@bestagentkits/render 0.1.1-next.1 → 0.3.0

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

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

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

@@ -0,0 +1,4 @@
+/** Data table blocks: typed, sortable, searchable tables bound to a dataset. */
+import type { BlockGroup } from '../../registry/block-module.js';
+export declare const DATA_TABLE_GROUP: BlockGroup;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/data-table/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAKjE,eAAO,MAAM,gBAAgB,EAAE,UAY9B,CAAC"}

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

@@ -0,0 +1,18 @@
+/** Data table blocks: typed, sortable, searchable tables bound to a dataset. */
+import { DATA_TABLE_FEATURE, dataTableBlock } from './data-table.js';
+import { DATA_TABLE_RUNTIME } from './data-table-runtime.js';
+import { DATA_TABLE_CSS } from './data-table-styles.js';
+export const DATA_TABLE_GROUP = {
+    name: 'data-table',
+    blocks: [dataTableBlock],
+    features: [
+        {
+            name: DATA_TABLE_FEATURE,
+            marker: '.ak-data-table',
+            css: DATA_TABLE_CSS,
+            script: { code: DATA_TABLE_RUNTIME, boot: 'wireDataTables();' },
+            announces: true,
+        },
+    ],
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/blocks/data-table/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAGhF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,cAAc,CAAC;IACxB,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,gBAAgB;YACxB,GAAG,EAAE,cAAc;YACnB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,mBAAmB,EAAE;YAC/D,SAAS,EAAE,IAAI;SAChB;KACF;CACF,CAAC"}

package/dist/blocks/engineering/api-endpoint.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Api-endpoint block: one HTTP operation with its parameters, request body and
+ * responses.
+ *
+ * The method is a badge, the path highlights its `{param}` segments and has a
+ * Copy button, the parameters are a table with row headers, and bodies use the
+ * core code block markup.
+ */
+import type { BlockModule } from '../../registry/block-module.js';
+export declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "PATCH", "DELETE"];
+export declare const apiEndpointBlock: BlockModule;
+//# sourceMappingURL=api-endpoint.d.ts.map

package/dist/blocks/engineering/api-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-endpoint.d.ts","sourceRoot":"","sources":["../../../src/blocks/engineering/api-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAsBlE,eAAO,MAAM,YAAY,oDAAqD,CAAC;AAwI/E,eAAO,MAAM,gBAAgB,EAAE,WAsD9B,CAAC"}

package/dist/blocks/engineering/api-endpoint.js

@@ -0,0 +1,174 @@
+/**
+ * Api-endpoint block: one HTTP operation with its parameters, request body and
+ * responses.
+ *
+ * The method is a badge, the path highlights its `{param}` segments and has a
+ * Copy button, the parameters are a table with row headers, and bodies use the
+ * core code block markup.
+ */
+import { pathKey } from '../../diagnostics.js';
+import { isPlainObject } from '../../json.js';
+import { anchorProps, bool, define, enumStr, list, num, obj, str as strProp, txt, } from '../../registry/define-helpers.js';
+import { element, nodeAttributes, objectListProp, str, stringProp, } from '../../render/block-helpers.js';
+import { escapeInlineText, escapeText, renderAttributes } from '../../render/escape.js';
+import { codePanel, copyButton, partId } from './engineering-helpers.js';
+export const HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
+const METHOD_TONES = {
+    GET: 'info',
+    POST: 'success',
+    PUT: 'warning',
+    PATCH: 'warning',
+    DELETE: 'danger',
+};
+/** `{name}` segments of a path template. */
+const PATH_PARAM = /\{([^{}/]+)\}/gu;
+function statusTone(status) {
+    if (status >= 500)
+        return 'danger';
+    if (status >= 400)
+        return 'warning';
+    if (status >= 300)
+        return 'info';
+    if (status >= 200)
+        return 'success';
+    return 'neutral';
+}
+function pathMarkup(path) {
+    let output = '';
+    let last = 0;
+    for (const match of path.matchAll(PATH_PARAM)) {
+        output += escapeText(path.slice(last, match.index));
+        output += `<span class="ak-api-param">${escapeText(match[0])}</span>`;
+        last = match.index + match[0].length;
+    }
+    return output + escapeText(path.slice(last));
+}
+function paramsTable(node) {
+    const params = objectListProp(node, 'params');
+    if (params.length === 0)
+        return '';
+    const rows = params
+        .map((param) => {
+        const required = param.required === true ? ' <span class="ak-api-required">required</span>' : '';
+        return `<tr><th scope="row"><code>${escapeText(str(param.name))}</code>${required}</th><td>${escapeText(str(param.in))}</td><td><code>${escapeText(str(param.type))}</code></td><td>${escapeInlineText(str(param.description))}</td></tr>`;
+    })
+        .join('');
+    return `<h3 class="ak-api-heading">Parameters</h3><div class="ak-table-wrap"><table><caption class="ak-sr">Parameters</caption><thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Type</th><th scope="col">Description</th></tr></thead><tbody>${rows}</tbody></table></div>`;
+}
+function requestMarkup(node) {
+    const request = node.props.request;
+    if (!isPlainObject(request) || typeof request.code !== 'string')
+        return '';
+    const language = str(request.language, 'json');
+    return `<h3 class="ak-api-heading">Request body</h3>${codePanel(partId(node, 'request'), 'Request', language, request.code)}`;
+}
+function responsesMarkup(node) {
+    const responses = objectListProp(node, 'responses');
+    if (responses.length === 0)
+        return '';
+    const items = responses
+        .map((response, index) => {
+        const status = typeof response.status === 'number' ? response.status : 0;
+        const code = typeof response.code === 'string'
+            ? codePanel(partId(node, `response-${index}`), `${status} response`, str(response.language, 'json'), response.code)
+            : '';
+        return `<li class="ak-api-response"><p class="ak-api-response-head"><span class="ak-badge" data-tone="${statusTone(status)}">${status}</span><span>${escapeInlineText(str(response.description))}</span></p>${code}</li>`;
+    })
+        .join('');
+    return `<h3 class="ak-api-heading">Responses</h3><ul class="ak-api-responses">${items}</ul>`;
+}
+function renderApiEndpoint(node) {
+    const method = stringProp(node, 'method', 'GET');
+    const path = stringProp(node, 'path');
+    const summary = stringProp(node, 'summary');
+    const pathTarget = partId(node, 'path');
+    const head = `<div class="ak-api-head"><h2 class="ak-api-title"><span${renderAttributes({
+        class: 'ak-api-method',
+        'data-tone': METHOD_TONES[method] ?? 'neutral',
+    })}>${escapeText(method)}</span> <code${renderAttributes({
+        class: 'ak-api-path',
+        'data-ak-id': pathTarget,
+    })}>${pathMarkup(path)}</code></h2>${copyButton(pathTarget, `Copy path ${path}`)}</div>`;
+    return element('section', nodeAttributes(node, { class: 'ak-block ak-api' }), [
+        head,
+        summary === '' ? '' : `<p class="ak-api-summary">${escapeInlineText(summary)}</p>`,
+        paramsTable(node),
+        requestMarkup(node),
+        responsesMarkup(node),
+    ].join(''));
+}
+/** Warn when the path template and the `in: path` parameters disagree. */
+function checkPathParams(node, bag) {
+    const template = [...stringProp(node, 'path').matchAll(PATH_PARAM)].map((match) => match[1] ?? '');
+    const declared = objectListProp(node, 'params')
+        .filter((param) => param.in === 'path')
+        .map((param) => str(param.name));
+    for (const name of template.filter((name) => !declared.includes(name))) {
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            severity: 'warning',
+            path: pathKey(node.path, 'path'),
+            message: `path segment "{${name}}" has no matching "in: path" parameter`,
+            nodeId: node.id,
+        });
+    }
+    for (const name of declared.filter((name) => !template.includes(name))) {
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            severity: 'warning',
+            path: pathKey(node.path, 'params'),
+            message: `path parameter "${name}" does not appear in the path`,
+            details: { allowed: template },
+            nodeId: node.id,
+        });
+    }
+}
+const CODE = txt({ maxLength: 8_000, description: 'Emitted verbatim.' });
+const LANGUAGE = strProp({ maxLength: 20, default: 'json' });
+export const apiEndpointBlock = {
+    definition: define({
+        type: 'api-endpoint',
+        kind: 'semantic',
+        category: 'engineering',
+        tags: ['api', 'http', 'rest', 'reference'],
+        useCases: ['api reference', 'endpoint change review', 'integration guide'],
+        purpose: 'API reference for one HTTP operation: method, path, parameters, request and responses.',
+        summary: 'API endpoint: method and path with copy, a parameters table, a request body and status responses.',
+        props: {
+            method: enumStr(HTTP_METHODS, { required: true }),
+            path: strProp({
+                required: true,
+                maxLength: 300,
+                description: 'Path template; {name} marks a parameter.',
+            }),
+            summary: txt({ maxLength: 600 }),
+            params: list(obj({
+                name: strProp({ required: true, maxLength: 80 }),
+                in: enumStr(['path', 'query', 'header'], { required: true }),
+                type: strProp({ required: true, maxLength: 40 }),
+                required: bool(),
+                description: txt({ maxLength: 300 }),
+            }), { maxItems: 20 }),
+            request: obj({ language: LANGUAGE, code: { ...CODE, required: true } }),
+            responses: list(obj({
+                status: num({ required: true, integer: true, min: 100, max: 599 }),
+                description: strProp({ required: true, maxLength: 200 }),
+                language: LANGUAGE,
+                code: CODE,
+            }), { maxItems: 8 }),
+            ...anchorProps,
+        },
+        runtimeFeatures: ['api-endpoint', 'copy'],
+        sizing: {
+            sizes: ['medium', 'large'],
+            default: 'large',
+            responsive: 'The path wraps at any character; the parameters table scrolls inside its frame on phones.',
+        },
+        a11y: 'The method and path form the heading; the parameters table has column and row headers; status codes are text.',
+    }),
+    render: renderApiEndpoint,
+    check(node, { bag }) {
+        checkPathParams(node, bag);
+    },
+};
+//# sourceMappingURL=api-endpoint.js.map

package/dist/blocks/engineering/api-endpoint.js.map

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

package/dist/blocks/engineering/engineering-helpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Helpers shared by the engineering widgets: data-field mapping for the blocks
+ * that read rows (kanban, log-viewer), scalar rows for the filter contract, and
+ * the copyable code panel the api-endpoint block draws with core code markup.
+ */
+import type { DataRow, DataScalar } from '../../data/dataset-types.js';
+import { type DiagnosticBag } from '../../diagnostics.js';
+import type { IrNode } from '../../ir.js';
+import { type JsonValue } from '../../json.js';
+import type { PropSchema } from '../../registry/prop-schema.js';
+/**
+ * A `fields` prop that maps each part of a rendered item to a dataset field.
+ * An omitted part reads the field of the same name.
+ */
+export declare function fieldMapProp(parts: readonly string[], description: string): PropSchema;
+/** The dataset field each part reads: the authored mapping, else the part's own name. */
+export declare function fieldMap(node: IrNode, parts: readonly string[]): Record<string, string>;
+/**
+ * True when the author bound data, whether or not the binding resolved: a
+ * failed binding has already been reported under one of the binding keys.
+ */
+export declare function bindsData(node: IrNode, bag: DiagnosticBag): boolean;
+/**
+ * Check that a block takes its items from exactly one source: the inline list
+ * prop or a data binding. Returns false when it reported a problem.
+ */
+export declare function checkItemSource(node: IrNode, bag: DiagnosticBag, listKey: string, noun: string): boolean;
+/**
+ * Report every mapped field the bound rows do not have. `required` parts are
+ * always checked; optional parts only when the author mapped them explicitly,
+ * so a dataset without, say, an `owner` field simply shows no owner.
+ */
+export declare function checkMappedFields(node: IrNode, bag: DiagnosticBag, parts: readonly string[], required: readonly string[]): boolean;
+/** A row's value for a mapped part, or null when the row lacks the field. */
+export declare function partValue(row: DataRow, field: string | undefined): DataScalar;
+/** Display text for a bound scalar; empty for null so optional parts drop out. */
+export declare function partText(value: DataScalar): string;
+/** The scalar fields of an authored item, as the row the filter contract carries. */
+export declare function scalarRow(item: Record<string, JsonValue>): DataRow;
+/**
+ * A copy target id for a piece of a block. Node ids never contain a dot, so a
+ * dotted suffix cannot collide with any authored or derived node id.
+ */
+export declare function partId(node: IrNode, part: string): string;
+/** The core code block's Copy button, aimed at one element. */
+export declare function copyButton(target: string, label: string): string;
+/** A code panel in the core code block's markup, with its own copy target. */
+export declare function codePanel(target: string, label: string, language: string, code: string): string;
+//# sourceMappingURL=engineering-helpers.d.ts.map

package/dist/blocks/engineering/engineering-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineering-helpers.d.ts","sourceRoot":"","sources":["../../../src/blocks/engineering/engineering-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAIvE,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAMhE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAItF;AAED,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQvF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAanE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAsBT;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAeT;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAG7E;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAElD;AAED,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,OAAO,CASlE;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhE;AAWD,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAa/F"}

package/dist/blocks/engineering/engineering-helpers.js

@@ -0,0 +1,156 @@
+/**
+ * Helpers shared by the engineering widgets: data-field mapping for the blocks
+ * that read rows (kanban, log-viewer), scalar rows for the filter contract, and
+ * the copyable code panel the api-endpoint block draws with core code markup.
+ */
+import { isDataScalar } from '../../data/dataset-types.js';
+import { formatValue } from '../../data/format-value.js';
+import { reportUnknownField } from '../../data/resolve-block-data.js';
+import { pathKey } from '../../diagnostics.js';
+import { isPlainObject } from '../../json.js';
+import { obj, str as strProp } from '../../registry/define-helpers.js';
+import { escapeText, renderAttributes } from '../../render/escape.js';
+/** Data keys a bound block reads instead of props; any diagnostic under them means a binding was attempted. */
+const BINDING_KEYS = ['dataRef', 'data', 'transform'];
+/**
+ * A `fields` prop that maps each part of a rendered item to a dataset field.
+ * An omitted part reads the field of the same name.
+ */
+export function fieldMapProp(parts, description) {
+    return obj(Object.fromEntries(parts.map((part) => [part, strProp({ maxLength: 64 })])), {
+        description,
+    });
+}
+/** The dataset field each part reads: the authored mapping, else the part's own name. */
+export function fieldMap(node, parts) {
+    const authored = isPlainObject(node.props.fields) ? node.props.fields : {};
+    return Object.fromEntries(parts.map((part) => {
+        const value = authored[part];
+        return [part, typeof value === 'string' ? value : part];
+    }));
+}
+/**
+ * True when the author bound data, whether or not the binding resolved: a
+ * failed binding has already been reported under one of the binding keys.
+ */
+export function bindsData(node, bag) {
+    if (node.data !== undefined)
+        return true;
+    const prefixes = BINDING_KEYS.map((key) => pathKey(node.path, key));
+    return bag
+        .list()
+        .some((item) => prefixes.some((prefix) => item.path === prefix ||
+        item.path.startsWith(`${prefix}.`) ||
+        item.path.startsWith(`${prefix}[`)));
+}
+/**
+ * Check that a block takes its items from exactly one source: the inline list
+ * prop or a data binding. Returns false when it reported a problem.
+ */
+export function checkItemSource(node, bag, listKey, noun) {
+    const inline = Array.isArray(node.props[listKey]) && node.props[listKey].length > 0;
+    const bound = bindsData(node, bag);
+    if (inline && bound) {
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path: pathKey(node.path, listKey),
+            message: `set "${listKey}" or a data binding ("dataRef" or "data"), not both`,
+            nodeId: node.id,
+        });
+        return false;
+    }
+    if (!inline && !bound) {
+        bag.add({
+            code: 'SPEC_VALIDATION_ERROR',
+            path: pathKey(node.path, listKey),
+            message: `a ${node.type} needs ${noun}: set "${listKey}", or bind rows with "dataRef" or "data"`,
+            nodeId: node.id,
+        });
+        return false;
+    }
+    return true;
+}
+/**
+ * Report every mapped field the bound rows do not have. `required` parts are
+ * always checked; optional parts only when the author mapped them explicitly,
+ * so a dataset without, say, an `owner` field simply shows no owner.
+ */
+export function checkMappedFields(node, bag, parts, required) {
+    const data = node.data;
+    if (data === undefined)
+        return false;
+    const authored = isPlainObject(node.props.fields) ? node.props.fields : {};
+    const fields = fieldMap(node, parts);
+    let ok = true;
+    for (const part of parts) {
+        const field = fields[part] ?? part;
+        const explicit = typeof authored[part] === 'string';
+        if (!required.includes(part) && !explicit)
+            continue;
+        if (data.fields.includes(field))
+            continue;
+        ok = false;
+        reportUnknownField(field, data, pathKey(pathKey(node.path, 'fields'), part), bag, node.id);
+    }
+    return ok;
+}
+/** A row's value for a mapped part, or null when the row lacks the field. */
+export function partValue(row, field) {
+    if (field === undefined || !Object.hasOwn(row, field))
+        return null;
+    return row[field] ?? null;
+}
+/** Display text for a bound scalar; empty for null so optional parts drop out. */
+export function partText(value) {
+    return value === null ? '' : formatValue(value);
+}
+/** The scalar fields of an authored item, as the row the filter contract carries. */
+export function scalarRow(item) {
+    const row = {};
+    for (const [key, value] of Object.entries(item)) {
+        if (isDataScalar(value))
+            row[key] = value;
+        else if (Array.isArray(value) && value.every((entry) => typeof entry === 'string')) {
+            row[key] = value.join(', ');
+        }
+    }
+    return row;
+}
+/**
+ * A copy target id for a piece of a block. Node ids never contain a dot, so a
+ * dotted suffix cannot collide with any authored or derived node id.
+ */
+export function partId(node, part) {
+    return `${node.id}.${part}`;
+}
+/** The core code block's Copy button, aimed at one element. */
+export function copyButton(target, label) {
+    return `<button type="button" class="ak-code-copy"${renderAttributes({
+        'aria-label': label,
+        'data-ak-on-click': JSON.stringify([{ action: 'copy', target }]),
+    })}>Copy</button>`;
+}
+/** Split code into one span per line, as the core code block does, so lines are numbered. */
+function codeLines(text) {
+    return text
+        .replace(/\n$/u, '')
+        .split('\n')
+        .map((line) => `<span class="ak-line">${escapeText(line)}</span>`)
+        .join('\n');
+}
+/** A code panel in the core code block's markup, with its own copy target. */
+export function codePanel(target, label, language, code) {
+    return [
+        '<div class="ak-code">',
+        '<div class="ak-code-head">',
+        `<span class="ak-label">${escapeText(label)}</span>`,
+        `<span class="ak-code-lang">${escapeText(language)}</span>`,
+        copyButton(target, `Copy ${label}`),
+        '</div>',
+        `<pre${renderAttributes({ 'data-ak-id': target })}><code${renderAttributes({
+            class: `language-${language}`,
+        })}>${codeLines(code)}</code></pre>`,
+        '</div>',
+    ].join('');
+}
+//# sourceMappingURL=engineering-helpers.js.map

package/dist/blocks/engineering/engineering-helpers.js.map

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

package/dist/blocks/engineering/engineering-styles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Feature sheets for the engineering widgets. Each sheet is emitted only when a
+ * page uses its block, and every colour is a theme token or a `color-mix()` of
+ * tokens. Status is always stated in text; tone only reinforces it.
+ */
+export declare const KANBAN_CSS: string;
+export declare const ROADMAP_CSS: string;
+export declare const TEST_RESULTS_CSS: string;
+export declare const LOG_VIEWER_CSS: string;
+export declare const API_ENDPOINT_CSS: string;
+export declare const SCHEMA_VIEWER_CSS: string;
+//# sourceMappingURL=engineering-styles.d.ts.map

package/dist/blocks/engineering/engineering-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineering-styles.d.ts","sourceRoot":"","sources":["../../../src/blocks/engineering/engineering-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH,eAAO,MAAM,UAAU,QAmBoK,CAAC;AAe5L,eAAO,MAAM,WAAW,QA4BqF,CAAC;AAE9G,eAAO,MAAM,gBAAgB,QAoCgI,CAAC;AAE9J,eAAO,MAAM,cAAc,QAkBwE,CAAC;AAEpG,eAAO,MAAM,gBAAgB,QAeU,CAAC;AAExC,eAAO,MAAM,iBAAiB,QAcyF,CAAC"}