@aiquants/period-slider 0.11.1 → 0.13.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
@@ -7,6 +7,207 @@ All notable changes to `@aiquants/period-slider` are documented here.
7
7
 
8
8
  ## Unreleased
9
9
 
10
+ パッケージが所有するテキスト面を、1 つのフォーマッタ契約 (`PeriodOptionFormatter`) へ統一。
11
+
12
+ ### 追加
13
+
14
+ - **`formatOption` を `MonthSelector` / `YearSelector` / `DateSelector` の 3 つが受け取ります**。署名は
15
+ `(date: Date, unit: PeriodSliderUnit, scope: PeriodOptionScope) => string` の 1 つだけで、`unit` と `scope` は
16
+ ウィジェットが与えます。1 つのコールバック値をレールの `formatLabel` と 3 つのセレクタの `formatOption` へ渡せば、
17
+ 同じ画面の中で表記が食い違う余地そのものが無くなります (レールが `2025年度 第1四半期` と描く横で、セレクタが
18
+ `2025-04` と読める状態がこれで終わります)。
19
+ - **渡される `Date` は、その面が表す日付です**。`scope: "part"` は自分より粗い部位だけを保持値から取り、
20
+ 細かい部位は 1 に固定します (年は 1 月 1 日、月は当月 1 日、日は保持中の年月とその日)。保持中の細かい部位を
21
+ 混ぜないのは、混ぜると非グレゴリオ暦で同じ `<select>` の別々の値が同じ文字になるためです (「既知の制約」)。
22
+ Invalid Date が渡ることはありません。
23
+ - **4 つのフックが `formatOption` を受け取り、`locale` とともに `SelectorProps` へ載せます**。フックへ 1 度
24
+ 与えれば、レールと同じフックから配線した全セレクタが同じ表記で描きます。**これは挙動の変更です** — 従来は
25
+ `locale` がレールにしか届かず、`usePeriodSliderRange({ …, locale: "ja-JP" })` はレールに `2024/03`、隣の
26
+ セレクタに `2024-03` を出していました (1 つの画面が自分と食い違う状態)。レールとドロップダウンで敢えて別の
27
+ 文字列を出したい利用側は、セレクタへ `formatOption` を直接渡せばスプレッドの後ろに来るため上書きされます。
28
+ - **優先順位は 3 段のままで、段は増えません**: フォーマッタ Props > `locale` (Intl) > ロケール非依存の ISO 8601。
29
+ `scope: "period"` の面はすべて `formatLabel(unit, date, formatOption, locale)` の 1 本であり、優先順位の記述は
30
+ パッケージ全体で 1 箇所です。
31
+ - **組み込みの表記は、1 年以上の年については変わりません**。`"period"` は `2025` / `2025-04` / `2025-04-15`
32
+ (`ja-JP` では `2025年` / `2025/04` / `2025/04/15`)、`"part"` は `2025` / `04` / `15` (`ja-JP` では
33
+ `2025年` / `04月` / `15日`) です。0 年以下だけは下の「利用側の契約が変わる点」のとおり変わります。
34
+ - **`variant="date"` は履行できないため 1 度も呼びません** (表示はブラウザが所有します)。Props を渡すこと自体は
35
+ 合法で、`locale` と同じ扱いです。
36
+ - **戻り値はどの面でも機械可読値へ届きません**。`aria-label`・`<option value>`・`data-value`・
37
+ `variant="date"` の `input.value`・`onChange` が運ぶ値は、いずれもフォーマッタを通りません。
38
+ - **空文字列は合法な戻り値です** (無効日付に対して `formatLabel` が返す仕様上の値と同じであるため)。
39
+ - **`formatOptionText(date, unit, scope, locale?)` を公開します**。組み込みの段そのものであり、一部の
40
+ `(unit, scope)` だけを担当する利用側が残りをそのまま転送するための委譲先です (「`undefined` を返したら既定」という
41
+ 代替値連鎖を書かずに済みます)。宣言外の `unit` / `scope` は自分の名前を含む `RangeError`、Invalid Date は
42
+ 空文字列 (`formatLabel` と同じ約束) です。
43
+ - **型 `PeriodOptionFormatter` と `PeriodOptionScope` (`"period" | "part"`) を公開します**。`"period"` は 1 つの操作要素の
44
+ 値そのもの (月の選択肢・年の選択肢・日の行と、それらの畳んだ表示)、`"part"` は `variant="split-dropdown"` が
45
+ 3 つ並べる部位の 1 つです。
46
+ - **戻り値は読み上げ値にも届くため、読み上げ可能な文字列にしてください**。行き先は選択肢・プレースホルダ・
47
+ 畳んだ表示 (`variant="dropdown"` のコンボボックスでは、入力欄の可視テキストである `value` そのもの) に加え、
48
+ レールのつまみラベル・ホバーツールチップ・`aria-valuetext` です。`formatAriaValueText` を渡していないとき、
49
+ 読み上げ値は `formatLabel` / `formatMacroLabel` / `formatMicroLabel` の戻り値そのものになります
50
+ (`formatScreenReaderLabel` が `formatLabel` へ委譲するため)。記号だけで組んだ装飾は、画面では読めても
51
+ 読み上げでは読めません。
52
+ - **渡される `Date` が確定値でない面は、レールのホバーツールチップだけです** (ポインタ直下の日付が渡ります)。
53
+ セレクタの選択肢・プレースホルダ・畳んだ表示と、レールのつまみラベル・読み上げ値は、いずれも確定値です。
54
+ - **スライダーのフォーマッタ Props 4 つと公開ヘルパー 2 つが、同じ型へ広がりました** (`formatLabel` /
55
+ `formatMacroLabel` / `formatMicroLabel` / `formatAriaValueText`、`formatLabel` / `formatScreenReaderLabel`)。
56
+ `tsc --strict` での実測どおり、引数を減らした `(d: Date) => string` と `(d, u) => string` は引き続き代入可能で、
57
+ 逆向き (3 引数の関数を 1 引数のスロットへ) は `TS2322` (`Target signature provides too few arguments`) です。
58
+ **ただし「余分な引数が省略可能なら通る」という 0.12.0 の感覚は、そのままでは通用しません**。省略可能な第 2 /
59
+ 第 3 引数を持つコールバックは、その型によって代入できなくなるか、型エラーなしで受け取る値が変わります。
60
+ どちらも「利用側の契約が変わる点」に書き下しました。`formatQuarterLabel` は `(Date, number) => string` であり
61
+ `formatOption` の形ではないため、`formatOption={formatQuarterLabel}` はコンパイラが拒否します
62
+ (最も起こりやすい取り違えです)。
63
+ - これで 0.12.0 の「既知の制約」が解けます。四半期は ECMA-402 に無く `Intl` が黙って捨てるため `locale` の段を
64
+ 持ちません。`formatOption` がその経路です。
65
+
66
+ ### 利用側の契約が変わる点 (0.12.0 からの移行)
67
+
68
+ - **0 年以下の年の ISO 表記が変わります (`"00-1"` → `"-000001"`)。** 公開関数 `formatLabel` /
69
+ `formatScreenReaderLabel` / `formatOptionText` の戻り値、つまみラベル、`aria-valuetext`、3 セレクタの選択肢
70
+ テキスト、`MonthSelector` の `<option value>` と `input[type="month"]` の値がこの範囲で変わります。
71
+ 1 年以上の年は 1 文字も変わりません。
72
+ 理由: 年の 0 埋め規則がパッケージ内に 3 通りあり、2 つが誤っていました。同じ 1 日について `data-value` が
73
+ `-000001-01-02` (`formatIsoDay`、以前から正しい) である一方、表示テキストは `00-1-01-02` で、1 つのウィジェットが
74
+ 同じ日付に 2 つの ISO 表記を持っていました。ISO 8601 は 0 年以下に 4 桁形式を持たず、符号を 4 桁へ押し込んだ
75
+ `00-1` はどの規格にも属しません。規則を `formatIsoYear` 1 つへ寄せ、機械可読値側の正しい形へ揃えました。
76
+ 0.12.0 で `"00-1-Q1"` を固定していたテストは `"-000001-Q1"` へ改めています。
77
+
78
+ - **`DateSelector` の `formatYearOption` / `formatMonthOption` / `formatDayOption` を削除しました**。別名も二重経路も
79
+ 残していません。1 つの概念に 4 つの形があった状態 (レールの `(date) => string`、部位別の 3 つ、そして
80
+ `MonthSelector` / `YearSelector` には何も無い) を、`formatOption` 1 つへ畳んだためです。
81
+ - 移行はそのまま 1 行で書けます: `formatMonthOption={(m) => g(m)}` →
82
+ `formatOption={(date, unit, scope) => (scope === "part" && unit === "month" ? g(date.getMonth() + 1) : formatOptionText(date, unit, scope, locale))}`。
83
+ 担当しない組は `formatOptionText` へ転送してください。
84
+ - **旧 Props は数値 1 つしか受け取らなかったため、年度も四半期も表現できませんでした**。`formatYearOption(2019)` からは
85
+ その 4 月がどの年度に属するのかを知る術が無く、`formatMonthOption(4)` は年を知りません。新しいコールバックは
86
+ その選択肢が確定する日付そのものを受け取るため、どちらも導けます。
87
+ - `MonthSelector` と `YearSelector` は元々選択肢のフォーマッタを 1 つも持たず、`locale` しか無かったため、
88
+ こちらは追加のみで移行はありません。
89
+ - **余分な省略可能引数を持つコールバックは、フォーマッタ Props へ渡せなくなる場合があります**。4 つのフォーマッタ
90
+ Props と公開ヘルパー 2 つが 3 引数の `PeriodOptionFormatter` へ広がったため、第 2 引数が省略可能でありながら
91
+ `PeriodSliderUnit` (`"year" | "month" | "day"`) を受けられない型のコールバック (第 3 引数なら `PeriodOptionScope`)
92
+ は代入できません。0.12.0 の `formatLabel?: (date: Date) => string` は、余分な引数が省略可能でありさえすれば
93
+ そのまま受理していたため、**実在する破壊的変更です** (`Array.prototype.map` が誘う
94
+ `(date, index?: number) => string` や、既定値を付けた引数を足した形がこれに当たります)。
95
+ - 実測 (`tsc --strict` / TypeScript 5.9.3)。`const padded = (d: Date, pad = 4): string => …` を `formatLabel` へ
96
+ 渡すと `TS2322: Type '(d: Date, pad?: number) => string' is not assignable to type 'PeriodOptionFormatter'.` に
97
+ 続けて `Types of parameters 'pad' and 'unit' are incompatible. Type 'PeriodSliderUnit' is not assignable to type
98
+ 'number | undefined'.` が出ます。第 3 引数でも同じで、`(d, u: PeriodSliderUnit, pad?: number) => string` は
99
+ `scope` と衝突します。
100
+ - **その場に書いた無名関数では、診断が Props の名前を 1 度も出しません**。
101
+ `formatLabel={(d, verbose = false) => …}` の診断は `TS2322: Type 'false' is not assignable to type
102
+ 'PeriodSliderUnit'` であり、Props ではなく既定値そのものを指します。
103
+ - **移行**: 第 2 / 第 3 引数の型を `unit` / `scope` を受けられる形まで広げるか、1 引数のラッパーで包んでください
104
+ (`formatLabel={(d) => padded(d)}`)。
105
+ - **型エラーにならない側にも一度目を通してください**。余分な引数が `string` / `unknown` / `any` / 可変長のときは
106
+ 0.12.0 でも本リリースでも型エラーになりませんが、0.12.0 が `customFormat(d)` と 1 引数で呼んでいたのに対し
107
+ 本リリースは `customFormat(d, unit, "period")` と呼ぶため、既定値ではなく `unit` と `scope` が入ります
108
+ (`const withMode = (d: Date, mode = "long") => …` の `mode` は `"long"` から `"year"` へ変わり、`tsc` は緑のまま
109
+ 表示テキストだけが変わります)。
110
+ - **分割セレクト (`variant="split-dropdown"`) の日の `<option>` が、発行できない組で `disabled` になります**。年と月の
111
+ 選択肢は以前から `disabled` でしたが、日だけが抜けており、押しても `onChange` が発行されない選択肢が押せる
112
+ 見た目のまま並んでいました。判定は年・月と同じ `isSplitChoiceEmittable` (保持中の年月との組が境界の外、または
113
+ `allowedDates` に無い) です。**`option:disabled` を読むホストの CSS は、以前は当たらなかった要素に当たるように
114
+ なります**。選択肢は一覧に残り、`option` の `value` と発行される日付は変わりません。
115
+ - **`YearSelector` が新しい DOM を持ちます**。保持している年が境界の外にあるとき、ルートが
116
+ `data-out-of-range="true"` を持ち、一覧へ押し込まれるその年の `<option>` が `disabled` になります
117
+ (`MonthSelector` と `DateSelector` が以前から行っていたことに揃えました)。**`[data-out-of-range]` や `:disabled` を
118
+ 読むホストの CSS は、以前は当たらなかった要素に当たるようになります**。選択肢は一覧に残り、`select.value` が
119
+ 実年を持つ挙動は変わりません。境界外の年は以前から発行できず `RangeError` だったため、`disabled` は
120
+ 「押せる」と「発行できる」を揃えるだけです。
121
+
122
+ ### 修正
123
+
124
+ - **分割セレクト (`variant="split-dropdown"`) の各 `<select>` の選択肢テキストは、その `<select>` の値だけから
125
+ 決まります** (年は 1 月 1 日、月は当月 1 日、日は保持中の年月とその日)。保持中の他部位を基準日へ混ぜません。
126
+ 一度は「その選択肢が確定する日付」を基準日にしましたが、**撤回しました**。選択肢テキストは同じ `<select>` の
127
+ 中で相互に区別できること (単射であること) が先であり、非グレゴリオ暦では保持日を混ぜた瞬間に別々の値が
128
+ 同じ文字になるためです。実測 (`fa-IR`・ICU 既定暦は `persian`・2018-01-01〜2022-12-31・保持 2020-03-20):
129
+ 1 月 1 日基準なら年の選択肢は `۱۴۰۰ ۱۳۹۹ ۱۳۹۸ ۱۳۹۷ ۱۳۹۶` と全て異なりますが、確定日基準では
130
+ `۱۴۰۰ ۱۳۹۹ ۱۳۹۹ ۱۳۹۷ ۱۳۹۶` となり 2020 年と 2021 年が同じ文字になります (月も 1 つ消えて 1 つ重複)。
131
+ **既知の制約**: グレゴリオ暦の年・月を、境界の異なる暦 (和暦・ペルシア暦など) で描く以上、
132
+ 「その選択肢が確定する日付の呼び名」と「選択肢どうしが区別できること」は同時には満たせません。本パッケージは
133
+ 後者を採ります。`ja-JP-u-ca-japanese` では 2019 年の選択肢は常に **平成31年** (1 月 1 日の元号) であり、
134
+ 5 月を保持したまま押すと確定するのは令和元年の日付です。区別が要らず確定日の呼び名が要る利用側は
135
+ `formatOption` で自分の基準日を選んでください (日の部位には保持中の年月が渡るため、そこから組めます)。
136
+ - **履行できない面と、描かない文字列のためにフォーマッタを呼びません**。`DateSelector` の畳んだ表示は
137
+ `variant="dropdown"` のとき、`MonthSelector` のプレースホルダは `variant="dropdown"` かつ保持月が候補外のときだけ
138
+ 組み立てます。以前はどちらも毎描画で組み立てては捨てており、利用側のコールバックが入ると「誰も読まない文字列の
139
+ ための呼び出し」になっていました。
140
+ - **`DateSelector` が `Date` でない日付 Props を、形の段階で拒否します**。`value` / `initialDate` / `minDate` /
141
+ `maxDate` は以前 `Number.isNaN(date.getTime())` しか見ていなかったため、型検査を受けない JavaScript の利用側が
142
+ 文字列を渡すと `date.getTime is not a function` という `TypeError` がコンポーネントの内側から飛び、どの Props が
143
+ 原因かを名乗りませんでした。`instanceof Date` を先に見るようにしたため、いまは prop 名を含む `RangeError`
144
+ (`DateSelector: "minDate" must be a valid Date (received 2025-01-01)`) になります (`YearSelector` が以前から
145
+ 行っていたことに揃えました)。TypeScript の利用側は同じ値を型検査が先に弾くため、到達しません。
146
+ - **`YearSelector` の選択肢ラベルが memo の中で組まれます**。以前は JSX の中で組んでいたため、描画のたびに年の数だけ
147
+ 書式化していました (`MonthSelector` は以前から memo の中です)。出力は変わりません。
148
+ - **分割セレクトの選択肢ラベルと `allowedKey` も memo の中で組みます (性能だけの変更で、契約は変わりません)**。年・月・
149
+ 日のラベルは JSX の中ではなく 3 つの `useMemo` の中で (`useCallback` で安定化した 1 つの組み立て関数を通して) 組み、
150
+ `allowedKey` は `allowedDates` の同一性で memo 化しました (以前は描画のたびに候補数に比例する文字列連結を
151
+ コンポーネント本体で行っていました)。描かれるテキストも DOM も変わりません (変わるのは再描画あたりの書式化回数
152
+ だけであり、挙動の変化を探す必要はありません)。
153
+ - **先頭一致入力の契約を書き下しました**。`resolveTypeAheadIndex` は表示書式を一切参照せず (`labelAt` を読みません)、
154
+ 先発グレゴリオ暦の `yyyy[MM[dd]]` の数字だけで解決します。利用側フォーマッタが何を描いても、打鍵と行の対応は
155
+ 動きません。以前の注記は「区切りを落とせば同じ数字になるから」と説明していましたが、これは現行の表示では既に
156
+ 成り立っていませんでした。
157
+ - **内部: `DateOptionDomain.valueAt` を削除しました**。`src/index.ts` はこのモジュールから何も再輸出せず、
158
+ `exports` マップが深いパスを封じているため、公開面の変更ではありません (`src/` に呼び出し元は 1 つもありませんでした)。
159
+ 「選択肢の機械可読値」の第 2 の定義が、表示テキストの新しい引数の隣に残る状態を避けたものです。
160
+
161
+ ## 0.12.0
162
+
163
+ 1 月以外の月から始まる年 (年度) と、その上の四半期。
164
+
165
+ ### 追加
166
+
167
+ - **`yearStartMonth` (0 始まりの暦月、既定 `0`) で、`unit: "year"` の 1 年が始まる月を選べます**。`PeriodSlider`
168
+ (`BasePeriodSliderProps`)、`YearSelector`、フックが返す `SelectorProps`、4 つのフックのオプション、
169
+ `ConnectDragValueOptions` が受け取ります。4 月開始を指定すると、年つまみが名乗る位置・離散候補の正規化・
170
+ `YearSelector` の選択肢・ステッパーの 1 歩が、すべて 4 月から翌年 3 月までの周期の上に乗ります。年軸を持つのは
171
+ `YearSelector` だけで、`MonthSelector` / `DateSelector` は年の開始月を読みません。
172
+ - **年はその先頭月が属する暦年で名付けます** (4 月開始では 2025-04-01 〜 2026-03-31 が 2025 年)。これがパッケージ内で
173
+ 唯一の年の定義であり、`normalizeDateByUnit` / `encode` / `decode` / `resolveQuarter` / `YearSelector` が同じ採番を使います。
174
+ 米国式に終了年で呼ぶ慣行 (10 月開始の 2025-10 〜 2026-09 を FY2026 と呼ぶ形) は、利用側で 1 を足してください。
175
+ - **公開純関数 8 つが末尾の引数に `yearStartMonth = 0` を受けます**: `normalizeDateByUnit`・`encode`・`decode`・
176
+ `getMacroWindowStartDate`・`getMacroWindowEndDate`・`resolveMacroWindow`・`findNearestDateIndex`・`getSortedAllowedDates`。
177
+ 既定値があるため、既存の呼び出しは 1 つも変わりません。`addUnit` は**受け取りません** (ずらした年も厳密に 12 か月であり、
178
+ 読まない引数を足せばシグネチャが嘘になるため)。
179
+ - **未指定は仕様上の既定 (暦年) であり、指定された値だけを検証します**。`12`・`-1`・`1.5`・`NaN`・`Infinity`・`"3"`・
180
+ `null` は `RangeError` です (`null` は既定へ落ちません)。検証は各公開 API が**自分の名前で**、早期 return より前に行います。
181
+ - **移行の注意 — `allowedDates` / `macroAllowedDates` / `microAllowedDates` の各要素は「その日を含む年」として読まれます**。
182
+ 年レールで暦年の 1 月 1 日を並べた候補集合 (`[2016-01-01, 2018-01-01, …]`) を 4 月開始のレールへそのまま渡すと、
183
+ 各要素は 1 つ手前の年 (2015 年・2017 年) の先頭へ正規化され、候補が黙って 1 年ずれます。非暦年を指定するときは、
184
+ 候補もその年の先頭日 (`2016-04-01` など) で書いてください。
185
+ - **四半期の座標と表記を公開します**: `resolveQuarter(d, yearStartMonth): PeriodQuarter`、
186
+ `formatQuarterLabel(d, yearStartMonth): string` (`"2025-Q1"` 形式)、型 `PeriodQuarter`
187
+ (`{ year: number; quarter: 1 | 2 | 3 | 4; startDate: Date }`)。**新しい Props はありません**。四半期はフォーマッタ Props
188
+ (`formatLabel` / `formatMacroLabel` / `formatMicroLabel`) を通してラベルに現れます。
189
+ - **`yearStartMonth` は両関数で必須です** (既定値を持ちません)。既存の公開純関数 8 つが `= 0` を持つのは、以前からある
190
+ 呼び出し側の挙動を変えられないためです。新設の記号にその義務は無く、非暦年を扱うためのリリースで省略を許せば、
191
+ 最も起こりやすい誤り (暦四半期) が既定になります。**周辺の面に対する意図的な逸脱であり、そう明記します。**
192
+ - **関数自身の引数であり、スライダーの同名 Props を読みません**。年度レール上の暦四半期も、暦年レール上の年度四半期も
193
+ 表現できます。序数と年番号は必ず同一の引数から導かれるため、年と四半期が食い違うラベルは構成できません。
194
+ - **四半期の境界は `yearStartMonth` を 3 で割った剰余で決まり、番号は `yearStartMonth` そのもので決まります**。
195
+ 0・3・6・9 では境界が暦四半期と一致して番号だけがずれ、他の 8 通りでは境界自体が動きます (1 なら 2 月〜4 月が Q1)。
196
+ - **`year` は `startDate.getFullYear()` と一致するとは限りません**。1 月を跨ぐ四半期 (4 月開始の 2026-01-15 は
197
+ `year` が 2025、`startDate` が 2026-01-01) で両者は異なるため、ラベルの年は必ず `year` から組み立ててください。
198
+ - **`formatQuarterLabel` が返す文字列はロケール非依存ですが、ISO 8601 ではありません** (ISO 8601 は暦日・年間通日・
199
+ 週日付のみを定め、四半期表記を定めません)。ECMA-402 に四半期のフィールドが無く、`Intl.DateTimeFormat` は `quarter`
200
+ オプションを送出せずに黙って捨てます (実測: `{ quarter: "long", year: "numeric" }` の `resolvedOptions()` は
201
+ `year` だけを返し、`ja-JP` では 2025-04-01 が `2025年` になります。`formatToParts` に四半期の断片は現れません)。履行できない `locale` 引数は置かないため、本パッケージの 3 段の優先順位
202
+ (フォーマッタ Props > `locale` > ISO 8601 既定) に四半期の段はありません。地域化した表記 (`2025年度 第2四半期`) は
203
+ `resolveQuarter` から利用側が組み立てます (年の部分だけは `formatLabel("year", …, undefined, locale)` で `locale` に従います)。
204
+ - **エラー契約は既存の 2 つの族をそのまま踏襲します**。`resolveQuarter` は未指定・Invalid Date で `RangeError` を
205
+ 送出し (計算族: `normalizeDateByUnit` と同じ)、`formatQuarterLabel` は空文字列を返します (ラベル族: `formatLabel` と
206
+ 同じ)。`formatQuarterLabel` の無効日付の短絡は `yearStartMonth` の検証より前に置きます。不正な `yearStartMonth` は
207
+ どちらも `RangeError` です。
208
+ - **既知の制約**: `MonthSelector` / `YearSelector` は選択肢のフォーマッタ Props を持たないため、四半期の粒度で
209
+ ラベル付けした月ドロップダウンは依然として作れません (フォーマッタ Props の新設は本リリースの範囲外)。
210
+
10
211
  ## 0.11.1
11
212
 
12
213
  ### 修正
@@ -15,7 +216,6 @@ All notable changes to `@aiquants/period-slider` are documented here.
15
216
  操作要素の幅に合わせた 1 列のリストの上へ重なっていました (行を覆うだけで、ネイティブのポップアップにも
16
217
  無い部品です)。
17
218
 
18
-
19
219
  ## 0.11.0
20
220
 
21
221
  ### 利用側の契約が変わる点