@typescript-calendar-lib/core 0.1.1

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@typescript-calendar-lib/core",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}

package/src/index.ts

@@ -0,0 +1,22 @@
+export {
+  getMonthName,
+  getWeekdayHeaders,
+  LOCALES,
+} from "./locale.ts";
+export type {
+  CalendarOptions,
+  CalendarRangeOptions,
+  CalendarYearOptions,
+  HighlightStyle,
+  Locale,
+  RenderMonthOptions,
+  WeekStart,
+} from "./types.ts";
+export {
+  buildMonthGrid,
+  firstDayOfMonth,
+  getMonthRange,
+  isDateInRange,
+  isSameDay,
+  lastDayOfMonth,
+} from "./utils.ts";

package/src/locale.test.ts

@@ -0,0 +1,175 @@
+import { describe, expect, test } from "vitest";
+import { getMonthName, getWeekdayHeaders, LOCALES } from "./locale.ts";
+
+describe("LOCALES", () => {
+  test("全ロケールが12ヶ月分の月名を持つ", () => {
+    for (const locale of Object.keys(LOCALES) as (keyof typeof LOCALES)[]) {
+      expect(LOCALES[locale].months).toHaveLength(12);
+    }
+  });
+
+  test("全ロケールが7曜日のヘッダを持つ", () => {
+    for (const locale of Object.keys(LOCALES) as (keyof typeof LOCALES)[]) {
+      expect(LOCALES[locale].weekdays).toHaveLength(7);
+      expect(LOCALES[locale].weekdaysShort).toHaveLength(7);
+      expect(LOCALES[locale].weekdaysMonday).toHaveLength(7);
+      expect(LOCALES[locale].weekdaysMondayShort).toHaveLength(7);
+    }
+  });
+
+  test("日本語以外のロケールが存在する", () => {
+    expect(Object.keys(LOCALES)).toEqual(
+      expect.arrayContaining(["en", "ja", "es", "de", "fr", "ko", "zh"]),
+    );
+  });
+});
+
+describe("getWeekdayHeaders", () => {
+  test("英語・日曜始まりはSunから", () => {
+    expect(getWeekdayHeaders("en", "sunday")).toEqual([
+      "Sun",
+      "Mon",
+      "Tue",
+      "Wed",
+      "Thu",
+      "Fri",
+      "Sat",
+    ]);
+  });
+
+  test("英語・月曜始まりはMonから", () => {
+    expect(getWeekdayHeaders("en", "monday")).toEqual([
+      "Mon",
+      "Tue",
+      "Wed",
+      "Thu",
+      "Fri",
+      "Sat",
+      "Sun",
+    ]);
+  });
+
+  test("日本語・日曜始まりは日から", () => {
+    expect(getWeekdayHeaders("ja", "sunday")).toEqual([
+      "日",
+      "月",
+      "火",
+      "水",
+      "木",
+      "金",
+      "土",
+    ]);
+  });
+
+  test("日本語・月曜始まりは月から", () => {
+    expect(getWeekdayHeaders("ja", "monday")).toEqual([
+      "月",
+      "火",
+      "水",
+      "木",
+      "金",
+      "土",
+      "日",
+    ]);
+  });
+
+  test("スペイン語・日曜始まり", () => {
+    expect(getWeekdayHeaders("es", "sunday")).toEqual([
+      "dom",
+      "lun",
+      "mar",
+      "mié",
+      "jue",
+      "vie",
+      "sáb",
+    ]);
+  });
+
+  test("ドイツ語・月曜始まり", () => {
+    expect(getWeekdayHeaders("de", "monday")).toEqual([
+      "Mo",
+      "Di",
+      "Mi",
+      "Do",
+      "Fr",
+      "Sa",
+      "So",
+    ]);
+  });
+
+  test("フランス語・日曜始まり", () => {
+    expect(getWeekdayHeaders("fr", "sunday")).toEqual([
+      "dim.",
+      "lun.",
+      "mar.",
+      "mer.",
+      "jeu.",
+      "ven.",
+      "sam.",
+    ]);
+  });
+
+  test("韓国語・月曜始まり", () => {
+    expect(getWeekdayHeaders("ko", "monday")).toEqual([
+      "월",
+      "화",
+      "수",
+      "목",
+      "금",
+      "토",
+      "일",
+    ]);
+  });
+
+  test("中国語・月曜始まり", () => {
+    expect(getWeekdayHeaders("zh", "monday")).toEqual([
+      "一",
+      "二",
+      "三",
+      "四",
+      "五",
+      "六",
+      "日",
+    ]);
+  });
+});
+
+describe("getMonthName", () => {
+  test("英語の月名", () => {
+    expect(getMonthName("en", 1)).toBe("January");
+    expect(getMonthName("en", 9)).toBe("September");
+    expect(getMonthName("en", 12)).toBe("December");
+  });
+
+  test("日本語の月名", () => {
+    expect(getMonthName("ja", 1)).toBe("1月");
+    expect(getMonthName("ja", 12)).toBe("12月");
+  });
+
+  test("スペイン語の月名", () => {
+    expect(getMonthName("es", 1)).toBe("enero");
+    expect(getMonthName("es", 9)).toBe("septiembre");
+    expect(getMonthName("es", 12)).toBe("diciembre");
+  });
+
+  test("ドイツ語の月名", () => {
+    expect(getMonthName("de", 1)).toBe("Januar");
+    expect(getMonthName("de", 3)).toBe("März");
+    expect(getMonthName("de", 12)).toBe("Dezember");
+  });
+
+  test("フランス語の月名", () => {
+    expect(getMonthName("fr", 1)).toBe("janvier");
+    expect(getMonthName("fr", 8)).toBe("août");
+  });
+
+  test("韓国語の月名", () => {
+    expect(getMonthName("ko", 1)).toBe("1월");
+    expect(getMonthName("ko", 12)).toBe("12월");
+  });
+
+  test("中国語の月名", () => {
+    expect(getMonthName("zh", 1)).toBe("一月");
+    expect(getMonthName("zh", 12)).toBe("十二月");
+  });
+});

package/src/locale.ts

@@ -0,0 +1,164 @@
+import type { Locale, WeekStart } from "./types.ts";
+
+export interface LocaleData {
+  months: readonly string[];
+  weekdays: readonly string[];
+  weekdaysShort: readonly string[];
+  weekdaysMonday: readonly string[];
+  weekdaysMondayShort: readonly string[];
+}
+
+export const LOCALES: Record<Locale, LocaleData> = {
+  en: {
+    months: [
+      "January",
+      "February",
+      "March",
+      "April",
+      "May",
+      "June",
+      "July",
+      "August",
+      "September",
+      "October",
+      "November",
+      "December",
+    ],
+    weekdays: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
+    weekdaysShort: ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"],
+    weekdaysMonday: ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"],
+    weekdaysMondayShort: ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"],
+  },
+  ja: {
+    months: [
+      "1月",
+      "2月",
+      "3月",
+      "4月",
+      "5月",
+      "6月",
+      "7月",
+      "8月",
+      "9月",
+      "10月",
+      "11月",
+      "12月",
+    ],
+    weekdays: ["日", "月", "火", "水", "木", "金", "土"],
+    weekdaysShort: ["日", "月", "火", "水", "木", "金", "土"],
+    weekdaysMonday: ["月", "火", "水", "木", "金", "土", "日"],
+    weekdaysMondayShort: ["月", "火", "水", "木", "金", "土", "日"],
+  },
+  es: {
+    months: [
+      "enero",
+      "febrero",
+      "marzo",
+      "abril",
+      "mayo",
+      "junio",
+      "julio",
+      "agosto",
+      "septiembre",
+      "octubre",
+      "noviembre",
+      "diciembre",
+    ],
+    weekdays: ["dom", "lun", "mar", "mié", "jue", "vie", "sáb"],
+    weekdaysShort: ["do", "lu", "ma", "mi", "ju", "vi", "sá"],
+    weekdaysMonday: ["lun", "mar", "mié", "jue", "vie", "sáb", "dom"],
+    weekdaysMondayShort: ["lu", "ma", "mi", "ju", "vi", "sá", "do"],
+  },
+  de: {
+    months: [
+      "Januar",
+      "Februar",
+      "März",
+      "April",
+      "Mai",
+      "Juni",
+      "Juli",
+      "August",
+      "September",
+      "Oktober",
+      "November",
+      "Dezember",
+    ],
+    weekdays: ["So", "Mo", "Di", "Mi", "Do", "Fr", "Sa"],
+    weekdaysShort: ["So", "Mo", "Di", "Mi", "Do", "Fr", "Sa"],
+    weekdaysMonday: ["Mo", "Di", "Mi", "Do", "Fr", "Sa", "So"],
+    weekdaysMondayShort: ["Mo", "Di", "Mi", "Do", "Fr", "Sa", "So"],
+  },
+  fr: {
+    months: [
+      "janvier",
+      "février",
+      "mars",
+      "avril",
+      "mai",
+      "juin",
+      "juillet",
+      "août",
+      "septembre",
+      "octobre",
+      "novembre",
+      "décembre",
+    ],
+    weekdays: ["dim.", "lun.", "mar.", "mer.", "jeu.", "ven.", "sam."],
+    weekdaysShort: ["di", "lu", "ma", "me", "je", "ve", "sa"],
+    weekdaysMonday: ["lun.", "mar.", "mer.", "jeu.", "ven.", "sam.", "dim."],
+    weekdaysMondayShort: ["lu", "ma", "me", "je", "ve", "sa", "di"],
+  },
+  ko: {
+    months: [
+      "1월",
+      "2월",
+      "3월",
+      "4월",
+      "5월",
+      "6월",
+      "7월",
+      "8월",
+      "9월",
+      "10월",
+      "11월",
+      "12월",
+    ],
+    weekdays: ["일", "월", "화", "수", "목", "금", "토"],
+    weekdaysShort: ["일", "월", "화", "수", "목", "금", "토"],
+    weekdaysMonday: ["월", "화", "수", "목", "금", "토", "일"],
+    weekdaysMondayShort: ["월", "화", "수", "목", "금", "토", "일"],
+  },
+  zh: {
+    months: [
+      "一月",
+      "二月",
+      "三月",
+      "四月",
+      "五月",
+      "六月",
+      "七月",
+      "八月",
+      "九月",
+      "十月",
+      "十一月",
+      "十二月",
+    ],
+    weekdays: ["日", "一", "二", "三", "四", "五", "六"],
+    weekdaysShort: ["日", "一", "二", "三", "四", "五", "六"],
+    weekdaysMonday: ["一", "二", "三", "四", "五", "六", "日"],
+    weekdaysMondayShort: ["一", "二", "三", "四", "五", "六", "日"],
+  },
+};
+
+export function getWeekdayHeaders(
+  locale: Locale,
+  weekStart: WeekStart,
+): readonly string[] {
+  const data = LOCALES[locale];
+  return weekStart === "monday" ? data.weekdaysMonday : data.weekdays;
+}
+
+export function getMonthName(locale: Locale, month: number): string {
+  return LOCALES[locale].months[month - 1]!;
+}

package/src/types.ts

@@ -0,0 +1,44 @@
+export type Locale = "en" | "ja" | "es" | "de" | "fr" | "ko" | "zh";
+export type WeekStart = "sunday" | "monday";
+export type HighlightStyle = "bracket" | "reverse";
+
+export interface CalendarOptions {
+  year: number;
+  month: number;
+  locale?: Locale;
+  weekStart?: WeekStart;
+  highlight?: Date;
+  highlightStyle?: HighlightStyle;
+  range?: { from: Date; to: Date };
+  color?: boolean;
+}
+
+export interface CalendarYearOptions {
+  year: number;
+  locale?: Locale;
+  weekStart?: WeekStart;
+  highlight?: Date;
+  highlightStyle?: HighlightStyle;
+  range?: { from: Date; to: Date };
+  color?: boolean;
+}
+
+export interface CalendarRangeOptions {
+  from: Date;
+  to: Date;
+  locale?: Locale;
+  weekStart?: WeekStart;
+  highlight?: Date;
+  highlightStyle?: HighlightStyle;
+  range?: { from: Date; to: Date };
+  color?: boolean;
+}
+
+export interface RenderMonthOptions {
+  locale?: Locale;
+  weekStart?: WeekStart;
+  highlight?: Date;
+  highlightStyle?: HighlightStyle;
+  range?: { from: Date; to: Date };
+  color?: boolean;
+}

package/src/utils.test.ts

@@ -0,0 +1,140 @@
+import { describe, expect, test } from "vitest";
+import {
+  buildMonthGrid,
+  firstDayOfMonth,
+  getMonthRange,
+  isDateInRange,
+  isSameDay,
+  lastDayOfMonth,
+} from "./utils.ts";
+
+describe("firstDayOfMonth", () => {
+  test("1月の月初", () => {
+    expect(firstDayOfMonth(2026, 1)).toEqual(new Date(2026, 0, 1));
+  });
+
+  test("12月の月初", () => {
+    expect(firstDayOfMonth(2026, 12)).toEqual(new Date(2026, 11, 1));
+  });
+});
+
+describe("lastDayOfMonth", () => {
+  test("30日で終わる月（4月は30日）", () => {
+    expect(lastDayOfMonth(2026, 4)).toEqual(new Date(2026, 3, 30));
+  });
+
+  test("31日で終わる月", () => {
+    expect(lastDayOfMonth(2026, 1)).toEqual(new Date(2026, 0, 31));
+  });
+
+  test("通常年の2月は28日", () => {
+    expect(lastDayOfMonth(2026, 2)).toEqual(new Date(2026, 1, 28));
+  });
+
+  test("うるう年の2月は29日", () => {
+    expect(lastDayOfMonth(2024, 2)).toEqual(new Date(2024, 1, 29));
+  });
+});
+
+describe("buildMonthGrid", () => {
+  test("gridは常に6行×7列", () => {
+    const grid = buildMonthGrid(2026, 9, "sunday");
+    expect(grid).toHaveLength(6);
+    for (const row of grid) {
+      expect(row).toHaveLength(7);
+    }
+  });
+
+  test("9月2026（日曜始まり）は1日が火曜から開始", () => {
+    const grid = buildMonthGrid(2026, 9, "sunday");
+    expect(grid[0]).toEqual([null, null, 1, 2, 3, 4, 5]);
+  });
+
+  test("9月2026（月曜始まり）は1日が月曜から開始", () => {
+    const grid = buildMonthGrid(2026, 9, "monday");
+    expect(grid[0]).toEqual([null, 1, 2, 3, 4, 5, 6]);
+  });
+
+  test("日付の日数が月末を超えない", () => {
+    const grid = buildMonthGrid(2026, 2, "sunday");
+    const flat = grid.flat().filter((d) => d !== null);
+    expect(Math.max(...(flat as number[]))).toBe(28);
+    expect(flat).toHaveLength(28);
+  });
+});
+
+describe("isDateInRange", () => {
+  const range = { from: new Date(2026, 8, 1), to: new Date(2026, 8, 15) };
+
+  test("範囲なしなら常にfalse", () => {
+    expect(isDateInRange(new Date(2026, 8, 1))).toBe(false);
+  });
+
+  test("範囲内の日付はtrue", () => {
+    expect(isDateInRange(new Date(2026, 8, 10), range)).toBe(true);
+  });
+
+  test("開始日は境界として含む", () => {
+    expect(isDateInRange(new Date(2026, 8, 1), range)).toBe(true);
+  });
+
+  test("終了日は境界として含む", () => {
+    expect(isDateInRange(new Date(2026, 8, 15), range)).toBe(true);
+  });
+
+  test("範囲外の前日はfalse", () => {
+    expect(isDateInRange(new Date(2026, 7, 31), range)).toBe(false);
+  });
+
+  test("範囲外の翌日はfalse", () => {
+    expect(isDateInRange(new Date(2026, 8, 16), range)).toBe(false);
+  });
+});
+
+describe("isSameDay", () => {
+  test("同じ日付はtrue", () => {
+    expect(
+      isSameDay(new Date(2026, 8, 8, 3, 30), new Date(2026, 8, 8, 20, 0)),
+    ).toBe(true);
+  });
+
+  test("異なる日はfalse", () => {
+    expect(isSameDay(new Date(2026, 8, 8), new Date(2026, 8, 9))).toBe(false);
+  });
+
+  test("同じ日だが異なる月はfalse", () => {
+    expect(isSameDay(new Date(2026, 8, 8), new Date(2026, 7, 8))).toBe(false);
+  });
+});
+
+describe("getMonthRange", () => {
+  test("同月内は1件", () => {
+    expect(getMonthRange(new Date(2026, 8, 1), new Date(2026, 8, 30))).toEqual([
+      { year: 2026, month: 9 },
+    ]);
+  });
+
+  test("複数月に跨る", () => {
+    expect(getMonthRange(new Date(2026, 5, 1), new Date(2026, 8, 30))).toEqual([
+      { year: 2026, month: 6 },
+      { year: 2026, month: 7 },
+      { year: 2026, month: 8 },
+      { year: 2026, month: 9 },
+    ]);
+  });
+
+  test("12月から翌年1月に跨る", () => {
+    expect(
+      getMonthRange(new Date(2025, 11, 31), new Date(2026, 0, 15)),
+    ).toEqual([
+      { year: 2025, month: 12 },
+      { year: 2026, month: 1 },
+    ]);
+  });
+
+  test("1年の範囲", () => {
+    expect(
+      getMonthRange(new Date(2026, 0, 1), new Date(2026, 11, 31)),
+    ).toHaveLength(12);
+  });
+});

package/src/utils.ts

@@ -0,0 +1,94 @@
+import type { WeekStart } from "./types.ts";
+
+/** 月初日（1日）を返す */
+export function firstDayOfMonth(year: number, month: number): Date {
+  return new Date(year, month - 1, 1);
+}
+
+/** 月末日を返す */
+export function lastDayOfMonth(year: number, month: number): Date {
+  return new Date(year, month, 0);
+}
+
+/**
+ * 月の日付グリッドを生成する（6行×7列）
+ * 各セルは日数（1-31）または null（空欄）
+ */
+export function buildMonthGrid(
+  year: number,
+  month: number,
+  weekStart: WeekStart,
+): (number | null)[][] {
+  const first = firstDayOfMonth(year, month);
+  const last = lastDayOfMonth(year, month);
+  const daysInMonth = last.getDate();
+
+  let startDayOfWeek = first.getDay();
+  if (weekStart === "monday") {
+    startDayOfWeek = (startDayOfWeek + 6) % 7;
+  }
+
+  const grid: (number | null)[][] = [];
+  let currentDay = 1;
+
+  for (let week = 0; week < 6; week++) {
+    const row: (number | null)[] = [];
+    for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {
+      if (
+        (week === 0 && dayOfWeek < startDayOfWeek) ||
+        currentDay > daysInMonth
+      ) {
+        row.push(null);
+      } else {
+        row.push(currentDay);
+        currentDay++;
+      }
+    }
+    grid.push(row);
+  }
+
+  return grid;
+}
+
+/** 日付が範囲内に含まれるか */
+export function isDateInRange(
+  date: Date,
+  range?: { from: Date; to: Date },
+): boolean {
+  if (!range) return false;
+  const time = date.getTime();
+  return time >= range.from.getTime() && time <= range.to.getTime();
+}
+
+/** 日付が今日と一致するか（日付のみ比較） */
+export function isSameDay(a: Date, b: Date): boolean {
+  return (
+    a.getFullYear() === b.getFullYear() &&
+    a.getMonth() === b.getMonth() &&
+    a.getDate() === b.getDate()
+  );
+}
+
+/** 日付が範囲の年开始から範囲の年结束までの月リストを返す */
+export function getMonthRange(
+  from: Date,
+  to: Date,
+): { year: number; month: number }[] {
+  const months: { year: number; month: number }[] = [];
+  let year = from.getFullYear();
+  let month = from.getMonth() + 1;
+
+  while (
+    year < to.getFullYear() ||
+    (year === to.getFullYear() && month <= to.getMonth() + 1)
+  ) {
+    months.push({ year, month });
+    month++;
+    if (month > 12) {
+      month = 1;
+      year++;
+    }
+  }
+
+  return months;
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}