@elastic/isomer-sdk 0.0.0 → 0.1.0

package/dist/validate/url.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Returns the URL, trimmed and with control characters stripped, when it
+ * satisfies the navigation policy (`https:` / `http:` / `mailto:` / relative
+ * path), `null` otherwise.
+ */
+export declare const sanitizeNavigationHref: (href: string) => string | null;
+/**
+ * Returns the URL, trimmed and with control characters stripped, when it
+ * satisfies the asset policy (`https:` / `http:` / relative path /
+ * `data:image/*`), `null` otherwise.
+ */
+export declare const sanitizeAssetUrl: (url: string) => string | null;
+/** Checks a Markdown parser's decoded destination without decoding it again. */
+export declare const sanitizeParsedNavigationHref: (href: string) => string | null;
+/** Checks a Markdown parser's decoded image destination. */
+export declare const sanitizeParsedAssetUrl: (url: string) => string | null;
+/**
+ * Render-time replacement for a navigation href that failed the policy: an
+ * inert same-document link, so the label stays visible without a destination.
+ */
+export declare const BLOCKED_HREF = "#";
+/** What {@link navigationHref} accepts, for a field description to state. */
+export declare const NAVIGATION_HREF_RULE = "an https, http, or mailto URL, or a relative path";
+/** What {@link assetUrl} accepts, for a field description to state. */
+export declare const ASSET_URL_RULE = "an https, http, or data:image URL, or a relative path";
+/** Validation message for {@link navigationHref}. */
+export declare const NAVIGATION_HREF_MESSAGE = "must be an https, http, or mailto URL, or a relative path";
+/** Validation message for {@link assetUrl}. */
+export declare const ASSET_URL_MESSAGE = "must be an https, http, or data:image URL, or a relative path";
+/** Options for {@link navigationHref} and {@link assetUrl}. */
+export interface UrlSchemaOptions {
+    /** Longest accepted value, in characters. */
+    max?: number;
+}
+/**
+ * Zod schema for an `href`-like field: the validation layer of the two-layer
+ * policy, paired with {@link sanitizeNavigationHref} at render time.
+ *
+ * Its description states the rule, since a refinement's message does not
+ * reach the authoring JSON Schema. A field that describes itself should end
+ * with {@link NAVIGATION_HREF_RULE} so the model still reads it.
+ */
+export declare const navigationHref: (options?: UrlSchemaOptions) => import("zod").ZodString;
+/**
+ * Zod schema for a `src`-like field, paired with {@link sanitizeAssetUrl} at
+ * render time. Describes itself as {@link navigationHref} does, with
+ * {@link ASSET_URL_RULE}.
+ */
+export declare const assetUrl: (options?: UrlSchemaOptions) => import("zod").ZodString;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/validate/url.ts"],"names":[],"mappings":"AAsEA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IACgB,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IACgB,CAAC;AAEzE,gFAAgF;AAChF,eAAO,MAAM,4BAA4B,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAGpE,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAG7D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,sDACoB,CAAC;AAEtD,uEAAuE;AACvE,eAAO,MAAM,cAAc,0DAC8B,CAAC;AAE1D,qDAAqD;AACrD,eAAO,MAAM,uBAAuB,8DAAoC,CAAC;AAEzE,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,kEAA8B,CAAC;AAE7D,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAYD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,UAAS,gBAAqB,4BAM1D,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAS,gBAAqB,4BAMpD,CAAC"}

package/dist/validate/url.js

@@ -0,0 +1,107 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { requiredString } from '../define/zod_helpers.js';
+// The one URL trust policy every URL-bearing field goes through, as a Zod
+// refinement and again as render-time sanitization. See `docs/url-trust.md`.
+const NAMED_REFERENCES = {
+    bsol: '\\',
+    colon: ':',
+    gt: '>',
+    lt: '<',
+    newline: '\n',
+    sol: '/',
+    tab: '\t',
+};
+// Numeric references, which browsers decode without a trailing `;`, and the
+// named ones that spell a scheme, path, or tag character.
+const CHARACTER_REFERENCE_RE = /&(?:#x([0-9a-f]+);?|#([0-9]+);?|(bsol|colon|gt|lt|newline|sol|tab);)/gi;
+const decodeReference = (match, hex, decimal, name) => {
+    if (name)
+        return NAMED_REFERENCES[name.toLowerCase()] ?? match;
+    const codePoint = Number.parseInt(hex ?? decimal ?? '', hex ? 16 : 10);
+    return codePoint > 0 && codePoint <= 0x10ffff
+        ? String.fromCodePoint(codePoint)
+        : '\ufffd';
+};
+// The control characters browsers drop when parsing a URL.
+const stripControls = (value) => 
+// eslint-disable-next-line no-control-regex -- stripping control characters is the point.
+value.replace(/[\u0000-\u001f\u007f]/g, '').trim();
+// The URL as a sink sees it: references decoded once, then controls stripped,
+// so an obfuscated scheme is checked as it would act. Only the decision reads
+// it; the policy returns the authored value, since a consumer that decodes
+// again must decode what was checked, not a decoded copy.
+const decisionForm = (value) => stripControls(value.replace(CHARACTER_REFERENCE_RE, decodeReference));
+// `<` and `>` must be percent-encoded in a URL, so their unencoded presence
+// means the value is malformed or a parser-confusion attempt (an unterminated
+// `<dest` would otherwise read as a relative path). Reject rather than strip.
+const HAS_ANGLE_BRACKET_RE = /[<>]/;
+const HAS_SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;
+const NAVIGATION_SCHEME_RE = /^(?:https?|mailto):/i;
+const ASSET_SCHEME_RE = /^(?:https?:|data:image\/)/i;
+// `//host` — and the `\` variants browsers fold into `/` — resolve against the
+// current protocol onto a foreign host, so they are not relative paths.
+const PROTOCOL_RELATIVE_RE = /^[/\\][/\\]/;
+// Whether a URL in decision form passes, given which schemes are allowed.
+const passes = (decided, schemes) => decided !== '' &&
+    !PROTOCOL_RELATIVE_RE.test(decided) &&
+    !HAS_ANGLE_BRACKET_RE.test(decided) &&
+    (!HAS_SCHEME_RE.test(decided) || schemes.test(decided));
+/**
+ * Returns the URL, trimmed and with control characters stripped, when it
+ * satisfies the navigation policy (`https:` / `http:` / `mailto:` / relative
+ * path), `null` otherwise.
+ */
+export const sanitizeNavigationHref = (href) => passes(decisionForm(href), NAVIGATION_SCHEME_RE) ? stripControls(href) : null;
+/**
+ * Returns the URL, trimmed and with control characters stripped, when it
+ * satisfies the asset policy (`https:` / `http:` / relative path /
+ * `data:image/*`), `null` otherwise.
+ */
+export const sanitizeAssetUrl = (url) => passes(decisionForm(url), ASSET_SCHEME_RE) ? stripControls(url) : null;
+/** Checks a Markdown parser's decoded destination without decoding it again. */
+export const sanitizeParsedNavigationHref = (href) => {
+    const normalized = stripControls(href);
+    return passes(normalized, NAVIGATION_SCHEME_RE) ? normalized : null;
+};
+/** Checks a Markdown parser's decoded image destination. */
+export const sanitizeParsedAssetUrl = (url) => {
+    const normalized = stripControls(url);
+    return passes(normalized, ASSET_SCHEME_RE) ? normalized : null;
+};
+/**
+ * Render-time replacement for a navigation href that failed the policy: an
+ * inert same-document link, so the label stays visible without a destination.
+ */
+export const BLOCKED_HREF = '#';
+/** What {@link navigationHref} accepts, for a field description to state. */
+export const NAVIGATION_HREF_RULE = 'an https, http, or mailto URL, or a relative path';
+/** What {@link assetUrl} accepts, for a field description to state. */
+export const ASSET_URL_RULE = 'an https, http, or data:image URL, or a relative path';
+/** Validation message for {@link navigationHref}. */
+export const NAVIGATION_HREF_MESSAGE = `must be ${NAVIGATION_HREF_RULE}`;
+/** Validation message for {@link assetUrl}. */
+export const ASSET_URL_MESSAGE = `must be ${ASSET_URL_RULE}`;
+const urlSchema = (passes, rule, message, { max }) => (max === undefined ? requiredString() : requiredString().max(max))
+    .refine(passes, { error: message })
+    .describe(`${rule[0].toUpperCase()}${rule.slice(1)}.`);
+/**
+ * Zod schema for an `href`-like field: the validation layer of the two-layer
+ * policy, paired with {@link sanitizeNavigationHref} at render time.
+ *
+ * Its description states the rule, since a refinement's message does not
+ * reach the authoring JSON Schema. A field that describes itself should end
+ * with {@link NAVIGATION_HREF_RULE} so the model still reads it.
+ */
+export const navigationHref = (options = {}) => urlSchema((value) => sanitizeNavigationHref(value) !== null, NAVIGATION_HREF_RULE, NAVIGATION_HREF_MESSAGE, options);
+/**
+ * Zod schema for a `src`-like field, paired with {@link sanitizeAssetUrl} at
+ * render time. Describes itself as {@link navigationHref} does, with
+ * {@link ASSET_URL_RULE}.
+ */
+export const assetUrl = (options = {}) => urlSchema((value) => sanitizeAssetUrl(value) !== null, ASSET_URL_RULE, ASSET_URL_MESSAGE, options);
+//# sourceMappingURL=url.js.map

package/dist/validate/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/validate/url.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 { requiredString } from '../define/zod_helpers';\n\n// The one URL trust policy every URL-bearing field goes through, as a Zod\n// refinement and again as render-time sanitization. See `docs/url-trust.md`.\n\nconst NAMED_REFERENCES: Readonly<Record<string, string>> = {\n  bsol: '\\\\',\n  colon: ':',\n  gt: '>',\n  lt: '<',\n  newline: '\\n',\n  sol: '/',\n  tab: '\\t',\n};\n\n// Numeric references, which browsers decode without a trailing `;`, and the\n// named ones that spell a scheme, path, or tag character.\nconst CHARACTER_REFERENCE_RE =\n  /&(?:#x([0-9a-f]+);?|#([0-9]+);?|(bsol|colon|gt|lt|newline|sol|tab);)/gi;\n\nconst decodeReference = (\n  match: string,\n  hex: string | undefined,\n  decimal: string | undefined,\n  name: string | undefined\n): string => {\n  if (name) return NAMED_REFERENCES[name.toLowerCase()] ?? match;\n  const codePoint = Number.parseInt(hex ?? decimal ?? '', hex ? 16 : 10);\n  return codePoint > 0 && codePoint <= 0x10ffff\n    ? String.fromCodePoint(codePoint)\n    : '\\ufffd';\n};\n\n// The control characters browsers drop when parsing a URL.\nconst stripControls = (value: string): string =>\n  // eslint-disable-next-line no-control-regex -- stripping control characters is the point.\n  value.replace(/[\\u0000-\\u001f\\u007f]/g, '').trim();\n\n// The URL as a sink sees it: references decoded once, then controls stripped,\n// so an obfuscated scheme is checked as it would act. Only the decision reads\n// it; the policy returns the authored value, since a consumer that decodes\n// again must decode what was checked, not a decoded copy.\nconst decisionForm = (value: string): string =>\n  stripControls(value.replace(CHARACTER_REFERENCE_RE, decodeReference));\n\n// `<` and `>` must be percent-encoded in a URL, so their unencoded presence\n// means the value is malformed or a parser-confusion attempt (an unterminated\n// `<dest` would otherwise read as a relative path). Reject rather than strip.\nconst HAS_ANGLE_BRACKET_RE = /[<>]/;\nconst HAS_SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;\nconst NAVIGATION_SCHEME_RE = /^(?:https?|mailto):/i;\nconst ASSET_SCHEME_RE = /^(?:https?:|data:image\\/)/i;\n// `//host` — and the `\\` variants browsers fold into `/` — resolve against the\n// current protocol onto a foreign host, so they are not relative paths.\nconst PROTOCOL_RELATIVE_RE = /^[/\\\\][/\\\\]/;\n\n// Whether a URL in decision form passes, given which schemes are allowed.\nconst passes = (decided: string, schemes: RegExp): boolean =>\n  decided !== '' &&\n  !PROTOCOL_RELATIVE_RE.test(decided) &&\n  !HAS_ANGLE_BRACKET_RE.test(decided) &&\n  (!HAS_SCHEME_RE.test(decided) || schemes.test(decided));\n\n/**\n * Returns the URL, trimmed and with control characters stripped, when it\n * satisfies the navigation policy (`https:` / `http:` / `mailto:` / relative\n * path), `null` otherwise.\n */\nexport const sanitizeNavigationHref = (href: string): string | null =>\n  passes(decisionForm(href), NAVIGATION_SCHEME_RE) ? stripControls(href) : null;\n\n/**\n * Returns the URL, trimmed and with control characters stripped, when it\n * satisfies the asset policy (`https:` / `http:` / relative path /\n * `data:image/*`), `null` otherwise.\n */\nexport const sanitizeAssetUrl = (url: string): string | null =>\n  passes(decisionForm(url), ASSET_SCHEME_RE) ? stripControls(url) : null;\n\n/** Checks a Markdown parser's decoded destination without decoding it again. */\nexport const sanitizeParsedNavigationHref = (href: string): string | null => {\n  const normalized = stripControls(href);\n  return passes(normalized, NAVIGATION_SCHEME_RE) ? normalized : null;\n};\n\n/** Checks a Markdown parser's decoded image destination. */\nexport const sanitizeParsedAssetUrl = (url: string): string | null => {\n  const normalized = stripControls(url);\n  return passes(normalized, ASSET_SCHEME_RE) ? normalized : null;\n};\n\n/**\n * Render-time replacement for a navigation href that failed the policy: an\n * inert same-document link, so the label stays visible without a destination.\n */\nexport const BLOCKED_HREF = '#';\n\n/** What {@link navigationHref} accepts, for a field description to state. */\nexport const NAVIGATION_HREF_RULE =\n  'an https, http, or mailto URL, or a relative path';\n\n/** What {@link assetUrl} accepts, for a field description to state. */\nexport const ASSET_URL_RULE =\n  'an https, http, or data:image URL, or a relative path';\n\n/** Validation message for {@link navigationHref}. */\nexport const NAVIGATION_HREF_MESSAGE = `must be ${NAVIGATION_HREF_RULE}`;\n\n/** Validation message for {@link assetUrl}. */\nexport const ASSET_URL_MESSAGE = `must be ${ASSET_URL_RULE}`;\n\n/** Options for {@link navigationHref} and {@link assetUrl}. */\nexport interface UrlSchemaOptions {\n  /** Longest accepted value, in characters. */\n  max?: number;\n}\n\nconst urlSchema = (\n  passes: (value: string) => boolean,\n  rule: string,\n  message: string,\n  { max }: UrlSchemaOptions\n) =>\n  (max === undefined ? requiredString() : requiredString().max(max))\n    .refine(passes, { error: message })\n    .describe(`${rule[0]!.toUpperCase()}${rule.slice(1)}.`);\n\n/**\n * Zod schema for an `href`-like field: the validation layer of the two-layer\n * policy, paired with {@link sanitizeNavigationHref} at render time.\n *\n * Its description states the rule, since a refinement's message does not\n * reach the authoring JSON Schema. A field that describes itself should end\n * with {@link NAVIGATION_HREF_RULE} so the model still reads it.\n */\nexport const navigationHref = (options: UrlSchemaOptions = {}) =>\n  urlSchema(\n    (value) => sanitizeNavigationHref(value) !== null,\n    NAVIGATION_HREF_RULE,\n    NAVIGATION_HREF_MESSAGE,\n    options\n  );\n\n/**\n * Zod schema for a `src`-like field, paired with {@link sanitizeAssetUrl} at\n * render time. Describes itself as {@link navigationHref} does, with\n * {@link ASSET_URL_RULE}.\n */\nexport const assetUrl = (options: UrlSchemaOptions = {}) =>\n  urlSchema(\n    (value) => sanitizeAssetUrl(value) !== null,\n    ASSET_URL_RULE,\n    ASSET_URL_MESSAGE,\n    options\n  );\n"]}

package/dist/validate/validation.d.ts

@@ -0,0 +1,105 @@
+import { type SurfaceName } from '../composition/body_node_base.js';
+import type { Composition } from '../composition/composition.js';
+import type { PrimitiveNode } from '../composition/node.js';
+import { CompositionValidationError, type ValidationError } from '../composition/validation_error.js';
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+import { type InputBudget } from './input_budget.js';
+/**
+ * A non-fatal validation finding, scoped to the surface it concerns.
+ *
+ * Warnings carry `surface` because every one of them is a statement about one
+ * render target — a composition that draws nothing on `slack` is not news to a
+ * caller rendering HTML. Without the scope a host receives every surface's
+ * findings on every call and learns to ignore the channel.
+ * {@link warningsForSurface} is the filter.
+ */
+export interface ValidationWarning {
+    /** The render target this finding concerns, never the composition as a whole. */
+    surface: SurfaceName;
+    /**
+     * Path of the offending node within the composition, absent for
+     * whole-composition findings.
+     */
+    path?: string;
+    /** Safe to show a user, and phrased for whoever can act on it. */
+    message: string;
+}
+/**
+ * The outcome of `validate`: errors are fatal, warnings are advisory.
+ *
+ * `valid` tracks `errors` only — a composition can be valid and still carry
+ * warnings, which is the normal case for a surface gap.
+ */
+export interface ValidationResult {
+    /** True when `errors` is empty, regardless of `warnings`. */
+    valid: boolean;
+    /** Fatal findings. Empty when `valid`. */
+    errors: ValidationError[];
+    /** Advisory findings, empty when there are none. */
+    warnings: ValidationWarning[];
+}
+declare const checkedComposition: unique symbol;
+/** The copy {@link createCompositionValidator} checked, which a validating render draws in place of the caller's value. The brand is type-only. */
+export type CheckedComposition<TNode extends PrimitiveNode = PrimitiveNode> = Composition<TNode> & {
+    readonly [checkedComposition]: true;
+};
+/** A {@link ValidationResult} with the composition it describes. */
+export interface CheckedValidationResult<TNode extends PrimitiveNode = PrimitiveNode> extends ValidationResult {
+    /** Undefined only when {@link checkInputBudget} refused the input. */
+    composition: CheckedComposition<TNode> | undefined;
+}
+/** Narrows a result's warnings to the surface a caller is about to render. */
+export declare const warningsForSurface: (result: ValidationResult, surface: SurfaceName) => ValidationWarning[];
+/** Whether a render reports validation findings or raises on them. */
+export type ValidationErrorMode = 'collect' | 'throw';
+export { CompositionValidationError };
+/** 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. */
+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. */
+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;
+}
+/**
+ * Builds the trusted-input validator: {@link checkInputBudget}, then the schema and the semantic passes on its copy, which the result carries.
+ *
+ * `definitions` is memoized on array identity, so a caller that rebuilds the
+ * array per call (`createCompositionValidator(packs.flatMap(…))`) resolves a
+ * fresh discriminated union each time. Hold the array `composePacks` returns
+ * and reuse it across the validator, the parser, and the authoring context.
+ */
+export declare const createCompositionValidator: <TNode extends PrimitiveNode = PrimitiveNode>(definitions: readonly AnyPrimitiveDefinition[], options?: CompositionValidatorOptions) => ((composition: Composition<TNode>) => CheckedValidationResult<TNode>);
+/** The outcome of `parse`. */
+export interface ParsedComposition {
+    /** True when the value matched the schema. Says nothing about id uniqueness. */
+    valid: boolean;
+    /** Schema failures. Empty when `valid`. */
+    errors: ValidationError[];
+    /** The parsed document, present only when `valid`. */
+    composition?: Composition;
+}
+/**
+ * Builds the untrusted-input parser: {@link checkInputBudget}, then the schema only on its copy, reported rather than thrown.
+ *
+ * Deliberately narrower than {@link createCompositionValidator}. This answers
+ * "is this a `Composition`", not "is this a good one" — it does not run the
+ * duplicate-id pass or produce warnings, so a composition with two nodes
+ * sharing an `id` parses as valid. Id uniqueness is a `validate` guarantee, so
+ * a caller that wants the semantic checks runs `validate` on the result.
+ *
+ * Shares {@link createCompositionValidator}'s memoization identity requirement.
+ */
+export declare const createCompositionParser: (definitions: readonly AnyPrimitiveDefinition[], { inputBudget }?: Pick<CompositionValidatorOptions, "inputBudget">) => ((value: unknown) => ParsedComposition);
+//# sourceMappingURL=validation.d.ts.map

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

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

package/dist/validate/validation.js

@@ -0,0 +1,200 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { BODY_NODE_SURFACES, childNodePath, createChildNodeWalker, isVisibleOnSurface, rendersOnSurface, } 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';
+import { checkInputBudget, isInputRefusal, } from './input_budget.js';
+import { createNodeIssueFormatter } from './node_issues.js';
+const checkedComposition = Symbol.for('elastic.isomer.checked_composition');
+/** Narrows a result's warnings to the surface a caller is about to render. */
+export const warningsForSurface = (result, surface) => result.warnings.filter((warning) => warning.surface === surface);
+export { CompositionValidationError };
+/** 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. */
+export const enforceValidationMode = (result, mode) => {
+    if (!result.valid &&
+        (mode === 'throw' || result.errors.some(isInputRefusal))) {
+        throw new CompositionValidationError(result.errors);
+    }
+};
+/** 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 const compositionToRender = (result, mode) => {
+    enforceValidationMode(result, mode);
+    const { composition } = result;
+    if (composition === undefined) {
+        throw new CompositionValidationError(result.errors);
+    }
+    return composition;
+};
+/** The body's nodes, as {@link IssueRoot}s for a node issue formatter. */
+const bodyRoots = (value) => {
+    const { body } = (value ?? {});
+    return Array.isArray(body)
+        ? body.map((node, index) => [node, `body[${index}]`])
+        : [];
+};
+/**
+ * Builds the trusted-input validator: {@link checkInputBudget}, then the schema and the semantic passes on its copy, which the result carries.
+ *
+ * `definitions` is memoized on array identity, so a caller that rebuilds the
+ * array per call (`createCompositionValidator(packs.flatMap(…))`) resolves a
+ * fresh discriminated union each time. Hold the array `composePacks` returns
+ * and reuse it across the validator, the parser, and the authoring context.
+ */
+export const createCompositionValidator = (definitions, options = {}) => {
+    const schema = getCompositionSchemaForDefinitions(definitions);
+    const walk = createChildNodeWalker(definitions);
+    const formatIssues = createNodeIssueFormatter(definitions);
+    return (composition) => {
+        const checked = checkInputBudget(composition, options.inputBudget);
+        if (!checked.valid) {
+            return {
+                valid: false,
+                errors: [checked.error],
+                warnings: [],
+                composition: undefined,
+            };
+        }
+        const plain = checked.value;
+        const result = schema.safeParse(plain, { reportInput: true });
+        if (result.success) {
+            const { body } = plain;
+            const idErrors = collectDuplicateNodeIdErrors(body, walk);
+            const warnings = [
+                ...collectEmptySurfaceWarnings(body, walk),
+                ...(options.sizesFromNodeHeights
+                    ? collectMissingSvgHeightWarnings(body, definitions, walk)
+                    : []),
+            ];
+            return {
+                valid: idErrors.length === 0,
+                errors: idErrors,
+                warnings,
+                composition: plain,
+            };
+        }
+        return {
+            valid: false,
+            errors: formatIssues(bodyRoots(plain), result.error.issues),
+            warnings: [],
+            composition: plain,
+        };
+    };
+};
+/**
+ * Builds the untrusted-input parser: {@link checkInputBudget}, then the schema only on its copy, reported rather than thrown.
+ *
+ * Deliberately narrower than {@link createCompositionValidator}. This answers
+ * "is this a `Composition`", not "is this a good one" — it does not run the
+ * duplicate-id pass or produce warnings, so a composition with two nodes
+ * sharing an `id` parses as valid. Id uniqueness is a `validate` guarantee, so
+ * a caller that wants the semantic checks runs `validate` on the result.
+ *
+ * Shares {@link createCompositionValidator}'s memoization identity requirement.
+ */
+export const createCompositionParser = (definitions, { inputBudget } = {}) => {
+    const schema = getCompositionSchemaForDefinitions(definitions);
+    const formatIssues = createNodeIssueFormatter(definitions);
+    return (value) => {
+        const checked = checkInputBudget(value, inputBudget);
+        if (!checked.valid) {
+            return { valid: false, errors: [checked.error] };
+        }
+        const result = schema.safeParse(checked.value, { reportInput: true });
+        if (result.success) {
+            return {
+                valid: true,
+                errors: [],
+                composition: result.data,
+            };
+        }
+        return {
+            valid: false,
+            errors: formatIssues(bodyRoots(checked.value), result.error.issues),
+        };
+    };
+};
+/** 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) => ({
+    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.
+ *
+ * Errors rather than warnings, because ids are what a host addresses a node by.
+ * Run by `validate` and deliberately not by `parse`; see
+ * {@link createCompositionParser}.
+ */
+const collectDuplicateNodeIdErrors = (body, walk) => {
+    const errors = [];
+    const seen = new Map();
+    const visit = (node, path) => {
+        if (!node || typeof node !== 'object') {
+            return;
+        }
+        const { id, type } = node;
+        if (typeof id === 'string') {
+            const first = seen.get(id);
+            if (first) {
+                errors.push({
+                    path: `${path}.id`,
+                    message: `duplicates id ${quoteText(id)} first used at ${first}`,
+                    ...(typeof type === 'string' ? { nodeType: type } : {}),
+                });
+            }
+            else {
+                seen.set(id, path);
+            }
+        }
+        walk(node).forEach(({ node: child, path: field }) => {
+            visit(child, childNodePath(path, field));
+        });
+    };
+    body.forEach((node, index) => visit(node, `body[${index}]`));
+    return errors;
+};
+//# sourceMappingURL=validation.js.map

package/dist/validate/validation.js.map

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

package/dist/validate/value_schemas.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+/** Derived from {@link ALL_NAMED_COLORS} rather than restating the literals. */
+export declare const namedColorSchema: z.ZodEnum<{
+    primary: "primary";
+    danger: "danger";
+    success: "success";
+    neutral: "neutral";
+    accent: "accent";
+    warning: "warning";
+    risk: "risk";
+}>;
+/** `RenderTheme`: the light/dark preference a caller asks for. */
+export declare const renderThemeSchema: z.ZodEnum<{
+    auto: "auto";
+    light: "light";
+    dark: "dark";
+}>;
+/**
+ * The raw quantity plus a format hint, formatted once in a primitive's model so
+ * every surface renders the same string. See `StructuredValue`.
+ */
+export declare const structuredValueSchema: z.ZodObject<{
+    raw: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    format: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        date: "date";
+        compact: "compact";
+        percent: "percent";
+        currency: "currency";
+        bytes: "bytes";
+        duration: "duration";
+        relativeTime: "relativeTime";
+    }>>;
+    precision: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Value-bearing fields accept preformatted prose or a structured value. */
+export declare const displayValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    raw: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    format: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        date: "date";
+        compact: "compact";
+        percent: "percent";
+        currency: "currency";
+        bytes: "bytes";
+        duration: "duration";
+        relativeTime: "relativeTime";
+    }>>;
+    precision: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+//# sourceMappingURL=value_schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"value_schemas.d.ts","sourceRoot":"","sources":["../../src/validate/value_schemas.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,gFAAgF;AAChF,eAAO,MAAM,gBAAgB;;;;;;;;EAE5B,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,iBAAiB;;;;EAAwC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAiBhC,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;mBAM9B,CAAC"}