@elastic/isomer-sdk 0.0.0 → 0.2.0

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`, 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/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,173 @@
+"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 markdown_content_1 = require("./slack/markdown_content");
+/**
+ * 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.
+ */
+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 renderMarkdownContent = (node) => renderOn('markdown', node, {}) ?? [];
+    const renderMarkdown = (node) => (0, builder_1.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 (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.
+                return asSlackPayload((0, markdown_content_1.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 (!(0, body_node_base_1.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;
+};
+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 { serializeMarkdown } from './markdown/builder';\nimport type { SlackAssetCollector } from './slack/assets';\nimport type { SlackBlock, SlackImageBlock } from './slack/blocks';\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 `snapshot` 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  renderSnapshot(\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  /** The node's content serialized as GFM. */\n  renderMarkdown(node: TNode): string;\n  /** Empty when the node is hidden from `markdown`. */\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 `snapshot` or its primitive declares no `metrics.snapshotHeight`. */\n  estimateSnapshotHeight(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 * `snapshot` maps to `react`: a rasterizer 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  snapshot: '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 renderMarkdownContent = (node: TNode): MarkdownContent =>\n    renderOn('markdown', node, {}) ?? [];\n\n  const renderMarkdown = (node: TNode): string =>\n    serializeMarkdown(renderMarkdownContent(node));\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    renderSnapshot: (node, context, theme, key) => {\n      const rendered = renderOn('snapshot', 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        return asSlackPayload<T['slackBlock']>(\n          markdownContentToSlackBlocks(renderMarkdownContent(node))\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    estimateSnapshotHeight: (node) => {\n      if (!isVisibleOnSurface(node, 'snapshot')) {\n        return 0;\n      }\n      const snapshotHeight = getDefinition(node).metrics?.snapshotHeight as\n        ((node: TNode) => number) | undefined;\n      return snapshotHeight?.(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"]}

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

@@ -0,0 +1,32 @@
+"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.applyEnhancements = void 0;
+const enhancements_1 = require("../../pack/enhancements");
+const anchors_1 = require("../anchors");
+const context_view_1 = require("../context_view");
+/**
+ * The `definitions` that apply to `body`, the first of each id and limited to
+ * `requested` ids when given, and `context` for a React render of it: carrying
+ * their ids as `context.enhancements`, with `context.anchors` on when one
+ * declares `anchors: true`. `context` is viewed, not copied, as the HTML
+ * surface does.
+ */
+const applyEnhancements = (context, body, walk, definitions, requested) => {
+    const applied = (0, enhancements_1.resolveEnhancements)(body, walk, definitions, requested);
+    const ids = new Set(applied.map(({ id }) => id));
+    const enhanced = (0, context_view_1.contextWith)(context, 'enhancements', ids);
+    return {
+        context: applied.some(({ anchors }) => anchors)
+            ? (0, anchors_1.withNodeAnchors)(enhanced)
+            : enhanced,
+        applied,
+    };
+};
+exports.applyEnhancements = applyEnhancements;
+//# sourceMappingURL=enhancements.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enhancements.js","sourceRoot":"","sources":["../../../../src/render/react/enhancements.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,0DAGiC;AACjC,wCAA6C;AAC7C,kDAA8C;AAE9C;;;;;;GAMG;AACI,MAAM,iBAAiB,GAAG,CAC/B,OAAiB,EACjB,IAA8B,EAC9B,IAAqB,EACrB,WAA6C,EAC7C,SAA6B,EAC4B,EAAE;IAC3D,MAAM,OAAO,GAAG,IAAA,kCAAmB,EAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAA,0BAAW,EAAC,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC;YAC7C,CAAC,CAAC,IAAA,yBAAe,EAAC,QAAQ,CAAC;YAC3B,CAAC,CAAC,QAAQ;QACZ,OAAO;KACR,CAAC;AACJ,CAAC,CAAC;AAhBW,QAAA,iBAAiB,qBAgB5B","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 { ChildNodeWalker } from '../../composition/body_node_base';\nimport type { PrimitiveNode } from '../../composition/node';\nimport {\n  type EnhancementDefinition,\n  resolveEnhancements,\n} from '../../pack/enhancements';\nimport { withNodeAnchors } from '../anchors';\nimport { contextWith } from '../context_view';\n\n/**\n * The `definitions` that apply to `body`, the first of each id and limited to\n * `requested` ids when given, and `context` for a React render of it: carrying\n * their ids as `context.enhancements`, with `context.anchors` on when one\n * declares `anchors: true`. `context` is viewed, not copied, as the HTML\n * surface does.\n */\nexport const applyEnhancements = <TContext>(\n  context: TContext,\n  body: readonly PrimitiveNode[],\n  walk: ChildNodeWalker,\n  definitions: readonly EnhancementDefinition[],\n  requested?: readonly string[]\n): { context: TContext; applied: EnhancementDefinition[] } => {\n  const applied = resolveEnhancements(body, walk, definitions, requested);\n  const ids = new Set(applied.map(({ id }) => id));\n  const enhanced = contextWith(context, 'enhancements', ids);\n  return {\n    context: applied.some(({ anchors }) => anchors)\n      ? withNodeAnchors(enhanced)\n      : enhanced,\n    applied,\n  };\n};\n"]}

package/dist/cjs/render/react/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.applyEnhancements = exports.wrapCompositionContent = exports.renderCompositionContent = void 0;
+var content_1 = require("./content");
+Object.defineProperty(exports, "renderCompositionContent", { enumerable: true, get: function () { return content_1.renderCompositionContent; } });
+Object.defineProperty(exports, "wrapCompositionContent", { enumerable: true, get: function () { return content_1.wrapCompositionContent; } });
+var enhancements_1 = require("./enhancements");
+Object.defineProperty(exports, "applyEnhancements", { enumerable: true, get: function () { return enhancements_1.applyEnhancements; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/render/react/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qCAMmB;AAFjB,mHAAA,wBAAwB,OAAA;AACxB,iHAAA,sBAAsB,OAAA;AAExB,+CAAmD;AAA1C,iHAAA,iBAAiB,OAAA","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport {\n  type CompositionWrapperOptions,\n  type ReactContentDispatcher,\n  type ReactContentOptions,\n  renderCompositionContent,\n  wrapCompositionContent,\n} from './content';\nexport { applyEnhancements } from './enhancements';\n"]}

package/dist/cjs/render/slack/assets.js

@@ -0,0 +1,45 @@
+"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.createSlackAssetCollector = exports.isSlackReachableImageUrl = void 0;
+const blocks_1 = require("./blocks");
+const format_1 = require("./format");
+/**
+ * Whether Slack's servers can fetch `src` themselves: an `https:` URL with a
+ * host, so a data URL or a host-relative path has to go through an upload.
+ */
+const isSlackReachableImageUrl = (src) => /^https:/i.test(src) && (0, format_1.isAbsoluteHttpUrl)(src);
+exports.isSlackReachableImageUrl = isSlackReachableImageUrl;
+/**
+ * A fresh {@link SlackAssetCollector} handing out `{prefix}-0`, `{prefix}-1`,
+ * … in allocation order. `prefix` defaults to `asset`.
+ */
+const createSlackAssetCollector = (options = {}) => {
+    const prefix = options.prefix ?? 'asset';
+    const requests = [];
+    let counter = 0;
+    return {
+        allocate: (node, altText) => {
+            const ref = `${prefix}-${counter}`;
+            counter += 1;
+            // Clamped at allocation so a host reading `requests` for an upload title
+            // sees the same string as the block it accompanies.
+            requests.push({
+                ref,
+                node,
+                altText: (0, format_1.clampSlackText)(altText, blocks_1.SLACK_LIMITS.imageAltTextChars),
+            });
+            return ref;
+        },
+        get requests() {
+            return requests;
+        },
+    };
+};
+exports.createSlackAssetCollector = createSlackAssetCollector;
+//# sourceMappingURL=assets.js.map

package/dist/cjs/render/slack/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../../src/render/slack/assets.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAQH,qCAAwC;AACxC,qCAA6D;AAI7D;;;GAGG;AACI,MAAM,wBAAwB,GAAG,CAAC,GAAW,EAAW,EAAE,CAC/D,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAA,0BAAiB,EAAC,GAAG,CAAC,CAAC;AADpC,QAAA,wBAAwB,4BACY;AAEjD;;;GAGG;AACI,MAAM,yBAAyB,GAAG,CAGvC,UAA+B,EAAE,EACL,EAAE;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;IACzC,MAAM,QAAQ,GAA+B,EAAE,CAAC;IAChD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YAC1B,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,CAAC;YACb,yEAAyE;YACzE,oDAAoD;YACpD,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG;gBACH,IAAI;gBACJ,OAAO,EAAE,IAAA,uBAAc,EAAC,OAAO,EAAE,qBAAY,CAAC,iBAAiB,CAAC;aACjE,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAzBW,QAAA,yBAAyB,6BAyBpC","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 { PrimitiveNode } from '../../composition/node';\nimport type {\n  SlackAssetCollector,\n  SlackAssetRequest,\n} from '../../define/slack_assets';\n\nimport { SLACK_LIMITS } from './blocks';\nimport { clampSlackText, isAbsoluteHttpUrl } from './format';\n\nexport type { SlackAssetCollector, SlackAssetRequest };\n\n/**\n * Whether Slack's servers can fetch `src` themselves: an `https:` URL with a\n * host, so a data URL or a host-relative path has to go through an upload.\n */\nexport const isSlackReachableImageUrl = (src: string): boolean =>\n  /^https:/i.test(src) && isAbsoluteHttpUrl(src);\n\n/**\n * A fresh {@link SlackAssetCollector} handing out `{prefix}-0`, `{prefix}-1`,\n * … in allocation order. `prefix` defaults to `asset`.\n */\nexport const createSlackAssetCollector = <\n  TNode extends PrimitiveNode = PrimitiveNode,\n>(\n  options: { prefix?: string } = {}\n): SlackAssetCollector<TNode> => {\n  const prefix = options.prefix ?? 'asset';\n  const requests: SlackAssetRequest<TNode>[] = [];\n  let counter = 0;\n  return {\n    allocate: (node, altText) => {\n      const ref = `${prefix}-${counter}`;\n      counter += 1;\n      // Clamped at allocation so a host reading `requests` for an upload title\n      // sees the same string as the block it accompanies.\n      requests.push({\n        ref,\n        node,\n        altText: clampSlackText(altText, SLACK_LIMITS.imageAltTextChars),\n      });\n      return ref;\n    },\n    get requests() {\n      return requests;\n    },\n  };\n};\n"]}

package/dist/cjs/render/slack/blocks.js

@@ -0,0 +1,80 @@
+"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.SLACK_LIMITS = void 0;
+/**
+ * Slack's published surface limits, enforced by the renderer so a composition
+ * cannot silently trip Slack's validation.
+ */
+exports.SLACK_LIMITS = {
+    blocksPerMessage: 50,
+    /** `section.text`. */
+    sectionTextChars: 3000,
+    /** One entry of `section.fields`. */
+    sectionFieldChars: 2000,
+    /** One entry of `context.elements`. */
+    contextElementChars: 2000,
+    /** `header.text`, which is `plain_text`. */
+    headerTextChars: 150,
+    fieldsPerSection: 10,
+    /** Elements per `context` block. */
+    contextElements: 10,
+    buttonsPerActions: 25,
+    /** Slack truncates the top-level `text` fallback in notifications around here. */
+    fallbackTextChars: 4000,
+    /** `plain_text` option labels (selects, radio, checkboxes, overflow). */
+    optionTextChars: 75,
+    /** Options per select, or per option group of one. */
+    optionsPerSelect: 100,
+    /** Options per overflow menu (Slack caps overflow at 5). */
+    optionsPerOverflow: 5,
+    /** Options per radio button group or checkboxes element. */
+    optionsPerChoice: 10,
+    /** Option groups per select, each holding up to `optionsPerSelect` options. */
+    optionGroupsPerSelect: 100,
+    /** An option's `value`, which interactions send back. */
+    optionValueChars: 150,
+    /** A button's `value`. */
+    buttonValueChars: 2000,
+    /** A button's or overflow option's `url`. */
+    urlChars: 3000,
+    /** An interactive element's `action_id`. */
+    actionIdChars: 255,
+    /** Max indent level for `rich_text_list`. */
+    richTextListMaxIndent: 8,
+    /**
+     * Characters across every table cell in one message. Slack publishes the
+     * same 10,000 figure per table and per message, so the message-wide
+     * aggregate is the binding one.
+     * https://docs.slack.dev/reference/block-kit/blocks/table-block/
+     */
+    tableCellCharsPerMessage: 10_000,
+    /** Rows per `table` block (includes the header row). */
+    tableRows: 100,
+    /** Cells per `table` row / columns per table. */
+    tableColumns: 20,
+    /** `image`/image-element `image_url` max length. */
+    imageUrlChars: 3000,
+    /** `image`/image-element `alt_text` max length. */
+    imageAltTextChars: 2000,
+    /** `image` block `title`. */
+    imageTitleChars: 2000,
+    /** `video` block `title`; Slack requires fewer than 200. */
+    videoTitleChars: 199,
+    /** `video` block `description`; Slack requires fewer than 200. */
+    videoDescriptionChars: 199,
+    /** `video` block `author_name`; Slack requires fewer than 50. */
+    videoAuthorNameChars: 49,
+    /** `button` element `text`. */
+    buttonTextChars: 75,
+    /** Select `placeholder`. */
+    placeholderChars: 150,
+    /** `option_groups[].label`. */
+    optionGroupLabelChars: 75,
+};
+//# sourceMappingURL=blocks.js.map