@sheetpane/grid 0.3.0 → 0.4.0

package/dist/check.js

@@ -0,0 +1,151 @@
+// @sheetpane/grid/check — the checks the pane runs on load, with no page (W-54): the rules
+// file, the column rules and every plugin's `validate`, over the same store the elements share,
+// giving the same SheetpaneError[]. One engine, two entry points: this one never imports an
+// element, registers nothing and touches no DOM, so it runs in Node, in a worker and in a page
+// (SR-GRID decision 22f).
+import { parseRange, spError } from '@sheetpane/export';
+import { pluginsFromIds } from './plugins/host.js';
+import { createWorkbook } from './pane/store.js';
+// what a DOM-free host or plugin needs, from the modules the elements use (the same instances)
+export { WorkbookStore, createWorkbook, parseInput, key as cellKey, splitKey, kindRef, baseRef, SLOTTED_KINDS, HISTORY_CAP } from './pane/store.js';
+export { checkDocument, describeRule, RULE_TYPE, CELL_RULE_TYPE } from './pane/rules.js';
+export { BUILTIN_TYPE_NAMES, DEFAULT_ERROR_TYPES, SEVERITY, machineAuthored } from './pane/types.js';
+export { registerPlugin, registeredPluginIds, pluginsFromIds, checkPlugins } from './plugins/host.js';
+export { HOOKS, SLOTS, SINGLE_PROVIDER, STYLE_PROPS } from './plugins/types.js';
+export { shiftFormula } from '@sheetpane/export';
+export { CODES, ERRORS_DOC_URL, codeUrl, spMessage, spError, codeOf, detailOf } from '@sheetpane/export';
+/**
+ * The errors a pane holds once a file has loaded and its checks have finished — the rules file, the
+ * column rules (including an async `validate`, awaited) and every plugin's `validate`, after a
+ * `derive` plugin has recalculated — computed with no page (SR-GRID decision 22f). Same file, same
+ * options → the same errors as `<sheetpane-excel>` in a browser; only `id` and `createdAt` are per
+ * run. Sorted by sheet (workbook order), row, column, then type and message.
+ * @param file - The `.xlsx` or `.csv` bytes.
+ * @param options - The pane's settings: `rules`, `columns`, `validate`, `onInvalid`, `headerRow`, `plugins`, and the file's `name`.
+ * @returns The errors, SheetpaneError v1.
+ * @throws SP-3020 when `file` is not bytes; the reader's own code (SP-10xx) when the file cannot be read.
+ * @example
+ * ```ts
+ * import { check } from '@sheetpane/grid/check';
+ * import { validation } from '@sheetpane/validation/check';
+ *
+ * // `bytes`: the file as your runtime reads it — `await readFile(path)` in Node
+ * const found = await check(bytes, {
+ *   name: 'q3.xlsx',
+ *   rules: { version: 1, sheets: { '*': { columns: { Units: { type: 'integer', min: 0 } } } } },
+ *   plugins: [validation()],
+ * });
+ * const blocking = found.filter((e) => e.severity === 'error');
+ * ```
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0105_GRID.md
+ */
+export async function check(file, options = {}) {
+    return sorted(await loadWorkbook(file, options));
+}
+/**
+ * The workbook {@link check} reads, returned instead of its errors: a {@link WorkbookStore} holding
+ * the file, every `derive` landed and every check finished — what a DOM-free host hands to
+ * `renderStatic` (`@sheetpane/grid/static`, W-67), or reads with `getErrors()`, `text()` and `value()`.
+ * @param file - The `.xlsx` or `.csv` bytes.
+ * @param options - The same options as {@link check}.
+ * @returns The loaded store; its errors are `check()`'s, unsorted.
+ * @throws SP-3020 when `file` is not bytes; the reader's own code (SP-10xx) when the file cannot be read.
+ * @example
+ * ```ts
+ * import { loadWorkbook } from '@sheetpane/grid/check';
+ * import { numfmt } from '@sheetpane/numfmt';
+ *
+ * const book = await loadWorkbook(bytes, { name: 'q3.xlsx', plugins: [numfmt()] });
+ * book.text('Holdings', 'C4'); // "1,250.00" — as the pane shows it
+ * ```
+ */
+export async function loadWorkbook(file, options = {}) {
+    const isBlob = typeof Blob !== 'undefined' && file instanceof Blob;
+    if (!(file instanceof Uint8Array || file instanceof ArrayBuffer || isBlob)) {
+        throw spError('SP-3020', `check() and loadWorkbook() take the file's bytes — a Uint8Array, an ArrayBuffer or a Blob, not ${file === null ? 'null' : typeof file}`, TypeError);
+    }
+    const deriving = new Set();
+    const plugins = (options.plugins ?? []).flatMap((p) => (typeof p === 'string' ? pluginsFromIds([p]) : [p])).map((p) => tracked(p, deriving));
+    const store = createWorkbook({ plugins });
+    const rules = rulesConfig(options);
+    if (rules)
+        store.setColumnRules(rules); // before the file, as an element given rules binds them first
+    await store.load(file, options.name ?? (await nameOf(file)));
+    const load = store.getSnapshot().load;
+    if (load.status === 'error')
+        throw spError(load.spCode, load.message);
+    await settled(store, deriving);
+    return store;
+}
+/** The element's `applyRules()`, from options: undefined when none is given (a pane with no rules has none). */
+function rulesConfig(o) {
+    if (o.rules === undefined && o.columns === undefined && o.validate === undefined)
+        return undefined;
+    const c = { columns: o.columns ?? {}, validate: o.validate, onInvalid: o.onInvalid ?? 'flag', headerRow: Math.max(1, Number(o.headerRow ?? 1) || 1) };
+    if (o.rules !== undefined)
+        c.document = documentOf(o.rules);
+    return c;
+}
+/** A rules file given as text is parsed; text that is not JSON becomes the SP-6011 note, as a failed `rules-src` read does. */
+function documentOf(rules) {
+    if (typeof rules !== 'string')
+        return rules;
+    try {
+        return JSON.parse(rules);
+    }
+    catch (e) {
+        return { __error: `not JSON — ${e.message}` };
+    }
+}
+/** Unnamed bytes are named as `<sheetpane-excel>.load()` names them: a ZIP is `.xlsx`, anything else `.csv`. */
+async function nameOf(file) {
+    const head = file instanceof Uint8Array ? file.subarray(0, 2) : file instanceof ArrayBuffer ? new Uint8Array(file, 0, Math.min(2, file.byteLength)) : new Uint8Array(await file.slice(0, 2).arrayBuffer());
+    return head[0] === 0x50 && head[1] === 0x4b ? 'workbook.xlsx' : 'data.csv';
+}
+/**
+ * The plugin with its `derive` watched, so {@link check} knows when recalculation is done; the
+ * plugin itself is the prototype — its id, hooks and anything else it offers (`evaluate()`) unchanged.
+ */
+function tracked(p, deriving) {
+    if (typeof p?.derive !== 'function')
+        return p;
+    const w = Object.create(p);
+    w.derive = (input, ctx) => {
+        const out = p.derive.call(w, input, ctx);
+        const done = Promise.resolve(out).then(() => undefined, () => undefined); // a failure is the store's to log (SP-3012)
+        deriving.add(done);
+        void done.then(() => deriving.delete(done));
+        return out;
+    };
+    return w;
+}
+/** A turn of the event loop: the store's own continuations after a `derive` or a load-phase slice have run. */
+const turn = () => new Promise((r) => setTimeout(r, 0));
+/** Resolves once the rules' load phase is idle (`ruleProgress` undefined) — it reports every step through the store. */
+function rulesIdle(store) {
+    if (store.ruleProgress === undefined)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const off = store.subscribe(() => { if (store.ruleProgress === undefined) {
+            off();
+            resolve();
+        } });
+    });
+}
+/** Waits until nothing is left to run: every `derive` landed and the rules' load phase finished, then once more. */
+async function settled(store, deriving) {
+    for (;;) {
+        await Promise.all([...deriving]);
+        await rulesIdle(store);
+        await turn();
+        if (!deriving.size && store.ruleProgress === undefined)
+            return;
+    }
+}
+/** The store's errors in a fixed order: sheet (workbook order), row, column, type, message. */
+function sorted(store) {
+    const order = new Map((store.book?.sheets ?? []).map((s, i) => [s.name, i]));
+    const at = (e) => { const r = parseRange(e.range); return [order.get(e.sheet) ?? order.size, r?.top ?? -1, r?.left ?? -1]; };
+    return store.getErrors().map((e) => ({ e, k: at(e) })).sort((a, b) => a.k[0] - b.k[0] || a.k[1] - b.k[1] || a.k[2] - b.k[2] || (a.e.type < b.e.type ? -1 : a.e.type > b.e.type ? 1 : 0) || (a.e.message < b.e.message ? -1 : a.e.message > b.e.message ? 1 : 0)).map((x) => x.e);
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/errors/element.d.ts

@@ -1,6 +1,6 @@
 import type { Theme } from '../tokens.js';
 import { type WorkbookStore } from '../pane/store.js';
-import { type ErrorType, type SheetpaneError, type Severity } from '../pane/types.js';
+import { type ErrorType, type ErrorsEnvelope, type RenderDetail, type ResultsLevel, type SheetpaneError, type Severity } from '../pane/types.js';
 import { ElementBase } from '../shared/dom.js';
 declare const sevOrder: Record<Severity, number>;
 /**
@@ -10,25 +10,33 @@ declare const sevOrder: Record<Severity, number>;
  *
  * Attributes:
  * - `pane` — the pane id shared with the sheet; none gives the element its own store.
- * - `readonly` — hides the form, Resolve, Delete, Undo and Redo (a sign-off screen).
- * - `author` — written into the errors this element's user adds.
+ * - `readonly` — hides the form, Resolve, Accept…, Delete, Undo and Redo (a sign-off screen).
+ * - `author` — written into the errors this element's user adds, and as who accepted one (W-69).
  * - `plugins` — space-separated registered plugin ids; fixed per pane.
  * - `theme` — `light` (the default), `dark` or `auto`.
+ * - `results` — `summary` (the default), `marks` or `off`: how `pass` and `skipped` results show, pane-wide (W-50).
+ * - `layers` — 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.
  *
- * Properties: `workbook`, `errors`, `errorTypes`, `readOnly`, `theme`.
+ * Properties: `workbook`, `errors`, `errorTypes`, `readOnly`, `theme`, `results`, `renderDetail`, `layers`, `layerNames`.
  *
- * Methods: `getErrors()`, `setErrors(list, { plugins? })`, `renderNow()`.
+ * Methods: `getErrors({ layer? })`, `setErrors(list | envelope, { plugins?, layer? })`, `renderNow()`.
  *
  * Every event bubbles and is composed; an action's event fires once, on the element where it
  * happened.
  *
- * @fires sheetpane-errors `{ errors, plugins }` when the pane's errors change — the envelope to save a review.
+ * @fires sheetpane-errors `{ 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.
+ * @fires sheetpane-layers `{ visible, layers }` when the visible review layers change — the switch or the `layers` attribute (W-51).
  * @fires sheetpane-change `{ sheet, ref, kind, was, now }` when a cell changes from here ("Also change the cell", undo, redo).
  * @fires sheetpane-select `{ sheet, ref }` when picking a row selects its cell.
  * @fires sheetpane-history `{ reason, canUndo, canRedo }` on undo, redo, or the stack cleared by `setErrors()`.
- * @fires sheetpane-reveal `{ error }` on Show in sheet, so the host can switch tab or open the pop-up.
+ * @fires sheetpane-reveal `{ 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).
+ *
+ * Views (W-50, W-64): *Problems* (the default); *✓ Passed* and *— Not checked* while the pane holds results; *Edits n* —
+ * every change in the pane, newest first, each with its place, kind, was → now, time, the errors it cleared or raised,
+ * and its own Revert — in Edit mode, and in View mode while there are edits.
  *
  * @csspart root - The panel's frame: the header, the form, the filters and the list.
+ * @csspart detail - The host's region in an open row, after the message: what `renderDetail` returns (W-68).
  *
  * @example
  * ```ts
@@ -39,7 +47,9 @@ declare const sevOrder: Record<Severity, number>;
  * document.body.append(list);
  * list.addEventListener('sheetpane-errors', (e) => localStorage.setItem('review', JSON.stringify((e as CustomEvent).detail)));
  * const saved = JSON.parse(localStorage.getItem('review') ?? 'null');
- * if (saved) list.setErrors(saved.errors, { plugins: saved.plugins });
+ * if (saved) list.setErrors(saved); // the envelope: every layer, and the plugins notice
+ * list.setErrors(pdfFindings, { layer: 'pdf' }); // one layer replaced; the others kept
+ * list.layerNames = { pdf: 'PDF check' };
  * ```
  * @see https://github.com/arpitarya/sheetpane/blob/main/records/0106_ERRORS.md
  * @see https://github.com/arpitarya/sheetpane/blob/main/packages/grid/README.md#sheetpane-errors
@@ -60,6 +70,23 @@ export declare class SheetpaneErrors extends ElementBase {
     private draft;
     private formKey;
     private savedPlugins;
+    private detailRegion;
+    /** W-69: the Accepted chip is on (only accepted errors listed); the error whose Accept form is open, and its reason so far. */
+    private showAccepted;
+    /** W-51: the switch's button to focus after a re-draw (`''` is All). */
+    private focusLayer;
+    private accepting;
+    private reasonDraft;
+    private focusNext;
+    private _layerNames;
+    private view;
+    private openGroups;
+    private groupEntries;
+    /** A control to focus again once the list is redrawn (a group toggled). */
+    private refocus;
+    /** W-64: how many edits the Edits view draws; the Edits chip to focus once the last row is reverted. */
+    private editsLimit;
+    private focusEditsChip;
     /** The pane's store; assigning one replaces the `pane` lookup. */
     get workbook(): WorkbookStore | undefined;
     set workbook(s: WorkbookStore | undefined);
@@ -75,12 +102,42 @@ export declare class SheetpaneErrors extends ElementBase {
     /** `light` (the default), `dark` or `auto` — the same tokens as the sheet (W-29). */
     get theme(): Theme;
     set theme(t: Theme);
-    /** A copy of the pane's errors, to save a review. */
-    getErrors(): SheetpaneError[];
-    /** Restores a saved review. `plugins` (from the saved `sheetpane-errors` envelope) shows a notice when it differs from this pane's set. */
-    setErrors(list: SheetpaneError[], o?: {
+    /**
+     * 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.
+     */
+    get renderDetail(): RenderDetail | undefined;
+    set renderDetail(f: RenderDetail | undefined);
+    /** The pane's results level (W-50): `summary` (the default), `marks` or `off`; setting it sets the `results` attribute. */
+    get results(): ResultsLevel;
+    set results(v: ResultsLevel);
+    /**
+     * 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.
+     */
+    get layers(): string[];
+    set layers(v: readonly string[] | null);
+    /** 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*). */
+    get layerNames(): Readonly<Record<string, string>>;
+    set layerNames(m: Readonly<Record<string, string>>);
+    /** A copy of the pane's errors, to save a review; `{ layer }` gives one layer's (W-51). */
+    getErrors(o?: {
+        layer?: string;
+    }): SheetpaneError[];
+    /**
+     * Restores a saved review — a list, or the `sheetpane-errors` envelope with its layers — or, with `layer`, replaces that
+     * layer only (W-51). `plugins` (from the saved envelope; read from it when it is passed whole) shows a notice when it
+     * differs from this pane's set.
+     */
+    setErrors(list: SheetpaneError[] | ErrorsEnvelope, o?: {
         plugins?: string[];
+        layer?: string;
     }): void;
+    private layerName;
+    /** The `layers` attribute, given to the store (connect, a new store). */
+    private applyLayers;
     /** Builds the shadow root once and binds to the pane's store. */
     connectedCallback(): void;
     /** Releases the pane's store. */
@@ -97,9 +154,30 @@ export declare class SheetpaneErrors extends ElementBase {
     private onClick;
     private onInput;
     private onKey;
+    /** Selects an error's cell; a sheet-level error opens its tab (W-55), keeping the selection when it is already there; a workbook-level one has no place. */
+    private showPlace;
+    /** Selects an edit's cell or range (W-64); an edit about a whole sheet opens its tab, keeping the selection when it is already there. */
+    private showEdit;
+    /** Reverts one edit (W-64) — itself one undo step. Focus moves to the next row's Revert, else the previous one's, else the Edits chip. */
+    private revertEdit;
+    /** Closes the reason form; focus goes back to Accept…. */
+    private closeAccept;
+    /** Accepts the error whose form is open (W-69): only with a reason; who is this element's `author`. The row moves under the Accepted chip, which takes focus. */
+    private acceptNow;
     private add;
+    /** Show ▸ (W-50): selects the group's range on its first sheet and marks that range's results, even at `summary`. */
+    private showGroup;
     private authorKind;
     private render;
+    /** The Passed or Not checked view (W-50): one row per check (passes, by type + message) or reason (not checked, by message). */
+    private groupsHtml;
+    /**
+     * The Edits view (W-64): one row per change-map entry, newest first — its place and kind, was → now, the time, and the
+     * errors it cleared or raised (each a link to the error in Problems); Revert per row in Edit mode. A page at a time.
+     */
+    private editsHtml;
+    /** Draws the cell rows an opened group's box shows, and a few either side — never all of them (W-50, virtualised). */
+    private fillCells;
     private formHtml;
 }
 /** The column's header text: the nearest row above with two or more text cells. */

package/dist/errors/element.d.ts.map

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