@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.
@@ -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
+ }