@aiquants/spreadsheet 0.15.0 → 0.16.1

package/src/clipboard/tsv.ts

@@ -1,34 +1,106 @@
 /**
- * @fileoverview Clipboard TSV serialize/parse compatible with Excel's REAL behavior (§6.5.1):
- * only cells containing a tab or newline are quoted (with internal `"` doubled) — everything
- * else passes through verbatim even when it contains `"`. The parser therefore adopts the
- * quoted reading ONLY when the unquoted content itself needs quoting; a field that is merely
- * wrapped in quotes (`"hi"`) is a literal Excel emitted untouched. Both readers share 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).
+ * @fileoverview Clipboard TSV serialize/parse (§6.5.1) whose round trip is exact for every
+ * rectangular matrix of strings of at least 1 × 1: `parseTsv(serializeTsv(m))` deep-equals `m`.
+ * `serializeClipboardTsv` is the clipboard's text/plain writer (the grid's copy, and a host's own
+ * copy button): Excel's form, which quotes only fields holding a tab, CR or LF, so a plain-text
+ * target receives `"Important" note` as typed (the grid's own paste reads its JSON payload first, so
+ * a grid-to-grid paste stays exact). Files and stored bodies use the strict `serializeTsv`. The writer quotes a
+ * field (doubling its inner `"`) when it holds a tab, CR or LF — the only cells Excel quotes — OR
+ * when it starts with `"`, the one other cell a reader could mistake for a quoted field (a ditto
+ * mark `"` beside another one would otherwise read back as a single cell). The reader adopts the
+ * quoted reading only when the quoted field closes properly (the closing quote is followed by a
+ * tab, a line break or the end) AND its unescaped content holds a tab, CR, LF or `"` — exactly the
+ * fields the writer quotes. Everything else is a literal, so Excel's raw output keeps reading as
+ * 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. 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), 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.
  *
- * Excel 実挙動互換のクリップボード TSV (§6.5.1)。quote されるのはタブ / 改行を含むセルだけ
- * (内部の `"` は二重化)、それ以外は `"` を含んでいても素通し。parse 側の quoted 解釈は
- * 「剥がした中身が改行かタブを含む」場合のみ採用 — 全体が引用で包まれただけの `"hi"` は
- * Excel が素通しした literal であり剥がさない。読み手 2 つは唯一の文法走査 (`scanTsv`) を共有:
- * `parseTsv` は行列を実体化し、`measureTsv` は行 × 列だけを数える — ADR-12 の paste ゲートが
- * 上限超のクリップボードを行配列の実体化**前**に拒否できる (改行だけのクリップボードは実体化で
- * 入力 1 byte あたり数百 byte の行列費用になる)。
+ * クリップボード TSV の直列化 / 解析 (§6.5.1)。文字列の少なくとも 1 × 1 のどの矩形行列でも往復が厳密
+ * (`parseTsv(serializeTsv(m))` が `m` と深く等しい)。`serializeClipboardTsv` はクリップボードの text/plain の
+ * 書き手 (グリッドのコピーと、ホスト自身のコピーのボタン) で、Excel の形 (タブ・CR・LF を含む値だけを囲む) なので、平文の
+ * 貼り先には `"Important" note` がそのまま届く (グリッド自身の貼り付けは JSON の payload を先に読むので、グリッドからグリッドへの
+ * 貼り付けは厳密なまま)。ファイルと保存する本文は厳密な `serializeTsv` を使う。書き手はタブ・CR・LF を含む値 (Excel が引用符で
+ * 囲む唯一のセル) に加え、`"` で始まる値 (読み手が引用されたフィールドと取り違え得る唯一の残り。
+ * 同じ記号 `"` が 2 つ並ぶと 1 つのセルに読み戻される) も引用符で囲み、中の `"` を二重化する。
+ * 読み手が引用の読みを採るのは、引用が正しく閉じ (閉じの引用符の直後がタブ・改行・終端)、かつ
+ * 剥がした中身がタブ・CR・LF・`"` のどれかを含むとき — 書き手が囲む値とちょうど同じ — だけ。
+ * それ以外は文字どおりの値なので、Excel の素の出力は従来どおりに読める (Excel が囲まずに出した
+ * `"hi"` は中身に 4 つのどれも無いため `"hi"` のまま)。読みが変わった素の形は、二重化した引用符を
+ * 持つ引用のフィールドとそっくりな値 (文字どおりの `"a""b"` は `a"b` と読む) だけで、Excel が囲まずに
+ * 出すセルには無い。全ての読み手は唯一の文法走査 (`scanTsv`) を共有: `parseTsv` は行列を実体化し、
+ * `measureTsv` は行 × 列だけを数える — ADR-12 の paste ゲートが上限超のクリップボードを行配列の
+ * 実体化**前**に拒否できる (改行だけのクリップボードは実体化で入力 1 byte あたり数百 byte の行列費用になる)。
+ * `iterateTsvPrefixRows` は TSV の先頭だけかもしれない文字を読み、続きが行を変えうる所で止まる (改行の無い行と、
+ * 文字が閉じない引用。文字全体ではこれを literal と読む)。
  */
 
 /**
- * Serializes a matrix to Excel-behavior TSV with a trailing CRLF.
- * 行列を終端 CRLF つきの Excel 実挙動 TSV へ直列化。
+ * Joins escaped fields with tabs, rows with CRLF, and ends with a CRLF.
+ * 囲みを済ませた値をタブで、行を CRLF でつなぎ、CRLF で終える処理。
+ *
+ * @param matrix - The rows of cell strings. セルの文字列の行。
+ * @param escapeField - The field writer. 値の書き手。
+ * @returns The TSV text. TSV の文字列。
  */
-export const serializeTsv = (matrix: readonly (readonly string[])[]): string =>
+const joinTsv = (matrix: readonly (readonly string[])[], escapeField: (field: string) => string): string =>
     // 終端 CRLF は必須 (Excel 実挙動)。parseTsv の「終端の改行 1 つを剥がす」規約と対 —
     // 終端なしだと [["a"],[""]] が [["a"]] に潰れ (cut-move で clear されるべき先に旧値が残る)、
     // [[""]] は "" になって §6.5.4-5 の空ガードに飲まれ「空セル貼り付けで clear」が不発になる
-    `${matrix.map((row) => row.map(escapeTsvField).join("\t")).join("\r\n")}\r\n`
+    `${matrix.map((row) => row.map(escapeField).join("\t")).join("\r\n")}\r\n`
+
+/**
+ * Serializes a matrix to TSV with a trailing CRLF; `parseTsv` reads the result back to the same
+ * matrix for every rectangular matrix of strings of at least 1 × 1 (the strict writer the package
+ * publishes; a host stores tables with it).
+ * 行列を終端 CRLF つきの TSV へ直列化する処理。文字列の少なくとも 1 × 1 のどの矩形行列でも `parseTsv` が同じ行列へ
+ * 読み戻す (パッケージが公開する厳密な書き手。ホストは表をこれで保存する)。
+ *
+ * @param matrix - The rows of cell strings. セルの文字列の行。
+ * @returns The TSV text. TSV の文字列。
+ */
+export const serializeTsv = (matrix: readonly (readonly string[])[]): string => joinTsv(matrix, escapeTsvField)
 
-/** Quotes only fields containing a tab or newline (Excel behavior). / タブか改行を含むフィールドのみ quote (Excel 実挙動)。 */
-const escapeTsvField = (field: string): string => (/[\t\r\n]/.test(field) ? `"${field.replaceAll('"', '""')}"` : field)
+/**
+ * Serializes a matrix the way Excel writes its clipboard text, with a trailing CRLF: only a field
+ * holding a tab, CR or LF is quoted (inner quotes doubled), so a field that merely starts with `"`
+ * reaches a plain-text target as typed. Its round trip is not exact for such fields (a raw
+ * `"\t"\tBlue` reads back as two cells); the grid's copy writes text/plain with it (and so should a
+ * host's own copy control, to match), and the grid's own paste reads the JSON payload first. Files and
+ * stored bodies use `serializeTsv`.
+ * Excel がクリップボードの文字を書く形で行列を終端 CRLF つきに直列化する処理。囲むのはタブ・CR・LF を含む値だけ (中の
+ * `"` は二重化) なので、`"` で始まるだけの値は平文の貼り先へそのまま届く。そうした値の往復は厳密でない (素の
+ * `"\t"\tBlue` は 2 つのセルに読み戻る)。グリッドのコピーが text/plain をこれで書き (ホスト自身のコピーの部品も揃えて
+ * これで書く)、グリッド自身の貼り付けは JSON の payload を先に読む。ファイルと保存する本文は `serializeTsv` を使う。
+ *
+ * @param matrix - The rows of cell strings. セルの文字列の行。
+ * @returns The TSV text in Excel's form. Excel の形の TSV の文字列。
+ */
+export const serializeClipboardTsv = (matrix: readonly (readonly string[])[]): string => joinTsv(matrix, escapeClipboardTsvField)
+
+/**
+ * Quotes a field that holds a tab, CR or LF or starts with `"` (inner quotes doubled); any other
+ * field is written verbatim.
+ * タブ・CR・LF を含むか `"` で始まる値を引用符で囲む処理 (中の `"` は二重化)。ほかの値はそのまま書く。
+ *
+ * @param field - The cell string. セルの文字列。
+ * @returns The field as written to TSV. TSV へ書く形の値。
+ */
+const escapeTsvField = (field: string): string => (/[\t\r\n]/.test(field) || field.startsWith('"') ? `"${field.replaceAll('"', '""')}"` : field)
+
+/**
+ * Quotes a field only when it holds a tab, CR or LF (inner quotes doubled) — the cells Excel quotes.
+ * タブ・CR・LF を含む値だけを引用符で囲む処理 (中の `"` は二重化) — Excel が囲むセル。
+ *
+ * @param field - The cell string. セルの文字列。
+ * @returns The field as Excel writes it. Excel が書く形の値。
+ */
+const escapeClipboardTsvField = (field: string): string => (/[\t\r\n]/.test(field) ? `"${field.replaceAll('"', '""')}"` : field)
 
 /**
  * Strips the single trailing line terminator (CRLF / LF / lone CR) — the last row's terminator,
@@ -37,38 +109,50 @@ const escapeTsvField = (field: string): string => (/[\t\r\n]/.test(field) ? `"${
  */
 const stripTrailingTerminator = (text: string): string => (text.endsWith("\r\n") ? text.slice(0, -2) : text.endsWith("\n") || text.endsWith("\r") ? text.slice(0, -1) : text)
 
+/** The token scanTsv yields after the last field of every row. / scanTsv が各行の最後の値の後に出す印。 */
+const ROW_END: unique symbol = Symbol("row end")
+
+/**
+ * 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 both readers share: reads `body` field by field (the quoted reading
- * adopted only under the two-part condition below), reporting each field to `onField` and each
- * row end to `onRowEnd` (the last row included). `body` must be terminator-stripped, non-empty.
- * 両読み手が共有する唯一の文法走査: `body` を 1 フィールドずつ読み (quoted 解釈の採用は下の
- * 二重条件のときだけ)、フィールド毎に `onField`、行の終わり毎に `onRowEnd` (最終行も) を呼ぶ。
- * `body` は終端剥がし済み・非空であること。
+ * 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 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. 値と行末の印。
  */
-const scanTsv = (body: string, onField: (field: string) => void, onRowEnd: () => void): void => {
+function* scanTsv(body: string, extent: TsvExtent): Generator<string | typeof ROW_END> {
     let i = 0
     while (true) {
-        // 1 フィールドずつ読む。quoted 解釈は「" で始まり、対応する閉じの直後がタブ / 改行 / 終端」の
-        // ときだけ採用し、そうでなければ literal (Excel が quote せず出力した `"hi"` を壊さない)
-        let field: string
-        if (body[i] === '"') {
-            const quoted = tryReadQuotedField(body, i)
-            if (quoted !== null) {
-                field = quoted.value
-                i = quoted.nextIndex
-            } else {
-                const end = nextDelimiter(body, i)
-                field = body.slice(i, end)
-                i = end
-            }
+        // 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 {
             const end = nextDelimiter(body, i)
-            field = body.slice(i, end)
+            yield body.slice(i, end)
             i = end
         }
-        onField(field)
         if (i >= body.length) {
-            onRowEnd()
+            if (extent === "whole") yield ROW_END
             return
         }
         if (body[i] === "\t") {
@@ -76,32 +160,80 @@ const scanTsv = (body: string, onField: (field: string) => void, onRowEnd: () =>
         } else {
             // 改行 (CRLF / LF / CR)
             i += body[i] === "\r" && body[i + 1] === "\n" ? 2 : 1
-            onRowEnd()
+            yield ROW_END
         }
     }
 }
 
 /**
- * Parses Excel-behavior TSV into a rectangular matrix (ragged rows are right-padded).
- * Excel 実挙動 TSV を矩形行列へ解析 (ギザギザ行は右パディング)。
+ * 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
+ * consumer that stops early materialises nothing past the last row it took, so a large text can be previewed under a
+ * cell budget.
+ * TSV の文字列の行を 1 つずつ出す処理。parseTsv とちょうど同じ文法 (同じ引用の規則・改行・末尾の改行の扱い。空の文字は空のセル
+ * 1 つの 1 行) で、幅を揃える右の埋めはしない。途中で止めた受け手は、最後に取った行より先を何も実体化しないので、大きな文字を
+ * セルの予算の下で見られる。
+ *
+ * @param text - The TSV text. TSV の文字列。
+ * @returns The rows, unpadded. 埋めない行。
  */
-export const parseTsv = (text: string): string[][] => {
+export function* iterateTsvRows(text: string): Generator<string[]> {
     const body = stripTrailingTerminator(text)
     if (body === "") {
-        return [[""]]
+        yield [""]
+        return
     }
-    const rows: string[][] = []
+    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[] = []
-    scanTsv(
-        body,
-        (field) => {
-            row.push(field)
-        },
-        () => {
-            rows.push(row)
+    for (const token of tokens) {
+        if (token === ROW_END) {
+            yield row
             row = []
-        },
-    )
+        } else {
+            row.push(token)
+        }
+    }
+}
+
+/**
+ * Parses TSV into a rectangular matrix (ragged rows are right-padded with ""; one trailing line
+ * terminator is dropped; empty text is one empty cell): the rows of iterateTsvRows, padded.
+ * TSV を矩形行列へ解析する処理 (不揃いの行は "" で右を埋め、末尾の改行 1 つを除き、空の文字は空のセル 1 つ)。iterateTsvRows の
+ * 行を埋めたもの。
+ *
+ * @param text - The TSV text. TSV の文字列。
+ * @returns The rectangular matrix, at least 1 × 1. 少なくとも 1 × 1 の矩形行列。
+ */
+export const parseTsv = (text: string): string[][] => {
+    const rows = Array.from(iterateTsvRows(text))
     // 矩形化: Excel 由来は常に矩形だが、他アプリ由来のギザギザ行も右パディングで受ける (仕様)。
     // ❗ Math.max(...rows) は行数ぶん引数を積み、巨大貼り付け (V8 実測 ~15 万行、JSC はさらに低い)
     // で ADR-12 見積もりに到達する前に RangeError で落ちる — ループで求める
@@ -122,6 +254,9 @@ export const parseTsv = (text: string): string[][] => {
  * `parseTsv(text)` が実体化する寸法 — 行数と矩形化後 (最大) の列数 — を**同じ**文法走査から、
  * 行配列を一切作らずに返す: `tsv` 貼り付けソースの ADR-12 実体化前見積もり (素の改行計数は
  * quoted 内の埋め込み改行を行と数え、正当な貼り付けを誤って上限拒否する)。
+ *
+ * @param text - The TSV text. TSV の文字列。
+ * @returns The row count and the maximum column count. 行数と最大の列数。
  */
 export const measureTsv = (text: string): { rows: number; cols: number } => {
     const body = stripTrailingTerminator(text)
@@ -131,48 +266,60 @@ export const measureTsv = (text: string): { rows: number; cols: number } => {
     let rows = 0
     let cols = 0
     let current = 0
-    scanTsv(
-        body,
-        () => {
-            current += 1
-        },
-        () => {
+    for (const token of scanTsv(body, "whole")) {
+        if (token === ROW_END) {
             rows += 1
             if (current > cols) {
                 cols = current
             }
             current = 0
-        },
-    )
+        } else {
+            current += 1
+        }
+    }
     return { rows, cols }
 }
 
-/** Reads a quoted field at i, adopted ONLY when its content needs quoting. / 位置 i の quoted field 読取り (中身が quote を要する場合のみ採用、不成立は null)。 */
-const tryReadQuotedField = (body: string, start: number): { value: string; nextIndex: number } | null => {
+/** readQuotedField's answer for a field read as a literal. readQuotedField が文字どおりに読む値に返す答え。 */
+const LITERAL_FIELD: unique symbol = Symbol("literal field")
+
+/**
+ * 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 TSV text. TSV の文字列。
+ * @param start - The index of the opening quote. 開きの引用符の位置。
+ * @returns The unescaped value and the index after the closing quote, LITERAL_FIELD, or OPEN_QUOTE. 剥がした値と閉じの直後の位置、LITERAL_FIELD、または OPEN_QUOTE。
+ */
+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) 中身に改行かタブを含む (Excel が quote する唯一の理由)。
-                // (b) が無いと、全体がちょうど引用で包まれた 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/clipboard/useClipboard.ts

@@ -88,7 +88,7 @@ import {
 import { parseHtmlTable, serializeHtmlTable } from "./htmlInterop.ts"
 import { DEFAULT_PASTE_OPTIONS, MODE_ASPECTS, type PasteAspects, type PasteOptions, patchFromClipCell, stripUndeclaredAspects, translateConditionalFormats, transposePayload } from "./pasteSpecial.ts"
 import { computePasteTargetRect, expandRichPaste } from "./tiling.ts"
-import { measureTsv, parseTsv, serializeTsv } from "./tsv.ts"
+import { measureTsv, parseTsv, serializeClipboardTsv } from "./tsv.ts"
 
 /** The armed clip surface a consumer sees (`onClipChange` / `getClip`): `foreign` = the record belongs to another adapter (sheet switch kept a cut). / consumer が見る装填クリップ (`onClipChange` / `getClip`): `foreign` = 記録が別アダプタのもの (シート切替が cut を保持)。 */
 export type ClipInfo = { kind: "copy" | "cut"; range: CellRange; foreign: boolean }
@@ -709,7 +709,8 @@ export const useClipboard = (params: UseClipboardParams): ClipboardController =>
             if (data !== null) {
                 // TSV は素の文字列 (数式セルも値文字列)、HTML は先頭属性に同じ JSON、カスタム MIME は
                 // paste イベント経路の高速マーカー (read() 経路には届かない)
-                data.setData("text/plain", serializeTsv(payload.cells.map((line) => line.map((cell) => cell.t))))
+                // 平文の貼り先には Excel の形 (囲むのはタブ・改行を含む値だけ)。グリッド自身の貼り付けは JSON の payload を先に読む
+                data.setData("text/plain", serializeClipboardTsv(payload.cells.map((line) => line.map((cell) => cell.t))))
                 data.setData("text/html", serializeHtmlTable(payload, json))
                 data.setData(CLIP_MIME, json)
             }

package/src/commands/useCommands.ts

@@ -166,6 +166,14 @@ export type UseCommandsParams = {
     announce: (text: string) => void
     formatCommandAnnouncement?: (ctx: { command: SpreadsheetCommand; state: boolean | null }) => string
     /** The active cell's keyboard rect (onPasteSpecialRequest origin). / active セルのキーボード矩形 (onPasteSpecialRequest の origin)。 */
+    /**
+     * The keyboard resize capability (the header resize machine's keyboard twins); absent ⇒ the resize commands are
+     * unavailable (`enableResizeUI` false or an empty grid).
+     * キーボードの寸法の能力 (帯のリサイズ機械のキーボードの双子)。無ければ寸法のコマンドは使えない (`enableResizeUI` が false か空のグリッド)。
+     */
+    trackResize?: { readonly stepTrack: (axis: "row" | "col", index: number, direction: 1 | -1) => boolean; readonly autofitColumn: (index: number) => boolean }
+    /** Live-region text after a keyboard resize (the active track's new size); absent ⇒ silent. / キーボードの寸法の変更の後の読み上げ (アクティブなトラックの新しい寸法)。無ければ無音。 */
+    formatResizeAnnouncement?: (ctx: { command: SpreadsheetCommand; axis: "row" | "column"; index: number; size: number }) => string
     keyboardCellRect: () => KeyboardCellRect
 }
 
@@ -218,6 +226,7 @@ type CommandSpec =
     | { kind: "paste"; options: PasteOptions }
     | { kind: "insertNow"; unit: "date" | "time" }
     | { kind: "hide"; axis: "row" | "col"; hide: boolean }
+    | { kind: "resize"; axis: "row" | "col"; step: 1 | -1 | "fit" }
     | { kind: "highlight"; target: "row" | "column" | "both" | "intersection" }
 
 /** Fill presets of the four named fill-colour toggles — pastels (design v3 §7 / the reference extension: legible behind the default text colour). / 名前つき塗りトグル 4 種のプリセット — 淡色 (設計 v3 §7 / 参照拡張機能と同値: 既定文字色の背後で可読)。 */
@@ -294,6 +303,11 @@ const COMMAND_SPECS: { readonly [K in SpreadsheetCommand]: CommandSpec } = {
     fontColorCustom3: { kind: "color", key: "color", preset: null, custom: 2 },
     fontColorCustom4: { kind: "color", key: "color", preset: null, custom: 3 },
     fontColorCustom5: { kind: "color", key: "color", preset: null, custom: 4 },
+    increaseColumnWidth: { kind: "resize", axis: "col", step: 1 },
+    decreaseColumnWidth: { kind: "resize", axis: "col", step: -1 },
+    increaseRowHeight: { kind: "resize", axis: "row", step: 1 },
+    decreaseRowHeight: { kind: "resize", axis: "row", step: -1 },
+    autoFitColumnWidth: { kind: "resize", axis: "col", step: "fit" },
     toggleRowHighlight: { kind: "highlight", target: "row" },
     toggleColumnHighlight: { kind: "highlight", target: "column" },
     toggleBothHighlight: { kind: "highlight", target: "both" },
@@ -748,6 +762,8 @@ export const useCommands = (params: UseCommandsParams): CommandRunner => {
             const formatDeclared = adapter.getCellFormat !== undefined
             const popoverEnabled = (kind: PopoverKind): boolean => (p.popovers === undefined ? true : p.popovers[kind] !== false)
             switch (spec.kind) {
+                case "resize":
+                    return p.trackResize !== undefined
                 case "toggle":
                 case "patch":
                 case "clear":
@@ -842,6 +858,30 @@ export const useCommands = (params: UseCommandsParams): CommandRunner => {
         [activeHyperlink],
     )
 
+    /**
+     * Runs one keyboard resize command on the active track (the header resize machine's keyboard twin) and announces the
+     * track's size afterwards; returns false when the capability is absent or the machine refused.
+     * キーボードの寸法のコマンド 1 つをアクティブなトラックへ当て (帯のリサイズ機械のキーボードの双子)、後でトラックの寸法を
+     * 読み上げる処理。能力が無いときと機械が拒んだときは false。
+     */
+    const runResize = useCallback((command: SpreadsheetCommand, axis: "row" | "col", step: 1 | -1 | "fit"): boolean => {
+        const p = paramsRef.current
+        const resize = p.trackResize
+        // 可否は isCommandAvailable が先に確かめている — 無いのは到達しない枝で、能力の代わりの値は作らない
+        if (resize === undefined) {
+            return false
+        }
+        const active = p.getActive()
+        const index = axis === "col" ? active.col : active.row
+        const ran = step === "fit" ? resize.autofitColumn(index) : resize.stepTrack(axis, index, step)
+        const size = (axis === "col" ? p.colAxis : p.rowAxis).sizeOf(index)
+        // 隠れたトラック (0 px) は何も変えずに消費する — 寸法の読み上げも出さない
+        if (ran && size > 0 && p.formatResizeAnnouncement !== undefined) {
+            p.announce(p.formatResizeAnnouncement({ command, axis: axis === "col" ? "column" : "row", index, size }))
+        }
+        return ran
+    }, [])
+
     const executeCommand = useCallback(
         (command: SpreadsheetCommand): boolean => {
             const p = paramsRef.current
@@ -980,6 +1020,8 @@ export const useCommands = (params: UseCommandsParams): CommandRunner => {
                 }
                 case "hide":
                     return runHide(spec.axis, spec.hide)
+                case "resize":
+                    return runResize(command, spec.axis, spec.step)
                 default: {
                     const h = p.getHighlight()
                     switch (spec.target) {
@@ -1002,7 +1044,7 @@ export const useCommands = (params: UseCommandsParams): CommandRunner => {
                 }
             }
         },
-        [isCommandAvailable, gateReadOnlyChord, activeHyperlink, activeBase, writeConstantPatch, announceFormat, setBorders, runCalc, runFill, runFillSelectionEditing, runHide],
+        [isCommandAvailable, gateReadOnlyChord, activeHyperlink, activeBase, writeConstantPatch, announceFormat, setBorders, runCalc, runFill, runFillSelectionEditing, runHide, runResize],
     )
 
     /** Commit gate shared by the annotation setters. / 注釈 setter 共通の commit ゲート。 */