ng-hub-ui-spreadsheet 22.0.0

package/fesm2022/ng-hub-ui-spreadsheet-signals.mjs

@@ -0,0 +1,281 @@
+import * as i0 from '@angular/core';
+import { model, input, booleanAttribute, output, computed, ChangeDetectionStrategy, Component } from '@angular/core';
+import { HubSpreadsheetComponent } from 'ng-hub-ui-spreadsheet';
+
+/**
+ * A sheet that is a form control: its value is the rows.
+ *
+ * Bind it with the `FormField` directive and the rows become the field's value, written back on
+ * every edit, paste and clearing. Because the contract is Angular's own
+ * {@link FormValueControl}, the same component also works inside reactive and template-driven
+ * forms — Angular's migration guide says as much, and forbids implementing the old
+ * `ControlValueAccessor` alongside it.
+ *
+ * **What this shape cannot do, and why it is not the only one.** A control bound to a collection
+ * receives that field's own errors and never its descendants'. A rule declared with `applyEach`
+ * on the rows therefore produces errors this component will not see, and per-cell validation is
+ * the whole point of an editable sheet. When you need it, keep `<hub-spreadsheet>` bound to your
+ * own rows and feed its `errors` input — `spreadsheetFieldErrors()` maps a field tree onto the
+ * map it expects.
+ */
+class HubSpreadsheetFieldComponent {
+    /** The rows, as the field's value. Written back whenever the reader changes a cell. */
+    value = model([], /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** What each column shows and allows. */
+    columns = input.required(/* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "columns" }] : /* istanbul ignore next */ []));
+    /** A stable name per row. */
+    rowKey = input.required(/* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "rowKey" }] : /* istanbul ignore next */ []));
+    /** The save state of each cell. */
+    states = input({}, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "states" }] : /* istanbul ignore next */ []));
+    /** The character this reader types decimals with. */
+    decimalMark = input(',', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "decimalMark" }] : /* istanbul ignore next */ []));
+    /** What an empty sheet says. */
+    emptyText = input('', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "emptyText" }] : /* istanbul ignore next */ []));
+    /** How many rows Page Up and Page Down travel. */
+    pageSize = input(10, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "pageSize" }] : /* istanbul ignore next */ []));
+    /** Turns off every editor, whatever the cells say. */
+    readonly = input(false, { ...(ngDevMode ? { debugName: "readonly" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
+    /** How many columns stay pinned to the leading edge. */
+    frozenColumns = input(0, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "frozenColumns" }] : /* istanbul ignore next */ []));
+    /** How many rows stay pinned below the header. */
+    frozenRows = input(0, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "frozenRows" }] : /* istanbul ignore next */ []));
+    /** Merged blocks. */
+    spans = input([], /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "spans" }] : /* istanbul ignore next */ []));
+    /**
+     * Bound by the `FormField` directive. Only the array field's own errors arrive here, which is
+     * why they are shown as a whole rather than attributed to a cell.
+     */
+    errors = input([], /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "errors" }] : /* istanbul ignore next */ []));
+    /** Bound by the `FormField` directive; disables every editor. */
+    disabled = input(false, { ...(ngDevMode ? { debugName: "disabled" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
+    /** The selected rectangle changed. */
+    selectionChange = output();
+    /**
+     * The sheet's own per-cell error map.
+     *
+     * Empty here on purpose: this shape has no per-cell errors to give. It exists so the inner
+     * component's input is always bound to something, and so a future release can fill it without
+     * changing the template.
+     */
+    cellErrors = computed(() => ({}), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "cellErrors" }] : /* istanbul ignore next */ []));
+    onCommit(change) {
+        this.write(change.coords.row, change.column.key, change.value);
+    }
+    onPaste(paste) {
+        if (!paste.cells.length) {
+            return;
+        }
+        // One update for the whole block rather than one per cell: a paste is a single change as
+        // far as the field is concerned, and writing it cell by cell would fire the form's
+        // validation hundreds of times for one gesture.
+        this.value.update((rows) => {
+            const next = [...rows];
+            for (const change of paste.cells) {
+                next[change.coords.row] = { ...next[change.coords.row], [change.column.key]: change.value };
+            }
+            return next;
+        });
+    }
+    onCleared(cells) {
+        this.value.update((rows) => {
+            const next = [...rows];
+            for (const ref of cells) {
+                next[ref.coords.row] = { ...next[ref.coords.row], [ref.column.key]: null };
+            }
+            return next;
+        });
+    }
+    write(row, key, value) {
+        this.value.update((rows) => rows.map((candidate, index) => (index === row ? { ...candidate, [key]: value } : candidate)));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: HubSpreadsheetFieldComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.0.8", type: HubSpreadsheetFieldComponent, isStandalone: true, selector: "hub-spreadsheet-field", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, columns: { classPropertyName: "columns", publicName: "columns", isSignal: true, isRequired: true, transformFunction: null }, rowKey: { classPropertyName: "rowKey", publicName: "rowKey", isSignal: true, isRequired: true, transformFunction: null }, states: { classPropertyName: "states", publicName: "states", isSignal: true, isRequired: false, transformFunction: null }, decimalMark: { classPropertyName: "decimalMark", publicName: "decimalMark", isSignal: true, isRequired: false, transformFunction: null }, emptyText: { classPropertyName: "emptyText", publicName: "emptyText", isSignal: true, isRequired: false, transformFunction: null }, pageSize: { classPropertyName: "pageSize", publicName: "pageSize", isSignal: true, isRequired: false, transformFunction: null }, readonly: { classPropertyName: "readonly", publicName: "readonly", isSignal: true, isRequired: false, transformFunction: null }, frozenColumns: { classPropertyName: "frozenColumns", publicName: "frozenColumns", isSignal: true, isRequired: false, transformFunction: null }, frozenRows: { classPropertyName: "frozenRows", publicName: "frozenRows", isSignal: true, isRequired: false, transformFunction: null }, spans: { classPropertyName: "spans", publicName: "spans", isSignal: true, isRequired: false, transformFunction: null }, errors: { classPropertyName: "errors", publicName: "errors", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { value: "valueChange", selectionChange: "selectionChange" }, ngImport: i0, template: `
+		<hub-spreadsheet
+			[rows]="value()"
+			[columns]="columns()"
+			[rowKey]="rowKey()"
+			[states]="states()"
+			[errors]="cellErrors()"
+			[decimalMark]="decimalMark()"
+			[emptyText]="emptyText()"
+			[pageSize]="pageSize()"
+			[readonly]="readonly() || disabled()"
+			[frozenColumns]="frozenColumns()"
+			[frozenRows]="frozenRows()"
+			[spans]="spans()"
+			(commit)="onCommit($event)"
+			(pasted)="onPaste($event)"
+			(cleared)="onCleared($event)"
+			(selectionChange)="selectionChange.emit($event)"
+		/>
+	`, isInline: true, dependencies: [{ kind: "component", type: HubSpreadsheetComponent, selector: "hub-spreadsheet", inputs: ["rows", "columns", "rowKey", "states", "errors", "decimalMark", "emptyText", "pageSize", "readonly", "frozenColumns", "frozenRows", "spans", "structure", "retiredColumnKeys", "fillHandle", "canUndo", "canRedo", "resizableColumns", "reorderableColumns", "columnWidths", "minColumnWidth", "contextMenu", "mergeable", "formulas", "virtual", "rowHeight", "editOn"], outputs: ["columnWidthsChange", "commit", "pasted", "cleared", "selectionChange", "insertRequested", "deleteRequested", "filled", "undoRequested", "redoRequested", "columnMoved", "mergeRequested", "unmergeRequested"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: HubSpreadsheetFieldComponent, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'hub-spreadsheet-field',
+                    standalone: true,
+                    imports: [HubSpreadsheetComponent],
+                    changeDetection: ChangeDetectionStrategy.OnPush,
+                    template: `
+		<hub-spreadsheet
+			[rows]="value()"
+			[columns]="columns()"
+			[rowKey]="rowKey()"
+			[states]="states()"
+			[errors]="cellErrors()"
+			[decimalMark]="decimalMark()"
+			[emptyText]="emptyText()"
+			[pageSize]="pageSize()"
+			[readonly]="readonly() || disabled()"
+			[frozenColumns]="frozenColumns()"
+			[frozenRows]="frozenRows()"
+			[spans]="spans()"
+			(commit)="onCommit($event)"
+			(pasted)="onPaste($event)"
+			(cleared)="onCleared($event)"
+			(selectionChange)="selectionChange.emit($event)"
+		/>
+	`
+                }]
+        }], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], columns: [{ type: i0.Input, args: [{ isSignal: true, alias: "columns", required: true }] }], rowKey: [{ type: i0.Input, args: [{ isSignal: true, alias: "rowKey", required: true }] }], states: [{ type: i0.Input, args: [{ isSignal: true, alias: "states", required: false }] }], decimalMark: [{ type: i0.Input, args: [{ isSignal: true, alias: "decimalMark", required: false }] }], emptyText: [{ type: i0.Input, args: [{ isSignal: true, alias: "emptyText", required: false }] }], pageSize: [{ type: i0.Input, args: [{ isSignal: true, alias: "pageSize", required: false }] }], readonly: [{ type: i0.Input, args: [{ isSignal: true, alias: "readonly", required: false }] }], frozenColumns: [{ type: i0.Input, args: [{ isSignal: true, alias: "frozenColumns", required: false }] }], frozenRows: [{ type: i0.Input, args: [{ isSignal: true, alias: "frozenRows", required: false }] }], spans: [{ type: i0.Input, args: [{ isSignal: true, alias: "spans", required: false }] }], errors: [{ type: i0.Input, args: [{ isSignal: true, alias: "errors", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], selectionChange: [{ type: i0.Output, args: ["selectionChange"] }] } });
+
+/**
+ * Turns a field tree over rows into the per-cell error map `<hub-spreadsheet>` reads.
+ *
+ * This is the piece that makes per-cell validation work, and it exists because of a limit in the
+ * framework rather than a preference: a control bound to a collection is handed that field's own
+ * errors and never its descendants'. Rules declared with `applyEach` therefore land on the row
+ * fields, one level below anything the sheet could see for itself.
+ *
+ * So the host keeps the field tree, and this walks it: for each row and each column, it reads
+ * that field's errors and writes the first message under the key the sheet addresses cells by.
+ *
+ * ```ts
+ * readonly form = form(this.lines, (path) => {
+ *   applyEach(path, (line) => {
+ *     min(line.units, 1, { message: 'At least one unit' });
+ *   });
+ * });
+ *
+ * protected readonly cellErrors = computed(() =>
+ *   spreadsheetFieldErrors(this.form, this.lines(), this.columns, (row) => row.id)
+ * );
+ * ```
+ *
+ * @param form The field tree over the rows.
+ * @param rows The rows themselves, in the same order.
+ * @param columns The sheet's columns; only aliases that name a field are looked up.
+ * @param rowKey How the sheet names a row, so the keys line up with `states`.
+ * @param touchedOnly Whether to report only fields the reader has visited. True by default: an
+ *   untouched form that paints itself red the moment it renders is a form nobody trusts.
+ */
+function spreadsheetFieldErrors(form, rows, columns, rowKey, touchedOnly = true) {
+    const errors = {};
+    const tree = form;
+    rows.forEach((row, index) => {
+        const rowField = tree[index];
+        if (!rowField) {
+            return;
+        }
+        for (const column of columns) {
+            const message = firstMessage(rowField[column.key], touchedOnly);
+            if (message) {
+                errors[`${rowKey(row)}\t${column.key}`] = message;
+            }
+        }
+    });
+    return errors;
+}
+/**
+ * The first message a field has to offer, or nothing.
+ *
+ * Read defensively. A column alias need not name a field at all — a calculated total has no
+ * counterpart in the model — and reaching into a field tree for a key that is not there must
+ * report "no error" rather than throw in the middle of a render.
+ */
+function firstMessage(field, touchedOnly) {
+    if (typeof field !== 'function') {
+        return undefined;
+    }
+    try {
+        const state = field();
+        if (touchedOnly && state['touched'] && state['touched']() !== true) {
+            return undefined;
+        }
+        const list = state['errors']?.();
+        const first = list?.[0];
+        return first?.message ?? first?.kind;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Marks the field behind a cell as visited.
+ *
+ * Errors are held back until a cell has been touched, and a sheet has no way to report that on
+ * its own: the `FormField` directive learns it from a control's `touch` output, and a sheet
+ * driven through `errors` is not bound to a field at all. So the host says it, from the
+ * `commit`, `pasted` and `cleared` handlers it already writes.
+ *
+ * Without this call, `spreadsheetFieldErrors()` in its default mode reports nothing and no cell
+ * is ever marked — which looks exactly like validation that does not work.
+ *
+ * ```ts
+ * protected onCommit(change: HubSpreadsheetCommit<Line>): void {
+ *   this.lines.update(...);
+ *   touchSpreadsheetField(this.orderForm, change.coords.row, change.column.key);
+ * }
+ * ```
+ *
+ * @param form The field tree over the rows.
+ * @param row The row index of the cell.
+ * @param columnKey The column's alias.
+ */
+function touchSpreadsheetField(form, row, columnKey) {
+    const field = form[row]?.[columnKey];
+    if (typeof field !== 'function') {
+        return;
+    }
+    try {
+        const state = field();
+        state.markAsTouched?.();
+    }
+    catch {
+        // A column alias that names no field. Nothing to mark, and nothing to report.
+    }
+}
+
+/*
+ * Public API Surface of ng-hub-ui-spreadsheet/signals
+ *
+ * Opt-in Angular Signal Forms (`@angular/forms/signals`) integration. Importing this entry
+ * point is the only place that pulls in that API; the core `ng-hub-ui-spreadsheet` package
+ * never touches it, so a project that uses neither forms system pays nothing for it.
+ *
+ * Worth knowing before you choose a shape: a control whose value is a collection receives only
+ * that field's own errors, never its descendants'. `<hub-spreadsheet-field>` is therefore the
+ * convenience, not the whole story — for per-cell validation, keep the sheet bound to your own
+ * rows and feed its `errors` input from the field tree. `spreadsheetFieldErrors()` does that
+ * mapping for you.
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { HubSpreadsheetFieldComponent, spreadsheetFieldErrors, touchSpreadsheetField };
+//# sourceMappingURL=ng-hub-ui-spreadsheet-signals.mjs.map

package/fesm2022/ng-hub-ui-spreadsheet-signals.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-hub-ui-spreadsheet-signals.mjs","sources":["../../../projects/spreadsheet/signals/src/lib/spreadsheet-field.component.ts","../../../projects/spreadsheet/signals/src/lib/spreadsheet-field-errors.ts","../../../projects/spreadsheet/signals/src/public-api.ts","../../../projects/spreadsheet/signals/src/ng-hub-ui-spreadsheet-signals.ts"],"sourcesContent":["import { ChangeDetectionStrategy, Component, booleanAttribute, computed, input, model, output } from '@angular/core';\nimport { FormValueControl, ValidationError, WithOptionalFieldTree } from '@angular/forms/signals';\nimport { HubGridRange, HubGridSpan } from 'ng-hub-ui-utils';\nimport {\n\tHubSpreadsheetCellRef,\n\tHubSpreadsheetCellState,\n\tHubSpreadsheetColumn,\n\tHubSpreadsheetCommit,\n\tHubSpreadsheetComponent,\n\tHubSpreadsheetPaste\n} from 'ng-hub-ui-spreadsheet';\n\n/**\n * A sheet that is a form control: its value is the rows.\n *\n * Bind it with the `FormField` directive and the rows become the field's value, written back on\n * every edit, paste and clearing. Because the contract is Angular's own\n * {@link FormValueControl}, the same component also works inside reactive and template-driven\n * forms — Angular's migration guide says as much, and forbids implementing the old\n * `ControlValueAccessor` alongside it.\n *\n * **What this shape cannot do, and why it is not the only one.** A control bound to a collection\n * receives that field's own errors and never its descendants'. A rule declared with `applyEach`\n * on the rows therefore produces errors this component will not see, and per-cell validation is\n * the whole point of an editable sheet. When you need it, keep `<hub-spreadsheet>` bound to your\n * own rows and feed its `errors` input — `spreadsheetFieldErrors()` maps a field tree onto the\n * map it expects.\n */\n@Component({\n\tselector: 'hub-spreadsheet-field',\n\tstandalone: true,\n\timports: [HubSpreadsheetComponent],\n\tchangeDetection: ChangeDetectionStrategy.OnPush,\n\ttemplate: `\n\t\t<hub-spreadsheet\n\t\t\t[rows]=\"value()\"\n\t\t\t[columns]=\"columns()\"\n\t\t\t[rowKey]=\"rowKey()\"\n\t\t\t[states]=\"states()\"\n\t\t\t[errors]=\"cellErrors()\"\n\t\t\t[decimalMark]=\"decimalMark()\"\n\t\t\t[emptyText]=\"emptyText()\"\n\t\t\t[pageSize]=\"pageSize()\"\n\t\t\t[readonly]=\"readonly() || disabled()\"\n\t\t\t[frozenColumns]=\"frozenColumns()\"\n\t\t\t[frozenRows]=\"frozenRows()\"\n\t\t\t[spans]=\"spans()\"\n\t\t\t(commit)=\"onCommit($event)\"\n\t\t\t(pasted)=\"onPaste($event)\"\n\t\t\t(cleared)=\"onCleared($event)\"\n\t\t\t(selectionChange)=\"selectionChange.emit($event)\"\n\t\t/>\n\t`\n})\nexport class HubSpreadsheetFieldComponent<TRow extends object> implements FormValueControl<TRow[]> {\n\t/** The rows, as the field's value. Written back whenever the reader changes a cell. */\n\treadonly value = model<TRow[]>([]);\n\n\t/** What each column shows and allows. */\n\treadonly columns = input.required<readonly HubSpreadsheetColumn<TRow>[]>();\n\t/** A stable name per row. */\n\treadonly rowKey = input.required<(row: TRow) => string>();\n\t/** The save state of each cell. */\n\treadonly states = input<Record<string, HubSpreadsheetCellState>>({});\n\t/** The character this reader types decimals with. */\n\treadonly decimalMark = input<',' | '.'>(',');\n\t/** What an empty sheet says. */\n\treadonly emptyText = input('');\n\t/** How many rows Page Up and Page Down travel. */\n\treadonly pageSize = input(10);\n\t/** Turns off every editor, whatever the cells say. */\n\treadonly readonly = input(false, { transform: booleanAttribute });\n\t/** How many columns stay pinned to the leading edge. */\n\treadonly frozenColumns = input(0);\n\t/** How many rows stay pinned below the header. */\n\treadonly frozenRows = input(0);\n\t/** Merged blocks. */\n\treadonly spans = input<readonly HubGridSpan[]>([]);\n\n\t/**\n\t * Bound by the `FormField` directive. Only the array field's own errors arrive here, which is\n\t * why they are shown as a whole rather than attributed to a cell.\n\t */\n\treadonly errors = input<readonly ValidationError.WithOptionalFieldTree[]>([]);\n\t/** Bound by the `FormField` directive; disables every editor. */\n\treadonly disabled = input(false, { transform: booleanAttribute });\n\n\t/** The selected rectangle changed. */\n\treadonly selectionChange = output<HubGridRange | null>();\n\n\t/**\n\t * The sheet's own per-cell error map.\n\t *\n\t * Empty here on purpose: this shape has no per-cell errors to give. It exists so the inner\n\t * component's input is always bound to something, and so a future release can fill it without\n\t * changing the template.\n\t */\n\tprotected readonly cellErrors = computed<Record<string, string>>(() => ({}));\n\n\tprotected onCommit(change: HubSpreadsheetCommit<TRow>): void {\n\t\tthis.write(change.coords.row, change.column.key, change.value);\n\t}\n\n\tprotected onPaste(paste: HubSpreadsheetPaste<TRow>): void {\n\t\tif (!paste.cells.length) {\n\t\t\treturn;\n\t\t}\n\n\t\t// One update for the whole block rather than one per cell: a paste is a single change as\n\t\t// far as the field is concerned, and writing it cell by cell would fire the form's\n\t\t// validation hundreds of times for one gesture.\n\t\tthis.value.update((rows) => {\n\t\t\tconst next = [...rows];\n\n\t\t\tfor (const change of paste.cells) {\n\t\t\t\tnext[change.coords.row] = { ...next[change.coords.row], [change.column.key]: change.value };\n\t\t\t}\n\n\t\t\treturn next;\n\t\t});\n\t}\n\n\tprotected onCleared(cells: readonly HubSpreadsheetCellRef<TRow>[]): void {\n\t\tthis.value.update((rows) => {\n\t\t\tconst next = [...rows];\n\n\t\t\tfor (const ref of cells) {\n\t\t\t\tnext[ref.coords.row] = { ...next[ref.coords.row], [ref.column.key]: null };\n\t\t\t}\n\n\t\t\treturn next;\n\t\t});\n\t}\n\n\tprivate write(row: number, key: string, value: unknown): void {\n\t\tthis.value.update((rows) =>\n\t\t\trows.map((candidate, index) => (index === row ? { ...candidate, [key]: value } : candidate))\n\t\t);\n\t}\n}\n\n/** Re-exported so a consumer can type a handler without importing from two packages. */\nexport type { WithOptionalFieldTree };\n","import { FieldTree } from '@angular/forms/signals';\nimport { HubSpreadsheetColumn } from 'ng-hub-ui-spreadsheet';\n\n/**\n * Turns a field tree over rows into the per-cell error map `<hub-spreadsheet>` reads.\n *\n * This is the piece that makes per-cell validation work, and it exists because of a limit in the\n * framework rather than a preference: a control bound to a collection is handed that field's own\n * errors and never its descendants'. Rules declared with `applyEach` therefore land on the row\n * fields, one level below anything the sheet could see for itself.\n *\n * So the host keeps the field tree, and this walks it: for each row and each column, it reads\n * that field's errors and writes the first message under the key the sheet addresses cells by.\n *\n * ```ts\n * readonly form = form(this.lines, (path) => {\n *   applyEach(path, (line) => {\n *     min(line.units, 1, { message: 'At least one unit' });\n *   });\n * });\n *\n * protected readonly cellErrors = computed(() =>\n *   spreadsheetFieldErrors(this.form, this.lines(), this.columns, (row) => row.id)\n * );\n * ```\n *\n * @param form The field tree over the rows.\n * @param rows The rows themselves, in the same order.\n * @param columns The sheet's columns; only aliases that name a field are looked up.\n * @param rowKey How the sheet names a row, so the keys line up with `states`.\n * @param touchedOnly Whether to report only fields the reader has visited. True by default: an\n *   untouched form that paints itself red the moment it renders is a form nobody trusts.\n */\nexport function spreadsheetFieldErrors<TRow extends object>(\n\tform: FieldTree<TRow[]>,\n\trows: readonly TRow[],\n\tcolumns: readonly HubSpreadsheetColumn<TRow>[],\n\trowKey: (row: TRow) => string,\n\ttouchedOnly = true\n): Record<string, string> {\n\tconst errors: Record<string, string> = {};\n\tconst tree = form as unknown as ArrayLike<Record<string, unknown>>;\n\n\trows.forEach((row, index) => {\n\t\tconst rowField = tree[index];\n\n\t\tif (!rowField) {\n\t\t\treturn;\n\t\t}\n\n\t\tfor (const column of columns) {\n\t\t\tconst message = firstMessage(rowField[column.key], touchedOnly);\n\n\t\t\tif (message) {\n\t\t\t\terrors[`${rowKey(row)}\\t${column.key}`] = message;\n\t\t\t}\n\t\t}\n\t});\n\n\treturn errors;\n}\n\n/**\n * The first message a field has to offer, or nothing.\n *\n * Read defensively. A column alias need not name a field at all — a calculated total has no\n * counterpart in the model — and reaching into a field tree for a key that is not there must\n * report \"no error\" rather than throw in the middle of a render.\n */\nfunction firstMessage(field: unknown, touchedOnly: boolean): string | undefined {\n\tif (typeof field !== 'function') {\n\t\treturn undefined;\n\t}\n\n\ttry {\n\t\tconst state = (field as () => Record<string, () => unknown>)();\n\n\t\tif (touchedOnly && state['touched'] && state['touched']() !== true) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst list = state['errors']?.() as ReadonlyArray<{ message?: string; kind?: string }> | undefined;\n\t\tconst first = list?.[0];\n\n\t\treturn first?.message ?? first?.kind;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/**\n * Marks the field behind a cell as visited.\n *\n * Errors are held back until a cell has been touched, and a sheet has no way to report that on\n * its own: the `FormField` directive learns it from a control's `touch` output, and a sheet\n * driven through `errors` is not bound to a field at all. So the host says it, from the\n * `commit`, `pasted` and `cleared` handlers it already writes.\n *\n * Without this call, `spreadsheetFieldErrors()` in its default mode reports nothing and no cell\n * is ever marked — which looks exactly like validation that does not work.\n *\n * ```ts\n * protected onCommit(change: HubSpreadsheetCommit<Line>): void {\n *   this.lines.update(...);\n *   touchSpreadsheetField(this.orderForm, change.coords.row, change.column.key);\n * }\n * ```\n *\n * @param form The field tree over the rows.\n * @param row The row index of the cell.\n * @param columnKey The column's alias.\n */\nexport function touchSpreadsheetField<TRow extends object>(form: FieldTree<TRow[]>, row: number, columnKey: string): void {\n\tconst field = (form as unknown as ArrayLike<Record<string, unknown>>)[row]?.[columnKey];\n\n\tif (typeof field !== 'function') {\n\t\treturn;\n\t}\n\n\ttry {\n\t\tconst state = (field as () => { markAsTouched?: () => void })();\n\n\t\tstate.markAsTouched?.();\n\t} catch {\n\t\t// A column alias that names no field. Nothing to mark, and nothing to report.\n\t}\n}\n","/*\n * Public API Surface of ng-hub-ui-spreadsheet/signals\n *\n * Opt-in Angular Signal Forms (`@angular/forms/signals`) integration. Importing this entry\n * point is the only place that pulls in that API; the core `ng-hub-ui-spreadsheet` package\n * never touches it, so a project that uses neither forms system pays nothing for it.\n *\n * Worth knowing before you choose a shape: a control whose value is a collection receives only\n * that field's own errors, never its descendants'. `<hub-spreadsheet-field>` is therefore the\n * convenience, not the whole story — for per-cell validation, keep the sheet bound to your own\n * rows and feed its `errors` input from the field tree. `spreadsheetFieldErrors()` does that\n * mapping for you.\n */\n\nexport { HubSpreadsheetFieldComponent } from './lib/spreadsheet-field.component';\nexport { spreadsheetFieldErrors, touchSpreadsheetField } from './lib/spreadsheet-field-errors';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}