@elastic/isomer-sdk 0.0.0 → 0.1.0

package/dist/define/frame.d.ts

@@ -0,0 +1,166 @@
+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 `svg` surface. `key` must be unique among its siblings. */
+    renderSvg(node: TNode, key: string): ReactNode;
+    /** The node's height in pixels; `0` when it is hidden from `svg` or its primitive declares no `metrics.svgHeight`. */
+    estimateSvgHeight(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 an `svg` 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;
+    /**
+     * Whether {@link Frame.estimateHeight} sums per-node heights, and so
+     * under-sizes the frame for a node whose primitive declares no
+     * `metrics.svgHeight` — `dispatcher.estimateSvgHeight` returns `0` for those.
+     *
+     * Defaults to `true`, because the gap is silent and a frame that measures
+     * nodes is the normal case. A fixed-size frame sets `false` once and stops
+     * the missing `svgHeight` warning reporting a metric nothing reads.
+     */
+    sizesFromNodeHeights?: boolean;
+    /**
+     * 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. See {@link Frame.sizesFromNodeHeights} for what it may
+     * assume of the nodes.
+     */
+    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 `svg` 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.sizesFromNodeHeights}; defaulted at binding. */
+    readonly sizesFromNodeHeights: boolean;
+    /** 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,28 @@
+/*
+ * 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,
+        sizesFromNodeHeights: frame.sizesFromNodeHeights ?? true,
+        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.renderSvg(node, `body-${index}`)), { ...viewport, theme });
+        },
+        renderNode: (node, dispatcher) => dispatcher.renderSvg(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;AAyLH;;;;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,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,IAAI,IAAI;QACxD,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,SAAS,CAAC,IAAI,EAAE,QAAQ,KAAK,EAAE,CAAC,CAC5C,EACD,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CACvB,CAAC;QACJ,CAAC;QACD,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;KACxE,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 an `svg` 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 `svg` surface. `key` must be unique among its siblings. */\n  renderSvg(node: TNode, key: string): ReactNode;\n  /** The node's height in pixels; `0` when it is hidden from `svg` or its primitive declares no `metrics.svgHeight`. */\n  estimateSvgHeight(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 an `svg` 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   * Whether {@link Frame.estimateHeight} sums per-node heights, and so\n   * under-sizes the frame for a node whose primitive declares no\n   * `metrics.svgHeight` — `dispatcher.estimateSvgHeight` returns `0` for those.\n   *\n   * Defaults to `true`, because the gap is silent and a frame that measures\n   * nodes is the normal case. A fixed-size frame sets `false` once and stops\n   * the missing `svgHeight` warning reporting a metric nothing reads.\n   */\n  sizesFromNodeHeights?: boolean;\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. See {@link Frame.sizesFromNodeHeights} for what it may\n   * assume of the nodes.\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 `svg` 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.sizesFromNodeHeights}; defaulted at binding. */\n  readonly sizesFromNodeHeights: boolean;\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    sizesFromNodeHeights: frame.sizesFromNodeHeights ?? true,\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.renderSvg(node, `body-${index}`)\n        ),\n        { ...viewport, theme }\n      );\n    },\n    renderNode: (node, dispatcher) => dispatcher.renderSvg(node, node.type),\n  };\n};\n"]}

package/dist/define/index.d.ts

@@ -0,0 +1,8 @@
+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 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, 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,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,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,11 @@
+/*
+ * 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 { 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,EAuBL,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 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  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"]}