@aiquants/period-slider 0.15.0 → 0.16.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 +358 -4
- package/README.md +267 -106
- package/dist/DateSelector.d.ts +40 -5
- package/dist/DateSelector.d.ts.map +1 -1
- package/dist/MonthSelector.d.ts +31 -4
- package/dist/MonthSelector.d.ts.map +1 -1
- package/dist/PeriodSlider.d.ts +67 -8
- package/dist/PeriodSlider.d.ts.map +1 -1
- package/dist/YearSelector.d.ts +31 -4
- package/dist/YearSelector.d.ts.map +1 -1
- package/dist/dateOptionDomain.d.ts +20 -13
- package/dist/dateOptionDomain.d.ts.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +4 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2693 -2108
- package/dist/inputValue.d.ts +85 -0
- package/dist/inputValue.d.ts.map +1 -0
- package/dist/optionText.d.ts.map +1 -1
- package/dist/selectorMemo.d.ts +37 -0
- package/dist/selectorMemo.d.ts.map +1 -0
- package/dist/selectorStep.d.ts +300 -0
- package/dist/selectorStep.d.ts.map +1 -0
- package/dist/usePeriodSlider.d.ts +119 -36
- package/dist/usePeriodSlider.d.ts.map +1 -1
- package/dist/valueSet.d.ts +126 -13
- package/dist/valueSet.d.ts.map +1 -1
- package/dist/vernierStep.d.ts +180 -0
- package/dist/vernierStep.d.ts.map +1 -0
- package/package.json +1 -1
- package/src/DateSelector.tsx +366 -92
- package/src/MonthSelector.tsx +180 -55
- package/src/PeriodSlider.tsx +222 -120
- package/src/VirtualDateDropdown.tsx +2 -2
- package/src/YearSelector.tsx +171 -55
- package/src/dateOptionDomain.ts +31 -44
- package/src/index.ts +15 -0
- package/src/inputValue.ts +107 -0
- package/src/labels.ts +4 -4
- package/src/optionText.ts +4 -3
- package/src/selectorMemo.ts +51 -0
- package/src/selectorStep.ts +553 -0
- package/src/usePeriodSlider.ts +786 -268
- package/src/valueSet.ts +199 -17
- package/src/vernierStep.ts +566 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,326 @@ 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.16.0 (2026-10-01)
|
|
8
|
+
|
|
9
|
+
セレクタの ◀▶ を所有者へ引き渡す口と、◀▶ が期間・ノギスの窓をどう動かすかを 1 か所で決める規則を加えた版です。
|
|
10
|
+
あわせて、フックとセレクタの既存の欠陥 (離散レールの候補がセレクタへ届かない、平レールのフックがレールの描かない値を保持する、
|
|
11
|
+
通知が利用側の知らない値を取りこぼす、境界が初期値を越えて動くと送出する、`YearSelector` が Date の表現範囲の端で別の年を
|
|
12
|
+
発行し得る、など) を直しました。**新しい Props・オプションを渡さないホストでも、下の「変更」の各点で挙動が変わります**
|
|
13
|
+
(フックを使うホスト全般。とりわけ離散レール・実行中に動く境界・`setRange` などの直接の更新関数・`YearSelector` への番兵・`DateSelector variant="split-dropdown"` への -271821 年の日付を使うホストと、拒否メッセージの文言を照合するテスト)。
|
|
14
|
+
|
|
15
|
+
### 追加
|
|
16
|
+
|
|
17
|
+
- **3 セレクタの `stepper` Props**。`{ onStep, canStepPrevious, canStepNext }` を渡すと、◀▶ の押下は `onChange` ではなく
|
|
18
|
+
`onStep("previous" | "next")` だけを呼び、押せるかどうかは `canStepPrevious` / `canStepNext` そのものになります。これまで ◀▶ の押下は
|
|
19
|
+
隣の値を選んだ操作と同じ `onChange` で届き、所有者は両者を区別できず、押せるかどうかもセレクタ自身の判定 (示している値に隣があるか) に
|
|
20
|
+
縛られていました。セレクタは自分の値を動かさないため制御の `value` を要求し (`initialDate` だけなら `RangeError`)、
|
|
21
|
+
選択肢・入力で選んだ値は `onChange` で届きます。`disabled` は引き続き両方の矢印を無効にします。メモ比較は `stepper` を
|
|
22
|
+
フィールドごとに比べ、付け外しの描画と、付けたまま非制御へ切り替えた描画は省かずに検証します。
|
|
23
|
+
- **`resolveSelectorSteps`**。向きごとの規則 (`shift` [`edge` は `"disable"` 既定 / `"clamp"`]・`start`・`end`・`single`) のもとで、
|
|
24
|
+
◀▶ が選択 ([開始, 終了]) をどこへ送るか、そもそも送れるかを返す純関数です。動かす端はすべて単一の値のステッパーが送る先へ着くため、
|
|
25
|
+
選択と同じ単位の 1 歩ではセレクタ自身の ◀▶ の規則 (集合の外からは戻る向きだけが押せる) と一致します。離散候補 (`allowedDates`)、
|
|
26
|
+
片側だけの境界、`yearStartMonth`、月の期間を年の行で動かす 1 歩 (`stepUnit: "year"`。日の選択を月・年で動かす組み合わせは、暦の
|
|
27
|
+
月末で丸まって往復しても戻らないため `RangeError`) を扱います。両側へ広げる動きは `start` と `end` の組で表します。候補配列は
|
|
28
|
+
参照で同一視して 1 度だけ準備する (初回は O(n log n)) ため、以後の 1 歩の費用は候補の数に対して O(log n) です (100 年分の日の
|
|
29
|
+
候補でも、数か月分と比べて二分探索の数段しか増えません)。
|
|
30
|
+
- **`resolveVernierSelectorSteps`**。ノギスのマクロ行・ミクロ行の ◀▶ が確定するマクロ窓とミクロ選択を、向きごとにまとめて返す純関数です。
|
|
31
|
+
ミクロの 1 歩は今の窓ではなく定義域全体の上を動き、窓は `window` (`"keep"` 既定 / `"follow"`) で据え置くか行き先のマクロ単位へ合わせます
|
|
32
|
+
(離散マクロレールでは外側の候補へ吸着し、`edge: "clamp"` は最後の候補の窓の端で効きます)。行き先の窓のレールが描かない端は押した向きへ
|
|
33
|
+
そのレールが描く最初の値まで進み、どの端も押した向きに逆らって動きません。マクロの 1 歩は、窓ごと動けばミクロ選択を運び、片端だけ
|
|
34
|
+
動けば切り落とします。候補配列は `resolveSelectorSteps` と同じく 1 度だけ準備し、マクロの 1 歩も行き先の窓の候補を日付へ戻さずに
|
|
35
|
+
ミクロ選択を置くため、1 歩の費用は窓の広さに依りません。
|
|
36
|
+
- **`useSelectorStepper`**。行き先から `stepper` を作るフックです。`onStep` は描画を跨いで同一で、押せるかどうかが変わらない限り
|
|
37
|
+
同じオブジェクトを返します (セレクタのメモ比較が描画を省けるため)。行き先はオブジェクトか `null` で、`undefined` を返し得る出所は
|
|
38
|
+
型が拒みます。
|
|
39
|
+
- **フックのオプション `selectorStep` (`usePeriodSliderRange`)、`macroSelectorStep` / `microSelectorStep` (`useVernierSliderRange` /
|
|
40
|
+
`useVernierSliderPoint`)**。規則を渡した行の `SelectorProps` に `stepper` が載り (`SelectorProps.stepper`)、押下は他の変更と同じ確定経路を
|
|
41
|
+
通ります (コールバックは動いたスケールだけが 1 度ずつ鳴る)。規則は中身で、境界は時刻で比べるため、インラインの規則や描画ごとに
|
|
42
|
+
値の等しい新しい `Date` で渡した境界では行き先を求め直しません (求め直すのは規則の中身・選択・境界の時刻・単位・候補配列が変わったとき)。規則を渡さない行の Props に `stepper` キーは無く、規則は `sliderProps` へ転送されません。時点フックの
|
|
43
|
+
ミクロ行が読むのは `window` だけです。
|
|
44
|
+
- 型 `SelectorStepper` / `SelectorStepDirection` / `SelectorStepRule` / `SelectorStepRules` / `SelectorStepEdge` / `SelectorStepWindow` /
|
|
45
|
+
`VernierRangeStepRule` / `VernierPointStepRule` / `ResolveSelectorStepsOptions` / `SelectorStepTargets` /
|
|
46
|
+
`ResolveVernierSelectorStepsOptions` / `VernierSelectorStep` / `VernierSelectorStepTargets`。
|
|
47
|
+
- デモの 14 番目のセクション。ノギスのフックへ規則を渡し、年の行を窓ごと・月の行を期間ごと動かします (月の行の動き方と窓の扱いを切り替え、
|
|
48
|
+
規則を外した従来の動きとも比べられます)。
|
|
49
|
+
- `SelectorProps.allowedYears` / `allowedMonths` / `allowedDates` (下の「変更」の 1 点目)。
|
|
50
|
+
|
|
51
|
+
### 変更
|
|
52
|
+
|
|
53
|
+
- **フックのセレクタ Props (`SelectorProps`) が、離散レールの候補を運びます**。レールが離散の間 (`usePeriodSliderRange` /
|
|
54
|
+
`usePeriodSliderPoint` は `allowedDates` が空でない間、ノギスのマクロ行は `macroIsDiscrete` の間、ミクロ行は `microIsDiscrete` かつ
|
|
55
|
+
現在の窓が候補を含む間)、行の `unit` のセレクタが読むキー 1 つ (`"year"` は `allowedYears`、`"month"` は `allowedMonths`、
|
|
56
|
+
`"day"` は `allowedDates`) に、レールが描く候補 (定義域で絞り、単位の先頭へ正規化した昇順の配列) を載せます。スプレッドした
|
|
57
|
+
セレクタは選択肢も ◀▶ もレールが描く値だけを差し出します。0.15.1 までは候補でない年・月・日も選択肢に並び、規則を渡さない行の
|
|
58
|
+
◀▶ は候補でない値を発行していました。レールが連続の間はキーそのものを載せません。候補の一覧はフックが境界の時刻でメモ化するため、
|
|
59
|
+
境界へ描画ごとに値の等しい新しい `Date` を渡してもセレクタの描画は省かれます。
|
|
60
|
+
**離散の日レールのフックを `DateSelector` の `variant="split-dropdown"` へ広げると `RangeError` になります** (この形は離散集合を
|
|
61
|
+
扱えません)。この形を使い続けるならスプレッドの後ろに `allowedDates={undefined}` を書くか、`variant="dropdown"` /
|
|
62
|
+
`variant="date"` へ移してください。候補でない日の選択は、平レールのフックとノギスのミクロ行が最近傍の候補へ動かします
|
|
63
|
+
(ノギスのマクロ行は定義域へ収めるだけです)。
|
|
64
|
+
- **`usePeriodSliderRange` / `usePeriodSliderPoint` は、レールが描く値だけを保持します**。`allowedDates` がレールを離散にしている間、
|
|
65
|
+
確定する値 (設定関数・セレクタの `onChange`・`sliderProps` のコールバック・`resetRange` / `resetValue`) とレンダー中の収め直しを
|
|
66
|
+
最近傍の候補へ寄せてから `[minDate, maxDate]` へ収めます。0.15.1 までは候補でない値 (候補が 1 月と 6 月のレールでの `2024-03`) を
|
|
67
|
+
そのまま保持・通知し、レールだけが最近傍の候補 (`2024-01`) を描いていました (フックの値とレールの表示が別の期間を示す状態)。
|
|
68
|
+
候補と同じ単位の中の値 (`2024-01-15`) はその候補として描かれるため、渡したまま残ります。期間の両端が同じ候補へ寄って生の時刻で
|
|
69
|
+
逆転するときは、上限を下限へ揃えます。候補の上にない `initialRange` / `initialValue` は拒まず、初回の描画で同じ規則により
|
|
70
|
+
置き直します。連続レールの挙動 (時刻で `[minDate, maxDate]` へ収める) は変わりません。
|
|
71
|
+
- **フックの通知 (`onChangeRange` / `onChangePoint`、ノギスの `onChangeMacroRange` / `onChangeMicroRange` / `onChangeMicroPoint`) は、
|
|
72
|
+
確定した値が利用側の知っている値と異なるときに鳴ります**。知っている値とは、渡した初期値・`setRange` / `setValue` / `setMacroRange` /
|
|
73
|
+
`setMicroRange` / `setMicroValue` で自分で書いた値・最後に通知した値です。レンダー中の収め直し (境界や候補の変化、初期値の寄せ) はその場では通知せず、次にその値へ
|
|
74
|
+
落ち着いた操作で通知します。反対に、収め直しの後で利用側の知っている値へ戻る操作は、ステートが変わっても鳴りません。
|
|
75
|
+
0.15.1 までの平レールのフックは「ステートと異なるとき」だけ鳴ったため、収め直しの後に同じ値へ落ち着いた操作は利用側へ何も
|
|
76
|
+
伝えず、ノギスのマクロ窓の通知も「ステートと異なるとき」だけ鳴り、ミクロ通知は初回の描画で寄せた初期値を通知済みとして扱い、
|
|
77
|
+
直接の更新関数で書いた値を記録していませんでした (書いた値の後で以前の通知値へ戻る操作が鳴らなかった)。
|
|
78
|
+
- **`usePeriodSliderRange` / `usePeriodSliderPoint` は、設定関数とセレクタ・スライダーのコールバックへ渡した Invalid Date を、
|
|
79
|
+
フック名と入口の名前を名乗る `RangeError` で拒みます** (`setLowerDate(date)` / `setUpperDate(date)` / `sliderProps.onChangeRange(lower)` /
|
|
80
|
+
`selectorProps.onChange(date)` / `sliderProps.onChangePoint(value)`。`setRange` / `setValue` で入れた値は、次の描画が `range[0]` /
|
|
81
|
+
`value` などを名乗って拒みます)。ノギスのフックと同じ扱いです。0.15.1 までは Invalid Date をそのままステートと `onChangeRange` /
|
|
82
|
+
`onChangePoint` へ流していました。
|
|
83
|
+
- **期間を扱う 3 つのフック (`usePeriodSliderRange` / `useVernierSliderRange` / `useVernierSliderPoint`) は、利用側が渡した逆転した
|
|
84
|
+
期間を黙って揃えず、名乗って拒みます**。`setRange` / `setMacroRange` / `setMicroRange` で
|
|
85
|
+
入れた逆転した期間は次の描画が `range upper must not be earlier than lower` のように状態名を名乗って、`sliderProps` のコールバック
|
|
86
|
+
(`onChangeRange` / `onChangeMacroRange` / `onChangeMicroRange`) へ直接渡した逆転した期間は `sliderProps.onChangeRange(upper) must not
|
|
87
|
+
be earlier than lower` のように入口の名前を名乗って `RangeError` です (本体は逆転した期間を通知しません)。期間の両端が同じ候補へ
|
|
88
|
+
寄って生の時刻で逆転する場合だけは、上限を下限へ揃えます。
|
|
89
|
+
- **4 つのフックは、初期値 (`initialRange` / `initialValue` / `initialMacroRange` / `initialMicroRange` / `initialMicroValue`) を定義域と
|
|
90
|
+
初期の窓に照らすのを、マウント時だけにしました**。0.15.1 までは描画のたびに照らしたため、初期値を変えずに境界を初期値の先へ
|
|
91
|
+
動かすと、描画中に `RangeError` になっていました (仕様は「マウント後に動いた境界へはステートの収め直しで応じる」としていました)。
|
|
92
|
+
マウント時に渡した初期値だけがリセットの行き先になり、リセットもいまの定義域へ収めて確定します (ノギスの `resetVernier` は窓を
|
|
93
|
+
定義域へ収め、ミクロ選択をその窓のレールへ置きます)。
|
|
94
|
+
- **`YearSelector` は、年の始まりが Date の表現範囲の外にある Props を、prop 名を名乗る `RangeError` で拒みます**。対象は `value` /
|
|
95
|
+
`initialDate` / `minDate` / `maxDate` と `allowedYears` の要素 (その日付を含む年の、`yearStartMonth` の月の 1 日)、および
|
|
96
|
+
`minYear` / `maxYear` (どちらも発行し得る年を名指すため両方) です。0.15.1 までは、`new Date(-8.64e15)` のような番兵の境界で
|
|
97
|
+
選択肢のラベルが空になり `onChange` へ Invalid Date が届き得たほか、始まりが表現範囲の外にある年 (10 月始まりの
|
|
98
|
+
`maxYear={275760}`) を選ぶと、年の初日の組み立て (コンストラクタで作った Invalid Date に年を書き戻す 2 段組み) が範囲内の別の
|
|
99
|
+
日付へ化け、選んだのと別の年の日付を発行していました。年の初日は年・月・日を 1 回の `setFullYear` で組みます (`MonthSelector` /
|
|
100
|
+
`DateSelector` と同じ形)。番兵の境界のエラーは、実際に選ばせる年の範囲 (`minYear` / `maxYear`) か `allowedYears` を渡すよう示し、
|
|
101
|
+
年 Props のエラーは年の始まりを決めた開始月を名乗ります。
|
|
102
|
+
- **`DateSelector variant="split-dropdown"` は、1 月 1 日が Date の表現範囲の外にある年 (-271821 年) の日付を `RangeError` で
|
|
103
|
+
拒みます** (`YearSelector` と同じ規則)。`value` / `initialDate` / `minDate` / `maxDate` は prop 名を名乗り (境界には、`minYear` / `maxYear` で年を
|
|
104
|
+
宣言するよう示す番兵の直し方を添える)、以前の描画から保持している非制御の選択がその年にあるまま描く描画 (その選択を保持したままの
|
|
105
|
+
`variant="split-dropdown"` への切り替えと、制御から非制御への切り替え) は `variant="split-dropdown"` を名乗ります。メモ比較器も
|
|
106
|
+
この年の日付のキーを使えない値として扱い、再描画で渡したその年の日付 (制御中の `initialDate` を含む) もその描画で拒みます。0.15.1 までは、
|
|
107
|
+
境界・保持値・非制御の選択がその年にあると、年の選択肢 `-271821` と月の選択肢 `4` (保持年が境界の年でなければ 1〜4 月と、始まりが
|
|
108
|
+
範囲外の日) の基準日を表現範囲の外に組み、組み込みのテキストは空になり、`formatOption` は Invalid Date を受け取っていました
|
|
109
|
+
(Invalid Date で例外を投げるフォーマッタ、たとえば date-fns の `format` では描画ごと落ちていた)。4 月の日数も数えられず、31 日を
|
|
110
|
+
保持したまま 4 月を選ぶと、選んでいない 5 月 1 日を発行していました。
|
|
111
|
+
- **3 セレクタは、`allowedYears` / `allowedMonths` / `allowedDates` の `undefined` の要素と疎配列の穴を、添字付きの `RangeError` で
|
|
112
|
+
名指します**。0.15.1 までは `YearSelector` / `MonthSelector` が内部の `TypeError` で落ち、`DateSelector` は穴を黙って飛ばし、
|
|
113
|
+
`Date` でない要素と `undefined` を、どの要素かを名乗らない `TypeError` で落としていました。
|
|
114
|
+
- `allowedYears` / `allowedMonths` / `allowedDates` と `stepper` (3 セレクタと `SelectorProps`) の型は `| undefined` を明示します
|
|
115
|
+
(`Date[] | undefined`・`SelectorStepper | undefined`)。`exactOptionalPropertyTypes` を有効にした利用側でも、フックの Props を広げた後ろで
|
|
116
|
+
`allowedDates={undefined}` や `stepper={undefined}` を書けます。
|
|
117
|
+
- **拒否のメッセージは、受け取った文字列を JSON の引用符付きで示します** (例:
|
|
118
|
+
`formatOptionText: scope must be "period" or "part" (received: "label")`、
|
|
119
|
+
`PeriodSlider: value must be a valid Date (received: "2024-02-12")`)。0.15.1 までは、`formatLocale`・`locale`・`labels` の検証だけが
|
|
120
|
+
引用符を付け、ほかの検証 (Date 型 Props・年 Props・フックのオプション・`formatOptionText` の
|
|
121
|
+
引数など) は引用符なしで示していたため、日付に見える文字列が有効な Date の ISO 表記と見分けられず、空文字列は何も示されません
|
|
122
|
+
でした。メッセージに載る受け取った値と保持している値 (`received` / `holding`) はパッケージ全体で 1 つの関数が組みます (文字列は JSON、
|
|
123
|
+
有効な Date は ISO 8601、それ以外は `String()` の形)。`formatLocale` に文字列でない値を渡したときも JSON ではなくこの形で示します
|
|
124
|
+
(`NaN` は `null` ではなく `NaN`、素のオブジェクトは `{}` ではなく `[object Object]`、`BigInt` は名前を名乗らない `TypeError` ではなく数字)。
|
|
125
|
+
例外は `labels` と `locale` の検証で、それらを検証するエンジン (`@aiquants/virtualscroll`) と同じ形 (`got number` など) のままです
|
|
126
|
+
(`locale` のメッセージはエンジンのメッセージを包み直したもの)。解決した境界など、パッケージが組んだ日付は、これまでどおり
|
|
127
|
+
`yyyy-MM-dd` (`DateSelector`) / `yyyy-MM` (`MonthSelector`) で示します。
|
|
128
|
+
- **`PeriodSlider` のタプル Props の形のエラーは、描画に必須の `macroRange` だけが `is required` を名乗ります** (公開関数
|
|
129
|
+
`resolveMacroWindow` の引数 `macroRange` も同じ)。省ける選択 Props (`range` / `defaultRange` / `microRange` / `defaultMicroRange`) は
|
|
130
|
+
形だけを求めます (`PeriodSlider: defaultMicroRange must be a [start, end] Date tuple (received: null)`)。0.15.1 までは省ける Props も
|
|
131
|
+
`range is required and must be a [start, end] Date tuple` のように必須と名乗っていました。
|
|
132
|
+
- **ノギスの離散ミクロレールで、窓を動かす費用が候補の一覧の大きさに比例しなくなりました**。0.15.1 までのフック
|
|
133
|
+
(`useVernierSliderRange` / `useVernierSliderPoint`) は、窓が動くたび (レンダーと確定経路の両方) に候補の一覧全体を検証・整列し直し、
|
|
134
|
+
スライダー本体も窓の候補を一覧全体の符号化で絞っていました。どちらも候補を定義域で 1 度だけ解決し (候補の一覧・境界・単位・
|
|
135
|
+
`yearStartMonth` が変わったときだけ)、窓の候補はそのキーの二分探索で求めます。配置の結果 (値、値が変わらない端の `Date` そのもの、
|
|
136
|
+
連続レールが返す窓の端の `Date`、送出) は、下の (3) を除いて変わりません。利用側から見える違いは 4 つです。
|
|
137
|
+
(1) 両端が同じ候補へ吸着したミクロ選択の 2 つの端は、同じ時刻の別々の `Date` になることがあります (0.15.1 までは 1 つの `Date` を
|
|
138
|
+
共有していました)。(2) `shiftMicroRange` / `shiftMicroValue` が確定する `Date` は解決した一覧の `Date` そのもので、窓を跨いで同じ
|
|
139
|
+
インスタンスです (ミクロ行のセレクタへ渡す候補も同じ)。受け取った `Date` を書き換えないでください。(3) 単位の先頭が `Date` の
|
|
140
|
+
表現範囲の始まり (`-8.64e15` ms) より前になるミクロの値 (表現範囲の最初の単位の中の値。日の単位では UTC 以外の時間帯だけ) を候補の
|
|
141
|
+
ある窓へ置くと、`drawnValuesNearest: value must be a finite integer (received: NaN)` で送出します。0.15.1 までは、窓の候補が 1 つなら
|
|
142
|
+
その候補へ寄せ、2 つ以上なら `normalizeDateByUnit: d must be a valid Date (received: undefined)` で送出していました。
|
|
143
|
+
(4) フックの確定経路 (`sliderProps` のミクロのコールバック・`shiftMicroRange` / `shiftMicroValue`) は、画面に描かれている描画が
|
|
144
|
+
解決したミクロの候補を読みます。0.15.1 までは、確定していない描画 (保留中の移行) が渡した候補の一覧と離散スイッチを読むことが
|
|
145
|
+
あり、その間は画面のレールに無い値へ寄せ得ました。
|
|
146
|
+
ミクロ行のセレクタへ渡す窓の候補は窓が動くたびに新しい配列 (長さは窓の候補の数) で、セレクタはそれを受け取るたびに読み直すため、
|
|
147
|
+
セレクタを描く費用は窓の広さに比例します。
|
|
148
|
+
|
|
149
|
+
### 修正
|
|
150
|
+
|
|
151
|
+
- **3 セレクタは、値の単位 (年・月・日) を変えずに制御と非制御を切り替えた描画を省かなくなりました**。0.15.1 までは比較器が
|
|
152
|
+
その切り替えを「変化なし」とみなして描画を省き、制御へ移った後も本体が内部ステートで描き続けていました (▶ を押すと、利用側が
|
|
153
|
+
動かしていない値を表示していた)。
|
|
154
|
+
- **3 セレクタと `PeriodSlider` のメモ比較器は、再描画で渡した使えない Date 型 Props で例外を投げず、「変化なし」ともみなさなく
|
|
155
|
+
なりました**。Date でない値 (文字列・数値・`null`・素のオブジェクト) と Invalid Date は、初回のマウントと同じく、その描画で
|
|
156
|
+
Props 名を名指す `RangeError` になります (例: ``YearSelector: `minDate` must be a valid Date, received null.``)。比較器自身は、
|
|
157
|
+
どの値を渡しても例外を投げません。0.15.1 までは `YearSelector` / `MonthSelector` / `PeriodSlider` の比較器が、名前を名乗らない
|
|
158
|
+
`TypeError` (`date.getFullYear is not a function` など) を検証より先に投げていました。`DateSelector` の比較器は同じ日へ変換できる
|
|
159
|
+
文字列・数値・`null` を等しいとみなして描画ごと省き、検証は無関係な Props が次に変わった描画まで走りませんでした。制御中の
|
|
160
|
+
`initialDate`、`initialDate` と並べた `value={null}`、未指定から `null` / `0` / `""` へ変えた `MonthSelector` の境界、未指定から
|
|
161
|
+
`null` へ変えた `YearSelector` の `yearStartMonth` と `PeriodSlider` の `value` / `range` / `microValue` も同じく省かれていました。
|
|
162
|
+
有効な Date の扱いは変わりません (3 セレクタは同じ年・月・日の中の移動の描画を引き続き省き、`PeriodSlider` は引き続き時刻で比べます)。
|
|
163
|
+
- **ノギスは、制御のミクロ選択 (`microValue` / `microRange`) と並べて渡した既定値 (`defaultMicroValue` / `defaultMicroRange`) も
|
|
164
|
+
描画のたびに検証します** (point / range モードの `value` / `defaultValue`・`range` / `defaultRange` と同じ規則)。0.15.1 までは
|
|
165
|
+
制御の値があると既定値を検証せず、`null`・Invalid Date・定義域外の既定値を黙って受け取り、Date でない既定値 (文字列など) では
|
|
166
|
+
初回のマウントが通った後、最初の再描画でメモ比較器が名前を名乗らない `TypeError` (`prev.defaultMicroValue?.getTime is not a function`)
|
|
167
|
+
を投げていました。
|
|
168
|
+
- **拒否のメッセージを組む段で例外を投げなくなり、使えない Date 型 Props はすべて、初回のマウントでも再描画でも拒否した部品・関数の名前付きの
|
|
169
|
+
`RangeError` になります**。文字列へ変換すると例外になる値 (`Object.create(null)`・時刻値を持たずに `Date.prototype` を継ぐ
|
|
170
|
+
オブジェクト・Date を包んだ Proxy) を渡すと、0.15.1 までは有効な Date かの判定 (`getTime` の呼び出し) か、メッセージに載せる値の
|
|
171
|
+
文字列化が、名前を名乗らない `TypeError` (`this is not a Date object.`・`Cannot convert object to primitive value`) を投げて
|
|
172
|
+
いました。こうした値はメッセージでは `an object that cannot be converted to a string` と示します。有効な Date かどうかは Date
|
|
173
|
+
自身の時刻値で判定するため、自前の `getTime` を持つだけで `Date.prototype` を継ぐオブジェクトも有効な Date とはみなしません。
|
|
174
|
+
フックのオプションとステップ規則の検証も、同じ判定とメッセージの規則を読みます。
|
|
175
|
+
- **ノギスのフックは、本体がマクロ窓を動かしたとき、利用側がまだ知らないミクロ選択を窓の外のまま通知しなくなりました**。
|
|
176
|
+
レンダー中に収め直した選択が新しい窓のレールに載らないときは窓だけを確定し、本体が置き直した値を 1 度だけ通知します
|
|
177
|
+
(0.15.1 までは、収め直した値を先に鳴らしてから本体の値で 2 度目を鳴らしていました)。レールに載ったままの選択は、窓と一緒に
|
|
178
|
+
1 度だけ通知します。
|
|
179
|
+
- **`useVernierSliderPoint` のミクロセレクタの `onChange` は `setMicroDate` そのものになり**、Invalid Date を
|
|
180
|
+
`useVernierSliderPoint: setMicroDate(date)` を名乗って拒みます (0.15.1 までは内部関数 `normalizeDateByUnit` の名前で失敗していました)。
|
|
181
|
+
- **`getSortedAllowedDates` (本体・フックが離散候補を解決する関数) は、Date でない要素と疎配列の穴を
|
|
182
|
+
`getSortedAllowedDates: allowedDates[1] must be a valid Date (received: undefined)` のように添字付きで名指します** (0.15.1 までは
|
|
183
|
+
正規化の奥の `normalizeDateByUnit` の名前で、どの要素かを名乗らずに失敗していました)。
|
|
184
|
+
- **`MonthSelector` / `DateSelector` の表現範囲のエラーは、番兵の境界 (`minDate` / `maxDate`) にだけ直し方を添えます**
|
|
185
|
+
(`YearSelector` と同じ規則)。値や許可月・許可日の要素のエラーに「prop を省く」直し方を添えていたのをやめ、境界の直し方も
|
|
186
|
+
「変種が許せば境界を省く、または `minYear` / `maxYear` か許可集合で宣言する」に改めました (境界が必須の変種もあるため)。
|
|
187
|
+
境界の双方を要し `allowedDates` も拒む `DateSelector variant="split-dropdown"` の境界のエラーは、`minYear` / `maxYear` で年を
|
|
188
|
+
宣言するようにだけ示します。
|
|
189
|
+
- **`DateSelector variant="split-dropdown"` が上限より後の保持年・保持月を暦の終わりまで埋める月と日の一覧は、Date の表現範囲の端で
|
|
190
|
+
終わります**。0.15.1 までは、275760 年の保持値で 10〜12 月を基準日の無い選択肢 (空のテキスト、`formatOption` へ Invalid Date) として
|
|
191
|
+
描き、同年 9 月の保持値では日数を数えられずに日の一覧が空でした (日のセレクトはプレースホルダだけで `select.value === ""`)。日の一覧は
|
|
192
|
+
実在する日だけを並べ (次項)、保持日だけが変わっても組み直しません (同じ月の中で保持日が動くだけなら、日の選択肢のために
|
|
193
|
+
`formatOption` は呼ばれ直しません)。
|
|
194
|
+
- **`DateSelector variant="split-dropdown"` の日の一覧はローカルの暦に実在する日だけを並べ、どの選択肢も自分が名指す日だけを
|
|
195
|
+
発行します**。実在するのは、年・月・日から組んだ日付が同じ年・月・日を名乗る日だけです (月の日数は数えません)。0.15.1 までは
|
|
196
|
+
月の日数で一覧を組んでいたため、タイムゾーンが月の途中の日を飛ばした月 (Pacific/Apia の 2011 年 12 月は 30 日が無い) では
|
|
197
|
+
30 日の選択肢が `31` と描かれ、それを選ぶと (保持日と組んでその日になる年・月を選んでも) 選んでいない 12 月 31 日を発行し、
|
|
198
|
+
月末の日を飛ばした月 (Pacific/Kiritimati と Pacific/Kanton の 1994 年 12 月、Asia/Manila の 1844 年 12 月) では日の一覧が
|
|
199
|
+
1 日の 1 件だけになり、ほかの日を選べませんでした。飛ばされた日は一覧に現れず、その日になる年・月の選択肢は `disabled` です。
|
|
200
|
+
|
|
201
|
+
### 移行
|
|
202
|
+
|
|
203
|
+
- `onChange` に届いた値が今の値の隣かどうかで ◀▶ の押下を推し量っていた利用側は、`stepper` で押下を直接受け取れます
|
|
204
|
+
(README「セレクタの矢印を所有者が引き受ける」)。推し量りは、選択肢から隣の値を選んだ操作と区別できません。
|
|
205
|
+
- フックへ規則を渡した行の `SelectorProps` には `stepper` が載ります。`SelectorProps` をセレクタへそのままスプレッドしていれば、
|
|
206
|
+
ほかに書き換えるものはありません。
|
|
207
|
+
- 離散レールをフックで使い、候補でない選択肢や ◀▶ の行き先を前提にしていたテストは、候補の上の値へ改めてください。セレクタへ
|
|
208
|
+
自分で `allowedYears` / `allowedMonths` / `allowedDates` を渡していた場合、スプレッドの後ろに書いていればその値がそのまま勝ち、
|
|
209
|
+
前に書いていればフックの候補が勝ちます (フックが載せるのはレールの候補そのものなので、同じ集合なら書かなくて構いません)。
|
|
210
|
+
- 通知の回数を数えるテストは、収め直しや初期値の寄せの後にその値へ落ち着く操作で 1 回増え、収め直しの後に利用側の知っている値へ
|
|
211
|
+
戻る操作で 1 回減ることがあります。ノギスのミクロ通知は、`setMicroRange` / `setMicroValue` で書いた値の後に以前の通知値へ戻る
|
|
212
|
+
操作で 1 回増え、書いた値と同じ値の確定で 1 回減ります。現在の値は、コールバックではなくフックの `range` / `value` /
|
|
213
|
+
`microRange` / `microValue` で読めます。
|
|
214
|
+
- 平レールのフックの設定関数・コールバックへ Invalid Date を渡し得るコードは、値を検証してから渡してください (`RangeError` になります)。
|
|
215
|
+
- 境界を動かすたびに `initialRange` などを境界の内側へ作り直して渡していた回避は、要らなくなりました。
|
|
216
|
+
- ノギスで `microValue` / `microRange` と一緒に `defaultMicroValue` / `defaultMicroRange` を渡している場合、既定値も有効な Date
|
|
217
|
+
(タプル) で定義域の中にある必要があります。表示に使わない既定値は渡さないでください。
|
|
218
|
+
- 再描画でセレクタや `PeriodSlider` の Date 型 Props へ文字列・数値・`null` を渡していた場合 (`DateSelector` へ同じ日の ISO 文字列を
|
|
219
|
+
渡すなど、0.15.1 では描画が省かれて気付かなかったものを含む) は、その描画で `RangeError` になります。Date を渡してください。
|
|
220
|
+
- 拒否のメッセージの文言を照合しているテストは、受け取った文字列を引用符付きで照合してください (`(received: x)` は
|
|
221
|
+
`(received: "x")`、`DateSelector` の `(received 2024-05-02)` は `(received "2024-05-02")`)。`PeriodSlider` の省ける選択 Props の
|
|
222
|
+
タプルのエラーは `is required and` を含みません (`range is required and must be a [start, end] Date tuple` は
|
|
223
|
+
`range must be a [start, end] Date tuple`)。
|
|
224
|
+
- `DateSelector` の `variant="split-dropdown"` に -271821 年の日付 (UTC で渡す番兵 `new Date(-8.64e15)` を含む) を渡していた場合は
|
|
225
|
+
`RangeError` になります。選ばせる年を `minYear={-271820}` のように宣言するか、日だけを描く `variant="dropdown"` / `variant="date"` を
|
|
226
|
+
使ってください。非制御のまま `variant` を切り替える画面や、制御と非制御を切り替える画面でその年の日を選ばせていた場合は、`value` で制御してください。
|
|
227
|
+
|
|
228
|
+
### 0.13.0 の記述の訂正
|
|
229
|
+
|
|
230
|
+
- 「新しいコールバックはその選択肢が確定する日付そのものを受け取る」は不正確でした。分割セレクトの部位 (`scope === "part"`) の
|
|
231
|
+
選択肢が受け取るのは、その `<select>` の値と、それより粗い保持中の部位から決まる日付 (年は 1 月 1 日、月は保持中の年の当月 1 日、
|
|
232
|
+
日は保持中の年月とその日) であり、確定日を基準日にする形は同じ 0.13.0 の「修正」のとおり撤回されています。和暦の元号のように
|
|
233
|
+
確定日の呼び名が要る場合は、同じ節の既知の制約のとおり、利用側が自分の基準日を選んでください。
|
|
234
|
+
|
|
235
|
+
### 文書
|
|
236
|
+
|
|
237
|
+
- README から版ごとの移行節 (0.12・0.13・0.14・0.15.0 からの移行、インストール節の 0.9.0 / 0.10.x からの注意、`DateSelector` の
|
|
238
|
+
`<select>` を前提にしたテストの読み替え) を除き、本書の該当する版へ移しました。README は現在の仕様だけを書き、版ごとの変更と
|
|
239
|
+
移行手順は本書が持ちます。README にしか無かった手順と例は 0.11.0・0.13.0・0.14.0・0.15.1 の各節へ書き足しています。
|
|
240
|
+
- README の `useVernierSliderPoint` の `yearStartMonth` は「4 つの `SelectorProps` へ転送」としていましたが、このフックが返すセレクタ
|
|
241
|
+
Props は 3 つ (マクロ開始・マクロ終了・ミクロ時点) のため直しました。
|
|
242
|
+
|
|
243
|
+
## 0.15.1 (2026-09-25)
|
|
244
|
+
|
|
245
|
+
0.15.0 の回帰を直す修正版です。0.15.0 は「`allowedYears` を渡していないホストの DOM は、上の 5 点以外は 1 バイトも変わりません」と
|
|
246
|
+
書きましたが、0.14.0 と 0.15.0 を同じ入力で描き比べると、それ以外の変化がありました。本版はそのうち欠陥であるものを直し、
|
|
247
|
+
意図どおりのものは下の「0.15.0 の記述の訂正」に書き足します。Props は増えません。
|
|
248
|
+
|
|
249
|
+
### 修正
|
|
250
|
+
|
|
251
|
+
- **`DateSelector` (`variant="date"`) で境界が片側でも欠けると、◀▶ が両方とも使用不可になっていました** (0.15.0 の回帰)。
|
|
252
|
+
◀▶ の行き先を選択肢一覧 (`variant="dropdown"` のための添字空間。両境界が揃わないと空になる) へ尋ねていたためです。
|
|
253
|
+
◀▶ と所属判定は、`MonthSelector` / `YearSelector` と同じく選択可能集合そのもの (宣言の無い側は無制限) を読みます。
|
|
254
|
+
境界なし・`minDate` だけ・`minYear` だけ・`maxDate` だけ・`maxYear` だけのいずれでも ±1 日を発行し、境界のある側は
|
|
255
|
+
0.15.0 の規則のまま (境界日では使用不可、集合の外の保持値からは戻る向きだけが有効) です。
|
|
256
|
+
- **0 年 2 月 29 日を 3 月 1 日と取り違えていました**。日通番の算出が 0-99 年を 1900 年代へ写してから年を戻しており、
|
|
257
|
+
うるう年でない 1900 年に 2 月 29 日が無いためです。0.15.0 でステッパーがこの通番を読むようになり、◀▶ がうるう日を飛ばす・
|
|
258
|
+
3 月 1 日で足踏みする、`variant="dropdown"` がアクティブ行の無いポップアップを開く、が起きていました。`variant="split-dropdown"` で
|
|
259
|
+
0 年 2 月の 29 日を選ぶと 3 月 1 日を発行していた (0.15.0 より前から) のも同じ原因です。日通番はパッケージの日キー
|
|
260
|
+
`encode("day")` / `decode("day")` そのものへ一本化しました。
|
|
261
|
+
- **`mode="vernier"` の `macro-connect` ドラッグが、新しい窓の縁に一部だけ掛かったミクロ選択を縁で切り落としていました**
|
|
262
|
+
(0.15.0 の回帰。0.14.0 は長さを保って押し戻していた)。窓ごとの平行移動は、越えたのが一部でも全部でも選択を丸ごと押し戻します。
|
|
263
|
+
同じ規則により、`Shift` + ホイールとフックの `shiftMacroRange` でも一部だけ掛かった選択が縮まなくなりました
|
|
264
|
+
(0.15.0 の README の「窓の縁で止まる分も長さが先に決まります」は、完全に外れた選択にしか当てはまっていませんでした)。
|
|
265
|
+
- **ノギスのフック (`useVernierSliderRange` / `useVernierSliderPoint`) の `sliderProps` で描いたスライダーは、窓を動かす操作で
|
|
266
|
+
ミクロ選択の通知を 2 度鳴らしていました**。`Shift` + ホイール 1 回で窓頭の 1 点へ潰れた途中値を先に鳴らし (0.15.0 の回帰)、
|
|
267
|
+
`macro-connect` のドラッグでは窓へ運んだだけの値を先に鳴らしていました (0.14.0 から)。フックは本体から届いたマクロ窓の変化では
|
|
268
|
+
窓だけを記録し、ミクロ選択の置き直しを本体に任せます。本体は操作ごとの規則 (つまみ 1 本は縁で切り落とす、ホイールとキーボードは
|
|
269
|
+
窓ごと運ぶ、`macro-connect` は暦の差分だけ平行移動してから運ぶ) で置き直した値を 1 度だけ通知し、フックのステートはその値になります。
|
|
270
|
+
- **ノギスのフックは、窓の最初と最後の単位の途中にあるミクロ日付を単位の先頭へ書き換えていました** (0.14.0 から)。
|
|
271
|
+
12 月で終わる窓の中の `2024-12-15` は、本体にとっては 12 月の上にある正当な値ですが、フックは時刻で比べて `2024-12-01` へ
|
|
272
|
+
切り落としていました。本体が「動いていない」とみなして通知しない場面 (マクロつまみで窓を縮めた直後、`initialMicroRange` /
|
|
273
|
+
`initialMicroValue` の初回描画など) では、ステートだけが黙って変わっていました。フックの包含判定は本体と同じくミクロ単位で行い、窓の内側の値は
|
|
274
|
+
渡されたまま残します。`initialMicroRange` / `initialMicroValue` に単位の途中の日付を渡していたホストでは、初回描画から
|
|
275
|
+
渡した値のままになります。`shiftMicroRange` が窓の最後の単位の途中へ着くシフトを「はみ出す」として中止していたのも同じ原因です。
|
|
276
|
+
- **離散マクロレールへ候補の外の `macroRange` を渡すと、マクロつまみの `aria-valuenow` が自分の `aria-valuemin` /
|
|
277
|
+
`aria-valuemax` の外を指していました** (0.15.0 の回帰。可動端を候補集合の端にした変更で生じた)。外側の端は
|
|
278
|
+
「可動端と現在値のうち外側の方」を名乗ります。候補の上に居る間は 0.15.0 と同じく候補集合の端です。
|
|
279
|
+
|
|
280
|
+
### 変更
|
|
281
|
+
|
|
282
|
+
- **Date の表現範囲の外に始まりがある日付を `DateSelector` / `MonthSelector` へ渡すと、prop 名を名乗る `RangeError` で失敗します**。
|
|
283
|
+
対象は `value` / `initialDate` / `minDate` / `maxDate` と許可日・許可月の要素 (`DateSelector` はローカルのその日の始まり、
|
|
284
|
+
`MonthSelector` はその月の始まり)、および年 Props が境界として名指す端 (`minYear` は 1 月 1 日・1 月、`maxYear` は
|
|
285
|
+
12 月 31 日・12 月) です。反対側の端は境界に使われないため検査しません (`minYear={275760}` は受け付けます)。0.14.0 は UTC 以外のタイムゾーンで
|
|
286
|
+
`new Date(-8.64e15)` のような番兵の境界を黙って無視し、0.15.0 は内部関数の名前 (`drawnValuesHas` など) の例外で描画を止めるか、
|
|
287
|
+
◀▶ を両方とも使用不可にしていました。境界を持たない側は、番兵を渡さずその prop を省いてください。
|
|
288
|
+
- **`MonthSelector` の入力欄へ打ち込んだ Date の表現範囲外の年月は破棄します** (`onChange` を発火しない)。0.14.0 は Invalid Date を
|
|
289
|
+
発行するか 1 月へ巻き戻した値を発行し、0.15.0 は内部の例外を投げていました (`input[type="month"]` がテキスト欄へ退化するブラウザで
|
|
290
|
+
届く経路です)。両セレクタとも、境界の無い側で表現範囲の端に着いた ◀▶ は使用不可になり、`variant="split-dropdown"` は
|
|
291
|
+
表現範囲の端の年・月のうち存在しない日になる組み合わせを選べなくします。
|
|
292
|
+
- **ノギスの 2 つのフックの設定関数は、Invalid Date をフック名と関数名を名乗る `RangeError` で拒みます**
|
|
293
|
+
(`useVernierSliderRange` の `setMacroLowerDate` / `setMacroUpperDate` / `setMicroLowerDate` / `setMicroUpperDate`、
|
|
294
|
+
`useVernierSliderPoint` の `setMacroLowerDate` / `setMacroUpperDate` / `setMicroDate`)。検証を通らない `setMacroRange` /
|
|
295
|
+
`setMicroRange` / `setMicroValue` で Invalid Date を入れた場合は、次の描画が `macroRange[0]` / `microRange[1]` / `microValue`
|
|
296
|
+
などの状態名を名乗って失敗します。0.15.0 はマクロ側が `resolveMacroWindow`、ミクロ側が `normalizeDateByUnit` の名前で、
|
|
297
|
+
`useVernierSliderPoint` の `setMicroDate` は Invalid Date を黙ってステートと通知へ流していました。
|
|
298
|
+
`sliderProps` のコールバック (`onChangeMacroRange` / `onChangeMicroRange` / `onChangeMicroPoint`) を利用側が直接呼んだ場合も、
|
|
299
|
+
`useVernierSliderRange: sliderProps.onChangeMicroRange(upper) is required ...` のように引数名まで名乗って拒みます。
|
|
300
|
+
- **4 つのフックのシフト関数は、整数でない `delta` (`NaN`・`Infinity`・小数) をフック名と関数名を名乗る `RangeError` で拒みます**
|
|
301
|
+
(`usePeriodSliderRange` の `shiftRange`、`usePeriodSliderPoint` の `shiftValue`、ノギスの 2 フックの `shiftMacroRange` と
|
|
302
|
+
`shiftMicroRange` / `shiftMicroValue`。メッセージは `useVernierSliderRange: shiftMicroRange(delta) must be an integer number of units (received: NaN)`)。
|
|
303
|
+
0.15.0 は `NaN` を渡すと、平坦な 2 フックが Invalid Date を `onChangeRange` / `onChangePoint` へ通知し、ノギスの 2 フックが
|
|
304
|
+
`resolveMacroWindow` / `normalizeDateByUnit` の名前の例外を投げていました。小数は、連続レールでは月・日の加算で切り捨てられ
|
|
305
|
+
(`0.5` は動かない)、年単位のマクロ窓は `0.5` で半年ずれて単位の途中へ着き、離散レールでは存在しない候補の添字を読んで
|
|
306
|
+
`Cannot read properties of undefined` か内部関数の名前の例外になっていました。`0` と負の整数はこれまでどおり受け付けます。
|
|
307
|
+
- **ノギスのフックのミクロ通知 (`onChangeMicroRange` / `onChangeMicroPoint`) は、「ここへ最後に通知した値と異なるとき」に鳴ります**。
|
|
308
|
+
定義域や窓の変化でレンダー中に収め直された値は、従来どおりその場では通知しませんが、次に確定した操作の値が収め直し後の
|
|
309
|
+
ステートと同じでも、利用側がまだ知らない値であれば通知します (本体がマクロとミクロを別々のタイマーで確定する
|
|
310
|
+
`debounceMs` 指定時に、この順で届きます)。確定した値が利用側の知っている値に戻っただけのときは鳴りません。
|
|
311
|
+
|
|
312
|
+
### 0.15.0 の記述の訂正
|
|
313
|
+
|
|
314
|
+
- 「`macro-connect` のドラッグだけが長さを保っていました」は不正確でした。0.14.0 はミリ秒の長さで運んでいたため、ミクロ単位が月だと
|
|
315
|
+
窓の縁で 1 か月伸びたり 1 点へ潰れたりし、夏時間のあるタイムゾーンでは日数が 1 日ずれました。0.15.0 以降はミクロ単位で数えます。
|
|
316
|
+
`macro-connect` は暦の差分だけ平行移動してから押し戻すため、日単位の選択の長さは運んだ先の暦での日数です
|
|
317
|
+
(窓に収まるときと縁に掛かったときで長さが変わりません)。
|
|
318
|
+
- 「0.14 までは集合から 2 単位以上離れた保持値では両方の矢印が使用不可」は連続集合の場合です。`allowedDates` / `allowedMonths` を
|
|
319
|
+
指定したセレクタは、0.14.0 でも集合からの距離に関わらず最寄りの候補へ進んでいました。
|
|
320
|
+
- 「窓ごとの平行移動でミクロ選択の長さが保たれます」は、離散ミクロレールでは両端がそれぞれ最寄りの候補へ寄るため、候補の疎な窓で
|
|
321
|
+
短くなることがあります (0.14.0 から同じ)。
|
|
322
|
+
- `YearSelector` の送出メッセージが 2 つ変わっていました。境界が欠けたときは ``..., or `allowedYears`, are required; ...``、
|
|
323
|
+
選べない年を発行しようとしたときは `... which lies outside the selectable years.` (境界の年を名乗らない) です。送出する条件は同じです。
|
|
324
|
+
- `MonthSelector` で `maxYear={275760}` を渡すと、0.14.0 は表現範囲の外の月を 275760 年 1 月へ巻き戻した境界で描いていました。
|
|
325
|
+
本版は上の「変更」のとおり `RangeError` です。
|
|
326
|
+
|
|
7
327
|
## 0.15.0 (2026-09-25)
|
|
8
328
|
|
|
9
329
|
「その値は描かれているか」「端はどこか」「その向きの次はどれか」「集合が動いたとき対はどこへ行くか」の 4 つを
|
|
@@ -100,8 +420,10 @@ All notable changes to `@aiquants/period-slider` are documented here.
|
|
|
100
420
|
> **0.13 で `locale="ja"` / `locale="en"` を渡していたホストは、型エラーも実行時エラーも出ないまま意味が変わります**。
|
|
101
421
|
> `"ja"` / `"en"` は 0.13 では日付書式の正当な BCP 47 タグでしたが、0.14 では UI 言語の `locale` の受理値そのものです。
|
|
102
422
|
> `formatLocale` へ改名しない限り、日付テキストは黙って ISO 8601 へ戻り (`2024/01` → `2024-01`、`04/15/2025` → `2025-04-15`)、
|
|
103
|
-
> `"ja"` では部品の名前も日本語カタログへ切り替わります (`Previous month` → `前月`)
|
|
423
|
+
> `"ja"` では部品の名前も日本語カタログへ切り替わります (`Previous month` → `前月`)。アクセシブル名や Intl 書式の日付を照合するテストは、
|
|
424
|
+
> 原因を示さずに失敗します。
|
|
104
425
|
> **0.13 の `locale` は値が何であれ、すべて `formatLocale` へ改名してください**。日本語の名前が欲しい場合に限り、そのあとで `locale="ja"` を加えます。
|
|
426
|
+
> フックのオプション (`{ locale: "ja" }` → `{ formatLocale: "ja" }`) と `SelectorProps` も同じです。
|
|
105
427
|
|
|
106
428
|
- `locale="ja-JP"` (日付書式) → `formatLocale="ja-JP"`。フックの `{ locale: "ja-JP" }` も `{ formatLocale: "ja-JP" }` へ。
|
|
107
429
|
`"ja"` / `"en"` 以外のタグを旧名のまま渡すと、UI 言語の `locale` として
|
|
@@ -206,7 +528,34 @@ All notable changes to `@aiquants/period-slider` are documented here.
|
|
|
206
528
|
`MonthSelector` / `YearSelector` には何も無い) を、`formatOption` 1 つへ畳んだためです。
|
|
207
529
|
- 移行はそのまま 1 行で書けます: `formatMonthOption={(m) => g(m)}` →
|
|
208
530
|
`formatOption={(date, unit, scope) => (scope === "part" && unit === "month" ? g(date.getMonth() + 1) : formatOptionText(date, unit, scope, locale))}`。
|
|
209
|
-
担当しない組は `formatOptionText` へ転送してください。
|
|
531
|
+
担当しない組は `formatOptionText` へ転送してください。3 つの旧 Props は同じ 1 つの関数の枝になります (旧 Props が受け取っていた
|
|
532
|
+
数値は、受け取った日付から取り出せます):
|
|
533
|
+
|
|
534
|
+
| 0.12 まで | 0.13 から |
|
|
535
|
+
| :--- | :--- |
|
|
536
|
+
| `formatYearOption={(year) => …}` | `formatOption` の `unit === "year" && scope === "part"` の枝 (`year` は `date.getFullYear()`) |
|
|
537
|
+
| `formatMonthOption={(month) => …}` | 同じ関数の `unit === "month" && scope === "part"` の枝 (`month` は `date.getMonth() + 1`) |
|
|
538
|
+
| `formatDayOption={(day) => …}` | 同じ関数の `unit === "day" && scope === "part"` の枝 (`day` は `date.getDate()`) |
|
|
539
|
+
|
|
540
|
+
```tsx
|
|
541
|
+
// 0.12
|
|
542
|
+
<DateSelector variant="split-dropdown" locale="ja-JP" formatMonthOption={(month) => `${month}月`} {...rest} />
|
|
543
|
+
|
|
544
|
+
// 0.13 — 担当しない組は formatOptionText へ転送し、書式ロケールは Props ではなく第 4 引数で渡す
|
|
545
|
+
const formatOption: PeriodOptionFormatter = (date, unit, scope) =>
|
|
546
|
+
unit === "month" && scope === "part" ? `${date.getMonth() + 1}月` : formatOptionText(date, unit, scope, "ja-JP")
|
|
547
|
+
|
|
548
|
+
// formatOption(new Date(2025, 3, 15), "month", "part") === "4月"
|
|
549
|
+
// formatOption(new Date(2025, 3, 15), "day", "part") === "15日" (組み込みの段へ委譲。第 4 引数を省くと "15")
|
|
550
|
+
<DateSelector variant="split-dropdown" formatOption={formatOption} {...rest} />
|
|
551
|
+
```
|
|
552
|
+
|
|
553
|
+
- **書式ロケール (`locale`。0.14.0 で `formatLocale` へ改名) を指定していたホストは、同じタグを `formatOptionText` の第 4 引数へ
|
|
554
|
+
渡してください**。`formatOption` は書式ロケールより上の段なので、フォーマッタを渡した時点で Props の書式ロケールはどの表示
|
|
555
|
+
テキストにも届かなくなります (残しても害はありませんが、表示は決めません)。転送時に第 4 引数を省くと、自分で描かない組だけが
|
|
556
|
+
Intl の段からロケール非依存の ISO 8601 の段へ落ちます — 上の例では年が `2025年` → `2025`、日が `15日` → `15` となり、自分で
|
|
557
|
+
描いた月だけが変わらないため、3 列のうち 2 列が黙って言語を変えます。書式ロケールを指定していなかったホストは、第 4 引数も
|
|
558
|
+
省いたままで挙動が変わりません。
|
|
210
559
|
- **旧 Props は数値 1 つしか受け取らなかったため、年度も四半期も表現できませんでした**。`formatYearOption(2019)` からは
|
|
211
560
|
その 4 月がどの年度に属するのかを知る術が無く、`formatMonthOption(4)` は年を知りません。新しいコールバックは
|
|
212
561
|
その選択肢が確定する日付そのものを受け取るため、どちらも導けます。
|
|
@@ -226,8 +575,10 @@ All notable changes to `@aiquants/period-slider` are documented here.
|
|
|
226
575
|
- **その場に書いた無名関数では、診断が Props の名前を 1 度も出しません**。
|
|
227
576
|
`formatLabel={(d, verbose = false) => …}` の診断は `TS2322: Type 'false' is not assignable to type
|
|
228
577
|
'PeriodSliderUnit'` であり、Props ではなく既定値そのものを指します。
|
|
578
|
+
- `dates.map(formatDate)` と共用するために書かれがちな `(date: Date, index?: number) => string` は
|
|
579
|
+
`Type '(date: Date, index?: number) => string' is not assignable to type 'PeriodOptionFormatter'` になります。
|
|
229
580
|
- **移行**: 第 2 / 第 3 引数の型を `unit` / `scope` を受けられる形まで広げるか、1 引数のラッパーで包んでください
|
|
230
|
-
(`formatLabel={(d) => padded(d)}`)。
|
|
581
|
+
(`formatLabel={(d) => padded(d)}`。`map` と共用している関数なら、`map` へ `(date) => formatDate(date)` を渡す形でも構いません)。
|
|
231
582
|
- **型エラーにならない側にも一度目を通してください**。余分な引数が `string` / `unknown` / `any` / 可変長のときは
|
|
232
583
|
0.12.0 でも本リリースでも型エラーになりませんが、0.12.0 が `customFormat(d)` と 1 引数で呼んでいたのに対し
|
|
233
584
|
本リリースは `customFormat(d, unit, "period")` と呼ぶため、既定値ではなく `unit` と `scope` が入ります
|
|
@@ -357,7 +708,10 @@ All notable changes to `@aiquants/period-slider` are documented here.
|
|
|
357
708
|
変わりません。
|
|
358
709
|
- 操作要素は `<input type="text" readonly role="combobox">` になり、`value` は人間が読むテキスト、機械可読値は
|
|
359
710
|
`data-value` (`yyyy-MM-dd`) です。`<select>` の `value` / `options` / `selectOption` を前提にしたテストと DOM 参照は
|
|
360
|
-
|
|
711
|
+
次のように読み替えてください: `select.value` → `combobox.getAttribute("data-value")`、`select.options` を数える → 開いてから
|
|
712
|
+
行の `aria-setsize` を読む (描画される行は可視窓の分だけ)、`selectOption(value)` → 開いて行を押すか、ISO の数字を打って `Enter`。
|
|
713
|
+
Playwright の `getByRole("combobox", { name: "Date" })` はそのまま解決します (名前は既定の `Date`)。`toHaveValue` は書式ロケール
|
|
714
|
+
(0.11 の `locale`、0.14.0 からの `formatLocale`) のテキストと比較されるため、ISO は `toHaveAttribute("data-value", …)` で読みます。
|
|
361
715
|
- ポップアップは `document.body` へポータルされ、下に余地が無ければ上へ反転して視野内へ収まります。各行は
|
|
362
716
|
`aria-posinset` / `aria-setsize` を集合全体の件数で持ち、キーボード (矢印・`Home` / `End` / `PageUp` / `PageDown` /
|
|
363
717
|
`Enter` / `Escape` / 先頭一致入力) は操作要素が `aria-activedescendant` 方式で担います。タッチでは OS のホイール式
|