@aiquants/spreadsheet 0.15.0 → 0.16.0

package/src/clipboard/tsv.ts

@@ -1,34 +1,102 @@
 /**
- * @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. 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).
  *
- * 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 が囲まずに
+ * 出すセルには無い。読み手 2 つは唯一の文法走査 (`scanTsv`) を共有: `parseTsv` は行列を実体化し、
+ * `measureTsv` は行 × 列だけを数える — ADR-12 の paste ゲートが上限超のクリップボードを行配列の
+ * 実体化**前**に拒否できる (改行だけのクリップボードは実体化で入力 1 byte あたり数百 byte の行列費用になる)。
  */
 
 /**
- * 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`
 
-/** 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 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)
+
+/**
+ * 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 +105,36 @@ 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")
+
 /**
- * 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, 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` は終端剥がし済み・非空であること。
+ *
+ * @param body - The terminator-stripped TSV text. 終端を剥がした TSV の文字列。
+ * @returns The field / row-end tokens. 値と行末の印。
  */
-const scanTsv = (body: string, onField: (field: string) => void, onRowEnd: () => void): void => {
+function* scanTsv(body: string): 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 解釈の採否は tryReadQuotedField の 2 条件だけが決める (不成立は literal — Excel が囲まずに出した `"hi"` を壊さない)
+        const quoted = body[i] === '"' ? tryReadQuotedField(body, i) : null
+        if (quoted !== null) {
+            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()
+            yield ROW_END
             return
         }
         if (body[i] === "\t") {
@@ -76,32 +142,51 @@ 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[][] = []
     let row: string[] = []
-    scanTsv(
-        body,
-        (field) => {
-            row.push(field)
-        },
-        () => {
-            rows.push(row)
+    for (const token of scanTsv(body)) {
+        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 +207,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,23 +219,31 @@ 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)) {
+        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)。 */
+/**
+ * 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 (呼び手は文字どおりに読む)。
+ *
+ * @param body - The terminator-stripped 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。
+ */
 const tryReadQuotedField = (body: string, start: number): { value: string; nextIndex: number } | null => {
     let value = ""
     let i = start + 1
@@ -158,11 +254,10 @@ const tryReadQuotedField = (body: string, start: number): { value: string; nextI
                 i += 2
             } else {
                 const next = i + 1
-                // 成立条件は 2 つとも必要: (a) 閉じ引用の直後が区切りか終端、
-                // (b) 中身に改行かタブを含む (Excel が quote する唯一の理由)。
-                // (b) が無いと、全体がちょうど引用で包まれた literal `"hi"` を剥がしてしまう
+                // 成立条件は 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)) {
+                if (isBoundary && /[\t\r\n"]/.test(value)) {
                     return { value, nextIndex: next }
                 }
                 return null

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 ゲート。 */

package/src/grid/GridBody.tsx

@@ -28,6 +28,14 @@
  * helper (ADR-31 — no package CSS; capability absent ⇒ O(1) false ⇒ keys absent ⇒ the DOM
  * stays byte-identical).
  *
+ * Accessibility structure (v0.16): the body wrapper is the ONE `role="grid"` element (row / column counts, its name
+ * from `labelledBy` or the built-in root label, `aria-readonly` from `readOnly`; no `aria-multiselectable`, since no
+ * cell carries `aria-selected` — the live region announces the selection), so the frozen leading,
+ * scrolling and frozen trailing panes VirtualGrid draws inside it are all owned by it; the scrolling pane's content
+ * element is the body `rowgroup`, the cells of the first `headerRows` rows are `columnheader` (`data-aqsp-header-row`),
+ * and both scroll bars are declared pointer-only (`enableArrowButtonTabStops: false` — the grid owns keyboard
+ * scrolling), so no `scrollbar` / `button` becomes a child of the grid.
+ *
  * UI chrome locale: the resolved `locale` and the value-stable engine subset `scrollLabels` are
  * forwarded to VirtualGrid, which localizes the embedded vertical bar, the horizontal bar and the
  * degenerate-band "No items" — no lang attribute, no new data-* hook.
@@ -55,6 +63,13 @@
  * `aria-readonly="true"` + `data-aqsp-readonly=""` を `isReadOnlyCell` ヘルパ経由で条件スタンプ
  * する (ADR-31 — パッケージ CSS なし。能力未宣言 = O(1) false = キー不在 = DOM バイト同一)。
  *
+ * アクセシビリティの構造 (v0.16): 本体の包みが唯一の `role="grid"` (行数 / 列数・`labelledBy` か組み込みのルートの名前による
+ * 名前・`readOnly` からの `aria-readonly`。セルが `aria-selected` を持たないので `aria-multiselectable` は付けず、選択は
+ * live region が読み上げる) で、VirtualGrid がその中に描く先頭の凍結・スクロール・末尾の凍結の
+ * ペインを全て持つ。スクロールのペインの中身の要素は本体の `rowgroup`、先頭 `headerRows` 行のセルは `columnheader`
+ * (`data-aqsp-header-row`)、両方のスクロールバーはポインタ専用 (`enableArrowButtonTabStops: false` — キーボードのスクロールは
+ * グリッドが持つ) と宣言し、`scrollbar` / `button` をグリッドの子にしない。
+ *
  * UI クロームロケール: 解決済み `locale` と値安定なエンジン部分集合 `scrollLabels` を VirtualGrid へ
  * 素通しし、埋込み縦バー・横バー・退化帯の "No items" を現地化する (lang 属性・新規 data-* フックなし)。
  */
@@ -83,6 +98,15 @@ const ALIGN_ONLY_STYLES: Readonly<Record<CellAlign, CellStyle>> = Object.freeze(
     right: Object.freeze({ justifyContent: alignToJustify("right") }),
 })
 
+/**
+ * The scrolling pane's content element is the row group of the body rows; the `role="grid"` element is the body wrapper,
+ * which contains the frozen leading pane, the scrolling pane and the frozen trailing pane, so every row has the grid as
+ * an ancestor.
+ * スクロールするペインの中身の要素は本体の行の行グループ。`role="grid"` は本体の包みが持ち、先頭の凍結のペイン・スクロールの
+ * ペイン・末尾の凍結のペインを全て含むので、どの行もグリッドを祖先に持つ。
+ */
+const BODY_ROWGROUP_PROPS = Object.freeze({ role: "rowgroup" }) as { readonly role: "rowgroup" }
+
 /** Whole-Map clearing threshold of the canonical-JSON style intern (the CF memo's bound). / 正準 JSON style intern の全消去しきい値 (CF memo と同じ上限)。 */
 export const STYLE_INTERN_LIMIT = 4096
 
@@ -287,6 +311,14 @@ type GridBodyProps = {
     frozenTrailingColumns: number
     /** Trailing frozen rows (v0.9 — VirtualGrid frozenTrailingRows engine-validated pass-through; the row twin). / 末尾凍結行数 (v0.9 — frozenTrailingRows のエンジン検証素通し。行双子)。 */
     frozenTrailingRows: number
+    /** Leading rows whose cells are column headers (validated by the root against frozenRows). / セルが列の見出しになる先頭の行数 (root が frozenRows と照らして検証済み)。 */
+    headerRows: number
+    /** The id naming the grid (`aria-labelledby` of the `role="grid"` element), or undefined. / グリッドに名前を与える id (`role="grid"` の要素の `aria-labelledby`)。無ければ undefined。 */
+    labelledBy: string | undefined
+    /** The grid's own name (`aria-label`) when no `labelledBy` names it, else undefined. / `labelledBy` が無いときのグリッド自身の名前 (`aria-label`)。あれば undefined。 */
+    gridLabel: string | undefined
+    /** Whole-grid read-only (`aria-readonly` of the `role="grid"` element). / グリッド全体の読み取り専用 (`role="grid"` の要素の `aria-readonly`)。 */
+    readOnly: boolean
     renderCell?: (ctx: RenderCellContext) => ReactNode
     /** 2D scroll notification from the grid handle (the truth — §7-4). / グリッドハンドル発の 2 軸スクロール通知 (§7-4 の真実側)。 */
     onScroll: (position: { x: number; y: number }) => void
@@ -382,6 +414,10 @@ const GridBodyInner = ({
     frozenRows,
     frozenTrailingColumns,
     frozenTrailingRows,
+    headerRows,
+    labelledBy,
+    gridLabel,
+    readOnly,
     renderCell,
     onScroll,
     onRangeChange,
@@ -424,14 +460,14 @@ const GridBodyInner = ({
     const getRowHeight = useCallback((row: number) => rowAxis.sizeOf(row), [rowAxis])
     const getColWidth = useCallback((col: number) => colAxis.sizeOf(col), [colAxis])
     const getCell = useCallback((row: number, col: number) => adapter.getCellText(row, col), [adapter])
-    // ARIA コンテナ属性 (identity は行列数にのみ追随)。型は行側と同型の狭い contentProps
-    const contentProps = useMemo(() => ({ role: "grid", "aria-rowcount": adapter.rowCount, "aria-colcount": adapter.colCount, "aria-multiselectable": true }) as const, [adapter.rowCount, adapter.colCount])
     // 挙動オプション: 行木は identity 変化で再構築 (軸再構築追随)、列幅木も対称 + defaultColWidth
     // (§7-8 — サンプリング省略の Fenwick baseValue)。pointerDragInputs はペン / タッチのみ
     // (マウスドラッグは選択エンジンの所有)
     const behaviorOptions = useMemo(() => ({ enableKeyboardNavigation: false, pointerDragInputs: ["pen", "touch"] as const, resetOnGetItemHeightChange: true, resetOnGetColWidthChange: true, defaultColWidth: defaultColumnWidth }), [defaultColumnWidth])
     // タップサークル素通し (v0.10 §2.1): 未指定は undefined キー同乗 = エンジン宣言の不在信号
-    const scrollBarOptions = useMemo(() => ({ width: SPREADSHEET_SCROLLBAR_SIZE_PX, tapScrollCircleOptions }), [tapScrollCircleOptions])
+    // 矢印の Tab の止まり先は false: キーボードのスクロールはグリッド自身 (シンク) が持つので、バーはネイティブのスクロールバーと同じ
+    // ポインタ専用の部品になり (aria-hidden)、role="grid" の中に許されない子 (scrollbar・button) を作らない
+    const scrollBarOptions = useMemo(() => ({ width: SPREADSHEET_SCROLLBAR_SIZE_PX, tapScrollCircleOptions, enableArrowButtonTabStops: false }), [tapScrollCircleOptions])
     // 表示値書式の掛け金 (getCellProps が書き、同じセルの children が直後に消費 — 番兵は届かない座標)
     const displayLatchRef = useRef<DisplayLatch>({ row: -1, col: -1, value: undefined })
     /**
@@ -446,9 +482,10 @@ const GridBodyInner = ({
      */
     const getCellProps = useCallback(
         (row: number, col: number) => {
+            const isHeader = row < headerRows
             const base = {
                 // aria-rowindex は行ラッパーと重複出力 (合法な上位集合) — セル単独が AT に読まれた際の行文脈補助 (§10-1)
-                role: "gridcell",
+                role: isHeader ? "columnheader" : "gridcell",
                 "aria-rowindex": row + 1,
                 "aria-colindex": col + 1,
                 "data-aqsp-cell": "",
@@ -460,6 +497,7 @@ const GridBodyInner = ({
                 // 単一居住 — layer-2 census)。未宣言 = O(1) false = キー不在 = v0.9 と DOM バイト同一、
                 // 宣言ホストは塗りセル毎 1 述語読み (ADR-31 の登記コスト)
                 ...(isReadOnlyCell(adapter, row, col) ? { "aria-readonly": "true", "data-aqsp-readonly": "" } : {}),
+                ...(isHeader ? { "data-aqsp-header-row": "" } : {}),
             }
             // v0.12 ホスト属性の継ぎ目: resolveCellAttributes が予約キー (data-aqsp* / data-row /
             // data-col) と非 data-* を fail-fast 済みなのでパッケージ属性と衝突しない。未宣言は
@@ -477,7 +515,7 @@ const GridBodyInner = ({
             }
             return (rich.style === null ? { ...stamped, ...rich.attrs } : { ...stamped, ...rich.attrs, style: rich.style }) as HTMLAttributes<HTMLDivElement>
         },
-        [adapter, rowAxis, colAxis, cf],
+        [adapter, rowAxis, colAxis, cf, headerRows],
     )
     /** Row attribute surface — carries the engine event gate (data-aqsp-cells §6.4.3-1). / 行属性面 — エンジンのイベントゲート (data-aqsp-cells) を運ぶ。 */
     const getRowProps = useCallback(
@@ -518,11 +556,18 @@ const GridBodyInner = ({
     )
 
     return (
+        // biome-ignore lint/a11y/useSemanticElements: <table> を描けない — 行は VirtualGrid が 3 つのペインに仮想化して描き、表の構造要素の入れ子を作れないため、ARIA の grid で全ての行を包む
         <div
             ref={bodyRef}
             className="aqsp-body"
             data-aqsp-body=""
             data-testid={testId ? `${testId}-body` : undefined}
+            role="grid"
+            aria-rowcount={adapter.rowCount}
+            aria-colcount={adapter.colCount}
+            aria-label={gridLabel}
+            aria-labelledby={labelledBy}
+            aria-readonly={readOnly ? "true" : undefined}
             onPointerDownCapture={(event) => {
                 // バー帯の統合ゲート (§6.8-3 — v0.4 でスクロールバー 2 本ともグリッド内在化):
                 // セル領域 (data-aqsp-cells) 由来は選択エンジンの所有 — 素通し。それ以外 (縦バー /
@@ -574,7 +619,7 @@ const GridBodyInner = ({
                 getCell={getCell}
                 getCellProps={getCellProps}
                 getRowProps={getRowProps}
-                contentProps={contentProps}
+                contentProps={BODY_ROWGROUP_PROPS}
                 behaviorOptions={behaviorOptions}
                 scrollBarOptions={scrollBarOptions}
                 overscanRows={overscanRows}

package/src/header/resizeGates.ts

@@ -55,6 +55,40 @@ export const MAX_TRACK_SIZE_PX = 10_000
  */
 export const ROW_FANOUT_DIVISOR = 10
 
+/**
+ * The ratio of one keyboard resize step: the zoom ladder's 2^(1/4), so four presses double a track and four halve it,
+ * at every size.
+ * キーボードの寸法の 1 段の比。拡大率の段と同じ 2^(1/4) で、どの寸法でも 4 回で 2 倍、4 回で半分になる。
+ */
+const KEYBOARD_RESIZE_RATIO = 2 ** (1 / 4)
+
+/**
+ * The size one keyboard step gives a track (increaseColumnWidth / decreaseColumnWidth / increaseRowHeight /
+ * decreaseRowHeight): `size × 2^(1/4)` up and `size / 2^(1/4)` down, rounded to whole px, moving at least 1 px, never
+ * below 1 px (a step never hides a track) and never above MAX_TRACK_SIZE_PX. A track already at a bound keeps its size:
+ * a hidden track (0 px) stays hidden in both directions (only unhide restores it), and growing never shrinks a track a
+ * host made wider than MAX_TRACK_SIZE_PX.
+ * キーボードの 1 段がトラックに与える寸法。上は `size × 2^(1/4)`、下は `size / 2^(1/4)` を整数 px に丸め、少なくとも 1 px 動き、
+ * 1 px を下回らず (1 段でトラックを隠さない)、MAX_TRACK_SIZE_PX を超えない。端にあるトラックは寸法を保つ: 隠れたトラック (0 px)
+ * はどちらの向きでも隠れたまま (戻すのは再表示だけ)、ホストが MAX_TRACK_SIZE_PX より広くしたトラックを大きくする向きで縮めない。
+ *
+ * @param size - The track's current size in px. トラックの今の寸法 (px)。
+ * @param direction - 1 to grow, -1 to shrink. 大きくするなら 1、小さくするなら -1。
+ * @returns The new size in px. 新しい寸法 (px)。
+ */
+export const keyboardStepSize = (size: number, direction: 1 | -1): number => {
+    if (size <= 0) {
+        return size
+    }
+    if (direction > 0) {
+        if (size >= MAX_TRACK_SIZE_PX) {
+            return size
+        }
+        return Math.min(MAX_TRACK_SIZE_PX, Math.max(size + 1, Math.round(size * KEYBOARD_RESIZE_RATIO)))
+    }
+    return Math.max(1, Math.min(size - 1, Math.round(size / KEYBOARD_RESIZE_RATIO)))
+}
+
 /** One track-size entry of a resize batch (size in logical px, 0 = hidden). / リサイズバッチの 1 entry (論理 px、0 = 非表示)。 */
 export type ResizeEntry = { index: number; size: number }