@aigne/moonphase 1.11.0-beta.12

package/LICENSE.md

@@ -0,0 +1,26 @@
+# Proprietary License
+
+Copyright (c) 2024-2025 ArcBlock, Inc. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential. Unauthorized copying, modification, distribution, or use of
+this Software, via any medium, is strictly prohibited.
+
+The Software is provided for internal use only within ArcBlock, Inc. and its
+authorized affiliates.
+
+## No License Granted
+
+No license, express or implied, is granted to any party for any purpose.
+All rights are reserved by ArcBlock, Inc.
+
+## Public Artifact Distribution
+
+Portions of this Software may be released publicly under separate open-source
+licenses (such as MIT License) through designated public repositories. Such
+public releases are governed by their respective licenses and do not affect
+the proprietary nature of this repository.
+
+## Contact
+
+For licensing inquiries, contact: legal@arcblock.io

package/dist/index.d.mts

@@ -0,0 +1,36 @@
+//#region src/index.d.ts
+/**
+ * Lunar phase calculator — pure math, zero dependencies.
+ *
+ * Ported from lunarphase-calculator (blocklet/aistro).
+ */
+/** Mean synodic month in days (new moon → new moon). */
+declare const SYNODIC_MONTH = 29.53058770576;
+type LunarPhase = "NEW_MOON" | "WAXING_CRESCENT" | "FIRST_QUARTER" | "WAXING_GIBBOUS" | "FULL_MOON" | "WANING_GIBBOUS" | "LAST_QUARTER" | "WANING_CRESCENT";
+declare const PHASES: readonly LunarPhase[];
+/** Convert a Gregorian Date to Julian Day Number. */
+declare function toJDN(date: Date): number;
+/** Convert a Julian Day Number back to [year, month, day]. */
+declare function fromJDN(jdn: number): [year: number, month: number, day: number];
+/**
+ * Fractional lunar day (0 = new moon, ~14.77 = full moon, ~29.53 = next new moon).
+ */
+declare function getLunarDay(date?: Date): number;
+/** Map a lunar day to its named phase. */
+declare function getLunarPhase(lunarDay?: number): LunarPhase;
+/** Illumination fraction (0 = new moon, 1 = full moon). */
+declare function getIllumination(lunarDay?: number): number;
+interface PhaseInfo {
+  date: string;
+  lunarDay: number;
+  phase: LunarPhase;
+  illumination: number;
+}
+/** Full phase info for a given date. */
+declare function getPhaseInfo(date?: Date): PhaseInfo;
+/** Phase for each day of the given month. */
+declare function getMonthPhases(year: number, month: number): PhaseInfo[];
+declare function getPhaseEmoji(phase: LunarPhase): string;
+//#endregion
+export { LunarPhase, PHASES, PhaseInfo, SYNODIC_MONTH, fromJDN, getIllumination, getLunarDay, getLunarPhase, getMonthPhases, getPhaseEmoji, getPhaseInfo, toJDN };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;AASA;;;;;cAAa,aAAA;AAAA,KAoBD,UAAA;AAAA,cAUC,MAAA,WAAiB,UAAA;;iBAcd,KAAA,CAAM,IAAA,EAAM,IAAA;AAd5B;AAAA,iBAmCgB,OAAA,CAAQ,GAAA,YAAe,IAAA,UAAc,KAAA,UAAe,GAAA;;;;iBAoBpD,WAAA,CAAY,IAAA,GAAM,IAAA;;iBASlB,aAAA,CAAc,QAAA,YAAmC,UAAA;;iBAcjD,eAAA,CAAgB,QAAA;AAAA,UAOf,SAAA;EACf,IAAA;EACA,QAAA;EACA,KAAA,EAAO,UAAA;EACP,YAAA;AAAA;;iBAIc,YAAA,CAAa,IAAA,GAAM,IAAA,GAAoB,SAAA;;iBAWvC,cAAA,CAAe,IAAA,UAAc,KAAA,WAAgB,SAAA;AAAA,iBAsB7C,aAAA,CAAc,KAAA,EAAO,UAAA"}

package/dist/index.mjs

@@ -0,0 +1,117 @@
+//#region src/index.ts
+/**
+* Lunar phase calculator — pure math, zero dependencies.
+*
+* Ported from lunarphase-calculator (blocklet/aistro).
+*/
+/** Mean synodic month in days (new moon → new moon). */
+const SYNODIC_MONTH = 29.53058770576;
+/** JDN of a known new-moon reference epoch (2000-01-06 18:14 UTC). */
+const START_JDN = 2451550.1;
+/** Phase boundary thresholds (in lunar days 0–29.53). */
+const BOUNDARIES = {
+	WAXING_CRESCENT: 1,
+	FIRST_QUARTER: 6.382647,
+	WAXING_GIBBOUS: 8.382647,
+	FULL_MOON: 13.765294,
+	WANING_GIBBOUS: 15.765294,
+	LAST_QUARTER: 21.147941,
+	WANING_CRESCENT: 23.147941,
+	NEW_MOON_UPPER: 28.530588,
+	NEW_MOON_UPPER_END: 29.530588
+};
+const PHASES = [
+	"NEW_MOON",
+	"WAXING_CRESCENT",
+	"FIRST_QUARTER",
+	"WAXING_GIBBOUS",
+	"FULL_MOON",
+	"WANING_GIBBOUS",
+	"LAST_QUARTER",
+	"WANING_CRESCENT"
+];
+/** Convert a Gregorian Date to Julian Day Number. */
+function toJDN(date) {
+	const day = date.getUTCDate();
+	const month = date.getUTCMonth() + 1;
+	const year = date.getFullYear();
+	const a = Math.trunc((14 - month) / 12);
+	const y = year + 4800 - a;
+	const m = month + 12 * a - 3;
+	return day + Math.trunc((153 * m + 2) / 5) + 365 * y + Math.trunc(y / 4) - Math.trunc(y / 100) + Math.trunc(y / 400) - 32045;
+}
+/** Convert a Julian Day Number back to [year, month, day]. */
+function fromJDN(jdn) {
+	const a = jdn + 32044;
+	const b = Math.trunc((4 * a + 3) / 146097);
+	const c = a - Math.trunc(146097 * b / 4);
+	const d = Math.trunc((4 * c + 3) / 1461);
+	const e = c - Math.trunc(1461 * d / 4);
+	const mo = Math.trunc((5 * e + 2) / 153);
+	const day = e - Math.trunc((153 * mo + 2) / 5) + 1;
+	const month = mo + 3 - 12 * Math.trunc(mo / 10);
+	return [
+		100 * b + d - 4800 + Math.trunc(mo / 10),
+		month,
+		day
+	];
+}
+/**
+* Fractional lunar day (0 = new moon, ~14.77 = full moon, ~29.53 = next new moon).
+*/
+function getLunarDay(date = /* @__PURE__ */ new Date()) {
+	const raw = (toJDN(date) - START_JDN) / SYNODIC_MONTH;
+	const frac = raw - Math.floor(raw);
+	return (frac < 0 ? frac + 1 : frac) * SYNODIC_MONTH;
+}
+/** Map a lunar day to its named phase. */
+function getLunarPhase(lunarDay = getLunarDay()) {
+	if (lunarDay < BOUNDARIES.WAXING_CRESCENT) return "NEW_MOON";
+	if (lunarDay < BOUNDARIES.FIRST_QUARTER) return "WAXING_CRESCENT";
+	if (lunarDay < BOUNDARIES.WAXING_GIBBOUS) return "FIRST_QUARTER";
+	if (lunarDay < BOUNDARIES.FULL_MOON) return "WAXING_GIBBOUS";
+	if (lunarDay < BOUNDARIES.WANING_GIBBOUS) return "FULL_MOON";
+	if (lunarDay < BOUNDARIES.LAST_QUARTER) return "WANING_GIBBOUS";
+	if (lunarDay < BOUNDARIES.WANING_CRESCENT) return "LAST_QUARTER";
+	if (lunarDay < BOUNDARIES.NEW_MOON_UPPER) return "WANING_CRESCENT";
+	if (lunarDay < BOUNDARIES.NEW_MOON_UPPER_END) return "NEW_MOON";
+	throw new RangeError(`Lunar day ${lunarDay} is out of range [0, ${SYNODIC_MONTH})`);
+}
+/** Illumination fraction (0 = new moon, 1 = full moon). */
+function getIllumination(lunarDay = getLunarDay()) {
+	return (1 - Math.cos(lunarDay / SYNODIC_MONTH * 2 * Math.PI)) / 2;
+}
+/** Full phase info for a given date. */
+function getPhaseInfo(date = /* @__PURE__ */ new Date()) {
+	const lunarDay = getLunarDay(date);
+	return {
+		date: date.toISOString().slice(0, 10),
+		lunarDay: +lunarDay.toFixed(4),
+		phase: getLunarPhase(lunarDay),
+		illumination: +getIllumination(lunarDay).toFixed(4)
+	};
+}
+/** Phase for each day of the given month. */
+function getMonthPhases(year, month) {
+	const results = [];
+	const daysInMonth = new Date(year, month, 0).getDate();
+	for (let day = 1; day <= daysInMonth; day++) results.push(getPhaseInfo(new Date(year, month - 1, day)));
+	return results;
+}
+const PHASE_EMOJI = {
+	NEW_MOON: "🌑",
+	WAXING_CRESCENT: "🌒",
+	FIRST_QUARTER: "🌓",
+	WAXING_GIBBOUS: "🌔",
+	FULL_MOON: "🌕",
+	WANING_GIBBOUS: "🌖",
+	LAST_QUARTER: "🌗",
+	WANING_CRESCENT: "🌘"
+};
+function getPhaseEmoji(phase) {
+	return PHASE_EMOJI[phase];
+}
+
+//#endregion
+export { PHASES, SYNODIC_MONTH, fromJDN, getIllumination, getLunarDay, getLunarPhase, getMonthPhases, getPhaseEmoji, getPhaseInfo, toJDN };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Lunar phase calculator — pure math, zero dependencies.\n *\n * Ported from lunarphase-calculator (blocklet/aistro).\n */\n\n// ── Constants ──\n\n/** Mean synodic month in days (new moon → new moon). */\nexport const SYNODIC_MONTH = 29.53058770576;\n\n/** JDN of a known new-moon reference epoch (2000-01-06 18:14 UTC). */\nconst START_JDN = 2451550.1;\n\n/** Phase boundary thresholds (in lunar days 0–29.53). */\nconst BOUNDARIES = {\n  WAXING_CRESCENT: 1,\n  FIRST_QUARTER: 6.382647,\n  WAXING_GIBBOUS: 8.382647,\n  FULL_MOON: 13.765294,\n  WANING_GIBBOUS: 15.765294,\n  LAST_QUARTER: 21.147941,\n  WANING_CRESCENT: 23.147941,\n  NEW_MOON_UPPER: 28.530588,\n  NEW_MOON_UPPER_END: 29.530588,\n} as const;\n\n// ── Phase enum ──\n\nexport type LunarPhase =\n  | \"NEW_MOON\"\n  | \"WAXING_CRESCENT\"\n  | \"FIRST_QUARTER\"\n  | \"WAXING_GIBBOUS\"\n  | \"FULL_MOON\"\n  | \"WANING_GIBBOUS\"\n  | \"LAST_QUARTER\"\n  | \"WANING_CRESCENT\";\n\nexport const PHASES: readonly LunarPhase[] = [\n  \"NEW_MOON\",\n  \"WAXING_CRESCENT\",\n  \"FIRST_QUARTER\",\n  \"WAXING_GIBBOUS\",\n  \"FULL_MOON\",\n  \"WANING_GIBBOUS\",\n  \"LAST_QUARTER\",\n  \"WANING_CRESCENT\",\n] as const;\n\n// ── Julian Day Number conversion ──\n\n/** Convert a Gregorian Date to Julian Day Number. */\nexport function toJDN(date: Date): number {\n  const day = date.getUTCDate();\n  const month = date.getUTCMonth() + 1;\n  const year = date.getFullYear();\n\n  const a = Math.trunc((14 - month) / 12);\n  const y = year + 4800 - a;\n  const m = month + 12 * a - 3;\n\n  return (\n    day +\n    Math.trunc((153 * m + 2) / 5) +\n    365 * y +\n    Math.trunc(y / 4) -\n    Math.trunc(y / 100) +\n    Math.trunc(y / 400) -\n    32045\n  );\n}\n\n/** Convert a Julian Day Number back to [year, month, day]. */\nexport function fromJDN(jdn: number): [year: number, month: number, day: number] {\n  const a = jdn + 32044;\n  const b = Math.trunc((4 * a + 3) / 146097);\n  const c = a - Math.trunc((146097 * b) / 4);\n  const d = Math.trunc((4 * c + 3) / 1461);\n  const e = c - Math.trunc((1461 * d) / 4);\n  const mo = Math.trunc((5 * e + 2) / 153);\n\n  const day = e - Math.trunc((153 * mo + 2) / 5) + 1;\n  const month = mo + 3 - 12 * Math.trunc(mo / 10);\n  const year = 100 * b + d - 4800 + Math.trunc(mo / 10);\n\n  return [year, month, day];\n}\n\n// ── Core calculation ──\n\n/**\n * Fractional lunar day (0 = new moon, ~14.77 = full moon, ~29.53 = next new moon).\n */\nexport function getLunarDay(date: Date = new Date()): number {\n  const jdn = toJDN(date);\n  const raw = (jdn - START_JDN) / SYNODIC_MONTH;\n  const frac = raw - Math.floor(raw);\n  const norm = frac < 0 ? frac + 1 : frac;\n  return norm * SYNODIC_MONTH;\n}\n\n/** Map a lunar day to its named phase. */\nexport function getLunarPhase(lunarDay: number = getLunarDay()): LunarPhase {\n  if (lunarDay < BOUNDARIES.WAXING_CRESCENT) return \"NEW_MOON\";\n  if (lunarDay < BOUNDARIES.FIRST_QUARTER) return \"WAXING_CRESCENT\";\n  if (lunarDay < BOUNDARIES.WAXING_GIBBOUS) return \"FIRST_QUARTER\";\n  if (lunarDay < BOUNDARIES.FULL_MOON) return \"WAXING_GIBBOUS\";\n  if (lunarDay < BOUNDARIES.WANING_GIBBOUS) return \"FULL_MOON\";\n  if (lunarDay < BOUNDARIES.LAST_QUARTER) return \"WANING_GIBBOUS\";\n  if (lunarDay < BOUNDARIES.WANING_CRESCENT) return \"LAST_QUARTER\";\n  if (lunarDay < BOUNDARIES.NEW_MOON_UPPER) return \"WANING_CRESCENT\";\n  if (lunarDay < BOUNDARIES.NEW_MOON_UPPER_END) return \"NEW_MOON\";\n  throw new RangeError(`Lunar day ${lunarDay} is out of range [0, ${SYNODIC_MONTH})`);\n}\n\n/** Illumination fraction (0 = new moon, 1 = full moon). */\nexport function getIllumination(lunarDay: number = getLunarDay()): number {\n  // Simple cosine approximation\n  return (1 - Math.cos((lunarDay / SYNODIC_MONTH) * 2 * Math.PI)) / 2;\n}\n\n// ── Convenience ──\n\nexport interface PhaseInfo {\n  date: string;\n  lunarDay: number;\n  phase: LunarPhase;\n  illumination: number;\n}\n\n/** Full phase info for a given date. */\nexport function getPhaseInfo(date: Date = new Date()): PhaseInfo {\n  const lunarDay = getLunarDay(date);\n  return {\n    date: date.toISOString().slice(0, 10),\n    lunarDay: +lunarDay.toFixed(4),\n    phase: getLunarPhase(lunarDay),\n    illumination: +getIllumination(lunarDay).toFixed(4),\n  };\n}\n\n/** Phase for each day of the given month. */\nexport function getMonthPhases(year: number, month: number): PhaseInfo[] {\n  const results: PhaseInfo[] = [];\n  const daysInMonth = new Date(year, month, 0).getDate(); // month is 1-based here\n  for (let day = 1; day <= daysInMonth; day++) {\n    results.push(getPhaseInfo(new Date(year, month - 1, day)));\n  }\n  return results;\n}\n\n// ── Phase emoji (for display) ──\n\nconst PHASE_EMOJI: Record<LunarPhase, string> = {\n  NEW_MOON: \"\\u{1F311}\",\n  WAXING_CRESCENT: \"\\u{1F312}\",\n  FIRST_QUARTER: \"\\u{1F313}\",\n  WAXING_GIBBOUS: \"\\u{1F314}\",\n  FULL_MOON: \"\\u{1F315}\",\n  WANING_GIBBOUS: \"\\u{1F316}\",\n  LAST_QUARTER: \"\\u{1F317}\",\n  WANING_CRESCENT: \"\\u{1F318}\",\n};\n\nexport function getPhaseEmoji(phase: LunarPhase): string {\n  return PHASE_EMOJI[phase];\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@aigne/moonphase",
+  "version": "1.11.0-beta.12",
+  "description": "Lunar phase calculator — pure math, zero dependencies",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Arcblock <blocklet@arcblock.io> https://github.com/arcblock",
+  "homepage": "https://github.com/arcblock/afs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arcblock/afs"
+  },
+  "bugs": {
+    "url": "https://github.com/arcblock/afs/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs"
+    },
+    "./*": "./*"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "devDependencies": {
+    "@types/bun": "^1.3.6",
+    "npm-run-all": "^4.1.5",
+    "rimraf": "^6.1.2",
+    "tsdown": "0.20.0-beta.3",
+    "typescript": "5.9.2",
+    "@aigne/scripts": "0.0.0",
+    "@aigne/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check-types": "tsc --noEmit",
+    "clean": "rimraf dist coverage",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage --coverage-reporter=lcov --coverage-reporter=text"
+  }
+}