@scenography/plugin-floor 0.2.0

package/dist/data-BgdlM_kL.cjs

@@ -0,0 +1,38 @@
+let _scenography_scene = require("@scenography/scene");
+//#region src/data/validate.ts
+const validateFloor = (floor) => (0, _scenography_scene.validate)([
+	(0, _scenography_scene.existsProp)("size", "Floor is missing a size."),
+	(0, _scenography_scene.propIs)("size", _scenography_scene.isVec2, "size must be [width, depth]."),
+	(0, _scenography_scene.propIs)("center", _scenography_scene.isVec2, "center must be [x, z]."),
+	(0, _scenography_scene.propIs)("y", _scenography_scene.isFiniteNumber, "y must be a finite number."),
+	(0, _scenography_scene.propIs)("heightScale", _scenography_scene.isFiniteNumber, "heightScale must be a finite number."),
+	(0, _scenography_scene.propIs)("segments", (v) => (0, _scenography_scene.isIntegerNumber)(v) && v >= 1, "segments must be a positive integer."),
+	(0, _scenography_scene.nested)("texture", _scenography_scene.validateTexture)
+])(floor);
+//#endregion
+//#region src/data/plugin.ts
+/**
+* The data half of the floor plugin: owns the `floor` scene key (a singleton)
+* and validates it. Pure — no three.js. Pass it to `defineScene` so scenes with
+* a floor validate without loading the runtime.
+*/
+const floorData = {
+	kind: "floor",
+	cardinality: "single",
+	validate: (floor) => validateFloor(floor)
+};
+//#endregion
+Object.defineProperty(exports, "floorData", {
+	enumerable: true,
+	get: function() {
+		return floorData;
+	}
+});
+Object.defineProperty(exports, "validateFloor", {
+	enumerable: true,
+	get: function() {
+		return validateFloor;
+	}
+});
+
+//# sourceMappingURL=data-BgdlM_kL.cjs.map

package/dist/data-BgdlM_kL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-BgdlM_kL.cjs","names":["isVec2","isFiniteNumber","validateTexture"],"sources":["../src/data/validate.ts","../src/data/plugin.ts"],"sourcesContent":["import {\n  existsProp,\n  isFiniteNumber,\n  isIntegerNumber,\n  isVec2,\n  nested,\n  propIs,\n  validate,\n  validateTexture,\n  type ValidationResult,\n} from \"@scenography/scene\";\n\nimport type { Floor } from \"./floor\";\n\nexport const validateFloor = (floor: Floor): ValidationResult =>\n  validate<Floor>([\n    existsProp(\"size\", \"Floor is missing a size.\"),\n    propIs(\"size\", isVec2, \"size must be [width, depth].\"),\n    propIs(\"center\", isVec2, \"center must be [x, z].\"),\n    propIs(\"y\", isFiniteNumber, \"y must be a finite number.\"),\n    propIs(\"heightScale\", isFiniteNumber, \"heightScale must be a finite number.\"),\n    propIs(\n      \"segments\",\n      (v) => isIntegerNumber(v) && v >= 1,\n      \"segments must be a positive integer.\",\n    ),\n    nested(\"texture\", validateTexture),\n  ])(floor);\n","import type { DataPlugin } from \"@scenography/scene\";\n\nimport { validateFloor } from \"./validate\";\nimport type { Floor } from \"./floor\";\n\n/**\n * The data half of the floor plugin: owns the `floor` scene key (a singleton)\n * and validates it. Pure — no three.js. Pass it to `defineScene` so scenes with\n * a floor validate without loading the runtime.\n */\nexport const floorData: DataPlugin<Floor> = {\n  kind: \"floor\",\n  cardinality: \"single\",\n  validate: (floor) => validateFloor(floor),\n};\n"],"mappings":";;AAcA,MAAa,iBAAiB,WAAA,GAAA,mBAAA,SAAA,CACZ;oCACH,QAAQ,0BAA0B;gCACtC,QAAQA,mBAAAA,QAAQ,8BAA8B;gCAC9C,UAAUA,mBAAAA,QAAQ,wBAAwB;gCAC1C,KAAKC,mBAAAA,gBAAgB,4BAA4B;gCACjD,eAAeA,mBAAAA,gBAAgB,sCAAsC;gCAE1E,aACC,OAAA,GAAA,mBAAA,gBAAA,CAAsB,CAAC,KAAK,KAAK,GAClC,sCACF;gCACO,WAAWC,mBAAAA,eAAe;AACnC,CAAC,CAAC,CAAC,KAAK;;;;;;;;ACjBV,MAAa,YAA+B;CAC1C,MAAM;CACN,aAAa;CACb,WAAW,UAAU,cAAc,KAAK;AAC1C"}

package/dist/data-CTGlghAE.mjs

@@ -0,0 +1,27 @@
+import { existsProp, isFiniteNumber, isIntegerNumber, isVec2, nested, propIs, validate, validateTexture } from "@scenography/scene";
+//#region src/data/validate.ts
+const validateFloor = (floor) => validate([
+	existsProp("size", "Floor is missing a size."),
+	propIs("size", isVec2, "size must be [width, depth]."),
+	propIs("center", isVec2, "center must be [x, z]."),
+	propIs("y", isFiniteNumber, "y must be a finite number."),
+	propIs("heightScale", isFiniteNumber, "heightScale must be a finite number."),
+	propIs("segments", (v) => isIntegerNumber(v) && v >= 1, "segments must be a positive integer."),
+	nested("texture", validateTexture)
+])(floor);
+//#endregion
+//#region src/data/plugin.ts
+/**
+* The data half of the floor plugin: owns the `floor` scene key (a singleton)
+* and validates it. Pure — no three.js. Pass it to `defineScene` so scenes with
+* a floor validate without loading the runtime.
+*/
+const floorData = {
+	kind: "floor",
+	cardinality: "single",
+	validate: (floor) => validateFloor(floor)
+};
+//#endregion
+export { validateFloor as n, floorData as t };
+
+//# sourceMappingURL=data-CTGlghAE.mjs.map

package/dist/data-CTGlghAE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-CTGlghAE.mjs","names":[],"sources":["../src/data/validate.ts","../src/data/plugin.ts"],"sourcesContent":["import {\n  existsProp,\n  isFiniteNumber,\n  isIntegerNumber,\n  isVec2,\n  nested,\n  propIs,\n  validate,\n  validateTexture,\n  type ValidationResult,\n} from \"@scenography/scene\";\n\nimport type { Floor } from \"./floor\";\n\nexport const validateFloor = (floor: Floor): ValidationResult =>\n  validate<Floor>([\n    existsProp(\"size\", \"Floor is missing a size.\"),\n    propIs(\"size\", isVec2, \"size must be [width, depth].\"),\n    propIs(\"center\", isVec2, \"center must be [x, z].\"),\n    propIs(\"y\", isFiniteNumber, \"y must be a finite number.\"),\n    propIs(\"heightScale\", isFiniteNumber, \"heightScale must be a finite number.\"),\n    propIs(\n      \"segments\",\n      (v) => isIntegerNumber(v) && v >= 1,\n      \"segments must be a positive integer.\",\n    ),\n    nested(\"texture\", validateTexture),\n  ])(floor);\n","import type { DataPlugin } from \"@scenography/scene\";\n\nimport { validateFloor } from \"./validate\";\nimport type { Floor } from \"./floor\";\n\n/**\n * The data half of the floor plugin: owns the `floor` scene key (a singleton)\n * and validates it. Pure — no three.js. Pass it to `defineScene` so scenes with\n * a floor validate without loading the runtime.\n */\nexport const floorData: DataPlugin<Floor> = {\n  kind: \"floor\",\n  cardinality: \"single\",\n  validate: (floor) => validateFloor(floor),\n};\n"],"mappings":";;AAcA,MAAa,iBAAiB,UAC5B,SAAgB;CACd,WAAW,QAAQ,0BAA0B;CAC7C,OAAO,QAAQ,QAAQ,8BAA8B;CACrD,OAAO,UAAU,QAAQ,wBAAwB;CACjD,OAAO,KAAK,gBAAgB,4BAA4B;CACxD,OAAO,eAAe,gBAAgB,sCAAsC;CAC5E,OACE,aACC,MAAM,gBAAgB,CAAC,KAAK,KAAK,GAClC,sCACF;CACA,OAAO,WAAW,eAAe;AACnC,CAAC,CAAC,CAAC,KAAK;;;;;;;;ACjBV,MAAa,YAA+B;CAC1C,MAAM;CACN,aAAa;CACb,WAAW,UAAU,cAAc,KAAK;AAC1C"}

package/dist/data.cjs

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

package/dist/data.d.cts

@@ -0,0 +1,2 @@
+import { n as validateFloor, r as Floor, t as floorData } from "./index-1ydrP4eD.cjs";
+export { type Floor, floorData, validateFloor };

package/dist/data.d.mts

@@ -0,0 +1,2 @@
+import { n as validateFloor, r as Floor, t as floorData } from "./index-1ydrP4eD.mjs";
+export { type Floor, floorData, validateFloor };

package/dist/data.mjs

@@ -0,0 +1,2 @@
+import { n as validateFloor, t as floorData } from "./data-CTGlghAE.mjs";
+export { floorData, validateFloor };

package/dist/index-1ydrP4eD.d.cts

@@ -0,0 +1,52 @@
+import { DataPlugin, SurfaceTexture, ValidationResult, Vec2 } from "@scenography/scene";
+
+//#region src/data/floor.d.ts
+/**
+ * The gallery floor: a rectangular ground plane, optionally displaced into
+ * relief by a heightmap. A minimal scene can omit it; when present the engine
+ * lays it at `y` and the visitor walks over it, following its height.
+ */
+interface Floor {
+  /** Extent on the ground plane, `[width (x), depth (z)]` in world units. */
+  size: Vec2;
+  /** Center on the ground plane `[x, z]`. Defaults to `[0, 0]`. */
+  center?: Vec2;
+  /** Base vertical position (world Y). Defaults to `0`. */
+  y?: number;
+  /**
+   * Grayscale heightmap URL that displaces the whole ground (distinct from the
+   * tiling `texture`): paint dunes, a shoreline berm, a gentle grade toward
+   * water. Black = `0`, white = `heightScale`, so height at `(x, z)` is
+   * `y + sample(x, z)·heightScale`. The visitor follows it and a waterline
+   * becomes an irregular contour instead of a straight cut.
+   */
+  heightmap?: string;
+  /** Max displacement (world units) at white in the heightmap. Default `0`. */
+  heightScale?: number;
+  /** Grid resolution the ground is tessellated into for displacement. Default `200`. */
+  segments?: number;
+  /** CSS-style color. Tints the texture when both are set. Defaults to white. */
+  color?: string;
+  /** Image/PBR maps mapped onto the surface. */
+  texture?: SurfaceTexture;
+}
+declare module "@scenography/scene" {
+  interface Scene {
+    /** The gallery floor — provided by `@scenography/plugin-floor`. */
+    floor?: Floor;
+  }
+}
+//#endregion
+//#region src/data/validate.d.ts
+declare const validateFloor: (floor: Floor) => ValidationResult;
+//#endregion
+//#region src/data/plugin.d.ts
+/**
+ * The data half of the floor plugin: owns the `floor` scene key (a singleton)
+ * and validates it. Pure — no three.js. Pass it to `defineScene` so scenes with
+ * a floor validate without loading the runtime.
+ */
+declare const floorData: DataPlugin<Floor>;
+//#endregion
+export { validateFloor as n, Floor as r, floorData as t };
+//# sourceMappingURL=index-1ydrP4eD.d.cts.map

package/dist/index-1ydrP4eD.d.mts

@@ -0,0 +1,52 @@
+import { DataPlugin, SurfaceTexture, ValidationResult, Vec2 } from "@scenography/scene";
+
+//#region src/data/floor.d.ts
+/**
+ * The gallery floor: a rectangular ground plane, optionally displaced into
+ * relief by a heightmap. A minimal scene can omit it; when present the engine
+ * lays it at `y` and the visitor walks over it, following its height.
+ */
+interface Floor {
+  /** Extent on the ground plane, `[width (x), depth (z)]` in world units. */
+  size: Vec2;
+  /** Center on the ground plane `[x, z]`. Defaults to `[0, 0]`. */
+  center?: Vec2;
+  /** Base vertical position (world Y). Defaults to `0`. */
+  y?: number;
+  /**
+   * Grayscale heightmap URL that displaces the whole ground (distinct from the
+   * tiling `texture`): paint dunes, a shoreline berm, a gentle grade toward
+   * water. Black = `0`, white = `heightScale`, so height at `(x, z)` is
+   * `y + sample(x, z)·heightScale`. The visitor follows it and a waterline
+   * becomes an irregular contour instead of a straight cut.
+   */
+  heightmap?: string;
+  /** Max displacement (world units) at white in the heightmap. Default `0`. */
+  heightScale?: number;
+  /** Grid resolution the ground is tessellated into for displacement. Default `200`. */
+  segments?: number;
+  /** CSS-style color. Tints the texture when both are set. Defaults to white. */
+  color?: string;
+  /** Image/PBR maps mapped onto the surface. */
+  texture?: SurfaceTexture;
+}
+declare module "@scenography/scene" {
+  interface Scene {
+    /** The gallery floor — provided by `@scenography/plugin-floor`. */
+    floor?: Floor;
+  }
+}
+//#endregion
+//#region src/data/validate.d.ts
+declare const validateFloor: (floor: Floor) => ValidationResult;
+//#endregion
+//#region src/data/plugin.d.ts
+/**
+ * The data half of the floor plugin: owns the `floor` scene key (a singleton)
+ * and validates it. Pure — no three.js. Pass it to `defineScene` so scenes with
+ * a floor validate without loading the runtime.
+ */
+declare const floorData: DataPlugin<Floor>;
+//#endregion
+export { validateFloor as n, Floor as r, floorData as t };
+//# sourceMappingURL=index-1ydrP4eD.d.mts.map

package/dist/index.cjs

@@ -0,0 +1,142 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_data = require("./data-BgdlM_kL.cjs");
+let _scenography_engine = require("@scenography/engine");
+let three = require("three");
+//#region src/buildFloor.ts
+/** Bilinear sample of a height field at UV `[0,1]`; `0` until the image loads. */
+function sampleField(field, u, v) {
+	const { data, w, h } = field;
+	if (!data) return 0;
+	const x = Math.min(Math.max(u, 0), 1) * (w - 1);
+	const y = Math.min(Math.max(v, 0), 1) * (h - 1);
+	const x0 = Math.floor(x);
+	const y0 = Math.floor(y);
+	const x1 = Math.min(x0 + 1, w - 1);
+	const y1 = Math.min(y0 + 1, h - 1);
+	const fx = x - x0;
+	const fy = y - y0;
+	const a = data[y0 * w + x0] ?? 0;
+	const b = data[y0 * w + x1] ?? 0;
+	const c = data[y1 * w + x0] ?? 0;
+	const d = data[y1 * w + x1] ?? 0;
+	return (a * (1 - fx) + b * fx) * (1 - fy) + (c * (1 - fx) + d * fx) * fy;
+}
+/** Map world `(x, z)` to heightmap UV for a floor (matches the plane orientation). */
+const floorUV = (floor, x, z) => {
+	const [w, d] = floor.size;
+	const [cx, cz] = floor.center ?? [0, 0];
+	return [(x - cx + w / 2) / w, (cz - z + d / 2) / d];
+};
+/** Ground height at `(x, z)`: base `y` + heightmap displacement. */
+function heightAtWith(floor, field) {
+	const base = floor.y ?? 0;
+	const scale = floor.heightScale ?? 0;
+	if (scale === 0) return () => base;
+	return (x, z) => {
+		const [u, v] = floorUV(floor, x, z);
+		return base + sampleField(field, u, v) * scale;
+	};
+}
+/**
+* Build the three.js object for a `Floor`: a plane at `y`, centered on `center`,
+* and (when a `heightmap` is given) displaced into dunes/berms by sampling that
+* grayscale image. `size` is `[width (x), depth (z)]`. Returns the mesh plus a
+* `heightAt(x, z)` the camera controls use to follow the terrain.
+*/
+function buildFloor(floor) {
+	const [width, depth] = floor.size;
+	const [cx, cz] = floor.center ?? [0, 0];
+	const segments = floor.heightmap ? floor.segments ?? 200 : 1;
+	const material = new three.MeshStandardMaterial({ color: floor.color ?? "#ffffff" });
+	const needsUv1 = floor.texture ? (0, _scenography_engine.applyTexture)(material, floor.texture) : false;
+	const geometry = new three.PlaneGeometry(width, depth, segments, segments);
+	if (needsUv1) {
+		const uv = geometry.getAttribute("uv");
+		if (uv) geometry.setAttribute("uv1", uv);
+	}
+	const field = {
+		data: null,
+		w: 0,
+		h: 0
+	};
+	const scale = floor.heightScale ?? 0;
+	const pos = geometry.getAttribute("position");
+	const applyHeights = () => {
+		if (!pos || !field.data || scale === 0) return;
+		for (let i = 0; i < pos.count; i++) {
+			const px = pos.getX(i);
+			const py = pos.getY(i);
+			const u = (px + width / 2) / width;
+			const v = (py + depth / 2) / depth;
+			pos.setZ(i, sampleField(field, u, v) * scale);
+		}
+		pos.needsUpdate = true;
+		geometry.computeVertexNormals();
+	};
+	const mesh = new three.Mesh(geometry, material);
+	mesh.rotation.x = -Math.PI / 2;
+	mesh.position.set(cx, floor.y ?? 0, cz);
+	mesh.receiveShadow = true;
+	mesh.name = "floor";
+	let ready = Promise.resolve();
+	const src = floor.heightmap;
+	if (src && scale !== 0) ready = new Promise((resolve) => {
+		const img = new Image();
+		img.crossOrigin = "anonymous";
+		img.onload = () => {
+			const canvas = document.createElement("canvas");
+			canvas.width = img.naturalWidth;
+			canvas.height = img.naturalHeight;
+			const ctx = canvas.getContext("2d");
+			if (ctx) {
+				ctx.drawImage(img, 0, 0);
+				const { data } = ctx.getImageData(0, 0, canvas.width, canvas.height);
+				const heights = new Float32Array(canvas.width * canvas.height);
+				for (let i = 0; i < heights.length; i++) heights[i] = (data[i * 4] ?? 0) / 255;
+				field.data = heights;
+				field.w = canvas.width;
+				field.h = canvas.height;
+				applyHeights();
+			}
+			resolve();
+		};
+		img.onerror = () => resolve();
+		img.src = src;
+	});
+	return {
+		object: mesh,
+		heightAt: heightAtWith(floor, field),
+		ready
+	};
+}
+//#endregion
+//#region src/plugin.ts
+/**
+* The floor plugin: lays the ground plane (displaced by a heightmap when given)
+* and publishes the `terrain` capability — the live height function the camera
+* follows and the definition the water shader samples. Rebuilds revoke and
+* re-provide terrain, so consumers (`dependsOn: [TERRAIN]`) refresh in step.
+*/
+const floor = () => ({
+	data: require_data.floorData,
+	build: (definition, ctx) => {
+		const built = buildFloor(definition);
+		const terrain = {
+			definition,
+			heightAt: built.heightAt,
+			ready: built.ready
+		};
+		ctx.capabilities.provide(_scenography_engine.TERRAIN, terrain);
+		return {
+			object: built.object,
+			dispose: () => ctx.capabilities.revoke(_scenography_engine.TERRAIN)
+		};
+	}
+});
+//#endregion
+exports.buildFloor = buildFloor;
+exports.floor = floor;
+exports.floorData = require_data.floorData;
+exports.validateFloor = require_data.validateFloor;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["MeshStandardMaterial","PlaneGeometry","Mesh","floorData","TERRAIN"],"sources":["../src/buildFloor.ts","../src/plugin.ts"],"sourcesContent":["import { applyTexture } from \"@scenography/engine\";\nimport { Mesh, MeshStandardMaterial, PlaneGeometry, type BufferAttribute, type Object3D } from \"three\";\n\nimport type { Floor } from \"./data\";\n\n/** A sampled grayscale heightmap, in `[0,1]`, populated once the image loads. */\ninterface HeightField {\n  data: Float32Array | null;\n  w: number;\n  h: number;\n}\n\n/** Bilinear sample of a height field at UV `[0,1]`; `0` until the image loads. */\nfunction sampleField(field: HeightField, u: number, v: number): number {\n  const { data, w, h } = field;\n  if (!data) return 0;\n  const x = Math.min(Math.max(u, 0), 1) * (w - 1);\n  const y = Math.min(Math.max(v, 0), 1) * (h - 1);\n  const x0 = Math.floor(x);\n  const y0 = Math.floor(y);\n  const x1 = Math.min(x0 + 1, w - 1);\n  const y1 = Math.min(y0 + 1, h - 1);\n  const fx = x - x0;\n  const fy = y - y0;\n  const a = data[y0 * w + x0] ?? 0;\n  const b = data[y0 * w + x1] ?? 0;\n  const c = data[y1 * w + x0] ?? 0;\n  const d = data[y1 * w + x1] ?? 0;\n  return (a * (1 - fx) + b * fx) * (1 - fy) + (c * (1 - fx) + d * fx) * fy;\n}\n\n/** A built floor plus a function giving ground height at any world `(x, z)`. */\nexport interface BuiltFloor {\n  object: Object3D;\n  heightAt: (x: number, z: number) => number;\n  /**\n   * Resolves once `heightAt` reflects the heightmap (immediately when there is\n   * none). Until then `heightAt` returns the flat base `y`.\n   */\n  ready: Promise<void>;\n}\n\n/** Map world `(x, z)` to heightmap UV for a floor (matches the plane orientation). */\nconst floorUV = (floor: Floor, x: number, z: number): [number, number] => {\n  const [w, d] = floor.size;\n  const [cx, cz] = floor.center ?? [0, 0];\n  const u = (x - cx + w / 2) / w;\n  const v = (cz - z + d / 2) / d;\n  return [u, v];\n};\n\n/** Ground height at `(x, z)`: base `y` + heightmap displacement. */\nfunction heightAtWith(floor: Floor, field: HeightField): (x: number, z: number) => number {\n  const base = floor.y ?? 0;\n  const scale = floor.heightScale ?? 0;\n  if (scale === 0) return () => base;\n  return (x, z) => {\n    const [u, v] = floorUV(floor, x, z);\n    return base + sampleField(field, u, v) * scale;\n  };\n}\n\n/**\n * Build the three.js object for a `Floor`: a plane at `y`, centered on `center`,\n * and (when a `heightmap` is given) displaced into dunes/berms by sampling that\n * grayscale image. `size` is `[width (x), depth (z)]`. Returns the mesh plus a\n * `heightAt(x, z)` the camera controls use to follow the terrain.\n */\nexport function buildFloor(floor: Floor): BuiltFloor {\n  const [width, depth] = floor.size;\n  const [cx, cz] = floor.center ?? [0, 0];\n  const segments = floor.heightmap ? floor.segments ?? 200 : 1;\n\n  const material = new MeshStandardMaterial({ color: floor.color ?? \"#ffffff\" });\n  const needsUv1 = floor.texture ? applyTexture(material, floor.texture) : false;\n\n  const geometry = new PlaneGeometry(width, depth, segments, segments);\n  if (needsUv1) {\n    const uv = geometry.getAttribute(\"uv\");\n    if (uv) geometry.setAttribute(\"uv1\", uv);\n  }\n\n  const field: HeightField = { data: null, w: 0, h: 0 };\n  const scale = floor.heightScale ?? 0;\n  const pos = geometry.getAttribute(\"position\") as BufferAttribute | undefined;\n\n  // Displace the vertices once the heightmap loads. A vertex at local (px, py)\n  // is raised along local Z = world +Y after the plane is laid flat.\n  const applyHeights = (): void => {\n    if (!pos || !field.data || scale === 0) return;\n    for (let i = 0; i < pos.count; i++) {\n      const px = pos.getX(i);\n      const py = pos.getY(i);\n      // Local (px, py) → world (cx+px, cz-py) → heightmap UV.\n      const u = (px + width / 2) / width;\n      const v = (py + depth / 2) / depth;\n      pos.setZ(i, sampleField(field, u, v) * scale);\n    }\n    pos.needsUpdate = true;\n    geometry.computeVertexNormals();\n  };\n\n  const mesh = new Mesh(geometry, material);\n  // PlaneGeometry faces +Z; lay it flat so it faces up (+Y).\n  mesh.rotation.x = -Math.PI / 2;\n  mesh.position.set(cx, floor.y ?? 0, cz);\n  mesh.receiveShadow = true;\n  mesh.name = \"floor\";\n\n  // Load the heightmap, read its pixels, then displace the mesh and fill the\n  // sampler so terrain-following (heightAt) matches the visible geometry.\n  let ready: Promise<void> = Promise.resolve();\n  const src = floor.heightmap;\n  if (src && scale !== 0) {\n    ready = new Promise((resolve) => {\n      const img = new Image();\n      img.crossOrigin = \"anonymous\";\n      img.onload = (): void => {\n        const canvas = document.createElement(\"canvas\");\n        canvas.width = img.naturalWidth;\n        canvas.height = img.naturalHeight;\n        const ctx = canvas.getContext(\"2d\");\n        if (ctx) {\n          ctx.drawImage(img, 0, 0);\n          const { data } = ctx.getImageData(0, 0, canvas.width, canvas.height);\n          const heights = new Float32Array(canvas.width * canvas.height);\n          for (let i = 0; i < heights.length; i++) heights[i] = (data[i * 4] ?? 0) / 255;\n          field.data = heights;\n          field.w = canvas.width;\n          field.h = canvas.height;\n          applyHeights();\n        }\n        resolve();\n      };\n      img.onerror = (): void => resolve();\n      img.src = src;\n    });\n  }\n\n  return { object: mesh, heightAt: heightAtWith(floor, field), ready };\n}\n","import { TERRAIN, type EnginePlugin, type TerrainCapability } from \"@scenography/engine\";\n\nimport { buildFloor } from \"./buildFloor\";\nimport { floorData, type Floor } from \"./data\";\n\n/**\n * The floor plugin: lays the ground plane (displaced by a heightmap when given)\n * and publishes the `terrain` capability — the live height function the camera\n * follows and the definition the water shader samples. Rebuilds revoke and\n * re-provide terrain, so consumers (`dependsOn: [TERRAIN]`) refresh in step.\n */\nexport const floor = (): EnginePlugin<Floor> => ({\n  data: floorData,\n  build: (definition, ctx) => {\n    const built = buildFloor(definition);\n    const terrain: TerrainCapability = {\n      definition,\n      heightAt: built.heightAt,\n      ready: built.ready,\n    };\n    ctx.capabilities.provide(TERRAIN, terrain);\n    return {\n      object: built.object,\n      dispose: () => ctx.capabilities.revoke(TERRAIN),\n    };\n  },\n});\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+import { n as validateFloor, r as Floor, t as floorData } from "./index-1ydrP4eD.cjs";
+import { EnginePlugin } from "@scenography/engine";
+import { Object3D } from "three";
+
+//#region src/plugin.d.ts
+/**
+ * The floor plugin: lays the ground plane (displaced by a heightmap when given)
+ * and publishes the `terrain` capability — the live height function the camera
+ * follows and the definition the water shader samples. Rebuilds revoke and
+ * re-provide terrain, so consumers (`dependsOn: [TERRAIN]`) refresh in step.
+ */
+declare const floor: () => EnginePlugin<Floor>;
+//#endregion
+//#region src/buildFloor.d.ts
+/** A built floor plus a function giving ground height at any world `(x, z)`. */
+interface BuiltFloor {
+  object: Object3D;
+  heightAt: (x: number, z: number) => number;
+  /**
+   * Resolves once `heightAt` reflects the heightmap (immediately when there is
+   * none). Until then `heightAt` returns the flat base `y`.
+   */
+  ready: Promise<void>;
+}
+/**
+ * Build the three.js object for a `Floor`: a plane at `y`, centered on `center`,
+ * and (when a `heightmap` is given) displaced into dunes/berms by sampling that
+ * grayscale image. `size` is `[width (x), depth (z)]`. Returns the mesh plus a
+ * `heightAt(x, z)` the camera controls use to follow the terrain.
+ */
+declare function buildFloor(floor: Floor): BuiltFloor;
+//#endregion
+export { type BuiltFloor, type Floor, buildFloor, floor, floorData, validateFloor };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,34 @@
+import { n as validateFloor, r as Floor, t as floorData } from "./index-1ydrP4eD.mjs";
+import { EnginePlugin } from "@scenography/engine";
+import { Object3D } from "three";
+
+//#region src/plugin.d.ts
+/**
+ * The floor plugin: lays the ground plane (displaced by a heightmap when given)
+ * and publishes the `terrain` capability — the live height function the camera
+ * follows and the definition the water shader samples. Rebuilds revoke and
+ * re-provide terrain, so consumers (`dependsOn: [TERRAIN]`) refresh in step.
+ */
+declare const floor: () => EnginePlugin<Floor>;
+//#endregion
+//#region src/buildFloor.d.ts
+/** A built floor plus a function giving ground height at any world `(x, z)`. */
+interface BuiltFloor {
+  object: Object3D;
+  heightAt: (x: number, z: number) => number;
+  /**
+   * Resolves once `heightAt` reflects the heightmap (immediately when there is
+   * none). Until then `heightAt` returns the flat base `y`.
+   */
+  ready: Promise<void>;
+}
+/**
+ * Build the three.js object for a `Floor`: a plane at `y`, centered on `center`,
+ * and (when a `heightmap` is given) displaced into dunes/berms by sampling that
+ * grayscale image. `size` is `[width (x), depth (z)]`. Returns the mesh plus a
+ * `heightAt(x, z)` the camera controls use to follow the terrain.
+ */
+declare function buildFloor(floor: Floor): BuiltFloor;
+//#endregion
+export { type BuiltFloor, type Floor, buildFloor, floor, floorData, validateFloor };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,138 @@
+import { n as validateFloor, t as floorData } from "./data-CTGlghAE.mjs";
+import { TERRAIN, applyTexture } from "@scenography/engine";
+import { Mesh, MeshStandardMaterial, PlaneGeometry } from "three";
+//#region src/buildFloor.ts
+/** Bilinear sample of a height field at UV `[0,1]`; `0` until the image loads. */
+function sampleField(field, u, v) {
+	const { data, w, h } = field;
+	if (!data) return 0;
+	const x = Math.min(Math.max(u, 0), 1) * (w - 1);
+	const y = Math.min(Math.max(v, 0), 1) * (h - 1);
+	const x0 = Math.floor(x);
+	const y0 = Math.floor(y);
+	const x1 = Math.min(x0 + 1, w - 1);
+	const y1 = Math.min(y0 + 1, h - 1);
+	const fx = x - x0;
+	const fy = y - y0;
+	const a = data[y0 * w + x0] ?? 0;
+	const b = data[y0 * w + x1] ?? 0;
+	const c = data[y1 * w + x0] ?? 0;
+	const d = data[y1 * w + x1] ?? 0;
+	return (a * (1 - fx) + b * fx) * (1 - fy) + (c * (1 - fx) + d * fx) * fy;
+}
+/** Map world `(x, z)` to heightmap UV for a floor (matches the plane orientation). */
+const floorUV = (floor, x, z) => {
+	const [w, d] = floor.size;
+	const [cx, cz] = floor.center ?? [0, 0];
+	return [(x - cx + w / 2) / w, (cz - z + d / 2) / d];
+};
+/** Ground height at `(x, z)`: base `y` + heightmap displacement. */
+function heightAtWith(floor, field) {
+	const base = floor.y ?? 0;
+	const scale = floor.heightScale ?? 0;
+	if (scale === 0) return () => base;
+	return (x, z) => {
+		const [u, v] = floorUV(floor, x, z);
+		return base + sampleField(field, u, v) * scale;
+	};
+}
+/**
+* Build the three.js object for a `Floor`: a plane at `y`, centered on `center`,
+* and (when a `heightmap` is given) displaced into dunes/berms by sampling that
+* grayscale image. `size` is `[width (x), depth (z)]`. Returns the mesh plus a
+* `heightAt(x, z)` the camera controls use to follow the terrain.
+*/
+function buildFloor(floor) {
+	const [width, depth] = floor.size;
+	const [cx, cz] = floor.center ?? [0, 0];
+	const segments = floor.heightmap ? floor.segments ?? 200 : 1;
+	const material = new MeshStandardMaterial({ color: floor.color ?? "#ffffff" });
+	const needsUv1 = floor.texture ? applyTexture(material, floor.texture) : false;
+	const geometry = new PlaneGeometry(width, depth, segments, segments);
+	if (needsUv1) {
+		const uv = geometry.getAttribute("uv");
+		if (uv) geometry.setAttribute("uv1", uv);
+	}
+	const field = {
+		data: null,
+		w: 0,
+		h: 0
+	};
+	const scale = floor.heightScale ?? 0;
+	const pos = geometry.getAttribute("position");
+	const applyHeights = () => {
+		if (!pos || !field.data || scale === 0) return;
+		for (let i = 0; i < pos.count; i++) {
+			const px = pos.getX(i);
+			const py = pos.getY(i);
+			const u = (px + width / 2) / width;
+			const v = (py + depth / 2) / depth;
+			pos.setZ(i, sampleField(field, u, v) * scale);
+		}
+		pos.needsUpdate = true;
+		geometry.computeVertexNormals();
+	};
+	const mesh = new Mesh(geometry, material);
+	mesh.rotation.x = -Math.PI / 2;
+	mesh.position.set(cx, floor.y ?? 0, cz);
+	mesh.receiveShadow = true;
+	mesh.name = "floor";
+	let ready = Promise.resolve();
+	const src = floor.heightmap;
+	if (src && scale !== 0) ready = new Promise((resolve) => {
+		const img = new Image();
+		img.crossOrigin = "anonymous";
+		img.onload = () => {
+			const canvas = document.createElement("canvas");
+			canvas.width = img.naturalWidth;
+			canvas.height = img.naturalHeight;
+			const ctx = canvas.getContext("2d");
+			if (ctx) {
+				ctx.drawImage(img, 0, 0);
+				const { data } = ctx.getImageData(0, 0, canvas.width, canvas.height);
+				const heights = new Float32Array(canvas.width * canvas.height);
+				for (let i = 0; i < heights.length; i++) heights[i] = (data[i * 4] ?? 0) / 255;
+				field.data = heights;
+				field.w = canvas.width;
+				field.h = canvas.height;
+				applyHeights();
+			}
+			resolve();
+		};
+		img.onerror = () => resolve();
+		img.src = src;
+	});
+	return {
+		object: mesh,
+		heightAt: heightAtWith(floor, field),
+		ready
+	};
+}
+//#endregion
+//#region src/plugin.ts
+/**
+* The floor plugin: lays the ground plane (displaced by a heightmap when given)
+* and publishes the `terrain` capability — the live height function the camera
+* follows and the definition the water shader samples. Rebuilds revoke and
+* re-provide terrain, so consumers (`dependsOn: [TERRAIN]`) refresh in step.
+*/
+const floor = () => ({
+	data: floorData,
+	build: (definition, ctx) => {
+		const built = buildFloor(definition);
+		const terrain = {
+			definition,
+			heightAt: built.heightAt,
+			ready: built.ready
+		};
+		ctx.capabilities.provide(TERRAIN, terrain);
+		return {
+			object: built.object,
+			dispose: () => ctx.capabilities.revoke(TERRAIN)
+		};
+	}
+});
+//#endregion
+export { buildFloor, floor, floorData, validateFloor };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/buildFloor.ts","../src/plugin.ts"],"sourcesContent":["import { applyTexture } from \"@scenography/engine\";\nimport { Mesh, MeshStandardMaterial, PlaneGeometry, type BufferAttribute, type Object3D } from \"three\";\n\nimport type { Floor } from \"./data\";\n\n/** A sampled grayscale heightmap, in `[0,1]`, populated once the image loads. */\ninterface HeightField {\n  data: Float32Array | null;\n  w: number;\n  h: number;\n}\n\n/** Bilinear sample of a height field at UV `[0,1]`; `0` until the image loads. */\nfunction sampleField(field: HeightField, u: number, v: number): number {\n  const { data, w, h } = field;\n  if (!data) return 0;\n  const x = Math.min(Math.max(u, 0), 1) * (w - 1);\n  const y = Math.min(Math.max(v, 0), 1) * (h - 1);\n  const x0 = Math.floor(x);\n  const y0 = Math.floor(y);\n  const x1 = Math.min(x0 + 1, w - 1);\n  const y1 = Math.min(y0 + 1, h - 1);\n  const fx = x - x0;\n  const fy = y - y0;\n  const a = data[y0 * w + x0] ?? 0;\n  const b = data[y0 * w + x1] ?? 0;\n  const c = data[y1 * w + x0] ?? 0;\n  const d = data[y1 * w + x1] ?? 0;\n  return (a * (1 - fx) + b * fx) * (1 - fy) + (c * (1 - fx) + d * fx) * fy;\n}\n\n/** A built floor plus a function giving ground height at any world `(x, z)`. */\nexport interface BuiltFloor {\n  object: Object3D;\n  heightAt: (x: number, z: number) => number;\n  /**\n   * Resolves once `heightAt` reflects the heightmap (immediately when there is\n   * none). Until then `heightAt` returns the flat base `y`.\n   */\n  ready: Promise<void>;\n}\n\n/** Map world `(x, z)` to heightmap UV for a floor (matches the plane orientation). */\nconst floorUV = (floor: Floor, x: number, z: number): [number, number] => {\n  const [w, d] = floor.size;\n  const [cx, cz] = floor.center ?? [0, 0];\n  const u = (x - cx + w / 2) / w;\n  const v = (cz - z + d / 2) / d;\n  return [u, v];\n};\n\n/** Ground height at `(x, z)`: base `y` + heightmap displacement. */\nfunction heightAtWith(floor: Floor, field: HeightField): (x: number, z: number) => number {\n  const base = floor.y ?? 0;\n  const scale = floor.heightScale ?? 0;\n  if (scale === 0) return () => base;\n  return (x, z) => {\n    const [u, v] = floorUV(floor, x, z);\n    return base + sampleField(field, u, v) * scale;\n  };\n}\n\n/**\n * Build the three.js object for a `Floor`: a plane at `y`, centered on `center`,\n * and (when a `heightmap` is given) displaced into dunes/berms by sampling that\n * grayscale image. `size` is `[width (x), depth (z)]`. Returns the mesh plus a\n * `heightAt(x, z)` the camera controls use to follow the terrain.\n */\nexport function buildFloor(floor: Floor): BuiltFloor {\n  const [width, depth] = floor.size;\n  const [cx, cz] = floor.center ?? [0, 0];\n  const segments = floor.heightmap ? floor.segments ?? 200 : 1;\n\n  const material = new MeshStandardMaterial({ color: floor.color ?? \"#ffffff\" });\n  const needsUv1 = floor.texture ? applyTexture(material, floor.texture) : false;\n\n  const geometry = new PlaneGeometry(width, depth, segments, segments);\n  if (needsUv1) {\n    const uv = geometry.getAttribute(\"uv\");\n    if (uv) geometry.setAttribute(\"uv1\", uv);\n  }\n\n  const field: HeightField = { data: null, w: 0, h: 0 };\n  const scale = floor.heightScale ?? 0;\n  const pos = geometry.getAttribute(\"position\") as BufferAttribute | undefined;\n\n  // Displace the vertices once the heightmap loads. A vertex at local (px, py)\n  // is raised along local Z = world +Y after the plane is laid flat.\n  const applyHeights = (): void => {\n    if (!pos || !field.data || scale === 0) return;\n    for (let i = 0; i < pos.count; i++) {\n      const px = pos.getX(i);\n      const py = pos.getY(i);\n      // Local (px, py) → world (cx+px, cz-py) → heightmap UV.\n      const u = (px + width / 2) / width;\n      const v = (py + depth / 2) / depth;\n      pos.setZ(i, sampleField(field, u, v) * scale);\n    }\n    pos.needsUpdate = true;\n    geometry.computeVertexNormals();\n  };\n\n  const mesh = new Mesh(geometry, material);\n  // PlaneGeometry faces +Z; lay it flat so it faces up (+Y).\n  mesh.rotation.x = -Math.PI / 2;\n  mesh.position.set(cx, floor.y ?? 0, cz);\n  mesh.receiveShadow = true;\n  mesh.name = \"floor\";\n\n  // Load the heightmap, read its pixels, then displace the mesh and fill the\n  // sampler so terrain-following (heightAt) matches the visible geometry.\n  let ready: Promise<void> = Promise.resolve();\n  const src = floor.heightmap;\n  if (src && scale !== 0) {\n    ready = new Promise((resolve) => {\n      const img = new Image();\n      img.crossOrigin = \"anonymous\";\n      img.onload = (): void => {\n        const canvas = document.createElement(\"canvas\");\n        canvas.width = img.naturalWidth;\n        canvas.height = img.naturalHeight;\n        const ctx = canvas.getContext(\"2d\");\n        if (ctx) {\n          ctx.drawImage(img, 0, 0);\n          const { data } = ctx.getImageData(0, 0, canvas.width, canvas.height);\n          const heights = new Float32Array(canvas.width * canvas.height);\n          for (let i = 0; i < heights.length; i++) heights[i] = (data[i * 4] ?? 0) / 255;\n          field.data = heights;\n          field.w = canvas.width;\n          field.h = canvas.height;\n          applyHeights();\n        }\n        resolve();\n      };\n      img.onerror = (): void => resolve();\n      img.src = src;\n    });\n  }\n\n  return { object: mesh, heightAt: heightAtWith(floor, field), ready };\n}\n","import { TERRAIN, type EnginePlugin, type TerrainCapability } from \"@scenography/engine\";\n\nimport { buildFloor } from \"./buildFloor\";\nimport { floorData, type Floor } from \"./data\";\n\n/**\n * The floor plugin: lays the ground plane (displaced by a heightmap when given)\n * and publishes the `terrain` capability — the live height function the camera\n * follows and the definition the water shader samples. Rebuilds revoke and\n * re-provide terrain, so consumers (`dependsOn: [TERRAIN]`) refresh in step.\n */\nexport const floor = (): EnginePlugin<Floor> => ({\n  data: floorData,\n  build: (definition, ctx) => {\n    const built = buildFloor(definition);\n    const terrain: TerrainCapability = {\n      definition,\n      heightAt: built.heightAt,\n      ready: built.ready,\n    };\n    ctx.capabilities.provide(TERRAIN, terrain);\n    return {\n      object: built.object,\n      dispose: () => ctx.capabilities.revoke(TERRAIN),\n    };\n  },\n});\n"],"mappings":";;;;;AAaA,SAAS,YAAY,OAAoB,GAAW,GAAmB;CACrE,MAAM,EAAE,MAAM,GAAG,MAAM;CACvB,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;CAC7C,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;CAC7C,MAAM,KAAK,KAAK,MAAM,CAAC;CACvB,MAAM,KAAK,KAAK,MAAM,CAAC;CACvB,MAAM,KAAK,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC;CACjC,MAAM,KAAK,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC;CACjC,MAAM,KAAK,IAAI;CACf,MAAM,KAAK,IAAI;CACf,MAAM,IAAI,KAAK,KAAK,IAAI,OAAO;CAC/B,MAAM,IAAI,KAAK,KAAK,IAAI,OAAO;CAC/B,MAAM,IAAI,KAAK,KAAK,IAAI,OAAO;CAC/B,MAAM,IAAI,KAAK,KAAK,IAAI,OAAO;CAC/B,QAAQ,KAAK,IAAI,MAAM,IAAI,OAAO,IAAI,OAAO,KAAK,IAAI,MAAM,IAAI,MAAM;AACxE;;AAcA,MAAM,WAAW,OAAc,GAAW,MAAgC;CACxE,MAAM,CAAC,GAAG,KAAK,MAAM;CACrB,MAAM,CAAC,IAAI,MAAM,MAAM,UAAU,CAAC,GAAG,CAAC;CAGtC,OAAO,EAFI,IAAI,KAAK,IAAI,KAAK,IAClB,KAAK,IAAI,IAAI,KAAK,CACjB;AACd;;AAGA,SAAS,aAAa,OAAc,OAAsD;CACxF,MAAM,OAAO,MAAM,KAAK;CACxB,MAAM,QAAQ,MAAM,eAAe;CACnC,IAAI,UAAU,GAAG,aAAa;CAC9B,QAAQ,GAAG,MAAM;EACf,MAAM,CAAC,GAAG,KAAK,QAAQ,OAAO,GAAG,CAAC;EAClC,OAAO,OAAO,YAAY,OAAO,GAAG,CAAC,IAAI;CAC3C;AACF;;;;;;;AAQA,SAAgB,WAAW,OAA0B;CACnD,MAAM,CAAC,OAAO,SAAS,MAAM;CAC7B,MAAM,CAAC,IAAI,MAAM,MAAM,UAAU,CAAC,GAAG,CAAC;CACtC,MAAM,WAAW,MAAM,YAAY,MAAM,YAAY,MAAM;CAE3D,MAAM,WAAW,IAAI,qBAAqB,EAAE,OAAO,MAAM,SAAS,UAAU,CAAC;CAC7E,MAAM,WAAW,MAAM,UAAU,aAAa,UAAU,MAAM,OAAO,IAAI;CAEzE,MAAM,WAAW,IAAI,cAAc,OAAO,OAAO,UAAU,QAAQ;CACnE,IAAI,UAAU;EACZ,MAAM,KAAK,SAAS,aAAa,IAAI;EACrC,IAAI,IAAI,SAAS,aAAa,OAAO,EAAE;CACzC;CAEA,MAAM,QAAqB;EAAE,MAAM;EAAM,GAAG;EAAG,GAAG;CAAE;CACpD,MAAM,QAAQ,MAAM,eAAe;CACnC,MAAM,MAAM,SAAS,aAAa,UAAU;CAI5C,MAAM,qBAA2B;EAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,QAAQ,UAAU,GAAG;EACxC,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,OAAO,KAAK;GAClC,MAAM,KAAK,IAAI,KAAK,CAAC;GACrB,MAAM,KAAK,IAAI,KAAK,CAAC;GAErB,MAAM,KAAK,KAAK,QAAQ,KAAK;GAC7B,MAAM,KAAK,KAAK,QAAQ,KAAK;GAC7B,IAAI,KAAK,GAAG,YAAY,OAAO,GAAG,CAAC,IAAI,KAAK;EAC9C;EACA,IAAI,cAAc;EAClB,SAAS,qBAAqB;CAChC;CAEA,MAAM,OAAO,IAAI,KAAK,UAAU,QAAQ;CAExC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK;CAC7B,KAAK,SAAS,IAAI,IAAI,MAAM,KAAK,GAAG,EAAE;CACtC,KAAK,gBAAgB;CACrB,KAAK,OAAO;CAIZ,IAAI,QAAuB,QAAQ,QAAQ;CAC3C,MAAM,MAAM,MAAM;CAClB,IAAI,OAAO,UAAU,GACnB,QAAQ,IAAI,SAAS,YAAY;EAC/B,MAAM,MAAM,IAAI,MAAM;EACtB,IAAI,cAAc;EAClB,IAAI,eAAqB;GACvB,MAAM,SAAS,SAAS,cAAc,QAAQ;GAC9C,OAAO,QAAQ,IAAI;GACnB,OAAO,SAAS,IAAI;GACpB,MAAM,MAAM,OAAO,WAAW,IAAI;GAClC,IAAI,KAAK;IACP,IAAI,UAAU,KAAK,GAAG,CAAC;IACvB,MAAM,EAAE,SAAS,IAAI,aAAa,GAAG,GAAG,OAAO,OAAO,OAAO,MAAM;IACnE,MAAM,UAAU,IAAI,aAAa,OAAO,QAAQ,OAAO,MAAM;IAC7D,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,QAAQ,MAAM,KAAK,IAAI,MAAM,KAAK;IAC3E,MAAM,OAAO;IACb,MAAM,IAAI,OAAO;IACjB,MAAM,IAAI,OAAO;IACjB,aAAa;GACf;GACA,QAAQ;EACV;EACA,IAAI,gBAAsB,QAAQ;EAClC,IAAI,MAAM;CACZ,CAAC;CAGH,OAAO;EAAE,QAAQ;EAAM,UAAU,aAAa,OAAO,KAAK;EAAG;CAAM;AACrE;;;;;;;;;ACjIA,MAAa,eAAoC;CAC/C,MAAM;CACN,QAAQ,YAAY,QAAQ;EAC1B,MAAM,QAAQ,WAAW,UAAU;EACnC,MAAM,UAA6B;GACjC;GACA,UAAU,MAAM;GAChB,OAAO,MAAM;EACf;EACA,IAAI,aAAa,QAAQ,SAAS,OAAO;EACzC,OAAO;GACL,QAAQ,MAAM;GACd,eAAe,IAAI,aAAa,OAAO,OAAO;EAChD;CACF;AACF"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@scenography/plugin-floor",
+  "version": "0.2.0",
+  "description": "Floor plugin for scenography: a ground plane optionally displaced into relief by a heightmap; publishes the terrain capability the camera and water consume. Data half importable without three.js.",
+  "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"
+  }
+}