@json-to-office/shared-docx 0.37.0 → 0.38.0

package/dist/{chunk-HYY4ZOYL.js → chunk-DYTUITUL.js}

@@ -393,6 +393,47 @@ function collectNoteRevisionConflicts(data) {
   visit(data, "");
   return errors;
 }
+var UNDASHABLE_BORDER_STYLES = /* @__PURE__ */ new Set(["dashed", "dotted", "double"]);
+function collectTextBoxShapeConflicts(data) {
+  const errors = [];
+  const visit = (node, path) => {
+    if (Array.isArray(node)) {
+      node.forEach((item, i) => visit(item, `${path}/${i}`));
+      return;
+    }
+    if (!node || typeof node !== "object") return;
+    if (node.name === "text-box" && node.props?.renderAs === "shape") {
+      const missing = ["width", "height"].filter(
+        (axis) => node.props[axis] === void 0
+      );
+      if (missing.length > 0) {
+        errors.push({
+          path: `${path}/props/${missing[0]}`,
+          message: `A text-box with renderAs "shape" requires ${missing.join(" and ")}: a shape has no autofit, so its size cannot be derived from its content. Give it an explicit size, or use renderAs "table", which grows to fit.`,
+          code: "required"
+        });
+      }
+      const border = node.props.style?.border;
+      if (border && typeof border === "object") {
+        for (const side of ["top", "right", "bottom", "left"]) {
+          const style = border[side]?.style;
+          if (typeof style === "string" && UNDASHABLE_BORDER_STYLES.has(style)) {
+            errors.push({
+              path: `${path}/props/style/border/${side}/style`,
+              message: `A text-box with renderAs "shape" cannot draw a "${style}" border: a shape outline carries no dash pattern. Use "solid", or use renderAs "table", which draws every border style.`,
+              code: "unsupported_value"
+            });
+          }
+        }
+      }
+    }
+    for (const key of Object.keys(node)) {
+      visit(node[key], `${path}/${key}`);
+    }
+  };
+  visit(data, "");
+  return errors;
+}
 function deepValidateDocument(data, opts = {}) {
   const allErrors = [];
   if (!data || typeof data !== "object") {
@@ -746,6 +787,33 @@ function getValidationSummary(result) {
 // src/validation/unified/document-validator.ts
 import { extractStandardComponentNames } from "@json-to-office/shared";
 var JsonComponentDefinitionSchema = ComponentDefinitionSchema;
+var SEMANTIC_COLLECTORS = [
+  {
+    // A multi-source image passes the structural check: each source is its own
+    // optional field.
+    why: "image source mutual-exclusivity",
+    collect: collectImageSourceConflicts
+  },
+  {
+    why: "indent hanging/firstLine mutual-exclusivity",
+    collect: collectIndentConflicts
+  },
+  {
+    // Tracked-change text renders literally, so a note marker inside it never
+    // resolves and docx cannot express the pair anyway.
+    why: "notes on a revised paragraph",
+    collect: collectNoteRevisionConflicts
+  },
+  {
+    // A shape has no autofit and its outline carries no dash pattern, so the
+    // request could only ever come back as a table.
+    why: "a text box asking for a shape rendering a shape cannot give it",
+    collect: collectTextBoxShapeConflicts
+  }
+];
+function collectSemanticConflicts(document) {
+  return SEMANTIC_COLLECTORS.flatMap(({ collect }) => collect(document));
+}
 function validateDocument(data, options) {
   const result = validateAgainstSchema(
     ComponentDefinitionSchema,
@@ -763,19 +831,9 @@ function validateDocument(data, options) {
       finalValid = true;
     }
   }
-  const sourceConflicts = collectImageSourceConflicts(data);
-  if (sourceConflicts.length > 0) {
-    finalErrors = [...finalErrors, ...sourceConflicts];
-    finalValid = false;
-  }
-  const indentConflicts = collectIndentConflicts(data);
-  if (indentConflicts.length > 0) {
-    finalErrors = [...finalErrors, ...indentConflicts];
-    finalValid = false;
-  }
-  const noteRevisionConflicts = collectNoteRevisionConflicts(data);
-  if (noteRevisionConflicts.length > 0) {
-    finalErrors = [...finalErrors, ...noteRevisionConflicts];
+  const semanticConflicts = collectSemanticConflicts(data);
+  if (semanticConflicts.length > 0) {
+    finalErrors = [...finalErrors, ...semanticConflicts];
     finalValid = false;
   }
   const resolvedData = result.data ?? (finalValid ? data : void 0);
@@ -814,19 +872,9 @@ function validateJsonDocument(jsonInput, options) {
       finalValid = true;
     }
   }
-  const sourceConflicts = collectImageSourceConflicts(result.parsed);
-  if (sourceConflicts.length > 0) {
-    finalErrors = [...finalErrors, ...sourceConflicts];
-    finalValid = false;
-  }
-  const indentConflicts = collectIndentConflicts(result.parsed);
-  if (indentConflicts.length > 0) {
-    finalErrors = [...finalErrors, ...indentConflicts];
-    finalValid = false;
-  }
-  const noteRevisionConflicts = collectNoteRevisionConflicts(result.parsed);
-  if (noteRevisionConflicts.length > 0) {
-    finalErrors = [...finalErrors, ...noteRevisionConflicts];
+  const semanticConflicts = collectSemanticConflicts(result.parsed);
+  if (semanticConflicts.length > 0) {
+    finalErrors = [...finalErrors, ...semanticConflicts];
     finalValid = false;
   }
   const resolvedData = result.data ?? (finalValid ? result.parsed : void 0);
@@ -884,6 +932,7 @@ export {
   transformValueErrors,
   collectIndentConflicts,
   collectNoteRevisionConflicts,
+  collectTextBoxShapeConflicts,
   deepValidateDocument,
   comprehensiveValidateDocument,
   validateAgainstSchema,
@@ -903,4 +952,4 @@ export {
   validateJsonComponent,
   validateDocumentWithSchema
 };
-//# sourceMappingURL=chunk-HYY4ZOYL.js.map
+//# sourceMappingURL=chunk-DYTUITUL.js.map

package/dist/chunk-DYTUITUL.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// 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/**\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  // 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 `header` / `footer` paragraph regions under `props` — typed only\n *    loosely on the section schema (an array of `Type.Any()`, or the\n *    `'linkToPrevious'` literal, which is skipped), so their entries are not\n *    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. `table` and `list`\n * nest their components inside their own recursive props schemas, so those are\n * already covered by `validateComponentProps` and are intentionally not\n * re-walked here.\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    // 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    if (child.props != null) {\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  // header/footer entries are validated strictly: the static section schema\n  // types them as `Type.Any()`, so the editor's whole-tree schema (where they\n  // resolve to the component union) is stricter than the per-component check —\n  // the walk closes that gap, flagging non-component entries too. A bare\n  // `'linkToPrevious'` value is not an array, so it is skipped here.\n  for (const region of ['header', 'footer'] as const) {\n    const entries = node.props?.[region];\n    if (Array.isArray(entries)) {\n      entries.forEach((child: any, i: number) =>\n        validateEntry(child, `${path}/props/${region}/${i}`, true)\n      );\n    }\n  }\n\n  // `table` nests its cell content under `props` (not the shared `children`\n  // field), and the static table schema types that content loosely — the\n  // cell-content ref accepts any props object, just like the `Type.Any()`\n  // header/footer above. So a bad prop deep in a cell (e.g. `font.size` over the\n  // cap) slips past the per-component table check; walk each content component\n  // so its props are validated against the real schema. Structural problems\n  // with a cell are already reported by the table's own props validation, hence\n  // the lenient (`false`) entry check to avoid double-reporting.\n  if (node.name === 'table' && Array.isArray(node.props?.columns)) {\n    node.props.columns.forEach((col: any, c: number) => {\n      if (!col || typeof col !== 'object') return;\n      const base = `${path}/props/columns/${c}`;\n      const headerContent = col.header?.content;\n      if (headerContent && typeof headerContent === 'object') {\n        validateEntry(headerContent, `${base}/header/content`, false);\n      }\n      if (Array.isArray(col.cells)) {\n        col.cells.forEach((cell: any, r: number) => {\n          const content = cell?.content;\n          if (content && typeof content === 'object') {\n            validateEntry(content, `${base}/cells/${r}/content`, false);\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 * 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  // 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(schema, Value.Clone(props))\n    : props;\n\n  // Use TypeBox to validate against the specific schema\n  if (!Value.Check(schema, toCheck)) {\n    const valueErrors = [...Value.Errors(schema, 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 * 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 { Static } from '@sinclair/typebox';\nimport {\n  ComponentDefinitionSchema,\n  StandardComponentDefinitionSchema,\n} from '../../schemas/components';\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';\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\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/**\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    finalErrors = comprehensiveValidateDocument(data, result.errors, {\n      allowUnknownFields: options?.allowUnknownFields,\n      knownCustomNames: options?.knownCustomNames,\n    });\n    // If TypeBox's union check produced only generic catch-all errors and the\n    // deep validator finds nothing actionable, treat the document as valid.\n    if (finalErrors.length === 0) {\n      finalValid = true;\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    finalErrors = comprehensiveValidateDocument(result.parsed, result.errors, {\n      allowUnknownFields: options?.allowUnknownFields,\n      knownCustomNames: options?.knownCustomNames,\n    });\n    if (finalErrors.length === 0) {\n      finalValid = true;\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":"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","names":["Value","transformValueErrors","result"]}

package/dist/{chunk-HMNKQ7BT.js → chunk-SH3OH4OY.js}

@@ -3,7 +3,7 @@ import {
   strictDocumentValidator,
   validateAgainstSchema,
   validateJson
-} from "./chunk-HYY4ZOYL.js";
+} from "./chunk-DYTUITUL.js";
 import {
   ComponentDefinitionSchema
 } from "./chunk-K2LA6WCD.js";
@@ -410,4 +410,4 @@ export {
   createErrorConfig,
   formatErrorMessage
 };
-//# sourceMappingURL=chunk-HMNKQ7BT.js.map
+//# sourceMappingURL=chunk-SH3OH4OY.js.map

package/dist/chunk-SH3OH4OY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validation/unified/index.ts","../src/validation/unified/error-formatter-config.ts","../src/validation/unified/theme-validator.ts","../src/validation/unified/component-validator.ts"],"sourcesContent":["/**\n * Unified validation facade\n * Simple, clean API for all validation needs\n */\n\n// Format-agnostic types re-exported from @json-to-office/shared\nexport type { ValidationError, ValidationResult } from '@json-to-office/shared';\n\n// Docx-specific extended types (local)\nexport type {\n  ValidationOptions,\n  JsonValidationResult,\n  ThemeValidationResult,\n  DocumentValidationResult,\n  ComponentValidationResult,\n  EnhancedValueError,\n} from './types';\n\n// Format-agnostic error utilities re-exported from @json-to-office/shared\nexport {\n  transformValueError,\n  transformValueErrors,\n  calculatePosition,\n  formatErrorSummary,\n  groupErrorsByPath,\n  createJsonParseError,\n} from '@json-to-office/shared';\n\n// Docx-specific error transformer (local, extends shared with docx-specific messages)\nexport {\n  transformValueError as transformDocxValueError,\n  transformValueErrors as transformDocxValueErrors,\n} from './error-transformer';\n\n// Export deep validation utilities (docx-specific)\nexport {\n  deepValidateDocument,\n  comprehensiveValidateDocument,\n  collectIndentConflicts,\n  collectNoteRevisionConflicts,\n  collectTextBoxShapeConflicts,\n} from './deep-validator';\n\n// Format-agnostic schema utilities re-exported from @json-to-office/shared\nexport {\n  isUnionSchema,\n  isObjectSchema,\n  isLiteralSchema,\n  getObjectSchemaPropertyNames,\n  getLiteralValue,\n  extractStandardComponentNames,\n  clearComponentNamesCache,\n  getSchemaMetadata,\n} from '@json-to-office/shared';\n\n// Format-agnostic error formatter config re-exported from @json-to-office/shared\nexport {\n  type ErrorFormatterConfig,\n  DEFAULT_ERROR_CONFIG,\n  ERROR_EMOJIS,\n  createErrorConfig,\n  formatErrorMessage,\n} from '@json-to-office/shared';\n\n// Docx-specific error formatter extras (local)\nexport { ERROR_TEMPLATES } from './error-formatter-config';\n\n// Export base validator utilities\nexport {\n  validateAgainstSchema,\n  validateJson,\n  validateBatch,\n  validateWithEnhancement,\n  createValidator,\n  createJsonValidator,\n  isValidationSuccess,\n  getValidationSummary,\n} from './base-validator';\n\n// Export document validation\nexport {\n  validateDocument,\n  validateJsonDocument,\n  isValidDocument,\n  createDocumentValidator,\n  documentValidator,\n  strictDocumentValidator,\n  // Legacy compatibility\n  validateJsonComponent,\n  validateDocumentWithSchema,\n} from './document-validator';\n\n// Export theme validation\nexport {\n  validateTheme,\n  validateThemeJson,\n  validateThemeWithEnhancement,\n  isValidTheme,\n  createThemeValidator,\n  themeValidator,\n  strictThemeValidator,\n  getThemeName,\n  isThemeConfig,\n} from './theme-validator';\n\n// Export component validation\nexport {\n  validateComponent,\n  validateComponentDefinition,\n  validateCustomComponentProps,\n  validateComponents,\n  isStandardComponentName,\n  createComponentValidator,\n  componentValidator,\n  strictComponentValidator,\n  // Type guards\n  isReportProps,\n  isSectionProps,\n  isHeadingProps,\n  isParagraphProps,\n  isColumnsProps,\n  isImageProps,\n  isStatisticProps,\n  isTableProps,\n  isListProps,\n  isCustomComponentProps,\n  // Types\n  type StandardComponentName,\n} from './component-validator';\n\n// Import the validators we need\nimport {\n  documentValidator,\n  strictDocumentValidator,\n} from './document-validator';\nimport { themeValidator, strictThemeValidator } from './theme-validator';\nimport {\n  componentValidator,\n  strictComponentValidator,\n} from './component-validator';\n\n/**\n * Simple validation API\n * The main entry point for most validation needs\n */\nexport const validate = {\n  // Document validation\n  document: (data: unknown) => documentValidator.validate(data),\n  jsonDocument: (jsonInput: string | object) =>\n    documentValidator.validateJson(jsonInput),\n\n  // Theme validation\n  theme: (data: unknown) => themeValidator.validate(data),\n  jsonTheme: (jsonInput: string | object) =>\n    themeValidator.validateJson(jsonInput),\n\n  // Component validation\n  component: (name: string, props: unknown) =>\n    componentValidator.validate(name, props),\n  componentDefinition: (component: unknown) =>\n    componentValidator.validateDefinition(component),\n\n  // Batch operations\n  components: (components: Array<{ name: string; props: unknown }>) =>\n    components.map((c) => componentValidator.validate(c.name, c.props)),\n\n  // Type checking (non-throwing)\n  isDocument: (data: unknown) => {\n    const result = documentValidator.validate(data);\n    return result.valid;\n  },\n  isTheme: (data: unknown) => {\n    const result = themeValidator.validate(data);\n    return result.valid;\n  },\n  isComponent: (name: string, props: unknown) => {\n    const result = componentValidator.validate(name, props);\n    return result.valid;\n  },\n};\n\n/**\n * Strict validation API\n * For cases where you want no cleaning or defaults\n */\nexport const validateStrict = {\n  document: (data: unknown) => strictDocumentValidator.validate(data),\n  jsonDocument: (jsonInput: string | object) =>\n    strictDocumentValidator.validateJson(jsonInput),\n  theme: (data: unknown) => strictThemeValidator.validate(data),\n  jsonTheme: (jsonInput: string | object) =>\n    strictThemeValidator.validateJson(jsonInput),\n  component: (name: string, props: unknown) =>\n    strictComponentValidator.validate(name, props),\n  componentDefinition: (component: unknown) =>\n    strictComponentValidator.validateDefinition(component),\n};\n","/**\n * Error Formatter Configuration\n * Configurable error message formatting options\n */\n\n/**\n * Error formatter configuration options\n */\nexport interface ErrorFormatterConfig {\n  /**\n   * Include emoji indicators in error messages\n   * Default: true (false in CI environments)\n   */\n  includeEmojis?: boolean;\n\n  /**\n   * Verbosity level for error messages\n   * - minimal: Just the error message\n   * - normal: Error message with path\n   * - detailed: Full error with suggestions and context\n   * Default: 'normal'\n   */\n  verbosity?: 'minimal' | 'normal' | 'detailed';\n\n  /**\n   * Include suggestions for fixing errors\n   * Default: true\n   */\n  includeSuggestions?: boolean;\n\n  /**\n   * Include stack trace or error path\n   * Default: true\n   */\n  includePath?: boolean;\n\n  /**\n   * Maximum error message length (0 = unlimited)\n   * Default: 0\n   */\n  maxMessageLength?: number;\n\n  /**\n   * Include links to documentation\n   * Default: false\n   */\n  includeDocLinks?: boolean;\n\n  /**\n   * Terminal color support\n   * Default: auto-detected\n   */\n  colorSupport?: boolean;\n}\n\n/**\n * Get default configuration\n * Evaluates environment variables at call time, not module load time\n */\nfunction getDefaultConfig(): Required<ErrorFormatterConfig> {\n  return {\n    includeEmojis: !isCI(),\n    verbosity: 'normal',\n    includeSuggestions: true,\n    includePath: true,\n    maxMessageLength: 0,\n    includeDocLinks: false,\n    colorSupport: hasColorSupport(),\n  };\n}\n\n/**\n * Default configuration (for backward compatibility)\n */\nexport const DEFAULT_ERROR_CONFIG: Required<ErrorFormatterConfig> =\n  getDefaultConfig();\n\n/**\n * Error message templates\n */\nexport const ERROR_TEMPLATES = {\n  UNION_NO_MATCH: \"Value doesn't match any of the expected formats\",\n  TYPE_MISMATCH: 'Expected {expected} but got {actual}',\n  MISSING_REQUIRED: \"Missing required field '{field}'\",\n  UNKNOWN_PROPERTY: \"Unknown property '{property}'\",\n  INVALID_FORMAT: 'Invalid {type} format',\n  PATTERN_MISMATCH: \"Value doesn't match the required pattern\",\n} as const;\n\n/**\n * Emoji indicators for different error types\n */\nexport const ERROR_EMOJIS = {\n  ERROR: '❌',\n  WARNING: '⚠️',\n  INFO: 'ℹ️',\n  SUGGESTION: '💡',\n  FIX: '🔧',\n  LINK: '🔗',\n} as const;\n\n/**\n * Detect if running in CI environment\n */\nfunction isCI(): boolean {\n  // Check if we're in a Node environment\n  if (typeof process === 'undefined' || !process.env) {\n    return false;\n  }\n\n  return !!(\n    process.env.CI ||\n    process.env.CONTINUOUS_INTEGRATION ||\n    process.env.GITHUB_ACTIONS ||\n    process.env.GITLAB_CI ||\n    process.env.CIRCLECI ||\n    process.env.TRAVIS ||\n    process.env.JENKINS_URL\n  );\n}\n\n/**\n * Detect terminal color support\n */\nfunction hasColorSupport(): boolean {\n  // Check if we're in a Node environment\n  if (typeof process === 'undefined') {\n    return false;\n  }\n\n  // Check for explicit NO_COLOR env var\n  if (process.env?.NO_COLOR) {\n    return false;\n  }\n\n  // Check for explicit FORCE_COLOR env var\n  if (process.env?.FORCE_COLOR) {\n    return true;\n  }\n\n  // Check if stdout is a TTY\n  if (process.stdout?.isTTY) {\n    return true;\n  }\n\n  // Default to no color in CI environments\n  return !isCI();\n}\n\n/**\n * Create a configuration with defaults\n */\nexport function createErrorConfig(\n  config?: ErrorFormatterConfig\n): Required<ErrorFormatterConfig> {\n  // Get fresh defaults that evaluate environment at call time\n  const defaults = getDefaultConfig();\n  return {\n    ...defaults,\n    ...config,\n  };\n}\n\n/**\n * Format an error message based on configuration\n */\nexport function formatErrorMessage(\n  message: string,\n  config: ErrorFormatterConfig = {}\n): string {\n  const finalConfig = createErrorConfig(config);\n\n  let formatted = message;\n\n  // Remove emojis if not wanted\n  if (!finalConfig.includeEmojis) {\n    Object.values(ERROR_EMOJIS).forEach((emoji) => {\n      formatted = formatted.replace(new RegExp(emoji, 'g'), '');\n    });\n    // Clean up extra spaces\n    formatted = formatted.replace(/\\s+/g, ' ').trim();\n  }\n\n  // Truncate if needed\n  if (\n    finalConfig.maxMessageLength > 0 &&\n    formatted.length > finalConfig.maxMessageLength\n  ) {\n    formatted =\n      formatted.substring(0, finalConfig.maxMessageLength - 3) + '...';\n  }\n\n  return formatted;\n}\n","/**\n * Theme validation implementation\n * Single source of truth for all theme validation\n */\n\nimport type { Static } from '@sinclair/typebox';\nimport { ThemeConfigSchema } from '../../schemas/theme';\nimport type { ValidationOptions } from './types';\nimport { validateAgainstSchema, validateJson } from './base-validator';\n\n// Re-export ThemeValidationResult type\nexport type { ThemeValidationResult } from './types';\nimport type { ThemeValidationResult } from './types';\n\n/**\n * Validate a theme configuration object\n */\nexport function validateTheme(\n  data: unknown,\n  options?: ValidationOptions\n): ThemeValidationResult {\n  // Handle string input (theme name)\n  if (typeof data === 'string') {\n    // This is just a theme name, not a theme config\n    // It will be resolved later by the theme resolver\n    return {\n      valid: true,\n      themeName: data,\n    };\n  }\n\n  const result = validateAgainstSchema(ThemeConfigSchema, data, options);\n\n  // Add theme-specific metadata\n  const themeResult: ThemeValidationResult = {\n    ...result,\n  };\n\n  // Extract theme name if present\n  if (result.valid && result.data) {\n    const theme = result.data as any;\n    if (theme.name) {\n      themeResult.themeName = theme.name;\n    }\n  }\n\n  return themeResult;\n}\n\n/**\n * Validate a theme JSON string or object\n * This replaces all three validateThemeJson implementations\n */\nexport function validateThemeJson(\n  jsonInput: string | object,\n  options?: ValidationOptions\n): ThemeValidationResult {\n  const result = validateJson(ThemeConfigSchema, jsonInput, options);\n\n  // Add theme-specific metadata\n  const themeResult: ThemeValidationResult = {\n    ...result,\n  };\n\n  // Extract theme name if present\n  if (result.valid && result.data) {\n    const theme = result.data as any;\n\n    // Inject default $schema if missing and it's an object\n    if (typeof theme === 'object' && !theme.$schema) {\n      theme.$schema = './json-schemas/theme.schema.json';\n    }\n\n    if (theme.name) {\n      themeResult.themeName = theme.name;\n    }\n  }\n\n  return themeResult;\n}\n\n/**\n * Validate theme with enhanced error messages\n */\nexport function validateThemeWithEnhancement(\n  data: unknown,\n  options?: ValidationOptions\n): ThemeValidationResult {\n  const result = validateTheme(data, options);\n\n  // Enhance errors with theme-specific suggestions\n  if (!result.valid && result.errors) {\n    result.errors = result.errors.map((error) => {\n      // Add specific suggestions for common theme errors\n      if (error.path.includes('colors') && !error.suggestion) {\n        error.suggestion = 'Colors must be valid hex, rgb, or named colors';\n      }\n      if (error.path.includes('fonts') && !error.suggestion) {\n        error.suggestion = 'Fonts must include size and family properties';\n      }\n      if (error.path.includes('headings') && !error.suggestion) {\n        error.suggestion = 'Headings must be an array of 6 style definitions';\n      }\n      return error;\n    });\n  }\n\n  return result;\n}\n\n/**\n * Type guard for valid theme result\n */\nexport function isValidTheme(\n  result: ThemeValidationResult\n): result is ThemeValidationResult & {\n  valid: true;\n  data: Static<typeof ThemeConfigSchema>;\n} {\n  return result.valid === true && result.data !== undefined;\n}\n\n/**\n * Create a theme validator with default options\n */\nexport function createThemeValidator(defaultOptions?: ValidationOptions) {\n  return {\n    validate: (data: unknown, options?: ValidationOptions) =>\n      validateTheme(data, { ...defaultOptions, ...options }),\n    validateJson: (jsonInput: string | object, options?: ValidationOptions) =>\n      validateThemeJson(jsonInput, { ...defaultOptions, ...options }),\n    validateWithEnhancement: (data: unknown, options?: ValidationOptions) =>\n      validateThemeWithEnhancement(data, { ...defaultOptions, ...options }),\n  };\n}\n\n// Export convenient validators with common configurations\nexport const themeValidator = createThemeValidator({\n  clean: true,\n  applyDefaults: true,\n});\n\nexport const strictThemeValidator = createThemeValidator({\n  clean: false,\n  applyDefaults: false,\n  maxErrors: 10,\n});\n\n/**\n * Get theme name from data\n */\nexport function getThemeName(data: unknown): string | undefined {\n  if (typeof data === 'string') {\n    return data;\n  }\n\n  if (typeof data === 'object' && data !== null && 'name' in data) {\n    const theme = data as any;\n    if (typeof theme.name === 'string') {\n      return theme.name;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Check if theme config is valid (basic check without full validation)\n */\nexport function isThemeConfig(data: unknown): boolean {\n  if (!data || typeof data !== 'object') {\n    return false;\n  }\n\n  const theme = data as any;\n  return !!(theme.colors && theme.fonts);\n}\n","/**\n * Component validation implementation\n * Single source of truth for all component validation\n */\n\nimport { Value } from '@sinclair/typebox/value';\nimport type { Static, TSchema } from '@sinclair/typebox';\nimport { validateCustomComponentProps as sharedValidateCustomComponentProps } from '@json-to-office/shared/plugin';\nimport {\n  ReportPropsSchema,\n  SectionPropsSchema,\n  HeadingPropsSchema,\n  ParagraphPropsSchema,\n  ColumnsPropsSchema,\n  ImagePropsSchema,\n  StatisticPropsSchema,\n  TablePropsSchema,\n  ListPropsSchema,\n  ComponentDefinitionSchema,\n} from '../../schemas/components';\nimport { CustomComponentDefinitionSchema } from '../../schemas/custom-components';\nimport type { ComponentValidationResult, ValidationOptions } from './types';\nimport { validateAgainstSchema } from './base-validator';\n\n// Map of standard component names to their schemas\nconst COMPONENT_SCHEMA_MAP = {\n  report: ReportPropsSchema,\n  section: SectionPropsSchema,\n  heading: HeadingPropsSchema,\n  paragraph: ParagraphPropsSchema,\n  columns: ColumnsPropsSchema,\n  image: ImagePropsSchema,\n  statistic: StatisticPropsSchema,\n  table: TablePropsSchema,\n  list: ListPropsSchema,\n  custom: CustomComponentDefinitionSchema,\n} as const;\n\nexport type StandardComponentName = keyof typeof COMPONENT_SCHEMA_MAP;\n\n/**\n * Validate a component configuration by type\n */\nexport function validateComponent<T extends StandardComponentName>(\n  name: T,\n  props: unknown,\n  options?: ValidationOptions\n): ComponentValidationResult<any> {\n  const schema = COMPONENT_SCHEMA_MAP[name];\n\n  if (!schema) {\n    // Unknown component type, try custom component schema\n    const customResult = validateAgainstSchema(\n      CustomComponentDefinitionSchema,\n      props,\n      options\n    );\n\n    return {\n      ...customResult,\n      success: customResult.valid, // Add success for backward compatibility\n      componentName: name,\n      isCustomComponent: true,\n    };\n  }\n\n  const result = validateAgainstSchema(schema, props, options);\n\n  return {\n    ...result,\n    success: result.valid, // Add success for backward compatibility\n    componentName: name,\n    isCustomComponent: name === 'custom',\n  };\n}\n\n/**\n * Validate a complete component definition (including nested children)\n */\nexport function validateComponentDefinition(\n  component: unknown,\n  options?: ValidationOptions\n): ComponentValidationResult {\n  const result = validateAgainstSchema(\n    ComponentDefinitionSchema,\n    component,\n    options\n  );\n\n  // Add component-specific metadata\n  const componentResult: ComponentValidationResult = {\n    ...result,\n  };\n\n  if (result.valid && result.data) {\n    const comp = result.data as any;\n    componentResult.componentName = comp.name;\n    componentResult.isCustomComponent = !isStandardComponentName(comp.name);\n  }\n\n  return componentResult;\n}\n\n/**\n * Validate a custom component configuration with a custom schema.\n * Delegates to @json-to-office/shared/plugin to avoid duplication.\n */\nexport function validateCustomComponentProps<T>(\n  componentSchema: TSchema,\n  config: unknown,\n  options?: ValidationOptions\n): ComponentValidationResult<T> {\n  return sharedValidateCustomComponentProps<T>(\n    componentSchema,\n    config,\n    options\n  );\n}\n\n/**\n * Batch validate multiple components\n */\nexport function validateComponents(\n  components: Array<{ name: string; props: unknown }>,\n  options?: ValidationOptions\n): ComponentValidationResult[] {\n  return components.map(({ name, props }) => {\n    if (isStandardComponentName(name)) {\n      return validateComponent(name, props, options);\n    }\n    return validateComponent('custom', props, options);\n  });\n}\n\n/**\n * Type guards for component names\n */\nexport function isStandardComponentName(\n  name: string\n): name is StandardComponentName {\n  return name in COMPONENT_SCHEMA_MAP;\n}\n\nexport function isReportProps(\n  config: unknown\n): config is Static<typeof ReportPropsSchema> {\n  return Value.Check(ReportPropsSchema, config);\n}\n\nexport function isSectionProps(\n  config: unknown\n): config is Static<typeof SectionPropsSchema> {\n  return Value.Check(SectionPropsSchema, config);\n}\n\nexport function isHeadingProps(\n  config: unknown\n): config is Static<typeof HeadingPropsSchema> {\n  return Value.Check(HeadingPropsSchema, config);\n}\n\nexport function isParagraphProps(\n  config: unknown\n): config is Static<typeof ParagraphPropsSchema> {\n  return Value.Check(ParagraphPropsSchema, config);\n}\n\nexport function isColumnsProps(\n  config: unknown\n): config is Static<typeof ColumnsPropsSchema> {\n  return Value.Check(ColumnsPropsSchema, config);\n}\n\nexport function isImageProps(\n  config: unknown\n): config is Static<typeof ImagePropsSchema> {\n  return Value.Check(ImagePropsSchema, config);\n}\n\nexport function isStatisticProps(\n  config: unknown\n): config is Static<typeof StatisticPropsSchema> {\n  return Value.Check(StatisticPropsSchema, config);\n}\n\nexport function isTableProps(\n  config: unknown\n): config is Static<typeof TablePropsSchema> {\n  return Value.Check(TablePropsSchema, config);\n}\n\nexport function isListProps(\n  config: unknown\n): config is Static<typeof ListPropsSchema> {\n  return Value.Check(ListPropsSchema, config);\n}\n\nexport function isCustomComponentProps(\n  config: unknown\n): config is Static<typeof CustomComponentDefinitionSchema> {\n  return Value.Check(CustomComponentDefinitionSchema, config);\n}\n\n/**\n * Create a component validator with default options\n */\nexport function createComponentValidator(defaultOptions?: ValidationOptions) {\n  return {\n    validate: (name: string, props: unknown, options?: ValidationOptions) => {\n      if (isStandardComponentName(name)) {\n        return validateComponent(name, props, {\n          ...defaultOptions,\n          ...options,\n        });\n      }\n      return validateComponent('custom', props, {\n        ...defaultOptions,\n        ...options,\n      });\n    },\n    validateDefinition: (component: unknown, options?: ValidationOptions) =>\n      validateComponentDefinition(component, { ...defaultOptions, ...options }),\n    validateCustom: <T>(\n      schema: TSchema,\n      config: unknown,\n      options?: ValidationOptions\n    ) =>\n      validateCustomComponentProps<T>(schema, config, {\n        ...defaultOptions,\n        ...options,\n      }),\n  };\n}\n\n// Export convenient validators with common configurations\nexport const componentValidator = createComponentValidator({\n  clean: true,\n  applyDefaults: true,\n});\n\nexport const strictComponentValidator = createComponentValidator({\n  clean: false,\n  applyDefaults: false,\n  maxErrors: 10,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAkBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EAEE,wBAAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;;;ACHP,SAAS,mBAAmD;AAC1D,SAAO;AAAA,IACL,eAAe,CAAC,KAAK;AAAA,IACrB,WAAW;AAAA,IACX,oBAAoB;AAAA,IACpB,aAAa;AAAA,IACb,kBAAkB;AAAA,IAClB,iBAAiB;AAAA,IACjB,cAAc,gBAAgB;AAAA,EAChC;AACF;AAKO,IAAM,uBACX,iBAAiB;AAKZ,IAAM,kBAAkB;AAAA,EAC7B,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,kBAAkB;AACpB;AAiBA,SAAS,OAAgB;AAEvB,MAAI,OAAO,YAAY,eAAe,CAAC,QAAQ,KAAK;AAClD,WAAO;AAAA,EACT;AAEA,SAAO,CAAC,EACN,QAAQ,IAAI,MACZ,QAAQ,IAAI,0BACZ,QAAQ,IAAI,kBACZ,QAAQ,IAAI,aACZ,QAAQ,IAAI,YACZ,QAAQ,IAAI,UACZ,QAAQ,IAAI;AAEhB;AAKA,SAAS,kBAA2B;AAElC,MAAI,OAAO,YAAY,aAAa;AAClC,WAAO;AAAA,EACT;AAGA,MAAI,QAAQ,KAAK,UAAU;AACzB,WAAO;AAAA,EACT;AAGA,MAAI,QAAQ,KAAK,aAAa;AAC5B,WAAO;AAAA,EACT;AAGA,MAAI,QAAQ,QAAQ,OAAO;AACzB,WAAO;AAAA,EACT;AAGA,SAAO,CAAC,KAAK;AACf;;;AClIO,SAAS,cACd,MACA,SACuB;AAEvB,MAAI,OAAO,SAAS,UAAU;AAG5B,WAAO;AAAA,MACL,OAAO;AAAA,MACP,WAAW;AAAA,IACb;AAAA,EACF;AAEA,QAAM,SAAS,sBAAsB,mBAAmB,MAAM,OAAO;AAGrE,QAAM,cAAqC;AAAA,IACzC,GAAG;AAAA,EACL;AAGA,MAAI,OAAO,SAAS,OAAO,MAAM;AAC/B,UAAM,QAAQ,OAAO;AACrB,QAAI,MAAM,MAAM;AACd,kBAAY,YAAY,MAAM;AAAA,IAChC;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,kBACd,WACA,SACuB;AACvB,QAAM,SAAS,aAAa,mBAAmB,WAAW,OAAO;AAGjE,QAAM,cAAqC;AAAA,IACzC,GAAG;AAAA,EACL;AAGA,MAAI,OAAO,SAAS,OAAO,MAAM;AAC/B,UAAM,QAAQ,OAAO;AAGrB,QAAI,OAAO,UAAU,YAAY,CAAC,MAAM,SAAS;AAC/C,YAAM,UAAU;AAAA,IAClB;AAEA,QAAI,MAAM,MAAM;AACd,kBAAY,YAAY,MAAM;AAAA,IAChC;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,6BACd,MACA,SACuB;AACvB,QAAM,SAAS,cAAc,MAAM,OAAO;AAG1C,MAAI,CAAC,OAAO,SAAS,OAAO,QAAQ;AAClC,WAAO,SAAS,OAAO,OAAO,IAAI,CAAC,UAAU;AAE3C,UAAI,MAAM,KAAK,SAAS,QAAQ,KAAK,CAAC,MAAM,YAAY;AACtD,cAAM,aAAa;AAAA,MACrB;AACA,UAAI,MAAM,KAAK,SAAS,OAAO,KAAK,CAAC,MAAM,YAAY;AACrD,cAAM,aAAa;AAAA,MACrB;AACA,UAAI,MAAM,KAAK,SAAS,UAAU,KAAK,CAAC,MAAM,YAAY;AACxD,cAAM,aAAa;AAAA,MACrB;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAKO,SAAS,aACd,QAIA;AACA,SAAO,OAAO,UAAU,QAAQ,OAAO,SAAS;AAClD;AAKO,SAAS,qBAAqB,gBAAoC;AACvE,SAAO;AAAA,IACL,UAAU,CAAC,MAAe,YACxB,cAAc,MAAM,EAAE,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAAA,IACvD,cAAc,CAAC,WAA4B,YACzC,kBAAkB,WAAW,EAAE,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAAA,IAChE,yBAAyB,CAAC,MAAe,YACvC,6BAA6B,MAAM,EAAE,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAAA,EACxE;AACF;AAGO,IAAM,iBAAiB,qBAAqB;AAAA,EACjD,OAAO;AAAA,EACP,eAAe;AACjB,CAAC;AAEM,IAAM,uBAAuB,qBAAqB;AAAA,EACvD,OAAO;AAAA,EACP,eAAe;AAAA,EACf,WAAW;AACb,CAAC;AAKM,SAAS,aAAa,MAAmC;AAC9D,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU,MAAM;AAC/D,UAAM,QAAQ;AACd,QAAI,OAAO,MAAM,SAAS,UAAU;AAClC,aAAO,MAAM;AAAA,IACf;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,cAAc,MAAwB;AACpD,MAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ;AACd,SAAO,CAAC,EAAE,MAAM,UAAU,MAAM;AAClC;;;AC3KA,SAAS,aAAa;AAEtB,SAAS,gCAAgC,0CAA0C;AAkBnF,IAAM,uBAAuB;AAAA,EAC3B,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,SAAS;AAAA,EACT,OAAO;AAAA,EACP,WAAW;AAAA,EACX,OAAO;AAAA,EACP,MAAM;AAAA,EACN,QAAQ;AACV;AAOO,SAAS,kBACd,MACA,OACA,SACgC;AAChC,QAAM,SAAS,qBAAqB,IAAI;AAExC,MAAI,CAAC,QAAQ;AAEX,UAAM,eAAe;AAAA,MACnB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL,GAAG;AAAA,MACH,SAAS,aAAa;AAAA;AAAA,MACtB,eAAe;AAAA,MACf,mBAAmB;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,SAAS,sBAAsB,QAAQ,OAAO,OAAO;AAE3D,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO;AAAA;AAAA,IAChB,eAAe;AAAA,IACf,mBAAmB,SAAS;AAAA,EAC9B;AACF;AAKO,SAAS,4BACd,WACA,SAC2B;AAC3B,QAAM,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,QAAM,kBAA6C;AAAA,IACjD,GAAG;AAAA,EACL;AAEA,MAAI,OAAO,SAAS,OAAO,MAAM;AAC/B,UAAM,OAAO,OAAO;AACpB,oBAAgB,gBAAgB,KAAK;AACrC,oBAAgB,oBAAoB,CAAC,wBAAwB,KAAK,IAAI;AAAA,EACxE;AAEA,SAAO;AACT;AAMO,SAAS,6BACd,iBACA,QACA,SAC8B;AAC9B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAKO,SAAS,mBACd,YACA,SAC6B;AAC7B,SAAO,WAAW,IAAI,CAAC,EAAE,MAAM,MAAM,MAAM;AACzC,QAAI,wBAAwB,IAAI,GAAG;AACjC,aAAO,kBAAkB,MAAM,OAAO,OAAO;AAAA,IAC/C;AACA,WAAO,kBAAkB,UAAU,OAAO,OAAO;AAAA,EACnD,CAAC;AACH;AAKO,SAAS,wBACd,MAC+B;AAC/B,SAAO,QAAQ;AACjB;AAEO,SAAS,cACd,QAC4C;AAC5C,SAAO,MAAM,MAAM,mBAAmB,MAAM;AAC9C;AAEO,SAAS,eACd,QAC6C;AAC7C,SAAO,MAAM,MAAM,oBAAoB,MAAM;AAC/C;AAEO,SAAS,eACd,QAC6C;AAC7C,SAAO,MAAM,MAAM,oBAAoB,MAAM;AAC/C;AAEO,SAAS,iBACd,QAC+C;AAC/C,SAAO,MAAM,MAAM,sBAAsB,MAAM;AACjD;AAEO,SAAS,eACd,QAC6C;AAC7C,SAAO,MAAM,MAAM,oBAAoB,MAAM;AAC/C;AAEO,SAAS,aACd,QAC2C;AAC3C,SAAO,MAAM,MAAM,kBAAkB,MAAM;AAC7C;AAEO,SAAS,iBACd,QAC+C;AAC/C,SAAO,MAAM,MAAM,sBAAsB,MAAM;AACjD;AAEO,SAAS,aACd,QAC2C;AAC3C,SAAO,MAAM,MAAM,kBAAkB,MAAM;AAC7C;AAEO,SAAS,YACd,QAC0C;AAC1C,SAAO,MAAM,MAAM,iBAAiB,MAAM;AAC5C;AAEO,SAAS,uBACd,QAC0D;AAC1D,SAAO,MAAM,MAAM,iCAAiC,MAAM;AAC5D;AAKO,SAAS,yBAAyB,gBAAoC;AAC3E,SAAO;AAAA,IACL,UAAU,CAAC,MAAc,OAAgB,YAAgC;AACvE,UAAI,wBAAwB,IAAI,GAAG;AACjC,eAAO,kBAAkB,MAAM,OAAO;AAAA,UACpC,GAAG;AAAA,UACH,GAAG;AAAA,QACL,CAAC;AAAA,MACH;AACA,aAAO,kBAAkB,UAAU,OAAO;AAAA,QACxC,GAAG;AAAA,QACH,GAAG;AAAA,MACL,CAAC;AAAA,IACH;AAAA,IACA,oBAAoB,CAAC,WAAoB,YACvC,4BAA4B,WAAW,EAAE,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAAA,IAC1E,gBAAgB,CACd,QACA,QACA,YAEA,6BAAgC,QAAQ,QAAQ;AAAA,MAC9C,GAAG;AAAA,MACH,GAAG;AAAA,IACL,CAAC;AAAA,EACL;AACF;AAGO,IAAM,qBAAqB,yBAAyB;AAAA,EACzD,OAAO;AAAA,EACP,eAAe;AACjB,CAAC;AAEM,IAAM,2BAA2B,yBAAyB;AAAA,EAC/D,OAAO;AAAA,EACP,eAAe;AAAA,EACf,WAAW;AACb,CAAC;;;AHnGM,IAAM,WAAW;AAAA;AAAA,EAEtB,UAAU,CAAC,SAAkB,kBAAkB,SAAS,IAAI;AAAA,EAC5D,cAAc,CAAC,cACb,kBAAkB,aAAa,SAAS;AAAA;AAAA,EAG1C,OAAO,CAAC,SAAkB,eAAe,SAAS,IAAI;AAAA,EACtD,WAAW,CAAC,cACV,eAAe,aAAa,SAAS;AAAA;AAAA,EAGvC,WAAW,CAAC,MAAc,UACxB,mBAAmB,SAAS,MAAM,KAAK;AAAA,EACzC,qBAAqB,CAAC,cACpB,mBAAmB,mBAAmB,SAAS;AAAA;AAAA,EAGjD,YAAY,CAAC,eACX,WAAW,IAAI,CAAC,MAAM,mBAAmB,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;AAAA;AAAA,EAGpE,YAAY,CAAC,SAAkB;AAC7B,UAAM,SAAS,kBAAkB,SAAS,IAAI;AAC9C,WAAO,OAAO;AAAA,EAChB;AAAA,EACA,SAAS,CAAC,SAAkB;AAC1B,UAAM,SAAS,eAAe,SAAS,IAAI;AAC3C,WAAO,OAAO;AAAA,EAChB;AAAA,EACA,aAAa,CAAC,MAAc,UAAmB;AAC7C,UAAM,SAAS,mBAAmB,SAAS,MAAM,KAAK;AACtD,WAAO,OAAO;AAAA,EAChB;AACF;AAMO,IAAM,iBAAiB;AAAA,EAC5B,UAAU,CAAC,SAAkB,wBAAwB,SAAS,IAAI;AAAA,EAClE,cAAc,CAAC,cACb,wBAAwB,aAAa,SAAS;AAAA,EAChD,OAAO,CAAC,SAAkB,qBAAqB,SAAS,IAAI;AAAA,EAC5D,WAAW,CAAC,cACV,qBAAqB,aAAa,SAAS;AAAA,EAC7C,WAAW,CAAC,MAAc,UACxB,yBAAyB,SAAS,MAAM,KAAK;AAAA,EAC/C,qBAAqB,CAAC,cACpB,yBAAyB,mBAAmB,SAAS;AACzD;","names":["DEFAULT_ERROR_CONFIG"]}

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { GenerateDocumentRequest, GenerateDocumentRequestSchema, GenerateDocumen
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { Static } from '@sinclair/typebox';
 import { ValueError } from '@sinclair/typebox/value';
-export { ERROR_TEMPLATES, collectIndentConflicts, collectNoteRevisionConflicts, componentValidator, comprehensiveValidateDocument, createComponentValidator, createJsonValidator, createThemeValidator, createValidator, deepValidateDocument, getThemeName, getValidationSummary, isColumnsProps, isCustomComponentProps, isHeadingProps, isImageProps, isListProps, isParagraphProps, isReportProps, isSectionProps, isStandardComponentName, isStatisticProps, isTableProps, isThemeConfig, isValidTheme, isValidTheme as isValidThemeJson, isValidationSuccess, strictComponentValidator, strictThemeValidator, themeValidator, transformDocxValueError, transformDocxValueErrors, validate, validateAgainstSchema, validateBatch, validateComponent as validateComponentProps, validateCustomComponentProps, validateJson, validateStrict, validateTheme, validateThemeJson, validateThemeWithEnhancement, validateWithEnhancement } from './validation/unified/index.js';
+export { ERROR_TEMPLATES, collectIndentConflicts, collectNoteRevisionConflicts, collectTextBoxShapeConflicts, componentValidator, comprehensiveValidateDocument, createComponentValidator, createJsonValidator, createThemeValidator, createValidator, deepValidateDocument, getThemeName, getValidationSummary, isColumnsProps, isCustomComponentProps, isHeadingProps, isImageProps, isListProps, isParagraphProps, isReportProps, isSectionProps, isStandardComponentName, isStatisticProps, isTableProps, isThemeConfig, isValidTheme, isValidTheme as isValidThemeJson, isValidationSuccess, strictComponentValidator, strictThemeValidator, themeValidator, transformDocxValueError, transformDocxValueErrors, validate, validateAgainstSchema, validateBatch, validateComponent as validateComponentProps, validateCustomComponentProps, validateJson, validateStrict, validateTheme, validateThemeJson, validateThemeWithEnhancement, validateWithEnhancement } from './validation/unified/index.js';
 import { TextSpaceAfterPropsSchema } from './schemas/custom-components.js';
 export { CustomComponentDefinitionSchema, TextSpaceAfterComponentSchema, TextSpaceAfterProps } from './schemas/custom-components.js';
 export { STANDARD_COMPONENTS_REGISTRY, getAllStandardComponentNames, getStandardComponent } from './schemas/component-registry.js';

package/dist/index.js

@@ -31,7 +31,7 @@ import {
   validateTheme,
   validateThemeJson,
   validateThemeWithEnhancement
-} from "./chunk-HMNKQ7BT.js";
+} from "./chunk-SH3OH4OY.js";
 import {
   GenerateDocumentRequestSchema,
   GenerateDocumentResponseSchema,
@@ -45,6 +45,7 @@ import {
 import {
   collectIndentConflicts,
   collectNoteRevisionConflicts,
+  collectTextBoxShapeConflicts,
   comprehensiveValidateDocument,
   createDocumentValidator,
   createJsonValidator,
@@ -65,7 +66,7 @@ import {
   validateJsonComponent,
   validateJsonDocument,
   validateWithEnhancement
-} from "./chunk-HYY4ZOYL.js";
+} from "./chunk-DYTUITUL.js";
 import {
   ComponentDefinitionSchema,
   StandardComponentDefinitionSchema
@@ -1974,6 +1975,7 @@ export {
   clearComponentNamesCache,
   collectIndentConflicts,
   collectNoteRevisionConflicts,
+  collectTextBoxShapeConflicts,
   compareSemver,
   componentValidator,
   comprehensiveValidateDocument,