@aiquants/spreadsheet 0.15.0 → 0.16.1

package/src/tsv.ts

@@ -1,13 +1,20 @@
 /**
- * @fileoverview The TSV codec the grid copies and pastes with (Excel's real behaviour: one trailing line terminator
- * dropped, empty text read as one empty cell, ragged rows padded with "", only fields holding a tab or a line break
- * quoted), React-free, so a host reads or writes 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 two functions.
+ * @fileoverview The TSV codec the grid copies and pastes with (one trailing line terminator dropped, empty text read as
+ * one empty cell, ragged rows padded with "", a field quoted when it holds a tab or a line break or starts with `"`, so
+ * `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 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`.
  *
- * グリッドがコピーと貼り付けに使う TSV の符号化 (Excel の実際の振る舞い: 末尾の改行 1 つを除く・空の文字は空のセル 1 つ・
- * 不揃いの行は "" で埋める・引用符で囲むのはタブか改行を含む値だけ) を React を読まずに渡すモジュール。ホストがグリッドを
- * 読み込む前に (サーバーで描く代わりの表、遅延で読み込むグリッド) グリッドの文字を読み書きできる。グリッドを読み込まない
- * `@aiquants/spreadsheet/tsv` として公開し、barrel も同じ 2 つの関数を公開する。
+ * グリッドがコピーと貼り付けに使う TSV の符号化 (末尾の改行 1 つを除く・空の文字は空のセル 1 つ・不揃いの行は "" で埋める・
+ * タブか改行を含むか `"` で始まる値を引用符で囲むので、文字列の少なくとも 1 × 1 のどの矩形行列 `m` でも `parseTsv(serializeTsv(m))` が `m` に
+ * 等しい) と寸法の走査 `measureTsv` (`parseTsv` が組む行 × 列を、組まずに返す) を React を読まずに渡すモジュール。ホストが
+ * グリッドを読み込む前に (サーバーで描く代わりの表、遅延で読み込むグリッド) グリッドの文字を読み書きし寸法を測れる。グリッドを
+ * 読み込まない `@aiquants/spreadsheet/tsv` として公開し、barrel も同じ 6 つの関数を公開する (`iterateTsvRows` は行を遅延で、埋めずに出し、
+ * `iterateTsvPrefixRows` は TSV の先頭だけかもしれない文字の行のうち、続きが変えられない行を出す)。クリップボードの text/plain は
+ * Excel の形の `serializeClipboardTsv`、ファイルと保存する本文は厳密な `serializeTsv` を使う。
  */
-export { parseTsv, serializeTsv } from "./clipboard/tsv.ts"
+export { iterateTsvPrefixRows, iterateTsvRows, measureTsv, parseTsv, serializeClipboardTsv, serializeTsv } from "./clipboard/tsv.ts"

package/src/view.ts

@@ -1,13 +1,18 @@
 /**
- * @fileoverview The grid's fixed view geometry and its zoom rules, React-free, so a host can size a box for the grid and
- * drive the zoom from its own controls with exactly the numbers the grid itself uses. Published as
- * `@aiquants/spreadsheet/view`, which loads none of the grid.
+ * @fileoverview The grid's fixed view geometry, its defaults and its zoom ladder, React-free, so a host can size a box
+ * for the grid, paint a static stand-in of its first screen (column letters through `columnIndexToName`) and drive the
+ * zoom from its own controls with exactly the numbers the grid itself uses (each value is defined once here and the
+ * grid reads it from here). Published as `@aiquants/spreadsheet/view`, which loads none of the grid: its only module
+ * dependency is the column-name codec, which imports nothing.
  *
- * グリッドの固定の寸法と拡大率の規則 (React を読まない)。ホストがグリッドの箱の大きさを決め、自前の操作部品から拡大率を
- * 動かすときに、グリッド自身と同じ数を使えるようにするモジュール。グリッドを読み込まない `@aiquants/spreadsheet/view` として
- * 公開する。
+ * グリッドの固定の寸法・既定値・拡大率の段 (React を読まない)。ホストがグリッドの箱の大きさを決め、最初の画面の静的な代わり
+ * (列名は `columnIndexToName`) を描き、自前の操作部品から拡大率を動かすときに、グリッド自身と同じ数を使えるようにする
+ * モジュール (値はどれもここで 1 度だけ定義し、グリッドもここから読む)。グリッドを読み込まない `@aiquants/spreadsheet/view` と
+ * して公開する。読むモジュールは何も import しない列名の符号化だけ。
  */
 
+export { columnIndexToName } from "./header/columnName.ts"
+
 /** The height of the column-header band in CSS px (`--aqsp-col-header-height` in the stylesheet). 列見出しの帯の高さ (CSS px。スタイルシートの `--aqsp-col-header-height`)。 */
 export const SPREADSHEET_COLUMN_HEADER_HEIGHT_PX = 24
 
@@ -21,6 +26,16 @@ export const SPREADSHEET_ROW_HEADER_WIDTH_PX = 64
  */
 export const SPREADSHEET_SCROLLBAR_SIZE_PX = 12
 
+/** The default column width in CSS px, the width of every column the host does not size. 既定の列幅 (CSS px。ホストが寸法を決めない列の幅)。 */
+export const SPREADSHEET_DEFAULT_COLUMN_WIDTH_PX = 100
+
+/**
+ * The default of `maxOperationCells` (ADR-12): the largest number of cells one operation (paste, fill, clear, format)
+ * may touch before the grid refuses it.
+ * `maxOperationCells` の既定値 (ADR-12)。1 つの操作 (貼り付け・フィル・消去・書式) が触れてよいセル数の上限で、超えるとグリッドが拒む。
+ */
+export const SPREADSHEET_MAX_OPERATION_CELLS = 100_000
+
 /** The smallest package zoom. パッケージの拡大率の下限。 */
 export const SPREADSHEET_ZOOM_MIN = 0.25
 
@@ -48,15 +63,53 @@ export const clampSpreadsheetZoom = (value: number): number => {
 }
 
 /**
- * The 0.1-grid step of the zoom gestures (Alt+Wheel and Ctrl+Alt+= / -), unclamped and free of float drift. From an
- * off-grid value (the 0.25 bound or a host's 1.25) the step lands on the nearest detent in the travel direction (0.25
- * goes to 0.3 up and 0.2 down); rounding would skip a detent (0.25 to 0.4). Clamp the result with clampSpreadsheetZoom.
- * 拡大縮小の操作 (Alt+ホイールと Ctrl+Alt+= / -) の 0.1 刻み (範囲で切らず、浮動小数のずれを持ち込まない)。刻みの外の値
- * (下限の 0.25 やホストの 1.25) からは、進む向きの最寄りの刻みへ着く (0.25 から上は 0.3、下は 0.2)。丸めると刻みを飛ばす
- * (0.25 から 0.4) ため使わない。結果は clampSpreadsheetZoom で切る。
+ * The ratio between neighbouring steps of the zoom ladder: four steps double the zoom.
+ * 拡大率の段の隣どうしの比。4 段で拡大率が 2 倍になる。
+ */
+const ZOOM_LADDER_RATIO = 2 ** (1 / 4)
+
+/**
+ * The grid every ladder step is rounded to: hundredths, so each step reads as a whole percentage.
+ * 段の値を丸める格子。100 分の 1 で、どの段も整数の百分率として読める。
+ */
+const ZOOM_LADDER_GRID = 100
+
+/**
+ * The zoom ladder of the gestures (Alt+Wheel and Ctrl+Alt+= / -): the geometric series `2^(k/4)` for every integer `k`
+ * from −8 to 8, rounded to hundredths, so it runs from SPREADSHEET_ZOOM_MIN (0.25) through 1 to SPREADSHEET_ZOOM_MAX (4)
+ * in steps of about 19 % and every power of two is a step.
+ * 拡大縮小の操作 (Alt+ホイールと Ctrl+Alt+= / -) の段。−8 から 8 までの整数 `k` の等比数列 `2^(k/4)` を 100 分の 1 に丸めた
+ * もので、SPREADSHEET_ZOOM_MIN (0.25) から 1 を通って SPREADSHEET_ZOOM_MAX (4) まで約 19 % ずつ進み、2 の累乗はどれも段に乗る。
+ */
+export const SPREADSHEET_ZOOM_STEPS: readonly number[] = Object.freeze(Array.from({ length: 17 }, (_, index) => Math.round(ZOOM_LADDER_RATIO ** (index - 8) * ZOOM_LADDER_GRID) / ZOOM_LADDER_GRID))
+
+/**
+ * The tolerance under which a zoom counts as standing on a ladder step, so a value that carries float drift (0.59 + 1e-12)
+ * moves to the next step instead of the one it already shows.
+ * 拡大率が段の上にあるとみなす許容差。浮動小数のずれを持つ値 (0.59 + 1e-12) が、すでに表している段でなく次の段へ動くための幅。
+ */
+const ZOOM_STEP_TOLERANCE = 1e-9
+
+/**
+ * The next step of SPREADSHEET_ZOOM_STEPS in the travel direction, from any finite value, including a value off the
+ * ladder (a host's 1.25 goes to 1.41 up and 1.19 down). The input is clamped first, as clampSpreadsheetZoom does, and
+ * the step is taken from the clamped value: 9 zooms out to 3.36 and 0.01 zooms in to 0.3, and at a bound the result stays
+ * at that bound (in from SPREADSHEET_ZOOM_MAX, out from SPREADSHEET_ZOOM_MIN). A non-finite value fails fast.
+ * 進む向きの SPREADSHEET_ZOOM_STEPS の次の段を返す処理。段の外の値 (ホストの 1.25 は上で 1.41、下で 1.19) を含む、どの有限の
+ * 値からでも求める。入力を先に clampSpreadsheetZoom と同じく範囲へ切り、切った値から一歩進む (9 からの縮小は 3.36、0.01 からの
+ * 拡大は 0.3)。端では端に留まる (SPREADSHEET_ZOOM_MAX からの拡大、SPREADSHEET_ZOOM_MIN からの縮小)。有限でない値はすぐに投げる。
  *
  * @param value - The current zoom. 今の拡大率。
  * @param direction - 1 to zoom in, -1 to zoom out. 拡大は 1、縮小は -1。
- * @returns The next detent in that direction. その向きの次の刻み。
+ * @returns The next ladder step in that direction from the clamped input. 範囲へ切った入力からのその向きの次の段。
+ * @throws {RangeError} When the value is not finite. 有限でない場合。
  */
-export const stepSpreadsheetZoom = (value: number, direction: 1 | -1): number => (direction > 0 ? (Math.floor(value * 10 + 1e-6) + 1) / 10 : (Math.ceil(value * 10 - 1e-6) - 1) / 10)
+export const stepSpreadsheetZoom = (value: number, direction: 1 | -1): number => {
+    const current = clampSpreadsheetZoom(value)
+    if (direction > 0) {
+        const next = SPREADSHEET_ZOOM_STEPS.find((step) => step > current + ZOOM_STEP_TOLERANCE)
+        return next === undefined ? SPREADSHEET_ZOOM_MAX : next
+    }
+    const previous = SPREADSHEET_ZOOM_STEPS.findLast((step) => step < current - ZOOM_STEP_TOLERANCE)
+    return previous === undefined ? SPREADSHEET_ZOOM_MIN : previous
+}

package/dist/tsv-B6TDExlk.js

@@ -1,91 +0,0 @@
-const o = (e) => (
-  // 終端 CRLF は必須 (Excel 実挙動)。parseTsv の「終端の改行 1 つを剥がす」規約と対 —
-  // 終端なしだと [["a"],[""]] が [["a"]] に潰れ (cut-move で clear されるべき先に旧値が残る)、
-  // [[""]] は "" になって §6.5.4-5 の空ガードに飲まれ「空セル貼り付けで clear」が不発になる
-  `${e.map((l) => l.map(h).join("	")).join(`\r
-`)}\r
-`
-), h = (e) => /[\t\r\n]/.test(e) ? `"${e.replaceAll('"', '""')}"` : e, u = (e) => e.endsWith(`\r
-`) ? e.slice(0, -2) : e.endsWith(`
-`) || e.endsWith("\r") ? e.slice(0, -1) : e, a = (e, l, t) => {
-  let n = 0;
-  for (; ; ) {
-    let s;
-    if (e[n] === '"') {
-      const r = f(e, n);
-      if (r !== null)
-        s = r.value, n = r.nextIndex;
-      else {
-        const i = c(e, n);
-        s = e.slice(n, i), n = i;
-      }
-    } else {
-      const r = c(e, n);
-      s = e.slice(n, r), n = r;
-    }
-    if (l(s), n >= e.length) {
-      t();
-      return;
-    }
-    e[n] === "	" ? n += 1 : (n += e[n] === "\r" && e[n + 1] === `
-` ? 2 : 1, t());
-  }
-}, p = (e) => {
-  const l = u(e);
-  if (l === "")
-    return [[""]];
-  const t = [];
-  let n = [];
-  a(
-    l,
-    (r) => {
-      n.push(r);
-    },
-    () => {
-      t.push(n), n = [];
-    }
-  );
-  let s = 0;
-  for (const r of t)
-    r.length > s && (s = r.length);
-  return t.map((r) => r.length === s ? r : [...r, ...Array(s - r.length).fill("")]);
-}, g = (e) => {
-  const l = u(e);
-  if (l === "")
-    return { rows: 1, cols: 1 };
-  let t = 0, n = 0, s = 0;
-  return a(
-    l,
-    () => {
-      s += 1;
-    },
-    () => {
-      t += 1, s > n && (n = s), s = 0;
-    }
-  ), { rows: t, cols: n };
-}, f = (e, l) => {
-  let t = "", n = l + 1;
-  for (; n < e.length; )
-    if (e[n] === '"')
-      if (e[n + 1] === '"')
-        t += '"', n += 2;
-      else {
-        const s = n + 1;
-        return (s >= e.length || e[s] === "	" || e[s] === `
-` || e[s] === "\r") && /[\t\r\n]/.test(t) ? { value: t, nextIndex: s } : null;
-      }
-    else
-      t += e[n], n += 1;
-  return null;
-}, c = (e, l) => {
-  for (let t = l; t < e.length; t += 1)
-    if (e[t] === "	" || e[t] === `
-` || e[t] === "\r")
-      return t;
-  return e.length;
-};
-export {
-  g as m,
-  p,
-  o as s
-};

package/dist/tsv-BHXbWK5W.cjs

@@ -1,8 +0,0 @@
-"use strict";const h=e=>`${e.map(l=>l.map(f).join("	")).join(`\r
-`)}\r
-`,f=e=>/[\t\r\n]/.test(e)?`"${e.replaceAll('"','""')}"`:e,u=e=>e.endsWith(`\r
-`)?e.slice(0,-2):e.endsWith(`
-`)||e.endsWith("\r")?e.slice(0,-1):e,a=(e,l,t)=>{let n=0;for(;;){let s;if(e[n]==='"'){const r=p(e,n);if(r!==null)s=r.value,n=r.nextIndex;else{const i=c(e,n);s=e.slice(n,i),n=i}}else{const r=c(e,n);s=e.slice(n,r),n=r}if(l(s),n>=e.length){t();return}e[n]==="	"?n+=1:(n+=e[n]==="\r"&&e[n+1]===`
-`?2:1,t())}},o=e=>{const l=u(e);if(l==="")return[[""]];const t=[];let n=[];a(l,r=>{n.push(r)},()=>{t.push(n),n=[]});let s=0;for(const r of t)r.length>s&&(s=r.length);return t.map(r=>r.length===s?r:[...r,...Array(s-r.length).fill("")])},g=e=>{const l=u(e);if(l==="")return{rows:1,cols:1};let t=0,n=0,s=0;return a(l,()=>{s+=1},()=>{t+=1,s>n&&(n=s),s=0}),{rows:t,cols:n}},p=(e,l)=>{let t="",n=l+1;for(;n<e.length;)if(e[n]==='"')if(e[n+1]==='"')t+='"',n+=2;else{const s=n+1;return(s>=e.length||e[s]==="	"||e[s]===`
-`||e[s]==="\r")&&/[\t\r\n]/.test(t)?{value:t,nextIndex:s}:null}else t+=e[n],n+=1;return null},c=(e,l)=>{for(let t=l;t<e.length;t+=1)if(e[t]==="	"||e[t]===`
-`||e[t]==="\r")return t;return e.length};exports.measureTsv=g;exports.parseTsv=o;exports.serializeTsv=h;