@tonybfox/threejs-tools 1.0.5 → 1.0.7

package/dist/chunk-W4DAAAW6.mjs

@@ -1,404 +0,0 @@
-// packages/sunlight/src/SunLightTool.ts
-import * as THREE from "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);
-    }
-  }
-};
-
-export {
-  SunLightTool
-};