@elastic/isomer-sdk 0.1.0 → 0.3.0

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';
 /**
@@ -13,7 +14,7 @@ export interface PackAuthoringOptions {
     describe?: Readonly<Record<string, string>>;
     /** `$defId.property` paths to drop, from this pack's own primitives. */
     omitProperties?: readonly string[];
-    /** Headings an index catalog sorts this pack's primitives under, in order. */
+    /** Headings an index catalog sorts this pack's primitives under, in order. A type in none is listed under {@link UNCATEGORIZED_GROUP_TITLE}. */
     groups?: readonly PrimitiveGroup[];
 }
 /** A titled set of primitive types, listed together in an index catalog. */
@@ -21,6 +22,8 @@ export interface PrimitiveGroup {
     title: string;
     types: readonly string[];
 }
+/** The index heading for primitives in no group. A pack cannot declare a group with this title. */
+export declare const UNCATEGORIZED_GROUP_TITLE = "Uncategorized";
 /**
  * The HTML style-adapter hooks a pack may declare. Typed loosely here so `pack/` does not import `render/`.
  */
@@ -98,7 +101,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 +122,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 +157,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

@@ -8,11 +8,13 @@
 // primitive in it implements. Additive: a runtime composes any number of packs,
 // and nothing about a pack decides how a composition is framed.
 import { IsomerError } from '../composition/error.js';
+/** The index heading for primitives in no group. A pack cannot declare a group with this title. */
+export const UNCATEGORIZED_GROUP_TITLE = 'Uncategorized';
 /**
  * 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) => {
@@ -22,7 +24,7 @@ export const definePrimitivePack = (input) => {
     assertUniquePrimitiveTypes(input.id, input.primitives);
     assertUniqueEnhancementIds(input.id, input.enhancements ?? []);
     const types = new Set(input.primitives.map((definition) => definition.type));
-    assertGroupedOnce(input.id, input.authoring?.groups ?? [], types);
+    assertValidGroups(input.id, input.authoring?.groups ?? [], types);
     for (const type of input.slackAssetTypes ?? []) {
         if (!types.has(type)) {
             throw new IsomerError('UNKNOWN_PRIMITIVE_TYPE', `primitive pack "${input.id}": slackAssetTypes names primitive type "${type}", which the pack does not register`);
@@ -34,6 +36,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 +46,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();
@@ -53,10 +66,18 @@ const assertUniquePrimitiveTypes = (id, primitives) => {
         seen.add(type);
     }
 };
-/** Throws if a group names a type outside `types`, or two groups share a type. */
-const assertGroupedOnce = (id, groups, types) => {
+/** Throws if a group repeats or reserves a title, names a type outside `types`, or shares a type with another. */
+const assertValidGroups = (id, groups, types) => {
+    const titles = new Set();
     const grouped = new Set();
     for (const { title, types: members } of groups) {
+        if (title === UNCATEGORIZED_GROUP_TITLE) {
+            throw new IsomerError('INVALID_PACK_GROUPS', `primitive pack "${id}": group title "${title}" is reserved for primitives in no group`);
+        }
+        if (titles.has(title)) {
+            throw new IsomerError('INVALID_PACK_GROUPS', `primitive pack "${id}": group title "${title}" is used twice`);
+        }
+        titles.add(title);
         for (const type of members) {
             if (!types.has(type)) {
                 throw new IsomerError('UNKNOWN_PRIMITIVE_TYPE', `primitive pack "${id}": group "${title}" names primitive type "${type}", which the pack does not register`);

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. A type in none is listed under {@link UNCATEGORIZED_GROUP_TITLE}. */\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/** The index heading for primitives in no group. A pack cannot declare a group with this title. */\nexport const UNCATEGORIZED_GROUP_TITLE = 'Uncategorized';\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  assertValidGroups(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 repeats or reserves a title, names a type outside `types`, or shares a type with another. */\nconst assertValidGroups = (\n  id: string,\n  groups: readonly PrimitiveGroup[],\n  types: ReadonlySet<string>\n): void => {\n  const titles = new Set<string>();\n  const grouped = new Set<string>();\n  for (const { title, types: members } of groups) {\n    if (title === UNCATEGORIZED_GROUP_TITLE) {\n      throw new IsomerError(\n        'INVALID_PACK_GROUPS',\n        `primitive pack \"${id}\": group title \"${title}\" is reserved for primitives in no group`\n      );\n    }\n    if (titles.has(title)) {\n      throw new IsomerError(\n        'INVALID_PACK_GROUPS',\n        `primitive pack \"${id}\": group title \"${title}\" is used twice`\n      );\n    }\n    titles.add(title);\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/format_number.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format_number.d.ts","sourceRoot":"","sources":["../../src/render/format_number.ts"],"names":[],"mappings":"AAyBA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,EACb,aAAS,EACT,kBAAa,KACZ,MAeF,CAAC"}
+{"version":3,"file":"format_number.d.ts","sourceRoot":"","sources":["../../src/render/format_number.ts"],"names":[],"mappings":"AAyBA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,EACb,aAAS,EACT,kBAAa,KACZ,MAiBF,CAAC"}

package/dist/render/format_number.js

@@ -28,8 +28,9 @@ const trimDecimal = (value, precision) => Number.isInteger(value)
 export const formatCompactNumber = (value, unit = '', precision = 1) => {
     const abs = Math.abs(value);
     let index = TIERS.findIndex(({ size }) => abs >= size);
-    if (index === -1)
+    if (index === -1) {
         index = TIERS.length - 1;
+    }
     // A value that rounds up to the tier's next power, `999.96k`, reads as `1m`.
     if (index > 0 &&
         Math.abs(Number((value / TIERS[index].size).toFixed(precision))) >= 1_000) {

package/dist/render/format_number.js.map

@@ -1 +1 @@
-{"version":3,"file":"format_number.js","sourceRoot":"","sources":["../../src/render/format_number.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,6EAA6E;AAC7E,2BAA2B;AAE3B,MAAM,KAAK,GAAG;IACZ,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,EAAE;IACxC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;IACpC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;IAChC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;IAC5B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;CACf,CAAC;AAEX,2DAA2D;AAC3D,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,SAAiB,EAAU,EAAE,CAC/D,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;IACrB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IACf,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAa,EACb,IAAI,GAAG,EAAE,EACT,SAAS,GAAG,CAAC,EACL,EAAE;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACvD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,6EAA6E;IAC7E,IACE,KAAK,GAAG,CAAC;QACT,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,EAC1E,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;IACvC,MAAM,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,GAAG,IAAI,EAAE,SAAS,CAAC,GAAG,MAAM,EAAE,CAAC;IAElE,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;AAC7E,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// Compact numeric formatting, shared by anything that has to fit a number into\n// a small space — chart axis labels, a `compact` structured display value, a\n// text-surface trend line.\n\nconst TIERS = [\n  { size: 1_000_000_000_000, suffix: 't' },\n  { size: 1_000_000_000, suffix: 'b' },\n  { size: 1_000_000, suffix: 'm' },\n  { size: 1_000, suffix: 'k' },\n  { size: 1, suffix: '' },\n] as const;\n\n// Rounded to `precision` decimals, trailing zeros dropped.\nconst trimDecimal = (value: number, precision: number): string =>\n  Number.isInteger(value)\n    ? String(value)\n    : String(Number(value.toFixed(precision)));\n\n/**\n * `1_284` to `1.3k`, `18_200_000` to `18.2m`, through `b` and `t`, with an\n * optional unit appended. `precision` is the decimals kept, `1` by default.\n *\n * `%` joins without a space because \"99.2 %\" reads wrong; every other unit gets\n * one.\n */\nexport const formatCompactNumber = (\n  value: number,\n  unit = '',\n  precision = 1\n): string => {\n  const abs = Math.abs(value);\n  let index = TIERS.findIndex(({ size }) => abs >= size);\n  if (index === -1) index = TIERS.length - 1;\n  // A value that rounds up to the tier's next power, `999.96k`, reads as `1m`.\n  if (\n    index > 0 &&\n    Math.abs(Number((value / TIERS[index]!.size).toFixed(precision))) >= 1_000\n  ) {\n    index -= 1;\n  }\n  const { size, suffix } = TIERS[index]!;\n  const scaled = `${trimDecimal(value / size, precision)}${suffix}`;\n\n  return unit === '' ? scaled : `${scaled}${unit === '%' ? '' : ' '}${unit}`;\n};\n"]}
+{"version":3,"file":"format_number.js","sourceRoot":"","sources":["../../src/render/format_number.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,6EAA6E;AAC7E,2BAA2B;AAE3B,MAAM,KAAK,GAAG;IACZ,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,EAAE;IACxC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;IACpC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;IAChC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;IAC5B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;CACf,CAAC;AAEX,2DAA2D;AAC3D,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,SAAiB,EAAU,EAAE,CAC/D,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;IACrB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IACf,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAa,EACb,IAAI,GAAG,EAAE,EACT,SAAS,GAAG,CAAC,EACL,EAAE;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACvD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,6EAA6E;IAC7E,IACE,KAAK,GAAG,CAAC;QACT,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,EAC1E,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;IACvC,MAAM,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,GAAG,IAAI,EAAE,SAAS,CAAC,GAAG,MAAM,EAAE,CAAC;IAElE,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;AAC7E,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// Compact numeric formatting, shared by anything that has to fit a number into\n// a small space — chart axis labels, a `compact` structured display value, a\n// text-surface trend line.\n\nconst TIERS = [\n  { size: 1_000_000_000_000, suffix: 't' },\n  { size: 1_000_000_000, suffix: 'b' },\n  { size: 1_000_000, suffix: 'm' },\n  { size: 1_000, suffix: 'k' },\n  { size: 1, suffix: '' },\n] as const;\n\n// Rounded to `precision` decimals, trailing zeros dropped.\nconst trimDecimal = (value: number, precision: number): string =>\n  Number.isInteger(value)\n    ? String(value)\n    : String(Number(value.toFixed(precision)));\n\n/**\n * `1_284` to `1.3k`, `18_200_000` to `18.2m`, through `b` and `t`, with an\n * optional unit appended. `precision` is the decimals kept, `1` by default.\n *\n * `%` joins without a space because \"99.2 %\" reads wrong; every other unit gets\n * one.\n */\nexport const formatCompactNumber = (\n  value: number,\n  unit = '',\n  precision = 1\n): string => {\n  const abs = Math.abs(value);\n  let index = TIERS.findIndex(({ size }) => abs >= size);\n  if (index === -1) {\n    index = TIERS.length - 1;\n  }\n  // A value that rounds up to the tier's next power, `999.96k`, reads as `1m`.\n  if (\n    index > 0 &&\n    Math.abs(Number((value / TIERS[index]!.size).toFixed(precision))) >= 1_000\n  ) {\n    index -= 1;\n  }\n  const { size, suffix } = TIERS[index]!;\n  const scaled = `${trimDecimal(value / size, precision)}${suffix}`;\n\n  return unit === '' ? scaled : `${scaled}${unit === '%' ? '' : ' '}${unit}`;\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. */

package/dist/render/html/envelope.js

@@ -108,8 +108,9 @@ export const renderHTMLWithDispatcher = (input, { dispatcher, validate = createC
 const embedCss = (css) => css.replace(/<\/(?=style)/gi, '<\\/');
 // Tagged templates observe raw spelling and reuse the same frozen object per site.
 const embedJs = (js) => {
-    if (!/<\/script|<!--/i.test(js))
+    if (!/<\/script|<!--/i.test(js)) {
         return js;
+    }
     const comments = [];
     const tree = parse(js, { ecmaVersion: 'latest', onComment: comments });
     const sites = [];
@@ -117,11 +118,13 @@ const embedJs = (js) => {
     const pending = [tree];
     while (pending.length) {
         const node = pending.pop();
-        if (node.type === 'Identifier' && node.name)
+        if (node.type === 'Identifier' && node.name) {
             identifiers.add(node.name);
+        }
         if (node.type === 'TaggedTemplateExpression' &&
-            node.quasi.quasis.some(({ value: { raw } }) => /<\/script|<!--/i.test(raw)))
+            node.quasi.quasis.some(({ value: { raw } }) => /<\/script|<!--/i.test(raw))) {
             sites.push(node);
+        }
         for (const value of Object.values(node)) {
             for (const child of Array.isArray(value) ? value : [value]) {
                 if (child &&
@@ -135,8 +138,9 @@ const embedJs = (js) => {
     }
     sites.sort((a, b) => a.start - b.start);
     let prefix = '__isomerTemplate';
-    while ([...identifiers].some((name) => name.startsWith(prefix)))
+    while ([...identifiers].some((name) => name.startsWith(prefix))) {
         prefix += '_';
+    }
     const literal = (value) => value === null ? 'void 0' : JSON.stringify(value).replace(/</g, '\\u003c');
     const rewrite = (start, end) => {
         let cursor = start;
@@ -152,8 +156,9 @@ const embedJs = (js) => {
                 .map((comment) => ({ ...comment, index: -1, comment: comment.value })),
         ].sort((a, b) => a.start - b.start);
         for (const edit of edits) {
-            if (edit.start < cursor || edit.end > end)
+            if (edit.start < cursor || edit.end > end) {
                 continue;
+            }
             result += js.slice(cursor, edit.start);
             if (edit.comment !== undefined) {
                 result += `//${edit.comment}`;
@@ -184,8 +189,9 @@ const embedJs = (js) => {
 };
 const escapedBy = (source, at) => {
     let slashes = 0;
-    while (source[at - slashes - 1] === '\\')
+    while (source[at - slashes - 1] === '\\') {
         slashes += 1;
+    }
     return slashes % 2 === 1;
 };
 const RenderedHtmlView = ({ composition, theme, fluid, framed, styleText, scriptText, defaultAriaLabel, body, }) => wrapCompositionContent(createElement(Fragment, null, styleText

package/dist/render/html/envelope.js.map

@@ -1 +1 @@
-{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/render/html/envelope.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 { createElement, Fragment, type ReactNode } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\nimport {\n  type Comment as JavaScriptComment,\n  type Node as JavaScriptNode,\n  parse,\n} from 'acorn';\n\nimport {\n  type ChildNodeWalker,\n  createChildNodeWalker,\n} from '../../composition/body_node_base';\nimport type { Composition } from '../../composition/composition';\nimport type { RenderTheme } from '../../composition/named_color';\nimport type { ValidationError } from '../../composition/validation_error';\nimport type {\n  AnyPrimitiveDefinition,\n  PrimitiveNode,\n  PrimitiveStyleCollectionContext,\n  PrimitiveStyleCollector,\n  StyledRenderContext,\n  StyleHandle,\n} from '../../define/primitive_module';\nimport {\n  EMBEDDED_SCRIPT_ATTRIBUTE,\n  resolveEnhancements,\n  scopeScript,\n} from '../../pack/enhancements';\nimport {\n  type CheckedValidationResult,\n  compositionToRender,\n  createCompositionValidator,\n  enforceValidationMode,\n  type ValidationErrorMode,\n} from '../../validate/validation';\nimport { withAnchors } from '../anchors';\nimport { contextWith } from '../context_view';\nimport { byteLength, type PayloadMeasurement } from '../payload';\nimport {\n  type ReactContentDispatcher,\n  renderCompositionContent,\n  wrapCompositionContent,\n} from '../react/content';\n\nimport {\n  embedScript,\n  type EnhancementDefinition,\n  enhancementScript,\n} from './enhancements';\n\n/** Knobs for the HTML surface. Every field defaults, so `{}` is valid. */\nexport interface HTMLRenderOptions {\n  /** Overrides {@link Composition.theme}; `auto` when neither is set. */\n  theme?: RenderTheme;\n  /** Drops whitespace between tags that spans a line break, leaving `<pre>`, `<script>`, `<style>`, and `<textarea>` content intact. Defaults to `true`. */\n  minify?: boolean;\n  /** Adds the `fluid` wrapper class and reaches the pack as {@link PrimitiveStyleCollectionContext.fluid}; the adapter decides what it changes. */\n  fluid?: boolean;\n  /** Adds the `framed` wrapper class the adapter styles as a frame. Defaults to `true`. */\n  framed?: boolean;\n  /**\n   * Renders the composition's title and subtitle. Defaults to `true`. Set\n   * `false` when the embedding host already shows the title itself — the title\n   * still backs the wrapper's `aria-label`.\n   */\n  heading?: boolean;\n  /** Whether the collected CSS is inlined as a `<style>` element. Defaults to `'inline'`. */\n  css?: 'inline' | 'separate';\n  /**\n   * Who runs the enhancement script. Defaults to `'embedded'`: `html` carries\n   * a `<script>` that finds its own `.isomer` section when the page parses it.\n   *\n   * `'embedded'` never runs inside a shadow root, or anywhere the host inserts\n   * `html` itself (`innerHTML`, a React tree). Use `'host'` there: `html`\n   * carries no `<script>`, and the host calls `runEnhancementScript(js,\n   * section)` after inserting it.\n   */\n  scripts?: 'embedded' | 'host';\n  /** Defaults to collecting into {@link HTMLRenderResult.validationErrors}; `'throw'` raises instead. Input the budget refused raises in either mode. */\n  onValidationError?: ValidationErrorMode;\n  /** Opt-in by {@link EnhancementDefinition.id}. One whose content gate does not match the body is dropped. */\n  enhancements?: readonly string[];\n  /** `true` renders node anchors whether or not an enhancement asks for them, e.g. for tests. `false` cannot turn off anchors an enhancement needs. */\n  anchors?: boolean;\n  /**\n   * Resolves `light-dark(…)` in the stylesheet to one scheme's value. A browser\n   * resolves it itself; an image is one static frame, so the `svg` surface sets\n   * it.\n   */\n  scheme?: 'light' | 'dark';\n}\n\n/**\n * One rendered HTML payload.\n *\n * `body` is the primitive markup alone; `html` adds the wrapper element, on\n * the default `css: 'inline'` a `<style>`, and on the default\n * `scripts: 'embedded'` a `<script>`. `css` and `js` are populated either way.\n * `validationErrors` are the messages that survived\n * {@link HTMLRenderOptions.onValidationError}.\n */\nexport interface HTMLRenderResult {\n  html: string;\n  css: string;\n  /**\n   * The enhancement script as a function body over `root`, or `''`. Under\n   * `scripts: 'embedded'` the `<script>` in `html` wraps the same body; under\n   * `'host'` the host runs it with `runEnhancementScript`. It is never a\n   * complete script on its own.\n   */\n  js: string;\n  body: string;\n  measurement: PayloadMeasurement;\n  validationErrors: ValidationError[];\n}\n\n/**\n * A pack's HTML entry point: the React renderer plus the style pass that runs\n * ahead of it.\n */\nexport interface HTMLRenderDispatcher<\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> extends ReactContentDispatcher<TNode, TContext> {\n  /** The whole composition's inventory: a child walker built from one pack's definitions cannot descend into another pack's container. */\n  readonly definitions: readonly AnyPrimitiveDefinition[];\n  /** One node's style pass, driven by {@link HTMLStyleAdapter.collectViewStyles} rather than called by the sdk. */\n  collectStyles(\n    node: TNode,\n    collector: TCollector,\n    context: PrimitiveStyleCollectionContext\n  ): void;\n}\n\n/**\n * The composition's child walker and the enhancements every loaded pack\n * declared. Threaded into the style adapter so content-gating can see a\n * table nested inside a container from another package.\n */\nexport interface HTMLEnhancementScope {\n  walk: ChildNodeWalker;\n  definitions: readonly EnhancementDefinition[];\n}\n\n/**\n * How a pack turns its nodes into CSS. Optional overall — without an adapter\n * the render still produces markup, just with no class names and an empty\n * `TContext`.\n */\nexport interface HTMLStyleAdapter<\n  TNode extends PrimitiveNode = PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> {\n  /**\n   * Names the collector shape {@link HTMLStyleAdapter.createCollector} returns, so a runtime can\n   * reject a pack whose `collectStyles` hooks were written against a different one.\n   */\n  styleCollector?: string;\n  /** One collector per render, shared by every other hook here and by both render passes. */\n  createCollector(options: HTMLRenderOptions): TCollector;\n  /**\n   * Settles options that depend on the composition, before anything reads them.\n   *\n   * Needed by an adapter whose look is chosen per render: deciding `framed`\n   * from the body has to happen before the wrapper class is written, not while\n   * CSS is collected.\n   */\n  resolveOptions?(\n    composition: Composition<TNode>,\n    options: HTMLRenderOptions\n  ): HTMLRenderOptions;\n  /**\n   * The `.isomer` / `.isomer.framed` / `.isomer.fluid` rules around a rendered composition.\n   * Named for the wrapper rather than the frame, which the sdk reserves for a\n   * pack's svg document surround.\n   */\n  collectWrapperStyles?(\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): void;\n  /** Walks the body into the collector, usually through {@link HTMLRenderDispatcher.collectStyles}. Runs before any markup exists. */\n  collectViewStyles?(\n    composition: Composition<TNode>,\n    dispatcher: HTMLRenderDispatcher<TNode, TCollector, TContext>,\n    collector: TCollector,\n    context: PrimitiveStyleCollectionContext,\n    options: HTMLRenderOptions,\n    scope: HTMLEnhancementScope\n  ): void;\n  /** Runs once the collection pass has rendered the body, for styles only a renderer can discover. That markup is discarded. */\n  collectAfterRender?(\n    composition: Composition<TNode>,\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): void;\n  /**\n   * Builds the render context handed to every `react` renderer. Called once\n   * per pass, so an adapter that behaves differently while collecting returns\n   * a different context then. Must be complete, because `TContext` is the\n   * pack's own type. The sdk never writes to it: whether renderers anchor\n   * is the surface's decision, whatever the context's `anchors` says.\n   */\n  createRenderContext(\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): TContext;\n  /** The collected CSS as text, with no `<style>` wrapper; the sdk adds one when `css` is `'inline'`. */\n  renderStyles(collector: TCollector, options: HTMLRenderOptions): string;\n  /**\n   * Whether `handle` belongs to this adapter's stylesheet.\n   *\n   * Unused on a lone adapter. A runtime composing several packs' adapters\n   * routes each handle to its owner, so CSS is neither duplicated nor\n   * rendered against the wrong theme. An adapter that cannot answer this\n   * cannot be combined with another.\n   */\n  ownsHandle?(handle: StyleHandle): boolean;\n  /**\n   * Appended after {@link HTMLDispatcherRenderOptions.scriptText} into the\n   * render's one script. A function body with `root` in scope, under the same\n   * rules as {@link EnhancementDefinition.script}.\n   */\n  getScriptText?(\n    composition: Composition<TNode>,\n    options: HTMLRenderOptions,\n    scope: HTMLEnhancementScope\n  ): string;\n}\n\n/** What {@link renderHTMLWithDispatcher} needs beyond the composition. */\nexport interface HTMLDispatcherRenderOptions<\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> {\n  dispatcher: HTMLRenderDispatcher<TNode, TCollector, TContext>;\n  /** Runs once before rendering, which draws the composition it returns; {@link HTMLRenderOptions.onValidationError} decides what becomes of its errors. Defaults to `createCompositionValidator(dispatcher.definitions)`. */\n  validate?: (\n    composition: Composition<TNode>\n  ) => CheckedValidationResult<TNode>;\n  options?: HTMLRenderOptions;\n  /** Used only when the composition has neither `meta.ariaLabel` nor a `title`. Defaults to `'View'`. */\n  defaultAriaLabel?: string;\n  styleAdapter?: HTMLStyleAdapter<TNode, TCollector, TContext>;\n  /**\n   * Emitted unescaped ahead of {@link HTMLStyleAdapter.getScriptText}. A\n   * function body with `root` in scope, under the same rules as\n   * {@link EnhancementDefinition.script}.\n   */\n  scriptText?: string;\n  /**\n   * Progressive enhancements declared by the packs this render was composed\n   * from. The render resolves {@link HTMLRenderOptions.enhancements} against\n   * them once, hands every renderer the set as `context.enhancements`, and\n   * emits each resolved one's script.\n   */\n  enhancementDefinitions?: readonly EnhancementDefinition[];\n}\n\n/**\n * Renders a composition to standalone HTML: the wrapper element, the pack's\n * markup, and its CSS either inlined or returned separately.\n *\n * Runs the pack twice when a style adapter is present — once to collect\n * styles, once with the render context those styles produced — so a\n * `renderReact` implementation must be free of side effects.\n */\nexport const renderHTMLWithDispatcher = <\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n>(\n  input: Composition<TNode>,\n  {\n    dispatcher,\n    validate = createCompositionValidator<TNode>(dispatcher.definitions),\n    options: rawOptions = {},\n    defaultAriaLabel = 'View',\n    styleAdapter,\n    scriptText = '',\n    enhancementDefinitions = [],\n  }: HTMLDispatcherRenderOptions<TNode, TCollector, TContext>\n): HTMLRenderResult => {\n  const validation = validate(input);\n  const composition = compositionToRender(validation);\n  // Resolved before the validation mode is read, so an adapter can derive\n  // `onValidationError`.\n  const options =\n    styleAdapter?.resolveOptions?.(composition, rawOptions) ?? rawOptions;\n  enforceValidationMode(validation, options.onValidationError);\n  const framed = options.framed ?? true;\n  const heading = options.heading ?? true;\n  const theme = options.theme ?? composition.theme ?? 'auto';\n  const cssMode = options.css ?? 'inline';\n  const scriptsMode = options.scripts ?? 'embedded';\n  const styleState = styleAdapter?.createCollector(options);\n  const enhancementScope: HTMLEnhancementScope = {\n    walk: createChildNodeWalker(dispatcher.definitions),\n    definitions: enhancementDefinitions,\n  };\n  const applied = resolveEnhancements(\n    composition.body,\n    enhancementScope.walk,\n    enhancementDefinitions,\n    options.enhancements ?? []\n  );\n  const enhancements: ReadonlySet<string> = new Set(\n    applied.map(({ id }) => id)\n  );\n  const anchors =\n    options.anchors === true || applied.some(({ anchors }) => anchors);\n  const enhanced = (context: TContext): TContext =>\n    contextWith(context, 'enhancements', enhancements);\n\n  if (styleState) {\n    styleAdapter?.collectWrapperStyles?.(styleState, options);\n    styleAdapter?.collectViewStyles?.(\n      composition,\n      dispatcher,\n      styleState,\n      { fluid: Boolean(options.fluid) },\n      options,\n      enhancementScope\n    );\n    const collectionContext = enhanced(\n      styleAdapter?.createRenderContext(styleState, options) as TContext\n    );\n    withAnchors(anchors, () =>\n      renderToStaticMarkup(\n        createElement(() =>\n          renderCompositionContent(composition, dispatcher, collectionContext, {\n            heading,\n          })\n        )\n      )\n    );\n    styleAdapter?.collectAfterRender?.(composition, styleState, options);\n  }\n\n  const renderContext = enhanced(\n    styleState && styleAdapter\n      ? styleAdapter.createRenderContext(styleState, options)\n      : // No adapter means no class names and no css vars to resolve.\n        ({} as TContext)\n  );\n  const cssText =\n    styleState && styleAdapter\n      ? styleAdapter.renderStyles(styleState, options)\n      : '';\n  const adapterScriptText =\n    styleAdapter?.getScriptText?.(composition, options, enhancementScope) ?? '';\n  const js = [\n    ...[scriptText, adapterScriptText].filter(Boolean).map(scopeScript),\n    enhancementScript(applied),\n  ]\n    .filter(Boolean)\n    .join('\\n');\n  const embeddedScript =\n    js && scriptsMode === 'embedded' ? embedScript(js) : '';\n  const body = withAnchors(anchors, () =>\n    renderToStaticMarkup(\n      createElement(() =>\n        renderCompositionContent(composition, dispatcher, renderContext, {\n          heading,\n        })\n      )\n    )\n  );\n  const inlineCss = cssMode === 'inline' ? embedCss(cssText) : '';\n  const inlineJs = embeddedScript ? embedJs(embeddedScript) : '';\n  const raw = renderToStaticMarkup(\n    createElement(RenderedHtmlView<TNode>, {\n      composition,\n      theme,\n      fluid: Boolean(options.fluid),\n      framed,\n      styleText: inlineCss || undefined,\n      scriptText: inlineJs || undefined,\n      defaultAriaLabel,\n      body,\n    })\n  );\n  const html = options.minify === false ? raw : minifyHtml(raw);\n\n  // Inline payloads are measured as emitted, escapes included.\n  const inlineCssBytes = byteLength(inlineCss);\n  const inlineJsBytes = byteLength(inlineJs);\n  const separateCssBytes = cssMode === 'inline' ? 0 : byteLength(cssText);\n  const separateJsBytes = embeddedScript ? 0 : byteLength(js);\n\n  return {\n    html,\n    css: cssText,\n    js,\n    body,\n    measurement: {\n      html: byteLength(html) - inlineCssBytes - inlineJsBytes,\n      css: inlineCssBytes + separateCssBytes,\n      js: inlineJsBytes + separateJsBytes,\n      total: byteLength(html) + separateCssBytes + separateJsBytes,\n    },\n    validationErrors: validation.errors,\n  };\n};\n\ninterface RenderedHtmlViewProps<TNode extends PrimitiveNode> {\n  composition: Composition<TNode>;\n  theme: RenderTheme;\n  fluid: boolean;\n  framed: boolean;\n  styleText?: string | undefined;\n  scriptText?: string | undefined;\n  defaultAriaLabel: string;\n  body: string;\n}\n\n// Only `</style` ends a `<style>`. `\\/` is a CSS escape for `/`, so a string\n// holding it keeps its value.\nconst embedCss = (css: string): string => css.replace(/<\\/(?=style)/gi, '<\\\\/');\n\ninterface ScriptNode extends JavaScriptNode {\n  tag: ScriptNode;\n  quasi: ScriptNode;\n  quasis: ScriptNode[];\n  expressions: ScriptNode[];\n  value: { raw: string; cooked: string | null };\n  name?: string;\n}\n\n// Tagged templates observe raw spelling and reuse the same frozen object per site.\nconst embedJs = (js: string): string => {\n  if (!/<\\/script|<!--/i.test(js)) return js;\n  const comments: JavaScriptComment[] = [];\n  const tree = parse(js, { ecmaVersion: 'latest', onComment: comments });\n  const sites: ScriptNode[] = [];\n  const identifiers = new Set<string>();\n  const pending: JavaScriptNode[] = [tree];\n  while (pending.length) {\n    const node = pending.pop()! as ScriptNode;\n    if (node.type === 'Identifier' && node.name) identifiers.add(node.name);\n    if (\n      node.type === 'TaggedTemplateExpression' &&\n      node.quasi.quasis.some(({ value: { raw } }) =>\n        /<\\/script|<!--/i.test(raw)\n      )\n    )\n      sites.push(node);\n    for (const value of Object.values(node)) {\n      for (const child of Array.isArray(value) ? value : [value]) {\n        if (\n          child &&\n          typeof child === 'object' &&\n          'type' in child &&\n          'start' in child\n        ) {\n          pending.push(child as JavaScriptNode);\n        }\n      }\n    }\n  }\n  sites.sort((a, b) => a.start - b.start);\n  let prefix = '__isomerTemplate';\n  while ([...identifiers].some((name) => name.startsWith(prefix)))\n    prefix += '_';\n  const literal = (value: string | null): string =>\n    value === null ? 'void 0' : JSON.stringify(value).replace(/</g, '\\\\u003c');\n  const rewrite = (start: number, end: number): string => {\n    let cursor = start;\n    let result = '';\n    const edits = [\n      ...sites.map((site, index) => ({\n        ...site,\n        index,\n        comment: undefined as string | undefined,\n      })),\n      ...comments\n        .filter(({ start }) => /^(?:<!--|-->)/.test(js.slice(start, start + 4)))\n        .map((comment) => ({ ...comment, index: -1, comment: comment.value })),\n    ].sort((a, b) => a.start - b.start);\n    for (const edit of edits) {\n      if (edit.start < cursor || edit.end > end) continue;\n      result += js.slice(cursor, edit.start);\n      if (edit.comment !== undefined) {\n        result += `//${edit.comment}`;\n      } else {\n        const site = sites[edit.index]!;\n        const {\n          tag,\n          quasi: { quasis, expressions },\n        } = site;\n        const cooked = quasis\n          .map(({ value }) => literal(value.cooked))\n          .join(',');\n        const raw = quasis.map(({ value }) => literal(value.raw)).join(',');\n        const cache = `${prefix}${edit.index}`;\n        const template = `${cache} ??= ${prefix}Freeze(${prefix}Define([${cooked}], 'raw', {value:${prefix}Freeze([${raw}])}))`;\n        const args = expressions.map((expression) =>\n          rewrite(expression.start, expression.end)\n        );\n        result += `(${rewrite(tag.start, tag.end)})(${template}${args.map((arg) => `,(${arg})`).join('')})`;\n      }\n      cursor = edit.end;\n    }\n    return result + js.slice(cursor, end);\n  };\n  const rewritten = rewrite(0, js.length);\n  const scoped = sites.length\n    ? `(function(){const ${prefix}Freeze=Object.freeze,${prefix}Define=Object.defineProperty;let ${sites.map((_site, index) => `${prefix}${index}`).join(',')};\\n${rewritten}\\n})();`\n    : rewritten;\n  return scoped\n    .replace(/<\\/(?=script)/gi, '<\\\\/')\n    .replace(/<!--/g, (_match, at: number, source: string) =>\n      escapedBy(source, at) ? 'x3C!--' : '\\\\x3C!--'\n    );\n};\n\nconst escapedBy = (source: string, at: number): boolean => {\n  let slashes = 0;\n  while (source[at - slashes - 1] === '\\\\') slashes += 1;\n  return slashes % 2 === 1;\n};\n\nconst RenderedHtmlView = <TNode extends PrimitiveNode>({\n  composition,\n  theme,\n  fluid,\n  framed,\n  styleText,\n  scriptText,\n  defaultAriaLabel,\n  body,\n}: RenderedHtmlViewProps<TNode>): ReactNode =>\n  wrapCompositionContent(\n    createElement(\n      Fragment,\n      null,\n      styleText\n        ? createElement('style', {\n            key: 'style',\n            dangerouslySetInnerHTML: { __html: styleText },\n          })\n        : null,\n      createElement('div', {\n        key: 'body',\n        dangerouslySetInnerHTML: { __html: body },\n      }),\n      scriptText\n        ? createElement('script', {\n            key: 'script',\n            [EMBEDDED_SCRIPT_ATTRIBUTE]: '',\n            dangerouslySetInnerHTML: { __html: scriptText },\n          })\n        : null\n    ),\n    composition,\n    { framed, fluid, theme, defaultAriaLabel }\n  );\n\n// Whitespace inside `pre`, `script`, `style`, and `textarea` is content, so\n// those elements match whole and pass through. Elsewhere only whitespace\n// spanning a line break is collapsed: a single space between inline elements\n// (`<b>a</b> <i>b</i>`) is authored content.\nconst MINIFY_RE =\n  /<(pre|script|style|textarea)[\\s>][\\s\\S]*?(?:<\\/\\1\\s*>|$)|(?<=>)\\s+(?=<)/gi;\n\nconst minifyHtml = (value: string): string =>\n  value\n    .replace(MINIFY_RE, (match, element: string | undefined) =>\n      element || !match.includes('\\n') ? match : ''\n    )\n    .trim();\n"]}
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/render/html/envelope.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 { createElement, Fragment, type ReactNode } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\nimport {\n  type Comment as JavaScriptComment,\n  type Node as JavaScriptNode,\n  parse,\n} from 'acorn';\n\nimport {\n  type ChildNodeWalker,\n  createChildNodeWalker,\n} from '../../composition/body_node_base';\nimport type { Composition } from '../../composition/composition';\nimport type { RenderTheme } from '../../composition/named_color';\nimport type { ValidationError } from '../../composition/validation_error';\nimport type {\n  AnyPrimitiveDefinition,\n  PrimitiveNode,\n  PrimitiveStyleCollectionContext,\n  PrimitiveStyleCollector,\n  StyledRenderContext,\n  StyleHandle,\n} from '../../define/primitive_module';\nimport {\n  EMBEDDED_SCRIPT_ATTRIBUTE,\n  resolveEnhancements,\n  scopeScript,\n} from '../../pack/enhancements';\nimport {\n  type CheckedValidationResult,\n  compositionToRender,\n  createCompositionValidator,\n  enforceValidationMode,\n  type ValidationErrorMode,\n} from '../../validate/validation';\nimport { withAnchors } from '../anchors';\nimport { contextWith } from '../context_view';\nimport { byteLength, type PayloadMeasurement } from '../payload';\nimport {\n  type ReactContentDispatcher,\n  renderCompositionContent,\n  wrapCompositionContent,\n} from '../react/content';\n\nimport {\n  embedScript,\n  type EnhancementDefinition,\n  enhancementScript,\n} from './enhancements';\n\n/** Knobs for the HTML surface. Every field defaults, so `{}` is valid. */\nexport interface HTMLRenderOptions {\n  /** Overrides {@link Composition.theme}; `auto` when neither is set. */\n  theme?: RenderTheme;\n  /** Drops whitespace between tags that spans a line break, leaving `<pre>`, `<script>`, `<style>`, and `<textarea>` content intact. Defaults to `true`. */\n  minify?: boolean;\n  /** Adds the `fluid` wrapper class and reaches the pack as {@link PrimitiveStyleCollectionContext.fluid}; the adapter decides what it changes. */\n  fluid?: boolean;\n  /** Adds the `framed` wrapper class the adapter styles as a frame. Defaults to `true`. */\n  framed?: boolean;\n  /**\n   * Renders the composition's title and subtitle. Defaults to `true`. Set\n   * `false` when the embedding host already shows the title itself — the title\n   * still backs the wrapper's `aria-label`.\n   */\n  heading?: boolean;\n  /** Whether the collected CSS is inlined as a `<style>` element. Defaults to `'inline'`. */\n  css?: 'inline' | 'separate';\n  /**\n   * Who runs the enhancement script. Defaults to `'embedded'`: `html` carries\n   * a `<script>` that finds its own `.isomer` section when the page parses it.\n   *\n   * `'embedded'` never runs inside a shadow root, or anywhere the host inserts\n   * `html` itself (`innerHTML`, a React tree). Use `'host'` there: `html`\n   * carries no `<script>`, and the host calls `runEnhancementScript(js,\n   * section)` after inserting it.\n   */\n  scripts?: 'embedded' | 'host';\n  /** Defaults to collecting into {@link HTMLRenderResult.validationErrors}; `'throw'` raises instead. Input the budget refused raises in either mode. */\n  onValidationError?: ValidationErrorMode;\n  /** Opt-in by {@link EnhancementDefinition.id}. One whose content gate does not match the body is dropped. */\n  enhancements?: readonly string[];\n  /** `true` renders node anchors whether or not an enhancement asks for them, e.g. for tests. `false` cannot turn off anchors an enhancement needs. */\n  anchors?: boolean;\n  /**\n   * Resolves `light-dark(…)` in the stylesheet to one scheme's value. A browser\n   * resolves it itself; an image is one static frame, so the `snapshot` surface sets\n   * it.\n   */\n  scheme?: 'light' | 'dark';\n}\n\n/**\n * One rendered HTML payload.\n *\n * `body` is the primitive markup alone; `html` adds the wrapper element, on\n * the default `css: 'inline'` a `<style>`, and on the default\n * `scripts: 'embedded'` a `<script>`. `css` and `js` are populated either way.\n * `validationErrors` are the messages that survived\n * {@link HTMLRenderOptions.onValidationError}.\n */\nexport interface HTMLRenderResult {\n  html: string;\n  css: string;\n  /**\n   * The enhancement script as a function body over `root`, or `''`. Under\n   * `scripts: 'embedded'` the `<script>` in `html` wraps the same body; under\n   * `'host'` the host runs it with `runEnhancementScript`. It is never a\n   * complete script on its own.\n   */\n  js: string;\n  body: string;\n  measurement: PayloadMeasurement;\n  validationErrors: ValidationError[];\n}\n\n/**\n * A pack's HTML entry point: the React renderer plus the style pass that runs\n * ahead of it.\n */\nexport interface HTMLRenderDispatcher<\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> extends ReactContentDispatcher<TNode, TContext> {\n  /** The whole composition's inventory: a child walker built from one pack's definitions cannot descend into another pack's container. */\n  readonly definitions: readonly AnyPrimitiveDefinition[];\n  /** One node's style pass, driven by {@link HTMLStyleAdapter.collectViewStyles} rather than called by the sdk. */\n  collectStyles(\n    node: TNode,\n    collector: TCollector,\n    context: PrimitiveStyleCollectionContext\n  ): void;\n}\n\n/**\n * The composition's child walker and the enhancements every loaded pack\n * declared. Threaded into the style adapter so content-gating can see a\n * table nested inside a container from another package.\n */\nexport interface HTMLEnhancementScope {\n  walk: ChildNodeWalker;\n  definitions: readonly EnhancementDefinition[];\n}\n\n/**\n * How a pack turns its nodes into CSS. Optional overall — without an adapter\n * the render still produces markup, just with no class names and an empty\n * `TContext`.\n */\nexport interface HTMLStyleAdapter<\n  TNode extends PrimitiveNode = PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> {\n  /**\n   * Names the collector shape {@link HTMLStyleAdapter.createCollector} returns, so a runtime can\n   * reject a pack whose `collectStyles` hooks were written against a different one.\n   */\n  styleCollector?: string;\n  /** One collector per render, shared by every other hook here and by both render passes. */\n  createCollector(options: HTMLRenderOptions): TCollector;\n  /**\n   * Settles options that depend on the composition, before anything reads them.\n   *\n   * Needed by an adapter whose look is chosen per render: deciding `framed`\n   * from the body has to happen before the wrapper class is written, not while\n   * CSS is collected.\n   */\n  resolveOptions?(\n    composition: Composition<TNode>,\n    options: HTMLRenderOptions\n  ): HTMLRenderOptions;\n  /**\n   * The `.isomer` / `.isomer.framed` / `.isomer.fluid` rules around a rendered composition.\n   * Named for the wrapper rather than the frame, which the sdk reserves for the\n   * document a snapshot is drawn inside.\n   */\n  collectWrapperStyles?(\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): void;\n  /** Walks the body into the collector, usually through {@link HTMLRenderDispatcher.collectStyles}. Runs before any markup exists. */\n  collectViewStyles?(\n    composition: Composition<TNode>,\n    dispatcher: HTMLRenderDispatcher<TNode, TCollector, TContext>,\n    collector: TCollector,\n    context: PrimitiveStyleCollectionContext,\n    options: HTMLRenderOptions,\n    scope: HTMLEnhancementScope\n  ): void;\n  /** Runs once the collection pass has rendered the body, for styles only a renderer can discover. That markup is discarded. */\n  collectAfterRender?(\n    composition: Composition<TNode>,\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): void;\n  /**\n   * Builds the render context handed to every `react` renderer. Called once\n   * per pass, so an adapter that behaves differently while collecting returns\n   * a different context then. Must be complete, because `TContext` is the\n   * pack's own type. The sdk never writes to it: whether renderers anchor\n   * is the surface's decision, whatever the context's `anchors` says.\n   */\n  createRenderContext(\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): TContext;\n  /** The collected CSS as text, with no `<style>` wrapper; the sdk adds one when `css` is `'inline'`. */\n  renderStyles(collector: TCollector, options: HTMLRenderOptions): string;\n  /**\n   * Whether `handle` belongs to this adapter's stylesheet.\n   *\n   * Unused on a lone adapter. A runtime composing several packs' adapters\n   * routes each handle to its owner, so CSS is neither duplicated nor\n   * rendered against the wrong theme. An adapter that cannot answer this\n   * cannot be combined with another.\n   */\n  ownsHandle?(handle: StyleHandle): boolean;\n  /**\n   * Appended after {@link HTMLDispatcherRenderOptions.scriptText} into the\n   * render's one script. A function body with `root` in scope, under the same\n   * rules as {@link EnhancementDefinition.script}.\n   */\n  getScriptText?(\n    composition: Composition<TNode>,\n    options: HTMLRenderOptions,\n    scope: HTMLEnhancementScope\n  ): string;\n}\n\n/** What {@link renderHTMLWithDispatcher} needs beyond the composition. */\nexport interface HTMLDispatcherRenderOptions<\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> {\n  dispatcher: HTMLRenderDispatcher<TNode, TCollector, TContext>;\n  /** Runs once before rendering, which draws the composition it returns; {@link HTMLRenderOptions.onValidationError} decides what becomes of its errors. Defaults to `createCompositionValidator(dispatcher.definitions)`. */\n  validate?: (\n    composition: Composition<TNode>\n  ) => CheckedValidationResult<TNode>;\n  options?: HTMLRenderOptions;\n  /** Used only when the composition has neither `meta.ariaLabel` nor a `title`. Defaults to `'View'`. */\n  defaultAriaLabel?: string;\n  styleAdapter?: HTMLStyleAdapter<TNode, TCollector, TContext>;\n  /**\n   * Emitted unescaped ahead of {@link HTMLStyleAdapter.getScriptText}. A\n   * function body with `root` in scope, under the same rules as\n   * {@link EnhancementDefinition.script}.\n   */\n  scriptText?: string;\n  /**\n   * Progressive enhancements declared by the packs this render was composed\n   * from. The render resolves {@link HTMLRenderOptions.enhancements} against\n   * them once, hands every renderer the set as `context.enhancements`, and\n   * emits each resolved one's script.\n   */\n  enhancementDefinitions?: readonly EnhancementDefinition[];\n}\n\n/**\n * Renders a composition to standalone HTML: the wrapper element, the pack's\n * markup, and its CSS either inlined or returned separately.\n *\n * Runs the pack twice when a style adapter is present — once to collect\n * styles, once with the render context those styles produced — so a\n * `renderReact` implementation must be free of side effects.\n */\nexport const renderHTMLWithDispatcher = <\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n>(\n  input: Composition<TNode>,\n  {\n    dispatcher,\n    validate = createCompositionValidator<TNode>(dispatcher.definitions),\n    options: rawOptions = {},\n    defaultAriaLabel = 'View',\n    styleAdapter,\n    scriptText = '',\n    enhancementDefinitions = [],\n  }: HTMLDispatcherRenderOptions<TNode, TCollector, TContext>\n): HTMLRenderResult => {\n  const validation = validate(input);\n  const composition = compositionToRender(validation);\n  // Resolved before the validation mode is read, so an adapter can derive\n  // `onValidationError`.\n  const options =\n    styleAdapter?.resolveOptions?.(composition, rawOptions) ?? rawOptions;\n  enforceValidationMode(validation, options.onValidationError);\n  const framed = options.framed ?? true;\n  const heading = options.heading ?? true;\n  const theme = options.theme ?? composition.theme ?? 'auto';\n  const cssMode = options.css ?? 'inline';\n  const scriptsMode = options.scripts ?? 'embedded';\n  const styleState = styleAdapter?.createCollector(options);\n  const enhancementScope: HTMLEnhancementScope = {\n    walk: createChildNodeWalker(dispatcher.definitions),\n    definitions: enhancementDefinitions,\n  };\n  const applied = resolveEnhancements(\n    composition.body,\n    enhancementScope.walk,\n    enhancementDefinitions,\n    options.enhancements ?? []\n  );\n  const enhancements: ReadonlySet<string> = new Set(\n    applied.map(({ id }) => id)\n  );\n  const anchors =\n    options.anchors === true || applied.some(({ anchors }) => anchors);\n  const enhanced = (context: TContext): TContext =>\n    contextWith(context, 'enhancements', enhancements);\n\n  if (styleState) {\n    styleAdapter?.collectWrapperStyles?.(styleState, options);\n    styleAdapter?.collectViewStyles?.(\n      composition,\n      dispatcher,\n      styleState,\n      { fluid: Boolean(options.fluid) },\n      options,\n      enhancementScope\n    );\n    const collectionContext = enhanced(\n      styleAdapter?.createRenderContext(styleState, options) as TContext\n    );\n    withAnchors(anchors, () =>\n      renderToStaticMarkup(\n        createElement(() =>\n          renderCompositionContent(composition, dispatcher, collectionContext, {\n            heading,\n          })\n        )\n      )\n    );\n    styleAdapter?.collectAfterRender?.(composition, styleState, options);\n  }\n\n  const renderContext = enhanced(\n    styleState && styleAdapter\n      ? styleAdapter.createRenderContext(styleState, options)\n      : // No adapter means no class names and no css vars to resolve.\n        ({} as TContext)\n  );\n  const cssText =\n    styleState && styleAdapter\n      ? styleAdapter.renderStyles(styleState, options)\n      : '';\n  const adapterScriptText =\n    styleAdapter?.getScriptText?.(composition, options, enhancementScope) ?? '';\n  const js = [\n    ...[scriptText, adapterScriptText].filter(Boolean).map(scopeScript),\n    enhancementScript(applied),\n  ]\n    .filter(Boolean)\n    .join('\\n');\n  const embeddedScript =\n    js && scriptsMode === 'embedded' ? embedScript(js) : '';\n  const body = withAnchors(anchors, () =>\n    renderToStaticMarkup(\n      createElement(() =>\n        renderCompositionContent(composition, dispatcher, renderContext, {\n          heading,\n        })\n      )\n    )\n  );\n  const inlineCss = cssMode === 'inline' ? embedCss(cssText) : '';\n  const inlineJs = embeddedScript ? embedJs(embeddedScript) : '';\n  const raw = renderToStaticMarkup(\n    createElement(RenderedHtmlView<TNode>, {\n      composition,\n      theme,\n      fluid: Boolean(options.fluid),\n      framed,\n      styleText: inlineCss || undefined,\n      scriptText: inlineJs || undefined,\n      defaultAriaLabel,\n      body,\n    })\n  );\n  const html = options.minify === false ? raw : minifyHtml(raw);\n\n  // Inline payloads are measured as emitted, escapes included.\n  const inlineCssBytes = byteLength(inlineCss);\n  const inlineJsBytes = byteLength(inlineJs);\n  const separateCssBytes = cssMode === 'inline' ? 0 : byteLength(cssText);\n  const separateJsBytes = embeddedScript ? 0 : byteLength(js);\n\n  return {\n    html,\n    css: cssText,\n    js,\n    body,\n    measurement: {\n      html: byteLength(html) - inlineCssBytes - inlineJsBytes,\n      css: inlineCssBytes + separateCssBytes,\n      js: inlineJsBytes + separateJsBytes,\n      total: byteLength(html) + separateCssBytes + separateJsBytes,\n    },\n    validationErrors: validation.errors,\n  };\n};\n\ninterface RenderedHtmlViewProps<TNode extends PrimitiveNode> {\n  composition: Composition<TNode>;\n  theme: RenderTheme;\n  fluid: boolean;\n  framed: boolean;\n  styleText?: string | undefined;\n  scriptText?: string | undefined;\n  defaultAriaLabel: string;\n  body: string;\n}\n\n// Only `</style` ends a `<style>`. `\\/` is a CSS escape for `/`, so a string\n// holding it keeps its value.\nconst embedCss = (css: string): string => css.replace(/<\\/(?=style)/gi, '<\\\\/');\n\ninterface ScriptNode extends JavaScriptNode {\n  tag: ScriptNode;\n  quasi: ScriptNode;\n  quasis: ScriptNode[];\n  expressions: ScriptNode[];\n  value: { raw: string; cooked: string | null };\n  name?: string;\n}\n\n// Tagged templates observe raw spelling and reuse the same frozen object per site.\nconst embedJs = (js: string): string => {\n  if (!/<\\/script|<!--/i.test(js)) {\n    return js;\n  }\n  const comments: JavaScriptComment[] = [];\n  const tree = parse(js, { ecmaVersion: 'latest', onComment: comments });\n  const sites: ScriptNode[] = [];\n  const identifiers = new Set<string>();\n  const pending: JavaScriptNode[] = [tree];\n  while (pending.length) {\n    const node = pending.pop()! as ScriptNode;\n    if (node.type === 'Identifier' && node.name) {\n      identifiers.add(node.name);\n    }\n    if (\n      node.type === 'TaggedTemplateExpression' &&\n      node.quasi.quasis.some(({ value: { raw } }) =>\n        /<\\/script|<!--/i.test(raw)\n      )\n    ) {\n      sites.push(node);\n    }\n    for (const value of Object.values(node)) {\n      for (const child of Array.isArray(value) ? value : [value]) {\n        if (\n          child &&\n          typeof child === 'object' &&\n          'type' in child &&\n          'start' in child\n        ) {\n          pending.push(child as JavaScriptNode);\n        }\n      }\n    }\n  }\n  sites.sort((a, b) => a.start - b.start);\n  let prefix = '__isomerTemplate';\n  while ([...identifiers].some((name) => name.startsWith(prefix))) {\n    prefix += '_';\n  }\n  const literal = (value: string | null): string =>\n    value === null ? 'void 0' : JSON.stringify(value).replace(/</g, '\\\\u003c');\n  const rewrite = (start: number, end: number): string => {\n    let cursor = start;\n    let result = '';\n    const edits = [\n      ...sites.map((site, index) => ({\n        ...site,\n        index,\n        comment: undefined as string | undefined,\n      })),\n      ...comments\n        .filter(({ start }) => /^(?:<!--|-->)/.test(js.slice(start, start + 4)))\n        .map((comment) => ({ ...comment, index: -1, comment: comment.value })),\n    ].sort((a, b) => a.start - b.start);\n    for (const edit of edits) {\n      if (edit.start < cursor || edit.end > end) {\n        continue;\n      }\n      result += js.slice(cursor, edit.start);\n      if (edit.comment !== undefined) {\n        result += `//${edit.comment}`;\n      } else {\n        const site = sites[edit.index]!;\n        const {\n          tag,\n          quasi: { quasis, expressions },\n        } = site;\n        const cooked = quasis\n          .map(({ value }) => literal(value.cooked))\n          .join(',');\n        const raw = quasis.map(({ value }) => literal(value.raw)).join(',');\n        const cache = `${prefix}${edit.index}`;\n        const template = `${cache} ??= ${prefix}Freeze(${prefix}Define([${cooked}], 'raw', {value:${prefix}Freeze([${raw}])}))`;\n        const args = expressions.map((expression) =>\n          rewrite(expression.start, expression.end)\n        );\n        result += `(${rewrite(tag.start, tag.end)})(${template}${args.map((arg) => `,(${arg})`).join('')})`;\n      }\n      cursor = edit.end;\n    }\n    return result + js.slice(cursor, end);\n  };\n  const rewritten = rewrite(0, js.length);\n  const scoped = sites.length\n    ? `(function(){const ${prefix}Freeze=Object.freeze,${prefix}Define=Object.defineProperty;let ${sites.map((_site, index) => `${prefix}${index}`).join(',')};\\n${rewritten}\\n})();`\n    : rewritten;\n  return scoped\n    .replace(/<\\/(?=script)/gi, '<\\\\/')\n    .replace(/<!--/g, (_match, at: number, source: string) =>\n      escapedBy(source, at) ? 'x3C!--' : '\\\\x3C!--'\n    );\n};\n\nconst escapedBy = (source: string, at: number): boolean => {\n  let slashes = 0;\n  while (source[at - slashes - 1] === '\\\\') {\n    slashes += 1;\n  }\n  return slashes % 2 === 1;\n};\n\nconst RenderedHtmlView = <TNode extends PrimitiveNode>({\n  composition,\n  theme,\n  fluid,\n  framed,\n  styleText,\n  scriptText,\n  defaultAriaLabel,\n  body,\n}: RenderedHtmlViewProps<TNode>): ReactNode =>\n  wrapCompositionContent(\n    createElement(\n      Fragment,\n      null,\n      styleText\n        ? createElement('style', {\n            key: 'style',\n            dangerouslySetInnerHTML: { __html: styleText },\n          })\n        : null,\n      createElement('div', {\n        key: 'body',\n        dangerouslySetInnerHTML: { __html: body },\n      }),\n      scriptText\n        ? createElement('script', {\n            key: 'script',\n            [EMBEDDED_SCRIPT_ATTRIBUTE]: '',\n            dangerouslySetInnerHTML: { __html: scriptText },\n          })\n        : null\n    ),\n    composition,\n    { framed, fluid, theme, defaultAriaLabel }\n  );\n\n// Whitespace inside `pre`, `script`, `style`, and `textarea` is content, so\n// those elements match whole and pass through. Elsewhere only whitespace\n// spanning a line break is collapsed: a single space between inline elements\n// (`<b>a</b> <i>b</i>`) is authored content.\nconst MINIFY_RE =\n  /<(pre|script|style|textarea)[\\s>][\\s\\S]*?(?:<\\/\\1\\s*>|$)|(?<=>)\\s+(?=<)/gi;\n\nconst minifyHtml = (value: string): string =>\n  value\n    .replace(MINIFY_RE, (match, element: string | undefined) =>\n      element || !match.includes('\\n') ? match : ''\n    )\n    .trim();\n"]}

package/dist/render/layout_check.d.ts

@@ -39,5 +39,5 @@ export interface LayoutFinding {
  * compared. Nothing inside a scaled box is checked. A finding is advice, not an error:
  * an overlap may be intended.
  */
-export declare const checkLayout: (layout: LayoutBox, body: readonly unknown[], walk: ChildNodeWalker, surface: "react" | "svg") => LayoutFinding[];
+export declare const checkLayout: (layout: LayoutBox, body: readonly unknown[], walk: ChildNodeWalker, surface: "react" | "snapshot") => LayoutFinding[];
 //# sourceMappingURL=layout_check.d.ts.map