bazi-chart 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AskingMing (https://askingming.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# bazi-chart
+
+> React component + adapters for rendering Bazi / Four Pillars (八字·四柱) charts. Bilingual, inline styles, SSR-safe. Part of [BaziKit](../../README.md).
+
+Feed `<BaziChart />` your chart data — it auto-detects the input shape, normalizes it, and renders a complete chart in Chinese, English, or both. It never calculates anything itself.
+
+## Install
+
+```bash
+npm install bazi-chart
+```
+
+`react` (>= 17) is a peer dependency. Terminology comes from [`bazi-terms`](../bazi-terms) (installed automatically).
+
+## Usage
+
+`<BaziChart />` accepts either **raw output from your Bazi engine** (the two most common community shapes are auto-detected) or a **pre-normalized `NormalizedChart`**:
+
+```tsx
+import { BaziChart } from 'bazi-chart';
+
+// `data` = raw engine output (auto-detected) …
+export default function Chart({ data }) {
+  return <BaziChart data={data} lang="both" theme="light" />;
+}
+```
+
+```tsx
+import { BaziChart } from 'bazi-chart';
+import type { NormalizedChart } from 'bazi-chart';
+
+// … or a chart object you built yourself.
+export default ({ chart }: { chart: NormalizedChart }) => (
+  <BaziChart chart={chart} lang="en" theme="dark" />
+);
+```
+
+### What it renders
+
+Four Pillars (with main star, stem/branch glyphs colour-coded by element, hidden stems and their ten gods, Na Yin, growth stage, void branches and Shen Sha), Five-Element score bars, interactions (刑冲合会), the Luck Pillar (大运) timeline, and auxiliary palaces (命宫/身宫/胎元/胎息) when the source provides them.
+
+## Props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `data` | `unknown` | — | Raw chart data. Auto-detected and normalized. |
+| `chart` | `NormalizedChart` | — | Pre-normalized chart; takes precedence over `data`. |
+| `lang` | `'zh' \| 'en' \| 'both'` | `'both'` | Render language. `'both'` shows `中文 · English`. |
+| `theme` | `'light' \| 'dark'` | `'light'` | Colour theme. |
+| `showDaYun` | `boolean` | `true` | Show the Luck Pillar timeline. |
+| `showInteractions` | `boolean` | `true` | Show the interactions panel. |
+| `showFiveElements` | `boolean` | `true` | Show element score bars (when the source emits them). |
+| `showShenSha` | `boolean` | `true` | Show per-pillar Shen Sha (when the source emits them). |
+| `style` | `CSSProperties` | — | Merged onto the root container. |
+
+## Adapters
+
+Use them directly when you want the normalized data without the component (e.g. for a custom UI, a table export, or an API response):
+
+```ts
+import { normalize, detectEngine, fromBaziObject, fromPillarMap } from 'bazi-chart';
+
+detectEngine(engineOutput);   // 'baziObject' | 'pillarMap' | 'normalized' | 'unknown'
+
+const chart = normalize(engineOutput);   // dispatches to the right adapter
+// chart.pillars, chart.dayMaster, chart.daYun, chart.interactions, ...
+
+// Or call an adapter explicitly:
+const a = fromBaziObject(baziObjectOutput);   // top-level 八字 object
+const b = fromPillarMap(pillarMapOutput);     // pillars keyed by year/month/day/hour
+```
+
+`normalize()` throws a clear error for unrecognized input.
+
+### The `NormalizedChart` model
+
+One engine-agnostic shape (`meta`, `solarTime`, `dayMaster`, `pillars`, `fiveElements`, `daYun`, `interactions`, `extras`). Adapters only **reshape** raw output and keep original Chinese values; everything derivable (element, polarity, colour, translations) is resolved at render time via `bazi-terms`. Sections a source does not emit (e.g. element scores or palaces) are simply `undefined`.
+
+## Styling
+
+Inline styles only — no CSS import, no build step, safe for SSR and any meta-framework (Next.js, Remix, Astro). Element colours follow the traditional Five-Element palette (wood=green, fire=red, earth=brown, metal=gold, water=blue), tuned for contrast in both themes. Override the surface with the `style` prop or wrap the component in your own container.
+
+## License
+
+[MIT](./LICENSE) © 2026 [AskingMing](https://askingming.com).