@json-to-office/core-docx 0.23.0 → 0.25.0

package/dist/plugin/createDocumentGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createDocumentGenerator.d.ts","sourceRoot":"","sources":["../../src/plugin/createDocumentGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,KAAK,EAEV,wBAAwB,EAOxB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAmBjB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,oFAAoF;IACpF,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AA8nBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAgBvC"}
+{"version":3,"file":"createDocumentGenerator.d.ts","sourceRoot":"","sources":["../../src/plugin/createDocumentGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,KAAK,EAEV,wBAAwB,EAOxB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAmBjB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,oFAAoF;IACpF,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAqnBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAgBvC"}

package/dist/plugin/example/index.js

@@ -1053,7 +1053,8 @@ function resolveFontProperties(theme, fontRef) {
     alignment: fontDef.alignment,
     lineSpacing: fontDef.lineSpacing,
     spacing: fontDef.spacing,
-    characterSpacing: fontDef.characterSpacing
+    characterSpacing: fontDef.characterSpacing,
+    scale: fontDef.scale
   };
 }
 function mergeFontAndStyleProperties(fontProps, styleOverrides) {
@@ -1914,9 +1915,84 @@ function resolveBuiltInTheme(themeName, options = {}) {
   return getThemeWithFallback(themeName);
 }
 
-// src/plugin/createDocumentGenerator.ts
+// src/core/generationContext.ts
 import { applyExportMode, scopedThemeName } from "@json-to-office/shared";
 
+// src/themes/overrides.ts
+import { createHash } from "crypto";
+function applyThemeOverrides(theme, overrides) {
+  if (!overrides) return theme;
+  const fonts = { ...theme.fonts };
+  for (const [role, def] of Object.entries(overrides.fonts ?? {})) {
+    const key = role;
+    fonts[key] = { ...theme.fonts[key], ...def };
+  }
+  const styles = { ...theme.styles ?? {} };
+  for (const [name, def] of Object.entries(overrides.styles ?? {})) {
+    styles[name] = { ...styles[name], ...def };
+  }
+  return {
+    ...theme,
+    colors: { ...theme.colors, ...overrides.colors ?? {} },
+    fonts,
+    ...Object.keys(styles).length > 0 && { styles }
+  };
+}
+function themeOverridesDigest(overrides) {
+  return createHash("sha256").update(JSON.stringify(overrides)).digest("hex").slice(0, 8);
+}
+
+// src/core/generationContext.ts
+function defaultNamedThemeLookup(themeName, customThemes, warnings) {
+  if (customThemes) {
+    if (customThemes[themeName]) return customThemes[themeName];
+    const themeNameLower = themeName.toLowerCase();
+    const matchingThemeKey = Object.keys(customThemes).find(
+      (key) => key.toLowerCase() === themeNameLower
+    );
+    if (matchingThemeKey) return customThemes[matchingThemeKey];
+    return resolveBuiltInTheme(themeName, { customThemes, warnings });
+  }
+  return resolveBuiltInTheme(themeName, { warnings });
+}
+function resolveThemeContext(documentIn, options = {}) {
+  const { customThemes, fonts, warnings, resolveNamedTheme } = options;
+  if (documentIn.props === null) {
+    throw new Error(
+      "Document `props` is null. Omit it, or provide an object \u2014 a null props cannot carry a theme."
+    );
+  }
+  const document = documentIn.props === void 0 ? { ...documentIn, props: {} } : documentIn;
+  const baseThemeName = document.props.theme || "minimal";
+  let theme = resolveNamedTheme ? resolveNamedTheme(baseThemeName, warnings) : defaultNamedThemeLookup(baseThemeName, customThemes, warnings);
+  const themeOverrides = document.props.themeOverrides;
+  let themeName = baseThemeName;
+  if (themeOverrides) {
+    theme = applyThemeOverrides(theme, themeOverrides);
+    themeName = `${themeName}+ov:${themeOverridesDigest(themeOverrides)}`;
+  }
+  const mode = applyExportMode({ doc: document, theme, fonts });
+  for (const w of mode.warnings) {
+    if (warnings) {
+      warnings.push({
+        component: "fontRegistry",
+        message: w.message,
+        severity: "warning",
+        context: { code: w.code }
+      });
+    } else {
+      console.warn(`[json-to-docx] [${w.code}] ${w.message}`);
+    }
+  }
+  return {
+    document: mode.doc,
+    theme: mode.theme,
+    // Scope by mode too: substitute rewrites the theme in place, so caches
+    // must not share slots with custom-mode runs keyed on the same name.
+    themeName: scopedThemeName(themeName, fonts?.mode)
+  };
+}
+
 // src/core/fontResolution.ts
 import {
   collectFontNamesFromDocx,
@@ -3127,7 +3203,8 @@ function convertRunProperties(merged, theme, defaultColor, defaultSize) {
     ...merged.underline !== void 0 && merged.underline && { underline: { type: "single" } },
     ...merged.characterSpacing && {
       characterSpacing: merged.characterSpacing.type === "condensed" ? -merged.characterSpacing.value : merged.characterSpacing.value
-    }
+    },
+    ...merged.scale && { scale: merged.scale }
   };
 }
 function convertParagraphProperties(merged, styleProps, theme) {
@@ -3201,7 +3278,8 @@ function createWordStyles(themeNameOrObject = "minimal", language) {
           bold: normalStyle?.bold,
           italic: normalStyle?.italic,
           underline: normalStyle?.underline,
-          characterSpacing: normalStyle?.characterSpacing
+          characterSpacing: normalStyle?.characterSpacing,
+          scale: normalStyle?.scale
         });
         return convertRunProperties(merged, theme, theme.colors.text);
       })(),
@@ -3239,7 +3317,8 @@ function createWordStyles(themeNameOrObject = "minimal", language) {
             bold: headingStyle.bold,
             italic: headingStyle.italic,
             underline: headingStyle.underline,
-            characterSpacing: headingStyle.characterSpacing
+            characterSpacing: headingStyle.characterSpacing,
+            scale: headingStyle.scale
           });
           return convertRunProperties(merged, theme, theme.colors.primary, 20);
         })(),
@@ -3305,7 +3384,8 @@ function createWordStyles(themeNameOrObject = "minimal", language) {
             bold: headingStyle.bold,
             italic: headingStyle.italic,
             underline: headingStyle.underline,
-            characterSpacing: headingStyle.characterSpacing
+            characterSpacing: headingStyle.characterSpacing,
+            scale: headingStyle.scale
           });
           return convertRunProperties(merged, theme, theme.colors.primary, 20);
         })(),
@@ -3372,7 +3452,8 @@ function createWordStyles(themeNameOrObject = "minimal", language) {
           bold: titleStyle.bold,
           italic: titleStyle.italic,
           underline: titleStyle.underline,
-          characterSpacing: titleStyle.characterSpacing
+          characterSpacing: titleStyle.characterSpacing,
+          scale: titleStyle.scale
         });
         return convertRunProperties(merged, theme, theme.colors.primary, 20);
       })(),
@@ -3433,7 +3514,8 @@ function createWordStyles(themeNameOrObject = "minimal", language) {
           bold: subtitleStyle.bold,
           italic: subtitleStyle.italic,
           underline: subtitleStyle.underline,
-          characterSpacing: subtitleStyle.characterSpacing
+          characterSpacing: subtitleStyle.characterSpacing,
+          scale: subtitleStyle.scale
         });
         return convertRunProperties(merged, theme, theme.colors.secondary);
       })(),
@@ -3575,7 +3657,8 @@ function createWordStyles(themeNameOrObject = "minimal", language) {
             bold: customStyle.bold,
             italic: customStyle.italic,
             underline: customStyle.underline,
-            characterSpacing: customStyle.characterSpacing
+            characterSpacing: customStyle.characterSpacing,
+            scale: customStyle.scale
           });
           return convertRunProperties(merged, theme, theme.colors.text);
         })(),
@@ -3683,7 +3766,7 @@ __reExport(cache_exports, cache_star);
 import * as cache_star from "@json-to-office/shared/cache";
 
 // src/cache/key-generator.ts
-import { createHash } from "crypto";
+import { createHash as createHash2 } from "crypto";
 var CacheKeyGenerator = class {
   version;
   constructor(version = "1.0") {
@@ -3757,7 +3840,7 @@ var CacheKeyGenerator = class {
    * Create hash
    */
   hash(input) {
-    return createHash("sha256").update(input).digest("hex").substring(0, 16);
+    return createHash2("sha256").update(input).digest("hex").substring(0, 16);
   }
 };
 
@@ -3772,11 +3855,12 @@ function normalizeUnicodeText(text) {
 // src/utils/placeholderProcessor.ts
 import {
   TextRun as TextRun2,
-  PageNumber
+  PageNumber,
+  Tab as Tab2
 } from "docx";
 
 // src/utils/textParser.ts
-import { TextRun, ExternalHyperlink, InternalHyperlink } from "docx";
+import { TextRun, ExternalHyperlink, InternalHyperlink, Tab } from "docx";
 function escapeRegExp(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -3899,28 +3983,49 @@ function createTextRunsWithNewlines(text, baseStyle, options, overrideStyle) {
         ...runStyle.bold !== void 0 && { bold: runStyle.bold },
         ...runStyle.italics !== void 0 && { italics: runStyle.italics },
         ...baseStyle.underline && { underline: baseStyle.underline },
+        ...baseStyle.scale && { scale: baseStyle.scale },
+        ...baseStyle.characterSpacing && {
+          characterSpacing: baseStyle.characterSpacing
+        },
         ...baseStyle.language && { language: baseStyle.language }
       };
       const wholeRunNoProof = baseStyle.noProof === true;
       const wordsForLine = wholeRunNoProof ? void 0 : options.noProofWords;
       let firstSegment = true;
-      const lineRuns = splitByNoProofWords(
-        line,
-        (segment, matched) => {
-          const segNoProof = matched || wholeRunNoProof;
-          const run = new TextRun({
-            text: segment,
-            ...commonProps,
-            ...(matched || baseStyle.noProof !== void 0) && {
-              noProof: segNoProof
-            },
-            ...needsLineBreak && firstSegment && { break: 1 }
-          });
+      const lineRuns = [];
+      const tabSegments = line.split("	");
+      tabSegments.forEach((tabSegment, tabIndex) => {
+        if (tabIndex > 0) {
+          lineRuns.push(
+            new TextRun({
+              children: [new Tab()],
+              ...commonProps,
+              ...needsLineBreak && firstSegment && { break: 1 }
+            })
+          );
           firstSegment = false;
-          return run;
-        },
-        wordsForLine
-      );
+        }
+        if (!tabSegment && tabSegments.length > 1) return;
+        lineRuns.push(
+          ...splitByNoProofWords(
+            tabSegment,
+            (segment, matched) => {
+              const segNoProof = matched || wholeRunNoProof;
+              const run = new TextRun({
+                text: segment,
+                ...commonProps,
+                ...(matched || baseStyle.noProof !== void 0) && {
+                  noProof: segNoProof
+                },
+                ...needsLineBreak && firstSegment && { break: 1 }
+              });
+              firstSegment = false;
+              return run;
+            },
+            wordsForLine
+          )
+        );
+      });
       runs.push(...lineRuns);
     }
   }
@@ -4155,27 +4260,48 @@ function createTextRunsWithNewlines2(text, baseStyle, noProofWords) {
         bold: baseStyle.bold,
         italics: baseStyle.italics,
         underline: baseStyle.underline,
+        ...baseStyle.scale && { scale: baseStyle.scale },
+        ...baseStyle.characterSpacing && {
+          characterSpacing: baseStyle.characterSpacing
+        },
         ...baseStyle.language && { language: baseStyle.language }
       };
       const wholeRunNoProof = baseStyle.noProof === true;
       const wordsForLine = wholeRunNoProof ? void 0 : noProofWords;
       let firstSegment = true;
-      const lineRuns = splitByNoProofWords(
-        line,
-        (segment, matched) => {
-          const run = new TextRun2({
-            text: segment,
-            ...commonProps,
-            ...(matched || baseStyle.noProof !== void 0) && {
-              noProof: matched || wholeRunNoProof
-            },
-            break: needsLineBreak && firstSegment ? 1 : void 0
-          });
+      const lineRuns = [];
+      const tabSegments = line.split("	");
+      tabSegments.forEach((tabSegment, tabIndex) => {
+        if (tabIndex > 0) {
+          lineRuns.push(
+            new TextRun2({
+              children: [new Tab2()],
+              ...commonProps,
+              break: needsLineBreak && firstSegment ? 1 : void 0
+            })
+          );
           firstSegment = false;
-          return run;
-        },
-        wordsForLine
-      );
+        }
+        if (!tabSegment && tabSegments.length > 1) return;
+        lineRuns.push(
+          ...splitByNoProofWords(
+            tabSegment,
+            (segment, matched) => {
+              const run = new TextRun2({
+                text: segment,
+                ...commonProps,
+                ...(matched || baseStyle.noProof !== void 0) && {
+                  noProof: matched || wholeRunNoProof
+                },
+                break: needsLineBreak && firstSegment ? 1 : void 0
+              });
+              firstSegment = false;
+              return run;
+            },
+            wordsForLine
+          )
+        );
+      });
       runs.push(...lineRuns);
     }
   }
@@ -4330,12 +4456,12 @@ function componentHasRevision(component) {
 }
 
 // src/core/cached-render.ts
-import { createHash as createHash2 } from "crypto";
+import { createHash as createHash3 } from "crypto";
 var componentCache = null;
 var cacheKeyGen = null;
 function createThemeHash(theme) {
   const themeString = JSON.stringify(theme);
-  return createHash2("sha256").update(themeString).digest("hex").substring(0, 8);
+  return createHash3("sha256").update(themeString).digest("hex").substring(0, 8);
 }
 function initializeComponentCache(cache) {
   if (cache) {
@@ -4572,6 +4698,12 @@ function createText(content, theme, themeName, options = {}) {
     ...options.underline !== void 0 && {
       underline: options.underline ? { type: "single" } : void 0
     },
+    // Character width scaling in percent (w:w)
+    ...options.scale && { scale: options.scale },
+    // Letter tracking (w:spacing, twentieths of a point; negative = condensed)
+    ...options.characterSpacing && {
+      characterSpacing: options.characterSpacing.type === "condensed" ? -options.characterSpacing.value : options.characterSpacing.value
+    },
     // Proofing: per-run language and/or no-proof. Omitting language lets the
     // run inherit the document default set on docDefaults.
     ...options.language && { language: { value: options.language } },
@@ -4596,7 +4728,7 @@ function createText(content, theme, themeName, options = {}) {
     }
   } else {
     const textRuns = parseTextWithDecorators(normalizedContent, baseTextStyle, {
-      boldColor: options.boldColor,
+      boldColor: options.boldColor ? resolveColor(options.boldColor, theme) : void 0,
       enableHyperlinks: true,
       noProofWords: resolveNoProofWords(theme, options.noProofWords)
     });
@@ -4628,7 +4760,9 @@ function createText(content, theme, themeName, options = {}) {
     },
     ...frameOptions && { frame: frameOptions },
     ...options.keepNext !== void 0 && { keepNext: options.keepNext },
-    ...options.keepLines !== void 0 && { keepLines: options.keepLines }
+    ...options.keepLines !== void 0 && { keepLines: options.keepLines },
+    ...options.indent && { indent: options.indent },
+    ...options.tabStops && options.tabStops.length > 0 && { tabStops: options.tabStops }
   });
 }
 function mapFrameOptions(floating, theme, themeName) {
@@ -4734,6 +4868,12 @@ function createHeading(text, level, theme, _themeName, options = {}) {
     ...options.underline !== void 0 && {
       underline: options.underline ? { type: "single" } : void 0
     },
+    // Character width scaling in percent (w:w)
+    ...options.scale && { scale: options.scale },
+    // Letter tracking (w:spacing, twentieths of a point; negative = condensed)
+    ...options.characterSpacing && {
+      characterSpacing: options.characterSpacing.type === "condensed" ? -options.characterSpacing.value : options.characterSpacing.value
+    },
     // Proofing: per-run language and/or no-proof (see createText).
     ...options.language && { language: { value: options.language } },
     ...options.noProof !== void 0 && { noProof: options.noProof }
@@ -4774,7 +4914,7 @@ function createHeading(text, level, theme, _themeName, options = {}) {
     const headingTextChildren = [];
     if (hasDecorators) {
       const textRuns = parseTextWithDecorators(normalizedText, baseTextStyle, {
-        boldColor: options.boldColor,
+        boldColor: options.boldColor ? resolveColor(options.boldColor, theme) : void 0,
         enableHyperlinks: true,
         noProofWords: headingNoProofWords
       });
@@ -4791,7 +4931,7 @@ function createHeading(text, level, theme, _themeName, options = {}) {
   } else {
     if (hasDecorators) {
       const textRuns = parseTextWithDecorators(normalizedText, baseTextStyle, {
-        boldColor: options.boldColor,
+        boldColor: options.boldColor ? resolveColor(options.boldColor, theme) : void 0,
         enableHyperlinks: true,
         noProofWords: headingNoProofWords
       });
@@ -4807,7 +4947,8 @@ function createHeading(text, level, theme, _themeName, options = {}) {
     // Only override spacing if explicitly provided
     spacing: hasExplicitSpacing ? spacing : void 0,
     ...options.keepNext !== void 0 && { keepNext: options.keepNext },
-    ...options.keepLines !== void 0 && { keepLines: options.keepLines }
+    ...options.keepLines !== void 0 && { keepLines: options.keepLines },
+    ...options.indent && { indent: options.indent }
   });
 }
 async function createImage(path3, theme, themeName, options = {}) {
@@ -5799,6 +5940,8 @@ function renderHeadingComponent(component, theme, themeName) {
       fontWeight: config.font?.fontWeight,
       italic: config.font?.italic,
       underline: config.font?.underline,
+      scale: config.font?.scale,
+      characterSpacing: config.font?.characterSpacing,
       // Proofing: local language override + no-proof toggle + known-words list
       language: config.language,
       noProof: config.noProof,
@@ -5806,6 +5949,8 @@ function renderHeadingComponent(component, theme, themeName) {
       // Pagination control
       keepNext: config.keepNext,
       keepLines: config.keepLines,
+      // Paragraph indentation (w:ind) in twips
+      indent: config.indent,
       // Bookmark ID for internal linking
       bookmarkId,
       // Tracked-change segments (rendered as native Word revisions)
@@ -6086,6 +6231,8 @@ function renderParagraphComponent(component, theme, themeName) {
     fontWeight: resolvedConfig.font?.fontWeight,
     italic: resolvedConfig.font?.italic,
     underline: resolvedConfig.font?.underline,
+    scale: resolvedConfig.font?.scale,
+    characterSpacing: resolvedConfig.font?.characterSpacing,
     // Proofing: local language override + no-proof toggle + known-words list
     language: resolvedConfig.language,
     noProof: resolvedConfig.noProof,
@@ -6098,6 +6245,10 @@ function renderParagraphComponent(component, theme, themeName) {
     keepNext: resolvedConfig.keepNext,
     // Pass keepLines property
     keepLines: resolvedConfig.keepLines,
+    // Paragraph indentation (w:ind) in twips
+    indent: resolvedConfig.indent,
+    // Tab stops (w:tabs); \t characters in text jump to these positions
+    tabStops: resolvedConfig.tabStops,
     // Pass bookmark ID for internal linking
     bookmarkId: resolvedConfig.id,
     // Tracked-change segments (rendered as native Word revisions)
@@ -7947,32 +8098,25 @@ function createBuilderImpl(state) {
         }
       };
       const warnings = [];
-      const baseThemeName = internalDocument.props.theme || "minimal";
-      const docTheme = resolveDocumentTheme(baseThemeName, warnings);
-      const mode = applyExportMode({
-        doc: internalDocument,
-        theme: docTheme,
-        fonts: state.fonts
+      const {
+        document: modedRoot,
+        theme: modedTheme,
+        themeName
+      } = resolveThemeContext(internalDocument, {
+        customThemes: state.customThemes,
+        fonts: state.fonts,
+        warnings,
+        resolveNamedTheme: resolveDocumentTheme
       });
-      const modedTheme = mode.theme;
-      const themeName = scopedThemeName(baseThemeName, state.fonts?.mode);
-      for (const w of mode.warnings) {
-        warnings.push({
-          component: "fontRegistry",
-          message: w.message,
-          severity: "warning",
-          context: { code: w.code }
-        });
-      }
       const processed = await processDocumentComponents(
-        mode.doc.children || [],
+        modedRoot.children || [],
         preserveSet,
         warnings,
         modedTheme,
         validateEmitted
       );
       const processedDocument = {
-        ...mode.doc,
+        ...modedRoot,
         children: processed.standard
       };
       const [modedDoc] = normalizeDocument(processedDocument);
@@ -7993,7 +8137,7 @@ function createBuilderImpl(state) {
         bypassCache: !state.enableCache
       });
       const preservedDefinition = preserveSet ? {
-        ...mode.doc,
+        ...modedRoot,
         children: processed.preserved
       } : void 0;
       return {