@orrery/core 0.3.0 → 0.4.0

package/dist/{chunk-DGSIRAXF.js → chunk-JLKMDX3R.js}

@@ -3,19 +3,28 @@ import {
   BRANCH_BREAKS,
   BRANCH_CLASHES,
   BRANCH_COMBINES_6,
+  BRANCH_GWIMUN,
   BRANCH_HARMS,
   BRANCH_PUNISHMENTS,
   BRANCH_SELF_PUNISHMENTS,
+  BRANCH_WONJIN,
+  CHEONDUK_MAP,
+  CHEONUL_MAP,
   DIRECTIONAL_COMPOSES,
   DIRECTIONAL_COMPOSE_ELEMENTS,
+  DOHWA_MAP,
   EARTH,
   EARTH_KR,
+  GEUMYEO_MAP,
   GOEGANG_PILLARS,
+  GONGMANG_TABLE,
   HALF_COMPOSES,
   HGANJI,
+  HONGYEOM_PILLARS,
   JIJANGGAN,
   METEORS_12,
   METEOR_LOOKUP,
+  MUNCHANG_MAP,
   PILLAR_NAMES,
   RELATIONS,
   SKY,
@@ -26,9 +35,10 @@ import {
   STEM_INFO,
   TRIPLE_COMPOSES,
   TRIPLE_COMPOSE_ELEMENTS,
+  WOLDUK_MAP,
   YANGGAN,
   YANGIN_MAP
-} from "./chunk-VJDUZB5T.js";
+} from "./chunk-EXYPMSUR.js";
 
 // src/pillars.ts
 function div(a, b) {
@@ -253,7 +263,7 @@ function dateFromMinutes(tmin, uyear, umonth, uday, uhour, umin) {
   }
   return [y1, mo1, d1, h1, mi1];
 }
-function calcPillarIndices(year, month, day, hour, min) {
+function calcPillarIndices(year, month, day, hour, min, jasiMethod) {
   const displ2min = minutesBetween(
     UNIT.year,
     UNIT.month,
@@ -325,11 +335,16 @@ function calcPillarIndices(year, month, day, hour, min) {
   } else if (hour === 21 && min >= 30 || hour === 22 || hour === 23 && min < 30) {
     i = 11;
   } else {
-    so24day += 1;
-    if (so24day === 60) so24day = 0;
     i = 0;
+    const method = jasiMethod ?? "unified";
+    if (method === "unified") {
+      so24day += 1;
+      if (so24day === 60) so24day = 0;
+    }
   }
-  t = so24day % 10;
+  const isYajasi = i === 0 && hour === 23 && jasiMethod === "split";
+  const dayForHour = isYajasi ? (so24day + 1) % 60 : so24day;
+  t = dayForHour % 10;
   t = t % 5;
   t = t * 12 + i;
   const so24hour = t;
@@ -407,12 +422,12 @@ function calcSolarTerms(year, month, day, hour, min) {
     outgiMin
   };
 }
-function getFourPillars(year, month, day, hour, minute) {
-  const [, y, m, d, h] = calcPillarIndices(year, month, day, hour, minute);
+function getFourPillars(year, month, day, hour, minute, jasiMethod) {
+  const [, y, m, d, h] = calcPillarIndices(year, month, day, hour, minute, jasiMethod);
   return [HGANJI[y], HGANJI[m], HGANJI[d], HGANJI[h]];
 }
-function getDaewoon(isMale, year, month, day, hour, minute) {
-  const [, sy, sm] = calcPillarIndices(year, month, day, hour, minute);
+function getDaewoon(isMale, year, month, day, hour, minute, jasiMethod) {
+  const [, sy, sm] = calcPillarIndices(year, month, day, hour, minute, jasiMethod);
   const yearStem = HGANJI[sy][0];
   const isYangGan = YANGGAN.includes(yearStem);
   const order = isMale && isYangGan || !isMale && !isYangGan;
@@ -512,6 +527,62 @@ function getTwelveSpirit(yearBranch, targetBranch) {
   const offset = ((targetIdx - start) % 12 + 12) % 12;
   return SPIRITS_12[offset].hanja;
 }
+var YANG_STEM_OF = {
+  tree: "\u7532",
+  fire: "\u4E19",
+  earth: "\u620A",
+  metal: "\u5E9A",
+  water: "\u58EC"
+};
+var SIPSIN_CATEGORIES = [
+  { name: "\u6BD4\u52AB", interactions: ["same"] },
+  { name: "\u98DF\u50B7", interactions: ["output"] },
+  { name: "\u8CA1\u661F", interactions: ["sword"] },
+  { name: "\u5B98\u661F", interactions: ["shield"] },
+  { name: "\u5370\u661F", interactions: ["input"] }
+];
+function calculateJwabeop(dayStem, branches, dayBranch) {
+  return branches.map((branch) => {
+    const hidden = getHiddenStems(branch).replace(/ /g, "");
+    return [...hidden].map((stem) => {
+      const rel = getRelation(dayStem, stem);
+      const sipsin = rel ? rel.hanja : "?";
+      const unseong = getTwelveMeteor(stem, dayBranch);
+      return { stem, sipsin, unseong };
+    });
+  });
+}
+function calculateInjongbeop(dayStem, dayBranch) {
+  const dayInfo = STEM_INFO[dayStem];
+  if (!dayInfo) return [];
+  const hidden = getHiddenStems(dayBranch).replace(/ /g, "");
+  const presentInteractions = /* @__PURE__ */ new Set();
+  for (const stem of hidden) {
+    const info = STEM_INFO[stem];
+    if (!info) continue;
+    const interaction = getInteraction(dayInfo.element, info.element);
+    if (interaction) presentInteractions.add(interaction);
+  }
+  const result = [];
+  for (const cat of SIPSIN_CATEGORIES) {
+    const missing = cat.interactions.every((i) => !presentInteractions.has(i));
+    if (!missing) continue;
+    let targetElement = null;
+    for (const [el, info] of Object.entries(STEM_INFO)) {
+      if (info.yinyang !== "+") continue;
+      const inter = getInteraction(dayInfo.element, info.element);
+      if (inter && cat.interactions.includes(inter)) {
+        targetElement = info.element;
+        break;
+      }
+    }
+    if (!targetElement) continue;
+    const yangStem = YANG_STEM_OF[targetElement];
+    const unseong = getTwelveMeteor(yangStem, dayBranch);
+    result.push({ category: cat.name, yangStem, unseong });
+  }
+  return result;
+}
 function lookupPair(table, a, b) {
   return table[`${a},${b}`] ?? table[`${b},${a}`];
 }
@@ -547,6 +618,10 @@ function getBranchRelation(branch1, branch2) {
   if (branch1 === branch2 && BRANCH_SELF_PUNISHMENTS.has(branch1)) {
     results.push({ type: "\u5211", detail: "\u81EA\u5211" });
   }
+  const wonjin = lookupPair(BRANCH_WONJIN, branch1, branch2);
+  if (wonjin) results.push({ type: wonjin, detail: null });
+  const gwimun = lookupPair(BRANCH_GWIMUN, branch1, branch2);
+  if (gwimun) results.push({ type: gwimun, detail: null });
   return results;
 }
 function analyzePillarRelations(pillar1, pillar2) {
@@ -594,18 +669,66 @@ function analyzeAllRelations(pillars) {
     directional: checkDirectionalCompose(branches)
   };
 }
-function getSpecialSals(dayStem, dayPillar, branches) {
+function getSpecialSals(stems, branches, dayPillar) {
+  const dayStem = stems[1];
+  const dayBranch = branches[1];
+  const monthBranch = branches[2];
   const yanginBranch = YANGIN_MAP[dayStem];
   const yangin = yanginBranch ? branches.reduce((acc, b, i) => {
     if (b === yanginBranch) acc.push(i);
     return acc;
   }, []) : [];
+  const dohwaBranch = DOHWA_MAP[dayBranch];
+  const dohwa = dohwaBranch ? branches.reduce((acc, b, i) => {
+    if (i !== 1 && b === dohwaBranch) acc.push(i);
+    return acc;
+  }, []) : [];
+  const cheonulBranches = CHEONUL_MAP[dayStem] ?? [];
+  const cheonul = branches.reduce((acc, b, i) => {
+    if (cheonulBranches.includes(b)) acc.push(i);
+    return acc;
+  }, []);
+  const cheondukChar = CHEONDUK_MAP[monthBranch];
+  const cheonduk = cheondukChar ? [...stems, ...branches].reduce((acc, ch, i) => {
+    if (ch === cheondukChar) acc.push(i % 4);
+    return acc;
+  }, []).filter((v, i, a) => a.indexOf(v) === i) : [];
+  const woldukChar = WOLDUK_MAP[monthBranch];
+  const wolduk = woldukChar ? stems.reduce((acc, s, i) => {
+    if (s === woldukChar) acc.push(i);
+    return acc;
+  }, []) : [];
+  const munchangBranch = MUNCHANG_MAP[dayStem];
+  const munchang = munchangBranch ? branches.reduce((acc, b, i) => {
+    if (b === munchangBranch) acc.push(i);
+    return acc;
+  }, []) : [];
+  const geumyeoBranch = GEUMYEO_MAP[dayStem];
+  const geumyeo = geumyeoBranch ? branches.reduce((acc, b, i) => {
+    if (b === geumyeoBranch) acc.push(i);
+    return acc;
+  }, []) : [];
   return {
     yangin,
     baekho: BAEKHO_PILLARS.has(dayPillar),
-    goegang: GOEGANG_PILLARS.has(dayPillar)
+    goegang: GOEGANG_PILLARS.has(dayPillar),
+    dohwa,
+    cheonul,
+    cheonduk,
+    wolduk,
+    munchang,
+    hongyeom: HONGYEOM_PILLARS.has(dayPillar),
+    geumyeo
   };
 }
+function getYearGanzi(year) {
+  return HGANJI[((12 + (year - 1996)) % 60 + 60) % 60];
+}
+function getGongmang(dayGanzi) {
+  const idx = HGANJI.indexOf(dayGanzi);
+  if (idx < 0) return ["", ""];
+  return GONGMANG_TABLE[Math.trunc(idx / 10)];
+}
 var IMPORTANT_RELATIONS = /* @__PURE__ */ new Set(["\u5408", "\u6C96", "\u5211"]);
 function findTransits(natalPillars, months = 1, backward = false) {
   const results = [];
@@ -687,6 +810,8 @@ export {
   toHangul,
   getTwelveMeteor,
   getTwelveSpirit,
+  calculateJwabeop,
+  calculateInjongbeop,
   getStemRelation,
   getBranchRelation,
   analyzePillarRelations,
@@ -694,5 +819,7 @@ export {
   checkDirectionalCompose,
   analyzeAllRelations,
   getSpecialSals,
+  getYearGanzi,
+  getGongmang,
   findTransits
 };

package/dist/{chunk-6BKZDAMP.js → chunk-NSFWX6RO.js}

@@ -41832,7 +41832,8 @@ var PLANET_SYMBOLS = {
   Pluto: "\u2647",
   Chiron: "\u26B7",
   NorthNode: "\u260A",
-  SouthNode: "\u260B"
+  SouthNode: "\u260B",
+  Fortuna: "\u2295"
 };
 var PLANET_KO = {
   Sun: "\uD0DC\uC591",
@@ -41847,7 +41848,8 @@ var PLANET_KO = {
   Pluto: "\uBA85\uC655\uC131",
   Chiron: "\uD0A4\uB860",
   NorthNode: "\uBD81\uAD50\uC810",
-  SouthNode: "\uB0A8\uAD50\uC810"
+  SouthNode: "\uB0A8\uAD50\uC810",
+  Fortuna: "\uD589\uC6B4\uC810"
 };
 var PLANET_BODIES = [
   ["Sun", 0],
@@ -41972,14 +41974,17 @@ function calculateAspects(planets) {
 async function calculateNatal(input, houseSystem = "P") {
   const lat = input.latitude ?? DEFAULT_LAT;
   const lon = input.longitude ?? DEFAULT_LON;
+  const unknownTime = !!input.unknownTime;
+  const hour = unknownTime ? 12 : input.hour;
+  const minute = unknownTime ? 0 : input.minute;
   const offsetHours = getSeoulUtcOffsetHours(
     input.year,
     input.month,
     input.day,
-    input.hour,
-    input.minute
+    hour,
+    minute
   );
-  const utHourDecimal = input.hour + input.minute / 60 - offsetHours;
+  const utHourDecimal = hour + minute / 60 - offsetHours;
   let utYear = input.year;
   let utMonth = input.month;
   let utDay = input.day;
@@ -41998,7 +42003,13 @@ async function calculateNatal(input, houseSystem = "P") {
     utDay = d.getDate();
   }
   const jd = julday2(utYear, utMonth, utDay, utHour);
-  const { cusps, ascmc } = calcHouses(jd, lat, lon, houseSystem);
+  let cusps = null;
+  let ascmc = null;
+  if (!unknownTime) {
+    const houseResult = calcHouses(jd, lat, lon, houseSystem);
+    cusps = Array.from(houseResult.cusps);
+    ascmc = Array.from(houseResult.ascmc);
+  }
   const planets = [];
   for (const [id, bodyNum] of PLANET_BODIES) {
     const pos = calcPlanet(jd, bodyNum);
@@ -42010,7 +42021,7 @@ async function calculateNatal(input, houseSystem = "P") {
       sign: lonToSign(pos.longitude),
       degreeInSign: degreeInSign(pos.longitude),
       isRetrograde: pos.longitudeSpeed < 0,
-      house: findHouse(pos.longitude, cusps)
+      ...cusps ? { house: findHouse(pos.longitude, cusps) } : {}
     });
   }
   const northNode = planets.find((p) => p.id === "NorthNode");
@@ -42023,29 +42034,51 @@ async function calculateNatal(input, houseSystem = "P") {
     sign: lonToSign(southLon),
     degreeInSign: degreeInSign(southLon),
     isRetrograde: false,
-    house: findHouse(southLon, cusps)
+    ...cusps ? { house: findHouse(southLon, cusps) } : {}
   });
-  const houses = [];
-  for (let i = 1; i <= 12; i++) {
-    const cuspLon = cusps[i];
-    houses.push({
-      number: i,
-      cuspLongitude: cuspLon,
-      sign: lonToSign(cuspLon),
-      degreeInSign: degreeInSign(cuspLon)
+  if (ascmc) {
+    const ascLon = ascmc[0];
+    const sun = planets.find((p) => p.id === "Sun");
+    const moon = planets.find((p) => p.id === "Moon");
+    const isDayChart = sun.house >= 7;
+    const fortunaLon = isDayChart ? normalizeDeg(ascLon + moon.longitude - sun.longitude) : normalizeDeg(ascLon + sun.longitude - moon.longitude);
+    planets.push({
+      id: "Fortuna",
+      longitude: fortunaLon,
+      latitude: 0,
+      speed: 0,
+      sign: lonToSign(fortunaLon),
+      degreeInSign: degreeInSign(fortunaLon),
+      isRetrograde: false,
+      house: findHouse(fortunaLon, cusps)
     });
   }
-  const ascLon = ascmc[0];
-  const mcLon = ascmc[1];
-  const descLon = normalizeDeg(ascLon + 180);
-  const icLon = normalizeDeg(mcLon + 180);
-  const angles = {
-    asc: { longitude: ascLon, sign: lonToSign(ascLon), degreeInSign: degreeInSign(ascLon) },
-    mc: { longitude: mcLon, sign: lonToSign(mcLon), degreeInSign: degreeInSign(mcLon) },
-    desc: { longitude: descLon, sign: lonToSign(descLon), degreeInSign: degreeInSign(descLon) },
-    ic: { longitude: icLon, sign: lonToSign(icLon), degreeInSign: degreeInSign(icLon) }
-  };
-  const aspectPlanets = planets.filter((p) => p.id !== "SouthNode");
+  const houses = [];
+  if (cusps) {
+    for (let i = 1; i <= 12; i++) {
+      const cuspLon = cusps[i];
+      houses.push({
+        number: i,
+        cuspLongitude: cuspLon,
+        sign: lonToSign(cuspLon),
+        degreeInSign: degreeInSign(cuspLon)
+      });
+    }
+  }
+  let angles = null;
+  if (ascmc) {
+    const ascLon = ascmc[0];
+    const mcLon = ascmc[1];
+    const descLon = normalizeDeg(ascLon + 180);
+    const icLon = normalizeDeg(mcLon + 180);
+    angles = {
+      asc: { longitude: ascLon, sign: lonToSign(ascLon), degreeInSign: degreeInSign(ascLon) },
+      mc: { longitude: mcLon, sign: lonToSign(mcLon), degreeInSign: degreeInSign(mcLon) },
+      desc: { longitude: descLon, sign: lonToSign(descLon), degreeInSign: degreeInSign(descLon) },
+      ic: { longitude: icLon, sign: lonToSign(icLon), degreeInSign: degreeInSign(icLon) }
+    };
+  }
+  const aspectPlanets = planets.filter((p) => p.id !== "SouthNode" && p.id !== "Fortuna");
   const aspects = calculateAspects(aspectPlanets);
   return { input, planets, houses, angles, aspects };
 }

package/dist/{chunk-OCPJGMZC.js → chunk-WOQT7EBV.js}

@@ -47,60 +47,75 @@ function matchChosung(name, query) {
 }
 var KOREAN_CITIES = [
   // 특별/광역시
-  { name: "\uC11C\uC6B8", lat: 37.5665, lon: 126.978 },
-  { name: "\uBD80\uC0B0", lat: 35.1796, lon: 129.0756 },
-  { name: "\uC778\uCC9C", lat: 37.4563, lon: 126.7052 },
-  { name: "\uB300\uAD6C", lat: 35.8714, lon: 128.6014 },
-  { name: "\uB300\uC804", lat: 36.3504, lon: 127.3845 },
-  { name: "\uAD11\uC8FC", lat: 35.1595, lon: 126.8526 },
-  { name: "\uC6B8\uC0B0", lat: 35.5384, lon: 129.3114 },
-  { name: "\uC138\uC885", lat: 36.48, lon: 127.259 },
+  { name: "\uC11C\uC6B8", region: "\uC11C\uC6B8\uD2B9\uBCC4\uC2DC", lat: 37.5665, lon: 126.978 },
+  { name: "\uBD80\uC0B0", region: "\uBD80\uC0B0\uAD11\uC5ED\uC2DC", lat: 35.1796, lon: 129.0756 },
+  { name: "\uC778\uCC9C", region: "\uC778\uCC9C\uAD11\uC5ED\uC2DC", lat: 37.4563, lon: 126.7052 },
+  { name: "\uB300\uAD6C", region: "\uB300\uAD6C\uAD11\uC5ED\uC2DC", lat: 35.8714, lon: 128.6014 },
+  { name: "\uB300\uC804", region: "\uB300\uC804\uAD11\uC5ED\uC2DC", lat: 36.3504, lon: 127.3845 },
+  { name: "\uAD11\uC8FC", region: "\uAD11\uC8FC\uAD11\uC5ED\uC2DC", lat: 35.1595, lon: 126.8526 },
+  { name: "\uC6B8\uC0B0", region: "\uC6B8\uC0B0\uAD11\uC5ED\uC2DC", lat: 35.5384, lon: 129.3114 },
+  { name: "\uC138\uC885", region: "\uC138\uC885\uD2B9\uBCC4\uC790\uCE58\uC2DC", lat: 36.48, lon: 127.259 },
   // 경기도
-  { name: "\uC218\uC6D0", lat: 37.2636, lon: 127.0286 },
-  { name: "\uACE0\uC591", lat: 37.6584, lon: 126.832 },
-  { name: "\uC6A9\uC778", lat: 37.2411, lon: 127.1776 },
-  { name: "\uC131\uB0A8", lat: 37.4386, lon: 127.1378 },
-  { name: "\uBD80\uCC9C", lat: 37.5034, lon: 126.766 },
-  { name: "\uC548\uC0B0", lat: 37.3219, lon: 126.8309 },
-  { name: "\uC548\uC591", lat: 37.3943, lon: 126.9568 },
-  { name: "\uB0A8\uC591\uC8FC", lat: 37.636, lon: 127.2165 },
-  { name: "\uD654\uC131", lat: 37.1996, lon: 126.8312 },
-  { name: "\uD3C9\uD0DD", lat: 36.9921, lon: 127.0857 },
-  { name: "\uC758\uC815\uBD80", lat: 37.7381, lon: 127.0338 },
-  { name: "\uC2DC\uD765", lat: 37.3801, lon: 126.8032 },
-  { name: "\uD30C\uC8FC", lat: 37.759, lon: 126.7802 },
-  { name: "\uAE40\uD3EC", lat: 37.6153, lon: 126.7156 },
-  { name: "\uAD11\uBA85", lat: 37.4786, lon: 126.8646 },
-  { name: "\uC774\uCC9C", lat: 37.272, lon: 127.435 },
+  { name: "\uC218\uC6D0", region: "\uACBD\uAE30\uB3C4", lat: 37.2636, lon: 127.0286 },
+  { name: "\uACE0\uC591", region: "\uACBD\uAE30\uB3C4", lat: 37.6584, lon: 126.832 },
+  { name: "\uC6A9\uC778", region: "\uACBD\uAE30\uB3C4", lat: 37.2411, lon: 127.1776 },
+  { name: "\uC131\uB0A8", region: "\uACBD\uAE30\uB3C4", lat: 37.4386, lon: 127.1378 },
+  { name: "\uBD80\uCC9C", region: "\uACBD\uAE30\uB3C4", lat: 37.5034, lon: 126.766 },
+  { name: "\uC548\uC0B0", region: "\uACBD\uAE30\uB3C4", lat: 37.3219, lon: 126.8309 },
+  { name: "\uC548\uC591", region: "\uACBD\uAE30\uB3C4", lat: 37.3943, lon: 126.9568 },
+  { name: "\uB0A8\uC591\uC8FC", region: "\uACBD\uAE30\uB3C4", lat: 37.636, lon: 127.2165 },
+  { name: "\uD654\uC131", region: "\uACBD\uAE30\uB3C4", lat: 37.1996, lon: 126.8312 },
+  { name: "\uD3C9\uD0DD", region: "\uACBD\uAE30\uB3C4", lat: 36.9921, lon: 127.0857 },
+  { name: "\uC758\uC815\uBD80", region: "\uACBD\uAE30\uB3C4", lat: 37.7381, lon: 127.0338 },
+  { name: "\uC2DC\uD765", region: "\uACBD\uAE30\uB3C4", lat: 37.3801, lon: 126.8032 },
+  { name: "\uD30C\uC8FC", region: "\uACBD\uAE30\uB3C4", lat: 37.759, lon: 126.7802 },
+  { name: "\uAE40\uD3EC", region: "\uACBD\uAE30\uB3C4", lat: 37.6153, lon: 126.7156 },
+  { name: "\uAD11\uBA85", region: "\uACBD\uAE30\uB3C4", lat: 37.4786, lon: 126.8646 },
+  { name: "\uC774\uCC9C", region: "\uACBD\uAE30\uB3C4", lat: 37.272, lon: 127.435 },
+  { name: "\uAD70\uD3EC", region: "\uACBD\uAE30\uB3C4", lat: 37.3616, lon: 126.9351 },
+  { name: "\uD558\uB0A8", region: "\uACBD\uAE30\uB3C4", lat: 37.5393, lon: 127.2148 },
+  { name: "\uC624\uC0B0", region: "\uACBD\uAE30\uB3C4", lat: 37.1499, lon: 127.077 },
+  { name: "\uC591\uC8FC", region: "\uACBD\uAE30\uB3C4", lat: 37.7853, lon: 127.0456 },
+  { name: "\uAD6C\uB9AC", region: "\uACBD\uAE30\uB3C4", lat: 37.5943, lon: 127.1297 },
+  { name: "\uC548\uC131", region: "\uACBD\uAE30\uB3C4", lat: 37.008, lon: 127.2798 },
+  { name: "\uD3EC\uCC9C", region: "\uACBD\uAE30\uB3C4", lat: 37.8949, lon: 127.2003 },
+  { name: "\uC758\uC655", region: "\uACBD\uAE30\uB3C4", lat: 37.3449, lon: 126.9685 },
+  { name: "\uC5EC\uC8FC", region: "\uACBD\uAE30\uB3C4", lat: 37.2984, lon: 127.6373 },
+  { name: "\uC591\uD3C9", region: "\uACBD\uAE30\uB3C4", lat: 37.4914, lon: 127.4875 },
+  { name: "\uB3D9\uB450\uCC9C", region: "\uACBD\uAE30\uB3C4", lat: 37.9034, lon: 127.0606 },
+  { name: "\uACFC\uCC9C", region: "\uACBD\uAE30\uB3C4", lat: 37.4292, lon: 126.9876 },
+  { name: "\uAD11\uC8FC", region: "\uACBD\uAE30\uB3C4", lat: 37.4095, lon: 127.255 },
+  { name: "\uC5F0\uCC9C", region: "\uACBD\uAE30\uB3C4", lat: 38.0965, lon: 127.075 },
+  { name: "\uAC00\uD3C9", region: "\uACBD\uAE30\uB3C4", lat: 37.8315, lon: 127.5095 },
   // 강원도
-  { name: "\uCD98\uCC9C", lat: 37.8813, lon: 127.7299 },
-  { name: "\uC6D0\uC8FC", lat: 37.3422, lon: 127.9202 },
-  { name: "\uAC15\uB989", lat: 37.7519, lon: 128.8761 },
-  { name: "\uC18D\uCD08", lat: 38.207, lon: 128.5918 },
+  { name: "\uCD98\uCC9C", region: "\uAC15\uC6D0\uB3C4", lat: 37.8813, lon: 127.7299 },
+  { name: "\uC6D0\uC8FC", region: "\uAC15\uC6D0\uB3C4", lat: 37.3422, lon: 127.9202 },
+  { name: "\uAC15\uB989", region: "\uAC15\uC6D0\uB3C4", lat: 37.7519, lon: 128.8761 },
+  { name: "\uC18D\uCD08", region: "\uAC15\uC6D0\uB3C4", lat: 38.207, lon: 128.5918 },
   // 충청도
-  { name: "\uCCAD\uC8FC", lat: 36.6424, lon: 127.489 },
-  { name: "\uCC9C\uC548", lat: 36.8152, lon: 127.1139 },
-  { name: "\uCDA9\uC8FC", lat: 36.991, lon: 127.9259 },
-  { name: "\uC81C\uCC9C", lat: 37.1326, lon: 128.191 },
-  { name: "\uC544\uC0B0", lat: 36.7898, lon: 127.0018 },
+  { name: "\uCCAD\uC8FC", region: "\uCDA9\uCCAD\uBD81\uB3C4", lat: 36.6424, lon: 127.489 },
+  { name: "\uCC9C\uC548", region: "\uCDA9\uCCAD\uB0A8\uB3C4", lat: 36.8152, lon: 127.1139 },
+  { name: "\uCDA9\uC8FC", region: "\uCDA9\uCCAD\uBD81\uB3C4", lat: 36.991, lon: 127.9259 },
+  { name: "\uC81C\uCC9C", region: "\uCDA9\uCCAD\uBD81\uB3C4", lat: 37.1326, lon: 128.191 },
+  { name: "\uC544\uC0B0", region: "\uCDA9\uCCAD\uB0A8\uB3C4", lat: 36.7898, lon: 127.0018 },
   // 전라도
-  { name: "\uC804\uC8FC", lat: 35.8242, lon: 127.148 },
-  { name: "\uBAA9\uD3EC", lat: 34.8118, lon: 126.3922 },
-  { name: "\uC5EC\uC218", lat: 34.7604, lon: 127.6622 },
-  { name: "\uC21C\uCC9C", lat: 34.9505, lon: 127.4873 },
-  { name: "\uAD70\uC0B0", lat: 35.9677, lon: 126.737 },
-  { name: "\uC775\uC0B0", lat: 35.9483, lon: 126.9576 },
+  { name: "\uC804\uC8FC", region: "\uC804\uB77C\uBD81\uB3C4", lat: 35.8242, lon: 127.148 },
+  { name: "\uBAA9\uD3EC", region: "\uC804\uB77C\uB0A8\uB3C4", lat: 34.8118, lon: 126.3922 },
+  { name: "\uC5EC\uC218", region: "\uC804\uB77C\uB0A8\uB3C4", lat: 34.7604, lon: 127.6622 },
+  { name: "\uC21C\uCC9C", region: "\uC804\uB77C\uB0A8\uB3C4", lat: 34.9505, lon: 127.4873 },
+  { name: "\uAD70\uC0B0", region: "\uC804\uB77C\uBD81\uB3C4", lat: 35.9677, lon: 126.737 },
+  { name: "\uC775\uC0B0", region: "\uC804\uB77C\uBD81\uB3C4", lat: 35.9483, lon: 126.9576 },
   // 경상도
-  { name: "\uD3EC\uD56D", lat: 36.019, lon: 129.3435 },
-  { name: "\uACBD\uC8FC", lat: 35.8562, lon: 129.2247 },
-  { name: "\uAE40\uD574", lat: 35.2285, lon: 128.8894 },
-  { name: "\uCC3D\uC6D0", lat: 35.2281, lon: 128.6811 },
-  { name: "\uC9C4\uC8FC", lat: 35.1798, lon: 128.1076 },
-  { name: "\uAD6C\uBBF8", lat: 36.1197, lon: 128.3446 },
-  { name: "\uC548\uB3D9", lat: 36.5684, lon: 128.7294 },
+  { name: "\uD3EC\uD56D", region: "\uACBD\uC0C1\uBD81\uB3C4", lat: 36.019, lon: 129.3435 },
+  { name: "\uACBD\uC8FC", region: "\uACBD\uC0C1\uBD81\uB3C4", lat: 35.8562, lon: 129.2247 },
+  { name: "\uAE40\uD574", region: "\uACBD\uC0C1\uB0A8\uB3C4", lat: 35.2285, lon: 128.8894 },
+  { name: "\uCC3D\uC6D0", region: "\uACBD\uC0C1\uB0A8\uB3C4", lat: 35.2281, lon: 128.6811 },
+  { name: "\uC9C4\uC8FC", region: "\uACBD\uC0C1\uB0A8\uB3C4", lat: 35.1798, lon: 128.1076 },
+  { name: "\uAD6C\uBBF8", region: "\uACBD\uC0C1\uBD81\uB3C4", lat: 36.1197, lon: 128.3446 },
+  { name: "\uC548\uB3D9", region: "\uACBD\uC0C1\uBD81\uB3C4", lat: 36.5684, lon: 128.7294 },
   // 제주도
-  { name: "\uC81C\uC8FC", lat: 33.4996, lon: 126.5312 },
-  { name: "\uC11C\uADC0\uD3EC", lat: 33.2542, lon: 126.56 }
+  { name: "\uC81C\uC8FC", region: "\uC81C\uC8FC\uD2B9\uBCC4\uC790\uCE58\uB3C4", lat: 33.4996, lon: 126.5312 },
+  { name: "\uC11C\uADC0\uD3EC", region: "\uC81C\uC8FC\uD2B9\uBCC4\uC790\uCE58\uB3C4", lat: 33.2542, lon: 126.56 }
 ];
 var WORLD_CITIES = [
   // ── 동아시아 ──
@@ -297,8 +312,13 @@ var WORLD_CITIES = [
   { name: "\uC624\uD074\uB79C\uB4DC", country: "\uB274\uC9C8\uB79C\uB4DC", lat: -36.8485, lon: 174.7633 }
 ];
 var SEOUL = KOREAN_CITIES[0];
+var AMBIGUOUS_NAMES = new Set(
+  KOREAN_CITIES.map((c) => c.name).filter((name, _, arr) => arr.indexOf(name) !== arr.lastIndexOf(name))
+);
 function formatCityName(city) {
-  return city.country ? `${city.name}, ${city.country}` : city.name;
+  if (city.country) return `${city.name}, ${city.country}`;
+  if (city.region && AMBIGUOUS_NAMES.has(city.name)) return `${city.name} (${city.region})`;
+  return city.name;
 }
 function filterCities(query) {
   const q = query.trim();
@@ -307,7 +327,7 @@ function filterCities(query) {
   const koreanResults = [];
   const worldResults = [];
   for (const city of KOREAN_CITIES) {
-    if (chosung ? matchChosung(city.name, q) : city.name.includes(q)) {
+    if (chosung ? matchChosung(city.name, q) || city.region != null && matchChosung(city.region, q) : city.name.includes(q) || city.region != null && city.region.includes(q)) {
       koreanResults.push(city);
     }
   }
@@ -319,7 +339,7 @@ function filterCities(query) {
       if (label.includes(q)) worldResults.push(city);
     }
   }
-  return [...koreanResults, ...worldResults].slice(0, 8);
+  return [...koreanResults, ...worldResults].slice(0, 20);
 }
 
 export {

package/dist/cities.d.ts

@@ -4,6 +4,8 @@ interface City {
     name: string;
     /** 한국어 국가명 (국내 도시는 생략) */
     country?: string;
+    /** 한국어 광역 지역명 (예: '경기도', '강원도') */
+    region?: string;
     lat: number;
     lon: number;
 }
@@ -11,9 +13,9 @@ declare const KOREAN_CITIES: readonly City[];
 declare const WORLD_CITIES: readonly City[];
 /** 기본값: 서울 */
 declare const SEOUL: City;
-/** 도시 표시명 (예: "서울", "도쿄, 일본") */
+/** 도시 표시명 (예: "서울", "광주 (경기도)", "도쿄, 일본") */
 declare function formatCityName(city: City): string;
-/** 쿼리로 도시 필터링 (최대 8개, 한국 도시 우선) */
+/** 쿼리로 도시 필터링 (최대 20개, 한국 도시 우선) */
 declare function filterCities(query: string): City[];
 
 export { type City, KOREAN_CITIES, SEOUL, WORLD_CITIES, filterCities, formatCityName };

package/dist/cities.js

@@ -4,7 +4,7 @@ import {
   WORLD_CITIES,
   filterCities,
   formatCityName
-} from "./chunk-OCPJGMZC.js";
+} from "./chunk-WOQT7EBV.js";
 import "./chunk-JSBRDJBE.js";
 export {
   KOREAN_CITIES,

package/dist/constants.d.ts

@@ -27,11 +27,22 @@ declare const BRANCH_BREAKS: Record<string, string>;
 declare const BRANCH_HARMS: Record<string, string>;
 declare const BRANCH_PUNISHMENTS: Record<string, [string, string]>;
 declare const BRANCH_SELF_PUNISHMENTS: Set<string>;
+declare const BRANCH_WONJIN: Record<string, string>;
+declare const BRANCH_GWIMUN: Record<string, string>;
 declare const YANGIN_MAP: Record<string, string>;
 declare const BAEKHO_PILLARS: Set<string>;
 declare const GOEGANG_PILLARS: Set<string>;
+declare const DOHWA_MAP: Record<string, string>;
+declare const CHEONUL_MAP: Record<string, string[]>;
+declare const CHEONDUK_MAP: Record<string, string>;
+declare const WOLDUK_MAP: Record<string, string>;
+declare const MUNCHANG_MAP: Record<string, string>;
+declare const HONGYEOM_PILLARS: Set<string>;
+declare const GEUMYEO_MAP: Record<string, string>;
 declare const METEOR_LOOKUP: Record<string, number>;
 declare const JIJANGGAN: Record<string, string>;
+/** 6순(旬)별 공망 지지 쌍. 인덱스 = Math.trunc(HGANJI index / 10) */
+declare const GONGMANG_TABLE: [string, string][];
 declare const HGANJI: string[];
 declare const PILLAR_NAMES: string[];
 declare const TIAN_GAN = "\u7532\u4E59\u4E19\u4E01\u620A\u5DF1\u5E9A\u8F9B\u58EC\u7678";
@@ -54,4 +65,4 @@ declare const BRIGHTNESS_TABLE: Record<string, Record<string, string>>;
 declare const CHANGSHENG_START: Record<string, string>;
 declare const WU_HU_DUN_GAN: Record<string, string>;
 
-export { BAEKHO_PILLARS, BRANCH_BREAKS, BRANCH_CLASHES, BRANCH_COMBINES_6, BRANCH_ELEMENT, BRANCH_HARMS, BRANCH_PUNISHMENTS, BRANCH_SELF_PUNISHMENTS, BRIGHTNESS_TABLE, CHANGSHENG_START, DIRECTIONAL_COMPOSES, DIRECTIONAL_COMPOSE_ELEMENTS, DI_ZHI, EARTH, EARTH_KR, ELEMENT_HANJA, GOEGANG_PILLARS, HALF_COMPOSES, HGANJI, HUO_XING_START, JIJANGGAN, KUI_YUE_TABLE, LING_XING_START, LUCKY_STAR_NAMES, LU_CUN_TABLE, MAIN_STAR_NAMES, METEORS_12, METEOR_LOOKUP, NAYIN_TABLE, PALACE_NAMES, PILLAR_NAMES, RELATIONS, SHA_STAR_NAMES, SI_HUA_TABLE, SKY, SKY_KR, SPIRITS_12, STEM_CLASHES, STEM_COMBINES, STEM_INFO, TIANFU_SERIES_OFFSETS, TIAN_GAN, TIAN_MA_TABLE, TRIPLE_COMPOSES, TRIPLE_COMPOSE_ELEMENTS, WU_HU_DUN_GAN, WU_XING_JU_MAP, YANGGAN, YANGIN_MAP, ZIWEI_SERIES_OFFSETS };
+export { BAEKHO_PILLARS, BRANCH_BREAKS, BRANCH_CLASHES, BRANCH_COMBINES_6, BRANCH_ELEMENT, BRANCH_GWIMUN, BRANCH_HARMS, BRANCH_PUNISHMENTS, BRANCH_SELF_PUNISHMENTS, BRANCH_WONJIN, BRIGHTNESS_TABLE, CHANGSHENG_START, CHEONDUK_MAP, CHEONUL_MAP, DIRECTIONAL_COMPOSES, DIRECTIONAL_COMPOSE_ELEMENTS, DI_ZHI, DOHWA_MAP, EARTH, EARTH_KR, ELEMENT_HANJA, GEUMYEO_MAP, GOEGANG_PILLARS, GONGMANG_TABLE, HALF_COMPOSES, HGANJI, HONGYEOM_PILLARS, HUO_XING_START, JIJANGGAN, KUI_YUE_TABLE, LING_XING_START, LUCKY_STAR_NAMES, LU_CUN_TABLE, MAIN_STAR_NAMES, METEORS_12, METEOR_LOOKUP, MUNCHANG_MAP, NAYIN_TABLE, PALACE_NAMES, PILLAR_NAMES, RELATIONS, SHA_STAR_NAMES, SI_HUA_TABLE, SKY, SKY_KR, SPIRITS_12, STEM_CLASHES, STEM_COMBINES, STEM_INFO, TIANFU_SERIES_OFFSETS, TIAN_GAN, TIAN_MA_TABLE, TRIPLE_COMPOSES, TRIPLE_COMPOSE_ELEMENTS, WOLDUK_MAP, WU_HU_DUN_GAN, WU_XING_JU_MAP, YANGGAN, YANGIN_MAP, ZIWEI_SERIES_OFFSETS };