@elastic/isomer-sdk 0.1.0 → 0.3.0

package/dist/define/frame.js

@@ -13,16 +13,15 @@ export const bindFrame = (frame) => {
     const themeFor = (mode) => mode === 'dark' ? frame.theme.dark : frame.theme.light;
     return {
         defaultWidth: frame.defaultWidth,
-        sizesFromNodeHeights: frame.sizesFromNodeHeights ?? true,
         estimateHeight: (composition, dispatcher) => frame.estimateHeight(composition, dispatcher),
         validateBody: (body) => frame.validateBody?.(body) ?? [],
         resolveTheme: (mode) => themeFor(mode),
         render: (composition, viewport, dispatcher) => {
             const theme = themeFor(viewport.mode);
             const { title, subtitle, theme: mode } = composition;
-            return frame.wrap({ title, subtitle, theme: mode }, composition.body.map((node, index) => dispatcher.renderSvg(node, `body-${index}`)), { ...viewport, theme });
+            return frame.wrap({ title, subtitle, theme: mode }, composition.body.map((node, index) => dispatcher.renderSnapshot(node, `body-${index}`)), { ...viewport, theme });
         },
-        renderNode: (node, dispatcher) => dispatcher.renderSvg(node, node.type),
+        renderNode: (node, dispatcher) => dispatcher.renderSnapshot(node, node.type),
     };
 };
 //# sourceMappingURL=frame.js.map

package/dist/define/frame.js.map

@@ -1 +1 @@
-{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/define/frame.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyLH;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAS,KAAoB,EAAc,EAAE;IACpE,MAAM,QAAQ,GAAG,CAAC,IAA6B,EAAU,EAAE,CACzD,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;IACzD,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,IAAI,IAAI;QACxD,cAAc,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAC1C,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE,UAAU,CAAC;QAC/C,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE;QACxD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtC,MAAM,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC;YACrD,OAAO,KAAK,CAAC,IAAI,CACf,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAChC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,KAAK,EAAE,CAAC,CAC5C,EACD,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CACvB,CAAC;QACJ,CAAC;QACD,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;KACxE,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n// The frame an `svg` render is drawn inside, and the geometry that sizes it.\n// Frame is a runtime input, not a pack asset: vocabulary is additive, the\n// document is exclusive.\n\nimport type { ReactNode } from 'react';\n\nimport type { RenderTheme } from '../composition/named_color';\nimport type { PrimitiveNode } from '../composition/node';\n\n/**\n * A frame's palette, per mode. An image has no media queries, so it must\n * commit to one; `auto` resolves light.\n */\nexport interface ThemePair<TTheme> {\n  light: TTheme;\n  dark: TTheme;\n}\n\n/**\n * Geometry and resolved theme a frame draws within.\n *\n * Named for the viewport rather than the frame because {@link Frame.wrap}\n * draws *a* frame within it; the two would otherwise read as the same thing.\n */\nexport interface FrameViewport<TTheme> {\n  width: number;\n  height: number;\n  /** Resolved from {@link Frame.theme} for `mode`. */\n  theme: TTheme;\n  /** What the caller asked for, before resolution. `undefined` and `auto` both resolve light. */\n  mode: RenderTheme | undefined;\n}\n\n/**\n * The two dispatcher methods a frame needs.\n *\n * The render context the nodes are drawn with is bound by the caller rather\n * than passed here: it carries the class-name resolution that pairs with the\n * stylesheet emitted alongside the frame's output, which is the surface's\n * concern and not the document's. Generic in `TNode` so a helper can be\n * written against a narrowed node union while the runtime holds the erased form.\n */\nexport interface FrameDispatcher<TNode extends PrimitiveNode = PrimitiveNode> {\n  /** Draws one node on the `svg` surface. `key` must be unique among its siblings. */\n  renderSvg(node: TNode, key: string): ReactNode;\n  /** The node's height in pixels; `0` when it is hidden from `svg` or its primitive declares no `metrics.svgHeight`. */\n  estimateSvgHeight(node: TNode): number;\n}\n\n/**\n * What {@link Frame.wrap} is told about the composition it draws around.\n *\n * The body is withheld, and {@link bindFrame} copies only these fields into a\n * fresh value, so the surround cannot branch on a pack's node types.\n */\nexport interface FrameHeader {\n  title?: string | undefined;\n  subtitle?: string | undefined;\n  /** The caller's preference, not a resolved palette. Use {@link FrameViewport.theme} to draw. */\n  theme?: RenderTheme | undefined;\n}\n\n/** {@link FrameHeader} plus the body, for the sizing and validation hooks. */\nexport interface FrameComposition extends FrameHeader {\n  /** Raw nodes, for measuring and checking only. {@link FrameBody} is what gets drawn. */\n  body: PrimitiveNode[];\n}\n\n/**\n * Body nodes already rendered to elements, ready to be surrounded.\n *\n * Distinct from `Composition.body`, which is the raw {@link PrimitiveNode}\n * array a frame never sees.\n */\nexport type FrameBody = readonly ReactNode[];\n\n/**\n * A document an `svg` render can produce: its geometry, the surround it draws\n * around the body, and whatever it requires of a composition it is asked to\n * draw.\n *\n * A host registers frames with the runtime and picks one per render. That is\n * what lets one runtime serve a 760px card, a 1920x1080 slide, and a\n * host-branded variant of either from the same vocabulary — and what keeps a\n * vocabulary pack additive, since nothing about a primitive decides the frame.\n * A frame is named by the key a host registers it under, not by a field it\n * carries.\n */\nexport interface Frame<TTheme> {\n  /** Width used when the caller passes none. */\n  defaultWidth: number;\n  /**\n   * Whether {@link Frame.estimateHeight} sums per-node heights, and so\n   * under-sizes the frame for a node whose primitive declares no\n   * `metrics.svgHeight` — `dispatcher.estimateSvgHeight` returns `0` for those.\n   *\n   * Defaults to `true`, because the gap is silent and a frame that measures\n   * nodes is the normal case. A fixed-size frame sets `false` once and stops\n   * the missing `svgHeight` warning reporting a metric nothing reads.\n   */\n  sizesFromNodeHeights?: boolean;\n  /**\n   * Palette per mode. Frame and palette vary independently — a branded card is\n   * this geometry with a host's colors — so a host overrides one by spreading\n   * this value rather than rebuilding anything.\n   */\n  theme: ThemePair<TTheme>;\n  /**\n   * Height for this body when the caller passes none, in the geometry this\n   * document defines. See {@link Frame.sizesFromNodeHeights} for what it may\n   * assume of the nodes.\n   */\n  estimateHeight(\n    composition: FrameComposition,\n    dispatcher: FrameDispatcher\n  ): number;\n  /**\n   * What this document requires of a body. A slide document's\n   * exactly-one-`slideFrame` rule is the example.\n   *\n   * Returned rather than thrown so a caller can decide what to do with it, but\n   * note where it is *not* checked: composition validation is frame-agnostic,\n   * and has to be, because the same composition can be valid in one frame and\n   * not another. Only the `svg` surface consults this, on the frame a render\n   * actually names, and raises before drawing. A host that wants the answer\n   * earlier asks the frame directly.\n   */\n  validateBody?(body: readonly PrimitiveNode[]): readonly string[];\n  /**\n   * Draws the surround around the already-rendered body nodes, including a\n   * title header if this document wants one.\n   *\n   * Takes the nodes as an array rather than a single `ReactNode` so a frame\n   * that draws no surround can return its one root element — image layout\n   * starts from a single element, and an array or a fragment is not one.\n   *\n   * Declared property-style, so it is checked contravariantly in `TTheme` under\n   * `strictFunctionTypes`. A method signature is bivariant, which would admit a\n   * frame needing a richer theme into a slot typed for a narrower one, where it\n   * would read a token nothing supplies.\n   */\n  wrap: (\n    header: FrameHeader,\n    body: FrameBody,\n    viewport: FrameViewport<TTheme>\n  ) => ReactNode;\n}\n\n/**\n * A {@link Frame} as the runtime stores it, with its theme resolved away.\n *\n * The erasure is a closure rather than a type parameter because the runtime\n * dispatches nodes through one inventory keyed by node type, which has no\n * single theme to name. A runtime's frames are homogeneous in `TTheme`, so the\n * palette is known where it is resolved and only the resolved result is stored.\n */\nexport interface BoundFrame {\n  readonly defaultWidth: number;\n  /** See {@link Frame.sizesFromNodeHeights}; defaulted at binding. */\n  readonly sizesFromNodeHeights: boolean;\n  /** See {@link Frame.estimateHeight}. */\n  estimateHeight(\n    composition: FrameComposition,\n    dispatcher: FrameDispatcher\n  ): number;\n  /** See {@link Frame.validateBody}; empty when this frame states no rule. */\n  validateBody(body: readonly PrimitiveNode[]): readonly string[];\n  /**\n   * Resolves {@link Frame.theme} for `mode`, erased to `unknown` like the rest\n   * of this type. Lets a caller hand the palette to a primitive's `env.theme`\n   * without itself knowing `TTheme`.\n   */\n  resolveTheme(mode: RenderTheme | undefined): unknown;\n  /** Renders the body and its surround at `viewport`'s geometry. */\n  render(\n    composition: FrameComposition,\n    viewport: { width: number; height: number; mode: RenderTheme | undefined },\n    dispatcher: FrameDispatcher\n  ): ReactNode;\n  /** One node, no surround. */\n  renderNode(node: PrimitiveNode, dispatcher: FrameDispatcher): ReactNode;\n}\n\n/**\n * Erases a {@link Frame}'s `TTheme` into a {@link BoundFrame}, resolving the\n * palette per render and composing the generic body walk with the frame's own\n * surround.\n */\nexport const bindFrame = <TTheme>(frame: Frame<TTheme>): BoundFrame => {\n  const themeFor = (mode: RenderTheme | undefined): TTheme =>\n    mode === 'dark' ? frame.theme.dark : frame.theme.light;\n  return {\n    defaultWidth: frame.defaultWidth,\n    sizesFromNodeHeights: frame.sizesFromNodeHeights ?? true,\n    estimateHeight: (composition, dispatcher) =>\n      frame.estimateHeight(composition, dispatcher),\n    validateBody: (body) => frame.validateBody?.(body) ?? [],\n    resolveTheme: (mode) => themeFor(mode),\n    render: (composition, viewport, dispatcher) => {\n      const theme = themeFor(viewport.mode);\n      const { title, subtitle, theme: mode } = composition;\n      return frame.wrap(\n        { title, subtitle, theme: mode },\n        composition.body.map((node, index) =>\n          dispatcher.renderSvg(node, `body-${index}`)\n        ),\n        { ...viewport, theme }\n      );\n    },\n    renderNode: (node, dispatcher) => dispatcher.renderSvg(node, node.type),\n  };\n};\n"]}
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/define/frame.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8KH;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAS,KAAoB,EAAc,EAAE;IACpE,MAAM,QAAQ,GAAG,CAAC,IAA6B,EAAU,EAAE,CACzD,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;IACzD,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,cAAc,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAC1C,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE,UAAU,CAAC;QAC/C,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE;QACxD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtC,MAAM,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC;YACrD,OAAO,KAAK,CAAC,IAAI,CACf,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAChC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnC,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,KAAK,EAAE,CAAC,CACjD,EACD,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CACvB,CAAC;QACJ,CAAC;QACD,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAC/B,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;KAC7C,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n// The frame a `snapshot` render is drawn inside, and the geometry that sizes it.\n// Frame is a runtime input, not a pack asset: vocabulary is additive, the\n// document is exclusive.\n\nimport type { ReactNode } from 'react';\n\nimport type { RenderTheme } from '../composition/named_color';\nimport type { PrimitiveNode } from '../composition/node';\n\n/**\n * A frame's palette, per mode. An image has no media queries, so it must\n * commit to one; `auto` resolves light.\n */\nexport interface ThemePair<TTheme> {\n  light: TTheme;\n  dark: TTheme;\n}\n\n/**\n * Geometry and resolved theme a frame draws within.\n *\n * Named for the viewport rather than the frame because {@link Frame.wrap}\n * draws *a* frame within it; the two would otherwise read as the same thing.\n */\nexport interface FrameViewport<TTheme> {\n  width: number;\n  height: number;\n  /** Resolved from {@link Frame.theme} for `mode`. */\n  theme: TTheme;\n  /** What the caller asked for, before resolution. `undefined` and `auto` both resolve light. */\n  mode: RenderTheme | undefined;\n}\n\n/**\n * The two dispatcher methods a frame needs.\n *\n * The render context the nodes are drawn with is bound by the caller rather\n * than passed here: it carries the class-name resolution that pairs with the\n * stylesheet emitted alongside the frame's output, which is the surface's\n * concern and not the document's. Generic in `TNode` so a helper can be\n * written against a narrowed node union while the runtime holds the erased form.\n */\nexport interface FrameDispatcher<TNode extends PrimitiveNode = PrimitiveNode> {\n  /** Draws one node on the `snapshot` surface. `key` must be unique among its siblings. */\n  renderSnapshot(node: TNode, key: string): ReactNode;\n  /** The node's height in pixels; `0` when it is hidden from `snapshot` or its primitive declares no `metrics.snapshotHeight`. */\n  estimateSnapshotHeight(node: TNode): number;\n}\n\n/**\n * What {@link Frame.wrap} is told about the composition it draws around.\n *\n * The body is withheld, and {@link bindFrame} copies only these fields into a\n * fresh value, so the surround cannot branch on a pack's node types.\n */\nexport interface FrameHeader {\n  title?: string | undefined;\n  subtitle?: string | undefined;\n  /** The caller's preference, not a resolved palette. Use {@link FrameViewport.theme} to draw. */\n  theme?: RenderTheme | undefined;\n}\n\n/** {@link FrameHeader} plus the body, for the sizing and validation hooks. */\nexport interface FrameComposition extends FrameHeader {\n  /** Raw nodes, for measuring and checking only. {@link FrameBody} is what gets drawn. */\n  body: PrimitiveNode[];\n}\n\n/**\n * Body nodes already rendered to elements, ready to be surrounded.\n *\n * Distinct from `Composition.body`, which is the raw {@link PrimitiveNode}\n * array a frame never sees.\n */\nexport type FrameBody = readonly ReactNode[];\n\n/**\n * A document a `snapshot` render can produce: its geometry, the surround it draws\n * around the body, and whatever it requires of a composition it is asked to\n * draw.\n *\n * A host registers frames with the runtime and picks one per render. That is\n * what lets one runtime serve a 760px card, a 1920x1080 slide, and a\n * host-branded variant of either from the same vocabulary — and what keeps a\n * vocabulary pack additive, since nothing about a primitive decides the frame.\n * A frame is named by the key a host registers it under, not by a field it\n * carries.\n */\nexport interface Frame<TTheme> {\n  /** Width used when the caller passes none. */\n  defaultWidth: number;\n  /**\n   * Palette per mode. Frame and palette vary independently — a branded card is\n   * this geometry with a host's colors — so a host overrides one by spreading\n   * this value rather than rebuilding anything.\n   */\n  theme: ThemePair<TTheme>;\n  /**\n   * Height for this body when the caller passes none, in the geometry this\n   * document defines. Calling {@link FrameDispatcher.estimateSnapshotHeight} is\n   * what makes a missing `metrics.snapshotHeight` size the frame short: that\n   * method returns `0` for a node whose primitive declares none.\n   */\n  estimateHeight(\n    composition: FrameComposition,\n    dispatcher: FrameDispatcher\n  ): number;\n  /**\n   * What this document requires of a body. A slide document's\n   * exactly-one-`slideFrame` rule is the example.\n   *\n   * Returned rather than thrown so a caller can decide what to do with it, but\n   * note where it is *not* checked: composition validation is frame-agnostic,\n   * and has to be, because the same composition can be valid in one frame and\n   * not another. Only the `snapshot` surface consults this, on the frame a render\n   * actually names, and raises before drawing. A host that wants the answer\n   * earlier asks the frame directly.\n   */\n  validateBody?(body: readonly PrimitiveNode[]): readonly string[];\n  /**\n   * Draws the surround around the already-rendered body nodes, including a\n   * title header if this document wants one.\n   *\n   * Takes the nodes as an array rather than a single `ReactNode` so a frame\n   * that draws no surround can return its one root element — image layout\n   * starts from a single element, and an array or a fragment is not one.\n   *\n   * Declared property-style, so it is checked contravariantly in `TTheme` under\n   * `strictFunctionTypes`. A method signature is bivariant, which would admit a\n   * frame needing a richer theme into a slot typed for a narrower one, where it\n   * would read a token nothing supplies.\n   */\n  wrap: (\n    header: FrameHeader,\n    body: FrameBody,\n    viewport: FrameViewport<TTheme>\n  ) => ReactNode;\n}\n\n/**\n * A {@link Frame} as the runtime stores it, with its theme resolved away.\n *\n * The erasure is a closure rather than a type parameter because the runtime\n * dispatches nodes through one inventory keyed by node type, which has no\n * single theme to name. A runtime's frames are homogeneous in `TTheme`, so the\n * palette is known where it is resolved and only the resolved result is stored.\n */\nexport interface BoundFrame {\n  readonly defaultWidth: number;\n  /** See {@link Frame.estimateHeight}. */\n  estimateHeight(\n    composition: FrameComposition,\n    dispatcher: FrameDispatcher\n  ): number;\n  /** See {@link Frame.validateBody}; empty when this frame states no rule. */\n  validateBody(body: readonly PrimitiveNode[]): readonly string[];\n  /**\n   * Resolves {@link Frame.theme} for `mode`, erased to `unknown` like the rest\n   * of this type. Lets a caller hand the palette to a primitive's `env.theme`\n   * without itself knowing `TTheme`.\n   */\n  resolveTheme(mode: RenderTheme | undefined): unknown;\n  /** Renders the body and its surround at `viewport`'s geometry. */\n  render(\n    composition: FrameComposition,\n    viewport: { width: number; height: number; mode: RenderTheme | undefined },\n    dispatcher: FrameDispatcher\n  ): ReactNode;\n  /** One node, no surround. */\n  renderNode(node: PrimitiveNode, dispatcher: FrameDispatcher): ReactNode;\n}\n\n/**\n * Erases a {@link Frame}'s `TTheme` into a {@link BoundFrame}, resolving the\n * palette per render and composing the generic body walk with the frame's own\n * surround.\n */\nexport const bindFrame = <TTheme>(frame: Frame<TTheme>): BoundFrame => {\n  const themeFor = (mode: RenderTheme | undefined): TTheme =>\n    mode === 'dark' ? frame.theme.dark : frame.theme.light;\n  return {\n    defaultWidth: frame.defaultWidth,\n    estimateHeight: (composition, dispatcher) =>\n      frame.estimateHeight(composition, dispatcher),\n    validateBody: (body) => frame.validateBody?.(body) ?? [],\n    resolveTheme: (mode) => themeFor(mode),\n    render: (composition, viewport, dispatcher) => {\n      const theme = themeFor(viewport.mode);\n      const { title, subtitle, theme: mode } = composition;\n      return frame.wrap(\n        { title, subtitle, theme: mode },\n        composition.body.map((node, index) =>\n          dispatcher.renderSnapshot(node, `body-${index}`)\n        ),\n        { ...viewport, theme }\n      );\n    },\n    renderNode: (node, dispatcher) =>\n      dispatcher.renderSnapshot(node, node.type),\n  };\n};\n"]}

package/dist/define/index.d.ts

@@ -1,6 +1,8 @@
 export { type BoundFrame, type Frame, type FrameBody, type FrameComposition, type FrameDispatcher, type FrameHeader, type FrameViewport, type ThemePair, bindFrame, } from './frame.js';
 export { type MarkdownBlock, type MarkdownContent, type MarkdownInline, type MarkdownInlineInput, } from './markdown_content.js';
-export { type AnyPrimitiveDefinition, type DefaultPackTypes, type OptionalSurface, type PackTypes, type PrimitiveCatalogEntry, type PrimitiveChildRef, type PrimitiveDefinition, type PrimitiveMetrics, type PrimitiveNode, type PrimitiveRenderContext, type PrimitiveSchema, type PrimitiveStyleCollectionContext, type PrimitiveStyleCollector, type ReactContextArg, type Renderer, type Renderers, type RenderScope, type StyledRenderContext, type StyleHandle, type SurfaceMap, type ThemeTokenPath, type WithNodeFields, bodyNodeIdSchema, bodyNodeSurfacesSchema, definePrimitive, definePrimitiveFor, unresolvedBodyNodeSchema, validateWithSchema, } from './primitive_module.js';
+export { type ExampleNode, type NormalizedPrimitiveExample, type PrimitiveExample, exampleNodes, primitiveExamples, } from './primitive_example.js';
+export { type PrimitiveIcon, ICON_VARS } from './primitive_icon.js';
+export { type AnyPrimitiveDefinition, type DefaultPackTypes, type OptionalSurface, type PackTypes, type PrimitiveCatalogEntry, type PrimitiveChildRef, type PrimitiveDefinition, type PrimitiveMetrics, type PrimitiveNode, type PrimitiveRenderContext, type PrimitiveSchema, type PrimitiveStyleCollectionContext, type PrimitiveStyleCollector, type ReactContextArg, type Renderer, type Renderers, type RenderScope, type StyledRenderContext, type StyleHandle, type SurfaceMap, type ThemeTokenPath, type WithNodeFields, OPTIONAL_SURFACES, bodyNodeIdSchema, bodyNodeSurfacesSchema, definePrimitive, definePrimitiveFor, unresolvedBodyNodeSchema, validateWithSchema, } from './primitive_module.js';
 export { type SlackAssetCollector, type SlackAssetRequest, } from './slack_assets.js';
 export { type SlackActionElement, type SlackActionsBlock, type SlackBlock, type SlackButtonElement, type SlackCheckboxesElement, type SlackContextBlock, type SlackDividerBlock, type SlackFileReference, type SlackHeaderBlock, type SlackHeaderLevel, type SlackImageBlock, type SlackImageElement, type SlackMrkdwnTextObject, type SlackMultiStaticSelectElement, type SlackOptionGroup, type SlackOptionObject, type SlackOverflowElement, type SlackPlainTextObject, type SlackRadioButtonsElement, type SlackRawTextElement, type SlackRichTextBlock, type SlackRichTextBlockElement, type SlackRichTextInline, type SlackRichTextLink, type SlackRichTextList, type SlackRichTextPreformatted, type SlackRichTextQuote, type SlackRichTextSection, type SlackRichTextStyle, type SlackRichTextTag, type SlackRichTextText, type SlackSectionAccessory, type SlackSectionBlock, type SlackStaticSelectElement, type SlackTableBlock, type SlackTableCell, type SlackTableColumnSetting, type SlackTagColor, type SlackTextObject, type SlackVideoBlock, } from './slack_blocks.js';
 export { declaredFieldsNote, formatZodIssues } from './zod_format.js';

package/dist/define/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,YAAY,EACZ,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC"}

package/dist/define/index.js

@@ -5,7 +5,9 @@
  * 2.0.
  */
 export { bindFrame, } from './frame.js';
-export { bodyNodeIdSchema, bodyNodeSurfacesSchema, definePrimitive, definePrimitiveFor, unresolvedBodyNodeSchema, validateWithSchema, } from './primitive_module.js';
+export { exampleNodes, primitiveExamples, } from './primitive_example.js';
+export { ICON_VARS } from './primitive_icon.js';
+export { OPTIONAL_SURFACES, bodyNodeIdSchema, bodyNodeSurfacesSchema, definePrimitive, definePrimitiveFor, unresolvedBodyNodeSchema, validateWithSchema, } from './primitive_module.js';
 export { declaredFieldsNote, formatZodIssues } from './zod_format.js';
 export { requiredString, z } from './zod_helpers.js';
 //# sourceMappingURL=index.js.map

package/dist/define/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EASL,SAAS,GACV,MAAM,SAAS,CAAC;AAOjB,OAAO,EAuBL,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AA+C5B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,eAAe,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 BoundFrame,\n  type Frame,\n  type FrameBody,\n  type FrameComposition,\n  type FrameDispatcher,\n  type FrameHeader,\n  type FrameViewport,\n  type ThemePair,\n  bindFrame,\n} from './frame';\nexport {\n  type MarkdownBlock,\n  type MarkdownContent,\n  type MarkdownInline,\n  type MarkdownInlineInput,\n} from './markdown_content';\nexport {\n  type AnyPrimitiveDefinition,\n  type DefaultPackTypes,\n  type OptionalSurface,\n  type PackTypes,\n  type PrimitiveCatalogEntry,\n  type PrimitiveChildRef,\n  type PrimitiveDefinition,\n  type PrimitiveMetrics,\n  type PrimitiveNode,\n  type PrimitiveRenderContext,\n  type PrimitiveSchema,\n  type PrimitiveStyleCollectionContext,\n  type PrimitiveStyleCollector,\n  type ReactContextArg,\n  type Renderer,\n  type Renderers,\n  type RenderScope,\n  type StyledRenderContext,\n  type StyleHandle,\n  type SurfaceMap,\n  type ThemeTokenPath,\n  type WithNodeFields,\n  bodyNodeIdSchema,\n  bodyNodeSurfacesSchema,\n  definePrimitive,\n  definePrimitiveFor,\n  unresolvedBodyNodeSchema,\n  validateWithSchema,\n} from './primitive_module';\nexport {\n  type SlackAssetCollector,\n  type SlackAssetRequest,\n} from './slack_assets';\nexport {\n  type SlackActionElement,\n  type SlackActionsBlock,\n  type SlackBlock,\n  type SlackButtonElement,\n  type SlackCheckboxesElement,\n  type SlackContextBlock,\n  type SlackDividerBlock,\n  type SlackFileReference,\n  type SlackHeaderBlock,\n  type SlackHeaderLevel,\n  type SlackImageBlock,\n  type SlackImageElement,\n  type SlackMrkdwnTextObject,\n  type SlackMultiStaticSelectElement,\n  type SlackOptionGroup,\n  type SlackOptionObject,\n  type SlackOverflowElement,\n  type SlackPlainTextObject,\n  type SlackRadioButtonsElement,\n  type SlackRawTextElement,\n  type SlackRichTextBlock,\n  type SlackRichTextBlockElement,\n  type SlackRichTextInline,\n  type SlackRichTextLink,\n  type SlackRichTextList,\n  type SlackRichTextPreformatted,\n  type SlackRichTextQuote,\n  type SlackRichTextSection,\n  type SlackRichTextStyle,\n  type SlackRichTextTag,\n  type SlackRichTextText,\n  type SlackSectionAccessory,\n  type SlackSectionBlock,\n  type SlackStaticSelectElement,\n  type SlackTableBlock,\n  type SlackTableCell,\n  type SlackTableColumnSetting,\n  type SlackTagColor,\n  type SlackTextObject,\n  type SlackVideoBlock,\n} from './slack_blocks';\nexport { declaredFieldsNote, formatZodIssues } from './zod_format';\nexport { requiredString, z } from './zod_helpers';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EASL,SAAS,GACV,MAAM,SAAS,CAAC;AAOjB,OAAO,EAIL,YAAY,EACZ,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAsB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAuBL,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AA+C5B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,eAAe,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 BoundFrame,\n  type Frame,\n  type FrameBody,\n  type FrameComposition,\n  type FrameDispatcher,\n  type FrameHeader,\n  type FrameViewport,\n  type ThemePair,\n  bindFrame,\n} from './frame';\nexport {\n  type MarkdownBlock,\n  type MarkdownContent,\n  type MarkdownInline,\n  type MarkdownInlineInput,\n} from './markdown_content';\nexport {\n  type ExampleNode,\n  type NormalizedPrimitiveExample,\n  type PrimitiveExample,\n  exampleNodes,\n  primitiveExamples,\n} from './primitive_example';\nexport { type PrimitiveIcon, ICON_VARS } from './primitive_icon';\nexport {\n  type AnyPrimitiveDefinition,\n  type DefaultPackTypes,\n  type OptionalSurface,\n  type PackTypes,\n  type PrimitiveCatalogEntry,\n  type PrimitiveChildRef,\n  type PrimitiveDefinition,\n  type PrimitiveMetrics,\n  type PrimitiveNode,\n  type PrimitiveRenderContext,\n  type PrimitiveSchema,\n  type PrimitiveStyleCollectionContext,\n  type PrimitiveStyleCollector,\n  type ReactContextArg,\n  type Renderer,\n  type Renderers,\n  type RenderScope,\n  type StyledRenderContext,\n  type StyleHandle,\n  type SurfaceMap,\n  type ThemeTokenPath,\n  type WithNodeFields,\n  OPTIONAL_SURFACES,\n  bodyNodeIdSchema,\n  bodyNodeSurfacesSchema,\n  definePrimitive,\n  definePrimitiveFor,\n  unresolvedBodyNodeSchema,\n  validateWithSchema,\n} from './primitive_module';\nexport {\n  type SlackAssetCollector,\n  type SlackAssetRequest,\n} from './slack_assets';\nexport {\n  type SlackActionElement,\n  type SlackActionsBlock,\n  type SlackBlock,\n  type SlackButtonElement,\n  type SlackCheckboxesElement,\n  type SlackContextBlock,\n  type SlackDividerBlock,\n  type SlackFileReference,\n  type SlackHeaderBlock,\n  type SlackHeaderLevel,\n  type SlackImageBlock,\n  type SlackImageElement,\n  type SlackMrkdwnTextObject,\n  type SlackMultiStaticSelectElement,\n  type SlackOptionGroup,\n  type SlackOptionObject,\n  type SlackOverflowElement,\n  type SlackPlainTextObject,\n  type SlackRadioButtonsElement,\n  type SlackRawTextElement,\n  type SlackRichTextBlock,\n  type SlackRichTextBlockElement,\n  type SlackRichTextInline,\n  type SlackRichTextLink,\n  type SlackRichTextList,\n  type SlackRichTextPreformatted,\n  type SlackRichTextQuote,\n  type SlackRichTextSection,\n  type SlackRichTextStyle,\n  type SlackRichTextTag,\n  type SlackRichTextText,\n  type SlackSectionAccessory,\n  type SlackSectionBlock,\n  type SlackStaticSelectElement,\n  type SlackTableBlock,\n  type SlackTableCell,\n  type SlackTableColumnSetting,\n  type SlackTagColor,\n  type SlackTextObject,\n  type SlackVideoBlock,\n} from './slack_blocks';\nexport { declaredFieldsNote, formatZodIssues } from './zod_format';\nexport { requiredString, z } from './zod_helpers';\n"]}

package/dist/define/primitive_example.d.ts

@@ -0,0 +1,30 @@
+import type { PrimitiveNode } from '../composition/node.js';
+/** A published example with a name hosts can list it by. */
+export interface PrimitiveExample<TNode extends PrimitiveNode = PrimitiveNode> {
+    /** Short and unique within the primitive, such as `Warning tone`. */
+    name: string;
+    /** What the example demonstrates. */
+    description?: string;
+    node: TNode;
+    /** Never set: an entry is a bare node exactly when it has a `type`. */
+    type?: never;
+}
+/** An entry of `examples` read as one shape; `name` is absent for a bare node. */
+export interface NormalizedPrimitiveExample<TNode extends PrimitiveNode = PrimitiveNode> {
+    name?: string;
+    description?: string;
+    node: TNode;
+}
+/** The node type an `examples` entry holds. */
+export type ExampleNode<TEntry> = TEntry extends PrimitiveExample<infer TNode> ? TNode : TEntry;
+interface WithExamples {
+    readonly examples: readonly (PrimitiveNode | PrimitiveExample)[];
+}
+/** Distributes over a union of definitions, so a mixed registry keeps every node type. */
+type NodeOf<TDefinition extends WithExamples> = ExampleNode<TDefinition['examples'][number]>;
+/** A definition's examples, bare or named, as {@link NormalizedPrimitiveExample}s. */
+export declare const primitiveExamples: <TDefinition extends WithExamples>({ examples, }: TDefinition) => NormalizedPrimitiveExample<NodeOf<TDefinition>>[];
+/** A definition's example nodes, without names. */
+export declare const exampleNodes: <TDefinition extends WithExamples>({ examples, }: TDefinition) => NodeOf<TDefinition>[];
+export {};
+//# sourceMappingURL=primitive_example.d.ts.map

package/dist/define/primitive_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive_example.d.ts","sourceRoot":"","sources":["../../src/define/primitive_example.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,aAAa,GAAG,aAAa;IAC3E,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,KAAK,CAAC;IACZ,uEAAuE;IACvE,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,0BAA0B,CACzC,KAAK,SAAS,aAAa,GAAG,aAAa;IAE3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,KAAK,CAAC;CACb;AAED,+CAA+C;AAC/C,MAAM,MAAM,WAAW,CAAC,MAAM,IAC5B,MAAM,SAAS,gBAAgB,CAAC,MAAM,KAAK,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhE,UAAU,YAAY;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,CAAC;CAClE;AAED,0FAA0F;AAC1F,KAAK,MAAM,CAAC,WAAW,SAAS,YAAY,IAAI,WAAW,CACzD,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAChC,CAAC;AAkBF,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,GAAI,WAAW,SAAS,YAAY,EAAE,eAEjE,WAAW,KAAG,0BAA0B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EACc,CAAC;AAE/E,mDAAmD;AACnD,eAAO,MAAM,YAAY,GAAI,WAAW,SAAS,YAAY,EAAE,eAE5D,WAAW,KAAG,MAAM,CAAC,WAAW,CAAC,EACqC,CAAC"}

package/dist/define/primitive_example.js

@@ -0,0 +1,21 @@
+/*
+ * 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 isPrimitiveExample = (entry) => !('type' in entry) && 'node' in entry;
+const normalize = (entry) => {
+    if (!isPrimitiveExample(entry)) {
+        return { node: entry };
+    }
+    const { name, description, node } = entry;
+    return description === undefined
+        ? { name, node }
+        : { name, description, node };
+};
+/** A definition's examples, bare or named, as {@link NormalizedPrimitiveExample}s. */
+export const primitiveExamples = ({ examples, }) => examples.map(normalize);
+/** A definition's example nodes, without names. */
+export const exampleNodes = ({ examples, }) => examples.map((entry) => normalize(entry).node);
+//# sourceMappingURL=primitive_example.js.map

package/dist/define/primitive_example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive_example.js","sourceRoot":"","sources":["../../src/define/primitive_example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqCH,MAAM,kBAAkB,GAAG,CACzB,KAAuC,EACZ,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,MAAM,IAAI,KAAK,CAAC;AAEtE,MAAM,SAAS,GAAG,CAChB,KAAuC,EACX,EAAE;IAC9B,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC1C,OAAO,WAAW,KAAK,SAAS;QAC9B,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;QAChB,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAmC,EAClE,QAAQ,GACI,EAAqD,EAAE,CACnE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAsD,CAAC;AAE/E,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAmC,EAC7D,QAAQ,GACI,EAAyB,EAAE,CACvC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAA0B,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 type { PrimitiveNode } from '../composition/node';\n\n/** A published example with a name hosts can list it by. */\nexport interface PrimitiveExample<TNode extends PrimitiveNode = PrimitiveNode> {\n  /** Short and unique within the primitive, such as `Warning tone`. */\n  name: string;\n  /** What the example demonstrates. */\n  description?: string;\n  node: TNode;\n  /** Never set: an entry is a bare node exactly when it has a `type`. */\n  type?: never;\n}\n\n/** An entry of `examples` read as one shape; `name` is absent for a bare node. */\nexport interface NormalizedPrimitiveExample<\n  TNode extends PrimitiveNode = PrimitiveNode,\n> {\n  name?: string;\n  description?: string;\n  node: TNode;\n}\n\n/** The node type an `examples` entry holds. */\nexport type ExampleNode<TEntry> =\n  TEntry extends PrimitiveExample<infer TNode> ? TNode : TEntry;\n\ninterface WithExamples {\n  readonly examples: readonly (PrimitiveNode | PrimitiveExample)[];\n}\n\n/** Distributes over a union of definitions, so a mixed registry keeps every node type. */\ntype NodeOf<TDefinition extends WithExamples> = ExampleNode<\n  TDefinition['examples'][number]\n>;\n\nconst isPrimitiveExample = (\n  entry: PrimitiveNode | PrimitiveExample\n): entry is PrimitiveExample => !('type' in entry) && 'node' in entry;\n\nconst normalize = (\n  entry: PrimitiveNode | PrimitiveExample\n): NormalizedPrimitiveExample => {\n  if (!isPrimitiveExample(entry)) {\n    return { node: entry };\n  }\n  const { name, description, node } = entry;\n  return description === undefined\n    ? { name, node }\n    : { name, description, node };\n};\n\n/** A definition's examples, bare or named, as {@link NormalizedPrimitiveExample}s. */\nexport const primitiveExamples = <TDefinition extends WithExamples>({\n  examples,\n}: TDefinition): NormalizedPrimitiveExample<NodeOf<TDefinition>>[] =>\n  examples.map(normalize) as NormalizedPrimitiveExample<NodeOf<TDefinition>>[];\n\n/** A definition's example nodes, without names. */\nexport const exampleNodes = <TDefinition extends WithExamples>({\n  examples,\n}: TDefinition): NodeOf<TDefinition>[] =>\n  examples.map((entry) => normalize(entry).node) as NodeOf<TDefinition>[];\n"]}

package/dist/define/primitive_icon.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A 16×16 glyph a host shows beside the primitive: static SVG, inlinable without a renderer.
+ *
+ * Colours go through {@link ICON_VARS}, optionally with a `currentColor` or hex fallback; `assertPackIconsValid` from `./testing` enforces the rules.
+ */
+export interface PrimitiveIcon {
+    svg: string;
+}
+/** The colour slots an icon may paint with, which a host sets per theme and mode. */
+export declare const ICON_VARS: readonly ["--isomer-icon-accent", "--isomer-icon-bg", "--isomer-icon-fg", "--isomer-icon-muted"];
+//# sourceMappingURL=primitive_icon.d.ts.map

package/dist/define/primitive_icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive_icon.d.ts","sourceRoot":"","sources":["../../src/define/primitive_icon.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qFAAqF;AACrF,eAAO,MAAM,SAAS,kGAKZ,CAAC"}

package/dist/define/primitive_icon.js

@@ -0,0 +1,14 @@
+/*
+ * 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.
+ */
+/** The colour slots an icon may paint with, which a host sets per theme and mode. */
+export const ICON_VARS = [
+    '--isomer-icon-accent',
+    '--isomer-icon-bg',
+    '--isomer-icon-fg',
+    '--isomer-icon-muted',
+];
+//# sourceMappingURL=primitive_icon.js.map

package/dist/define/primitive_icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive_icon.js","sourceRoot":"","sources":["../../src/define/primitive_icon.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,qFAAqF;AACrF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,sBAAsB;IACtB,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;CACb,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n/**\n * A 16×16 glyph a host shows beside the primitive: static SVG, inlinable without a renderer.\n *\n * Colours go through {@link ICON_VARS}, optionally with a `currentColor` or hex fallback; `assertPackIconsValid` from `./testing` enforces the rules.\n */\nexport interface PrimitiveIcon {\n  svg: string;\n}\n\n/** The colour slots an icon may paint with, which a host sets per theme and mode. */\nexport const ICON_VARS = [\n  '--isomer-icon-accent',\n  '--isomer-icon-bg',\n  '--isomer-icon-fg',\n  '--isomer-icon-muted',\n] as const;\n"]}

package/dist/define/primitive_module.d.ts

@@ -5,6 +5,8 @@ import { type ChildNodeRef, type SurfaceName } from '../composition/body_node_ba
 import type { PrimitiveNode } from '../composition/node.js';
 import type { ValidationError } from '../composition/validation_error.js';
 import type { MarkdownContent } from './markdown_content.js';
+import type { PrimitiveExample } from './primitive_example.js';
+import type { PrimitiveIcon } from './primitive_icon.js';
 import type { SlackAssetCollector } from './slack_assets.js';
 import type { SlackBlock } from './slack_blocks.js';
 export type { PrimitiveNode };
@@ -12,10 +14,20 @@ export type { PrimitiveNode };
  * A primitive's entry in the catalog the authoring prompt is built from.
  *
  * Written for the model rather than for a developer: `useWhen` and `avoidWhen`
- * are what steer it away from reaching for the wrong primitive.
+ * are what steer it away from reaching for the wrong primitive. `name` is the
+ * one host-facing field, and the prompt never prints it.
  */
 export interface PrimitiveCatalogEntry {
     type: string;
+    /** Short name a host shows for the primitive, e.g. `Stat group`. Absent means the host derives one from `type`. */
+    name?: string;
+    /**
+     * Description of this primitive's `$def` in the authoring JSON Schema.
+     *
+     * `z.toJSONSchema` drops refinements, so a cross-field rule is restated here.
+     * {@link definePrimitive} copies `schema.description` when this is omitted.
+     */
+    description?: string;
     /** One line on what the primitive is for, in the model's voice. */
     purpose: string;
     /** Situations that call for this primitive. Phrase each as a user intent, not a shape. */
@@ -53,7 +65,7 @@ export interface PrimitiveRenderContext {
      * still answer the question on its own. See `docs/rendering.md`.
      */
     enhancements?: ReadonlySet<string>;
-    /** Turns on `nodeAnchor` outside an HTML surface render, on the React and `svg` surfaces; inside one, the surface decides. */
+    /** Turns on `nodeAnchor` outside an HTML surface render, on the React and `snapshot` surfaces; inside one, the surface decides. */
     anchors?: boolean;
     /** Raises an interaction for the host to route. Absent means render non-interactively. */
     onEvent?: (event: ActionEventRef) => void;
@@ -127,9 +139,9 @@ export interface SurfaceMap<T extends PackTypes = DefaultPackTypes> {
             scope: RenderScope<T>;
             /**
              * The frame's resolved palette, when this render is reached through the
-             * `svg` surface. A bare `react`/`html` render has no {@link Frame} to
+             * `snapshot` surface. A bare `react`/`html` render has no {@link Frame} to
              * resolve one from, so it is absent there — a pack that needs a
-             * literal color outside `svg` still goes through `context`.
+             * literal color outside `snapshot` still goes through `context`.
              */
             theme?: T['theme'];
         };
@@ -139,9 +151,9 @@ export interface SurfaceMap<T extends PackTypes = DefaultPackTypes> {
      * Identical to `react`, and served by the same renderer: an image backend
      * lays out the pack's DOM tree and stylesheet rather than a second tree
      * authored for it. The surface stays separate so a node can be hidden from
-     * images alone, and so a {@link Frame} has something to draw inside.
+     * snapshots alone, and so a {@link Frame} has something to draw inside.
      */
-    svg: {
+    snapshot: {
         env: {
             context: T['context'];
             scope: RenderScope<T>;
@@ -156,12 +168,12 @@ export interface SurfaceMap<T extends PackTypes = DefaultPackTypes> {
         };
         output: string;
     };
-    /** A string is printed as written; content from `md` is escaped where it lands. */
+    /** Content built with `md`, escaped where it lands; authored Markdown source goes through `md.authored`. */
     markdown: {
         env: {
             scope: RenderScope<T>;
         };
-        output: string | MarkdownContent;
+        output: MarkdownContent;
     };
     /**
      * Returns one payload or several, so a primitive need not wrap a single
@@ -193,12 +205,12 @@ export interface RenderScope<T extends PackTypes = DefaultPackTypes> {
     collectStyles(node: PrimitiveNode, styles: PrimitiveStyleCollector, context: PrimitiveStyleCollectionContext): void;
     renderText(node: PrimitiveNode): string;
     renderMarkdown(node: PrimitiveNode): string;
-    /** A child as content, for a container building with `md`; a string result is printed as written. */
+    /** A child as content, for a container building with `md`. */
     renderMarkdownContent(node: PrimitiveNode): MarkdownContent;
     /** Empty when the node is hidden from `slack`, `sanitize` drops it, or its renderer returns nothing; a node with no `slack` renderer degrades through its markdown. */
     renderSlack(node: PrimitiveNode, collector?: T['slackCollector']): readonly T['slackBlock'][];
-    /** `0` when the node is hidden from `svg` or its primitive declares no `metrics.svgHeight`. */
-    estimateSvgHeight(node: PrimitiveNode): number;
+    /** `0` when the node is hidden from `snapshot` or its primitive declares no `metrics.snapshotHeight`. */
+    estimateSnapshotHeight(node: PrimitiveNode): number;
     /** Appends schema failures under `path` to `errors`, each naming `node`'s type. */
     validate(node: PrimitiveNode, path: string, errors: ValidationError[]): void;
 }
@@ -215,15 +227,17 @@ export type Renderer<TNode extends PrimitiveNode, S extends SurfaceName, T exten
  *
  * Only `slack`, and even that stays optional per primitive: the dispatcher
  * converts the mandatory markdown to Block Kit, so a missing Slack renderer
- * degrades rather than disappearing. `svg` is not here because no primitive
+ * degrades rather than disappearing. `snapshot` is not here because no primitive
  * implements it — the surface reuses `react`.
  */
-export type OptionalSurface = Extract<SurfaceName, 'slack'>;
+export declare const OPTIONAL_SURFACES: readonly ["slack"];
+/** One of the {@link OPTIONAL_SURFACES}. */
+export type OptionalSurface = (typeof OPTIONAL_SURFACES)[number];
 /**
  * One renderer per surface a primitive implements.
  *
  * `react`, `text`, and `markdown` are always required: those three are what
- * make "every composition degrades" true. `react` serves the `svg` surface
+ * make "every composition degrades" true. `react` serves the `snapshot` surface
  * too, so targeting images costs a primitive nothing.
  *
  * `slack` is declared method-style deliberately: method parameters are checked
@@ -241,7 +255,7 @@ export interface Renderers<TNode extends PrimitiveNode, T extends PackTypes = De
     }): string;
     markdown(node: TNode, env: {
         scope: RenderScope<T>;
-    }): string | MarkdownContent;
+    }): MarkdownContent;
     slack?(node: TNode, env: {
         collector?: T['slackCollector'];
         scope: RenderScope<T>;
@@ -250,12 +264,12 @@ export interface Renderers<TNode extends PrimitiveNode, T extends PackTypes = De
 /**
  * Measurements a frame can ask of a node before drawing it.
  *
- * `svgHeight` is optional, so a frame that sums node heights sizes short when
- * it is missing — the missing `svgHeight` validation warning reports the gap.
+ * `snapshotHeight` is optional. The height estimate is `0` when it is missing, so
+ * a frame that sums node heights sizes short.
  */
 export interface PrimitiveMetrics<TNode extends PrimitiveNode> {
     /** The node's drawn height in pixels at the frame's width. */
-    svgHeight?: (node: TNode) => number;
+    snapshotHeight?: (node: TNode) => number;
 }
 /**
  * Every primitive's schema is an object schema, because {@link definePrimitive}
@@ -292,8 +306,14 @@ export interface PrimitiveDefinition<TNode extends PrimitiveNode, T extends Pack
     type: TNode['type'];
     /** How the authoring prompt describes this primitive to the model. */
     catalog: PrimitiveCatalogEntry;
-    /** Driven by the conformance harness. The catalog `example` is what the prompt shows. */
-    examples: readonly TNode[];
+    /** Host-facing glyph, never shown to the model. Absent means the host supplies its own. */
+    icon?: PrimitiveIcon;
+    /**
+     * Driven by the conformance harness, bare or named; read them with
+     * `exampleNodes` or `primitiveExamples`. The catalog `example` is what the
+     * prompt shows.
+     */
+    examples: readonly (TNode | PrimitiveExample<TNode>)[];
     /**
      * This primitive on its own. A container declares
      * {@link PrimitiveDefinition.schemaFor} as well, and uses
@@ -310,7 +330,7 @@ export interface PrimitiveDefinition<TNode extends PrimitiveNode, T extends Pack
      * exactly one union.
      */
     schemaFor?: (bodyNodeSchema: ZodType<unknown>) => PrimitiveSchema;
-    /** One function per surface; `react` serves `svg` as well. */
+    /** One function per surface; `react` serves `snapshot` as well. */
     renderers: Renderers<TNode, T>;
     /** Sizing a frame can ask for before drawing. Absent means it cannot be measured. */
     metrics?: PrimitiveMetrics<TNode>;
@@ -353,12 +373,13 @@ export interface PrimitiveDefinition<TNode extends PrimitiveNode, T extends Pack
 export interface AnyPrimitiveDefinition {
     type: string;
     catalog: PrimitiveCatalogEntry;
-    examples: readonly PrimitiveNode[];
+    icon?: PrimitiveIcon;
+    examples: readonly (PrimitiveNode | PrimitiveExample)[];
     schema: PrimitiveSchema;
     schemaFor?: (bodyNodeSchema: ZodType<unknown>) => PrimitiveSchema;
     renderers: Record<'react' | 'text' | 'markdown', unknown> & Partial<Record<'slack', unknown>>;
     metrics?: {
-        svgHeight?: unknown;
+        snapshotHeight?: unknown;
     };
     sanitize?: unknown;
     children?: unknown;
@@ -372,7 +393,7 @@ export declare const bodyNodeIdSchema: z.ZodString;
 /** The `surfaces` allowlist on a node. Absent means every surface; empty is rejected. */
 export declare const bodyNodeSurfacesSchema: z.ZodArray<z.ZodEnum<{
     react: "react";
-    svg: "svg";
+    snapshot: "snapshot";
     text: "text";
     markdown: "markdown";
     slack: "slack";

package/dist/define/primitive_module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitive_module.d.ts","sourceRoot":"","sources":["../../src/define/primitive_module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"primitive_module.d.ts","sourceRoot":"","sources":["../../src/define/primitive_module.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mHAAmH;IACnH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8FAA8F;IAC9F,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,mIAAmI;IACnI,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,QAAQ,IAClC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,QAAQ,GAClC,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GACpB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC;IACzD,iGAAiG;IACjG,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,SAAS,MAAM,GAAG,CAAC;CAC1D;AAED,iFAAiF;AACjF,MAAM,WAAW,+BAA+B;IAC9C,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,uBAAuB,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,EAAE,uBAAuB,CAAC;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,SAAS,GAAG,gBAAgB;IAChE,KAAK,EAAE;QACL,GAAG,EAAE;YACH,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YACtB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;YACtB;;;;;eAKG;YACH,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;SACpB,CAAC;QACF,MAAM,EAAE,SAAS,CAAC;KACnB,CAAC;IACF;;;;;OAKG;IACH,QAAQ,EAAE;QACR,GAAG,EAAE;YACH,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YACtB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;YACtB,kFAAkF;YAClF,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;SACpB,CAAC;QACF,MAAM,EAAE,SAAS,CAAC;KACnB,CAAC;IACF,IAAI,EAAE;QACJ,GAAG,EAAE;YACH,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;SACvB,CAAC;QACF,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,4GAA4G;IAC5G,QAAQ,EAAE;QACR,GAAG,EAAE;YACH,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;SACvB,CAAC;QACF,MAAM,EAAE,eAAe,CAAC;KACzB,CAAC;IACF;;;OAGG;IACH,KAAK,EAAE;QACL,GAAG,EAAE;YACH,SAAS,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAChC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;SACvB,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;KACtD,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,gBAAgB;IACjE,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,wFAAwF;IACxF,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,sBAAsB,CAAC;IAC3D,oIAAoI;IACpI,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5B,OAAO,EAAE,CAAC,EACV,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAC7C,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC1C,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACpE,aAAa,CACX,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,+BAA+B,GACvC,IAAI,CAAC;IACR,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IACxC,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAC5C,8DAA8D;IAC9D,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAAC;IAC5D,uKAAuK;IACvK,WAAW,CACT,IAAI,EAAE,aAAa,EACnB,SAAS,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAC9B,SAAS,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;IAC9B,yGAAyG;IACzG,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IACpD,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;CAC9E;AAED;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAClB,KAAK,SAAS,aAAa,EAC3B,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,SAAS,GAAG,gBAAgB,IACpC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,oBAEa,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS,CACxB,KAAK,SAAS,aAAa,EAC3B,CAAC,SAAS,SAAS,GAAG,gBAAgB;IAEtC,KAAK,CACH,IAAI,EAAE,KAAK,EACX,GAAG,EAAE;QACH,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QACtB,kDAAkD;QAClD,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;KACpB,GACA,SAAS,CAAC;IACb,IAAI,CACF,IAAI,EAAE,KAAK,EACX,GAAG,EAAE;QACH,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;KACvB,GACA,MAAM,CAAC;IACV,QAAQ,CACN,IAAI,EAAE,KAAK,EACX,GAAG,EAAE;QACH,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;KACvB,GACA,eAAe,CAAC;IACnB,KAAK,CAAC,CACJ,IAAI,EAAE,KAAK,EACX,GAAG,EAAE;QACH,SAAS,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAChC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;KACvB,GACA,CAAC,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;CACjD;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,aAAa;IAC3D,8DAA8D;IAC9D,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAClC,KAAK,SAAS,aAAa,EAC3B,CAAC,SAAS,SAAS,GAAG,gBAAgB,EACtC,OAAO,SAAS,eAAe,GAAG,eAAe;IAEjD,oFAAoF;IACpF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,sEAAsE;IACtE,OAAO,EAAE,qBAAqB,CAAC;IAC/B,2FAA2F;IAC3F,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;;OAIG;IACH,QAAQ,EAAE,SAAS,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACvD;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,eAAe,CAAC;IAClE,mEAAmE;IACnE,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/B,qFAAqF;IACrF,OAAO,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,GAAG,IAAI,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,iBAAiB,EAAE,CAAC;IACzD;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC;IACzC,kFAAkF;IAClF,aAAa,CAAC,EAAE,CACd,IAAI,EAAE,KAAK,EACX,GAAG,EAAE;QAAE,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;QAAC,OAAO,EAAE,+BAA+B,CAAA;KAAE,KACtE,IAAI,CAAC;CACX;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,CAAC;IACxD,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,eAAe,CAAC;IAClE,SAAS,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,GACvD,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,eAAe,EACvB,MAAM,OAAO,EACb,MAAM,MAAM,EACZ,QAAQ,eAAe,EAAE,KACxB,IAKF,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,aAA+C,CAAC;AAE7E,yFAAyF;AACzF,eAAO,MAAM,sBAAsB;;;;;;GAMsB,CAAC;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,SAAS,aAAa,EAC3B,CAAC,SAAS,SAAS,GAAG,gBAAgB,EACtC,OAAO,SAAS,eAAe,GAAG,eAAe,EAEjD,YAAY,mBAAmB,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,KACjD,mBAAmB,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAmBvD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC5B,CAAC,SAAS,SAAS,QAElB,KAAK,SAAS,aAAa,EAC3B,OAAO,SAAS,eAAe,GAAG,eAAe,EAEjD,YAAY,mBAAmB,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,KACjD,mBAAmB,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CACR,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,eAAe,IACxD,OAAO,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,GAClC,SAAS,CACP,KAAK,GAAG;IACN,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjD,QAAQ,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC9D,CACF,GACD,eAAe,CAAC"}

package/dist/define/primitive_module.js

@@ -5,10 +5,21 @@
  * 2.0.
  */
 import { z } from 'zod';
-import { BODY_NODE_SURFACES, } from '../composition/body_node_base.js';
+import { SURFACE_NAMES, } from '../composition/body_node_base.js';
 import { ISOMER_ERROR_CODES, IsomerError } from '../composition/error.js';
 import { formatZodIssues, oneOf } from './zod_format.js';
 import { requiredString } from './zod_helpers.js';
+/**
+ * The surface a pack may declare beyond the mandatory three.
+ *
+ * Only `slack`, and even that stays optional per primitive: the dispatcher
+ * converts the mandatory markdown to Block Kit, so a missing Slack renderer
+ * degrades rather than disappearing. `snapshot` is not here because no primitive
+ * implements it — the surface reuses `react`.
+ */
+export const OPTIONAL_SURFACES = [
+    'slack',
+];
 /** Parses `node` against `schema`, appending path-prefixed messages to `errors`. */
 export const validateWithSchema = (schema, node, path, errors) => {
     const result = schema.safeParse(node, { reportInput: true });
@@ -20,8 +31,8 @@ export const validateWithSchema = (schema, node, path, errors) => {
 export const bodyNodeIdSchema = requiredString('must be a non-empty string');
 /** The `surfaces` allowlist on a node. Absent means every surface; empty is rejected. */
 export const bodyNodeSurfacesSchema = z
-    .array(z.enum(BODY_NODE_SURFACES, {
-    error: () => oneOf(BODY_NODE_SURFACES),
+    .array(z.enum(SURFACE_NAMES, {
+    error: () => oneOf(SURFACE_NAMES),
 }))
     .min(1, { error: 'must contain at least one surface' });
 /**
@@ -47,10 +58,14 @@ export const unresolvedBodyNodeSchema = z.looseObject({
  * {@link PackTypes}, so each primitive names only `TNode`.
  */
 export const definePrimitive = (definition) => {
-    const { schemaFor } = definition;
+    const { schemaFor, schema, catalog } = definition;
+    const described = catalog.description === undefined ? schema.description : undefined;
     return {
         ...definition,
-        schema: withNodeFields(definition.schema),
+        ...(described === undefined
+            ? {}
+            : { catalog: { ...catalog, description: described } }),
+        schema: withNodeFields(schema),
         // Both forms get the node fields, or a container would accept `id` and
         // `surfaces` standalone and reject them inside a composition.
         ...(schemaFor
@@ -81,11 +96,13 @@ const NODE_FIELDS = {
 const isNodeField = (schema) => {
     let current = schema;
     while (current && typeof current === 'object') {
-        if (Object.hasOwn(current, NODE_FIELD))
+        if (Object.hasOwn(current, NODE_FIELD)) {
             return true;
+        }
         const { def } = current;
-        if (def?.type !== 'optional')
+        if (def?.type !== 'optional') {
             return false;
+        }
         current = def.innerType;
     }
     return false;