@3driseai/3drise-viewer 0.1.42 → 0.1.43

package/dist/shaders/terrain/TerrainMaterial.js

@@ -59,6 +59,17 @@ varying float vDist;
 varying float vShadow;
 
 #ifdef TERRAIN_PATCH
+#ifdef LAND_LAYOUT
+// A land kept to a layout (config.shapeLayout; viewer utils/landPatch landLayoutGeometry), per
+// vertex on the unit grid: the layout's mask (0 at its edge -> 1 past the band) with its slope per
+// grid unit, and its lift (the layout's height, its metres) with its slope per grid unit. Brought
+// into terrain metres here (/ u_patchSize, x u_scaleY), so the grid never depends on the scale.
+// They replace the rectangle's band (u_edgeWidth is 0) and apply to the height AND its gradient.
+attribute vec3 aLayoutMask;
+attribute vec3 aLayoutLift;
+varying vec3 vLayoutMask;
+varying vec3 vLayoutLift;
+#endif
 // A land object. The mesh is a unit grid on XZ (-0.5..0.5) that the object's
 // transform places, rotates and sizes. The field is sampled in terrain space —
 // metres from the object's origin, plus the seed offset — so a wider footprint
@@ -71,6 +82,13 @@ void main(){
 
   vec2 grad;
   float h = terrainSurfaceAt(tp, cellLod, grad);
+  #ifdef LAND_LAYOUT
+  float hb = h - u_seaLevel;
+  grad = grad * aLayoutMask.x + hb * aLayoutMask.yz / u_patchSize + aLayoutLift.yz * u_scaleY / u_patchSize;
+  h = u_seaLevel + hb * aLayoutMask.x + aLayoutLift.x * u_scaleY;
+  vLayoutMask = aLayoutMask;
+  vLayoutLift = aLayoutLift;
+  #endif
 
   vec3 wp = vec3(tp.x, h, tp.y);
   float camDist = distance(wp, TERRAIN_CAM);
@@ -180,6 +198,10 @@ varying vec3  vWorld;
 varying float vCell;
 varying float vDist;
 varying float vShadow;
+#if defined(TERRAIN_PATCH) && defined(LAND_LAYOUT)
+varying vec3 vLayoutMask;
+varying vec3 vLayoutLift;
+#endif
 
 void main(){
   vec3 viewDir = normalize(vWorld - TERRAIN_CAM);
@@ -200,6 +222,12 @@ void main(){
   // them on every pixel.
   vec2 grad;
   float shadeHeight = terrainSurfaceAt(vWorld.xz, lod, grad);
+  #if defined(TERRAIN_PATCH) && defined(LAND_LAYOUT)
+  // the layout's mask and lift, as the vertex applied them (interpolated across the cell)
+  float shb = shadeHeight - u_seaLevel;
+  grad = grad * vLayoutMask.x + shb * vLayoutMask.yz / u_patchSize + vLayoutLift.yz * u_scaleY / u_patchSize;
+  shadeHeight = u_seaLevel + shb * vLayoutMask.x + vLayoutLift.x * u_scaleY;
+  #endif
   vec3 nBase = terrainNormal(grad);
   vec3 n = terrainDetailNormal(nBase, vWorld, vDist);
 

package/dist/triggers/kinds/change.js

@@ -10,7 +10,7 @@ import { SceneActions } from '@3driseai/3drise-core';
 import { defineTriggerable } from '../registry.js';
 import { logTrigger } from '../log.js';
 import { currentChain } from '../engine.js';
-const ENV = new Set(['camera', 'sky', 'clouds', 'ocean', 'terrain']);
+const ENV = new Set(['camera', 'sky', 'clouds', 'ocean', 'terrain', 'time', 'render']);
 export const changeLayerId = (c) => `change:${c.id}`;
 const ownerName = (o) => (o.startsWith('layer:change:') ? `change ${o.slice(13)}` : o === 'layer:timeline' ? 'a switch track' : `action ${o}`);
 const patchesOf = (c) => {

package/dist/utils/composerHostedPass.d.ts

@@ -0,0 +1,74 @@
+import type * as THREE from 'three';
+/**
+ * A full-screen pass that can be hosted by the post-processing composer.
+ *
+ * VolumetricCloudsPass owns the frame: it draws the scene into its own target and
+ * composites the clouds to the canvas. The post-processing EffectComposer owns the
+ * frame too: its RenderPass draws the scene, its effects run on top. With both
+ * mounted, both drew the whole scene every frame — measured on a city scene as
+ * twice the draw calls and triangles, 60 fps down to 40.
+ *
+ * So when a composer is mounted it HOSTS the pass instead: the pass is inserted
+ * right after the composer's RenderPass, reads that render (colour + depth) and
+ * writes the scene-with-clouds for the effects that follow. The scene is drawn
+ * once, bloom and the rest see the clouds, and tone mapping happens once, at the
+ * end of the chain. With no composer the pass renders the frame itself, as before.
+ *
+ * The two meet through this registry (keyed on the renderer, like frameRenderer)
+ * because they live in unrelated parts of the tree: the clouds under the
+ * environment, the composer under SceneBuilder.
+ *
+ * The object is shaped for `postprocessing`'s EffectComposer.addPass rather than
+ * extending its Pass class: the viewer reaches postprocessing only through
+ * @react-three/postprocessing, which does not export Pass. The composer calls only
+ * the members below.
+ */
+export interface HostedPass {
+    name: string;
+    enabled: boolean;
+    renderer: THREE.WebGLRenderer | null;
+    /** Writes to outputBuffer, so the composer swaps buffers after it. */
+    needsSwap: boolean;
+    needsDepthBlit: boolean;
+    /** Makes the composer keep the stable copy of the RenderPass's depth. */
+    needsDepthTexture: boolean;
+    renderToScreen: boolean;
+    mainScene: THREE.Scene | null;
+    mainCamera: THREE.Camera | null;
+    /** True while a composer has it in its chain; the owner must not draw the frame itself then. */
+    hosted: boolean;
+    setSize(width: number, height: number): void;
+    initialize(renderer: THREE.WebGLRenderer, alpha: boolean, frameBufferType: number): void;
+    setDepthTexture(depthTexture: THREE.Texture | null): void;
+    getDepthTexture(): THREE.Texture | null;
+    render(renderer: THREE.WebGLRenderer, inputBuffer: THREE.WebGLRenderTarget, outputBuffer: THREE.WebGLRenderTarget, deltaTime?: number): void;
+    /** No-op. The composer disposes every pass it holds when it is torn down; this
+     *  pass's resources belong to the component that created it. */
+    dispose(): void;
+}
+/** What the owner draws when hosted: the composer's scene render in, its next buffer out. */
+export interface HostedInput {
+    scene: THREE.Texture;
+    depth: THREE.Texture | null;
+    /** null = the canvas, when this is the last pass in the chain. */
+    output: THREE.WebGLRenderTarget | null;
+    toScreen: boolean;
+}
+export declare function createHostedPass(name: string, draw: (input: HostedInput, deltaTime: number) => void): HostedPass;
+/** Offer the pass to whichever composer is (or later gets) mounted. Returns the release. */
+export declare function publishHostedPass(gl: THREE.WebGLRenderer, pass: HostedPass): () => void;
+/** The pass a composer on this renderer should host, or null. Re-renders when it changes. */
+export declare function useHostedPass(gl: THREE.WebGLRenderer): HostedPass | null;
+/** The part of postprocessing's EffectComposer this needs. */
+export interface ComposerLike {
+    passes: unknown[];
+    addPass(pass: unknown, index?: number): void;
+    removePass(pass: unknown): void;
+}
+/**
+ * Put the pass right after the composer's RenderPass (always its first pass), ahead
+ * of every effect. Returns the detach. Effects the composer adds or rebuilds later
+ * are appended after it, so the position holds.
+ */
+export declare function attachHostedPass(composer: ComposerLike, pass: HostedPass): () => void;
+//# sourceMappingURL=composerHostedPass.d.ts.map

package/dist/utils/composerHostedPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composerHostedPass.d.ts","sourceRoot":"","sources":["../../src/utils/composerHostedPass.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IACrC,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAChC,gGAAgG;IAChG,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACzF,eAAe,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1D,eAAe,IAAI,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;IACxC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,WAAW,EAAE,KAAK,CAAC,iBAAiB,EAAE,YAAY,EAAE,KAAK,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7I;oEACgE;IAChE,OAAO,IAAI,IAAI,CAAC;CACnB;AAED,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;IAC5B,kEAAkE;IAClE,MAAM,EAAE,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CA2BhH;AAUD,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,IAAI,CASvF;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,aAAa,GAAG,UAAU,GAAG,IAAI,CAMxE;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,IAAI,CAOrF"}

package/dist/utils/composerHostedPass.js

@@ -0,0 +1,63 @@
+import { useSyncExternalStore } from 'react';
+export function createHostedPass(name, draw) {
+    let depth = null;
+    return {
+        name,
+        enabled: true,
+        renderer: null,
+        needsSwap: true,
+        needsDepthBlit: false,
+        needsDepthTexture: true,
+        renderToScreen: false,
+        mainScene: null,
+        mainCamera: null,
+        hosted: false,
+        setSize() { },
+        initialize() { },
+        setDepthTexture(t) { depth = t; },
+        getDepthTexture() { return depth; },
+        render(_renderer, inputBuffer, outputBuffer, deltaTime = 0) {
+            draw({
+                scene: inputBuffer.texture,
+                depth,
+                output: this.renderToScreen ? null : outputBuffer,
+                toScreen: this.renderToScreen,
+            }, deltaTime);
+        },
+        dispose() { },
+    };
+}
+// ---------------------------------------------------------------------------
+// Registry: one hosted pass per renderer.
+// ---------------------------------------------------------------------------
+const registry = new WeakMap();
+const listeners = new Set();
+const notify = () => listeners.forEach((l) => l());
+/** Offer the pass to whichever composer is (or later gets) mounted. Returns the release. */
+export function publishHostedPass(gl, pass) {
+    registry.set(gl, pass);
+    notify();
+    return () => {
+        if (registry.get(gl) === pass) {
+            registry.delete(gl);
+            notify();
+        }
+    };
+}
+/** The pass a composer on this renderer should host, or null. Re-renders when it changes. */
+export function useHostedPass(gl) {
+    return useSyncExternalStore((l) => { listeners.add(l); return () => { listeners.delete(l); }; }, () => registry.get(gl) ?? null, () => null);
+}
+/**
+ * Put the pass right after the composer's RenderPass (always its first pass), ahead
+ * of every effect. Returns the detach. Effects the composer adds or rebuilds later
+ * are appended after it, so the position holds.
+ */
+export function attachHostedPass(composer, pass) {
+    composer.addPass(pass, 1);
+    pass.hosted = true;
+    return () => {
+        pass.hosted = false;
+        composer.removePass(pass);
+    };
+}

package/dist/utils/geometryScript.d.ts

@@ -0,0 +1,17 @@
+import type { BufferGeometry } from 'three';
+import { type ScriptParams, type ScriptRunReport } from '@3driseai/3drise-core';
+export declare class ScriptGeometryError extends Error {
+    line?: number;
+    constructor(message: string, line?: number);
+}
+export interface ScriptBuild {
+    geometry: BufferGeometry;
+    report: ScriptRunReport;
+}
+/** The cached build, when there is one (synchronous; the first render of a known script needs no suspense). */
+export declare function cachedScriptGeometry(source: string, params: ScriptParams): ScriptBuild | undefined;
+/** Builds (or reads from the cache). The returned geometry is shared: clone it before mutating. */
+export declare function buildScriptGeometry(source: string, params: ScriptParams): Promise<ScriptBuild>;
+/** Drops the cached builds (tests, memory pressure). */
+export declare function clearScriptGeometryCache(): void;
+//# sourceMappingURL=geometryScript.d.ts.map

package/dist/utils/geometryScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometryScript.d.ts","sourceRoot":"","sources":["../../src/utils/geometryScript.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAyE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEvJ,qBAAa,mBAAoB,SAAQ,KAAK;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;gBACF,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAC7C;AAED,MAAM,WAAW,WAAW;IAAG,QAAQ,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE;AA4DlF,+GAA+G;AAC/G,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS,CAElG;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAa9F;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}

package/dist/utils/geometryScript.js

@@ -0,0 +1,92 @@
+import { buffersToGeometry, scriptKey, SCRIPT_TIMEOUT_MS } from '@3driseai/3drise-core';
+export class ScriptGeometryError extends Error {
+    line;
+    constructor(message, line) { super(message); this.name = 'ScriptGeometryError'; this.line = line; }
+}
+const CACHE_MAX = 64;
+const cache = new Map();
+const pending = new Map();
+const queue = [];
+let running = null;
+let worker = null;
+let seq = 0;
+function makeWorker() {
+    const w = new Worker(new URL('./geometryScript.worker.ts', import.meta.url), { type: 'module' });
+    w.onmessage = (ev) => {
+        const job = running;
+        if (!job || ev.data.id !== job.id)
+            return;
+        clearTimeout(job.timer);
+        running = null;
+        if (ev.data.ok && ev.data.buffers && ev.data.report)
+            job.resolve({ geometry: buffersToGeometry(ev.data.buffers), report: ev.data.report });
+        else
+            job.reject(new ScriptGeometryError(ev.data.error ?? 'The geometry script failed.', ev.data.line));
+        next();
+    };
+    w.onerror = (ev) => {
+        const job = running;
+        if (!job)
+            return;
+        clearTimeout(job.timer);
+        running = null;
+        job.reject(new ScriptGeometryError(ev.message || 'The geometry worker failed.'));
+        next();
+    };
+    return w;
+}
+function next() {
+    if (running || !queue.length)
+        return;
+    const job = queue.shift();
+    running = job;
+    if (!worker)
+        worker = makeWorker();
+    job.timer = setTimeout(() => {
+        if (running !== job)
+            return;
+        worker?.terminate();
+        worker = null;
+        running = null;
+        job.reject(new ScriptGeometryError(`The geometry script ran for more than ${SCRIPT_TIMEOUT_MS / 1000} s and was stopped — lower the segments or the number of CSG operations.`));
+        next();
+    }, SCRIPT_TIMEOUT_MS);
+    worker.postMessage({ id: job.id, source: job.source, params: job.params });
+}
+function remember(key, build) {
+    cache.set(key, build);
+    if (cache.size > CACHE_MAX) {
+        const oldest = cache.keys().next().value;
+        cache.get(oldest)?.geometry.dispose();
+        cache.delete(oldest);
+    }
+    return build;
+}
+/** The cached build, when there is one (synchronous; the first render of a known script needs no suspense). */
+export function cachedScriptGeometry(source, params) {
+    return cache.get(scriptKey(source, params));
+}
+/** Builds (or reads from the cache). The returned geometry is shared: clone it before mutating. */
+export function buildScriptGeometry(source, params) {
+    const key = scriptKey(source, params);
+    const hit = cache.get(key);
+    if (hit)
+        return Promise.resolve(hit);
+    const inflight = pending.get(key);
+    if (inflight)
+        return inflight;
+    if (typeof Worker === 'undefined')
+        return Promise.reject(new ScriptGeometryError('Geometry scripts need a browser with Web Workers.'));
+    const p = new Promise((resolve, reject) => {
+        queue.push({ id: ++seq, source, params, resolve: (r) => resolve(remember(key, r)), reject });
+        next();
+    }).finally(() => pending.delete(key));
+    pending.set(key, p);
+    return p;
+}
+/** Drops the cached builds (tests, memory pressure). */
+export function clearScriptGeometryCache() {
+    for (const b of cache.values())
+        b.geometry.dispose();
+    cache.clear();
+}

package/dist/utils/geometryScript.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=geometryScript.worker.d.ts.map

package/dist/utils/geometryScript.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometryScript.worker.d.ts","sourceRoot":"","sources":["../../src/utils/geometryScript.worker.ts"],"names":[],"mappings":""}

package/dist/utils/geometryScript.worker.js

@@ -0,0 +1,42 @@
+// =============================================================================
+// Geometry script worker — runs `build(p, g)` away from the page
+// =============================================================================
+//
+// A saved script is untrusted code (a shared project, a market object), so it
+// never runs on the page thread. This worker has no DOM, and every way out
+// (fetch, sockets, importScripts, storage) is removed before the first script
+// runs — the same hardening as the agent's scriptSandbox. In: { id, source,
+// params }. Out: { id, ok, buffers, report } with the buffers transferred, or
+// { id, ok: false, error, line }.
+//
+import { createGeometryKit, errorLine, geometryToBuffers, runGeometryScript } from '@3driseai/3drise-core';
+const BLOCKED = ['fetch', 'XMLHttpRequest', 'WebSocket', 'WebSocketStream', 'EventSource', 'importScripts', 'indexedDB', 'caches',
+    'BroadcastChannel', 'Worker', 'SharedWorker', 'Request', 'Response', 'navigator', 'location', 'open', 'close'];
+for (const name of BLOCKED) {
+    for (let o = self; o; o = Object.getPrototypeOf(o)) {
+        try {
+            if (Object.prototype.hasOwnProperty.call(o, name))
+                delete o[name];
+        }
+        catch { /* sealed */ }
+    }
+    try {
+        Object.defineProperty(self, name, { value: undefined, configurable: false, writable: false });
+    }
+    catch { /* sealed */ }
+}
+const kit = createGeometryKit();
+const post = self.postMessage.bind(self);
+self.onmessage = async (ev) => {
+    const { id, source, params } = ev.data;
+    try {
+        const { geometry, report } = await runGeometryScript(source, params, kit);
+        const buffers = geometryToBuffers(geometry);
+        geometry.dispose();
+        post({ id, ok: true, buffers, report }, [buffers.position.buffer, buffers.normal.buffer, buffers.uv.buffer]);
+    }
+    catch (e) {
+        const err = e;
+        post({ id, ok: false, error: err?.message ?? String(e), line: errorLine(e) });
+    }
+};

package/dist/utils/groundRegistry.d.ts

@@ -0,0 +1,11 @@
+import type { TerrainConfig } from '@3driseai/3drise-core';
+export type GroundProvider = (x: number, z: number) => number | null;
+export declare function registerGround(id: string, provider: GroundProvider): () => void;
+/** A provider's surface changed (same function, different answers). */
+export declare function bumpGround(): void;
+export declare const groundVersion: () => number;
+export declare const hasGround: () => boolean;
+/** Highest registered ground at world (x, z); null where nothing covers it. */
+export declare function groundHeightAt(x: number, z: number): number | null;
+export declare function heightSignature(cfg: TerrainConfig, extra?: string): string;
+//# sourceMappingURL=groundRegistry.d.ts.map

package/dist/utils/groundRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groundRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/groundRegistry.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;AAKrE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAM/E;AAED,uEAAuE;AACvE,wBAAgB,UAAU,IAAI,IAAI,CAAe;AAEjD,eAAO,MAAM,aAAa,QAAO,MAAiB,CAAC;AACnD,eAAO,MAAM,SAAS,QAAO,OAA6B,CAAC;AAE3D,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOlE;AASD,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,SAAK,GAAG,MAAM,CAItE"}

package/dist/utils/groundRegistry.js

@@ -0,0 +1,39 @@
+const providers = new Map();
+let version = 0;
+export function registerGround(id, provider) {
+    providers.set(id, provider);
+    version++;
+    return () => {
+        if (providers.get(id) === provider) {
+            providers.delete(id);
+            version++;
+        }
+    };
+}
+/** A provider's surface changed (same function, different answers). */
+export function bumpGround() { version++; }
+export const groundVersion = () => version;
+export const hasGround = () => providers.size > 0;
+/** Highest registered ground at world (x, z); null where nothing covers it. */
+export function groundHeightAt(x, z) {
+    let best = null;
+    for (const p of providers.values()) {
+        const h = p(x, z);
+        if (h !== null && Number.isFinite(h) && (best === null || h > best))
+            best = h;
+    }
+    return best;
+}
+/** The height-field knobs of a terrain config, as one string: providers compare it per frame
+ *  and bump the version only when the ground itself moved (not on a colour or texture edit). */
+const HEIGHT_KEYS = [
+    'terrainType', 'featureSize', 'octaves', 'lacunarity', 'gain', 'ridgeSharpness', 'warpStrength', 'warpSize',
+    'erosion', 'elevation', 'seaLevel', 'bearing', 'duneWavelength', 'duneAsymmetry', 'plateau', 'valleyDepth',
+    'valleyWidth', 'terraces', 'terraceSharpness',
+];
+export function heightSignature(cfg, extra = '') {
+    let s = extra;
+    for (const k of HEIGHT_KEYS)
+        s += '|' + cfg[k];
+    return s;
+}

package/dist/utils/instancingSupport.d.ts

@@ -0,0 +1,9 @@
+import type { Material } from 'three';
+/**
+ * Whether a material draws correctly on an InstancedMesh. three's built-in
+ * materials apply `instanceMatrix` in the `project_vertex` chunk; a custom
+ * ShaderMaterial does only if its vertex shader includes that chunk (or reads
+ * instanceMatrix itself). Without it every copy would draw on top of the master.
+ */
+export declare function instancingSupported(material: Material): boolean;
+//# sourceMappingURL=instancingSupport.d.ts.map

package/dist/utils/instancingSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instancingSupport.d.ts","sourceRoot":"","sources":["../../src/utils/instancingSupport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAK/D"}

package/dist/utils/instancingSupport.js

@@ -0,0 +1,13 @@
+/**
+ * Whether a material draws correctly on an InstancedMesh. three's built-in
+ * materials apply `instanceMatrix` in the `project_vertex` chunk; a custom
+ * ShaderMaterial does only if its vertex shader includes that chunk (or reads
+ * instanceMatrix itself). Without it every copy would draw on top of the master.
+ */
+export function instancingSupported(material) {
+    const m = material;
+    if (!m.isShaderMaterial && !m.isRawShaderMaterial)
+        return true;
+    const vs = m.vertexShader ?? '';
+    return vs.includes('instanceMatrix') || (!m.isRawShaderMaterial && vs.includes('#include <project_vertex>'));
+}

package/dist/utils/landPatch.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { LandObjectConfig, LandQuality, TerrainConfig, TerrainQualityConfig } from '@3driseai/3drise-core';
+import type { LandObjectConfig, LandQuality, ShapeLayoutField, TerrainConfig, TerrainQualityConfig } from '@3driseai/3drise-core';
 export declare const LAND_SEGMENTS: Record<LandQuality, number>;
 /** The seed's offset into the field, in metres. Deterministic, far apart. */
 export declare function landSeedOffset(seed: number, out?: THREE.Vector2): THREE.Vector2;
@@ -21,13 +21,34 @@ export declare function landFrame(object: THREE.Object3D, out?: LandFrame): Land
  * the camera and sun brought into terrain space. Call after applyTerrainUniforms
  * and applySunUniforms (both of which write world-space or unscaled values).
  */
-export declare function applyLandPatchUniforms(material: THREE.ShaderMaterial, cfg: LandObjectConfig, frame: LandFrame, camera: THREE.Camera): void;
+export declare function applyLandPatchUniforms(material: THREE.ShaderMaterial, cfg: LandObjectConfig, frame: LandFrame, camera: THREE.Camera, 
+/** The grid is a layout's (landLayoutGeometry): its per-vertex band replaces the rectangle's. */
+layoutActive?: boolean): void;
+/**
+ * A land that keeps to a layout, as geometry: the field (core shapeLayoutField) stretched over the
+ * patch's unit grid (-0.5…0.5 on x / z), so the object's scale stretches the island with the grid —
+ * live while dragging, no rebuild — while the terrain inside stays a window in metres. `edge`: the
+ * band at the layout's edge in unit-grid units (edgeFade, a fraction of the side).
+ */
+export interface LandLayout {
+    field: ShapeLayoutField;
+    edge: number;
+}
+/**
+ * The patch grid for a land on a layout — independent of the object's scale. The unit grid with the
+ * cells that touch the layout kept, and every kept point that lies off it moved onto the layout's
+ * edge (the outline follows the layout, not the cells). Per vertex, for TerrainMaterial's
+ * LAND_LAYOUT path: the mask with its slope (per unit) and the lift (metres) with its slope.
+ * null: nothing of the grid is on the layout.
+ */
+export declare function landLayoutGeometry(segments: number, layout: LandLayout): THREE.BufferGeometry | null;
 /**
  * Height of the land above the object's base, in terrain metres, at terrain-space
  * (tx, tz) measured from the object's centre (before rotation). Multiply nothing:
- * scale.y is already in (elevation x scale.y).
+ * scale.y is already in (elevation x scale.y). With a layout: the layout's mask in
+ * place of the rectangle's, plus its lift (x scale.y); 0 off the layout.
  */
-export declare function landHeightAt(cfg: LandObjectConfig, scale: THREE.Vector3, tx: number, tz: number, lodCell?: number): number;
+export declare function landHeightAt(cfg: LandObjectConfig, scale: THREE.Vector3, tx: number, tz: number, lodCell?: number, layout?: LandLayout | null): number;
 /** World-space height of a land object's surface under world (x, z), or null off the patch. */
-export declare function landWorldHeightAt(object: THREE.Object3D, cfg: LandObjectConfig, x: number, z: number): number | null;
+export declare function landWorldHeightAt(object: THREE.Object3D, cfg: LandObjectConfig, x: number, z: number, layout?: LandLayout | null): number | null;
 //# sourceMappingURL=landPatch.d.ts.map

package/dist/utils/landPatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"landPatch.d.ts","sourceRoot":"","sources":["../../src/utils/landPatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAgBhH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAwC,CAAC;AAE/F,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAsB,GAAG,KAAK,CAAC,OAAO,CAKrF;AAED;qCACqC;AACrC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAExE;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,oBAAoB,CAevE;AAED,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;IACxB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;IACrB,iBAAiB,EAAE,KAAK,CAAC,UAAU,CAAC;CACvC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAM5E;AAKD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,KAAK,CAAC,MAAM,GACrB,IAAI,CAiBN;AAaD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,CAOrH;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWpH"}
+{"version":3,"file":"landPatch.d.ts","sourceRoot":"","sources":["../../src/utils/landPatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAgBlI,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAwC,CAAC;AAE/F,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAsB,GAAG,KAAK,CAAC,OAAO,CAKrF;AAED;qCACqC;AACrC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAExE;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,oBAAoB,CAevE;AAED,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;IACxB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;IACrB,iBAAiB,EAAE,KAAK,CAAC,UAAU,CAAC;CACvC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAM5E;AAKD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,KAAK,CAAC,MAAM;AACpB,iGAAiG;AACjG,YAAY,UAAQ,GACrB,IAAI,CAkBN;AAcD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IAAG,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAwBrE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAkDpG;AAGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,SAAI,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAWjJ;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAYhJ"}