@elastic/isomer-sdk 0.0.0 → 0.1.0

package/dist/composition/error.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 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_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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCrB,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,68 @@
+/*
+ * 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_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,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_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, 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,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, 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,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  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"]}

package/dist/composition/validation_error.d.ts

@@ -0,0 +1,33 @@
+import { type IsomerErrorCode } from './error.js';
+/**
+ * One fatal validation finding.
+ *
+ * `path` locates the offending value (`body[3].items[0].label`) and is empty
+ * for a finding about the document as a whole. `message` is a predicate
+ * (`is required`, `must be one of: a, b`) so the two read as one sentence
+ * through {@link formatValidationError}.
+ */
+export interface ValidationError {
+    path: string;
+    message: string;
+    /** The `type` of the innermost primitive node `path` lands in, when there is one. */
+    nodeType?: string;
+    /** Set only on a refusal from `checkInputBudget`: `INPUT_OVER_BUDGET` or `INPUT_NOT_PLAIN_DATA`. */
+    code?: IsomerErrorCode;
+}
+/** `<path> (in <nodeType>) <message>`, or the message alone for a root finding. */
+export declare const formatValidationError: ({ path, message, nodeType, }: ValidationError) => string;
+/**
+ * Thrown when a `Composition` fails validation, carrying every finding
+ * rather than only the first.
+ *
+ * Identify it by `name`, `code`, and `errors`, 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 CompositionValidationError extends Error {
+    readonly code: "COMPOSITION_INVALID";
+    readonly errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+}
+//# sourceMappingURL=validation_error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation_error.d.ts","sourceRoot":"","sources":["../../src/composition/validation_error.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAGnE;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,GAAI,8BAInC,eAAe,KAAG,MAOpB,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,wBAA0C;IACvD,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;gBAEvB,MAAM,EAAE,eAAe,EAAE;CAStC"}

package/dist/composition/validation_error.js

@@ -0,0 +1,35 @@
+/*
+ * 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 { ISOMER_ERROR_CODES } from './error.js';
+import { nameText } from './one_line.js';
+/** `<path> (in <nodeType>) <message>`, or the message alone for a root finding. */
+export const formatValidationError = ({ path, message, nodeType, }) => {
+    if (!path) {
+        return message;
+    }
+    return nodeType === undefined
+        ? `${path} ${message}`
+        : `${path} (in ${nameText(nodeType)}) ${message}`;
+};
+/**
+ * Thrown when a `Composition` fails validation, carrying every finding
+ * rather than only the first.
+ *
+ * Identify it by `name`, `code`, and `errors`, 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 CompositionValidationError extends Error {
+    code = ISOMER_ERROR_CODES.COMPOSITION_INVALID;
+    errors;
+    constructor(errors) {
+        super(`Invalid Composition:\n  ${errors.map(formatValidationError).join('\n  ') || '(no detail)'}`);
+        this.name = 'CompositionValidationError';
+        this.errors = errors;
+    }
+}
+//# sourceMappingURL=validation_error.js.map

package/dist/composition/validation_error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation_error.js","sourceRoot":"","sources":["../../src/composition/validation_error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAwB,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmBtC,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EACpC,IAAI,EACJ,OAAO,EACP,QAAQ,GACQ,EAAU,EAAE;IAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,QAAQ,KAAK,SAAS;QAC3B,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE;QACtB,CAAC,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,QAAQ,CAAC,KAAK,OAAO,EAAE,CAAC;AACtD,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,kBAAkB,CAAC,mBAAmB,CAAC;IAC9C,MAAM,CAAoB;IAEnC,YAAY,MAAyB;QACnC,KAAK,CACH,2BACE,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,aACpD,EAAE,CACH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,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\nimport { ISOMER_ERROR_CODES, type IsomerErrorCode } from './error';\nimport { nameText } from './one_line';\n\n/**\n * One fatal validation finding.\n *\n * `path` locates the offending value (`body[3].items[0].label`) and is empty\n * for a finding about the document as a whole. `message` is a predicate\n * (`is required`, `must be one of: a, b`) so the two read as one sentence\n * through {@link formatValidationError}.\n */\nexport interface ValidationError {\n  path: string;\n  message: string;\n  /** The `type` of the innermost primitive node `path` lands in, when there is one. */\n  nodeType?: string;\n  /** Set only on a refusal from `checkInputBudget`: `INPUT_OVER_BUDGET` or `INPUT_NOT_PLAIN_DATA`. */\n  code?: IsomerErrorCode;\n}\n\n/** `<path> (in <nodeType>) <message>`, or the message alone for a root finding. */\nexport const formatValidationError = ({\n  path,\n  message,\n  nodeType,\n}: ValidationError): string => {\n  if (!path) {\n    return message;\n  }\n  return nodeType === undefined\n    ? `${path} ${message}`\n    : `${path} (in ${nameText(nodeType)}) ${message}`;\n};\n\n/**\n * Thrown when a `Composition` fails validation, carrying every finding\n * rather than only the first.\n *\n * Identify it by `name`, `code`, and `errors`, never `instanceof`: the SDK\n * ships both ESM and CJS builds, so a host can hold two copies of this class\n * and an identity check would miss one.\n */\nexport class CompositionValidationError extends Error {\n  readonly code = ISOMER_ERROR_CODES.COMPOSITION_INVALID;\n  readonly errors: ValidationError[];\n\n  constructor(errors: ValidationError[]) {\n    super(\n      `Invalid Composition:\\n  ${\n        errors.map(formatValidationError).join('\\n  ') || '(no detail)'\n      }`\n    );\n    this.name = 'CompositionValidationError';\n    this.errors = errors;\n  }\n}\n"]}