@tonybfox/threejs-tools 1.0.0

package/dist/sunlight/index.cjs

@@ -0,0 +1,441 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/sunlight/src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  SunLightTool: () => SunLightTool
+});
+module.exports = __toCommonJS(src_exports);
+
+// packages/sunlight/src/SunLightTool.ts
+var THREE = __toESM(require("three"));
+var DAY_MS = 24 * 60 * 60 * 1e3;
+var DEG2RAD = Math.PI / 180;
+var RAD2DEG = 180 / Math.PI;
+var J1970 = 2440588;
+var J2000 = 2451545;
+var clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+var normalizeLongitude = (value) => {
+  const normalized = ((value + 180) % 360 + 360) % 360 - 180;
+  return normalized;
+};
+var isLeapYear = (year) => year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+var limitDayOfYear = (day, year) => {
+  const maxDay = isLeapYear(year) ? 366 : 365;
+  return clamp(Math.floor(day), 1, maxDay);
+};
+var normalizeHours = (hours) => {
+  const normalized = hours % 24;
+  return normalized < 0 ? normalized + 24 : normalized;
+};
+var TWILIGHT_SUN_COLOR = new THREE.Color(16747612);
+var TWILIGHT_AMBIENT_COLOR = new THREE.Color(16757898);
+var TWILIGHT_SKY_COLOR = new THREE.Color(16750950);
+var TWILIGHT_GROUND_COLOR = new THREE.Color(3549732);
+var toJulian = (date) => date.valueOf() / DAY_MS - 0.5 + J1970;
+var toDays = (date) => toJulian(date) - J2000;
+var solarMeanAnomaly = (days) => DEG2RAD * (357.5291 + 0.98560028 * days);
+var eclipticLongitude = (meanAnomaly) => {
+  const c = DEG2RAD * (1.9148 * Math.sin(meanAnomaly) + 0.02 * Math.sin(2 * meanAnomaly) + 3e-4 * Math.sin(3 * meanAnomaly));
+  const p = DEG2RAD * 102.9372;
+  return meanAnomaly + c + p + Math.PI;
+};
+var declination = (longitude) => {
+  const e = DEG2RAD * 23.4397;
+  return Math.asin(Math.sin(e) * Math.sin(longitude));
+};
+var rightAscension = (longitude) => {
+  const e = DEG2RAD * 23.4397;
+  return Math.atan2(Math.sin(longitude) * Math.cos(e), Math.cos(longitude));
+};
+var siderealTime = (days, longitudeWest) => DEG2RAD * (280.16 + 360.9856235 * days) - longitudeWest;
+var solarAzimuth = (hourAngle, latitudeRad, declinationRad) => Math.atan2(
+  Math.sin(hourAngle),
+  Math.cos(hourAngle) * Math.sin(latitudeRad) - Math.tan(declinationRad) * Math.cos(latitudeRad)
+);
+var solarAltitude = (hourAngle, latitudeRad, declinationRad) => Math.asin(
+  Math.sin(latitudeRad) * Math.sin(declinationRad) + Math.cos(latitudeRad) * Math.cos(declinationRad) * Math.cos(hourAngle)
+);
+var computeDayOfYear = (date) => {
+  const startOfYear = Date.UTC(date.getUTCFullYear(), 0, 0);
+  const diff = date.getTime() - startOfYear;
+  return Math.floor(diff / (24 * 60 * 60 * 1e3));
+};
+var buildWeatherPreset = (weather, solarAltitude2) => {
+  const altitudeFactor = clamp(Math.sin(solarAltitude2) + 0.1, 0, 1);
+  switch (weather) {
+    case "sunny":
+      return {
+        sunIntensity: 1.5 * altitudeFactor,
+        sunColor: new THREE.Color(16773839),
+        ambientIntensity: 0.35 + 0.45 * altitudeFactor,
+        ambientColor: new THREE.Color(16115663),
+        hemisphereIntensity: 0.4 + 0.4 * altitudeFactor,
+        hemisphereSkyColor: new THREE.Color(12114175),
+        hemisphereGroundColor: new THREE.Color(16044458),
+        shadowBias: -5e-4
+      };
+    case "partly-cloudy":
+      return {
+        sunIntensity: 1.1 * altitudeFactor,
+        sunColor: new THREE.Color(16774885),
+        ambientIntensity: 0.45 + 0.35 * altitudeFactor,
+        ambientColor: new THREE.Color(15265009),
+        hemisphereIntensity: 0.5 + 0.3 * altitudeFactor,
+        hemisphereSkyColor: new THREE.Color(13162475),
+        hemisphereGroundColor: new THREE.Color(15129026),
+        shadowBias: -3e-4
+      };
+    case "overcast":
+      return {
+        sunIntensity: 0.35 * altitudeFactor,
+        sunColor: new THREE.Color(15791359),
+        ambientIntensity: 0.75,
+        ambientColor: new THREE.Color(14278117),
+        hemisphereIntensity: 0.8,
+        hemisphereSkyColor: new THREE.Color(13489631),
+        hemisphereGroundColor: new THREE.Color(13158600),
+        shadowBias: -1e-4
+      };
+    default:
+      return {
+        sunIntensity: 1 * altitudeFactor,
+        sunColor: new THREE.Color(16767411),
+        ambientIntensity: 0.35 + 0.25 * altitudeFactor,
+        ambientColor: new THREE.Color(16769988),
+        hemisphereIntensity: 0.4 + 0.3 * altitudeFactor,
+        hemisphereSkyColor: new THREE.Color(16763043),
+        hemisphereGroundColor: new THREE.Color(6243898),
+        shadowBias: -2e-4
+      };
+  }
+};
+var SunLightTool = class extends THREE.EventDispatcher {
+  constructor(scene, options = {}) {
+    super();
+    this.createdLight = false;
+    this.createdHemisphere = false;
+    this.scene = scene;
+    const defaultLatitude = options.latitude ?? 51.5072;
+    const defaultLongitude = options.longitude ?? -0.1276;
+    this.latitude = clamp(defaultLatitude, -90, 90);
+    this.longitude = normalizeLongitude(defaultLongitude);
+    this.referenceYear = options.referenceYear ?? (/* @__PURE__ */ new Date()).getUTCFullYear();
+    this.dayOfYear = limitDayOfYear(
+      options.dayOfYear ?? 172,
+      this.referenceYear
+    );
+    this.timeOfDay = normalizeHours(options.timeOfDay ?? 12);
+    this.timeZoneOffsetMinutes = options.timeZoneOffsetMinutes ?? 0;
+    this.weather = options.weather ?? "sunny";
+    this.useSystemTime = options.useSystemTime ?? false;
+    this.lightDistance = options.lightDistance ?? 150;
+    this.shadowCameraSize = options.shadowCameraSize ?? 100;
+    this.shadowCameraFar = options.shadowCameraFar ?? 600;
+    const existingDirectional = options.light;
+    this.light = existingDirectional ?? new THREE.DirectionalLight(16777215, 1);
+    this.createdLight = !existingDirectional;
+    if (!this.light.parent) {
+      this.scene.add(this.light);
+    }
+    if (!this.light.target.parent) {
+      this.scene.add(this.light.target);
+    }
+    this.configureShadowMap(this.light);
+    if (options.ambientLight) {
+      this.ambientLight = options.ambientLight;
+    }
+    if (options.enableHemisphereLight ?? true) {
+      this.hemisphereLight = new THREE.HemisphereLight(
+        options.hemisphereSkyColor ?? 12244223,
+        options.hemisphereGroundColor ?? 7628634,
+        options.hemisphereIntensity ?? 0.45
+      );
+      this.scene.add(this.hemisphereLight);
+      this.createdHemisphere = true;
+    }
+    if (options.showHelper) {
+      this.helper = new THREE.DirectionalLightHelper(
+        this.light,
+        options.helperSize ?? 25,
+        options.helperColor ?? 16765567
+      );
+      this.scene.add(this.helper);
+    }
+    this.state = {
+      date: /* @__PURE__ */ new Date(),
+      latitude: this.latitude,
+      longitude: this.longitude,
+      solarAzimuth: 0,
+      solarAltitude: 0,
+      weather: this.weather,
+      useSystemTime: this.useSystemTime
+    };
+    this.update();
+  }
+  getLight() {
+    return this.light;
+  }
+  getHemisphereLight() {
+    return this.hemisphereLight;
+  }
+  getState() {
+    return { ...this.state, date: new Date(this.state.date.getTime()) };
+  }
+  getDayOfYear() {
+    return this.dayOfYear;
+  }
+  getTimeOfDay() {
+    return this.timeOfDay;
+  }
+  getTimeZoneOffset() {
+    return this.timeZoneOffsetMinutes;
+  }
+  getWeather() {
+    return this.weather;
+  }
+  usesSystemTime() {
+    return this.useSystemTime;
+  }
+  setLatitude(latitude) {
+    const clamped = clamp(latitude, -90, 90);
+    if (clamped === this.latitude) return;
+    this.latitude = clamped;
+    this.update();
+  }
+  setLongitude(longitude) {
+    const normalized = normalizeLongitude(longitude);
+    if (normalized === this.longitude) return;
+    this.longitude = normalized;
+    this.update();
+  }
+  setLocation(latitude, longitude) {
+    let changed = false;
+    const lat = clamp(latitude, -90, 90);
+    if (lat !== this.latitude) {
+      this.latitude = lat;
+      changed = true;
+    }
+    const lon = normalizeLongitude(longitude);
+    if (lon !== this.longitude) {
+      this.longitude = lon;
+      changed = true;
+    }
+    if (changed) {
+      this.update();
+    }
+  }
+  setDayOfYear(day) {
+    const limited = limitDayOfYear(day, this.referenceYear);
+    if (limited === this.dayOfYear) return;
+    this.dayOfYear = limited;
+    this.update();
+  }
+  setTimeOfDay(hours) {
+    const normalized = normalizeHours(hours);
+    if (normalized === this.timeOfDay) return;
+    this.timeOfDay = normalized;
+    this.update();
+  }
+  setTimeZoneOffset(minutes) {
+    if (minutes === this.timeZoneOffsetMinutes) return;
+    this.timeZoneOffsetMinutes = minutes;
+    this.update();
+  }
+  setWeather(weather) {
+    if (weather === this.weather) return;
+    this.weather = weather;
+    this.dispatchEvent({ type: "weatherChanged", weather });
+    this.update();
+  }
+  setUseSystemTime(enabled) {
+    if (enabled === this.useSystemTime) return;
+    this.useSystemTime = enabled;
+    this.dispatchEvent({
+      type: "systemTimeToggled",
+      useSystemTime: this.useSystemTime
+    });
+    this.update();
+  }
+  update(dateOverride) {
+    const date = this.computeDate(dateOverride);
+    const position = this.computeSunPosition(date);
+    this.applySunPosition(position, date);
+    this.state = {
+      date,
+      latitude: this.latitude,
+      longitude: this.longitude,
+      solarAzimuth: position.azimuth,
+      solarAltitude: position.altitude,
+      weather: this.weather,
+      useSystemTime: this.useSystemTime
+    };
+    this.applyWeather(position.altitude);
+    this.dispatchEvent({ type: "stateChanged", state: this.getState() });
+  }
+  dispose() {
+    if (this.helper) {
+      this.scene.remove(this.helper);
+      this.helper.dispose();
+      this.helper = void 0;
+    }
+    if (this.createdHemisphere && this.hemisphereLight) {
+      this.scene.remove(this.hemisphereLight);
+      this.hemisphereLight.dispose();
+      this.hemisphereLight = void 0;
+    }
+    if (this.createdLight && this.light) {
+      this.scene.remove(this.light);
+      if (this.light.shadow?.map) {
+        this.light.shadow.map.dispose();
+      }
+      this.light.dispose();
+    }
+  }
+  configureShadowMap(light) {
+    light.castShadow = true;
+    const camera = light.shadow.camera;
+    if (camera instanceof THREE.OrthographicCamera && typeof this.shadowCameraSize === "number") {
+      const size = this.shadowCameraSize;
+      camera.left = -size;
+      camera.right = size;
+      camera.top = size;
+      camera.bottom = -size;
+      camera.near = 0.5;
+      camera.far = this.shadowCameraFar;
+      camera.updateProjectionMatrix();
+    }
+    light.shadow.mapSize.set(2048, 2048);
+    light.shadow.bias = -5e-4;
+  }
+  computeDate(dateOverride) {
+    if (dateOverride) {
+      return new Date(dateOverride.getTime());
+    }
+    if (this.useSystemTime) {
+      const now = /* @__PURE__ */ new Date();
+      this.referenceYear = now.getUTCFullYear();
+      this.dayOfYear = computeDayOfYear(now);
+      this.timeOfDay = now.getUTCHours() + now.getUTCMinutes() / 60 + now.getUTCSeconds() / 3600;
+      return now;
+    }
+    const daysInYear = isLeapYear(this.referenceYear) ? 366 : 365;
+    const dayIndex = clamp(this.dayOfYear, 1, daysInYear);
+    const date = new Date(Date.UTC(this.referenceYear, 0, 1, 0, 0, 0, 0));
+    const minutesFromYearStart = (dayIndex - 1) * 24 * 60 + this.timeOfDay * 60 - this.timeZoneOffsetMinutes;
+    date.setUTCMinutes(minutesFromYearStart);
+    return date;
+  }
+  computeSunPosition(date) {
+    const days = toDays(date);
+    const lw = -this.longitude * DEG2RAD;
+    const phi = this.latitude * DEG2RAD;
+    const meanAnomaly = solarMeanAnomaly(days);
+    const longitude = eclipticLongitude(meanAnomaly);
+    const decl = declination(longitude);
+    const ra = rightAscension(longitude);
+    const sidereal = siderealTime(days, lw);
+    const hourAngle = sidereal - ra;
+    return {
+      azimuth: solarAzimuth(hourAngle, phi, decl),
+      altitude: solarAltitude(hourAngle, phi, decl)
+    };
+  }
+  applySunPosition(position, date) {
+    const radius = this.lightDistance;
+    const altitude = position.altitude;
+    const azimuth = position.azimuth;
+    const x = -radius * Math.cos(altitude) * Math.sin(azimuth);
+    const y = radius * Math.sin(altitude);
+    const z = radius * Math.cos(altitude) * Math.cos(azimuth);
+    this.light.position.set(x, y, z);
+    this.light.target.position.set(0, 0, 0);
+    this.light.target.updateMatrixWorld();
+    if (this.helper) {
+      this.helper.update();
+    }
+    if (!this.useSystemTime) {
+      this.referenceYear = date.getUTCFullYear();
+    }
+  }
+  applyWeather(solarAltitude2) {
+    const preset = buildWeatherPreset(this.weather, solarAltitude2);
+    const altitudeDeg = solarAltitude2 * RAD2DEG;
+    const twilightStartDeg = -6;
+    const daylightDeg = 4;
+    const daylightRange = daylightDeg - twilightStartDeg;
+    const daylightFactor = clamp(
+      (altitudeDeg - twilightStartDeg) / daylightRange,
+      0,
+      1
+    );
+    const twilightFactor = 1 - daylightFactor;
+    const sunColor = preset.sunColor.lerp(TWILIGHT_SUN_COLOR, twilightFactor);
+    const ambientColor = preset.ambientColor.lerp(
+      TWILIGHT_AMBIENT_COLOR,
+      twilightFactor
+    );
+    const skyColor = preset.hemisphereSkyColor.lerp(
+      TWILIGHT_SKY_COLOR,
+      twilightFactor
+    );
+    const groundColor = preset.hemisphereGroundColor.lerp(
+      TWILIGHT_GROUND_COLOR,
+      twilightFactor
+    );
+    const adjustedSunIntensity = preset.sunIntensity * daylightFactor;
+    const adjustedAmbientIntensity = Math.max(
+      0.05,
+      preset.ambientIntensity * (0.3 + 0.7 * daylightFactor)
+    );
+    const adjustedHemisphereIntensity = Math.max(
+      0.05,
+      preset.hemisphereIntensity * (0.35 + 0.65 * daylightFactor)
+    );
+    this.light.intensity = adjustedSunIntensity;
+    this.light.visible = adjustedSunIntensity > 1e-3;
+    this.light.color.copy(sunColor);
+    this.light.shadow.bias = preset.shadowBias;
+    if (this.ambientLight) {
+      this.ambientLight.intensity = adjustedAmbientIntensity;
+      this.ambientLight.color.copy(ambientColor);
+    }
+    if (this.hemisphereLight) {
+      this.hemisphereLight.intensity = adjustedHemisphereIntensity;
+      this.hemisphereLight.color.copy(skyColor);
+      this.hemisphereLight.groundColor.copy(groundColor);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SunLightTool
+});
+//# sourceMappingURL=index.cjs.map

package/dist/sunlight/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../packages/sunlight/src/index.ts","../../packages/sunlight/src/SunLightTool.ts"],"sourcesContent":["export * from './SunLightTool'\n","import * as THREE from 'three'\n\nexport type SunLightWeather = 'sunny' | 'partly-cloudy' | 'overcast'\n\nexport interface SunLightToolOptions {\n  light?: THREE.DirectionalLight\n  ambientLight?: THREE.Light\n  latitude?: number\n  longitude?: number\n  dayOfYear?: number\n  timeOfDay?: number\n  timeZoneOffsetMinutes?: number\n  referenceYear?: number\n  useSystemTime?: boolean\n  weather?: SunLightWeather\n  showHelper?: boolean\n  helperSize?: number\n  helperColor?: number\n  enableHemisphereLight?: boolean\n  hemisphereSkyColor?: number\n  hemisphereGroundColor?: number\n  hemisphereIntensity?: number\n  lightDistance?: number\n  shadowCameraSize?: number\n  shadowCameraFar?: number\n}\n\nexport interface SunLightState {\n  date: Date\n  latitude: number\n  longitude: number\n  solarAzimuth: number\n  solarAltitude: number\n  weather: SunLightWeather\n  useSystemTime: boolean\n}\n\nexport interface SunLightToolEvents {\n  stateChanged: { state: SunLightState }\n  weatherChanged: { weather: SunLightWeather }\n  systemTimeToggled: { useSystemTime: boolean }\n}\n\ninterface WeatherPresetConfig {\n  sunIntensity: number\n  sunColor: THREE.Color\n  ambientIntensity: number\n  ambientColor: THREE.Color\n  hemisphereIntensity: number\n  hemisphereSkyColor: THREE.Color\n  hemisphereGroundColor: THREE.Color\n  shadowBias: number\n}\n\nconst DAY_MS = 24 * 60 * 60 * 1000\nconst DEG2RAD = Math.PI / 180\nconst RAD2DEG = 180 / Math.PI\nconst J1970 = 2440588\nconst J2000 = 2451545\n\nconst clamp = (value: number, min: number, max: number): number =>\n  Math.min(Math.max(value, min), max)\n\nconst normalizeLongitude = (value: number): number => {\n  const normalized = ((((value + 180) % 360) + 360) % 360) - 180\n  return normalized\n}\n\nconst isLeapYear = (year: number): boolean =>\n  (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0\n\nconst limitDayOfYear = (day: number, year: number): number => {\n  const maxDay = isLeapYear(year) ? 366 : 365\n  return clamp(Math.floor(day), 1, maxDay)\n}\n\nconst normalizeHours = (hours: number): number => {\n  const normalized = hours % 24\n  return normalized < 0 ? normalized + 24 : normalized\n}\n\nconst TWILIGHT_SUN_COLOR = new THREE.Color(0xff8c5c)\nconst TWILIGHT_AMBIENT_COLOR = new THREE.Color(0xffb48a)\nconst TWILIGHT_SKY_COLOR = new THREE.Color(0xff9966)\nconst TWILIGHT_GROUND_COLOR = new THREE.Color(0x362a24)\n\nconst toJulian = (date: Date): number => date.valueOf() / DAY_MS - 0.5 + J1970\nconst toDays = (date: Date): number => toJulian(date) - J2000\n\nconst solarMeanAnomaly = (days: number): number =>\n  DEG2RAD * (357.5291 + 0.98560028 * days)\n\nconst eclipticLongitude = (meanAnomaly: number): number => {\n  const c =\n    DEG2RAD *\n    (1.9148 * Math.sin(meanAnomaly) +\n      0.02 * Math.sin(2 * meanAnomaly) +\n      0.0003 * Math.sin(3 * meanAnomaly))\n  const p = DEG2RAD * 102.9372\n  return meanAnomaly + c + p + Math.PI\n}\n\nconst declination = (longitude: number): number => {\n  const e = DEG2RAD * 23.4397\n  return Math.asin(Math.sin(e) * Math.sin(longitude))\n}\n\nconst rightAscension = (longitude: number): number => {\n  const e = DEG2RAD * 23.4397\n  return Math.atan2(Math.sin(longitude) * Math.cos(e), Math.cos(longitude))\n}\n\nconst siderealTime = (days: number, longitudeWest: number): number =>\n  DEG2RAD * (280.16 + 360.9856235 * days) - longitudeWest\n\nconst solarAzimuth = (\n  hourAngle: number,\n  latitudeRad: number,\n  declinationRad: number\n): number =>\n  Math.atan2(\n    Math.sin(hourAngle),\n    Math.cos(hourAngle) * Math.sin(latitudeRad) -\n      Math.tan(declinationRad) * Math.cos(latitudeRad)\n  )\n\nconst solarAltitude = (\n  hourAngle: number,\n  latitudeRad: number,\n  declinationRad: number\n): number =>\n  Math.asin(\n    Math.sin(latitudeRad) * Math.sin(declinationRad) +\n      Math.cos(latitudeRad) * Math.cos(declinationRad) * Math.cos(hourAngle)\n  )\n\nconst computeDayOfYear = (date: Date): number => {\n  const startOfYear = Date.UTC(date.getUTCFullYear(), 0, 0)\n  const diff = date.getTime() - startOfYear\n  return Math.floor(diff / (24 * 60 * 60 * 1000))\n}\n\nconst buildWeatherPreset = (\n  weather: SunLightWeather,\n  solarAltitude: number\n): WeatherPresetConfig => {\n  const altitudeFactor = clamp(Math.sin(solarAltitude) + 0.1, 0, 1)\n  switch (weather) {\n    case 'sunny':\n      return {\n        sunIntensity: 1.5 * altitudeFactor,\n        sunColor: new THREE.Color(0xfff2cf),\n        ambientIntensity: 0.35 + 0.45 * altitudeFactor,\n        ambientColor: new THREE.Color(0xf5e7cf),\n        hemisphereIntensity: 0.4 + 0.4 * altitudeFactor,\n        hemisphereSkyColor: new THREE.Color(0xb8d8ff),\n        hemisphereGroundColor: new THREE.Color(0xf4d1aa),\n        shadowBias: -0.0005,\n      }\n    case 'partly-cloudy':\n      return {\n        sunIntensity: 1.1 * altitudeFactor,\n        sunColor: new THREE.Color(0xfff6e5),\n        ambientIntensity: 0.45 + 0.35 * altitudeFactor,\n        ambientColor: new THREE.Color(0xe8ecf1),\n        hemisphereIntensity: 0.5 + 0.3 * altitudeFactor,\n        hemisphereSkyColor: new THREE.Color(0xc8d7eb),\n        hemisphereGroundColor: new THREE.Color(0xe6d9c2),\n        shadowBias: -0.0003,\n      }\n    case 'overcast':\n      return {\n        sunIntensity: 0.35 * altitudeFactor,\n        sunColor: new THREE.Color(0xf0f4ff),\n        ambientIntensity: 0.75,\n        ambientColor: new THREE.Color(0xd9dde5),\n        hemisphereIntensity: 0.8,\n        hemisphereSkyColor: new THREE.Color(0xcdd5df),\n        hemisphereGroundColor: new THREE.Color(0xc8c8c8),\n        shadowBias: -0.0001,\n      }\n    default:\n      return {\n        sunIntensity: 1.0 * altitudeFactor,\n        sunColor: new THREE.Color(0xffd9b3),\n        ambientIntensity: 0.35 + 0.25 * altitudeFactor,\n        ambientColor: new THREE.Color(0xffe3c4),\n        hemisphereIntensity: 0.4 + 0.3 * altitudeFactor,\n        hemisphereSkyColor: new THREE.Color(0xffc8a3),\n        hemisphereGroundColor: new THREE.Color(0x5f463a),\n        shadowBias: -0.0002,\n      }\n  }\n}\n\nexport class SunLightTool extends THREE.EventDispatcher<SunLightToolEvents> {\n  private scene: THREE.Scene\n  private light: THREE.DirectionalLight\n  private ambientLight?: THREE.Light\n  private hemisphereLight?: THREE.HemisphereLight\n  private helper?: THREE.DirectionalLightHelper\n  private createdLight: boolean = false\n  private createdHemisphere: boolean = false\n  private latitude: number\n  private longitude: number\n  private dayOfYear: number\n  private timeOfDay: number\n  private timeZoneOffsetMinutes: number\n  private referenceYear: number\n  private weather: SunLightWeather\n  private useSystemTime: boolean\n  private lightDistance: number\n  private shadowCameraSize: number\n  private shadowCameraFar: number\n  private state: SunLightState\n\n  constructor(scene: THREE.Scene, options: SunLightToolOptions = {}) {\n    super()\n    this.scene = scene\n    const defaultLatitude = options.latitude ?? 51.5072\n    const defaultLongitude = options.longitude ?? -0.1276\n    this.latitude = clamp(defaultLatitude, -90, 90)\n    this.longitude = normalizeLongitude(defaultLongitude)\n    this.referenceYear = options.referenceYear ?? new Date().getUTCFullYear()\n    this.dayOfYear = limitDayOfYear(\n      options.dayOfYear ?? 172,\n      this.referenceYear\n    )\n    this.timeOfDay = normalizeHours(options.timeOfDay ?? 12)\n    this.timeZoneOffsetMinutes = options.timeZoneOffsetMinutes ?? 0\n    this.weather = options.weather ?? 'sunny'\n    this.useSystemTime = options.useSystemTime ?? false\n    this.lightDistance = options.lightDistance ?? 150\n    this.shadowCameraSize = options.shadowCameraSize ?? 100\n    this.shadowCameraFar = options.shadowCameraFar ?? 600\n\n    const existingDirectional = options.light\n    this.light =\n      existingDirectional ?? new THREE.DirectionalLight(0xffffff, 1.0)\n    this.createdLight = !existingDirectional\n\n    if (!this.light.parent) {\n      this.scene.add(this.light)\n    }\n\n    if (!this.light.target.parent) {\n      this.scene.add(this.light.target)\n    }\n\n    this.configureShadowMap(this.light)\n\n    if (options.ambientLight) {\n      this.ambientLight = options.ambientLight\n    }\n\n    if (options.enableHemisphereLight ?? true) {\n      this.hemisphereLight = new THREE.HemisphereLight(\n        options.hemisphereSkyColor ?? 0xbad4ff,\n        options.hemisphereGroundColor ?? 0x74675a,\n        options.hemisphereIntensity ?? 0.45\n      )\n      this.scene.add(this.hemisphereLight)\n      this.createdHemisphere = true\n    }\n\n    if (options.showHelper) {\n      this.helper = new THREE.DirectionalLightHelper(\n        this.light,\n        options.helperSize ?? 25,\n        options.helperColor ?? 0xffd27f\n      )\n      this.scene.add(this.helper)\n    }\n\n    this.state = {\n      date: new Date(),\n      latitude: this.latitude,\n      longitude: this.longitude,\n      solarAzimuth: 0,\n      solarAltitude: 0,\n      weather: this.weather,\n      useSystemTime: this.useSystemTime,\n    }\n\n    this.update()\n  }\n\n  getLight(): THREE.DirectionalLight {\n    return this.light\n  }\n\n  getHemisphereLight(): THREE.HemisphereLight | undefined {\n    return this.hemisphereLight\n  }\n\n  getState(): SunLightState {\n    return { ...this.state, date: new Date(this.state.date.getTime()) }\n  }\n\n  getDayOfYear(): number {\n    return this.dayOfYear\n  }\n\n  getTimeOfDay(): number {\n    return this.timeOfDay\n  }\n\n  getTimeZoneOffset(): number {\n    return this.timeZoneOffsetMinutes\n  }\n\n  getWeather(): SunLightWeather {\n    return this.weather\n  }\n\n  usesSystemTime(): boolean {\n    return this.useSystemTime\n  }\n\n  setLatitude(latitude: number): void {\n    const clamped = clamp(latitude, -90, 90)\n    if (clamped === this.latitude) return\n    this.latitude = clamped\n    this.update()\n  }\n\n  setLongitude(longitude: number): void {\n    const normalized = normalizeLongitude(longitude)\n    if (normalized === this.longitude) return\n    this.longitude = normalized\n    this.update()\n  }\n\n  setLocation(latitude: number, longitude: number): void {\n    let changed = false\n    const lat = clamp(latitude, -90, 90)\n    if (lat !== this.latitude) {\n      this.latitude = lat\n      changed = true\n    }\n    const lon = normalizeLongitude(longitude)\n    if (lon !== this.longitude) {\n      this.longitude = lon\n      changed = true\n    }\n    if (changed) {\n      this.update()\n    }\n  }\n\n  setDayOfYear(day: number): void {\n    const limited = limitDayOfYear(day, this.referenceYear)\n    if (limited === this.dayOfYear) return\n    this.dayOfYear = limited\n    this.update()\n  }\n\n  setTimeOfDay(hours: number): void {\n    const normalized = normalizeHours(hours)\n    if (normalized === this.timeOfDay) return\n    this.timeOfDay = normalized\n    this.update()\n  }\n\n  setTimeZoneOffset(minutes: number): void {\n    if (minutes === this.timeZoneOffsetMinutes) return\n    this.timeZoneOffsetMinutes = minutes\n    this.update()\n  }\n\n  setWeather(weather: SunLightWeather): void {\n    if (weather === this.weather) return\n    this.weather = weather\n    this.dispatchEvent({ type: 'weatherChanged', weather })\n    this.update()\n  }\n\n  setUseSystemTime(enabled: boolean): void {\n    if (enabled === this.useSystemTime) return\n    this.useSystemTime = enabled\n    this.dispatchEvent({\n      type: 'systemTimeToggled',\n      useSystemTime: this.useSystemTime,\n    })\n    this.update()\n  }\n\n  update(dateOverride?: Date): void {\n    const date = this.computeDate(dateOverride)\n    const position = this.computeSunPosition(date)\n    this.applySunPosition(position, date)\n    this.state = {\n      date,\n      latitude: this.latitude,\n      longitude: this.longitude,\n      solarAzimuth: position.azimuth,\n      solarAltitude: position.altitude,\n      weather: this.weather,\n      useSystemTime: this.useSystemTime,\n    }\n    this.applyWeather(position.altitude)\n    this.dispatchEvent({ type: 'stateChanged', state: this.getState() })\n  }\n\n  dispose(): void {\n    if (this.helper) {\n      this.scene.remove(this.helper)\n      this.helper.dispose()\n      this.helper = undefined\n    }\n\n    if (this.createdHemisphere && this.hemisphereLight) {\n      this.scene.remove(this.hemisphereLight)\n      this.hemisphereLight.dispose()\n      this.hemisphereLight = undefined\n    }\n\n    if (this.createdLight && this.light) {\n      this.scene.remove(this.light)\n      if (this.light.shadow?.map) {\n        this.light.shadow.map.dispose()\n      }\n      this.light.dispose()\n    }\n  }\n\n  private configureShadowMap(light: THREE.DirectionalLight): void {\n    light.castShadow = true\n    const camera = light.shadow.camera\n    if (\n      camera instanceof THREE.OrthographicCamera &&\n      typeof this.shadowCameraSize === 'number'\n    ) {\n      const size = this.shadowCameraSize\n      camera.left = -size\n      camera.right = size\n      camera.top = size\n      camera.bottom = -size\n      camera.near = 0.5\n      camera.far = this.shadowCameraFar\n      camera.updateProjectionMatrix()\n    }\n    light.shadow.mapSize.set(2048, 2048)\n    light.shadow.bias = -0.0005\n  }\n\n  private computeDate(dateOverride?: Date): Date {\n    if (dateOverride) {\n      return new Date(dateOverride.getTime())\n    }\n\n    if (this.useSystemTime) {\n      const now = new Date()\n      this.referenceYear = now.getUTCFullYear()\n      this.dayOfYear = computeDayOfYear(now)\n      this.timeOfDay =\n        now.getUTCHours() +\n        now.getUTCMinutes() / 60 +\n        now.getUTCSeconds() / 3600\n      return now\n    }\n\n    const daysInYear = isLeapYear(this.referenceYear) ? 366 : 365\n    const dayIndex = clamp(this.dayOfYear, 1, daysInYear)\n    const date = new Date(Date.UTC(this.referenceYear, 0, 1, 0, 0, 0, 0))\n    const minutesFromYearStart =\n      (dayIndex - 1) * 24 * 60 +\n      this.timeOfDay * 60 -\n      this.timeZoneOffsetMinutes\n    date.setUTCMinutes(minutesFromYearStart)\n    return date\n  }\n\n  private computeSunPosition(date: Date): {\n    azimuth: number\n    altitude: number\n  } {\n    const days = toDays(date)\n    const lw = -this.longitude * DEG2RAD\n    const phi = this.latitude * DEG2RAD\n    const meanAnomaly = solarMeanAnomaly(days)\n    const longitude = eclipticLongitude(meanAnomaly)\n    const decl = declination(longitude)\n    const ra = rightAscension(longitude)\n    const sidereal = siderealTime(days, lw)\n    const hourAngle = sidereal - ra\n    return {\n      azimuth: solarAzimuth(hourAngle, phi, decl),\n      altitude: solarAltitude(hourAngle, phi, decl),\n    }\n  }\n\n  private applySunPosition(\n    position: { azimuth: number; altitude: number },\n    date: Date\n  ): void {\n    const radius = this.lightDistance\n    const altitude = position.altitude\n    // Astronomical azimuth: 0° = South, increasing clockwise (East=90°, North=180°, West=270°)\n    // Three.js coordinates: +X = East, +Z = North, -X = West, -Z = South\n    // The solarAzimuth function returns azimuth measured from South, clockwise\n    const azimuth = position.azimuth\n\n    // Correct coordinate mapping for Three.js\n    // sin(azimuth) gives us the East-West component, but we need to negate it:\n    // azimuth 90° (East) should give +X, azimuth 270° (West) should give -X\n    // cos(azimuth) gives us the North-South component, also needs to be positive for correct clockwise motion:\n    // azimuth 0° (South) should give -Z, azimuth 180° (North) should give +Z\n    const x = -radius * Math.cos(altitude) * Math.sin(azimuth)\n    const y = radius * Math.sin(altitude)\n    const z = radius * Math.cos(altitude) * Math.cos(azimuth)\n\n    this.light.position.set(x, y, z)\n    this.light.target.position.set(0, 0, 0)\n    this.light.target.updateMatrixWorld()\n\n    if (this.helper) {\n      this.helper.update()\n    }\n\n    // Update cached time properties when not using real-time\n    if (!this.useSystemTime) {\n      this.referenceYear = date.getUTCFullYear()\n    }\n  }\n\n  private applyWeather(solarAltitude: number): void {\n    const preset = buildWeatherPreset(this.weather, solarAltitude)\n    const altitudeDeg = solarAltitude * RAD2DEG\n    const twilightStartDeg = -6\n    const daylightDeg = 4\n    const daylightRange = daylightDeg - twilightStartDeg\n\n    const daylightFactor = clamp(\n      (altitudeDeg - twilightStartDeg) / daylightRange,\n      0,\n      1\n    )\n    const twilightFactor = 1 - daylightFactor\n\n    const sunColor = preset.sunColor.lerp(TWILIGHT_SUN_COLOR, twilightFactor)\n    const ambientColor = preset.ambientColor.lerp(\n      TWILIGHT_AMBIENT_COLOR,\n      twilightFactor\n    )\n    const skyColor = preset.hemisphereSkyColor.lerp(\n      TWILIGHT_SKY_COLOR,\n      twilightFactor\n    )\n    const groundColor = preset.hemisphereGroundColor.lerp(\n      TWILIGHT_GROUND_COLOR,\n      twilightFactor\n    )\n\n    const adjustedSunIntensity = preset.sunIntensity * daylightFactor\n    const adjustedAmbientIntensity = Math.max(\n      0.05,\n      preset.ambientIntensity * (0.3 + 0.7 * daylightFactor)\n    )\n    const adjustedHemisphereIntensity = Math.max(\n      0.05,\n      preset.hemisphereIntensity * (0.35 + 0.65 * daylightFactor)\n    )\n\n    this.light.intensity = adjustedSunIntensity\n    this.light.visible = adjustedSunIntensity > 0.001\n    this.light.color.copy(sunColor)\n    this.light.shadow.bias = preset.shadowBias\n\n    if (this.ambientLight) {\n      this.ambientLight.intensity = adjustedAmbientIntensity\n      this.ambientLight.color.copy(ambientColor)\n    }\n\n    if (this.hemisphereLight) {\n      this.hemisphereLight.intensity = adjustedHemisphereIntensity\n      this.hemisphereLight.color.copy(skyColor)\n      this.hemisphereLight.groundColor.copy(groundColor)\n    }\n  }\n}\n"],"mappings":"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","names":["solarAltitude"]}

package/dist/sunlight/index.d.mts

@@ -0,0 +1,92 @@
+import * as THREE from 'three';
+
+type SunLightWeather = 'sunny' | 'partly-cloudy' | 'overcast';
+interface SunLightToolOptions {
+    light?: THREE.DirectionalLight;
+    ambientLight?: THREE.Light;
+    latitude?: number;
+    longitude?: number;
+    dayOfYear?: number;
+    timeOfDay?: number;
+    timeZoneOffsetMinutes?: number;
+    referenceYear?: number;
+    useSystemTime?: boolean;
+    weather?: SunLightWeather;
+    showHelper?: boolean;
+    helperSize?: number;
+    helperColor?: number;
+    enableHemisphereLight?: boolean;
+    hemisphereSkyColor?: number;
+    hemisphereGroundColor?: number;
+    hemisphereIntensity?: number;
+    lightDistance?: number;
+    shadowCameraSize?: number;
+    shadowCameraFar?: number;
+}
+interface SunLightState {
+    date: Date;
+    latitude: number;
+    longitude: number;
+    solarAzimuth: number;
+    solarAltitude: number;
+    weather: SunLightWeather;
+    useSystemTime: boolean;
+}
+interface SunLightToolEvents {
+    stateChanged: {
+        state: SunLightState;
+    };
+    weatherChanged: {
+        weather: SunLightWeather;
+    };
+    systemTimeToggled: {
+        useSystemTime: boolean;
+    };
+}
+declare class SunLightTool extends THREE.EventDispatcher<SunLightToolEvents> {
+    private scene;
+    private light;
+    private ambientLight?;
+    private hemisphereLight?;
+    private helper?;
+    private createdLight;
+    private createdHemisphere;
+    private latitude;
+    private longitude;
+    private dayOfYear;
+    private timeOfDay;
+    private timeZoneOffsetMinutes;
+    private referenceYear;
+    private weather;
+    private useSystemTime;
+    private lightDistance;
+    private shadowCameraSize;
+    private shadowCameraFar;
+    private state;
+    constructor(scene: THREE.Scene, options?: SunLightToolOptions);
+    getLight(): THREE.DirectionalLight;
+    getHemisphereLight(): THREE.HemisphereLight | undefined;
+    getState(): SunLightState;
+    getDayOfYear(): number;
+    getTimeOfDay(): number;
+    getTimeZoneOffset(): number;
+    getWeather(): SunLightWeather;
+    usesSystemTime(): boolean;
+    setLatitude(latitude: number): void;
+    setLongitude(longitude: number): void;
+    setLocation(latitude: number, longitude: number): void;
+    setDayOfYear(day: number): void;
+    setTimeOfDay(hours: number): void;
+    setTimeZoneOffset(minutes: number): void;
+    setWeather(weather: SunLightWeather): void;
+    setUseSystemTime(enabled: boolean): void;
+    update(dateOverride?: Date): void;
+    dispose(): void;
+    private configureShadowMap;
+    private computeDate;
+    private computeSunPosition;
+    private applySunPosition;
+    private applyWeather;
+}
+
+export { type SunLightState, SunLightTool, type SunLightToolEvents, type SunLightToolOptions, type SunLightWeather };

package/dist/sunlight/index.d.ts

@@ -0,0 +1,92 @@
+import * as THREE from 'three';
+
+type SunLightWeather = 'sunny' | 'partly-cloudy' | 'overcast';
+interface SunLightToolOptions {
+    light?: THREE.DirectionalLight;
+    ambientLight?: THREE.Light;
+    latitude?: number;
+    longitude?: number;
+    dayOfYear?: number;
+    timeOfDay?: number;
+    timeZoneOffsetMinutes?: number;
+    referenceYear?: number;
+    useSystemTime?: boolean;
+    weather?: SunLightWeather;
+    showHelper?: boolean;
+    helperSize?: number;
+    helperColor?: number;
+    enableHemisphereLight?: boolean;
+    hemisphereSkyColor?: number;
+    hemisphereGroundColor?: number;
+    hemisphereIntensity?: number;
+    lightDistance?: number;
+    shadowCameraSize?: number;
+    shadowCameraFar?: number;
+}
+interface SunLightState {
+    date: Date;
+    latitude: number;
+    longitude: number;
+    solarAzimuth: number;
+    solarAltitude: number;
+    weather: SunLightWeather;
+    useSystemTime: boolean;
+}
+interface SunLightToolEvents {
+    stateChanged: {
+        state: SunLightState;
+    };
+    weatherChanged: {
+        weather: SunLightWeather;
+    };
+    systemTimeToggled: {
+        useSystemTime: boolean;
+    };
+}
+declare class SunLightTool extends THREE.EventDispatcher<SunLightToolEvents> {
+    private scene;
+    private light;
+    private ambientLight?;
+    private hemisphereLight?;
+    private helper?;
+    private createdLight;
+    private createdHemisphere;
+    private latitude;
+    private longitude;
+    private dayOfYear;
+    private timeOfDay;
+    private timeZoneOffsetMinutes;
+    private referenceYear;
+    private weather;
+    private useSystemTime;
+    private lightDistance;
+    private shadowCameraSize;
+    private shadowCameraFar;
+    private state;
+    constructor(scene: THREE.Scene, options?: SunLightToolOptions);
+    getLight(): THREE.DirectionalLight;
+    getHemisphereLight(): THREE.HemisphereLight | undefined;
+    getState(): SunLightState;
+    getDayOfYear(): number;
+    getTimeOfDay(): number;
+    getTimeZoneOffset(): number;
+    getWeather(): SunLightWeather;
+    usesSystemTime(): boolean;
+    setLatitude(latitude: number): void;
+    setLongitude(longitude: number): void;
+    setLocation(latitude: number, longitude: number): void;
+    setDayOfYear(day: number): void;
+    setTimeOfDay(hours: number): void;
+    setTimeZoneOffset(minutes: number): void;
+    setWeather(weather: SunLightWeather): void;
+    setUseSystemTime(enabled: boolean): void;
+    update(dateOverride?: Date): void;
+    dispose(): void;
+    private configureShadowMap;
+    private computeDate;
+    private computeSunPosition;
+    private applySunPosition;
+    private applyWeather;
+}
+
+export { type SunLightState, SunLightTool, type SunLightToolEvents, type SunLightToolOptions, type SunLightWeather };