{"_id":"@aharris02/bazi-calculator-by-alvamind","_rev":"13-b89b059020b6d9df582c6b71fba8a7d0","name":"@aharris02/bazi-calculator-by-alvamind","dist-tags":{"latest":"1.0.16"},"versions":{"1.0.2":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.2","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.2","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"ff8008c356efe8d1abd9014d8f9f1de43e520bd4","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.2.tgz","fileCount":10,"integrity":"sha512-xqQkOfmYzutfO4gN8fY4m1eG4vKNe0T37SXpDrXvEn9j2GD9fPQ1+q/i38i58njaxbBVm5rs4Q+oHuW5ZEmtxw==","signatures":[{"sig":"MEUCIQDF9ZJv1xgScybvFwEkhDBvpQq/Ar3pnshuGNgjNpP3dAIgKhC9Aqu/RywhgGAL9+4Pj5gqPYPaClDpmQpSU9Z7770=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7785748},"main":"src/index.ts","type":"module","types":"src/index.ts","gitHead":"0a1258f059be2b21fb6cfeb18d785668405df0ce","scripts":{"lint":"eslint src*.ts","build":"tsc && tsc -p tsconfig.build.json","clean":"clean","commit":"commit","format":"prettier --write \"src*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"publish-npm patch"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.2_1745960660405_0.5474569236409084","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.3","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.3","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"cc772f934a3b996dc9587d86894cb9d423017fe8","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.3.tgz","fileCount":16,"integrity":"sha512-LiH9h3M0sj5P/0mLiKipwXP4SgqINBVMa+iDVLusD3+CMpBvBQP9xIWJJ12w7tkqzFGLlBno8irEYGijaAnrkw==","signatures":[{"sig":"MEUCIQCF3eb8iH0hrzN3nMGnfkDaopoC1e9UYcrwyHD3CDdAjQIgcMNsBwXdwe8YgDkZFLrFcV5Eqv91l5Sxn9U6OzjoKBc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25349},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"d417480c7440a72e40176baf842ddd57e3b9ee30","scripts":{"lint":"eslint src/*.ts","build":"tsc -p tsconfig.build.json","clean":"clean","commit":"commit","format":"prettier --write \"src/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.3_1745961701369_0.28346146171449016","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.4","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.4","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"4c5193ccae94ac8384bde4fdfb30ba470a300c6d","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.4.tgz","fileCount":17,"integrity":"sha512-FYpuG5bzkA82XxTuBErfvFnRuj7hecUjgn9gK4JhNGFf2BdGmTjxXaXnpe1zhd4tepeVlJNdIit+x4av7Re+Vg==","signatures":[{"sig":"MEYCIQDM/dWZqPz6YMbzid2/KODAeh9qfW5Tl8EfgGJWY5wfwAIhAIUhMXpxTOMvsUBINhnutEE1m3286KNgHZPl07lKvUKe","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7788732},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"9db07cc642c0a566ae1961c1f17a1f9cc62260fd","scripts":{"lint":"eslint src/*.ts","build":"tsc -p tsconfig.build.json","clean":"clean","commit":"commit","format":"prettier --write \"src/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.4_1745962439095_0.6886157507482389","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.5","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.5","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"5edda254436999e85c2b9e4a55e6943d7717817a","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.5.tgz","fileCount":17,"integrity":"sha512-ClB0HeLTmj2eFC7I2AogayB28xwbuHkYmsIVax8AGy5le4EVUmFjGfQkzdhSchsIwweHFJjwbS1l6QnwXvSL4A==","signatures":[{"sig":"MEYCIQC97KwzMcpOMhiB+pbzvE9M6FODwcZlP5lchnoM6DS7NwIhAOAS722SM5jJdyQYanHH5irShs0jsNCtdur4VkuJ5z/h","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7788765},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"6057fe51868d3bee8ac2e7696c27b3852eaf8d6b","scripts":{"lint":"eslint src/*.ts","build":"tsc -p tsconfig.build.json && cp -R src/assets dist/assets","clean":"clean","commit":"commit","format":"prettier --write \"src/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.5_1745962906889_0.033899860295014905","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.6","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.6","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"e6f2d21eebf31acaa2589f035a2d419f6576c97c","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.6.tgz","fileCount":18,"integrity":"sha512-X3HSw2MozIwaq7ZrbOHehTINeZEEVmPZXa4+EEVRtXO8a8RRMHVeGTKux0e6YrB74uE3yRjYjzykcHNuMKKyDw==","signatures":[{"sig":"MEUCIE6NQiobJ0S7vSXgAwYAmZ7qykJy8biD8hKLLF8fG+xZAiEAvGhFoxRZU/Qh1tFeKArCFgPOyjiAh4eiyBgufaoToas=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18518987},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"6057fe51868d3bee8ac2e7696c27b3852eaf8d6b","scripts":{"lint":"eslint src/*.ts","build":"tsc -p tsconfig.build.json && cp -R src/assets dist/assets","clean":"clean","commit":"commit","format":"prettier --write \"src/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.6_1746043064206_0.9641927947501154","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.7","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.7","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"1ef7142819a544807ae28cdbf69923ee25428df7","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.7.tgz","fileCount":6,"integrity":"sha512-1LodwO+IUzcpCcvFMC4Euq7Eosrcu6JUr3dlnSS8eDpUb/Z6Yd+plioboM0H1ZW3ibfWTM6OxkhkoLMUoB5XoA==","signatures":[{"sig":"MEUCIQClAkwl8kMEzZSuOuNHFP47E11O33KI0LfKO9tPoIxn3QIgb1Ot2IPMHoBlb+2BDs331uUA6uS0AWSHEQH1D8v2gGc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14344007},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"f45e85aca5145cec57d3ee5b7efada329ec28b8d","scripts":{"lint":"eslint src/*.ts","build":"tsup src/index.ts --format esm,cjs --dts --clean","clean":"clean","commit":"commit","format":"prettier --write \"src/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.7_1746044444039_0.8642319387682236","host":"s3://npm-registry-packages-npm-production"}},"1.0.8":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.8","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.8","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"1eca5b157cc1e93e09dfa0ffdd81cf92816568e2","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.8.tgz","fileCount":7,"integrity":"sha512-dcKW0S6bR6LIHCCINivKUCQ2/pvd3h3q1EGvx35I6+ePlFxj5MzKg/eWOGb4BcbzkeDM+e1PL/Y07KObZoamjQ==","signatures":[{"sig":"MEUCIEMUZattk6vW/0qevv9ooIsnCXCCeOAtrd1+sooFzI3MAiEAgZSvojWN//M00e8dV7i3h0uIpHLgwSCDZhkfv664luU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22107460},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./package.json":"./package.json"},"gitHead":"f45e85aca5145cec57d3ee5b7efada329ec28b8d","scripts":{"lint":"eslint src/**/*.ts","build":"tsup src/index.ts --format esm,cjs --dts --clean --out-dir dist --publicDir src/assets","clean":"clean","commit":"commit","format":"prettier --write \"src/**/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.8_1746045759438_0.5324084628983228","host":"s3://npm-registry-packages-npm-production"}},"1.0.9":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.9","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.9","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"4319c6fc08a868d594dc3060db425cc08986aff8","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.9.tgz","fileCount":7,"integrity":"sha512-KUizleUt6loHY1cuJPtR0V6UnZZ+et8FiGpL429GXIPitHgYVza6Ya9Rxw6r0tEcJAblhLHT2LlcVLCqm7yBxw==","signatures":[{"sig":"MEUCIQC8iUF1xXqlWX7NfAM1AUpXmM4p4HH6rHw6AFUUPZFczgIgbfRUZGJATDgP+4wTzNSGIUwlaU0sbl/5nPFFkQ6kqb8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22107460},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./package.json":"./package.json"},"gitHead":"43ae2ac6991b8934e31f262a33fbd8144ee91d9f","scripts":{"lint":"eslint src/**/*.ts","build":"tsup src/index.ts --format esm,cjs --dts --clean --out-dir dist --publicDir src/assets","clean":"clean","commit":"commit","format":"prettier --write \"src/**/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.9_1746046108543_0.8445962220731857","host":"s3://npm-registry-packages-npm-production"}},"1.0.10":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.10","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.10","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"3268301820d2dd72f02514e151cdd6ba96c240fd","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.10.tgz","fileCount":7,"integrity":"sha512-DyOVZGVw2NaGo14raUfKNCpp9AG6DOa48BSZRFJCNqRZIHYP1vw5Q5H4dXQ64ap5eMKuKOzIitUp5uUkzrHZdw==","signatures":[{"sig":"MEUCIB+8tmEAcx3Nzs9qK20wJUjVgJwu4fYJQwbhVXssBYi6AiEApx7CFnUxb3XXUzGO/ko1XEwmj6Wv0JlgcTTzxmS6WR8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22107463},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"},"./package.json":"./package.json"},"gitHead":"b7c055c69caa27480466534297b372ff85d8b6ae","scripts":{"lint":"eslint src/**/*.ts","build":"tsup src/index.ts --format esm,cjs --dts --clean --out-dir dist --publicDir src/assets","clean":"clean","commit":"commit","format":"prettier --write \"src/**/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.10_1746050722433_0.5757240751611732","host":"s3://npm-registry-packages-npm-production"}},"1.0.12":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.12","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.12","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"1a19e48f9f150e935e9aa15e7349275203582797","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.12.tgz","fileCount":7,"integrity":"sha512-K6Vt5BDb4ZVuEc9RqVWbTwzxZO0+iJM2Wj2GQNr5OQknKd0/ieVNkvCrcFkdlQhuM2LiA9APgVCDs8BxnZnmEg==","signatures":[{"sig":"MEUCIBliEjTyO5Jjbr622wEXuarQTDe4mn/m8FqmEdNwSaYaAiEA2xRuLsZ4v/AL3FUA5D/nAD1kiU6+XV7ITb/Qoh7GKlQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22107461},"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"},"./package.json":"./package.json"},"gitHead":"c19dd251a72f837c99199ebbfe84ff558091d95d","scripts":{"lint":"eslint src/**/*.ts","build":"tsup src/index.ts --format esm,cjs --dts --clean --out-dir dist --publicDir src/assets","clean":"clean","commit":"commit","format":"prettier --write \"src/**/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","@types/bun":"latest","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.12_1746052521726_0.27294247913934866","host":"s3://npm-registry-packages-npm-production"}},"1.0.14":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.14","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.14","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"c0b4be86ff0f9d389a3f0fef2f4cf5880d6fc944","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.14.tgz","fileCount":8,"integrity":"sha512-7FPz9P91b6eNx9AvAK5IhUHPIDT2gx6lX2OFPl+6qVQJDU5zJInHVC5/QOF61AabL8OvgzUZkQT8D7VJJlOdKQ==","signatures":[{"sig":"MEUCIHrppdr3pjedx+xKhsdagjbNNS6oKq793UnYBMMS8v9TAiEAsfKr27mEdfypcF5JrKINEb71facV0sak5U7LEp1BkeY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":951301},"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"},"./package.json":"./package.json"},"gitHead":"ae3ad3e50f66769a4259bb0377baf640351a5c11","scripts":{"lint":"eslint src/**/*.ts","build":"tsup src/index.ts --format esm,cjs --dts --clean --out-dir dist --publicDir src/assets","clean":"clean","commit":"commit","format":"prettier --write \"src/**/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"date-fns":"^4.1.0","date-fns-tz":"^3.2.0","alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","@types/bun":"latest","typescript":"^5.8.3","@types/node":"^22.15.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.14_1746134316527_0.7001640367899733","host":"s3://npm-registry-packages-npm-production"}},"1.0.15":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.15","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","_id":"@aharris02/bazi-calculator-by-alvamind@1.0.15","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"dist":{"shasum":"1235ed7f6dd5db1350cd386a87197b6e79cc1c68","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.15.tgz","fileCount":8,"integrity":"sha512-Z1FpJD4VdqMnO4JcwnYU64t477Iltin8sQzxd/fiYzNMmkCCqFJb10AKAGkrGd8/vRV7ZmN0S7tdCYzjsiHR9w==","signatures":[{"sig":"MEQCIA4XiJTosirNRxcdsEIqmJHGP0WRjZcQLyxZCzUVXWK/AiAFOItAqSaophnSG03Xnxp1DQEl+4Y6FhvXOP8hmXXnvQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1052653},"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"},"./package.json":"./package.json"},"gitHead":"77bf3ca2f19dd27c764c92cc0e6edd198dcf7250","scripts":{"lint":"eslint src/**/*.ts","build":"tsup src/index.ts --format esm,cjs --dts --clean --out-dir dist --publicDir src/assets","clean":"clean","commit":"commit","format":"prettier --write \"src/**/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output","publish-npm":"npm run build && npm publish"},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"repository":{"url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git","type":"git"},"_npmVersion":"11.3.0","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","directories":{},"_nodeVersion":"23.6.0","dependencies":{"date-fns":"^4.1.0","date-fns-tz":"^3.2.0","alvamind-tools":"^1.0.23"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","@types/bun":"latest","typescript":"^5.8.3","@types/node":"^22.15.3"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bazi-calculator-by-alvamind_1.0.15_1746151774719_0.061726193929533935","host":"s3://npm-registry-packages-npm-production"}},"1.0.16":{"name":"@aharris02/bazi-calculator-by-alvamind","version":"1.0.16","description":"A fork of alvamind's comprehensive Bazi calculator for personal use","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./package.json":"./package.json"},"main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","type":"module","repository":{"type":"git","url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git"},"scripts":{"build":"tsup src/index.ts --format esm,cjs --dts --clean --out-dir dist --publicDir src/assets","publish-npm":"npm run build && npm publish","lint":"eslint src/**/*.ts","format":"prettier --write \"src/**/*.ts\"","source":"generate-source output=documentation.md exclude=dist/,node_modules/,.git/","commit":"commit","clean":"clean","split-code":"split-code source=combined.ts markers=src/,lib/ outputDir=./output"},"keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"author":{"name":"Alvamind"},"license":"MIT","devDependencies":{"@types/bun":"latest","@types/node":"^22.15.3","tsup":"^8.4.0","typescript":"^5.8.3"},"peerDependencies":{"typescript":"^5.0.0"},"dependencies":{"alvamind-tools":"^1.0.23","date-fns":"^4.1.0","date-fns-tz":"^3.2.0"},"_id":"@aharris02/bazi-calculator-by-alvamind@1.0.16","gitHead":"4081313725ea262eafdcbcbc8d88ee39ab0642da","bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","_nodeVersion":"23.6.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-lEFSA1Xbc1r+2eSorNpOFqS2VbioFwg5UbFGItolmhLBqFFyO9Gfejl83+mVu1fxlWg4yyOowO0nP4Cf2/mhag==","shasum":"df6ca89442ec653a00c941b8b77b77159aa1b360","tarball":"https://registry.npmjs.org/@aharris02/bazi-calculator-by-alvamind/-/bazi-calculator-by-alvamind-1.0.16.tgz","fileCount":8,"unpackedSize":1083712,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDvxPZh7xoM6HRFc05MDcwjks6HIxXPlqSGEjg+DQlhmgIgA0+MVvmcuIg4LdF2aJduT1VHUs1NflniY0GV1Im1cjw="}]},"_npmUser":{"name":"aharris02","email":"alan.harris02@gmail.com"},"directories":{},"maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bazi-calculator-by-alvamind_1.0.16_1746834857268_0.49989450739472985"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-29T21:04:20.322Z","modified":"2025-05-09T23:54:17.737Z","1.0.2":"2025-04-29T21:04:20.632Z","1.0.3":"2025-04-29T21:21:41.563Z","1.0.4":"2025-04-29T21:33:59.326Z","1.0.5":"2025-04-29T21:41:47.108Z","1.0.6":"2025-04-30T19:57:44.479Z","1.0.7":"2025-04-30T20:20:44.260Z","1.0.8":"2025-04-30T20:42:39.672Z","1.0.9":"2025-04-30T20:48:28.807Z","1.0.10":"2025-04-30T22:05:22.795Z","1.0.12":"2025-04-30T22:35:21.963Z","1.0.14":"2025-05-01T21:18:36.762Z","1.0.15":"2025-05-02T02:09:35.040Z","1.0.16":"2025-05-09T23:54:17.546Z"},"bugs":{"url":"https://github.com/aharris02/bazi-calculator-by-alvamind/issues"},"author":{"name":"Alvamind"},"license":"MIT","homepage":"https://github.com/aharris02/bazi-calculator-by-alvamind#readme","keywords":["bazi","calculator","chinese","astrology","fengshui","four pillars"],"repository":{"type":"git","url":"git+https://github.com/aharris02/bazi-calculator-by-alvamind.git"},"description":"A fork of alvamind's comprehensive Bazi calculator for personal use","maintainers":[{"name":"aharris02","email":"alan.harris02@gmail.com"}],"readme":"# Bazi Calculator (TypeScript Port)\n\n> ⚠️ This is a fork of the original [bazi-calculator-by-alvamind](https://www.npmjs.com/package/bazi-calculator-by-alvamind) and incorporates work from [bazica by tommitoan](https://github.com/tommitoan/bazica), published by @aharris02 for compatibility with modern TypeScript builds and deployment environments (e.g. Vercel).\n\n\n\n[](https://www.npmjs.com/package/@aharris02/bazi-calculator-by-alvamind)\n[](https://opensource.org/licenses/MIT)\n[](https://www.typescriptlang.org/)\n[](https://www.npmjs.com/package/@aharris02/bazi-calculator-by-alvamind)\n\nA modern, accurate, and comprehensive Bazi (八字 / Four Pillars of Destiny) calculator and analyzer with robust timezone handling and advanced features.\n\n[Installation](#installation) • [Quick Start](#quick-start) • [Documentation](#detailed-documentation) • [Contributing](#contributing)\n\n
\n\n## 📢 Disclaimer\n\nThis package is provided for educational and research purposes only. The calculations and interpretations should not be used as the sole basis for making important life decisions. Chinese Metaphysics and Bazi analysis require professional expertise and years of study.\n\n## ✨ Key Features\n\n### Core Calculations\n- **Four Pillars (四柱) Calculation:** Accurate Year, Month, Day, and Hour pillar determination.\n- **Timezone-Aware Processing:** Requires IANA timezone strings (e.g., `America/New_York`, `Asia/Shanghai`).\n- **Unknown Birth Time Handling:** Gracefully calculates when exact birth time is unknown.\n- **Luck Pillars Calculation:** Determines 10-year Luck Pillar sequence with direction and precise start age.\n- **Gender Normalization:** Accepts various gender inputs but normalizes to `'male'` or `'female'`, since Bazi is based on binary genders.\n\n### Analysis Components\n- **Five Elements (五行) Analysis:** Element distribution with relationship weighting.\n- **Day Master (日主) Analysis:** Stem, Element, Yin/Yang properties.\n- **Eight Mansions (八宅) Feng Shui:** Life Gua calculation with favorable/unfavorable directions.\n- **Destiny Indicators:** Nobleman (貴人), Intelligence Star (文昌), Sky Horse (天馬), Peach Blossom (桃花).\n- **Stem & Branch Interactions:** Comprehensive detection of Combinations, Clashes, Harms, Punishments, and Destructions within Natal chart and with Luck/Timed Pillars.\n- **Ten Gods (十神) Calculation:** Determines the Ten Gods relationships between Heavenly Stems (Natal, Luck, Timed).\n- **Day Master Strength Assessment:** Provides an estimated strength of the Day Master.\n- **Favorable Elements Suggestion:** Suggests potentially favorable elements based on Day Master strength.\n- **Timed Event Analysis:**\n - `getAnalysisForDate(targetDate, targetTimezone, options)`: Provides detailed analysis for a single specific day, either in a 'general' context (the day's own chart) or 'personalized' (how that day interacts with a natal chart).\n - `getAnalysisForDateRange(startDate, endDate, targetTimezone, options)`: Provides daily analysis for a range of dates, supporting both 'general' and 'personalized' modes.\n\n### Technical Features\n- 🔒 Type-safe with TypeScript\n- 📦 ES Module Support\n- 🌐 Timezone-correct calculations via `date-fns-tz`\n- 📝 Comprehensive Type Definitions (see `src/types.ts` and exported types)\n- ⚡ Optimized Performance\n\n## 🚀 Installation\n\n```bash\n# Using npm\nnpm install @aharris02/bazi-calculator-by-alvamind date-fns date-fns-tz\n\n# Using yarn\nyarn add @aharris02/bazi-calculator-by-alvamind date-fns date-fns-tz\n\n# Using pnpm\npnpm add @aharris02/bazi-calculator-by-alvamind date-fns date-fns-tz\n```\n\n> **Note:** This library requires `date-fns` and `date-fns-tz` as peer dependencies for robust date and timezone handling.\n\n## 🎯 Quick Start\n\n```typescript\nimport { BaziCalculator } from '@aharris02/bazi-calculator-by-alvamind';\nimport { toDate } from 'date-fns-tz'; // Essential for timezone-aware Date creation\n\n// Define Birth Details\nconst dateString = '1990-05-10T12:30:00';\nconst timezone = 'Asia/Shanghai';\nconst gender = 'male';\n\n// Create a timezone-aware Date object (IMPORTANT!)\nconst birthDate = toDate(dateString, { timeZone: timezone });\n\n// Initialize calculator with modern constructor\nconst calculator = new BaziCalculator(\n birthDate, // Date object (timezone-aware)\n gender, // Gender ('male' or any other string -> 'female')\n timezone, // IANA Timezone string\n true // Is birth time known? (default: true)\n);\n\n// Get complete analysis for the natal chart\nconst analysis = calculator.getCompleteAnalysis();\n\n// Display Chinese characters for the natal chart\nconsole.log(calculator.toString()); // Example: 庚午年辛巳月乙酉日壬午時\n\nif (analysis) {\n console.log(\"Day Master:\", analysis.basicAnalysis?.dayMaster?.stem);\n // Access other parts of the analysis object as needed\n}\n```\n\nFor more detailed examples, including handling unknown birth times and using new daily/range analysis features, please see the [Detailed Documentation](#detailed-documentation) section.\n\n## 📖 Detailed Documentation\n\n### Birth Time Known Example\n\n```typescript\nimport { BaziCalculator } from '@aharris02/bazi-calculator-by-alvamind';\nimport { toDate, formatInTimeZone } from 'date-fns-tz';\nimport { isValid } from 'date-fns';\n\n// 1. Define Birth Details\nconst year = 1995;\nconst month = 6; // 1-12\nconst day = 8;\nconst hour = 22; // 0-23\nconst minute = 5;\nconst gender = 'male'; // or 'female', 'nonbinary', 'other', etc.\nconst timeZone = 'Asia/Ho_Chi_Minh'; // IANA Timezone String is crucial!\nconst isTimeKnown = true; // Explicitly state time is known\n\n// 2. Create a Timezone-Aware Date Object\n// IMPORTANT: Use date-fns-tz's toDate for correct initial parsing\nconst dateString = `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}T${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}:00`;\nconst birthDate = toDate(dateString, { timeZone });\n\nif (!isValid(birthDate)) {\n console.error(\"Invalid Date constructed. Check inputs and timezone.\");\n // Handle error appropriately\n} else {\n // 3. Instantiate the Calculator\n // Gender normalizes internally: non-'male' inputs become 'female' for calculations\n const calculator = new BaziCalculator(birthDate, gender, timeZone, isTimeKnown);\n\n // 4. Get the Complete Analysis\n const analysis = calculator.getCompleteAnalysis();\n\n if (analysis) {\n console.log(\"--- Four Pillars (Simple) ---\");\n console.log(analysis.mainPillars);\n // Example: { year: {...}, month: {...}, day: {...}, time: {...} }\n\n console.log(\"\\n--- Luck Pillars Summary ---\");\n if (analysis.luckPillars) {\n console.log(`Direction: ${analysis.luckPillars.incrementRule === 1 ? 'Forward' : 'Backward'}`);\n console.log(`Timing Known: ${analysis.luckPillars.isTimingKnown}`);\n console.log(`Start Age: ${analysis.luckPillars.startAgeYears}y ${analysis.luckPillars.startAgeMonths}m ${analysis.luckPillars.startAgeDays}d`);\n }\n\n console.log(\"\\n--- Basic Analysis ---\");\n console.log(analysis.basicAnalysis);\n\n console.log(\"\\n--- Chart String ---\");\n console.log(calculator.toString()); // Output: 乙亥年 壬午月 庚午日 丁亥時\n }\n}\n```\n\n### Unknown Birth Time Example\n\n```typescript\nimport { BaziCalculator } from '@aharris02/bazi-calculator-by-alvamind';\nimport { toDate } from 'date-fns-tz';\nimport { isValid } from 'date-fns';\n\nconst year = 1995;\nconst month = 6;\nconst day = 8;\nconst hour = 12; // Placeholder Hour (e.g., noon)\nconst minute = 0; // Placeholder Minute\nconst gender = 'male';\nconst timeZone = 'Asia/Ho_Chi_Minh';\nconst isTimeKnown = false; // <<< Indicate time is unknown\n\nconst dateString = `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}T${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}:00`;\nconst birthDate = toDate(dateString, { timeZone });\n\nif (isValid(birthDate)) {\n const calculator = new BaziCalculator(birthDate, gender, timeZone, isTimeKnown);\n const analysis = calculator.getCompleteAnalysis();\n\n if (analysis) {\n console.log(\"--- Analysis (Unknown Time) ---\");\n\n console.log(\"Pillars:\", analysis.mainPillars);\n // Output will have time: null\n\n console.log(\"Pillars String:\", calculator.toString());\n // Output: 乙亥年 壬午月 庚午日 ??時\n\n console.log(\"Luck Pillars Timing Known:\", analysis.luckPillars?.isTimingKnown);\n // Output: false\n\n console.log(\"Luck Pillars Start Age:\", analysis.luckPillars?.startAgeYears);\n // Output: null\n\n // Note: Some analysis components like Ten Gods related to the Hour Pillar might be absent or less precise.\n console.log(\"Five Factors:\", analysis.basicAnalysis?.fiveFactors);\n }\n}\n```\n\n### Daily Analysis (`getAnalysisForDate`) Example\n\nThis method provides analysis for a single specific day.\n\n```typescript\nimport { BaziCalculator } from '@aharris02/bazi-calculator-by-alvamind';\nimport { toDate } from 'date-fns-tz';\n\n// Assume 'calculator' is an instance of BaziCalculator initialized with a natal chart (for 'personalized' analysis)\n// For 'general' analysis, a dummy BaziCalculator instance can be used if you only need the day's chart.\nconst natalBirthDate = toDate('1990-01-01T10:00:00', { timeZone: 'America/New_York' });\nconst natalCalculator = new BaziCalculator(natalBirthDate, 'female', 'America/New_York', true);\n\n// Define the target date and timezone for the daily analysis\nconst targetDateString = '2025-05-09T12:00:00'; // Time component is used to ensure the correct day in the target timezone\nconst targetTimezone = 'America/New_York'; // CRUCIAL: This determines the day's pillars\n\nconst targetDate = toDate(targetDateString, { timeZone: targetTimezone });\n\n// 1. General Daily Analysis (the day's own chart and interactions)\nconst generalDailyAnalysis = natalCalculator.getAnalysisForDate(targetDate, targetTimezone, { type: 'general' });\nif (generalDailyAnalysis) {\n console.log(\"\\n--- General Daily Analysis for\", generalDailyAnalysis.date, \"---\");\n console.log(\"Day Pillar:\", generalDailyAnalysis.dayPillar.chinese);\n // Explore generalDailyAnalysis.interactions, .annualPillarContext, .monthlyPillarContext etc.\n // Output structure defined in GeneralDailyAnalysisOutput in src/types.ts\n}\n\n// 2. Personalized Daily Analysis (how the target day interacts with the natal chart)\nconst personalizedDailyAnalysis = natalCalculator.getAnalysisForDate(targetDate, targetTimezone, { type: 'personalized' });\nif (personalizedDailyAnalysis) {\n console.log(\"\\n--- Personalized Daily Analysis for\", personalizedDailyAnalysis.date, \"---\");\n console.log(\"Day Pillar of Target Date:\", personalizedDailyAnalysis.dayPillar.chinese);\n console.log(\"Interactions with Natal Chart:\", personalizedDailyAnalysis.interactions);\n // Explore personalizedDailyAnalysis.currentLuckPillarSnap etc.\n // Output structure defined in PersonalizedDailyAnalysisOutput in src/types.ts\n}\n```\n**Important Note on `targetTimezone`:** The `targetTimezone` parameter is critical for `getAnalysisForDate` and `getAnalysisForDateRange`. It determines how the `targetDate` (or dates in the range) is interpreted to calculate its daily pillars. Using the wrong timezone can lead to off-by-one day errors in the analysis.\n\n### Date Range Analysis (`getAnalysisForDateRange`) Example\n\nThis method provides daily analysis for a sequence of dates.\n\n```typescript\nimport { BaziCalculator } from '@aharris02/bazi-calculator-by-alvamind';\nimport { toDate } from 'date-fns-tz';\n\n// Assume 'natalCalculator' is an instance of BaziCalculator initialized with a natal chart (for 'personalized' analysis)\nconst natalBirthDate = toDate('1990-01-01T10:00:00', { timeZone: 'America/New_York' });\nconst natalCalculator = new BaziCalculator(natalBirthDate, 'female', 'America/New_York', true);\n\nconst rangeTimezone = 'America/Los_Angeles'; // Timezone for the daily analysis within the range\n\n// Define the start and end dates for the range.\n// Use toDate with the rangeTimezone to ensure correct day boundaries.\nconst startDate = toDate('2025-06-01T00:00:00', { timeZone: rangeTimezone });\nconst endDate = toDate('2025-06-03T00:00:00', { timeZone: rangeTimezone }); // Inclusive of this day\n\n// 1. General Date Range Analysis\nconst generalRangeAnalysis = natalCalculator.getAnalysisForDateRange(startDate, endDate, rangeTimezone, { type: 'general' });\nif (generalRangeAnalysis) {\n console.log(\"\\n--- General Date Range Analysis ---\");\n generalRangeAnalysis.forEach(dayAnalysis => {\n console.log(dayAnalysis.date, \"Day Pillar:\", dayAnalysis.dayPillar.chinese);\n });\n}\n\n// 2. Personalized Date Range Analysis\nconst personalizedRangeAnalysis = natalCalculator.getAnalysisForDateRange(startDate, endDate, rangeTimezone, { type: 'personalized' });\nif (personalizedRangeAnalysis) {\n console.log(\"\\n--- Personalized Date Range Analysis ---\");\n personalizedRangeAnalysis.forEach(dayAnalysis => {\n console.log(dayAnalysis.date, \"Interactions with Natal:\", dayAnalysis.interactions.length, \"interactions found.\");\n });\n}\n```\nRefer to `src/types.ts` or the exported types (`GeneralDailyAnalysisOutput`, `PersonalizedDailyAnalysisOutput`) for the detailed structure of the objects returned by these methods.\n\n### API Reference\n\n#### `BaziCalculator` Class\n\n```typescript\nclass BaziCalculator {\n constructor(\n birthDateTime: Date, // Timezone-aware Date object (use date-fns-tz's toDate)\n genderInput?: string, // 'male', 'female' (other inputs default to 'female')\n timezoneInput?: string, // IANA timezone string (defaults to 'UTC')\n isTimeKnownInput?: boolean // Whether the exact hour/minute are known (defaults to true)\n );\n\n // Main Natal Chart methods\n calculatePillars(): Pillars | null;\n calculateLuckPillars(): LuckPillarsResult | null;\n calculateBasicAnalysis(): BasicAnalysis | null;\n getCompleteAnalysis(): CompleteAnalysis | null; // Recommended for full natal chart\n toString(): string; // Returns the Four Pillars as a Chinese string\n\n // Timed Analysis methods\n getAnalysisForDate(\n targetDate: Date,\n targetTimezone: string, // IANA timezone for interpreting targetDate\n options: { type: 'general' | 'personalized' }\n ): GeneralDailyAnalysisOutput | PersonalizedDailyAnalysisOutput | null;\n\n getAnalysisForDateRange(\n startDate: Date,\n endDate: Date,\n targetTimezone: string, // IANA timezone for interpreting dates in the range\n options: { type: 'general' | 'personalized' }\n ): (GeneralDailyAnalysisOutput | PersonalizedDailyAnalysisOutput)[] | null;\n}\n```\nFor detailed information on the structures returned by these methods (e.g., `CompleteAnalysis`, `Pillars`, `LuckPillarsResult`, `GeneralDailyAnalysisOutput`, `PersonalizedDailyAnalysisOutput`), please refer to the exported types from the library and the definitions in `src/types.ts`.\n\n### Data Files\nThis library relies on internal JSON data for calculations:\n\n- `lunar-new-year.json`: Used for determining the Lunar Year for the Year Pillar.\n- `solar-term.json`: Used for determining the Month Branch and Luck Pillar timing.\n\nThese files are bundled with the library.\n\n## 📝 Important Notes\n\n### Calculation Methods\n- Timezone-aware calculations using IANA timezone strings are essential. Always use `date-fns-tz`'s `toDate` when creating `Date` objects from strings to pass to the calculator.\n- Traditional Chinese time system (12 two-hour periods).\n- Standard Stem-Branch (干支) system.\n- Eight Mansions Feng Shui principles.\n- Support for unknown birth time calculations (Hour Pillar will be null, affecting some analyses).\n- Interaction analysis includes Natal, Luck, Annual, Monthly, and Daily pillars as applicable.\n\n### Limitations\n- Luck Pillar Start Time precision depends on solar term data.\n- Calculations use standard timezone time, not Real Solar Time adjusted for longitude.\n- While Ten Gods are calculated, advanced interpretations and very specific Symbolic Star analyses beyond the core set (Nobleman, Intelligence, Sky Horse, Peach Blossom) are not exhaustive.\n- For professional consultations, please consult a qualified Bazi practitioner.\n\n## 🤝 Contributing\n\nWe welcome contributions! See our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n## 📄 License\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\n\n**Based on the original work by [Alvamind](https://github.com/alvamind)**\n\n
\n","readmeFilename":"README.md"}