@aiquants/period-slider 0.20.0 → 0.21.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.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,79 @@ 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.21.0 (2026-10-30)
8
+
9
+ つまみとラベルの飾りの層が、文書のスクロールの範囲を広げなくなりました。`@aiquants/virtualscroll` の下限を 3.22.1 へ上げるため、
10
+ **0.x の破壊的変更を含むマイナー版です** (下の「移行」を参照。本パッケージの Props と公開 API の宣言は変わりません)。
11
+
12
+ ### 変更 (破壊的)
13
+
14
+ - **`@aiquants/virtualscroll` は 3.22.1 以上が必要です** (`^3.8.0` から `^3.22.1`)。公開時の peer 範囲は `^3.22.1` へ展開されます。
15
+ 本パッケージが使うのは `DateSelector variant="dropdown"` のポップアップの `VirtualScroll` とラベルの表だけで、3.22.1 で単体テストと E2E を通しています。
16
+ 3.8.0 から上げると、ポップアップの中では次が変わります (そのほかは virtualscroll の CHANGELOG を参照)。
17
+ - **スクロールバーは、名前と値を持つ `role="scrollbar"` の溝 1 つと、その外に並ぶ矢印のボタン 2 つになります** (virtualscroll 3.20.0)。
18
+ つまみは描くだけの要素で、`role="slider"` を持ちません。溝の名前はエンジンキー `verticalScrollBar` (`Vertical` / `縦方向`) です。
19
+ - **ラベルの語彙は 31 キー (エンジン 9 + 固有 22) になります**。`PeriodSliderLabels`・`PeriodSliderLabelOverrides`・`PERIOD_SLIDER_LABEL_KEYS` のエンジンの部分は、
20
+ インストールされた virtualscroll の `VIRTUAL_SCROLL_LABEL_KEYS` から導くため、3.8.0 の 7 キーに `verticalScrollBar` と `horizontalScrollBar` が加わります
21
+ (3.10.0 で加わったつまみの名前の 2 キー `verticalScrollThumb` / `horizontalScrollThumb` は、3.20.0 で外れました)。
22
+ - **使えない矢印のボタンの字は、バーの幅から作る SVG の三角形になります** (3.14.0。これまでは文字の `▲` / `▼`)。
23
+
24
+ ### 修正
25
+
26
+ - **つまみとラベルが掴んだ瞬間に光らせる飾りの層 (`::before` / `::after`) が、祖先と文書のスクロールの範囲に数えられなくなりました。**
27
+ 層は見えない間 (`opacity: 0`) も箱を持ち、`::after` は載り先の 2 倍の大きさで四方へ半分ずつはみ出し、掴んでいる間はキーフレームの終わり (斜めに 120% 先、`::before` は 3.2 倍) に留まります。
28
+ 0.20.1 までは、ラベルが画面の右端や下端の近くにあると見えない層の分だけ文書が横や縦へ送れ、横のホイールやタッチパッドの操作で画面全体がずれました
29
+ (ラベルを文書の右端に接させると静止時に 30px、掴んでいる間は約 200px。縦向きの下のつまみは掴んでいる間に約 100px)。
30
+ 配布スタイルシートは `.period-slider-knob` と `.period-slider-tooltip` へ `contain: layout` を宣言し、層のはみ出しを描画だけのはみ出しにします。描画は切らないため、光の見た目は変わりません。
31
+ この送りを防ぐためにスライダーの祖先へ `overflow-x: clip` などを指定していたホストは、ほかに切る理由が無ければ指定を外せます。
32
+ 掴んでいる間に 1.15 倍で描かれるラベルは描かれた内容なので、スクロールの範囲に数えられます (ラベルを文書の端に接させると、掴んでいる間だけラベルの大きさの 7.5%、幅 65px のラベルで約 5px)。
33
+
34
+ ### 移行
35
+
36
+ - `@aiquants/virtualscroll` を 3.22.1 以上へ上げてください (`pnpm add @aiquants/virtualscroll@^3.22.1`)。`VirtualScroll` を自分でも使うホストは、virtualscroll の CHANGELOG の 3.8.1〜3.22.1 も読んでください。
37
+ - `PeriodSliderLabels` を全キーそろえて組み立てるホスト (独自の言語のカタログなど) は、`verticalScrollBar` と `horizontalScrollBar` を足してください。
38
+ `labels` へ `verticalScrollThumb` / `horizontalScrollThumb` を渡していたホスト (virtualscroll 3.10.0〜3.19.x で動かしていた場合) は外してください。未知のキーは描画時の `RangeError` です。
39
+ - 日付のドロップダウンのポップアップのスクロールバーを `[role="slider"]` / `getByRole("slider")` で引いていたテストは、値と名前を `[role="scrollbar"]` / `getByRole("scrollbar")` から読んでください。
40
+ 矢印のボタンは `role="scrollbar"` の要素の兄弟で、`closest('[role="scrollbar"]')` では辿れません。ページの `getByRole("slider")` は、ポップアップを開いている間もスライダーのつまみだけに当たります。
41
+
42
+ ### 文書
43
+
44
+ - README の「配置の注意」に、文書のスクロールの範囲に数えられるもの (ルート要素の箱、ラベル、交差軸へ伸びる当たり判定と範囲領域のレーン、掴んでいる間のラベルの拡大) を書き足しました。
45
+ - README は、ポップアップのスクロールバーを virtualscroll 3.20.0 以後の形 (名前と値を持つ `role="scrollbar"` の溝 1 つ・その外の矢印のボタン 2 つ・見た目だけのつまみ) で述べ、
46
+ 溝の名前のキー (`verticalScrollBar`) を、`locale` と `labels` が決める名前の一覧に加えました。
47
+
48
+ ## 0.20.1 (2026-10-03)
49
+
50
+ 4 つのフックの `duringRender(action)` は、`action` が何も記録しない描画に印を付けなくなり、そうした描画では React がホストの子の描画を省くようにしました (Props と公開 API は変わりません)。
51
+ **`duringRender` を呼ぶホストの描画・子の描画・`Profiler` の確定を数えるテストでは、下の「修正」の点で数が変わります。**
52
+
53
+ ### 修正
54
+
55
+ - **`duringRender(action)` の `action` が何も記録しない描画では、React がホストの子の描画を省くようになりました。**
56
+ 0.20.0 では、描画の中で最初に呼んだ `duringRender` が `action` の中身によらずその描画に印を付け、印がフック内部のステートを変えたため、
57
+ ステートが既に持つオブジェクトの受け渡しや、確定した受け渡しの記録が走らせる描画でも、ホストの本体がもう 1 度走って子も描き直されていました
58
+ (描いている日付への追従を描画のたびに呼ぶ時点フックのホストで、同じオブジェクトの `setValue` は本体 2・子 1・確定 1、目標を動かした追従は本体 4・子 2・確定 2)。
59
+ 印は、`action` の中の返す関数がその描画で最初に何か (写しや利用側が知っている値への書き込み・受け渡し・通知) を記録したときに付けます。
60
+ 何も記録しない描画は本体の実行も子の描画も増やしません (同じ例で本体 1・子 0・確定 1 と、本体 3・子 1・確定 2)。
61
+ 記録した描画は 0.20.0 と同じく、印でその描画の続きに結ばれ、ほかに変化が無くても確定して記録した分を当てます (印は確定を増やしません)。
62
+ 何も記録しない描画は React が省き得るため、その直後の同じ同期の処理 (`flushSync` や同期の `act` の直後など) で誤って `duringRender` を呼んでも、
63
+ `Error` にならないことがあります (検出しない誤用で対応外。0.20.0 では印がその描画を確定させたため送出していました)。ほかのコンポーネントの描画の中で
64
+ 何も記録しない `action` を呼ぶ誤用では、React の「Cannot update a component while rendering a different component」警告も出ません。
65
+
66
+ ### 変更
67
+
68
+ - **`@aiquants/virtualscroll` のピア依存の下限を 3.8.0 に上げました** (`^3.7.0` から `^3.8.0`)。本パッケージが使うのは `VirtualScroll` とラベルの表だけで、
69
+ 3.7.1 (Pointer Capture API の無い環境で例外を出さない) と 3.8.0 (矢印を Tab の止まり先から外す選択肢は既定で従来どおり・`VirtualGrid` の横バーの変更・
70
+ 行の平行移動を装置の画素へ揃える) を取り込んだ版で、単体テストと E2E を通しています。
71
+ - **公開の流れで tarball の漏洩検査を必ず通すようにしました**。`publish:patch` / `publish:minor` / `publish:major` は typecheck → ビルド → テスト → 検査 →
72
+ 版上げ → 公開の順に、素の `pnpm publish` が起動する `prepublishOnly` はビルドの後に検査を走らせます。検出が 1 件でもあれば版上げの前に止まります。
73
+
74
+ ### 文書
75
+
76
+ - 同梱の CHANGELOG の 0.10.0 の節が参照していた、tarball に含まれない設計文書への参照 2 件を、参照先が決めていた内容 (範囲領域の作り・◀▶ を描く 1 つの部品・
77
+ ドラッグの連続描画が公開する値を変えないこと) の記述へ置き換えました。
78
+ - 0.20.0 の公開の後に文書を実装へ合わせました (同じオブジェクトの受け渡しなどが走らせる描画で子の描画を省く条件、描画中の対応外の直接の呼び出しが残す受け渡しの記録の影響、欠けていた docstring)。
79
+
7
80
  ## 0.20.0 (2026-10-02)
8
81
 
9
82
  4 つのフック (`usePeriodSliderRange` / `usePeriodSliderPoint` / `useVernierSliderRange` / `useVernierSliderPoint`) は `duringRender(action)` を返すようにしました。
@@ -25,9 +98,10 @@ All notable changes to `@aiquants/period-slider` are documented here.
25
98
  ステートへの受け渡しは React の描画中の更新になり、写し・受け渡しの記録・利用側が知っている値への書き込みと通知はその描画の範囲へ入り、その描画の確定が当てます。
26
99
  範囲を続けるのは、`duringRender` を呼んだ描画の続き (描画中の更新の後の走らせ直し、`StrictMode` の 2 度目の呼び出し、中断した描画のデータが解決した後の再実行) だけです。
27
100
  React が捨てた描画の範囲は、同じステートを持つ後の別の描画が確定しても当たらず、後の描画の `action` の書き込みと通知を消しもしません。これを見分けるため、
28
- 描画の中で最初に呼んだ `duringRender` はその描画に印を描画中の更新として付けます (`action` が何も渡さない描画でも、ホストの本体が同じ描画の中でもう 1 度走ります。子の描画と確定は増えません)。
101
+ 描画の中で最初に呼んだ `duringRender` はその描画に印を描画中の更新として付けます (`action` が何も渡さない描画でも、ホストの本体が同じ描画の中でもう 1 度走ります。確定は増えません。
102
+ 子の描画は、ホストがもともと子を描く描画では増えませんが、子の描画を省くはずの描画 (ステートが既に持つオブジェクトの受け渡しや、下の記録が走らせる描画) で `duringRender` を呼ぶと、印のため子も描き直します)。
29
103
  `action` の中でステートを変える値を渡した描画の確定は、その受け渡しを、ホストのレイアウト副作用からステートの更新の列へ同一性で守った更新関数として記録します。
30
- その描画が飛ばした優先度の低い受け渡し (移行の中で渡した値) を React が後で当て直しても、保存される値は通知した値に行き着きます。記録の分、子の描画を省くホストの描画が 1 度走ります。
104
+ その描画が飛ばした優先度の低い受け渡し (移行の中で渡した値) を React が後で当て直しても、保存される値は通知した値に行き着きます。記録の分、ホストの描画が 1 度走ります (その描画で `duringRender` を呼ばないホストでは子の描画を省き、呼ぶホストでは子も描き直します)。
31
105
  通知はその描画のコールバックを呼び、ホストのレイアウト副作用で届きます (その確定で先に走る子孫のレイアウト副作用がフックへ書くか通知するときはその前、
32
106
  隠れた `<Activity>` の中の確定ではマイクロタスク)。入れ子のホストでは子から親の順に、1 つのホストの複数のフックではフックを呼んだ順に届きます。
33
107
  サーバー描画では確定が無いため、`action` の中の呼び出しはコールバックを呼びません。ほかのコンポーネントのステートを書くコールバックでも、
@@ -35,7 +109,7 @@ All notable changes to `@aiquants/period-slider` are documented here.
35
109
  その描画がフックを呼んだ後に事象の時点の呼び出しが書いたステートと、描画が持たない事象の時点の受け渡し (移行が譲っている間にホストの描画より前に渡した値、
36
110
  その描画が飛ばす優先度の移行の中で渡した値) を待つステートには、その描画の分を当てません (ノギスのフックではスケールごと。React は事象の更新を後で当て、そちらが勝ちます)。
37
111
  `action` の中の受け渡しがまだ確定し得る間は、表示中の値へ落ち着く事象の時点の呼び出しも同じ値をステートへ渡し直し、後の操作として勝ちます。
38
- 渡し直しは子の描画を省くホストの描画を 1 度走らせます (React が捨てた描画の `action` が値を渡した後も、ホストが次に描かれるまでは、最初のそうした呼び出しで同じく 1 度走ることがあります)。
112
+ 渡し直しはホストの描画を 1 度走らせます (その描画でも `duringRender` を呼ぶホストでは子も描き直します。React が捨てた描画の `action` が値を渡した後も、ホストが次に描かれるまでは、最初のそうした呼び出しで同じく 1 度走ることがあります)。
39
113
  フックの描画の範囲が閉じた後 (フックの最後の描画が確定した後と、本体を走らせた同期の処理が終わった後。副作用・イベントハンドラ・フックを呼んだ後に積んだマイクロタスクの中) に `duringRender` を呼ぶと
40
114
  `Error` (`<フック名>: duringRender(action) must be called during the host's render, after the hook call (call the returned functions directly from event handlers and effects)`)、
41
115
  `action` が関数でなければ `TypeError` (`<フック名>: duringRender(action) must be a function (received: ...)`) です。`action` の中でほかのフックのインスタンスの返す関数を呼ぶと、
@@ -71,7 +145,9 @@ All notable changes to `@aiquants/period-slider` are documented here.
71
145
  押下と同じ事象の中でホストが隠す場合は、押下の確定が `Activity` では 4 回から 5 回に、`Suspense` では 2 回から 3 回に増え、表示し直す確定が 2 回から 1 回になります。
72
146
 
73
147
  - **描画中に `duringRender` の外で返す関数を呼ぶのは対応外です**。そうした呼び出しは 0.19.0 と同じく事象の時点の呼び出しとして、その場で写し・受け渡しの記録・利用側が知っている値を書いて通知し、
74
- React が捨てた描画の中の呼び出しでも書き込みと通知を残します。描画中の呼び出しは `duringRender(action)` で包んでください (上の「追加」と下の「移行」)。
148
+ React が捨てた描画の中の呼び出しでも書き込みと通知を残します (受け渡しの記録も React が捨てた受け渡しを指したまま残るため、以後そのステートへの `duringRender` の受け渡しは、
149
+ 事象の時点の呼び出しがそのステートへ値を渡すか、記録が指すオブジェクトそのものをステートが持つ描画が確定するまで、描かれても通知されません)。
150
+ 描画中の呼び出しは `duringRender(action)` で包んでください (上の「追加」と下の「移行」)。
75
151
  `duringRender` の外の呼び出しは、事象の処理・副作用・マイクロタスク・確定の途中 (子孫のレイアウト副作用の後始末など)・子の描画を省いたホストの描画の直後のどこで呼んでも、
76
152
  事象の時点の呼び出しです。`duringRender` の動作の中でほかのフックのインスタンスの返す関数を呼ぶと、そのインスタンスは何もせずに `Error` を送出します (上の「追加」)。
77
153
  - **ノギスのフックの操作は、動かさないスケールをステートへ渡しません**。片方のスケールだけを動かす確定経路 (マクロ窓は `setMacroLowerDate` / `setMacroUpperDate`・`shiftMacroRange`・
@@ -82,7 +158,7 @@ All notable changes to `@aiquants/period-slider` are documented here.
82
158
  保存する値を最後に通知した値と揃えます。操作の結果もう片方のスケールも動くとき (窓の移動で置き直したミクロ選択、窓を追従させるミクロの ◀▶) と `resetVernier` は、両方のスケールを確定します。
83
159
  動かすスケールは、返す関数の読む値 (確定したもう片方のスケール) に照らして置きます。追従した値と動かした値の両方を持つ描画でミクロ選択が窓に収まらないときは、
84
160
  その描画が収め直しと同じくミクロ選択を置き直し (その場では通知しません)、その値は次にそれへ落ち着いた操作で通知されます。
85
- そのため、マウントの後にまだ何も渡していないスケールへの同じ値の確定経路は、もう片方のスケールの操作の後でも、子の描画を省くホストの描画を 1 度走らせます。
161
+ そのため、マウントの後にまだ何も渡していないスケールへの同じ値の確定経路は、もう片方のスケールの操作の後でも、ホストの描画を 1 度走らせます (その描画で `duringRender` を呼ばないホストでは子の描画を省きます)。
86
162
  例えば `useVernierSliderRange` で、ミクロだけを動かす `setMicroUpperDate` の後に窓と同じ値の `setMacroUpperDate` を呼ぶと、0.19.0 では `setMicroUpperDate` が窓も渡して記録していたため描画が走りませんでしたが、
87
163
  この版では 1 度走り、以後のホストの描画の回数が 1 つずつ増えます (`Profiler` の確定も 1 回増えます)。
88
164
  - **4 つのフックは、ステートへ最後に渡した値の記録を、その受け渡しを持たない描画を挟んでも保ちます**。移行の中で渡した値を飛ばして確定した緊急の描画や、
@@ -125,7 +201,7 @@ All notable changes to `@aiquants/period-slider` are documented here.
125
201
  もう片方のスケールの操作の後でも 1 回増えることを期待してください (上の「変更」)。
126
202
  - 移行の中で渡した値を飛ばした描画 (その後の緊急の描画や、移行の描画が譲っている間に渡した値を持たないその移行の描画) を挟み、その値の確定の後に同じ値の確定経路を呼ぶ前後で
127
203
  `Profiler` の確定やホストの描画を数えるテストは、0.19.0 より 1 回少なく期待してください (4 つのフックに共通。上の「変更」)。
128
- - `duringRender` で包んだ呼び出しがステートを変える値を渡した描画の確定の後には、その受け渡しの記録のため、子の描画を省くホストの描画と `Profiler` の確定が 1 回ずつ続きます。
204
+ - `duringRender` で包んだ呼び出しがステートを変える値を渡した描画の確定の後には、その受け渡しの記録のため、ホストの描画と `Profiler` の確定が 1 回ずつ続きます (その描画で `duringRender` を呼ばないホストでは子の描画を省き、呼ぶホストでは子も描き直します)。
129
205
  0.19.0 で描画中に直接呼んでいた追従を包んだホストでその前後を数えるテストは、1 回多く期待してください。`action` が何も渡さない描画では、ホストの本体が同じ描画の中で
130
206
  もう 1 度走ります (確定は増えません)。
131
207
 
@@ -1342,9 +1418,9 @@ All notable changes to `@aiquants/period-slider` are documented here.
1342
1418
 
1343
1419
  ## 0.10.0
1344
1420
 
1345
- 範囲領域 (range area) の `Shift` + ホイール、ステッパーの矢印言語、ドラッグの連続描画。統治文書はリポジトリの
1346
- `docs/plans/2026.09.17 [AI] range-area-shift-wheel-and-stepper-arrow-language-implementation-plan.md` と
1347
- `docs/plans/2026.09.18 [AI] continuous-drag-presentation-implementation-plan.md` (どちらも公開物には同梱しません)。
1421
+ 範囲領域 (range area) の `Shift` + ホイール、ステッパーの矢印言語、ドラッグの連続描画。範囲領域はルートの箱・ラベルの帯を覆う子要素・
1422
+ ルートの中のポインターの標的を合わせた領域で、8 つの ◀▶ は 1 つの部品が同じ形・大きさ (当たり判定 44px の `--ps-target-size`)・配色で描きます。
1423
+ ドラッグの連続描画は、公開する値 (スナップ・コールバック・`debounceMs`・`aria-valuenow`) を変えない表示の層です。
1348
1424
 
1349
1425
  ### 利用側の契約が変わる点 (0.9.0 からの移行)
1350
1426
 
package/README.md CHANGED
@@ -128,7 +128,7 @@ peer dependency の `@aiquants/virtualscroll` のスタイルシートは、本
128
128
 
129
129
  - **`locale` と `formatLocale` は別の軸です**。`locale` は部品の名前の言語 (閉じた `"en"` / `"ja"`)、`formatLocale` は日付テキストの書式 (任意の BCP 47 タグ) です。`formatLocale="ja-JP"` を渡しても名前は英語のまま、`locale="ja"` を渡しても日付は ISO 8601 のままです。**言語ネゴシエーションは行いません**: `navigator.language` などからの対応付けはホストの責務です。
130
130
  - **日付の書式を `locale` へ渡さないでください**。`"ja-JP"` のようなタグは `RangeError` で止まりますが、`"ja"` / `"en"` は日付書式の BCP 47 タグとしても正当である一方、`locale` の受理値そのものでもあるため拒否されません。その場合、日付テキストは ISO 8601 のまま (`2024-01`) で、`"ja"` では部品の名前だけが切り替わり (`Previous month` → `前月`)、アクセシブル名や Intl 書式の日付を照合するテストは原因を示さずに失敗します。日付の書式は常に `formatLocale` へ渡し、部品の名前を日本語にしたいときだけ `locale="ja"` を加えます。フックのオプションと `SelectorProps` も同じです。
131
- - `PeriodSliderLocale` は `@aiquants/virtualscroll` の `VirtualScrollLocale` そのものです。エンジンの 7 キーは `VIRTUAL_SCROLL_LABEL_CATALOGS` の値をそのまま再利用し、本パッケージでは書き直しません。
131
+ - `PeriodSliderLocale` は `@aiquants/virtualscroll` の `VirtualScrollLocale` そのものです。エンジンのキー (`VIRTUAL_SCROLL_LABEL_KEYS` の全件) は `VIRTUAL_SCROLL_LABEL_CATALOGS` の値をそのまま再利用し、本パッケージでは書き直しません。
132
132
 
133
133
  ```tsx
134
134
  // 名前は日本語、日付は ja-JP の Intl 書式 (2 つの軸を両方指定)
@@ -142,7 +142,7 @@ const labels = { rangeStart: "調査開始月", rangeEnd: "調査完了月", pre
142
142
 
143
143
  #### カタログ (`PERIOD_SLIDER_LABEL_CATALOGS`)
144
144
 
145
- 全 29 キー (エンジン 7 + 固有 22)。`PERIOD_SLIDER_LABEL_KEYS` はこの順の閉じたキー集合です。
145
+ `@aiquants/virtualscroll` のエンジンキー (`VIRTUAL_SCROLL_LABEL_KEYS`) の全件と固有 22 キーです。`PERIOD_SLIDER_LABEL_KEYS` はエンジンキーをエンジンの順に並べ、その後に固有 22 キーを表の順で続けた閉じたキー集合です。表のエンジンキーは対応するどのエンジン版にもあるキーで、インストールされたエンジンの `VIRTUAL_SCROLL_LABEL_KEYS` がそれ以外のキーを持てば、そのキーも同じく上書きでき、検証はエンジン自身が行い、`DateSelector variant="dropdown"` の内蔵 VirtualScroll へ転送されます。
146
146
 
147
147
  | キー | 読む部品 / 面 | `en` | `ja` |
148
148
  | :--- | :--- | :--- | :--- |
@@ -186,7 +186,7 @@ const labels = { rangeStart: "調査開始月", rangeEnd: "調査完了月", pre
186
186
  - `overrides` が `undefined` ならカタログそのもの (同一参照) を返します。
187
187
  - それ以外は素のオブジェクト (プロトタイプが `Object.prototype` か `null`) だけを受け付け、**自身のプロパティだけ**を読みます。配列・クラスインスタンス・他オブジェクト継承・`null`・非オブジェクトは `RangeError` です。
188
188
  - 未知キーは `RangeError` です (`lowerAriaLabel` のような `*AriaLabel` の名前も、`labels` のキーではないため未知キーです)。値が `undefined` のキーはカタログ値のままです。
189
- - 与えた値は空白以外の文字を含む文字列でなければ `RangeError` です。エンジン 7 キーの検証は `resolveVirtualScrollLabels` 自身が行います。メッセージ中の拒否値は例外を投げない記述 (文字列は JSON、`null` は `null`、それ以外は `typeof`) で示されます。
189
+ - 与えた値は空白以外の文字を含む文字列でなければ `RangeError` です。エンジンキーの検証は `resolveVirtualScrollLabels` 自身が行います。メッセージ中の拒否値は例外を投げない記述 (文字列は JSON、`null` は `null`、それ以外は `typeof`) で示されます。
190
190
  - 結果は凍結された新しいオブジェクトです。入力は変更しません。
191
191
 
192
192
  部品は解決結果を値で安定化します。`labels={{ ... }}` をインラインで書いても、文字列が同じ間はメモ比較器が再描画を起こさず、内蔵 VirtualScroll へ渡すエンジンラベルの同一性も保たれます。
@@ -272,7 +272,7 @@ type PeriodOptionFormatter = (date: Date, unit: PeriodSliderUnit, scope: PeriodO
272
272
 
273
273
  **フォーマッタが届かない先** (いずれも別の関数が別の経路で作ります):
274
274
 
275
- - すべての `aria-label` (◀▶・セレクト・コンボボックス・ポップアップの `listbox`、ポップアップのスクロールバーの矢印ボタン 2 つ)。これらは UI クローム言語の `locale` と `labels` が決めます ([Localization](#localization-ui-クローム言語-locale-と-labels))。矢印ボタンの名前 (`scrollUp` / `scrollDown`) は内蔵の `@aiquants/virtualscroll` へ転送され、常に `disabled` のためタブ順には入らず、支援技術がポップアップ内を辿ったときに現れます。
275
+ - すべての `aria-label` (◀▶・セレクト・コンボボックス・ポップアップの `listbox`、ポップアップのスクロールバーの溝と矢印ボタン 2 つ)。これらは UI クローム言語の `locale` と `labels` が決めます ([Localization](#localization-ui-クローム言語-locale-と-labels))。溝の名前 (`verticalScrollBar`) と矢印ボタンの名前 (`scrollUp` / `scrollDown`) は内蔵の `@aiquants/virtualscroll` へ転送されます。どちらもタブ順には入らず (矢印ボタンは常に `disabled`)、支援技術がポップアップ内を辿ったときに現れます。
276
276
  - すべての機械可読値: `<option value>`、`variant="dropdown"` の `data-value`、`<input type="date">` / `<input type="month">` の `value` / `min` / `max`。
277
277
  - `onChange` が渡す引数。表示を変えても発行される `Date` は 1 ミリ秒も動きません。
278
278
 
@@ -790,7 +790,7 @@ export function FiscalQuarterLabelExample() {
790
790
  - **押すだけで動きます**: トラックを押して指を動かさずに離すと、最寄りの対象がその位置へ寄ります (ノギスのマクロ窓・ミクロ選択も同じ)。ドラッグを要しない単一ポインターの経路です (WCAG 2.2 SC 2.5.7)。
791
791
  - **使用不可の ◀▶ / ステッパーは押下をホストへ通しません**: 境界に着いたボタンは `aria-disabled="true"` でフォーカスを保ったまま、押下を捕捉フェーズで飲み込みます (`preventDefault` + `stopPropagation`)。`mousedown` / `mouseup` / `click` は React のルートコンテナより下のもの (ボタン自身と、その間にあるホストの要素) へ 1 つも届かず、押下がフォーカスを奪うこともありません。クリック可能なカード・イベント委譲・外側押下による閉じ処理・クリック計測の中へ置いても、淡く塗られた矢印からホストのハンドラが発火することはありません。ネイティブの `disabled` と同じく `pointerdown` / `pointerup` は配送されます。
792
792
 
793
- ### 配置の注意 (範囲領域と当たり判定)
793
+ ### 配置の注意 (範囲領域・当たり判定・スクロールの範囲)
794
794
 
795
795
  - **範囲領域はホストの押下を奪いません**: `Shift` + ホイールを受ける範囲領域 (ルート要素の箱に加えて、レールの上下のレーンと描かれたラベルの帯。レール方向にもラベルの外縁まで届きます) は何も描かず、ヒットテストにも一切答えません。レール方向の伸びは要素の箱ではなく持ち主判定の中だけにあるため、余裕のないスクロールコンテナへスクロールのはみ出しを足すこともありません。帯がホストの要素に重なっても、押下・ホバー・コンテキストメニューは何も変わりません。帯を空けるかどうかは、ラベルが読めるかどうかという見た目の判断です (レーンはレールの上下 22px、ノギスは 28px。ラベルの帯の厚みは描かれるラベルの寸法と傾きで変わり、日単位で接近した対では 90px を超えます)。
796
796
  - **範囲領域の持ち主は幾何で決まります**: スライダーを 2 つ近づけて範囲領域が重なっても、動くのはトラック中心線が近い方だけ (同距離なら先にマウントした方だけ) で、互いを動かすことはありません。描かれていないスライダー — `visibility: hidden` の下、`display: none` の下、畳んだアコーディオン (`max-height: 0; overflow: hidden` や `contain: paint`) の中 — はどの点も持たないため、そこに見えているホストの要素から操作を奪うこともありません。切り取りは CSS の規則どおり包含ブロックの連鎖でだけ効きます (`position: fixed` のスライダーは、`transform` などで包含ブロックを作らない祖先の `overflow` には切り取られず、浮いて描かれているとおり自分の領域を持ちます)。祖先の `clip-path` と `mask` が消した部分だけは扱いません (算出値から復元できないため、その方法で隠したスライダーは自分の点を持ち続けます)。逆に、スライダーの上へ重ねたホストの層 (ドロップダウンなど) の上でも `Shift` + ホイールはスライダーを動かします。ホストの層を優先させたい場合の手立ては 3 つあります。(a) ルート要素のインライン `--ps-label-reach-before` / `--ps-label-reach-after` / `--ps-label-reach-main` を読んで帯の厚みだけ避ける (この 3 つは `--ps-` 名前空間で唯一、**読み取り専用の出力として名前と意味を保つ**もので、ホストが読んでかまいません。上書きの口ではありません。ラベルが描かれていない側は変数自体が出ないため `var(--ps-label-reach-after, 0px)` の形で読みます)、(b) `labelPosition` で帯を反対側へ移す、(c) `tooltipStyle="hover"` でラベルを描かせず、領域をレール周りのレーン (22px / ノギス 28px) へ縮める。いずれもスライダーの機能は落ちません。
@@ -808,6 +808,7 @@ export function FiscalQuarterLabelExample() {
808
808
  | スライダー ⇄ 文字などの非操作要素 (交差軸方向) | 11px / 18px |
809
809
 
810
810
  空けないと、はみ出した当たり判定が隣の文字や部品の押下を受けます。押せるステッパーの当たり判定は `--aqps-z-handle-front` + 1 (既定 41) の層に載るため、`z-index` が 41 未満のホストの層に重なると、ステッパーの上でその層の押下を奪います。
811
+ - **文書のスクロールの範囲に数えられるのは描かれた占有だけです**: つまみとラベルが掴んだ瞬間に光らせる飾りの層 (`::before` / `::after`) は、見えない間も掴んでいる間も、祖先と文書のスクロールの範囲に数えられません (配布スタイルシートがつまみとラベルへレイアウトの封じ込め `contain: layout` を宣言し、層を描画だけのはみ出しにします)。スライダーを画面の端に寄せても、祖先へ `overflow` を指定する必要はありません。数えられるのは、ルート要素の箱 (レール方向の当たり判定の予約を含む)、ラベル、交差軸へ伸びる当たり判定と範囲領域のレーン (上の表の交差軸と同じ、ステッパー表示時 11px / 非表示時 18px) です。掴んでいる間のラベルは 1.15 倍に拡大して描かれるため、ラベルが文書の端に接していると、掴んでいる間だけラベルの大きさの 7.5% (右端では幅、下に出したラベルの下端では高さ) だけ文書が送れます (幅 65px のラベルで約 5px)。
811
812
  - **ルート要素のレイアウトはコンポーネントが持つ**: `PeriodSlider` のルート要素はグリッド (`grid` / `gap` / `place-items`)、セレクタのルート要素は内容幅の `inline-flex` です。`className` には寸法と余白 (`flex-1`、`h-60`、`w-fit` など) だけを与えてください。
812
813
  - **縦向きのスライダー**: トラックの長さはルート要素の高さから決まるため、高さを与えてください (与えないとトラックは 0px に潰れます)。幅は `w-fit` などで内容へ合わせます。
813
814
  - **セレクタだけを使う場合もスタイルシートを読み込む**: 44px の当たり判定は、配布スタイルシートがパッケージ自身の要素 (`.period-slider` と 1 単位移動ボタン) に宣言する内部変数を読みます。読み込まないと押せる範囲はボタンの箱 (22px) だけになります。
@@ -1112,7 +1113,7 @@ yearStartMonth=9 2,2,2,3,3,3,4,4,4,1,1,1
1112
1113
  | `resolveVernierSelectorSteps` | 未知の `row` / `shows` / 単位、不正な `yearStartMonth`、不正または厳密に順序づいていない境界、`macroUnit` または `microUnit` の始まりが Date の表現範囲の外にある `minDate` (`macroUnit` を先に判定。`maxDate` は厳密に後にあるため判定しない)、有効な Date 2 つで順序どおりでない `macroRange` / `microSelection` (`macroRange` は同じマクロ単位の中の時刻の逆転も)、候補が配列でない・不正な要素 (疎配列の穴を含む)・全要素が定義域の外、整っていない `rules`、単位の始まりが Date の表現範囲の外にある `macroRange` (`macroUnit`)・`microSelection` (`microUnit`)・候補 (その行の単位) | `RangeError: resolveVernierSelectorSteps: minDate must fall in a month that starts inside the Date range (received: ...)` / `... every microAllowedDates entry falls outside [minDate, maxDate] (...)` 等 |
1113
1114
  | 4 部品すべて | `formatLocale` が空文字列・構造として不正な BCP 47 タグ・非文字列 | `RangeError: <コンポーネント名>: formatLocale must be a valid BCP 47 language tag (received: ...)` |
1114
1115
  | 4 部品すべて | `locale` が `"en"` / `"ja"` 以外 (`"ja-JP"`・`"EN"`・`""`・`null` 等) | `RangeError: [period-slider] locale is the UI language, not a BCP 47 tag (date formatting reads formatLocale): [virtualscroll] locale must be one of "en", "ja"; got ...` (`cause` はエンジンの `RangeError`) |
1115
- | 4 部品すべて | `labels` が `null`・非オブジェクト・素のオブジェクトでない・未知キー (`*AriaLabel` の名前を含む)・空白や非文字列の値 | `RangeError: [period-slider] labels ...` (エンジン 7 キーの値は `RangeError: [virtualscroll] labels.<キー> must be a non-blank string; ...`) |
1116
+ | 4 部品すべて | `labels` が `null`・非オブジェクト・素のオブジェクトでない・未知キー (`*AriaLabel` の名前を含む)・空白や非文字列の値 | `RangeError: [period-slider] labels ...` (エンジンキーの値は `RangeError: [virtualscroll] labels.<キー> must be a non-blank string; ...`) |
1116
1117
  | `YearSelector` / `MonthSelector` / `DateSelector` | `value` と `initialDate` が共に未指定 | `RangeError: <コンポーネント名>: either value (controlled) or initialDate (uncontrolled) is required; ...` |
1117
1118
  | `YearSelector` / `MonthSelector` / `DateSelector` | `stepper` がオブジェクトでない、`onStep` が関数でない、`canStepPrevious` / `canStepNext` が真偽値でない、または `value` を渡さずに `stepper` を渡した | `RangeError: MonthSelector: stepper.onStep must be a function (received: "next")` / `RangeError: DateSelector: stepper.canStepNext must be a boolean (received: undefined)` / `... stepper requires the controlled value; ...` |
1118
1119
  | `YearSelector` | 境界の欠落・矛盾、Date / 年 Props の不正値、`allowedYears` の要素が Invalid Date または `Date` でない (`undefined`・疎配列の穴を含む。添字付きで報告) | `RangeError` |
@@ -1424,7 +1425,7 @@ const allowedMonths = useMemo(() => baseMonths.map((yyyymm) => new Date(Math.tru
1424
1425
  | `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
1425
1426
  | `children` | `React.ReactNode` | `undefined` | ルート要素末尾へ追加描画する子要素 |
1426
1427
  | `locale` | `PeriodSliderLocale` | `undefined` (= `"en"`) | UI クローム言語。アクセシブル名 (`previousDay` / `nextDay` / `dateSelect`、`variant="split-dropdown"` では `splitYear` / `splitMonth` / `splitDay`) と、`variant="dropdown"` のポップアップに埋め込まれた `@aiquants/virtualscroll` のスクロールクロームの言語を選ぶ |
1427
- | `labels` | `PeriodSliderLabelOverrides` | `undefined` | カタログへのキー単位の上書き。読むのは `previousDay` / `nextDay` / `dateSelect` / `splitYear` / `splitMonth` / `splitDay` と、`variant="dropdown"` ではエンジン 7 キー (内蔵 VirtualScroll へ転送) |
1428
+ | `labels` | `PeriodSliderLabelOverrides` | `undefined` | カタログへのキー単位の上書き。読むのは `previousDay` / `nextDay` / `dateSelect` / `splitYear` / `splitMonth` / `splitDay` と、`variant="dropdown"` ではエンジンキー全件 (`VIRTUAL_SCROLL_LABEL_KEYS`。内蔵 VirtualScroll へ転送) |
1428
1429
  | `formatLocale` | `string` | `undefined` | 選択肢テキストのロケール (BCP 47 言語タグ)。未指定は ISO 8601 (`variant="dropdown"` は `YYYY-MM-DD`、`variant="split-dropdown"` は `2024` / `01` / `15`)、指定時は `Intl.DateTimeFormat` 書式。`<input type="date">` の値・コンボボックスの `data-value`・`<option value>` は常に `yyyy-MM-dd` または生の数値。空文字列・不正タグ・非文字列は `RangeError` |
1429
1430
  | `formatOption` | `PeriodOptionFormatter` | `undefined` | 選択肢・プレースホルダ・畳んだ表示のテキスト生成関数 (`formatLocale` より優先)。`(date, unit, scope) => string` で、`unit` と `scope` はコンポーネントが与える。ネイティブ入力を使う `variant="date"` では履行できないため**呼び出しも行わない**。返り値は機械可読値・`aria-label`・`onChange` の引数には届かない。参照比較で再描画を判定するため、利用側でメモ化する |
1430
1431
  | `unit` | — | — | **このコンポーネントが宣言していない名前です**。フックの `SelectorProps` をそのままスプレッドできるよう、受け取っても読まれず捨てられます (コンポーネントは必要な Props だけを名前で取り出すため、DOM へも届きません)。型にも宣言が無いので、JSX へ直接書くとコンパイルエラーになります (スプレッドは余剰プロパティ検査を受けないため通ります) |
@@ -1449,7 +1450,7 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
1449
1450
  - 操作要素は `<input type="text" readonly role="combobox">` で、`value` には人間が読むテキスト (`formatOption` 指定時はその返り値、未指定なら `formatLocale` 書式)、`data-value` には常に `yyyy-MM-dd` の機械可読値を持ちます。この `value` は選択中の行のテキストと必ず一致します (同じ関数値へ同じ形の引数を渡すため)。`aria-expanded` / `aria-haspopup="listbox"` / `aria-controls` (ポップアップが描かれている間) / `aria-activedescendant` (アクティブ行が DOM に在る間。スクロールで窓の外へ出ると外れ、戻ると同じ確定で付き、Activity などで隠れている間は持たない) を持ち、`data-testid="period-slider-date-combobox"` で引けます。集合外の保持値は行にならず、操作要素の表示テキストとしてだけ現れます。
1450
1451
  - 開く位置は保持値の行、保持値が集合の外にあるときは**その値に最も近い行** (同距離では早い側の日付) です。先頭行から開かないため、100 年の定義域でも戻る操作が数行で済みます。開いた行は `data-active="true"` と `aria-activedescendant` が指しますが、集合外の保持値では `aria-selected="true"` の行は 1 つもありません (アクティブ行は「これから選ぶ候補」であり、選択済みではないため)。操作要素の表示テキストと `data-out-of-range="true"` はどちらも動きません。
1451
1452
  - ポップアップは `document.body` へポータルされ (`data-testid="period-slider-date-popup"`)、開いた時点の操作要素の位置から解決した配色モードを `data-color-mode="light|dark"` として持ち、操作要素の下に開き、余地が無ければ上へ反転して視野内へ収まります。中の `role="listbox"` (アクセシブル名は `labels.dateSelect`、操作要素と同じ名前) が `role="option"` の行を持ち、各行は `aria-selected` / `aria-posinset` / `aria-setsize` (集合全体の件数) / `data-active` (キーボードの現在位置) を持ち、`data-testid="period-slider-date-option"` で引けます。DOM に存在する行は可視窓の分だけで、集合全体の件数は `aria-setsize` から読みます。所有側 (`Activity`・`Suspense`) が隠れている間、ポップアップは画面に出ません (隠す確定でインラインの `display: none !important` を持ち、閉じて外れます)。隠れている間に操作要素へ届いた打鍵と押下は何もしません (一覧を開かず、`onChange` も呼びません)。
1452
- - ポップアップには `role="listbox"` のほかに `@aiquants/virtualscroll` のスクロールバーが同居します (`role="scrollbar"`、つまみの `role="slider"`、そして `aria-label` を持つ矢印ボタン 2 つ)。矢印ボタンは常に `disabled` でタブ順にもキーボード操作にも現れませんが、アクセシビリティツリーには残ります。その名前は `locale` のカタログの `scrollUp` / `scrollDown` (`Scroll up` / `Scroll down`、`ja` では `上へスクロール` / `下へスクロール`) で、`labels` の同じキーで上書きできます (本パッケージが内蔵 VirtualScroll へ `locale` とエンジン 7 キーを転送します)。ポップアップに絞った `getByRole("button")` はこの 2 つに当たるため、行は `role="option"` か `data-testid` で引いてください。
1453
+ - ポップアップには `role="listbox"` のほかに `@aiquants/virtualscroll` のスクロールバーが同居します (値と名前を持つ `role="scrollbar"` の溝 1 つと、その外に並ぶ `aria-label` を持つ矢印ボタン 2 つ。つまみは見た目だけで、役割を持ちません)。矢印ボタンは常に `disabled` でタブ順にもキーボード操作にも現れませんが、アクセシビリティツリーには残ります。その名前は `locale` のカタログの `scrollUp` / `scrollDown` (`Scroll up` / `Scroll down`、`ja` では `上へスクロール` / `下へスクロール`) で、溝の名前は `verticalScrollBar` (`Vertical`、`ja` では `縦方向`) です。どれも `labels` の同じキーで上書きできます (本パッケージが内蔵 VirtualScroll へ `locale` とエンジンキー全件を転送します)。ポップアップに絞った `getByRole("button")` はこの 2 つに当たるため、行は `role="option"` か `data-testid` で引いてください。
1453
1454
  - キーボード: `ArrowDown` / `ArrowUp` (閉じていれば開く、開いていれば 1 行移動)、`Home` / `End` (先頭 = 最新日 / 末尾 = 最古日)、`PageDown` / `PageUp` (1 窓 = 7 行)、`Enter` (閉じていれば開く、開いていればアクティブ行を確定)、`Escape` (閉じる・発火しない)、`Tab` (閉じる)、数字と `-` / `/` / `.` (先頭一致入力。**表示書式に関わらず**先発グレゴリオ暦の `yyyy` / `yyyyMM` / `yyyyMMdd` として解釈し、走査せずに当該日へ飛ぶ。`formatOption` が非数字のテキストを返していても変わらない)。行の押下でも DOM フォーカスは操作要素から離れません。
1454
1455
  - 閉じる契機: 行の確定、`Escape`、`Tab`、操作要素からのフォーカス喪失、ポップアップ外の `pointerdown`、所有側が `<Activity mode="hidden">` で隠れたとき・`Suspense` がフォールバックを出したとき (表示し直しても閉じたまま)。
1455
1456
  - `startTransition` で渡した境界・`allowedDates`・`formatLocale`・`formatOption` は、その描画が確定するまでポップアップに使われません。一覧の行 (スクロールで描き足す行も)・先頭一致入力・行の押下は、画面に描かれている一覧を読みます。開いたまま件数が縮み、アクティブ行が一覧の外に出るときは、件数を縮めた描画のうちに末尾の行へ移り、件数が戻っても移った行に留まります。開いている間に配置だけが変わる描画 (ページのスクロール・リサイズへの追従) は、描かれている行を描き直しません (`formatOption` を呼ぶのは新しく描く行だけです)。
@@ -1694,10 +1695,10 @@ const { sliderProps, startSelectorProps } = usePeriodSliderRange({ unit: "day",
1694
1695
 
1695
1696
  - `startTransition` で渡した新しいオプションは、その描画が確定するまで使われません。確定していない描画が渡したコールバックは呼ばれません。関数の同一性は変わりません。
1696
1697
  - 子孫のレイアウト副作用から呼んでも、隠れた `Activity` の中でも、その確定の値を読みます。
1697
- - 確定経路は、返す関数が最後にステートへ渡した値と同じ値を、それがステートの最後の更新だと分かっている間は渡さず、それ以外は同じ値でもステートへ渡します。そのため `startTransition` の中で呼んだ設定関数が中断している間に別の操作をしても、保存される値は最後に通知した値 (または `setRange` などで書いた値) と一致します。その間に境界・候補・窓が動いて確定済みの値を収め直しても、収め直しの記録は中断している値を上書きしません。中断している値と同じ値を緊急に呼び直しても、その間にホストが描き直されていなければその値を緊急の優先度へ引き上げず (代替表示を出さず)、更新の後に同じ値で呼び直してもホストは描き直されません。確定経路がステートと同じオブジェクトを渡すときと、設定関数へステートが持つオブジェクトそのものを渡したとき (呼び出しごと) は、子を描き直さないホストの描画が 1 度走ります。
1698
- - ホストの描画の中で返す関数を呼ぶときは、`duringRender(action)` の `action` の中で呼びます。`action` の中で同期に呼んだこのフックの返す関数は、その描画の中だけで働きます。読む値は最後に確定した描画の値 (その後に事象の時点で書いた値と、同じ描画で先に呼んだ返す関数が渡した値があればその値) で、境界も前の確定のもので収めます (同じ描画で広げた `maxDate` ではなく、前の確定の `maxDate`)。ステートへの受け渡しは React の描画中の更新になり、写し・受け渡しの記録・利用側が知っている値への書き込みと通知は、その描画が確定したときに行います。React が捨てた描画 (Suspense が保留した移行、取り消した移行) は何も残しません。フックがその描画の分を続けるのは、`duringRender` を呼んだ描画の続き (描画中の更新の後の走らせ直し、`StrictMode` の 2 度目の呼び出し、中断した描画のデータが解決した後の再実行) だけで、React が捨てた描画の分は、同じ値を持つ後の別の描画が確定しても当たらず (通知も届かず)、後の描画の `action` の書き込みと通知を消しもしません。これを見分けるため、描画の中で最初に呼んだ `duringRender` はその描画に印を描画中の更新として付け、`action` が何も渡さなくても、ホストの本体は同じ描画の中でもう 1 度走ります (子の描画と確定は増えません)。その描画に入らない事象の書き込み (描画がフックを呼んだ後の書き込みと、描画が持たない保留中の受け渡し: 移行が譲っている間にホストの描画より前に渡した値や、その描画が飛ばす優先度の移行の中で渡した値) があるステートには描画の分を当てず、事象の書き込みが後から当たります (ノギスのフックではスケールごと)。`action` の中の受け渡しがまだ確定し得る間は、表示中の値へ落ち着く事象の時点の呼び出しも同じ値をステートへ渡し直し、後の操作として勝ちます (渡し直しは子の描画を省くホストの描画を 1 度走らせます。React が捨てた描画の `action` が値を渡した後も、ホストが次に描かれるまでは、最初のそうした呼び出しで同じく 1 度走ることがあります)。`action` の中でステートを変える値を渡した描画の確定の後は、その受け渡しをステートの更新の列へ記録するため、子の描画を省くホストの描画が 1 度走ります (その描画が飛ばした優先度の低い受け渡しを React が後で当て直しても、保存される値が通知した値に行き着くようにするため)。フック自身の値と比べて描画のたびに呼ぶ追従は、確定経路 (シフト・リセット、`setLowerDate` / `setMicroDate` などの端ごとの設定関数、セレクタと `sliderProps` のコールバック、◀▶) で呼べば、値が境界・候補・窓へ置き直される場合も置き直した値で落ち着きます (走らせ直した描画の同じ値の確定経路は何も渡しません)。直接の設定関数 (`setValue` / `setRange` / `setMacroRange` / `setMicroRange` / `setMicroValue`) は呼ぶたびに値を渡すため、フックが置き直す値へ描画のたびに比べて追従すると落ち着かず、React の「Too many re-renders」に至ります。設定関数で追従するときは、下の例のように保持した目標と比べます (`if (target !== held)`)。同じ描画の値で収めるには、副作用 (`useEffect` / `useLayoutEffect`) かイベントハンドラの中で呼んでください。設定関数 (`setValue` など) へ渡した値は、同じオブジェクトでもその確定が描きます。
1699
- - `duringRender` は、フックを呼んだホスト自身の描画の中で、フックを呼んだ後に呼びます。フックの描画の範囲が閉じた後、つまりフックの最後の描画が確定した後 (確定した描画から控えた戻り値をフックの呼び出しより前に使う場合を含む) と、本体を走らせた同期の処理が終わった後 (副作用・イベントハンドラ・フックを呼んだ後に積んだマイクロタスク) に呼ぶと、フック名を名乗る `Error` (`usePeriodSliderPoint: duringRender(action) must be called during the host's render, after the hook call (...)`) です。`action` が関数でなければ `TypeError` (`usePeriodSliderPoint: duringRender(action) must be a function (received: ...)`) です。`action` の中でほかのフックのインスタンスの返す関数を呼ぶと、そのインスタンスが何もせずに自分の名前を名乗る `Error` (`... a returned function was called during another hook's duringRender(action); ...`) を送出します (そのインスタンスの `duringRender` を入れ子に呼び、その中で呼びます)。`action` が送出した例外はそのまま伝わり、`duringRender` の同一性はコンポーネントの存続中ずっと変わりません。ほかのコンポーネントの描画の中、フックを呼ぶ前、確定しなかった描画と同じ同期の処理の中の事象のコード、描画のコードがフックを呼ぶ前に積んだマイクロタスク (先に描いたコンポーネントが積んだものを含む) で `duringRender` を呼ぶのも対応外です (送出されないことがあります)。
1700
- - `duringRender` の外の呼び出しは、どこで呼んでも (事象の処理・副作用・マイクロタスク・確定の途中 (子孫のレイアウト副作用の後始末など)・描画中) 事象の時点の呼び出しで、その場で書き、待っている通知を届けてから通知します。描画中に `duringRender` の外で呼ぶのは対応外です (React が捨てた描画の中でも書き込みと通知が残ります)。`action` の中の呼び出しの通知は、その描画のコールバックへホストのレイアウト副作用で届き (その確定で先に走る子孫のレイアウト副作用がフックへ書くか通知するときはその前、隠れた `Activity` の中の確定ではマイクロタスク)、入れ子のホストでは子から親、1 つのホストの複数のフックではフックを呼んだ順に届きます。通知に応えてホスト自身のステートを書くコールバックは確定の後に走るため、その更新は同期の描画と確定をもう 1 回走らせます。サーバー描画では確定が無いため、`action` の中の呼び出しはコールバックを呼びません。
1698
+ - 確定経路は、返す関数が最後にステートへ渡した値と同じ値を、それがステートの最後の更新だと分かっている間は渡さず、それ以外は同じ値でもステートへ渡します。そのため `startTransition` の中で呼んだ設定関数が中断している間に別の操作をしても、保存される値は最後に通知した値 (または `setRange` などで書いた値) と一致します。その間に境界・候補・窓が動いて確定済みの値を収め直しても、収め直しの記録は中断している値を上書きしません。中断している値と同じ値を緊急に呼び直しても、その間にホストが描き直されていなければその値を緊急の優先度へ引き上げず (代替表示を出さず)、更新の後に同じ値で呼び直してもホストは描き直されません。確定経路がステートと同じオブジェクトを渡すときと、設定関数へステートが持つオブジェクトそのものを渡したとき (呼び出しごと) は、ホストの描画が 1 度走ります (その描画の `duringRender` の `action` が何かを記録しない限り、子を描き直しません。下の `duringRender` の印)。
1699
+ - ホストの描画の中で返す関数を呼ぶときは、`duringRender(action)` の `action` の中で呼びます。`action` の中で同期に呼んだこのフックの返す関数は、その描画の中だけで働きます。読む値は最後に確定した描画の値 (その後に事象の時点で書いた値と、同じ描画で先に呼んだ返す関数が渡した値があればその値) で、境界も前の確定のもので収めます (同じ描画で広げた `maxDate` ではなく、前の確定の `maxDate`)。ステートへの受け渡しは React の描画中の更新になり、写し・受け渡しの記録・利用側が知っている値への書き込みと通知は、その描画が確定したときに行います。React が捨てた描画 (Suspense が保留した移行、取り消した移行) は何も残しません。フックがその描画の分を続けるのは、`duringRender` を呼んだ描画の続き (描画中の更新の後の走らせ直し、`StrictMode` の 2 度目の呼び出し、中断した描画のデータが解決した後の再実行) だけで、React が捨てた描画の分は、同じ値を持つ後の別の描画が確定しても当たらず (通知も届かず)、後の描画の `action` の書き込みと通知を消しもしません。これを見分けるため、`action` の中の返す関数がその描画で最初に何か (写しや利用側が知っている値への書き込み・受け渡し・通知) を記録したとき、フックはその描画に印を描画中の更新として付けます。印はその描画のフックのステートを変えるため、印を付けた描画では React が子の描画を省かず、ホストの本体は同じ描画の中でもう 1 度走ります (`action` が値を渡すときは、その受け渡しを当てる走らせ直しと同じ 1 度です。確定は増えません)。`action` が何も記録しない描画には印を付けないため、本体の実行は増えず、ほかに変化が無ければ React は子の描画を省きます (ステートと同じオブジェクトの受け渡しや下の記録が走らせる描画で、描画のたびに呼ぶ追従が既に落ち着いている場合など)。その描画に入らない事象の書き込み (描画がフックを呼んだ後の書き込みと、描画が持たない保留中の受け渡し: 移行が譲っている間にホストの描画より前に渡した値や、その描画が飛ばす優先度の移行の中で渡した値) があるステートには描画の分を当てず、事象の書き込みが後から当たります (ノギスのフックではスケールごと)。`action` の中の受け渡しがまだ確定し得る間は、表示中の値へ落ち着く事象の時点の呼び出しも同じ値をステートへ渡し直し、後の操作として勝ちます (渡し直しはホストの描画を 1 度走らせ、その描画の `action` が何かを記録しない限り子の描画を省きます。React が捨てた描画の `action` が値を渡した後も、ホストが次に描かれるまでは、最初のそうした呼び出しで同じく 1 度走ることがあります)。`action` の中でステートを変える値を渡した描画の確定の後は、その受け渡しをステートの更新の列へ記録するため、ホストの描画が 1 度走ります (その描画が飛ばした優先度の低い受け渡しを React が後で当て直しても、保存される値が通知した値に行き着くようにするため。その描画の `action` が何かを記録しない限り子の描画を省きます。受け渡した値で落ち着いた追従は、その描画で何も記録しません)。フック自身の値と比べて描画のたびに呼ぶ追従は、確定経路 (シフト・リセット、`setLowerDate` / `setMicroDate` などの端ごとの設定関数、セレクタと `sliderProps` のコールバック、◀▶) で呼べば、値が境界・候補・窓へ置き直される場合も置き直した値で落ち着きます (走らせ直した描画の同じ値の確定経路は何も渡しません)。直接の設定関数 (`setValue` / `setRange` / `setMacroRange` / `setMicroRange` / `setMicroValue`) は呼ぶたびに値を渡すため、フックが置き直す値へ描画のたびに比べて追従すると落ち着かず、React の「Too many re-renders」に至ります。設定関数で追従するときは、下の例のように保持した目標と比べます (`if (target !== held)`)。同じ描画の値で収めるには、副作用 (`useEffect` / `useLayoutEffect`) かイベントハンドラの中で呼んでください。設定関数 (`setValue` など) へ渡した値は、同じオブジェクトでもその確定が描きます。
1700
+ - `duringRender` は、フックを呼んだホスト自身の描画の中で、フックを呼んだ後に呼びます。フックの描画の範囲が閉じた後、つまりフックの最後の描画が確定した後 (確定した描画から控えた戻り値をフックの呼び出しより前に使う場合を含む) と、本体を走らせた同期の処理が終わった後 (副作用・イベントハンドラ・フックを呼んだ後に積んだマイクロタスク) に呼ぶと、フック名を名乗る `Error` (`usePeriodSliderPoint: duringRender(action) must be called during the host's render, after the hook call (...)`) です。`action` が関数でなければ `TypeError` (`usePeriodSliderPoint: duringRender(action) must be a function (received: ...)`) です。`action` の中でほかのフックのインスタンスの返す関数を呼ぶと、そのインスタンスが何もせずに自分の名前を名乗る `Error` (`... a returned function was called during another hook's duringRender(action); ...`) を送出します (そのインスタンスの `duringRender` を入れ子に呼び、その中で呼びます)。`action` が送出した例外はそのまま伝わり、`duringRender` の同一性はコンポーネントの存続中ずっと変わりません。ほかのコンポーネントの描画の中、フックを呼ぶ前、確定しなかった描画 (`action` が何も記録せず、React がホストを省いた描画を含む) と同じ同期の処理の中の事象のコード (`flushSync` や同期の `act` の直後など)、描画のコードがフックを呼ぶ前に積んだマイクロタスク (先に描いたコンポーネントが積んだものを含む) で `duringRender` を呼ぶのも対応外です (送出されないことがあります)。
1701
+ - `duringRender` の外の呼び出しは、どこで呼んでも (事象の処理・副作用・マイクロタスク・確定の途中 (子孫のレイアウト副作用の後始末など)・描画中) 事象の時点の呼び出しで、その場で書き、待っている通知を届けてから通知します。ただし、ほかのフックのインスタンスの `action` の中の呼び出しは事象の時点の呼び出しではなく、何もせずに `Error` を送出します (上の項目)。描画中に `duringRender` の外で呼ぶのは対応外です (React が捨てた描画の中でも書き込みと通知が残ります。受け渡しの記録も React が捨てた受け渡しを指したまま残るため、以後そのステートへの `duringRender` の中の受け渡しは、描かれても通知されず、利用側が知っている値にもなりません。事象の時点の呼び出しがそのステートへ値を渡すか、記録が指すオブジェクトそのものをステートが持つ描画が確定するまで続きます)。`action` の中の呼び出しの通知は、その描画のコールバックへホストのレイアウト副作用で届き (その確定で先に走る子孫のレイアウト副作用がフックへ書くか通知するときはその前、隠れた `Activity` の中の確定ではマイクロタスク)、入れ子のホストでは子から親、1 つのホストの複数のフックではフックを呼んだ順に届きます。通知に応えてホスト自身のステートを書くコールバックは確定の後に走るため、その更新は同期の描画と確定をもう 1 回走らせます。サーバー描画では確定が無いため、`action` の中の呼び出しはコールバックを呼びません。
1701
1702
 
1702
1703
  ```tsx
1703
1704
  const point = usePeriodSliderPoint({ unit: "day", minDate, maxDate, initialValue })
@@ -1760,7 +1761,7 @@ if (target !== held) {
1760
1761
 
1761
1762
  #### `useVernierSliderRange(options)`
1762
1763
 
1763
- **ノギスの操作は、動かすスケールだけをステートへ渡します** (`useVernierSliderRange` / `useVernierSliderPoint` に共通)。片方のスケールだけを動かす確定経路 (マクロ窓は `setMacroLowerDate` / `setMacroUpperDate`・`shiftMacroRange`・マクロのセレクタの `onChange` と ◀▶・`sliderProps.onChangeMacroRange`、ミクロ選択は `setMicroLowerDate` / `setMicroUpperDate` / `setMicroDate`・`shiftMicroRange` / `shiftMicroValue`・ミクロのセレクタの `onChange` と ◀▶・`sliderProps` のミクロのコールバック) は、もう片方のスケールの落ち着いた値が返す関数の読む値とも利用側が知っている値とも等しい間、そのスケールを渡さず通知もしません。そのため、`duringRender` で一方のスケールへ追従する移行の描画が譲っている間にもう一方だけを動かしても、追従した値はその確定で描かれて通知されます。利用側が別の値を知っているとき (収め直した値、緊急の確定が元の窓を描いた間も保留している窓の移行) は、操作が描いている値を渡し直して通知し、保存する値を最後に通知した値と揃えます。操作の結果もう片方のスケールも動くとき (窓の移動で置き直したミクロ選択、窓を追従させるミクロの ◀▶) と `resetVernier` は、両方のスケールを確定します。動かすスケールは、返す関数の読む値 (確定したもう片方のスケール) に照らして置きます。追従した値と動かした値の両方を持つ描画でミクロ選択が窓に収まらないときは、その描画が収め直しと同じくミクロ選択を置き直し (その場では通知しません)、その値は次にそれへ落ち着いた操作で通知されます。直接の更新関数 (`setMacroRange` / `setMicroRange` / `setMicroValue`) は自分のスケールだけを渡します。もう片方の操作はそのスケールを渡さないため、マウントの後にまだ何も渡していないスケールへ同じ値の確定経路を初めて呼ぶと、子の描画を省くホストの描画が 1 度走ります (上の「共通: `SelectorProps`」の同じ値の受け渡しと同じ)。
1764
+ **ノギスの操作は、動かすスケールだけをステートへ渡します** (`useVernierSliderRange` / `useVernierSliderPoint` に共通)。片方のスケールだけを動かす確定経路 (マクロ窓は `setMacroLowerDate` / `setMacroUpperDate`・`shiftMacroRange`・マクロのセレクタの `onChange` と ◀▶・`sliderProps.onChangeMacroRange`、ミクロ選択は `setMicroLowerDate` / `setMicroUpperDate` / `setMicroDate`・`shiftMicroRange` / `shiftMicroValue`・ミクロのセレクタの `onChange` と ◀▶・`sliderProps` のミクロのコールバック) は、もう片方のスケールの落ち着いた値が返す関数の読む値とも利用側が知っている値とも等しい間、そのスケールを渡さず通知もしません。そのため、`duringRender` で一方のスケールへ追従する移行の描画が譲っている間にもう一方だけを動かしても、追従した値はその確定で描かれて通知されます。利用側が別の値を知っているとき (収め直した値、緊急の確定が元の窓を描いた間も保留している窓の移行) は、操作が描いている値を渡し直して通知し、保存する値を最後に通知した値と揃えます。操作の結果もう片方のスケールも動くとき (窓の移動で置き直したミクロ選択、窓を追従させるミクロの ◀▶) と `resetVernier` は、両方のスケールを確定します。動かすスケールは、返す関数の読む値 (確定したもう片方のスケール) に照らして置きます。追従した値と動かした値の両方を持つ描画でミクロ選択が窓に収まらないときは、その描画が収め直しと同じくミクロ選択を置き直し (その場では通知しません)、その値は次にそれへ落ち着いた操作で通知されます。直接の更新関数 (`setMacroRange` / `setMicroRange` / `setMicroValue`) は自分のスケールだけを渡します。もう片方の操作はそのスケールを渡さないため、マウントの後にまだ何も渡していないスケールへ同じ値の確定経路を初めて呼ぶと、ホストの描画が 1 度走ります (上の「共通: `SelectorProps`」の同じ値の受け渡しと同じく、その描画の `duringRender` の `action` が何かを記録しない限り子を描き直しません)。
1764
1765
 
1765
1766
  | オプション | 型 | 既定値 | 説明 |
1766
1767
  | :--- | :--- | :--- | :--- |
@@ -55,7 +55,7 @@ export interface DateSelectorProps {
55
55
  disabled?: boolean;
56
56
  /** UI chrome language of the accessible names and of the dropdown's scroll chrome ("en" | "ja", default "en"); anything else throws RangeError / アクセシブル名とドロップダウンのスクロールクロームの UI クローム言語 ("en" | "ja"、既定 "en"。それ以外は RangeError) */
57
57
  locale?: PeriodSliderLocale;
58
- /** Per-key overrides over the `locale` catalog; this component reads `previousDay`, `nextDay`, `dateSelect`, `splitYear`, `splitMonth`, `splitDay` and, in variant="dropdown", the 7 engine keys / `locale` カタログへのキー単位の上書き (本コンポーネントが読むのは `previousDay`・`nextDay`・`dateSelect`・`splitYear`・`splitMonth`・`splitDay`、variant="dropdown" ではエンジン 7 キーも) */
58
+ /** Per-key overrides over the `locale` catalog; this component reads `previousDay`, `nextDay`, `dateSelect`, `splitYear`, `splitMonth`, `splitDay` and, in variant="dropdown", the engine keys (`VIRTUAL_SCROLL_LABEL_KEYS`) / `locale` カタログへのキー単位の上書き (本コンポーネントが読むのは `previousDay`・`nextDay`・`dateSelect`・`splitYear`・`splitMonth`・`splitDay`、variant="dropdown" ではエンジンキー全件も) */
59
59
  labels?: PeriodSliderLabelOverrides;
60
60
  /** BCP 47 language tag switching option text to Intl formatting; omitted keeps locale-independent ISO 8601, and the input value stays yyyy-MM-dd either way / 選択肢テキストを Intl 書式にする BCP 47 言語タグ (未指定時はロケール非依存の ISO 8601 表記・input の value は常に yyyy-MM-dd) */
61
61
  formatLocale?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"DateSelector.d.ts","sourceRoot":"","sources":["../src/DateSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAA0B,KAAK,0BAA0B,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAE3G,OAAO,EAA2E,KAAK,qBAAqB,EAA8C,MAAM,gBAAgB,CAAA;AAGhL,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAM5E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAC9B,qJAAqJ;IACrJ,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,4UAA4U;IAC5U,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,sKAAsK;IACtK,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;IACrC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gHAAgH;IAChH,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,gHAAgH;IAChH,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,gbAAgb;IAChb,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;IACjC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,gBAAgB,CAAA;IAChD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gOAAgO;IAChO,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,uVAAuV;IACvV,MAAM,CAAC,EAAE,0BAA0B,CAAA;IACnC,0PAA0P;IAC1P,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mUAAmU;IACnU,YAAY,CAAC,EAAE,qBAAqB,CAAA;CACvC;AAonBD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM,iBAAiB,EAAE,MAAM,iBAAiB,KAAG,OA2B5F,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,oCA/Za,iBAAiB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+ZO,CAAA"}
1
+ {"version":3,"file":"DateSelector.d.ts","sourceRoot":"","sources":["../src/DateSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAA0B,KAAK,0BAA0B,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAE3G,OAAO,EAA2E,KAAK,qBAAqB,EAA8C,MAAM,gBAAgB,CAAA;AAGhL,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAM5E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAC9B,qJAAqJ;IACrJ,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,4UAA4U;IAC5U,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,sKAAsK;IACtK,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;IACrC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gHAAgH;IAChH,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,gHAAgH;IAChH,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,gbAAgb;IAChb,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;IACjC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,gBAAgB,CAAA;IAChD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gOAAgO;IAChO,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,kXAAkX;IAClX,MAAM,CAAC,EAAE,0BAA0B,CAAA;IACnC,0PAA0P;IAC1P,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mUAAmU;IACnU,YAAY,CAAC,EAAE,qBAAqB,CAAA;CACvC;AAonBD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM,iBAAiB,EAAE,MAAM,iBAAiB,KAAG,OA2B5F,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,oCA/Za,iBAAiB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+ZO,CAAA"}
@@ -59,8 +59,8 @@ export interface VirtualDateDropdownProps {
59
59
  /** UI chrome locale forwarded to the embedded VirtualScroll, or undefined for its default "en" / 内蔵 VirtualScroll へ転送する UI クロームロケール (undefined は既定の "en") */
60
60
  locale: PeriodSliderLocale | undefined;
61
61
  /**
62
- * Resolved, value-stable label bag of the owning selector; its 7 engine keys are forwarded to the embedded VirtualScroll.
63
- * 所有セレクタの解決済み・値安定なラベル集合 (エンジン 7 キーを内蔵 VirtualScroll へ転送)。
62
+ * Resolved, value-stable label bag of the owning selector; its engine keys (`VIRTUAL_SCROLL_LABEL_KEYS`) are forwarded to the embedded VirtualScroll.
63
+ * 所有セレクタの解決済み・値安定なラベル集合 (エンジンキー全件を内蔵 VirtualScroll へ転送)。
64
64
  */
65
65
  labels: PeriodSliderLabels;
66
66
  /** Commits the date of an index the user picked / 利用者が選んだ添字の日付を確定する関数 */
@@ -1 +1 @@
1
- {"version":3,"file":"VirtualDateDropdown.d.ts","sourceRoot":"","sources":["../src/VirtualDateDropdown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAoB,MAAM,UAAU,CAAA;AAG7F,4GAA4G;AAC5G,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAQxC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AA4BnC;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;OAGG;IACH,MAAM,EAAE,gBAAgB,CAAA;IACxB,mKAAmK;IACnK,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB,0HAA0H;IAC1H,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAA;IACjB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,6JAA6J;IAC7J,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACtC;;;OAGG;IACH,MAAM,EAAE,kBAAkB,CAAA;IAC1B,yEAAyE;IACzE,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;CAC3B;AAiBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,QAAQ,gBAAgB,KAAG,MAwBhF,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,cAKnD,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,yGAAyG;IACzG,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,eAAe,MAAM,EAAE,gBAAgB,MAAM,EAAE,eAAe,MAAM,KAAG,aAUjL,CAAA;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAmZlE,CAAA"}
1
+ {"version":3,"file":"VirtualDateDropdown.d.ts","sourceRoot":"","sources":["../src/VirtualDateDropdown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAoB,MAAM,UAAU,CAAA;AAG7F,4GAA4G;AAC5G,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAQxC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AA4BnC;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;OAGG;IACH,MAAM,EAAE,gBAAgB,CAAA;IACxB,mKAAmK;IACnK,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB,0HAA0H;IAC1H,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAA;IACjB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,6JAA6J;IAC7J,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACtC;;;OAGG;IACH,MAAM,EAAE,kBAAkB,CAAA;IAC1B,yEAAyE;IACzE,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;CAC3B;AAiBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,QAAQ,gBAAgB,KAAG,MAwBhF,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,cAKnD,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,yGAAyG;IACzG,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,eAAe,MAAM,EAAE,gBAAgB,MAAM,EAAE,eAAe,MAAM,KAAG,aAUjL,CAAA;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAialE,CAAA"}