@threestarsoftware/tssgrid 0.1.29-beta.0 → 0.1.29-beta.2

package/CHANGELOG.md

@@ -6,7 +6,8 @@ TssGrid の各リリースの変更点。日付は JST。形式は [Keep a Chang
 ## [Unreleased]
 
 ### 追加（プラグイン）
-- **`tss-calendar` に範囲選択 `range` を追加** — 連続した日（休暇申請の開始〜終了など）を**1回の編集で**選べる。`range:true` で有効、`range:(ctx)=>boolean` で**行ごとにON/OFF**（半休の行は範囲を選ばせない等）。未指定は単日＝**従来動作**。1クリック目＝開始・2クリック目＝終了（**開始より前なら入替・同じ日を2回で単日確定**）、間の日に色が付く。1クリック目だけで閉じたら（Esc／外クリック）**値は変えない**。確定値は既定で `2026/10/13～2026/10/16`（単日は `2026/10/13`／区切りは `rangeSeparator`・既定 '～'／`rangeValue(startISO,endISO)` で完全差替可）。**入力中のセルに範囲ツールチップ**を出し、`rangeTooltip(startISO,endISO)` で文面を差し替え可能（休日を除いた日数などを外から足す口）。**休日スキップは利用側**＝カレンダーは範囲を返すだけ。範囲列は `type:'date'` を付けない素の列にする（範囲文字列を日付パーサに通さないため）。例 `examples/calendar-range.html`。
+- **`tss-calendar` に範囲選択 `range` を追加** — 連続した日（休暇申請の開始〜終了など）を**1回の編集で**選べる。`range:true` で有効、`range:(ctx)=>boolean` で**行ごとにON/OFF**（半休の行は範囲を選ばせない等）。未指定は単日＝**従来動作**。1クリック目＝開始・2クリック目＝終了（**開始より前なら入替・同じ日を2回で単日確定**）、間の日に色が付く。1クリック目だけで閉じたら（Esc／外クリック）**値は変えない**。確定値は既定で `2026/10/13～2026/10/16`（**単日は ISO `2026-10-13`＝範囲なしの単日と同じ形**で保存値が混ざらない／区切りは `rangeSeparator`・既定 '～'／`rangeValue(startISO,endISO)` で完全差替可・**同日も呼ばれる**）。**入力中のセルに範囲ツールチップ**を出し、`rangeTooltip(startISO,endISO)` で文面を差し替え可能（休日を除いた日数などを外から足す口）。**休日スキップは利用側**＝カレンダーは範囲を返すだけ。範囲列は `type:'date'` を付けない素の列にする（範囲文字列を日付パーサに通さないため）。例 `examples/calendar-range.html`。
+- **`tss-calendar` 範囲に「範囲で選ぶ」トグルを追加** — `range` が有効な行のカレンダー上部にトグル（チェックボックス）を出し、**OFF＝従来の単日**（1クリック確定・値 ISO・ツールチップ無し）／**ON＝範囲**（2クリック・間の色・ツールチップ）を編集中に切替可能。休暇申請はほとんどが1日なので**既定 OFF**（1クリックで決まる）。初期状態は `rangeDefault`（`true`／`(ctx)=>boolean`・既定 `false`）で、**どちらでもセル値が既に範囲なら ON で開く**。`range:(ctx)=>false` の行はトグルを出さない。文言は `rangeToggleLabel`（既定 `'範囲で選ぶ'`）。
 
 ## [0.1.28] - 2026-10-20
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threestarsoftware/tssgrid",
-  "version": "0.1.29-beta.0",
+  "version": "0.1.29-beta.2",
   "description": "軽量・ノービルド・日本語IME堅牢な編集グリッド（vanilla JS / 依存なし / MIT）。Excel ライクな入力画面を <script> タグ1本で。",
   "license": "MIT",
   "author": "ThreeStarSoftware (https://www.threestarsoftware.co.jp/)",

package/plugins/tss-calendar.css

@@ -18,6 +18,10 @@
   border: 1px solid var(--cal-border); border-radius: var(--cal-radius);
   box-shadow: 0 6px 24px rgba(0,0,0,.18); padding: 8px; font: var(--cal-font); user-select: none; outline: none;
 }
+/* 範囲選択トグル（range 有効行のみ上部に表示）。 */
+.tss-cal-toggle { display: flex; align-items: center; gap: 6px; margin: 0 2px 6px; padding: 3px 4px; font-size: 12px; color: var(--cal-fg); cursor: pointer; border-bottom: 1px solid var(--cal-border); user-select: none; }
+.tss-cal-toggle input { cursor: pointer; margin: 0; }
+.tss-cal-toggle:hover { color: var(--cal-accent); }
 .tss-cal-head { display: flex; align-items: center; justify-content: space-between; margin: 2px 2px 6px; }
 .tss-cal-title { font-weight: 600; }
 .tss-cal-sels { display: flex; gap: 4px; }

package/plugins/tss-calendar.d.ts

@@ -28,14 +28,21 @@ declare namespace TssCalendar {
     disable?: Array<'holiday' | 'weekend' | string>;
     /** 共有 input に乗る型（既定 true）＝直打ち可・矢印は本体へ。false でフォーカス奪取型。 */
     inline?: boolean;
-    /** 範囲選択（開始〜終了を1回の編集で）。`true` で全行有効／`(ctx)=>boolean` で行ごとに切替
-     *  （例: 半休の行は範囲を選ばせない）。未指定は単日＝従来動作。1クリック目=開始・2クリック目=終了
-     *  （開始より前なら入替・同日2回は単日確定）。確定値・ツールチップは下記で差し替え可。休日スキップは利用側。 */
+    /** 範囲選択を**使える行**にする。`true` で全行／`(ctx)=>boolean` で行ごと（例: 半休の行は `false`＝単日のみ）。
+     *  有効な行では上部に「範囲で選ぶ」トグルが出る: **OFF＝従来の単日**（1クリック確定・値 ISO・ツールチップ無し）／
+     *  **ON＝範囲**（1クリック目=開始・2クリック目=終了・開始より前なら入替・同日2回は単日・間の色・ツールチップ）。
+     *  未指定は常に単日＝従来動作。初期ON/OFFは `rangeDefault`、確定値・ツールチップ・文言は下記で差替可。休日スキップは利用側。 */
     range?: boolean | ((ctx: any) => boolean);
+    /** 「範囲で選ぶ」トグルの初期状態（`true`=ON/`(ctx)=>boolean` で行ごと・既定 `false`=OFF）。
+     *  いずれの場合も **セルの値が既に範囲なら ON で開く**。`range` が無効な行では無視（トグル自体が出ない）。 */
+    rangeDefault?: boolean | ((ctx: any) => boolean);
+    /** トグルの文言（既定 `'範囲で選ぶ'`）。 */
+    rangeToggleLabel?: string;
     /** 範囲値・ツールチップの日付区切り（既定 '～'）。 */
     rangeSeparator?: string;
-    /** 範囲の確定値を作る（既定 `'YYYY/MM/DD～YYYY/MM/DD'`／同日は `'YYYY/MM/DD'`）。
-     *  引数は開始・終了の ISO（'YYYY-MM-DD'・開始<=終了に整列済み）。別フィールド分割などはこの口で。 */
+    /** 範囲の確定値を作る。**同日（単日）のときも呼ばれる**。引数は開始・終了の ISO
+     *  （'YYYY-MM-DD'・開始<=終了に整列済み）。未指定の既定は 範囲=`'YYYY/MM/DD～YYYY/MM/DD'`／
+     *  **単日＝ISO `'YYYY-MM-DD'`（範囲なしの単日と同じ形）**。別フィールド分割などはこの口で。 */
     rangeValue?: (startISO: string, endISO: string) => string;
     /** 編集中セルに出す範囲ツールチップの文面（既定は範囲文字列）。休日を除いた日数などを外から足す口。 */
     rangeTooltip?: (startISO: string, endISO: string) => string;

package/plugins/tss-calendar.js

@@ -38,20 +38,29 @@
     var inline = opts.inline !== false;   // true=共有 input に乗る（直打ち可・矢印は本体に返す）／false=従来のフォーカス奪取型
 
     // ── 範囲選択（range）: 連続した日を1回の編集で選ぶ（休暇申請の開始〜終了 等）───────────
-    //   range:true で有効（行ごとに切替えたい時は range:(ctx)=>boolean）。未指定は単日＝従来動作。
-    //   1クリック目=開始、2クリック目=終了（開始より前なら入替・同日2回は単日確定）。間の日に色。
-    //   確定値は rangeValue(開始ISO,終了ISO)（既定 'YYYY/MM/DD～YYYY/MM/DD'・単日は 'YYYY/MM/DD'）。
-    //   入力中はセルに range のツールチップ（rangeTooltip で文面差替＝休日除く日数を外から足せる口）。
+    //   range:true で「範囲も選べる」行になる（行ごとに切替えたい時は range:(ctx)=>boolean）。未指定は常に単日＝従来動作。
+    //   range が有効な行では、カレンダー上部に「範囲で選ぶ」トグルが出る（文言は rangeToggleLabel）:
+    //     OFF＝従来の単日（1クリックで確定・値は ISO・ツールチップ無し）／ON＝2クリック（開始→終了・間の色・ツールチップ）。
+    //   トグルの初期状態は rangeDefault（true/関数(ctx)=>boolean・既定 OFF）。ただし **セル値が既に範囲なら ON で開く**。
+    //   ON 時の確定値は rangeValue(開始ISO,終了ISO)（既定: 範囲 'YYYY/MM/DD～YYYY/MM/DD'／同日は ISO 'YYYY-MM-DD'。rangeValue は同日も呼ぶ）。
     //   休日スキップは利用側（返すのは範囲だけ）。
     var rangeOpt = opts.range;
+    var rangeDefault = opts.rangeDefault;          // トグルの初期ON/OFF（bool or (ctx)=>bool・既定 false=OFF）
+    var rangeToggleLabel = opts.rangeToggleLabel != null ? opts.rangeToggleLabel : '範囲で選ぶ';
     var rangeSep = opts.rangeSeparator != null ? opts.rangeSeparator : '～';
     var rangeValueFn = typeof opts.rangeValue === 'function' ? opts.rangeValue : null;
     var rangeTooltipFn = typeof opts.rangeTooltip === 'function' ? opts.rangeTooltip : null;
-    function defRangeStr(aIso, bIso) { return aIso === bIso ? fmtSlash(aIso) : fmtSlash(aIso) + rangeSep + fmtSlash(bIso); }
-    function rangeValOf(aIso, bIso) { return (aIso !== bIso && rangeValueFn) ? rangeValueFn(aIso, bIso) : defRangeStr(aIso, bIso); }
-    function rangeTipOf(aIso, bIso) { return rangeTooltipFn ? rangeTooltipFn(aIso, bIso) : defRangeStr(aIso, bIso); }
-    var rc = null;                 // 現在の編集が range なら { td } を持つ（open(ctx) で ctx 判定して設定）
+    function defRangeStr(aIso, bIso) { return fmtSlash(aIso) + rangeSep + fmtSlash(bIso); }     // 表示用（両端 slash・範囲）
+    function rangeValOf(aIso, bIso) {
+      if (rangeValueFn) return rangeValueFn(aIso, bIso);                                         // rangeValue は同日も必ず呼ぶ（利用側で形を決められる）
+      return aIso === bIso ? aIso : defRangeStr(aIso, bIso);                                     // 既定: 単日＝ISO（範囲なしと同形）／範囲＝'YYYY/MM/DD～YYYY/MM/DD'
+    }
+    function rangeTipOf(aIso, bIso) { return rangeTooltipFn ? rangeTooltipFn(aIso, bIso) : (aIso === bIso ? fmtSlash(aIso) : defRangeStr(aIso, bIso)); }
+    function isRangeValue(v) { v = String(v == null ? '' : v); return !!rangeSep && v.indexOf(rangeSep) >= 0; }   // 既定書式の範囲値か（区切りを含む）
+    var rc = null;                 // この行で範囲が使えるなら { td, def } を持つ＝トグルを出す（open(ctx) で ctx 判定）
+    var rangeActive = false;       // トグルの現在値（ON＝2クリック範囲／OFF＝単日）。rc 無しの行は常に false
     var rangeStart = null, hoverEnd = null;   // 範囲選択の途中状態（1クリック目＝rangeStart、プレビュー終端＝hoverEnd）
+    function setRangeActive(on) { rangeActive = !!on; rangeStart = null; hoverEnd = null; clearTip(); render(); }  // トグル切替＝途中選択はリセット
 
     function disabled(d) {
       if (minD && d < minD) return true;
@@ -71,7 +80,9 @@
       var monSel = '<select class="tss-cal-sel-mon" aria-label="月">';
       for (var mm = 0; mm < 12; mm++) monSel += '<option value="' + mm + '"' + (mm === m ? ' selected' : '') + '>' + (mm + 1) + '月</option>';
       monSel += '</select>';
-      var html = '<div class="tss-cal-head">'
+      // range が使える行はトグル（範囲で選ぶ）を上部に。OFF=単日1クリック／ON=2クリック範囲。
+      var toggle = rc ? '<label class="tss-cal-toggle"><input type="checkbox" class="tss-cal-range-cb"' + (rangeActive ? ' checked' : '') + '><span>' + esc(rangeToggleLabel) + '</span></label>' : '';
+      var html = toggle + '<div class="tss-cal-head">'
         + '<button type="button" class="tss-cal-nav" data-nav="-1" aria-label="前の月">‹</button>'
         + '<span class="tss-cal-sels">' + yrSel + monSel + '</span>'
         + '<button type="button" class="tss-cal-nav" data-nav="1" aria-label="次の月">›</button></div>'
@@ -89,7 +100,7 @@
         if (sameDay(d, today)) cls += ' tss-cal-today';
         if (sameDay(d, sel)) cls += ' tss-cal-sel';
         if (sameDay(d, focus)) cls += ' tss-cal-focus';
-        if (rc && rangeStart) {                              // 範囲の途中＝開始〜(プレビュー)終端を塗る
+        if (rc && rangeActive && rangeStart) {               // 範囲の途中＝開始〜(プレビュー)終端を塗る（ON のときだけ）
           var ra = rangeStart, rb = hoverEnd || rangeStart, lo = ra <= rb ? ra : rb, hi = ra <= rb ? rb : ra;
           if (d >= lo && d <= hi) cls += ' tss-cal-inrange';
           if (sameDay(d, ra)) cls += ' tss-cal-range-start';
@@ -116,7 +127,8 @@
     }
     function onChange(e) {
       var t = e.target;
-      if (t.classList && t.classList.contains('tss-cal-sel-yr')) { view = new Date(+t.value, view.getMonth(), 1); render(); }
+      if (t.classList && t.classList.contains('tss-cal-range-cb')) { setRangeActive(t.checked); }   // 「範囲で選ぶ」トグル
+      else if (t.classList && t.classList.contains('tss-cal-sel-yr')) { view = new Date(+t.value, view.getMonth(), 1); render(); }
       else if (t.classList && t.classList.contains('tss-cal-sel-mon')) { view = new Date(view.getFullYear(), +t.value, 1); render(); }
     }
     function onKey(e) {
@@ -126,12 +138,12 @@
       if (k === 'Escape') { e.preventDefault(); cancel(); return; }
       if (k === 'Enter') { e.preventDefault(); if (!disabled(focus)) pick(focus); return; }
       var dx = { ArrowLeft: -1, ArrowRight: 1, ArrowUp: -7, ArrowDown: 7 }[k];
-      if (dx != null) { e.preventDefault(); focus = new Date(focus); focus.setDate(focus.getDate() + dx); view = new Date(focus.getFullYear(), focus.getMonth(), 1); if (rc && rangeStart) { hoverEnd = new Date(focus); updateTip(); } render(); return; }
+      if (dx != null) { e.preventDefault(); focus = new Date(focus); focus.setDate(focus.getDate() + dx); view = new Date(focus.getFullYear(), focus.getMonth(), 1); if (rc && rangeActive && rangeStart) { hoverEnd = new Date(focus); updateTip(); } render(); return; }
       if (k === 'PageUp' || k === 'PageDown') { e.preventDefault(); view = new Date(view.getFullYear(), view.getMonth() + (k === 'PageUp' ? -1 : 1), 1); render(); }
     }
     // range 途中: 日の上をなぞると終端プレビューを更新（間の色＋ツールチップ）。
     function onOver(e) {
-      if (!(rc && rangeStart)) return;
+      if (!(rc && rangeActive && rangeStart)) return;
       var dd = e.target.getAttribute && e.target.getAttribute('data-d');
       if (!dd) return;
       var d = parseISO(dd); if (!d || disabled(d)) return;
@@ -148,6 +160,7 @@
     function show(anchor, value, onPick, onCancel, rangeCfg) {
       teardown();   // 既に開いていれば先に片付ける（前の pop 除去＋outside リスナ解除・open-while-open の取り残し防止）
       done = false; rc = rangeCfg || null; rangeStart = null; hoverEnd = null;
+      rangeActive = rc ? (isRangeValue(value) || !!rc.def) : false;   // 既存値が範囲 or rangeDefault なら ON で開く
       sel = parseISO(value);
       // range の既存値（'YYYY/MM/DD～…' 等）は parseISO では取れない＝先頭日を緩く読んで月を合わせる。
       var initD = sel || (rc ? parseLoose(value) : null);
@@ -173,21 +186,22 @@
     function teardown() { clearTip(); if (outside) { document.removeEventListener('mousedown', outside, true); outside = null; } if (pop) { pop.remove(); pop = null; } }
     function pick(d) {
       if (done) return;
-      if (rc) {
+      if (rc && rangeActive) {   // トグル ON＝2クリック範囲
         if (!rangeStart) { rangeStart = d; hoverEnd = d; focus = new Date(d); render(); updateTip(); return; }   // 1クリック目＝開始（閉じない）
         var aIso = iso(rangeStart), bIso = iso(d);                                                              // 2クリック目＝終了
         if (bIso < aIso) { var t = aIso; aIso = bIso; bIso = t; }                                              // 逆順は入替／同日は単日
         done = true; var fr = ref.pick; teardown(); fr(rangeValOf(aIso, bIso)); return;
       }
-      done = true; var f = ref.pick; teardown(); f(iso(d));
+      done = true; var f = ref.pick; teardown(); f(iso(d));   // トグル OFF／range 無しの行＝単日1クリック（ISO）
     }
     function cancel() { if (done) return; done = true; var f = ref.cancel; teardown(); if (f) f(); }   // range 途中の取消も値は変えない（ref.cancel）
 
     return {
       // TssGrid カスタムエディタ契約
       open: function (ctx) {
-        var rangeMode = typeof rangeOpt === 'function' ? !!rangeOpt(ctx) : !!rangeOpt;   // 行ごとに range を切替（半休行は単日）
-        var cfg = rangeMode ? { td: ctx.td } : null;
+        var rangeMode = typeof rangeOpt === 'function' ? !!rangeOpt(ctx) : !!rangeOpt;   // この行で範囲を使えるか（半休行は false＝トグル無し）
+        var def = typeof rangeDefault === 'function' ? !!rangeDefault(ctx) : !!rangeDefault;  // トグル初期ON/OFF（行ごと可）
+        var cfg = rangeMode ? { td: ctx.td, def: def } : null;
         show(ctx.td, ctx.value, function (v) { ctx.commit(v); }, function () { ctx.cancel(); }, cfg);
       },
       close: function () { teardown(); },