@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/testing/conformance.d.ts

@@ -0,0 +1,145 @@
+import type { ChildNodeWalker } from '../composition/body_node_base.js';
+import type { Composition } from '../composition/composition.js';
+import type { ValidationError } from '../composition/validation_error.js';
+import type { AnyPrimitiveDefinition, PrimitiveNode } from '../define/primitive_module.js';
+import type { HTMLRenderResult } from '../render/html/envelope.js';
+import type { SlackBlock } from '../render/slack/blocks.js';
+import type { ValidationResult } from '../validate/validation.js';
+/**
+ * The foreign node {@link PrimitiveConformanceHarness.nestForeignChild}
+ * hands a container must render text/markdown containing this string, or the
+ * cross-pack nesting case cannot tell a dropped child from an empty one.
+ */
+export declare const CONFORMANCE_FOREIGN_MARKER = "isomerConformanceForeign";
+/** One example node, paired with the definition that published it. */
+export interface PrimitiveConformanceExample {
+    readonly definition: AnyPrimitiveDefinition;
+    /** Always `definition.type`, lifted onto the row so `it.each` titles can read it. */
+    readonly type: string;
+    /** Index into {@link AnyPrimitiveDefinition.examples}, and half of the preview hint a failure prints. */
+    readonly exampleIndex: number;
+    /** The example's `name`, absent for a bare node. */
+    readonly exampleName?: string;
+    readonly node: PrimitiveNode;
+}
+/** The subset of a host's HTML render options the cases exercise. */
+export interface PrimitiveConformanceHtmlOptions {
+    /** `'separate'` must move the stylesheet out of the markup and into `css`; the CSS cases assert against that field. */
+    readonly css?: 'inline' | 'separate';
+    /** `'readable'` must emit human-legible class names, which the CSS coverage case matches back against the emitted selectors. */
+    readonly names?: string;
+    /** Must render node anchors, as the `anchors` HTML render option does. */
+    readonly anchors?: boolean;
+}
+/** The subset of a host's `snapshot` render result the cases assert on. */
+export interface PrimitiveConformanceSnapshotResult {
+    /** Must be empty for every published example. */
+    readonly validationErrors: readonly ValidationError[];
+    /** The frame's markup, stylesheet included or not. */
+    readonly html: string;
+    /** `total` is the rendered byte size, and must be positive. */
+    readonly measurement: {
+        readonly total: number;
+    };
+}
+/** The subset of a host's Slack render result the cases assert on. */
+export interface PrimitiveConformanceSlackResult {
+    readonly blocks: readonly SlackBlock[];
+    /** Notification fallback text. Must be non-empty. */
+    readonly text: string;
+}
+/**
+ * Pack-owned render and validation bindings. The cases cannot import a
+ * vocabulary package, so the pack closes over its dispatcher, frame, and
+ * theme when it builds this object.
+ *
+ * Unsuffixed members take a single node; the `Composition`-suffixed ones take
+ * a whole {@link Composition}. Optional members gate the cases that need
+ * them, so a pack supplies only what its surfaces can answer.
+ */
+export interface PrimitiveConformanceHarness {
+    /**
+     * The smallest composition that carries one node. Its `title` must be
+     * `'Conformance fixture'`, which the envelope cases look for as
+     * `CONFORMANCE FIXTURE` in text and `# Conformance fixture` in markdown.
+     */
+    wrapComposition(node: PrimitiveNode): Composition;
+    /** Validation errors for the node on its own. Must be empty for every published example. */
+    validateNode(node: PrimitiveNode): readonly ValidationError[];
+    /** Whole-composition validation. Must be `valid` with no `errors` for a wrapped example. */
+    validateComposition(composition: Composition): ValidationResult;
+    /** Must return something other than `undefined`; the case does not mount the element. */
+    renderReact(node: PrimitiveNode): unknown;
+    /** Drives the pack's style collection for one node. Must not throw. */
+    collectStyles(node: PrimitiveNode): void;
+    /** Must return a string with non-whitespace content. */
+    renderText(node: PrimitiveNode): string;
+    /** Must return a string with non-whitespace content. */
+    renderMarkdown(node: PrimitiveNode): string;
+    /** Must return at least one block, each an object with a string `type`. */
+    renderSlack(node: PrimitiveNode): readonly SlackBlock[];
+    /** `key` is unique per example and only has to survive into the React tree. Must not throw. Omit for a pack with no `snapshot` path. */
+    renderSnapshot?(node: PrimitiveNode, key: string): unknown;
+    /** Must be finite and greater than zero, so a frame can lay the node out unrendered. Omit for a pack with no `snapshot` path. */
+    estimateSnapshotHeight?(node: PrimitiveNode): number;
+    /**
+     * Set `false` for a pack whose frame is a fixed size, so its primitives are
+     * not required to report a positive `metrics.snapshotHeight`. Skips the
+     * positive-finite height assertion.
+     */
+    sizesFromNodeHeights?: boolean;
+    /**
+     * For a container example, returns `container` with one of its children
+     * replaced by a node from a pack the harness composed in only for this
+     * check — never one `container`'s own pack registers. That node's `text`
+     * and `markdown` renderers must emit {@link CONFORMANCE_FOREIGN_MARKER}.
+     * Omit to skip the cross-pack nesting case.
+     */
+    nestForeignChild?(container: PrimitiveNode): PrimitiveNode;
+    /**
+     * Must honor {@link PrimitiveConformanceHtmlOptions}. Cases assert the
+     * markup wraps the body in a `<section>`, that `measurement.js` is zero, and
+     * that `validationErrors` is empty. Omit to skip the HTML cases.
+     */
+    renderHTML?(composition: Composition, options?: PrimitiveConformanceHtmlOptions): HTMLRenderResult;
+    /**
+     * The child walker over every definition the harness renders with. Set it
+     * once every `react` renderer spreads `nodeAnchor` on its root; the anchor
+     * case then asserts each node renders one.
+     */
+    anchorWalk?: ChildNodeWalker;
+    /** Must throw when `css` references a `var(--name)` it never declares. Omit to skip the CSS variable case. */
+    assertVarRefsHaveDeclarations?(css: string): void;
+    /** Whole-composition text render, title envelope included. */
+    renderTextComposition(composition: Composition): string;
+    /** Whole-composition markdown render, title heading included. */
+    renderMarkdownComposition(composition: Composition): string;
+    /** Must lead with a `plain_text` header block carrying the composition title. */
+    renderSlackComposition(composition: Composition): PrimitiveConformanceSlackResult;
+    /** Must resolve to non-empty markup with no validation errors. Omit for a pack with no frame. */
+    renderSnapshotComposition?(composition: Composition): Promise<PrimitiveConformanceSnapshotResult>;
+}
+/** One assertion, run once per example. */
+export interface PrimitiveConformanceCase {
+    readonly name: string;
+    /** Signals failure by throwing. May be async, so a pack must await it. */
+    readonly run: (example: PrimitiveConformanceExample, harness: PrimitiveConformanceHarness) => void | Promise<void>;
+}
+/** Every definition's examples, flattened to one row each. */
+export declare const examplesFromDefinitions: (definitions: readonly AnyPrimitiveDefinition[]) => readonly PrimitiveConformanceExample[];
+/** Every example crossed with every case, shaped for `it.each`. */
+export declare const primitiveConformanceRows: (definitions: readonly AnyPrimitiveDefinition[]) => readonly (PrimitiveConformanceExample & PrimitiveConformanceCase)[];
+/**
+ * Asserts the inventory itself holds up: the pack has examples, every
+ * definition contributes one, `catalog.name` and example names are non-empty,
+ * example names are unique within their definition, each example's `type` matches its definition, and
+ * `catalog.example` is within the input budget and parses or matches a
+ * published example.
+ */
+export declare const runPrimitiveInventoryConformance: (definitions: readonly AnyPrimitiveDefinition[]) => void;
+/**
+ * Every assertion a primitive owes its callers, for a pack to drive with
+ * `it.each`.
+ */
+export declare const primitiveConformanceCases: readonly PrimitiveConformanceCase[];
+//# sourceMappingURL=conformance.d.ts.map

package/dist/testing/conformance.d.ts.map

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

package/dist/testing/conformance.js

@@ -0,0 +1,303 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+// The behaviour every primitive definition owes its callers, expressed once.
+//
+// Framework-agnostic on purpose: only `node:assert/strict` and Node builtins,
+// so this ships on a public entry without dragging vitest into a vocabulary
+// package's dependency set. Each pack drives the array with `it.each`, so a
+// second vocabulary costs one package and one test file.
+import assert from 'node:assert/strict';
+import { exampleNodes, primitiveExamples } from '../define/primitive_example.js';
+import { anchoredNodes, anchorValue, NODE_ANCHOR_ATTRIBUTE, nodeType, } from '../render/anchors.js';
+import { checkInputBudget } from '../validate/input_budget.js';
+/**
+ * The foreign node {@link PrimitiveConformanceHarness.nestForeignChild}
+ * hands a container must render text/markdown containing this string, or the
+ * cross-pack nesting case cannot tell a dropped child from an empty one.
+ */
+export const CONFORMANCE_FOREIGN_MARKER = 'isomerConformanceForeign';
+/** Every definition's examples, flattened to one row each. */
+export const examplesFromDefinitions = (definitions) => definitions.flatMap((definition) => primitiveExamples(definition).map(({ name, node }, exampleIndex) => ({
+    definition,
+    type: definition.type,
+    exampleIndex,
+    ...(name === undefined ? {} : { exampleName: name }),
+    node,
+})));
+/** Every example crossed with every case, shaped for `it.each`. */
+export const primitiveConformanceRows = (definitions) => examplesFromDefinitions(definitions).flatMap((example) => primitiveConformanceCases.map((conformanceCase) => ({
+    ...example,
+    ...conformanceCase,
+})));
+/**
+ * Asserts the inventory itself holds up: the pack has examples, every
+ * definition contributes one, `catalog.name` and example names are non-empty,
+ * example names are unique within their definition, each example's `type` matches its definition, and
+ * `catalog.example` is within the input budget and parses or matches a
+ * published example.
+ */
+export const runPrimitiveInventoryConformance = (definitions) => {
+    const examples = examplesFromDefinitions(definitions);
+    assert.ok(examples.length > 0, 'expected at least one primitive example');
+    for (const definition of definitions) {
+        assert.ok(definition.examples.length > 0, `${definition.type} primitive must expose at least one example`);
+        const { name: catalogName } = definition.catalog;
+        assert.ok(catalogName === undefined || catalogName.trim().length > 0, `${definition.type} catalog.name must be non-empty when present`);
+        const names = new Set();
+        for (const { name } of primitiveExamples(definition)) {
+            if (name === undefined) {
+                continue;
+            }
+            assert.ok(name.trim().length > 0, `${definition.type} example names must be non-empty`);
+            assert.ok(!names.has(name), `${definition.type} has two examples named ${JSON.stringify(name)}`);
+            names.add(name);
+        }
+        const checked = checkInputBudget(definition.catalog.example);
+        if (!checked.valid) {
+            assert.fail(`${definition.type} catalog.example must be within the input budget: ${checked.error.message}`);
+        }
+        const catalogExample = checked.value;
+        const matchesPublished = exampleNodes(definition).some((node) => {
+            const published = checkInputBudget(node);
+            return (published.valid &&
+                JSON.stringify(published.value) === JSON.stringify(catalogExample));
+        });
+        if (matchesPublished) {
+            continue;
+        }
+        const parsed = definition.schema.safeParse(catalogExample);
+        assert.ok(parsed.success, `${definition.type} catalog.example must parse against its schema or match a published example`);
+    }
+    for (const { type, node } of examples) {
+        assert.equal(node.type, type);
+    }
+};
+const previewHint = ({ type, exampleIndex, exampleName, }) => `Failing example: \`${type}\` definition, examples[${exampleIndex}]` +
+    `${exampleName === undefined ? '' : ` (${JSON.stringify(exampleName)})`}.`;
+const renderedClassNames = (html) => {
+    const classNames = new Set();
+    for (const match of html.matchAll(/\bclass="([^"]+)"/g)) {
+        match[1]
+            .split(/\s+/)
+            .filter(Boolean)
+            .forEach((className) => classNames.add(className));
+    }
+    return [...classNames].sort();
+};
+/** The node anchor values in serialized `html`, in document order. */
+const renderedAnchors = (html) => {
+    const attribute = new RegExp(`\\s${NODE_ANCHOR_ATTRIBUTE}="([^"]*)"`);
+    // Only opening tags: the serializer escapes `<`, `>`, and `"` in text and attribute values.
+    return [...html.matchAll(/<[a-zA-Z][^>]*>/g)].flatMap(([tag]) => {
+        const [, value] = attribute.exec(tag) ?? [];
+        return value === undefined ? [] : [value];
+    });
+};
+const cssEscapeClass = (className) => className.replace(/([!"#$%&'()*+,./:;<=>?@[\\\]^`{|}~])/g, '\\$1');
+const cssHasClassSelector = (css, className) => new RegExp(`\\.${cssEscapeClass(className)}(?![\\w-])`).test(css);
+/**
+ * Every assertion a primitive owes its callers, for a pack to drive with
+ * `it.each`.
+ */
+export const primitiveConformanceCases = [
+    {
+        name: 'validates as a primitive node and inside a composition',
+        run: (example, harness) => {
+            const { node } = example;
+            const hint = previewHint(example);
+            const primitiveErrors = [...harness.validateNode(node)];
+            assert.deepEqual(primitiveErrors, [], hint);
+            const result = harness.validateComposition(harness.wrapComposition(node));
+            assert.equal(result.valid, true, hint);
+            assert.deepEqual(result.errors, [], hint);
+        },
+    },
+    {
+        name: 'renders through React without throwing',
+        run: ({ node }, harness) => {
+            const rendered = harness.renderReact(node);
+            assert.notEqual(rendered, undefined);
+        },
+    },
+    {
+        name: 'collects styles without throwing',
+        run: ({ node }, harness) => {
+            assert.doesNotThrow(() => harness.collectStyles(node));
+        },
+    },
+    {
+        name: 'a container recurses through scope for a node from another pack',
+        run: ({ definition, node }, harness) => {
+            if (!definition.children || !harness.nestForeignChild) {
+                return;
+            }
+            const nested = harness.nestForeignChild(node);
+            assert.notEqual(harness.renderReact(nested), undefined);
+            assert.ok(harness.renderText(nested).includes(CONFORMANCE_FOREIGN_MARKER));
+            assert.ok(harness.renderMarkdown(nested).includes(CONFORMANCE_FOREIGN_MARKER));
+        },
+    },
+    {
+        name: 'renders through plain text with non-empty output',
+        run: ({ node }, harness) => {
+            const text = harness.renderText(node);
+            assert.equal(typeof text, 'string');
+            assert.ok(text.trim().length > 0);
+        },
+    },
+    {
+        name: 'renders through markdown with non-empty output',
+        run: ({ node }, harness) => {
+            const markdown = harness.renderMarkdown(node);
+            assert.equal(typeof markdown, 'string');
+            assert.ok(markdown.trim().length > 0);
+        },
+    },
+    {
+        name: 'renders through Slack dispatch returning at least one block',
+        run: ({ node }, harness) => {
+            const blocks = harness.renderSlack(node);
+            assert.ok(blocks.length > 0);
+            for (const block of blocks) {
+                assert.equal(typeof block, 'object');
+                assert.equal(typeof block.type, 'string');
+            }
+        },
+    },
+    {
+        name: 'renders through snapshot primitive dispatch without throwing',
+        run: ({ type, exampleIndex, node }, harness) => {
+            if (!harness.renderSnapshot) {
+                return;
+            }
+            assert.doesNotThrow(() => harness.renderSnapshot?.(node, `conformance-${type}-${exampleIndex}`));
+        },
+    },
+    {
+        name: 'reports a positive finite snapshot height estimate',
+        run: ({ node }, harness) => {
+            if (harness.sizesFromNodeHeights === false ||
+                !harness.estimateSnapshotHeight) {
+                return;
+            }
+            const height = harness.estimateSnapshotHeight(node);
+            assert.equal(Number.isFinite(height), true);
+            assert.ok(height > 0);
+        },
+    },
+    {
+        name: 'renders through renderHTML wrapped in a minimal composition',
+        run: ({ node }, harness) => {
+            if (!harness.renderHTML) {
+                return;
+            }
+            const result = harness.renderHTML(harness.wrapComposition(node));
+            assert.deepEqual(result.validationErrors, []);
+            assert.ok(result.html.includes('<section'));
+            assert.equal(result.measurement.js, 0);
+            assert.ok(result.measurement.total > 0);
+        },
+    },
+    {
+        name: 'renders no node anchors unless asked',
+        run: ({ node }, harness) => {
+            if (!harness.renderHTML) {
+                return;
+            }
+            const { body } = harness.renderHTML(harness.wrapComposition(node));
+            assert.deepEqual(renderedAnchors(body), []);
+        },
+    },
+    {
+        name: 'renders a node anchor on every node when asked',
+        run: (example, harness) => {
+            if (!harness.renderHTML || !harness.anchorWalk) {
+                return;
+            }
+            const composition = harness.wrapComposition(example.node);
+            const { body } = harness.renderHTML(composition, { anchors: true });
+            const expected = anchoredNodes(composition.body, harness.anchorWalk).flatMap((anchored) => {
+                const anchoredType = nodeType(anchored);
+                return anchoredType === undefined ? [] : [anchorValue(anchoredType)];
+            });
+            assert.deepEqual(renderedAnchors(body), expected, `Expected one anchor per node, in walker order. ${previewHint(example)}`);
+        },
+    },
+    {
+        name: 'emits CSS where every var(...) reference has a matching declaration',
+        run: ({ node }, harness) => {
+            if (!harness.renderHTML || !harness.assertVarRefsHaveDeclarations) {
+                return;
+            }
+            const result = harness.renderHTML(harness.wrapComposition(node), {
+                css: 'separate',
+            });
+            harness.assertVarRefsHaveDeclarations(result.css);
+        },
+    },
+    {
+        name: 'reaches every rendered readable class in compact CSS collection',
+        run: (example, harness) => {
+            if (!harness.renderHTML) {
+                return;
+            }
+            const { type, exampleIndex, node } = example;
+            const result = harness.renderHTML(harness.wrapComposition(node), {
+                css: 'separate',
+                names: 'readable',
+            });
+            const missing = renderedClassNames(result.body).filter((className) => !cssHasClassSelector(result.css, className));
+            const hint = `Missing CSS for ${type} example #${exampleIndex}: ` +
+                `${missing.join(', ') || '(none)'}. ` +
+                previewHint(example);
+            assert.deepEqual(missing, [], hint);
+        },
+    },
+    {
+        name: 'renders through renderText wrapped in a minimal composition',
+        run: ({ node }, harness) => {
+            const text = harness.renderTextComposition(harness.wrapComposition(node));
+            assert.ok(text.length > 0);
+            assert.ok(text.includes('CONFORMANCE FIXTURE'));
+        },
+    },
+    {
+        name: 'renders through renderMarkdown wrapped in a minimal composition',
+        run: ({ node }, harness) => {
+            const markdown = harness.renderMarkdownComposition(harness.wrapComposition(node));
+            assert.ok(markdown.length > 0);
+            assert.ok(markdown.includes('# Conformance fixture'));
+        },
+    },
+    {
+        name: 'renders through renderSlack wrapped in a minimal composition',
+        run: ({ node }, harness) => {
+            const result = harness.renderSlackComposition(harness.wrapComposition(node));
+            assert.ok(result.blocks.length > 0);
+            assert.ok(result.text.length > 0);
+            const first = result.blocks[0];
+            assert.ok(first);
+            if (first.type !== 'header') {
+                assert.fail(`expected a header block, got ${first.type}`);
+            }
+            assert.equal(first.text.type, 'plain_text');
+        },
+    },
+    {
+        name: 'renders a snapshot wrapped in a minimal composition',
+        run: async ({ node }, harness) => {
+            if (!harness.renderSnapshotComposition) {
+                return;
+            }
+            const result = await harness.renderSnapshotComposition(harness.wrapComposition(node));
+            assert.deepEqual(result.validationErrors, []);
+            assert.ok(result.html.trim().length > 0);
+            assert.ok(result.measurement.total > 0);
+        },
+    },
+];
+//# sourceMappingURL=conformance.js.map

package/dist/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../src/testing/conformance.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n// The behaviour every primitive definition owes its callers, expressed once.\n//\n// Framework-agnostic on purpose: only `node:assert/strict` and Node builtins,\n// so this ships on a public entry without dragging vitest into a vocabulary\n// package's dependency set. Each pack drives the array with `it.each`, so a\n// second vocabulary costs one package and one test file.\n\nimport assert from 'node:assert/strict';\n\nimport type { ChildNodeWalker } from '../composition/body_node_base';\nimport type { Composition } from '../composition/composition';\nimport type { ValidationError } from '../composition/validation_error';\nimport { exampleNodes, primitiveExamples } from '../define/primitive_example';\nimport type {\n  AnyPrimitiveDefinition,\n  PrimitiveNode,\n} from '../define/primitive_module';\nimport {\n  anchoredNodes,\n  anchorValue,\n  NODE_ANCHOR_ATTRIBUTE,\n  nodeType,\n} from '../render/anchors';\nimport type { HTMLRenderResult } from '../render/html/envelope';\nimport type { SlackBlock } from '../render/slack/blocks';\nimport { checkInputBudget } from '../validate/input_budget';\nimport type { ValidationResult } from '../validate/validation';\n\n/**\n * The foreign node {@link PrimitiveConformanceHarness.nestForeignChild}\n * hands a container must render text/markdown containing this string, or the\n * cross-pack nesting case cannot tell a dropped child from an empty one.\n */\nexport const CONFORMANCE_FOREIGN_MARKER = 'isomerConformanceForeign';\n\n/** One example node, paired with the definition that published it. */\nexport interface PrimitiveConformanceExample {\n  readonly definition: AnyPrimitiveDefinition;\n  /** Always `definition.type`, lifted onto the row so `it.each` titles can read it. */\n  readonly type: string;\n  /** Index into {@link AnyPrimitiveDefinition.examples}, and half of the preview hint a failure prints. */\n  readonly exampleIndex: number;\n  /** The example's `name`, absent for a bare node. */\n  readonly exampleName?: string;\n  readonly node: PrimitiveNode;\n}\n\n/** The subset of a host's HTML render options the cases exercise. */\nexport interface PrimitiveConformanceHtmlOptions {\n  /** `'separate'` must move the stylesheet out of the markup and into `css`; the CSS cases assert against that field. */\n  readonly css?: 'inline' | 'separate';\n  /** `'readable'` must emit human-legible class names, which the CSS coverage case matches back against the emitted selectors. */\n  readonly names?: string;\n  /** Must render node anchors, as the `anchors` HTML render option does. */\n  readonly anchors?: boolean;\n}\n\n/** The subset of a host's `snapshot` render result the cases assert on. */\nexport interface PrimitiveConformanceSnapshotResult {\n  /** Must be empty for every published example. */\n  readonly validationErrors: readonly ValidationError[];\n  /** The frame's markup, stylesheet included or not. */\n  readonly html: string;\n  /** `total` is the rendered byte size, and must be positive. */\n  readonly measurement: { readonly total: number };\n}\n\n/** The subset of a host's Slack render result the cases assert on. */\nexport interface PrimitiveConformanceSlackResult {\n  readonly blocks: readonly SlackBlock[];\n  /** Notification fallback text. Must be non-empty. */\n  readonly text: string;\n}\n\n/**\n * Pack-owned render and validation bindings. The cases cannot import a\n * vocabulary package, so the pack closes over its dispatcher, frame, and\n * theme when it builds this object.\n *\n * Unsuffixed members take a single node; the `Composition`-suffixed ones take\n * a whole {@link Composition}. Optional members gate the cases that need\n * them, so a pack supplies only what its surfaces can answer.\n */\nexport interface PrimitiveConformanceHarness {\n  /**\n   * The smallest composition that carries one node. Its `title` must be\n   * `'Conformance fixture'`, which the envelope cases look for as\n   * `CONFORMANCE FIXTURE` in text and `# Conformance fixture` in markdown.\n   */\n  wrapComposition(node: PrimitiveNode): Composition;\n  /** Validation errors for the node on its own. Must be empty for every published example. */\n  validateNode(node: PrimitiveNode): readonly ValidationError[];\n  /** Whole-composition validation. Must be `valid` with no `errors` for a wrapped example. */\n  validateComposition(composition: Composition): ValidationResult;\n  /** Must return something other than `undefined`; the case does not mount the element. */\n  renderReact(node: PrimitiveNode): unknown;\n  /** Drives the pack's style collection for one node. Must not throw. */\n  collectStyles(node: PrimitiveNode): void;\n  /** Must return a string with non-whitespace content. */\n  renderText(node: PrimitiveNode): string;\n  /** Must return a string with non-whitespace content. */\n  renderMarkdown(node: PrimitiveNode): string;\n  /** Must return at least one block, each an object with a string `type`. */\n  renderSlack(node: PrimitiveNode): readonly SlackBlock[];\n  /** `key` is unique per example and only has to survive into the React tree. Must not throw. Omit for a pack with no `snapshot` path. */\n  renderSnapshot?(node: PrimitiveNode, key: string): unknown;\n  /** Must be finite and greater than zero, so a frame can lay the node out unrendered. Omit for a pack with no `snapshot` path. */\n  estimateSnapshotHeight?(node: PrimitiveNode): number;\n  /**\n   * Set `false` for a pack whose frame is a fixed size, so its primitives are\n   * not required to report a positive `metrics.snapshotHeight`. Skips the\n   * positive-finite height assertion.\n   */\n  sizesFromNodeHeights?: boolean;\n  /**\n   * For a container example, returns `container` with one of its children\n   * replaced by a node from a pack the harness composed in only for this\n   * check — never one `container`'s own pack registers. That node's `text`\n   * and `markdown` renderers must emit {@link CONFORMANCE_FOREIGN_MARKER}.\n   * Omit to skip the cross-pack nesting case.\n   */\n  nestForeignChild?(container: PrimitiveNode): PrimitiveNode;\n  /**\n   * Must honor {@link PrimitiveConformanceHtmlOptions}. Cases assert the\n   * markup wraps the body in a `<section>`, that `measurement.js` is zero, and\n   * that `validationErrors` is empty. Omit to skip the HTML cases.\n   */\n  renderHTML?(\n    composition: Composition,\n    options?: PrimitiveConformanceHtmlOptions\n  ): HTMLRenderResult;\n  /**\n   * The child walker over every definition the harness renders with. Set it\n   * once every `react` renderer spreads `nodeAnchor` on its root; the anchor\n   * case then asserts each node renders one.\n   */\n  anchorWalk?: ChildNodeWalker;\n  /** Must throw when `css` references a `var(--name)` it never declares. Omit to skip the CSS variable case. */\n  assertVarRefsHaveDeclarations?(css: string): void;\n  /** Whole-composition text render, title envelope included. */\n  renderTextComposition(composition: Composition): string;\n  /** Whole-composition markdown render, title heading included. */\n  renderMarkdownComposition(composition: Composition): string;\n  /** Must lead with a `plain_text` header block carrying the composition title. */\n  renderSlackComposition(\n    composition: Composition\n  ): PrimitiveConformanceSlackResult;\n  /** Must resolve to non-empty markup with no validation errors. Omit for a pack with no frame. */\n  renderSnapshotComposition?(\n    composition: Composition\n  ): Promise<PrimitiveConformanceSnapshotResult>;\n}\n\n/** One assertion, run once per example. */\nexport interface PrimitiveConformanceCase {\n  readonly name: string;\n  /** Signals failure by throwing. May be async, so a pack must await it. */\n  readonly run: (\n    example: PrimitiveConformanceExample,\n    harness: PrimitiveConformanceHarness\n  ) => void | Promise<void>;\n}\n\n/** Every definition's examples, flattened to one row each. */\nexport const examplesFromDefinitions = (\n  definitions: readonly AnyPrimitiveDefinition[]\n): readonly PrimitiveConformanceExample[] =>\n  definitions.flatMap((definition) =>\n    primitiveExamples(definition).map(({ name, node }, exampleIndex) => ({\n      definition,\n      type: definition.type,\n      exampleIndex,\n      ...(name === undefined ? {} : { exampleName: name }),\n      node,\n    }))\n  );\n\n/** Every example crossed with every case, shaped for `it.each`. */\nexport const primitiveConformanceRows = (\n  definitions: readonly AnyPrimitiveDefinition[]\n): readonly (PrimitiveConformanceExample & PrimitiveConformanceCase)[] =>\n  examplesFromDefinitions(definitions).flatMap((example) =>\n    primitiveConformanceCases.map((conformanceCase) => ({\n      ...example,\n      ...conformanceCase,\n    }))\n  );\n\n/**\n * Asserts the inventory itself holds up: the pack has examples, every\n * definition contributes one, `catalog.name` and example names are non-empty,\n * example names are unique within their definition, each example's `type` matches its definition, and\n * `catalog.example` is within the input budget and parses or matches a\n * published example.\n */\nexport const runPrimitiveInventoryConformance = (\n  definitions: readonly AnyPrimitiveDefinition[]\n): void => {\n  const examples = examplesFromDefinitions(definitions);\n  assert.ok(examples.length > 0, 'expected at least one primitive example');\n  for (const definition of definitions) {\n    assert.ok(\n      definition.examples.length > 0,\n      `${definition.type} primitive must expose at least one example`\n    );\n    const { name: catalogName } = definition.catalog;\n    assert.ok(\n      catalogName === undefined || catalogName.trim().length > 0,\n      `${definition.type} catalog.name must be non-empty when present`\n    );\n    const names = new Set<string>();\n    for (const { name } of primitiveExamples(definition)) {\n      if (name === undefined) {\n        continue;\n      }\n      assert.ok(\n        name.trim().length > 0,\n        `${definition.type} example names must be non-empty`\n      );\n      assert.ok(\n        !names.has(name),\n        `${definition.type} has two examples named ${JSON.stringify(name)}`\n      );\n      names.add(name);\n    }\n    const checked = checkInputBudget(definition.catalog.example);\n    if (!checked.valid) {\n      assert.fail(\n        `${definition.type} catalog.example must be within the input budget: ${checked.error.message}`\n      );\n    }\n    const catalogExample = checked.value;\n    const matchesPublished = exampleNodes(definition).some((node) => {\n      const published = checkInputBudget(node);\n      return (\n        published.valid &&\n        JSON.stringify(published.value) === JSON.stringify(catalogExample)\n      );\n    });\n    if (matchesPublished) {\n      continue;\n    }\n    const parsed = definition.schema.safeParse(catalogExample);\n    assert.ok(\n      parsed.success,\n      `${definition.type} catalog.example must parse against its schema or match a published example`\n    );\n  }\n  for (const { type, node } of examples) {\n    assert.equal(node.type, type);\n  }\n};\n\nconst previewHint = ({\n  type,\n  exampleIndex,\n  exampleName,\n}: PrimitiveConformanceExample): string =>\n  `Failing example: \\`${type}\\` definition, examples[${exampleIndex}]` +\n  `${exampleName === undefined ? '' : ` (${JSON.stringify(exampleName)})`}.`;\n\nconst renderedClassNames = (html: string): string[] => {\n  const classNames = new Set<string>();\n  for (const match of html.matchAll(/\\bclass=\"([^\"]+)\"/g)) {\n    match[1]!\n      .split(/\\s+/)\n      .filter(Boolean)\n      .forEach((className) => classNames.add(className));\n  }\n  return [...classNames].sort();\n};\n\n/** The node anchor values in serialized `html`, in document order. */\nconst renderedAnchors = (html: string): string[] => {\n  const attribute = new RegExp(`\\\\s${NODE_ANCHOR_ATTRIBUTE}=\"([^\"]*)\"`);\n  // Only opening tags: the serializer escapes `<`, `>`, and `\"` in text and attribute values.\n  return [...html.matchAll(/<[a-zA-Z][^>]*>/g)].flatMap(([tag]) => {\n    const [, value] = attribute.exec(tag) ?? [];\n    return value === undefined ? [] : [value];\n  });\n};\n\nconst cssEscapeClass = (className: string): string =>\n  className.replace(/([!\"#$%&'()*+,./:;<=>?@[\\\\\\]^`{|}~])/g, '\\\\$1');\n\nconst cssHasClassSelector = (css: string, className: string): boolean =>\n  new RegExp(`\\\\.${cssEscapeClass(className)}(?![\\\\w-])`).test(css);\n\n/**\n * Every assertion a primitive owes its callers, for a pack to drive with\n * `it.each`.\n */\nexport const primitiveConformanceCases: readonly PrimitiveConformanceCase[] = [\n  {\n    name: 'validates as a primitive node and inside a composition',\n    run: (example, harness) => {\n      const { node } = example;\n      const hint = previewHint(example);\n      const primitiveErrors = [...harness.validateNode(node)];\n      assert.deepEqual(primitiveErrors, [], hint);\n      const result = harness.validateComposition(harness.wrapComposition(node));\n      assert.equal(result.valid, true, hint);\n      assert.deepEqual(result.errors, [], hint);\n    },\n  },\n  {\n    name: 'renders through React without throwing',\n    run: ({ node }, harness) => {\n      const rendered = harness.renderReact(node);\n      assert.notEqual(rendered, undefined);\n    },\n  },\n  {\n    name: 'collects styles without throwing',\n    run: ({ node }, harness) => {\n      assert.doesNotThrow(() => harness.collectStyles(node));\n    },\n  },\n  {\n    name: 'a container recurses through scope for a node from another pack',\n    run: ({ definition, node }, harness) => {\n      if (!definition.children || !harness.nestForeignChild) {\n        return;\n      }\n      const nested = harness.nestForeignChild(node);\n      assert.notEqual(harness.renderReact(nested), undefined);\n      assert.ok(\n        harness.renderText(nested).includes(CONFORMANCE_FOREIGN_MARKER)\n      );\n      assert.ok(\n        harness.renderMarkdown(nested).includes(CONFORMANCE_FOREIGN_MARKER)\n      );\n    },\n  },\n  {\n    name: 'renders through plain text with non-empty output',\n    run: ({ node }, harness) => {\n      const text = harness.renderText(node);\n      assert.equal(typeof text, 'string');\n      assert.ok(text.trim().length > 0);\n    },\n  },\n  {\n    name: 'renders through markdown with non-empty output',\n    run: ({ node }, harness) => {\n      const markdown = harness.renderMarkdown(node);\n      assert.equal(typeof markdown, 'string');\n      assert.ok(markdown.trim().length > 0);\n    },\n  },\n  {\n    name: 'renders through Slack dispatch returning at least one block',\n    run: ({ node }, harness) => {\n      const blocks = harness.renderSlack(node);\n      assert.ok(blocks.length > 0);\n      for (const block of blocks) {\n        assert.equal(typeof block, 'object');\n        assert.equal(typeof block.type, 'string');\n      }\n    },\n  },\n  {\n    name: 'renders through snapshot primitive dispatch without throwing',\n    run: ({ type, exampleIndex, node }, harness) => {\n      if (!harness.renderSnapshot) {\n        return;\n      }\n      assert.doesNotThrow(() =>\n        harness.renderSnapshot?.(node, `conformance-${type}-${exampleIndex}`)\n      );\n    },\n  },\n  {\n    name: 'reports a positive finite snapshot height estimate',\n    run: ({ node }, harness) => {\n      if (\n        harness.sizesFromNodeHeights === false ||\n        !harness.estimateSnapshotHeight\n      ) {\n        return;\n      }\n      const height = harness.estimateSnapshotHeight(node);\n      assert.equal(Number.isFinite(height), true);\n      assert.ok(height > 0);\n    },\n  },\n  {\n    name: 'renders through renderHTML wrapped in a minimal composition',\n    run: ({ node }, harness) => {\n      if (!harness.renderHTML) {\n        return;\n      }\n      const result = harness.renderHTML(harness.wrapComposition(node));\n      assert.deepEqual(result.validationErrors, []);\n      assert.ok(result.html.includes('<section'));\n      assert.equal(result.measurement.js, 0);\n      assert.ok(result.measurement.total > 0);\n    },\n  },\n  {\n    name: 'renders no node anchors unless asked',\n    run: ({ node }, harness) => {\n      if (!harness.renderHTML) {\n        return;\n      }\n      const { body } = harness.renderHTML(harness.wrapComposition(node));\n      assert.deepEqual(renderedAnchors(body), []);\n    },\n  },\n  {\n    name: 'renders a node anchor on every node when asked',\n    run: (example, harness) => {\n      if (!harness.renderHTML || !harness.anchorWalk) {\n        return;\n      }\n      const composition = harness.wrapComposition(example.node);\n      const { body } = harness.renderHTML(composition, { anchors: true });\n      const expected = anchoredNodes(\n        composition.body,\n        harness.anchorWalk\n      ).flatMap((anchored) => {\n        const anchoredType = nodeType(anchored);\n        return anchoredType === undefined ? [] : [anchorValue(anchoredType)];\n      });\n      assert.deepEqual(\n        renderedAnchors(body),\n        expected,\n        `Expected one anchor per node, in walker order. ${previewHint(example)}`\n      );\n    },\n  },\n  {\n    name: 'emits CSS where every var(...) reference has a matching declaration',\n    run: ({ node }, harness) => {\n      if (!harness.renderHTML || !harness.assertVarRefsHaveDeclarations) {\n        return;\n      }\n      const result = harness.renderHTML(harness.wrapComposition(node), {\n        css: 'separate',\n      });\n      harness.assertVarRefsHaveDeclarations(result.css);\n    },\n  },\n  {\n    name: 'reaches every rendered readable class in compact CSS collection',\n    run: (example, harness) => {\n      if (!harness.renderHTML) {\n        return;\n      }\n      const { type, exampleIndex, node } = example;\n      const result = harness.renderHTML(harness.wrapComposition(node), {\n        css: 'separate',\n        names: 'readable',\n      });\n      const missing = renderedClassNames(result.body).filter(\n        (className) => !cssHasClassSelector(result.css, className)\n      );\n      const hint =\n        `Missing CSS for ${type} example #${exampleIndex}: ` +\n        `${missing.join(', ') || '(none)'}. ` +\n        previewHint(example);\n      assert.deepEqual(missing, [], hint);\n    },\n  },\n  {\n    name: 'renders through renderText wrapped in a minimal composition',\n    run: ({ node }, harness) => {\n      const text = harness.renderTextComposition(harness.wrapComposition(node));\n      assert.ok(text.length > 0);\n      assert.ok(text.includes('CONFORMANCE FIXTURE'));\n    },\n  },\n  {\n    name: 'renders through renderMarkdown wrapped in a minimal composition',\n    run: ({ node }, harness) => {\n      const markdown = harness.renderMarkdownComposition(\n        harness.wrapComposition(node)\n      );\n      assert.ok(markdown.length > 0);\n      assert.ok(markdown.includes('# Conformance fixture'));\n    },\n  },\n  {\n    name: 'renders through renderSlack wrapped in a minimal composition',\n    run: ({ node }, harness) => {\n      const result = harness.renderSlackComposition(\n        harness.wrapComposition(node)\n      );\n      assert.ok(result.blocks.length > 0);\n      assert.ok(result.text.length > 0);\n      const first = result.blocks[0];\n      assert.ok(first);\n      if (first.type !== 'header') {\n        assert.fail(`expected a header block, got ${first.type}`);\n      }\n      assert.equal(first.text.type, 'plain_text');\n    },\n  },\n  {\n    name: 'renders a snapshot wrapped in a minimal composition',\n    run: async ({ node }, harness) => {\n      if (!harness.renderSnapshotComposition) {\n        return;\n      }\n      const result = await harness.renderSnapshotComposition(\n        harness.wrapComposition(node)\n      );\n      assert.deepEqual(result.validationErrors, []);\n      assert.ok(result.html.trim().length > 0);\n      assert.ok(result.measurement.total > 0);\n    },\n  },\n];\n"]}

package/dist/testing/icon.d.ts

@@ -0,0 +1,11 @@
+import { type PrimitivePack } from '../pack/primitive_pack.js';
+/**
+ * Fails when any icon in `pack` breaks the rules a host relies on to inline it: a single `<svg viewBox="0 0 16 16">` root, allowlisted shape elements and geometry or paint attributes, and paint limited to `none`, `currentColor`, or `var(--isomer-icon-*)` with an optional `currentColor` or hex fallback.
+ *
+ * @example
+ * ```ts
+ * assertPackIconsValid(slidesPack);
+ * ```
+ */
+export declare const assertPackIconsValid: ({ icons, primitives, }: Pick<PrimitivePack, "icons" | "primitives">) => void;
+//# sourceMappingURL=icon.d.ts.map

package/dist/testing/icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../src/testing/icon.ts"],"names":[],"mappings":"AASA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA2PzE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,wBAGlC,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,YAAY,CAAC,KAAG,IAUhD,CAAC"}