@fcurd/core 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,337 @@
+import { Ref, Reactive, ComputedRef } from 'vue';
+
+/**
+ * Sort configuration
+ */
+interface CrudSort<Field extends string = string> {
+    field: Field;
+    order: 'ascend' | 'descend';
+}
+/**
+ * Field visibility context
+ */
+interface FieldContext<Row = any, FormModel = Row> {
+    surface: 'search' | 'table' | 'form' | 'detail';
+    row?: Row;
+    formModel?: FormModel;
+    query?: Record<string, unknown>;
+}
+/**
+ * Cell render context for table columns
+ */
+interface CellContext<Row = any> {
+    row: Row;
+    rowIndex: number;
+    value: any;
+}
+/** Alias for backward compatibility */
+type CrudTableCellContext<Row = any> = CellContext<Row>;
+/**
+ * Field definition - core schema for form/search/table
+ */
+type CrudFieldType = 'text' | 'textarea' | 'select' | 'date' | 'datetime' | 'dateRange' | 'datetimeRange' | 'switch' | 'number' | 'money' | 'custom';
+interface CrudField<Row = any, FormModel = Row, UiExt = unknown> {
+    key: string;
+    label: string | (() => string);
+    type: CrudFieldType | (string & {});
+    required?: boolean;
+    visibleIn?: {
+        search?: boolean | ((ctx: FieldContext<Row, FormModel>) => boolean);
+        table?: boolean | ((ctx: FieldContext<Row, FormModel>) => boolean);
+        form?: boolean | ((ctx: FieldContext<Row, FormModel>) => boolean);
+        detail?: boolean | ((ctx: FieldContext<Row, FormModel>) => boolean);
+    };
+    /** UI-specific extensions, defined by adapter layer */
+    ui?: UiExt;
+}
+/**
+ * Table column definition
+ */
+interface CrudColumn<Row = any, UiExt = unknown> {
+    key: string;
+    label?: string | (() => string);
+    width?: number;
+    minWidth?: number;
+    fixed?: 'left' | 'right';
+    sortable?: boolean;
+    render?: (ctx: CellContext<Row>) => any;
+    /** UI-specific extensions */
+    ui?: UiExt;
+}
+interface ListParams<Query = Record<string, unknown>> {
+    page: number;
+    pageSize: number;
+    query: Query;
+    sort?: CrudSort | null;
+    signal?: AbortSignal;
+}
+interface ListResult<Row = any> {
+    items: Row[];
+    total: number;
+}
+interface ExportParams<Query = Record<string, unknown>> {
+    query: Query;
+    sort?: CrudSort | null;
+    signal?: AbortSignal;
+}
+type ExportResult = Blob | {
+    blob: Blob;
+    filename?: string;
+} | {
+    url: string;
+    filename?: string;
+};
+/**
+ * CRUD data adapter interface
+ */
+interface CrudAdapter<Row = any, Query = Record<string, unknown>> {
+    list: (params: ListParams<Query>) => Promise<ListResult<Row>>;
+    create?: (data: Partial<Row>) => Promise<Row>;
+    update?: (id: string | number, data: Partial<Row>) => Promise<Row>;
+    remove?: (id: string | number) => Promise<void>;
+    export?: (params: ExportParams<Query>) => Promise<ExportResult>;
+    getId?: (row: Row) => string | number;
+}
+interface UseCrudListOptions<Row = any, Query = Record<string, unknown>> {
+    adapter: CrudAdapter<Row, Query>;
+    initialQuery?: Query;
+    initialPage?: number;
+    initialPageSize?: number;
+    autoFetch?: boolean;
+    debounceMs?: number;
+    dedupe?: boolean;
+    onError?: (error: unknown) => void;
+}
+interface UseCrudListReturn<Row = any, Query = Record<string, unknown>> {
+    rows: Ref<Row[]>;
+    total: Ref<number>;
+    loading: Ref<boolean>;
+    error: Ref<unknown>;
+    page: Ref<number>;
+    pageSize: Ref<number>;
+    query: Ref<Query>;
+    sort: Ref<CrudSort | null>;
+    refresh: () => Promise<void>;
+    setQuery: (partial: Partial<Query>, options?: SetQueryOptions) => void;
+    setPage: (page: number) => void;
+    setPageSize: (size: number) => void;
+    setSort: (sort: CrudSort | null) => void;
+    reset: () => void;
+}
+interface SetQueryOptions {
+    /**
+     * How to apply the partial query update
+     * - merge: shallow merge into existing query (default)
+     * - replace: replace the whole query with partial
+     */
+    mode?: 'merge' | 'replace';
+    /** Keys to delete from current query before applying the update (useful for flat search forms) */
+    clearKeys?: string[];
+    /**
+     * Remove empty values after applying update.
+     * Treats `undefined | null | '' | [] | {}` as empty (deep).
+     * Keeps `0` / `false`.
+     */
+    pruneEmpty?: boolean;
+}
+interface UseCrudFormOptions<Row = any> {
+    fields: CrudField<Row>[];
+    initialData?: Partial<Row>;
+}
+interface UseCrudFormReturn<Row = any> {
+    model: Reactive<Partial<Row>>;
+    mode: Ref<'create' | 'edit'>;
+    dirty: ComputedRef<boolean>;
+    changedKeys: ComputedRef<string[]>;
+    changedData: ComputedRef<Partial<Row>>;
+    visibleFields: ComputedRef<CrudField<Row>[]>;
+    reset: (data?: Partial<Row>) => void;
+    setMode: (mode: 'create' | 'edit') => void;
+    getSubmitData: () => Partial<Row>;
+}
+interface UseCrudSelectionOptions<Row = any> {
+    rows: Ref<Row[]>;
+    getId?: (row: Row) => string | number;
+}
+interface UseCrudSelectionReturn<Row = any> {
+    selectedIds: Ref<Set<string | number>>;
+    selectedRows: ComputedRef<Row[]>;
+    selectedCount: ComputedRef<number>;
+    /** Replace the whole selectedIds set (used by UI adapters to keep cross-page selection stable) */
+    setSelectedIds: (ids: (string | number)[]) => void;
+    select: (id: string | number) => void;
+    deselect: (id: string | number) => void;
+    toggle: (id: string | number) => void;
+    selectAll: () => void;
+    clear: () => void;
+    isSelected: (id: string | number) => boolean;
+}
+interface ActionContext<Row = any> {
+    row?: Row;
+    selectedRows: Row[];
+    selectedIds: (string | number)[];
+    /** Current list query (if available) */
+    query?: Record<string, unknown>;
+    /** Current list sort (if available) */
+    sort?: CrudSort | null;
+    /** Current page (if available) */
+    page?: number;
+    /** Current page size (if available) */
+    pageSize?: number;
+    refresh: () => Promise<void>;
+    clearSelection: () => void;
+}
+interface CrudAction<Row = any> {
+    id: string;
+    label: string;
+    icon?: any;
+    type?: 'primary' | 'default' | 'success' | 'warning' | 'error';
+    area: 'toolbar' | 'row' | 'batch';
+    order?: number;
+    confirm?: boolean | string;
+    visible?: (ctx: ActionContext<Row>) => boolean;
+    disabled?: (ctx: ActionContext<Row>) => boolean;
+    onClick: (ctx: ActionContext<Row>) => Promise<void> | void;
+}
+interface UseCrudActionsOptions<Row = any> {
+    actions?: CrudAction<Row>[];
+    adapter?: CrudAdapter<Row>;
+    getId?: (row: Row) => string | number;
+    refresh?: () => Promise<void>;
+    clearSelection?: () => void;
+    onError?: (error: unknown) => void;
+}
+interface UseCrudActionsReturn<Row = any> {
+    actions: Ref<CrudAction<Row>[]>;
+    getByArea: (area: CrudAction['area']) => CrudAction<Row>[];
+    register: (action: CrudAction<Row>) => void;
+    unregister: (id: string) => void;
+}
+
+/**
+ * Core hook for CRUD action management
+ */
+declare function useCrudActions<Row = any>(options?: UseCrudActionsOptions<Row>): UseCrudActionsReturn<Row>;
+interface CreateActionOptions {
+    label?: string;
+    onClick: () => void;
+}
+declare function createAction(options: CreateActionOptions): CrudAction;
+interface EditActionOptions<Row = any> {
+    label?: string;
+    onClick: (row: Row) => void;
+}
+declare function editAction<Row = any>(options: EditActionOptions<Row>): CrudAction<Row>;
+interface DeleteActionOptions<Row = any> {
+    label?: string;
+    adapter: CrudAdapter<Row>;
+    getId?: (row: Row) => string | number;
+    confirm?: boolean | string;
+    onSuccess?: () => void;
+    onError?: (error: unknown) => void;
+}
+declare function deleteAction<Row = any>(options: DeleteActionOptions<Row>): CrudAction<Row>;
+interface BatchDeleteActionOptions<Row = any> {
+    label?: string;
+    adapter: CrudAdapter<Row>;
+    getId?: (row: Row) => string | number;
+    confirm?: boolean | string;
+    onSuccess?: () => void;
+    onError?: (error: unknown) => void;
+}
+declare function batchDeleteAction<Row = any>(options: BatchDeleteActionOptions<Row>): CrudAction<Row>;
+interface ExportActionOptions<Row = any> {
+    label?: string;
+    adapter: CrudAdapter<Row>;
+    filename?: string;
+    onSuccess?: () => void;
+    onError?: (error: unknown) => void;
+    /** UI layer provides download handler */
+    handleExport?: (result: any, filename?: string) => void;
+}
+declare function exportAction<Row = any>(options: ExportActionOptions<Row>): CrudAction<Row>;
+/**
+ * Preset action factories
+ */
+declare const presetActions: {
+    create: typeof createAction;
+    edit: typeof editAction;
+    delete: typeof deleteAction;
+    batchDelete: typeof batchDeleteAction;
+    export: typeof exportAction;
+};
+
+/**
+ * Core hook for CRUD form state management
+ */
+declare function useCrudForm<Row = any>(options: UseCrudFormOptions<Row>): UseCrudFormReturn<Row>;
+
+/**
+ * Core hook for CRUD list operations - handles pagination, sorting, query, and data fetching
+ */
+declare function useCrudList<Row = any, Query extends object = Record<string, unknown>>(options: UseCrudListOptions<Row, Query>): UseCrudListReturn<Row, Query>;
+
+interface UseCrudRouteSyncOptions<Query = Record<string, unknown>> {
+    /** Query ref from useCrudList */
+    query: Ref<Query>;
+    /** Set query function from useCrudList */
+    setQuery: (partial: Partial<Query>, options?: SetQueryOptions) => void;
+    /** Router instance (vue-router) */
+    router?: any;
+    /** Route instance (vue-router) */
+    route?: any;
+    /** Query key in URL (default: 'q') */
+    queryKey?: string;
+    /** Serialize query to string (default: JSON.stringify) */
+    serialize?: (query: Query) => string;
+    /** Deserialize string to query (default: JSON.parse) */
+    deserialize?: (str: string) => Partial<Query>;
+    /** Debounce delay in ms (default: 300) */
+    debounceMs?: number;
+    /**
+     * How to apply query when syncing from route (default: 'replace')
+     * - replace: URL is the source of truth (prevents stale keys from lingering)
+     * - merge: merge into current query
+     */
+    syncFromRouteMode?: 'replace' | 'merge';
+}
+/**
+ * Sync CRUD query with URL route query
+ */
+declare function useCrudRouteSync<Query = Record<string, unknown>>(options: UseCrudRouteSyncOptions<Query>): {
+    syncFromRoute: () => void;
+    syncToRoute: () => void;
+};
+
+/**
+ * Core hook for CRUD selection management
+ */
+declare function useCrudSelection<Row = any>(options: UseCrudSelectionOptions<Row>): UseCrudSelectionReturn<Row>;
+
+/**
+ * Define columns with type inference
+ */
+declare function defineColumns<Row = any, const Columns extends CrudColumn<Row>[] = CrudColumn<Row>[]>(columns: Columns): Columns;
+/**
+ * Create columns from fields with optional overrides
+ */
+declare function createColumnsFromFields<Row = any>(fields: CrudField<Row>[], options?: {
+    overrides?: Partial<Record<string, Partial<CrudColumn<Row>>>>;
+    defaults?: Partial<CrudColumn<Row>>;
+    filter?: (field: CrudField<Row>) => boolean;
+}): CrudColumn<Row>[];
+
+/**
+ * Define fields with type inference
+ */
+declare function defineFields<Row = any, FormModel = Row, const Fields extends CrudField<Row, FormModel>[] = CrudField<Row, FormModel>[]>(fields: Fields): Fields;
+/**
+ * Filter fields by surface visibility
+ */
+declare function filterFieldsBySurface<Row = any, FormModel = Row>(fields: CrudField<Row, FormModel>[], surface: FieldContext['surface'], ctx?: Partial<FieldContext<Row, FormModel>>): CrudField<Row, FormModel>[];
+/**
+ * Get field label (resolve function if needed)
+ */
+declare function getFieldLabel(field: CrudField): string;
+
+export { type ActionContext, type BatchDeleteActionOptions, type CellContext, type CreateActionOptions, type CrudAction, type CrudAdapter, type CrudColumn, type CrudField, type CrudFieldType, type CrudSort, type CrudTableCellContext, type DeleteActionOptions, type EditActionOptions, type ExportActionOptions, type ExportParams, type ExportResult, type FieldContext, type ListParams, type ListResult, type SetQueryOptions, type UseCrudActionsOptions, type UseCrudActionsReturn, type UseCrudFormOptions, type UseCrudFormReturn, type UseCrudListOptions, type UseCrudListReturn, type UseCrudRouteSyncOptions, type UseCrudSelectionOptions, type UseCrudSelectionReturn, batchDeleteAction, createAction, createColumnsFromFields, defineColumns, defineFields, deleteAction, editAction, exportAction, filterFieldsBySurface, getFieldLabel, presetActions, useCrudActions, useCrudForm, useCrudList, useCrudRouteSync, useCrudSelection };

package/dist/index.d.ts

@@ -0,0 +1,337 @@
+import { Ref, Reactive, ComputedRef } from 'vue';
+
+/**
+ * Sort configuration
+ */
+interface CrudSort<Field extends string = string> {
+    field: Field;
+    order: 'ascend' | 'descend';
+}
+/**
+ * Field visibility context
+ */
+interface FieldContext<Row = any, FormModel = Row> {
+    surface: 'search' | 'table' | 'form' | 'detail';
+    row?: Row;
+    formModel?: FormModel;
+    query?: Record<string, unknown>;
+}
+/**
+ * Cell render context for table columns
+ */
+interface CellContext<Row = any> {
+    row: Row;
+    rowIndex: number;
+    value: any;
+}
+/** Alias for backward compatibility */
+type CrudTableCellContext<Row = any> = CellContext<Row>;
+/**
+ * Field definition - core schema for form/search/table
+ */
+type CrudFieldType = 'text' | 'textarea' | 'select' | 'date' | 'datetime' | 'dateRange' | 'datetimeRange' | 'switch' | 'number' | 'money' | 'custom';
+interface CrudField<Row = any, FormModel = Row, UiExt = unknown> {
+    key: string;
+    label: string | (() => string);
+    type: CrudFieldType | (string & {});
+    required?: boolean;
+    visibleIn?: {
+        search?: boolean | ((ctx: FieldContext<Row, FormModel>) => boolean);
+        table?: boolean | ((ctx: FieldContext<Row, FormModel>) => boolean);
+        form?: boolean | ((ctx: FieldContext<Row, FormModel>) => boolean);
+        detail?: boolean | ((ctx: FieldContext<Row, FormModel>) => boolean);
+    };
+    /** UI-specific extensions, defined by adapter layer */
+    ui?: UiExt;
+}
+/**
+ * Table column definition
+ */
+interface CrudColumn<Row = any, UiExt = unknown> {
+    key: string;
+    label?: string | (() => string);
+    width?: number;
+    minWidth?: number;
+    fixed?: 'left' | 'right';
+    sortable?: boolean;
+    render?: (ctx: CellContext<Row>) => any;
+    /** UI-specific extensions */
+    ui?: UiExt;
+}
+interface ListParams<Query = Record<string, unknown>> {
+    page: number;
+    pageSize: number;
+    query: Query;
+    sort?: CrudSort | null;
+    signal?: AbortSignal;
+}
+interface ListResult<Row = any> {
+    items: Row[];
+    total: number;
+}
+interface ExportParams<Query = Record<string, unknown>> {
+    query: Query;
+    sort?: CrudSort | null;
+    signal?: AbortSignal;
+}
+type ExportResult = Blob | {
+    blob: Blob;
+    filename?: string;
+} | {
+    url: string;
+    filename?: string;
+};
+/**
+ * CRUD data adapter interface
+ */
+interface CrudAdapter<Row = any, Query = Record<string, unknown>> {
+    list: (params: ListParams<Query>) => Promise<ListResult<Row>>;
+    create?: (data: Partial<Row>) => Promise<Row>;
+    update?: (id: string | number, data: Partial<Row>) => Promise<Row>;
+    remove?: (id: string | number) => Promise<void>;
+    export?: (params: ExportParams<Query>) => Promise<ExportResult>;
+    getId?: (row: Row) => string | number;
+}
+interface UseCrudListOptions<Row = any, Query = Record<string, unknown>> {
+    adapter: CrudAdapter<Row, Query>;
+    initialQuery?: Query;
+    initialPage?: number;
+    initialPageSize?: number;
+    autoFetch?: boolean;
+    debounceMs?: number;
+    dedupe?: boolean;
+    onError?: (error: unknown) => void;
+}
+interface UseCrudListReturn<Row = any, Query = Record<string, unknown>> {
+    rows: Ref<Row[]>;
+    total: Ref<number>;
+    loading: Ref<boolean>;
+    error: Ref<unknown>;
+    page: Ref<number>;
+    pageSize: Ref<number>;
+    query: Ref<Query>;
+    sort: Ref<CrudSort | null>;
+    refresh: () => Promise<void>;
+    setQuery: (partial: Partial<Query>, options?: SetQueryOptions) => void;
+    setPage: (page: number) => void;
+    setPageSize: (size: number) => void;
+    setSort: (sort: CrudSort | null) => void;
+    reset: () => void;
+}
+interface SetQueryOptions {
+    /**
+     * How to apply the partial query update
+     * - merge: shallow merge into existing query (default)
+     * - replace: replace the whole query with partial
+     */
+    mode?: 'merge' | 'replace';
+    /** Keys to delete from current query before applying the update (useful for flat search forms) */
+    clearKeys?: string[];
+    /**
+     * Remove empty values after applying update.
+     * Treats `undefined | null | '' | [] | {}` as empty (deep).
+     * Keeps `0` / `false`.
+     */
+    pruneEmpty?: boolean;
+}
+interface UseCrudFormOptions<Row = any> {
+    fields: CrudField<Row>[];
+    initialData?: Partial<Row>;
+}
+interface UseCrudFormReturn<Row = any> {
+    model: Reactive<Partial<Row>>;
+    mode: Ref<'create' | 'edit'>;
+    dirty: ComputedRef<boolean>;
+    changedKeys: ComputedRef<string[]>;
+    changedData: ComputedRef<Partial<Row>>;
+    visibleFields: ComputedRef<CrudField<Row>[]>;
+    reset: (data?: Partial<Row>) => void;
+    setMode: (mode: 'create' | 'edit') => void;
+    getSubmitData: () => Partial<Row>;
+}
+interface UseCrudSelectionOptions<Row = any> {
+    rows: Ref<Row[]>;
+    getId?: (row: Row) => string | number;
+}
+interface UseCrudSelectionReturn<Row = any> {
+    selectedIds: Ref<Set<string | number>>;
+    selectedRows: ComputedRef<Row[]>;
+    selectedCount: ComputedRef<number>;
+    /** Replace the whole selectedIds set (used by UI adapters to keep cross-page selection stable) */
+    setSelectedIds: (ids: (string | number)[]) => void;
+    select: (id: string | number) => void;
+    deselect: (id: string | number) => void;
+    toggle: (id: string | number) => void;
+    selectAll: () => void;
+    clear: () => void;
+    isSelected: (id: string | number) => boolean;
+}
+interface ActionContext<Row = any> {
+    row?: Row;
+    selectedRows: Row[];
+    selectedIds: (string | number)[];
+    /** Current list query (if available) */
+    query?: Record<string, unknown>;
+    /** Current list sort (if available) */
+    sort?: CrudSort | null;
+    /** Current page (if available) */
+    page?: number;
+    /** Current page size (if available) */
+    pageSize?: number;
+    refresh: () => Promise<void>;
+    clearSelection: () => void;
+}
+interface CrudAction<Row = any> {
+    id: string;
+    label: string;
+    icon?: any;
+    type?: 'primary' | 'default' | 'success' | 'warning' | 'error';
+    area: 'toolbar' | 'row' | 'batch';
+    order?: number;
+    confirm?: boolean | string;
+    visible?: (ctx: ActionContext<Row>) => boolean;
+    disabled?: (ctx: ActionContext<Row>) => boolean;
+    onClick: (ctx: ActionContext<Row>) => Promise<void> | void;
+}
+interface UseCrudActionsOptions<Row = any> {
+    actions?: CrudAction<Row>[];
+    adapter?: CrudAdapter<Row>;
+    getId?: (row: Row) => string | number;
+    refresh?: () => Promise<void>;
+    clearSelection?: () => void;
+    onError?: (error: unknown) => void;
+}
+interface UseCrudActionsReturn<Row = any> {
+    actions: Ref<CrudAction<Row>[]>;
+    getByArea: (area: CrudAction['area']) => CrudAction<Row>[];
+    register: (action: CrudAction<Row>) => void;
+    unregister: (id: string) => void;
+}
+
+/**
+ * Core hook for CRUD action management
+ */
+declare function useCrudActions<Row = any>(options?: UseCrudActionsOptions<Row>): UseCrudActionsReturn<Row>;
+interface CreateActionOptions {
+    label?: string;
+    onClick: () => void;
+}
+declare function createAction(options: CreateActionOptions): CrudAction;
+interface EditActionOptions<Row = any> {
+    label?: string;
+    onClick: (row: Row) => void;
+}
+declare function editAction<Row = any>(options: EditActionOptions<Row>): CrudAction<Row>;
+interface DeleteActionOptions<Row = any> {
+    label?: string;
+    adapter: CrudAdapter<Row>;
+    getId?: (row: Row) => string | number;
+    confirm?: boolean | string;
+    onSuccess?: () => void;
+    onError?: (error: unknown) => void;
+}
+declare function deleteAction<Row = any>(options: DeleteActionOptions<Row>): CrudAction<Row>;
+interface BatchDeleteActionOptions<Row = any> {
+    label?: string;
+    adapter: CrudAdapter<Row>;
+    getId?: (row: Row) => string | number;
+    confirm?: boolean | string;
+    onSuccess?: () => void;
+    onError?: (error: unknown) => void;
+}
+declare function batchDeleteAction<Row = any>(options: BatchDeleteActionOptions<Row>): CrudAction<Row>;
+interface ExportActionOptions<Row = any> {
+    label?: string;
+    adapter: CrudAdapter<Row>;
+    filename?: string;
+    onSuccess?: () => void;
+    onError?: (error: unknown) => void;
+    /** UI layer provides download handler */
+    handleExport?: (result: any, filename?: string) => void;
+}
+declare function exportAction<Row = any>(options: ExportActionOptions<Row>): CrudAction<Row>;
+/**
+ * Preset action factories
+ */
+declare const presetActions: {
+    create: typeof createAction;
+    edit: typeof editAction;
+    delete: typeof deleteAction;
+    batchDelete: typeof batchDeleteAction;
+    export: typeof exportAction;
+};
+
+/**
+ * Core hook for CRUD form state management
+ */
+declare function useCrudForm<Row = any>(options: UseCrudFormOptions<Row>): UseCrudFormReturn<Row>;
+
+/**
+ * Core hook for CRUD list operations - handles pagination, sorting, query, and data fetching
+ */
+declare function useCrudList<Row = any, Query extends object = Record<string, unknown>>(options: UseCrudListOptions<Row, Query>): UseCrudListReturn<Row, Query>;
+
+interface UseCrudRouteSyncOptions<Query = Record<string, unknown>> {
+    /** Query ref from useCrudList */
+    query: Ref<Query>;
+    /** Set query function from useCrudList */
+    setQuery: (partial: Partial<Query>, options?: SetQueryOptions) => void;
+    /** Router instance (vue-router) */
+    router?: any;
+    /** Route instance (vue-router) */
+    route?: any;
+    /** Query key in URL (default: 'q') */
+    queryKey?: string;
+    /** Serialize query to string (default: JSON.stringify) */
+    serialize?: (query: Query) => string;
+    /** Deserialize string to query (default: JSON.parse) */
+    deserialize?: (str: string) => Partial<Query>;
+    /** Debounce delay in ms (default: 300) */
+    debounceMs?: number;
+    /**
+     * How to apply query when syncing from route (default: 'replace')
+     * - replace: URL is the source of truth (prevents stale keys from lingering)
+     * - merge: merge into current query
+     */
+    syncFromRouteMode?: 'replace' | 'merge';
+}
+/**
+ * Sync CRUD query with URL route query
+ */
+declare function useCrudRouteSync<Query = Record<string, unknown>>(options: UseCrudRouteSyncOptions<Query>): {
+    syncFromRoute: () => void;
+    syncToRoute: () => void;
+};
+
+/**
+ * Core hook for CRUD selection management
+ */
+declare function useCrudSelection<Row = any>(options: UseCrudSelectionOptions<Row>): UseCrudSelectionReturn<Row>;
+
+/**
+ * Define columns with type inference
+ */
+declare function defineColumns<Row = any, const Columns extends CrudColumn<Row>[] = CrudColumn<Row>[]>(columns: Columns): Columns;
+/**
+ * Create columns from fields with optional overrides
+ */
+declare function createColumnsFromFields<Row = any>(fields: CrudField<Row>[], options?: {
+    overrides?: Partial<Record<string, Partial<CrudColumn<Row>>>>;
+    defaults?: Partial<CrudColumn<Row>>;
+    filter?: (field: CrudField<Row>) => boolean;
+}): CrudColumn<Row>[];
+
+/**
+ * Define fields with type inference
+ */
+declare function defineFields<Row = any, FormModel = Row, const Fields extends CrudField<Row, FormModel>[] = CrudField<Row, FormModel>[]>(fields: Fields): Fields;
+/**
+ * Filter fields by surface visibility
+ */
+declare function filterFieldsBySurface<Row = any, FormModel = Row>(fields: CrudField<Row, FormModel>[], surface: FieldContext['surface'], ctx?: Partial<FieldContext<Row, FormModel>>): CrudField<Row, FormModel>[];
+/**
+ * Get field label (resolve function if needed)
+ */
+declare function getFieldLabel(field: CrudField): string;
+
+export { type ActionContext, type BatchDeleteActionOptions, type CellContext, type CreateActionOptions, type CrudAction, type CrudAdapter, type CrudColumn, type CrudField, type CrudFieldType, type CrudSort, type CrudTableCellContext, type DeleteActionOptions, type EditActionOptions, type ExportActionOptions, type ExportParams, type ExportResult, type FieldContext, type ListParams, type ListResult, type SetQueryOptions, type UseCrudActionsOptions, type UseCrudActionsReturn, type UseCrudFormOptions, type UseCrudFormReturn, type UseCrudListOptions, type UseCrudListReturn, type UseCrudRouteSyncOptions, type UseCrudSelectionOptions, type UseCrudSelectionReturn, batchDeleteAction, createAction, createColumnsFromFields, defineColumns, defineFields, deleteAction, editAction, exportAction, filterFieldsBySurface, getFieldLabel, presetActions, useCrudActions, useCrudForm, useCrudList, useCrudRouteSync, useCrudSelection };