@elastic/isomer-sdk 0.0.0 → 0.2.0

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"]}

package/dist/define/frame.d.ts

@@ -0,0 +1,155 @@
+import type { ReactNode } from 'react';
+import type { RenderTheme } from '../composition/named_color.js';
+import type { PrimitiveNode } from '../composition/node.js';
+/**
+ * A frame's palette, per mode. An image has no media queries, so it must
+ * commit to one; `auto` resolves light.
+ */
+export interface ThemePair<TTheme> {
+    light: TTheme;
+    dark: TTheme;
+}
+/**
+ * Geometry and resolved theme a frame draws within.
+ *
+ * Named for the viewport rather than the frame because {@link Frame.wrap}
+ * draws *a* frame within it; the two would otherwise read as the same thing.
+ */
+export interface FrameViewport<TTheme> {
+    width: number;
+    height: number;
+    /** Resolved from {@link Frame.theme} for `mode`. */
+    theme: TTheme;
+    /** What the caller asked for, before resolution. `undefined` and `auto` both resolve light. */
+    mode: RenderTheme | undefined;
+}
+/**
+ * The two dispatcher methods a frame needs.
+ *
+ * The render context the nodes are drawn with is bound by the caller rather
+ * than passed here: it carries the class-name resolution that pairs with the
+ * stylesheet emitted alongside the frame's output, which is the surface's
+ * concern and not the document's. Generic in `TNode` so a helper can be
+ * written against a narrowed node union while the runtime holds the erased form.
+ */
+export interface FrameDispatcher<TNode extends PrimitiveNode = PrimitiveNode> {
+    /** Draws one node on the `snapshot` surface. `key` must be unique among its siblings. */
+    renderSnapshot(node: TNode, key: string): ReactNode;
+    /** The node's height in pixels; `0` when it is hidden from `snapshot` or its primitive declares no `metrics.snapshotHeight`. */
+    estimateSnapshotHeight(node: TNode): number;
+}
+/**
+ * What {@link Frame.wrap} is told about the composition it draws around.
+ *
+ * The body is withheld, and {@link bindFrame} copies only these fields into a
+ * fresh value, so the surround cannot branch on a pack's node types.
+ */
+export interface FrameHeader {
+    title?: string | undefined;
+    subtitle?: string | undefined;
+    /** The caller's preference, not a resolved palette. Use {@link FrameViewport.theme} to draw. */
+    theme?: RenderTheme | undefined;
+}
+/** {@link FrameHeader} plus the body, for the sizing and validation hooks. */
+export interface FrameComposition extends FrameHeader {
+    /** Raw nodes, for measuring and checking only. {@link FrameBody} is what gets drawn. */
+    body: PrimitiveNode[];
+}
+/**
+ * Body nodes already rendered to elements, ready to be surrounded.
+ *
+ * Distinct from `Composition.body`, which is the raw {@link PrimitiveNode}
+ * array a frame never sees.
+ */
+export type FrameBody = readonly ReactNode[];
+/**
+ * A document a `snapshot` render can produce: its geometry, the surround it draws
+ * around the body, and whatever it requires of a composition it is asked to
+ * draw.
+ *
+ * A host registers frames with the runtime and picks one per render. That is
+ * what lets one runtime serve a 760px card, a 1920x1080 slide, and a
+ * host-branded variant of either from the same vocabulary — and what keeps a
+ * vocabulary pack additive, since nothing about a primitive decides the frame.
+ * A frame is named by the key a host registers it under, not by a field it
+ * carries.
+ */
+export interface Frame<TTheme> {
+    /** Width used when the caller passes none. */
+    defaultWidth: number;
+    /**
+     * Palette per mode. Frame and palette vary independently — a branded card is
+     * this geometry with a host's colors — so a host overrides one by spreading
+     * this value rather than rebuilding anything.
+     */
+    theme: ThemePair<TTheme>;
+    /**
+     * Height for this body when the caller passes none, in the geometry this
+     * document defines. Calling {@link FrameDispatcher.estimateSnapshotHeight} is
+     * what makes a missing `metrics.snapshotHeight` size the frame short: that
+     * method returns `0` for a node whose primitive declares none.
+     */
+    estimateHeight(composition: FrameComposition, dispatcher: FrameDispatcher): number;
+    /**
+     * What this document requires of a body. A slide document's
+     * exactly-one-`slideFrame` rule is the example.
+     *
+     * Returned rather than thrown so a caller can decide what to do with it, but
+     * note where it is *not* checked: composition validation is frame-agnostic,
+     * and has to be, because the same composition can be valid in one frame and
+     * not another. Only the `snapshot` surface consults this, on the frame a render
+     * actually names, and raises before drawing. A host that wants the answer
+     * earlier asks the frame directly.
+     */
+    validateBody?(body: readonly PrimitiveNode[]): readonly string[];
+    /**
+     * Draws the surround around the already-rendered body nodes, including a
+     * title header if this document wants one.
+     *
+     * Takes the nodes as an array rather than a single `ReactNode` so a frame
+     * that draws no surround can return its one root element — image layout
+     * starts from a single element, and an array or a fragment is not one.
+     *
+     * Declared property-style, so it is checked contravariantly in `TTheme` under
+     * `strictFunctionTypes`. A method signature is bivariant, which would admit a
+     * frame needing a richer theme into a slot typed for a narrower one, where it
+     * would read a token nothing supplies.
+     */
+    wrap: (header: FrameHeader, body: FrameBody, viewport: FrameViewport<TTheme>) => ReactNode;
+}
+/**
+ * A {@link Frame} as the runtime stores it, with its theme resolved away.
+ *
+ * The erasure is a closure rather than a type parameter because the runtime
+ * dispatches nodes through one inventory keyed by node type, which has no
+ * single theme to name. A runtime's frames are homogeneous in `TTheme`, so the
+ * palette is known where it is resolved and only the resolved result is stored.
+ */
+export interface BoundFrame {
+    readonly defaultWidth: number;
+    /** See {@link Frame.estimateHeight}. */
+    estimateHeight(composition: FrameComposition, dispatcher: FrameDispatcher): number;
+    /** See {@link Frame.validateBody}; empty when this frame states no rule. */
+    validateBody(body: readonly PrimitiveNode[]): readonly string[];
+    /**
+     * Resolves {@link Frame.theme} for `mode`, erased to `unknown` like the rest
+     * of this type. Lets a caller hand the palette to a primitive's `env.theme`
+     * without itself knowing `TTheme`.
+     */
+    resolveTheme(mode: RenderTheme | undefined): unknown;
+    /** Renders the body and its surround at `viewport`'s geometry. */
+    render(composition: FrameComposition, viewport: {
+        width: number;
+        height: number;
+        mode: RenderTheme | undefined;
+    }, dispatcher: FrameDispatcher): ReactNode;
+    /** One node, no surround. */
+    renderNode(node: PrimitiveNode, dispatcher: FrameDispatcher): ReactNode;
+}
+/**
+ * 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.
+ */
+export declare const bindFrame: <TTheme>(frame: Frame<TTheme>) => BoundFrame;
+//# sourceMappingURL=frame.d.ts.map

package/dist/define/frame.d.ts.map

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

package/dist/define/frame.js

@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+/**
+ * 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.
+ */
+export 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),
+    };
+};
+//# sourceMappingURL=frame.js.map

package/dist/define/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/define/frame.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8KH;;;;GAIG;AACH,MAAM,CAAC,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","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/define/index.d.ts

@@ -0,0 +1,10 @@
+export { type BoundFrame, type Frame, type FrameBody, type FrameComposition, type FrameDispatcher, type FrameHeader, type FrameViewport, type ThemePair, bindFrame, } from './frame.js';
+export { type MarkdownBlock, type MarkdownContent, type MarkdownInline, type MarkdownInlineInput, } from './markdown_content.js';
+export { type ExampleNode, type NormalizedPrimitiveExample, type PrimitiveExample, exampleNodes, primitiveExamples, } from './primitive_example.js';
+export { type PrimitiveIcon, ICON_VARS } from './primitive_icon.js';
+export { type AnyPrimitiveDefinition, type DefaultPackTypes, type OptionalSurface, type PackTypes, type PrimitiveCatalogEntry, type PrimitiveChildRef, type PrimitiveDefinition, type PrimitiveMetrics, type PrimitiveNode, type PrimitiveRenderContext, type PrimitiveSchema, type PrimitiveStyleCollectionContext, type PrimitiveStyleCollector, type ReactContextArg, type Renderer, type Renderers, type RenderScope, type StyledRenderContext, type StyleHandle, type SurfaceMap, type ThemeTokenPath, type WithNodeFields, OPTIONAL_SURFACES, bodyNodeIdSchema, bodyNodeSurfacesSchema, definePrimitive, definePrimitiveFor, unresolvedBodyNodeSchema, validateWithSchema, } from './primitive_module.js';
+export { type SlackAssetCollector, type SlackAssetRequest, } from './slack_assets.js';
+export { type SlackActionElement, type SlackActionsBlock, type SlackBlock, type SlackButtonElement, type SlackCheckboxesElement, type SlackContextBlock, type SlackDividerBlock, type SlackFileReference, type SlackHeaderBlock, type SlackHeaderLevel, type SlackImageBlock, type SlackImageElement, type SlackMrkdwnTextObject, type SlackMultiStaticSelectElement, type SlackOptionGroup, type SlackOptionObject, type SlackOverflowElement, type SlackPlainTextObject, type SlackRadioButtonsElement, type SlackRawTextElement, type SlackRichTextBlock, type SlackRichTextBlockElement, type SlackRichTextInline, type SlackRichTextLink, type SlackRichTextList, type SlackRichTextPreformatted, type SlackRichTextQuote, type SlackRichTextSection, type SlackRichTextStyle, type SlackRichTextTag, type SlackRichTextText, type SlackSectionAccessory, type SlackSectionBlock, type SlackStaticSelectElement, type SlackTableBlock, type SlackTableCell, type SlackTableColumnSetting, type SlackTagColor, type SlackTextObject, type SlackVideoBlock, } from './slack_blocks.js';
+export { declaredFieldsNote, formatZodIssues } from './zod_format.js';
+export { requiredString, z } from './zod_helpers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,YAAY,EACZ,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC"}

package/dist/define/index.js

@@ -0,0 +1,13 @@
+/*
+ * 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 { bindFrame, } from './frame.js';
+export { exampleNodes, primitiveExamples, } from './primitive_example.js';
+export { ICON_VARS } from './primitive_icon.js';
+export { OPTIONAL_SURFACES, bodyNodeIdSchema, bodyNodeSurfacesSchema, definePrimitive, definePrimitiveFor, unresolvedBodyNodeSchema, validateWithSchema, } from './primitive_module.js';
+export { declaredFieldsNote, formatZodIssues } from './zod_format.js';
+export { requiredString, z } from './zod_helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/define/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EASL,SAAS,GACV,MAAM,SAAS,CAAC;AAOjB,OAAO,EAIL,YAAY,EACZ,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAsB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAuBL,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AA+C5B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport {\n  type 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/define/markdown_content.d.ts

@@ -0,0 +1,15 @@
+/** Brands `md` output. `Symbol.for`: ESM and CJS builds must agree. */
+export declare const markdownContent: unique symbol;
+/** Inline Markdown built with `md`. */
+export interface MarkdownInline {
+    readonly [markdownContent]: 'inline';
+}
+/** Block Markdown built with `md`. */
+export interface MarkdownBlock {
+    readonly [markdownContent]: 'block';
+}
+/** What a `markdown` renderer may return in place of a string. Nested lists flatten. */
+export type MarkdownContent = MarkdownBlock | readonly MarkdownContent[];
+/** A string is text: escaped wherever it would read as Markdown, line breaks as spaces. */
+export type MarkdownInlineInput = string | MarkdownInline;
+//# sourceMappingURL=markdown_content.d.ts.map

package/dist/define/markdown_content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown_content.d.ts","sourceRoot":"","sources":["../../src/define/markdown_content.ts"],"names":[],"mappings":"AAOA,uEAAuE;AACvE,eAAO,MAAM,eAAe,eAAgD,CAAC;AAE7E,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC;CACtC;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,wFAAwF;AACxF,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,SAAS,eAAe,EAAE,CAAC;AAEzE,2FAA2F;AAC3F,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,cAAc,CAAC"}

package/dist/define/markdown_content.js

@@ -0,0 +1,9 @@
+/*
+ * 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.
+ */
+/** Brands `md` output. `Symbol.for`: ESM and CJS builds must agree. */
+export const markdownContent = Symbol.for('elastic.isomer.markdown_content');
+//# sourceMappingURL=markdown_content.js.map

package/dist/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;AACvE,MAAM,CAAC,MAAM,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/define/primitive_example.d.ts

@@ -0,0 +1,30 @@
+import type { PrimitiveNode } from '../composition/node.js';
+/** A published example with a name hosts can list it by. */
+export interface PrimitiveExample<TNode extends PrimitiveNode = PrimitiveNode> {
+    /** Short and unique within the primitive, such as `Warning tone`. */
+    name: string;
+    /** What the example demonstrates. */
+    description?: string;
+    node: TNode;
+    /** Never set: an entry is a bare node exactly when it has a `type`. */
+    type?: never;
+}
+/** An entry of `examples` read as one shape; `name` is absent for a bare node. */
+export interface NormalizedPrimitiveExample<TNode extends PrimitiveNode = PrimitiveNode> {
+    name?: string;
+    description?: string;
+    node: TNode;
+}
+/** The node type an `examples` entry holds. */
+export type ExampleNode<TEntry> = TEntry extends PrimitiveExample<infer TNode> ? TNode : TEntry;
+interface WithExamples {
+    readonly examples: readonly (PrimitiveNode | PrimitiveExample)[];
+}
+/** Distributes over a union of definitions, so a mixed registry keeps every node type. */
+type NodeOf<TDefinition extends WithExamples> = ExampleNode<TDefinition['examples'][number]>;
+/** A definition's examples, bare or named, as {@link NormalizedPrimitiveExample}s. */
+export declare const primitiveExamples: <TDefinition extends WithExamples>({ examples, }: TDefinition) => NormalizedPrimitiveExample<NodeOf<TDefinition>>[];
+/** A definition's example nodes, without names. */
+export declare const exampleNodes: <TDefinition extends WithExamples>({ examples, }: TDefinition) => NodeOf<TDefinition>[];
+export {};
+//# sourceMappingURL=primitive_example.d.ts.map

package/dist/define/primitive_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive_example.d.ts","sourceRoot":"","sources":["../../src/define/primitive_example.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,aAAa,GAAG,aAAa;IAC3E,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,KAAK,CAAC;IACZ,uEAAuE;IACvE,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,0BAA0B,CACzC,KAAK,SAAS,aAAa,GAAG,aAAa;IAE3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,KAAK,CAAC;CACb;AAED,+CAA+C;AAC/C,MAAM,MAAM,WAAW,CAAC,MAAM,IAC5B,MAAM,SAAS,gBAAgB,CAAC,MAAM,KAAK,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhE,UAAU,YAAY;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,CAAC;CAClE;AAED,0FAA0F;AAC1F,KAAK,MAAM,CAAC,WAAW,SAAS,YAAY,IAAI,WAAW,CACzD,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAChC,CAAC;AAkBF,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,GAAI,WAAW,SAAS,YAAY,EAAE,eAEjE,WAAW,KAAG,0BAA0B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EACc,CAAC;AAE/E,mDAAmD;AACnD,eAAO,MAAM,YAAY,GAAI,WAAW,SAAS,YAAY,EAAE,eAE5D,WAAW,KAAG,MAAM,CAAC,WAAW,CAAC,EACqC,CAAC"}

package/dist/define/primitive_example.js

@@ -0,0 +1,21 @@
+/*
+ * 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 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. */
+export const primitiveExamples = ({ examples, }) => examples.map(normalize);
+/** A definition's example nodes, without names. */
+export const exampleNodes = ({ examples, }) => examples.map((entry) => normalize(entry).node);
+//# sourceMappingURL=primitive_example.js.map

package/dist/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;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAmC,EAClE,QAAQ,GACI,EAAqD,EAAE,CACnE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAsD,CAAC;AAE/E,mDAAmD;AACnD,MAAM,CAAC,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","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/define/primitive_icon.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A 16×16 glyph a host shows beside the primitive: static SVG, inlinable without a renderer.
+ *
+ * Colours go through {@link ICON_VARS}, optionally with a `currentColor` or hex fallback; `assertPackIconsValid` from `./testing` enforces the rules.
+ */
+export interface PrimitiveIcon {
+    svg: string;
+}
+/** The colour slots an icon may paint with, which a host sets per theme and mode. */
+export declare const ICON_VARS: readonly ["--isomer-icon-accent", "--isomer-icon-bg", "--isomer-icon-fg", "--isomer-icon-muted"];
+//# sourceMappingURL=primitive_icon.d.ts.map

package/dist/define/primitive_icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive_icon.d.ts","sourceRoot":"","sources":["../../src/define/primitive_icon.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qFAAqF;AACrF,eAAO,MAAM,SAAS,kGAKZ,CAAC"}

package/dist/define/primitive_icon.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.
+ */
+/** The colour slots an icon may paint with, which a host sets per theme and mode. */
+export const ICON_VARS = [
+    '--isomer-icon-accent',
+    '--isomer-icon-bg',
+    '--isomer-icon-fg',
+    '--isomer-icon-muted',
+];
+//# sourceMappingURL=primitive_icon.js.map

package/dist/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;AACrF,MAAM,CAAC,MAAM,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"]}