@json-to-office/shared 1.1.0 → 1.3.0

package/dist/capabilities-DrHJ6_4G.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Format-independent renderer contracts.
+ *
+ * This module deliberately knows nothing about DOCX or PPTX semantics. Each
+ * format owns its own intermediate representation (`DocxIR`, `PptxIR`) and its
+ * own feature union; the only thing shared between them is the shape of the
+ * contract a backend adapter must satisfy.
+ *
+ * Do not add format-specific feature names, IR nodes or units here.
+ */
+/** The Office formats this repository can produce. */
+type OfficeFormat = 'docx' | 'pptx';
+/**
+ * Options every renderer accepts.
+ *
+ * `deterministic` asks the adapter (and the packaging step after it) to make
+ * output byte-stable across runs: fixed zip entry timestamps, fixed core
+ * metadata timestamps, no random identifiers.
+ *
+ * `generatedAt` pins the timestamp written into package metadata. Callers that
+ * want reproducible bytes pass both.
+ */
+interface RenderOptions {
+    deterministic?: boolean;
+    generatedAt?: Date;
+}
+/**
+ * A backend that turns a format-specific IR into package bytes.
+ *
+ * @typeParam TIR - the format's intermediate representation (plain data)
+ * @typeParam TFeature - the format's feature union (see `capabilities.ts`)
+ * @typeParam TId - the string-literal union of renderer ids for the format
+ */
+interface OfficeRenderer<TIR, TFeature extends string, TId extends string> {
+    readonly id: TId;
+    readonly format: OfficeFormat;
+    readonly capabilities: ReadonlySet<TFeature>;
+    render(document: TIR, options?: RenderOptions): Promise<Uint8Array>;
+}
+/**
+ * Exhaustiveness guard for discriminated-union switches.
+ *
+ * Reaching this at runtime means an IR node kind was added without a matching
+ * `case`, so it throws rather than silently dropping content.
+ */
+declare function assertNever(value: never, context?: string): never;
+
+/**
+ * Diagnostics raised when an IR asks a renderer for something it cannot do.
+ *
+ * These are distinct from `GenerationWarning` (see `../types/warnings`), which
+ * describes authoring problems found while building the document. A renderer
+ * diagnostic describes a *backend* limitation: the document is fine, this
+ * particular adapter just cannot express part of it.
+ */
+type RendererDiagnosticSeverity = 'error' | 'warning';
+/**
+ * One unsupported (or degraded) feature at one place in the IR.
+ *
+ * `path` is an IR path such as `slides[2].elements[0].fill` — not an author-JSON
+ * path — because the check runs against compiled IR. Compilers record the
+ * authoring path alongside where it is useful for the message text.
+ */
+interface RendererDiagnostic<TFeature extends string = string> {
+    feature: TFeature;
+    path: string;
+    severity: RendererDiagnosticSeverity;
+    message: string;
+}
+interface UnsupportedRendererFeatureErrorInit<TFeature extends string = string> {
+    format: OfficeFormat;
+    rendererId: string;
+    diagnostics: readonly RendererDiagnostic<TFeature>[];
+}
+/**
+ * Aggregated failure thrown *before* rendering starts.
+ *
+ * One error carries every unsupported feature found in the IR so a caller sees
+ * the whole gap at once instead of fixing them one render at a time.
+ */
+declare class UnsupportedRendererFeatureError<TFeature extends string = string> extends Error {
+    readonly code = "UNSUPPORTED_RENDERER_FEATURE";
+    readonly format: OfficeFormat;
+    readonly rendererId: string;
+    /** Distinct unsupported features, in first-seen order. */
+    readonly features: readonly TFeature[];
+    /** Distinct IR paths that required them, in first-seen order. */
+    readonly paths: readonly string[];
+    /** Every error-severity diagnostic that produced this failure. */
+    readonly diagnostics: readonly RendererDiagnostic<TFeature>[];
+    constructor(init: UnsupportedRendererFeatureErrorInit<TFeature>);
+}
+/**
+ * A renderer id that is not registered for the format asked for.
+ *
+ * Caller input, not an infrastructure failure — which is the whole reason it is
+ * a class with a `code` rather than a bare `Error`. A server matching on the
+ * message text could only answer `500`, so an unknown id looked like the
+ * service falling over, and a retry looked worth attempting (#263).
+ */
+declare class UnknownRendererError extends Error {
+    readonly code = "UNKNOWN_RENDERER";
+    readonly format: OfficeFormat;
+    /** What the caller asked for. */
+    readonly rendererId: string;
+    /** Every id registered for this format, in registration order. */
+    readonly availableIds: readonly string[];
+    constructor(format: OfficeFormat, rendererId: string, availableIds: readonly string[]);
+}
+/** Build a `RendererDiagnostic` with `severity: 'error'`. */
+declare function rendererError<TFeature extends string>(feature: TFeature, path: string, message: string): RendererDiagnostic<TFeature>;
+/** Build a `RendererDiagnostic` with `severity: 'warning'`. */
+declare function rendererWarning<TFeature extends string>(feature: TFeature, path: string, message: string): RendererDiagnostic<TFeature>;
+/** Split diagnostics into blocking errors and non-blocking warnings. */
+declare function partitionDiagnostics<TFeature extends string>(diagnostics: readonly RendererDiagnostic<TFeature>[]): {
+    errors: RendererDiagnostic<TFeature>[];
+    warnings: RendererDiagnostic<TFeature>[];
+};
+
+/**
+ * Capability checking: what an IR *requires* versus what an adapter *provides*.
+ *
+ * A compiler records one `FeatureRequirement` each time it emits an IR node that
+ * needs a backend capability. Before rendering, `assertRendererSupports` diffs
+ * those requirements against the adapter's `capabilities` set and throws a
+ * single aggregated `UnsupportedRendererFeatureError` if anything is missing.
+ *
+ * The point is that nothing is dropped silently: a feature either appears in the
+ * adapter's capability set and is rendered, or it fails loudly before bytes are
+ * produced.
+ */
+/** One capability an IR node needs, and where in the IR it was needed. */
+interface FeatureRequirement<TFeature extends string = string> {
+    feature: TFeature;
+    /** IR path, e.g. `sections[0].children[3].image`. */
+    path: string;
+    /** Optional detail folded into the failure message. */
+    detail?: string;
+}
+/**
+ * Accumulates feature requirements during compilation.
+ *
+ * Deliberately per-compilation (never module-global) so concurrent generations
+ * never share state.
+ */
+declare class FeatureRequirementCollector<TFeature extends string> {
+    private readonly requirements;
+    private readonly seen;
+    /**
+     * Record that `feature` is needed at `path`.
+     *
+     * Duplicate (feature, path) pairs collapse, so a compiler can call this
+     * unconditionally inside a loop without inflating the diagnostics.
+     */
+    require(feature: TFeature, path: string, detail?: string): void;
+    /** Every recorded requirement, in first-seen order. */
+    list(): readonly FeatureRequirement<TFeature>[];
+    /** Distinct required features, in first-seen order. */
+    features(): readonly TFeature[];
+    /** True when nothing has been required yet. */
+    isEmpty(): boolean;
+}
+/**
+ * Diff required features against a capability set.
+ *
+ * Returns one error-severity diagnostic per unsupported requirement. An empty
+ * array means the renderer can render the IR.
+ */
+declare function diagnoseUnsupportedFeatures<TFeature extends string>(required: readonly FeatureRequirement<TFeature>[], capabilities: ReadonlySet<TFeature>, rendererId: string): RendererDiagnostic<TFeature>[];
+/**
+ * Throw one aggregated error if the renderer is missing any required feature.
+ *
+ * Call this after compiling to IR and before handing the IR to an adapter.
+ */
+declare function assertRendererSupports<TFeature extends string>(required: readonly FeatureRequirement<TFeature>[], renderer: Pick<OfficeRenderer<unknown, TFeature, string>, 'id' | 'format' | 'capabilities'>): void;
+/**
+ * A registry of renderers for a single format.
+ *
+ * Instances are created per format module, not per generation, and hold only
+ * immutable adapter descriptors — never per-document state.
+ */
+declare class RendererRegistry<TIR, TFeature extends string, TId extends string> {
+    private readonly format;
+    private readonly defaultId;
+    private readonly renderers;
+    constructor(format: OfficeFormat, defaultId: TId);
+    /**
+     * Register a lazily-constructed renderer.
+     *
+     * The factory is async and only invoked on selection, so an adapter whose
+     * backend is an optional dependency is never imported unless it is chosen.
+     */
+    register(id: TId, factory: () => Promise<OfficeRenderer<TIR, TFeature, TId>>): void;
+    /** Renderer ids registered for this format, in registration order. */
+    ids(): readonly TId[];
+    /** The id used when a caller does not pass one. */
+    getDefaultId(): TId;
+    has(id: string): id is TId;
+    /**
+     * Resolve a renderer, defaulting when `id` is omitted.
+     *
+     * An unknown id is `UnknownRendererError`, which carries the id asked for and
+     * the ones that exist, so a caller boundary can answer "bad request" rather
+     * than "the server broke". A missing optional dependency is re-thrown with an
+     * actionable install hint.
+     */
+    resolve(id?: TId): Promise<OfficeRenderer<TIR, TFeature, TId>>;
+}
+
+export { type FeatureRequirement as F, type OfficeFormat as O, type RenderOptions as R, UnknownRendererError as U, FeatureRequirementCollector as a, type OfficeRenderer as b, type RendererDiagnostic as c, type RendererDiagnosticSeverity as d, RendererRegistry as e, UnsupportedRendererFeatureError as f, type UnsupportedRendererFeatureErrorInit as g, assertNever as h, assertRendererSupports as i, diagnoseUnsupportedFeatures as j, rendererWarning as k, partitionDiagnostics as p, rendererError as r };

package/dist/{chunk-BS2BBPVA.js → chunk-6TNT7DGC.js}

@@ -164,7 +164,7 @@ function fixSchemaReferences(schema, rootDefinitionName = "ComponentDefinition")
 }
 function convertToJsonSchema(schema, options = {}) {
   const {
-    $schema = "https://json-schema.org/draft-07/schema#",
+    $schema = "http://json-schema.org/draft-07/schema#",
     $id,
     title,
     description,
@@ -219,7 +219,7 @@ function convertToJsonSchema(schema, options = {}) {
 }
 function createComponentSchema(name, config, containerNames, componentDefinitionSchema, rootDefinitionName = "ComponentDefinition") {
   const componentStructure = {
-    $schema: "https://json-schema.org/draft-07/schema#",
+    $schema: "http://json-schema.org/draft-07/schema#",
     $id: `${name}.schema.json`,
     title: config.title,
     description: config.description,
@@ -294,4 +294,4 @@ export {
   exportSchemaToFile,
   createComponentSchemaObject
 };
-//# sourceMappingURL=chunk-BS2BBPVA.js.map
+//# sourceMappingURL=chunk-6TNT7DGC.js.map

package/dist/chunk-6TNT7DGC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/schema-utils.ts","../src/schemas/discriminated-unions.ts"],"sourcesContent":["import { Type, TSchema } from '@sinclair/typebox';\nimport { restructureNameDiscriminatedUnions } from './discriminated-unions';\nimport type { ComponentDefinition } from '../types/components';\n\nexport interface ComponentSchemaConfig {\n  schema: TSchema;\n  title: string;\n  description: string;\n  requiresName?: boolean;\n  enhanceForRichContent?: boolean;\n}\n\nfunction replaceRefs(\n  obj: Record<string, unknown>,\n  target: string,\n  replacement: string\n): void {\n  if (typeof obj !== 'object' || obj === null) return;\n  if (Array.isArray(obj)) {\n    obj.forEach((item) => {\n      if (typeof item === 'object' && item !== null) {\n        replaceRefs(item as Record<string, unknown>, target, replacement);\n      }\n    });\n    return;\n  }\n  if (obj.$ref === target) {\n    obj.$ref = replacement;\n  }\n  for (const value of Object.values(obj)) {\n    if (typeof value === 'object' && value !== null) {\n      replaceRefs(value as Record<string, unknown>, target, replacement);\n    }\n  }\n}\n\n/**\n * Resolve the bare `$ref` values TypeBox leaves behind into JSON Pointers.\n *\n * `rootDefinitionName` is only the fallback for a reference that names nothing\n * hoisted. A schema may carry several recursive definitions — the DOCX\n * document schema carries one per renderer — so a bare reference that matches\n * an actual definition resolves to *that* one, which is what keeps the two\n * renderer views from collapsing into whichever was walked last.\n */\nexport function fixSchemaReferences(\n  schema: Record<string, unknown>,\n  rootDefinitionName = 'ComponentDefinition'\n): void {\n  const definitionNames = new Set(\n    Object.keys(\n      (schema.definitions as Record<string, unknown> | undefined) ?? {}\n    )\n  );\n  // Undefined when nothing by either name was hoisted. Substituting the root\n  // name regardless is how a reference to a definition that does not exist got\n  // written, and Ajv refuses to compile a schema containing one — so an\n  // unresolved reference is dropped rather than invented.\n  const definitionRef = (name: string): string | undefined => {\n    const target = definitionNames.has(name) ? name : rootDefinitionName;\n    return definitionNames.has(target) ? `#/definitions/${target}` : undefined;\n  };\n  const isBareDefinitionRef = (value: unknown): value is string =>\n    typeof value === 'string' &&\n    (/^T\\d+$/.test(value) ||\n      value === rootDefinitionName ||\n      definitionNames.has(value));\n\n  function traverse(obj: Record<string, unknown>, path = ''): void {\n    if (typeof obj !== 'object' || obj === null) return;\n\n    for (const [key, value] of Object.entries(obj)) {\n      const currentPath = path ? `${path}.${key}` : key;\n\n      if (value && typeof value === 'object') {\n        const schemaValue = value as Record<string, unknown>;\n\n        // Only when there is something to point at. A schema that holds\n        // components without embedding their definition (the theme schema\n        // holds `componentDefaults` but cannot carry a renderer's component\n        // union) keeps its untyped item: a `$ref` to a definition that was\n        // never hoisted is unresolvable, and Ajv refuses to compile the whole\n        // schema over it.\n        if (\n          schemaValue.type === 'array' &&\n          schemaValue.items &&\n          Object.keys(schemaValue.items).length === 0 &&\n          definitionNames.has(rootDefinitionName)\n        ) {\n          schemaValue.items = {\n            $ref: `#/definitions/${rootDefinitionName}`,\n          };\n        }\n\n        if (\n          schemaValue.type === 'array' &&\n          schemaValue.items &&\n          typeof schemaValue.items === 'object' &&\n          '$ref' in schemaValue.items &&\n          isBareDefinitionRef(\n            (schemaValue.items as Record<string, unknown>).$ref\n          )\n        ) {\n          const name = (schemaValue.items as Record<string, unknown>)\n            .$ref as string;\n          const ref = definitionRef(name);\n          // Untyped rather than dangling when the target was never hoisted.\n          schemaValue.items = ref ? { $ref: ref } : {};\n        }\n\n        if (isBareDefinitionRef(schemaValue.$ref)) {\n          const ref = definitionRef(schemaValue.$ref as string);\n          if (ref) schemaValue.$ref = ref;\n          else delete schemaValue.$ref;\n        }\n\n        if (\n          key === '$id' &&\n          isBareDefinitionRef(value) &&\n          currentPath !== `definitions.${value}.$id`\n        ) {\n          delete obj[key];\n          continue;\n        }\n\n        traverse(value as Record<string, unknown>, currentPath);\n      }\n    }\n  }\n\n  traverse(schema);\n}\n\nexport function convertToJsonSchema(\n  schema: TSchema,\n  options: {\n    $schema?: string;\n    $id?: string;\n    title?: string;\n    description?: string;\n    definitions?: Record<string, unknown>;\n  } = {}\n): Record<string, unknown> {\n  const {\n    $schema = 'http://json-schema.org/draft-07/schema#',\n    $id,\n    title,\n    description,\n    definitions = {},\n  } = options;\n\n  const schemaJson = JSON.parse(JSON.stringify(schema));\n\n  if (\n    schemaJson.$id &&\n    typeof schemaJson.$id === 'string' &&\n    /^T\\d+$/.test(schemaJson.$id)\n  ) {\n    const recursiveId = schemaJson.$id;\n    delete schemaJson.$id;\n    replaceRefs(schemaJson, recursiveId, '#');\n  }\n\n  const extractedDefinitions: Record<string, unknown> = { ...definitions };\n\n  function extractRecursiveSchemas(\n    obj: Record<string, unknown>,\n    path = ''\n  ): void {\n    if (typeof obj !== 'object' || obj === null) return;\n\n    for (const [key, value] of Object.entries(obj)) {\n      if (value && typeof value === 'object') {\n        const schemaValue = value as Record<string, unknown>;\n\n        if (schemaValue.$id && typeof schemaValue.$id === 'string') {\n          const definitionName = schemaValue.$id;\n\n          if (path !== `definitions.${definitionName}`) {\n            const { $id: _id, ...schemaWithoutId } = schemaValue; // eslint-disable-line @typescript-eslint/no-unused-vars\n            extractedDefinitions[definitionName] = schemaWithoutId;\n            obj[key] = { $ref: `#/definitions/${definitionName}` };\n            extractRecursiveSchemas(\n              schemaWithoutId,\n              `definitions.${definitionName}`\n            );\n            continue;\n          }\n        }\n\n        extractRecursiveSchemas(\n          value as Record<string, unknown>,\n          path ? `${path}.${key}` : key\n        );\n      }\n    }\n  }\n\n  extractRecursiveSchemas(schemaJson);\n\n  const jsonSchema: Record<string, unknown> = { $schema };\n\n  if ($id) jsonSchema.$id = $id;\n\n  Object.assign(jsonSchema, schemaJson);\n\n  jsonSchema.$schema = $schema;\n  if ($id) jsonSchema.$id = $id;\n  if (title !== undefined) jsonSchema.title = title;\n  if (description !== undefined) jsonSchema.description = description;\n\n  if (Object.keys(extractedDefinitions).length > 0) {\n    jsonSchema.definitions = extractedDefinitions;\n  }\n\n  fixSchemaReferences(jsonSchema);\n  restructureNameDiscriminatedUnions(jsonSchema);\n\n  return jsonSchema;\n}\n\nexport function createComponentSchema(\n  name: string,\n  config: ComponentSchemaConfig,\n  containerNames: string[],\n  componentDefinitionSchema?: TSchema,\n  // The definition the recursive children reference. Callers whose component\n  // union is renderer-specific pass that renderer's name so the embedded\n  // definition and the `$ref` pointing at it agree.\n  rootDefinitionName = 'ComponentDefinition'\n): Record<string, unknown> {\n  const componentStructure: Record<string, unknown> = {\n    $schema: 'http://json-schema.org/draft-07/schema#',\n    $id: `${name}.schema.json`,\n    title: config.title,\n    description: config.description,\n    type: 'object',\n    required: ['name', 'props'],\n    properties: {\n      name: {\n        type: 'string',\n        const: name,\n        description: `Component name identifier (must be \"${name}\")`,\n      },\n      id: {\n        type: 'string',\n        description: 'Optional unique identifier for the component',\n      },\n      props: JSON.parse(JSON.stringify(config.schema)),\n    },\n  };\n\n  if (containerNames.includes(name)) {\n    (componentStructure.properties as Record<string, unknown>).children = {\n      type: 'array',\n      description: 'Children within this container',\n      items: {\n        $ref: `#/definitions/${rootDefinitionName}`,\n      },\n    };\n\n    if (componentDefinitionSchema) {\n      componentStructure.definitions = {\n        [rootDefinitionName]: JSON.parse(\n          JSON.stringify(componentDefinitionSchema)\n        ),\n      };\n    }\n  }\n\n  fixSchemaReferences(componentStructure, rootDefinitionName);\n  componentStructure.additionalProperties = false;\n\n  return componentStructure;\n}\n\nexport async function exportSchemaToFile(\n  schema: Record<string, unknown>,\n  outputPath: string,\n  options: { prettyPrint?: boolean } = {}\n): Promise<void> {\n  const { prettyPrint = true } = options;\n  const jsonSchema = prettyPrint\n    ? JSON.stringify(schema, null, 2)\n    : JSON.stringify(schema);\n  const fs = await import('fs/promises');\n  await fs.writeFile(outputPath, jsonSchema, 'utf-8');\n}\n\n/**\n * Create a TypeBox schema object for any component definition.\n * Works for both docx and pptx components.\n */\nexport function createComponentSchemaObject(\n  component: ComponentDefinition,\n  recursiveRef?: TSchema\n): TSchema {\n  const schema: Record<string, TSchema> = {\n    name: Type.Literal(component.name),\n    id: Type.Optional(Type.String()),\n    enabled: Type.Optional(\n      Type.Boolean({\n        default: true,\n        description:\n          'When false, this component is filtered out and not rendered. Defaults to true.',\n      })\n    ),\n  };\n\n  if (component.special?.hasSchemaField) {\n    schema.$schema = Type.Optional(Type.String({ format: 'uri' }));\n  }\n\n  schema.props = component.propsSchema;\n\n  if (component.hasChildren && recursiveRef) {\n    schema.children = Type.Optional(Type.Array(recursiveRef));\n  }\n\n  return Type.Object(schema, { additionalProperties: false });\n}\n","/**\n * Canonical `if/then` restructuring for name-discriminated component unions.\n *\n * The generators export component unions as a flat `anyOf`. Schema-driven\n * editors (Monaco, VS Code — vscode-json-languageservice) resolve a partially\n * typed node against an `anyOf` by picking the single best-matching branch:\n * while typing `{ \"name\": | }`, every branch requiring `props` fails\n * validation, so its name const never reached autocomplete, and diagnostics\n * reported one arbitrary branch's complaints (\"Value must be \\\"heading\\\"\",\n * \"Missing property \\\"props\\\"\") instead of the real problem.\n *\n * This transform rewrites each such union — at JSON-Schema export time only,\n * the runtime TypeBox validators are untouched — into the standard\n * discriminated-union dispatch:\n *\n *   {\n *     type: \"object\",\n *     required: [\"name\"],\n *     properties: { name: { anyOf: [{ const, description }, …] } },\n *     allOf: [\n *       { if: { properties: { name: { const } }, required: [\"name\"] },\n *         then: <branch> },\n *       …\n *     ]\n *   }\n *\n * The accepted set of documents is exactly the same — `properties.name` is\n * the enum the branches already imply, and each `then` is the original\n * branch — but editors now behave deterministically:\n * - completing `name` offers every component, with its description\n * - an empty object reports only `Missing property \"name\"`\n * - a wrong name reports only `Value is not accepted. Valid values: …`\n * - a valid name activates exactly its branch for keys, props and errors\n *\n * Standard draft-07 keywords only, so ajv and every schema-aware editor\n * agree. Versioned plugin branches share a name; they stay grouped in a\n * small `anyOf` inside their `then`, containing best-match ambiguity to the\n * component's own versions.\n */\n\ninterface SchemaNode {\n  [key: string]: unknown;\n}\n\ninterface NameConstEntry {\n  const: string;\n  type: 'string';\n  description?: string;\n}\n\n/** A union branch shaped `{ properties: { name: { const: \"...\" } } }`. */\nfunction branchNameConst(branch: unknown): string | undefined {\n  if (typeof branch !== 'object' || branch === null || Array.isArray(branch))\n    return undefined;\n  const name = ((branch as SchemaNode).properties as SchemaNode | undefined)\n    ?.name as SchemaNode | undefined;\n  return typeof name?.const === 'string' ? name.const : undefined;\n}\n\n/** True when the branch also discriminates on a `version` const (plugins). */\nfunction isVersionedBranch(branch: SchemaNode): boolean {\n  const version = (branch.properties as SchemaNode | undefined)?.version as\n    | SchemaNode\n    | undefined;\n  return typeof version?.const === 'string';\n}\n\nfunction branchRequiresName(branch: SchemaNode): boolean {\n  return Array.isArray(branch.required) && branch.required.includes('name');\n}\n\n/** Group branches by their name const, preserving union order. */\nfunction groupByName(branches: SchemaNode[]): Map<string, SchemaNode[]> {\n  const groups = new Map<string, SchemaNode[]>();\n  for (const branch of branches) {\n    const name = branchNameConst(branch)!;\n    const group = groups.get(name);\n    if (group) group.push(branch);\n    else groups.set(name, [branch]);\n  }\n  return groups;\n}\n\nfunction nameEntry(name: string, group: SchemaNode[]): NameConstEntry {\n  // Versioned plugins repeat the same name across version branches; the\n  // un-versioned fallback carries the cleanest component description.\n  const source =\n    group.find(\n      (b) => !isVersionedBranch(b) && typeof b.description === 'string'\n    ) ?? group.find((b) => typeof b.description === 'string');\n  return {\n    const: name,\n    type: 'string',\n    ...(source ? { description: source.description as string } : {}),\n  };\n}\n\n/**\n * Walk a JSON Schema and restructure every `anyOf` union whose branches are\n * all name-discriminated objects into the `if/then` dispatch shape above.\n *\n * Mutates in place. Conservative by design — a union is only restructured\n * when the rewrite is provably equivalent:\n * - every branch is an object with a `name` const that lists `name` as\n *   required (unions containing `$ref` or free-form branches are left alone;\n *   a `$ref`'s target union is restructured where it is defined)\n * - the node declares no `properties`, `allOf`, `if`, `required`,\n *   `additionalProperties` or `type` of its own that the rewrite would have\n *   to merge with\n * - at least two distinct names; single-name unions (a versioned plugin's\n *   variants) validate and complete fine as a plain anyOf\n */\nexport function restructureNameDiscriminatedUnions(schema: unknown): void {\n  const visited = new WeakSet<object>();\n\n  function walk(node: unknown): void {\n    if (typeof node !== 'object' || node === null) return;\n    if (visited.has(node)) return;\n    visited.add(node);\n\n    if (Array.isArray(node)) {\n      node.forEach(walk);\n      return;\n    }\n\n    const obj = node as SchemaNode;\n    const anyOf = obj.anyOf;\n    const isCandidate =\n      Array.isArray(anyOf) &&\n      anyOf.length >= 2 &&\n      anyOf.every(\n        (b) => branchNameConst(b) !== undefined && branchRequiresName(b)\n      ) &&\n      obj.properties === undefined &&\n      obj.allOf === undefined &&\n      obj.if === undefined &&\n      obj.required === undefined &&\n      // A sibling `additionalProperties` evaluates against the node's own\n      // (absent) `properties`; declaring `name` here would change what it\n      // rejects, so such unions are left alone.\n      obj.additionalProperties === undefined &&\n      (obj.type === undefined || obj.type === 'object');\n    // Dispatch needs at least two distinct names. Same-name groups (a\n    // versioned plugin's variants) stay a plain anyOf — restructuring them\n    // would recurse forever on the group it just created.\n    const groups = isCandidate ? groupByName(anyOf as SchemaNode[]) : undefined;\n    if (groups && groups.size >= 2) {\n      obj.type = 'object';\n      obj.required = ['name'];\n      obj.properties = {\n        name: {\n          anyOf: [...groups.entries()].map(([name, group]) =>\n            nameEntry(name, group)\n          ),\n        },\n      };\n      obj.allOf = [...groups.entries()].map(([name, group]) => ({\n        if: {\n          properties: { name: { const: name } },\n          required: ['name'],\n        },\n        then: group.length === 1 ? group[0] : { anyOf: group },\n      }));\n      delete obj.anyOf;\n    }\n\n    for (const value of Object.values(obj)) walk(value);\n  }\n\n  walk(schema);\n}\n\n/**\n * Iterate the component branches of an exported union, whichever shape it is\n * in — the flat `anyOf` the generators emit, or the `if/then` dispatch this\n * module rewrites it into. For consumers that post-process branch objects\n * (description enhancement, theme-name injection, …).\n */\nexport function unionBranches(schema: unknown): SchemaNode[] {\n  if (typeof schema !== 'object' || schema === null) return [];\n  const obj = schema as SchemaNode;\n  if (Array.isArray(obj.anyOf)) {\n    return obj.anyOf.filter(\n      (b): b is SchemaNode => typeof b === 'object' && b !== null\n    );\n  }\n  if (Array.isArray(obj.allOf)) {\n    return obj.allOf.flatMap((entry): SchemaNode[] => {\n      const then = (entry as SchemaNode | null)?.then;\n      if (typeof then !== 'object' || then === null) return [];\n      const inner = (then as SchemaNode).anyOf;\n      return Array.isArray(inner)\n        ? inner.filter(\n            (b): b is SchemaNode => typeof b === 'object' && b !== null\n          )\n        : [then as SchemaNode];\n    });\n  }\n  return [];\n}\n"],"mappings":"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","names":[]}