@aiquants/period-slider 0.12.0 → 0.14.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
@@ -1,11 +1,242 @@
1
1
  # Changelog
2
2
 
3
3
  All notable changes to `@aiquants/period-slider` are documented here.
4
- 見出しは公開済みの版番号です。`## Unreleased` は次の公開に入る変更であり、公開のコミットで版番号へ改め、新しい `## Unreleased` を起こします
5
- (改めないと、同梱される release notes が公開後も `## Unreleased` のままになります)。
4
+ 見出しは版番号です。次の公開に入る変更は、その版番号と作成日の見出し (`## 0.14.0 (2026-09-24)` の形) の下へ書きます。
6
5
  本書は 0.10.0 で起こしたため、0.7.0 以前の項はありません (0.8.0 と 0.9.0 は公開済みの差分から起こした要約です)。
7
6
 
8
- ## Unreleased
7
+ ## 0.14.0 (2026-09-24)
8
+
9
+ 部品の名前を読み手の言語で名乗らせる UI クローム言語 (`locale` / `labels`) を加え、日付書式のロケールを `formatLocale` へ
10
+ 改名。2 つは独立した軸で、一方から他方を導出しません。**0.x の破壊的変更を含むマイナー版です** (下の「移行」を参照)。
11
+
12
+ ### 追加
13
+
14
+ - **`locale?: "en" | "ja"` (UI クローム言語) を `PeriodSlider` / `YearSelector` / `MonthSelector` / `DateSelector` が
15
+ 受け取ります**。つまみ・ステッパー・セレクト・コンボボックス・ポップアップの `listbox` の名前を凍結カタログ
16
+ `PERIOD_SLIDER_LABEL_CATALOGS` から選びます。既定は `"en"` で、その文言は 0.13 の英語既定と 1 バイトも違わないため、
17
+ `locale` を渡さないホストの DOM は変わりません。`"en"` / `"ja"` 以外 (`"ja-JP"`・`"EN"`・`""`・`null` 等) は
18
+ `RangeError: [period-slider] locale is the UI language, not a BCP 47 tag (date formatting reads formatLocale): ...`
19
+ です (エンジンの `RangeError` を `cause` に保持)。言語ネゴシエーションは行いません (`navigator.language` からの対応付けはホストの責務です)。
20
+ - **`labels?: PeriodSliderLabelOverrides` でカタログをキー単位に上書きできます**。全 29 キー (エンジン 7 + 固有 22) の
21
+ 閉じた集合で、各部品は自分のキーだけを読むため、1 つのオブジェクトをスライダーと全セレクタへ渡せます。
22
+ 解決規則は `@aiquants/virtualscroll` と同じです: 素のオブジェクトだけを受け付け自身のプロパティだけを読む、未知キーは
23
+ `RangeError`、値は空白以外を含む文字列、`undefined` はカタログ値のまま、結果は凍結。
24
+ - **`DateSelector variant="dropdown"` のポップアップに埋め込まれた VirtualScroll へ `locale` とエンジン 7 キーを転送します**。
25
+ 0.13 まで翻訳できなかったスクロールバー矢印の名前 (`Scroll up` / `Scroll down`) が、`locale="ja"` で
26
+ `上へスクロール` / `下へスクロール` になり、`labels.scrollUp` / `labels.scrollDown` で上書きできます。エンジンの文言は
27
+ `VIRTUAL_SCROLL_LABEL_CATALOGS` をそのまま再利用し、本パッケージでは書き直しません。
28
+ - **公開 API**: `PERIOD_SLIDER_LABEL_KEYS`・`PERIOD_SLIDER_LABEL_CATALOGS`・`resolvePeriodSliderLabels(locale, overrides)`、
29
+ 型 `PeriodSliderLocale` (`VirtualScrollLocale` と同一)・`PeriodSliderLabels`・`PeriodSliderLabelOverrides`。
30
+ - **4 つのフックは `locale` と `labels` を `sliderProps` と全 `SelectorProps` へ配ります** (`formatLocale` / `formatOption` と同じ経路)。
31
+ - **インラインの `labels={{ ... }}` でも文字列が同じ間は再描画しません**。4 部品のメモ比較器は `labels` を自身のキーの
32
+ 値で比較し、解決結果も値で安定化するため、内蔵 VirtualScroll へ渡すラベルの同一性も保たれます。
33
+ - デモに `?lang=en` / `?lang=ja` と言語切替ボタンを加えました (日付の書式は `formatLocale="ja-JP"` のままです)。
34
+
35
+ ### 変更 (破壊的)
36
+
37
+ - **日付書式の BCP 47 タグ `locale?: string` を `formatLocale?: string` へ改名しました** (別名は残していません)。
38
+ 4 部品の Props・4 フックのオプション・`SelectorProps` のすべてが対象です。検証メッセージも新しい名前を名乗ります
39
+ (例: `PeriodSlider: formatLocale must be a valid BCP 47 language tag (received: "")`)。`formatLabel` /
40
+ `formatScreenReaderLabel` / `formatOptionText` の第 4 引数は位置引数のため呼び出しは変わりません (引数名だけが
41
+ `formatLocale` になりました)。
42
+ - **4 部品の `*AriaLabel` Props (延べ 19 個、名前としては 17 種: `selectAriaLabel` は 3 つのセレクタに共通) と
43
+ `AccessibleSliderLabels` 型を撤去し、`labels` へ統合しました**。`formatAriaValueText`
44
+ は `BasePeriodSliderProps` へ移り、そのまま使えます。ノギスのミクロつまみは 0.13 まで `lowerAriaLabel` /
45
+ `upperAriaLabel` / `pointAriaLabel` を range / point モードと共有していましたが、専用のキー (`microRangeStart` /
46
+ `microRangeEnd` / `microSelectedDate`) を読むようになりました。
47
+ - **`@aiquants/virtualscroll` は 3.7.0 以上が必要です** (`locale` / `labels` の受け口)。公開時の peer 範囲は `^3.7.0` へ展開されます。
48
+
49
+ ### 移行
50
+
51
+ > [!WARNING]
52
+ > **0.13 で `locale="ja"` / `locale="en"` を渡していたホストは、型エラーも実行時エラーも出ないまま意味が変わります**。
53
+ > `"ja"` / `"en"` は 0.13 では日付書式の正当な BCP 47 タグでしたが、0.14 では UI 言語の `locale` の受理値そのものです。
54
+ > `formatLocale` へ改名しない限り、日付テキストは黙って ISO 8601 へ戻り (`2024/01` → `2024-01`、`04/15/2025` → `2025-04-15`)、
55
+ > `"ja"` では部品の名前も日本語カタログへ切り替わります (`Previous month` → `前月`)。
56
+ > **0.13 の `locale` は値が何であれ、すべて `formatLocale` へ改名してください**。日本語の名前が欲しい場合に限り、そのあとで `locale="ja"` を加えます。
57
+
58
+ - `locale="ja-JP"` (日付書式) → `formatLocale="ja-JP"`。フックの `{ locale: "ja-JP" }` も `{ formatLocale: "ja-JP" }` へ。
59
+ `"ja"` / `"en"` 以外のタグを旧名のまま渡すと、UI 言語の `locale` として
60
+ `RangeError: [period-slider] locale is the UI language, not a BCP 47 tag (date formatting reads formatLocale): ...`
61
+ になります。`"ja"` / `"en"` は拒否されないため (上の警告)、エラーの有無に関わらず改名が必要です。
62
+ - アクセシブル名の Props → `labels` のキー:
63
+
64
+ | 撤去した Prop | 部品 | `labels` のキー |
65
+ | :--- | :--- | :--- |
66
+ | `lowerAriaLabel` / `upperAriaLabel` | `PeriodSlider` | `rangeStart` / `rangeEnd` (ノギスのミクロ期間形態では `microRangeStart` / `microRangeEnd`) |
67
+ | `pointAriaLabel` | `PeriodSlider` | `selectedDate` (ノギスのミクロ時点形態では `microSelectedDate`) |
68
+ | `macroLowerAriaLabel` / `macroUpperAriaLabel` | `PeriodSlider` | `macroRangeStart` / `macroRangeEnd` |
69
+ | `decreaseAriaLabel` / `increaseAriaLabel` | `PeriodSlider` | `decrease` / `increase` |
70
+ | `prevYearAriaLabel` / `nextYearAriaLabel` / `selectAriaLabel` | `YearSelector` | `previousYear` / `nextYear` / `yearSelect` |
71
+ | `prevMonthAriaLabel` / `nextMonthAriaLabel` / `selectAriaLabel` | `MonthSelector` | `previousMonth` / `nextMonth` / `monthSelect` |
72
+ | `prevDateAriaLabel` / `nextDateAriaLabel` / `selectAriaLabel` | `DateSelector` | `previousDay` / `nextDay` / `dateSelect` |
73
+ | `yearAriaLabel` / `monthAriaLabel` / `dayAriaLabel` | `DateSelector` | `splitYear` / `splitMonth` / `splitDay` |
74
+
75
+ - 日本語名を個別に与えていたホストは、`locale="ja"` でカタログに任せ、カタログと違う名前だけを `labels` に残すのが最小の書き換えです。
76
+ - 撤去した `*AriaLabel` 名を `labels` のキーとして渡すと、未知キーとして `RangeError` になります (黙って無視されません)。
77
+ - 何も渡していなかったホスト (英語名・ISO 表記に依存するテストを含む) は変更不要です。
78
+
79
+ ### 修正
80
+
81
+ - **`usePeriodSliderRange` の `startSelectorProps` / `endSelectorProps` が、書式の変更に追従しないことがありました**。
82
+ メモの依存に `formatLocale` (0.13 の `locale`) と `formatOption` が無く、フックへ渡す値を実行中に変えても
83
+ セレクタだけが初回の値を配り続けていました。4 つの値 (`formatLocale` / `formatOption` / `locale` / `labels`) を依存へ加えました。
84
+ - 本書の 0.13.0 の見出しが `## Unreleased` のまま残っていたため、版番号へ改めました。
85
+
86
+ ## 0.13.0
87
+
88
+ パッケージが所有するテキスト面を、1 つのフォーマッタ契約 (`PeriodOptionFormatter`) へ統一。
89
+
90
+ ### 追加
91
+
92
+ - **`formatOption` を `MonthSelector` / `YearSelector` / `DateSelector` の 3 つが受け取ります**。署名は
93
+ `(date: Date, unit: PeriodSliderUnit, scope: PeriodOptionScope) => string` の 1 つだけで、`unit` と `scope` は
94
+ ウィジェットが与えます。1 つのコールバック値をレールの `formatLabel` と 3 つのセレクタの `formatOption` へ渡せば、
95
+ 同じ画面の中で表記が食い違う余地そのものが無くなります (レールが `2025年度 第1四半期` と描く横で、セレクタが
96
+ `2025-04` と読める状態がこれで終わります)。
97
+ - **渡される `Date` は、その面が表す日付です**。`scope: "part"` は自分より粗い部位だけを保持値から取り、
98
+ 細かい部位は 1 に固定します (年は 1 月 1 日、月は当月 1 日、日は保持中の年月とその日)。保持中の細かい部位を
99
+ 混ぜないのは、混ぜると非グレゴリオ暦で同じ `<select>` の別々の値が同じ文字になるためです (「既知の制約」)。
100
+ Invalid Date が渡ることはありません。
101
+ - **4 つのフックが `formatOption` を受け取り、`locale` とともに `SelectorProps` へ載せます**。フックへ 1 度
102
+ 与えれば、レールと同じフックから配線した全セレクタが同じ表記で描きます。**これは挙動の変更です** — 従来は
103
+ `locale` がレールにしか届かず、`usePeriodSliderRange({ …, locale: "ja-JP" })` はレールに `2024/03`、隣の
104
+ セレクタに `2024-03` を出していました (1 つの画面が自分と食い違う状態)。レールとドロップダウンで敢えて別の
105
+ 文字列を出したい利用側は、セレクタへ `formatOption` を直接渡せばスプレッドの後ろに来るため上書きされます。
106
+ - **優先順位は 3 段のままで、段は増えません**: フォーマッタ Props > `locale` (Intl) > ロケール非依存の ISO 8601。
107
+ `scope: "period"` の面はすべて `formatLabel(unit, date, formatOption, locale)` の 1 本であり、優先順位の記述は
108
+ パッケージ全体で 1 箇所です。
109
+ - **組み込みの表記は、1 年以上の年については変わりません**。`"period"` は `2025` / `2025-04` / `2025-04-15`
110
+ (`ja-JP` では `2025年` / `2025/04` / `2025/04/15`)、`"part"` は `2025` / `04` / `15` (`ja-JP` では
111
+ `2025年` / `04月` / `15日`) です。0 年以下だけは下の「利用側の契約が変わる点」のとおり変わります。
112
+ - **`variant="date"` は履行できないため 1 度も呼びません** (表示はブラウザが所有します)。Props を渡すこと自体は
113
+ 合法で、`locale` と同じ扱いです。
114
+ - **戻り値はどの面でも機械可読値へ届きません**。`aria-label`・`<option value>`・`data-value`・
115
+ `variant="date"` の `input.value`・`onChange` が運ぶ値は、いずれもフォーマッタを通りません。
116
+ - **空文字列は合法な戻り値です** (無効日付に対して `formatLabel` が返す仕様上の値と同じであるため)。
117
+ - **`formatOptionText(date, unit, scope, locale?)` を公開します**。組み込みの段そのものであり、一部の
118
+ `(unit, scope)` だけを担当する利用側が残りをそのまま転送するための委譲先です (「`undefined` を返したら既定」という
119
+ 代替値連鎖を書かずに済みます)。宣言外の `unit` / `scope` は自分の名前を含む `RangeError`、Invalid Date は
120
+ 空文字列 (`formatLabel` と同じ約束) です。
121
+ - **型 `PeriodOptionFormatter` と `PeriodOptionScope` (`"period" | "part"`) を公開します**。`"period"` は 1 つの操作要素の
122
+ 値そのもの (月の選択肢・年の選択肢・日の行と、それらの畳んだ表示)、`"part"` は `variant="split-dropdown"` が
123
+ 3 つ並べる部位の 1 つです。
124
+ - **戻り値は読み上げ値にも届くため、読み上げ可能な文字列にしてください**。行き先は選択肢・プレースホルダ・
125
+ 畳んだ表示 (`variant="dropdown"` のコンボボックスでは、入力欄の可視テキストである `value` そのもの) に加え、
126
+ レールのつまみラベル・ホバーツールチップ・`aria-valuetext` です。`formatAriaValueText` を渡していないとき、
127
+ 読み上げ値は `formatLabel` / `formatMacroLabel` / `formatMicroLabel` の戻り値そのものになります
128
+ (`formatScreenReaderLabel` が `formatLabel` へ委譲するため)。記号だけで組んだ装飾は、画面では読めても
129
+ 読み上げでは読めません。
130
+ - **渡される `Date` が確定値でない面は、レールのホバーツールチップだけです** (ポインタ直下の日付が渡ります)。
131
+ セレクタの選択肢・プレースホルダ・畳んだ表示と、レールのつまみラベル・読み上げ値は、いずれも確定値です。
132
+ - **スライダーのフォーマッタ Props 4 つと公開ヘルパー 2 つが、同じ型へ広がりました** (`formatLabel` /
133
+ `formatMacroLabel` / `formatMicroLabel` / `formatAriaValueText`、`formatLabel` / `formatScreenReaderLabel`)。
134
+ `tsc --strict` での実測どおり、引数を減らした `(d: Date) => string` と `(d, u) => string` は引き続き代入可能で、
135
+ 逆向き (3 引数の関数を 1 引数のスロットへ) は `TS2322` (`Target signature provides too few arguments`) です。
136
+ **ただし「余分な引数が省略可能なら通る」という 0.12.0 の感覚は、そのままでは通用しません**。省略可能な第 2 /
137
+ 第 3 引数を持つコールバックは、その型によって代入できなくなるか、型エラーなしで受け取る値が変わります。
138
+ どちらも「利用側の契約が変わる点」に書き下しました。`formatQuarterLabel` は `(Date, number) => string` であり
139
+ `formatOption` の形ではないため、`formatOption={formatQuarterLabel}` はコンパイラが拒否します
140
+ (最も起こりやすい取り違えです)。
141
+ - これで 0.12.0 の「既知の制約」が解けます。四半期は ECMA-402 に無く `Intl` が黙って捨てるため `locale` の段を
142
+ 持ちません。`formatOption` がその経路です。
143
+
144
+ ### 利用側の契約が変わる点 (0.12.0 からの移行)
145
+
146
+ - **0 年以下の年の ISO 表記が変わります (`"00-1"` → `"-000001"`)。** 公開関数 `formatLabel` /
147
+ `formatScreenReaderLabel` / `formatOptionText` の戻り値、つまみラベル、`aria-valuetext`、3 セレクタの選択肢
148
+ テキスト、`MonthSelector` の `<option value>` と `input[type="month"]` の値がこの範囲で変わります。
149
+ 1 年以上の年は 1 文字も変わりません。
150
+ 理由: 年の 0 埋め規則がパッケージ内に 3 通りあり、2 つが誤っていました。同じ 1 日について `data-value` が
151
+ `-000001-01-02` (`formatIsoDay`、以前から正しい) である一方、表示テキストは `00-1-01-02` で、1 つのウィジェットが
152
+ 同じ日付に 2 つの ISO 表記を持っていました。ISO 8601 は 0 年以下に 4 桁形式を持たず、符号を 4 桁へ押し込んだ
153
+ `00-1` はどの規格にも属しません。規則を `formatIsoYear` 1 つへ寄せ、機械可読値側の正しい形へ揃えました。
154
+ 0.12.0 で `"00-1-Q1"` を固定していたテストは `"-000001-Q1"` へ改めています。
155
+
156
+ - **`DateSelector` の `formatYearOption` / `formatMonthOption` / `formatDayOption` を削除しました**。別名も二重経路も
157
+ 残していません。1 つの概念に 4 つの形があった状態 (レールの `(date) => string`、部位別の 3 つ、そして
158
+ `MonthSelector` / `YearSelector` には何も無い) を、`formatOption` 1 つへ畳んだためです。
159
+ - 移行はそのまま 1 行で書けます: `formatMonthOption={(m) => g(m)}` →
160
+ `formatOption={(date, unit, scope) => (scope === "part" && unit === "month" ? g(date.getMonth() + 1) : formatOptionText(date, unit, scope, locale))}`。
161
+ 担当しない組は `formatOptionText` へ転送してください。
162
+ - **旧 Props は数値 1 つしか受け取らなかったため、年度も四半期も表現できませんでした**。`formatYearOption(2019)` からは
163
+ その 4 月がどの年度に属するのかを知る術が無く、`formatMonthOption(4)` は年を知りません。新しいコールバックは
164
+ その選択肢が確定する日付そのものを受け取るため、どちらも導けます。
165
+ - `MonthSelector` と `YearSelector` は元々選択肢のフォーマッタを 1 つも持たず、`locale` しか無かったため、
166
+ こちらは追加のみで移行はありません。
167
+ - **余分な省略可能引数を持つコールバックは、フォーマッタ Props へ渡せなくなる場合があります**。4 つのフォーマッタ
168
+ Props と公開ヘルパー 2 つが 3 引数の `PeriodOptionFormatter` へ広がったため、第 2 引数が省略可能でありながら
169
+ `PeriodSliderUnit` (`"year" | "month" | "day"`) を受けられない型のコールバック (第 3 引数なら `PeriodOptionScope`)
170
+ は代入できません。0.12.0 の `formatLabel?: (date: Date) => string` は、余分な引数が省略可能でありさえすれば
171
+ そのまま受理していたため、**実在する破壊的変更です** (`Array.prototype.map` が誘う
172
+ `(date, index?: number) => string` や、既定値を付けた引数を足した形がこれに当たります)。
173
+ - 実測 (`tsc --strict` / TypeScript 5.9.3)。`const padded = (d: Date, pad = 4): string => …` を `formatLabel` へ
174
+ 渡すと `TS2322: Type '(d: Date, pad?: number) => string' is not assignable to type 'PeriodOptionFormatter'.` に
175
+ 続けて `Types of parameters 'pad' and 'unit' are incompatible. Type 'PeriodSliderUnit' is not assignable to type
176
+ 'number | undefined'.` が出ます。第 3 引数でも同じで、`(d, u: PeriodSliderUnit, pad?: number) => string` は
177
+ `scope` と衝突します。
178
+ - **その場に書いた無名関数では、診断が Props の名前を 1 度も出しません**。
179
+ `formatLabel={(d, verbose = false) => …}` の診断は `TS2322: Type 'false' is not assignable to type
180
+ 'PeriodSliderUnit'` であり、Props ではなく既定値そのものを指します。
181
+ - **移行**: 第 2 / 第 3 引数の型を `unit` / `scope` を受けられる形まで広げるか、1 引数のラッパーで包んでください
182
+ (`formatLabel={(d) => padded(d)}`)。
183
+ - **型エラーにならない側にも一度目を通してください**。余分な引数が `string` / `unknown` / `any` / 可変長のときは
184
+ 0.12.0 でも本リリースでも型エラーになりませんが、0.12.0 が `customFormat(d)` と 1 引数で呼んでいたのに対し
185
+ 本リリースは `customFormat(d, unit, "period")` と呼ぶため、既定値ではなく `unit` と `scope` が入ります
186
+ (`const withMode = (d: Date, mode = "long") => …` の `mode` は `"long"` から `"year"` へ変わり、`tsc` は緑のまま
187
+ 表示テキストだけが変わります)。
188
+ - **分割セレクト (`variant="split-dropdown"`) の日の `<option>` が、発行できない組で `disabled` になります**。年と月の
189
+ 選択肢は以前から `disabled` でしたが、日だけが抜けており、押しても `onChange` が発行されない選択肢が押せる
190
+ 見た目のまま並んでいました。判定は年・月と同じ `isSplitChoiceEmittable` (保持中の年月との組が境界の外、または
191
+ `allowedDates` に無い) です。**`option:disabled` を読むホストの CSS は、以前は当たらなかった要素に当たるように
192
+ なります**。選択肢は一覧に残り、`option` の `value` と発行される日付は変わりません。
193
+ - **`YearSelector` が新しい DOM を持ちます**。保持している年が境界の外にあるとき、ルートが
194
+ `data-out-of-range="true"` を持ち、一覧へ押し込まれるその年の `<option>` が `disabled` になります
195
+ (`MonthSelector` と `DateSelector` が以前から行っていたことに揃えました)。**`[data-out-of-range]` や `:disabled` を
196
+ 読むホストの CSS は、以前は当たらなかった要素に当たるようになります**。選択肢は一覧に残り、`select.value` が
197
+ 実年を持つ挙動は変わりません。境界外の年は以前から発行できず `RangeError` だったため、`disabled` は
198
+ 「押せる」と「発行できる」を揃えるだけです。
199
+
200
+ ### 修正
201
+
202
+ - **分割セレクト (`variant="split-dropdown"`) の各 `<select>` の選択肢テキストは、その `<select>` の値だけから
203
+ 決まります** (年は 1 月 1 日、月は当月 1 日、日は保持中の年月とその日)。保持中の他部位を基準日へ混ぜません。
204
+ 一度は「その選択肢が確定する日付」を基準日にしましたが、**撤回しました**。選択肢テキストは同じ `<select>` の
205
+ 中で相互に区別できること (単射であること) が先であり、非グレゴリオ暦では保持日を混ぜた瞬間に別々の値が
206
+ 同じ文字になるためです。実測 (`fa-IR`・ICU 既定暦は `persian`・2018-01-01〜2022-12-31・保持 2020-03-20):
207
+ 1 月 1 日基準なら年の選択肢は `۱۴۰۰ ۱۳۹۹ ۱۳۹۸ ۱۳۹۷ ۱۳۹۶` と全て異なりますが、確定日基準では
208
+ `۱۴۰۰ ۱۳۹۹ ۱۳۹۹ ۱۳۹۷ ۱۳۹۶` となり 2020 年と 2021 年が同じ文字になります (月も 1 つ消えて 1 つ重複)。
209
+ **既知の制約**: グレゴリオ暦の年・月を、境界の異なる暦 (和暦・ペルシア暦など) で描く以上、
210
+ 「その選択肢が確定する日付の呼び名」と「選択肢どうしが区別できること」は同時には満たせません。本パッケージは
211
+ 後者を採ります。`ja-JP-u-ca-japanese` では 2019 年の選択肢は常に **平成31年** (1 月 1 日の元号) であり、
212
+ 5 月を保持したまま押すと確定するのは令和元年の日付です。区別が要らず確定日の呼び名が要る利用側は
213
+ `formatOption` で自分の基準日を選んでください (日の部位には保持中の年月が渡るため、そこから組めます)。
214
+ - **履行できない面と、描かない文字列のためにフォーマッタを呼びません**。`DateSelector` の畳んだ表示は
215
+ `variant="dropdown"` のとき、`MonthSelector` のプレースホルダは `variant="dropdown"` かつ保持月が候補外のときだけ
216
+ 組み立てます。以前はどちらも毎描画で組み立てては捨てており、利用側のコールバックが入ると「誰も読まない文字列の
217
+ ための呼び出し」になっていました。
218
+ - **`DateSelector` が `Date` でない日付 Props を、形の段階で拒否します**。`value` / `initialDate` / `minDate` /
219
+ `maxDate` は以前 `Number.isNaN(date.getTime())` しか見ていなかったため、型検査を受けない JavaScript の利用側が
220
+ 文字列を渡すと `date.getTime is not a function` という `TypeError` がコンポーネントの内側から飛び、どの Props が
221
+ 原因かを名乗りませんでした。`instanceof Date` を先に見るようにしたため、いまは prop 名を含む `RangeError`
222
+ (`DateSelector: "minDate" must be a valid Date (received 2025-01-01)`) になります (`YearSelector` が以前から
223
+ 行っていたことに揃えました)。TypeScript の利用側は同じ値を型検査が先に弾くため、到達しません。
224
+ - **`YearSelector` の選択肢ラベルが memo の中で組まれます**。以前は JSX の中で組んでいたため、描画のたびに年の数だけ
225
+ 書式化していました (`MonthSelector` は以前から memo の中です)。出力は変わりません。
226
+ - **分割セレクトの選択肢ラベルと `allowedKey` も memo の中で組みます (性能だけの変更で、契約は変わりません)**。年・月・
227
+ 日のラベルは JSX の中ではなく 3 つの `useMemo` の中で (`useCallback` で安定化した 1 つの組み立て関数を通して) 組み、
228
+ `allowedKey` は `allowedDates` の同一性で memo 化しました (以前は描画のたびに候補数に比例する文字列連結を
229
+ コンポーネント本体で行っていました)。描かれるテキストも DOM も変わりません (変わるのは再描画あたりの書式化回数
230
+ だけであり、挙動の変化を探す必要はありません)。
231
+ - **先頭一致入力の契約を書き下しました**。`resolveTypeAheadIndex` は表示書式を一切参照せず (`labelAt` を読みません)、
232
+ 先発グレゴリオ暦の `yyyy[MM[dd]]` の数字だけで解決します。利用側フォーマッタが何を描いても、打鍵と行の対応は
233
+ 動きません。以前の注記は「区切りを落とせば同じ数字になるから」と説明していましたが、これは現行の表示では既に
234
+ 成り立っていませんでした。
235
+ - **内部: `DateOptionDomain.valueAt` を削除しました**。`src/index.ts` はこのモジュールから何も再輸出せず、
236
+ `exports` マップが深いパスを封じているため、公開面の変更ではありません (`src/` に呼び出し元は 1 つもありませんでした)。
237
+ 「選択肢の機械可読値」の第 2 の定義が、表示テキストの新しい引数の隣に残る状態を避けたものです。
238
+
239
+ ## 0.12.0
9
240
 
10
241
  1 月以外の月から始まる年 (年度) と、その上の四半期。
11
242