@eaprelsky/nocturna-wheel 3.1.1 → 4.0.1

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-27T18:13:39.810Z
      * 
      * 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
@@ -2331,17 +2338,37 @@
                 ascendantAlignmentOffset = (360 - ascendantLon) % 360;
             }
             
-            // Add Roman numerals for house numbers
+            // Create array of houses with their rotated angles and original indices
+            const housesWithAngles = [];
             for (let i = 0; i < 12; i++) {
-                // Get house angle with rotation
-                let baseHouseAngle;
+                let baseAngle;
                 if (this.houseData && this.houseData.length >= 12) {
-                    baseHouseAngle = this.getHouseLongitude(this.houseData[i]);
+                    baseAngle = this.getHouseLongitude(this.houseData[i]);
                 } else {
-                    baseHouseAngle = i * 30; // Default if no data
+                    baseAngle = i * 30; // Default if no data
                 }
-                 // Apply alignment offset and user rotation
-                const houseAngle = (baseHouseAngle + ascendantAlignmentOffset + rotationAngle) % 360;
+                const rotatedAngle = (baseAngle + ascendantAlignmentOffset + rotationAngle) % 360;
+                
+                housesWithAngles.push({
+                    originalIndex: i,
+                    baseAngle: baseAngle,
+                    rotatedAngle: rotatedAngle
+                });
+            }
+            
+            // Sort by rotated angle to determine visual order
+            housesWithAngles.sort((a, b) => a.rotatedAngle - b.rotatedAngle);
+            
+            // Find which house is Ascendant (originally index 0) after rotation
+            const ascendantVisualIndex = housesWithAngles.findIndex(h => h.originalIndex === 0);
+            
+            // Render houses with correct numbering based on visual position
+            housesWithAngles.forEach((house, visualIndex) => {
+                const houseAngle = house.rotatedAngle;
+                
+                // Calculate house number based on position relative to Ascendant
+                // Counter-clockwise from Ascendant
+                const houseNumber = ((visualIndex - ascendantVisualIndex + 12) % 12) + 1;
                 
                 // Offset text from house line clockwise
                 const angle = (houseAngle + 15) % 360; // Place in middle of house segment, apply modulo
@@ -2377,15 +2404,15 @@
                     text.setAttribute("dominant-baseline", "middle");
                 }
                 
-                // Set house number as text (Roman numeral)
-                text.textContent = AstrologyUtils.houseToRoman(i + 1);
+                // Set house number as text (Roman numeral) - now based on visual position
+                text.textContent = AstrologyUtils.houseToRoman(houseNumber);
                 
                 // Add tooltip with house information
-                this.svgUtils.addTooltip(text, `House ${i + 1}`);
+                this.svgUtils.addTooltip(text, `House ${houseNumber}`);
                 
                 parentGroup.appendChild(text);
                 elements.push(text);
-            }
+            });
             
             return elements;
         }
@@ -4916,6 +4943,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);