@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/cjs/author/schema_to_typescript.js

@@ -0,0 +1,295 @@
+"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')) return atom('unknown');\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) return atom('unknown');\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    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/action_event.js

@@ -0,0 +1,9 @@
+"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 });
+//# sourceMappingURL=action_event.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action_event.js","sourceRoot":"","sources":["../../../src/composition/action_event.ts"],"names":[],"mappings":";AAAA;;;;;GAKG","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n/**\n * A named event a node can raise, for the host to interpret.\n *\n * The SDK carries the reference and never dispatches it: side effects are the\n * host's, so `name` means whatever its handler decides.\n */\nexport interface ActionEventRef {\n  /** Agreed between the composition's author and the host's handler. */\n  name: string;\n  /** Payload passed through untouched, so it must be JSON-serializable. */\n  context?: Record<string, unknown>;\n}\n"]}

package/dist/cjs/composition/body_node_base.js

@@ -0,0 +1,112 @@
+"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.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',
+    '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.
+ *
+ * Pass every pack's definitions: a walker missing one cannot see children of a
+ * container that pack defines, and a tree walk would stop at its boundary.
+ */
+const createChildNodeWalker = (definitions) => {
+    const childrenByType = new Map();
+    const ownContentByType = new Map();
+    for (const definition of definitions) {
+        if (typeof definition.children === 'function') {
+            childrenByType.set(definition.type, definition.children);
+        }
+        if (typeof definition.hasOwnContent === 'function') {
+            ownContentByType.set(definition.type, definition.hasOwnContent);
+        }
+    }
+    const walk = ((node) => {
+        if (!node || typeof node !== 'object') {
+            return [];
+        }
+        const { type } = node;
+        if (typeof type !== 'string') {
+            return [];
+        }
+        return [...(childrenByType.get(type)?.(node) ?? [])];
+    });
+    walk.hasOwnContent = (node) => {
+        if (!node || typeof node !== 'object') {
+            return false;
+        }
+        const { type } = node;
+        if (typeof type !== 'string') {
+            return false;
+        }
+        return ownContentByType.get(type)?.(node) ?? false;
+    };
+    return walk;
+};
+exports.createChildNodeWalker = createChildNodeWalker;
+/** Joins a parent path with a {@link ChildNodeRef.path} fragment. */
+const childNodePath = (parent, child) => `${parent}.${child}`;
+exports.childNodePath = childNodePath;
+/**
+ * Whether any node visible on `surface` matches, descending through container
+ * children via `walk`. A node (or a container ancestor) hidden from `surface`
+ * is skipped along with its children.
+ *
+ * `walk` must span every pack in the composition: a walker built from one
+ * pack's definitions cannot see children of a container defined in another.
+ */
+const someBodyNode = (nodes, surface, predicate, walk) => nodes.some((node) => {
+    if (!(0, exports.isVisibleOnSurface)(node, surface)) {
+        return false;
+    }
+    return (predicate(node) ||
+        (0, exports.someBodyNode)(walk(node).map((child) => child.node), surface, predicate, walk));
+});
+exports.someBodyNode = someBodyNode;
+/** Whether `node`'s own `surfaces` hint admits `surface`, ignoring its children. */
+const isVisibleOnSurface = (node, surface) => {
+    if (!node || typeof node !== 'object') {
+        return false;
+    }
+    const { surfaces } = node;
+    return !Array.isArray(surfaces) || surfaces.includes(surface);
+};
+exports.isVisibleOnSurface = isVisibleOnSurface;
+/**
+ * Whether `node` puts anything on `surface` — itself or through a descendant.
+ *
+ * Stronger than {@link isVisibleOnSurface}: a container every one of whose
+ * children is hidden renders nothing, even though its own hint allows the
+ * surface. A hybrid container that also owns string fields declares
+ * {@link ChildNodeWalker.hasOwnContent} and keeps rendering regardless.
+ */
+const rendersOnSurface = (node, surface, walk) => {
+    if (!(0, exports.isVisibleOnSurface)(node, surface)) {
+        return false;
+    }
+    const children = walk(node);
+    if (children.length === 0 || walk.hasOwnContent?.(node)) {
+        return true;
+    }
+    return children.some(({ node: child }) => (0, exports.rendersOnSurface)(child, surface, walk));
+};
+exports.rendersOnSurface = rendersOnSurface;
+//# sourceMappingURL=body_node_base.js.map

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

@@ -0,0 +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 * 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/composition.js

@@ -0,0 +1,9 @@
+"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 });
+//# sourceMappingURL=composition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../../src/composition/composition.ts"],"names":[],"mappings":";AAAA;;;;;GAKG","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 { RenderTheme } from './named_color';\nimport type { PrimitiveNode } from './node';\n\n/**\n * The wire format: one typed document that every surface renders from.\n *\n * Crosses process and vendor boundaries, so the JSON shape is the contract and\n * the TypeScript name is not: {@link Composition.type} reads `view`, the\n * discriminator an agent is prompted on.\n */\nexport interface Composition<TNode extends PrimitiveNode = PrimitiveNode> {\n  /** Root marker. Always `view`; see the note on {@link Composition}. */\n  type: 'view';\n  /**\n   * Wire-format version. A literal rather than `number` so an unknown future\n   * version cannot parse as valid, and optional with no default because absent\n   * already means v1 — writing one in would rewrite stored documents.\n   */\n  version?: 1;\n  title?: string;\n  subtitle?: string;\n  /** Light/dark preference, not a resolved value; `auto` resolves light. */\n  theme?: RenderTheme;\n  /** At least one node, which the schema enforces via `.min(1)`. */\n  body: TNode[];\n  meta?: CompositionMeta;\n}\n\n/**\n * Context a host may surface beside the render.\n *\n * Advisory and pass-through throughout: nothing here changes what the body\n * renders to, and the SDK reads none of it. Timestamps are plain strings by\n * convention ISO 8601, which the schema does not enforce — a host that parses\n * one should tolerate anything.\n */\nexport interface CompositionMeta {\n  /** Origin of the composition itself, e.g. the agent or feature that composed it. */\n  source?: string;\n  /** When the composition was produced. */\n  generatedAt?: string;\n  /** Overrides the accessible name a surface derives from `title`. */\n  ariaLabel?: string;\n  /** Where the underlying data came from, as opposed to who composed it. */\n  provenance?: {\n    /** Data origin, e.g. an index or dataset name. */\n    source?: string;\n    /** The query that produced the data, for a host that offers \"show me how\". */\n    query?: string;\n    /** Service or connector that answered the query. */\n    provider?: string;\n  };\n  /** How current the data is, for a host that shows an as-of or staleness badge. */\n  freshness?: {\n    /** When the data was current, which may precede `generatedAt`. */\n    asOf?: string;\n    /** Asserted by the producer rather than derived, so a host should prefer it to comparing `asOf`. */\n    stale?: boolean;\n    /** How long `asOf` stays current. Not range-checked. */\n    ttlSeconds?: number;\n  };\n  /**\n   * Set when the composition rendered anyway despite losing some data, so a\n   * host can mark it incomplete rather than presenting it as whole.\n   */\n  partialFailure?: {\n    /** True when some of the data behind the composition was lost before it rendered. */\n    degraded?: boolean;\n    /** Human-readable cause, safe to show a user. */\n    reason?: string;\n  };\n}\n"]}

package/dist/cjs/composition/error.js

@@ -0,0 +1,73 @@
+"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.IsomerError = exports.ISOMER_ERROR_CODES = void 0;
+/**
+ * Stable codes for {@link IsomerError}, {@link CompositionValidationError},
+ * and the runtime's `RegisteredViewInputError`. Hosts branch on `code`, not
+ * on `message`. Codes name the condition, not the throwing module: duplicate
+ * type at `definePrimitivePack`, `composePacks`, and `createIsomerRuntime` is the same
+ * `DUPLICATE_PRIMITIVE_TYPE`; the message names the layer.
+ */
+exports.ISOMER_ERROR_CODES = {
+    AMBIGUOUS_FRAME: 'AMBIGUOUS_FRAME',
+    AMBIGUOUS_STYLE_ADAPTER: 'AMBIGUOUS_STYLE_ADAPTER',
+    AUTHOR_TYPE_MISMATCH: 'AUTHOR_TYPE_MISMATCH',
+    AUTHORED_SCHEMA_REUSED: 'AUTHORED_SCHEMA_REUSED',
+    COMPOSITION_INVALID: 'COMPOSITION_INVALID',
+    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',
+    EMPTY_FRAMES: 'EMPTY_FRAMES',
+    EMPTY_PACK: 'EMPTY_PACK',
+    EMPTY_PACKS: 'EMPTY_PACKS',
+    EMPTY_PAGES: 'EMPTY_PAGES',
+    EMPTY_VOCABULARY: 'EMPTY_VOCABULARY',
+    ENHANCEMENT_ROOT_MISSING: 'ENHANCEMENT_ROOT_MISSING',
+    EXPECTED_AUTHOR_COMPONENT: 'EXPECTED_AUTHOR_COMPONENT',
+    EXPECTED_JSX_ELEMENT: 'EXPECTED_JSX_ELEMENT',
+    EXPECTED_TEXT_CHILDREN: 'EXPECTED_TEXT_CHILDREN',
+    INCOMPATIBLE_STYLE_COLLECTOR: 'INCOMPATIBLE_STYLE_COLLECTOR',
+    INPUT_NOT_PLAIN_DATA: 'INPUT_NOT_PLAIN_DATA',
+    INPUT_OVER_BUDGET: 'INPUT_OVER_BUDGET',
+    INVALID_BODY_NODE: 'INVALID_BODY_NODE',
+    INVALID_FRAME_BODY: 'INVALID_FRAME_BODY',
+    MISSING_AUTHORED_TEXT: 'MISSING_AUTHORED_TEXT',
+    MISSING_STYLE_ADAPTER: 'MISSING_STYLE_ADAPTER',
+    RESERVED_NODE_FIELD: 'RESERVED_NODE_FIELD',
+    UNEXPECTED_CHILDREN: 'UNEXPECTED_CHILDREN',
+    UNKNOWN_FRAME: 'UNKNOWN_FRAME',
+    UNKNOWN_PRIMITIVE_TYPE: 'UNKNOWN_PRIMITIVE_TYPE',
+    UNKNOWN_SURFACE: 'UNKNOWN_SURFACE',
+    UNKNOWN_VIEW: 'UNKNOWN_VIEW',
+    UNSUPPORTED_CHILD_PATH: 'UNSUPPORTED_CHILD_PATH',
+    VIEW_INPUT_INVALID: 'VIEW_INPUT_INVALID',
+    VOCABULARY_UNRESOLVED: 'VOCABULARY_UNRESOLVED',
+};
+/**
+ * Thrown for construction and authoring failures that are not a
+ * `CompositionValidationError`.
+ *
+ * Identify it by `name` and `code`, never `instanceof`: the SDK ships both
+ * ESM and CJS builds, so a host can hold two copies of this class and an
+ * identity check would miss one.
+ */
+class IsomerError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'IsomerError';
+        this.code = code;
+    }
+}
+exports.IsomerError = IsomerError;
+//# sourceMappingURL=error.js.map

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

@@ -0,0 +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,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,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  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

@@ -0,0 +1,32 @@
+"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.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; } });
+var error_1 = require("./error");
+Object.defineProperty(exports, "ISOMER_ERROR_CODES", { enumerable: true, get: function () { return error_1.ISOMER_ERROR_CODES; } });
+Object.defineProperty(exports, "IsomerError", { enumerable: true, get: function () { return error_1.IsomerError; } });
+var map_nodes_1 = require("./map_nodes");
+Object.defineProperty(exports, "mapCompositionNodes", { enumerable: true, get: function () { return map_nodes_1.mapCompositionNodes; } });
+var named_color_1 = require("./named_color");
+Object.defineProperty(exports, "ALL_NAMED_COLORS", { enumerable: true, get: function () { return named_color_1.ALL_NAMED_COLORS; } });
+var one_line_1 = require("./one_line");
+Object.defineProperty(exports, "nameText", { enumerable: true, get: function () { return one_line_1.nameText; } });
+Object.defineProperty(exports, "oneLine", { enumerable: true, get: function () { return one_line_1.oneLine; } });
+Object.defineProperty(exports, "quoteText", { enumerable: true, get: function () { return one_line_1.quoteText; } });
+var structured_value_1 = require("./structured_value");
+Object.defineProperty(exports, "STRUCTURED_VALUE_FORMATS", { enumerable: true, get: function () { return structured_value_1.STRUCTURED_VALUE_FORMATS; } });
+var validation_error_1 = require("./validation_error");
+Object.defineProperty(exports, "CompositionValidationError", { enumerable: true, get: function () { return validation_error_1.CompositionValidationError; } });
+Object.defineProperty(exports, "formatValidationError", { enumerable: true, get: function () { return validation_error_1.formatValidationError; } });
+//# sourceMappingURL=index.js.map