@affino/datagrid-vue-app 0.1.15 → 0.1.17

package/README.md

@@ -1019,6 +1019,8 @@ Supported preset names:
 
 The public component exposes full grid state round-tripping.
 
+When `state` is the only controlled input, the built-in app toolbar and filter affordances derive their effective sort, filter, grouping, and pivot state from that unified snapshot. You do not need to mirror the same payload back into separate `sort-model`, `filter-model`, `group-by`, or `pivot-model` props just to keep the default renderer synchronized.
+
 Controlled state:
 
 ```vue
@@ -1050,6 +1052,38 @@ function importState(raw: unknown) {
   }
 }
 
+`applyState()` and `applySavedView()` also queue the restore until the runtime and declared columns are ready. Host pages can restore presets before async column definitions finish loading instead of maintaining a separate pending-saved-view scheduler.
+
+Saved views sanitize transient transaction history before serialization and restore. The persisted envelope keeps layout, filters, grouping, pivoting, row selection, and `viewMode`, but drops undo/redo history.
+
+### Controlled Row Selection
+
+`rowSelection` still enables the built-in checkbox column and header select-all control. When a page wants to own the selected-row snapshot directly, use `rowSelectionState` with `update:rowSelectionState`.
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue"
+import { DataGrid } from "@affino/datagrid-vue-app"
+
+const rowSelectionState = ref({
+  focusedRow: null,
+  selectedRows: ["r2"],
+})
+</script>
+
+<template>
+  <DataGrid
+    :rows="rows"
+    :columns="columns"
+    row-selection
+    :row-selection-state="rowSelectionState"
+    @update:row-selection-state="rowSelectionState = $event"
+  />
+</template>
+```
+
+The legacy `row-select` event still exists, but `rowSelectionState` is the stable controlled API when the page wants to bind selected row ids without diffing unified-state updates.
+
 function exportSavedView() {
   return gridRef.value?.getSavedView()
 }

package/dist/DataGrid.d.ts

@@ -97,6 +97,10 @@ declare const _default: import("vue").DefineComponent<{
         type: BooleanConstructor;
         default: boolean;
     };
+    rowSelectionState: {
+        type: PropType<DataGridRowSelectionSnapshot | null | undefined>;
+        default: undefined;
+    };
     pageSize: {
         type: PropType<number | undefined>;
         default: undefined;
@@ -222,6 +226,7 @@ declare const _default: import("vue").DefineComponent<{
     "selection-change": (_payload: DataGridApiSelectionChangedEvent) => true;
     "row-selection-change": (_payload: DataGridApiRowSelectionChangedEvent) => true;
     "row-select": (_payload: DataGridRowSelectionSnapshot | null) => true;
+    "update:rowSelectionState": (_payload: DataGridRowSelectionSnapshot | null) => true;
     "update:columnState": (_payload: DataGridUnifiedColumnState | null) => true;
     "update:columnOrder": (_payload: readonly string[] | null) => true;
     "update:hiddenColumnKeys": (_payload: readonly string[] | null) => true;
@@ -315,6 +320,10 @@ declare const _default: import("vue").DefineComponent<{
         type: BooleanConstructor;
         default: boolean;
     };
+    rowSelectionState: {
+        type: PropType<DataGridRowSelectionSnapshot | null | undefined>;
+        default: undefined;
+    };
     pageSize: {
         type: PropType<number | undefined>;
         default: undefined;
@@ -440,6 +449,7 @@ declare const _default: import("vue").DefineComponent<{
     "onSelection-change"?: ((_payload: DataGridApiSelectionChangedEvent) => any) | undefined;
     "onRow-selection-change"?: ((_payload: DataGridApiRowSelectionChangedEvent) => any) | undefined;
     "onRow-select"?: ((_payload: DataGridRowSelectionSnapshot | null) => any) | undefined;
+    "onUpdate:rowSelectionState"?: ((_payload: DataGridRowSelectionSnapshot | null) => any) | undefined;
     "onUpdate:columnState"?: ((_payload: DataGridUnifiedColumnState | null) => any) | undefined;
     "onUpdate:columnOrder"?: ((_payload: readonly string[] | null) => any) | undefined;
     "onUpdate:hiddenColumnKeys"?: ((_payload: readonly string[] | null) => any) | undefined;
@@ -464,12 +474,12 @@ declare const _default: import("vue").DefineComponent<{
     isCellEditable: DataGridCellEditablePredicate<Record<string, unknown>> | undefined;
     rowSelection: boolean;
     gantt: DataGridGanttProp | undefined;
-    virtualization: DataGridVirtualizationProp | undefined;
-    pagination: DataGridPaginationProp | undefined;
     rowModel: DataGridRowModel<unknown> | undefined;
-    aggregations: DataGridAggregationsProp | undefined;
     baseRowHeight: number;
     state: DataGridUnifiedState<Record<string, unknown>> | null | undefined;
+    virtualization: DataGridVirtualizationProp | undefined;
+    pagination: DataGridPaginationProp | undefined;
+    aggregations: DataGridAggregationsProp | undefined;
     sortModel: readonly DataGridSortState[] | undefined;
     filterModel: DataGridFilterSnapshot | null | undefined;
     groupBy: DataGridGroupByProp | undefined;
@@ -493,11 +503,12 @@ declare const _default: import("vue").DefineComponent<{
     plugins: readonly DataGridApiPluginDefinition<unknown>[];
     services: DataGridRuntimeOverrides | undefined;
     autoStart: boolean;
+    columnState: DataGridUnifiedColumnState | null | undefined;
     computedFields: readonly DataGridComputedFieldDefinition<unknown>[] | null | undefined;
     formulas: readonly DataGridFormulaFieldDefinition[] | null | undefined;
     formulaFunctions: Readonly<Record<string, import("@affino/datagrid-formula-engine").DataGridFormulaFunctionDefinition | ((args: readonly import("@affino/datagrid-formula-engine").DataGridFormulaValue[], context?: import("@affino/datagrid-formula-engine").DataGridComputedFieldComputeContext<unknown>) => unknown)>> | null | undefined;
     aggregationModel: DataGridAggregationModel<Record<string, unknown>> | null | undefined;
-    columnState: DataGridUnifiedColumnState | null | undefined;
+    rowSelectionState: DataGridRowSelectionSnapshot | null | undefined;
     columnOrder: readonly string[] | null | undefined;
     hiddenColumnKeys: readonly string[] | null | undefined;
     columnWidths: Readonly<Record<string, number | null>> | null | undefined;