@aiquants/period-slider 0.7.0 → 0.9.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/README.md +137 -25
- package/dist/MonthSelector.d.ts.map +1 -1
- package/dist/PeriodSlider.d.ts +144 -16
- package/dist/PeriodSlider.d.ts.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +4 -4
- package/dist/index.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1743 -1431
- package/dist/styles/period-slider.css +1 -1
- package/dist/styles/period-slider.standalone.css +1 -1
- package/dist/usePeriodSlider.d.ts +96 -10
- package/dist/usePeriodSlider.d.ts.map +1 -1
- package/package.json +5 -5
- package/src/DateSelector.tsx +1 -1
- package/src/MonthSelector.tsx +4 -1
- package/src/PeriodSlider.tsx +751 -218
- package/src/index.ts +14 -3
- package/src/styles/period-slider.css +25 -0
- package/src/usePeriodSlider.ts +510 -45
package/README.md
CHANGED
|
@@ -20,6 +20,7 @@
|
|
|
20
20
|
- `range`: 開始時期と終了時期の 2 つのつまみと連結バーで範囲を選択。
|
|
21
21
|
- `point`: 単一のつまみで時点を選択。
|
|
22
22
|
- `vernier`: ノギス (Vernier Caliper) 型 2 段スケール一体型モード。全体期間からマクロ表示窓を上側で指定し、その拡大スケールを下側で精密選択。上下反転、台形プロジェクション光、2 段スケールの目盛線、精密ヘアライン針を完備。
|
|
23
|
+
- **ミクロレールは期間と時点の 2 形態**: `microRange` / `defaultMicroRange` / `onChangeMicroRange` を渡せば 2 つまみの期間選択、`microValue` / `defaultMicroValue` / `onChangeMicroPoint` を渡せば 1 つまみの時点選択になります。2 系統の同時指定は型で禁じられ、実行時も `RangeError` で拒否します。時点形態ではミクロ側の接続バーを描かず、つまみは `role="slider"` が 1 つだけ立ちます (全体で 3 つ)。
|
|
23
24
|
- **半円直径 (±8px) 完全充填幾何配置**: 半円ノブ底面 (16px) を完全に満たす一体型選択ゲージ。
|
|
24
25
|
- **上下段つまみ交差反転スワップ (Crossover)**: マクロ・ミクロ双方で上限下限の追い越し反転をサポート。
|
|
25
26
|
- **弾性復元 (Push-and-Restore)**: マクロ縮小時の一時クランプ後、拡大時に記憶された初期ミクロ選択範囲へ自動復元。
|
|
@@ -57,6 +58,9 @@
|
|
|
57
58
|
- ノギスモードではマクロツールチップ (`--aqps-macro-color`) とミクロツールチップ (`--aqps-micro-color`) がセマンティックに色分けされ、上下段の対応関係が一目で判別可能。
|
|
58
59
|
- **ロケール中立な表示文字列**: 組み込み文字列に特定の言語を持ちません。アクセシブル名の既定値は英語、日付表記の既定値は ISO 8601 で、`locale` を渡せば `Intl.DateTimeFormat` 書式、フォーマッタ Props を渡せば任意書式になります。`<input>` の `value` と `<option value>` は常に ISO 8601 (または生の数値) で、`locale` の影響を受けません。
|
|
59
60
|
- **高いアクセシビリティ**: WAI-ARIA `slider` ロール、キーボード操作 (矢印キー, PageUp/Down, Home/End) 完全準拠 (Vernier ノギスハンドル含む)。
|
|
61
|
+
- **`Shift` + ホイールによる平行移動**: トラック上で `Shift` を押しながらホイールを回すと、選択がステッパーと同じ ±1 単位だけ平行移動します。`Shift` 無しの素のホイールはページのスクロールのままで、ページのスクロールを奪うのは `Shift` 付きのホイールが使えるデルタを運んでいるときだけです (レールが端に着いていて結果的に何も動かない場合も、操作はレールへ向けられているため奪います)。縦向きレールではレールの正方向が上のため符号が反転します。ノギスではポインターが載っている段のスケール (マクロレールならマクロ窓、ミクロレールならミクロ選択) が動きます。
|
|
62
|
+
- **レールが描く位置だけを名乗り、そこだけを確定させる**: 離散ミクロレール (`microIsDiscrete`) は候補集合しか描かないため、つまみの位置・読み上げ値・ラベル・そして確定値がすべて同じ 1 規則 (候補があれば最近傍候補、無ければ窓へのクランプ) を読みます。つまみが描かれている場所と利用側が受け取る値が食い違いません。
|
|
63
|
+
- **マクロ窓の両境界は対**: ノギスのミクロレールは、マクロつまみが名乗る期間をちょうど覆います。`macroRange` に期間の途中を指す日付を渡しても、開始側は先頭マクロ期間の先頭へ (`getMacroWindowStartDate`)、終了側は末尾マクロ期間の末日へ (`getMacroWindowEndDate`) 揃います (例: `2026-09-15`〜`2026-10-15` は `2026-09-01`〜`2026-10-31`)。丸めた窓が `[minDate, maxDate]` をはみ出す場合は定義域で切り落とされ、この交差は `resolveMacroWindow` が一手に引き受けます — レール・フックの収め込み・ミクロセレクタが同じ窓を読むため、どの経路も定義域外のミクロ日付を確定させません。
|
|
60
64
|
|
|
61
65
|
## インストール
|
|
62
66
|
|
|
@@ -258,6 +262,52 @@ export function VernierExample() {
|
|
|
258
262
|
|
|
259
263
|
マクロ・ミクロ両段のラベルと `aria-valuetext` は、つまみ位置と `aria-valuenow` を決めるのと同一の符号値から復元した `Date` を整形します。したがって `macroUnit="month"` で `macroRange` に月の途中の日付を渡しても、ラベルは常に `aria-valuenow` と一致します。対の 2 つの符号値が一致したとき (例: 同一マクロ単位内に収まる `macroRange`) は、同一文字列のラベルを 2 枚描かず 1 枚へ畳みます (下記 DOM 契約の `data-duplicate`)。
|
|
260
264
|
|
|
265
|
+
### PeriodSlider (Vernier ノギス × 時点選択)
|
|
266
|
+
|
|
267
|
+
数年の定義域から 1 か月・1 日を「1 点だけ」指す画面向けに、ノギスのミクロレールを単一つまみにした形態です。マクロ窓で定義域を絞ってからミクロレールで精密に指す操作は期間選択と同じで、違いはミクロ側が期間ではなく時点であることだけです。
|
|
268
|
+
|
|
269
|
+
ミクロ側に `microValue` (制御) または `defaultMicroValue` (非制御) を渡すと、この形態になります。
|
|
270
|
+
|
|
271
|
+
```tsx
|
|
272
|
+
import { PeriodSlider } from "@aiquants/period-slider"
|
|
273
|
+
import { useState } from "react"
|
|
274
|
+
|
|
275
|
+
export function VernierPointExample() {
|
|
276
|
+
// マクロ側の表示窓 (2020 年〜2026 年)
|
|
277
|
+
const [macroRange, setMacroRange] = useState<[Date, Date]>([
|
|
278
|
+
new Date(2020, 0, 1),
|
|
279
|
+
new Date(2026, 0, 1),
|
|
280
|
+
])
|
|
281
|
+
// ミクロ側の確定時点 (2023 年 6 月)
|
|
282
|
+
const [basisMonth, setBasisMonth] = useState<Date>(new Date(2023, 5, 1))
|
|
283
|
+
|
|
284
|
+
return (
|
|
285
|
+
<PeriodSlider
|
|
286
|
+
mode="vernier"
|
|
287
|
+
unit="month"
|
|
288
|
+
macroUnit="year"
|
|
289
|
+
microUnit="month"
|
|
290
|
+
minDate={new Date(2015, 0, 1)}
|
|
291
|
+
maxDate={new Date(2030, 11, 31)}
|
|
292
|
+
macroRange={macroRange}
|
|
293
|
+
onChangeMacroRange={(lower, upper) => setMacroRange([lower, upper])}
|
|
294
|
+
microValue={basisMonth}
|
|
295
|
+
onChangeMicroPoint={setBasisMonth}
|
|
296
|
+
/>
|
|
297
|
+
)
|
|
298
|
+
}
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
時点形態の契約は次のとおりです。
|
|
302
|
+
|
|
303
|
+
- ミクロレールのつまみは 1 つ (`data-handle-type="micro-point"`) で、`role="slider"` はマクロ 2 つと合わせて 3 つになります。既定のアクセシブル名は `"Micro selected date"` で、`pointAriaLabel` で上書きできます。
|
|
304
|
+
- ミクロ側の接続バー (`period-slider-connect-micro`) は描きません。幅を持たない選択を帯で表すと「満タンの期間」に見え、掴める帯まで生えてしまうためです。マクロ窓の帯は従来どおり残ります。
|
|
305
|
+
- `aria-valuemin` / `aria-valuemax` はミクロレールの両端 (マクロ窓で切り出した範囲) で、`aria-valuenow` は選択時点そのものです。期間形態のように相手のつまみで塞がれることはありません。
|
|
306
|
+
- キーボードは `mode="point"` と同じく左右対称です。`←` `→` で ±1 ミクロ単位、`PageUp` / `PageDown` で ±5、`Home` / `End` でレールの両端へ届きます。動けない押下はコールバックを発火しません。
|
|
307
|
+
- ステッパーは ±1 ミクロ単位で、レールの端に着いた側だけが `disabled` になります。
|
|
308
|
+
- マクロ窓を掴んで動かすと時点も同じ暦差分だけ平行移動し、窓の端を動かして時点が窓の外に出る場合は窓の内側へ収まります。
|
|
309
|
+
- `microIsDiscrete` / `microAllowedDates` は期間形態と同じく併用でき、キーボードもステッパーも候補集合の上だけを歩きます。
|
|
310
|
+
|
|
261
311
|
### PeriodSlider (垂直レイアウト)
|
|
262
312
|
|
|
263
313
|
`isVertical={true}` を指定することで、縦向き (下部が最小日付、上部が最大日付) のスライダーとして表示できます。
|
|
@@ -417,17 +467,16 @@ export function CustomLabelExample() {
|
|
|
417
467
|
|
|
418
468
|
#### Vernier モード専用 Props (`mode="vernier"`)
|
|
419
469
|
|
|
470
|
+
ノギスは**ミクロレールの形態で 2 つに分かれます**。下の表はどちらの形態にも共通する Props で、ミクロ選択そのものは続く 2 表のいずれか一方だけを使います。
|
|
471
|
+
|
|
420
472
|
| プロパティ | 型 | 既定値 | 説明 |
|
|
421
473
|
| :--- | :--- | :--- | :--- |
|
|
422
474
|
| `macroRange` | `[Date, Date]` | (必須) | マクロ側の広域表示窓 [開始, 終了]。制御専用 (非制御版は存在しない)。欠落・2 要素タプル以外・Invalid Date・逆転 (`end` が `start` より前) は `RangeError`。`start` と `end` が同値の場合は 1 マクロ単位幅の窓として有効 |
|
|
423
475
|
| `onChangeMacroRange` | `(lower: Date, upper: Date) => void` | `undefined` | マクロ窓変更時コールバック |
|
|
424
|
-
| `microRange` | `[Date, Date]` | `undefined` | 制御時のミクロ選択期間タプル [開始, 終了]。指定時は本 Props が単一真実源となり、内部ステートは一切参照されない |
|
|
425
|
-
| `defaultMicroRange` | `[Date, Date]` | `undefined` | 非制御時の初期ミクロ選択期間タプル。以降のミクロ操作はコンポーネント内部のステートが保持し、つまみは操作に追従する。`microRange` 指定時は無視 |
|
|
426
|
-
| `onChangeMicroRange` | `(lower: Date, upper: Date) => void` | `undefined` | ミクロ選択期間変更時コールバック |
|
|
427
476
|
| `macroUnit` | `"year" \| "month" \| "day"` | `unit` | マクロ側時間解像度単位 (異単位構成用)。`macroUnit` で `minDate` と `maxDate` が同一値に丸められる場合は `RangeError` |
|
|
428
477
|
| `microUnit` | `"year" \| "month" \| "day"` | `unit` | ミクロ側時間解像度単位 (異単位構成用) |
|
|
429
478
|
| `macroIsDiscrete` | `boolean` | `false` | マクロ側の離散スナップ有効化フラグ。`false` の間は `macroAllowedDates` が参照されない |
|
|
430
|
-
| `microIsDiscrete` | `boolean` | `false` | ミクロ側の離散スナップ有効化フラグ。`false` の間は `microAllowedDates`
|
|
479
|
+
| `microIsDiscrete` | `boolean` | `false` | ミクロ側の離散スナップ有効化フラグ。`false` の間は `microAllowedDates` が参照されない。`true` かつ現在のマクロ窓が候補を 1 つ以上含む間、ミクロレールは候補集合しか描かないため、位置・`aria-valuenow` / `aria-valuetext`・ラベル・**確定値**のすべてが最近傍候補へ解決される (ドラッグ・キーボード・ホイール・ステッパー・フックの収め込みで同一規則)。窓が候補を 1 つも含まない場合は窓内の連続値として振る舞う |
|
|
431
480
|
| `macroAllowedDates` | `Date[]` | `allowedDates` | マクロ側の離散スナップ対象日付配列。`macroIsDiscrete={true}` との併用が必須 |
|
|
432
481
|
| `microAllowedDates` | `Date[]` | `allowedDates` | ミクロ側の離散スナップ対象日付配列。`microIsDiscrete={true}` との併用が必須。候補はマクロ窓で切り出され、窓の外の日付へはキーボード・ポインターのいずれからも到達しない。窓内に候補が 1 件も残らない場合、ミクロレールは窓内の連続値として振る舞う |
|
|
433
482
|
| `formatMacroLabel` | `(date: Date) => string` | `formatLabel` | マクロ側ラベル・ツールチップのカスタム表示文字列生成関数。引数はつまみ位置・`aria-valuenow` と同一の符号値から復元した `macroUnit` 正規化済み `Date` であり、`macroRange` の生の値ではない (`macroUnit="month"` なら常に月初、`"year"` なら常に元日、`"day"` は暦日そのままで時刻が 0 時) |
|
|
@@ -437,15 +486,35 @@ export function CustomLabelExample() {
|
|
|
437
486
|
| `showVernierTicks` | `boolean` | `true` | 目盛線の表示有無。マクロレールに 20% 間隔で 4 本、ミクロレールに 10% 間隔で 9 本を等間隔に描画する |
|
|
438
487
|
| `showHairline` | `boolean` | `true` | 半円つまみ先端の 1px 精密ヘアライン針の表示有無 |
|
|
439
488
|
|
|
489
|
+
##### ミクロが期間の形態 (`PeriodSliderVernierRangeProps`)
|
|
490
|
+
|
|
491
|
+
| プロパティ | 型 | 既定値 | 説明 |
|
|
492
|
+
| :--- | :--- | :--- | :--- |
|
|
493
|
+
| `microRange` | `[Date, Date]` | `undefined` | 制御時のミクロ選択期間タプル [開始, 終了]。指定時は本 Props が単一真実源となり、内部ステートは一切参照されない |
|
|
494
|
+
| `defaultMicroRange` | `[Date, Date]` | `undefined` | 非制御時の初期ミクロ選択期間タプル。以降のミクロ操作はコンポーネント内部のステートが保持し、つまみは操作に追従する。`microRange` 指定時は無視 |
|
|
495
|
+
| `onChangeMicroRange` | `(lower: Date, upper: Date) => void` | `undefined` | ミクロ選択期間変更時コールバック |
|
|
496
|
+
|
|
440
497
|
`microRange` (制御) / `defaultMicroRange` (非制御) はいずれか一方が必須です。共に省略した場合は描画時に `RangeError` を送出し、ミクロ選択範囲を発明しません。
|
|
441
498
|
|
|
499
|
+
##### ミクロが時点の形態 (`PeriodSliderVernierPointProps`)
|
|
500
|
+
|
|
501
|
+
| プロパティ | 型 | 既定値 | 説明 |
|
|
502
|
+
| :--- | :--- | :--- | :--- |
|
|
503
|
+
| `microValue` | `Date` | `undefined` | 制御時のミクロ選択時点。指定時は本 Props が単一真実源となり、内部ステートは一切参照されない |
|
|
504
|
+
| `defaultMicroValue` | `Date` | `undefined` | 非制御時の初期ミクロ選択時点。以降のミクロ操作はコンポーネント内部のステートが保持し、つまみは操作に追従する。`microValue` 指定時は無視 |
|
|
505
|
+
| `onChangeMicroPoint` | `(value: Date) => void` | `undefined` | ミクロ選択時点変更時コールバック |
|
|
506
|
+
|
|
507
|
+
`microValue` (制御) / `defaultMicroValue` (非制御) はいずれか一方が必須です。ミクロ選択を 1 つも渡さなければ、期間側・時点側の双方を名指しする `RangeError` を送出します。
|
|
508
|
+
|
|
509
|
+
期間側の 3 Props と時点側の 3 Props は**相互排他**です。型では互いを `never` として宣言しているため同時指定はコンパイルエラーになり、JavaScript からの同時指定は描画時に `RangeError` で拒否します (黙ってどちらかを優先すると、渡したはずのコールバックが永久に鳴らない状態になるため)。
|
|
510
|
+
|
|
442
511
|
#### アクセシビリティ Props (`AccessibleSliderLabels`, 全モード共通)
|
|
443
512
|
|
|
444
513
|
| プロパティ | 型 | 既定値 | 説明 |
|
|
445
514
|
| :--- | :--- | :--- | :--- |
|
|
446
515
|
| `lowerAriaLabel` | `string` | `"Range start"` (vernier 時 `"Micro range start"`) | 下限つまみのアクセシブル名 |
|
|
447
516
|
| `upperAriaLabel` | `string` | `"Range end"` (vernier 時 `"Micro range end"`) | 上限つまみのアクセシブル名 |
|
|
448
|
-
| `pointAriaLabel` | `string` | `"Selected date"` | 単一選択つまみのアクセシブル名 (`mode="point"
|
|
517
|
+
| `pointAriaLabel` | `string` | `"Selected date"` (vernier 時点形態では `"Micro selected date"`) | 単一選択つまみのアクセシブル名 (`mode="point"`、およびノギスのミクロ時点形態) |
|
|
449
518
|
| `macroLowerAriaLabel` | `string` | `"Macro range start"` | マクロ下限つまみのアクセシブル名 (`mode="vernier"` のみ) |
|
|
450
519
|
| `macroUpperAriaLabel` | `string` | `"Macro range end"` | マクロ上限つまみのアクセシブル名 (`mode="vernier"` のみ) |
|
|
451
520
|
| `decreaseAriaLabel` | `string` | `"Decrease"` | 値を `minDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (水平時は左の `◀`、垂直時は下の `▼`) |
|
|
@@ -462,8 +531,9 @@ export function CustomLabelExample() {
|
|
|
462
531
|
| :--- | :--- | :--- |
|
|
463
532
|
| `onChangePoint` | `point` | `(value: Date) => void` |
|
|
464
533
|
| `onChangeRange` | `range` | `(lower: Date, upper: Date) => void` |
|
|
465
|
-
| `onChangeMacroRange` | `vernier` | `(lower: Date, upper: Date) => void` |
|
|
466
|
-
| `onChangeMicroRange` | `vernier` | `(lower: Date, upper: Date) => void` |
|
|
534
|
+
| `onChangeMacroRange` | `vernier` (両形態) | `(lower: Date, upper: Date) => void` |
|
|
535
|
+
| `onChangeMicroRange` | `vernier` (ミクロが期間の形態) | `(lower: Date, upper: Date) => void` |
|
|
536
|
+
| `onChangeMicroPoint` | `vernier` (ミクロが時点の形態) | `(value: Date) => void` |
|
|
467
537
|
|
|
468
538
|
#### DOM 契約 (テストフック)
|
|
469
539
|
|
|
@@ -472,19 +542,19 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
472
542
|
| フック | 対象 |
|
|
473
543
|
| :--- | :--- |
|
|
474
544
|
| `[data-mode="range" \| "point" \| "vernier"]` | ルート要素。`data-unit` / `data-orientation` / `data-label-position` / `data-color-scheme` / `data-disabled` を併せ持つ |
|
|
475
|
-
| `[role="slider"]` | すべてのつまみ。`aria-label` (既定 `"Range start"` / `"Range end"` / `"Selected date"`) で個々のつまみを識別でき、`data-active` / `data-front`
|
|
545
|
+
| `[role="slider"]` | すべてのつまみ。`aria-label` (既定 `"Range start"` / `"Range end"` / `"Selected date"` / `"Macro range start"` / `"Macro range end"` / `"Micro range start"` / `"Micro range end"` / `"Micro selected date"`) で個々のつまみを識別でき、`data-active` / `data-front` が操作状態を表す。個数はモードと形態で決まり、`range` は 2、`point` は 1、ノギスの期間形態は 4、ノギスの時点形態は 3 |
|
|
476
546
|
| `[data-testid="period-slider-knob"]` | `range` / `point` モードのつまみ本体 (円形ノブ)。つまみの位置・寸法の測定に用いる |
|
|
477
|
-
| `[data-handle-type="macro-low" \| "macro-high" \| "micro-low" \| "micro-high"]` | ノギスモードのつまみのみに付与 (`role="slider"` との併用)
|
|
547
|
+
| `[data-handle-type="macro-low" \| "macro-high" \| "micro-low" \| "micro-high" \| "micro-point"]` | ノギスモードのつまみのみに付与 (`role="slider"` との併用)。`micro-low` / `micro-high` はミクロが期間の形態、`micro-point` はミクロが時点の形態でのみ現れ、両者が同時に存在することはない。配置位置は `data-vernier-pos` (`top` / `bottom` / `left` / `right`) が持ち、配色を決める `data-handle-type` と直交する |
|
|
478
548
|
| `[data-testid="period-slider-track"]` | トラック (`data-vernier-orientation` でノギスのレール配置を判別) |
|
|
479
|
-
| `[data-testid="period-slider-connect"]` | 接続バー。ノギスでは `period-slider-connect-macro` / `period-slider-connect-micro` の 2 本 |
|
|
549
|
+
| `[data-testid="period-slider-connect"]` | 接続バー。ノギスでは `period-slider-connect-macro` / `period-slider-connect-micro` の 2 本 (ミクロが時点の形態では `period-slider-connect-micro` を描かない) |
|
|
480
550
|
| `[data-testid="period-slider-tick"]` | 目盛線。ノギスモードでは `data-tick-scale="macro" \| "micro"` が併記され上下段を判別できる |
|
|
481
551
|
| `[data-testid="period-slider-hover-guide"]` | ポインターオーバーレイ (点と追従ラベルを束ねる器)。`range` / `point` のみで、ノギスモードでは描かれない |
|
|
482
552
|
| `[data-testid="period-slider-hover-dot"]` | オーバーレイの点 (ポインター位置そのものを示す。重複時も表示され続ける) |
|
|
483
553
|
| `[data-testid="period-slider-hover-tooltip"]` | オーバーレイの追従ラベル。指している値がつまみの確定値と一致する間は `data-duplicate="true"` が付いて `visibility: hidden` になる |
|
|
484
|
-
| `[data-tooltip-style="always" \| "hover" \| "balloon"]` | すべてのツールチップ (Range は 2 枚、Point は 1
|
|
485
|
-
| `[data-slanted="true"]` | 近接傾斜中のツールチップ。Range の 2
|
|
486
|
-
| `[data-duplicate="true"]` | 同じ値が二重に描かれる側を隠す唯一の印。対象は 2 種類で、いずれも符号化値 (`aria-valuenow`) の厳密一致が条件。(1) 同じ値に重なった対のうち冗長な側のつまみラベル 1 枚 — 対は Range の下限 / 上限、ノギスのマクロ下限 /
|
|
487
|
-
| `[data-handle-type="macro-low"] [data-tooltip-style]` | 個々のノギスラベル。ノギスのツールチップは親つまみ経由で特定する。水平レール (`macro-top` / `macro-bottom`) かつ `autoSlantLabels` 有効時はインライン `style` に `--ps-tooltip-tx` / `--ps-tooltip-ty` / `--ps-tooltip-rot` の 3 つを持ち (`--ps-tooltip-ty` はレール基準からの生のピクセル差分)、垂直レール (`macro-left` / `macro-right`)
|
|
554
|
+
| `[data-tooltip-style="always" \| "hover" \| "balloon"]` | すべてのツールチップ (Range は 2 枚、Point は 1 枚、ノギスはミクロ期間形態が 4 枚・ミクロ時点形態が 3 枚)。`tooltipStyle="hover"` ではツールチップ要素自体が描かれない。`range` / `point` のツールチップは `data-label-position` / `data-front` を併せ持つ (ノギスではこの 2 つは親つまみ側にある) |
|
|
555
|
+
| `[data-slanted="true"]` | 近接傾斜中のツールチップ。Range の 2 枚とノギスのミクロ期間形態の 4 枚が対象 (Point モードと、ノギスのミクロ時点形態のミクロラベルには付かない。いずれも離す相手が居ないため)。ノギスは対ごとに独立して傾くため、マクロ対とミクロ対で有無が違うのは正常。垂直レイアウトでは付かない |
|
|
556
|
+
| `[data-duplicate="true"]` | 同じ値が二重に描かれる側を隠す唯一の印。対象は 2 種類で、いずれも符号化値 (`aria-valuenow`) の厳密一致が条件。(1) 同じ値に重なった対のうち冗長な側のつまみラベル 1 枚 — 対は Range の下限 / 上限、ノギスのマクロ下限 / 上限、ノギスのミクロ期間形態のミクロ下限 / 上限の 3 つで、Point モードとノギスのミクロ時点形態には付かない。(2) 指している値がつまみの確定値と一致したときのオーバーレイの追従ラベル — こちらは Point モードでも付く (`tooltipStyle="hover"` ではつまみのラベルが描かれず二重にならないため付かない) |
|
|
557
|
+
| `[data-handle-type="macro-low"] [data-tooltip-style]` | 個々のノギスラベル。ノギスのツールチップは親つまみ経由で特定する。水平レール (`macro-top` / `macro-bottom`) かつ `autoSlantLabels` 有効時はインライン `style` に `--ps-tooltip-tx` / `--ps-tooltip-ty` / `--ps-tooltip-rot` の 3 つを持ち (`--ps-tooltip-ty` はレール基準からの生のピクセル差分)、垂直レール (`macro-left` / `macro-right`)、`autoSlantLabels={false}`、およびミクロ時点形態のミクロラベルでは `style` 属性を持たない (時点には離す相手が居ないため傾斜計算そのものを行わない) |
|
|
488
558
|
|
|
489
559
|
### 実行時バリデーション (Fail Fast)
|
|
490
560
|
|
|
@@ -497,16 +567,21 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
497
567
|
| `PeriodSlider` | `maxDate <= minDate` | `RangeError: PeriodSlider: maxDate must be strictly later than minDate (...)` |
|
|
498
568
|
| `PeriodSlider` (`vernier`) | `macroUnit` で `minDate` と `maxDate` が同一単位に丸められる | `RangeError: PeriodSlider: macroUnit "..." cannot distinguish minDate from maxDate (...)` |
|
|
499
569
|
| `PeriodSlider` (`vernier`) | `macroRange` の未指定・2 要素タプル以外・Invalid Date・逆転 | `RangeError: PeriodSlider: macroRange is required and must be a [start, end] Date tuple (...)` / `... macroRange[0] must be a valid Date (...)` / `... macroRange must not be inverted (...)` |
|
|
500
|
-
| `PeriodSlider` (`vernier`) |
|
|
570
|
+
| `PeriodSlider` (`vernier`) | ミクロ選択 Props を 1 つも指定していない | `RangeError: PeriodSlider: vernier mode requires a micro selection; supply microRange / defaultMicroRange for a period, or microValue / defaultMicroValue for a point` |
|
|
571
|
+
| `PeriodSlider` (`vernier`) | ミクロ期間系とミクロ時点系の Props を同時に指定 | `RangeError: PeriodSlider: vernier mode takes either a micro range (microRange / defaultMicroRange / onChangeMicroRange) or a micro point (microValue / defaultMicroValue / onChangeMicroPoint), never both` |
|
|
572
|
+
| `PeriodSlider` (`vernier`) | 時点系の Props だけを渡し `microValue` / `defaultMicroValue` が共に未指定 | `RangeError: PeriodSlider: vernier point mode requires a micro selection; supply microValue (controlled) or defaultMicroValue (uncontrolled)` |
|
|
573
|
+
| `PeriodSlider` (`vernier`) | 期間系の Props だけを渡し `microRange` / `defaultMicroRange` が共に未指定 | `RangeError: PeriodSlider: vernier range mode requires a micro selection; supply microRange (controlled) or defaultMicroRange (uncontrolled)` |
|
|
501
574
|
| `PeriodSlider` (`vernier`) | 指定された `microRange` / `defaultMicroRange` が 2 要素タプル以外・Invalid Date・逆転 | `RangeError: PeriodSlider: <プロパティ名> ...` |
|
|
575
|
+
| `PeriodSlider` (`vernier`) | 指定された `microValue` / `defaultMicroValue` が Invalid Date | `RangeError: PeriodSlider: <プロパティ名> must be a valid Date (received: ...)` |
|
|
576
|
+
| `PeriodSlider` (`vernier`) | 指定されたミクロ選択が `[minDate, maxDate]` の外 | `RangeError: PeriodSlider: <プロパティ名> must lie within [minDate, maxDate] (...)` (`macroRange` は定義域をはみ出してよい。レールが定義域と積を取り、通知はクランプ済みの値を配るため) |
|
|
502
577
|
| `PeriodSlider` | `allowedDates` の全要素が `[minDate, maxDate]` 外 | `RangeError: getSortedAllowedDates: every allowedDates entry falls outside [minDate, maxDate] (...)` |
|
|
503
|
-
| `usePeriodSliderRange` / `usePeriodSliderPoint` / `
|
|
578
|
+
| `usePeriodSliderRange` / `usePeriodSliderPoint` / `useVernierSliderRange` / `useVernierSliderPoint` | 境界・初期値の欠落、Invalid Date、逆転 | `RangeError: <フック名>: ...` |
|
|
504
579
|
| `PeriodSlider` | `locale` が空文字列・構造として不正な BCP 47 タグ・非文字列 | `RangeError: PeriodSlider: locale must be a valid BCP 47 language tag (received: ...)` |
|
|
505
580
|
| `DateSelector` | 同上 | `RangeError: DateSelector: "locale" must be a valid BCP 47 language tag (received ...)` |
|
|
506
581
|
| `MonthSelector` / `YearSelector` | 同上 | ``RangeError: <コンポーネント名>: `locale` must be a valid BCP 47 language tag, received ....`` |
|
|
507
582
|
| `YearSelector` / `MonthSelector` / `DateSelector` | `value` と `initialDate` が共に未指定 | `RangeError: <コンポーネント名>: either \`value\` (controlled) or \`initialDate\` (uncontrolled) is required; ...` |
|
|
508
583
|
| `YearSelector` | 境界の欠落・矛盾、Date / 年 Props の不正値 | `RangeError` |
|
|
509
|
-
| `MonthSelector` | 境界の矛盾、`allowedMonths` を伴わない `variant="dropdown"` での境界の欠落、`allowedMonths` の要素が Invalid Date (添字付きで報告)、Date / 年 Props の不正値 | ``RangeError: MonthSelector: `allowedMonths[1]` must be a valid Date, received ....`` 等 |
|
|
584
|
+
| `MonthSelector` | 境界の矛盾、`allowedMonths` を伴わない `variant="dropdown"` での境界の欠落、`allowedMonths` の要素が Invalid Date または `Date` でない (添字付きで報告)、Date / 年 Props の不正値 | ``RangeError: MonthSelector: `allowedMonths[1]` must be a valid Date, received ....`` 等 |
|
|
510
585
|
| `DateSelector` | Date / 年 Props の不正値、解決後の範囲が空、バリアントが要求する境界の欠落、`variant="split-dropdown"` への `allowedDates` 指定 | `RangeError` |
|
|
511
586
|
|
|
512
587
|
`DateSelector` は構成そのものの矛盾を優先して報告します。`variant="split-dropdown"` と `allowedDates` の併用は、`value` / `initialDate` の欠落よりも先に判定されます。
|
|
@@ -644,6 +719,9 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
644
719
|
|
|
645
720
|
3 つのセレクタはいずれも `value` (制御) または `initialDate` (非制御) で選択値を受け取り、両脇の ◀▶ ステッパーボタンで 1 単位ずつ移動します。
|
|
646
721
|
|
|
722
|
+
> [!NOTE]
|
|
723
|
+
> `variant="date"` のネイティブ入力 (`<input type="date">` / `<input type="month">`) は、同じ値を示す `variant="dropdown"` と並んだときに別物に見えないよう、同じ書体・字送り・面で描かれます。中央寄せだけはユーティリティでは届きません — Tailwind preflight が `::-webkit-datetime-edit` を `inline-flex` にするため `text-align` が余白を配らないからです。そこで同梱スタイルシートの公開クラス `.period-slider-native-date-field` が、編集領域を全幅化して中央へ寄せ、カレンダー起動子を絶対配置で桁送りから外します。自前のマークアップで同じ揃えが必要な場合はこのクラスを付けてください。preflight を適用しないホストでは編集領域が flex にならず、これらの宣言は無害に無視されます。
|
|
724
|
+
|
|
647
725
|
```tsx
|
|
648
726
|
import { YearSelector, MonthSelector, DateSelector } from "@aiquants/period-slider"
|
|
649
727
|
import { useState } from "react"
|
|
@@ -708,7 +786,7 @@ export function SelectorsExample() {
|
|
|
708
786
|
| `locale` | `string` | `undefined` | 選択肢テキストのロケール (BCP 47 言語タグ)。未指定は 4 桁ゼロ埋めの年、指定時は `Intl.DateTimeFormat` 書式。空文字列・不正タグ・非文字列は `RangeError` |
|
|
709
787
|
| `unit` | `"year" \| "month" \| "day"` | `undefined` | **不活性 Props**。フックの `SelectorProps` をスプレッドするための受け口で、描画・挙動には一切影響しない |
|
|
710
788
|
|
|
711
|
-
下限 (`minYear` または `minDate`) と上限 (`maxYear` または `maxDate`) は共に必須です。境界外の年を保持している間は、境界へ丸めず・`RangeError` も送出せず、その年を選択肢へ 1
|
|
789
|
+
下限 (`minYear` または `minDate`) と上限 (`maxYear` または `maxDate`) は共に必須です。境界外の年を保持している間は、境界へ丸めず・`RangeError` も送出せず、その年を選択肢へ 1 件加えてそのまま表示します。ステッパーは移動先の年が境界内にある場合だけ有効です (境界の 1 つ外側では戻る側だけが有効、それより外では両方とも `disabled`)。境界外の年が `onChange` へ渡ることはありません。
|
|
712
790
|
|
|
713
791
|
#### `MonthSelector` Props
|
|
714
792
|
|
|
@@ -798,9 +876,9 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
798
876
|
|
|
799
877
|
### React フック
|
|
800
878
|
|
|
801
|
-
|
|
879
|
+
4 つのフックはいずれもステート、更新関数、および `PeriodSlider` / セレクタへそのままスプレッドできる Props を返します。境界・初期値は必須で、欠落・Invalid Date・逆転はすべて `RangeError` です。ノギスは選択形態ごとに 1 つずつ用意されており、`useVernierSliderRange` がミクロ期間、`useVernierSliderPoint` がミクロ時点を受け持ちます。
|
|
802
880
|
|
|
803
|
-
`setRange` / `setValue` / `setMacroRange` / `setMicroRange` はステートを置き換えるだけでコールバックを発火しません。それ以外の更新関数 (`setLowerDate`, `shiftRange`, `resetRange`, `setMicroUpperDate`, `shiftMacroRange`, `resetVernier` 等) は対応する `onChange*` を発火します。
|
|
881
|
+
`setRange` / `setValue` / `setMacroRange` / `setMicroRange` / `setMicroValue` はステートを置き換えるだけでコールバックを発火しません。それ以外の更新関数 (`setLowerDate`, `shiftRange`, `resetRange`, `setMicroUpperDate`, `setMicroDate`, `shiftMacroRange`, `shiftMicroValue`, `resetVernier` 等) は対応する `onChange*` を発火します。
|
|
804
882
|
|
|
805
883
|
#### 共通: `SelectorProps`
|
|
806
884
|
|
|
@@ -861,7 +939,7 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
861
939
|
| `selectorProps` | `SelectorProps` | セレクタ用 Props |
|
|
862
940
|
| `sliderProps` | `PeriodSliderPointProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props |
|
|
863
941
|
|
|
864
|
-
#### `
|
|
942
|
+
#### `useVernierSliderRange(options)`
|
|
865
943
|
|
|
866
944
|
| オプション | 型 | 既定値 | 説明 |
|
|
867
945
|
| :--- | :--- | :--- | :--- |
|
|
@@ -869,7 +947,7 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
869
947
|
| `minDate` | `Date` | (必須) | 全期間マクロの下限日付 |
|
|
870
948
|
| `maxDate` | `Date` | (必須) | 全期間マクロの上限日付 (`minDate` より厳密に後) |
|
|
871
949
|
| `initialMacroRange` | `[Date, Date]` | (必須) | 初期マクロ表示窓 [開始, 終了] |
|
|
872
|
-
| `initialMicroRange` | `[Date, Date]` | (必須) | 初期ミクロ選択期間 [開始, 終了] |
|
|
950
|
+
| `initialMicroRange` | `[Date, Date]` | (必須) | 初期ミクロ選択期間 [開始, 終了] (初期マクロ窓と `[minDate, maxDate]` の交差の内側) |
|
|
873
951
|
| `macroUnit` | `PeriodSliderUnit` | `unit` | マクロ側時間解像度単位 |
|
|
874
952
|
| `microUnit` | `PeriodSliderUnit` | `unit` | ミクロ側時間解像度単位 |
|
|
875
953
|
| `onChangeMacroRange` | `(lower: Date, upper: Date) => void` | `undefined` | マクロ窓変更時コールバック |
|
|
@@ -886,14 +964,48 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
886
964
|
| `setMacroUpperDate` | `(date: Date) => void` | マクロ終了日更新関数。`maxDate` より後は `maxDate` へ収め、マクロ下限を下回った場合は下限も追従 |
|
|
887
965
|
| `setMicroLowerDate` | `(date: Date) => void` | ミクロ開始日更新関数。マクロ窓の下限より前は窓下限へ収め、ミクロ上限を超えた場合は上限も追従 |
|
|
888
966
|
| `setMicroUpperDate` | `(date: Date) => void` | ミクロ終了日更新関数。マクロ窓の上限より後は窓上限へ収め、ミクロ下限を下回った場合は下限も追従 |
|
|
889
|
-
| `shiftMacroRange` | `(delta: number) => void` | マクロ窓を `delta` マクロ単位シフト。窓幅を保つため、片側でも `[minDate, maxDate]` を越えるシフトは全体を中止する (クランプしない) |
|
|
890
|
-
| `shiftMicroRange` | `(delta: number) => void` | ミクロ選択期間を `delta`
|
|
967
|
+
| `shiftMacroRange` | `(delta: number) => void` | マクロ窓を `delta` マクロ単位シフト。窓幅を保つため、片側でも `[minDate, maxDate]` を越えるシフトは全体を中止する (クランプしない)。`macroIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`macroAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、候補集合を外れるシフトも同じく全体中止 |
|
|
968
|
+
| `shiftMicroRange` | `(delta: number) => void` | ミクロ選択期間を `delta` ミクロ単位シフト。実効マクロ窓 (マクロ窓と `[minDate, maxDate]` の交差) からはみ出すシフトは全体を中止する (クランプしない)。`microIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`microAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、候補集合を外れるシフトも同じく全体中止。現在のマクロ窓に候補が 1 つも無い場合は連続として扱う |
|
|
891
969
|
| `resetVernier` | `() => void` | マクロ・ミクロ双方を初期値へ復帰 |
|
|
892
970
|
| `macroStartSelectorProps` | `SelectorProps` | マクロ開始日セレクタ用 Props |
|
|
893
971
|
| `macroEndSelectorProps` | `SelectorProps` | マクロ終了日セレクタ用 Props |
|
|
894
972
|
| `microStartSelectorProps` | `SelectorProps` | ミクロ開始日セレクタ用 Props |
|
|
895
973
|
| `microEndSelectorProps` | `SelectorProps` | ミクロ終了日セレクタ用 Props |
|
|
896
|
-
| `sliderProps` | `
|
|
974
|
+
| `sliderProps` | `PeriodSliderVernierRangeProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props |
|
|
975
|
+
|
|
976
|
+
#### `useVernierSliderPoint(options)`
|
|
977
|
+
|
|
978
|
+
マクロ窓はそのままに、ミクロレールが単一の時点を指すノギス用フックです。オプションと返却値は `useVernierSliderRange` と対になっており、ミクロ側だけがタプルからスカラーへ置き換わります。
|
|
979
|
+
|
|
980
|
+
| オプション | 型 | 既定値 | 説明 |
|
|
981
|
+
| :--- | :--- | :--- | :--- |
|
|
982
|
+
| `unit` | `PeriodSliderUnit` | (必須) | 基本時間解像度単位 |
|
|
983
|
+
| `minDate` | `Date` | (必須) | 全期間マクロの下限日付 |
|
|
984
|
+
| `maxDate` | `Date` | (必須) | 全期間マクロの上限日付 (`minDate` より厳密に後) |
|
|
985
|
+
| `initialMacroRange` | `[Date, Date]` | (必須) | 初期マクロ表示窓 [開始, 終了] |
|
|
986
|
+
| `initialMicroValue` | `Date` | (必須) | 初期ミクロ選択時点 (初期マクロ窓と `[minDate, maxDate]` の交差の内側) |
|
|
987
|
+
| `macroUnit` | `PeriodSliderUnit` | `unit` | マクロ側時間解像度単位 |
|
|
988
|
+
| `microUnit` | `PeriodSliderUnit` | `unit` | ミクロ側時間解像度単位 |
|
|
989
|
+
| `onChangeMacroRange` | `(lower: Date, upper: Date) => void` | `undefined` | マクロ窓変更時コールバック |
|
|
990
|
+
| `onChangeMicroPoint` | `(value: Date) => void` | `undefined` | ミクロ時点変更時コールバック |
|
|
991
|
+
| その他 | — | — | 上記および `mode` / `macroRange` を除く `PeriodSlider` の Vernier 共通 Props をすべて受け取り、`sliderProps` へそのまま転送 |
|
|
992
|
+
|
|
993
|
+
| 返却値 | 型 | 説明 |
|
|
994
|
+
| :--- | :--- | :--- |
|
|
995
|
+
| `macroRange` | `[Date, Date]` | 現在のマクロ表示窓タプル |
|
|
996
|
+
| `setMacroRange` | `React.Dispatch<React.SetStateAction<[Date, Date]>>` | マクロ窓の直接更新関数 |
|
|
997
|
+
| `microValue` | `Date` | 現在のミクロ選択時点 |
|
|
998
|
+
| `setMicroValue` | `React.Dispatch<React.SetStateAction<Date>>` | ミクロ時点の直接更新関数 |
|
|
999
|
+
| `setMacroLowerDate` | `(date: Date) => void` | マクロ開始日更新関数。`minDate` より前は `minDate` へ収め、マクロ上限を超えた場合は上限も追従 |
|
|
1000
|
+
| `setMacroUpperDate` | `(date: Date) => void` | マクロ終了日更新関数。`maxDate` より後は `maxDate` へ収め、マクロ下限を下回った場合は下限も追従 |
|
|
1001
|
+
| `setMicroDate` | `(date: Date) => void` | ミクロ時点更新関数。マクロ窓の外はマクロ窓の境界へ収める |
|
|
1002
|
+
| `shiftMacroRange` | `(delta: number) => void` | マクロ窓を `delta` マクロ単位シフト。窓幅を保つため、片側でも `[minDate, maxDate]` を越えるシフトは全体を中止する (クランプしない)。`macroIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`macroAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、候補集合を外れるシフトも同じく全体中止 |
|
|
1003
|
+
| `shiftMicroValue` | `(delta: number) => void` | ミクロ時点を `delta` ミクロ単位シフトし、実効マクロ窓 (マクロ窓と `[minDate, maxDate]` の交差) へクランプする。時点には保つべき幅が無いため、`shiftMicroRange` と違い端で中止せず端へ着ける。`microIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`microAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、現在のマクロ窓に候補が 1 つも無い場合は連続スライダーと同じ 1 単位シフトへ退化する (送出しない) |
|
|
1004
|
+
| `resetVernier` | `() => void` | マクロ窓・ミクロ時点の双方を初期値へ復帰 |
|
|
1005
|
+
| `macroStartSelectorProps` | `SelectorProps` | マクロ開始日セレクタ用 Props |
|
|
1006
|
+
| `macroEndSelectorProps` | `SelectorProps` | マクロ終了日セレクタ用 Props |
|
|
1007
|
+
| `microSelectorProps` | `SelectorProps` | ミクロ時点セレクタ用 Props (`maxDate` は実効マクロ窓終端) |
|
|
1008
|
+
| `sliderProps` | `PeriodSliderVernierPointProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props |
|
|
897
1009
|
|
|
898
1010
|
## ライセンス
|
|
899
1011
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MonthSelector.d.ts","sourceRoot":"","sources":["../src/MonthSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8GAA8G;IAC9G,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,8FAA8F;IAC9F,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,iFAAiF;IACjF,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC7B,oQAAoQ;IACpQ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sQAAsQ;IACtQ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+IAA+I;IAC/I,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,+IAA+I;IAC/I,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,oKAAoK;IACpK,aAAa,CAAC,EAAE,IAAI,EAAE,CAAA;IACtB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+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,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oPAAoP;IACpP,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;
|
|
1
|
+
{"version":3,"file":"MonthSelector.d.ts","sourceRoot":"","sources":["../src/MonthSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8GAA8G;IAC9G,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,8FAA8F;IAC9F,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,iFAAiF;IACjF,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC7B,oQAAoQ;IACpQ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sQAAsQ;IACtQ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+IAA+I;IAC/I,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,+IAA+I;IAC/I,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,oKAAoK;IACpK,aAAa,CAAC,EAAE,IAAI,EAAE,CAAA;IACtB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+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,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oPAAoP;IACpP,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAkZD;;;;GAIG;AACH,eAAO,MAAM,aAAa,oCAnOa,kBAAkB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA8P3E,CAAA"}
|
package/dist/PeriodSlider.d.ts
CHANGED
|
@@ -97,11 +97,11 @@ export interface LabelSlantResult {
|
|
|
97
97
|
* ステッパー名は配置ではなく値への作用で定義 (同じボタンが横向きでは左、縦向きでは下に立つため)。
|
|
98
98
|
*/
|
|
99
99
|
export interface AccessibleSliderLabels {
|
|
100
|
-
/** Accessible name for lower handle / 下限つまみのアクセシブル名 (既定: "Range start" /
|
|
100
|
+
/** Accessible name for lower handle / 下限つまみのアクセシブル名 (既定: "Range start" / ノギスのミクロ期間形態では "Micro range start"。ミクロ時点形態には下限つまみが無く不活性) */
|
|
101
101
|
lowerAriaLabel?: string;
|
|
102
|
-
/** Accessible name for upper handle / 上限つまみのアクセシブル名 (既定: "Range end" /
|
|
102
|
+
/** Accessible name for upper handle / 上限つまみのアクセシブル名 (既定: "Range end" / ノギスのミクロ期間形態では "Micro range end"。ミクロ時点形態には上限つまみが無く不活性) */
|
|
103
103
|
upperAriaLabel?: string;
|
|
104
|
-
/** Accessible name for single
|
|
104
|
+
/** Accessible name for the single selection handle of point mode and of the vernier micro point shape / 単一選択つまみのアクセシブル名 (既定: point モードでは "Selected date"、ノギスのミクロ時点形態では "Micro selected date") */
|
|
105
105
|
pointAriaLabel?: string;
|
|
106
106
|
/** Accessible name for macro lower handle / マクロ下限つまみのアクセシブル名 (既定: "Macro range start") */
|
|
107
107
|
macroLowerAriaLabel?: string;
|
|
@@ -179,6 +179,9 @@ export interface PeriodSliderRangeProps extends BasePeriodSliderProps {
|
|
|
179
179
|
microRange?: never;
|
|
180
180
|
defaultMicroRange?: never;
|
|
181
181
|
onChangeMicroRange?: never;
|
|
182
|
+
microValue?: never;
|
|
183
|
+
defaultMicroValue?: never;
|
|
184
|
+
onChangeMicroPoint?: never;
|
|
182
185
|
}
|
|
183
186
|
/**
|
|
184
187
|
* Props of the single-handle point mode.
|
|
@@ -201,24 +204,26 @@ export interface PeriodSliderPointProps extends BasePeriodSliderProps {
|
|
|
201
204
|
microRange?: never;
|
|
202
205
|
defaultMicroRange?: never;
|
|
203
206
|
onChangeMicroRange?: never;
|
|
207
|
+
microValue?: never;
|
|
208
|
+
defaultMicroValue?: never;
|
|
209
|
+
onChangeMicroPoint?: never;
|
|
204
210
|
}
|
|
205
211
|
/**
|
|
206
|
-
* Props
|
|
207
|
-
*
|
|
212
|
+
* Props both vernier micro shapes share: the macro window rail and everything painted on either rail.
|
|
213
|
+
* ノギスの 2 形態が共有する Props (マクロ窓レールと両レールの描画設定)。
|
|
214
|
+
*
|
|
215
|
+
* The micro rail selects either a period or a point, and the props that express that choice live on the
|
|
216
|
+
* two shape interfaces below rather than here, so one shape's props can never be written on the other.
|
|
217
|
+
* ミクロレールの選択対象は期間か時点のいずれかであり、その選択を表す Props は本 interface ではなく
|
|
218
|
+
* 下の 2 形態 interface が持つため、一方の形態の Props をもう一方へ書くことは型として不可能。
|
|
208
219
|
*/
|
|
209
|
-
export interface
|
|
220
|
+
export interface BasePeriodSliderVernierProps extends BasePeriodSliderProps {
|
|
210
221
|
/** Vernier dual-scale integrated mode / ノギス型 2 段スケール一体型モード */
|
|
211
222
|
mode: "vernier";
|
|
212
223
|
/** Controlled macro window range [start, end] / マクロ側の広域表示窓 (必須・制御) */
|
|
213
224
|
macroRange: [Date, Date];
|
|
214
225
|
/** Callback triggered when the macro window changes / マクロ窓変更時コールバック */
|
|
215
226
|
onChangeMacroRange?: (lower: Date, upper: Date) => void;
|
|
216
|
-
/** Controlled micro selected range tuple [lower, upper] / 制御時のミクロ選択期間タプル */
|
|
217
|
-
microRange?: [Date, Date];
|
|
218
|
-
/** Initial micro range tuple for uncontrolled usage / 非制御時の初期ミクロ選択期間タプル */
|
|
219
|
-
defaultMicroRange?: [Date, Date];
|
|
220
|
-
/** Callback triggered when the micro selected range changes / ミクロ選択範囲変更時コールバック */
|
|
221
|
-
onChangeMicroRange?: (lower: Date, upper: Date) => void;
|
|
222
227
|
/** Vernier scale orientation; default is "macro-top" horizontally and "macro-left" when isVertical / ノギス配置方向 (既定: 横向き "macro-top"、isVertical 時 "macro-left") */
|
|
223
228
|
vernierOrientation?: "macro-top" | "macro-bottom" | "macro-left" | "macro-right";
|
|
224
229
|
/** Show semi-transparent trapezoid projection cone between macro and micro / 台形プロジェクション光の表示 (既定: true) */
|
|
@@ -250,6 +255,41 @@ export interface PeriodSliderVernierProps extends BasePeriodSliderProps {
|
|
|
250
255
|
defaultValue?: never;
|
|
251
256
|
onChangePoint?: never;
|
|
252
257
|
}
|
|
258
|
+
/**
|
|
259
|
+
* Props of the vernier shape whose micro rail selects a period with two handles.
|
|
260
|
+
* ミクロレールが 2 つのつまみで期間を選ぶノギス形態の Props。
|
|
261
|
+
*/
|
|
262
|
+
export interface PeriodSliderVernierRangeProps extends BasePeriodSliderVernierProps {
|
|
263
|
+
/** Controlled micro selected range tuple [lower, upper] / 制御時のミクロ選択期間タプル */
|
|
264
|
+
microRange?: [Date, Date];
|
|
265
|
+
/** Initial micro range tuple for uncontrolled usage / 非制御時の初期ミクロ選択期間タプル */
|
|
266
|
+
defaultMicroRange?: [Date, Date];
|
|
267
|
+
/** Callback triggered when the micro selected range changes / ミクロ選択範囲変更時コールバック */
|
|
268
|
+
onChangeMicroRange?: (lower: Date, upper: Date) => void;
|
|
269
|
+
microValue?: never;
|
|
270
|
+
defaultMicroValue?: never;
|
|
271
|
+
onChangeMicroPoint?: never;
|
|
272
|
+
}
|
|
273
|
+
/**
|
|
274
|
+
* Props of the vernier shape whose micro rail selects a single point with one handle.
|
|
275
|
+
* ミクロレールが 1 つのつまみで時点を選ぶノギス形態の Props。
|
|
276
|
+
*/
|
|
277
|
+
export interface PeriodSliderVernierPointProps extends BasePeriodSliderVernierProps {
|
|
278
|
+
/** Controlled micro selected point / 制御時のミクロ選択時点 */
|
|
279
|
+
microValue?: Date;
|
|
280
|
+
/** Initial micro point for uncontrolled usage / 非制御時の初期ミクロ選択時点 */
|
|
281
|
+
defaultMicroValue?: Date;
|
|
282
|
+
/** Callback triggered when the micro selected point changes / ミクロ選択時点変更時コールバック */
|
|
283
|
+
onChangeMicroPoint?: (value: Date) => void;
|
|
284
|
+
microRange?: never;
|
|
285
|
+
defaultMicroRange?: never;
|
|
286
|
+
onChangeMicroRange?: never;
|
|
287
|
+
}
|
|
288
|
+
/**
|
|
289
|
+
* Discriminated union of both vernier micro shapes, keyed by which micro selection props are supplied.
|
|
290
|
+
* どちらのミクロ選択 Props を渡したかを判別子とする、ノギス 2 形態の判別可能合併型。
|
|
291
|
+
*/
|
|
292
|
+
export type PeriodSliderVernierProps = PeriodSliderVernierRangeProps | PeriodSliderVernierPointProps;
|
|
253
293
|
/**
|
|
254
294
|
* Discriminated union of every PeriodSlider mode, keyed by the mode prop.
|
|
255
295
|
* mode Props を判別子とする全 PeriodSlider モードの判別可能合併型。
|
|
@@ -295,6 +335,29 @@ export declare const decode: (unit: PeriodSliderUnit, val: number) => Date;
|
|
|
295
335
|
* @throws RangeError when d is absent or an Invalid Date / d が未指定または Invalid Date の場合
|
|
296
336
|
*/
|
|
297
337
|
export declare const addUnit: (unit: PeriodSliderUnit, d: Date, amount: number) => Date;
|
|
338
|
+
/**
|
|
339
|
+
* Calculates the start boundary of a macro window in micro unit resolution.
|
|
340
|
+
* マクロ窓の開始境界を、ミクロ単位の解像度で算出する関数。
|
|
341
|
+
*
|
|
342
|
+
* The end boundary is expanded to the end of the terminal macro period (getMacroWindowEndDate), so the
|
|
343
|
+
* start must be collapsed to the head of the leading one: otherwise a window whose raw start sits mid
|
|
344
|
+
* period opens a rail that begins somewhere the macro handles never claim.
|
|
345
|
+
* 終了境界は末尾マクロ期間の末日まで広げられる (getMacroWindowEndDate) ため、開始境界も先頭マクロ期間の
|
|
346
|
+
* 先頭へ畳む必要がある。畳まないと、生の開始日が期間の途中にある窓で、マクロつまみが一度も名乗らない
|
|
347
|
+
* 位置からミクロレールが始まる。
|
|
348
|
+
*
|
|
349
|
+
* Normalising by the macro unit and then by the micro unit reproduces, for every unit pair, the mirror
|
|
350
|
+
* image of the end-side case table - including the pairs where the macro unit is the finer of the two.
|
|
351
|
+
* マクロ単位で正規化してからミクロ単位で正規化する形は、マクロ側が細かい組み合わせも含め、
|
|
352
|
+
* 全ての単位の組で終了側の場合分けの鏡像と一致する。
|
|
353
|
+
*
|
|
354
|
+
* @param macroUnit - Macro scale unit / マクロ側の時間解像度単位
|
|
355
|
+
* @param microUnit - Micro scale unit / ミクロ側の時間解像度単位
|
|
356
|
+
* @param d - Macro range start date / マクロ範囲の開始日付
|
|
357
|
+
* @returns Corrected boundary Date in micro unit resolution / 補正後のミクロ解像度開始日付
|
|
358
|
+
* @throws RangeError when d is absent or an Invalid Date / d が未指定または Invalid Date の場合
|
|
359
|
+
*/
|
|
360
|
+
export declare const getMacroWindowStartDate: (macroUnit: PeriodSliderUnit, microUnit: PeriodSliderUnit, d: Date) => Date;
|
|
298
361
|
/**
|
|
299
362
|
* Calculates the end boundary of a macro window in micro unit resolution.
|
|
300
363
|
* When the macro unit is coarser than the micro unit, expands the date to encompass
|
|
@@ -308,6 +371,27 @@ export declare const addUnit: (unit: PeriodSliderUnit, d: Date, amount: number)
|
|
|
308
371
|
* @throws RangeError when d is absent or an Invalid Date / d が未指定または Invalid Date の場合
|
|
309
372
|
*/
|
|
310
373
|
export declare const getMacroWindowEndDate: (macroUnit: PeriodSliderUnit, microUnit: PeriodSliderUnit, d: Date) => Date;
|
|
374
|
+
/**
|
|
375
|
+
* Resolves the effective micro window: the macro window intersected with [minDate, maxDate].
|
|
376
|
+
* Both boundaries of a macro window are rounded outward to whole macro periods, so on its own the
|
|
377
|
+
* window reaches past the domain whenever minDate or maxDate falls mid period. The rails, the state
|
|
378
|
+
* hooks' containment and the micro selectors must all read the same intersected pair: when one of them
|
|
379
|
+
* uses the raw window instead, it commits a micro date that the component's own domain assertions then
|
|
380
|
+
* reject, and the tree throws during render.
|
|
381
|
+
* 実効ミクロ窓 (マクロ窓と [minDate, maxDate] の交差) を解決する関数。
|
|
382
|
+
* マクロ窓は両端ともマクロ期間の外側へ丸められるため、minDate / maxDate が期間の途中にあると窓単体では
|
|
383
|
+
* 定義域を越える。レール・ステートフックの収め込み・ミクロセレクタが同一の交差結果を共有しないと、
|
|
384
|
+
* 生の窓を見た側が定義域外のミクロ日付を確定させ、本体の定義域表明がそれを弾いて描画中に送出する。
|
|
385
|
+
*
|
|
386
|
+
* @param macroUnit - Macro scale unit / マクロ側の時間解像度単位
|
|
387
|
+
* @param microUnit - Micro scale unit / ミクロ側の時間解像度単位
|
|
388
|
+
* @param macroRange - Current macro window tuple / 現在のマクロ窓タプル
|
|
389
|
+
* @param minDate - Domain lower boundary / 定義域の下限
|
|
390
|
+
* @param maxDate - Domain upper boundary / 定義域の上限
|
|
391
|
+
* @returns Window tuple in micro unit resolution, guaranteed to lie inside [minDate, maxDate] / [minDate, maxDate] の内側であることが保証されたミクロ解像度の窓タプル
|
|
392
|
+
* @throws RangeError naming this function when macroRange is not a usable tuple, when a boundary is absent or an Invalid Date, or when either pair is inverted / macroRange が利用可能なタプルでない場合、境界が未指定または Invalid Date の場合、いずれかの対が逆転している場合 (メッセージは本関数を名指しする)
|
|
393
|
+
*/
|
|
394
|
+
export declare const resolveMacroWindow: (macroUnit: PeriodSliderUnit, microUnit: PeriodSliderUnit, macroRange: [Date, Date], minDate: Date, maxDate: Date) => [Date, Date];
|
|
311
395
|
/**
|
|
312
396
|
* Formats a date for handle labels and tooltips.
|
|
313
397
|
* つまみラベル・ツールチップ用の日付文字列を生成する関数。
|
|
@@ -446,7 +530,46 @@ export declare const calculateLabelSlant: (lowPct: number, highPct: number, trac
|
|
|
446
530
|
* Grabbable part of a vernier slider, naming both the rail and the element on it.
|
|
447
531
|
* ノギススライダーで掴める部位 (レールと要素の組)。
|
|
448
532
|
*/
|
|
449
|
-
export type VernierHandle = "macro-low" | "macro-high" | "macro-connect" | "micro-low" | "micro-high" | "micro-connect";
|
|
533
|
+
export type VernierHandle = "macro-low" | "macro-high" | "macro-connect" | "micro-low" | "micro-high" | "micro-connect" | "micro-point";
|
|
534
|
+
/**
|
|
535
|
+
* What the vernier micro rail selects: a period spanned by two handles, or a point held by one.
|
|
536
|
+
* ノギスのミクロレールが選ぶ対象 (2 つのつまみが張る期間か、1 つのつまみが指す時点か)。
|
|
537
|
+
*/
|
|
538
|
+
export type VernierMicroShape = "range" | "point";
|
|
539
|
+
/**
|
|
540
|
+
* Tells which vernier rail a cross-axis offset falls on.
|
|
541
|
+
* 直交軸オフセットがノギスのどちらのレールに属するかを判定する関数。
|
|
542
|
+
*
|
|
543
|
+
* The track carries two rails separated by its centre line, so the sign of the offset - together with
|
|
544
|
+
* which rail the macro scale was drawn on - is the whole rule. Every gesture that has to pick a scale
|
|
545
|
+
* (a press, a wheel) reads it here rather than restating it.
|
|
546
|
+
* トラックは中心線で分かれた 2 本のレールを載せるため、オフセットの符号とマクロレールの側だけが判定規則の全て。
|
|
547
|
+
* スケールを選ぶ必要のある操作 (押下・ホイール) は、規則を再掲せず本関数を読む。
|
|
548
|
+
*
|
|
549
|
+
* @param pointerCrossAxisOffset - Signed pointer offset from the track center line in pixels / トラック中心線からのポインター直交軸オフセット (ピクセル、符号付き)
|
|
550
|
+
* @param orientation - Which rail the macro scale is drawn on / マクロスケールを描くレール
|
|
551
|
+
* @returns Rail the offset belongs to / オフセットが属するレール
|
|
552
|
+
*/
|
|
553
|
+
export declare const resolveVernierRailZone: (pointerCrossAxisOffset: number, orientation: "macro-top" | "macro-bottom" | "macro-left" | "macro-right") => "macro" | "micro";
|
|
554
|
+
/**
|
|
555
|
+
* Resolves the signed unit step a wheel gesture asks the rail for.
|
|
556
|
+
* ホイール操作がレールへ要求する符号付き 1 単位ステップを解決する関数。
|
|
557
|
+
*
|
|
558
|
+
* Holding Shift makes some platforms report the gesture on deltaX and others on deltaY, so the dominant
|
|
559
|
+
* component is read as the primary axis instead of trusting either field.
|
|
560
|
+
* Shift 押下時に deltaX で報告する環境と deltaY で報告する環境があるため、いずれかを信じず支配的な成分を主軸として読む。
|
|
561
|
+
*
|
|
562
|
+
* Screen coordinates grow rightwards and downwards, while the rail grows rightwards when horizontal and
|
|
563
|
+
* upwards when vertical - so the sign is flipped for a vertical rail. This is the axis, not a preference.
|
|
564
|
+
* 画面座標は右・下方向へ増えるのに対し、レールは横向きなら右、縦向きなら上へ伸びるため、縦向きだけ符号が反転する。
|
|
565
|
+
* これは好みではなく軸そのもの。
|
|
566
|
+
*
|
|
567
|
+
* @param deltaX - Horizontal wheel delta / ホイールの水平デルタ
|
|
568
|
+
* @param deltaY - Vertical wheel delta / ホイールの垂直デルタ
|
|
569
|
+
* @param isVertical - Whether the rail runs along the vertical axis / レールが垂直方向か
|
|
570
|
+
* @returns +1 toward maxDate, -1 toward minDate, or 0 when the gesture carries no usable delta / maxDate 方向なら +1、minDate 方向なら -1、使えるデルタが無ければ 0
|
|
571
|
+
*/
|
|
572
|
+
export declare const resolveWheelStep: (deltaX: number, deltaY: number, isVertical: boolean) => number;
|
|
450
573
|
/**
|
|
451
574
|
* Resolves the target Vernier handle based on pointer primary-axis ratio and cross-axis offset relative to track center.
|
|
452
575
|
* トラック中心線に対するポインターの直交軸オフセットと主軸比率から、操作対象となるノギスハンドル(マクロまたはミクロ)を判定します。
|
|
@@ -460,9 +583,10 @@ export type VernierHandle = "macro-low" | "macro-high" | "macro-connect" | "micr
|
|
|
460
583
|
* @param orientation - Which rail the macro scale is drawn on (default: "macro-top") / マクロスケールを描くレール (既定: "macro-top")
|
|
461
584
|
* @param handleHitSlopRatio - Hit slop around a knob as a 0-1 ratio (default: 0.05) / つまみ周辺の当たり判定余裕 (0-1 比率、既定: 0.05)
|
|
462
585
|
* @param allowConnectHandles - Whether a press inside a band may grab the band itself (default: true) / 帯の内側の押下で帯自体を掴めるか (既定: true)
|
|
586
|
+
* @param microShape - What the micro rail selects (default: "range") / ミクロレールの選択対象 (既定: "range")
|
|
463
587
|
* @returns Handle the press targets / 押下が対象とするハンドル
|
|
464
588
|
*/
|
|
465
|
-
export declare function resolveVernierTargetHandle(pointerPrimaryRatio: number, pointerCrossAxisOffset: number, macroLowRatio: number, macroHighRatio: number, microLowRatio: number, microHighRatio: number, orientation?: "macro-top" | "macro-bottom" | "macro-left" | "macro-right", handleHitSlopRatio?: number, allowConnectHandles?: boolean): VernierHandle;
|
|
589
|
+
export declare function resolveVernierTargetHandle(pointerPrimaryRatio: number, pointerCrossAxisOffset: number, macroLowRatio: number, macroHighRatio: number, microLowRatio: number, microHighRatio: number, orientation?: "macro-top" | "macro-bottom" | "macro-left" | "macro-right", handleHitSlopRatio?: number, allowConnectHandles?: boolean, microShape?: VernierMicroShape): VernierHandle;
|
|
466
590
|
/**
|
|
467
591
|
* Calculates updated macro window range when dragging a macro handle or connect bar, supporting crossover swapping.
|
|
468
592
|
* マクロハンドルまたはコネクトバードラッグ時の新マクロ範囲を算出します (上限下限反転スワップ対応)。
|
|
@@ -479,14 +603,18 @@ export declare function calculateVernierMacroDrag(handle: "macro-low" | "macro-h
|
|
|
479
603
|
* Calculates updated micro selection range when dragging a micro handle or connect bar, supporting crossover swapping.
|
|
480
604
|
* ミクロハンドルまたはコネクトバードラッグ時の新ミクロ範囲を算出します (上限下限反転スワップ対応)。
|
|
481
605
|
*
|
|
482
|
-
*
|
|
606
|
+
* A point handle carries no width, so it resolves to the bare clamped pointer ratio in both tuple slots:
|
|
607
|
+
* that is what keeps the degenerate selection degenerate for the whole drag.
|
|
608
|
+
* 時点つまみは幅を持たないため、両スロットともクランプ済みポインター比率そのものとなり、ドラッグ中ずっと幅ゼロが保たれる。
|
|
609
|
+
*
|
|
610
|
+
* @param handle - Dragged micro handle, connect bar or point handle
|
|
483
611
|
* @param pointerRatio - Current pointer ratio across track (0.0 - 1.0)
|
|
484
612
|
* @param startPointerRatio - Initial pointer ratio at drag start
|
|
485
613
|
* @param startMicroLowRatio - Initial micro low ratio at drag start
|
|
486
614
|
* @param startMicroHighRatio - Initial micro high ratio at drag start
|
|
487
615
|
* @returns Tuple of [nextLowRatio, nextHighRatio, activeHandle]
|
|
488
616
|
*/
|
|
489
|
-
export declare function calculateVernierMicroDrag(handle: "micro-low" | "micro-high" | "micro-connect", pointerRatio: number, startPointerRatio: number, startMicroLowRatio: number, startMicroHighRatio: number): [number, number, "micro-low" | "micro-high" | "micro-connect"];
|
|
617
|
+
export declare function calculateVernierMicroDrag(handle: "micro-low" | "micro-high" | "micro-connect" | "micro-point", pointerRatio: number, startPointerRatio: number, startMicroLowRatio: number, startMicroHighRatio: number): [number, number, "micro-low" | "micro-high" | "micro-connect" | "micro-point"];
|
|
490
618
|
/**
|
|
491
619
|
* SVG vector semicircle knob for Vernier caliper handles.
|
|
492
620
|
* Rendered using mathematical arc commands to guarantee perfectly smooth round edges without raster distortion.
|