@bestagentkits/render 0.2.0 → 0.3.0

package/dist/blocks/engineering/roadmap.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Roadmap block: items placed on an ordered period grid, one row group per lane.
+ *
+ * Placement is static markup: each item carries `data-ak-start`/`data-ak-end`
+ * period indexes that the feature sheet maps to grid columns (1-24), so the
+ * output has no inline style. Phones and print get an agenda grouped by start
+ * period instead of the grid. There is no "today" marker: it would depend on
+ * the clock and break determinism.
+ */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const ROADMAP_MAX_PERIODS = 24;
+export declare const roadmapBlock: BlockModule;
+//# sourceMappingURL=roadmap.d.ts.map

package/dist/blocks/engineering/roadmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../../src/blocks/engineering/roadmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAuBlE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AA6LtC,eAAO,MAAM,YAAY,EAAE,WA8C1B,CAAC"}

package/dist/blocks/engineering/roadmap.js

@@ -0,0 +1,197 @@
+/**
+ * Roadmap block: items placed on an ordered period grid, one row group per lane.
+ *
+ * Placement is static markup: each item carries `data-ak-start`/`data-ak-end`
+ * period indexes that the feature sheet maps to grid columns (1-24), so the
+ * output has no inline style. Phones and print get an agenda grouped by start
+ * period instead of the grid. There is no "today" marker: it would depend on
+ * the clock and break determinism.
+ */
+import { pathIndex, pathKey } from '../../diagnostics.js';
+import { anchorProps, define, enumStr, itemsOf, LABEL, list, OPTIONAL_TITLE, obj, str as strProp, } from '../../registry/define-helpers.js';
+import { element, listProp, nodeAttributes, objectListProp, str, stringProp, titleHeader, } from '../../render/block-helpers.js';
+import { escapeText, renderAttributes } from '../../render/escape.js';
+export const ROADMAP_MAX_PERIODS = 24;
+const STATUS_LABELS = {
+    planned: 'Planned',
+    active: 'In progress',
+    done: 'Done',
+    'at-risk': 'At risk',
+};
+const STATUSES = Object.keys(STATUS_LABELS);
+function roadmapItems(node, periods) {
+    return objectListProp(node, 'items').flatMap((item) => {
+        const start = periods.indexOf(str(item.start));
+        const endValue = str(item.end);
+        const end = endValue === '' ? start : periods.indexOf(endValue);
+        // A check has already reported an unknown or reversed range; skip it here.
+        if (start < 0 || end < start)
+            return [];
+        const status = str(item.status, 'planned');
+        return [
+            {
+                title: str(item.title),
+                lane: str(item.lane),
+                start,
+                end,
+                status: STATUSES.includes(status) ? status : 'planned',
+            },
+        ];
+    });
+}
+function range(item, periods) {
+    const first = periods[item.start] ?? '';
+    return item.end === item.start ? first : `${first} – ${periods[item.end] ?? ''}`;
+}
+function statusText(status) {
+    return `<span class="ak-roadmap-status">${escapeText(STATUS_LABELS[status] ?? status)}</span>`;
+}
+function gridItem(item, periods) {
+    return `<li${renderAttributes({
+        class: 'ak-roadmap-item',
+        'data-status': item.status,
+        'data-ak-start': item.start + 1,
+        'data-ak-end': item.end + 1,
+    })}><span class="ak-roadmap-item-title">${escapeText(item.title)}</span><span class="ak-roadmap-meta"><span class="ak-roadmap-when">${escapeText(range(item, periods))}</span>${statusText(item.status)}</span></li>`;
+}
+function renderRoadmap(node) {
+    const periods = listProp(node, 'periods').map((period) => str(period));
+    const lanes = objectListProp(node, 'lanes').map((lane) => ({
+        id: str(lane.id),
+        title: str(lane.title),
+    }));
+    const items = roadmapItems(node, periods);
+    const laneTitles = new Map(lanes.map((lane) => [lane.id, lane.title]));
+    const groups = lanes.length === 0 ? [{ id: '', title: '' }] : lanes;
+    const lanesMarkup = groups
+        .map((lane) => {
+        const inLane = items.filter((item) => item.lane === lane.id);
+        const head = lane.title === '' ? '' : `<h3 class="ak-roadmap-lane-title">${escapeText(lane.title)}</h3>`;
+        const body = inLane.length === 0
+            ? '<p class="ak-roadmap-empty">Nothing scheduled</p>'
+            : `<ol class="ak-roadmap-items">${inLane.map((item) => gridItem(item, periods)).join('')}</ol>`;
+        return `<div class="ak-roadmap-lane">${head}${body}</div>`;
+    })
+        .join('');
+    const agenda = periods
+        .map((period, index) => {
+        const starting = items.filter((item) => item.start === index);
+        if (starting.length === 0)
+            return '';
+        const entries = starting
+            .map((item) => {
+            const lane = laneTitles.get(item.lane) ?? '';
+            const until = item.end === item.start ? '' : `until ${periods[item.end] ?? ''}`;
+            const meta = [lane, until].filter((part) => part !== '').join(' · ');
+            return `<li${renderAttributes({ class: 'ak-roadmap-entry', 'data-status': item.status })}><span class="ak-roadmap-item-title">${escapeText(item.title)}</span><span class="ak-roadmap-meta">${meta === '' ? '' : `<span class="ak-roadmap-when">${escapeText(meta)}</span>`}${statusText(item.status)}</span></li>`;
+        })
+            .join('');
+        return `<li><h3 class="ak-roadmap-period">${escapeText(period)}</h3><ul>${entries}</ul></li>`;
+    })
+        .join('');
+    const title = stringProp(node, 'title');
+    const head = periods.map((period) => `<li>${escapeText(period)}</li>`).join('');
+    return element('section', nodeAttributes(node, { class: 'ak-block ak-roadmap-block' }), `${titleHeader(node)}<div${renderAttributes({
+        class: 'ak-roadmap',
+        role: 'region',
+        tabindex: 0,
+        'aria-label': title === '' ? 'Roadmap' : title,
+    })}><div class="ak-roadmap-grid" data-ak-cols="${periods.length}"><ol class="ak-roadmap-periods">${head}</ol>${lanesMarkup}</div></div><ol class="ak-roadmap-agenda">${agenda}</ol>`);
+}
+function reportDuplicates(values, path, noun, node, bag) {
+    const seen = new Set();
+    values.forEach((value, index) => {
+        if (seen.has(value)) {
+            bag.add({
+                code: 'SPEC_VALIDATION_ERROR',
+                path: path(index),
+                message: `${noun} "${value}" is listed twice`,
+                nodeId: node.id,
+            });
+        }
+        seen.add(value);
+    });
+}
+function checkRoadmap(node, bag) {
+    const periods = listProp(node, 'periods').map((period) => str(period));
+    const laneIds = objectListProp(node, 'lanes').map((lane) => str(lane.id));
+    reportDuplicates(periods, (index) => pathIndex(pathKey(node.path, 'periods'), index), 'period', node, bag);
+    reportDuplicates(laneIds, (index) => pathKey(pathIndex(pathKey(node.path, 'lanes'), index), 'id'), 'lane id', node, bag);
+    const items = node.props.items;
+    if (!Array.isArray(items))
+        return;
+    objectListProp(node, 'items').forEach((item, index) => {
+        const itemPath = pathIndex(pathKey(node.path, 'items'), index);
+        const error = (key, message, allowed) => bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path: pathKey(itemPath, key),
+            message,
+            details: { allowed: [...allowed] },
+            nodeId: node.id,
+        });
+        const start = periods.indexOf(str(item.start));
+        if (start < 0)
+            error('start', `"${str(item.start)}" is not one of the periods`, periods);
+        if (typeof item.end === 'string') {
+            const end = periods.indexOf(item.end);
+            if (end < 0)
+                error('end', `"${item.end}" is not one of the periods`, periods);
+            else if (start >= 0 && end < start) {
+                error('end', `ends at "${item.end}", before its start "${str(item.start)}"`, periods.slice(start));
+            }
+        }
+        const lane = typeof item.lane === 'string' ? item.lane : undefined;
+        if (laneIds.length === 0 && lane !== undefined) {
+            error('lane', `lane "${lane}" is set, but the roadmap declares no lanes`, []);
+        }
+        else if (laneIds.length > 0 && lane === undefined) {
+            error('lane', 'an item needs a lane when the roadmap declares lanes', laneIds);
+        }
+        else if (lane !== undefined && !laneIds.includes(lane)) {
+            error('lane', `"${lane}" is not a lane id`, laneIds);
+        }
+    });
+}
+export const roadmapBlock = {
+    definition: define({
+        type: 'roadmap',
+        kind: 'semantic',
+        category: 'engineering',
+        tags: ['timeline', 'gantt', 'plan', 'milestones'],
+        useCases: ['quarterly roadmap', 'release plan', 'project schedule'],
+        purpose: 'Plan over time: items spanning ordered periods, optionally split into lanes.',
+        summary: 'Roadmap: items spanning 2-24 ordered periods in up to 8 lanes, with planned/active/done/at-risk status.',
+        props: {
+            title: OPTIONAL_TITLE,
+            periods: list(strProp({ maxLength: 40 }), {
+                required: true,
+                minItems: 2,
+                maxItems: ROADMAP_MAX_PERIODS,
+                description: 'Ordered period labels, such as 2026-Q3.',
+            }),
+            lanes: list(obj({ id: strProp({ required: true, id: true }), title: LABEL }), {
+                maxItems: 8,
+            }),
+            items: itemsOf({
+                title: LABEL,
+                lane: strProp({ maxLength: 64, description: 'A lane id; required when lanes are set.' }),
+                start: strProp({ required: true, maxLength: 40, description: 'A period label.' }),
+                end: strProp({ maxLength: 40, description: 'A period label; defaults to start.' }),
+                status: enumStr(STATUSES, { default: 'planned' }),
+            }, { minItems: 1, maxItems: 40 }),
+            ...anchorProps,
+        },
+        runtimeFeatures: ['roadmap'],
+        sizing: {
+            sizes: ['large'],
+            default: 'large',
+            responsive: 'A period grid that scrolls sideways when the periods do not fit; at 560px and below, an agenda grouped by period.',
+        },
+        a11y: 'Each item states its title, period range and status in text; the grid is a labelled, focusable scroll region.',
+    }),
+    render: renderRoadmap,
+    check(node, { bag }) {
+        checkRoadmap(node, bag);
+    },
+};
+//# sourceMappingURL=roadmap.js.map

package/dist/blocks/engineering/roadmap.js.map

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

package/dist/blocks/engineering/schema-viewer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Schema-viewer block: a data shape drawn as a tree from dotted field paths.
+ *
+ * `user.address.city` nests under `user` and `user.address`. A parent the
+ * author did not list becomes an implicit object node. Children keep the
+ * authored order of their first mention, so the tree is deterministic. Nodes
+ * with children are native `<details>`, open by default, so the whole shape
+ * reads without script and in print.
+ */
+import type { BlockModule } from '../../registry/block-module.js';
+interface SchemaField {
+    type: string;
+    required: boolean;
+    description: string;
+}
+interface SchemaNode {
+    name: string;
+    field: SchemaField | undefined;
+    children: Map<string, SchemaNode>;
+}
+/** Build the tree from dotted paths; later duplicates and empty segments are skipped (a check reports them). */
+export declare function buildSchemaTree(fields: readonly Record<string, unknown>[]): SchemaNode;
+export declare const schemaViewerBlock: BlockModule;
+export {};
+//# sourceMappingURL=schema-viewer.d.ts.map

package/dist/blocks/engineering/schema-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-viewer.d.ts","sourceRoot":"","sources":["../../../src/blocks/engineering/schema-viewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAmBlE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACnC;AAMD,gHAAgH;AAChH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,UAAU,CAuBtF;AAsCD,eAAO,MAAM,iBAAiB,EAAE,WA6D/B,CAAC"}

package/dist/blocks/engineering/schema-viewer.js

@@ -0,0 +1,124 @@
+/**
+ * Schema-viewer block: a data shape drawn as a tree from dotted field paths.
+ *
+ * `user.address.city` nests under `user` and `user.address`. A parent the
+ * author did not list becomes an implicit object node. Children keep the
+ * authored order of their first mention, so the tree is deterministic. Nodes
+ * with children are native `<details>`, open by default, so the whole shape
+ * reads without script and in print.
+ */
+import { pathIndex, pathKey } from '../../diagnostics.js';
+import { anchorProps, bool, define, itemsOf, OPTIONAL_TITLE, str as strProp, txt, } from '../../registry/define-helpers.js';
+import { element, nodeAttributes, objectListProp, str, titleHeader, } from '../../render/block-helpers.js';
+import { escapeInlineText, escapeText } from '../../render/escape.js';
+function newNode(name) {
+    return { name, field: undefined, children: new Map() };
+}
+/** Build the tree from dotted paths; later duplicates and empty segments are skipped (a check reports them). */
+export function buildSchemaTree(fields) {
+    const root = newNode('');
+    for (const entry of fields) {
+        const path = typeof entry.path === 'string' ? entry.path : '';
+        const segments = path.split('.');
+        if (segments.some((segment) => segment === ''))
+            continue;
+        let cursor = root;
+        for (const segment of segments) {
+            let next = cursor.children.get(segment);
+            if (next === undefined) {
+                next = newNode(segment);
+                cursor.children.set(segment, next);
+            }
+            cursor = next;
+        }
+        if (cursor.field !== undefined)
+            continue;
+        cursor.field = {
+            type: typeof entry.type === 'string' ? entry.type : '',
+            required: entry.required === true,
+            description: typeof entry.description === 'string' ? entry.description : '',
+        };
+    }
+    return root;
+}
+function nodeLine(node) {
+    const field = node.field;
+    const type = field === undefined ? 'object' : field.type;
+    return `<span class="ak-schema-name">${escapeText(node.name)}</span><span${field === undefined ? ' class="ak-schema-type" data-implicit' : ' class="ak-schema-type"'}>${escapeText(type)}</span>${field?.required === true ? '<span class="ak-schema-required">required</span>' : ''}`;
+}
+function description(node) {
+    const text = node.field?.description ?? '';
+    return text === '' ? '' : `<p class="ak-schema-desc">${escapeInlineText(text)}</p>`;
+}
+function renderChildren(parent) {
+    const items = [...parent.children.values()].map((child) => {
+        if (child.children.size === 0) {
+            return `<li><div class="ak-schema-row">${nodeLine(child)}</div>${description(child)}</li>`;
+        }
+        return `<li><details open><summary class="ak-schema-row">${nodeLine(child)}</summary>${description(child)}${renderChildren(child)}</details></li>`;
+    });
+    return `<ul>${items.join('')}</ul>`;
+}
+function renderSchemaViewer(node) {
+    const tree = buildSchemaTree(objectListProp(node, 'fields'));
+    return element('section', nodeAttributes(node, { class: 'ak-block ak-schema-block' }), `${titleHeader(node)}<div class="ak-schema">${renderChildren(tree)}</div>`);
+}
+export const schemaViewerBlock = {
+    definition: define({
+        type: 'schema-viewer',
+        kind: 'semantic',
+        category: 'engineering',
+        tags: ['schema', 'data-model', 'fields', 'types'],
+        useCases: ['payload shape', 'config reference', 'data model review'],
+        purpose: 'Data shape reference: typed fields from dotted paths, drawn as a collapsible tree.',
+        summary: 'Schema viewer: up to 120 typed fields from dotted paths as a tree; missing parents become objects.',
+        props: {
+            title: OPTIONAL_TITLE,
+            fields: itemsOf({
+                path: strProp({
+                    required: true,
+                    maxLength: 200,
+                    description: 'Dotted path, such as user.email.',
+                }),
+                type: strProp({ required: true, maxLength: 60 }),
+                required: bool(),
+                description: txt({ maxLength: 400 }),
+            }, { minItems: 1, maxItems: 120 }),
+            ...anchorProps,
+        },
+        runtimeFeatures: ['schema-viewer'],
+        sizing: {
+            sizes: ['medium', 'large'],
+            default: 'medium',
+            responsive: 'Indentation stays narrow so deep paths fit a phone; long names and types wrap.',
+        },
+        a11y: 'Nested lists mirror the shape; branches are native disclosures that start open; required is text.',
+    }),
+    render: renderSchemaViewer,
+    check(node, { bag }) {
+        const seen = new Set();
+        objectListProp(node, 'fields').forEach((field, index) => {
+            const path = str(field.path);
+            const at = pathKey(pathIndex(pathKey(node.path, 'fields'), index), 'path');
+            if (path.split('.').some((segment) => segment === '')) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path: at,
+                    message: `"${path}" has an empty segment; use dotted names such as user.email`,
+                    nodeId: node.id,
+                });
+                return;
+            }
+            if (seen.has(path)) {
+                bag.add({
+                    code: 'SPEC_VALIDATION_ERROR',
+                    path: at,
+                    message: `field path "${path}" is listed twice`,
+                    nodeId: node.id,
+                });
+            }
+            seen.add(path);
+        });
+    },
+};
+//# sourceMappingURL=schema-viewer.js.map

package/dist/blocks/engineering/schema-viewer.js.map

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

package/dist/blocks/engineering/test-results.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Test-results block: a computed run summary over suites of cases.
+ *
+ * The summary (counts, total duration and a proportional bar) is derived from
+ * the cases, so it cannot disagree with them. Suites with failures come first,
+ * and suites with failing or flaky cases start open. Inside a suite, failing
+ * cases come first. Native `<details>` carry the folding, so there is no script.
+ */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const TEST_RESULTS_MAX_CASES = 200;
+export declare const testResultsBlock: BlockModule;
+//# sourceMappingURL=test-results.d.ts.map

package/dist/blocks/engineering/test-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-results.d.ts","sourceRoot":"","sources":["../../../src/blocks/engineering/test-results.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAqBlE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAwK1C,eAAO,MAAM,gBAAgB,EAAE,WA2D9B,CAAC"}

package/dist/blocks/engineering/test-results.js

@@ -0,0 +1,180 @@
+/**
+ * Test-results block: a computed run summary over suites of cases.
+ *
+ * The summary (counts, total duration and a proportional bar) is derived from
+ * the cases, so it cannot disagree with them. Suites with failures come first,
+ * and suites with failing or flaky cases start open. Inside a suite, failing
+ * cases come first. Native `<details>` carry the folding, so there is no script.
+ */
+import { formatValue } from '../../data/format-value.js';
+import { pathKey } from '../../diagnostics.js';
+import { isPlainObject } from '../../json.js';
+import { anchorProps, define, enumStr, itemsOf, LABEL, num, OPTIONAL_TITLE, str as strProp, txt, } from '../../registry/define-helpers.js';
+import { element, nodeAttributes, objectListProp, str, titleHeader, } from '../../render/block-helpers.js';
+import { escapeText, renderAttributes } from '../../render/escape.js';
+export const TEST_RESULTS_MAX_CASES = 200;
+/** Status order for the summary and for sorting failures first. */
+const STATUS_ORDER = ['fail', 'flaky', 'skip', 'pass'];
+const STATUS_TEXT = {
+    fail: { label: 'Failed', tone: 'danger', plural: 'failed' },
+    flaky: { label: 'Flaky', tone: 'warning', plural: 'flaky' },
+    skip: { label: 'Skipped', tone: 'neutral', plural: 'skipped' },
+    pass: { label: 'Passed', tone: 'success', plural: 'passed' },
+};
+function isStatus(value) {
+    return STATUS_ORDER.includes(value);
+}
+function emptyCounts() {
+    return { fail: 0, flaky: 0, skip: 0, pass: 0 };
+}
+function suites(node) {
+    return objectListProp(node, 'suites').map((suite) => {
+        const cases = (Array.isArray(suite.cases) ? suite.cases : []).flatMap((entry) => {
+            if (!isPlainObject(entry))
+                return [];
+            const status = str(entry.status);
+            return [
+                {
+                    name: str(entry.name),
+                    status: isStatus(status) ? status : 'pass',
+                    duration: typeof entry.duration === 'number' ? entry.duration : undefined,
+                    message: str(entry.message),
+                    file: str(entry.file),
+                },
+            ];
+        });
+        const counts = emptyCounts();
+        for (const item of cases)
+            counts[item.status] += 1;
+        const duration = cases.reduce((total, item) => total + (item.duration ?? 0), 0);
+        // Failures first, then flaky, then the rest in authored order (sort is stable).
+        const rank = (status) => status === 'fail' ? 0 : status === 'flaky' ? 1 : 2;
+        const ordered = [...cases].sort((left, right) => rank(left.status) - rank(right.status));
+        return { name: str(suite.name), cases: ordered, counts, duration };
+    });
+}
+function duration(ms) {
+    return formatValue(ms, { format: 'duration' });
+}
+function countPhrase(counts) {
+    return STATUS_ORDER.filter((status) => counts[status] > 0)
+        .map((status) => `${counts[status]} ${STATUS_TEXT[status].plural}`)
+        .join(', ');
+}
+function statusBadge(status) {
+    const text = STATUS_TEXT[status];
+    return `<span class="ak-badge" data-tone="${text.tone}">${text.label}</span>`;
+}
+/**
+ * The proportional bar is an SVG of rect widths (attributes, not inline
+ * styles), stretched to the row. It is decorative: the counts are text.
+ */
+function summaryBar(counts, total) {
+    if (total === 0)
+        return '';
+    let offset = 0;
+    const rects = STATUS_ORDER.filter((status) => counts[status] > 0)
+        .map((status) => {
+        const width = (counts[status] / total) * 100;
+        const rect = `<rect class="ak-tests-seg" data-status="${status}" x="${offset.toFixed(2)}" y="0" width="${width.toFixed(2)}" height="1"></rect>`;
+        offset += width;
+        return rect;
+    })
+        .join('');
+    return `<svg class="ak-tests-bar" viewBox="0 0 100 1" preserveAspectRatio="none" aria-hidden="true" focusable="false">${rects}</svg>`;
+}
+function renderCase(item) {
+    const time = item.duration === undefined
+        ? ''
+        : `<span class="ak-tests-time">${escapeText(duration(item.duration))}</span>`;
+    const file = item.file === '' ? '' : `<code class="ak-tests-file">${escapeText(item.file)}</code>`;
+    const message = item.message === '' ? '' : `<pre class="ak-tests-message">${escapeText(item.message)}</pre>`;
+    return `<li${renderAttributes({ class: 'ak-tests-case', 'data-status': item.status })}><div class="ak-tests-case-head">${statusBadge(item.status)}<span class="ak-tests-name">${escapeText(item.name)}</span>${time}</div>${file}${message}</li>`;
+}
+function renderTestResults(node) {
+    const all = suites(node);
+    const totals = emptyCounts();
+    for (const suite of all)
+        for (const status of STATUS_ORDER)
+            totals[status] += suite.counts[status];
+    const total = STATUS_ORDER.reduce((sum, status) => sum + totals[status], 0);
+    const elapsed = all.reduce((sum, suite) => sum + suite.duration, 0);
+    const coverage = node.props.coverage;
+    const failed = totals.fail > 0;
+    const verdict = failed
+        ? `${totals.fail} of ${total} ${total === 1 ? 'test' : 'tests'} failed`
+        : `No failures in ${total} ${total === 1 ? 'test' : 'tests'}`;
+    const stats = [
+        ...STATUS_ORDER.map((status) => [STATUS_TEXT[status].label, String(totals[status]), status]),
+        ...(elapsed > 0 ? [['Duration', duration(elapsed), '']] : []),
+        ...(typeof coverage === 'number'
+            ? [['Coverage', formatValue(coverage, { format: 'percent' }), '']]
+            : []),
+    ]
+        .map(([label, value, status]) => `<div${renderAttributes({ 'data-status': status === '' ? undefined : status })}><dt>${escapeText(label ?? '')}</dt><dd>${escapeText(value ?? '')}</dd></div>`)
+        .join('');
+    // Suites with failures first, in authored order otherwise.
+    const ordered = [...all].sort((left, right) => Number(right.counts.fail > 0) - Number(left.counts.fail > 0));
+    const suitesMarkup = ordered
+        .map((suite) => {
+        const elapsedText = suite.duration > 0 ? ` · ${duration(suite.duration)}` : '';
+        return `<details${renderAttributes({
+            class: 'ak-tests-suite',
+            open: suite.counts.fail + suite.counts.flaky > 0,
+            'data-status': suite.counts.fail > 0 ? 'fail' : suite.counts.flaky > 0 ? 'flaky' : 'pass',
+        })}><summary><span class="ak-tests-suite-name">${escapeText(suite.name)}</span><span class="ak-tests-suite-counts">${escapeText(`${countPhrase(suite.counts)}${elapsedText}`)}</span></summary><ul class="ak-tests-cases">${suite.cases.map(renderCase).join('')}</ul></details>`;
+    })
+        .join('');
+    return element('section', nodeAttributes(node, { class: 'ak-block ak-tests-block' }), `${titleHeader(node)}<div class="ak-tests"><div class="ak-tests-summary"${renderAttributes({
+        'data-status': failed ? 'fail' : 'pass',
+    })}><p class="ak-tests-verdict">${escapeText(verdict)}</p>${summaryBar(totals, total)}<dl class="ak-tests-counts">${stats}</dl></div><div class="ak-tests-suites">${suitesMarkup}</div></div>`);
+}
+export const testResultsBlock = {
+    definition: define({
+        type: 'test-results',
+        kind: 'semantic',
+        category: 'engineering',
+        tags: ['tests', 'ci', 'quality', 'suites'],
+        useCases: ['test run report', 'ci summary', 'regression triage'],
+        purpose: 'Test run report: suites of cases with a computed pass, fail, skip and duration summary.',
+        summary: 'Test results: suites of pass/fail/skip/flaky cases; the summary is computed and failures come first.',
+        props: {
+            title: OPTIONAL_TITLE,
+            coverage: num({ min: 0, max: 100, description: 'Line coverage in percent (87 for 87%).' }),
+            suites: itemsOf({
+                name: LABEL,
+                cases: itemsOf({
+                    name: strProp({ required: true, maxLength: 300 }),
+                    status: enumStr(STATUS_ORDER, { required: true }),
+                    duration: num({ min: 0, description: 'Milliseconds.' }),
+                    message: txt({ maxLength: 400, description: 'Failure output; emitted verbatim.' }),
+                    file: strProp({
+                        maxLength: 200,
+                        description: 'Source reference, such as src/a.ts:12.',
+                    }),
+                }, { minItems: 1, maxItems: TEST_RESULTS_MAX_CASES }),
+            }, { minItems: 1, maxItems: 20 }),
+            ...anchorProps,
+        },
+        runtimeFeatures: ['test-results'],
+        sizing: {
+            sizes: ['medium', 'large'],
+            default: 'large',
+            responsive: 'One column at every width; case rows wrap their duration and file under the name.',
+        },
+        a11y: 'Counts and each case status are text; the summary bar is decorative. Suites are native disclosures.',
+    }),
+    render: renderTestResults,
+    check(node, { bag }) {
+        const total = objectListProp(node, 'suites').reduce((sum, suite) => sum + (Array.isArray(suite.cases) ? suite.cases.length : 0), 0);
+        if (total > TEST_RESULTS_MAX_CASES) {
+            bag.add({
+                code: 'SPEC_BOUNDS_ERROR',
+                path: pathKey(node.path, 'suites'),
+                message: `the suites hold ${total} cases, limit is ${TEST_RESULTS_MAX_CASES} in total`,
+                nodeId: node.id,
+            });
+        }
+    },
+};
+//# sourceMappingURL=test-results.js.map

package/dist/blocks/engineering/test-results.js.map

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

package/dist/blocks/evidence/annotated-image.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Annotated image: numbered pins over an image, and the same notes as an
+ * ordered list below it. The list is the accessible and printable form; the
+ * pins only point at where each note applies.
+ */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const ANNOTATION_LIMITS: {
+    readonly maxNotes: 12;
+};
+/** Pin coordinates snap to this many percent, so the stylesheet needs 21 positions per axis. */
+export declare const PIN_STEP = 5;
+/** A pin coordinate in percent, clamped to 0–100 and snapped to `PIN_STEP`. */
+export declare function quantizePin(value: number): number;
+export declare const annotatedImageBlock: BlockModule;
+//# sourceMappingURL=annotated-image.d.ts.map

package/dist/blocks/evidence/annotated-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotated-image.d.ts","sourceRoot":"","sources":["../../../src/blocks/evidence/annotated-image.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,gCAAgC,CAAC;AAuBhF,eAAO,MAAM,iBAAiB;;CAA4B,CAAC;AAC3D,gGAAgG;AAChG,eAAO,MAAM,QAAQ,IAAI,CAAC;AAE1B,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAiED,eAAO,MAAM,mBAAmB,EAAE,WA+BjC,CAAC"}