@elastic/isomer-sdk 0.1.0 → 0.2.0

package/dist/entries/slack.js.map

@@ -1 +1 @@
-{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../src/entries/slack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EA8CL,YAAY,EACZ,IAAI,EACJ,cAAc,EACd,IAAI,EACJ,SAAS,EACT,yBAAyB,EACzB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,EACN,IAAI,EACJ,4BAA4B,EAC5B,mBAAmB,EACnB,YAAY,EACZ,MAAM,GACP,MAAM,iBAAiB,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 SlackActionElement,\n  type SlackActionsBlock,\n  type SlackAssetCollector,\n  type SlackAssetRequest,\n  type SlackBlock,\n  type SlackButtonElement,\n  type SlackCheckboxesElement,\n  type SlackContextBlock,\n  type SlackDividerBlock,\n  type SlackEnvelopeDispatcher,\n  type SlackEnvelopeOptions,\n  type SlackEnvelopeResult,\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  SLACK_LIMITS,\n  bold,\n  clampSlackText,\n  code,\n  codeBlock,\n  createSlackAssetCollector,\n  escapeMrkdwn,\n  gfmToSlackBlocks,\n  isSlackReachableImageUrl,\n  italic,\n  link,\n  markdownContentToSlackBlocks,\n  renderSlackEnvelope,\n  slackLinkUrl,\n  strike,\n} from '../render/slack';\n"]}
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../src/entries/slack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EA8CL,YAAY,EACZ,IAAI,EACJ,cAAc,EACd,IAAI,EACJ,SAAS,EACT,yBAAyB,EACzB,YAAY,EACZ,wBAAwB,EACxB,MAAM,EACN,IAAI,EACJ,4BAA4B,EAC5B,mBAAmB,EACnB,YAAY,EACZ,MAAM,GACP,MAAM,iBAAiB,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 SlackActionElement,\n  type SlackActionsBlock,\n  type SlackAssetCollector,\n  type SlackAssetRequest,\n  type SlackBlock,\n  type SlackButtonElement,\n  type SlackCheckboxesElement,\n  type SlackContextBlock,\n  type SlackDividerBlock,\n  type SlackEnvelopeDispatcher,\n  type SlackEnvelopeOptions,\n  type SlackEnvelopeResult,\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  SLACK_LIMITS,\n  bold,\n  clampSlackText,\n  code,\n  codeBlock,\n  createSlackAssetCollector,\n  escapeMrkdwn,\n  isSlackReachableImageUrl,\n  italic,\n  link,\n  markdownContentToSlackBlocks,\n  renderSlackEnvelope,\n  slackLinkUrl,\n  strike,\n} from '../render/slack';\n"]}

package/dist/pack/capabilities.d.ts

@@ -1,4 +1,6 @@
 import type { AnyPrimitivePack } from './primitive_pack.js';
+/** `native` renders through the primitive's own renderer, `fallback` through another surface's (Slack via markdown). */
+export type SurfaceSupport = 'native' | 'fallback';
 /**
  * What a runtime or a pack supports. Enhancement ids are open strings: each
  * pack declares its own on {@link PrimitivePack.enhancements}, and a runtime
@@ -7,21 +9,33 @@ import type { AnyPrimitivePack } from './primitive_pack.js';
 export interface HostCapabilities<TEnhancement extends string = string> {
     /** Primitive `type` values that can be dispatched. */
     primitives: string[];
-    /** Render formats reachable, e.g. `html`, `slack`, `png`. */
+    /** Surfaces that render, e.g. `html`, `slack`, `snapshot`. */
+    surfaces: string[];
+    /** Formats the host can ship, e.g. `html`, `slack`, `png`. Never `snapshot`, which only a rasterizer turns into a format. */
     formats: string[];
+    /**
+     * How each of `surfaces` renders each primitive, keyed by `type` then surface.
+     * `slack` is `fallback` for a primitive with no `slack` renderer; every other
+     * surface renders from `react`, `text`, or `markdown`, which are required.
+     */
+    support: Record<string, Record<string, SurfaceSupport>>;
     /** Progressive enhancements the packs declare, by id, which an HTML or React render may request. */
     enhancements?: Partial<Record<TEnhancement, boolean>>;
 }
+/** What {@link describeCapabilities} reports beyond the packs themselves. */
+export interface CapabilitySources {
+    /** The surfaces the caller built; `snapshot` exists only when a host supplied a frame. */
+    surfaces: readonly string[];
+    /** Formats produced outside the surfaces, such as a rasterizer's `png`. */
+    formats?: readonly string[];
+}
 /**
- * Reports the primitive types and render formats a set of packs supports.
+ * Reports the primitive types, surfaces, and formats a set of packs supports.
  *
- * `formats` is passed rather than derived because only the caller knows which
- * surfaces exist: a runtime passes the surfaces it built, and a pack passes
- * what it can produce through its own entry points — a `png` reachable only
- * behind a host image binding is something no runtime can infer. `svg` in
- * particular depends on a frame, which is a runtime input and not a pack's to
- * report.
- * @param formats Candidate formats this caller can reach.
+ * `surfaces` is passed rather than derived because only the caller knows which
+ * exist. Every surface but `snapshot` is also a format; `formats` adds the ones
+ * no surface produces on its own, so a `png` is reported only when a host
+ * registers the rasterizer that writes it.
  */
-export declare const describeCapabilities: (packs: readonly AnyPrimitivePack[], formats: readonly string[]) => HostCapabilities;
+export declare const describeCapabilities: (packs: readonly AnyPrimitivePack[], { surfaces, formats }: CapabilitySources) => HostCapabilities;
 //# sourceMappingURL=capabilities.d.ts.map

package/dist/pack/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/pack/capabilities.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM;IACpE,sDAAsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oGAAoG;IACpG,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,gBAAgB,EAAE,EAClC,SAAS,SAAS,MAAM,EAAE,KACzB,gBAiBF,CAAC"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/pack/capabilities.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wHAAwH;AACxH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM;IACpE,sDAAsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6HAA6H;IAC7H,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IACxD,oGAAoG;IACpG,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAKD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,gBAAgB,EAAE,EAClC,uBAA4B,iBAAiB,KAC5C,gBA2BF,CAAC"}

package/dist/pack/capabilities.js

@@ -4,22 +4,27 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
+/** The one surface whose output is not itself a shippable format. */
+const SNAPSHOT = 'snapshot';
 /**
- * Reports the primitive types and render formats a set of packs supports.
+ * Reports the primitive types, surfaces, and formats a set of packs supports.
  *
- * `formats` is passed rather than derived because only the caller knows which
- * surfaces exist: a runtime passes the surfaces it built, and a pack passes
- * what it can produce through its own entry points — a `png` reachable only
- * behind a host image binding is something no runtime can infer. `svg` in
- * particular depends on a frame, which is a runtime input and not a pack's to
- * report.
- * @param formats Candidate formats this caller can reach.
+ * `surfaces` is passed rather than derived because only the caller knows which
+ * exist. Every surface but `snapshot` is also a format; `formats` adds the ones
+ * no surface produces on its own, so a `png` is reported only when a host
+ * registers the rasterizer that writes it.
  */
-export const describeCapabilities = (packs, formats) => {
+export const describeCapabilities = (packs, { surfaces, formats = [] }) => {
     const enhancementIds = packs.flatMap((pack) => pack.enhancements.map((definition) => definition.id));
+    const definitions = packs.flatMap((pack) => pack.primitives);
     return {
-        primitives: packs.flatMap((pack) => pack.primitives.map((definition) => definition.type)),
-        formats: [...formats],
+        primitives: definitions.map(({ type }) => type),
+        surfaces: [...surfaces],
+        formats: [...new Set([...surfaces, ...formats])].filter((format) => format !== SNAPSHOT),
+        support: Object.fromEntries(definitions.map((definition) => [
+            definition.type,
+            Object.fromEntries(surfaces.map((surface) => [surface, supportOn(definition, surface)])),
+        ])),
         ...(enhancementIds.length > 0
             ? {
                 enhancements: Object.fromEntries(enhancementIds.map((id) => [id, true])),
@@ -27,4 +32,5 @@ export const describeCapabilities = (packs, formats) => {
             : {}),
     };
 };
+const supportOn = ({ renderers }, surface) => surface === 'slack' && renderers.slack === undefined ? 'fallback' : 'native';
 //# sourceMappingURL=capabilities.js.map

package/dist/pack/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/pack/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAkC,EAClC,OAA0B,EACR,EAAE;IACpB,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CACrD,CAAC;IACF,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CACrD;QACD,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;QACrB,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;YAC3B,CAAC,CAAC;gBACE,YAAY,EAAE,MAAM,CAAC,WAAW,CAC9B,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CACvC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,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// What a host can render, reported from packs rather than asserted by hand.\n//\n// Lives in the sdk so both the assembly layer and a pack import it from the\n// same place; a pack must not have to depend on the assembly layer for it.\n\nimport type { AnyPrimitivePack } from './primitive_pack';\n\n/**\n * What a runtime or a pack supports. Enhancement ids are open strings: each\n * pack declares its own on {@link PrimitivePack.enhancements}, and a runtime\n * reports the union.\n */\nexport interface HostCapabilities<TEnhancement extends string = string> {\n  /** Primitive `type` values that can be dispatched. */\n  primitives: string[];\n  /** Render formats reachable, e.g. `html`, `slack`, `png`. */\n  formats: string[];\n  /** Progressive enhancements the packs declare, by id, which an HTML or React render may request. */\n  enhancements?: Partial<Record<TEnhancement, boolean>>;\n}\n\n/**\n * Reports the primitive types and render formats a set of packs supports.\n *\n * `formats` is passed rather than derived because only the caller knows which\n * surfaces exist: a runtime passes the surfaces it built, and a pack passes\n * what it can produce through its own entry points — a `png` reachable only\n * behind a host image binding is something no runtime can infer. `svg` in\n * particular depends on a frame, which is a runtime input and not a pack's to\n * report.\n * @param formats Candidate formats this caller can reach.\n */\nexport const describeCapabilities = (\n  packs: readonly AnyPrimitivePack[],\n  formats: readonly string[]\n): HostCapabilities => {\n  const enhancementIds = packs.flatMap((pack) =>\n    pack.enhancements.map((definition) => definition.id)\n  );\n  return {\n    primitives: packs.flatMap((pack) =>\n      pack.primitives.map((definition) => definition.type)\n    ),\n    formats: [...formats],\n    ...(enhancementIds.length > 0\n      ? {\n          enhancements: Object.fromEntries(\n            enhancementIds.map((id) => [id, true])\n          ),\n        }\n      : {}),\n  };\n};\n"]}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/pack/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4CH,qEAAqE;AACrE,MAAM,QAAQ,GAAG,UAAU,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAkC,EAClC,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE,EAAqB,EAC3B,EAAE;IACpB,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CACrD,CAAC;IACF,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7D,OAAO;QACL,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;QAC/C,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;QACvB,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CACrD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,QAAQ,CAChC;QACD,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI;YACf,MAAM,CAAC,WAAW,CAChB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CACrE;SACF,CAAC,CACH;QACD,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;YAC3B,CAAC,CAAC;gBACE,YAAY,EAAE,MAAM,CAAC,WAAW,CAC9B,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CACvC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAChB,EAAE,SAAS,EAA0B,EACrC,OAAe,EACC,EAAE,CAClB,OAAO,KAAK,OAAO,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,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// What a host can render, reported from packs rather than asserted by hand.\n//\n// Lives in the sdk so both the assembly layer and a pack import it from the\n// same place; a pack must not have to depend on the assembly layer for it.\n\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport type { AnyPrimitivePack } from './primitive_pack';\n\n/** `native` renders through the primitive's own renderer, `fallback` through another surface's (Slack via markdown). */\nexport type SurfaceSupport = 'native' | 'fallback';\n\n/**\n * What a runtime or a pack supports. Enhancement ids are open strings: each\n * pack declares its own on {@link PrimitivePack.enhancements}, and a runtime\n * reports the union.\n */\nexport interface HostCapabilities<TEnhancement extends string = string> {\n  /** Primitive `type` values that can be dispatched. */\n  primitives: string[];\n  /** Surfaces that render, e.g. `html`, `slack`, `snapshot`. */\n  surfaces: string[];\n  /** Formats the host can ship, e.g. `html`, `slack`, `png`. Never `snapshot`, which only a rasterizer turns into a format. */\n  formats: string[];\n  /**\n   * How each of `surfaces` renders each primitive, keyed by `type` then surface.\n   * `slack` is `fallback` for a primitive with no `slack` renderer; every other\n   * surface renders from `react`, `text`, or `markdown`, which are required.\n   */\n  support: Record<string, Record<string, SurfaceSupport>>;\n  /** Progressive enhancements the packs declare, by id, which an HTML or React render may request. */\n  enhancements?: Partial<Record<TEnhancement, boolean>>;\n}\n\n/** What {@link describeCapabilities} reports beyond the packs themselves. */\nexport interface CapabilitySources {\n  /** The surfaces the caller built; `snapshot` exists only when a host supplied a frame. */\n  surfaces: readonly string[];\n  /** Formats produced outside the surfaces, such as a rasterizer's `png`. */\n  formats?: readonly string[];\n}\n\n/** The one surface whose output is not itself a shippable format. */\nconst SNAPSHOT = 'snapshot';\n\n/**\n * Reports the primitive types, surfaces, and formats a set of packs supports.\n *\n * `surfaces` is passed rather than derived because only the caller knows which\n * exist. Every surface but `snapshot` is also a format; `formats` adds the ones\n * no surface produces on its own, so a `png` is reported only when a host\n * registers the rasterizer that writes it.\n */\nexport const describeCapabilities = (\n  packs: readonly AnyPrimitivePack[],\n  { surfaces, formats = [] }: CapabilitySources\n): HostCapabilities => {\n  const enhancementIds = packs.flatMap((pack) =>\n    pack.enhancements.map((definition) => definition.id)\n  );\n  const definitions = packs.flatMap((pack) => pack.primitives);\n  return {\n    primitives: definitions.map(({ type }) => type),\n    surfaces: [...surfaces],\n    formats: [...new Set([...surfaces, ...formats])].filter(\n      (format) => format !== SNAPSHOT\n    ),\n    support: Object.fromEntries(\n      definitions.map((definition) => [\n        definition.type,\n        Object.fromEntries(\n          surfaces.map((surface) => [surface, supportOn(definition, surface)])\n        ),\n      ])\n    ),\n    ...(enhancementIds.length > 0\n      ? {\n          enhancements: Object.fromEntries(\n            enhancementIds.map((id) => [id, true])\n          ),\n        }\n      : {}),\n  };\n};\n\nconst supportOn = (\n  { renderers }: AnyPrimitiveDefinition,\n  surface: string\n): SurfaceSupport =>\n  surface === 'slack' && renderers.slack === undefined ? 'fallback' : 'native';\n"]}

package/dist/pack/compose.d.ts

@@ -1,6 +1,7 @@
+import type { PrimitiveIcon } from '../define/primitive_icon.js';
 import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
 import type { EnhancementDefinition } from './enhancements.js';
-import type { AnyPrimitivePack } from './primitive_pack.js';
+import { type AnyPrimitivePack } from './primitive_pack.js';
 /**
  * One flattened inventory owned by {@link composePacks}.
  *
@@ -10,6 +11,8 @@ import type { AnyPrimitivePack } from './primitive_pack.js';
 export interface ComposedPacks {
     readonly definitions: readonly AnyPrimitiveDefinition[];
     readonly enhancements: readonly EnhancementDefinition[];
+    /** Every definition's `icon` by type, in one frozen null-prototype dictionary. */
+    readonly icons: Readonly<Record<string, PrimitiveIcon>>;
     readonly slackAssetTypes: ReadonlySet<string>;
 }
 /**

package/dist/pack/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/pack/compose.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,SAAS,gBAAgB,EAAE,KACjC,aAuCF,CAAC"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/pack/compose.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,kBAAkB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxD,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,SAAS,gBAAgB,EAAE,KACjC,aAyCF,CAAC"}

package/dist/pack/compose.js

@@ -5,6 +5,7 @@
  * 2.0.
  */
 import { IsomerError } from '../composition/error.js';
+import { iconsByType } from './primitive_pack.js';
 /**
  * Flattens `packs` into one inventory, rejecting cross-pack duplicate node
  * types and duplicate enhancement ids. Every offender is named in one error,
@@ -34,9 +35,11 @@ export const composePacks = (packs) => {
     }
     assertUnique('DUPLICATE_PRIMITIVE_TYPE', 'primitive type', typeOwners);
     assertUnique('DUPLICATE_ENHANCEMENT', 'enhancement', enhancementOwners);
+    const definitions = packs.flatMap((pack) => [...pack.primitives]);
     return Object.freeze({
-        definitions: Object.freeze(packs.flatMap((pack) => [...pack.primitives])),
+        definitions: Object.freeze(definitions),
         enhancements: Object.freeze(packs.flatMap((pack) => [...pack.enhancements])),
+        icons: iconsByType(definitions),
         slackAssetTypes: new Set(packs.flatMap((pack) => [...pack.slackAssetTypes])),
     });
 };

package/dist/pack/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/pack/compose.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { IsomerError } from '../composition/error';\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport type { EnhancementDefinition } from './enhancements';\nimport type { AnyPrimitivePack } from './primitive_pack';\n\n/**\n * One flattened inventory owned by {@link composePacks}.\n *\n * `definitions` is a stable array identity, which is what the composition\n * schema cache keys on — pass it through rather than flattening packs per call.\n */\nexport interface ComposedPacks {\n  readonly definitions: readonly AnyPrimitiveDefinition[];\n  readonly enhancements: readonly EnhancementDefinition[];\n  readonly slackAssetTypes: ReadonlySet<string>;\n}\n\n/**\n * Flattens `packs` into one inventory, rejecting cross-pack duplicate node\n * types and duplicate enhancement ids. Every offender is named in one error,\n * so a bad three-pack composition reports all three at once.\n */\nexport const composePacks = (\n  packs: readonly AnyPrimitivePack[]\n): ComposedPacks => {\n  const typeOwners = new Map<string, string[]>();\n  const enhancementOwners = new Map<string, string[]>();\n  for (const pack of packs) {\n    for (const { type } of pack.primitives) {\n      typeOwners.set(type, [...(typeOwners.get(type) ?? []), pack.id]);\n    }\n    for (const { id } of pack.enhancements) {\n      enhancementOwners.set(id, [\n        ...(enhancementOwners.get(id) ?? []),\n        pack.id,\n      ]);\n    }\n  }\n  const repeated = [\n    ...new Set(\n      packs\n        .map(({ id }) => id)\n        .filter((id, index, ids) => ids.indexOf(id) !== index)\n    ),\n  ];\n  if (repeated.length > 0) {\n    throw new IsomerError(\n      'DUPLICATE_PACK_ID',\n      `composePacks: ${repeated.map((id) => `\"${id}\"`).join(', ')} names more than one pack; pack ids must be unique`\n    );\n  }\n  assertUnique('DUPLICATE_PRIMITIVE_TYPE', 'primitive type', typeOwners);\n  assertUnique('DUPLICATE_ENHANCEMENT', 'enhancement', enhancementOwners);\n\n  return Object.freeze({\n    definitions: Object.freeze(packs.flatMap((pack) => [...pack.primitives])),\n    enhancements: Object.freeze(\n      packs.flatMap((pack) => [...pack.enhancements])\n    ),\n    slackAssetTypes: new Set(\n      packs.flatMap((pack) => [...pack.slackAssetTypes])\n    ),\n  });\n};\n\nconst assertUnique = (\n  code: 'DUPLICATE_ENHANCEMENT' | 'DUPLICATE_PRIMITIVE_TYPE',\n  noun: string,\n  owners: ReadonlyMap<string, readonly string[]>\n): void => {\n  const duplicates = [...owners].filter(([, packs]) => packs.length > 1);\n  if (duplicates.length === 0) {\n    return;\n  }\n  throw new IsomerError(\n    code,\n    duplicates\n      .map(\n        ([key, packs]) =>\n          `${noun} \"${key}\" registered by ${packs.map((id) => `\"${id}\"`).join(' and ')}`\n      )\n      .join('; ')\n  );\n};\n"]}
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/pack/compose.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { IsomerError } from '../composition/error';\nimport type { PrimitiveIcon } from '../define/primitive_icon';\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport type { EnhancementDefinition } from './enhancements';\nimport { type AnyPrimitivePack, iconsByType } from './primitive_pack';\n\n/**\n * One flattened inventory owned by {@link composePacks}.\n *\n * `definitions` is a stable array identity, which is what the composition\n * schema cache keys on — pass it through rather than flattening packs per call.\n */\nexport interface ComposedPacks {\n  readonly definitions: readonly AnyPrimitiveDefinition[];\n  readonly enhancements: readonly EnhancementDefinition[];\n  /** Every definition's `icon` by type, in one frozen null-prototype dictionary. */\n  readonly icons: Readonly<Record<string, PrimitiveIcon>>;\n  readonly slackAssetTypes: ReadonlySet<string>;\n}\n\n/**\n * Flattens `packs` into one inventory, rejecting cross-pack duplicate node\n * types and duplicate enhancement ids. Every offender is named in one error,\n * so a bad three-pack composition reports all three at once.\n */\nexport const composePacks = (\n  packs: readonly AnyPrimitivePack[]\n): ComposedPacks => {\n  const typeOwners = new Map<string, string[]>();\n  const enhancementOwners = new Map<string, string[]>();\n  for (const pack of packs) {\n    for (const { type } of pack.primitives) {\n      typeOwners.set(type, [...(typeOwners.get(type) ?? []), pack.id]);\n    }\n    for (const { id } of pack.enhancements) {\n      enhancementOwners.set(id, [\n        ...(enhancementOwners.get(id) ?? []),\n        pack.id,\n      ]);\n    }\n  }\n  const repeated = [\n    ...new Set(\n      packs\n        .map(({ id }) => id)\n        .filter((id, index, ids) => ids.indexOf(id) !== index)\n    ),\n  ];\n  if (repeated.length > 0) {\n    throw new IsomerError(\n      'DUPLICATE_PACK_ID',\n      `composePacks: ${repeated.map((id) => `\"${id}\"`).join(', ')} names more than one pack; pack ids must be unique`\n    );\n  }\n  assertUnique('DUPLICATE_PRIMITIVE_TYPE', 'primitive type', typeOwners);\n  assertUnique('DUPLICATE_ENHANCEMENT', 'enhancement', enhancementOwners);\n\n  const definitions = packs.flatMap((pack) => [...pack.primitives]);\n  return Object.freeze({\n    definitions: Object.freeze(definitions),\n    enhancements: Object.freeze(\n      packs.flatMap((pack) => [...pack.enhancements])\n    ),\n    icons: iconsByType(definitions),\n    slackAssetTypes: new Set(\n      packs.flatMap((pack) => [...pack.slackAssetTypes])\n    ),\n  });\n};\n\nconst assertUnique = (\n  code: 'DUPLICATE_ENHANCEMENT' | 'DUPLICATE_PRIMITIVE_TYPE',\n  noun: string,\n  owners: ReadonlyMap<string, readonly string[]>\n): void => {\n  const duplicates = [...owners].filter(([, packs]) => packs.length > 1);\n  if (duplicates.length === 0) {\n    return;\n  }\n  throw new IsomerError(\n    code,\n    duplicates\n      .map(\n        ([key, packs]) =>\n          `${noun} \"${key}\" registered by ${packs.map((id) => `\"${id}\"`).join(' and ')}`\n      )\n      .join('; ')\n  );\n};\n"]}

package/dist/pack/index.d.ts

@@ -1,4 +1,4 @@
-export { type HostCapabilities, describeCapabilities } from './capabilities.js';
+export { type CapabilitySources, type HostCapabilities, type SurfaceSupport, describeCapabilities, } from './capabilities.js';
 export { type ComposedPacks, composePacks } from './compose.js';
 export { type EnhancementDefinition, scopeScript } from './enhancements.js';
 export { type AnyPrimitivePack, type PackAuthoringOptions, type PackStyleAdapter, type PrimitiveGroup, type PrimitivePack, type PrimitivePackInput, definePrimitivePack, } from './primitive_pack.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,KAAK,qBAAqB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,KAAK,qBAAqB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/pack/index.js

@@ -4,7 +4,7 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-export { describeCapabilities } from './capabilities.js';
+export { describeCapabilities, } from './capabilities.js';
 export { composePacks } from './compose.js';
 export { scopeScript } from './enhancements.js';
 export { definePrimitivePack, } from './primitive_pack.js';

package/dist/pack/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAyB,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAsB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAA8B,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAOL,mBAAmB,GACpB,MAAM,kBAAkB,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 HostCapabilities, describeCapabilities } from './capabilities';\nexport { type ComposedPacks, composePacks } from './compose';\nexport { type EnhancementDefinition, scopeScript } from './enhancements';\nexport {\n  type AnyPrimitivePack,\n  type PackAuthoringOptions,\n  type PackStyleAdapter,\n  type PrimitiveGroup,\n  type PrimitivePack,\n  type PrimitivePackInput,\n  definePrimitivePack,\n} from './primitive_pack';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAsB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAA8B,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAOL,mBAAmB,GACpB,MAAM,kBAAkB,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 CapabilitySources,\n  type HostCapabilities,\n  type SurfaceSupport,\n  describeCapabilities,\n} from './capabilities';\nexport { type ComposedPacks, composePacks } from './compose';\nexport { type EnhancementDefinition, scopeScript } from './enhancements';\nexport {\n  type AnyPrimitivePack,\n  type PackAuthoringOptions,\n  type PackStyleAdapter,\n  type PrimitiveGroup,\n  type PrimitivePack,\n  type PrimitivePackInput,\n  definePrimitivePack,\n} from './primitive_pack';\n"]}

package/dist/pack/primitive_pack.d.ts

@@ -1,3 +1,4 @@
+import type { PrimitiveIcon } from '../define/primitive_icon.js';
 import type { AnyPrimitiveDefinition, OptionalSurface, StyleHandle } from '../define/primitive_module.js';
 import type { EnhancementDefinition } from './enhancements.js';
 /**
@@ -98,7 +99,7 @@ export interface PrimitivePackInput {
  * A pack as the runtime sees it.
  *
  * `TTheme` is the palette this pack's `react` renderers read as `env.theme`
- * when drawn through the `svg` surface — a *lower bound* on whatever theme
+ * when drawn through the `snapshot` surface — a *lower bound* on whatever theme
  * the runtime holding it supplies. It is carried by
  * {@link PrimitivePack.__theme} rather than by any real field, because
  * `primitives` is erased to `AnyPrimitiveDefinition[]` and a heterogeneous
@@ -119,6 +120,12 @@ export interface PrimitivePack<TTheme = unknown> {
     readonly primitives: readonly AnyPrimitiveDefinition[];
     /** Node types this pack owns, for duplicate detection across packs. */
     readonly types: ReadonlySet<string>;
+    /**
+     * Each primitive's `icon` by type, for the primitives that declare one, so a host listing them need not walk `primitives`.
+     *
+     * A frozen null-prototype dictionary: an absent type reads `undefined`, even `constructor`. Absent on a pack built by an SDK that predates icons; {@link iconsByType} derives it from `primitives`.
+     */
+    readonly icons?: Readonly<Record<string, PrimitiveIcon>>;
     /** See {@link PrimitivePackInput.enhancements}. */
     readonly enhancements: readonly EnhancementDefinition[];
     /** See {@link PrimitivePackInput.slackAssetTypes}. */
@@ -148,8 +155,10 @@ export type AnyPrimitivePack = PrimitivePack<never>;
  * Builds a {@link PrimitivePack}.
  *
  * `TTheme` is the palette a frame must supply for this pack's nodes to be drawn
- * on the `svg` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is
+ * on the `snapshot` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is
  * `unknown`, which requires nothing.
  */
 export declare const definePrimitivePack: <TTheme = unknown>(input: PrimitivePackInput) => PrimitivePack<TTheme>;
+/** Each definition's `icon` by type, null-prototype so a type such as `__proto__` is an ordinary key. */
+export declare const iconsByType: (primitives: readonly AnyPrimitiveDefinition[]) => Readonly<Record<string, PrimitiveIcon>>;
 //# sourceMappingURL=primitive_pack.d.ts.map

package/dist/pack/primitive_pack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitive_pack.d.ts","sourceRoot":"","sources":["../../src/pack/primitive_pack.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"primitive_pack.d.ts","sourceRoot":"","sources":["../../src/pack/primitive_pack.ts"],"names":[],"mappings":"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"}

package/dist/pack/primitive_pack.js

@@ -12,7 +12,7 @@ import { IsomerError } from '../composition/error.js';
  * Builds a {@link PrimitivePack}.
  *
  * `TTheme` is the palette a frame must supply for this pack's nodes to be drawn
- * on the `svg` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is
+ * on the `snapshot` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is
  * `unknown`, which requires nothing.
  */
 export const definePrimitivePack = (input) => {
@@ -34,6 +34,7 @@ export const definePrimitivePack = (input) => {
         surfaces: input.surfaces ?? [],
         primitives: input.primitives,
         types,
+        icons: iconsByType(input.primitives),
         enhancements: input.enhancements ?? [],
         slackAssetTypes: new Set(input.slackAssetTypes ?? []),
         ...(input.styleAdapter !== undefined
@@ -43,6 +44,16 @@ export const definePrimitivePack = (input) => {
         ...(input.authoring !== undefined ? { authoring: input.authoring } : {}),
     };
 };
+/** Each definition's `icon` by type, null-prototype so a type such as `__proto__` is an ordinary key. */
+export const iconsByType = (primitives) => {
+    const icons = Object.create(null);
+    for (const { type, icon } of primitives) {
+        if (icon !== undefined) {
+            icons[type] = icon;
+        }
+    }
+    return Object.freeze(icons);
+};
 /** Throws if `primitives` repeats a type. */
 const assertUniquePrimitiveTypes = (id, primitives) => {
     const seen = new Set();

package/dist/pack/primitive_pack.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitive_pack.js","sourceRoot":"","sources":["../../src/pack/primitive_pack.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// A primitive pack as a value: a vocabulary, and the optional surfaces every\n// primitive in it implements. Additive: a runtime composes any number of packs,\n// and nothing about a pack decides how a composition is framed.\n\nimport { IsomerError } from '../composition/error';\nimport type {\n  AnyPrimitiveDefinition,\n  OptionalSurface,\n  StyleHandle,\n} from '../define/primitive_module';\n\nimport type { EnhancementDefinition } from './enhancements';\n\n/**\n * The authoring-schema material a pack contributes for its own primitives.\n *\n * A subset of `AuthoringJsonSchemaOptions`: `$id`, `title`, `description`, and\n * `composition` describe the whole authoring schema a runtime builds, which is\n * a host decision, not a pack one. `pack/` does not import `validate/` for\n * this, so the shape is declared here rather than reused by reference.\n */\nexport interface PackAuthoringOptions {\n  /** `$def` id to `description`, for this pack's own primitives. */\n  describe?: Readonly<Record<string, string>>;\n  /** `$defId.property` paths to drop, from this pack's own primitives. */\n  omitProperties?: readonly string[];\n  /** Headings an index catalog sorts this pack's primitives under, in order. */\n  groups?: readonly PrimitiveGroup[];\n}\n\n/** A titled set of primitive types, listed together in an index catalog. */\nexport interface PrimitiveGroup {\n  title: string;\n  types: readonly string[];\n}\n\n/**\n * The HTML style-adapter hooks a pack may declare. Typed loosely here so `pack/` does not import `render/`.\n */\nexport type PackStyleAdapter = {\n  /** See {@link PrimitivePackInput.styleCollector}. */\n  styleCollector?: string;\n  /** The hooks of `HTMLStyleAdapter` from `./html`, erased: a fresh collector per render, the context renderers receive, and the stylesheet the collector produced. */\n  createCollector: (...args: never[]) => object;\n  createRenderContext: (...args: never[]) => unknown;\n  renderStyles: (...args: never[]) => string;\n  /**\n   * Whether `handle` belongs to this adapter's stylesheet. Required for a runtime to combine several packs' CSS: without it their handles cannot be routed and the host must pick one adapter.\n   */\n  ownsHandle?: (handle: StyleHandle) => boolean;\n};\n\n/** What a pack author passes to {@link definePrimitivePack}. */\nexport interface PrimitivePackInput {\n  /** Stable identifier, used in capability reports and error messages. */\n  id: string;\n  /**\n   * The optional surfaces this pack's primitives implement.\n   *\n   * Only `slack`, and it stays optional per primitive: the dispatcher converts\n   * the mandatory markdown to Block Kit, so declaring it reports an intent\n   * rather than imposing a requirement. Omit it entirely for a pack that\n   * renders Slack through that fallback.\n   */\n  surfaces?: readonly OptionalSurface[];\n  /** This pack's vocabulary. Node types must be unique within it, or construction throws. */\n  primitives: readonly AnyPrimitiveDefinition[];\n  /**\n   * Progressive enhancements this pack's primitives can apply, by id.\n   *\n   * Declared by the pack because an enhancement is a fact about its\n   * vocabulary — a sortable table, a copyable code block — and a host\n   * composing packs it did not write cannot be expected to know the ids.\n   * The runtime flattens these across packs; duplicate ids are rejected.\n   */\n  enhancements?: readonly EnhancementDefinition[];\n  /**\n   * Types that render as a self-contained picture rather than as text.\n   *\n   * A channel that cannot draw them inline uploads an image instead: the Slack\n   * dispatcher swaps such a node for an `image` block and an upload request, so\n   * a chart arrives as a PNG rather than as a markdown approximation of one.\n   *\n   * Declared by the pack because it is a fact about the vocabulary, and a host\n   * composing packs it did not write cannot be expected to know it.\n   */\n  slackAssetTypes?: readonly string[];\n  /**\n   * Default HTML style adapter for this pack. A runtime that omits\n   * `styleAdapter` runs the packs' own adapters, combined when more than one\n   * pack declares one and each answers `ownsHandle`. Pass `styleAdapter` on\n   * the runtime to replace them all.\n   */\n  styleAdapter?: PackStyleAdapter;\n  /**\n   * Names the collector shape this pack's `collectStyles` hooks mutate, so a\n   * runtime can reject a pack paired with an adapter of a different tag.\n   * Defaults to `styleAdapter.styleCollector`; a pack with neither opts out of\n   * the check.\n   */\n  styleCollector?: string;\n  /**\n   * This pack's own contribution to the runtime's authoring JSON Schema.\n   *\n   * Merged across every composed pack, so a host does not hand-merge each\n   * pack's `describe`/`omitProperties` into one options object itself. The\n   * runtime-level `authoring` option is merged in last and wins on conflict.\n   */\n  authoring?: PackAuthoringOptions;\n}\n\n/**\n * A pack as the runtime sees it.\n *\n * `TTheme` is the palette this pack's `react` renderers read as `env.theme`\n * when drawn through the `svg` surface — a *lower bound* on whatever theme\n * the runtime holding it supplies. It is carried by\n * {@link PrimitivePack.__theme} rather than by any real field, because\n * `primitives` is erased to `AnyPrimitiveDefinition[]` and a heterogeneous\n * inventory has no single node type to be generic over.\n *\n * The bound is declared, not derived: nothing checks it against what the\n * renderers actually read. State it at the definition as\n * `definePrimitivePack<T>(input)`.\n * Bare `PrimitivePack` requires nothing and fits any runtime; a slot that must\n * hold packs of every palette is typed {@link AnyPrimitivePack}.\n */\nexport interface PrimitivePack<TTheme = unknown> {\n  /** Unique among the packs a runtime composes, and used in error messages. */\n  readonly id: string;\n  /** See {@link PrimitivePackInput.surfaces}. */\n  readonly surfaces: readonly OptionalSurface[];\n  /** See {@link PrimitivePackInput.primitives}. */\n  readonly primitives: readonly AnyPrimitiveDefinition[];\n  /** Node types this pack owns, for duplicate detection across packs. */\n  readonly types: ReadonlySet<string>;\n  /** See {@link PrimitivePackInput.enhancements}. */\n  readonly enhancements: readonly EnhancementDefinition[];\n  /** See {@link PrimitivePackInput.slackAssetTypes}. */\n  readonly slackAssetTypes: ReadonlySet<string>;\n  /** See {@link PrimitivePackInput.styleAdapter}. */\n  readonly styleAdapter?: PackStyleAdapter;\n  /** See {@link PrimitivePackInput.styleCollector}. */\n  readonly styleCollector?: string;\n  /** See {@link PrimitivePackInput.authoring}. */\n  readonly authoring?: PackAuthoringOptions;\n  /**\n   * Phantom: never present at runtime, never read.\n   *\n   * A property rather than a method so `strictFunctionTypes` checks it\n   * contravariantly. A method signature is bivariant, which would let a pack\n   * needing richer tokens sit in a slot supplying fewer and then read a field\n   * nothing supplies — the exact failure this marker exists to prevent.\n   */\n  readonly __theme?: (theme: TTheme) => void;\n}\n\n/**\n * A pack of any palette, for storage positions: `never` is assignable to every\n * requirement, so a slot typed this way holds every pack.\n */\nexport type AnyPrimitivePack = PrimitivePack<never>;\n\n/**\n * Builds a {@link PrimitivePack}.\n *\n * `TTheme` is the palette a frame must supply for this pack's nodes to be drawn\n * on the `svg` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is\n * `unknown`, which requires nothing.\n */\nexport const definePrimitivePack = <TTheme = unknown>(\n  input: PrimitivePackInput\n): PrimitivePack<TTheme> => {\n  if (input.primitives.length === 0) {\n    throw new IsomerError(\n      'EMPTY_PACK',\n      `primitive pack \"${input.id}\": at least one primitive is required`\n    );\n  }\n  assertUniquePrimitiveTypes(input.id, input.primitives);\n  assertUniqueEnhancementIds(input.id, input.enhancements ?? []);\n  const types = new Set(input.primitives.map((definition) => definition.type));\n  assertGroupedOnce(input.id, input.authoring?.groups ?? [], types);\n  for (const type of input.slackAssetTypes ?? []) {\n    if (!types.has(type)) {\n      throw new IsomerError(\n        'UNKNOWN_PRIMITIVE_TYPE',\n        `primitive pack \"${input.id}\": slackAssetTypes names primitive type \"${type}\", which the pack does not register`\n      );\n    }\n  }\n  const styleCollector =\n    input.styleCollector ?? input.styleAdapter?.styleCollector;\n\n  return {\n    id: input.id,\n    surfaces: input.surfaces ?? [],\n    primitives: input.primitives,\n    types,\n    enhancements: input.enhancements ?? [],\n    slackAssetTypes: new Set(input.slackAssetTypes ?? []),\n    ...(input.styleAdapter !== undefined\n      ? { styleAdapter: input.styleAdapter }\n      : {}),\n    ...(styleCollector !== undefined ? { styleCollector } : {}),\n    ...(input.authoring !== undefined ? { authoring: input.authoring } : {}),\n  };\n};\n\n/** Throws if `primitives` repeats a type. */\nconst assertUniquePrimitiveTypes = (\n  id: string,\n  primitives: readonly AnyPrimitiveDefinition[]\n): void => {\n  const seen = new Set<string>();\n  for (const { type } of primitives) {\n    if (seen.has(type)) {\n      throw new IsomerError(\n        'DUPLICATE_PRIMITIVE_TYPE',\n        `primitive pack \"${id}\": primitive type \"${type}\" registered twice`\n      );\n    }\n    seen.add(type);\n  }\n};\n\n/** Throws if a group names a type outside `types`, or two groups share a type. */\nconst assertGroupedOnce = (\n  id: string,\n  groups: readonly PrimitiveGroup[],\n  types: ReadonlySet<string>\n): void => {\n  const grouped = new Set<string>();\n  for (const { title, types: members } of groups) {\n    for (const type of members) {\n      if (!types.has(type)) {\n        throw new IsomerError(\n          'UNKNOWN_PRIMITIVE_TYPE',\n          `primitive pack \"${id}\": group \"${title}\" names primitive type \"${type}\", which the pack does not register`\n        );\n      }\n      if (grouped.has(type)) {\n        throw new IsomerError(\n          'DUPLICATE_PRIMITIVE_TYPE',\n          `primitive pack \"${id}\": primitive type \"${type}\" is in two groups`\n        );\n      }\n      grouped.add(type);\n    }\n  }\n};\n\n/** Throws if this pack registers the same enhancement id twice. */\nconst assertUniqueEnhancementIds = (\n  id: string,\n  enhancements: readonly EnhancementDefinition[]\n): void => {\n  const seen = new Set<string>();\n  for (const definition of enhancements) {\n    if (seen.has(definition.id)) {\n      throw new IsomerError(\n        'DUPLICATE_ENHANCEMENT',\n        `primitive pack \"${id}\": enhancement \"${definition.id}\" registered twice`\n      );\n    }\n    seen.add(definition.id);\n  }\n};\n"]}
+{"version":3,"file":"primitive_pack.js","sourceRoot":"","sources":["../../src/pack/primitive_pack.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// A primitive pack as a value: a vocabulary, and the optional surfaces every\n// primitive in it implements. Additive: a runtime composes any number of packs,\n// and nothing about a pack decides how a composition is framed.\n\nimport { IsomerError } from '../composition/error';\nimport type { PrimitiveIcon } from '../define/primitive_icon';\nimport type {\n  AnyPrimitiveDefinition,\n  OptionalSurface,\n  StyleHandle,\n} from '../define/primitive_module';\n\nimport type { EnhancementDefinition } from './enhancements';\n\n/**\n * The authoring-schema material a pack contributes for its own primitives.\n *\n * A subset of `AuthoringJsonSchemaOptions`: `$id`, `title`, `description`, and\n * `composition` describe the whole authoring schema a runtime builds, which is\n * a host decision, not a pack one. `pack/` does not import `validate/` for\n * this, so the shape is declared here rather than reused by reference.\n */\nexport interface PackAuthoringOptions {\n  /** `$def` id to `description`, for this pack's own primitives. */\n  describe?: Readonly<Record<string, string>>;\n  /** `$defId.property` paths to drop, from this pack's own primitives. */\n  omitProperties?: readonly string[];\n  /** Headings an index catalog sorts this pack's primitives under, in order. */\n  groups?: readonly PrimitiveGroup[];\n}\n\n/** A titled set of primitive types, listed together in an index catalog. */\nexport interface PrimitiveGroup {\n  title: string;\n  types: readonly string[];\n}\n\n/**\n * The HTML style-adapter hooks a pack may declare. Typed loosely here so `pack/` does not import `render/`.\n */\nexport type PackStyleAdapter = {\n  /** See {@link PrimitivePackInput.styleCollector}. */\n  styleCollector?: string;\n  /** The hooks of `HTMLStyleAdapter` from `./html`, erased: a fresh collector per render, the context renderers receive, and the stylesheet the collector produced. */\n  createCollector: (...args: never[]) => object;\n  createRenderContext: (...args: never[]) => unknown;\n  renderStyles: (...args: never[]) => string;\n  /**\n   * Whether `handle` belongs to this adapter's stylesheet. Required for a runtime to combine several packs' CSS: without it their handles cannot be routed and the host must pick one adapter.\n   */\n  ownsHandle?: (handle: StyleHandle) => boolean;\n};\n\n/** What a pack author passes to {@link definePrimitivePack}. */\nexport interface PrimitivePackInput {\n  /** Stable identifier, used in capability reports and error messages. */\n  id: string;\n  /**\n   * The optional surfaces this pack's primitives implement.\n   *\n   * Only `slack`, and it stays optional per primitive: the dispatcher converts\n   * the mandatory markdown to Block Kit, so declaring it reports an intent\n   * rather than imposing a requirement. Omit it entirely for a pack that\n   * renders Slack through that fallback.\n   */\n  surfaces?: readonly OptionalSurface[];\n  /** This pack's vocabulary. Node types must be unique within it, or construction throws. */\n  primitives: readonly AnyPrimitiveDefinition[];\n  /**\n   * Progressive enhancements this pack's primitives can apply, by id.\n   *\n   * Declared by the pack because an enhancement is a fact about its\n   * vocabulary — a sortable table, a copyable code block — and a host\n   * composing packs it did not write cannot be expected to know the ids.\n   * The runtime flattens these across packs; duplicate ids are rejected.\n   */\n  enhancements?: readonly EnhancementDefinition[];\n  /**\n   * Types that render as a self-contained picture rather than as text.\n   *\n   * A channel that cannot draw them inline uploads an image instead: the Slack\n   * dispatcher swaps such a node for an `image` block and an upload request, so\n   * a chart arrives as a PNG rather than as a markdown approximation of one.\n   *\n   * Declared by the pack because it is a fact about the vocabulary, and a host\n   * composing packs it did not write cannot be expected to know it.\n   */\n  slackAssetTypes?: readonly string[];\n  /**\n   * Default HTML style adapter for this pack. A runtime that omits\n   * `styleAdapter` runs the packs' own adapters, combined when more than one\n   * pack declares one and each answers `ownsHandle`. Pass `styleAdapter` on\n   * the runtime to replace them all.\n   */\n  styleAdapter?: PackStyleAdapter;\n  /**\n   * Names the collector shape this pack's `collectStyles` hooks mutate, so a\n   * runtime can reject a pack paired with an adapter of a different tag.\n   * Defaults to `styleAdapter.styleCollector`; a pack with neither opts out of\n   * the check.\n   */\n  styleCollector?: string;\n  /**\n   * This pack's own contribution to the runtime's authoring JSON Schema.\n   *\n   * Merged across every composed pack, so a host does not hand-merge each\n   * pack's `describe`/`omitProperties` into one options object itself. The\n   * runtime-level `authoring` option is merged in last and wins on conflict.\n   */\n  authoring?: PackAuthoringOptions;\n}\n\n/**\n * A pack as the runtime sees it.\n *\n * `TTheme` is the palette this pack's `react` renderers read as `env.theme`\n * when drawn through the `snapshot` surface — a *lower bound* on whatever theme\n * the runtime holding it supplies. It is carried by\n * {@link PrimitivePack.__theme} rather than by any real field, because\n * `primitives` is erased to `AnyPrimitiveDefinition[]` and a heterogeneous\n * inventory has no single node type to be generic over.\n *\n * The bound is declared, not derived: nothing checks it against what the\n * renderers actually read. State it at the definition as\n * `definePrimitivePack<T>(input)`.\n * Bare `PrimitivePack` requires nothing and fits any runtime; a slot that must\n * hold packs of every palette is typed {@link AnyPrimitivePack}.\n */\nexport interface PrimitivePack<TTheme = unknown> {\n  /** Unique among the packs a runtime composes, and used in error messages. */\n  readonly id: string;\n  /** See {@link PrimitivePackInput.surfaces}. */\n  readonly surfaces: readonly OptionalSurface[];\n  /** See {@link PrimitivePackInput.primitives}. */\n  readonly primitives: readonly AnyPrimitiveDefinition[];\n  /** Node types this pack owns, for duplicate detection across packs. */\n  readonly types: ReadonlySet<string>;\n  /**\n   * Each primitive's `icon` by type, for the primitives that declare one, so a host listing them need not walk `primitives`.\n   *\n   * A frozen null-prototype dictionary: an absent type reads `undefined`, even `constructor`. Absent on a pack built by an SDK that predates icons; {@link iconsByType} derives it from `primitives`.\n   */\n  readonly icons?: Readonly<Record<string, PrimitiveIcon>>;\n  /** See {@link PrimitivePackInput.enhancements}. */\n  readonly enhancements: readonly EnhancementDefinition[];\n  /** See {@link PrimitivePackInput.slackAssetTypes}. */\n  readonly slackAssetTypes: ReadonlySet<string>;\n  /** See {@link PrimitivePackInput.styleAdapter}. */\n  readonly styleAdapter?: PackStyleAdapter;\n  /** See {@link PrimitivePackInput.styleCollector}. */\n  readonly styleCollector?: string;\n  /** See {@link PrimitivePackInput.authoring}. */\n  readonly authoring?: PackAuthoringOptions;\n  /**\n   * Phantom: never present at runtime, never read.\n   *\n   * A property rather than a method so `strictFunctionTypes` checks it\n   * contravariantly. A method signature is bivariant, which would let a pack\n   * needing richer tokens sit in a slot supplying fewer and then read a field\n   * nothing supplies — the exact failure this marker exists to prevent.\n   */\n  readonly __theme?: (theme: TTheme) => void;\n}\n\n/**\n * A pack of any palette, for storage positions: `never` is assignable to every\n * requirement, so a slot typed this way holds every pack.\n */\nexport type AnyPrimitivePack = PrimitivePack<never>;\n\n/**\n * Builds a {@link PrimitivePack}.\n *\n * `TTheme` is the palette a frame must supply for this pack's nodes to be drawn\n * on the `snapshot` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is\n * `unknown`, which requires nothing.\n */\nexport const definePrimitivePack = <TTheme = unknown>(\n  input: PrimitivePackInput\n): PrimitivePack<TTheme> => {\n  if (input.primitives.length === 0) {\n    throw new IsomerError(\n      'EMPTY_PACK',\n      `primitive pack \"${input.id}\": at least one primitive is required`\n    );\n  }\n  assertUniquePrimitiveTypes(input.id, input.primitives);\n  assertUniqueEnhancementIds(input.id, input.enhancements ?? []);\n  const types = new Set(input.primitives.map((definition) => definition.type));\n  assertGroupedOnce(input.id, input.authoring?.groups ?? [], types);\n  for (const type of input.slackAssetTypes ?? []) {\n    if (!types.has(type)) {\n      throw new IsomerError(\n        'UNKNOWN_PRIMITIVE_TYPE',\n        `primitive pack \"${input.id}\": slackAssetTypes names primitive type \"${type}\", which the pack does not register`\n      );\n    }\n  }\n  const styleCollector =\n    input.styleCollector ?? input.styleAdapter?.styleCollector;\n\n  return {\n    id: input.id,\n    surfaces: input.surfaces ?? [],\n    primitives: input.primitives,\n    types,\n    icons: iconsByType(input.primitives),\n    enhancements: input.enhancements ?? [],\n    slackAssetTypes: new Set(input.slackAssetTypes ?? []),\n    ...(input.styleAdapter !== undefined\n      ? { styleAdapter: input.styleAdapter }\n      : {}),\n    ...(styleCollector !== undefined ? { styleCollector } : {}),\n    ...(input.authoring !== undefined ? { authoring: input.authoring } : {}),\n  };\n};\n\n/** Each definition's `icon` by type, null-prototype so a type such as `__proto__` is an ordinary key. */\nexport const iconsByType = (\n  primitives: readonly AnyPrimitiveDefinition[]\n): Readonly<Record<string, PrimitiveIcon>> => {\n  const icons = Object.create(null) as Record<string, PrimitiveIcon>;\n  for (const { type, icon } of primitives) {\n    if (icon !== undefined) {\n      icons[type] = icon;\n    }\n  }\n  return Object.freeze(icons);\n};\n\n/** Throws if `primitives` repeats a type. */\nconst assertUniquePrimitiveTypes = (\n  id: string,\n  primitives: readonly AnyPrimitiveDefinition[]\n): void => {\n  const seen = new Set<string>();\n  for (const { type } of primitives) {\n    if (seen.has(type)) {\n      throw new IsomerError(\n        'DUPLICATE_PRIMITIVE_TYPE',\n        `primitive pack \"${id}\": primitive type \"${type}\" registered twice`\n      );\n    }\n    seen.add(type);\n  }\n};\n\n/** Throws if a group names a type outside `types`, or two groups share a type. */\nconst assertGroupedOnce = (\n  id: string,\n  groups: readonly PrimitiveGroup[],\n  types: ReadonlySet<string>\n): void => {\n  const grouped = new Set<string>();\n  for (const { title, types: members } of groups) {\n    for (const type of members) {\n      if (!types.has(type)) {\n        throw new IsomerError(\n          'UNKNOWN_PRIMITIVE_TYPE',\n          `primitive pack \"${id}\": group \"${title}\" names primitive type \"${type}\", which the pack does not register`\n        );\n      }\n      if (grouped.has(type)) {\n        throw new IsomerError(\n          'DUPLICATE_PRIMITIVE_TYPE',\n          `primitive pack \"${id}\": primitive type \"${type}\" is in two groups`\n        );\n      }\n      grouped.add(type);\n    }\n  }\n};\n\n/** Throws if this pack registers the same enhancement id twice. */\nconst assertUniqueEnhancementIds = (\n  id: string,\n  enhancements: readonly EnhancementDefinition[]\n): void => {\n  const seen = new Set<string>();\n  for (const definition of enhancements) {\n    if (seen.has(definition.id)) {\n      throw new IsomerError(\n        'DUPLICATE_ENHANCEMENT',\n        `primitive pack \"${id}\": enhancement \"${definition.id}\" registered twice`\n      );\n    }\n    seen.add(definition.id);\n  }\n};\n"]}

package/dist/render/anchors.d.ts

@@ -32,7 +32,7 @@ export declare const withNodeAnchors: <TContext>(context: TContext) => TContext;
 /**
  * Props a `react` renderer spreads on its root element so runtime code can find
  * the node with {@link findNodeElementPairs}. Inside an HTML surface render the
- * surface decides; elsewhere, on the React and `svg` surfaces, `context.anchors`
+ * surface decides; elsewhere, on the React and `snapshot` surfaces, `context.anchors`
  * does. Always empty under {@link withoutAnchors}.
  */
 export declare const nodeAnchor: (context: unknown, { type }: {
@@ -51,7 +51,7 @@ export declare const layoutRoom: (context: unknown) => Readonly<Record<string, s
  * path in validation's `body[0].items[1]` form. Nested nodes follow `react`,
  * as a container renders them through `renderReact` on either surface.
  */
-export declare const anchoredNodePaths: (body: readonly unknown[], walk: ChildNodeWalker, surface?: "react" | "svg") => {
+export declare const anchoredNodePaths: (body: readonly unknown[], walk: ChildNodeWalker, surface?: "react" | "snapshot") => {
     node: unknown;
     path: string;
 }[];

package/dist/render/anchors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../src/render/anchors.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AAIvC,2GAA2G;AAC3G,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MACmC,CAAC;AAgB/E;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,EACjC,IAAI,OAAO,EACX,QAAQ,MAAM,OAAO,KACpB,OAaF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,EAAE,SAAS,QAAQ,KAAG,QACrB,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,EAAE,SAAS,QAAQ,KAAG,QACvB,CAAC;AAaxC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,OAAO,EAChB,UAAU;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KACzB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACwC,CAAC;AAE3E,6CAA6C;AAC7C,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,OAAO,KACf,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACyB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,SAAS,OAAO,EAAE,EACxB,MAAM,eAAe,EACrB,UAAS,OAAO,GAAG,KAAe,KACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAejC,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,aAAa,GACxB,MAAM,SAAS,OAAO,EAAE,EACxB,MAAM,eAAe,KACpB,OAAO,EAA2D,CAAC;AAEtE,wCAAwC;AACxC,eAAO,MAAM,QAAQ,GAAI,MAAM,OAAO,KAAG,MAAM,GAAG,SAGjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,EAC/B,UAAU,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,EACzD,OAAO,SAAS,OAAO,EAAE,KACxB,CAAC,KAAK,GAAG,SAAS,CAAC,EAyBrB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,UAAU,EAChB,MAAM,SAAS,OAAO,EAAE,EACxB,MAAM,eAAe,KACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,EAYjD,CAAC"}
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../src/render/anchors.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AAIvC,2GAA2G;AAC3G,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MACmC,CAAC;AAgB/E;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,EACjC,IAAI,OAAO,EACX,QAAQ,MAAM,OAAO,KACpB,OAaF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,EAAE,SAAS,QAAQ,KAAG,QACrB,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,EAAE,SAAS,QAAQ,KAAG,QACvB,CAAC;AAaxC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,OAAO,EAChB,UAAU;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KACzB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACwC,CAAC;AAE3E,6CAA6C;AAC7C,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,OAAO,KACf,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACyB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,SAAS,OAAO,EAAE,EACxB,MAAM,eAAe,EACrB,UAAS,OAAO,GAAG,UAAoB,KACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAejC,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,aAAa,GACxB,MAAM,SAAS,OAAO,EAAE,EACxB,MAAM,eAAe,KACpB,OAAO,EAA2D,CAAC;AAEtE,wCAAwC;AACxC,eAAO,MAAM,QAAQ,GAAI,MAAM,OAAO,KAAG,MAAM,GAAG,SAGjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,EAC/B,UAAU,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,EACzD,OAAO,SAAS,OAAO,EAAE,KACxB,CAAC,KAAK,GAAG,SAAS,CAAC,EAyBrB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,UAAU,EAChB,MAAM,SAAS,OAAO,EAAE,EACxB,MAAM,eAAe,KACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,EAYjD,CAAC"}

package/dist/render/anchors.js

@@ -70,7 +70,7 @@ const anchorsOn = (context) => {
 /**
  * Props a `react` renderer spreads on its root element so runtime code can find
  * the node with {@link findNodeElementPairs}. Inside an HTML surface render the
- * surface decides; elsewhere, on the React and `svg` surfaces, `context.anchors`
+ * surface decides; elsewhere, on the React and `snapshot` surfaces, `context.anchors`
  * does. Always empty under {@link withoutAnchors}.
  */
 export const nodeAnchor = (context, { type }) => anchorsOn(context) ? { [NODE_ANCHOR_ATTRIBUTE]: anchorValue(type) } : {};

package/dist/render/anchors.js.map

@@ -1 +1 @@
-{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../src/render/anchors.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\n  childNodePath,\n  type ChildNodeWalker,\n  isVisibleOnSurface,\n} from '../composition/body_node_base';\n\nimport { contextWith, isObjectLike } from './context_view';\n\n/** The attribute {@link nodeAnchor} sets to a node's type, escaped so HTML parsing leaves it unchanged. */\nexport const NODE_ANCHOR_ATTRIBUTE = 'data-isomer-node';\n\n/**\n * A node type as its anchor carries it. Every character outside `[A-Za-z0-9_-]`\n * becomes `%<hex code point>;`, so the value survives HTML serialization and\n * parsing unchanged and never throws. A plain identifier stays as it is.\n */\nexport const anchorValue = (type: string): string =>\n  type.replace(/[^\\w-]/gu, (char) => `%${char.codePointAt(0)!.toString(16)};`);\n\n/** Marks a context whose subtree renders no anchors; see {@link withoutAnchors}. */\nconst NO_ANCHORS = Symbol.for('elastic.isomer.anchors_off');\n\n/**\n * Where an HTML render keeps its anchor decision while it runs. On `globalThis`\n * under a `Symbol.for` key, so an ESM and a CommonJS copy of the SDK share it.\n */\nconst ACTIVE = Symbol.for('elastic.isomer.anchors_active');\n\ntype AnchorScope = { [ACTIVE]?: boolean };\n\nconst activeAnchors = (): boolean | undefined =>\n  (globalThis as AnchorScope)[ACTIVE];\n\n/**\n * Runs `render` with anchors on or off for every {@link nodeAnchor} it reaches,\n * whatever each render context says. The render must be synchronous; the\n * previous state comes back afterwards, even if it throws.\n */\nexport const withAnchors = <TResult>(\n  on: boolean,\n  render: () => TResult\n): TResult => {\n  const scope = globalThis as AnchorScope;\n  const outer = scope[ACTIVE];\n  scope[ACTIVE] = on;\n  try {\n    return render();\n  } finally {\n    if (outer === undefined) {\n      delete scope[ACTIVE];\n    } else {\n      scope[ACTIVE] = outer;\n    }\n  }\n};\n\n/**\n * `context` for content a renderer draws that is not one of its `children`,\n * such as an embedded composition: nothing under it renders an anchor.\n *\n * The result is a view of `context`, not a copy: reads go to `context` itself,\n * with methods bound to it, so getters, methods, private state, and\n * `instanceof` behave as before. The mark survives a context derived from it\n * by spreading. A context that is neither an object nor a function is\n * returned as it is.\n */\nexport const withoutAnchors = <TContext>(context: TContext): TContext =>\n  contextWith(context, NO_ANCHORS, true);\n\n/**\n * `context` with node anchors on, as an enhancement declaring `anchors: true`\n * turns them on. A view like {@link withoutAnchors}, which still wins.\n */\nexport const withNodeAnchors = <TContext>(context: TContext): TContext =>\n  contextWith(context, 'anchors', true);\n\nconst anchorsOn = (context: unknown): boolean => {\n  const carries = isObjectLike(context);\n  if (carries && Reflect.get(context, NO_ANCHORS) === true) {\n    return false;\n  }\n  return (\n    activeAnchors() ??\n    (carries && (context as { anchors?: unknown }).anchors === true)\n  );\n};\n\n/**\n * Props a `react` renderer spreads on its root element so runtime code can find\n * the node with {@link findNodeElementPairs}. Inside an HTML surface render the\n * surface decides; elsewhere, on the React and `svg` surfaces, `context.anchors`\n * does. Always empty under {@link withoutAnchors}.\n */\nexport const nodeAnchor = (\n  context: unknown,\n  { type }: { type: string }\n): Readonly<Record<string, string>> =>\n  anchorsOn(context) ? { [NODE_ANCHOR_ATTRIBUTE]: anchorValue(type) } : {};\n\n/** The attribute {@link layoutRoom} sets. */\nexport const LAYOUT_ROOM_ATTRIBUTE = 'data-isomer-room';\n\n/**\n * Props a renderer spreads on an element inside its node that bounds the nodes\n * nested in it, such as a frame's body, so `checkLayout` measures them against\n * it. Rendered when {@link nodeAnchor} would be.\n */\nexport const layoutRoom = (\n  context: unknown\n): Readonly<Record<string, string>> =>\n  anchorsOn(context) ? { [LAYOUT_ROOM_ATTRIBUTE]: '' } : {};\n\n/**\n * The nodes of `body` a render on `surface` draws, pre-order, each with its\n * path in validation's `body[0].items[1]` form. Nested nodes follow `react`,\n * as a container renders them through `renderReact` on either surface.\n */\nexport const anchoredNodePaths = (\n  body: readonly unknown[],\n  walk: ChildNodeWalker,\n  surface: 'react' | 'svg' = 'react'\n): { node: unknown; path: string }[] => {\n  const visit = (\n    node: unknown,\n    path: string\n  ): { node: unknown; path: string }[] => [\n    { node, path },\n    ...walk(node).flatMap((child) =>\n      isVisibleOnSurface(child.node, 'react')\n        ? visit(child.node, childNodePath(path, child.path))\n        : []\n    ),\n  ];\n  return body.flatMap((node, index) =>\n    isVisibleOnSurface(node, surface) ? visit(node, `body[${index}]`) : []\n  );\n};\n\n/** The `react`-visible nodes of `body`, pre-order: the order their anchors render in. */\nexport const anchoredNodes = (\n  body: readonly unknown[],\n  walk: ChildNodeWalker\n): unknown[] => anchoredNodePaths(body, walk).map(({ node }) => node);\n\n/** A node's `type`, when it has one. */\nexport const nodeType = (node: unknown): string | undefined => {\n  const { type } = node as { type?: unknown };\n  return typeof type === 'string' ? type : undefined;\n};\n\n/**\n * The item each of `nodes` pairs with, from `anchored` in document order: the\n * k-th node of a type pairs with the k-th item whose anchor value is that\n * type's. A type whose node and item counts disagree pairs with nothing.\n */\nexport const pairAnchors = <TItem>(\n  anchored: Iterable<readonly [value: string, item: TItem]>,\n  nodes: readonly unknown[]\n): (TItem | undefined)[] => {\n  const itemsByValue = new Map<string, TItem[]>();\n  for (const [value, item] of anchored) {\n    const items = itemsByValue.get(value) ?? [];\n    items.push(item);\n    itemsByValue.set(value, items);\n  }\n  const counts = new Map<string, number>();\n  for (const node of nodes) {\n    const type = nodeType(node);\n    if (type !== undefined) {\n      counts.set(type, (counts.get(type) ?? 0) + 1);\n    }\n  }\n  const seen = new Map<string, number>();\n  return nodes.map((node) => {\n    const type = nodeType(node);\n    if (type === undefined) {\n      return undefined;\n    }\n    const index = seen.get(type) ?? 0;\n    seen.set(type, index + 1);\n    const items = itemsByValue.get(anchorValue(type)) ?? [];\n    return items.length === counts.get(type) ? items[index] : undefined;\n  });\n};\n\n/**\n * Every `react`-visible node of `body`, walked pre-order, with the element\n * its anchor marks under `root`, paired by {@link pairAnchors}. `root` holds\n * one render.\n *\n * Pairing holds because every renderer draws its `children` in the order its\n * definition's `children` returns them. A node that rendered nothing leaves\n * its type unpaired. A node object that appears twice appears twice here,\n * each time with its own element.\n */\nexport const findNodeElementPairs = (\n  root: ParentNode,\n  body: readonly unknown[],\n  walk: ChildNodeWalker\n): { node: unknown; element: Element | undefined }[] => {\n  const nodes = anchoredNodes(body, walk);\n  // Read by attribute value, so a type is never read as selector syntax.\n  const elements = pairAnchors(\n    Array.from(\n      root.querySelectorAll(`[${NODE_ANCHOR_ATTRIBUTE}]`),\n      (element) =>\n        [element.getAttribute(NODE_ANCHOR_ATTRIBUTE) ?? '', element] as const\n    ),\n    nodes\n  );\n  return nodes.map((node, index) => ({ node, element: elements[index] }));\n};\n"]}
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../src/render/anchors.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\n  childNodePath,\n  type ChildNodeWalker,\n  isVisibleOnSurface,\n} from '../composition/body_node_base';\n\nimport { contextWith, isObjectLike } from './context_view';\n\n/** The attribute {@link nodeAnchor} sets to a node's type, escaped so HTML parsing leaves it unchanged. */\nexport const NODE_ANCHOR_ATTRIBUTE = 'data-isomer-node';\n\n/**\n * A node type as its anchor carries it. Every character outside `[A-Za-z0-9_-]`\n * becomes `%<hex code point>;`, so the value survives HTML serialization and\n * parsing unchanged and never throws. A plain identifier stays as it is.\n */\nexport const anchorValue = (type: string): string =>\n  type.replace(/[^\\w-]/gu, (char) => `%${char.codePointAt(0)!.toString(16)};`);\n\n/** Marks a context whose subtree renders no anchors; see {@link withoutAnchors}. */\nconst NO_ANCHORS = Symbol.for('elastic.isomer.anchors_off');\n\n/**\n * Where an HTML render keeps its anchor decision while it runs. On `globalThis`\n * under a `Symbol.for` key, so an ESM and a CommonJS copy of the SDK share it.\n */\nconst ACTIVE = Symbol.for('elastic.isomer.anchors_active');\n\ntype AnchorScope = { [ACTIVE]?: boolean };\n\nconst activeAnchors = (): boolean | undefined =>\n  (globalThis as AnchorScope)[ACTIVE];\n\n/**\n * Runs `render` with anchors on or off for every {@link nodeAnchor} it reaches,\n * whatever each render context says. The render must be synchronous; the\n * previous state comes back afterwards, even if it throws.\n */\nexport const withAnchors = <TResult>(\n  on: boolean,\n  render: () => TResult\n): TResult => {\n  const scope = globalThis as AnchorScope;\n  const outer = scope[ACTIVE];\n  scope[ACTIVE] = on;\n  try {\n    return render();\n  } finally {\n    if (outer === undefined) {\n      delete scope[ACTIVE];\n    } else {\n      scope[ACTIVE] = outer;\n    }\n  }\n};\n\n/**\n * `context` for content a renderer draws that is not one of its `children`,\n * such as an embedded composition: nothing under it renders an anchor.\n *\n * The result is a view of `context`, not a copy: reads go to `context` itself,\n * with methods bound to it, so getters, methods, private state, and\n * `instanceof` behave as before. The mark survives a context derived from it\n * by spreading. A context that is neither an object nor a function is\n * returned as it is.\n */\nexport const withoutAnchors = <TContext>(context: TContext): TContext =>\n  contextWith(context, NO_ANCHORS, true);\n\n/**\n * `context` with node anchors on, as an enhancement declaring `anchors: true`\n * turns them on. A view like {@link withoutAnchors}, which still wins.\n */\nexport const withNodeAnchors = <TContext>(context: TContext): TContext =>\n  contextWith(context, 'anchors', true);\n\nconst anchorsOn = (context: unknown): boolean => {\n  const carries = isObjectLike(context);\n  if (carries && Reflect.get(context, NO_ANCHORS) === true) {\n    return false;\n  }\n  return (\n    activeAnchors() ??\n    (carries && (context as { anchors?: unknown }).anchors === true)\n  );\n};\n\n/**\n * Props a `react` renderer spreads on its root element so runtime code can find\n * the node with {@link findNodeElementPairs}. Inside an HTML surface render the\n * surface decides; elsewhere, on the React and `snapshot` surfaces, `context.anchors`\n * does. Always empty under {@link withoutAnchors}.\n */\nexport const nodeAnchor = (\n  context: unknown,\n  { type }: { type: string }\n): Readonly<Record<string, string>> =>\n  anchorsOn(context) ? { [NODE_ANCHOR_ATTRIBUTE]: anchorValue(type) } : {};\n\n/** The attribute {@link layoutRoom} sets. */\nexport const LAYOUT_ROOM_ATTRIBUTE = 'data-isomer-room';\n\n/**\n * Props a renderer spreads on an element inside its node that bounds the nodes\n * nested in it, such as a frame's body, so `checkLayout` measures them against\n * it. Rendered when {@link nodeAnchor} would be.\n */\nexport const layoutRoom = (\n  context: unknown\n): Readonly<Record<string, string>> =>\n  anchorsOn(context) ? { [LAYOUT_ROOM_ATTRIBUTE]: '' } : {};\n\n/**\n * The nodes of `body` a render on `surface` draws, pre-order, each with its\n * path in validation's `body[0].items[1]` form. Nested nodes follow `react`,\n * as a container renders them through `renderReact` on either surface.\n */\nexport const anchoredNodePaths = (\n  body: readonly unknown[],\n  walk: ChildNodeWalker,\n  surface: 'react' | 'snapshot' = 'react'\n): { node: unknown; path: string }[] => {\n  const visit = (\n    node: unknown,\n    path: string\n  ): { node: unknown; path: string }[] => [\n    { node, path },\n    ...walk(node).flatMap((child) =>\n      isVisibleOnSurface(child.node, 'react')\n        ? visit(child.node, childNodePath(path, child.path))\n        : []\n    ),\n  ];\n  return body.flatMap((node, index) =>\n    isVisibleOnSurface(node, surface) ? visit(node, `body[${index}]`) : []\n  );\n};\n\n/** The `react`-visible nodes of `body`, pre-order: the order their anchors render in. */\nexport const anchoredNodes = (\n  body: readonly unknown[],\n  walk: ChildNodeWalker\n): unknown[] => anchoredNodePaths(body, walk).map(({ node }) => node);\n\n/** A node's `type`, when it has one. */\nexport const nodeType = (node: unknown): string | undefined => {\n  const { type } = node as { type?: unknown };\n  return typeof type === 'string' ? type : undefined;\n};\n\n/**\n * The item each of `nodes` pairs with, from `anchored` in document order: the\n * k-th node of a type pairs with the k-th item whose anchor value is that\n * type's. A type whose node and item counts disagree pairs with nothing.\n */\nexport const pairAnchors = <TItem>(\n  anchored: Iterable<readonly [value: string, item: TItem]>,\n  nodes: readonly unknown[]\n): (TItem | undefined)[] => {\n  const itemsByValue = new Map<string, TItem[]>();\n  for (const [value, item] of anchored) {\n    const items = itemsByValue.get(value) ?? [];\n    items.push(item);\n    itemsByValue.set(value, items);\n  }\n  const counts = new Map<string, number>();\n  for (const node of nodes) {\n    const type = nodeType(node);\n    if (type !== undefined) {\n      counts.set(type, (counts.get(type) ?? 0) + 1);\n    }\n  }\n  const seen = new Map<string, number>();\n  return nodes.map((node) => {\n    const type = nodeType(node);\n    if (type === undefined) {\n      return undefined;\n    }\n    const index = seen.get(type) ?? 0;\n    seen.set(type, index + 1);\n    const items = itemsByValue.get(anchorValue(type)) ?? [];\n    return items.length === counts.get(type) ? items[index] : undefined;\n  });\n};\n\n/**\n * Every `react`-visible node of `body`, walked pre-order, with the element\n * its anchor marks under `root`, paired by {@link pairAnchors}. `root` holds\n * one render.\n *\n * Pairing holds because every renderer draws its `children` in the order its\n * definition's `children` returns them. A node that rendered nothing leaves\n * its type unpaired. A node object that appears twice appears twice here,\n * each time with its own element.\n */\nexport const findNodeElementPairs = (\n  root: ParentNode,\n  body: readonly unknown[],\n  walk: ChildNodeWalker\n): { node: unknown; element: Element | undefined }[] => {\n  const nodes = anchoredNodes(body, walk);\n  // Read by attribute value, so a type is never read as selector syntax.\n  const elements = pairAnchors(\n    Array.from(\n      root.querySelectorAll(`[${NODE_ANCHOR_ATTRIBUTE}]`),\n      (element) =>\n        [element.getAttribute(NODE_ANCHOR_ATTRIBUTE) ?? '', element] as const\n    ),\n    nodes\n  );\n  return nodes.map((node, index) => ({ node, element: elements[index] }));\n};\n"]}

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

@@ -43,7 +43,7 @@ export interface HTMLRenderOptions {
     anchors?: boolean;
     /**
      * Resolves `light-dark(…)` in the stylesheet to one scheme's value. A browser
-     * resolves it itself; an image is one static frame, so the `svg` surface sets
+     * resolves it itself; an image is one static frame, so the `snapshot` surface sets
      * it.
      */
     scheme?: 'light' | 'dark';
@@ -113,8 +113,8 @@ export interface HTMLStyleAdapter<TNode extends PrimitiveNode = PrimitiveNode, T
     resolveOptions?(composition: Composition<TNode>, options: HTMLRenderOptions): HTMLRenderOptions;
     /**
      * The `.isomer` / `.isomer.framed` / `.isomer.fluid` rules around a rendered composition.
-     * Named for the wrapper rather than the frame, which the sdk reserves for a
-     * pack's svg document surround.
+     * Named for the wrapper rather than the frame, which the sdk reserves for the
+     * document a snapshot is drawn inside.
      */
     collectWrapperStyles?(collector: TCollector, options: HTMLRenderOptions): void;
     /** Walks the body into the collector, usually through {@link HTMLRenderDispatcher.collectStyles}. Runs before any markup exists. */