@json-to-office/shared 1.0.0 → 1.2.0

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

@@ -124,30 +124,35 @@ function fixSchemaReferences(schema, rootDefinitionName = "ComponentDefinition")
       schema.definitions ?? {}
     )
   );
-  const definitionRef = (name) => `#/definitions/${definitionNames.has(name) ? name : rootDefinitionName}`;
+  const definitionRef = (name) => {
+    const target = definitionNames.has(name) ? name : rootDefinitionName;
+    return definitionNames.has(target) ? `#/definitions/${target}` : void 0;
+  };
+  const isBareDefinitionRef = (value) => typeof value === "string" && (/^T\d+$/.test(value) || value === rootDefinitionName || definitionNames.has(value));
   function traverse(obj, path = "") {
     if (typeof obj !== "object" || obj === null) return;
     for (const [key, value] of Object.entries(obj)) {
       const currentPath = path ? `${path}.${key}` : key;
       if (value && typeof value === "object") {
         const schemaValue = value;
-        if (schemaValue.type === "array" && schemaValue.items && Object.keys(schemaValue.items).length === 0) {
+        if (schemaValue.type === "array" && schemaValue.items && Object.keys(schemaValue.items).length === 0 && definitionNames.has(rootDefinitionName)) {
           schemaValue.items = {
             $ref: `#/definitions/${rootDefinitionName}`
           };
         }
-        if (schemaValue.type === "array" && schemaValue.items && typeof schemaValue.items === "object" && "$ref" in schemaValue.items && typeof schemaValue.items.$ref === "string" && /^T\d+$/.test(
+        if (schemaValue.type === "array" && schemaValue.items && typeof schemaValue.items === "object" && "$ref" in schemaValue.items && isBareDefinitionRef(
           schemaValue.items.$ref
         )) {
           const name = schemaValue.items.$ref;
-          schemaValue.items = {
-            $ref: definitionRef(name)
-          };
+          const ref = definitionRef(name);
+          schemaValue.items = ref ? { $ref: ref } : {};
         }
-        if (typeof schemaValue.$ref === "string" && (/^T\d+$/.test(schemaValue.$ref) || schemaValue.$ref === rootDefinitionName)) {
-          schemaValue.$ref = definitionRef(schemaValue.$ref);
+        if (isBareDefinitionRef(schemaValue.$ref)) {
+          const ref = definitionRef(schemaValue.$ref);
+          if (ref) schemaValue.$ref = ref;
+          else delete schemaValue.$ref;
         }
-        if (key === "$id" && typeof value === "string" && (/^T\d+$/.test(value) || value === rootDefinitionName) && currentPath !== `definitions.${rootDefinitionName}.$id`) {
+        if (key === "$id" && isBareDefinitionRef(value) && currentPath !== `definitions.${value}.$id`) {
           delete obj[key];
           continue;
         }
@@ -159,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,
@@ -212,9 +217,9 @@ function convertToJsonSchema(schema, options = {}) {
   restructureNameDiscriminatedUnions(jsonSchema);
   return jsonSchema;
 }
-function createComponentSchema(name, config, containerNames, componentDefinitionSchema) {
+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,
@@ -238,18 +243,18 @@ function createComponentSchema(name, config, containerNames, componentDefinition
       type: "array",
       description: "Children within this container",
       items: {
-        $ref: "#/definitions/ComponentDefinition"
+        $ref: `#/definitions/${rootDefinitionName}`
       }
     };
     if (componentDefinitionSchema) {
       componentStructure.definitions = {
-        ComponentDefinition: JSON.parse(
+        [rootDefinitionName]: JSON.parse(
           JSON.stringify(componentDefinitionSchema)
         )
       };
     }
   }
-  fixSchemaReferences(componentStructure);
+  fixSchemaReferences(componentStructure, rootDefinitionName);
   componentStructure.additionalProperties = false;
   return componentStructure;
 }
@@ -289,4 +294,4 @@ export {
   exportSchemaToFile,
   createComponentSchemaObject
 };
-//# sourceMappingURL=chunk-SJ2YYRCT.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":[]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { C as ComponentDefinition, a as ComponentSchemaConfig, c as convertToJsonSchema, b as createComponentSchema, d as createComponentSchemaObject, e as exportSchemaToFile, f as fixSchemaReferences } from './schema-utils-CbCi6dEk.js';
+export { C as ComponentDefinition, a as ComponentSchemaConfig, c as convertToJsonSchema, b as createComponentSchema, d as createComponentSchemaObject, e as exportSchemaToFile, f as fixSchemaReferences } from './schema-utils-C5Qdzsgy.js';
 export { AddWarningFunction, GenerationWarning } from './types/warnings.js';
 import { F as FontRegistryEntry, c as FontRuntimeOpts, R as ResolvedFontSource, b as ResolvedFont } from './types-kcQwhOlf.js';
 export { D as DEFAULT_VISUAL_DPI, d as FontFamilyNameSchema, e as FontRegistryDefinition, f as FontRegistryEntrySchema, g as FontRegistrySchema, h as FontSource, i as FontSourceSchema, H as HighchartsHeaders, j as HighchartsHeadersResolver, k as HighchartsServiceConfig, M as MAX_RASTERIZE_BATCH_SLIDES, l as MAX_RASTERIZE_FONTS, m as MAX_RASTERIZE_FONT_BYTES, n as MAX_VISUAL_DPI, o as MIN_VISUAL_DPI, P as PptxBatchRasterizer, p as PptxRasterizeBatchRequest, q as PptxRasterizeBatchResult, r as PptxRasterizeBatchSlide, s as PptxRasterizeBatchSlideResult, t as PptxRasterizeFailureStage, u as PptxRasterizeRequest, v as PptxRasterizeResult, w as PptxRasterizer, x as PptxServiceConfig, y as PptxServiceHeaders, z as PptxServiceHeadersResolver, a as RasterizeFontFace, S as SAFE_FONTS, A as SafeFontName, B as ServicesConfig, C as clampVisualDpi, E as isSafeFont } from './types-kcQwhOlf.js';

package/dist/index.js

@@ -53,7 +53,7 @@ import {
   fixSchemaReferences,
   restructureNameDiscriminatedUnions,
   unionBranches
-} from "./chunk-SJ2YYRCT.js";
+} from "./chunk-6TNT7DGC.js";
 import {
   FontFamilyNameSchema,
   FontRegistryEntrySchema,

package/dist/{schema-utils-CbCi6dEk.d.ts → schema-utils-C5Qdzsgy.d.ts}

@@ -22,6 +22,15 @@ interface ComponentSchemaConfig {
     requiresName?: boolean;
     enhanceForRichContent?: boolean;
 }
+/**
+ * Resolve the bare `$ref` values TypeBox leaves behind into JSON Pointers.
+ *
+ * `rootDefinitionName` is only the fallback for a reference that names nothing
+ * hoisted. A schema may carry several recursive definitions — the DOCX
+ * document schema carries one per renderer — so a bare reference that matches
+ * an actual definition resolves to *that* one, which is what keeps the two
+ * renderer views from collapsing into whichever was walked last.
+ */
 declare function fixSchemaReferences(schema: Record<string, unknown>, rootDefinitionName?: string): void;
 declare function convertToJsonSchema(schema: TSchema, options?: {
     $schema?: string;
@@ -30,7 +39,7 @@ declare function convertToJsonSchema(schema: TSchema, options?: {
     description?: string;
     definitions?: Record<string, unknown>;
 }): Record<string, unknown>;
-declare function createComponentSchema(name: string, config: ComponentSchemaConfig, containerNames: string[], componentDefinitionSchema?: TSchema): Record<string, unknown>;
+declare function createComponentSchema(name: string, config: ComponentSchemaConfig, containerNames: string[], componentDefinitionSchema?: TSchema, rootDefinitionName?: string): Record<string, unknown>;
 declare function exportSchemaToFile(schema: Record<string, unknown>, outputPath: string, options?: {
     prettyPrint?: boolean;
 }): Promise<void>;

package/dist/schemas/schema-utils.d.ts

@@ -1,2 +1,2 @@
 import '@sinclair/typebox';
-export { a as ComponentSchemaConfig, c as convertToJsonSchema, b as createComponentSchema, d as createComponentSchemaObject, e as exportSchemaToFile, f as fixSchemaReferences } from '../schema-utils-CbCi6dEk.js';
+export { a as ComponentSchemaConfig, c as convertToJsonSchema, b as createComponentSchema, d as createComponentSchemaObject, e as exportSchemaToFile, f as fixSchemaReferences } from '../schema-utils-C5Qdzsgy.js';

package/dist/schemas/schema-utils.js

@@ -4,7 +4,7 @@ import {
   createComponentSchemaObject,
   exportSchemaToFile,
   fixSchemaReferences
-} from "../chunk-SJ2YYRCT.js";
+} from "../chunk-6TNT7DGC.js";
 export {
   convertToJsonSchema,
   createComponentSchema,