@bestagentkits/render 0.2.0 → 0.3.0

package/dist/blocks/evidence/evidence-styles.js

@@ -0,0 +1,88 @@
+/**
+ * Feature sheets for the evidence widgets. `evidence` covers the benchmark
+ * comparison, the metric breakdown and the references list; `annotated-image`
+ * is separate because it is the only one that positions pins over media.
+ *
+ * Every value comes from theme tokens. Positions and widths are static rules
+ * keyed by quantized attributes (`data-ak-pct`, `data-x`, `data-y`), so the
+ * page needs no inline style and no script to lay them out.
+ */
+import { TRANSITION, UNIT } from '../../render/style-units.js';
+import { PIN_STEP } from './annotated-image.js';
+import { BREAKDOWN_SERIES } from './metric-breakdown.js';
+const MONO_LABEL = 'font-family:var(--ak-font-mono);font-size:.7rem;font-weight:500;letter-spacing:.08em;text-transform:uppercase;color:var(--ak-color-text-muted)';
+/** One rule per value of an integer attribute, e.g. `[data-ak-pct="42"]{width:42%}`. */
+function steppedRules(selector, attribute, property, step) {
+    const rules = [];
+    for (let value = 0; value <= 100; value += step) {
+        rules.push(`${selector}[${attribute}="${value}"]{${property}:${value}%}`);
+    }
+    return rules.join('');
+}
+const BENCHMARK_CSS = `.ak-bench{display:flex;flex-direction:column;gap:${UNIT(1.5)}}
+.ak-bench-summary{display:flex;flex-wrap:wrap;align-items:center;gap:.5em 1em;margin:0;font-family:var(--ak-font-mono);font-size:.78rem;letter-spacing:.03em;color:var(--ak-color-text-muted)}
+.ak-bench-summary strong{color:var(--ak-color-text);font-weight:600}
+.ak-bench-tally{padding:.2em .75em;border-radius:999px;background:var(--ak-tint);color:var(--ak-color-text);border:var(--ak-border-width) solid color-mix(in srgb,var(--ak-color-accent) 22%,var(--ak-color-border))}
+.ak-bench-metric{display:block;overflow-wrap:anywhere}
+.ak-bench-better{display:block;margin-top:.2em;${MONO_LABEL};font-size:.64rem;white-space:nowrap}
+.ak-bench-delta{white-space:nowrap;font-weight:600}
+.ak-bench-pct{display:block;margin-top:.15em;font-family:var(--ak-font-mono);font-size:.76em;font-weight:500;color:var(--ak-color-text-muted)}
+.ak-bench tr[data-verdict="improved"] .ak-bench-delta{color:color-mix(in srgb,var(--ak-color-success) 78%,var(--ak-color-text))}
+.ak-bench tr[data-verdict="regressed"] .ak-bench-delta{color:color-mix(in srgb,var(--ak-color-danger) 78%,var(--ak-color-text))}
+.ak-bench-notes{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,15rem),1fr));gap:${UNIT(1.5)} ${UNIT(3)};margin:0;padding-top:${UNIT(1.5)};border-top:var(--ak-border-width) solid var(--ak-color-border)}
+.ak-bench-notes div{min-width:0}
+.ak-bench-notes dt{${MONO_LABEL}}
+.ak-bench-notes dd{margin:.35em 0 0;font-size:.92rem;color:var(--ak-color-text-muted);overflow-wrap:anywhere}
+@media (max-width:560px){.ak-bench .ak-table-wrap table{min-width:0}.ak-bench thead{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}.ak-bench tbody{display:block}.ak-bench tbody tr{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:${UNIT(1)} ${UNIT(2)};padding:${UNIT(1.75)} ${UNIT(2)};border-bottom:var(--ak-border-width) solid var(--ak-color-border)}.ak-bench tbody tr:last-child{border-bottom:0}.ak-bench tbody tr > *{display:block;padding:0;border:0;text-align:left}.ak-bench tbody th{grid-column:1 / -1}.ak-bench td::before{content:attr(data-label);display:block;margin-bottom:.2em;${MONO_LABEL};font-size:.64rem}.ak-bench-delta{white-space:normal}}`;
+const SERIES_RULES = Array.from({ length: BREAKDOWN_SERIES }, (_, index) => `.ak-breakdown [data-series="${index}"]{--ak-part:var(--ak-c${index})}`).join('\n');
+const BREAKDOWN_CSS = `.ak-breakdown{display:flex;flex-direction:column;gap:${UNIT(1.5)};--ak-c0:var(--ak-color-accent);--ak-c1:var(--ak-color-info);--ak-c2:var(--ak-color-success);--ak-c3:var(--ak-color-warning);--ak-c4:var(--ak-color-danger);--ak-c5:var(--ak-color-text-muted)}
+@supports (color:oklch(from red l c h)){.ak-breakdown{--ak-c1:oklch(from var(--ak-color-accent) l max(c,.1) calc(h + 210));--ak-c2:oklch(from var(--ak-color-accent) l max(c,.1) calc(h + 120));--ak-c3:oklch(from var(--ak-color-accent) l max(c,.1) calc(h + 60));--ak-c4:oklch(from var(--ak-color-accent) l max(c,.1) calc(h + 290));--ak-c5:oklch(from var(--ak-color-accent) l max(c,.1) calc(h + 165))}}
+${SERIES_RULES}
+.ak-breakdown [data-tone="neutral"]{--ak-part:var(--ak-color-text-muted)}
+.ak-breakdown [data-tone="info"]{--ak-part:var(--ak-color-info)}
+.ak-breakdown [data-tone="success"]{--ak-part:var(--ak-color-success)}
+.ak-breakdown [data-tone="warning"]{--ak-part:var(--ak-color-warning)}
+.ak-breakdown [data-tone="danger"]{--ak-part:var(--ak-color-danger)}
+.ak-breakdown-total{display:flex;flex-wrap:wrap;align-items:baseline;justify-content:space-between;gap:.25em 1em;margin:0}
+.ak-breakdown-total strong{font-family:var(--ak-font-heading);font-size:calc(var(--ak-font-size-base) * 1.6);font-weight:650;letter-spacing:-.02em;font-variant-numeric:tabular-nums;color:var(--ak-color-text)}
+.ak-breakdown-bar{display:flex;height:14px;border-radius:999px;overflow:hidden;background:color-mix(in srgb,var(--ak-color-text) 7%,transparent);print-color-adjust:exact;-webkit-print-color-adjust:exact}
+.ak-breakdown-seg{flex:none;box-sizing:border-box;height:100%;background-color:var(--ak-part);background-clip:padding-box}
+.ak-breakdown-seg + .ak-breakdown-seg{border-left:2px solid transparent}
+.ak-breakdown-seg[data-ak-pct="0"]{display:none}
+${steppedRules('.ak-breakdown-seg', 'data-ak-pct', 'width', 1)}
+.ak-breakdown [data-hatch] .ak-breakdown-swatch,.ak-breakdown-seg[data-hatch]{background-image:repeating-linear-gradient(135deg,transparent 0 3px,color-mix(in srgb,var(--ak-color-surface) 55%,transparent) 3px 5px)}
+.ak-breakdown-list{list-style:none;margin:0;padding:0}
+.ak-breakdown-list li{display:grid;grid-template-columns:auto minmax(0,1fr) auto 3.4em;align-items:baseline;gap:.75em;padding:.6em 0;border-bottom:var(--ak-border-width) solid var(--ak-color-border)}
+.ak-breakdown-list li:last-child{border-bottom:0}
+.ak-breakdown-swatch{align-self:center;width:.75em;height:.75em;border-radius:3px;background-color:var(--ak-part);print-color-adjust:exact;-webkit-print-color-adjust:exact}
+.ak-breakdown-label{overflow-wrap:anywhere}
+.ak-breakdown-value{font-variant-numeric:tabular-nums;text-align:right;font-weight:600}
+.ak-breakdown-share{font-family:var(--ak-font-mono);font-size:.8rem;font-variant-numeric:tabular-nums;text-align:right;color:var(--ak-color-text-muted)}`;
+const REFERENCES_CSS = `.ak-ref-list{margin:0;padding-left:2.4em;display:flex;flex-direction:column;gap:${UNIT(1.25)}}
+.ak-ref{padding-left:.35em;border-radius:var(--ak-radius-small);scroll-margin-top:${UNIT(4)};${TRANSITION}}
+.ak-ref::marker{font-family:var(--ak-font-mono);font-size:.8rem;color:var(--ak-color-text-muted)}
+.ak-ref p{margin:0}
+.ak-ref-title cite{font-style:normal;font-weight:600;color:var(--ak-color-text);overflow-wrap:anywhere}
+.ak-ref .ak-ref-meta{margin-top:.2em;font-size:.84rem;color:var(--ak-color-text-muted);overflow-wrap:anywhere}
+.ak-ref .ak-ref-note{margin-top:.3em;font-size:.92rem;color:var(--ak-color-text-muted);max-width:var(--ak-measure)}
+.ak-ref:target{background:var(--ak-tint);box-shadow:0 0 0 ${UNIT(0.75)} var(--ak-tint)}
+@media print{.ak-ref-title a[href^="http"]::after{content:" <" attr(href) ">";font-weight:400;font-size:.84em;overflow-wrap:anywhere}.ak-ref{break-inside:avoid}.ak-ref:target{background:none;box-shadow:none}}`;
+export const EVIDENCE_CSS = [BENCHMARK_CSS, BREAKDOWN_CSS, REFERENCES_CSS].join('\n');
+const PIN = `display:grid;place-items:center;width:26px;height:26px;border-radius:50%;background:var(--ak-color-accent);color:var(--ak-color-accent-contrast);font-family:var(--ak-font-mono);font-size:.74rem;font-weight:700;line-height:1;font-variant-numeric:tabular-nums;print-color-adjust:exact;-webkit-print-color-adjust:exact`;
+export const ANNOTATED_IMAGE_CSS = `.ak-annotated{display:flex;flex-direction:column;gap:${UNIT(1.5)}}
+.ak-annotated-stage{position:relative;align-self:flex-start;max-width:100%;overflow:hidden;border:var(--ak-border-width) solid var(--ak-color-border);border-radius:var(--ak-radius-medium);background:var(--ak-color-surface-raised);box-shadow:var(--ak-elevation-card)}
+.ak-annotated-stage img{display:block;max-width:100%;height:auto}
+.ak-annotated-blocked{display:block;padding:${UNIT(2.5)}}
+.ak-annotated-pins{position:absolute;inset:0;list-style:none;margin:0;padding:0;pointer-events:none}
+.ak-pin{position:absolute;translate:-50% -50%;${PIN};box-shadow:0 0 0 2px var(--ak-color-accent-contrast),0 4px 12px color-mix(in srgb,var(--ak-color-text) 32%,transparent)}
+${steppedRules('.ak-pin', 'data-x', 'left', PIN_STEP)}
+${steppedRules('.ak-pin', 'data-y', 'top', PIN_STEP)}
+.ak-annotated figcaption{font-size:.84rem;color:var(--ak-color-text-muted)}
+.ak-annotated-notes{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:${UNIT(1)}}
+.ak-annotated-notes li{display:flex;align-items:flex-start;gap:.75em}
+.ak-pin-number{flex:none;${PIN};width:22px;height:22px;font-size:.68rem;margin-top:.1em}
+.ak-annotated-notes p{margin:0;min-width:0;overflow-wrap:anywhere;max-width:var(--ak-measure)}
+.ak-annotated-notes strong{font-weight:600;color:var(--ak-color-text)}
+@media (max-width:480px){.ak-pin{width:22px;height:22px;font-size:.66rem}}
+@media print{.ak-annotated-stage{box-shadow:none;break-inside:avoid}.ak-annotated-notes li{break-inside:avoid}}`;
+//# sourceMappingURL=evidence-styles.js.map

package/dist/blocks/evidence/evidence-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-styles.js","sourceRoot":"","sources":["../../../src/blocks/evidence/evidence-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,UAAU,GACd,gJAAgJ,CAAC;AAEnJ,wFAAwF;AACxF,SAAS,YAAY,CAAC,QAAgB,EAAE,SAAiB,EAAE,QAAgB,EAAE,IAAY;IACvF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,GAAG,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,SAAS,KAAK,KAAK,MAAM,QAAQ,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,aAAa,GAAG,oDAAoD,IAAI,CAAC,GAAG,CAAC;;;;;iDAKlC,UAAU;;;;;sGAK2C,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,GAAG,CAAC;;qBAEvI,UAAU;;mSAEoQ,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,iTAAiT,UAAU,wDAAwD,CAAC;AAE1sB,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAC5B,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,+BAA+B,KAAK,0BAA0B,KAAK,IAAI,CACtF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,aAAa,GAAG,wDAAwD,IAAI,CAAC,GAAG,CAAC;;EAErF,YAAY;;;;;;;;;;;;EAYZ,YAAY,CAAC,mBAAmB,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;;;;;;;;yJAQ2F,CAAC;AAE1J,MAAM,cAAc,GAAG,mFAAmF,IAAI,CAAC,IAAI,CAAC;oFAChC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU;;;;;;4DAM7C,IAAI,CAAC,IAAI,CAAC;iNAC2I,CAAC;AAElN,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEtF,MAAM,GAAG,GAAG,6TAA6T,CAAC;AAE1U,MAAM,CAAC,MAAM,mBAAmB,GAAG,wDAAwD,IAAI,CAAC,GAAG,CAAC;;;8CAGtD,IAAI,CAAC,GAAG,CAAC;;gDAEP,GAAG;EACjD,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;EACnD,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC;;gGAE4C,IAAI,CAAC,CAAC,CAAC;;2BAE5E,GAAG;;;;gHAIkF,CAAC"}

package/dist/blocks/evidence/index.d.ts

@@ -0,0 +1,4 @@
+/** Evidence widgets: measured comparisons, breakdowns, annotated captures and sources. */
+import type { BlockGroup } from '../../registry/block-module.js';
+export declare const EVIDENCE_GROUP: BlockGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/evidence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/evidence/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAOjE,eAAO,MAAM,cAAc,EAAE,UAO5B,CAAC"}

package/dist/blocks/evidence/index.js

@@ -0,0 +1,15 @@
+/** Evidence widgets: measured comparisons, breakdowns, annotated captures and sources. */
+import { annotatedImageBlock } from './annotated-image.js';
+import { benchmarkComparisonBlock } from './benchmark-comparison.js';
+import { ANNOTATED_IMAGE_CSS, EVIDENCE_CSS } from './evidence-styles.js';
+import { metricBreakdownBlock } from './metric-breakdown.js';
+import { referencesBlock } from './references.js';
+export const EVIDENCE_GROUP = {
+    name: 'evidence',
+    blocks: [benchmarkComparisonBlock, metricBreakdownBlock, annotatedImageBlock, referencesBlock],
+    features: [
+        { name: 'evidence', marker: '.ak-bench', css: EVIDENCE_CSS },
+        { name: 'annotated-image', marker: '.ak-annotated', css: ANNOTATED_IMAGE_CSS },
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/blocks/evidence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/blocks/evidence/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAG1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,CAAC,wBAAwB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,eAAe,CAAC;IAC9F,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE;QAC5D,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,mBAAmB,EAAE;KAC/E;CACF,CAAC"}

package/dist/blocks/evidence/metric-breakdown.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Metric breakdown: how a total splits into parts. A stacked bar shows the
+ * shares at a glance and a list states each part's value and share, so the
+ * list alone carries everything the bar shows.
+ */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const BREAKDOWN_LIMITS: {
+    readonly minParts: 2;
+    readonly maxParts: 12;
+};
+export declare const PART_TONES: readonly ["neutral", "info", "success", "warning", "danger"];
+/** Distinct series colours before the bar repeats them with a hatch. */
+export declare const BREAKDOWN_SERIES = 6;
+/**
+ * Whole-percent shares of `denominator` that never sum past what the parts
+ * cover: each share is floored, then the points left over go to the largest
+ * remainders (earlier parts win ties), so the bar and the list always agree
+ * and the bar never overflows.
+ */
+export declare function quantizeShares(values: readonly number[], denominator: number): number[];
+export declare const metricBreakdownBlock: BlockModule;
+//# sourceMappingURL=metric-breakdown.d.ts.map

package/dist/blocks/evidence/metric-breakdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-breakdown.d.ts","sourceRoot":"","sources":["../../../src/blocks/evidence/metric-breakdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,gCAAgC,CAAC;AA6BhF,eAAO,MAAM,gBAAgB;;;CAAyC,CAAC;AACvE,eAAO,MAAM,UAAU,8DAA+D,CAAC;AACvF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAUlC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAevF;AA0JD,eAAO,MAAM,oBAAoB,EAAE,WA2ClC,CAAC"}

package/dist/blocks/evidence/metric-breakdown.js

@@ -0,0 +1,203 @@
+/**
+ * Metric breakdown: how a total splits into parts. A stacked bar shows the
+ * shares at a glance and a list states each part's value and share, so the
+ * list alone carries everything the bar shows.
+ */
+import { FORMAT_FIELDS } from '../../data/format-value.js';
+import { pathIndex, pathKey } from '../../diagnostics.js';
+import { isPlainObject } from '../../json.js';
+import { anchorProps, enumStr, LABEL, list, num, OPTIONAL_TITLE, obj, semantic, str as strProp, } from '../../registry/define-helpers.js';
+import { element, nodeAttributes, objectListProp, str, titleHeader, } from '../../render/block-helpers.js';
+import { escapeText } from '../../render/escape.js';
+import { checkFieldMap, dataBindingFailed, fieldMap, formatMeasure, formatSpecOf, projectRow, } from './evidence-helpers.js';
+export const BREAKDOWN_LIMITS = { minParts: 2, maxParts: 12 };
+export const PART_TONES = ['neutral', 'info', 'success', 'warning', 'danger'];
+/** Distinct series colours before the bar repeats them with a hatch. */
+export const BREAKDOWN_SERIES = 6;
+const DATA_FIELDS = { label: 'label', value: 'value' };
+/**
+ * Whole-percent shares of `denominator` that never sum past what the parts
+ * cover: each share is floored, then the points left over go to the largest
+ * remainders (earlier parts win ties), so the bar and the list always agree
+ * and the bar never overflows.
+ */
+export function quantizeShares(values, denominator) {
+    if (denominator <= 0)
+        return values.map(() => 0);
+    const exact = values.map((value) => (Math.max(value, 0) / denominator) * 100);
+    const floors = exact.map((share) => Math.floor(share));
+    const covered = exact.reduce((sum, share) => sum + share, 0);
+    let spare = Math.min(100, Math.round(covered)) - floors.reduce((sum, share) => sum + share, 0);
+    const order = exact
+        .map((share, index) => ({ index, remainder: share - Math.floor(share) }))
+        .sort((a, b) => b.remainder - a.remainder || a.index - b.index);
+    for (const { index } of order) {
+        if (spare <= 0)
+            break;
+        floors[index] = (floors[index] ?? 0) + 1;
+        spare -= 1;
+    }
+    return floors;
+}
+function isMeasure(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+function readParts(node) {
+    if (node.data === undefined) {
+        return objectListProp(node, 'parts').flatMap((item) => isMeasure(item.value) && item.value >= 0
+            ? [{ label: str(item.label), value: item.value, tone: str(item.tone) }]
+            : []);
+    }
+    const map = fieldMap(node, DATA_FIELDS);
+    return node.data.rows.slice(0, BREAKDOWN_LIMITS.maxParts).flatMap((row) => {
+        const value = projectRow(row, map);
+        if (!isMeasure(value.value) || value.value < 0)
+            return [];
+        return [
+            { label: value.label === null ? '' : String(value.label), value: value.value, tone: '' },
+        ];
+    });
+}
+function authoredTotal(node) {
+    const total = node.props.total;
+    if (!isPlainObject(total) || !isMeasure(total.value))
+        return undefined;
+    return { label: str(total.label), value: total.value };
+}
+function checkData(node, { bag }) {
+    const data = node.data;
+    if (data === undefined)
+        return;
+    const map = fieldMap(node, DATA_FIELDS);
+    if (!checkFieldMap(node, data, map, [], bag))
+        return;
+    const path = pathKey(node.path, data.source === null ? 'data' : 'dataRef');
+    if (data.rows.length < BREAKDOWN_LIMITS.minParts ||
+        data.rows.length > BREAKDOWN_LIMITS.maxParts) {
+        bag.add({
+            code: data.rows.length > BREAKDOWN_LIMITS.maxParts
+                ? 'SPEC_BOUNDS_ERROR'
+                : 'SPEC_VALIDATION_ERROR',
+            path,
+            nodeId: node.id,
+            message: `metric-breakdown has ${data.rows.length} rows; it takes ${BREAKDOWN_LIMITS.minParts}-${BREAKDOWN_LIMITS.maxParts} parts`,
+        });
+    }
+    data.rows.forEach((row, index) => {
+        const value = projectRow(row, map).value;
+        if (isMeasure(value) && value >= 0)
+            return;
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path: pathKey(pathKey(node.path, 'fields'), 'value'),
+            nodeId: node.id,
+            message: `row ${index}: value field "${map.value}" must hold a non-negative number`,
+            details: { row: index, field: map.value },
+        });
+    });
+}
+function check(node, context) {
+    const { bag } = context;
+    const parts = objectListProp(node, 'parts');
+    if (node.data !== undefined && parts.length > 0) {
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path: pathKey(node.path, 'parts'),
+            nodeId: node.id,
+            message: 'use either parts or bound data (dataRef/data), not both',
+        });
+        return;
+    }
+    if (node.data === undefined && parts.length === 0) {
+        if (dataBindingFailed(node, bag))
+            return;
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path: pathKey(node.path, 'parts'),
+            nodeId: node.id,
+            message: 'metric-breakdown needs parts, or dataRef/data with fields',
+        });
+        return;
+    }
+    parts.forEach((part, index) => {
+        if (!isMeasure(part.value) || part.value >= 0)
+            return;
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path: pathKey(pathIndex(pathKey(node.path, 'parts'), index), 'value'),
+            nodeId: node.id,
+            message: 'a part value must not be negative',
+        });
+    });
+    checkData(node, context);
+    const total = authoredTotal(node);
+    if (total === undefined)
+        return;
+    const sum = readParts(node).reduce((acc, part) => acc + part.value, 0);
+    if (sum > total.value) {
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            severity: 'warning',
+            path: pathKey(pathKey(node.path, 'total'), 'value'),
+            nodeId: node.id,
+            message: `the parts sum to ${sum}, more than the total ${total.value}; shares use the sum`,
+            details: { sum, total: total.value },
+        });
+    }
+}
+function render(node) {
+    const format = formatSpecOf(node.props);
+    const parts = readParts(node);
+    const sum = parts.reduce((acc, part) => acc + part.value, 0);
+    const authored = authoredTotal(node);
+    const total = authored ?? { label: 'Total', value: sum };
+    const shares = quantizeShares(parts.map((part) => part.value), Math.max(total.value, sum));
+    const attributes = (part, index) => `data-series="${index % BREAKDOWN_SERIES}"${index >= BREAKDOWN_SERIES ? ' data-hatch' : ''}${part.tone === '' ? '' : ` data-tone="${part.tone}"`}`;
+    const bar = `<div class="ak-breakdown-bar" aria-hidden="true">${parts
+        .map((part, index) => `<span class="ak-breakdown-seg" data-ak-pct="${shares[index] ?? 0}" ${attributes(part, index)}></span>`)
+        .join('')}</div>`;
+    const items = parts
+        .map((part, index) => `<li ${attributes(part, index)}><span class="ak-breakdown-swatch" aria-hidden="true"></span><span class="ak-breakdown-label">${escapeText(part.label)}</span><span class="ak-breakdown-value">${escapeText(formatMeasure(part.value, format))}</span><span class="ak-breakdown-share">${shares[index] ?? 0}%</span></li>`)
+        .join('');
+    return element('section', nodeAttributes(node, { class: 'ak-block ak-breakdown' }), [
+        titleHeader(node),
+        `<p class="ak-breakdown-total"><span class="ak-label">${escapeText(total.label)}</span><strong>${escapeText(formatMeasure(total.value, format))}</strong></p>`,
+        bar,
+        `<ol class="ak-breakdown-list">${items}</ol>`,
+    ].join(''));
+}
+export const metricBreakdownBlock = {
+    definition: semantic({
+        type: 'metric-breakdown',
+        category: 'data',
+        tags: ['share', 'composition', 'stacked-bar', 'budget', 'evidence'],
+        useCases: ['cost breakdown', 'latency budget', 'share of total'],
+        purpose: 'A total split into parts, as a stacked bar plus a list with shares.',
+        summary: 'Metric breakdown: parts of a total as a stacked bar and a list with value and share %.',
+        props: {
+            title: OPTIONAL_TITLE,
+            total: obj({ label: LABEL, value: num({ required: true, min: 0 }) }, { description: 'Omit to use the sum of the parts.' }),
+            parts: list(obj({
+                label: LABEL,
+                value: num({ required: true, min: 0 }),
+                tone: enumStr(PART_TONES, { description: 'Status colour instead of a series colour.' }),
+            }), {
+                minItems: BREAKDOWN_LIMITS.minParts,
+                maxItems: BREAKDOWN_LIMITS.maxParts,
+                description: 'Omit when the rows come from dataRef or data.',
+            }),
+            fields: obj({
+                label: strProp({ maxLength: 64, default: DATA_FIELDS.label }),
+                value: strProp({ maxLength: 64, default: DATA_FIELDS.value }),
+            }, { description: 'Data fields for the part label and value.' }),
+            ...FORMAT_FIELDS,
+            ...anchorProps,
+        },
+        data: { required: false, description: 'Rows with a label and a non-negative value field.' },
+        runtimeFeatures: ['evidence'],
+        a11y: 'The bar is decorative; the list states every part, its value and its share in text.',
+    }),
+    render,
+    check,
+};
+//# sourceMappingURL=metric-breakdown.js.map

package/dist/blocks/evidence/metric-breakdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-breakdown.js","sourceRoot":"","sources":["../../../src/blocks/evidence/metric-breakdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAkB,MAAM,eAAe,CAAC;AAE9D,OAAO,EACL,WAAW,EACX,OAAO,EACP,KAAK,EACL,IAAI,EACJ,GAAG,EACH,cAAc,EACd,GAAG,EACH,QAAQ,EACR,GAAG,IAAI,OAAO,GACf,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,OAAO,EACP,cAAc,EACd,cAAc,EACd,GAAG,EACH,WAAW,GACZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAW,CAAC;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AACvF,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAW,CAAC;AAQhE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,EAAE,WAAmB;IAC3E,IAAI,WAAW,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7D,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,KAAK;SAChB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACxE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAClE,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;QAC9B,IAAI,KAAK,IAAI,CAAC;YAAE,MAAM;QACtB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACzC,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAA4B;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACpD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC;YACtC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvE,CAAC,CAAC,EAAE,CACP,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACxE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1D,OAAO;YACL,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;SACzF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC/B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,EAAE,GAAG,EAAgB;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACxC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC;QAAE,OAAO;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3E,IACE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,QAAQ;QAC5C,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAC5C,CAAC;QACD,GAAG,CAAC,GAAG,CAAC;YACN,IAAI,EACF,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,QAAQ;gBAC1C,CAAC,CAAC,mBAAmB;gBACrB,CAAC,CAAC,uBAAuB;YAC7B,IAAI;YACJ,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,wBAAwB,IAAI,CAAC,IAAI,CAAC,MAAM,mBAAmB,gBAAgB,CAAC,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,QAAQ;SACnI,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC;QACzC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO;QAC3C,GAAG,CAAC,GAAG,CAAC;YACN,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YACpD,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,OAAO,KAAK,kBAAkB,GAAG,CAAC,KAAK,mCAAmC;YACnF,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,IAAY,EAAE,OAAqB;IAChD,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACxB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,GAAG,CAAC;YACN,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,yDAAyD;SACnE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO;QACzC,GAAG,CAAC,GAAG,CAAC;YACN,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,2DAA2D;SACrE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC;YAAE,OAAO;QACtD,GAAG,CAAC,GAAG,CAAC;YACN,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC;YACrE,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,mCAAmC;SAC7C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAChC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvE,IAAI,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QACtB,GAAG,CAAC,GAAG,CAAC;YACN,IAAI,EAAE,uBAAuB;YAC7B,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC;YACnD,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,oBAAoB,GAAG,yBAAyB,KAAK,CAAC,KAAK,sBAAsB;YAC1F,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,QAAQ,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACzD,MAAM,MAAM,GAAG,cAAc,CAC3B,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAC/B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAC3B,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,KAAa,EAAU,EAAE,CACvD,gBAAgB,KAAK,GAAG,gBAAgB,IAAI,KAAK,IAAI,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GACxF,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,IAAI,GAClD,EAAE,CAAC;IACL,MAAM,GAAG,GAAG,oDAAoD,KAAK;SAClE,GAAG,CACF,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,+CAA+C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAC1G;SACA,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC;IACpB,MAAM,KAAK,GAAG,KAAK;SAChB,GAAG,CACF,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,iGAAiG,UAAU,CACvI,IAAI,CAAC,KAAK,CACX,2CAA2C,UAAU,CACpD,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAClC,2CAA2C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAChF;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,OAAO,CACZ,SAAS,EACT,cAAc,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,EACxD;QACE,WAAW,CAAC,IAAI,CAAC;QACjB,wDAAwD,UAAU,CAChE,KAAK,CAAC,KAAK,CACZ,kBAAkB,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,eAAe;QAChF,GAAG;QACH,iCAAiC,KAAK,OAAO;KAC9C,CAAC,IAAI,CAAC,EAAE,CAAC,CACX,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,UAAU,EAAE,QAAQ,CAAC;QACnB,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC;QACnE,QAAQ,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;QAChE,OAAO,EAAE,qEAAqE;QAC9E,OAAO,EACL,wFAAwF;QAC1F,KAAK,EAAE;YACL,KAAK,EAAE,cAAc;YACrB,KAAK,EAAE,GAAG,CACR,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EACxD,EAAE,WAAW,EAAE,mCAAmC,EAAE,CACrD;YACD,KAAK,EAAE,IAAI,CACT,GAAG,CAAC;gBACF,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;gBACtC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;aACxF,CAAC,EACF;gBACE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;gBACnC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;gBACnC,WAAW,EAAE,+CAA+C;aAC7D,CACF;YACD,MAAM,EAAE,GAAG,CACT;gBACE,KAAK,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC;gBAC7D,KAAK,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC;aAC9D,EACD,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAC7D;YACD,GAAG,aAAa;YAChB,GAAG,WAAW;SACf;QACD,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAC3F,eAAe,EAAE,CAAC,UAAU,CAAC;QAC7B,IAAI,EAAE,qFAAqF;KAC5F,CAAC;IACF,MAAM;IACN,KAAK;CACN,CAAC"}

package/dist/blocks/evidence/references.d.ts

@@ -0,0 +1,13 @@
+/**
+ * References: a numbered source list with a stable anchor per entry, so any
+ * link on the page can point at `#ref-<id>`. Links are emitted as plain
+ * anchors; the compiler never fetches them.
+ */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const REFERENCE_LIMITS: {
+    readonly maxItems: 60;
+};
+/** The element id of a reference entry: the anchor other text links to. */
+export declare function referenceAnchor(id: string): string;
+export declare const referencesBlock: BlockModule;
+//# sourceMappingURL=references.d.ts.map

package/dist/blocks/evidence/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../src/blocks/evidence/references.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,gCAAgC,CAAC;AAsBhF,eAAO,MAAM,gBAAgB;;CAA4B,CAAC;AAE1D,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAmED,eAAO,MAAM,eAAe,EAAE,WA8B7B,CAAC"}

package/dist/blocks/evidence/references.js

@@ -0,0 +1,103 @@
+/**
+ * References: a numbered source list with a stable anchor per entry, so any
+ * link on the page can point at `#ref-<id>`. Links are emitted as plain
+ * anchors; the compiler never fetches them.
+ */
+import { pathIndex, pathKey } from '../../diagnostics.js';
+import { anchorProps, idProp, itemsOf, LABEL, num, OPTIONAL_TITLE, semantic, str as strProp, txt, urlProp, } from '../../registry/define-helpers.js';
+import { element, nodeAttributes, objectListProp, str, titleHeader, } from '../../render/block-helpers.js';
+import { escapeAttribute, escapeInlineText, escapeText, escapeUrl } from '../../render/escape.js';
+export const REFERENCE_LIMITS = { maxItems: 60 };
+/** The element id of a reference entry: the anchor other text links to. */
+export function referenceAnchor(id) {
+    return `ref-${id}`;
+}
+function referenceIds(node) {
+    return objectListProp(node, 'items').map((item) => str(item.id));
+}
+/**
+ * Entry ids must be unique across every references block on the page, because
+ * each becomes a document-level anchor. The first occurrence wins; each later
+ * one is reported where it is written.
+ */
+function check(node, { bag, byId }) {
+    const seen = new Map();
+    for (const other of byId.values()) {
+        if (other === node)
+            break;
+        if (other.type !== 'references')
+            continue;
+        for (const id of referenceIds(other))
+            if (!seen.has(id))
+                seen.set(id, other.id);
+    }
+    referenceIds(node).forEach((id, index) => {
+        if (id === '')
+            return;
+        const owner = seen.get(id);
+        if (owner !== undefined) {
+            bag.add({
+                code: 'SPEC_VALIDATION_ERROR',
+                path: pathKey(pathIndex(pathKey(node.path, 'items'), index), 'id'),
+                nodeId: node.id,
+                message: `reference id "${id}" is already used${owner === node.id ? ' in this list' : ` by block "${owner}"`}; anchors must be unique`,
+                details: { id, anchor: referenceAnchor(id) },
+            });
+            return;
+        }
+        seen.set(id, node.id);
+    });
+}
+function entry(item) {
+    const title = escapeText(str(item.title));
+    const href = str(item.href);
+    const heading = href === ''
+        ? `<cite>${title}</cite>`
+        : `<cite><a href="${escapeAttribute(escapeUrl(href))}" rel="noreferrer noopener">${title}</a></cite>`;
+    const meta = [
+        str(item.authors),
+        str(item.source),
+        typeof item.year === 'number' ? String(item.year) : '',
+    ].filter((part) => part !== '');
+    const note = str(item.note);
+    return [
+        `<li id="${escapeAttribute(referenceAnchor(str(item.id)))}" class="ak-ref">`,
+        `<p class="ak-ref-title">${heading}</p>`,
+        meta.length === 0 ? '' : `<p class="ak-ref-meta">${escapeText(meta.join(' · '))}</p>`,
+        note === '' ? '' : `<p class="ak-ref-note">${escapeInlineText(note)}</p>`,
+        '</li>',
+    ].join('');
+}
+function render(node) {
+    return element('section', nodeAttributes(node, { class: 'ak-block ak-refs' }), `${titleHeader(node)}<ol class="ak-ref-list">${objectListProp(node, 'items')
+        .map(entry)
+        .join('')}</ol>`);
+}
+export const referencesBlock = {
+    definition: semantic({
+        type: 'references',
+        category: 'content',
+        tags: ['citations', 'sources', 'bibliography', 'evidence'],
+        useCases: ['research report sources', 'benchmark evidence'],
+        purpose: 'Numbered sources with stable anchors (#ref-<id>).',
+        summary: 'References: numbered citations with title, authors, source, year, link and note; anchor #ref-<id>.',
+        props: {
+            title: OPTIONAL_TITLE,
+            items: itemsOf({
+                id: { ...idProp('Anchor id; the entry is reachable at #ref-<id>.'), required: true },
+                title: LABEL,
+                href: urlProp({ description: 'Link to the source; never fetched.' }),
+                authors: strProp({ maxLength: 200 }),
+                source: strProp({ maxLength: 200, description: 'Publisher, venue or site.' }),
+                year: num({ integer: true, min: 1, max: 9999 }),
+                note: txt({ maxLength: 600 }),
+            }, { maxItems: REFERENCE_LIMITS.maxItems }),
+            ...anchorProps,
+        },
+        runtimeFeatures: ['evidence'],
+        a11y: 'An ordered list of <cite> titles; each entry has a stable id, so in-page links land on it.',
+    }),
+    render,
+    check,
+};
+//# sourceMappingURL=references.js.map

package/dist/blocks/evidence/references.js.map

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

package/dist/blocks/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Block groups, in their fixed registration order. The order decides where a
+ * group's blocks appear in the catalog and where its feature CSS and runtime
+ * parts are emitted, so it never depends on discovery.
+ */
+import type { BlockGroup } from '../registry/block-module.js';
+export declare const BLOCK_GROUPS: readonly BlockGroup[];
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAU9D,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAS7C,CAAC"}

package/dist/blocks/index.js

@@ -0,0 +1,24 @@
+/**
+ * Block groups, in their fixed registration order. The order decides where a
+ * group's blocks appear in the catalog and where its feature CSS and runtime
+ * parts are emitted, so it never depends on discovery.
+ */
+import { CHART_GROUP } from './chart/index.js';
+import { COMPOSITION_GROUP } from './composition/index.js';
+import { CONTROLS_GROUP } from './controls/index.js';
+import { DATA_TABLE_GROUP } from './data-table/index.js';
+import { ENGINEERING_GROUP } from './engineering/index.js';
+import { EVIDENCE_GROUP } from './evidence/index.js';
+import { LAYOUT_GROUP } from './layout/index.js';
+import { PRODUCT_GROUP } from './product/index.js';
+export const BLOCK_GROUPS = [
+    COMPOSITION_GROUP,
+    LAYOUT_GROUP,
+    DATA_TABLE_GROUP,
+    CHART_GROUP,
+    ENGINEERING_GROUP,
+    EVIDENCE_GROUP,
+    PRODUCT_GROUP,
+    CONTROLS_GROUP,
+];
+//# sourceMappingURL=index.js.map

package/dist/blocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,iBAAiB;IACjB,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,iBAAiB;IACjB,cAAc;IACd,aAAa;IACb,cAAc;CACf,CAAC"}

package/dist/blocks/layout/grid-item.d.ts

@@ -0,0 +1,4 @@
+/** Grid item block: explicit placement of child blocks inside a 12-track grid. */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const gridItemBlock: BlockModule;
+//# sourceMappingURL=grid-item.d.ts.map

package/dist/blocks/layout/grid-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-item.d.ts","sourceRoot":"","sources":["../../../src/blocks/layout/grid-item.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAGlF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAalE,eAAO,MAAM,aAAa,EAAE,WAyD3B,CAAC"}

package/dist/blocks/layout/grid-item.js

@@ -0,0 +1,65 @@
+/** Grid item block: explicit placement of child blocks inside a 12-track grid. */
+import { pathKey } from '../../diagnostics.js';
+import { define, enumStr, num } from '../../registry/define-helpers.js';
+import { element, nodeAttributes } from '../../render/block-helpers.js';
+import { defaultTrackSpan } from './grid.js';
+import { GRID_TRACKS, LAYOUT_TRACKS_FEATURE } from './layout-styles.js';
+const track = (description) => num({ integer: true, min: 1, max: GRID_TRACKS, description });
+/** An integer prop as an attribute value, or undefined when unset. */
+const attribute = (value) => typeof value === 'number' ? String(value) : undefined;
+export const gridItemBlock = {
+    definition: define({
+        type: 'grid-item',
+        category: 'layout',
+        tags: ['span', 'columns', 'responsive', 'dashboard'],
+        useCases: ['8/4 dashboard split', 'wide chart beside a narrow list'],
+        parents: ['grid'],
+        purpose: 'Places its child blocks across tracks of a 12-track grid.',
+        summary: 'Grid item: spans 1–12 tracks of its grid, with tablet and mobile spans.',
+        runtimeFeatures: [LAYOUT_TRACKS_FEATURE],
+        props: {
+            span: track('Tracks of 12 to span. Default 12 / the grid columns.'),
+            tabletSpan: track('Span at 768px and below. Default: span.'),
+            mobileSpan: track('Span at 480px and below. Default 12 (full width).'),
+            rowSpan: num({
+                integer: true,
+                min: 1,
+                max: 4,
+                description: 'Rows to span; wide screens only.',
+            }),
+            start: track('First track; wide screens only.'),
+            align: enumStr(['start', 'center', 'end', 'stretch']),
+        },
+        slots: { children: { accepts: '*', min: 1, max: 40 } },
+    }),
+    render: (node, context) => {
+        const parent = node.parentId === null ? undefined : context.byId(node.parentId);
+        const span = typeof node.props.span === 'number' ? node.props.span : defaultTrackSpan(parent);
+        return element('div', nodeAttributes(node, {
+            class: 'ak-block ak-grid-item',
+            'data-ak-span': String(span),
+            'data-ak-tablet-span': attribute(node.props.tabletSpan),
+            'data-ak-mobile-span': attribute(node.props.mobileSpan),
+            'data-ak-row-span': attribute(node.props.rowSpan),
+            'data-ak-start': attribute(node.props.start),
+            'data-align': typeof node.props.align === 'string' ? node.props.align : undefined,
+        }), context.renderChildren(node));
+    },
+    check: (node, { bag, byId }) => {
+        const start = node.props.start;
+        if (typeof start !== 'number')
+            return;
+        const parent = node.parentId === null ? undefined : byId.get(node.parentId);
+        const span = typeof node.props.span === 'number' ? node.props.span : defaultTrackSpan(parent);
+        if (start + span - 1 > GRID_TRACKS) {
+            bag.add({
+                code: 'SPEC_VALIDATION_ERROR',
+                path: pathKey(node.path, 'start'),
+                nodeId: node.id,
+                message: `"start: ${start}" with a span of ${span} runs past track ${GRID_TRACKS}`,
+                details: { start, span, maxStart: GRID_TRACKS - span + 1 },
+            });
+        }
+    },
+};
+//# sourceMappingURL=grid-item.js.map