@json-to-office/core-docx 1.7.0 → 1.9.0

package/dist/ir/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/ir/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAKhE,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA6C3D,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,wBAAwB,CAAC;AAuC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAEL,KAAK,MAAM,EAoCZ,MAAM,SAAS,CAAC;AAiBjB,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IACrD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B;;;;OAIG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AA8FD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,QAAQ,GAAE,iBAAiB,EAAO,EAClC,MAAM,GAAE,cAA0B,EAClC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,iBAAiB,CAgHnB"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/ir/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAKhE,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA6C3D,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,wBAAwB,CAAC;AAuC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAEL,KAAK,MAAM,EAqCZ,MAAM,SAAS,CAAC;AAiBjB,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IACrD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B;;;;OAIG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AA8FD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,QAAQ,GAAE,iBAAiB,EAAO,EAClC,MAAM,GAAE,cAA0B,EAClC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,iBAAiB,CAgHnB"}

package/dist/plugin/example/index.js

@@ -1182,6 +1182,15 @@ function resolveFontFamily(theme, fontRef) {
   }
   return theme.fonts[fontRef]?.family || theme.fonts.body.family;
 }
+function resolveFontSize(theme, fontRef) {
+  if (!theme?.fonts?.body?.size) {
+    return void 0;
+  }
+  if (!fontRef) {
+    return theme.fonts.body.size;
+  }
+  return theme.fonts[fontRef]?.size || theme.fonts.body.size;
+}
 function resolveFontProperties(theme, fontRef) {
   const targetFontKey = fontRef || "body";
   if (!theme?.fonts?.[targetFontKey]) {
@@ -2484,6 +2493,14 @@ function paragraphOptions(formatting) {
   if (formatting.outlineLevel !== void 0) {
     options.outlineLevel = formatting.outlineLevel;
   }
+  if (formatting.borders) {
+    const borders3 = {};
+    for (const side of ["top", "bottom", "left", "right", "between"]) {
+      const emitted = emitBorder(formatting.borders[side]);
+      if (emitted) borders3[side] = emitted;
+    }
+    if (Object.keys(borders3).length > 0) options.border = borders3;
+  }
   return options;
 }
 function emitParagraph(block2, resources = /* @__PURE__ */ new Map()) {
@@ -2667,7 +2684,11 @@ function emitBorder(border3) {
   return {
     style: BORDER_STYLE[border3.style] ?? BorderStyle.SINGLE,
     size: border3.sizeEighthPoints ?? 0,
-    color: border3.color?.hex ?? "000000"
+    color: border3.color?.hex ?? "000000",
+    // Stated only when the IR states it, so every border that predates the
+    // rule component emits exactly the bytes it did before. office-open
+    // already carries `w:space`; this is what keeps the two agreeing.
+    ...border3.spacePoints !== void 0 ? { space: border3.spacePoints } : {}
   };
 }
 var ALIGNMENT2, PAGE_FIELD, WRAP_TYPE, VERTICAL_ALIGN, TABLE_ANCHOR, HORIZONTAL_POSITION, VERTICAL_POSITION, BORDER_STYLE;
@@ -3337,6 +3358,7 @@ var init_docxjs = __esm({
       "endnotes",
       "revisions",
       "breaks",
+      "borders",
       "tab-stops",
       "proofing-language",
       "custom-properties"
@@ -4636,6 +4658,7 @@ var init_office_open = __esm({
       "endnotes",
       "revisions",
       "breaks",
+      "borders",
       "tab-stops",
       "proofing-language",
       "custom-properties"
@@ -6690,17 +6713,17 @@ function createDocumentStyles(themeNameOrObject = "minimal", language) {
     "subtitle"
   ]);
   if (theme.styles) {
-    for (const [styleKey, styleValue] of Object.entries(theme.styles)) {
-      if (predefinedStyleKeys.has(styleKey)) {
+    for (const [styleKey2, styleValue] of Object.entries(theme.styles)) {
+      if (predefinedStyleKeys.has(styleKey2)) {
         continue;
       }
       if (!styleValue) {
         continue;
       }
-      const tocMatch = /^TOC([1-9])$/.exec(styleKey);
-      const customStyle = tocMatch ? styleValue : resolveStyleWithBaseStyle(theme, styleKey) || styleValue;
-      const styleId = tocMatch ? `TOC${tocMatch[1]}` : styleKey;
-      const styleName = tocMatch ? `TOC ${tocMatch[1]}` : styleKey.replace(/([A-Z])/g, " $1").trim();
+      const tocMatch = /^TOC([1-9])$/.exec(styleKey2);
+      const customStyle = tocMatch ? styleValue : resolveStyleWithBaseStyle(theme, styleKey2) || styleValue;
+      const styleId = tocMatch ? `TOC${tocMatch[1]}` : styleKey2;
+      const styleName = tocMatch ? `TOC ${tocMatch[1]}` : styleKey2.replace(/([A-Z])/g, " $1").trim();
       const mapBaseStyleId = (base) => {
         if (!base) return "Normal";
         const lower = base.toLowerCase();
@@ -8624,6 +8647,8 @@ function compileComponent(component, scope) {
       return compileStatistic(component, scope);
     case "toc":
       return compileToc(component, scope);
+    case "rule":
+      return compileRule(component, scope);
     case "text-box":
       return compileTextBox(component, scope);
     case "columns":
@@ -9200,6 +9225,100 @@ function compileToc(component, scope) {
   });
   return blocks;
 }
+var DEFAULT_RULE_SPACING_PT = 6;
+var DEFAULT_RULE_THICKNESS_PT = 1;
+var RULE_LINE_TWIPS = 20;
+var RULE_BORDER_STYLE = {
+  solid: "single",
+  dashed: "dashed",
+  dotted: "dotted",
+  double: "double"
+};
+function compileRule(component, scope) {
+  const { ctx, path: path3 } = scope;
+  const props = component.props ?? {};
+  ctx.features.require("borders", path3);
+  const thicknessPt = Math.min(
+    12,
+    Math.max(
+      0.25,
+      typeof props.thickness === "number" && Number.isFinite(props.thickness) ? props.thickness : DEFAULT_RULE_THICKNESS_PT
+    )
+  );
+  const spacing = props.spacing ?? {};
+  const beforePt = typeof spacing.before === "number" && Number.isFinite(spacing.before) ? spacing.before : DEFAULT_RULE_SPACING_PT;
+  const afterPt = typeof spacing.after === "number" && Number.isFinite(spacing.after) ? spacing.after : DEFAULT_RULE_SPACING_PT;
+  return [
+    {
+      kind: "paragraph",
+      id: scope.id,
+      path: path3,
+      styleId: "Normal",
+      children: [],
+      formatting: {
+        spacing: {
+          beforeTwips: pointsToTwips2(beforePt),
+          afterTwips: pointsToTwips2(afterPt),
+          lineTwips: RULE_LINE_TWIPS,
+          lineRule: "exact"
+        },
+        ...ruleIndent(props, ctx, path3),
+        borders: {
+          bottom: {
+            style: RULE_BORDER_STYLE[String(props.style)] ?? "single",
+            sizeEighthPoints: pointsToEighthPoints(thicknessPt),
+            color: irColor(
+              resolveColor(String(props.color ?? "border"), ctx.theme)
+            ),
+            // The border hangs off the paragraph edge; any gap the author
+            // wants belongs to `spacing`, where they can see it.
+            spacePoints: 0
+          }
+        }
+      }
+    }
+  ];
+}
+function ruleIndent(props, ctx, path3) {
+  const width = props.width;
+  if (width === void 0) return {};
+  const page = getPageSetup(ctx.theme);
+  const measureTwips = Math.max(
+    0,
+    page.size.width - page.margin.left - page.margin.right
+  );
+  let usedTwips;
+  if (typeof width === "number" && Number.isFinite(width)) {
+    usedTwips = pointsToTwips2(width);
+  } else if (typeof width === "string" && width.trim().endsWith("%")) {
+    const percent = Number(width.trim().slice(0, -1));
+    if (Number.isFinite(percent)) {
+      usedTwips = Math.round(measureTwips * percent / 100);
+    }
+  }
+  if (usedTwips === void 0) return {};
+  const remainder = measureTwips - usedTwips;
+  if (remainder <= 0) {
+    if (remainder < 0) {
+      warnOnce(
+        ctx,
+        "rule",
+        `Rule width ${JSON.stringify(width)} at ${path3} is wider than the ${Math.round(measureTwips / 20)}pt text measure; it runs the full measure instead.`
+      );
+    }
+    return {};
+  }
+  switch (props.alignment) {
+    case "right":
+      return { indent: { leftTwips: remainder } };
+    case "center": {
+      const half = Math.round(remainder / 2);
+      return { indent: { leftTwips: half, rightTwips: remainder - half } };
+    }
+    default:
+      return { indent: { rightTwips: remainder } };
+  }
+}
 var TREND_GLYPHS = {
   up: "\u25B2",
   down: "\u25BC",
@@ -11196,8 +11315,8 @@ function getHeadingDefaults(theme) {
 function getHeadingDefaultsForLevel(theme, level) {
   const defaults = {};
   if (theme.styles) {
-    const styleKey = `heading${level}`;
-    const headingStyle = theme.styles[styleKey];
+    const styleKey2 = `heading${level}`;
+    const headingStyle = theme.styles[styleKey2];
     if (headingStyle?.alignment) {
       defaults.alignment = headingStyle.alignment;
     }
@@ -11545,6 +11664,8 @@ function normalizeDocument(document) {
 }
 
 // src/quality/facts.ts
+init_styleHelpers();
+init_defaults();
 init_widthUtils();
 function asRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
@@ -11634,6 +11755,70 @@ function characterSpacingPt(spacing) {
   if (rule === void 0 || value === void 0) return 0;
   return rule.type === "condensed" ? -value / TWIPS_PER_POINT3 : value / TWIPS_PER_POINT3;
 }
+function pointerExists(root, pointer) {
+  let current = root;
+  for (const token of pointer.split("/").slice(1)) {
+    if (Array.isArray(current)) {
+      const index = Number(token);
+      if (!Number.isInteger(index)) return false;
+      current = current[index];
+      continue;
+    }
+    const record = asRecord(current);
+    if (!record) return false;
+    current = record[token];
+  }
+  return current !== void 0;
+}
+function styleKey(node, props) {
+  if (node.name === "heading") {
+    return `heading${finiteNumber(props.level) ?? 1}`;
+  }
+  return typeof props.themeStyle === "string" && props.themeStyle !== "" ? props.themeStyle : "normal";
+}
+function effectiveFontSize(node, props, typography) {
+  const authored = finiteNumber(asRecord(props.font)?.size);
+  if (authored !== void 0) return { fontSizePt: authored, authored: true };
+  const { styles, theme } = typography;
+  const style = asRecord(styles[styleKey(node, props)]) ?? asRecord(styles.normal);
+  const stated = finiteNumber(style?.size);
+  if (stated !== void 0) return { fontSizePt: stated, authored: false };
+  const reference = style?.font === "heading" || style?.font === "body" || style?.font === "mono" || style?.font === "light" ? style.font : void 0;
+  const inherited = resolveFontSize(theme, reference);
+  return inherited === void 0 ? void 0 : { fontSizePt: inherited, authored: false };
+}
+function pinnedLineBox(props, path3) {
+  const candidates = [
+    [props.lineSpacing, `${path3}/props/lineSpacing`],
+    [asRecord(props.font)?.lineSpacing, `${path3}/props/font/lineSpacing`]
+  ];
+  for (const [spacing, pointer] of candidates) {
+    if (spacing === void 0) continue;
+    const rule = asRecord(spacing);
+    if (rule?.type !== "exactly") return void 0;
+    const lineBoxPt = finiteNumber(rule.value);
+    return lineBoxPt === void 0 ? void 0 : { lineBoxPt, pointer };
+  }
+  return void 0;
+}
+function lineBoxFact(node, props, path3, typography, authored) {
+  if (typeof props.text !== "string" || props.text.trim() === "") {
+    return void 0;
+  }
+  const pinned = pinnedLineBox(props, path3);
+  if (!pinned) return void 0;
+  const size = effectiveFontSize(node, props, typography);
+  if (size === void 0) return void 0;
+  return {
+    id: `docx:line-box:${path3}`,
+    kind: "docx/line-box",
+    path: pinned.pointer,
+    lineBoxPt: pinned.lineBoxPt,
+    fontSizePt: size.fontSizePt,
+    fontSizeAuthored: size.authored,
+    patchable: pointerExists(authored, pinned.pointer)
+  };
+}
 function frameSignature(floating) {
   const horizontal = asRecord(floating.horizontalPosition);
   const vertical = asRecord(floating.verticalPosition);
@@ -11750,6 +11935,10 @@ function prepareDocxQualityDocument(document, options = {}) {
   });
   const resolved = resolveDocumentTree(context.document, context.theme);
   const basePage = pageBox(resolved.theme, context.themeName);
+  const typography = {
+    styles: getThemeStyles(resolved.theme),
+    theme: resolved.theme
+  };
   const facts = [];
   const provenance = {};
   let previousHeadingLevel;
@@ -11780,6 +11969,10 @@ function prepareDocxQualityDocument(document, options = {}) {
         if (fact) addFact(fact);
       }
     }
+    if (node.name === "paragraph" || node.name === "heading") {
+      const fact = lineBoxFact(node, props, path3, typography, context.document);
+      if (fact) addFact(fact);
+    }
     if (node.name === "image" || node.name === "visual") {
       for (const fact of svgTextFacts(props, path3)) addFact(fact);
     }