caelus-wheel 0.1.1 → 0.2.1

package/README.md

@@ -3,11 +3,15 @@
 React SVG chart wheel for [caelus](https://github.com/heavyblotto/caelus).
 SSR-safe, zero runtime dependencies (react is a peer), ~3.4 KB gzipped.
 
+```bash
+npm install caelus-wheel
+```
+
 ```tsx
 import { ChartWheel } from "caelus-wheel";
 
 <ChartWheel
-  chart={chart}            // the Chart object from caelus, as-is
+  chart={chart}            // caelus Chart object or caelus-mcp chart payload, as-is
   size={520}               // px, square
   showAspects={true}
   aspectTypes={["conjunction", "sextile", "square", "trine", "opposition"]}
@@ -15,6 +19,11 @@ import { ChartWheel } from "caelus-wheel";
 />
 ```
 
+`chart` accepts either the `Chart` object from the caelus engine or a
+`natal_chart` / `current_sky` response from caelus-mcp — the MCP payload's
+`rx` retrograde flag is understood and `signDeg` is derived from `lon`
+when absent. An MCP client can pipe a tool response straight in.
+
 ## What it draws
 
 - **Zodiac ring** — sign glyphs, sign boundaries, 1°/5°/10° tick marks.
@@ -40,3 +49,10 @@ counterclockwise.
 - Pure render: no hooks, no client-only APIs — works in server components,
   static export, and `renderToStaticMarkup` (the test suite renders real
   engine charts exactly that way).
+
+## The caelus packages
+
+- [caelus](https://www.npmjs.com/package/caelus) — the engine
+- [caelus-birth](https://www.npmjs.com/package/caelus-birth) — local birth time + place → UT
+- caelus-wheel — this package
+- [caelus-mcp](https://www.npmjs.com/package/caelus-mcp) — MCP server, six chart tools over stdio

package/dist/src/index.d.ts

@@ -12,8 +12,9 @@
 import type { ReactElement } from "react";
 export interface WheelPosition {
     lon: number;
-    retrograde: boolean;
-    signDeg: number;
+    retrograde?: boolean;
+    rx?: boolean;
+    signDeg?: number;
 }
 export interface WheelAspect {
     a: string;
@@ -44,7 +45,8 @@ export interface WheelTheme {
 export declare const DARK_THEME: WheelTheme;
 export declare const GLYPHS: Record<string, string>;
 export interface ChartWheelProps {
-    /** The Chart object from caelus, as-is. */
+    /** The Chart object from caelus, or a caelus-mcp natal_chart /
+     *  current_sky tool response, as-is. */
     chart: WheelChart;
     /** Square size in px. */
     size?: number;

package/dist/src/index.js

@@ -179,9 +179,11 @@ export function ChartWheel({ chart, size = 520, showAspects = true, aspectTypes
             el.push(_jsx("line", { x1: fix(x1), y1: fix(y1), x2: fix(x2), y2: fix(y2), stroke: T.labelText, strokeWidth: 0.5, opacity: 0.5 }, `conn-${b}`));
         }
         el.push(text(disp, 0.655, G[b] ?? b.slice(0, 2).toUpperCase(), size * 0.05, T.planetText, `pg-${b}`));
-        const deg = Math.floor(p.signDeg);
-        const min = String(Math.floor(mod(p.signDeg, 1) * 60)).padStart(2, "0");
-        el.push(text(disp, 0.585, `${deg}°${min}'${p.retrograde ? "℞" : ""}`, size * 0.024, T.labelText, `pl-${b}`));
+        const signDeg = p.signDeg ?? mod(p.lon, 30);
+        const retro = p.retrograde ?? p.rx ?? false;
+        const deg = Math.floor(signDeg);
+        const min = String(Math.floor(mod(signDeg, 1) * 60)).padStart(2, "0");
+        el.push(text(disp, 0.585, `${deg}°${min}'${retro ? "℞" : ""}`, size * 0.024, T.labelText, `pl-${b}`));
     });
     return (_jsx("svg", { width: size, height: size, viewBox: `0 0 ${size} ${size}`, role: "img", "aria-label": "astrological chart wheel", style: { background: T.background }, children: el }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caelus-wheel",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "React SVG chart wheel for caelus: zodiac, houses, planets with collision avoidance, aspect lines. SSR-safe, zero runtime dependencies.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -45,4 +45,4 @@
     "svg",
     "natal-chart"
   ]
-}
+}