@aiquants/spreadsheet 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `@aiquants/spreadsheet` are documented here.
 
+## 0.15.0 (2026-10-26)
+
+グリッドがコピーと貼り付けに使う TSV の符号化を、グリッドを読み込まない副パス `@aiquants/spreadsheet/tsv` として公開する。
+barrel も同じ関数を公開し続けるので、既存の import と描画・操作の動作は変わらない。
+
+- **新機能 — `@aiquants/spreadsheet/tsv`**: `parseTsv` と `serializeTsv` (barrel と同じ関数で、定義は 1 つ) を、React も
+  `@aiquants/virtualscroll` も読まない入口から公開する (約 1 KB)。グリッドを遅延で読み込むホストが、最初の描画の時点で表の文字を
+  読める (サーバーで描く代わりの表と、それと同じクライアントの最初の描画)。barrel から `parseTsv` だけを読むと、束ねる道具は
+  グリッドの大半を落とせない (約 260 KB と React・virtualscroll の import が残る) ため、別の入口にした。
+- **ビルド**: 入口は `index`・`view`・`tsv` の 3 つ。符号化のモジュールは `index` と `tsv` が共有する塊 (`tsv-<hash>.js` /
+  `.cjs`) に入り、どちらもそれを読む。
+- **peer**: `@aiquants/virtualscroll` の peer の範囲は `^3.22.0` のまま (0.14.0 と同じ)。
+- **検証 — 走行台帳 (census の錨は本未リリース節)**: 単体 / 統合 **94 ファイル 4,097 テスト** 全緑 —
+  0.14.0 出荷時の 93 ファイル 4,094 に v0.15 進行分 +3 (新規 `tsvEntry` 2、0.14.0 節の出荷時凍結ピンで `hxCensus` +1)。
+  barrel (`src/index.ts`) の export は変わらない。`tsc --noEmit` / biome 0。
+
 ## 0.14.0 (2026-10-26)
 
 グリッドの固定の寸法と拡大率の規則を、グリッドを読み込まない副パス `@aiquants/spreadsheet/view` として公開する。グリッド自身も

package/README.md

@@ -844,9 +844,28 @@ const zoomIn = () => setZoom((zoom) => clampSpreadsheetZoom(stepSpreadsheetZoom(
 // <Spreadsheet zoom={zoom} onZoomChange={setZoom} … />
 ```
 
+## TSV codec (`@aiquants/spreadsheet/tsv`)
+
+`@aiquants/spreadsheet/tsv` publishes `parseTsv` and `serializeTsv` — the codec the grid copies and pastes with — without
+loading the grid (no React, no `@aiquants/virtualscroll`; about 1 KB). A host that lazily imports the grid can still read
+the grid's text during the first render, for example to server-render a placeholder table of the rows the grid will show
+(the same markup on the client, so hydration matches). The barrel exports the same two functions (one definition), so
+code that already loads the grid keeps importing them from `@aiquants/spreadsheet`.
+
+| Export | Contract |
+| :--- | :--- |
+| `parseTsv(text)` | A rectangular `string[][]`: one trailing line terminator dropped, empty text read as one empty cell (`[[""]]`), ragged rows padded with `""`; a quoted field is unquoted only when its content holds a tab or a line break (a value merely wrapped in quotes is literal text, as Excel writes it) |
+| `serializeTsv(matrix)` | Rows joined with CRLF and a trailing CRLF; only a field with a tab or a line break is quoted (its quotes doubled) — every other field, quotes included, is written verbatim (Excel's behaviour) |
+
+```tsx
+import { parseTsv } from "@aiquants/spreadsheet/tsv"
+
+const rows = parseTsv(text) // ready before `import("@aiquants/spreadsheet")` resolves
+```
+
 ## Clipboard utilities (public)
 
-`parseTsv` / `serializeTsv` / `estimatePasteCellCount` / `expandPaste` are exported for building custom paste UIs and
+`parseTsv` / `serializeTsv` (also at `@aiquants/spreadsheet/tsv`) / `estimatePasteCellCount` / `expandPaste` are exported for building custom paste UIs and
 importers with the exact same Excel-compatible semantics the grid uses. `enumerateRangeCells`, `makeRange`,
 `rangeContains`, `rangeSize`, `columnIndexToName`, `columnNameToIndex` round out the toolkit. The named unions
 `SpreadsheetDirection` (`"up" | "down" | "left" | "right"` — the `findDataEdge` direction), `SpreadsheetOperation` (the