@elastic/isomer-sdk 0.2.0 → 0.3.0

package/dist/render/markdown/host_tags.js

@@ -0,0 +1,63 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+const NAME = String.raw `[A-Za-z_:][\w.:-]*`;
+// A quoted value stays on one line and holds no backtick, so a code span
+// opened before the tag still closes where CommonMark closes it.
+const VALUE = String.raw `[^\s"'=<>\x60]+|'[^'\r\n\x60]*'|"[^"\r\n\x60]*"`;
+const ATTRIBUTE = String.raw `[ \t]+${NAME}(?:[ \t]*=[ \t]*(?:${VALUE}))?`;
+const ATTRIBUTE_RE = new RegExp(String.raw `[ \t]+(${NAME})(?:[ \t]*=[ \t]*(${VALUE}))?`, 'g');
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const tagPattern = (names) => new RegExp(`<(${names.map(escapeRegExp).join('|')})((?:${ATTRIBUTE})*)[ \\t]*/?>`, 'gi');
+const parseAttributes = (body) => {
+    const attributes = Object.create(null);
+    for (const [, name, value = ''] of body.matchAll(ATTRIBUTE_RE)) {
+        const key = name.toLowerCase();
+        if (!(key in attributes)) {
+            attributes[key] =
+                value.startsWith('"') || value.startsWith("'")
+                    ? value.slice(1, -1)
+                    : value;
+        }
+    }
+    return attributes;
+};
+// `\<` is an escaped `<`. Where a backslash is literal (code, HTML), the tag
+// is literal too, so skipping it there changes nothing.
+const isEscaped = (source, index) => {
+    let backslashes = 0;
+    while (source[index - backslashes - 1] === '\\') {
+        backslashes += 1;
+    }
+    return backslashes % 2 === 1;
+};
+/** Every tag named in `names` (matched case-insensitively and whole), in source order. */
+export const findHostTags = (source, names) => {
+    const canonical = new Map();
+    for (const name of names) {
+        const lower = name.toLowerCase();
+        if (lower !== '' && !canonical.has(lower)) {
+            canonical.set(lower, name);
+        }
+    }
+    if (canonical.size === 0) {
+        return [];
+    }
+    const tags = [];
+    for (const match of source.matchAll(tagPattern([...canonical.keys()]))) {
+        if (isEscaped(source, match.index)) {
+            continue;
+        }
+        tags.push({
+            index: match.index,
+            raw: match[0],
+            name: canonical.get(match[1].toLowerCase()),
+            attributes: parseAttributes(match[2]),
+        });
+    }
+    return tags;
+};
+//# sourceMappingURL=host_tags.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host_tags.js","sourceRoot":"","sources":["../../../src/render/markdown/host_tags.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// Finds a host's own tags, such as `<render_attachment id=\"…\" />`, in\n// authored Markdown. The grammar is CommonMark's raw HTML open tag (§6.6) on\n// one line, with `_` allowed in the name. One scan serves both paths of\n// `splitAuthoredMarkdown`: the parsed path swaps each tag for a sentinel\n// before parsing, and the over-budget path cuts the source at each tag.\n\n/** A tag found by {@link findHostTags}. */\nexport interface HostTag {\n  /** Offset of the `<` in the source. */\n  readonly index: number;\n  /** The tag as written. */\n  readonly raw: string;\n  /** The name as listed in the options. */\n  readonly name: string;\n  /** Values as written, keyed by lower-cased name; a bare attribute is `''`. */\n  readonly attributes: Readonly<Record<string, string>>;\n}\n\nconst NAME = String.raw`[A-Za-z_:][\\w.:-]*`;\n// A quoted value stays on one line and holds no backtick, so a code span\n// opened before the tag still closes where CommonMark closes it.\nconst VALUE = String.raw`[^\\s\"'=<>\\x60]+|'[^'\\r\\n\\x60]*'|\"[^\"\\r\\n\\x60]*\"`;\nconst ATTRIBUTE = String.raw`[ \\t]+${NAME}(?:[ \\t]*=[ \\t]*(?:${VALUE}))?`;\nconst ATTRIBUTE_RE = new RegExp(\n  String.raw`[ \\t]+(${NAME})(?:[ \\t]*=[ \\t]*(${VALUE}))?`,\n  'g'\n);\n\nconst escapeRegExp = (value: string): string =>\n  value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\nconst tagPattern = (names: readonly string[]): RegExp =>\n  new RegExp(\n    `<(${names.map(escapeRegExp).join('|')})((?:${ATTRIBUTE})*)[ \\\\t]*/?>`,\n    'gi'\n  );\n\nconst parseAttributes = (body: string): Record<string, string> => {\n  const attributes = Object.create(null) as Record<string, string>;\n  for (const [, name, value = ''] of body.matchAll(ATTRIBUTE_RE)) {\n    const key = name!.toLowerCase();\n    if (!(key in attributes)) {\n      attributes[key] =\n        value.startsWith('\"') || value.startsWith(\"'\")\n          ? value.slice(1, -1)\n          : value;\n    }\n  }\n  return attributes;\n};\n\n// `\\<` is an escaped `<`. Where a backslash is literal (code, HTML), the tag\n// is literal too, so skipping it there changes nothing.\nconst isEscaped = (source: string, index: number): boolean => {\n  let backslashes = 0;\n  while (source[index - backslashes - 1] === '\\\\') {\n    backslashes += 1;\n  }\n  return backslashes % 2 === 1;\n};\n\n/** Every tag named in `names` (matched case-insensitively and whole), in source order. */\nexport const findHostTags = (\n  source: string,\n  names: readonly string[]\n): HostTag[] => {\n  const canonical = new Map<string, string>();\n  for (const name of names) {\n    const lower = name.toLowerCase();\n    if (lower !== '' && !canonical.has(lower)) {\n      canonical.set(lower, name);\n    }\n  }\n  if (canonical.size === 0) {\n    return [];\n  }\n  const tags: HostTag[] = [];\n  for (const match of source.matchAll(tagPattern([...canonical.keys()]))) {\n    if (isEscaped(source, match.index)) {\n      continue;\n    }\n    tags.push({\n      index: match.index,\n      raw: match[0],\n      name: canonical.get(match[1]!.toLowerCase())!,\n      attributes: parseAttributes(match[2]!),\n    });\n  }\n  return tags;\n};\n"]}

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

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

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

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

package/dist/render/markdown/index.js

@@ -6,4 +6,5 @@
  */
 export { md, serializeMarkdown } from './builder.js';
 export { renderMarkdownEnvelope, } from './envelope.js';
+export { splitAuthoredMarkdown, } from './split.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/render/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EAGL,sBAAsB,GACvB,MAAM,YAAY,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport { md, serializeMarkdown } from './builder';\n\nexport {\n  type MarkdownEnvelopeDispatcher,\n  type MarkdownEnvelopeOptions,\n  renderMarkdownEnvelope,\n} from './envelope';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/render/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAGL,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAGL,qBAAqB,GACtB,MAAM,SAAS,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport { md, serializeMarkdown } from './builder';\nexport {\n  type MarkdownEnvelopeDispatcher,\n  type MarkdownEnvelopeOptions,\n  renderMarkdownEnvelope,\n} from './envelope';\n\nexport {\n  type AuthoredMarkdownSegment,\n  type SplitAuthoredMarkdownOptions,\n  splitAuthoredMarkdown,\n} from './split';\n"]}

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

@@ -0,0 +1,32 @@
+import type { MarkdownContent } from '../../define/markdown_content.js';
+/** A piece of authored Markdown, or one of the host's elements cut out of it. */
+export type AuthoredMarkdownSegment = {
+    type: 'markdown';
+    content: MarkdownContent;
+    /** The text `content` was built from, for a host that stores a string and passes it to `md.authored` later. */
+    source: string;
+} | {
+    type: 'element';
+    /** The name as listed in {@link SplitAuthoredMarkdownOptions.elements}. */
+    name: string;
+    /** Attribute values as written, keyed by lower-cased name; a bare attribute is `''`. */
+    attributes: Readonly<Record<string, string>>;
+};
+export interface SplitAuthoredMarkdownOptions {
+    /** Tag names to cut out, matched case-insensitively and whole. */
+    readonly elements: readonly string[];
+}
+/**
+ * Splits authored Markdown at the host's own elements, such as
+ * `<render_attachment id="…" />`, so the host can replace each with content
+ * of its own without cutting the raw string. The source is parsed once, so a
+ * tag in code, a link destination or title, an image's alt text, or raw HTML
+ * stays text, and a list, table, quote, or emphasis around a tag stays whole.
+ * Each `markdown` segment is sanitized as `md.authored` sanitizes; past the
+ * parse budget the source is cut at each tag into inert pieces.
+ *
+ * @example
+ * splitAuthoredMarkdown(message, { elements: ['render_attachment'] })
+ */
+export declare const splitAuthoredMarkdown: (source: string, { elements }: SplitAuthoredMarkdownOptions) => AuthoredMarkdownSegment[];
+//# sourceMappingURL=split.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../src/render/markdown/split.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAMrE,iFAAiF;AACjF,MAAM,MAAM,uBAAuB,GAC/B;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC;IACzB,+GAA+G;IAC/G,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9C,CAAC;AAEN,MAAM,WAAW,4BAA4B;IAC3C,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AA8UD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,cAAc,4BAA4B,KACzC,uBAAuB,EAezB,CAAC"}

package/dist/render/markdown/split.js

@@ -0,0 +1,321 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { md, printParsed, verbatim } from './builder.js';
+import { exceedsParseBudget, inert, parseGfmBlocks } from './format.js';
+import { findHostTags } from './host_tags.js';
+// A sentinel keeps the tag's own `<` and `>` as its edges, so emphasis and
+// other delimiters around it read exactly as they did around the tag, and
+// holds private-use characters between them, which no Markdown construct
+// reads, so it parses as text wherever the tag was written. Any already in
+// the source, literal or as a character reference (the only other way text
+// can decode to one), are replaced first, so the parsed text holds sentinels
+// only where tags were.
+const SENTINEL_RE = /<\uE000(\d+)\uE001>/g;
+// In a link destination the parser strips the angle brackets.
+const SENTINEL_ANYWHERE_RE = /<?\uE000(\d+)\uE001>?/g;
+const RESERVED_RE = /[\uE000\uE001]|&#(?:[xX]0*[eE]00[01]|0*5734[45]);/g;
+const sentinel = (index) => `<\uE000${index}\uE001>`;
+const withoutReserved = (source) => source.replace(RESERVED_RE, (match) => match.length === 1 ? '\uFFFD' : '&#xFFFD;');
+// Tags written identically get the same sentinel, so a reference label that
+// holds one still matches a definition that holds the same. Sharing by
+// exact text keeps each tag's attributes and spelling its own.
+const substitute = (source, tags) => {
+    const first = new Map();
+    let out = '';
+    let cursor = 0;
+    tags.forEach((tag, index) => {
+        if (!first.has(tag.raw)) {
+            first.set(tag.raw, index);
+        }
+        out += source.slice(cursor, tag.index) + sentinel(first.get(tag.raw));
+        cursor = tag.index + tag.raw.length;
+    });
+    return out + source.slice(cursor);
+};
+// The GFM serializer's cost grows steeply with nesting depth, while the
+// parse budget bounds breadth, not depth. Nothing authored nests this deep.
+const MAX_DEPTH = 64;
+const exceedsDepth = (nodes, depth = 1) => depth > MAX_DEPTH ||
+    nodes.some((node) => 'children' in node && exceedsDepth(node.children, depth + 1));
+// The tag's node in the tree, until it is cut out again.
+const HOST = 'isomerHostElement';
+const isHost = (node) => node.type === HOST;
+const hostTag = (node) => node.tag;
+const element = ({ name, attributes }) => ({
+    type: 'element',
+    name,
+    attributes,
+});
+const markdown = (source) => source.trim() === ''
+    ? []
+    : [{ type: 'markdown', content: md.authored(source), source }];
+// A sentinel in a text node becomes a host node between the text around it.
+// In any other string (code, alt, url, title, HTML) the tag text goes back. A
+// footnote prints at the end of its segment, away from where it is cited, so
+// a tag inside one is literal too.
+const resolve = (node, tags, literal) => {
+    if (node.type === 'text' && !literal) {
+        const parts = [];
+        let cursor = 0;
+        for (const match of node.value.matchAll(SENTINEL_RE)) {
+            if (match.index > cursor) {
+                parts.push({
+                    type: 'text',
+                    value: node.value.slice(cursor, match.index),
+                });
+            }
+            parts.push({
+                type: HOST,
+                tag: tags[Number(match[1])],
+            });
+            cursor = match.index + match[0].length;
+        }
+        if (parts.length === 0) {
+            return [node];
+        }
+        if (cursor < node.value.length) {
+            parts.push({ type: 'text', value: node.value.slice(cursor) });
+        }
+        return parts;
+    }
+    const restored = { ...node };
+    for (const [key, value] of Object.entries(restored)) {
+        if (typeof value === 'string') {
+            restored[key] = value.replace(SENTINEL_ANYWHERE_RE, (_, index) => tags[Number(index)].raw);
+        }
+    }
+    if ('children' in node) {
+        restored.children = node.children.flatMap((child) => resolve(child, tags, literal || node.type === 'footnoteDefinition'));
+    }
+    return [restored];
+};
+// Depth-first, in document order.
+const walk = (node, visit) => {
+    visit(node);
+    if ('children' in node) {
+        node.children.forEach((child) => walk(child, visit));
+    }
+};
+const PHRASING_PARENTS = new Set([
+    'delete',
+    'emphasis',
+    'heading',
+    'link',
+    'linkReference',
+    'paragraph',
+    'strong',
+    'tableCell',
+]);
+// A wrapper the tag leaves empty would print its markers alone (`****` is a
+// thematic break). Containers keep their place: an empty list item keeps the
+// numbering of the items after it.
+const DROPPED_WHEN_EMPTY = new Set([
+    'delete',
+    'emphasis',
+    'heading',
+    'link',
+    'linkReference',
+    'paragraph',
+    'strong',
+]);
+// Text either side of a removed tag joins, with one space if either side
+// had one. The run's edges are trimmed, and a hard break left at an edge is
+// dropped as `md.paragraph` drops it, since it would print as a bare `\\`.
+const tidyPhrasing = (children) => {
+    const joined = [];
+    for (const child of children) {
+        const previous = joined[joined.length - 1];
+        if (previous?.type === 'text' && child.type === 'text') {
+            const left = previous.value.replace(/\s+$/, '');
+            const right = child.value.replace(/^\s+/, '');
+            const spaced = left !== previous.value || right !== child.value;
+            joined[joined.length - 1] = {
+                type: 'text',
+                value: left + (spaced ? ' ' : '') + right,
+            };
+        }
+        else {
+            joined.push(child);
+        }
+    }
+    const isEdge = (node) => node?.type === 'break' ||
+        (node?.type === 'text' && node.value.trim() === '');
+    while (isEdge(joined[0])) {
+        joined.shift();
+    }
+    while (isEdge(joined[joined.length - 1])) {
+        joined.pop();
+    }
+    const first = joined[0];
+    if (first?.type === 'text') {
+        joined[0] = { ...first, value: first.value.trimStart() };
+    }
+    const last = joined[joined.length - 1];
+    if (last?.type === 'text') {
+        joined[joined.length - 1] = { ...last, value: last.value.trimEnd() };
+    }
+    return joined;
+};
+// `node` without its host nodes, which are appended to `found` in document
+// order; `[]` when nothing is left of it. Only a node a tag was removed
+// from is tidied, so phrasing elsewhere in the block stays as written.
+const strip = (node, found) => {
+    if (isHost(node)) {
+        found.push(hostTag(node));
+        return [];
+    }
+    if (!('children' in node)) {
+        return [node];
+    }
+    const before = found.length;
+    const stripped = node.children.flatMap((child) => strip(child, found));
+    if (found.length === before) {
+        return [node];
+    }
+    const children = PHRASING_PARENTS.has(node.type)
+        ? tidyPhrasing(stripped)
+        : stripped;
+    return children.length === 0 && DROPPED_WHEN_EMPTY.has(node.type)
+        ? []
+        : [{ ...node, children }];
+};
+// The first definition of each identifier, anywhere in the tree, as the
+// parser resolved references.
+const firstDefinitions = (blocks) => {
+    const definitions = new Map();
+    for (const block of blocks) {
+        walk(block, (node) => {
+            if (node.type === 'definition' && !definitions.has(node.identifier)) {
+                definitions.set(node.identifier, node);
+            }
+        });
+    }
+    return definitions;
+};
+// Each segment is a document of its own, so a definition another segment
+// holds is copied ahead of the run that references it.
+const printRun = (run, definitions) => {
+    const present = new Set();
+    const needed = new Map();
+    for (const block of run) {
+        walk(block, (node) => {
+            present.add(node);
+            if (node.type === 'linkReference' || node.type === 'imageReference') {
+                const definition = definitions.get(node.identifier);
+                if (definition) {
+                    needed.set(node.identifier, definition);
+                }
+            }
+        });
+    }
+    const carried = [...needed.values()].filter((node) => !present.has(node));
+    return printParsed([...carried, ...run]);
+};
+const splitBlocks = (blocks, tags) => {
+    const resolved = blocks.flatMap((block) => resolve(block, tags, false));
+    const definitions = firstDefinitions(resolved);
+    const segments = [];
+    let run = [];
+    const flush = () => {
+        if (run.length > 0) {
+            segments.push(...markdown(printRun(run, definitions)));
+        }
+        run = [];
+    };
+    // `block` without its tags joins the run; each tag ends the run after it.
+    const push = (block) => {
+        const found = [];
+        run.push(...strip(block, found));
+        for (const tag of found) {
+            flush();
+            segments.push(element(tag));
+        }
+    };
+    for (const block of resolved) {
+        if (block.type === 'definition') {
+            // Prints nothing where it stands; it is copied where it is referenced.
+            continue;
+        }
+        if (block.type !== 'paragraph' || !block.children.some(isHost)) {
+            push(block);
+            continue;
+        }
+        // A tag directly in a top-level paragraph splits it in place.
+        let piece = [];
+        const pushPiece = () => {
+            const children = tidyPhrasing(piece);
+            if (children.length > 0) {
+                push({ ...block, children });
+            }
+            piece = [];
+        };
+        for (const child of block.children) {
+            if (isHost(child)) {
+                pushPiece();
+                flush();
+                segments.push(element(hostTag(child)));
+            }
+            else {
+                piece.push(child);
+            }
+        }
+        pushPiece();
+    }
+    flush();
+    return segments;
+};
+// Past the parse budget there is no tree to consult, so the source is cut at
+// each tag and every piece degrades to inert text, as `md.authored` degrades.
+const cutLinearly = (source, tags) => {
+    const segments = [];
+    const push = (piece) => {
+        const text = piece.trim();
+        if (text !== '') {
+            segments.push({
+                type: 'markdown',
+                content: verbatim(inert(text), text),
+                source: text,
+            });
+        }
+    };
+    let cursor = 0;
+    for (const tag of tags) {
+        push(source.slice(cursor, tag.index));
+        segments.push(element(tag));
+        cursor = tag.index + tag.raw.length;
+    }
+    push(source.slice(cursor));
+    return segments;
+};
+/**
+ * Splits authored Markdown at the host's own elements, such as
+ * `<render_attachment id="…" />`, so the host can replace each with content
+ * of its own without cutting the raw string. The source is parsed once, so a
+ * tag in code, a link destination or title, an image's alt text, or raw HTML
+ * stays text, and a list, table, quote, or emphasis around a tag stays whole.
+ * Each `markdown` segment is sanitized as `md.authored` sanitizes; past the
+ * parse budget the source is cut at each tag into inert pieces.
+ *
+ * @example
+ * splitAuthoredMarkdown(message, { elements: ['render_attachment'] })
+ */
+export const splitAuthoredMarkdown = (source, { elements }) => {
+    const cleaned = withoutReserved(source);
+    const tags = findHostTags(cleaned, elements);
+    if (tags.length === 0) {
+        return markdown(source);
+    }
+    // The budget applies to the source as written: a long attribute value
+    // shrinks to a sentinel, but comes back in full wherever it is literal.
+    const blocks = exceedsParseBudget(cleaned)
+        ? null
+        : parseGfmBlocks(substitute(cleaned, tags));
+    return blocks && !exceedsDepth(blocks)
+        ? splitBlocks(blocks, tags)
+        : cutLinearly(cleaned, tags);
+};
+//# sourceMappingURL=split.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"split.js","sourceRoot":"","sources":["../../../src/render/markdown/split.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// Splits authored Markdown at a host's own tags without a second grammar:\n// each tag becomes a sentinel, the stock GFM parser parses the whole source\n// once, and where the sentinel lands says what the tag is. In a `text`\n// node it is a tag; anywhere else (a code span or block, an image's alt, a\n// link destination or title, raw HTML) it is literal and the tag text goes\n// back. Blocks that held a tag are then printed from the tree.\n\nimport type { Definition, Nodes, RootContent } from 'mdast';\n\nimport type { MarkdownContent } from '../../define/markdown_content';\n\nimport { md, printParsed, verbatim } from './builder';\nimport { exceedsParseBudget, inert, parseGfmBlocks } from './format';\nimport { findHostTags, type HostTag } from './host_tags';\n\n/** A piece of authored Markdown, or one of the host's elements cut out of it. */\nexport type AuthoredMarkdownSegment =\n  | {\n      type: 'markdown';\n      content: MarkdownContent;\n      /** The text `content` was built from, for a host that stores a string and passes it to `md.authored` later. */\n      source: string;\n    }\n  | {\n      type: 'element';\n      /** The name as listed in {@link SplitAuthoredMarkdownOptions.elements}. */\n      name: string;\n      /** Attribute values as written, keyed by lower-cased name; a bare attribute is `''`. */\n      attributes: Readonly<Record<string, string>>;\n    };\n\nexport interface SplitAuthoredMarkdownOptions {\n  /** Tag names to cut out, matched case-insensitively and whole. */\n  readonly elements: readonly string[];\n}\n\n// A sentinel keeps the tag's own `<` and `>` as its edges, so emphasis and\n// other delimiters around it read exactly as they did around the tag, and\n// holds private-use characters between them, which no Markdown construct\n// reads, so it parses as text wherever the tag was written. Any already in\n// the source, literal or as a character reference (the only other way text\n// can decode to one), are replaced first, so the parsed text holds sentinels\n// only where tags were.\nconst SENTINEL_RE = /<\\uE000(\\d+)\\uE001>/g;\n// In a link destination the parser strips the angle brackets.\nconst SENTINEL_ANYWHERE_RE = /<?\\uE000(\\d+)\\uE001>?/g;\nconst RESERVED_RE = /[\\uE000\\uE001]|&#(?:[xX]0*[eE]00[01]|0*5734[45]);/g;\nconst sentinel = (index: number): string => `<\\uE000${index}\\uE001>`;\nconst withoutReserved = (source: string): string =>\n  source.replace(RESERVED_RE, (match) =>\n    match.length === 1 ? '\\uFFFD' : '&#xFFFD;'\n  );\n\n// Tags written identically get the same sentinel, so a reference label that\n// holds one still matches a definition that holds the same. Sharing by\n// exact text keeps each tag's attributes and spelling its own.\nconst substitute = (source: string, tags: readonly HostTag[]): string => {\n  const first = new Map<string, number>();\n  let out = '';\n  let cursor = 0;\n  tags.forEach((tag, index) => {\n    if (!first.has(tag.raw)) {\n      first.set(tag.raw, index);\n    }\n    out += source.slice(cursor, tag.index) + sentinel(first.get(tag.raw)!);\n    cursor = tag.index + tag.raw.length;\n  });\n  return out + source.slice(cursor);\n};\n\n// The GFM serializer's cost grows steeply with nesting depth, while the\n// parse budget bounds breadth, not depth. Nothing authored nests this deep.\nconst MAX_DEPTH = 64;\n\nconst exceedsDepth = (nodes: readonly Nodes[], depth = 1): boolean =>\n  depth > MAX_DEPTH ||\n  nodes.some(\n    (node) => 'children' in node && exceedsDepth(node.children, depth + 1)\n  );\n\n// The tag's node in the tree, until it is cut out again.\nconst HOST = 'isomerHostElement';\ninterface HostNode {\n  type: typeof HOST;\n  tag: HostTag;\n}\n\nconst isHost = (node: Nodes): boolean => (node.type as string) === HOST;\nconst hostTag = (node: Nodes): HostTag => (node as unknown as HostNode).tag;\n\nconst element = ({ name, attributes }: HostTag): AuthoredMarkdownSegment => ({\n  type: 'element',\n  name,\n  attributes,\n});\n\nconst markdown = (source: string): AuthoredMarkdownSegment[] =>\n  source.trim() === ''\n    ? []\n    : [{ type: 'markdown', content: md.authored(source), source }];\n\n// A sentinel in a text node becomes a host node between the text around it.\n// In any other string (code, alt, url, title, HTML) the tag text goes back. A\n// footnote prints at the end of its segment, away from where it is cited, so\n// a tag inside one is literal too.\nconst resolve = (\n  node: Nodes,\n  tags: readonly HostTag[],\n  literal: boolean\n): Nodes[] => {\n  if (node.type === 'text' && !literal) {\n    const parts: Nodes[] = [];\n    let cursor = 0;\n    for (const match of node.value.matchAll(SENTINEL_RE)) {\n      if (match.index > cursor) {\n        parts.push({\n          type: 'text',\n          value: node.value.slice(cursor, match.index),\n        });\n      }\n      parts.push({\n        type: HOST,\n        tag: tags[Number(match[1])]!,\n      } as unknown as Nodes);\n      cursor = match.index + match[0].length;\n    }\n    if (parts.length === 0) {\n      return [node];\n    }\n    if (cursor < node.value.length) {\n      parts.push({ type: 'text', value: node.value.slice(cursor) });\n    }\n    return parts;\n  }\n  const restored = { ...node } as Record<string, unknown>;\n  for (const [key, value] of Object.entries(restored)) {\n    if (typeof value === 'string') {\n      restored[key] = value.replace(\n        SENTINEL_ANYWHERE_RE,\n        (_, index: string) => tags[Number(index)]!.raw\n      );\n    }\n  }\n  if ('children' in node) {\n    restored.children = node.children.flatMap((child) =>\n      resolve(child, tags, literal || node.type === 'footnoteDefinition')\n    );\n  }\n  return [restored as unknown as Nodes];\n};\n\n// Depth-first, in document order.\nconst walk = (node: Nodes, visit: (node: Nodes) => void): void => {\n  visit(node);\n  if ('children' in node) {\n    node.children.forEach((child) => walk(child, visit));\n  }\n};\n\nconst PHRASING_PARENTS = new Set([\n  'delete',\n  'emphasis',\n  'heading',\n  'link',\n  'linkReference',\n  'paragraph',\n  'strong',\n  'tableCell',\n]);\n\n// A wrapper the tag leaves empty would print its markers alone (`****` is a\n// thematic break). Containers keep their place: an empty list item keeps the\n// numbering of the items after it.\nconst DROPPED_WHEN_EMPTY = new Set([\n  'delete',\n  'emphasis',\n  'heading',\n  'link',\n  'linkReference',\n  'paragraph',\n  'strong',\n]);\n\n// Text either side of a removed tag joins, with one space if either side\n// had one. The run's edges are trimmed, and a hard break left at an edge is\n// dropped as `md.paragraph` drops it, since it would print as a bare `\\\\`.\nconst tidyPhrasing = (children: Nodes[]): Nodes[] => {\n  const joined: Nodes[] = [];\n  for (const child of children) {\n    const previous = joined[joined.length - 1];\n    if (previous?.type === 'text' && child.type === 'text') {\n      const left = previous.value.replace(/\\s+$/, '');\n      const right = child.value.replace(/^\\s+/, '');\n      const spaced = left !== previous.value || right !== child.value;\n      joined[joined.length - 1] = {\n        type: 'text',\n        value: left + (spaced ? ' ' : '') + right,\n      };\n    } else {\n      joined.push(child);\n    }\n  }\n  const isEdge = (node: Nodes | undefined): boolean =>\n    node?.type === 'break' ||\n    (node?.type === 'text' && node.value.trim() === '');\n  while (isEdge(joined[0])) {\n    joined.shift();\n  }\n  while (isEdge(joined[joined.length - 1])) {\n    joined.pop();\n  }\n  const first = joined[0];\n  if (first?.type === 'text') {\n    joined[0] = { ...first, value: first.value.trimStart() };\n  }\n  const last = joined[joined.length - 1];\n  if (last?.type === 'text') {\n    joined[joined.length - 1] = { ...last, value: last.value.trimEnd() };\n  }\n  return joined;\n};\n\n// `node` without its host nodes, which are appended to `found` in document\n// order; `[]` when nothing is left of it. Only a node a tag was removed\n// from is tidied, so phrasing elsewhere in the block stays as written.\nconst strip = (node: Nodes, found: HostTag[]): Nodes[] => {\n  if (isHost(node)) {\n    found.push(hostTag(node));\n    return [];\n  }\n  if (!('children' in node)) {\n    return [node];\n  }\n  const before = found.length;\n  const stripped = node.children.flatMap((child) => strip(child, found));\n  if (found.length === before) {\n    return [node];\n  }\n  const children = PHRASING_PARENTS.has(node.type)\n    ? tidyPhrasing(stripped)\n    : stripped;\n  return children.length === 0 && DROPPED_WHEN_EMPTY.has(node.type)\n    ? []\n    : [{ ...node, children } as Nodes];\n};\n\n// The first definition of each identifier, anywhere in the tree, as the\n// parser resolved references.\nconst firstDefinitions = (\n  blocks: readonly Nodes[]\n): ReadonlyMap<string, Definition> => {\n  const definitions = new Map<string, Definition>();\n  for (const block of blocks) {\n    walk(block, (node) => {\n      if (node.type === 'definition' && !definitions.has(node.identifier)) {\n        definitions.set(node.identifier, node);\n      }\n    });\n  }\n  return definitions;\n};\n\n// Each segment is a document of its own, so a definition another segment\n// holds is copied ahead of the run that references it.\nconst printRun = (\n  run: readonly Nodes[],\n  definitions: ReadonlyMap<string, Definition>\n): string => {\n  const present = new Set<Nodes>();\n  const needed = new Map<string, Definition>();\n  for (const block of run) {\n    walk(block, (node) => {\n      present.add(node);\n      if (node.type === 'linkReference' || node.type === 'imageReference') {\n        const definition = definitions.get(node.identifier);\n        if (definition) {\n          needed.set(node.identifier, definition);\n        }\n      }\n    });\n  }\n  const carried = [...needed.values()].filter((node) => !present.has(node));\n  return printParsed([...carried, ...run]);\n};\n\nconst splitBlocks = (\n  blocks: readonly Nodes[],\n  tags: readonly HostTag[]\n): AuthoredMarkdownSegment[] => {\n  const resolved = blocks.flatMap((block) => resolve(block, tags, false));\n  const definitions = firstDefinitions(resolved);\n  const segments: AuthoredMarkdownSegment[] = [];\n  let run: Nodes[] = [];\n  const flush = (): void => {\n    if (run.length > 0) {\n      segments.push(...markdown(printRun(run, definitions)));\n    }\n    run = [];\n  };\n  // `block` without its tags joins the run; each tag ends the run after it.\n  const push = (block: Nodes): void => {\n    const found: HostTag[] = [];\n    run.push(...strip(block, found));\n    for (const tag of found) {\n      flush();\n      segments.push(element(tag));\n    }\n  };\n  for (const block of resolved) {\n    if (block.type === 'definition') {\n      // Prints nothing where it stands; it is copied where it is referenced.\n      continue;\n    }\n    if (block.type !== 'paragraph' || !block.children.some(isHost)) {\n      push(block);\n      continue;\n    }\n    // A tag directly in a top-level paragraph splits it in place.\n    let piece: Nodes[] = [];\n    const pushPiece = (): void => {\n      const children = tidyPhrasing(piece);\n      if (children.length > 0) {\n        push({ ...block, children } as Nodes);\n      }\n      piece = [];\n    };\n    for (const child of block.children) {\n      if (isHost(child)) {\n        pushPiece();\n        flush();\n        segments.push(element(hostTag(child)));\n      } else {\n        piece.push(child);\n      }\n    }\n    pushPiece();\n  }\n  flush();\n  return segments;\n};\n\n// Past the parse budget there is no tree to consult, so the source is cut at\n// each tag and every piece degrades to inert text, as `md.authored` degrades.\nconst cutLinearly = (\n  source: string,\n  tags: readonly HostTag[]\n): AuthoredMarkdownSegment[] => {\n  const segments: AuthoredMarkdownSegment[] = [];\n  const push = (piece: string): void => {\n    const text = piece.trim();\n    if (text !== '') {\n      segments.push({\n        type: 'markdown',\n        content: verbatim(inert(text), text),\n        source: text,\n      });\n    }\n  };\n  let cursor = 0;\n  for (const tag of tags) {\n    push(source.slice(cursor, tag.index));\n    segments.push(element(tag));\n    cursor = tag.index + tag.raw.length;\n  }\n  push(source.slice(cursor));\n  return segments;\n};\n\n/**\n * Splits authored Markdown at the host's own elements, such as\n * `<render_attachment id=\"…\" />`, so the host can replace each with content\n * of its own without cutting the raw string. The source is parsed once, so a\n * tag in code, a link destination or title, an image's alt text, or raw HTML\n * stays text, and a list, table, quote, or emphasis around a tag stays whole.\n * Each `markdown` segment is sanitized as `md.authored` sanitizes; past the\n * parse budget the source is cut at each tag into inert pieces.\n *\n * @example\n * splitAuthoredMarkdown(message, { elements: ['render_attachment'] })\n */\nexport const splitAuthoredMarkdown = (\n  source: string,\n  { elements }: SplitAuthoredMarkdownOptions\n): AuthoredMarkdownSegment[] => {\n  const cleaned = withoutReserved(source);\n  const tags = findHostTags(cleaned, elements);\n  if (tags.length === 0) {\n    return markdown(source);\n  }\n  // The budget applies to the source as written: a long attribute value\n  // shrinks to a sentinel, but comes back in full wherever it is literal.\n  const blocks = exceedsParseBudget(cleaned)\n    ? null\n    : (parseGfmBlocks(substitute(cleaned, tags)) as\n        readonly RootContent[] | null);\n  return blocks && !exceedsDepth(blocks)\n    ? splitBlocks(blocks, tags)\n    : cutLinearly(cleaned, tags);\n};\n"]}

package/dist/render/react/content.d.ts

@@ -27,7 +27,7 @@ export interface CompositionWrapperOptions {
     framed?: boolean;
     /** Adds the `fluid` class. */
     fluid?: boolean;
-    /** Sets `data-theme`; defaults to the composition's `theme`, and `auto` sets nothing so the page's scheme applies. */
+    /** Sets `data-theme` and `color-scheme`, which `light-dark()` resolves against; defaults to the composition's `theme`, and `auto` sets nothing so the page's scheme applies. */
     theme?: RenderTheme;
     /** Used only when the composition has neither `meta.ariaLabel` nor a `title`. Defaults to `'View'`. */
     defaultAriaLabel?: string;

package/dist/render/react/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/render/react/content.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE1E,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB,CACrC,KAAK,SAAS,aAAa,EAC3B,QAAQ,GAAG,sBAAsB;IAEjC,4GAA4G;IAC5G,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACzD;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,KAAK,SAAS,aAAa,EAC3B,QAAQ,GAAG,sBAAsB,EAEjC,aAAa,WAAW,CAAC,KAAK,CAAC,EAC/B,YAAY,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,EACnD,SAAS,QAAQ,EACjB,cAAoB,mBAAwB,KAC3C,SAwBA,CAAC;AAkBJ,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sHAAsH;IACtH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,SAAS,aAAa,EAChE,SAAS,SAAS,EAClB,aAAa,WAAW,CAAC,KAAK,CAAC,EAC/B,8CAKG,yBAA8B,KAChC,YAaA,CAAC"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/render/react/content.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE1E,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB,CACrC,KAAK,SAAS,aAAa,EAC3B,QAAQ,GAAG,sBAAsB;IAEjC,4GAA4G;IAC5G,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACzD;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,KAAK,SAAS,aAAa,EAC3B,QAAQ,GAAG,sBAAsB,EAEjC,aAAa,WAAW,CAAC,KAAK,CAAC,EAC/B,YAAY,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,EACnD,SAAS,QAAQ,EACjB,cAAoB,mBAAwB,KAC3C,SAwBA,CAAC;AAkBJ,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gLAAgL;IAChL,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,SAAS,aAAa,EAChE,SAAS,SAAS,EAClB,aAAa,WAAW,CAAC,KAAK,CAAC,EAC/B,8CAKG,yBAA8B,KAChC,YAeA,CAAC"}

package/dist/render/react/content.js

@@ -34,6 +34,8 @@ export const wrapCompositionContent = (content, composition, { framed = true, fl
         .join(' '),
     role: 'group',
     'aria-label': composition.meta?.ariaLabel ?? composition.title ?? defaultAriaLabel,
-    ...(theme === 'auto' ? {} : { 'data-theme': theme }),
+    ...(theme === 'auto'
+        ? {}
+        : { 'data-theme': theme, style: { colorScheme: theme } }),
 }, content);
 //# sourceMappingURL=content.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/render/react/content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,QAAQ,GAGT,MAAM,OAAO,CAAC;AAyBf;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAItC,WAA+B,EAC/B,UAAmD,EACnD,OAAiB,EACjB,EAAE,OAAO,GAAG,IAAI,KAA0B,EAAE,EACjC,EAAE,CACb,aAAa,CACX,QAAQ,EACR,IAAI,EACJ,GAAG;IACD,OAAO,IAAI,WAAW,CAAC,KAAK;QAC1B,CAAC,CAAC,aAAa,CAAC,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,aAAa,CACX,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,aAAa,CAAC,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;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;AACH,MAAM,CAAC,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,aAAa,CACX,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","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"]}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/render/react/content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,QAAQ,GAGT,MAAM,OAAO,CAAC;AAyBf;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAItC,WAA+B,EAC/B,UAAmD,EACnD,OAAiB,EACjB,EAAE,OAAO,GAAG,IAAI,KAA0B,EAAE,EACjC,EAAE,CACb,aAAa,CACX,QAAQ,EACR,IAAI,EACJ,GAAG;IACD,OAAO,IAAI,WAAW,CAAC,KAAK;QAC1B,CAAC,CAAC,aAAa,CAAC,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,aAAa,CACX,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,aAAa,CAAC,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;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;AACH,MAAM,CAAC,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,aAAa,CACX,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;QAClB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC;CAC5D,EACD,OAAO,CACR,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\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` and `color-scheme`, which `light-dark()` resolves against; 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'\n        ? {}\n        : { 'data-theme': theme, style: { colorScheme: theme } }),\n    },\n    content\n  );\n"]}

package/dist/render/slack/markdown_content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown_content.d.ts","sourceRoot":"","sources":["../../../src/render/slack/markdown_content.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIrE,OAAO,EAEL,KAAK,UAAU,EAOhB,MAAM,UAAU,CAAC;AA8dlB;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GACvC,SAAS,eAAe,KACvB,UAAU,EAKV,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,UAAU,EAC1B,CAAC"}
+{"version":3,"file":"markdown_content.d.ts","sourceRoot":"","sources":["../../../src/render/slack/markdown_content.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIrE,OAAO,EAEL,KAAK,UAAU,EAOhB,MAAM,UAAU,CAAC;AAoelB;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GACvC,SAAS,eAAe,KACvB,UAAU,EAKV,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,UAAU,EAC1B,CAAC"}

package/dist/render/slack/markdown_content.js

@@ -107,7 +107,8 @@ const unquoted = (node) => node.type === 'blockquote' ? node.children.flatMap(un
 // nested list follows at the next indent; any other block, such as a table,
 // follows on its own; what the item holds after either follows unbulleted,
 // since a Slack list item cannot resume; and the list resumes at its next
-// number. A task item's first line leads with its box.
+// number. An empty item keeps its number, so the list resumes past it. A task
+// item's first line leads with its box.
 const listPieces = (list, indent) => {
     const style = list.ordered ? 'ordered' : 'bullet';
     const out = [];
@@ -167,6 +168,11 @@ const listPieces = (list, indent) => {
             }
         }
         emit();
+        if (item.children.length === 0) {
+            flush();
+            number += 1;
+            offset = number - 1;
+        }
     }
     flush();
     return out;