@guinetik/gcanvas 1.0.0

package/demos/js/penrose/artifact.js

@@ -0,0 +1,69 @@
+/**
+ * Penrose Artifact
+ *
+ * A mysterious alien artifact that allows survival inside a black hole.
+ * Only appears after using a wormhole at least once.
+ * Rendered as a rotating cube.
+ */
+
+import { Cube } from "../../../src/shapes/cube.js";
+import { CONFIG } from "./constants.js";
+
+export class PenroseArtifact {
+  constructor(u, v) {
+    this.u = u;
+    this.v = v;
+
+    // Artifact size
+    this.radius = CONFIG.artifactRadius;
+
+    // Animation
+    this.rotationPhase = 0;
+    this.pulsePhase = Math.random() * Math.PI * 2;
+    this.hoverOffset = 0;
+
+    // State
+    this.collected = false;
+    this.spawnTime = 0;
+
+    // Create the cube shape (will be positioned during draw)
+    this.cube = new Cube(CONFIG.artifactCubeSize, {
+      faceTopColor: "#a0f",
+      faceBottomColor: "#60a",
+      faceLeftColor: "#80c",
+      faceRightColor: "#70b",
+      faceFrontColor: "#90d",
+      faceBackColor: "#50a",
+      strokeColor: "#f0f",
+      lineWidth: 2,
+    });
+  }
+
+  update(dt) {
+    this.rotationPhase += dt * 2;
+    this.pulsePhase += dt * 4;
+    this.hoverOffset = Math.sin(this.pulsePhase) * 5;
+    this.spawnTime += dt;
+
+    // Rotate the cube
+    this.cube.setRotation(
+      this.rotationPhase * 0.7,
+      this.rotationPhase,
+      this.rotationPhase * 0.5
+    );
+  }
+
+  /**
+   * Get circle bounds for collision detection
+   */
+  getCircle() {
+    return { x: this.u, y: this.v, radius: this.radius };
+  }
+
+  /**
+   * Check if artifact is active (not collected)
+   */
+  get active() {
+    return !this.collected;
+  }
+}

package/demos/js/penrose/blackhole.js

@@ -0,0 +1,121 @@
+import { CONFIG } from "./constants.js";
+// ============================================================================
+// PENROSE BLACK HOLE
+// ============================================================================
+
+export class PenroseBlackHole {
+  constructor(u, v, mass) {
+    this.u = u;
+    this.v = v;
+    this.mass = mass;
+
+    // Event horizon radius in Penrose space (death zone)
+    this.horizonRadius = CONFIG.blackHoleBaseSize + mass * 0.1;
+
+    // Ergosphere radius - larger than horizon, where Kerr energy can be harvested
+    // In real physics, ergosphere extends ~1.5-2x beyond horizon for rotating black holes
+    this.ergosphereRadius = this.horizonRadius * 1.8;
+
+    // Has the player passed this one?
+    this.passed = false;
+
+    // Visual pulse
+    this.pulsePhase = Math.random() * Math.PI * 2;
+
+    // Kerr energy harvesting
+    this.harvestProgress = 0; // 0 to kerrHarvestTime
+    this.harvested = false; // Already collected?
+    this.isBeingHarvested = false; // Light cone touching right now?
+  }
+
+  update(dt) {
+    this.pulsePhase += dt * 2;
+
+    // Decay harvest progress if not being harvested
+    if (!this.isBeingHarvested && this.harvestProgress > 0) {
+      this.harvestProgress = Math.max(0, this.harvestProgress - dt * 0.5);
+    }
+    this.isBeingHarvested = false; // Reset each frame
+  }
+
+  /**
+   * Get circle bounds for collision detection (event horizon)
+   */
+  getCircle() {
+    return { x: this.u, y: this.v, radius: this.horizonRadius };
+  }
+
+  /**
+   * Get ergosphere circle bounds
+   */
+  getErgosphereCircle() {
+    return { x: this.u, y: this.v, radius: this.ergosphereRadius };
+  }
+
+  // Check if light cone touches the ergosphere (for Kerr harvesting)
+  checkLightConeContact(shipU, shipV, coneLength) {
+    // Light cone extends from ship at 45° angles
+    // Check if ergosphere is within the cone and ahead of ship
+    const du = this.u - shipU;
+    const dv = this.v - shipV;
+
+    // Must be ahead (in future)
+    if (dv <= 0) return false;
+
+    // Must be within cone length
+    if (dv > coneLength) return false;
+
+    // Light cone edges at this dv: u ranges from shipU - dv to shipU + dv
+    // Check if ergosphere intersects this range
+    const coneLeft = shipU - dv;
+    const coneRight = shipU + dv;
+
+    // Ergosphere touches cone if its area overlaps (larger than horizon!)
+    const ergoLeft = this.u - this.ergosphereRadius;
+    const ergoRight = this.u + this.ergosphereRadius;
+
+    return ergoRight >= coneLeft && ergoLeft <= coneRight;
+  }
+
+  // Calculate frame dragging effect on ship
+  // Returns the velocity change to apply (du per dt)
+  getFrameDragForce(shipU, shipV) {
+    const du = shipU - this.u;
+    const dv = shipV - this.v;
+    const dist = Math.sqrt(du * du + dv * dv);
+
+    // No effect outside ergosphere
+    if (dist > this.ergosphereRadius) return 0;
+
+    // No effect if already dead (inside horizon)
+    if (dist < this.horizonRadius) return 0;
+
+    // Frame drag strength increases as you get closer to horizon
+    // Normalize distance: 0 at horizon, 1 at ergosphere edge
+    const normalizedDist =
+      (dist - this.horizonRadius) /
+      (this.ergosphereRadius - this.horizonRadius);
+
+    // Drag force falls off with distance (stronger near horizon)
+    const dragMagnitude =
+      Math.pow(1 - normalizedDist, CONFIG.frameDragFalloff) *
+      CONFIG.frameDragStrength;
+
+    // Direction: perpendicular to radial direction (orbital motion)
+    // In 2D Penrose space, we'll make it pull tangentially
+    // Black holes rotate counter-clockwise, so drag is perpendicular to (du, dv)
+    // Perpendicular in 2D: (-dv, du) or (dv, -du)
+    // We want to pull into orbit, so use the direction that's tangent
+
+    // Calculate tangent direction (perpendicular to radial)
+    // Normalize the radial direction first
+    const radialU = du / dist;
+    const radialV = dv / dist;
+
+    // Tangent is perpendicular - rotate 90 degrees (counter-clockwise orbit)
+    const tangentU = -radialV;
+
+    // Return the velocity change in u direction (we're mainly affecting horizontal motion)
+    return tangentU * dragMagnitude;
+  }
+}

package/demos/js/penrose/constants.js

@@ -0,0 +1,73 @@
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+
+export const CONFIG = {
+  // Ship physics
+  shipTimeSpeed: 0.02, // Base rate of time progression (slower for longer games)
+  shipAcceleration: 1.003, // How much faster time gets (slower ramp)
+  shipMaxVelocity: 1.2, // Max spatial velocity (higher = more lateral movement)
+  shipSteering: 4.0, // Steering responsiveness (much higher for real navigation)
+  shipDrag: 0.96, // Velocity damping (less drag = more responsive)
+  shipStartV: -0.99, // Starting position in time (at i- past infinity corner)
+
+  // Black holes
+  blackHoleSpawnRate: 3.5, // Seconds between spawns (slower!)
+  blackHoleMinSpawnRate: 1.5, // Fastest spawn rate (not too crazy)
+  blackHoleBaseSize: 0.05, // Base horizon radius (smaller)
+  blackHoleMaxSize: 0.1, // Max horizon radius
+  blackHoleSpawnAhead: 0.25, // How far ahead (in v) to spawn
+  blackHoleMinGap: 0.22, // Minimum gap between black holes (so player can pass)
+
+  // Camera
+  cameraLag: 0.1, // Camera smoothing
+  cameraLookAhead: 0.08, // Look ahead of ship
+  baseViewScale: 0.35, // Base zoom level (smaller = more zoomed in!)
+
+  // Visual
+  worldlineMaxLength: 350, // Trail length
+  gridSpacing: 0.1, // Null geodesic grid spacing
+  coneLength: 0.08, // Light cone visual length
+  starCount: 200, // More stars!
+
+  // Death
+  deathAttractionSpeed: 0.3, // How fast ship is pulled to singularity
+  deathFadeDuration: 2.0, // How long the fade out takes
+
+  // Difficulty
+  difficultyRampTime: 120, // Seconds to reach max difficulty (longer game)
+
+  // Kerr Energy mechanic
+  kerrHarvestTime: 3.0, // Seconds to harvest Kerr energy from a black hole
+  kerrScoreMultiplier: 2, // Each Kerr harvest doubles score
+
+  // Frame dragging (ergosphere physics)
+  frameDragStrength: 0.8, // How strongly ergosphere pulls you into orbit
+  frameDragFalloff: 2.0, // How quickly drag falls off with distance
+
+  // Boost mechanic (uses Kerr energy)
+  boostSteeringMultiplier: 3.0, // How much stronger steering is when boosting
+  boostSpeedMultiplier: 2.5, // How much faster time moves when boosting
+  boostDrainRate: 35, // Kerr energy drained per second while boosting
+  kerrEnergyPerHarvest: 100, // Energy gained per Kerr harvest
+
+  // Wormhole (rare teleporter back to start)
+  wormholeSpawnChance: 0.25, // 25% chance per spawn cycle
+  wormholeSpawnInterval: 12.0, // Check for spawn every 12 seconds
+  wormholeRadius: 0.08, // Collision radius (bigger for easier hit)
+  wormholeMinTime: 10, // Don't spawn before 10 seconds
+
+  // Alien Artifact (survive singularity!)
+  artifactSpawnChance: 0.3, // 30% chance per spawn cycle
+  artifactSpawnInterval: 15.0, // Check for spawn every 15 seconds
+  artifactRadius: 0.07, // Collision radius
+  artifactCubeSize: 20, // Size of the cube visual
+
+  // Inside Black Hole (void dimension)
+  voidShipSpeed: 400, // Much faster ship in the void
+  voidShipSteering: 6, // Steering in void
+  voidParticleRadius: 12, // Size of collectible particles
+  voidParticlesToCollect: 10, // Particles needed to escape
+  voidParticleSpawnRate: 0.8, // Seconds between particle spawns
+  voidDuration: 20, // Max time in void before forced exit
+};