@aiquants/spreadsheet 0.16.0 → 0.17.0

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/header/useHeaderResize.ts

@@ -25,7 +25,10 @@
  * byte-identical (sign +1, guide `offsetOf + pendingSize`, both writers). Column autofit
  * measures the union `[0, R_eff) ∪ [rowStart, rowEnd] ∪ [rowCount − T_eff, rowCount)` (each
  * filtered by sizeOf > 0 — ADR-21, band counts from a judgment-time `getFrozenSize()` read)
- * and the measured-cell budget gate counts band rows.
+ * and the measured-cell budget gate counts band rows. v0.17: autofit measures with the cells' base
+ * font, read from the body pane (`fontSourceRef`), so the keyboard twin and the imperative all-rows
+ * fit (`autofitColumnsInAllRows` — every row of the named columns, no fan-out, gated at
+ * maxOperationCells measured cells) work whether the header bands are shown or not.
  *
  * ヘッダーリサイズ / unhide 機械 (§7 PT-1)。単一フックが両帯を結線 (§7.4 の機械勘定 = 1)。
  * 帯へ wire-once の native capture pointerdown を 1 本 (ストリップはリスナーを持たない —
@@ -49,7 +52,10 @@
  * 即時書込) が予定動く辺 `offsetOf(index) + initialSize − pendingSize` に置く。leading パスは
  * byte 恒等 (符号 +1、ガイド `offsetOf + pendingSize`、両書き手)。列 autofit の測定行集合は
  * 和集合 `[0, R_eff) ∪ [rowStart, rowEnd] ∪ [rowCount − T_eff, rowCount)` (各 sizeOf > 0 —
- * ADR-21。帯件数は判断時 `getFrozenSize()` 読み)、計測セル予算ゲートは帯行を算入する。
+ * ADR-21。帯件数は判断時 `getFrozenSize()` 読み)、計測セル予算ゲートは帯行を算入する。v0.17: autofit はセルの
+ * 基本の書体を本体ペイン (`fontSourceRef`) から読むので、キーの双子と命令の全部の行の合わせ
+ * (`autofitColumnsInAllRows` — 名指した列の全部の行、ファンアウトなし、測るセルは maxOperationCells まで) は
+ * 見出しの帯の有無に依らず働く。
  */
 
 import type { VirtualGridHandle } from "@aiquants/virtualscroll"
@@ -86,6 +92,12 @@ type UseHeaderResizeParams = {
     enabled: boolean
     colBandRef: RefObject<HTMLElement | null>
     rowBandRef: RefObject<HTMLElement | null>
+    /**
+     * The element whose computed font is the cells' base font (the body pane, the cells' parent): autofit measures with it,
+     * so it works whether the header bands are shown or not.
+     * 計算済みの書体がセルの基本の書体になる要素 (セルの親の本体ペイン)。autofit はこれで測るので、見出しの帯の有無に依らない。
+     */
+    fontSourceRef: RefObject<HTMLElement | null>
     colAxis: AxisModel
     rowAxis: AxisModel
     viewStore: ViewStore
@@ -119,25 +131,25 @@ type UseHeaderResizeParams = {
 }
 
 /**
- * The canvas `font` shorthand of a painted format over the band's computed style: italic /
- * bold / pt size (× 4/3 px, like cellPaint) / family from the format, the band's values
- * otherwise. Interned per format object (the paint intern keeps one object per distinct
+ * The canvas `font` shorthand of a painted format over the cells' base computed style (the body
+ * pane's): italic / bold / pt size (× 4/3 px, like cellPaint) / family from the format, the base
+ * values otherwise. Interned per format object (the paint intern keeps one object per distinct
  * painted format, so this is one string per distinct font).
- * 塗り書式の canvas `font` 短縮形 (帯の computed style の上に italic / bold / pt サイズ (× 4/3 px —
- * cellPaint と同式) / フォント族を重ねる)。書式 object 毎に intern (塗り intern が書式毎に 1 object を
- * 保つので、異なりフォント毎に 1 文字列)。
+ * 塗り書式の canvas `font` 短縮形 (セルの基本の computed style — 本体ペインのもの — の上に italic / bold /
+ * pt サイズ (× 4/3 px — cellPaint と同式) / フォント族を重ねる)。書式 object 毎に intern (塗り intern が書式毎に
+ * 1 object を保つので、異なりフォント毎に 1 文字列)。
  */
-const fontKeyOf = (painted: CellFormat, fontKeys: WeakMap<CellFormat, string>, bandStyle: Pick<CSSStyleDeclaration, "fontStyle" | "fontWeight" | "fontSize" | "fontFamily">): string => {
+const fontKeyOf = (painted: CellFormat, fontKeys: WeakMap<CellFormat, string>, baseStyle: Pick<CSSStyleDeclaration, "fontStyle" | "fontWeight" | "fontSize" | "fontFamily">): string => {
     const cached = fontKeys.get(painted)
     if (cached !== undefined) {
         return cached
     }
     // 真偽値は厳密 true のみ (fail-soft — cellPaint と同じ判定)
-    const style = painted.italic === true ? "italic" : bandStyle.fontStyle
-    const weight = painted.bold === true ? "bold" : bandStyle.fontWeight
-    // pt は cellPaint と同じ × 4/3 で px へ (非有限 / 非正は帯の既定のまま)
-    const size = typeof painted.fontSize === "number" && Number.isFinite(painted.fontSize) && painted.fontSize > 0 ? `${(painted.fontSize * 4) / 3}px` : bandStyle.fontSize
-    const family = typeof painted.fontFamily === "string" && painted.fontFamily !== "" ? painted.fontFamily : bandStyle.fontFamily
+    const style = painted.italic === true ? "italic" : baseStyle.fontStyle
+    const weight = painted.bold === true ? "bold" : baseStyle.fontWeight
+    // pt は cellPaint と同じ × 4/3 で px へ (非有限 / 非正は基本の書体の既定のまま)
+    const size = typeof painted.fontSize === "number" && Number.isFinite(painted.fontSize) && painted.fontSize > 0 ? `${(painted.fontSize * 4) / 3}px` : baseStyle.fontSize
+    const family = typeof painted.fontFamily === "string" && painted.fontFamily !== "" ? painted.fontFamily : baseStyle.fontFamily
     const font = `${style} ${weight} ${size} ${family}`
     fontKeys.set(painted, font)
     return font
@@ -184,6 +196,14 @@ export type HeaderResizeMachine = SelectionEngine & {
     stepTrack: (axis: "row" | "col", index: number, direction: 1 | -1) => boolean
     /** Fits column `index` to its content, as the strip double-click does (false when renderCell is set). / 列 `index` を中身に合わせる (ストリップのダブルクリックと同じ。renderCell があれば false)。 */
     autofitColumn: (index: number) => boolean
+    /**
+     * Fits the listed columns to the widest text of every row (no fan-out; hidden columns keep their width), gated at
+     * maxOperationCells measured cells (false after onOperationRejected; false when renderCell is set or no font source is
+     * mounted).
+     * 名指した列を全部の行で最も広い文字に合わせる (ファンアウトなし。隠した列は幅を保つ)。測るセルは maxOperationCells まで
+     * (超えると onOperationRejected の後に false。renderCell があるか書体の元が未装着なら false)。
+     */
+    autofitColumnsInAllRows: (columns: readonly number[]) => boolean
 }
 
 /**
@@ -323,44 +343,28 @@ export const useHeaderResize = (params: UseHeaderResizeParams): HeaderResizeMach
         [collectTargets, applyEntries],
     )
 
-    /** Column autofit (§7.3 / v0.8 §4.2.10 / ADR-21): per-column canvas measurement over the union of both frozen bands and the visible window — `[0, R_eff) ∪ [rowStart, rowEnd] ∪ [rowCount − T_eff, rowCount)`, each filtered by sizeOf > 0 — in each cell's painted font, bucketed by font key. / 列 autofit (§7.3 / v0.8 §4.2.10 / ADR-21): 両凍結帯 + 可視ウィンドウの和集合 `[0, R_eff) ∪ [rowStart, rowEnd] ∪ [rowCount − T_eff, rowCount)` (各 sizeOf > 0) をセルの塗りフォントで計測、フォントキーでバケット化。 */
-    const autofitColumns = useCallback(
-        (band: HTMLElement, pressedIndex: number): boolean => {
+    /**
+     * The measuring core of both autofit entries: fits `targets` to the widest painted text of `measuredRows` (per-column
+     * canvas measurement in each cell's painted font over the cells' base font from fontSourceRef, bucketed by font key),
+     * gated at `measureLimit` measured cells. No row to measure, no 2d context (jsdom) or an all-empty column set changes
+     * nothing and still counts as a run (true).
+     * 両方の autofit の入口が共有する計測の芯。`targets` を `measuredRows` の最も広い塗りの文字に合わせる (fontSourceRef のセルの
+     * 基本の書体の上で、セルごとの塗りの書体で列ごとに canvas で測り、書体の鍵で束ねる)。測るセルは `measureLimit` まで。測る行が無い・
+     * 2d の文脈が無い (jsdom)・全部が空の列は何も変えずに走ったものとする (true)。
+     *
+     * @param targets - The columns to fit. 合わせる列。
+     * @param measuredRows - The rows to measure, each with a size above 0. 測る行 (どれも大きさ 0 より大きい)。
+     * @param measureLimit - The most measured cells. 測るセルの上限。
+     * @param pressedIndex - The pressed track for the §7.2 zero-guard, or null for an imperative fit. §7.2 の 0 化ガードの押下トラック (命令の合わせでは null)。
+     * @returns Whether the fit ran (false after a refusal or without a mounted font source). 走ったか (拒んだとき・書体の元が未装着なら false)。
+     */
+    const fitColumns = useCallback(
+        (targets: readonly number[], measuredRows: readonly number[], measureLimit: number, pressedIndex: number | null): boolean => {
             const p = paramsRef.current
-            const targets = collectTargets("col", pressedIndex)
-            if (targets === null) {
+            const fontSource = p.fontSourceRef.current
+            if (fontSource === null) {
                 return false
             }
-            // 帯件数は判断時ハンドル読み (ADR-21 / ADR-19 の判断時規律 — getFrozenSize().rows /
-            // .trailingRows はエンジンクランプ済み実効値)。装着前 (null) は帯集合なし — 測定集合が
-            // 窓のみに縮む v0.8 恒等の能力分岐 (値代替フォールバックではない)
-            const handle = p.handleRef.current
-            const frozenSize = handle === null ? null : handle.getFrozenSize()
-            const leadingRows = frozenSize === null ? 0 : frozenSize.rows
-            const trailingRows = frozenSize === null ? 0 : frozenSize.trailingRows
-            // 測定行集合 = [0, R_eff) ∪ [rowStart, rowEnd] ∪ [rowCount − T_eff, rowCount) の順序付き
-            // 和集合 (ADR-21 — v0.9 §4.14)。幅 0 行は計測しない (sizeOf > 0 フィルタ)、重複は Set で
-            // 去重 (R = T = 0 は窓のみ = v0.8 恒等)
-            const { rowStart, rowEnd } = p.viewStore.get()
-            const last = Math.min(rowEnd, p.rowAxis.count - 1)
-            const measuredRows: number[] = []
-            const seen = new Set<number>()
-            const pushRow = (row: number): void => {
-                if (!seen.has(row) && p.rowAxis.sizeOf(row) > 0) {
-                    seen.add(row)
-                    measuredRows.push(row)
-                }
-            }
-            for (let row = 0; row < leadingRows; row += 1) {
-                pushRow(row)
-            }
-            for (let row = rowStart; row <= last; row += 1) {
-                pushRow(row)
-            }
-            // 末尾帯の開始 = rowCount − T_eff (エンジンクランプ済みのため常に ≥ R_eff ≥ 0 — §1.2)
-            for (let row = p.rowAxis.count - trailingRows; row < p.rowAxis.count; row += 1) {
-                pushRow(row)
-            }
             // 計測対象の可視行がゼロ (全帯 + 窓が非表示) は no-op — Excel も計測対象
             // なしでは幅を変えない (0 計測 → 9px 潰しの破壊を作らない。R1(B) 所見)
             // 測る行が無い / 測る書体が無い / 全空列は「当てるものが無い」実行で、拒否ではない (true)
@@ -368,30 +372,28 @@ export const useHeaderResize = (params: UseHeaderResizeParams): HeaderResizeMach
                 return true
             }
             // 上限ゲートは計測セル数単位 (§7.3 — トラック数単位では 16k 列 × 可視 40 行が素通り
-            // する)。上限は autofit 専用の低い係数 (§13 (e) の設計返却 — 実測根拠は定数 docstring)。
-            // 帯行も算入する (ADR-21 — measuredRows が帯行を含む)
+            // する)。帯行も算入する (ADR-21 — measuredRows が帯行を含む)
             const measuredCells = targets.length * measuredRows.length
-            const measureLimit = Math.floor(p.maxOperationCells / AUTOFIT_MEASURE_DIVISOR)
             if (measuredCells > measureLimit) {
                 p.onOperationRejected?.("resize", measuredCells, "limit")
                 return false
             }
-            // canvas 生成 + computed font 取得はジェスチャ 1 回につき 1 度 (§7.3)。font は
+            // canvas 生成 + computed font 取得は合わせ 1 回につき 1 度 (§7.3)。font は
             // ロングハンド合成の単一経路 (Firefox は font ショートハンドの computed 値を空で
             // 返すため、合成だけが全ブラウザで決定的)
             const context = document.createElement("canvas").getContext("2d")
             if (context === null) {
                 return true // 実ブラウザでは常に成立 (jsdom は 2d 未実装 — 計測面は E2E がピン)
             }
-            const bandStyle = getComputedStyle(band)
-            // 既定フォント (書式なしセル) — 帯の computed style のロングハンド合成
-            const baseFont = `${bandStyle.fontStyle} ${bandStyle.fontWeight} ${bandStyle.fontSize} ${bandStyle.fontFamily}`
+            const baseStyle = getComputedStyle(fontSource)
+            // 既定フォント (書式なしセル) — 本体ペインの computed style のロングハンド合成 (セルは本体ペインの書体を継ぐ)
+            const baseFont = `${baseStyle.fontStyle} ${baseStyle.fontWeight} ${baseStyle.fontSize} ${baseStyle.fontFamily}`
             // 見出しの行は書式でなくスタイルシートが太くする — 測る書体もセルと同じ太さにする。スタイルシートが読まれていなければ
-            // 見出しの行も帯と同じ太さで描かれるので、帯の太さがそのまま実際の描画の値
-            const headerWeight = bandStyle.getPropertyValue("--_aqsp-header-row-font-weight").trim()
-            const headerStyle = { fontStyle: bandStyle.fontStyle, fontWeight: headerWeight === "" ? bandStyle.fontWeight : headerWeight, fontSize: bandStyle.fontSize, fontFamily: bandStyle.fontFamily }
+            // 見出しの行も本体と同じ太さで描かれるので、本体の太さがそのまま実際の描画の値
+            const headerWeight = baseStyle.getPropertyValue("--_aqsp-header-row-font-weight").trim()
+            const headerStyle = { fontStyle: baseStyle.fontStyle, fontWeight: headerWeight === "" ? baseStyle.fontWeight : headerWeight, fontSize: baseStyle.fontSize, fontFamily: baseStyle.fontFamily }
             const headerFont = `${headerStyle.fontStyle} ${headerStyle.fontWeight} ${headerStyle.fontSize} ${headerStyle.fontFamily}`
-            // CF は幅に効く規則 (bold / italic 設定) と stopIfTrue の障壁だけを 1 ジェスチャ 1 回抽出し列毎に
+            // CF は幅に効く規則 (bold / italic 設定) と stopIfTrue の障壁だけを 1 回の合わせで 1 回抽出し列毎に
             // スライスする (実測 155 → 56 ms)。障壁を残すため走査は塗りと同じ位置で止まり bold / italic が
             // 厳密一致する。getConditionalFormats は getCellFormat を要する (root がマウント時に保証)
             const cfRules = p.adapter.getConditionalFormats === undefined ? null : widthRelevantRules(p.adapter.getConditionalFormats())
@@ -411,7 +413,7 @@ export const useHeaderResize = (params: UseHeaderResizeParams): HeaderResizeMach
                     // 塗り書式 (base ⊕ 幅に効く CF) — raw は既読なので thunk は再読しない
                     const painted = p.adapter.getCellFormat === undefined ? undefined : resolvePaintedFormat(p.adapter, colIndex, memo, row, col, () => raw)
                     const isHeaderRow = row < p.headerRows
-                    const font = painted === undefined ? (isHeaderRow ? headerFont : baseFont) : isHeaderRow ? fontKeyOf(painted, headerFontKeys, headerStyle) : fontKeyOf(painted, fontKeys, bandStyle)
+                    const font = painted === undefined ? (isHeaderRow ? headerFont : baseFont) : isHeaderRow ? fontKeyOf(painted, headerFontKeys, headerStyle) : fontKeyOf(painted, fontKeys, baseStyle)
                     const text = formatCellValue(raw, painted === undefined ? undefined : painted.value)
                     const bucket = buckets.get(font)
                     if (bucket === undefined) {
@@ -446,7 +448,51 @@ export const useHeaderResize = (params: UseHeaderResizeParams): HeaderResizeMach
             }
             return applyEntries("col", entries, pressedIndex)
         },
-        [collectTargets, applyEntries],
+        [applyEntries],
+    )
+
+    /** Column autofit (§7.3 / v0.8 §4.2.10 / ADR-21): per-column canvas measurement over the union of both frozen bands and the visible window — `[0, R_eff) ∪ [rowStart, rowEnd] ∪ [rowCount − T_eff, rowCount)`, each filtered by sizeOf > 0 — in each cell's painted font, bucketed by font key. / 列 autofit (§7.3 / v0.8 §4.2.10 / ADR-21): 両凍結帯 + 可視ウィンドウの和集合 `[0, R_eff) ∪ [rowStart, rowEnd] ∪ [rowCount − T_eff, rowCount)` (各 sizeOf > 0) をセルの塗りフォントで計測、フォントキーでバケット化。 */
+    const autofitColumns = useCallback(
+        (pressedIndex: number): boolean => {
+            const p = paramsRef.current
+            const targets = collectTargets("col", pressedIndex)
+            if (targets === null) {
+                return false
+            }
+            // 帯件数は判断時ハンドル読み (ADR-21 / ADR-19 の判断時規律 — getFrozenSize().rows /
+            // .trailingRows はエンジンクランプ済み実効値)。装着前 (null) は帯集合なし — 測定集合が
+            // 窓のみに縮む v0.8 恒等の能力分岐 (値代替フォールバックではない)
+            const handle = p.handleRef.current
+            const frozenSize = handle === null ? null : handle.getFrozenSize()
+            const leadingRows = frozenSize === null ? 0 : frozenSize.rows
+            const trailingRows = frozenSize === null ? 0 : frozenSize.trailingRows
+            // 測定行集合 = [0, R_eff) ∪ [rowStart, rowEnd] ∪ [rowCount − T_eff, rowCount) の順序付き
+            // 和集合 (ADR-21 — v0.9 §4.14)。幅 0 行は計測しない (sizeOf > 0 フィルタ)、重複は Set で
+            // 去重 (R = T = 0 は窓のみ = v0.8 恒等)
+            const { rowStart, rowEnd } = p.viewStore.get()
+            const last = Math.min(rowEnd, p.rowAxis.count - 1)
+            const measuredRows: number[] = []
+            const seen = new Set<number>()
+            const pushRow = (row: number): void => {
+                if (!seen.has(row) && p.rowAxis.sizeOf(row) > 0) {
+                    seen.add(row)
+                    measuredRows.push(row)
+                }
+            }
+            for (let row = 0; row < leadingRows; row += 1) {
+                pushRow(row)
+            }
+            for (let row = rowStart; row <= last; row += 1) {
+                pushRow(row)
+            }
+            // 末尾帯の開始 = rowCount − T_eff (エンジンクランプ済みのため常に ≥ R_eff ≥ 0 — §1.2)
+            for (let row = p.rowAxis.count - trailingRows; row < p.rowAxis.count; row += 1) {
+                pushRow(row)
+            }
+            // 上限は autofit 専用の低い係数 (§13 (e) の設計返却 — 実測根拠は定数 docstring)。帯行も算入する (ADR-21)
+            return fitColumns(targets, measuredRows, Math.floor(p.maxOperationCells / AUTOFIT_MEASURE_DIVISOR), pressedIndex)
+        },
+        [collectTargets, fitColumns],
     )
 
     const stepTrack = useCallback(
@@ -473,20 +519,42 @@ export const useHeaderResize = (params: UseHeaderResizeParams): HeaderResizeMach
     const autofitColumn = useCallback(
         (index: number): boolean => {
             const p = paramsRef.current
-            const band = p.colBandRef.current
-            // renderCell のカスタム DOM は measureText で測れない (帯のダブルクリックと同じ逸脱) — 帯の未装着は測る書体が無い
-            if (!p.autofitEnabled || band === null) {
+            // renderCell のカスタム DOM は measureText で測れない (帯のダブルクリックと同じ逸脱)。書体の元の未装着は芯が false を返す
+            if (!p.autofitEnabled) {
                 return false
             }
             // 隠れた列は隠れたまま (戻すのは再表示だけ) — 走ったが何も変えない
             if (p.colAxis.sizeOf(index) === 0) {
                 return true
             }
-            return autofitColumns(band, index)
+            return autofitColumns(index)
         },
         [autofitColumns],
     )
 
+    const autofitColumnsInAllRows = useCallback(
+        (columns: readonly number[]): boolean => {
+            const p = paramsRef.current
+            if (!p.autofitEnabled) {
+                return false
+            }
+            // 隠れた列は隠れたまま (戻すのは再表示だけ)。重複は 1 回
+            const targets = [...new Set(columns)].filter((col) => p.colAxis.sizeOf(col) > 0)
+            if (targets.length === 0) {
+                return true
+            }
+            const measuredRows: number[] = []
+            for (let row = 0; row < p.rowAxis.count; row += 1) {
+                if (p.rowAxis.sizeOf(row) > 0) {
+                    measuredRows.push(row)
+                }
+            }
+            // ホストが一度だけ呼ぶ合わせなので、上限は操作の予算そのもの (画面の操作の 1/4 の係数は打鍵ごとの応答のためのもの)
+            return fitColumns(targets, measuredRows, p.maxOperationCells, null)
+        },
+        [fitColumns],
+    )
+
     const { enabled, colBandRef, rowBandRef } = params
     useEffect(() => {
         const colBand = colBandRef.current
@@ -680,7 +748,7 @@ export const useHeaderResize = (params: UseHeaderResizeParams): HeaderResizeMach
                 }
                 return
             }
-            autofitColumns(band, hit.index)
+            autofitColumns(hit.index)
         }
 
         const onLostPointerCapture = (event: PointerEvent) => {
@@ -717,6 +785,7 @@ export const useHeaderResize = (params: UseHeaderResizeParams): HeaderResizeMach
         () => ({
             stepTrack,
             autofitColumn,
+            autofitColumnsInAllRows,
             isDragging: () => draggingRef.current,
             // リサイズ / unhide は選択矩形を配送しない — 配送モードは常に加算
             getDragMode: (): "add" | "subtract" | "point" => "add",
@@ -728,6 +797,6 @@ export const useHeaderResize = (params: UseHeaderResizeParams): HeaderResizeMach
             },
             cancelDrag: cleanupDrag,
         }),
-        [cleanupDrag, stepTrack, autofitColumn],
+        [cleanupDrag, stepTrack, autofitColumn, autofitColumnsInAllRows],
     )
 }

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 が公開面にある以上、その引数型も名指しできなければならない
@@ -122,5 +122,5 @@ export { NoteTip, type NoteTipProps } from "./popover/NoteTip.tsx"
 // PopoverContext.anchorRect の型 (層座標系の矩形) — 配置エンジン placePopover 本体は非公開のまま
 export type { PopoverRect } from "./popover/placement.ts"
 export type { CommentPopoverContext, LinkPopoverContext, ListPopoverContext, MessagePopoverContext, NotePopoverContext, NoteTipContext, PopoverContext, PopoverKind, PopoverOverrides } from "./popover/usePopovers.ts"
-export { DEFAULT_CUSTOM_COLORS, type ScrollToCellOptions, Spreadsheet, type SpreadsheetHandle, type SpreadsheetProps } from "./Spreadsheet.tsx"
+export { DEFAULT_CUSTOM_COLORS, type ScrollToCellOptions, Spreadsheet, type SpreadsheetContentSize, type SpreadsheetHandle, type SpreadsheetProps } from "./Spreadsheet.tsx"
 export type { SelectionState } from "./selection/selectionState.ts"

package/src/styles/spreadsheet.css

@@ -113,6 +113,26 @@
   transform-origin: 0 0;
 }
 
+/* 見出し (列の記号・行の番号・角) を出さないグリッド (headings={false}): 格子の 2 本の帯を 0 にし、本体を根の左上から始める */
+.aqsp-root[data-aqsp-headings-hidden] .aqsp-zoom {
+  grid-template-columns: 0 minmax(0, 1fr);
+  grid-template-rows: 0 minmax(0, 1fr);
+}
+
+/*
+ * キーの移動で選んだセルをページの中で見せる印 (位置と大きさは revealCellInPage が書く)。根の直下でズームの包みの外に置き、見えず
+ * 押せない。scrollIntoView は可視性に依らず箱の位置へスクロールする
+ */
+.aqsp-reveal {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 0;
+  height: 0;
+  pointer-events: none;
+  visibility: hidden;
+}
+
 .aqsp-corner {
   grid-column: 1;
   grid-row: 1;

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"