@json-to-office/core-docx 0.20.0 → 0.22.0

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.`
   );
@@ -1613,219 +1606,11 @@ var init_docxImagePositioning = __esm({
   }
 });
 
-// src/utils/numberingConfig.ts
-var numberingConfig_exports = {};
-__export(numberingConfig_exports, {
-  NumberingRegistry: () => NumberingRegistry,
-  createBulletListConfig: () => createBulletListConfig,
-  createNumberedListConfig: () => createNumberedListConfig,
-  createNumberingConfig: () => createNumberingConfig,
-  globalNumberingRegistry: () => globalNumberingRegistry
-});
-import { AlignmentType as AlignmentType3, convertInchesToTwip, LevelFormat } from "docx";
-function getLevelFormat(format2) {
-  if (!format2) return LevelFormat.BULLET;
-  return LEVEL_FORMAT_MAP[format2] || LevelFormat.BULLET;
-}
-function getAlignment2(alignment) {
-  if (!alignment) return AlignmentType3.LEFT;
-  return ALIGNMENT_MAP[alignment] || AlignmentType3.LEFT;
-}
-function createDefaultLevel(level, format2 = LevelFormat.BULLET, text) {
-  const baseIndent = 0.5 * (level + 1);
-  const hangingIndent = 0.25;
-  return {
-    level,
-    format: format2,
-    text: text || (format2 === LevelFormat.BULLET ? "\u2022" : "%1."),
-    alignment: AlignmentType3.LEFT,
-    style: {
-      paragraph: {
-        indent: {
-          left: convertInchesToTwip(baseIndent),
-          hanging: convertInchesToTwip(hangingIndent)
-        }
-      }
-    }
-  };
-}
-function createNumberingConfig(config) {
-  const levels = [];
-  for (const levelConfig of config.levels) {
-    const format2 = getLevelFormat(levelConfig.format);
-    const alignment = getAlignment2(levelConfig.alignment);
-    const text = levelConfig.text || (format2 === LevelFormat.BULLET ? "\u2022" : `%${levelConfig.level + 1}.`);
-    const baseIndent = levelConfig.indent?.left !== void 0 ? levelConfig.indent.left / 72 : 0.5 * (levelConfig.level + 1);
-    const hangingIndent = levelConfig.indent?.hanging !== void 0 ? levelConfig.indent.hanging / 72 : 0.25;
-    const level = {
-      level: levelConfig.level,
-      format: format2,
-      text,
-      alignment,
-      style: {
-        paragraph: {
-          indent: {
-            left: convertInchesToTwip(baseIndent),
-            hanging: convertInchesToTwip(hangingIndent)
-          }
-        }
-      },
-      // Add start number if specified
-      ...levelConfig.start !== void 0 && { start: levelConfig.start }
-    };
-    levels.push(level);
-  }
-  return {
-    reference: config.reference,
-    levels
-  };
-}
-function createBulletListConfig(reference, bullet = "\u2022") {
-  return {
-    reference,
-    levels: [
-      createDefaultLevel(0, LevelFormat.BULLET, bullet),
-      createDefaultLevel(1, LevelFormat.BULLET, "\u25E6"),
-      createDefaultLevel(2, LevelFormat.BULLET, "\u25AA")
-    ]
-  };
-}
-function createNumberedListConfig(reference, start = 1) {
-  return {
-    reference,
-    levels: [
-      { ...createDefaultLevel(0, LevelFormat.DECIMAL, "%1."), start },
-      createDefaultLevel(1, LevelFormat.LOWER_LETTER, "%2."),
-      createDefaultLevel(2, LevelFormat.LOWER_ROMAN, "%3.")
-    ]
-  };
-}
-var LEVEL_FORMAT_MAP, ALIGNMENT_MAP, NumberingRegistry, globalNumberingRegistry;
-var init_numberingConfig = __esm({
-  "src/utils/numberingConfig.ts"() {
-    "use strict";
-    LEVEL_FORMAT_MAP = {
-      decimal: LevelFormat.DECIMAL,
-      upperRoman: LevelFormat.UPPER_ROMAN,
-      lowerRoman: LevelFormat.LOWER_ROMAN,
-      upperLetter: LevelFormat.UPPER_LETTER,
-      lowerLetter: LevelFormat.LOWER_LETTER,
-      bullet: LevelFormat.BULLET,
-      ordinal: LevelFormat.ORDINAL,
-      cardinalText: LevelFormat.CARDINAL_TEXT,
-      ordinalText: LevelFormat.ORDINAL_TEXT,
-      hex: LevelFormat.HEX,
-      chicago: LevelFormat.CHICAGO,
-      ideographDigital: LevelFormat.IDEOGRAPH__DIGITAL,
-      japaneseCounting: LevelFormat.JAPANESE_COUNTING,
-      aiueo: LevelFormat.AIUEO,
-      iroha: LevelFormat.IROHA,
-      decimalFullWidth: LevelFormat.DECIMAL_FULL_WIDTH,
-      decimalHalfWidth: LevelFormat.DECIMAL_HALF_WIDTH,
-      japaneseLegal: LevelFormat.JAPANESE_LEGAL,
-      japaneseDigitalTenThousand: LevelFormat.JAPANESE_DIGITAL_TEN_THOUSAND,
-      decimalEnclosedCircle: LevelFormat.DECIMAL_ENCLOSED_CIRCLE,
-      decimalFullWidth2: LevelFormat.DECIMAL_FULL_WIDTH2,
-      aiueoFullWidth: LevelFormat.AIUEO_FULL_WIDTH,
-      irohaFullWidth: LevelFormat.IROHA_FULL_WIDTH,
-      decimalZero: LevelFormat.DECIMAL_ZERO,
-      ganada: LevelFormat.GANADA,
-      chosung: LevelFormat.CHOSUNG,
-      decimalEnclosedFullstop: LevelFormat.DECIMAL_ENCLOSED_FULLSTOP,
-      decimalEnclosedParen: LevelFormat.DECIMAL_ENCLOSED_PARENTHESES,
-      decimalEnclosedCircleChinese: LevelFormat.DECIMAL_ENCLOSED_CIRCLE_CHINESE,
-      ideographEnclosedCircle: LevelFormat.IDEOGRAPH_ENCLOSED_CIRCLE,
-      ideographTraditional: LevelFormat.IDEOGRAPH_TRADITIONAL,
-      ideographZodiac: LevelFormat.IDEOGRAPH_ZODIAC,
-      ideographZodiacTraditional: LevelFormat.IDEOGRAPH_ZODIAC_TRADITIONAL,
-      taiwaneseCounting: LevelFormat.TAIWANESE_COUNTING,
-      ideographLegalTraditional: LevelFormat.IDEOGRAPH_LEGAL_TRADITIONAL,
-      taiwaneseCountingThousand: LevelFormat.TAIWANESE_COUNTING_THOUSAND,
-      taiwaneseDigital: LevelFormat.TAIWANESE_DIGITAL,
-      chineseCounting: LevelFormat.CHINESE_COUNTING,
-      chineseLegalSimplified: LevelFormat.CHINESE_LEGAL_SIMPLIFIED,
-      chineseCountingThousand: LevelFormat.CHINESE_COUNTING_THOUSAND,
-      koreanDigital: LevelFormat.KOREAN_DIGITAL,
-      koreanCounting: LevelFormat.KOREAN_COUNTING,
-      koreanLegal: LevelFormat.KOREAN_LEGAL,
-      koreanDigital2: LevelFormat.KOREAN_DIGITAL2,
-      vietnameseCounting: LevelFormat.VIETNAMESE_COUNTING,
-      russianLower: LevelFormat.RUSSIAN_LOWER,
-      russianUpper: LevelFormat.RUSSIAN_UPPER,
-      none: LevelFormat.NONE,
-      numberInDash: LevelFormat.NUMBER_IN_DASH,
-      hebrew1: LevelFormat.HEBREW1,
-      hebrew2: LevelFormat.HEBREW2,
-      arabicAlpha: LevelFormat.ARABIC_ALPHA,
-      arabicAbjad: LevelFormat.ARABIC_ABJAD,
-      hindiVowels: LevelFormat.HINDI_VOWELS,
-      hindiConsonants: LevelFormat.HINDI_CONSONANTS,
-      hindiNumbers: LevelFormat.HINDI_NUMBERS,
-      hindiCounting: LevelFormat.HINDI_COUNTING,
-      thaiLetters: LevelFormat.THAI_LETTERS,
-      thaiNumbers: LevelFormat.THAI_NUMBERS,
-      thaiCounting: LevelFormat.THAI_COUNTING
-    };
-    ALIGNMENT_MAP = {
-      start: AlignmentType3.START,
-      end: AlignmentType3.END,
-      left: AlignmentType3.LEFT,
-      right: AlignmentType3.RIGHT,
-      center: AlignmentType3.CENTER
-    };
-    NumberingRegistry = class {
-      configs = /* @__PURE__ */ new Map();
-      counter = 0;
-      /**
-       * Register a numbering configuration
-       */
-      register(config) {
-        const reference = config.reference;
-        this.configs.set(reference, config);
-        return reference;
-      }
-      /**
-       * Generate a unique reference ID
-       */
-      generateReference(prefix = "list") {
-        return `${prefix}-${++this.counter}`;
-      }
-      /**
-       * Get all registered configurations as an array suitable for INumberingOptions
-       */
-      getAll() {
-        return Array.from(this.configs.values());
-      }
-      /**
-       * Clear all configurations
-       */
-      clear() {
-        this.configs.clear();
-        this.counter = 0;
-      }
-      /**
-       * Check if a reference exists
-       */
-      has(reference) {
-        return this.configs.has(reference);
-      }
-      /**
-       * Get a configuration by reference
-       */
-      get(reference) {
-        return this.configs.get(reference);
-      }
-    };
-    globalNumberingRegistry = new NumberingRegistry();
-  }
-});
-
 // src/plugin/example/index.ts
 import { Packer as Packer2 } from "docx";
 
 // src/plugin/createDocumentGenerator.ts
 init_styles();
-import { Packer } from "docx";
 import { applyExportMode, scopedThemeName } from "@json-to-office/shared";
 
 // src/core/fontResolution.ts
@@ -2168,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
   );
@@ -2192,8 +1977,8 @@ function resolveComponentTree(components, theme) {
 }
 
 // src/core/structure.ts
-async function processDocument(document, theme, themeName) {
-  const metadata = createDocumentMetadata(document.props);
+async function processDocument(document, theme, themeName, generationDate) {
+  const metadata = createDocumentMetadata(document.props, generationDate);
   const docDefaults = document.props.componentDefaults;
   const mergedComponentDefaults = docDefaults ? mergeWithDefaults2(docDefaults, theme.componentDefaults || {}) : void 0;
   const docNoProofWords = document.props.noProofWords;
@@ -2231,13 +2016,16 @@ async function processDocument(document, theme, themeName) {
     language: document.props.language
   };
 }
-function createDocumentMetadata(props) {
+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,
-    date: props.metadata?.date ? new Date(props.metadata.date) : /* @__PURE__ */ new Date()
+    version: props.metadata?.version,
+    tags: props.metadata?.tags,
+    date: props.metadata?.date ? new Date(props.metadata.date) : generationDate
   };
 }
 async function extractSections(components, context) {
@@ -3900,7 +3688,39 @@ function parseTextWithHyperlinks(text, baseStyle = {}, options = {}) {
   return runs;
 }
 
+// src/utils/generationContext.ts
+import { AsyncLocalStorage } from "async_hooks";
+var generationDateStorage = new AsyncLocalStorage();
+function runWithGenerationDate(date, callback) {
+  return generationDateStorage.run(date, callback);
+}
+function getGenerationDate() {
+  return generationDateStorage.getStore() ?? /* @__PURE__ */ new Date();
+}
+
 // src/utils/placeholderProcessor.ts
+function styledPlaceholderText(text, context) {
+  return new TextRun2({
+    text,
+    font: context?.style?.font,
+    size: context?.style?.size,
+    color: context?.style?.color,
+    bold: context?.style?.bold,
+    italics: context?.style?.italics,
+    underline: context?.style?.underline,
+    language: context?.style?.language,
+    noProof: context?.style?.noProof
+  });
+}
+function placeholderDate(context) {
+  return context?.date ?? getGenerationDate();
+}
+function isoDate(date) {
+  return date.toISOString().slice(0, 10);
+}
+function isoDateTime(date) {
+  return date.toISOString().replace("T", " ").replace(/\.\d{3}Z$/, "Z");
+}
 var PlaceholderRegistry = class {
   static handlers = /* @__PURE__ */ new Map();
   /**
@@ -3956,8 +3776,6 @@ function processTextWithPlaceholders(text, baseStyle = {}, context = {}, noProof
         const placeholderResult = handler({ ...context, style: baseStyle });
         if (Array.isArray(placeholderResult)) {
           result.push(...placeholderResult);
-        } else if (placeholderResult instanceof TextRun2) {
-          result.push(placeholderResult);
         } else if (typeof placeholderResult === "string") {
           result.push(
             ...createTextRunsWithNewlines2(
@@ -3966,6 +3784,8 @@ function processTextWithPlaceholders(text, baseStyle = {}, context = {}, noProof
               noProofWords
             )
           );
+        } else {
+          result.push(placeholderResult);
         }
       } else {
         result.push(
@@ -4080,59 +3900,51 @@ function initializeBuiltinPlaceholders() {
       underline: context?.style?.underline
     });
   });
-  PlaceholderRegistry.register("DATE", (context) => {
-    const today = /* @__PURE__ */ new Date();
-    const dateString = today.toLocaleDateString();
-    return new TextRun2({
-      text: dateString,
-      font: context?.style?.font,
-      size: context?.style?.size,
-      color: context?.style?.color,
-      bold: context?.style?.bold,
-      italics: context?.style?.italics,
-      underline: context?.style?.underline
-    });
-  });
-  PlaceholderRegistry.register("DATETIME", (context) => {
-    const now = /* @__PURE__ */ new Date();
-    const dateTimeString = now.toLocaleString();
-    return new TextRun2({
-      text: dateTimeString,
-      font: context?.style?.font,
-      size: context?.style?.size,
-      color: context?.style?.color,
-      bold: context?.style?.bold,
-      italics: context?.style?.italics,
-      underline: context?.style?.underline
-    });
-  });
-  PlaceholderRegistry.register("YEAR", (context) => {
-    const year = (/* @__PURE__ */ new Date()).getFullYear().toString();
-    return new TextRun2({
-      text: year,
-      font: context?.style?.font,
-      size: context?.style?.size,
-      color: context?.style?.color,
-      bold: context?.style?.bold,
-      italics: context?.style?.italics,
-      underline: context?.style?.underline
-    });
-  });
+  PlaceholderRegistry.register(
+    "DATE",
+    (context) => styledPlaceholderText(isoDate(placeholderDate(context)), context)
+  );
+  PlaceholderRegistry.register(
+    "DATETIME",
+    (context) => styledPlaceholderText(isoDateTime(placeholderDate(context)), context)
+  );
+  PlaceholderRegistry.register(
+    "YEAR",
+    (context) => styledPlaceholderText(
+      String(placeholderDate(context).getUTCFullYear()),
+      context
+    )
+  );
 }
 initializeBuiltinPlaceholders();
 
 // src/utils/revisionUtils.ts
+import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
 var DEFAULT_REVISION_AUTHOR = "json-to-office";
 var DEFAULT_REVISION_DATE = "1970-01-01T00:00:00Z";
 var RevisionIdRegistry = class {
-  counter = 0;
+  fallbackCounter = 0;
+  scopes = new AsyncLocalStorage2();
+  runScoped(callback) {
+    return this.scopes.run({ counter: 0 }, callback);
+  }
   next() {
-    this.counter += 1;
-    return this.counter;
+    const state = this.scopes.getStore();
+    if (state) {
+      state.counter += 1;
+      return state.counter;
+    }
+    this.fallbackCounter += 1;
+    return this.fallbackCounter;
   }
   /** Test-only: deterministic ids for snapshot assertions. */
   clear() {
-    this.counter = 0;
+    const state = this.scopes.getStore();
+    if (state) {
+      state.counter = 0;
+    } else {
+      this.fallbackCounter = 0;
+    }
   }
 };
 var globalRevisionIdRegistry = new RevisionIdRegistry();
@@ -4252,7 +4064,10 @@ function initializeComponentCache(cache) {
   }
 }
 async function renderComponentWithCache(component, theme, themeName, context, bypassCache = false) {
-  const forceBypassForType = component.name === "toc" || component.name === "section" || component.name === "visual" || componentHasRevision(component);
+  const forceBypassForType = component.name === "toc" || component.name === "section" || component.name === "visual" || component.name === "heading" || // Both explicit lists and markdown-list paragraphs register numbering in
+  // the current document scope. Cached paragraphs can otherwise reference
+  // definitions that only existed in a previous render.
+  component.name === "list" || component.name === "paragraph" || "id" in component || componentHasRevision(component);
   if (!componentCache) {
     initializeComponentCache();
   }
@@ -4262,8 +4077,9 @@ async function renderComponentWithCache(component, theme, themeName, context, by
   const componentProps = JSON.stringify(component.props || {});
   const themeHash = createThemeHash(theme);
   const contextKey = context?.section ? `${context.section.currentLayout}:${context.section.columnCount}` : "no-section";
+  const generationDateKey = getGenerationDate().toISOString();
   const childrenKey = "children" in component && component.children ? `:children:${JSON.stringify(component.children)}` : "";
-  const cacheKey = `component:${component.name}:${themeHash}:${contextKey}:${componentProps}${childrenKey}`;
+  const cacheKey = `component:${component.name}:${themeHash}:${contextKey}:${generationDateKey}:${componentProps}${childrenKey}`;
   const cached = await componentCache.get(cacheKey);
   if (cached) {
     return cached.result;
@@ -4311,19 +4127,27 @@ init_styles();
 init_defaults();
 
 // src/utils/bookmarkRegistry.ts
+import { AsyncLocalStorage as AsyncLocalStorage3 } from "async_hooks";
 var BookmarkRegistry = class {
-  bookmarks = /* @__PURE__ */ new Map();
-  counter = 0;
+  fallback = { bookmarks: /* @__PURE__ */ new Map() };
+  scopes = new AsyncLocalStorage3();
+  get state() {
+    return this.scopes.getStore() ?? this.fallback;
+  }
+  /** Run work with an isolated registry that follows its async call chain. */
+  runScoped(callback) {
+    return this.scopes.run({ bookmarks: /* @__PURE__ */ new Map() }, callback);
+  }
   /**
    * Register a bookmark
    */
   register(id, title, type) {
-    if (this.bookmarks.has(id)) {
+    if (this.state.bookmarks.has(id)) {
       console.warn(
         `Duplicate bookmark ID: ${id}. Using the latest registration.`
       );
     }
-    this.bookmarks.set(id, { id, title, type });
+    this.state.bookmarks.set(id, { id, title, type });
   }
   /**
    * Generate a unique bookmark ID from text
@@ -4333,7 +4157,7 @@ var BookmarkRegistry = class {
     const baseId = text.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").substring(0, 40);
     let id = baseId;
     let attempt = 0;
-    while (this.bookmarks.has(id) && attempt < 100) {
+    while (this.state.bookmarks.has(id) && attempt < 100) {
       id = `${baseId}-${++attempt}`;
     }
     return id;
@@ -4342,26 +4166,25 @@ var BookmarkRegistry = class {
    * Check if a bookmark exists
    */
   exists(id) {
-    return this.bookmarks.has(id);
+    return this.state.bookmarks.has(id);
   }
   /**
    * Get bookmark info by ID
    */
   get(id) {
-    return this.bookmarks.get(id);
+    return this.state.bookmarks.get(id);
   }
   /**
    * Get all registered bookmarks
    */
   getAll() {
-    return Array.from(this.bookmarks.values());
+    return Array.from(this.state.bookmarks.values());
   }
   /**
    * Clear all bookmarks
    */
   clear() {
-    this.bookmarks.clear();
-    this.counter = 0;
+    this.state.bookmarks.clear();
   }
   /**
    * Validate that all internal hyperlink references exist
@@ -4866,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") {
@@ -5002,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,
@@ -5056,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,
@@ -5279,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) => {
@@ -5649,8 +5511,173 @@ function renderHeadingComponent(component, theme, themeName) {
   return [header];
 }
 
+// src/utils/numberingConfig.ts
+import { AlignmentType as AlignmentType3, convertInchesToTwip, LevelFormat } from "docx";
+import { AsyncLocalStorage as AsyncLocalStorage4 } from "async_hooks";
+var LEVEL_FORMAT_MAP = {
+  decimal: LevelFormat.DECIMAL,
+  upperRoman: LevelFormat.UPPER_ROMAN,
+  lowerRoman: LevelFormat.LOWER_ROMAN,
+  upperLetter: LevelFormat.UPPER_LETTER,
+  lowerLetter: LevelFormat.LOWER_LETTER,
+  bullet: LevelFormat.BULLET,
+  ordinal: LevelFormat.ORDINAL,
+  cardinalText: LevelFormat.CARDINAL_TEXT,
+  ordinalText: LevelFormat.ORDINAL_TEXT,
+  hex: LevelFormat.HEX,
+  chicago: LevelFormat.CHICAGO,
+  ideographDigital: LevelFormat.IDEOGRAPH__DIGITAL,
+  japaneseCounting: LevelFormat.JAPANESE_COUNTING,
+  aiueo: LevelFormat.AIUEO,
+  iroha: LevelFormat.IROHA,
+  decimalFullWidth: LevelFormat.DECIMAL_FULL_WIDTH,
+  decimalHalfWidth: LevelFormat.DECIMAL_HALF_WIDTH,
+  japaneseLegal: LevelFormat.JAPANESE_LEGAL,
+  japaneseDigitalTenThousand: LevelFormat.JAPANESE_DIGITAL_TEN_THOUSAND,
+  decimalEnclosedCircle: LevelFormat.DECIMAL_ENCLOSED_CIRCLE,
+  decimalFullWidth2: LevelFormat.DECIMAL_FULL_WIDTH2,
+  aiueoFullWidth: LevelFormat.AIUEO_FULL_WIDTH,
+  irohaFullWidth: LevelFormat.IROHA_FULL_WIDTH,
+  decimalZero: LevelFormat.DECIMAL_ZERO,
+  ganada: LevelFormat.GANADA,
+  chosung: LevelFormat.CHOSUNG,
+  decimalEnclosedFullstop: LevelFormat.DECIMAL_ENCLOSED_FULLSTOP,
+  decimalEnclosedParen: LevelFormat.DECIMAL_ENCLOSED_PARENTHESES,
+  decimalEnclosedCircleChinese: LevelFormat.DECIMAL_ENCLOSED_CIRCLE_CHINESE,
+  ideographEnclosedCircle: LevelFormat.IDEOGRAPH_ENCLOSED_CIRCLE,
+  ideographTraditional: LevelFormat.IDEOGRAPH_TRADITIONAL,
+  ideographZodiac: LevelFormat.IDEOGRAPH_ZODIAC,
+  ideographZodiacTraditional: LevelFormat.IDEOGRAPH_ZODIAC_TRADITIONAL,
+  taiwaneseCounting: LevelFormat.TAIWANESE_COUNTING,
+  ideographLegalTraditional: LevelFormat.IDEOGRAPH_LEGAL_TRADITIONAL,
+  taiwaneseCountingThousand: LevelFormat.TAIWANESE_COUNTING_THOUSAND,
+  taiwaneseDigital: LevelFormat.TAIWANESE_DIGITAL,
+  chineseCounting: LevelFormat.CHINESE_COUNTING,
+  chineseLegalSimplified: LevelFormat.CHINESE_LEGAL_SIMPLIFIED,
+  chineseCountingThousand: LevelFormat.CHINESE_COUNTING_THOUSAND,
+  koreanDigital: LevelFormat.KOREAN_DIGITAL,
+  koreanCounting: LevelFormat.KOREAN_COUNTING,
+  koreanLegal: LevelFormat.KOREAN_LEGAL,
+  koreanDigital2: LevelFormat.KOREAN_DIGITAL2,
+  vietnameseCounting: LevelFormat.VIETNAMESE_COUNTING,
+  russianLower: LevelFormat.RUSSIAN_LOWER,
+  russianUpper: LevelFormat.RUSSIAN_UPPER,
+  none: LevelFormat.NONE,
+  numberInDash: LevelFormat.NUMBER_IN_DASH,
+  hebrew1: LevelFormat.HEBREW1,
+  hebrew2: LevelFormat.HEBREW2,
+  arabicAlpha: LevelFormat.ARABIC_ALPHA,
+  arabicAbjad: LevelFormat.ARABIC_ABJAD,
+  hindiVowels: LevelFormat.HINDI_VOWELS,
+  hindiConsonants: LevelFormat.HINDI_CONSONANTS,
+  hindiNumbers: LevelFormat.HINDI_NUMBERS,
+  hindiCounting: LevelFormat.HINDI_COUNTING,
+  thaiLetters: LevelFormat.THAI_LETTERS,
+  thaiNumbers: LevelFormat.THAI_NUMBERS,
+  thaiCounting: LevelFormat.THAI_COUNTING
+};
+var ALIGNMENT_MAP = {
+  start: AlignmentType3.START,
+  end: AlignmentType3.END,
+  left: AlignmentType3.LEFT,
+  right: AlignmentType3.RIGHT,
+  center: AlignmentType3.CENTER
+};
+function getLevelFormat(format2) {
+  if (!format2) return LevelFormat.BULLET;
+  return LEVEL_FORMAT_MAP[format2] || LevelFormat.BULLET;
+}
+function getAlignment2(alignment) {
+  if (!alignment) return AlignmentType3.LEFT;
+  return ALIGNMENT_MAP[alignment] || AlignmentType3.LEFT;
+}
+function createNumberingConfig(config) {
+  const levels = [];
+  for (const levelConfig of config.levels) {
+    const format2 = getLevelFormat(levelConfig.format);
+    const alignment = getAlignment2(levelConfig.alignment);
+    const text = levelConfig.text || (format2 === LevelFormat.BULLET ? "\u2022" : `%${levelConfig.level + 1}.`);
+    const baseIndent = levelConfig.indent?.left !== void 0 ? levelConfig.indent.left / 72 : 0.5 * (levelConfig.level + 1);
+    const hangingIndent = levelConfig.indent?.hanging !== void 0 ? levelConfig.indent.hanging / 72 : 0.25;
+    const level = {
+      level: levelConfig.level,
+      format: format2,
+      text,
+      alignment,
+      style: {
+        paragraph: {
+          indent: {
+            left: convertInchesToTwip(baseIndent),
+            hanging: convertInchesToTwip(hangingIndent)
+          }
+        }
+      },
+      // Add start number if specified
+      ...levelConfig.start !== void 0 && { start: levelConfig.start }
+    };
+    levels.push(level);
+  }
+  return {
+    reference: config.reference,
+    levels
+  };
+}
+var NumberingRegistry = class {
+  fallback = {
+    configs: /* @__PURE__ */ new Map(),
+    counter: 0
+  };
+  scopes = new AsyncLocalStorage4();
+  get state() {
+    return this.scopes.getStore() ?? this.fallback;
+  }
+  /** Run work with an isolated registry that follows its async call chain. */
+  runScoped(callback) {
+    return this.scopes.run({ configs: /* @__PURE__ */ new Map(), counter: 0 }, callback);
+  }
+  /**
+   * Register a numbering configuration
+   */
+  register(config) {
+    const reference = config.reference;
+    this.state.configs.set(reference, config);
+    return reference;
+  }
+  /**
+   * Generate a unique reference ID
+   */
+  generateReference(prefix = "list") {
+    return `${prefix}-${++this.state.counter}`;
+  }
+  /**
+   * Get all registered configurations as an array suitable for INumberingOptions
+   */
+  getAll() {
+    return Array.from(this.state.configs.values());
+  }
+  /**
+   * Clear all configurations
+   */
+  clear() {
+    this.state.configs.clear();
+    this.state.counter = 0;
+  }
+  /**
+   * Check if a reference exists
+   */
+  has(reference) {
+    return this.state.configs.has(reference);
+  }
+  /**
+   * Get a configuration by reference
+   */
+  get(reference) {
+    return this.state.configs.get(reference);
+  }
+};
+var globalNumberingRegistry = new NumberingRegistry();
+
 // src/components/paragraph.ts
-init_numberingConfig();
 function parseMarkdownList(text) {
   const lines = text.split("\n");
   const items = [];
@@ -5776,7 +5803,6 @@ function renderParagraphComponent(component, theme, themeName) {
 }
 
 // src/components/list.ts
-init_numberingConfig();
 function createLevelsFromSimplifiedProps(props) {
   const levels = [];
   let format2;
@@ -6200,17 +6226,22 @@ async function renderTableComponent(component, theme, themeName) {
 
 // src/components/section.ts
 import { Paragraph as Paragraph4, BookmarkStart, BookmarkEnd } from "docx";
-function generateSectionBookmarkId() {
-  const linkId = Math.floor(Math.random() * 1e6);
+function generateSectionBookmarkId(context) {
+  const custom = context.custom ??= {};
+  const state = custom.sectionBookmarks ??= {
+    next: 1
+  };
+  const ordinal = state.next++;
+  const linkId = 1e6 + ordinal;
   return {
-    id: `_Section_${linkId}_${Date.now()}`,
+    id: `_NestedSection_${ordinal}`,
     linkId
   };
 }
 async function renderSectionComponent(component, theme, themeName, context) {
   if (!isSectionComponent(component)) return [];
   const elements = [];
-  const { id: sectionBookmarkId, linkId: bookmarkLinkId } = generateSectionBookmarkId();
+  const { id: sectionBookmarkId, linkId: bookmarkLinkId } = generateSectionBookmarkId(context);
   elements.push(
     new Paragraph4({
       children: [new BookmarkStart(sectionBookmarkId, bookmarkLinkId)],
@@ -6441,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;
@@ -6530,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";
@@ -6579,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()) {
@@ -6619,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,
@@ -6824,14 +6874,40 @@ 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,
+    () => globalBookmarkRegistry.runScoped(
+      () => globalRevisionIdRegistry.runScoped(
+        () => globalNumberingRegistry.runScoped(
+          () => renderDocumentScoped(structure, layout, options)
+        )
+      )
+    )
+  );
+}
+async function renderDocumentScoped(structure, layout, options) {
   if (options?.cache) {
     initializeComponentCache(options.cache);
   } else if (!options?.bypassCache) {
     initializeComponentCache();
   }
-  const { globalNumberingRegistry: globalNumberingRegistry2 } = await Promise.resolve().then(() => (init_numberingConfig(), numberingConfig_exports));
-  globalNumberingRegistry2.clear();
   const sections = [];
   const context = createRenderContext(
     structure,
@@ -6888,7 +6964,8 @@ async function renderDocument(structure, layout, options) {
       structure.themeName,
       context,
       sectionOrdinal,
-      closeBookmark
+      closeBookmark,
+      options?.bypassCache === true
     );
     if (layoutSection.isUserSection) {
       sectionBookmarkCounter++;
@@ -6897,10 +6974,11 @@ async function renderDocument(structure, layout, options) {
       sections.push(rendered);
     }
   }
-  const numberingConfigs = globalNumberingRegistry2.getAll();
+  const numberingConfigs = globalNumberingRegistry.getAll();
   return new Document({
     styles: createWordStyles(structure.theme, structure.language),
     sections,
+    ...coreProperties(structure.metadata),
     features: {
       updateFields: true,
       // Required for TOC fields to update correctly
@@ -7065,7 +7143,7 @@ async function renderHeaderFooterComponents(components, theme, themeName, contex
   }
   return elements;
 }
-async function renderSection(section, theme, themeName, context, sectionOrdinal, closeBookmark) {
+async function renderSection(section, theme, themeName, context, sectionOrdinal, closeBookmark, bypassCache = false) {
   const elements = [];
   const isFirstLayoutOfUserSection = section.isUserSection;
   const sharedLinkId = section.belongsToUserSection && sectionOrdinal ? sectionOrdinal : void 0;
@@ -7103,8 +7181,7 @@ async function renderSection(section, theme, themeName, context, sectionOrdinal,
       theme,
       themeName,
       sectionContext,
-      false
-      // Don't bypass cache
+      bypassCache
     );
     elements.push(...rendered);
   }
@@ -7273,6 +7350,75 @@ function normalizeDocument(document) {
   return [normalized];
 }
 
+// src/utils/packageDocument.ts
+import AdmZip2 from "adm-zip";
+import { Packer } from "docx";
+
+// src/utils/fixFloatingImageIds.ts
+import AdmZip from "adm-zip";
+function fixFloatingImageIdsInBuffer(buffer) {
+  const zip = new AdmZip(buffer);
+  const documentEntry = zip.getEntry("word/document.xml");
+  if (!documentEntry) {
+    throw new Error("document.xml not found in DOCX");
+  }
+  let idCounter = 1;
+  const documentXml = documentEntry.getData().toString("utf8").replace(/<wp:docPr\s+id="(\d+)"/g, () => {
+    const newId = idCounter++;
+    return `<wp:docPr id="${newId}"`;
+  });
+  zip.updateFile(documentEntry, Buffer.from(documentXml, "utf8"));
+  return zip.toBuffer();
+}
+
+// src/utils/packageDocument.ts
+var DEFAULT_GENERATION_DATE = /* @__PURE__ */ new Date("2000-01-01T00:00:00.000Z");
+function resolveGenerationDate(options) {
+  if (options?.generatedAt !== void 0) {
+    const date = new Date(options.generatedAt);
+    if (Number.isNaN(date.getTime())) {
+      throw new RangeError("generatedAt must be a valid date");
+    }
+    if (date.getUTCFullYear() < 1980) {
+      throw new RangeError(
+        "generatedAt must be on or after 1980-01-01 for ZIP compatibility"
+      );
+    }
+    return date;
+  }
+  return options?.deterministic === false ? /* @__PURE__ */ new Date() : new Date(DEFAULT_GENERATION_DATE);
+}
+function toDosTime(date) {
+  const dosDate = (date.getUTCFullYear() - 1980 & 127) << 9 | date.getUTCMonth() + 1 << 5 | date.getUTCDate();
+  const dosTime = date.getUTCHours() << 11 | date.getUTCMinutes() << 5 | date.getUTCSeconds() >> 1;
+  return (dosDate << 16 | dosTime) >>> 0;
+}
+function canonicalizeDocxBuffer(buffer, generatedAt = DEFAULT_GENERATION_DATE) {
+  const zip = new AdmZip2(buffer);
+  const isoTimestamp = generatedAt.toISOString();
+  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(coreProperties2, Buffer.from(normalized, "utf8"));
+  }
+  const zipTimestamp = toDosTime(generatedAt);
+  for (const entry of zip.getEntries()) {
+    entry.header.timeval = zipTimestamp;
+  }
+  return zip.toBuffer();
+}
+async function packageDocument(document, options) {
+  const packed = await Packer.toBuffer(document);
+  const fixed = fixFloatingImageIdsInBuffer(packed);
+  if (options?.deterministic === false) {
+    return fixed;
+  }
+  return canonicalizeDocxBuffer(fixed, resolveGenerationDate(options));
+}
+
 // src/plugin/createDocumentGenerator.ts
 function createBuilderImpl(state) {
   const componentMap = new Map(state.components.map((c) => [c.name, c]));
@@ -7428,7 +7574,10 @@ function createBuilderImpl(state) {
       debug: state.debug,
       enableCache: state.enableCache,
       services: state.services,
-      fonts: state.fonts
+      fonts: state.fonts,
+      validation: state.validation,
+      deterministic: state.deterministic,
+      generatedAt: state.generatedAt
     };
     return createBuilderImpl(
       newState
@@ -7452,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
@@ -7520,10 +7670,20 @@ function createBuilderImpl(state) {
       };
       const [modedDoc] = normalizeDocument(processedDocument);
       await resolveDocumentFonts(modedDoc, modedTheme, state.fonts, warnings);
-      const structure = await processDocument(modedDoc, modedTheme, themeName);
+      const packageOptions = {
+        deterministic: options?.deterministic ?? state.deterministic,
+        generatedAt: options?.generatedAt ?? state.generatedAt
+      };
+      const structure = await processDocument(
+        modedDoc,
+        modedTheme,
+        themeName,
+        resolveGenerationDate(packageOptions)
+      );
       const layout = applyLayout(structure.sections, modedTheme, themeName);
       const generatedDocument = await renderDocument(structure, layout, {
-        services: state.services
+        services: state.services,
+        bypassCache: !state.enableCache
       });
       const preservedDefinition = preserveSet ? {
         ...mode.doc,
@@ -7549,7 +7709,10 @@ function createBuilderImpl(state) {
       standardDefinition,
       preservedDefinition
     } = await generate(document, options);
-    const buffer = await Packer.toBuffer(doc);
+    const buffer = await packageDocument(doc, {
+      deterministic: options?.deterministic ?? state.deterministic,
+      generatedAt: options?.generatedAt ?? state.generatedAt
+    });
     return { buffer, warnings, standardDefinition, preservedDefinition };
   }
   async function generateFile(document, outputPath, options) {
@@ -7648,7 +7811,9 @@ function createDocumentGenerator(options) {
     enableCache: options.enableCache ?? false,
     services: options.services,
     fonts: options.fonts,
-    validation: options.validation
+    validation: options.validation,
+    deterministic: options.deterministic ?? true,
+    generatedAt: options.generatedAt
   };
   return createBuilderImpl(initialState);
 }