@elastic/isomer-sdk 0.0.0 → 0.1.0

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, gfmToSlackBlocks, 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,gBAAgB,EAChB,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  gfmToSlackBlocks,\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,27 @@
+import type { AnyPrimitivePack } from './primitive_pack.js';
+/**
+ * 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[];
+    /** Render formats reachable, e.g. `html`, `slack`, `png`. */
+    formats: string[];
+    /** Progressive enhancements the packs declare, by id, which an HTML or React render may request. */
+    enhancements?: Partial<Record<TEnhancement, boolean>>;
+}
+/**
+ * Reports the primitive types and render formats a set of packs supports.
+ *
+ * `formats` is passed rather than derived because only the caller knows which
+ * surfaces exist: a runtime passes the surfaces it built, and a pack passes
+ * what it can produce through its own entry points — a `png` reachable only
+ * behind a host image binding is something no runtime can infer. `svg` in
+ * particular depends on a frame, which is a runtime input and not a pack's to
+ * report.
+ * @param formats Candidate formats this caller can reach.
+ */
+export declare const describeCapabilities: (packs: readonly AnyPrimitivePack[], formats: readonly string[]) => 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":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM;IACpE,sDAAsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oGAAoG;IACpG,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,gBAAgB,EAAE,EAClC,SAAS,SAAS,MAAM,EAAE,KACzB,gBAiBF,CAAC"}

package/dist/pack/capabilities.js

@@ -0,0 +1,30 @@
+/*
+ * 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.
+ */
+/**
+ * Reports the primitive types and render formats a set of packs supports.
+ *
+ * `formats` is passed rather than derived because only the caller knows which
+ * surfaces exist: a runtime passes the surfaces it built, and a pack passes
+ * what it can produce through its own entry points — a `png` reachable only
+ * behind a host image binding is something no runtime can infer. `svg` in
+ * particular depends on a frame, which is a runtime input and not a pack's to
+ * report.
+ * @param formats Candidate formats this caller can reach.
+ */
+export const describeCapabilities = (packs, formats) => {
+    const enhancementIds = packs.flatMap((pack) => pack.enhancements.map((definition) => definition.id));
+    return {
+        primitives: packs.flatMap((pack) => pack.primitives.map((definition) => definition.type)),
+        formats: [...formats],
+        ...(enhancementIds.length > 0
+            ? {
+                enhancements: Object.fromEntries(enhancementIds.map((id) => [id, true])),
+            }
+            : {}),
+    };
+};
+//# 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;AAuBH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAkC,EAClC,OAA0B,EACR,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,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CACrD;QACD,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;QACrB,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","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 { AnyPrimitivePack } from './primitive_pack';\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  /** Render formats reachable, e.g. `html`, `slack`, `png`. */\n  formats: string[];\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/**\n * Reports the primitive types and render formats a set of packs supports.\n *\n * `formats` is passed rather than derived because only the caller knows which\n * surfaces exist: a runtime passes the surfaces it built, and a pack passes\n * what it can produce through its own entry points — a `png` reachable only\n * behind a host image binding is something no runtime can infer. `svg` in\n * particular depends on a frame, which is a runtime input and not a pack's to\n * report.\n * @param formats Candidate formats this caller can reach.\n */\nexport const describeCapabilities = (\n  packs: readonly AnyPrimitivePack[],\n  formats: readonly string[]\n): HostCapabilities => {\n  const enhancementIds = packs.flatMap((pack) =>\n    pack.enhancements.map((definition) => definition.id)\n  );\n  return {\n    primitives: packs.flatMap((pack) =>\n      pack.primitives.map((definition) => definition.type)\n    ),\n    formats: [...formats],\n    ...(enhancementIds.length > 0\n      ? {\n          enhancements: Object.fromEntries(\n            enhancementIds.map((id) => [id, true])\n          ),\n        }\n      : {}),\n  };\n};\n"]}

package/dist/pack/compose.d.ts

@@ -0,0 +1,21 @@
+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[];
+    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,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,SAAS,qBAAqB,EAAE,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,aAuCF,CAAC"}

package/dist/pack/compose.js

@@ -0,0 +1,52 @@
+/*
+ * 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';
+/**
+ * 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);
+    return Object.freeze({
+        definitions: Object.freeze(packs.flatMap((pack) => [...pack.primitives])),
+        enhancements: Object.freeze(packs.flatMap((pack) => [...pack.enhancements])),
+        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 { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport type { EnhancementDefinition } from './enhancements';\nimport type { AnyPrimitivePack } 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  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  return Object.freeze({\n    definitions: Object.freeze(packs.flatMap((pack) => [...pack.primitives])),\n    enhancements: Object.freeze(\n      packs.flatMap((pack) => [...pack.enhancements])\n    ),\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 HostCapabilities, 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,EAAE,KAAK,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,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,EAAyB,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,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 { type HostCapabilities, describeCapabilities } 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,155 @@
+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 `svg` 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>;
+    /** 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 `svg` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is
+ * `unknown`, which requires nothing.
+ */
+export declare const definePrimitivePack: <TTheme = unknown>(input: PrimitivePackInput) => PrimitivePack<TTheme>;
+//# 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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"}

package/dist/pack/primitive_pack.js

@@ -0,0 +1,81 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+// A primitive pack as a value: a vocabulary, and the optional surfaces every
+// primitive in it implements. Additive: a runtime composes any number of packs,
+// and nothing about a pack decides how a composition is framed.
+import { IsomerError } from '../composition/error.js';
+/**
+ * Builds a {@link PrimitivePack}.
+ *
+ * `TTheme` is the palette a frame must supply for this pack's nodes to be drawn
+ * on the `svg` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is
+ * `unknown`, which requires nothing.
+ */
+export const definePrimitivePack = (input) => {
+    if (input.primitives.length === 0) {
+        throw new IsomerError('EMPTY_PACK', `primitive pack "${input.id}": at least one primitive is required`);
+    }
+    assertUniquePrimitiveTypes(input.id, input.primitives);
+    assertUniqueEnhancementIds(input.id, input.enhancements ?? []);
+    const types = new Set(input.primitives.map((definition) => definition.type));
+    assertGroupedOnce(input.id, input.authoring?.groups ?? [], types);
+    for (const type of input.slackAssetTypes ?? []) {
+        if (!types.has(type)) {
+            throw new IsomerError('UNKNOWN_PRIMITIVE_TYPE', `primitive pack "${input.id}": slackAssetTypes names primitive type "${type}", which the pack does not register`);
+        }
+    }
+    const styleCollector = input.styleCollector ?? input.styleAdapter?.styleCollector;
+    return {
+        id: input.id,
+        surfaces: input.surfaces ?? [],
+        primitives: input.primitives,
+        types,
+        enhancements: input.enhancements ?? [],
+        slackAssetTypes: new Set(input.slackAssetTypes ?? []),
+        ...(input.styleAdapter !== undefined
+            ? { styleAdapter: input.styleAdapter }
+            : {}),
+        ...(styleCollector !== undefined ? { styleCollector } : {}),
+        ...(input.authoring !== undefined ? { authoring: input.authoring } : {}),
+    };
+};
+/** Throws if `primitives` repeats a type. */
+const assertUniquePrimitiveTypes = (id, primitives) => {
+    const seen = new Set();
+    for (const { type } of primitives) {
+        if (seen.has(type)) {
+            throw new IsomerError('DUPLICATE_PRIMITIVE_TYPE', `primitive pack "${id}": primitive type "${type}" registered twice`);
+        }
+        seen.add(type);
+    }
+};
+/** Throws if a group names a type outside `types`, or two groups share a type. */
+const assertGroupedOnce = (id, groups, types) => {
+    const grouped = new Set();
+    for (const { title, types: members } of groups) {
+        for (const type of members) {
+            if (!types.has(type)) {
+                throw new IsomerError('UNKNOWN_PRIMITIVE_TYPE', `primitive pack "${id}": group "${title}" names primitive type "${type}", which the pack does not register`);
+            }
+            if (grouped.has(type)) {
+                throw new IsomerError('DUPLICATE_PRIMITIVE_TYPE', `primitive pack "${id}": primitive type "${type}" is in two groups`);
+            }
+            grouped.add(type);
+        }
+    }
+};
+/** Throws if this pack registers the same enhancement id twice. */
+const assertUniqueEnhancementIds = (id, enhancements) => {
+    const seen = new Set();
+    for (const definition of enhancements) {
+        if (seen.has(definition.id)) {
+            throw new IsomerError('DUPLICATE_ENHANCEMENT', `primitive pack "${id}": enhancement "${definition.id}" registered twice`);
+        }
+        seen.add(definition.id);
+    }
+};
+//# sourceMappingURL=primitive_pack.js.map