@sheetpane/grid 0.3.0 → 0.4.0

package/dist/plugins/types.d.ts

@@ -1,5 +1,5 @@
-import type { Cell, PatchContext } from '@sheetpane/export';
-import type { ImportedSheet, ImportedWorkbook } from '@sheetpane/import';
+import type { Cell, PatchContext, StructureOpName } from '@sheetpane/export';
+import type { ImportedSheet, ImportedWorkbook, TextRun } from '@sheetpane/import';
 import type { Mode, Selection, SheetpaneError, Snapshot } from '../pane/types.js';
 import type { WorkbookStore } from '../pane/store.js';
 /** The six hooks a plugin may provide (SR-GRID decision 17). */
@@ -26,16 +26,27 @@ export interface CellContext {
     readonly value: Cell;
     /** The cell's style index (`s`), the change map's `style` entry applied by plugins themselves. */
     readonly styleIndex: number | undefined;
+    /** A rich-text cell's runs from the file (W-53) — only while the cell still holds the file's value; absent once it is edited. */
+    readonly runs?: readonly TextRun[];
+}
+/** One styled piece of a rich-text cell (W-53): a run's text and its CSS from {@link STYLE_PROPS}, never `font-family`. */
+export interface RunStyle {
+    text: string;
+    style?: StyleSubset;
 }
 /** What every plugin hook but `format` and `decorate` is given. */
 export interface PluginContext {
     readonly store: WorkbookStore;
     readonly book: ImportedWorkbook;
     snapshot(): Snapshot;
-    /** During `exportPatch`: the options the host passed to `export(options)` (e.g. `{ comments: false }`). */
+    /** During `exportPatch`: the options the host passed to `export(options)` (e.g. `{ comments: false }`, `{ layers: ['pdf'] }` — W-51). */
     readonly exportOptions?: Readonly<Record<string, unknown>>;
 }
-/** What `derive` is told: the workbook loaded, or cells changed (by the user, or by undo). */
+/**
+ * What `derive` is told: the workbook loaded, cells changed (by the user, or by undo), or rows or
+ * columns were inserted or deleted (W-52) — `ctx.book` is then the moved workbook and, as on a
+ * load, the provider returns every derived cell (the store replaces its derived set with them).
+ */
 export type DeriveInput = {
     kind: 'load';
 } | {
@@ -45,6 +56,12 @@ export type DeriveInput = {
         ref: string;
         value: Cell;
     }[];
+} | {
+    kind: 'restructure';
+    sheet: string;
+    op: StructureOpName;
+    at: number;
+    count: number;
 };
 /** One recalculated cell. `clear: true` removes the cell's derived entry (its value and text are then ignored). */
 export interface DerivedChange {
@@ -55,8 +72,8 @@ export interface DerivedChange {
     clear?: boolean;
 }
 /** What `validate` returns: an error without the fields the store owns. */
-/** `key` tells apart a provider's findings that share a sheet, range and type (several notes on one cell); it is not stored on the error. */
-export type ErrorDraft = Omit<SheetpaneError, 'v' | 'id' | 'matchesExpected' | 'createdAt' | 'status' | 'cellChanged'> & {
+/** `key` tells apart a provider's findings that share a sheet, range and type (several notes on one cell); it is not stored on the error. `layer` (W-51) puts the error in that review layer; without it, `review`. */
+export type ErrorDraft = Omit<SheetpaneError, 'v' | 'id' | 'matchesExpected' | 'createdAt' | 'status' | 'cellChanged' | 'acceptedBy' | 'acceptedAt' | 'reason'> & {
     status?: 'open' | 'resolved';
     cellChanged?: boolean;
     key?: string;
@@ -66,6 +83,12 @@ export interface ExportOption {
     key: string;
     label: string;
     default: boolean;
+    /**
+     * Whether the switch has anything to do for this workbook (W-58). When it returns `false` the menu leaves the switch
+     * out; when it returns `true` and the switch is on, Download exports even an untouched workbook instead of handing back
+     * the original bytes. Absent: always shown, and Download decides by changes and errors alone.
+     */
+    applies?(store: WorkbookStore): boolean;
 }
 /** Something drawn in sheet space (pictures, charts). `rect` is in pixels at 100 % zoom from the top-left of A1. */
 export interface OverlayItem {
@@ -146,6 +169,11 @@ export interface Plugin {
     after?: string[];
     format?(cell: CellContext): string | undefined;
     decorate?(cell: CellContext): StyleSubset | undefined;
+    /**
+     * Part of the `decorate` hook (W-53): a rich-text cell (`cell.runs`) drawn as styled spans inside the cell. The
+     * pieces' text joined must be the cell's display text, or the grid draws it plain. Later providers win.
+     */
+    decorateRuns?(cell: CellContext): RunStyle[] | undefined;
     derive?(input: DeriveInput, ctx: PluginContext): DerivedChange[] | Promise<DerivedChange[]>;
     validate?(sheet: string, ctx: PluginContext): ErrorDraft[];
     overlay?(sheet: string, ctx: PluginContext & {

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

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

package/dist/plugins/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AASA,kCAAkC;AAClC,MAAM,CAAC,MAAM,KAAK,GAAwB,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACjH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,eAAe,GAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEzE,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kBAAkB,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa;IAC3J,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc;CACpE,CAAC;AAoEX,kCAAkC;AAClC,MAAM,CAAC,MAAM,KAAK,GAAwB,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AASA,kCAAkC;AAClC,MAAM,CAAC,MAAM,KAAK,GAAwB,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACjH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,eAAe,GAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEzE,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kBAAkB,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa;IAC3J,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc;CACpE,CAAC;AA2FX,kCAAkC;AAClC,MAAM,CAAC,MAAM,KAAK,GAAwB,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/shared/detail.d.ts

@@ -0,0 +1,24 @@
+import { type RenderDetail, type SheetpaneError } from '../pane/types.js';
+/** The region's class; `part="detail"` names it to the host. */
+export declare const DETAIL_CLASS = "xdetail";
+/** Hidden while empty; the host's font and colours, never ours (SR-LAW-5). */
+export declare const DETAIL_CSS = ".xdetail{font:inherit;color:inherit;overflow-wrap:anywhere;min-width:0}.xdetail:empty{display:none}";
+/** One element's detail region: the hook, and what it last drew for the one error shown. */
+export declare class DetailRegion {
+    private fn;
+    private gen;
+    private shown;
+    /** The host's hook; anything but a function turns the region off. */
+    get render(): RenderDetail | undefined;
+    set render(f: RenderDetail | undefined);
+    /** The region's markup, where the element draws it — nothing while no hook is set. */
+    html(): string;
+    /** Puts what the hook returns for `e` into the region under `root`; calls the hook only when `e` or the hook changed. */
+    sync(root: ParentNode | null | undefined, e: SheetpaneError | undefined): void;
+    private make;
+}
+/** Whether an event started inside the host's region — its clicks and keys are the host's, not the element's. */
+export declare const inDetail: (t: EventTarget | null) => boolean;
+/** Who accepted an error, when, and why (W-69) — in the list's open row and the sheet's error card; nothing for any other status. */
+export declare function acceptedHtml(e: SheetpaneError): string;
+//# sourceMappingURL=detail.d.ts.map

package/dist/shared/detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail.d.ts","sourceRoot":"","sources":["../../src/shared/detail.ts"],"names":[],"mappings":"AAMA,OAAO,EAAa,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGrF,gEAAgE;AAChE,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,8EAA8E;AAC9E,eAAO,MAAM,UAAU,wGAAwH,CAAC;AAMhJ,4FAA4F;AAC5F,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAA2B;IACrC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,KAAK,CAAiD;IAE9D,qEAAqE;IACrE,IAAI,MAAM,IAAI,YAAY,GAAG,SAAS,CAAoB;IAC1D,IAAI,MAAM,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,EAA4F;IAElI,sFAAsF;IACtF,IAAI,IAAI,MAAM,CAA+E;IAE7F,yHAAyH;IACzH,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAO7E;IAED,OAAO,CAAC,IAAI;CAYb;AAED,iHAAiH;AACjH,eAAO,MAAM,QAAQ,MAAO,WAAW,GAAG,IAAI,KAAG,OAAiE,CAAC;AAEnH,qIAAqI;AACrI,wBAAgB,YAAY,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAKtD"}

package/dist/shared/detail.js

@@ -0,0 +1,75 @@
+// The host's region in an error's card and list row (W-68): `renderDetail(error)`
+// fills a `part="detail"` box after the message. A string is text, never HTML; a
+// Node is the host's own. The hook runs again only when the error changes or the
+// hook is replaced — a list re-drawn for another error reuses what it returned.
+// Beside it, who accepted an error, when and why (W-69), drawn the same in both.
+import { spMessage } from '@sheetpane/export';
+import { copyError } from '../pane/types.js';
+import { esc } from './dom.js';
+/** The region's class; `part="detail"` names it to the host. */
+export const DETAIL_CLASS = 'xdetail';
+/** Hidden while empty; the host's font and colours, never ours (SR-LAW-5). */
+export const DETAIL_CSS = `.${DETAIL_CLASS}{font:inherit;color:inherit;overflow-wrap:anywhere;min-width:0}.${DETAIL_CLASS}:empty{display:none}`;
+// errors are immutable in a snapshot: one JSON text per object
+const keys = new WeakMap();
+const keyOf = (e) => { let k = keys.get(e); if (k === undefined) {
+    k = JSON.stringify(e);
+    keys.set(e, k);
+} return k; };
+/** One element's detail region: the hook, and what it last drew for the one error shown. */
+export class DetailRegion {
+    fn;
+    gen = 0;
+    shown;
+    /** The host's hook; anything but a function turns the region off. */
+    get render() { return this.fn; }
+    set render(f) { this.fn = typeof f === 'function' ? f : undefined; this.gen++; this.shown = undefined; }
+    /** The region's markup, where the element draws it — nothing while no hook is set. */
+    html() { return this.fn ? `<div class="${DETAIL_CLASS}" part="detail"></div>` : ''; }
+    /** Puts what the hook returns for `e` into the region under `root`; calls the hook only when `e` or the hook changed. */
+    sync(root, e) {
+        const slot = root?.querySelector(`.${DETAIL_CLASS}`);
+        if (!slot || !e || !this.fn) {
+            this.shown = undefined;
+            return;
+        }
+        const key = `${this.gen}|${keyOf(e)}`;
+        if (this.shown?.key !== key)
+            this.shown = { key, node: this.make(e) };
+        const node = this.shown.node;
+        if (node ? slot.childNodes.length !== 1 || slot.firstChild !== node : slot.childNodes.length)
+            slot.replaceChildren(...(node ? [node] : []));
+    }
+    make(e) {
+        let out;
+        try {
+            out = this.fn(copyError(e));
+        }
+        catch (err) {
+            console.error(spMessage('SP-3017', `renderDetail threw for ${e.id}; nothing is shown for it`), err);
+            return null;
+        }
+        if (out === null || out === undefined || out === '')
+            return null;
+        if (typeof out.nodeType !== 'number')
+            return document.createTextNode(String(out)); // a string is text, never HTML
+        const node = out;
+        if (node.nodeType !== 11)
+            return node; // DocumentFragment: its children move on the first insert, so keep them in a box
+        const box = document.createElement('div');
+        box.style.display = 'contents';
+        box.append(node);
+        return box;
+    }
+}
+/** Whether an event started inside the host's region — its clicks and keys are the host's, not the element's. */
+export const inDetail = (t) => !!t?.closest?.(`.${DETAIL_CLASS}`);
+/** Who accepted an error, when, and why (W-69) — in the list's open row and the sheet's error card; nothing for any other status. */
+export function acceptedHtml(e) {
+    if (e.status !== 'accepted')
+        return '';
+    const at = e.acceptedAt ? new Date(e.acceptedAt) : undefined;
+    const when = at && !Number.isNaN(at.getTime()) ? at.toLocaleString(undefined, { day: 'numeric', month: 'short', year: 'numeric', hour: '2-digit', minute: '2-digit' }) : '';
+    return `<div class="acceptance"><span class="xs faint">${esc(['Accepted' + (e.acceptedBy ? ` by ${e.acceptedBy}` : ''), when].filter(Boolean).join(' · '))}</span><span>${esc(e.reason ?? '')}</span></div>`;
+}
+//# sourceMappingURL=detail.js.map

package/dist/shared/detail.js.map

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

package/dist/shared/dom.d.ts

@@ -17,7 +17,10 @@ export declare const ICON: {
     redo: string;
     upload: string;
     freeze: string;
+    chevron: string;
 };
 /** Fires a bubbling, composed `sheetpane-*` event (contract verdict: DOM events only). */
 export declare function fire<T>(el: EventTarget, name: string, detail: T, cancelable?: boolean): boolean;
+/** The `layers` attribute as names (W-51): space-separated; absent or blank is `null`, every layer. */
+export declare const layersAttr: (v: string | null) => string[] | null;
 //# sourceMappingURL=dom.d.ts.map

package/dist/shared/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/shared/dom.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,MAAO,MAAM,WAAgH,CAAC;AAE9I,4GAA4G;AAC5G,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAGzE;AAED,iHAAiH;AACjH,eAAO,MAAM,WAAW,EAAE,OAAO,WAAiG,CAAC;AAGnI,eAAO,MAAM,IAAI;IACf,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,MAAM;CACP,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,UAAQ,GAAG,OAAO,CAE7F"}
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/shared/dom.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,MAAO,MAAM,WAAgH,CAAC;AAE9I,4GAA4G;AAC5G,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAGzE;AAED,iHAAiH;AACjH,eAAO,MAAM,WAAW,EAAE,OAAO,WAAiG,CAAC;AAGnI,eAAO,MAAM,IAAI;IACf,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;CACR,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,UAAQ,GAAG,OAAO,CAE7F;AAED,uGAAuG;AACvG,eAAO,MAAM,UAAU,MAAO,MAAM,GAAG,IAAI,KAAG,MAAM,EAAE,GAAG,IAAyF,CAAC"}

package/dist/shared/dom.js

@@ -24,9 +24,12 @@ export const ICON = {
     redo: svg('<path d="M15 14l5-5-5-5"/><path d="M20 9H9a5 5 0 0 0 0 10h3"/>'),
     upload: svg('<path d="M12 16V4M7 9l5-5 5 5M4 20h16"/>'),
     freeze: svg('<rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M9 3v18"/>'),
+    chevron: svg('<path d="M6 9l6 6 6-6"/>'),
 };
 /** Fires a bubbling, composed `sheetpane-*` event (contract verdict: DOM events only). */
 export function fire(el, name, detail, cancelable = false) {
     return el.dispatchEvent(new CustomEvent(name, { detail, bubbles: true, composed: true, cancelable }));
 }
+/** The `layers` attribute as names (W-51): space-separated; absent or blank is `null`, every layer. */
+export const layersAttr = (v) => { const l = (v ?? '').split(/\s+/).filter(Boolean); return l.length ? l : null; };
 //# sourceMappingURL=dom.js.map

package/dist/shared/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/shared/dom.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;AAE9I,4GAA4G;AAC5G,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAA8B;IACjE,MAAM,GAAG,GAAI,UAAyD,CAAC,cAAc,CAAC;IACtF,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,iHAAiH;AACjH,MAAM,CAAC,MAAM,WAAW,GAAuB,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;CAAQ,CAAuB,CAAC;AAEnI,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,oJAAoJ,CAAC,QAAQ,CAAC;AACzL,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,KAAK,EAAE,GAAG,CAAC,6EAA6E,CAAC;IACzF,IAAI,EAAE,GAAG,CAAC,6FAA6F,CAAC;IACxG,IAAI,EAAE,GAAG,CAAC,0DAA0D,CAAC;IACrE,IAAI,EAAE,GAAG,CAAC,4DAA4D,CAAC;IACvE,QAAQ,EAAE,GAAG,CAAC,2CAA2C,CAAC;IAC1D,KAAK,EAAE,GAAG,CAAC,kCAAkC,CAAC;IAC9C,IAAI,EAAE,GAAG,CAAC,mCAAmC,CAAC;IAC9C,IAAI,EAAE,GAAG,CAAC,4BAA4B,CAAC;IACvC,IAAI,EAAE,GAAG,CAAC,0BAA0B,CAAC;IACrC,IAAI,EAAE,GAAG,CAAC,gEAAgE,CAAC;IAC3E,IAAI,EAAE,GAAG,CAAC,gEAAgE,CAAC;IAC3E,MAAM,EAAE,GAAG,CAAC,0CAA0C,CAAC;IACvD,MAAM,EAAE,GAAG,CAAC,6EAA6E,CAAC;CAC3F,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,IAAI,CAAI,EAAe,EAAE,IAAY,EAAE,MAAS,EAAE,UAAU,GAAG,KAAK;IAClF,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AACxG,CAAC"}
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/shared/dom.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;AAE9I,4GAA4G;AAC5G,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAA8B;IACjE,MAAM,GAAG,GAAI,UAAyD,CAAC,cAAc,CAAC;IACtF,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,iHAAiH;AACjH,MAAM,CAAC,MAAM,WAAW,GAAuB,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;CAAQ,CAAuB,CAAC;AAEnI,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,oJAAoJ,CAAC,QAAQ,CAAC;AACzL,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,KAAK,EAAE,GAAG,CAAC,6EAA6E,CAAC;IACzF,IAAI,EAAE,GAAG,CAAC,6FAA6F,CAAC;IACxG,IAAI,EAAE,GAAG,CAAC,0DAA0D,CAAC;IACrE,IAAI,EAAE,GAAG,CAAC,4DAA4D,CAAC;IACvE,QAAQ,EAAE,GAAG,CAAC,2CAA2C,CAAC;IAC1D,KAAK,EAAE,GAAG,CAAC,kCAAkC,CAAC;IAC9C,IAAI,EAAE,GAAG,CAAC,mCAAmC,CAAC;IAC9C,IAAI,EAAE,GAAG,CAAC,4BAA4B,CAAC;IACvC,IAAI,EAAE,GAAG,CAAC,0BAA0B,CAAC;IACrC,IAAI,EAAE,GAAG,CAAC,gEAAgE,CAAC;IAC3E,IAAI,EAAE,GAAG,CAAC,gEAAgE,CAAC;IAC3E,MAAM,EAAE,GAAG,CAAC,0CAA0C,CAAC;IACvD,MAAM,EAAE,GAAG,CAAC,6EAA6E,CAAC;IAC1F,OAAO,EAAE,GAAG,CAAC,0BAA0B,CAAC;CACzC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,IAAI,CAAI,EAAe,EAAE,IAAY,EAAE,MAAS,EAAE,UAAU,GAAG,KAAK;IAClF,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAgB,EAAmB,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/static.d.ts

@@ -0,0 +1,81 @@
+import type { WorkbookStore } from './pane/store.js';
+import { type ResultSeverity, type SheetpaneError } from './pane/types.js';
+import { type TokenName } from './tokens.js';
+export { loadWorkbook, type CheckOptions } from './check.js';
+export { WorkbookStore, createWorkbook } from './pane/store.js';
+export type { SheetpaneError, Severity } from './pane/types.js';
+export { TOKENS, DARK_TOKENS, type TokenName } from './tokens.js';
+/** The colours a static table is drawn in: the light tokens, or the dark set (SR-GRID decision 15a). Inline hex, so no `auto`. */
+export type StaticTheme = 'light' | 'dark';
+/** What {@link renderStatic} draws. */
+export interface StaticOptions {
+    /** The sheet, by name. Default: the sheet the pane has selected — the file's active sheet after a load. */
+    sheet?: string;
+    /** An A1 range (`B2:F20`, or one cell). Default: the sheet's used range — its data, widened to its merges. */
+    range?: string;
+    /** The errors to mark. Default: those of the pane's visible layers (W-51) — every layer unless the pane shows some only; `[]` marks nothing. Pass `check()`'s result, or a review restored from a server. */
+    errors?: readonly SheetpaneError[];
+    /** `light` (the default) or `dark`. A `decorate` colour (the file's fills and fonts) is drawn as saved in both. */
+    theme?: StaticTheme;
+    /** Column letters and row numbers around the cells, as the grid draws them. Default true. */
+    headers?: boolean;
+}
+/**
+ * What decides a cell's mark: its error's status, then its severity — see {@link STATIC_MARKS}. `accepted` is a
+ * deviation accepted with a reason (W-69); `pass` and `skipped` are results (W-50), drawn only while the pane's
+ * `results` level is `marks`.
+ */
+export type StaticMarkKey = 'error' | 'warning' | 'note' | 'accepted' | 'resolved' | ResultSeverity;
+/**
+ * How one mark is drawn: its glyph and label, the solid token of its ring and badge, the soft token of its tint (none:
+ * no tint), and its rank — the higher wins a cell two errors share. `quiet`: the badge is the surface colour in a ring
+ * of `solid`, its glyph in `ink-2` (an accepted deviation, as the grid draws it). `corner`: a result — no ring, tint
+ * or badge, only its glyph in `solid` before the cell's text.
+ */
+export interface StaticMark {
+    glyph: string;
+    label: string;
+    solid: TokenName;
+    soft?: TokenName;
+    rank: number;
+    quiet?: boolean;
+    corner?: boolean;
+}
+/**
+ * Every mark a static table draws — the grid's `m-*` cell marks and glyphs: a ring in the solid
+ * colour, a tint of the soft one at 60 % over the cell's own fill, and a badge holding the glyph
+ * and the error's number, which the table's footer explains. Never colour alone. A result (`pass`,
+ * `skipped`) is the grid's corner glyph instead, and only where no problem covers the cell.
+ */
+export declare const STATIC_MARKS: Readonly<Record<StaticMarkKey, StaticMark>>;
+/** A static table holds at most this many cells; a larger range throws SP-3028 — pass a smaller `range`. */
+export declare const STATIC_MAX_CELLS = 200000;
+/**
+ * A range of a sheet as one self-contained HTML `<table>` — the text the pane shows (the `format`
+ * plugin), the look it draws (every `decorate` plugin, merges, the tokens as inline hex), hidden
+ * rows and columns left out, and the given errors marked with a ring, a tint and a numbered glyph,
+ * listed in the footer (SR-GRID decision 22g). Made with no DOM, in Node, a worker or a page.
+ *
+ * The output is inert: no `<script>`, no event attribute, no `class`, no `<style>`, no URL — inline
+ * `style` only, every value escaped, no font family (the reader's font is the font, SR-LAW-5).
+ * What a plugin draws over the cells (`overlay`: pictures, charts) is not drawn; the footer says so
+ * and the table's `data-sp-skipped` names those plugins.
+ * @param book - A loaded workbook: `loadWorkbook()`'s, `createWorkbook()`'s after `load()`, or an element's `workbook`. Its plugins format and decorate; its changes and derived values show.
+ * @param options - `sheet`, `range`, `errors`, `theme` and `headers`.
+ * @returns The HTML of one `<table>` element.
+ * @throws SP-3027 when `book` is not a loaded workbook; SP-3028 for an unknown sheet, a range that is not A1, or one over {@link STATIC_MAX_CELLS} cells.
+ * @example
+ * ```ts
+ * import { loadWorkbook, renderStatic } from '@sheetpane/grid/static';
+ * import { numfmt } from '@sheetpane/numfmt';
+ * import { styles } from '@sheetpane/styles';
+ * import { validation } from '@sheetpane/validation/check';
+ *
+ * // `bytes`: the file as your runtime reads it — `await readFile(path)` in Node
+ * const book = await loadWorkbook(bytes, { name: 'q3.xlsx', plugins: [numfmt(), styles(), validation()] });
+ * const html = renderStatic(book, { sheet: 'Holdings', range: 'A1:F12' }); // the workbook's own errors marked
+ * ```
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0105_GRID.md
+ */
+export declare function renderStatic(book: WorkbookStore, options?: StaticOptions): string;
+//# sourceMappingURL=static.d.ts.map

package/dist/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../src/static.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAiH,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE1L,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAElE,kIAAkI;AAClI,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,2GAA2G;IAC3G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8GAA8G;IAC9G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6MAA6M;IAC7M,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,mHAAmH;IACnH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAC;AAEpG;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE;AAEjJ;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAQpE,CAAC;AAQF,4GAA4G;AAC5G,eAAO,MAAM,gBAAgB,SAAU,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CA2IrF"}