@quario/xlsx 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-09-07
+
+### Added
+
+- **Styled runs become rich text.** A cell of more than one styled run is written
+  as rich text, each run's font merged over the cell's — so bold, italic,
+  underline, strikethrough, size, face and colour survive into the grid. A
+  run-level `background` is not read: a spreadsheet's rich-text runs carry fonts
+  only, and filling the cell would colour text nobody asked to colour. A cell of
+  exactly one run stays a typed cell, so a single styled amount is still a
+  number.
+
+- **A run inside a sentence presents its value.** A run holding one
+  interpolation under a `format` shows the same decimals here as on the page,
+  where a mixed cell used to show the bare value.
+
 ## [0.6.0] - 2026-09-07
 
 ### Added

package/README.md

@@ -79,7 +79,7 @@ as that order alone. Group boundaries add no rows of their own, and `break: "pag
 `reset: "page"` are ignored, as are `page.margin` and a report header's `height`.
 
 Each item takes one row with its cell in the first column, unmerged; a split takes one row with its
-slots as the cells across it (slot widths unread, a slot rendering nothing an empty cell), and a
+slots as the cells across it (slot widths withdrawn, a slot rendering nothing an empty cell), and a
 spanning header or total cell is a merged range. Two band roles carry an
 omakase default that the author's own style always overrides: report-header items render bold at
 size 14, group-header items render bold.
@@ -109,8 +109,8 @@ on the wrong type, or a code the engine cannot read, writes no format.
 ### Images
 
 An image item is not a cell: it takes one worksheet row as its anchor and floats over the sheet as a
-drawing at its natural pixel size. Placement here is best-effort. `fit`, `alt`, and `style` go
-unread, and all of it may change without a breaking change. Bytes too short to carry a size reject
+drawing at its natural pixel size. Placement here is best-effort. `fit`, `alt`, and `style` are
+unused, and all of it may change without a breaking change. Bytes too short to carry a size reject
 the render rather than vanish.
 
 ### Styles
@@ -136,14 +136,14 @@ The first table's header row anchors the frozen view. Everything from that row u
 while the body scrolls, the spreadsheet analogue of the PDF target's repeated headers. A report
 without a table freezes nothing. This is normative.
 
-### Widths are not read
+### Widths are withdrawn
 
 Column `width` percentages size nothing here, and every worksheet column keeps the application
 default. A width is a share of the _table_ width, and a worksheet's columns are global to the sheet.
 Column A carries the flattened band item rows and the table's first column alike, so there is no
 table for a share to be a share of.
 
-### Page columns are not read
+### Page columns are withdrawn
 
 A page column count sizes and splits nothing here, and will not change, as `break: "page"` is
 ignored. Page columns are strips of a page, and this target has no page to strip.

package/lib/cell.js

@@ -2,12 +2,13 @@
  * From an event cell to a plain cell descriptor `{ value, format }`, built on
  * the engine's `typed` stream rule. `value` is a native number, boolean, or
  * Date when the cell is one bare interpolation (so numbers stay computable in
- * the sheet), and the display-text join otherwise. `format` is the resolved
- * cell-level formatting from the style module. Display text that contains a
- * newline gains `wrapText` so the break is visible in the grid.
+ * the sheet), the worksheet's rich-text shape when the cell holds more than
+ * one styled run, and the display-text join otherwise. `format` is the
+ * resolved cell-level formatting from the style module. Display text that
+ * contains a newline gains `wrapText` so the break is visible in the grid.
  */
-import { currencyOf, text, typed } from "quario";
-import { format as look, merge } from "./style.js";
+import { currencyOf, display, format as present, styledRuns, text, typed } from "quario";
+import { font, format as look, merge } from "./style.js";
 
 // The digit count is the engine's, never this target's: it rides on the
 // resolved declaration the stream carries, the same one HTML and PDF
@@ -87,14 +88,62 @@ let paintWrap = (out, shown) => {
     out.alignment = { ...out.alignment, wrapText: true };
 };
 
+// One run's presented text: literals verbatim, every value through the
+// declaration that run resolved. A run holding a single value token presents
+// it, so a formatted amount inside a sentence reads the same here as it does
+// on the page -- SCHEMA.md pins that the fraction digits are the same in every
+// target that presents, and this target presents (ADR 0061). A run the engine
+// withdrew the declaration from has nothing to present with and falls to
+// display text, which is what the whole cell used to do.
+/** @type {(tokens: any[], style: any, intl: any) => string} */
+let shownText = (tokens, style, intl) => {
+  let out = "";
+  for (let token of tokens)
+    out +=
+      "literal" in token
+        ? token.literal
+        : (present(token.value, style, intl) ?? display(token.value));
+  return out;
+};
+
+// A cell of more than one styled run takes the worksheet's rich-text shape:
+// each run's **font half** merged over the cell font, and nothing else. A
+// run-level `background` is inert -- spreadsheet rich-text runs carry fonts
+// only, and filling the cell would colour text the author did not name -- and
+// so is a run-level number format, since a cell has one and this cell is text.
+// No typed cell is lost: a cell of more than one run holds more than one token
+// and was display text already.
+/** @type {(cell: any, styled: any[], under: any, intl: any) => any} */
+let rich = (cell, styled, under, intl) => {
+  let base = merge(under, cell.style);
+  let out = look(base);
+  let parts = styled.map((one) => {
+    let style = one.style ? merge(base, one.style) : base;
+    return { font: font(style), text: shownText(one.tokens, style, intl) };
+  });
+  paintWrap(out, parts.map((part) => part.text).join(""));
+  return { value: { richText: parts }, format: out };
+};
+
+// The style a cell of one styled run wears: that run's resolved answer, which
+// already carries the cell's own declarations, or the cell's where it has no
+// run at all.
+/** @type {(cell: any, styled: any[]) => any} */
+let soleStyle = (cell, styled) => styled[0]?.style ?? cell.style;
+
 /**
  * Resolve one event cell against its enclosing style (a row's style, or an
  * item's band-role default — the layer under the cell's own).
  *
+ * A cell of exactly one styled run wears that run's answer whole, so a single
+ * styled amount is still a number in the grid.
+ *
  * @type {(cell: { tokens: any[], style?: any }, under: any, intl?: any) => { value: any, format: any }}
  */
 let field = (cell, under, intl) => {
-  let resolved = merge(under, cell.style);
+  let styled = styledRuns(cell.tokens);
+  if (styled.length > 1) return rich(cell, styled, under, intl);
+  let resolved = merge(under, soleStyle(cell, styled));
   let shown = shownOf(cell, resolved?.format);
   let out = look(resolved);
   paintFmt(out, resolved, shown, intl);

package/lib/index.js

@@ -27,17 +27,19 @@ import { append, create, embed, freeze, mark, place, save, sheet, span } from ".
 
 // Band-role omakase defaults, applied under the author's own style so a
 // declared style always wins. Only the headline roles carry one; every other
-// band writes plain cells. The PDF target carries the same two, byte-identical,
-// in its own `style.js` — SCHEMA.md states the pair for both, so they move
-// together, and a target imports only public engine helpers so there is nowhere
-// to share them from.
+// band writes plain cells. SCHEMA.md states the pair, and a target imports only
+// public engine helpers so there is nowhere to share them from.
 //
 // `@quario/html` deliberately carries none of them: its consumer has a
 // stylesheet and the `q-*` classes are the seam, where a worksheet has neither.
 // The rule is docs/adr/0014-a-target-supplies-defaults-only-where-its-consumer-has-no-seam.md —
 // a target supplies defaults only where its consumer has no seam to supply
-// them. `@quario/html/style.css` and `packages/viewer/lib/style.js` supply them for
-// that target; keep all four in agreement.
+// them.
+//
+// `test/omakase-defaults.test.js` is what holds the copies in agreement. This
+// comment names the gate rather than listing the files, because the list is
+// what rotted: it used to name `packages/viewer/lib/style.js` and a `style.js`
+// of the PDF target's own, and neither file exists.
 /** @type {Record<string, any>} */
 let ROLES = {
   "report-header": { bold: true, size: 14 },

package/lib/style.js

@@ -138,4 +138,4 @@ let format = (style) => {
   return put(out, "alignment", alignment(style));
 };
 
-export { format, merge };
+export { font, format, merge };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quario/xlsx",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "The spreadsheet render target for quario — in the makings, not yet released",
   "homepage": "https://getquario.com",
   "license": "SEE LICENSE IN LICENSE",
@@ -42,12 +42,12 @@
     "@arethetypeswrong/cli": "^0.18.3",
     "@size-limit/preset-small-lib": "^13.0.3",
     "@types/node": "^22.20.1",
-    "quario": "^0.6.0",
+    "quario": "^0.7.0",
     "size-limit": "^13.0.3",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {
-    "quario": "^0.6.0"
+    "quario": "^0.7.0"
   },
   "size-limit": [
     {