@affino/datagrid-vue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 affino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,338 @@
+# @affino/datagrid-vue
+
+Vue adapter surface for `@affino/datagrid-core`.
+
+## Stable API (`@affino/datagrid-vue`)
+
+- `createDataGridVueRuntime`
+- `useDataGridRuntime`
+- `useAffinoDataGrid`
+- `useAffinoDataGridUi`
+- `AffinoDataGridSimple`
+- `DataGrid`
+- `useDataGridSettingsStore`
+- `createDataGridSettingsAdapter`
+- `buildDataGridOverlayTransform`
+- `buildDataGridOverlayTransformFromSnapshot`
+- `mapDataGridA11yGridAttributes`
+- `mapDataGridA11yCellAttributes`
+- `useDataGridContextMenu`
+- `DATA_GRID_SELECTORS`
+- `DATA_GRID_DATA_ATTRS`
+- `dataGridCellSelector`
+- `dataGridHeaderCellSelector`
+- `dataGridResizeHandleSelector`
+
+Stable selector contract (for parity tests/integration-safe querying):
+
+```ts
+import {
+  DATA_GRID_SELECTORS,
+  dataGridCellSelector,
+} from "@affino/datagrid-vue"
+
+const viewportSelector = DATA_GRID_SELECTORS.viewport
+const ownerCellSelector = dataGridCellSelector("owner")
+```
+
+## Advanced API (`@affino/datagrid-vue/advanced`)
+
+Compatibility entrypoint. New demo/workbench wiring should import `@affino/datagrid-vue/internal`.
+
+- `useDataGridViewportBridge`
+- `useDataGridHeaderOrchestration`
+- `createDataGridHeaderBindings`
+- `useDataGridCellPointerDownRouter`
+- `useDataGridCellPointerHoverRouter`
+- `useDataGridDragSelectionLifecycle`
+- `useDataGridDragPointerSelection`
+- `useDataGridFillSelectionLifecycle`
+- `useDataGridFillHandleStart`
+- `useDataGridRangeMoveLifecycle`
+- `useDataGridRangeMoveStart`
+- `useDataGridSelectionMoveHandle`
+- `useDataGridTabTargetResolver`
+- `useDataGridCellNavigation`
+- `useDataGridClipboardValuePolicy`
+- `useDataGridCellDatasetResolver`
+- `useDataGridCellRangeHelpers`
+- `useDataGridNavigationPrimitives`
+- `useDataGridMutationSnapshot`
+- `useDataGridCellVisualStatePredicates`
+- `useDataGridRangeMutationEngine`
+- `useDataGridA11yCellIds`
+- `useDataGridColumnUiPolicy`
+- `useDataGridEditableValuePolicy`
+- `useDataGridMoveMutationPolicy`
+- `useDataGridInlineEditorSchema`
+- `useDataGridInlineEditOrchestration`
+- `useDataGridInlineEditorTargetNavigation`
+- `useDataGridInlineEditorKeyRouter`
+- `useDataGridHeaderContextActions`
+- `useDataGridCopyRangeHelpers`
+- `useDataGridHeaderSortOrchestration`
+- `useDataGridHeaderResizeOrchestration`
+- `useDataGridHeaderInteractionRouter`
+- `useDataGridColumnFilterOrchestration`
+- `useDataGridEnumTrigger`
+- `useDataGridGroupValueLabelResolver`
+- `useDataGridGroupMetaOrchestration`
+- `useDataGridGroupBadge`
+- `useDataGridGroupingSortOrchestration`
+- `useDataGridViewportMeasureScheduler`
+- `useDataGridVisibleRowsSyncScheduler`
+- `useDataGridColumnLayoutOrchestration`
+- `useDataGridSelectionOverlayOrchestration`
+- `useDataGridRowsProjection`
+- `useDataGridRowSelectionOrchestration`
+- `useDataGridRowSelectionInputHandlers`
+- `useDataGridVirtualRangeMetrics`
+- `useDataGridContextMenuAnchor`
+- `useDataGridContextMenuActionRouter`
+- `useDataGridViewportContextMenuRouter`
+- `useDataGridViewportBlurHandler`
+- `useDataGridViewportScrollLifecycle`
+- `useDataGridClearSelectionLifecycle`
+- `useDataGridGlobalPointerLifecycle`
+- `useDataGridPointerAutoScroll`
+- `useDataGridPointerPreviewRouter`
+- `useDataGridPointerCellCoordResolver`
+- `useDataGridAxisAutoScrollDelta`
+- `useDataGridCellVisibilityScroller`
+- `useDataGridGlobalMouseDownContextMenuCloser`
+- `useDataGridKeyboardCommandRouter`
+- `useDataGridQuickFilterActions`
+- `useDataGridCellCoordNormalizer`
+- `useDataGridSelectionComparators`
+- `useDataGridPointerModifierPolicy`
+- `useDataGridHistoryActionRunner`
+- `useDataGridInlineEditorFocus`
+- `useDataGridRowSelectionFacade`
+- `useDataGridFindReplaceFacade`
+- `useDataGridClipboardBridge`
+- `useDataGridClipboardMutations`
+- `useDataGridIntentHistory`
+
+## Quick start
+
+```ts
+import { ref } from "vue"
+import { useDataGridRuntime } from "@affino/datagrid-vue"
+
+const rows = ref([])
+const columns = ref([
+  { key: "service", label: "Service", width: 220 },
+])
+
+const { api, columnSnapshot } = useDataGridRuntime({
+  rows,
+  columns,
+})
+```
+
+## 60-second integration (junior-friendly)
+
+```ts
+import { ref } from "vue"
+import { AffinoDataGridSimple } from "@affino/datagrid-vue/components"
+
+const rows = ref([
+  { rowId: "1", service: "edge-gateway", owner: "NOC" },
+  { rowId: "2", service: "billing-api", owner: "Payments" },
+])
+
+const columns = [
+  { key: "service", label: "Service", width: 220 },
+  { key: "owner", label: "Owner", width: 180 },
+]
+```
+
+```vue
+<AffinoDataGridSimple
+  v-model:rows="rows"
+  :columns="columns"
+  :features="{ selection: true, clipboard: true, editing: true }"
+/>
+```
+
+- Includes pre-wired sort, row-selection, context-menu, clipboard and inline edit.
+- Emits `update:rows`, `update:status`, and `action` for app-level integration.
+
+## High-level sugar API
+
+```ts
+import { ref } from "vue"
+import { useAffinoDataGrid } from "@affino/datagrid-vue"
+
+const rows = ref([
+  { rowId: "1", service: "edge-gateway", owner: "NOC" },
+  { rowId: "2", service: "billing-api", owner: "Payments" },
+])
+
+const columns = ref([
+  { key: "service", label: "Service", width: 220 },
+  { key: "owner", label: "Owner", width: 180 },
+])
+
+const grid = useAffinoDataGrid({
+  rows,
+  columns,
+  features: {
+    selection: true,
+    clipboard: true,
+    editing: {
+      mode: "cell",
+      enum: true,
+    },
+    filtering: {
+      enabled: true,
+      initialFilterModel: {
+        columnFilters: {},
+        advancedFilters: {},
+      },
+    },
+    summary: {
+      enabled: true,
+      columns: [
+        { key: "owner", aggregations: ["countDistinct"] },
+      ],
+    },
+    visibility: {
+      enabled: true,
+      hiddenColumnKeys: [],
+    },
+    tree: {
+      enabled: true,
+      initialGroupBy: {
+        fields: ["owner"],
+        expandedByDefault: true,
+      },
+    },
+    interactions: {
+      enabled: true,
+      range: { enabled: true, fill: true, move: true },
+    },
+    headerFilters: {
+      enabled: true,
+      maxUniqueValues: 300,
+    },
+    feedback: {
+      enabled: true,
+      maxEvents: 120,
+    },
+    statusBar: {
+      enabled: true,
+    },
+    keyboardNavigation: true,
+  },
+})
+
+type Grid = ReturnType<typeof useAffinoDataGrid>
+// grid is fully typed and safe to destructure.
+```
+
+Row identity contract (required):
+
+- Each row must expose a stable non-empty `rowId` (or `id`/`key`), or
+- Provide `features.selection.resolveRowKey(row, index)`.
+- Index-based fallback keys are intentionally not used.
+
+```vue
+<th v-for="column in columns" :key="column.key" v-bind="grid.bindings.headerCell(column.key)">
+  {{ column.label }}
+</th>
+
+<td
+  v-for="column in columns"
+  :key="column.key"
+  v-bind="grid.bindings.dataCell({ row, rowIndex, columnKey: column.key, value: row[column.key] })"
+>
+  <input
+    v-if="grid.bindings.isCellEditing(String(row.rowId), column.key)"
+    v-bind="grid.bindings.inlineEditor({ rowKey: String(row.rowId), columnKey: column.key })"
+  />
+  <span v-else>{{ row[column.key] }}</span>
+</td>
+```
+
+- `grid.componentProps` can be passed into `<DataGrid v-bind="grid.componentProps" />`.
+- `grid.bindings` provides ready wiring helpers:
+  - `grid.bindings.headerSort(column.key)` for sortable header handlers/ARIA.
+  - `grid.bindings.rowSelection(row, rowIndex)` for row selection click/keyboard behavior.
+  - `grid.bindings.editableCell({ row, rowIndex, columnKey })` + `grid.bindings.inlineEditor(...)` for inline edit flows.
+  - `grid.bindings.headerCell(column.key)` and `grid.bindings.dataCell(...)` for pre-wired sort/edit + context-menu behavior.
+  - `grid.bindings.contextMenuRoot()` + `grid.bindings.contextMenuAction(action.id)` for menu keyboard/click wiring.
+  - `grid.bindings.actionButton("copy" | "cut" | "paste" | ...)` for toolbar-level actions.
+- `grid.actions` provides no-router commands for common flows:
+  - `runAction("copy" | "cut" | "paste" | "clear" | "sort-asc" | "sort-desc" | "sort-clear")`
+  - `copySelectedRows()`, `cutSelectedRows()`, `pasteRowsAppend()`, `clearSelectedRows()`, `selectAllRows()`
+  - Mutating clipboard flows (`clear/cut/paste`) are intent-transaction backed in sugar path (undo/redo-capable when history controls are wired).
+- `grid.contextMenu` wraps menu state + keyboard support + action execution:
+  - `open(x, y, { zone, columnKey?, rowId? })`
+  - `runAction(actionId)` (maps directly into `grid.actions`)
+- `grid.features.filtering` exposes `model`, `setModel`, `setAdvancedExpression`, and `clear`.
+- `grid.features.filtering.helpers` provides typed advanced-filter helpers:
+  - `setText`, `setNumber`, `setDate`, `setSet`, `apply`, `clearByKey`
+  - merge modes: `replace | merge-and | merge-or`
+  - set value modes: `replace | append | remove`
+- `grid.features.summary.selected` returns deterministic aggregates for current selection scope.
+- `grid.features.visibility` exposes `setColumnVisible`, `toggleColumnVisible`, `setHiddenColumnKeys`, `reset`.
+- `grid.features.tree` exposes `groupBy`, `groupExpansion`, `setGroupBy`, `toggleGroup`, `expandAll`, `collapseAll`.
+- `grid.features.rowHeight` exposes `setMode("fixed" | "auto")`, `setBase(height)`, `measureVisible()`.
+- `features.keyboardNavigation: true` enables out-of-the-box shortcuts and cell navigation:
+  - `Cmd/Ctrl+C`, `Cmd/Ctrl+X`, `Cmd/Ctrl+V`, `Delete/Backspace`
+  - `Cmd/Ctrl+Z`, `Cmd/Ctrl+Shift+Z`, `Cmd/Ctrl+Y`
+  - arrows/home/end/page/tab/enter range navigation on focused grid cells
+- `grid.pagination` exposes first/prev/next/last + snapshot wrappers.
+- `grid.columnState` exposes `capture/apply` and point updates (`setOrder`, `setVisibility`, `setWidth`, `setPin`).
+- `grid.history` exposes `supported/canUndo/canRedo/undo/redo`.
+- `grid.rowReorder` exposes guarded client-side reorder (`moveByIndex`, `moveByKey`).
+- `grid.cellSelection` exposes anchor/focus/range model (`setCellByKey`, `isCellSelected`, `clear`).
+- `grid.cellRange` exposes range clipboard/fill/move (`copy`, `cut`, `paste`, `clear`, `applyFillPreview`, `applyRangeMove`).
+- `grid.features.interactions.range` provides declarative fill/move lifecycle flags.
+- `grid.bindings.rangeHandle` + `grid.bindings.rangeSurface` wire fill/move without page-local pointer logic.
+- `grid.bindings.columnResizeHandle` + `grid.bindings.rowResizeHandle` provide drag/keyboard/double-click autosize.
+- `grid.features.headerFilters` provides Excel-style popover model (`open/toggle/query/operators/unique-values/select-only/select-all`).
+- `grid.feedback` exposes unified event stream for action/context/history/range/header-filter flows.
+- `grid.contextMenu` parity helpers: `openForActiveCell`, `openForHeader`, `groupedActions`, disabled reason helpers.
+- `grid.features.editing.enumEditor` exposes Affino enum-editor contract (`primitive`, `resolveOptions`).
+- `grid.layoutProfiles` exposes save/apply/remove/clear for sort/filter/group/column snapshots.
+- `grid.statusBar` exposes built-in metrics model and summary accessors for status bar UIs.
+
+## Complete integration playbook
+
+For end-to-end integration (tree rendering contract, advanced-filter AST cookbook, interaction/hotkey contract, and full-page setup), use:
+
+- `/Users/anton/Projects/affinio/docs/datagrid-vue-sugar-playbook.md`
+- `/Users/anton/Projects/affinio/docs/datagrid-sheets-user-interactions-and-integrator-api.md`
+
+## Junior-first UI wrapper
+
+```ts
+import { ref } from "vue"
+import { useAffinoDataGridUi } from "@affino/datagrid-vue"
+
+const status = ref("Ready")
+const grid = useAffinoDataGridUi({
+  rows,
+  columns,
+  status,
+  features: {
+    selection: true,
+    clipboard: true,
+    editing: true,
+  },
+})
+```
+
+```vue
+<button v-bind="grid.ui.bindToolbarAction('copy')">Copy</button>
+<th v-bind="grid.ui.bindHeaderCell(column.key)">{{ column.label }}</th>
+<td v-bind="grid.ui.bindDataCell({ row, rowIndex, columnKey: column.key, value: row[column.key] })">
+  <input
+    v-if="grid.ui.isCellEditing(String(row.rowId), column.key)"
+    v-bind="grid.ui.bindInlineEditor({ rowKey: String(row.rowId), columnKey: column.key })"
+  />
+</td>
+```
+- Demo-level orchestration can be imported from `@affino/datagrid-vue/internal`.

package/dist/adapters/a11yAttributesAdapter.d.ts

@@ -0,0 +1,20 @@
+import type { DataGridA11yCellAriaState, DataGridA11yGridAriaState } from "@affino/datagrid-core/advanced";
+export interface DataGridA11yGridAttributeMap {
+    role: "grid";
+    tabindex: number;
+    "aria-rowcount": number;
+    "aria-colcount": number;
+    "aria-activedescendant"?: string;
+    "aria-multiselectable": "true" | "false";
+}
+export interface DataGridA11yCellAttributeMap {
+    id: string;
+    role: "gridcell";
+    tabindex: number;
+    "aria-rowindex": number;
+    "aria-colindex": number;
+    "aria-selected": "true" | "false";
+}
+export declare function mapDataGridA11yGridAttributes(state: DataGridA11yGridAriaState): DataGridA11yGridAttributeMap;
+export declare function mapDataGridA11yCellAttributes(state: DataGridA11yCellAriaState): DataGridA11yCellAttributeMap;
+//# sourceMappingURL=a11yAttributesAdapter.d.ts.map

package/dist/adapters/a11yAttributesAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11yAttributesAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/a11yAttributesAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAA;AAEvC,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,sBAAsB,EAAE,MAAM,GAAG,OAAO,CAAA;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,GAAG,OAAO,CAAA;CAClC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,yBAAyB,GAC/B,4BAA4B,CAY9B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,yBAAyB,GAC/B,4BAA4B,CAS9B"}

package/dist/adapters/a11yAttributesAdapter.js

@@ -0,0 +1,23 @@
+export function mapDataGridA11yGridAttributes(state) {
+    const attributes = {
+        role: state.role,
+        tabindex: state.tabIndex,
+        "aria-rowcount": state.ariaRowCount,
+        "aria-colcount": state.ariaColCount,
+        "aria-multiselectable": state.ariaMultiselectable ? "true" : "false",
+    };
+    if (state.ariaActiveDescendant) {
+        attributes["aria-activedescendant"] = state.ariaActiveDescendant;
+    }
+    return attributes;
+}
+export function mapDataGridA11yCellAttributes(state) {
+    return {
+        id: state.id,
+        role: state.role,
+        tabindex: state.tabIndex,
+        "aria-rowindex": state.ariaRowIndex,
+        "aria-colindex": state.ariaColIndex,
+        "aria-selected": state.ariaSelected ? "true" : "false",
+    };
+}

package/dist/adapters/adapterLifecycle.d.ts

@@ -0,0 +1,12 @@
+export interface AdapterDiagnostics {
+    initialized: boolean;
+    disposed: boolean;
+    syncCount: number;
+}
+export interface AdapterLifecycle<InitInput, SyncInput, Diagnostics extends AdapterDiagnostics = AdapterDiagnostics> {
+    init(input?: InitInput): void;
+    sync(input: SyncInput): void;
+    teardown(): void;
+    diagnostics(): Diagnostics;
+}
+//# sourceMappingURL=adapterLifecycle.d.ts.map

package/dist/adapters/adapterLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterLifecycle.d.ts","sourceRoot":"","sources":["../../src/adapters/adapterLifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,SAAS,kBAAkB,GAAG,kBAAkB;IACjH,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IAC7B,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAC5B,QAAQ,IAAI,IAAI,CAAA;IAChB,WAAW,IAAI,WAAW,CAAA;CAC3B"}

package/dist/adapters/adapterLifecycle.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/clipboardAdapter.d.ts

@@ -0,0 +1,3 @@
+import type { ClipboardAdapter } from "../../core/dom/domAdapters";
+export declare function createClipboardAdapter(): ClipboardAdapter;
+//# sourceMappingURL=clipboardAdapter.d.ts.map

package/dist/adapters/clipboardAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboardAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/clipboardAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAElE,wBAAgB,sBAAsB,IAAI,gBAAgB,CAmCzD"}

package/dist/adapters/clipboardAdapter.js

@@ -0,0 +1,38 @@
+export function createClipboardAdapter() {
+    return {
+        async writeText(value) {
+            if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+                await navigator.clipboard.writeText(value);
+                return;
+            }
+            if (typeof document === "undefined") {
+                throw new Error("Clipboard API unavailable");
+            }
+            const textarea = document.createElement("textarea");
+            textarea.value = value;
+            textarea.setAttribute("readonly", "");
+            textarea.style.position = "fixed";
+            textarea.style.opacity = "0";
+            document.body.appendChild(textarea);
+            textarea.select();
+            try {
+                const execCommand = document.execCommand;
+                if (typeof execCommand === "function") {
+                    execCommand.call(document, "copy");
+                }
+                else {
+                    throw new Error("execCommand unavailable");
+                }
+            }
+            finally {
+                document.body.removeChild(textarea);
+            }
+        },
+        async readText() {
+            if (typeof navigator !== "undefined" && navigator.clipboard?.readText) {
+                return navigator.clipboard.readText();
+            }
+            throw new Error("Clipboard read unavailable");
+        },
+    };
+}

package/dist/adapters/columnPinNormalization.d.ts

@@ -0,0 +1,14 @@
+export type ColumnPinPosition = "left" | "right" | "none";
+export interface ColumnPinNormalizationInput {
+    isSystem?: boolean;
+    pin?: unknown;
+    sticky?: unknown;
+    stickyLeft?: unknown;
+    stickyRight?: unknown;
+    [key: string]: unknown;
+}
+export declare function resolveColumnPinPosition(input: ColumnPinNormalizationInput): ColumnPinPosition;
+export declare function normalizeColumnPinInput<TColumn extends ColumnPinNormalizationInput>(column: TColumn): TColumn & {
+    pin: ColumnPinPosition;
+};
+//# sourceMappingURL=columnPinNormalization.d.ts.map

package/dist/adapters/columnPinNormalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnPinNormalization.d.ts","sourceRoot":"","sources":["../../src/adapters/columnPinNormalization.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAEzD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAyBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,2BAA2B,GAAG,iBAAiB,CAmB9F;AAED,wBAAgB,uBAAuB,CAAC,OAAO,SAAS,2BAA2B,EACjF,MAAM,EAAE,OAAO,GACd,OAAO,GAAG;IAAE,GAAG,EAAE,iBAAiB,CAAA;CAAE,CAmBtC"}

package/dist/adapters/columnPinNormalization.js

@@ -0,0 +1,55 @@
+function hasLegacyLeftPin(input) {
+    const rawPinned = input.pinned;
+    const rawLock = input.lock;
+    const rawLocked = input.locked;
+    if (rawPinned === true || rawPinned === "left")
+        return true;
+    if (rawLock === "left" || rawLocked === true)
+        return true;
+    if (input.sticky === "left")
+        return true;
+    if (input.stickyLeft === true || typeof input.stickyLeft === "number")
+        return true;
+    return false;
+}
+function hasLegacyRightPin(input) {
+    const rawPinned = input.pinned;
+    const rawLock = input.lock;
+    if (rawPinned === "right")
+        return true;
+    if (rawLock === "right")
+        return true;
+    if (input.sticky === "right")
+        return true;
+    if (input.stickyRight === true || typeof input.stickyRight === "number")
+        return true;
+    return false;
+}
+export function resolveColumnPinPosition(input) {
+    if (input.isSystem === true) {
+        return "left";
+    }
+    if (input.pin === "left" || input.pin === "right") {
+        return input.pin;
+    }
+    if (input.pin === "none") {
+        return "none";
+    }
+    if (hasLegacyLeftPin(input)) {
+        return "left";
+    }
+    if (hasLegacyRightPin(input)) {
+        return "right";
+    }
+    return "none";
+}
+export function normalizeColumnPinInput(column) {
+    const normalized = { ...column, pin: resolveColumnPinPosition(column) };
+    delete normalized.pinned;
+    delete normalized.lock;
+    delete normalized.locked;
+    delete normalized.sticky;
+    delete normalized.stickyLeft;
+    delete normalized.stickyRight;
+    return normalized;
+}

package/dist/adapters/hoverEnvironment.d.ts

@@ -0,0 +1,3 @@
+import type { HoverDelegationEnvironment } from "../../core/dom/domAdapters";
+export declare function createHoverDelegationEnvironment(target?: typeof globalThis): HoverDelegationEnvironment;
+//# sourceMappingURL=hoverEnvironment.d.ts.map

package/dist/adapters/hoverEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hoverEnvironment.d.ts","sourceRoot":"","sources":["../../src/adapters/hoverEnvironment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AAI5E,wBAAgB,gCAAgC,CAAC,MAAM,GAAE,OAAO,UAAgC,GAAG,0BAA0B,CAqB5H"}

package/dist/adapters/hoverEnvironment.js

@@ -0,0 +1,24 @@
+import { scheduleMeasurement } from "../../core/runtime/measurementQueue";
+const defaultGlobalObject = typeof window !== "undefined" ? window : globalThis;
+export function createHoverDelegationEnvironment(target = defaultGlobalObject) {
+    return {
+        measurement: {
+            measure: callback => scheduleMeasurement(callback).promise,
+        },
+        frame: {
+            schedule: callback => {
+                if (typeof target.requestAnimationFrame === "function") {
+                    return target.requestAnimationFrame(() => callback());
+                }
+                return target.setTimeout(callback, 16);
+            },
+            cancel: handle => {
+                if (typeof target.cancelAnimationFrame === "function") {
+                    target.cancelAnimationFrame(handle);
+                    return;
+                }
+                target.clearTimeout(handle);
+            },
+        },
+    };
+}

package/dist/adapters/selectionControllerAdapter.d.ts

@@ -0,0 +1,30 @@
+import type { ShallowRef } from "vue";
+import type { SelectionController, SelectionControllerListener } from "@affino/datagrid-core/selection/headlessSelectionController";
+import type { SelectionEnvironment, SelectionOverlaySnapshot, SelectionRange } from "@affino/datagrid-core/selection/selectionEnvironment";
+import type { GridSelectionContext } from "@affino/datagrid-core/selection/selectionState";
+import type { HeadlessSelectionState } from "@affino/datagrid-core/selection/update";
+import type { PointerCoordinates } from "@affino/datagrid-core/selection/autoScroll";
+import { type SelectionHeadlessAdapterDiagnostics, type SelectionHeadlessAdapterSyncInput } from "./selectionHeadlessAdapter";
+export interface SelectionControllerAdapterOptions<RowKey> {
+    environment: SelectionEnvironment<RowKey>;
+    context: GridSelectionContext<RowKey>;
+    initialState?: HeadlessSelectionState<RowKey>;
+}
+export interface SelectionControllerAdapter<RowKey> {
+    controller: SelectionController<RowKey>;
+    state: ShallowRef<HeadlessSelectionState<RowKey>>;
+    overlaySnapshot: ShallowRef<SelectionOverlaySnapshot | null>;
+    fillHandleRange: ShallowRef<SelectionRange<RowKey> | null>;
+    autoscrollState: ShallowRef<{
+        active: boolean;
+        pointer: PointerCoordinates | null;
+    }>;
+    subscribe(listener: SelectionControllerListener<RowKey>): () => void;
+    init(): void;
+    sync(input: SelectionHeadlessAdapterSyncInput<RowKey>): void;
+    teardown(): void;
+    diagnostics(): SelectionHeadlessAdapterDiagnostics;
+    dispose(): void;
+}
+export declare function createSelectionControllerAdapter<RowKey>(options: SelectionControllerAdapterOptions<RowKey>): SelectionControllerAdapter<RowKey>;
+//# sourceMappingURL=selectionControllerAdapter.d.ts.map

package/dist/adapters/selectionControllerAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionControllerAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/selectionControllerAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAA;AACnI,OAAO,KAAK,EACX,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,MAAM,sDAAsD,CAAA;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAA;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAA;AAEpF,OAAO,EAEN,KAAK,mCAAmC,EACxC,KAAK,iCAAiC,EACtC,MAAM,4BAA4B,CAAA;AAEnC,MAAM,WAAW,iCAAiC,CAAC,MAAM;IACxD,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACzC,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACrC,YAAY,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA;CAC7C;AAED,MAAM,WAAW,0BAA0B,CAAC,MAAM;IACjD,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACvC,KAAK,EAAE,UAAU,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAA;IACjD,eAAe,EAAE,UAAU,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAA;IAC5D,eAAe,EAAE,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;IAC1D,eAAe,EAAE,UAAU,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IACpF,SAAS,CAAC,QAAQ,EAAE,2BAA2B,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAA;IACpE,IAAI,IAAI,IAAI,CAAA;IACZ,IAAI,CAAC,KAAK,EAAE,iCAAiC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5D,QAAQ,IAAI,IAAI,CAAA;IAChB,WAAW,IAAI,mCAAmC,CAAA;IAClD,OAAO,IAAI,IAAI,CAAA;CACf;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EACtD,OAAO,EAAE,iCAAiC,CAAC,MAAM,CAAC,GAChD,0BAA0B,CAAC,MAAM,CAAC,CAuGpC"}