@eaprelsky/nocturna-wheel 3.1.0 → 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/assets/css/nocturna-wheel.css

@@ -147,6 +147,10 @@
     pointer-events: none;
 }
 
+.projection-dot {
+    stroke-width: 0.5 !important;
+}
+
 /* Aspect elements */
 .aspect-line {
     transition: opacity 0.2s ease;
@@ -194,7 +198,7 @@
 }
 
 .nocturna-wheel-checkbox {
-    margin-right: 5px;
+    margin-right: 5px; /* Reverted to original value */
 }
 
 .nocturna-wheel-slider {
@@ -202,6 +206,17 @@
     margin: 10px 0;
 }
 
+/* Bootstrap overrides for control alignment and spacing */
+.form-check,
+.form-switch {
+    display: flex;
+    align-items: center;
+}
+
+.form-check-label {
+    margin-left: 10px; /* Add spacing between control and label */
+}
+
 /* Tooltips */
 .nocturna-wheel-tooltip {
     position: absolute;

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-16T11:36:03.070Z
+     * 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
@@ -2840,7 +2847,8 @@
             const adjustedPositions = [...positions];
             
             // The minimum angular distance needed to prevent overlap at base radius
-            const minAngularDistance = (minDistance / baseRadius) * (180 / Math.PI);
+            // Add safety factor to ensure visual separation
+            const minAngularDistance = (minDistance / baseRadius) * (180 / Math.PI) * 1.3; // 30% extra spacing
             console.log(`PlanetPositionCalculator: Minimum angular distance: ${minAngularDistance.toFixed(2)}°`);
             
             // Sort positions by longitude for overlap detection
@@ -2990,10 +2998,16 @@
         static _distributeClusterByAngle(positions, radius, minAngularDistance, centerX, centerY, iconSize) {
             const n = positions.length;
             
+            // If only one planet, keep its original position
+            if (n === 1) {
+                this._setExactPosition(positions[0], positions[0].longitude, radius, centerX, centerY, iconSize);
+                return;
+            }
+            
             // Sort positions by their original longitude to maintain order
             positions.sort((a, b) => a.longitude - b.longitude);
             
-            // Calculate central angle and total span needed
+            // Calculate central angle and total span
             const firstPos = positions[0].longitude;
             const lastPos = positions[n-1].longitude;
             let totalArc = lastPos - firstPos;
@@ -3003,26 +3017,25 @@
                 totalArc = (360 + lastPos - firstPos) % 360;
             }
             
-            // Calculate the center of the cluster
-            let centerAngle = (firstPos + totalArc/2) % 360;
+            // Calculate the center of the cluster (weighted average of all positions)
+            let sumAngles = 0;
+            for (let i = 0; i < n; i++) {
+                sumAngles += positions[i].longitude;
+            }
+            let centerAngle = (sumAngles / n) % 360;
             
             // Determine minimum arc needed for n planets with minimum spacing
-            const minRequiredArc = (n - 1) * minAngularDistance;
+            // Add extra spacing factor to ensure planets don't overlap
+            const minRequiredArc = (n - 1) * minAngularDistance * 1.2; // 20% extra spacing
             
-            // Calculate total span to use (either natural spacing or minimum required)
-            const spanToUse = Math.max(totalArc, minRequiredArc);
+            // Always use at least the minimum required arc
+            const spanToUse = Math.max(minRequiredArc, totalArc);
             
             // Calculate start angle (center - half of span)
             const startAngle = (centerAngle - spanToUse/2 + 360) % 360;
             
             // Distribute planets evenly from the start angle
             for (let i = 0; i < n; i++) {
-                // If only one planet, keep its original position
-                if (n === 1) {
-                    this._setExactPosition(positions[i], positions[i].longitude, radius, centerX, centerY, iconSize);
-                    continue;
-                }
-                
                 const angle = (startAngle + i * (spanToUse / (n-1))) % 360;
                 this._setExactPosition(positions[i], angle, radius, centerX, centerY, iconSize);
             }
@@ -3994,7 +4007,7 @@
                     class: `projection-dot projection-${planet.name}`,
                     fill: 'none',
                     stroke: planet.color || '#666666',
-                    'stroke-width': '1.5'
+                    'stroke-width': '1'
                 });
                 
                 // Add tooltip
@@ -4910,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);