@sheetpane/grid 0.1.0 → 0.4.0

package/dist/excel/link.d.ts

@@ -0,0 +1,40 @@
+import { type RangePos } from '@sheetpane/export';
+/** The key of sheetpane's part of a URL fragment: `sheetpane=<pane>:<Sheet>!<ref>`. */
+export declare const LINK_KEY = "sheetpane";
+/** A cell or range to open at: the sheet it names (none: the sheet shown) and its A1 corners. */
+export interface LinkTarget {
+    sheet?: string;
+    range: RangePos;
+}
+/** `Data!B3` → `{ sheet: 'Data', ref: 'B3' }`; `'Q3 data'!B3` is unquoted; `B3` names no sheet. */
+export declare function splitSheetRef(text: string): {
+    sheet?: string;
+    ref: string;
+};
+/**
+ * Reads `B4`, `Data!B4`, `'Q3 data'!B4:D8` — a cell or an A1 range, with or without its sheet.
+ * @param text - The reference as a host or a link writes it.
+ * @returns The target, or `undefined` when the text is not a cell or range (the sheet is checked by the caller).
+ */
+export declare function parseTarget(text: string): LinkTarget | undefined;
+/**
+ * The link for a pane in a URL fragment, as `Sheet!B4` text.
+ * @param hash - `location.hash`, with or without its `#`.
+ * @param pane - The element's `pane` (`''` when it has none).
+ * @returns The reference text (`'Q3 data'!B4` when the sheet needs quoting), or `undefined` when the fragment names nothing for this pane.
+ */
+export declare function readLink(hash: string, pane: string): string | undefined;
+/**
+ * A fragment with this pane's link set (or removed), every other part kept as it was: the link replaces the
+ * pane's old one where it stood; a new one goes after a hash router's path with `?` (`#/reports/12?sheetpane=…`),
+ * after anything else with `&`, or alone.
+ * @param hash - `location.hash`, with or without its `#`.
+ * @param pane - The element's `pane` (`''` when it has none).
+ * @param at - The sheet and the cell or range (`B4`, `B4:D8`) to link to; `undefined` removes the pane's link.
+ * @returns The new fragment, without its `#` (`''`: no fragment).
+ */
+export declare function writeLink(hash: string, pane: string, at: {
+    sheet: string;
+    ref: string;
+} | undefined): string;
+//# sourceMappingURL=link.d.ts.map

package/dist/excel/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/excel/link.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9D,uFAAuF;AACvF,eAAO,MAAM,QAAQ,cAAc,CAAC;AAEpC,iGAAiG;AACjG,MAAM,WAAW,UAAU;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE;AAE/D,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAM3E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAIhE;AAwBD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,MAAM,CAO5G"}

package/dist/excel/link.js

@@ -0,0 +1,90 @@
+// W-66: the cell a page opens at — the `ref` attribute's text and the opt-in `link="hash"` fragment,
+// `#sheetpane=<pane>:<Sheet>!<ref>`. Pure string work, no DOM: the element reads `location.hash` and
+// writes it back with `history.replaceState`. A URL fragment is never sent to a server (SR-LAW-11).
+import { parseRange } from '@sheetpane/export';
+/** The key of sheetpane's part of a URL fragment: `sheetpane=<pane>:<Sheet>!<ref>`. */
+export const LINK_KEY = 'sheetpane';
+/** `Data!B3` → `{ sheet: 'Data', ref: 'B3' }`; `'Q3 data'!B3` is unquoted; `B3` names no sheet. */
+export function splitSheetRef(text) {
+    const i = text.lastIndexOf('!');
+    if (i < 0)
+        return { ref: text.trim() };
+    let sheet = text.slice(0, i).trim();
+    if (sheet.length >= 2 && sheet.startsWith("'") && sheet.endsWith("'"))
+        sheet = sheet.slice(1, -1).replace(/''/g, "'");
+    return { sheet, ref: text.slice(i + 1).trim() };
+}
+/**
+ * Reads `B4`, `Data!B4`, `'Q3 data'!B4:D8` — a cell or an A1 range, with or without its sheet.
+ * @param text - The reference as a host or a link writes it.
+ * @returns The target, or `undefined` when the text is not a cell or range (the sheet is checked by the caller).
+ */
+export function parseTarget(text) {
+    const at = splitSheetRef(text), range = parseRange(at.ref);
+    if (!range || at.sheet === '')
+        return undefined;
+    return at.sheet === undefined ? { range } : { sheet: at.sheet, range };
+}
+// The value is `<pane>:<Sheet>!<ref>`, the pane and sheet percent-encoded with `!` too, so the last literal `!`
+// ends the sheet and the one literal `:` before it ends the pane (a range's own `:` comes after the `!`).
+// No pane: `<Sheet>!<ref>`. No sheet (written by hand; sheetpane always writes it): `<pane>:<ref>`.
+const enc = (s) => encodeURIComponent(s).replace(/!/g, '%21').replace(/'/g, '%27');
+const dec = (s) => { try {
+    return decodeURIComponent(s);
+}
+catch {
+    return s;
+} };
+/** The fragment's parts: a hash router's path (`/reports/12`, `!/x`) and the `&`-separated parameters after it. */
+function partsOf(hash) {
+    const h = hash.startsWith('#') ? hash.slice(1) : hash;
+    if (/^!?\//.test(h)) {
+        const q = h.indexOf('?');
+        return { path: q < 0 ? h : h.slice(0, q), params: q < 0 ? [] : h.slice(q + 1).split('&').filter(Boolean) };
+    }
+    return { path: undefined, params: h.split('&').filter(Boolean) };
+}
+/** A `sheetpane=` parameter's pane (`''` for none), sheet and ref — `undefined` when the parameter is not ours. */
+function valueOf(param) {
+    if (!param.startsWith(`${LINK_KEY}=`))
+        return undefined;
+    const v = param.slice(LINK_KEY.length + 1), j = v.lastIndexOf('!');
+    const head = j < 0 ? v : v.slice(0, j), i = head.indexOf(':');
+    if (j < 0)
+        return i < 0 ? { pane: '', ref: dec(v) } : { pane: dec(v.slice(0, i)), ref: dec(v.slice(i + 1)) };
+    const sheet = dec(i < 0 ? head : head.slice(i + 1));
+    return { pane: i < 0 ? '' : dec(head.slice(0, i)), sheet, ref: dec(v.slice(j + 1)) };
+}
+/**
+ * The link for a pane in a URL fragment, as `Sheet!B4` text.
+ * @param hash - `location.hash`, with or without its `#`.
+ * @param pane - The element's `pane` (`''` when it has none).
+ * @returns The reference text (`'Q3 data'!B4` when the sheet needs quoting), or `undefined` when the fragment names nothing for this pane.
+ */
+export function readLink(hash, pane) {
+    const at = partsOf(hash).params.map(valueOf).find((x) => x?.pane === pane);
+    if (!at)
+        return undefined;
+    if (at.sheet === undefined)
+        return at.ref;
+    return `${/^[\w.]+$/.test(at.sheet) ? at.sheet : `'${at.sheet.replace(/'/g, "''")}'`}!${at.ref}`;
+}
+/**
+ * A fragment with this pane's link set (or removed), every other part kept as it was: the link replaces the
+ * pane's old one where it stood; a new one goes after a hash router's path with `?` (`#/reports/12?sheetpane=…`),
+ * after anything else with `&`, or alone.
+ * @param hash - `location.hash`, with or without its `#`.
+ * @param pane - The element's `pane` (`''` when it has none).
+ * @param at - The sheet and the cell or range (`B4`, `B4:D8`) to link to; `undefined` removes the pane's link.
+ * @returns The new fragment, without its `#` (`''`: no fragment).
+ */
+export function writeLink(hash, pane, at) {
+    const { path, params } = partsOf(hash);
+    const mine = at && `${LINK_KEY}=${pane ? `${enc(pane)}:` : ''}${enc(at.sheet)}!${at.ref}`;
+    const i = params.findIndex((x) => valueOf(x)?.pane === pane);
+    const kept = params.flatMap((x, k) => (valueOf(x)?.pane !== pane ? [x] : k === i && mine ? [mine] : []));
+    if (i < 0 && mine)
+        kept.push(mine);
+    return path === undefined ? kept.join('&') : `${path}${kept.length ? `?${kept.join('&')}` : ''}`;
+}
+//# sourceMappingURL=link.js.map

package/dist/excel/link.js.map

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

package/dist/excel/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/excel/styles.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,QAiCpB,CAAC;AAEF,eAAO,MAAM,SAAS,QAsKrB,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/excel/styles.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,QAmCpB,CAAC;AAEF,eAAO,MAAM,SAAS,QAoMrB,CAAC"}

package/dist/excel/styles.js

@@ -28,20 +28,30 @@ button,input,select,textarea{font:inherit;color:inherit}
 .chip-warn{background:var(--sp-warn-soft);color:var(--sp-warn)}
 .chip-info{background:var(--sp-accent-soft);color:var(--sp-accent-ink)}
 .chip-pass{background:var(--sp-pass-soft);color:var(--sp-pass)}
+.chip-skip{background:var(--sp-sunken);color:var(--sp-ink-2)}
 .input{height:28px;border:1px solid var(--sp-line-strong);border-radius:var(--sp-r);padding:0 8px;background:var(--sp-surface);min-width:0;font-size:13px}
 .input:focus{outline:2px solid var(--sp-accent);outline-offset:-1px;border-color:var(--sp-accent)}
 textarea.input{height:auto;min-height:56px;padding:6px 8px;resize:vertical;width:100%;line-height:1.45}
 .num{font-variant-numeric:tabular-nums}
 .xs{font-size:12px}.faint{color:var(--sp-ink-3)}.muted{color:var(--sp-ink-2)}
 .g{display:inline-flex;align-items:center;justify-content:center;width:16px;height:16px;border-radius:var(--sp-r-sm);font-size:10px;font-weight:700;color:var(--sp-on-solid);flex:none}
-.g-error{background:var(--sp-fail)}.g-warning{background:var(--sp-warn)}.g-note{background:var(--sp-accent)}.g-pass{background:var(--sp-pass)}
+.g-error{background:var(--sp-fail)}.g-warning{background:var(--sp-warn)}.g-note{background:var(--sp-accent)}.g-pass{background:var(--sp-pass)}.g-accepted{background:var(--sp-surface);color:var(--sp-ink-2);box-shadow:inset 0 0 0 1.5px var(--sp-ink-3)}
+.acceptance{display:flex;flex-direction:column;gap:2px;font-size:13px;margin:0;overflow-wrap:anywhere}
 `;
 export const EXCEL_CSS = `${BASE_CSS}
 .sp{display:flex;flex-direction:column;height:100%;min-height:320px;background:var(--sp-surface);border:1px solid var(--sp-line);border-radius:var(--sp-r-lg);overflow:hidden}
 :host([display=popup]) .sp{border:0;border-radius:var(--sp-r-xl)}
 dialog{padding:0;border:0;border-radius:var(--sp-r-xl);width:min(1240px,calc(100vw - 48px));height:min(760px,calc(100vh - 48px));max-width:none;max-height:none;box-shadow:var(--sp-shadow-lg);background:var(--sp-surface);color:inherit;font:inherit}
 dialog::backdrop{background:rgba(22,23,26,.42)}
-.bar{display:flex;align-items:center;gap:6px;padding:8px 10px;border-bottom:1px solid var(--sp-line);flex-wrap:wrap}
+.sp{container:sp/inline-size}
+/* one toolbar row (design: Sheetpane board); as the element narrows it sheds, in order, the changes label (the Download badge keeps the count), find's width, the counts (the errors panel and tab counts keep them) and the file meta (kept in the name's tooltip); only below 860 px may it wrap */
+.bar{display:flex;align-items:center;gap:6px;padding:8px 10px;border-bottom:1px solid var(--sp-line);flex-wrap:nowrap;white-space:nowrap}
+@container sp (max-width: 1240px){.bar .changes{display:none}}
+@container sp (max-width: 1140px){.find input{width:84px}}
+@container sp (max-width: 1040px){.bar .counts{display:none}}
+@container sp (max-width: 960px){.bar .meta{display:none}}
+@container sp (max-width: 860px){.bar{flex-wrap:wrap}}
+.dlmore svg{width:12px;height:12px}
 .bar .ico{width:18px;height:18px;color:var(--sp-ink-3);flex:none}
 .fname{font-weight:600;font-size:13px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:200px;min-width:40px;flex:0 1 auto}
 .counts{display:inline-flex;gap:4px}
@@ -51,6 +61,7 @@ dialog::backdrop{background:rgba(22,23,26,.42)}
 .find input{padding-left:28px;width:112px}
 .zoom{width:70px;padding:0 2px}
 .find .cnt{font-size:11px;color:var(--sp-ink-3);margin-left:6px;min-width:44px}
+.find .cnt:empty{display:none}
 .input.cell[aria-invalid]{outline:2px solid var(--sp-fail);outline-offset:-1px}
 .ptext{display:inline-flex;align-items:center;height:24px;padding:0 8px;border:1px dashed var(--sp-line-strong);border-radius:var(--sp-r-sm);color:var(--sp-ink-2);font-size:12px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:40ch;font-variant-numeric:tabular-nums}
 .fx{display:flex;align-items:center;gap:8px;padding:6px 10px;border-bottom:1px solid var(--sp-line);min-height:41px;font-size:13px;flex-wrap:wrap}
@@ -58,13 +69,24 @@ dialog::backdrop{background:rgba(22,23,26,.42)}
 .fx .val{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .fx input.cell{flex:1;max-width:460px;border-color:var(--sp-accent)}
 .tag{font-size:10px;font-weight:600;letter-spacing:.06em;text-transform:uppercase;color:var(--sp-ink-3);border:1px solid var(--sp-line-strong);border-radius:4px;padding:3px 5px}
-.frow{display:flex;align-items:center;gap:4px;padding:4px 10px;border-bottom:1px solid var(--sp-line);flex-wrap:wrap;background:var(--sp-ground)}
+.frow{display:flex;align-items:center;gap:4px;padding:4px 10px;border-bottom:1px solid var(--sp-line);flex-wrap:nowrap;background:var(--sp-ground);position:relative;z-index:6}
+/* one row: groups that do not fit move into More ▾ from the right (W-14); Number format and Text never move */
+.fgrp{display:inline-flex;align-items:center;gap:4px;flex:none}
+.fmore{position:relative;display:inline-flex;margin-left:auto;flex:none}
+.fmore[hidden]{display:none}
+.fmore-btn svg{width:12px;height:12px}
+.fmenu{position:absolute;top:calc(100% + 4px);right:0;z-index:9;display:flex;flex-direction:column;gap:6px;padding:8px;min-width:200px}
+.fmenu[hidden]{display:none}
+.fmenu .fgrp{flex-wrap:wrap}
+.fmenu .fgrp+.fgrp{border-top:1px solid var(--sp-line);padding-top:6px}
+.fmenu .sep{display:none}
 .frow .sep{width:1px;height:20px;background:var(--sp-line-strong);margin:0 4px}
 .frow button[aria-pressed=true]{background:var(--sp-accent-soft);border-color:var(--sp-accent)}
 .body{flex:1;min-height:0;display:flex;position:relative}
 .scroller{flex:1;min-width:0;overflow:auto;position:relative;background:var(--sp-cell)}
 .grid{outline:none}
-.scroller:has(.grid:focus-visible){box-shadow:inset 0 0 0 2px var(--sp-accent)}
+/* the grid's focus ring: keyboard only (a click's focus is shown by the active cell), drawn over the cells, not under them */
+.sp[data-kbd] .body:has(.grid:focus)::after{content:"";position:absolute;inset:0;box-shadow:inset 0 0 0 2px var(--sp-accent);pointer-events:none;z-index:8}
 .sheet{position:relative}
 .hrow{position:sticky;top:0;z-index:5;display:flex;background:var(--sp-head)}
 .row{position:absolute;left:0;display:flex}
@@ -111,14 +133,21 @@ dialog::backdrop{background:rgba(22,23,26,.42)}
 .c.m-warning{box-shadow:inset 0 0 0 1.5px var(--sp-warn)}.c.m-warning::before{background:var(--sp-warn-soft)}
 .c.m-note{box-shadow:inset 0 0 0 1.5px var(--sp-accent)}.c.m-note::before{background:var(--sp-accent-soft)}
 .c.m-pass{box-shadow:inset 0 0 0 1.5px var(--sp-pass)}
+.c.m-accepted{box-shadow:inset 0 0 0 1.5px var(--sp-ink-3)}
+.c>.rmk{position:absolute;left:3px;bottom:2px;z-index:2;font-size:.69em;font-weight:700;line-height:1;pointer-events:none}
+.rmk.pass{color:var(--sp-pass)}.rmk.skipped{color:var(--sp-skip)}
 .c.stale>.v{color:var(--sp-ink-3);font-style:italic}
 .c.stale>.v::before{content:"≈ ";color:var(--sp-warn);font-style:normal}
 .c.derived>.v{color:var(--sp-accent-ink)}
 .c .mk{position:absolute;z-index:2;right:2px;top:50%;transform:translateY(-50%);border:0;background:transparent;padding:0 2px;cursor:pointer;color:var(--sp-ink-3)}
 .overlay{position:absolute;inset:0;pointer-events:none;z-index:4}
 .overlay>*{pointer-events:auto}
+.overlay>.hl,.hlbox{pointer-events:none}
+.hlbox{position:absolute;box-sizing:border-box;border:2px solid var(--sp-accent);border-radius:var(--sp-r-sm);box-shadow:0 0 0 2px var(--sp-accent-soft)}
+.hlbox.pass{border-color:var(--sp-pass);box-shadow:0 0 0 2px var(--sp-pass-soft)}
+.hlbox.fail{border-color:var(--sp-fail);box-shadow:0 0 0 2px var(--sp-fail-soft)}
 .pin{position:absolute;min-width:18px;height:18px;padding:0 4px;border-radius:9px;border:0;font-size:10px;font-weight:700;line-height:18px;color:var(--sp-on-solid);text-align:center;box-shadow:0 0 0 2px var(--sp-cell),0 1px 4px rgba(22,23,26,.3);cursor:pointer;font-variant-numeric:tabular-nums}
-.pin.error{background:var(--sp-fail)}.pin.warning{background:var(--sp-warn)}.pin.note{background:var(--sp-accent)}.pin.resolved{background:var(--sp-pass)}
+.pin.error{background:var(--sp-fail)}.pin.warning{background:var(--sp-warn)}.pin.note{background:var(--sp-accent)}.pin.resolved{background:var(--sp-pass)}.pin.accepted{background:var(--sp-surface);color:var(--sp-ink-2);box-shadow:0 0 0 2px var(--sp-cell),inset 0 0 0 1.5px var(--sp-ink-3)}
 .pin.on{box-shadow:0 0 0 2px var(--sp-cell),0 0 0 4px var(--sp-ink)}
 .pin.square{border-radius:3px;min-width:16px;height:16px;line-height:16px;padding:0 2px}
 .pin.pending{background:var(--sp-cell);color:var(--sp-accent);box-shadow:0 0 0 1.5px var(--sp-accent)}
@@ -138,6 +167,9 @@ dialog::backdrop{background:rgba(22,23,26,.42)}
 /* plugin buttons stay in the bar while it is wide, and fold into ⋯ before Flag issue moves */
 .moremenu .fold{display:none}
 @container (max-width: 720px){.dock .plug{display:none}.moremenu .fold{display:flex}}
+/* …and also whenever they would squeeze the value field below 200 px (measured: fitDock) */
+.fx.folded .dock .plug{display:none}
+.fx.folded .moremenu .fold{display:flex}
 .warn-t{color:var(--sp-warn)}
 .export .badge-n{min-width:18px;height:18px;padding:0 5px;border-radius:9px;background:var(--sp-sunken);color:var(--sp-ink);font-size:11px;font-weight:700;line-height:18px;text-align:center}
 .split{position:relative;display:inline-flex}

package/dist/excel/styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../src/excel/styles.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,uEAAuE;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCpC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsKnC,CAAC"}
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../src/excel/styles.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,uEAAuE;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCpC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoMnC,CAAC"}

package/dist/frameworks/elements.d.ts

@@ -3,34 +3,38 @@ import type { ChangeKind, Mode, SheetpaneError, SheetpaneErrors, SheetpaneExcel,
 
 /** The events `<sheetpane-excel>` dispatches, by name; each bubbles and is composed. */
 export interface SheetpaneExcelEventMap {
-  /** `{ status: 'ready', name, kind, sheets, readMs }` when a file is read, or the refusal `{ status: 'error', code, spCode, message, name, detail? }`. */
-  'sheetpane-load': CustomEvent<{ status: 'ready'; name: string; kind: 'xlsx' | 'csv'; sheets: string[]; readMs: number } | { status: 'error'; code: string; spCode: SpCode; message: string; name: string; detail?: string }>;
-  /** `{ sheet, ref, kind, was, now }` for each change, undo and redo included. */
-  'sheetpane-change': CustomEvent<{ sheet: string; ref: string; kind: ChangeKind; was: unknown; now: unknown }>;
-  /** `{ errors, plugins }` when the pane's errors change. */
-  'sheetpane-errors': CustomEvent<{ errors: SheetpaneError[]; plugins: string[] }>;
+  /** `{ status: 'ready', name, kind, sheets, readMs, sha256 }` when a file is read (`sha256`: the file's SHA-256, W-65), or the refusal `{ status: 'error', code, spCode, message, name, detail? }`. */
+  'sheetpane-load': CustomEvent<{ status: 'ready'; name: string; kind: 'xlsx' | 'csv'; sheets: string[]; readMs: number; sha256: string | undefined } | { status: 'error'; code: string; spCode: SpCode; message: string; name: string; detail?: string }>;
+  /** `{ sheet, ref, kind, was, now, op?, at?, count? }` for each change, undo and redo included; rows or columns inserted or deleted (W-52) are one event, `kind: 'structure'`, with `op`, `at` (0-based) and `count`. */
+  'sheetpane-change': CustomEvent<{ sheet: string; ref: string; kind: ChangeKind; was: unknown; now: unknown; op?: 'insertRows' | 'deleteRows' | 'insertCols' | 'deleteCols'; at?: number; count?: number }>;
+  /** `{ v, errors, plugins, layers, changed }` when the pane's errors change — the envelope to save a review (`v: 2`, W-51); `changed` names the layers whose errors changed. */
+  'sheetpane-errors': CustomEvent<{ v: 2; errors: SheetpaneError[]; plugins: string[]; layers: string[]; changed: string[] }>;
+  /** `{ visible, layers }` when the visible review layers change (W-51). */
+  'sheetpane-layers': CustomEvent<{ visible: string[]; layers: string[] }>;
   /** `{ sheet, ref, range, column, value }` when the selection settles — `range` (`B3:D8`) when more than one cell is selected; a drag fires once, on release. */
   'sheetpane-select': CustomEvent<{ sheet: string; ref: string; range: string | undefined; column: { index: number; letter: string; header: string }; value: unknown }>;
   /** `{ sheet, axis, indexes, hidden, via }` when rows, columns or a sheet are hidden, unhidden or shown for viewing (`via: 'reveal'`) (W-49). */
   'sheetpane-visibility': CustomEvent<{ sheet: string; axis: 'row' | 'col' | 'sheet'; indexes: number[]; hidden: boolean; via: 'menu' | 'key' | 'marker' | 'reveal' }>;
   /** `{ sheet, axis, indexes, px, via }` when a column width or row height is set by a drag, a fit, the header menu or a reset — on release, never during a drag (W-47). */
   'sheetpane-resize': CustomEvent<{ sheet: string; axis: 'col' | 'row'; indexes: number[]; px: number | number[]; via: 'drag' | 'fit' | 'menu' | 'reset' }>;
+  /** `{ sheet, ref, column }` when a mouse or pen pointer moves onto another cell (a merge's top-left), at most once per frame, or `null` when it leaves the cells; never for a finger (W-56). */
+  'sheetpane-hover': CustomEvent<{ sheet: string; ref: string; column: { index: number; letter: string; header: string } } | null>;
   /** `{ sheet }` when the selection moves to another sheet. */
   'sheetpane-sheet': CustomEvent<{ sheet: string }>;
   /** `{ mode }` when the pane switches between View and Edit. */
   'sheetpane-mode': CustomEvent<{ mode: Mode }>;
   /** `{ reason, canUndo, canRedo }` on undo, redo, or the stack cleared by `setErrors()`. */
   'sheetpane-history': CustomEvent<{ reason: 'undo' | 'redo' | 'cleared'; canUndo: boolean; canRedo: boolean }>;
-  /** `{ sheet, ref, column, value }` before a cell edit starts; cancellable — the cell stays read-only. */
-  'sheetpane-editstart': CustomEvent<{ sheet: string; ref: string; column: { index: number; letter: string; header: string }; value: unknown }>;
+  /** `{ sheet, ref, column, value, richText?: true }` before a cell edit starts (`richText: true` on a rich-text cell, whose edit saves plain text — W-53); cancellable — the cell stays read-only. */
+  'sheetpane-editstart': CustomEvent<{ sheet: string; ref: string; column: { index: number; letter: string; header: string }; value: unknown; richText?: true }>;
   /** `{ sheet, ref, column, draft, was }` as the cell-bar draft is typed. */
   'sheetpane-input': CustomEvent<{ sheet: string; ref: string; column: { index: number; letter: string; header: string }; draft: string; was: unknown }>;
   /** `{ sheet, ref, column, was, now }` before a value is stored; cancellable — the value is refused. */
   'sheetpane-beforechange': CustomEvent<{ sheet: string; ref: string; column: { index: number; letter: string; header: string }; was: unknown; now: unknown }>;
-  /** `{ sheet, ref }` when Esc restores a draft, or `{ sheet, ref, reason: 'blocked', code: 'SP-6003', message }` when a `block` rule refuses it. */
-  'sheetpane-editcancel': CustomEvent<{ sheet: string; ref: string } | { sheet: string; ref: string; reason: 'blocked'; code: 'SP-6003'; message: string }>;
-  /** `{ blob, kind, name, guarded, format, converted, original? }` on `export()` and Download; cancellable — the Download control then saves nothing. */
-  'sheetpane-export': CustomEvent<{ blob: Blob; kind: 'xlsx' | 'csv'; name: string; guarded: string[] | false; format: 'xlsx' | 'csv'; converted: boolean; original?: boolean }>;
+  /** `{ sheet, ref }` when Esc restores a draft, `{ sheet, ref, reason: 'blocked', code: 'SP-6003', message }` when a `block` rule refuses it, or `{ sheet, ref, reason: 'locked', code: 'SP-3026', message }` when the cell is locked on a protected sheet (W-62). */
+  'sheetpane-editcancel': CustomEvent<{ sheet: string; ref: string } | { sheet: string; ref: string; reason: 'blocked'; code: 'SP-6003'; message: string } | { sheet: string; ref: string; reason: 'locked'; code: 'SP-3026'; message: string }>;
+  /** `{ blob, kind, name, guarded, format, converted, sha256, original? }` on `export()` and Download (`sha256`: the blob's SHA-256, W-65); cancellable — the Download control then saves nothing. */
+  'sheetpane-export': CustomEvent<{ blob: Blob; kind: 'xlsx' | 'csv'; name: string; guarded: string[] | false; format: 'xlsx' | 'csv'; converted: boolean; sha256: string | undefined; original?: boolean }>;
   /** `{}` when the pop-up closes. */
   'sheetpane-close': CustomEvent<Record<string, never>>;
 }
@@ -61,6 +65,16 @@ export interface SheetpaneExcelAttributes {
   'rules-src'?: string | undefined;
   /** `on` (the default) or `off`: no Flag issue anywhere. */
   flagging?: 'on' | 'off' | undefined;
+  /** The cell or range selected once a file is read, scrolled into view: `B4`, `Data!B4`, `'Q3 data'!B4:D8`; setting it later selects it then. One that names no cell is warned (SP-3019) and the sheet opens at A1. React, Vue and Solid keep `ref` for their own refs — set it with `setAttribute`. */
+  ref?: string | undefined;
+  /** `none` (the default) or `hash`: the selection is kept in the URL fragment as `#sheetpane=<pane>:<Sheet>!<ref>`, read when a file is read and on back and forward, and *Copy link* joins the cell menu. The rest of the fragment is the host's and is kept as it was. */
+  link?: 'none' | 'hash' | undefined;
+  /** `summary` (the default), `marks` or `off`: how `pass` and `skipped` results show, pane-wide (W-50). */
+  results?: 'summary' | 'marks' | 'off' | undefined;
+  /** Space-separated review layers to show (W-51); none shows every layer. Shared by the pane's elements. */
+  layers?: string | undefined;
+  /** `honour` (the default) or `ignore`: whether a protected sheet's locked cells refuse edits and a protected structure keeps its sheets, pane-wide (W-62). `ignore` is the host's decision; the file is unchanged. */
+  protection?: 'honour' | 'ignore' | undefined;
 }
 
 /** The properties a framework may set on `<sheetpane-excel>`, typed as the element declares them. */
@@ -71,8 +85,12 @@ export interface SheetpaneExcelProperties {
   errors?: SheetpaneExcel['errors'] | undefined;
   /** The types offered in the Flag issue form; an empty list falls back to `DEFAULT_ERROR_TYPES`. */
   errorTypes?: SheetpaneExcel['errorTypes'] | undefined;
+  /** The host's extra detail for an error (W-68): called with a copy of the error when its card opens in the sheet, and drawn after the message in a `part="detail"` region. A string is text, never HTML; a Node is the host's own. Called again only when the error changes (its `meta` included) or this is replaced; a throw is logged as SP-3017. Set it on each element that should show it — `<sheetpane-errors>` has its own. */
+  renderDetail?: SheetpaneExcel['renderDetail'] | undefined;
   /** Loads a file, like `load()`; `null` does nothing. */
   file?: SheetpaneExcel['file'] | undefined;
+  /** The review layers shown (W-51) — the pane's, shared with `<sheetpane-errors>`: every layer until the `layers` attribute or the switch names some. Setting it sets the attribute; `null` or `[]` shows every layer. */
+  layers?: SheetpaneExcel['layers'] | undefined;
   /** The pane's mode, `view` or `edit`; setting it sets the `mode` attribute. */
   mode?: SheetpaneExcel['mode'] | undefined;
   /** `light` (the default), `dark`, or `auto` (follows `prefers-color-scheme`) — colour only; the file's own colours never change (W-29). */
@@ -81,6 +99,10 @@ export interface SheetpaneExcelProperties {
   rules?: SheetpaneExcel['rules'] | undefined;
   /** `flagging="off"`: no Flag issue anywhere, no composer, no callout card — the errors panel is the one place errors are read. */
   flagging?: SheetpaneExcel['flagging'] | undefined;
+  /** The pane's results level (W-50): `summary` (the default), `marks` or `off`; setting it sets the `results` attribute. */
+  results?: SheetpaneExcel['results'] | undefined;
+  /** The pane's protection mode (W-62): `honour` (the default) keeps the file's protection; `ignore` is the host's decision. Setting it sets the `protection` attribute. */
+  protection?: SheetpaneExcel['protection'] | undefined;
   /** Rules by column title, as plain JSON (`required`, `type`, `min`, `max`, `minLength`, `maxLength`, `pattern`, `oneOf`, `unique`, `message`, `severity`, `onInvalid`). */
   columns?: SheetpaneExcel['columns'] | undefined;
   /** `validate(ctx, signal)`, sync or async: `null`, or `{ severity, message, expected? }`. */
@@ -91,19 +113,25 @@ export interface SheetpaneExcelProperties {
   sizes?: SheetpaneExcel['sizes'] | undefined;
   /** The `src` attribute; `null`, `undefined` or `''` removes it. */
   src?: SheetpaneExcel['src'] | undefined;
+  /** The `ref` attribute: the cell or range selected once a file is read (W-66); `null`, `undefined` or `''` removes it. */
+  ref?: SheetpaneExcel['ref'] | undefined;
+  /** `none` (the default) or `hash`: the selection kept in the URL fragment, and *Copy link* in the cell menu (W-66). */
+  link?: SheetpaneExcel['link'] | undefined;
 }
 
 /** The events `<sheetpane-errors>` dispatches, by name; each bubbles and is composed. */
 export interface SheetpaneErrorsEventMap {
-  /** `{ errors, plugins }` when the pane's errors change — the envelope to save a review. */
-  'sheetpane-errors': CustomEvent<{ errors: SheetpaneError[]; plugins: string[] }>;
+  /** `{ v, errors, plugins, layers, changed }` when the pane's errors change — the envelope to save a review (`v: 2`, W-51); `changed` names the layers whose errors changed. */
+  'sheetpane-errors': CustomEvent<{ v: 2; errors: SheetpaneError[]; plugins: string[]; layers: string[]; changed: string[] }>;
+  /** `{ visible, layers }` when the visible review layers change — the switch or the `layers` attribute (W-51). */
+  'sheetpane-layers': CustomEvent<{ visible: string[]; layers: string[] }>;
   /** `{ sheet, ref, kind, was, now }` when a cell changes from here ("Also change the cell", undo, redo). */
   'sheetpane-change': CustomEvent<{ sheet: string; ref: string; kind: ChangeKind; was: unknown; now: unknown }>;
   /** `{ sheet, ref }` when picking a row selects its cell. */
   'sheetpane-select': CustomEvent<{ sheet: string; ref: string }>;
   /** `{ reason, canUndo, canRedo }` on undo, redo, or the stack cleared by `setErrors()`. */
   'sheetpane-history': CustomEvent<{ reason: 'undo' | 'redo' | 'cleared'; canUndo: boolean; canRedo: boolean }>;
-  /** `{ error }` on Show in sheet, so the host can switch tab or open the pop-up. */
+  /** `{ error }` on Show in sheet, so the host can switch tab or open the pop-up — for a whole-sheet error too (its tab is opened); never for a workbook-level one (W-55); for a result group's Show ▸, its first entry (W-50). */
   'sheetpane-reveal': CustomEvent<{ error: SheetpaneError }>;
 }
 
@@ -111,14 +139,18 @@ export interface SheetpaneErrorsEventMap {
 export interface SheetpaneErrorsAttributes {
   /** The pane id shared with the sheet; none gives the element its own store. */
   pane?: string | undefined;
-  /** Hides the form, Resolve, Delete, Undo and Redo (a sign-off screen). */
+  /** Hides the form, Resolve, Accept…, Delete, Undo and Redo (a sign-off screen). */
   readonly?: boolean | undefined;
-  /** Written into the errors this element's user adds. */
+  /** Written into the errors this element's user adds, and as who accepted one (W-69). */
   author?: string | undefined;
   /** Space-separated registered plugin ids; fixed per pane. */
   plugins?: string | undefined;
   /** `light` (the default), `dark` or `auto`. */
   theme?: 'light' | 'dark' | 'auto' | undefined;
+  /** `summary` (the default), `marks` or `off`: how `pass` and `skipped` results show, pane-wide (W-50). */
+  results?: 'summary' | 'marks' | 'off' | undefined;
+  /** Space-separated review layers to show (W-51); none shows every layer. Shared by the pane's elements; with two or more layers the header shows a switch. */
+  layers?: string | undefined;
 }
 
 /** The properties a framework may set on `<sheetpane-errors>`, typed as the element declares them. */
@@ -133,4 +165,12 @@ export interface SheetpaneErrorsProperties {
   readOnly?: SheetpaneErrors['readOnly'] | undefined;
   /** `light` (the default), `dark` or `auto` — the same tokens as the sheet (W-29). */
   theme?: SheetpaneErrors['theme'] | undefined;
+  /** The host's extra detail for an error (W-68): called with a copy of the error when its row is opened, and drawn after the message in a `part="detail"` region. A string is text, never HTML; a Node is the host's own. Called again only when the error changes (its `meta` included) or this is replaced; a throw is logged as SP-3017. Set it on each element that should show it — the sheet's error card has its own. */
+  renderDetail?: SheetpaneErrors['renderDetail'] | undefined;
+  /** The pane's results level (W-50): `summary` (the default), `marks` or `off`; setting it sets the `results` attribute. */
+  results?: SheetpaneErrors['results'] | undefined;
+  /** The review layers shown (W-51) — the pane's, shared with `<sheetpane-excel>`: every layer until the `layers` attribute or the switch names some. Setting it sets the attribute; `null` or `[]` shows every layer. */
+  layers?: SheetpaneErrors['layers'] | undefined;
+  /** What the switch and the rows call each layer (W-51), e.g. `{ pdf: 'PDF check' }`; a layer not named here shows its name (`review` as *Review*). */
+  layerNames?: SheetpaneErrors['layerNames'] | undefined;
 }

package/dist/frameworks/jsx.d.ts

@@ -7,34 +7,38 @@ import type { SheetpaneErrorsAttributes, SheetpaneErrorsEventMap, SheetpaneError
 export type { SheetpaneErrorsAttributes, SheetpaneErrorsEventMap, SheetpaneErrorsProperties, SheetpaneExcelAttributes, SheetpaneExcelEventMap, SheetpaneExcelProperties } from './elements.js';
 
 /** `<sheetpane-excel>` in React 19 JSX: attributes, properties and `onsheetpane-…` event props (React 19 sets properties and listens to custom events). */
-export type SheetpaneExcelReactProps = SheetpaneExcelAttributes & SheetpaneExcelProperties & {
-  /** `{ status: 'ready', name, kind, sheets, readMs }` when a file is read, or the refusal `{ status: 'error', code, spCode, message, name, detail? }`. */
+export type SheetpaneExcelReactProps = Omit<SheetpaneExcelAttributes, 'ref'> & Omit<SheetpaneExcelProperties, 'ref'> & {
+  /** `{ status: 'ready', name, kind, sheets, readMs, sha256 }` when a file is read (`sha256`: the file's SHA-256, W-65), or the refusal `{ status: 'error', code, spCode, message, name, detail? }`. */
   'onsheetpane-load'?: ((event: SheetpaneExcelEventMap['sheetpane-load']) => void) | undefined;
-  /** `{ sheet, ref, kind, was, now }` for each change, undo and redo included. */
+  /** `{ sheet, ref, kind, was, now, op?, at?, count? }` for each change, undo and redo included; rows or columns inserted or deleted (W-52) are one event, `kind: 'structure'`, with `op`, `at` (0-based) and `count`. */
   'onsheetpane-change'?: ((event: SheetpaneExcelEventMap['sheetpane-change']) => void) | undefined;
-  /** `{ errors, plugins }` when the pane's errors change. */
+  /** `{ v, errors, plugins, layers, changed }` when the pane's errors change — the envelope to save a review (`v: 2`, W-51); `changed` names the layers whose errors changed. */
   'onsheetpane-errors'?: ((event: SheetpaneExcelEventMap['sheetpane-errors']) => void) | undefined;
+  /** `{ visible, layers }` when the visible review layers change (W-51). */
+  'onsheetpane-layers'?: ((event: SheetpaneExcelEventMap['sheetpane-layers']) => void) | undefined;
   /** `{ sheet, ref, range, column, value }` when the selection settles — `range` (`B3:D8`) when more than one cell is selected; a drag fires once, on release. */
   'onsheetpane-select'?: ((event: SheetpaneExcelEventMap['sheetpane-select']) => void) | undefined;
   /** `{ sheet, axis, indexes, hidden, via }` when rows, columns or a sheet are hidden, unhidden or shown for viewing (`via: 'reveal'`) (W-49). */
   'onsheetpane-visibility'?: ((event: SheetpaneExcelEventMap['sheetpane-visibility']) => void) | undefined;
   /** `{ sheet, axis, indexes, px, via }` when a column width or row height is set by a drag, a fit, the header menu or a reset — on release, never during a drag (W-47). */
   'onsheetpane-resize'?: ((event: SheetpaneExcelEventMap['sheetpane-resize']) => void) | undefined;
+  /** `{ sheet, ref, column }` when a mouse or pen pointer moves onto another cell (a merge's top-left), at most once per frame, or `null` when it leaves the cells; never for a finger (W-56). */
+  'onsheetpane-hover'?: ((event: SheetpaneExcelEventMap['sheetpane-hover']) => void) | undefined;
   /** `{ sheet }` when the selection moves to another sheet. */
   'onsheetpane-sheet'?: ((event: SheetpaneExcelEventMap['sheetpane-sheet']) => void) | undefined;
   /** `{ mode }` when the pane switches between View and Edit. */
   'onsheetpane-mode'?: ((event: SheetpaneExcelEventMap['sheetpane-mode']) => void) | undefined;
   /** `{ reason, canUndo, canRedo }` on undo, redo, or the stack cleared by `setErrors()`. */
   'onsheetpane-history'?: ((event: SheetpaneExcelEventMap['sheetpane-history']) => void) | undefined;
-  /** `{ sheet, ref, column, value }` before a cell edit starts; cancellable — the cell stays read-only. */
+  /** `{ sheet, ref, column, value, richText?: true }` before a cell edit starts (`richText: true` on a rich-text cell, whose edit saves plain text — W-53); cancellable — the cell stays read-only. */
   'onsheetpane-editstart'?: ((event: SheetpaneExcelEventMap['sheetpane-editstart']) => void) | undefined;
   /** `{ sheet, ref, column, draft, was }` as the cell-bar draft is typed. */
   'onsheetpane-input'?: ((event: SheetpaneExcelEventMap['sheetpane-input']) => void) | undefined;
   /** `{ sheet, ref, column, was, now }` before a value is stored; cancellable — the value is refused. */
   'onsheetpane-beforechange'?: ((event: SheetpaneExcelEventMap['sheetpane-beforechange']) => void) | undefined;
-  /** `{ sheet, ref }` when Esc restores a draft, or `{ sheet, ref, reason: 'blocked', code: 'SP-6003', message }` when a `block` rule refuses it. */
+  /** `{ sheet, ref }` when Esc restores a draft, `{ sheet, ref, reason: 'blocked', code: 'SP-6003', message }` when a `block` rule refuses it, or `{ sheet, ref, reason: 'locked', code: 'SP-3026', message }` when the cell is locked on a protected sheet (W-62). */
   'onsheetpane-editcancel'?: ((event: SheetpaneExcelEventMap['sheetpane-editcancel']) => void) | undefined;
-  /** `{ blob, kind, name, guarded, format, converted, original? }` on `export()` and Download; cancellable — the Download control then saves nothing. */
+  /** `{ blob, kind, name, guarded, format, converted, sha256, original? }` on `export()` and Download (`sha256`: the blob's SHA-256, W-65); cancellable — the Download control then saves nothing. */
   'onsheetpane-export'?: ((event: SheetpaneExcelEventMap['sheetpane-export']) => void) | undefined;
   /** `{}` when the pop-up closes. */
   'onsheetpane-close'?: ((event: SheetpaneExcelEventMap['sheetpane-close']) => void) | undefined;
@@ -42,15 +46,17 @@ export type SheetpaneExcelReactProps = SheetpaneExcelAttributes & SheetpaneExcel
 
 /** `<sheetpane-errors>` in React 19 JSX: attributes, properties and `onsheetpane-…` event props (React 19 sets properties and listens to custom events). */
 export type SheetpaneErrorsReactProps = SheetpaneErrorsAttributes & SheetpaneErrorsProperties & {
-  /** `{ errors, plugins }` when the pane's errors change — the envelope to save a review. */
+  /** `{ v, errors, plugins, layers, changed }` when the pane's errors change — the envelope to save a review (`v: 2`, W-51); `changed` names the layers whose errors changed. */
   'onsheetpane-errors'?: ((event: SheetpaneErrorsEventMap['sheetpane-errors']) => void) | undefined;
+  /** `{ visible, layers }` when the visible review layers change — the switch or the `layers` attribute (W-51). */
+  'onsheetpane-layers'?: ((event: SheetpaneErrorsEventMap['sheetpane-layers']) => void) | undefined;
   /** `{ sheet, ref, kind, was, now }` when a cell changes from here ("Also change the cell", undo, redo). */
   'onsheetpane-change'?: ((event: SheetpaneErrorsEventMap['sheetpane-change']) => void) | undefined;
   /** `{ sheet, ref }` when picking a row selects its cell. */
   'onsheetpane-select'?: ((event: SheetpaneErrorsEventMap['sheetpane-select']) => void) | undefined;
   /** `{ reason, canUndo, canRedo }` on undo, redo, or the stack cleared by `setErrors()`. */
   'onsheetpane-history'?: ((event: SheetpaneErrorsEventMap['sheetpane-history']) => void) | undefined;
-  /** `{ error }` on Show in sheet, so the host can switch tab or open the pop-up. */
+  /** `{ error }` on Show in sheet, so the host can switch tab or open the pop-up — for a whole-sheet error too (its tab is opened); never for a workbook-level one (W-55); for a result group's Show ▸, its first entry (W-50). */
   'onsheetpane-reveal'?: ((event: SheetpaneErrorsEventMap['sheetpane-reveal']) => void) | undefined;
 };