@elastic/isomer-sdk 0.0.0 → 0.1.0

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

@@ -0,0 +1,190 @@
+"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.sanitizeMarkdownSource = void 0;
+const mdast_util_from_markdown_1 = require("mdast-util-from-markdown");
+const mdast_util_gfm_1 = require("mdast-util-gfm");
+const micromark_extension_gfm_1 = require("micromark-extension-gfm");
+const url_1 = require("../../validate/url");
+// 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;
+// 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) => {
+    parseOptions ??= {
+        extensions: [(0, micromark_extension_gfm_1.gfm)()],
+        mdastExtensions: [(0, mdast_util_gfm_1.gfmFromMarkdown)()],
+    };
+    const root = (0, mdast_util_from_markdown_1.fromMarkdown)(source, parseOptions);
+    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 = (0, url_1.sanitizeParsedNavigationHref)(node.url) ??
+                    (0, url_1.sanitizeParsedAssetUrl)(node.url);
+                if (safe === node.url)
+                    return undefined;
+                const title = node.title ? ` ${escapeTitle(node.title)}` : '';
+                return `[${node.label ?? node.identifier}]: ${safe === null ? url_1.BLOCKED_HREF : escapeParsedDestination(safe)}${title}`;
+            }
+            case 'imageReference': {
+                const definition = definitions.get(node.identifier);
+                return definition && (0, url_1.sanitizeParsedAssetUrl)(definition.url) === null
+                    ? escapeLinkLabel(node.alt ?? '')
+                    : undefined;
+            }
+            case 'linkReference': {
+                const definition = definitions.get(node.identifier);
+                return definition &&
+                    (0, url_1.sanitizeParsedNavigationHref)(definition.url) === null &&
+                    (0, url_1.sanitizeParsedAssetUrl)(definition.url) !== null
+                    ? emitLabel(node)
+                    : undefined;
+            }
+            case 'image': {
+                const safe = (0, url_1.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 = (0, url_1.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);
+};
+/** Sanitizes GFM destinations and HTML; excessive syntax or length degrades to inert text. */
+const sanitizeMarkdownSource = (markdown) => {
+    if (exceedsParseBudget(markdown))
+        return inert(markdown);
+    let current = markdown;
+    try {
+        for (let pass = 0; pass < MAX_PASSES; pass++) {
+            const next = sanitizePass(current);
+            if (next === current)
+                return current;
+            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 inert(current);
+};
+exports.sanitizeMarkdownSource = sanitizeMarkdownSource;
+// 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/cjs/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`.\n\nimport type { Definition, Nodes, Parents } 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\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  parseOptions ??= {\n    extensions: [gfm()],\n    mdastExtensions: [gfmFromMarkdown()],\n  };\n  const root = fromMarkdown(source, parseOptions);\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/** Sanitizes GFM destinations and HTML; excessive syntax or length degrades to inert text. */\nexport const sanitizeMarkdownSource = (markdown: string): string => {\n  if (exceedsParseBudget(markdown)) return inert(markdown);\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 current;\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 inert(current);\n};\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/cjs/render/markdown/index.js

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

package/dist/cjs/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,qCAAkD;AAAzC,6FAAA,EAAE,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAE9B,uCAIoB;AADlB,kHAAA,sBAAsB,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 { md, serializeMarkdown } from './builder';\n\nexport {\n  type MarkdownEnvelopeDispatcher,\n  type MarkdownEnvelopeOptions,\n  renderMarkdownEnvelope,\n} from './envelope';\n"]}

package/dist/cjs/render/measure_dom.js

@@ -0,0 +1,61 @@
+"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.measureDom = void 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.
+ */
+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);
+};
+exports.measureDom = measureDom;
+//# sourceMappingURL=measure_dom.js.map

package/dist/cjs/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/cjs/render/payload.js

@@ -0,0 +1,13 @@
+"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.byteLength = void 0;
+/** UTF-8 byte length of `value`, which is not `length` for non-ASCII text. */
+const byteLength = (value) => new TextEncoder().encode(value).length;
+exports.byteLength = byteLength;
+//# sourceMappingURL=payload.js.map

package/dist/cjs/render/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../src/render/payload.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAgBH,8EAA8E;AACvE,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAClD,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;AAD5B,QAAA,UAAU,cACkB","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/cjs/render/primitive_dispatch.js

@@ -0,0 +1,187 @@
+"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.createPrimitiveDispatcher = void 0;
+const react_1 = require("react");
+const body_node_base_1 = require("../composition/body_node_base");
+const error_1 = require("../composition/error");
+const node_issues_1 = require("../validate/node_issues");
+const builder_1 = require("./markdown/builder");
+const format_1 = require("./slack/format");
+const markdown_content_1 = require("./slack/markdown_content");
+/**
+ * Which of a definition's renderers each surface dispatches to.
+ *
+ * `svg` maps to `react`: an image backend 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',
+    svg: '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.
+ */
+const createPrimitiveDispatcher = (definitions, options = {}) => {
+    const { isSlackAssetType } = options;
+    const formatIssues = (0, node_issues_1.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 error_1.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 error_1.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 (!(0, body_node_base_1.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 renderMarkdown = (node) => {
+        const rendered = renderOn('markdown', node, {}) ?? '';
+        return typeof rendered === 'string'
+            ? rendered
+            : (0, builder_1.serializeMarkdown)(rendered);
+    };
+    const renderMarkdownContent = (node) => {
+        const rendered = renderOn('markdown', node, {}) ?? '';
+        return typeof rendered === 'string'
+            ? (0, builder_1.markdownFromString)(rendered)
+            : rendered;
+    };
+    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 });
+        },
+        renderSvg: (node, context, theme, key) => {
+            const rendered = renderOn('svg', 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 (0, react_1.isValidElement)(rendered)
+                ? (0, react_1.cloneElement)(rendered, { key })
+                : rendered;
+        },
+        renderText: (node) => renderOn('text', node, {}) ?? '',
+        renderMarkdown,
+        renderMarkdownContent,
+        renderSlack: (node, collector) => {
+            if (!(0, body_node_base_1.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 = ((0, body_node_base_1.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.
+                const markdown = renderOn('markdown', node, {}) ?? '';
+                return asSlackPayload(typeof markdown === 'string'
+                    ? (0, format_1.gfmToSlackBlocks)(markdown)
+                    : (0, markdown_content_1.markdownContentToSlackBlocks)(markdown));
+            }
+            const safeNode = sanitizeNode(definition, node);
+            if (safeNode === null) {
+                return [];
+            }
+            const rendered = slackRenderer(safeNode, {
+                ...(collector === undefined ? {} : { collector }),
+                scope: scope(),
+            });
+            return isReadonlyArray(rendered) ? rendered : [rendered];
+        },
+        estimateSvgHeight: (node) => {
+            if (!(0, body_node_base_1.isVisibleOnSurface)(node, 'svg')) {
+                return 0;
+            }
+            const svgHeight = getDefinition(node).metrics?.svgHeight;
+            return svgHeight?.(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;
+};
+exports.createPrimitiveDispatcher = createPrimitiveDispatcher;
+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

package/dist/cjs/render/primitive_dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive_dispatch.js","sourceRoot":"","sources":["../../../src/render/primitive_dispatch.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 { cloneElement, isValidElement, type ReactNode } from 'react';\n\nimport {\n  isVisibleOnSurface,\n  type SurfaceName,\n} from '../composition/body_node_base';\nimport { IsomerError } from '../composition/error';\nimport type { ValidationError } from '../composition/validation_error';\nimport type { MarkdownContent } from '../define/markdown_content';\nimport {\n  type AnyPrimitiveDefinition,\n  type DefaultPackTypes,\n  type PackTypes,\n  type PrimitiveNode,\n  type PrimitiveStyleCollectionContext,\n  type ReactContextArg,\n  type Renderer,\n  type RenderScope,\n  type SurfaceMap,\n} from '../define/primitive_module';\nimport { createNodeIssueFormatter } from '../validate/node_issues';\n\nimport { markdownFromString, serializeMarkdown } from './markdown/builder';\nimport type { SlackAssetCollector } from './slack/assets';\nimport type { SlackBlock, SlackImageBlock } from './slack/blocks';\nimport { gfmToSlackBlocks } from './slack/format';\nimport { markdownContentToSlackBlocks } from './slack/markdown_content';\n\n/**\n * Renders a node on any surface by looking its `type` up in one flattened\n * inventory.\n *\n * The seam that makes packs composable: a container recurses through the\n * {@link RenderScope} it is passed rather than through its own pack, so a node\n * owned by another pack still renders.\n */\nexport interface PrimitiveDispatcher<\n  TNode extends PrimitiveNode,\n  T extends PackTypes = DefaultPackTypes,\n> {\n  /** Every primitive this dispatcher can reach, across all composed packs. */\n  readonly definitions: readonly AnyPrimitiveDefinition[];\n  /** Throws for an unknown node type; a missing primitive is a bug, not a degradation. */\n  getDefinition(node: TNode): AnyPrimitiveDefinition;\n  /** `undefined` when the node is hidden from `surface`, `sanitize` drops it, or the primitive declares no renderer for `surface`. */\n  renderOn<S extends SurfaceName>(\n    surface: S,\n    node: TNode,\n    extras: Omit<SurfaceMap<T>[S]['env'], 'scope'>\n  ): SurfaceMap<T>[S]['output'] | undefined;\n  /** 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. */\n  renderReact(\n    node: TNode,\n    ...context: ReactContextArg<T['context']>\n  ): ReactNode;\n  /** Mutates `styles` with this node's contribution. */\n  collectStyles(\n    node: TNode,\n    styles: T['collector'],\n    context: PrimitiveStyleCollectionContext\n  ): void;\n  /**\n   * The node's `react` renderer, gated on `svg` visibility and keyed for a\n   * frame's sibling list. `key` must be unique among those siblings.\n   * `theme` is the frame's resolved palette for this render, or `undefined`\n   * outside a frame.\n   */\n  renderSvg(\n    node: TNode,\n    context: T['context'],\n    theme: T['theme'] | undefined,\n    key: string\n  ): ReactNode;\n  /** `''` when the node is hidden from `text` or its primitive declares no `text` renderer. */\n  renderText(node: TNode): string;\n  /** Builder content is serialized per node. */\n  renderMarkdown(node: TNode): string;\n  /** A string result comes back as content printed as written. */\n  renderMarkdownContent(node: TNode): MarkdownContent;\n  /**\n   * Empty when the node is hidden from `slack`, `sanitize` drops it, or its\n   * renderer returns nothing. A node with no `slack` renderer degrades through\n   * its markdown; one `isSlackAssetType` names becomes an `image` block when\n   * `collector` can allocate.\n   */\n  renderSlack(\n    node: TNode,\n    collector?: T['slackCollector']\n  ): readonly T['slackBlock'][];\n  /** `0` when the node is hidden from `svg` or its primitive declares no `metrics.svgHeight`. */\n  estimateSvgHeight(node: TNode): number;\n  /**\n   * Appends schema failures under `path` to `errors`, each naming `node`'s\n   * type, and an unknown key on `node` listing the fields it declares.\n   */\n  validate(node: TNode, path: string, errors: ValidationError[]): void;\n}\n\n/**\n * Which of a definition's renderers each surface dispatches to.\n *\n * `svg` maps to `react`: an image backend lays out the pack's DOM tree and\n * stylesheet, so the two surfaces differ only in visibility and in what\n * surrounds them.\n */\nconst RENDERER_FOR_SURFACE = {\n  react: 'react',\n  svg: 'react',\n  text: 'text',\n  markdown: 'markdown',\n  slack: 'slack',\n} as const satisfies Record<\n  SurfaceName,\n  keyof AnyPrimitiveDefinition['renderers']\n>;\n\n/** Runtime facts {@link createPrimitiveDispatcher} cannot derive from the inventory. */\nexport interface PrimitiveDispatcherOptions {\n  /** Names this dispatcher in error messages. */\n  label?: string;\n  /**\n   * Which node types render as a picture rather than as text, so the Slack\n   * surface uploads an image instead of degrading to markdown. Supplied by the\n   * runtime from each pack's `slackAssetTypes`.\n   */\n  isSlackAssetType?: ((type: string) => boolean) | undefined;\n}\n\n/**\n * Flattens `definitions` into one type-keyed inventory.\n *\n * Throws on a duplicate `type`: two packs claiming one node type has no correct\n * resolution, so it fails at construction rather than resolving arbitrarily per\n * render.\n */\nexport const createPrimitiveDispatcher = <\n  TNode extends PrimitiveNode,\n  T extends PackTypes = DefaultPackTypes,\n>(\n  definitions: readonly AnyPrimitiveDefinition[],\n  options: PrimitiveDispatcherOptions = {}\n): PrimitiveDispatcher<TNode, T> => {\n  const { isSlackAssetType } = options;\n  const formatIssues = createNodeIssueFormatter(definitions);\n  const byType = new Map<string, AnyPrimitiveDefinition>();\n  for (const definition of definitions) {\n    const existing = byType.get(definition.type);\n    if (existing) {\n      const label = options.label ? `${options.label}: ` : '';\n      throw new IsomerError(\n        'DUPLICATE_PRIMITIVE_TYPE',\n        `${label}duplicate primitive type \"${definition.type}\" registered`\n      );\n    }\n    byType.set(definition.type, definition);\n  }\n\n  const getDefinition = (node: TNode): AnyPrimitiveDefinition => {\n    const definition = byType.get(node.type);\n    if (!definition) {\n      throw new IsomerError(\n        'UNKNOWN_PRIMITIVE_TYPE',\n        `Unknown primitive type \"${node.type}\"`\n      );\n    }\n    return definition;\n  };\n\n  const sanitizeNode = (\n    definition: AnyPrimitiveDefinition,\n    node: TNode\n  ): TNode | null => {\n    const sanitize = definition.sanitize as\n      ((node: TNode) => TNode | null) | undefined;\n    return sanitize ? sanitize(node) : node;\n  };\n\n  // Assigned after helpers that close over this binding.\n  // eslint-disable-next-line prefer-const\n  let self: PrimitiveDispatcher<TNode, T>;\n\n  const scope = (): RenderScope<T> => self;\n\n  const renderOn = <S extends SurfaceName>(\n    surface: S,\n    node: TNode,\n    extras: Omit<SurfaceMap<T>[S]['env'], 'scope'>\n  ): SurfaceMap<T>[S]['output'] | undefined => {\n    if (!isVisibleOnSurface(node, surface)) {\n      return undefined;\n    }\n    const definition = getDefinition(node);\n    const safeNode = sanitizeNode(definition, node);\n    return safeNode === null\n      ? undefined\n      : renderSanitized(surface, definition, safeNode, extras);\n  };\n\n  // `renderOn` for a node its sanitizer has already run on.\n  const renderSanitized = <S extends SurfaceName>(\n    surface: S,\n    definition: AnyPrimitiveDefinition,\n    safeNode: TNode,\n    extras: Omit<SurfaceMap<T>[S]['env'], 'scope'>\n  ): SurfaceMap<T>[S]['output'] | undefined => {\n    const renderer = definition.renderers[RENDERER_FOR_SURFACE[surface]] as\n      Renderer<TNode, S, T> | undefined;\n    return renderer?.(safeNode, { ...extras, scope: scope() });\n  };\n\n  const renderMarkdown = (node: TNode): string => {\n    const rendered = renderOn('markdown', node, {}) ?? '';\n    return typeof rendered === 'string'\n      ? rendered\n      : serializeMarkdown(rendered);\n  };\n\n  const renderMarkdownContent = (node: TNode): MarkdownContent => {\n    const rendered = renderOn('markdown', node, {}) ?? '';\n    return typeof rendered === 'string'\n      ? markdownFromString(rendered)\n      : rendered;\n  };\n\n  self = {\n    definitions,\n    getDefinition,\n    renderOn,\n    // `{}` only ever runs when the argument was optional, which\n    // `ReactContextArg` allows exactly when `{}` is a complete context.\n    renderReact: (node, ...context) =>\n      renderOn('react', node, {\n        context: context[0] ?? {},\n      }),\n    collectStyles: (node, styles, context) => {\n      const definition = getDefinition(node);\n      const collectStyles = definition.collectStyles as\n        | ((\n            node: TNode,\n            env: {\n              styles: T['collector'];\n              context: PrimitiveStyleCollectionContext;\n            }\n          ) => void)\n        | undefined;\n      collectStyles?.(node, { styles, context });\n    },\n    renderSvg: (node, context, theme, key) => {\n      const rendered = renderOn('svg', node, { context, theme });\n      // The frame hands these to React as an array; a `key` has to sit on the\n      // element itself, since wrapping in a Fragment would hide the single\n      // root an image backend lays out from.\n      return isValidElement(rendered)\n        ? cloneElement(rendered, { key })\n        : rendered;\n    },\n    renderText: (node) => renderOn('text', node, {}) ?? '',\n    renderMarkdown,\n    renderMarkdownContent,\n    renderSlack: (node, collector) => {\n      if (!isVisibleOnSurface(node, 'slack')) {\n        return [];\n      }\n      const assets = isSlackAssetCollector(collector) ? collector : undefined;\n      if (assets && isSlackAssetType?.(node.type)) {\n        const definition = getDefinition(node);\n        const safeNode = sanitizeNode(definition, node);\n        if (safeNode === null) {\n          return [];\n        }\n        const altText =\n          (isVisibleOnSurface(safeNode, 'text') &&\n            renderSanitized('text', definition, safeNode, {})) ||\n          node.type;\n        const ref = assets.allocate(safeNode, altText);\n        const block = {\n          type: 'image',\n          alt_text: altText,\n          slack_file: { ref },\n        } satisfies SlackImageBlock;\n        return asSlackPayload<T['slackBlock']>([block]);\n      }\n      const definition = getDefinition(node);\n      const slackRenderer = definition.renderers.slack as\n        Renderer<TNode, 'slack', T> | undefined;\n      if (!slackRenderer) {\n        // Degrading here rather than in the envelope is what reaches nested\n        // children: a container's `slack` renderer recurses through this\n        // method, and the envelope only ever sees the container's own output.\n        const markdown = renderOn('markdown', node, {}) ?? '';\n        return asSlackPayload<T['slackBlock']>(\n          typeof markdown === 'string'\n            ? gfmToSlackBlocks(markdown)\n            : markdownContentToSlackBlocks(markdown)\n        );\n      }\n      const safeNode = sanitizeNode(definition, node);\n      if (safeNode === null) {\n        return [];\n      }\n      const rendered = slackRenderer(safeNode, {\n        ...(collector === undefined ? {} : { collector }),\n        scope: scope(),\n      });\n      return isReadonlyArray(rendered) ? rendered : [rendered];\n    },\n    estimateSvgHeight: (node) => {\n      if (!isVisibleOnSurface(node, 'svg')) {\n        return 0;\n      }\n      const svgHeight = getDefinition(node).metrics?.svgHeight as\n        ((node: TNode) => number) | undefined;\n      return svgHeight?.(node) ?? 0;\n    },\n    validate: (node, path, errors) => {\n      const result = getDefinition(node).schema.safeParse(node, {\n        reportInput: true,\n      });\n      if (!result.success) {\n        errors.push(...formatIssues([[node, path]], result.error.issues, path));\n      }\n    },\n  };\n  return self;\n};\n\nconst isReadonlyArray = <T>(value: T | readonly T[]): value is readonly T[] =>\n  Array.isArray(value);\n\n/** The picture swap needs a collector that can allocate; any other collector type skips it. */\nconst isSlackAssetCollector = (value: unknown): value is SlackAssetCollector =>\n  typeof value === 'object' &&\n  value !== null &&\n  typeof (value as { allocate?: unknown }).allocate === 'function';\n\n/** Rebinds checked Block Kit to the erased payload parameter. */\nconst asSlackPayload = <TSlackBlock>(\n  blocks: readonly SlackBlock[]\n): readonly TSlackBlock[] => blocks as unknown as readonly TSlackBlock[];\n"]}

package/dist/cjs/render/react/content.js

@@ -0,0 +1,44 @@
+"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.wrapCompositionContent = exports.renderCompositionContent = void 0;
+const react_1 = require("react");
+/**
+ * A composition's heading and body as React nodes, without the surrounding
+ * document or wrapper element.
+ */
+const renderCompositionContent = (composition, dispatcher, context, { heading = true } = {}) => (0, react_1.createElement)(react_1.Fragment, null, ...[
+    heading && composition.title
+        ? (0, react_1.createElement)('h2', { key: 'title' }, composition.title)
+        : null,
+    heading && composition.subtitle
+        ? (0, react_1.createElement)('p', { key: 'subtitle', className: 'sub' }, composition.subtitle)
+        : null,
+    ...composition.body.map((node, index) => (0, react_1.createElement)((RenderedCompositionNode), {
+        key: `body-${index}`,
+        node,
+        context,
+        dispatcher,
+    })),
+].filter(Boolean));
+exports.renderCompositionContent = renderCompositionContent;
+const RenderedCompositionNode = ({ node, context, dispatcher, }) => dispatcher.renderReact(node, context);
+/**
+ * The one `.isomer[.framed][.fluid]` `section` every surface wraps rendered
+ * content in: the `html` surface's document wrapper and a React host's.
+ */
+const wrapCompositionContent = (content, composition, { framed = true, fluid = false, theme = composition.theme ?? 'auto', defaultAriaLabel = 'View', } = {}) => (0, react_1.createElement)('section', {
+    className: ['isomer', framed ? 'framed' : '', fluid ? 'fluid' : '']
+        .filter(Boolean)
+        .join(' '),
+    role: 'group',
+    'aria-label': composition.meta?.ariaLabel ?? composition.title ?? defaultAriaLabel,
+    ...(theme === 'auto' ? {} : { 'data-theme': theme }),
+}, content);
+exports.wrapCompositionContent = wrapCompositionContent;
+//# sourceMappingURL=content.js.map

package/dist/cjs/render/react/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../../src/render/react/content.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iCAKe;AAyBf;;;GAGG;AACI,MAAM,wBAAwB,GAAG,CAItC,WAA+B,EAC/B,UAAmD,EACnD,OAAiB,EACjB,EAAE,OAAO,GAAG,IAAI,KAA0B,EAAE,EACjC,EAAE,CACb,IAAA,qBAAa,EACX,gBAAQ,EACR,IAAI,EACJ,GAAG;IACD,OAAO,IAAI,WAAW,CAAC,KAAK;QAC1B,CAAC,CAAC,IAAA,qBAAa,EAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC;QAC1D,CAAC,CAAC,IAAI;IACR,OAAO,IAAI,WAAW,CAAC,QAAQ;QAC7B,CAAC,CAAC,IAAA,qBAAa,EACX,GAAG,EACH,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,EACrC,WAAW,CAAC,QAAQ,CACrB;QACH,CAAC,CAAC,IAAI;IACR,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACtC,IAAA,qBAAa,EAAC,CAAA,uBAAwC,CAAA,EAAE;QACtD,GAAG,EAAE,QAAQ,KAAK,EAAE;QACpB,IAAI;QACJ,OAAO;QACP,UAAU;KACX,CAAC,CACH;CACF,CAAC,MAAM,CAAC,OAAO,CAAC,CAClB,CAAC;AAhCS,QAAA,wBAAwB,4BAgCjC;AAWJ,MAAM,uBAAuB,GAAG,CAAwC,EACtE,IAAI,EACJ,OAAO,EACP,UAAU,GACoC,EAAa,EAAE,CAC7D,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAcxC;;;GAGG;AACI,MAAM,sBAAsB,GAAG,CACpC,OAAkB,EAClB,WAA+B,EAC/B,EACE,MAAM,GAAG,IAAI,EACb,KAAK,GAAG,KAAK,EACb,KAAK,GAAG,WAAW,CAAC,KAAK,IAAI,MAAM,EACnC,gBAAgB,GAAG,MAAM,MACI,EAAE,EACnB,EAAE,CAChB,IAAA,qBAAa,EACX,SAAS,EACT;IACE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC;IACZ,IAAI,EAAE,OAAO;IACb,YAAY,EACV,WAAW,CAAC,IAAI,EAAE,SAAS,IAAI,WAAW,CAAC,KAAK,IAAI,gBAAgB;IACtE,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;CACrD,EACD,OAAO,CACR,CAAC;AAtBS,QAAA,sBAAsB,0BAsB/B","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 {\n  createElement,\n  Fragment,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\n\nimport type { Composition } from '../../composition';\nimport type { RenderTheme } from '../../composition/named_color';\nimport type { PrimitiveNode, PrimitiveRenderContext } from '../../define';\n\n/** A pack's React renderer for one node of its own type. */\nexport interface ReactContentDispatcher<\n  TNode extends PrimitiveNode,\n  TContext = PrimitiveRenderContext,\n> {\n  /** Must be side-effect free: the HTML surface calls it twice, once to collect styles and once to render. */\n  renderReact(node: TNode, context?: TContext): ReactNode;\n}\n\n/** Options for {@link renderCompositionContent}. */\nexport interface ReactContentOptions {\n  /**\n   * Renders the composition's title and subtitle as the leading `h2` / `p.sub`.\n   * Defaults to `true`. Pass `false` when the host already shows the title\n   * itself; the title still backs the wrapper's `aria-label`.\n   */\n  heading?: boolean;\n}\n\n/**\n * A composition's heading and body as React nodes, without the surrounding\n * document or wrapper element.\n */\nexport const renderCompositionContent = <\n  TNode extends PrimitiveNode,\n  TContext = PrimitiveRenderContext,\n>(\n  composition: Composition<TNode>,\n  dispatcher: ReactContentDispatcher<TNode, TContext>,\n  context: TContext,\n  { heading = true }: ReactContentOptions = {}\n): ReactNode =>\n  createElement(\n    Fragment,\n    null,\n    ...[\n      heading && composition.title\n        ? createElement('h2', { key: 'title' }, composition.title)\n        : null,\n      heading && composition.subtitle\n        ? createElement(\n            'p',\n            { key: 'subtitle', className: 'sub' },\n            composition.subtitle\n          )\n        : null,\n      ...composition.body.map((node, index) =>\n        createElement(RenderedCompositionNode<TNode, TContext>, {\n          key: `body-${index}`,\n          node,\n          context,\n          dispatcher,\n        })\n      ),\n    ].filter(Boolean)\n  );\n\ninterface RenderedCompositionNodeProps<\n  TNode extends PrimitiveNode,\n  TContext = PrimitiveRenderContext,\n> {\n  node: TNode;\n  context: TContext;\n  dispatcher: ReactContentDispatcher<TNode, TContext>;\n}\n\nconst RenderedCompositionNode = <TNode extends PrimitiveNode, TContext>({\n  node,\n  context,\n  dispatcher,\n}: RenderedCompositionNodeProps<TNode, TContext>): ReactNode =>\n  dispatcher.renderReact(node, context);\n\n/** Options for {@link wrapCompositionContent}. */\nexport interface CompositionWrapperOptions {\n  /** Adds the `framed` class. Defaults to `true`. */\n  framed?: boolean;\n  /** Adds the `fluid` class. */\n  fluid?: boolean;\n  /** Sets `data-theme`; defaults to the composition's `theme`, and `auto` sets nothing so the page's scheme applies. */\n  theme?: RenderTheme;\n  /** Used only when the composition has neither `meta.ariaLabel` nor a `title`. Defaults to `'View'`. */\n  defaultAriaLabel?: string;\n}\n\n/**\n * The one `.isomer[.framed][.fluid]` `section` every surface wraps rendered\n * content in: the `html` surface's document wrapper and a React host's.\n */\nexport const wrapCompositionContent = <TNode extends PrimitiveNode>(\n  content: ReactNode,\n  composition: Composition<TNode>,\n  {\n    framed = true,\n    fluid = false,\n    theme = composition.theme ?? 'auto',\n    defaultAriaLabel = 'View',\n  }: CompositionWrapperOptions = {}\n): ReactElement =>\n  createElement(\n    'section',\n    {\n      className: ['isomer', framed ? 'framed' : '', fluid ? 'fluid' : '']\n        .filter(Boolean)\n        .join(' '),\n      role: 'group',\n      'aria-label':\n        composition.meta?.ariaLabel ?? composition.title ?? defaultAriaLabel,\n      ...(theme === 'auto' ? {} : { 'data-theme': theme }),\n    },\n    content\n  );\n"]}