@quario/csv 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-09-01
+
+### Added
+
+- **A split is one record, its slots the fields.** Slots are values beside
+  each other, which is what a record is. Slot widths go unread, as every width
+  is here. Images stay unread too, but a slot holding one still writes an
+  empty field, so the fields either side keep their positions.
+
+### Changed
+
+- **Display-text `Date`s join as ISO 8601 UTC.** A `Date` inside a mixed
+  cell (literal text plus interpolation) joined through `String(date)`, so
+  the field carried the host's timezone and locale. It now joins through the
+  engine's shared display rule as `toISOString()` text — the same form a
+  typed single-`Date` field has always used, so every `Date` in a CSV now
+  reads the same way.
+
 ## [0.1.0] - 2026-08-27
 
 ### Added

package/lib/index.js

@@ -7,7 +7,7 @@
  * then RFC 4180 quoting. Styles, widths, page bands, and images go unread.
  * The unlicensed marking is a trailing line, so record 1 stays the report's.
  */
-import { text, typed, walk } from "quario";
+import { display, text, typed, walk } from "quario";
 
 /** Formula guard, then RFC 4180 quoting. Typed fields skip this.
  *  @type {(s: string) => string} */
@@ -19,8 +19,9 @@ let format = (s) => {
 /** @type {(cell: { tokens: any[] }) => string} */
 let field = (cell) => {
   let value = typed(cell.tokens);
+  // The typed branch only skips the formula guard; display() owns the text.
   if (value === undefined) return format(text(cell.tokens));
-  return value instanceof Date ? value.toISOString() : String(value);
+  return display(value);
 };
 
 /**
@@ -39,6 +40,12 @@ export function csv() {
       let out = "";
       /** @type {string | undefined} */
       let marking;
+      // The fields of the split being filled, if any. A split is one record of
+      // its own -- the slots are values beside each other, which is what a
+      // record is -- so its items are collected here instead of each taking a
+      // record. Splits never nest, so one buffer is enough.
+      /** @type {string[] | null} */
+      let split = null;
       let record = (/** @type {any} */ event) => {
         out += event.cells.map(field).join(",") + "\n";
       };
@@ -47,7 +54,23 @@ export function csv() {
           if (event.marking) marking = event.marking;
         },
         item: (event) => {
-          out += field(event) + "\n";
+          if (split) split.push(field(event));
+          else out += field(event) + "\n";
+        },
+        // Images go unread by this target, but a slot holding one still holds
+        // its place in the record, so the fields either side of it stay in
+        // their columns.
+        image: () => {
+          if (split) split.push("");
+        },
+        "split-start": () => {
+          split = [];
+        },
+        "split-end": () => {
+          // The engine emits the bracket as one array, so a `split-end` always
+          // has its opening and `split` is never null here.
+          out += /** @type {string[]} */ (split).join(",") + "\n";
+          split = null;
         },
         "table-start": (event) => {
           out +=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quario/csv",
-  "version": "0.1.0",
+  "version": "0.2.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.1.0",
+    "quario": "^0.2.0",
     "size-limit": "^13.0.3",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {
-    "quario": "^0.1.0"
+    "quario": "^0.2.0"
   },
   "size-limit": [
     {