@bestagentkits/render 0.1.1-next.1 → 0.3.0

package/dist/blocks/controls/number-input.js

@@ -0,0 +1,62 @@
+/** Number input: a bounded number; inside a filter-bar it sets a minimum or maximum. */
+import { pathKey } from '../../diagnostics.js';
+import { define, num } from '../../registry/define-helpers.js';
+import { checkControl, controlProps, initialValue } from './control-shared.js';
+import { renderFieldInput } from './field-input.js';
+const BOUND = 1_000_000_000;
+const KIND = {
+    type: 'number-input',
+    valueType: 'number',
+    matches: ['min', 'max', 'equals'],
+};
+const optionalNumber = (value) => typeof value === 'number' ? String(value) : undefined;
+export const numberInputBlock = {
+    definition: define({
+        type: 'number-input',
+        category: 'interaction',
+        tags: ['input', 'number', 'state', 'filter', 'threshold'],
+        useCases: ['enter a quantity', 'filter rows by threshold'],
+        purpose: 'Bounded numeric entry.',
+        summary: 'Number input: labeled native number field; writes state or filters by min/max.',
+        props: controlProps(KIND, num({ min: -BOUND, max: BOUND, description: 'Initial number.' }), {
+            min: num({ min: -BOUND, max: BOUND }),
+            max: num({ min: -BOUND, max: BOUND }),
+            step: num({ min: 0.0001, max: BOUND }),
+        }),
+        runtimeFeatures: ['controls'],
+        actions: ['set-value'],
+        a11y: 'Native number <input> with a visible <label>; arrow keys step the value.',
+    }),
+    render: (node, context) => {
+        const start = initialValue(node, context.ir.state);
+        return renderFieldInput(node, KIND, context, {
+            type: 'number',
+            inputmode: 'decimal',
+            value: optionalNumber(start),
+            min: optionalNumber(node.props.min),
+            max: optionalNumber(node.props.max),
+            step: optionalNumber(node.props.step) ?? 'any',
+        });
+    },
+    check: (node, context) => {
+        checkControl(node, KIND, context);
+        const { min, max, value } = node.props;
+        const report = (key, message) => context.bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path: pathKey(node.path, key),
+            nodeId: node.id,
+            message,
+        });
+        if (typeof min === 'number' && typeof max === 'number' && min > max) {
+            report('min', `"min" (${min}) is greater than "max" (${max})`);
+            return;
+        }
+        if (typeof value !== 'number')
+            return;
+        if (typeof min === 'number' && value < min)
+            report('value', `"value" is below "min" (${min})`);
+        if (typeof max === 'number' && value > max)
+            report('value', `"value" is above "max" (${max})`);
+    },
+};
+//# sourceMappingURL=number-input.js.map

package/dist/blocks/controls/number-input.js.map

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

package/dist/blocks/controls/radio-group.d.ts

@@ -0,0 +1,4 @@
+/** Radio group: a short list of exclusive choices in a fieldset. */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const radioGroupBlock: BlockModule;
+//# sourceMappingURL=radio-group.d.ts.map

package/dist/blocks/controls/radio-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../../src/blocks/controls/radio-group.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAyBlE,eAAO,MAAM,eAAe,EAAE,WAqD7B,CAAC"}

package/dist/blocks/controls/radio-group.js

@@ -0,0 +1,56 @@
+/** Radio group: a short list of exclusive choices in a fieldset. */
+import { define, str } from '../../registry/define-helpers.js';
+import { element, stringProp } from '../../render/block-helpers.js';
+import { escapeText, renderAttributes } from '../../render/escape.js';
+import { ANY_OPTION, checkChoices, choiceProps, resolveOptions, selectedValue, } from './choice-options.js';
+import { checkControl, controlAttributes, controlFooter, controlProps, describedBy, initialValue, placementOf, } from './control-shared.js';
+const MAX_OPTIONS = 8;
+const KIND = { type: 'radio-group', valueType: 'string', matches: ['equals'] };
+export const radioGroupBlock = {
+    definition: define({
+        type: 'radio-group',
+        category: 'interaction',
+        tags: ['input', 'choice', 'state', 'filter'],
+        useCases: ['pick one of a few', 'segment a view'],
+        purpose: 'Exclusive choice among up to 8 options.',
+        summary: 'Radio group: native radios in a fieldset; writes state or filters in a filter-bar.',
+        props: controlProps(KIND, str({ maxLength: 120, description: 'Initial choice.' }), choiceProps(MAX_OPTIONS)),
+        runtimeFeatures: ['controls'],
+        actions: ['set-value'],
+        a11y: '<fieldset> with a visible <legend>; native radios move with the arrow keys.',
+    }),
+    render: (node, context) => {
+        const placement = placementOf(node, context.byId);
+        const options = resolveOptions(node, placement);
+        if (placement.bar !== undefined)
+            options.unshift(ANY_OPTION);
+        const selected = selectedValue(options, initialValue(node, context.ir.state));
+        const radios = options
+            .map((option, index) => {
+            const id = `${node.id}-option-${index}`;
+            const input = `<input${renderAttributes({
+                type: 'radio',
+                id,
+                name: node.id,
+                value: option.value,
+                checked: option.value === selected,
+                disabled: true,
+            })} />`;
+            return `<div class="ak-choice">${input}<label for="${id}">${escapeText(option.label)}</label></div>`;
+        })
+            .join('');
+        return element('fieldset', {
+            ...controlAttributes(node, KIND, context),
+            'aria-describedby': describedBy(node),
+        }, [
+            `<legend>${escapeText(stringProp(node, 'label'))}</legend>`,
+            `<div class="ak-choice-list">${radios}</div>`,
+            controlFooter(node, context),
+        ].join(''));
+    },
+    check: (node, context) => {
+        checkControl(node, KIND, context);
+        checkChoices(node, MAX_OPTIONS, context);
+    },
+};
+//# sourceMappingURL=radio-group.js.map

package/dist/blocks/controls/radio-group.js.map

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

package/dist/blocks/controls/select.d.ts

@@ -0,0 +1,4 @@
+/** Select: a native drop-down that writes one string to state or filters by equality. */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const selectBlock: BlockModule;
+//# sourceMappingURL=select.d.ts.map

package/dist/blocks/controls/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/blocks/controls/select.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AA2BlE,eAAO,MAAM,WAAW,EAAE,WAiDzB,CAAC"}

package/dist/blocks/controls/select.js

@@ -0,0 +1,49 @@
+/** Select: a native drop-down that writes one string to state or filters by equality. */
+import { define, str } from '../../registry/define-helpers.js';
+import { element } from '../../render/block-helpers.js';
+import { escapeText, renderAttributes } from '../../render/escape.js';
+import { ANY_OPTION, checkChoices, choiceProps, resolveOptions, selectedValue, } from './choice-options.js';
+import { checkControl, controlAttributes, controlFooter, controlProps, describedBy, initialValue, inputId, placementOf, visibleLabel, } from './control-shared.js';
+const MAX_OPTIONS = 50;
+const KIND = { type: 'select', valueType: 'string', matches: ['equals'] };
+export const selectBlock = {
+    definition: define({
+        type: 'select',
+        category: 'interaction',
+        tags: ['input', 'choice', 'state', 'filter'],
+        useCases: ['switch a view', 'filter by category'],
+        purpose: 'Native drop-down choice.',
+        summary: 'Select: labeled native <select> that writes state or filters in a filter-bar.',
+        props: controlProps(KIND, str({ maxLength: 120, description: 'Initial choice.' }), choiceProps(MAX_OPTIONS)),
+        runtimeFeatures: ['controls'],
+        actions: ['set-value'],
+        a11y: 'Native <select> with a visible <label>; keyboard behavior is the platform default.',
+    }),
+    render: (node, context) => {
+        const placement = placementOf(node, context.byId);
+        const options = resolveOptions(node, placement);
+        if (placement.bar !== undefined)
+            options.unshift(ANY_OPTION);
+        const selected = selectedValue(options, initialValue(node, context.ir.state));
+        const markup = options
+            .map((option) => `<option${renderAttributes({
+            value: option.value,
+            selected: option.value === selected,
+        })}>${escapeText(option.label)}</option>`)
+            .join('');
+        return element('div', controlAttributes(node, KIND, context), [
+            visibleLabel(node),
+            `<select${renderAttributes({
+                id: inputId(node),
+                disabled: true,
+                'aria-describedby': describedBy(node),
+            })}>${markup}</select>`,
+            controlFooter(node, context),
+        ].join(''));
+    },
+    check: (node, context) => {
+        checkControl(node, KIND, context);
+        checkChoices(node, MAX_OPTIONS, context);
+    },
+};
+//# sourceMappingURL=select.js.map

package/dist/blocks/controls/select.js.map

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

package/dist/blocks/controls/switch.d.ts

@@ -0,0 +1,4 @@
+/** Switch: an on/off setting, a native checkbox with `role="switch"`. */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const switchBlock: BlockModule;
+//# sourceMappingURL=switch.d.ts.map

package/dist/blocks/controls/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/blocks/controls/switch.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAOlE,eAAO,MAAM,WAAW,EAAE,WAgBzB,CAAC"}

package/dist/blocks/controls/switch.js

@@ -0,0 +1,22 @@
+/** Switch: an on/off setting, a native checkbox with `role="switch"`. */
+import { bool, define } from '../../registry/define-helpers.js';
+import { renderToggle } from './checkbox.js';
+import { checkControl, controlProps } from './control-shared.js';
+const KIND = { type: 'switch', valueType: 'boolean', matches: ['truthy'] };
+export const switchBlock = {
+    definition: define({
+        type: 'switch',
+        category: 'interaction',
+        tags: ['input', 'boolean', 'toggle', 'state'],
+        useCases: ['show or hide detail', 'turn a setting on'],
+        purpose: 'On/off setting.',
+        summary: 'Switch: native checkbox with role="switch"; writes a boolean or filters to truthy rows.',
+        props: controlProps(KIND, bool({ description: 'Initially on.' })),
+        runtimeFeatures: ['controls'],
+        actions: ['set-value'],
+        a11y: 'Native checkbox with role="switch" and a visible <label>; Space toggles it.',
+    }),
+    render: (node, context) => renderToggle(node, KIND, context, true),
+    check: (node, context) => checkControl(node, KIND, context),
+};
+//# sourceMappingURL=switch.js.map

package/dist/blocks/controls/switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.js","sourceRoot":"","sources":["../../../src/blocks/controls/switch.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAGzE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAoB,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnF,MAAM,IAAI,GAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;AAExF,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,UAAU,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;QAC7C,QAAQ,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;QACtD,OAAO,EAAE,iBAAiB;QAC1B,OAAO,EACL,yFAAyF;QAC3F,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC;QACjE,eAAe,EAAE,CAAC,UAAU,CAAC;QAC7B,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,IAAI,EAAE,6EAA6E;KACpF,CAAC;IACF,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;IAClE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;CAC5D,CAAC"}

package/dist/blocks/controls/text-input.d.ts

@@ -0,0 +1,4 @@
+/** Text input: a bounded single-line string; inside a filter-bar it matches by substring. */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const textInputBlock: BlockModule;
+//# sourceMappingURL=text-input.d.ts.map

package/dist/blocks/controls/text-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../../src/blocks/controls/text-input.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAalE,eAAO,MAAM,cAAc,EAAE,WA6B5B,CAAC"}

package/dist/blocks/controls/text-input.js

@@ -0,0 +1,42 @@
+/** Text input: a bounded single-line string; inside a filter-bar it matches by substring. */
+import { define, num, str } from '../../registry/define-helpers.js';
+import { numberProp, stringProp } from '../../render/block-helpers.js';
+import { checkControl, controlProps, initialValue } from './control-shared.js';
+import { renderFieldInput } from './field-input.js';
+const MAX_LENGTH = 200;
+const KIND = {
+    type: 'text-input',
+    valueType: 'string',
+    matches: ['contains', 'equals'],
+};
+export const textInputBlock = {
+    definition: define({
+        type: 'text-input',
+        category: 'interaction',
+        tags: ['input', 'text', 'state', 'filter'],
+        useCases: ['enter a name', 'filter rows by text'],
+        purpose: 'Single-line text entry.',
+        summary: 'Text input: labeled native text field; writes state or filters rows by substring.',
+        props: controlProps(KIND, str({ maxLength: MAX_LENGTH, description: 'Initial text.' }), {
+            placeholder: str({ maxLength: 120 }),
+            maxLength: num({ min: 1, max: MAX_LENGTH, integer: true, default: MAX_LENGTH }),
+        }),
+        runtimeFeatures: ['controls'],
+        actions: ['set-value'],
+        a11y: 'Native text <input> with a visible <label>; the placeholder never replaces it.',
+    }),
+    render: (node, context) => {
+        const start = initialValue(node, context.ir.state);
+        const placeholder = stringProp(node, 'placeholder');
+        return renderFieldInput(node, KIND, context, {
+            type: 'text',
+            value: typeof start === 'string' ? start : '',
+            maxlength: String(numberProp(node, 'maxLength', MAX_LENGTH)),
+            placeholder: placeholder === '' ? undefined : placeholder,
+            autocomplete: 'off',
+            spellcheck: 'false',
+        });
+    },
+    check: (node, context) => checkControl(node, KIND, context),
+};
+//# sourceMappingURL=text-input.js.map

package/dist/blocks/controls/text-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.js","sourceRoot":"","sources":["../../../src/blocks/controls/text-input.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAG7F,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAoB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,IAAI,GAAgB;IACxB,IAAI,EAAE,YAAY;IAClB,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,UAAU,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;QAC1C,QAAQ,EAAE,CAAC,cAAc,EAAE,qBAAqB,CAAC;QACjD,OAAO,EAAE,yBAAyB;QAClC,OAAO,EAAE,mFAAmF;QAC5F,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,EAAE;YACtF,WAAW,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;YACpC,SAAS,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;SAChF,CAAC;QACF,eAAe,EAAE,CAAC,UAAU,CAAC;QAC7B,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,IAAI,EAAE,gFAAgF;KACvF,CAAC;IACF,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACpD,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;YAC3C,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAC7C,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YAC5D,WAAW,EAAE,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YACzD,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;CAC5D,CAAC"}

package/dist/blocks/data-table/data-table-cells.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Data table cells: one renderer per column type.
+ *
+ * Every value goes through `formatValue`, so a cell reads like the same value
+ * in a chart or a metric. Each cell also carries its raw value in `data-sort`,
+ * which the sort runtime compares, so sorting never depends on display text.
+ */
+import { type DataRow, type DataScalar } from '../../data/dataset-types.js';
+import type { DataColumn } from './data-table-columns.js';
+/**
+ * The value as a link target when it passes the same URL policy as every URL
+ * prop (relative, https, http or mailto); undefined otherwise.
+ */
+export declare function safeHref(value: DataScalar): string | undefined;
+/** The raw value the sort runtime compares; undefined for an empty cell. */
+export declare function sortValue(value: DataScalar): string | undefined;
+/** The inner markup of one cell. */
+export declare function cellContent(column: DataColumn, row: DataRow): string;
+/** Alignment class shared by a column's header and its cells. */
+export declare function alignClass(column: DataColumn): string | undefined;
+/**
+ * One body cell. The first column is the row header, which the card layout on
+ * narrow screens also uses as the card's title.
+ */
+export declare function renderCell(column: DataColumn, row: DataRow, first: boolean): string;
+//# sourceMappingURL=data-table-cells.d.ts.map

package/dist/blocks/data-table/data-table-cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-cells.d.ts","sourceRoot":"","sources":["../../../src/blocks/data-table/data-table-cells.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,6BAA6B,CAAC;AAaxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAiC1D;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAK9D;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAE/D;AAyDD,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAcpE;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAGjE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAYnF"}

package/dist/blocks/data-table/data-table-cells.js

@@ -0,0 +1,154 @@
+/**
+ * Data table cells: one renderer per column type.
+ *
+ * Every value goes through `formatValue`, so a cell reads like the same value
+ * in a chart or a metric. Each cell also carries its raw value in `data-sort`,
+ * which the sort runtime compares, so sorting never depends on display text.
+ */
+import { fieldValue } from '../../data/dataset-types.js';
+import { EMPTY_VALUE, formatValue } from '../../data/format-value.js';
+import { DiagnosticBag } from '../../diagnostics.js';
+import { urlProp } from '../../registry/define-helpers.js';
+import { validateProp } from '../../registry/prop-schema.js';
+import { escapeText, escapeUrl, renderAttributes, } from '../../render/escape.js';
+import { sparkPaths } from '../../render/showcase-blocks.js';
+import { toneBadge } from '../../render/tone.js';
+/** The sparkline drawing space `sparkPaths` plots into (its 120×36 box). */
+const SPARK_VIEWBOX = '0 0 120 36';
+const LINK_SCHEMA = urlProp();
+/**
+ * Test and run outcomes, which status columns are mostly made of. They extend
+ * the shared value tones for badge cells only; an authored `tones` map wins.
+ */
+const OUTCOME_TONES = {
+    pass: 'success',
+    passed: 'success',
+    ok: 'success',
+    fail: 'danger',
+    failed: 'danger',
+    error: 'danger',
+    flaky: 'warning',
+    skipped: 'neutral',
+};
+/** Types whose cells read as one unit and so never wrap. */
+const UNBROKEN_TYPES = new Set([
+    'number',
+    'percent',
+    'currency',
+    'date',
+    'badge',
+    'progress',
+    'sparkline',
+]);
+/**
+ * The value as a link target when it passes the same URL policy as every URL
+ * prop (relative, https, http or mailto); undefined otherwise.
+ */
+export function safeHref(value) {
+    if (typeof value !== 'string' || value === '')
+        return undefined;
+    const probe = new DiagnosticBag();
+    validateProp(LINK_SCHEMA, value, '', probe);
+    return probe.size === 0 ? value : undefined;
+}
+/** The raw value the sort runtime compares; undefined for an empty cell. */
+export function sortValue(value) {
+    return value === null ? undefined : String(value);
+}
+function numericValues(row, fields) {
+    const values = [];
+    for (const field of fields) {
+        const value = fieldValue(row, field);
+        if (typeof value === 'number')
+            values.push(value);
+    }
+    return values;
+}
+function badge(column, value) {
+    if (value === null)
+        return EMPTY_VALUE;
+    const text = formatValue(value, column.format);
+    const raw = String(value);
+    const word = raw.trim().toLowerCase();
+    const tone = Object.hasOwn(column.tones, raw)
+        ? column.tones[raw]
+        : Object.hasOwn(OUTCOME_TONES, word)
+            ? OUTCOME_TONES[word]
+            : undefined;
+    if (tone === undefined)
+        return toneBadge(text);
+    return `<span class="ak-badge" data-tone="${tone}">${escapeText(text)}</span>`;
+}
+function link(column, row, value) {
+    const text = escapeText(formatValue(value, column.format));
+    const href = safeHref(fieldValue(row, column.hrefField));
+    if (href === undefined)
+        return text;
+    return `<a${renderAttributes({ href: escapeUrl(href), rel: 'noreferrer noopener' })}>${text}</a>`;
+}
+function progress(column, value) {
+    if (typeof value !== 'number')
+        return escapeText(formatValue(value, column.format));
+    // The meter is the picture; the text beside it carries the value.
+    return `<span class="ak-dt-progress"><meter${renderAttributes({
+        min: 0,
+        max: column.max,
+        value: Math.min(Math.max(value, 0), column.max),
+        'aria-hidden': 'true',
+    })}></meter><span>${escapeText(formatValue(value, column.format))}</span></span>`;
+}
+function sparkline(column, row) {
+    const values = numericValues(row, column.fields);
+    if (values.length < 2)
+        return EMPTY_VALUE;
+    const paths = sparkPaths(values);
+    const spoken = values.map((value) => formatValue(value, column.format)).join(', ');
+    return [
+        `<svg class="ak-dt-spark" viewBox="${SPARK_VIEWBOX}" preserveAspectRatio="none" aria-hidden="true" focusable="false">`,
+        `<path class="ak-dt-spark-area" d="${paths.area}" />`,
+        `<path class="ak-dt-spark-line" d="${paths.line}" vector-effect="non-scaling-stroke" />`,
+        '</svg>',
+        `<span class="ak-sr">${escapeText(spoken)}</span>`,
+    ].join('');
+}
+/** The inner markup of one cell. */
+export function cellContent(column, row) {
+    const value = fieldValue(row, column.key);
+    switch (column.type) {
+        case 'badge':
+            return badge(column, value);
+        case 'link':
+            return link(column, row, value);
+        case 'progress':
+            return progress(column, value);
+        case 'sparkline':
+            return sparkline(column, row);
+        default:
+            return escapeText(formatValue(value, column.format));
+    }
+}
+/** Alignment class shared by a column's header and its cells. */
+export function alignClass(column) {
+    if (column.align === 'end')
+        return 'ak-num';
+    return column.align === 'center' ? 'ak-dt-center' : undefined;
+}
+/**
+ * One body cell. The first column is the row header, which the card layout on
+ * narrow screens also uses as the card's title.
+ */
+export function renderCell(column, row, first) {
+    const classes = [alignClass(column), UNBROKEN_TYPES.has(column.type) ? 'ak-dt-nowrap' : undefined]
+        .filter((name) => name !== undefined)
+        .join(' ');
+    const attributes = {
+        class: classes === '' ? undefined : classes,
+        'data-label': column.label,
+        'data-sort': sortValue(fieldValue(row, column.key)),
+    };
+    if (first)
+        attributes.scope = 'row';
+    const tag = first ? 'th' : 'td';
+    return `<${tag}${renderAttributes(attributes)}>${cellContent(column, row)}</${tag}>`;
+}
+//# sourceMappingURL=data-table-cells.js.map

package/dist/blocks/data-table/data-table-cells.js.map

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

package/dist/blocks/data-table/data-table-check.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cross-field checks for the data table: every field a column names must exist
+ * in the bound data, a sparkline needs its series fields, and a prop that only
+ * one column type reads is flagged elsewhere. Link values that fail the URL
+ * policy are warned about, because they render as plain text.
+ */
+import type { IrNode } from '../../ir.js';
+import type { CheckContext } from '../../registry/block-module.js';
+export declare function checkDataTable(node: IrNode, { bag }: CheckContext): void;
+//# sourceMappingURL=data-table-check.d.ts.map

package/dist/blocks/data-table/data-table-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-check.d.ts","sourceRoot":"","sources":["../../../src/blocks/data-table/data-table-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAoBnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,YAAY,GAAG,IAAI,CAkExE"}

package/dist/blocks/data-table/data-table-check.js

@@ -0,0 +1,99 @@
+/**
+ * Cross-field checks for the data table: every field a column names must exist
+ * in the bound data, a sparkline needs its series fields, and a prop that only
+ * one column type reads is flagged elsewhere. Link values that fail the URL
+ * policy are warned about, because they render as plain text.
+ */
+import { fieldValue } from '../../data/dataset-types.js';
+import { reportUnknownField } from '../../data/resolve-block-data.js';
+import { pathIndex, pathKey } from '../../diagnostics.js';
+import { objectListProp } from '../../render/block-helpers.js';
+import { safeHref } from './data-table-cells.js';
+import { columnType, resolveColumns } from './data-table-columns.js';
+/** Column props that only one type reads, so setting them elsewhere is a mistake. */
+const TYPE_ONLY_PROPS = [
+    { prop: 'hrefField', type: 'link' },
+    { prop: 'max', type: 'progress' },
+    { prop: 'fields', type: 'sparkline' },
+    { prop: 'tones', type: 'badge' },
+];
+function isSet(value) {
+    if (value === undefined)
+        return false;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'object' && value !== null)
+        return Object.keys(value).length > 0;
+    return true;
+}
+export function checkDataTable(node, { bag }) {
+    const data = node.data;
+    if (data === undefined)
+        return;
+    const columnsPath = pathKey(node.path, 'columns');
+    objectListProp(node, 'columns').forEach((column, index) => {
+        const path = pathIndex(columnsPath, index);
+        const type = columnType(column.type);
+        const field = (value, at) => {
+            if (typeof value === 'string' && !data.fields.includes(value)) {
+                reportUnknownField(value, data, pathKey(path, at), bag, node.id);
+            }
+        };
+        field(column.key, 'key');
+        if (type === 'link')
+            field(column.hrefField, 'hrefField');
+        if (type === 'sparkline') {
+            const fields = Array.isArray(column.fields) ? column.fields : [];
+            if (fields.length === 0) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path: pathKey(path, 'fields'),
+                    nodeId: node.id,
+                    message: 'a sparkline column needs "fields": 2 to 24 numeric fields',
+                    details: { allowed: [...data.fields] },
+                });
+            }
+            fields.forEach((name, position) => {
+                field(name, `fields[${position}]`);
+            });
+        }
+        for (const { prop, type: owner } of TYPE_ONLY_PROPS) {
+            if (type !== owner && isSet(column[prop])) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    severity: 'warning',
+                    path: pathKey(path, prop),
+                    nodeId: node.id,
+                    message: `"${prop}" applies only to ${owner} columns and is ignored here`,
+                });
+            }
+        }
+        if (column.max === 0) {
+            bag.add({
+                code: 'SPEC_VALIDATION_ERROR',
+                path: pathKey(path, 'max'),
+                nodeId: node.id,
+                message: 'a progress "max" must be greater than 0',
+            });
+        }
+    });
+    // Unsafe link targets render as plain text; say so once per value.
+    resolveColumns(node).forEach((column, index) => {
+        if (column.type !== 'link' || !data.fields.includes(column.hrefField))
+            return;
+        for (const row of data.rows) {
+            const value = fieldValue(row, column.hrefField);
+            if (value === null || safeHref(value) !== undefined)
+                continue;
+            bag.add({
+                code: 'SPEC_VALIDATION_ERROR',
+                severity: 'warning',
+                path: pathKey(pathIndex(columnsPath, index), 'hrefField'),
+                nodeId: node.id,
+                message: `link "${String(value)}" is not a safe URL and renders as text`,
+                details: { value },
+            });
+        }
+    });
+}
+//# sourceMappingURL=data-table-check.js.map

package/dist/blocks/data-table/data-table-check.js.map

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