@json-to-office/jto-ops 4.4.4 → 4.5.0

package/dist/index.js

@@ -2136,7 +2136,7 @@ var RENDERED_QUALITY_RULES = {
     renderedRule({
       id: "rendered/page-underfilled",
       code: QUALITY_CODES.RENDERED_PAGE_UNDERFILLED,
-      description: "A docx page, other than the first and the last, whose ink stops less than halfway down the body area before the next page begins (`context.fill` is the share used): a section that ends early on its own page, argued in a paragraph where a table or chart was owed.",
+      description: "A docx page whose ink stops well above the footer: a middle page less than half filled before the next page begins (`kind: middle-page`), or a last page less than a quarter filled that holds only the tail of the document (`kind: last-page`); `context.fill` is the share used. The first page is never judged.",
       category: "composition",
       defaultSeverity: "info",
       formats: ["docx"]
@@ -2532,6 +2532,7 @@ function assignInventory(pages, inventory) {
 
 // src/rendered-analysis.ts
 var MINIMUM_PAGE_FILL = 0.5;
+var MINIMUM_LAST_PAGE_FILL = 0.25;
 function isRenderedGeometryFact(fact) {
   return fact.kind === "rendered/geometry";
 }
@@ -2821,9 +2822,8 @@ function draftRenderedFindings(input) {
   });
   if (format === "docx") {
     pages.forEach((page, pageIndex) => {
-      if (!page.ink || pageIndex === 0 || pageIndex === pages.length - 1) {
-        return;
-      }
+      if (!page.ink || pageIndex === 0) return;
+      const last = pageIndex === pages.length - 1;
       const rowPt = page.heightPt / page.ink.rows;
       let headerBottom = 0;
       let footerTop = page.heightPt;
@@ -2842,7 +2842,7 @@ function draftRenderedFindings(input) {
       const top = body[0] * rowPt;
       const bottom = (body[body.length - 1] + 1) * rowPt;
       const fill = Math.round((bottom - top) / (footerTop - top) * 100) / 100;
-      if (fill >= MINIMUM_PAGE_FILL) return;
+      if (fill >= (last ? MINIMUM_LAST_PAGE_FILL : MINIMUM_PAGE_FILL)) return;
       let owner;
       for (const match of matches) {
         if (match.status !== "mapped" || match.entry.repeats) continue;
@@ -2862,14 +2862,14 @@ function draftRenderedFindings(input) {
           mapping: section ? "mapped" : "unmapped",
           page: pageIndex + 1,
           path: section ?? "",
-          message: `Page ${pageIndex + 1} is ${Math.round(fill * 100)}% filled: its content stops ${Math.round(footerTop - bottom)}pt above the footer and the next page begins anyway.`,
-          suggestion: "Let the next section continue on this page, or give the page the table or chart its argument owes; a short section on its own page reads as unfinished.",
+          message: last ? `Page ${pageIndex + 1}, the last, is ${Math.round(fill * 100)}% filled: only the tail of the document reached it.` : `Page ${pageIndex + 1} is ${Math.round(fill * 100)}% filled: its content stops ${Math.round(footerTop - bottom)}pt above the footer and the next page begins anyway.`,
+          suggestion: last ? "Keep the notes and sources with the paragraph before them, or tighten the page before so the document closes on a designed page rather than a stub." : "Merge this section into its neighbour, or give the page the table or chart its argument owes. Do not pad it with prose: a short section on its own page reads as unfinished, a padded one reads as filler.",
           evidence: {
             summary: "Share of the body area the page paints, header to footer",
-            expected: `\u2265 ${Math.round(MINIMUM_PAGE_FILL * 100)}%`,
+            expected: `\u2265 ${Math.round((last ? MINIMUM_LAST_PAGE_FILL : MINIMUM_PAGE_FILL) * 100)}%`,
             actual: fill
           },
-          context: { fill }
+          context: { fill, kind: last ? "last-page" : "middle-page" }
         })
       );
     });