@affino/datagrid-vue 0.1.0 → 0.1.2

package/README.md

@@ -92,6 +92,10 @@ Compatibility entrypoint. New demo/workbench wiring should import `@affino/datag
 - `useDataGridViewportContextMenuRouter`
 - `useDataGridViewportBlurHandler`
 - `useDataGridViewportScrollLifecycle`
+- `useDataGridLinkedPaneScrollSync`
+- `useDataGridResizeClickGuard`
+- `useDataGridInitialViewportRecovery`
+- `useDataGridManagedWheelScroll`
 - `useDataGridClearSelectionLifecycle`
 - `useDataGridGlobalPointerLifecycle`
 - `useDataGridPointerAutoScroll`
@@ -104,6 +108,7 @@ Compatibility entrypoint. New demo/workbench wiring should import `@affino/datag
 - `useDataGridQuickFilterActions`
 - `useDataGridCellCoordNormalizer`
 - `useDataGridSelectionComparators`
+- `useDataGridRowSelectionModel`
 - `useDataGridPointerModifierPolicy`
 - `useDataGridHistoryActionRunner`
 - `useDataGridInlineEditorFocus`
@@ -130,6 +135,86 @@ const { api, columnSnapshot } = useDataGridRuntime({
 })
 ```
 
+## Managed wheel scroll (advanced)
+
+Use `useDataGridManagedWheelScroll` when you want deterministic wheel ownership (axis lock, preventDefault policy, and consistent header/body horizontal sync).
+
+```ts
+import { useDataGridManagedWheelScroll } from "@affino/datagrid-vue/advanced"
+
+const managedWheelScroll = useDataGridManagedWheelScroll({
+  resolveWheelMode: () => "managed", // "managed" | "native"
+  resolveWheelAxisLockMode: () => "dominant",
+  resolvePreventDefaultWhenHandled: () => true,
+  resolveBodyViewport: () => viewportRef.value,
+  resolveMainViewport: () => viewportRef.value
+    ? {
+        scrollLeft: viewportRef.value.scrollLeft,
+        scrollWidth: viewportRef.value.scrollWidth,
+        clientWidth: viewportRef.value.clientWidth,
+      }
+    : null,
+  setHandledScrollTop: (nextTop) => {
+    if (viewportRef.value) {
+      viewportRef.value.scrollTop = nextTop
+    }
+  },
+  setHandledScrollLeft: (nextLeft) => {
+    if (viewportRef.value) {
+      viewportRef.value.scrollLeft = nextLeft
+    }
+  },
+})
+
+function onViewportWheel(event: WheelEvent) {
+  managedWheelScroll.onBodyViewportWheel(event)
+}
+```
+
+```vue
+<div ref="viewportRef" @wheel="onViewportWheel" @scroll="onViewportScroll" />
+```
+
+- Call `managedWheelScroll.reset()` on unmount.
+- Keep DOM reads/writes in adapter/demo/UI layer; do not move wheel DOM handling into core.
+
+## Orchestration-heavy viewport integration
+
+Use orchestration primitives from `@affino/datagrid-vue/advanced` to keep component code thin while preserving high-fidelity interaction behavior.
+
+```ts
+import {
+  useDataGridLinkedPaneScrollSync,
+  useDataGridResizeClickGuard,
+  useDataGridInitialViewportRecovery,
+  useDataGridRowSelectionModel,
+} from "@affino/datagrid-vue/advanced"
+
+const linkedPaneSync = useDataGridLinkedPaneScrollSync({
+  resolveSourceScrollTop: () => viewportRef.value?.scrollTop ?? 0,
+  mode: "css-var",
+  resolveCssVarHost: () => gridRootRef.value,
+})
+
+const resizeGuard = useDataGridResizeClickGuard()
+
+const viewportRecovery = useDataGridInitialViewportRecovery({
+  resolveShouldRecover: () => totalRows.value > 1 && renderedRowsCount.value <= 1,
+  runRecoveryStep: () => syncViewportMetrics(),
+})
+
+const rowSelectionModel = useDataGridRowSelectionModel({
+  resolveFilteredRows: () => filteredRows.value,
+  resolveRowId: row => String(row.rowId),
+  resolveAllRows: () => allRows.value,
+})
+```
+
+Recommended ownership:
+- `@affino/datagrid-core`: deterministic data/runtime contracts.
+- `@affino/datagrid-orchestration`: interaction policies and state orchestration.
+- `@affino/datagrid-vue`: refs/template wiring and DOM lifecycle integration.
+
 ## 60-second integration (junior-friendly)
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@affino/datagrid-vue",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "author": "Anton Pavlov <a.pavlov@affino.dev>",
   "type": "module",
   "description": "Vue adapter and UI layer for @affino/datagrid-core (bootstrap fork from .tmp/ui-table/vue)",
@@ -38,8 +38,8 @@
     "@affino/datagrid-theme": "^0.1.0"
   },
   "dependencies": {
-    "@affino/datagrid-orchestration": "0.1.0",
-    "@affino/datagrid-core": "0.1.0"
+    "@affino/datagrid-core": "0.1.0",
+    "@affino/datagrid-orchestration": "0.1.2"
   },
   "devDependencies": {
     "@affino/datagrid-theme": "^0.1.0"