@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/render/markdown/format.js

@@ -0,0 +1,202 @@
+/*
+ * 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.
+ */
+import { fromMarkdown } from 'mdast-util-from-markdown';
+import { gfmFromMarkdown } from 'mdast-util-gfm';
+import { gfm } from 'micromark-extension-gfm';
+import { BLOCKED_HREF, sanitizeParsedAssetUrl, sanitizeParsedNavigationHref, } from '../../validate/url.js';
+// Escapes label characters that could close a `[...]` early and smuggle in a
+// hostile destination of their own.
+const escapeLinkLabel = (label) => label.replace(/[[\]\\]/g, '\\$&');
+// Percent-encodes destination characters that would terminate the `(...)`
+// early or read as a link title. `encodeURIComponent` leaves `(` and `)`
+// unescaped by spec, so those two are mapped by hand.
+const escapeLinkDestination = (href) => href.replace(/[()\s\\]/g, (char) => {
+    if (char === '(')
+        return '%28';
+    if (char === ')')
+        return '%29';
+    return encodeURIComponent(char);
+});
+const escapeParsedDestination = (href) => escapeLinkDestination(href.replace(/&/g, '&'));
+let parseOptions;
+const parse = (source) => fromMarkdown(source, (parseOptions ??= {
+    extensions: [gfm()],
+    mdastExtensions: [gfmFromMarkdown()],
+}));
+/** `markdown` as flat GFM mdast blocks, typed `unknown` so no declaration names mdast; `null` past the parse budget or the parser's recursion depth. */
+export const parseGfmBlocks = (markdown) => {
+    if (exceedsParseBudget(markdown))
+        return null;
+    try {
+        return parse(markdown).children;
+    }
+    catch (error) {
+        if (!(error instanceof RangeError))
+            throw error;
+        return null;
+    }
+};
+// Each pass can expose a new sink (an escaped HTML block reveals the Markdown
+// inside it; a blocked link's label may close an outer `](`), so passes repeat
+// until the source is stable.
+const MAX_PASSES = 16;
+const escapeTitle = (title) => `"${title.replace(/["\\]/g, '\\$&')}"`;
+const offsets = (node) => {
+    const start = node.position?.start.offset;
+    const end = node.position?.end.offset;
+    return start === undefined || end === undefined ? undefined : [start, end];
+};
+const sanitizePass = (source) => {
+    const root = parse(source);
+    const definitions = new Map();
+    const pending = [...root.children].reverse();
+    while (pending.length) {
+        const node = pending.pop();
+        if (node.type === 'definition' && !definitions.has(node.identifier)) {
+            definitions.set(node.identifier, node);
+        }
+        if ('children' in node)
+            pending.push(...[...node.children].reverse());
+    }
+    const slice = (node) => {
+        const range = offsets(node);
+        return range ? source.slice(...range) : '';
+    };
+    const emitChildren = (start, end, children) => {
+        let out = '';
+        let cursor = start;
+        for (const child of children) {
+            const range = offsets(child);
+            if (!range)
+                continue;
+            out += source.slice(cursor, range[0]) + emit(child);
+            cursor = range[1];
+        }
+        return out + source.slice(cursor, end);
+    };
+    const emitLabel = (node) => {
+        const first = node.children[0];
+        const last = node.children[node.children.length - 1];
+        const from = first && offsets(first);
+        const to = last && offsets(last);
+        return from && to ? emitChildren(from[0], to[1], node.children) : '';
+    };
+    const rewrite = (node) => {
+        switch (node.type) {
+            case 'html':
+                return slice(node).replace(/</g, '&lt;');
+            case 'definition': {
+                const safe = sanitizeParsedNavigationHref(node.url) ??
+                    sanitizeParsedAssetUrl(node.url);
+                if (safe === node.url)
+                    return undefined;
+                const title = node.title ? ` ${escapeTitle(node.title)}` : '';
+                return `[${node.label ?? node.identifier}]: ${safe === null ? BLOCKED_HREF : escapeParsedDestination(safe)}${title}`;
+            }
+            case 'imageReference': {
+                const definition = definitions.get(node.identifier);
+                return definition && sanitizeParsedAssetUrl(definition.url) === null
+                    ? escapeLinkLabel(node.alt ?? '')
+                    : undefined;
+            }
+            case 'linkReference': {
+                const definition = definitions.get(node.identifier);
+                return definition &&
+                    sanitizeParsedNavigationHref(definition.url) === null &&
+                    sanitizeParsedAssetUrl(definition.url) !== null
+                    ? emitLabel(node)
+                    : undefined;
+            }
+            case 'image': {
+                const safe = sanitizeParsedAssetUrl(node.url);
+                if (safe === null)
+                    return escapeLinkLabel(node.alt ?? '');
+                if (safe === node.url)
+                    return undefined;
+                const title = node.title ? ` ${escapeTitle(node.title)}` : '';
+                return `![${escapeLinkLabel(node.alt ?? '')}](${escapeParsedDestination(safe)}${title})`;
+            }
+            case 'link': {
+                const raw = slice(node);
+                const safe = sanitizeParsedNavigationHref(node.url);
+                if (raw.startsWith('<')) {
+                    return safe === null ? raw.slice(1, -1) : undefined;
+                }
+                // A GFM literal (`www.x.com`) is http(s) or mailto by construction.
+                if (!raw.startsWith('['))
+                    return undefined;
+                if (safe === null)
+                    return emitLabel(node);
+                if (safe === node.url)
+                    return undefined;
+                const title = node.title ? ` ${escapeTitle(node.title)}` : '';
+                return `[${emitLabel(node)}](${escapeParsedDestination(safe)}${title})`;
+            }
+            default:
+                return undefined;
+        }
+    };
+    const emit = (node) => {
+        const replaced = rewrite(node);
+        if (replaced !== undefined)
+            return replaced;
+        const range = offsets(node);
+        if (!range)
+            return '';
+        return 'children' in node
+            ? emitChildren(range[0], range[1], node.children)
+            : source.slice(...range);
+    };
+    return emitChildren(0, source.length, root.children);
+};
+/** {@link sanitizeMarkdownSource}'s result, and whether it degraded to inert text. */
+export const sanitizeAuthoredSource = (markdown) => {
+    if (exceedsParseBudget(markdown)) {
+        return { markdown: inert(markdown), inert: true };
+    }
+    let current = markdown;
+    try {
+        for (let pass = 0; pass < MAX_PASSES; pass++) {
+            const next = sanitizePass(current);
+            if (next === current)
+                return { markdown: current, inert: false };
+            current = next;
+        }
+    }
+    catch (error) {
+        // The parser recurses per nesting level, so inline nesting deep enough
+        // to exhaust the stack lands here.
+        if (!(error instanceof RangeError))
+            throw error;
+    }
+    return { markdown: inert(current), inert: true };
+};
+/** Sanitizes GFM destinations and HTML; excessive syntax or length degrades to inert text. */
+export const sanitizeMarkdownSource = (markdown) => sanitizeAuthoredSource(markdown).markdown;
+// No link, image, definition, or tag can survive without `[` or `<`.
+const inert = (markdown) => markdown.replace(/[[\]\\]/g, '\\$&').replace(/</g, '&lt;');
+// GFM parsing is superlinear for some delimiter runs, even without nesting.
+const LINE_PREFIX_RE = /^(?:[ \t>]|[-*+](?=[ \t])|\d{1,9}[.)](?=[ \t]))+/gm;
+const MAX_LINE_PREFIX = 256;
+const INLINE_DELIMITER_RE = /[[\]*`~<>|\\]|(?<![\p{L}\p{N}])_|_(?![\p{L}\p{N}])/gu;
+const MAX_INLINE_DELIMITERS = 2048;
+const MAX_PARSE_LENGTH = 16_384;
+const exceedsParseBudget = (markdown) => {
+    if (markdown.length > MAX_PARSE_LENGTH)
+        return true;
+    for (const [prefix] of markdown.matchAll(LINE_PREFIX_RE)) {
+        if (prefix.length > MAX_LINE_PREFIX)
+            return true;
+    }
+    let delimiters = 0;
+    for (const _ of markdown.matchAll(INLINE_DELIMITER_RE)) {
+        if (++delimiters > MAX_INLINE_DELIMITERS)
+            return true;
+    }
+    return false;
+};
+//# sourceMappingURL=format.js.map

package/dist/render/markdown/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/render/markdown/format.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// Authored Markdown source made safe to print, for `md.authored`, and the GFM\n// parse it shares with the Slack fallback.\n\nimport type { Definition, Nodes, Parents, Root } from 'mdast';\nimport { fromMarkdown } from 'mdast-util-from-markdown';\nimport { gfmFromMarkdown } from 'mdast-util-gfm';\nimport { gfm } from 'micromark-extension-gfm';\n\nimport {\n  BLOCKED_HREF,\n  sanitizeParsedAssetUrl,\n  sanitizeParsedNavigationHref,\n} from '../../validate/url';\n\n// Escapes label characters that could close a `[...]` early and smuggle in a\n// hostile destination of their own.\nconst escapeLinkLabel = (label: string): string =>\n  label.replace(/[[\\]\\\\]/g, '\\\\$&');\n\n// Percent-encodes destination characters that would terminate the `(...)`\n// early or read as a link title. `encodeURIComponent` leaves `(` and `)`\n// unescaped by spec, so those two are mapped by hand.\nconst escapeLinkDestination = (href: string): string =>\n  href.replace(/[()\\s\\\\]/g, (char) => {\n    if (char === '(') return '%28';\n    if (char === ')') return '%29';\n    return encodeURIComponent(char);\n  });\n\nconst escapeParsedDestination = (href: string): string =>\n  escapeLinkDestination(href.replace(/&/g, '&amp;'));\n\nlet parseOptions: Parameters<typeof fromMarkdown>[1] | undefined;\n\nconst parse = (source: string): Root =>\n  fromMarkdown(\n    source,\n    (parseOptions ??= {\n      extensions: [gfm()],\n      mdastExtensions: [gfmFromMarkdown()],\n    })\n  );\n\n/** `markdown` as flat GFM mdast blocks, typed `unknown` so no declaration names mdast; `null` past the parse budget or the parser's recursion depth. */\nexport const parseGfmBlocks = (markdown: string): readonly unknown[] | null => {\n  if (exceedsParseBudget(markdown)) return null;\n  try {\n    return parse(markdown).children;\n  } catch (error) {\n    if (!(error instanceof RangeError)) throw error;\n    return null;\n  }\n};\n\n// Each pass can expose a new sink (an escaped HTML block reveals the Markdown\n// inside it; a blocked link's label may close an outer `](`), so passes repeat\n// until the source is stable.\nconst MAX_PASSES = 16;\n\nconst escapeTitle = (title: string): string =>\n  `\"${title.replace(/[\"\\\\]/g, '\\\\$&')}\"`;\n\nconst offsets = (node: Nodes): [number, number] | undefined => {\n  const start = node.position?.start.offset;\n  const end = node.position?.end.offset;\n  return start === undefined || end === undefined ? undefined : [start, end];\n};\n\nconst sanitizePass = (source: string): string => {\n  const root = parse(source);\n  const definitions = new Map<string, Definition>();\n  const pending: Nodes[] = [...root.children].reverse();\n  while (pending.length) {\n    const node = pending.pop()!;\n    if (node.type === 'definition' && !definitions.has(node.identifier)) {\n      definitions.set(node.identifier, node);\n    }\n    if ('children' in node) pending.push(...[...node.children].reverse());\n  }\n\n  const slice = (node: Nodes): string => {\n    const range = offsets(node);\n    return range ? source.slice(...range) : '';\n  };\n\n  const emitChildren = (\n    start: number,\n    end: number,\n    children: readonly Nodes[]\n  ): string => {\n    let out = '';\n    let cursor = start;\n    for (const child of children) {\n      const range = offsets(child);\n      if (!range) continue;\n      out += source.slice(cursor, range[0]) + emit(child);\n      cursor = range[1];\n    }\n    return out + source.slice(cursor, end);\n  };\n\n  const emitLabel = (node: Parents): string => {\n    const first = node.children[0];\n    const last = node.children[node.children.length - 1];\n    const from = first && offsets(first);\n    const to = last && offsets(last);\n    return from && to ? emitChildren(from[0], to[1], node.children) : '';\n  };\n\n  const rewrite = (node: Nodes): string | undefined => {\n    switch (node.type) {\n      case 'html':\n        return slice(node).replace(/</g, '&lt;');\n      case 'definition': {\n        const safe =\n          sanitizeParsedNavigationHref(node.url) ??\n          sanitizeParsedAssetUrl(node.url);\n        if (safe === node.url) return undefined;\n        const title = node.title ? ` ${escapeTitle(node.title)}` : '';\n        return `[${node.label ?? node.identifier}]: ${\n          safe === null ? BLOCKED_HREF : escapeParsedDestination(safe)\n        }${title}`;\n      }\n      case 'imageReference': {\n        const definition = definitions.get(node.identifier);\n        return definition && sanitizeParsedAssetUrl(definition.url) === null\n          ? escapeLinkLabel(node.alt ?? '')\n          : undefined;\n      }\n      case 'linkReference': {\n        const definition = definitions.get(node.identifier);\n        return definition &&\n          sanitizeParsedNavigationHref(definition.url) === null &&\n          sanitizeParsedAssetUrl(definition.url) !== null\n          ? emitLabel(node)\n          : undefined;\n      }\n      case 'image': {\n        const safe = sanitizeParsedAssetUrl(node.url);\n        if (safe === null) return escapeLinkLabel(node.alt ?? '');\n        if (safe === node.url) return undefined;\n        const title = node.title ? ` ${escapeTitle(node.title)}` : '';\n        return `![${escapeLinkLabel(node.alt ?? '')}](${escapeParsedDestination(\n          safe\n        )}${title})`;\n      }\n      case 'link': {\n        const raw = slice(node);\n        const safe = sanitizeParsedNavigationHref(node.url);\n        if (raw.startsWith('<')) {\n          return safe === null ? raw.slice(1, -1) : undefined;\n        }\n        // A GFM literal (`www.x.com`) is http(s) or mailto by construction.\n        if (!raw.startsWith('[')) return undefined;\n        if (safe === null) return emitLabel(node);\n        if (safe === node.url) return undefined;\n        const title = node.title ? ` ${escapeTitle(node.title)}` : '';\n        return `[${emitLabel(node)}](${escapeParsedDestination(safe)}${title})`;\n      }\n      default:\n        return undefined;\n    }\n  };\n\n  const emit = (node: Nodes): string => {\n    const replaced = rewrite(node);\n    if (replaced !== undefined) return replaced;\n    const range = offsets(node);\n    if (!range) return '';\n    return 'children' in node\n      ? emitChildren(range[0], range[1], node.children)\n      : source.slice(...range);\n  };\n\n  return emitChildren(0, source.length, root.children);\n};\n\n/** {@link sanitizeMarkdownSource}'s result, and whether it degraded to inert text. */\nexport const sanitizeAuthoredSource = (\n  markdown: string\n): { markdown: string; inert: boolean } => {\n  if (exceedsParseBudget(markdown)) {\n    return { markdown: inert(markdown), inert: true };\n  }\n  let current = markdown;\n  try {\n    for (let pass = 0; pass < MAX_PASSES; pass++) {\n      const next = sanitizePass(current);\n      if (next === current) return { markdown: current, inert: false };\n      current = next;\n    }\n  } catch (error) {\n    // The parser recurses per nesting level, so inline nesting deep enough\n    // to exhaust the stack lands here.\n    if (!(error instanceof RangeError)) throw error;\n  }\n  return { markdown: inert(current), inert: true };\n};\n\n/** Sanitizes GFM destinations and HTML; excessive syntax or length degrades to inert text. */\nexport const sanitizeMarkdownSource = (markdown: string): string =>\n  sanitizeAuthoredSource(markdown).markdown;\n\n// No link, image, definition, or tag can survive without `[` or `<`.\nconst inert = (markdown: string): string =>\n  markdown.replace(/[[\\]\\\\]/g, '\\\\$&').replace(/</g, '&lt;');\n\n// GFM parsing is superlinear for some delimiter runs, even without nesting.\nconst LINE_PREFIX_RE = /^(?:[ \\t>]|[-*+](?=[ \\t])|\\d{1,9}[.)](?=[ \\t]))+/gm;\nconst MAX_LINE_PREFIX = 256;\nconst INLINE_DELIMITER_RE =\n  /[[\\]*`~<>|\\\\]|(?<![\\p{L}\\p{N}])_|_(?![\\p{L}\\p{N}])/gu;\nconst MAX_INLINE_DELIMITERS = 2048;\n\nconst MAX_PARSE_LENGTH = 16_384;\n\nconst exceedsParseBudget = (markdown: string): boolean => {\n  if (markdown.length > MAX_PARSE_LENGTH) return true;\n  for (const [prefix] of markdown.matchAll(LINE_PREFIX_RE)) {\n    if (prefix.length > MAX_LINE_PREFIX) return true;\n  }\n  let delimiters = 0;\n  for (const _ of markdown.matchAll(INLINE_DELIMITER_RE)) {\n    if (++delimiters > MAX_INLINE_DELIMITERS) return true;\n  }\n  return false;\n};\n"]}

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

@@ -0,0 +1,3 @@
+export { md, serializeMarkdown } from './builder.js';
+export { type MarkdownEnvelopeDispatcher, type MarkdownEnvelopeOptions, renderMarkdownEnvelope, } from './envelope.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/markdown/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/render/markdown/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 { md, serializeMarkdown } from './builder.js';
+export { renderMarkdownEnvelope, } from './envelope.js';
+//# sourceMappingURL=index.js.map

package/dist/render/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/render/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EAGL,sBAAsB,GACvB,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 { md, serializeMarkdown } from './builder';\n\nexport {\n  type MarkdownEnvelopeDispatcher,\n  type MarkdownEnvelopeOptions,\n  renderMarkdownEnvelope,\n} from './envelope';\n"]}

package/dist/render/measure_dom.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutBox } from './layout_check.js';
+/**
+ * The {@link LayoutBox} tree a browser laid `root` out as, measured from
+ * `root`'s top left, for `checkLayout`. An HTML element's `scale` is its
+ * drawn size over its layout size, so a rotated one reads as scaled; an SVG
+ * element has no layout size and is never scaled. jsdom does no layout, so
+ * every box it measures is empty.
+ */
+export declare const measureDom: (root: Element) => LayoutBox;
+//# sourceMappingURL=measure_dom.d.ts.map

package/dist/render/measure_dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure_dom.d.ts","sourceRoot":"","sources":["../../src/render/measure_dom.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,gBAAgB,CAAC;AAuB5D;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,OAAO,KAAG,SAmC1C,CAAC"}

package/dist/render/measure_dom.js

@@ -0,0 +1,57 @@
+/*
+ * 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.
+ */
+const TEXT_NODE = 3;
+const unlisted = new Set(['class', 'id', 'style']);
+/** Drawn size over layout size, within a pixel of `offsetWidth`'s rounding. */
+const axisScale = (drawn, laid) => laid > 0 && Math.abs(drawn - laid) > 1 ? drawn / laid : 1;
+const scaleOf = (element, { width, height }) => {
+    if (!('offsetWidth' in element)) {
+        return 1;
+    }
+    const { offsetWidth, offsetHeight } = element;
+    const scaleX = axisScale(width, offsetWidth);
+    const scaleY = axisScale(height, offsetHeight);
+    return Math.abs(scaleY - 1) > Math.abs(scaleX - 1) ? scaleY : scaleX;
+};
+/**
+ * The {@link LayoutBox} tree a browser laid `root` out as, measured from
+ * `root`'s top left, for `checkLayout`. An HTML element's `scale` is its
+ * drawn size over its layout size, so a rotated one reads as scaled; an SVG
+ * element has no layout size and is never scaled. jsdom does no layout, so
+ * every box it measures is empty.
+ */
+export const measureDom = (root) => {
+    const origin = root.getBoundingClientRect();
+    const range = root.ownerDocument.createRange();
+    const place = ({ x, y, width, height }) => ({
+        x: x - origin.x,
+        y: y - origin.y,
+        width,
+        height,
+    });
+    const measure = (element) => {
+        const rect = element.getBoundingClientRect();
+        const scale = scaleOf(element, rect);
+        const attributes = Object.fromEntries(Array.from(element.attributes)
+            .filter(({ name }) => !unlisted.has(name))
+            .map(({ name, value }) => [name, value]));
+        return {
+            ...place(rect),
+            ...(scale !== 1 && { scale }),
+            runs: Array.from(element.childNodes)
+                .filter((node) => node.nodeType === TEXT_NODE && node.textContent?.trim())
+                .flatMap((node) => {
+                range.selectNodeContents(node);
+                return Array.from(range.getClientRects(), place);
+            }),
+            ...(Object.keys(attributes).length > 0 && { attributes }),
+            children: Array.from(element.children, measure),
+        };
+    };
+    return measure(root);
+};
+//# sourceMappingURL=measure_dom.js.map

package/dist/render/measure_dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure_dom.js","sourceRoot":"","sources":["../../src/render/measure_dom.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\nimport type { LayoutBox, LayoutRect } from './layout_check';\n\nconst TEXT_NODE = 3;\n\nconst unlisted = new Set(['class', 'id', 'style']);\n\n/** Drawn size over layout size, within a pixel of `offsetWidth`'s rounding. */\nconst axisScale = (drawn: number, laid: number): number =>\n  laid > 0 && Math.abs(drawn - laid) > 1 ? drawn / laid : 1;\n\nconst scaleOf = (\n  element: Element,\n  { width, height }: DOMRectReadOnly\n): number => {\n  if (!('offsetWidth' in element)) {\n    return 1;\n  }\n  const { offsetWidth, offsetHeight } = element as HTMLElement;\n  const scaleX = axisScale(width, offsetWidth);\n  const scaleY = axisScale(height, offsetHeight);\n  return Math.abs(scaleY - 1) > Math.abs(scaleX - 1) ? scaleY : scaleX;\n};\n\n/**\n * The {@link LayoutBox} tree a browser laid `root` out as, measured from\n * `root`'s top left, for `checkLayout`. An HTML element's `scale` is its\n * drawn size over its layout size, so a rotated one reads as scaled; an SVG\n * element has no layout size and is never scaled. jsdom does no layout, so\n * every box it measures is empty.\n */\nexport const measureDom = (root: Element): LayoutBox => {\n  const origin = root.getBoundingClientRect();\n  const range = root.ownerDocument.createRange();\n  const place = ({ x, y, width, height }: DOMRectReadOnly): LayoutRect => ({\n    x: x - origin.x,\n    y: y - origin.y,\n    width,\n    height,\n  });\n\n  const measure = (element: Element): LayoutBox => {\n    const rect = element.getBoundingClientRect();\n    const scale = scaleOf(element, rect);\n    const attributes = Object.fromEntries(\n      Array.from(element.attributes)\n        .filter(({ name }) => !unlisted.has(name))\n        .map(({ name, value }): [string, string] => [name, value])\n    );\n    return {\n      ...place(rect),\n      ...(scale !== 1 && { scale }),\n      runs: Array.from(element.childNodes)\n        .filter(\n          (node) => node.nodeType === TEXT_NODE && node.textContent?.trim()\n        )\n        .flatMap((node) => {\n          range.selectNodeContents(node);\n          return Array.from(range.getClientRects(), place);\n        }),\n      ...(Object.keys(attributes).length > 0 && { attributes }),\n      children: Array.from(element.children, measure),\n    };\n  };\n\n  return measure(root);\n};\n"]}

package/dist/render/payload.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Byte sizes of one rendered payload.
+ *
+ * `html` counts markup only: inlined CSS and script bytes are subtracted out
+ * and reported under `css` / `js`. `total` counts each part exactly once,
+ * whether or not the CSS was inlined.
+ */
+export interface PayloadMeasurement {
+    html: number;
+    css: number;
+    js: number;
+    total: number;
+}
+/** UTF-8 byte length of `value`, which is not `length` for non-ASCII text. */
+export declare const byteLength: (value: string) => number;
+//# sourceMappingURL=payload.d.ts.map

package/dist/render/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/render/payload.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8EAA8E;AAC9E,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MACH,CAAC"}

package/dist/render/payload.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.
+ */
+/** UTF-8 byte length of `value`, which is not `length` for non-ASCII text. */
+export const byteLength = (value) => new TextEncoder().encode(value).length;
+//# sourceMappingURL=payload.js.map

package/dist/render/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/render/payload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAClD,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,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\n/**\n * Byte sizes of one rendered payload.\n *\n * `html` counts markup only: inlined CSS and script bytes are subtracted out\n * and reported under `css` / `js`. `total` counts each part exactly once,\n * whether or not the CSS was inlined.\n */\nexport interface PayloadMeasurement {\n  html: number;\n  css: number;\n  js: number;\n  total: number;\n}\n\n/** UTF-8 byte length of `value`, which is not `length` for non-ASCII text. */\nexport const byteLength = (value: string): number =>\n  new TextEncoder().encode(value).length;\n"]}

package/dist/render/primitive_dispatch.d.ts

@@ -0,0 +1,72 @@
+import { type ReactNode } from 'react';
+import { type SurfaceName } from '../composition/body_node_base.js';
+import type { ValidationError } from '../composition/validation_error.js';
+import type { MarkdownContent } from '../define/markdown_content.js';
+import { type AnyPrimitiveDefinition, type DefaultPackTypes, type PackTypes, type PrimitiveNode, type PrimitiveStyleCollectionContext, type ReactContextArg, type SurfaceMap } from '../define/primitive_module.js';
+/**
+ * Renders a node on any surface by looking its `type` up in one flattened
+ * inventory.
+ *
+ * The seam that makes packs composable: a container recurses through the
+ * {@link RenderScope} it is passed rather than through its own pack, so a node
+ * owned by another pack still renders.
+ */
+export interface PrimitiveDispatcher<TNode extends PrimitiveNode, T extends PackTypes = DefaultPackTypes> {
+    /** Every primitive this dispatcher can reach, across all composed packs. */
+    readonly definitions: readonly AnyPrimitiveDefinition[];
+    /** Throws for an unknown node type; a missing primitive is a bug, not a degradation. */
+    getDefinition(node: TNode): AnyPrimitiveDefinition;
+    /** `undefined` when the node is hidden from `surface`, `sanitize` drops it, or the primitive declares no renderer for `surface`. */
+    renderOn<S extends SurfaceName>(surface: S, node: TNode, extras: Omit<SurfaceMap<T>[S]['env'], 'scope'>): SurfaceMap<T>[S]['output'] | undefined;
+    /** The node's `react` renderer, or `undefined` when it is hidden or has none. `context` may be omitted only when `{}` is a complete context for the pack. */
+    renderReact(node: TNode, ...context: ReactContextArg<T['context']>): ReactNode;
+    /** Mutates `styles` with this node's contribution. */
+    collectStyles(node: TNode, styles: T['collector'], context: PrimitiveStyleCollectionContext): void;
+    /**
+     * The node's `react` renderer, gated on `snapshot` visibility and keyed for a
+     * frame's sibling list. `key` must be unique among those siblings.
+     * `theme` is the frame's resolved palette for this render, or `undefined`
+     * outside a frame.
+     */
+    renderSnapshot(node: TNode, context: T['context'], theme: T['theme'] | undefined, key: string): ReactNode;
+    /** `''` when the node is hidden from `text` or its primitive declares no `text` renderer. */
+    renderText(node: TNode): string;
+    /** The node's content serialized as GFM. */
+    renderMarkdown(node: TNode): string;
+    /** Empty when the node is hidden from `markdown`. */
+    renderMarkdownContent(node: TNode): MarkdownContent;
+    /**
+     * Empty when the node is hidden from `slack`, `sanitize` drops it, or its
+     * renderer returns nothing. A node with no `slack` renderer degrades through
+     * its markdown; one `isSlackAssetType` names becomes an `image` block when
+     * `collector` can allocate.
+     */
+    renderSlack(node: TNode, collector?: T['slackCollector']): readonly T['slackBlock'][];
+    /** `0` when the node is hidden from `snapshot` or its primitive declares no `metrics.snapshotHeight`. */
+    estimateSnapshotHeight(node: TNode): number;
+    /**
+     * Appends schema failures under `path` to `errors`, each naming `node`'s
+     * type, and an unknown key on `node` listing the fields it declares.
+     */
+    validate(node: TNode, path: string, errors: ValidationError[]): void;
+}
+/** Runtime facts {@link createPrimitiveDispatcher} cannot derive from the inventory. */
+export interface PrimitiveDispatcherOptions {
+    /** Names this dispatcher in error messages. */
+    label?: string;
+    /**
+     * Which node types render as a picture rather than as text, so the Slack
+     * surface uploads an image instead of degrading to markdown. Supplied by the
+     * runtime from each pack's `slackAssetTypes`.
+     */
+    isSlackAssetType?: ((type: string) => boolean) | undefined;
+}
+/**
+ * Flattens `definitions` into one type-keyed inventory.
+ *
+ * Throws on a duplicate `type`: two packs claiming one node type has no correct
+ * resolution, so it fails at construction rather than resolving arbitrarily per
+ * render.
+ */
+export declare const createPrimitiveDispatcher: <TNode extends PrimitiveNode, T extends PackTypes = DefaultPackTypes>(definitions: readonly AnyPrimitiveDefinition[], options?: PrimitiveDispatcherOptions) => PrimitiveDispatcher<TNode, T>;
+//# sourceMappingURL=primitive_dispatch.d.ts.map

package/dist/render/primitive_dispatch.d.ts.map

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

package/dist/render/primitive_dispatch.js

@@ -0,0 +1,169 @@
+/*
+ * 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.
+ */
+import { cloneElement, isValidElement } from 'react';
+import { isVisibleOnSurface, } from '../composition/body_node_base.js';
+import { IsomerError } from '../composition/error.js';
+import { createNodeIssueFormatter } from '../validate/node_issues.js';
+import { serializeMarkdown } from './markdown/builder.js';
+import { markdownContentToSlackBlocks } from './slack/markdown_content.js';
+/**
+ * Which of a definition's renderers each surface dispatches to.
+ *
+ * `snapshot` maps to `react`: a rasterizer lays out the pack's DOM tree and
+ * stylesheet, so the two surfaces differ only in visibility and in what
+ * surrounds them.
+ */
+const RENDERER_FOR_SURFACE = {
+    react: 'react',
+    snapshot: 'react',
+    text: 'text',
+    markdown: 'markdown',
+    slack: 'slack',
+};
+/**
+ * Flattens `definitions` into one type-keyed inventory.
+ *
+ * Throws on a duplicate `type`: two packs claiming one node type has no correct
+ * resolution, so it fails at construction rather than resolving arbitrarily per
+ * render.
+ */
+export const createPrimitiveDispatcher = (definitions, options = {}) => {
+    const { isSlackAssetType } = options;
+    const formatIssues = createNodeIssueFormatter(definitions);
+    const byType = new Map();
+    for (const definition of definitions) {
+        const existing = byType.get(definition.type);
+        if (existing) {
+            const label = options.label ? `${options.label}: ` : '';
+            throw new IsomerError('DUPLICATE_PRIMITIVE_TYPE', `${label}duplicate primitive type "${definition.type}" registered`);
+        }
+        byType.set(definition.type, definition);
+    }
+    const getDefinition = (node) => {
+        const definition = byType.get(node.type);
+        if (!definition) {
+            throw new IsomerError('UNKNOWN_PRIMITIVE_TYPE', `Unknown primitive type "${node.type}"`);
+        }
+        return definition;
+    };
+    const sanitizeNode = (definition, node) => {
+        const sanitize = definition.sanitize;
+        return sanitize ? sanitize(node) : node;
+    };
+    // Assigned after helpers that close over this binding.
+    // eslint-disable-next-line prefer-const
+    let self;
+    const scope = () => self;
+    const renderOn = (surface, node, extras) => {
+        if (!isVisibleOnSurface(node, surface)) {
+            return undefined;
+        }
+        const definition = getDefinition(node);
+        const safeNode = sanitizeNode(definition, node);
+        return safeNode === null
+            ? undefined
+            : renderSanitized(surface, definition, safeNode, extras);
+    };
+    // `renderOn` for a node its sanitizer has already run on.
+    const renderSanitized = (surface, definition, safeNode, extras) => {
+        const renderer = definition.renderers[RENDERER_FOR_SURFACE[surface]];
+        return renderer?.(safeNode, { ...extras, scope: scope() });
+    };
+    const renderMarkdownContent = (node) => renderOn('markdown', node, {}) ?? [];
+    const renderMarkdown = (node) => serializeMarkdown(renderMarkdownContent(node));
+    self = {
+        definitions,
+        getDefinition,
+        renderOn,
+        // `{}` only ever runs when the argument was optional, which
+        // `ReactContextArg` allows exactly when `{}` is a complete context.
+        renderReact: (node, ...context) => renderOn('react', node, {
+            context: context[0] ?? {},
+        }),
+        collectStyles: (node, styles, context) => {
+            const definition = getDefinition(node);
+            const collectStyles = definition.collectStyles;
+            collectStyles?.(node, { styles, context });
+        },
+        renderSnapshot: (node, context, theme, key) => {
+            const rendered = renderOn('snapshot', node, { context, theme });
+            // The frame hands these to React as an array; a `key` has to sit on the
+            // element itself, since wrapping in a Fragment would hide the single
+            // root an image backend lays out from.
+            return isValidElement(rendered)
+                ? cloneElement(rendered, { key })
+                : rendered;
+        },
+        renderText: (node) => renderOn('text', node, {}) ?? '',
+        renderMarkdown,
+        renderMarkdownContent,
+        renderSlack: (node, collector) => {
+            if (!isVisibleOnSurface(node, 'slack')) {
+                return [];
+            }
+            const assets = isSlackAssetCollector(collector) ? collector : undefined;
+            if (assets && isSlackAssetType?.(node.type)) {
+                const definition = getDefinition(node);
+                const safeNode = sanitizeNode(definition, node);
+                if (safeNode === null) {
+                    return [];
+                }
+                const altText = (isVisibleOnSurface(safeNode, 'text') &&
+                    renderSanitized('text', definition, safeNode, {})) ||
+                    node.type;
+                const ref = assets.allocate(safeNode, altText);
+                const block = {
+                    type: 'image',
+                    alt_text: altText,
+                    slack_file: { ref },
+                };
+                return asSlackPayload([block]);
+            }
+            const definition = getDefinition(node);
+            const slackRenderer = definition.renderers.slack;
+            if (!slackRenderer) {
+                // Degrading here rather than in the envelope is what reaches nested
+                // children: a container's `slack` renderer recurses through this
+                // method, and the envelope only ever sees the container's own output.
+                return asSlackPayload(markdownContentToSlackBlocks(renderMarkdownContent(node)));
+            }
+            const safeNode = sanitizeNode(definition, node);
+            if (safeNode === null) {
+                return [];
+            }
+            const rendered = slackRenderer(safeNode, {
+                ...(collector === undefined ? {} : { collector }),
+                scope: scope(),
+            });
+            return isReadonlyArray(rendered) ? rendered : [rendered];
+        },
+        estimateSnapshotHeight: (node) => {
+            if (!isVisibleOnSurface(node, 'snapshot')) {
+                return 0;
+            }
+            const snapshotHeight = getDefinition(node).metrics?.snapshotHeight;
+            return snapshotHeight?.(node) ?? 0;
+        },
+        validate: (node, path, errors) => {
+            const result = getDefinition(node).schema.safeParse(node, {
+                reportInput: true,
+            });
+            if (!result.success) {
+                errors.push(...formatIssues([[node, path]], result.error.issues, path));
+            }
+        },
+    };
+    return self;
+};
+const isReadonlyArray = (value) => Array.isArray(value);
+/** The picture swap needs a collector that can allocate; any other collector type skips it. */
+const isSlackAssetCollector = (value) => typeof value === 'object' &&
+    value !== null &&
+    typeof value.allocate === 'function';
+/** Rebinds checked Block Kit to the erased payload parameter. */
+const asSlackPayload = (blocks) => blocks;
+//# sourceMappingURL=primitive_dispatch.js.map