@rowsncolumns/spreadsheet 10.2.74 → 10.2.75

package/dist/esm/api/excel-validation-kinds.js

@@ -0,0 +1,287 @@
+import { cellToAddress } from "@rowsncolumns/utils";
+export const EXCEL_VALIDATION_KIND_LABELS = [
+    { kind: "whole", label: "Whole number" },
+    { kind: "time", label: "Time" },
+    { kind: "textLength", label: "Text length" },
+];
+export const EXCEL_VALIDATION_OPERATOR_LABELS = [
+    { operator: "between", label: "between" },
+    { operator: "notBetween", label: "not between" },
+    { operator: "equal", label: "equal to" },
+    { operator: "notEqual", label: "not equal to" },
+    { operator: "greaterThan", label: "greater than" },
+    { operator: "lessThan", label: "less than" },
+    { operator: "greaterThanOrEqual", label: "greater than or equal to" },
+    { operator: "lessThanOrEqual", label: "less than or equal to" },
+];
+const EXCEL_KINDS = new Set(["whole", "time", "textLength"]);
+const EXCEL_OPERATORS = new Set(EXCEL_VALIDATION_OPERATOR_LABELS.map((entry) => entry.operator));
+/** Two-sided operators need both bounds. */
+export const isTwoSidedOperator = (operator) => operator === "between" || operator === "notBetween";
+const NUMBER_CONDITION_BY_OPERATOR = {
+    between: "NUMBER_BETWEEN",
+    notBetween: "NUMBER_NOT_BETWEEN",
+    equal: "NUMBER_EQ",
+    notEqual: "NUMBER_NOT_EQ",
+    greaterThan: "NUMBER_GREATER",
+    lessThan: "NUMBER_LESS",
+    greaterThanOrEqual: "NUMBER_GREATER_THAN_EQ",
+    lessThanOrEqual: "NUMBER_LESS_THAN_EQ",
+};
+const stripEquals = (text) => {
+    const trimmed = text?.trim() ?? "";
+    return trimmed.startsWith("=") ? trimmed.slice(1).trim() : trimmed;
+};
+const TIME_PATTERN = /^(\d{1,2})(?::(\d{1,2}))?(?::(\d{1,2}))?\s*([AaPp][Mm]?)?$/;
+/**
+ * Parse a typed time (`9:30`, `9:30 AM`, `21:05:10`, `24:00`, `0.5`) to
+ * Excel's serial. A bare non-negative number is taken as a serial already and
+ * kept whole (Excel's Time validation compares the full serial, so a
+ * date-time is out of a same-day range). `undefined` when unparsable.
+ */
+export const parseTimeToSerial = (text) => {
+    const trimmed = text?.trim() ?? "";
+    if (!trimmed)
+        return undefined;
+    const asNumber = Number(trimmed);
+    if (Number.isFinite(asNumber)) {
+        return asNumber >= 0 ? asNumber : undefined;
+    }
+    const match = TIME_PATTERN.exec(trimmed);
+    if (!match)
+        return undefined;
+    let hours = Number(match[1]);
+    const minutes = Number(match[2] ?? 0);
+    const seconds = Number(match[3] ?? 0);
+    const meridiem = match[4]?.toLowerCase();
+    if (minutes > 59 || seconds > 59)
+        return undefined;
+    if (meridiem) {
+        if (hours < 1 || hours > 12)
+            return undefined;
+        if (meridiem.startsWith("p") && hours !== 12)
+            hours += 12;
+        if (meridiem.startsWith("a") && hours === 12)
+            hours = 0;
+    }
+    else if (hours > 24 || (hours === 24 && (minutes > 0 || seconds > 0))) {
+        // Excel accepts `24:00` as exactly 1.0 (midnight at the end of the day).
+        return undefined;
+    }
+    return (hours * 3600 + minutes * 60 + seconds) / 86400;
+};
+/** Render a day-fraction serial as `h:mm AM/PM` (seconds when non-zero). */
+export const formatTimeSerial = (serial) => {
+    const total = Math.round((serial - Math.floor(serial)) * 86400) % 86400;
+    const hours24 = Math.floor(total / 3600);
+    const minutes = Math.floor((total % 3600) / 60);
+    const seconds = total % 60;
+    const meridiem = hours24 >= 12 ? "PM" : "AM";
+    const hours12 = hours24 % 12 === 0 ? 12 : hours24 % 12;
+    const mm = String(minutes).padStart(2, "0");
+    const ss = seconds ? `:${String(seconds).padStart(2, "0")}` : "";
+    return `${hours12}:${mm}${ss} ${meridiem}`;
+};
+/**
+ * A bound as it goes into a formula / `xlsxSource`: references and formulas
+ * verbatim (no `=`), times as serials, numbers as typed.
+ */
+const toBoundFormula = (kind, text) => {
+    const raw = text?.trim() ?? "";
+    if (!raw)
+        return undefined;
+    if (raw.startsWith("="))
+        return stripEquals(raw);
+    if (kind === "time") {
+        const serial = parseTimeToSerial(raw);
+        return serial === undefined ? raw : String(serial);
+    }
+    return raw;
+};
+/** The A1 anchor (range top-left) a relative custom formula is written against. */
+export const getValidationAnchor = (range) => cellToAddress(range
+    ? { rowIndex: range.startRowIndex, columnIndex: range.startColumnIndex }
+    : { rowIndex: 1, columnIndex: 1 }) ?? "A1";
+const comparison = (subject, operator, a, b) => {
+    switch (operator) {
+        case "between":
+            return b === undefined
+                ? undefined
+                : `AND(${subject}>=${a},${subject}<=${b})`;
+        case "notBetween":
+            return b === undefined
+                ? undefined
+                : `OR(${subject}<${a},${subject}>${b})`;
+        case "equal":
+            return `${subject}=${a}`;
+        case "notEqual":
+            return `${subject}<>${a}`;
+        case "greaterThan":
+            return `${subject}>${a}`;
+        case "lessThan":
+            return `${subject}<${a}`;
+        case "greaterThanOrEqual":
+            return `${subject}>=${a}`;
+        case "lessThanOrEqual":
+            return `${subject}<=${a}`;
+    }
+};
+/**
+ * Build the `condition` + `xlsxSource` pair for an Excel kind. Returns
+ * `undefined` when a required bound is missing (the editor keeps the form
+ * open in that case).
+ */
+export const buildExcelValidationRule = (spec, anchor) => {
+    const formula1 = toBoundFormula(spec.kind, spec.formula1);
+    const formula2 = toBoundFormula(spec.kind, spec.formula2);
+    if (!formula1)
+        return undefined;
+    if (isTwoSidedOperator(spec.operator) && !formula2)
+        return undefined;
+    const xlsxSource = {
+        type: spec.kind,
+        operator: spec.operator,
+        formula1,
+        ...(isTwoSidedOperator(spec.operator) ? { formula2 } : {}),
+    };
+    if (spec.kind === "time") {
+        const condition = {
+            type: NUMBER_CONDITION_BY_OPERATOR[spec.operator],
+            values: [
+                {
+                    userEnteredValue: /^[A-Za-z$'!]/.test(formula1)
+                        ? `=${formula1}`
+                        : formula1,
+                },
+                ...(isTwoSidedOperator(spec.operator) && formula2
+                    ? [
+                        {
+                            userEnteredValue: /^[A-Za-z$'!]/.test(formula2)
+                                ? `=${formula2}`
+                                : formula2,
+                        },
+                    ]
+                    : []),
+            ],
+        };
+        return { condition, xlsxSource };
+    }
+    const subject = spec.kind === "textLength" ? `LEN(${anchor})` : anchor;
+    const body = comparison(subject, spec.operator, formula1, formula2);
+    if (!body)
+        return undefined;
+    const formula = spec.kind === "whole"
+        ? `=AND(ISNUMBER(${anchor}),${anchor}=INT(${anchor}),${body})`
+        : `=${body}`;
+    return {
+        condition: {
+            type: "CUSTOM_FORMULA",
+            values: [{ userEnteredValue: formula }],
+        },
+        xlsxSource,
+    };
+};
+/**
+ * Read an Excel kind back from a rule's `xlsxSource` (imported or authored
+ * here); `undefined` for every other rule. Time bounds come back as
+ * `h:mm AM/PM` text so the editor shows what the user would type.
+ */
+export const readExcelValidationSpec = (rule) => {
+    const source = rule?.xlsxSource;
+    if (!source || !EXCEL_KINDS.has(source.type))
+        return undefined;
+    const operator = (source.operator && EXCEL_OPERATORS.has(source.operator)
+        ? source.operator
+        : "between");
+    const kind = source.type;
+    const display = (formula) => {
+        if (formula === undefined || formula === "")
+            return undefined;
+        const asNumber = Number(formula);
+        if (Number.isFinite(asNumber)) {
+            return kind === "time" ? formatTimeSerial(asNumber) : formula;
+        }
+        return `=${formula}`;
+    };
+    return {
+        kind,
+        operator,
+        formula1: display(source.formula1),
+        formula2: display(source.formula2),
+    };
+};
+const compare = (subject, operator, a, b) => {
+    switch (operator) {
+        case "between":
+            return (b !== undefined &&
+                subject >= Math.min(a, b) &&
+                subject <= Math.max(a, b));
+        case "notBetween":
+            return (b !== undefined &&
+                (subject < Math.min(a, b) || subject > Math.max(a, b)));
+        case "equal":
+            return subject === a;
+        case "notEqual":
+            return subject !== a;
+        case "greaterThan":
+            return subject > a;
+        case "lessThan":
+            return subject < a;
+        case "greaterThanOrEqual":
+            return subject >= a;
+        case "lessThanOrEqual":
+            return subject <= a;
+    }
+};
+/** A typed value that is a formula (`=…`) — validated on its result, not its text. */
+export const isFormulaEntry = (value) => typeof value === "string" && value.trim().startsWith("=");
+/**
+ * Decide an Excel-kind rule for a freshly typed value without the
+ * calculator — the commit-time enforcement Excel applies (`stop` blocks a
+ * decimal in a whole-number cell). `undefined` when the bounds are
+ * formulas / references, or when the typed value is itself a formula
+ * (Excel validates the formula's RESULT after the recalc, so `=5` is a
+ * valid whole number), so the caller falls back to the flag-only marker.
+ */
+export const checkExcelValidationValue = (rule, value) => {
+    const source = rule?.xlsxSource;
+    if (!source || !EXCEL_KINDS.has(source.type))
+        return undefined;
+    if (isFormulaEntry(value))
+        return undefined;
+    const operator = (source.operator ?? "between");
+    if (!EXCEL_OPERATORS.has(operator))
+        return undefined;
+    const a = Number(source.formula1);
+    const b = source.formula2 === undefined ? undefined : Number(source.formula2);
+    if (!Number.isFinite(a))
+        return undefined;
+    if (isTwoSidedOperator(operator) &&
+        !(b !== undefined && Number.isFinite(b))) {
+        return undefined;
+    }
+    const text = typeof value === "boolean" ? (value ? "TRUE" : "FALSE") : value;
+    switch (source.type) {
+        case "textLength":
+            return compare(Array.from(text).length, operator, a, b);
+        case "whole": {
+            if (typeof value === "boolean")
+                return false;
+            const num = Number(text.trim());
+            if (!Number.isFinite(num) || !Number.isInteger(num))
+                return false;
+            return compare(num, operator, a, b);
+        }
+        case "time": {
+            if (typeof value === "boolean")
+                return false;
+            // Excel compares the cell's full serial against the bounds (a
+            // date-time such as 45292.5 is NOT between 9:00 and 12:00) — the same
+            // comparison the composed `NUMBER_*` condition makes for the marker.
+            const serial = parseTimeToSerial(text);
+            if (serial === undefined)
+                return false;
+            return compare(serial, operator, a, b);
+        }
+    }
+};

package/dist/esm/api/go-to-special.d.ts

@@ -0,0 +1,32 @@
+import type { GridRange } from "@rowsncolumns/grid";
+import type { CellData } from "../types";
+/**
+ * Excel's Go To Special categories that can be decided from cell data alone.
+ * (Row / column differences, precedents / dependents and objects are served
+ * by the trace arrows and the drawing layer, not by this dialog.)
+ */
+export type GoToSpecialKind = "blanks" | "constants" | "formulas" | "errors" | "notes" | "visible";
+export declare const GO_TO_SPECIAL_OPTIONS: ReadonlyArray<{
+    kind: GoToSpecialKind;
+    label: string;
+}>;
+export type GoToSpecialContext<T extends CellData = CellData> = {
+    sheetId: number;
+    /** The area to scan — the current selection, or the used range for a single cell. */
+    range: GridRange;
+    getCellData(sheetId: number, rowIndex: number, columnIndex: number): T | null | undefined;
+    isRowHidden?(rowIndex: number): boolean;
+    isColumnHidden?(columnIndex: number): boolean;
+    /** Scan guard — Excel refuses huge Go To Special selections as well. */
+    maxCells?: number;
+};
+/** Cells scanned before the search gives up (returns what it found so far). */
+export declare const GO_TO_SPECIAL_MAX_CELLS = 250000;
+/**
+ * Resolve a Go To Special category to the matching cells of `range`, packed
+ * into per-row runs of adjacent columns (what the selection layer paints).
+ * Hidden rows / columns are skipped for every kind — Excel never selects
+ * into a hidden cell from Go To Special. Returns `[]` when nothing matches.
+ */
+export declare const resolveGoToSpecial: <T extends CellData>(kind: GoToSpecialKind, context: GoToSpecialContext<T>) => GridRange[];
+//# sourceMappingURL=go-to-special.d.ts.map

package/dist/esm/api/go-to-special.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-to-special.d.ts","sourceRoot":"","sources":["../../../api/go-to-special.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC;IAChD,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf,CAOA,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CACT,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACxB,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC,cAAc,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAmD/C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,QAAQ,EACnD,MAAM,eAAe,EACrB,SAAS,kBAAkB,CAAC,CAAC,CAAC,KAC7B,SAAS,EAoCX,CAAC"}

package/dist/esm/api/go-to-special.js

@@ -0,0 +1,96 @@
+export const GO_TO_SPECIAL_OPTIONS = [
+    { kind: "notes", label: "Notes" },
+    { kind: "constants", label: "Constants" },
+    { kind: "formulas", label: "Formulas" },
+    { kind: "errors", label: "Errors" },
+    { kind: "blanks", label: "Blanks" },
+    { kind: "visible", label: "Visible cells only" },
+];
+/** Cells scanned before the search gives up (returns what it found so far). */
+export const GO_TO_SPECIAL_MAX_CELLS = 250_000;
+const hasContent = (cell) => {
+    const ue = cell?.ue ?? cell?.userEnteredValue;
+    if (!ue)
+        return false;
+    return (ue.fv != null ||
+        ue.formulaValue != null ||
+        ue.sv != null ||
+        ue.stringValue != null ||
+        ue.nv != null ||
+        ue.numberValue != null ||
+        ue.bv != null ||
+        ue.boolValue != null);
+};
+const isFormula = (cell) => {
+    const ue = cell?.ue ?? cell?.userEnteredValue;
+    return typeof (ue?.fv ?? ue?.formulaValue) === "string";
+};
+const isError = (cell) => {
+    const ev = cell?.ev ?? cell?.effectiveValue;
+    const error = ev?.ev ?? ev?.errorValue;
+    return !!error && error.type === "Error";
+};
+const hasNote = (cell) => typeof cell?.note === "string" && cell.note.trim().length > 0;
+const matches = (kind, cell) => {
+    switch (kind) {
+        case "blanks":
+            return !hasContent(cell);
+        case "constants":
+            return hasContent(cell) && !isFormula(cell);
+        case "formulas":
+            return isFormula(cell);
+        case "errors":
+            return isError(cell);
+        case "notes":
+            return hasNote(cell);
+        case "visible":
+            return true;
+    }
+};
+/**
+ * Resolve a Go To Special category to the matching cells of `range`, packed
+ * into per-row runs of adjacent columns (what the selection layer paints).
+ * Hidden rows / columns are skipped for every kind — Excel never selects
+ * into a hidden cell from Go To Special. Returns `[]` when nothing matches.
+ */
+export const resolveGoToSpecial = (kind, context) => {
+    const { sheetId, range, getCellData, isRowHidden, isColumnHidden } = context;
+    const maxCells = context.maxCells ?? GO_TO_SPECIAL_MAX_CELLS;
+    const runs = [];
+    let scanned = 0;
+    for (let row = range.startRowIndex; row <= range.endRowIndex; row++) {
+        if (isRowHidden?.(row))
+            continue;
+        let runStart;
+        const flush = (endColumn) => {
+            if (runStart === undefined)
+                return;
+            runs.push({
+                startRowIndex: row,
+                endRowIndex: row,
+                startColumnIndex: runStart,
+                endColumnIndex: endColumn,
+            });
+            runStart = undefined;
+        };
+        for (let col = range.startColumnIndex; col <= range.endColumnIndex; col++) {
+            if (++scanned > maxCells) {
+                flush(col - 1);
+                return runs;
+            }
+            if (isColumnHidden?.(col)) {
+                flush(col - 1);
+                continue;
+            }
+            if (matches(kind, getCellData(sheetId, row, col))) {
+                if (runStart === undefined)
+                    runStart = col;
+            }
+            else {
+                flush(col - 1);
+            }
+        }
+        flush(range.endColumnIndex);
+    }
+    return runs;
+};

package/dist/esm/api/validation-tooltip.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { DataValidationRule, ErrorValue } from "../types";
+/**
+ * The data-validation part of a cell tooltip (both engines share it):
+ *
+ * - a cell flagged **Invalid** shows the rule's own error alert title/body
+ *   (Excel's custom error message, #131) — the generic "violates its
+ *   validation rule" text is only the fallback when the rule has none;
+ * - a formula **Error** keeps its own tooltip (nothing here);
+ * - otherwise the rule's input message (Excel's "show input message when
+ *   cell is selected", surfaced on hover here — #130).
+ *
+ * Returns `undefined` when the rule contributes nothing, so the host's own
+ * tooltip content / the generic markers apply.
+ */
+export declare const getDataValidationTooltipContent: (rule: DataValidationRule | null | undefined, error: ErrorValue | null | undefined) => ReactNode | undefined;
+//# sourceMappingURL=validation-tooltip.d.ts.map

package/dist/esm/api/validation-tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-tooltip.d.ts","sourceRoot":"","sources":["../../../api/validation-tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAsB/D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,+BAA+B,GAC1C,MAAM,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,UAAU,GAAG,IAAI,GAAG,SAAS,KACnC,SAAS,GAAG,SAad,CAAC"}

package/dist/esm/api/validation-tooltip.js

@@ -0,0 +1,34 @@
+import React from "react";
+const hasText = (message) => Boolean(message && (message.title || message.message));
+const renderMessage = (message, accentClass) => (React.createElement("div", { className: `bg-rnc-background text-rnc-foreground p-2 shadow-md rounded-md border-l-4 border-solid ${accentClass} max-w-[300px] flex flex-col gap-0.5` },
+    message.title ? (React.createElement("div", { className: "font-bold font-system text-sm" }, message.title)) : null,
+    message.message ? (React.createElement("div", { className: "text-xs font-system whitespace-pre-wrap" }, message.message)) : null));
+/**
+ * The data-validation part of a cell tooltip (both engines share it):
+ *
+ * - a cell flagged **Invalid** shows the rule's own error alert title/body
+ *   (Excel's custom error message, #131) — the generic "violates its
+ *   validation rule" text is only the fallback when the rule has none;
+ * - a formula **Error** keeps its own tooltip (nothing here);
+ * - otherwise the rule's input message (Excel's "show input message when
+ *   cell is selected", surfaced on hover here — #130).
+ *
+ * Returns `undefined` when the rule contributes nothing, so the host's own
+ * tooltip content / the generic markers apply.
+ */
+export const getDataValidationTooltipContent = (rule, error) => {
+    if (!rule)
+        return undefined;
+    if (error?.type === "Error")
+        return undefined;
+    if (error?.type === "Invalid") {
+        const alertMessage = rule.alert?.message;
+        return hasText(alertMessage)
+            ? renderMessage(alertMessage, "border-l-rnc-destructive")
+            : undefined;
+    }
+    const inputMessage = rule.inputMessage;
+    return hasText(inputMessage)
+        ? renderMessage(inputMessage, "border-l-blue-700")
+        : undefined;
+};

package/dist/esm/atoms/advanced-filter-dialog.atom.d.ts

@@ -0,0 +1,28 @@
+import type { AdvancedFilterOptions } from "../types";
+/**
+ * Open-state + payload for the Advanced Filter dialog (Excel's Data → Sort &
+ * Filter → Advanced). The context menu opens it with the list range around
+ * the active cell (A1 text); the host-mounted dialog resolves the typed
+ * references and routes the options back through `onApply`.
+ */
+export type AdvancedFilterDialogRequest = {
+    /** A1 reference of the default "List range". */
+    listRange: string;
+    /** Routed to `onAdvancedFilter` by the opener. */
+    onApply: (options: AdvancedFilterOptions) => void;
+};
+export declare const advancedFilterDialogAtom: import("jotai").PrimitiveAtom<AdvancedFilterDialogRequest | null> & {
+    init: AdvancedFilterDialogRequest | null;
+};
+export declare const useAdvancedFilterDialogState: () => [AdvancedFilterDialogRequest | null, (args_0: AdvancedFilterDialogRequest | ((prev: AdvancedFilterDialogRequest | null) => AdvancedFilterDialogRequest | null) | null) => void];
+/** Number of mounted `AdvancedFilterDialogHost`s — the menu item is offered only while > 0. */
+export declare const advancedFilterDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `AdvancedFilterDialogHost` is mounted. */
+export declare const useIsAdvancedFilterDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterAdvancedFilterDialogHost: () => void;
+/** Returns a function that opens the host-mounted Advanced Filter dialog. */
+export declare const useOpenAdvancedFilterDialog: () => (request: AdvancedFilterDialogRequest) => void;
+//# sourceMappingURL=advanced-filter-dialog.atom.d.ts.map

package/dist/esm/atoms/advanced-filter-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-filter-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/advanced-filter-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,wBAAwB;;CAEpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,uLACN,CAAC;AAEpC,+FAA+F;AAC/F,eAAO,MAAM,iCAAiC;;CAAU,CAAC;AAEzD,oEAAoE;AACpE,eAAO,MAAM,gCAAgC,eACQ,CAAC;AAEtD,yEAAyE;AACzE,eAAO,MAAM,mCAAmC,YAM/C,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,kBAG1B,2BAA2B,SAGxC,CAAC"}

package/dist/esm/atoms/advanced-filter-dialog.atom.js

@@ -0,0 +1,21 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+import { useCallback, useEffect } from "react";
+export const advancedFilterDialogAtom = atom(null);
+export const useAdvancedFilterDialogState = () => useAtom(advancedFilterDialogAtom);
+/** Number of mounted `AdvancedFilterDialogHost`s — the menu item is offered only while > 0. */
+export const advancedFilterDialogHostCountAtom = atom(0);
+/** True when at least one `AdvancedFilterDialogHost` is mounted. */
+export const useIsAdvancedFilterDialogMounted = () => useAtomValue(advancedFilterDialogHostCountAtom) > 0;
+/** Registers the calling component as a dialog host for its lifetime. */
+export const useRegisterAdvancedFilterDialogHost = () => {
+    const setCount = useSetAtom(advancedFilterDialogHostCountAtom);
+    useEffect(() => {
+        setCount((count) => count + 1);
+        return () => setCount((count) => count - 1);
+    }, [setCount]);
+};
+/** Returns a function that opens the host-mounted Advanced Filter dialog. */
+export const useOpenAdvancedFilterDialog = () => {
+    const setRequest = useSetAtom(advancedFilterDialogAtom);
+    return useCallback((request) => setRequest(request), [setRequest]);
+};

package/dist/esm/atoms/go-to-dialog.atom.d.ts

@@ -1,4 +1,5 @@
-import type { CellInterface } from "@rowsncolumns/grid";
+import type { CellInterface, GridRange } from "@rowsncolumns/grid";
+import type { GoToSpecialKind } from "../api/go-to-special";
 import type { NamedRange, SheetRange } from "../types";
 /**
  * Open-state + payload for the Go To dialog (Excel `Ctrl+G` / `F5`). The grid
@@ -14,6 +15,15 @@ export type GoToDialogRequest = {
     rowCount?: number;
     columnCount?: number;
     onNavigate: (range: SheetRange) => void;
+    /**
+     * Go To Special: resolves a category against the current selection (or
+     * the sheet) and selects the resulting runs. Absent when the grid cannot
+     * read cell data, in which case the dialog hides the "Special…" panel.
+     */
+    special?: {
+        resolve: (kind: GoToSpecialKind) => GridRange[];
+        onSelectRanges: (ranges: GridRange[]) => void;
+    };
 };
 export declare const goToDialogAtom: import("jotai").PrimitiveAtom<GoToDialogRequest | null> & {
     init: GoToDialogRequest | null;

package/dist/esm/atoms/go-to-dialog.atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"go-to-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/go-to-dialog.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,cAAc;;CAAuC,CAAC;AAEnE,eAAO,MAAM,kBAAkB,+IAAgC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;CAAU,CAAC;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,eACQ,CAAC;AAE5C,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,YAMrC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,kBAGhB,iBAAiB,SAG9B,CAAC"}
+{"version":3,"file":"go-to-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/go-to-dialog.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAInE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,SAAS,EAAE,CAAC;QAChD,cAAc,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;KAC/C,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,cAAc;;CAAuC,CAAC;AAEnE,eAAO,MAAM,kBAAkB,+IAAgC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;CAAU,CAAC;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,eACQ,CAAC;AAE5C,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,YAMrC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,kBAGhB,iBAAiB,SAG9B,CAAC"}

package/dist/esm/atoms/goal-seek-dialog.atom.d.ts

@@ -0,0 +1,29 @@
+import type { GoalSeekResult } from "../types";
+/**
+ * Open-state + payload for the Goal Seek dialog (Excel's Data → What-If
+ * Analysis → Goal Seek). The context menu opens it with the active cell as
+ * the "Set cell"; the host-mounted dialog routes the three fields (as A1
+ * references) back through `onApply` and shows the search status it
+ * resolves to.
+ */
+export type GoalSeekDialogRequest = {
+    /** A1 reference of the active cell — the default "Set cell". */
+    setCell: string;
+    /** Runs the search; resolves to the result, or `undefined` when the engine reports none. */
+    onApply: (setCell: string, targetValue: number, changingCell: string) => Promise<GoalSeekResult | undefined>;
+};
+export declare const goalSeekDialogAtom: import("jotai").PrimitiveAtom<GoalSeekDialogRequest | null> & {
+    init: GoalSeekDialogRequest | null;
+};
+export declare const useGoalSeekDialogState: () => [GoalSeekDialogRequest | null, (args_0: GoalSeekDialogRequest | ((prev: GoalSeekDialogRequest | null) => GoalSeekDialogRequest | null) | null) => void];
+/** Number of mounted `GoalSeekDialogHost`s — the menu item is offered only while > 0. */
+export declare const goalSeekDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `GoalSeekDialogHost` is mounted. */
+export declare const useIsGoalSeekDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterGoalSeekDialogHost: () => void;
+/** Returns a function that opens the host-mounted Goal Seek dialog. */
+export declare const useOpenGoalSeekDialog: () => (request: GoalSeekDialogRequest) => void;
+//# sourceMappingURL=goal-seek-dialog.atom.d.ts.map

package/dist/esm/atoms/goal-seek-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-seek-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/goal-seek-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,OAAO,EAAE,CACP,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,kBAAkB;;CAA2C,CAAC;AAE3E,eAAO,MAAM,sBAAsB,+JAAoC,CAAC;AAExE,yFAAyF;AACzF,eAAO,MAAM,2BAA2B;;CAAU,CAAC;AAEnD,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,eACQ,CAAC;AAEhD,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,YAMzC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,kBAGpB,qBAAqB,SAGlC,CAAC"}

package/dist/esm/atoms/goal-seek-dialog.atom.js

@@ -0,0 +1,21 @@
+import { atom, useAtom, useAtomValue, useSetAtom } from "jotai";
+import { useCallback, useEffect } from "react";
+export const goalSeekDialogAtom = atom(null);
+export const useGoalSeekDialogState = () => useAtom(goalSeekDialogAtom);
+/** Number of mounted `GoalSeekDialogHost`s — the menu item is offered only while > 0. */
+export const goalSeekDialogHostCountAtom = atom(0);
+/** True when at least one `GoalSeekDialogHost` is mounted. */
+export const useIsGoalSeekDialogMounted = () => useAtomValue(goalSeekDialogHostCountAtom) > 0;
+/** Registers the calling component as a dialog host for its lifetime. */
+export const useRegisterGoalSeekDialogHost = () => {
+    const setCount = useSetAtom(goalSeekDialogHostCountAtom);
+    useEffect(() => {
+        setCount((count) => count + 1);
+        return () => setCount((count) => count - 1);
+    }, [setCount]);
+};
+/** Returns a function that opens the host-mounted Goal Seek dialog. */
+export const useOpenGoalSeekDialog = () => {
+    const setRequest = useSetAtom(goalSeekDialogAtom);
+    return useCallback((request) => setRequest(request), [setRequest]);
+};

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

@@ -19,4 +19,5 @@ export * from "./paste-special-dialog.atom";
 export * from "./go-to-dialog.atom";
 export * from "./evaluate-formula-dialog.atom";
 export * from "./remove-duplicates-dialog.atom";
+export * from "./watch-window.atom";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/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,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,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,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC"}

package/dist/esm/atoms/index.js

@@ -19,3 +19,4 @@ export * from "./paste-special-dialog.atom";
 export * from "./go-to-dialog.atom";
 export * from "./evaluate-formula-dialog.atom";
 export * from "./remove-duplicates-dialog.atom";
+export * from "./watch-window.atom";