@elastic/isomer-sdk 0.1.0 → 0.2.0

package/dist/validate/validation.d.ts

@@ -57,18 +57,8 @@ export { CompositionValidationError };
 export declare const enforceValidationMode: (result: ValidationResult, mode?: ValidationErrorMode) => void;
 /** The composition `result` checked, which is what a render draws. Throws {@link CompositionValidationError} when `mode` is `'throw'` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input. */
 export declare const compositionToRender: <TNode extends PrimitiveNode>(result: CheckedValidationResult<TNode>, mode?: ValidationErrorMode) => CheckedComposition<TNode>;
-/** Runtime facts the semantic passes need beyond the primitive inventory. */
+/** Options for {@link createCompositionValidator}. */
 export interface CompositionValidatorOptions {
-    /**
-     * Whether any frame the runtime can draw with sizes itself from node heights,
-     * which is what makes a missing `metrics.svgHeight` matter.
-     *
-     * A runtime-wide question rather than a per-node one, because a frame is a
-     * runtime input: any node can be drawn under any frame, so the metric is
-     * load-bearing as soon as one frame consults it. Defaults to `false`, so a
-     * runtime with no frame at all reports nothing about a value nothing reads.
-     */
-    sizesFromNodeHeights?: boolean;
     /** Limits checked before the schema runs; see {@link checkInputBudget}. */
     inputBudget?: InputBudget;
 }

package/dist/validate/validation.d.ts.map

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

package/dist/validate/validation.js

@@ -4,7 +4,7 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-import { BODY_NODE_SURFACES, childNodePath, createChildNodeWalker, isVisibleOnSurface, rendersOnSurface, } from '../composition/body_node_base.js';
+import { childNodePath, createChildNodeWalker, rendersOnSurface, SURFACE_NAMES, } from '../composition/body_node_base.js';
 import { quoteText } from '../composition/one_line.js';
 import { CompositionValidationError, } from '../composition/validation_error.js';
 import { getCompositionSchemaForDefinitions } from './composition_schema.js';
@@ -64,12 +64,7 @@ export const createCompositionValidator = (definitions, options = {}) => {
         if (result.success) {
             const { body } = plain;
             const idErrors = collectDuplicateNodeIdErrors(body, walk);
-            const warnings = [
-                ...collectEmptySurfaceWarnings(body, walk),
-                ...(options.sizesFromNodeHeights
-                    ? collectMissingSvgHeightWarnings(body, definitions, walk)
-                    : []),
-            ];
+            const warnings = collectEmptySurfaceWarnings(body, walk);
             return {
                 valid: idErrors.length === 0,
                 errors: idErrors,
@@ -119,48 +114,10 @@ export const createCompositionParser = (definitions, { inputBudget } = {}) => {
     };
 };
 /** Warns once per surface that the whole body renders nothing on. */
-const collectEmptySurfaceWarnings = (body, walk) => BODY_NODE_SURFACES.filter((surface) => !body.some((node) => rendersOnSurface(node, surface, walk))).map((surface) => ({
+const collectEmptySurfaceWarnings = (body, walk) => SURFACE_NAMES.filter((surface) => !body.some((node) => rendersOnSurface(node, surface, walk))).map((surface) => ({
     surface,
     message: `composition renders no nodes on surface "${surface}"`,
 }));
-/**
- * Warns for each node that renders to `svg` but declares no `svgHeight`.
- *
- * `metrics.svgHeight` is optional, so `dispatcher.estimateSvgHeight` returns
- * `0` for such a node and a frame that sums node heights sizes short.
- *
- * Whether a runtime consults the metric at all is the caller's to decide; see
- * {@link CompositionValidatorOptions.sizesFromNodeHeights}. A fixed-size frame
- * never does, and warning about a value nothing reads is how a warning channel
- * gets ignored.
- */
-const collectMissingSvgHeightWarnings = (body, definitions, walk) => {
-    const unmeasured = new Set(definitions
-        .filter((definition) => !definition.metrics?.svgHeight)
-        .map((definition) => definition.type));
-    if (unmeasured.size === 0) {
-        return [];
-    }
-    const warnings = [];
-    const visit = (node, path) => {
-        if (!node || typeof node !== 'object' || !isVisibleOnSurface(node, 'svg')) {
-            return;
-        }
-        const { type } = node;
-        if (typeof type === 'string' && unmeasured.has(type)) {
-            warnings.push({
-                surface: 'svg',
-                path,
-                message: `${path} type ${quoteText(type)} declares no svgHeight metric and will be measured as 0, sizing the frame short`,
-            });
-        }
-        walk(node).forEach(({ node: child, path: field }) => {
-            visit(child, childNodePath(path, field));
-        });
-    };
-    body.forEach((node, index) => visit(node, `body[${index}]`));
-    return warnings;
-};
 /**
  * Errors for each node whose `id` repeats one already seen, naming the first
  * use.

package/dist/validate/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validate/validation.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\n  BODY_NODE_SURFACES,\n  childNodePath,\n  createChildNodeWalker,\n  isVisibleOnSurface,\n  rendersOnSurface,\n  type SurfaceName,\n} from '../composition/body_node_base';\nimport type { Composition } from '../composition/composition';\nimport type { PrimitiveNode } from '../composition/node';\nimport { quoteText } from '../composition/one_line';\nimport {\n  CompositionValidationError,\n  type ValidationError,\n} from '../composition/validation_error';\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport { getCompositionSchemaForDefinitions } from './composition_schema';\nimport {\n  checkInputBudget,\n  type InputBudget,\n  isInputRefusal,\n} from './input_budget';\nimport { createNodeIssueFormatter, type IssueRoot } from './node_issues';\n\n/**\n * A non-fatal validation finding, scoped to the surface it concerns.\n *\n * Warnings carry `surface` because every one of them is a statement about one\n * render target — a composition that draws nothing on `slack` is not news to a\n * caller rendering HTML. Without the scope a host receives every surface's\n * findings on every call and learns to ignore the channel.\n * {@link warningsForSurface} is the filter.\n */\nexport interface ValidationWarning {\n  /** The render target this finding concerns, never the composition as a whole. */\n  surface: SurfaceName;\n  /**\n   * Path of the offending node within the composition, absent for\n   * whole-composition findings.\n   */\n  path?: string;\n  /** Safe to show a user, and phrased for whoever can act on it. */\n  message: string;\n}\n\n/**\n * The outcome of `validate`: errors are fatal, warnings are advisory.\n *\n * `valid` tracks `errors` only — a composition can be valid and still carry\n * warnings, which is the normal case for a surface gap.\n */\nexport interface ValidationResult {\n  /** True when `errors` is empty, regardless of `warnings`. */\n  valid: boolean;\n  /** Fatal findings. Empty when `valid`. */\n  errors: ValidationError[];\n  /** Advisory findings, empty when there are none. */\n  warnings: ValidationWarning[];\n}\n\nconst checkedComposition = Symbol.for('elastic.isomer.checked_composition');\n\n/** The copy {@link createCompositionValidator} checked, which a validating render draws in place of the caller's value. The brand is type-only. */\nexport type CheckedComposition<TNode extends PrimitiveNode = PrimitiveNode> =\n  Composition<TNode> & { readonly [checkedComposition]: true };\n\n/** A {@link ValidationResult} with the composition it describes. */\nexport interface CheckedValidationResult<\n  TNode extends PrimitiveNode = PrimitiveNode,\n> extends ValidationResult {\n  /** Undefined only when {@link checkInputBudget} refused the input. */\n  composition: CheckedComposition<TNode> | undefined;\n}\n\n/** Narrows a result's warnings to the surface a caller is about to render. */\nexport const warningsForSurface = (\n  result: ValidationResult,\n  surface: SurfaceName\n): ValidationWarning[] =>\n  result.warnings.filter((warning) => warning.surface === surface);\n\n/** Whether a render reports validation findings or raises on them. */\nexport type ValidationErrorMode = 'collect' | 'throw';\n\nexport { CompositionValidationError };\n\n/** Raises {@link CompositionValidationError} when `mode` is `throw` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input, which nothing can render. */\nexport const enforceValidationMode = (\n  result: ValidationResult,\n  mode?: ValidationErrorMode\n): void => {\n  if (\n    !result.valid &&\n    (mode === 'throw' || result.errors.some(isInputRefusal))\n  ) {\n    throw new CompositionValidationError(result.errors);\n  }\n};\n\n/** The composition `result` checked, which is what a render draws. Throws {@link CompositionValidationError} when `mode` is `'throw'` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input. */\nexport const compositionToRender = <TNode extends PrimitiveNode>(\n  result: CheckedValidationResult<TNode>,\n  mode?: ValidationErrorMode\n): CheckedComposition<TNode> => {\n  enforceValidationMode(result, mode);\n  const { composition } = result;\n  if (composition === undefined) {\n    throw new CompositionValidationError(result.errors);\n  }\n  return composition;\n};\n\n/** Runtime facts the semantic passes need beyond the primitive inventory. */\nexport interface CompositionValidatorOptions {\n  /**\n   * Whether any frame the runtime can draw with sizes itself from node heights,\n   * which is what makes a missing `metrics.svgHeight` matter.\n   *\n   * A runtime-wide question rather than a per-node one, because a frame is a\n   * runtime input: any node can be drawn under any frame, so the metric is\n   * load-bearing as soon as one frame consults it. Defaults to `false`, so a\n   * runtime with no frame at all reports nothing about a value nothing reads.\n   */\n  sizesFromNodeHeights?: boolean;\n  /** Limits checked before the schema runs; see {@link checkInputBudget}. */\n  inputBudget?: InputBudget;\n}\n\n/** The body's nodes, as {@link IssueRoot}s for a node issue formatter. */\nconst bodyRoots = (value: unknown): IssueRoot[] => {\n  const { body } = (value ?? {}) as { body?: unknown };\n  return Array.isArray(body)\n    ? body.map((node, index) => [node, `body[${index}]`] as const)\n    : [];\n};\n\n/**\n * Builds the trusted-input validator: {@link checkInputBudget}, then the schema and the semantic passes on its copy, which the result carries.\n *\n * `definitions` is memoized on array identity, so a caller that rebuilds the\n * array per call (`createCompositionValidator(packs.flatMap(…))`) resolves a\n * fresh discriminated union each time. Hold the array `composePacks` returns\n * and reuse it across the validator, the parser, and the authoring context.\n */\nexport const createCompositionValidator = <\n  TNode extends PrimitiveNode = PrimitiveNode,\n>(\n  definitions: readonly AnyPrimitiveDefinition[],\n  options: CompositionValidatorOptions = {}\n): ((composition: Composition<TNode>) => CheckedValidationResult<TNode>) => {\n  const schema = getCompositionSchemaForDefinitions(definitions);\n  const walk = createChildNodeWalker(definitions);\n  const formatIssues = createNodeIssueFormatter(definitions);\n  return (composition) => {\n    const checked = checkInputBudget(composition, options.inputBudget);\n    if (!checked.valid) {\n      return {\n        valid: false,\n        errors: [checked.error],\n        warnings: [],\n        composition: undefined,\n      };\n    }\n    const plain = checked.value as CheckedComposition<TNode>;\n    const result = schema.safeParse(plain, { reportInput: true });\n    if (result.success) {\n      const { body } = plain;\n      const idErrors = collectDuplicateNodeIdErrors(body, walk);\n      const warnings = [\n        ...collectEmptySurfaceWarnings(body, walk),\n        ...(options.sizesFromNodeHeights\n          ? collectMissingSvgHeightWarnings(body, definitions, walk)\n          : []),\n      ];\n      return {\n        valid: idErrors.length === 0,\n        errors: idErrors,\n        warnings,\n        composition: plain,\n      };\n    }\n    return {\n      valid: false,\n      errors: formatIssues(bodyRoots(plain), result.error.issues),\n      warnings: [],\n      composition: plain,\n    };\n  };\n};\n\n/** The outcome of `parse`. */\nexport interface ParsedComposition {\n  /** True when the value matched the schema. Says nothing about id uniqueness. */\n  valid: boolean;\n  /** Schema failures. Empty when `valid`. */\n  errors: ValidationError[];\n  /** The parsed document, present only when `valid`. */\n  composition?: Composition;\n}\n\n/**\n * Builds the untrusted-input parser: {@link checkInputBudget}, then the schema only on its copy, reported rather than thrown.\n *\n * Deliberately narrower than {@link createCompositionValidator}. This answers\n * \"is this a `Composition`\", not \"is this a good one\" — it does not run the\n * duplicate-id pass or produce warnings, so a composition with two nodes\n * sharing an `id` parses as valid. Id uniqueness is a `validate` guarantee, so\n * a caller that wants the semantic checks runs `validate` on the result.\n *\n * Shares {@link createCompositionValidator}'s memoization identity requirement.\n */\nexport const createCompositionParser = (\n  definitions: readonly AnyPrimitiveDefinition[],\n  { inputBudget }: Pick<CompositionValidatorOptions, 'inputBudget'> = {}\n): ((value: unknown) => ParsedComposition) => {\n  const schema = getCompositionSchemaForDefinitions(definitions);\n  const formatIssues = createNodeIssueFormatter(definitions);\n  return (value) => {\n    const checked = checkInputBudget(value, inputBudget);\n    if (!checked.valid) {\n      return { valid: false, errors: [checked.error] };\n    }\n    const result = schema.safeParse(checked.value, { reportInput: true });\n    if (result.success) {\n      return {\n        valid: true,\n        errors: [],\n        composition: result.data as unknown as Composition,\n      };\n    }\n    return {\n      valid: false,\n      errors: formatIssues(bodyRoots(checked.value), result.error.issues),\n    };\n  };\n};\n\n/** Warns once per surface that the whole body renders nothing on. */\nconst collectEmptySurfaceWarnings = (\n  body: readonly unknown[],\n  walk: ReturnType<typeof createChildNodeWalker>\n): ValidationWarning[] =>\n  BODY_NODE_SURFACES.filter(\n    (surface) => !body.some((node) => rendersOnSurface(node, surface, walk))\n  ).map((surface) => ({\n    surface,\n    message: `composition renders no nodes on surface \"${surface}\"`,\n  }));\n\n/**\n * Warns for each node that renders to `svg` but declares no `svgHeight`.\n *\n * `metrics.svgHeight` is optional, so `dispatcher.estimateSvgHeight` returns\n * `0` for such a node and a frame that sums node heights sizes short.\n *\n * Whether a runtime consults the metric at all is the caller's to decide; see\n * {@link CompositionValidatorOptions.sizesFromNodeHeights}. A fixed-size frame\n * never does, and warning about a value nothing reads is how a warning channel\n * gets ignored.\n */\nconst collectMissingSvgHeightWarnings = (\n  body: readonly unknown[],\n  definitions: readonly AnyPrimitiveDefinition[],\n  walk: ReturnType<typeof createChildNodeWalker>\n): ValidationWarning[] => {\n  const unmeasured = new Set(\n    definitions\n      .filter((definition) => !definition.metrics?.svgHeight)\n      .map((definition) => definition.type)\n  );\n  if (unmeasured.size === 0) {\n    return [];\n  }\n  const warnings: ValidationWarning[] = [];\n  const visit = (node: unknown, path: string): void => {\n    if (!node || typeof node !== 'object' || !isVisibleOnSurface(node, 'svg')) {\n      return;\n    }\n    const { type } = node as { type?: unknown };\n    if (typeof type === 'string' && unmeasured.has(type)) {\n      warnings.push({\n        surface: 'svg',\n        path,\n        message: `${path} type ${quoteText(type)} declares no svgHeight metric and will be measured as 0, sizing the frame short`,\n      });\n    }\n    walk(node).forEach(({ node: child, path: field }) => {\n      visit(child, childNodePath(path, field));\n    });\n  };\n  body.forEach((node, index) => visit(node, `body[${index}]`));\n  return warnings;\n};\n\n/**\n * Errors for each node whose `id` repeats one already seen, naming the first\n * use.\n *\n * Errors rather than warnings, because ids are what a host addresses a node by.\n * Run by `validate` and deliberately not by `parse`; see\n * {@link createCompositionParser}.\n */\nconst collectDuplicateNodeIdErrors = (\n  body: readonly unknown[],\n  walk: ReturnType<typeof createChildNodeWalker>\n): ValidationError[] => {\n  const errors: ValidationError[] = [];\n  const seen = new Map<string, string>();\n  const visit = (node: unknown, path: string): void => {\n    if (!node || typeof node !== 'object') {\n      return;\n    }\n    const { id, type } = node as { id?: unknown; type?: unknown };\n    if (typeof id === 'string') {\n      const first = seen.get(id);\n      if (first) {\n        errors.push({\n          path: `${path}.id`,\n          message: `duplicates id ${quoteText(id)} first used at ${first}`,\n          ...(typeof type === 'string' ? { nodeType: type } : {}),\n        });\n      } else {\n        seen.set(id, path);\n      }\n    }\n    walk(node).forEach(({ node: child, path: field }) => {\n      visit(child, childNodePath(path, field));\n    });\n  };\n  body.forEach((node, index) => visit(node, `body[${index}]`));\n  return errors;\n};\n"]}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validate/validation.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\n  childNodePath,\n  createChildNodeWalker,\n  rendersOnSurface,\n  SURFACE_NAMES,\n  type SurfaceName,\n} from '../composition/body_node_base';\nimport type { Composition } from '../composition/composition';\nimport type { PrimitiveNode } from '../composition/node';\nimport { quoteText } from '../composition/one_line';\nimport {\n  CompositionValidationError,\n  type ValidationError,\n} from '../composition/validation_error';\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport { getCompositionSchemaForDefinitions } from './composition_schema';\nimport {\n  checkInputBudget,\n  type InputBudget,\n  isInputRefusal,\n} from './input_budget';\nimport { createNodeIssueFormatter, type IssueRoot } from './node_issues';\n\n/**\n * A non-fatal validation finding, scoped to the surface it concerns.\n *\n * Warnings carry `surface` because every one of them is a statement about one\n * render target — a composition that draws nothing on `slack` is not news to a\n * caller rendering HTML. Without the scope a host receives every surface's\n * findings on every call and learns to ignore the channel.\n * {@link warningsForSurface} is the filter.\n */\nexport interface ValidationWarning {\n  /** The render target this finding concerns, never the composition as a whole. */\n  surface: SurfaceName;\n  /**\n   * Path of the offending node within the composition, absent for\n   * whole-composition findings.\n   */\n  path?: string;\n  /** Safe to show a user, and phrased for whoever can act on it. */\n  message: string;\n}\n\n/**\n * The outcome of `validate`: errors are fatal, warnings are advisory.\n *\n * `valid` tracks `errors` only — a composition can be valid and still carry\n * warnings, which is the normal case for a surface gap.\n */\nexport interface ValidationResult {\n  /** True when `errors` is empty, regardless of `warnings`. */\n  valid: boolean;\n  /** Fatal findings. Empty when `valid`. */\n  errors: ValidationError[];\n  /** Advisory findings, empty when there are none. */\n  warnings: ValidationWarning[];\n}\n\nconst checkedComposition = Symbol.for('elastic.isomer.checked_composition');\n\n/** The copy {@link createCompositionValidator} checked, which a validating render draws in place of the caller's value. The brand is type-only. */\nexport type CheckedComposition<TNode extends PrimitiveNode = PrimitiveNode> =\n  Composition<TNode> & { readonly [checkedComposition]: true };\n\n/** A {@link ValidationResult} with the composition it describes. */\nexport interface CheckedValidationResult<\n  TNode extends PrimitiveNode = PrimitiveNode,\n> extends ValidationResult {\n  /** Undefined only when {@link checkInputBudget} refused the input. */\n  composition: CheckedComposition<TNode> | undefined;\n}\n\n/** Narrows a result's warnings to the surface a caller is about to render. */\nexport const warningsForSurface = (\n  result: ValidationResult,\n  surface: SurfaceName\n): ValidationWarning[] =>\n  result.warnings.filter((warning) => warning.surface === surface);\n\n/** Whether a render reports validation findings or raises on them. */\nexport type ValidationErrorMode = 'collect' | 'throw';\n\nexport { CompositionValidationError };\n\n/** Raises {@link CompositionValidationError} when `mode` is `throw` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input, which nothing can render. */\nexport const enforceValidationMode = (\n  result: ValidationResult,\n  mode?: ValidationErrorMode\n): void => {\n  if (\n    !result.valid &&\n    (mode === 'throw' || result.errors.some(isInputRefusal))\n  ) {\n    throw new CompositionValidationError(result.errors);\n  }\n};\n\n/** The composition `result` checked, which is what a render draws. Throws {@link CompositionValidationError} when `mode` is `'throw'` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input. */\nexport const compositionToRender = <TNode extends PrimitiveNode>(\n  result: CheckedValidationResult<TNode>,\n  mode?: ValidationErrorMode\n): CheckedComposition<TNode> => {\n  enforceValidationMode(result, mode);\n  const { composition } = result;\n  if (composition === undefined) {\n    throw new CompositionValidationError(result.errors);\n  }\n  return composition;\n};\n\n/** Options for {@link createCompositionValidator}. */\nexport interface CompositionValidatorOptions {\n  /** Limits checked before the schema runs; see {@link checkInputBudget}. */\n  inputBudget?: InputBudget;\n}\n\n/** The body's nodes, as {@link IssueRoot}s for a node issue formatter. */\nconst bodyRoots = (value: unknown): IssueRoot[] => {\n  const { body } = (value ?? {}) as { body?: unknown };\n  return Array.isArray(body)\n    ? body.map((node, index) => [node, `body[${index}]`] as const)\n    : [];\n};\n\n/**\n * Builds the trusted-input validator: {@link checkInputBudget}, then the schema and the semantic passes on its copy, which the result carries.\n *\n * `definitions` is memoized on array identity, so a caller that rebuilds the\n * array per call (`createCompositionValidator(packs.flatMap(…))`) resolves a\n * fresh discriminated union each time. Hold the array `composePacks` returns\n * and reuse it across the validator, the parser, and the authoring context.\n */\nexport const createCompositionValidator = <\n  TNode extends PrimitiveNode = PrimitiveNode,\n>(\n  definitions: readonly AnyPrimitiveDefinition[],\n  options: CompositionValidatorOptions = {}\n): ((composition: Composition<TNode>) => CheckedValidationResult<TNode>) => {\n  const schema = getCompositionSchemaForDefinitions(definitions);\n  const walk = createChildNodeWalker(definitions);\n  const formatIssues = createNodeIssueFormatter(definitions);\n  return (composition) => {\n    const checked = checkInputBudget(composition, options.inputBudget);\n    if (!checked.valid) {\n      return {\n        valid: false,\n        errors: [checked.error],\n        warnings: [],\n        composition: undefined,\n      };\n    }\n    const plain = checked.value as CheckedComposition<TNode>;\n    const result = schema.safeParse(plain, { reportInput: true });\n    if (result.success) {\n      const { body } = plain;\n      const idErrors = collectDuplicateNodeIdErrors(body, walk);\n      const warnings = collectEmptySurfaceWarnings(body, walk);\n      return {\n        valid: idErrors.length === 0,\n        errors: idErrors,\n        warnings,\n        composition: plain,\n      };\n    }\n    return {\n      valid: false,\n      errors: formatIssues(bodyRoots(plain), result.error.issues),\n      warnings: [],\n      composition: plain,\n    };\n  };\n};\n\n/** The outcome of `parse`. */\nexport interface ParsedComposition {\n  /** True when the value matched the schema. Says nothing about id uniqueness. */\n  valid: boolean;\n  /** Schema failures. Empty when `valid`. */\n  errors: ValidationError[];\n  /** The parsed document, present only when `valid`. */\n  composition?: Composition;\n}\n\n/**\n * Builds the untrusted-input parser: {@link checkInputBudget}, then the schema only on its copy, reported rather than thrown.\n *\n * Deliberately narrower than {@link createCompositionValidator}. This answers\n * \"is this a `Composition`\", not \"is this a good one\" — it does not run the\n * duplicate-id pass or produce warnings, so a composition with two nodes\n * sharing an `id` parses as valid. Id uniqueness is a `validate` guarantee, so\n * a caller that wants the semantic checks runs `validate` on the result.\n *\n * Shares {@link createCompositionValidator}'s memoization identity requirement.\n */\nexport const createCompositionParser = (\n  definitions: readonly AnyPrimitiveDefinition[],\n  { inputBudget }: Pick<CompositionValidatorOptions, 'inputBudget'> = {}\n): ((value: unknown) => ParsedComposition) => {\n  const schema = getCompositionSchemaForDefinitions(definitions);\n  const formatIssues = createNodeIssueFormatter(definitions);\n  return (value) => {\n    const checked = checkInputBudget(value, inputBudget);\n    if (!checked.valid) {\n      return { valid: false, errors: [checked.error] };\n    }\n    const result = schema.safeParse(checked.value, { reportInput: true });\n    if (result.success) {\n      return {\n        valid: true,\n        errors: [],\n        composition: result.data as unknown as Composition,\n      };\n    }\n    return {\n      valid: false,\n      errors: formatIssues(bodyRoots(checked.value), result.error.issues),\n    };\n  };\n};\n\n/** Warns once per surface that the whole body renders nothing on. */\nconst collectEmptySurfaceWarnings = (\n  body: readonly unknown[],\n  walk: ReturnType<typeof createChildNodeWalker>\n): ValidationWarning[] =>\n  SURFACE_NAMES.filter(\n    (surface) => !body.some((node) => rendersOnSurface(node, surface, walk))\n  ).map((surface) => ({\n    surface,\n    message: `composition renders no nodes on surface \"${surface}\"`,\n  }));\n\n/**\n * Errors for each node whose `id` repeats one already seen, naming the first\n * use.\n *\n * Errors rather than warnings, because ids are what a host addresses a node by.\n * Run by `validate` and deliberately not by `parse`; see\n * {@link createCompositionParser}.\n */\nconst collectDuplicateNodeIdErrors = (\n  body: readonly unknown[],\n  walk: ReturnType<typeof createChildNodeWalker>\n): ValidationError[] => {\n  const errors: ValidationError[] = [];\n  const seen = new Map<string, string>();\n  const visit = (node: unknown, path: string): void => {\n    if (!node || typeof node !== 'object') {\n      return;\n    }\n    const { id, type } = node as { id?: unknown; type?: unknown };\n    if (typeof id === 'string') {\n      const first = seen.get(id);\n      if (first) {\n        errors.push({\n          path: `${path}.id`,\n          message: `duplicates id ${quoteText(id)} first used at ${first}`,\n          ...(typeof type === 'string' ? { nodeType: type } : {}),\n        });\n      } else {\n        seen.set(id, path);\n      }\n    }\n    walk(node).forEach(({ node: child, path: field }) => {\n      visit(child, childNodePath(path, field));\n    });\n  };\n  body.forEach((node, index) => visit(node, `body[${index}]`));\n  return errors;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elastic/isomer-sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Shared primitive-pack toolkit for Isomer: the composition contract, validation, and rendering.",
   "license": "Elastic-2.0",
   "author": "Elastic",
@@ -111,7 +111,8 @@
     "micromark-extension-gfm": "^3.0.0"
   },
   "devDependencies": {
-    "@types/mdast": "^4.0.4"
+    "@types/mdast": "^4.0.4",
+    "parse5": "^7.3.0"
   },
   "scripts": {
     "typecheck": "tsc -p tsconfig.json --noEmit"