@json-to-office/core-docx 3.3.0 → 4.0.0

package/dist/plugin/example/index.js

@@ -193,6 +193,7 @@ var init_minimal_docx_theme = __esm({
       name: "minimal",
       displayName: "Minimal Clean",
       description: "A quiet, warm minimal theme \u2014 Calibri throughout, sage-green ink on ivory neutrals, a large tracked-tight bold title, wide margins and hairline rules",
+      whenToUse: "Quiet documents where the type carries the tone: notes, briefs, drafts and internal papers that want warmth without decoration.",
       version: "4.0.0",
       colors: {
         primary: "#2B302B",
@@ -382,6 +383,7 @@ var init_devportal_docx_theme = __esm({
       name: "devportal",
       displayName: "Field Editorial",
       description: "A compact editorial theme \u2014 Helvetica in near-black ink with a burnt-orange accent, tight condensed titles, letterspaced labels, warm tinted fills and hairline rules",
+      whenToUse: "Developer and product documentation, API guides and technical handbooks: dense text, code and tables that need compact, letterspaced structure.",
       version: "4.0.0",
       colors: {
         primary: "#12191F",
@@ -580,6 +582,7 @@ var init_vermilion_docx_theme = __esm({
       name: "vermilion",
       displayName: "Vermilion Editorial",
       description: "Poster-red editorial system \u2014 vermilion display headings, ink text, warm creams and hairline rules",
+      whenToUse: "Editorial and annual-report work that wants a strong red display voice: covers, feature-style sections, reports built around a few large headings.",
       version: "1.0.0",
       colors: {
         primary: "#282829",
@@ -798,6 +801,7 @@ var init_consulting_docx_theme = __esm({
       name: "consulting",
       displayName: "Consulting House",
       description: "The house style for client and technical reports \u2014 near-black ink, three greys and one deep-blue accent, Calibri body under Arial headings, hairline rules, no fills behind body text, safe fonts only",
+      whenToUse: "Client and technical reports, memos and anything a client will read as the house's own work; the default choice for a report unless the brief names a brand.",
       version: "1.0.0",
       colors: {
         primary: "#1A1F26",
@@ -12132,8 +12136,10 @@ import {
 } from "@json-to-office/quality";
 import { DEFAULT_DOCX_RENDERER_ID as DEFAULT_DOCX_RENDERER_ID2 } from "@json-to-office/shared-docx";
 import {
+  designCanvas as designCanvas2,
   designColors as designColors2,
-  resolveDesignColor as resolveDesignColor2
+  resolveDesignColor as resolveDesignColor2,
+  typeScaleSizes
 } from "@json-to-office/shared";
 
 // src/json/normalizer.ts
@@ -12903,6 +12909,93 @@ function walkActive(node, path3, page, visit) {
     (child, index) => walkActive(child, `${path3}/children/${index}`, page, visit)
   );
 }
+function textSizeFact(node, props, path3, typography, role) {
+  const size = effectiveFontSize(node, props, typography);
+  if (size === void 0) return void 0;
+  return {
+    id: `docx:text-size:${path3}`,
+    kind: "docx/text-size",
+    path: path3,
+    role: role ?? styleKey(node, props),
+    fontSizePt: size.fontSizePt,
+    authored: size.authored,
+    ...size.authored && { sizePath: `${path3}/props/font/size` }
+  };
+}
+function tableTextSizeFacts(props, authored, path3, typography, page) {
+  const facts = [];
+  const sizeOf = (holder) => finiteNumber(asRecord(asRecord(holder)?.font)?.size);
+  const authoredSize = (holder, pointer, role) => {
+    const size = sizeOf(holder);
+    if (size === void 0) return;
+    facts.push({
+      id: `docx:text-size:${pointer}`,
+      kind: "docx/text-size",
+      path: pointer,
+      role,
+      fontSizePt: size,
+      authored: true,
+      sizePath: `${pointer}/font/size`
+    });
+  };
+  const cellContent = (holder, pointer, role) => {
+    const content = asRecord(holder)?.content;
+    if (asRecord(content) === void 0) return;
+    walkActive(content, `${pointer}/content`, page, (node, nodePath) => {
+      if (node.name !== "paragraph" && node.name !== "heading") return;
+      const nodeProps = asRecord(node.props) ?? {};
+      if (typeof nodeProps.text !== "string" || nodeProps.text.trim() === "")
+        return;
+      const fact = textSizeFact(node, nodeProps, nodePath, typography, role);
+      if (fact) facts.push(fact);
+    });
+  };
+  if (authored) {
+    authoredSize(
+      authored.cellDefaults,
+      `${path3}/props/cellDefaults`,
+      "tableCell"
+    );
+    authoredSize(
+      authored.headerCellDefaults,
+      `${path3}/props/headerCellDefaults`,
+      "tableHeader"
+    );
+    const columns = Array.isArray(authored.columns) ? authored.columns : [];
+    columns.forEach((column, index) => {
+      const record = asRecord(column) ?? {};
+      const columnPath = `${path3}/props/columns/${index}`;
+      authoredSize(
+        record.cellDefaults,
+        `${columnPath}/cellDefaults`,
+        "tableCell"
+      );
+      authoredSize(record.header, `${columnPath}/header`, "tableHeader");
+      cellContent(record.header, `${columnPath}/header`, "tableHeader");
+      const cells = Array.isArray(record.cells) ? record.cells : [];
+      cells.forEach((cell, cellIndex) => {
+        authoredSize(cell, `${columnPath}/cells/${cellIndex}`, "tableCell");
+        cellContent(cell, `${columnPath}/cells/${cellIndex}`, "tableCell");
+      });
+    });
+  }
+  for (const [key, role] of [
+    ["cellDefaults", "tableCell"],
+    ["headerCellDefaults", "tableHeader"]
+  ]) {
+    const size = sizeOf(props[key]);
+    if (size === void 0) continue;
+    facts.push({
+      id: `docx:text-size:${path3}:${role}`,
+      kind: "docx/text-size",
+      path: path3,
+      role,
+      fontSizePt: size,
+      authored: false
+    });
+  }
+  return facts;
+}
 function prepareDocxQualityDocument(document, options = {}) {
   const themed = options.context ?? resolveThemeContext(normalizeDocument(document)[0], {
     customThemes: options.customThemes,
@@ -12972,6 +13065,43 @@ function prepareDocxQualityDocument(document, options = {}) {
     const header = part("header");
     const footer = part("footer");
     inherited = { header, footer };
+    for (const kind of ["header", "footer"]) {
+      if (!Array.isArray(props[kind])) continue;
+      const drawnByBlock = !Array.isArray(
+        asRecord(
+          asRecord(
+            (Array.isArray(themed.document.children) ? themed.document.children : [])[index]
+          )?.props
+        )?.[kind]
+      );
+      const part2 = props[kind];
+      const visitChrome = (child, childPath) => {
+        if (child.name !== "paragraph" && child.name !== "heading") return;
+        const childProps = asRecord(child.props) ?? {};
+        if (typeof childProps.text !== "string" || childProps.text.trim() === "")
+          return;
+        const fact = textSizeFact(
+          child,
+          childProps,
+          childPath,
+          typography,
+          kind
+        );
+        if (fact)
+          addFact({
+            ...fact,
+            generated: drawnByBlock || authoredPath(childPath) !== childPath
+          });
+      };
+      part2.forEach(
+        (child, childIndex) => walkActive(
+          child,
+          `/children/${index}/props/${kind}/${childIndex}`,
+          basePage,
+          visitChrome
+        )
+      );
+    }
     addFact({
       id: `docx:section-chrome:${index}`,
       kind: "docx/section-chrome",
@@ -13005,12 +13135,34 @@ function prepareDocxQualityDocument(document, options = {}) {
     (value) => `#${resolveDesignColor2(value, visualColors)}`
   ) ?? SERIES_COLOR_TOKENS.filter((token) => paletteHexes[token] !== void 0);
   const authoredPropsAt = (pointer) => asRecord(asRecord(nodeAtPointer(context.document, pointer))?.props);
+  const roleSizesPt = {};
+  for (const key of Object.keys(typography.styles)) {
+    const size = effectiveFontSize(
+      { name: "paragraph" },
+      { themeStyle: key },
+      typography
+    );
+    if (size) roleSizesPt[key] = size.fontSizePt;
+  }
+  const scale = resolved.theme.typography?.scale?.[designCanvas2("docx", resolved.theme.page?.size)];
+  const typeScalePt = [
+    .../* @__PURE__ */ new Set([
+      ...Object.values(roleSizesPt),
+      ...["heading", "body", "mono", "light"].flatMap((role) => {
+        const size = resolveFontSize(resolved.theme, role);
+        return size === void 0 ? [] : [size];
+      }),
+      ...scale ? typeScaleSizes(scale) : []
+    ])
+  ].sort((a, b) => a - b);
   addFact({
     id: "docx:theme",
     kind: "docx/theme",
     path: "/props",
     themeName: context.themeName,
     paletteHexes,
+    typeScalePt,
+    roleSizesPt,
     // `heading` and `body` only. A theme also names `mono` and `light`, but
     // those paint nothing until a component asks for them — counting an
     // unused `Courier New` against a document's family budget would flag a
@@ -13063,6 +13215,15 @@ function prepareDocxQualityDocument(document, options = {}) {
     if (node.name === "table") {
       const fact = tableFact(props, path3, page.availableWidthTwips);
       if (fact) addFact(fact);
+      for (const size of tableTextSizeFacts(
+        props,
+        authoredPropsAt(path3),
+        path3,
+        typography,
+        page
+      )) {
+        addFact({ ...size, generated: authoredPath(size.path) !== size.path });
+      }
       const design = tableDesignFact(
         props,
         path3,
@@ -13121,6 +13282,10 @@ function prepareDocxQualityDocument(document, options = {}) {
     if (node.name === "paragraph" || node.name === "heading") {
       const fact = lineBoxFact(node, props, path3, typography, context.document);
       if (fact) addFact(fact);
+      if (typeof props.text === "string" && props.text.trim() !== "") {
+        const fact2 = textSizeFact(node, props, path3, typography);
+        if (fact2) addFact({ ...fact2, generated: authoredPath(path3) !== path3 });
+      }
     }
     if (node.name === "image" || node.name === "visual") {
       for (const fact of svgTextFacts(props, path3)) addFact(fact);