import { ColumnConfig, DataGridElement, GridConfig } from '@toolbox-web/grid';
import { InjectionKey, Ref } from 'vue';
/**
 * Injection key for the grid element.
 * @since 0.1.0
 */
export declare const GRID_ELEMENT_KEY: InjectionKey<Ref<DataGridElement | null>>;
/**
 * Return type for useGrid composable.
 * @since 0.1.0
 */
export interface UseGridReturn<TRow = unknown> {
    /** The grid element reference */
    element: Ref<DataGridElement<TRow> | null>;
    /**
     * The grid element reference.
     * @deprecated Use {@link UseGridReturn.element} instead, which matches the
     * React and Angular adapters. This alias points at the same `Ref` and will
     * be removed in a future major.
     */
    gridElement: Ref<DataGridElement<TRow> | null>;
    /** Whether the grid is ready */
    isReady: Ref<boolean>;
    /** Current grid configuration (reactive) */
    config: Ref<GridConfig<TRow> | null>;
    /** Get the effective configuration */
    getConfig: () => Promise<GridConfig<TRow> | null>;
    /** Wait for the grid to finish its first render */
    ready: () => Promise<void>;
    /** Force a layout recalculation */
    forceLayout: () => Promise<void>;
    /** Get a plugin by its class */
    getPlugin: <T>(pluginClass: new (...args: unknown[]) => T) => T | undefined;
    /**
     * Get a plugin by its registered name (preferred).
     * Uses the type-safe PluginNameMap for auto-completion and return type narrowing.
     */
    getPluginByName: DataGridElement['getPluginByName'];
    /** Toggle a group row */
    toggleGroup: (key: string) => Promise<void>;
    /** Register custom styles via `document.adoptedStyleSheets` */
    registerStyles: (id: string, css: string) => void;
    /** Unregister previously registered custom styles */
    unregisterStyles: (id: string) => void;
    /** Get currently visible columns (excluding hidden columns) */
    getVisibleColumns: () => ColumnConfig<TRow>[];
}
/**
 * Composable for programmatic access to the grid.
 *
 * @example
 * ```vue
 * <script setup>
 * import { useGrid } from '@toolbox-web/grid-vue';
 *
 * const { forceLayout, getConfig, isReady, getVisibleColumns } = useGrid();
 *
 * async function handleResize() {
 *   await forceLayout();
 * }
 * </script>
 * ```
 * @param selector - Optional CSS selector to target a specific grid element via
 *   DOM query instead of using Vue's provide/inject. Use when the component
 *   contains multiple grids, e.g. `'tbw-grid.primary'` or `'#my-grid'`.
 * @since 0.1.0
 */
export declare function useGrid<TRow = unknown>(selector?: string): UseGridReturn<TRow>;
//# sourceMappingURL=use-grid.d.ts.map