mingpan 0.1.1 → 0.1.2

package/dist/utils/timeNormalization.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * 時間歸一化工具
+ *
+ * 設計原則：
+ * 1. 當前階段統一使用北京時間（UTC+8），不對外暴露時區參數
+ * 2. 農曆輸入在入口層即轉換為公曆，內部計算統一走公曆
+ *
+ * TODO: 多時區支持（M4 里程碑）
+ * - 新增 timezone 參數
+ * - 引入 date-fns-tz 或 @js-temporal/polyfill
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BEIJING_TZ = void 0;
+exports.normalizeBirthDateTime = normalizeBirthDateTime;
+const lunar_javascript_1 = require("lunar-javascript");
+// ============================================
+// Constants
+// ============================================
+/** 北京時區 IANA 標識（內部使用） */
+exports.BEIJING_TZ = 'Asia/Shanghai';
+// ============================================
+// Functions
+// ============================================
+/**
+ * 歸一化出生日期時間
+ *
+ * 處理邏輯：
+ * 1. 補齊 minute 默認值
+ * 2. 如果是農曆輸入，轉換為公曆
+ *
+ * @example
+ * // 公曆輸入
+ * normalizeBirthDateTime({ year: 1990, month: 5, day: 15, hour: 10 })
+ * // { year: 1990, month: 5, day: 15, hour: 10, minute: 0, isLunarInput: false }
+ *
+ * // 農曆輸入
+ * normalizeBirthDateTime({ year: 1990, month: 4, day: 21, hour: 10, isLunar: true })
+ * // { year: 1990, month: 5, day: 15, hour: 10, minute: 0, isLunarInput: true }
+ */
+function normalizeBirthDateTime(input) {
+    const minute = input.minute ?? 0;
+    const isLunarInput = !!input.isLunar;
+    // 公曆輸入：直接返回
+    if (!isLunarInput) {
+        return {
+            year: input.year,
+            month: input.month,
+            day: input.day,
+            hour: input.hour,
+            minute,
+            isLunarInput,
+        };
+    }
+    // 農曆輸入：轉換為公曆
+    // 注意：lunar-javascript 的 fromYmd 不處理閏月，閏月需要用 fromYmdHms 的第二個參數
+    // 當前簡化處理，閏月按本月算（與梅花易數口徑一致）
+    const lunar = lunar_javascript_1.Lunar.fromYmd(input.year, input.month, input.day);
+    const solar = lunar.getSolar();
+    return {
+        year: solar.getYear(),
+        month: solar.getMonth(),
+        day: solar.getDay(),
+        hour: input.hour,
+        minute,
+        isLunarInput,
+    };
+}
+//# sourceMappingURL=timeNormalization.js.map

package/dist/utils/timeNormalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeNormalization.js","sourceRoot":"","sources":["../../src/utils/timeNormalization.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAsDH,wDA8BC;AAlFD,uDAAyC;AAEzC,+CAA+C;AAC/C,YAAY;AACZ,+CAA+C;AAE/C,yBAAyB;AACZ,QAAA,UAAU,GAAG,eAAe,CAAC;AAyB1C,+CAA+C;AAC/C,YAAY;AACZ,+CAA+C;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,sBAAsB,CAAC,KAAyB;IAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IAErC,YAAY;IACZ,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM;YACN,YAAY;SACb,CAAC;IACJ,CAAC;IAED,aAAa;IACb,8DAA8D;IAC9D,2BAA2B;IAC3B,MAAM,KAAK,GAAG,wBAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAE/B,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE;QACrB,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;QACvB,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM;QACN,YAAY;KACb,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mingpan",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP service for accurate Bazi and Ziwei chart calculations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",