@json-to-office/core-docx 0.29.0 → 0.31.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;AAK7C,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;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAyoBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAiBvC"}
+{"version":3,"file":"createDocumentGenerator.d.ts","sourceRoot":"","sources":["../../src/plugin/createDocumentGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,KAAK,EAEV,wBAAwB,EAQxB,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;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8sBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAiBvC"}

package/dist/plugin/example/index.js

@@ -4442,6 +4442,26 @@ function componentHasRevision(component) {
 import { createHash as createHash3 } from "crypto";
 var componentCache = null;
 var cacheKeyGen = null;
+var bypassStats = /* @__PURE__ */ new Map();
+function recordBypass(type, reason) {
+  const entry = bypassStats.get(type);
+  if (entry) {
+    entry.renders++;
+  } else {
+    bypassStats.set(type, { renders: 1, reason });
+  }
+}
+var DATE_INDEPENDENT_PLACEHOLDERS = /* @__PURE__ */ new Set(["PAGE", "TOTAL_PAGES"]);
+function usesDateSensitivePlaceholder(serialized) {
+  const placeholderRegex = /\{([^}{]+)\}/g;
+  let match;
+  while ((match = placeholderRegex.exec(serialized)) !== null) {
+    const name = match[1].toUpperCase();
+    if (DATE_INDEPENDENT_PLACEHOLDERS.has(name)) continue;
+    if (PlaceholderRegistry.has(name)) return true;
+  }
+  return false;
+}
 function createThemeHash(theme) {
   const themeString = JSON.stringify(theme);
   return createHash3("sha256").update(themeString).digest("hex").substring(0, 8);
@@ -4477,22 +4497,31 @@ function initializeComponentCache(cache) {
   }
 }
 async function renderComponentWithCache(component, theme, themeName, context, bypassCache = false) {
-  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);
+  const bypassReason = componentHasRevision(
+    component
+  ) ? "revision-ids" : "id" in component ? "bookmark-id" : 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" ? "dynamic-context" : null;
   if (!componentCache) {
     initializeComponentCache();
   }
-  if (!componentCache || bypassCache || forceBypassForType || !componentCache.getConfig().enabled) {
+  if (bypassReason !== null) {
+    recordBypass(component.name, bypassReason);
+    return renderComponent(component, theme, themeName, context);
+  }
+  if (!componentCache || bypassCache || !componentCache.getConfig().enabled) {
     return renderComponent(component, theme, themeName, context);
   }
   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 baseDirKey = getBaseDir() ?? "";
   const childrenKey = "children" in component && component.children ? `:children:${JSON.stringify(component.children)}` : "";
+  const generationDateKey = usesDateSensitivePlaceholder(
+    componentProps + childrenKey
+  ) ? getGenerationDate().toISOString() : "no-date";
   const cacheKey = `component:${component.name}:${themeHash}:${contextKey}:${generationDateKey}:${baseDirKey}:${componentProps}${childrenKey}`;
   const cached = await componentCache.get(cacheKey);
   if (cached) {
@@ -7355,6 +7384,11 @@ function createLimiter(max) {
 var DEFAULT_FALLBACK_CONCURRENCY = 4;
 var BATCH_TIMEOUT_BASE_MS = 3e4;
 var BATCH_TIMEOUT_PER_SLIDE_MS = 1e4;
+var prepassStats = {
+  documents: 0,
+  collected: 0,
+  unique: 0
+};
 function collectVisualProps(root) {
   const found = [];
   const seen = /* @__PURE__ */ new WeakSet();
@@ -7431,6 +7465,9 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
     }
   }
   if (targets.size === 0) return map;
+  prepassStats.documents++;
+  prepassStats.collected += visuals.length;
+  prepassStats.unique += targets.size;
   const unique = [...targets.values()];
   const limit = createLimiter(
     Math.max(1, options.concurrency ?? DEFAULT_FALLBACK_CONCURRENCY)
@@ -8284,70 +8321,104 @@ function createBuilderImpl(state) {
     }
     return new Set(list);
   }
-  async function generate(document, options) {
-    try {
-      const preserveSet = resolvePreserveSet(options);
-      const rootIn = document;
-      const internalDocument = rootIn.props === void 0 ? { ...rootIn, props: {} } : rootIn;
-      const vOpts = {
-        ...state.validation,
-        ...options?.validation
-      };
-      if (vOpts.enabled !== false) {
-        const result = validateDocument(
-          internalDocument,
-          state.components,
-          { allowUnknownFields: vOpts.allowUnknownFields }
+  async function expandDocument(document, options) {
+    const preserveSet = resolvePreserveSet(options);
+    const rootIn = document;
+    const internalDocument = rootIn.props === void 0 ? { ...rootIn, props: {} } : rootIn;
+    const vOpts = {
+      ...state.validation,
+      ...options?.validation
+    };
+    if (vOpts.enabled !== false) {
+      const result = validateDocument(
+        internalDocument,
+        state.components,
+        { allowUnknownFields: vOpts.allowUnknownFields }
+      );
+      if (!result.valid) {
+        throw new ComponentValidationError2(
+          (result.errors ?? []).map((e) => ({
+            path: e.path ?? "",
+            message: e.message
+          })),
+          internalDocument
         );
-        if (!result.valid) {
-          throw new ComponentValidationError2(
-            (result.errors ?? []).map((e) => ({
-              path: e.path ?? "",
-              message: e.message
-            })),
-            internalDocument
-          );
-        }
       }
-      const validateEmitted = vOpts.enabled === false ? void 0 : (emitted, componentLabel) => {
-        const result = validateDocument(
-          { ...internalDocument, children: emitted },
-          state.components,
-          { allowUnknownFields: vOpts.allowUnknownFields }
+    }
+    const validateEmitted = vOpts.enabled === false ? void 0 : (emitted, componentLabel) => {
+      const result = validateDocument(
+        { ...internalDocument, children: emitted },
+        state.components,
+        { allowUnknownFields: vOpts.allowUnknownFields }
+      );
+      if (!result.valid) {
+        throw new ComponentValidationError2(
+          (result.errors ?? []).map((e) => ({
+            path: e.path ?? "",
+            message: `custom component '${componentLabel}' emitted invalid output \u2014 ${e.message}`
+          })),
+          emitted
         );
-        if (!result.valid) {
-          throw new ComponentValidationError2(
-            (result.errors ?? []).map((e) => ({
-              path: e.path ?? "",
-              message: `custom component '${componentLabel}' emitted invalid output \u2014 ${e.message}`
-            })),
-            emitted
-          );
-        }
+      }
+    };
+    const warnings = [];
+    const {
+      document: modedRoot,
+      theme: modedTheme,
+      themeName
+    } = resolveThemeContext(internalDocument, {
+      customThemes: state.customThemes,
+      fonts: state.fonts,
+      warnings,
+      resolveNamedTheme: resolveDocumentTheme
+    });
+    const processed = await processDocumentComponents(
+      modedRoot.children || [],
+      preserveSet,
+      warnings,
+      modedTheme,
+      validateEmitted
+    );
+    const processedDocument = {
+      ...modedRoot,
+      children: processed.standard
+    };
+    const [modedDoc] = normalizeDocument(processedDocument);
+    return {
+      modedRoot,
+      modedTheme,
+      themeName,
+      processed,
+      modedDoc,
+      warnings,
+      preserveSet
+    };
+  }
+  async function expandStandardDefinition(document, options) {
+    try {
+      const { modedDoc, warnings } = await expandDocument(document, options);
+      return {
+        standardDefinition: modedDoc,
+        warnings: warnings.length > 0 ? warnings : null
       };
-      const warnings = [];
+    } catch (error) {
+      if (state.debug) {
+        console.error("Document expansion error:", error);
+      }
+      throw error;
+    }
+  }
+  async function generate(document, options) {
+    try {
       const {
-        document: modedRoot,
-        theme: modedTheme,
-        themeName
-      } = resolveThemeContext(internalDocument, {
-        customThemes: state.customThemes,
-        fonts: state.fonts,
-        warnings,
-        resolveNamedTheme: resolveDocumentTheme
-      });
-      const processed = await processDocumentComponents(
-        modedRoot.children || [],
-        preserveSet,
-        warnings,
+        modedRoot,
         modedTheme,
-        validateEmitted
-      );
-      const processedDocument = {
-        ...modedRoot,
-        children: processed.standard
-      };
-      const [modedDoc] = normalizeDocument(processedDocument);
+        themeName,
+        processed,
+        modedDoc,
+        warnings,
+        preserveSet
+      } = await expandDocument(document, options);
       await resolveDocumentFonts(modedDoc, modedTheme, state.fonts, warnings);
       const packageOptions = {
         deterministic: options?.deterministic ?? state.deterministic,
@@ -8474,6 +8545,7 @@ function createBuilderImpl(state) {
     generate,
     generateBuffer,
     generateFile,
+    expandStandardDefinition,
     getComponentNames,
     validate,
     generateSchema,