@aiquants/period-slider 0.7.0 → 0.8.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 +125 -20
- package/dist/PeriodSlider.d.ts +66 -16
- package/dist/PeriodSlider.d.ts.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1591 -1413
- package/dist/usePeriodSlider.d.ts +87 -3
- package/dist/usePeriodSlider.d.ts.map +1 -1
- package/package.json +5 -5
- package/src/PeriodSlider.tsx +384 -157
- package/src/index.ts +7 -0
- package/src/usePeriodSlider.ts +329 -4
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)**: マクロ縮小時の一時クランプ後、拡大時に記憶された初期ミクロ選択範囲へ自動復元。
|
|
@@ -258,6 +259,52 @@ export function VernierExample() {
|
|
|
258
259
|
|
|
259
260
|
マクロ・ミクロ両段のラベルと `aria-valuetext` は、つまみ位置と `aria-valuenow` を決めるのと同一の符号値から復元した `Date` を整形します。したがって `macroUnit="month"` で `macroRange` に月の途中の日付を渡しても、ラベルは常に `aria-valuenow` と一致します。対の 2 つの符号値が一致したとき (例: 同一マクロ単位内に収まる `macroRange`) は、同一文字列のラベルを 2 枚描かず 1 枚へ畳みます (下記 DOM 契約の `data-duplicate`)。
|
|
260
261
|
|
|
262
|
+
### PeriodSlider (Vernier ノギス × 時点選択)
|
|
263
|
+
|
|
264
|
+
数年の定義域から 1 か月・1 日を「1 点だけ」指す画面向けに、ノギスのミクロレールを単一つまみにした形態です。マクロ窓で定義域を絞ってからミクロレールで精密に指す操作は期間選択と同じで、違いはミクロ側が期間ではなく時点であることだけです。
|
|
265
|
+
|
|
266
|
+
ミクロ側に `microValue` (制御) または `defaultMicroValue` (非制御) を渡すと、この形態になります。
|
|
267
|
+
|
|
268
|
+
```tsx
|
|
269
|
+
import { PeriodSlider } from "@aiquants/period-slider"
|
|
270
|
+
import { useState } from "react"
|
|
271
|
+
|
|
272
|
+
export function VernierPointExample() {
|
|
273
|
+
// マクロ側の表示窓 (2020 年〜2026 年)
|
|
274
|
+
const [macroRange, setMacroRange] = useState<[Date, Date]>([
|
|
275
|
+
new Date(2020, 0, 1),
|
|
276
|
+
new Date(2026, 0, 1),
|
|
277
|
+
])
|
|
278
|
+
// ミクロ側の確定時点 (2023 年 6 月)
|
|
279
|
+
const [basisMonth, setBasisMonth] = useState<Date>(new Date(2023, 5, 1))
|
|
280
|
+
|
|
281
|
+
return (
|
|
282
|
+
<PeriodSlider
|
|
283
|
+
mode="vernier"
|
|
284
|
+
unit="month"
|
|
285
|
+
macroUnit="year"
|
|
286
|
+
microUnit="month"
|
|
287
|
+
minDate={new Date(2015, 0, 1)}
|
|
288
|
+
maxDate={new Date(2030, 11, 31)}
|
|
289
|
+
macroRange={macroRange}
|
|
290
|
+
onChangeMacroRange={(lower, upper) => setMacroRange([lower, upper])}
|
|
291
|
+
microValue={basisMonth}
|
|
292
|
+
onChangeMicroPoint={setBasisMonth}
|
|
293
|
+
/>
|
|
294
|
+
)
|
|
295
|
+
}
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
時点形態の契約は次のとおりです。
|
|
299
|
+
|
|
300
|
+
- ミクロレールのつまみは 1 つ (`data-handle-type="micro-point"`) で、`role="slider"` はマクロ 2 つと合わせて 3 つになります。既定のアクセシブル名は `"Micro selected date"` で、`pointAriaLabel` で上書きできます。
|
|
301
|
+
- ミクロ側の接続バー (`period-slider-connect-micro`) は描きません。幅を持たない選択を帯で表すと「満タンの期間」に見え、掴める帯まで生えてしまうためです。マクロ窓の帯は従来どおり残ります。
|
|
302
|
+
- `aria-valuemin` / `aria-valuemax` はミクロレールの両端 (マクロ窓で切り出した範囲) で、`aria-valuenow` は選択時点そのものです。期間形態のように相手のつまみで塞がれることはありません。
|
|
303
|
+
- キーボードは `mode="point"` と同じく左右対称です。`←` `→` で ±1 ミクロ単位、`PageUp` / `PageDown` で ±5、`Home` / `End` でレールの両端へ届きます。動けない押下はコールバックを発火しません。
|
|
304
|
+
- ステッパーは ±1 ミクロ単位で、レールの端に着いた側だけが `disabled` になります。
|
|
305
|
+
- マクロ窓を掴んで動かすと時点も同じ暦差分だけ平行移動し、窓の端を動かして時点が窓の外に出る場合は窓の内側へ収まります。
|
|
306
|
+
- `microIsDiscrete` / `microAllowedDates` は期間形態と同じく併用でき、キーボードもステッパーも候補集合の上だけを歩きます。
|
|
307
|
+
|
|
261
308
|
### PeriodSlider (垂直レイアウト)
|
|
262
309
|
|
|
263
310
|
`isVertical={true}` を指定することで、縦向き (下部が最小日付、上部が最大日付) のスライダーとして表示できます。
|
|
@@ -417,13 +464,12 @@ export function CustomLabelExample() {
|
|
|
417
464
|
|
|
418
465
|
#### Vernier モード専用 Props (`mode="vernier"`)
|
|
419
466
|
|
|
467
|
+
ノギスは**ミクロレールの形態で 2 つに分かれます**。下の表はどちらの形態にも共通する Props で、ミクロ選択そのものは続く 2 表のいずれか一方だけを使います。
|
|
468
|
+
|
|
420
469
|
| プロパティ | 型 | 既定値 | 説明 |
|
|
421
470
|
| :--- | :--- | :--- | :--- |
|
|
422
471
|
| `macroRange` | `[Date, Date]` | (必須) | マクロ側の広域表示窓 [開始, 終了]。制御専用 (非制御版は存在しない)。欠落・2 要素タプル以外・Invalid Date・逆転 (`end` が `start` より前) は `RangeError`。`start` と `end` が同値の場合は 1 マクロ単位幅の窓として有効 |
|
|
423
472
|
| `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
473
|
| `macroUnit` | `"year" \| "month" \| "day"` | `unit` | マクロ側時間解像度単位 (異単位構成用)。`macroUnit` で `minDate` と `maxDate` が同一値に丸められる場合は `RangeError` |
|
|
428
474
|
| `microUnit` | `"year" \| "month" \| "day"` | `unit` | ミクロ側時間解像度単位 (異単位構成用) |
|
|
429
475
|
| `macroIsDiscrete` | `boolean` | `false` | マクロ側の離散スナップ有効化フラグ。`false` の間は `macroAllowedDates` が参照されない |
|
|
@@ -437,15 +483,35 @@ export function CustomLabelExample() {
|
|
|
437
483
|
| `showVernierTicks` | `boolean` | `true` | 目盛線の表示有無。マクロレールに 20% 間隔で 4 本、ミクロレールに 10% 間隔で 9 本を等間隔に描画する |
|
|
438
484
|
| `showHairline` | `boolean` | `true` | 半円つまみ先端の 1px 精密ヘアライン針の表示有無 |
|
|
439
485
|
|
|
486
|
+
##### ミクロが期間の形態 (`PeriodSliderVernierRangeProps`)
|
|
487
|
+
|
|
488
|
+
| プロパティ | 型 | 既定値 | 説明 |
|
|
489
|
+
| :--- | :--- | :--- | :--- |
|
|
490
|
+
| `microRange` | `[Date, Date]` | `undefined` | 制御時のミクロ選択期間タプル [開始, 終了]。指定時は本 Props が単一真実源となり、内部ステートは一切参照されない |
|
|
491
|
+
| `defaultMicroRange` | `[Date, Date]` | `undefined` | 非制御時の初期ミクロ選択期間タプル。以降のミクロ操作はコンポーネント内部のステートが保持し、つまみは操作に追従する。`microRange` 指定時は無視 |
|
|
492
|
+
| `onChangeMicroRange` | `(lower: Date, upper: Date) => void` | `undefined` | ミクロ選択期間変更時コールバック |
|
|
493
|
+
|
|
440
494
|
`microRange` (制御) / `defaultMicroRange` (非制御) はいずれか一方が必須です。共に省略した場合は描画時に `RangeError` を送出し、ミクロ選択範囲を発明しません。
|
|
441
495
|
|
|
496
|
+
##### ミクロが時点の形態 (`PeriodSliderVernierPointProps`)
|
|
497
|
+
|
|
498
|
+
| プロパティ | 型 | 既定値 | 説明 |
|
|
499
|
+
| :--- | :--- | :--- | :--- |
|
|
500
|
+
| `microValue` | `Date` | `undefined` | 制御時のミクロ選択時点。指定時は本 Props が単一真実源となり、内部ステートは一切参照されない |
|
|
501
|
+
| `defaultMicroValue` | `Date` | `undefined` | 非制御時の初期ミクロ選択時点。以降のミクロ操作はコンポーネント内部のステートが保持し、つまみは操作に追従する。`microValue` 指定時は無視 |
|
|
502
|
+
| `onChangeMicroPoint` | `(value: Date) => void` | `undefined` | ミクロ選択時点変更時コールバック |
|
|
503
|
+
|
|
504
|
+
`microValue` (制御) / `defaultMicroValue` (非制御) はいずれか一方が必須です。ミクロ選択を 1 つも渡さなければ、期間側・時点側の双方を名指しする `RangeError` を送出します。
|
|
505
|
+
|
|
506
|
+
期間側の 3 Props と時点側の 3 Props は**相互排他**です。型では互いを `never` として宣言しているため同時指定はコンパイルエラーになり、JavaScript からの同時指定は描画時に `RangeError` で拒否します (黙ってどちらかを優先すると、渡したはずのコールバックが永久に鳴らない状態になるため)。
|
|
507
|
+
|
|
442
508
|
#### アクセシビリティ Props (`AccessibleSliderLabels`, 全モード共通)
|
|
443
509
|
|
|
444
510
|
| プロパティ | 型 | 既定値 | 説明 |
|
|
445
511
|
| :--- | :--- | :--- | :--- |
|
|
446
512
|
| `lowerAriaLabel` | `string` | `"Range start"` (vernier 時 `"Micro range start"`) | 下限つまみのアクセシブル名 |
|
|
447
513
|
| `upperAriaLabel` | `string` | `"Range end"` (vernier 時 `"Micro range end"`) | 上限つまみのアクセシブル名 |
|
|
448
|
-
| `pointAriaLabel` | `string` | `"Selected date"` | 単一選択つまみのアクセシブル名 (`mode="point"
|
|
514
|
+
| `pointAriaLabel` | `string` | `"Selected date"` (vernier 時点形態では `"Micro selected date"`) | 単一選択つまみのアクセシブル名 (`mode="point"`、およびノギスのミクロ時点形態) |
|
|
449
515
|
| `macroLowerAriaLabel` | `string` | `"Macro range start"` | マクロ下限つまみのアクセシブル名 (`mode="vernier"` のみ) |
|
|
450
516
|
| `macroUpperAriaLabel` | `string` | `"Macro range end"` | マクロ上限つまみのアクセシブル名 (`mode="vernier"` のみ) |
|
|
451
517
|
| `decreaseAriaLabel` | `string` | `"Decrease"` | 値を `minDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (水平時は左の `◀`、垂直時は下の `▼`) |
|
|
@@ -462,8 +528,9 @@ export function CustomLabelExample() {
|
|
|
462
528
|
| :--- | :--- | :--- |
|
|
463
529
|
| `onChangePoint` | `point` | `(value: Date) => void` |
|
|
464
530
|
| `onChangeRange` | `range` | `(lower: Date, upper: Date) => void` |
|
|
465
|
-
| `onChangeMacroRange` | `vernier` | `(lower: Date, upper: Date) => void` |
|
|
466
|
-
| `onChangeMicroRange` | `vernier` | `(lower: Date, upper: Date) => void` |
|
|
531
|
+
| `onChangeMacroRange` | `vernier` (両形態) | `(lower: Date, upper: Date) => void` |
|
|
532
|
+
| `onChangeMicroRange` | `vernier` (ミクロが期間の形態) | `(lower: Date, upper: Date) => void` |
|
|
533
|
+
| `onChangeMicroPoint` | `vernier` (ミクロが時点の形態) | `(value: Date) => void` |
|
|
467
534
|
|
|
468
535
|
#### DOM 契約 (テストフック)
|
|
469
536
|
|
|
@@ -472,19 +539,19 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
472
539
|
| フック | 対象 |
|
|
473
540
|
| :--- | :--- |
|
|
474
541
|
| `[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`
|
|
542
|
+
| `[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
543
|
| `[data-testid="period-slider-knob"]` | `range` / `point` モードのつまみ本体 (円形ノブ)。つまみの位置・寸法の測定に用いる |
|
|
477
|
-
| `[data-handle-type="macro-low" \| "macro-high" \| "micro-low" \| "micro-high"]` | ノギスモードのつまみのみに付与 (`role="slider"` との併用)
|
|
544
|
+
| `[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
545
|
| `[data-testid="period-slider-track"]` | トラック (`data-vernier-orientation` でノギスのレール配置を判別) |
|
|
479
|
-
| `[data-testid="period-slider-connect"]` | 接続バー。ノギスでは `period-slider-connect-macro` / `period-slider-connect-micro` の 2 本 |
|
|
546
|
+
| `[data-testid="period-slider-connect"]` | 接続バー。ノギスでは `period-slider-connect-macro` / `period-slider-connect-micro` の 2 本 (ミクロが時点の形態では `period-slider-connect-micro` を描かない) |
|
|
480
547
|
| `[data-testid="period-slider-tick"]` | 目盛線。ノギスモードでは `data-tick-scale="macro" \| "micro"` が併記され上下段を判別できる |
|
|
481
548
|
| `[data-testid="period-slider-hover-guide"]` | ポインターオーバーレイ (点と追従ラベルを束ねる器)。`range` / `point` のみで、ノギスモードでは描かれない |
|
|
482
549
|
| `[data-testid="period-slider-hover-dot"]` | オーバーレイの点 (ポインター位置そのものを示す。重複時も表示され続ける) |
|
|
483
550
|
| `[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`)
|
|
551
|
+
| `[data-tooltip-style="always" \| "hover" \| "balloon"]` | すべてのツールチップ (Range は 2 枚、Point は 1 枚、ノギスはミクロ期間形態が 4 枚・ミクロ時点形態が 3 枚)。`tooltipStyle="hover"` ではツールチップ要素自体が描かれない。`range` / `point` のツールチップは `data-label-position` / `data-front` を併せ持つ (ノギスではこの 2 つは親つまみ側にある) |
|
|
552
|
+
| `[data-slanted="true"]` | 近接傾斜中のツールチップ。Range の 2 枚とノギスのミクロ期間形態の 4 枚が対象 (Point モードと、ノギスのミクロ時点形態のミクロラベルには付かない。いずれも離す相手が居ないため)。ノギスは対ごとに独立して傾くため、マクロ対とミクロ対で有無が違うのは正常。垂直レイアウトでは付かない |
|
|
553
|
+
| `[data-duplicate="true"]` | 同じ値が二重に描かれる側を隠す唯一の印。対象は 2 種類で、いずれも符号化値 (`aria-valuenow`) の厳密一致が条件。(1) 同じ値に重なった対のうち冗長な側のつまみラベル 1 枚 — 対は Range の下限 / 上限、ノギスのマクロ下限 / 上限、ノギスのミクロ期間形態のミクロ下限 / 上限の 3 つで、Point モードとノギスのミクロ時点形態には付かない。(2) 指している値がつまみの確定値と一致したときのオーバーレイの追従ラベル — こちらは Point モードでも付く (`tooltipStyle="hover"` ではつまみのラベルが描かれず二重にならないため付かない) |
|
|
554
|
+
| `[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
555
|
|
|
489
556
|
### 実行時バリデーション (Fail Fast)
|
|
490
557
|
|
|
@@ -497,16 +564,20 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
497
564
|
| `PeriodSlider` | `maxDate <= minDate` | `RangeError: PeriodSlider: maxDate must be strictly later than minDate (...)` |
|
|
498
565
|
| `PeriodSlider` (`vernier`) | `macroUnit` で `minDate` と `maxDate` が同一単位に丸められる | `RangeError: PeriodSlider: macroUnit "..." cannot distinguish minDate from maxDate (...)` |
|
|
499
566
|
| `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`) |
|
|
567
|
+
| `PeriodSlider` (`vernier`) | ミクロ選択 Props を 1 つも指定していない | `RangeError: PeriodSlider: vernier mode requires a micro selection; supply microRange / defaultMicroRange for a period, or microValue / defaultMicroValue for a point` |
|
|
568
|
+
| `PeriodSlider` (`vernier`) | ミクロ期間系とミクロ時点系の Props を同時に指定 | `RangeError: PeriodSlider: vernier mode takes either a micro range (microRange / defaultMicroRange / onChangeMicroRange) or a micro point (microValue / defaultMicroValue / onChangeMicroPoint), never both` |
|
|
569
|
+
| `PeriodSlider` (`vernier`) | 時点系の Props だけを渡し `microValue` / `defaultMicroValue` が共に未指定 | `RangeError: PeriodSlider: vernier point mode requires a micro selection; supply microValue (controlled) or defaultMicroValue (uncontrolled)` |
|
|
570
|
+
| `PeriodSlider` (`vernier`) | 期間系の Props だけを渡し `microRange` / `defaultMicroRange` が共に未指定 | `RangeError: PeriodSlider: vernier range mode requires a micro selection; supply microRange (controlled) or defaultMicroRange (uncontrolled)` |
|
|
501
571
|
| `PeriodSlider` (`vernier`) | 指定された `microRange` / `defaultMicroRange` が 2 要素タプル以外・Invalid Date・逆転 | `RangeError: PeriodSlider: <プロパティ名> ...` |
|
|
572
|
+
| `PeriodSlider` (`vernier`) | 指定された `microValue` / `defaultMicroValue` が Invalid Date | `RangeError: PeriodSlider: <プロパティ名> must be a valid Date (received: ...)` |
|
|
502
573
|
| `PeriodSlider` | `allowedDates` の全要素が `[minDate, maxDate]` 外 | `RangeError: getSortedAllowedDates: every allowedDates entry falls outside [minDate, maxDate] (...)` |
|
|
503
|
-
| `usePeriodSliderRange` / `usePeriodSliderPoint` / `useVernierSlider` | 境界・初期値の欠落、Invalid Date、逆転 | `RangeError: <フック名>: ...` |
|
|
574
|
+
| `usePeriodSliderRange` / `usePeriodSliderPoint` / `useVernierSlider` / `useVernierSliderPoint` | 境界・初期値の欠落、Invalid Date、逆転 | `RangeError: <フック名>: ...` |
|
|
504
575
|
| `PeriodSlider` | `locale` が空文字列・構造として不正な BCP 47 タグ・非文字列 | `RangeError: PeriodSlider: locale must be a valid BCP 47 language tag (received: ...)` |
|
|
505
576
|
| `DateSelector` | 同上 | `RangeError: DateSelector: "locale" must be a valid BCP 47 language tag (received ...)` |
|
|
506
577
|
| `MonthSelector` / `YearSelector` | 同上 | ``RangeError: <コンポーネント名>: `locale` must be a valid BCP 47 language tag, received ....`` |
|
|
507
578
|
| `YearSelector` / `MonthSelector` / `DateSelector` | `value` と `initialDate` が共に未指定 | `RangeError: <コンポーネント名>: either \`value\` (controlled) or \`initialDate\` (uncontrolled) is required; ...` |
|
|
508
579
|
| `YearSelector` | 境界の欠落・矛盾、Date / 年 Props の不正値 | `RangeError` |
|
|
509
|
-
| `MonthSelector` | 境界の矛盾、`allowedMonths` を伴わない `variant="dropdown"` での境界の欠落、`allowedMonths` の要素が Invalid Date (添字付きで報告)、Date / 年 Props の不正値 | ``RangeError: MonthSelector: `allowedMonths[1]` must be a valid Date, received ....`` 等 |
|
|
580
|
+
| `MonthSelector` | 境界の矛盾、`allowedMonths` を伴わない `variant="dropdown"` での境界の欠落、`allowedMonths` の要素が Invalid Date または `Date` でない (添字付きで報告)、Date / 年 Props の不正値 | ``RangeError: MonthSelector: `allowedMonths[1]` must be a valid Date, received ....`` 等 |
|
|
510
581
|
| `DateSelector` | Date / 年 Props の不正値、解決後の範囲が空、バリアントが要求する境界の欠落、`variant="split-dropdown"` への `allowedDates` 指定 | `RangeError` |
|
|
511
582
|
|
|
512
583
|
`DateSelector` は構成そのものの矛盾を優先して報告します。`variant="split-dropdown"` と `allowedDates` の併用は、`value` / `initialDate` の欠落よりも先に判定されます。
|
|
@@ -708,7 +779,7 @@ export function SelectorsExample() {
|
|
|
708
779
|
| `locale` | `string` | `undefined` | 選択肢テキストのロケール (BCP 47 言語タグ)。未指定は 4 桁ゼロ埋めの年、指定時は `Intl.DateTimeFormat` 書式。空文字列・不正タグ・非文字列は `RangeError` |
|
|
709
780
|
| `unit` | `"year" \| "month" \| "day"` | `undefined` | **不活性 Props**。フックの `SelectorProps` をスプレッドするための受け口で、描画・挙動には一切影響しない |
|
|
710
781
|
|
|
711
|
-
下限 (`minYear` または `minDate`) と上限 (`maxYear` または `maxDate`) は共に必須です。境界外の年を保持している間は、境界へ丸めず・`RangeError` も送出せず、その年を選択肢へ 1
|
|
782
|
+
下限 (`minYear` または `minDate`) と上限 (`maxYear` または `maxDate`) は共に必須です。境界外の年を保持している間は、境界へ丸めず・`RangeError` も送出せず、その年を選択肢へ 1 件加えてそのまま表示します。ステッパーは移動先の年が境界内にある場合だけ有効です (境界の 1 つ外側では戻る側だけが有効、それより外では両方とも `disabled`)。境界外の年が `onChange` へ渡ることはありません。
|
|
712
783
|
|
|
713
784
|
#### `MonthSelector` Props
|
|
714
785
|
|
|
@@ -798,9 +869,9 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
798
869
|
|
|
799
870
|
### React フック
|
|
800
871
|
|
|
801
|
-
|
|
872
|
+
4 つのフックはいずれもステート、更新関数、および `PeriodSlider` / セレクタへそのままスプレッドできる Props を返します。境界・初期値は必須で、欠落・Invalid Date・逆転はすべて `RangeError` です。ノギスは選択形態ごとに 1 つずつ用意されており、`useVernierSlider` がミクロ期間、`useVernierSliderPoint` がミクロ時点を受け持ちます。
|
|
802
873
|
|
|
803
|
-
`setRange` / `setValue` / `setMacroRange` / `setMicroRange` はステートを置き換えるだけでコールバックを発火しません。それ以外の更新関数 (`setLowerDate`, `shiftRange`, `resetRange`, `setMicroUpperDate`, `shiftMacroRange`, `resetVernier` 等) は対応する `onChange*` を発火します。
|
|
874
|
+
`setRange` / `setValue` / `setMacroRange` / `setMicroRange` / `setMicroValue` はステートを置き換えるだけでコールバックを発火しません。それ以外の更新関数 (`setLowerDate`, `shiftRange`, `resetRange`, `setMicroUpperDate`, `setMicroDate`, `shiftMacroRange`, `shiftMicroValue`, `resetVernier` 等) は対応する `onChange*` を発火します。
|
|
804
875
|
|
|
805
876
|
#### 共通: `SelectorProps`
|
|
806
877
|
|
|
@@ -893,7 +964,41 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
893
964
|
| `macroEndSelectorProps` | `SelectorProps` | マクロ終了日セレクタ用 Props |
|
|
894
965
|
| `microStartSelectorProps` | `SelectorProps` | ミクロ開始日セレクタ用 Props |
|
|
895
966
|
| `microEndSelectorProps` | `SelectorProps` | ミクロ終了日セレクタ用 Props |
|
|
896
|
-
| `sliderProps` | `
|
|
967
|
+
| `sliderProps` | `PeriodSliderVernierRangeProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props |
|
|
968
|
+
|
|
969
|
+
#### `useVernierSliderPoint(options)`
|
|
970
|
+
|
|
971
|
+
マクロ窓はそのままに、ミクロレールが単一の時点を指すノギス用フックです。オプションと返却値は `useVernierSlider` と対になっており、ミクロ側だけがタプルからスカラーへ置き換わります。
|
|
972
|
+
|
|
973
|
+
| オプション | 型 | 既定値 | 説明 |
|
|
974
|
+
| :--- | :--- | :--- | :--- |
|
|
975
|
+
| `unit` | `PeriodSliderUnit` | (必須) | 基本時間解像度単位 |
|
|
976
|
+
| `minDate` | `Date` | (必須) | 全期間マクロの下限日付 |
|
|
977
|
+
| `maxDate` | `Date` | (必須) | 全期間マクロの上限日付 (`minDate` より厳密に後) |
|
|
978
|
+
| `initialMacroRange` | `[Date, Date]` | (必須) | 初期マクロ表示窓 [開始, 終了] |
|
|
979
|
+
| `initialMicroValue` | `Date` | (必須) | 初期ミクロ選択時点 (初期マクロ窓の内側) |
|
|
980
|
+
| `macroUnit` | `PeriodSliderUnit` | `unit` | マクロ側時間解像度単位 |
|
|
981
|
+
| `microUnit` | `PeriodSliderUnit` | `unit` | ミクロ側時間解像度単位 |
|
|
982
|
+
| `onChangeMacroRange` | `(lower: Date, upper: Date) => void` | `undefined` | マクロ窓変更時コールバック |
|
|
983
|
+
| `onChangeMicroPoint` | `(value: Date) => void` | `undefined` | ミクロ時点変更時コールバック |
|
|
984
|
+
| その他 | — | — | 上記および `mode` / `macroRange` を除く `PeriodSlider` の Vernier 共通 Props をすべて受け取り、`sliderProps` へそのまま転送 |
|
|
985
|
+
|
|
986
|
+
| 返却値 | 型 | 説明 |
|
|
987
|
+
| :--- | :--- | :--- |
|
|
988
|
+
| `macroRange` | `[Date, Date]` | 現在のマクロ表示窓タプル |
|
|
989
|
+
| `setMacroRange` | `React.Dispatch<React.SetStateAction<[Date, Date]>>` | マクロ窓の直接更新関数 |
|
|
990
|
+
| `microValue` | `Date` | 現在のミクロ選択時点 |
|
|
991
|
+
| `setMicroValue` | `React.Dispatch<React.SetStateAction<Date>>` | ミクロ時点の直接更新関数 |
|
|
992
|
+
| `setMacroLowerDate` | `(date: Date) => void` | マクロ開始日更新関数。`minDate` より前は `minDate` へ収め、マクロ上限を超えた場合は上限も追従 |
|
|
993
|
+
| `setMacroUpperDate` | `(date: Date) => void` | マクロ終了日更新関数。`maxDate` より後は `maxDate` へ収め、マクロ下限を下回った場合は下限も追従 |
|
|
994
|
+
| `setMicroDate` | `(date: Date) => void` | ミクロ時点更新関数。マクロ窓の外はマクロ窓の境界へ収める |
|
|
995
|
+
| `shiftMacroRange` | `(delta: number) => void` | マクロ窓を `delta` マクロ単位シフト。窓幅を保つため、片側でも `[minDate, maxDate]` を越えるシフトは全体を中止する (クランプしない) |
|
|
996
|
+
| `shiftMicroValue` | `(delta: number) => void` | ミクロ時点を `delta` ミクロ単位シフトし、マクロ窓へクランプする。時点には保つべき幅が無いため、`shiftMicroRange` と違い端で中止せず端へ着ける。`microIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`microAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、現在のマクロ窓に候補が 1 つも無い場合は連続スライダーと同じ 1 単位シフトへ退化する (送出しない) |
|
|
997
|
+
| `resetVernier` | `() => void` | マクロ窓・ミクロ時点の双方を初期値へ復帰 |
|
|
998
|
+
| `macroStartSelectorProps` | `SelectorProps` | マクロ開始日セレクタ用 Props |
|
|
999
|
+
| `macroEndSelectorProps` | `SelectorProps` | マクロ終了日セレクタ用 Props |
|
|
1000
|
+
| `microSelectorProps` | `SelectorProps` | ミクロ時点セレクタ用 Props (`maxDate` は実効マクロ窓終端) |
|
|
1001
|
+
| `sliderProps` | `PeriodSliderVernierPointProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props |
|
|
897
1002
|
|
|
898
1003
|
## ライセンス
|
|
899
1004
|
|
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 モードの判別可能合併型。
|
|
@@ -446,7 +486,12 @@ export declare const calculateLabelSlant: (lowPct: number, highPct: number, trac
|
|
|
446
486
|
* Grabbable part of a vernier slider, naming both the rail and the element on it.
|
|
447
487
|
* ノギススライダーで掴める部位 (レールと要素の組)。
|
|
448
488
|
*/
|
|
449
|
-
export type VernierHandle = "macro-low" | "macro-high" | "macro-connect" | "micro-low" | "micro-high" | "micro-connect";
|
|
489
|
+
export type VernierHandle = "macro-low" | "macro-high" | "macro-connect" | "micro-low" | "micro-high" | "micro-connect" | "micro-point";
|
|
490
|
+
/**
|
|
491
|
+
* What the vernier micro rail selects: a period spanned by two handles, or a point held by one.
|
|
492
|
+
* ノギスのミクロレールが選ぶ対象 (2 つのつまみが張る期間か、1 つのつまみが指す時点か)。
|
|
493
|
+
*/
|
|
494
|
+
export type VernierMicroShape = "range" | "point";
|
|
450
495
|
/**
|
|
451
496
|
* Resolves the target Vernier handle based on pointer primary-axis ratio and cross-axis offset relative to track center.
|
|
452
497
|
* トラック中心線に対するポインターの直交軸オフセットと主軸比率から、操作対象となるノギスハンドル(マクロまたはミクロ)を判定します。
|
|
@@ -460,9 +505,10 @@ export type VernierHandle = "macro-low" | "macro-high" | "macro-connect" | "micr
|
|
|
460
505
|
* @param orientation - Which rail the macro scale is drawn on (default: "macro-top") / マクロスケールを描くレール (既定: "macro-top")
|
|
461
506
|
* @param handleHitSlopRatio - Hit slop around a knob as a 0-1 ratio (default: 0.05) / つまみ周辺の当たり判定余裕 (0-1 比率、既定: 0.05)
|
|
462
507
|
* @param allowConnectHandles - Whether a press inside a band may grab the band itself (default: true) / 帯の内側の押下で帯自体を掴めるか (既定: true)
|
|
508
|
+
* @param microShape - What the micro rail selects (default: "range") / ミクロレールの選択対象 (既定: "range")
|
|
463
509
|
* @returns Handle the press targets / 押下が対象とするハンドル
|
|
464
510
|
*/
|
|
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;
|
|
511
|
+
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
512
|
/**
|
|
467
513
|
* Calculates updated macro window range when dragging a macro handle or connect bar, supporting crossover swapping.
|
|
468
514
|
* マクロハンドルまたはコネクトバードラッグ時の新マクロ範囲を算出します (上限下限反転スワップ対応)。
|
|
@@ -479,14 +525,18 @@ export declare function calculateVernierMacroDrag(handle: "macro-low" | "macro-h
|
|
|
479
525
|
* Calculates updated micro selection range when dragging a micro handle or connect bar, supporting crossover swapping.
|
|
480
526
|
* ミクロハンドルまたはコネクトバードラッグ時の新ミクロ範囲を算出します (上限下限反転スワップ対応)。
|
|
481
527
|
*
|
|
482
|
-
*
|
|
528
|
+
* A point handle carries no width, so it resolves to the bare clamped pointer ratio in both tuple slots:
|
|
529
|
+
* that is what keeps the degenerate selection degenerate for the whole drag.
|
|
530
|
+
* 時点つまみは幅を持たないため、両スロットともクランプ済みポインター比率そのものとなり、ドラッグ中ずっと幅ゼロが保たれる。
|
|
531
|
+
*
|
|
532
|
+
* @param handle - Dragged micro handle, connect bar or point handle
|
|
483
533
|
* @param pointerRatio - Current pointer ratio across track (0.0 - 1.0)
|
|
484
534
|
* @param startPointerRatio - Initial pointer ratio at drag start
|
|
485
535
|
* @param startMicroLowRatio - Initial micro low ratio at drag start
|
|
486
536
|
* @param startMicroHighRatio - Initial micro high ratio at drag start
|
|
487
537
|
* @returns Tuple of [nextLowRatio, nextHighRatio, activeHandle]
|
|
488
538
|
*/
|
|
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"];
|
|
539
|
+
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
540
|
/**
|
|
491
541
|
* SVG vector semicircle knob for Vernier caliper handles.
|
|
492
542
|
* Rendered using mathematical arc commands to guarantee perfectly smooth round edges without raster distortion.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"PeriodSlider.d.ts","sourceRoot":"","sources":["../src/PeriodSlider.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"PeriodSlider.d.ts","sourceRoot":"","sources":["../src/PeriodSlider.tsx"],"names":[],"mappings":"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"}
|