@aiquants/period-slider 0.17.0 → 0.19.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 (43) hide show
  1. package/CHANGELOG.md +216 -0
  2. package/README.md +58 -50
  3. package/dist/DateSelector.d.ts +9 -9
  4. package/dist/DateSelector.d.ts.map +1 -1
  5. package/dist/MonthSelector.d.ts +5 -4
  6. package/dist/MonthSelector.d.ts.map +1 -1
  7. package/dist/PeriodSlider.d.ts +136 -35
  8. package/dist/PeriodSlider.d.ts.map +1 -1
  9. package/dist/VirtualDateDropdown.d.ts +24 -1
  10. package/dist/VirtualDateDropdown.d.ts.map +1 -1
  11. package/dist/YearSelector.d.ts +7 -4
  12. package/dist/YearSelector.d.ts.map +1 -1
  13. package/dist/index.cjs +1 -1
  14. package/dist/index.js +2631 -2610
  15. package/dist/inputValue.d.ts +20 -12
  16. package/dist/inputValue.d.ts.map +1 -1
  17. package/dist/optionText.d.ts +2 -2
  18. package/dist/optionText.d.ts.map +1 -1
  19. package/dist/selectorMemo.d.ts +30 -22
  20. package/dist/selectorMemo.d.ts.map +1 -1
  21. package/dist/selectorStep.d.ts +14 -22
  22. package/dist/selectorStep.d.ts.map +1 -1
  23. package/dist/useCommittedRef.d.ts +54 -27
  24. package/dist/useCommittedRef.d.ts.map +1 -1
  25. package/dist/usePeriodSlider.d.ts +32 -22
  26. package/dist/usePeriodSlider.d.ts.map +1 -1
  27. package/dist/useUncontrolledSelection.d.ts +32 -19
  28. package/dist/useUncontrolledSelection.d.ts.map +1 -1
  29. package/dist/vernierStep.d.ts.map +1 -1
  30. package/package.json +1 -1
  31. package/src/DateSelector.tsx +67 -73
  32. package/src/MonthSelector.tsx +57 -64
  33. package/src/PeriodSlider.tsx +255 -96
  34. package/src/VirtualDateDropdown.tsx +171 -111
  35. package/src/YearSelector.tsx +43 -73
  36. package/src/inputValue.ts +20 -12
  37. package/src/optionText.ts +9 -9
  38. package/src/selectorMemo.ts +41 -25
  39. package/src/selectorStep.ts +25 -32
  40. package/src/useCommittedRef.ts +70 -32
  41. package/src/usePeriodSlider.ts +252 -109
  42. package/src/useUncontrolledSelection.ts +58 -30
  43. package/src/vernierStep.ts +7 -7
package/CHANGELOG.md CHANGED
@@ -4,6 +4,222 @@ All notable changes to `@aiquants/period-slider` are documented here.
4
4
  見出しは版番号です。次の公開に入る変更は、その版番号と作成日の見出し (`## 0.14.0 (2026-09-24)` の形) の下へ書きます。
5
5
  本書は 0.10.0 で起こしたため、0.7.0 以前の項はありません (0.8.0 と 0.9.0 は公開済みの差分から起こした要約です)。
6
6
 
7
+ ## 0.19.0 (2026-10-02)
8
+
9
+ パッケージ全体が Date を時刻値のシステムのタイムゾーンで読むようにし、3 セレクタのメモ比較器と非制御の選択が、Date 型 Props の単位を検証と同じ関数 (`keyInsideDateRange`) で読むようにした版です。
10
+ 比較器が描画を省くかどうかと検証が拒否するかどうかは、2 つの実装が同じ時刻を求めることを前提にせず、構成上一致します。Props は増えず、通常の `Date` では Date の読み方による挙動の変化はありません。
11
+ あわせて、`DateSelector variant="dropdown"` の操作要素の `aria-activedescendant` と `aria-controls` が DOM に無い要素を指さないようにしました (Props と公開 API は変わりません)。
12
+ 4 つのフックは返す関数が値を渡すステートを `useReducer` で持ち、React が捨てた描画の中でホストが返す関数へ渡したオブジェクトを、後で同じオブジェクトのまま渡しても描くようにしました (Props と公開 API は変わりません)。
13
+ **自身のゲッターがシステムのタイムゾーンと別の年・月・日を名乗る Date (別のタイムゾーンで作った `@date-fns/tz` の `TZDate`、`@date-fns/utc` の `UTCDate` など) を
14
+ 3 セレクタ・本体・4 つのフック・公開の純関数へ渡すホストでは、下の「変更」と「修正」の点で挙動が変わります。**
15
+ **4 つのフックの設定関数へステートが既に持つオブジェクトを渡すホスト、受け渡しの記録が無い間 (マウントの後など) に保持する値と同じ値で確定経路
16
+ (`resetValue`・セレクタの `onChange`・`setLowerDate` など) を呼ぶホスト、そうした呼び出しの前後でホストの描画や `Profiler` の確定を数えるテストでは、下の「変更」の点で挙動が変わります。**
17
+ **`DateSelector variant="dropdown"` を開く前後で `Profiler` の確定を数えるテストと、操作要素の React の Props から `aria-activedescendant` を読むツールでも、下の「変更」の点で挙動が変わります。**
18
+
19
+ ### 変更
20
+
21
+ - **4 つのフックの設定関数へステートが既に持つオブジェクトを渡すと、子の描画を省くホストの描画が呼び出しごとに 1 度走ります**。
22
+ 対象は `setRange` / `setValue` / `setMacroRange` / `setMicroRange` / `setMicroValue` へステートのオブジェクトそのもの (引数をそのまま返す更新関数を含む) を渡す呼び出しで、
23
+ 更新の後の 2 度目以降の同じ呼び出しも含みます。これまでは、ホストに保留中の更新が無い間は React が描画を起こさずに捨てていました (更新の直後の 1 度目だけは同じ描画が走っていました)。
24
+ 設定関数以外の返す関数 (セレクタの `onChange`・`sliderProps` のコールバックなど) では、受け渡しの記録が無い間 (マウントの後、収め直しの記録の確定から別の確定を挟んだ後など。
25
+ 記録の確定の直後の呼び出しは、これまでも 1 度走っていました) に保持する値へ落ち着いたとき 1 度だけ走り、
26
+ その後の同じ値はこれまでどおり記録で省きます (更新の後の同じ値の呼び直しも、これまでどおり描画を起こしません)。パッケージの本体とセレクタは、設定関数以外の返す関数だけを呼びます。
27
+ 走る描画は子を描き直さず、副作用も DOM の変更もありません (`Profiler` の確定は 1 回増えます)。値・コールバック・返す関数とオブジェクトの同一性・マウントと収め直しの確定の回数は変わりません。
28
+ - **年の単位も、Date を時刻値のシステムのタイムゾーンで読みます**。`normalizeDateByUnit` は月と日の単位では時刻値の複製を読む一方、年の単位では Date 自身のゲッター
29
+ (`getFullYear` / `getMonth`) を読んでおり、`addUnit` の月・年の加算、`getMacroWindowEndDate` の年 × 月・年 × 日・月 × 日の期間、`resolveQuarter` / `formatQuarterLabel` の四半期、
30
+ `formatLabel` / `formatOptionText` の ISO と数字の表記 (`formatLocale` を渡さない段)、`YearSelector` の描く年・境界・`allowedYears` の要素も同じゲッターを読んでいました。
31
+ どれも時刻値のシステムのタイムゾーンでの年・月・日を読むため、ゲッターが別のタイムゾーンを名乗る Date の派生クラスは、同じ時刻の素の `Date` と同じ単位・同じ表記になります
32
+ (`encode` / `keyInsideDateRange` の年のキーと、それを読む本体・4 つのフックの年の単位の値と境界を含みます)。東京で `2024-03-31T20:00Z` (現地 4 月 1 日 5 時) の `UTCDate` は、
33
+ `yearStartMonth={3}` の `YearSelector` では 2023 年を描いていましたが 2024 年を描き、`formatLabel("day", ...)` は `2024-03-31` でしたが `2024-04-01` を返します。
34
+ `formatLocale` を渡した表記は以前から時刻値を読んでおり、変わりません。
35
+ - **`DateSelector variant="dropdown"` は、開くたびの確定が 1 回減り (jsdom の `Profiler` で 3 回 → 2 回)、描画範囲の通知による再描画が無くなります**
36
+ (jsdom のテストでこの再描画が出していた `act(...)` の警告も出ません)。`formatOption` の呼び出し回数は変わりません。
37
+ 操作要素の `aria-activedescendant` はアクティブ行の ref が書くため (下の「修正」)、操作要素の React の Props ではなくなり、開発ツールの Props には現れません
38
+ (DOM と支援技術から見える値は同じです)。
39
+
40
+ ### 修正
41
+
42
+ - **`MonthSelector` は `value` / `initialDate` / `minDate` / `maxDate` と `allowedMonths` の要素を、検証が判定する月 (時刻値のシステムのタイムゾーンでの月) で読みます**。
43
+ これまでは検証が時刻値の月を判定する一方、描く月・`min` / `max` の属性・選択肢・メモ比較器は各 Date 自身のゲッター (`getFullYear` / `getMonth`) の月を読んでおり、
44
+ ゲッターが別の月を名乗る Date では 2 つの月が食い違っていました (東京で `2024-03-31T20:00Z` (現地 4 月 1 日 5 時) の `UTCDate` を渡すと `2024-03` を描いていましたが、
45
+ `2024-04` を描きます)。比較器も同じ月で比べるため、そうした値を検証が拒む月へ動かした再描画は省かれずにその描画で `RangeError` になり (これまでは省かれ、
46
+ 拒否が次の無関係な変更まで遅れていました)、省いた描画は新規のマウントと同じ月を描きます。表現範囲の最初の月の近くで、ゲッターが表現範囲の外で始まる月を名乗る Date を
47
+ 検証が受け付けた描画は、内部関数の `RangeError` (`drawnValuesNeighbour: values.min must be a finite integer (received: NaN)`) で落ちていましたが、時刻値の月を描きます。
48
+ `YearSelector` の年と `DateSelector variant="split-dropdown"` の年の検査も、時刻値の読み方へ揃えました (上の「変更」と下の項)。
49
+ - **`DateSelector variant="split-dropdown"` は、ゲッターが別の年を名乗る Date の `value` / `initialDate` / `minDate` / `maxDate` を、描く年で検査します**。
50
+ これまでは年の検査 (`assertSplitYearProp`) が Props 自身のゲッターの年を、保持中の選択の検査と描画が時刻値の年を読んでおり、表現範囲の最初の年の近くで食い違っていました
51
+ (ニューヨークで `-271820-01-01T02:00Z` (現地 -271821 年 12 月 31 日 21 時) の `UTCDate` を `value` に渡すと、名指す日付の無い年の選択肢を描いて `formatOption` に Invalid Date を渡し、
52
+ `initialDate` に渡すと、初回のマウントが以前の描画から保持している選択を名指す `RangeError` になっていました)。どちらも同じ時刻の素の `Date` と同じく、
53
+ Props を名指す `RangeError` (`DateSelector: value must fall in a year that starts inside the Date range, because variant="split-dropdown" draws its year (received: ...)`) になります。
54
+ - **`DateSelector variant="dropdown"` の `aria-activedescendant` と `aria-controls` が、DOM に無い要素を指さなくなりました**。
55
+ 開く操作の最初の確定 (ポップアップの実測前) は listbox も行も無いのに両属性を持ち、ホイール・スクロールバーでアクティブ行を描画窓の外へ送ると、
56
+ スクローラの描画範囲の通知 (後のアニメーションフレーム) が届くまで消えた行を指したまま描かれ、スクロールやキー操作で窓へ戻すと、通知が届くまで名指しを欠いていました。
57
+ 開いたまま選択肢が 0 件になった確定も、閉じる前に存在しない listbox を `aria-controls` で指していました。
58
+ `aria-activedescendant` は Props ではなくアクティブ行の ref が書き、行を付けた確定で名指し、外した確定で消します。`aria-controls` はポップアップを描くのと同じ条件で名乗ります。
59
+ Activity・Suspense で隠れている間は `aria-activedescendant` を持たず、開いたまま表示し直すと同じ行を名指します (隠れている間に閉じても、表示後に消えた行を指しません)。
60
+ 開くたびの確定の回数と、操作要素の React の Props から属性が無くなる点は、上の「変更」にまとめました。
61
+ - **4 つのフックは、React が捨てた描画の中でホストが返す関数へ渡したオブジェクトを、後で同じオブジェクトのまま渡しても描きます**。
62
+ ホストが自分の描画の中で返す関数を呼んで Props へ追従し、React がその描画を捨てた後 (Suspense が保留した移行、取り消した移行) に、同じオブジェクトを
63
+ `setValue` / `setRange` / `setMacroRange` / `setMicroRange` / `setMicroValue` へ渡すと、これまでは描かれず、フックが別の理由で描き直されるまで
64
+ (取り消した移行の後では、いつまでも) 前の値に留まっていましたが、その確定が描きます (取り消した移行の後も、その場で描きます)。
65
+ 確定経路 (セレクタの `onChange` など) がそのオブジェクトを渡すとき (時点フックはレールに載っている Date をそのまま渡します) も、捨てた描画の後 (取り消した移行) にフックが一度描かれていれば、その確定が描きます。
66
+ これまでどおり、ホスト自身が渡した値は利用側が知っている値のため、通知しません。取り消した移行では、捨てた描画からフックが次に描かれるまでの間、返す関数はその描画が渡した値を読み、
67
+ 確定経路はそれと同じ値を渡しません (その呼び出しは描かれず、通知もされません。この版でも変わりません)。
68
+ Suspense が保留したままの移行では、React は確定のたびにその移行を描き直して捨て、ホストの描画中の呼び出しが同じ値を渡し直すため、写し・受け渡しの記録・利用側が知っている値は、
69
+ その移行が確定するか取り消されるまでその値に戻り続けます (シフトはそこから進み、その値と同じ確定経路の呼び出しは描かれず、通知もされません。この版でも変わりません)。
70
+
71
+ ### 移行
72
+
73
+ - 3 セレクタ・本体・4 つのフック・公開の純関数にゲッターが別のタイムゾーンを名乗る Date を渡し、そのゲッターの年・月・日を描かせていた、または読ませていたホストは、
74
+ 描かせたい年・月・日に属するシステムのタイムゾーンでの日付を渡してください。
75
+ - 4 つのフックの設定関数へステートが持つオブジェクトを渡す前後で `Profiler` の確定やホストの描画を数えていたテストは、呼び出しごとに 1 回多い回数を期待してください (上の「変更」)。
76
+ - `DateSelector variant="dropdown"` を開く前後の `Profiler` の確定を数えていたテストは、開くたびに 1 回少ない回数を期待してください。操作要素の React の Props から
77
+ `aria-activedescendant` を読んでいたツールは、DOM の属性を読んでください (上の「変更」)。
78
+
79
+ ## 0.18.0 (2026-10-02)
80
+
81
+ 単位を受け取るすべての公開の入口 (本体・4 つのフック・公開の純関数) が、`"year"` / `"month"` / `"day"` 以外の単位を日として読まず、
82
+ 名指しの `RangeError` で拒否するようにした版です。あわせて、ノギスの本体が描かない平レールの候補を読まないようにしました。
83
+ 3 セレクタ・4 つのフック・本体は描画中にステートを書かず、描画が導いた値をその確定で記録します (Suspense が保留した移行の間に選んだ値が描かれ、
84
+ 取り込み・収め直し・畳み込みの更新は、同じ値を描く 2 回目の確定を伴います)。`DateSelector variant="dropdown"` のポップアップは、移行が保留している間も
85
+ 画面に描かれている一覧だけを読み、配置だけが変わる描画では描かれている行を描き直しません。
86
+ 3 セレクタ (`YearSelector` / `MonthSelector` / `DateSelector`) の拒否メッセージを、本体・4 つのフック・公開の純関数と同じ 1 つの形へ揃えました
87
+ (この変更では、拒否する入力・判定の順序・例外型 (`RangeError`) は変わらず、変わるのはメッセージの文言だけです)。
88
+ **新しい Props・オプションを渡さないホストでも、下の「変更」の各点で挙動が変わります**
89
+ (型検査を経ずに単位を渡しているホスト (JavaScript・キャスト・型の無いデータから組んだ単位)、ノギスの `macroUnit` / `microUnit` に `null` を渡しているホスト、
90
+ ノギスに `allowedDates` を渡しているホスト、ノギスの `macroIsDiscrete` / `microIsDiscrete` に真偽値以外を渡しているホスト、ノギスでマウントしたスライダーを `range` / `value` を渡さずに range / point へ切り替えるホスト、
91
+ `formatOptionText` の単位の拒否メッセージや、宣言外の単位と他の不正な引数を同時に渡したときの拒否メッセージ、候補の一覧の拒否メッセージを照合するテスト、
92
+ セレクタ・フックのホスト・本体の確定を `Profiler` で数えるテスト、隠れた `<Activity>` の中でセレクタの `value` / `initialDate` やフックの境界を動かして戻すホスト、
93
+ `DateSelector variant="dropdown"` のポップアップを開いたまま `formatOption` の呼び出しや `Profiler` の確定を数えるテスト、
94
+ 3 セレクタの拒否メッセージを照合するテスト)。
95
+ 単位の判定は、`PeriodSliderUnit` を型どおりに渡す TypeScript のホストには影響しません。
96
+
97
+ ### 変更
98
+
99
+ - **宣言外の単位は名指しの `RangeError` になります**。`PeriodSlider` の `unit` (全モード) と `macroUnit` / `microUnit` (`vernier`)、4 つのフックの同名のオプション、
100
+ `normalizeDateByUnit` / `encode` / `decode` / `addUnit` / `getMacroWindowStartDate` / `getMacroWindowEndDate` / `resolveMacroWindow` / `findNearestDateIndex` /
101
+ `getSortedAllowedDates` / `formatLabel` / `formatScreenReaderLabel` / `calculateConnectDragValues` が、`resolveSelectorSteps` / `resolveVernierSelectorSteps` /
102
+ `formatOptionText` と同じ 1 つの判定と文言で拒否します (`encode: unit must be one of "year", "month", "day" (received: "decade")`)。これまでは日として読まれ
103
+ (`"decade"` のレールは日で描かれ・数えられ・歩かれました)、`formatLocale` を渡した `formatLabel` は Intl の既定の書式 (`1/15/2024`) で描き、
104
+ `customFormat` は宣言外の単位をそのまま受け取っていました。`findNearestDateIndex` / `getSortedAllowedDates` は空の一覧でも、`calculateConnectDragValues` は単位を読まない
105
+ 連続モードでも拒否し、`formatLabel` / `formatScreenReaderLabel` は Invalid Date でも `""` を返さずに拒否します。
106
+ - **単位は `yearStartMonth`・日付・`amount`・候補の一覧より先、無効日付の短絡・早期 return (`findNearestDateIndex` / `getSortedAllowedDates` の空の一覧、
107
+ `calculateConnectDragValues` の連続モードを含む) より先に判定します** (`formatOptionText` と同じ順序。`resolveSelectorSteps` / `resolveVernierSelectorSteps` は
108
+ これまでどおり、オプションがオブジェクトであること (`resolveVernierSelectorSteps` は `row` / `shows` も) を先に判定します)。宣言外の単位と他の不正な引数を同時に渡すと、単位の文言で拒否します
109
+ (`normalizeDateByUnit("decade", new Date(NaN))` はこれまで `normalizeDateByUnit: d must be a valid Date (received: Invalid Date)` でした)。
110
+ - **ノギスの `macroUnit` / `microUnit` を `unit` へ畳むのは省略 (`undefined`) のときだけです**。`null` は `RangeError` です
111
+ (`PeriodSlider: macroUnit must be one of "year", "month", "day" (received: null)`)。これまで本体は `null` を `unit` と読んでいました。
112
+ - **`formatOptionText` の宣言外の `unit` のメッセージを他の入口と同じ文言にしました**: `formatOptionText: unit must be "year", "month" or "day" (received: ...)` →
113
+ `formatOptionText: unit must be one of "year", "month", "day" (received: ...)`。
114
+ - **ノギスの `PeriodSlider` は、共有の `allowedDates` を、自分の一覧を省略した離散の行の読み出しでだけ読みます**。これまではノギスでも平レールの読み出しが
115
+ `allowedDates` を `unit` で読み (ノギスは平レールを描かないため、描画にも操作にも使われない読み出しでした)、配列でない値・有効な Date でない要素・
116
+ `unit` の始まりが表現範囲の外にある要素・`unit` での全滅を拒否していました。継ぐ行の無いノギス (離散のフラグを降ろした行と、自分の一覧を持つ行だけの構成) は
117
+ `allowedDates` を読まず、検証もしません。継ぐ行は一覧をその行の単位でだけ判定します (`unit="day"` / `macroUnit="month"` / `minDate` 2024-03-15 のノギスで
118
+ マクロ行が継ぐ `[2024-03-01]` は、日の単位では全滅でも月の単位では定義域に入るため受け付けます。`unit` がより粗いときにだけ始まりが表現範囲の外に出る要素は、
119
+ 行の単位で定義域の外として除かれます)。描画と操作は変わりません。
120
+ - **継いだ `allowedDates` の拒否は、どの誤りでも継いだ行を名乗ります**: `PeriodSlider: allowedDates must be an array of Dates (received: null)` →
121
+ `PeriodSlider: allowedDates (inherited by the micro row) must be an array of Dates (received: null)`、
122
+ `PeriodSlider: allowedDates[3] must be a valid Date (received: "x")` → `PeriodSlider: allowedDates[3] (inherited by the micro row) must be a valid Date (received: "x")`
123
+ (マクロ行が継いだときは `(inherited by the macro row)`)。両方の行が継ぐとき、また両方の行の自分の一覧が不正なときは、ミクロ行を先に読んで名乗ります
124
+ (ノギスのフックと同じ行。これまではマクロ行の `macroAllowedDates` を先に報告していました)。
125
+ - **本体の `macroIsDiscrete` / `microIsDiscrete` は、ノギスのフックと同じく `true` だけを離散と読みます**。これまで本体は `1` や `"yes"` などの真と評価される値も
126
+ 離散と読み、その行の候補の一覧を読んで検証していました (フックはその行を連続と読み、一覧を検証せずに `sliderProps` へ渡していました)。型検査を経ずに真偽値以外の
127
+ フラグを渡すホストでは、その行は連続のレールになります。
128
+ - **ノギスでマウントしたスライダーを、`range` / `value` を渡さない `mode="range"` / `"point"` へ切り替えると、そのモードの `defaultRange` / `defaultValue` から始まります**
129
+ (ミクロ選択の制御・非制御を問わず、新しくマウントした場合と同じ位置)。これまでは、マウント時のミクロ選択 (その後の操作を反映しない) を `unit` へ写した値
130
+ (`allowedDates` があればその候補へ寄せた値) から始まっていました。平レールを最初に操作するまでは `defaultRange` / `defaultValue` の変更に従います
131
+ (後から `vernier` へ切り替えたときのミクロ選択と同じ規則)。平レールでマウントしたスライダーの選択は、ノギスを往復しても保たれます。
132
+ - **取り込み・収め直し・畳み込みを描画中にステートへ書かず、描画が描いた値をその確定のレイアウト副作用で記録します** (セレクタの `initialDate` の取り込みと
133
+ 制御の描画、4 つのフックの境界・候補・窓への収め直し、本体のミクロ形態の切り替えで畳む非制御のミクロ選択と前面つまみ)。描く値と最初の確定は変わりませんが、
134
+ これらの更新は同じ値を描く 2 回目の確定を伴い、多くの場合で確定が 1 回増えます (jsdom の `Profiler` で数えた例: `DateSelector` / `MonthSelector` / `YearSelector` の取り込み 1 → 2、制御と非制御の切り替え 1 → 2
135
+ (`DateSelector variant="dropdown"` で `value` を渡す切り替えは 2 のまま)、`usePeriodSliderPoint` / `usePeriodSliderRange` の境界の移動による収め直し 1 → 2、
136
+ ノギスのフックの境界の移動によるマクロ窓の収め直し 1 → 2、本体のミクロ形態の期間から時点への切り替え 1 → 2。`DateSelector variant="dropdown"` の取り込みと、
137
+ 時点から期間への切り替えは 2 のまま)。2 回目の確定は描画前に同期で行われます。`DateSelector variant="dropdown"` の `formatOption` の呼び出し回数は
138
+ 変わりません (取り込みと切り替えで 2 回のまま)。`usePeriodSliderPoint` / `usePeriodSliderRange` のマウントはレールへ置いた初期値でステートを始めるため、
139
+ マウントの確定は 1 回のままです。`useVernierSliderPoint` / `useVernierSliderRange` に離散のミクロレールへ載らない初期値を渡したマウントは、確定が 1 → 2 回になります。
140
+ 隠れた `<Activity>` の中の確定は記録せず、表示したときにその描画の Props で記録します。そのため、隠れている間に `value` を渡して外す、または `initialDate` を
141
+ 別の単位へ動かして戻すと、表示したセレクタは隠す前の選択を描きます (これまでは `initialDate` を取り込み直していました)。隠れている間に境界を狭めて戻したフックは、
142
+ 畳む前の値を描きます (これまでは畳んだ値のままでした)。
143
+ - **`DateSelector variant="dropdown"` のポップアップは、開いている間に配置だけが変わる描画 (ページのスクロール・リサイズへの追従) で、描かれている選択肢の行を描き直しません**。
144
+ 行を描き直すのは、選択肢の一覧・保持値の行・アクティブ行のいずれかが変わる描画だけです (高さが変わって新しく描く行は描きます)。`formatOption` の呼び出しを数えるテストでは、
145
+ 開いている間のページのスクロール・リサイズ 1 回あたりの呼び出しが描画行数ぶんから 0 回になり (jsdom の実測で 37 回 → 0 回)、開いたまま件数を縮めた描画の呼び出しも
146
+ 行の描き直し 1 回分減ります (45 回 → 23 回)。`Profiler` で数える確定の回数は、スクロール・リサイズへの追従と件数の縮小で、スクローラが間引いて通知する範囲の時機により
147
+ jsdom でも実行ごとに 1 回ずれます (この版でも 0.17.0 でも、スクロール・リサイズで 1〜2 回、件数の縮小で 2〜3 回が出ます) ので、固定の回数で照合しないでください。
148
+ 開く・矢印キー・先頭一致入力・`End`・`Escape` の確定の回数は変わりません。
149
+ - **3 セレクタの拒否メッセージを、本体・フック・公開の純関数と同じ形 `<部品名>: <パス> <要件> (received: <値>)<直し方>` へ揃えました**。
150
+ パスを引用符で囲まず (これまでは `YearSelector` / `MonthSelector` と、`DateSelector` の `value` / `initialDate` の欠落のメッセージがバッククォート、それ以外の `DateSelector` が二重引用符)、受け取った値を `(received: ...)` に入れ
151
+ (これまでは `, received ...` / `(received ...)`)、理由は括弧の前に、直し方は閉じ括弧の後に `; ...` で続け、末尾に句点を付けません (これまでは `YearSelector` /
152
+ `MonthSelector` の文と、`DateSelector` の `value` / `initialDate` の欠落の文が句点で終わっていました)。例: `YearSelector: minDate must fall in a year that starts inside the Date range (received: -271821-04-20T00:00:00.000Z); declare the years to offer with minYear / maxYear or allowedYears instead of a sentinel for "no bound"`
153
+ (これまでは ``YearSelector: `minDate` must fall in a year that starts inside the Date range, received -271821-04-20T00:00:00.000Z; declare the years to offer with `minYear` / `maxYear` or `allowedYears` instead of a sentinel for "no bound".``)。
154
+ - **同じ条件は、本体・フックと同じ検証が同じ文言で拒否します**: 候補の一覧の形 (`<部品名>: allowedYears must be an array of Dates (received: ...)` など)、
155
+ 単位の始まりが Date の表現範囲の外にある日付 (`<部品名>: <パス> must fall in a <year|month|day> that starts inside the Date range (received: ...)`。
156
+ `DateSelector` の `fall on a day` は `fall in a day` になります)、`formatLocale` (`<部品名>: formatLocale must be a valid BCP 47 language tag (received: ...)`)、
157
+ `stepper` のフィールド (`<部品名>: stepper.onStep must be a function (received: ...)` など) と非制御での `stepper` (`<部品名>: stepper requires the controlled value; ...`)。
158
+ `DateSelector` の `variant="split-dropdown"` が年を描くための検査は、理由を添える `DateSelector` 自身の文言のままです (`..., because variant="split-dropdown" draws its year (received: ...)`)。
159
+ - **セレクタごとに違っていた文言を揃えました**。解決した境界の逆転は `<部品名>: the resolved upper bound must not precede the resolved lower bound (lower: ..., upper: ...)`
160
+ (これまでは `YearSelector` が `the resolved lower bound 2031 is after the resolved upper bound 2030.`、`MonthSelector` が同じ文を月で (`the resolved lower bound 2031-01 is after the resolved upper bound 2030-12.`)、`DateSelector` が
161
+ `the resolved range is empty (min ... is after max ...)`)。境界の欠落は `requires a lower bound (minYear or minDate) and an upper bound (maxYear or maxDate), or <一覧>; the option list is never invented`
162
+ (`variant="split-dropdown"` は `, or <一覧>` なし。バリアントを持たない `YearSelector` は `a lower bound (minYear or minDate) and an upper bound (maxYear or maxDate), or allowedYears, are required; the option list is never invented`。
163
+ これまでは `DateSelector` が `needs a bounded range; supply minDate/minYear and maxDate/maxYear ...`、`MonthSelector` が `the option window is never invented`、
164
+ `YearSelector` が `the year option list is never invented`)。`DateSelector` の年 Props は `whose first day starts inside` / `whose last day starts inside` (これまでは `is inside`) です。
165
+ - **番兵の境界に添える直し方は、本体と同じ `; <直し方> instead of a sentinel for "no bound"` の形です** (Props 名の引用符と、`instead` の前のカンマを外しました)。
166
+
167
+ ### 修正
168
+
169
+ - **ノギスのフックが `macroUnit` / `microUnit` の `null` を日と読み、本体は `unit` と読んでいた食い違いを直しました**。フックは `null` をそのまま
170
+ `sliderProps` へ渡すため、`unit: "month"` のフックの `shiftMacroRange(1)` が窓を 1 日動かす一方で、本体は月のレールを描いていました。どちらも同じ `RangeError` で拒否します。
171
+ - **ノギスのフックが受け付けた `allowedDates` で、その `sliderProps` を描く `PeriodSlider` が落ちていた食い違いを直しました**。離散のフラグを降ろした
172
+ `useVernierSliderRange` / `useVernierSliderPoint` は `null` などの一覧を受け付けてそのまま `sliderProps` へ渡す一方、本体は描かない平レールの読み出しで
173
+ それを拒否していました。本体とフックは同じ一覧を同じ行の単位で読み、行を離散と読むのも同じくフラグが `true` のときだけです。
174
+ - **非制御のセレクタで、Suspense が保留した移行の間に利用者が選んだ値が描かれなかった退行を直しました** (0.17.0 で `initialDate` の取り込みを描画のうちへ移したときに
175
+ 入りました)。非制御の `YearSelector` / `MonthSelector` / `DateSelector` で、`startTransition` で `initialDate` を別の単位へ動かした、または `value` を渡した移行が
176
+ Suspense で保留されている間に、利用者が ◀▶・選択肢・入力で選ぶと、`onChange` は選んだ値で鳴るのに、セレクタは選ぶ前の値を描き続けていました
177
+ (保留した描画が描画中に記録した取り込みを React が設定関数の即時の計算の基準に残し、選んだ値が取り込み直しで消えていました)。同期の事象でも `await` した事象でも起きていました。
178
+ - **`usePeriodSliderPoint` で、保留した移行が境界を動かして日付を収め直している間に、収め直し先と同じ Date オブジェクト (`minDate` / `maxDate` として渡したもの) を
179
+ `setValue` へ渡すと、別の理由で描き直されるまで描かれなかった問題を直しました**。
180
+ - **4 つのフックで、`startTransition` の中で呼んだ返す関数 (`setRange` / `setValue` / `setMicroRange` / `setMicroValue` など) の値が Suspense で保留している間に、
181
+ 境界・候補・窓の緊急の変化が確定済みの値を収め直すと、移行が確定したときに渡した値ではなく収め直した値が残っていた問題を直しました** (0.17.0 にもありました)。
182
+ 利用側へは渡した値を通知したまま (`setRange` などは自分で書いたまま)、収め直した値は通知されませんでした。収め直しの記録は、その描画が読んだステートにだけ当たり、
183
+ 保留中の受け渡しを上書きしません。
184
+ - **`DateSelector variant="dropdown"` のポップアップは、`startTransition` で渡した境界・`allowedDates`・`formatLocale`・`formatOption` が Suspense で保留している間も、
185
+ 画面に描かれている選択肢の一覧だけを読みます**。これまでは確定しなかった描画の一覧が内部に残り、先頭一致入力はその一覧で添字を引いて画面の一覧では別の日の行へ移り
186
+ (続く `Enter` はその別の日を発行し、`maxDate` を広げる移行の保留中に `2024` を打って `Enter` を押すと、2024-12-31 ではなく 2024-01-01 を発行していました)、ポップアップをホイールや
187
+ スクロールバーで送るとスクローラが描き足す行は保留中の一覧の日付を名乗っていました (その行の押下は、名乗った日ではなく画面の一覧の同じ位置の日を発行していました)。
188
+ キーボードの移動 (`ArrowDown` / `ArrowUp` / `Home` / `End` / `PageDown` / `PageUp`) は以前から画面の一覧を読んでいます。
189
+ - **開いたまま選択肢の件数が縮み、アクティブ行が一覧の外に出るとき、その行を指したままの確定を描かなくなりました**。これまでは件数を縮めた確定で `aria-activedescendant` が
190
+ 存在しない行の `id` を指し、`data-active="true"` の行が 1 つも無く (その間の `Enter` は何も発行せず)、次の確定でアクティブ行が末尾の行へ移っていました。件数を縮めた描画が
191
+ 末尾の行をアクティブ行として描きます。末尾の行へ移す規則と、件数が戻っても移した行に留まることは変わりません。
192
+
193
+ ### 移行
194
+
195
+ - 型検査を経ずに単位を渡していたホスト (JavaScript・キャスト・URL や JSON から組んだ単位) は、`"year"` / `"month"` / `"day"` のいずれかへ揃えてから渡してください
196
+ (大文字違い・空文字列・`null` も拒否します)。
197
+ - ノギスの `macroUnit` / `microUnit` に `null` を渡して `unit` と同じ単位を表していたホストは、その Props・オプションを省略 (`undefined`) してください。
198
+ - `formatOptionText` の単位の拒否メッセージを照合していたテストは、`formatOptionText: unit must be one of "year", "month", "day" (received: ...)` で照合してください。
199
+ - 宣言外の単位と他の不正な引数を同時に渡して、他の引数の文言を照合していたテストは、単位の文言 (`<入口名>: <引数名> must be one of "year", "month", "day" (received: ...)`)
200
+ で照合してください。
201
+ - ノギスで継いだ `allowedDates` の拒否メッセージを照合していたテストは、`(inherited by the micro row)` / `(inherited by the macro row)` 付きの文言で照合し、
202
+ 両方の行が継ぐ構成と両方の行の一覧が不正な構成ではミクロ行の文言で照合してください。
203
+ - 継ぐ行の無いノギスへ渡した `allowedDates` の拒否で不正な一覧を検出していたホストは、`getSortedAllowedDates` で一覧を検証してください。
204
+ - ノギスの `macroIsDiscrete` / `microIsDiscrete` に真偽値以外 (`1`・`"yes"`・一覧の長さなど) を渡して行を離散にしていたホストは、`true` を渡してください。
205
+ - ノギスから range / point へ切り替えたときにノギスで選んでいた期間を平レールの初期選択に使っていたホストは、その選択を `defaultRange` / `defaultValue`
206
+ (または制御の `range` / `value`) で渡してください。
207
+ - セレクタ・フックのホスト・本体の確定を `Profiler` で数えていたテストは、取り込み・収め直し・畳み込みの更新と、離散のミクロレールに載らない初期値で
208
+ マウントしたノギスのフックの確定を 1 回多く数えてください (上の「変更」の一覧)。
209
+ - 隠れた `<Activity>` の中で `value` を渡して外す、または `initialDate` を別の単位へ動かして戻すことでセレクタに `initialDate` を取り込ませていたホストは、
210
+ 表示した後に `initialDate` を別の単位へ動かすか、`key` を変えてセレクタをマウントし直してください。
211
+ - `DateSelector variant="dropdown"` のポップアップを開いたまま `formatOption` の呼び出しや `Profiler` の確定を数えていたテストは、配置だけが変わる描画
212
+ (ページのスクロール・リサイズへの追従) と件数を縮めた描画で、描かれている行の描き直しによる `formatOption` の呼び出しを数えず、スクロール・リサイズへの
213
+ 追従と件数の縮小の確定の回数が実行ごとに 1 回ずれることを許してください (上の「変更」)。
214
+ - 3 セレクタの拒否メッセージを照合していたテストは、新しい文言で照合してください。主な置き換えは次のとおりです (型と、拒否する入力は変わりません)。
215
+ ``YearSelector: `value` must be a valid Date, received Invalid Date.`` → `YearSelector: value must be a valid Date (received: Invalid Date)`、
216
+ ``MonthSelector: `allowedMonths` must be an array of Dates, received null.`` → `MonthSelector: allowedMonths must be an array of Dates (received: null)`、
217
+ `DateSelector: "minDate" must fall on a day that starts inside the Date range (received ...)` → `DateSelector: minDate must fall in a day that starts inside the Date range (received: ...)`、
218
+ `DateSelector: "stepper.onStep" must be a function (received "next")` → `DateSelector: stepper.onStep must be a function (received: "next")`、
219
+ ``YearSelector: `stepper` requires the controlled `value`; ...`` → `YearSelector: stepper requires the controlled value; ...`、
220
+ ``YearSelector: either `value` (controlled) or `initialDate` (uncontrolled) is required; ...`` → `YearSelector: either value (controlled) or initialDate (uncontrolled) is required; ...`。
221
+ 解決した境界の逆転・境界の欠落・番兵の直し方は上の「変更」の文言で照合してください。
222
+
7
223
  ## 0.17.0 (2026-10-01)
8
224
 
9
225
  候補の一覧 (`allowedDates` / `allowedYears` / `allowedMonths` / `macroAllowedDates` / `microAllowedDates`) が一覧かどうかを 1 つの規則で判定し、