@gridsheet/preact-core 3.2.0 → 3.4.0

package/dist/lib/clipboard.d.ts

@@ -1,5 +1,5 @@
 import { StoreType, AreaType, PointType } from '../types';
-import { UserSheet } from '@gridsheet/core';
+import { UserSheet } from '@gridsheet/web';
 export declare const clip: (store: StoreType) => AreaType;
 export type SheetCSVProps = {
     getter?: (sheet: UserSheet, point: PointType) => string;

package/dist/lib/hooks.d.ts

@@ -1,4 +1,4 @@
-import { BookType, RegistryProps } from '@gridsheet/core';
+import { BookType, RegistryProps } from '@gridsheet/web';
 export declare const useBrowser: () => {
     window: Window & typeof globalThis;
     document: Document;

package/dist/lib/menu.d.ts

@@ -1,5 +1,5 @@
 import { PointType, ZoneType, FilterConfig, StoreType } from '../types';
-import { UserSheet } from '@gridsheet/core';
+import { UserSheet } from '@gridsheet/web';
 import { Dispatcher } from '../store';
 import { FC } from 'react';
 export type MenuContext = {
@@ -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/policy/checkbox.d.ts

@@ -1,3 +1,3 @@
-import { PolicyMixinType } from '@gridsheet/core';
+import { PolicyMixinType } from '@gridsheet/web';
 export declare const CheckboxPolicyMixin: PolicyMixinType;
 //# sourceMappingURL=checkbox.d.ts.map

package/dist/spellbook.d.ts

@@ -1,6 +1,6 @@
-import { RegistryProps } from '@gridsheet/core';
+import { RegistryProps } from '@gridsheet/web';
 /** useBook with all extended functions pre-loaded. User-supplied additionalFunctions are merged on top. */
-export declare const useSpellbook: ({ additionalFunctions, ...rest }?: RegistryProps) => import('@gridsheet/core').BookType;
+export declare const useSpellbook: ({ additionalFunctions, ...rest }?: RegistryProps) => import('@gridsheet/engine').BookType;
 /** createBook with all extended functions pre-loaded. User-supplied additionalFunctions are merged on top. */
-export declare const createSpellbook: ({ additionalFunctions, ...rest }?: RegistryProps) => import('@gridsheet/core').BookType;
+export declare const createSpellbook: ({ additionalFunctions, ...rest }?: RegistryProps) => import('@gridsheet/engine').BookType;
 //# sourceMappingURL=spellbook.d.ts.map

package/dist/spellbook.js

@@ -1,8 +1,7 @@
 import { allFunctions } from "@gridsheet/functions";
-import { createBook } from "@gridsheet/core";
-import { U as useBook } from "./hooks-ykrgAwg5.mjs";
+import { aH as useBook, b7 as vn } from "./hooks-BTcuh87d.mjs";
 const useSpellbook = ({ additionalFunctions, ...rest } = {}) => useBook({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });
-const createSpellbook = ({ additionalFunctions, ...rest } = {}) => createBook({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });
+const createSpellbook = ({ additionalFunctions, ...rest } = {}) => vn({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });
 export {
   createSpellbook,
   useSpellbook

package/dist/spellbook.js.map

@@ -1 +1 @@
-{"version":3,"file":"spellbook.js","sources":["../../react-core/src/spellbook.ts"],"sourcesContent":["import { allFunctions } from '@gridsheet/functions';\nimport type { RegistryProps } from '@gridsheet/core';\nimport { createBook } from '@gridsheet/core';\nimport { useBook } from './lib/hooks';\n\n/** useBook with all extended functions pre-loaded. User-supplied additionalFunctions are merged on top. */\nexport const useSpellbook = ({ additionalFunctions, ...rest }: RegistryProps = {}) =>\n  useBook({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });\n\n/** createBook with all extended functions pre-loaded. User-supplied additionalFunctions are merged on top. */\nexport const createSpellbook = ({ additionalFunctions, ...rest }: RegistryProps = {}) =>\n  createBook({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });\n"],"names":[],"mappings":";;;AAMa,MAAA,eAAe,CAAC,EAAE,qBAAqB,GAAG,KAAK,IAAmB,CAAA,MAC7E,QAAQ,EAAE,GAAG,MAAM,qBAAqB,EAAE,GAAG,cAAc,GAAG,oBAAA,EAAuB,CAAA;AAG1E,MAAA,kBAAkB,CAAC,EAAE,qBAAqB,GAAG,KAAK,IAAmB,CAAA,MAChF,WAAW,EAAE,GAAG,MAAM,qBAAqB,EAAE,GAAG,cAAc,GAAG,oBAAA,EAAuB,CAAA;"}
+{"version":3,"file":"spellbook.js","sources":["../../react-core/src/spellbook.ts"],"sourcesContent":["import { allFunctions } from '@gridsheet/functions';\nimport type { RegistryProps } from '@gridsheet/web';\nimport { createBook } from '@gridsheet/web';\nimport { useBook } from './lib/hooks';\n\n/** useBook with all extended functions pre-loaded. User-supplied additionalFunctions are merged on top. */\nexport const useSpellbook = ({ additionalFunctions, ...rest }: RegistryProps = {}) =>\n  useBook({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });\n\n/** createBook with all extended functions pre-loaded. User-supplied additionalFunctions are merged on top. */\nexport const createSpellbook = ({ additionalFunctions, ...rest }: RegistryProps = {}) =>\n  createBook({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });\n"],"names":["createBook"],"mappings":";;AAMa,MAAA,eAAe,CAAC,EAAE,qBAAqB,GAAG,KAAK,IAAmB,CAAA,MAC7E,QAAQ,EAAE,GAAG,MAAM,qBAAqB,EAAE,GAAG,cAAc,GAAG,oBAAA,EAAuB,CAAA;AAG1E,MAAA,kBAAkB,CAAC,EAAE,qBAAqB,GAAG,KAAK,IAAmB,CAAA,MAChFA,GAAW,EAAE,GAAG,MAAM,qBAAqB,EAAE,GAAG,cAAc,GAAG,oBAAA,EAAuB,CAAA;"}

package/dist/store/actions.d.ts

@@ -1,5 +1,5 @@
 import { StoreType, RectType, ZoneType, PointType, RangeType, PositionType, RawCellType, OperatorType, FilterConfig } from '../types';
-import { Sheet } from '@gridsheet/core';
+import { Sheet } from '@gridsheet/web';
 type StoreWithCallback = StoreType & {
     callback?: (store: StoreType) => void;
 };
@@ -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;
@@ -296,6 +301,7 @@ export declare const setColumnMenu: (payload: {
         y: number;
         x: number;
     };
+    focusLabel?: boolean;
 } | null) => {
     type: number;
     value: {
@@ -304,6 +310,7 @@ export declare const setColumnMenu: (payload: {
             y: number;
             x: number;
         };
+        focusLabel?: boolean;
     } | null;
 };
 export declare const setRowMenu: (payload: {
@@ -330,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;
@@ -537,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/store/helpers.d.ts

@@ -1,4 +1,4 @@
-import { Sheet } from '@gridsheet/core';
+import { Sheet } from '@gridsheet/web';
 import { PointType, StorePatchType, StoreType } from '../types';
 /**
  * Strip redundant fields from a StorePatchType before recording in history.

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import { RefObject, CSSProperties, KeyboardEvent } from 'react';
-import { Sheet, UserSheet, BookType, PolicyType, ModeType, DensityType, GridLinesType, MatrixAlignmentType, PointType, ZoneType, RectType, PositionType, CellsByAddressType, SheetLimits } from '@gridsheet/core';
+import { Sheet, UserSheet, BookType, PolicyType, ModeType, DensityType, GridLinesType, MatrixAlignmentType, PointType, ZoneType, RectType, PositionType, CellsByAddressType, SheetLimits } from '@gridsheet/web';
 import { ContextMenuItemDescriptor, RowMenuItemDescriptor, ColMenuItemDescriptor } from './lib/menu';
-export type { CSSPropertiesLike, RefLike, Resolution, Y, X, Height, Width, ShapeType, RectType, MatrixType, CursorStateType, FeedbackType, ModeType, HeadersType, AsyncCache, System, FilterConditionMethod, FilterCondition, FilterConfig, CellType, RawCellType, CellPatchType, CellFilter, CellsByAddressType, CellsByIdType, SystemsByIdType, RangeType, PointType, ExtraPointType, PositionType, ZoneType, AreaType, WriterType, Id, Ids, IdMatrix, Address, MatricesByAddress, StorePatchType, HistoryUpdateType, MoveRelation, MoveRelations, HistoryMoveType, HistoryInsertRowsType, HistoryRemoveRowsType, HistoryInsertColsType, HistoryRemoveColsType, HistorySortRowsType, HistoryType, Virtualization, OperatorType, OperationType, Dispatcher, StoreDispatchType, ContextsBySheetId, SheetIdsByName, RefPaletteType, } from '@gridsheet/core';
+export type { CSSPropertiesLike, RefLike, Resolution, Y, X, Height, Width, ShapeType, RectType, MatrixType, CursorStateType, FeedbackType, ModeType, HeadersType, AsyncCache, System, FilterConditionMethod, FilterCondition, FilterConfig, CellType, RawCellType, CellPatchType, CellFilter, CellsByAddressType, CellsByIdType, SystemsByIdType, RangeType, PointType, ExtraPointType, PositionType, ZoneType, AreaType, WriterType, Id, Ids, IdMatrix, Address, MatricesByAddress, StorePatchType, HistoryUpdateType, MoveRelation, MoveRelations, HistoryMoveType, HistoryInsertRowsType, HistoryRemoveRowsType, HistoryInsertColsType, HistoryRemoveColsType, HistorySortRowsType, HistoryType, Virtualization, OperatorType, OperationType, Dispatcher, StoreDispatchType, ContextsBySheetId, SheetIdsByName, RefPaletteType, } from '@gridsheet/web';
 export type Policies = {
     [s: string]: PolicyType;
 };
@@ -89,12 +89,21 @@ export type StoreType = {
     columnMenuState: {
         x: number;
         position: PositionType;
+        focusLabel?: boolean;
     } | null;
     rowMenuState: {
         y: number;
         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;
@@ -115,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;
@@ -124,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.2.0",
+  "version": "3.4.0",
   "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/core": "3.2.0"
+    "@gridsheet/web": "3.4.0"
   },
   "exports": {
     ".": {
@@ -35,7 +35,8 @@
     "vite": "^6.2.2",
     "vite-plugin-dts": "^4.5.3",
     "@preact/preset-vite": "^2.10.1",
-    "@gridsheet/functions": "3.2.0"
+    "@gridsheet/react-core": "3.4.0",
+    "@gridsheet/functions": "3.4.0"
   },
   "bugs": {
     "url": "https://github.com/walkframe/gridsheet/issues"