@sheetpane/validation 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arpit Arya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,150 @@
-# Temporary Holding Version
+# @sheetpane/validation
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**The workbook's own data-validation rules, checked when the file loads and after every edit. Each cell that breaks a rule shows up as a warning in `<sheetpane-errors>`.**
+
+A plugin for `@sheetpane/grid`. It reads the `<dataValidations>` the file's
+author saved, including the x14 form Excel uses for lists on another sheet,
+and runs them through the `validate` hook. `<sheetpane-excel>` and
+`<sheetpane-errors>` on the same pane both see the result. No runtime
+dependencies; `@sheetpane/grid` is a peer. Versioned in lockstep with it.
+
+- `@sheetpane/validation`: the headless plugin (`validate` only).
+- `@sheetpane/validation/ui`: opt-in. Adds the list arrow and the status-line count.
+
+## Use
+
+```html
+<script type="module">
+  import '@sheetpane/grid';
+  import '@sheetpane/validation/ui'; // registers "validation" = rules + controls
+</script>
+
+<sheetpane-excel pane="q3" plugins="validation" src="/files/holdings.xlsx" mode="edit"></sheetpane-excel>
+<sheetpane-errors pane="q3"></sheetpane-errors>
+```
+
+Without a page, or without the controls:
+
+```ts
+import { createWorkbook } from '@sheetpane/grid';
+import { validation, skippedRules } from '@sheetpane/validation';
+
+const store = createWorkbook({ plugins: [validation({ severity: 'warning' })] });
+await store.load(bytes, 'holdings.xlsx');
+store.getErrors();      // one error per failing cell
+skippedRules(store);    // { rules, checked, skipped: [{ sheet, sqref, type, reason, detail }] }
+```
+
+Importing `@sheetpane/validation` registers `validation` as the rules plugin
+alone. Importing `/ui` re-registers it as the rules plus the controls.
+
+## What a broken rule looks like
+
+One error per failing cell. If a cell breaks two rules, the first one counts.
+
+| field | value |
+|---|---|
+| `type` | `validation` |
+| `severity` | `warning` (set another with `validation({ severity })`) |
+| `author` | `workbook` |
+| `range` | the cell, e.g. `B4` |
+| `found` | the cell's current display text, or `(blank)` |
+| `expected` | the rule in words (table below) |
+| `message` | the rule's own `errorTitle: error`, or either one alone; otherwise the rule in words |
+
+A workbook error resolves itself when its cell passes again and reopens if
+the cell fails again (it keeps the same id). This is the only automatic
+resolve in sheetpane; the store does it. `showErrorMessage="0"` rules are
+still checked, because that flag only turns off Excel's popup.
+
+## The rules, and the words a reviewer reads
+
+| rule | passes when | `expected` |
+|---|---|---|
+| `whole` | the value is an integer and the operator holds | `whole number > 0` |
+| `decimal` | the value is a number and the operator holds | `decimal between 0.00% and 2.00%` (operands in the cell's own number format) |
+| `date` | the value is a date serial and the operator holds | `date between 01-Jul-2026 and 30-Sep-2026` |
+| `time` | the value is a number (a fraction of a day) and the operator holds | `time between 09:00 and 18:00` |
+| `textLength` | the length of the text holds against the operator | `text length ≤ 5 characters` |
+| `list` | the text matches a choice (case-insensitive; a number also matches its number) | `list — Core, Income, Cap` (the first 8, then `… (n more)`) |
+| `custom` | the formula is true at the cell | `custom — =A1>0` |
+
+Operators: `between` (the default), `notBetween`, `equal` (`=`), `notEqual`
+(`≠`), `greaterThan` (`>`), `lessThan` (`<`), `greaterThanOrEqual` (`≥`),
+`lessThanOrEqual` (`≤`). `between` includes both ends.
+
+What an operand can be:
+
+- a number
+- `DATE(y,m,d)` or `TIME(h,m,s)` with number arguments
+- a quoted string
+- a cell: `$G$1`, `Sheet2!B1`, or a relative `D1`, which shifts with each cell the same way it does in Excel
+- a defined name that resolves to one of these
+
+A cell operand is read live, so changing the limit re-checks the rule. An
+empty operand cell reads as 0.
+
+A `list` source can be:
+
+- a literal list: `"a,b,c"`
+- a range: `$H$1:$H$9`, `Lists!$A$1:$A$9`, `$A:$A`
+- a defined name that resolves to a range
+
+A range source is read live from the store, and the arrow's menu re-reads it
+each time it opens.
+
+Blank cells pass when the rule has `allowBlank`. Without it, they fail.
+Cells are checked only inside the sheet's used range: its data plus any cell
+the user changed. A rule on `B:B` therefore does not produce a million rows.
+
+## What is not checked, and why (`skippedRules`)
+
+| reason | what |
+|---|---|
+| `custom` | a `custom` rule when no formula plugin offers `evaluate()` (see below) |
+| `operand` | an operand the subset above does not cover, e.g. `SUM(...)` or `INDIRECT(...)` |
+| `operator` | an operator outside the eight above |
+| `type` | an unknown rule type |
+| `source` | a list source that is neither a list, a range nor a name, or that names a missing sheet |
+
+`skippedRules(store)` counts `custom` as checked when the pane has a formula
+evaluator. `skippedRules(book)` has only the workbook to go on, so it counts
+every `custom` rule as skipped. The status line adds `· n rules not checked`.
+
+### Custom rules need a formula engine
+
+`custom` rules run only when the pane's `derive` plugin (`@sheetpane/formulas`)
+also exposes:
+
+```ts
+evaluate(formula: string, at: { sheet: string; ref: string }): boolean | number | string | null | undefined
+```
+
+The plugin passes the formula with its relative references already shifted to
+the cell. `true` or a non-zero number passes. `false` or `0` fails. Anything
+else counts as unknown, and the cell is not flagged.
+
+## The controls (`/ui`)
+
+- **List arrow** (`cell` slot, Edit only): appears in every cell a `list` rule
+  covers. It opens the rule's current choices, and picking one sets the cell
+  with `store.setCell`, which can be undone.
+- **Status** (`status` slot, View and Edit): `3 validation warnings`, plus
+  `· 1 rule not checked` when rules were skipped.
+
+`<sheetpane-errors>` lists the rule rows with the reviewer's own errors. Its
+author filter (Anyone · People · Workbook rules · File comments) shows only
+the rule rows when you need them.
+
+## Known limits
+
+- A list whose source is on another sheet is re-checked when its own sheet
+  changes, not when the source sheet changes. The arrow's menu is always
+  current.
+- A cell holding a formula is checked against its saved value. If the user
+  typed the formula, the plugin uses the value the formula plugin derived. The
+  check runs on the edit, before the formula plugin has finished deriving.
+- `found` is fixed when the error is first made. If an error reopens, it shows
+  the first failing value.
+
+**Using an AI coding agent?** `npx sheetpane-skills install` puts sheetpane's skills for Claude Code, Kiro and Codex into your repository.

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+import { type ErrorDraft, type Plugin, type Severity, type WorkbookStore } from '@sheetpane/grid';
+import { type Book, type Rule, type SkipReason } from './rules.js';
+export type { Book, Rule, RuleKind, Operator, SkipReason, Evaluate } from './rules.js';
+export { rulesOf, listOptions, ruleWords, check, shiftFormula, parseOperand } from './rules.js';
+/** The plugin's id, and the name `plugins="…"` takes. */
+export declare const PLUGIN_ID = "validation";
+/** The `type` of every error this plugin raises. */
+export declare const ERROR_TYPE = "validation";
+/** The `author` of every error this plugin raises: the workbook's own rules, not a person. */
+export declare const AUTHOR = "workbook";
+/** Options for {@link validation}. */
+export interface ValidationOptions {
+    /** The severity a broken rule gets; `warning` by default. */
+    severity?: Severity;
+}
+/** A rule that is not checked: where it is, its type, and why (`custom`, `operand`, `operator`, `type`, `source`). */
+export interface SkippedRule {
+    sheet: string;
+    sqref: string;
+    type: string;
+    reason: SkipReason;
+    detail: string;
+}
+/** How many of a workbook's rules are checked, and the ones that are not. */
+export interface SkipReport {
+    /** Rules the workbook holds (`type="none"` excluded). */
+    rules: number;
+    /** Rules this pane checks. */
+    checked: number;
+    /** Rules it cannot check, and why. `skipped.length` is the count `sheetpane-load` would carry. */
+    skipped: SkippedRule[];
+}
+/**
+ * The rules a workbook holds that are not checked, and why. Given a store, a
+ * `custom` rule counts as checked when its `derive` plugin offers `evaluate()`;
+ * given a bare workbook, every `custom` rule is skipped.
+ *
+ * @param from - The workbook, or the store holding it.
+ * @returns The report; all zero when no workbook is loaded.
+ */
+export declare function skippedRules(from: Book | WorkbookStore): SkipReport;
+/**
+ * The last report `validate` made for a workbook (the status line reads it).
+ *
+ * @param book - The workbook, or `undefined`.
+ * @returns The report, or `undefined` before the first `validate`.
+ */
+export declare function lastReport(book: Book | undefined): SkipReport | undefined;
+/**
+ * Every failing cell on one sheet: one error draft per cell (the first rule it breaks), within the used range.
+ *
+ * @param sheet - The sheet's name.
+ * @param store - The workbook store.
+ * @param severity - The drafts' severity; default `warning`.
+ * @returns The drafts — `type: 'validation'`, `author: 'workbook'`, `found`, `expected` and `message` filled.
+ */
+export declare function validateSheet(sheet: string, store: WorkbookStore, severity?: Severity): ErrorDraft[];
+/**
+ * The data-validation plugin: checks the workbook's own `<dataValidations>` rules on load and after every change,
+ * through the `validate` hook. A cell that breaks a rule is one error (`type: 'validation'`, `author: 'workbook'`)
+ * that resolves when the cell passes and reopens when it fails again. `custom` rules need a formula engine
+ * (`@sheetpane/formulas`); rules it cannot check are listed by {@link skippedRules}. Importing this module
+ * registers it as `validation`; the list arrow and status count are in `@sheetpane/validation/ui`.
+ *
+ * @param o - The severity a broken rule gets; default `warning`.
+ * @returns The plugin (`id: 'validation'`).
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0108_VALIDATION.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { formulas } from '@sheetpane/formulas';
+ * import { skippedRules, validation } from '@sheetpane/validation';
+ *
+ * const book = createWorkbook({ plugins: [validation({ severity: 'error' }), formulas()] });
+ * await book.load(bytes, 'budget.xlsx');
+ * console.log(skippedRules(book).skipped);
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/validation'; // registers `validation`
+ * excel.setAttribute('plugins', 'validation formulas');
+ * ```
+ */
+export declare function validation(o?: ValidationOptions): Plugin;
+/**
+ * The checkable `list` rule covering a cell, if any — the list arrow's `appliesTo`.
+ *
+ * @param store - The workbook store.
+ * @param sheet - The sheet's name.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns The rule, or `undefined`.
+ */
+export declare function listRuleAt(store: WorkbookStore, sheet: string, row: number, col: number): Rule | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,MAAM,EAAsB,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACtI,OAAO,EAAiF,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAElJ,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhG,yDAAyD;AACzD,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,oDAAoD;AACpD,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,8FAA8F;AAC9F,eAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,sHAAsH;AACtH,MAAM,WAAW,WAAW;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC/G,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,kGAAkG;IAClG,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAcnE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAEzE;AAQD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,GAAE,QAAoB,GAAG,UAAU,EAAE,CAwB/G;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAE,iBAAsB,GAAG,MAAM,CAU5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAI1G"}

package/dist/index.js

@@ -0,0 +1,146 @@
+// @sheetpane/validation — the workbook's own `<dataValidations>` rules, checked on
+// load and on every edit through the `validate` hook (W-18). A cell that breaks a
+// rule is one error: type `validation`, author `workbook`; the store resolves it
+// when the cell passes and reopens it when it fails again.
+// Headless: this entry never imports ./ui.js. Importing it in Node is safe.
+import { registerPlugin } from '@sheetpane/grid';
+import { a1, check, covers, evaluatorOf, ruleWords, rulesOf, skipOf, textAt, usedRange } from './rules.js';
+export { rulesOf, listOptions, ruleWords, check, shiftFormula, parseOperand } from './rules.js';
+/** The plugin's id, and the name `plugins="…"` takes. */
+export const PLUGIN_ID = 'validation';
+/** The `type` of every error this plugin raises. */
+export const ERROR_TYPE = 'validation';
+/** The `author` of every error this plugin raises: the workbook's own rules, not a person. */
+export const AUTHOR = 'workbook';
+const reports = new WeakMap();
+/**
+ * The rules a workbook holds that are not checked, and why. Given a store, a
+ * `custom` rule counts as checked when its `derive` plugin offers `evaluate()`;
+ * given a bare workbook, every `custom` rule is skipped.
+ *
+ * @param from - The workbook, or the store holding it.
+ * @returns The report; all zero when no workbook is loaded.
+ */
+export function skippedRules(from) {
+    const store = 'getSnapshot' in from ? from : undefined;
+    const book = store ? store.book : from;
+    const out = { rules: 0, checked: 0, skipped: [] };
+    if (!book)
+        return out;
+    for (const s of book.sheets) {
+        for (const r of rulesOf(book, s.name)) {
+            out.rules++;
+            const skip = skipOf(r, store);
+            if (skip)
+                out.skipped.push({ sheet: s.name, sqref: r.dv.sqref.join(' '), type: r.dv.type, reason: skip.reason, detail: skip.detail });
+            else
+                out.checked++;
+        }
+    }
+    return out;
+}
+/**
+ * The last report `validate` made for a workbook (the status line reads it).
+ *
+ * @param book - The workbook, or `undefined`.
+ * @returns The report, or `undefined` before the first `validate`.
+ */
+export function lastReport(book) {
+    return book ? reports.get(book) : undefined;
+}
+/** The rule's own error text — `errorTitle: error`, either alone — else the rule in words. */
+function messageOf(rule, words) {
+    const t = rule.dv.errorTitle?.trim(), e = rule.dv.error?.trim();
+    return t && e ? `${t}: ${e}` : t || e || words;
+}
+/**
+ * Every failing cell on one sheet: one error draft per cell (the first rule it breaks), within the used range.
+ *
+ * @param sheet - The sheet's name.
+ * @param store - The workbook store.
+ * @param severity - The drafts' severity; default `warning`.
+ * @returns The drafts — `type: 'validation'`, `author: 'workbook'`, `found`, `expected` and `message` filled.
+ */
+export function validateSheet(sheet, store, severity = 'warning') {
+    const book = store.book, s = store.sheet(sheet);
+    if (!book || !s)
+        return [];
+    const rules = rulesOf(book, sheet).filter((r) => !skipOf(r, store));
+    if (!rules.length)
+        return [];
+    const evaluate = evaluatorOf(store);
+    const used = usedRange(store, s);
+    const out = [];
+    const flagged = new Set();
+    const memo = new Map(); // a fixed list source is read once per run
+    for (const rule of rules) {
+        for (const b of rule.boxes) {
+            for (let r = b.top; r <= Math.min(b.bottom, used.rows - 1); r++) {
+                for (let c = b.left; c <= Math.min(b.right, used.cols - 1); c++) {
+                    const ref = a1(r, c);
+                    if (flagged.has(ref) || check(rule, store, r, c, evaluate, memo) !== 'fail')
+                        continue;
+                    flagged.add(ref);
+                    const expected = ruleWords(rule, store, r, c);
+                    out.push({ sheet, range: ref, type: ERROR_TYPE, severity, found: textAt(store, sheet, ref) || '(blank)', expected, message: messageOf(rule, expected), author: AUTHOR });
+                }
+            }
+        }
+    }
+    return out;
+}
+/**
+ * The data-validation plugin: checks the workbook's own `<dataValidations>` rules on load and after every change,
+ * through the `validate` hook. A cell that breaks a rule is one error (`type: 'validation'`, `author: 'workbook'`)
+ * that resolves when the cell passes and reopens when it fails again. `custom` rules need a formula engine
+ * (`@sheetpane/formulas`); rules it cannot check are listed by {@link skippedRules}. Importing this module
+ * registers it as `validation`; the list arrow and status count are in `@sheetpane/validation/ui`.
+ *
+ * @param o - The severity a broken rule gets; default `warning`.
+ * @returns The plugin (`id: 'validation'`).
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0108_VALIDATION.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { formulas } from '@sheetpane/formulas';
+ * import { skippedRules, validation } from '@sheetpane/validation';
+ *
+ * const book = createWorkbook({ plugins: [validation({ severity: 'error' }), formulas()] });
+ * await book.load(bytes, 'budget.xlsx');
+ * console.log(skippedRules(book).skipped);
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/validation'; // registers `validation`
+ * excel.setAttribute('plugins', 'validation formulas');
+ * ```
+ */
+export function validation(o = {}) {
+    const severity = o.severity ?? 'warning';
+    return {
+        id: PLUGIN_ID,
+        provides: ['validate'],
+        validate(sheet, ctx) {
+            if (ctx.book && !reports.has(ctx.book))
+                reports.set(ctx.book, skippedRules(ctx.store));
+            return validateSheet(sheet, ctx.store, severity);
+        },
+    };
+}
+/**
+ * The checkable `list` rule covering a cell, if any — the list arrow's `appliesTo`.
+ *
+ * @param store - The workbook store.
+ * @param sheet - The sheet's name.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns The rule, or `undefined`.
+ */
+export function listRuleAt(store, sheet, row, col) {
+    const book = store.book;
+    if (!book)
+        return undefined;
+    return rulesOf(book, sheet).find((r) => r.kind === 'list' && !r.skip && covers(r, row, col));
+}
+registerPlugin(PLUGIN_ID, () => validation());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/rules.d.ts

@@ -0,0 +1,143 @@
+import { shiftFormula, type CellContext, type PluginContext, type WorkbookStore } from '@sheetpane/grid';
+/** The imported workbook, as a plugin hook receives it. */
+export type Book = PluginContext['book'];
+export type Sheet = CellContext['sheet'];
+export type Cell = CellContext['value'];
+export type DataValidation = Sheet['dataValidations'][number];
+/** A data-validation rule's type (`<dataValidation type>`); `custom` needs a formula engine. */
+export type RuleKind = 'whole' | 'decimal' | 'date' | 'time' | 'textLength' | 'list' | 'custom';
+/** A rule's comparison (`<dataValidation operator>`); `between` is the default and inclusive. */
+export type Operator = 'between' | 'notBetween' | 'equal' | 'notEqual' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual';
+/** Why a rule is not checked: `custom` without a formula evaluator, an operator or operand outside the subset, an unknown type, a list source that names nothing. */
+export type SkipReason = 'custom' | 'operator' | 'operand' | 'type' | 'source';
+export interface Box {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+export declare function colIndex(letters: string): number;
+export declare function colLetters(col: number): string;
+export declare const a1: (row: number, col: number) => string;
+/** `B3`, `B3:B5`, `B:B`, `3:3` (`$` allowed) → a box; undefined when it is none of these. */
+export declare function parseBox(s: string): Box | undefined;
+/** A formula1/formula2 the subset evaluates: a number, a string, DATE/TIME of numbers, a cell (relative parts shift with the cell), or a range (list sources). */
+export type Operand = {
+    k: 'num';
+    v: number;
+} | {
+    k: 'str';
+    v: string;
+} | {
+    k: 'ref';
+    sheet: string | undefined;
+    row: number;
+    col: number;
+    absRow: boolean;
+    absCol: boolean;
+} | {
+    k: 'range';
+    sheet: string | undefined;
+    box: Box;
+    absRow: boolean;
+    absCol: boolean;
+};
+export declare function dateSerial(y: number, m: number, d: number, d1904: boolean): number;
+/**
+ * Parses one operand (`formula1` / `formula2`): a number, quoted text, `DATE` / `TIME` of numbers, a cell or a
+ * range; a defined name is followed (three levels) to its formula.
+ *
+ * @param f - The operand as the file stores it, with or without `=`.
+ * @param book - The workbook (its date system and defined names).
+ * @param sheetIndex - The rule's sheet, 0-based — a sheet-scoped name wins over a global one.
+ * @param depth - How many defined names have been followed already; callers omit it.
+ * @returns The operand, or `undefined` when it is outside the subset (the rule is then skipped).
+ */
+export declare function parseOperand(f: string, book: Book, sheetIndex: number, depth?: number): Operand | undefined;
+/** Shifting relative references is @sheetpane/export's `shiftFormula`, re-exported by the grid peer. */
+export { shiftFormula };
+/** One `<dataValidation>`, compiled: its kind, operator, ranges, parsed operands, and why it is skipped, if it is. */
+export interface Rule {
+    sheet: string;
+    dv: DataValidation;
+    kind: RuleKind;
+    op: Operator;
+    boxes: Box[];
+    /** The top-left of the first range: relative references are written against it. */
+    anchor: {
+        row: number;
+        col: number;
+    };
+    f1?: Operand;
+    f2?: Operand;
+    /** `list`: the literal choices. */
+    literal?: string[];
+    skip?: {
+        reason: SkipReason;
+        detail: string;
+    };
+}
+/**
+ * The sheet's rules, compiled once per workbook. `type="none"` (any value) is not a rule.
+ *
+ * @param book - The workbook.
+ * @param sheetName - The sheet's name.
+ * @returns The compiled rules, skipped ones included (they carry `skip`).
+ */
+export declare function rulesOf(book: Book, sheetName: string): Rule[];
+/** What `@sheetpane/validation` needs from a formula engine for `custom` rules: the `derive` provider's synchronous `evaluate`. */
+export type Evaluate = (formula: string, at: {
+    sheet: string;
+    ref: string;
+}) => Cell | undefined;
+export declare function evaluatorOf(store: WorkbookStore): Evaluate | undefined;
+/** The reason a rule is not checked in this store, if it is not. */
+export declare function skipOf(rule: Rule, store: WorkbookStore | undefined): Rule['skip'];
+/** The cell's value now. A typed formula (change kind `formula`) is its derived result, not its text. */
+export declare function valueAt(store: WorkbookStore, sheet: string, ref: string): Cell | undefined;
+export declare function textAt(store: WorkbookStore, sheet: string, ref: string): string;
+/**
+ * A `list` rule's choices at one cell — the literal list, or read live from the store for a range (relative parts
+ * shifted to the cell; empty and repeated values dropped).
+ *
+ * @param rule - A `list` rule.
+ * @param store - The workbook store.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns The choices, in order.
+ */
+export declare function listOptions(rule: Rule, store: WorkbookStore, row: number, col: number): string[];
+/** The rows and columns a sheet uses: its data, plus any cell a user changed. */
+export declare function usedRange(store: WorkbookStore, s: Sheet): {
+    rows: number;
+    cols: number;
+};
+export type Verdict = 'pass' | 'fail' | 'unknown';
+/**
+ * Does one cell pass one (checkable) rule? A blank cell passes with `allowBlank`.
+ *
+ * @param rule - A rule that is not skipped.
+ * @param store - The workbook store (current values).
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @param evaluate - The formula engine's `evaluate`, for `custom` rules; `undefined` without one.
+ * @param memo - A cache of list sources, shared across one run.
+ * @returns `pass`, `fail`, or `unknown` when an operand cannot be read — not an error.
+ */
+export declare function check(rule: Rule, store: WorkbookStore, row: number, col: number, evaluate: Evaluate | undefined, memo?: Map<Rule, string[]>): Verdict;
+export declare function dateText(serial: number, d1904: boolean): string;
+export declare function timeText(serial: number): string;
+/**
+ * The rule in words, at one cell: `whole number > 0`, `decimal between 0.00% and 2.00%`, `date ≤ 30-Sep-2026`,
+ * `list — Core, Income, Cap` — an error's `expected`.
+ *
+ * @param rule - The rule.
+ * @param store - The workbook store (cell operands are read live).
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns The sentence.
+ */
+export declare function ruleWords(rule: Rule, store: WorkbookStore, row: number, col: number): string;
+/** Does a cell sit in one of the rule's ranges? */
+export declare const covers: (rule: Rule, row: number, col: number) => boolean;
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

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

package/dist/rules.js

@@ -0,0 +1,417 @@
+// The rule engine: a sheet's `<dataValidations>` compiled once per workbook, then
+// checked against the store's current values. No DOM, no dependency — the types
+// come from @sheetpane/grid, the values from the store a hook is handed.
+import { shiftFormula } from '@sheetpane/grid';
+const KINDS = ['whole', 'decimal', 'date', 'time', 'textLength', 'list', 'custom'];
+const OPERATORS = ['between', 'notBetween', 'equal', 'notEqual', 'greaterThan', 'lessThan', 'greaterThanOrEqual', 'lessThanOrEqual'];
+const MAX_ROWS = 1048576, MAX_COLS = 16384;
+export function colIndex(letters) {
+    let n = 0;
+    for (const ch of letters.toUpperCase())
+        n = n * 26 + (ch.charCodeAt(0) - 64);
+    return n - 1;
+}
+export function colLetters(col) {
+    let s = '';
+    for (let n = col + 1; n > 0; n = Math.floor((n - 1) / 26))
+        s = String.fromCharCode(65 + ((n - 1) % 26)) + s;
+    return s;
+}
+export const a1 = (row, col) => `${colLetters(col)}${row + 1}`;
+/** `B3`, `B3:B5`, `B:B`, `3:3` (`$` allowed) → a box; undefined when it is none of these. */
+export function parseBox(s) {
+    const t = s.replace(/\$/g, '').toUpperCase();
+    let m = /^([A-Z]{1,3})(\d+)(?::([A-Z]{1,3})(\d+))?$/.exec(t);
+    if (m) {
+        const r1 = Number(m[2]) - 1, c1 = colIndex(m[1]);
+        const r2 = m[4] ? Number(m[4]) - 1 : r1, c2 = m[3] ? colIndex(m[3]) : c1;
+        if (r1 < 0 || r2 < 0)
+            return undefined;
+        return { top: Math.min(r1, r2), left: Math.min(c1, c2), bottom: Math.max(r1, r2), right: Math.max(c1, c2) };
+    }
+    m = /^([A-Z]{1,3}):([A-Z]{1,3})$/.exec(t);
+    if (m) {
+        const a = colIndex(m[1]), b = colIndex(m[2]);
+        return { top: 0, left: Math.min(a, b), bottom: MAX_ROWS - 1, right: Math.max(a, b) };
+    }
+    m = /^(\d+):(\d+)$/.exec(t);
+    if (m) {
+        const a = Number(m[1]) - 1, b = Number(m[2]) - 1;
+        return { top: Math.min(a, b), left: 0, bottom: Math.max(a, b), right: MAX_COLS - 1 };
+    }
+    return undefined;
+}
+const inBox = (b, row, col) => row >= b.top && row <= b.bottom && col >= b.left && col <= b.right;
+const NUM = /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/;
+const SHEET = String.raw `(?:'((?:[^']|'')+)'|([^\s!'"(),:=<>&+\-*/^]+))!`;
+const REF = new RegExp(`^(?:${SHEET})?(\\$?)([A-Za-z]{1,3})(\\$?)(\\d+)$`);
+const RANGE = new RegExp(`^(?:${SHEET})?(\\$?[A-Za-z]{1,3}\\$?\\d+:\\$?[A-Za-z]{1,3}\\$?\\d+|\\$?[A-Za-z]{1,3}:\\$?[A-Za-z]{1,3})$`);
+function dayBase(d1904) { return d1904 ? Date.UTC(1904, 0, 1) : Date.UTC(1899, 11, 30); }
+export function dateSerial(y, m, d, d1904) { return Math.round((Date.UTC(y, m - 1, d) - dayBase(d1904)) / 864e5); }
+/**
+ * Parses one operand (`formula1` / `formula2`): a number, quoted text, `DATE` / `TIME` of numbers, a cell or a
+ * range; a defined name is followed (three levels) to its formula.
+ *
+ * @param f - The operand as the file stores it, with or without `=`.
+ * @param book - The workbook (its date system and defined names).
+ * @param sheetIndex - The rule's sheet, 0-based — a sheet-scoped name wins over a global one.
+ * @param depth - How many defined names have been followed already; callers omit it.
+ * @returns The operand, or `undefined` when it is outside the subset (the rule is then skipped).
+ */
+export function parseOperand(f, book, sheetIndex, depth = 0) {
+    const t = f.trim().replace(/^=/, '').trim();
+    if (NUM.test(t))
+        return { k: 'num', v: Number(t) };
+    let m = /^"((?:[^"]|"")*)"$/.exec(t);
+    if (m)
+        return { k: 'str', v: m[1].replace(/""/g, '"') };
+    m = /^(DATE|TIME)\(\s*([^,()]+?)\s*,\s*([^,()]+?)\s*,\s*([^,()]+?)\s*\)$/i.exec(t);
+    if (m) {
+        const [a, b, c] = [m[2], m[3], m[4]].map(Number);
+        if (![a, b, c].every(Number.isFinite))
+            return undefined;
+        return m[1].toUpperCase() === 'DATE' ? { k: 'num', v: dateSerial(a, b, c, book.date1904) } : { k: 'num', v: (a * 3600 + b * 60 + c) / 86400 };
+    }
+    m = REF.exec(t);
+    if (m) {
+        const sheet = m[1] !== undefined ? m[1].replace(/''/g, "'") : m[2];
+        return { k: 'ref', sheet, absCol: m[3] === '$', col: colIndex(m[4]), absRow: m[5] === '$', row: Number(m[6]) - 1 };
+    }
+    m = RANGE.exec(t);
+    if (m) {
+        const sheet = m[1] !== undefined ? m[1].replace(/''/g, "'") : m[2];
+        const body = m[3], box = parseBox(body);
+        if (!box)
+            return undefined;
+        const first = body.split(':')[0];
+        return { k: 'range', sheet, box, absCol: first.startsWith('$'), absRow: /^\$?[A-Za-z]+\$/.test(first) || /^\$?[A-Za-z]+:/.test(body) };
+    }
+    if (depth < 3 && /^[A-Za-z_\\][\w.]*$/.test(t)) {
+        const names = book.definedNames.filter((n) => n.name.toLowerCase() === t.toLowerCase());
+        const n = names.find((x) => x.localSheetId === sheetIndex) ?? names.find((x) => x.localSheetId === undefined);
+        if (n)
+            return parseOperand(n.formula, book, sheetIndex, depth + 1);
+    }
+    return undefined;
+}
+/** Shifting relative references is @sheetpane/export's `shiftFormula`, re-exported by the grid peer. */
+export { shiftFormula };
+const cache = new WeakMap();
+/**
+ * The sheet's rules, compiled once per workbook. `type="none"` (any value) is not a rule.
+ *
+ * @param book - The workbook.
+ * @param sheetName - The sheet's name.
+ * @returns The compiled rules, skipped ones included (they carry `skip`).
+ */
+export function rulesOf(book, sheetName) {
+    let bySheet = cache.get(book);
+    if (!bySheet)
+        cache.set(book, (bySheet = new Map()));
+    let rules = bySheet.get(sheetName);
+    if (!rules)
+        bySheet.set(sheetName, (rules = compile(book, sheetName)));
+    return rules;
+}
+function compile(book, sheetName) {
+    const index = book.sheets.findIndex((s) => s.name === sheetName);
+    const sheet = book.sheets[index];
+    if (!sheet)
+        return [];
+    const out = [];
+    for (const dv of sheet.dataValidations) {
+        if (dv.type === 'none' || dv.type === '' || dv.type === 'any')
+            continue;
+        const boxes = dv.sqref.map(parseBox).filter((b) => !!b);
+        if (!boxes.length)
+            continue;
+        const kind = dv.type, op = (dv.operator ?? 'between');
+        const rule = { sheet: sheetName, dv, kind, op, boxes, anchor: { row: boxes[0].top, col: boxes[0].left } };
+        out.push(rule);
+        if (!KINDS.includes(kind)) {
+            rule.skip = { reason: 'type', detail: `rule type "${dv.type}"` };
+            continue;
+        }
+        if (kind === 'custom')
+            continue; // checked only with a formula evaluator (see `evaluatorOf`)
+        if (kind === 'list') {
+            const f = (dv.formula1 ?? '').trim();
+            const lit = /^"((?:[^"]|"")*)"$/.exec(f);
+            if (lit) {
+                rule.literal = lit[1].replace(/""/g, '"').split(',').map((x) => x.trim());
+                continue;
+            }
+            const o = parseOperand(f, book, index);
+            if (o && (o.k === 'range' || o.k === 'ref')) {
+                const src = o.sheet ?? sheetName;
+                if (!book.sheets.some((s) => s.name === src)) {
+                    rule.skip = { reason: 'source', detail: `list source "${f}" names no sheet in this workbook` };
+                    continue;
+                }
+                rule.f1 = o;
+            }
+            else if (o && o.k === 'num')
+                rule.literal = [String(o.v)];
+            else
+                rule.skip = { reason: 'source', detail: `list source "${f}" is not a list, a range or a defined name` };
+            continue;
+        }
+        if (!OPERATORS.includes(op)) {
+            rule.skip = { reason: 'operator', detail: `operator "${dv.operator}"` };
+            continue;
+        }
+        const two = op === 'between' || op === 'notBetween';
+        const f1 = dv.formula1 !== undefined ? parseOperand(dv.formula1, book, index) : undefined;
+        const f2 = two && dv.formula2 !== undefined ? parseOperand(dv.formula2, book, index) : undefined;
+        const bad = (o) => !o || o.k === 'range';
+        if (bad(f1) || (two && bad(f2))) {
+            rule.skip = { reason: 'operand', detail: `operand "${bad(f1) ? dv.formula1 ?? '' : dv.formula2 ?? ''}" is not a number, a date, a time or a cell` };
+            continue;
+        }
+        rule.f1 = f1;
+        if (two)
+            rule.f2 = f2;
+    }
+    return out;
+}
+export function evaluatorOf(store) {
+    const p = store.plugins.find((x) => x.provides.includes('derive'));
+    return typeof p?.evaluate === 'function' ? p.evaluate.bind(p) : undefined;
+}
+/** The reason a rule is not checked in this store, if it is not. */
+export function skipOf(rule, store) {
+    if (rule.skip)
+        return rule.skip;
+    if (rule.kind === 'custom' && !(store && evaluatorOf(store)))
+        return { reason: 'custom', detail: store?.plugins.some((p) => p.provides.includes('derive')) ? 'custom (formula) rule — the formula plugin offers no evaluate()' : 'custom (formula) rule — needs the formulas plugin' };
+    return undefined;
+}
+// ── values ────────────────────────────────────────────────────────────────
+/** The cell's value now. A typed formula (change kind `formula`) is its derived result, not its text. */
+export function valueAt(store, sheet, ref) {
+    const c = store.changeOf(sheet, ref);
+    if (c?.kind === 'formula') {
+        const d = store.getSnapshot().derived.get(`${sheet}!${ref}`);
+        return d ? d.value : undefined;
+    }
+    return store.value(sheet, ref);
+}
+export function textAt(store, sheet, ref) {
+    const c = store.changeOf(sheet, ref);
+    if (c?.kind === 'formula')
+        return store.getSnapshot().derived.get(`${sheet}!${ref}`)?.text ?? String(c.now);
+    return store.text(sheet, ref);
+}
+const toNumber = (v) => {
+    if (v === null)
+        return 0; // an empty cell reads as 0, as in Excel
+    if (typeof v === 'number')
+        return v;
+    if (typeof v === 'string') {
+        const t = v.trim();
+        return NUM.test(t) ? Number(t) : undefined;
+    }
+    return undefined;
+};
+/** An operand's number at one cell; undefined when the cell it reads is not a number. */
+function operandAt(o, rule, store, row, col) {
+    if (o.k === 'num')
+        return o.v;
+    if (o.k === 'str')
+        return toNumber(o.v);
+    if (o.k === 'ref') {
+        const r = o.absRow ? o.row : o.row + row - rule.anchor.row, c = o.absCol ? o.col : o.col + col - rule.anchor.col;
+        if (r < 0 || c < 0)
+            return undefined;
+        return toNumber(valueAt(store, o.sheet ?? rule.sheet, a1(r, c)));
+    }
+    return undefined;
+}
+/**
+ * A `list` rule's choices at one cell — the literal list, or read live from the store for a range (relative parts
+ * shifted to the cell; empty and repeated values dropped).
+ *
+ * @param rule - A `list` rule.
+ * @param store - The workbook store.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns The choices, in order.
+ */
+export function listOptions(rule, store, row, col) {
+    if (rule.literal)
+        return rule.literal;
+    const o = rule.f1;
+    if (!o || (o.k !== 'range' && o.k !== 'ref'))
+        return [];
+    const src = o.sheet ?? rule.sheet;
+    const dr = o.absRow ? 0 : row - rule.anchor.row, dc = o.absCol ? 0 : col - rule.anchor.col;
+    const box = o.k === 'ref' ? { top: o.row, left: o.col, bottom: o.row, right: o.col } : o.box;
+    const s = store.sheet(src);
+    const used = s ? usedRange(store, s) : { rows: 0, cols: 0 };
+    const out = [];
+    const seen = new Set();
+    for (let r = box.top + dr; r <= Math.min(box.bottom + dr, used.rows - 1); r++) {
+        for (let c = box.left + dc; c <= Math.min(box.right + dc, used.cols - 1); c++) {
+            if (r < 0 || c < 0)
+                continue;
+            const t = textAt(store, src, a1(r, c));
+            if (t === '' || seen.has(t))
+                continue;
+            seen.add(t);
+            out.push(t);
+        }
+    }
+    return out;
+}
+/** The rows and columns a sheet uses: its data, plus any cell a user changed. */
+export function usedRange(store, s) {
+    let rows = s.rows.length, cols = s.rows.reduce((m, r) => Math.max(m, r?.length ?? 0), 0);
+    const prefix = `${s.name}!`;
+    for (const k of store.getSnapshot().changes.keys()) {
+        if (!k.startsWith(prefix))
+            continue;
+        const box = parseBox(k.slice(prefix.length));
+        if (box && box.top === box.bottom && box.left === box.right) {
+            rows = Math.max(rows, box.top + 1);
+            cols = Math.max(cols, box.left + 1);
+        }
+    }
+    return { rows, cols };
+}
+const compare = (op, x, a, b) => {
+    const lo = b === undefined ? a : Math.min(a, b), hi = b === undefined ? a : Math.max(a, b);
+    switch (op) {
+        case 'between': return x >= lo && x <= hi;
+        case 'notBetween': return x < lo || x > hi;
+        case 'equal': return x === a;
+        case 'notEqual': return x !== a;
+        case 'greaterThan': return x > a;
+        case 'lessThan': return x < a;
+        case 'greaterThanOrEqual': return x >= a;
+        case 'lessThanOrEqual': return x <= a;
+    }
+};
+/**
+ * Does one cell pass one (checkable) rule? A blank cell passes with `allowBlank`.
+ *
+ * @param rule - A rule that is not skipped.
+ * @param store - The workbook store (current values).
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @param evaluate - The formula engine's `evaluate`, for `custom` rules; `undefined` without one.
+ * @param memo - A cache of list sources, shared across one run.
+ * @returns `pass`, `fail`, or `unknown` when an operand cannot be read — not an error.
+ */
+export function check(rule, store, row, col, evaluate, memo) {
+    const ref = a1(row, col);
+    const v = valueAt(store, rule.sheet, ref);
+    if (v === undefined)
+        return 'unknown';
+    const blank = v === null || v === '';
+    if (blank && rule.dv.allowBlank)
+        return 'pass';
+    if (rule.kind === 'custom') {
+        if (!evaluate || !rule.dv.formula1)
+            return 'unknown';
+        const f = shiftFormula(rule.dv.formula1.replace(/^=/, ''), row - rule.anchor.row, col - rule.anchor.col);
+        let r;
+        try {
+            r = evaluate(f, { sheet: rule.sheet, ref });
+        }
+        catch {
+            return 'unknown';
+        }
+        if (typeof r === 'boolean')
+            return r ? 'pass' : 'fail';
+        if (typeof r === 'number')
+            return r !== 0 ? 'pass' : 'fail';
+        return 'unknown';
+    }
+    if (rule.kind === 'list') {
+        if (blank)
+            return 'fail';
+        const fixed = !rule.f1 || (rule.f1.k !== 'ref' && rule.f1.k !== 'range') || (rule.f1.absRow && rule.f1.absCol);
+        let opts = fixed ? memo?.get(rule) : undefined;
+        if (!opts) {
+            opts = listOptions(rule, store, row, col);
+            if (fixed)
+                memo?.set(rule, opts);
+        }
+        const t = textAt(store, rule.sheet, ref).trim().toLowerCase();
+        if (opts.some((o) => o.trim().toLowerCase() === t))
+            return 'pass';
+        if (typeof v === 'number' && opts.some((o) => { const n = toNumber(o.replace(/(\d),(?=\d{3}\b)/g, '$1')); return n !== undefined && n === v; }))
+            return 'pass';
+        return 'fail';
+    }
+    let x;
+    if (rule.kind === 'textLength') {
+        x = v === null ? 0 : typeof v === 'string' ? v.length : typeof v === 'boolean' ? (v ? 4 : 5) : String(v).length;
+    }
+    else {
+        if (typeof v !== 'number')
+            return 'fail';
+        if (rule.kind === 'whole' && !Number.isInteger(v))
+            return 'fail';
+        x = v;
+    }
+    const a = operandAt(rule.f1, rule, store, row, col);
+    const b = rule.f2 ? operandAt(rule.f2, rule, store, row, col) : undefined;
+    if (a === undefined || (rule.f2 && b === undefined))
+        return 'unknown';
+    return compare(rule.op, x, a, b) ? 'pass' : 'fail';
+}
+// ── the rule in words (the error row's "expected") ────────────────────────
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+export function dateText(serial, d1904) {
+    const d = new Date(dayBase(d1904) + Math.floor(serial) * 864e5);
+    return `${String(d.getUTCDate()).padStart(2, '0')}-${MONTHS[d.getUTCMonth()]}-${d.getUTCFullYear()}`;
+}
+export function timeText(serial) {
+    const secs = Math.round((serial - Math.floor(serial)) * 86400) % 86400;
+    const h = Math.floor(secs / 3600), m = Math.floor((secs % 3600) / 60), s = secs % 60;
+    return `${String(h).padStart(2, '0')}:${String(m).padStart(2, '0')}${s ? `:${String(s).padStart(2, '0')}` : ''}`;
+}
+const TYPE_WORDS = { whole: 'whole number', decimal: 'decimal', date: 'date', time: 'time', textLength: 'text length', list: 'list', custom: 'custom' };
+const OP_WORDS = { between: 'between', notBetween: 'not between', equal: '=', notEqual: '≠', greaterThan: '>', lessThan: '<', greaterThanOrEqual: '≥', lessThanOrEqual: '≤' };
+const LIST_SHOWN = 8;
+/**
+ * The rule in words, at one cell: `whole number > 0`, `decimal between 0.00% and 2.00%`, `date ≤ 30-Sep-2026`,
+ * `list — Core, Income, Cap` — an error's `expected`.
+ *
+ * @param rule - The rule.
+ * @param store - The workbook store (cell operands are read live).
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns The sentence.
+ */
+export function ruleWords(rule, store, row, col) {
+    const ref = a1(row, col);
+    if (rule.kind === 'list') {
+        const opts = listOptions(rule, store, row, col);
+        const shown = opts.slice(0, LIST_SHOWN).join(', ');
+        return `list — ${shown || '(empty)'}${opts.length > LIST_SHOWN ? `, … (${opts.length - LIST_SHOWN} more)` : ''}`;
+    }
+    if (rule.kind === 'custom')
+        return `custom — =${(rule.dv.formula1 ?? '').replace(/^=/, '')}`;
+    const book = store.book;
+    const show = (o) => {
+        if (!o)
+            return '?';
+        const n = operandAt(o, rule, store, row, col);
+        if (n === undefined)
+            return o.k === 'ref' ? a1(o.row, o.col) : '?';
+        if (rule.kind === 'date')
+            return dateText(n, book?.date1904 ?? false);
+        if (rule.kind === 'time')
+            return timeText(n);
+        if (rule.kind === 'textLength')
+            return String(n);
+        return store.format(rule.sheet, ref, n);
+    };
+    const two = rule.op === 'between' || rule.op === 'notBetween';
+    return `${TYPE_WORDS[rule.kind]} ${OP_WORDS[rule.op]} ${show(rule.f1)}${two ? ` and ${show(rule.f2)}` : ''}${rule.kind === 'textLength' ? ' characters' : ''}`;
+}
+/** Does a cell sit in one of the rule's ranges? */
+export const covers = (rule, row, col) => rule.boxes.some((b) => inBox(b, row, col));
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

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

package/dist/ui.d.ts

@@ -0,0 +1,55 @@
+import { type Plugin, type Snapshot } from '@sheetpane/grid';
+import { type ValidationOptions } from './index.js';
+/** The controls plugin's id. */
+export declare const UI_ID = "validation-ui";
+/**
+ * Open validation errors in a snapshot.
+ *
+ * @param snap - A snapshot of the store.
+ * @returns How many errors by the `workbook` author, of type `validation`, are open.
+ */
+export declare function openWarnings(snap: Snapshot): number;
+/**
+ * The status line: `3 validation warnings`, plus `· 1 rule not checked` when some are skipped.
+ *
+ * @param snap - A snapshot of the store.
+ * @returns The text, or `''` when the workbook has no rules.
+ */
+export declare function statusText(snap: Snapshot): string;
+/**
+ * The validation controls: a list arrow on every cell a `list` rule covers (Edit; mouse or Alt+↓, a pick sets the
+ * cell, undoably) and the count of open validation warnings in the status line. No hooks — pair it with
+ * {@link validation}; importing this module makes `plugins="validation"` enable both.
+ *
+ * @returns The controls plugin (`id: 'validation-ui'`).
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0108_VALIDATION.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { validation } from '@sheetpane/validation';
+ * import { ui } from '@sheetpane/validation/ui';
+ *
+ * const book = createWorkbook({ plugins: [validation(), ui()] });
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/validation/ui'; // registers `validation` with its controls
+ * excel.setAttribute('plugins', 'validation');
+ * ```
+ */
+export declare function ui(): Plugin;
+/**
+ * The validation plugin and its controls together.
+ *
+ * @param o - The validation plugin's options.
+ * @returns `[validation(o), ui()]`.
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { validationWithUi } from '@sheetpane/validation/ui';
+ *
+ * const book = createWorkbook({ plugins: validationWithUi() });
+ * ```
+ */
+export declare function validationWithUi(o?: ValidationOptions): Plugin[];
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0C,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAA0D,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG5G,gCAAgC;AAChC,eAAO,MAAM,KAAK,kBAAkB,CAAC;AAGrC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAKjD;AA0BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,EAAE,IAAI,MAAM,CAE3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAE,iBAAsB,GAAG,MAAM,EAAE,CAEpE"}

package/dist/ui.js

@@ -0,0 +1,96 @@
+// @sheetpane/validation/ui — the controls validation adds to the grid's slots
+// (W-18 DoD 4): a list arrow in every cell a `list` rule covers (Edit), and the
+// count of open validation warnings in the status line (both modes).
+// Opt-in: the headless entry never imports this file.
+import { registerPlugin } from '@sheetpane/grid';
+import { AUTHOR, ERROR_TYPE, lastReport, listRuleAt, validation } from './index.js';
+import { listOptions } from './rules.js';
+/** The controls plugin's id. */
+export const UI_ID = 'validation-ui';
+const ARROW = '<svg viewBox="0 0 12 12" width="12" height="12" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 4.5l3 3 3-3"/></svg>';
+/**
+ * Open validation errors in a snapshot.
+ *
+ * @param snap - A snapshot of the store.
+ * @returns How many errors by the `workbook` author, of type `validation`, are open.
+ */
+export function openWarnings(snap) {
+    return snap.errors.filter((e) => e.author === AUTHOR && e.type === ERROR_TYPE && e.status === 'open').length;
+}
+/**
+ * The status line: `3 validation warnings`, plus `· 1 rule not checked` when some are skipped.
+ *
+ * @param snap - A snapshot of the store.
+ * @returns The text, or `''` when the workbook has no rules.
+ */
+export function statusText(snap) {
+    const report = lastReport(snap.book);
+    if (!report?.rules)
+        return '';
+    const n = openWarnings(snap), k = report.skipped.length;
+    return `${n} validation warning${n === 1 ? '' : 's'}${k ? ` · ${k} rule${k === 1 ? '' : 's'} not checked` : ''}`;
+}
+const listArrow = {
+    id: 'validation-list',
+    slot: 'cell',
+    group: 'validation',
+    label: 'Choose from the list',
+    icon: ARROW,
+    mode: 'edit',
+    appliesTo: (cell) => !!listRuleAt(cell.store, cell.sheet.name, cell.row, cell.col),
+    cellOptions: (cell) => {
+        const rule = listRuleAt(cell.store, cell.sheet.name, cell.row, cell.col);
+        return rule ? listOptions(rule, cell.store, cell.row, cell.col) : [];
+    },
+    choose: (store, sel, value) => { store.setCell(sel.sheet, sel.ref, value); },
+};
+const status = {
+    id: 'validation-status',
+    slot: 'status',
+    group: 'validation',
+    label: 'Validation warnings',
+    mode: 'both',
+    text: (snap) => statusText(snap),
+};
+/**
+ * The validation controls: a list arrow on every cell a `list` rule covers (Edit; mouse or Alt+↓, a pick sets the
+ * cell, undoably) and the count of open validation warnings in the status line. No hooks — pair it with
+ * {@link validation}; importing this module makes `plugins="validation"` enable both.
+ *
+ * @returns The controls plugin (`id: 'validation-ui'`).
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0108_VALIDATION.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { validation } from '@sheetpane/validation';
+ * import { ui } from '@sheetpane/validation/ui';
+ *
+ * const book = createWorkbook({ plugins: [validation(), ui()] });
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/validation/ui'; // registers `validation` with its controls
+ * excel.setAttribute('plugins', 'validation');
+ * ```
+ */
+export function ui() {
+    return { id: UI_ID, provides: [], controls: [listArrow, status] };
+}
+/**
+ * The validation plugin and its controls together.
+ *
+ * @param o - The validation plugin's options.
+ * @returns `[validation(o), ui()]`.
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { validationWithUi } from '@sheetpane/validation/ui';
+ *
+ * const book = createWorkbook({ plugins: validationWithUi() });
+ * ```
+ */
+export function validationWithUi(o = {}) {
+    return [validation(o), ui()];
+}
+registerPlugin('validation', () => [validation(), ui()]);
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

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

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@sheetpane/validation",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Data validation for sheetpane — the workbook's own `<dataValidations>` rules checked on load and on every edit, landing in <sheetpane-errors> — as a plugin on the `validate` hook.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arpitarya/sheetpane.git",
+    "directory": "packages/validation"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/ui.js",
+    "./src/index.ts",
+    "./src/ui.ts"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@sheetpane/grid": "0.1.0"
+  },
+  "dependencies": {
+    "@sheetpane/skills": "0.1.0"
+  },
+  "devDependencies": {
+    "@sheetpane/export": "0.1.0",
+    "@sheetpane/formulas": "0.1.0",
+    "@sheetpane/grid": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }