@affino/datagrid-vue-app 0.1.29 → 0.1.31

package/README.md

@@ -718,6 +718,90 @@ Supported action keys for `actions` are:
 - `pinMenu`, `pinLeft`, `pinRight`, `unpin`
 - `clearFilter`, `addCurrentSelectionToFilter`, `selectAllValues`, `clearAllValues`, `applyFilter`, `cancelFilter`
 
+## Declarative Cell Menu
+
+`cell-menu` exposes the same native configuration direction as the header menu, so apps can tune the built-in cell context menu without replacing the renderer.
+
+```vue
+<script setup lang="ts">
+import { DataGrid, type DataGridCellMenuProp } from "@affino/datagrid-vue-app"
+
+const cellMenu: DataGridCellMenuProp = {
+  items: ["clipboard", "pasteSpecial", "edit"],
+  labels: {
+    pasteSpecial: "Paste special",
+  },
+  actions: {
+    copy: { label: "Copy value" },
+    pasteValues: { label: "Values only" },
+  },
+  customItems: [
+    {
+      key: "organize",
+      label: "Organize",
+      placement: "after:pasteSpecial",
+      kind: "submenu",
+      items: [
+        {
+          key: "duplicate",
+          label: "Duplicate cell",
+          onSelect: ({ columnKey, rowId }) => {
+            console.log("Duplicate", columnKey, rowId)
+          },
+        },
+      ],
+    },
+  ],
+  columns: {
+    owner: {
+      customItems: [
+        {
+          key: "inspect",
+          label: "Inspect cell",
+          placement: "start",
+          onSelect: ({ zone, columnKey, rowId, closeMenu }) => {
+            console.log(zone, columnKey, rowId)
+            closeMenu()
+          },
+        },
+      ],
+    },
+  },
+}
+</script>
+
+<template>
+  <DataGrid
+    :rows="rows"
+    :columns="columns"
+    :cell-menu="cellMenu"
+  />
+</template>
+```
+
+Supported built-in cell-menu sections:
+
+- `clipboard`: `cut`, `copy`, `paste`
+- `pasteSpecial`: `pasteValues`
+- `edit`: `clear`
+
+Supported cell-menu controls:
+
+- `items`: choose and order built-in sections (`clipboard`, `pasteSpecial`, `edit`)
+- `disabled`, `disabledReasons`, `labels`
+- `actions`: override built-in action `label`, `hidden`, `disabled`, and `disabledReason`
+- `customItems`: add custom items or nested submenus around the built-in sections
+- `columns[columnKey]`: per-column `items`, `hide`, `disabled`, `disabledReasons`, `labels`, `actions`, and `customItems`
+
+Custom cell-menu items support:
+
+- `key`, `kind`, `label`, `hidden`, `disabled`, `disabledReason`
+- `placement`: `start`, `end`, `before:clipboard`, `after:clipboard`, `before:pasteSpecial`, `after:pasteSpecial`, `before:edit`, `after:edit`
+- `onSelect(context)`: leaf callbacks receive `{ zone, columnKey, rowId, closeMenu }`
+- `items`: nested submenu entries when `kind: "submenu"`
+
+`Paste special -> Values only` uses the same native clipboard pipeline as ordinary paste. When the source copy came from the grid itself, the app runtime can preserve internal semantics instead of degrading to a plain system-clipboard round trip.
+
 Disabled sections and actions can expose a reason string so users see why a menu affordance is unavailable.
 - `trigger: "button"` disables the standard header `contextmenu` open path while keeping the menu button.
 - `trigger: "contextmenu"` keeps right-click open on the header cell and hides the button.
@@ -1751,6 +1835,9 @@ Saved views are a thin app-level envelope around unified state plus `viewMode`,
 - `insertRowsAt(index, rows)`
 - `insertRowBefore(rowId, rows)`
 - `insertRowAfter(rowId, rows)`
+- `runStructuralRowAction(action, rowId)`
+
+Use `runStructuralRowAction(...)` when row inserts or deletes must be delegated to a higher-level model such as a spreadsheet sheet/workbook that owns structural rewrite semantics. The built-in row-index menu and keyboard shortcuts route through the same entry point before falling back to generic row mutations.
 
 ### Selection
 

package/dist/DataGrid.d.ts

@@ -1,5 +1,6 @@
 import { type ExtractPublicPropTypes, type PropType, type VNode } from "vue";
 import { type CreateDataGridCoreOptions, type DataGridApi, type DataGridApiRowSelectionChangedEvent, type DataGridApiSelectionChangedEvent, type DataGridApiPluginDefinition, type DataGridAggregationModel, type DataGridColumnPin, type DataGridComputedFieldDefinition, type DataGridCoreServiceRegistry, type DataGridFilterSnapshot, type DataGridFormulaFieldDefinition, type DataGridFormulaFunctionRegistry, type DataGridGroupBySpec, type DataGridMigrateStateOptions, type DataGridRowNode, type DataGridRowSelectionSnapshot, type DataGridRowModel, type DataGridRowNodeInput, type DataGridSetStateOptions, type DataGridSortState, type DataGridUnifiedColumnState, type DataGridUnifiedState, type DataGridPivotSpec } from "@affino/datagrid-vue";
+import { defineDataGridStructuralRowActionHandler, type DataGridStructuralRowActionHandler, type DataGridStructuralRowActionId } from "./dataGridStructuralRowActions";
 import type { DataGridBivariantCallback } from "./types/bivariance";
 import type { DataGridAppToolbarModule } from "./host/DataGridModuleHost";
 import { type DataGridAppClientRowModelOptions, type DataGridAppColumnInput } from "./config/dataGridFormulaOptions";
@@ -35,6 +36,7 @@ export type DataGridFilterCellReader<TRow = unknown> = DataGridBivariantCallback
 ], unknown>;
 export declare function defineDataGridSelectionCellReader<TRow = unknown>(): <TReader extends DataGridSelectionCellReader<TRow>>(reader: TReader) => TReader;
 export declare function defineDataGridFilterCellReader<TRow = unknown>(): <TReader extends DataGridFilterCellReader<TRow>>(reader: TReader) => TReader;
+export { defineDataGridStructuralRowActionHandler };
 declare const dataGridProps: {
     readonly rows: {
         readonly type: PropType<readonly unknown[]>;
@@ -96,6 +98,10 @@ declare const dataGridProps: {
         readonly type: PropType<DataGridRowIndexMenuProp | undefined>;
         readonly default: undefined;
     };
+    readonly runStructuralRowAction: {
+        readonly type: PropType<DataGridStructuralRowActionHandler<Record<string, unknown>> | undefined>;
+        readonly default: undefined;
+    };
     readonly columnLayout: {
         readonly type: PropType<DataGridColumnLayoutProp | undefined>;
         readonly default: undefined;
@@ -296,6 +302,7 @@ export interface DataGridExposed<TRow = unknown> {
     getHistory: () => DataGridHistoryController;
     getApi: () => DataGridApi<TRow> | null;
     getSelectionAggregatesLabel: () => string;
+    runStructuralRowAction: (action: DataGridStructuralRowActionId, rowId: string | number) => Promise<boolean>;
     getState: () => DataGridUnifiedState<TRow> | null;
     getSavedView: () => DataGridSavedViewSnapshot<TRow & Record<string, unknown>> | null;
     migrateSavedView: (savedView: unknown, options?: DataGridMigrateStateOptions) => DataGridSavedViewSnapshot<TRow & Record<string, unknown>> | null;
@@ -364,6 +371,10 @@ declare const DataGridRuntimeComponent: import("vue").DefineComponent<{
         readonly type: PropType<DataGridRowIndexMenuProp | undefined>;
         readonly default: undefined;
     };
+    readonly runStructuralRowAction: {
+        readonly type: PropType<DataGridStructuralRowActionHandler<Record<string, unknown>> | undefined>;
+        readonly default: undefined;
+    };
     readonly columnLayout: {
         readonly type: PropType<DataGridColumnLayoutProp | undefined>;
         readonly default: undefined;
@@ -624,6 +635,10 @@ declare const DataGridRuntimeComponent: import("vue").DefineComponent<{
         readonly type: PropType<DataGridRowIndexMenuProp | undefined>;
         readonly default: undefined;
     };
+    readonly runStructuralRowAction: {
+        readonly type: PropType<DataGridStructuralRowActionHandler<Record<string, unknown>> | undefined>;
+        readonly default: undefined;
+    };
     readonly columnLayout: {
         readonly type: PropType<DataGridColumnLayoutProp | undefined>;
         readonly default: undefined;
@@ -866,6 +881,7 @@ declare const DataGridRuntimeComponent: import("vue").DefineComponent<{
     readonly viewMode: DataGridAppViewMode | undefined;
     readonly toolbarModules: readonly DataGridAppToolbarModule[];
     readonly history: DataGridHistoryProp | undefined;
+    readonly runStructuralRowAction: DataGridStructuralRowActionHandler<Record<string, unknown>> | undefined;
     readonly pageSize: number | undefined;
     readonly currentPage: number | undefined;
     readonly startupOrder: readonly import("@affino/datagrid-core").DataGridCoreServiceName[] | undefined;

package/dist/chunks/{DataGridGanttStage.vue_vue_type_script_setup_true_lang-Dsl2y3cS.js → DataGridGanttStage.vue_vue_type_script_setup_true_lang-DJ72Tgpd.js}

@@ -1,5 +1,5 @@
 import { defineComponent as _n, computed as d, ref as b, watch as fe, nextTick as Pt, onMounted as xn, onBeforeUnmount as En, openBlock as De, createElementBlock as We, createElementVNode as F, normalizeStyle as oe, createVNode as Cn, mergeProps as Ln, unref as Bn, createCommentVNode as Hn } from "vue";
-import { o as Gn, q as Vn, r as An, _ as Nn } from "./DataGridTableStage.vue_vue_type_script_setup_true_lang-Bg0_YlVn.js";
+import { o as Gn, q as Vn, r as An, _ as Nn } from "./DataGridTableStage.vue_vue_type_script_setup_true_lang-Q2ri6J1V.js";
 import { resolveDataGridGanttAnalysis as zn, buildDataGridGanttVisibleBars as Fn, buildDataGridGanttDependencyPaths as Xn, resolveDataGridGanttRangeFrame as je, buildDataGridTimelineRenderModels as Dt, resolveDataGridTimelineDateToPixel as Wt, resolveDataGridTimelineScrollLeftForDate as On, applyDataGridGanttDragDelta as $n, hitTestDataGridGanttBar as kt, clampDataGridTimelineScrollLeft as Kn, buildDataGridGanttRowEditPatch as Un } from "@affino/datagrid-gantt";
 const Me = 0.5, jn = 1.25;
 function Yn(s) {

package/dist/chunks/{DataGridGanttStageEntry-Dtor-tmD.js → DataGridGanttStageEntry-C4qhNhnp.js}

@@ -1,5 +1,5 @@
 import { defineComponent as e, h as r } from "vue";
-import { _ as a } from "./DataGridGanttStage.vue_vue_type_script_setup_true_lang-Dsl2y3cS.js";
+import { _ as a } from "./DataGridGanttStage.vue_vue_type_script_setup_true_lang-DJ72Tgpd.js";
 import { normalizeDataGridGanttOptions as n } from "@affino/datagrid-gantt";
 const m = e({
   name: "DataGridGanttStageEntry",