mixdog 1.0.4 → 1.0.6

package/src/runtime/office/authoring/xlsx-html-runner.mjs

@@ -0,0 +1,139 @@
+// The `author` action's Excel input: lay the HTML's <section data-sheet> pages out in a local browser, read each back
+// as a grid (xlsx-html-measure.mjs), photograph pictures and each section for the review, and write the .xlsx.
+import { mkdir, mkdtemp, rm, stat, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { htmlFailure, launchHtmlBrowser, photographCaptures, runInBrowser } from './html-browser.mjs';
+import { iconTable, injectIcons } from './pptx-html-measure.mjs';
+import { extractXlsxSheets } from './xlsx-html-measure.mjs';
+import { drawDataCharts } from './pdf-html-charts.mjs';
+import { buildXlsxFromSheets } from './xlsx-html-build.mjs';
+
+/**
+ * Runs inside the page: a chart whose data-range names table cells by id (`{mh}:{m9},{wh}:{w9}`, each area one column
+ * from its header down, the first the categories) takes the labels and values those cells show, so the reference
+ * draws the chart the workbook will; a chart with values of its own, or a range not written that way, is left alone.
+ */
+function fillRangeCharts() {
+  for (const element of document.querySelectorAll('[data-chart][data-range]')) {
+    let spec;
+    try {
+      spec = JSON.parse(element.dataset.chart);
+    } catch {
+      continue;
+    }
+    if (spec.values || spec.series) continue;
+    const columns = element.dataset.range.split(',').map((area) => {
+      const ids = [...area.matchAll(/\{([A-Za-z][\w-]*)\}/g)].map((match) => document.getElementById(match[1]));
+      const [from, to] = ids;
+      if (ids.length !== 2 || !from || !to || from.cellIndex === undefined) return null;
+      const table = from.closest('table');
+      if (!table || table !== to.closest('table') || from.cellIndex !== to.cellIndex) return null;
+      const rows = [...table.rows].slice(from.parentElement.rowIndex, to.parentElement.rowIndex + 1);
+      return rows.map((row) => (row.cells[from.cellIndex]?.innerText || '').trim());
+    });
+    if (columns.length < 2 || columns.some((column) => !column || column.length !== columns[0].length)) continue;
+    const number = (text) => Number(String(text).replace(/[^\d.-]/g, '')) || 0;
+    const [labels, ...values] = columns;
+    element.dataset.chart = JSON.stringify({
+      ...spec,
+      labels: labels.slice(1),
+      ...(values.length === 1
+        ? { values: values[0].slice(1).map(number) }
+        : { series: values.map((column) => ({ name: column[0], values: column.slice(1).map(number) })) }),
+    });
+  }
+}
+
+/** Artifacts kept beside the workbook: its HTML and the browser's picture of each sheet. */
+export function xlsxHtmlArtifacts(target) {
+  return {
+    source: `${target}.mixdog-source.html`,
+    shot: (sheet) => `${target}.mixdog-html-sheet-${sheet}.png`,
+    compare: (page) => `${target}.mixdog-compare-page-${page}.png`,
+  };
+}
+
+export async function runXlsxHtmlAuthoring(html, output, { target, signal = null, timeoutMs = 90_000 }) {
+  const startedAt = performance.now();
+  const artifacts = xlsxHtmlArtifacts(target);
+  await mkdir(dirname(output), { recursive: true });
+  await rm(output, { force: true });
+  await writeFile(artifacts.source, html, 'utf8');
+  const scratch = await mkdtemp(join(tmpdir(), 'mixdog-xlsx-captures-'));
+  let browser;
+  try {
+    browser = await launchHtmlBrowser('xlsx-html-browser');
+  } catch (error) {
+    await rm(scratch, { recursive: true, force: true }).catch(() => {});
+    return htmlFailure(error, startedAt);
+  }
+  const work = async () => {
+    const page = await browser.newPage();
+    await page.setViewport({ width: 1920, height: 1200, deviceScaleFactor: 2 });
+    await page.goto(pathToFileURL(artifacts.source).href, { waitUntil: 'load' });
+    await page.evaluate(injectIcons, iconTable().table, '0 0 24 24');
+    await page.evaluate(() => document.fonts.ready);
+    const measure = await page.evaluate(extractXlsxSheets);
+    const captures = await photographCaptures(page, 'data-xlsx-capture', measure.captures, scratch);
+    // The reference each sheet is held against: its section as the browser drew it, cut at its content (a data sheet's
+    // section runs the window's width), with its charts drawn — a chart over its cells (data-range="{a}:{b},…") from
+    // the text those cells show.
+    await page.evaluate(fillRangeCharts);
+    await page.evaluate(drawDataCharts);
+    const extents = await page.evaluate(() =>
+      [...document.querySelectorAll('section[data-sheet]')].map((section) => {
+        const box = section.getBoundingClientRect();
+        const cs = getComputedStyle(section);
+        let right = box.left;
+        let bottom = box.top;
+        for (const el of section.querySelectorAll('*')) {
+          const r = el.getBoundingClientRect();
+          if (!r.width || !r.height) continue;
+          right = Math.max(right, r.right);
+          bottom = Math.max(bottom, r.bottom);
+        }
+        return {
+          x: box.left + window.scrollX,
+          y: box.top + window.scrollY,
+          width: Math.min(box.width, right - box.left + (parseFloat(cs.paddingRight) || 0)),
+          height: Math.min(box.height, bottom - box.top + (parseFloat(cs.paddingBottom) || 0)),
+        };
+      })
+    );
+    const htmlPages = [];
+    for (const [index, clip] of extents.entries()) {
+      const path = artifacts.shot(index + 1);
+      await page.screenshot({ path, clip, captureBeyondViewport: true });
+      htmlPages.push({ page: index + 1, path });
+    }
+    return { measure, captures, htmlPages, title: await page.title() };
+  };
+  let laid;
+  try {
+    laid = await runInBrowser(browser, { signal, timeoutMs }, work);
+  } catch (error) {
+    if (signal?.aborted) throw error;
+    await rm(scratch, { recursive: true, force: true }).catch(() => {});
+    return htmlFailure(error, startedAt);
+  }
+  try {
+    const built = await buildXlsxFromSheets(laid.measure, output, { captures: laid.captures, title: laid.title });
+    laid.measure.notes.push(...built.notes);
+    return {
+      ok: true,
+      output,
+      bytes: (await stat(output)).size,
+      htmlSource: artifacts.source,
+      htmlPages: laid.htmlPages,
+      logs: laid.measure.notes.map((text) => ({ level: 'warn', text })),
+      elapsedMs: Math.round(performance.now() - startedAt),
+    };
+  } catch (error) {
+    return htmlFailure(error, startedAt);
+  } finally {
+    await rm(scratch, { recursive: true, force: true }).catch(() => {});
+  }
+}

package/src/runtime/office/capabilities-catalog.mjs

@@ -99,6 +99,7 @@ export const CATALOG = {
         'set_paragraph_format',
         'set_font',
         'set_document_font',
+        'define_styles',
         'add_image',
         // Drawn as a picture before either backend sees it (office-actions-batch withDocumentCharts).
         'add_chart',
@@ -169,6 +170,8 @@ export const CATALOG = {
         'headerBold',
         'headerRows',
         'keepWithNext',
+        'rowStyles',
+        'totalRow',
       ],
       tableStyle: ['style', 'alignment', 'columnAlignments', 'columnWidths', 'borders', 'shading'],
       tableCell: [
@@ -317,6 +320,11 @@ export const CATALOG = {
         'valueNumberFormat',
         'dataLabelPosition',
         'dataLabelColor',
+        'highlight',
+        'mutedColor',
+        'gridlines',
+        'valueAxis',
+        'fontName',
       ],
       table: ['name', 'style'],
       pivot: ['source', 'destination', 'name', 'rows', 'columns', 'values'],

package/src/runtime/office/capabilities-signatures.mjs

@@ -68,7 +68,7 @@ export const FORMAT_SIGNATURES = {
     add_table: signature(['values'], ['paragraph', 'rows', 'columns', 'properties'], {
       propertySets: ['table'],
       notes:
-        'properties.alignment places the table on the page (left, center, right); properties.columnAlignments sets the text of each column (one of left, center, right, justify per column); without it a column of figures (184,200, 2.1%, 2.6억 원) sets right and the rest left. Without style, borders, or shading the table takes a bold header row with a rule under it and hairlines between rows; headerBold:false keeps the header plain. properties.headerRows (default 1) is how many rows the header takes: a two-level header, its group label merged across the columns it spans (merge_table_cells), is headerRows:2, and every header row is set bold on its bottom edge and repeats on a continuation page.',
+        'properties.alignment places the table on the page (left, center, right); properties.columnAlignments sets the text of each column (one of left, center, right, justify per column); without it a column of figures (184,200, 2.1%, 2.6억 원) sets right and the rest left. Without style, borders, or shading the table takes a bold header row with a rule under it and hairlines between rows; headerBold:false keeps the header plain. properties.headerRows (default 1) is how many rows the header takes: a two-level header, its group label merged across the columns it spans (merge_table_cells), is headerRows:2, and every header row is set bold on its bottom edge and repeats on a continuation page. properties.totalRow:true sets the last row as the total (bold over a rule). properties.rowStyles gives rows their own type, one entry per row from the first (null keeps the table\'s): [{ fontSize: 22, color: "1F5E4B" }, { fontSize: 9, color: "6B7280", bold: false }] is a stat strip — figures over their labels in one table.',
     }),
     set_table_style: signature(['table', 'properties'], [], {
       propertySets: ['tableStyle'],
@@ -101,6 +101,10 @@ export const FORMAT_SIGNATURES = {
       notes:
         "The document's own face, size, and ink — what every paragraph without its own reads, and what a paragraph added later in Word or by append_text starts from. properties: name, nameEastAsia, size, color.",
     }),
+    define_styles: signature(['styles'], [], {
+      notes:
+        'styles maps a style name to its fields — { "Title": { size: 24, bold: true, spacingAfter: 8 }, "Heading 1": { size: 15, bold: true, color: "1F5E4B", spacingBefore: 18, spacingAfter: 6, keepWithNext: true }, "Normal": { lineSpacing: 18, spacingAfter: 8, alignment: "left" }, "Caption": { size: 9, color: "6B7280" } } — fields: name, nameEastAsia, size, bold, italic, color, alignment, spacingBefore, spacingAfter, lineSpacing, lineSpacingRule, keepWithNext, keepTogether. Built-in styles are reached by their English name in any Word language. Define them before the paragraphs: append_text style:"Heading 1" then takes the definition with no properties of its own, and a paragraph the reader adds in Word under that style matches.',
+    }),
     set_font: signature(['find', 'properties'], [], {
       propertySets: ['font'],
       notes:
@@ -179,7 +183,7 @@ export const FORMAT_SIGNATURES = {
       ['section', 'kind', 'variant', 'prefix', 'separator', 'includeTotal', 'alignment'],
       {
         notes:
-          "Writes into the footer unless kind:'header' asks otherwise; variant picks default, first, or even, as for set_header_footer. The number alone, centred, on both backends; prefix ('Page') and includeTotal:true with separator ('/' by default) add to it.",
+          "Writes into the footer unless kind:'header' asks otherwise; variant picks default, first, or even, as for set_header_footer. The number alone, centred, on both backends; prefix ('Page') adds to it, and a separator (' / ') or includeTotal:true adds the total ('3 / 12'; includeTotal:false keeps the number alone). A cover without the running line: set_header_footer variant:'first' text:'' (and the same for the footer) after the default ones.",
       }
     ),
     insert_break: signature([], ['paragraph', 'kind'], {
@@ -239,7 +243,11 @@ export const FORMAT_SIGNATURES = {
       }
     ),
     set_cell: signature(['cell', 'value'], ['sheet']),
-    set_formula: signature(['cell', 'formula'], ['sheet']),
+    set_formula: signature(['formula'], ['sheet'], {
+      oneOf: [['cell'], ['range']],
+      notes:
+        'cell writes one formula. range fills it as Excel does: the formula is written for the top-left cell and every other cell takes it moved — relative references follow the cell, $-pinned ones stay, a table column (Ops[처리량 (건)]) stays — so range:"C6:C9" with =SUMIFS(Ops[처리량 (건)],Ops[월],B6) writes B7, B8, B9 into the rows below.',
+    }),
     set_range: signature(['range', 'values'], ['sheet']),
     append_row: signature(['values'], ['sheet'], {
       notes:
@@ -310,11 +318,16 @@ export const FORMAT_SIGNATURES = {
         'dataLabelPosition',
         'dataLabelColor',
         'plotBy',
+        'highlight',
+        'mutedColor',
+        'gridlines',
+        'valueAxis',
+        'fontName',
       ],
       {
         propertySets: ['chart'],
         notes:
-          "plotBy:'rows' reads one bounded range the other way — the first row supplies the categories and every other row is a series named by its first cell — for a sheet that grows a column per period. The first source column supplies categories; remaining columns become series. A series that is not beside its categories joins by comma the way Excel reads it (range:'A7:A12,D7:D12', same rows in every area). A source on another sheet names it on every area (range:\"'Calc'!A1:A7,'Calc'!D1:D7\"); sheet is where the frame stands. cell (H2) places the frame's top-left corner on the grid; left/top are points and win when both are given; width/height are points (420 × 260 at F5 reaches about N22), and the print area has to reach past the frame. toColumn (F) with cell ends the frame at that column's right edge in place of width, so a chart spans a table exactly: a column's points depend on the workbook's font (a Korean Excel's is wider), which a width cannot know.",
+          "highlight (a 0-based index or a category) sets one bar or slice-free point in the series colour and the rest in mutedColor (C9CED6), so the chart says which one it is about — one series only. gridlines:false and valueAxis:false quiet the plot when every bar carries its value (showValues). fontName sets every text in the chart in the sheet's face (a Korean workbook's Malgun Gothic), where it otherwise takes the workbook default. plotBy:'rows' reads one bounded range the other way — the first row supplies the categories and every other row is a series named by its first cell — for a sheet that grows a column per period. The first source column supplies categories; remaining columns become series. A series that is not beside its categories joins by comma the way Excel reads it (range:'A7:A12,D7:D12', same rows in every area). A source on another sheet names it on every area (range:\"'Calc'!A1:A7,'Calc'!D1:D7\"); sheet is where the frame stands. cell (H2) places the frame's top-left corner on the grid; left/top are points and win when both are given; width/height are points (420 × 260 at F5 reaches about N22), and the print area has to reach past the frame. toColumn (F) with cell ends the frame at that column's right edge in place of width, so a chart spans a table exactly: a column's points depend on the workbook's font (a Korean Excel's is wider), which a width cannot know.",
       }
     ),
     add_conditional_format: signature(
@@ -330,8 +343,7 @@ export const FORMAT_SIGNATURES = {
       ['range', 'formula1'],
       ['sheet', 'type', 'operator', 'formula2', 'inputMessage', 'errorMessage'],
       {
-        notes:
-          `type: ${XLSX_VALIDATION_TYPES.join(', ')}. Without type, choices ("a,b,c" or $A$1:$A$9) mean list; other formulas mean custom. Numeric/date/time/textLength rules take operator: ${XLSX_VALIDATION_OPERATORS.join(', ')} (default between). between/notBetween require formula2; other operators use formula1. Example: type:"whole", operator:"greaterThanOrEqual", formula1:"0". Under protect_sheet unlock entry cells with set_style properties:{ locked:false }.`,
+        notes: `type: ${XLSX_VALIDATION_TYPES.join(', ')}. Without type, choices ("a,b,c" or $A$1:$A$9) mean list; other formulas mean custom. Numeric/date/time/textLength rules take operator: ${XLSX_VALIDATION_OPERATORS.join(', ')} (default between). between/notBetween require formula2; other operators use formula1. Example: type:"whole", operator:"greaterThanOrEqual", formula1:"0". Under protect_sheet unlock entry cells with set_style properties:{ locked:false }.`,
       }
     ),
     freeze_panes: signature([], ['sheet', 'row', 'column'], {

package/src/runtime/office/capabilities.mjs

@@ -4,6 +4,7 @@ import { FIELD_ALIASES, OPERATION_ALIASES, PROPERTY_ALIASES } from './capabiliti
 import { BACKENDS, CATALOG, COMMON, VIRTUAL_OPERATIONS } from './capabilities-catalog.mjs';
 import { COMMON_SIGNATURES, FORMAT_SIGNATURES, signature } from './capabilities-signatures.mjs';
 import { normalizeXlsxValidation } from './portable/xlsx-contract.mjs';
+import { docxStyleDefinitions } from './portable/portable-docx-operations.mjs';
 
 export { OFFICE_ACTIONS } from './capabilities-catalog.mjs';
 
@@ -149,7 +150,10 @@ function operationProperties(catalog, signatureValue, backend) {
       .map((name) => [
         name,
         catalog.properties[name].filter(
-          (field) => !backend || !signatureValue.propertyBackends[field] || signatureValue.propertyBackends[field].includes(backend)
+          (field) =>
+            !backend ||
+            !signatureValue.propertyBackends[field] ||
+            signatureValue.propertyBackends[field].includes(backend)
         ),
       ])
   );
@@ -271,6 +275,14 @@ function applyFieldAliases(format, name, operation) {
 // handed to a single-cell operation is one, and says which operation writes it.
 function singleCellRangeFault(batch, name, operation, index, allowed) {
   const { format, backend } = batch;
+  // set_formula takes a range to fill; one cell named that way is still the cell it is.
+  if (format === 'xlsx' && name === 'set_formula' && operation.cell === undefined) {
+    if (SINGLE_CELL_REFERENCE.test(String(operation.range ?? '').trim())) {
+      operation.cell = operation.range;
+      delete operation.range;
+    }
+    return null;
+  }
   if (format !== 'xlsx' || !allowed.has('cell') || allowed.has('range')) return null;
   if (operation.range === undefined || operation.cell !== undefined) return null;
   if (SINGLE_CELL_REFERENCE.test(String(operation.range).trim())) {
@@ -404,6 +416,18 @@ function unknownPropertiesFault(batch, name, operation, index, allowedProperties
   return `${format.toUpperCase()} operation "${name}" at operation ${index + 1} has unknown properties: ${unknownProperties.join(', ')}.${didYouMean(corrections)} ${name} properties: ${[...allowedProperties].join(', ')}. ${describeHint(format, backend, name)}`;
 }
 
+// define_styles carries its fields one level down, per style; both backends read them only after this check, so a
+// misspelt field is refused here on either backend instead of being dropped by one of them.
+function docxStyleDefinitionFault(format, name, operation, index) {
+  if (format !== 'docx' || name !== 'define_styles' || operation.styles === undefined) return null;
+  try {
+    docxStyleDefinitions(operation);
+    return null;
+  } catch (error) {
+    return `DOCX operation "define_styles" at operation ${index + 1}: ${error.message}`;
+  }
+}
+
 // A Word table has two alignments that read alike: `alignment` places the
 // table on the page and `columnAlignments` sets the text of each column.
 // A list written into the first used to be serialized verbatim into the
@@ -490,6 +514,7 @@ function operationContractFaults(batch, operation, index) {
     unknownFieldsFault(batch, name, operation, index, { allowed, propertyKeys, missing }),
     unknownPropertiesFault(batch, name, operation, index, propertyKeys),
     ...docxTableAlignmentFaults(format, name, operation, index),
+    docxStyleDefinitionFault(format, name, operation, index),
     requiredInputFault(batch, name, operation, index, signatureValue, stableTargets),
   ].filter(Boolean);
   if (!faults.length && format === 'xlsx' && name === 'add_validation') {

package/src/runtime/office/com/office-com-host.ps1

@@ -370,11 +370,23 @@ function Snapshot-Word($doc, $payload) {
                 # The cell's accepted view and its struck-through words, as for a
                 # paragraph, so a redline in a table reads the same way.
                 try {
-                    $accepted = Word-AcceptedText $doc $table.Cell($r, $c).Range $context
+                    $cellRange = $table.Cell($r, $c).Range
+                    $accepted = Word-AcceptedText $doc $cellRange $context
+                    # The cell's type, as the portable reader states it: a stat strip's label set at the figure's size.
+                    $fontSize = 0
+                    $fontBold = $false
+                    try {
+                        $measured = [double]$cellRange.Font.Size
+                        if ($measured -gt 0 -and $measured -lt 1000) { $fontSize = $measured }
+                        $fontBold = [int]$cellRange.Font.Bold -eq -1
+                    }
+                    catch {}
                     $cells += [ordered]@{
                         text        = ([string]$accepted.text).TrimEnd("`r", "`a")
                         deletedText = ([string]$accepted.deleted).TrimEnd("`r", "`a")
                         tracked     = [bool]$accepted.tracked
+                        size        = $fontSize
+                        bold        = $fontBold
                     }
                 }
                 catch { $cells += $null }
@@ -387,6 +399,9 @@ function Snapshot-Word($doc, $payload) {
             for ($c = 1; $c -le @($rows[$r - 1]).Count; $c++) {
                 $record = @($rows[$r - 1])[$c - 1]
                 $cell = [ordered]@{ path = "/body/tbl[$i]/row[$r]/cell[$c]"; index = $c; text = $(if ($null -eq $record) { $null } else { $record.text }) }
+                if ($null -ne $record -and ($record.size -gt 0 -or $record.bold)) {
+                    $cell.font = [ordered]@{ size = $record.size; bold = [bool]$record.bold }
+                }
                 if ($null -ne $record -and $record.tracked) { $cell.tracked = $true }
                 if ($null -ne $record -and $record.deletedText.Length -gt 0) { $cell.deletedText = $record.deletedText }
                 $cells += $cell
@@ -673,10 +688,25 @@ function Excel-FormulaPrecedents([string]$formula, [string]$currentSheet) {
     return $output
 }
 
+# A cell's own horizontal alignment in the portable reader's words; $null for Excel's General (the cell states none),
+# which the portable reader leaves out too.
+function Excel-HorizontalAlignmentName($value) {
+    switch ([int]$value) {
+        -4131 { return 'left' }
+        -4108 { return 'center' }
+        -4152 { return 'right' }
+        -4130 { return 'justify' }
+        7 { return 'centerContinuous' }
+        -4117 { return 'distributed' }
+        5 { return 'fill' }
+        default { return $null }
+    }
+}
+
 # One cell's style as the snapshot reports it.
 function Excel-CellStyle($cell) {
     $font = $cell.Font
-    return [ordered]@{
+    $style = [ordered]@{
         fontName     = [string]$font.Name
         fontSize     = [double]$font.Size
         bold         = [bool]$font.Bold
@@ -685,6 +715,9 @@ function Excel-CellStyle($cell) {
         fillColor    = [double]$cell.Interior.Color
         numberFormat = Excel-EnglishNumberFormat $cell
     }
+    $alignment = $(try { Excel-HorizontalAlignmentName $cell.HorizontalAlignment } catch { $null })
+    if ($alignment) { $style.horizontalAlignment = $alignment }
+    return $style
 }
 
 # The style every cell of a block shares, or $null when they differ: Excel answers a mixed range's property with
@@ -706,7 +739,9 @@ function Excel-SharedCellStyle($range) {
     if ($null -eq $color -or $color -is [System.DBNull]) { return $null }
     $italic = $font.Italic
     if ($null -eq $italic -or $italic -is [System.DBNull]) { return $null }
-    return [ordered]@{
+    $horizontal = $range.HorizontalAlignment
+    if ($null -eq $horizontal -or $horizontal -is [System.DBNull]) { return $null }
+    $style = [ordered]@{
         fontName     = [string]$name
         fontSize     = [double]$size
         bold         = [bool]$bold
@@ -715,6 +750,9 @@ function Excel-SharedCellStyle($range) {
         fillColor    = [double]$fill
         numberFormat = Excel-EnglishNumberFormat $range ([string]$format)
     }
+    $alignment = Excel-HorizontalAlignmentName $horizontal
+    if ($alignment) { $style.horizontalAlignment = $alignment }
+    return $style
 }
 
 # The styles of one column's populated cells ($rows: their sheet rows, ascending) into $styles by address. Asking
@@ -1289,16 +1327,7 @@ function Snapshot-ExcelPage($book, $payload) {
                     }
                 }
                 if ($detailed -and $payload.includeStyles) {
-                    $cell = $range.Cells.Item($r, $c)
-                    $entry.style = [ordered]@{
-                        fontName     = [string]$cell.Font.Name
-                        fontSize     = [double]$cell.Font.Size
-                        bold         = [bool]$cell.Font.Bold
-                        italic       = [bool]$cell.Font.Italic
-                        color        = [double]$cell.Font.Color
-                        fillColor    = [double]$cell.Interior.Color
-                        numberFormat = Excel-EnglishNumberFormat $cell
-                    }
+                    $entry.style = Excel-CellStyle $range.Cells.Item($r, $c)
                 }
                 if ($detailed) { $cells.Add($entry) }
             }
@@ -2986,6 +3015,32 @@ function Invoke-WordOperation($doc, $op) {
             if ($rows -gt 1 -and $props.repeatHeader -ne $false) {
                 for ($row = 1; $row -le $headerRows; $row++) { try { $table.Rows.Item($row).HeadingFormat = $true } catch {} }
             }
+            # The last row is the total when totalRow is set: bold over a rule, as the portable writer draws it.
+            if ($props.totalRow -eq $true -and $rows -gt 1) {
+                $total = $table.Rows.Item($rows)
+                $total.Range.Font.Bold = -1
+                $rule = $total.Borders.Item(-1)   # wdBorderTop
+                $rule.LineStyle = 1
+                $rule.LineWidth = 8               # wdLineWidth100pt, the portable writer's w:sz 8
+                $rule.Color = Color-Value '374151'
+            }
+            # One row's own type (rowStyles[row]: fontSize, color, bold) over the table's, with the row's exact line
+            # pitch following its size: a stat strip's 22 pt figures over its 9 pt labels in one table.
+            if ($props.rowStyles) {
+                $rowStyles = @($props.rowStyles)
+                for ($row = 1; $row -le [Math]::Min($rows, $rowStyles.Count); $row++) {
+                    $style = $rowStyles[$row - 1]
+                    if ($null -eq $style) { continue }
+                    $rowRange = $table.Rows.Item($row).Range
+                    if ($style.fontSize) {
+                        $rowRange.Font.Size = [single]$style.fontSize
+                        $rowRange.ParagraphFormat.LineSpacingRule = 4
+                        $rowRange.ParagraphFormat.LineSpacing = [single]$style.fontSize * 1.3
+                    }
+                    if ($style.color) { $rowRange.Font.Color = Color-Value ([string]$style.color) }
+                    if ($null -ne $style.bold) { $rowRange.Font.Bold = $(if ($style.bold) { -1 } else { 0 }) }
+                }
+            }
             $added = [ordered]@{ op = 'add_table'; changed = $true; table = [int]$table.Index; rows = $rows; columns = $columns }
             if ($styleNotFound.Count) { $added.styleNotFound = $styleNotFound -join ', ' }
             return $added
@@ -3218,6 +3273,27 @@ function Invoke-WordOperation($doc, $op) {
             if ($props.color) { $normal.Font.Color = Color-Value ([string]$props.color) }
             return [ordered]@{ op = 'set_document_font'; changed = $true; name = [string]$normal.Font.Name; nameEastAsia = [string]$normal.Font.NameFarEast; size = [double]$normal.Font.Size }
         }
+        'define_styles' {
+            # Word's own styles defined once, as the portable writer patches styles.xml: built-in styles by their id
+            # (Word-StyleValue), so a Korean Word's "제목 1" is reached as "Heading 1".
+            if (-not $op.styles) { throw 'define_styles needs styles: { "<style name>": { fields } }' }
+            $defined = @()
+            $notFound = @()
+            foreach ($entry in $op.styles.PSObject.Properties) {
+                $style = $null
+                try { $style = $doc.Styles.Item((Word-StyleValue ([string]$entry.Name))) } catch { $style = $null }
+                if ($null -eq $style) { $notFound += [string]$entry.Name; continue }
+                $fields = $entry.Value
+                Set-WordRunFormat $style $fields
+                $format = $style.ParagraphFormat
+                if ($fields.alignment) { $format.Alignment = Word-ParagraphAlignment $fields.alignment }
+                Set-WordParagraphFlow $format $fields
+                $defined += [string]$entry.Name
+            }
+            $result = [ordered]@{ op = 'define_styles'; changed = $defined.Count -gt 0; styles = $defined }
+            if ($notFound.Count) { $result.styleNotFound = $notFound }
+            return $result
+        }
         'set_font' {
             $range = $doc.Content.Duplicate
             if (-not $op.find) { throw 'set_font requires non-empty find' }
@@ -3455,16 +3531,18 @@ function Invoke-WordOperation($doc, $op) {
                 if ($said) { $footer.Range.InsertParagraphAfter() }
                 $range = $footer.Range.Paragraphs.Last.Range
                 if ($said) { $null = $range.MoveEnd(1, -1) } else { $range = $footer.Range }
-                # The same treatment as the portable writer: the number alone, a prefix
-                # only when asked for, the total only with includeTotal:true.
+                # The same treatment as the portable writer: the number alone, a prefix only when asked for, and the
+                # total with includeTotal:true or a separator ("3 / 12"; includeTotal:false keeps the number alone).
                 $range.Text = $(if ($op.prefix) { ([string]$op.prefix) + ' ' } else { '' })
                 $range = $footer.Range
                 $range.Collapse(0)
                 $null = $footer.Range.Fields.Add($range, -1, 'PAGE', $true)
-                if ([bool]$op.includeTotal) {
+                $separatorText = ([string]$op.separator).Trim()
+                $includeTotal = ([bool]$op.includeTotal) -or ($op.includeTotal -ne $false -and $separatorText)
+                if ($includeTotal) {
                     $range = $footer.Range
                     $range.Collapse(0)
-                    $range.InsertAfter(' ' + $(if ($null -ne $op.separator) { [string]$op.separator } else { '/' }) + ' ')
+                    $range.InsertAfter(' ' + $(if ($separatorText) { $separatorText } else { '/' }) + ' ')
                     $range = $footer.Range
                     $range.Collapse(0)
                     $null = $footer.Range.Fields.Add($range, -1, 'NUMPAGES', $true)
@@ -4384,6 +4462,16 @@ function Apply-ExcelOperation($book, $op) {
                     } 'Excel chart series by rows'
                 }
             }
+            # Every text in the chart in the sheet's face, where Excel otherwise sets the workbook default. Set before the
+            # title's face: the chart area's font, set after it, put the title back in Excel's regular grey.
+            if ($op.fontName) {
+                try {
+                    $font = $chart.ChartArea.Format.TextFrame2.TextRange.Font
+                    $font.Name = [string]$op.fontName
+                    $font.NameFarEast = [string]$op.fontName
+                }
+                catch {}
+            }
             if ($op.title) {
                 $null = Invoke-ExcelComRetry {
                     $chart.HasTitle = $true
@@ -4496,6 +4584,34 @@ function Apply-ExcelOperation($book, $op) {
             else {
                 0
             }
+            # The quiet plot and the one lit bar, as the portable writer draws them: gridlines:false, valueAxis:false,
+            # highlight (a 0-based index or a category's text) in the series colour with the rest in mutedColor.
+            if ($op.gridlines -eq $false) { try { $chart.Axes(2, 1).HasMajorGridlines = $false } catch {} }
+            if ($op.valueAxis -eq $false) { try { $chart.Axes(2, 1).Delete() } catch {} }
+            if ($null -ne $op.highlight -and [string]$op.highlight -ne '' -and $seriesCount -eq 1 -and -not $slices) {
+                $series = $chart.SeriesCollection().Item(1)
+                $lit = -1
+                if ($op.highlight -is [ValueType]) { $lit = [int]$op.highlight }
+                else {
+                    $names = @(@($series.XValues) | ForEach-Object { [string]$_ })
+                    $lit = [Array]::IndexOf($names, [string]$op.highlight)
+                }
+                if ($lit -ge 0 -and $lit -lt $pointCount) {
+                    $accent = Color-Value $(if ($palette.Count) { [string]$palette[0] } else { '2F6DB5' })
+                    $muted = Color-Value $(if ($op.mutedColor) { [string]$op.mutedColor } else { 'C9CED6' })
+                    for ($pointIndex = 1; $pointIndex -le $pointCount; $pointIndex++) {
+                        try {
+                            $point = $series.Points($pointIndex)
+                            $pointColor = $(if ($pointIndex -eq $lit + 1) { $accent } else { $muted })
+                            $point.Format.Fill.Solid()
+                            $point.Format.Fill.ForeColor.RGB = $pointColor
+                            # The series' outline was set in the accent; a receded bar keeps no accent edge.
+                            $point.Format.Line.ForeColor.RGB = $pointColor
+                        }
+                        catch {}
+                    }
+                }
+            }
             $chartResultValue = [ordered]@{ op = 'add_chart'; changed = $true; name = [string]$shape.Name; series = $seriesCount; categories = $pointCount }
             if ($pageFit) { $chartResultValue.pageFit = $pageFit }
             return $chartResultValue

package/src/runtime/office/core/office-actions-batch.mjs

@@ -13,7 +13,13 @@ import { applyPdfBatch } from '../pdf/pdf-adapter.mjs';
 import { createChartPdf } from '../pdf/pdf-writer.mjs';
 import { renderPdfPages } from '../pdf/pdf-render.mjs';
 import { assertOfficeOperationContracts } from '../capabilities.mjs';
-import { quoteUnquotedSheetReferences, validateXlsxOperations } from '../portable/xlsx-contract.mjs';
+import {
+  expandFilledFormulas,
+  quoteUnquotedSheetReferences,
+  validateXlsxOperations,
+} from '../portable/xlsx-contract.mjs';
+import { translateSharedFormula } from '../portable/xlsx-formula-engine.mjs';
+import { documentBrief } from '../quality/document-brief.mjs';
 import { applyTabularBatch } from './tabular.mjs';
 import { expandOfficeDesignOperations } from '../design/design-system.mjs';
 import { createPptxSlideSelection } from '../design/library/design-library.mjs';
@@ -433,6 +439,12 @@ async function prepareBatchOperations(session, args) {
   session.designRequest = designRequest;
   session.design = prepared.design;
   session.designState ||= emptyOfficeDesignState();
+  // A Word document or workbook written to a brief (design.brief, the deck's key: value lines) is held to it as an
+  // authored deck is: its figures against the facts, and a scored page review at finalize.
+  if (['docx', 'xlsx'].includes(session.format) && typeof args.design?.brief === 'string') {
+    const brief = documentBrief(args.design.brief);
+    if (brief) session.authoredBrief = brief;
+  }
   const baseDir = args.__cwd || dirname(session.target);
   let operations = Array.isArray(prepared.operations)
     ? prepared.operations.map((operation) => localizeOperation(operation, baseDir))
@@ -454,6 +466,9 @@ async function prepareBatchOperations(session, args) {
   operations = await withImportedSlideBackgrounds(session, operations);
   prepared.scratch = [];
   operations = await withDocumentCharts(session, operations, prepared.scratch);
+  // set_formula over a range is written cell by cell, each formula moved as Excel's fill moves it, before either
+  // backend sees it: both then write cells they already write.
+  if (session.format === 'xlsx') operations = expandFilledFormulas(operations, translateSharedFormula);
   if (session.format === 'xlsx' || TABULAR_FORMATS.has(session.format)) validateXlsxOperations(operations);
   // Excel rejects `My Sheet!A1` outright; the portable writer quotes it from
   // the sheet list, and an Excel session gets the same courtesy here.

package/src/runtime/office/core/office-actions-inspect.mjs

@@ -55,7 +55,8 @@ async function structureIssues(session, args) {
     if (!read?.document) return [];
     return reviewOfficeStructure({
       format: session.format,
-      document: read.document,
+      // A PDF's designed sheets are held to the print type floors (assurance-structure-pptx typeFloors).
+      document: session.printSheet ? { ...read.document, printSheet: true } : read.document,
       auditProfile: args.auditProfile,
     });
   } catch {
@@ -292,7 +293,7 @@ async function microsoftOfficeIssues(session, args) {
 function portableIssues(session, args) {
   if (session.format === 'pdf') return issuesPdf(session.target, args);
   if (TABULAR_FORMATS.has(session.format)) return issuesTabular(session.target, session.format, args);
-  return issuesPortableOoxml(session.target, session.format, args);
+  return issuesPortableOoxml(session.target, session.format, session.printSheet ? { ...args, printSheet: true } : args);
 }
 
 export async function issues(session, args = {}) {

package/src/runtime/office/core/office-actions-lifecycle.mjs

@@ -2,7 +2,7 @@
 // recalculate → review → hold checks → save → validate → close (see
 // office-finalize/*.mjs for each stage).
 import { recalculateForReview } from './office-recalculation.mjs';
-import { reviewForFinalize } from './office-finalize/review-stage.mjs';
+import { briefedDocument, reviewForFinalize } from './office-finalize/review-stage.mjs';
 import { finalizeHold, reviewHold } from './office-finalize/holds.mjs';
 import { closeForFinalize, saveForFinalize, validateForFinalize } from './office-finalize/commit-stage.mjs';
 
@@ -29,7 +29,11 @@ export async function finalize(session, args, cwd, signal) {
     session,
     failOn,
     stepMetrics,
-    requiresVisualReview: session.format === 'pptx' && session.designState?.requiresVisualReview === true,
+    // A PDF of designed pages is the author's deck on paper and owes the deck's critique.
+    requiresVisualReview:
+      session.authoredFrame === true ||
+      briefedDocument(session) ||
+      (session.format === 'pptx' && session.designState?.requiresVisualReview === true),
     recalculation: await timedStep('recalculation', () => recalculateForReview(session, signal)),
   };
   const { recalculation } = context;

package/src/runtime/office/core/office-actions-render.mjs

@@ -40,6 +40,8 @@ export async function qa(session, args, cwd, { reuseRender = false } = {}) {
         format: session.format,
         pageRoles: design.pageRoles,
         smallWorksheet: session.format === 'xlsx' && isSmallWorksheetDocument(design.currentSnapshot?.document),
+        pageCount: preview.pageCount,
+        designedPages: session.authoredFrame === true,
       });
   const trust = design.currentSnapshot?.trust || session.trustReview || null;
   const { review, combinedIssuesAfter } = assembleQaReview({
@@ -92,5 +94,6 @@ export async function qa(session, args, cwd, { reuseRender = false } = {}) {
 export async function render(session, args, cwd) {
   await recalculateForReview(session, session.activeSignal || null);
   const preview = await renderOfficePreview(session, args, cwd);
-  return session.format === 'pptx' ? pptxReviewArtifacts(session, preview) : preview;
+  // A PDF of designed pages is reviewed as the deck it was measured as: receipt and contact sheet.
+  return session.format === 'pptx' || session.authoredFrame === true ? pptxReviewArtifacts(session, preview) : preview;
 }