@json-to-office/shared-docx 0.5.3 → 0.6.0

package/dist/{chunk-YNBTESFN.js → chunk-22VYYAC2.js}

@@ -1,14 +1,12 @@
 import {
   ComponentDefinitionSchema,
   StandardComponentDefinitionSchema
-} from "./chunk-CVI7GFWX.js";
+} from "./chunk-YQECZGRR.js";
 import {
   CustomComponentDefinitionSchema
 } from "./chunk-VP3X6DBP.js";
 import {
   ColumnsPropsSchema,
-  FooterPropsSchema,
-  HeaderPropsSchema,
   HeadingPropsSchema,
   ImagePropsSchema,
   ListPropsSchema,
@@ -17,7 +15,7 @@ import {
   SectionPropsSchema,
   StatisticPropsSchema,
   TablePropsSchema
-} from "./chunk-3D6HY6AC.js";
+} from "./chunk-PN6JT3KF.js";
 
 // src/validation/unified/error-transformer.ts
 import {
@@ -284,7 +282,7 @@ function getSuggestion(error, config) {
     return "Ensure the value matches the required format";
   }
   if (path?.includes("name") || path?.includes("type")) {
-    return "Use a valid component name: docx, section, columns, heading, paragraph, image, statistic, table, header, footer, list, toc, text-box, or highcharts";
+    return "Use a valid component name: docx, section, columns, heading, paragraph, image, statistic, table, list, toc, text-box, or highcharts";
   }
   return void 0;
 }
@@ -301,8 +299,6 @@ var COMPONENT_SCHEMAS = {
   list: ListPropsSchema,
   statistic: StatisticPropsSchema,
   columns: ColumnsPropsSchema,
-  header: HeaderPropsSchema,
-  footer: FooterPropsSchema,
   custom: CustomComponentDefinitionSchema
 };
 function deepValidateDocument(data) {
@@ -747,4 +743,4 @@ export {
   validateJsonComponent,
   validateDocumentWithSchema
 };
-//# sourceMappingURL=chunk-YNBTESFN.js.map
+//# sourceMappingURL=chunk-22VYYAC2.js.map

package/dist/chunk-22VYYAC2.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') || path?.includes('modules')) {\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, or highcharts';\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 {\n  ReportPropsSchema,\n  SectionPropsSchema,\n  HeadingPropsSchema,\n  ParagraphPropsSchema,\n  TablePropsSchema,\n  ImagePropsSchema,\n  ListPropsSchema,\n  StatisticPropsSchema,\n  ColumnsPropsSchema,\n} from '../../schemas/components';\nimport { CustomComponentDefinitionSchema } from '../../schemas/custom-components';\nimport { transformValueErrors } from './error-transformer';\n\n// Map of component names to their schemas\nconst COMPONENT_SCHEMAS: Record<string, TSchema> = {\n  report: ReportPropsSchema,\n  section: SectionPropsSchema,\n  heading: HeadingPropsSchema,\n  paragraph: ParagraphPropsSchema,\n  table: TablePropsSchema,\n  image: ImagePropsSchema,\n  list: ListPropsSchema,\n  statistic: StatisticPropsSchema,\n  columns: ColumnsPropsSchema,\n  custom: CustomComponentDefinitionSchema,\n};\n\n/**\n * Deep validate a document to collect ALL errors, not just union-level errors\n */\nexport function deepValidateDocument(data: any): 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 (data.name !== 'docx') {\n    allErrors.push({\n      path: '/name',\n      message: `Invalid name \"${data.name}\". Expected \"docx\"`,\n      code: 'invalid_value',\n    });\n  }\n\n  // Validate props section if present and name is docx\n  if (data.name === 'docx' && data.props) {\n    const propsErrors = validateComponentProps('docx', data.props, '/props');\n    allErrors.push(...propsErrors);\n  }\n\n  // Validate children array\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  } else {\n    // Validate each child component\n    data.children.forEach((child: any, index: number) => {\n      const childPath = `/children/${index}`;\n\n      if (!child || typeof child !== 'object') {\n        allErrors.push({\n          path: childPath,\n          message: 'Component must be an object',\n          code: 'invalid_type',\n        });\n        return;\n      }\n\n      // Check component name\n      if (!child.name) {\n        allErrors.push({\n          path: `${childPath}/name`,\n          message: 'Component missing required field \"name\"',\n          code: 'required_property',\n        });\n        return;\n      }\n\n      // Validate component props based on name\n      if (child.props) {\n        const componentErrors = validateComponentProps(\n          child.name,\n          child.props,\n          `${childPath}/props`\n        );\n        allErrors.push(...componentErrors);\n      } else if (child.name !== 'custom') {\n        // Most components require props\n        allErrors.push({\n          path: `${childPath}/props`,\n          message: 'Component missing required field \"props\"',\n          code: 'required_property',\n        });\n      }\n\n      // Special handling for section components (recursive)\n      if (child.name === 'section' && child.children) {\n        if (!Array.isArray(child.children)) {\n          allErrors.push({\n            path: `${childPath}/children`,\n            message: 'Section children must be an array',\n            code: 'invalid_type',\n          });\n        } else {\n          // Recursively validate nested components\n          child.children.forEach((nestedChild: any, nestedIndex: number) => {\n            const nestedChildPath = `${childPath}/children/${nestedIndex}`;\n            if (!nestedChild || typeof nestedChild !== 'object') {\n              allErrors.push({\n                path: nestedChildPath,\n                message: 'Nested component must be an object',\n                code: 'invalid_type',\n              });\n              return;\n            }\n\n            if (!nestedChild.name) {\n              allErrors.push({\n                path: `${nestedChildPath}/name`,\n                message: 'Nested component missing required field \"name\"',\n                code: 'required_property',\n              });\n            } else {\n              if (nestedChild.props) {\n                const nestedErrors = validateComponentProps(\n                  nestedChild.name,\n                  nestedChild.props,\n                  `${nestedChildPath}/props`\n                );\n                allErrors.push(...nestedErrors);\n              } else if (nestedChild.name !== 'custom') {\n                // Most components require props\n                allErrors.push({\n                  path: `${nestedChildPath}/props`,\n                  message: 'Component missing required field \"props\"',\n                  code: 'required_property',\n                });\n              }\n            }\n          });\n        }\n      }\n    });\n  }\n\n  return allErrors;\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): 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\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  // Use TypeBox to validate against the specific schema\n  if (!Value.Check(schema, props)) {\n    const valueErrors = [...Value.Errors(schema, props)];\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 */\nexport function comprehensiveValidateDocument(\n  data: any,\n  existingErrors: ValidationError[] = []\n): ValidationError[] {\n  // First, get deep validation errors\n  const deepErrors = deepValidateDocument(data);\n\n  // If we got specific errors from deep validation, prefer those\n  if (deepErrors.length > 0) {\n    // Filter out any generic \"invalid component configurations\" errors\n    const filteredExisting = existingErrors.filter(\n      (e) =>\n        !e.message.includes('invalid module configurations') &&\n        !e.message.includes('invalid component configurations')\n    );\n\n    // Combine and deduplicate\n    const allErrors = [...filteredExisting, ...deepErrors];\n    const uniqueErrors = deduplicateErrors(allErrors);\n\n    return uniqueErrors;\n  }\n\n  // Otherwise return the existing errors\n  return existingErrors;\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 { comprehensiveValidateDocument } from './deep-validator';\n\n// JsonComponentDefinitionSchema is just an alias for ComponentDefinitionSchema\nconst JsonComponentDefinitionSchema = ComponentDefinitionSchema;\nimport type { DocumentValidationResult, ValidationOptions } from './types';\nimport { validateAgainstSchema, validateJson } from './base-validator';\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(ComponentDefinitionSchema, data, options);\n\n  // If validation failed, use deep validation to get all detailed errors\n  let finalErrors = result.errors || [];\n  if (!result.valid && data) {\n    finalErrors = comprehensiveValidateDocument(data, result.errors);\n  }\n\n  // Add document-specific metadata\n  const documentResult: DocumentValidationResult = {\n    ...result,\n    documentType: 'docx',\n    errors: finalErrors, // Use the comprehensive errors\n  };\n\n  // Check if document has custom components\n  if (result.valid && result.data) {\n    const doc = result.data as any;\n    if (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(JsonComponentDefinitionSchema, jsonInput, options);\n\n  // If validation failed, use deep validation to get all detailed errors\n  let finalErrors = result.errors || [];\n  if (!result.valid && result.parsed) {\n    finalErrors = comprehensiveValidateDocument(result.parsed, result.errors);\n  }\n\n  // Add document-specific metadata\n  const documentResult: DocumentValidationResult = {\n    ...result,\n    documentType: 'docx',\n    errors: finalErrors, // Use the comprehensive errors\n  };\n\n  // Check for custom components\n  if (result.valid && result.data) {\n    const doc = result.data as any;\n    if (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-S4EFGCIC.js → chunk-6SLVQATI.js}

@@ -1,6 +1,6 @@
 import {
   ComponentDefinitionSchema
-} from "./chunk-CVI7GFWX.js";
+} from "./chunk-YQECZGRR.js";
 
 // src/schemas/document.ts
 var JsonComponentDefinitionSchema = ComponentDefinitionSchema;
@@ -31,4 +31,4 @@ export {
   JsonComponentDefinitionSchema,
   JSON_SCHEMA_URLS
 };
-//# sourceMappingURL=chunk-S4EFGCIC.js.map
+//# sourceMappingURL=chunk-6SLVQATI.js.map

package/dist/{chunk-EDYWA2KA.js → chunk-ABVYMFDA.js}

@@ -1,6 +1,6 @@
 import {
   ComponentDefinitionSchema
-} from "./chunk-CVI7GFWX.js";
+} from "./chunk-YQECZGRR.js";
 
 // src/schemas/api.ts
 import { Type } from "@sinclair/typebox";
@@ -94,4 +94,4 @@ export {
   GenerateDocumentResponseSchema,
   ValidateDocumentResponseSchema
 };
-//# sourceMappingURL=chunk-EDYWA2KA.js.map
+//# sourceMappingURL=chunk-ABVYMFDA.js.map

package/dist/{chunk-F5LVWDTY.js → chunk-JOXJOD2C.js}

@@ -4,6 +4,10 @@ var HexColorSchema = Type.String({
   pattern: "^(#[0-9A-Fa-f]{6}|[a-zA-Z][a-zA-Z0-9]*)$",
   description: 'Hex color with # prefix (e.g. "#000000") or theme color name'
 });
+var HexColorOrTransparentSchema = Type.String({
+  pattern: "^(transparent|#[0-9A-Fa-f]{6}|[a-zA-Z][a-zA-Z0-9]*)$",
+  description: 'Hex color with # prefix, theme color name, or "transparent"'
+});
 var TextFormattingPropertiesSchema = Type.Object(
   {
     size: Type.Optional(Type.Number({ minimum: 8, maximum: 72 })),
@@ -51,7 +55,8 @@ var FontDefinitionSchema = Type.Object(
 
 export {
   HexColorSchema,
+  HexColorOrTransparentSchema,
   TextFormattingPropertiesSchema,
   FontDefinitionSchema
 };
-//# sourceMappingURL=chunk-F5LVWDTY.js.map
+//# sourceMappingURL=chunk-JOXJOD2C.js.map

package/dist/chunk-JOXJOD2C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/font.ts"],"sourcesContent":["/**\n * Font-related Schemas (shared)\n * Extracted to avoid circular dependencies between theme and module schemas.\n */\n\nimport { Type } from '@sinclair/typebox';\n\n// ----------------------------------------------------------------------------\n// Shared Color Schema\n// ----------------------------------------------------------------------------\n\n/** Hex color with # prefix (e.g. \"#000000\") or a theme color name (e.g. \"primary\") */\nexport const HexColorSchema = Type.String({\n  pattern: '^(#[0-9A-Fa-f]{6}|[a-zA-Z][a-zA-Z0-9]*)$',\n  description: 'Hex color with # prefix (e.g. \"#000000\") or theme color name',\n});\n\n/** Like HexColorSchema but also accepts \"transparent\" (used for backgroundColor) */\nexport const HexColorOrTransparentSchema = Type.String({\n  pattern: '^(transparent|#[0-9A-Fa-f]{6}|[a-zA-Z][a-zA-Z0-9]*)$',\n  description: 'Hex color with # prefix, theme color name, or \"transparent\"',\n});\n\n// ----------------------------------------------------------------------------\n// Shared Text Formatting Properties\n// ----------------------------------------------------------------------------\n\n/**\n * Shared schema for text formatting properties.\n * Used as base for both font definitions and style definitions.\n */\nexport const TextFormattingPropertiesSchema = Type.Object(\n  {\n    size: Type.Optional(Type.Number({ minimum: 8, maximum: 72 })),\n    color: Type.Optional(HexColorSchema),\n    bold: Type.Optional(Type.Boolean()),\n    italic: Type.Optional(Type.Boolean()),\n    underline: Type.Optional(Type.Boolean()),\n    lineSpacing: Type.Optional(\n      Type.Object({\n        type: Type.Union([\n          Type.Literal('single'),\n          Type.Literal('atLeast'),\n          Type.Literal('exactly'),\n          Type.Literal('double'),\n          Type.Literal('multiple'),\n        ]),\n        value: Type.Optional(Type.Number({ minimum: 0 })),\n      })\n    ),\n    spacing: Type.Optional(\n      Type.Object({\n        before: Type.Optional(Type.Number({ minimum: 0 })),\n        after: Type.Optional(Type.Number({ minimum: 0 })),\n      })\n    ),\n    characterSpacing: Type.Optional(\n      Type.Object({\n        type: Type.Union([Type.Literal('condensed'), Type.Literal('expanded')]),\n        value: Type.Number(),\n      })\n    ),\n  },\n  { additionalProperties: false }\n);\n\n// ----------------------------------------------------------------------------\n// Font Definition Schema\n// ----------------------------------------------------------------------------\n\n/**\n * Font definition schema with full text formatting properties.\n * All properties except 'family' are optional.\n */\nexport const FontDefinitionSchema = Type.Object(\n  {\n    family: Type.String(),\n    ...TextFormattingPropertiesSchema.properties,\n  },\n  {\n    description:\n      'Font definition with family and optional formatting properties',\n    additionalProperties: false,\n  }\n);\n"],"mappings":";AAKA,SAAS,YAAY;AAOd,IAAM,iBAAiB,KAAK,OAAO;AAAA,EACxC,SAAS;AAAA,EACT,aAAa;AACf,CAAC;AAGM,IAAM,8BAA8B,KAAK,OAAO;AAAA,EACrD,SAAS;AAAA,EACT,aAAa;AACf,CAAC;AAUM,IAAM,iCAAiC,KAAK;AAAA,EACjD;AAAA,IACE,MAAM,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;AAAA,IAC5D,OAAO,KAAK,SAAS,cAAc;AAAA,IACnC,MAAM,KAAK,SAAS,KAAK,QAAQ,CAAC;AAAA,IAClC,QAAQ,KAAK,SAAS,KAAK,QAAQ,CAAC;AAAA,IACpC,WAAW,KAAK,SAAS,KAAK,QAAQ,CAAC;AAAA,IACvC,aAAa,KAAK;AAAA,MAChB,KAAK,OAAO;AAAA,QACV,MAAM,KAAK,MAAM;AAAA,UACf,KAAK,QAAQ,QAAQ;AAAA,UACrB,KAAK,QAAQ,SAAS;AAAA,UACtB,KAAK,QAAQ,SAAS;AAAA,UACtB,KAAK,QAAQ,QAAQ;AAAA,UACrB,KAAK,QAAQ,UAAU;AAAA,QACzB,CAAC;AAAA,QACD,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AAAA,MAClD,CAAC;AAAA,IACH;AAAA,IACA,SAAS,KAAK;AAAA,MACZ,KAAK,OAAO;AAAA,QACV,QAAQ,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AAAA,QACjD,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AAAA,MAClD,CAAC;AAAA,IACH;AAAA,IACA,kBAAkB,KAAK;AAAA,MACrB,KAAK,OAAO;AAAA,QACV,MAAM,KAAK,MAAM,CAAC,KAAK,QAAQ,WAAW,GAAG,KAAK,QAAQ,UAAU,CAAC,CAAC;AAAA,QACtE,OAAO,KAAK,OAAO;AAAA,MACrB,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EACA,EAAE,sBAAsB,MAAM;AAChC;AAUO,IAAM,uBAAuB,KAAK;AAAA,EACvC;AAAA,IACE,QAAQ,KAAK,OAAO;AAAA,IACpB,GAAG,+BAA+B;AAAA,EACpC;AAAA,EACA;AAAA,IACE,aACE;AAAA,IACF,sBAAsB;AAAA,EACxB;AACF;","names":[]}

package/dist/{chunk-IFSM3GXH.js → chunk-L5TZFC47.js}

@@ -8,12 +8,12 @@ import {
   SectionPropsSchema,
   StatisticPropsSchema,
   TablePropsSchema
-} from "./chunk-3D6HY6AC.js";
+} from "./chunk-PN6JT3KF.js";
 import {
   FontDefinitionSchema,
   HexColorSchema,
   TextFormattingPropertiesSchema
-} from "./chunk-F5LVWDTY.js";
+} from "./chunk-JOXJOD2C.js";
 
 // src/schemas/theme.ts
 import { Type } from "@sinclair/typebox";
@@ -367,4 +367,4 @@ export {
   ThemeConfigSchema,
   isValidThemeConfig
 };
-//# sourceMappingURL=chunk-IFSM3GXH.js.map
+//# sourceMappingURL=chunk-L5TZFC47.js.map

package/dist/{chunk-A325P5FV.js → chunk-OE5JFL7S.js}

@@ -1,22 +1,20 @@
 import {
   ThemeConfigSchema
-} from "./chunk-IFSM3GXH.js";
+} from "./chunk-L5TZFC47.js";
 import {
   documentValidator,
   strictDocumentValidator,
   validateAgainstSchema,
   validateJson
-} from "./chunk-YNBTESFN.js";
+} from "./chunk-22VYYAC2.js";
 import {
   ComponentDefinitionSchema
-} from "./chunk-CVI7GFWX.js";
+} from "./chunk-YQECZGRR.js";
 import {
   CustomComponentDefinitionSchema
 } from "./chunk-VP3X6DBP.js";
 import {
   ColumnsPropsSchema,
-  FooterPropsSchema,
-  HeaderPropsSchema,
   HeadingPropsSchema,
   ImagePropsSchema,
   ListPropsSchema,
@@ -25,7 +23,7 @@ import {
   SectionPropsSchema,
   StatisticPropsSchema,
   TablePropsSchema
-} from "./chunk-3D6HY6AC.js";
+} from "./chunk-PN6JT3KF.js";
 
 // src/validation/unified/index.ts
 import {
@@ -206,8 +204,6 @@ var COMPONENT_SCHEMA_MAP = {
   image: ImagePropsSchema,
   statistic: StatisticPropsSchema,
   table: TablePropsSchema,
-  header: HeaderPropsSchema,
-  footer: FooterPropsSchema,
   list: ListPropsSchema,
   custom: CustomComponentDefinitionSchema
 };
@@ -294,12 +290,6 @@ function isStatisticProps(config) {
 function isTableProps(config) {
   return Value.Check(TablePropsSchema, config);
 }
-function isHeaderProps(config) {
-  return Value.Check(HeaderPropsSchema, config);
-}
-function isFooterProps(config) {
-  return Value.Check(FooterPropsSchema, config);
-}
 function isListProps(config) {
   return Value.Check(ListPropsSchema, config);
 }
@@ -396,8 +386,6 @@ export {
   isImageProps,
   isStatisticProps,
   isTableProps,
-  isHeaderProps,
-  isFooterProps,
   isListProps,
   isCustomComponentProps,
   createComponentValidator,
@@ -426,4 +414,4 @@ export {
   createErrorConfig,
   formatErrorMessage
 };
-//# sourceMappingURL=chunk-A325P5FV.js.map
+//# sourceMappingURL=chunk-OE5JFL7S.js.map

package/dist/chunk-OE5JFL7S.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} 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, DOC_LINKS } 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 * Documentation links for common errors\n */\nexport const DOC_LINKS = {\n  MODULE_TYPES: 'https://docs.json-to-docx.com/modules',\n  THEME_CONFIG: 'https://docs.json-to-docx.com/themes',\n  VALIDATION: 'https://docs.json-to-docx.com/validation',\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":"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","names":["DEFAULT_ERROR_CONFIG"]}