@json-to-office/shared 0.1.0

package/dist/chunk-ZKD5BAMU.js

@@ -0,0 +1,382 @@
+// src/validation/unified/schema-utils.ts
+var componentNamesCache = /* @__PURE__ */ new Map();
+function isUnionSchema(schema) {
+  return "anyOf" in schema && Array.isArray(schema.anyOf);
+}
+function isObjectSchema(schema) {
+  return schema.type === "object" && "properties" in schema;
+}
+function isLiteralSchema(schema) {
+  return "const" in schema;
+}
+function getObjectSchemaPropertyNames(schema) {
+  if (isObjectSchema(schema)) {
+    return Object.keys(schema.properties);
+  }
+  return [];
+}
+function getLiteralValue(schema) {
+  if (isLiteralSchema(schema)) {
+    return schema.const;
+  }
+  return void 0;
+}
+function extractStandardComponentNames(schema) {
+  if (componentNamesCache.has(schema)) {
+    return componentNamesCache.get(schema);
+  }
+  const names = [];
+  if ("anyOf" in schema && Array.isArray(schema.anyOf)) {
+    for (const componentSchema of schema.anyOf) {
+      if (isObjectSchema(componentSchema)) {
+        const nameProperty = componentSchema.properties?.name;
+        if (nameProperty && isLiteralSchema(nameProperty)) {
+          const nameValue = getLiteralValue(nameProperty);
+          if (typeof nameValue === "string") {
+            names.push(nameValue);
+          }
+        }
+      }
+    }
+  } else if (isObjectSchema(schema)) {
+    const nameProperty = schema.properties?.name ?? schema.properties?.type;
+    if (nameProperty && isLiteralSchema(nameProperty)) {
+      const nameValue = getLiteralValue(nameProperty);
+      if (typeof nameValue === "string") {
+        names.push(nameValue);
+      }
+    }
+  }
+  componentNamesCache.set(schema, names);
+  return names;
+}
+function clearComponentNamesCache() {
+  componentNamesCache.clear();
+}
+function getSchemaMetadata(schema) {
+  const metadata = {};
+  if ("type" in schema) {
+    metadata.type = String(schema.type);
+  }
+  if (isObjectSchema(schema)) {
+    metadata.properties = getObjectSchemaPropertyNames(schema);
+  }
+  if (isLiteralSchema(schema)) {
+    metadata.literal = getLiteralValue(schema);
+  }
+  return metadata;
+}
+
+// src/validation/unified/error-formatter-config.ts
+function isCI() {
+  if (typeof process === "undefined" || !process.env) return false;
+  return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI);
+}
+function hasColorSupport() {
+  if (typeof process === "undefined") return false;
+  if (process.env?.NO_COLOR) return false;
+  if (process.env?.FORCE_COLOR) return true;
+  if (process.stdout?.isTTY) return true;
+  return !isCI();
+}
+var DEFAULT_ERROR_CONFIG = {
+  includeEmojis: !isCI(),
+  verbosity: "normal",
+  includeSuggestions: true,
+  includePath: true,
+  maxMessageLength: 0,
+  includeDocLinks: false,
+  colorSupport: hasColorSupport()
+};
+function createErrorConfig(config) {
+  return { ...DEFAULT_ERROR_CONFIG, ...config };
+}
+var ERROR_EMOJIS = {
+  ERROR: "\u274C",
+  WARNING: "\u26A0\uFE0F",
+  FIX: "\u{1F527}",
+  INFO: "\u2139\uFE0F",
+  SUCCESS: "\u2705"
+};
+function formatErrorMessage(message, config) {
+  if (config.maxMessageLength > 0 && message.length > config.maxMessageLength) {
+    return message.substring(0, config.maxMessageLength) + "...";
+  }
+  return message;
+}
+
+// src/validation/unified/error-transformer.ts
+function generateEnhancedMessage(error, _config) {
+  const typeStr = String(error.type || "");
+  const path = error.path || "root";
+  if (typeStr === "62" || typeStr === "union") {
+    return generateUnionErrorMessage(error);
+  }
+  if (error.message?.includes("additionalProperties")) {
+    return generateAdditionalPropertiesMessage(error);
+  }
+  if (error.message?.includes("Required property")) {
+    return generateRequiredPropertyMessage(error);
+  }
+  if (typeStr === "string" || typeStr === "number" || typeStr === "boolean" || typeStr === "array" || typeStr === "object") {
+    return generateTypeMismatchMessage(error);
+  }
+  if (typeStr === "literal") {
+    return generateLiteralErrorMessage(error);
+  }
+  if (typeStr === "pattern" || typeStr === "RegExp") {
+    return generatePatternErrorMessage(error);
+  }
+  return `At ${path}: ${error.message}`;
+}
+function generateUnionErrorMessage(error) {
+  const path = error.path || "root";
+  const value = error.value;
+  if (path === "root" || path === "/" || path === "/jsonDefinition") {
+    if (value && typeof value === "object") {
+      if ("name" in value) {
+        return `Invalid component configuration for '${value.name}'. Check that all required fields are present.`;
+      }
+      if ("children" in value && Array.isArray(value.children)) {
+        return "Document is missing required 'name' field.";
+      }
+    }
+    return "Invalid document structure. Check required fields.";
+  }
+  if (path.includes("/children/")) {
+    if (value && typeof value === "object" && "name" in value) {
+      const componentType = value.name;
+      return `Invalid component configuration for type '${componentType}'. Check that all required fields are present and correctly formatted.`;
+    }
+    return 'Invalid component structure. Each component must have a "name" field and valid configuration.';
+  }
+  return `Value at ${path} doesn't match any of the expected formats. Check the structure and required fields.`;
+}
+function generateAdditionalPropertiesMessage(error) {
+  const path = error.path || "root";
+  const value = error.value;
+  if (typeof value === "object" && value !== null) {
+    const schema = error.schema;
+    if (schema && isObjectSchema(schema)) {
+      const knownProps = getObjectSchemaPropertyNames(schema);
+      const actualProps = Object.keys(value);
+      const unknownProps = actualProps.filter((p) => !knownProps.includes(p));
+      if (unknownProps.length > 0) {
+        return `Unknown properties at ${path}: ${unknownProps.join(", ")}. Allowed properties are: ${knownProps.join(", ")}`;
+      }
+    }
+  }
+  return `Additional properties not allowed at ${path}. Check for typos or unsupported fields.`;
+}
+function generateRequiredPropertyMessage(error) {
+  const path = error.path || "root";
+  const match = error.message?.match(/Required property '([^']+)'/);
+  if (match) {
+    const propName = match[1];
+    return `Missing required field '${propName}' at ${path}. This field is mandatory.`;
+  }
+  return `Missing required property at ${path}. Check that all mandatory fields are present.`;
+}
+function generateTypeMismatchMessage(error) {
+  const path = error.path || "root";
+  const expectedType = String(error.type);
+  const actualType = Array.isArray(error.value) ? "array" : typeof error.value;
+  if (path.includes("alignment")) {
+    return `Invalid alignment value at ${path}. Expected one of: left, center, right, justify`;
+  }
+  if (path.includes("color")) {
+    return `Invalid color value at ${path}. Use hex format (#RRGGBB), rgb(r,g,b), or a named color`;
+  }
+  if (path.includes("fontSize") || path.includes("size")) {
+    return `Invalid size value at ${path}. Expected a number (in points)`;
+  }
+  if (path.includes("margin") || path.includes("padding") || path.includes("spacing")) {
+    return `Invalid spacing value at ${path}. Expected a number or spacing object with top/bottom/left/right`;
+  }
+  return `Type mismatch at ${path}: Expected ${expectedType} but got ${actualType}`;
+}
+function generateLiteralErrorMessage(error) {
+  const path = error.path || "root";
+  const expected = error.schema ? JSON.stringify(getLiteralValue(error.schema)) : "specific value";
+  const actual = JSON.stringify(error.value);
+  return `Invalid value at ${path}: Expected exactly ${expected} but got ${actual}`;
+}
+function generatePatternErrorMessage(error) {
+  const path = error.path || "root";
+  if (path.includes("email")) {
+    return `Invalid email format at ${path}. Use format: user@example.com`;
+  }
+  if (path.includes("url") || path.includes("link")) {
+    return `Invalid URL format at ${path}. Use format: https://example.com`;
+  }
+  if (path.includes("date")) {
+    return `Invalid date format at ${path}. Use ISO format: YYYY-MM-DD`;
+  }
+  return `Value at ${path} doesn't match the required pattern`;
+}
+function transformValueError(error, jsonString, config) {
+  const formatterConfig = createErrorConfig(config);
+  const enhancedMessage = generateEnhancedMessage(error, formatterConfig);
+  const baseError = {
+    path: error.path || "root",
+    message: formatErrorMessage(
+      enhancedMessage || error.message,
+      formatterConfig
+    ),
+    code: String(error.type || "validation_error"),
+    value: error.value
+  };
+  if (formatterConfig.includeSuggestions) {
+    const suggestion = getSuggestion(error, formatterConfig);
+    if (suggestion) {
+      baseError.suggestion = formatErrorMessage(suggestion, formatterConfig);
+    }
+  }
+  if (jsonString && error.path) {
+    const position = calculatePosition(jsonString, error.path);
+    if (position) {
+      baseError.line = position.line;
+      baseError.column = position.column;
+    }
+  }
+  return baseError;
+}
+function transformValueErrors(errors, options) {
+  const maxErrors = options?.maxErrors ?? Number.MAX_SAFE_INTEGER;
+  const result = [];
+  const seenPaths = /* @__PURE__ */ new Set();
+  for (const error of errors) {
+    if (result.length >= maxErrors) break;
+    const errorKey = `${error.path}:${error.type}`;
+    if (!seenPaths.has(errorKey)) {
+      seenPaths.add(errorKey);
+      result.push(transformValueError(error, options?.jsonString, void 0));
+    }
+  }
+  return result;
+}
+function calculatePosition(jsonString, path) {
+  try {
+    const pathParts = path.split("/").filter(Boolean);
+    if (pathParts.length === 0) {
+      return { line: 1, column: 1 };
+    }
+    const lastPart = pathParts[pathParts.length - 1];
+    const searchPattern = `"${lastPart}"`;
+    const index = jsonString.indexOf(searchPattern);
+    if (index === -1) {
+      return { line: 1, column: 1 };
+    }
+    const beforeError = jsonString.substring(0, index);
+    const lines = beforeError.split("\n");
+    const line = lines.length;
+    const column = lines[lines.length - 1].length + 1;
+    return { line, column };
+  } catch {
+    return null;
+  }
+}
+function getSuggestion(error, _config) {
+  const { type, path } = error;
+  const typeStr = String(type);
+  if (typeStr === "62" || typeStr === "union") {
+    if (path === "root" || path === "/") {
+      return 'Ensure the document has proper structure with a root "name" field';
+    }
+    if (path?.includes("/children/")) {
+      return 'Check that the component has a valid "name" and all required fields';
+    }
+    return "Review the structure and ensure all required fields are present with correct types";
+  }
+  if (error.message?.includes("additionalProperties")) {
+    return "Remove any unknown or unsupported fields.";
+  }
+  if (error.message?.includes("Required property")) {
+    return "Add the missing required field to fix this error";
+  }
+  if (typeStr === "string") {
+    if (path?.includes("color")) {
+      return "Use a valid color format (hex: #RRGGBB, rgb: rgb(r,g,b), or named color)";
+    }
+    return "Provide a text string value";
+  }
+  if (typeStr === "number") {
+    return "Provide a numeric value";
+  }
+  if (typeStr === "boolean") {
+    return "Use true or false (without quotes)";
+  }
+  if (typeStr === "array") {
+    return "Provide an array of values using square brackets []";
+  }
+  if (typeStr === "object") {
+    return "Provide an object with key-value pairs using curly braces {}";
+  }
+  if (typeStr === "literal") {
+    const expected = error.schema ? JSON.stringify(getLiteralValue(error.schema)) : "specific value";
+    return `Use exactly this value: ${expected}`;
+  }
+  return void 0;
+}
+function formatErrorSummary(errors) {
+  if (errors.length === 0) return "No errors";
+  if (errors.length === 1) {
+    return errors[0].message;
+  }
+  const summary = errors.slice(0, 3).map((e) => `${e.path}: ${e.message}`).join(", ");
+  if (errors.length > 3) {
+    return `${summary} and ${errors.length - 3} more...`;
+  }
+  return summary;
+}
+function groupErrorsByPath(errors) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const error of errors) {
+    const path = error.path || "root";
+    const group = grouped.get(path) || [];
+    group.push(error);
+    grouped.set(path, group);
+  }
+  return grouped;
+}
+function createJsonParseError(error, jsonString) {
+  const match = error.message.match(/position (\d+)/);
+  const position = match ? parseInt(match[1], 10) : 0;
+  let line = 1;
+  let column = 1;
+  if (position > 0) {
+    const lines = jsonString.substring(0, position).split("\n");
+    line = lines.length;
+    column = lines[lines.length - 1].length + 1;
+  }
+  return {
+    path: "root",
+    message: `JSON Parse Error: ${error.message}`,
+    code: "json_parse_error",
+    line,
+    column,
+    suggestion: "Check for missing commas, quotes, or brackets"
+  };
+}
+
+export {
+  isUnionSchema,
+  isObjectSchema,
+  isLiteralSchema,
+  getObjectSchemaPropertyNames,
+  getLiteralValue,
+  extractStandardComponentNames,
+  clearComponentNamesCache,
+  getSchemaMetadata,
+  DEFAULT_ERROR_CONFIG,
+  createErrorConfig,
+  ERROR_EMOJIS,
+  formatErrorMessage,
+  transformValueError,
+  transformValueErrors,
+  calculatePosition,
+  formatErrorSummary,
+  groupErrorsByPath,
+  createJsonParseError
+};
+//# sourceMappingURL=chunk-ZKD5BAMU.js.map

package/dist/chunk-ZKD5BAMU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validation/unified/schema-utils.ts","../src/validation/unified/error-formatter-config.ts","../src/validation/unified/error-transformer.ts"],"sourcesContent":["import type { TSchema, TUnion, TObject, TLiteral } from '@sinclair/typebox';\n\nconst componentNamesCache = new Map<unknown, string[]>();\n\nexport function isUnionSchema(schema: TSchema): schema is TUnion {\n  return 'anyOf' in schema && Array.isArray(schema.anyOf);\n}\n\nexport function isObjectSchema(schema: TSchema): schema is TObject {\n  return schema.type === 'object' && 'properties' in schema;\n}\n\nexport function isLiteralSchema(schema: TSchema): schema is TLiteral {\n  return 'const' in schema;\n}\n\nexport function getObjectSchemaPropertyNames(schema: TSchema): string[] {\n  if (isObjectSchema(schema)) {\n    return Object.keys(schema.properties);\n  }\n  return [];\n}\n\nexport function getLiteralValue(schema: TSchema): unknown {\n  if (isLiteralSchema(schema)) {\n    return schema.const;\n  }\n  return undefined;\n}\n\nexport function extractStandardComponentNames(schema: TSchema): string[] {\n  if (componentNamesCache.has(schema)) {\n    return componentNamesCache.get(schema)!;\n  }\n\n  const names: string[] = [];\n\n  if ('anyOf' in schema && Array.isArray(schema.anyOf)) {\n    for (const componentSchema of schema.anyOf) {\n      if (isObjectSchema(componentSchema)) {\n        const nameProperty = componentSchema.properties?.name;\n        if (nameProperty && isLiteralSchema(nameProperty)) {\n          const nameValue = getLiteralValue(nameProperty);\n          if (typeof nameValue === 'string') {\n            names.push(nameValue);\n          }\n        }\n      }\n    }\n  } else if (isObjectSchema(schema)) {\n    const nameProperty = schema.properties?.name ?? schema.properties?.type;\n    if (nameProperty && isLiteralSchema(nameProperty)) {\n      const nameValue = getLiteralValue(nameProperty);\n      if (typeof nameValue === 'string') {\n        names.push(nameValue);\n      }\n    }\n  }\n\n  componentNamesCache.set(schema, names);\n  return names;\n}\n\nexport function clearComponentNamesCache(): void {\n  componentNamesCache.clear();\n}\n\nexport function getSchemaMetadata(schema: TSchema): {\n  type?: string;\n  properties?: string[];\n  literal?: unknown;\n} {\n  const metadata: {\n    type?: string;\n    properties?: string[];\n    literal?: unknown;\n  } = {};\n\n  if ('type' in schema) {\n    metadata.type = String(schema.type);\n  }\n\n  if (isObjectSchema(schema)) {\n    metadata.properties = getObjectSchemaPropertyNames(schema);\n  }\n\n  if (isLiteralSchema(schema)) {\n    metadata.literal = getLiteralValue(schema);\n  }\n\n  return metadata;\n}\n","export interface ErrorFormatterConfig {\n  includeEmojis?: boolean;\n  verbosity?: 'minimal' | 'normal' | 'detailed';\n  includeSuggestions?: boolean;\n  includePath?: boolean;\n  maxMessageLength?: number;\n  includeDocLinks?: boolean;\n  colorSupport?: boolean;\n}\n\nfunction isCI(): boolean {\n  if (typeof process === 'undefined' || !process.env) return false;\n  return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI);\n}\n\nfunction hasColorSupport(): boolean {\n  if (typeof process === 'undefined') return false;\n  if (process.env?.NO_COLOR) return false;\n  if (process.env?.FORCE_COLOR) return true;\n  if (process.stdout?.isTTY) return true;\n  return !isCI();\n}\n\nexport const DEFAULT_ERROR_CONFIG: Required<ErrorFormatterConfig> = {\n  includeEmojis: !isCI(),\n  verbosity: 'normal',\n  includeSuggestions: true,\n  includePath: true,\n  maxMessageLength: 0,\n  includeDocLinks: false,\n  colorSupport: hasColorSupport(),\n};\n\nexport function createErrorConfig(\n  config?: ErrorFormatterConfig\n): Required<ErrorFormatterConfig> {\n  return { ...DEFAULT_ERROR_CONFIG, ...config };\n}\n\nexport const ERROR_EMOJIS = {\n  ERROR: '\\u274c',\n  WARNING: '\\u26a0\\ufe0f',\n  FIX: '\\ud83d\\udd27',\n  INFO: '\\u2139\\ufe0f',\n  SUCCESS: '\\u2705',\n};\n\nexport function formatErrorMessage(\n  message: string,\n  config: Required<ErrorFormatterConfig>\n): string {\n  if (config.maxMessageLength > 0 && message.length > config.maxMessageLength) {\n    return message.substring(0, config.maxMessageLength) + '...';\n  }\n  return message;\n}\n","import type { ValueError } from '@sinclair/typebox/value';\nimport type { ValidationError } from './types';\nimport {\n  isObjectSchema,\n  getObjectSchemaPropertyNames,\n  getLiteralValue,\n} from './schema-utils';\nimport {\n  ErrorFormatterConfig,\n  createErrorConfig,\n  formatErrorMessage,\n} from './error-formatter-config';\n\nexport type { TransformedError } from './types';\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  if (typeStr === '62' || typeStr === 'union') {\n    return generateUnionErrorMessage(error);\n  }\n\n  if (error.message?.includes('additionalProperties')) {\n    return generateAdditionalPropertiesMessage(error);\n  }\n\n  if (error.message?.includes('Required property')) {\n    return generateRequiredPropertyMessage(error);\n  }\n\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  if (typeStr === 'literal') {\n    return generateLiteralErrorMessage(error);\n  }\n\n  if (typeStr === 'pattern' || typeStr === 'RegExp') {\n    return generatePatternErrorMessage(error);\n  }\n\n  return `At ${path}: ${error.message}`;\n}\n\nfunction generateUnionErrorMessage(error: ValueError): string {\n  const path = error.path || 'root';\n  const value = error.value;\n\n  if (path === 'root' || path === '/' || path === '/jsonDefinition') {\n    if (value && typeof value === 'object') {\n      if ('name' in value) {\n        return `Invalid component configuration for '${(value as any).name}'. Check that all required fields are present.`;\n      }\n      if ('children' in value && Array.isArray((value as any).children)) {\n        return 'Document is missing required \\'name\\' field.';\n      }\n    }\n    return 'Invalid document structure. Check required fields.';\n  }\n\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  return `Value at ${path} doesn't match any of the expected formats. Check the structure and required fields.`;\n}\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    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\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.`;\n  }\n\n  return `Missing required property at ${path}. Check that all mandatory fields are present.`;\n}\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  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\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\nfunction generatePatternErrorMessage(error: ValueError): string {\n  const path = error.path || 'root';\n\n  if (path.includes('email')) {\n    return `Invalid email format at ${path}. Use format: user@example.com`;\n  }\n  if (path.includes('url') || path.includes('link')) {\n    return `Invalid URL format at ${path}. Use format: https://example.com`;\n  }\n  if (path.includes('date')) {\n    return `Invalid date format at ${path}. Use ISO format: YYYY-MM-DD`;\n  }\n\n  return `Value at ${path} doesn't match the required pattern`;\n}\n\nexport function transformValueError(\n  error: ValueError,\n  jsonString?: string,\n  config?: ErrorFormatterConfig\n): ValidationError {\n  const formatterConfig = createErrorConfig(config);\n\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  if (formatterConfig.includeSuggestions) {\n    const suggestion = getSuggestion(error, formatterConfig);\n    if (suggestion) {\n      baseError.suggestion = formatErrorMessage(suggestion, formatterConfig);\n    }\n  }\n\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\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  for (const error of errors) {\n    if (result.length >= maxErrors) break;\n\n    const errorKey = `${error.path}:${error.type}`;\n\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\nexport function calculatePosition(\n  jsonString: string,\n  path: string\n): { line: number; column: number } | null {\n  try {\n    const pathParts = path.split('/').filter(Boolean);\n    if (pathParts.length === 0) {\n      return { line: 1, column: 1 };\n    }\n\n    const lastPart = pathParts[pathParts.length - 1];\n    const searchPattern = `\"${lastPart}\"`;\n    const index = jsonString.indexOf(searchPattern);\n\n    if (index === -1) {\n      return { line: 1, column: 1 };\n    }\n\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\nfunction getSuggestion(\n  error: ValueError,\n  _config: Required<ErrorFormatterConfig>\n): string | undefined {\n  const { type, path } = error;\n  const typeStr = String(type);\n\n  if (typeStr === '62' || typeStr === 'union') {\n    if (path === 'root' || path === '/') {\n      return 'Ensure the document has proper structure with a root \"name\" field';\n    }\n    if (path?.includes('/children/')) {\n      return 'Check that the component has a valid \"name\" and all required fields';\n    }\n    return 'Review the structure and ensure all required fields are present with correct types';\n  }\n\n  if (error.message?.includes('additionalProperties')) {\n    return 'Remove any unknown or unsupported fields.';\n  }\n\n  if (error.message?.includes('Required property')) {\n    return 'Add the missing required field to fix this error';\n  }\n\n  if (typeStr === 'string') {\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    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    return 'Provide an array 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  return undefined;\n}\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\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\nexport function createJsonParseError(\n  error: Error,\n  jsonString: string\n): ValidationError {\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"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { C as ComponentDefinition, a as ComponentSchemaConfig, c as convertToJsonSchema, b as createComponentSchema, d as createComponentSchemaObject, e as exportSchemaToFile, f as fixSchemaReferences } from './schema-utils-CbCi6dEk.js';
+export { AddWarningFunction, GenerationWarning } from './types/warnings.js';
+export { DEFAULT_ERROR_CONFIG, ERROR_EMOJIS, ErrorFormatterConfig, TransformedError, ValidationError, ValidationResult, calculatePosition, clearComponentNamesCache, createErrorConfig, createJsonParseError, extractStandardComponentNames, formatErrorMessage, formatErrorSummary, getLiteralValue, getObjectSchemaPropertyNames, getSchemaMetadata, groupErrorsByPath, isLiteralSchema, isObjectSchema, isUnionSchema, transformValueError, transformValueErrors } from './validation/unified/index.js';
+export { ParsedSemver, compareSemver, isValidSemver, latestVersion, parseSemver } from './utils/semver.js';
+import '@sinclair/typebox';
+import '@sinclair/typebox/value';

package/dist/index.js

@@ -0,0 +1,63 @@
+import {
+  convertToJsonSchema,
+  createComponentSchema,
+  createComponentSchemaObject,
+  exportSchemaToFile,
+  fixSchemaReferences
+} from "./chunk-5J43F4XD.js";
+import {
+  compareSemver,
+  isValidSemver,
+  latestVersion,
+  parseSemver
+} from "./chunk-244MHDOZ.js";
+import {
+  DEFAULT_ERROR_CONFIG,
+  ERROR_EMOJIS,
+  calculatePosition,
+  clearComponentNamesCache,
+  createErrorConfig,
+  createJsonParseError,
+  extractStandardComponentNames,
+  formatErrorMessage,
+  formatErrorSummary,
+  getLiteralValue,
+  getObjectSchemaPropertyNames,
+  getSchemaMetadata,
+  groupErrorsByPath,
+  isLiteralSchema,
+  isObjectSchema,
+  isUnionSchema,
+  transformValueError,
+  transformValueErrors
+} from "./chunk-ZKD5BAMU.js";
+export {
+  DEFAULT_ERROR_CONFIG,
+  ERROR_EMOJIS,
+  calculatePosition,
+  clearComponentNamesCache,
+  compareSemver,
+  convertToJsonSchema,
+  createComponentSchema,
+  createComponentSchemaObject,
+  createErrorConfig,
+  createJsonParseError,
+  exportSchemaToFile,
+  extractStandardComponentNames,
+  fixSchemaReferences,
+  formatErrorMessage,
+  formatErrorSummary,
+  getLiteralValue,
+  getObjectSchemaPropertyNames,
+  getSchemaMetadata,
+  groupErrorsByPath,
+  isLiteralSchema,
+  isObjectSchema,
+  isUnionSchema,
+  isValidSemver,
+  latestVersion,
+  parseSemver,
+  transformValueError,
+  transformValueErrors
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,43 @@
+import { TSchema } from '@sinclair/typebox';
+
+/**
+ * Base component definition interface, parameterized by category.
+ * Both docx and pptx component registries extend this.
+ */
+interface ComponentDefinition<TCategory extends string = 'container' | 'content' | 'layout'> {
+    name: string;
+    propsSchema: TSchema;
+    hasChildren: boolean;
+    category: TCategory;
+    description: string;
+    special?: {
+        hasSchemaField?: boolean;
+    };
+}
+
+interface ComponentSchemaConfig {
+    schema: TSchema;
+    title: string;
+    description: string;
+    requiresName?: boolean;
+    enhanceForRichContent?: boolean;
+}
+declare function fixSchemaReferences(schema: Record<string, unknown>, rootDefinitionName?: string): void;
+declare function convertToJsonSchema(schema: TSchema, options?: {
+    $schema?: string;
+    $id?: string;
+    title?: string;
+    description?: string;
+    definitions?: Record<string, unknown>;
+}): Record<string, unknown>;
+declare function createComponentSchema(name: string, config: ComponentSchemaConfig, containerNames: string[], componentDefinitionSchema?: TSchema): Record<string, unknown>;
+declare function exportSchemaToFile(schema: Record<string, unknown>, outputPath: string, options?: {
+    prettyPrint?: boolean;
+}): Promise<void>;
+/**
+ * Create a TypeBox schema object for any component definition.
+ * Works for both docx and pptx components.
+ */
+declare function createComponentSchemaObject(component: ComponentDefinition, recursiveRef?: TSchema): TSchema;
+
+export { type ComponentDefinition as C, type ComponentSchemaConfig as a, createComponentSchema as b, convertToJsonSchema as c, createComponentSchemaObject as d, exportSchemaToFile as e, fixSchemaReferences as f };

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

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

package/dist/schemas/schema-utils.js

@@ -0,0 +1,15 @@
+import {
+  convertToJsonSchema,
+  createComponentSchema,
+  createComponentSchemaObject,
+  exportSchemaToFile,
+  fixSchemaReferences
+} from "../chunk-5J43F4XD.js";
+export {
+  convertToJsonSchema,
+  createComponentSchema,
+  createComponentSchemaObject,
+  exportSchemaToFile,
+  fixSchemaReferences
+};
+//# sourceMappingURL=schema-utils.js.map

package/dist/schemas/schema-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/warnings.d.ts

@@ -0,0 +1,9 @@
+interface GenerationWarning {
+    component: string;
+    message: string;
+    severity?: 'warning' | 'info';
+    context?: Record<string, unknown>;
+}
+type AddWarningFunction = (message: string, context?: Record<string, unknown>) => void;
+
+export type { AddWarningFunction, GenerationWarning };

package/dist/types/warnings.js

@@ -0,0 +1 @@
+//# sourceMappingURL=warnings.js.map

package/dist/types/warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/semver.d.ts

@@ -0,0 +1,11 @@
+interface ParsedSemver {
+    major: number;
+    minor: number;
+    patch: number;
+}
+declare function isValidSemver(version: string): boolean;
+declare function parseSemver(version: string): ParsedSemver;
+declare function compareSemver(a: string, b: string): number;
+declare function latestVersion(versions: string[]): string;
+
+export { type ParsedSemver, compareSemver, isValidSemver, latestVersion, parseSemver };

package/dist/utils/semver.js

@@ -0,0 +1,13 @@
+import {
+  compareSemver,
+  isValidSemver,
+  latestVersion,
+  parseSemver
+} from "../chunk-244MHDOZ.js";
+export {
+  compareSemver,
+  isValidSemver,
+  latestVersion,
+  parseSemver
+};
+//# sourceMappingURL=semver.js.map

package/dist/utils/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}