mingpan 0.1.2 → 0.1.4

package/dist/tools/ziweiTools.js

@@ -0,0 +1,483 @@
+"use strict";
+/**
+ * 紫微斗数 MCP 工具
+ *
+ * 工具列表：
+ * - ziwei_basic      基礎排盤（十二宮、主星、四化）
+ * - ziwei_daxian     大限列表
+ * - ziwei_xiaoxian   小限列表
+ * - ziwei_liunian    流年列表
+ * - ziwei_liuyue     流月列表（農曆月）
+ * - ziwei_liuri      流日列表（農曆日）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerZiweiTools = registerZiweiTools;
+const zod_1 = require("zod");
+const lunar_javascript_1 = require("lunar-javascript");
+const ZiweiService_1 = require("../services/ziwei/ZiweiService");
+const YearlyCalculator_1 = require("../services/ziwei/calculators/YearlyCalculator");
+const MutagenCore_1 = require("../core/ziwei/MutagenCore");
+const fortuneTextRenderer_1 = require("../output/fortuneTextRenderer");
+const listTextRenderer_1 = require("../output/listTextRenderer");
+const schemas_1 = require("./schemas");
+const ziweiService = new ZiweiService_1.ZiweiService();
+const detailField = zod_1.z.enum(['simple', 'standard', 'detailed']).optional().default('standard').describe('Output detail level');
+const countField = zod_1.z.number().int().min(1).max(12).optional().default(10).describe('Number of decade periods to display (default 10)');
+/** 提取命宮主星（宮位名稱兼容繁簡） */
+function findMingGong(result) {
+    return result.palaces?.find(p => p.name === '命宮' || p.name === '命宫' || p.name === 'Life');
+}
+function extractStars(palace) {
+    return palace?.majorStars?.map(s => (typeof s === 'string' ? s : s.name)) || [];
+}
+function registerZiweiTools(server) {
+    server.registerTool('ziwei_basic', {
+        title: '紫微基礎排盤',
+        description: `計算紫微斗數命盤（基礎排盤）。
+
+輸入出生時間，返回完整的紫微命盤信息：
+- 十二宮位排布及干支
+- 各宮主星及亮度（廟/旺/得/利/平/不/陷）
+- 各宮輔星配置
+- 命宮與身宮位置
+- 五行局、命主、身主
+- 本命四化（化祿/權/科/忌）
+
+時區說明：默認按北京時間排盤；海外出生者請提供 timezone 參數。
+
+輸出為結構化文本，便於 AI 分析解讀。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            detail: detailField,
+            targetYear: zod_1.z.number().int().optional().describe('Calculate yearly fortune for this specific year'),
+            includeDecades: zod_1.z.boolean().optional().default(true).describe('Include decade fortune (大限)'),
+            includeMutagen: zod_1.z.boolean().optional().default(true).describe('Include four mutagens (四化)'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('ziwei_basic', async () => {
+        const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await ziweiService.calculate({
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            gender: normalized.gender,
+        });
+        const options = {
+            detail: args.detail,
+            includePersonal: false,
+        };
+        const birthDate = new Date(normalized.year, normalized.month - 1, normalized.day, normalized.hour, normalized.minute);
+        return (0, schemas_1.timezoneNote)(sourceTimezone) + (0, fortuneTextRenderer_1.renderZiweiText)({
+            ziwei: result,
+            gender: normalized.gender,
+            birthDate,
+            mutagen: result.mutagenInfo,
+        }, options);
+    }));
+    server.registerTool('ziwei_daxian', {
+        title: '紫微大限列表',
+        description: `紫微大限列表。
+
+返回命主一生的大限週期（十年一限）：
+- 起止虛歲
+- 對應公曆年份
+- 大限宮位名稱
+- 宮內主星配置
+- 大限四化
+
+用於了解人生各階段的運勢大框架。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            count: countField,
+        },
+    }, async (args) => (0, schemas_1.textResult)('ziwei_daxian', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await ziweiService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, gender: normalized.gender,
+        });
+        if (!result.decades || result.decades.length === 0) {
+            throw new Error('Failed to calculate ZiWei decades');
+        }
+        const yangStems = ['甲', '丙', '戊', '庚', '壬'];
+        const yearStem = result.basicInfo?.fourPillars?.year?.stem || '';
+        const isYang = yangStems.includes(yearStem);
+        const isMale = normalized.gender === 'male';
+        const direction = ((isYang && isMale) || (!isYang && !isMale)) ? '顺行' : '逆行';
+        const mingGongPalace = findMingGong(result);
+        const mingGongStars = extractStars(mingGongPalace);
+        const shenGongPalace = result.palaces?.find(p => p.isBodyPalace);
+        const shenGongStars = extractStars(shenGongPalace);
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            mingGong: mingGongPalace?.name || '命宮',
+            mingGongStars,
+            shenGong: shenGongPalace?.name,
+            shenGongStars,
+            palaces: result.palaces,
+            mutagenInfo: result.mutagenInfo,
+            direction,
+        };
+        return (0, listTextRenderer_1.renderZiweiDaXianList)(result.decades.slice(0, args.count), options);
+    }));
+    server.registerTool('ziwei_xiaoxian', {
+        title: '紫微小限列表',
+        description: `紫微小限列表。
+
+小限是紫微斗數中的年度運限單位，每年一宮：
+- 虛歲（1歲起）
+- 對應公曆年份
+- 小限宮位（根據出生年支起宮，男順女逆）
+- 宮內主星
+- 所屬大限
+- 小限四化
+
+小限與流年並列但計算方式不同：
+- 小限：以出生年支定起宮，逐年移宮
+- 流年：以該年地支定宮位
+
+層級順序：大限 > 小限 > 流年 > 流月 > 流日`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            startAge: zod_1.z.number().int().min(1).max(120).describe('Start age (nominal age) for the range'),
+            endAge: zod_1.z.number().int().min(1).max(120).describe('End age (nominal age) for the range'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('ziwei_xiaoxian', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await ziweiService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, gender: normalized.gender,
+        });
+        if (!result.palaces) {
+            throw new Error('Failed to calculate ZiWei chart');
+        }
+        const minorLimitList = ziweiService.getMinorLimitRange(normalized.year, args.startAge, args.endAge);
+        const mingGongPalace = findMingGong(result);
+        const mingGongStars = extractStars(mingGongPalace);
+        const currentYear = new Date().getFullYear();
+        const currentAge = currentYear - normalized.year + 1;
+        let currentDecade;
+        if (result.decades && result.decades.length > 0) {
+            const matchedDecade = result.decades.find(d => currentAge >= d.startAge && currentAge <= d.endAge);
+            if (matchedDecade) {
+                currentDecade = {
+                    palaceName: matchedDecade.palaceName || result.palaces?.[matchedDecade.palaceIndex]?.name || '未知',
+                    startAge: matchedDecade.startAge,
+                    endAge: matchedDecade.endAge,
+                };
+            }
+        }
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            mingGong: mingGongPalace?.name || '命宮',
+            mingGongStars,
+            palaces: result.palaces,
+            mutagenInfo: result.mutagenInfo,
+            startAge: args.startAge,
+            endAge: args.endAge,
+            currentDecade,
+            decades: result.decades,
+        };
+        return (0, listTextRenderer_1.renderZiweiXiaoXianList)(minorLimitList, options);
+    }));
+    server.registerTool('ziwei_liunian', {
+        title: '紫微流年列表',
+        description: `紫微流年列表。
+
+返回指定年份範圍內的流年信息：
+- 公曆年份
+- 干支年
+- 虛歲
+- 流年宮位
+- 宮內主星
+- 所屬大限
+- 流年四化
+
+用於分析多年運勢趨勢。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            startYear: zod_1.z.number().int().min(1900).max(2100).describe('Start year for the range'),
+            endYear: zod_1.z.number().int().min(1900).max(2100).describe('End year for the range'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('ziwei_liunian', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await ziweiService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, gender: normalized.gender,
+        });
+        if (!result.palaces) {
+            throw new Error('Failed to calculate ZiWei chart');
+        }
+        const yearlyList = [];
+        for (let year = args.startYear; year <= args.endYear; year++) {
+            const yearly = YearlyCalculator_1.YearlyCalculator.calculate(year, normalized.year, result.palaces);
+            if (yearly) {
+                yearlyList.push(yearly);
+            }
+        }
+        const mingGongPalace = findMingGong(result);
+        const mingGongStars = extractStars(mingGongPalace);
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            mingGong: mingGongPalace?.name || '命宮',
+            mingGongStars,
+            palaces: result.palaces,
+            mutagenInfo: result.mutagenInfo,
+            startYear: args.startYear,
+            endYear: args.endYear,
+            decades: result.decades,
+        };
+        return (0, listTextRenderer_1.renderZiweiLiuNianList)(yearlyList, options);
+    }));
+    server.registerTool('ziwei_liuyue', {
+        title: '紫微流月列表',
+        description: `紫微流月列表。
+
+重要：紫微流月使用【農曆月】，非節氣月！
+- 以農曆初一為邊界
+- 正月從春節開始
+- 閏月單獨顯示（如"閏六月"）
+
+返回指定年份的流月運勢（含上下文）：
+- 當前大限、小限、流年資訊
+- 農曆月份及公曆日期範圍
+- 流月宮位及宮內主星
+- 完整四化系統（本命/大限/小限/流年/流月）
+
+用於規劃年度活動時機。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            lunarYear: zod_1.z.number().int().min(1900).max(2100).describe('The lunar year (Gregorian year) to query'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('ziwei_liuyue', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await ziweiService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, gender: normalized.gender,
+        });
+        const monthlyList = ziweiService.getYearlyMonths(args.lunarYear);
+        const mingGongPalace = findMingGong(result);
+        const mingGongStars = extractStars(mingGongPalace);
+        const lunar = lunar_javascript_1.Lunar.fromYmd(args.lunarYear, 1, 1);
+        const leapMonth = lunar.getYear() === args.lunarYear
+            ? lunar_javascript_1.Lunar.fromYmd(args.lunarYear, 6, 1).getLeapMonth?.()
+            : undefined;
+        const targetAge = args.lunarYear - normalized.year + 1;
+        let currentDecade;
+        if (result.decades && result.decades.length > 0) {
+            const matchedDecade = result.decades.find(d => targetAge >= d.startAge && targetAge <= d.endAge);
+            if (matchedDecade) {
+                currentDecade = {
+                    palaceName: matchedDecade.palaceName || result.palaces?.[matchedDecade.palaceIndex]?.name || '未知',
+                    startAge: matchedDecade.startAge,
+                    endAge: matchedDecade.endAge,
+                };
+            }
+        }
+        const yearlyInfo = YearlyCalculator_1.YearlyCalculator.calculate(args.lunarYear, normalized.year, result.palaces);
+        let currentYearly;
+        if (yearlyInfo) {
+            const { stem: yearStem, branch: yearBranch } = (0, schemas_1.getYearStemBranch)(args.lunarYear);
+            currentYearly = {
+                year: args.lunarYear,
+                age: targetAge,
+                palaceName: result.palaces?.[yearlyInfo.palaceIndex]?.name || '未知',
+                heavenlyStem: yearStem,
+                earthlyBranch: yearBranch,
+            };
+        }
+        const minorLimitInfo = ziweiService.getMinorLimitInfo(normalized.year, args.lunarYear);
+        let currentMinorLimit;
+        if (minorLimitInfo) {
+            currentMinorLimit = {
+                age: minorLimitInfo.age,
+                palaceName: result.palaces?.[minorLimitInfo.palaceIndex]?.name || '未知',
+                heavenlyStem: minorLimitInfo.heavenlyStem,
+                earthlyBranch: minorLimitInfo.earthlyBranch,
+            };
+        }
+        const enhancedMutagenInfo = { ...result.mutagenInfo };
+        if (minorLimitInfo?.heavenlyStem) {
+            enhancedMutagenInfo.minorLimit = MutagenCore_1.MutagenCore.getMutagen(minorLimitInfo.heavenlyStem) || undefined;
+        }
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            mingGong: mingGongPalace?.name || '命宮',
+            mingGongStars,
+            palaces: result.palaces,
+            mutagenInfo: enhancedMutagenInfo,
+            lunarYear: args.lunarYear,
+            gregorianYear: args.lunarYear,
+            leapMonth: typeof leapMonth === 'number' ? leapMonth : undefined,
+            currentDecade,
+            currentMinorLimit,
+            currentYearly,
+        };
+        return (0, listTextRenderer_1.renderZiweiLiuYueList)(monthlyList, options);
+    }));
+    server.registerTool('ziwei_liuri', {
+        title: '紫微流日列表',
+        description: `紫微流日列表。
+
+返回指定農曆月內的每日運勢（含上下文）：
+- 當前大限、流年、流月資訊
+- 農曆日期與公曆日期對照
+- 干支日及流日宮位
+- 完整四化系統（本命/大限/小限/流年/流月/流日）
+
+閏月使用負數表示（如 -6 表示閏六月）。
+
+用於精細的日期選擇。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            lunarYear: zod_1.z.number().int().min(1900).max(2100).describe('The lunar year (Gregorian year)'),
+            lunarMonth: zod_1.z.number().int().min(-12).max(12).describe('Lunar month (1-12, use negative for leap month, e.g. -6 for leap 6th month)'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('ziwei_liuri', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await ziweiService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, gender: normalized.gender,
+        });
+        const isLeapMonth = args.lunarMonth < 0;
+        const actualMonth = Math.abs(args.lunarMonth);
+        const monthParam = isLeapMonth ? -actualMonth : actualMonth;
+        const lunarFirstDay = lunar_javascript_1.Lunar.fromYmd(args.lunarYear, monthParam, 1);
+        let lastDayNum = 29;
+        try {
+            lunar_javascript_1.Lunar.fromYmd(args.lunarYear, monthParam, 30);
+            lastDayNum = 30;
+        }
+        catch {
+            // Month only has 29 days
+        }
+        const lunarLastDay = lunar_javascript_1.Lunar.fromYmd(args.lunarYear, monthParam, lastDayNum);
+        const firstSolar = lunarFirstDay.getSolar();
+        const lastSolar = lunarLastDay.getSolar();
+        const startDate = new Date(firstSolar.getYear(), firstSolar.getMonth() - 1, firstSolar.getDay());
+        const endDate = new Date(lastSolar.getYear(), lastSolar.getMonth() - 1, lastSolar.getDay());
+        const dailyList = [];
+        for (let day = 1; day <= lastDayNum; day++) {
+            try {
+                const lunarDay = lunar_javascript_1.Lunar.fromYmd(args.lunarYear, monthParam, day);
+                const solarDay = lunarDay.getSolar();
+                const solarDate = new Date(solarDay.getYear(), solarDay.getMonth() - 1, solarDay.getDay());
+                const dailyInfo = ziweiService.getDailyInfo(solarDay.getYear(), solarDay.getMonth(), solarDay.getDay());
+                dailyList.push({
+                    lunarMonth: actualMonth,
+                    lunarDay: day,
+                    isLeapMonth,
+                    gregorianDate: solarDate,
+                    ganzhi: dailyInfo ? `${dailyInfo.heavenlyStem}${dailyInfo.earthlyBranch}` : '',
+                    palaceIndex: dailyInfo?.palaceIndex || 0,
+                });
+            }
+            catch {
+                // Skip invalid dates
+            }
+        }
+        const mingGongPalace = findMingGong(result);
+        const mingGongStars = extractStars(mingGongPalace);
+        const monthlyInfo = ziweiService.getMonthlyInfo(args.lunarYear, actualMonth - 1, actualMonth, isLeapMonth);
+        const monthlyPalace = monthlyInfo ? result.palaces?.[monthlyInfo.palaceIndex]?.name : undefined;
+        const targetAge = args.lunarYear - normalized.year + 1;
+        let currentDecade;
+        if (result.decades && result.decades.length > 0) {
+            const matchedDecade = result.decades.find(d => targetAge >= d.startAge && targetAge <= d.endAge);
+            if (matchedDecade) {
+                currentDecade = {
+                    palaceName: matchedDecade.palaceName || result.palaces?.[matchedDecade.palaceIndex]?.name || '未知',
+                    startAge: matchedDecade.startAge,
+                    endAge: matchedDecade.endAge,
+                };
+            }
+        }
+        const yearlyInfo = YearlyCalculator_1.YearlyCalculator.calculate(args.lunarYear, normalized.year, result.palaces);
+        let currentYearly;
+        if (yearlyInfo) {
+            const { stem: yearStem, branch: yearBranch } = (0, schemas_1.getYearStemBranch)(args.lunarYear);
+            currentYearly = {
+                year: args.lunarYear,
+                age: targetAge,
+                palaceName: result.palaces?.[yearlyInfo.palaceIndex]?.name || '未知',
+                heavenlyStem: yearStem,
+                earthlyBranch: yearBranch,
+            };
+        }
+        let currentMonthly;
+        if (monthlyInfo) {
+            currentMonthly = {
+                month: actualMonth,
+                palaceName: result.palaces?.[monthlyInfo.palaceIndex]?.name || '未知',
+                heavenlyStem: monthlyInfo.heavenlyStem,
+                earthlyBranch: monthlyInfo.earthlyBranch,
+            };
+        }
+        const minorLimitInfo = ziweiService.getMinorLimitInfo(normalized.year, args.lunarYear);
+        let currentMinorLimit;
+        if (minorLimitInfo) {
+            currentMinorLimit = {
+                age: minorLimitInfo.age,
+                palaceName: result.palaces?.[minorLimitInfo.palaceIndex]?.name || '未知',
+                heavenlyStem: minorLimitInfo.heavenlyStem,
+                earthlyBranch: minorLimitInfo.earthlyBranch,
+            };
+        }
+        const enhancedMutagenInfo = { ...result.mutagenInfo };
+        if (minorLimitInfo?.heavenlyStem) {
+            enhancedMutagenInfo.minorLimit = MutagenCore_1.MutagenCore.getMutagen(minorLimitInfo.heavenlyStem) || undefined;
+        }
+        if (monthlyInfo?.heavenlyStem) {
+            enhancedMutagenInfo.monthly = MutagenCore_1.MutagenCore.getMutagen(monthlyInfo.heavenlyStem) || undefined;
+        }
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            mingGong: mingGongPalace?.name || '命宮',
+            mingGongStars,
+            palaces: result.palaces,
+            mutagenInfo: enhancedMutagenInfo,
+            lunarYear: args.lunarYear,
+            lunarMonth: actualMonth,
+            isLeapMonth,
+            gregorianStartDate: startDate,
+            gregorianEndDate: endDate,
+            monthlyPalace,
+            currentDecade,
+            currentMinorLimit,
+            currentYearly,
+            currentMonthly,
+        };
+        return (0, listTextRenderer_1.renderZiweiLiuRiList)(dailyList, options);
+    }));
+}
+//# sourceMappingURL=ziweiTools.js.map

package/dist/tools/ziweiTools.js.map

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

package/dist/utils/timeNormalization.d.ts

@@ -2,14 +2,14 @@
  * 時間歸一化工具
  *
  * 設計原則：
- * 1. 當前階段統一使用北京時間（UTC+8），不對外暴露時區參數
- * 2. 農曆輸入在入口層即轉換為公曆，內部計算統一走公曆
- *
- * TODO: 多時區支持（M4 里程碑）
- * - 新增 timezone 參數
- * - 引入 date-fns-tz 或 @js-temporal/polyfill
+ * 1. 可複現性優先：內部規範表示為北京時間（UTC+8）壁鐘時間，
+ *    所有曆法計算（農曆、節氣、干支）均基於北京時間壁鐘分量
+ * 2. 輸入層負責歸一化：農曆轉公曆、時區換算都在入口層一次完成
+ * 3. 多時區支持（M4）：timezone 為 IANA 時區名（如 America/New_York），
+ *    僅對公曆輸入生效；農曆輸入為曆法日期（無時區語義），忽略 timezone
+ * 4. 零額外依賴：時區換算基於 Intl.DateTimeFormat（宿主環境無關，跨機器確定性）
  */
-/** 北京時區 IANA 標識（內部使用） */
+/** 北京時區 IANA 標識（內部規範時區） */
 export declare const BEIJING_TZ = "Asia/Shanghai";
 export interface BirthDateTimeInput {
     year: number;
@@ -18,8 +18,11 @@ export interface BirthDateTimeInput {
     hour: number;
     minute?: number;
     isLunar?: boolean;
+    /** IANA 時區名（公曆輸入的所在時區），默認北京時間 */
+    timezone?: string;
 }
 export interface NormalizedBirthDateTime {
+    /** 北京時間（內部規範表示）分量 */
     year: number;
     month: number;
     day: number;
@@ -27,22 +30,44 @@ export interface NormalizedBirthDateTime {
     minute: number;
     /** 標記原始輸入是否為農曆（用於輸出顯示） */
     isLunarInput: boolean;
+    /** 原始輸入時區（僅當發生時區換算時存在） */
+    sourceTimezone?: string;
 }
+/** 校驗 IANA 時區名，非法時拋出明確錯誤 */
+export declare function validateTimezone(timeZone: string): void;
 /**
- * 歸一化出生日期時間
+ * 將指定時區的壁鐘時間換算為北京標準時間（UTC+8）壁鐘分量
  *
- * 處理邏輯：
+ * 演算法：先假設輸入為 UTC 得到猜測時刻，再用該時刻的實際偏移量迭代修正
+ * （兩輪即可收斂至秒級偏移，第三輪兜底 DST 邊界）。
+ * 輸入側使用 Intl（正確處理各國歷史夏令時，如 1986-1991 中國夏令時），
+ * 輸出側使用固定 +8（命理標準時口徑），全程與宿主機時區無關。
+ */
+export declare function convertToBeijingWallClock(input: {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+}, timeZone: string): {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+};
+/**
+ * 歸一化出生（起卦）日期時間至北京時間規範表示
+ *
+ * 處理順序：
  * 1. 補齊 minute 默認值
- * 2. 如果是農曆輸入，轉換為公曆
+ * 2. 農曆輸入：轉換為公曆（農曆為曆法日期，忽略 timezone）
+ * 3. 公曆輸入且提供 timezone：換算為北京時間壁鐘
  *
  * @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 }
+ * // 紐約出生，真實出生時刻 1990-06-15 20:30 EDT
+ * normalizeBirthDateTime({ year: 1990, month: 6, day: 15, hour: 20, minute: 30, timezone: 'America/New_York' })
+ * // => 北京時間 1990-06-16 08:30（次日），用於排盤
  */
 export declare function normalizeBirthDateTime(input: BirthDateTimeInput): NormalizedBirthDateTime;
 //# sourceMappingURL=timeNormalization.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"timeNormalization.d.ts","sourceRoot":"","sources":["../../src/utils/timeNormalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,2BAA2B;AAC3B,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;IAClB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,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;IACtB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,4BAA4B;AAC5B,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMvD;AA8CD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACjF,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAU5E;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,uBAAuB,CAqBzF"}