@vc-shell/framework 1.2.3-beta.1 → 1.2.4-beta.1

package/dist/ui/components/organisms/vc-table/composables/useDataTableOrchestrator.d.ts

@@ -0,0 +1,173 @@
+/**
+ * useDataTableOrchestrator - Central orchestrator for VcDataTable composables
+ *
+ * This composable provides a unified interface for coordinating all VcDataTable
+ * functionality. It wraps individual composables and provides consistent typing.
+ *
+ * NOTE: This is a foundation for future refactoring. Currently VcDataTable.vue
+ * uses individual composables directly. This orchestrator can be gradually
+ * integrated to reduce VcDataTable complexity.
+ *
+ * Features coordinated:
+ * - Selection (single/multiple)
+ * - Sorting (single/multi)
+ * - Filtering (column + global)
+ * - Editing (row/cell)
+ * - Expansion
+ * - Row grouping
+ * - Inline edit mode
+ * - Column management (resize, reorder, visibility)
+ *
+ * Benefits:
+ * - Reduces VcDataTable.vue complexity
+ * - Centralizes state management
+ * - Provides unified event handling
+ * - Makes testing easier
+ */
+import { type Ref, type ComputedRef } from "vue";
+import type { ColumnInstance } from "../utils/ColumnCollector";
+import type { VcColumnProps, EditChange } from "../types";
+import { type SortEvent } from "./useTableSort";
+import { type GroupedData } from "./useTableRowGrouping";
+export interface DataTableOrchestratorOptions<T extends Record<string, any>> {
+    items: Ref<T[]>;
+    dataKey: string;
+    getItemKey: (item: T, index: number) => string;
+    selection?: Ref<T | T[] | undefined>;
+    selectionMode?: ComputedRef<"single" | "multiple" | undefined>;
+    isRowSelectable?: (item: T) => boolean;
+    totalCount?: Ref<number | undefined>;
+    selectAllActive?: Ref<boolean | undefined>;
+    sortField?: Ref<string | undefined>;
+    sortOrder?: Ref<0 | 1 | -1>;
+    sortMode?: Ref<"single" | "multiple">;
+    multiSortMeta?: Ref<Array<{
+        field: string;
+        order: 0 | 1 | -1;
+    }>>;
+    removableSort?: Ref<boolean>;
+    editMode?: Ref<"cell" | "row" | undefined>;
+    editingRows?: Ref<T[]>;
+    validationRules?: Record<string, (value: unknown, row: T) => string | true>;
+    expandedRows?: Ref<T[]>;
+    groupRowsBy?: Ref<string | undefined>;
+    rowGroupMode?: Ref<"subheader" | "rowspan">;
+    expandableRowGroups?: Ref<boolean>;
+    expandedRowGroups?: Ref<string[] | undefined>;
+    visibleColumns: ComputedRef<ColumnInstance[]>;
+    resizableColumns?: boolean;
+    reorderableColumns?: boolean;
+    hasSelectionColumn: ComputedRef<boolean>;
+    isSelectionViaColumn: ComputedRef<boolean>;
+    tableContainerRef?: Ref<HTMLElement | null>;
+    onSelectionChange?: (selection: T | T[]) => void;
+    onSelectAllChange?: (active: boolean) => void;
+    onSort?: (event: SortEvent) => void;
+    onEditSave?: (changes: EditChange<T>[]) => void;
+    onEditCancel?: () => void;
+    onExpandedRowsChange?: (rows: T[]) => void;
+    onExpandedRowGroupsChange?: (groups: string[]) => void;
+    onRowGroupExpand?: (event: {
+        data: string;
+        originalEvent: Event;
+    }) => void;
+    onRowGroupCollapse?: (event: {
+        data: string;
+        originalEvent: Event;
+    }) => void;
+    onColumnResizeEnd?: (columns: Array<{
+        id: string;
+        width: number;
+    }>) => void;
+    onColumnReorder?: (columns: Array<{
+        id: string;
+        width: number;
+    }>) => void;
+}
+export interface DataTableOrchestratorReturn<T extends Record<string, any>> {
+    selection: {
+        internalSelection: Ref<T[]>;
+        allSelected: ComputedRef<boolean>;
+        someSelected: ComputedRef<boolean>;
+        isSelected: (item: T) => boolean;
+        canSelect: (item: T) => boolean;
+        handleRowSelectionChange: (item: T, eventOrValue?: Event | boolean) => {
+            data: T;
+            index?: number;
+        } | null;
+        handleSelectAllChange: (value: boolean, event?: Event) => {
+            data: T[];
+            originalEvent: Event;
+        };
+        clearSelection: () => void;
+    };
+    sort: {
+        getSortDirection: (field: string) => "asc" | "desc" | undefined;
+        getSortIndex: (field: string) => number | undefined;
+        handleSort: (field: string, event?: MouseEvent) => void;
+    };
+    editing: {
+        isRowEditing: (item: T) => boolean;
+        getEditingRowData: (item: T, index: number) => T | null;
+        isCellEditing: (rowIndex: number, field: string) => boolean;
+        startRowEdit: (item: T, index: number) => void;
+        cancelRowEdit: (item: T, index: number) => void;
+        saveRowEdit: (item: T, index: number) => void;
+    };
+    expansion: {
+        isRowExpanded: (item: T) => boolean;
+        toggleRowExpansion: (item: T, index: number, event: Event) => void;
+        expandedKeysArray: Ref<string[]>;
+    };
+    rowGrouping: {
+        isGroupingEnabled: ComputedRef<boolean>;
+        groupedData: ComputedRef<GroupedData<T>[]>;
+        isGroupExpanded: (key: string) => boolean;
+        toggleGroupExpansion: (key: string, event: Event) => void;
+        getItemGroupKey: (item: T) => string;
+    };
+    inlineEdit: {
+        isEditing: Ref<boolean>;
+        startEditing: () => void;
+        cancelEditing: () => void;
+        saveChanges: () => Promise<void>;
+        updateCell: (rowIndex: number, field: string, value: unknown) => void;
+        addRow: (defaults?: Partial<T>) => void;
+        removeRow: (index: number) => void;
+    };
+    cols: {
+        orderedVisibleColumns: ComputedRef<ColumnInstance[]>;
+        columnWidths: Ref<Array<{
+            id: string;
+            width: number;
+        }>>;
+        getEffectiveColumnWidth: (colProps: VcColumnProps) => string | undefined;
+        getHeaderAlign: (colProps: VcColumnProps) => "left" | "center" | "right" | undefined;
+        getHeaderStyle: (colProps: VcColumnProps) => object | undefined;
+        getCellAlign: (colProps: VcColumnProps) => "left" | "center" | "right" | undefined;
+        getCellStyle: (colProps: VcColumnProps) => object | undefined;
+        getSortField: (colProps: VcColumnProps) => string;
+        isColumnResizable: (colProps: VcColumnProps) => boolean;
+        isColumnReorderable: (colProps: VcColumnProps) => boolean;
+        isLastResizableColumn: (colProps: VcColumnProps) => boolean;
+        setHeaderRef: (id: string, el: HTMLElement | null) => void;
+        headerRefs: Map<string, HTMLElement>;
+        handleResizeStart: (columnId: string, event: MouseEvent) => void;
+        handleColumnDragStart: (columnId: string, event: DragEvent) => void;
+        handleColumnDragOver: (event: DragEvent, targetColumnId: string) => void;
+        handleColumnDrop: (event: DragEvent) => void;
+    };
+    columnFilter: {
+        getFilterType: (col: ColumnInstance) => string;
+        getFilterOptions: (col: ColumnInstance) => Array<{
+            label: string;
+            value: unknown;
+        }> | undefined;
+        getRangeFields: (col: ColumnInstance) => [string, string] | undefined;
+        isMultipleSelect: (col: ColumnInstance) => boolean;
+    };
+    getGlobalIndex: (item: T) => number;
+    getRowProps: (item: T, index: number) => Record<string, unknown>;
+}
+export declare function useDataTableOrchestrator<T extends Record<string, any>>(options: DataTableOrchestratorOptions<T>): DataTableOrchestratorReturn<T>;
+//# sourceMappingURL=useDataTableOrchestrator.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useDataTableOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableOrchestrator.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useDataTableOrchestrator.ts"],"names":[],"mappings":"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"}

package/dist/ui/components/organisms/vc-table/composables/useDataTableState.d.ts

@@ -0,0 +1,30 @@
+import { type Ref, type ComputedRef } from "vue";
+/** Schema for persisted table state (versioned for future migrations). */
+export interface DataTablePersistedState {
+    /** Schema version — bump when adding/renaming/removing fields. */
+    v: 1;
+    columnWidths?: Record<string, number>;
+    columnOrder?: string[];
+    hiddenColumnIds?: string[];
+    shownColumnIds?: string[];
+}
+export interface UseDataTableStateOptions {
+    stateKey: Ref<string | undefined>;
+    stateStorage: Ref<"local" | "session"> | ComputedRef<"local" | "session">;
+    columnWidths: Ref<{
+        id: string;
+        width: number;
+    }[]>;
+    hiddenColumnIds: Ref<Set<string>>;
+    shownColumnIds?: Ref<Set<string>>;
+    /** Called after state is saved (for `state-save` emit). */
+    onStateSave?: (state: DataTablePersistedState) => void;
+    /** Called after state is restored (for `state-restore` emit). */
+    onStateRestore?: (state: DataTablePersistedState) => void;
+}
+export interface UseDataTableStateReturn {
+    saveState: () => void;
+    clearState: () => void;
+}
+export declare function useDataTableState(options: UseDataTableStateOptions): UseDataTableStateReturn;
+//# sourceMappingURL=useDataTableState.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useDataTableState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableState.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useDataTableState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,WAAW,EAAoC,MAAM,KAAK,CAAC;AAMnF,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,CAAC,EAAE,CAAC,CAAC;IACL,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClC,YAAY,EAAE,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC1E,YAAY,EAAE,GAAG,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACnD,eAAe,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACvD,iEAAiE;IACjE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAaD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CA0S5F"}

package/dist/ui/components/organisms/vc-table/composables/useDataTableState.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useDataTableState.test.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useDataTableState.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableState.test.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useDataTableState.test.ts"],"names":[],"mappings":""}

package/dist/ui/components/organisms/vc-table/composables/useMobileCardLayout.d.ts

@@ -0,0 +1,48 @@
+import { type Ref } from "vue";
+import type { ColumnInstance } from "../utils/ColumnCollector";
+import type { MobileCardLayout, MobileColumnConfig } from "../types";
+export interface UseMobileCardLayoutOptions {
+    /** Column instances from VcColumn */
+    columns: Ref<ColumnInstance[]>;
+}
+export interface UseMobileCardLayoutReturn {
+    /** Computed mobile card layout */
+    mobileLayout: Ref<MobileCardLayout>;
+    /** Whether any columns are configured for mobile */
+    hasMobileColumns: Ref<boolean>;
+    /** Columns that are visible on mobile */
+    mobileVisibleColumns: Ref<MobileColumnConfig[]>;
+}
+/**
+ * Composable for computing mobile card layout from VcColumn definitions.
+ *
+ * Supports two APIs:
+ * 1. **New API (recommended)**: Use `mobileRole` for semantic roles
+ *    - `title`: Primary identifier (full width, bold)
+ *    - `image`: Visual element (left side)
+ *    - `field`: Data with label (auto-distributed in 2x2 grid, max 4)
+ *    - `status`: Status badge (multiple allowed, bottom row)
+ *
+ * 2. **Legacy API**: Use `mobilePosition` (backward compatible)
+ *    - Automatically maps to roles: image→image, status→status,
+ *      first top-left→title, others→field
+ *
+ * Auto-placement for fields:
+ * - Fields with explicit `mobilePosition` are placed there
+ * - Fields without `mobilePosition` fill remaining grid positions in order
+ * - Maximum 4 fields (2x2 grid), excess fields are hidden
+ *
+ * @example
+ * ```vue
+ * <!-- New API with mobileRole -->
+ * <VcColumn id="name" title="Name" mobile-role="title" />
+ * <VcColumn id="price" title="Price" type="money" mobile-role="field" />
+ * <VcColumn id="status" type="status" mobile-role="status" />
+ *
+ * <!-- Legacy API with mobilePosition (still works) -->
+ * <VcColumn id="name" title="Name" mobile-position="top-left" />
+ * ```
+ */
+export declare function useMobileCardLayout(options: UseMobileCardLayoutOptions): UseMobileCardLayoutReturn;
+export default useMobileCardLayout;
+//# sourceMappingURL=useMobileCardLayout.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useMobileCardLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMobileCardLayout.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useMobileCardLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAInB,MAAM,UAAU,CAAC;AAclB,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,OAAO,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACxC,kCAAkC;IAClC,YAAY,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpC,oDAAoD;IACpD,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,yCAAyC;IACzC,oBAAoB,EAAE,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;CACjD;AA+FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,yBAAyB,CAuLlG;AAED,eAAe,mBAAmB,CAAC"}

package/dist/ui/components/organisms/vc-table/composables/useMobileCardLayout.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useMobileCardLayout.test.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useMobileCardLayout.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMobileCardLayout.test.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useMobileCardLayout.test.ts"],"names":[],"mappings":""}

package/dist/ui/components/organisms/vc-table/composables/useTableColumns.d.ts

@@ -0,0 +1,40 @@
+/**
+ * useTableColumns - Composable for column-related logic
+ *
+ * Extracts column ordering, width management, and helper functions
+ * from VcDataTable.vue to reduce main component size.
+ */
+import { type Ref, type ComputedRef } from "vue";
+import type { ColumnInstance } from "../utils/ColumnCollector";
+import type { VcColumnProps } from "../types";
+export interface UseTableColumnsOptions {
+    visibleColumns: Ref<ColumnInstance[]> | ComputedRef<ColumnInstance[]>;
+    resizableColumns?: boolean;
+    reorderableColumns?: boolean;
+    hasSelectionColumn?: ComputedRef<boolean>;
+    isSelectionViaColumn?: ComputedRef<boolean>;
+}
+export interface UseTableColumnsReturn {
+    columnWidths: Ref<{
+        id: string;
+        width: number;
+    }[]>;
+    headerRefs: Map<string, HTMLElement>;
+    setHeaderRef: (id: string, el: unknown) => void;
+    orderedVisibleColumns: ComputedRef<ColumnInstance[]>;
+    totalColumns: ComputedRef<number>;
+    isSpecialColumn: (col: VcColumnProps) => boolean;
+    isColumnResizable: (col: VcColumnProps) => boolean;
+    isColumnReorderable: (col: VcColumnProps) => boolean;
+    isLastResizableColumn: (col: VcColumnProps) => boolean;
+    getEffectiveColumnWidth: (col: VcColumnProps) => string | undefined;
+    getHeaderAlign: (col: VcColumnProps) => "left" | "center" | "right" | undefined;
+    getCellAlign: (col: VcColumnProps) => "left" | "center" | "right" | undefined;
+    getHeaderStyle: (col: VcColumnProps) => object | undefined;
+    getCellStyle: (col: VcColumnProps) => object | undefined;
+    getSortField: (col: VcColumnProps) => string;
+    /** Whether any visible column has no explicit width (i.e., uses flex-grow) */
+    hasFlexColumns: ComputedRef<boolean>;
+}
+export declare function useTableColumns(options: UseTableColumnsOptions): UseTableColumnsReturn;
+//# sourceMappingURL=useTableColumns.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useTableColumns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableColumns.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useTableColumns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAwB,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC;IACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1C,oBAAoB,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,qBAAqB;IAEpC,YAAY,EAAE,GAAG,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACnD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAGrC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC;IAGhD,qBAAqB,EAAE,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC;IACrD,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAGlC,eAAe,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;IACjD,iBAAiB,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;IACnD,mBAAmB,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;IACrD,qBAAqB,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;IACvD,uBAAuB,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAChF,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9E,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD,YAAY,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;IAC7C,8EAA8E;IAC9E,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAsOtF"}

package/dist/ui/components/organisms/vc-table/composables/useTableColumnsReorder.d.ts

@@ -0,0 +1,33 @@
+import { Ref } from "vue";
+export interface ReorderableColumn {
+    id: string;
+    [key: string]: any;
+}
+export interface UseTableColumnsReorderOptions<T extends ReorderableColumn> {
+    columns: Ref<T[]>;
+    onReorderEnd?: (columns: T[]) => void;
+}
+/**
+ * Composable for table column reordering with drag & drop
+ * Features:
+ * - Live reordering (columns swap during drag)
+ * - 50% threshold (swap only when crossing middle of target column)
+ * - Smooth transitions
+ * - Throttling for performance
+ */
+export declare function useTableColumnsReorder<T extends ReorderableColumn>(options: UseTableColumnsReorderOptions<T>): {
+    isDragging: Ref<boolean, boolean>;
+    handleDragStart: (columnId: string, event: DragEvent) => void;
+    handleDragOver: (event: DragEvent) => void;
+    handleDrop: (event: DragEvent) => void;
+    handleDragEnd: () => void;
+    getReorderHeadProps: (columnId: string) => {
+        reorderable: boolean;
+        columnId: string;
+        onReorderDragStart: (id: string | undefined, e: DragEvent) => void;
+        onReorderDragOver: (e: DragEvent) => void;
+        onReorderDrop: (id: string | undefined, e: DragEvent) => void;
+        onReorderDragEnd: () => void;
+    };
+};
+//# sourceMappingURL=useTableColumnsReorder.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useTableColumnsReorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableColumnsReorder.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useTableColumnsReorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,GAAG,EAAmB,MAAM,KAAK,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B,CAAC,CAAC,SAAS,iBAAiB;IACxE,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,EAChE,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC;;gCAQN,MAAM,SAAS,SAAS;4BAiC5B,SAAS;wBA8Cb,SAAS;;oCAqCG,MAAM;;;iCAGlB,MAAM,GAAG,SAAS,KAAK,SAAS;+BAClC,SAAS;4BACZ,MAAM,GAAG,SAAS,KAAK,SAAS;;;EAwBvD"}

package/dist/ui/components/organisms/vc-table/composables/useTableColumnsResize.d.ts

@@ -0,0 +1,25 @@
+import { Ref } from "vue";
+export interface ResizableColumn {
+    id: string;
+    width: number;
+}
+export interface UseTableColumnsResizeOptions {
+    columns: Ref<ResizableColumn[]>;
+    minColumnWidth?: number;
+    /** Returns the header cell DOM element for a given column id (for measuring flex columns) */
+    getColumnElement?: (id: string) => HTMLElement | null;
+    /** Returns all cell DOM elements for a given column id (for live resize updates) */
+    getAllColumnElements?: (id: string) => NodeListOf<Element> | null;
+    onResizeEnd?: (columns: ResizableColumn[]) => void;
+}
+export declare function useTableColumnsResize(options: UseTableColumnsResizeOptions): {
+    isResizing: Ref<boolean, boolean>;
+    handleResizeStart: (columnId: string, event: MouseEvent) => void;
+    getResizeHeadProps: (columnId: string, index: number) => {
+        resizable: boolean;
+        columnId: string;
+        isLastResizable: boolean;
+        onResizeStart: (id: string | undefined, e: MouseEvent) => void;
+    };
+};
+//# sourceMappingURL=useTableColumnsResize.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useTableColumnsResize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableColumnsResize.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useTableColumnsResize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,GAAG,EAAmB,MAAM,KAAK,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IACtD,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAClE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CACpD;AAqBD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B;;kCAuHpC,MAAM,SAAS,UAAU;mCAiHxB,MAAM,SAAS,MAAM;;;;4BAIrC,MAAM,GAAG,SAAS,KAAK,UAAU;;EAmBxD"}

package/dist/ui/components/organisms/vc-table/composables/useTableContext.d.ts

@@ -0,0 +1,12 @@
+import { type ComputedRef } from "vue";
+export interface TableContext<T = any> {
+    selectedRowIndex: ComputedRef<number | undefined>;
+    setSelectedRowIndex: (index: number | undefined) => void;
+    variant: ComputedRef<string | undefined>;
+}
+/**
+ * Hook to access table context from child components
+ * @returns Table context or null if not inside a Table component
+ */
+export declare function useTableContext<T = any>(): TableContext<T> | null;
+//# sourceMappingURL=useTableContext.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useTableContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableContext.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useTableContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAE/C,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACnC,gBAAgB,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACzD,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAEjE"}

package/dist/ui/components/organisms/vc-table/composables/useTableEditing.d.ts

@@ -0,0 +1,77 @@
+/**
+ * useTableEditing - Composable for cell and row editing (PrimeVue-style)
+ *
+ * Supports two editing modes:
+ * - cell: Click on a cell to edit it inline
+ * - row: Edit/Save/Cancel buttons per row
+ *
+ * This is different from useTableInlineEdit which handles bulk editing mode.
+ * Extracted from VcDataTable.vue for better modularity.
+ *
+ * Inspired by PrimeVue DataTable editMode patterns.
+ */
+import { type Ref } from "vue";
+export interface UseTableEditingOptions<T> {
+    /** Editing mode: cell or row */
+    editMode: Ref<"cell" | "row" | undefined>;
+    /** External editing rows (v-model:editingRows) */
+    editingRows?: Ref<T[] | undefined>;
+    /** Data key field for item identification */
+    dataKey: string;
+    /** Function to get unique key for an item */
+    getItemKey: (item: T, index: number) => string;
+}
+export interface CellEditEvent<T> {
+    data: T;
+    field: string;
+    index: number;
+}
+export interface CellEditCompleteEvent<T> extends CellEditEvent<T> {
+    newValue: unknown;
+}
+export interface RowEditEvent<T> {
+    data: T;
+    index: number;
+}
+export interface RowEditSaveEvent<T> extends RowEditEvent<T> {
+    newData: T;
+}
+/** Editing metadata for a row - stores copy of data being edited */
+export interface EditingMeta<T> {
+    data: T;
+    fields: string[];
+}
+export interface UseTableEditingReturn<T> {
+    /** Currently editing cell (for cell mode) */
+    editingCell: Ref<{
+        rowIndex: number;
+        field: string;
+    } | null>;
+    /** Internal array of rows being edited (for row mode) */
+    internalEditingRows: Ref<T[]>;
+    /** Snapshot of row data before editing (for cancel) */
+    editingRowSnapshot: Ref<Map<string, T>>;
+    /** Editing metadata - stores copies of rows being edited (PrimeVue-style) */
+    editingMeta: Ref<Record<number, EditingMeta<T>>>;
+    /** Check if a specific cell is being edited */
+    isCellEditing: (rowIndex: number, field: string) => boolean;
+    /** Start editing a cell */
+    startCellEdit: (item: T, field: string, rowIndex: number) => CellEditEvent<T>;
+    /** Complete cell editing with new value */
+    completeCellEdit: (item: T, field: string, rowIndex: number, newValue: unknown) => CellEditCompleteEvent<T>;
+    /** Cancel cell editing */
+    cancelCellEdit: (item: T, field: string, rowIndex: number) => CellEditEvent<T>;
+    /** Get the editing data for a row (copy that user edits) */
+    getEditingRowData: (item: T, rowIndex: number) => T;
+    /** Check if a specific row is being edited */
+    isRowEditing: (item: T) => boolean;
+    /** Start editing a row */
+    startRowEdit: (item: T, rowIndex: number) => RowEditEvent<T>;
+    /** Save row editing */
+    saveRowEdit: (item: T, rowIndex: number) => RowEditSaveEvent<T>;
+    /** Cancel row editing (restores original data) */
+    cancelRowEdit: (item: T, rowIndex: number) => RowEditEvent<T>;
+}
+export declare function useTableEditing<T extends Record<string, unknown>>(options: UseTableEditingOptions<T>): UseTableEditingReturn<T>;
+export default useTableEditing;
+//# sourceMappingURL=useTableEditing.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useTableEditing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableEditing.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useTableEditing.ts"],"names":[],"mappings":"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"}

package/dist/ui/components/organisms/vc-table/composables/useTableExpansion.d.ts

@@ -0,0 +1,40 @@
+/**
+ * useTableExpansion - Composable for expandable rows functionality
+ *
+ * Handles row expansion/collapse with efficient key-based lookup.
+ * Extracted from VcDataTable.vue for better modularity.
+ *
+ * Inspired by PrimeVue DataTable expandableRows patterns.
+ */
+import { type Ref, type ComputedRef } from "vue";
+export interface UseTableExpansionOptions<T> {
+    /** External expanded rows (v-model:expandedRows) */
+    expandedRows?: Ref<T[] | undefined>;
+    /** Function to get unique key for an item */
+    getItemKey: (item: T, index: number) => string;
+}
+export interface RowExpandEvent<T> {
+    data: T;
+    originalEvent: Event;
+}
+export interface UseTableExpansionReturn<T> {
+    /** Internal array of expanded rows */
+    internalExpandedRows: Ref<T[]>;
+    /** Set of expanded row keys for O(1) lookup */
+    expandedRowKeys: ComputedRef<Set<string>>;
+    /** Check if a specific row is expanded */
+    isRowExpanded: (item: T, index: number) => boolean;
+    /** Toggle row expansion state */
+    toggleRowExpansion: (item: T, index: number, event: Event) => RowExpandEvent<T>;
+    /** Expand a row */
+    expandRow: (item: T, index: number, event?: Event) => RowExpandEvent<T>;
+    /** Collapse a row */
+    collapseRow: (item: T, index: number, event?: Event) => RowExpandEvent<T>;
+    /** Expand all rows */
+    expandAll: (items: T[]) => void;
+    /** Collapse all rows */
+    collapseAll: () => void;
+}
+export declare function useTableExpansion<T extends Record<string, unknown>>(options: UseTableExpansionOptions<T>): UseTableExpansionReturn<T>;
+export default useTableExpansion;
+//# sourceMappingURL=useTableExpansion.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useTableExpansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableExpansion.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useTableExpansion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAwB,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAEvE,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,oDAAoD;IACpD,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IACpC,6CAA6C;IAC7C,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,aAAa,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,sCAAsC;IACtC,oBAAoB,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/B,+CAA+C;IAC/C,eAAe,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,0CAA0C;IAC1C,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,iCAAiC;IACjC,kBAAkB,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC;IAChF,mBAAmB;IACnB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC;IACxE,qBAAqB;IACrB,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1E,sBAAsB;IACtB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAChC,wBAAwB;IACxB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACnC,uBAAuB,CAAC,CAAC,CAAC,CAiH5B;AAED,eAAe,iBAAiB,CAAC"}

package/dist/ui/components/organisms/vc-table/composables/useTableFilter.d.ts

@@ -0,0 +1,25 @@
+import type { FilterValue } from "../types";
+export interface UseFilterStateOptions {
+    /** Called whenever a filter is applied/cleared with a flat payload for the backend */
+    onFilterChange?: (payload: Record<string, unknown>) => void;
+}
+/**
+ * Simple filter state composable for backend-driven filtering.
+ *
+ * Collects filter values and emits flat payloads for the backend to handle.
+ */
+export declare function useFilterState(options?: UseFilterStateOptions): {
+    filterValues: import("vue").Ref<Record<string, FilterValue>, Record<string, FilterValue>>;
+    updateFilter: (field: string, value: FilterValue) => void;
+    updateRangeFilter: (rangeFields: [string, string], value: {
+        start?: string;
+        end?: string;
+    }) => void;
+    clearFilter: (field: string) => void;
+    clearAllFilters: () => void;
+    buildPayload: () => Record<string, unknown>;
+    hasActiveFilters: import("vue").ComputedRef<boolean>;
+    activeFilterCount: import("vue").ComputedRef<number>;
+};
+export type UseFilterStateReturn = ReturnType<typeof useFilterState>;
+//# sourceMappingURL=useTableFilter.d.ts.map

package/dist/ui/components/organisms/vc-table/composables/useTableFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableFilter.d.ts","sourceRoot":"","sources":["../../../../../../ui/components/organisms/vc-table/composables/useTableFilter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC,sFAAsF;IACtF,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B;;0BASnC,MAAM,SAAS,WAAW;qCAOf,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;yBASrE,MAAM;;wBAoBT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EA4DjD;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}