@json-to-office/core-docx 0.35.0 → 0.36.1

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;AAI9E,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;AAguBD;;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;AAI9E,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;AAiuBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAiBvC"}

package/dist/plugin/example/index.js

@@ -2146,10 +2146,68 @@ function resolveFromBaseDir(filePath) {
   if (!base || isAbsolute(filePath)) return filePath;
   return resolve(base, filePath);
 }
+var warningsStorage = new AsyncLocalStorage();
+function runWithWarnings(warnings, callback) {
+  return warnings === void 0 ? callback() : warningsStorage.run(warnings, callback);
+}
+function reportWarning(component, code, message, context) {
+  const warnings = warningsStorage.getStore();
+  if (warnings) {
+    warnings.push({
+      component,
+      message,
+      severity: "warning",
+      context: { code, ...context }
+    });
+    return;
+  }
+  console.warn(`[json-to-docx] [${code}] ${message}`);
+}
 
 // src/utils/imageUtils.ts
 init_widthUtils();
 import { ImageRun } from "docx";
+var SVG_RASTER_SCALE = 3;
+var SVG_MAX_EDGE_PX = 4096;
+var SVG_MIN_EDGE_PX = 16;
+var resvgModule;
+function loadResvg() {
+  resvgModule ??= import("@resvg/resvg-js");
+  return resvgModule;
+}
+function toRasterPx(px) {
+  return Math.min(
+    SVG_MAX_EDGE_PX,
+    Math.max(SVG_MIN_EDGE_PX, Math.round(px * SVG_RASTER_SCALE))
+  );
+}
+async function rasterizeSvgFallback(svg, transformation) {
+  let Resvg;
+  try {
+    ({ Resvg } = await loadResvg());
+  } catch (error) {
+    reportWarning(
+      "image",
+      "IMAGE_SVG_RASTER_FAILED",
+      `Could not load the SVG rasterizer, so inline SVG keeps a fallback that only Word 2016+ can draw: ${String(error)}`
+    );
+    return void 0;
+  }
+  try {
+    const markup = svg.toString("utf-8");
+    const probeImage = new Resvg(markup);
+    const wide = probeImage.width / probeImage.height > transformation.width / transformation.height;
+    const fitTo = wide ? { mode: "height", value: toRasterPx(transformation.height) } : { mode: "width", value: toRasterPx(transformation.width) };
+    return Buffer.from(new Resvg(markup, { fitTo }).render().asPng());
+  } catch (error) {
+    reportWarning(
+      "image",
+      "IMAGE_SVG_RASTER_FAILED",
+      `Could not rasterize inline SVG, so its fallback only renders in Word 2016+: ${String(error)}`
+    );
+    return void 0;
+  }
+}
 function parseWidthValue(width, availableWidthPx) {
   if (typeof width === "number") {
     return width;
@@ -2259,17 +2317,18 @@ function detectImageType(imagePath, responseContentType) {
   if (typeFromExtension) return typeFromExtension;
   return "png";
 }
-function createTypedImageRun(opts) {
+async function createTypedImageRun(opts) {
   const base = {
     data: opts.data,
     transformation: opts.transformation,
     ...opts.floating && { floating: opts.floating }
   };
   if (opts.type === "svg") {
+    const raster = await rasterizeSvgFallback(opts.data, opts.transformation);
     return new ImageRun({
       type: "svg",
       ...base,
-      fallback: { type: "png", data: opts.data }
+      fallback: { type: "png", data: raster ?? opts.data }
     });
   }
   return new ImageRun({ type: opts.type, ...base });
@@ -4428,7 +4487,7 @@ async function createImage(path3, theme, themeName, options = {}) {
     const { mapFloatingOptions: mapFloatingOptions2 } = await Promise.resolve().then(() => (init_docxImagePositioning(), docxImagePositioning_exports));
     const floating = isFloating ? mapFloatingOptions2(options.floating, theme, themeName) : void 0;
     const imageType = detectImageType(imagePath, responseContentType);
-    const imageRun = createTypedImageRun({
+    const imageRun = await createTypedImageRun({
       type: imageType,
       data: imageBuffer,
       transformation: { width: dimensions.width, height: dimensions.height },
@@ -4973,7 +5032,7 @@ async function createTable(columns, tableConfig, theme, themeName, _options = {}
             // fallback height
           );
           const imgType = detectImageType(imageSource, imageResult.contentType);
-          const imageRun = createTypedImageRun({
+          const imageRun = await createTypedImageRun({
             type: imgType,
             data: imageResult.buffer,
             transformation: {
@@ -8224,23 +8283,26 @@ function coreProperties(metadata) {
 async function renderDocument(structure, layout, options) {
   return runWithGenerationDate(
     structure.metadata.date,
-    () => runWithBaseDir(
-      options?.baseDir,
-      () => globalBookmarkRegistry.runScoped(
-        () => globalRevisionIdRegistry.runScoped(
-          () => globalNumberingRegistry.runScoped(
-            () => globalSectionBookmarkRegistry.runScoped(
-              () => (
-                // Comment ids are a separate OOXML namespace from w:ins/w:del,
-                // but they need the same per-render isolation: outside this nest
-                // concurrent generations would interleave counters and an anchor
-                // would point at another document's comment body.
-                globalCommentRegistry.runScoped(
-                  () => (
-                    // Footnote ids are document-scoped too: a reference resolved
-                    // against another render's counter points at the wrong body.
-                    globalNoteRegistry.runScoped(
-                      () => renderDocumentScoped(structure, layout, options)
+    () => runWithWarnings(
+      options?.warnings,
+      () => runWithBaseDir(
+        options?.baseDir,
+        () => globalBookmarkRegistry.runScoped(
+          () => globalRevisionIdRegistry.runScoped(
+            () => globalNumberingRegistry.runScoped(
+              () => globalSectionBookmarkRegistry.runScoped(
+                () => (
+                  // Comment ids are a separate OOXML namespace from w:ins/w:del,
+                  // but they need the same per-render isolation: outside this nest
+                  // concurrent generations would interleave counters and an anchor
+                  // would point at another document's comment body.
+                  globalCommentRegistry.runScoped(
+                    () => (
+                      // Footnote ids are document-scoped too: a reference resolved
+                      // against another render's counter points at the wrong body.
+                      globalNoteRegistry.runScoped(
+                        () => renderDocumentScoped(structure, layout, options)
+                      )
                     )
                   )
                 )
@@ -8460,7 +8522,7 @@ async function renderHeaderFooterComponents(components, theme, themeName, contex
           themeName
         );
         const imageType = detectImageType(imageSource, responseContentType);
-        const imageRun = createTypedImageRun({
+        const imageRun = await createTypedImageRun({
           type: imageType,
           data: imageBuffer,
           transformation: {
@@ -9098,6 +9160,7 @@ function createBuilderImpl(state) {
         services: state.services,
         bypassCache: !state.enableCache,
         baseDir: options?.baseDir ?? state.baseDir,
+        warnings,
         ...visualFonts.length > 0 && { visualFonts }
       });
       const preservedDefinition = preserveSet ? {