@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/composition/body_node_base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body_node_base.js","sourceRoot":"","sources":["../../src/composition/body_node_base.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/**\n * Every surface a node renders on or is hidden from, in render order.\n *\n * `html` is not here: the runtime's `html` surface wraps `react` output in a\n * document, and no node targets it.\n */\nexport const SURFACE_NAMES = [\n  'react',\n  'snapshot',\n  'text',\n  'markdown',\n  'slack',\n] as const;\n\n/** One of the {@link SURFACE_NAMES}. */\nexport type SurfaceName = (typeof SURFACE_NAMES)[number];\n\n/** @deprecated Use {@link SURFACE_NAMES}. */\nexport const BODY_NODE_SURFACES: readonly SurfaceName[] = SURFACE_NAMES;\n\n/** The two fields every primitive node carries, whatever its pack. */\nexport interface BodyNodeBase {\n  /** Unique within a composition, which `validate` enforces and `parse` does not. */\n  id?: string;\n  /** Surfaces this node appears on. Absent means every surface. */\n  surfaces?: SurfaceName[];\n}\n\n/**\n * A child node together with the field path locating it inside its parent, so\n * an error path can name the field a child actually lives under. A container\n * that returned bare nodes would leave every caller guessing the field name.\n */\nexport interface ChildNodeRef {\n  /** Erased: one walker spans every pack's node types, so it can name none of them. */\n  node: unknown;\n  /** Relative to the parent, e.g. `items[0].node`, `items[2].description`. */\n  path: string;\n}\n\n/**\n * Walks nested nodes and, for a hybrid container, reports whether the parent\n * still produces output of its own. A non-empty `children` result is the\n * complete source of rendered content unless\n * {@link ChildNodeWalker.hasOwnContent} is true for that node.\n */\nexport type ChildNodeWalker = ((node: unknown) => ChildNodeRef[]) & {\n  hasOwnContent?(node: unknown): boolean;\n};\n\n/**\n * Builds the {@link ChildNodeWalker} for one composition's inventory.\n *\n * Pass every pack's definitions: a walker missing one cannot see children of a\n * container that pack defines, and a tree walk would stop at its boundary.\n */\nexport const createChildNodeWalker = (\n  definitions: readonly {\n    type: string;\n    children?: unknown;\n    hasOwnContent?: unknown;\n  }[]\n): ChildNodeWalker => {\n  const childrenByType = new Map<\n    string,\n    (node: unknown) => readonly ChildNodeRef[]\n  >();\n  const ownContentByType = new Map<string, (node: unknown) => boolean>();\n  for (const definition of definitions) {\n    if (typeof definition.children === 'function') {\n      childrenByType.set(\n        definition.type,\n        definition.children as (node: unknown) => readonly ChildNodeRef[]\n      );\n    }\n    if (typeof definition.hasOwnContent === 'function') {\n      ownContentByType.set(\n        definition.type,\n        definition.hasOwnContent as (node: unknown) => boolean\n      );\n    }\n  }\n  const walk = ((node: unknown) => {\n    if (!node || typeof node !== 'object') {\n      return [];\n    }\n    const { type } = node as { type?: unknown };\n    if (typeof type !== 'string') {\n      return [];\n    }\n    return [...(childrenByType.get(type)?.(node) ?? [])];\n  }) as ChildNodeWalker;\n  walk.hasOwnContent = (node) => {\n    if (!node || typeof node !== 'object') {\n      return false;\n    }\n    const { type } = node as { type?: unknown };\n    if (typeof type !== 'string') {\n      return false;\n    }\n    return ownContentByType.get(type)?.(node) ?? false;\n  };\n  return walk;\n};\n\n/** Joins a parent path with a {@link ChildNodeRef.path} fragment. */\nexport const childNodePath = (parent: string, child: string): string =>\n  `${parent}.${child}`;\n\n/**\n * Whether any node visible on `surface` matches, descending through container\n * children via `walk`. A node (or a container ancestor) hidden from `surface`\n * is skipped along with its children.\n *\n * `walk` must span every pack in the composition: a walker built from one\n * pack's definitions cannot see children of a container defined in another.\n */\nexport const someBodyNode = (\n  nodes: readonly unknown[],\n  surface: SurfaceName,\n  predicate: (node: unknown) => boolean,\n  walk: ChildNodeWalker\n): boolean =>\n  nodes.some((node) => {\n    if (!isVisibleOnSurface(node, surface)) {\n      return false;\n    }\n    return (\n      predicate(node) ||\n      someBodyNode(\n        walk(node).map((child) => child.node),\n        surface,\n        predicate,\n        walk\n      )\n    );\n  });\n\n/** Whether `node`'s own `surfaces` hint admits `surface`, ignoring its children. */\nexport const isVisibleOnSurface = (\n  node: unknown,\n  surface: SurfaceName\n): boolean => {\n  if (!node || typeof node !== 'object') {\n    return false;\n  }\n  const { surfaces } = node as { surfaces?: unknown };\n  return !Array.isArray(surfaces) || surfaces.includes(surface);\n};\n\n/**\n * Whether `node` puts anything on `surface` — itself or through a descendant.\n *\n * Stronger than {@link isVisibleOnSurface}: a container every one of whose\n * children is hidden renders nothing, even though its own hint allows the\n * surface. A hybrid container that also owns string fields declares\n * {@link ChildNodeWalker.hasOwnContent} and keeps rendering regardless.\n */\nexport const rendersOnSurface = (\n  node: unknown,\n  surface: SurfaceName,\n  walk: ChildNodeWalker\n): boolean => {\n  if (!isVisibleOnSurface(node, surface)) {\n    return false;\n  }\n  const children = walk(node);\n  if (children.length === 0 || walk.hasOwnContent?.(node)) {\n    return true;\n  }\n  return children.some(({ node: child }) =>\n    rendersOnSurface(child, surface, walk)\n  );\n};\n"]}

package/dist/composition/composition.d.ts

@@ -0,0 +1,71 @@
+import type { RenderTheme } from './named_color.js';
+import type { PrimitiveNode } from './node.js';
+/**
+ * The wire format: one typed document that every surface renders from.
+ *
+ * Crosses process and vendor boundaries, so the JSON shape is the contract and
+ * the TypeScript name is not: {@link Composition.type} reads `view`, the
+ * discriminator an agent is prompted on.
+ */
+export interface Composition<TNode extends PrimitiveNode = PrimitiveNode> {
+    /** Root marker. Always `view`; see the note on {@link Composition}. */
+    type: 'view';
+    /**
+     * Wire-format version. A literal rather than `number` so an unknown future
+     * version cannot parse as valid, and optional with no default because absent
+     * already means v1 — writing one in would rewrite stored documents.
+     */
+    version?: 1;
+    title?: string;
+    subtitle?: string;
+    /** Light/dark preference, not a resolved value; `auto` resolves light. */
+    theme?: RenderTheme;
+    /** At least one node, which the schema enforces via `.min(1)`. */
+    body: TNode[];
+    meta?: CompositionMeta;
+}
+/**
+ * Context a host may surface beside the render.
+ *
+ * Advisory and pass-through throughout: nothing here changes what the body
+ * renders to, and the SDK reads none of it. Timestamps are plain strings by
+ * convention ISO 8601, which the schema does not enforce — a host that parses
+ * one should tolerate anything.
+ */
+export interface CompositionMeta {
+    /** Origin of the composition itself, e.g. the agent or feature that composed it. */
+    source?: string;
+    /** When the composition was produced. */
+    generatedAt?: string;
+    /** Overrides the accessible name a surface derives from `title`. */
+    ariaLabel?: string;
+    /** Where the underlying data came from, as opposed to who composed it. */
+    provenance?: {
+        /** Data origin, e.g. an index or dataset name. */
+        source?: string;
+        /** The query that produced the data, for a host that offers "show me how". */
+        query?: string;
+        /** Service or connector that answered the query. */
+        provider?: string;
+    };
+    /** How current the data is, for a host that shows an as-of or staleness badge. */
+    freshness?: {
+        /** When the data was current, which may precede `generatedAt`. */
+        asOf?: string;
+        /** Asserted by the producer rather than derived, so a host should prefer it to comparing `asOf`. */
+        stale?: boolean;
+        /** How long `asOf` stays current. Not range-checked. */
+        ttlSeconds?: number;
+    };
+    /**
+     * Set when the composition rendered anyway despite losing some data, so a
+     * host can mark it incomplete rather than presenting it as whole.
+     */
+    partialFailure?: {
+        /** True when some of the data behind the composition was lost before it rendered. */
+        degraded?: boolean;
+        /** Human-readable cause, safe to show a user. */
+        reason?: string;
+    };
+}
+//# sourceMappingURL=composition.d.ts.map

package/dist/composition/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/composition/composition.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,aAAa,GAAG,aAAa;IACtE,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kEAAkE;IAClE,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE;QACX,kDAAkD;QAClD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,8EAA8E;QAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,oDAAoD;QACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,kFAAkF;IAClF,SAAS,CAAC,EAAE;QACV,kEAAkE;QAClE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,oGAAoG;QACpG,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,wDAAwD;QACxD,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;;OAGG;IACH,cAAc,CAAC,EAAE;QACf,qFAAqF;QACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,iDAAiD;QACjD,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/composition/composition.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+export {};
+//# sourceMappingURL=composition.js.map

package/dist/composition/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../src/composition/composition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type { RenderTheme } from './named_color';\nimport type { PrimitiveNode } from './node';\n\n/**\n * The wire format: one typed document that every surface renders from.\n *\n * Crosses process and vendor boundaries, so the JSON shape is the contract and\n * the TypeScript name is not: {@link Composition.type} reads `view`, the\n * discriminator an agent is prompted on.\n */\nexport interface Composition<TNode extends PrimitiveNode = PrimitiveNode> {\n  /** Root marker. Always `view`; see the note on {@link Composition}. */\n  type: 'view';\n  /**\n   * Wire-format version. A literal rather than `number` so an unknown future\n   * version cannot parse as valid, and optional with no default because absent\n   * already means v1 — writing one in would rewrite stored documents.\n   */\n  version?: 1;\n  title?: string;\n  subtitle?: string;\n  /** Light/dark preference, not a resolved value; `auto` resolves light. */\n  theme?: RenderTheme;\n  /** At least one node, which the schema enforces via `.min(1)`. */\n  body: TNode[];\n  meta?: CompositionMeta;\n}\n\n/**\n * Context a host may surface beside the render.\n *\n * Advisory and pass-through throughout: nothing here changes what the body\n * renders to, and the SDK reads none of it. Timestamps are plain strings by\n * convention ISO 8601, which the schema does not enforce — a host that parses\n * one should tolerate anything.\n */\nexport interface CompositionMeta {\n  /** Origin of the composition itself, e.g. the agent or feature that composed it. */\n  source?: string;\n  /** When the composition was produced. */\n  generatedAt?: string;\n  /** Overrides the accessible name a surface derives from `title`. */\n  ariaLabel?: string;\n  /** Where the underlying data came from, as opposed to who composed it. */\n  provenance?: {\n    /** Data origin, e.g. an index or dataset name. */\n    source?: string;\n    /** The query that produced the data, for a host that offers \"show me how\". */\n    query?: string;\n    /** Service or connector that answered the query. */\n    provider?: string;\n  };\n  /** How current the data is, for a host that shows an as-of or staleness badge. */\n  freshness?: {\n    /** When the data was current, which may precede `generatedAt`. */\n    asOf?: string;\n    /** Asserted by the producer rather than derived, so a host should prefer it to comparing `asOf`. */\n    stale?: boolean;\n    /** How long `asOf` stays current. Not range-checked. */\n    ttlSeconds?: number;\n  };\n  /**\n   * Set when the composition rendered anyway despite losing some data, so a\n   * host can mark it incomplete rather than presenting it as whole.\n   */\n  partialFailure?: {\n    /** True when some of the data behind the composition was lost before it rendered. */\n    degraded?: boolean;\n    /** Human-readable cause, safe to show a user. */\n    reason?: string;\n  };\n}\n"]}

package/dist/composition/error.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Stable codes for {@link IsomerError}, {@link CompositionValidationError},
+ * and the runtime's `RegisteredViewInputError`. Hosts branch on `code`, not
+ * on `message`. Codes name the condition, not the throwing module: duplicate
+ * type at `definePrimitivePack`, `composePacks`, and `createIsomerRuntime` is the same
+ * `DUPLICATE_PRIMITIVE_TYPE`; the message names the layer.
+ */
+export declare const ISOMER_ERROR_CODES: {
+    readonly AMBIGUOUS_FRAME: "AMBIGUOUS_FRAME";
+    readonly AMBIGUOUS_STYLE_ADAPTER: "AMBIGUOUS_STYLE_ADAPTER";
+    readonly AUTHOR_TYPE_MISMATCH: "AUTHOR_TYPE_MISMATCH";
+    readonly AUTHORED_SCHEMA_REUSED: "AUTHORED_SCHEMA_REUSED";
+    readonly COMPOSITION_INVALID: "COMPOSITION_INVALID";
+    readonly CYCLIC_COMPOSITION: "CYCLIC_COMPOSITION";
+    readonly DUPLICATE_AUTHORED_CHILD: "DUPLICATE_AUTHORED_CHILD";
+    readonly DUPLICATE_ENHANCEMENT: "DUPLICATE_ENHANCEMENT";
+    readonly DUPLICATE_FORMAT: "DUPLICATE_FORMAT";
+    readonly DUPLICATE_PACK_ID: "DUPLICATE_PACK_ID";
+    readonly DUPLICATE_PRIMITIVE_TYPE: "DUPLICATE_PRIMITIVE_TYPE";
+    readonly DUPLICATE_VIEW: "DUPLICATE_VIEW";
+    readonly EMPTY_FRAMES: "EMPTY_FRAMES";
+    readonly EMPTY_PACK: "EMPTY_PACK";
+    readonly EMPTY_PACKS: "EMPTY_PACKS";
+    readonly EMPTY_PAGES: "EMPTY_PAGES";
+    readonly EMPTY_VOCABULARY: "EMPTY_VOCABULARY";
+    readonly ENHANCEMENT_ROOT_MISSING: "ENHANCEMENT_ROOT_MISSING";
+    readonly EXPECTED_AUTHOR_COMPONENT: "EXPECTED_AUTHOR_COMPONENT";
+    readonly EXPECTED_JSX_ELEMENT: "EXPECTED_JSX_ELEMENT";
+    readonly EXPECTED_TEXT_CHILDREN: "EXPECTED_TEXT_CHILDREN";
+    readonly INCOMPATIBLE_STYLE_COLLECTOR: "INCOMPATIBLE_STYLE_COLLECTOR";
+    readonly INPUT_NOT_PLAIN_DATA: "INPUT_NOT_PLAIN_DATA";
+    readonly INPUT_OVER_BUDGET: "INPUT_OVER_BUDGET";
+    readonly INVALID_BODY_NODE: "INVALID_BODY_NODE";
+    readonly INVALID_FRAME_BODY: "INVALID_FRAME_BODY";
+    readonly MISSING_AUTHORED_TEXT: "MISSING_AUTHORED_TEXT";
+    readonly MISSING_STYLE_ADAPTER: "MISSING_STYLE_ADAPTER";
+    readonly RESERVED_NODE_FIELD: "RESERVED_NODE_FIELD";
+    readonly UNEXPECTED_CHILDREN: "UNEXPECTED_CHILDREN";
+    readonly UNKNOWN_FRAME: "UNKNOWN_FRAME";
+    readonly UNKNOWN_PRIMITIVE_TYPE: "UNKNOWN_PRIMITIVE_TYPE";
+    readonly UNKNOWN_SURFACE: "UNKNOWN_SURFACE";
+    readonly UNKNOWN_VIEW: "UNKNOWN_VIEW";
+    readonly UNSUPPORTED_CHILD_PATH: "UNSUPPORTED_CHILD_PATH";
+    readonly VIEW_INPUT_INVALID: "VIEW_INPUT_INVALID";
+    readonly VOCABULARY_UNRESOLVED: "VOCABULARY_UNRESOLVED";
+};
+/** One of {@link ISOMER_ERROR_CODES}. */
+export type IsomerErrorCode = (typeof ISOMER_ERROR_CODES)[keyof typeof ISOMER_ERROR_CODES];
+/**
+ * Thrown for construction and authoring failures that are not a
+ * `CompositionValidationError`.
+ *
+ * Identify it by `name` and `code`, never `instanceof`: the SDK ships both
+ * ESM and CJS builds, so a host can hold two copies of this class and an
+ * identity check would miss one.
+ */
+export declare class IsomerError extends Error {
+    readonly code: IsomerErrorCode;
+    constructor(code: IsomerErrorCode, message: string);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/composition/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/composition/error.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCrB,CAAC;AAEX,yCAAyC;AACzC,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAEnB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD"}

package/dist/composition/error.js

@@ -0,0 +1,69 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+/**
+ * Stable codes for {@link IsomerError}, {@link CompositionValidationError},
+ * and the runtime's `RegisteredViewInputError`. Hosts branch on `code`, not
+ * on `message`. Codes name the condition, not the throwing module: duplicate
+ * type at `definePrimitivePack`, `composePacks`, and `createIsomerRuntime` is the same
+ * `DUPLICATE_PRIMITIVE_TYPE`; the message names the layer.
+ */
+export const ISOMER_ERROR_CODES = {
+    AMBIGUOUS_FRAME: 'AMBIGUOUS_FRAME',
+    AMBIGUOUS_STYLE_ADAPTER: 'AMBIGUOUS_STYLE_ADAPTER',
+    AUTHOR_TYPE_MISMATCH: 'AUTHOR_TYPE_MISMATCH',
+    AUTHORED_SCHEMA_REUSED: 'AUTHORED_SCHEMA_REUSED',
+    COMPOSITION_INVALID: 'COMPOSITION_INVALID',
+    CYCLIC_COMPOSITION: 'CYCLIC_COMPOSITION',
+    DUPLICATE_AUTHORED_CHILD: 'DUPLICATE_AUTHORED_CHILD',
+    DUPLICATE_ENHANCEMENT: 'DUPLICATE_ENHANCEMENT',
+    DUPLICATE_FORMAT: 'DUPLICATE_FORMAT',
+    DUPLICATE_PACK_ID: 'DUPLICATE_PACK_ID',
+    DUPLICATE_PRIMITIVE_TYPE: 'DUPLICATE_PRIMITIVE_TYPE',
+    DUPLICATE_VIEW: 'DUPLICATE_VIEW',
+    EMPTY_FRAMES: 'EMPTY_FRAMES',
+    EMPTY_PACK: 'EMPTY_PACK',
+    EMPTY_PACKS: 'EMPTY_PACKS',
+    EMPTY_PAGES: 'EMPTY_PAGES',
+    EMPTY_VOCABULARY: 'EMPTY_VOCABULARY',
+    ENHANCEMENT_ROOT_MISSING: 'ENHANCEMENT_ROOT_MISSING',
+    EXPECTED_AUTHOR_COMPONENT: 'EXPECTED_AUTHOR_COMPONENT',
+    EXPECTED_JSX_ELEMENT: 'EXPECTED_JSX_ELEMENT',
+    EXPECTED_TEXT_CHILDREN: 'EXPECTED_TEXT_CHILDREN',
+    INCOMPATIBLE_STYLE_COLLECTOR: 'INCOMPATIBLE_STYLE_COLLECTOR',
+    INPUT_NOT_PLAIN_DATA: 'INPUT_NOT_PLAIN_DATA',
+    INPUT_OVER_BUDGET: 'INPUT_OVER_BUDGET',
+    INVALID_BODY_NODE: 'INVALID_BODY_NODE',
+    INVALID_FRAME_BODY: 'INVALID_FRAME_BODY',
+    MISSING_AUTHORED_TEXT: 'MISSING_AUTHORED_TEXT',
+    MISSING_STYLE_ADAPTER: 'MISSING_STYLE_ADAPTER',
+    RESERVED_NODE_FIELD: 'RESERVED_NODE_FIELD',
+    UNEXPECTED_CHILDREN: 'UNEXPECTED_CHILDREN',
+    UNKNOWN_FRAME: 'UNKNOWN_FRAME',
+    UNKNOWN_PRIMITIVE_TYPE: 'UNKNOWN_PRIMITIVE_TYPE',
+    UNKNOWN_SURFACE: 'UNKNOWN_SURFACE',
+    UNKNOWN_VIEW: 'UNKNOWN_VIEW',
+    UNSUPPORTED_CHILD_PATH: 'UNSUPPORTED_CHILD_PATH',
+    VIEW_INPUT_INVALID: 'VIEW_INPUT_INVALID',
+    VOCABULARY_UNRESOLVED: 'VOCABULARY_UNRESOLVED',
+};
+/**
+ * Thrown for construction and authoring failures that are not a
+ * `CompositionValidationError`.
+ *
+ * Identify it by `name` and `code`, never `instanceof`: the SDK ships both
+ * ESM and CJS builds, so a host can hold two copies of this class and an
+ * identity check would miss one.
+ */
+export class IsomerError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'IsomerError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/composition/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/composition/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe,EAAE,iBAAiB;IAClC,uBAAuB,EAAE,yBAAyB;IAClD,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;IACxC,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB,EAAE,uBAAuB;IAC9C,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,wBAAwB,EAAE,0BAA0B;IACpD,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,wBAAwB,EAAE,0BAA0B;IACpD,yBAAyB,EAAE,2BAA2B;IACtD,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,4BAA4B,EAAE,8BAA8B;IAC5D,oBAAoB,EAAE,sBAAsB;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;IAC9C,qBAAqB,EAAE,uBAAuB;IAC9C,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,aAAa,EAAE,eAAe;IAC9B,sBAAsB,EAAE,wBAAwB;IAChD,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;CACtC,CAAC;AAMX;;;;;;;GAOG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IAE/B,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n/**\n * Stable codes for {@link IsomerError}, {@link CompositionValidationError},\n * and the runtime's `RegisteredViewInputError`. Hosts branch on `code`, not\n * on `message`. Codes name the condition, not the throwing module: duplicate\n * type at `definePrimitivePack`, `composePacks`, and `createIsomerRuntime` is the same\n * `DUPLICATE_PRIMITIVE_TYPE`; the message names the layer.\n */\nexport const ISOMER_ERROR_CODES = {\n  AMBIGUOUS_FRAME: 'AMBIGUOUS_FRAME',\n  AMBIGUOUS_STYLE_ADAPTER: 'AMBIGUOUS_STYLE_ADAPTER',\n  AUTHOR_TYPE_MISMATCH: 'AUTHOR_TYPE_MISMATCH',\n  AUTHORED_SCHEMA_REUSED: 'AUTHORED_SCHEMA_REUSED',\n  COMPOSITION_INVALID: 'COMPOSITION_INVALID',\n  CYCLIC_COMPOSITION: 'CYCLIC_COMPOSITION',\n  DUPLICATE_AUTHORED_CHILD: 'DUPLICATE_AUTHORED_CHILD',\n  DUPLICATE_ENHANCEMENT: 'DUPLICATE_ENHANCEMENT',\n  DUPLICATE_FORMAT: 'DUPLICATE_FORMAT',\n  DUPLICATE_PACK_ID: 'DUPLICATE_PACK_ID',\n  DUPLICATE_PRIMITIVE_TYPE: 'DUPLICATE_PRIMITIVE_TYPE',\n  DUPLICATE_VIEW: 'DUPLICATE_VIEW',\n  EMPTY_FRAMES: 'EMPTY_FRAMES',\n  EMPTY_PACK: 'EMPTY_PACK',\n  EMPTY_PACKS: 'EMPTY_PACKS',\n  EMPTY_PAGES: 'EMPTY_PAGES',\n  EMPTY_VOCABULARY: 'EMPTY_VOCABULARY',\n  ENHANCEMENT_ROOT_MISSING: 'ENHANCEMENT_ROOT_MISSING',\n  EXPECTED_AUTHOR_COMPONENT: 'EXPECTED_AUTHOR_COMPONENT',\n  EXPECTED_JSX_ELEMENT: 'EXPECTED_JSX_ELEMENT',\n  EXPECTED_TEXT_CHILDREN: 'EXPECTED_TEXT_CHILDREN',\n  INCOMPATIBLE_STYLE_COLLECTOR: 'INCOMPATIBLE_STYLE_COLLECTOR',\n  INPUT_NOT_PLAIN_DATA: 'INPUT_NOT_PLAIN_DATA',\n  INPUT_OVER_BUDGET: 'INPUT_OVER_BUDGET',\n  INVALID_BODY_NODE: 'INVALID_BODY_NODE',\n  INVALID_FRAME_BODY: 'INVALID_FRAME_BODY',\n  MISSING_AUTHORED_TEXT: 'MISSING_AUTHORED_TEXT',\n  MISSING_STYLE_ADAPTER: 'MISSING_STYLE_ADAPTER',\n  RESERVED_NODE_FIELD: 'RESERVED_NODE_FIELD',\n  UNEXPECTED_CHILDREN: 'UNEXPECTED_CHILDREN',\n  UNKNOWN_FRAME: 'UNKNOWN_FRAME',\n  UNKNOWN_PRIMITIVE_TYPE: 'UNKNOWN_PRIMITIVE_TYPE',\n  UNKNOWN_SURFACE: 'UNKNOWN_SURFACE',\n  UNKNOWN_VIEW: 'UNKNOWN_VIEW',\n  UNSUPPORTED_CHILD_PATH: 'UNSUPPORTED_CHILD_PATH',\n  VIEW_INPUT_INVALID: 'VIEW_INPUT_INVALID',\n  VOCABULARY_UNRESOLVED: 'VOCABULARY_UNRESOLVED',\n} as const;\n\n/** One of {@link ISOMER_ERROR_CODES}. */\nexport type IsomerErrorCode =\n  (typeof ISOMER_ERROR_CODES)[keyof typeof ISOMER_ERROR_CODES];\n\n/**\n * Thrown for construction and authoring failures that are not a\n * `CompositionValidationError`.\n *\n * Identify it by `name` and `code`, never `instanceof`: the SDK ships both\n * ESM and CJS builds, so a host can hold two copies of this class and an\n * identity check would miss one.\n */\nexport class IsomerError extends Error {\n  readonly code: IsomerErrorCode;\n\n  constructor(code: IsomerErrorCode, message: string) {\n    super(message);\n    this.name = 'IsomerError';\n    this.code = code;\n  }\n}\n"]}

package/dist/composition/index.d.ts

@@ -0,0 +1,11 @@
+export { type ActionEventRef } from './action_event.js';
+export { type BodyNodeBase, type ChildNodeRef, type ChildNodeWalker, type SurfaceName, BODY_NODE_SURFACES, SURFACE_NAMES, createChildNodeWalker, isVisibleOnSurface, someBodyNode, } from './body_node_base.js';
+export { type Composition, type CompositionMeta } from './composition.js';
+export { type IsomerErrorCode, ISOMER_ERROR_CODES, IsomerError } from './error.js';
+export { mapCompositionNodes } from './map_nodes.js';
+export { type NamedColor, type NamedColorPalette, type RenderTheme, ALL_NAMED_COLORS, } from './named_color.js';
+export { type PrimitiveNode } from './node.js';
+export { nameText, oneLine, quoteText } from './one_line.js';
+export { type DisplayValue, type StructuredValue, type StructuredValueFormat, STRUCTURED_VALUE_FORMATS, } from './structured_value.js';
+export { type ValidationError, CompositionValidationError, formatValidationError, } from './validation_error.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composition/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,KAAK,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,eAAe,EACpB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/composition/index.js

@@ -0,0 +1,14 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+export { BODY_NODE_SURFACES, SURFACE_NAMES, createChildNodeWalker, isVisibleOnSurface, someBodyNode, } from './body_node_base.js';
+export { ISOMER_ERROR_CODES, IsomerError } from './error.js';
+export { mapCompositionNodes } from './map_nodes.js';
+export { ALL_NAMED_COLORS, } from './named_color.js';
+export { nameText, oneLine, quoteText } from './one_line.js';
+export { STRUCTURED_VALUE_FORMATS, } from './structured_value.js';
+export { CompositionValidationError, formatValidationError, } from './validation_error.js';
+//# sourceMappingURL=index.js.map

package/dist/composition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/composition/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAKL,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAwB,kBAAkB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAIL,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAIL,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,oBAAoB,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport { type ActionEventRef } from './action_event';\nexport {\n  type BodyNodeBase,\n  type ChildNodeRef,\n  type ChildNodeWalker,\n  type SurfaceName,\n  BODY_NODE_SURFACES,\n  SURFACE_NAMES,\n  createChildNodeWalker,\n  isVisibleOnSurface,\n  someBodyNode,\n} from './body_node_base';\nexport { type Composition, type CompositionMeta } from './composition';\nexport { type IsomerErrorCode, ISOMER_ERROR_CODES, IsomerError } from './error';\nexport { mapCompositionNodes } from './map_nodes';\nexport {\n  type NamedColor,\n  type NamedColorPalette,\n  type RenderTheme,\n  ALL_NAMED_COLORS,\n} from './named_color';\nexport { type PrimitiveNode } from './node';\nexport { nameText, oneLine, quoteText } from './one_line';\nexport {\n  type DisplayValue,\n  type StructuredValue,\n  type StructuredValueFormat,\n  STRUCTURED_VALUE_FORMATS,\n} from './structured_value';\nexport {\n  type ValidationError,\n  CompositionValidationError,\n  formatValidationError,\n} from './validation_error';\n"]}

package/dist/composition/map_nodes.d.ts

@@ -0,0 +1,16 @@
+import type { ChildNodeWalker } from './body_node_base.js';
+import type { Composition } from './composition.js';
+import type { PrimitiveNode } from './node.js';
+/**
+ * Rebuilds `composition`'s body with `fn` applied to every node, including
+ * the nested children `walk` yields.
+ *
+ * Post-order: a container reaches `fn` after its children have been mapped,
+ * so `fn` sees the finished replacements in place. Build `walk` with
+ * {@link createChildNodeWalker} over every pack in the composition.
+ * A child path is the dotted `field` / `field[index]` form the SDK documents
+ * (`items[0].node`); any other shape throws `UNSUPPORTED_CHILD_PATH`.
+ * Walked without recursion, so depth is bounded by memory, not the call stack; a node nested in itself throws `CYCLIC_COMPOSITION`.
+ */
+export declare const mapCompositionNodes: <TNode extends PrimitiveNode = PrimitiveNode>(composition: Composition<TNode>, walk: ChildNodeWalker, fn: (node: PrimitiveNode) => PrimitiveNode) => Composition<TNode>;
+//# sourceMappingURL=map_nodes.d.ts.map

package/dist/composition/map_nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map_nodes.d.ts","sourceRoot":"","sources":["../../src/composition/map_nodes.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAiD5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC9B,KAAK,SAAS,aAAa,GAAG,aAAa,EAE3C,aAAa,WAAW,CAAC,KAAK,CAAC,EAC/B,MAAM,eAAe,EACrB,IAAI,CAAC,IAAI,EAAE,aAAa,KAAK,aAAa,KACzC,WAAW,CAAC,KAAK,CA2CnB,CAAC"}

package/dist/composition/map_nodes.js

@@ -0,0 +1,81 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { IsomerError } from './error.js';
+/** One dotted step of a child path: `field` or `field[index]`. */
+const PATH_STEP = /^([A-Za-z_$][\w$]*)(?:\[(\d+)\])?$/;
+const unsupportedPath = (path) => new IsomerError('UNSUPPORTED_CHILD_PATH', `mapCompositionNodes: cannot rewrite child at path "${path}"; expected dotted "field" or "field[index]" steps`);
+/** `parent` with the value at `steps` replaced, every touched object and array copied. */
+const withValueAt = (parent, steps, value, path) => {
+    const [step, ...rest] = steps;
+    const match = step === undefined ? null : PATH_STEP.exec(step);
+    if (!match || typeof parent !== 'object' || parent === null) {
+        throw unsupportedPath(path);
+    }
+    const field = match[1];
+    const record = parent;
+    if (match[2] === undefined) {
+        const next = rest.length === 0 ? value : withValueAt(record[field], rest, value, path);
+        return { ...record, [field]: next };
+    }
+    const index = Number(match[2]);
+    const current = record[field];
+    if (!Array.isArray(current)) {
+        throw unsupportedPath(path);
+    }
+    const array = [...current];
+    array[index] =
+        rest.length === 0 ? value : withValueAt(array[index], rest, value, path);
+    return { ...record, [field]: array };
+};
+/**
+ * Rebuilds `composition`'s body with `fn` applied to every node, including
+ * the nested children `walk` yields.
+ *
+ * Post-order: a container reaches `fn` after its children have been mapped,
+ * so `fn` sees the finished replacements in place. Build `walk` with
+ * {@link createChildNodeWalker} over every pack in the composition.
+ * A child path is the dotted `field` / `field[index]` form the SDK documents
+ * (`items[0].node`); any other shape throws `UNSUPPORTED_CHILD_PATH`.
+ * Walked without recursion, so depth is bounded by memory, not the call stack; a node nested in itself throws `CYCLIC_COMPOSITION`.
+ */
+export const mapCompositionNodes = (composition, walk, fn) => {
+    const mapNode = (root) => {
+        const open = new Set();
+        const stack = [];
+        const enter = (node) => {
+            if (open.has(node)) {
+                throw new IsomerError('CYCLIC_COMPOSITION', 'mapCompositionNodes: a node is nested in itself');
+            }
+            open.add(node);
+            stack.push({ node, children: walk(node), next: 0, result: node });
+        };
+        enter(root);
+        for (;;) {
+            const frame = stack[stack.length - 1];
+            const child = frame.children[frame.next];
+            if (child) {
+                enter(child.node);
+                continue;
+            }
+            stack.pop();
+            open.delete(frame.node);
+            const mapped = fn(frame.result);
+            const parent = stack[stack.length - 1];
+            if (!parent) {
+                return mapped;
+            }
+            const { path } = parent.children[parent.next];
+            parent.result = withValueAt(parent.result, path.split('.'), mapped, path);
+            parent.next += 1;
+        }
+    };
+    return {
+        ...composition,
+        body: composition.body.map((node) => mapNode(node)),
+    };
+};
+//# sourceMappingURL=map_nodes.js.map

package/dist/composition/map_nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map_nodes.js","sourceRoot":"","sources":["../../src/composition/map_nodes.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 type { ChildNodeRef, ChildNodeWalker } from './body_node_base';\nimport type { Composition } from './composition';\nimport { IsomerError } from './error';\nimport type { PrimitiveNode } from './node';\n\n/** One dotted step of a child path: `field` or `field[index]`. */\nconst PATH_STEP = /^([A-Za-z_$][\\w$]*)(?:\\[(\\d+)\\])?$/;\n\nconst unsupportedPath = (path: string): IsomerError =>\n  new IsomerError(\n    'UNSUPPORTED_CHILD_PATH',\n    `mapCompositionNodes: cannot rewrite child at path \"${path}\"; expected dotted \"field\" or \"field[index]\" steps`\n  );\n\n/** `parent` with the value at `steps` replaced, every touched object and array copied. */\nconst withValueAt = (\n  parent: unknown,\n  steps: readonly string[],\n  value: unknown,\n  path: string\n): unknown => {\n  const [step, ...rest] = steps;\n  const match = step === undefined ? null : PATH_STEP.exec(step);\n  if (!match || typeof parent !== 'object' || parent === null) {\n    throw unsupportedPath(path);\n  }\n  const field = match[1] as string;\n  const record = parent as Record<string, unknown>;\n  if (match[2] === undefined) {\n    const next =\n      rest.length === 0 ? value : withValueAt(record[field], rest, value, path);\n    return { ...record, [field]: next };\n  }\n  const index = Number(match[2]);\n  const current = record[field];\n  if (!Array.isArray(current)) {\n    throw unsupportedPath(path);\n  }\n  const array = [...(current as unknown[])];\n  array[index] =\n    rest.length === 0 ? value : withValueAt(array[index], rest, value, path);\n  return { ...record, [field]: array };\n};\n\n/** A node being mapped: its children, how many are done, and its copy so far. */\ninterface Frame {\n  node: PrimitiveNode;\n  children: ChildNodeRef[];\n  next: number;\n  result: PrimitiveNode;\n}\n\n/**\n * Rebuilds `composition`'s body with `fn` applied to every node, including\n * the nested children `walk` yields.\n *\n * Post-order: a container reaches `fn` after its children have been mapped,\n * so `fn` sees the finished replacements in place. Build `walk` with\n * {@link createChildNodeWalker} over every pack in the composition.\n * A child path is the dotted `field` / `field[index]` form the SDK documents\n * (`items[0].node`); any other shape throws `UNSUPPORTED_CHILD_PATH`.\n * Walked without recursion, so depth is bounded by memory, not the call stack; a node nested in itself throws `CYCLIC_COMPOSITION`.\n */\nexport const mapCompositionNodes = <\n  TNode extends PrimitiveNode = PrimitiveNode,\n>(\n  composition: Composition<TNode>,\n  walk: ChildNodeWalker,\n  fn: (node: PrimitiveNode) => PrimitiveNode\n): Composition<TNode> => {\n  const mapNode = (root: PrimitiveNode): PrimitiveNode => {\n    const open = new Set<PrimitiveNode>();\n    const stack: Frame[] = [];\n    const enter = (node: PrimitiveNode) => {\n      if (open.has(node)) {\n        throw new IsomerError(\n          'CYCLIC_COMPOSITION',\n          'mapCompositionNodes: a node is nested in itself'\n        );\n      }\n      open.add(node);\n      stack.push({ node, children: walk(node), next: 0, result: node });\n    };\n    enter(root);\n    for (;;) {\n      const frame = stack[stack.length - 1]!;\n      const child = frame.children[frame.next];\n      if (child) {\n        enter(child.node as PrimitiveNode);\n        continue;\n      }\n      stack.pop();\n      open.delete(frame.node);\n      const mapped = fn(frame.result);\n      const parent = stack[stack.length - 1];\n      if (!parent) {\n        return mapped;\n      }\n      const { path } = parent.children[parent.next]!;\n      parent.result = withValueAt(\n        parent.result,\n        path.split('.'),\n        mapped,\n        path\n      ) as PrimitiveNode;\n      parent.next += 1;\n    }\n  };\n  return {\n    ...composition,\n    body: composition.body.map((node) => mapNode(node) as TNode),\n  };\n};\n"]}

package/dist/composition/named_color.d.ts

@@ -0,0 +1,9 @@
+/** Portable color names shared by primitive packs and renderers. An exact subset of EUI's `NamedColor`. */
+export type NamedColor = 'neutral' | 'primary' | 'accent' | 'success' | 'warning' | 'risk' | 'danger';
+/** Every {@link NamedColor}, and the source `namedColorSchema` derives from. */
+export declare const ALL_NAMED_COLORS: readonly NamedColor[];
+/** Light/dark preference. `auto` resolves light wherever media queries are unavailable. */
+export type RenderTheme = 'auto' | 'light' | 'dark';
+/** A pack's colors by name. Partial: an unmapped name falls back to the renderer's default. */
+export type NamedColorPalette = Partial<Record<NamedColor, string>>;
+//# sourceMappingURL=named_color.d.ts.map

package/dist/composition/named_color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named_color.d.ts","sourceRoot":"","sources":["../../src/composition/named_color.ts"],"names":[],"mappings":"AAOA,2GAA2G;AAC3G,MAAM,MAAM,UAAU,GACpB,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/E,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAQjD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,+FAA+F;AAC/F,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC"}

package/dist/composition/named_color.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+/** Every {@link NamedColor}, and the source `namedColorSchema` derives from. */
+export const ALL_NAMED_COLORS = [
+    'neutral',
+    'primary',
+    'accent',
+    'success',
+    'warning',
+    'risk',
+    'danger',
+];
+//# sourceMappingURL=named_color.js.map

package/dist/composition/named_color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named_color.js","sourceRoot":"","sources":["../../src/composition/named_color.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAA0B;IACrD,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,MAAM;IACN,QAAQ;CACT,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/** Portable color names shared by primitive packs and renderers. An exact subset of EUI's `NamedColor`. */\nexport type NamedColor =\n  'neutral' | 'primary' | 'accent' | 'success' | 'warning' | 'risk' | 'danger';\n\n/** Every {@link NamedColor}, and the source `namedColorSchema` derives from. */\nexport const ALL_NAMED_COLORS: readonly NamedColor[] = [\n  'neutral',\n  'primary',\n  'accent',\n  'success',\n  'warning',\n  'risk',\n  'danger',\n];\n\n/** Light/dark preference. `auto` resolves light wherever media queries are unavailable. */\nexport type RenderTheme = 'auto' | 'light' | 'dark';\n\n/** A pack's colors by name. Partial: an unmapped name falls back to the renderer's default. */\nexport type NamedColorPalette = Partial<Record<NamedColor, string>>;\n"]}

package/dist/composition/node.d.ts

@@ -0,0 +1,11 @@
+import type { BodyNodeBase } from './body_node_base.js';
+/**
+ * One node in a `Composition`'s body, erased to its discriminator.
+ *
+ * A pack narrows `type` to its own literal union; the SDK holds this form
+ * because a heterogeneous inventory has no single node type to name.
+ */
+export interface PrimitiveNode extends BodyNodeBase {
+    type: string;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/composition/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/composition/node.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/composition/node.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+export {};
+//# sourceMappingURL=node.js.map

package/dist/composition/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/composition/node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type { BodyNodeBase } from './body_node_base';\n\n/**\n * One node in a `Composition`'s body, erased to its discriminator.\n *\n * A pack narrows `type` to its own literal union; the SDK holds this form\n * because a heterogeneous inventory has no single node type to name.\n */\nexport interface PrimitiveNode extends BodyNodeBase {\n  type: string;\n}\n"]}

package/dist/composition/one_line.d.ts

@@ -0,0 +1,7 @@
+/** `text` on one line: each run of whitespace holding a line terminator becomes one space, and other whitespace stays as is. */
+export declare const oneLine: (text: string) => string;
+/** `text` as a JSON string on one line: `JSON.stringify` leaves U+2028 and U+2029 raw. */
+export declare const quoteText: (text: string) => string;
+/** A name for a one-line message: as it is when plain, else as {@link quoteText} quotes it. */
+export declare const nameText: (name: string) => string;
+//# sourceMappingURL=one_line.d.ts.map

package/dist/composition/one_line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one_line.d.ts","sourceRoot":"","sources":["../../src/composition/one_line.ts"],"names":[],"mappings":"AASA,gIAAgI;AAChI,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,MACoC,CAAC;AAE5E,0FAA0F;AAC1F,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAGP,CAAC;AAInC,+FAA+F;AAC/F,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,MACQ,CAAC"}

package/dist/composition/one_line.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+const LINE_TERMINATOR_RE = /[\r\n\u2028\u2029]/;
+/** `text` on one line: each run of whitespace holding a line terminator becomes one space, and other whitespace stays as is. */
+export const oneLine = (text) => text.replace(/\s+/g, (run) => (LINE_TERMINATOR_RE.test(run) ? ' ' : run));
+/** `text` as a JSON string on one line: `JSON.stringify` leaves U+2028 and U+2029 raw. */
+export const quoteText = (text) => JSON.stringify(text)
+    .replace(/\u2028/g, '\\u2028')
+    .replace(/\u2029/g, '\\u2029');
+const PLAIN_NAME = /^[\w$-]+$/;
+/** A name for a one-line message: as it is when plain, else as {@link quoteText} quotes it. */
+export const nameText = (name) => PLAIN_NAME.test(name) ? name : quoteText(name);
+//# sourceMappingURL=one_line.js.map

package/dist/composition/one_line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one_line.js","sourceRoot":"","sources":["../../src/composition/one_line.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEhD,gIAAgI;AAChI,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CAC9C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAE5E,0FAA0F;AAC1F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAChD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KACjB,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;KAC7B,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAEnC,MAAM,UAAU,GAAG,WAAW,CAAC;AAE/B,+FAA+F;AAC/F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAC/C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,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\nconst LINE_TERMINATOR_RE = /[\\r\\n\\u2028\\u2029]/;\n\n/** `text` on one line: each run of whitespace holding a line terminator becomes one space, and other whitespace stays as is. */\nexport const oneLine = (text: string): string =>\n  text.replace(/\\s+/g, (run) => (LINE_TERMINATOR_RE.test(run) ? ' ' : run));\n\n/** `text` as a JSON string on one line: `JSON.stringify` leaves U+2028 and U+2029 raw. */\nexport const quoteText = (text: string): string =>\n  JSON.stringify(text)\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029');\n\nconst PLAIN_NAME = /^[\\w$-]+$/;\n\n/** A name for a one-line message: as it is when plain, else as {@link quoteText} quotes it. */\nexport const nameText = (name: string): string =>\n  PLAIN_NAME.test(name) ? name : quoteText(name);\n"]}

package/dist/composition/structured_value.d.ts

@@ -0,0 +1,27 @@
+/** Format hints a {@link StructuredValue} may carry. */
+export declare const STRUCTURED_VALUE_FORMATS: readonly ["number", "compact", "percent", "currency", "bytes", "duration", "date", "relativeTime"];
+/** One of {@link STRUCTURED_VALUE_FORMATS}. */
+export type StructuredValueFormat = (typeof STRUCTURED_VALUE_FORMATS)[number];
+/**
+ * A raw quantity plus a format hint, so every surface renders the same string.
+ *
+ * Formatting happens once, in `formatDisplayValue`, rather than per renderer —
+ * otherwise the text and Slack surfaces drift on rounding.
+ */
+export interface StructuredValue {
+    /** Unformatted, in base units — a `percent` of `0.42` renders as 42%. */
+    raw: number | string;
+    /** How to render `raw`. Absent passes a string through and gives a number default formatting. */
+    format?: StructuredValueFormat;
+    /**
+     * Fraction digits for numeric formats. `number`, `percent`, and `currency`
+     * pad to it; omitted, `number` and `percent` keep at most two and `currency`
+     * two. `compact` and `bytes` drop trailing zeros and keep one when omitted.
+     */
+    precision?: number;
+    /** Three-letter currency code for `currency`; defaults to USD. */
+    currency?: string;
+}
+/** A value-bearing field: preformatted prose, or a {@link StructuredValue} to format. */
+export type DisplayValue = string | StructuredValue;
+//# sourceMappingURL=structured_value.d.ts.map

package/dist/composition/structured_value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured_value.d.ts","sourceRoot":"","sources":["../../src/composition/structured_value.ts"],"names":[],"mappings":"AAOA,wDAAwD;AACxD,eAAO,MAAM,wBAAwB,oGAS3B,CAAC;AAEX,+CAA+C;AAC/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,iGAAiG;IACjG,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,eAAe,CAAC"}

package/dist/composition/structured_value.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+/** Format hints a {@link StructuredValue} may carry. */
+export const STRUCTURED_VALUE_FORMATS = [
+    'number',
+    'compact',
+    'percent',
+    'currency',
+    'bytes',
+    'duration',
+    'date',
+    'relativeTime',
+];
+//# sourceMappingURL=structured_value.js.map

package/dist/composition/structured_value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured_value.js","sourceRoot":"","sources":["../../src/composition/structured_value.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,OAAO;IACP,UAAU;IACV,MAAM;IACN,cAAc;CACN,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/** Format hints a {@link StructuredValue} may carry. */\nexport const STRUCTURED_VALUE_FORMATS = [\n  'number',\n  'compact',\n  'percent',\n  'currency',\n  'bytes',\n  'duration',\n  'date',\n  'relativeTime',\n] as const;\n\n/** One of {@link STRUCTURED_VALUE_FORMATS}. */\nexport type StructuredValueFormat = (typeof STRUCTURED_VALUE_FORMATS)[number];\n\n/**\n * A raw quantity plus a format hint, so every surface renders the same string.\n *\n * Formatting happens once, in `formatDisplayValue`, rather than per renderer —\n * otherwise the text and Slack surfaces drift on rounding.\n */\nexport interface StructuredValue {\n  /** Unformatted, in base units — a `percent` of `0.42` renders as 42%. */\n  raw: number | string;\n  /** How to render `raw`. Absent passes a string through and gives a number default formatting. */\n  format?: StructuredValueFormat;\n  /**\n   * Fraction digits for numeric formats. `number`, `percent`, and `currency`\n   * pad to it; omitted, `number` and `percent` keep at most two and `currency`\n   * two. `compact` and `bytes` drop trailing zeros and keep one when omitted.\n   */\n  precision?: number;\n  /** Three-letter currency code for `currency`; defaults to USD. */\n  currency?: string;\n}\n\n/** A value-bearing field: preformatted prose, or a {@link StructuredValue} to format. */\nexport type DisplayValue = string | StructuredValue;\n"]}