@json-to-office/core-docx 0.21.0 → 0.22.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,EAAwB,MAAM,WAAW,CAAC;AAEnE,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;AAknBD;;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,EAAwB,MAAM,WAAW,CAAC;AAEnE,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;AAwnBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAgBvC"}

package/dist/plugin/example/index.js

@@ -362,12 +362,7 @@ var init_minimal_docx_theme = __esm({
       },
       componentDefaults: {
         table: {
-          borders: false,
-          striped: false,
-          headerBackground: "#fafafa",
-          headerColor: "#000000",
-          borderColor: "#f0f0f0",
-          borderWidth: 0.5
+          borderColor: "#f0f0f0"
         },
         list: {
           format: "bullet",
@@ -450,7 +445,12 @@ var init_corporate_docx_theme = __esm({
           keepNext: true,
           alignment: "left",
           borders: {
-            bottom: { style: "single", size: 2, color: "primary", space: 6 }
+            bottom: {
+              style: "single",
+              size: 2,
+              color: "primary",
+              space: 6
+            }
           }
         },
         heading2: {
@@ -490,12 +490,7 @@ var init_corporate_docx_theme = __esm({
       },
       componentDefaults: {
         table: {
-          borders: true,
-          striped: true,
-          headerBackground: "#1a365d",
-          headerColor: "#FFFFFF",
-          borderColor: "#E2E8F0",
-          borderWidth: 0.5
+          borderColor: "#E2E8F0"
         },
         list: {
           format: "bullet",
@@ -612,12 +607,7 @@ var init_modern_docx_theme = __esm({
       },
       componentDefaults: {
         table: {
-          borders: true,
-          striped: false,
-          headerBackground: "#6D28D9",
-          headerColor: "#FFFFFF",
-          borderColor: "#E2E8F0",
-          borderWidth: 0.5
+          borderColor: "#E2E8F0"
         },
         list: {
           format: "bullet",
@@ -718,10 +708,13 @@ function resolveColor(colorValue, theme) {
     );
   }
   const colors = getThemeColors(theme);
-  if (colorValue in colors) {
-    const resolvedColor = colors[colorValue];
+  const resolvedColor = colors[colorValue];
+  if (typeof resolvedColor === "string") {
     return resolveColor(resolvedColor, theme);
   }
+  if (/^[0-9A-Fa-f]{6}$/.test(colorValue)) {
+    return colorValue.toUpperCase();
+  }
   throw new Error(
     `Invalid color value: "${colorValue}". Must be a hex color with # prefix (e.g., "#000000") or a valid theme color name.`
   );
@@ -1960,10 +1953,10 @@ var RESOLVER_MAP = {
   visual: resolveVisualProps
 };
 function resolveComponentDefaults(component, theme) {
-  if (!component.props) return component;
+  const props = component.props ?? {};
   const resolver = RESOLVER_MAP[component.name];
-  const resolvedProps = resolver ? resolver(component.props, theme) : resolveCustomComponentProps(
-    component.props,
+  const resolvedProps = resolver ? resolver(props, theme) : resolveCustomComponentProps(
+    props,
     theme,
     component.name
   );
@@ -2027,8 +2020,11 @@ function createDocumentMetadata(props, generationDate = /* @__PURE__ */ new Date
   return {
     title: props.metadata?.title,
     subtitle: props.metadata?.subtitle,
+    description: props.metadata?.description,
     author: props.metadata?.author,
     company: props.metadata?.company,
+    version: props.metadata?.version,
+    tags: props.metadata?.tags,
     date: props.metadata?.date ? new Date(props.metadata.date) : generationDate
   };
 }
@@ -4693,6 +4689,32 @@ async function createTable(columns, tableConfig, theme, themeName, _options = {}
     borderColor: "000000",
     borderSize: 1
   });
+  const warnedCellColors = /* @__PURE__ */ new Set();
+  const warnCellColor = (code, message) => {
+    if (warnedCellColors.has(message)) return;
+    warnedCellColors.add(message);
+    console.warn(`[json-to-docx] ${code}: ${message}`);
+  };
+  const resolveCellColor = (value, prop) => {
+    if (value === void 0 || value === "auto") return value;
+    if (value === "transparent") {
+      if (prop === "backgroundColor") return value;
+      warnCellColor(
+        "TABLE_CELL_COLOR_INVALID",
+        `"transparent" is not a valid table cell "color"; ignoring it and using the table style color. It only applies to "backgroundColor".`
+      );
+      return void 0;
+    }
+    if (/^[0-9A-Fa-f]{6}$/.test(value)) return value.toUpperCase();
+    try {
+      return resolveColor(value, theme);
+    } catch {
+      const allowed = prop === "backgroundColor" ? '"auto", or "transparent" for no shading' : 'or "auto"';
+      throw new Error(
+        `Invalid table cell ${prop}: "${value}". Must be a hex color with # prefix (e.g. "#000000"), a theme color name, ${allowed}.`
+      );
+    }
+  };
   const normalizeBorderColor = (border) => {
     if (border === void 0) return void 0;
     if (typeof border === "string") {
@@ -4829,8 +4851,14 @@ async function createTable(columns, tableConfig, theme, themeName, _options = {}
       tableDef?.padding
     );
     return {
-      color: cellDef?.color ?? columnDef?.color ?? tableDef?.color ?? defaults.color,
-      backgroundColor: cellDef?.backgroundColor ?? columnDef?.backgroundColor ?? tableDef?.backgroundColor ?? defaults.backgroundColor,
+      color: resolveCellColor(
+        cellDef?.color ?? columnDef?.color ?? tableDef?.color ?? defaults.color,
+        "color"
+      ),
+      backgroundColor: resolveCellColor(
+        cellDef?.backgroundColor ?? columnDef?.backgroundColor ?? tableDef?.backgroundColor ?? defaults.backgroundColor,
+        "backgroundColor"
+      ),
       horizontalAlignment: cellDef?.horizontalAlignment ?? columnDef?.horizontalAlignment ?? tableDef?.horizontalAlignment ?? defaults.horizontalAlignment,
       verticalAlignment: cellDef?.verticalAlignment ?? columnDef?.verticalAlignment ?? tableDef?.verticalAlignment ?? defaults.verticalAlignment,
       font: mergedFont,
@@ -4883,8 +4911,14 @@ async function createTable(columns, tableConfig, theme, themeName, _options = {}
       tableDef?.padding
     );
     return {
-      color: headerDef?.color ?? headerTableDef?.color ?? columnDef?.color ?? tableDef?.color ?? defaults.color,
-      backgroundColor: headerDef?.backgroundColor ?? headerTableDef?.backgroundColor ?? columnDef?.backgroundColor ?? tableDef?.backgroundColor ?? defaults.backgroundColor,
+      color: resolveCellColor(
+        headerDef?.color ?? headerTableDef?.color ?? columnDef?.color ?? tableDef?.color ?? defaults.color,
+        "color"
+      ),
+      backgroundColor: resolveCellColor(
+        headerDef?.backgroundColor ?? headerTableDef?.backgroundColor ?? columnDef?.backgroundColor ?? tableDef?.backgroundColor ?? defaults.backgroundColor,
+        "backgroundColor"
+      ),
       horizontalAlignment: headerDef?.horizontalAlignment ?? headerTableDef?.horizontalAlignment ?? columnDef?.horizontalAlignment ?? tableDef?.horizontalAlignment ?? defaults.horizontalAlignment,
       verticalAlignment: headerDef?.verticalAlignment ?? headerTableDef?.verticalAlignment ?? columnDef?.verticalAlignment ?? tableDef?.verticalAlignment ?? defaults.verticalAlignment,
       font: mergedFont,
@@ -5106,7 +5140,8 @@ async function createTable(columns, tableConfig, theme, themeName, _options = {}
     void 0
   );
   const headerRow = new TableRow({
-    tableHeader: tableConfig.repeatHeaderOnPageBreak,
+    // Headers repeat across page breaks unless explicitly disabled
+    tableHeader: tableConfig.repeatHeaderOnPageBreak ?? true,
     height: headerHeight !== void 0 ? { value: headerHeight * 20, rule: "atLeast" } : void 0,
     children: await Promise.all(
       columns.map(async (column, colIndex) => {
@@ -6437,6 +6472,11 @@ function renderTocComponent(component, theme, context) {
     pageNumbersStart = pageNumbersRange.from;
     pageNumbersEnd = pageNumbersRange.to;
   }
+  if (componentProps.numberingStyle !== void 0) {
+    console.warn(
+      `TOC numberingStyle "${componentProps.numberingStyle}" is ignored: Word's table-of-contents field has no numbering switch. TOC entries inherit numbering from the heading styles they reference.`
+    );
+  }
   const includePageNumbers = componentProps.includePageNumbers !== false;
   const scope = componentProps.scope ?? "auto";
   const effectiveScope = scope === "auto" ? context?.section?.sectionBookmarkId ? "section" : "document" : scope;
@@ -6526,6 +6566,9 @@ function renderTocComponent(component, theme, context) {
   return paragraphs;
 }
 
+// src/components/highcharts.ts
+init_colorUtils();
+
 // src/utils/environment.ts
 function isNodeEnvironment() {
   return typeof process !== "undefined" && process.versions != null && process.versions.node != null && typeof process.versions.node === "string";
@@ -6575,6 +6618,7 @@ async function postJsonToService(opts) {
 }
 
 // src/components/highcharts.ts
+import { DEFAULT_CHART_THEME_COLORS } from "@json-to-office/shared";
 var DEFAULT_EXPORT_SERVER_URL = "http://localhost:7801";
 async function generateChart(config, servicesConfig) {
   if (!isNodeEnvironment()) {
@@ -6615,14 +6659,24 @@ Cause: ${cause}`
     height
   };
 }
+function toChartColor(value, theme) {
+  if (/^#?[0-9A-Fa-f]{6}$/.test(value)) {
+    return value.startsWith("#") ? value : `#${value}`;
+  }
+  try {
+    return `#${resolveColor(value, theme)}`;
+  } catch {
+    return void 0;
+  }
+}
 function withThemeColors(config, theme) {
   const options = config.options;
   if (!options || options.colors || !theme?.colors) return config;
-  const palette = [
-    theme.colors.primary,
-    theme.colors.secondary,
-    theme.colors.accent
-  ].filter((c) => typeof c === "string" && c.length > 0).map((c) => c.startsWith("#") ? c : `#${c}`);
+  const themeColors = theme.colors;
+  const palette = DEFAULT_CHART_THEME_COLORS.map((token) => {
+    const value = themeColors[token];
+    return typeof value === "string" && value.length > 0 ? toChartColor(value, theme) : void 0;
+  }).filter((c) => c !== void 0);
   if (palette.length === 0) return config;
   return {
     ...config,
@@ -6820,6 +6874,22 @@ function getAlignment3(alignment) {
       return AlignmentType5.LEFT;
   }
 }
+function coreProperties(metadata) {
+  const { title, subtitle, description, author, company, version, tags } = metadata;
+  const customProperties = [
+    ...company ? [{ name: "Company", value: company }] : [],
+    ...version ? [{ name: "Version", value: version }] : []
+  ];
+  return {
+    ...title && { title },
+    ...subtitle && { subject: subtitle },
+    ...description && { description },
+    // Word surfaces both names; author is the only person the document knows.
+    ...author && { creator: author, lastModifiedBy: author },
+    ...tags && tags.length > 0 && { keywords: tags.join(", ") },
+    ...customProperties.length > 0 && { customProperties }
+  };
+}
 async function renderDocument(structure, layout, options) {
   return runWithGenerationDate(
     structure.metadata.date,
@@ -6908,6 +6978,7 @@ async function renderDocumentScoped(structure, layout, options) {
   return new Document({
     styles: createWordStyles(structure.theme, structure.language),
     sections,
+    ...coreProperties(structure.metadata),
     features: {
       updateFields: true,
       // Required for TOC fields to update correctly
@@ -7325,13 +7396,13 @@ function toDosTime(date) {
 function canonicalizeDocxBuffer(buffer, generatedAt = DEFAULT_GENERATION_DATE) {
   const zip = new AdmZip2(buffer);
   const isoTimestamp = generatedAt.toISOString();
-  const coreProperties = zip.getEntry("docProps/core.xml");
-  if (coreProperties) {
-    const normalized = coreProperties.getData().toString("utf8").replace(
+  const coreProperties2 = zip.getEntry("docProps/core.xml");
+  if (coreProperties2) {
+    const normalized = coreProperties2.getData().toString("utf8").replace(
       /(<dcterms:(?:created|modified)\b[^>]*>)[^<]*(<\/dcterms:(?:created|modified)>)/g,
       `$1${isoTimestamp}$2`
     );
-    zip.updateFile(coreProperties, Buffer.from(normalized, "utf8"));
+    zip.updateFile(coreProperties2, Buffer.from(normalized, "utf8"));
   }
   const zipTimestamp = toDosTime(generatedAt);
   for (const entry of zip.getEntries()) {
@@ -7530,7 +7601,8 @@ function createBuilderImpl(state) {
   async function generate(document, options) {
     try {
       const preserveSet = resolvePreserveSet(options);
-      const internalDocument = document;
+      const rootIn = document;
+      const internalDocument = rootIn.props === void 0 ? { ...rootIn, props: {} } : rootIn;
       const vOpts = {
         ...state.validation,
         ...options?.validation