@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/validate/authoring_schema.js

@@ -0,0 +1,306 @@
+/*
+ * 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 { buildCompositionJsonSchema, } from './json_schema.js';
+import { displayValueSchema, namedColorSchema, renderThemeSchema, structuredValueSchema, } from './value_schemas.js';
+const DEF_PREFIX = '#/$defs/';
+const BODY_NODE_ID = 'bodyNode';
+const SAFE_INTEGER_MAX = Number.MAX_SAFE_INTEGER;
+const SCALAR_TYPES = new Set(['string', 'number', 'integer', 'boolean']);
+const DEFAULT_EXTRA_DEFS = [
+    { schema: namedColorSchema, id: 'tone' },
+    { schema: displayValueSchema, id: 'displayValue' },
+    { schema: structuredValueSchema, id: 'structuredValue' },
+    { schema: renderThemeSchema, id: 'renderTheme' },
+];
+const isJsonObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const cloneJson = (value) => JSON.parse(JSON.stringify(value));
+const ownDef = (defs, id) => Object.hasOwn(defs, id) ? defs[id] : undefined;
+const parseDefRef = (ref) => {
+    if (typeof ref !== 'string' || !ref.startsWith(DEF_PREFIX)) {
+        return undefined;
+    }
+    return ref.slice(DEF_PREFIX.length);
+};
+const walkJson = (node, visit) => {
+    if (Array.isArray(node)) {
+        for (const item of node) {
+            walkJson(item, visit);
+        }
+        return;
+    }
+    if (!isJsonObject(node)) {
+        return;
+    }
+    visit(node);
+    for (const value of Object.values(node)) {
+        walkJson(value, visit);
+    }
+};
+const mapJson = (node, visit) => {
+    if (Array.isArray(node)) {
+        return node.map((item) => mapJson(item, visit));
+    }
+    if (!isJsonObject(node)) {
+        return node;
+    }
+    return Object.fromEntries(Object.entries(visit(node)).map(([key, value]) => [
+        key,
+        mapJson(value, visit),
+    ]));
+};
+const rewriteDefRefs = (schema, rewrite) => mapJson(schema, (node) => {
+    const id = parseDefRef(node.$ref);
+    if (id === undefined) {
+        return node;
+    }
+    const replacement = rewrite(id);
+    if (replacement === undefined) {
+        return node;
+    }
+    if (typeof replacement === 'string') {
+        return { ...node, $ref: `${DEF_PREFIX}${replacement}` };
+    }
+    const rest = { ...node };
+    delete rest.$ref;
+    return Object.keys(rest).length === 0
+        ? cloneJson(replacement)
+        : { ...cloneJson(replacement), ...rest };
+});
+const isRefOnlyDef = (def) => isJsonObject(def) &&
+    Object.keys(def).length === 1 &&
+    typeof def.$ref === 'string';
+const isBareScalarDef = (def) => {
+    if (!isJsonObject(def)) {
+        return false;
+    }
+    const { type } = def;
+    if (typeof type !== 'string' || !SCALAR_TYPES.has(type)) {
+        return false;
+    }
+    return !['enum', 'const', '$ref', 'properties'].some((key) => Object.hasOwn(def, key));
+};
+const defsOf = (schema) => isJsonObject(schema.$defs) ? schema.$defs : {};
+const withDefs = (schema, defs) => ({ ...schema, $defs: defs });
+const dropSafeIntegerMaxima = (schema) => {
+    walkJson(schema, (node) => {
+        if (node.maximum === SAFE_INTEGER_MAX) {
+            delete node.maximum;
+        }
+        if (node.minimum === -SAFE_INTEGER_MAX) {
+            delete node.minimum;
+        }
+    });
+};
+const dropNodeIdAndSurfaces = (schema) => {
+    for (const def of Object.values(defsOf(schema))) {
+        if (!isJsonObject(def) || !isJsonObject(def.properties)) {
+            continue;
+        }
+        const typeProp = def.properties.type;
+        if (!isJsonObject(typeProp) || typeof typeProp.const !== 'string') {
+            continue;
+        }
+        delete def.properties.id;
+        delete def.properties.surfaces;
+        if (Array.isArray(def.required)) {
+            def.required = def.required.filter((key) => key !== 'id' && key !== 'surfaces');
+        }
+    }
+};
+const omitListedProperties = (schema, paths) => {
+    const defs = defsOf(schema);
+    for (const path of paths) {
+        const dot = path.indexOf('.');
+        if (dot <= 0) {
+            continue;
+        }
+        const defId = path.slice(0, dot);
+        const property = path.slice(dot + 1);
+        const def = ownDef(defs, defId);
+        if (!isJsonObject(def) || !isJsonObject(def.properties)) {
+            continue;
+        }
+        delete def.properties[property];
+        if (Array.isArray(def.required)) {
+            def.required = def.required.filter((key) => key !== property);
+        }
+    }
+};
+const applyDescriptions = (schema, describe) => {
+    const defs = defsOf(schema);
+    for (const [id, description] of Object.entries(describe)) {
+        const def = ownDef(defs, id);
+        if (isJsonObject(def)) {
+            def.description = description;
+        }
+    }
+};
+const flattenRefOnlyDefs = (schema) => {
+    const defs = defsOf(schema);
+    const aliases = new Map();
+    for (const [id, def] of Object.entries(defs)) {
+        if (id === BODY_NODE_ID || !isRefOnlyDef(def)) {
+            continue;
+        }
+        const target = parseDefRef(def.$ref);
+        if (target === undefined || target === id) {
+            continue;
+        }
+        aliases.set(id, target);
+    }
+    if (aliases.size === 0) {
+        return schema;
+    }
+    const resolve = (id) => {
+        const seen = new Set();
+        let current = id;
+        while (aliases.has(current) && !seen.has(current)) {
+            seen.add(current);
+            current = aliases.get(current) ?? current;
+        }
+        return current;
+    };
+    const rewritten = rewriteDefRefs(schema, (id) => aliases.has(id) ? resolve(id) : undefined);
+    const nextDefs = { ...defsOf(rewritten) };
+    for (const id of aliases.keys()) {
+        delete nextDefs[id];
+    }
+    return withDefs(rewritten, nextDefs);
+};
+const inlineScalarDefs = (schema) => {
+    const defs = defsOf(schema);
+    const scalars = new Map();
+    for (const [id, def] of Object.entries(defs)) {
+        if (id === BODY_NODE_ID || !isBareScalarDef(def)) {
+            continue;
+        }
+        scalars.set(id, def);
+    }
+    if (scalars.size === 0) {
+        return schema;
+    }
+    const rewritten = rewriteDefRefs(schema, (id) => scalars.get(id));
+    const nextDefs = { ...defsOf(rewritten) };
+    for (const id of scalars.keys()) {
+        delete nextDefs[id];
+    }
+    return withDefs(rewritten, nextDefs);
+};
+const pruneUnreferencedDefs = (schema) => {
+    const defs = defsOf(schema);
+    if (Object.keys(defs).length === 0) {
+        return schema;
+    }
+    const referenced = new Set();
+    const visit = (node) => {
+        walkJson(node, (value) => {
+            const id = parseDefRef(value.$ref);
+            if (id === undefined || referenced.has(id)) {
+                return;
+            }
+            referenced.add(id);
+            visit(ownDef(defs, id));
+        });
+    };
+    const root = { ...schema };
+    delete root.$defs;
+    visit(root);
+    referenced.add(BODY_NODE_ID);
+    visit(defs[BODY_NODE_ID]);
+    return withDefs(schema, Object.fromEntries(Object.entries(defs).filter(([id]) => referenced.has(id))));
+};
+const mergeExtraDefs = (extras) => {
+    const bySchema = new Map();
+    for (const item of DEFAULT_EXTRA_DEFS) {
+        bySchema.set(item.schema, item);
+    }
+    for (const item of extras ?? []) {
+        bySchema.set(item.schema, item);
+    }
+    const byId = new Map();
+    for (const item of bySchema.values()) {
+        byId.set(item.id, item);
+    }
+    return [...byId.values()];
+};
+const slimAuthoringSchema = (schema, options) => {
+    const next = cloneJson(schema);
+    dropSafeIntegerMaxima(next);
+    dropNodeIdAndSurfaces(next);
+    omitListedProperties(next, options.omitProperties ?? []);
+    const flattened = flattenRefOnlyDefs(next);
+    const inlined = inlineScalarDefs(flattened);
+    const pruned = pruneUnreferencedDefs(inlined);
+    applyDescriptions(pruned, options.describe ?? {});
+    return pruned;
+};
+/**
+ * Projects a composition to the JSON Schema an agent reads.
+ *
+ * {@link buildCompositionJsonSchema} stays the validator projection. This walk
+ * names shared SDK defs, inlines scalar leaves, and drops host-only fields.
+ */
+export const buildAuthoringJsonSchema = (definitions, options = {}) => {
+    const { describe, omitProperties, extraDefs, ...rest } = options;
+    const projected = buildCompositionJsonSchema(definitions, {
+        ...rest,
+        extraDefs: mergeExtraDefs(extraDefs),
+    });
+    return slimAuthoringSchema(projected, {
+        ...(describe === undefined ? {} : { describe }),
+        ...(omitProperties === undefined ? {} : { omitProperties }),
+    });
+};
+const BODY_NODE_STUB = {
+    description: 'Any primitive in the catalog, as its own object with its `type`.',
+};
+/**
+ * The `$defs` that `types` reach in a schema from {@link buildAuthoringJsonSchema},
+ * keyed as `schema` keys them, with the body-node union stubbed so a container
+ * does not pull in every primitive.
+ */
+export const authoringSchemaSubset = (schema, types) => {
+    const defs = defsOf(schema);
+    // A `Map`, so an id such as `constructor` is never an inherited key.
+    const kept = new Map();
+    const visit = (id) => {
+        if (kept.has(id) || !Object.hasOwn(defs, id)) {
+            return;
+        }
+        if (id === BODY_NODE_ID) {
+            kept.set(id, BODY_NODE_STUB);
+            return;
+        }
+        kept.set(id, defs[id]);
+        walkJson(defs[id], (value) => {
+            const ref = parseDefRef(value.$ref);
+            if (ref !== undefined) {
+                visit(ref);
+            }
+        });
+    };
+    for (const type of types) {
+        visit(type);
+    }
+    return { $defs: Object.fromEntries(kept) };
+};
+/**
+ * The `body` of a schema from {@link buildAuthoringJsonSchema} as a schema of
+ * its own, for an editor that validates body nodes rather than a whole
+ * composition. Carries the `$defs` the body reaches.
+ */
+export const authoringBodySchema = (schema) => {
+    const { properties, $schema } = schema;
+    const body = isJsonObject(properties) ? properties.body : undefined;
+    return pruneUnreferencedDefs({
+        ...(typeof $schema === 'string' ? { $schema } : {}),
+        title: 'Body',
+        ...(isJsonObject(body) ? body : { type: 'array' }),
+        $defs: defsOf(schema),
+    });
+};
+//# sourceMappingURL=authoring_schema.js.map

package/dist/validate/authoring_schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_schema.js","sourceRoot":"","sources":["../../src/validate/authoring_schema.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 type { ZodType } from 'zod';\n\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport {\n  buildCompositionJsonSchema,\n  type CompositionJsonSchemaOptions,\n} from './json_schema';\nimport {\n  displayValueSchema,\n  namedColorSchema,\n  renderThemeSchema,\n  structuredValueSchema,\n} from './value_schemas';\n\ntype JsonSchema = Record<string, unknown>;\n\nconst DEF_PREFIX = '#/$defs/';\nconst BODY_NODE_ID = 'bodyNode';\nconst SAFE_INTEGER_MAX = Number.MAX_SAFE_INTEGER;\nconst SCALAR_TYPES = new Set(['string', 'number', 'integer', 'boolean']);\n\nconst DEFAULT_EXTRA_DEFS: readonly { schema: ZodType; id: string }[] = [\n  { schema: namedColorSchema, id: 'tone' },\n  { schema: displayValueSchema, id: 'displayValue' },\n  { schema: structuredValueSchema, id: 'structuredValue' },\n  { schema: renderThemeSchema, id: 'renderTheme' },\n];\n\n/** Options for {@link buildAuthoringJsonSchema}. */\nexport interface AuthoringJsonSchemaOptions extends CompositionJsonSchemaOptions {\n  /** `$def` id to `description`. Survives `z.toJSONSchema` dropping `.refine` text. */\n  describe?: Readonly<Record<string, string>>;\n  /** `$defId.property` paths to drop, e.g. `'kpi.delta'`. */\n  omitProperties?: readonly string[];\n}\n\nconst isJsonObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst cloneJson = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\nconst ownDef = (defs: Record<string, unknown>, id: string): unknown =>\n  Object.hasOwn(defs, id) ? defs[id] : undefined;\n\nconst parseDefRef = (ref: unknown): string | undefined => {\n  if (typeof ref !== 'string' || !ref.startsWith(DEF_PREFIX)) {\n    return undefined;\n  }\n  return ref.slice(DEF_PREFIX.length);\n};\n\nconst walkJson = (\n  node: unknown,\n  visit: (value: Record<string, unknown>) => void\n): void => {\n  if (Array.isArray(node)) {\n    for (const item of node) {\n      walkJson(item, visit);\n    }\n    return;\n  }\n  if (!isJsonObject(node)) {\n    return;\n  }\n  visit(node);\n  for (const value of Object.values(node)) {\n    walkJson(value, visit);\n  }\n};\n\nconst mapJson = (\n  node: unknown,\n  visit: (value: Record<string, unknown>) => Record<string, unknown>\n): unknown => {\n  if (Array.isArray(node)) {\n    return node.map((item) => mapJson(item, visit));\n  }\n  if (!isJsonObject(node)) {\n    return node;\n  }\n  return Object.fromEntries(\n    Object.entries(visit(node)).map(([key, value]) => [\n      key,\n      mapJson(value, visit),\n    ])\n  );\n};\n\nconst rewriteDefRefs = (\n  schema: JsonSchema,\n  rewrite: (id: string) => string | JsonSchema | undefined\n): JsonSchema =>\n  mapJson(schema, (node) => {\n    const id = parseDefRef(node.$ref);\n    if (id === undefined) {\n      return node;\n    }\n    const replacement = rewrite(id);\n    if (replacement === undefined) {\n      return node;\n    }\n    if (typeof replacement === 'string') {\n      return { ...node, $ref: `${DEF_PREFIX}${replacement}` };\n    }\n    const rest = { ...node };\n    delete rest.$ref;\n    return Object.keys(rest).length === 0\n      ? cloneJson(replacement)\n      : { ...cloneJson(replacement), ...rest };\n  }) as JsonSchema;\n\nconst isRefOnlyDef = (def: unknown): def is { $ref: string } =>\n  isJsonObject(def) &&\n  Object.keys(def).length === 1 &&\n  typeof def.$ref === 'string';\n\nconst isBareScalarDef = (def: unknown): def is Record<string, unknown> => {\n  if (!isJsonObject(def)) {\n    return false;\n  }\n  const { type } = def;\n  if (typeof type !== 'string' || !SCALAR_TYPES.has(type)) {\n    return false;\n  }\n  return !['enum', 'const', '$ref', 'properties'].some((key) =>\n    Object.hasOwn(def, key)\n  );\n};\n\nconst defsOf = (schema: JsonSchema): Record<string, unknown> =>\n  isJsonObject(schema.$defs) ? schema.$defs : {};\n\nconst withDefs = (\n  schema: JsonSchema,\n  defs: Record<string, unknown>\n): JsonSchema => ({ ...schema, $defs: defs });\n\nconst dropSafeIntegerMaxima = (schema: JsonSchema): void => {\n  walkJson(schema, (node) => {\n    if (node.maximum === SAFE_INTEGER_MAX) {\n      delete node.maximum;\n    }\n    if (node.minimum === -SAFE_INTEGER_MAX) {\n      delete node.minimum;\n    }\n  });\n};\n\nconst dropNodeIdAndSurfaces = (schema: JsonSchema): void => {\n  for (const def of Object.values(defsOf(schema))) {\n    if (!isJsonObject(def) || !isJsonObject(def.properties)) {\n      continue;\n    }\n    const typeProp = def.properties.type;\n    if (!isJsonObject(typeProp) || typeof typeProp.const !== 'string') {\n      continue;\n    }\n    delete def.properties.id;\n    delete def.properties.surfaces;\n    if (Array.isArray(def.required)) {\n      def.required = def.required.filter(\n        (key) => key !== 'id' && key !== 'surfaces'\n      );\n    }\n  }\n};\n\nconst omitListedProperties = (\n  schema: JsonSchema,\n  paths: readonly string[]\n): void => {\n  const defs = defsOf(schema);\n  for (const path of paths) {\n    const dot = path.indexOf('.');\n    if (dot <= 0) {\n      continue;\n    }\n    const defId = path.slice(0, dot);\n    const property = path.slice(dot + 1);\n    const def = ownDef(defs, defId);\n    if (!isJsonObject(def) || !isJsonObject(def.properties)) {\n      continue;\n    }\n    delete def.properties[property];\n    if (Array.isArray(def.required)) {\n      def.required = def.required.filter((key) => key !== property);\n    }\n  }\n};\n\nconst applyDescriptions = (\n  schema: JsonSchema,\n  describe: Readonly<Record<string, string>>\n): void => {\n  const defs = defsOf(schema);\n  for (const [id, description] of Object.entries(describe)) {\n    const def = ownDef(defs, id);\n    if (isJsonObject(def)) {\n      def.description = description;\n    }\n  }\n};\n\nconst flattenRefOnlyDefs = (schema: JsonSchema): JsonSchema => {\n  const defs = defsOf(schema);\n  const aliases = new Map<string, string>();\n  for (const [id, def] of Object.entries(defs)) {\n    if (id === BODY_NODE_ID || !isRefOnlyDef(def)) {\n      continue;\n    }\n    const target = parseDefRef(def.$ref);\n    if (target === undefined || target === id) {\n      continue;\n    }\n    aliases.set(id, target);\n  }\n  if (aliases.size === 0) {\n    return schema;\n  }\n  const resolve = (id: string): string => {\n    const seen = new Set<string>();\n    let current = id;\n    while (aliases.has(current) && !seen.has(current)) {\n      seen.add(current);\n      current = aliases.get(current) ?? current;\n    }\n    return current;\n  };\n  const rewritten = rewriteDefRefs(schema, (id) =>\n    aliases.has(id) ? resolve(id) : undefined\n  );\n  const nextDefs = { ...defsOf(rewritten) };\n  for (const id of aliases.keys()) {\n    delete nextDefs[id];\n  }\n  return withDefs(rewritten, nextDefs);\n};\n\nconst inlineScalarDefs = (schema: JsonSchema): JsonSchema => {\n  const defs = defsOf(schema);\n  const scalars = new Map<string, Record<string, unknown>>();\n  for (const [id, def] of Object.entries(defs)) {\n    if (id === BODY_NODE_ID || !isBareScalarDef(def)) {\n      continue;\n    }\n    scalars.set(id, def);\n  }\n  if (scalars.size === 0) {\n    return schema;\n  }\n  const rewritten = rewriteDefRefs(schema, (id) => scalars.get(id));\n  const nextDefs = { ...defsOf(rewritten) };\n  for (const id of scalars.keys()) {\n    delete nextDefs[id];\n  }\n  return withDefs(rewritten, nextDefs);\n};\n\nconst pruneUnreferencedDefs = (schema: JsonSchema): JsonSchema => {\n  const defs = defsOf(schema);\n  if (Object.keys(defs).length === 0) {\n    return schema;\n  }\n  const referenced = new Set<string>();\n  const visit = (node: unknown): void => {\n    walkJson(node, (value) => {\n      const id = parseDefRef(value.$ref);\n      if (id === undefined || referenced.has(id)) {\n        return;\n      }\n      referenced.add(id);\n      visit(ownDef(defs, id));\n    });\n  };\n  const root: JsonSchema = { ...schema };\n  delete root.$defs;\n  visit(root);\n  referenced.add(BODY_NODE_ID);\n  visit(defs[BODY_NODE_ID]);\n  return withDefs(\n    schema,\n    Object.fromEntries(\n      Object.entries(defs).filter(([id]) => referenced.has(id))\n    )\n  );\n};\n\nconst mergeExtraDefs = (\n  extras: CompositionJsonSchemaOptions['extraDefs']\n): { schema: ZodType; id: string }[] => {\n  const bySchema = new Map<ZodType, { schema: ZodType; id: string }>();\n  for (const item of DEFAULT_EXTRA_DEFS) {\n    bySchema.set(item.schema, item);\n  }\n  for (const item of extras ?? []) {\n    bySchema.set(item.schema, item);\n  }\n  const byId = new Map<string, { schema: ZodType; id: string }>();\n  for (const item of bySchema.values()) {\n    byId.set(item.id, item);\n  }\n  return [...byId.values()];\n};\n\nconst slimAuthoringSchema = (\n  schema: JsonSchema,\n  options: AuthoringJsonSchemaOptions\n): JsonSchema => {\n  const next = cloneJson(schema);\n  dropSafeIntegerMaxima(next);\n  dropNodeIdAndSurfaces(next);\n  omitListedProperties(next, options.omitProperties ?? []);\n  const flattened = flattenRefOnlyDefs(next);\n  const inlined = inlineScalarDefs(flattened);\n  const pruned = pruneUnreferencedDefs(inlined);\n  applyDescriptions(pruned, options.describe ?? {});\n  return pruned;\n};\n\n/**\n * Projects a composition to the JSON Schema an agent reads.\n *\n * {@link buildCompositionJsonSchema} stays the validator projection. This walk\n * names shared SDK defs, inlines scalar leaves, and drops host-only fields.\n */\nexport const buildAuthoringJsonSchema = (\n  definitions: readonly AnyPrimitiveDefinition[],\n  options: AuthoringJsonSchemaOptions = {}\n): JsonSchema => {\n  const { describe, omitProperties, extraDefs, ...rest } = options;\n  const projected = buildCompositionJsonSchema(definitions, {\n    ...rest,\n    extraDefs: mergeExtraDefs(extraDefs),\n  });\n  return slimAuthoringSchema(projected, {\n    ...(describe === undefined ? {} : { describe }),\n    ...(omitProperties === undefined ? {} : { omitProperties }),\n  });\n};\n\nconst BODY_NODE_STUB = {\n  description:\n    'Any primitive in the catalog, as its own object with its `type`.',\n};\n\n/**\n * The `$defs` that `types` reach in a schema from {@link buildAuthoringJsonSchema},\n * keyed as `schema` keys them, with the body-node union stubbed so a container\n * does not pull in every primitive.\n */\nexport const authoringSchemaSubset = (\n  schema: JsonSchema,\n  types: readonly string[]\n): { $defs: Record<string, unknown> } => {\n  const defs = defsOf(schema);\n  // A `Map`, so an id such as `constructor` is never an inherited key.\n  const kept = new Map<string, unknown>();\n  const visit = (id: string): void => {\n    if (kept.has(id) || !Object.hasOwn(defs, id)) {\n      return;\n    }\n    if (id === BODY_NODE_ID) {\n      kept.set(id, BODY_NODE_STUB);\n      return;\n    }\n    kept.set(id, defs[id]);\n    walkJson(defs[id], (value) => {\n      const ref = parseDefRef(value.$ref);\n      if (ref !== undefined) {\n        visit(ref);\n      }\n    });\n  };\n  for (const type of types) {\n    visit(type);\n  }\n  return { $defs: Object.fromEntries(kept) };\n};\n\n/**\n * The `body` of a schema from {@link buildAuthoringJsonSchema} as a schema of\n * its own, for an editor that validates body nodes rather than a whole\n * composition. Carries the `$defs` the body reaches.\n */\nexport const authoringBodySchema = (schema: JsonSchema): JsonSchema => {\n  const { properties, $schema } = schema;\n  const body = isJsonObject(properties) ? properties.body : undefined;\n  return pruneUnreferencedDefs({\n    ...(typeof $schema === 'string' ? { $schema } : {}),\n    title: 'Body',\n    ...(isJsonObject(body) ? body : { type: 'array' }),\n    $defs: defsOf(schema),\n  });\n};\n"]}

package/dist/validate/composition_schema.d.ts

@@ -0,0 +1,80 @@
+import { z, type ZodObject, type ZodType } from 'zod';
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+/** `Composition.meta`: provenance and freshness, every field optional. */
+export declare const metaSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodString>;
+    generatedAt: z.ZodOptional<z.ZodString>;
+    ariaLabel: z.ZodOptional<z.ZodString>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    freshness: z.ZodOptional<z.ZodObject<{
+        asOf: z.ZodOptional<z.ZodString>;
+        stale: z.ZodOptional<z.ZodBoolean>;
+        ttlSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    partialFailure: z.ZodOptional<z.ZodObject<{
+        degraded: z.ZodOptional<z.ZodBoolean>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Options for the `Composition` envelope schema a body-node union is wrapped in. */
+export interface CompositionSchemaOptions {
+    /** The union the envelope's `body` array holds, as {@link resolveVocabulary} builds it. */
+    bodyNodeSchema: ZodType<unknown>;
+}
+/**
+ * Wraps a body-node union in the `Composition` envelope.
+ *
+ * `.strict()`, so an unknown root key is an error rather than silently carried:
+ * the format crosses vendor boundaries, and a typo'd field that validates is
+ * worse than one that fails. Most callers want
+ * {@link getCompositionSchemaForDefinitions} instead, which memoizes.
+ */
+export declare const buildCompositionSchema: ({ bodyNodeSchema, }: CompositionSchemaOptions) => ZodObject;
+/**
+ * One set of definitions resolved into a body-node union, with the schema
+ * instance that actually landed in it per primitive type.
+ *
+ * The members matter to callers because a container's schema in the union is
+ * built by `schemaFor` and is therefore *not* `definition.schema`. Anything
+ * keyed on identity — the JSON Schema id registry, which names `$defs` — has to
+ * be given these, or a container's projection silently loses its name.
+ */
+export interface ResolvedVocabulary {
+    /** The discriminated union over every primitive type in this vocabulary. */
+    bodyNodeSchema: ZodType<unknown>;
+    /** Keyed by node type. A container's value comes from `schemaFor`, not `definition.schema`. */
+    members: ReadonlyMap<string, ZodObject>;
+}
+/**
+ * Builds a body-node union whose containers reference *this* union.
+ *
+ * The `z.lazy` closing the recursion is created here and discarded with the
+ * vocabulary: it memoizes its getter after the first resolution, so one shared
+ * across vocabularies would freeze on whichever union parsed first.
+ */
+export declare const resolveVocabulary: (definitions: readonly AnyPrimitiveDefinition[]) => ResolvedVocabulary;
+/**
+ * {@link resolveVocabulary}, discarding the member instances.
+ *
+ * Only for a caller with no id registry to name; anything projecting to JSON
+ * Schema needs the members and should use {@link resolveVocabulary}.
+ */
+export declare const buildBodyNodeSchemaFromDefinitions: (definitions: readonly AnyPrimitiveDefinition[]) => ZodType<unknown>;
+/**
+ * A fresh `Composition` schema over `definitions`.
+ *
+ * Builds a new union per call. Prefer
+ * {@link getCompositionSchemaForDefinitions} unless a fresh instance is
+ * required.
+ */
+export declare const buildCompositionSchemaFromDefinitions: (definitions: readonly AnyPrimitiveDefinition[]) => ZodObject;
+/**
+ * {@link buildCompositionSchemaFromDefinitions}, memoized per definition array.
+ * Prefer this whenever the caller does not need a fresh schema instance.
+ */
+export declare const getCompositionSchemaForDefinitions: (definitions: readonly AnyPrimitiveDefinition[]) => ZodObject;
+//# sourceMappingURL=composition_schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composition_schema.d.ts","sourceRoot":"","sources":["../../src/validate/composition_schema.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAGtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIzE,0EAA0E;AAC1E,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;iBAwBrB,CAAC;AAEH,qFAAqF;AACrF,MAAM,WAAW,wBAAwB;IACvC,2FAA2F;IAC3F,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,qBAEpC,wBAAwB,KAAG,SAajB,CAAC;AAEd;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,+FAA+F;IAC/F,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,SAAS,sBAAsB,EAAE,KAC7C,kBAmCF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,GAC7C,aAAa,SAAS,sBAAsB,EAAE,KAC7C,OAAO,CAAC,OAAO,CAAkD,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC,GAChD,aAAa,SAAS,sBAAsB,EAAE,KAC7C,SAGC,CAAC;AAgCL;;;GAGG;AACH,eAAO,MAAM,kCAAkC,GAC7C,aAAa,SAAS,sBAAsB,EAAE,KAC7C,SAA0C,CAAC"}

package/dist/validate/composition_schema.js

@@ -0,0 +1,127 @@
+/*
+ * 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 { z } from 'zod';
+import { IsomerError } from '../composition/error.js';
+import { renderThemeSchema } from './value_schemas.js';
+/** `Composition.meta`: provenance and freshness, every field optional. */
+export const metaSchema = z.object({
+    source: z.string().optional(),
+    generatedAt: z.string().optional(),
+    ariaLabel: z.string().optional(),
+    provenance: z
+        .object({
+        source: z.string().optional(),
+        query: z.string().optional(),
+        provider: z.string().optional(),
+    })
+        .optional(),
+    freshness: z
+        .object({
+        asOf: z.string().optional(),
+        stale: z.boolean().optional(),
+        ttlSeconds: z.number().optional(),
+    })
+        .optional(),
+    partialFailure: z
+        .object({
+        degraded: z.boolean().optional(),
+        reason: z.string().optional(),
+    })
+        .optional(),
+});
+/**
+ * Wraps a body-node union in the `Composition` envelope.
+ *
+ * `.strict()`, so an unknown root key is an error rather than silently carried:
+ * the format crosses vendor boundaries, and a typo'd field that validates is
+ * worse than one that fails. Most callers want
+ * {@link getCompositionSchemaForDefinitions} instead, which memoizes.
+ */
+export const buildCompositionSchema = ({ bodyNodeSchema, }) => z
+    .object({
+    type: z.literal('view', { error: 'type must be "view"' }),
+    version: z.literal(1).optional(),
+    title: z.string().optional(),
+    subtitle: z.string().optional(),
+    theme: renderThemeSchema.optional(),
+    body: z
+        .array(bodyNodeSchema)
+        .min(1, { error: 'must contain at least one node' }),
+    meta: metaSchema.optional(),
+})
+    .strict();
+/**
+ * Builds a body-node union whose containers reference *this* union.
+ *
+ * The `z.lazy` closing the recursion is created here and discarded with the
+ * vocabulary: it memoizes its getter after the first resolution, so one shared
+ * across vocabularies would freeze on whichever union parsed first.
+ */
+export const resolveVocabulary = (definitions) => {
+    if (definitions.length === 0) {
+        throw new IsomerError('EMPTY_VOCABULARY', 'resolveVocabulary: at least one primitive is required');
+    }
+    // Resolved once the union exists; nothing parses before this function returns.
+    const pending = {};
+    const resolveUnion = () => {
+        if (!pending.union) {
+            throw new IsomerError('VOCABULARY_UNRESOLVED', 'resolveVocabulary: body-node union read before its vocabulary resolved');
+        }
+        return pending.union;
+    };
+    const members = new Map();
+    const memberSchemas = definitions.map((definition) => {
+        const schema = definition.schemaFor
+            ? // One `z.lazy` per container: the JSON Schema projection gives a shared
+                // wrapper its own anonymous `$def` instead of `$ref: #/$defs/bodyNode`.
+                definition.schemaFor(z.lazy(resolveUnion))
+            : definition.schema;
+        members.set(definition.type, schema);
+        return schema;
+    });
+    pending.union = z.discriminatedUnion('type', memberSchemas);
+    return { bodyNodeSchema: pending.union, members };
+};
+/**
+ * {@link resolveVocabulary}, discarding the member instances.
+ *
+ * Only for a caller with no id registry to name; anything projecting to JSON
+ * Schema needs the members and should use {@link resolveVocabulary}.
+ */
+export const buildBodyNodeSchemaFromDefinitions = (definitions) => resolveVocabulary(definitions).bodyNodeSchema;
+/**
+ * A fresh `Composition` schema over `definitions`.
+ *
+ * Builds a new union per call. Prefer
+ * {@link getCompositionSchemaForDefinitions} unless a fresh instance is
+ * required.
+ */
+export const buildCompositionSchemaFromDefinitions = (definitions) => buildCompositionSchema({
+    bodyNodeSchema: buildBodyNodeSchemaFromDefinitions(definitions),
+});
+const compositionSchemaCache = new WeakMap();
+const cachedFor = (definitions) => {
+    const cached = compositionSchemaCache.get(definitions);
+    if (cached) {
+        return cached;
+    }
+    const vocabulary = resolveVocabulary(definitions);
+    const entry = {
+        vocabulary,
+        schema: buildCompositionSchema({
+            bodyNodeSchema: vocabulary.bodyNodeSchema,
+        }),
+    };
+    compositionSchemaCache.set(definitions, entry);
+    return entry;
+};
+/**
+ * {@link buildCompositionSchemaFromDefinitions}, memoized per definition array.
+ * Prefer this whenever the caller does not need a fresh schema instance.
+ */
+export const getCompositionSchemaForDefinitions = (definitions) => cachedFor(definitions).schema;
+//# sourceMappingURL=composition_schema.js.map

package/dist/validate/composition_schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition_schema.js","sourceRoot":"","sources":["../../src/validate/composition_schema.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 { z, type ZodObject, type ZodType } from 'zod';\n\nimport { IsomerError } from '../composition/error';\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport { renderThemeSchema } from './value_schemas';\n\n/** `Composition.meta`: provenance and freshness, every field optional. */\nexport const metaSchema = z.object({\n  source: z.string().optional(),\n  generatedAt: z.string().optional(),\n  ariaLabel: z.string().optional(),\n  provenance: z\n    .object({\n      source: z.string().optional(),\n      query: z.string().optional(),\n      provider: z.string().optional(),\n    })\n    .optional(),\n  freshness: z\n    .object({\n      asOf: z.string().optional(),\n      stale: z.boolean().optional(),\n      ttlSeconds: z.number().optional(),\n    })\n    .optional(),\n  partialFailure: z\n    .object({\n      degraded: z.boolean().optional(),\n      reason: z.string().optional(),\n    })\n    .optional(),\n});\n\n/** Options for the `Composition` envelope schema a body-node union is wrapped in. */\nexport interface CompositionSchemaOptions {\n  /** The union the envelope's `body` array holds, as {@link resolveVocabulary} builds it. */\n  bodyNodeSchema: ZodType<unknown>;\n}\n\n/**\n * Wraps a body-node union in the `Composition` envelope.\n *\n * `.strict()`, so an unknown root key is an error rather than silently carried:\n * the format crosses vendor boundaries, and a typo'd field that validates is\n * worse than one that fails. Most callers want\n * {@link getCompositionSchemaForDefinitions} instead, which memoizes.\n */\nexport const buildCompositionSchema = ({\n  bodyNodeSchema,\n}: CompositionSchemaOptions): ZodObject =>\n  z\n    .object({\n      type: z.literal('view', { error: 'type must be \"view\"' }),\n      version: z.literal(1).optional(),\n      title: z.string().optional(),\n      subtitle: z.string().optional(),\n      theme: renderThemeSchema.optional(),\n      body: z\n        .array(bodyNodeSchema)\n        .min(1, { error: 'must contain at least one node' }),\n      meta: metaSchema.optional(),\n    })\n    .strict();\n\n/**\n * One set of definitions resolved into a body-node union, with the schema\n * instance that actually landed in it per primitive type.\n *\n * The members matter to callers because a container's schema in the union is\n * built by `schemaFor` and is therefore *not* `definition.schema`. Anything\n * keyed on identity — the JSON Schema id registry, which names `$defs` — has to\n * be given these, or a container's projection silently loses its name.\n */\nexport interface ResolvedVocabulary {\n  /** The discriminated union over every primitive type in this vocabulary. */\n  bodyNodeSchema: ZodType<unknown>;\n  /** Keyed by node type. A container's value comes from `schemaFor`, not `definition.schema`. */\n  members: ReadonlyMap<string, ZodObject>;\n}\n\n/**\n * Builds a body-node union whose containers reference *this* union.\n *\n * The `z.lazy` closing the recursion is created here and discarded with the\n * vocabulary: it memoizes its getter after the first resolution, so one shared\n * across vocabularies would freeze on whichever union parsed first.\n */\nexport const resolveVocabulary = (\n  definitions: readonly AnyPrimitiveDefinition[]\n): ResolvedVocabulary => {\n  if (definitions.length === 0) {\n    throw new IsomerError(\n      'EMPTY_VOCABULARY',\n      'resolveVocabulary: at least one primitive is required'\n    );\n  }\n  // Resolved once the union exists; nothing parses before this function returns.\n  const pending: { union?: ZodType<unknown> } = {};\n  const resolveUnion = (): ZodType<unknown> => {\n    if (!pending.union) {\n      throw new IsomerError(\n        'VOCABULARY_UNRESOLVED',\n        'resolveVocabulary: body-node union read before its vocabulary resolved'\n      );\n    }\n    return pending.union;\n  };\n\n  const members = new Map<string, ZodObject>();\n  const memberSchemas = definitions.map((definition) => {\n    const schema = definition.schemaFor\n      ? // One `z.lazy` per container: the JSON Schema projection gives a shared\n        // wrapper its own anonymous `$def` instead of `$ref: #/$defs/bodyNode`.\n        definition.schemaFor(z.lazy(resolveUnion))\n      : definition.schema;\n    members.set(definition.type, schema);\n    return schema;\n  });\n\n  pending.union = z.discriminatedUnion(\n    'type',\n    memberSchemas as [ZodObject, ...ZodObject[]]\n  );\n  return { bodyNodeSchema: pending.union, members };\n};\n\n/**\n * {@link resolveVocabulary}, discarding the member instances.\n *\n * Only for a caller with no id registry to name; anything projecting to JSON\n * Schema needs the members and should use {@link resolveVocabulary}.\n */\nexport const buildBodyNodeSchemaFromDefinitions = (\n  definitions: readonly AnyPrimitiveDefinition[]\n): ZodType<unknown> => resolveVocabulary(definitions).bodyNodeSchema;\n\n/**\n * A fresh `Composition` schema over `definitions`.\n *\n * Builds a new union per call. Prefer\n * {@link getCompositionSchemaForDefinitions} unless a fresh instance is\n * required.\n */\nexport const buildCompositionSchemaFromDefinitions = (\n  definitions: readonly AnyPrimitiveDefinition[]\n): ZodObject =>\n  buildCompositionSchema({\n    bodyNodeSchema: buildBodyNodeSchemaFromDefinitions(definitions),\n  });\n\n// Keyed on the definition array's identity: a runtime needs the same schema\n// for its validator, parser, and authoring context, so hold the array\n// `composePacks` returns rather than flattening per call. The vocabulary is\n// cached with the schema because the JSON Schema id registry names member\n// instances, and a second resolution would produce different ones.\ninterface CachedCompositionSchema {\n  schema: ZodObject;\n  vocabulary: ResolvedVocabulary;\n}\n\nconst compositionSchemaCache = new WeakMap<object, CachedCompositionSchema>();\n\nconst cachedFor = (\n  definitions: readonly AnyPrimitiveDefinition[]\n): CachedCompositionSchema => {\n  const cached = compositionSchemaCache.get(definitions);\n  if (cached) {\n    return cached;\n  }\n  const vocabulary = resolveVocabulary(definitions);\n  const entry: CachedCompositionSchema = {\n    vocabulary,\n    schema: buildCompositionSchema({\n      bodyNodeSchema: vocabulary.bodyNodeSchema,\n    }),\n  };\n  compositionSchemaCache.set(definitions, entry);\n  return entry;\n};\n\n/**\n * {@link buildCompositionSchemaFromDefinitions}, memoized per definition array.\n * Prefer this whenever the caller does not need a fresh schema instance.\n */\nexport const getCompositionSchemaForDefinitions = (\n  definitions: readonly AnyPrimitiveDefinition[]\n): ZodObject => cachedFor(definitions).schema;\n"]}

package/dist/validate/index.d.ts

@@ -0,0 +1,9 @@
+export { type AuthoringJsonSchemaOptions, authoringBodySchema, authoringSchemaSubset, buildAuthoringJsonSchema, } from './authoring_schema.js';
+export { type CompositionSchemaOptions, buildBodyNodeSchemaFromDefinitions, buildCompositionSchema, buildCompositionSchemaFromDefinitions, getCompositionSchemaForDefinitions, metaSchema, } from './composition_schema.js';
+export { type InputBudget, type InputBudgetCheck, MAX_INPUT_CHARACTERS, MAX_INPUT_DEPTH, MAX_INPUT_VALUES, checkInputBudget, isInputRefusal, } from './input_budget.js';
+export { type CompositionJsonSchemaOptions, buildCompositionJsonSchema, } from './json_schema.js';
+export { type IssueRoot, createNodeIssueFormatter } from './node_issues.js';
+export { type UrlSchemaOptions, ASSET_URL_MESSAGE, ASSET_URL_RULE, BLOCKED_HREF, NAVIGATION_HREF_MESSAGE, NAVIGATION_HREF_RULE, assetUrl, navigationHref, sanitizeAssetUrl, sanitizeNavigationHref, sanitizeParsedAssetUrl, sanitizeParsedNavigationHref, } from './url.js';
+export { type CheckedComposition, type CheckedValidationResult, type CompositionValidatorOptions, type ParsedComposition, type ValidationErrorMode, type ValidationResult, type ValidationWarning, compositionToRender, CompositionValidationError, createCompositionParser, createCompositionValidator, warningsForSurface, } from './validation.js';
+export { displayValueSchema, namedColorSchema, renderThemeSchema, structuredValueSchema, } from './value_schemas.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,wBAAwB,EAC7B,kCAAkC,EAClC,sBAAsB,EACtB,qCAAqC,EACrC,kCAAkC,EAClC,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,4BAA4B,EACjC,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,SAAS,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,OAAO,CAAC;AACf,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/validate/index.js

@@ -0,0 +1,15 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+export { authoringBodySchema, authoringSchemaSubset, buildAuthoringJsonSchema, } from './authoring_schema.js';
+export { buildBodyNodeSchemaFromDefinitions, buildCompositionSchema, buildCompositionSchemaFromDefinitions, getCompositionSchemaForDefinitions, metaSchema, } from './composition_schema.js';
+export { MAX_INPUT_CHARACTERS, MAX_INPUT_DEPTH, MAX_INPUT_VALUES, checkInputBudget, isInputRefusal, } from './input_budget.js';
+export { buildCompositionJsonSchema, } from './json_schema.js';
+export { createNodeIssueFormatter } from './node_issues.js';
+export { ASSET_URL_MESSAGE, ASSET_URL_RULE, BLOCKED_HREF, NAVIGATION_HREF_MESSAGE, NAVIGATION_HREF_RULE, assetUrl, navigationHref, sanitizeAssetUrl, sanitizeNavigationHref, sanitizeParsedAssetUrl, sanitizeParsedNavigationHref, } from './url.js';
+export { compositionToRender, CompositionValidationError, createCompositionParser, createCompositionValidator, warningsForSurface, } from './validation.js';
+export { displayValueSchema, namedColorSchema, renderThemeSchema, structuredValueSchema, } from './value_schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/validate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,kCAAkC,EAClC,sBAAsB,EACtB,qCAAqC,EACrC,kCAAkC,EAClC,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAkB,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAEL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,OAAO,CAAC;AACf,OAAO,EAQL,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport {\n  type AuthoringJsonSchemaOptions,\n  authoringBodySchema,\n  authoringSchemaSubset,\n  buildAuthoringJsonSchema,\n} from './authoring_schema';\nexport {\n  type CompositionSchemaOptions,\n  buildBodyNodeSchemaFromDefinitions,\n  buildCompositionSchema,\n  buildCompositionSchemaFromDefinitions,\n  getCompositionSchemaForDefinitions,\n  metaSchema,\n} from './composition_schema';\nexport {\n  type InputBudget,\n  type InputBudgetCheck,\n  MAX_INPUT_CHARACTERS,\n  MAX_INPUT_DEPTH,\n  MAX_INPUT_VALUES,\n  checkInputBudget,\n  isInputRefusal,\n} from './input_budget';\nexport {\n  type CompositionJsonSchemaOptions,\n  buildCompositionJsonSchema,\n} from './json_schema';\nexport { type IssueRoot, createNodeIssueFormatter } from './node_issues';\nexport {\n  type UrlSchemaOptions,\n  ASSET_URL_MESSAGE,\n  ASSET_URL_RULE,\n  BLOCKED_HREF,\n  NAVIGATION_HREF_MESSAGE,\n  NAVIGATION_HREF_RULE,\n  assetUrl,\n  navigationHref,\n  sanitizeAssetUrl,\n  sanitizeNavigationHref,\n  sanitizeParsedAssetUrl,\n  sanitizeParsedNavigationHref,\n} from './url';\nexport {\n  type CheckedComposition,\n  type CheckedValidationResult,\n  type CompositionValidatorOptions,\n  type ParsedComposition,\n  type ValidationErrorMode,\n  type ValidationResult,\n  type ValidationWarning,\n  compositionToRender,\n  CompositionValidationError,\n  createCompositionParser,\n  createCompositionValidator,\n  warningsForSurface,\n} from './validation';\nexport {\n  displayValueSchema,\n  namedColorSchema,\n  renderThemeSchema,\n  structuredValueSchema,\n} from './value_schemas';\n"]}