@eaprelsky/nocturna-wheel 3.1.1 → 4.0.0

package/README.md

@@ -8,6 +8,7 @@ A JavaScript library for rendering astrological natal charts.
 - **Dual chart support** - independent inner and outer circles for synastry and transit charts
 - **Zodiac sign display** with customizable styling
 - **House system rendering** with multiple system options (Placidus, Koch, Equal, etc.)
+- **Automatic wheel rotation** - chart automatically positions Ascendant at 9 o'clock when house data is provided
 - **Planet placement** with customizable icons and colors on two independent circles
 - **Three types of aspects:**
   - Primary aspects (outer circle to outer circle)
@@ -169,10 +170,49 @@ const chart = new NocturnaWheel.WheelChart({
 - `togglePrimaryAspects(visible)`: Toggles visibility of primary aspects (outer circle)
 - `toggleSecondaryAspects(visible)`: Toggles visibility of secondary aspects (inner circle)
 - `toggleSynastryAspects(visible)`: Toggles visibility of synastry aspects (cross-circle)
-- `setHouseRotation(angle)`: Sets house system rotation
+- `setHouseRotation(angle)`: Sets house system rotation (optional - automatic rotation is enabled by default)
 - `setHouseSystem(name)`: Changes the house system
 - `destroy()`: Removes the chart and cleans up resources
 
+### Automatic Wheel Rotation
+
+The library **automatically rotates** the zodiac wheel to position the Ascendant (1st house cusp) at the 9 o'clock position when house data is provided. This happens in two ways:
+
+1. **When providing a `houses` array**: The first house cusp longitude (`houses[0].lon`) is used for rotation
+2. **When using `astronomicalData.ascendant`**: The ascendant value is used for rotation
+
+```javascript
+// Auto-rotation with houses array
+const chart = new WheelChart({
+  container: '#chart',
+  houses: [
+    { lon: 300.32 },  // Ascendant - automatically used for rotation
+    // ... other houses
+  ]
+});
+
+// Auto-rotation with astronomicalData
+const chart = new WheelChart({
+  container: '#chart',
+  config: {
+    astronomicalData: {
+      ascendant: 120.5,  // Automatically used for rotation
+      mc: 210.5,
+      latitude: 55.75,
+      houseSystem: "Placidus"
+    }
+  }
+});
+```
+
+**Manual override**: You can still override the automatic rotation by calling `setHouseRotation()` after initialization:
+
+```javascript
+chart.setHouseRotation(90);  // Custom rotation angle
+```
+
+For more details, see [Auto-Rotation Documentation](docs/AUTO_ROTATION.md).
+
 ## Advanced Configuration
 
 ### ChartConfig Options

package/dist/nocturna-wheel.bundle.js

@@ -293,7 +293,7 @@
     /**
      * IconData.js
      * Auto-generated module containing inline SVG icons as data URLs
-     * Generated at: 2025-11-21T17:08:56.476Z
+     * Generated at: 2025-11-23T10:05:26.626Z
      * 
      * This file is automatically generated by the build process.
      * Do not edit manually - changes will be overwritten.
@@ -1131,6 +1131,13 @@
                             mc: this.astronomicalData.mc
                         }
                     );
+                    
+                    // Auto-rotate the wheel to position the Ascendant at 9 o'clock
+                    // Only set if not already explicitly configured
+                    if (this.houseCusps.length > 0 && this.houseSettings.rotationAngle === 0) {
+                        console.log(`ChartConfig: Auto-rotating wheel to Ascendant at ${this.astronomicalData.ascendant}°`);
+                        this.houseSettings.rotationAngle = this.astronomicalData.ascendant;
+                    }
                 } catch (error) {
                     console.error("Failed to calculate house cusps:", error?.message || error);
                     // Set empty cusps array if calculation fails
@@ -4916,6 +4923,13 @@
             
             this.houses = options.houses || [];
             
+            // Auto-rotate the wheel if houses are provided
+            // This ensures the Ascendant (1st house cusp) is positioned at 9 o'clock
+            if (this.houses.length > 0 && this.houses[0] && typeof this.houses[0].lon === 'number') {
+                console.log(`NocturnaWheel: Auto-rotating wheel to Ascendant at ${this.houses[0].lon}°`);
+                this.config.houseSettings.rotationAngle = this.houses[0].lon;
+            }
+            
             // Override aspect settings if provided (legacy support)
             if (options.aspectSettings) {
                 this.config.updateAspectSettings(options.aspectSettings);