@aiquants/spreadsheet 0.16.0 → 0.16.1

package/dist/index.d.cts

@@ -670,6 +670,22 @@ export declare type HtmlTableResult = {
     readonly outcome: "none";
 };
 
+/**
+ * Yields the rows of a text that may be only the beginning of a TSV (a file read partway, a stream not yet ended), in
+ * exactly iterateTsvRows's grammar, but only those the rest of the text cannot change: every row the text ends with a
+ * line terminator, up to the first field that opens a quote the text does not close (whether it is one quoted field or a
+ * literal one split at its line breaks is the rest's to decide). So the rows of any beginning of a TSV are the first
+ * rows of the whole: a reader of a stream can show them as final. Empty text yields no row. Unpadded.
+ * TSV の先頭だけかもしれない文字 (途中まで読んだファイル、まだ終わらないストリーム) の行を、iterateTsvRows とちょうど同じ文法で、
+ * ただし文字の続きが変えられない行だけ出す処理。文字が改行で終える行すべてを、文字が閉じない引用を開く最初の値まで出す (それが 1 つの
+ * 引用の値か、改行で割れる文字どおりの値かは続きが決める)。そのため TSV のどの先頭の行も全体の最初の行で、ストリームの読み手は
+ * それを確定したものとして見せられる。空の文字は行を出さない。埋めない。
+ *
+ * @param text - The beginning of a TSV text, as read. 読んだままの TSV の文字の先頭。
+ * @returns The rows the rest of the text cannot change, unpadded. 文字の続きが変えられない行 (埋めない)。
+ */
+export declare function iterateTsvPrefixRows(text: string): Generator<string[]>;
+
 /**
  * Yields the rows of a TSV text one at a time, in exactly parseTsv's grammar (the same quoting rule, line terminators
  * and final-terminator handling; empty text is one row with one empty cell), WITHOUT padding them to a common width. A

package/dist/index.d.ts

@@ -670,6 +670,22 @@ export declare type HtmlTableResult = {
     readonly outcome: "none";
 };
 
+/**
+ * Yields the rows of a text that may be only the beginning of a TSV (a file read partway, a stream not yet ended), in
+ * exactly iterateTsvRows's grammar, but only those the rest of the text cannot change: every row the text ends with a
+ * line terminator, up to the first field that opens a quote the text does not close (whether it is one quoted field or a
+ * literal one split at its line breaks is the rest's to decide). So the rows of any beginning of a TSV are the first
+ * rows of the whole: a reader of a stream can show them as final. Empty text yields no row. Unpadded.
+ * TSV の先頭だけかもしれない文字 (途中まで読んだファイル、まだ終わらないストリーム) の行を、iterateTsvRows とちょうど同じ文法で、
+ * ただし文字の続きが変えられない行だけ出す処理。文字が改行で終える行すべてを、文字が閉じない引用を開く最初の値まで出す (それが 1 つの
+ * 引用の値か、改行で割れる文字どおりの値かは続きが決める)。そのため TSV のどの先頭の行も全体の最初の行で、ストリームの読み手は
+ * それを確定したものとして見せられる。空の文字は行を出さない。埋めない。
+ *
+ * @param text - The beginning of a TSV text, as read. 読んだままの TSV の文字の先頭。
+ * @returns The rows the rest of the text cannot change, unpadded. 文字の続きが変えられない行 (埋めない)。
+ */
+export declare function iterateTsvPrefixRows(text: string): Generator<string[]>;
+
 /**
  * Yields the rows of a TSV text one at a time, in exactly parseTsv's grammar (the same quoting rule, line terminators
  * and final-terminator handling; empty text is one row with one empty cell), WITHOUT padding them to a common width. A

package/dist/index.js

@@ -1,7 +1,7 @@
 import { serializeClipboardTsv as hu, measureTsv as gu, parseTsv as mu } from "./tsv.js";
-import { iterateTsvRows as r0, serializeTsv as o0 } from "./tsv.js";
+import { iterateTsvPrefixRows as r0, iterateTsvRows as o0, serializeTsv as s0 } from "./tsv.js";
 import { S as be, c as Wr, a as Fo, b as wu, d as yu, s as No } from "./view-DycJZi_t.js";
-import { e as i0 } from "./view-DycJZi_t.js";
+import { e as l0 } from "./view-DycJZi_t.js";
 import { VIRTUAL_SCROLL_LABEL_CATALOGS as Ai, resolveVirtualScrollLocale as Ul, VIRTUAL_SCROLL_LABEL_KEYS as oo, resolveVirtualScrollLabels as vu, useWheelBridge as ms, FenwickMapTree as Cu, VirtualGrid as bu } from "@aiquants/virtualscroll";
 import { jsxs as Mt, jsx as J, Fragment as Xl } from "react/jsx-runtime";
 import { useRef as R, useCallback as S, useMemo as zt, useLayoutEffect as Jt, useEffect as Ht, useState as se, useId as jn, memo as Gl, useSyncExternalStore as so, forwardRef as Ru, useImperativeHandle as Su } from "react";
@@ -8409,7 +8409,7 @@ export {
   t0 as Spreadsheet,
   De as canonicalizeFormat,
   Wr as columnIndexToName,
-  i0 as columnNameToIndex,
+  l0 as columnNameToIndex,
   Ed as detectClipSource,
   pn as enumerateRangeCells,
   Jw as estimatePasteCellCount,
@@ -8417,7 +8417,8 @@ export {
   gr as formatCellValue,
   Gw as formatEquals,
   co as fromR1C1,
-  r0 as iterateTsvRows,
+  r0 as iterateTsvPrefixRows,
+  o0 as iterateTsvRows,
   vt as makeRange,
   gu as measureTsv,
   nc as mergeFormat,
@@ -8433,7 +8434,7 @@ export {
   ud as serializeClipPayload,
   hu as serializeClipboardTsv,
   Dp as serializeHtmlTable,
-  o0 as serializeTsv,
+  s0 as serializeTsv,
   kf as shiftFormula,
   xs as toR1C1,
   ug as validateCellText

package/dist/tsv.cjs

@@ -1,8 +1,8 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=(e,t)=>`${e.map(n=>n.map(t).join("	")).join(`\r
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=(e,n)=>`${e.map(t=>t.map(n).join("	")).join(`\r
 `)}\r
-`,f=e=>o(e,v),h=e=>o(e,T),v=e=>/[\t\r\n]/.test(e)||e.startsWith('"')?`"${e.replaceAll('"','""')}"`:e,T=e=>/[\t\r\n]/.test(e)?`"${e.replaceAll('"','""')}"`:e,c=e=>e.endsWith(`\r
+`,p=e=>c(e,w),v=e=>c(e,m),w=e=>/[\t\r\n]/.test(e)||e.startsWith('"')?`"${e.replaceAll('"','""')}"`:e,m=e=>/[\t\r\n]/.test(e)?`"${e.replaceAll('"','""')}"`:e,a=e=>e.endsWith(`\r
 `)?e.slice(0,-2):e.endsWith(`
-`)||e.endsWith("\r")?e.slice(0,-1):e,l=Symbol("row end");function*a(e){let t=0;for(;;){const n=e[t]==='"'?m(e,t):null;if(n!==null)yield n.value,t=n.nextIndex;else{const s=w(e,t);yield e.slice(t,s),t=s}if(t>=e.length){yield l;return}e[t]==="	"?t+=1:(t+=e[t]==="\r"&&e[t+1]===`
-`?2:1,yield l)}}function*u(e){const t=c(e);if(t===""){yield[""];return}let n=[];for(const s of a(t))s===l?(yield n,n=[]):n.push(s)}const p=e=>{const t=Array.from(u(e));let n=0;for(const s of t)s.length>n&&(n=s.length);return t.map(s=>s.length===n?s:[...s,...Array(n-s.length).fill("")])},g=e=>{const t=c(e);if(t==="")return{rows:1,cols:1};let n=0,s=0,r=0;for(const i of a(t))i===l?(n+=1,r>s&&(s=r),r=0):r+=1;return{rows:n,cols:s}},m=(e,t)=>{let n="",s=t+1;for(;s<e.length;)if(e[s]==='"')if(e[s+1]==='"')n+='"',s+=2;else{const r=s+1;return(r>=e.length||e[r]==="	"||e[r]===`
-`||e[r]==="\r")&&/[\t\r\n"]/.test(n)?{value:n,nextIndex:r}:null}else n+=e[s],s+=1;return null},w=(e,t)=>{for(let n=t;n<e.length;n+=1)if(e[n]==="	"||e[n]===`
-`||e[n]==="\r")return n;return e.length};exports.iterateTsvRows=u;exports.measureTsv=g;exports.parseTsv=p;exports.serializeClipboardTsv=h;exports.serializeTsv=f;
+`)||e.endsWith("\r")?e.slice(0,-1):e,l=Symbol("row end");function*o(e,n){let t=0;for(;;){const s=e[t]==='"'?R(e,t):T;if(s===h&&n==="prefix")return;if(typeof s=="object")yield s.value,t=s.nextIndex;else{const r=j(e,t);yield e.slice(t,r),t=r}if(t>=e.length){n==="whole"&&(yield l);return}e[t]==="	"?t+=1:(t+=e[t]==="\r"&&e[t+1]===`
+`?2:1,yield l)}}function*u(e){const n=a(e);if(n===""){yield[""];return}yield*f(o(n,"whole"))}function*d(e){yield*f(o(e,"prefix"))}function*f(e){let n=[];for(const t of e)t===l?(yield n,n=[]):n.push(t)}const g=e=>{const n=Array.from(u(e));let t=0;for(const s of n)s.length>t&&(t=s.length);return n.map(s=>s.length===t?s:[...s,...Array(t-s.length).fill("")])},O=e=>{const n=a(e);if(n==="")return{rows:1,cols:1};let t=0,s=0,r=0;for(const i of o(n,"whole"))i===l?(t+=1,r>s&&(s=r),r=0):r+=1;return{rows:t,cols:s}},T=Symbol("literal field"),h=Symbol("open quote"),R=(e,n)=>{let t="",s=n+1;for(;;){const r=e.indexOf('"',s);if(r<0)return h;if(t+=e.slice(s,r),e[r+1]==='"'){t+='"',s=r+2;continue}const i=r+1;return(i>=e.length||e[i]==="	"||e[i]===`
+`||e[i]==="\r")&&/[\t\r\n"]/.test(t)?{value:t,nextIndex:i}:T}},j=(e,n)=>{for(let t=n;t<e.length;t+=1)if(e[t]==="	"||e[t]===`
+`||e[t]==="\r")return t;return e.length};exports.iterateTsvPrefixRows=d;exports.iterateTsvRows=u;exports.measureTsv=O;exports.parseTsv=g;exports.serializeClipboardTsv=v;exports.serializeTsv=p;

package/dist/tsv.d.cts

@@ -1,3 +1,19 @@
+/**
+ * Yields the rows of a text that may be only the beginning of a TSV (a file read partway, a stream not yet ended), in
+ * exactly iterateTsvRows's grammar, but only those the rest of the text cannot change: every row the text ends with a
+ * line terminator, up to the first field that opens a quote the text does not close (whether it is one quoted field or a
+ * literal one split at its line breaks is the rest's to decide). So the rows of any beginning of a TSV are the first
+ * rows of the whole: a reader of a stream can show them as final. Empty text yields no row. Unpadded.
+ * TSV の先頭だけかもしれない文字 (途中まで読んだファイル、まだ終わらないストリーム) の行を、iterateTsvRows とちょうど同じ文法で、
+ * ただし文字の続きが変えられない行だけ出す処理。文字が改行で終える行すべてを、文字が閉じない引用を開く最初の値まで出す (それが 1 つの
+ * 引用の値か、改行で割れる文字どおりの値かは続きが決める)。そのため TSV のどの先頭の行も全体の最初の行で、ストリームの読み手は
+ * それを確定したものとして見せられる。空の文字は行を出さない。埋めない。
+ *
+ * @param text - The beginning of a TSV text, as read. 読んだままの TSV の文字の先頭。
+ * @returns The rows the rest of the text cannot change, unpadded. 文字の続きが変えられない行 (埋めない)。
+ */
+export declare function iterateTsvPrefixRows(text: string): Generator<string[]>;
+
 /**
  * Yields the rows of a TSV text one at a time, in exactly parseTsv's grammar (the same quoting rule, line terminators
  * and final-terminator handling; empty text is one row with one empty cell), WITHOUT padding them to a common width. A

package/dist/tsv.d.ts

@@ -1,3 +1,19 @@
+/**
+ * Yields the rows of a text that may be only the beginning of a TSV (a file read partway, a stream not yet ended), in
+ * exactly iterateTsvRows's grammar, but only those the rest of the text cannot change: every row the text ends with a
+ * line terminator, up to the first field that opens a quote the text does not close (whether it is one quoted field or a
+ * literal one split at its line breaks is the rest's to decide). So the rows of any beginning of a TSV are the first
+ * rows of the whole: a reader of a stream can show them as final. Empty text yields no row. Unpadded.
+ * TSV の先頭だけかもしれない文字 (途中まで読んだファイル、まだ終わらないストリーム) の行を、iterateTsvRows とちょうど同じ文法で、
+ * ただし文字の続きが変えられない行だけ出す処理。文字が改行で終える行すべてを、文字が閉じない引用を開く最初の値まで出す (それが 1 つの
+ * 引用の値か、改行で割れる文字どおりの値かは続きが決める)。そのため TSV のどの先頭の行も全体の最初の行で、ストリームの読み手は
+ * それを確定したものとして見せられる。空の文字は行を出さない。埋めない。
+ *
+ * @param text - The beginning of a TSV text, as read. 読んだままの TSV の文字の先頭。
+ * @returns The rows the rest of the text cannot change, unpadded. 文字の続きが変えられない行 (埋めない)。
+ */
+export declare function iterateTsvPrefixRows(text: string): Generator<string[]>;
+
 /**
  * Yields the rows of a TSV text one at a time, in exactly parseTsv's grammar (the same quoting rule, line terminators
  * and final-terminator handling; empty text is one row with one empty cell), WITHOUT padding them to a common width. A

package/dist/tsv.js

@@ -1,70 +1,76 @@
-const o = (e, t) => (
+const c = (e, t) => (
   // 終端 CRLF は必須 (Excel 実挙動)。parseTsv の「終端の改行 1 つを剥がす」規約と対 —
   // 終端なしだと [["a"],[""]] が [["a"]] に潰れ (cut-move で clear されるべき先に旧値が残る)、
   // [[""]] は "" になって §6.5.4-5 の空ガードに飲まれ「空セル貼り付けで clear」が不発になる
   `${e.map((n) => n.map(t).join("	")).join(`\r
 `)}\r
 `
-), T = (e) => o(e, a), g = (e) => o(e, f), a = (e) => /[\t\r\n]/.test(e) || e.startsWith('"') ? `"${e.replaceAll('"', '""')}"` : e, f = (e) => /[\t\r\n]/.test(e) ? `"${e.replaceAll('"', '""')}"` : e, c = (e) => e.endsWith(`\r
+), d = (e) => c(e, p), x = (e) => c(e, w), p = (e) => /[\t\r\n]/.test(e) || e.startsWith('"') ? `"${e.replaceAll('"', '""')}"` : e, w = (e) => /[\t\r\n]/.test(e) ? `"${e.replaceAll('"', '""')}"` : e, f = (e) => e.endsWith(`\r
 `) ? e.slice(0, -2) : e.endsWith(`
 `) || e.endsWith("\r") ? e.slice(0, -1) : e, l = /* @__PURE__ */ Symbol("row end");
-function* u(e) {
-  let t = 0;
+function* o(e, t) {
+  let n = 0;
   for (; ; ) {
-    const n = e[t] === '"' ? p(e, t) : null;
-    if (n !== null)
-      yield n.value, t = n.nextIndex;
+    const r = e[n] === '"' ? v(e, n) : a;
+    if (r === h && t === "prefix") return;
+    if (typeof r == "object")
+      yield r.value, n = r.nextIndex;
     else {
-      const r = v(e, t);
-      yield e.slice(t, r), t = r;
+      const s = m(e, n);
+      yield e.slice(n, s), n = s;
     }
-    if (t >= e.length) {
-      yield l;
+    if (n >= e.length) {
+      t === "whole" && (yield l);
       return;
     }
-    e[t] === "	" ? t += 1 : (t += e[t] === "\r" && e[t + 1] === `
+    e[n] === "	" ? n += 1 : (n += e[n] === "\r" && e[n + 1] === `
 ` ? 2 : 1, yield l);
   }
 }
-function* h(e) {
-  const t = c(e);
+function* T(e) {
+  const t = f(e);
   if (t === "") {
     yield [""];
     return;
   }
-  let n = [];
-  for (const r of u(t))
-    r === l ? (yield n, n = []) : n.push(r);
+  yield* u(o(t, "whole"));
+}
+function* A(e) {
+  yield* u(o(e, "prefix"));
+}
+function* u(e) {
+  let t = [];
+  for (const n of e)
+    n === l ? (yield t, t = []) : t.push(n);
 }
-const w = (e) => {
-  const t = Array.from(h(e));
+const E = (e) => {
+  const t = Array.from(T(e));
   let n = 0;
   for (const r of t)
     r.length > n && (n = r.length);
   return t.map((r) => r.length === n ? r : [...r, ...Array(n - r.length).fill("")]);
-}, m = (e) => {
-  const t = c(e);
+}, O = (e) => {
+  const t = f(e);
   if (t === "")
     return { rows: 1, cols: 1 };
   let n = 0, r = 0, s = 0;
-  for (const i of u(t))
+  for (const i of o(t, "whole"))
     i === l ? (n += 1, s > r && (r = s), s = 0) : s += 1;
   return { rows: n, cols: r };
-}, p = (e, t) => {
+}, a = /* @__PURE__ */ Symbol("literal field"), h = /* @__PURE__ */ Symbol("open quote"), v = (e, t) => {
   let n = "", r = t + 1;
-  for (; r < e.length; )
-    if (e[r] === '"')
-      if (e[r + 1] === '"')
-        n += '"', r += 2;
-      else {
-        const s = r + 1;
-        return (s >= e.length || e[s] === "	" || e[s] === `
-` || e[s] === "\r") && /[\t\r\n"]/.test(n) ? { value: n, nextIndex: s } : null;
-      }
-    else
-      n += e[r], r += 1;
-  return null;
-}, v = (e, t) => {
+  for (; ; ) {
+    const s = e.indexOf('"', r);
+    if (s < 0) return h;
+    if (n += e.slice(r, s), e[s + 1] === '"') {
+      n += '"', r = s + 2;
+      continue;
+    }
+    const i = s + 1;
+    return (i >= e.length || e[i] === "	" || e[i] === `
+` || e[i] === "\r") && /[\t\r\n"]/.test(n) ? { value: n, nextIndex: i } : a;
+  }
+}, m = (e, t) => {
   for (let n = t; n < e.length; n += 1)
     if (e[n] === "	" || e[n] === `
 ` || e[n] === "\r")
@@ -72,9 +78,10 @@ const w = (e) => {
   return e.length;
 };
 export {
-  h as iterateTsvRows,
-  m as measureTsv,
-  w as parseTsv,
-  g as serializeClipboardTsv,
-  T as serializeTsv
+  A as iterateTsvPrefixRows,
+  T as iterateTsvRows,
+  O as measureTsv,
+  E as parseTsv,
+  x as serializeClipboardTsv,
+  d as serializeTsv
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/spreadsheet",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "Excel-grade spreadsheet grid for React: multi-cell selection, TSV/HTML clipboard, in-place editing on top of @aiquants/virtualscroll",
   "sideEffects": [
     "**/*.css"
@@ -56,12 +56,12 @@
     "LICENSE.md"
   ],
   "peerDependencies": {
-    "@aiquants/virtualscroll": "^3.22.0",
+    "@aiquants/virtualscroll": "^3.22.1",
     "react": "^19.2.7",
     "react-dom": "^19.2.7"
   },
   "devDependencies": {
-    "@aiquants/virtualscroll": "3.22.0",
+    "@aiquants/virtualscroll": "3.22.1",
     "@playwright/test": "^1.59.1",
     "@tailwindcss/cli": "^4.1.18",
     "@testing-library/jest-dom": "^6.9.1",

package/src/clipboard/tsv.ts

@@ -14,10 +14,12 @@
  * before: a cell Excel emitted untouched such as `"hi"` (content without any of the four) stays
  * `"hi"`. The one raw shape that changed reading is a cell that looks exactly like a quoted field
  * holding a doubled quote (a literal `"a""b"` now reads `a"b`), which no Excel cell produces
- * unquoted. Both readers share ONE grammar walk (`scanTsv`): `parseTsv` materialises the matrix,
+ * unquoted. Every reader shares ONE grammar walk (`scanTsv`): `parseTsv` materialises the matrix,
  * `measureTsv` only counts rows × columns so the ADR-12 paste gate can refuse an over-cap
  * clipboard BEFORE any row array exists (a newline-only clipboard costs ~hundreds of bytes of
- * matrix per input byte when materialised).
+ * matrix per input byte when materialised), and `iterateTsvPrefixRows` reads a text that may be
+ * only a TSV's beginning, stopping where the rest could change a row: at a row without its line
+ * terminator, and at a quote the text does not close, which the whole text reads as a literal.
  *
  * クリップボード TSV の直列化 / 解析 (§6.5.1)。文字列の少なくとも 1 × 1 のどの矩形行列でも往復が厳密
  * (`parseTsv(serializeTsv(m))` が `m` と深く等しい)。`serializeClipboardTsv` はクリップボードの text/plain の
@@ -31,9 +33,11 @@
  * それ以外は文字どおりの値なので、Excel の素の出力は従来どおりに読める (Excel が囲まずに出した
  * `"hi"` は中身に 4 つのどれも無いため `"hi"` のまま)。読みが変わった素の形は、二重化した引用符を
  * 持つ引用のフィールドとそっくりな値 (文字どおりの `"a""b"` は `a"b` と読む) だけで、Excel が囲まずに
- * 出すセルには無い。読み手 2 つは唯一の文法走査 (`scanTsv`) を共有: `parseTsv` は行列を実体化し、
+ * 出すセルには無い。全ての読み手は唯一の文法走査 (`scanTsv`) を共有: `parseTsv` は行列を実体化し、
  * `measureTsv` は行 × 列だけを数える — ADR-12 の paste ゲートが上限超のクリップボードを行配列の
  * 実体化**前**に拒否できる (改行だけのクリップボードは実体化で入力 1 byte あたり数百 byte の行列費用になる)。
+ * `iterateTsvPrefixRows` は TSV の先頭だけかもしれない文字を読み、続きが行を変えうる所で止まる (改行の無い行と、
+ * 文字が閉じない引用。文字全体ではこれを literal と読む)。
  */
 
 /**
@@ -109,23 +113,37 @@ const stripTrailingTerminator = (text: string): string => (text.endsWith("\r\n")
 const ROW_END: unique symbol = Symbol("row end")
 
 /**
- * The ONE grammar walk every reader shares (parseTsv through iterateTsvRows, and measureTsv): yields each field of
- * `body` in order and ROW_END after the last field of every row (the last row included), adopting the quoted reading only
- * under the two-part condition of tryReadQuotedField. Lazy: nothing past the token a consumer takes is read. `body` must
- * be terminator-stripped and non-empty.
- * 全ての読み手 (iterateTsvRows を通る parseTsv と measureTsv) が共有する唯一の文法走査: `body` の値を順に出し、各行の最後の
- * 値の後に ROW_END を出す (最終行も)。quoted 解釈の採否は tryReadQuotedField の 2 条件だけ。遅延で、受け手が取った印より先は
- * 読まない。`body` は終端剥がし済み・非空であること。
+ * What a walk reads: `whole`, a whole TSV text, terminator-stripped and non-empty; `prefix`, a text that may be only
+ * the beginning of one (a file read partway), whose readings end at the first one the rest could change.
+ * 走査が読むもの。`whole` は TSV の文字全体 (終端を剥がした非空の文字)、`prefix` は TSV の先頭だけかもしれない文字 (途中まで読んだ
+ * ファイル) で、続きが変えうる最初の読みで終わる。
+ */
+type TsvExtent = "whole" | "prefix"
+
+/**
+ * The ONE grammar walk every reader shares (parseTsv through iterateTsvRows, measureTsv, and iterateTsvPrefixRows): yields
+ * each field of `body` in order and ROW_END after the last field of every row, adopting the quoted reading only under the
+ * two-part condition of readQuotedField. Of a `whole` text the last row ends with the text; of a `prefix` the walk stops
+ * at the first field whose quote the text does not close (the rest decides whether it is one quoted field or a literal
+ * one), and a row the text does not end with a line terminator gets no ROW_END, as the rest may continue it. Lazy:
+ * nothing past the token a consumer takes is read.
+ * 全ての読み手 (iterateTsvRows を通る parseTsv・measureTsv・iterateTsvPrefixRows) が共有する唯一の文法走査: `body` の値を順に
+ * 出し、各行の最後の値の後に ROW_END を出す。quoted 解釈の採否は readQuotedField の 2 条件だけ。`whole` の文字では最後の行が
+ * 文字とともに終わり、`prefix` では文字が閉じない引用の値で走査を止め (それが 1 つの引用の値か文字どおりの値かは続きが決める)、
+ * 文字が改行で終えない行には ROW_END を出さない (続きがその行を延ばしうる)。遅延で、受け手が取った印より先は読まない。
  *
- * @param body - The terminator-stripped TSV text. 終端を剥がした TSV の文字列。
+ * @param body - The TSV text: terminator-stripped and non-empty for `whole`, as read for `prefix`. TSV の文字列 (`whole` は終端を剥がした非空の文字、`prefix` は読んだまま)。
+ * @param extent - Whether `body` is the whole text or only its beginning. `body` が文字全体か、その先頭だけか。
  * @returns The field / row-end tokens. 値と行末の印。
  */
-function* scanTsv(body: string): Generator<string | typeof ROW_END> {
+function* scanTsv(body: string, extent: TsvExtent): Generator<string | typeof ROW_END> {
     let i = 0
     while (true) {
-        // quoted 解釈の採否は tryReadQuotedField の 2 条件だけが決める (不成立は literal — Excel が囲まずに出した `"hi"` を壊さない)
-        const quoted = body[i] === '"' ? tryReadQuotedField(body, i) : null
-        if (quoted !== null) {
+        // quoted 解釈の採否は readQuotedField の 2 条件だけが決める (不成立は literal — Excel が囲まずに出した `"hi"` を壊さない)
+        const quoted = body[i] === '"' ? readQuotedField(body, i) : LITERAL_FIELD
+        // 閉じない引用は、続きが閉じれば 1 つの値、閉じなければ改行で割れる literal。先頭だけの文字ではまだ決まらない
+        if (quoted === OPEN_QUOTE && extent === "prefix") return
+        if (typeof quoted === "object") {
             yield quoted.value
             i = quoted.nextIndex
         } else {
@@ -134,7 +152,7 @@ function* scanTsv(body: string): Generator<string | typeof ROW_END> {
             i = end
         }
         if (i >= body.length) {
-            yield ROW_END
+            if (extent === "whole") yield ROW_END
             return
         }
         if (body[i] === "\t") {
@@ -165,8 +183,37 @@ export function* iterateTsvRows(text: string): Generator<string[]> {
         yield [""]
         return
     }
+    yield* rowsOf(scanTsv(body, "whole"))
+}
+
+/**
+ * Yields the rows of a text that may be only the beginning of a TSV (a file read partway, a stream not yet ended), in
+ * exactly iterateTsvRows's grammar, but only those the rest of the text cannot change: every row the text ends with a
+ * line terminator, up to the first field that opens a quote the text does not close (whether it is one quoted field or a
+ * literal one split at its line breaks is the rest's to decide). So the rows of any beginning of a TSV are the first
+ * rows of the whole: a reader of a stream can show them as final. Empty text yields no row. Unpadded.
+ * TSV の先頭だけかもしれない文字 (途中まで読んだファイル、まだ終わらないストリーム) の行を、iterateTsvRows とちょうど同じ文法で、
+ * ただし文字の続きが変えられない行だけ出す処理。文字が改行で終える行すべてを、文字が閉じない引用を開く最初の値まで出す (それが 1 つの
+ * 引用の値か、改行で割れる文字どおりの値かは続きが決める)。そのため TSV のどの先頭の行も全体の最初の行で、ストリームの読み手は
+ * それを確定したものとして見せられる。空の文字は行を出さない。埋めない。
+ *
+ * @param text - The beginning of a TSV text, as read. 読んだままの TSV の文字の先頭。
+ * @returns The rows the rest of the text cannot change, unpadded. 文字の続きが変えられない行 (埋めない)。
+ */
+export function* iterateTsvPrefixRows(text: string): Generator<string[]> {
+    yield* rowsOf(scanTsv(text, "prefix"))
+}
+
+/**
+ * Groups a walk's tokens into rows; fields after the last ROW_END (a row the walk did not end) are dropped.
+ * 走査の印を行にまとめる処理 (最後の ROW_END の後の値 — 走査が終えなかった行 — は捨てる)。
+ *
+ * @param tokens - The walk's tokens. 走査の印。
+ * @returns The rows. 行。
+ */
+function* rowsOf(tokens: Iterable<string | typeof ROW_END>): Generator<string[]> {
     let row: string[] = []
-    for (const token of scanTsv(body)) {
+    for (const token of tokens) {
         if (token === ROW_END) {
             yield row
             row = []
@@ -219,7 +266,7 @@ export const measureTsv = (text: string): { rows: number; cols: number } => {
     let rows = 0
     let cols = 0
     let current = 0
-    for (const token of scanTsv(body)) {
+    for (const token of scanTsv(body, "whole")) {
         if (token === ROW_END) {
             rows += 1
             if (current > cols) {
@@ -233,41 +280,46 @@ export const measureTsv = (text: string): { rows: number; cols: number } => {
     return { rows, cols }
 }
 
+/** readQuotedField's answer for a field read as a literal. readQuotedField が文字どおりに読む値に返す答え。 */
+const LITERAL_FIELD: unique symbol = Symbol("literal field")
+
 /**
- * Reads the quoted field that starts at `start`, adopted ONLY when it closes properly and its
- * content holds a tab, CR, LF or `"` (exactly the fields `serializeTsv` quotes); otherwise null,
- * and the caller reads a literal.
- * 位置 `start` から始まる引用のフィールドを読む処理。正しく閉じ、中身がタブ・CR・LF・`"` のどれかを含む
- * とき (`serializeTsv` が囲む値とちょうど同じ) だけ採用し、そうでなければ null (呼び手は文字どおりに読む)。
+ * readQuotedField's answer for a quote the text does not close: a literal of a whole text, undecided in a prefix.
+ * readQuotedField が、文字の閉じない引用に返す答え (文字全体では literal、先頭だけの文字ではまだ決まらない)。
+ */
+const OPEN_QUOTE: unique symbol = Symbol("open quote")
+
+/**
+ * Reads the quoted field that starts at `start`, adopted ONLY when it closes properly and its content holds a tab, CR,
+ * LF or `"` (exactly the fields `serializeTsv` quotes); a quote that closes otherwise is a literal (LITERAL_FIELD), and a
+ * quote the text never closes is OPEN_QUOTE, which a whole text reads as a literal too. The content is gathered a run
+ * between quotes at a time.
+ * 位置 `start` から始まる引用のフィールドを読む処理。正しく閉じ、中身がタブ・CR・LF・`"` のどれかを含むとき (`serializeTsv` が
+ * 囲む値とちょうど同じ) だけ採用し、ほかの閉じ方は文字どおり (LITERAL_FIELD)、文字が閉じない引用は OPEN_QUOTE (文字全体では
+ * これも文字どおりに読む)。中身は引用符の間の区間ごとにまとめて集める。
  *
- * @param body - The terminator-stripped TSV text. 終端を剥がした TSV の文字列。
+ * @param body - The TSV text. TSV の文字列。
  * @param start - The index of the opening quote. 開きの引用符の位置。
- * @returns The unescaped value and the index after the closing quote, or null. 剥がした値と閉じの直後の位置、または null。
+ * @returns The unescaped value and the index after the closing quote, LITERAL_FIELD, or OPEN_QUOTE. 剥がした値と閉じの直後の位置、LITERAL_FIELD、または OPEN_QUOTE。
  */
-const tryReadQuotedField = (body: string, start: number): { value: string; nextIndex: number } | null => {
+const readQuotedField = (body: string, start: number): { value: string; nextIndex: number } | typeof LITERAL_FIELD | typeof OPEN_QUOTE => {
     let value = ""
     let i = start + 1
-    while (i < body.length) {
-        if (body[i] === '"') {
-            if (body[i + 1] === '"') {
-                value += '"'
-                i += 2
-            } else {
-                const next = i + 1
-                // 成立条件は 2 つとも必要: (a) 閉じ引用の直後が区切りか終端、(b) 中身がタブ・改行・`"` を含む
-                // (書き手が囲む値の集合と同じ)。(b) が無いと、Excel が囲まずに出した literal `"hi"` を剥がしてしまう
-                const isBoundary = next >= body.length || body[next] === "\t" || body[next] === "\n" || body[next] === "\r"
-                if (isBoundary && /[\t\r\n"]/.test(value)) {
-                    return { value, nextIndex: next }
-                }
-                return null
-            }
-        } else {
-            value += body[i]
-            i += 1
+    while (true) {
+        const quote = body.indexOf('"', i)
+        if (quote < 0) return OPEN_QUOTE
+        value += body.slice(i, quote)
+        if (body[quote + 1] === '"') {
+            value += '"'
+            i = quote + 2
+            continue
         }
+        const next = quote + 1
+        // 成立条件は 2 つとも必要: (a) 閉じ引用の直後が区切りか終端、(b) 中身がタブ・改行・`"` を含む
+        // (書き手が囲む値の集合と同じ)。(b) が無いと、Excel が囲まずに出した literal `"hi"` を剥がしてしまう
+        const isBoundary = next >= body.length || body[next] === "\t" || body[next] === "\n" || body[next] === "\r"
+        return isBoundary && /[\t\r\n"]/.test(value) ? { value, nextIndex: next } : LITERAL_FIELD
     }
-    return null // 閉じ引用が無い → literal 扱い
 }
 
 /** Next tab/newline position or end. / 次の区切り位置 (無ければ終端)。 */

package/src/index.ts

@@ -46,7 +46,7 @@ export { type HtmlTableKind, type HtmlTableResult, parseHtmlTable, serializeHtml
 export type { NumberFormatDecodeOptions } from "./clipboard/numberFormatCodec.ts"
 export type { PasteMode, PasteOperation, PasteOptions } from "./clipboard/pasteSpecial.ts"
 export { estimatePasteCellCount, expandPaste } from "./clipboard/tiling.ts"
-export { iterateTsvRows, measureTsv, parseTsv, serializeClipboardTsv, serializeTsv } from "./clipboard/tsv.ts"
+export { iterateTsvPrefixRows, iterateTsvRows, measureTsv, parseTsv, serializeClipboardTsv, serializeTsv } from "./clipboard/tsv.ts"
 export type { ClipInfo, PasteOutcome } from "./clipboard/useClipboard.ts"
 export type { BorderPreset } from "./commands/useCommands.ts"
 // renderCell の ctx 型 — prop が公開面にある以上、その引数型も名指しできなければならない

package/src/tsv.ts

@@ -4,7 +4,8 @@
  * `parseTsv(serializeTsv(m))` equals `m` for every rectangular matrix of strings of at least 1 × 1) and the dimension scan `measureTsv`
  * (the rows × columns `parseTsv` would build, without building them), React-free, so a host reads, writes or sizes a
  * grid's text before the grid itself is loaded — a server-rendered placeholder table, a lazily imported grid. Published
- * as `@aiquants/spreadsheet/tsv`, which loads none of the grid; the barrel exports the same five functions (`iterateTsvRows` yields the rows lazily, unpadded). The clipboard
+ * as `@aiquants/spreadsheet/tsv`, which loads none of the grid; the barrel exports the same six functions (`iterateTsvRows` yields the rows lazily, unpadded, and
+ * `iterateTsvPrefixRows` the rows of a text that may be only a TSV's beginning, those the rest cannot change). The clipboard
  * writer `serializeClipboardTsv` (Excel's form) is for text/plain on the clipboard; files and stored bodies use the strict
  * `serializeTsv`.
  *
@@ -12,7 +13,8 @@
  * タブか改行を含むか `"` で始まる値を引用符で囲むので、文字列の少なくとも 1 × 1 のどの矩形行列 `m` でも `parseTsv(serializeTsv(m))` が `m` に
  * 等しい) と寸法の走査 `measureTsv` (`parseTsv` が組む行 × 列を、組まずに返す) を React を読まずに渡すモジュール。ホストが
  * グリッドを読み込む前に (サーバーで描く代わりの表、遅延で読み込むグリッド) グリッドの文字を読み書きし寸法を測れる。グリッドを
- * 読み込まない `@aiquants/spreadsheet/tsv` として公開し、barrel も同じ 5 つの関数を公開する (`iterateTsvRows` は行を遅延で、埋めずに出す)。クリップボードの text/plain は
+ * 読み込まない `@aiquants/spreadsheet/tsv` として公開し、barrel も同じ 6 つの関数を公開する (`iterateTsvRows` は行を遅延で、埋めずに出し、
+ * `iterateTsvPrefixRows` は TSV の先頭だけかもしれない文字の行のうち、続きが変えられない行を出す)。クリップボードの text/plain は
  * Excel の形の `serializeClipboardTsv`、ファイルと保存する本文は厳密な `serializeTsv` を使う。
  */
-export { iterateTsvRows, measureTsv, parseTsv, serializeClipboardTsv, serializeTsv } from "./clipboard/tsv.ts"
+export { iterateTsvPrefixRows, iterateTsvRows, measureTsv, parseTsv, serializeClipboardTsv, serializeTsv } from "./clipboard/tsv.ts"