@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/cjs/testing/conformance.js

@@ -0,0 +1,312 @@
+"use strict";
+/*
+ * 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.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.primitiveConformanceCases = exports.runPrimitiveInventoryConformance = exports.primitiveConformanceRows = exports.examplesFromDefinitions = exports.CONFORMANCE_FOREIGN_MARKER = void 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.
+const strict_1 = __importDefault(require("node:assert/strict"));
+const primitive_example_1 = require("../define/primitive_example");
+const anchors_1 = require("../render/anchors");
+const input_budget_1 = require("../validate/input_budget");
+/**
+ * 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.
+ */
+exports.CONFORMANCE_FOREIGN_MARKER = 'isomerConformanceForeign';
+/** Every definition's examples, flattened to one row each. */
+const examplesFromDefinitions = (definitions) => definitions.flatMap((definition) => (0, primitive_example_1.primitiveExamples)(definition).map(({ name, node }, exampleIndex) => ({
+    definition,
+    type: definition.type,
+    exampleIndex,
+    ...(name === undefined ? {} : { exampleName: name }),
+    node,
+})));
+exports.examplesFromDefinitions = examplesFromDefinitions;
+/** Every example crossed with every case, shaped for `it.each`. */
+const primitiveConformanceRows = (definitions) => (0, exports.examplesFromDefinitions)(definitions).flatMap((example) => exports.primitiveConformanceCases.map((conformanceCase) => ({
+    ...example,
+    ...conformanceCase,
+})));
+exports.primitiveConformanceRows = primitiveConformanceRows;
+/**
+ * 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.
+ */
+const runPrimitiveInventoryConformance = (definitions) => {
+    const examples = (0, exports.examplesFromDefinitions)(definitions);
+    strict_1.default.ok(examples.length > 0, 'expected at least one primitive example');
+    for (const definition of definitions) {
+        strict_1.default.ok(definition.examples.length > 0, `${definition.type} primitive must expose at least one example`);
+        const { name: catalogName } = definition.catalog;
+        strict_1.default.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 (0, primitive_example_1.primitiveExamples)(definition)) {
+            if (name === undefined) {
+                continue;
+            }
+            strict_1.default.ok(name.trim().length > 0, `${definition.type} example names must be non-empty`);
+            strict_1.default.ok(!names.has(name), `${definition.type} has two examples named ${JSON.stringify(name)}`);
+            names.add(name);
+        }
+        const checked = (0, input_budget_1.checkInputBudget)(definition.catalog.example);
+        if (!checked.valid) {
+            strict_1.default.fail(`${definition.type} catalog.example must be within the input budget: ${checked.error.message}`);
+        }
+        const catalogExample = checked.value;
+        const matchesPublished = (0, primitive_example_1.exampleNodes)(definition).some((node) => {
+            const published = (0, input_budget_1.checkInputBudget)(node);
+            return (published.valid &&
+                JSON.stringify(published.value) === JSON.stringify(catalogExample));
+        });
+        if (matchesPublished) {
+            continue;
+        }
+        const parsed = definition.schema.safeParse(catalogExample);
+        strict_1.default.ok(parsed.success, `${definition.type} catalog.example must parse against its schema or match a published example`);
+    }
+    for (const { type, node } of examples) {
+        strict_1.default.equal(node.type, type);
+    }
+};
+exports.runPrimitiveInventoryConformance = runPrimitiveInventoryConformance;
+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${anchors_1.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`.
+ */
+exports.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)];
+            strict_1.default.deepEqual(primitiveErrors, [], hint);
+            const result = harness.validateComposition(harness.wrapComposition(node));
+            strict_1.default.equal(result.valid, true, hint);
+            strict_1.default.deepEqual(result.errors, [], hint);
+        },
+    },
+    {
+        name: 'renders through React without throwing',
+        run: ({ node }, harness) => {
+            const rendered = harness.renderReact(node);
+            strict_1.default.notEqual(rendered, undefined);
+        },
+    },
+    {
+        name: 'collects styles without throwing',
+        run: ({ node }, harness) => {
+            strict_1.default.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);
+            strict_1.default.notEqual(harness.renderReact(nested), undefined);
+            strict_1.default.ok(harness.renderText(nested).includes(exports.CONFORMANCE_FOREIGN_MARKER));
+            strict_1.default.ok(harness.renderMarkdown(nested).includes(exports.CONFORMANCE_FOREIGN_MARKER));
+        },
+    },
+    {
+        name: 'renders through plain text with non-empty output',
+        run: ({ node }, harness) => {
+            const text = harness.renderText(node);
+            strict_1.default.equal(typeof text, 'string');
+            strict_1.default.ok(text.trim().length > 0);
+        },
+    },
+    {
+        name: 'renders through markdown with non-empty output',
+        run: ({ node }, harness) => {
+            const markdown = harness.renderMarkdown(node);
+            strict_1.default.equal(typeof markdown, 'string');
+            strict_1.default.ok(markdown.trim().length > 0);
+        },
+    },
+    {
+        name: 'renders through Slack dispatch returning at least one block',
+        run: ({ node }, harness) => {
+            const blocks = harness.renderSlack(node);
+            strict_1.default.ok(blocks.length > 0);
+            for (const block of blocks) {
+                strict_1.default.equal(typeof block, 'object');
+                strict_1.default.equal(typeof block.type, 'string');
+            }
+        },
+    },
+    {
+        name: 'renders through snapshot primitive dispatch without throwing',
+        run: ({ type, exampleIndex, node }, harness) => {
+            if (!harness.renderSnapshot) {
+                return;
+            }
+            strict_1.default.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);
+            strict_1.default.equal(Number.isFinite(height), true);
+            strict_1.default.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));
+            strict_1.default.deepEqual(result.validationErrors, []);
+            strict_1.default.ok(result.html.includes('<section'));
+            strict_1.default.equal(result.measurement.js, 0);
+            strict_1.default.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));
+            strict_1.default.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 = (0, anchors_1.anchoredNodes)(composition.body, harness.anchorWalk).flatMap((anchored) => {
+                const anchoredType = (0, anchors_1.nodeType)(anchored);
+                return anchoredType === undefined ? [] : [(0, anchors_1.anchorValue)(anchoredType)];
+            });
+            strict_1.default.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);
+            strict_1.default.deepEqual(missing, [], hint);
+        },
+    },
+    {
+        name: 'renders through renderText wrapped in a minimal composition',
+        run: ({ node }, harness) => {
+            const text = harness.renderTextComposition(harness.wrapComposition(node));
+            strict_1.default.ok(text.length > 0);
+            strict_1.default.ok(text.includes('CONFORMANCE FIXTURE'));
+        },
+    },
+    {
+        name: 'renders through renderMarkdown wrapped in a minimal composition',
+        run: ({ node }, harness) => {
+            const markdown = harness.renderMarkdownComposition(harness.wrapComposition(node));
+            strict_1.default.ok(markdown.length > 0);
+            strict_1.default.ok(markdown.includes('# Conformance fixture'));
+        },
+    },
+    {
+        name: 'renders through renderSlack wrapped in a minimal composition',
+        run: ({ node }, harness) => {
+            const result = harness.renderSlackComposition(harness.wrapComposition(node));
+            strict_1.default.ok(result.blocks.length > 0);
+            strict_1.default.ok(result.text.length > 0);
+            const first = result.blocks[0];
+            strict_1.default.ok(first);
+            if (first.type !== 'header') {
+                strict_1.default.fail(`expected a header block, got ${first.type}`);
+            }
+            strict_1.default.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));
+            strict_1.default.deepEqual(result.validationErrors, []);
+            strict_1.default.ok(result.html.trim().length > 0);
+            strict_1.default.ok(result.measurement.total > 0);
+        },
+    },
+];
+//# sourceMappingURL=conformance.js.map

package/dist/cjs/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/cjs/testing/icon.js

@@ -0,0 +1,248 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertPackIconsValid = void 0;
+// Hosts insert an icon's `svg` as markup, so every rule here is an allowlist.
+const primitive_pack_1 = require("../pack/primitive_pack");
+// HTML's markup whitespace, never `\s`: a parser reads NBSP and other Unicode separators as part of a name or as text.
+const NUMBER = /^[-+0-9.eE,\t\n\f\r ]*$/;
+const PATH_DATA = /^[-+0-9.eE,\t\n\f\r MmLlHhVvCcSsQqTtAaZz]*$/;
+const TRANSFORM = /^(?:[\t\n\f\r ]*(?:matrix|translate|scale|rotate|skewX|skewY)[\t\n\f\r ]*\([-+0-9.eE,\t\n\f\r ]*\)[\t\n\f\r ]*,?)*[\t\n\f\r ]*$/;
+const PAINT = /^(?:none|currentColor|var\(--isomer-icon-(?:accent|bg|fg|muted)(?:[\t\n\f\r ]*,[\t\n\f\r ]*(?:currentColor|#[0-9a-fA-F]{3}|#[0-9a-fA-F]{6}))?\))$/;
+const PAINT_RULE = 'is not none, currentColor, or var(--isomer-icon-*)';
+const NAME = /[A-Za-z][\w:.-]*/y;
+const ATTRIBUTE_NAME = /[^\t\n\f\r "'<>/=]+/y;
+const WHITESPACE = /[\t\n\f\r ]*/y;
+const BLANK = /^[\t\n\f\r ]*$/;
+const NAME_END = /[\t\n\f\r />]/;
+const trimMarkup = (text) => text.replace(/^[\t\n\f\r ]+|[\t\n\f\r ]+$/g, '');
+const isNumber = (value) => NUMBER.test(value);
+const keyword = (...words) => (value) => words.includes(value);
+const ATTRIBUTE_RULES = new Map([
+    ['clip-rule', keyword('nonzero', 'evenodd')],
+    ['cx', isNumber],
+    ['cy', isNumber],
+    ['d', (value) => PATH_DATA.test(value)],
+    ['fill', (value) => PAINT.test(value)],
+    ['fill-opacity', isNumber],
+    ['fill-rule', keyword('nonzero', 'evenodd')],
+    ['height', isNumber],
+    ['opacity', isNumber],
+    ['points', isNumber],
+    ['r', isNumber],
+    ['rx', isNumber],
+    ['ry', isNumber],
+    ['stroke', (value) => PAINT.test(value)],
+    ['stroke-linecap', keyword('butt', 'round', 'square')],
+    ['stroke-linejoin', keyword('miter', 'round', 'bevel')],
+    ['stroke-opacity', isNumber],
+    ['stroke-width', isNumber],
+    ['transform', (value) => TRANSFORM.test(value)],
+    ['viewBox', keyword('0 0 16 16')],
+    ['width', isNumber],
+    ['x', isNumber],
+    ['x1', isNumber],
+    ['x2', isNumber],
+    ['xmlns', keyword('http://www.w3.org/2000/svg')],
+    ['y', isNumber],
+    ['y1', isNumber],
+    ['y2', isNumber],
+]);
+const PRESENTATION = [
+    'clip-rule',
+    'fill',
+    'fill-opacity',
+    'fill-rule',
+    'opacity',
+    'stroke',
+    'stroke-linecap',
+    'stroke-linejoin',
+    'stroke-opacity',
+    'stroke-width',
+    'transform',
+];
+const ELEMENT_ATTRIBUTES = new Map([
+    ['svg', new Set(['viewBox', 'xmlns', ...PRESENTATION])],
+    ['g', new Set(PRESENTATION)],
+    ['path', new Set(['d', ...PRESENTATION])],
+    ['rect', new Set(['x', 'y', 'width', 'height', 'rx', 'ry', ...PRESENTATION])],
+    ['circle', new Set(['cx', 'cy', 'r', ...PRESENTATION])],
+    ['ellipse', new Set(['cx', 'cy', 'rx', 'ry', ...PRESENTATION])],
+    ['line', new Set(['x1', 'y1', 'x2', 'y2', ...PRESENTATION])],
+    ['polyline', new Set(['points', ...PRESENTATION])],
+    ['polygon', new Set(['points', ...PRESENTATION])],
+]);
+/** Every way `svg` breaks the icon rules, as one line each; empty when it passes. */
+const iconProblems = (svg) => {
+    const problems = [];
+    const open = [];
+    let roots = 0;
+    let index = 0;
+    const match = (pattern) => {
+        pattern.lastIndex = index;
+        const found = pattern.exec(svg)?.[0] ?? '';
+        index += found.length;
+        return found;
+    };
+    const checkAttributes = (element, attributes) => {
+        const allowed = ELEMENT_ATTRIBUTES.get(element);
+        if (!allowed) {
+            problems.push(`<${element}> is not an allowed element`);
+            return;
+        }
+        for (const [name, value] of attributes) {
+            if (!allowed.has(name)) {
+                problems.push(`${name} is not an allowed attribute on <${element}>`);
+            }
+            else if (value.includes('&')) {
+                problems.push(`${name}="${value}" contains an entity`);
+            }
+            else if (!ATTRIBUTE_RULES.get(name)(value)) {
+                problems.push(name === 'fill' || name === 'stroke'
+                    ? `${name}="${value}" ${PAINT_RULE}`
+                    : `${name}="${value}" is not an allowed value`);
+            }
+        }
+    };
+    while (index < svg.length) {
+        if (svg[index] !== '<') {
+            const end = svg.indexOf('<', index);
+            const text = svg.slice(index, end === -1 ? undefined : end);
+            if (!BLANK.test(text)) {
+                problems.push(open.length > 0
+                    ? `text content "${trimMarkup(text)}" is not allowed`
+                    : `unexpected "${trimMarkup(text)}" outside <svg>`);
+                return problems;
+            }
+            index += text.length;
+            continue;
+        }
+        if (svg.startsWith('<!', index) || svg.startsWith('<?', index)) {
+            problems.push('comments, declarations, and CDATA are not allowed');
+            return problems;
+        }
+        if (svg.startsWith('</', index)) {
+            index += 2;
+            const name = match(NAME);
+            match(WHITESPACE);
+            if (name === '' || svg[index] !== '>') {
+                problems.push('malformed closing tag');
+                return problems;
+            }
+            index += 1;
+            const expected = open.pop();
+            if (expected === undefined) {
+                problems.push(`</${name}> closes nothing`);
+                return problems;
+            }
+            if (expected !== name) {
+                problems.push(`</${name}> does not close <${expected}>`);
+                return problems;
+            }
+            continue;
+        }
+        index += 1;
+        const element = match(NAME);
+        if (element === '' || !NAME_END.test(svg[index] ?? '>')) {
+            problems.push('malformed opening tag');
+            return problems;
+        }
+        if (open.length === 0) {
+            roots += 1;
+            if (roots > 1) {
+                problems.push('more than one root element');
+                return problems;
+            }
+            if (element !== 'svg') {
+                problems.push(`root is <${element}>, not <svg>`);
+                return problems;
+            }
+        }
+        const attributes = new Map();
+        let selfClosing = false;
+        for (;;) {
+            match(WHITESPACE);
+            if (svg.startsWith('/>', index)) {
+                index += 2;
+                selfClosing = true;
+                break;
+            }
+            if (svg[index] === '>') {
+                index += 1;
+                break;
+            }
+            const name = match(ATTRIBUTE_NAME);
+            if (name === '') {
+                problems.push(`<${element}> is not terminated`);
+                return problems;
+            }
+            match(WHITESPACE);
+            if (svg[index] !== '=') {
+                problems.push(`${name} on <${element}> has no value`);
+                return problems;
+            }
+            index += 1;
+            match(WHITESPACE);
+            const quote = svg[index];
+            if (quote !== '"' && quote !== "'") {
+                problems.push(`${name} on <${element}> is unquoted`);
+                return problems;
+            }
+            const close = svg.indexOf(quote, index + 1);
+            if (close === -1) {
+                problems.push(`${name} on <${element}> is unterminated`);
+                return problems;
+            }
+            const value = svg.slice(index + 1, close);
+            index = close + 1;
+            if (value.includes('<')) {
+                problems.push(`${name} on <${element}> contains "<"`);
+                return problems;
+            }
+            if (attributes.has(name)) {
+                problems.push(`<${element}> repeats ${name}`);
+                return problems;
+            }
+            attributes.set(name, value);
+        }
+        checkAttributes(element, attributes);
+        if (open.length === 0 && !attributes.has('viewBox')) {
+            problems.push('<svg> has no viewBox="0 0 16 16"');
+        }
+        if (!selfClosing) {
+            open.push(element);
+        }
+        else if (open.length === 0) {
+            problems.push('<svg> is empty');
+        }
+    }
+    if (roots === 0) {
+        problems.push('has no <svg> root');
+    }
+    for (const element of open.reverse()) {
+        problems.push(`<${element}> is not closed`);
+    }
+    return problems;
+};
+/**
+ * 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);
+ * ```
+ */
+const assertPackIconsValid = ({ icons, primitives, }) => {
+    const byType = icons ?? (0, primitive_pack_1.iconsByType)(primitives);
+    const problems = Object.keys(byType).flatMap((type) => iconProblems(byType[type].svg).map((problem) => `${type} icon: ${problem}`));
+    if (problems.length > 0) {
+        throw new Error(`Pack icons break the icon rules:\n${problems.map((line) => `- ${line}`).join('\n')}`);
+    }
+};
+exports.assertPackIconsValid = assertPackIconsValid;
+//# sourceMappingURL=icon.js.map