@gridsheet/preact-core 3.3.0 → 3.4.1

package/dist/lib/menu.d.ts

@@ -66,9 +66,22 @@ export type MenuComponentItem<Args extends unknown[] = []> = {
     componentId: string;
     visible?: (ctx: MenuContext, ...args: Args) => boolean;
 };
-export type ContextMenuItemDescriptor = MenuDividerItem | MenuItemBase | MenuComponentItem;
-export type RowMenuItemDescriptor = MenuDividerItem | MenuItemBase<[y: number]> | MenuComponentItem<[y: number]>;
-export type ColMenuItemDescriptor = MenuDividerItem | MenuItemBase<[x: number]> | MenuComponentItem<[x: number]>;
+/**
+ * A menu entry that opens a nested flyout of child items on hover. `children` uses the same
+ * descriptor shape (items, dividers, or further submenus), so menus can nest arbitrarily —
+ * useful when a category (e.g. cell "Format") has more options than fit in one flat list.
+ */
+export type MenuSubmenuItem<Args extends unknown[] = []> = {
+    type: 'submenu';
+    id?: string;
+    label: string | ((ctx: MenuContext, ...args: Args) => string);
+    visible?: (ctx: MenuContext, ...args: Args) => boolean;
+    disabled?: (ctx: MenuContext, ...args: Args) => boolean;
+    children: (MenuDividerItem | MenuItemBase<Args> | MenuSubmenuItem<Args>)[];
+};
+export type ContextMenuItemDescriptor = MenuDividerItem | MenuItemBase | MenuComponentItem | MenuSubmenuItem;
+export type RowMenuItemDescriptor = MenuDividerItem | MenuItemBase<[y: number]> | MenuComponentItem<[y: number]> | MenuSubmenuItem<[y: number]>;
+export type ColMenuItemDescriptor = MenuDividerItem | MenuItemBase<[x: number]> | MenuComponentItem<[x: number]> | MenuSubmenuItem<[x: number]>;
 export declare const defaultContextMenuDescriptors: ContextMenuItemDescriptor[];
 export declare const defaultRowMenuDescriptors: RowMenuItemDescriptor[];
 export declare const defaultColMenuDescriptors: ColMenuItemDescriptor[];

package/dist/spellbook.js

@@ -1,7 +1,7 @@
 import { allFunctions } from "@gridsheet/functions";
-import { aA as useBook, a_ as xn } from "./hooks-DroLjp9H.mjs";
+import { aH as useBook, b7 as vn } from "./hooks-BHtHkTAN.mjs";
 const useSpellbook = ({ additionalFunctions, ...rest } = {}) => useBook({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });
-const createSpellbook = ({ additionalFunctions, ...rest } = {}) => xn({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });
+const createSpellbook = ({ additionalFunctions, ...rest } = {}) => vn({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });
 export {
   createSpellbook,
   useSpellbook

package/dist/store/actions.d.ts

@@ -12,6 +12,9 @@ export declare class CoreAction<T> {
     private actionId;
     /** Whether this action mutates sheet data (triggers loading indicator). */
     mutation: boolean;
+    /** Whether this action kicks off a chunked async mutation (fill/paste): its reduce
+     *  sets `pendingAsyncOp` and GridSheet runs it with a progress bar. Locked while one runs. */
+    asyncMutation: boolean;
     reduce(store: StoreType, payload: T): StoreWithCallback;
     call(payload: T): {
         type: number;
@@ -24,6 +27,8 @@ export declare class CoreAction<T> {
 }
 /** Returns true if the given action type is a mutation (heavy operation). */
 export declare const isMutationAction: (type: number) => boolean;
+/** Returns true if the action starts a chunked async mutation (fill/paste). */
+export declare const isAsyncMutationAction: (type: number) => boolean;
 export declare const setSearchQuery: (payload: string | undefined) => {
     type: number;
     value: string | undefined;
@@ -332,6 +337,36 @@ export declare const setStore: (payload: Partial<StoreType>) => {
     type: number;
     value: Partial<StoreType>;
 };
+export declare const selectToDataEdge: (payload: {
+    deltaY: number;
+    deltaX: number;
+}) => {
+    type: number;
+    value: {
+        deltaY: number;
+        deltaX: number;
+    };
+};
+export declare const fillDown: (payload: null) => {
+    type: number;
+    value: null;
+};
+export declare const fillRight: (payload: null) => {
+    type: number;
+    value: null;
+};
+export declare const commitAsyncOp: (payload: {
+    sheet: Sheet;
+    selectingZone: ZoneType;
+    finalize?: Partial<StoreType>;
+}) => {
+    type: number;
+    value: {
+        sheet: Sheet;
+        selectingZone: ZoneType;
+        finalize?: Partial<StoreType>;
+    };
+};
 export declare const userActions: {
     blur: (payload: null) => {
         type: number;
@@ -539,6 +574,24 @@ export declare const userActions: {
             filter?: FilterConfig;
         };
     };
+    selectToDataEdge: (payload: {
+        deltaY: number;
+        deltaX: number;
+    }) => {
+        type: number;
+        value: {
+            deltaY: number;
+            deltaX: number;
+        };
+    };
+    fillDown: (payload: null) => {
+        type: number;
+        value: null;
+    };
+    fillRight: (payload: null) => {
+        type: number;
+        value: null;
+    };
 };
 export {};
 //# sourceMappingURL=actions.d.ts.map

package/dist/types.d.ts

@@ -96,6 +96,14 @@ export type StoreType = {
         position: PositionType;
     } | null;
     editorHovering: boolean;
+    pendingAsyncOp: PendingAsyncOp | null;
+};
+export type PendingAsyncOp = {
+    run: (onProgress: (ratio: number) => void) => Promise<Sheet>;
+    selectingZone: ZoneType;
+    label: string;
+    finalize?: Partial<StoreType>;
+    postCommit?: () => void;
 };
 export type Manager<T> = {
     instance: T;
@@ -116,6 +124,13 @@ export type StoreHandle = {
         value: any;
     }>;
 };
+/** Consumer-driven loading state: show a progress overlay while data isn't ready yet (e.g.
+ * the app is fetching/parsing initial cells). `true` = indeterminate spinner; an object =
+ * a determinate bar. The consumer decides when loading ends (the grid can't know the source). */
+export type LoadingState = boolean | {
+    progress?: number | null;
+    label?: string;
+};
 export type Props = {
     initialCells: CellsByAddressType;
     sheetName?: string;
@@ -125,6 +140,7 @@ export type Props = {
     options?: OptionsType;
     className?: string;
     style?: CSSProperties;
+    loading?: LoadingState;
 };
 export type EditorEvent = KeyboardEvent<HTMLTextAreaElement>;
 export type EditorEventWithNativeEvent = EditorEvent & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gridsheet/preact-core",
-  "version": "3.3.0",
+  "version": "3.4.1",
   "description": "Spreadsheet component for Preact",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -10,7 +10,7 @@
     "url": "git+https://github.com/walkframe/gridsheet.git"
   },
   "dependencies": {
-    "@gridsheet/web": "3.3.0"
+    "@gridsheet/web": "3.4.1"
   },
   "exports": {
     ".": {
@@ -35,8 +35,8 @@
     "vite": "^6.2.2",
     "vite-plugin-dts": "^4.5.3",
     "@preact/preset-vite": "^2.10.1",
-    "@gridsheet/functions": "3.3.0",
-    "@gridsheet/react-core": "3.3.0"
+    "@gridsheet/react-core": "3.4.1",
+    "@gridsheet/functions": "3.4.1"
   },
   "bugs": {
     "url": "https://github.com/walkframe/gridsheet/issues"