@elastic/isomer-sdk 0.1.0 → 0.3.0

package/dist/cjs/author/schema_to_typescript.js

@@ -0,0 +1,298 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTypePrinter = exports.jsDoc = exports.pascalCase = exports.ownDef = exports.parseDefRef = exports.isJsonObject = exports.IDENTIFIER = exports.ANONYMOUS_DEF = exports.DEF_PREFIX = void 0;
+exports.DEF_PREFIX = '#/$defs/';
+/** Ids `z.toJSONSchema` gives a def no one named. */
+exports.ANONYMOUS_DEF = /^__schema\d+$/;
+const STRUCTURAL_KEYS = [
+    'type',
+    'const',
+    'enum',
+    'properties',
+    'additionalProperties',
+    'patternProperties',
+    'propertyNames',
+    'items',
+    'prefixItems',
+    'oneOf',
+    'anyOf',
+    'allOf',
+];
+const INDENT = '  ';
+exports.IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
+const isJsonObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+exports.isJsonObject = isJsonObject;
+const parseDefRef = (ref) => typeof ref === 'string' && ref.startsWith(exports.DEF_PREFIX)
+    ? ref.slice(exports.DEF_PREFIX.length)
+    : undefined;
+exports.parseDefRef = parseDefRef;
+const ownDef = (defs, id) => Object.hasOwn(defs, id) ? defs[id] : undefined;
+exports.ownDef = ownDef;
+/** `slideStats` becomes `SlideStats`; anything but letters and digits splits words. */
+const pascalCase = (value) => {
+    const name = value
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map((word) => `${word.slice(0, 1).toUpperCase()}${word.slice(1)}`)
+        .join('');
+    if (name === '') {
+        return 'Type';
+    }
+    return /^\d/.test(name) ? `_${name}` : name;
+};
+exports.pascalCase = pascalCase;
+/** A JSDoc block for `lines`, or `''` when there are none. */
+const jsDoc = (lines, pad) => {
+    const text = lines
+        .flatMap((line) => line.split('\n'))
+        .map((line) => line.replaceAll('*/', '*\\/').trimEnd());
+    while (text[0] === '') {
+        text.shift();
+    }
+    while (text.at(-1) === '') {
+        text.pop();
+    }
+    if (text.length === 0) {
+        return '';
+    }
+    const [only] = text;
+    if (text.length === 1 && only !== undefined) {
+        return `${pad}/** ${only} */\n`;
+    }
+    return `${pad}/**\n${text
+        .map((line) => (line === '' ? `${pad} *` : `${pad} * ${line}`))
+        .join('\n')}\n${pad} */\n`;
+};
+exports.jsDoc = jsDoc;
+const propertyKey = (key) => exports.IDENTIFIER.test(key) ? key : JSON.stringify(key);
+const literal = (value) => {
+    if (value === null) {
+        return 'null';
+    }
+    switch (typeof value) {
+        case 'string':
+            return JSON.stringify(value);
+        case 'number':
+        case 'boolean':
+            return String(value);
+        default:
+            return 'unknown';
+    }
+};
+const atom = (text) => ({ text, kind: 'atom' });
+const union = (members) => {
+    if (members.some(({ text }) => text === 'unknown')) {
+        return atom('unknown');
+    }
+    const unique = new Map(members.map((member) => [member.text, member]));
+    const [only] = [...unique.values()];
+    if (unique.size === 0) {
+        return atom('never');
+    }
+    return unique.size === 1 && only
+        ? only
+        : { text: [...unique.keys()].join(' | '), kind: 'union' };
+};
+const intersection = (members) => {
+    const unique = new Map(members.map((member) => [member.text, member]));
+    const [only] = [...unique.values()];
+    if (!only) {
+        return atom('unknown');
+    }
+    if (unique.size === 1 && only) {
+        return only;
+    }
+    return {
+        text: [...unique.values()]
+            .map(({ text, kind }) => (kind === 'union' ? `(${text})` : text))
+            .join(' & '),
+        kind: 'intersection',
+    };
+};
+const arrayOf = ({ text, kind }) => atom(kind === 'atom' ? `${text}[]` : `(${text})[]`);
+/** A TypeScript printer over the subset of JSON Schema `z.toJSONSchema` emits. */
+const createTypePrinter = ({ defs, names, claim, }) => {
+    const promotedNames = new Map();
+    const printRef = (id, depth, active) => {
+        const named = names.get(id);
+        if (named !== undefined) {
+            return atom(named);
+        }
+        const target = (0, exports.ownDef)(defs, id);
+        if (target === undefined) {
+            return atom('unknown');
+        }
+        if (active.has(id)) {
+            const name = promotedNames.get(id) ?? claim((0, exports.pascalCase)(id));
+            promotedNames.set(id, name);
+            return atom(name);
+        }
+        return printNode(target, depth, new Set([...active, id]));
+    };
+    const printNode = (node, depth, active) => {
+        if (node === false) {
+            return atom('never');
+        }
+        if (!(0, exports.isJsonObject)(node)) {
+            return atom('unknown');
+        }
+        const parts = [];
+        const ref = (0, exports.parseDefRef)(node.$ref);
+        if (ref !== undefined) {
+            parts.push(printRef(ref, depth, active));
+        }
+        if (STRUCTURAL_KEYS.some((key) => Object.hasOwn(node, key))) {
+            parts.push(printStructure(node, depth, active));
+        }
+        return parts.length === 0 ? atom('unknown') : intersection(parts);
+    };
+    const printStructure = (node, depth, active) => {
+        const parts = [];
+        const own = printOwn(node, depth, active);
+        if (own) {
+            parts.push(own);
+        }
+        for (const key of ['oneOf', 'anyOf']) {
+            const members = node[key];
+            if (Array.isArray(members)) {
+                parts.push(union(members.map((member) => printNode(member, depth, active))));
+            }
+        }
+        if (Array.isArray(node.allOf)) {
+            parts.push(intersection(node.allOf.map((member) => printNode(member, depth, active))));
+        }
+        return parts.length === 0 ? atom('unknown') : intersection(parts);
+    };
+    // `undefined` when the node only combines other schemas.
+    const printOwn = (node, depth, active) => {
+        if (Object.hasOwn(node, 'const')) {
+            return atom(literal(node.const));
+        }
+        if (Array.isArray(node.enum)) {
+            return union(node.enum.map((value) => atom(literal(value))));
+        }
+        const { type } = node;
+        if (Array.isArray(type)) {
+            return union(type.map((member) => printTyped(member, node, depth, active)));
+        }
+        if (typeof type === 'string') {
+            return printTyped(type, node, depth, active);
+        }
+        if (Object.hasOwn(node, 'properties') ||
+            Object.hasOwn(node, 'additionalProperties')) {
+            return printObject(node, depth, active);
+        }
+        if (Object.hasOwn(node, 'items') || Object.hasOwn(node, 'prefixItems')) {
+            return printArray(node, depth, active);
+        }
+        return undefined;
+    };
+    const printTyped = (type, node, depth, active) => {
+        switch (type) {
+            case 'string':
+                return atom('string');
+            case 'number':
+            case 'integer':
+                return atom('number');
+            case 'boolean':
+                return atom('boolean');
+            case 'null':
+                return atom('null');
+            case 'array':
+                return printArray(node, depth, active);
+            case 'object':
+                return printObject(node, depth, active);
+            default:
+                return atom('unknown');
+        }
+    };
+    const printArray = (node, depth, active) => {
+        const { prefixItems, items } = node;
+        if (Array.isArray(prefixItems)) {
+            const required = typeof node.minItems === 'number' ? node.minItems : 0;
+            const elements = prefixItems.map((item, index) => {
+                const printed = printNode(item, depth, active);
+                return index < required
+                    ? printed.text
+                    : `${printed.kind === 'atom' ? printed.text : `(${printed.text})`}?`;
+            });
+            if (items !== undefined && items !== false) {
+                elements.push(`...${arrayOf(printNode(items, depth, active)).text}`);
+            }
+            return atom(`[${elements.join(', ')}]`);
+        }
+        return arrayOf(items === undefined ? atom('unknown') : printNode(items, depth, active));
+    };
+    const printObject = (node, depth, active) => {
+        const properties = (0, exports.isJsonObject)(node.properties) ? node.properties : {};
+        const lines = printMembers(node, depth, active, {});
+        const extra = node.additionalProperties;
+        const patterns = (0, exports.isJsonObject)(node.patternProperties)
+            ? Object.values(node.patternProperties)
+            : [];
+        const open = extra !== false;
+        const values = [
+            ...patterns.map((schema) => printNode(schema, depth, active)),
+        ];
+        if (open) {
+            values.push(extra === undefined || extra === true
+                ? atom('unknown')
+                : printNode(extra, depth, active));
+        }
+        const index = values.length === 0
+            ? Object.keys(properties).length === 0
+                ? `${INDENT.repeat(depth + 1)}[key: string]: never;\n`
+                : ''
+            : `${INDENT.repeat(depth + 1)}[key: string]: ${union([
+                ...values,
+                ...Object.values(properties).map((schema) => printNode(schema, depth, active)),
+                ...(Object.keys(properties).some((key) => !Array.isArray(node.required) || !node.required.includes(key))
+                    ? [atom('undefined')]
+                    : []),
+            ]).text};\n`;
+        return atom(`{\n${lines}${index}${INDENT.repeat(depth)}}`);
+    };
+    const printMembers = (node, depth, active, { omit, optional }) => {
+        const pad = INDENT.repeat(depth + 1);
+        const required = new Set(Array.isArray(node.required)
+            ? node.required.filter((key) => typeof key === 'string')
+            : []);
+        const properties = (0, exports.isJsonObject)(node.properties) ? node.properties : {};
+        return Object.entries(properties)
+            .filter(([key]) => !omit?.has(key))
+            .map(([key, property]) => {
+            const doc = (0, exports.isJsonObject)(property)
+                ? (0, exports.jsDoc)([
+                    typeof property.description === 'string'
+                        ? property.description
+                        : '',
+                    ...(Object.hasOwn(property, 'default')
+                        ? [`@default ${JSON.stringify(property.default)}`]
+                        : []),
+                ], pad)
+                : '';
+            const mark = required.has(key) && !optional?.has(key) ? '' : '?';
+            return `${doc}${pad}${propertyKey(key)}${mark}: ${printNode(property, depth + 1, active).text};\n`;
+        })
+            .join('');
+    };
+    return {
+        print: (schema, depth = 0) => printNode(schema, depth, new Set()).text,
+        members: (schema, depth, options = {}) => printMembers(schema, depth, new Set(), options),
+        promoted: () => {
+            const aliases = [];
+            for (const [id, name] of promotedNames) {
+                aliases.push(`type ${name} = ${printNode((0, exports.ownDef)(defs, id), 0, new Set([id])).text};`);
+            }
+            return aliases;
+        },
+    };
+};
+exports.createTypePrinter = createTypePrinter;
+//# sourceMappingURL=schema_to_typescript.js.map

package/dist/cjs/author/schema_to_typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema_to_typescript.js","sourceRoot":"","sources":["../../../src/author/schema_to_typescript.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\nexport type JsonObject = Record<string, unknown>;\n\nexport const DEF_PREFIX = '#/$defs/';\n\n/** Ids `z.toJSONSchema` gives a def no one named. */\nexport const ANONYMOUS_DEF = /^__schema\\d+$/;\n\nconst STRUCTURAL_KEYS = [\n  'type',\n  'const',\n  'enum',\n  'properties',\n  'additionalProperties',\n  'patternProperties',\n  'propertyNames',\n  'items',\n  'prefixItems',\n  'oneOf',\n  'anyOf',\n  'allOf',\n] as const;\n\nconst INDENT = '  ';\n\nexport const IDENTIFIER = /^[A-Za-z_$][\\w$]*$/;\n\nexport const isJsonObject = (value: unknown): value is JsonObject =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nexport const parseDefRef = (ref: unknown): string | undefined =>\n  typeof ref === 'string' && ref.startsWith(DEF_PREFIX)\n    ? ref.slice(DEF_PREFIX.length)\n    : undefined;\n\nexport const ownDef = (defs: JsonObject, id: string): unknown =>\n  Object.hasOwn(defs, id) ? defs[id] : undefined;\n\n/** `slideStats` becomes `SlideStats`; anything but letters and digits splits words. */\nexport const pascalCase = (value: string): string => {\n  const name = value\n    .split(/[^A-Za-z0-9]+/)\n    .filter(Boolean)\n    .map((word) => `${word.slice(0, 1).toUpperCase()}${word.slice(1)}`)\n    .join('');\n  if (name === '') {\n    return 'Type';\n  }\n  return /^\\d/.test(name) ? `_${name}` : name;\n};\n\n/** A JSDoc block for `lines`, or `''` when there are none. */\nexport const jsDoc = (lines: readonly string[], pad: string): string => {\n  const text = lines\n    .flatMap((line) => line.split('\\n'))\n    .map((line) => line.replaceAll('*/', '*\\\\/').trimEnd());\n  while (text[0] === '') {\n    text.shift();\n  }\n  while (text.at(-1) === '') {\n    text.pop();\n  }\n  if (text.length === 0) {\n    return '';\n  }\n  const [only] = text;\n  if (text.length === 1 && only !== undefined) {\n    return `${pad}/** ${only} */\\n`;\n  }\n  return `${pad}/**\\n${text\n    .map((line) => (line === '' ? `${pad} *` : `${pad} * ${line}`))\n    .join('\\n')}\\n${pad} */\\n`;\n};\n\nconst propertyKey = (key: string): string =>\n  IDENTIFIER.test(key) ? key : JSON.stringify(key);\n\nconst literal = (value: unknown): string => {\n  if (value === null) {\n    return 'null';\n  }\n  switch (typeof value) {\n    case 'string':\n      return JSON.stringify(value);\n    case 'number':\n    case 'boolean':\n      return String(value);\n    default:\n      return 'unknown';\n  }\n};\n\ninterface Printed {\n  text: string;\n  kind: 'atom' | 'union' | 'intersection';\n}\n\nconst atom = (text: string): Printed => ({ text, kind: 'atom' });\n\nconst union = (members: readonly Printed[]): Printed => {\n  if (members.some(({ text }) => text === 'unknown')) {\n    return atom('unknown');\n  }\n  const unique = new Map(members.map((member) => [member.text, member]));\n  const [only] = [...unique.values()];\n  if (unique.size === 0) {\n    return atom('never');\n  }\n  return unique.size === 1 && only\n    ? only\n    : { text: [...unique.keys()].join(' | '), kind: 'union' };\n};\n\nconst intersection = (members: readonly Printed[]): Printed => {\n  const unique = new Map(members.map((member) => [member.text, member]));\n  const [only] = [...unique.values()];\n  if (!only) {\n    return atom('unknown');\n  }\n  if (unique.size === 1 && only) {\n    return only;\n  }\n  return {\n    text: [...unique.values()]\n      .map(({ text, kind }) => (kind === 'union' ? `(${text})` : text))\n      .join(' & '),\n    kind: 'intersection',\n  };\n};\n\nconst arrayOf = ({ text, kind }: Printed): Printed =>\n  atom(kind === 'atom' ? `${text}[]` : `(${text})[]`);\n\n/** What {@link TypePrinter.members} prints and how. */\nexport interface MemberOptions {\n  /** Properties left out. */\n  omit?: ReadonlySet<string>;\n  /** Properties printed optional whether or not the schema requires them. */\n  optional?: ReadonlySet<string>;\n}\n\nexport interface TypePrinterOptions {\n  defs: JsonObject;\n  /** TypeScript names for defs printed by reference; every other def is inlined. */\n  names: ReadonlyMap<string, string>;\n  /** A fresh, unused name, for a def inlining cannot express. */\n  claim: (base: string) => string;\n}\n\nexport interface TypePrinter {\n  /** `schema` as a TypeScript type, written at `depth` levels of indent. */\n  print: (schema: unknown, depth?: number) => string;\n  /** The `key?: Type;` members of an object schema, with their JSDoc, at `depth + 1`. */\n  members: (\n    schema: JsonObject,\n    depth: number,\n    options?: MemberOptions\n  ) => string;\n  /** Type aliases for the anonymous defs that refer to themselves. Call last. */\n  promoted: () => string[];\n}\n\n/** A TypeScript printer over the subset of JSON Schema `z.toJSONSchema` emits. */\nexport const createTypePrinter = ({\n  defs,\n  names,\n  claim,\n}: TypePrinterOptions): TypePrinter => {\n  const promotedNames = new Map<string, string>();\n\n  const printRef = (\n    id: string,\n    depth: number,\n    active: ReadonlySet<string>\n  ): Printed => {\n    const named = names.get(id);\n    if (named !== undefined) {\n      return atom(named);\n    }\n    const target = ownDef(defs, id);\n    if (target === undefined) {\n      return atom('unknown');\n    }\n    if (active.has(id)) {\n      const name = promotedNames.get(id) ?? claim(pascalCase(id));\n      promotedNames.set(id, name);\n      return atom(name);\n    }\n    return printNode(target, depth, new Set([...active, id]));\n  };\n\n  const printNode = (\n    node: unknown,\n    depth: number,\n    active: ReadonlySet<string>\n  ): Printed => {\n    if (node === false) {\n      return atom('never');\n    }\n    if (!isJsonObject(node)) {\n      return atom('unknown');\n    }\n    const parts: Printed[] = [];\n    const ref = parseDefRef(node.$ref);\n    if (ref !== undefined) {\n      parts.push(printRef(ref, depth, active));\n    }\n    if (STRUCTURAL_KEYS.some((key) => Object.hasOwn(node, key))) {\n      parts.push(printStructure(node, depth, active));\n    }\n    return parts.length === 0 ? atom('unknown') : intersection(parts);\n  };\n\n  const printStructure = (\n    node: JsonObject,\n    depth: number,\n    active: ReadonlySet<string>\n  ): Printed => {\n    const parts: Printed[] = [];\n    const own = printOwn(node, depth, active);\n    if (own) {\n      parts.push(own);\n    }\n    for (const key of ['oneOf', 'anyOf'] as const) {\n      const members = node[key];\n      if (Array.isArray(members)) {\n        parts.push(\n          union(members.map((member) => printNode(member, depth, active)))\n        );\n      }\n    }\n    if (Array.isArray(node.allOf)) {\n      parts.push(\n        intersection(\n          node.allOf.map((member) => printNode(member, depth, active))\n        )\n      );\n    }\n    return parts.length === 0 ? atom('unknown') : intersection(parts);\n  };\n\n  // `undefined` when the node only combines other schemas.\n  const printOwn = (\n    node: JsonObject,\n    depth: number,\n    active: ReadonlySet<string>\n  ): Printed | undefined => {\n    if (Object.hasOwn(node, 'const')) {\n      return atom(literal(node.const));\n    }\n    if (Array.isArray(node.enum)) {\n      return union(node.enum.map((value) => atom(literal(value))));\n    }\n    const { type } = node;\n    if (Array.isArray(type)) {\n      return union(\n        type.map((member) => printTyped(member, node, depth, active))\n      );\n    }\n    if (typeof type === 'string') {\n      return printTyped(type, node, depth, active);\n    }\n    if (\n      Object.hasOwn(node, 'properties') ||\n      Object.hasOwn(node, 'additionalProperties')\n    ) {\n      return printObject(node, depth, active);\n    }\n    if (Object.hasOwn(node, 'items') || Object.hasOwn(node, 'prefixItems')) {\n      return printArray(node, depth, active);\n    }\n    return undefined;\n  };\n\n  const printTyped = (\n    type: unknown,\n    node: JsonObject,\n    depth: number,\n    active: ReadonlySet<string>\n  ): Printed => {\n    switch (type) {\n      case 'string':\n        return atom('string');\n      case 'number':\n      case 'integer':\n        return atom('number');\n      case 'boolean':\n        return atom('boolean');\n      case 'null':\n        return atom('null');\n      case 'array':\n        return printArray(node, depth, active);\n      case 'object':\n        return printObject(node, depth, active);\n      default:\n        return atom('unknown');\n    }\n  };\n\n  const printArray = (\n    node: JsonObject,\n    depth: number,\n    active: ReadonlySet<string>\n  ): Printed => {\n    const { prefixItems, items } = node;\n    if (Array.isArray(prefixItems)) {\n      const required = typeof node.minItems === 'number' ? node.minItems : 0;\n      const elements = prefixItems.map((item, index) => {\n        const printed = printNode(item, depth, active);\n        return index < required\n          ? printed.text\n          : `${printed.kind === 'atom' ? printed.text : `(${printed.text})`}?`;\n      });\n      if (items !== undefined && items !== false) {\n        elements.push(`...${arrayOf(printNode(items, depth, active)).text}`);\n      }\n      return atom(`[${elements.join(', ')}]`);\n    }\n    return arrayOf(\n      items === undefined ? atom('unknown') : printNode(items, depth, active)\n    );\n  };\n\n  const printObject = (\n    node: JsonObject,\n    depth: number,\n    active: ReadonlySet<string>\n  ): Printed => {\n    const properties = isJsonObject(node.properties) ? node.properties : {};\n    const lines = printMembers(node, depth, active, {});\n    const extra = node.additionalProperties;\n    const patterns = isJsonObject(node.patternProperties)\n      ? Object.values(node.patternProperties)\n      : [];\n    const open = extra !== false;\n    const values = [\n      ...patterns.map((schema) => printNode(schema, depth, active)),\n    ];\n    if (open) {\n      values.push(\n        extra === undefined || extra === true\n          ? atom('unknown')\n          : printNode(extra, depth, active)\n      );\n    }\n    const index =\n      values.length === 0\n        ? Object.keys(properties).length === 0\n          ? `${INDENT.repeat(depth + 1)}[key: string]: never;\\n`\n          : ''\n        : `${INDENT.repeat(depth + 1)}[key: string]: ${\n            union([\n              ...values,\n              ...Object.values(properties).map((schema) =>\n                printNode(schema, depth, active)\n              ),\n              ...(Object.keys(properties).some(\n                (key) =>\n                  !Array.isArray(node.required) || !node.required.includes(key)\n              )\n                ? [atom('undefined')]\n                : []),\n            ]).text\n          };\\n`;\n    return atom(`{\\n${lines}${index}${INDENT.repeat(depth)}}`);\n  };\n\n  const printMembers = (\n    node: JsonObject,\n    depth: number,\n    active: ReadonlySet<string>,\n    { omit, optional }: MemberOptions\n  ): string => {\n    const pad = INDENT.repeat(depth + 1);\n    const required = new Set(\n      Array.isArray(node.required)\n        ? node.required.filter((key) => typeof key === 'string')\n        : []\n    );\n    const properties = isJsonObject(node.properties) ? node.properties : {};\n    return Object.entries(properties)\n      .filter(([key]) => !omit?.has(key))\n      .map(([key, property]) => {\n        const doc = isJsonObject(property)\n          ? jsDoc(\n              [\n                typeof property.description === 'string'\n                  ? property.description\n                  : '',\n                ...(Object.hasOwn(property, 'default')\n                  ? [`@default ${JSON.stringify(property.default)}`]\n                  : []),\n              ],\n              pad\n            )\n          : '';\n        const mark = required.has(key) && !optional?.has(key) ? '' : '?';\n        return `${doc}${pad}${propertyKey(key)}${mark}: ${\n          printNode(property, depth + 1, active).text\n        };\\n`;\n      })\n      .join('');\n  };\n\n  return {\n    print: (schema, depth = 0) => printNode(schema, depth, new Set()).text,\n    members: (schema, depth, options = {}) =>\n      printMembers(schema, depth, new Set(), options),\n    promoted: () => {\n      const aliases: string[] = [];\n      for (const [id, name] of promotedNames) {\n        aliases.push(\n          `type ${name} = ${printNode(ownDef(defs, id), 0, new Set([id])).text};`\n        );\n      }\n      return aliases;\n    },\n  };\n};\n"]}

package/dist/cjs/composition/body_node_base.js

@@ -6,15 +6,22 @@
  * 2.0.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rendersOnSurface = exports.isVisibleOnSurface = exports.someBodyNode = exports.childNodePath = exports.createChildNodeWalker = exports.BODY_NODE_SURFACES = void 0;
-/** Every {@link SurfaceName}, for callers that iterate them. */
-exports.BODY_NODE_SURFACES = [
+exports.rendersOnSurface = exports.isVisibleOnSurface = exports.someBodyNode = exports.childNodePath = exports.createChildNodeWalker = exports.BODY_NODE_SURFACES = exports.SURFACE_NAMES = void 0;
+/**
+ * Every surface a node renders on or is hidden from, in render order.
+ *
+ * `html` is not here: the runtime's `html` surface wraps `react` output in a
+ * document, and no node targets it.
+ */
+exports.SURFACE_NAMES = [
     'react',
-    'svg',
+    'snapshot',
     'text',
     'markdown',
     'slack',
 ];
+/** @deprecated Use {@link SURFACE_NAMES}. */
+exports.BODY_NODE_SURFACES = exports.SURFACE_NAMES;
 /**
  * Builds the {@link ChildNodeWalker} for one composition's inventory.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"body_node_base.js","sourceRoot":"","sources":["../../../src/composition/body_node_base.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\n/**\n * The five surfaces a node renders on or is hidden from.\n *\n * Spelled out rather than derived as `keyof SurfaceMap<…>`: the keys never vary\n * with the pack types, and TypeScript can fail to prove a `keyof` over one\n * instantiation transfers to another, silently widening to `any`.\n */\nexport type SurfaceName = 'react' | 'svg' | 'text' | 'markdown' | 'slack';\n\n/** Every {@link SurfaceName}, for callers that iterate them. */\nexport const BODY_NODE_SURFACES: readonly SurfaceName[] = [\n  'react',\n  'svg',\n  'text',\n  'markdown',\n  'slack',\n];\n\n/** The two fields every primitive node carries, whatever its pack. */\nexport interface BodyNodeBase {\n  /** Unique within a composition, which `validate` enforces and `parse` does not. */\n  id?: string;\n  /** Surfaces this node appears on. Absent means every surface. */\n  surfaces?: SurfaceName[];\n}\n\n/**\n * A child node together with the field path locating it inside its parent, so\n * an error path can name the field a child actually lives under. A container\n * that returned bare nodes would leave every caller guessing the field name.\n */\nexport interface ChildNodeRef {\n  /** Erased: one walker spans every pack's node types, so it can name none of them. */\n  node: unknown;\n  /** Relative to the parent, e.g. `items[0].node`, `items[2].description`. */\n  path: string;\n}\n\n/**\n * Walks nested nodes and, for a hybrid container, reports whether the parent\n * still produces output of its own. A non-empty `children` result is the\n * complete source of rendered content unless\n * {@link ChildNodeWalker.hasOwnContent} is true for that node.\n */\nexport type ChildNodeWalker = ((node: unknown) => ChildNodeRef[]) & {\n  hasOwnContent?(node: unknown): boolean;\n};\n\n/**\n * Builds the {@link ChildNodeWalker} for one composition's inventory.\n *\n * Pass every pack's definitions: a walker missing one cannot see children of a\n * container that pack defines, and a tree walk would stop at its boundary.\n */\nexport const createChildNodeWalker = (\n  definitions: readonly {\n    type: string;\n    children?: unknown;\n    hasOwnContent?: unknown;\n  }[]\n): ChildNodeWalker => {\n  const childrenByType = new Map<\n    string,\n    (node: unknown) => readonly ChildNodeRef[]\n  >();\n  const ownContentByType = new Map<string, (node: unknown) => boolean>();\n  for (const definition of definitions) {\n    if (typeof definition.children === 'function') {\n      childrenByType.set(\n        definition.type,\n        definition.children as (node: unknown) => readonly ChildNodeRef[]\n      );\n    }\n    if (typeof definition.hasOwnContent === 'function') {\n      ownContentByType.set(\n        definition.type,\n        definition.hasOwnContent as (node: unknown) => boolean\n      );\n    }\n  }\n  const walk = ((node: unknown) => {\n    if (!node || typeof node !== 'object') {\n      return [];\n    }\n    const { type } = node as { type?: unknown };\n    if (typeof type !== 'string') {\n      return [];\n    }\n    return [...(childrenByType.get(type)?.(node) ?? [])];\n  }) as ChildNodeWalker;\n  walk.hasOwnContent = (node) => {\n    if (!node || typeof node !== 'object') {\n      return false;\n    }\n    const { type } = node as { type?: unknown };\n    if (typeof type !== 'string') {\n      return false;\n    }\n    return ownContentByType.get(type)?.(node) ?? false;\n  };\n  return walk;\n};\n\n/** Joins a parent path with a {@link ChildNodeRef.path} fragment. */\nexport const childNodePath = (parent: string, child: string): string =>\n  `${parent}.${child}`;\n\n/**\n * Whether any node visible on `surface` matches, descending through container\n * children via `walk`. A node (or a container ancestor) hidden from `surface`\n * is skipped along with its children.\n *\n * `walk` must span every pack in the composition: a walker built from one\n * pack's definitions cannot see children of a container defined in another.\n */\nexport const someBodyNode = (\n  nodes: readonly unknown[],\n  surface: SurfaceName,\n  predicate: (node: unknown) => boolean,\n  walk: ChildNodeWalker\n): boolean =>\n  nodes.some((node) => {\n    if (!isVisibleOnSurface(node, surface)) {\n      return false;\n    }\n    return (\n      predicate(node) ||\n      someBodyNode(\n        walk(node).map((child) => child.node),\n        surface,\n        predicate,\n        walk\n      )\n    );\n  });\n\n/** Whether `node`'s own `surfaces` hint admits `surface`, ignoring its children. */\nexport const isVisibleOnSurface = (\n  node: unknown,\n  surface: SurfaceName\n): boolean => {\n  if (!node || typeof node !== 'object') {\n    return false;\n  }\n  const { surfaces } = node as { surfaces?: unknown };\n  return !Array.isArray(surfaces) || surfaces.includes(surface);\n};\n\n/**\n * Whether `node` puts anything on `surface` — itself or through a descendant.\n *\n * Stronger than {@link isVisibleOnSurface}: a container every one of whose\n * children is hidden renders nothing, even though its own hint allows the\n * surface. A hybrid container that also owns string fields declares\n * {@link ChildNodeWalker.hasOwnContent} and keeps rendering regardless.\n */\nexport const rendersOnSurface = (\n  node: unknown,\n  surface: SurfaceName,\n  walk: ChildNodeWalker\n): boolean => {\n  if (!isVisibleOnSurface(node, surface)) {\n    return false;\n  }\n  const children = walk(node);\n  if (children.length === 0 || walk.hasOwnContent?.(node)) {\n    return true;\n  }\n  return children.some(({ node: child }) =>\n    rendersOnSurface(child, surface, walk)\n  );\n};\n"]}
+{"version":3,"file":"body_node_base.js","sourceRoot":"","sources":["../../../src/composition/body_node_base.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\n/**\n * Every surface a node renders on or is hidden from, in render order.\n *\n * `html` is not here: the runtime's `html` surface wraps `react` output in a\n * document, and no node targets it.\n */\nexport const SURFACE_NAMES = [\n  'react',\n  'snapshot',\n  'text',\n  'markdown',\n  'slack',\n] as const;\n\n/** One of the {@link SURFACE_NAMES}. */\nexport type SurfaceName = (typeof SURFACE_NAMES)[number];\n\n/** @deprecated Use {@link SURFACE_NAMES}. */\nexport const BODY_NODE_SURFACES: readonly SurfaceName[] = SURFACE_NAMES;\n\n/** The two fields every primitive node carries, whatever its pack. */\nexport interface BodyNodeBase {\n  /** Unique within a composition, which `validate` enforces and `parse` does not. */\n  id?: string;\n  /** Surfaces this node appears on. Absent means every surface. */\n  surfaces?: SurfaceName[];\n}\n\n/**\n * A child node together with the field path locating it inside its parent, so\n * an error path can name the field a child actually lives under. A container\n * that returned bare nodes would leave every caller guessing the field name.\n */\nexport interface ChildNodeRef {\n  /** Erased: one walker spans every pack's node types, so it can name none of them. */\n  node: unknown;\n  /** Relative to the parent, e.g. `items[0].node`, `items[2].description`. */\n  path: string;\n}\n\n/**\n * Walks nested nodes and, for a hybrid container, reports whether the parent\n * still produces output of its own. A non-empty `children` result is the\n * complete source of rendered content unless\n * {@link ChildNodeWalker.hasOwnContent} is true for that node.\n */\nexport type ChildNodeWalker = ((node: unknown) => ChildNodeRef[]) & {\n  hasOwnContent?(node: unknown): boolean;\n};\n\n/**\n * Builds the {@link ChildNodeWalker} for one composition's inventory.\n *\n * Pass every pack's definitions: a walker missing one cannot see children of a\n * container that pack defines, and a tree walk would stop at its boundary.\n */\nexport const createChildNodeWalker = (\n  definitions: readonly {\n    type: string;\n    children?: unknown;\n    hasOwnContent?: unknown;\n  }[]\n): ChildNodeWalker => {\n  const childrenByType = new Map<\n    string,\n    (node: unknown) => readonly ChildNodeRef[]\n  >();\n  const ownContentByType = new Map<string, (node: unknown) => boolean>();\n  for (const definition of definitions) {\n    if (typeof definition.children === 'function') {\n      childrenByType.set(\n        definition.type,\n        definition.children as (node: unknown) => readonly ChildNodeRef[]\n      );\n    }\n    if (typeof definition.hasOwnContent === 'function') {\n      ownContentByType.set(\n        definition.type,\n        definition.hasOwnContent as (node: unknown) => boolean\n      );\n    }\n  }\n  const walk = ((node: unknown) => {\n    if (!node || typeof node !== 'object') {\n      return [];\n    }\n    const { type } = node as { type?: unknown };\n    if (typeof type !== 'string') {\n      return [];\n    }\n    return [...(childrenByType.get(type)?.(node) ?? [])];\n  }) as ChildNodeWalker;\n  walk.hasOwnContent = (node) => {\n    if (!node || typeof node !== 'object') {\n      return false;\n    }\n    const { type } = node as { type?: unknown };\n    if (typeof type !== 'string') {\n      return false;\n    }\n    return ownContentByType.get(type)?.(node) ?? false;\n  };\n  return walk;\n};\n\n/** Joins a parent path with a {@link ChildNodeRef.path} fragment. */\nexport const childNodePath = (parent: string, child: string): string =>\n  `${parent}.${child}`;\n\n/**\n * Whether any node visible on `surface` matches, descending through container\n * children via `walk`. A node (or a container ancestor) hidden from `surface`\n * is skipped along with its children.\n *\n * `walk` must span every pack in the composition: a walker built from one\n * pack's definitions cannot see children of a container defined in another.\n */\nexport const someBodyNode = (\n  nodes: readonly unknown[],\n  surface: SurfaceName,\n  predicate: (node: unknown) => boolean,\n  walk: ChildNodeWalker\n): boolean =>\n  nodes.some((node) => {\n    if (!isVisibleOnSurface(node, surface)) {\n      return false;\n    }\n    return (\n      predicate(node) ||\n      someBodyNode(\n        walk(node).map((child) => child.node),\n        surface,\n        predicate,\n        walk\n      )\n    );\n  });\n\n/** Whether `node`'s own `surfaces` hint admits `surface`, ignoring its children. */\nexport const isVisibleOnSurface = (\n  node: unknown,\n  surface: SurfaceName\n): boolean => {\n  if (!node || typeof node !== 'object') {\n    return false;\n  }\n  const { surfaces } = node as { surfaces?: unknown };\n  return !Array.isArray(surfaces) || surfaces.includes(surface);\n};\n\n/**\n * Whether `node` puts anything on `surface` — itself or through a descendant.\n *\n * Stronger than {@link isVisibleOnSurface}: a container every one of whose\n * children is hidden renders nothing, even though its own hint allows the\n * surface. A hybrid container that also owns string fields declares\n * {@link ChildNodeWalker.hasOwnContent} and keeps rendering regardless.\n */\nexport const rendersOnSurface = (\n  node: unknown,\n  surface: SurfaceName,\n  walk: ChildNodeWalker\n): boolean => {\n  if (!isVisibleOnSurface(node, surface)) {\n    return false;\n  }\n  const children = walk(node);\n  if (children.length === 0 || walk.hasOwnContent?.(node)) {\n    return true;\n  }\n  return children.some(({ node: child }) =>\n    rendersOnSurface(child, surface, walk)\n  );\n};\n"]}

package/dist/cjs/composition/error.js

@@ -23,6 +23,7 @@ exports.ISOMER_ERROR_CODES = {
     CYCLIC_COMPOSITION: 'CYCLIC_COMPOSITION',
     DUPLICATE_AUTHORED_CHILD: 'DUPLICATE_AUTHORED_CHILD',
     DUPLICATE_ENHANCEMENT: 'DUPLICATE_ENHANCEMENT',
+    DUPLICATE_FORMAT: 'DUPLICATE_FORMAT',
     DUPLICATE_PACK_ID: 'DUPLICATE_PACK_ID',
     DUPLICATE_PRIMITIVE_TYPE: 'DUPLICATE_PRIMITIVE_TYPE',
     DUPLICATE_VIEW: 'DUPLICATE_VIEW',
@@ -40,6 +41,7 @@ exports.ISOMER_ERROR_CODES = {
     INPUT_OVER_BUDGET: 'INPUT_OVER_BUDGET',
     INVALID_BODY_NODE: 'INVALID_BODY_NODE',
     INVALID_FRAME_BODY: 'INVALID_FRAME_BODY',
+    INVALID_PACK_GROUPS: 'INVALID_PACK_GROUPS',
     MISSING_AUTHORED_TEXT: 'MISSING_AUTHORED_TEXT',
     MISSING_STYLE_ADAPTER: 'MISSING_STYLE_ADAPTER',
     RESERVED_NODE_FIELD: 'RESERVED_NODE_FIELD',

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

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/composition/error.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;GAMG;AACU,QAAA,kBAAkB,GAAG;IAChC,eAAe,EAAE,iBAAiB;IAClC,uBAAuB,EAAE,yBAAyB;IAClD,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;IACxC,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB,EAAE,uBAAuB;IAC9C,iBAAiB,EAAE,mBAAmB;IACtC,wBAAwB,EAAE,0BAA0B;IACpD,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,wBAAwB,EAAE,0BAA0B;IACpD,yBAAyB,EAAE,2BAA2B;IACtD,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,4BAA4B,EAAE,8BAA8B;IAC5D,oBAAoB,EAAE,sBAAsB;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;IAC9C,qBAAqB,EAAE,uBAAuB;IAC9C,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,aAAa,EAAE,eAAe;IAC9B,sBAAsB,EAAE,wBAAwB;IAChD,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;CACtC,CAAC;AAMX;;;;;;;GAOG;AACH,MAAa,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IAE/B,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AARD,kCAQC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n/**\n * Stable codes for {@link IsomerError}, {@link CompositionValidationError},\n * and the runtime's `RegisteredViewInputError`. Hosts branch on `code`, not\n * on `message`. Codes name the condition, not the throwing module: duplicate\n * type at `definePrimitivePack`, `composePacks`, and `createIsomerRuntime` is the same\n * `DUPLICATE_PRIMITIVE_TYPE`; the message names the layer.\n */\nexport const ISOMER_ERROR_CODES = {\n  AMBIGUOUS_FRAME: 'AMBIGUOUS_FRAME',\n  AMBIGUOUS_STYLE_ADAPTER: 'AMBIGUOUS_STYLE_ADAPTER',\n  AUTHOR_TYPE_MISMATCH: 'AUTHOR_TYPE_MISMATCH',\n  AUTHORED_SCHEMA_REUSED: 'AUTHORED_SCHEMA_REUSED',\n  COMPOSITION_INVALID: 'COMPOSITION_INVALID',\n  CYCLIC_COMPOSITION: 'CYCLIC_COMPOSITION',\n  DUPLICATE_AUTHORED_CHILD: 'DUPLICATE_AUTHORED_CHILD',\n  DUPLICATE_ENHANCEMENT: 'DUPLICATE_ENHANCEMENT',\n  DUPLICATE_PACK_ID: 'DUPLICATE_PACK_ID',\n  DUPLICATE_PRIMITIVE_TYPE: 'DUPLICATE_PRIMITIVE_TYPE',\n  DUPLICATE_VIEW: 'DUPLICATE_VIEW',\n  EMPTY_FRAMES: 'EMPTY_FRAMES',\n  EMPTY_PACK: 'EMPTY_PACK',\n  EMPTY_PACKS: 'EMPTY_PACKS',\n  EMPTY_PAGES: 'EMPTY_PAGES',\n  EMPTY_VOCABULARY: 'EMPTY_VOCABULARY',\n  ENHANCEMENT_ROOT_MISSING: 'ENHANCEMENT_ROOT_MISSING',\n  EXPECTED_AUTHOR_COMPONENT: 'EXPECTED_AUTHOR_COMPONENT',\n  EXPECTED_JSX_ELEMENT: 'EXPECTED_JSX_ELEMENT',\n  EXPECTED_TEXT_CHILDREN: 'EXPECTED_TEXT_CHILDREN',\n  INCOMPATIBLE_STYLE_COLLECTOR: 'INCOMPATIBLE_STYLE_COLLECTOR',\n  INPUT_NOT_PLAIN_DATA: 'INPUT_NOT_PLAIN_DATA',\n  INPUT_OVER_BUDGET: 'INPUT_OVER_BUDGET',\n  INVALID_BODY_NODE: 'INVALID_BODY_NODE',\n  INVALID_FRAME_BODY: 'INVALID_FRAME_BODY',\n  MISSING_AUTHORED_TEXT: 'MISSING_AUTHORED_TEXT',\n  MISSING_STYLE_ADAPTER: 'MISSING_STYLE_ADAPTER',\n  RESERVED_NODE_FIELD: 'RESERVED_NODE_FIELD',\n  UNEXPECTED_CHILDREN: 'UNEXPECTED_CHILDREN',\n  UNKNOWN_FRAME: 'UNKNOWN_FRAME',\n  UNKNOWN_PRIMITIVE_TYPE: 'UNKNOWN_PRIMITIVE_TYPE',\n  UNKNOWN_SURFACE: 'UNKNOWN_SURFACE',\n  UNKNOWN_VIEW: 'UNKNOWN_VIEW',\n  UNSUPPORTED_CHILD_PATH: 'UNSUPPORTED_CHILD_PATH',\n  VIEW_INPUT_INVALID: 'VIEW_INPUT_INVALID',\n  VOCABULARY_UNRESOLVED: 'VOCABULARY_UNRESOLVED',\n} as const;\n\n/** One of {@link ISOMER_ERROR_CODES}. */\nexport type IsomerErrorCode =\n  (typeof ISOMER_ERROR_CODES)[keyof typeof ISOMER_ERROR_CODES];\n\n/**\n * Thrown for construction and authoring failures that are not a\n * `CompositionValidationError`.\n *\n * Identify it by `name` and `code`, never `instanceof`: the SDK ships both\n * ESM and CJS builds, so a host can hold two copies of this class and an\n * identity check would miss one.\n */\nexport class IsomerError extends Error {\n  readonly code: IsomerErrorCode;\n\n  constructor(code: IsomerErrorCode, message: string) {\n    super(message);\n    this.name = 'IsomerError';\n    this.code = code;\n  }\n}\n"]}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/composition/error.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;GAMG;AACU,QAAA,kBAAkB,GAAG;IAChC,eAAe,EAAE,iBAAiB;IAClC,uBAAuB,EAAE,yBAAyB;IAClD,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;IACxC,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB,EAAE,uBAAuB;IAC9C,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,wBAAwB,EAAE,0BAA0B;IACpD,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,wBAAwB,EAAE,0BAA0B;IACpD,yBAAyB,EAAE,2BAA2B;IACtD,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,4BAA4B,EAAE,8BAA8B;IAC5D,oBAAoB,EAAE,sBAAsB;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,qBAAqB,EAAE,uBAAuB;IAC9C,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,aAAa,EAAE,eAAe;IAC9B,sBAAsB,EAAE,wBAAwB;IAChD,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;CACtC,CAAC;AAMX;;;;;;;GAOG;AACH,MAAa,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IAE/B,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AARD,kCAQC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n/**\n * Stable codes for {@link IsomerError}, {@link CompositionValidationError},\n * and the runtime's `RegisteredViewInputError`. Hosts branch on `code`, not\n * on `message`. Codes name the condition, not the throwing module: duplicate\n * type at `definePrimitivePack`, `composePacks`, and `createIsomerRuntime` is the same\n * `DUPLICATE_PRIMITIVE_TYPE`; the message names the layer.\n */\nexport const ISOMER_ERROR_CODES = {\n  AMBIGUOUS_FRAME: 'AMBIGUOUS_FRAME',\n  AMBIGUOUS_STYLE_ADAPTER: 'AMBIGUOUS_STYLE_ADAPTER',\n  AUTHOR_TYPE_MISMATCH: 'AUTHOR_TYPE_MISMATCH',\n  AUTHORED_SCHEMA_REUSED: 'AUTHORED_SCHEMA_REUSED',\n  COMPOSITION_INVALID: 'COMPOSITION_INVALID',\n  CYCLIC_COMPOSITION: 'CYCLIC_COMPOSITION',\n  DUPLICATE_AUTHORED_CHILD: 'DUPLICATE_AUTHORED_CHILD',\n  DUPLICATE_ENHANCEMENT: 'DUPLICATE_ENHANCEMENT',\n  DUPLICATE_FORMAT: 'DUPLICATE_FORMAT',\n  DUPLICATE_PACK_ID: 'DUPLICATE_PACK_ID',\n  DUPLICATE_PRIMITIVE_TYPE: 'DUPLICATE_PRIMITIVE_TYPE',\n  DUPLICATE_VIEW: 'DUPLICATE_VIEW',\n  EMPTY_FRAMES: 'EMPTY_FRAMES',\n  EMPTY_PACK: 'EMPTY_PACK',\n  EMPTY_PACKS: 'EMPTY_PACKS',\n  EMPTY_PAGES: 'EMPTY_PAGES',\n  EMPTY_VOCABULARY: 'EMPTY_VOCABULARY',\n  ENHANCEMENT_ROOT_MISSING: 'ENHANCEMENT_ROOT_MISSING',\n  EXPECTED_AUTHOR_COMPONENT: 'EXPECTED_AUTHOR_COMPONENT',\n  EXPECTED_JSX_ELEMENT: 'EXPECTED_JSX_ELEMENT',\n  EXPECTED_TEXT_CHILDREN: 'EXPECTED_TEXT_CHILDREN',\n  INCOMPATIBLE_STYLE_COLLECTOR: 'INCOMPATIBLE_STYLE_COLLECTOR',\n  INPUT_NOT_PLAIN_DATA: 'INPUT_NOT_PLAIN_DATA',\n  INPUT_OVER_BUDGET: 'INPUT_OVER_BUDGET',\n  INVALID_BODY_NODE: 'INVALID_BODY_NODE',\n  INVALID_FRAME_BODY: 'INVALID_FRAME_BODY',\n  INVALID_PACK_GROUPS: 'INVALID_PACK_GROUPS',\n  MISSING_AUTHORED_TEXT: 'MISSING_AUTHORED_TEXT',\n  MISSING_STYLE_ADAPTER: 'MISSING_STYLE_ADAPTER',\n  RESERVED_NODE_FIELD: 'RESERVED_NODE_FIELD',\n  UNEXPECTED_CHILDREN: 'UNEXPECTED_CHILDREN',\n  UNKNOWN_FRAME: 'UNKNOWN_FRAME',\n  UNKNOWN_PRIMITIVE_TYPE: 'UNKNOWN_PRIMITIVE_TYPE',\n  UNKNOWN_SURFACE: 'UNKNOWN_SURFACE',\n  UNKNOWN_VIEW: 'UNKNOWN_VIEW',\n  UNSUPPORTED_CHILD_PATH: 'UNSUPPORTED_CHILD_PATH',\n  VIEW_INPUT_INVALID: 'VIEW_INPUT_INVALID',\n  VOCABULARY_UNRESOLVED: 'VOCABULARY_UNRESOLVED',\n} as const;\n\n/** One of {@link ISOMER_ERROR_CODES}. */\nexport type IsomerErrorCode =\n  (typeof ISOMER_ERROR_CODES)[keyof typeof ISOMER_ERROR_CODES];\n\n/**\n * Thrown for construction and authoring failures that are not a\n * `CompositionValidationError`.\n *\n * Identify it by `name` and `code`, never `instanceof`: the SDK ships both\n * ESM and CJS builds, so a host can hold two copies of this class and an\n * identity check would miss one.\n */\nexport class IsomerError extends Error {\n  readonly code: IsomerErrorCode;\n\n  constructor(code: IsomerErrorCode, message: string) {\n    super(message);\n    this.name = 'IsomerError';\n    this.code = code;\n  }\n}\n"]}

package/dist/cjs/composition/index.js

@@ -6,9 +6,10 @@
  * 2.0.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatValidationError = exports.CompositionValidationError = exports.STRUCTURED_VALUE_FORMATS = exports.quoteText = exports.oneLine = exports.nameText = exports.ALL_NAMED_COLORS = exports.mapCompositionNodes = exports.IsomerError = exports.ISOMER_ERROR_CODES = exports.someBodyNode = exports.isVisibleOnSurface = exports.createChildNodeWalker = exports.BODY_NODE_SURFACES = void 0;
+exports.formatValidationError = exports.CompositionValidationError = exports.STRUCTURED_VALUE_FORMATS = exports.quoteText = exports.oneLine = exports.nameText = exports.ALL_NAMED_COLORS = exports.mapCompositionNodes = exports.IsomerError = exports.ISOMER_ERROR_CODES = exports.someBodyNode = exports.isVisibleOnSurface = exports.createChildNodeWalker = exports.SURFACE_NAMES = exports.BODY_NODE_SURFACES = void 0;
 var body_node_base_1 = require("./body_node_base");
 Object.defineProperty(exports, "BODY_NODE_SURFACES", { enumerable: true, get: function () { return body_node_base_1.BODY_NODE_SURFACES; } });
+Object.defineProperty(exports, "SURFACE_NAMES", { enumerable: true, get: function () { return body_node_base_1.SURFACE_NAMES; } });
 Object.defineProperty(exports, "createChildNodeWalker", { enumerable: true, get: function () { return body_node_base_1.createChildNodeWalker; } });
 Object.defineProperty(exports, "isVisibleOnSurface", { enumerable: true, get: function () { return body_node_base_1.isVisibleOnSurface; } });
 Object.defineProperty(exports, "someBodyNode", { enumerable: true, get: function () { return body_node_base_1.someBodyNode; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/composition/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,mDAS0B;AAJxB,oHAAA,kBAAkB,OAAA;AAClB,uHAAA,qBAAqB,OAAA;AACrB,oHAAA,kBAAkB,OAAA;AAClB,8GAAA,YAAY,OAAA;AAGd,iCAAgF;AAAjD,2GAAA,kBAAkB,OAAA;AAAE,oGAAA,WAAW,OAAA;AAC9D,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,6CAKuB;AADrB,+GAAA,gBAAgB,OAAA;AAGlB,uCAA0D;AAAjD,oGAAA,QAAQ,OAAA;AAAE,mGAAA,OAAO,OAAA;AAAE,qGAAA,SAAS,OAAA;AACrC,uDAK4B;AAD1B,4HAAA,wBAAwB,OAAA;AAE1B,uDAI4B;AAF1B,8HAAA,0BAA0B,OAAA;AAC1B,yHAAA,qBAAqB,OAAA","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport { type ActionEventRef } from './action_event';\nexport {\n  type BodyNodeBase,\n  type ChildNodeRef,\n  type ChildNodeWalker,\n  type SurfaceName,\n  BODY_NODE_SURFACES,\n  createChildNodeWalker,\n  isVisibleOnSurface,\n  someBodyNode,\n} from './body_node_base';\nexport { type Composition, type CompositionMeta } from './composition';\nexport { type IsomerErrorCode, ISOMER_ERROR_CODES, IsomerError } from './error';\nexport { mapCompositionNodes } from './map_nodes';\nexport {\n  type NamedColor,\n  type NamedColorPalette,\n  type RenderTheme,\n  ALL_NAMED_COLORS,\n} from './named_color';\nexport { type PrimitiveNode } from './node';\nexport { nameText, oneLine, quoteText } from './one_line';\nexport {\n  type DisplayValue,\n  type StructuredValue,\n  type StructuredValueFormat,\n  STRUCTURED_VALUE_FORMATS,\n} from './structured_value';\nexport {\n  type ValidationError,\n  CompositionValidationError,\n  formatValidationError,\n} from './validation_error';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/composition/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,mDAU0B;AALxB,oHAAA,kBAAkB,OAAA;AAClB,+GAAA,aAAa,OAAA;AACb,uHAAA,qBAAqB,OAAA;AACrB,oHAAA,kBAAkB,OAAA;AAClB,8GAAA,YAAY,OAAA;AAGd,iCAAgF;AAAjD,2GAAA,kBAAkB,OAAA;AAAE,oGAAA,WAAW,OAAA;AAC9D,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,6CAKuB;AADrB,+GAAA,gBAAgB,OAAA;AAGlB,uCAA0D;AAAjD,oGAAA,QAAQ,OAAA;AAAE,mGAAA,OAAO,OAAA;AAAE,qGAAA,SAAS,OAAA;AACrC,uDAK4B;AAD1B,4HAAA,wBAAwB,OAAA;AAE1B,uDAI4B;AAF1B,8HAAA,0BAA0B,OAAA;AAC1B,yHAAA,qBAAqB,OAAA","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport { type ActionEventRef } from './action_event';\nexport {\n  type BodyNodeBase,\n  type ChildNodeRef,\n  type ChildNodeWalker,\n  type SurfaceName,\n  BODY_NODE_SURFACES,\n  SURFACE_NAMES,\n  createChildNodeWalker,\n  isVisibleOnSurface,\n  someBodyNode,\n} from './body_node_base';\nexport { type Composition, type CompositionMeta } from './composition';\nexport { type IsomerErrorCode, ISOMER_ERROR_CODES, IsomerError } from './error';\nexport { mapCompositionNodes } from './map_nodes';\nexport {\n  type NamedColor,\n  type NamedColorPalette,\n  type RenderTheme,\n  ALL_NAMED_COLORS,\n} from './named_color';\nexport { type PrimitiveNode } from './node';\nexport { nameText, oneLine, quoteText } from './one_line';\nexport {\n  type DisplayValue,\n  type StructuredValue,\n  type StructuredValueFormat,\n  STRUCTURED_VALUE_FORMATS,\n} from './structured_value';\nexport {\n  type ValidationError,\n  CompositionValidationError,\n  formatValidationError,\n} from './validation_error';\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"structured_value.js","sourceRoot":"","sources":["../../../src/composition/structured_value.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,wDAAwD;AAC3C,QAAA,wBAAwB,GAAG;IACtC,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,OAAO;IACP,UAAU;IACV,MAAM;IACN,cAAc;CACN,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n/** Format hints a {@link StructuredValue} may carry. */\nexport const STRUCTURED_VALUE_FORMATS = [\n  'number',\n  'compact',\n  'percent',\n  'currency',\n  'bytes',\n  'duration',\n  'date',\n  'relativeTime',\n] as const;\n\n/** One of {@link STRUCTURED_VALUE_FORMATS}. */\nexport type StructuredValueFormat = (typeof STRUCTURED_VALUE_FORMATS)[number];\n\n/**\n * A raw quantity plus a format hint, so every surface renders the same string.\n *\n * Formatting happens once, in `formatDisplayValue`, rather than per renderer —\n * otherwise the text and Slack surfaces drift on rounding.\n */\nexport interface StructuredValue {\n  /** Unformatted, in base units — a `percent` of `0.42` renders as 42%. */\n  raw: number | string;\n  /** How to render `raw`. Absent passes a string through and gives a number default formatting. */\n  format?: StructuredValueFormat;\n  /**\n   * Fraction digits for numeric formats. `number`, `percent`, and `currency`\n   * pad to it; omitted, `number` and `percent` keep at most two and `currency`\n   * two. `compact` and `bytes` drop trailing zeros and keep one when omitted.\n   */\n  precision?: number;\n  /** Three-letter currency code for `currency`; defaults to USD. */\n  currency?: string;\n}\n\n/** A value-bearing field: preformatted prose, or a {@link StructuredValue} to format. */\nexport type DisplayValue = string | StructuredValue;\n"]}
+{"version":3,"file":"structured_value.js","sourceRoot":"","sources":["../../../src/composition/structured_value.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,wDAAwD;AAC3C,QAAA,wBAAwB,GAAG;IACtC,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,OAAO;IACP,UAAU;IACV,MAAM;IACN,cAAc;CACN,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n/** Format hints a {@link StructuredValue} may carry. */\nexport const STRUCTURED_VALUE_FORMATS = [\n  'number',\n  'compact',\n  'percent',\n  'currency',\n  'bytes',\n  'duration',\n  'date',\n  'relativeTime',\n] as const;\n\n/** One of {@link STRUCTURED_VALUE_FORMATS}. */\nexport type StructuredValueFormat = (typeof STRUCTURED_VALUE_FORMATS)[number];\n\n/**\n * A raw quantity plus a format hint, so every surface renders the same string.\n *\n * Formatting happens once, in `formatDisplayValue`, rather than per renderer —\n * otherwise the text and Slack surfaces drift on rounding.\n */\nexport interface StructuredValue {\n  /** Unformatted, in base units — a `percent` of `0.42` renders as 42%. */\n  raw: number | string;\n  /** How to render `raw`. Absent passes a string through and gives a number default formatting. */\n  format?: StructuredValueFormat | undefined;\n  /**\n   * Fraction digits for numeric formats. `number`, `percent`, and `currency`\n   * pad to it; omitted, `number` and `percent` keep at most two and `currency`\n   * two. `compact` and `bytes` drop trailing zeros and keep one when omitted.\n   */\n  precision?: number | undefined;\n  /** Three-letter currency code for `currency`; defaults to USD. */\n  currency?: string | undefined;\n}\n\n/** A value-bearing field: preformatted prose, or a {@link StructuredValue} to format. */\nexport type DisplayValue = string | StructuredValue;\n"]}

package/dist/cjs/define/frame.js

@@ -16,16 +16,15 @@ const bindFrame = (frame) => {
     const themeFor = (mode) => mode === 'dark' ? frame.theme.dark : frame.theme.light;
     return {
         defaultWidth: frame.defaultWidth,
-        sizesFromNodeHeights: frame.sizesFromNodeHeights ?? true,
         estimateHeight: (composition, dispatcher) => frame.estimateHeight(composition, dispatcher),
         validateBody: (body) => frame.validateBody?.(body) ?? [],
         resolveTheme: (mode) => themeFor(mode),
         render: (composition, viewport, dispatcher) => {
             const theme = themeFor(viewport.mode);
             const { title, subtitle, theme: mode } = composition;
-            return frame.wrap({ title, subtitle, theme: mode }, composition.body.map((node, index) => dispatcher.renderSvg(node, `body-${index}`)), { ...viewport, theme });
+            return frame.wrap({ title, subtitle, theme: mode }, composition.body.map((node, index) => dispatcher.renderSnapshot(node, `body-${index}`)), { ...viewport, theme });
         },
-        renderNode: (node, dispatcher) => dispatcher.renderSvg(node, node.type),
+        renderNode: (node, dispatcher) => dispatcher.renderSnapshot(node, node.type),
     };
 };
 exports.bindFrame = bindFrame;

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

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

package/dist/cjs/define/index.js

@@ -6,10 +6,16 @@
  * 2.0.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.z = exports.requiredString = exports.formatZodIssues = exports.declaredFieldsNote = exports.validateWithSchema = exports.unresolvedBodyNodeSchema = exports.definePrimitiveFor = exports.definePrimitive = exports.bodyNodeSurfacesSchema = exports.bodyNodeIdSchema = exports.bindFrame = void 0;
+exports.z = exports.requiredString = exports.formatZodIssues = exports.declaredFieldsNote = exports.validateWithSchema = exports.unresolvedBodyNodeSchema = exports.definePrimitiveFor = exports.definePrimitive = exports.bodyNodeSurfacesSchema = exports.bodyNodeIdSchema = exports.OPTIONAL_SURFACES = exports.ICON_VARS = exports.primitiveExamples = exports.exampleNodes = exports.bindFrame = void 0;
 var frame_1 = require("./frame");
 Object.defineProperty(exports, "bindFrame", { enumerable: true, get: function () { return frame_1.bindFrame; } });
+var primitive_example_1 = require("./primitive_example");
+Object.defineProperty(exports, "exampleNodes", { enumerable: true, get: function () { return primitive_example_1.exampleNodes; } });
+Object.defineProperty(exports, "primitiveExamples", { enumerable: true, get: function () { return primitive_example_1.primitiveExamples; } });
+var primitive_icon_1 = require("./primitive_icon");
+Object.defineProperty(exports, "ICON_VARS", { enumerable: true, get: function () { return primitive_icon_1.ICON_VARS; } });
 var primitive_module_1 = require("./primitive_module");
+Object.defineProperty(exports, "OPTIONAL_SURFACES", { enumerable: true, get: function () { return primitive_module_1.OPTIONAL_SURFACES; } });
 Object.defineProperty(exports, "bodyNodeIdSchema", { enumerable: true, get: function () { return primitive_module_1.bodyNodeIdSchema; } });
 Object.defineProperty(exports, "bodyNodeSurfacesSchema", { enumerable: true, get: function () { return primitive_module_1.bodyNodeSurfacesSchema; } });
 Object.defineProperty(exports, "definePrimitive", { enumerable: true, get: function () { return primitive_module_1.definePrimitive; } });

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

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