@elastic/isomer-sdk 0.0.0 → 0.1.0

package/dist/render/text/envelope.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+/** The composition as plain text: title uppercased, subtitle, then nodes. */
+export const renderTextEnvelope = (composition, dispatcher, { heading = true } = {}) => {
+    const lines = [
+        ...(heading
+            ? [composition.title?.toUpperCase(), composition.subtitle]
+            : []),
+        ...composition.body.map((node) => dispatcher.renderText(node)),
+    ].filter(Boolean);
+    return lines.join('\n\n');
+};
+//# sourceMappingURL=envelope.js.map

package/dist/render/text/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/render/text/envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,WAA+B,EAC/B,UAAyC,EACzC,EAAE,OAAO,GAAG,IAAI,KAA0B,EAAE,EACpC,EAAE;IACV,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,OAAO;YACT,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC;YAC1D,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;KAC/D,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC,CAAC","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\nimport type { Composition } from '../../composition/composition';\nimport type { PrimitiveNode } from '../../define/primitive_module';\n\n/** A pack's plain-text renderer for one node of its own type. */\nexport interface TextEnvelopeDispatcher<TNode extends PrimitiveNode> {\n  /** Returns the empty string for a node with nothing to show; the envelope drops it rather than emitting a blank paragraph. */\n  renderText(node: TNode): string;\n}\n\n/** Options for {@link renderTextEnvelope}. */\nexport interface TextEnvelopeOptions {\n  /** Renders the composition's title and subtitle. Defaults to `true`. Pass `false` when the host already shows the title, or the body opens with its own. */\n  heading?: boolean;\n}\n\n/** The composition as plain text: title uppercased, subtitle, then nodes. */\nexport const renderTextEnvelope = <TNode extends PrimitiveNode>(\n  composition: Composition<TNode>,\n  dispatcher: TextEnvelopeDispatcher<TNode>,\n  { heading = true }: TextEnvelopeOptions = {}\n): string => {\n  const lines = [\n    ...(heading\n      ? [composition.title?.toUpperCase(), composition.subtitle]\n      : []),\n    ...composition.body.map((node) => dispatcher.renderText(node)),\n  ].filter(Boolean);\n\n  return lines.join('\\n\\n');\n};\n"]}

package/dist/render/text/index.d.ts

@@ -0,0 +1,2 @@
+export { type TextEnvelopeDispatcher, type TextEnvelopeOptions, renderTextEnvelope, } from './envelope.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/render/text/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/text/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/render/text/index.js

@@ -0,0 +1,8 @@
+/*
+ * 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.
+ */
+export { renderTextEnvelope, } from './envelope.js';
+//# sourceMappingURL=index.js.map

package/dist/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,OAAO,EAGL,kBAAkB,GACnB,MAAM,YAAY,CAAC","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/testing/conformance.d.ts

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

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

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

package/dist/testing/conformance.js

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

package/dist/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../src/testing/conformance.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n// The behaviour every primitive definition owes its callers, expressed once.\n//\n// Framework-agnostic on purpose: only `node:assert/strict` and Node builtins,\n// so this ships on a public entry without dragging vitest into a vocabulary\n// package's dependency set. Each pack drives the array with `it.each`, so a\n// second vocabulary costs one package and one test file.\n\nimport assert from 'node:assert/strict';\n\nimport type { ChildNodeWalker } from '../composition/body_node_base';\nimport type { Composition } from '../composition/composition';\nimport type { ValidationError } from '../composition/validation_error';\nimport 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/testing/index.d.ts

@@ -0,0 +1,3 @@
+export { type PrimitiveConformanceCase, type PrimitiveConformanceExample, type PrimitiveConformanceHarness, type PrimitiveConformanceHtmlOptions, type PrimitiveConformanceSlackResult, type PrimitiveConformanceSvgResult, CONFORMANCE_FOREIGN_MARKER, primitiveConformanceRows, runPrimitiveInventoryConformance, } from './conformance.js';
+export { type PackRegistrationOptions, assertPackRegistrationComplete, } from './registration.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,0BAA0B,EAC1B,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,uBAAuB,EAC5B,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,9 @@
+/*
+ * 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.
+ */
+export { CONFORMANCE_FOREIGN_MARKER, primitiveConformanceRows, runPrimitiveInventoryConformance, } from './conformance.js';
+export { assertPackRegistrationComplete, } from './registration.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAOL,0BAA0B,EAC1B,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC","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/testing/registration.d.ts

@@ -0,0 +1,32 @@
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+/** What {@link assertPackRegistrationComplete} needs to compare a pack against its directory. */
+export interface PackRegistrationOptions {
+    /** Directory whose subdirectories are one primitive each. A `URL` is resolved with `fileURLToPath`. */
+    primitivesDir: URL | string;
+    /** The pack's registry array, as passed to `definePrimitivePack`. */
+    registered: readonly AnyPrimitiveDefinition[];
+    /** Subdirectory names that hold no primitive. */
+    ignore?: readonly string[];
+}
+/**
+ * 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,
+ * });
+ * ```
+ */
+export declare const assertPackRegistrationComplete: ({ primitivesDir, registered, ignore, }: PackRegistrationOptions) => Promise<void>;
+//# sourceMappingURL=registration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../src/testing/registration.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,iGAAiG;AACjG,MAAM,WAAW,uBAAuB;IACtC,uGAAuG;IACvG,aAAa,EAAE,GAAG,GAAG,MAAM,CAAC;IAC5B,qEAAqE;IACrE,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC9C,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AA2CD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,8BAA8B,GAAU,wCAIlD,uBAAuB,KAAG,OAAO,CAAC,IAAI,CA2DxC,CAAC"}