@sheetpane/grid 0.1.0 → 0.4.0

package/dist/pane/structure.js

@@ -0,0 +1,238 @@
+// Rows and columns inserted or deleted (W-52), as the store applies them: what is refused, and
+// how the store's own tables move — the change map, the errors, the derived values, the
+// selection and the plugin-error index. The imported workbook itself moves through
+// @sheetpane/import's restructureWorkbook; patchXlsx moves the file. Pure functions; the
+// store owns the one commit path.
+import { MAX_COLS, MAX_ROWS, cellRef, isInsertOp, isRowOp, movesRange, parseRange, parseRef, rangeRef, restructureFormula, shiftCount, shiftIndex, shiftRangePos, shiftRefText, splitsRange, tableRefusal, } from '@sheetpane/export';
+/** The change-map ref that holds a sheet's operations, in order: `Sheet1!#structure`. */
+export const STRUCTURE_REF = '#structure';
+const splitKey = (k) => { const i = k.lastIndexOf('!'); return { sheet: k.slice(0, i), ref: k.slice(i + 1) }; };
+const what = (o) => `${o.count} ${isRowOp(o) ? 'row' : 'column'}${o.count === 1 ? '' : 's'}`;
+/** The sheet's Excel tables as `@sheetpane/import` reads them (W-61); none on a hand-made sheet. */
+function tablesOf(s) {
+    return s.tables ?? [];
+}
+/**
+ * What Excel refuses, sheetpane refuses (W-52 DoD 5): a delete that cuts a merged range (SP-3022),
+ * anything that would move a pivot table or its source (SP-3023), an insert that would push cells
+ * off the sheet (SP-3024), and a cut a table cannot follow (SP-3025).
+ * @param book - The workbook.
+ * @param merges - The sheet's merged ranges as they are now (the file's, with merge changes).
+ * @param o - The operation.
+ * @returns The refusal, or `undefined` when the operation may go ahead.
+ */
+export function structureRefusal(book, merges, o) {
+    const s = book.sheets.find((x) => x.name === o.sheet);
+    if (!s)
+        return undefined;
+    if (!isInsertOp(o)) {
+        const cut = merges.find((m) => { const r = parseRange(m); return r && splitsRange(r, o); });
+        if (cut)
+            return { code: 'SP-3022', message: `Deleting ${what(o)} would split the merged cells ${cut} — unmerge them first.` };
+    }
+    for (const sh of book.sheets)
+        for (const p of sh.pivotTables) {
+            const at = sh.name === o.sheet ? parseRange(p.ref) : undefined;
+            if (at && movesRange(at, o))
+                return { code: 'SP-3023', message: `This would move the pivot table ${p.name || p.ref} — sheetpane does not rewrite pivot tables.` };
+            const src = p.source && p.source.sheet.toUpperCase() === o.sheet.toUpperCase() ? parseRange(p.source.ref) : undefined;
+            if (src && movesRange(src, o))
+                return { code: 'SP-3023', message: `This would move ${p.source.ref}, the source of the pivot table ${p.name || p.ref} — sheetpane does not rewrite pivot sources.` };
+        }
+    if (isInsertOp(o)) {
+        const used = isRowOp(o) ? s.rows.length : s.rows.reduce((m, r) => Math.max(m, r.length), 0);
+        if (used > o.at && used + o.count > (isRowOp(o) ? MAX_ROWS : MAX_COLS))
+            return { code: 'SP-3024', message: `Inserting ${what(o)} would push cells off the end of the sheet.` };
+    }
+    for (const t of tablesOf(s)) {
+        const r = parseRange(t.ref);
+        const why = r && tableRefusal(r, o, { name: t.name, header: t.headerRowCount > 0, totals: t.totalsRowCount > 0 });
+        if (why)
+            return { code: 'SP-3025', message: `This ${why}.` };
+    }
+    return undefined;
+}
+/** A cell ref moved; `undefined` when deleted. */
+function moveCell(ref, o) {
+    const p = parseRef(ref);
+    if (!p)
+        return ref;
+    const i = shiftIndex(isRowOp(o) ? p.row : p.col, o);
+    return i === undefined ? undefined : isRowOp(o) ? cellRef(i, p.col) : cellRef(p.row, i);
+}
+const isFormula = (c) => c.kind === 'formula' || (c.kind === 'value' && typeof c.now === 'string' && c.now.startsWith('='));
+const moveIndexes = (v, o) => (Array.isArray(v) ? v.flatMap((i) => { const j = shiftIndex(i, o); return j === undefined ? [] : [j]; }) : v);
+const moveLevels = (v, o) => {
+    if (!v || typeof v !== 'object')
+        return v;
+    const out = {};
+    for (const [k, l] of Object.entries(v)) {
+        const j = shiftIndex(Number(k), o);
+        if (j !== undefined)
+            out[j] = l;
+    }
+    return out;
+};
+const moveFreeze = (v, o) => {
+    const f = v;
+    if (!f || typeof f !== 'object')
+        return v;
+    return isRowOp(o) ? { ...f, rows: shiftCount(f.rows, o) } : { ...f, cols: shiftCount(f.cols, o) };
+};
+/**
+ * The change map after the operation: entries of the sheet rekeyed (deleted cells' entries go),
+ * formulas everywhere that point at the sheet rewritten, sheet-wide entries (freeze, hidden,
+ * outline) moved, and the operation appended to the sheet's `#structure` entry.
+ * @param changes - The change map now.
+ * @param o - The operation.
+ * @param carry - Told of each entry rewritten into a new object (a formula, a freeze), so its edit keeps its time (W-64).
+ * @returns A new change map.
+ */
+export function shiftChanges(changes, o, carry) {
+    const out = new Map();
+    const rows = isRowOp(o);
+    for (const [k, c] of changes) {
+        const { sheet, ref } = splitKey(k);
+        let next = c;
+        if (isFormula(c)) {
+            const f = String(c.now);
+            const g = `=${restructureFormula(f.slice(1), sheet, o)}`;
+            if (g !== f)
+                next = { ...c, now: g };
+        }
+        if (sheet !== o.sheet) {
+            if (next !== c)
+                carry?.(c, next);
+            out.set(k, next);
+            continue;
+        }
+        let key = ref;
+        const slot = /^#(style|numFmt):(.+)$/.exec(ref);
+        if (slot) {
+            const m = moveCell(slot[2], o);
+            if (m === undefined)
+                continue;
+            key = `#${slot[1]}:${m}`;
+        }
+        else if (ref.startsWith('#merge:')) {
+            const m = shiftRefText(ref.slice(7), o);
+            if (m === undefined || !m.includes(':'))
+                continue;
+            key = `#merge:${m}`;
+        }
+        else if (ref === '#freeze')
+            next = { ...next, now: moveFreeze(next.now, o), was: moveFreeze(next.was, o) };
+        else if (ref === (rows ? '#hiddenRows' : '#hiddenCols'))
+            next = { ...next, now: moveIndexes(next.now, o), was: moveIndexes(next.was, o) };
+        else if (ref === (rows ? '#outlineRows' : '#outlineCols'))
+            next = { ...next, now: moveLevels(next.now, o), was: moveLevels(next.was, o) };
+        else if (!ref.startsWith('#')) {
+            const m = moveCell(ref, o);
+            if (m === undefined)
+                continue;
+            key = m;
+        }
+        if (next !== c)
+            carry?.(c, next);
+        out.set(`${sheet}!${key}`, next);
+    }
+    const sk = `${o.sheet}!${STRUCTURE_REF}`, prev = out.get(sk);
+    out.set(sk, { kind: 'structure', was: [], now: [...(prev?.now ?? []), { sheet: o.sheet, op: o.op, at: o.at, count: o.count }] });
+    return out;
+}
+/** Derived values keyed by cell, moved with their cells. */
+export function shiftDerived(derived, o) {
+    const out = new Map();
+    for (const [k, d] of derived) {
+        const { sheet, ref } = splitKey(k);
+        if (sheet !== o.sheet) {
+            out.set(k, d);
+            continue;
+        }
+        const m = moveCell(ref, o);
+        if (m !== undefined)
+            out.set(`${sheet}!${m}`, d);
+    }
+    return out;
+}
+/**
+ * The errors after the operation: ranges on the sheet move; an error whose every cell was deleted
+ * stays, `resolved`, with the message "row deleted" (or "column deleted"), its range as it was.
+ * @param errors - The errors now.
+ * @param o - The operation.
+ * @returns The errors, and the ids of those whose cells were deleted.
+ */
+export function shiftErrors(errors, o) {
+    const gone = new Set();
+    const out = errors.map((e) => {
+        if (e.sheet !== o.sheet)
+            return e;
+        const r = parseRange(e.range);
+        if (!r)
+            return e;
+        const m = shiftRangePos(r, o);
+        if (!m) { // W-69: a resolved error carries no acceptance
+            gone.add(e.id);
+            const { acceptedBy: _by, acceptedAt: _at, reason: _why, ...rest } = e;
+            return { ...rest, status: 'resolved', message: isRowOp(o) ? 'row deleted' : 'column deleted' };
+        }
+        const range = e.range.includes(':') ? `${cellRef(m.top, m.left)}:${cellRef(m.bottom, m.right)}` : rangeRef(m);
+        return range === e.range ? e : { ...e, range };
+    });
+    return { errors: out, gone };
+}
+/**
+ * The plugin-error index (`plugin|sheet|range|type…` → id) with each key's range following its
+ * error, so `validate` finds the moved error rather than adding a second one.
+ * @param index - The index now.
+ * @param before - The errors before the operation.
+ * @param after - The errors after it.
+ * @param gone - Ids of errors whose cells were deleted: their keys go.
+ * @returns A new index.
+ */
+export function shiftPluginErrors(index, before, after, gone) {
+    const was = new Map(before.map((e) => [e.id, e])), now = new Map(after.map((e) => [e.id, e]));
+    const out = new Map();
+    for (const [k, id] of index) {
+        if (gone.has(id))
+            continue;
+        const a = was.get(id), b = now.get(id);
+        if (!a || !b || a.range === b.range) {
+            out.set(k, id);
+            continue;
+        }
+        const from = `|${a.sheet}|${a.range}|`, i = k.indexOf(from);
+        out.set(i < 0 ? k : `${k.slice(0, i)}|${b.sheet}|${b.range}|${k.slice(i + from.length)}`, id);
+    }
+    return out;
+}
+/** The selection after the operation: it moves with its cells; a deleted active cell lands on the row (column) that took its place. */
+export function shiftSelection(sel, o) {
+    if (sel.sheet !== o.sheet)
+        return sel;
+    const p = parseRef(sel.ref);
+    if (!p)
+        return sel;
+    const clamp = (i) => shiftIndex(i, o) ?? Math.max(0, Math.min(o.at, i));
+    const ref = isRowOp(o) ? cellRef(clamp(p.row), p.col) : cellRef(p.row, clamp(p.col));
+    const next = { sheet: sel.sheet, ref };
+    const r = sel.range ? parseRange(sel.range) : undefined;
+    const m = r && shiftRangePos(r, o);
+    if (m && (m.top !== m.bottom || m.left !== m.right))
+        next.range = `${cellRef(m.top, m.left)}:${cellRef(m.bottom, m.right)}`;
+    return next;
+}
+/** The open Flag issue form follows its cell, or closes when the cell was deleted. */
+export function shiftComposing(c, o) {
+    if (!c || c.sheet !== o.sheet)
+        return c;
+    const ref = moveCell(c.ref, o);
+    if (ref === undefined)
+        return null;
+    const next = { sheet: c.sheet, ref };
+    const r = c.range ? parseRange(c.range) : undefined, m = r && shiftRangePos(r, o);
+    if (m)
+        next.range = rangeRef(m);
+    return next;
+}
+//# sourceMappingURL=structure.js.map

package/dist/pane/structure.js.map

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

package/dist/pane/types.d.ts

@@ -2,15 +2,33 @@ import type { Cell, SpCode } from '@sheetpane/export';
 import type { ImportedWorkbook } from '@sheetpane/import';
 /** The pane's mode, shared by its elements: `view` reads, `edit` changes cells and flags errors. */
 export type Mode = 'view' | 'edit';
-/** How serious an error is; see {@link SEVERITY} for its name, glyph and help line. */
-export type Severity = 'error' | 'warning' | 'note';
+/**
+ * How serious an error is — or, for `pass` and `skipped` (not checked), a result rather than a
+ * problem (W-50); see {@link SEVERITY} for its name, glyph and help line.
+ */
+export type Severity = 'error' | 'warning' | 'note' | 'pass' | 'skipped';
+/** The severities that ask for action: everything but a result. */
+export type ProblemSeverity = 'error' | 'warning' | 'note';
+/** A result, not a problem: a passed check or a cell that was not checked (W-50). */
+export type ResultSeverity = 'pass' | 'skipped';
+/**
+ * How much of the results a pane shows (W-50, the `results` attribute): `off` drops `pass` and
+ * `skipped` entries on arrival; `summary` (the default) counts them in the errors panel and marks
+ * nothing on the sheet; `marks` also puts a ✓ or — in each result cell's bottom-left corner.
+ */
+export type ResultsLevel = 'off' | 'summary' | 'marks';
+/** The results levels, in order. */
+export declare const RESULTS_LEVELS: readonly ResultsLevel[];
+/** The `results` attribute's level: `off` or `marks`, else `summary`. */
+export declare const resultsLevelOf: (v: string | null | undefined) => ResultsLevel;
 /** SheetpaneError v1 — exactly the contract verdict's schema. */
 export interface SheetpaneError {
     v: 1;
     /** `"ERR-0003"` — stable, never reused in a session. */
     id: string;
+    /** The sheet's name; `""` (with `range: ""`) for an error about the whole workbook (W-55). */
     sheet: string;
-    /** A1 cell `"I6"` or a whole row `"A14:J14"`. */
+    /** A1 cell `"I6"` or a whole row `"A14:J14"`; `""` for an error about the whole sheet, or the workbook (W-55) — see {@link errorScope}. */
     range: string;
     /** An id from `errorTypes`, e.g. `"wrong-value"`. */
     type: string;
@@ -21,7 +39,8 @@ export interface SheetpaneError {
     message: string;
     /** "Also change the cell" was ticked. */
     cellChanged: boolean;
-    status: 'open' | 'resolved';
+    /** `accepted` (W-69): a known deviation someone approved — kept, never counted as open; it carries `acceptedBy`, `acceptedAt` and a `reason`. */
+    status: ErrorStatus;
     /** Computed: the cell now shows `expected` (B-022 — it does not resolve the error). */
     matchesExpected: boolean;
     /** The element's `author`, `"workbook"` (validation) or `"file"` (comments), or `""`. */
@@ -30,18 +49,153 @@ export interface SheetpaneError {
     createdAt: string;
     /** The stable SP code (W-40) when sheetpane itself raised the error — a rules-engine note, e.g. `"SP-6023"`; see docs/ERRORS.md. Optional: v1 stays valid without it. */
     code?: SpCode;
+    /**
+     * The host's own data about the error (W-68) — what `renderDetail` reads, e.g. a PDF page and box, a measured and an
+     * expected size. Any JSON value up to {@link ERROR_META_MAX} bytes; kept as its JSON round trip, carried by
+     * `getErrors()`, `setErrors()` and the `sheetpane-errors` envelope, and never written into the file. Optional: v1
+     * stays valid without it.
+     */
+    meta?: ErrorMeta;
+    /** Who accepted the deviation (W-69): the element's `author`, or what the host passed; `""` when nobody was named. Only while `status` is `accepted`. */
+    acceptedBy?: string;
+    /** When it was accepted, ISO 8601 (W-69). Only while `status` is `accepted`. */
+    acceptedAt?: string;
+    /** Why it was accepted (W-69) — required, never blank, while `status` is `accepted`; written into the export as *Accepted: <reason>*. */
+    reason?: string;
+    /**
+     * The review layer the error belongs to (W-51), e.g. `"validation"` or `"pdf"`: a named set of errors the host replaces
+     * whole with `setErrors(list, { layer })` and the user shows with the layers switch. Every error the store holds carries
+     * one; an error given without it (a review saved before W-51) is in {@link DEFAULT_LAYER}. A name is 1–64 characters
+     * with no spaces ({@link isLayerName}). An edit never moves an error to another layer.
+     */
+    layer?: string;
 }
+/** The layer an error is in when nobody names one (W-51): `"review"` — people's errors and the plugins' land here. */
+export declare const DEFAULT_LAYER = "review";
+/**
+ * Whether a value may name a review layer (W-51): a string of 1–64 characters with no whitespace, so the `layers`
+ * attribute can list several separated by spaces.
+ *
+ * @param x - Any value.
+ * @returns True for a usable layer name.
+ * @example
+ * ```ts
+ * import { isLayerName } from '@sheetpane/grid';
+ * isLayerName('pdf'); // true
+ * isLayerName('PDF check'); // false — a space
+ * ```
+ */
+export declare const isLayerName: (x: unknown) => x is string;
+/**
+ * The layer an error is in (W-51): its `layer`, else {@link DEFAULT_LAYER}.
+ *
+ * @param e - The error, or just its `layer`.
+ * @returns The layer's name.
+ * @example
+ * ```ts
+ * import { layerOf } from '@sheetpane/grid';
+ * layerOf({ layer: 'pdf' }); // 'pdf'
+ * layerOf({}); // 'review'
+ * ```
+ */
+export declare const layerOf: (e: Pick<SheetpaneError, 'layer'>) => string;
+/**
+ * What `sheetpane-errors` carries and a host saves to restore a review (W-51 bumps it to `v: 2`): every error with its
+ * `layer`, the pane's plugin ids, and the pane's layers in order — an empty one included, so a check that found nothing
+ * comes back as a layer. `changed` names the layers whose errors changed in this event (ignored on restore).
+ * `setErrors(envelope)` restores it; an envelope saved before W-51 (`{ errors, plugins }`, no `v`) restores into
+ * `review`.
+ *
+ * @example
+ * ```ts
+ * import '@sheetpane/grid';
+ * import type { ErrorsEnvelope } from '@sheetpane/grid';
+ * const list = document.querySelector('sheetpane-errors')!;
+ * list.addEventListener('sheetpane-errors', (e) => localStorage.setItem('review', JSON.stringify((e as CustomEvent<ErrorsEnvelope>).detail)));
+ * const saved = JSON.parse(localStorage.getItem('review') ?? 'null') as ErrorsEnvelope | null;
+ * if (saved) list.setErrors(saved);
+ * ```
+ */
+export interface ErrorsEnvelope {
+    /** `2` since W-51; absent in an envelope saved before it. */
+    v?: 2;
+    errors: SheetpaneError[];
+    plugins?: string[];
+    /** The pane's layers in the order they were first named. */
+    layers?: string[];
+    /** The layers whose errors changed in this event. */
+    changed?: string[];
+}
+/**
+ * Where an error stands: `open` counts as a problem; `resolved` is fixed; `accepted` (W-69) is a known deviation someone
+ * approved with a reason — kept in the review and the download, never counted as open.
+ */
+export type ErrorStatus = 'open' | 'resolved' | 'accepted';
+/** A JSON value: what `SheetpaneError.meta` holds (W-68). */
+export type ErrorMeta = null | boolean | number | string | ErrorMeta[] | {
+    [key: string]: ErrorMeta;
+};
+/** The most an error's `meta` may weigh, in bytes of its JSON text (UTF-8): 64 KiB. Over it, the meta is dropped with SP-3016 (W-68). */
+export declare const ERROR_META_MAX = 65536;
+/**
+ * The host's extra detail for one error (W-68), drawn in the sheet's error card and the error list's open row, after the
+ * message, in a region the host styles as `::part(detail)`. A string is shown as text, never parsed as HTML; a Node is
+ * the host's own and is placed as it is; `null`, `undefined` or `''` shows nothing. It is called again only when the
+ * error changes (its `meta` included) or the hook is replaced. A throw is logged as SP-3017 and shows nothing.
+ *
+ * @example
+ * ```ts
+ * import '@sheetpane/grid';
+ * import type { RenderDetail } from '@sheetpane/grid';
+ * const detail: RenderDetail = (e) => {
+ *   const m = e.meta as { measured?: string; expected?: string } | null | undefined;
+ *   return m?.measured ? `The PDF measures ${m.measured}; the sheet says ${m.expected}.` : null;
+ * };
+ * document.querySelector('sheetpane-excel')!.renderDetail = detail;
+ * document.querySelector('sheetpane-errors')!.renderDetail = detail;
+ * ```
+ */
+export type RenderDetail = (error: SheetpaneError) => Node | string | null | undefined;
+/** A copy of an error the host may change freely: its `meta` is cloned too (W-68). */
+export declare const copyError: (e: SheetpaneError) => SheetpaneError;
 /** Plugins verdict decision 6. */
-export type ChangeKind = 'value' | 'style' | 'numFmt' | 'formula' | 'merge' | 'freeze' | 'hidden' | 'sheetState' | 'outline';
+export type ChangeKind = 'value' | 'style' | 'numFmt' | 'formula' | 'merge' | 'freeze' | 'hidden' | 'sheetState' | 'outline' | 'structure';
 /** Whether Excel shows a sheet: `veryHidden` is hidden from Excel's own Unhide list (W-49). */
 export type { SheetState } from '@sheetpane/export';
-/** One entry of the change map, keyed `sheet!ref` (or `sheet!#freeze`). */
+/** One entry of the change map, keyed `sheet!ref` (or `sheet!#freeze`; `sheet!#structure` holds the sheet's inserts and deletes, in order, W-52). */
 export interface ChangeEntry {
     kind: ChangeKind;
     /** The uploaded value (for `value`: the stored cell; for others: the plugin's own shape). */
     was: unknown;
     now: unknown;
 }
+/**
+ * One change-map entry as the Edits view lists it (W-64, `store.edits()`): the edit's key, its place,
+ * kind, before and after, and when it was made. A kind the view does not know is listed as it is.
+ */
+export interface Edit {
+    /** The change-map key — `Sheet1!B3`, `Sheet1!#style:B3`, `Sheet1!#freeze` — what `revertEdits()` takes. */
+    key: string;
+    sheet: string;
+    /** The cell or range the edit is about (`B3`; `A1:C1` for a merge); `''` for one about the whole sheet (freeze, hidden rows, its state). */
+    ref: string;
+    kind: ChangeKind;
+    /** What the file had (for `value`: the stored cell). */
+    was: unknown;
+    /** What it holds now. */
+    now: unknown;
+    /** When the entry was last written, ISO 8601; undo brings back the entry with its time. */
+    at: string;
+}
+/** What an edit did to the problems on its cells (W-64, `store.editEffects(key)`): error ids, compared with before its cell first changed. */
+export interface EditEffects {
+    /** Workbook, file or rule errors that were open and are now resolved or gone. */
+    cleared: string[];
+    /** Workbook, file or rule errors open now that were not open before. */
+    raised: string[];
+    /** A person's errors whose suggestion the cell now matches (they stay open — SR-GRID decision 5). */
+    matched: string[];
+}
 /** A value a plugin's `derive` hook computed (W-16): never a user change. */
 export interface DerivedCell {
     value: Cell;
@@ -88,7 +242,11 @@ export interface Source {
     bytes: Uint8Array;
     /** Milliseconds the read took. */
     readMs: number;
+    /** The SHA-256 of `bytes`, 64 lowercase hex digits, hashed once on load (W-65); absent where Web Crypto is missing (SP-1009). */
+    sha256?: string;
 }
+/** Whether the pane keeps the file's protection in Edit (W-62): `honour` (the default) or `ignore` (the host's decision). */
+export type ProtectionMode = 'honour' | 'ignore';
 /** The pane's state at one moment: immutable, a new object per change (SR-GRID decision 2). */
 export interface Snapshot {
     readonly load: LoadState;
@@ -98,12 +256,21 @@ export interface Snapshot {
     readonly changes: ReadonlyMap<string, ChangeEntry>;
     /** `sheet!ref` → a value a plugin derived. */
     readonly derived: ReadonlyMap<string, DerivedCell>;
+    /** Every error in the pane, in every layer (W-51). */
     readonly errors: readonly SheetpaneError[];
+    /** The pane's review layers in the order they were first named (W-51): by `setErrors(list, { layer })`, by the `layers` attribute, or by an error. */
+    readonly layers: readonly string[];
+    /** The layers shown (W-51): what the `layers` attribute or the switch chose, else every layer. */
+    readonly visibleLayers: readonly string[];
+    /** The errors in the visible layers — what every surface draws and counts (W-51, SR-LAW-7). The same array as `errors` while every layer is shown. */
+    readonly visibleErrors: readonly SheetpaneError[];
     readonly selection: Selection;
     readonly mode: Mode;
     readonly composing: Composing | null;
     readonly canUndo: boolean;
     readonly canRedo: boolean;
+    /** Whether the file's sheet and workbook protection is kept (W-62, SR-GRID decision 21e); the pane's, never undone. */
+    readonly protection: ProtectionMode;
     /** Bumped on every change of state; elements compare it to skip work. */
     readonly version: number;
 }
@@ -119,6 +286,22 @@ export interface ErrorType {
 export declare const DEFAULT_ERROR_TYPES: readonly ErrorType[];
 /** Names for the types plugins and the core write, shown when the host's `errorTypes` does not name them. */
 export declare const BUILTIN_TYPE_NAMES: Readonly<Record<string, string>>;
+/** Where an error belongs (W-55). */
+export type ErrorScope = 'cell' | 'sheet' | 'workbook';
+/**
+ * Where an error belongs: `workbook` when `sheet` is `""`, `sheet` when `range` is `""`, else `cell`.
+ * A sheet- or workbook-level error has no cell — it is listed above the cell errors, never placed on A1.
+ *
+ * @param e - The error, or just its `sheet` and `range`.
+ * @returns `cell`, `sheet` or `workbook`.
+ * @example
+ * ```ts
+ * import { errorScope } from '@sheetpane/grid';
+ * errorScope({ sheet: 'Pages', range: '' }); // 'sheet'
+ * errorScope({ sheet: '', range: '' }); // 'workbook'
+ * ```
+ */
+export declare const errorScope: (e: Pick<SheetpaneError, 'sheet' | 'range'>) => ErrorScope;
 /** Errors the workbook, the file or a host rule wrote: shown, never resolved or deleted by hand. */
 export declare const machineAuthored: (author: string) => author is "file" | "host" | "workbook";
 /** Each severity's name, glyph and help line — a glyph and a colour, never colour alone. */
@@ -127,4 +310,10 @@ export declare const SEVERITY: Record<Severity, {
     glyph: string;
     help: string;
 }>;
+/** Severity order, worst first: error › warning › note › skipped › pass (W-50 DoD 4). */
+export declare const SEVERITY_ORDER: Record<Severity, number>;
+/** A `pass` or `skipped` entry: a result, never counted where a count asks for action (W-50). */
+export declare const isResult: (e: {
+    severity: Severity;
+}) => boolean;
 //# sourceMappingURL=types.d.ts.map

package/dist/pane/types.d.ts.map

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

package/dist/pane/types.js

@@ -1,3 +1,40 @@
+/** The results levels, in order. */
+export const RESULTS_LEVELS = ['off', 'summary', 'marks'];
+/** The `results` attribute's level: `off` or `marks`, else `summary`. */
+export const resultsLevelOf = (v) => (v === 'off' || v === 'marks' ? v : 'summary');
+/** The layer an error is in when nobody names one (W-51): `"review"` — people's errors and the plugins' land here. */
+export const DEFAULT_LAYER = 'review';
+/**
+ * Whether a value may name a review layer (W-51): a string of 1–64 characters with no whitespace, so the `layers`
+ * attribute can list several separated by spaces.
+ *
+ * @param x - Any value.
+ * @returns True for a usable layer name.
+ * @example
+ * ```ts
+ * import { isLayerName } from '@sheetpane/grid';
+ * isLayerName('pdf'); // true
+ * isLayerName('PDF check'); // false — a space
+ * ```
+ */
+export const isLayerName = (x) => typeof x === 'string' && /^\S{1,64}$/.test(x);
+/**
+ * The layer an error is in (W-51): its `layer`, else {@link DEFAULT_LAYER}.
+ *
+ * @param e - The error, or just its `layer`.
+ * @returns The layer's name.
+ * @example
+ * ```ts
+ * import { layerOf } from '@sheetpane/grid';
+ * layerOf({ layer: 'pdf' }); // 'pdf'
+ * layerOf({}); // 'review'
+ * ```
+ */
+export const layerOf = (e) => e.layer ?? DEFAULT_LAYER;
+/** The most an error's `meta` may weigh, in bytes of its JSON text (UTF-8): 64 KiB. Over it, the meta is dropped with SP-3016 (W-68). */
+export const ERROR_META_MAX = 65536;
+/** A copy of an error the host may change freely: its `meta` is cloned too (W-68). */
+export const copyError = (e) => (e.meta !== null && typeof e.meta === 'object' ? { ...e, meta: structuredClone(e.meta) } : { ...e });
 /** The seven error types and Other that `errorTypes` defaults to (SR-ERRORS decision 6). */
 export const DEFAULT_ERROR_TYPES = [
     { id: 'wrong-value', name: 'Wrong value', severity: 'error', why: 'Fee rate is 10× the account’s tier and above the 2.00% cap — a misplaced decimal.', expected: '0.75%' },
@@ -11,6 +48,20 @@ export const DEFAULT_ERROR_TYPES = [
 ];
 /** Names for the types plugins and the core write, shown when the host's `errorTypes` does not name them. */
 export const BUILTIN_TYPE_NAMES = { validation: 'Workbook rule', comment: 'Comment', 'column-rule': 'Column rule', 'cell-rule': 'Cell rule' };
+/**
+ * Where an error belongs: `workbook` when `sheet` is `""`, `sheet` when `range` is `""`, else `cell`.
+ * A sheet- or workbook-level error has no cell — it is listed above the cell errors, never placed on A1.
+ *
+ * @param e - The error, or just its `sheet` and `range`.
+ * @returns `cell`, `sheet` or `workbook`.
+ * @example
+ * ```ts
+ * import { errorScope } from '@sheetpane/grid';
+ * errorScope({ sheet: 'Pages', range: '' }); // 'sheet'
+ * errorScope({ sheet: '', range: '' }); // 'workbook'
+ * ```
+ */
+export const errorScope = (e) => (e.sheet === '' ? 'workbook' : e.range === '' ? 'sheet' : 'cell');
 /** Errors the workbook, the file or a host rule wrote: shown, never resolved or deleted by hand. */
 export const machineAuthored = (author) => author === 'workbook' || author === 'file' || author === 'host';
 /** Each severity's name, glyph and help line — a glyph and a colour, never colour alone. */
@@ -18,5 +69,11 @@ export const SEVERITY = {
     error: { name: 'Error', glyph: '✕', help: 'Must be fixed before this file is accepted.' },
     warning: { name: 'Warning', glyph: '!', help: 'Needs a second look; may be fine.' },
     note: { name: 'Note', glyph: 'i', help: 'For information — nothing blocks.' },
+    pass: { name: 'Passed', glyph: '✓', help: 'A check ran on this cell and it passed — not a problem.' },
+    skipped: { name: 'Not checked', glyph: '—', help: 'No check ran on this cell; the message says why — not a problem.' },
 };
+/** Severity order, worst first: error › warning › note › skipped › pass (W-50 DoD 4). */
+export const SEVERITY_ORDER = { error: 5, warning: 4, note: 3, skipped: 2, pass: 1 };
+/** A `pass` or `skipped` entry: a result, never counted where a count asks for action (W-50). */
+export const isResult = (e) => e.severity === 'pass' || e.severity === 'skipped';
 //# sourceMappingURL=types.js.map

package/dist/pane/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pane/types.ts"],"names":[],"mappings":"AA4GA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,mBAAmB,GAAyB;IACvD,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,mFAAmF,EAAE,QAAQ,EAAE,OAAO,EAAE;IAC1K,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,8EAA8E,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACnL,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,oEAAoE,EAAE,QAAQ,EAAE,UAAU,EAAE;IAClK,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,8DAA8D,EAAE,QAAQ,EAAE,aAAa,EAAE;IAC7J,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,+DAA+D,EAAE,QAAQ,EAAE,WAAW,EAAE;IAChK,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,kFAAkF,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC3K,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,8EAA8E,EAAE,QAAQ,EAAE,eAAe,EAAE;IAChL,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,sEAAsE,EAAE,QAAQ,EAAE,EAAE,EAAE;CAC/I,CAAC;AAEF,6GAA6G;AAC7G,MAAM,CAAC,MAAM,kBAAkB,GAAqC,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAEhL,oGAAoG;AACpG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,CAAC;AAEnH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,QAAQ,GAAoE;IACvF,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,6CAA6C,EAAE;IACzF,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,mCAAmC,EAAE;IACnF,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,mCAAmC,EAAE;CAC9E,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pane/types.ts"],"names":[],"mappings":"AAsBA,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACnF,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAA4B,EAAgB,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAoD7H,sHAAsH;AACtH,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEtG;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAgC,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,aAAa,CAAC;AAuC9F,yIAAyI;AACzI,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAsBpC,sFAAsF;AACtF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAiB,EAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAmHrK,4FAA4F;AAC5F,MAAM,CAAC,MAAM,mBAAmB,GAAyB;IACvD,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,mFAAmF,EAAE,QAAQ,EAAE,OAAO,EAAE;IAC1K,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,8EAA8E,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACnL,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,oEAAoE,EAAE,QAAQ,EAAE,UAAU,EAAE;IAClK,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,8DAA8D,EAAE,QAAQ,EAAE,aAAa,EAAE;IAC7J,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,+DAA+D,EAAE,QAAQ,EAAE,WAAW,EAAE;IAChK,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,kFAAkF,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC3K,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,8EAA8E,EAAE,QAAQ,EAAE,eAAe,EAAE;IAChL,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,sEAAsE,EAAE,QAAQ,EAAE,EAAE,EAAE;CAC/I,CAAC;AAEF,6GAA6G;AAC7G,MAAM,CAAC,MAAM,kBAAkB,GAAqC,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAKhL;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAA0C,EAAc,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAExJ,oGAAoG;AACpG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,CAAC;AAEnH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,QAAQ,GAAoE;IACvF,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,6CAA6C,EAAE;IACzF,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,mCAAmC,EAAE;IACnF,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,mCAAmC,EAAE;IAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,yDAAyD,EAAE;IACrG,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,kEAAkE,EAAE;CACvH,CAAC;AAEF,yFAAyF;AACzF,MAAM,CAAC,MAAM,cAAc,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAE/G,iGAAiG;AACjG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAyB,EAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC"}