@scenography/plugin-sky 0.2.0

package/dist/data-BY6HfW4z.mjs

@@ -0,0 +1,21 @@
+import { isFiniteNumber, isNonNegativeNumber, isNumberInRange, propIs, validate } from "@scenography/scene";
+//#region src/data/validate.ts
+const validateSky = (sky) => validate([
+	propIs("time", isNumberInRange(0, 24), "time must be between 0 and 24."),
+	propIs("azimuth", isFiniteNumber, "azimuth must be a finite number."),
+	propIs("turbidity", isNonNegativeNumber, "turbidity must be a non-negative number."),
+	propIs("rayleigh", isNonNegativeNumber, "rayleigh must be a non-negative number."),
+	propIs("fog", isNonNegativeNumber, "fog must be a non-negative number.")
+])(sky);
+//#endregion
+//#region src/data/plugin.ts
+/** The data half of the sky plugin: owns the `sky` scene key (a singleton). */
+const skyData = {
+	kind: "sky",
+	cardinality: "single",
+	validate: (sky) => validateSky(sky)
+};
+//#endregion
+export { validateSky as n, skyData as t };
+
+//# sourceMappingURL=data-BY6HfW4z.mjs.map

package/dist/data-BY6HfW4z.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-BY6HfW4z.mjs","names":[],"sources":["../src/data/validate.ts","../src/data/plugin.ts"],"sourcesContent":["import {\n  isFiniteNumber,\n  isNonNegativeNumber,\n  isNumberInRange,\n  propIs,\n  validate,\n  type ValidationResult,\n} from \"@scenography/scene\";\nimport type { Sky } from \"./sky\";\n\nexport const validateSky = (sky: Sky): ValidationResult =>\n  validate<Sky>([\n    propIs(\"time\", isNumberInRange(0, 24), \"time must be between 0 and 24.\"),\n    propIs(\"azimuth\", isFiniteNumber, \"azimuth must be a finite number.\"),\n    propIs(\"turbidity\", isNonNegativeNumber, \"turbidity must be a non-negative number.\"),\n    propIs(\"rayleigh\", isNonNegativeNumber, \"rayleigh must be a non-negative number.\"),\n    propIs(\"fog\", isNonNegativeNumber, \"fog must be a non-negative number.\"),\n  ])(sky);\n","import type { DataPlugin } from \"@scenography/scene\";\n\nimport { validateSky } from \"./validate\";\nimport type { Sky } from \"./sky\";\n\n/** The data half of the sky plugin: owns the `sky` scene key (a singleton). */\nexport const skyData: DataPlugin<Sky> = {\n  kind: \"sky\",\n  cardinality: \"single\",\n  validate: (sky) => validateSky(sky),\n};\n"],"mappings":";;AAUA,MAAa,eAAe,QAC1B,SAAc;CACZ,OAAO,QAAQ,gBAAgB,GAAG,EAAE,GAAG,gCAAgC;CACvE,OAAO,WAAW,gBAAgB,kCAAkC;CACpE,OAAO,aAAa,qBAAqB,0CAA0C;CACnF,OAAO,YAAY,qBAAqB,yCAAyC;CACjF,OAAO,OAAO,qBAAqB,oCAAoC;AACzE,CAAC,CAAC,CAAC,GAAG;;;;ACXR,MAAa,UAA2B;CACtC,MAAM;CACN,aAAa;CACb,WAAW,QAAQ,YAAY,GAAG;AACpC"}

package/dist/data-DM9PlHyL.cjs

@@ -0,0 +1,32 @@
+let _scenography_scene = require("@scenography/scene");
+//#region src/data/validate.ts
+const validateSky = (sky) => (0, _scenography_scene.validate)([
+	(0, _scenography_scene.propIs)("time", (0, _scenography_scene.isNumberInRange)(0, 24), "time must be between 0 and 24."),
+	(0, _scenography_scene.propIs)("azimuth", _scenography_scene.isFiniteNumber, "azimuth must be a finite number."),
+	(0, _scenography_scene.propIs)("turbidity", _scenography_scene.isNonNegativeNumber, "turbidity must be a non-negative number."),
+	(0, _scenography_scene.propIs)("rayleigh", _scenography_scene.isNonNegativeNumber, "rayleigh must be a non-negative number."),
+	(0, _scenography_scene.propIs)("fog", _scenography_scene.isNonNegativeNumber, "fog must be a non-negative number.")
+])(sky);
+//#endregion
+//#region src/data/plugin.ts
+/** The data half of the sky plugin: owns the `sky` scene key (a singleton). */
+const skyData = {
+	kind: "sky",
+	cardinality: "single",
+	validate: (sky) => validateSky(sky)
+};
+//#endregion
+Object.defineProperty(exports, "skyData", {
+	enumerable: true,
+	get: function() {
+		return skyData;
+	}
+});
+Object.defineProperty(exports, "validateSky", {
+	enumerable: true,
+	get: function() {
+		return validateSky;
+	}
+});
+
+//# sourceMappingURL=data-DM9PlHyL.cjs.map

package/dist/data-DM9PlHyL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-DM9PlHyL.cjs","names":["isFiniteNumber","isNonNegativeNumber"],"sources":["../src/data/validate.ts","../src/data/plugin.ts"],"sourcesContent":["import {\n  isFiniteNumber,\n  isNonNegativeNumber,\n  isNumberInRange,\n  propIs,\n  validate,\n  type ValidationResult,\n} from \"@scenography/scene\";\nimport type { Sky } from \"./sky\";\n\nexport const validateSky = (sky: Sky): ValidationResult =>\n  validate<Sky>([\n    propIs(\"time\", isNumberInRange(0, 24), \"time must be between 0 and 24.\"),\n    propIs(\"azimuth\", isFiniteNumber, \"azimuth must be a finite number.\"),\n    propIs(\"turbidity\", isNonNegativeNumber, \"turbidity must be a non-negative number.\"),\n    propIs(\"rayleigh\", isNonNegativeNumber, \"rayleigh must be a non-negative number.\"),\n    propIs(\"fog\", isNonNegativeNumber, \"fog must be a non-negative number.\"),\n  ])(sky);\n","import type { DataPlugin } from \"@scenography/scene\";\n\nimport { validateSky } from \"./validate\";\nimport type { Sky } from \"./sky\";\n\n/** The data half of the sky plugin: owns the `sky` scene key (a singleton). */\nexport const skyData: DataPlugin<Sky> = {\n  kind: \"sky\",\n  cardinality: \"single\",\n  validate: (sky) => validateSky(sky),\n};\n"],"mappings":";;AAUA,MAAa,eAAe,SAAA,GAAA,mBAAA,SAAA,CACZ;gCACL,SAAA,GAAA,mBAAA,gBAAA,CAAwB,GAAG,EAAE,GAAG,gCAAgC;gCAChE,WAAWA,mBAAAA,gBAAgB,kCAAkC;gCAC7D,aAAaC,mBAAAA,qBAAqB,0CAA0C;gCAC5E,YAAYA,mBAAAA,qBAAqB,yCAAyC;gCAC1E,OAAOA,mBAAAA,qBAAqB,oCAAoC;AACzE,CAAC,CAAC,CAAC,GAAG;;;;ACXR,MAAa,UAA2B;CACtC,MAAM;CACN,aAAa;CACb,WAAW,QAAQ,YAAY,GAAG;AACpC"}

package/dist/data.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_data = require("./data-DM9PlHyL.cjs");
+exports.skyData = require_data.skyData;
+exports.validateSky = require_data.validateSky;

package/dist/data.d.cts

@@ -0,0 +1,2 @@
+import { n as validateSky, r as Sky, t as skyData } from "./index-GwVhqXni.cjs";
+export { type Sky, skyData, validateSky };

package/dist/data.d.mts

@@ -0,0 +1,2 @@
+import { n as validateSky, r as Sky, t as skyData } from "./index-GwVhqXni.mjs";
+export { type Sky, skyData, validateSky };

package/dist/data.mjs

@@ -0,0 +1,2 @@
+import { n as validateSky, t as skyData } from "./data-BY6HfW4z.mjs";
+export { skyData, validateSky };

package/dist/index-GwVhqXni.d.cts

@@ -0,0 +1,37 @@
+import { DataPlugin, ValidationResult } from "@scenography/scene";
+
+//#region src/data/sky.d.ts
+/**
+ * A procedural sky driven by the time of day. The runtime renders an atmospheric
+ * sky dome, moves a sun light along its daily arc, and fades in stars at night —
+ * all from `time`. Always clear (no weather). Distinct from `Environment` (a
+ * static HDRI): a scene uses one or the other for its background.
+ */
+interface Sky {
+  /** Hour of day, `0`..`24` (`6` sunrise, `12` noon, `18` sunset, `0`/`24` midnight). Default `12`. */
+  time?: number;
+  /** Compass offset (degrees) that rotates the sun's daily arc — orient the scene to the sun. Default `0`. */
+  azimuth?: number;
+  /** Atmospheric haze; higher is hazier/whiter. Default `4`. */
+  turbidity?: number;
+  /** Rayleigh scattering; higher is a deeper blue. Default `2`. */
+  rayleigh?: number;
+  /** Exponential fog density tinted to the sky (fades the horizon). `0` = none. Default `0`. */
+  fog?: number;
+}
+declare module "@scenography/scene" {
+  interface Scene {
+    /** Procedural time-of-day sky — provided by `@scenography/plugin-sky`. */
+    sky?: Sky;
+  }
+}
+//#endregion
+//#region src/data/validate.d.ts
+declare const validateSky: (sky: Sky) => ValidationResult;
+//#endregion
+//#region src/data/plugin.d.ts
+/** The data half of the sky plugin: owns the `sky` scene key (a singleton). */
+declare const skyData: DataPlugin<Sky>;
+//#endregion
+export { validateSky as n, Sky as r, skyData as t };
+//# sourceMappingURL=index-GwVhqXni.d.cts.map

package/dist/index-GwVhqXni.d.mts

@@ -0,0 +1,37 @@
+import { DataPlugin, ValidationResult } from "@scenography/scene";
+
+//#region src/data/sky.d.ts
+/**
+ * A procedural sky driven by the time of day. The runtime renders an atmospheric
+ * sky dome, moves a sun light along its daily arc, and fades in stars at night —
+ * all from `time`. Always clear (no weather). Distinct from `Environment` (a
+ * static HDRI): a scene uses one or the other for its background.
+ */
+interface Sky {
+  /** Hour of day, `0`..`24` (`6` sunrise, `12` noon, `18` sunset, `0`/`24` midnight). Default `12`. */
+  time?: number;
+  /** Compass offset (degrees) that rotates the sun's daily arc — orient the scene to the sun. Default `0`. */
+  azimuth?: number;
+  /** Atmospheric haze; higher is hazier/whiter. Default `4`. */
+  turbidity?: number;
+  /** Rayleigh scattering; higher is a deeper blue. Default `2`. */
+  rayleigh?: number;
+  /** Exponential fog density tinted to the sky (fades the horizon). `0` = none. Default `0`. */
+  fog?: number;
+}
+declare module "@scenography/scene" {
+  interface Scene {
+    /** Procedural time-of-day sky — provided by `@scenography/plugin-sky`. */
+    sky?: Sky;
+  }
+}
+//#endregion
+//#region src/data/validate.d.ts
+declare const validateSky: (sky: Sky) => ValidationResult;
+//#endregion
+//#region src/data/plugin.d.ts
+/** The data half of the sky plugin: owns the `sky` scene key (a singleton). */
+declare const skyData: DataPlugin<Sky>;
+//#endregion
+export { validateSky as n, Sky as r, skyData as t };
+//# sourceMappingURL=index-GwVhqXni.d.mts.map

package/dist/index.cjs

@@ -0,0 +1,226 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_data = require("./data-DM9PlHyL.cjs");
+let three = require("three");
+//#region src/SkyController.ts
+const clamp01 = (x) => Math.min(Math.max(x, 0), 1);
+const lerp = (a, b, t) => a + (b - a) * t;
+const DOME = 4500;
+const STAR_COUNT = 1500;
+const SUN_DISTANCE = 2e3;
+const MAX_ELEVATION = 60;
+const ENV_THROTTLE_MS = 150;
+const SUNSET = new three.Color("#ff7a3c");
+const DAYLIGHT = new three.Color("#fff4e6");
+const NIGHT_FOG = new three.Color("#0a1222");
+const DAY_FOG = new three.Color("#bcd3e0");
+/**
+* Owns the procedural time-of-day sky: an atmospheric dome (three's `Sky`
+* addon), a sun `DirectionalLight` riding its daily arc, a hemisphere fill, and a
+* star field that fades in at night. `setTime(hour)` drives everything; the
+* dome loads on demand (own chunk) and catches up to the latest time.
+*/
+var SkyController = class {
+	scene;
+	sun = new three.DirectionalLight(16777215, 0);
+	hemi = new three.HemisphereLight(8961023, 5917238, 0);
+	stars;
+	dome = null;
+	def = null;
+	time = 12;
+	azimuth = 0;
+	hash = null;
+	renderer;
+	pmrem;
+	envRT = null;
+	envDirty = false;
+	envTimer = 0;
+	constructor(scene, renderer) {
+		this.scene = scene;
+		this.renderer = renderer;
+		this.pmrem = new three.PMREMGenerator(renderer);
+		this.sun.castShadow = true;
+		this.sun.shadow.mapSize.set(2048, 2048);
+		const cam = this.sun.shadow.camera;
+		cam.left = cam.bottom = -1500;
+		cam.right = cam.top = 1500;
+		cam.near = 1;
+		cam.far = SUN_DISTANCE * 2;
+		this.stars = this.buildStars();
+	}
+	reconcile(def) {
+		const hash = def ? JSON.stringify(def) : null;
+		if (hash === this.hash) return;
+		this.hash = hash;
+		if (!def) {
+			this.clear();
+			return;
+		}
+		if (!this.def) {
+			this.scene.add(this.sun, this.sun.target, this.hemi, this.stars);
+			this.ensureDome();
+		}
+		this.def = def;
+		this.azimuth = def.azimuth ?? 0;
+		this.applyAtmosphere();
+		this.setTime(def.time ?? 12);
+	}
+	/** Set the hour of day (0..24) and update sun, sky, fill and stars live. */
+	setTime(hour) {
+		this.time = hour;
+		const elevation = Math.sin((hour - 6) / 12 * Math.PI) * MAX_ELEVATION;
+		const azimuth = 90 + (hour - 6) / 12 * 180 + this.azimuth;
+		const dir = new three.Vector3().setFromSphericalCoords(1, three.MathUtils.degToRad(90 - elevation), three.MathUtils.degToRad(azimuth));
+		if (this.dome) this.dome.material.uniforms.sunPosition.value.copy(dir);
+		this.sun.position.copy(dir).multiplyScalar(SUN_DISTANCE);
+		const day = clamp01(elevation / 6);
+		this.sun.intensity = day * 3;
+		this.sun.color.copy(SUNSET).lerp(DAYLIGHT, clamp01(elevation / 20));
+		this.hemi.intensity = lerp(.04, .6, clamp01((elevation + 6) / 12));
+		const night = clamp01(-elevation / 6);
+		const starMat = this.stars.material;
+		starMat.opacity = night;
+		this.stars.visible = night > 0;
+		const fogDensity = this.def?.fog ?? 0;
+		if (fogDensity > 0) {
+			const fog = this.scene.fog instanceof three.FogExp2 ? this.scene.fog : new three.FogExp2(0, fogDensity);
+			fog.density = fogDensity;
+			fog.color.copy(NIGHT_FOG).lerp(DAY_FOG, clamp01((elevation + 4) / 16));
+			const lowSun = clamp01(1 - elevation / 12) * clamp01(elevation / 3 + .4);
+			fog.color.lerp(SUNSET, lowSun * .4);
+			this.scene.fog = fog;
+		} else if (this.scene.fog instanceof three.FogExp2) this.scene.fog = null;
+		this.envDirty = true;
+	}
+	/** Current hour of day. */
+	getTime() {
+		return this.time;
+	}
+	/** Set the sun's compass offset (degrees) and re-place the sun. */
+	setAzimuth(degrees) {
+		this.azimuth = degrees;
+		this.setTime(this.time);
+	}
+	/** Current sun compass offset (degrees). */
+	getAzimuth() {
+		return this.azimuth;
+	}
+	/** Advance throttled work (IBL regeneration). Call once per frame. */
+	update(deltaMs) {
+		if (!this.envDirty || !this.dome) return;
+		this.envTimer += deltaMs;
+		if (this.envTimer < ENV_THROTTLE_MS) return;
+		this.envTimer = 0;
+		this.envDirty = false;
+		this.regenerateEnvironment();
+	}
+	/** Render just the dome to a PMREM and use it as the scene's IBL. */
+	regenerateEnvironment() {
+		if (!this.dome) return;
+		this.scene.remove(this.dome);
+		const envScene = new three.Scene();
+		envScene.add(this.dome);
+		const rt = this.pmrem.fromScene(envScene);
+		envScene.remove(this.dome);
+		this.scene.add(this.dome);
+		this.envRT?.dispose();
+		this.envRT = rt;
+		this.scene.environment = rt.texture;
+	}
+	applyAtmosphere() {
+		if (!this.dome || !this.def) return;
+		const u = this.dome.material.uniforms;
+		u.turbidity.value = this.def.turbidity ?? 4;
+		u.rayleigh.value = this.def.rayleigh ?? 2;
+		u.mieCoefficient.value = .005;
+		u.mieDirectionalG.value = .8;
+	}
+	ensureDome() {
+		if (this.dome) return;
+		import("three/examples/jsm/objects/Sky.js").then(({ Sky }) => {
+			if (!this.def) return;
+			const dome = new Sky();
+			dome.scale.setScalar(DOME);
+			this.dome = dome;
+			this.scene.add(dome);
+			this.applyAtmosphere();
+			this.setTime(this.time);
+		});
+	}
+	buildStars() {
+		const positions = new Float32Array(STAR_COUNT * 3);
+		for (let i = 0; i < STAR_COUNT; i++) {
+			const theta = Math.random() * Math.PI * 2;
+			const phi = Math.acos(Math.random());
+			const r = DOME * .9;
+			positions[i * 3] = r * Math.sin(phi) * Math.cos(theta);
+			positions[i * 3 + 1] = r * Math.cos(phi);
+			positions[i * 3 + 2] = r * Math.sin(phi) * Math.sin(theta);
+		}
+		const geometry = new three.BufferGeometry();
+		geometry.setAttribute("position", new three.Float32BufferAttribute(positions, 3));
+		const stars = new three.Points(geometry, new three.PointsMaterial({
+			color: 16777215,
+			size: 12,
+			sizeAttenuation: true,
+			transparent: true,
+			opacity: 0,
+			depthWrite: false
+		}));
+		stars.visible = false;
+		return stars;
+	}
+	clear() {
+		if (!this.def) return;
+		this.scene.remove(this.sun, this.sun.target, this.hemi, this.stars);
+		if (this.dome) {
+			this.scene.remove(this.dome);
+			this.dome = null;
+		}
+		if (this.scene.fog instanceof three.FogExp2) this.scene.fog = null;
+		this.scene.environment = null;
+		this.envRT?.dispose();
+		this.envRT = null;
+		this.envDirty = false;
+		this.def = null;
+	}
+	dispose() {
+		this.clear();
+		this.stars.geometry.dispose();
+		this.stars.material.dispose();
+		this.pmrem.dispose();
+		this.hash = null;
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* Procedural time-of-day sky — a *system* plugin. It renders an atmospheric sky
+* dome, moves a sun light along its arc, fades in stars at night and drives the
+* image-based lighting, all from `scene.sky`. Exposes `ctx.sky` (setTime/…). It
+* manages its own objects, so it takes the scene graph and renderer (for IBL).
+*/
+const sky = () => ({
+	name: "sky",
+	setup: (ctx) => {
+		const controller = new SkyController(ctx.scene3d, ctx.renderer);
+		controller.reconcile(ctx.scene.sky);
+		return {
+			update: (deltaMs) => controller.update(deltaMs),
+			setScene: (scene) => controller.reconcile(scene.sky),
+			dispose: () => controller.dispose(),
+			api: {
+				setTime: (hour) => controller.setTime(hour),
+				getTime: () => controller.getTime(),
+				setAzimuth: (degrees) => controller.setAzimuth(degrees),
+				getAzimuth: () => controller.getAzimuth()
+			}
+		};
+	}
+});
+//#endregion
+exports.SkyController = SkyController;
+exports.sky = sky;
+exports.skyData = require_data.skyData;
+exports.validateSky = require_data.validateSky;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Color","DirectionalLight","HemisphereLight","PMREMGenerator","Vector3","MathUtils","FogExp2","Scene","BufferGeometry","Float32BufferAttribute","Points","PointsMaterial"],"sources":["../src/SkyController.ts","../src/plugin.ts"],"sourcesContent":["import {\n  BufferGeometry,\n  Color,\n  DirectionalLight,\n  Float32BufferAttribute,\n  FogExp2,\n  HemisphereLight,\n  MathUtils,\n  PMREMGenerator,\n  Points,\n  PointsMaterial,\n  Scene,\n  Vector3,\n  type Object3D,\n  type Scene as ThreeScene,\n  type WebGLRenderer,\n  type WebGLRenderTarget,\n} from \"three\";\nimport type { Sky as SkyDef } from \"./data\";\n\nconst clamp01 = (x: number): number => Math.min(Math.max(x, 0), 1);\nconst lerp = (a: number, b: number, t: number): number => a + (b - a) * t;\n\n// Sky dome radius (within the camera far plane) and star shell radius.\nconst DOME = 4500;\nconst STAR_COUNT = 1500;\nconst SUN_DISTANCE = 2000;\nconst MAX_ELEVATION = 60; // noon sun angle (less than zenith for longer shadows)\nconst ENV_THROTTLE_MS = 150; // min gap between IBL regenerations\n\nconst SUNSET = new Color(\"#ff7a3c\");\nconst DAYLIGHT = new Color(\"#fff4e6\");\nconst NIGHT_FOG = new Color(\"#0a1222\");\nconst DAY_FOG = new Color(\"#bcd3e0\");\n\n/** Minimal shape of the Sky addon's material uniforms we touch. */\ninterface SkyMaterial {\n  uniforms: {\n    turbidity: { value: number };\n    rayleigh: { value: number };\n    mieCoefficient: { value: number };\n    mieDirectionalG: { value: number };\n    sunPosition: { value: Vector3 };\n  };\n}\n\n/**\n * Owns the procedural time-of-day sky: an atmospheric dome (three's `Sky`\n * addon), a sun `DirectionalLight` riding its daily arc, a hemisphere fill, and a\n * star field that fades in at night. `setTime(hour)` drives everything; the\n * dome loads on demand (own chunk) and catches up to the latest time.\n */\nexport class SkyController {\n  private readonly scene: ThreeScene;\n  private readonly sun = new DirectionalLight(0xffffff, 0);\n  private readonly hemi = new HemisphereLight(0x88bbff, 0x5a4a36, 0);\n  private readonly stars: Points;\n  private dome: (Object3D & { material: SkyMaterial }) | null = null;\n  private def: SkyDef | null = null;\n  private time = 12;\n  private azimuth = 0;\n  private hash: string | null = null;\n\n  // Image-based lighting: a PMREM of the sky dome, regenerated (throttled) when\n  // the sky changes, so the water reflects the sky and PBR picks up its color.\n  private readonly renderer: WebGLRenderer;\n  private readonly pmrem: PMREMGenerator;\n  private envRT: WebGLRenderTarget | null = null;\n  private envDirty = false;\n  private envTimer = 0;\n\n  constructor(scene: ThreeScene, renderer: WebGLRenderer) {\n    this.scene = scene;\n    this.renderer = renderer;\n    this.pmrem = new PMREMGenerator(renderer);\n    this.sun.castShadow = true;\n    this.sun.shadow.mapSize.set(2048, 2048);\n    const cam = this.sun.shadow.camera;\n    cam.left = cam.bottom = -1500;\n    cam.right = cam.top = 1500;\n    cam.near = 1;\n    cam.far = SUN_DISTANCE * 2;\n    this.stars = this.buildStars();\n  }\n\n  reconcile(def: SkyDef | undefined): void {\n    const hash = def ? JSON.stringify(def) : null;\n    if (hash === this.hash) return;\n    this.hash = hash;\n\n    if (!def) {\n      this.clear();\n      return;\n    }\n    if (!this.def) {\n      this.scene.add(this.sun, this.sun.target, this.hemi, this.stars);\n      this.ensureDome();\n    }\n    this.def = def;\n    this.azimuth = def.azimuth ?? 0;\n    this.applyAtmosphere();\n    this.setTime(def.time ?? 12);\n  }\n\n  /** Set the hour of day (0..24) and update sun, sky, fill and stars live. */\n  setTime(hour: number): void {\n    this.time = hour;\n\n    // Sun along its arc: elevation peaks at noon, dips below at night.\n    const elevation = Math.sin(((hour - 6) / 12) * Math.PI) * MAX_ELEVATION;\n    const azimuth = 90 + ((hour - 6) / 12) * 180 + this.azimuth;\n    const dir = new Vector3().setFromSphericalCoords(\n      1,\n      MathUtils.degToRad(90 - elevation),\n      MathUtils.degToRad(azimuth),\n    );\n\n    if (this.dome) this.dome.material.uniforms.sunPosition.value.copy(dir);\n    this.sun.position.copy(dir).multiplyScalar(SUN_DISTANCE);\n\n    // Intensity/colour: bright white high up, dim warm at the horizon, off below.\n    const day = clamp01(elevation / 6);\n    this.sun.intensity = day * 3;\n    this.sun.color.copy(SUNSET).lerp(DAYLIGHT, clamp01(elevation / 20));\n    this.hemi.intensity = lerp(0.04, 0.6, clamp01((elevation + 6) / 12));\n\n    // Stars fade in once the sun is below the horizon.\n    const night = clamp01(-elevation / 6);\n    const starMat = this.stars.material as PointsMaterial;\n    starMat.opacity = night;\n    this.stars.visible = night > 0;\n\n    // Fog tinted to the sky, fading the horizon (off when density is 0).\n    const fogDensity = this.def?.fog ?? 0;\n    if (fogDensity > 0) {\n      const fog = this.scene.fog instanceof FogExp2 ? this.scene.fog : new FogExp2(0x000000, fogDensity);\n      fog.density = fogDensity;\n      fog.color.copy(NIGHT_FOG).lerp(DAY_FOG, clamp01((elevation + 4) / 16));\n      const lowSun = clamp01(1 - elevation / 12) * clamp01(elevation / 3 + 0.4);\n      fog.color.lerp(SUNSET, lowSun * 0.4);\n      this.scene.fog = fog;\n    } else if (this.scene.fog instanceof FogExp2) {\n      this.scene.fog = null;\n    }\n\n    // The sky changed; refresh the IBL (throttled in update()).\n    this.envDirty = true;\n  }\n\n  /** Current hour of day. */\n  getTime(): number {\n    return this.time;\n  }\n\n  /** Set the sun's compass offset (degrees) and re-place the sun. */\n  setAzimuth(degrees: number): void {\n    this.azimuth = degrees;\n    this.setTime(this.time);\n  }\n\n  /** Current sun compass offset (degrees). */\n  getAzimuth(): number {\n    return this.azimuth;\n  }\n\n  /** Advance throttled work (IBL regeneration). Call once per frame. */\n  update(deltaMs: number): void {\n    if (!this.envDirty || !this.dome) return;\n    this.envTimer += deltaMs;\n    if (this.envTimer < ENV_THROTTLE_MS) return;\n    this.envTimer = 0;\n    this.envDirty = false;\n    this.regenerateEnvironment();\n  }\n\n  /** Render just the dome to a PMREM and use it as the scene's IBL. */\n  private regenerateEnvironment(): void {\n    if (!this.dome) return;\n    this.scene.remove(this.dome);\n    const envScene = new Scene();\n    envScene.add(this.dome);\n    const rt = this.pmrem.fromScene(envScene);\n    envScene.remove(this.dome);\n    this.scene.add(this.dome);\n    this.envRT?.dispose();\n    this.envRT = rt;\n    this.scene.environment = rt.texture;\n  }\n\n  private applyAtmosphere(): void {\n    if (!this.dome || !this.def) return;\n    const u = this.dome.material.uniforms;\n    u.turbidity.value = this.def.turbidity ?? 4;\n    u.rayleigh.value = this.def.rayleigh ?? 2;\n    u.mieCoefficient.value = 0.005;\n    u.mieDirectionalG.value = 0.8;\n  }\n\n  private ensureDome(): void {\n    if (this.dome) return;\n    void import(\"three/examples/jsm/objects/Sky.js\").then(({ Sky }) => {\n      if (!this.def) return; // reconciled away before it loaded\n      const dome = new Sky() as unknown as Object3D & { material: SkyMaterial };\n      dome.scale.setScalar(DOME);\n      this.dome = dome;\n      this.scene.add(dome);\n      this.applyAtmosphere();\n      this.setTime(this.time);\n    });\n  }\n\n  private buildStars(): Points {\n    const positions = new Float32Array(STAR_COUNT * 3);\n    for (let i = 0; i < STAR_COUNT; i++) {\n      // Upper hemisphere shell.\n      const theta = Math.random() * Math.PI * 2;\n      const phi = Math.acos(Math.random()); // 0..90° from zenith\n      const r = DOME * 0.9;\n      positions[i * 3] = r * Math.sin(phi) * Math.cos(theta);\n      positions[i * 3 + 1] = r * Math.cos(phi);\n      positions[i * 3 + 2] = r * Math.sin(phi) * Math.sin(theta);\n    }\n    const geometry = new BufferGeometry();\n    geometry.setAttribute(\"position\", new Float32BufferAttribute(positions, 3));\n    const material = new PointsMaterial({\n      color: 0xffffff,\n      size: 12,\n      sizeAttenuation: true,\n      transparent: true,\n      opacity: 0,\n      depthWrite: false,\n    });\n    const stars = new Points(geometry, material);\n    stars.visible = false;\n    return stars;\n  }\n\n  private clear(): void {\n    if (!this.def) return;\n    this.scene.remove(this.sun, this.sun.target, this.hemi, this.stars);\n    if (this.dome) {\n      this.scene.remove(this.dome);\n      this.dome = null;\n    }\n    if (this.scene.fog instanceof FogExp2) this.scene.fog = null;\n    this.scene.environment = null;\n    this.envRT?.dispose();\n    this.envRT = null;\n    this.envDirty = false;\n    this.def = null;\n  }\n\n  dispose(): void {\n    this.clear();\n    this.stars.geometry.dispose();\n    (this.stars.material as PointsMaterial).dispose();\n    this.pmrem.dispose();\n    this.hash = null;\n  }\n}\n","import type { SkyApi, SystemPlugin } from \"@scenography/engine\";\n\nimport { SkyController } from \"./SkyController\";\n\n/**\n * Procedural time-of-day sky — a *system* plugin. It renders an atmospheric sky\n * dome, moves a sun light along its arc, fades in stars at night and drives the\n * image-based lighting, all from `scene.sky`. Exposes `ctx.sky` (setTime/…). It\n * manages its own objects, so it takes the scene graph and renderer (for IBL).\n */\nexport const sky = (): SystemPlugin<SkyApi> => ({\n  name: \"sky\",\n  setup: (ctx) => {\n    const controller = new SkyController(ctx.scene3d, ctx.renderer);\n    controller.reconcile(ctx.scene.sky);\n    return {\n      update: (deltaMs) => controller.update(deltaMs),\n      setScene: (scene) => controller.reconcile(scene.sky),\n      dispose: () => controller.dispose(),\n      api: {\n        setTime: (hour) => controller.setTime(hour),\n        getTime: () => controller.getTime(),\n        setAzimuth: (degrees) => controller.setAzimuth(degrees),\n        getAzimuth: () => controller.getAzimuth(),\n      },\n    };\n  },\n});\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,58 @@
+import { n as validateSky, r as Sky, t as skyData } from "./index-GwVhqXni.cjs";
+import { SkyApi, SystemPlugin } from "@scenography/engine";
+import { Scene, WebGLRenderer } from "three";
+
+//#region src/plugin.d.ts
+/**
+ * Procedural time-of-day sky — a *system* plugin. It renders an atmospheric sky
+ * dome, moves a sun light along its arc, fades in stars at night and drives the
+ * image-based lighting, all from `scene.sky`. Exposes `ctx.sky` (setTime/…). It
+ * manages its own objects, so it takes the scene graph and renderer (for IBL).
+ */
+declare const sky: () => SystemPlugin<SkyApi>;
+//#endregion
+//#region src/SkyController.d.ts
+/**
+ * Owns the procedural time-of-day sky: an atmospheric dome (three's `Sky`
+ * addon), a sun `DirectionalLight` riding its daily arc, a hemisphere fill, and a
+ * star field that fades in at night. `setTime(hour)` drives everything; the
+ * dome loads on demand (own chunk) and catches up to the latest time.
+ */
+declare class SkyController {
+  private readonly scene;
+  private readonly sun;
+  private readonly hemi;
+  private readonly stars;
+  private dome;
+  private def;
+  private time;
+  private azimuth;
+  private hash;
+  private readonly renderer;
+  private readonly pmrem;
+  private envRT;
+  private envDirty;
+  private envTimer;
+  constructor(scene: Scene, renderer: WebGLRenderer);
+  reconcile(def: Sky | undefined): void;
+  /** Set the hour of day (0..24) and update sun, sky, fill and stars live. */
+  setTime(hour: number): void;
+  /** Current hour of day. */
+  getTime(): number;
+  /** Set the sun's compass offset (degrees) and re-place the sun. */
+  setAzimuth(degrees: number): void;
+  /** Current sun compass offset (degrees). */
+  getAzimuth(): number;
+  /** Advance throttled work (IBL regeneration). Call once per frame. */
+  update(deltaMs: number): void;
+  /** Render just the dome to a PMREM and use it as the scene's IBL. */
+  private regenerateEnvironment;
+  private applyAtmosphere;
+  private ensureDome;
+  private buildStars;
+  private clear;
+  dispose(): void;
+}
+//#endregion
+export { type Sky, SkyController, sky, skyData, validateSky };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,58 @@
+import { n as validateSky, r as Sky, t as skyData } from "./index-GwVhqXni.mjs";
+import { Scene, WebGLRenderer } from "three";
+import { SkyApi, SystemPlugin } from "@scenography/engine";
+
+//#region src/plugin.d.ts
+/**
+ * Procedural time-of-day sky — a *system* plugin. It renders an atmospheric sky
+ * dome, moves a sun light along its arc, fades in stars at night and drives the
+ * image-based lighting, all from `scene.sky`. Exposes `ctx.sky` (setTime/…). It
+ * manages its own objects, so it takes the scene graph and renderer (for IBL).
+ */
+declare const sky: () => SystemPlugin<SkyApi>;
+//#endregion
+//#region src/SkyController.d.ts
+/**
+ * Owns the procedural time-of-day sky: an atmospheric dome (three's `Sky`
+ * addon), a sun `DirectionalLight` riding its daily arc, a hemisphere fill, and a
+ * star field that fades in at night. `setTime(hour)` drives everything; the
+ * dome loads on demand (own chunk) and catches up to the latest time.
+ */
+declare class SkyController {
+  private readonly scene;
+  private readonly sun;
+  private readonly hemi;
+  private readonly stars;
+  private dome;
+  private def;
+  private time;
+  private azimuth;
+  private hash;
+  private readonly renderer;
+  private readonly pmrem;
+  private envRT;
+  private envDirty;
+  private envTimer;
+  constructor(scene: Scene, renderer: WebGLRenderer);
+  reconcile(def: Sky | undefined): void;
+  /** Set the hour of day (0..24) and update sun, sky, fill and stars live. */
+  setTime(hour: number): void;
+  /** Current hour of day. */
+  getTime(): number;
+  /** Set the sun's compass offset (degrees) and re-place the sun. */
+  setAzimuth(degrees: number): void;
+  /** Current sun compass offset (degrees). */
+  getAzimuth(): number;
+  /** Advance throttled work (IBL regeneration). Call once per frame. */
+  update(deltaMs: number): void;
+  /** Render just the dome to a PMREM and use it as the scene's IBL. */
+  private regenerateEnvironment;
+  private applyAtmosphere;
+  private ensureDome;
+  private buildStars;
+  private clear;
+  dispose(): void;
+}
+//#endregion
+export { type Sky, SkyController, sky, skyData, validateSky };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,222 @@
+import { n as validateSky, t as skyData } from "./data-BY6HfW4z.mjs";
+import { BufferGeometry, Color, DirectionalLight, Float32BufferAttribute, FogExp2, HemisphereLight, MathUtils, PMREMGenerator, Points, PointsMaterial, Scene, Vector3 } from "three";
+//#region src/SkyController.ts
+const clamp01 = (x) => Math.min(Math.max(x, 0), 1);
+const lerp = (a, b, t) => a + (b - a) * t;
+const DOME = 4500;
+const STAR_COUNT = 1500;
+const SUN_DISTANCE = 2e3;
+const MAX_ELEVATION = 60;
+const ENV_THROTTLE_MS = 150;
+const SUNSET = new Color("#ff7a3c");
+const DAYLIGHT = new Color("#fff4e6");
+const NIGHT_FOG = new Color("#0a1222");
+const DAY_FOG = new Color("#bcd3e0");
+/**
+* Owns the procedural time-of-day sky: an atmospheric dome (three's `Sky`
+* addon), a sun `DirectionalLight` riding its daily arc, a hemisphere fill, and a
+* star field that fades in at night. `setTime(hour)` drives everything; the
+* dome loads on demand (own chunk) and catches up to the latest time.
+*/
+var SkyController = class {
+	scene;
+	sun = new DirectionalLight(16777215, 0);
+	hemi = new HemisphereLight(8961023, 5917238, 0);
+	stars;
+	dome = null;
+	def = null;
+	time = 12;
+	azimuth = 0;
+	hash = null;
+	renderer;
+	pmrem;
+	envRT = null;
+	envDirty = false;
+	envTimer = 0;
+	constructor(scene, renderer) {
+		this.scene = scene;
+		this.renderer = renderer;
+		this.pmrem = new PMREMGenerator(renderer);
+		this.sun.castShadow = true;
+		this.sun.shadow.mapSize.set(2048, 2048);
+		const cam = this.sun.shadow.camera;
+		cam.left = cam.bottom = -1500;
+		cam.right = cam.top = 1500;
+		cam.near = 1;
+		cam.far = SUN_DISTANCE * 2;
+		this.stars = this.buildStars();
+	}
+	reconcile(def) {
+		const hash = def ? JSON.stringify(def) : null;
+		if (hash === this.hash) return;
+		this.hash = hash;
+		if (!def) {
+			this.clear();
+			return;
+		}
+		if (!this.def) {
+			this.scene.add(this.sun, this.sun.target, this.hemi, this.stars);
+			this.ensureDome();
+		}
+		this.def = def;
+		this.azimuth = def.azimuth ?? 0;
+		this.applyAtmosphere();
+		this.setTime(def.time ?? 12);
+	}
+	/** Set the hour of day (0..24) and update sun, sky, fill and stars live. */
+	setTime(hour) {
+		this.time = hour;
+		const elevation = Math.sin((hour - 6) / 12 * Math.PI) * MAX_ELEVATION;
+		const azimuth = 90 + (hour - 6) / 12 * 180 + this.azimuth;
+		const dir = new Vector3().setFromSphericalCoords(1, MathUtils.degToRad(90 - elevation), MathUtils.degToRad(azimuth));
+		if (this.dome) this.dome.material.uniforms.sunPosition.value.copy(dir);
+		this.sun.position.copy(dir).multiplyScalar(SUN_DISTANCE);
+		const day = clamp01(elevation / 6);
+		this.sun.intensity = day * 3;
+		this.sun.color.copy(SUNSET).lerp(DAYLIGHT, clamp01(elevation / 20));
+		this.hemi.intensity = lerp(.04, .6, clamp01((elevation + 6) / 12));
+		const night = clamp01(-elevation / 6);
+		const starMat = this.stars.material;
+		starMat.opacity = night;
+		this.stars.visible = night > 0;
+		const fogDensity = this.def?.fog ?? 0;
+		if (fogDensity > 0) {
+			const fog = this.scene.fog instanceof FogExp2 ? this.scene.fog : new FogExp2(0, fogDensity);
+			fog.density = fogDensity;
+			fog.color.copy(NIGHT_FOG).lerp(DAY_FOG, clamp01((elevation + 4) / 16));
+			const lowSun = clamp01(1 - elevation / 12) * clamp01(elevation / 3 + .4);
+			fog.color.lerp(SUNSET, lowSun * .4);
+			this.scene.fog = fog;
+		} else if (this.scene.fog instanceof FogExp2) this.scene.fog = null;
+		this.envDirty = true;
+	}
+	/** Current hour of day. */
+	getTime() {
+		return this.time;
+	}
+	/** Set the sun's compass offset (degrees) and re-place the sun. */
+	setAzimuth(degrees) {
+		this.azimuth = degrees;
+		this.setTime(this.time);
+	}
+	/** Current sun compass offset (degrees). */
+	getAzimuth() {
+		return this.azimuth;
+	}
+	/** Advance throttled work (IBL regeneration). Call once per frame. */
+	update(deltaMs) {
+		if (!this.envDirty || !this.dome) return;
+		this.envTimer += deltaMs;
+		if (this.envTimer < ENV_THROTTLE_MS) return;
+		this.envTimer = 0;
+		this.envDirty = false;
+		this.regenerateEnvironment();
+	}
+	/** Render just the dome to a PMREM and use it as the scene's IBL. */
+	regenerateEnvironment() {
+		if (!this.dome) return;
+		this.scene.remove(this.dome);
+		const envScene = new Scene();
+		envScene.add(this.dome);
+		const rt = this.pmrem.fromScene(envScene);
+		envScene.remove(this.dome);
+		this.scene.add(this.dome);
+		this.envRT?.dispose();
+		this.envRT = rt;
+		this.scene.environment = rt.texture;
+	}
+	applyAtmosphere() {
+		if (!this.dome || !this.def) return;
+		const u = this.dome.material.uniforms;
+		u.turbidity.value = this.def.turbidity ?? 4;
+		u.rayleigh.value = this.def.rayleigh ?? 2;
+		u.mieCoefficient.value = .005;
+		u.mieDirectionalG.value = .8;
+	}
+	ensureDome() {
+		if (this.dome) return;
+		import("three/examples/jsm/objects/Sky.js").then(({ Sky }) => {
+			if (!this.def) return;
+			const dome = new Sky();
+			dome.scale.setScalar(DOME);
+			this.dome = dome;
+			this.scene.add(dome);
+			this.applyAtmosphere();
+			this.setTime(this.time);
+		});
+	}
+	buildStars() {
+		const positions = new Float32Array(STAR_COUNT * 3);
+		for (let i = 0; i < STAR_COUNT; i++) {
+			const theta = Math.random() * Math.PI * 2;
+			const phi = Math.acos(Math.random());
+			const r = DOME * .9;
+			positions[i * 3] = r * Math.sin(phi) * Math.cos(theta);
+			positions[i * 3 + 1] = r * Math.cos(phi);
+			positions[i * 3 + 2] = r * Math.sin(phi) * Math.sin(theta);
+		}
+		const geometry = new BufferGeometry();
+		geometry.setAttribute("position", new Float32BufferAttribute(positions, 3));
+		const stars = new Points(geometry, new PointsMaterial({
+			color: 16777215,
+			size: 12,
+			sizeAttenuation: true,
+			transparent: true,
+			opacity: 0,
+			depthWrite: false
+		}));
+		stars.visible = false;
+		return stars;
+	}
+	clear() {
+		if (!this.def) return;
+		this.scene.remove(this.sun, this.sun.target, this.hemi, this.stars);
+		if (this.dome) {
+			this.scene.remove(this.dome);
+			this.dome = null;
+		}
+		if (this.scene.fog instanceof FogExp2) this.scene.fog = null;
+		this.scene.environment = null;
+		this.envRT?.dispose();
+		this.envRT = null;
+		this.envDirty = false;
+		this.def = null;
+	}
+	dispose() {
+		this.clear();
+		this.stars.geometry.dispose();
+		this.stars.material.dispose();
+		this.pmrem.dispose();
+		this.hash = null;
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* Procedural time-of-day sky — a *system* plugin. It renders an atmospheric sky
+* dome, moves a sun light along its arc, fades in stars at night and drives the
+* image-based lighting, all from `scene.sky`. Exposes `ctx.sky` (setTime/…). It
+* manages its own objects, so it takes the scene graph and renderer (for IBL).
+*/
+const sky = () => ({
+	name: "sky",
+	setup: (ctx) => {
+		const controller = new SkyController(ctx.scene3d, ctx.renderer);
+		controller.reconcile(ctx.scene.sky);
+		return {
+			update: (deltaMs) => controller.update(deltaMs),
+			setScene: (scene) => controller.reconcile(scene.sky),
+			dispose: () => controller.dispose(),
+			api: {
+				setTime: (hour) => controller.setTime(hour),
+				getTime: () => controller.getTime(),
+				setAzimuth: (degrees) => controller.setAzimuth(degrees),
+				getAzimuth: () => controller.getAzimuth()
+			}
+		};
+	}
+});
+//#endregion
+export { SkyController, sky, skyData, validateSky };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/SkyController.ts","../src/plugin.ts"],"sourcesContent":["import {\n  BufferGeometry,\n  Color,\n  DirectionalLight,\n  Float32BufferAttribute,\n  FogExp2,\n  HemisphereLight,\n  MathUtils,\n  PMREMGenerator,\n  Points,\n  PointsMaterial,\n  Scene,\n  Vector3,\n  type Object3D,\n  type Scene as ThreeScene,\n  type WebGLRenderer,\n  type WebGLRenderTarget,\n} from \"three\";\nimport type { Sky as SkyDef } from \"./data\";\n\nconst clamp01 = (x: number): number => Math.min(Math.max(x, 0), 1);\nconst lerp = (a: number, b: number, t: number): number => a + (b - a) * t;\n\n// Sky dome radius (within the camera far plane) and star shell radius.\nconst DOME = 4500;\nconst STAR_COUNT = 1500;\nconst SUN_DISTANCE = 2000;\nconst MAX_ELEVATION = 60; // noon sun angle (less than zenith for longer shadows)\nconst ENV_THROTTLE_MS = 150; // min gap between IBL regenerations\n\nconst SUNSET = new Color(\"#ff7a3c\");\nconst DAYLIGHT = new Color(\"#fff4e6\");\nconst NIGHT_FOG = new Color(\"#0a1222\");\nconst DAY_FOG = new Color(\"#bcd3e0\");\n\n/** Minimal shape of the Sky addon's material uniforms we touch. */\ninterface SkyMaterial {\n  uniforms: {\n    turbidity: { value: number };\n    rayleigh: { value: number };\n    mieCoefficient: { value: number };\n    mieDirectionalG: { value: number };\n    sunPosition: { value: Vector3 };\n  };\n}\n\n/**\n * Owns the procedural time-of-day sky: an atmospheric dome (three's `Sky`\n * addon), a sun `DirectionalLight` riding its daily arc, a hemisphere fill, and a\n * star field that fades in at night. `setTime(hour)` drives everything; the\n * dome loads on demand (own chunk) and catches up to the latest time.\n */\nexport class SkyController {\n  private readonly scene: ThreeScene;\n  private readonly sun = new DirectionalLight(0xffffff, 0);\n  private readonly hemi = new HemisphereLight(0x88bbff, 0x5a4a36, 0);\n  private readonly stars: Points;\n  private dome: (Object3D & { material: SkyMaterial }) | null = null;\n  private def: SkyDef | null = null;\n  private time = 12;\n  private azimuth = 0;\n  private hash: string | null = null;\n\n  // Image-based lighting: a PMREM of the sky dome, regenerated (throttled) when\n  // the sky changes, so the water reflects the sky and PBR picks up its color.\n  private readonly renderer: WebGLRenderer;\n  private readonly pmrem: PMREMGenerator;\n  private envRT: WebGLRenderTarget | null = null;\n  private envDirty = false;\n  private envTimer = 0;\n\n  constructor(scene: ThreeScene, renderer: WebGLRenderer) {\n    this.scene = scene;\n    this.renderer = renderer;\n    this.pmrem = new PMREMGenerator(renderer);\n    this.sun.castShadow = true;\n    this.sun.shadow.mapSize.set(2048, 2048);\n    const cam = this.sun.shadow.camera;\n    cam.left = cam.bottom = -1500;\n    cam.right = cam.top = 1500;\n    cam.near = 1;\n    cam.far = SUN_DISTANCE * 2;\n    this.stars = this.buildStars();\n  }\n\n  reconcile(def: SkyDef | undefined): void {\n    const hash = def ? JSON.stringify(def) : null;\n    if (hash === this.hash) return;\n    this.hash = hash;\n\n    if (!def) {\n      this.clear();\n      return;\n    }\n    if (!this.def) {\n      this.scene.add(this.sun, this.sun.target, this.hemi, this.stars);\n      this.ensureDome();\n    }\n    this.def = def;\n    this.azimuth = def.azimuth ?? 0;\n    this.applyAtmosphere();\n    this.setTime(def.time ?? 12);\n  }\n\n  /** Set the hour of day (0..24) and update sun, sky, fill and stars live. */\n  setTime(hour: number): void {\n    this.time = hour;\n\n    // Sun along its arc: elevation peaks at noon, dips below at night.\n    const elevation = Math.sin(((hour - 6) / 12) * Math.PI) * MAX_ELEVATION;\n    const azimuth = 90 + ((hour - 6) / 12) * 180 + this.azimuth;\n    const dir = new Vector3().setFromSphericalCoords(\n      1,\n      MathUtils.degToRad(90 - elevation),\n      MathUtils.degToRad(azimuth),\n    );\n\n    if (this.dome) this.dome.material.uniforms.sunPosition.value.copy(dir);\n    this.sun.position.copy(dir).multiplyScalar(SUN_DISTANCE);\n\n    // Intensity/colour: bright white high up, dim warm at the horizon, off below.\n    const day = clamp01(elevation / 6);\n    this.sun.intensity = day * 3;\n    this.sun.color.copy(SUNSET).lerp(DAYLIGHT, clamp01(elevation / 20));\n    this.hemi.intensity = lerp(0.04, 0.6, clamp01((elevation + 6) / 12));\n\n    // Stars fade in once the sun is below the horizon.\n    const night = clamp01(-elevation / 6);\n    const starMat = this.stars.material as PointsMaterial;\n    starMat.opacity = night;\n    this.stars.visible = night > 0;\n\n    // Fog tinted to the sky, fading the horizon (off when density is 0).\n    const fogDensity = this.def?.fog ?? 0;\n    if (fogDensity > 0) {\n      const fog = this.scene.fog instanceof FogExp2 ? this.scene.fog : new FogExp2(0x000000, fogDensity);\n      fog.density = fogDensity;\n      fog.color.copy(NIGHT_FOG).lerp(DAY_FOG, clamp01((elevation + 4) / 16));\n      const lowSun = clamp01(1 - elevation / 12) * clamp01(elevation / 3 + 0.4);\n      fog.color.lerp(SUNSET, lowSun * 0.4);\n      this.scene.fog = fog;\n    } else if (this.scene.fog instanceof FogExp2) {\n      this.scene.fog = null;\n    }\n\n    // The sky changed; refresh the IBL (throttled in update()).\n    this.envDirty = true;\n  }\n\n  /** Current hour of day. */\n  getTime(): number {\n    return this.time;\n  }\n\n  /** Set the sun's compass offset (degrees) and re-place the sun. */\n  setAzimuth(degrees: number): void {\n    this.azimuth = degrees;\n    this.setTime(this.time);\n  }\n\n  /** Current sun compass offset (degrees). */\n  getAzimuth(): number {\n    return this.azimuth;\n  }\n\n  /** Advance throttled work (IBL regeneration). Call once per frame. */\n  update(deltaMs: number): void {\n    if (!this.envDirty || !this.dome) return;\n    this.envTimer += deltaMs;\n    if (this.envTimer < ENV_THROTTLE_MS) return;\n    this.envTimer = 0;\n    this.envDirty = false;\n    this.regenerateEnvironment();\n  }\n\n  /** Render just the dome to a PMREM and use it as the scene's IBL. */\n  private regenerateEnvironment(): void {\n    if (!this.dome) return;\n    this.scene.remove(this.dome);\n    const envScene = new Scene();\n    envScene.add(this.dome);\n    const rt = this.pmrem.fromScene(envScene);\n    envScene.remove(this.dome);\n    this.scene.add(this.dome);\n    this.envRT?.dispose();\n    this.envRT = rt;\n    this.scene.environment = rt.texture;\n  }\n\n  private applyAtmosphere(): void {\n    if (!this.dome || !this.def) return;\n    const u = this.dome.material.uniforms;\n    u.turbidity.value = this.def.turbidity ?? 4;\n    u.rayleigh.value = this.def.rayleigh ?? 2;\n    u.mieCoefficient.value = 0.005;\n    u.mieDirectionalG.value = 0.8;\n  }\n\n  private ensureDome(): void {\n    if (this.dome) return;\n    void import(\"three/examples/jsm/objects/Sky.js\").then(({ Sky }) => {\n      if (!this.def) return; // reconciled away before it loaded\n      const dome = new Sky() as unknown as Object3D & { material: SkyMaterial };\n      dome.scale.setScalar(DOME);\n      this.dome = dome;\n      this.scene.add(dome);\n      this.applyAtmosphere();\n      this.setTime(this.time);\n    });\n  }\n\n  private buildStars(): Points {\n    const positions = new Float32Array(STAR_COUNT * 3);\n    for (let i = 0; i < STAR_COUNT; i++) {\n      // Upper hemisphere shell.\n      const theta = Math.random() * Math.PI * 2;\n      const phi = Math.acos(Math.random()); // 0..90° from zenith\n      const r = DOME * 0.9;\n      positions[i * 3] = r * Math.sin(phi) * Math.cos(theta);\n      positions[i * 3 + 1] = r * Math.cos(phi);\n      positions[i * 3 + 2] = r * Math.sin(phi) * Math.sin(theta);\n    }\n    const geometry = new BufferGeometry();\n    geometry.setAttribute(\"position\", new Float32BufferAttribute(positions, 3));\n    const material = new PointsMaterial({\n      color: 0xffffff,\n      size: 12,\n      sizeAttenuation: true,\n      transparent: true,\n      opacity: 0,\n      depthWrite: false,\n    });\n    const stars = new Points(geometry, material);\n    stars.visible = false;\n    return stars;\n  }\n\n  private clear(): void {\n    if (!this.def) return;\n    this.scene.remove(this.sun, this.sun.target, this.hemi, this.stars);\n    if (this.dome) {\n      this.scene.remove(this.dome);\n      this.dome = null;\n    }\n    if (this.scene.fog instanceof FogExp2) this.scene.fog = null;\n    this.scene.environment = null;\n    this.envRT?.dispose();\n    this.envRT = null;\n    this.envDirty = false;\n    this.def = null;\n  }\n\n  dispose(): void {\n    this.clear();\n    this.stars.geometry.dispose();\n    (this.stars.material as PointsMaterial).dispose();\n    this.pmrem.dispose();\n    this.hash = null;\n  }\n}\n","import type { SkyApi, SystemPlugin } from \"@scenography/engine\";\n\nimport { SkyController } from \"./SkyController\";\n\n/**\n * Procedural time-of-day sky — a *system* plugin. It renders an atmospheric sky\n * dome, moves a sun light along its arc, fades in stars at night and drives the\n * image-based lighting, all from `scene.sky`. Exposes `ctx.sky` (setTime/…). It\n * manages its own objects, so it takes the scene graph and renderer (for IBL).\n */\nexport const sky = (): SystemPlugin<SkyApi> => ({\n  name: \"sky\",\n  setup: (ctx) => {\n    const controller = new SkyController(ctx.scene3d, ctx.renderer);\n    controller.reconcile(ctx.scene.sky);\n    return {\n      update: (deltaMs) => controller.update(deltaMs),\n      setScene: (scene) => controller.reconcile(scene.sky),\n      dispose: () => controller.dispose(),\n      api: {\n        setTime: (hour) => controller.setTime(hour),\n        getTime: () => controller.getTime(),\n        setAzimuth: (degrees) => controller.setAzimuth(degrees),\n        getAzimuth: () => controller.getAzimuth(),\n      },\n    };\n  },\n});\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@scenography/plugin-sky",
+  "version": "0.2.0",
+  "description": "Sky plugin for scenography: procedural time-of-day sky (sun, atmosphere, stars, IBL) with ctx.sky runtime control.",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./data": {
+      "import": {
+        "types": "./dist/data.d.mts",
+        "default": "./dist/data.mjs"
+      },
+      "require": {
+        "types": "./dist/data.d.cts",
+        "default": "./dist/data.cjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@scenography/scene": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.160.0",
+    "three": "^0.160.0",
+    "@scenography/engine": "0.2.0"
+  },
+  "peerDependencies": {
+    "three": ">=0.160.0",
+    "@scenography/engine": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}