{"_id":"@astralium/liuyao","_rev":"2-2453fe67ab2cc5bcec2f25855bf70840","name":"@astralium/liuyao","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@astralium/liuyao","version":"0.1.0","license":"MIT","_id":"@astralium/liuyao@0.1.0","maintainers":[{"name":"astralium","email":"getastralium@gmail.com"}],"homepage":"https://github.com/kwu904-hash/liuyao#readme","bugs":{"url":"https://github.com/kwu904-hash/liuyao/issues"},"dist":{"shasum":"4d6b4290ab61b207347fac5b916fef2a0d90df79","tarball":"https://registry.npmjs.org/@astralium/liuyao/-/liuyao-0.1.0.tgz","fileCount":9,"integrity":"sha512-qUHVLRbKlOnggutbw2gfpvcV6x6L53hOLuwwJOfkCrQCMVY47Ed/+Kc3/YMkeQbJwpZ6lYyUejcL9YVHXnxkZA==","signatures":[{"sig":"MEYCIQCjPxMZk1Oe+lJzLgftL4ys+zDph8IuQo3HGcFgycW04wIhAN9sEYtfUK2q3DwHFas9SW5gmLNkStUunnN45J2QOLD2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":172628},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"bd4bfe202ab86411f613e52b27b3ec4ae624facb","scripts":{"test":"vitest run","build":"tsup","verify":"tsx scripts/verify.ts","prepack":"npm run build","typecheck":"tsc --noEmit"},"_npmUser":{"name":"astralium","email":"getastralium@gmail.com"},"repository":{"url":"git+https://github.com/kwu904-hash/liuyao.git","type":"git"},"_npmVersion":"11.12.1","description":"Astralium Liu Yao (京房纳甲六爻) calculation core: coin faces → structured hexagram. No interpretation, no auto-cast.","directories":{},"_nodeVersion":"24.15.0","dependencies":{"lunar-javascript":"^1.7.7"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.4","tsup":"^8.5.0","vitest":"^3.2.4","typescript":"~5.8.3","@types/node":"^24.12.3"},"_npmOperationalInternal":{"tmp":"tmp/liuyao_0.1.0_1789143382575_0.647774915799451","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@astralium/liuyao","version":"0.1.1","description":"Astralium Liu Yao (京房纳甲六爻) calculation core: coin faces → structured hexagram. No interpretation, no auto-cast.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/kwu904-hash/liuyao.git"},"bugs":{"url":"https://github.com/kwu904-hash/liuyao/issues"},"homepage":"https://github.com/kwu904-hash/liuyao#readme","type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"build":"tsup","typecheck":"tsc --noEmit","test":"vitest run","verify":"tsx scripts/verify.ts","prepack":"npm run build"},"publishConfig":{"access":"public"},"dependencies":{"lunar-javascript":"^1.7.7"},"devDependencies":{"@types/node":"^24.12.3","tsup":"^8.5.0","tsx":"^4.22.4","typescript":"~5.8.3","vitest":"^3.2.4"},"gitHead":"89cfc67322a67d1fcd3b7d0aee2f69108f7d0e51","_id":"@astralium/liuyao@0.1.1","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-F0G1+hx1q71+HK0Hoqx4x1K/By3940edSWOUZ/oU+LcD/MKwz/sPwio/6PYxA/EVTbtgl+keR4mN/38DaScpJA==","shasum":"d0612dbbb3e9ae69408f9c5866d04fbab70ba5ae","tarball":"https://registry.npmjs.org/@astralium/liuyao/-/liuyao-0.1.1.tgz","fileCount":9,"unpackedSize":171817,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCGc3GhuJ6I3vapPz4k/BILxGI3cmxcgnbKX7RHuKwZ0QIgPRZErGC6vgTSCMLrpJSsiuETMsK+PR/rIUTBlzLF3o0="}]},"_npmUser":{"name":"astralium","email":"getastralium@gmail.com"},"directories":{},"maintainers":[{"name":"astralium","email":"getastralium@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/liuyao_0.1.1_1789143952986_0.5693893709520568"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-11T16:16:22.360Z","modified":"2026-09-11T16:25:53.288Z","0.1.0":"2026-09-11T16:16:22.706Z","0.1.1":"2026-09-11T16:25:53.135Z"},"bugs":{"url":"https://github.com/kwu904-hash/liuyao/issues"},"license":"MIT","homepage":"https://github.com/kwu904-hash/liuyao#readme","repository":{"type":"git","url":"git+https://github.com/kwu904-hash/liuyao.git"},"description":"Astralium Liu Yao (京房纳甲六爻) calculation core: coin faces → structured hexagram. No interpretation, no auto-cast.","maintainers":[{"name":"astralium","email":"getastralium@gmail.com"}],"readme":"# Astralium Liu Yao / Astralium 六爻计算核\n\n京房纳甲六爻计算库：传入六次铜钱正反与起卦时刻，得到本卦、变卦、纳甲、六亲、六神、世应、伏神、旬空、日冲、月冲、进退神。\n\n```bash\nnpm i @astralium/liuyao\n```\n\n[Astralium](https://getastralium.com) 是商标。本库是独立的 MIT 开源计算核，不是托管产品，也不包含网站源码。\n\n不算命。不自动摇卦。不输出吉凶断语。\n\n## 铜钱口径\n\n传统字背（《卜筮正宗·以钱代蓍法》），**不是多数决**。\n\n| 背面数量 | 传入例子 | 爻值 | 阴阳 |\n| --- | --- | --- | --- |\n| 一背 | `[1, 0, 0]`（三枚顺序无所谓） | **少阳 7** | 阳、静 |\n| 二背 | `[1, 1, 0]` | **少阴 8** | 阴、静 |\n| 三背 | `[1, 1, 1]` | 老阳 9 | 阳、动 |\n| 三字（零背） | `[0, 0, 0]` | 老阴 6 | 阴、动 |\n\n- **`1` = 背**（无字 / 花徽），**`0` = 字**（有字）。\n- 一背是少阳，二背是少阴。按「哪面比较多」会把一背判阴、二背判阳，那是错的。\n- 六个三元组的顺序是 **初爻 → 上爻**（自下而上；下标 0 为初爻）。\n- `divinationDate` 为 `YYYY-MM-DD`，`divinationTime` 为 `HH:mm`，均为当地墙上时钟。**日界为 23:00**：当天 23:00 起改用次日日柱，与次日 00:30 相同。\n\n日柱、月建（节令月支）与旬空由运行时依赖 [`lunar-javascript`](https://github.com/6tail/lunar-javascript)（MIT）计算。\n\n## 例子\n\n```ts\nimport { buildLiuyaoChart } from \"@astralium/liuyao\";\n\nconst chart = buildLiuyaoChart({\n  throws: [\n    [1, 0, 0], // 一背 → 少阳 7\n    [1, 1, 0], // 二背 → 少阴 8\n    [1, 1, 1], // 三背 → 老阳 9（动）\n    [0, 0, 0], // 三字 → 老阴 6（动）\n    [1, 0, 0],\n    [1, 1, 0],\n  ],\n  divinationDate: \"2024-06-01\",\n  divinationTime: \"10:00\",\n});\n\nconsole.log(chart.primary.identity.name);  // 水火既济\nconsole.log(chart.changed?.identity.name); // 泽雷随\nconsole.log(chart.meta.engine);            // astralium-liuyao-jingfang-v1\n```\n\n稳定 API 只有包入口 `@astralium/liuyao`。`LiuYaoChartData`、`FuShenEntry`、`LineTransform`、`LiuQin`、`AdvanceRetreat` 等类型也从该入口导出：\n\n```ts\nimport type { FuShenEntry, LiuQin, LineTransform } from \"@astralium/liuyao\";\n```\n\n日期或时间格式无效时，错误信息会附带你传入的值，并给出合法示例。\n\n## 本库不做的事\n\n- 吉凶、应期、旺衰等断语\n- 代为摇卦或生成随机铜钱（六次投掷必须由调用方传入）\n- 选用神或排卦意主题\n- 阅读文案、卡片或其他应用层输出\n\n结构标记止于当前实现：不计算日破 / 暗动断语、完整出伏、变卦伏神。\n\n## 开发\n\n克隆本仓库后：\n\n```bash\nnpm install\nnpm test\nnpm run verify\n```\n\n`verify` 会核对铜钱映射、六十四卦、日界与进退神等回归项。\n\n## License\n\nMIT.\n","readmeFilename":"README.md"}