@kalyx/core 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,256 @@
+/**
+ * @kalyx/core 타입 정의
+ *
+ * 모든 날짜 값은 ISO 8601 UTC string으로 표현한다.
+ * native Date 객체는 사용하지 않는다.
+ */
+/** ISO 8601 UTC 날짜 문자열. 예: "2026-01-15T00:00:00.000Z" */
+type ISODateString = string;
+/**
+ * 날짜 비활성화 규칙. 여러 규칙을 배열로 조합할 수 있다.
+ *
+ * @example
+ * ```ts
+ * const rules: DisabledRule[] = [
+ *   { before: '2026-01-01T00:00:00.000Z' }, // 1월 1일 이전 비활성화
+ *   { after: '2026-12-31T00:00:00.000Z' },  // 12월 31일 이후 비활성화
+ *   { date: '2026-06-15T00:00:00.000Z' },   // 특정 날짜 비활성화
+ *   { dayOfWeek: [0, 6] },                   // 주말 비활성화
+ * ];
+ * ```
+ */
+type DisabledRule = {
+    date: ISODateString;
+} | {
+    before: ISODateString;
+} | {
+    after: ISODateString;
+} | {
+    dayOfWeek: number[];
+};
+/** 날짜 범위 (RangePicker) */
+interface DateRange {
+    start: ISODateString | null;
+    end: ISODateString | null;
+}
+/** 캘린더 그리드의 하루를 표현하는 타입 */
+interface CalendarDay {
+    /** ISO 8601 UTC string */
+    isoString: ISODateString;
+    /** 날짜 숫자 (1-31) */
+    dayNumber: number;
+    /** 현재 표시 중인 달에 속하는지 */
+    isCurrentMonth: boolean;
+    /** 오늘인지 */
+    isToday: boolean;
+    /** 선택된 날짜인지 (단일 선택) */
+    isSelected: boolean;
+    /** 비활성화 상태인지 */
+    isDisabled: boolean;
+    /** 포커스된 날짜인지 */
+    isFocused: boolean;
+    /** 범위의 시작일인지 */
+    isRangeStart: boolean;
+    /** 범위의 종료일인지 */
+    isRangeEnd: boolean;
+    /** 범위 내부 (시작과 종료 사이)인지 */
+    isInRange: boolean;
+}
+/** 캘린더 그리드: 주(week) 배열 → 일(day) 배열 */
+type CalendarWeek = CalendarDay[];
+type CalendarGrid = CalendarWeek[];
+/**
+ * 날짜 라이브러리 어댑터 인터페이스.
+ * 모든 날짜 연산을 추상화하여 다른 라이브러리(Temporal API 등)로 교체 가능.
+ * 기본 구현체: {@link DateFnsAdapter}
+ */
+interface DateAdapter {
+    /** 어떤 형식이든 → ISO 8601 UTC string */
+    parse(value: string, format?: string): string;
+    /** ISO string → 화면 표시용 string */
+    format(iso: string, formatStr: string, timezone?: string): string;
+    addDays(iso: string, n: number): string;
+    addMonths(iso: string, n: number): string;
+    addYears(iso: string, n: number): string;
+    isBefore(a: string, b: string): boolean;
+    isAfter(a: string, b: string): boolean;
+    isSameDay(a: string, b: string, timezone?: string): boolean;
+    isSameMonth(a: string, b: string): boolean;
+    startOfDay(iso: string, timezone?: string): string;
+    startOfMonth(iso: string): string;
+    endOfMonth(iso: string): string;
+    startOfWeek(iso: string, weekStartsOn?: 0 | 1): string;
+    endOfWeek(iso: string, weekStartsOn?: 0 | 1): string;
+    now(): string;
+    today(timezone?: string): string;
+    isValid(value: string): boolean;
+    getYear(iso: string): number;
+    getMonth(iso: string): number;
+    getDate(iso: string): number;
+    getDay(iso: string): number;
+}
+/** 주 시작 요일 */
+type WeekStartsOn = 0 | 1;
+/** 캘린더 그리드 생성 옵션 */
+interface CalendarOptions {
+    weekStartsOn?: WeekStartsOn;
+    today?: ISODateString;
+    selected?: ISODateString | null;
+    focusedDate?: ISODateString;
+    disabled?: DisabledRule[];
+    /** 선택된 범위 (RangePicker) */
+    range?: DateRange | null;
+    /** 호버 중인 날짜 (RangePicker 미리보기용) */
+    rangeHover?: ISODateString | null;
+}
+
+/**
+ * date-fns 기반 DateAdapter 구현체.
+ * 모든 연산은 UTC 기준으로 동작하여 timezone 간섭을 방지한다.
+ *
+ * @example
+ * ```ts
+ * import { DateFnsAdapter } from '@kalyx/core';
+ *
+ * DateFnsAdapter.format('2026-01-15T00:00:00.000Z', 'yyyy-MM-dd'); // "2026-01-15"
+ * DateFnsAdapter.addDays('2026-01-15T00:00:00.000Z', 7);           // "2026-01-22T..."
+ * DateFnsAdapter.isSameDay('2026-01-15T00:00:00.000Z', '2026-01-15T23:59:59.000Z'); // true
+ * ```
+ */
+declare const DateFnsAdapter: DateAdapter;
+
+/**
+ * 특정 월의 캘린더 그리드를 생성한다.
+ * 주(week) 단위로 구분된 2차원 배열(`CalendarGrid`)을 반환한다.
+ *
+ * @param monthISO - 표시할 월을 포함하는 ISO datetime
+ * @param adapter - 날짜 연산 어댑터 ({@link DateFnsAdapter})
+ * @param options - 주 시작 요일, 선택된 날짜, 비활성화 규칙, 범위 등
+ * @returns 4~6주의 캘린더 그리드. 각 주는 7개의 {@link CalendarDay} 배열.
+ *
+ * @example
+ * ```ts
+ * const grid = getCalendarDays('2026-01-01T00:00:00.000Z', DateFnsAdapter, {
+ *   weekStartsOn: 0,
+ *   selected: '2026-01-15T00:00:00.000Z',
+ *   disabled: [{ dayOfWeek: [0, 6] }],
+ * });
+ * // grid[0] = 첫째 주 (CalendarDay[7])
+ * // grid[0][0].dayNumber = 28 (이전 달)
+ * ```
+ */
+declare function getCalendarDays(monthISO: string, adapter: DateAdapter, options?: CalendarOptions): CalendarGrid;
+/**
+ * 주어진 날짜가 비활성화 규칙에 해당하는지 검사한다.
+ */
+declare function isDateDisabled(iso: string, rules: DisabledRule[], adapter: DateAdapter): boolean;
+/**
+ * 두 날짜 중 더 이른 것을 반환한다.
+ */
+declare function minDate(a: ISODateString, b: ISODateString, adapter: DateAdapter): ISODateString;
+/**
+ * 두 날짜 중 더 늦은 것을 반환한다.
+ */
+declare function maxDate(a: ISODateString, b: ISODateString, adapter: DateAdapter): ISODateString;
+
+/**
+ * 날짜 문자열을 ISO 8601 UTC 형식으로 정규화한다.
+ * "2026-01-15" → "2026-01-15T00:00:00.000Z"
+ */
+declare function normalizeISO(value: string): string;
+/**
+ * 사용자 입력 텍스트를 ISO string으로 파싱한다.
+ * 실패 시 null을 반환한다.
+ */
+declare function parseInputValue(input: string, format: string, adapter: DateAdapter): string | null;
+
+/** 시간 표현 (24시간제 기준) */
+interface TimeValue {
+    hours: number;
+    minutes: number;
+    seconds: number;
+}
+/**
+ * ISO datetime의 시간 부분을 변경한다.
+ * UTC 기준으로 동작한다.
+ */
+declare function setTime(iso: ISODateString, time: Partial<TimeValue>): ISODateString;
+/**
+ * ISO datetime에서 시간 부분만 추출한다.
+ */
+declare function getTime(iso: ISODateString): TimeValue;
+/**
+ * "HH:MM" 또는 "HH:MM:SS" 문자열을 TimeValue로 파싱한다.
+ * 잘못된 형식이면 null 반환.
+ */
+declare function parseTimeString(input: string): TimeValue | null;
+/**
+ * TimeValue를 "HH:MM" 또는 "HH:MM:SS" 문자열로 포맷팅한다.
+ */
+declare function formatTimeString(time: TimeValue, withSeconds?: boolean): string;
+/**
+ * 24시간제 → 12시간제 변환.
+ * 0시 → 12 AM, 12시 → 12 PM
+ */
+declare function to12Hour(hours24: number): {
+    hours12: number;
+    period: 'AM' | 'PM';
+};
+/**
+ * 12시간제 → 24시간제 변환.
+ */
+declare function to24Hour(hours12: number, period: 'AM' | 'PM'): number;
+/**
+ * 시 리스트 생성 (0-23 또는 1-12)
+ */
+declare function generateHours(format?: '12h' | '24h'): number[];
+/**
+ * 분 리스트 생성 (step 단위)
+ * step=1 → [0, 1, 2, ..., 59]
+ * step=15 → [0, 15, 30, 45]
+ * step=5 → [0, 5, 10, ..., 55]
+ */
+declare function generateMinutes(step?: number): number[];
+/**
+ * 두 TimeValue가 동일한지 비교 (시·분·초 모두).
+ */
+declare function isSameTime(a: TimeValue, b: TimeValue): boolean;
+/**
+ * ISO datetime을 시간 문자열로 포맷팅 (UTC 기준).
+ * 어댑터를 받아서 일관성 유지.
+ */
+declare function formatTimeFromISO(iso: ISODateString, format: 'HH:mm' | 'HH:mm:ss' | 'h:mm a' | 'h:mm:ss a', _adapter?: DateAdapter): string;
+
+interface WeekdayInfo {
+    /** 짧은 이름 (예: "Su", "일") */
+    short: string;
+    /** 전체 이름 (예: "Sunday", "일요일") */
+    full: string;
+}
+/**
+ * Intl.DateTimeFormat으로 월 이름을 반환한다.
+ * @param month 0-indexed (0 = January)
+ * @param year 표시에만 사용 (일부 locale은 년 포함)
+ * @param locale BCP 47 locale string (예: "en-US", "ko-KR", "ja-JP")
+ */
+declare function getMonthName(month: number, locale?: string): string;
+/**
+ * "2026년 1월" 또는 "January 2026" 같은 월+년 문자열을 반환한다.
+ */
+declare function formatMonthYear(year: number, month: number, locale?: string): string;
+/**
+ * Intl.DateTimeFormat으로 주의 요일 이름 배열을 반환한다.
+ * weekStartsOn에 맞춰 정렬.
+ *
+ * @param locale BCP 47 locale string
+ * @param weekStartsOn 0 = Sunday, 1 = Monday
+ * @returns 7개의 WeekdayInfo 배열
+ */
+declare function getWeekdayNames(locale?: string, weekStartsOn?: WeekStartsOn): WeekdayInfo[];
+/**
+ * Intl.DateTimeFormat으로 날짜의 전체 텍스트를 반환한다 (스크린리더용).
+ * 예: "2026년 1월 15일 목요일"
+ */
+declare function formatFullDate(iso: string, locale?: string): string;
+
+export { type CalendarDay, type CalendarGrid, type CalendarOptions, type CalendarWeek, type DateAdapter, DateFnsAdapter, type DateRange, type DisabledRule, type ISODateString, type TimeValue, type WeekStartsOn, type WeekdayInfo, formatFullDate, formatMonthYear, formatTimeFromISO, formatTimeString, generateHours, generateMinutes, getCalendarDays, getMonthName, getTime, getWeekdayNames, isDateDisabled, isSameTime, maxDate, minDate, normalizeISO, parseInputValue, parseTimeString, setTime, to12Hour, to24Hour };

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { ISODateString, DisabledRule, DateRange, CalendarDay, CalendarWeek, CalendarGrid, CalendarOptions, DateAdapter, WeekStartsOn, } from './types.js';
+export { DateFnsAdapter } from './adapters/date-fns.js';
+export { getCalendarDays, isDateDisabled, minDate, maxDate } from './utils/calendar.js';
+export { normalizeISO, parseInputValue } from './utils/date.js';
+export { setTime, getTime, parseTimeString, formatTimeString, formatTimeFromISO, to12Hour, to24Hour, generateHours, generateMinutes, isSameTime, } from './utils/time.js';
+export type { TimeValue } from './utils/time.js';
+export { getMonthName, formatMonthYear, getWeekdayNames, formatFullDate, } from './utils/locale.js';
+export type { WeekdayInfo } from './utils/locale.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,OAAO,EACP,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,eAAe,EACf,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// @kalyx/core — 플랫폼 독립 날짜 로직
+// 어댑터
+export { DateFnsAdapter } from './adapters/date-fns.js';
+// 유틸
+export { getCalendarDays, isDateDisabled, minDate, maxDate } from './utils/calendar.js';
+export { normalizeISO, parseInputValue } from './utils/date.js';
+export { setTime, getTime, parseTimeString, formatTimeString, formatTimeFromISO, to12Hour, to24Hour, generateHours, generateMinutes, isSameTime, } from './utils/time.js';
+export { getMonthName, formatMonthYear, getWeekdayNames, formatFullDate, } from './utils/locale.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAe7B,MAAM;AACN,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,KAAK;AACL,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,OAAO,EACP,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,eAAe,EACf,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @kalyx/core 타입 정의
+ *
+ * 모든 날짜 값은 ISO 8601 UTC string으로 표현한다.
+ * native Date 객체는 사용하지 않는다.
+ */
+/** ISO 8601 UTC 날짜 문자열. 예: "2026-01-15T00:00:00.000Z" */
+export type ISODateString = string;
+/**
+ * 날짜 비활성화 규칙. 여러 규칙을 배열로 조합할 수 있다.
+ *
+ * @example
+ * ```ts
+ * const rules: DisabledRule[] = [
+ *   { before: '2026-01-01T00:00:00.000Z' }, // 1월 1일 이전 비활성화
+ *   { after: '2026-12-31T00:00:00.000Z' },  // 12월 31일 이후 비활성화
+ *   { date: '2026-06-15T00:00:00.000Z' },   // 특정 날짜 비활성화
+ *   { dayOfWeek: [0, 6] },                   // 주말 비활성화
+ * ];
+ * ```
+ */
+export type DisabledRule = {
+    date: ISODateString;
+} | {
+    before: ISODateString;
+} | {
+    after: ISODateString;
+} | {
+    dayOfWeek: number[];
+};
+/** 날짜 범위 (RangePicker) */
+export interface DateRange {
+    start: ISODateString | null;
+    end: ISODateString | null;
+}
+/** 캘린더 그리드의 하루를 표현하는 타입 */
+export interface CalendarDay {
+    /** ISO 8601 UTC string */
+    isoString: ISODateString;
+    /** 날짜 숫자 (1-31) */
+    dayNumber: number;
+    /** 현재 표시 중인 달에 속하는지 */
+    isCurrentMonth: boolean;
+    /** 오늘인지 */
+    isToday: boolean;
+    /** 선택된 날짜인지 (단일 선택) */
+    isSelected: boolean;
+    /** 비활성화 상태인지 */
+    isDisabled: boolean;
+    /** 포커스된 날짜인지 */
+    isFocused: boolean;
+    /** 범위의 시작일인지 */
+    isRangeStart: boolean;
+    /** 범위의 종료일인지 */
+    isRangeEnd: boolean;
+    /** 범위 내부 (시작과 종료 사이)인지 */
+    isInRange: boolean;
+}
+/** 캘린더 그리드: 주(week) 배열 → 일(day) 배열 */
+export type CalendarWeek = CalendarDay[];
+export type CalendarGrid = CalendarWeek[];
+/**
+ * 날짜 라이브러리 어댑터 인터페이스.
+ * 모든 날짜 연산을 추상화하여 다른 라이브러리(Temporal API 등)로 교체 가능.
+ * 기본 구현체: {@link DateFnsAdapter}
+ */
+export interface DateAdapter {
+    /** 어떤 형식이든 → ISO 8601 UTC string */
+    parse(value: string, format?: string): string;
+    /** ISO string → 화면 표시용 string */
+    format(iso: string, formatStr: string, timezone?: string): string;
+    addDays(iso: string, n: number): string;
+    addMonths(iso: string, n: number): string;
+    addYears(iso: string, n: number): string;
+    isBefore(a: string, b: string): boolean;
+    isAfter(a: string, b: string): boolean;
+    isSameDay(a: string, b: string, timezone?: string): boolean;
+    isSameMonth(a: string, b: string): boolean;
+    startOfDay(iso: string, timezone?: string): string;
+    startOfMonth(iso: string): string;
+    endOfMonth(iso: string): string;
+    startOfWeek(iso: string, weekStartsOn?: 0 | 1): string;
+    endOfWeek(iso: string, weekStartsOn?: 0 | 1): string;
+    now(): string;
+    today(timezone?: string): string;
+    isValid(value: string): boolean;
+    getYear(iso: string): number;
+    getMonth(iso: string): number;
+    getDate(iso: string): number;
+    getDay(iso: string): number;
+}
+/** 주 시작 요일 */
+export type WeekStartsOn = 0 | 1;
+/** 캘린더 그리드 생성 옵션 */
+export interface CalendarOptions {
+    weekStartsOn?: WeekStartsOn;
+    today?: ISODateString;
+    selected?: ISODateString | null;
+    focusedDate?: ISODateString;
+    disabled?: DisabledRule[];
+    /** 선택된 범위 (RangePicker) */
+    range?: DateRange | null;
+    /** 호버 중인 날짜 (RangePicker 미리보기용) */
+    rangeHover?: ISODateString | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * @kalyx/core 타입 정의
+ *
+ * 모든 날짜 값은 ISO 8601 UTC string으로 표현한다.
+ * native Date 객체는 사용하지 않는다.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/calendar.d.ts

@@ -0,0 +1,35 @@
+import type { CalendarGrid, CalendarOptions, DateAdapter, DisabledRule, ISODateString } from '../types.js';
+/**
+ * 특정 월의 캘린더 그리드를 생성한다.
+ * 주(week) 단위로 구분된 2차원 배열(`CalendarGrid`)을 반환한다.
+ *
+ * @param monthISO - 표시할 월을 포함하는 ISO datetime
+ * @param adapter - 날짜 연산 어댑터 ({@link DateFnsAdapter})
+ * @param options - 주 시작 요일, 선택된 날짜, 비활성화 규칙, 범위 등
+ * @returns 4~6주의 캘린더 그리드. 각 주는 7개의 {@link CalendarDay} 배열.
+ *
+ * @example
+ * ```ts
+ * const grid = getCalendarDays('2026-01-01T00:00:00.000Z', DateFnsAdapter, {
+ *   weekStartsOn: 0,
+ *   selected: '2026-01-15T00:00:00.000Z',
+ *   disabled: [{ dayOfWeek: [0, 6] }],
+ * });
+ * // grid[0] = 첫째 주 (CalendarDay[7])
+ * // grid[0][0].dayNumber = 28 (이전 달)
+ * ```
+ */
+export declare function getCalendarDays(monthISO: string, adapter: DateAdapter, options?: CalendarOptions): CalendarGrid;
+/**
+ * 주어진 날짜가 비활성화 규칙에 해당하는지 검사한다.
+ */
+export declare function isDateDisabled(iso: string, rules: DisabledRule[], adapter: DateAdapter): boolean;
+/**
+ * 두 날짜 중 더 이른 것을 반환한다.
+ */
+export declare function minDate(a: ISODateString, b: ISODateString, adapter: DateAdapter): ISODateString;
+/**
+ * 두 날짜 중 더 늦은 것을 반환한다.
+ */
+export declare function maxDate(a: ISODateString, b: ISODateString, adapter: DateAdapter): ISODateString;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/utils/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/utils/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EACZ,eAAe,EACf,WAAW,EAEX,YAAY,EACZ,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,eAAoB,GAC5B,YAAY,CA2Dd;AAwED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,WAAW,GACnB,OAAO,CAaT;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,CAAC,EAAE,aAAa,EAChB,CAAC,EAAE,aAAa,EAChB,OAAO,EAAE,WAAW,GACnB,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,CAAC,EAAE,aAAa,EAChB,CAAC,EAAE,aAAa,EAChB,OAAO,EAAE,WAAW,GACnB,aAAa,CAEf"}

package/dist/utils/calendar.js

@@ -0,0 +1,141 @@
+/**
+ * 특정 월의 캘린더 그리드를 생성한다.
+ * 주(week) 단위로 구분된 2차원 배열(`CalendarGrid`)을 반환한다.
+ *
+ * @param monthISO - 표시할 월을 포함하는 ISO datetime
+ * @param adapter - 날짜 연산 어댑터 ({@link DateFnsAdapter})
+ * @param options - 주 시작 요일, 선택된 날짜, 비활성화 규칙, 범위 등
+ * @returns 4~6주의 캘린더 그리드. 각 주는 7개의 {@link CalendarDay} 배열.
+ *
+ * @example
+ * ```ts
+ * const grid = getCalendarDays('2026-01-01T00:00:00.000Z', DateFnsAdapter, {
+ *   weekStartsOn: 0,
+ *   selected: '2026-01-15T00:00:00.000Z',
+ *   disabled: [{ dayOfWeek: [0, 6] }],
+ * });
+ * // grid[0] = 첫째 주 (CalendarDay[7])
+ * // grid[0][0].dayNumber = 28 (이전 달)
+ * ```
+ */
+export function getCalendarDays(monthISO, adapter, options = {}) {
+    const { weekStartsOn = 0, today, selected, focusedDate, disabled = [], range, rangeHover, } = options;
+    const todayISO = today ?? adapter.today();
+    const monthStart = adapter.startOfMonth(monthISO);
+    // 캘린더 그리드의 시작: 해당 월 첫째 날이 속한 주의 시작
+    const gridStart = adapter.startOfWeek(monthStart, weekStartsOn);
+    // 범위 계산용 정규화 (start <= end 보장)
+    const normalizedRange = normalizeRangeForDisplay(range, rangeHover, adapter);
+    const weeks = [];
+    let current = gridStart;
+    // 최대 6주 (42일)
+    for (let week = 0; week < 6; week++) {
+        const days = [];
+        for (let day = 0; day < 7; day++) {
+            const isCurrentMonth = adapter.isSameMonth(current, monthISO);
+            const isTodayDate = adapter.isSameDay(current, todayISO);
+            const isSelected_ = selected ? adapter.isSameDay(current, selected) : false;
+            const isFocused_ = focusedDate ? adapter.isSameDay(current, focusedDate) : false;
+            const isDisabled_ = isDateDisabled(current, disabled, adapter);
+            const rangeFlags = computeRangeFlags(current, normalizedRange, adapter);
+            days.push({
+                isoString: current,
+                dayNumber: adapter.getDate(current),
+                isCurrentMonth,
+                isToday: isTodayDate,
+                isSelected: isSelected_,
+                isDisabled: isDisabled_,
+                isFocused: isFocused_,
+                ...rangeFlags,
+            });
+            current = adapter.addDays(current, 1);
+        }
+        weeks.push(days);
+        // 다음 주의 시작이 이미 다음 달이면 그리드 종료
+        if (!adapter.isSameMonth(current, monthISO) && week >= 3) {
+            break;
+        }
+    }
+    return weeks;
+}
+/**
+ * Range가 한 쪽만 선택된 경우 hover 날짜로 임시 범위를 만들어 표시한다.
+ * start > end인 경우 정렬한다.
+ */
+function normalizeRangeForDisplay(range, hover, adapter) {
+    if (!range)
+        return { start: null, end: null };
+    const { start, end } = range;
+    // 둘 다 선택됨 → 정렬해서 반환
+    if (start && end) {
+        if (adapter.isAfter(start, end)) {
+            return { start: end, end: start };
+        }
+        return { start, end };
+    }
+    // 시작만 선택됨 + hover 있음 → hover까지 미리보기
+    if (start && !end && hover) {
+        if (adapter.isAfter(start, hover)) {
+            return { start: hover, end: start };
+        }
+        return { start, end: hover };
+    }
+    // 시작만 선택됨, hover 없음
+    if (start && !end) {
+        return { start, end: null };
+    }
+    return { start: null, end: null };
+}
+function computeRangeFlags(iso, range, adapter) {
+    const { start, end } = range;
+    if (!start) {
+        return { isRangeStart: false, isRangeEnd: false, isInRange: false };
+    }
+    const isRangeStart = adapter.isSameDay(iso, start);
+    if (!end) {
+        return { isRangeStart, isRangeEnd: false, isInRange: false };
+    }
+    const isRangeEnd = adapter.isSameDay(iso, end);
+    const isInRange = !isRangeStart &&
+        !isRangeEnd &&
+        adapter.isAfter(iso, start) &&
+        adapter.isBefore(iso, end);
+    return { isRangeStart, isRangeEnd, isInRange };
+}
+/**
+ * 주어진 날짜가 비활성화 규칙에 해당하는지 검사한다.
+ */
+export function isDateDisabled(iso, rules, adapter) {
+    for (const rule of rules) {
+        if ('date' in rule) {
+            if (adapter.isSameDay(iso, rule.date))
+                return true;
+        }
+        else if ('before' in rule) {
+            if (adapter.isBefore(iso, rule.before))
+                return true;
+        }
+        else if ('after' in rule) {
+            if (adapter.isAfter(iso, rule.after))
+                return true;
+        }
+        else if ('dayOfWeek' in rule) {
+            if (rule.dayOfWeek.includes(adapter.getDay(iso)))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * 두 날짜 중 더 이른 것을 반환한다.
+ */
+export function minDate(a, b, adapter) {
+    return adapter.isBefore(a, b) ? a : b;
+}
+/**
+ * 두 날짜 중 더 늦은 것을 반환한다.
+ */
+export function maxDate(a, b, adapter) {
+    return adapter.isAfter(a, b) ? a : b;
+}
+//# sourceMappingURL=calendar.js.map

package/dist/utils/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/utils/calendar.ts"],"names":[],"mappings":"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"}

package/dist/utils/date.d.ts

@@ -0,0 +1,22 @@
+import type { DateAdapter } from '../types.js';
+/**
+ * 날짜 문자열을 ISO 8601 UTC 형식으로 정규화한다.
+ * "2026-01-15" → "2026-01-15T00:00:00.000Z"
+ */
+export declare function normalizeISO(value: string): string;
+/**
+ * 사용자 입력 텍스트를 ISO string으로 파싱한다.
+ * 실패 시 null을 반환한다.
+ */
+export declare function parseInputValue(input: string, format: string, adapter: DateAdapter): string | null;
+/** 주어진 달의 이름을 반환한다 (기본 영어) */
+export declare const WEEKDAY_LABELS: {
+    short: readonly ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"];
+    full: readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+};
+/** 주 시작 요일에 맞춰 요일 배열을 정렬한다 */
+export declare function getOrderedWeekdays(weekStartsOn?: 0 | 1): {
+    short: "Su" | "Mo" | "Tu" | "We" | "Th" | "Fr" | "Sa";
+    full: "Sunday" | "Monday" | "Tuesday" | "Wednesday" | "Thursday" | "Friday" | "Saturday";
+}[];
+//# sourceMappingURL=date.d.ts.map

package/dist/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,GACnB,MAAM,GAAG,IAAI,CAuBf;AAED,8BAA8B;AAC9B,eAAO,MAAM,cAAc;;;CAW1B,CAAC;AAEF,8BAA8B;AAC9B,wBAAgB,kBAAkB,CAAC,YAAY,GAAE,CAAC,GAAG,CAAK;;;IAYzD"}