@json-to-office/shared-docx 1.6.0 → 1.9.0

package/dist/{chunk-3DLMRNA7.js → chunk-S7CHEAUQ.js}

@@ -1,17 +1,18 @@
 import {
   ComponentDefinitionSchema,
   StandardComponentDefinitionSchema
-} from "./chunk-JGD54FUF.js";
+} from "./chunk-M2GYRM4P.js";
 import {
   CustomComponentDefinitionSchema
 } from "./chunk-7GGTZ4TA.js";
 import {
   ReportPropsSchema,
-  STANDARD_COMPONENTS_REGISTRY
-} from "./chunk-KMKQOMP7.js";
+  STANDARD_COMPONENTS_REGISTRY,
+  createComponentSchemaObject
+} from "./chunk-64CLASFN.js";
 import {
   collectDocxRendererErrors
-} from "./chunk-KGQAQE4S.js";
+} from "./chunk-JW5NOPVQ.js";
 
 // src/validation/unified/error-transformer.ts
 import {
@@ -289,11 +290,60 @@ var COMPONENT_SCHEMAS = Object.fromEntries([
   ...STANDARD_COMPONENTS_REGISTRY.map((c) => [c.name, c.propsSchema]),
   ["custom", CustomComponentDefinitionSchema]
 ]);
+var EMBEDDED_REGIONS = new Map(
+  STANDARD_COMPONENTS_REGISTRY.filter(
+    (c) => (c.embeddedComponents?.length ?? 0) > 0
+  ).map((c) => [c.name, c.embeddedComponents])
+);
 var ROOT_COMPONENT_NAMES = new Set(
   STANDARD_COMPONENTS_REGISTRY.filter(
     (c) => Boolean(c.special?.hasSchemaField)
   ).map((c) => c.name)
 );
+var ALLOWED_SIBLING_KEYS = new Map(
+  STANDARD_COMPONENTS_REGISTRY.map((c) => [
+    c.name,
+    /* @__PURE__ */ new Set([
+      "name",
+      "id",
+      "enabled",
+      "props",
+      ...c.hasChildren ? ["children"] : [],
+      ...c.special?.hasSchemaField ? ["$schema", "renderer"] : []
+    ])
+  ])
+);
+var SIBLING_KEY_TYPES = {
+  id: "string",
+  enabled: "boolean",
+  $schema: "string",
+  renderer: "string"
+};
+function collectSiblingKeyErrors(node, path, opts, errors) {
+  const allowed = typeof node.name === "string" ? ALLOWED_SIBLING_KEYS.get(node.name) : void 0;
+  if (!allowed) return;
+  for (const key of Object.keys(node)) {
+    if (!allowed.has(key)) {
+      if (opts.allowUnknownFields) continue;
+      errors.push({
+        path: `${path}/${key}`,
+        message: `Unknown key "${key}" on component "${node.name}". Allowed keys: ${[
+          ...allowed
+        ].join(", ")}.`,
+        code: "unknown_key"
+      });
+      continue;
+    }
+    const expected = SIBLING_KEY_TYPES[key];
+    if (expected && typeof node[key] !== expected) {
+      errors.push({
+        path: `${path}/${key}`,
+        message: `Key "${key}" on component "${node.name}" must be a ${expected}.`,
+        code: "invalid_type"
+      });
+    }
+  }
+}
 var IMAGE_SOURCE_FIELDS = ["path", "base64", "svg"];
 function presentImageSources(props) {
   if (!props || typeof props !== "object") return [];
@@ -461,6 +511,7 @@ function deepValidateDocument(data, opts = {}) {
       code: "invalid_value"
     });
   }
+  collectSiblingKeyErrors(data, "", opts, allErrors);
   if (ROOT_COMPONENT_NAMES.has(data.name) && "props" in data) {
     const propsErrors = validateComponentProps(
       data.name,
@@ -510,6 +561,7 @@ function walkComponentTree(node, path, opts, errors) {
       return;
     }
     if (opts.knownCustomNames?.has(child.name)) return;
+    collectSiblingKeyErrors(child, childPath, opts, errors);
     if ("props" in child) {
       errors.push(
         ...validateComponentProps(
@@ -526,32 +578,31 @@ function walkComponentTree(node, path, opts, errors) {
     }
     walkComponentTree(child, childPath, opts, errors);
   };
-  for (const region of ["header", "footer"]) {
-    const entries = node.props?.[region];
-    if (Array.isArray(entries)) {
-      entries.forEach(
-        (child, i) => validateEntry(child, `${path}/props/${region}/${i}`, true)
+  const regions = typeof node.name === "string" ? EMBEDDED_REGIONS.get(node.name) : void 0;
+  if (regions && node.props && typeof node.props === "object") {
+    for (const region of regions) {
+      resolveRegionValues(
+        node.props,
+        region.path,
+        `${path}/props`,
+        (value, valuePath) => {
+          if (region.arity === "component-array") {
+            if (Array.isArray(value)) {
+              value.forEach(
+                (child, i) => validateEntry(
+                  child,
+                  `${valuePath}/${i}`,
+                  region.reportStructure
+                )
+              );
+            }
+          } else if (value && typeof value === "object" && !Array.isArray(value)) {
+            validateEntry(value, valuePath, region.reportStructure);
+          }
+        }
       );
     }
   }
-  if (node.name === "table" && Array.isArray(node.props?.columns)) {
-    node.props.columns.forEach((col, c) => {
-      if (!col || typeof col !== "object") return;
-      const base = `${path}/props/columns/${c}`;
-      const headerContent = col.header?.content;
-      if (headerContent && typeof headerContent === "object") {
-        validateEntry(headerContent, `${base}/header/content`, false);
-      }
-      if (Array.isArray(col.cells)) {
-        col.cells.forEach((cell, r) => {
-          const content = cell?.content;
-          if (content && typeof content === "object") {
-            validateEntry(content, `${base}/cells/${r}/content`, false);
-          }
-        });
-      }
-    });
-  }
   if (Array.isArray(node.children)) {
     node.children.forEach(
       (child, i) => validateEntry(child, `${path}/children/${i}`, true)
@@ -564,6 +615,22 @@ function walkComponentTree(node, path, opts, errors) {
     });
   }
 }
+function resolveRegionValues(value, segments, path, visit) {
+  if (segments.length === 0) {
+    visit(value, path);
+    return;
+  }
+  if (!value || typeof value !== "object") return;
+  const [head, ...rest] = segments;
+  if (head === "*") {
+    if (!Array.isArray(value)) return;
+    value.forEach(
+      (item, i) => resolveRegionValues(item, rest, `${path}/${i}`, visit)
+    );
+    return;
+  }
+  resolveRegionValues(value[head], rest, `${path}/${head}`, visit);
+}
 function validateComponentProps(componentName, props, basePath, opts = {}) {
   const errors = [];
   const schema = COMPONENT_SCHEMAS[componentName];
@@ -825,6 +892,8 @@ function getValidationSummary(result) {
 }
 
 // src/validation/unified/document-validator.ts
+import { Type } from "@sinclair/typebox";
+import { Value as Value3 } from "@sinclair/typebox/value";
 import { extractStandardComponentNames } from "@json-to-office/shared";
 var JsonComponentDefinitionSchema = ComponentDefinitionSchema;
 var SEMANTIC_COLLECTORS = [
@@ -858,6 +927,61 @@ var SEMANTIC_COLLECTORS = [
 function collectSemanticConflicts(document) {
   return SEMANTIC_COLLECTORS.flatMap(({ collect }) => collect(document));
 }
+function referencesCustomComponent(node, names) {
+  if (Array.isArray(node)) {
+    return node.some((item) => referencesCustomComponent(item, names));
+  }
+  if (!node || typeof node !== "object") return false;
+  const record = node;
+  if (typeof record.name === "string" && names.has(record.name)) return true;
+  return Object.values(record).some(
+    (value) => referencesCustomComponent(value, names)
+  );
+}
+var containmentRelaxedSchema;
+function getContainmentRelaxedSchema() {
+  containmentRelaxedSchema ??= Type.Recursive(
+    (This) => Type.Union(
+      STANDARD_COMPONENTS_REGISTRY.map(
+        (component) => createComponentSchemaObject(component, This, This)
+      )
+    )
+  );
+  return containmentRelaxedSchema;
+}
+function resolveEmptyWalk(document, stageOneErrors, options) {
+  if (options?.allowUnknownFields === true || options?.knownCustomNames !== void 0 && options.knownCustomNames.size > 0 && referencesCustomComponent(document, options.knownCustomNames) || Value3.Check(getContainmentRelaxedSchema(), document)) {
+    return { valid: true, errors: [] };
+  }
+  const errors = stageOneErrors.length > 0 ? stageOneErrors : [
+    {
+      path: "root",
+      message: "Document does not match the 'docx' document schema.",
+      code: "invalid_document"
+    }
+  ];
+  return {
+    valid: false,
+    errors: [
+      ...errors,
+      {
+        path: "root",
+        message: 'The document was rejected by the whole-document schema, but deep validation could not localize the fault. Common causes: an unknown key next to "name", "props" or "children" on some component, or a value at a position the schema does not declare.',
+        code: "unlocalized_schema_error"
+      }
+    ]
+  };
+}
+function deepValidateRejected(document, stageOneErrors, options) {
+  const errors = comprehensiveValidateDocument(document, stageOneErrors, {
+    allowUnknownFields: options?.allowUnknownFields,
+    knownCustomNames: options?.knownCustomNames
+  });
+  if (errors.length === 0) {
+    return resolveEmptyWalk(document, stageOneErrors, options);
+  }
+  return { valid: false, errors };
+}
 function validateDocument(data, options) {
   const result = validateAgainstSchema(
     ComponentDefinitionSchema,
@@ -867,13 +991,11 @@ function validateDocument(data, options) {
   let finalErrors = result.errors || [];
   let finalValid = result.valid;
   if (!result.valid && data) {
-    finalErrors = comprehensiveValidateDocument(data, result.errors, {
-      allowUnknownFields: options?.allowUnknownFields,
-      knownCustomNames: options?.knownCustomNames
-    });
-    if (finalErrors.length === 0) {
-      finalValid = true;
-    }
+    ({ valid: finalValid, errors: finalErrors } = deepValidateRejected(
+      data,
+      result.errors || [],
+      options
+    ));
   }
   const semanticConflicts = collectSemanticConflicts(data);
   if (semanticConflicts.length > 0) {
@@ -908,13 +1030,11 @@ function validateJsonDocument(jsonInput, options) {
   let finalErrors = result.errors || [];
   let finalValid = result.valid;
   if (!result.valid && result.parsed) {
-    finalErrors = comprehensiveValidateDocument(result.parsed, result.errors, {
-      allowUnknownFields: options?.allowUnknownFields,
-      knownCustomNames: options?.knownCustomNames
-    });
-    if (finalErrors.length === 0) {
-      finalValid = true;
-    }
+    ({ valid: finalValid, errors: finalErrors } = deepValidateRejected(
+      result.parsed,
+      result.errors || [],
+      options
+    ));
   }
   const semanticConflicts = collectSemanticConflicts(result.parsed);
   if (semanticConflicts.length > 0) {
@@ -996,4 +1116,4 @@ export {
   validateJsonComponent,
   validateDocumentWithSchema
 };
-//# sourceMappingURL=chunk-3DLMRNA7.js.map
+//# sourceMappingURL=chunk-S7CHEAUQ.js.map

package/dist/chunk-S7CHEAUQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validation/unified/error-transformer.ts","../src/validation/unified/deep-validator.ts","../src/validation/unified/base-validator.ts","../src/validation/unified/document-validator.ts"],"sourcesContent":["/**\n * Unified error transformation utilities\n * Converts TypeBox ValueError objects to standardized ValidationError format\n */\n\nimport type { ValueError } from '@sinclair/typebox/value';\nimport type { ValidationError } from '@json-to-office/shared';\nimport { ReportPropsSchema } from '../../schemas/components/report';\nimport {\n  isObjectSchema,\n  getObjectSchemaPropertyNames,\n  getLiteralValue,\n  type ErrorFormatterConfig,\n  createErrorConfig,\n  formatErrorMessage,\n  ERROR_EMOJIS,\n} from '@json-to-office/shared';\n\n/**\n * Generate enhanced error message based on error type and context\n */\nfunction generateEnhancedMessage(\n  error: ValueError,\n  _config: Required<ErrorFormatterConfig>\n): string {\n  const typeStr = String(error.type || '');\n  const path = error.path || 'root';\n\n  // Handle union errors specially - these are the most common and least helpful\n  if (typeStr === '62' || typeStr === 'union') {\n    return generateUnionErrorMessage(error);\n  }\n\n  // Handle additional properties error\n  if (error.message?.includes('additionalProperties')) {\n    return generateAdditionalPropertiesMessage(error);\n  }\n\n  // Handle missing required properties\n  if (error.message?.includes('Required property')) {\n    return generateRequiredPropertyMessage(error);\n  }\n\n  // Handle type mismatches\n  if (\n    typeStr === 'string' ||\n    typeStr === 'number' ||\n    typeStr === 'boolean' ||\n    typeStr === 'array' ||\n    typeStr === 'object'\n  ) {\n    return generateTypeMismatchMessage(error);\n  }\n\n  // Handle literal value errors\n  if (typeStr === 'literal') {\n    return generateLiteralErrorMessage(error);\n  }\n\n  // Handle pattern/regex errors\n  if (typeStr === 'pattern' || typeStr === 'RegExp') {\n    return generatePatternErrorMessage(error);\n  }\n\n  // Default to original message with some context\n  return `At ${path}: ${error.message}`;\n}\n\n/**\n * Generate message for union validation errors\n */\nfunction generateUnionErrorMessage(error: ValueError): string {\n  const path = error.path || 'root';\n  const value = error.value;\n\n  // Try to determine what the user was attempting\n  if (path === 'root' || path === '/' || path === '/jsonDefinition') {\n    // Root level or jsonDefinition union error - likely a document type issue\n    if (value && typeof value === 'object') {\n      if ('name' in value) {\n        const name = value.name;\n        if (name === 'docx') {\n          return 'Document structure appears valid but contains invalid component configurations. Check each component for errors.';\n        }\n        return `Unknown document name '${name}'. Expected 'docx'.`;\n      }\n\n      // Missing name field\n      const valueAny = value as Record<string, unknown>;\n      if ('children' in value && Array.isArray(valueAny.children)) {\n        return 'Document is missing required \\'name\\' field. Add \"name\": \"docx\" at the root level.';\n      }\n\n      // Check if it might be a theme\n      if ('name' in value || 'styles' in value) {\n        return 'This appears to be a theme configuration. Use --type theme or ensure proper document structure.';\n      }\n    }\n    return 'Invalid document structure. Expected a document with name=\"docx\" or a theme configuration.';\n  }\n\n  // Component-level union error\n  if (path.includes('/children/')) {\n    if (value && typeof value === 'object' && 'name' in value) {\n      const componentType = (value as any).name;\n      return `Invalid component configuration for type '${componentType}'. Check that all required fields are present and correctly formatted.`;\n    }\n    return 'Invalid component structure. Each component must have a \"name\" field and valid configuration.';\n  }\n\n  // Default union error message\n  return `Value at ${path} doesn't match any of the expected formats. Check the structure and required fields.`;\n}\n\n/**\n * Generate message for additional properties errors\n */\nfunction generateAdditionalPropertiesMessage(error: ValueError): string {\n  const path = error.path || 'root';\n  const value = error.value;\n\n  if (typeof value === 'object' && value !== null) {\n    // Try to identify the unknown properties\n    const schema = error.schema;\n    if (schema && isObjectSchema(schema)) {\n      const knownProps = getObjectSchemaPropertyNames(schema);\n      const actualProps = Object.keys(value);\n      const unknownProps = actualProps.filter((p) => !knownProps.includes(p));\n\n      if (unknownProps.length > 0) {\n        return (\n          `Unknown properties at ${path}: ${unknownProps.join(', ')}. ` +\n          `Allowed properties are: ${knownProps.join(', ')}`\n        );\n      }\n    }\n  }\n\n  return `Additional properties not allowed at ${path}. Check for typos or unsupported fields.`;\n}\n\n/**\n * Generate message for required property errors\n */\nfunction generateRequiredPropertyMessage(error: ValueError): string {\n  const path = error.path || 'root';\n  const match = error.message?.match(/Required property '([^']+)'/);\n\n  if (match) {\n    const propName = match[1];\n    return `Missing required field '${propName}' at ${path}. This field is mandatory for this configuration.`;\n  }\n\n  return `Missing required property at ${path}. Check that all mandatory fields are present.`;\n}\n\n/**\n * Generate message for type mismatch errors\n */\nfunction generateTypeMismatchMessage(error: ValueError): string {\n  const path = error.path || 'root';\n  const expectedType = String(error.type);\n  const actualType = Array.isArray(error.value) ? 'array' : typeof error.value;\n\n  // Provide context-specific messages\n  if (path.includes('alignment')) {\n    return `Invalid alignment value at ${path}. Expected one of: left, center, right, justify`;\n  }\n\n  if (path.includes('color')) {\n    return `Invalid color value at ${path}. Use hex format (#RRGGBB), rgb(r,g,b), or a named color`;\n  }\n\n  if (path.includes('fontSize') || path.includes('size')) {\n    return `Invalid size value at ${path}. Expected a number (in points)`;\n  }\n\n  if (\n    path.includes('margin') ||\n    path.includes('padding') ||\n    path.includes('spacing')\n  ) {\n    return `Invalid spacing value at ${path}. Expected a number or spacing object with top/bottom/left/right`;\n  }\n\n  return `Type mismatch at ${path}: Expected ${expectedType} but got ${actualType}`;\n}\n\n/**\n * Generate message for literal value errors\n */\nfunction generateLiteralErrorMessage(error: ValueError): string {\n  const path = error.path || 'root';\n  const expected = error.schema\n    ? JSON.stringify(getLiteralValue(error.schema))\n    : 'specific value';\n  const actual = JSON.stringify(error.value);\n\n  return `Invalid value at ${path}: Expected exactly ${expected} but got ${actual}`;\n}\n\n/**\n * Generate message for pattern/regex errors\n */\nfunction generatePatternErrorMessage(error: ValueError): string {\n  const path = error.path || 'root';\n\n  // Try to provide helpful context based on the path\n  if (path.includes('email')) {\n    return `Invalid email format at ${path}. Use format: user@example.com`;\n  }\n\n  if (path.includes('url') || path.includes('link')) {\n    return `Invalid URL format at ${path}. Use format: https://example.com`;\n  }\n\n  if (path.includes('date')) {\n    return `Invalid date format at ${path}. Use ISO format: YYYY-MM-DD`;\n  }\n\n  if (path.includes('phone')) {\n    return `Invalid phone number format at ${path}`;\n  }\n\n  return `Value at ${path} doesn't match the required pattern`;\n}\n\n/**\n * Transform TypeBox ValueError to standardized ValidationError\n */\nexport function transformValueError(\n  error: ValueError,\n  jsonString?: string,\n  config?: ErrorFormatterConfig\n): ValidationError {\n  const formatterConfig = createErrorConfig(config);\n\n  // Generate enhanced message based on error type\n  const enhancedMessage = generateEnhancedMessage(error, formatterConfig);\n\n  const baseError: ValidationError = {\n    path: error.path || 'root',\n    message: formatErrorMessage(\n      enhancedMessage || error.message,\n      formatterConfig\n    ),\n    code: String(error.type || 'validation_error'),\n    value: error.value,\n  };\n\n  // Add suggestion if available and configured\n  if (formatterConfig.includeSuggestions) {\n    const suggestion = getSuggestion(error, formatterConfig);\n    if (suggestion) {\n      baseError.suggestion = formatErrorMessage(suggestion, formatterConfig);\n    }\n  }\n\n  // Calculate line and column if JSON string is provided\n  if (jsonString && error.path) {\n    const position = calculatePosition(jsonString, error.path);\n    if (position) {\n      baseError.line = position.line;\n      baseError.column = position.column;\n    }\n  }\n\n  return baseError;\n}\n\n/**\n * Transform multiple TypeBox errors to ValidationError array\n * Enhanced to collect ALL errors, not just stopping at union failures\n */\nexport function transformValueErrors(\n  errors: ValueError[],\n  options?: {\n    jsonString?: string;\n    maxErrors?: number;\n  }\n): ValidationError[] {\n  const maxErrors = options?.maxErrors ?? Number.MAX_SAFE_INTEGER;\n  const result: ValidationError[] = [];\n  const seenPaths = new Set<string>();\n\n  // Collect all errors, but avoid duplicates at the same path\n  for (const error of errors) {\n    if (result.length >= maxErrors) break;\n\n    // Create a unique key for this error based on path and type\n    const errorKey = `${error.path}:${error.type}`;\n\n    // Skip if we've already seen an error at this exact path and type\n    // This helps avoid duplicate union errors while still showing all unique issues\n    if (!seenPaths.has(errorKey)) {\n      seenPaths.add(errorKey);\n      result.push(transformValueError(error, options?.jsonString, undefined));\n    }\n  }\n\n  return result;\n}\n\n/**\n * Calculate line and column position in JSON string\n */\nexport function calculatePosition(\n  jsonString: string,\n  path: string\n): { line: number; column: number } | null {\n  try {\n    // Convert path like \"/children/0/props/title\" to searchable parts\n    const pathParts = path.split('/').filter(Boolean);\n    if (pathParts.length === 0) {\n      return { line: 1, column: 1 };\n    }\n\n    // Try to find the last part of the path in the JSON\n    const lastPart = pathParts[pathParts.length - 1];\n    const searchPattern = `\"${lastPart}\"`;\n    const index = jsonString.indexOf(searchPattern);\n\n    if (index === -1) {\n      // Try to find just the value if it's a property name\n      return { line: 1, column: 1 };\n    }\n\n    // Calculate line and column from index\n    const beforeError = jsonString.substring(0, index);\n    const lines = beforeError.split('\\n');\n    const line = lines.length;\n    const column = lines[lines.length - 1].length + 1;\n\n    return { line, column };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get helpful suggestion based on error type and context\n */\nfunction getSuggestion(\n  error: ValueError,\n  config: Required<ErrorFormatterConfig>\n): string | undefined {\n  const { type, path, value } = error;\n  const typeStr = String(type);\n\n  // Enhanced suggestions for union errors\n  if (typeStr === '62' || typeStr === 'union') {\n    if (path === 'root' || path === '/') {\n      if (value && typeof value === 'object') {\n        if (!('name' in value)) {\n          const msg = 'Add a \"name\" field with value \"docx\" for documents';\n          return config.includeEmojis ? `${ERROR_EMOJIS.FIX} ${msg}` : msg;\n        }\n        if ('props' in value && typeof value.props === 'object') {\n          const knownFields = getObjectSchemaPropertyNames(ReportPropsSchema);\n          return `Review the props section for unsupported fields. Allowed fields: ${knownFields.join(', ')}`;\n        }\n      }\n      return 'Ensure the document has proper structure: { \"name\": \"docx\", \"props\": {...}, \"children\": [...] }';\n    }\n    if (path?.includes('/children/')) {\n      return 'Check that the component has a valid \"name\" and all required fields for that component type';\n    }\n    return 'Review the structure and ensure all required fields are present with correct types';\n  }\n\n  // Suggestions for additional properties errors\n  if (error.message?.includes('additionalProperties')) {\n    return 'Remove any unknown or unsupported fields. Check documentation for allowed properties.';\n  }\n\n  // Suggestions for required properties\n  if (error.message?.includes('Required property')) {\n    return 'Add the missing required field to fix this error';\n  }\n\n  // Type-specific suggestions\n  if (typeStr === 'string') {\n    if (path?.includes('alignment')) {\n      return 'Use one of: left, center, right, justify';\n    }\n    if (path?.includes('color')) {\n      return 'Use a valid color format (hex: #RRGGBB, rgb: rgb(r,g,b), or named color)';\n    }\n    return 'Provide a text string value';\n  }\n\n  if (typeStr === 'number') {\n    if (path?.includes('fontSize') || path?.includes('size')) {\n      return 'Use a number in points (e.g., 12, 14, 16)';\n    }\n    if (path?.includes('margin') || path?.includes('padding')) {\n      return 'Use a number for spacing in points';\n    }\n    return 'Provide a numeric value';\n  }\n\n  if (typeStr === 'boolean') {\n    return 'Use true or false (without quotes)';\n  }\n\n  if (typeStr === 'array') {\n    if (path?.includes('children')) {\n      return 'Provide an array of component objects, each with a \"name\" field';\n    }\n    return 'Provide an array/list of values using square brackets []';\n  }\n\n  if (typeStr === 'object') {\n    return 'Provide an object with key-value pairs using curly braces {}';\n  }\n\n  if (typeStr === 'literal') {\n    const expected = error.schema\n      ? JSON.stringify(getLiteralValue(error.schema))\n      : 'specific value';\n    return `Use exactly this value: ${expected}`;\n  }\n\n  if (typeStr === 'pattern' || typeStr === 'RegExp') {\n    if (path?.includes('email')) {\n      return 'Use valid email format: user@example.com';\n    }\n    if (path?.includes('url')) {\n      return 'Use valid URL format: https://example.com';\n    }\n    if (path?.includes('date')) {\n      return 'Use ISO date format: YYYY-MM-DD';\n    }\n    return 'Ensure the value matches the required format';\n  }\n\n  // Path-based suggestions\n  if (path?.includes('name') || path?.includes('type')) {\n    return 'Use a valid component name: docx, section, columns, heading, paragraph, image, statistic, table, list, toc, text-box, highcharts, or visual';\n  }\n\n  return undefined;\n}\n\n/**\n * Format validation errors as a summary string\n */\nexport function formatErrorSummary(errors: ValidationError[]): string {\n  if (errors.length === 0) return 'No errors';\n\n  if (errors.length === 1) {\n    return errors[0].message;\n  }\n\n  const summary = errors\n    .slice(0, 3)\n    .map((e) => `${e.path}: ${e.message}`)\n    .join(', ');\n\n  if (errors.length > 3) {\n    return `${summary} and ${errors.length - 3} more...`;\n  }\n\n  return summary;\n}\n\n/**\n * Group errors by path for better reporting\n */\nexport function groupErrorsByPath(\n  errors: ValidationError[]\n): Map<string, ValidationError[]> {\n  const grouped = new Map<string, ValidationError[]>();\n\n  for (const error of errors) {\n    const path = error.path || 'root';\n    const group = grouped.get(path) || [];\n    group.push(error);\n    grouped.set(path, group);\n  }\n\n  return grouped;\n}\n\n/**\n * Create a JSON parse error\n */\nexport function createJsonParseError(\n  error: Error,\n  jsonString: string\n): ValidationError {\n  // Try to extract position from error message\n  const match = error.message.match(/position (\\d+)/);\n  const position = match ? parseInt(match[1], 10) : 0;\n\n  let line = 1;\n  let column = 1;\n\n  if (position > 0) {\n    const lines = jsonString.substring(0, position).split('\\n');\n    line = lines.length;\n    column = lines[lines.length - 1].length + 1;\n  }\n\n  return {\n    path: 'root',\n    message: `JSON Parse Error: ${error.message}`,\n    code: 'json_parse_error',\n    line,\n    column,\n    suggestion: 'Check for missing commas, quotes, or brackets',\n  };\n}\n","/**\n * Deep validation utilities for collecting ALL errors in nested structures\n * This bypasses TypeBox's union short-circuiting to provide comprehensive error reporting\n */\n\nimport { Value } from '@sinclair/typebox/value';\nimport type { TSchema } from '@sinclair/typebox';\nimport type { ValidationError } from '@json-to-office/shared';\nimport { STANDARD_COMPONENTS_REGISTRY } from '../../schemas/component-registry';\nimport { CustomComponentDefinitionSchema } from '../../schemas/custom-components';\nimport { transformValueErrors } from './error-transformer';\n\n// Map of component names to their props schemas, sourced from the registry.\n// This stays in sync as new standard components are added, so the document\n// root ('docx') and every standard child component are recognized here.\nconst COMPONENT_SCHEMAS: Record<string, TSchema> = Object.fromEntries([\n  ...STANDARD_COMPONENTS_REGISTRY.map((c) => [c.name, c.propsSchema]),\n  ['custom', CustomComponentDefinitionSchema],\n]);\n\n// Where each component embeds full component definitions inside its props\n// (section header/footer, table cell content, …), sourced from the registry so\n// the walk covers exactly what each entry's `createPropsSchema` wires into the\n// live document schema — the declaration and the factory are pinned to each\n// other by embedded-component-regions.test.ts (#292).\nconst EMBEDDED_REGIONS = new Map(\n  STANDARD_COMPONENTS_REGISTRY.filter(\n    (c) => (c.embeddedComponents?.length ?? 0) > 0\n  ).map((c) => [c.name, c.embeddedComponents!])\n);\n\n// Root component names that may appear at the top of a document.\nconst ROOT_COMPONENT_NAMES = new Set(\n  STANDARD_COMPONENTS_REGISTRY.filter((c) =>\n    Boolean(c.special?.hasSchemaField)\n  ).map((c) => c.name)\n);\n\n// The sibling keys legal NEXT TO `name`/`props` on each component node,\n// mirroring what createComponentSchemaObject puts on the whole-document\n// schema. Per-component props checks never see these positions, so without\n// this list a junk key beside `props` is invisible to the walk and used to\n// fail only via the generic fail-closed net (#292).\nconst ALLOWED_SIBLING_KEYS: ReadonlyMap<string, ReadonlySet<string>> = new Map(\n  STANDARD_COMPONENTS_REGISTRY.map((c) => [\n    c.name,\n    new Set([\n      'name',\n      'id',\n      'enabled',\n      'props',\n      ...(c.hasChildren ? ['children'] : []),\n      ...(c.special?.hasSchemaField ? ['$schema', 'renderer'] : []),\n    ]),\n  ])\n);\n\n// What each legal sibling key must hold, per the whole-document schema.\n// `name` and `children` are typed by their own dedicated checks.\nconst SIBLING_KEY_TYPES: Record<string, 'string' | 'boolean'> = {\n  id: 'string',\n  enabled: 'boolean',\n  $schema: 'string',\n  renderer: 'string',\n};\n\n/**\n * Report sibling-key faults on a component node: keys the whole-document\n * schema does not define, and known keys holding a wrong-typed value (an\n * `enabled: \"yes\"` — key presence alone would pass it). Unknown keys are\n * skipped under `allowUnknownFields`; names outside the registry are skipped\n * entirely (unknown components and the legacy `custom` shape are reported\n * through other channels).\n */\nfunction collectSiblingKeyErrors(\n  node: Record<string, unknown>,\n  path: string,\n  opts: DeepValidateOptions,\n  errors: ValidationError[]\n): void {\n  const allowed =\n    typeof node.name === 'string'\n      ? ALLOWED_SIBLING_KEYS.get(node.name)\n      : undefined;\n  if (!allowed) return;\n  for (const key of Object.keys(node)) {\n    if (!allowed.has(key)) {\n      if (opts.allowUnknownFields) continue;\n      errors.push({\n        path: `${path}/${key}`,\n        message: `Unknown key \"${key}\" on component \"${node.name}\". Allowed keys: ${[\n          ...allowed,\n        ].join(', ')}.`,\n        code: 'unknown_key',\n      });\n      continue;\n    }\n    const expected = SIBLING_KEY_TYPES[key];\n    if (expected && typeof node[key] !== expected) {\n      errors.push({\n        path: `${path}/${key}`,\n        message: `Key \"${key}\" on component \"${node.name}\" must be a ${expected}.`,\n        code: 'invalid_type',\n      });\n    }\n  }\n}\n\n/**\n * Options that tune deep validation.\n *\n * `knownCustomNames` — names of registered plugin components. The deep\n * validator neither flags these as \"unknown component\" nor validates their\n * props here; the plugin layer validates custom props version-aware separately.\n *\n * `allowUnknownFields` — when true, unknown properties are stripped before the\n * per-component check instead of being rejected. The escape hatch for callers\n * migrating onto strict schemas.\n */\nexport interface DeepValidateOptions {\n  knownCustomNames?: Set<string>;\n  allowUnknownFields?: boolean;\n}\n\n// Image source fields that are mutually exclusive: exactly one may be set.\nconst IMAGE_SOURCE_FIELDS = ['path', 'base64', 'svg'] as const;\n\n/**\n * Names of the image source fields that carry a non-empty value on a props object.\n */\nexport function presentImageSources(props: unknown): string[] {\n  if (!props || typeof props !== 'object') return [];\n  const p = props as Record<string, unknown>;\n  return IMAGE_SOURCE_FIELDS.filter((f) => {\n    const v = p[f];\n    return typeof v === 'string' && v.trim().length > 0;\n  });\n}\n\n/**\n * Collect \"more than one image source\" conflicts anywhere in a document.\n *\n * `path`, `base64`, and `svg` are mutually exclusive on the image component, but\n * all three are optional fields on a single object schema — so a multi-source\n * payload passes TypeBox's structural check and would otherwise be silently\n * resolved by runtime precedence (svg > base64 > path). This walk runs\n * unconditionally and rejects such payloads. It traverses every nested value, so\n * images inside columns, table cells, text boxes, headers/footers, and sections\n * are all covered regardless of container shape.\n */\nexport function collectImageSourceConflicts(data: unknown): ValidationError[] {\n  const errors: ValidationError[] = [];\n\n  const visit = (node: any, path: string): void => {\n    if (Array.isArray(node)) {\n      node.forEach((item, i) => visit(item, `${path}/${i}`));\n      return;\n    }\n    if (!node || typeof node !== 'object') return;\n\n    if (node.name === 'image') {\n      const present = presentImageSources(node.props);\n      if (present.length > 1) {\n        errors.push({\n          path: `${path}/props`,\n          message: `Image component accepts only one source, but found ${present\n            .map((f) => `\"${f}\"`)\n            .join(', ')}. Use exactly one of \"path\", \"base64\", or \"svg\".`,\n          code: 'mutually_exclusive',\n        });\n      }\n    }\n\n    for (const key of Object.keys(node)) {\n      visit(node[key], `${path}/${key}`);\n    }\n  };\n\n  visit(data, '');\n  return errors;\n}\n\n// Components that accept a paragraph-style `indent` prop with the mutually\n// exclusive hanging/firstLine pair.\nconst INDENT_COMPONENT_NAMES = new Set(['paragraph', 'heading']);\n\n/**\n * Collect \"hanging and firstLine both set\" indent conflicts anywhere in a\n * document.\n *\n * `hanging` and `firstLine` are mutually exclusive on `props.indent` (they both\n * map to the same w:ind axis — Word keeps only one), but each is an optional\n * field on a single object schema, so a payload carrying both passes TypeBox's\n * structural check. Like the image-source walk above, this runs unconditionally\n * and traverses every nested value, so paragraphs inside columns, table cells,\n * text boxes, headers/footers, and sections are all covered.\n */\nexport function collectIndentConflicts(data: unknown): ValidationError[] {\n  const errors: ValidationError[] = [];\n\n  const visit = (node: any, path: string): void => {\n    if (Array.isArray(node)) {\n      node.forEach((item, i) => visit(item, `${path}/${i}`));\n      return;\n    }\n    if (!node || typeof node !== 'object') return;\n\n    if (INDENT_COMPONENT_NAMES.has(node.name)) {\n      const indent = node.props?.indent;\n      if (\n        indent &&\n        typeof indent === 'object' &&\n        indent.hanging !== undefined &&\n        indent.firstLine !== undefined\n      ) {\n        errors.push({\n          path: `${path}/props/indent`,\n          message:\n            'Indent accepts either \"hanging\" or \"firstLine\", not both. Use exactly one of the two.',\n          code: 'mutually_exclusive',\n        });\n      }\n    }\n\n    for (const key of Object.keys(node)) {\n      visit(node[key], `${path}/${key}`);\n    }\n  };\n\n  visit(data, '');\n  return errors;\n}\n\n/**\n * Collect \"notes declared on a revised paragraph\" conflicts anywhere in a\n * document.\n *\n * `revision` renders a paragraph's text from its segments as literal runs, so a\n * `[^id]` marker inside them never resolves and the declared note body is never\n * written. The combination is not expressible either: `InsertedTextRun` and\n * `DeletedTextRun` wrap exactly one `TextRun` built from their own options, so\n * `docx` offers no way to put a footnote reference inside `w:ins` / `w:del`\n * without reaching past its public API.\n *\n * Each half is an independent optional field, so a payload carrying both passes\n * TypeBox's structural check. Like the image-source and indent walks above,\n * this runs unconditionally and traverses every nested value, so paragraphs\n * inside columns, table cells, text boxes, headers/footers and sections are all\n * covered.\n */\nexport function collectNoteRevisionConflicts(data: unknown): ValidationError[] {\n  const errors: ValidationError[] = [];\n\n  const visit = (node: any, path: string): void => {\n    if (Array.isArray(node)) {\n      node.forEach((item, i) => visit(item, `${path}/${i}`));\n      return;\n    }\n    if (!node || typeof node !== 'object') return;\n\n    // A paragraph revised directly, or a table cell whose own revision drives\n    // the runs of the paragraph inside it — both render the text from segments,\n    // so neither can resolve a marker.\n    const revisedNotes: { notes: unknown; path: string }[] = [];\n    if (node.name === 'paragraph' && node.props?.revision) {\n      for (const kind of ['footnotes', 'endnotes'] as const) {\n        revisedNotes.push({\n          notes: node.props[kind],\n          path: `${path}/props/${kind}`,\n        });\n      }\n    }\n    if (node.revision && node.content?.name === 'paragraph') {\n      for (const kind of ['footnotes', 'endnotes'] as const) {\n        revisedNotes.push({\n          notes: node.content.props?.[kind],\n          path: `${path}/content/props/${kind}`,\n        });\n      }\n    }\n\n    for (const { notes, path: notesPath } of revisedNotes) {\n      if (Array.isArray(notes) && notes.length > 0) {\n        const kind = notesPath.endsWith('endnotes') ? 'endnotes' : 'footnotes';\n        errors.push({\n          path: notesPath,\n          message:\n            `\"revision\" and \"${kind}\" cannot apply to the same text. Tracked-change ` +\n            'text renders literally, so note markers inside it are not resolved and the ' +\n            'note bodies would be dropped. Move the notes to text without a revision.',\n          code: 'mutually_exclusive',\n        });\n      }\n    }\n\n    for (const key of Object.keys(node)) {\n      visit(node[key], `${path}/${key}`);\n    }\n  };\n\n  visit(data, '');\n  return errors;\n}\n\n/**\n * Collect `text-box` requests for a shape rendering that a shape cannot honour,\n * anywhere in a document.\n *\n * `renderAs: 'shape'` emits a WPS DrawingML shape, and two of its limits are\n * decidable from the props alone:\n *\n * - **Size.** A shape carries an absolute extent and has no autofit, so a box\n *   without both `width` and `height` has no size to render at.\n * - **Border style.** docx's outline options carry width, cap, compound and\n *   fill but no `a:prstDash`, so a dash pattern cannot be expressed at all; the\n *   `compoundLine` that could stand in for `double` is emitted as the enum key\n *   (`cmpd=\"DOUBLE\"`) rather than the OOXML value.\n *\n * Both are independently optional fields, so the combination passes TypeBox's\n * structural check. Reporting them here rather than warning at render time puts\n * the fault where the author can fix it — the renderer's own guards degrade to\n * the table rendering, which is silent in an editor that only shows the result.\n *\n * Like the walks above this runs unconditionally over every nested value, so a\n * text box inside columns, a table cell, a header/footer or another text box is\n * covered too. The third render-time fallback — content that renders as a table\n * rather than a paragraph — is deliberately absent: it depends on what the\n * children render to, which no static walk can know.\n */\nconst UNDASHABLE_BORDER_STYLES = new Set(['dashed', 'dotted', 'double']);\n\nexport function collectTextBoxShapeConflicts(data: unknown): ValidationError[] {\n  const errors: ValidationError[] = [];\n\n  const visit = (node: any, path: string): void => {\n    if (Array.isArray(node)) {\n      node.forEach((item, i) => visit(item, `${path}/${i}`));\n      return;\n    }\n    if (!node || typeof node !== 'object') return;\n\n    if (node.name === 'text-box' && node.props?.renderAs === 'shape') {\n      const missing = (['width', 'height'] as const).filter(\n        (axis) => node.props[axis] === undefined\n      );\n      if (missing.length > 0) {\n        errors.push({\n          path: `${path}/props/${missing[0]}`,\n          message:\n            `A text-box with renderAs \"shape\" requires ${missing.join(' and ')}: a shape ` +\n            'has no autofit, so its size cannot be derived from its content. Give it an ' +\n            'explicit size, or use renderAs \"table\", which grows to fit.',\n          code: 'required',\n        });\n      }\n\n      const border = node.props.style?.border;\n      if (border && typeof border === 'object') {\n        for (const side of ['top', 'right', 'bottom', 'left'] as const) {\n          const style = border[side]?.style;\n          if (\n            typeof style === 'string' &&\n            UNDASHABLE_BORDER_STYLES.has(style)\n          ) {\n            errors.push({\n              path: `${path}/props/style/border/${side}/style`,\n              message:\n                `A text-box with renderAs \"shape\" cannot draw a \"${style}\" border: a shape ` +\n                'outline carries no dash pattern. Use \"solid\", or use renderAs \"table\", ' +\n                'which draws every border style.',\n              code: 'unsupported_value',\n            });\n          }\n        }\n      }\n    }\n\n    for (const key of Object.keys(node)) {\n      visit(node[key], `${path}/${key}`);\n    }\n  };\n\n  visit(data, '');\n  return errors;\n}\n\n/**\n * Deep validate a document to collect ALL errors, not just union-level errors\n */\nexport function deepValidateDocument(\n  data: any,\n  opts: DeepValidateOptions = {}\n): ValidationError[] {\n  const allErrors: ValidationError[] = [];\n\n  // Validate the document structure\n  if (!data || typeof data !== 'object') {\n    allErrors.push({\n      path: 'root',\n      message: 'Document must be an object',\n      code: 'invalid_type',\n    });\n    return allErrors;\n  }\n\n  // Check name field\n  if (!data.name) {\n    allErrors.push({\n      path: '/name',\n      message: 'Missing required field \"name\"',\n      code: 'required_property',\n    });\n  } else if (!ROOT_COMPONENT_NAMES.has(data.name)) {\n    const expected = [...ROOT_COMPONENT_NAMES].map((n) => `\"${n}\"`).join(', ');\n    allErrors.push({\n      path: '/name',\n      message: `Invalid name \"${data.name}\". Expected ${expected}`,\n      code: 'invalid_value',\n    });\n  }\n\n  // Junk keys next to the root's name/props/children are outside every\n  // per-component props check; report them here.\n  collectSiblingKeyErrors(data, '', opts, allErrors);\n\n  // Validate props section when the key is present so explicit `null` (or any\n  // falsy non-object) is checked against the component's schema instead of\n  // silently passing.\n  if (ROOT_COMPONENT_NAMES.has(data.name) && 'props' in data) {\n    const propsErrors = validateComponentProps(\n      data.name,\n      data.props,\n      '/props',\n      opts\n    );\n    allErrors.push(...propsErrors);\n  }\n\n  // Validate the children array. The root component requires one; nested\n  // containers may legitimately omit it.\n  if (!data.children) {\n    allErrors.push({\n      path: '/children',\n      message: 'Missing required field \"children\"',\n      code: 'required_property',\n    });\n  } else if (!Array.isArray(data.children)) {\n    allErrors.push({\n      path: '/children',\n      message: 'Field \"children\" must be an array',\n      code: 'invalid_type',\n    });\n  }\n\n  // Deep-validate the props of every component anywhere in the tree.\n  //\n  // The earlier implementation only re-validated the root's direct children\n  // and one level of `section` children. Two whole-tree blind spots followed:\n  //   1. component props nested inside `text-box`/`columns` children — the\n  //      content of every container lives in the shared `children` field, so\n  //      anything below the first level went unchecked; and\n  //   2. the `header`/`footer` paragraph regions, which the section schema\n  //      types loosely as an array of `Type.Any()` (or the `'linkToPrevious'`\n  //      literal) — so their entries' props are never checked by the\n  //      per-section validation.\n  // The in-editor (Monaco) validator runs the generated JSON Schema over the\n  // entire document, so it flags both. This walk brings the CLI to parity.\n  walkComponentTree(data, '', opts, allErrors);\n\n  return allErrors;\n}\n\n/**\n * Recursively validate the props of every component nested under `node`.\n *\n * Walks two kinds of child position to any depth:\n *  - the `children` array — the universal container field shared by `docx`,\n *    `section`, `columns` and `text-box` (added by the component registry), so\n *    a bad prop inside a `text-box` or `columns` child is caught however deeply\n *    it is nested; and\n *  - the embedded-component regions each registry entry declares\n *    (`embeddedComponents`: section `header`/`footer`, table cell content) —\n *    positions the static per-component props schemas type loosely, so their\n *    entries are not deep-checked by the parent's per-component validation.\n *\n * The node's own props are NOT validated here — the caller validates the root\n * props, and every entry is validated as it is visited.\n */\nfunction walkComponentTree(\n  node: any,\n  path: string,\n  opts: DeepValidateOptions,\n  errors: ValidationError[]\n): void {\n  if (!node || typeof node !== 'object') return;\n\n  // `strictStructure` controls whether a malformed entry (not an object, or\n  // missing `name`) is reported here. It is ON for positions the per-component\n  // schema leaves unchecked — the `children` array (a sibling field, never seen\n  // by props validation) and the `header`/`footer` regions (typed `Type.Any()`\n  // on the static section schema) — so the walk is their only structural\n  // checker and must match the whole-tree schema the editor runs. It is OFF for\n  // `table` cell content, whose structure the table's own props schema already\n  // validates; there the walk only adds the prop-constraint errors the loose\n  // cell-content ref misses, so reporting structure too would double-report.\n  const validateEntry = (\n    child: any,\n    childPath: string,\n    strictStructure: boolean\n  ): void => {\n    if (!child || typeof child !== 'object') {\n      if (strictStructure) {\n        errors.push({\n          path: childPath,\n          message: 'Component must be an object',\n          code: 'invalid_type',\n        });\n      }\n      return;\n    }\n    if (typeof child.name !== 'string' || child.name.length === 0) {\n      if (strictStructure) {\n        errors.push({\n          path: `${childPath}/name`,\n          message: 'Component missing required field \"name\"',\n          code: 'required_property',\n        });\n      }\n      return;\n    }\n\n    // Registered plugin components are validated version-aware by the plugin\n    // layer; skip their props and subtree so they are neither double-validated\n    // nor misreported as unknown.\n    if (opts.knownCustomNames?.has(child.name)) return;\n\n    // Junk keys next to name/props are outside the props check below.\n    collectSiblingKeyErrors(child, childPath, opts, errors);\n\n    // Validate props against the component's schema. When props is omitted,\n    // validate an empty object so the schema decides whether props are\n    // required (e.g. `section` needs none; `heading` requires text+level).\n    //\n    // Presence is `'props' in child`, matching the root check above: an\n    // explicit `null` is a value the schema rejects (props must be an object),\n    // so it has to reach the schema rather than be read as an omission.\n    if ('props' in child) {\n      errors.push(\n        ...validateComponentProps(\n          child.name,\n          child.props,\n          `${childPath}/props`,\n          opts\n        )\n      );\n    } else if (child.name !== 'custom') {\n      errors.push(\n        ...validateComponentProps(child.name, {}, `${childPath}/props`, opts)\n      );\n    }\n\n    // Recurse so arbitrarily nested containers are covered.\n    walkComponentTree(child, childPath, opts, errors);\n  };\n\n  // Visit every embedded-component region this component declares in the\n  // registry. A value of another legal shape at the position (a string cell\n  // content, a `'linkToPrevious'` header) simply fails the arity guard and is\n  // not walked.\n  const regions =\n    typeof node.name === 'string' ? EMBEDDED_REGIONS.get(node.name) : undefined;\n  if (regions && node.props && typeof node.props === 'object') {\n    for (const region of regions) {\n      resolveRegionValues(\n        node.props,\n        region.path,\n        `${path}/props`,\n        (value, valuePath) => {\n          if (region.arity === 'component-array') {\n            if (Array.isArray(value)) {\n              value.forEach((child: any, i: number) =>\n                validateEntry(\n                  child,\n                  `${valuePath}/${i}`,\n                  region.reportStructure\n                )\n              );\n            }\n          } else if (\n            value &&\n            typeof value === 'object' &&\n            !Array.isArray(value)\n          ) {\n            validateEntry(value, valuePath, region.reportStructure);\n          }\n        }\n      );\n    }\n  }\n\n  if (Array.isArray(node.children)) {\n    node.children.forEach((child: any, i: number) =>\n      validateEntry(child, `${path}/children/${i}`, true)\n    );\n  } else if (node.children != null && path !== '') {\n    // `children` is present but not an array on a nested container. The root's\n    // `children` is already checked by deepValidateDocument (skipped here via\n    // `path !== ''` so it is not reported twice); this branch covers every\n    // deeper container (`section`/`columns`/`text-box`) the old one-level walk\n    // never reached. Without it a malformed subtree slips through as valid:\n    // TypeBox reports only a generic catch-all (which we strip), so an empty\n    // error set would otherwise flip the document back to `valid`.\n    errors.push({\n      path: `${path}/children`,\n      message: 'Field \"children\" must be an array',\n      code: 'invalid_type',\n    });\n  }\n}\n\n/**\n * Resolve an embedded-region path over a props value and call `visit` with\n * each terminal value. Fixed segments descend into objects; `'*'` fans out\n * over every element of an array. A segment that does not resolve (missing\n * key, `'*'` over a non-array, descent into a non-object) ends that branch\n * silently — the shape is either legal (an optional region) or already\n * reported by the owning component's props validation.\n */\nfunction resolveRegionValues(\n  value: any,\n  segments: readonly string[],\n  path: string,\n  visit: (value: any, path: string) => void\n): void {\n  if (segments.length === 0) {\n    visit(value, path);\n    return;\n  }\n  if (!value || typeof value !== 'object') return;\n\n  const [head, ...rest] = segments;\n  if (head === '*') {\n    if (!Array.isArray(value)) return;\n    value.forEach((item, i) =>\n      resolveRegionValues(item, rest, `${path}/${i}`, visit)\n    );\n    return;\n  }\n  resolveRegionValues(value[head!], rest, `${path}/${head}`, visit);\n}\n\n/**\n * Validate a component's props against its schema\n */\nfunction validateComponentProps(\n  componentName: string,\n  props: any,\n  basePath: string,\n  opts: DeepValidateOptions = {}\n): ValidationError[] {\n  const errors: ValidationError[] = [];\n\n  // Get the schema for this component\n  const schema = COMPONENT_SCHEMAS[componentName];\n  if (!schema) {\n    // Unknown component type. `basePath` always ends in `/props`; anchor the\n    // swap to the end so a nested region path like `…/props/header/0/props`\n    // becomes `…/props/header/0/name` rather than mangling an earlier `/props`.\n    errors.push({\n      path: basePath.replace(/\\/props$/, '/name'),\n      message: `Unknown component \"${componentName}\"`,\n      code: 'unknown_component',\n    });\n    return errors;\n  }\n\n  // A props schema may be a union — `visual` is one, discriminated on\n  // `renderMode`. Checking the union itself collapses every nested complaint\n  // into one generic failure at `/props`, which is the opposite of what deep\n  // validation is for, so the branch the author clearly meant is resolved\n  // first and the errors are collected against that.\n  const branch = selectPropsBranch(schema, props);\n\n  // When unknown fields are explicitly allowed, strip them before checking so\n  // additionalProperties:false no longer rejects — required/typed fields are\n  // still enforced.\n  const toCheck = opts.allowUnknownFields\n    ? Value.Clean(branch, Value.Clone(props))\n    : props;\n\n  // Use TypeBox to validate against the specific schema\n  if (!Value.Check(branch, toCheck)) {\n    const valueErrors = [...Value.Errors(branch, toCheck)];\n    const transformedErrors = transformValueErrors(valueErrors, {\n      maxErrors: 100,\n    });\n\n    // Adjust paths to be relative to the document root\n    transformedErrors.forEach((error) => {\n      // Combine base path with error path\n      const fullPath =\n        error.path === 'root'\n          ? basePath\n          : `${basePath}${error.path.startsWith('/') ? error.path : '/' + error.path}`;\n\n      errors.push({\n        ...error,\n        path: fullPath,\n      });\n    });\n  }\n\n  return errors;\n}\n\n/**\n * The branch of a union props schema that an author's props were written\n * against.\n *\n * Resolved by literal discriminator first — a branch stating `renderMode:\n * \"native\"` claims props that say so, and disclaims props that do not. When no\n * single branch claims them (an unknown discriminator, or none at all), the\n * one that complains least is used: a specific list of what is wrong beats a\n * single \"does not match any of the expected formats\" every time.\n *\n * A non-union schema is returned untouched, so this costs nothing for the\n * components that are plain objects.\n */\nfunction selectPropsBranch(schema: TSchema, props: unknown): TSchema {\n  const branches = (schema as { anyOf?: TSchema[] }).anyOf;\n  if (!Array.isArray(branches) || branches.length === 0) return schema;\n\n  const claimed = branches.filter((branch) => claimsProps(branch, props));\n  if (claimed.length === 1) return claimed[0]!;\n\n  const candidates = claimed.length > 1 ? claimed : branches;\n  let best = candidates[0]!;\n  let fewest = Number.POSITIVE_INFINITY;\n  for (const candidate of candidates) {\n    const count = [...Value.Errors(candidate, props)].length;\n    if (count < fewest) {\n      fewest = count;\n      best = candidate;\n    }\n  }\n  return best;\n}\n\n/** True when every literal-valued property of `branch` agrees with `props`. */\nfunction claimsProps(branch: TSchema, props: unknown): boolean {\n  const properties = (branch as { properties?: Record<string, TSchema> })\n    .properties;\n  if (!properties) return false;\n  const required = new Set(\n    ((branch as { required?: string[] }).required ?? []) as string[]\n  );\n  const value = (props ?? {}) as Record<string, unknown>;\n\n  for (const [key, propertySchema] of Object.entries(properties)) {\n    const literal = (propertySchema as { const?: unknown }).const;\n    if (literal === undefined) continue;\n    const present = value[key] !== undefined;\n    if (!present) {\n      if (required.has(key)) return false;\n      continue;\n    }\n    if (value[key] !== literal) return false;\n  }\n  return true;\n}\n\n/**\n * Combine deep validation with standard validation.\n *\n * Deep validation produces precise, path-aware errors. TypeBox's discriminated-\n * union check, by contrast, often collapses any failure under the root document\n * into a single generic \"Invalid component configuration for 'docx'\" message at\n * `root` — useful as a signal that something is wrong, but actionable only via\n * the deep-validator's output. We always strip that catch-all so it doesn't\n * appear alongside (or, worse, instead of) the real diagnostics.\n */\nexport function comprehensiveValidateDocument(\n  data: any,\n  existingErrors: ValidationError[] = [],\n  opts: DeepValidateOptions = {}\n): ValidationError[] {\n  const deepErrors = deepValidateDocument(data, opts);\n\n  const filteredExisting = existingErrors.filter(\n    (e) => !isGenericUnionCatchAll(e)\n  );\n\n  return deduplicateErrors([...filteredExisting, ...deepErrors]);\n}\n\n/**\n * Detect TypeBox's generic union/discriminator catch-all error at the document\n * root. These messages name the component type ('docx') but give no actionable\n * detail — the deep validator emits the actual path-level errors instead.\n */\nfunction isGenericUnionCatchAll(error: ValidationError): boolean {\n  const atRoot = !error.path || error.path === 'root' || error.path === '/';\n  if (!atRoot) return false;\n  const msg = error.message || '';\n  return (\n    /invalid component configurations?/i.test(msg) ||\n    /invalid document structure/i.test(msg)\n  );\n}\n\n/**\n * Deduplicate errors by path and message\n */\nfunction deduplicateErrors(errors: ValidationError[]): ValidationError[] {\n  const seen = new Set<string>();\n  const unique: ValidationError[] = [];\n\n  for (const error of errors) {\n    const key = `${error.path}:${error.message}`;\n    if (!seen.has(key)) {\n      seen.add(key);\n      unique.push(error);\n    }\n  }\n\n  return unique;\n}\n","/**\n * Base validator implementation\n * Core validation logic that eliminates duplication across the codebase\n */\n\nimport { Value } from '@sinclair/typebox/value';\nimport type { Static, TSchema } from '@sinclair/typebox';\nimport type {\n  ValidationResult,\n  ValidationOptions,\n  JsonValidationResult,\n} from './types';\nimport {\n  transformValueErrors,\n  createJsonParseError,\n  formatErrorSummary,\n} from '@json-to-office/shared';\n\n/**\n * Base validation function that all specific validators use\n * This eliminates the repeated Value.Check -> Value.Errors -> map pattern\n */\nexport function validateAgainstSchema<T extends TSchema>(\n  schema: T,\n  data: unknown,\n  options?: ValidationOptions\n): ValidationResult<Static<T>> {\n  try {\n    // Check if data matches the schema\n    if (!Value.Check(schema, data)) {\n      // Collect ALL errors (not just the first one)\n      const errors = [...Value.Errors(schema, data)];\n      const transformedErrors = transformValueErrors(errors, {\n        jsonString: options?.jsonString,\n        maxErrors: options?.maxErrors || 100, // Default to 100 if not specified\n      });\n\n      return {\n        valid: false,\n        errors: transformedErrors,\n      };\n    }\n\n    // Data is valid, apply transformations if requested\n    let processedData = data;\n\n    if (options?.clean) {\n      // Remove unknown properties\n      processedData = Value.Clean(schema, Value.Clone(processedData));\n    }\n\n    if (options?.applyDefaults) {\n      // Apply default values\n      processedData = Value.Default(schema, processedData);\n    }\n\n    return {\n      valid: true,\n      data: processedData as Static<T>,\n    };\n  } catch (error) {\n    // Handle unexpected errors\n    return {\n      valid: false,\n      errors: [\n        {\n          path: 'root',\n          message:\n            error instanceof Error ? error.message : 'Unknown validation error',\n          code: 'validation_exception',\n        },\n      ],\n    };\n  }\n}\n\n/**\n * Validate JSON string or object with schema\n */\nexport function validateJson<T extends TSchema>(\n  schema: T,\n  jsonInput: string | object,\n  options?: ValidationOptions\n): JsonValidationResult<Static<T>> {\n  // Handle string input\n  if (typeof jsonInput === 'string') {\n    // Basic input validation\n    if (!jsonInput.trim()) {\n      return {\n        valid: false,\n        errors: [\n          {\n            path: 'root',\n            message: 'Input must be a non-empty string',\n            code: 'empty_input',\n          },\n        ],\n        isJsonError: true,\n      };\n    }\n\n    // Try to parse JSON\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(jsonInput);\n    } catch (error) {\n      if (error instanceof Error) {\n        return {\n          valid: false,\n          errors: [createJsonParseError(error, jsonInput)],\n          isJsonError: true,\n        };\n      }\n      return {\n        valid: false,\n        errors: [\n          {\n            path: 'root',\n            message: 'Failed to parse JSON',\n            code: 'json_parse_error',\n          },\n        ],\n        isJsonError: true,\n      };\n    }\n\n    // Validate parsed object with position calculation\n    const result = validateAgainstSchema(schema, parsed, {\n      ...options,\n      jsonString: jsonInput,\n      calculatePosition: true,\n    });\n\n    return {\n      ...result,\n      parsed,\n      isJsonError: false,\n    };\n  }\n\n  // Handle object input directly\n  const result = validateAgainstSchema(schema, jsonInput, options);\n  return {\n    ...result,\n    parsed: jsonInput,\n    isJsonError: false,\n  };\n}\n\n/**\n * Batch validate multiple items\n */\nexport function validateBatch<T extends TSchema>(\n  schema: T,\n  items: unknown[],\n  options?: ValidationOptions\n): ValidationResult<Static<T>[]> {\n  const results: Static<T>[] = [];\n  const allErrors: any[] = [];\n  let hasErrors = false;\n\n  for (let i = 0; i < items.length; i++) {\n    const result = validateAgainstSchema(schema, items[i], options);\n\n    if (result.valid && result.data) {\n      results.push(result.data);\n    } else {\n      hasErrors = true;\n      if (result.errors) {\n        // Prefix errors with item index\n        const prefixedErrors = result.errors.map((e) => ({\n          ...e,\n          path: `[${i}]${e.path ? '/' + e.path : ''}`,\n        }));\n        allErrors.push(...prefixedErrors);\n      }\n    }\n\n    // Stop if we've hit the max errors\n    if (options?.maxErrors && allErrors.length >= options.maxErrors) {\n      break;\n    }\n  }\n\n  if (hasErrors) {\n    return {\n      valid: false,\n      errors: allErrors.slice(0, options?.maxErrors),\n    };\n  }\n\n  return {\n    valid: true,\n    data: results,\n  };\n}\n\n/**\n * Validate with custom error enhancement\n */\nexport function validateWithEnhancement<T extends TSchema>(\n  schema: T,\n  data: unknown,\n  enhancer: (errors: any[]) => any[],\n  options?: ValidationOptions\n): ValidationResult<Static<T>> {\n  const result = validateAgainstSchema(schema, data, options);\n\n  if (!result.valid && result.errors) {\n    result.errors = enhancer(result.errors);\n  }\n\n  return result;\n}\n\n/**\n * Create a validator function for a specific schema\n */\nexport function createValidator<T extends TSchema>(\n  schema: T,\n  defaultOptions?: ValidationOptions\n) {\n  return (data: unknown, options?: ValidationOptions) => {\n    return validateAgainstSchema(schema, data, {\n      ...defaultOptions,\n      ...options,\n    });\n  };\n}\n\n/**\n * Create a JSON validator function for a specific schema\n */\nexport function createJsonValidator<T extends TSchema>(\n  schema: T,\n  defaultOptions?: ValidationOptions\n) {\n  return (jsonInput: string | object, options?: ValidationOptions) => {\n    return validateJson(schema, jsonInput, {\n      ...defaultOptions,\n      ...options,\n    });\n  };\n}\n\n/**\n * Utility to check if validation result is successful with type guard\n */\nexport function isValidationSuccess<T>(\n  result: ValidationResult<T>\n): result is ValidationResult<T> & { valid: true; data: T } {\n  return result.valid === true && result.data !== undefined;\n}\n\n/**\n * Get validation error summary\n */\nexport function getValidationSummary(result: ValidationResult): string {\n  if (result.valid) {\n    return 'Validation successful';\n  }\n\n  if (!result.errors || result.errors.length === 0) {\n    return 'Validation failed with unknown error';\n  }\n\n  return formatErrorSummary(result.errors);\n}\n","/**\n * Document validation implementation\n * Single source of truth for all document validation\n */\n\nimport { Type, type Static, type TSchema } from '@sinclair/typebox';\nimport { Value } from '@sinclair/typebox/value';\nimport {\n  ComponentDefinitionSchema,\n  StandardComponentDefinitionSchema,\n} from '../../schemas/components';\nimport {\n  createComponentSchemaObject,\n  STANDARD_COMPONENTS_REGISTRY,\n} from '../../schemas/component-registry';\nimport { extractStandardComponentNames } from '@json-to-office/shared';\nimport {\n  comprehensiveValidateDocument,\n  collectImageSourceConflicts,\n  collectIndentConflicts,\n  collectNoteRevisionConflicts,\n  collectTextBoxShapeConflicts,\n} from './deep-validator';\n\n// JsonComponentDefinitionSchema is just an alias for ComponentDefinitionSchema\nconst JsonComponentDefinitionSchema = ComponentDefinitionSchema;\nimport type {\n  DocumentValidationResult,\n  ValidationError,\n  ValidationOptions,\n} from './types';\nimport { validateAgainstSchema, validateJson } from './base-validator';\nimport { collectDocxRendererErrors } from '../../schemas/renderer';\n\n/**\n * The semantic rules the structural schema cannot express.\n *\n * Each entry runs unconditionally over the whole document, because every one of\n * them describes a payload TypeBox already accepted: the fields involved are\n * independently optional, and only their combination is wrong.\n *\n * They live in one list because both entry points below need all of them, and a\n * collector wired into only one of the two is invisible until a document takes\n * the other path.\n */\nconst SEMANTIC_COLLECTORS: readonly {\n  readonly why: string;\n  readonly collect: (document: unknown) => ValidationError[];\n}[] = [\n  {\n    // A multi-source image passes the structural check: each source is its own\n    // optional field.\n    why: 'image source mutual-exclusivity',\n    collect: collectImageSourceConflicts,\n  },\n  {\n    why: 'indent hanging/firstLine mutual-exclusivity',\n    collect: collectIndentConflicts,\n  },\n  {\n    // Tracked-change text renders literally, so a note marker inside it never\n    // resolves and docx cannot express the pair anyway.\n    why: 'notes on a revised paragraph',\n    collect: collectNoteRevisionConflicts,\n  },\n  {\n    // A shape has no autofit and its outline carries no dash pattern, so the\n    // request could only ever come back as a table.\n    why: 'a text box asking for a shape rendering a shape cannot give it',\n    collect: collectTextBoxShapeConflicts,\n  },\n  {\n    why: 'renderer profile compatibility',\n    collect: collectDocxRendererErrors,\n  },\n];\n\n/**\n * Run every semantic rule over an already-resolved document — `data` for the\n * object entry point, `result.parsed` for the JSON one.\n */\nfunction collectSemanticConflicts(document: unknown): ValidationError[] {\n  return SEMANTIC_COLLECTORS.flatMap(({ collect }) => collect(document));\n}\n\n/** True when any node anywhere in the tree is a registered plugin component. */\nfunction referencesCustomComponent(node: unknown, names: Set<string>): boolean {\n  if (Array.isArray(node)) {\n    return node.some((item) => referencesCustomComponent(item, names));\n  }\n  if (!node || typeof node !== 'object') return false;\n  const record = node as Record<string, unknown>;\n  if (typeof record.name === 'string' && names.has(record.name)) return true;\n  return Object.values(record).some((value) =>\n    referencesCustomComponent(value, names)\n  );\n}\n\n/**\n * The whole-document schema with every container's children relaxed to the\n * full component union — and ONLY the children.\n *\n * Stage 1 narrows each container to its registry `allowedChildren` (docx →\n * section only, …) as authoring guidance, but the pipeline accepts and renders\n * looser nesting — a heading directly under the root is a pinned behavior. A\n * document that fails stage 1 but passes this schema failed on containment\n * alone.\n *\n * The recursive ref is passed as BOTH the children union and the props\n * factories' `selfRef`, so embedded regions (section header/footer, table\n * cell content) keep their live component typing here. Passing it only as\n * children once left those factories on the static schemas, whose regions are\n * `Type.Any()` — the gate then also relaxed embedded-region typing and\n * re-admitted a wrong-typed sibling key inside a header. Built lazily: only\n * the empty-walk path below ever needs it.\n */\nlet containmentRelaxedSchema: TSchema | undefined;\nfunction getContainmentRelaxedSchema(): TSchema {\n  containmentRelaxedSchema ??= Type.Recursive((This) =>\n    Type.Union(\n      STANDARD_COMPONENTS_REGISTRY.map((component) =>\n        createComponentSchemaObject(component, This, This)\n      )\n    )\n  );\n  return containmentRelaxedSchema;\n}\n\n/**\n * Decide a document that failed stage 1 (the whole-document TypeBox check)\n * while the deep walk found nothing actionable.\n *\n * Stage 1 has exactly three known false-reject classes, each handled by one\n * gate below:\n *\n *  - `allowUnknownFields` — the whole-document schema is\n *    additionalProperties:false throughout, so the unknown keys the caller\n *    asked to tolerate always fail it. The deep walk has already re-checked\n *    every component with unknown props stripped, so its empty result is the\n *    leniency working as designed. Residual risk, documented: under this\n *    option a walk blind spot is still invisible — the caller opted into\n *    unknown content being ignored.\n *  - registered plugin components (`knownCustomNames`) — the static document\n *    schema has no plugin branch, so a document that uses one always fails\n *    stage 1. The walk skipped those nodes for the plugin layer to validate\n *    version-aware. Applies only when the document actually uses a registered\n *    name; registering plugins must not loosen validation of documents that\n *    never mention them. Residual risk, documented: in a document that does\n *    use one, leniency and a walk blind spot cannot be told apart.\n *  - `allowedChildren` containment — stage 1 narrows container children as\n *    authoring guidance, but the pipeline accepts looser nesting (a heading\n *    directly under the root renders fine, and tests pin it). This gate is\n *    precise: the document must pass the containment-relaxed whole-document\n *    schema, so junk that stage 1 rejected for any other reason still fails.\n *\n * Otherwise the empty walk means a walk blind spot, and the document fails\n * CLOSED, keeping stage 1's own generic error. Historically this flipped to\n * valid instead (938bdda, when stage 1's false rejects were the rule), which\n * silently accepted invalid documents — e.g. an unknown key next to\n * `name`/`props`, a position no per-component props check ever sees (#292).\n */\nfunction resolveEmptyWalk(\n  document: unknown,\n  stageOneErrors: ValidationError[],\n  options?: ValidationOptions\n): { valid: boolean; errors: ValidationError[] } {\n  if (\n    options?.allowUnknownFields === true ||\n    (options?.knownCustomNames !== undefined &&\n      options.knownCustomNames.size > 0 &&\n      referencesCustomComponent(document, options.knownCustomNames)) ||\n    Value.Check(getContainmentRelaxedSchema(), document)\n  ) {\n    return { valid: true, errors: [] };\n  }\n\n  const errors =\n    stageOneErrors.length > 0\n      ? stageOneErrors\n      : [\n          {\n            path: 'root',\n            message: \"Document does not match the 'docx' document schema.\",\n            code: 'invalid_document',\n          },\n        ];\n  return {\n    valid: false,\n    errors: [\n      ...errors,\n      {\n        path: 'root',\n        message:\n          'The document was rejected by the whole-document schema, but deep validation ' +\n          'could not localize the fault. Common causes: an unknown key next to \"name\", ' +\n          '\"props\" or \"children\" on some component, or a value at a position the ' +\n          'schema does not declare.',\n        code: 'unlocalized_schema_error',\n      },\n    ],\n  };\n}\n\n/**\n * Stage 2 for a document stage 1 rejected: deep-walk it for path-addressed\n * errors; when the walk comes back empty, let resolveEmptyWalk decide between\n * the audited leniencies and failing closed. Shared by both entry points\n * below so the two cannot drift.\n */\nfunction deepValidateRejected(\n  document: unknown,\n  stageOneErrors: ValidationError[],\n  options?: ValidationOptions\n): { valid: boolean; errors: ValidationError[] } {\n  const errors = comprehensiveValidateDocument(document, stageOneErrors, {\n    allowUnknownFields: options?.allowUnknownFields,\n    knownCustomNames: options?.knownCustomNames,\n  });\n  if (errors.length === 0) {\n    return resolveEmptyWalk(document, stageOneErrors, options);\n  }\n  return { valid: false, errors };\n}\n\n/**\n * Validate a document/report component definition\n */\nexport function validateDocument(\n  data: unknown,\n  options?: ValidationOptions\n): DocumentValidationResult {\n  const result = validateAgainstSchema(\n    ComponentDefinitionSchema,\n    data,\n    options\n  );\n\n  // If validation failed, use deep validation to get all detailed errors\n  let finalErrors = result.errors || [];\n  let finalValid = result.valid;\n  if (!result.valid && data) {\n    ({ valid: finalValid, errors: finalErrors } = deepValidateRejected(\n      data,\n      result.errors || [],\n      options\n    ));\n  }\n\n  // Semantic rules run on every document, valid or not: they describe payloads\n  // the structural check already accepted.\n  const semanticConflicts = collectSemanticConflicts(data);\n  if (semanticConflicts.length > 0) {\n    finalErrors = [...finalErrors, ...semanticConflicts];\n    finalValid = false;\n  }\n\n  // Add document-specific metadata. Keep `data` populated whenever `valid` is\n  // true so `isValidDocument()` (which requires both) stays consistent — when\n  // TypeBox failed and the deep validator cleared the doc, fall back to the\n  // original input as the data payload.\n  const resolvedData =\n    result.data ??\n    (finalValid\n      ? (data as Static<typeof ComponentDefinitionSchema>)\n      : undefined);\n  const documentResult: DocumentValidationResult = {\n    ...result,\n    valid: finalValid,\n    documentType: 'docx',\n    errors: finalErrors,\n    data: resolvedData,\n  };\n\n  // Check if document has custom components\n  if (finalValid) {\n    const doc = resolvedData as any;\n    if (doc && doc.children && Array.isArray(doc.children)) {\n      const hasCustom = doc.children.some(\n        (c: any) => !isStandardComponentName(c.name)\n      );\n      documentResult.hasCustomComponents = hasCustom;\n    }\n  }\n\n  return documentResult;\n}\n\n/**\n * Validate a JSON document (string or object)\n */\nexport function validateJsonDocument(\n  jsonInput: string | object,\n  options?: ValidationOptions\n): DocumentValidationResult {\n  // Use the JSON-specific schema which includes the $schema field\n  const result = validateJson(\n    JsonComponentDefinitionSchema,\n    jsonInput,\n    options\n  );\n\n  // If validation failed, use deep validation to get all detailed errors\n  let finalErrors = result.errors || [];\n  let finalValid = result.valid;\n  if (!result.valid && result.parsed) {\n    ({ valid: finalValid, errors: finalErrors } = deepValidateRejected(\n      result.parsed,\n      result.errors || [],\n      options\n    ));\n  }\n\n  // Semantic rules run on every document, valid or not: they describe payloads\n  // the structural check already accepted.\n  const semanticConflicts = collectSemanticConflicts(result.parsed);\n  if (semanticConflicts.length > 0) {\n    finalErrors = [...finalErrors, ...semanticConflicts];\n    finalValid = false;\n  }\n\n  // Add document-specific metadata. Keep `data` populated whenever `valid` is\n  // true so `isValidDocument()` (which requires both) stays consistent — when\n  // TypeBox failed and the deep validator cleared the doc, fall back to the\n  // parsed input as the data payload.\n  const resolvedData =\n    result.data ??\n    (finalValid\n      ? (result.parsed as Static<typeof ComponentDefinitionSchema>)\n      : undefined);\n  const documentResult: DocumentValidationResult = {\n    ...result,\n    valid: finalValid,\n    documentType: 'docx',\n    errors: finalErrors,\n    data: resolvedData,\n  };\n\n  // Check for custom components\n  if (finalValid) {\n    const doc = resolvedData as any;\n    if (doc && doc.children && Array.isArray(doc.children)) {\n      const hasCustom = doc.children.some(\n        (c: any) => !isStandardComponentName(c.name)\n      );\n      documentResult.hasCustomComponents = hasCustom;\n    }\n  }\n\n  return documentResult;\n}\n\n/**\n * Type guard for document validation result\n */\nexport function isValidDocument(\n  result: DocumentValidationResult\n): result is DocumentValidationResult & {\n  valid: true;\n  data: Static<typeof ComponentDefinitionSchema>;\n} {\n  return result.valid === true && result.data !== undefined;\n}\n\n/**\n * Extract standard component names from the schema (cached)\n */\nfunction getStandardComponentNames(): string[] {\n  return extractStandardComponentNames(StandardComponentDefinitionSchema);\n}\n\n/**\n * Check if a component name is standard\n */\nfunction isStandardComponentName(name: string): boolean {\n  const standardNames = getStandardComponentNames();\n  return standardNames.includes(name);\n}\n\n/**\n * Create a document validator with default options\n */\nexport function createDocumentValidator(defaultOptions?: ValidationOptions) {\n  return {\n    validate: (data: unknown, options?: ValidationOptions) =>\n      validateDocument(data, { ...defaultOptions, ...options }),\n    validateJson: (jsonInput: string | object, options?: ValidationOptions) =>\n      validateJsonDocument(jsonInput, { ...defaultOptions, ...options }),\n  };\n}\n\n// Export convenient validators with common configurations\nexport const documentValidator = createDocumentValidator({\n  clean: true,\n  applyDefaults: true,\n  maxErrors: 100, // Collect up to 100 errors to show all validation issues\n});\n\nexport const strictDocumentValidator = createDocumentValidator({\n  clean: false,\n  applyDefaults: false,\n  maxErrors: 100, // Increased from 10 to show more errors\n});\n\n/**\n * Legacy compatibility exports\n */\nexport const validateJsonComponent = validateJsonDocument;\nexport const validateDocumentWithSchema = validateDocument;\n"],"mappings":";;;;;;;;;;;;;;;;;AAQA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,SAAS,wBACP,OACA,SACQ;AACR,QAAM,UAAU,OAAO,MAAM,QAAQ,EAAE;AACvC,QAAM,OAAO,MAAM,QAAQ;AAG3B,MAAI,YAAY,QAAQ,YAAY,SAAS;AAC3C,WAAO,0BAA0B,KAAK;AAAA,EACxC;AAGA,MAAI,MAAM,SAAS,SAAS,sBAAsB,GAAG;AACnD,WAAO,oCAAoC,KAAK;AAAA,EAClD;AAGA,MAAI,MAAM,SAAS,SAAS,mBAAmB,GAAG;AAChD,WAAO,gCAAgC,KAAK;AAAA,EAC9C;AAGA,MACE,YAAY,YACZ,YAAY,YACZ,YAAY,aACZ,YAAY,WACZ,YAAY,UACZ;AACA,WAAO,4BAA4B,KAAK;AAAA,EAC1C;AAGA,MAAI,YAAY,WAAW;AACzB,WAAO,4BAA4B,KAAK;AAAA,EAC1C;AAGA,MAAI,YAAY,aAAa,YAAY,UAAU;AACjD,WAAO,4BAA4B,KAAK;AAAA,EAC1C;AAGA,SAAO,MAAM,IAAI,KAAK,MAAM,OAAO;AACrC;AAKA,SAAS,0BAA0B,OAA2B;AAC5D,QAAM,OAAO,MAAM,QAAQ;AAC3B,QAAM,QAAQ,MAAM;AAGpB,MAAI,SAAS,UAAU,SAAS,OAAO,SAAS,mBAAmB;AAEjE,QAAI,SAAS,OAAO,UAAU,UAAU;AACtC,UAAI,UAAU,OAAO;AACnB,cAAM,OAAO,MAAM;AACnB,YAAI,SAAS,QAAQ;AACnB,iBAAO;AAAA,QACT;AACA,eAAO,0BAA0B,IAAI;AAAA,MACvC;AAGA,YAAM,WAAW;AACjB,UAAI,cAAc,SAAS,MAAM,QAAQ,SAAS,QAAQ,GAAG;AAC3D,eAAO;AAAA,MACT;AAGA,UAAI,UAAU,SAAS,YAAY,OAAO;AACxC,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAGA,MAAI,KAAK,SAAS,YAAY,GAAG;AAC/B,QAAI,SAAS,OAAO,UAAU,YAAY,UAAU,OAAO;AACzD,YAAM,gBAAiB,MAAc;AACrC,aAAO,6CAA6C,aAAa;AAAA,IACnE;AACA,WAAO;AAAA,EACT;AAGA,SAAO,YAAY,IAAI;AACzB;AAKA,SAAS,oCAAoC,OAA2B;AACtE,QAAM,OAAO,MAAM,QAAQ;AAC3B,QAAM,QAAQ,MAAM;AAEpB,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAE/C,UAAM,SAAS,MAAM;AACrB,QAAI,UAAU,eAAe,MAAM,GAAG;AACpC,YAAM,aAAa,6BAA6B,MAAM;AACtD,YAAM,cAAc,OAAO,KAAK,KAAK;AACrC,YAAM,eAAe,YAAY,OAAO,CAAC,MAAM,CAAC,WAAW,SAAS,CAAC,CAAC;AAEtE,UAAI,aAAa,SAAS,GAAG;AAC3B,eACE,yBAAyB,IAAI,KAAK,aAAa,KAAK,IAAI,CAAC,6BAC9B,WAAW,KAAK,IAAI,CAAC;AAAA,MAEpD;AAAA,IACF;AAAA,EACF;AAEA,SAAO,wCAAwC,IAAI;AACrD;AAKA,SAAS,gCAAgC,OAA2B;AAClE,QAAM,OAAO,MAAM,QAAQ;AAC3B,QAAM,QAAQ,MAAM,SAAS,MAAM,6BAA6B;AAEhE,MAAI,OAAO;AACT,UAAM,WAAW,MAAM,CAAC;AACxB,WAAO,2BAA2B,QAAQ,QAAQ,IAAI;AAAA,EACxD;AAEA,SAAO,gCAAgC,IAAI;AAC7C;AAKA,SAAS,4BAA4B,OAA2B;AAC9D,QAAM,OAAO,MAAM,QAAQ;AAC3B,QAAM,eAAe,OAAO,MAAM,IAAI;AACtC,QAAM,aAAa,MAAM,QAAQ,MAAM,KAAK,IAAI,UAAU,OAAO,MAAM;AAGvE,MAAI,KAAK,SAAS,WAAW,GAAG;AAC9B,WAAO,8BAA8B,IAAI;AAAA,EAC3C;AAEA,MAAI,KAAK,SAAS,OAAO,GAAG;AAC1B,WAAO,0BAA0B,IAAI;AAAA,EACvC;AAEA,MAAI,KAAK,SAAS,UAAU,KAAK,KAAK,SAAS,MAAM,GAAG;AACtD,WAAO,yBAAyB,IAAI;AAAA,EACtC;AAEA,MACE,KAAK,SAAS,QAAQ,KACtB,KAAK,SAAS,SAAS,KACvB,KAAK,SAAS,SAAS,GACvB;AACA,WAAO,4BAA4B,IAAI;AAAA,EACzC;AAEA,SAAO,oBAAoB,IAAI,cAAc,YAAY,YAAY,UAAU;AACjF;AAKA,SAAS,4BAA4B,OAA2B;AAC9D,QAAM,OAAO,MAAM,QAAQ;AAC3B,QAAM,WAAW,MAAM,SACnB,KAAK,UAAU,gBAAgB,MAAM,MAAM,CAAC,IAC5C;AACJ,QAAM,SAAS,KAAK,UAAU,MAAM,KAAK;AAEzC,SAAO,oBAAoB,IAAI,sBAAsB,QAAQ,YAAY,MAAM;AACjF;AAKA,SAAS,4BAA4B,OAA2B;AAC9D,QAAM,OAAO,MAAM,QAAQ;AAG3B,MAAI,KAAK,SAAS,OAAO,GAAG;AAC1B,WAAO,2BAA2B,IAAI;AAAA,EACxC;AAEA,MAAI,KAAK,SAAS,KAAK,KAAK,KAAK,SAAS,MAAM,GAAG;AACjD,WAAO,yBAAyB,IAAI;AAAA,EACtC;AAEA,MAAI,KAAK,SAAS,MAAM,GAAG;AACzB,WAAO,0BAA0B,IAAI;AAAA,EACvC;AAEA,MAAI,KAAK,SAAS,OAAO,GAAG;AAC1B,WAAO,kCAAkC,IAAI;AAAA,EAC/C;AAEA,SAAO,YAAY,IAAI;AACzB;AAKO,SAAS,oBACd,OACA,YACA,QACiB;AACjB,QAAM,kBAAkB,kBAAkB,MAAM;AAGhD,QAAM,kBAAkB,wBAAwB,OAAO,eAAe;AAEtE,QAAM,YAA6B;AAAA,IACjC,MAAM,MAAM,QAAQ;AAAA,IACpB,SAAS;AAAA,MACP,mBAAmB,MAAM;AAAA,MACzB;AAAA,IACF;AAAA,IACA,MAAM,OAAO,MAAM,QAAQ,kBAAkB;AAAA,IAC7C,OAAO,MAAM;AAAA,EACf;AAGA,MAAI,gBAAgB,oBAAoB;AACtC,UAAM,aAAa,cAAc,OAAO,eAAe;AACvD,QAAI,YAAY;AACd,gBAAU,aAAa,mBAAmB,YAAY,eAAe;AAAA,IACvE;AAAA,EACF;AAGA,MAAI,cAAc,MAAM,MAAM;AAC5B,UAAM,WAAW,kBAAkB,YAAY,MAAM,IAAI;AACzD,QAAI,UAAU;AACZ,gBAAU,OAAO,SAAS;AAC1B,gBAAU,SAAS,SAAS;AAAA,IAC9B;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,qBACd,QACA,SAImB;AACnB,QAAM,YAAY,SAAS,aAAa,OAAO;AAC/C,QAAM,SAA4B,CAAC;AACnC,QAAM,YAAY,oBAAI,IAAY;AAGlC,aAAW,SAAS,QAAQ;AAC1B,QAAI,OAAO,UAAU,UAAW;AAGhC,UAAM,WAAW,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI;AAI5C,QAAI,CAAC,UAAU,IAAI,QAAQ,GAAG;AAC5B,gBAAU,IAAI,QAAQ;AACtB,aAAO,KAAK,oBAAoB,OAAO,SAAS,YAAY,MAAS,CAAC;AAAA,IACxE;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,kBACd,YACA,MACyC;AACzC,MAAI;AAEF,UAAM,YAAY,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAChD,QAAI,UAAU,WAAW,GAAG;AAC1B,aAAO,EAAE,MAAM,GAAG,QAAQ,EAAE;AAAA,IAC9B;AAGA,UAAM,WAAW,UAAU,UAAU,SAAS,CAAC;AAC/C,UAAM,gBAAgB,IAAI,QAAQ;AAClC,UAAM,QAAQ,WAAW,QAAQ,aAAa;AAE9C,QAAI,UAAU,IAAI;AAEhB,aAAO,EAAE,MAAM,GAAG,QAAQ,EAAE;AAAA,IAC9B;AAGA,UAAM,cAAc,WAAW,UAAU,GAAG,KAAK;AACjD,UAAM,QAAQ,YAAY,MAAM,IAAI;AACpC,UAAM,OAAO,MAAM;AACnB,UAAM,SAAS,MAAM,MAAM,SAAS,CAAC,EAAE,SAAS;AAEhD,WAAO,EAAE,MAAM,OAAO;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKA,SAAS,cACP,OACA,QACoB;AACpB,QAAM,EAAE,MAAM,MAAM,MAAM,IAAI;AAC9B,QAAM,UAAU,OAAO,IAAI;AAG3B,MAAI,YAAY,QAAQ,YAAY,SAAS;AAC3C,QAAI,SAAS,UAAU,SAAS,KAAK;AACnC,UAAI,SAAS,OAAO,UAAU,UAAU;AACtC,YAAI,EAAE,UAAU,QAAQ;AACtB,gBAAM,MAAM;AACZ,iBAAO,OAAO,gBAAgB,GAAG,aAAa,GAAG,IAAI,GAAG,KAAK;AAAA,QAC/D;AACA,YAAI,WAAW,SAAS,OAAO,MAAM,UAAU,UAAU;AACvD,gBAAM,cAAc,6BAA6B,iBAAiB;AAClE,iBAAO,oEAAoE,YAAY,KAAK,IAAI,CAAC;AAAA,QACnG;AAAA,MACF;AACA,aAAO;AAAA,IACT;AACA,QAAI,MAAM,SAAS,YAAY,GAAG;AAChC,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAGA,MAAI,MAAM,SAAS,SAAS,sBAAsB,GAAG;AACnD,WAAO;AAAA,EACT;AAGA,MAAI,MAAM,SAAS,SAAS,mBAAmB,GAAG;AAChD,WAAO;AAAA,EACT;AAGA,MAAI,YAAY,UAAU;AACxB,QAAI,MAAM,SAAS,WAAW,GAAG;AAC/B,aAAO;AAAA,IACT;AACA,QAAI,MAAM,SAAS,OAAO,GAAG;AAC3B,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,UAAU;AACxB,QAAI,MAAM,SAAS,UAAU,KAAK,MAAM,SAAS,MAAM,GAAG;AACxD,aAAO;AAAA,IACT;AACA,QAAI,MAAM,SAAS,QAAQ,KAAK,MAAM,SAAS,SAAS,GAAG;AACzD,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,WAAW;AACzB,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,SAAS;AACvB,QAAI,MAAM,SAAS,UAAU,GAAG;AAC9B,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,UAAU;AACxB,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,WAAW;AACzB,UAAM,WAAW,MAAM,SACnB,KAAK,UAAU,gBAAgB,MAAM,MAAM,CAAC,IAC5C;AACJ,WAAO,2BAA2B,QAAQ;AAAA,EAC5C;AAEA,MAAI,YAAY,aAAa,YAAY,UAAU;AACjD,QAAI,MAAM,SAAS,OAAO,GAAG;AAC3B,aAAO;AAAA,IACT;AACA,QAAI,MAAM,SAAS,KAAK,GAAG;AACzB,aAAO;AAAA,IACT;AACA,QAAI,MAAM,SAAS,MAAM,GAAG;AAC1B,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAGA,MAAI,MAAM,SAAS,MAAM,KAAK,MAAM,SAAS,MAAM,GAAG;AACpD,WAAO;AAAA,EACT;AAEA,SAAO;AACT;;;ACrbA,SAAS,aAAa;AAUtB,IAAM,oBAA6C,OAAO,YAAY;AAAA,EACpE,GAAG,6BAA6B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC;AAAA,EAClE,CAAC,UAAU,+BAA+B;AAC5C,CAAC;AAOD,IAAM,mBAAmB,IAAI;AAAA,EAC3B,6BAA6B;AAAA,IAC3B,CAAC,OAAO,EAAE,oBAAoB,UAAU,KAAK;AAAA,EAC/C,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,kBAAmB,CAAC;AAC9C;AAGA,IAAM,uBAAuB,IAAI;AAAA,EAC/B,6BAA6B;AAAA,IAAO,CAAC,MACnC,QAAQ,EAAE,SAAS,cAAc;AAAA,EACnC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI;AACrB;AAOA,IAAM,uBAAiE,IAAI;AAAA,EACzE,6BAA6B,IAAI,CAAC,MAAM;AAAA,IACtC,EAAE;AAAA,IACF,oBAAI,IAAI;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,GAAI,EAAE,cAAc,CAAC,UAAU,IAAI,CAAC;AAAA,MACpC,GAAI,EAAE,SAAS,iBAAiB,CAAC,WAAW,UAAU,IAAI,CAAC;AAAA,IAC7D,CAAC;AAAA,EACH,CAAC;AACH;AAIA,IAAM,oBAA0D;AAAA,EAC9D,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,SAAS;AAAA,EACT,UAAU;AACZ;AAUA,SAAS,wBACP,MACA,MACA,MACA,QACM;AACN,QAAM,UACJ,OAAO,KAAK,SAAS,WACjB,qBAAqB,IAAI,KAAK,IAAI,IAClC;AACN,MAAI,CAAC,QAAS;AACd,aAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,QAAI,CAAC,QAAQ,IAAI,GAAG,GAAG;AACrB,UAAI,KAAK,mBAAoB;AAC7B,aAAO,KAAK;AAAA,QACV,MAAM,GAAG,IAAI,IAAI,GAAG;AAAA,QACpB,SAAS,gBAAgB,GAAG,mBAAmB,KAAK,IAAI,oBAAoB;AAAA,UAC1E,GAAG;AAAA,QACL,EAAE,KAAK,IAAI,CAAC;AAAA,QACZ,MAAM;AAAA,MACR,CAAC;AACD;AAAA,IACF;AACA,UAAM,WAAW,kBAAkB,GAAG;AACtC,QAAI,YAAY,OAAO,KAAK,GAAG,MAAM,UAAU;AAC7C,aAAO,KAAK;AAAA,QACV,MAAM,GAAG,IAAI,IAAI,GAAG;AAAA,QACpB,SAAS,QAAQ,GAAG,mBAAmB,KAAK,IAAI,eAAe,QAAQ;AAAA,QACvE,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAmBA,IAAM,sBAAsB,CAAC,QAAQ,UAAU,KAAK;AAK7C,SAAS,oBAAoB,OAA0B;AAC5D,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO,CAAC;AACjD,QAAM,IAAI;AACV,SAAO,oBAAoB,OAAO,CAAC,MAAM;AACvC,UAAM,IAAI,EAAE,CAAC;AACb,WAAO,OAAO,MAAM,YAAY,EAAE,KAAK,EAAE,SAAS;AAAA,EACpD,CAAC;AACH;AAaO,SAAS,4BAA4B,MAAkC;AAC5E,QAAM,SAA4B,CAAC;AAEnC,QAAM,QAAQ,CAAC,MAAW,SAAuB;AAC/C,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,WAAK,QAAQ,CAAC,MAAM,MAAM,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;AACrD;AAAA,IACF;AACA,QAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AAEvC,QAAI,KAAK,SAAS,SAAS;AACzB,YAAM,UAAU,oBAAoB,KAAK,KAAK;AAC9C,UAAI,QAAQ,SAAS,GAAG;AACtB,eAAO,KAAK;AAAA,UACV,MAAM,GAAG,IAAI;AAAA,UACb,SAAS,sDAAsD,QAC5D,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EACnB,KAAK,IAAI,CAAC;AAAA,UACb,MAAM;AAAA,QACR,CAAC;AAAA,MACH;AAAA,IACF;AAEA,eAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,YAAM,KAAK,GAAG,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE;AAAA,IACnC;AAAA,EACF;AAEA,QAAM,MAAM,EAAE;AACd,SAAO;AACT;AAIA,IAAM,yBAAyB,oBAAI,IAAI,CAAC,aAAa,SAAS,CAAC;AAaxD,SAAS,uBAAuB,MAAkC;AACvE,QAAM,SAA4B,CAAC;AAEnC,QAAM,QAAQ,CAAC,MAAW,SAAuB;AAC/C,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,WAAK,QAAQ,CAAC,MAAM,MAAM,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;AACrD;AAAA,IACF;AACA,QAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AAEvC,QAAI,uBAAuB,IAAI,KAAK,IAAI,GAAG;AACzC,YAAM,SAAS,KAAK,OAAO;AAC3B,UACE,UACA,OAAO,WAAW,YAClB,OAAO,YAAY,UACnB,OAAO,cAAc,QACrB;AACA,eAAO,KAAK;AAAA,UACV,MAAM,GAAG,IAAI;AAAA,UACb,SACE;AAAA,UACF,MAAM;AAAA,QACR,CAAC;AAAA,MACH;AAAA,IACF;AAEA,eAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,YAAM,KAAK,GAAG,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE;AAAA,IACnC;AAAA,EACF;AAEA,QAAM,MAAM,EAAE;AACd,SAAO;AACT;AAmBO,SAAS,6BAA6B,MAAkC;AAC7E,QAAM,SAA4B,CAAC;AAEnC,QAAM,QAAQ,CAAC,MAAW,SAAuB;AAC/C,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,WAAK,QAAQ,CAAC,MAAM,MAAM,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;AACrD;AAAA,IACF;AACA,QAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AAKvC,UAAM,eAAmD,CAAC;AAC1D,QAAI,KAAK,SAAS,eAAe,KAAK,OAAO,UAAU;AACrD,iBAAW,QAAQ,CAAC,aAAa,UAAU,GAAY;AACrD,qBAAa,KAAK;AAAA,UAChB,OAAO,KAAK,MAAM,IAAI;AAAA,UACtB,MAAM,GAAG,IAAI,UAAU,IAAI;AAAA,QAC7B,CAAC;AAAA,MACH;AAAA,IACF;AACA,QAAI,KAAK,YAAY,KAAK,SAAS,SAAS,aAAa;AACvD,iBAAW,QAAQ,CAAC,aAAa,UAAU,GAAY;AACrD,qBAAa,KAAK;AAAA,UAChB,OAAO,KAAK,QAAQ,QAAQ,IAAI;AAAA,UAChC,MAAM,GAAG,IAAI,kBAAkB,IAAI;AAAA,QACrC,CAAC;AAAA,MACH;AAAA,IACF;AAEA,eAAW,EAAE,OAAO,MAAM,UAAU,KAAK,cAAc;AACrD,UAAI,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,GAAG;AAC5C,cAAM,OAAO,UAAU,SAAS,UAAU,IAAI,aAAa;AAC3D,eAAO,KAAK;AAAA,UACV,MAAM;AAAA,UACN,SACE,mBAAmB,IAAI;AAAA,UAGzB,MAAM;AAAA,QACR,CAAC;AAAA,MACH;AAAA,IACF;AAEA,eAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,YAAM,KAAK,GAAG,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE;AAAA,IACnC;AAAA,EACF;AAEA,QAAM,MAAM,EAAE;AACd,SAAO;AACT;AA2BA,IAAM,2BAA2B,oBAAI,IAAI,CAAC,UAAU,UAAU,QAAQ,CAAC;AAEhE,SAAS,6BAA6B,MAAkC;AAC7E,QAAM,SAA4B,CAAC;AAEnC,QAAM,QAAQ,CAAC,MAAW,SAAuB;AAC/C,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,WAAK,QAAQ,CAAC,MAAM,MAAM,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;AACrD;AAAA,IACF;AACA,QAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AAEvC,QAAI,KAAK,SAAS,cAAc,KAAK,OAAO,aAAa,SAAS;AAChE,YAAM,UAAW,CAAC,SAAS,QAAQ,EAAY;AAAA,QAC7C,CAAC,SAAS,KAAK,MAAM,IAAI,MAAM;AAAA,MACjC;AACA,UAAI,QAAQ,SAAS,GAAG;AACtB,eAAO,KAAK;AAAA,UACV,MAAM,GAAG,IAAI,UAAU,QAAQ,CAAC,CAAC;AAAA,UACjC,SACE,6CAA6C,QAAQ,KAAK,OAAO,CAAC;AAAA,UAGpE,MAAM;AAAA,QACR,CAAC;AAAA,MACH;AAEA,YAAM,SAAS,KAAK,MAAM,OAAO;AACjC,UAAI,UAAU,OAAO,WAAW,UAAU;AACxC,mBAAW,QAAQ,CAAC,OAAO,SAAS,UAAU,MAAM,GAAY;AAC9D,gBAAM,QAAQ,OAAO,IAAI,GAAG;AAC5B,cACE,OAAO,UAAU,YACjB,yBAAyB,IAAI,KAAK,GAClC;AACA,mBAAO,KAAK;AAAA,cACV,MAAM,GAAG,IAAI,uBAAuB,IAAI;AAAA,cACxC,SACE,mDAAmD,KAAK;AAAA,cAG1D,MAAM;AAAA,YACR,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,eAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,YAAM,KAAK,GAAG,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE;AAAA,IACnC;AAAA,EACF;AAEA,QAAM,MAAM,EAAE;AACd,SAAO;AACT;AAKO,SAAS,qBACd,MACA,OAA4B,CAAC,GACV;AACnB,QAAM,YAA+B,CAAC;AAGtC,MAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,MACT,MAAM;AAAA,IACR,CAAC;AACD,WAAO;AAAA,EACT;AAGA,MAAI,CAAC,KAAK,MAAM;AACd,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,MACT,MAAM;AAAA,IACR,CAAC;AAAA,EACH,WAAW,CAAC,qBAAqB,IAAI,KAAK,IAAI,GAAG;AAC/C,UAAM,WAAW,CAAC,GAAG,oBAAoB,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AACzE,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS,iBAAiB,KAAK,IAAI,eAAe,QAAQ;AAAA,MAC1D,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAIA,0BAAwB,MAAM,IAAI,MAAM,SAAS;AAKjD,MAAI,qBAAqB,IAAI,KAAK,IAAI,KAAK,WAAW,MAAM;AAC1D,UAAM,cAAc;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA;AAAA,IACF;AACA,cAAU,KAAK,GAAG,WAAW;AAAA,EAC/B;AAIA,MAAI,CAAC,KAAK,UAAU;AAClB,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,MACT,MAAM;AAAA,IACR,CAAC;AAAA,EACH,WAAW,CAAC,MAAM,QAAQ,KAAK,QAAQ,GAAG;AACxC,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,MACT,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AAeA,oBAAkB,MAAM,IAAI,MAAM,SAAS;AAE3C,SAAO;AACT;AAkBA,SAAS,kBACP,MACA,MACA,MACA,QACM;AACN,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AAWvC,QAAM,gBAAgB,CACpB,OACA,WACA,oBACS;AACT,QAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,UAAI,iBAAiB;AACnB,eAAO,KAAK;AAAA,UACV,MAAM;AAAA,UACN,SAAS;AAAA,UACT,MAAM;AAAA,QACR,CAAC;AAAA,MACH;AACA;AAAA,IACF;AACA,QAAI,OAAO,MAAM,SAAS,YAAY,MAAM,KAAK,WAAW,GAAG;AAC7D,UAAI,iBAAiB;AACnB,eAAO,KAAK;AAAA,UACV,MAAM,GAAG,SAAS;AAAA,UAClB,SAAS;AAAA,UACT,MAAM;AAAA,QACR,CAAC;AAAA,MACH;AACA;AAAA,IACF;AAKA,QAAI,KAAK,kBAAkB,IAAI,MAAM,IAAI,EAAG;AAG5C,4BAAwB,OAAO,WAAW,MAAM,MAAM;AAStD,QAAI,WAAW,OAAO;AACpB,aAAO;AAAA,QACL,GAAG;AAAA,UACD,MAAM;AAAA,UACN,MAAM;AAAA,UACN,GAAG,SAAS;AAAA,UACZ;AAAA,QACF;AAAA,MACF;AAAA,IACF,WAAW,MAAM,SAAS,UAAU;AAClC,aAAO;AAAA,QACL,GAAG,uBAAuB,MAAM,MAAM,CAAC,GAAG,GAAG,SAAS,UAAU,IAAI;AAAA,MACtE;AAAA,IACF;AAGA,sBAAkB,OAAO,WAAW,MAAM,MAAM;AAAA,EAClD;AAMA,QAAM,UACJ,OAAO,KAAK,SAAS,WAAW,iBAAiB,IAAI,KAAK,IAAI,IAAI;AACpE,MAAI,WAAW,KAAK,SAAS,OAAO,KAAK,UAAU,UAAU;AAC3D,eAAW,UAAU,SAAS;AAC5B;AAAA,QACE,KAAK;AAAA,QACL,OAAO;AAAA,QACP,GAAG,IAAI;AAAA,QACP,CAAC,OAAO,cAAc;AACpB,cAAI,OAAO,UAAU,mBAAmB;AACtC,gBAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,oBAAM;AAAA,gBAAQ,CAAC,OAAY,MACzB;AAAA,kBACE;AAAA,kBACA,GAAG,SAAS,IAAI,CAAC;AAAA,kBACjB,OAAO;AAAA,gBACT;AAAA,cACF;AAAA,YACF;AAAA,UACF,WACE,SACA,OAAO,UAAU,YACjB,CAAC,MAAM,QAAQ,KAAK,GACpB;AACA,0BAAc,OAAO,WAAW,OAAO,eAAe;AAAA,UACxD;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,QAAQ,KAAK,QAAQ,GAAG;AAChC,SAAK,SAAS;AAAA,MAAQ,CAAC,OAAY,MACjC,cAAc,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,IAAI;AAAA,IACpD;AAAA,EACF,WAAW,KAAK,YAAY,QAAQ,SAAS,IAAI;AAQ/C,WAAO,KAAK;AAAA,MACV,MAAM,GAAG,IAAI;AAAA,MACb,SAAS;AAAA,MACT,MAAM;AAAA,IACR,CAAC;AAAA,EACH;AACF;AAUA,SAAS,oBACP,OACA,UACA,MACA,OACM;AACN,MAAI,SAAS,WAAW,GAAG;AACzB,UAAM,OAAO,IAAI;AACjB;AAAA,EACF;AACA,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU;AAEzC,QAAM,CAAC,MAAM,GAAG,IAAI,IAAI;AACxB,MAAI,SAAS,KAAK;AAChB,QAAI,CAAC,MAAM,QAAQ,KAAK,EAAG;AAC3B,UAAM;AAAA,MAAQ,CAAC,MAAM,MACnB,oBAAoB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,KAAK;AAAA,IACvD;AACA;AAAA,EACF;AACA,sBAAoB,MAAM,IAAK,GAAG,MAAM,GAAG,IAAI,IAAI,IAAI,IAAI,KAAK;AAClE;AAKA,SAAS,uBACP,eACA,OACA,UACA,OAA4B,CAAC,GACV;AACnB,QAAM,SAA4B,CAAC;AAGnC,QAAM,SAAS,kBAAkB,aAAa;AAC9C,MAAI,CAAC,QAAQ;AAIX,WAAO,KAAK;AAAA,MACV,MAAM,SAAS,QAAQ,YAAY,OAAO;AAAA,MAC1C,SAAS,sBAAsB,aAAa;AAAA,MAC5C,MAAM;AAAA,IACR,CAAC;AACD,WAAO;AAAA,EACT;AAOA,QAAM,SAAS,kBAAkB,QAAQ,KAAK;AAK9C,QAAM,UAAU,KAAK,qBACjB,MAAM,MAAM,QAAQ,MAAM,MAAM,KAAK,CAAC,IACtC;AAGJ,MAAI,CAAC,MAAM,MAAM,QAAQ,OAAO,GAAG;AACjC,UAAM,cAAc,CAAC,GAAG,MAAM,OAAO,QAAQ,OAAO,CAAC;AACrD,UAAM,oBAAoB,qBAAqB,aAAa;AAAA,MAC1D,WAAW;AAAA,IACb,CAAC;AAGD,sBAAkB,QAAQ,CAAC,UAAU;AAEnC,YAAM,WACJ,MAAM,SAAS,SACX,WACA,GAAG,QAAQ,GAAG,MAAM,KAAK,WAAW,GAAG,IAAI,MAAM,OAAO,MAAM,MAAM,IAAI;AAE9E,aAAO,KAAK;AAAA,QACV,GAAG;AAAA,QACH,MAAM;AAAA,MACR,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAeA,SAAS,kBAAkB,QAAiB,OAAyB;AACnE,QAAM,WAAY,OAAiC;AACnD,MAAI,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,WAAW,EAAG,QAAO;AAE9D,QAAM,UAAU,SAAS,OAAO,CAAC,WAAW,YAAY,QAAQ,KAAK,CAAC;AACtE,MAAI,QAAQ,WAAW,EAAG,QAAO,QAAQ,CAAC;AAE1C,QAAM,aAAa,QAAQ,SAAS,IAAI,UAAU;AAClD,MAAI,OAAO,WAAW,CAAC;AACvB,MAAI,SAAS,OAAO;AACpB,aAAW,aAAa,YAAY;AAClC,UAAM,QAAQ,CAAC,GAAG,MAAM,OAAO,WAAW,KAAK,CAAC,EAAE;AAClD,QAAI,QAAQ,QAAQ;AAClB,eAAS;AACT,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAGA,SAAS,YAAY,QAAiB,OAAyB;AAC7D,QAAM,aAAc,OACjB;AACH,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,WAAW,IAAI;AAAA,IACjB,OAAmC,YAAY,CAAC;AAAA,EACpD;AACA,QAAM,QAAS,SAAS,CAAC;AAEzB,aAAW,CAAC,KAAK,cAAc,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC9D,UAAM,UAAW,eAAuC;AACxD,QAAI,YAAY,OAAW;AAC3B,UAAM,UAAU,MAAM,GAAG,MAAM;AAC/B,QAAI,CAAC,SAAS;AACZ,UAAI,SAAS,IAAI,GAAG,EAAG,QAAO;AAC9B;AAAA,IACF;AACA,QAAI,MAAM,GAAG,MAAM,QAAS,QAAO;AAAA,EACrC;AACA,SAAO;AACT;AAYO,SAAS,8BACd,MACA,iBAAoC,CAAC,GACrC,OAA4B,CAAC,GACV;AACnB,QAAM,aAAa,qBAAqB,MAAM,IAAI;AAElD,QAAM,mBAAmB,eAAe;AAAA,IACtC,CAAC,MAAM,CAAC,uBAAuB,CAAC;AAAA,EAClC;AAEA,SAAO,kBAAkB,CAAC,GAAG,kBAAkB,GAAG,UAAU,CAAC;AAC/D;AAOA,SAAS,uBAAuB,OAAiC;AAC/D,QAAM,SAAS,CAAC,MAAM,QAAQ,MAAM,SAAS,UAAU,MAAM,SAAS;AACtE,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,MAAM,MAAM,WAAW;AAC7B,SACE,qCAAqC,KAAK,GAAG,KAC7C,8BAA8B,KAAK,GAAG;AAE1C;AAKA,SAAS,kBAAkB,QAA8C;AACvE,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,SAA4B,CAAC;AAEnC,aAAW,SAAS,QAAQ;AAC1B,UAAM,MAAM,GAAG,MAAM,IAAI,IAAI,MAAM,OAAO;AAC1C,QAAI,CAAC,KAAK,IAAI,GAAG,GAAG;AAClB,WAAK,IAAI,GAAG;AACZ,aAAO,KAAK,KAAK;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AACT;;;ACrzBA,SAAS,SAAAA,cAAa;AAOtB;AAAA,EACE,wBAAAC;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMA,SAAS,sBACd,QACA,MACA,SAC6B;AAC7B,MAAI;AAEF,QAAI,CAACD,OAAM,MAAM,QAAQ,IAAI,GAAG;AAE9B,YAAM,SAAS,CAAC,GAAGA,OAAM,OAAO,QAAQ,IAAI,CAAC;AAC7C,YAAM,oBAAoBC,sBAAqB,QAAQ;AAAA,QACrD,YAAY,SAAS;AAAA,QACrB,WAAW,SAAS,aAAa;AAAA;AAAA,MACnC,CAAC;AAED,aAAO;AAAA,QACL,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,IACF;AAGA,QAAI,gBAAgB;AAEpB,QAAI,SAAS,OAAO;AAElB,sBAAgBD,OAAM,MAAM,QAAQA,OAAM,MAAM,aAAa,CAAC;AAAA,IAChE;AAEA,QAAI,SAAS,eAAe;AAE1B,sBAAgBA,OAAM,QAAQ,QAAQ,aAAa;AAAA,IACrD;AAEA,WAAO;AAAA,MACL,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF,SAAS,OAAO;AAEd,WAAO;AAAA,MACL,OAAO;AAAA,MACP,QAAQ;AAAA,QACN;AAAA,UACE,MAAM;AAAA,UACN,SACE,iBAAiB,QAAQ,MAAM,UAAU;AAAA,UAC3C,MAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAKO,SAAS,aACd,QACA,WACA,SACiC;AAEjC,MAAI,OAAO,cAAc,UAAU;AAEjC,QAAI,CAAC,UAAU,KAAK,GAAG;AACrB,aAAO;AAAA,QACL,OAAO;AAAA,QACP,QAAQ;AAAA,UACN;AAAA,YACE,MAAM;AAAA,YACN,SAAS;AAAA,YACT,MAAM;AAAA,UACR;AAAA,QACF;AAAA,QACA,aAAa;AAAA,MACf;AAAA,IACF;AAGA,QAAI;AACJ,QAAI;AACF,eAAS,KAAK,MAAM,SAAS;AAAA,IAC/B,SAAS,OAAO;AACd,UAAI,iBAAiB,OAAO;AAC1B,eAAO;AAAA,UACL,OAAO;AAAA,UACP,QAAQ,CAAC,qBAAqB,OAAO,SAAS,CAAC;AAAA,UAC/C,aAAa;AAAA,QACf;AAAA,MACF;AACA,aAAO;AAAA,QACL,OAAO;AAAA,QACP,QAAQ;AAAA,UACN;AAAA,YACE,MAAM;AAAA,YACN,SAAS;AAAA,YACT,MAAM;AAAA,UACR;AAAA,QACF;AAAA,QACA,aAAa;AAAA,MACf;AAAA,IACF;AAGA,UAAME,UAAS,sBAAsB,QAAQ,QAAQ;AAAA,MACnD,GAAG;AAAA,MACH,YAAY;AAAA,MACZ,mBAAmB;AAAA,IACrB,CAAC;AAED,WAAO;AAAA,MACL,GAAGA;AAAA,MACH;AAAA,MACA,aAAa;AAAA,IACf;AAAA,EACF;AAGA,QAAM,SAAS,sBAAsB,QAAQ,WAAW,OAAO;AAC/D,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ;AAAA,IACR,aAAa;AAAA,EACf;AACF;AAKO,SAAS,cACd,QACA,OACA,SAC+B;AAC/B,QAAM,UAAuB,CAAC;AAC9B,QAAM,YAAmB,CAAC;AAC1B,MAAI,YAAY;AAEhB,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,SAAS,sBAAsB,QAAQ,MAAM,CAAC,GAAG,OAAO;AAE9D,QAAI,OAAO,SAAS,OAAO,MAAM;AAC/B,cAAQ,KAAK,OAAO,IAAI;AAAA,IAC1B,OAAO;AACL,kBAAY;AACZ,UAAI,OAAO,QAAQ;AAEjB,cAAM,iBAAiB,OAAO,OAAO,IAAI,CAAC,OAAO;AAAA,UAC/C,GAAG;AAAA,UACH,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,MAAM,EAAE,OAAO,EAAE;AAAA,QAC3C,EAAE;AACF,kBAAU,KAAK,GAAG,cAAc;AAAA,MAClC;AAAA,IACF;AAGA,QAAI,SAAS,aAAa,UAAU,UAAU,QAAQ,WAAW;AAC/D;AAAA,IACF;AAAA,EACF;AAEA,MAAI,WAAW;AACb,WAAO;AAAA,MACL,OAAO;AAAA,MACP,QAAQ,UAAU,MAAM,GAAG,SAAS,SAAS;AAAA,IAC/C;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,IACP,MAAM;AAAA,EACR;AACF;AAKO,SAAS,wBACd,QACA,MACA,UACA,SAC6B;AAC7B,QAAM,SAAS,sBAAsB,QAAQ,MAAM,OAAO;AAE1D,MAAI,CAAC,OAAO,SAAS,OAAO,QAAQ;AAClC,WAAO,SAAS,SAAS,OAAO,MAAM;AAAA,EACxC;AAEA,SAAO;AACT;AAKO,SAAS,gBACd,QACA,gBACA;AACA,SAAO,CAAC,MAAe,YAAgC;AACrD,WAAO,sBAAsB,QAAQ,MAAM;AAAA,MACzC,GAAG;AAAA,MACH,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;AAKO,SAAS,oBACd,QACA,gBACA;AACA,SAAO,CAAC,WAA4B,YAAgC;AAClE,WAAO,aAAa,QAAQ,WAAW;AAAA,MACrC,GAAG;AAAA,MACH,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;AAKO,SAAS,oBACd,QAC0D;AAC1D,SAAO,OAAO,UAAU,QAAQ,OAAO,SAAS;AAClD;AAKO,SAAS,qBAAqB,QAAkC;AACrE,MAAI,OAAO,OAAO;AAChB,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,OAAO,UAAU,OAAO,OAAO,WAAW,GAAG;AAChD,WAAO;AAAA,EACT;AAEA,SAAO,mBAAmB,OAAO,MAAM;AACzC;;;ACtQA,SAAS,YAAuC;AAChD,SAAS,SAAAC,cAAa;AAStB,SAAS,qCAAqC;AAU9C,IAAM,gCAAgC;AAoBtC,IAAM,sBAGA;AAAA,EACJ;AAAA;AAAA;AAAA,IAGE,KAAK;AAAA,IACL,SAAS;AAAA,EACX;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,SAAS;AAAA,EACX;AAAA,EACA;AAAA;AAAA;AAAA,IAGE,KAAK;AAAA,IACL,SAAS;AAAA,EACX;AAAA,EACA;AAAA;AAAA;AAAA,IAGE,KAAK;AAAA,IACL,SAAS;AAAA,EACX;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,SAAS;AAAA,EACX;AACF;AAMA,SAAS,yBAAyB,UAAsC;AACtE,SAAO,oBAAoB,QAAQ,CAAC,EAAE,QAAQ,MAAM,QAAQ,QAAQ,CAAC;AACvE;AAGA,SAAS,0BAA0B,MAAe,OAA6B;AAC7E,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,WAAO,KAAK,KAAK,CAAC,SAAS,0BAA0B,MAAM,KAAK,CAAC;AAAA,EACnE;AACA,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,SAAS;AACf,MAAI,OAAO,OAAO,SAAS,YAAY,MAAM,IAAI,OAAO,IAAI,EAAG,QAAO;AACtE,SAAO,OAAO,OAAO,MAAM,EAAE;AAAA,IAAK,CAAC,UACjC,0BAA0B,OAAO,KAAK;AAAA,EACxC;AACF;AAoBA,IAAI;AACJ,SAAS,8BAAuC;AAC9C,+BAA6B,KAAK;AAAA,IAAU,CAAC,SAC3C,KAAK;AAAA,MACH,6BAA6B;AAAA,QAAI,CAAC,cAChC,4BAA4B,WAAW,MAAM,IAAI;AAAA,MACnD;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAmCA,SAAS,iBACP,UACA,gBACA,SAC+C;AAC/C,MACE,SAAS,uBAAuB,QAC/B,SAAS,qBAAqB,UAC7B,QAAQ,iBAAiB,OAAO,KAChC,0BAA0B,UAAU,QAAQ,gBAAgB,KAC9DC,OAAM,MAAM,4BAA4B,GAAG,QAAQ,GACnD;AACA,WAAO,EAAE,OAAO,MAAM,QAAQ,CAAC,EAAE;AAAA,EACnC;AAEA,QAAM,SACJ,eAAe,SAAS,IACpB,iBACA;AAAA,IACE;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,MACT,MAAM;AAAA,IACR;AAAA,EACF;AACN,SAAO;AAAA,IACL,OAAO;AAAA,IACP,QAAQ;AAAA,MACN,GAAG;AAAA,MACH;AAAA,QACE,MAAM;AAAA,QACN,SACE;AAAA,QAIF,MAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAQA,SAAS,qBACP,UACA,gBACA,SAC+C;AAC/C,QAAM,SAAS,8BAA8B,UAAU,gBAAgB;AAAA,IACrE,oBAAoB,SAAS;AAAA,IAC7B,kBAAkB,SAAS;AAAA,EAC7B,CAAC;AACD,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO,iBAAiB,UAAU,gBAAgB,OAAO;AAAA,EAC3D;AACA,SAAO,EAAE,OAAO,OAAO,OAAO;AAChC;AAKO,SAAS,iBACd,MACA,SAC0B;AAC1B,QAAM,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,MAAI,cAAc,OAAO,UAAU,CAAC;AACpC,MAAI,aAAa,OAAO;AACxB,MAAI,CAAC,OAAO,SAAS,MAAM;AACzB,KAAC,EAAE,OAAO,YAAY,QAAQ,YAAY,IAAI;AAAA,MAC5C;AAAA,MACA,OAAO,UAAU,CAAC;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAIA,QAAM,oBAAoB,yBAAyB,IAAI;AACvD,MAAI,kBAAkB,SAAS,GAAG;AAChC,kBAAc,CAAC,GAAG,aAAa,GAAG,iBAAiB;AACnD,iBAAa;AAAA,EACf;AAMA,QAAM,eACJ,OAAO,SACN,aACI,OACD;AACN,QAAM,iBAA2C;AAAA,IAC/C,GAAG;AAAA,IACH,OAAO;AAAA,IACP,cAAc;AAAA,IACd,QAAQ;AAAA,IACR,MAAM;AAAA,EACR;AAGA,MAAI,YAAY;AACd,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,YAAY,MAAM,QAAQ,IAAI,QAAQ,GAAG;AACtD,YAAM,YAAY,IAAI,SAAS;AAAA,QAC7B,CAAC,MAAW,CAAC,wBAAwB,EAAE,IAAI;AAAA,MAC7C;AACA,qBAAe,sBAAsB;AAAA,IACvC;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,qBACd,WACA,SAC0B;AAE1B,QAAM,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,MAAI,cAAc,OAAO,UAAU,CAAC;AACpC,MAAI,aAAa,OAAO;AACxB,MAAI,CAAC,OAAO,SAAS,OAAO,QAAQ;AAClC,KAAC,EAAE,OAAO,YAAY,QAAQ,YAAY,IAAI;AAAA,MAC5C,OAAO;AAAA,MACP,OAAO,UAAU,CAAC;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAIA,QAAM,oBAAoB,yBAAyB,OAAO,MAAM;AAChE,MAAI,kBAAkB,SAAS,GAAG;AAChC,kBAAc,CAAC,GAAG,aAAa,GAAG,iBAAiB;AACnD,iBAAa;AAAA,EACf;AAMA,QAAM,eACJ,OAAO,SACN,aACI,OAAO,SACR;AACN,QAAM,iBAA2C;AAAA,IAC/C,GAAG;AAAA,IACH,OAAO;AAAA,IACP,cAAc;AAAA,IACd,QAAQ;AAAA,IACR,MAAM;AAAA,EACR;AAGA,MAAI,YAAY;AACd,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,YAAY,MAAM,QAAQ,IAAI,QAAQ,GAAG;AACtD,YAAM,YAAY,IAAI,SAAS;AAAA,QAC7B,CAAC,MAAW,CAAC,wBAAwB,EAAE,IAAI;AAAA,MAC7C;AACA,qBAAe,sBAAsB;AAAA,IACvC;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,gBACd,QAIA;AACA,SAAO,OAAO,UAAU,QAAQ,OAAO,SAAS;AAClD;AAKA,SAAS,4BAAsC;AAC7C,SAAO,8BAA8B,iCAAiC;AACxE;AAKA,SAAS,wBAAwB,MAAuB;AACtD,QAAM,gBAAgB,0BAA0B;AAChD,SAAO,cAAc,SAAS,IAAI;AACpC;AAKO,SAAS,wBAAwB,gBAAoC;AAC1E,SAAO;AAAA,IACL,UAAU,CAAC,MAAe,YACxB,iBAAiB,MAAM,EAAE,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAAA,IAC1D,cAAc,CAAC,WAA4B,YACzC,qBAAqB,WAAW,EAAE,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAAA,EACrE;AACF;AAGO,IAAM,oBAAoB,wBAAwB;AAAA,EACvD,OAAO;AAAA,EACP,eAAe;AAAA,EACf,WAAW;AAAA;AACb,CAAC;AAEM,IAAM,0BAA0B,wBAAwB;AAAA,EAC7D,OAAO;AAAA,EACP,eAAe;AAAA,EACf,WAAW;AAAA;AACb,CAAC;AAKM,IAAM,wBAAwB;AAC9B,IAAM,6BAA6B;","names":["Value","transformValueErrors","result","Value","Value"]}

package/dist/{chunk-7YP6WMME.js → chunk-UDP63RKH.js}

@@ -1,6 +1,6 @@
 import {
   ComponentDefinitionSchema
-} from "./chunk-JGD54FUF.js";
+} from "./chunk-M2GYRM4P.js";
 
 // src/schemas/api.ts
 import { Type } from "@sinclair/typebox";
@@ -105,4 +105,4 @@ export {
   GenerateDocumentResponseSchema,
   ValidateDocumentResponseSchema
 };
-//# sourceMappingURL=chunk-7YP6WMME.js.map
+//# sourceMappingURL=chunk-UDP63RKH.js.map

package/dist/{chunk-ZKBTTJN6.js → chunk-V3YRROBV.js}

@@ -1,6 +1,6 @@
 import {
   HexColorSchema
-} from "./chunk-7TTAAYQ5.js";
+} from "./chunk-Y3XKLR27.js";
 
 // src/schemas/components/common.ts
 import { Type } from "@sinclair/typebox";
@@ -101,14 +101,24 @@ var BorderSchema = Type.Object(
 );
 var LineSpacingSchema = Type.Object(
   {
-    type: Type.Union([
-      Type.Literal("single"),
-      Type.Literal("atLeast"),
-      Type.Literal("exactly"),
-      Type.Literal("double"),
-      Type.Literal("multiple")
-    ]),
-    value: Type.Optional(Type.Number({ minimum: 0 }))
+    type: Type.Union(
+      [
+        Type.Literal("single"),
+        Type.Literal("atLeast"),
+        Type.Literal("exactly"),
+        Type.Literal("double"),
+        Type.Literal("multiple")
+      ],
+      {
+        description: "`single`/`double` ignore `value`; `multiple` scales single spacing by it; `atLeast` is a floor the line grows past; `exactly` pins an absolute box the glyphs are clipped to."
+      }
+    ),
+    value: Type.Optional(
+      Type.Number({
+        minimum: 0,
+        description: "Points for `exactly` and `atLeast`, a factor of single spacing for `multiple`. `exactly` has no floor of its own \u2014 an empty spacer paragraph legitimately pins a fraction of a point \u2014 so a box smaller than the text it holds is accepted here and clips it."
+      })
+    )
   },
   { description: "Line spacing configuration", additionalProperties: false }
 );
@@ -475,4 +485,4 @@ export {
   BaseComponentFields,
   BaseComponentPropsSchema
 };
-//# sourceMappingURL=chunk-ZKBTTJN6.js.map
+//# sourceMappingURL=chunk-V3YRROBV.js.map