@aiquants/period-slider 0.2.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/LICENSE +21 -0
- package/README.md +389 -0
- package/dist/DateSelector.d.ts +45 -0
- package/dist/DateSelector.d.ts.map +1 -0
- package/dist/MonthSelector.d.ts +43 -0
- package/dist/MonthSelector.d.ts.map +1 -0
- package/dist/PeriodSlider.d.ts +384 -0
- package/dist/PeriodSlider.d.ts.map +1 -0
- package/dist/YearSelector.d.ts +36 -0
- package/dist/YearSelector.d.ts.map +1 -0
- package/dist/index.cjs +1 -0
- package/dist/index.d.ts +21 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +1770 -0
- package/dist/period-slider.css +1 -0
- package/dist/styles/period-slider.css +2 -0
- package/dist/styles/period-slider.standalone.css +3 -0
- package/dist/usePeriodSlider.d.ts +213 -0
- package/dist/usePeriodSlider.d.ts.map +1 -0
- package/package.json +98 -0
- package/src/DateSelector.tsx +414 -0
- package/src/MonthSelector.tsx +303 -0
- package/src/PeriodSlider.tsx +2557 -0
- package/src/YearSelector.tsx +168 -0
- package/src/index.ts +67 -0
- package/src/styles/components.entry.css +10 -0
- package/src/styles/period-slider.css +910 -0
- package/src/styles/standalone.entry.css +10 -0
- package/src/usePeriodSlider.ts +692 -0
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
import type React from "react"
|
|
2
|
+
import { memo, useEffect, useMemo, useState } from "react"
|
|
3
|
+
import type { PeriodSliderUnit } from "./PeriodSlider"
|
|
4
|
+
|
|
5
|
+
export interface YearSelectorProps {
|
|
6
|
+
/** Controlled selected date / 選択日付(外部制御用) */
|
|
7
|
+
value?: Date
|
|
8
|
+
/** Initial selected date (defaults to current date) / 選択日付(未指定時は現在日) */
|
|
9
|
+
initialDate?: Date
|
|
10
|
+
/** Time resolution unit (ignored by selector, accepted for hook interoperability) / 時間解像度単位 (フック相互運用用) */
|
|
11
|
+
unit?: PeriodSliderUnit
|
|
12
|
+
/** Callback triggered when year changes / 年変更時コールバック */
|
|
13
|
+
onChange?(date: Date, year: number): void
|
|
14
|
+
/** Child elements / 子要素 */
|
|
15
|
+
children?: React.ReactNode
|
|
16
|
+
/** Minimum selectable year / ドロップダウン・可能範囲の最小年 */
|
|
17
|
+
minYear?: number
|
|
18
|
+
/** Maximum selectable year / ドロップダウン・可能範囲の最大年 */
|
|
19
|
+
maxYear?: number
|
|
20
|
+
/** Minimum selectable date / 選択可能範囲の最小日付 */
|
|
21
|
+
minDate?: Date
|
|
22
|
+
/** Maximum selectable date / 選択可能範囲の最大日付 */
|
|
23
|
+
maxDate?: Date
|
|
24
|
+
/** Additional CSS class name / 追加の CSS クラス名 */
|
|
25
|
+
className?: string
|
|
26
|
+
/** Custom styles / スタイル */
|
|
27
|
+
style?: React.CSSProperties
|
|
28
|
+
/** Disabled flag / 無効化フラグ */
|
|
29
|
+
disabled?: boolean
|
|
30
|
+
/** Accessible label for previous year button / 前年ボタンのアクセシブル名 */
|
|
31
|
+
prevYearAriaLabel?: string
|
|
32
|
+
/** Accessible label for next year button / 翌年ボタンのアクセシブル名 */
|
|
33
|
+
nextYearAriaLabel?: string
|
|
34
|
+
/** Accessible label for year select combobox / 会計年セレクトのアクセシブル名 */
|
|
35
|
+
selectAriaLabel?: string
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Year selector component supporting min/max boundaries and stepper buttons (◀▶).
|
|
40
|
+
* 年(会計年)セレクタ共通コンポーネント。
|
|
41
|
+
* 中央のドロップダウン (`<select>`) と両脇のステッパーボタン (◀▶) で ±1 年を変更可能。
|
|
42
|
+
*/
|
|
43
|
+
const YearSelectorComponent = (props: YearSelectorProps): React.JSX.Element => {
|
|
44
|
+
const { value, initialDate, onChange, children, minYear, maxYear, minDate, maxDate, className = "", style, disabled = false, prevYearAriaLabel = "前年", nextYearAriaLabel = "翌年", selectAriaLabel = "会計年" } = props
|
|
45
|
+
const effectiveDate = value ?? initialDate
|
|
46
|
+
const [year, setYear] = useState<number>(() => (effectiveDate ?? new Date()).getFullYear())
|
|
47
|
+
|
|
48
|
+
const minTime = minDate?.getTime()
|
|
49
|
+
const maxTime = maxDate?.getTime()
|
|
50
|
+
|
|
51
|
+
const minYearBound = useMemo(() => {
|
|
52
|
+
if (minYear !== undefined) return minYear
|
|
53
|
+
if (minDate) return minDate.getFullYear()
|
|
54
|
+
return undefined
|
|
55
|
+
}, [minYear, minTime])
|
|
56
|
+
|
|
57
|
+
const maxYearBound = useMemo(() => {
|
|
58
|
+
if (maxYear !== undefined) return maxYear
|
|
59
|
+
if (maxDate) return maxDate.getFullYear()
|
|
60
|
+
return undefined
|
|
61
|
+
}, [maxYear, maxTime])
|
|
62
|
+
|
|
63
|
+
const isControlled = value !== undefined
|
|
64
|
+
const currentYear = isControlled ? (value && !Number.isNaN(value.getTime()) ? value.getFullYear() : (minYearBound ?? new Date().getFullYear())) : year
|
|
65
|
+
|
|
66
|
+
// 外部からの value または initialDate 変更に追従
|
|
67
|
+
const effectiveTime = effectiveDate?.getTime()
|
|
68
|
+
useEffect(() => {
|
|
69
|
+
if (!isControlled && effectiveDate && !Number.isNaN(effectiveDate.getTime())) {
|
|
70
|
+
setYear(effectiveDate.getFullYear())
|
|
71
|
+
}
|
|
72
|
+
}, [isControlled, effectiveTime])
|
|
73
|
+
|
|
74
|
+
const emit = (nextYear: number) => {
|
|
75
|
+
if (disabled) return
|
|
76
|
+
let clamped = nextYear
|
|
77
|
+
if (minYearBound !== undefined && clamped < minYearBound) {
|
|
78
|
+
clamped = minYearBound
|
|
79
|
+
}
|
|
80
|
+
if (maxYearBound !== undefined && clamped > maxYearBound) {
|
|
81
|
+
clamped = maxYearBound
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
if (!isControlled) {
|
|
85
|
+
setYear(clamped)
|
|
86
|
+
}
|
|
87
|
+
const nextDate = new Date(clamped, 0, 1)
|
|
88
|
+
nextDate.setFullYear(clamped)
|
|
89
|
+
onChange?.(nextDate, clamped)
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
const isPrevDisabled = disabled || (minYearBound !== undefined && currentYear - 1 < minYearBound)
|
|
93
|
+
const isNextDisabled = disabled || (maxYearBound !== undefined && currentYear + 1 > maxYearBound)
|
|
94
|
+
|
|
95
|
+
const lower = minYearBound ?? Math.min(currentYear - 10, currentYear)
|
|
96
|
+
const upper = maxYearBound ?? Math.max(currentYear + 1, currentYear)
|
|
97
|
+
const start = Math.min(lower, currentYear)
|
|
98
|
+
const end = Math.max(upper, currentYear)
|
|
99
|
+
const yearsKey = `${start}_${end}`
|
|
100
|
+
|
|
101
|
+
const years = useMemo(() => {
|
|
102
|
+
const list: number[] = []
|
|
103
|
+
for (let y = end; y >= start; y--) {
|
|
104
|
+
list.push(y)
|
|
105
|
+
}
|
|
106
|
+
return list
|
|
107
|
+
}, [yearsKey])
|
|
108
|
+
|
|
109
|
+
return (
|
|
110
|
+
<div className={`inline-flex w-32 items-center ${className}`} style={style}>
|
|
111
|
+
<button
|
|
112
|
+
type="button"
|
|
113
|
+
aria-label={prevYearAriaLabel}
|
|
114
|
+
disabled={isPrevDisabled}
|
|
115
|
+
className="relative my-auto inline-flex h-5 w-4 cursor-pointer items-center justify-center rounded p-0 after:absolute after:inset-[-14px] after:content-[''] focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-600 disabled:opacity-40"
|
|
116
|
+
onClick={() => emit(currentYear - 1)}>
|
|
117
|
+
<span className="h-0 w-0 border-y-[6px] border-y-transparent border-r-[6px] border-r-slate-500 border-solid hover:border-r-slate-700 dark:border-r-slate-400 dark:hover:border-r-slate-200" />
|
|
118
|
+
</button>
|
|
119
|
+
<select
|
|
120
|
+
aria-label={selectAriaLabel}
|
|
121
|
+
disabled={disabled}
|
|
122
|
+
className="mx-1 my-auto w-18 appearance-none rounded-md border border-gray-300 bg-gray-100 px-1 py-0.5 text-center font-mono text-gray-900 text-xs tabular-nums [text-align-last:center] [text-align:center] focus:border-blue-500 focus:ring-blue-500 disabled:opacity-50 dark:border-slate-600 dark:bg-slate-700 dark:text-slate-100 dark:focus:border-blue-500 dark:focus:ring-blue-500"
|
|
123
|
+
value={currentYear}
|
|
124
|
+
onChange={(e) => {
|
|
125
|
+
if (e.target.value) {
|
|
126
|
+
emit(Number(e.target.value))
|
|
127
|
+
}
|
|
128
|
+
}}>
|
|
129
|
+
{years.map((y) => (
|
|
130
|
+
<option key={y} value={y} className="text-center font-mono text-gray-900 tabular-nums [text-align-last:center] [text-align:center] dark:bg-slate-700 dark:text-slate-100">
|
|
131
|
+
{y}
|
|
132
|
+
</option>
|
|
133
|
+
))}
|
|
134
|
+
</select>
|
|
135
|
+
<button
|
|
136
|
+
type="button"
|
|
137
|
+
aria-label={nextYearAriaLabel}
|
|
138
|
+
disabled={isNextDisabled}
|
|
139
|
+
className="relative my-auto inline-flex h-5 w-4 cursor-pointer items-center justify-center rounded p-0 after:absolute after:inset-[-14px] after:content-[''] focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-600 disabled:opacity-40"
|
|
140
|
+
onClick={() => emit(currentYear + 1)}>
|
|
141
|
+
<span className="h-0 w-0 border-y-[6px] border-y-transparent border-l-[6px] border-l-slate-500 border-solid hover:border-l-slate-700 dark:border-l-slate-400 dark:hover:border-l-slate-200" />
|
|
142
|
+
</button>
|
|
143
|
+
{children}
|
|
144
|
+
</div>
|
|
145
|
+
)
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
export const YearSelector = memo(YearSelectorComponent, (prev, next) => {
|
|
149
|
+
const prevDate = prev.value ?? prev.initialDate
|
|
150
|
+
const nextDate = next.value ?? next.initialDate
|
|
151
|
+
const prevYear = prevDate && !Number.isNaN(prevDate.getTime()) ? prevDate.getFullYear() : null
|
|
152
|
+
const nextYear = nextDate && !Number.isNaN(nextDate.getTime()) ? nextDate.getFullYear() : null
|
|
153
|
+
if (prevYear !== nextYear) return false
|
|
154
|
+
if (prev.disabled !== next.disabled) return false
|
|
155
|
+
if (prev.className !== next.className) return false
|
|
156
|
+
if (prev.style !== next.style) return false
|
|
157
|
+
if (prev.minYear !== next.minYear) return false
|
|
158
|
+
if (prev.maxYear !== next.maxYear) return false
|
|
159
|
+
if (prev.minDate?.getFullYear() !== next.minDate?.getFullYear()) return false
|
|
160
|
+
if (prev.maxDate?.getFullYear() !== next.maxDate?.getFullYear()) return false
|
|
161
|
+
if (prev.onChange !== next.onChange) return false
|
|
162
|
+
if (prev.children !== next.children) return false
|
|
163
|
+
if (prev.prevYearAriaLabel !== next.prevYearAriaLabel) return false
|
|
164
|
+
if (prev.nextYearAriaLabel !== next.nextYearAriaLabel) return false
|
|
165
|
+
if (prev.selectAriaLabel !== next.selectAriaLabel) return false
|
|
166
|
+
return true
|
|
167
|
+
})
|
|
168
|
+
YearSelector.displayName = "YearSelector"
|
package/src/index.ts
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Period Slider and Date Selectors Package
|
|
3
|
+
* @package @aiquants/period-slider
|
|
4
|
+
*
|
|
5
|
+
* This package provides range and point period slider components as well as
|
|
6
|
+
* specialized year, month, and date selector inputs for time series analysis and navigation.
|
|
7
|
+
*
|
|
8
|
+
* このパッケージは、時系列分析や期間移動のためのレンジ・ポイント期間スライダーコンポーネント、
|
|
9
|
+
* および年・年月・年月日セレクタを提供します。
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
export type { DateSelectorProps } from "./DateSelector"
|
|
13
|
+
export { DateSelector } from "./DateSelector"
|
|
14
|
+
export type { MonthSelectorProps } from "./MonthSelector"
|
|
15
|
+
export { MonthSelector } from "./MonthSelector"
|
|
16
|
+
export type {
|
|
17
|
+
AccessibleSliderLabels,
|
|
18
|
+
BasePeriodSliderProps,
|
|
19
|
+
ColorSchemePalette,
|
|
20
|
+
LabelSlantConfig,
|
|
21
|
+
LabelSlantResult,
|
|
22
|
+
PeriodSliderColorScheme,
|
|
23
|
+
PeriodSliderLabelPosition,
|
|
24
|
+
PeriodSliderPointProps,
|
|
25
|
+
PeriodSliderProps,
|
|
26
|
+
PeriodSliderRangeProps,
|
|
27
|
+
PeriodSliderUnit,
|
|
28
|
+
PeriodSliderVernierProps,
|
|
29
|
+
VernierHandle,
|
|
30
|
+
} from "./PeriodSlider"
|
|
31
|
+
export {
|
|
32
|
+
addUnit,
|
|
33
|
+
COLOR_SCHEME_PALETTES,
|
|
34
|
+
calculateConnectDragValues,
|
|
35
|
+
calculateHandleDragValues,
|
|
36
|
+
calculateKeyboardActionValues,
|
|
37
|
+
calculateLabelSlant,
|
|
38
|
+
calculateVernierMacroDrag,
|
|
39
|
+
decode,
|
|
40
|
+
encode,
|
|
41
|
+
findNearestDateIndex,
|
|
42
|
+
formatLabel,
|
|
43
|
+
formatScreenReaderLabel,
|
|
44
|
+
getMacroWindowEndDate,
|
|
45
|
+
getSortedAllowedDates,
|
|
46
|
+
normalizeDateByUnit,
|
|
47
|
+
PeriodSlider,
|
|
48
|
+
resolveVernierTargetHandle,
|
|
49
|
+
} from "./PeriodSlider"
|
|
50
|
+
// ======================================================================
|
|
51
|
+
// State Management Hooks (Zero-Boilerplate React Hooks)
|
|
52
|
+
// ======================================================================
|
|
53
|
+
export type {
|
|
54
|
+
UsePeriodSliderPointOptions,
|
|
55
|
+
UsePeriodSliderPointReturn,
|
|
56
|
+
UsePeriodSliderRangeOptions,
|
|
57
|
+
UsePeriodSliderRangeReturn,
|
|
58
|
+
UseVernierSliderOptions,
|
|
59
|
+
UseVernierSliderReturn,
|
|
60
|
+
} from "./usePeriodSlider"
|
|
61
|
+
export {
|
|
62
|
+
usePeriodSliderPoint,
|
|
63
|
+
usePeriodSliderRange,
|
|
64
|
+
useVernierSlider,
|
|
65
|
+
} from "./usePeriodSlider"
|
|
66
|
+
export type { YearSelectorProps } from "./YearSelector"
|
|
67
|
+
export { YearSelector } from "./YearSelector"
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* Artifact A: components-only CSS (Tailwind ホスト向け).
|
|
3
|
+
* 手書きコンポーネントクラスのみ (@apply は theme(reference) で
|
|
4
|
+
* var(--token, fallback) 形式に解決される)。
|
|
5
|
+
* :root テーマ変数・ユーティリティ・preflight を含まない。
|
|
6
|
+
*/
|
|
7
|
+
@import "tailwindcss/theme.css" theme(reference);
|
|
8
|
+
@layer components {
|
|
9
|
+
@import "./period-slider.css";
|
|
10
|
+
}
|