calendaryjs-plugin-lunar 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 calendaryjs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# calendaryjs-plugin-lunar
+
+Lunar (lunisolar) calendar plugin for [calendaryjs](https://github.com/calendaryjs/calendaryjs). Solar ↔ lunar date conversion (1900–2100) + lunar recurring events. Uses the standard astronomical lunisolar table.
+
+## Features
+
+- **🌙 Lunar events** — define events by lunar date (`type: "lunar"`)
+- **🔄 Date conversion** — solar ↔ lunar, 1900–2100
+- **🌏 Lunisolar** — standard astronomical lunisolar table
+- **📅 Leap-month handling** — correct intercalary-month calculations
+
+## Installation
+
+```bash
+pnpm add calendaryjs calendaryjs-plugin-lunar
+```
+
+## Requirements
+
+- `calendaryjs` >= 0.1.0
+
+## Quick Start
+
+```typescript
+import { calendary } from "calendaryjs";
+import { lunar } from "calendaryjs-plugin-lunar";
+
+const cal = calendary();
+cal.use(lunar());
+
+cal.addGroup({
+  id: "lunar-holidays",
+  name: "Lunar Holidays",
+  events: [
+    { type: "lunar", id: "lunar-new-year", lunarMonth: 1, lunarDay: 1, title: "Lunar New Year" },
+    { type: "lunar", id: "lantern", lunarMonth: 1, lunarDay: 15, title: "Lantern Festival" },
+    { type: "lunar", id: "mid-autumn", lunarMonth: 8, lunarDay: 15, title: "Mid-Autumn Festival" },
+  ],
+});
+
+// Get events - automatically converts lunar to solar dates
+const events = cal.getEventsInRange("2025-01-01", "2025-12-31");
+```
+
+## Event Type
+
+### `lunar`
+
+Events based on lunar calendar dates.
+
+```typescript
+{
+  type: 'lunar';
+  id: string;
+  lunarMonth: number;  // 1-12
+  lunarDay: number;    // 1-30
+  title?: string;
+  // ... other standard event properties
+}
+```
+
+## Lunar Date Conversion
+
+```typescript
+import { lunarToSolar, solarToLunar } from "calendaryjs-plugin-lunar";
+
+// Lunar to Solar
+const solarDate = lunarToSolar({ year: 2025, month: 1, day: 1, isLeapMonth: false });
+// Returns: { year: 2025, month: 1, day: 29 }
+
+// Solar to Lunar
+const lunarDate = solarToLunar({ year: 2025, month: 1, day: 29 });
+// Returns: { year: 2025, month: 1, day: 1, isLeapMonth: false }
+```
+
+## Example: lunar holidays
+
+```typescript
+import { calendary } from "calendaryjs";
+import { lunar } from "calendaryjs-plugin-lunar";
+
+const cal = calendary();
+cal.use(lunar());
+
+cal.addGroup({
+  id: "lunar-holidays",
+  name: "Lunar Holidays",
+  events: [
+    { type: "lunar", id: "lunar-new-year", lunarMonth: 1, lunarDay: 1, title: "Lunar New Year" },
+    { type: "lunar", id: "lantern", lunarMonth: 1, lunarDay: 15, title: "Lantern Festival" },
+    { type: "lunar", id: "dragon-boat", lunarMonth: 5, lunarDay: 5, title: "Dragon Boat Festival" },
+    { type: "lunar", id: "mid-autumn", lunarMonth: 8, lunarDay: 15, title: "Mid-Autumn Festival" },
+    {
+      type: "lunar",
+      id: "double-ninth",
+      lunarMonth: 9,
+      lunarDay: 9,
+      title: "Double Ninth Festival",
+    },
+  ],
+});
+```
+
+## Related Packages
+
+- [calendaryjs](https://github.com/calendaryjs/calendaryjs/tree/main/packages/calendaryjs) - Core package
+- [calendaryjs-plugin-liturgical](https://github.com/calendaryjs/calendaryjs/tree/main/packages/liturgical) - Liturgical calendar
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,373 @@
+'use strict';
+
+// package.json
+var package_default = {
+  name: "calendaryjs-plugin-lunar",
+  version: "0.1.0"};
+
+// src/converter.ts
+var LUNAR_INFO = [
+  19416,
+  19168,
+  42352,
+  21717,
+  53856,
+  55632,
+  91476,
+  22176,
+  39632,
+  21970,
+  19168,
+  42422,
+  42192,
+  53840,
+  119381,
+  46400,
+  54944,
+  44450,
+  38320,
+  84343,
+  18800,
+  42160,
+  46261,
+  27216,
+  27968,
+  109396,
+  11104,
+  38256,
+  21234,
+  18800,
+  25958,
+  54432,
+  59984,
+  92821,
+  23248,
+  11104,
+  100067,
+  37600,
+  116951,
+  51536,
+  54432,
+  120998,
+  46416,
+  22176,
+  107956,
+  9680,
+  37584,
+  53938,
+  43344,
+  46423,
+  27808,
+  46416,
+  86869,
+  19872,
+  42416,
+  83315,
+  21168,
+  43432,
+  59728,
+  27296,
+  44710,
+  43856,
+  19296,
+  43748,
+  42352,
+  21088,
+  62051,
+  55632,
+  23383,
+  22176,
+  38608,
+  19925,
+  19152,
+  42192,
+  54484,
+  53840,
+  54616,
+  46400,
+  46752,
+  103846,
+  38320,
+  18864,
+  43380,
+  42160,
+  45690,
+  27216,
+  27968,
+  44870,
+  43872,
+  38256,
+  19189,
+  18800,
+  25776,
+  29859,
+  59984,
+  27480,
+  23232,
+  43872,
+  38613,
+  37600,
+  51552,
+  55636,
+  54432,
+  55888,
+  30034,
+  22176,
+  43959,
+  9680,
+  37584,
+  51893,
+  43344,
+  46240,
+  47780,
+  44368,
+  21977,
+  19360,
+  42416,
+  86390,
+  21168,
+  43312,
+  31060,
+  27296,
+  44368,
+  23378,
+  19296,
+  42726,
+  42208,
+  53856,
+  60005,
+  54576,
+  23200,
+  30371,
+  38608,
+  19195,
+  19152,
+  42192,
+  118966,
+  53840,
+  54560,
+  56645,
+  46496,
+  22224,
+  21938,
+  18864,
+  42359,
+  42160,
+  43600,
+  111189,
+  27936,
+  44448,
+  84835,
+  37744,
+  18936,
+  18800,
+  25776,
+  92326,
+  59984,
+  27424,
+  108228,
+  43744,
+  37600,
+  53987,
+  51552,
+  54615,
+  54432,
+  55888,
+  23893,
+  22176,
+  42704,
+  21972,
+  21200,
+  43448,
+  43344,
+  46240,
+  46758,
+  44368,
+  21920,
+  43940,
+  42416,
+  21168,
+  45683,
+  26928,
+  29495,
+  27296,
+  44368,
+  84821,
+  19296,
+  42352,
+  21732,
+  53600,
+  59752,
+  54560,
+  55968,
+  92838,
+  22224,
+  19168,
+  43476,
+  41680,
+  53584,
+  62034,
+  54560
+];
+var BASE_YEAR = 1900;
+var BASE_DATE = new Date(Date.UTC(1900, 0, 31));
+function getLeapMonth(year) {
+  return LUNAR_INFO[year - BASE_YEAR] & 15;
+}
+function getLeapMonthDays(year) {
+  return getLeapMonth(year) ? LUNAR_INFO[year - BASE_YEAR] & 65536 ? 30 : 29 : 0;
+}
+function getLunarMonthDays(year, month) {
+  return LUNAR_INFO[year - BASE_YEAR] & 65536 >> month ? 30 : 29;
+}
+function getLunarYearDays(year) {
+  let sum = 348;
+  for (let i = 32768; i > 8; i >>= 1) {
+    sum += LUNAR_INFO[year - BASE_YEAR] & i ? 1 : 0;
+  }
+  return sum + getLeapMonthDays(year);
+}
+function solarToLunar(solar) {
+  const solarDate = new Date(Date.UTC(solar.year, solar.month - 1, solar.day));
+  let offset = Math.floor((solarDate.getTime() - BASE_DATE.getTime()) / 864e5);
+  let lunarYear = BASE_YEAR;
+  let yearDays;
+  while (lunarYear < 2100 && offset > 0) {
+    yearDays = getLunarYearDays(lunarYear);
+    if (offset < yearDays) break;
+    offset -= yearDays;
+    lunarYear++;
+  }
+  const leapMonth = getLeapMonth(lunarYear);
+  let isLeapMonth = false;
+  let lunarMonth = 1;
+  let monthDays;
+  for (let i = 1; i <= 12; i++) {
+    if (leapMonth > 0 && i === leapMonth + 1 && !isLeapMonth) {
+      monthDays = getLeapMonthDays(lunarYear);
+      isLeapMonth = true;
+      i--;
+    } else {
+      monthDays = getLunarMonthDays(lunarYear, i);
+      isLeapMonth = false;
+    }
+    if (offset < monthDays) {
+      lunarMonth = i;
+      break;
+    }
+    offset -= monthDays;
+  }
+  return {
+    year: lunarYear,
+    month: lunarMonth,
+    day: offset + 1,
+    isLeapMonth
+  };
+}
+function lunarToSolar(lunar2) {
+  let offset = 0;
+  for (let y = BASE_YEAR; y < lunar2.year; y++) {
+    offset += getLunarYearDays(y);
+  }
+  const leapMonth = getLeapMonth(lunar2.year);
+  for (let m = 1; m < lunar2.month; m++) {
+    offset += getLunarMonthDays(lunar2.year, m);
+    if (m === leapMonth) {
+      offset += getLeapMonthDays(lunar2.year);
+    }
+  }
+  if (lunar2.isLeapMonth && lunar2.month === leapMonth) {
+    offset += getLunarMonthDays(lunar2.year, lunar2.month);
+  }
+  offset += lunar2.day - 1;
+  const resultDate = new Date(BASE_DATE.getTime() + offset * 864e5);
+  return {
+    // Read back using UTC getters so we stay in the same calendar day
+    // regardless of local timezone.
+    year: resultDate.getUTCFullYear(),
+    month: resultDate.getUTCMonth() + 1,
+    day: resultDate.getUTCDate()
+  };
+}
+function isValidLunarDate(lunar2) {
+  if (lunar2.year < BASE_YEAR || lunar2.year > 2099) return false;
+  if (lunar2.month < 1 || lunar2.month > 12) return false;
+  const leapMonth = getLeapMonth(lunar2.year);
+  if (lunar2.isLeapMonth) {
+    if (lunar2.month !== leapMonth) return false;
+    const maxDays = getLeapMonthDays(lunar2.year);
+    if (lunar2.day < 1 || lunar2.day > maxDays) return false;
+  } else {
+    const maxDays = getLunarMonthDays(lunar2.year, lunar2.month);
+    if (lunar2.day < 1 || lunar2.day > maxDays) return false;
+  }
+  return true;
+}
+
+// src/generator.ts
+var lunarEventHandler = {
+  validate(event) {
+    if (typeof event !== "object" || event === null) return false;
+    const e = event;
+    return e.type === "lunar" && typeof e.lunarMonth === "number" && e.lunarMonth >= 1 && e.lunarMonth <= 12 && typeof e.lunarDay === "number" && e.lunarDay >= 1 && e.lunarDay <= 30 && typeof e.title === "string" && typeof e.id === "string";
+  },
+  generate(event, year) {
+    const lunarEvent = event;
+    const solar = lunarToSolar({
+      year,
+      month: lunarEvent.lunarMonth,
+      day: lunarEvent.lunarDay,
+      isLeapMonth: false
+    });
+    return [new Date(solar.year, solar.month - 1, solar.day)];
+  }
+};
+
+// src/plugin.ts
+var lunarDayEnricher = {
+  name: "lunar",
+  priority: 10,
+  // Run early so other enrichers can use lunar date
+  enrich: (day) => {
+    const lunarDate = solarToLunar({
+      year: day.year,
+      month: day.month,
+      day: day.day
+    });
+    return {
+      ...day,
+      lunar: {
+        year: lunarDate.year,
+        month: lunarDate.month,
+        day: lunarDate.day,
+        isLeapMonth: lunarDate.isLeapMonth
+      }
+    };
+  }
+};
+function lunarPlugin(options = {}) {
+  const { enrichDays = false } = options;
+  return {
+    name: package_default.name,
+    version: package_default.version,
+    install(calendary) {
+      if (enrichDays) {
+        calendary.registerDayEnricher(lunarDayEnricher);
+      }
+    },
+    eventTypes: {
+      lunar: lunarEventHandler
+    }
+  };
+}
+var lunar = Object.assign(lunarPlugin, {
+  /** Builder selector for a lunar date — `every("year").on(lunar.date(1, 1))`. */
+  date(month, day) {
+    return { type: "lunar", fields: { lunarMonth: month, lunarDay: day } };
+  }
+});
+
+exports.isValidLunarDate = isValidLunarDate;
+exports.lunar = lunar;
+exports.lunarToSolar = lunarToSolar;
+exports.solarToLunar = solarToLunar;

package/dist/index.d.cts

@@ -0,0 +1,134 @@
+import { CalendarDay, CalendaryPlugin, BaseEventProperties } from 'calendaryjs';
+import { Selector } from 'calendaryjs/builder';
+
+/**
+ * Lunar date info added by lunar plugin
+ */
+interface LunarInfo {
+    year: number;
+    month: number;
+    day: number;
+    isLeapMonth: boolean;
+}
+/**
+ * CalendarDay with lunar enrichment
+ */
+interface CalendarDayWithLunar extends CalendarDay {
+    lunar: LunarInfo;
+}
+/**
+ * Options for lunar plugin
+ */
+interface LunarPluginOptions {
+    /**
+     * Whether to enrich days with lunar date information.
+     * When true, getDays() will include lunarDate on each day.
+     * @default false
+     */
+    enrichDays?: boolean;
+}
+/**
+ * Lunar calendar plugin for Calendary
+ *
+ * Provides:
+ * - `lunar` event type for lunar calendar events
+ * - Optional day enricher that adds `lunar` info to CalendarDay (opt-in via enrichDays: true)
+ *
+ * @param options - Plugin options
+ *
+ * @example
+ * ```typescript
+ * const cal = calendary();
+ *
+ * // Basic usage - only lunar events, no day enrichment
+ * cal.use(lunar());
+ *
+ * // With day enrichment - getDays() will include lunar info
+ * cal.use(lunar({ enrichDays: true }));
+ *
+ * // Lunar events
+ * cal.addGroup({
+ *   id: "lunar-holidays",
+ *   name: "Lunar Holidays",
+ *   events: [
+ *     { type: "lunar", id: "lunar-new-year", title: "Lunar New Year", lunarMonth: 1, lunarDay: 1 }
+ *   ]
+ * });
+ *
+ * // With enrichDays: true, days have lunar info
+ * const day = cal.getDay("2025-01-29");
+ * console.log(day.lunar); // { year: 2025, month: 1, day: 1, isLeapMonth: false }
+ * ```
+ */
+declare function lunarPlugin(options?: LunarPluginOptions): CalendaryPlugin;
+/**
+ * The lunar plugin, plus a builder selector:
+ * - `calendary().use(lunar())` registers the `lunar` event type.
+ * - `every("year").on(lunar.date(1, 1))` authors a lunar event via the builder.
+ */
+declare const lunar: typeof lunarPlugin & {
+    /** Builder selector for a lunar date — `every("year").on(lunar.date(1, 1))`. */
+    date(month: number, day: number): Selector;
+};
+
+/**
+ * Module augmentation for CalendarDay.
+ * When this plugin is imported, TypeScript will recognize the optional `lunar` property
+ * on CalendarDay objects returned by getDays() and getDay().
+ */
+declare module "calendaryjs" {
+    interface CalendarDay {
+        /**
+         * Lunar date information (available when lunar plugin is used with enrichDays: true)
+         */
+        lunar?: LunarInfo;
+    }
+}
+/**
+ * Calendar date representation (year, month, day).
+ * Used for both solar and lunar dates in conversion functions.
+ */
+interface CalendarDate {
+    year: number;
+    month: number;
+    day: number;
+}
+/**
+ * Lunar date representation for internal converter use.
+ * Includes isLeapMonth flag needed for accurate lunar-solar conversion.
+ * @internal
+ */
+interface LunarDate extends CalendarDate {
+    isLeapMonth: boolean;
+}
+/**
+ * Solar date representation.
+ * Alias for CalendarDate for semantic clarity.
+ */
+type SolarDate = CalendarDate;
+/**
+ * Lunar event configuration.
+ * Developer only needs to provide lunarMonth and lunarDay.
+ * The plugin automatically handles leap month detection during date conversion.
+ * @template TMetadata - Custom metadata type extending Record<string, unknown>
+ */
+interface LunarEvent<TMetadata extends Record<string, unknown> = Record<string, unknown>> extends BaseEventProperties<TMetadata> {
+    type: "lunar";
+    lunarMonth: number;
+    lunarDay: number;
+}
+
+/**
+ * Convert solar date to lunar date
+ */
+declare function solarToLunar(solar: SolarDate): LunarDate;
+/**
+ * Convert lunar date to solar date
+ */
+declare function lunarToSolar(lunar: LunarDate): SolarDate;
+/**
+ * Check if a lunar date is valid
+ */
+declare function isValidLunarDate(lunar: LunarDate): boolean;
+
+export { type CalendarDate, type CalendarDayWithLunar, type LunarDate, type LunarEvent, type LunarInfo, type LunarPluginOptions, type SolarDate, isValidLunarDate, lunar, lunarToSolar, solarToLunar };

package/dist/index.d.ts

@@ -0,0 +1,134 @@
+import { CalendarDay, CalendaryPlugin, BaseEventProperties } from 'calendaryjs';
+import { Selector } from 'calendaryjs/builder';
+
+/**
+ * Lunar date info added by lunar plugin
+ */
+interface LunarInfo {
+    year: number;
+    month: number;
+    day: number;
+    isLeapMonth: boolean;
+}
+/**
+ * CalendarDay with lunar enrichment
+ */
+interface CalendarDayWithLunar extends CalendarDay {
+    lunar: LunarInfo;
+}
+/**
+ * Options for lunar plugin
+ */
+interface LunarPluginOptions {
+    /**
+     * Whether to enrich days with lunar date information.
+     * When true, getDays() will include lunarDate on each day.
+     * @default false
+     */
+    enrichDays?: boolean;
+}
+/**
+ * Lunar calendar plugin for Calendary
+ *
+ * Provides:
+ * - `lunar` event type for lunar calendar events
+ * - Optional day enricher that adds `lunar` info to CalendarDay (opt-in via enrichDays: true)
+ *
+ * @param options - Plugin options
+ *
+ * @example
+ * ```typescript
+ * const cal = calendary();
+ *
+ * // Basic usage - only lunar events, no day enrichment
+ * cal.use(lunar());
+ *
+ * // With day enrichment - getDays() will include lunar info
+ * cal.use(lunar({ enrichDays: true }));
+ *
+ * // Lunar events
+ * cal.addGroup({
+ *   id: "lunar-holidays",
+ *   name: "Lunar Holidays",
+ *   events: [
+ *     { type: "lunar", id: "lunar-new-year", title: "Lunar New Year", lunarMonth: 1, lunarDay: 1 }
+ *   ]
+ * });
+ *
+ * // With enrichDays: true, days have lunar info
+ * const day = cal.getDay("2025-01-29");
+ * console.log(day.lunar); // { year: 2025, month: 1, day: 1, isLeapMonth: false }
+ * ```
+ */
+declare function lunarPlugin(options?: LunarPluginOptions): CalendaryPlugin;
+/**
+ * The lunar plugin, plus a builder selector:
+ * - `calendary().use(lunar())` registers the `lunar` event type.
+ * - `every("year").on(lunar.date(1, 1))` authors a lunar event via the builder.
+ */
+declare const lunar: typeof lunarPlugin & {
+    /** Builder selector for a lunar date — `every("year").on(lunar.date(1, 1))`. */
+    date(month: number, day: number): Selector;
+};
+
+/**
+ * Module augmentation for CalendarDay.
+ * When this plugin is imported, TypeScript will recognize the optional `lunar` property
+ * on CalendarDay objects returned by getDays() and getDay().
+ */
+declare module "calendaryjs" {
+    interface CalendarDay {
+        /**
+         * Lunar date information (available when lunar plugin is used with enrichDays: true)
+         */
+        lunar?: LunarInfo;
+    }
+}
+/**
+ * Calendar date representation (year, month, day).
+ * Used for both solar and lunar dates in conversion functions.
+ */
+interface CalendarDate {
+    year: number;
+    month: number;
+    day: number;
+}
+/**
+ * Lunar date representation for internal converter use.
+ * Includes isLeapMonth flag needed for accurate lunar-solar conversion.
+ * @internal
+ */
+interface LunarDate extends CalendarDate {
+    isLeapMonth: boolean;
+}
+/**
+ * Solar date representation.
+ * Alias for CalendarDate for semantic clarity.
+ */
+type SolarDate = CalendarDate;
+/**
+ * Lunar event configuration.
+ * Developer only needs to provide lunarMonth and lunarDay.
+ * The plugin automatically handles leap month detection during date conversion.
+ * @template TMetadata - Custom metadata type extending Record<string, unknown>
+ */
+interface LunarEvent<TMetadata extends Record<string, unknown> = Record<string, unknown>> extends BaseEventProperties<TMetadata> {
+    type: "lunar";
+    lunarMonth: number;
+    lunarDay: number;
+}
+
+/**
+ * Convert solar date to lunar date
+ */
+declare function solarToLunar(solar: SolarDate): LunarDate;
+/**
+ * Convert lunar date to solar date
+ */
+declare function lunarToSolar(lunar: LunarDate): SolarDate;
+/**
+ * Check if a lunar date is valid
+ */
+declare function isValidLunarDate(lunar: LunarDate): boolean;
+
+export { type CalendarDate, type CalendarDayWithLunar, type LunarDate, type LunarEvent, type LunarInfo, type LunarPluginOptions, type SolarDate, isValidLunarDate, lunar, lunarToSolar, solarToLunar };

package/dist/index.js

@@ -0,0 +1,368 @@
+// package.json
+var package_default = {
+  name: "calendaryjs-plugin-lunar",
+  version: "0.1.0"};
+
+// src/converter.ts
+var LUNAR_INFO = [
+  19416,
+  19168,
+  42352,
+  21717,
+  53856,
+  55632,
+  91476,
+  22176,
+  39632,
+  21970,
+  19168,
+  42422,
+  42192,
+  53840,
+  119381,
+  46400,
+  54944,
+  44450,
+  38320,
+  84343,
+  18800,
+  42160,
+  46261,
+  27216,
+  27968,
+  109396,
+  11104,
+  38256,
+  21234,
+  18800,
+  25958,
+  54432,
+  59984,
+  92821,
+  23248,
+  11104,
+  100067,
+  37600,
+  116951,
+  51536,
+  54432,
+  120998,
+  46416,
+  22176,
+  107956,
+  9680,
+  37584,
+  53938,
+  43344,
+  46423,
+  27808,
+  46416,
+  86869,
+  19872,
+  42416,
+  83315,
+  21168,
+  43432,
+  59728,
+  27296,
+  44710,
+  43856,
+  19296,
+  43748,
+  42352,
+  21088,
+  62051,
+  55632,
+  23383,
+  22176,
+  38608,
+  19925,
+  19152,
+  42192,
+  54484,
+  53840,
+  54616,
+  46400,
+  46752,
+  103846,
+  38320,
+  18864,
+  43380,
+  42160,
+  45690,
+  27216,
+  27968,
+  44870,
+  43872,
+  38256,
+  19189,
+  18800,
+  25776,
+  29859,
+  59984,
+  27480,
+  23232,
+  43872,
+  38613,
+  37600,
+  51552,
+  55636,
+  54432,
+  55888,
+  30034,
+  22176,
+  43959,
+  9680,
+  37584,
+  51893,
+  43344,
+  46240,
+  47780,
+  44368,
+  21977,
+  19360,
+  42416,
+  86390,
+  21168,
+  43312,
+  31060,
+  27296,
+  44368,
+  23378,
+  19296,
+  42726,
+  42208,
+  53856,
+  60005,
+  54576,
+  23200,
+  30371,
+  38608,
+  19195,
+  19152,
+  42192,
+  118966,
+  53840,
+  54560,
+  56645,
+  46496,
+  22224,
+  21938,
+  18864,
+  42359,
+  42160,
+  43600,
+  111189,
+  27936,
+  44448,
+  84835,
+  37744,
+  18936,
+  18800,
+  25776,
+  92326,
+  59984,
+  27424,
+  108228,
+  43744,
+  37600,
+  53987,
+  51552,
+  54615,
+  54432,
+  55888,
+  23893,
+  22176,
+  42704,
+  21972,
+  21200,
+  43448,
+  43344,
+  46240,
+  46758,
+  44368,
+  21920,
+  43940,
+  42416,
+  21168,
+  45683,
+  26928,
+  29495,
+  27296,
+  44368,
+  84821,
+  19296,
+  42352,
+  21732,
+  53600,
+  59752,
+  54560,
+  55968,
+  92838,
+  22224,
+  19168,
+  43476,
+  41680,
+  53584,
+  62034,
+  54560
+];
+var BASE_YEAR = 1900;
+var BASE_DATE = new Date(Date.UTC(1900, 0, 31));
+function getLeapMonth(year) {
+  return LUNAR_INFO[year - BASE_YEAR] & 15;
+}
+function getLeapMonthDays(year) {
+  return getLeapMonth(year) ? LUNAR_INFO[year - BASE_YEAR] & 65536 ? 30 : 29 : 0;
+}
+function getLunarMonthDays(year, month) {
+  return LUNAR_INFO[year - BASE_YEAR] & 65536 >> month ? 30 : 29;
+}
+function getLunarYearDays(year) {
+  let sum = 348;
+  for (let i = 32768; i > 8; i >>= 1) {
+    sum += LUNAR_INFO[year - BASE_YEAR] & i ? 1 : 0;
+  }
+  return sum + getLeapMonthDays(year);
+}
+function solarToLunar(solar) {
+  const solarDate = new Date(Date.UTC(solar.year, solar.month - 1, solar.day));
+  let offset = Math.floor((solarDate.getTime() - BASE_DATE.getTime()) / 864e5);
+  let lunarYear = BASE_YEAR;
+  let yearDays;
+  while (lunarYear < 2100 && offset > 0) {
+    yearDays = getLunarYearDays(lunarYear);
+    if (offset < yearDays) break;
+    offset -= yearDays;
+    lunarYear++;
+  }
+  const leapMonth = getLeapMonth(lunarYear);
+  let isLeapMonth = false;
+  let lunarMonth = 1;
+  let monthDays;
+  for (let i = 1; i <= 12; i++) {
+    if (leapMonth > 0 && i === leapMonth + 1 && !isLeapMonth) {
+      monthDays = getLeapMonthDays(lunarYear);
+      isLeapMonth = true;
+      i--;
+    } else {
+      monthDays = getLunarMonthDays(lunarYear, i);
+      isLeapMonth = false;
+    }
+    if (offset < monthDays) {
+      lunarMonth = i;
+      break;
+    }
+    offset -= monthDays;
+  }
+  return {
+    year: lunarYear,
+    month: lunarMonth,
+    day: offset + 1,
+    isLeapMonth
+  };
+}
+function lunarToSolar(lunar2) {
+  let offset = 0;
+  for (let y = BASE_YEAR; y < lunar2.year; y++) {
+    offset += getLunarYearDays(y);
+  }
+  const leapMonth = getLeapMonth(lunar2.year);
+  for (let m = 1; m < lunar2.month; m++) {
+    offset += getLunarMonthDays(lunar2.year, m);
+    if (m === leapMonth) {
+      offset += getLeapMonthDays(lunar2.year);
+    }
+  }
+  if (lunar2.isLeapMonth && lunar2.month === leapMonth) {
+    offset += getLunarMonthDays(lunar2.year, lunar2.month);
+  }
+  offset += lunar2.day - 1;
+  const resultDate = new Date(BASE_DATE.getTime() + offset * 864e5);
+  return {
+    // Read back using UTC getters so we stay in the same calendar day
+    // regardless of local timezone.
+    year: resultDate.getUTCFullYear(),
+    month: resultDate.getUTCMonth() + 1,
+    day: resultDate.getUTCDate()
+  };
+}
+function isValidLunarDate(lunar2) {
+  if (lunar2.year < BASE_YEAR || lunar2.year > 2099) return false;
+  if (lunar2.month < 1 || lunar2.month > 12) return false;
+  const leapMonth = getLeapMonth(lunar2.year);
+  if (lunar2.isLeapMonth) {
+    if (lunar2.month !== leapMonth) return false;
+    const maxDays = getLeapMonthDays(lunar2.year);
+    if (lunar2.day < 1 || lunar2.day > maxDays) return false;
+  } else {
+    const maxDays = getLunarMonthDays(lunar2.year, lunar2.month);
+    if (lunar2.day < 1 || lunar2.day > maxDays) return false;
+  }
+  return true;
+}
+
+// src/generator.ts
+var lunarEventHandler = {
+  validate(event) {
+    if (typeof event !== "object" || event === null) return false;
+    const e = event;
+    return e.type === "lunar" && typeof e.lunarMonth === "number" && e.lunarMonth >= 1 && e.lunarMonth <= 12 && typeof e.lunarDay === "number" && e.lunarDay >= 1 && e.lunarDay <= 30 && typeof e.title === "string" && typeof e.id === "string";
+  },
+  generate(event, year) {
+    const lunarEvent = event;
+    const solar = lunarToSolar({
+      year,
+      month: lunarEvent.lunarMonth,
+      day: lunarEvent.lunarDay,
+      isLeapMonth: false
+    });
+    return [new Date(solar.year, solar.month - 1, solar.day)];
+  }
+};
+
+// src/plugin.ts
+var lunarDayEnricher = {
+  name: "lunar",
+  priority: 10,
+  // Run early so other enrichers can use lunar date
+  enrich: (day) => {
+    const lunarDate = solarToLunar({
+      year: day.year,
+      month: day.month,
+      day: day.day
+    });
+    return {
+      ...day,
+      lunar: {
+        year: lunarDate.year,
+        month: lunarDate.month,
+        day: lunarDate.day,
+        isLeapMonth: lunarDate.isLeapMonth
+      }
+    };
+  }
+};
+function lunarPlugin(options = {}) {
+  const { enrichDays = false } = options;
+  return {
+    name: package_default.name,
+    version: package_default.version,
+    install(calendary) {
+      if (enrichDays) {
+        calendary.registerDayEnricher(lunarDayEnricher);
+      }
+    },
+    eventTypes: {
+      lunar: lunarEventHandler
+    }
+  };
+}
+var lunar = Object.assign(lunarPlugin, {
+  /** Builder selector for a lunar date — `every("year").on(lunar.date(1, 1))`. */
+  date(month, day) {
+    return { type: "lunar", fields: { lunarMonth: month, lunarDay: day } };
+  }
+});
+
+export { isValidLunarDate, lunar, lunarToSolar, solarToLunar };

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "calendaryjs-plugin-lunar",
+  "version": "0.1.0",
+  "description": "Lunar (lunisolar) calendar plugin for calendaryjs — solar ↔ lunar date conversion (1900–2100) and lunar recurring events using the standard astronomical lunisolar table.",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "keywords": [
+    "lunar",
+    "lunar-calendar",
+    "lunisolar",
+    "leap-month",
+    "calendar",
+    "calendaryjs",
+    "calendaryjs-plugin",
+    "plugin"
+  ],
+  "calendaryjs": {
+    "category": "calendar"
+  },
+  "author": "calendaryjs",
+  "license": "MIT",
+  "peerDependencies": {
+    "calendaryjs": ">=0.1.0"
+  },
+  "devDependencies": {
+    "lunar-javascript": "^1.7.7",
+    "typescript": "^5.3.2",
+    "vitest": "^4.0.18",
+    "calendaryjs": "0.2.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "tsup": {
+    "entry": [
+      "src/index.ts"
+    ],
+    "format": [
+      "esm",
+      "cjs"
+    ],
+    "dts": true,
+    "clean": true,
+    "treeshake": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/calendaryjs/calendaryjs.git",
+    "directory": "packages/lunar"
+  },
+  "homepage": "https://github.com/calendaryjs/calendaryjs/tree/main/packages/lunar#readme",
+  "bugs": {
+    "url": "https://github.com/calendaryjs/calendaryjs/issues"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "tsup",
+    "test:coverage": "vitest run --coverage"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}