@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/cjs/composition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/composition/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,mDAU0B;AALxB,oHAAA,kBAAkB,OAAA;AAClB,+GAAA,aAAa,OAAA;AACb,uHAAA,qBAAqB,OAAA;AACrB,oHAAA,kBAAkB,OAAA;AAClB,8GAAA,YAAY,OAAA;AAGd,iCAAgF;AAAjD,2GAAA,kBAAkB,OAAA;AAAE,oGAAA,WAAW,OAAA;AAC9D,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,6CAKuB;AADrB,+GAAA,gBAAgB,OAAA;AAGlB,uCAA0D;AAAjD,oGAAA,QAAQ,OAAA;AAAE,mGAAA,OAAO,OAAA;AAAE,qGAAA,SAAS,OAAA;AACrC,uDAK4B;AAD1B,4HAAA,wBAAwB,OAAA;AAE1B,uDAI4B;AAF1B,8HAAA,0BAA0B,OAAA;AAC1B,yHAAA,qBAAqB,OAAA","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/cjs/composition/map_nodes.js

@@ -0,0 +1,85 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapCompositionNodes = void 0;
+const error_1 = require("./error");
+/** One dotted step of a child path: `field` or `field[index]`. */
+const PATH_STEP = /^([A-Za-z_$][\w$]*)(?:\[(\d+)\])?$/;
+const unsupportedPath = (path) => new error_1.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`.
+ */
+const mapCompositionNodes = (composition, walk, fn) => {
+    const mapNode = (root) => {
+        const open = new Set();
+        const stack = [];
+        const enter = (node) => {
+            if (open.has(node)) {
+                throw new error_1.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)),
+    };
+};
+exports.mapCompositionNodes = mapCompositionNodes;
+//# sourceMappingURL=map_nodes.js.map

package/dist/cjs/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/cjs/composition/named_color.js

@@ -0,0 +1,20 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_NAMED_COLORS = void 0;
+/** Every {@link NamedColor}, and the source `namedColorSchema` derives from. */
+exports.ALL_NAMED_COLORS = [
+    'neutral',
+    'primary',
+    'accent',
+    'success',
+    'warning',
+    'risk',
+    'danger',
+];
+//# sourceMappingURL=named_color.js.map

package/dist/cjs/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;AACnE,QAAA,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/cjs/composition/node.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=node.js.map

package/dist/cjs/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/cjs/composition/one_line.js

@@ -0,0 +1,23 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nameText = exports.quoteText = exports.oneLine = void 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. */
+const oneLine = (text) => text.replace(/\s+/g, (run) => (LINE_TERMINATOR_RE.test(run) ? ' ' : run));
+exports.oneLine = oneLine;
+/** `text` as a JSON string on one line: `JSON.stringify` leaves U+2028 and U+2029 raw. */
+const quoteText = (text) => JSON.stringify(text)
+    .replace(/\u2028/g, '\\u2028')
+    .replace(/\u2029/g, '\\u2029');
+exports.quoteText = quoteText;
+const PLAIN_NAME = /^[\w$-]+$/;
+/** A name for a one-line message: as it is when plain, else as {@link quoteText} quotes it. */
+const nameText = (name) => PLAIN_NAME.test(name) ? name : (0, exports.quoteText)(name);
+exports.nameText = nameText;
+//# sourceMappingURL=one_line.js.map

package/dist/cjs/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;AACzH,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;AAD/D,QAAA,OAAO,WACwD;AAE5E,0FAA0F;AACnF,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;AAHtB,QAAA,SAAS,aAGa;AAEnC,MAAM,UAAU,GAAG,WAAW,CAAC;AAE/B,+FAA+F;AACxF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAC/C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,iBAAS,EAAC,IAAI,CAAC,CAAC;AADpC,QAAA,QAAQ,YAC4B","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/cjs/composition/structured_value.js

@@ -0,0 +1,21 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STRUCTURED_VALUE_FORMATS = void 0;
+/** Format hints a {@link StructuredValue} may carry. */
+exports.STRUCTURED_VALUE_FORMATS = [
+    'number',
+    'compact',
+    'percent',
+    'currency',
+    'bytes',
+    'duration',
+    'date',
+    'relativeTime',
+];
+//# sourceMappingURL=structured_value.js.map

package/dist/cjs/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;AAC3C,QAAA,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/cjs/composition/validation_error.js

@@ -0,0 +1,40 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositionValidationError = exports.formatValidationError = void 0;
+const error_1 = require("./error");
+const one_line_1 = require("./one_line");
+/** `<path> (in <nodeType>) <message>`, or the message alone for a root finding. */
+const formatValidationError = ({ path, message, nodeType, }) => {
+    if (!path) {
+        return message;
+    }
+    return nodeType === undefined
+        ? `${path} ${message}`
+        : `${path} (in ${(0, one_line_1.nameText)(nodeType)}) ${message}`;
+};
+exports.formatValidationError = formatValidationError;
+/**
+ * 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.
+ */
+class CompositionValidationError extends Error {
+    code = error_1.ISOMER_ERROR_CODES.COMPOSITION_INVALID;
+    errors;
+    constructor(errors) {
+        super(`Invalid Composition:\n  ${errors.map(exports.formatValidationError).join('\n  ') || '(no detail)'}`);
+        this.name = 'CompositionValidationError';
+        this.errors = errors;
+    }
+}
+exports.CompositionValidationError = CompositionValidationError;
+//# sourceMappingURL=validation_error.js.map

package/dist/cjs/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,mCAAmE;AACnE,yCAAsC;AAmBtC,mFAAmF;AAC5E,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,IAAA,mBAAQ,EAAC,QAAQ,CAAC,KAAK,OAAO,EAAE,CAAC;AACtD,CAAC,CAAC;AAXW,QAAA,qBAAqB,yBAWhC;AAEF;;;;;;;GAOG;AACH,MAAa,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,0BAAkB,CAAC,mBAAmB,CAAC;IAC9C,MAAM,CAAoB;IAEnC,YAAY,MAAyB;QACnC,KAAK,CACH,2BACE,MAAM,CAAC,GAAG,CAAC,6BAAqB,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;AAbD,gEAaC","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"]}

package/dist/cjs/define/frame.js

@@ -0,0 +1,31 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindFrame = void 0;
+/**
+ * Erases a {@link Frame}'s `TTheme` into a {@link BoundFrame}, resolving the
+ * palette per render and composing the generic body walk with the frame's own
+ * surround.
+ */
+const bindFrame = (frame) => {
+    const themeFor = (mode) => mode === 'dark' ? frame.theme.dark : frame.theme.light;
+    return {
+        defaultWidth: frame.defaultWidth,
+        estimateHeight: (composition, dispatcher) => frame.estimateHeight(composition, dispatcher),
+        validateBody: (body) => frame.validateBody?.(body) ?? [],
+        resolveTheme: (mode) => themeFor(mode),
+        render: (composition, viewport, dispatcher) => {
+            const theme = themeFor(viewport.mode);
+            const { title, subtitle, theme: mode } = composition;
+            return frame.wrap({ title, subtitle, theme: mode }, composition.body.map((node, index) => dispatcher.renderSnapshot(node, `body-${index}`)), { ...viewport, theme });
+        },
+        renderNode: (node, dispatcher) => dispatcher.renderSnapshot(node, node.type),
+    };
+};
+exports.bindFrame = bindFrame;
+//# sourceMappingURL=frame.js.map

package/dist/cjs/define/frame.js.map

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

package/dist/cjs/define/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = exports.requiredString = exports.formatZodIssues = exports.declaredFieldsNote = exports.validateWithSchema = exports.unresolvedBodyNodeSchema = exports.definePrimitiveFor = exports.definePrimitive = exports.bodyNodeSurfacesSchema = exports.bodyNodeIdSchema = exports.OPTIONAL_SURFACES = exports.ICON_VARS = exports.primitiveExamples = exports.exampleNodes = exports.bindFrame = void 0;
+var frame_1 = require("./frame");
+Object.defineProperty(exports, "bindFrame", { enumerable: true, get: function () { return frame_1.bindFrame; } });
+var primitive_example_1 = require("./primitive_example");
+Object.defineProperty(exports, "exampleNodes", { enumerable: true, get: function () { return primitive_example_1.exampleNodes; } });
+Object.defineProperty(exports, "primitiveExamples", { enumerable: true, get: function () { return primitive_example_1.primitiveExamples; } });
+var primitive_icon_1 = require("./primitive_icon");
+Object.defineProperty(exports, "ICON_VARS", { enumerable: true, get: function () { return primitive_icon_1.ICON_VARS; } });
+var primitive_module_1 = require("./primitive_module");
+Object.defineProperty(exports, "OPTIONAL_SURFACES", { enumerable: true, get: function () { return primitive_module_1.OPTIONAL_SURFACES; } });
+Object.defineProperty(exports, "bodyNodeIdSchema", { enumerable: true, get: function () { return primitive_module_1.bodyNodeIdSchema; } });
+Object.defineProperty(exports, "bodyNodeSurfacesSchema", { enumerable: true, get: function () { return primitive_module_1.bodyNodeSurfacesSchema; } });
+Object.defineProperty(exports, "definePrimitive", { enumerable: true, get: function () { return primitive_module_1.definePrimitive; } });
+Object.defineProperty(exports, "definePrimitiveFor", { enumerable: true, get: function () { return primitive_module_1.definePrimitiveFor; } });
+Object.defineProperty(exports, "unresolvedBodyNodeSchema", { enumerable: true, get: function () { return primitive_module_1.unresolvedBodyNodeSchema; } });
+Object.defineProperty(exports, "validateWithSchema", { enumerable: true, get: function () { return primitive_module_1.validateWithSchema; } });
+var zod_format_1 = require("./zod_format");
+Object.defineProperty(exports, "declaredFieldsNote", { enumerable: true, get: function () { return zod_format_1.declaredFieldsNote; } });
+Object.defineProperty(exports, "formatZodIssues", { enumerable: true, get: function () { return zod_format_1.formatZodIssues; } });
+var zod_helpers_1 = require("./zod_helpers");
+Object.defineProperty(exports, "requiredString", { enumerable: true, get: function () { return zod_helpers_1.requiredString; } });
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_helpers_1.z; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/define/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/define/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iCAUiB;AADf,kGAAA,SAAS,OAAA;AAQX,yDAM6B;AAF3B,iHAAA,YAAY,OAAA;AACZ,sHAAA,iBAAiB,OAAA;AAEnB,mDAAiE;AAApC,2GAAA,SAAS,OAAA;AACtC,uDA8B4B;AAP1B,qHAAA,iBAAiB,OAAA;AACjB,oHAAA,gBAAgB,OAAA;AAChB,0HAAA,sBAAsB,OAAA;AACtB,mHAAA,eAAe,OAAA;AACf,sHAAA,kBAAkB,OAAA;AAClB,4HAAA,wBAAwB,OAAA;AACxB,sHAAA,kBAAkB,OAAA;AAgDpB,2CAAmE;AAA1D,gHAAA,kBAAkB,OAAA;AAAE,6GAAA,eAAe,OAAA;AAC5C,6CAAkD;AAAzC,6GAAA,cAAc,OAAA;AAAE,gGAAA,CAAC,OAAA","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport {\n  type BoundFrame,\n  type Frame,\n  type FrameBody,\n  type FrameComposition,\n  type FrameDispatcher,\n  type FrameHeader,\n  type FrameViewport,\n  type ThemePair,\n  bindFrame,\n} from './frame';\nexport {\n  type MarkdownBlock,\n  type MarkdownContent,\n  type MarkdownInline,\n  type MarkdownInlineInput,\n} from './markdown_content';\nexport {\n  type ExampleNode,\n  type NormalizedPrimitiveExample,\n  type PrimitiveExample,\n  exampleNodes,\n  primitiveExamples,\n} from './primitive_example';\nexport { type PrimitiveIcon, ICON_VARS } from './primitive_icon';\nexport {\n  type AnyPrimitiveDefinition,\n  type DefaultPackTypes,\n  type OptionalSurface,\n  type PackTypes,\n  type PrimitiveCatalogEntry,\n  type PrimitiveChildRef,\n  type PrimitiveDefinition,\n  type PrimitiveMetrics,\n  type PrimitiveNode,\n  type PrimitiveRenderContext,\n  type PrimitiveSchema,\n  type PrimitiveStyleCollectionContext,\n  type PrimitiveStyleCollector,\n  type ReactContextArg,\n  type Renderer,\n  type Renderers,\n  type RenderScope,\n  type StyledRenderContext,\n  type StyleHandle,\n  type SurfaceMap,\n  type ThemeTokenPath,\n  type WithNodeFields,\n  OPTIONAL_SURFACES,\n  bodyNodeIdSchema,\n  bodyNodeSurfacesSchema,\n  definePrimitive,\n  definePrimitiveFor,\n  unresolvedBodyNodeSchema,\n  validateWithSchema,\n} from './primitive_module';\nexport {\n  type SlackAssetCollector,\n  type SlackAssetRequest,\n} from './slack_assets';\nexport {\n  type SlackActionElement,\n  type SlackActionsBlock,\n  type SlackBlock,\n  type SlackButtonElement,\n  type SlackCheckboxesElement,\n  type SlackContextBlock,\n  type SlackDividerBlock,\n  type SlackFileReference,\n  type SlackHeaderBlock,\n  type SlackHeaderLevel,\n  type SlackImageBlock,\n  type SlackImageElement,\n  type SlackMrkdwnTextObject,\n  type SlackMultiStaticSelectElement,\n  type SlackOptionGroup,\n  type SlackOptionObject,\n  type SlackOverflowElement,\n  type SlackPlainTextObject,\n  type SlackRadioButtonsElement,\n  type SlackRawTextElement,\n  type SlackRichTextBlock,\n  type SlackRichTextBlockElement,\n  type SlackRichTextInline,\n  type SlackRichTextLink,\n  type SlackRichTextList,\n  type SlackRichTextPreformatted,\n  type SlackRichTextQuote,\n  type SlackRichTextSection,\n  type SlackRichTextStyle,\n  type SlackRichTextTag,\n  type SlackRichTextText,\n  type SlackSectionAccessory,\n  type SlackSectionBlock,\n  type SlackStaticSelectElement,\n  type SlackTableBlock,\n  type SlackTableCell,\n  type SlackTableColumnSetting,\n  type SlackTagColor,\n  type SlackTextObject,\n  type SlackVideoBlock,\n} from './slack_blocks';\nexport { declaredFieldsNote, formatZodIssues } from './zod_format';\nexport { requiredString, z } from './zod_helpers';\n"]}

package/dist/cjs/define/markdown_content.js

@@ -0,0 +1,12 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markdownContent = void 0;
+/** Brands `md` output. `Symbol.for`: ESM and CJS builds must agree. */
+exports.markdownContent = Symbol.for('elastic.isomer.markdown_content');
+//# sourceMappingURL=markdown_content.js.map

package/dist/cjs/define/markdown_content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown_content.js","sourceRoot":"","sources":["../../../src/define/markdown_content.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uEAAuE;AAC1D,QAAA,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n/** Brands `md` output. `Symbol.for`: ESM and CJS builds must agree. */\nexport const markdownContent = Symbol.for('elastic.isomer.markdown_content');\n\n/** Inline Markdown built with `md`. */\nexport interface MarkdownInline {\n  readonly [markdownContent]: 'inline';\n}\n\n/** Block Markdown built with `md`. */\nexport interface MarkdownBlock {\n  readonly [markdownContent]: 'block';\n}\n\n/** What a `markdown` renderer may return in place of a string. Nested lists flatten. */\nexport type MarkdownContent = MarkdownBlock | readonly MarkdownContent[];\n\n/** A string is text: escaped wherever it would read as Markdown, line breaks as spaces. */\nexport type MarkdownInlineInput = string | MarkdownInline;\n"]}

package/dist/cjs/define/primitive_example.js

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

package/dist/cjs/define/primitive_example.js.map

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

package/dist/cjs/define/primitive_icon.js

@@ -0,0 +1,17 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ICON_VARS = void 0;
+/** The colour slots an icon may paint with, which a host sets per theme and mode. */
+exports.ICON_VARS = [
+    '--isomer-icon-accent',
+    '--isomer-icon-bg',
+    '--isomer-icon-fg',
+    '--isomer-icon-muted',
+];
+//# sourceMappingURL=primitive_icon.js.map

package/dist/cjs/define/primitive_icon.js.map

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

package/dist/cjs/define/primitive_module.js

@@ -0,0 +1,118 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definePrimitiveFor = exports.definePrimitive = exports.unresolvedBodyNodeSchema = exports.bodyNodeSurfacesSchema = exports.bodyNodeIdSchema = exports.validateWithSchema = exports.OPTIONAL_SURFACES = void 0;
+const zod_1 = require("zod");
+const body_node_base_1 = require("../composition/body_node_base");
+const error_1 = require("../composition/error");
+const zod_format_1 = require("./zod_format");
+const zod_helpers_1 = require("./zod_helpers");
+/**
+ * The surface a pack may declare beyond the mandatory three.
+ *
+ * Only `slack`, and even that stays optional per primitive: the dispatcher
+ * converts the mandatory markdown to Block Kit, so a missing Slack renderer
+ * degrades rather than disappearing. `snapshot` is not here because no primitive
+ * implements it — the surface reuses `react`.
+ */
+exports.OPTIONAL_SURFACES = [
+    'slack',
+];
+/** Parses `node` against `schema`, appending path-prefixed messages to `errors`. */
+const validateWithSchema = (schema, node, path, errors) => {
+    const result = schema.safeParse(node, { reportInput: true });
+    if (!result.success) {
+        errors.push(...(0, zod_format_1.formatZodIssues)(result.error.issues, path));
+    }
+};
+exports.validateWithSchema = validateWithSchema;
+/** The `id` every node may carry, unique within a composition. */
+exports.bodyNodeIdSchema = (0, zod_helpers_1.requiredString)('must be a non-empty string');
+/** The `surfaces` allowlist on a node. Absent means every surface; empty is rejected. */
+exports.bodyNodeSurfacesSchema = zod_1.z
+    .array(zod_1.z.enum(body_node_base_1.SURFACE_NAMES, {
+    error: () => (0, zod_format_1.oneOf)(body_node_base_1.SURFACE_NAMES),
+}))
+    .min(1, { error: 'must contain at least one surface' });
+/**
+ * The child slot in a container's standalone {@link PrimitiveDefinition.schema},
+ * where no body-node union is available.
+ *
+ * Deliberately permissive rather than `z.unknown()`: it still rejects a child
+ * that is not a node at all, which is the error worth catching without an
+ * inventory. Anything that depends on *which* types are legal — the validator,
+ * the parser, the JSON Schema projection — goes through
+ * {@link PrimitiveDefinition.schemaFor} and sees the real union.
+ */
+exports.unresolvedBodyNodeSchema = zod_1.z.looseObject({
+    type: (0, zod_helpers_1.requiredString)('must be a non-empty string'),
+});
+/**
+ * Declares one primitive, extending its schema with the `id` and `surfaces`
+ * fields every node carries, and closing it to unknown keys so a node is held
+ * to the same rule as the composition root and the JSON Schema an agent reads.
+ * A schema with its own catchall (`z.looseObject`) keeps it.
+ *
+ * A pack normally calls the form {@link definePrimitiveFor} binds to its own
+ * {@link PackTypes}, so each primitive names only `TNode`.
+ */
+const definePrimitive = (definition) => {
+    const { schemaFor } = definition;
+    return {
+        ...definition,
+        schema: withNodeFields(definition.schema),
+        // Both forms get the node fields, or a container would accept `id` and
+        // `surfaces` standalone and reject them inside a composition.
+        ...(schemaFor
+            ? {
+                schemaFor: (bodyNodeSchema) => withNodeFields(schemaFor(bodyNodeSchema)),
+            }
+            : {}),
+    };
+};
+exports.definePrimitive = definePrimitive;
+/**
+ * {@link definePrimitive} bound to one pack's {@link PackTypes}.
+ *
+ * ```ts
+ * const define = definePrimitiveFor<SlidesPackTypes>();
+ * export const note = define({ type: 'note', … });
+ * ```
+ */
+const definePrimitiveFor = () => (definition) => (0, exports.definePrimitive)(definition);
+exports.definePrimitiveFor = definePrimitiveFor;
+// Marks the field schemas `definePrimitive` adds. A schema derived from a
+// defined one shares them by reference, and `Symbol.for` matches across ESM and
+// CommonJS copies of the SDK.
+const NODE_FIELD = Symbol.for('elastic.isomer.node_field');
+const nodeField = (schema) => Object.defineProperty(schema, NODE_FIELD, { value: true });
+const NODE_FIELDS = {
+    id: nodeField(exports.bodyNodeIdSchema.optional()),
+    surfaces: nodeField(exports.bodyNodeSurfacesSchema.optional()),
+};
+const isNodeField = (schema) => {
+    let current = schema;
+    while (current && typeof current === 'object') {
+        if (Object.hasOwn(current, NODE_FIELD))
+            return true;
+        const { def } = current;
+        if (def?.type !== 'optional')
+            return false;
+        current = def.innerType;
+    }
+    return false;
+};
+const withNodeFields = (schema) => {
+    const reserved = Object.keys(NODE_FIELDS).find((field) => Object.hasOwn(schema.shape, field) && !isNodeField(schema.shape[field]));
+    if (reserved) {
+        throw new error_1.IsomerError(error_1.ISOMER_ERROR_CODES.RESERVED_NODE_FIELD, `definePrimitive: a primitive schema cannot declare \`${reserved}\`; every body node has it.`);
+    }
+    const extended = schema.extend(NODE_FIELDS);
+    return (schema.def.catchall === undefined ? extended.strict() : extended);
+};
+//# sourceMappingURL=primitive_module.js.map