logisheets-engine 1.1.1 → 1.1.2

package/dist/types/lib/adapters/react.d.ts

@@ -5,7 +5,7 @@
  */
 import type { SelectedData, SheetInfo, CellLayout } from "logisheets-web";
 import type { Grid, EngineConfig } from "$types/index";
-import type { ContextMenuItem, ContextMenuContext } from "../components/contextMenuTypes";
+import type { ContextMenuContext } from "../components/contextMenuTypes";
 /**
  * Props for the React Spreadsheet component adapter.
  * These mirror the Svelte component props but follow React conventions.
@@ -23,8 +23,6 @@ export interface SpreadsheetAdapterProps {
     showSheetTabs?: boolean;
     /** Show scrollbars */
     showScrollbars?: boolean;
-    /** Custom context menu items */
-    contextMenuItems?: ContextMenuItem[];
     /** Callback when selection changes */
     onSelectedDataChange?: (data: SelectedData) => void;
     /** Callback when active sheet changes */
@@ -33,8 +31,11 @@ export interface SpreadsheetAdapterProps {
     onGridChange?: (grid: Grid | null) => void;
     /** Callback when sheets list changes */
     onSheetsChange?: (sheets: readonly SheetInfo[]) => void;
-    /** Callback when context menu item is clicked */
-    onContextMenuItemClick?: (item: ContextMenuItem, context: ContextMenuContext | null) => void;
+    /**
+     * The user opened the context menu. The engine renders no menu — the host
+     * renders its own at `(x, y)` (viewport coords) using `context`.
+     */
+    onContextMenu?: (context: ContextMenuContext, x: number, y: number) => void;
 }
 /**
  * LogiSheets-compatible props that follow the existing LogiSheets naming conventions.

package/dist/types/lib/components/contextMenuTypes.d.ts

@@ -17,6 +17,28 @@ export interface ContextMenuItem {
     shortcut?: string;
     /** Sub-menu items (if any) */
     children?: ContextMenuItem[];
+    /**
+     * Which trigger targets this item applies to. When omitted the item shows
+     * for every target; otherwise it only shows when the menu was opened on one
+     * of the listed targets (e.g. `["row", "column"]` for an insert/delete
+     * action, `["cell"]` for "Clear Cells").
+     */
+    targets?: ContextMenuTarget[];
+    /**
+     * Item kind. `"action"` (default) is a plain clickable row. `"stepper"`
+     * renders an inline numeric control (− value +) the user adjusts in place;
+     * its current value is passed as the third argument to the menu's click
+     * handler for every action item, so a sibling action (e.g. "Insert rows
+     * above") can act on the chosen amount. A stepper row is not itself
+     * clickable and does not close the menu.
+     */
+    type?: "action" | "stepper";
+    /** Minimum value for a `stepper` item (default 1). */
+    min?: number;
+    /** Maximum value for a `stepper` item (default 1000). */
+    max?: number;
+    /** Initial value for a `stepper` item (default `min`). */
+    value?: number;
 }
 /**
  * The target type where context menu was triggered

package/dist/types/lib/index.d.ts

@@ -1,5 +1,5 @@
 export { Spreadsheet, ColumnHeaders, RowHeaders, Selector, SheetTabs, Scrollbar, ContextMenu, match, xForColStart, xForColEnd, yForRowStart, yForRowEnd, getPosition, getSelectedCellRange, getSelectedRows, getSelectedColumns, getSelectedLines, findVisibleRowIdxRange, findVisibleColIdxRange, buildSelectedDataFromCell, buildSelectedDataFromCellRange, ptToPx, pxToPt, pxToWidth, simpleUuid, } from "./components";
-export type { ContextMenuItem, ContextMenuContext, } from "./components/contextMenuTypes";
+export type { ContextMenuItem, ContextMenuContext, ContextMenuTarget, } from "./components/contextMenuTypes";
 export { DataService, WorkbookClient, OffscreenClient } from "./clients";
 export { WorkbookWorkerService, OffscreenWorkerService } from "./worker";
 export { BlockManager, EnumSetManager, FieldManager, LOGISHEETS_BUILTIN_CRAFT_ID, FIELD_AND_VALIDATION_TAG, } from "./block";

package/dist/types/lib/session.d.ts

@@ -18,9 +18,9 @@
 import type { SheetInfo, SelectedData, CellLayout } from "logisheets-web";
 import type { DataService } from "./clients/service";
 import type { Grid, EngineConfig } from "$types/index";
-import type { ContextMenuItem } from "./components/contextMenuTypes";
+import type { ContextMenuContext } from "./components/contextMenuTypes";
 /** Events scoped to a single view. */
-export type SessionEventType = "selectionChange" | "gridChange" | "activeSheetChange" | "startEdit" | "invalidFormula" | "error";
+export type SessionEventType = "selectionChange" | "gridChange" | "activeSheetChange" | "startEdit" | "invalidFormula" | "contextMenu" | "error";
 export interface SessionEventMap {
     selectionChange: SelectedData;
     gridChange: Grid | null;
@@ -31,6 +31,17 @@ export interface SessionEventMap {
         initialText: string;
     };
     invalidFormula: void;
+    /**
+     * The user opened the context menu (right-clicked a cell or a row/column
+     * header). The engine renders NO menu of its own — the host listens for
+     * this and renders whatever menu it likes at `(x, y)` (viewport
+     * coordinates), using `context` to decide the items.
+     */
+    contextMenu: {
+        context: ContextMenuContext;
+        x: number;
+        y: number;
+    };
     error: Error;
 }
 type SessionEventCallback<T extends SessionEventType> = (data: SessionEventMap[T]) => void;
@@ -39,8 +50,6 @@ export interface SessionMountOptions {
     showSheetTabs?: boolean;
     /** Show scrollbars */
     showScrollbars?: boolean;
-    /** Custom context menu items */
-    contextMenuItems?: ContextMenuItem[];
     /** Cell layouts for custom rendering */
     cellLayouts?: CellLayout[];
     /** Getter for whether a formula is being edited (prevents canvas from taking focus) */

package/package.json

@@ -2,7 +2,7 @@
     "name": "logisheets-engine",
     "author": "Jeremy He<yiliang.he@qq.com>",
     "license": "MIT",
-    "version": "1.1.1",
+    "version": "1.1.2",
     "description": "LogiSheets spreadsheet engine - a high-performance spreadsheet rendering and editing library",
     "type": "module",
     "main": "./dist/logisheets-engine.umd.js",