@json-to-office/core-docx 0.1.1 → 0.3.0

package/dist/index.js

@@ -6178,42 +6178,15 @@ async function renderHighchartsComponent(component, theme, _themeName) {
 import { Type } from "@sinclair/typebox";
 
 // src/plugin/createComponent.ts
-import { isValidSemver } from "@json-to-office/shared";
+import {
+  createVersion as sharedCreateVersion,
+  createComponent as sharedCreateComponent
+} from "@json-to-office/shared/plugin";
 function createVersion(version) {
-  return version;
+  return sharedCreateVersion(version);
 }
 function createComponent(component) {
-  if (!component.name) {
-    throw new Error("Component name is required");
-  }
-  if (!component.versions || typeof component.versions !== "object") {
-    throw new Error(`Component "${component.name}" requires a versions map`);
-  }
-  const versionKeys = Object.keys(component.versions);
-  if (versionKeys.length === 0) {
-    throw new Error(
-      `Component "${component.name}" must have at least one version`
-    );
-  }
-  for (const key of versionKeys) {
-    if (!isValidSemver(key)) {
-      throw new Error(
-        `Component "${component.name}": invalid semver key "${key}". Expected format: major.minor.patch`
-      );
-    }
-    const entry = component.versions[key];
-    if (!entry.propsSchema) {
-      throw new Error(
-        `Component "${component.name}" version "${key}" requires a propsSchema`
-      );
-    }
-    if (!entry.render || typeof entry.render !== "function") {
-      throw new Error(
-        `Component "${component.name}" version "${key}" requires a render function`
-      );
-    }
-  }
-  return component;
+  return sharedCreateComponent(component);
 }
 
 // src/components/text-space-after.ts
@@ -7092,62 +7065,29 @@ async function runExample(example, options = {}) {
 }
 
 // src/plugin/createDocumentGenerator.ts
+init_styles();
 import { Packer as Packer2 } from "docx";
 
 // src/plugin/version-resolver.ts
-import { latestVersion } from "@json-to-office/shared-docx";
-function resolveComponentVersion(componentName, versions, requestedVersion) {
-  const versionKeys = Object.keys(versions);
-  if (requestedVersion) {
-    const entry = versions[requestedVersion];
-    if (!entry) {
-      throw new Error(
-        `Component "${componentName}" does not have version "${requestedVersion}". Available versions: ${versionKeys.join(", ")}`
-      );
-    }
-    return entry;
-  }
-  const latest = latestVersion(versionKeys);
-  return versions[latest];
-}
+import { resolveComponentVersion } from "@json-to-office/shared/plugin";
 
 // src/plugin/validation.ts
 import {
   validateCustomComponentProps,
+  ComponentValidationError
+} from "@json-to-office/shared/plugin";
+import {
   validateDocument as validateDocumentUnified
 } from "@json-to-office/shared-docx/validation/unified";
-var DuplicateComponentError = class _DuplicateComponentError extends Error {
-  componentName;
-  code = "DUPLICATE_COMPONENT";
-  constructor(componentName) {
-    super(
-      `Cannot register component "${componentName}": a component with this name is already registered. Component names must be unique within a document generator.`
-    );
-    this.name = "DuplicateComponentError";
-    this.componentName = componentName;
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, _DuplicateComponentError);
-    }
-  }
-};
-var ComponentValidationError = class extends Error {
-  errors;
-  props;
-  constructor(errors, props) {
-    const propsStr = props !== void 0 ? `
-Props: ${JSON.stringify(props, null, 2)}` : "";
-    const message = `Document validation failed:
-${errors.map((e) => `  ${e.path}: ${e.message}`).join("\n")}${propsStr}`;
-    super(message);
-    this.name = "ComponentValidationError";
-    this.errors = errors;
-    this.props = props;
-  }
-};
-function validateComponentProps(schema, props) {
+import {
+  DuplicateComponentError,
+  ComponentValidationError as ComponentValidationError2
+} from "@json-to-office/shared/plugin";
+function validateComponentProps(schema, props, componentName) {
   return validateCustomComponentProps(schema.propsSchema, props, {
     clean: true,
-    applyDefaults: true
+    applyDefaults: true,
+    componentName
   });
 }
 function validateDocument(document, customComponents) {
@@ -7174,7 +7114,8 @@ function validateDocument(document, customComponents) {
       );
       const validation = validateComponentProps(
         versionEntry,
-        componentData.props
+        componentData.props,
+        customComponent.name
       );
       if (!validation.valid && validation.errors) {
         const indexedErrors = validation.errors.map(
@@ -7209,7 +7150,7 @@ var cleanComponentProps = getValidatedProps;
 
 // src/plugin/schema.ts
 import { Type as Type2 } from "@sinclair/typebox";
-import { latestVersion as latestVersion2 } from "@json-to-office/shared-docx";
+import { latestVersion } from "@json-to-office/shared-docx";
 import {
   ReportPropsSchema,
   SectionPropsSchema,
@@ -7264,7 +7205,7 @@ function generateComponentSchemas(customComponents) {
   const schemas = {};
   for (const component of customComponents) {
     const versionKeys = Object.keys(component.versions);
-    const latest = latestVersion2(versionKeys);
+    const latest = latestVersion(versionKeys);
     for (const v of versionKeys) {
       const entry = component.versions[v];
       const cacheKey = `component_${component.name}@${v}`;
@@ -7362,45 +7303,29 @@ function mergeSchemas(customComponents, standardSchemas) {
   };
 }
 
-// src/styles/theme-resolver.ts
-init_themes();
-function resolveTheme2(theme) {
-  if (typeof theme === "string") {
-    const resolvedTheme = getTheme(theme);
-    if (resolvedTheme) {
-      return resolvedTheme;
-    }
-    return getTheme("minimal");
-  }
-  if (theme) {
-    return theme;
-  }
-  return getTheme("minimal");
-}
-
-// src/styles/theme-validator.ts
-import { validateTheme as validateThemeUnified } from "@json-to-office/shared-docx/validation/unified";
-function validateTheme(theme) {
-  if (!theme) {
-    return void 0;
-  }
-  if (typeof theme === "string") {
-    return theme;
-  }
-  const result = validateThemeUnified(theme);
-  if (!result.valid) {
-    const errorSummary = result.errors?.map((e) => e.message).join(", ") || "Invalid theme";
-    throw new Error(`Invalid theme: ${errorSummary}`);
-  }
-  return result.data;
-}
-
 // src/plugin/createDocumentGenerator.ts
 function createBuilderImpl(state) {
-  const validatedTheme = validateTheme(state.theme);
-  const fullTheme = resolveTheme2(validatedTheme);
   const componentMap = new Map(state.components.map((c) => [c.name, c]));
-  async function processDocumentComponents(components, warningsCollector) {
+  function resolveDocumentTheme(themeName) {
+    if (state.customThemes) {
+      if (state.customThemes[themeName]) {
+        return state.customThemes[themeName];
+      }
+      const key = Object.keys(state.customThemes).find(
+        (k) => k.toLowerCase() === themeName.toLowerCase()
+      );
+      if (key) {
+        return state.customThemes[key];
+      }
+    }
+    return getThemeWithFallback(themeName);
+  }
+  async function processDocumentComponents(components, warningsCollector, resolvedTheme, depth = 0) {
+    if (depth > 20) {
+      throw new Error(
+        "Maximum component nesting depth exceeded (20). Check for circular component references."
+      );
+    }
     const processedComponents = [];
     for (const componentData of components) {
       const componentName = componentData?.name;
@@ -7430,7 +7355,9 @@ function createBuilderImpl(state) {
           if (componentWithName.children && Array.isArray(componentWithName.children)) {
             nestedChildren = await processDocumentComponents(
               componentWithName.children,
-              warningsCollector
+              warningsCollector,
+              resolvedTheme,
+              depth + 1
             );
           }
           const versionLabel = componentWithName.version ? `${customComponent.name}@${componentWithName.version}` : customComponent.name;
@@ -7444,14 +7371,16 @@ function createBuilderImpl(state) {
           };
           const result = await versionEntry.render({
             props: cleanedProps,
-            theme: fullTheme,
+            theme: resolvedTheme,
             addWarning,
             children: nestedChildren
           });
           const resultComponents = Array.isArray(result) ? result : [result];
           const processedResult = await processDocumentComponents(
             resultComponents,
-            warningsCollector
+            warningsCollector,
+            resolvedTheme,
+            depth + 1
           );
           processedComponents.push(...processedResult);
           if (state.debug) {
@@ -7461,7 +7390,7 @@ function createBuilderImpl(state) {
             );
           }
         } catch (error) {
-          if (error instanceof ComponentValidationError) {
+          if (error instanceof ComponentValidationError2) {
             throw error;
           }
           throw new Error(
@@ -7472,7 +7401,9 @@ function createBuilderImpl(state) {
         if ("children" in componentData && Array.isArray(componentData.children)) {
           const processedNested = await processDocumentComponents(
             componentData.children,
-            warningsCollector
+            warningsCollector,
+            resolvedTheme,
+            depth + 1
           );
           processedComponents.push({
             ...componentData,
@@ -7486,18 +7417,19 @@ function createBuilderImpl(state) {
     return processedComponents;
   }
   function addComponent(component) {
-    if (state.componentNames.has(component.name)) {
-      throw new DuplicateComponentError(component.name);
-    }
     if (!component.name) {
       throw new Error("Component name is required");
     }
+    if (state.componentNames.has(component.name)) {
+      throw new DuplicateComponentError(component.name);
+    }
     const newComponentNames = new Set(state.componentNames);
     newComponentNames.add(component.name);
     const newState = {
       components: [...state.components, component],
       componentNames: newComponentNames,
       theme: state.theme,
+      customThemes: state.customThemes,
       debug: state.debug,
       enableCache: state.enableCache
     };
@@ -7512,10 +7444,13 @@ function createBuilderImpl(state) {
         internalDocument,
         state.components
       );
+      const themeName = internalDocument.props.theme || "minimal";
+      const docTheme = resolveDocumentTheme(themeName);
       const warnings = [];
       const processedComponents = await processDocumentComponents(
         internalDocument.children || [],
-        warnings
+        warnings,
+        docTheme
       );
       const processedDocument = {
         ...internalDocument,
@@ -7524,10 +7459,10 @@ function createBuilderImpl(state) {
       const [finalReportComponent] = normalizeDocument(processedDocument);
       const structure = await processDocument(
         finalReportComponent,
-        fullTheme,
-        "custom"
+        docTheme,
+        themeName
       );
-      const layout = applyLayout(structure.sections, fullTheme, "custom");
+      const layout = applyLayout(structure.sections, docTheme, themeName);
       const generatedDocument = await renderDocument(structure, layout);
       return {
         document: generatedDocument,
@@ -7563,7 +7498,7 @@ function createBuilderImpl(state) {
       );
       return { valid: true };
     } catch (error) {
-      if (error instanceof ComponentValidationError) {
+      if (error instanceof ComponentValidationError2) {
         return {
           valid: false,
           errors: error.errors.map((e) => ({
@@ -7603,10 +7538,13 @@ function createBuilderImpl(state) {
         internalDocument,
         state.components
       );
+      const themeName = internalDocument.props.theme || "minimal";
+      const docTheme = resolveDocumentTheme(themeName);
       const warnings = [];
       const processedComponents = await processDocumentComponents(
         internalDocument.children || [],
-        warnings
+        warnings,
+        docTheme
       );
       const processedDocument = {
         ...internalDocument,
@@ -7638,6 +7576,7 @@ function createDocumentGenerator(options) {
     components: [],
     componentNames: /* @__PURE__ */ new Set(),
     theme: options.theme,
+    customThemes: options.customThemes,
     debug: options.debug ?? false,
     enableCache: options.enableCache ?? false
   };
@@ -7656,7 +7595,7 @@ var export_mergeConfigs = cache_exports.mergeConfigs;
 export {
   CacheKeyGenerator,
   export_ComponentCacheAnalytics as ComponentCacheAnalytics,
-  ComponentValidationError,
+  ComponentValidationError2 as ComponentValidationError,
   DocumentGenerator as CoreDocumentGenerator,
   export_DEFAULT_CACHE_CONFIG as DEFAULT_CACHE_CONFIG,
   export_MemoryCache as MemoryCache,