@json-to-office/core-docx 3.2.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",
@@ -5307,6 +5311,10 @@ function resolveServiceUrl(propsUrl, servicesUrl, defaultUrl) {
   const withScheme = /^https?:\/\//i.test(raw) ? raw : `http://${raw}`;
   return withScheme.replace(/\/+$/, "");
 }
+var SERVICE_UNAVAILABLE_CODE = "SERVICE_UNAVAILABLE";
+function serviceUnavailable(message) {
+  return Object.assign(new Error(message), { code: SERVICE_UNAVAILABLE_CODE });
+}
 async function postJsonToService(opts) {
   const resolvedHeaders = typeof opts.headers === "function" ? await opts.headers(opts.body) : opts.headers;
   const headers = {
@@ -5326,12 +5334,12 @@ async function postJsonToService(opts) {
     });
   } catch (error) {
     if (error?.name === "AbortError") {
-      throw new Error(
+      throw serviceUnavailable(
         `${opts.serviceLabel} timed out after ${timeoutMs}ms at ${opts.url}.`
       );
     }
     const cause = error instanceof Error ? error.message : String(error);
-    throw new Error(opts.onUnreachable(opts.url, cause));
+    throw serviceUnavailable(opts.onUnreachable(opts.url, cause));
   } finally {
     clearTimeout(timer);
   }
@@ -12026,6 +12034,7 @@ async function processResolvedDocument(document, resolved, themeName, generation
   };
 }
 function createDocumentMetadata(props, generationDate = /* @__PURE__ */ new Date()) {
+  const parsed = props.metadata?.date ? new Date(props.metadata.date) : void 0;
   return {
     title: props.metadata?.title,
     subtitle: props.metadata?.subtitle,
@@ -12034,7 +12043,7 @@ function createDocumentMetadata(props, generationDate = /* @__PURE__ */ new Date
     company: props.metadata?.company,
     version: props.metadata?.version,
     tags: props.metadata?.tags,
-    date: props.metadata?.date ? new Date(props.metadata.date) : generationDate
+    date: parsed && !Number.isNaN(parsed.getTime()) ? parsed : generationDate
   };
 }
 async function extractSections(components, context) {
@@ -12126,7 +12135,12 @@ import {
   normalizeHighchartsChart
 } from "@json-to-office/quality";
 import { DEFAULT_DOCX_RENDERER_ID as DEFAULT_DOCX_RENDERER_ID2 } from "@json-to-office/shared-docx";
-import { designColors as designColors2, resolveDesignColor as resolveDesignColor2 } from "@json-to-office/shared";
+import {
+  designCanvas as designCanvas2,
+  designColors as designColors2,
+  resolveDesignColor as resolveDesignColor2,
+  typeScaleSizes
+} from "@json-to-office/shared";
 
 // src/json/normalizer.ts
 function normalizeComponent(component) {
@@ -12895,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,
@@ -12942,6 +13043,75 @@ function prepareDocxQualityDocument(document, options = {}) {
       ...budget
     });
   }
+  for (const role of blockSlotRoles2(themed.document, expanded.blocks)) {
+    addFact({
+      id: `docx:chrome-slot:${role.path}`,
+      kind: "docx/chrome-slot",
+      path: role.path,
+      relatedPaths: [role.invocation],
+      block: role.block,
+      slot: role.slot,
+      role: role.role,
+      present: slotIsFilled(role.value),
+      invocation: role.invocation
+    });
+  }
+  const topLevel = Array.isArray(context.document.children) ? context.document.children : [];
+  let inherited = {};
+  topLevel.forEach((node, index) => {
+    if (node?.name !== "section") return;
+    const props = asRecord(node.props) ?? {};
+    const part = (kind) => props[kind] === "linkToPrevious" ? inherited[kind] : props[kind];
+    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",
+      path: `/children/${index}`,
+      index,
+      header: partPresent(header),
+      footer: partPresent(footer),
+      pageNumber: hasPageField(header) || hasPageField(footer)
+    });
+  });
   const paletteHexes = {};
   const visualColors = designColors2(
     resolved.theme.colors,
@@ -12965,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
@@ -13023,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,
@@ -13081,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);
@@ -13136,6 +13341,17 @@ function prepareDocxQualityDocument(document, options = {}) {
     }
   };
 }
+function slotIsFilled(value) {
+  if (typeof value === "string") return value.trim() !== "";
+  return value !== void 0 && value !== null && value !== false && (!Array.isArray(value) || value.length > 0);
+}
+function partPresent(part) {
+  return Array.isArray(part) && part.length > 0;
+}
+var PAGE_FIELD = /\{(PAGE|PAGE_NUMBER|TOTAL_PAGES|NUMPAGES)\}/;
+function hasPageField(part) {
+  return Array.isArray(part) && PAGE_FIELD.test(JSON.stringify(part));
+}
 
 // src/core/generateFromIr.ts
 var UncompiledComponentError = class extends Error {