@elastic/isomer-sdk 0.0.0 → 0.1.0

package/dist/cjs/render/text/index.js

@@ -0,0 +1,12 @@
+"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.renderTextEnvelope = void 0;
+var envelope_1 = require("./envelope");
+Object.defineProperty(exports, "renderTextEnvelope", { enumerable: true, get: function () { return envelope_1.renderTextEnvelope; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/render/text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/render/text/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uCAIoB;AADlB,8GAAA,kBAAkB,OAAA","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\nexport {\n  type TextEnvelopeDispatcher,\n  type TextEnvelopeOptions,\n  renderTextEnvelope,\n} from './envelope';\n"]}

package/dist/cjs/testing/conformance.js

@@ -0,0 +1,296 @@
+"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 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 = '__isomer_conformance_foreign__';
+/** Every definition's examples, flattened to one row each. */
+const examplesFromDefinitions = (definitions) => definitions.flatMap((definition) => definition.examples.map((node, exampleIndex) => ({
+    definition,
+    type: definition.type,
+    exampleIndex,
+    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, 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 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 = definition.examples.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) => `Failing example: \`${type}\` definition, examples[${exampleIndex}].`;
+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: ({ type, exampleIndex, node }, harness) => {
+            const hint = previewHint(type, exampleIndex);
+            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 SVG primitive dispatch without throwing',
+        run: ({ type, exampleIndex, node }, harness) => {
+            if (!harness.renderSvg) {
+                return;
+            }
+            strict_1.default.doesNotThrow(() => harness.renderSvg?.(node, `conformance-${type}-${exampleIndex}`));
+        },
+    },
+    {
+        name: 'reports a positive finite SVG height estimate',
+        run: ({ node }, harness) => {
+            if (harness.sizesFromNodeHeights === false ||
+                !harness.estimateSvgHeight) {
+                return;
+            }
+            const height = harness.estimateSvgHeight(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: ({ type, exampleIndex, node }, harness) => {
+            if (!harness.renderHTML || !harness.anchorWalk) {
+                return;
+            }
+            const composition = harness.wrapComposition(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(type, exampleIndex)}`);
+        },
+    },
+    {
+        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: ({ type, exampleIndex, node }, harness) => {
+            if (!harness.renderHTML) {
+                return;
+            }
+            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(type, exampleIndex);
+            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 through renderSVG wrapped in a minimal composition',
+        run: async ({ node }, harness) => {
+            if (!harness.renderSVGComposition) {
+                return;
+            }
+            const result = await harness.renderSVGComposition(harness.wrapComposition(node));
+            strict_1.default.deepEqual(result.validationErrors, []);
+            strict_1.default.ok(result.svg.includes('<svg'));
+            strict_1.default.ok(result.svg.includes('</svg>'));
+            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 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 = '__isomer_conformance_foreign__';\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  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 SVG render result the cases assert on. */\nexport interface PrimitiveConformanceSvgResult {\n  /** Must be empty for every published example. */\n  readonly validationErrors: readonly ValidationError[];\n  readonly svg: 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 `svg` path. */\n  renderSvg?(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 `svg` path. */\n  estimateSvgHeight?(node: PrimitiveNode): number;\n  /**\n   * Set `false` for packs whose frame is fixed-size (`sizesFromNodeHeights: false`).\n   * Skips the positive-finite height assertion, which no fixed-frame pack can satisfy.\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 complete `<svg>`/`</svg>` markup with no validation errors. Omit for a pack with no frame. */\n  renderSVGComposition?(\n    composition: Composition\n  ): Promise<PrimitiveConformanceSvgResult>;\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    definition.examples.map((node, exampleIndex) => ({\n      definition,\n      type: definition.type,\n      exampleIndex,\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, each example's `type` matches its definition,\n * and `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 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 = definition.examples.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 = (type: string, exampleIndex: number): string =>\n  `Failing example: \\`${type}\\` definition, examples[${exampleIndex}].`;\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: ({ type, exampleIndex, node }, harness) => {\n      const hint = previewHint(type, exampleIndex);\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 SVG primitive dispatch without throwing',\n    run: ({ type, exampleIndex, node }, harness) => {\n      if (!harness.renderSvg) {\n        return;\n      }\n      assert.doesNotThrow(() =>\n        harness.renderSvg?.(node, `conformance-${type}-${exampleIndex}`)\n      );\n    },\n  },\n  {\n    name: 'reports a positive finite SVG height estimate',\n    run: ({ node }, harness) => {\n      if (\n        harness.sizesFromNodeHeights === false ||\n        !harness.estimateSvgHeight\n      ) {\n        return;\n      }\n      const height = harness.estimateSvgHeight(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: ({ type, exampleIndex, node }, harness) => {\n      if (!harness.renderHTML || !harness.anchorWalk) {\n        return;\n      }\n      const composition = harness.wrapComposition(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(type, exampleIndex)}`\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: ({ type, exampleIndex, node }, harness) => {\n      if (!harness.renderHTML) {\n        return;\n      }\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(type, exampleIndex);\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 through renderSVG wrapped in a minimal composition',\n    run: async ({ node }, harness) => {\n      if (!harness.renderSVGComposition) {\n        return;\n      }\n      const result = await harness.renderSVGComposition(\n        harness.wrapComposition(node)\n      );\n      assert.deepEqual(result.validationErrors, []);\n      assert.ok(result.svg.includes('<svg'));\n      assert.ok(result.svg.includes('</svg>'));\n      assert.ok(result.measurement.total > 0);\n    },\n  },\n];\n"]}

package/dist/cjs/testing/index.js

@@ -0,0 +1,16 @@
+"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.assertPackRegistrationComplete = exports.runPrimitiveInventoryConformance = exports.primitiveConformanceRows = exports.CONFORMANCE_FOREIGN_MARKER = void 0;
+var conformance_1 = require("./conformance");
+Object.defineProperty(exports, "CONFORMANCE_FOREIGN_MARKER", { enumerable: true, get: function () { return conformance_1.CONFORMANCE_FOREIGN_MARKER; } });
+Object.defineProperty(exports, "primitiveConformanceRows", { enumerable: true, get: function () { return conformance_1.primitiveConformanceRows; } });
+Object.defineProperty(exports, "runPrimitiveInventoryConformance", { enumerable: true, get: function () { return conformance_1.runPrimitiveInventoryConformance; } });
+var registration_1 = require("./registration");
+Object.defineProperty(exports, "assertPackRegistrationComplete", { enumerable: true, get: function () { return registration_1.assertPackRegistrationComplete; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6CAUuB;AAHrB,yHAAA,0BAA0B,OAAA;AAC1B,uHAAA,wBAAwB,OAAA;AACxB,+HAAA,gCAAgC,OAAA;AAElC,+CAGwB;AADtB,8HAAA,8BAA8B,OAAA","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\nexport {\n  type PrimitiveConformanceCase,\n  type PrimitiveConformanceExample,\n  type PrimitiveConformanceHarness,\n  type PrimitiveConformanceHtmlOptions,\n  type PrimitiveConformanceSlackResult,\n  type PrimitiveConformanceSvgResult,\n  CONFORMANCE_FOREIGN_MARKER,\n  primitiveConformanceRows,\n  runPrimitiveInventoryConformance,\n} from './conformance';\nexport {\n  type PackRegistrationOptions,\n  assertPackRegistrationComplete,\n} from './registration';\n"]}

package/dist/cjs/testing/registration.js

@@ -0,0 +1,140 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertPackRegistrationComplete = void 0;
+// Node-only, and reached only through the `./testing` entry: this reads the
+// filesystem, which no rendering path may do.
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const ENTRY_FILES = ['index.tsx', 'index.ts'];
+/** Duck-typed so a definition from a different copy of the sdk still matches. */
+const isPrimitiveDefinition = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const { type, catalog, schema, renderers } = value;
+    return (typeof type === 'string' &&
+        typeof catalog === 'object' &&
+        catalog !== null &&
+        typeof schema === 'object' &&
+        schema !== null &&
+        typeof renderers === 'object' &&
+        renderers !== null);
+};
+const entryFileIn = (dir) => {
+    for (const name of ENTRY_FILES) {
+        const candidate = (0, node_path_1.join)(dir, name);
+        try {
+            if ((0, node_fs_1.statSync)(candidate).isFile()) {
+                return candidate;
+            }
+        }
+        catch {
+            // Not this name; try the next.
+        }
+    }
+    return undefined;
+};
+const subdirectoriesOf = (root, ignore) => (0, node_fs_1.readdirSync)(root, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory() && !ignore.includes(entry.name))
+    .map((entry) => entry.name)
+    .sort();
+/**
+ * Fails when the primitives directory and the pack's registry disagree: a
+ * subdirectory with no entry file or no exported definition, a defined type
+ * nothing registers, or a registered type no directory defines. Each problem
+ * line carries its fix.
+ *
+ * A pack keeps two hand-written lists, the registry array and the body-node
+ * union, and nothing in the type system relates either to the directory they
+ * describe. A primitive absent from both lists leaves them agreeing with each
+ * other, so it compiles and every other test passes while the primitive is
+ * unreachable. This is the check that notices.
+ *
+ * @example
+ * ```ts
+ * await assertPackRegistrationComplete({
+ *   primitivesDir: new URL('./primitives/', import.meta.url),
+ *   registered: slideDeckPrimitives,
+ * });
+ * ```
+ */
+const assertPackRegistrationComplete = async ({ primitivesDir, registered, ignore = [], }) => {
+    const root = typeof primitivesDir === 'string'
+        ? primitivesDir
+        : (0, node_url_1.fileURLToPath)(primitivesDir);
+    const registeredTypes = new Set(registered.map(({ type }) => type));
+    const problems = [];
+    const foundTypes = new Set();
+    for (const folder of subdirectoriesOf(root, ignore)) {
+        const entry = entryFileIn((0, node_path_1.join)(root, folder));
+        if (!entry) {
+            problems.push(`${folder}/ has no ${ENTRY_FILES.join(' or ')}; add one or pass it in \`ignore\`.`);
+            continue;
+        }
+        const module = (await Promise.resolve(`${(0, node_url_1.pathToFileURL)(entry).href}`).then(s => __importStar(require(s))));
+        const exported = Object.entries(module).filter(([, value]) => isPrimitiveDefinition(value));
+        if (exported.length === 0) {
+            problems.push(`${folder}/ exports no primitive definition; add one or pass it in \`ignore\`.`);
+            continue;
+        }
+        for (const [exportName, definition] of exported) {
+            foundTypes.add(definition.type);
+            if (registeredTypes.has(definition.type)) {
+                continue;
+            }
+            problems.push(`${folder}/ defines "${definition.type}" but nothing registers it.\n` +
+                `  Import \`${exportName}\` from './${folder}' and add it to the registry array,\n` +
+                `  then add its node type to the pack's body-node union.`);
+        }
+    }
+    for (const { type } of registered) {
+        if (!foundTypes.has(type)) {
+            problems.push(`"${type}" is registered but no directory under ${root} defines it.`);
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`Pack registration is incomplete:\n${problems.map((line) => `- ${line}`).join('\n')}`);
+    }
+};
+exports.assertPackRegistrationComplete = assertPackRegistrationComplete;
+//# sourceMappingURL=registration.js.map

package/dist/cjs/testing/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../src/testing/registration.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// Node-only, and reached only through the `./testing` entry: this reads the\n// filesystem, which no rendering path may do.\n\nimport { readdirSync, statSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\n\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\n/** What {@link assertPackRegistrationComplete} needs to compare a pack against its directory. */\nexport interface PackRegistrationOptions {\n  /** Directory whose subdirectories are one primitive each. A `URL` is resolved with `fileURLToPath`. */\n  primitivesDir: URL | string;\n  /** The pack's registry array, as passed to `definePrimitivePack`. */\n  registered: readonly AnyPrimitiveDefinition[];\n  /** Subdirectory names that hold no primitive. */\n  ignore?: readonly string[];\n}\n\nconst ENTRY_FILES = ['index.tsx', 'index.ts'] as const;\n\n/** Duck-typed so a definition from a different copy of the sdk still matches. */\nconst isPrimitiveDefinition = (\n  value: unknown\n): value is AnyPrimitiveDefinition => {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const { type, catalog, schema, renderers } = value as Record<string, unknown>;\n  return (\n    typeof type === 'string' &&\n    typeof catalog === 'object' &&\n    catalog !== null &&\n    typeof schema === 'object' &&\n    schema !== null &&\n    typeof renderers === 'object' &&\n    renderers !== null\n  );\n};\n\nconst entryFileIn = (dir: string): string | undefined => {\n  for (const name of ENTRY_FILES) {\n    const candidate = join(dir, name);\n    try {\n      if (statSync(candidate).isFile()) {\n        return candidate;\n      }\n    } catch {\n      // Not this name; try the next.\n    }\n  }\n  return undefined;\n};\n\nconst subdirectoriesOf = (root: string, ignore: readonly string[]): string[] =>\n  readdirSync(root, { withFileTypes: true })\n    .filter((entry) => entry.isDirectory() && !ignore.includes(entry.name))\n    .map((entry) => entry.name)\n    .sort();\n\n/**\n * Fails when the primitives directory and the pack's registry disagree: a\n * subdirectory with no entry file or no exported definition, a defined type\n * nothing registers, or a registered type no directory defines. Each problem\n * line carries its fix.\n *\n * A pack keeps two hand-written lists, the registry array and the body-node\n * union, and nothing in the type system relates either to the directory they\n * describe. A primitive absent from both lists leaves them agreeing with each\n * other, so it compiles and every other test passes while the primitive is\n * unreachable. This is the check that notices.\n *\n * @example\n * ```ts\n * await assertPackRegistrationComplete({\n *   primitivesDir: new URL('./primitives/', import.meta.url),\n *   registered: slideDeckPrimitives,\n * });\n * ```\n */\nexport const assertPackRegistrationComplete = async ({\n  primitivesDir,\n  registered,\n  ignore = [],\n}: PackRegistrationOptions): Promise<void> => {\n  const root =\n    typeof primitivesDir === 'string'\n      ? primitivesDir\n      : fileURLToPath(primitivesDir);\n  const registeredTypes = new Set(registered.map(({ type }) => type));\n  const problems: string[] = [];\n  const foundTypes = new Set<string>();\n\n  for (const folder of subdirectoriesOf(root, ignore)) {\n    const entry = entryFileIn(join(root, folder));\n    if (!entry) {\n      problems.push(\n        `${folder}/ has no ${ENTRY_FILES.join(' or ')}; add one or pass it in \\`ignore\\`.`\n      );\n      continue;\n    }\n\n    const module = (await import(pathToFileURL(entry).href)) as Record<\n      string,\n      unknown\n    >;\n    const exported = Object.entries(module).filter(([, value]) =>\n      isPrimitiveDefinition(value)\n    ) as Array<[string, AnyPrimitiveDefinition]>;\n\n    if (exported.length === 0) {\n      problems.push(\n        `${folder}/ exports no primitive definition; add one or pass it in \\`ignore\\`.`\n      );\n      continue;\n    }\n\n    for (const [exportName, definition] of exported) {\n      foundTypes.add(definition.type);\n      if (registeredTypes.has(definition.type)) {\n        continue;\n      }\n      problems.push(\n        `${folder}/ defines \"${definition.type}\" but nothing registers it.\\n` +\n          `  Import \\`${exportName}\\` from './${folder}' and add it to the registry array,\\n` +\n          `  then add its node type to the pack's body-node union.`\n      );\n    }\n  }\n\n  for (const { type } of registered) {\n    if (!foundTypes.has(type)) {\n      problems.push(\n        `\"${type}\" is registered but no directory under ${root} defines it.`\n      );\n    }\n  }\n\n  if (problems.length > 0) {\n    throw new Error(\n      `Pack registration is incomplete:\\n${problems.map((line) => `- ${line}`).join('\\n')}`\n    );\n  }\n};\n"]}