npm - @aiquants/spreadsheet - Versions diffs - 0.8.0 - Mend

@aiquants/spreadsheet 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (68) hide show

package/CHANGELOG.md +1103 -0
package/LICENSE.md +155 -0
package/README.md +817 -0
package/dist/index.cjs +21 -0
package/dist/index.d.cts +1960 -0
package/dist/index.d.ts +1960 -0
package/dist/index.js +7711 -0
package/dist/styles/spreadsheet.css +2 -0
package/dist/styles/spreadsheet.standalone.css +3 -0
package/package.json +94 -0
package/src/Spreadsheet.tsx +2313 -0
package/src/clipboard/clipPayload.ts +1242 -0
package/src/clipboard/fixtures/excel.fixture.ts +301 -0
package/src/clipboard/fixtures/html.fixture.ts +90 -0
package/src/clipboard/fixtures/sheets.fixture.ts +83 -0
package/src/clipboard/htmlInterop.ts +1694 -0
package/src/clipboard/numberFormatCodec.ts +870 -0
package/src/clipboard/pasteSpecial.ts +608 -0
package/src/clipboard/tiling.ts +370 -0
package/src/clipboard/tsv.ts +186 -0
package/src/clipboard/useClipboard.ts +1154 -0
package/src/commands/selfCalc.ts +279 -0
package/src/commands/useCommands.ts +946 -0
package/src/editor/useCellEditor.ts +708 -0
package/src/grid/CellView.tsx +51 -0
package/src/grid/GridBody.tsx +489 -0
package/src/header/ColumnHeader.tsx +167 -0
package/src/header/RowHeader.tsx +144 -0
package/src/header/columnName.ts +31 -0
package/src/header/resizeGates.ts +146 -0
package/src/header/resizeStrips.ts +79 -0
package/src/header/useHeaderResize.ts +598 -0
package/src/header/useHeaderSelection.ts +454 -0
package/src/index.ts +122 -0
package/src/keyboard/compositionGuard.ts +53 -0
package/src/keyboard/ensureCellVisible.ts +77 -0
package/src/keyboard/shortcuts.ts +718 -0
package/src/keyboard/useGridKeyboard.ts +940 -0
package/src/model/axisModel.ts +186 -0
package/src/model/cellAnnotations.ts +92 -0
package/src/model/cellCoord.ts +114 -0
package/src/model/cellFormat.ts +562 -0
package/src/model/cellPaint.ts +537 -0
package/src/model/conditionalFormat.ts +805 -0
package/src/model/dataAdapter.ts +478 -0
package/src/model/dataValidation.ts +542 -0
package/src/model/formulaRefs.ts +984 -0
package/src/model/frozenPartition.ts +100 -0
package/src/model/labels.ts +228 -0
package/src/model/viewStore.ts +124 -0
package/src/overlay/SelectionOverlay.tsx +1425 -0
package/src/overlay/useFillHandle.ts +432 -0
package/src/popover/CommentPopover.tsx +109 -0
package/src/popover/LinkPopover.tsx +108 -0
package/src/popover/ListPopover.tsx +161 -0
package/src/popover/MessagePopover.tsx +36 -0
package/src/popover/NotePopover.tsx +106 -0
package/src/popover/NoteTip.tsx +26 -0
package/src/popover/PopoverLayer.tsx +210 -0
package/src/popover/placement.ts +138 -0
package/src/popover/usePopovers.ts +642 -0
package/src/selection/selectionState.ts +239 -0
package/src/selection/useAutoScroller.ts +226 -0
package/src/selection/usePointDrag.ts +273 -0
package/src/selection/useSelectionEngine.ts +687 -0
package/src/styles/components.entry.css +10 -0
package/src/styles/spreadsheet.css +1029 -0
package/src/styles/standalone.entry.css +9 -0

package/src/clipboard/fixtures/excel.fixture.ts ADDED Viewed

@@ -0,0 +1,301 @@
+/**
+ * @fileoverview Microsoft Excel clipboard `text/html` fixtures for htmlInterop.spec.ts (v0.8 §5.1 /
+ * §5.3). Real Excel captures are queued for a human (§5.3); every export here is a HAND-WRITTEN
+ * reconstruction that follows the research map's verified skeleton (Excel 15 desktop: `<style>`
+ * block outside the fragment, `.xl##` classes, `mso-number-format` escaping with `\0022`,
+ * `mso-ignore:colspan`, `mso-spacerun`, `<col width span>`, `<tr height style='height:Npt'>`;
+ * Excel 2002: `x:num` / `x:str` / `x:bool` / `x:err` / `x:fmla`; Excel for the web: the
+ * `ccp_infra` wrapper and Chrome's double fragment). Indentation uses spaces (the workspace bans
+ * tab characters) and line ends are LF; the CRLF form is derived in the spec. `String.raw` keeps
+ * every CSS backslash verbatim. Test-only: no package source imports this directory.
+ *
+ * Microsoft Excel のクリップボード `text/html` フィクスチャ (htmlInterop.spec.ts 用、v0.8 §5.1 /
+ * §5.3)。実 Excel キャプチャは人手キュー (§5.3) のため、全 export は研究マップの検証済み骨格
+ * (Excel 15 デスクトップ / Excel 2002 の `x:*` / Excel for the web) に従う手書き再構成。字下げは
+ * 空白 (タブ禁止)、行末は LF (CRLF 形は spec 側で派生)。`String.raw` で CSS の逆斜線を保つ。
+ */
+/**
+ * Excel 15 (Microsoft 365 desktop) skeleton, composed per research map §2 / §10 (verified
+ * fragments from public dumps: Qiita 2019, Froala #2028, CKEditor 4 `Table_excel/office365`).
+ * 4 rows × 5 columns: header row with `.xl65` (white bold centred, all-round thin borders, fill +
+ * `mso-pattern`), a `colspan=2` spill flagged `mso-ignore:colspan`, an `&nbsp;` empty cell; a
+ * user-sized row (`36.5pt` → 49 px) with a `rowspan=2` anchor, the shared-border form
+ * (`border-top:none;border-left:none` inline), `mso-number-format` classes `"\#\,\#\#0"`,
+ * `"0\.0%"` + italic, the accounting pattern with `\0022` and `\;` inside the CSS string plus an
+ * `mso-spacerun` span; a row with `"Short Date"`, a hyperlink class, a `<br>` + CRLF-style
+ * indentation cell with wrap / top / Times New Roman 9pt / line-through / `1.0pt dashed red`,
+ * a `"\@"` text cell with a `hairline` border; and a HIDDEN row (`display:none`) with an escaped
+ * date pattern `"yyyy\\-mm\\-dd"`, a whole-cell `<font class=font6>` run, a partial run, a
+ * `<ruby><rt>` phonetic guide and an unknown class. Reconstruction 2026-09-05, licence n/a.
+ * Excel 15 (Microsoft 365 デスクトップ) の骨格 (研究マップ §2 / §10 の検証済み断片に基づく再構成)。
+ * 4 行 × 5 列: `.xl65` 見出し (白太字中央・全周 thin・塗り + mso-pattern)、`mso-ignore:colspan`
+ * の溢れ、`&nbsp;` 空セル、ユーザー行高 (36.5pt → 49px) の `rowspan=2`、共有罫線形、数値書式
+ * クラス 3 種 (`\0022` / `\;` 入り会計形 + spacerun)、Short Date、リンク、`<br>` + 字下げ、
+ * `"\@"` + hairline、非表示行 (エスケープ日付・全体 `<font>` run・部分 run・ruby・未知クラス)。
+ */
+export const EXCEL_DESKTOP_15 = String.raw`<html xmlns:v="urn:schemas-microsoft-com:vml"
+xmlns:o="urn:schemas-microsoft-com:office:office"
+xmlns:x="urn:schemas-microsoft-com:office:excel"
+xmlns="http://www.w3.org/TR/REC-html40">
+<head>
+<meta http-equiv=Content-Type content="text/html; charset=utf-8">
+<meta name=ProgId content=Excel.Sheet>
+<meta name=Generator content="Microsoft Excel 15">
+<link id=Main-File rel=Main-File
+href="file:///C:/Users/XXXXX/AppData/Local/Temp/msohtmlclip1/01/clip.htm">
+<link rel=File-List
+href="file:///C:/Users/XXXXX/AppData/Local/Temp/msohtmlclip1/01/clip_filelist.xml">
+<style>
+<!--table
+    {mso-displayed-decimal-separator:"\.";
+    mso-displayed-thousand-separator:"\,";}
+@page
+    {margin:.75in .7in .75in .7in;
+    mso-header-margin:.3in;
+    mso-footer-margin:.3in;}
+tr
+    {mso-height-source:auto;}
+col
+    {mso-width-source:auto;}
+br
+    {mso-data-placement:same-cell;}
+td
+    {padding-top:1px;
+    padding-right:1px;
+    padding-left:1px;
+    mso-ignore:padding;
+    color:black;
+    font-size:11.0pt;
+    font-weight:400;
+    font-style:normal;
+    text-decoration:none;
+    font-family:Calibri, sans-serif;
+    mso-font-charset:0;
+    mso-number-format:General;
+    text-align:general;
+    vertical-align:bottom;
+    border:none;
+    mso-background-source:auto;
+    mso-pattern:auto;
+    mso-protection:locked visible;
+    white-space:nowrap;
+    mso-rotate:0;}
+.xl65
+    {color:white;
+    font-weight:700;
+    text-align:center;
+    border:.5pt solid windowtext;
+    background:#C6E0B4;
+    mso-pattern:black none;}
+.xl66
+    {border:.5pt solid windowtext;}
+.xl67
+    {text-align:right;
+    border-top:none;
+    border-right:.5pt solid windowtext;
+    border-bottom:1.5pt solid windowtext;
+    border-left:none;}
+.xl68
+    {mso-number-format:"\#\,\#\#0";}
+.xl69
+    {mso-number-format:"0\.0%";
+    font-style:italic;}
+.xl70
+    {mso-number-format:"_-* \#\,\#\#0_-\;\\-* \#\,\#\#0_-\;_-* \0022-\0022??_-\;_-\@_-";}
+.xl71
+    {mso-number-format:"Short Date";
+    text-align:right;}
+.xl72
+    {color:#0563C1;
+    text-decoration:underline;
+    text-underline-style:single;}
+.xl73
+    {white-space:normal;
+    vertical-align:top;
+    font-family:"Times New Roman", serif;
+    font-size:9.0pt;
+    text-decoration:line-through;
+    border:1.0pt dashed red;}
+.xl74
+    {mso-number-format:"\@";
+    border-bottom:.5pt hairline windowtext;}
+.xl75
+    {mso-number-format:"yyyy\\-mm\\-dd";
+    text-align:center;}
+.font6
+    {color:red;
+    font-size:9.0pt;
+    font-weight:700;}
+-->
+</style>
+</head>
+<body link="#0563C1" vlink="#954F72">
+<table border=0 cellpadding=0 cellspacing=0 width=320 style='border-collapse:
+ collapse;width:240pt'>
+<!--StartFragment-->
+ <col width=64 span=2 style='width:48pt'>
+ <col width=93 style='mso-width-source:userset;mso-width-alt:3234;width:70pt'>
+ <col width=64 style='width:48pt' span=2>
+ <tr height=20 style='height:15.0pt'>
+  <td height=20 class=xl65 width=64 style='height:15.0pt;width:48pt'>Qty</td>
+  <td class=xl65 width=64 style='width:48pt'>Double</td>
+  <td colspan=2 class=xl65 style='mso-ignore:colspan'>Spill</td>
+  <td class=xl65 width=64 style='width:48pt'>&nbsp;</td>
+ </tr>
+ <tr height=49 style='mso-height-source:userset;height:36.5pt'>
+  <td rowspan=2 height=98 class=xl66 width=64 align=right style='height:73.0pt;width:48pt'>4000</td>
+  <td class=xl67 style='border-top:none;border-left:none'>8000</td>
+  <td class=xl68 align=right>2,728,548</td>
+  <td class=xl69 align=right>20.5%</td>
+  <td class=xl70><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>2,728,548 </td>
+ </tr>
+ <tr height=20 style='height:15.0pt'>
+  <td height=20 class=xl71 style='height:15.0pt'>2026/09/04</td>
+  <td class=xl72><a href="https://example.com/">link</a></td>
+  <td class=xl73>first<br>
+    second</td>
+  <td class=xl74>0123</td>
+ </tr>
+ <tr height=20 style='display:none;height:15.0pt'>
+  <td height=20 class=xl75 style='height:15.0pt'>2026-09-04</td>
+  <td><font class="font6">Alarm</font></td>
+  <td><font class="font6">Al</font>arm</td>
+  <td><ruby>漢<rt>かん</rt></ruby>字</td>
+  <td class=xl62></td>
+ </tr>
+<!--EndFragment-->
+</table>
+</body>
+</html>`
+/**
+ * Excel 2002-era typed attributes (research map §5, [doc] Office HTML reference — modern Excel no
+ * longer WRITES them but still READS them): `x:num` bare and valued (17-digit E notation), `x:str`
+ * on a numeric-looking string, `x:bool`, `x:err` + `x:fmla`, `x:num` + `x:fmla`, a date serial
+ * under `"Short Date"` (inline `mso-number-format`), a non-numeric `x:num` and an `x:fmla` that
+ * does not start with `=` (both must be ignored). The `<table x:str>` global default is present.
+ * Reconstruction 2026-09-05, licence n/a.
+ * Excel 2002 世代の型付き属性 (研究マップ §5、Office HTML リファレンス [doc] — 現行 Excel は書かないが
+ * 読む): 裸 / 値付き `x:num` (17 桁 E 表記)、数値風文字列の `x:str`、`x:bool`、`x:err` + `x:fmla`、
+ * `x:num` + `x:fmla`、Short Date 下の日付シリアル、非数値 `x:num` と `=` 無し `x:fmla` (無視対象)。
+ */
+export const EXCEL_2002_TYPED = String.raw`<html xmlns:x="urn:schemas-microsoft-com:office:excel">
+<head>
+<meta name=Generator content="Microsoft Excel 10">
+<style>
+<!--table
+    {mso-displayed-decimal-separator:"\.";
+    mso-displayed-thousand-separator:"\,";}
+.xl24
+    {mso-number-format:"0\.00";}
+-->
+</style>
+</head>
+<body>
+<table x:str border=0 cellpadding=0 cellspacing=0>
+ <tr>
+  <td align=right x:num>12345</td>
+  <td align=right x:num="12344.6789" class=xl24>12,344.68</td>
+  <td align=right x:num="4.6000000000000001E-4">0.00046</td>
+  <td align=right x:str>12345</td>
+  <td align=center x:bool="TRUE">TRUE</td>
+ </tr>
+ <tr>
+  <td align=center x:err="#DIV/0!" x:fmla="=AVERAGE(D3:D10)">#DIV/0!</td>
+  <td align=right x:num x:fmla="=SUM(B2:B5)">10</td>
+  <td align=right x:num="46269" style='mso-number-format:"Short Date"'>2026/09/04</td>
+  <td x:num="abc">text</td>
+  <td x:fmla="SUM(1)">1</td>
+ </tr>
+</table>
+</body>
+</html>`
+/**
+ * Excel for the web (research map §8, [verified] Bugzilla 1641019 / roosterjs / CKEditor 5 forms):
+ * Chrome's own `<html><body><!--StartFragment-->` wrapper around Office's `<div ccp_infra_…>`
+ * wrapper around a second `<html>` document with the LEAN td block (no `mso-number-format:General`,
+ * no `mso-pattern:auto`), `<table width=209 style='…'>` without border attributes, `<col width=64
+ * style='width:48pt' span=2>`, `<td width=64 height=20 style='width:48pt;height:15.0pt'>`, the
+ * `background:white;mso-pattern:black none` fill, `.5pt solid windowtext` borders and a hyperlink
+ * class with `white-space:normal`. Reconstruction 2026-09-05, licence n/a.
+ * Excel for the web (研究マップ §8): Chrome の二重フラグメント + Office の `ccp_infra` div + 内側の
+ * 第 2 `<html>` 文書 (lean td ブロック)、属性なし `<table>`、`<col span>`、td の幅 / 高さ、白塗り +
+ * mso-pattern、`.5pt solid windowtext`、`white-space:normal` 付きリンククラス。
+ */
+export const EXCEL_WEB_15 = String.raw`<html>
+<body>
+<!--StartFragment--><div ccp_infra_version='3' ccp_infra_timestamp='1693000000000' ccp_infra_user_hash='1234567890' ccp_infra_copy_id='00000000-0000-0000-0000-000000000000' data-ccp-timestamp='1693000000000'><html><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=ProgId content=Excel.Sheet><meta name=Generator content="Microsoft Excel 15"><style>
+<!--table
+    {mso-displayed-decimal-separator:"\.";
+    mso-displayed-thousand-separator:"\,";}
+tr
+    {mso-height-source:auto;}
+col
+    {mso-width-source:auto;}
+td
+    {padding-top:1px;
+    padding-right:1px;
+    padding-left:1px;
+    mso-ignore:padding;
+    color:black;
+    font-size:11.0pt;
+    font-weight:400;
+    font-style:normal;
+    text-decoration:none;
+    font-family:Calibri, sans-serif;
+    mso-font-charset:0;
+    text-align:general;
+    vertical-align:bottom;
+    border:none;
+    white-space:nowrap;
+    mso-rotate:0;}
+.xl33
+    {background:white;
+    mso-pattern:black none;
+    border:.5pt solid windowtext;}
+.xl34
+    {color:#0563C1;
+    text-decoration:underline;
+    text-underline-style:single;
+    white-space:normal;}
+-->
+</style></head><body link="#0563C1" vlink="#954F72"><table width=209 style='border-collapse:collapse;width:157pt'><!--StartFragment--><col width=64 style='width:48pt' span=2><col width=81 style='width:61pt'><tr height=20 style='height:15.0pt'><td width=64 height=20 style='width:48pt;height:15.0pt'>Plain</td><td class=xl33 width=64 style='width:48pt'>1</td><td class=xl34 width=81 style='width:61pt'><a href="https://example.com/web">web</a></td></tr><!--EndFragment--></table></body></html></div><!--EndFragment-->
+</body>
+</html>`
+/**
+ * A European-locale Excel 15 copy (research map §2: "a European dump had `\,` and `\.` swapped"):
+ * the table rule declares the DECIMAL separator `,` and the THOUSAND separator `.`, so the
+ * displayed `2.728.548,5` under `mso-number-format:"\#\,\#\#0\.0"` (patterns stay locale-neutral)
+ * recovers as `2728548.5`, and a `General` cell keeps its text. Reconstruction 2026-09-05.
+ * 欧州ロケールの Excel 15 コピー (研究マップ §2: 区切りの入替え): table 規則が小数 `,` / 桁区切り
+ * `.` を宣言し、`2.728.548,5` (パターンは locale 非依存の `#,##0.0`) が `2728548.5` に復元される。
+ */
+export const EXCEL_EUROPEAN_SEPARATORS = String.raw`<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:x="urn:schemas-microsoft-com:office:excel">
+<head>
+<meta name=Generator content="Microsoft Excel 15">
+<style>
+<!--table
+    {mso-displayed-decimal-separator:"\,";
+    mso-displayed-thousand-separator:"\.";}
+.xl66
+    {mso-number-format:"\#\,\#\#0\.0";}
+-->
+</style>
+</head>
+<body>
+<table border=0 cellpadding=0 cellspacing=0>
+ <tr height=20 style='height:15.0pt'>
+  <td class=xl66 align=right>2.728.548,5</td>
+  <td>1.234</td>
+ </tr>
+</table>
+</body>
+</html>`

package/src/clipboard/fixtures/html.fixture.ts ADDED Viewed

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Generic (non-spreadsheet) HTML table fixtures for htmlInterop.spec.ts (v0.8 §5.1):
+ * hand-written documents exercising the HTML table model and text semantics the `html` kind must
+ * honour — pretty-printed whitespace, entities, `thead` / `tfoot` / `tbody` ordering, `th`,
+ * `rowspan` / `colspan` interplay, nested tables, semantic run tags, `<font>` attributes,
+ * `bgcolor`, `white-space` modes, `<script>` / comments / `<img>` noise (no `mso-*` property —
+ * that would be an Excel marker), and a second table that must be ignored. Written 2026-09-05, licence n/a. Test-only.
+ * 汎用 HTML 表のフィクスチャ (htmlInterop.spec.ts 用、v0.8 §5.1): `html` kind が守るべき HTML 表
+ * モデルと文字列意味論 (整形済み空白・実体・thead / tfoot / tbody 順・th・rowspan / colspan の
+ * 干渉・入れ子表・意味タグ run・`<font>` 属性・bgcolor・white-space 各モード・script / コメント /
+ * img のノイズ (`mso-*` は Excel マーカーになるので含めない)・無視すべき第 2 表) を手書きで網羅。テスト専用。
+ */
+/**
+ * A pretty-printed page: a `<title>` and a paragraph mentioning `<table>` before the table, a
+ * `<caption>`, `thead` (a `th` with `colspan=2`), `tfoot` placed BEFORE `tbody` in source order
+ * (the HTML `rows` order puts it last), class rules in `<style>` (`.hot`, `td.money`), a
+ * `rowspan=2` anchor holding a whole-cell `<b>`, `bgcolor`, a `white-space: pre` cell with a
+ * `&#9;` tab, partial `<i>` / `<u>` runs, indentation + `<br>` inside a cell, a whole-cell `<a>`
+ * with a nested partial `<em>`, a nested table, a whole-cell `<font color face>`, a `<script>` and
+ * a comment inside a cell, a `white-space: pre-line` cell, an `<img>` and `&nbsp;` — then a
+ * second table that must not be read.
+ * 整形済みページ: 表の前の `<title>` / 段落、caption、thead (`colspan=2` の th)、tbody より前に
+ * 置かれた tfoot (HTML の rows 順では末尾)、`<style>` のクラス規則、`<b>` 全体 run の rowspan
+ * anchor、bgcolor、`&#9;` 入り pre セル、部分 `<i>` / `<u>`、字下げ + `<br>`、部分 `<em>` を含む
+ * 全体 `<a>`、入れ子表、全体 `<font>`、script + コメント、pre-line、img + `&nbsp;`、
+ * 読んではならない第 2 表。
+ */
+export const HTML_PRETTY_PAGE = `<!DOCTYPE html>
+<html>
+  <head>
+    <title>Not a table</title>
+    <style>
+      .hot { color: #ff0000; font-weight: bold; }
+      td.money { text-align: right; }
+    </style>
+  </head>
+  <body>
+    <p>Intro paragraph with a &lt;table&gt; mention.</p>
+    <table border="1">
+      <caption>Prices</caption>
+      <thead>
+        <tr>
+          <th>Item</th>
+          <th colspan="2">Amount &amp; unit</th>
+        </tr>
+      </thead>
+      <tfoot>
+        <tr><td>Total</td><td class="money" colspan="2">3</td></tr>
+      </tfoot>
+      <tbody>
+        <tr>
+          <td rowspan="2"><b>Apple</b></td>
+          <td class="hot money" bgcolor="#FFFF00">1</td>
+          <td style="white-space: pre">a&#9;b</td>
+        </tr>
+        <tr>
+          <td><i>two</i> <u>words</u></td>
+          <td>
+            multi
+            line   text
+            <br>
+            after break
+          </td>
+        </tr>
+        <tr>
+          <td><a href="https://example.com/a">Link <em>text</em></a></td>
+          <td><table><tr><td>n1</td><td>n2</td></tr><tr><td>n3</td></tr></table></td>
+          <td><font color="#00ff00" face="Verdana, Geneva">Green</font></td>
+        </tr>
+        <tr>
+          <td><script>alert(1)</script>Safe<!-- comment --></td>
+          <td style="white-space: pre-line">  x
+   y  </td>
+          <td><img src="x.png" alt="pic">Only text &nbsp;here</td>
+        </tr>
+      </tbody>
+    </table>
+    <table><tr><td>second table</td></tr></table>
+  </body>
+</html>`
+/**
+ * A table whose second row spans THREE columns although its first row declares only two
+ * (`rowspan` carry + two own cells): the HTML model widens the table beyond the per-row Σcolspan the
+ * estimator sees — the case the reader documents as needing a post-parse re-gate.
+ * 1 行目が 2 列しか宣言しないのに 2 行目が 3 列に広がる表 (rowspan の持ち越し + 自セル 2 つ):
+ * HTML モデルは見積もりの行毎 Σcolspan を超えて広がる — reader が事後再ゲートを求める事例。
+ */
+export const HTML_ROWSPAN_WIDENING = `<table><tr><td rowspan="2">a</td><td>b</td></tr><tr><td>c</td><td>d</td></tr></table>`

package/src/clipboard/fixtures/sheets.fixture.ts ADDED Viewed

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Google Sheets clipboard `text/html` fixtures for htmlInterop.spec.ts (v0.8 §5.1 /
+ * §5.3). Every export is a template literal (no backslash occurs in Sheets markup, so `String.raw`
+ * is not needed) whose docstring states its provenance (source, capture date, tool, licence). The MARKUP — wrapper, `<style>` block, table / col / tr / td
+ * attributes and every inline style — is byte-verbatim from the cited capture; the cell TEXTS and
+ * URLs are replaced by neutral words / `example.com` so that no third-party body text is embedded
+ * (harness rule §5.3). Fixtures are test-only: no package source imports this directory.
+ *
+ * Google Sheets のクリップボード `text/html` フィクスチャ (htmlInterop.spec.ts 用、v0.8 §5.1 /
+ * §5.3)。各 export はテンプレートリテラル (Sheets のマークアップに逆斜線は無く `String.raw` は不要)
+ * で、docstring に由来 (source / capture date / tool / licence) を記す。マークアップ (ラッパー・`<style>`・table / col / tr / td の属性・全インライン
+ * style) は引用元キャプチャのバイト通り、セル本文と URL は中立語 / `example.com` へ置換 (第三者
+ * 本文を埋め込まない — §5.3)。テスト専用でパッケージ本体からは import しない。
+ */
+/**
+ * Own live capture of a 3 × 6 range copied from Google's public "Example Spreadsheet" (anonymous
+ * viewer): the raw `paste`-event `text/html` — `<google-sheets-html-origin>` wrapper, the grid-line
+ * `<style>`, `data-sheets-root="1"` + `data-sheets-baot="1"`, `<colgroup>` pixel widths, `<tr>`
+ * pixel heights, the base td style with `vertical-align:middle;font-weight:bold;` on the header
+ * row and `vertical-align:bottom;` elsewhere, and NO `data-sheets-value` on any cell (the 2026
+ * anonymous form). Source: Google Sheets (docs.google.com), capture date 2026-09-04, tool:
+ * headless Chrome 140 via Playwright (`sweep.mjs`, paste-event sink), licence: own capture
+ * (markup verbatim, texts replaced).
+ * Google 公開「Example Spreadsheet」の 3 × 6 範囲を匿名閲覧で自前キャプチャした生の `text/html`
+ * (2026-09-04、headless Chrome 140 + Playwright)。ラッパー・罫線 `<style>`・root / baot 属性・
+ * px 列幅 / 行高・見出し行の `vertical-align:middle;font-weight:bold;`・他行の
+ * `vertical-align:bottom;`・全セルに `data-sheets-value` 無し (2026 年匿名形)。本文は置換済み。
+ */
+export const SHEETS_LIVE_2026 = `<google-sheets-html-origin><style type="text/css"><!--td {border: 1px solid #cccccc;}br {mso-data-placement:same-cell;}--></style><table xmlns="http://www.w3.org/1999/xhtml" cellspacing="0" cellpadding="0" dir="ltr" border="1" style="table-layout:fixed;font-size:10pt;font-family:arial,sans,sans-serif;width:0px;border-collapse:collapse;border:none" data-sheets-root="1" data-sheets-baot="1"><colgroup><col width="120"/><col width="120"/><col width="120"/><col width="120"/><col width="120"/><col width="120"/></colgroup><tbody><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;font-weight:bold;">Name</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;font-weight:bold;">Group</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;font-weight:bold;">Level</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;font-weight:bold;">Region</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;font-weight:bold;">Field</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;font-weight:bold;">Activity</td></tr><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">Alice</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">F</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">4. Fourth</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">North</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">Text</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">Theatre</td></tr><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">Ben</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">M</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">1. First</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">South</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">Numbers</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;">Rowing</td></tr></tbody></table>`
+/**
+ * The SAME copy as SHEETS_LIVE_2026 read back through `navigator.clipboard.read()` WITHOUT
+ * `unsanitized` — Chromium's sanitised re-serialisation: the `<style>` block is gone and its
+ * grid-line rule is inlined on every td as `border: 1px solid rgb(204, 204, 204)`, `padding`
+ * collapses to `2px 3px`, every declaration gains a space after the colon, `<col>` loses its
+ * XHTML slash, and the wrapper element carries a computed-style dump. `data-*` attributes survive
+ * in this capture (Chromium keeps them on the table). Source / date / tool / licence as above.
+ * SHEETS_LIVE_2026 と同じコピーを `unsanitized` 無しの `navigator.clipboard.read()` で読み戻した
+ * Chromium のサニタイズ再直列化形: `<style>` は消え罫線規則が全 td に
+ * `border: 1px solid rgb(204, 204, 204)` としてインライン化、`padding` は `2px 3px` に畳まれ、
+ * 宣言はコロン後に空白、`<col>` の XHTML スラッシュ消失、ラッパーに計算スタイルの羅列。
+ */
+export const SHEETS_LIVE_2026_SANITISED = `<google-sheets-html-origin style="color: rgb(0, 0, 0); font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><table xmlns="http://www.w3.org/1999/xhtml" cellspacing="0" cellpadding="0" dir="ltr" border="1" data-sheets-root="1" data-sheets-baot="1" style="table-layout: fixed; font-size: 10pt; font-family: arial, sans, sans-serif; width: 0px; border-collapse: collapse; border-width: medium; border-style: none; border-color: currentcolor; border-image: none;"><colgroup><col width="120"><col width="120"><col width="120"><col width="120"><col width="120"><col width="120"></colgroup><tbody><tr style="height: 21px;"><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: middle; font-weight: bold;">Name</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: middle; font-weight: bold;">Group</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: middle; font-weight: bold;">Level</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: middle; font-weight: bold;">Region</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: middle; font-weight: bold;">Field</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: middle; font-weight: bold;">Activity</td></tr><tr style="height: 21px;"><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">Alice</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">F</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">4. Fourth</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">North</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">Text</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">Theatre</td></tr><tr style="height: 21px;"><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">Ben</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">M</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">1. First</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">South</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">Numbers</td><td style="border: 1px solid rgb(204, 204, 204); overflow: hidden; padding: 2px 3px; vertical-align: bottom;">Rowing</td></tr></tbody></table></google-sheets-html-origin>`
+/**
+ * A 4 × 4 table COMPOSED from cells of the 2026-09-04 sweep captures (23 public sheets, same tool
+ * and date as SHEETS_LIVE_2026): every `<td>` open tag and its inline style is verbatim from a
+ * captured cell; texts / URLs replaced. Families: merge anchor with `rowspan` + `colspan`, borders
+ * 1 / 2 px solid, `1px dashed`, the `1px solid transparent` overflow marker, `background-color`,
+ * `font-family` / `font-size:NNpt`, `font-weight:bold|normal`, `text-decoration:underline` /
+ * `line-through`, `color`, `text-align`, `vertical-align:top|middle|bottom`,
+ * `wrap-strategy:4;white-space:normal;word-wrap:break-word;` (wrap), `white-space:clip` (clip),
+ * `white-space:nowrap` (overflow), `<br/>`, `<a class="in-cell-link">`, the `<span><div
+ * style="max-height:…">` merged-wrapped wrapper, the overflow `<div><div style="float:left;">`
+ * wrapper and rich-text `<span style>` runs (a whole-cell run and a partial one).
+ * 2026-09-04 のスイープキャプチャ (公開シート 23 件) のセルを合成した 4 × 4 表: 各 `<td>` 開始タグと
+ * インライン style はキャプチャ通り、本文 / URL は置換。結合 anchor (rowspan + colspan)、罫線
+ * 1 / 2 px solid・1px dashed・透明 (overflow 印)、背景色、フォント族 / サイズ、太字 / normal、
+ * 下線 / 取消線、文字色、水平 / 垂直揃え、wrap / clip / nowrap、`<br/>`、in-cell-link、結合折返し
+ * ラッパー、overflow ラッパー、リッチテキスト `<span>` (全体 run と部分 run)。
+ */
+export const SHEETS_RICH_2026 = `<google-sheets-html-origin><style type="text/css"><!--td {border: 1px solid #cccccc;}br {mso-data-placement:same-cell;}--></style><table xmlns="http://www.w3.org/1999/xhtml" cellspacing="0" cellpadding="0" dir="ltr" border="1" style="table-layout:fixed;font-size:10pt;font-family:Arial;width:0px;border-collapse:collapse;border:none" data-sheets-root="1" data-sheets-baot="1"><colgroup><col width="100"/><col width="100"/><col width="61"/><col width="300"/></colgroup><tbody><tr style="height:21px;"><td style="border-right:2px solid #000000;border-bottom:2px solid #000000;border-left:2px solid #000000;overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;background-color:#ffffff;font-family:Comfortaa;font-size:9pt;font-weight:bold;text-decoration:underline;color:#0000ff;text-align:center;" rowspan="2" colspan="2"><a class="in-cell-link" href="https://example.com/list" target="_blank">Title</a></td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:top;font-weight:bold;wrap-strategy:0;white-space:nowrap;">Plan</td><td style="border-right:1px solid transparent;overflow:visible;padding:2px 0px 2px 0px;vertical-align:bottom;color:#0000ff;"><div style="white-space:nowrap;overflow:hidden;position:relative;width:303px;left:3px;"><div style="float:left;">spill text</div></div></td></tr><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;wrap-strategy:4;white-space:normal;word-wrap:break-word;">Wrapped &amp; long</td><td style="border-right:1px solid transparent;overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;"></td></tr><tr style="height:42px;"><td style="border-right:1px dashed #999999;border-bottom:1px solid #ffffff;overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;background-color:#ffffff;font-family:Nunito;font-size:16pt;font-weight:normal;wrap-strategy:4;white-space:normal;word-wrap:break-word;color:#999999;text-align:center;"><span style="font-size:16pt;font-family:Nunito,Arial;font-weight:normal;font-style:normal;color:#999999;">TYPE HERE</span></td><td style="border-right:1px solid #ffffff;border-bottom:1px solid #f8f9fa;border-left:1px solid #284e3f;overflow:hidden;padding:2px 8px 2px 8px;vertical-align:middle;background-color:#ffffff;font-family:Roboto;font-weight:normal;text-decoration:line-through;wrap-strategy:3;white-space:clip;color:#434343;">done</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;background-color:#cfe2f3;">line one:<br/>line two</td><td style="border-bottom:1px dashed #000000;overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;font-weight:bold;wrap-strategy:4;white-space:normal;word-wrap:break-word;text-align:right;">6.7</td></tr><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:middle;wrap-strategy:4;white-space:normal;word-wrap:break-word;" rowspan="1" colspan="3"><span><div style="max-height:42px">Notes<br/><br/>:: a field<br/>-&gt; a reference</div></span></td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;background-color:#f9fafb;font-size:9pt;wrap-strategy:4;white-space:normal;word-wrap:break-word;color:#374151;text-align:right;"><span style="font-size:9pt;font-family:Arial;font-style:normal;color:#374151;">w/ </span><span style="font-size:9pt;font-family:Arial;font-style:normal;text-decoration:underline;color:#374151;">it&#39;s</span></td></tr></tbody></table></google-sheets-html-origin>`
+/**
+ * HAND-WRITTEN reconstruction of an editor-side (logged-in) Sheets copy carrying the typed
+ * `data-sheets-*` attributes, following the grammar documented in the research map (§3) and the
+ * open-source fixtures it cites: iter.ca 2022 (`data-sheets-value` type 3 + `data-sheets-formula`
+ * R1C1), Univer `constant.ts` (Apache-2.0; `data-sheets-numberformat` `{"1":5,"2":"yyyy/m/d","3":1}`
+ * with serial 45607 = 2024/11/11, `rowspan` / `colspan`), Lexical (MIT; `data-sheets-textstyleruns`),
+ * jsvine 2015 (positional array `[null,2,"…"]`). Cells: number, formula, `=` literal forced to a
+ * string, boolean, error `#DIV/0!`, DATE serial, PERCENT, NUMBER, TEXT, legacy array form,
+ * `data-sheets-hyperlink` beside a different `<a href>`, `data-sheets-note` with `&#10;`,
+ * `data-sheets-userformat` + partial bold run, DATE_TIME serial with a fraction, malformed JSON,
+ * a FALSE with the automatic format `{"1":0}`, and a formula / hyperlink pair that must be dropped
+ * (no `=` / `javascript:`). Not a capture: reconstruction, 2026-09-05, licence n/a.
+ * 編集者側 (ログイン済) の Sheets コピーが持つ型付き `data-sheets-*` 属性を、研究マップ §3 と引用
+ * OSS フィクスチャ (iter.ca 2022 / Univer Apache-2.0 / Lexical MIT / jsvine 2015) の文法に従い
+ * 手書き再構成。数値・数式・`=` リテラル・真偽値・エラー・DATE シリアル・PERCENT・NUMBER・TEXT・
+ * 旧配列形・別 `<a>` と並ぶ hyperlink 属性・`&#10;` 入り note・userformat + 部分 bold run・
+ * 小数付き DATE_TIME・不正 JSON・自動書式の FALSE・落とすべき数式 / hyperlink。キャプチャではない。
+ */
+export const SHEETS_TYPED_RECONSTRUCTION = `<google-sheets-html-origin><style type="text/css"><!--td {border: 1px solid #cccccc;}br {mso-data-placement:same-cell;}--></style><table xmlns="http://www.w3.org/1999/xhtml" cellspacing="0" cellpadding="0" dir="ltr" border="1" style="table-layout:fixed;font-size:10pt;font-family:Arial;width:0px;border-collapse:collapse;border:none" data-sheets-root="1"><colgroup><col width="100"/><col width="100"/><col width="100"/><col width="100"/></colgroup><tbody><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:right;" data-sheets-value="{&quot;1&quot;:3,&quot;3&quot;:3}">3</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:right;" data-sheets-value="{&quot;1&quot;:3,&quot;3&quot;:6}" data-sheets-formula="=2*R[0]C[-1]">6</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;" data-sheets-value="{&quot;1&quot;:2,&quot;2&quot;:&quot;=not a formula&quot;}">=not a formula</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:center;" data-sheets-value="{&quot;1&quot;:4,&quot;4&quot;:1}">TRUE</td></tr><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:center;" data-sheets-value="{&quot;1&quot;:5,&quot;5&quot;:{&quot;1&quot;:2}}" data-sheets-formula="=1/0">#DIV/0!</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:right;" data-sheets-value="{&quot;1&quot;:3,&quot;3&quot;:45607}" data-sheets-numberformat="{&quot;1&quot;:5,&quot;2&quot;:&quot;yyyy/m/d&quot;,&quot;3&quot;:1}">2024/11/11</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:right;" data-sheets-value="{&quot;1&quot;:3,&quot;3&quot;:0.2}" data-sheets-numberformat="{&quot;1&quot;:3,&quot;2&quot;:&quot;0.00%&quot;,&quot;3&quot;:1}">20.00%</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:right;" data-sheets-value="{&quot;1&quot;:3,&quot;3&quot;:1234.5}" data-sheets-numberformat="{&quot;1&quot;:2,&quot;2&quot;:&quot;#,##0.00&quot;,&quot;3&quot;:1}">1,234.50</td></tr><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;" data-sheets-value="{&quot;1&quot;:2,&quot;2&quot;:&quot;0123&quot;}" data-sheets-numberformat="{&quot;1&quot;:1}">0123</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;" data-sheets-value="[null,2,&quot;Legacy&quot;]">Legacy</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-decoration:underline;color:#1155cc;" data-sheets-value="{&quot;1&quot;:2,&quot;2&quot;:&quot;Docs&quot;}" data-sheets-hyperlink="https://example.com/docs"><a class="in-cell-link" href="https://example.com/other" target="_blank">Docs</a></td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;" data-sheets-value="{&quot;1&quot;:2,&quot;2&quot;:&quot;Noted&quot;}" data-sheets-note="A note&#10;second line" data-sheets-userformat="{&quot;2&quot;:513,&quot;3&quot;:{&quot;1&quot;:0},&quot;12&quot;:0}" data-sheets-textstyleruns="{&quot;1&quot;:0}{&quot;1&quot;:2,&quot;2&quot;:{&quot;5&quot;:1}}">No<span style="font-weight:bold;">ted</span></td></tr><tr style="height:21px;"><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:right;" data-sheets-value="{&quot;1&quot;:3,&quot;3&quot;:45607.5}" data-sheets-numberformat="{&quot;1&quot;:7,&quot;2&quot;:&quot;yyyy-mm-dd hh:mm:ss&quot;}">2024-11-11 12:00:00</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;" data-sheets-value="{not json">shown</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;text-align:center;" data-sheets-value="{&quot;1&quot;:4,&quot;4&quot;:0}" data-sheets-numberformat="{&quot;1&quot;:0}">FALSE</td><td style="overflow:hidden;padding:2px 3px 2px 3px;vertical-align:bottom;" data-sheets-formula="R[0]C[-1]" data-sheets-hyperlink="javascript:alert(1)">bad</td></tr></tbody></table></google-sheets-html-origin>`