mingpan 0.1.1 → 0.1.3

package/dist/shared/types.d.ts

@@ -15,7 +15,6 @@ export interface SubjectData {
     gender: 'male' | 'female';
     isLunar?: boolean;
     longitude?: number;
-    timezone?: string;
     birthPlace?: string;
     relationship?: string;
     notes?: string;

package/dist/shared/types.d.ts.map

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

package/dist/utils/timeNormalization.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 時間歸一化工具
+ *
+ * 設計原則：
+ * 1. 當前階段統一使用北京時間（UTC+8），不對外暴露時區參數
+ * 2. 農曆輸入在入口層即轉換為公曆，內部計算統一走公曆
+ *
+ * TODO: 多時區支持（M4 里程碑）
+ * - 新增 timezone 參數
+ * - 引入 date-fns-tz 或 @js-temporal/polyfill
+ */
+/** 北京時區 IANA 標識（內部使用） */
+export declare const BEIJING_TZ = "Asia/Shanghai";
+export interface BirthDateTimeInput {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute?: number;
+    isLunar?: boolean;
+}
+export interface NormalizedBirthDateTime {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    /** 標記原始輸入是否為農曆（用於輸出顯示） */
+    isLunarInput: boolean;
+}
+/**
+ * 歸一化出生日期時間
+ *
+ * 處理邏輯：
+ * 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 }
+ */
+export declare function normalizeBirthDateTime(input: BirthDateTimeInput): NormalizedBirthDateTime;
+//# sourceMappingURL=timeNormalization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeNormalization.d.ts","sourceRoot":"","sources":["../../src/utils/timeNormalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,yBAAyB;AACzB,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAM1C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,uBAAuB,CA8BzF"}

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.3",
   "description": "MCP service for accurate Bazi and Ziwei chart calculations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",