@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/entries/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/entries/react.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAIL,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,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 { runEnhancementScript } from '../pack/enhancements';\nexport { findNodeElementPairs } from '../render/anchors';\nexport { measureDom } from '../render/measure_dom';\nexport {\n  type CompositionWrapperOptions,\n  type ReactContentDispatcher,\n  type ReactContentOptions,\n  applyEnhancements,\n  renderCompositionContent,\n  wrapCompositionContent,\n} from '../render/react';\n"]}

package/dist/entries/slack.d.ts

@@ -0,0 +1,2 @@
+export { type SlackActionElement, type SlackActionsBlock, type SlackAssetCollector, type SlackAssetRequest, type SlackBlock, type SlackButtonElement, type SlackCheckboxesElement, type SlackContextBlock, type SlackDividerBlock, type SlackEnvelopeDispatcher, type SlackEnvelopeOptions, type SlackEnvelopeResult, 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, SLACK_LIMITS, bold, clampSlackText, code, codeBlock, createSlackAssetCollector, escapeMrkdwn, isSlackReachableImageUrl, italic, link, markdownContentToSlackBlocks, renderSlackEnvelope, slackLinkUrl, strike, } from '../render/slack/index.js';
+//# sourceMappingURL=slack.d.ts.map

package/dist/entries/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/entries/slack.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,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,EACpB,YAAY,EACZ,IAAI,EACJ,cAAc,EACd,IAAI,EACJ,SAAS,EACT,yBAAyB,EACzB,YAAY,EACZ,wBAAwB,EACxB,MAAM,EACN,IAAI,EACJ,4BAA4B,EAC5B,mBAAmB,EACnB,YAAY,EACZ,MAAM,GACP,MAAM,iBAAiB,CAAC"}

package/dist/entries/slack.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+export { SLACK_LIMITS, bold, clampSlackText, code, codeBlock, createSlackAssetCollector, escapeMrkdwn, isSlackReachableImageUrl, italic, link, markdownContentToSlackBlocks, renderSlackEnvelope, slackLinkUrl, strike, } from '../render/slack/index.js';
+//# sourceMappingURL=slack.js.map

package/dist/entries/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../src/entries/slack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EA8CL,YAAY,EACZ,IAAI,EACJ,cAAc,EACd,IAAI,EACJ,SAAS,EACT,yBAAyB,EACzB,YAAY,EACZ,wBAAwB,EACxB,MAAM,EACN,IAAI,EACJ,4BAA4B,EAC5B,mBAAmB,EACnB,YAAY,EACZ,MAAM,GACP,MAAM,iBAAiB,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 SlackActionElement,\n  type SlackActionsBlock,\n  type SlackAssetCollector,\n  type SlackAssetRequest,\n  type SlackBlock,\n  type SlackButtonElement,\n  type SlackCheckboxesElement,\n  type SlackContextBlock,\n  type SlackDividerBlock,\n  type SlackEnvelopeDispatcher,\n  type SlackEnvelopeOptions,\n  type SlackEnvelopeResult,\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  SLACK_LIMITS,\n  bold,\n  clampSlackText,\n  code,\n  codeBlock,\n  createSlackAssetCollector,\n  escapeMrkdwn,\n  isSlackReachableImageUrl,\n  italic,\n  link,\n  markdownContentToSlackBlocks,\n  renderSlackEnvelope,\n  slackLinkUrl,\n  strike,\n} from '../render/slack';\n"]}

package/dist/entries/text.d.ts

@@ -0,0 +1,2 @@
+export { type TextEnvelopeDispatcher, type TextEnvelopeOptions, renderTextEnvelope, } from '../render/text/index.js';
+//# sourceMappingURL=text.d.ts.map

package/dist/entries/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/entries/text.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/entries/text.js

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

package/dist/entries/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/entries/text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,kBAAkB,GACnB,MAAM,gBAAgB,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 TextEnvelopeDispatcher,\n  type TextEnvelopeOptions,\n  renderTextEnvelope,\n} from '../render/text';\n"]}

package/dist/pack/capabilities.d.ts

@@ -0,0 +1,41 @@
+import type { AnyPrimitivePack } from './primitive_pack.js';
+/** `native` renders through the primitive's own renderer, `fallback` through another surface's (Slack via markdown). */
+export type SurfaceSupport = 'native' | 'fallback';
+/**
+ * What a runtime or a pack supports. Enhancement ids are open strings: each
+ * pack declares its own on {@link PrimitivePack.enhancements}, and a runtime
+ * reports the union.
+ */
+export interface HostCapabilities<TEnhancement extends string = string> {
+    /** Primitive `type` values that can be dispatched. */
+    primitives: string[];
+    /** Surfaces that render, e.g. `html`, `slack`, `snapshot`. */
+    surfaces: string[];
+    /** Formats the host can ship, e.g. `html`, `slack`, `png`. Never `snapshot`, which only a rasterizer turns into a format. */
+    formats: string[];
+    /**
+     * How each of `surfaces` renders each primitive, keyed by `type` then surface.
+     * `slack` is `fallback` for a primitive with no `slack` renderer; every other
+     * surface renders from `react`, `text`, or `markdown`, which are required.
+     */
+    support: Record<string, Record<string, SurfaceSupport>>;
+    /** Progressive enhancements the packs declare, by id, which an HTML or React render may request. */
+    enhancements?: Partial<Record<TEnhancement, boolean>>;
+}
+/** What {@link describeCapabilities} reports beyond the packs themselves. */
+export interface CapabilitySources {
+    /** The surfaces the caller built; `snapshot` exists only when a host supplied a frame. */
+    surfaces: readonly string[];
+    /** Formats produced outside the surfaces, such as a rasterizer's `png`. */
+    formats?: readonly string[];
+}
+/**
+ * Reports the primitive types, surfaces, and formats a set of packs supports.
+ *
+ * `surfaces` is passed rather than derived because only the caller knows which
+ * exist. Every surface but `snapshot` is also a format; `formats` adds the ones
+ * no surface produces on its own, so a `png` is reported only when a host
+ * registers the rasterizer that writes it.
+ */
+export declare const describeCapabilities: (packs: readonly AnyPrimitivePack[], { surfaces, formats }: CapabilitySources) => HostCapabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/pack/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/pack/capabilities.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wHAAwH;AACxH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM;IACpE,sDAAsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6HAA6H;IAC7H,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IACxD,oGAAoG;IACpG,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAKD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,gBAAgB,EAAE,EAClC,uBAA4B,iBAAiB,KAC5C,gBA2BF,CAAC"}

package/dist/pack/capabilities.js

@@ -0,0 +1,36 @@
+/*
+ * 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 one surface whose output is not itself a shippable format. */
+const SNAPSHOT = 'snapshot';
+/**
+ * Reports the primitive types, surfaces, and formats a set of packs supports.
+ *
+ * `surfaces` is passed rather than derived because only the caller knows which
+ * exist. Every surface but `snapshot` is also a format; `formats` adds the ones
+ * no surface produces on its own, so a `png` is reported only when a host
+ * registers the rasterizer that writes it.
+ */
+export const describeCapabilities = (packs, { surfaces, formats = [] }) => {
+    const enhancementIds = packs.flatMap((pack) => pack.enhancements.map((definition) => definition.id));
+    const definitions = packs.flatMap((pack) => pack.primitives);
+    return {
+        primitives: definitions.map(({ type }) => type),
+        surfaces: [...surfaces],
+        formats: [...new Set([...surfaces, ...formats])].filter((format) => format !== SNAPSHOT),
+        support: Object.fromEntries(definitions.map((definition) => [
+            definition.type,
+            Object.fromEntries(surfaces.map((surface) => [surface, supportOn(definition, surface)])),
+        ])),
+        ...(enhancementIds.length > 0
+            ? {
+                enhancements: Object.fromEntries(enhancementIds.map((id) => [id, true])),
+            }
+            : {}),
+    };
+};
+const supportOn = ({ renderers }, surface) => surface === 'slack' && renderers.slack === undefined ? 'fallback' : 'native';
+//# sourceMappingURL=capabilities.js.map

package/dist/pack/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/pack/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4CH,qEAAqE;AACrE,MAAM,QAAQ,GAAG,UAAU,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAkC,EAClC,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE,EAAqB,EAC3B,EAAE;IACpB,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CACrD,CAAC;IACF,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7D,OAAO;QACL,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;QAC/C,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;QACvB,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CACrD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,QAAQ,CAChC;QACD,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI;YACf,MAAM,CAAC,WAAW,CAChB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CACrE;SACF,CAAC,CACH;QACD,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;YAC3B,CAAC,CAAC;gBACE,YAAY,EAAE,MAAM,CAAC,WAAW,CAC9B,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CACvC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAChB,EAAE,SAAS,EAA0B,EACrC,OAAe,EACC,EAAE,CAClB,OAAO,KAAK,OAAO,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,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// What a host can render, reported from packs rather than asserted by hand.\n//\n// Lives in the sdk so both the assembly layer and a pack import it from the\n// same place; a pack must not have to depend on the assembly layer for it.\n\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport type { AnyPrimitivePack } from './primitive_pack';\n\n/** `native` renders through the primitive's own renderer, `fallback` through another surface's (Slack via markdown). */\nexport type SurfaceSupport = 'native' | 'fallback';\n\n/**\n * What a runtime or a pack supports. Enhancement ids are open strings: each\n * pack declares its own on {@link PrimitivePack.enhancements}, and a runtime\n * reports the union.\n */\nexport interface HostCapabilities<TEnhancement extends string = string> {\n  /** Primitive `type` values that can be dispatched. */\n  primitives: string[];\n  /** Surfaces that render, e.g. `html`, `slack`, `snapshot`. */\n  surfaces: string[];\n  /** Formats the host can ship, e.g. `html`, `slack`, `png`. Never `snapshot`, which only a rasterizer turns into a format. */\n  formats: string[];\n  /**\n   * How each of `surfaces` renders each primitive, keyed by `type` then surface.\n   * `slack` is `fallback` for a primitive with no `slack` renderer; every other\n   * surface renders from `react`, `text`, or `markdown`, which are required.\n   */\n  support: Record<string, Record<string, SurfaceSupport>>;\n  /** Progressive enhancements the packs declare, by id, which an HTML or React render may request. */\n  enhancements?: Partial<Record<TEnhancement, boolean>>;\n}\n\n/** What {@link describeCapabilities} reports beyond the packs themselves. */\nexport interface CapabilitySources {\n  /** The surfaces the caller built; `snapshot` exists only when a host supplied a frame. */\n  surfaces: readonly string[];\n  /** Formats produced outside the surfaces, such as a rasterizer's `png`. */\n  formats?: readonly string[];\n}\n\n/** The one surface whose output is not itself a shippable format. */\nconst SNAPSHOT = 'snapshot';\n\n/**\n * Reports the primitive types, surfaces, and formats a set of packs supports.\n *\n * `surfaces` is passed rather than derived because only the caller knows which\n * exist. Every surface but `snapshot` is also a format; `formats` adds the ones\n * no surface produces on its own, so a `png` is reported only when a host\n * registers the rasterizer that writes it.\n */\nexport const describeCapabilities = (\n  packs: readonly AnyPrimitivePack[],\n  { surfaces, formats = [] }: CapabilitySources\n): HostCapabilities => {\n  const enhancementIds = packs.flatMap((pack) =>\n    pack.enhancements.map((definition) => definition.id)\n  );\n  const definitions = packs.flatMap((pack) => pack.primitives);\n  return {\n    primitives: definitions.map(({ type }) => type),\n    surfaces: [...surfaces],\n    formats: [...new Set([...surfaces, ...formats])].filter(\n      (format) => format !== SNAPSHOT\n    ),\n    support: Object.fromEntries(\n      definitions.map((definition) => [\n        definition.type,\n        Object.fromEntries(\n          surfaces.map((surface) => [surface, supportOn(definition, surface)])\n        ),\n      ])\n    ),\n    ...(enhancementIds.length > 0\n      ? {\n          enhancements: Object.fromEntries(\n            enhancementIds.map((id) => [id, true])\n          ),\n        }\n      : {}),\n  };\n};\n\nconst supportOn = (\n  { renderers }: AnyPrimitiveDefinition,\n  surface: string\n): SurfaceSupport =>\n  surface === 'slack' && renderers.slack === undefined ? 'fallback' : 'native';\n"]}

package/dist/pack/compose.d.ts

@@ -0,0 +1,24 @@
+import type { PrimitiveIcon } from '../define/primitive_icon.js';
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+import type { EnhancementDefinition } from './enhancements.js';
+import { type AnyPrimitivePack } from './primitive_pack.js';
+/**
+ * One flattened inventory owned by {@link composePacks}.
+ *
+ * `definitions` is a stable array identity, which is what the composition
+ * schema cache keys on — pass it through rather than flattening packs per call.
+ */
+export interface ComposedPacks {
+    readonly definitions: readonly AnyPrimitiveDefinition[];
+    readonly enhancements: readonly EnhancementDefinition[];
+    /** Every definition's `icon` by type, in one frozen null-prototype dictionary. */
+    readonly icons: Readonly<Record<string, PrimitiveIcon>>;
+    readonly slackAssetTypes: ReadonlySet<string>;
+}
+/**
+ * Flattens `packs` into one inventory, rejecting cross-pack duplicate node
+ * types and duplicate enhancement ids. Every offender is named in one error,
+ * so a bad three-pack composition reports all three at once.
+ */
+export declare const composePacks: (packs: readonly AnyPrimitivePack[]) => ComposedPacks;
+//# sourceMappingURL=compose.d.ts.map

package/dist/pack/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/pack/compose.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,kBAAkB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxD,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,SAAS,gBAAgB,EAAE,KACjC,aAyCF,CAAC"}

package/dist/pack/compose.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { IsomerError } from '../composition/error.js';
+import { iconsByType } from './primitive_pack.js';
+/**
+ * Flattens `packs` into one inventory, rejecting cross-pack duplicate node
+ * types and duplicate enhancement ids. Every offender is named in one error,
+ * so a bad three-pack composition reports all three at once.
+ */
+export const composePacks = (packs) => {
+    const typeOwners = new Map();
+    const enhancementOwners = new Map();
+    for (const pack of packs) {
+        for (const { type } of pack.primitives) {
+            typeOwners.set(type, [...(typeOwners.get(type) ?? []), pack.id]);
+        }
+        for (const { id } of pack.enhancements) {
+            enhancementOwners.set(id, [
+                ...(enhancementOwners.get(id) ?? []),
+                pack.id,
+            ]);
+        }
+    }
+    const repeated = [
+        ...new Set(packs
+            .map(({ id }) => id)
+            .filter((id, index, ids) => ids.indexOf(id) !== index)),
+    ];
+    if (repeated.length > 0) {
+        throw new IsomerError('DUPLICATE_PACK_ID', `composePacks: ${repeated.map((id) => `"${id}"`).join(', ')} names more than one pack; pack ids must be unique`);
+    }
+    assertUnique('DUPLICATE_PRIMITIVE_TYPE', 'primitive type', typeOwners);
+    assertUnique('DUPLICATE_ENHANCEMENT', 'enhancement', enhancementOwners);
+    const definitions = packs.flatMap((pack) => [...pack.primitives]);
+    return Object.freeze({
+        definitions: Object.freeze(definitions),
+        enhancements: Object.freeze(packs.flatMap((pack) => [...pack.enhancements])),
+        icons: iconsByType(definitions),
+        slackAssetTypes: new Set(packs.flatMap((pack) => [...pack.slackAssetTypes])),
+    });
+};
+const assertUnique = (code, noun, owners) => {
+    const duplicates = [...owners].filter(([, packs]) => packs.length > 1);
+    if (duplicates.length === 0) {
+        return;
+    }
+    throw new IsomerError(code, duplicates
+        .map(([key, packs]) => `${noun} "${key}" registered by ${packs.map((id) => `"${id}"`).join(' and ')}`)
+        .join('; '));
+};
+//# sourceMappingURL=compose.js.map

package/dist/pack/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/pack/compose.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 { IsomerError } from '../composition/error';\nimport type { PrimitiveIcon } from '../define/primitive_icon';\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport type { EnhancementDefinition } from './enhancements';\nimport { type AnyPrimitivePack, iconsByType } from './primitive_pack';\n\n/**\n * One flattened inventory owned by {@link composePacks}.\n *\n * `definitions` is a stable array identity, which is what the composition\n * schema cache keys on — pass it through rather than flattening packs per call.\n */\nexport interface ComposedPacks {\n  readonly definitions: readonly AnyPrimitiveDefinition[];\n  readonly enhancements: readonly EnhancementDefinition[];\n  /** Every definition's `icon` by type, in one frozen null-prototype dictionary. */\n  readonly icons: Readonly<Record<string, PrimitiveIcon>>;\n  readonly slackAssetTypes: ReadonlySet<string>;\n}\n\n/**\n * Flattens `packs` into one inventory, rejecting cross-pack duplicate node\n * types and duplicate enhancement ids. Every offender is named in one error,\n * so a bad three-pack composition reports all three at once.\n */\nexport const composePacks = (\n  packs: readonly AnyPrimitivePack[]\n): ComposedPacks => {\n  const typeOwners = new Map<string, string[]>();\n  const enhancementOwners = new Map<string, string[]>();\n  for (const pack of packs) {\n    for (const { type } of pack.primitives) {\n      typeOwners.set(type, [...(typeOwners.get(type) ?? []), pack.id]);\n    }\n    for (const { id } of pack.enhancements) {\n      enhancementOwners.set(id, [\n        ...(enhancementOwners.get(id) ?? []),\n        pack.id,\n      ]);\n    }\n  }\n  const repeated = [\n    ...new Set(\n      packs\n        .map(({ id }) => id)\n        .filter((id, index, ids) => ids.indexOf(id) !== index)\n    ),\n  ];\n  if (repeated.length > 0) {\n    throw new IsomerError(\n      'DUPLICATE_PACK_ID',\n      `composePacks: ${repeated.map((id) => `\"${id}\"`).join(', ')} names more than one pack; pack ids must be unique`\n    );\n  }\n  assertUnique('DUPLICATE_PRIMITIVE_TYPE', 'primitive type', typeOwners);\n  assertUnique('DUPLICATE_ENHANCEMENT', 'enhancement', enhancementOwners);\n\n  const definitions = packs.flatMap((pack) => [...pack.primitives]);\n  return Object.freeze({\n    definitions: Object.freeze(definitions),\n    enhancements: Object.freeze(\n      packs.flatMap((pack) => [...pack.enhancements])\n    ),\n    icons: iconsByType(definitions),\n    slackAssetTypes: new Set(\n      packs.flatMap((pack) => [...pack.slackAssetTypes])\n    ),\n  });\n};\n\nconst assertUnique = (\n  code: 'DUPLICATE_ENHANCEMENT' | 'DUPLICATE_PRIMITIVE_TYPE',\n  noun: string,\n  owners: ReadonlyMap<string, readonly string[]>\n): void => {\n  const duplicates = [...owners].filter(([, packs]) => packs.length > 1);\n  if (duplicates.length === 0) {\n    return;\n  }\n  throw new IsomerError(\n    code,\n    duplicates\n      .map(\n        ([key, packs]) =>\n          `${noun} \"${key}\" registered by ${packs.map((id) => `\"${id}\"`).join(' and ')}`\n      )\n      .join('; ')\n  );\n};\n"]}

package/dist/pack/enhancements.d.ts

@@ -0,0 +1,65 @@
+import type { ChildNodeWalker } from '../composition/body_node_base.js';
+import type { PrimitiveNode } from '../composition/node.js';
+/**
+ * A progressive enhancement any vocabulary pack may declare.
+ *
+ * Ids are open strings rather than a closed union so a second pack can
+ * register one without editing a shared type. Duplicate ids across packs in
+ * one runtime are rejected at construction.
+ */
+export interface EnhancementDefinition {
+    /** What a renderer tests for via `context.enhancements`. Unique across a runtime's packs. */
+    id: string;
+    /**
+     * Whether this composition has anything for the enhancement to act on.
+     * Gating on content rather than the opt-in alone is what keeps a composition
+     * with no matching node from shipping the script.
+     *
+     * `walk` is the composition's child walker, so a match nested inside a
+     * container from another pack is still found.
+     */
+    appliesTo: (body: readonly PrimitiveNode[], walk: ChildNodeWalker) => boolean;
+    /**
+     * A function body with `root: Element`, the render's `.isomer` section, in
+     * scope. It runs in its own function, so a top-level `const` or `return`
+     * cannot reach another enhancement. Absent when the host drives the
+     * enhancement itself.
+     *
+     * It must not look for its root through `document.currentScript`, which is
+     * `null` inside a shadow root. It must address markup through `data-*`
+     * attributes rather than class names: class names are minified per render,
+     * and a selector written against one is a contract nothing checks. An event
+     * meant for the host sets `composed: true` as well as `bubbles: true`, or it
+     * stops at a shadow boundary.
+     */
+    script?: string;
+    /** Renders node anchors when resolved, for an enhancement that finds nodes with `findNodeElementPairs`. */
+    anchors?: true;
+}
+/**
+ * The `definitions` that apply to `body`, the first of each id, limited to
+ * `requested` ids when given. The HTML and React surfaces both resolve through
+ * it, so the two cannot disagree on which enhancements a render carries.
+ */
+export declare const resolveEnhancements: (body: readonly PrimitiveNode[], walk: ChildNodeWalker, definitions: readonly EnhancementDefinition[], requested?: readonly string[]) => EnhancementDefinition[];
+/**
+ * Wraps one script body in its own function, so its `const`s and a top-level
+ * `return` stay its own. Anything that joins script bodies scopes each first.
+ */
+export declare const scopeScript: (body: string) => string;
+/** Marks the `<script>` a `scripts: 'embedded'` render emits. */
+export declare const EMBEDDED_SCRIPT_ATTRIBUTE = "data-isomer-script";
+/**
+ * Runs a `scripts: 'host'` render's `js` against the
+ * `.isomer` section the host inserted.
+ *
+ * Needed wherever the HTML is inserted by the host rather than parsed with the
+ * page, including every shadow root: such a `<script>` never runs, and one
+ * that did would find no `document.currentScript`.
+ *
+ * Compiles with `new Function`, so a strict Content-Security-Policy must allow
+ * `'unsafe-eval'`. A host that cannot should render with `scripts: 'embedded'`
+ * into light DOM.
+ */
+export declare const runEnhancementScript: (js: string, root: Element) => void;
+//# sourceMappingURL=enhancements.d.ts.map

package/dist/pack/enhancements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancements.d.ts","sourceRoot":"","sources":["../../src/pack/enhancements.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,6FAA6F;IAC7F,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC;IAC9E;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,MAAM,SAAS,aAAa,EAAE,EAC9B,MAAM,eAAe,EACrB,aAAa,SAAS,qBAAqB,EAAE,EAC7C,YAAY,SAAS,MAAM,EAAE,KAC5B,qBAAqB,EAcvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAoC,CAAC;AAEhF,iEAAiE;AACjE,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,MAAM,EAAE,MAAM,OAAO,KAAG,IAkBhE,CAAC"}

package/dist/pack/enhancements.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { IsomerError } from '../composition/error.js';
+/**
+ * The `definitions` that apply to `body`, the first of each id, limited to
+ * `requested` ids when given. The HTML and React surfaces both resolve through
+ * it, so the two cannot disagree on which enhancements a render carries.
+ */
+export const resolveEnhancements = (body, walk, definitions, requested) => {
+    const wanted = requested && new Set(requested);
+    const ids = new Set();
+    return definitions.filter((definition) => {
+        if (ids.has(definition.id) ||
+            (wanted && !wanted.has(definition.id)) ||
+            !definition.appliesTo(body, walk)) {
+            return false;
+        }
+        ids.add(definition.id);
+        return true;
+    });
+};
+/**
+ * Wraps one script body in its own function, so its `const`s and a top-level
+ * `return` stay its own. Anything that joins script bodies scopes each first.
+ */
+export const scopeScript = (body) => `(() => {\n${body}\n})();`;
+/** Marks the `<script>` a `scripts: 'embedded'` render emits. */
+export const EMBEDDED_SCRIPT_ATTRIBUTE = 'data-isomer-script';
+/**
+ * Runs a `scripts: 'host'` render's `js` against the
+ * `.isomer` section the host inserted.
+ *
+ * Needed wherever the HTML is inserted by the host rather than parsed with the
+ * page, including every shadow root: such a `<script>` never runs, and one
+ * that did would find no `document.currentScript`.
+ *
+ * Compiles with `new Function`, so a strict Content-Security-Policy must allow
+ * `'unsafe-eval'`. A host that cannot should render with `scripts: 'embedded'`
+ * into light DOM.
+ */
+export const runEnhancementScript = (js, root) => {
+    // Guards untyped callers; typed ones already handled `querySelector`'s null.
+    if (!root) {
+        throw new IsomerError('ENHANCEMENT_ROOT_MISSING', 'runEnhancementScript: no root element; pass the `.isomer` section the render produced');
+    }
+    if (root.querySelector(`script[${EMBEDDED_SCRIPT_ATTRIBUTE}]`)) {
+        console.warn("isomer: this HTML was rendered with scripts: 'embedded'; render with scripts: 'host' so its enhancements run once");
+    }
+    if (js) {
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval -- compiling the render's script is the point.
+        const run = new Function('root', js);
+        run(root);
+    }
+};
+//# sourceMappingURL=enhancements.js.map

package/dist/pack/enhancements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancements.js","sourceRoot":"","sources":["../../src/pack/enhancements.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAwCnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,IAA8B,EAC9B,IAAqB,EACrB,WAA6C,EAC7C,SAA6B,EACJ,EAAE;IAC3B,MAAM,MAAM,GAAG,SAAS,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE;QACvC,IACE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACtB,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACtC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EACjC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,aAAa,IAAI,SAAS,CAAC;AAEhF,iEAAiE;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,oBAAoB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,EAAU,EAAE,IAAa,EAAQ,EAAE;IACtE,6EAA6E;IAC7E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,WAAW,CACnB,0BAA0B,EAC1B,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,yBAAyB,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO,CAAC,IAAI,CACV,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,EAAE,CAAC;QACP,6GAA6G;QAC7G,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAA4B,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,CAAC;IACZ,CAAC;AACH,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\nimport type { ChildNodeWalker } from '../composition/body_node_base';\nimport { IsomerError } from '../composition/error';\nimport type { PrimitiveNode } from '../composition/node';\n\n/**\n * A progressive enhancement any vocabulary pack may declare.\n *\n * Ids are open strings rather than a closed union so a second pack can\n * register one without editing a shared type. Duplicate ids across packs in\n * one runtime are rejected at construction.\n */\nexport interface EnhancementDefinition {\n  /** What a renderer tests for via `context.enhancements`. Unique across a runtime's packs. */\n  id: string;\n  /**\n   * Whether this composition has anything for the enhancement to act on.\n   * Gating on content rather than the opt-in alone is what keeps a composition\n   * with no matching node from shipping the script.\n   *\n   * `walk` is the composition's child walker, so a match nested inside a\n   * container from another pack is still found.\n   */\n  appliesTo: (body: readonly PrimitiveNode[], walk: ChildNodeWalker) => boolean;\n  /**\n   * A function body with `root: Element`, the render's `.isomer` section, in\n   * scope. It runs in its own function, so a top-level `const` or `return`\n   * cannot reach another enhancement. Absent when the host drives the\n   * enhancement itself.\n   *\n   * It must not look for its root through `document.currentScript`, which is\n   * `null` inside a shadow root. It must address markup through `data-*`\n   * attributes rather than class names: class names are minified per render,\n   * and a selector written against one is a contract nothing checks. An event\n   * meant for the host sets `composed: true` as well as `bubbles: true`, or it\n   * stops at a shadow boundary.\n   */\n  script?: string;\n  /** Renders node anchors when resolved, for an enhancement that finds nodes with `findNodeElementPairs`. */\n  anchors?: true;\n}\n\n/**\n * The `definitions` that apply to `body`, the first of each id, limited to\n * `requested` ids when given. The HTML and React surfaces both resolve through\n * it, so the two cannot disagree on which enhancements a render carries.\n */\nexport const resolveEnhancements = (\n  body: readonly PrimitiveNode[],\n  walk: ChildNodeWalker,\n  definitions: readonly EnhancementDefinition[],\n  requested?: readonly string[]\n): EnhancementDefinition[] => {\n  const wanted = requested && new Set(requested);\n  const ids = new Set<string>();\n  return definitions.filter((definition) => {\n    if (\n      ids.has(definition.id) ||\n      (wanted && !wanted.has(definition.id)) ||\n      !definition.appliesTo(body, walk)\n    ) {\n      return false;\n    }\n    ids.add(definition.id);\n    return true;\n  });\n};\n\n/**\n * Wraps one script body in its own function, so its `const`s and a top-level\n * `return` stay its own. Anything that joins script bodies scopes each first.\n */\nexport const scopeScript = (body: string): string => `(() => {\\n${body}\\n})();`;\n\n/** Marks the `<script>` a `scripts: 'embedded'` render emits. */\nexport const EMBEDDED_SCRIPT_ATTRIBUTE = 'data-isomer-script';\n\n/**\n * Runs a `scripts: 'host'` render's `js` against the\n * `.isomer` section the host inserted.\n *\n * Needed wherever the HTML is inserted by the host rather than parsed with the\n * page, including every shadow root: such a `<script>` never runs, and one\n * that did would find no `document.currentScript`.\n *\n * Compiles with `new Function`, so a strict Content-Security-Policy must allow\n * `'unsafe-eval'`. A host that cannot should render with `scripts: 'embedded'`\n * into light DOM.\n */\nexport const runEnhancementScript = (js: string, root: Element): void => {\n  // Guards untyped callers; typed ones already handled `querySelector`'s null.\n  if (!root) {\n    throw new IsomerError(\n      'ENHANCEMENT_ROOT_MISSING',\n      'runEnhancementScript: no root element; pass the `.isomer` section the render produced'\n    );\n  }\n  if (root.querySelector(`script[${EMBEDDED_SCRIPT_ATTRIBUTE}]`)) {\n    console.warn(\n      \"isomer: this HTML was rendered with scripts: 'embedded'; render with scripts: 'host' so its enhancements run once\"\n    );\n  }\n  if (js) {\n    // eslint-disable-next-line @typescript-eslint/no-implied-eval -- compiling the render's script is the point.\n    const run = new Function('root', js) as (root: Element) => void;\n    run(root);\n  }\n};\n"]}

package/dist/pack/index.d.ts

@@ -0,0 +1,5 @@
+export { type CapabilitySources, type HostCapabilities, type SurfaceSupport, describeCapabilities, } from './capabilities.js';
+export { type ComposedPacks, composePacks } from './compose.js';
+export { type EnhancementDefinition, scopeScript } from './enhancements.js';
+export { type AnyPrimitivePack, type PackAuthoringOptions, type PackStyleAdapter, type PrimitiveGroup, type PrimitivePack, type PrimitivePackInput, definePrimitivePack, } from './primitive_pack.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,KAAK,qBAAqB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/pack/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 { describeCapabilities, } from './capabilities.js';
+export { composePacks } from './compose.js';
+export { scopeScript } from './enhancements.js';
+export { definePrimitivePack, } from './primitive_pack.js';
+//# sourceMappingURL=index.js.map

package/dist/pack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pack/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAsB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAA8B,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAOL,mBAAmB,GACpB,MAAM,kBAAkB,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 CapabilitySources,\n  type HostCapabilities,\n  type SurfaceSupport,\n  describeCapabilities,\n} from './capabilities';\nexport { type ComposedPacks, composePacks } from './compose';\nexport { type EnhancementDefinition, scopeScript } from './enhancements';\nexport {\n  type AnyPrimitivePack,\n  type PackAuthoringOptions,\n  type PackStyleAdapter,\n  type PrimitiveGroup,\n  type PrimitivePack,\n  type PrimitivePackInput,\n  definePrimitivePack,\n} from './primitive_pack';\n"]}

package/dist/pack/primitive_pack.d.ts

@@ -0,0 +1,164 @@
+import type { PrimitiveIcon } from '../define/primitive_icon.js';
+import type { AnyPrimitiveDefinition, OptionalSurface, StyleHandle } from '../define/primitive_module.js';
+import type { EnhancementDefinition } from './enhancements.js';
+/**
+ * The authoring-schema material a pack contributes for its own primitives.
+ *
+ * A subset of `AuthoringJsonSchemaOptions`: `$id`, `title`, `description`, and
+ * `composition` describe the whole authoring schema a runtime builds, which is
+ * a host decision, not a pack one. `pack/` does not import `validate/` for
+ * this, so the shape is declared here rather than reused by reference.
+ */
+export interface PackAuthoringOptions {
+    /** `$def` id to `description`, for this pack's own primitives. */
+    describe?: Readonly<Record<string, string>>;
+    /** `$defId.property` paths to drop, from this pack's own primitives. */
+    omitProperties?: readonly string[];
+    /** Headings an index catalog sorts this pack's primitives under, in order. */
+    groups?: readonly PrimitiveGroup[];
+}
+/** A titled set of primitive types, listed together in an index catalog. */
+export interface PrimitiveGroup {
+    title: string;
+    types: readonly string[];
+}
+/**
+ * The HTML style-adapter hooks a pack may declare. Typed loosely here so `pack/` does not import `render/`.
+ */
+export type PackStyleAdapter = {
+    /** See {@link PrimitivePackInput.styleCollector}. */
+    styleCollector?: string;
+    /** The hooks of `HTMLStyleAdapter` from `./html`, erased: a fresh collector per render, the context renderers receive, and the stylesheet the collector produced. */
+    createCollector: (...args: never[]) => object;
+    createRenderContext: (...args: never[]) => unknown;
+    renderStyles: (...args: never[]) => string;
+    /**
+     * Whether `handle` belongs to this adapter's stylesheet. Required for a runtime to combine several packs' CSS: without it their handles cannot be routed and the host must pick one adapter.
+     */
+    ownsHandle?: (handle: StyleHandle) => boolean;
+};
+/** What a pack author passes to {@link definePrimitivePack}. */
+export interface PrimitivePackInput {
+    /** Stable identifier, used in capability reports and error messages. */
+    id: string;
+    /**
+     * The optional surfaces this pack's primitives implement.
+     *
+     * Only `slack`, and it stays optional per primitive: the dispatcher converts
+     * the mandatory markdown to Block Kit, so declaring it reports an intent
+     * rather than imposing a requirement. Omit it entirely for a pack that
+     * renders Slack through that fallback.
+     */
+    surfaces?: readonly OptionalSurface[];
+    /** This pack's vocabulary. Node types must be unique within it, or construction throws. */
+    primitives: readonly AnyPrimitiveDefinition[];
+    /**
+     * Progressive enhancements this pack's primitives can apply, by id.
+     *
+     * Declared by the pack because an enhancement is a fact about its
+     * vocabulary — a sortable table, a copyable code block — and a host
+     * composing packs it did not write cannot be expected to know the ids.
+     * The runtime flattens these across packs; duplicate ids are rejected.
+     */
+    enhancements?: readonly EnhancementDefinition[];
+    /**
+     * Types that render as a self-contained picture rather than as text.
+     *
+     * A channel that cannot draw them inline uploads an image instead: the Slack
+     * dispatcher swaps such a node for an `image` block and an upload request, so
+     * a chart arrives as a PNG rather than as a markdown approximation of one.
+     *
+     * Declared by the pack because it is a fact about the vocabulary, and a host
+     * composing packs it did not write cannot be expected to know it.
+     */
+    slackAssetTypes?: readonly string[];
+    /**
+     * Default HTML style adapter for this pack. A runtime that omits
+     * `styleAdapter` runs the packs' own adapters, combined when more than one
+     * pack declares one and each answers `ownsHandle`. Pass `styleAdapter` on
+     * the runtime to replace them all.
+     */
+    styleAdapter?: PackStyleAdapter;
+    /**
+     * Names the collector shape this pack's `collectStyles` hooks mutate, so a
+     * runtime can reject a pack paired with an adapter of a different tag.
+     * Defaults to `styleAdapter.styleCollector`; a pack with neither opts out of
+     * the check.
+     */
+    styleCollector?: string;
+    /**
+     * This pack's own contribution to the runtime's authoring JSON Schema.
+     *
+     * Merged across every composed pack, so a host does not hand-merge each
+     * pack's `describe`/`omitProperties` into one options object itself. The
+     * runtime-level `authoring` option is merged in last and wins on conflict.
+     */
+    authoring?: PackAuthoringOptions;
+}
+/**
+ * A pack as the runtime sees it.
+ *
+ * `TTheme` is the palette this pack's `react` renderers read as `env.theme`
+ * when drawn through the `snapshot` surface — a *lower bound* on whatever theme
+ * the runtime holding it supplies. It is carried by
+ * {@link PrimitivePack.__theme} rather than by any real field, because
+ * `primitives` is erased to `AnyPrimitiveDefinition[]` and a heterogeneous
+ * inventory has no single node type to be generic over.
+ *
+ * The bound is declared, not derived: nothing checks it against what the
+ * renderers actually read. State it at the definition as
+ * `definePrimitivePack<T>(input)`.
+ * Bare `PrimitivePack` requires nothing and fits any runtime; a slot that must
+ * hold packs of every palette is typed {@link AnyPrimitivePack}.
+ */
+export interface PrimitivePack<TTheme = unknown> {
+    /** Unique among the packs a runtime composes, and used in error messages. */
+    readonly id: string;
+    /** See {@link PrimitivePackInput.surfaces}. */
+    readonly surfaces: readonly OptionalSurface[];
+    /** See {@link PrimitivePackInput.primitives}. */
+    readonly primitives: readonly AnyPrimitiveDefinition[];
+    /** Node types this pack owns, for duplicate detection across packs. */
+    readonly types: ReadonlySet<string>;
+    /**
+     * Each primitive's `icon` by type, for the primitives that declare one, so a host listing them need not walk `primitives`.
+     *
+     * A frozen null-prototype dictionary: an absent type reads `undefined`, even `constructor`. Absent on a pack built by an SDK that predates icons; {@link iconsByType} derives it from `primitives`.
+     */
+    readonly icons?: Readonly<Record<string, PrimitiveIcon>>;
+    /** See {@link PrimitivePackInput.enhancements}. */
+    readonly enhancements: readonly EnhancementDefinition[];
+    /** See {@link PrimitivePackInput.slackAssetTypes}. */
+    readonly slackAssetTypes: ReadonlySet<string>;
+    /** See {@link PrimitivePackInput.styleAdapter}. */
+    readonly styleAdapter?: PackStyleAdapter;
+    /** See {@link PrimitivePackInput.styleCollector}. */
+    readonly styleCollector?: string;
+    /** See {@link PrimitivePackInput.authoring}. */
+    readonly authoring?: PackAuthoringOptions;
+    /**
+     * Phantom: never present at runtime, never read.
+     *
+     * A property rather than a method so `strictFunctionTypes` checks it
+     * contravariantly. A method signature is bivariant, which would let a pack
+     * needing richer tokens sit in a slot supplying fewer and then read a field
+     * nothing supplies — the exact failure this marker exists to prevent.
+     */
+    readonly __theme?: (theme: TTheme) => void;
+}
+/**
+ * A pack of any palette, for storage positions: `never` is assignable to every
+ * requirement, so a slot typed this way holds every pack.
+ */
+export type AnyPrimitivePack = PrimitivePack<never>;
+/**
+ * Builds a {@link PrimitivePack}.
+ *
+ * `TTheme` is the palette a frame must supply for this pack's nodes to be drawn
+ * on the `snapshot` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is
+ * `unknown`, which requires nothing.
+ */
+export declare const definePrimitivePack: <TTheme = unknown>(input: PrimitivePackInput) => PrimitivePack<TTheme>;
+/** Each definition's `icon` by type, null-prototype so a type such as `__proto__` is an ordinary key. */
+export declare const iconsByType: (primitives: readonly AnyPrimitiveDefinition[]) => Readonly<Record<string, PrimitiveIcon>>;
+//# sourceMappingURL=primitive_pack.d.ts.map

package/dist/pack/primitive_pack.d.ts.map

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