@typescript-calendar-lib/react 0.5.4 → 0.6.1

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 CHANGED
@@ -86,7 +86,7 @@ export function CalendarPanel() {
86
86
  | `year` | `number` | — (required) | Calendar year |
87
87
  | `month` | `number` | — (required) | Month, 1-indexed (`1`–`12`) |
88
88
  | `locale` | `"en" \| "ja" \| "es" \| "de" \| "fr" \| "ko" \| "zh"` | `"en"` | Language |
89
- | `holidayLocale` | `"en" \| "ja" \| "es" \| "de" \| "fr" \| "ko" \| "zh"` | `"ja"` | Holiday rules; currently only `"ja"` is provided |
89
+ | `holidayLocale` | `"en" \| "ja" \| "es" \| "de" \| "fr" \| "ko" \| "zh"` | `"ja"` | Holiday rules (fixed-date holidays for every locale; moving holidays such as Easter are not included) |
90
90
  | `weekStart` | `"sunday" \| "monday"` | `"sunday"` | First day of the week |
91
91
  | `highlight` | `Date` | — | Date to highlight |
92
92
  | `range` | `{ from: Date; to: Date }` | — | Dates to emphasize |
package/dist/index.d.ts CHANGED
@@ -72,6 +72,13 @@ export declare function Calendar({ year, month, locale, holidayLocale, weekStart
72
72
  interface UseCalendarStateOptions extends Pick<CalendarStateOptions, "locale" | "holidayLocale" | "weekStart" | "today" | "highlight" | "range" | "isDateDisabled" | "selectionMode"> {
73
73
  initialYear?: number;
74
74
  initialMonth?: number;
75
+ /**
76
+ * 制御モードの表示年。指定すると `initialYear` より優先され、値が変わるたびに
77
+ * その年月へ再構築される。月移動は内部状態を変えず `onMonthChange` に通知する。
78
+ */
79
+ year?: number;
80
+ /** 制御モードの表示月 (1–12)。`year` と併用する */
81
+ month?: number;
75
82
  /** 表示中の年月が変わったときに呼ばれる */
76
83
  onMonthChange?: (year: number, month: number) => void;
77
84
  }
@@ -132,6 +139,10 @@ interface InteractiveCalendarProps {
132
139
  initialYear?: number;
133
140
  /** 表示開始月 (1-12)。範囲外は正規化される */
134
141
  initialMonth?: number;
142
+ /** 制御モードの表示年。指定すると initialYear より優先され、月移動は onMonthChange に委譲される */
143
+ year?: number;
144
+ /** 制御モードの表示月 (1-12) */
145
+ month?: number;
135
146
  locale?: CalendarOptions["locale"];
136
147
  holidayLocale?: CalendarOptions["holidayLocale"];
137
148
  weekStart?: CalendarOptions["weekStart"];
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { COLOR_SCHEMES, THEMES, buildSizeStyle, formatCellLabel, getBlankClasses, getBlankClasses as getBlankClasses$1, getCellClasses, getCellStateClasses, getCellStateClasses as getCellStateClasses$1, getSelectionCellClasses, getSelectionCellClasses as getSelectionCellClasses$1, isSizeName, joinCellClassLists, joinCellClassLists as joinCellClassLists$1, mergeColorScheme, resolveColorScheme, resolveTheme, uiString } from "@typescript-calendar-lib/web";
2
- import { addDays, buildMonthGrid, createDate, getCalendarCellState, getISOWeek, getMonthName, getWeekOfYear, getWeekdayHeaders, isSameDay, sortRange as buildRangePreview } from "@typescript-calendar-lib/core";
2
+ import { addDays, buildMonthGrid, createDate, getCalendarCellState, getISOWeek, getMonthName, getWeekOfYear, getWeekdayHeaders, isSameDay, lastDayOfMonth, sortRange as buildRangePreview } from "@typescript-calendar-lib/core";
3
3
  import { useCallback, useEffect, useId, useMemo, useRef, useState } from "react";
4
4
  import { jsx, jsxs } from "react/jsx-runtime";
5
5
  import { clearSelection, createCalendarState, getCursorDate, getSelectedDate, getSelectedRange, goToDate, goToMonth, goToToday, keyToAction, moveCursor, navigateMonth, navigateYear, sameStateOptions, selectDate, selectDateAt, selectRange, setCursorToDate, updateStateOptions } from "@typescript-calendar-lib/tui";
@@ -138,6 +138,11 @@ function Calendar({ year, month, locale = "en", holidayLocale, weekStart = "sund
138
138
  function useCalendarState(options = {}) {
139
139
  const [state, setState] = useState(() => createCalendarState(options));
140
140
  const [hoveredDate, setHoveredDate] = useState(null);
141
+ const controlled = options.year !== void 0 || options.month !== void 0;
142
+ const controlledRef = useRef(controlled);
143
+ controlledRef.current = controlled;
144
+ const stateRef = useRef(state);
145
+ stateRef.current = state;
141
146
  const prevOptions = useRef(options);
142
147
  useEffect(() => {
143
148
  if (sameStateOptions(prevOptions.current, options)) return;
@@ -158,19 +163,61 @@ function useCalendarState(options = {}) {
158
163
  year: state.year,
159
164
  month: state.month
160
165
  };
161
- onMonthChangeRef.current?.(state.year, state.month);
162
166
  setHoveredDate(null);
167
+ if (!controlledRef.current) onMonthChangeRef.current?.(state.year, state.month);
163
168
  }
164
169
  }, [state.year, state.month]);
165
170
  return {
166
171
  state,
167
172
  moveCursor: useCallback((direction) => setState((prev) => moveCursor(prev, direction)), []),
168
- goNext: useCallback(() => setState((prev) => navigateMonth(prev, "next")), []),
169
- goPrev: useCallback(() => setState((prev) => navigateMonth(prev, "prev")), []),
170
- navigateYear: useCallback((direction) => setState((prev) => navigateYear(prev, direction)), []),
171
- goToMonth: useCallback((year, month) => setState((prev) => goToMonth(prev, year, month)), []),
172
- goToDate: useCallback((date) => setState((prev) => goToDate(prev, date)), []),
173
- goToday: useCallback(() => setState((prev) => goToToday(prev)), []),
173
+ goNext: useCallback(() => {
174
+ if (controlledRef.current) {
175
+ const next = navigateMonth(stateRef.current, "next");
176
+ onMonthChangeRef.current?.(next.year, next.month);
177
+ return;
178
+ }
179
+ setState((prev) => navigateMonth(prev, "next"));
180
+ }, []),
181
+ goPrev: useCallback(() => {
182
+ if (controlledRef.current) {
183
+ const next = navigateMonth(stateRef.current, "prev");
184
+ onMonthChangeRef.current?.(next.year, next.month);
185
+ return;
186
+ }
187
+ setState((prev) => navigateMonth(prev, "prev"));
188
+ }, []),
189
+ navigateYear: useCallback((direction) => {
190
+ if (controlledRef.current) {
191
+ const next = navigateYear(stateRef.current, direction);
192
+ onMonthChangeRef.current?.(next.year, next.month);
193
+ return;
194
+ }
195
+ setState((prev) => navigateYear(prev, direction));
196
+ }, []),
197
+ goToMonth: useCallback((year, month) => {
198
+ if (controlledRef.current) {
199
+ const next = goToMonth(stateRef.current, year, month);
200
+ onMonthChangeRef.current?.(next.year, next.month);
201
+ return;
202
+ }
203
+ setState((prev) => goToMonth(prev, year, month));
204
+ }, []),
205
+ goToDate: useCallback((date) => {
206
+ if (controlledRef.current) {
207
+ const next = goToDate(stateRef.current, date);
208
+ onMonthChangeRef.current?.(next.year, next.month);
209
+ return;
210
+ }
211
+ setState((prev) => goToDate(prev, date));
212
+ }, []),
213
+ goToday: useCallback(() => {
214
+ if (controlledRef.current) {
215
+ const next = goToToday(stateRef.current);
216
+ onMonthChangeRef.current?.(next.year, next.month);
217
+ return;
218
+ }
219
+ setState((prev) => goToToday(prev));
220
+ }, []),
174
221
  selectDate: useCallback(() => setState((prev) => selectDate(prev)), []),
175
222
  setCursorToDate: useCallback((date) => setState((prev) => setCursorToDate(prev, date)), []),
176
223
  selectDateAt: useCallback((date) => setState((prev) => selectDateAt(prev, date)), []),
@@ -195,10 +242,12 @@ function useCalendarState(options = {}) {
195
242
  * Enter/Space(クリックと同じ日付選択)
196
243
  */
197
244
  function InteractiveCalendar(props) {
198
- const { initialYear, initialMonth, locale, holidayLocale, weekStart, showWeekNumbers, selectionMode, highlight, range, today, isDateDisabled, onMonthChange, theme, colorScheme, size, responsive, style, renderCell, cellData, onDateClick, onDateHover, onDateLeave } = props;
245
+ const { initialYear, initialMonth, locale, holidayLocale, weekStart, showWeekNumbers, selectionMode, highlight, range, today, isDateDisabled, year, month, onMonthChange, theme, colorScheme, size, responsive, style, renderCell, cellData, onDateClick, onDateHover, onDateLeave } = props;
199
246
  const hook = useCalendarState({
200
247
  initialYear,
201
248
  initialMonth,
249
+ year,
250
+ month,
202
251
  locale,
203
252
  holidayLocale,
204
253
  weekStart,
@@ -209,7 +258,7 @@ function InteractiveCalendar(props) {
209
258
  isDateDisabled,
210
259
  onMonthChange
211
260
  });
212
- const { state, moveCursor, goPrev, goNext, selectDateAt, setHoveredDate } = hook;
261
+ const { state, moveCursor, goPrev, goNext, navigateYear, setCursorToDate, clearSelection, selectDateAt, setHoveredDate } = hook;
213
262
  const rootRef = useRef(null);
214
263
  const handleDateClick = useCallback((date, data) => {
215
264
  selectDateAt(date);
@@ -232,7 +281,7 @@ function InteractiveCalendar(props) {
232
281
  (rootRef.current?.querySelector("[data-cursor=\"true\"]"))?.focus();
233
282
  }, [state.cursor]);
234
283
  const handleKeyDown = useCallback((e) => {
235
- const action = keyToAction(e.key);
284
+ const action = keyToAction(e.key, e);
236
285
  if (action === void 0) return;
237
286
  e.preventDefault();
238
287
  switch (action) {
@@ -242,12 +291,32 @@ function InteractiveCalendar(props) {
242
291
  case "next":
243
292
  goNext();
244
293
  break;
294
+ case "prevYear":
295
+ navigateYear("prev");
296
+ break;
297
+ case "nextYear":
298
+ navigateYear("next");
299
+ break;
300
+ case "firstDay":
301
+ setCursorToDate(createDate(state.year, state.month - 1, 1));
302
+ break;
303
+ case "lastDay":
304
+ setCursorToDate(lastDayOfMonth(state.year, state.month));
305
+ break;
306
+ case "clear":
307
+ clearSelection();
308
+ break;
245
309
  default: moveCursor(action);
246
310
  }
247
311
  }, [
248
312
  moveCursor,
249
313
  goPrev,
250
- goNext
314
+ goNext,
315
+ navigateYear,
316
+ setCursorToDate,
317
+ clearSelection,
318
+ state.year,
319
+ state.month
251
320
  ]);
252
321
  return /* @__PURE__ */ jsx(Calendar, {
253
322
  ref: rootRef,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["buildSizeStyle","buildSizeStyleBase","buildSizeStyle","getBlankClasses","joinCellClassLists","getCellStateClasses","getSelectionCellClasses"],"sources":["../src/size.ts","../src/Calendar.tsx","../src/hooks.ts","../src/interactive.tsx"],"sourcesContent":["// ─── セルサイズ ───────────────────────────────────────────\n// サイズ判定・CSS 変数変換は web パッケージに集約済み。\n// ここでは React の style 型(CSSProperties)に適合させる薄いアダプタのみ持つ。\n\nimport type { CalendarSize } from \"@typescript-calendar-lib/web\";\nimport type { CSSProperties } from \"react\";\n\nexport type {\n CalendarCustomSize,\n CalendarSize,\n CalendarSizeName,\n} from \"@typescript-calendar-lib/web\";\nexport { isSizeName } from \"@typescript-calendar-lib/web\";\n\nimport { buildSizeStyle as buildSizeStyleBase } from \"@typescript-calendar-lib/web\";\n\n/** セルサイズを CSS 変数スタイル(--cal-cell-w / --cal-cell-h)へ変換する */\nexport function buildSizeStyle(size: CalendarSize): CSSProperties {\n return buildSizeStyleBase(size) as CSSProperties;\n}\n","import type {\n CalendarCellState,\n CalendarOptions,\n} from \"@typescript-calendar-lib/core\";\nimport {\n addDays,\n buildMonthGrid,\n createDate,\n getCalendarCellState,\n getISOWeek,\n getMonthName,\n getWeekdayHeaders,\n getWeekOfYear,\n isSameDay,\n} from \"@typescript-calendar-lib/core\";\nimport {\n formatCellLabel,\n getBlankClasses,\n getCellStateClasses,\n getSelectionCellClasses,\n joinCellClassLists,\n uiString,\n} from \"@typescript-calendar-lib/web\";\nimport type {\n CSSProperties,\n KeyboardEvent as ReactKeyboardEvent,\n ReactNode,\n Ref,\n} from \"react\";\nimport { useId, useMemo } from \"react\";\nimport type { CalendarSize } from \"./size.ts\";\nimport { buildSizeStyle, isSizeName } from \"./size.ts\";\nimport type {\n ColorSchemeName,\n ReactColorScheme,\n ReactTheme,\n ThemeName,\n} from \"./themes.ts\";\nimport { mergeColorScheme, resolveTheme } from \"./themes.ts\";\n\nexport type {\n CalendarCustomSize,\n CalendarSize,\n CalendarSizeName,\n} from \"./size.ts\";\n\nexport interface CalendarProps {\n year: number;\n month: number;\n locale?: CalendarOptions[\"locale\"];\n holidayLocale?: CalendarOptions[\"holidayLocale\"];\n weekStart?: CalendarOptions[\"weekStart\"];\n /** 各週の先頭に週番号(ISO/年始基準)を表示する。既定は false */\n showWeekNumbers?: boolean;\n highlight?: Date;\n /** 範囲強調 */\n range?: { from: Date; to: Date };\n /** 今日の基準日。カラースキームの today 着色に使用 */\n today?: Date;\n /** 範囲プレビュー(ホバー等の候補範囲)。is-in-range-preview クラスで視覚化される */\n rangePreview?: { from: Date; to: Date };\n /** 見た目テーマ。既定は \"default\" */\n theme?: ThemeName | ReactTheme;\n /** カラースキーム。既定は \"default\" */\n colorScheme?: ColorSchemeName | ReactColorScheme;\n /** セルサイズ。既定は \"md\"。{ width, height } で自由に指定できる */\n size?: CalendarSize;\n /** 狭い画面(スマホ等)でセルサイズと余白を自動調整する。既定は false(無効) */\n responsive?: boolean;\n /** root 要素に追加するスタイル。CSS変数(--cal-*)で自由に上書きできる */\n style?: CSSProperties;\n\n // ── インタラクション ──\n\n /** インタラクティブモードを有効にする。セルクリック・ホバー・キーボード選択が可能になる */\n interactive?: boolean;\n /** セルクリック時のコールバック。第2引数に該当日のデータ(cellData の戻り値)が渡る */\n onDateClick?: (date: Date, data?: unknown) => void;\n /** セルホバー時のコールバック */\n onDateHover?: (date: Date) => void;\n /** カレンダーからマウスが離れたときのコールバック */\n onDateLeave?: () => void;\n /** キーボード操作。root 要素で発火(矢印キー等を InteractiveCalendar が処理する) */\n onKeyDown?: (event: ReactKeyboardEvent<HTMLDivElement>) => void;\n\n // ── セル状態 ──\n\n /** 選択済み日付。aria-selected・aria-pressed と表示スタイルに使用 */\n selectedDate?: Date | null;\n /** カーソル位置の日付。このセルだけ tabIndex=0(roving tabindex)になる */\n cursorDate?: Date | null;\n /** ホバー中の日付。is-hovered クラスで視覚化される */\n hoveredDate?: Date | null;\n /** セル内容のカスタムレンダリング。interactive 時は button の子として描画される。第4引数に該当日のデータが渡る */\n renderCell?: (\n day: number,\n date: Date,\n state: CalendarCellState,\n data?: unknown,\n ) => ReactNode;\n /** 各セルに付与するユーザー定義データを解決する関数。実セルのみに呼ばれる */\n cellData?: (date: Date) => unknown;\n /** 選択不可日付の判定。true を返した日付は is-disabled クラスになり、インタラクティブ時は選択・ホバーできなくなる */\n isDateDisabled?: (date: Date) => boolean;\n\n /** root 要素への ref(React 19 の ref-as-prop) */\n ref?: Ref<HTMLDivElement>;\n}\n\n/** 月カレンダーコンポーネント */\nexport function Calendar({\n year,\n month,\n locale = \"en\",\n holidayLocale,\n weekStart = \"sunday\",\n showWeekNumbers = false,\n highlight,\n range,\n today,\n theme = \"default\",\n colorScheme = \"default\",\n size = \"md\",\n responsive = false,\n style,\n interactive = false,\n onDateClick,\n onDateHover,\n onDateLeave,\n onKeyDown,\n selectedDate = null,\n cursorDate = null,\n hoveredDate = null,\n renderCell,\n cellData,\n isDateDisabled,\n rangePreview,\n ref,\n}: CalendarProps) {\n // グリッドは月単位で不変。ホバー・選択の再描画でも再計算しない\n const grid = useMemo(\n () => buildMonthGrid(year, month, weekStart),\n [year, month, weekStart],\n );\n\n const handleCellClick = (date: Date, data?: unknown) => {\n if (interactive && onDateClick) onDateClick(date, data);\n };\n\n const handleCellHover = (date: Date) => {\n if (interactive && onDateHover) onDateHover(date);\n };\n\n const handleMouseLeave = () => {\n if (interactive && onDateLeave) onDateLeave();\n };\n\n const title = `${getMonthName(locale, month)} ${year}`;\n // 週番号の行ヘッダー(scope=\"row\")用ラベル。行ごとに一意の名前にするため\n // 番号を含める(aria-label が内容の数字を上書きしないように)\n const weekLabel = uiString(\"weekNumber\", locale);\n const weekOf = (row: (number | null)[]): number | null => {\n const firstIdx = row.findIndex((d) => d !== null);\n if (firstIdx === -1) return null;\n const firstDate = createDate(year, month - 1, row[firstIdx]!);\n const weekStartDate = addDays(firstDate, -firstIdx);\n return weekStart === \"monday\"\n ? getISOWeek(weekStartDate)\n : getWeekOfYear(weekStartDate);\n };\n // インタラクティブ時のみ APG の grid セマンティクスを付与する。\n // 静的表示ではネイティブの table/cell セマンティクスをそのまま使う。\n const gridRole = interactive ? \"grid\" : undefined;\n const cellRole = interactive ? \"gridcell\" : undefined;\n // h2 には一意な id を振り、table は aria-labelledby でそれを参照する。\n // useId() を使うのは同じ月のカレンダーが複数同時に置かれた場合に\n // id が衝突し aria-labelledby が別のカレンダーを見指すため。\n // aria-label と h2 の両方に同じ文字列を置くとスクリーンリーダーが二重に読む。\n const headingId = useId();\n\n return (\n // biome-ignore lint/a11y/noStaticElementInteractions: onMouseLeave はホバー状態クリア用の補助イベント。キーボード操作(role=grid)は独立して対応済み\n <div\n ref={ref}\n className={`calendar ${resolveTheme(theme).className}${isSizeName(size) ? ` calendar-size-${size}` : \"\"}${interactive ? \" calendar-interactive\" : \"\"}${responsive ? \" calendar-responsive\" : \"\"}`}\n onMouseLeave={interactive ? handleMouseLeave : undefined}\n style={{\n ...(mergeColorScheme(colorScheme) as CSSProperties),\n ...buildSizeStyle(size),\n ...style,\n }}\n >\n <div className=\"calendar-header\">\n <h2\n id={headingId}\n aria-live={gridRole ? \"polite\" : undefined}\n aria-atomic={gridRole ? \"true\" : undefined}\n >\n {title}\n </h2>\n </div>\n <table role={gridRole} aria-labelledby={headingId} onKeyDown={onKeyDown}>\n <thead>\n <tr>\n {showWeekNumbers && (\n <th\n key=\"week\"\n className=\"calendar-week\"\n scope=\"col\"\n aria-label={uiString(\"weekNumber\", locale)}\n />\n )}\n {getWeekdayHeaders(locale, weekStart).map((day) => (\n <th key={day} scope=\"col\">\n {day}\n </th>\n ))}\n </tr>\n </thead>\n <tbody>\n {grid.map((row, i) => {\n if (row.every((d) => d === null)) return null;\n const week = weekOf(row);\n return (\n // biome-ignore lint/suspicious/noArrayIndexKey: 月グリッドは静的で並び順が変わらない\n <tr key={i}>\n {showWeekNumbers && week !== null && (\n <th\n key=\"week\"\n className=\"calendar-week\"\n scope=\"row\"\n aria-label={`${weekLabel} ${week}`}\n >\n {week}\n </th>\n )}\n {row.map((day, j) => {\n if (day === null) {\n // biome-ignore-start lint/suspicious/noArrayIndexKey: パディングセルは日付を持たず列位置 j が唯一の識別子。月グリッドは静的で並び順が入れ替わらないため\n return (\n <td\n key={`b-${j}`}\n role={cellRole}\n className={getBlankClasses()}\n />\n );\n // biome-ignore-end lint/suspicious/noArrayIndexKey: 上記と同じ理由\n }\n // 1セルにつき Date・状態・クラスを1回だけ計算する。\n // Date は year/month 固定で day のみ変わるため createDate で正確に作る\n const date = createDate(year, month - 1, day);\n const state = getCalendarCellState(date, {\n today,\n holidayLocale,\n highlight,\n range,\n isDateDisabled,\n });\n const className =\n joinCellClassLists(\n getCellStateClasses(state),\n getSelectionCellClasses(date, {\n rangePreview,\n hoveredDate,\n selected: selectedDate,\n cursorDate,\n }),\n ) || undefined;\n const selected =\n selectedDate !== null && isSameDay(date, selectedDate);\n const cursor =\n cursorDate !== null && isSameDay(date, cursorDate);\n const onClick =\n interactive && !state.isDisabled\n ? () => handleCellClick(date, cellData?.(date))\n : undefined;\n const onEnter =\n interactive && !state.isDisabled\n ? () => handleCellHover(date)\n : undefined;\n return (\n // biome-ignore lint/a11y/useAriaPropsSupportedByRole: interactive 時は td に role=gridcell が付き aria-selected は有効(role が動的なため静的解析できない)\n <td\n // パディングセル(key=j)との衝突を避けるため日番号に \"d-\" を付与する。日番号は列位置 j と異なり配列の index ではない\n key={`d-${day}`}\n role={cellRole}\n className={className}\n aria-selected={selected || undefined}\n aria-current={state.isToday ? \"date\" : undefined}\n aria-disabled={state.isDisabled || undefined}\n >\n {interactive ? (\n <button\n type=\"button\"\n className=\"calendar-day-btn\"\n onClick={onClick}\n onMouseEnter={onEnter}\n tabIndex={cursor ? 0 : -1}\n data-cursor={cursor ? \"true\" : undefined}\n aria-label={formatCellLabel(locale, year, month, day)}\n aria-pressed={selected}\n disabled={state.isDisabled}\n >\n {renderCell\n ? renderCell(day, date, state, cellData?.(date))\n : day}\n </button>\n ) : renderCell ? (\n renderCell(day, date, state, cellData?.(date))\n ) : (\n day\n )}\n </td>\n );\n })}\n </tr>\n );\n })}\n </tbody>\n </table>\n </div>\n );\n}\n\nexport default Calendar;\n","import type { DateRange } from \"@typescript-calendar-lib/core\";\nimport type {\n CalendarState,\n CalendarStateOptions,\n Direction,\n MonthDirection,\n} from \"@typescript-calendar-lib/tui\";\nimport {\n clearSelection,\n createCalendarState,\n getCursorDate,\n getSelectedDate,\n getSelectedRange,\n goToDate,\n goToMonth,\n goToToday,\n moveCursor,\n navigateMonth,\n navigateYear,\n sameStateOptions,\n selectDate,\n selectDateAt,\n selectRange,\n setCursorToDate,\n updateStateOptions,\n} from \"@typescript-calendar-lib/tui\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface UseCalendarStateOptions\n extends Pick<\n CalendarStateOptions,\n | \"locale\"\n | \"holidayLocale\"\n | \"weekStart\"\n | \"today\"\n | \"highlight\"\n | \"range\"\n | \"isDateDisabled\"\n | \"selectionMode\"\n > {\n initialYear?: number;\n initialMonth?: number;\n /** 表示中の年月が変わったときに呼ばれる */\n onMonthChange?: (year: number, month: number) => void;\n}\n\nexport interface UseCalendarStateReturn {\n /** 現在のカレンダー状態 */\n state: CalendarState;\n /** カーソルを指定方向に移動 (wrap around) */\n moveCursor: (direction: Direction) => void;\n /** 前月/翌月へ移動 */\n goNext: () => void;\n goPrev: () => void;\n /** 前年/翌年へ移動 */\n navigateYear: (direction: MonthDirection) => void;\n /** 指定した年月へジャンプ */\n goToMonth: (year: number, month: number) => void;\n /** 指定した日付の月へジャンプし、カーソルをその日付に置く */\n goToDate: (date: Date) => void;\n /** 今日の月へジャンプ */\n goToday: () => void;\n /** カーソル位置の日付を選択 */\n selectDate: () => void;\n /** 指定した日付へカーソルを移動する(当月に無ければ何もしない) */\n setCursorToDate: (date: Date) => void;\n /** 指定した日付を選択し、カーソルもそこへ移動する(当月に無ければ何もしない) */\n selectDateAt: (date: Date) => void;\n /** 範囲を直接設定して選択する(from/to は自動で整列される) */\n selectRange: (from: Date, to: Date) => void;\n /** 選択を解除 */\n clearSelection: () => void;\n /** カーソル位置の日付(null の場合あり) */\n cursorDate: Date | null;\n /** 選択済み日付(null の場合あり) */\n selectedDate: Date | null;\n /** 確定した選択範囲(range モードで確定した範囲)。未確定なら null */\n selectedRange: DateRange | null;\n /** ホバー中の日付(null の場合あり) */\n hoveredDate: Date | null;\n /** ホバー日付を更新する */\n setHoveredDate: (date: Date | null) => void;\n}\n\n/**\n * tui の不変状態マシンを包む React hook。\n * カレンダーのインタラクティブ操作をシンプルに利用できる。\n *\n * `options` の値(locale / weekStart / today / highlight / range / selectionMode /\n * initialYear / initialMonth)が変わると、カーソル・選択を保ったまま\n * 状態が再構築される。比較は値(Date は getTime)で行うため、インラインで\n * オプションを渡しても値が同じなら再構築されない。\n *\n * `today` を省略した場合、最初に解決された値が状態に固定され、以降も\n * 引き継がれる(毎レンダリング `new Date()` を渡さなくてよい)。\n */\nexport function useCalendarState(\n options: UseCalendarStateOptions = {},\n): UseCalendarStateReturn {\n const [state, setState] = useState<CalendarState>(() =>\n createCalendarState(options),\n );\n\n // ホバー中の日付は React ローカル state で保持する(tui 状態には入れない)。\n const [hoveredDate, setHoveredDate] = useState<Date | null>(null);\n\n // options の「値の変化」を検知して状態を再構築する。\n // 初回は prevOptions が同一なので何もしない。値が同じままの再レンダリング\n // でも何もしないため、インラインリテラルを毎回渡しても無限ループしない。\n const prevOptions = useRef(options);\n useEffect(() => {\n if (sameStateOptions(prevOptions.current, options)) return;\n const previous = prevOptions.current;\n prevOptions.current = options;\n setState((current) => updateStateOptions(current, options, previous));\n }, [options]);\n\n // onMonthChange: ref 経由で安定参照\n const onMonthChangeRef = useRef(options.onMonthChange);\n onMonthChangeRef.current = options.onMonthChange;\n\n // 表示月が変わったら onMonthChange を通知し、古い月を指すホバーをクリアする\n const prevMonthRef = useRef({ year: state.year, month: state.month });\n useEffect(() => {\n const prev = prevMonthRef.current;\n if (prev.year !== state.year || prev.month !== state.month) {\n prevMonthRef.current = { year: state.year, month: state.month };\n onMonthChangeRef.current?.(state.year, state.month);\n setHoveredDate(null);\n }\n }, [state.year, state.month]);\n\n return {\n state,\n moveCursor: useCallback(\n (direction: Direction) => setState((prev) => moveCursor(prev, direction)),\n [],\n ),\n goNext: useCallback(\n () => setState((prev) => navigateMonth(prev, \"next\")),\n [],\n ),\n goPrev: useCallback(\n () => setState((prev) => navigateMonth(prev, \"prev\")),\n [],\n ),\n navigateYear: useCallback(\n (direction: MonthDirection) =>\n setState((prev) => navigateYear(prev, direction)),\n [],\n ),\n goToMonth: useCallback(\n (year: number, month: number) =>\n setState((prev) => goToMonth(prev, year, month)),\n [],\n ),\n goToDate: useCallback(\n (date: Date) => setState((prev) => goToDate(prev, date)),\n [],\n ),\n goToday: useCallback(() => setState((prev) => goToToday(prev)), []),\n selectDate: useCallback(() => setState((prev) => selectDate(prev)), []),\n setCursorToDate: useCallback(\n (date: Date) => setState((prev) => setCursorToDate(prev, date)),\n [],\n ),\n selectDateAt: useCallback(\n (date: Date) => setState((prev) => selectDateAt(prev, date)),\n [],\n ),\n selectRange: useCallback(\n (from: Date, to: Date) => setState((prev) => selectRange(prev, from, to)),\n [],\n ),\n clearSelection: useCallback(\n () => setState((prev) => clearSelection(prev)),\n [],\n ),\n cursorDate: getCursorDate(state),\n selectedDate: getSelectedDate(state),\n selectedRange: getSelectedRange(state),\n hoveredDate,\n setHoveredDate,\n };\n}\n\nexport type { Direction, MonthDirection };\n","import type { CalendarOptions } from \"@typescript-calendar-lib/core\";\nimport type { SelectionMode } from \"@typescript-calendar-lib/tui\";\nimport { keyToAction } from \"@typescript-calendar-lib/tui\";\nimport type { CSSProperties } from \"react\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport { Calendar, type CalendarProps } from \"./Calendar.tsx\";\nimport { useCalendarState } from \"./hooks.ts\";\nimport { buildRangePreview } from \"./range-preview.ts\";\nimport type { CalendarSize } from \"./size.ts\";\nimport type {\n ColorSchemeName,\n ReactColorScheme,\n ReactTheme,\n ThemeName,\n} from \"./themes.ts\";\n\nexport interface InteractiveCalendarProps {\n // ── useCalendarState オプション ──\n\n /** 表示開始年。既定は today の年 */\n initialYear?: number;\n /** 表示開始月 (1-12)。範囲外は正規化される */\n initialMonth?: number;\n locale?: CalendarOptions[\"locale\"];\n holidayLocale?: CalendarOptions[\"holidayLocale\"];\n weekStart?: CalendarOptions[\"weekStart\"];\n /** 各週の先頭に週番号(ISO/年始基準)を表示する */\n showWeekNumbers?: boolean;\n /** 選択方式。既定は \"single\"。範囲選択時はクリックのたびにアンカー→確定→リセットを交互に行う */\n selectionMode?: SelectionMode;\n /** ハイライト対象日 */\n highlight?: Date;\n /** 範囲プレビュー(ホバー等の候補範囲)。is-in-range-preview クラスで視覚化される */\n range?: { from: Date; to: Date };\n /** 今日の基準日。省略時は初回レンダリング時刻に解決される */\n today?: Date;\n /** 選択不可日付の判定。true を返した日付は選択・カーソル移動・ホバーの対象外になる */\n isDateDisabled?: (date: Date) => boolean;\n /** 表示中の年月が変わったときに呼ばれる */\n onMonthChange?: (year: number, month: number) => void;\n\n // ── Calendar の見た目 ──\n\n theme?: ThemeName | ReactTheme;\n colorScheme?: ColorSchemeName | ReactColorScheme;\n size?: CalendarSize;\n /** 狭い画面(スマホ等)でセルサイズと余白を自動調整する */\n responsive?: boolean;\n style?: CSSProperties;\n /** セル内容のカスタムレンダリング。第4引数に該当日のデータが渡る */\n renderCell?: CalendarProps[\"renderCell\"];\n /** 各セルに付与するユーザー定義データを解決する関数。実セルのみに呼ばれる */\n cellData?: (date: Date) => unknown;\n\n // ── イベント ──\n\n /** セルクリック時(キーボードの Enter/Space 含む)。クリックした日付は自動的に選択される。第2引数に該当日のデータが渡る */\n onDateClick?: (date: Date, data?: unknown) => void;\n /** セルホバー時 */\n onDateHover?: (date: Date) => void;\n /** カレンダーからマウスが離れたとき */\n onDateLeave?: () => void;\n}\n\n/**\n * `useCalendarState` と `Calendar` を一体化したインタラクティブカレンダー。\n * 内部で状態を管理し、以下の操作に対応する:\n *\n * - マウス: セルクリックで日付を選択(カーソルもそこへ移動) / ホバー追跡 /\n * 選択済み日付とホバー日付の間を範囲プレビュー表示\n * - キーボード: 矢印キー(カーソル移動)・PageUp/PageDown(月移動)・\n * Enter/Space(クリックと同じ日付選択)\n */\nexport function InteractiveCalendar(props: InteractiveCalendarProps) {\n const {\n initialYear,\n initialMonth,\n locale,\n holidayLocale,\n weekStart,\n showWeekNumbers,\n selectionMode,\n highlight,\n range,\n today,\n isDateDisabled,\n onMonthChange,\n theme,\n colorScheme,\n size,\n responsive,\n style,\n renderCell,\n cellData,\n onDateClick,\n onDateHover,\n onDateLeave,\n } = props;\n\n const hook = useCalendarState({\n initialYear,\n initialMonth,\n locale,\n holidayLocale,\n weekStart,\n selectionMode,\n today,\n highlight,\n range,\n isDateDisabled,\n onMonthChange,\n });\n\n const { state, moveCursor, goPrev, goNext, selectDateAt, setHoveredDate } =\n hook;\n const rootRef = useRef<HTMLDivElement>(null);\n\n // クリック(マウス・Enter/Space 共通)で日付を選択する。\n // 従来の onDateClick コールバックも引き続き発火し、第2引数に該当日のデータが渡る。\n const handleDateClick = useCallback(\n (date: Date, data?: unknown) => {\n selectDateAt(date);\n onDateClick?.(date, data);\n },\n [selectDateAt, onDateClick],\n );\n\n const handleDateHover = useCallback(\n (date: Date) => {\n setHoveredDate(date);\n onDateHover?.(date);\n },\n [setHoveredDate, onDateHover],\n );\n\n const handleDateLeave = useCallback(() => {\n setHoveredDate(null);\n onDateLeave?.();\n }, [setHoveredDate, onDateLeave]);\n\n // 確定済みの選択範囲は、次のピックが始まるまでプレビューとして表示し続ける。\n // 未確定なら選択済み日付とホバー日付の間を範囲プレビューとして表示する。\n const rangePreview =\n hook.selectedRange ??\n buildRangePreview(hook.selectedDate, hook.hoveredDate);\n\n // カーソルが動いたときだけ、そのセルへフォーカスを移す(初回マウントでは動かさない)\n const prevCursorRef = useRef(state.cursor);\n useEffect(() => {\n const prev = prevCursorRef.current;\n prevCursorRef.current = state.cursor;\n if (prev === state.cursor) return;\n const btn = rootRef.current?.querySelector<HTMLButtonElement>(\n '[data-cursor=\"true\"]',\n );\n btn?.focus();\n }, [state.cursor]);\n\n const handleKeyDown = useCallback(\n (e: Parameters<NonNullable<CalendarProps[\"onKeyDown\"]>>[0]) => {\n const action = keyToAction(e.key);\n if (action === undefined) return;\n e.preventDefault();\n switch (action) {\n case \"prev\":\n goPrev();\n break;\n case \"next\":\n goNext();\n break;\n default:\n moveCursor(action);\n }\n },\n [moveCursor, goPrev, goNext],\n );\n\n return (\n <Calendar\n ref={rootRef}\n year={state.year}\n month={state.month}\n locale={state.options.locale}\n holidayLocale={state.options.holidayLocale}\n weekStart={state.options.weekStart}\n showWeekNumbers={showWeekNumbers}\n highlight={state.options.highlight}\n range={state.options.range}\n today={state.options.today}\n isDateDisabled={isDateDisabled}\n theme={theme}\n colorScheme={colorScheme}\n size={size}\n responsive={responsive}\n style={style}\n interactive\n renderCell={renderCell}\n cellData={cellData}\n selectedDate={hook.selectedDate}\n cursorDate={hook.cursorDate}\n hoveredDate={hook.hoveredDate}\n rangePreview={rangePreview}\n onDateClick={handleDateClick}\n onDateHover={handleDateHover}\n onDateLeave={handleDateLeave}\n onKeyDown={handleKeyDown}\n />\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["buildSizeStyle","buildSizeStyleBase","buildSizeStyle","getBlankClasses","joinCellClassLists","getCellStateClasses","getSelectionCellClasses"],"sources":["../src/size.ts","../src/Calendar.tsx","../src/hooks.ts","../src/interactive.tsx"],"sourcesContent":["// ─── セルサイズ ───────────────────────────────────────────\n// サイズ判定・CSS 変数変換は web パッケージに集約済み。\n// ここでは React の style 型(CSSProperties)に適合させる薄いアダプタのみ持つ。\n\nimport type { CalendarSize } from \"@typescript-calendar-lib/web\";\nimport type { CSSProperties } from \"react\";\n\nexport type {\n CalendarCustomSize,\n CalendarSize,\n CalendarSizeName,\n} from \"@typescript-calendar-lib/web\";\nexport { isSizeName } from \"@typescript-calendar-lib/web\";\n\nimport { buildSizeStyle as buildSizeStyleBase } from \"@typescript-calendar-lib/web\";\n\n/** セルサイズを CSS 変数スタイル(--cal-cell-w / --cal-cell-h)へ変換する */\nexport function buildSizeStyle(size: CalendarSize): CSSProperties {\n return buildSizeStyleBase(size) as CSSProperties;\n}\n","import type {\n CalendarCellState,\n CalendarOptions,\n} from \"@typescript-calendar-lib/core\";\nimport {\n addDays,\n buildMonthGrid,\n createDate,\n getCalendarCellState,\n getISOWeek,\n getMonthName,\n getWeekdayHeaders,\n getWeekOfYear,\n isSameDay,\n} from \"@typescript-calendar-lib/core\";\nimport {\n formatCellLabel,\n getBlankClasses,\n getCellStateClasses,\n getSelectionCellClasses,\n joinCellClassLists,\n uiString,\n} from \"@typescript-calendar-lib/web\";\nimport type {\n CSSProperties,\n KeyboardEvent as ReactKeyboardEvent,\n ReactNode,\n Ref,\n} from \"react\";\nimport { useId, useMemo } from \"react\";\nimport type { CalendarSize } from \"./size.ts\";\nimport { buildSizeStyle, isSizeName } from \"./size.ts\";\nimport type {\n ColorSchemeName,\n ReactColorScheme,\n ReactTheme,\n ThemeName,\n} from \"./themes.ts\";\nimport { mergeColorScheme, resolveTheme } from \"./themes.ts\";\n\nexport type {\n CalendarCustomSize,\n CalendarSize,\n CalendarSizeName,\n} from \"./size.ts\";\n\nexport interface CalendarProps {\n year: number;\n month: number;\n locale?: CalendarOptions[\"locale\"];\n holidayLocale?: CalendarOptions[\"holidayLocale\"];\n weekStart?: CalendarOptions[\"weekStart\"];\n /** 各週の先頭に週番号(ISO/年始基準)を表示する。既定は false */\n showWeekNumbers?: boolean;\n highlight?: Date;\n /** 範囲強調 */\n range?: { from: Date; to: Date };\n /** 今日の基準日。カラースキームの today 着色に使用 */\n today?: Date;\n /** 範囲プレビュー(ホバー等の候補範囲)。is-in-range-preview クラスで視覚化される */\n rangePreview?: { from: Date; to: Date };\n /** 見た目テーマ。既定は \"default\" */\n theme?: ThemeName | ReactTheme;\n /** カラースキーム。既定は \"default\" */\n colorScheme?: ColorSchemeName | ReactColorScheme;\n /** セルサイズ。既定は \"md\"。{ width, height } で自由に指定できる */\n size?: CalendarSize;\n /** 狭い画面(スマホ等)でセルサイズと余白を自動調整する。既定は false(無効) */\n responsive?: boolean;\n /** root 要素に追加するスタイル。CSS変数(--cal-*)で自由に上書きできる */\n style?: CSSProperties;\n\n // ── インタラクション ──\n\n /** インタラクティブモードを有効にする。セルクリック・ホバー・キーボード選択が可能になる */\n interactive?: boolean;\n /** セルクリック時のコールバック。第2引数に該当日のデータ(cellData の戻り値)が渡る */\n onDateClick?: (date: Date, data?: unknown) => void;\n /** セルホバー時のコールバック */\n onDateHover?: (date: Date) => void;\n /** カレンダーからマウスが離れたときのコールバック */\n onDateLeave?: () => void;\n /** キーボード操作。root 要素で発火(矢印キー等を InteractiveCalendar が処理する) */\n onKeyDown?: (event: ReactKeyboardEvent<HTMLDivElement>) => void;\n\n // ── セル状態 ──\n\n /** 選択済み日付。aria-selected・aria-pressed と表示スタイルに使用 */\n selectedDate?: Date | null;\n /** カーソル位置の日付。このセルだけ tabIndex=0(roving tabindex)になる */\n cursorDate?: Date | null;\n /** ホバー中の日付。is-hovered クラスで視覚化される */\n hoveredDate?: Date | null;\n /** セル内容のカスタムレンダリング。interactive 時は button の子として描画される。第4引数に該当日のデータが渡る */\n renderCell?: (\n day: number,\n date: Date,\n state: CalendarCellState,\n data?: unknown,\n ) => ReactNode;\n /** 各セルに付与するユーザー定義データを解決する関数。実セルのみに呼ばれる */\n cellData?: (date: Date) => unknown;\n /** 選択不可日付の判定。true を返した日付は is-disabled クラスになり、インタラクティブ時は選択・ホバーできなくなる */\n isDateDisabled?: (date: Date) => boolean;\n\n /** root 要素への ref(React 19 の ref-as-prop) */\n ref?: Ref<HTMLDivElement>;\n}\n\n/** 月カレンダーコンポーネント */\nexport function Calendar({\n year,\n month,\n locale = \"en\",\n holidayLocale,\n weekStart = \"sunday\",\n showWeekNumbers = false,\n highlight,\n range,\n today,\n theme = \"default\",\n colorScheme = \"default\",\n size = \"md\",\n responsive = false,\n style,\n interactive = false,\n onDateClick,\n onDateHover,\n onDateLeave,\n onKeyDown,\n selectedDate = null,\n cursorDate = null,\n hoveredDate = null,\n renderCell,\n cellData,\n isDateDisabled,\n rangePreview,\n ref,\n}: CalendarProps) {\n // グリッドは月単位で不変。ホバー・選択の再描画でも再計算しない\n const grid = useMemo(\n () => buildMonthGrid(year, month, weekStart),\n [year, month, weekStart],\n );\n\n const handleCellClick = (date: Date, data?: unknown) => {\n if (interactive && onDateClick) onDateClick(date, data);\n };\n\n const handleCellHover = (date: Date) => {\n if (interactive && onDateHover) onDateHover(date);\n };\n\n const handleMouseLeave = () => {\n if (interactive && onDateLeave) onDateLeave();\n };\n\n const title = `${getMonthName(locale, month)} ${year}`;\n // 週番号の行ヘッダー(scope=\"row\")用ラベル。行ごとに一意の名前にするため\n // 番号を含める(aria-label が内容の数字を上書きしないように)\n const weekLabel = uiString(\"weekNumber\", locale);\n const weekOf = (row: (number | null)[]): number | null => {\n const firstIdx = row.findIndex((d) => d !== null);\n if (firstIdx === -1) return null;\n const firstDate = createDate(year, month - 1, row[firstIdx]!);\n const weekStartDate = addDays(firstDate, -firstIdx);\n return weekStart === \"monday\"\n ? getISOWeek(weekStartDate)\n : getWeekOfYear(weekStartDate);\n };\n // インタラクティブ時のみ APG の grid セマンティクスを付与する。\n // 静的表示ではネイティブの table/cell セマンティクスをそのまま使う。\n const gridRole = interactive ? \"grid\" : undefined;\n const cellRole = interactive ? \"gridcell\" : undefined;\n // h2 には一意な id を振り、table は aria-labelledby でそれを参照する。\n // useId() を使うのは同じ月のカレンダーが複数同時に置かれた場合に\n // id が衝突し aria-labelledby が別のカレンダーを見指すため。\n // aria-label と h2 の両方に同じ文字列を置くとスクリーンリーダーが二重に読む。\n const headingId = useId();\n\n return (\n // biome-ignore lint/a11y/noStaticElementInteractions: onMouseLeave はホバー状態クリア用の補助イベント。キーボード操作(role=grid)は独立して対応済み\n <div\n ref={ref}\n className={`calendar ${resolveTheme(theme).className}${isSizeName(size) ? ` calendar-size-${size}` : \"\"}${interactive ? \" calendar-interactive\" : \"\"}${responsive ? \" calendar-responsive\" : \"\"}`}\n onMouseLeave={interactive ? handleMouseLeave : undefined}\n style={{\n ...(mergeColorScheme(colorScheme) as CSSProperties),\n ...buildSizeStyle(size),\n ...style,\n }}\n >\n <div className=\"calendar-header\">\n <h2\n id={headingId}\n aria-live={gridRole ? \"polite\" : undefined}\n aria-atomic={gridRole ? \"true\" : undefined}\n >\n {title}\n </h2>\n </div>\n <table role={gridRole} aria-labelledby={headingId} onKeyDown={onKeyDown}>\n <thead>\n <tr>\n {showWeekNumbers && (\n <th\n key=\"week\"\n className=\"calendar-week\"\n scope=\"col\"\n aria-label={uiString(\"weekNumber\", locale)}\n />\n )}\n {getWeekdayHeaders(locale, weekStart).map((day) => (\n <th key={day} scope=\"col\">\n {day}\n </th>\n ))}\n </tr>\n </thead>\n <tbody>\n {grid.map((row, i) => {\n if (row.every((d) => d === null)) return null;\n const week = weekOf(row);\n return (\n // biome-ignore lint/suspicious/noArrayIndexKey: 月グリッドは静的で並び順が変わらない\n <tr key={i}>\n {showWeekNumbers && week !== null && (\n <th\n key=\"week\"\n className=\"calendar-week\"\n scope=\"row\"\n aria-label={`${weekLabel} ${week}`}\n >\n {week}\n </th>\n )}\n {row.map((day, j) => {\n if (day === null) {\n // biome-ignore-start lint/suspicious/noArrayIndexKey: パディングセルは日付を持たず列位置 j が唯一の識別子。月グリッドは静的で並び順が入れ替わらないため\n return (\n <td\n key={`b-${j}`}\n role={cellRole}\n className={getBlankClasses()}\n />\n );\n // biome-ignore-end lint/suspicious/noArrayIndexKey: 上記と同じ理由\n }\n // 1セルにつき Date・状態・クラスを1回だけ計算する。\n // Date は year/month 固定で day のみ変わるため createDate で正確に作る\n const date = createDate(year, month - 1, day);\n const state = getCalendarCellState(date, {\n today,\n holidayLocale,\n highlight,\n range,\n isDateDisabled,\n });\n const className =\n joinCellClassLists(\n getCellStateClasses(state),\n getSelectionCellClasses(date, {\n rangePreview,\n hoveredDate,\n selected: selectedDate,\n cursorDate,\n }),\n ) || undefined;\n const selected =\n selectedDate !== null && isSameDay(date, selectedDate);\n const cursor =\n cursorDate !== null && isSameDay(date, cursorDate);\n const onClick =\n interactive && !state.isDisabled\n ? () => handleCellClick(date, cellData?.(date))\n : undefined;\n const onEnter =\n interactive && !state.isDisabled\n ? () => handleCellHover(date)\n : undefined;\n return (\n // biome-ignore lint/a11y/useAriaPropsSupportedByRole: interactive 時は td に role=gridcell が付き aria-selected は有効(role が動的なため静的解析できない)\n <td\n // パディングセル(key=j)との衝突を避けるため日番号に \"d-\" を付与する。日番号は列位置 j と異なり配列の index ではない\n key={`d-${day}`}\n role={cellRole}\n className={className}\n aria-selected={selected || undefined}\n aria-current={state.isToday ? \"date\" : undefined}\n aria-disabled={state.isDisabled || undefined}\n >\n {interactive ? (\n <button\n type=\"button\"\n className=\"calendar-day-btn\"\n onClick={onClick}\n onMouseEnter={onEnter}\n tabIndex={cursor ? 0 : -1}\n data-cursor={cursor ? \"true\" : undefined}\n aria-label={formatCellLabel(locale, year, month, day)}\n aria-pressed={selected}\n disabled={state.isDisabled}\n >\n {renderCell\n ? renderCell(day, date, state, cellData?.(date))\n : day}\n </button>\n ) : renderCell ? (\n renderCell(day, date, state, cellData?.(date))\n ) : (\n day\n )}\n </td>\n );\n })}\n </tr>\n );\n })}\n </tbody>\n </table>\n </div>\n );\n}\n\nexport default Calendar;\n","import type { DateRange } from \"@typescript-calendar-lib/core\";\nimport type {\n CalendarState,\n CalendarStateOptions,\n Direction,\n MonthDirection,\n} from \"@typescript-calendar-lib/tui\";\nimport {\n clearSelection,\n createCalendarState,\n getCursorDate,\n getSelectedDate,\n getSelectedRange,\n goToDate,\n goToMonth,\n goToToday,\n moveCursor,\n navigateMonth,\n navigateYear,\n sameStateOptions,\n selectDate,\n selectDateAt,\n selectRange,\n setCursorToDate,\n updateStateOptions,\n} from \"@typescript-calendar-lib/tui\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface UseCalendarStateOptions\n extends Pick<\n CalendarStateOptions,\n | \"locale\"\n | \"holidayLocale\"\n | \"weekStart\"\n | \"today\"\n | \"highlight\"\n | \"range\"\n | \"isDateDisabled\"\n | \"selectionMode\"\n > {\n initialYear?: number;\n initialMonth?: number;\n /**\n * 制御モードの表示年。指定すると `initialYear` より優先され、値が変わるたびに\n * その年月へ再構築される。月移動は内部状態を変えず `onMonthChange` に通知する。\n */\n year?: number;\n /** 制御モードの表示月 (1–12)。`year` と併用する */\n month?: number;\n /** 表示中の年月が変わったときに呼ばれる */\n onMonthChange?: (year: number, month: number) => void;\n}\n\nexport interface UseCalendarStateReturn {\n /** 現在のカレンダー状態 */\n state: CalendarState;\n /** カーソルを指定方向に移動 (wrap around) */\n moveCursor: (direction: Direction) => void;\n /** 前月/翌月へ移動 */\n goNext: () => void;\n goPrev: () => void;\n /** 前年/翌年へ移動 */\n navigateYear: (direction: MonthDirection) => void;\n /** 指定した年月へジャンプ */\n goToMonth: (year: number, month: number) => void;\n /** 指定した日付の月へジャンプし、カーソルをその日付に置く */\n goToDate: (date: Date) => void;\n /** 今日の月へジャンプ */\n goToday: () => void;\n /** カーソル位置の日付を選択 */\n selectDate: () => void;\n /** 指定した日付へカーソルを移動する(当月に無ければ何もしない) */\n setCursorToDate: (date: Date) => void;\n /** 指定した日付を選択し、カーソルもそこへ移動する(当月に無ければ何もしない) */\n selectDateAt: (date: Date) => void;\n /** 範囲を直接設定して選択する(from/to は自動で整列される) */\n selectRange: (from: Date, to: Date) => void;\n /** 選択を解除 */\n clearSelection: () => void;\n /** カーソル位置の日付(null の場合あり) */\n cursorDate: Date | null;\n /** 選択済み日付(null の場合あり) */\n selectedDate: Date | null;\n /** 確定した選択範囲(range モードで確定した範囲)。未確定なら null */\n selectedRange: DateRange | null;\n /** ホバー中の日付(null の場合あり) */\n hoveredDate: Date | null;\n /** ホバー日付を更新する */\n setHoveredDate: (date: Date | null) => void;\n}\n\n/**\n * tui の不変状態マシンを包む React hook。\n * カレンダーのインタラクティブ操作をシンプルに利用できる。\n *\n * `options` の値(locale / weekStart / today / highlight / range / selectionMode /\n * initialYear / initialMonth)が変わると、カーソル・選択を保ったまま\n * 状態が再構築される。比較は値(Date は getTime)で行うため、インラインで\n * オプションを渡しても値が同じなら再構築されない。\n *\n * `today` を省略した場合、最初に解決された値が状態に固定され、以降も\n * 引き継がれる(毎レンダリング `new Date()` を渡さなくてよい)。\n */\nexport function useCalendarState(\n options: UseCalendarStateOptions = {},\n): UseCalendarStateReturn {\n const [state, setState] = useState<CalendarState>(() =>\n createCalendarState(options),\n );\n\n // ホバー中の日付は React ローカル state で保持する(tui 状態には入れない)。\n const [hoveredDate, setHoveredDate] = useState<Date | null>(null);\n\n // 制御モード(year/month を外部から渡す)かどうか。\n // 制御モードでは月移動は内部状態を変えず onMonthChange に委譲する。\n const controlled = options.year !== undefined || options.month !== undefined;\n const controlledRef = useRef(controlled);\n controlledRef.current = controlled;\n\n // 最新 state を参照するための ref(controlled 分岐で同期的に次月を計算する)\n const stateRef = useRef(state);\n stateRef.current = state;\n\n // options の「値の変化」を検知して状態を再構築する。\n // 初回は prevOptions が同一なので何もしない。値が同じままの再レンダリング\n // でも何もしないため、インラインリテラルを毎回渡しても無限ループしない。\n const prevOptions = useRef(options);\n useEffect(() => {\n if (sameStateOptions(prevOptions.current, options)) return;\n const previous = prevOptions.current;\n prevOptions.current = options;\n setState((current) => updateStateOptions(current, options, previous));\n }, [options]);\n\n // onMonthChange: ref 経由で安定参照\n const onMonthChangeRef = useRef(options.onMonthChange);\n onMonthChangeRef.current = options.onMonthChange;\n\n // 表示月が変わったら onMonthChange を通知し、古い月を指すホバーをクリアする。\n // 制御モードでは props 側が月を決めているので再通知しない(二重通知の抑止)。\n const prevMonthRef = useRef({ year: state.year, month: state.month });\n useEffect(() => {\n const prev = prevMonthRef.current;\n if (prev.year !== state.year || prev.month !== state.month) {\n prevMonthRef.current = { year: state.year, month: state.month };\n setHoveredDate(null);\n if (!controlledRef.current) {\n onMonthChangeRef.current?.(state.year, state.month);\n }\n }\n }, [state.year, state.month]);\n\n return {\n state,\n moveCursor: useCallback(\n (direction: Direction) => setState((prev) => moveCursor(prev, direction)),\n [],\n ),\n goNext: useCallback(() => {\n if (controlledRef.current) {\n const next = navigateMonth(stateRef.current, \"next\");\n onMonthChangeRef.current?.(next.year, next.month);\n return;\n }\n setState((prev) => navigateMonth(prev, \"next\"));\n }, []),\n goPrev: useCallback(() => {\n if (controlledRef.current) {\n const next = navigateMonth(stateRef.current, \"prev\");\n onMonthChangeRef.current?.(next.year, next.month);\n return;\n }\n setState((prev) => navigateMonth(prev, \"prev\"));\n }, []),\n navigateYear: useCallback((direction: MonthDirection) => {\n if (controlledRef.current) {\n const next = navigateYear(stateRef.current, direction);\n onMonthChangeRef.current?.(next.year, next.month);\n return;\n }\n setState((prev) => navigateYear(prev, direction));\n }, []),\n goToMonth: useCallback((year: number, month: number) => {\n if (controlledRef.current) {\n const next = goToMonth(stateRef.current, year, month);\n onMonthChangeRef.current?.(next.year, next.month);\n return;\n }\n setState((prev) => goToMonth(prev, year, month));\n }, []),\n goToDate: useCallback((date: Date) => {\n if (controlledRef.current) {\n const next = goToDate(stateRef.current, date);\n onMonthChangeRef.current?.(next.year, next.month);\n return;\n }\n setState((prev) => goToDate(prev, date));\n }, []),\n goToday: useCallback(() => {\n if (controlledRef.current) {\n const next = goToToday(stateRef.current);\n onMonthChangeRef.current?.(next.year, next.month);\n return;\n }\n setState((prev) => goToToday(prev));\n }, []),\n selectDate: useCallback(() => setState((prev) => selectDate(prev)), []),\n setCursorToDate: useCallback(\n (date: Date) => setState((prev) => setCursorToDate(prev, date)),\n [],\n ),\n selectDateAt: useCallback(\n (date: Date) => setState((prev) => selectDateAt(prev, date)),\n [],\n ),\n selectRange: useCallback(\n (from: Date, to: Date) => setState((prev) => selectRange(prev, from, to)),\n [],\n ),\n clearSelection: useCallback(\n () => setState((prev) => clearSelection(prev)),\n [],\n ),\n cursorDate: getCursorDate(state),\n selectedDate: getSelectedDate(state),\n selectedRange: getSelectedRange(state),\n hoveredDate,\n setHoveredDate,\n };\n}\n\nexport type { Direction, MonthDirection };\n","import type { CalendarOptions } from \"@typescript-calendar-lib/core\";\nimport { createDate, lastDayOfMonth } from \"@typescript-calendar-lib/core\";\nimport type { SelectionMode } from \"@typescript-calendar-lib/tui\";\nimport { keyToAction } from \"@typescript-calendar-lib/tui\";\nimport type { CSSProperties } from \"react\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport { Calendar, type CalendarProps } from \"./Calendar.tsx\";\nimport { useCalendarState } from \"./hooks.ts\";\nimport { buildRangePreview } from \"./range-preview.ts\";\nimport type { CalendarSize } from \"./size.ts\";\nimport type {\n ColorSchemeName,\n ReactColorScheme,\n ReactTheme,\n ThemeName,\n} from \"./themes.ts\";\n\nexport interface InteractiveCalendarProps {\n // ── useCalendarState オプション ──\n\n /** 表示開始年。既定は today の年 */\n initialYear?: number;\n /** 表示開始月 (1-12)。範囲外は正規化される */\n initialMonth?: number;\n /** 制御モードの表示年。指定すると initialYear より優先され、月移動は onMonthChange に委譲される */\n year?: number;\n /** 制御モードの表示月 (1-12) */\n month?: number;\n locale?: CalendarOptions[\"locale\"];\n holidayLocale?: CalendarOptions[\"holidayLocale\"];\n weekStart?: CalendarOptions[\"weekStart\"];\n /** 各週の先頭に週番号(ISO/年始基準)を表示する */\n showWeekNumbers?: boolean;\n /** 選択方式。既定は \"single\"。範囲選択時はクリックのたびにアンカー→確定→リセットを交互に行う */\n selectionMode?: SelectionMode;\n /** ハイライト対象日 */\n highlight?: Date;\n /** 範囲プレビュー(ホバー等の候補範囲)。is-in-range-preview クラスで視覚化される */\n range?: { from: Date; to: Date };\n /** 今日の基準日。省略時は初回レンダリング時刻に解決される */\n today?: Date;\n /** 選択不可日付の判定。true を返した日付は選択・カーソル移動・ホバーの対象外になる */\n isDateDisabled?: (date: Date) => boolean;\n /** 表示中の年月が変わったときに呼ばれる */\n onMonthChange?: (year: number, month: number) => void;\n\n // ── Calendar の見た目 ──\n\n theme?: ThemeName | ReactTheme;\n colorScheme?: ColorSchemeName | ReactColorScheme;\n size?: CalendarSize;\n /** 狭い画面(スマホ等)でセルサイズと余白を自動調整する */\n responsive?: boolean;\n style?: CSSProperties;\n /** セル内容のカスタムレンダリング。第4引数に該当日のデータが渡る */\n renderCell?: CalendarProps[\"renderCell\"];\n /** 各セルに付与するユーザー定義データを解決する関数。実セルのみに呼ばれる */\n cellData?: (date: Date) => unknown;\n\n // ── イベント ──\n\n /** セルクリック時(キーボードの Enter/Space 含む)。クリックした日付は自動的に選択される。第2引数に該当日のデータが渡る */\n onDateClick?: (date: Date, data?: unknown) => void;\n /** セルホバー時 */\n onDateHover?: (date: Date) => void;\n /** カレンダーからマウスが離れたとき */\n onDateLeave?: () => void;\n}\n\n/**\n * `useCalendarState` と `Calendar` を一体化したインタラクティブカレンダー。\n * 内部で状態を管理し、以下の操作に対応する:\n *\n * - マウス: セルクリックで日付を選択(カーソルもそこへ移動) / ホバー追跡 /\n * 選択済み日付とホバー日付の間を範囲プレビュー表示\n * - キーボード: 矢印キー(カーソル移動)・PageUp/PageDown(月移動)・\n * Enter/Space(クリックと同じ日付選択)\n */\nexport function InteractiveCalendar(props: InteractiveCalendarProps) {\n const {\n initialYear,\n initialMonth,\n locale,\n holidayLocale,\n weekStart,\n showWeekNumbers,\n selectionMode,\n highlight,\n range,\n today,\n isDateDisabled,\n year,\n month,\n onMonthChange,\n theme,\n colorScheme,\n size,\n responsive,\n style,\n renderCell,\n cellData,\n onDateClick,\n onDateHover,\n onDateLeave,\n } = props;\n\n const hook = useCalendarState({\n initialYear,\n initialMonth,\n year,\n month,\n locale,\n holidayLocale,\n weekStart,\n selectionMode,\n today,\n highlight,\n range,\n isDateDisabled,\n onMonthChange,\n });\n\n const {\n state,\n moveCursor,\n goPrev,\n goNext,\n navigateYear,\n setCursorToDate,\n clearSelection,\n selectDateAt,\n setHoveredDate,\n } = hook;\n const rootRef = useRef<HTMLDivElement>(null);\n\n // クリック(マウス・Enter/Space 共通)で日付を選択する。\n // 従来の onDateClick コールバックも引き続き発火し、第2引数に該当日のデータが渡る。\n const handleDateClick = useCallback(\n (date: Date, data?: unknown) => {\n selectDateAt(date);\n onDateClick?.(date, data);\n },\n [selectDateAt, onDateClick],\n );\n\n const handleDateHover = useCallback(\n (date: Date) => {\n setHoveredDate(date);\n onDateHover?.(date);\n },\n [setHoveredDate, onDateHover],\n );\n\n const handleDateLeave = useCallback(() => {\n setHoveredDate(null);\n onDateLeave?.();\n }, [setHoveredDate, onDateLeave]);\n\n // 確定済みの選択範囲は、次のピックが始まるまでプレビューとして表示し続ける。\n // 未確定なら選択済み日付とホバー日付の間を範囲プレビューとして表示する。\n const rangePreview =\n hook.selectedRange ??\n buildRangePreview(hook.selectedDate, hook.hoveredDate);\n\n // カーソルが動いたときだけ、そのセルへフォーカスを移す(初回マウントでは動かさない)\n const prevCursorRef = useRef(state.cursor);\n useEffect(() => {\n const prev = prevCursorRef.current;\n prevCursorRef.current = state.cursor;\n if (prev === state.cursor) return;\n const btn = rootRef.current?.querySelector<HTMLButtonElement>(\n '[data-cursor=\"true\"]',\n );\n btn?.focus();\n }, [state.cursor]);\n\n const handleKeyDown = useCallback(\n (e: Parameters<NonNullable<CalendarProps[\"onKeyDown\"]>>[0]) => {\n const action = keyToAction(e.key, e);\n if (action === undefined) return;\n e.preventDefault();\n switch (action) {\n case \"prev\":\n goPrev();\n break;\n case \"next\":\n goNext();\n break;\n case \"prevYear\":\n navigateYear(\"prev\");\n break;\n case \"nextYear\":\n navigateYear(\"next\");\n break;\n case \"firstDay\":\n setCursorToDate(createDate(state.year, state.month - 1, 1));\n break;\n case \"lastDay\":\n setCursorToDate(lastDayOfMonth(state.year, state.month));\n break;\n case \"clear\":\n clearSelection();\n break;\n default:\n moveCursor(action);\n }\n },\n [\n moveCursor,\n goPrev,\n goNext,\n navigateYear,\n setCursorToDate,\n clearSelection,\n state.year,\n state.month,\n ],\n );\n\n return (\n <Calendar\n ref={rootRef}\n year={state.year}\n month={state.month}\n locale={state.options.locale}\n holidayLocale={state.options.holidayLocale}\n weekStart={state.options.weekStart}\n showWeekNumbers={showWeekNumbers}\n highlight={state.options.highlight}\n range={state.options.range}\n today={state.options.today}\n isDateDisabled={isDateDisabled}\n theme={theme}\n colorScheme={colorScheme}\n size={size}\n responsive={responsive}\n style={style}\n interactive\n renderCell={renderCell}\n cellData={cellData}\n selectedDate={hook.selectedDate}\n cursorDate={hook.cursorDate}\n hoveredDate={hook.hoveredDate}\n rangePreview={rangePreview}\n onDateClick={handleDateClick}\n onDateHover={handleDateHover}\n onDateLeave={handleDateLeave}\n onKeyDown={handleKeyDown}\n />\n );\n}\n"],"mappings":";;;;;;;AAiBA,SAAgBA,iBAAe,MAAmC;CAChE,OAAOC,eAAmB,IAAI;AAChC;;;;AC2FA,SAAgB,SAAS,EACvB,MACA,OACA,SAAS,MACT,eACA,YAAY,UACZ,kBAAkB,OAClB,WACA,OACA,OACA,QAAQ,WACR,cAAc,WACd,OAAO,MACP,aAAa,OACb,OACA,cAAc,OACd,aACA,aACA,aACA,WACA,eAAe,MACf,aAAa,MACb,cAAc,MACd,YACA,UACA,gBACA,cACA,OACgB;CAEhB,MAAM,OAAO,cACL,eAAe,MAAM,OAAO,SAAS,GAC3C;EAAC;EAAM;EAAO;CAAS,CACzB;CAEA,MAAM,mBAAmB,MAAY,SAAmB;EACtD,IAAI,eAAe,aAAa,YAAY,MAAM,IAAI;CACxD;CAEA,MAAM,mBAAmB,SAAe;EACtC,IAAI,eAAe,aAAa,YAAY,IAAI;CAClD;CAEA,MAAM,yBAAyB;EAC7B,IAAI,eAAe,aAAa,YAAY;CAC9C;CAEA,MAAM,QAAQ,GAAG,aAAa,QAAQ,KAAK,EAAE,GAAG;CAGhD,MAAM,YAAY,SAAS,cAAc,MAAM;CAC/C,MAAM,UAAU,QAA0C;EACxD,MAAM,WAAW,IAAI,WAAW,MAAM,MAAM,IAAI;EAChD,IAAI,aAAa,IAAI,OAAO;EAC5B,MAAM,YAAY,WAAW,MAAM,QAAQ,GAAG,IAAI,SAAU;EAC5D,MAAM,gBAAgB,QAAQ,WAAW,CAAC,QAAQ;EAClD,OAAO,cAAc,WACjB,WAAW,aAAa,IACxB,cAAc,aAAa;CACjC;CAGA,MAAM,WAAW,cAAc,SAAS,KAAA;CACxC,MAAM,WAAW,cAAc,aAAa,KAAA;CAK5C,MAAM,YAAY,MAAM;CAExB,OAEE,qBAAC,OAAD;EACO;EACL,WAAW,YAAY,aAAa,KAAK,CAAC,CAAC,YAAY,WAAW,IAAI,IAAI,kBAAkB,SAAS,KAAK,cAAc,0BAA0B,KAAK,aAAa,yBAAyB;EAC7L,cAAc,cAAc,mBAAmB,KAAA;EAC/C,OAAO;GACL,GAAI,iBAAiB,WAAW;GAChC,GAAGC,iBAAe,IAAI;GACtB,GAAG;EACL;EARF,UAAA,CAUE,oBAAC,OAAD;GAAK,WAAU;GACb,UAAA,oBAAC,MAAD;IACE,IAAI;IACJ,aAAW,WAAW,WAAW,KAAA;IACjC,eAAa,WAAW,SAAS,KAAA;IAEhC,UAAA;GACC,CAAA;EACD,CAAA,GACL,qBAAC,SAAD;GAAO,MAAM;GAAU,mBAAiB;GAAsB;GAA9D,UAAA,CACE,oBAAC,SAAD,EAAA,UACE,qBAAC,MAAD,EAAA,UAAA,CACG,mBACC,oBAAC,MAAD;IAEE,WAAU;IACV,OAAM;IACN,cAAY,SAAS,cAAc,MAAM;GAC1C,GAJK,MAIL,GAEF,kBAAkB,QAAQ,SAAS,CAAC,CAAC,KAAK,QACzC,oBAAC,MAAD;IAAc,OAAM;IACjB,UAAA;GACC,GAFK,GAEL,CACL,CACC,EAAA,CAAA,EACC,CAAA,GACP,oBAAC,SAAD,EAAA,UACG,KAAK,KAAK,KAAK,MAAM;IACpB,IAAI,IAAI,OAAO,MAAM,MAAM,IAAI,GAAG,OAAO;IACzC,MAAM,OAAO,OAAO,GAAG;IACvB,OAEE,qBAAC,MAAD,EAAA,UAAA,CACG,mBAAmB,SAAS,QAC3B,oBAAC,MAAD;KAEE,WAAU;KACV,OAAM;KACN,cAAY,GAAG,UAAU,GAAG;KAE3B,UAAA;IACC,GANE,MAMF,GAEL,IAAI,KAAK,KAAK,MAAM;KACnB,IAAI,QAAQ,MAEV,OACE,oBAAC,MAAD;MAEE,MAAM;MACN,WAAWC,kBAAgB;KAC5B,GAHM,KAAK,GAGX;KAML,MAAM,OAAO,WAAW,MAAM,QAAQ,GAAG,GAAG;KAC5C,MAAM,QAAQ,qBAAqB,MAAM;MACvC;MACA;MACA;MACA;MACA;KACF,CAAC;KACD,MAAM,YACJC,qBACEC,sBAAoB,KAAK,GACzBC,0BAAwB,MAAM;MAC5B;MACA;MACA,UAAU;MACV;KACF,CAAC,CACH,KAAK,KAAA;KACP,MAAM,WACJ,iBAAiB,QAAQ,UAAU,MAAM,YAAY;KACvD,MAAM,SACJ,eAAe,QAAQ,UAAU,MAAM,UAAU;KACnD,MAAM,UACJ,eAAe,CAAC,MAAM,mBACZ,gBAAgB,MAAM,WAAW,IAAI,CAAC,IAC5C,KAAA;KACN,MAAM,UACJ,eAAe,CAAC,MAAM,mBACZ,gBAAgB,IAAI,IAC1B,KAAA;KACN,OAEE,oBAAC,MAAD;MAGE,MAAM;MACK;MACX,iBAAe,YAAY,KAAA;MAC3B,gBAAc,MAAM,UAAU,SAAS,KAAA;MACvC,iBAAe,MAAM,cAAc,KAAA;MAElC,UAAA,cACC,oBAAC,UAAD;OACE,MAAK;OACL,WAAU;OACD;OACT,cAAc;OACd,UAAU,SAAS,IAAI;OACvB,eAAa,SAAS,SAAS,KAAA;OAC/B,cAAY,gBAAgB,QAAQ,MAAM,OAAO,GAAG;OACpD,gBAAc;OACd,UAAU,MAAM;OAEf,UAAA,aACG,WAAW,KAAK,MAAM,OAAO,WAAW,IAAI,CAAC,IAC7C;MACE,CAAA,IACN,aACF,WAAW,KAAK,MAAM,OAAO,WAAW,IAAI,CAAC,IAE7C;KAEA,GA5BG,KAAK,KA4BR;IAER,CAAC,CACC,EAAA,GA1FK,CA0FL;GAER,CAAC,EACI,CAAA,CACF;EACJ,CAAA,CAAA;;AAET;;;;;;;;;;;;;;;AC3NA,SAAgB,iBACd,UAAmC,CAAC,GACZ;CACxB,MAAM,CAAC,OAAO,YAAY,eACxB,oBAAoB,OAAO,CAC7B;CAGA,MAAM,CAAC,aAAa,kBAAkB,SAAsB,IAAI;CAIhE,MAAM,aAAa,QAAQ,SAAS,KAAA,KAAa,QAAQ,UAAU,KAAA;CACnE,MAAM,gBAAgB,OAAO,UAAU;CACvC,cAAc,UAAU;CAGxB,MAAM,WAAW,OAAO,KAAK;CAC7B,SAAS,UAAU;CAKnB,MAAM,cAAc,OAAO,OAAO;CAClC,gBAAgB;EACd,IAAI,iBAAiB,YAAY,SAAS,OAAO,GAAG;EACpD,MAAM,WAAW,YAAY;EAC7B,YAAY,UAAU;EACtB,UAAU,YAAY,mBAAmB,SAAS,SAAS,QAAQ,CAAC;CACtE,GAAG,CAAC,OAAO,CAAC;CAGZ,MAAM,mBAAmB,OAAO,QAAQ,aAAa;CACrD,iBAAiB,UAAU,QAAQ;CAInC,MAAM,eAAe,OAAO;EAAE,MAAM,MAAM;EAAM,OAAO,MAAM;CAAM,CAAC;CACpE,gBAAgB;EACd,MAAM,OAAO,aAAa;EAC1B,IAAI,KAAK,SAAS,MAAM,QAAQ,KAAK,UAAU,MAAM,OAAO;GAC1D,aAAa,UAAU;IAAE,MAAM,MAAM;IAAM,OAAO,MAAM;GAAM;GAC9D,eAAe,IAAI;GACnB,IAAI,CAAC,cAAc,SACjB,iBAAiB,UAAU,MAAM,MAAM,MAAM,KAAK;EAEtD;CACF,GAAG,CAAC,MAAM,MAAM,MAAM,KAAK,CAAC;CAE5B,OAAO;EACL;EACA,YAAY,aACT,cAAyB,UAAU,SAAS,WAAW,MAAM,SAAS,CAAC,GACxE,CAAC,CACH;EACA,QAAQ,kBAAkB;GACxB,IAAI,cAAc,SAAS;IACzB,MAAM,OAAO,cAAc,SAAS,SAAS,MAAM;IACnD,iBAAiB,UAAU,KAAK,MAAM,KAAK,KAAK;IAChD;GACF;GACA,UAAU,SAAS,cAAc,MAAM,MAAM,CAAC;EAChD,GAAG,CAAC,CAAC;EACL,QAAQ,kBAAkB;GACxB,IAAI,cAAc,SAAS;IACzB,MAAM,OAAO,cAAc,SAAS,SAAS,MAAM;IACnD,iBAAiB,UAAU,KAAK,MAAM,KAAK,KAAK;IAChD;GACF;GACA,UAAU,SAAS,cAAc,MAAM,MAAM,CAAC;EAChD,GAAG,CAAC,CAAC;EACL,cAAc,aAAa,cAA8B;GACvD,IAAI,cAAc,SAAS;IACzB,MAAM,OAAO,aAAa,SAAS,SAAS,SAAS;IACrD,iBAAiB,UAAU,KAAK,MAAM,KAAK,KAAK;IAChD;GACF;GACA,UAAU,SAAS,aAAa,MAAM,SAAS,CAAC;EAClD,GAAG,CAAC,CAAC;EACL,WAAW,aAAa,MAAc,UAAkB;GACtD,IAAI,cAAc,SAAS;IACzB,MAAM,OAAO,UAAU,SAAS,SAAS,MAAM,KAAK;IACpD,iBAAiB,UAAU,KAAK,MAAM,KAAK,KAAK;IAChD;GACF;GACA,UAAU,SAAS,UAAU,MAAM,MAAM,KAAK,CAAC;EACjD,GAAG,CAAC,CAAC;EACL,UAAU,aAAa,SAAe;GACpC,IAAI,cAAc,SAAS;IACzB,MAAM,OAAO,SAAS,SAAS,SAAS,IAAI;IAC5C,iBAAiB,UAAU,KAAK,MAAM,KAAK,KAAK;IAChD;GACF;GACA,UAAU,SAAS,SAAS,MAAM,IAAI,CAAC;EACzC,GAAG,CAAC,CAAC;EACL,SAAS,kBAAkB;GACzB,IAAI,cAAc,SAAS;IACzB,MAAM,OAAO,UAAU,SAAS,OAAO;IACvC,iBAAiB,UAAU,KAAK,MAAM,KAAK,KAAK;IAChD;GACF;GACA,UAAU,SAAS,UAAU,IAAI,CAAC;EACpC,GAAG,CAAC,CAAC;EACL,YAAY,kBAAkB,UAAU,SAAS,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC;EACtE,iBAAiB,aACd,SAAe,UAAU,SAAS,gBAAgB,MAAM,IAAI,CAAC,GAC9D,CAAC,CACH;EACA,cAAc,aACX,SAAe,UAAU,SAAS,aAAa,MAAM,IAAI,CAAC,GAC3D,CAAC,CACH;EACA,aAAa,aACV,MAAY,OAAa,UAAU,SAAS,YAAY,MAAM,MAAM,EAAE,CAAC,GACxE,CAAC,CACH;EACA,gBAAgB,kBACR,UAAU,SAAS,eAAe,IAAI,CAAC,GAC7C,CAAC,CACH;EACA,YAAY,cAAc,KAAK;EAC/B,cAAc,gBAAgB,KAAK;EACnC,eAAe,iBAAiB,KAAK;EACrC;EACA;CACF;AACF;;;;;;;;;;;;ACvJA,SAAgB,oBAAoB,OAAiC;CACnE,MAAM,EACJ,aACA,cACA,QACA,eACA,WACA,iBACA,eACA,WACA,OACA,OACA,gBACA,MACA,OACA,eACA,OACA,aACA,MACA,YACA,OACA,YACA,UACA,aACA,aACA,gBACE;CAEJ,MAAM,OAAO,iBAAiB;EAC5B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CAED,MAAM,EACJ,OACA,YACA,QACA,QACA,cACA,iBACA,gBACA,cACA,mBACE;CACJ,MAAM,UAAU,OAAuB,IAAI;CAI3C,MAAM,kBAAkB,aACrB,MAAY,SAAmB;EAC9B,aAAa,IAAI;EACjB,cAAc,MAAM,IAAI;CAC1B,GACA,CAAC,cAAc,WAAW,CAC5B;CAEA,MAAM,kBAAkB,aACrB,SAAe;EACd,eAAe,IAAI;EACnB,cAAc,IAAI;CACpB,GACA,CAAC,gBAAgB,WAAW,CAC9B;CAEA,MAAM,kBAAkB,kBAAkB;EACxC,eAAe,IAAI;EACnB,cAAc;CAChB,GAAG,CAAC,gBAAgB,WAAW,CAAC;CAIhC,MAAM,eACJ,KAAK,iBACL,kBAAkB,KAAK,cAAc,KAAK,WAAW;CAGvD,MAAM,gBAAgB,OAAO,MAAM,MAAM;CACzC,gBAAgB;EACd,MAAM,OAAO,cAAc;EAC3B,cAAc,UAAU,MAAM;EAC9B,IAAI,SAAS,MAAM,QAAQ;EAI3B,CAHY,QAAQ,SAAS,cAC3B,wBACF,EAAA,EACK,MAAM;CACb,GAAG,CAAC,MAAM,MAAM,CAAC;CAEjB,MAAM,gBAAgB,aACnB,MAA8D;EAC7D,MAAM,SAAS,YAAY,EAAE,KAAK,CAAC;EACnC,IAAI,WAAW,KAAA,GAAW;EAC1B,EAAE,eAAe;EACjB,QAAQ,QAAR;GACE,KAAK;IACH,OAAO;IACP;GACF,KAAK;IACH,OAAO;IACP;GACF,KAAK;IACH,aAAa,MAAM;IACnB;GACF,KAAK;IACH,aAAa,MAAM;IACnB;GACF,KAAK;IACH,gBAAgB,WAAW,MAAM,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC;IAC1D;GACF,KAAK;IACH,gBAAgB,eAAe,MAAM,MAAM,MAAM,KAAK,CAAC;IACvD;GACF,KAAK;IACH,eAAe;IACf;GACF,SACE,WAAW,MAAM;EACrB;CACF,GACA;EACE;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;EACN,MAAM;CACR,CACF;CAEA,OACE,oBAAC,UAAD;EACE,KAAK;EACL,MAAM,MAAM;EACZ,OAAO,MAAM;EACb,QAAQ,MAAM,QAAQ;EACtB,eAAe,MAAM,QAAQ;EAC7B,WAAW,MAAM,QAAQ;EACR;EACjB,WAAW,MAAM,QAAQ;EACzB,OAAO,MAAM,QAAQ;EACrB,OAAO,MAAM,QAAQ;EACL;EACT;EACM;EACP;EACM;EACL;EACP,aAAA;EACY;EACF;EACV,cAAc,KAAK;EACnB,YAAY,KAAK;EACjB,aAAa,KAAK;EACJ;EACd,aAAa;EACb,aAAa;EACb,aAAa;EACb,WAAW;CACZ,CAAA;AAEL"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@typescript-calendar-lib/react",
3
- "version": "0.5.4",
3
+ "version": "0.6.1",
4
4
  "description": "React 19 calendar components with CSS themes and color schemes",
5
5
  "type": "module",
6
6
  "repository": {
@@ -28,9 +28,9 @@
28
28
  ],
29
29
  "license": "MIT",
30
30
  "dependencies": {
31
- "@typescript-calendar-lib/core": "^0.5.4",
32
- "@typescript-calendar-lib/tui": "^0.5.4",
33
- "@typescript-calendar-lib/web": "^0.5.4"
31
+ "@typescript-calendar-lib/core": "^0.6.1",
32
+ "@typescript-calendar-lib/tui": "^0.6.1",
33
+ "@typescript-calendar-lib/web": "^0.6.1"
34
34
  },
35
35
  "devDependencies": {
36
36
  "@testing-library/react": "^16",
@@ -44,6 +44,17 @@
44
44
  "peerDependencies": {
45
45
  "react": "^19"
46
46
  },
47
+ "author": "nazozokc",
48
+ "homepage": "https://github.com/nazozokc/typescript-calendar-lib#readme",
49
+ "bugs": {
50
+ "url": "https://github.com/nazozokc/typescript-calendar-lib/issues"
51
+ },
52
+ "engines": {
53
+ "node": ">=22"
54
+ },
55
+ "sideEffects": [
56
+ "**/*.css"
57
+ ],
47
58
  "scripts": {
48
59
  "build": "tsdown && cp ../web/dist/calendar.css dist/calendar.css"
49
60
  }