@orrery/core 0.1.0

package/README.md

@@ -0,0 +1,221 @@
+# @orrery/core
+
+브라우저/Node.js 환경에서 동작하는 동양·서양 점술 계산 엔진입니다.
+
+- **사주팔자(四柱八字)** — 60갑자, 십신, 12운성, 12신살, 대운, 간지 관계 분석
+- **자미두수(紫微斗數)** — 명반(命盤) 생성, 대한(大限), 유년(流年)/유월(流月) 분석
+- **서양 점성술 출생차트(Natal Chart)** — 행성 위치, 하우스, 앵글, 애스펙트 (Swiss Ephemeris WASM)
+
+백엔드 불필요. 모든 계산이 클라이언트에서 수행됩니다.
+
+**[라이브 데모 →](https://rath.github.io/orrery/)**
+
+## 크레딧
+
+- **사주 만세력** — 고영창님의 Perl [진짜만세력](http://afnmp3.homeip.net/~kohyc/calendar/cal20000.html)를 김정균님이 [PHP로 포팅](https://github.com/OOPS-ORG-PHP/Lunar)한 것을, 2018년 11월 황장호가 Java와 Python으로 재포팅하여 사용해오다가, 2026년 2월 Claude Code (Opus 4.6)로 TypeScript로 포팅
+- **자미두수 명반** — [lunar-javascript](https://www.npmjs.com/package/lunar-javascript) 라이브러리 기반으로 Claude (Opus 4.5)가 중국어 문헌을 리서치하며 구현
+- **점성술 출생차트** — [Swiss Ephemeris](https://github.com/arturania/swisseph)를 WASM으로 빌드한 [swisseph-wasm](https://www.npmjs.com/package/swisseph-wasm) 기반
+
+## 설치
+
+```bash
+npm install @orrery/core
+```
+
+서양 점성술(natal) 기능을 사용하려면 `swisseph-wasm`도 설치하세요:
+
+```bash
+npm install swisseph-wasm
+```
+
+> `swisseph-wasm`은 optional peer dependency입니다. 사주/자미두수만 사용한다면 설치하지 않아도 됩니다.
+
+## 사용법
+
+### 사주팔자 (四柱八字)
+
+```typescript
+import { calculateSaju } from '@orrery/core/saju'
+import type { BirthInput } from '@orrery/core/types'
+
+const input: BirthInput = {
+  year: 1993, month: 3, day: 12,
+  hour: 9, minute: 45,
+  gender: 'M',
+}
+
+const result = calculateSaju(input)
+
+// 사주 4주 (시, 일, 월, 년 순서)
+for (const p of result.pillars) {
+  console.log(p.pillar.ganzi)     // '乙巳', '壬辰', '乙卯', '癸酉'
+  console.log(p.stemSipsin)       // 천간 십신
+  console.log(p.branchSipsin)     // 지지 십신
+  console.log(p.unseong)          // 12운성
+}
+
+// 대운
+for (const dw of result.daewoon) {
+  console.log(`${dw.ganzi} (${dw.age}세~)`)
+}
+
+// 간지 관계 (합, 충, 형, 파, 해)
+for (const [key, pair] of result.relations.pairs) {
+  console.log(key, pair.stem, pair.branch)
+}
+```
+
+### 자미두수 (紫微斗數)
+
+```typescript
+import { createChart, calculateLiunian, getDaxianList } from '@orrery/core/ziwei'
+
+// 명반 생성
+const chart = createChart(1993, 3, 12, 9, 45, true)
+
+console.log(chart.mingGongZhi)     // 명궁 지지
+console.log(chart.shenGongZhi)     // 신궁 지지
+console.log(chart.wuXingJu.name)   // 오행국 (예: '水二局')
+
+// 각 궁위의 성요 확인
+for (const [name, palace] of Object.entries(chart.palaces)) {
+  const stars = palace.stars.map(s => {
+    const sihua = s.siHua ? `(${s.siHua})` : ''
+    return `${s.name}${s.brightness}${sihua}`
+  })
+  console.log(`${name} [${palace.ganZhi}]: ${stars.join(', ')}`)
+}
+
+// 대한 (大限)
+const daxianList = getDaxianList(chart)
+for (const dx of daxianList) {
+  console.log(`${dx.ageStart}~${dx.ageEnd}세: ${dx.palaceName} ${dx.ganZhi}`)
+}
+
+// 유년 (流年) — 특정 연도의 운세
+const liunian = calculateLiunian(chart, 2026)
+console.log(liunian.natalPalaceAtMing) // 유년 명궁이 위치한 본명반 궁위
+console.log(liunian.siHua)             // 유년 사화
+```
+
+### 서양 점성술 (Natal Chart)
+
+```typescript
+import { calculateNatal } from '@orrery/core/natal'
+import type { BirthInput } from '@orrery/core/types'
+
+const input: BirthInput = {
+  year: 1993, month: 3, day: 12,
+  hour: 9, minute: 45,
+  gender: 'M',
+  latitude: 37.5665,   // 서울 (선택사항, 기본값: 서울)
+  longitude: 126.9780,
+}
+
+const chart = await calculateNatal(input)
+
+// 행성 위치
+for (const planet of chart.planets) {
+  console.log(`${planet.id}: ${planet.sign} ${planet.degreeInSign.toFixed(1)}°`)
+  // 'Sun: Pisces 21.6°'
+}
+
+// ASC / MC
+console.log(`ASC: ${chart.angles.asc.sign}`)
+console.log(`MC: ${chart.angles.mc.sign}`)
+
+// 하우스 (기본: Placidus)
+for (const house of chart.houses) {
+  console.log(`House ${house.number}: ${house.sign} ${house.degreeInSign.toFixed(1)}°`)
+}
+
+// 애스펙트
+for (const aspect of chart.aspects) {
+  console.log(`${aspect.planet1} ${aspect.type} ${aspect.planet2} (orb: ${aspect.orb.toFixed(1)}°)`)
+}
+
+// 하우스 시스템 변경 (Koch)
+const kochChart = await calculateNatal(input, 'K')
+```
+
+### 저수준 API
+
+개별 함수를 직접 사용할 수도 있습니다:
+
+```typescript
+import { getFourPillars, getDaewoon, getRelation } from '@orrery/core/pillars'
+import { STEM_INFO, ELEMENT_HANJA } from '@orrery/core/constants'
+
+// 사주 4주만 계산
+const [년주, 월주, 일주, 시주] = getFourPillars(1993, 3, 12, 9, 45)
+console.log(년주, 월주, 일주, 시주) // '癸酉', '乙卯', '壬辰', '乙巳'
+
+// 십신 관계
+const relation = getRelation('壬', '乙')
+console.log(relation?.hanja) // '傷官'
+
+// 천간 오행 정보
+console.log(STEM_INFO['壬']) // { yinyang: '+', element: 'water' }
+console.log(ELEMENT_HANJA['water']) // '水'
+```
+
+### 도시 데이터
+
+출생 위치 입력에 활용할 수 있는 한국/세계 주요 도시 데이터를 제공합니다:
+
+```typescript
+import { SEOUL, filterCities, formatCityName } from '@orrery/core/cities'
+
+console.log(SEOUL) // { name: '서울', lat: 37.5665, lon: 126.9780 }
+
+// 한글 초성 검색 지원
+const results = filterCities('ㅂㅅ')  // '부산' 매칭
+console.log(formatCityName(results[0])) // '부산'
+```
+
+## 예제 실행
+
+저장소를 클론한 후 바로 실행해볼 수 있는 예제 스크립트가 있습니다:
+
+```bash
+git clone https://github.com/rath/orrery.git
+cd orrery
+bun install
+
+# 사주팔자
+bun packages/core/examples/saju.ts
+
+# 자미두수
+bun packages/core/examples/ziwei.ts
+
+# 서양 점성술 출생차트
+bun packages/core/examples/natal.ts
+```
+
+## Subpath Exports
+
+필요한 모듈만 선택적으로 import할 수 있습니다:
+
+| 경로 | 설명 |
+|------|------|
+| `@orrery/core` | 전체 barrel export |
+| `@orrery/core/saju` | `calculateSaju()` |
+| `@orrery/core/ziwei` | `createChart()`, `calculateLiunian()`, `getDaxianList()` |
+| `@orrery/core/natal` | `calculateNatal()`, 별자리/행성 심볼, 포맷 함수 |
+| `@orrery/core/pillars` | `getFourPillars()`, `getDaewoon()` 등 저수준 API |
+| `@orrery/core/types` | 모든 TypeScript 타입/인터페이스 |
+| `@orrery/core/constants` | 천간/지지, 십신, 궁위명 등 상수 테이블 |
+| `@orrery/core/cities` | 도시 데이터, 검색 함수 |
+
+## 의존성
+
+| 패키지 | 유형 | 용도 |
+|--------|------|------|
+| `lunar-javascript` | dependency | 음력 변환 (자미두수) |
+| `swisseph-wasm` | optional peer | Swiss Ephemeris WASM (서양 점성술) |
+
+`swisseph-wasm`을 설치하지 않으면 사주/자미두수만 사용 가능합니다.
+
+## 라이선스
+
+MIT

package/dist/chunk-6PJQHSY6.js

@@ -0,0 +1,292 @@
+// src/natal.ts
+import SwissEph from "swisseph-wasm";
+var DEFAULT_LAT = 37.5194;
+var DEFAULT_LON = 127.0992;
+var ZODIAC_SIGNS = [
+  "Aries",
+  "Taurus",
+  "Gemini",
+  "Cancer",
+  "Leo",
+  "Virgo",
+  "Libra",
+  "Scorpio",
+  "Sagittarius",
+  "Capricorn",
+  "Aquarius",
+  "Pisces"
+];
+var ZODIAC_SYMBOLS = {
+  Aries: "\u2648",
+  Taurus: "\u2649",
+  Gemini: "\u264A",
+  Cancer: "\u264B",
+  Leo: "\u264C",
+  Virgo: "\u264D",
+  Libra: "\u264E",
+  Scorpio: "\u264F",
+  Sagittarius: "\u2650",
+  Capricorn: "\u2651",
+  Aquarius: "\u2652",
+  Pisces: "\u2653"
+};
+var ZODIAC_KO = {
+  Aries: "\uC591\uC790\uB9AC",
+  Taurus: "\uD669\uC18C\uC790\uB9AC",
+  Gemini: "\uC30D\uB465\uC774\uC790\uB9AC",
+  Cancer: "\uAC8C\uC790\uB9AC",
+  Leo: "\uC0AC\uC790\uC790\uB9AC",
+  Virgo: "\uCC98\uB140\uC790\uB9AC",
+  Libra: "\uCC9C\uCE6D\uC790\uB9AC",
+  Scorpio: "\uC804\uAC08\uC790\uB9AC",
+  Sagittarius: "\uAD81\uC218\uC790\uB9AC",
+  Capricorn: "\uC5FC\uC18C\uC790\uB9AC",
+  Aquarius: "\uBB3C\uBCD1\uC790\uB9AC",
+  Pisces: "\uBB3C\uACE0\uAE30\uC790\uB9AC"
+};
+var PLANET_SYMBOLS = {
+  Sun: "\u2609",
+  Moon: "\u263D",
+  Mercury: "\u263F",
+  Venus: "\u2640",
+  Mars: "\u2642",
+  Jupiter: "\u2643",
+  Saturn: "\u2644",
+  Uranus: "\u2645",
+  Neptune: "\u2646",
+  Pluto: "\u2647",
+  Chiron: "\u26B7",
+  NorthNode: "\u260A",
+  SouthNode: "\u260B"
+};
+var PLANET_KO = {
+  Sun: "\uD0DC\uC591",
+  Moon: "\uB2EC",
+  Mercury: "\uC218\uC131",
+  Venus: "\uAE08\uC131",
+  Mars: "\uD654\uC131",
+  Jupiter: "\uBAA9\uC131",
+  Saturn: "\uD1A0\uC131",
+  Uranus: "\uCC9C\uC655\uC131",
+  Neptune: "\uD574\uC655\uC131",
+  Pluto: "\uBA85\uC655\uC131",
+  Chiron: "\uD0A4\uB860",
+  NorthNode: "\uBD81\uAD50\uC810",
+  SouthNode: "\uB0A8\uAD50\uC810"
+};
+var PLANET_BODIES = [
+  ["Sun", 0],
+  // SE_SUN
+  ["Moon", 1],
+  // SE_MOON
+  ["Mercury", 2],
+  // SE_MERCURY
+  ["Venus", 3],
+  // SE_VENUS
+  ["Mars", 4],
+  // SE_MARS
+  ["Jupiter", 5],
+  // SE_JUPITER
+  ["Saturn", 6],
+  // SE_SATURN
+  ["Uranus", 7],
+  // SE_URANUS
+  ["Neptune", 8],
+  // SE_NEPTUNE
+  ["Pluto", 9],
+  // SE_PLUTO
+  ["Chiron", 15],
+  // SE_CHIRON
+  ["NorthNode", 10]
+  // SE_MEAN_NODE
+];
+var ASPECT_SYMBOLS = {
+  conjunction: "\u260C",
+  sextile: "\u26B9",
+  square: "\u25A1",
+  trine: "\u25B3",
+  opposition: "\u260D"
+};
+var ASPECT_DEFS = [
+  { type: "conjunction", angle: 0, maxOrb: 8 },
+  { type: "sextile", angle: 60, maxOrb: 6 },
+  { type: "square", angle: 90, maxOrb: 8 },
+  { type: "trine", angle: 120, maxOrb: 8 },
+  { type: "opposition", angle: 180, maxOrb: 8 }
+];
+var ROMAN = ["I", "II", "III", "IV", "V", "VI", "VII", "VIII", "IX", "X", "XI", "XII"];
+var HOUSE_SYSTEMS = [
+  ["P", "Placidus"],
+  ["K", "Koch"],
+  ["O", "Porphyrius"],
+  ["R", "Regiomontanus"],
+  ["C", "Campanus"],
+  ["E", "Equal"],
+  ["W", "Whole Sign"],
+  ["B", "Alcabitus"],
+  ["M", "Morinus"],
+  ["T", "Topocentric"]
+];
+var sweInstance = null;
+var initPromise = null;
+async function getSwissEph() {
+  if (sweInstance) return sweInstance;
+  if (initPromise) return initPromise;
+  initPromise = (async () => {
+    const swe = new SwissEph();
+    await swe.initSwissEph();
+    sweInstance = swe;
+    return swe;
+  })();
+  return initPromise;
+}
+function lonToSign(lon) {
+  return ZODIAC_SIGNS[Math.trunc(normalizeDeg(lon) / 30)];
+}
+function normalizeDeg(deg) {
+  return (deg % 360 + 360) % 360;
+}
+function degreeInSign(lon) {
+  return normalizeDeg(lon) % 30;
+}
+function angularDifference(lon1, lon2) {
+  let diff = Math.abs(normalizeDeg(lon1) - normalizeDeg(lon2));
+  if (diff > 180) diff = 360 - diff;
+  return diff;
+}
+function formatDegree(lon) {
+  const d = degreeInSign(lon);
+  const deg = Math.trunc(d);
+  const min = Math.trunc((d - deg) * 60);
+  return `${deg}\xB0${String(min).padStart(2, "0")}'`;
+}
+function findHouse(planetLon, cusps) {
+  const lon = normalizeDeg(planetLon);
+  for (let i = 1; i <= 12; i++) {
+    const start = normalizeDeg(cusps[i]);
+    const end = normalizeDeg(cusps[i === 12 ? 1 : i + 1]);
+    if (start < end) {
+      if (lon >= start && lon < end) return i;
+    } else {
+      if (lon >= start || lon < end) return i;
+    }
+  }
+  return 1;
+}
+function calculateAspects(planets) {
+  const aspects = [];
+  for (let i = 0; i < planets.length; i++) {
+    for (let j = i + 1; j < planets.length; j++) {
+      const p1 = planets[i];
+      const p2 = planets[j];
+      const diff = angularDifference(p1.longitude, p2.longitude);
+      for (const def of ASPECT_DEFS) {
+        const orb = Math.abs(diff - def.angle);
+        if (orb <= def.maxOrb) {
+          aspects.push({
+            planet1: p1.id,
+            planet2: p2.id,
+            type: def.type,
+            angle: def.angle,
+            orb: Math.round(orb * 10) / 10
+          });
+        }
+      }
+    }
+  }
+  aspects.sort((a, b) => a.orb - b.orb);
+  return aspects;
+}
+async function calculateNatal(input, houseSystem = "P") {
+  const swe = await getSwissEph();
+  const lat = input.latitude ?? DEFAULT_LAT;
+  const lon = input.longitude ?? DEFAULT_LON;
+  const utHourDecimal = input.hour + input.minute / 60 - 9;
+  let utYear = input.year;
+  let utMonth = input.month;
+  let utDay = input.day;
+  let utHour = utHourDecimal;
+  if (utHour < 0) {
+    utHour += 24;
+    const d = new Date(utYear, utMonth - 1, utDay - 1);
+    utYear = d.getFullYear();
+    utMonth = d.getMonth() + 1;
+    utDay = d.getDate();
+  } else if (utHour >= 24) {
+    utHour -= 24;
+    const d = new Date(utYear, utMonth - 1, utDay + 1);
+    utYear = d.getFullYear();
+    utMonth = d.getMonth() + 1;
+    utDay = d.getDate();
+  }
+  const jd = swe.julday(utYear, utMonth, utDay, utHour);
+  const housesEx = swe.houses_ex.bind(swe);
+  const { cusps, ascmc } = housesEx(jd, 0, lat, lon, houseSystem);
+  const calcFlags = swe.SEFLG_SWIEPH | swe.SEFLG_SPEED;
+  const planets = [];
+  for (const [id, bodyNum] of PLANET_BODIES) {
+    const pos = swe.calc_ut(jd, bodyNum, calcFlags);
+    const longitude = pos[0];
+    planets.push({
+      id,
+      longitude,
+      latitude: pos[1],
+      speed: pos[3],
+      sign: lonToSign(longitude),
+      degreeInSign: degreeInSign(longitude),
+      isRetrograde: pos[3] < 0,
+      house: findHouse(longitude, cusps)
+    });
+  }
+  const northNode = planets.find((p) => p.id === "NorthNode");
+  const southLon = normalizeDeg(northNode.longitude + 180);
+  planets.push({
+    id: "SouthNode",
+    longitude: southLon,
+    latitude: -northNode.latitude,
+    speed: northNode.speed,
+    sign: lonToSign(southLon),
+    degreeInSign: degreeInSign(southLon),
+    isRetrograde: false,
+    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)
+    });
+  }
+  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 aspects = calculateAspects(aspectPlanets);
+  return { input, planets, houses, angles, aspects };
+}
+
+export {
+  ZODIAC_SIGNS,
+  ZODIAC_SYMBOLS,
+  ZODIAC_KO,
+  PLANET_SYMBOLS,
+  PLANET_KO,
+  ASPECT_SYMBOLS,
+  ROMAN,
+  HOUSE_SYSTEMS,
+  getSwissEph,
+  lonToSign,
+  normalizeDeg,
+  formatDegree,
+  calculateNatal
+};