@rowsncolumns/spreadsheet 10.6.5 → 10.7.0

package/dist/cjs/api/validation.d.ts

@@ -1,5 +1,5 @@
 import type { CellInterface, GridRange } from "@rowsncolumns/grid";
-import type { BooleanCondition, CellData, ConditionType, ConditionValue, CustomFormulaResult, DataValidationRule, DataValidationRuleAlert, FilterCriteria, Maybe, ProtectedRange, SheetProtection, TimePeriodTypes } from "../types";
+import type { AllowEditRange, BooleanCondition, CellData, ConditionType, ConditionValue, CustomFormulaResult, DataValidationRule, DataValidationRuleAlert, FilterCriteria, Maybe, ProtectedRange, SheetProtection, TimePeriodTypes } from "../types";
 export type CheckBooleanRuleOptions = {
     locale?: string;
 };
@@ -50,6 +50,28 @@ export declare const showValidationDropdownArrow: (rule?: DataValidationRule | n
  * @returns
  */
 export declare const isProtectedCell: (sheetId: number, cell: CellInterface, protectedRanges: ProtectedRange[]) => boolean;
+/**
+ * The Excel Allow Edit Range covering `cell` on `sheetId`, preferring one this
+ * session may already edit (no password, or unlocked). `undefined` when no
+ * range covers the cell.
+ */
+export declare const getAllowEditRangeAt: (sheetId: number, cell: CellInterface, allowEditRanges: Maybe<AllowEditRange[]> | undefined) => AllowEditRange | undefined;
+/**
+ * What worksheet protection lets a typed edit of `cell` do (Excel's rules):
+ * `"edit"` for an unprotected sheet, an unlocked cell or a cell of an open
+ * Allow Edit Range; `"locked"` for any other locked cell; `{ unlock }` for a
+ * cell of a password-protected range this session has not unlocked (Excel's
+ * Unlock Range prompt).
+ */
+export declare const resolveProtectedCellEdit: ({ sheetId, cell, sheetProtection, cellProtection, allowEditRanges, }: {
+    sheetId: number;
+    cell: CellInterface;
+    sheetProtection: Maybe<SheetProtection> | undefined;
+    cellProtection: Maybe<Pick<NonNullable<CellData["protection"]>, "locked">>;
+    allowEditRanges?: Maybe<AllowEditRange[]>;
+}) => "edit" | "locked" | {
+    unlock: AllowEditRange;
+};
 /**
  * Check if the entire sheet is protected
  * @param sheetId
@@ -86,6 +108,22 @@ export declare const isActionBlockedBySheetProtection: (sheetProtection: Maybe<S
  * protection is inactive.
  */
 export declare const isCellLockedUnderProtection: (sheetProtection: Maybe<SheetProtection> | undefined, cellProtection: Maybe<Pick<NonNullable<CellData["protection"]>, "locked">>) => boolean;
+/**
+ * Past this many cells a selection on a sheet that refuses locked cells is
+ * refused without a per-cell scan (it would cover a locked default cell in
+ * practice — the engine's protection gate uses the same reasoning).
+ */
+export declare const SELECTABLE_SCAN_CELL_CAP = 100000;
+/**
+ * Excel's "Select locked cells" / "Select unlocked cells" (support.microsoft.com
+ * "Protect a worksheet"): whether the selection may cover `range` on a sheet.
+ * Only an ACTIVE protection restricts anything. `selectUnlockedCells` set
+ * (`true` prohibits) means no cell can be selected — Excel clears both boxes
+ * together. `selectLockedCells` set means the range must hold only unlocked
+ * cells (`protection.locked === false`; a cell is locked by default). Absent
+ * flags take the OOXML schema default: allowed.
+ */
+export declare const isRangeSelectableUnderProtection: (sheetProtection: Maybe<SheetProtection> | undefined, range: GridRange, getCellProtection: (rowIndex: number, columnIndex: number) => Maybe<Pick<NonNullable<CellData["protection"]>, "locked">> | undefined) => boolean;
 /**
  * Whether a cell's contents are hidden from the formula bar: Excel's Format
  * Cells ▸ Protection ▸ Hidden takes effect only while the sheet is protected.

package/dist/cjs/api/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../api/validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../api/validation.ts"],"names":[],"mappings":"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"}

package/dist/cjs/api/validation.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.decideValidationCommit = exports.shouldUsePreviousValue = exports.getProtectedRange = exports.isProtectedRange = exports.isCellFormulaHiddenUnderProtection = exports.isCellLockedUnderProtection = exports.isActionBlockedBySheetProtection = exports.isSheetProtectionActive = exports.isProtectedSheet = exports.isProtectedCell = exports.showValidationDropdownArrow = exports.validationValueToDate = exports.passesAggregateFilterThreshold = exports.resolveAggregateFilterThreshold = exports.isAggregateFilterCondition = exports.AGGREGATE_FILTER_CONDITION_TYPES = exports.checkFilterCondition = exports.checkFilterRule = exports.checkBooleanRule = void 0;
+exports.decideValidationCommit = exports.shouldUsePreviousValue = exports.getProtectedRange = exports.isProtectedRange = exports.isCellFormulaHiddenUnderProtection = exports.isRangeSelectableUnderProtection = exports.SELECTABLE_SCAN_CELL_CAP = exports.isCellLockedUnderProtection = exports.isActionBlockedBySheetProtection = exports.isSheetProtectionActive = exports.isProtectedSheet = exports.resolveProtectedCellEdit = exports.getAllowEditRangeAt = exports.isProtectedCell = exports.showValidationDropdownArrow = exports.validationValueToDate = exports.passesAggregateFilterThreshold = exports.resolveAggregateFilterThreshold = exports.isAggregateFilterCondition = exports.AGGREGATE_FILTER_CONDITION_TYPES = exports.checkFilterCondition = exports.checkFilterRule = exports.checkBooleanRule = void 0;
 var tslib_1 = require("tslib");
 var grid_1 = require("@rowsncolumns/grid");
 var utils_1 = require("@rowsncolumns/utils");
@@ -515,6 +515,54 @@ var isProtectedCell = function (sheetId, cell, protectedRanges) {
     });
 };
 exports.isProtectedCell = isProtectedCell;
+/**
+ * The Excel Allow Edit Range covering `cell` on `sheetId`, preferring one this
+ * session may already edit (no password, or unlocked). `undefined` when no
+ * range covers the cell.
+ */
+var getAllowEditRangeAt = function (sheetId, cell, allowEditRanges) {
+    var e_1, _a;
+    var found;
+    try {
+        for (var _b = tslib_1.__values(allowEditRanges !== null && allowEditRanges !== void 0 ? allowEditRanges : []), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var range = _c.value;
+            if (range.sheetId !== sheetId)
+                continue;
+            if (!range.ranges.some(function (r) { return (0, grid_1.isCellWithinBounds)(cell, r); }))
+                continue;
+            if (range.unlocked)
+                return range;
+            found !== null && found !== void 0 ? found : (found = range);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return found;
+};
+exports.getAllowEditRangeAt = getAllowEditRangeAt;
+/**
+ * What worksheet protection lets a typed edit of `cell` do (Excel's rules):
+ * `"edit"` for an unprotected sheet, an unlocked cell or a cell of an open
+ * Allow Edit Range; `"locked"` for any other locked cell; `{ unlock }` for a
+ * cell of a password-protected range this session has not unlocked (Excel's
+ * Unlock Range prompt).
+ */
+var resolveProtectedCellEdit = function (_a) {
+    var sheetId = _a.sheetId, cell = _a.cell, sheetProtection = _a.sheetProtection, cellProtection = _a.cellProtection, allowEditRanges = _a.allowEditRanges;
+    if (!(0, exports.isCellLockedUnderProtection)(sheetProtection, cellProtection)) {
+        return "edit";
+    }
+    var range = (0, exports.getAllowEditRangeAt)(sheetId, cell, allowEditRanges);
+    if (!range)
+        return "locked";
+    return range.unlocked ? "edit" : { unlock: range };
+};
+exports.resolveProtectedCellEdit = resolveProtectedCellEdit;
 /**
  * Check if the entire sheet is protected
  * @param sheetId
@@ -570,6 +618,44 @@ var isCellLockedUnderProtection = function (sheetProtection, cellProtection) {
     return (0, exports.isSheetProtectionActive)(sheetProtection) && (cellProtection === null || cellProtection === void 0 ? void 0 : cellProtection.locked) !== false;
 };
 exports.isCellLockedUnderProtection = isCellLockedUnderProtection;
+/**
+ * Past this many cells a selection on a sheet that refuses locked cells is
+ * refused without a per-cell scan (it would cover a locked default cell in
+ * practice — the engine's protection gate uses the same reasoning).
+ */
+exports.SELECTABLE_SCAN_CELL_CAP = 100000;
+/**
+ * Excel's "Select locked cells" / "Select unlocked cells" (support.microsoft.com
+ * "Protect a worksheet"): whether the selection may cover `range` on a sheet.
+ * Only an ACTIVE protection restricts anything. `selectUnlockedCells` set
+ * (`true` prohibits) means no cell can be selected — Excel clears both boxes
+ * together. `selectLockedCells` set means the range must hold only unlocked
+ * cells (`protection.locked === false`; a cell is locked by default). Absent
+ * flags take the OOXML schema default: allowed.
+ */
+var isRangeSelectableUnderProtection = function (sheetProtection, range, getCellProtection) {
+    var _a;
+    if (!(0, exports.isSheetProtectionActive)(sheetProtection))
+        return true;
+    if ((sheetProtection === null || sheetProtection === void 0 ? void 0 : sheetProtection.selectUnlockedCells) === true)
+        return false;
+    if ((sheetProtection === null || sheetProtection === void 0 ? void 0 : sheetProtection.selectLockedCells) !== true)
+        return true;
+    var rows = range.endRowIndex - range.startRowIndex + 1;
+    var columns = range.endColumnIndex - range.startColumnIndex + 1;
+    if (rows <= 0 || columns <= 0)
+        return true;
+    if (rows * columns > exports.SELECTABLE_SCAN_CELL_CAP)
+        return false;
+    for (var row = range.startRowIndex; row <= range.endRowIndex; row++) {
+        for (var column = range.startColumnIndex; column <= range.endColumnIndex; column++) {
+            if (((_a = getCellProtection(row, column)) === null || _a === void 0 ? void 0 : _a.locked) !== false)
+                return false;
+        }
+    }
+    return true;
+};
+exports.isRangeSelectableUnderProtection = isRangeSelectableUnderProtection;
 /**
  * Whether a cell's contents are hidden from the formula bar: Excel's Format
  * Cells ▸ Protection ▸ Hidden takes effect only while the sheet is protected.

package/dist/cjs/atoms/cell-input-context.atom.d.ts

@@ -1,7 +1,10 @@
 export declare const useCellInputContext: () => {
     makeEditable: ((sheetId: number, cell: import("@rowsncolumns/grid").CellInterface, initialValue?: string, options?: import("../hooks/use-editable").MakeEditableOptions) => void) | undefined;
     getNextFocusableCell: ((sheetId: number, currentCell: import("@rowsncolumns/grid").CellInterface, direction?: import("@rowsncolumns/grid").Direction, restrictWithinSelection?: boolean) => import("@rowsncolumns/grid").CellInterface | null) | undefined;
-    submitEditor: ((value: string, textFormatRuns: import("@rowsncolumns/common-types").TextFormatRun[] | undefined, sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, nextActiveCell?: import("@rowsncolumns/grid").CellInterface | null | undefined) => void) | undefined;
+    submitEditor: ((value: string, textFormatRuns: import("@rowsncolumns/common-types").TextFormatRun[] | undefined, sheetId: number, activeCell: import("@rowsncolumns/grid").CellInterface, nextActiveCell?: import("@rowsncolumns/grid").CellInterface | null | undefined, shouldFocusGrid?: boolean, options?: {
+        arrayFormula?: boolean;
+        fillSelection?: boolean;
+    }) => void) | undefined;
     cancelEditor: ((e?: React.KeyboardEvent<HTMLDivElement>) => void) | undefined;
     onEditorKeyDown: ((e: React.KeyboardEvent<HTMLDivElement>) => void) | undefined;
     canEditCell: ((sheetId: number, cell: import("@rowsncolumns/grid").CellInterface) => boolean) | undefined;

package/dist/cjs/atoms/cell-input-context.atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cell-input-context.atom.d.ts","sourceRoot":"","sources":["../../../atoms/cell-input-context.atom.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;CAA+C,CAAC"}
+{"version":3,"file":"cell-input-context.atom.d.ts","sourceRoot":"","sources":["../../../atoms/cell-input-context.atom.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,mBAAmB;;;;oBACohiF,CAAC;qBAAwB,CAAC;;;;;;;;;;;CAD//hF,CAAC"}

package/dist/cjs/atoms/enter-key-direction.atom.d.ts

@@ -0,0 +1,11 @@
+import type { EnterKeyDirection } from "../components/cell-editor/helpers";
+/**
+ * The grid's `enterKeyDirection`, for the editors that commit on Enter outside its props (the
+ * in-cell editor a host supplies, the formula bar).
+ */
+export declare const enterKeyDirectionAtom: import("jotai").PrimitiveAtom<EnterKeyDirection> & {
+    init: EnterKeyDirection;
+};
+export declare const useEnterKeyDirection: () => EnterKeyDirection;
+export declare const useSetEnterKeyDirection: () => (args_0: EnterKeyDirection | ((prev: EnterKeyDirection) => EnterKeyDirection)) => void;
+//# sourceMappingURL=enter-key-direction.atom.d.ts.map

package/dist/cjs/atoms/enter-key-direction.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enter-key-direction.atom.d.ts","sourceRoot":"","sources":["../../../atoms/enter-key-direction.atom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;CAAkC,CAAC;AAErE,eAAO,MAAM,oBAAoB,yBAA4C,CAAC;AAC9E,eAAO,MAAM,uBAAuB,8FAA0C,CAAC"}

package/dist/cjs/atoms/enter-key-direction.atom.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSetEnterKeyDirection = exports.useEnterKeyDirection = exports.enterKeyDirectionAtom = void 0;
+var jotai_1 = require("jotai");
+/**
+ * The grid's `enterKeyDirection`, for the editors that commit on Enter outside its props (the
+ * in-cell editor a host supplies, the formula bar).
+ */
+exports.enterKeyDirectionAtom = (0, jotai_1.atom)("down");
+var useEnterKeyDirection = function () { return (0, jotai_1.useAtomValue)(exports.enterKeyDirectionAtom); };
+exports.useEnterKeyDirection = useEnterKeyDirection;
+var useSetEnterKeyDirection = function () { return (0, jotai_1.useSetAtom)(exports.enterKeyDirectionAtom); };
+exports.useSetEnterKeyDirection = useSetEnterKeyDirection;

package/dist/cjs/atoms/index.d.ts

@@ -13,6 +13,7 @@ export * from "./selected-chart-embed.atom";
 export * from "./selected-chart-series.atom";
 export * from "./popover.atom";
 export * from "./paste-menu.atom";
+export * from "./pick-list.atom";
 export * from "./fill-options.atom";
 export * from "./fill-series-dialog.atom";
 export * from "./magic-fill-state.atom";

package/dist/cjs/atoms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC"}

package/dist/cjs/atoms/index.js

@@ -18,6 +18,7 @@ tslib_1.__exportStar(require("./selected-chart-embed.atom"), exports);
 tslib_1.__exportStar(require("./selected-chart-series.atom"), exports);
 tslib_1.__exportStar(require("./popover.atom"), exports);
 tslib_1.__exportStar(require("./paste-menu.atom"), exports);
+tslib_1.__exportStar(require("./pick-list.atom"), exports);
 tslib_1.__exportStar(require("./fill-options.atom"), exports);
 tslib_1.__exportStar(require("./fill-series-dialog.atom"), exports);
 tslib_1.__exportStar(require("./magic-fill-state.atom"), exports);

package/dist/cjs/atoms/paste-menu.atom.d.ts

@@ -1,6 +1,28 @@
+import type { PasteOptionId } from "../components/selection/paste-options";
 export declare const showPasteMenuAtom: import("jotai").PrimitiveAtom<boolean> & {
     init: boolean;
 };
 export declare const useShowPasteMenu: () => [boolean, (args_0: boolean | ((prev: boolean) => boolean)) => void];
 export declare const useSetShowPasteMenu: () => (args_0: boolean | ((prev: boolean) => boolean)) => void;
+/**
+ * The Paste Options button's state for the last paste: whether its gallery
+ * is open (a click, or Ctrl pressed alone after the paste), which gallery
+ * entry the paste currently stands as, and what the gallery may offer.
+ */
+export type PasteMenuState = {
+    open: boolean;
+    /** The gallery entry the last paste was applied as. */
+    active?: PasteOptionId;
+    /** The last paste can be re-applied in another mode (a copy, not a cut). */
+    canReapply: boolean;
+    /** Paste Link needs copied grid cells (not after a cut or a foreign clipboard). */
+    canLink: boolean;
+};
+export declare const DEFAULT_PASTE_MENU_STATE: PasteMenuState;
+export declare const pasteMenuStateAtom: import("jotai").PrimitiveAtom<PasteMenuState> & {
+    init: PasteMenuState;
+};
+export declare const usePasteMenuState: () => [PasteMenuState, (args_0: PasteMenuState | ((prev: PasteMenuState) => PasteMenuState)) => void];
+export declare const usePasteMenuStateValue: () => PasteMenuState;
+export declare const useSetPasteMenuState: () => (args_0: PasteMenuState | ((prev: PasteMenuState) => PasteMenuState)) => void;
 //# sourceMappingURL=paste-menu.atom.d.ts.map

package/dist/cjs/atoms/paste-menu.atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paste-menu.atom.d.ts","sourceRoot":"","sources":["../../../atoms/paste-menu.atom.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB;;CAAc,CAAC;AAE7C,eAAO,MAAM,gBAAgB,2EAAmC,CAAC;AACjE,eAAO,MAAM,mBAAmB,gEAAsC,CAAC"}
+{"version":3,"file":"paste-menu.atom.d.ts","sourceRoot":"","sources":["../../../atoms/paste-menu.atom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAE3E,eAAO,MAAM,iBAAiB;;CAAc,CAAC;AAE7C,eAAO,MAAM,gBAAgB,2EAAmC,CAAC;AACjE,eAAO,MAAM,mBAAmB,gEAAsC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,4EAA4E;IAC5E,UAAU,EAAE,OAAO,CAAC;IACpB,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,cAItC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;CAAiD,CAAC;AAEjF,eAAO,MAAM,iBAAiB,uGAAoC,CAAC;AACnE,eAAO,MAAM,sBAAsB,sBAAyC,CAAC;AAC7E,eAAO,MAAM,oBAAoB,qFAAuC,CAAC"}

package/dist/cjs/atoms/paste-menu.atom.js

@@ -1,9 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useSetShowPasteMenu = exports.useShowPasteMenu = exports.showPasteMenuAtom = void 0;
+exports.useSetPasteMenuState = exports.usePasteMenuStateValue = exports.usePasteMenuState = exports.pasteMenuStateAtom = exports.DEFAULT_PASTE_MENU_STATE = exports.useSetShowPasteMenu = exports.useShowPasteMenu = exports.showPasteMenuAtom = void 0;
 var jotai_1 = require("jotai");
 exports.showPasteMenuAtom = (0, jotai_1.atom)(false);
 var useShowPasteMenu = function () { return (0, jotai_1.useAtom)(exports.showPasteMenuAtom); };
 exports.useShowPasteMenu = useShowPasteMenu;
 var useSetShowPasteMenu = function () { return (0, jotai_1.useSetAtom)(exports.showPasteMenuAtom); };
 exports.useSetShowPasteMenu = useSetShowPasteMenu;
+exports.DEFAULT_PASTE_MENU_STATE = {
+    open: false,
+    canReapply: false,
+    canLink: false,
+};
+exports.pasteMenuStateAtom = (0, jotai_1.atom)(exports.DEFAULT_PASTE_MENU_STATE);
+var usePasteMenuState = function () { return (0, jotai_1.useAtom)(exports.pasteMenuStateAtom); };
+exports.usePasteMenuState = usePasteMenuState;
+var usePasteMenuStateValue = function () { return (0, jotai_1.useAtomValue)(exports.pasteMenuStateAtom); };
+exports.usePasteMenuStateValue = usePasteMenuStateValue;
+var useSetPasteMenuState = function () { return (0, jotai_1.useSetAtom)(exports.pasteMenuStateAtom); };
+exports.useSetPasteMenuState = useSetPasteMenuState;

package/dist/cjs/atoms/pick-list.atom.d.ts

@@ -0,0 +1,15 @@
+import type { CellInterface } from "@rowsncolumns/grid";
+/**
+ * Excel's Pick From Drop-down List (Alt+↓ on a cell with no list of its
+ * own): the column's entries the cell editor offers for `cell`.
+ */
+export type PickListRequest = {
+    sheetId: number;
+    cell: CellInterface;
+    entries: string[];
+};
+export declare const pickListAtom: import("jotai").PrimitiveAtom<PickListRequest | null> & {
+    init: PickListRequest | null;
+};
+export declare const usePickList: () => [PickListRequest | null, (args_0: PickListRequest | ((prev: PickListRequest | null) => PickListRequest | null) | null) => void];
+//# sourceMappingURL=pick-list.atom.d.ts.map

package/dist/cjs/atoms/pick-list.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-list.atom.d.ts","sourceRoot":"","sources":["../../../atoms/pick-list.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,YAAY;;CAAqC,CAAC;AAE/D,eAAO,MAAM,WAAW,uIAA8B,CAAC"}

package/dist/cjs/atoms/pick-list.atom.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePickList = exports.pickListAtom = void 0;
+var jotai_1 = require("jotai");
+exports.pickListAtom = (0, jotai_1.atom)(null);
+var usePickList = function () { return (0, jotai_1.useAtom)(exports.pickListAtom); };
+exports.usePickList = usePickList;

package/dist/cjs/components/canvas-grid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AAsDA,OAAO,KASN,MAAM,OAAO,CAAC;AAgOf,OAAO,KAAK,EAGV,QAAQ,EAWT,MAAM,aAAa,CAAC;AAoBrB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AA6sMnB,eAAO,MAAM,UAAU,EAA4C,CACjE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAEvB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,wBAAwB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AAwDA,OAAO,KASN,MAAM,OAAO,CAAC;AA4Of,OAAO,KAAK,EAGV,QAAQ,EAWT,MAAM,aAAa,CAAC;AAyBrB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AAqgNnB,eAAO,MAAM,UAAU,EAA4C,CACjE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAEvB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,wBAAwB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}