@quario/csv 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-09-07
+
+### Changed
+
+- Requires quario ^0.6.0
+
+## [0.5.0] - 2026-09-05
+
+### Added
+
+- **Spans keep the record rectangular.** A cell covering several columns writes
+  its value in the first field it covers and leaves the rest empty, so every
+  record is the same width. This target reads no geometry, so there is nothing
+  here for a merge to mean.
+
 ## [0.4.0] - 2026-09-03
 
 ### Changed

package/README.md

@@ -82,12 +82,13 @@ blocks the host. Render-time failures reject with located errors.
 
 The banded walk flattened as records in render order: report-header items, then per group
 instance its header items, nested content, and footer items, then the table's header record,
-data records, and total record, then report-footer items. Grouping exists as that order
+data records, and total records, then report-footer items. Grouping exists as that order
 alone. Group boundaries add no records of their own, and `break: "page"` and `reset: "page"`
 are ignored. This target is unpaginated: `report-start.page` band closures are ignored.
 
-Each item takes one record with one field. A report that is one table and no other bands has
-its column headers as record 1; any other band makes the file ragged.
+Each item takes one record with one field; a split takes one record with a field per slot, and a
+spanning cell writes empty fields for the columns it covers so positions hold. A report that is one
+table and no other bands has its column headers as record 1; any other band makes the file ragged.
 
 ### Typed fields
 
@@ -105,8 +106,8 @@ A hidden cell keeps its column slot as an empty field.
 
 ### Unread
 
-`style`, column `width`, page columns, page bands, and images: nothing looks at them. An
-image emits no record.
+`style`, column `width`, slot `width`, page columns, page bands, and images: nothing looks at
+them. An image emits no record, though an image in a slot still writes its empty field.
 
 ### Text shape
 

package/lib/index.js

@@ -46,8 +46,23 @@ export function csv() {
       // record. Splits never nest, so one buffer is enough.
       /** @type {string[] | null} */
       let split = null;
+      // A record is rectangular, always: a cell covering several columns puts
+      // its value in the first field it covers and leaves the rest empty
+      // (docs/adr/0047). This target reads no styles and has no geometry to
+      // honour, so a merge is not a thing it could mean. Data rows carry no
+      // spans, so for them this is `map(field)`.
+      /** @type {(cells: any[]) => string[]} */
+      let spread = (cells) => {
+        /** @type {string[]} */
+        let fields = [];
+        for (let cell of cells) {
+          fields.push(field(cell));
+          for (let covered = 1; covered < (cell.span || 1); covered++) fields.push("");
+        }
+        return fields;
+      };
       let record = (/** @type {any} */ event) => {
-        out += event.cells.map(field).join(",") + "\n";
+        out += spread(event.cells).join(",") + "\n";
       };
       await walk(stream(data), {
         "report-start": (event) => {
@@ -73,8 +88,7 @@ export function csv() {
           split = null;
         },
         "table-start": (event) => {
-          out +=
-            event.columns.map((/** @type {any} */ column) => field(column.header)).join(",") + "\n";
+          out += spread(event.header.cells).join(",") + "\n";
         },
         row: record,
         "total-row": record,

package/package.json

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