@threestarsoftware/tssgrid 0.0.1

package/plugins/tss-filter.js

@@ -0,0 +1,146 @@
+/*! TssFilter — ヘッダのオートフィルタUI（Excel風）。コアの非破壊 filter() を呼ぶだけ。
+ *
+ *  各リーフ見出しにロート(漏斗)アイコンを出し（ソートの▲▼と区別）、クリックで「値チェックリスト＋絞り込み検索」ポップアップ。
+ *  複数列の条件は AND。適用は grid.filter(pred)／全解除で grid.clearFilter()。フィルタ済み列は印が付く。
+ *
+ *  使い方:
+ *    const grid = new TssGrid(el, { plugins: [ TssFilter.plugin() ] });   // 全列にフィルタUI
+ *    TssFilter.plugin({ columns: ['部署', 2] });                          // 対象列を限定（data キー or index）
+ *    grid.getPlugin('filter').clearAll();                                  // 全条件クリア
+ *
+ *  opts: columns（対象列の配列・省略=全列） / caseSensitive（既定 false・値一致は文字列）。
+ *  メモ: 値候補はマスタ全行(_allRows)から集計＝絞り込み中でも全値が出る。grid.filter() は履歴クリア（コア仕様）。
+ */
+(function (root) {
+  'use strict';
+  function esc(s) { return String(s).replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c])); }
+  // ロート（漏斗＝filter）アイコン。currentColor で .on の色替えに追従。ソートの▼と区別。
+  const FUNNEL = '<svg class="tg-filter-ico" viewBox="0 0 16 16" width="11" height="11" aria-hidden="true"><path d="M1.5 3h13l-5 6v4.2l-3-1.6V9z" fill="currentColor"/></svg>';
+
+  function plugin(opts) {
+    opts = opts || {};
+    return function (grid) {
+      const active = {};            // colIndex -> Set(許可する値文字列)
+      let pop = null, popCol = -1;
+
+      // 対象列 index の集合（省略時は全列）
+      const targets = (() => {
+        if (!opts.columns) return null;   // null = 全列
+        const s = new Set();
+        opts.columns.forEach(k => { const ci = grid._resolveCol ? grid._resolveCol(k) : (typeof k === 'number' ? k : -1); if (ci >= 0) s.add(ci); });
+        return s;
+      })();
+      const isTarget = c => !targets || targets.has(c);
+
+      // マスタ全行（フィルタ中でも全件）から列 c の重複なし値（出現順）。
+      function distinctValues(c) {
+        const rows = grid._allRows || grid.data, seen = new Set(), out = [];
+        for (const row of rows) { const v = String(row[c]); if (!seen.has(v)) { seen.add(v); out.push(v); } }
+        return out;
+      }
+
+      function buildPredicate() {
+        const cols = Object.keys(active).map(Number).filter(c => active[c]);
+        if (!cols.length) return null;
+        return row => cols.every(c => active[c].has(String(row[c])));
+      }
+      function apply() {
+        const p = buildPredicate();
+        if (p) grid.filter(p); else grid.clearFilter();
+        decorate();
+      }
+      grid.clearAllFilters = function () { for (const k in active) delete active[k]; apply(); };
+
+      // ---- ヘッダ装飾（buildTable をラップして毎回付け直す） ----
+      function decorate() {
+        const ths = grid.table ? grid.table.querySelectorAll('thead th[data-c]') : [];
+        ths.forEach(th => {
+          const c = +th.dataset.c;
+          let btn = th.querySelector('.tg-filter-btn');
+          if (!isTarget(c)) { if (btn) btn.remove(); return; }
+          if (!btn) { btn = document.createElement('span'); btn.className = 'tg-filter-btn'; btn.innerHTML = FUNNEL; th.appendChild(btn); }
+          btn.dataset.fc = c;
+          btn.classList.toggle('on', !!active[c]);
+        });
+      }
+      const origBuild = grid.buildTable.bind(grid);
+      grid.buildTable = function () { origBuild(); decorate(); };
+
+      // ---- ポップアップ ----
+      function closePop() { if (pop) { pop.remove(); pop = null; popCol = -1; } }
+      function openPop(c, anchor) {
+        closePop();
+        popCol = c;
+        const vals = distinctValues(c);
+        const allowed = active[c] || new Set(vals);   // 未設定なら全許可
+        pop = document.createElement('div');
+        pop.className = 'tg-filter-pop';
+        pop.innerHTML =
+          '<div class="tg-filter-search"><input type="text" placeholder="値を検索…"></div>' +
+          '<div class="tg-filter-tools"><a data-act="all">すべて</a> / <a data-act="none">解除</a></div>' +
+          '<div class="tg-filter-list">' +
+          vals.map(v => '<label><input type="checkbox" value="' + esc(v) + '"' + (allowed.has(v) ? ' checked' : '') + '><span>' + (v === '' ? '(空白)' : esc(v)) + '</span></label>').join('') +
+          '</div>' +
+          '<div class="tg-filter-btns"><button data-act="apply">適用</button><button data-act="clear">クリア</button></div>';
+        document.body.appendChild(pop);
+        // 位置（アンカーの下・はみ出しは画面内へ）
+        const r = anchor.getBoundingClientRect();
+        const pw = 220, ph = Math.min(320, pop.offsetHeight || 300);
+        let left = r.left, top = r.bottom + 2;
+        if (left + pw > window.innerWidth - 6) left = window.innerWidth - pw - 6;
+        if (top + ph > window.innerHeight - 6) top = Math.max(6, r.top - ph - 2);
+        pop.style.left = Math.max(6, left) + 'px'; pop.style.top = top + 'px';
+
+        const search = pop.querySelector('.tg-filter-search input');
+        const list = pop.querySelector('.tg-filter-list');
+        search.focus();
+        search.oninput = () => {
+          const q = search.value.trim().toLowerCase();
+          list.querySelectorAll('label').forEach(l => { l.style.display = (!q || l.textContent.toLowerCase().indexOf(q) >= 0) ? '' : 'none'; });
+        };
+        pop.querySelector('[data-act=all]').onclick = () => list.querySelectorAll('label:not([style*="none"]) input').forEach(cb => cb.checked = true);
+        pop.querySelector('[data-act=none]').onclick = () => list.querySelectorAll('label:not([style*="none"]) input').forEach(cb => cb.checked = false);
+        pop.querySelector('[data-act=apply]').onclick = () => {
+          const checked = [...list.querySelectorAll('input:checked')].map(cb => cb.value);
+          if (checked.length === vals.length) delete active[c];        // 全選択＝この列は無条件
+          else active[c] = new Set(checked);
+          closePop(); apply();
+        };
+        pop.querySelector('[data-act=clear]').onclick = () => { delete active[c]; closePop(); apply(); };
+      }
+
+      function onHeadClick(e) {
+        const btn = e.target.closest && e.target.closest('.tg-filter-btn');
+        if (!btn) return;
+        e.stopPropagation(); e.preventDefault();
+        const c = +btn.dataset.fc;
+        if (pop && popCol === c) { closePop(); return; }   // トグル
+        openPop(c, btn);
+      }
+      function onDocDown(e) { if (pop && !pop.contains(e.target) && !(e.target.closest && e.target.closest('.tg-filter-btn'))) closePop(); }
+
+      grid.table.addEventListener('mousedown', onHeadClick, true);   // sort等より先に拾う（capture）
+      document.addEventListener('mousedown', onDocDown);
+      decorate();
+
+      return {
+        name: 'filter',
+        clearAll: () => grid.clearAllFilters(),
+        destroy: function () {
+          closePop();
+          grid.table.removeEventListener('mousedown', onHeadClick, true);
+          document.removeEventListener('mousedown', onDocDown);
+          grid.buildTable = origBuild;
+          delete grid.clearAllFilters;
+          for (const k in active) delete active[k];
+          if (grid.isFiltered && grid.isFiltered()) grid.clearFilter();
+          if (grid.table) grid.table.querySelectorAll('.tg-filter-btn').forEach(b => b.remove());
+        },
+      };
+    };
+  }
+
+  const TssFilter = { plugin: plugin };
+  if (typeof module !== 'undefined' && module.exports) module.exports = TssFilter;
+  else root.TssFilter = TssFilter;
+})(typeof self !== 'undefined' ? self : this);

package/plugins/tss-formula.js

@@ -0,0 +1,87 @@
+/*! TssFormula — 行スコープの派生列（computed column）プラグイン。
+ *
+ *  「その行の値だけから計算する列」を columns 定義に formula 関数で書けるようにする。
+ *  例: 金額 = 数量 × 単価 / 税込 = 金額 × 1.1 / 勤怠の勤務時間 など。
+ *
+ *  使い方:
+ *    columns: [
+ *      { data:'quantity', type:'number' },
+ *      { data:'price',    type:'number' },
+ *      { data:'amount',   type:'number', formula: (row) => row.quantity * row.price },        // ← 派生列
+ *      { data:'withTax',  type:'number', formula: (row) => Math.round(row.amount * 1.1) },     // ← 前の formula 結果も使える
+ *    ],
+ *    plugins: [TssFormula]                 // または grid.usePlugin(TssFormula) / plugins:['formula']
+ *
+ *  仕様:
+ *   - formula は **行スコープの純粋関数** `(row, ctx) => value`。row=その行の {dataキー:値}、ctx={r,c,grid}。
+ *   - formula 列は **自動で readOnly**（計算結果＝手入力不可。明示済みなら尊重）。
+ *   - **同じ行のどれかが変わると自動再計算**（編集/フィル/貼付/Undo/Redo すべて追従。依存解析はせず「同じ行が変わったら回す」＝単純で正しい）。
+ *   - 書き込みは **setValueRaw**＝undo/redo 履歴に積まない（派生値が独立した Undo ステップにならない）。
+ *   - **columns 定義順に評価**＝後ろの formula は前の formula 結果を参照できる。
+ *   - 値は内部文字列。算術は JS が数値強制（'1200' * '5' = 6000）。`+` で連結を避けたいときは Number(row.x) を。
+ *
+ *  ※ 列方向の集計（縦の SUM/合計行）はこのプラグインの範囲外。合計は別の小さなグリッド＋関数で（勤怠デモの合計表が好例）。
+ */
+(function (root) {
+  'use strict';
+  function TssFormula(grid, opts) {
+    opts = opts || {};
+
+    // formula を持つ列を収集（無ければ何もしない）。formula 列は自動 readOnly。
+    var fcols = [];
+    for (var c = 0; c < grid.COLS; c++) {
+      var cfg = grid.columns[c];
+      if (cfg && typeof cfg.formula === 'function') { fcols.push(c); if (cfg.readOnly == null) cfg.readOnly = true; }
+    }
+    if (!fcols.length) return { name: 'formula' };
+
+    // その行を {dataキー: 値} のオブジェクトに（formula へ渡す row）。
+    function rowObject(r) {
+      var o = {};
+      for (var c = 0; c < grid.COLS; c++) { var k = grid.columns[c] && grid.columns[c].data; if (k != null) o[k] = grid.data[r][c]; }
+      return o;
+    }
+    // 1行の formula 列を順に再計算（後続が前の結果を参照できるよう row を更新しながら）。
+    function recalcRow(r) {
+      if (r < 0 || r >= grid.ROWS) return;
+      var o = rowObject(r);
+      for (var i = 0; i < fcols.length; i++) {
+        var c = fcols[i], v;
+        try { v = grid.columns[c].formula(o, { r: r, c: c, grid: grid }); } catch (e) { v = ''; }
+        if (v == null || (typeof v === 'number' && !isFinite(v))) v = '';   // null/NaN/Infinity は空
+        grid.setValueRaw(r, c, v);
+        var k = grid.columns[c].data; if (k != null) o[k] = grid.data[r][c];
+      }
+    }
+    function recalcRows(rows) { rows.forEach(recalcRow); }
+    function recalcAll() { for (var r = 0; r < grid.ROWS; r++) recalcRow(r); }
+
+    // 変更フック: onAfterChange を包んで「変わった行」の formula を再計算。
+    // setValueRaw は履歴も onAfterChange も起こさないので、ここで書いても再入しない＝ループしない。
+    var prevAfter = grid.onAfterChange;
+    grid.onAfterChange = function (changes, source) {
+      var rows = new Set();
+      for (var i = 0; i < changes.length; i++) rows.add(changes[i].r);
+      recalcRows(rows);
+      if (prevAfter) { try { prevAfter.call(grid, changes, source); } catch (e) {} }
+    };
+    // setData（全入替）後は全行再計算。
+    var prevSetData = grid.setData.bind(grid);
+    grid.setData = function (rows) { prevSetData(rows); recalcAll(); };
+    // 行/列の挿入・削除後も全行再計算（新規行の formula を埋める）。
+    var prevStruct = grid.onStructureChange;
+    grid.onStructureChange = function (info) { recalcAll(); if (prevStruct) { try { prevStruct.call(grid, info); } catch (e) {} } };
+
+    recalcAll();   // 初期計算
+
+    return {
+      name: 'formula',
+      recalc: recalcRow,          // 手動で1行
+      recalcAll: recalcAll,       // 手動で全行
+      destroy: function () { grid.onAfterChange = prevAfter; grid.setData = prevSetData; grid.onStructureChange = prevStruct; },
+    };
+  }
+  if (typeof TssGrid !== 'undefined' && TssGrid.registerPlugin) TssGrid.registerPlugin('formula', TssFormula);
+  if (typeof module !== 'undefined' && module.exports) module.exports = TssFormula;
+  else root.TssFormula = TssFormula;
+})(typeof self !== 'undefined' ? self : this);

package/plugins/tss-furigana.js

@@ -0,0 +1,84 @@
+/*! TssFurigana — 氏名→フリガナ 自動入力プラグイン。**辞書不要**。
+ *
+ *  スマホの連絡先のように「漢字を入力すると よみ が別列に自動で入る」。仕組みは**辞書引きではなく**、
+ *  IME変換の **composition イベントから「変換前の読み（かな）」を拾う**だけ。だから辞書データを持たない。
+ *  TssGrid は**アクティブセルに本物の <input> を重ねる**設計（IME堅牢の核）なので composition が確実に取れる＝相性抜群。
+ *
+ *  使い方:
+ *    plugins: [ TssFurigana({ source: 'name', target: 'kana' }) ]            // 氏名→フリガナ
+ *    plugins: [ TssFurigana({ pairs: [{source:'sei',target:'seiKana'}, …], katakana:false }) ]  // 複数ペア / ひらがな出力
+ *
+ *  opts:
+ *    source / target … 漢字を入れる列 / 読みを入れる列（dataキー）。target は手修正可（readOnlyにはしない）。
+ *    pairs           … 複数ペアを配列で（source/target の代わり / 併用可）。
+ *    katakana        … true(既定)=カタカナ出力 / false=ひらがな出力。
+ *
+ *  仕組みの限界（正直に）: **手入力（IME変換）した時だけ**読みが取れる。貼り付け・既存値の漢字からは取れない。
+ *  変換のクセで拾い損ねる語もある＝「自動入力＋手直しできる」が現実解（target は編集可のまま）。
+ */
+(function (root) {
+  'use strict';
+  // ひらがな → カタカナ
+  function toKatakana(s) { return s.replace(/[ぁ-ゖ]/g, function (c) { return String.fromCharCode(c.charCodeAt(0) + 0x60); }); }
+  // 全部かな（ひら/カタ/長音/濁点）か＝変換前の「読み」かどうか
+  function isKana(s) { return !!s && /^[ぁ-んァ-ヶー゛゜ー\s]+$/.test(s); }
+
+  function TssFurigana(opts) {
+    opts = opts || {};
+    var pairs = opts.pairs ? opts.pairs.slice() : [];
+    if (opts.source && opts.target) pairs.push({ source: opts.source, target: opts.target });
+    var toKata = opts.katakana !== false;
+
+    return function (grid) {
+      var ed = grid.editor;
+      if (!ed || !pairs.length) return { name: 'furigana' };
+      // source 列の index ＋ target 列キー を解決
+      var map = [];
+      pairs.forEach(function (p) {
+        var si = -1; for (var c = 0; c < grid.COLS; c++) if (grid.columns[c] && grid.columns[c].data === p.source) { si = c; break; }
+        if (si >= 0) map.push({ srcIdx: si, targetKey: p.target });
+      });
+      if (!map.length) return { name: 'furigana' };
+
+      // acc = このセル編集で打った読みの累積（漢字変換を複数回しても連結）。seg = 変換中セグメントの読み。
+      var acc = '', seg = '', lastKey = null;
+      function onStart() {
+        var key = grid.active.r + ',' + grid.active.c;
+        if (key !== lastKey) { acc = ''; lastKey = key; }   // 別セルに移ったら読みをリセット
+        seg = '';
+      }
+      function onUpdate(e) { if (isKana(e.data)) seg = e.data; }   // 変換前の全かなを保持（漢字化したら更新せず最後のかなが残る）
+      function onEnd() { acc += seg; seg = ''; }                   // 1変換ぶんの読みを累積
+      ed.addEventListener('compositionstart', onStart);
+      ed.addEventListener('compositionupdate', onUpdate);
+      ed.addEventListener('compositionend', onEnd);
+
+      // セル確定（onAfterChange）で、source 列が変わっていたら読みを target へ。貼付/フィルは acc 空＝何もしない。
+      var prevAfter = grid.onAfterChange;
+      grid.onAfterChange = function (changes, source) {
+        if (prevAfter) { try { prevAfter.call(grid, changes, source); } catch (e) {} }
+        if (source !== 'undo' && source !== 'redo' && acc) {
+          for (var i = 0; i < changes.length; i++) {
+            var ch = changes[i];
+            for (var m = 0; m < map.length; m++) if (ch.c === map[m].srcIdx) {
+              grid.setValueRaw(ch.r, map[m].targetKey, toKata ? toKatakana(acc) : acc);
+            }
+          }
+        }
+        acc = ''; seg = ''; lastKey = null;   // コミットでリセット
+      };
+
+      return {
+        name: 'furigana',
+        destroy: function () {
+          ed.removeEventListener('compositionstart', onStart);
+          ed.removeEventListener('compositionupdate', onUpdate);
+          ed.removeEventListener('compositionend', onEnd);
+          grid.onAfterChange = prevAfter;
+        },
+      };
+    };
+  }
+  if (typeof module !== 'undefined' && module.exports) module.exports = TssFurigana;
+  else root.TssFurigana = TssFurigana;
+})(typeof self !== 'undefined' ? self : this);

package/plugins/tss-heatmap.js

@@ -0,0 +1,66 @@
+/*! TssHeatmap / TssDataBar — セル背景の連続ビジュアライズ（cellStyle フック用）。
+ *
+ *  コアの `cellStyle`（セルにインラインCSSを差すフック）に乗せる。cellClass（クラス＝離散色）では出せない
+ *  **値に応じた連続色（ヒートマップ）／背景データバー**を、**編集できる数値セルのまま**実現する。
+ *
+ *  使い方:
+ *    // ヒートマップ: 値で背景色（低→高）。文字色は自動でコントラスト確保。
+ *    { data:'m4', type:'number', cellStyle: TssHeatmap({ min:0, max:400000, colors:['#f8b4b4','#ffffff','#93c5fd'] }) }
+ *    // データバー: 数値はそのまま見せつつ背景に棒（編集可）。
+ *    { data:'score', type:'number', cellStyle: TssDataBar({ min:0, max:100, color:'rgba(13,148,136,.25)' }) }
+ *
+ *  ※ min/max は明示（cellStyle はセル単位呼び出しで列全体の範囲を知らないため）。既定 0..100。
+ */
+(function (root) {
+  'use strict';
+  function r2(n) { return Math.round(n * 100) / 100; }
+  function clamp01(t) { return t < 0 ? 0 : t > 1 ? 1 : t; }
+  // '#abc'/'#aabbcc' → [r,g,b]
+  function hex2rgb(h) {
+    h = String(h).replace('#', '');
+    if (h.length === 3) h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
+    return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+  }
+  function rgb2hex(c) { return '#' + c.map(function (n) { return ('0' + Math.round(n).toString(16)).slice(-2); }).join(''); }
+  function lerp(a, b, t) { return a + (b - a) * t; }
+  // 複数ストップ（[low, mid, high] 等）を t∈0..1 で補間
+  function lerpStops(stops, t) {
+    if (stops.length === 1) return stops[0];
+    var seg = t * (stops.length - 1), i = Math.min(stops.length - 2, Math.floor(seg)), f = seg - i;
+    var a = hex2rgb(stops[i]), b = hex2rgb(stops[i + 1]);
+    return rgb2hex([lerp(a[0], b[0], f), lerp(a[1], b[1], f), lerp(a[2], b[2], f)]);
+  }
+  // 背景色に対して読みやすい文字色（黒 or 白）
+  function textOn(hex) { var c = hex2rgb(hex); return (0.299 * c[0] + 0.587 * c[1] + 0.114 * c[2]) > 150 ? '#1f2733' : '#fff'; }
+
+  function TssHeatmap(opts) {
+    opts = opts || {};
+    var min = (opts.min != null) ? opts.min : 0, max = (opts.max != null) ? opts.max : 100;
+    var stops = opts.colors || [opts.low || '#e8f0fe', opts.high || '#1a73e8'];
+    var autoText = opts.text !== false;
+    return function (value) {
+      var s = String(value == null ? '' : value).trim();
+      if (s === '' || !isFinite(Number(s))) return null;     // 空・非数値はスタイル無し
+      var t = clamp01((Number(s) - min) / ((max - min) || 1));
+      var bg = lerpStops(stops, t), out = { background: bg };
+      if (autoText) out.color = textOn(bg);
+      return out;
+    };
+  }
+
+  function TssDataBar(opts) {
+    opts = opts || {};
+    var min = (opts.min != null) ? opts.min : 0, max = (opts.max != null) ? opts.max : 100;
+    var color = opts.color || 'rgba(13,148,136,.25)';
+    var dir = (opts.align === 'right') ? 'to left' : 'to right';
+    return function (value) {
+      var s = String(value == null ? '' : value).trim();
+      if (s === '' || !isFinite(Number(s))) return null;
+      var pct = r2(Math.max(0, Math.min(100, ((Number(s) - min) / ((max - min) || 1)) * 100)));
+      return { background: 'linear-gradient(' + dir + ', ' + color + ' ' + pct + '%, transparent ' + pct + '%)' };
+    };
+  }
+
+  if (typeof module !== 'undefined' && module.exports) module.exports = { TssHeatmap: TssHeatmap, TssDataBar: TssDataBar };
+  else { root.TssHeatmap = TssHeatmap; root.TssDataBar = TssDataBar; }
+})(typeof self !== 'undefined' ? self : this);

package/plugins/tss-merge.js

@@ -0,0 +1,144 @@
+/*! TssMerge — 矩形セル結合（colspan×rowspan）の軽量プラグイン。
+ *
+ *  アンカー=(r,c)=左上が値・編集・選択の対象。覆われた従属セルは描画スキップ＋読取専用（貼付/フィルは弾く）。
+ *  行/列の挿入削除では結合座標がコア側で縦横対称に追従（undo 対応）。
+ *  並べ替え/行移動との関係: ソートは結合中つねにロック。行移動は「横結合のみ」なら可（行と一緒に移動）、
+ *  「縦結合(rowspan>1)」が在る間はロック（行順を崩すと縦結合が分断＝auto-split を避ける割り切り）。
+ *
+ *  使い方:
+ *    grid = new TssGrid(el, { plugins: [ TssMerge.plugin({ merges: [{r:0,c:1,colspan:3},{r:1,c:0,rowspan:2}] }) ] });
+ *    grid.setMerge(0, 1, 3);      // (0,1) を起点に3列を横結合（rowspan 省略=1）
+ *    grid.setMerge(1, 0, 1, 2);   // (1,0) を起点に2行を縦結合（colspan,rowspan）
+ *    grid.setMerge(2, 2, 2, 2);   // 2x2 の矩形結合
+ *    grid.mergeSelection();       // 選択矩形を結合（既存結合を含めば飲み込んで1つに＝Excel流）
+ *    grid.setMerge(0, 0, 4, 1, true);  // 第5引数 absorb=true で重なる既存結合を飲み込む
+ *    grid.removeMerge(0, 1);      // (0,1) を含む結合を解除
+ *    grid.getMerges();            // [{r,c,colspan,rowspan}, ...]
+ *    grid.destroyMerged();        // 全結合を解除
+ *
+ *  opts(plugin): merges（初期結合の配列 [{r,c,colspan,rowspan?}]）。
+ *  Undo: setMerge/removeMerge/mergeSelection/destroyMerged は履歴に積む（結合と、結合時にクリアした従属
+ *        セルの値の両方を復元）。初期 merges（opts）は履歴に積まない（設定扱い）。
+ *  注意: frozen 境界をまたぐ結合は想定外（ネストヘッダと同じ制約）。結合範囲のコピーは従属位置が空セル。
+ */
+(function (root) {
+  'use strict';
+
+  function TssMerge() { /* 名前空間。plugin を使う */ }
+
+  TssMerge.plugin = function (opts) {
+    opts = opts || {};
+    return function (grid) {
+      if (grid._tssMergeInstalled) return { name: 'merge' };   // 二重インストール防止
+      grid._tssMergeInstalled = true;
+
+      function cp(m) { return { r: m.r, c: m.c, colspan: m.colspan, rowspan: m.rowspan || 1 }; }
+      function snapshot() { return grid._merges ? grid._merges.map(cp) : null; }
+      function restore(snap) { grid._merges = snap ? snap.map(cp) : null; }
+      // 矩形の正規化（範囲外/1x1 は null）。重なり判定はせず、呼び出し側で扱う。
+      function rectOf(r, c, colspan, rowspan) {
+        r |= 0; c |= 0; colspan |= 0; rowspan = rowspan ? rowspan | 0 : 1;
+        if (r < 0 || r >= grid.ROWS || c < 0 || c >= grid.COLS) return null;
+        colspan = Math.min(colspan, grid.COLS - c);
+        rowspan = Math.min(rowspan, grid.ROWS - r);
+        if (colspan < 1 || rowspan < 1 || (colspan < 2 && rowspan < 2)) return null;   // 1x1 は結合でない
+        return { r: r, c: c, colspan: colspan, rowspan: rowspan };
+      }
+      // 矩形 m と重なる既存結合の配列（飲み込み対象の特定に使う）。
+      function overlapping(m) {
+        return (grid._merges || []).filter(function (x) {
+          var xrs = x.rowspan || 1;
+          return !(m.c + m.colspan <= x.c || x.c + x.colspan <= m.c || m.r + m.rowspan <= x.r || x.r + xrs <= m.r);
+        });
+      }
+      // 結合矩形のうちアンカー以外（従属セル）を列挙。値クリア／復元に使う。
+      function coveredOf(m) {
+        var out = [];
+        for (var rr = m.r; rr < m.r + m.rowspan; rr++) for (var cc = m.c; cc < m.c + m.colspan; cc++) {
+          if (rr === m.r && cc === m.c) continue;
+          out.push({ r: rr, c: cc });
+        }
+        return out;
+      }
+      // do/undo を実行＋履歴へ。コア _structCmd と同形（手動実行→push、apply=redo / revert=undo）。
+      function commit(doFn, undoFn, selR, selC) {
+        doFn(); grid.buildTable(); grid.setActive(selR, selC);
+        grid.history.push({
+          label: grid.name || 'merge',
+          apply: function () { doFn(); grid.buildTable(); grid.setActive(selR, selC); },
+          revert: function () { undoFn(); grid.buildTable(); grid.setActive(selR, selC); },
+        });
+      }
+
+      // (r,c) を起点に colspan×rowspan を結合。rowspan 省略=1（横結合）。成功で true。範囲外/1x1 は false。Undo 対応。
+      // 既存結合と重なる時: absorb=true なら飲み込んで1つに（Excel流）／false（既定）は拒否して false。
+      grid.setMerge = function (r, c, colspan, rowspan, absorb) {
+        var m = rectOf(r, c, colspan, rowspan); if (!m) return false;
+        if (overlapping(m).length && !absorb) return false;   // 重なりは既定では拒否（従来挙動）
+        var before = snapshot(), cleared = [];   // 従属セルの値クリア＝undo で復元
+        coveredOf(m).forEach(function (p) { if (grid.data[p.r][p.c] !== '') cleared.push({ r: p.r, c: p.c, val: grid.data[p.r][p.c] }); });
+        commit(
+          function () {
+            var hh = overlapping(m);   // 飲み込む結合は do の度に現在の _merges から再計算（undo→redo でも正しい）
+            if (hh.length) grid._merges = (grid._merges || []).filter(function (x) { return hh.indexOf(x) < 0; });
+            for (var k = 0; k < cleared.length; k++) grid.data[cleared[k].r][cleared[k].c] = '';
+            (grid._merges || (grid._merges = [])).push(cp(m));
+          },
+          function () { restore(before); for (var k = 0; k < cleared.length; k++) grid.data[cleared[k].r][cleared[k].c] = cleared[k].val; },
+          m.r, m.c);
+        return true;
+      };
+
+      // (r,c) を覆う結合を解除。解除したら true。Undo 対応（値は戻さない＝結合時に消えたまま）。
+      grid.removeMerge = function (r, c) {
+        if (!grid._merges) return false;
+        var hit = null;
+        for (var i = 0; i < grid._merges.length; i++) { var m = grid._merges[i], mrs = m.rowspan || 1; if (r >= m.r && r < m.r + mrs && c >= m.c && c < m.c + m.colspan) { hit = m; break; } }
+        if (!hit) return false;
+        var before = snapshot(), key = cp(hit);
+        commit(
+          function () { grid._merges = (grid._merges || []).filter(function (m) { return !(m.r === key.r && m.c === key.c && m.colspan === key.colspan && (m.rowspan || 1) === key.rowspan); }); if (!grid._merges.length) grid._merges = null; },
+          function () { restore(before); },
+          r, c);
+        return true;
+      };
+
+      // 現在の選択範囲（矩形）を結合。既存結合を含む場合は飲み込んで1つに（Excel流）。1x1 のみの選択は false。
+      grid.mergeSelection = function () {
+        var rr = grid.rectRange();
+        return grid.setMerge(rr.r0, rr.c0, rr.c1 - rr.c0 + 1, rr.r1 - rr.r0 + 1, true);
+      };
+
+      grid.getMerges = function () { return (grid._merges || []).map(cp); };
+
+      // 全結合を解除。Undo 対応。
+      grid.destroyMerged = function () {
+        if (!grid._merges) return;
+        var before = snapshot();
+        commit(function () { grid._merges = null; }, function () { restore(before); }, grid.active.r, grid.active.c);
+      };
+
+      // 初期結合（履歴に積まない＝設定扱い）。範囲検証し、重なるものは無視、従属セルの値はクリア。
+      (opts.merges || []).forEach(function (mm) {
+        var m = rectOf(mm.r, mm.c, mm.colspan, mm.rowspan); if (!m || overlapping(m).length) return;
+        coveredOf(m).forEach(function (p) { grid.data[p.r][p.c] = ''; });
+        (grid._merges || (grid._merges = [])).push(m);
+      });
+      if (grid._merges) grid.buildTable();
+
+      return {
+        name: 'merge',
+        destroy: function () {
+          grid._merges = null;
+          grid._tssMergeInstalled = false;
+          delete grid.setMerge; delete grid.removeMerge; delete grid.mergeSelection;
+          delete grid.getMerges; delete grid.destroyMerged;
+          if (grid.table) grid.buildTable();
+        },
+      };
+    };
+  };
+
+  if (typeof module !== 'undefined' && module.exports) module.exports = TssMerge;
+  else root.TssMerge = TssMerge;
+})(typeof self !== 'undefined' ? self : this);

package/plugins/tss-messages.js

@@ -0,0 +1,68 @@
+/*! TssMessages — システム共通メッセージのカタログ作成ヘルパー（CSV/行配列 → grid.messages 用マップ）。
+ *
+ *  エラー本文をコードで一元管理（トーン統一・多言語・差し替え）。validator は { code, params } を返すだけにし、
+ *  本文は外部の設定（CSV/JSON/XML→行配列）に置く。ここはその設定を grid.messages の形に変換する係。
+ *
+ *  形: grid.messages = { CODE: { level, text } }（text に {label}/{value}/任意params のプレースホルダ）。
+ *
+ *  使い方:
+ *    // CSV（1行目ヘッダ: code,level,text）から
+ *    const cat = TssMessages.fromCSV(`code,level,text
+ *    E_REQUIRED,error,{label}は必須です
+ *    E_RANGE,error,{label}は{min}〜{max}の範囲で
+ *    W_LONG,warn,{label}が長めです`);
+ *    new TssGrid(el, { messages: cat, columns:[{ data:'age', title:'年齢',
+ *      validator: v => v===''||(+v>=0&&+v<=120) || { code:'E_RANGE', params:{min:0,max:120} } }] });
+ *
+ *    // 既に配列（JSON等）なら: TssMessages.fromRows([{code,level,text}, …])
+ */
+(function (root) {
+  'use strict';
+  // 1行を CSV としてパース（"..." クォート・"" エスケープ・カンマ/改行をフィールド内に許容）
+  function parseCSV(text) {
+    var rows = [], row = [], i = 0, f = '', q = false, s = String(text);
+    while (i < s.length) {
+      var ch = s[i];
+      if (q) {
+        if (ch === '"') { if (s[i + 1] === '"') { f += '"'; i += 2; continue; } q = false; i++; continue; }
+        f += ch; i++; continue;
+      }
+      if (ch === '"') { q = true; i++; continue; }
+      if (ch === ',') { row.push(f); f = ''; i++; continue; }
+      if (ch === '\r') { i++; continue; }
+      if (ch === '\n') { row.push(f); rows.push(row); row = []; f = ''; i++; continue; }
+      f += ch; i++;
+    }
+    if (f !== '' || row.length) { row.push(f); rows.push(row); }
+    return rows.filter(function (r) { return r.length && !(r.length === 1 && r[0] === ''); });
+  }
+
+  function fromRows(rows) {
+    var cat = {};
+    (rows || []).forEach(function (r) {
+      var code = (r.code != null ? r.code : r[0]); if (code == null || code === '') return;
+      var level = (r.level != null ? r.level : r[1]) || 'error';
+      var text = (r.text != null ? r.text : (r.message != null ? r.message : r[2])) || '';
+      cat[String(code).trim()] = { level: String(level).trim() || 'error', text: String(text) };
+    });
+    return cat;
+  }
+
+  function fromCSV(text) {
+    var rows = parseCSV(text); if (!rows.length) return {};
+    var head = rows[0].map(function (h) { return String(h).trim().toLowerCase(); });
+    var hasHeader = head.indexOf('code') >= 0 || head.indexOf('text') >= 0 || head.indexOf('message') >= 0;
+    var ic = head.indexOf('code'), il = head.indexOf('level'), it = head.indexOf('text');
+    if (it < 0) it = head.indexOf('message');
+    var body = hasHeader ? rows.slice(1) : rows;
+    return fromRows(body.map(function (r) {
+      return hasHeader
+        ? { code: r[ic < 0 ? 0 : ic], level: il < 0 ? 'error' : r[il], text: r[it < 0 ? 2 : it] }
+        : { code: r[0], level: r[1], text: r[2] };
+    }));
+  }
+
+  var TssMessages = { fromRows: fromRows, fromCSV: fromCSV, parseCSV: parseCSV };
+  if (typeof module !== 'undefined' && module.exports) module.exports = TssMessages;
+  else root.TssMessages = TssMessages;
+})(typeof self !== 'undefined' ? self : this);