@json-to-office/core-docx 0.21.0 → 0.23.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,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"}

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",
@@ -638,10 +628,277 @@ var init_modern_docx_theme = __esm({
   }
 });
 
+// src/templates/themes/apex.docx.theme.json
+var apex_docx_theme_default;
+var init_apex_docx_theme = __esm({
+  "src/templates/themes/apex.docx.theme.json"() {
+    apex_docx_theme_default = {
+      name: "apex",
+      displayName: "Apex Consulting",
+      description: "A premium consulting theme with deep navy, warm amber accents, and authoritative typography",
+      version: "2.0.0",
+      colors: {
+        primary: "#0C2340",
+        secondary: "#1B3A5C",
+        accent: "#D4A843",
+        text: "#1A1A2E",
+        background: "#FFFFFF",
+        border: "#D6DAE0",
+        textPrimary: "#1A1A2E",
+        textSecondary: "#4A5066",
+        textMuted: "#8B91A0",
+        borderPrimary: "#B8BCC6",
+        borderSecondary: "#E8EAF0",
+        backgroundPrimary: "#FFFFFF",
+        backgroundSecondary: "#F4F5F8"
+      },
+      fonts: {
+        heading: { family: "Georgia", size: 26 },
+        body: { family: "Calibri", size: 11 },
+        mono: { family: "Consolas", size: 10 },
+        light: { family: "Georgia", size: 26 }
+      },
+      page: {
+        size: "A4",
+        margins: {
+          top: 1440,
+          bottom: 1440,
+          left: 1200,
+          right: 1200,
+          header: 720,
+          footer: 720,
+          gutter: 0
+        }
+      },
+      styles: {
+        normal: {
+          font: "body",
+          color: "textPrimary",
+          lineSpacing: { type: "multiple", value: 1.4 },
+          alignment: "justify",
+          spacing: { after: 8 }
+        },
+        heading1: {
+          font: "heading",
+          size: 26,
+          bold: false,
+          color: "primary",
+          spacing: { before: 24, after: 12 },
+          keepNext: true,
+          alignment: "left",
+          borders: {
+            bottom: {
+              style: "single",
+              size: 2,
+              color: "accent",
+              space: 6
+            }
+          }
+        },
+        heading2: {
+          font: "heading",
+          size: 18,
+          bold: false,
+          color: "secondary",
+          spacing: { before: 18, after: 8 },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading3: {
+          font: "body",
+          size: 13,
+          bold: true,
+          color: "accent",
+          spacing: { before: 12, after: 6 },
+          keepNext: true,
+          alignment: "left"
+        },
+        title: {
+          font: "light",
+          size: 36,
+          bold: false,
+          color: "primary",
+          alignment: "left",
+          spacing: { before: 0, after: 18 }
+        },
+        subtitle: {
+          font: "body",
+          size: 16,
+          italic: false,
+          color: "textSecondary",
+          alignment: "left",
+          spacing: { before: 0, after: 24 }
+        }
+      },
+      componentDefaults: {
+        table: {
+          borderColor: "#D6DAE0"
+        },
+        list: {
+          format: "bullet",
+          bullet: "\u2022",
+          indent: 3
+        },
+        image: {
+          alignment: "center"
+        },
+        statistic: {
+          alignment: "center"
+        },
+        section: {
+          pageBreak: false
+        },
+        heading: {
+          numbering: false
+        }
+      }
+    };
+  }
+});
+
+// src/templates/themes/devportal.docx.theme.json
+var devportal_docx_theme_default;
+var init_devportal_docx_theme = __esm({
+  "src/templates/themes/devportal.docx.theme.json"() {
+    devportal_docx_theme_default = {
+      name: "devportal",
+      displayName: "Developer Portal",
+      description: "A modern developer-focused theme with cool grays, teal accents, and monospace code styling",
+      version: "2.0.0",
+      colors: {
+        primary: "#0F172A",
+        secondary: "#334155",
+        accent: "#0D9488",
+        text: "#0F172A",
+        background: "#FFFFFF",
+        border: "#E2E8F0",
+        textPrimary: "#0F172A",
+        textSecondary: "#475569",
+        textMuted: "#94A3B8",
+        borderPrimary: "#CBD5E1",
+        borderSecondary: "#F1F5F9",
+        backgroundPrimary: "#FFFFFF",
+        backgroundSecondary: "#F8FAFC"
+      },
+      fonts: {
+        heading: { family: "Helvetica", size: 24 },
+        body: { family: "Calibri", size: 11 },
+        mono: { family: "Consolas", size: 10 },
+        light: { family: "Helvetica", size: 24 }
+      },
+      page: {
+        size: "A4",
+        margins: {
+          top: 1440,
+          bottom: 1440,
+          left: 1080,
+          right: 1080,
+          header: 720,
+          footer: 720,
+          gutter: 0
+        }
+      },
+      styles: {
+        normal: {
+          font: "body",
+          color: "textPrimary",
+          lineSpacing: { type: "multiple", value: 1.5 },
+          alignment: "left",
+          spacing: { after: 8 }
+        },
+        heading1: {
+          font: "heading",
+          size: 24,
+          bold: true,
+          color: "primary",
+          spacing: { before: 24, after: 12 },
+          keepNext: true,
+          alignment: "left",
+          borders: {
+            bottom: {
+              style: "single",
+              size: 1,
+              color: "accent",
+              space: 6
+            }
+          }
+        },
+        heading2: {
+          font: "heading",
+          size: 18,
+          bold: true,
+          color: "secondary",
+          spacing: { before: 18, after: 8 },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading3: {
+          font: "body",
+          size: 13,
+          bold: true,
+          color: "accent",
+          spacing: { before: 12, after: 6 },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading4: {
+          font: "body",
+          size: 12,
+          bold: true,
+          color: "textSecondary",
+          spacing: { before: 8, after: 4 },
+          keepNext: true
+        },
+        title: {
+          font: "heading",
+          size: 32,
+          bold: true,
+          color: "primary",
+          alignment: "left",
+          spacing: { before: 0, after: 12 }
+        },
+        subtitle: {
+          font: "light",
+          size: 16,
+          italic: false,
+          color: "textSecondary",
+          alignment: "left",
+          spacing: { before: 0, after: 24 }
+        }
+      },
+      componentDefaults: {
+        table: {
+          borderColor: "#E2E8F0"
+        },
+        list: {
+          format: "bullet",
+          bullet: "\u2013",
+          indent: 3
+        },
+        image: {
+          alignment: "center"
+        },
+        statistic: {
+          alignment: "center"
+        },
+        section: {
+          pageBreak: false
+        },
+        heading: {
+          numbering: false
+        }
+      }
+    };
+  }
+});
+
 // src/templates/themes/index.ts
 import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
+import {
+  isValidThemeConfig
+} from "@json-to-office/shared-docx";
 function loadThemesFromJson() {
   if (_themesCache) {
     return _themesCache;
@@ -649,7 +906,9 @@ function loadThemesFromJson() {
   const themes2 = {
     minimal: ensureThemeDefaults(minimal_docx_theme_default),
     corporate: ensureThemeDefaults(corporate_docx_theme_default),
-    modern: ensureThemeDefaults(modern_docx_theme_default)
+    modern: ensureThemeDefaults(modern_docx_theme_default),
+    apex: ensureThemeDefaults(apex_docx_theme_default),
+    devportal: ensureThemeDefaults(devportal_docx_theme_default)
   };
   try {
     const __filename2 = fileURLToPath(import.meta.url);
@@ -660,9 +919,18 @@ function loadThemesFromJson() {
       for (const themeName of themeFiles) {
         if (!themes2[themeName]) {
           try {
-            const filePath = path.join(themesDir, `${themeName}.docx.theme.json`);
+            const filePath = path.join(
+              themesDir,
+              `${themeName}.docx.theme.json`
+            );
             const content = fs.readFileSync(filePath, "utf8");
             const parsedTheme = JSON.parse(content);
+            if (!isValidThemeConfig(parsedTheme)) {
+              console.warn(
+                `Skipping theme ${themeName}: does not match the theme schema.`
+              );
+              continue;
+            }
             themes2[themeName] = ensureThemeDefaults(parsedTheme);
           } catch (error) {
             console.warn(
@@ -678,7 +946,7 @@ function loadThemesFromJson() {
   _themesCache = themes2;
   return themes2;
 }
-var _themesCache, themes, getTheme, getThemeWithFallback, minimalTheme, corporateTheme, modernTheme;
+var _themesCache, themes, getTheme, getThemeWithFallback, hasTheme, getThemeNames, minimalTheme, corporateTheme, modernTheme;
 var init_themes = __esm({
   "src/templates/themes/index.ts"() {
     "use strict";
@@ -686,6 +954,8 @@ var init_themes = __esm({
     init_minimal_docx_theme();
     init_corporate_docx_theme();
     init_modern_docx_theme();
+    init_apex_docx_theme();
+    init_devportal_docx_theme();
     _themesCache = null;
     themes = loadThemesFromJson();
     getTheme = (themeName) => {
@@ -700,6 +970,12 @@ var init_themes = __esm({
       }
       return theme;
     };
+    hasTheme = (themeName) => {
+      return themeName in themes;
+    };
+    getThemeNames = () => {
+      return Object.keys(themes);
+    };
     minimalTheme = themes["minimal"];
     corporateTheme = themes["corporate"];
     modernTheme = themes["modern"];
@@ -718,10 +994,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.`
   );
@@ -1308,7 +1587,8 @@ var init_loader = __esm({
 // src/themes/json/index.ts
 import {
   ThemeConfigSchema,
-  isValidThemeConfig
+  isValidThemeConfig as isValidThemeConfig2,
+  createMinimalTheme
 } from "@json-to-office/shared-docx";
 var themeParser, themeLoader;
 var init_json = __esm({
@@ -1616,8 +1896,25 @@ var init_docxImagePositioning = __esm({
 // src/plugin/example/index.ts
 import { Packer as Packer2 } from "docx";
 
+// src/styles/theme-resolver.ts
+init_themes();
+function resolveBuiltInTheme(themeName, options = {}) {
+  if (!hasTheme(themeName)) {
+    const available = [
+      ...getThemeNames(),
+      ...Object.keys(options.customThemes ?? {})
+    ].sort();
+    options.warnings?.push({
+      component: "theme",
+      message: `Theme "${themeName}" not found; falling back to "minimal". Available themes: ${available.join(", ")}.`,
+      severity: "warning",
+      context: { code: "theme_not_found", requested: themeName, available }
+    });
+  }
+  return getThemeWithFallback(themeName);
+}
+
 // src/plugin/createDocumentGenerator.ts
-init_styles();
 import { applyExportMode, scopedThemeName } from "@json-to-office/shared";
 
 // src/core/fontResolution.ts
@@ -1960,10 +2257,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 +2324,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 +4993,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 +5155,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 +5215,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 +5444,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 +6776,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 +6870,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 +6922,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 +6963,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 +7178,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 +7282,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 +7700,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()) {
@@ -7351,7 +7726,7 @@ async function packageDocument(document, options) {
 // src/plugin/createDocumentGenerator.ts
 function createBuilderImpl(state) {
   const componentMap = new Map(state.components.map((c) => [c.name, c]));
-  function resolveDocumentTheme(themeName) {
+  function resolveDocumentTheme(themeName, warnings) {
     if (state.customThemes) {
       if (state.customThemes[themeName]) {
         return state.customThemes[themeName];
@@ -7366,7 +7741,10 @@ function createBuilderImpl(state) {
     if (state.theme) {
       return state.theme;
     }
-    return getThemeWithFallback(themeName);
+    return resolveBuiltInTheme(themeName, {
+      customThemes: state.customThemes,
+      warnings
+    });
   }
   async function processDocumentComponents(components, preserveSet, warningsCollector, resolvedTheme, validateEmitted, depth = 0) {
     if (depth > 20) {
@@ -7530,7 +7908,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
@@ -7567,9 +7946,9 @@ function createBuilderImpl(state) {
           );
         }
       };
-      const baseThemeName = internalDocument.props.theme || "minimal";
-      const docTheme = resolveDocumentTheme(baseThemeName);
       const warnings = [];
+      const baseThemeName = internalDocument.props.theme || "minimal";
+      const docTheme = resolveDocumentTheme(baseThemeName, warnings);
       const mode = applyExportMode({
         doc: internalDocument,
         theme: docTheme,