@elastic/isomer-sdk 0.2.0 → 0.4.0

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/react/index.d.ts

@@ -1,3 +1,4 @@
 export { type CompositionWrapperOptions, type ReactContentDispatcher, type ReactContentOptions, renderCompositionContent, wrapCompositionContent, } from './content.js';
 export { applyEnhancements } from './enhancements.js';
+export { renderMarkdownContent } from './markdown_content.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/react/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/react/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/render/react/index.js

@@ -6,4 +6,5 @@
  */
 export { renderCompositionContent, wrapCompositionContent, } from './content.js';
 export { applyEnhancements } from './enhancements.js';
+export { renderMarkdownContent } from './markdown_content.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/render/react/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport {\n  type CompositionWrapperOptions,\n  type ReactContentDispatcher,\n  type ReactContentOptions,\n  renderCompositionContent,\n  wrapCompositionContent,\n} from './content';\nexport { applyEnhancements } from './enhancements';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/render/react/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport {\n  type CompositionWrapperOptions,\n  type ReactContentDispatcher,\n  type ReactContentOptions,\n  renderCompositionContent,\n  wrapCompositionContent,\n} from './content';\nexport { applyEnhancements } from './enhancements';\nexport { renderMarkdownContent } from './markdown_content';\n"]}

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

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+import type { MarkdownContent } from '../../define/markdown_content.js';
+/**
+ * Builder content as React elements: paragraphs, headings, lists, quotes, code, tables, and thematic breaks, with inline marks, links, and images. Source from `md.authored` is parsed as GFM, once, as the Markdown and Slack surfaces read it.
+ *
+ * Links and images follow `md`'s URL policy: a blocked link keeps its label on {@link BLOCKED_HREF}, and a blocked image degrades to its alt text.
+ */
+export declare const renderMarkdownContent: (content: MarkdownContent) => ReactNode;
+//# sourceMappingURL=markdown_content.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown_content.d.ts","sourceRoot":"","sources":["../../../src/render/react/markdown_content.ts"],"names":[],"mappings":"AAUA,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAWhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AA+MrE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,eAAe,KAAG,SAK9D,CAAC"}

package/dist/render/react/markdown_content.js

@@ -0,0 +1,139 @@
+/*
+ * 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.
+ */
+// Builder content as React elements, read from the blocks the Markdown and
+// Slack surfaces read. Unstyled: a pack's stylesheet owns the look.
+import { createElement, Fragment } from 'react';
+import { BLOCKED_HREF, sanitizeParsedAssetUrl, sanitizeParsedNavigationHref, } from '../../validate/url.js';
+import { resolvedMarkdownBlocks } from '../markdown/blocks.js';
+const HEADINGS = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'];
+const footnoteLabel = ({ identifier, label, }) => `[^${label ?? identifier}]`;
+const plainText = (node) => {
+    if ('value' in node) {
+        return node.value;
+    }
+    if (node.type === 'image') {
+        return node.alt ?? '';
+    }
+    if (node.type === 'footnoteReference') {
+        return footnoteLabel(node);
+    }
+    return 'children' in node ? node.children.map(plainText).join('') : '';
+};
+const keyed = (nodes) => nodes.map((node, index) => createElement(Fragment, { key: index }, node));
+const inlines = (nodes) => keyed(nodes.map(inline));
+const inline = (node) => {
+    switch (node.type) {
+        case 'strong':
+            return createElement('strong', null, ...inlines(node.children));
+        case 'emphasis':
+            return createElement('em', null, ...inlines(node.children));
+        case 'delete':
+            return createElement('del', null, ...inlines(node.children));
+        case 'inlineCode':
+            return createElement('code', null, node.value);
+        case 'break':
+            return createElement('br');
+        case 'link':
+            return createElement('a', {
+                href: sanitizeParsedNavigationHref(node.url) ?? BLOCKED_HREF,
+                ...(node.title ? { title: node.title } : {}),
+            }, ...inlines(node.children));
+        case 'image': {
+            const src = sanitizeParsedAssetUrl(node.url);
+            return src === null
+                ? (node.alt ?? '')
+                : createElement('img', {
+                    src,
+                    alt: node.alt ?? '',
+                    ...(node.title ? { title: node.title } : {}),
+                });
+        }
+        default:
+            return plainText(node);
+    }
+};
+const paragraphCount = (item) => item.children.filter(({ type }) => type === 'paragraph').length;
+// A spread list, a spread item, or an item with two paragraphs makes the whole list loose.
+const items = (list) => {
+    const tight = list.spread !== true &&
+        !list.children.some((item) => item.spread === true || paragraphCount(item) > 1);
+    return list.children.map((item, index) => listItem(item, index, tight));
+};
+// A task item's checkbox leads its first paragraph, so a loose item keeps it on the task's line.
+const listItem = (item, key, tight) => {
+    const checkbox = typeof item.checked === 'boolean'
+        ? [
+            createElement('input', {
+                type: 'checkbox',
+                checked: item.checked,
+                disabled: true,
+            }),
+            ' ',
+        ]
+        : [];
+    const [first, ...rest] = item.children;
+    const leadsWithParagraph = first?.type === 'paragraph';
+    const lead = leadsWithParagraph
+        ? [...checkbox, ...inlines(first.children)]
+        : checkbox;
+    const head = leadsWithParagraph && !tight ? [createElement('p', null, ...lead)] : lead;
+    const body = (leadsWithParagraph ? rest : item.children).flatMap((child) => child.type === 'paragraph' && tight
+        ? inlines(child.children)
+        : [block(child)]);
+    return createElement('li', { key }, ...keyed([...head, ...body]));
+};
+const tableRows = (table) => {
+    const [header, ...body] = table.children;
+    const cells = (row, tag) => createElement('tr', null, ...row.children.map((cell, index) => {
+        const align = table.align?.[index];
+        return createElement(tag, {
+            key: index,
+            ...(align ? { style: { textAlign: align } } : {}),
+        }, ...inlines(cell.children));
+    }));
+    return createElement(Fragment, null, header
+        ? createElement('thead', { key: 'head' }, cells(header, 'th'))
+        : null, body.length > 0
+        ? createElement('tbody', { key: 'body' }, ...body.map((row, index) => createElement(Fragment, { key: index }, cells(row, 'td'))))
+        : null);
+};
+const blocks = (nodes) => keyed(nodes.map(block));
+const block = (node) => {
+    switch (node.type) {
+        case 'paragraph':
+            return createElement('p', null, ...inlines(node.children));
+        case 'heading':
+            return createElement(HEADINGS[node.depth - 1], null, ...inlines(node.children));
+        case 'blockquote':
+            return createElement('blockquote', null, ...blocks(node.children));
+        case 'list':
+            return createElement(node.ordered ? 'ol' : 'ul', node.ordered && node.start != null && node.start !== 1
+                ? { start: node.start }
+                : null, ...items(node));
+        case 'code':
+            return createElement('pre', null, createElement('code', node.lang ? { className: `language-${node.lang}` } : null, node.value));
+        case 'table':
+            return createElement('table', null, tableRows(node));
+        case 'thematicBreak':
+            return createElement('hr');
+        case 'html':
+            return createElement('p', null, node.value);
+        case 'footnoteDefinition': {
+            const [first, ...rest] = node.children;
+            return createElement(Fragment, null, createElement('p', null, `${footnoteLabel(node)}: `, ...(first?.type === 'paragraph' ? inlines(first.children) : [])), ...blocks(first?.type === 'paragraph' ? rest : node.children));
+        }
+        default:
+            return null;
+    }
+};
+/**
+ * Builder content as React elements: paragraphs, headings, lists, quotes, code, tables, and thematic breaks, with inline marks, links, and images. Source from `md.authored` is parsed as GFM, once, as the Markdown and Slack surfaces read it.
+ *
+ * Links and images follow `md`'s URL policy: a blocked link keeps its label on {@link BLOCKED_HREF}, and a blocked image degrades to its alt text.
+ */
+export const renderMarkdownContent = (content) => createElement(Fragment, null, ...blocks(resolvedMarkdownBlocks(content)));
+//# sourceMappingURL=markdown_content.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown_content.js","sourceRoot":"","sources":["../../../src/render/react/markdown_content.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// Builder content as React elements, read from the blocks the Markdown and\n// Slack surfaces read. Unstyled: a pack's stylesheet owns the look.\n\nimport { createElement, Fragment, type ReactNode } from 'react';\nimport type {\n  FootnoteDefinition,\n  List,\n  ListItem,\n  Nodes,\n  PhrasingContent,\n  RootContent,\n  Table,\n} from 'mdast';\n\nimport type { MarkdownContent } from '../../define/markdown_content';\nimport {\n  BLOCKED_HREF,\n  sanitizeParsedAssetUrl,\n  sanitizeParsedNavigationHref,\n} from '../../validate/url';\nimport { resolvedMarkdownBlocks } from '../markdown/blocks';\n\nconst HEADINGS = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'] as const;\n\nconst footnoteLabel = ({\n  identifier,\n  label,\n}: Pick<FootnoteDefinition, 'identifier' | 'label'>): string =>\n  `[^${label ?? identifier}]`;\n\nconst plainText = (node: Nodes): string => {\n  if ('value' in node) {\n    return node.value;\n  }\n  if (node.type === 'image') {\n    return node.alt ?? '';\n  }\n  if (node.type === 'footnoteReference') {\n    return footnoteLabel(node);\n  }\n  return 'children' in node ? node.children.map(plainText).join('') : '';\n};\n\nconst keyed = (nodes: readonly ReactNode[]): ReactNode[] =>\n  nodes.map((node, index) => createElement(Fragment, { key: index }, node));\n\nconst inlines = (nodes: readonly PhrasingContent[]): ReactNode[] =>\n  keyed(nodes.map(inline));\n\nconst inline = (node: PhrasingContent): ReactNode => {\n  switch (node.type) {\n    case 'strong':\n      return createElement('strong', null, ...inlines(node.children));\n    case 'emphasis':\n      return createElement('em', null, ...inlines(node.children));\n    case 'delete':\n      return createElement('del', null, ...inlines(node.children));\n    case 'inlineCode':\n      return createElement('code', null, node.value);\n    case 'break':\n      return createElement('br');\n    case 'link':\n      return createElement(\n        'a',\n        {\n          href: sanitizeParsedNavigationHref(node.url) ?? BLOCKED_HREF,\n          ...(node.title ? { title: node.title } : {}),\n        },\n        ...inlines(node.children)\n      );\n    case 'image': {\n      const src = sanitizeParsedAssetUrl(node.url);\n      return src === null\n        ? (node.alt ?? '')\n        : createElement('img', {\n            src,\n            alt: node.alt ?? '',\n            ...(node.title ? { title: node.title } : {}),\n          });\n    }\n    default:\n      return plainText(node);\n  }\n};\n\nconst paragraphCount = (item: ListItem): number =>\n  item.children.filter(({ type }) => type === 'paragraph').length;\n\n// A spread list, a spread item, or an item with two paragraphs makes the whole list loose.\nconst items = (list: List): ReactNode[] => {\n  const tight =\n    list.spread !== true &&\n    !list.children.some(\n      (item) => item.spread === true || paragraphCount(item) > 1\n    );\n  return list.children.map((item, index) => listItem(item, index, tight));\n};\n\n// A task item's checkbox leads its first paragraph, so a loose item keeps it on the task's line.\nconst listItem = (item: ListItem, key: number, tight: boolean): ReactNode => {\n  const checkbox =\n    typeof item.checked === 'boolean'\n      ? [\n          createElement('input', {\n            type: 'checkbox',\n            checked: item.checked,\n            disabled: true,\n          }),\n          ' ',\n        ]\n      : [];\n  const [first, ...rest] = item.children;\n  const leadsWithParagraph = first?.type === 'paragraph';\n  const lead = leadsWithParagraph\n    ? [...checkbox, ...inlines(first.children)]\n    : checkbox;\n  const head =\n    leadsWithParagraph && !tight ? [createElement('p', null, ...lead)] : lead;\n  const body = (leadsWithParagraph ? rest : item.children).flatMap(\n    (child): ReactNode[] =>\n      child.type === 'paragraph' && tight\n        ? inlines(child.children)\n        : [block(child)]\n  );\n  return createElement('li', { key }, ...keyed([...head, ...body]));\n};\n\nconst tableRows = (table: Table): ReactNode => {\n  const [header, ...body] = table.children;\n  const cells = (row: Table['children'][number], tag: 'th' | 'td'): ReactNode =>\n    createElement(\n      'tr',\n      null,\n      ...row.children.map((cell, index) => {\n        const align = table.align?.[index];\n        return createElement(\n          tag,\n          {\n            key: index,\n            ...(align ? { style: { textAlign: align } } : {}),\n          },\n          ...inlines(cell.children)\n        );\n      })\n    );\n  return createElement(\n    Fragment,\n    null,\n    header\n      ? createElement('thead', { key: 'head' }, cells(header, 'th'))\n      : null,\n    body.length > 0\n      ? createElement(\n          'tbody',\n          { key: 'body' },\n          ...body.map((row, index) =>\n            createElement(Fragment, { key: index }, cells(row, 'td'))\n          )\n        )\n      : null\n  );\n};\n\nconst blocks = (nodes: readonly RootContent[]): ReactNode[] =>\n  keyed(nodes.map(block));\n\nconst block = (node: RootContent): ReactNode => {\n  switch (node.type) {\n    case 'paragraph':\n      return createElement('p', null, ...inlines(node.children));\n    case 'heading':\n      return createElement(\n        HEADINGS[node.depth - 1]!,\n        null,\n        ...inlines(node.children)\n      );\n    case 'blockquote':\n      return createElement('blockquote', null, ...blocks(node.children));\n    case 'list':\n      return createElement(\n        node.ordered ? 'ol' : 'ul',\n        node.ordered && node.start != null && node.start !== 1\n          ? { start: node.start }\n          : null,\n        ...items(node)\n      );\n    case 'code':\n      return createElement(\n        'pre',\n        null,\n        createElement(\n          'code',\n          node.lang ? { className: `language-${node.lang}` } : null,\n          node.value\n        )\n      );\n    case 'table':\n      return createElement('table', null, tableRows(node));\n    case 'thematicBreak':\n      return createElement('hr');\n    case 'html':\n      return createElement('p', null, node.value);\n    case 'footnoteDefinition': {\n      const [first, ...rest] = node.children;\n      return createElement(\n        Fragment,\n        null,\n        createElement(\n          'p',\n          null,\n          `${footnoteLabel(node)}: `,\n          ...(first?.type === 'paragraph' ? inlines(first.children) : [])\n        ),\n        ...blocks(first?.type === 'paragraph' ? rest : node.children)\n      );\n    }\n    default:\n      return null;\n  }\n};\n\n/**\n * Builder content as React elements: paragraphs, headings, lists, quotes, code, tables, and thematic breaks, with inline marks, links, and images. Source from `md.authored` is parsed as GFM, once, as the Markdown and Slack surfaces read it.\n *\n * Links and images follow `md`'s URL policy: a blocked link keeps its label on {@link BLOCKED_HREF}, and a blocked image degrades to its alt text.\n */\nexport const renderMarkdownContent = (content: MarkdownContent): ReactNode =>\n  createElement(\n    Fragment,\n    null,\n    ...blocks(resolvedMarkdownBlocks(content) as RootContent[])\n  );\n"]}

package/dist/render/slack/blocks.d.ts

@@ -1,10 +1,17 @@
-export type { SlackActionElement, SlackActionsBlock, SlackBlock, SlackButtonElement, SlackCheckboxesElement, SlackContextBlock, SlackDividerBlock, SlackFileReference, SlackHeaderBlock, SlackHeaderLevel, SlackImageBlock, SlackImageElement, SlackMrkdwnTextObject, SlackMultiStaticSelectElement, SlackOptionGroup, SlackOptionObject, SlackOverflowElement, SlackPlainTextObject, SlackRadioButtonsElement, SlackRawTextElement, SlackRichTextBlock, SlackRichTextBlockElement, SlackRichTextInline, SlackRichTextLink, SlackRichTextList, SlackRichTextPreformatted, SlackRichTextQuote, SlackRichTextSection, SlackRichTextStyle, SlackRichTextTag, SlackRichTextText, SlackSectionAccessory, SlackSectionBlock, SlackStaticSelectElement, SlackTableBlock, SlackTableCell, SlackTableColumnSetting, SlackTagColor, SlackTextObject, SlackVideoBlock, } from '../../define/slack_blocks.js';
+export type { SlackActionElement, SlackActionsBlock, SlackBlock, SlackButtonElement, SlackCheckboxesElement, SlackContainerBlock, SlackContainerChildBlock, SlackContextBlock, SlackDividerBlock, SlackFileReference, SlackHeaderBlock, SlackHeaderLevel, SlackImageBlock, SlackImageElement, SlackMrkdwnTextObject, SlackMultiStaticSelectElement, SlackOptionGroup, SlackOptionObject, SlackOverflowElement, SlackPlainTextObject, SlackRadioButtonsElement, SlackRawTextElement, SlackRichTextBlock, SlackRichTextBlockElement, SlackRichTextInline, SlackRichTextLink, SlackRichTextList, SlackRichTextPreformatted, SlackRichTextQuote, SlackRichTextSection, SlackRichTextStyle, SlackRichTextTag, SlackRichTextText, SlackSectionAccessory, SlackSectionBlock, SlackStaticSelectElement, SlackTableBlock, SlackTableCell, SlackTableColumnSetting, SlackTagColor, SlackTextObject, SlackVideoBlock, } from '../../define/slack_blocks.js';
 /**
  * Slack's published surface limits, enforced by the renderer so a composition
  * cannot silently trip Slack's validation.
  */
 export declare const SLACK_LIMITS: {
+    /** Top-level blocks; a `container`'s `child_blocks` do not count. */
     readonly blocksPerMessage: 50;
+    /** `container.title`, which is `plain_text`. */
+    readonly containerTitleChars: 150;
+    /** `container.subtitle`. */
+    readonly containerSubtitleChars: 150;
+    /** `container.child_blocks`; Slack also requires at least one. */
+    readonly containerChildBlocks: 10;
     /** `section.text`. */
     readonly sectionTextChars: 3000;
     /** One entry of `section.fields`. */

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

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/render/slack/blocks.ts"],"names":[],"mappings":"AAOA,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,YAAY;;IAEvB,sBAAsB;;IAEtB,qCAAqC;;IAErC,uCAAuC;;IAEvC,4CAA4C;;;IAG5C,oCAAoC;;;IAGpC,kFAAkF;;IAElF,yEAAyE;;IAEzE,sDAAsD;;IAEtD,4DAA4D;;IAE5D,4DAA4D;;IAE5D,+EAA+E;;IAE/E,yDAAyD;;IAEzD,0BAA0B;;IAE1B,6CAA6C;;IAE7C,4CAA4C;;IAE5C,6CAA6C;;IAE7C;;;;;OAKG;;IAEH,wDAAwD;;IAExD,iDAAiD;;IAEjD,oDAAoD;;IAEpD,mDAAmD;;IAEnD,6BAA6B;;IAE7B,4DAA4D;;IAE5D,kEAAkE;;IAElE,iEAAiE;;IAEjE,+BAA+B;;IAE/B,4BAA4B;;IAE5B,+BAA+B;;CAEvB,CAAC"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/render/slack/blocks.ts"],"names":[],"mappings":"AAOA,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,qEAAqE;;IAErE,gDAAgD;;IAEhD,4BAA4B;;IAE5B,kEAAkE;;IAElE,sBAAsB;;IAEtB,qCAAqC;;IAErC,uCAAuC;;IAEvC,4CAA4C;;;IAG5C,oCAAoC;;;IAGpC,kFAAkF;;IAElF,yEAAyE;;IAEzE,sDAAsD;;IAEtD,4DAA4D;;IAE5D,4DAA4D;;IAE5D,+EAA+E;;IAE/E,yDAAyD;;IAEzD,0BAA0B;;IAE1B,6CAA6C;;IAE7C,4CAA4C;;IAE5C,6CAA6C;;IAE7C;;;;;OAKG;;IAEH,wDAAwD;;IAExD,iDAAiD;;IAEjD,oDAAoD;;IAEpD,mDAAmD;;IAEnD,6BAA6B;;IAE7B,4DAA4D;;IAE5D,kEAAkE;;IAElE,iEAAiE;;IAEjE,+BAA+B;;IAE/B,4BAA4B;;IAE5B,+BAA+B;;CAEvB,CAAC"}

package/dist/render/slack/blocks.js

@@ -9,7 +9,14 @@
  * cannot silently trip Slack's validation.
  */
 export const SLACK_LIMITS = {
+    /** Top-level blocks; a `container`'s `child_blocks` do not count. */
     blocksPerMessage: 50,
+    /** `container.title`, which is `plain_text`. */
+    containerTitleChars: 150,
+    /** `container.subtitle`. */
+    containerSubtitleChars: 150,
+    /** `container.child_blocks`; Slack also requires at least one. */
+    containerChildBlocks: 10,
     /** `section.text`. */
     sectionTextChars: 3000,
     /** One entry of `section.fields`. */

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

@@ -1 +1 @@
-{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/render/slack/blocks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gBAAgB,EAAE,EAAE;IACpB,sBAAsB;IACtB,gBAAgB,EAAE,IAAI;IACtB,qCAAqC;IACrC,iBAAiB,EAAE,IAAI;IACvB,uCAAuC;IACvC,mBAAmB,EAAE,IAAI;IACzB,4CAA4C;IAC5C,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,EAAE;IACpB,oCAAoC;IACpC,eAAe,EAAE,EAAE;IACnB,iBAAiB,EAAE,EAAE;IACrB,kFAAkF;IAClF,iBAAiB,EAAE,IAAI;IACvB,yEAAyE;IACzE,eAAe,EAAE,EAAE;IACnB,sDAAsD;IACtD,gBAAgB,EAAE,GAAG;IACrB,4DAA4D;IAC5D,kBAAkB,EAAE,CAAC;IACrB,4DAA4D;IAC5D,gBAAgB,EAAE,EAAE;IACpB,+EAA+E;IAC/E,qBAAqB,EAAE,GAAG;IAC1B,yDAAyD;IACzD,gBAAgB,EAAE,GAAG;IACrB,0BAA0B;IAC1B,gBAAgB,EAAE,IAAI;IACtB,6CAA6C;IAC7C,QAAQ,EAAE,IAAI;IACd,4CAA4C;IAC5C,aAAa,EAAE,GAAG;IAClB,6CAA6C;IAC7C,qBAAqB,EAAE,CAAC;IACxB;;;;;OAKG;IACH,wBAAwB,EAAE,MAAM;IAChC,wDAAwD;IACxD,SAAS,EAAE,GAAG;IACd,iDAAiD;IACjD,YAAY,EAAE,EAAE;IAChB,oDAAoD;IACpD,aAAa,EAAE,IAAI;IACnB,mDAAmD;IACnD,iBAAiB,EAAE,IAAI;IACvB,6BAA6B;IAC7B,eAAe,EAAE,IAAI;IACrB,4DAA4D;IAC5D,eAAe,EAAE,GAAG;IACpB,kEAAkE;IAClE,qBAAqB,EAAE,GAAG;IAC1B,iEAAiE;IACjE,oBAAoB,EAAE,EAAE;IACxB,+BAA+B;IAC/B,eAAe,EAAE,EAAE;IACnB,4BAA4B;IAC5B,gBAAgB,EAAE,GAAG;IACrB,+BAA+B;IAC/B,qBAAqB,EAAE,EAAE;CACjB,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 type {\n  SlackActionElement,\n  SlackActionsBlock,\n  SlackBlock,\n  SlackButtonElement,\n  SlackCheckboxesElement,\n  SlackContextBlock,\n  SlackDividerBlock,\n  SlackFileReference,\n  SlackHeaderBlock,\n  SlackHeaderLevel,\n  SlackImageBlock,\n  SlackImageElement,\n  SlackMrkdwnTextObject,\n  SlackMultiStaticSelectElement,\n  SlackOptionGroup,\n  SlackOptionObject,\n  SlackOverflowElement,\n  SlackPlainTextObject,\n  SlackRadioButtonsElement,\n  SlackRawTextElement,\n  SlackRichTextBlock,\n  SlackRichTextBlockElement,\n  SlackRichTextInline,\n  SlackRichTextLink,\n  SlackRichTextList,\n  SlackRichTextPreformatted,\n  SlackRichTextQuote,\n  SlackRichTextSection,\n  SlackRichTextStyle,\n  SlackRichTextTag,\n  SlackRichTextText,\n  SlackSectionAccessory,\n  SlackSectionBlock,\n  SlackStaticSelectElement,\n  SlackTableBlock,\n  SlackTableCell,\n  SlackTableColumnSetting,\n  SlackTagColor,\n  SlackTextObject,\n  SlackVideoBlock,\n} from '../../define/slack_blocks';\n\n/**\n * Slack's published surface limits, enforced by the renderer so a composition\n * cannot silently trip Slack's validation.\n */\nexport const SLACK_LIMITS = {\n  blocksPerMessage: 50,\n  /** `section.text`. */\n  sectionTextChars: 3000,\n  /** One entry of `section.fields`. */\n  sectionFieldChars: 2000,\n  /** One entry of `context.elements`. */\n  contextElementChars: 2000,\n  /** `header.text`, which is `plain_text`. */\n  headerTextChars: 150,\n  fieldsPerSection: 10,\n  /** Elements per `context` block. */\n  contextElements: 10,\n  buttonsPerActions: 25,\n  /** Slack truncates the top-level `text` fallback in notifications around here. */\n  fallbackTextChars: 4000,\n  /** `plain_text` option labels (selects, radio, checkboxes, overflow). */\n  optionTextChars: 75,\n  /** Options per select, or per option group of one. */\n  optionsPerSelect: 100,\n  /** Options per overflow menu (Slack caps overflow at 5). */\n  optionsPerOverflow: 5,\n  /** Options per radio button group or checkboxes element. */\n  optionsPerChoice: 10,\n  /** Option groups per select, each holding up to `optionsPerSelect` options. */\n  optionGroupsPerSelect: 100,\n  /** An option's `value`, which interactions send back. */\n  optionValueChars: 150,\n  /** A button's `value`. */\n  buttonValueChars: 2000,\n  /** A button's or overflow option's `url`. */\n  urlChars: 3000,\n  /** An interactive element's `action_id`. */\n  actionIdChars: 255,\n  /** Max indent level for `rich_text_list`. */\n  richTextListMaxIndent: 8,\n  /**\n   * Characters across every table cell in one message. Slack publishes the\n   * same 10,000 figure per table and per message, so the message-wide\n   * aggregate is the binding one.\n   * https://docs.slack.dev/reference/block-kit/blocks/table-block/\n   */\n  tableCellCharsPerMessage: 10_000,\n  /** Rows per `table` block (includes the header row). */\n  tableRows: 100,\n  /** Cells per `table` row / columns per table. */\n  tableColumns: 20,\n  /** `image`/image-element `image_url` max length. */\n  imageUrlChars: 3000,\n  /** `image`/image-element `alt_text` max length. */\n  imageAltTextChars: 2000,\n  /** `image` block `title`. */\n  imageTitleChars: 2000,\n  /** `video` block `title`; Slack requires fewer than 200. */\n  videoTitleChars: 199,\n  /** `video` block `description`; Slack requires fewer than 200. */\n  videoDescriptionChars: 199,\n  /** `video` block `author_name`; Slack requires fewer than 50. */\n  videoAuthorNameChars: 49,\n  /** `button` element `text`. */\n  buttonTextChars: 75,\n  /** Select `placeholder`. */\n  placeholderChars: 150,\n  /** `option_groups[].label`. */\n  optionGroupLabelChars: 75,\n} as const;\n"]}
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/render/slack/blocks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+CH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,qEAAqE;IACrE,gBAAgB,EAAE,EAAE;IACpB,gDAAgD;IAChD,mBAAmB,EAAE,GAAG;IACxB,4BAA4B;IAC5B,sBAAsB,EAAE,GAAG;IAC3B,kEAAkE;IAClE,oBAAoB,EAAE,EAAE;IACxB,sBAAsB;IACtB,gBAAgB,EAAE,IAAI;IACtB,qCAAqC;IACrC,iBAAiB,EAAE,IAAI;IACvB,uCAAuC;IACvC,mBAAmB,EAAE,IAAI;IACzB,4CAA4C;IAC5C,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,EAAE;IACpB,oCAAoC;IACpC,eAAe,EAAE,EAAE;IACnB,iBAAiB,EAAE,EAAE;IACrB,kFAAkF;IAClF,iBAAiB,EAAE,IAAI;IACvB,yEAAyE;IACzE,eAAe,EAAE,EAAE;IACnB,sDAAsD;IACtD,gBAAgB,EAAE,GAAG;IACrB,4DAA4D;IAC5D,kBAAkB,EAAE,CAAC;IACrB,4DAA4D;IAC5D,gBAAgB,EAAE,EAAE;IACpB,+EAA+E;IAC/E,qBAAqB,EAAE,GAAG;IAC1B,yDAAyD;IACzD,gBAAgB,EAAE,GAAG;IACrB,0BAA0B;IAC1B,gBAAgB,EAAE,IAAI;IACtB,6CAA6C;IAC7C,QAAQ,EAAE,IAAI;IACd,4CAA4C;IAC5C,aAAa,EAAE,GAAG;IAClB,6CAA6C;IAC7C,qBAAqB,EAAE,CAAC;IACxB;;;;;OAKG;IACH,wBAAwB,EAAE,MAAM;IAChC,wDAAwD;IACxD,SAAS,EAAE,GAAG;IACd,iDAAiD;IACjD,YAAY,EAAE,EAAE;IAChB,oDAAoD;IACpD,aAAa,EAAE,IAAI;IACnB,mDAAmD;IACnD,iBAAiB,EAAE,IAAI;IACvB,6BAA6B;IAC7B,eAAe,EAAE,IAAI;IACrB,4DAA4D;IAC5D,eAAe,EAAE,GAAG;IACpB,kEAAkE;IAClE,qBAAqB,EAAE,GAAG;IAC1B,iEAAiE;IACjE,oBAAoB,EAAE,EAAE;IACxB,+BAA+B;IAC/B,eAAe,EAAE,EAAE;IACnB,4BAA4B;IAC5B,gBAAgB,EAAE,GAAG;IACrB,+BAA+B;IAC/B,qBAAqB,EAAE,EAAE;CACjB,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 type {\n  SlackActionElement,\n  SlackActionsBlock,\n  SlackBlock,\n  SlackButtonElement,\n  SlackCheckboxesElement,\n  SlackContainerBlock,\n  SlackContainerChildBlock,\n  SlackContextBlock,\n  SlackDividerBlock,\n  SlackFileReference,\n  SlackHeaderBlock,\n  SlackHeaderLevel,\n  SlackImageBlock,\n  SlackImageElement,\n  SlackMrkdwnTextObject,\n  SlackMultiStaticSelectElement,\n  SlackOptionGroup,\n  SlackOptionObject,\n  SlackOverflowElement,\n  SlackPlainTextObject,\n  SlackRadioButtonsElement,\n  SlackRawTextElement,\n  SlackRichTextBlock,\n  SlackRichTextBlockElement,\n  SlackRichTextInline,\n  SlackRichTextLink,\n  SlackRichTextList,\n  SlackRichTextPreformatted,\n  SlackRichTextQuote,\n  SlackRichTextSection,\n  SlackRichTextStyle,\n  SlackRichTextTag,\n  SlackRichTextText,\n  SlackSectionAccessory,\n  SlackSectionBlock,\n  SlackStaticSelectElement,\n  SlackTableBlock,\n  SlackTableCell,\n  SlackTableColumnSetting,\n  SlackTagColor,\n  SlackTextObject,\n  SlackVideoBlock,\n} from '../../define/slack_blocks';\n\n/**\n * Slack's published surface limits, enforced by the renderer so a composition\n * cannot silently trip Slack's validation.\n */\nexport const SLACK_LIMITS = {\n  /** Top-level blocks; a `container`'s `child_blocks` do not count. */\n  blocksPerMessage: 50,\n  /** `container.title`, which is `plain_text`. */\n  containerTitleChars: 150,\n  /** `container.subtitle`. */\n  containerSubtitleChars: 150,\n  /** `container.child_blocks`; Slack also requires at least one. */\n  containerChildBlocks: 10,\n  /** `section.text`. */\n  sectionTextChars: 3000,\n  /** One entry of `section.fields`. */\n  sectionFieldChars: 2000,\n  /** One entry of `context.elements`. */\n  contextElementChars: 2000,\n  /** `header.text`, which is `plain_text`. */\n  headerTextChars: 150,\n  fieldsPerSection: 10,\n  /** Elements per `context` block. */\n  contextElements: 10,\n  buttonsPerActions: 25,\n  /** Slack truncates the top-level `text` fallback in notifications around here. */\n  fallbackTextChars: 4000,\n  /** `plain_text` option labels (selects, radio, checkboxes, overflow). */\n  optionTextChars: 75,\n  /** Options per select, or per option group of one. */\n  optionsPerSelect: 100,\n  /** Options per overflow menu (Slack caps overflow at 5). */\n  optionsPerOverflow: 5,\n  /** Options per radio button group or checkboxes element. */\n  optionsPerChoice: 10,\n  /** Option groups per select, each holding up to `optionsPerSelect` options. */\n  optionGroupsPerSelect: 100,\n  /** An option's `value`, which interactions send back. */\n  optionValueChars: 150,\n  /** A button's `value`. */\n  buttonValueChars: 2000,\n  /** A button's or overflow option's `url`. */\n  urlChars: 3000,\n  /** An interactive element's `action_id`. */\n  actionIdChars: 255,\n  /** Max indent level for `rich_text_list`. */\n  richTextListMaxIndent: 8,\n  /**\n   * Characters across every table cell in one message. Slack publishes the\n   * same 10,000 figure per table and per message, so the message-wide\n   * aggregate is the binding one.\n   * https://docs.slack.dev/reference/block-kit/blocks/table-block/\n   */\n  tableCellCharsPerMessage: 10_000,\n  /** Rows per `table` block (includes the header row). */\n  tableRows: 100,\n  /** Cells per `table` row / columns per table. */\n  tableColumns: 20,\n  /** `image`/image-element `image_url` max length. */\n  imageUrlChars: 3000,\n  /** `image`/image-element `alt_text` max length. */\n  imageAltTextChars: 2000,\n  /** `image` block `title`. */\n  imageTitleChars: 2000,\n  /** `video` block `title`; Slack requires fewer than 200. */\n  videoTitleChars: 199,\n  /** `video` block `description`; Slack requires fewer than 200. */\n  videoDescriptionChars: 199,\n  /** `video` block `author_name`; Slack requires fewer than 50. */\n  videoAuthorNameChars: 49,\n  /** `button` element `text`. */\n  buttonTextChars: 75,\n  /** Select `placeholder`. */\n  placeholderChars: 150,\n  /** `option_groups[].label`. */\n  optionGroupLabelChars: 75,\n} as const;\n"]}

package/dist/render/slack/container.d.ts

@@ -0,0 +1,25 @@
+import { type SlackBlock, type SlackContainerBlock, type SlackContainerChildBlock, type SlackHeaderLevel } from './blocks.js';
+/** Options for {@link slackContainer}: the container's optional fields, and the level of the `header` it falls back to. */
+export type SlackContainerOptions = Partial<Pick<SlackContainerBlock, 'block_id' | 'subtitle' | 'icon' | 'width' | 'is_collapsible' | 'default_collapsed' | 'has_header_divider'>> & {
+    fallbackLevel?: SlackHeaderLevel;
+};
+/** A container Isomer fits, as opposed to one passed through `unmodeledSlackBlock`. */
+export declare const isContainer: (block: SlackBlock) => block is SlackContainerBlock;
+/** A container as the blocks it holds, led by its title and subtitle. */
+export declare const unwrapContainer: ({ title, rich_text_title, subtitle, child_blocks }: SlackContainerBlock, level?: SlackHeaderLevel) => SlackContainerChildBlock[];
+/**
+ * `container` holding `children`, with any nested container unwrapped, since
+ * Slack rejects one. A container left with no children, or more than
+ * `containerChildBlocks`, is unwrapped itself.
+ */
+export declare const containerWithChildren: (container: SlackContainerBlock, children: readonly SlackBlock[], level?: SlackHeaderLevel) => SlackBlock[];
+/**
+ * A titled section as one Block Kit `container`, from its title and the
+ * blocks its body rendered to, typically through `scope.renderSlack`.
+ *
+ * A nested container among `children` is unwrapped to its title and blocks.
+ * With no children, or more than `SLACK_LIMITS.containerChildBlocks`, the
+ * section falls back to a `header` at `fallbackLevel` followed by the blocks.
+ */
+export declare const slackContainer: (title: string, children: readonly SlackBlock[], { fallbackLevel, ...fields }?: SlackContainerOptions) => SlackBlock[];
+//# sourceMappingURL=container.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../src/render/slack/container.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAC;AAIlB,2HAA2H;AAC3H,MAAM,MAAM,qBAAqB,GAAG,OAAO,CACzC,IAAI,CACF,mBAAmB,EACjB,UAAU,GACV,UAAU,GACV,MAAM,GACN,OAAO,GACP,gBAAgB,GAChB,mBAAmB,GACnB,oBAAoB,CACvB,CACF,GAAG;IAAE,aAAa,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEzC,uFAAuF;AACvF,eAAO,MAAM,WAAW,GAAI,OAAO,UAAU,KAAG,KAAK,IAAI,mBACI,CAAC;AAE9D,yEAAyE;AACzE,eAAO,MAAM,eAAe,GAC1B,oDAAoD,mBAAmB,EACvE,QAAQ,gBAAgB,KACvB,wBAAwB,EAc1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,WAAW,mBAAmB,EAC9B,UAAU,SAAS,UAAU,EAAE,EAC/B,QAAQ,gBAAgB,KACvB,UAAU,EASZ,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,UAAU,SAAS,UAAU,EAAE,EAC/B,+BAA8B,qBAA0B,KACvD,UAAU,EAUV,CAAC"}

package/dist/render/slack/container.js

@@ -0,0 +1,55 @@
+/*
+ * 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 { SLACK_LIMITS, } from './blocks.js';
+import { formatHeaderText } from './format.js';
+import { isUnmodeledSlackBlock } from './unmodeled.js';
+/** A container Isomer fits, as opposed to one passed through `unmodeledSlackBlock`. */
+export const isContainer = (block) => block.type === 'container' && !isUnmodeledSlackBlock(block);
+/** A container as the blocks it holds, led by its title and subtitle. */
+export const unwrapContainer = ({ title, rich_text_title, subtitle, child_blocks }, level) => [
+    ...(rich_text_title
+        ? [rich_text_title]
+        : title
+            ? [
+                {
+                    type: 'header',
+                    text: title,
+                    ...(level === undefined ? {} : { level }),
+                },
+            ]
+            : []),
+    ...(subtitle ? [{ type: 'context', elements: [subtitle] }] : []),
+    ...child_blocks,
+];
+/**
+ * `container` holding `children`, with any nested container unwrapped, since
+ * Slack rejects one. A container left with no children, or more than
+ * `containerChildBlocks`, is unwrapped itself.
+ */
+export const containerWithChildren = (container, children, level) => {
+    const child_blocks = children.flatMap((child) => isContainer(child) ? unwrapContainer(child) : [child]);
+    const refitted = { ...container, child_blocks };
+    return child_blocks.length === 0 ||
+        child_blocks.length > SLACK_LIMITS.containerChildBlocks
+        ? unwrapContainer(refitted, level)
+        : [refitted];
+};
+/**
+ * A titled section as one Block Kit `container`, from its title and the
+ * blocks its body rendered to, typically through `scope.renderSlack`.
+ *
+ * A nested container among `children` is unwrapped to its title and blocks.
+ * With no children, or more than `SLACK_LIMITS.containerChildBlocks`, the
+ * section falls back to a `header` at `fallbackLevel` followed by the blocks.
+ */
+export const slackContainer = (title, children, { fallbackLevel, ...fields } = {}) => containerWithChildren({
+    type: 'container',
+    title: { type: 'plain_text', text: formatHeaderText(title), emoji: true },
+    ...fields,
+    child_blocks: [],
+}, children, fallbackLevel);
+//# sourceMappingURL=container.js.map

package/dist/render/slack/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../src/render/slack/container.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,GAKb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAgBpD,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAgC,EAAE,CAC7E,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAE9D,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAuB,EACvE,KAAwB,EACI,EAAE,CAAC;IAC/B,GAAG,CAAC,eAAe;QACjB,CAAC,CAAC,CAAC,eAAe,CAAC;QACnB,CAAC,CAAC,KAAK;YACL,CAAC,CAAC;gBACE;oBACE,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE,KAAK;oBACX,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;iBAC1C;aACF;YACH,CAAC,CAAC,EAAE,CAAC;IACT,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,GAAG,YAAY;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,SAA8B,EAC9B,QAA+B,EAC/B,KAAwB,EACV,EAAE;IAChB,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9C,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CACtD,CAAC;IACF,MAAM,QAAQ,GAAG,EAAE,GAAG,SAAS,EAAE,YAAY,EAAE,CAAC;IAChD,OAAO,YAAY,CAAC,MAAM,KAAK,CAAC;QAC9B,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC,oBAAoB;QACvD,CAAC,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC;QAClC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAa,EACb,QAA+B,EAC/B,EAAE,aAAa,EAAE,GAAG,MAAM,KAA4B,EAAE,EAC1C,EAAE,CAChB,qBAAqB,CACnB;IACE,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;IACzE,GAAG,MAAM;IACT,YAAY,EAAE,EAAE;CACjB,EACD,QAAQ,EACR,aAAa,CACd,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  SLACK_LIMITS,\n  type SlackBlock,\n  type SlackContainerBlock,\n  type SlackContainerChildBlock,\n  type SlackHeaderLevel,\n} from './blocks';\nimport { formatHeaderText } from './format';\nimport { isUnmodeledSlackBlock } from './unmodeled';\n\n/** Options for {@link slackContainer}: the container's optional fields, and the level of the `header` it falls back to. */\nexport type SlackContainerOptions = Partial<\n  Pick<\n    SlackContainerBlock,\n    | 'block_id'\n    | 'subtitle'\n    | 'icon'\n    | 'width'\n    | 'is_collapsible'\n    | 'default_collapsed'\n    | 'has_header_divider'\n  >\n> & { fallbackLevel?: SlackHeaderLevel };\n\n/** A container Isomer fits, as opposed to one passed through `unmodeledSlackBlock`. */\nexport const isContainer = (block: SlackBlock): block is SlackContainerBlock =>\n  block.type === 'container' && !isUnmodeledSlackBlock(block);\n\n/** A container as the blocks it holds, led by its title and subtitle. */\nexport const unwrapContainer = (\n  { title, rich_text_title, subtitle, child_blocks }: SlackContainerBlock,\n  level?: SlackHeaderLevel\n): SlackContainerChildBlock[] => [\n  ...(rich_text_title\n    ? [rich_text_title]\n    : title\n      ? [\n          {\n            type: 'header' as const,\n            text: title,\n            ...(level === undefined ? {} : { level }),\n          },\n        ]\n      : []),\n  ...(subtitle ? [{ type: 'context' as const, elements: [subtitle] }] : []),\n  ...child_blocks,\n];\n\n/**\n * `container` holding `children`, with any nested container unwrapped, since\n * Slack rejects one. A container left with no children, or more than\n * `containerChildBlocks`, is unwrapped itself.\n */\nexport const containerWithChildren = (\n  container: SlackContainerBlock,\n  children: readonly SlackBlock[],\n  level?: SlackHeaderLevel\n): SlackBlock[] => {\n  const child_blocks = children.flatMap((child) =>\n    isContainer(child) ? unwrapContainer(child) : [child]\n  );\n  const refitted = { ...container, child_blocks };\n  return child_blocks.length === 0 ||\n    child_blocks.length > SLACK_LIMITS.containerChildBlocks\n    ? unwrapContainer(refitted, level)\n    : [refitted];\n};\n\n/**\n * A titled section as one Block Kit `container`, from its title and the\n * blocks its body rendered to, typically through `scope.renderSlack`.\n *\n * A nested container among `children` is unwrapped to its title and blocks.\n * With no children, or more than `SLACK_LIMITS.containerChildBlocks`, the\n * section falls back to a `header` at `fallbackLevel` followed by the blocks.\n */\nexport const slackContainer = (\n  title: string,\n  children: readonly SlackBlock[],\n  { fallbackLevel, ...fields }: SlackContainerOptions = {}\n): SlackBlock[] =>\n  containerWithChildren(\n    {\n      type: 'container',\n      title: { type: 'plain_text', text: formatHeaderText(title), emoji: true },\n      ...fields,\n      child_blocks: [],\n    },\n    children,\n    fallbackLevel\n  );\n"]}

package/dist/render/slack/envelope.d.ts

@@ -3,6 +3,7 @@ import type { PrimitiveNode } from '../../define/primitive_module.js';
 import type { MarkdownEnvelopeDispatcher } from '../markdown/envelope.js';
 import { type SlackAssetCollector, type SlackAssetRequest } from './assets.js';
 import { type SlackBlock } from './blocks.js';
+import { type SlackLinkOptions } from './format.js';
 /**
  * Adds Block Kit to {@link MarkdownEnvelopeDispatcher}.
  *
@@ -14,10 +15,10 @@ import { type SlackBlock } from './blocks.js';
  */
 export interface SlackEnvelopeDispatcher<TNode extends PrimitiveNode> extends MarkdownEnvelopeDispatcher<TNode> {
     /** `collector` is absent unless the caller opted into asset collection, so a renderer must still degrade an image it cannot upload. */
-    renderSlack(node: TNode, collector?: SlackAssetCollector): readonly SlackBlock[];
+    renderSlack(node: TNode, collector?: SlackAssetCollector, options?: SlackLinkOptions): readonly SlackBlock[];
 }
 /** Options for {@link renderSlackEnvelope}. */
-export interface SlackEnvelopeOptions {
+export interface SlackEnvelopeOptions extends SlackLinkOptions {
     /** Renders the composition's title and subtitle, in the blocks and the fallback `text`. Defaults to `true`. Pass `false` when the host already shows the title, or the body opens with its own. */
     heading?: boolean;
     /** Fallback `text` summary shown in notifications and previews, as `mrkdwn`; defaults to the text render, escaped. */
@@ -45,8 +46,9 @@ export interface SlackEnvelopeResult {
  * fitted to Slack's limits — text is clamped, blocks past a count limit and
  * `rich_text` elements past a section's limit split, tables past a table limit
  * or the message's cell budget become rich text, spacers and then whole blocks
- * are dropped — so the output is always postable. `assets` stays empty
- * unless `collectAssets` is set.
+ * are dropped — so the output is always postable, except for a block from
+ * `unmodeledSlackBlock` or of a type Isomer does not model, which passes
+ * through unfitted. `assets` stays empty unless `collectAssets` is set.
  */
 export declare const renderSlackEnvelope: <TNode extends PrimitiveNode>(composition: Composition<TNode>, dispatcher: SlackEnvelopeDispatcher<TNode>, options?: SlackEnvelopeOptions) => SlackEnvelopeResult;
 //# sourceMappingURL=envelope.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/render/slack/envelope.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAGvE,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAGL,KAAK,UAAU,EAahB,MAAM,UAAU,CAAC;AAUlB;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB,CACtC,KAAK,SAAS,aAAa,CAC3B,SAAQ,0BAA0B,CAAC,KAAK,CAAC;IACzC,uIAAuI;IACvI,WAAW,CACT,IAAI,EAAE,KAAK,EACX,SAAS,CAAC,EAAE,mBAAmB,GAC9B,SAAS,UAAU,EAAE,CAAC;CAC1B;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,mMAAmM;IACnM,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sHAAsH;IACtH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8GAA8G;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,SAAS,aAAa,EAC7D,aAAa,WAAW,CAAC,KAAK,CAAC,EAC/B,YAAY,uBAAuB,CAAC,KAAK,CAAC,EAC1C,UAAS,oBAAyB,KACjC,mBA2CF,CAAC"}
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/render/slack/envelope.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAGvE,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAGL,KAAK,UAAU,EAchB,MAAM,UAAU,CAAC;AAElB,OAAO,EAQL,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAC;AAGlB;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB,CACtC,KAAK,SAAS,aAAa,CAC3B,SAAQ,0BAA0B,CAAC,KAAK,CAAC;IACzC,uIAAuI;IACvI,WAAW,CACT,IAAI,EAAE,KAAK,EACX,SAAS,CAAC,EAAE,mBAAmB,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACzB,SAAS,UAAU,EAAE,CAAC;CAC1B;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,mMAAmM;IACnM,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sHAAsH;IACtH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8GAA8G;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,SAAS,aAAa,EAC7D,aAAa,WAAW,CAAC,KAAK,CAAC,EAC/B,YAAY,uBAAuB,CAAC,KAAK,CAAC,EAC1C,UAAS,oBAAyB,KACjC,mBA+CF,CAAC"}