@3driseai/3drise-viewer 0.1.29 → 0.1.31

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

@@ -1 +1 @@
-{"version":3,"file":"CameraSingleton.d.ts","sourceRoot":"","sources":["../../src/utils/CameraSingleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsB,OAAO,EAAE,KAAK,EAAc,MAAM,OAAO,CAAC;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExF,cAAM,eAAe;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,YAAY,CAAe;;IAEnC,MAAM,CAAC,WAAW,IAAI,eAAe;IAMrC,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB5D,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAM1C,SAAS,IAAI,iBAAiB,GAAG,IAAI;IACrC,WAAW,IAAI,OAAO;IACtB,WAAW,IAAI,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAyBvG,iBAAiB,IAAI,OAAO;IAI5B,MAAM,IAAI,MAAM;IAChB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI3C,OAAO,CAAC,eAAe;IAGvB,WAAW,IAAI,OAAO;IACtB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAG5C,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAM7B,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG;QAC9C,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAClB;IAeT,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;QAC5B,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,MAAM,EAAE,OAAO,CAAC;KACnB;IAqBT,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,OAAO,GAAE,MAAU,GAAG,OAAO;IA6CvH,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAIhF,mBAAmB,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO;CAiBxD;AACD,eAAO,MAAM,aAAa,EAAE,eAA+C,CAAC;AAC5E,eAAe,aAAa,CAAC"}
+{"version":3,"file":"CameraSingleton.d.ts","sourceRoot":"","sources":["../../src/utils/CameraSingleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsB,OAAO,EAAE,KAAK,EAAc,MAAM,OAAO,CAAC;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExF,cAAM,eAAe;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,YAAY,CAAe;;IAEnC,MAAM,CAAC,WAAW,IAAI,eAAe;IAMrC,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB5D,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAM1C,SAAS,IAAI,iBAAiB,GAAG,IAAI;IACrC,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,CAAa;IAC7B,WAAW,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAChC,WAAW,IAAI,GAAG;IAClB,WAAW,IAAI,OAAO;IACtB,WAAW,IAAI,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAyBvG,iBAAiB,IAAI,OAAO;IAI5B,MAAM,IAAI,MAAM;IAChB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI3C,OAAO,CAAC,eAAe;IAGvB,WAAW,IAAI,OAAO;IACtB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAG5C,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAM7B,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG;QAC9C,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAClB;IAeT,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;QAC5B,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,MAAM,EAAE,OAAO,CAAC;KACnB;IAqBT,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,OAAO,GAAE,MAAU,GAAG,OAAO;IA6CvH,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAIhF,mBAAmB,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO;CAiBxD;AACD,eAAO,MAAM,aAAa,EAAE,eAA+C,CAAC;AAC5E,eAAe,aAAa,CAAC"}

package/dist/utils/CameraSingleton.js

@@ -43,6 +43,10 @@ class CameraSingleton {
         this.notifyCallbacks();
     }
     getCamera() { return this.camera; }
+    /** The live OrbitControls (registered by CameraController) — controllers drag it directly. */
+    controls = null;
+    setControls(controls) { this.controls = controls; }
+    getControls() { return this.controls; }
     getPosition() { return this.camera ? this.camera.position.clone() : new Vector3(); }
     getRotation() { return this.camera ? this.camera.rotation.clone() : new Euler(); }
     isSynced(position, orientation) {

package/dist/utils/deviceTier.d.ts

@@ -0,0 +1,2 @@
+export declare function isMobileDevice(): boolean;
+//# sourceMappingURL=deviceTier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deviceTier.d.ts","sourceRoot":"","sources":["../../src/utils/deviceTier.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,IAAI,OAAO,CAOxC"}

package/dist/utils/deviceTier.js

@@ -0,0 +1,16 @@
+/**
+ * Coarse device tier, for render-time quality caps. A phone or tablet: a coarse
+ * primary pointer on a small screen. Read once — it does not change while a page
+ * is open, and render code must not branch on something that flickers.
+ */
+let cached = null;
+export function isMobileDevice() {
+    if (cached !== null)
+        return cached;
+    if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+        return (cached = false);
+    const coarse = window.matchMedia('(pointer: coarse)').matches;
+    const shortSide = Math.min(window.screen?.width ?? 0, window.screen?.height ?? 0);
+    cached = coarse && shortSide > 0 && shortSide < 1000;
+    return cached;
+}

package/dist/utils/environmentDrawOrder.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Draw order of the camera-centred environment surfaces.
+ *
+ * three sorts opaque objects by renderOrder, then by MATERIAL ID, then by depth.
+ * The world ocean and the terrain clipmaps are both centred on the camera, so the
+ * depth tie never helps, and with renderOrder left at 0 the material id decides:
+ * whichever surface was created last draws last. That made the frame cost depend
+ * on mount order — measured 13 ms vs 22-27 ms GPU in the same view — because when
+ * the terrain drew first, every terrain pixel under the sea ran the full terrain
+ * shader (textures, 8 noise octaves) and was then painted over by water.
+ *
+ * Fixed order instead, all below the scene's objects (0):
+ *   1. water, inner rings first   (cheap shader; hides the seabed from the depth test)
+ *   2. terrain, inner rings first (near ground hides far ground: front to back)
+ * Drawing near-to-far is what lets the early depth test throw hidden pixels away
+ * before their shader runs. Wasted water pixels behind land are cheap; wasted
+ * terrain pixels under water were most of the frame.
+ */
+export declare const OCEAN_DRAW_ORDER = -40;
+export declare const TERRAIN_DRAW_ORDER = -20;
+/** Inner ring (level 0) first, then outward. */
+export declare const ringDrawOrder: (base: number, level: number) => number;
+//# sourceMappingURL=environmentDrawOrder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environmentDrawOrder.d.ts","sourceRoot":"","sources":["../../src/utils/environmentDrawOrder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,gDAAgD;AAChD,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,WAAiB,CAAC"}

package/dist/utils/environmentDrawOrder.js

@@ -0,0 +1,22 @@
+/**
+ * Draw order of the camera-centred environment surfaces.
+ *
+ * three sorts opaque objects by renderOrder, then by MATERIAL ID, then by depth.
+ * The world ocean and the terrain clipmaps are both centred on the camera, so the
+ * depth tie never helps, and with renderOrder left at 0 the material id decides:
+ * whichever surface was created last draws last. That made the frame cost depend
+ * on mount order — measured 13 ms vs 22-27 ms GPU in the same view — because when
+ * the terrain drew first, every terrain pixel under the sea ran the full terrain
+ * shader (textures, 8 noise octaves) and was then painted over by water.
+ *
+ * Fixed order instead, all below the scene's objects (0):
+ *   1. water, inner rings first   (cheap shader; hides the seabed from the depth test)
+ *   2. terrain, inner rings first (near ground hides far ground: front to back)
+ * Drawing near-to-far is what lets the early depth test throw hidden pixels away
+ * before their shader runs. Wasted water pixels behind land are cheap; wasted
+ * terrain pixels under water were most of the frame.
+ */
+export const OCEAN_DRAW_ORDER = -40;
+export const TERRAIN_DRAW_ORDER = -20;
+/** Inner ring (level 0) first, then outward. */
+export const ringDrawOrder = (base, level) => base + level;

package/dist/utils/pickProxy.d.ts

@@ -0,0 +1,11 @@
+import * as THREE from 'three';
+export declare const PICK_PROXY_NAME = "pickProxy";
+export declare function pickMaterial(side?: THREE.Side): THREE.MeshBasicMaterial;
+/** A unit plane proxy (scale it to the object's extent). */
+export declare function pickPlane(): THREE.Mesh;
+/** A unit sphere proxy (scale it to the object's radius). Front faces only: one hit per ray from outside. */
+export declare function pickSphere(): THREE.Mesh;
+export declare const NO_RAYCAST: () => any;
+/** Takes every object under `root` out of raycasting (the proxy is the hit target). Idempotent and cheap: safe per frame. */
+export declare function stopRaycast(root: THREE.Object3D): void;
+//# sourceMappingURL=pickProxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pickProxy.d.ts","sourceRoot":"","sources":["../../src/utils/pickProxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,wBAAgB,YAAY,CAAC,IAAI,GAAE,KAAK,CAAC,IAAuB,GAAG,KAAK,CAAC,iBAAiB,CAEzF;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,IAAI,KAAK,CAAC,IAAI,CAItC;AAED,6GAA6G;AAC7G,wBAAgB,UAAU,IAAI,KAAK,CAAC,IAAI,CAIvC;AAED,eAAO,MAAM,UAAU,WAAa,CAAC;AACrC,6HAA6H;AAC7H,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAEtD"}

package/dist/utils/pickProxy.js

@@ -0,0 +1,36 @@
+import * as THREE from 'three';
+// =============================================================================
+// Pick proxy — one invisible hit shape per object, so hover / click (the Actions tab's triggers, selection)
+// react to the object as a whole instead of to whatever its shaders happen to draw: a text hits on its box,
+// not letter by letter; a particle cloud on its volume, not on one sprite.
+//
+// The proxy is a real mesh that draws nothing (colorWrite / depthWrite off) — not `visible: false`, which the
+// event layer skips. The object's own drawing meshes opt out of raycasting (`stopRaycast`) so the proxy is the
+// only thing the pointer can land on. Its geometry also gives the selection gizmo a true bounding box.
+// =============================================================================
+export const PICK_PROXY_NAME = 'pickProxy';
+export function pickMaterial(side = THREE.DoubleSide) {
+    return new THREE.MeshBasicMaterial({ colorWrite: false, depthWrite: false, side });
+}
+/** A unit plane proxy (scale it to the object's extent). */
+export function pickPlane() {
+    const m = new THREE.Mesh(new THREE.PlaneGeometry(1, 1), pickMaterial());
+    m.name = PICK_PROXY_NAME;
+    m.frustumCulled = false;
+    m.renderOrder = -1000;
+    return m;
+}
+/** A unit sphere proxy (scale it to the object's radius). Front faces only: one hit per ray from outside. */
+export function pickSphere() {
+    const m = new THREE.Mesh(new THREE.SphereGeometry(1, 12, 8), pickMaterial(THREE.FrontSide));
+    m.name = PICK_PROXY_NAME;
+    m.frustumCulled = false;
+    m.renderOrder = -1000;
+    return m;
+}
+export const NO_RAYCAST = () => null;
+/** Takes every object under `root` out of raycasting (the proxy is the hit target). Idempotent and cheap: safe per frame. */
+export function stopRaycast(root) {
+    root.traverse((o) => { if (o.raycast !== NO_RAYCAST)
+        o.raycast = NO_RAYCAST; });
+}

package/dist/utils/shapes.d.ts

@@ -39,6 +39,10 @@ export interface ShapeOptions {
     tube?: number;
     size?: number;
     text?: string;
+    /** text: packed outline font id, extra letter advance (em), bevel on/off */
+    font?: string;
+    letterSpacing?: number;
+    bevelEnabled?: boolean;
     vertices?: number[];
     indices?: number[];
     normals?: number[];

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

@@ -1 +1 @@
-{"version":3,"file":"shapes.d.ts","sourceRoot":"","sources":["../../src/utils/shapes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shapes.d.ts","sourceRoot":"","sources":["../../src/utils/shapes.ts"],"names":[],"mappings":"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"}

package/dist/utils/shapes.js

@@ -1,5 +1,6 @@
 import { BoxGeometry, BufferGeometry, CapsuleGeometry, ConeGeometry, CylinderGeometry, DodecahedronGeometry, ExtrudeGeometry, Float32BufferAttribute, IcosahedronGeometry, OctahedronGeometry, Path, PlaneGeometry, RingGeometry, Shape, ShapeGeometry, SphereGeometry, TetrahedronGeometry, TorusGeometry, } from 'three';
 import { mergeGeometries } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
+import { buildTextGeometry, outlineFontSync } from './textShape.js';
 const safeNumber = (value, fallback, min) => {
     const num = typeof value === 'number' && !Number.isNaN(value) ? value : fallback;
     return min !== undefined ? Math.max(num, min) : num;
@@ -175,7 +176,9 @@ export const shapeGenerators = {
     octahedron: ({ radius, detail }) => new OctahedronGeometry(safeNumber(radius, 0.5, 0.0001), safeNumber(detail, 0, 0)),
     tetrahedron: ({ radius, detail }) => new TetrahedronGeometry(safeNumber(radius, 0.5, 0.0001), safeNumber(detail, 0, 0)),
     dodecahedron: ({ radius, detail }) => new DodecahedronGeometry(safeNumber(radius, 0.5, 0.0001), safeNumber(detail, 0, 0)),
-    text: ({ text = 'Hello', size, height }) => new BoxGeometry(text.length * safeNumber(size, 1, 0.0001) * 0.6, safeNumber(size, 1, 0.0001), safeNumber(height, 0.2, 0.0001)),
+    // the string extruded from a packed outline font (utils/textShape); empty until the font has loaded,
+    // GeometryShape re-renders when it lands
+    text: (o) => { const f = outlineFontSync(o.font); return f ? buildTextGeometry(f, o) : new BufferGeometry(); },
     point: ({ size }) => new SphereGeometry(safeNumber(size, 0.1, 0.0001), 16, 16),
     custom: ({ vertices = [], indices = [], normals, uvs }) => {
         const geometry = new BufferGeometry();

package/dist/utils/terrainUniforms.d.ts

@@ -2,6 +2,13 @@ import * as THREE from 'three';
 import type { TerrainConfig, TerrainQualityConfig } from '@3driseai/3drise-core';
 import type { TerrainTextureState } from '../hooks/useTerrainTextures';
 import type { CloudSunState } from '../hooks/useCloudSun';
+/**
+ * The height field's own uniforms (terrainFormUniforms): landform, scale, octaves,
+ * warp, erosion, shaping. Shared by the terrain material and by every material that
+ * includes `terrainFieldOnly` to read the ground — the ocean, for its shoreline —
+ * so the two can never disagree about where the ground is.
+ */
+export declare function applyTerrainFieldUniforms(material: THREE.ShaderMaterial, config: TerrainConfig): void;
 export declare function applyTerrainUniforms(material: THREE.ShaderMaterial, config: TerrainConfig, quality: TerrainQualityConfig): void;
 export default applyTerrainUniforms;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"terrainUniforms.d.ts","sourceRoot":"","sources":["../../src/utils/terrainUniforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAe,MAAM,uBAAuB,CAAC;AAE9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoD1D,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,oBAAoB,GAC9B,IAAI,CAwDN;AAED,eAAe,oBAAoB,CAAC;AAUpC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,mBAAmB,GACzB,IAAI,CAyDN;AAiCD,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CA4BlG;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAwC5F"}
+{"version":3,"file":"terrainUniforms.d.ts","sourceRoot":"","sources":["../../src/utils/terrainUniforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAe,MAAM,uBAAuB,CAAC;AAE9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoD1D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAwBrG;AAED,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,oBAAoB,GAC9B,IAAI,CAqCN;AAED,eAAe,oBAAoB,CAAC;AAUpC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,mBAAmB,GACzB,IAAI,CAyDN;AAiCD,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CA4BlG;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAwC5F"}

package/dist/utils/terrainUniforms.js

@@ -45,9 +45,15 @@ function setColor(uniform, hex) {
         return;
     uniform.value.setStyle(hex, THREE.SRGBColorSpace);
 }
-export function applyTerrainUniforms(material, config, quality) {
+/**
+ * The height field's own uniforms (terrainFormUniforms): landform, scale, octaves,
+ * warp, erosion, shaping. Shared by the terrain material and by every material that
+ * includes `terrainFieldOnly` to read the ground — the ocean, for its shoreline —
+ * so the two can never disagree about where the ground is.
+ */
+export function applyTerrainFieldUniforms(material, config) {
     const u = material.uniforms;
-    if (!u)
+    if (!u || !u.u_terrainType)
         return;
     u.u_terrainType.value = TYPE_INDEX[config.terrainType] ?? 2;
     u.u_elevation.value = Math.max(config.elevation, 0.01);
@@ -68,6 +74,13 @@ export function applyTerrainUniforms(material, config, quality) {
     u.u_plateau.value = config.plateau;
     u.u_valleyDepth.value = config.valleyDepth;
     u.u_valleyWidth.value = config.valleyWidth;
+    u.u_shadowSoftness.value = config.shadowSoftness;
+}
+export function applyTerrainUniforms(material, config, quality) {
+    const u = material.uniforms;
+    if (!u)
+        return;
+    applyTerrainFieldUniforms(material, config);
     setColor(u.u_lowColor, config.lowColor);
     setColor(u.u_midColor, config.midColor);
     setColor(u.u_rockColor, config.rockColor);

package/dist/utils/textShape.d.ts

@@ -0,0 +1,24 @@
+import { BufferGeometry } from 'three';
+export declare const DEFAULT_TEXT_SHAPE_FONT = "inter";
+export declare const isOutlineFontLoaded: (id: string | undefined) => boolean;
+/** The packed outline font when it is already loaded, else null (and the load is started). */
+export declare function outlineFontSync(id: string | undefined): any | null;
+/** Loads (once) and caches a packed outline font. */
+export declare function loadOutlineFont(id: string | undefined): Promise<any>;
+export interface TextShapeOptions {
+    text?: string;
+    font?: string;
+    /** Em size in world units. */
+    size?: number;
+    /** Extrusion depth in world units. */
+    height?: number;
+    /** Extra advance between letters, in em. */
+    letterSpacing?: number;
+    bevelEnabled?: boolean;
+    bevelThickness?: number;
+    bevelSize?: number;
+    bevelSegments?: number;
+}
+/** The string as an extruded, centred geometry. `font` is a loaded packed outline font (outlineFontSync / loadOutlineFont). */
+export declare function buildTextGeometry(font: any, o: TextShapeOptions): BufferGeometry;
+//# sourceMappingURL=textShape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textShape.d.ts","sourceRoot":"","sources":["../../src/utils/textShape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgC,MAAM,OAAO,CAAC;AAgBrE,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAG/C,eAAO,MAAM,mBAAmB,GAAI,IAAI,MAAM,GAAG,SAAS,KAAG,OAAgC,CAAC;AAE9F,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAMlE;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAUpE;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAqBD,+HAA+H;AAC/H,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,gBAAgB,GAAG,cAAc,CAgChF"}

package/dist/utils/textShape.js

@@ -0,0 +1,102 @@
+import { BufferGeometry, ExtrudeGeometry, Path, Shape } from 'three';
+import { layoutOutline } from '../components/text/engine/glyphs.js';
+import { loadOutline, TEXT_FONT_IDS } from '../components/text/fonts/index.js';
+// =============================================================================
+// Mesh text — the `text` shape of the mesh family: the string extruded into a solid, from the same packed
+// outline fonts the text looks use (components/text/fonts), so one font list serves every text in 3drise.
+//
+// The outline fonts load lazily (one import() per font, a few hundred KB each). Shape generators are
+// synchronous, so a font is read from this cache; the first build of a font yields an empty geometry and
+// starts the load, and GeometryShape re-renders once it lands (useTextShapeFont).
+// =============================================================================
+const fonts = new Map();
+const pending = new Map();
+export const DEFAULT_TEXT_SHAPE_FONT = 'inter';
+const fontId = (id) => (id && TEXT_FONT_IDS.includes(id) ? id : DEFAULT_TEXT_SHAPE_FONT);
+export const isOutlineFontLoaded = (id) => fonts.has(fontId(id));
+/** The packed outline font when it is already loaded, else null (and the load is started). */
+export function outlineFontSync(id) {
+    const k = fontId(id);
+    const f = fonts.get(k);
+    if (f)
+        return f;
+    void loadOutlineFont(k);
+    return null;
+}
+/** Loads (once) and caches a packed outline font. */
+export function loadOutlineFont(id) {
+    const k = fontId(id);
+    const f = fonts.get(k);
+    if (f)
+        return Promise.resolve(f);
+    let p = pending.get(k);
+    if (!p) {
+        p = loadOutline(k).then((font) => { fonts.set(k, font); pending.delete(k); return font; });
+        pending.set(k, p);
+    }
+    return p;
+}
+// even-odd point in polygon (flat [x, y, ...] array)
+function inside(px, py, p) {
+    let c = false;
+    const n = p.length / 2;
+    for (let i = 0, j = n - 1; i < n; j = i++) {
+        const xi = p[2 * i], yi = p[2 * i + 1], xj = p[2 * j], yj = p[2 * j + 1];
+        if (((yi > py) !== (yj > py)) && (px < ((xj - xi) * (py - yi)) / (yj - yi) + xi))
+            c = !c;
+    }
+    return c;
+}
+const pathOf = (pts, P, s) => {
+    // layoutOutline closes every contour by repeating its first point: drop it, Shape closes itself
+    const n = pts.length / 2 - 1;
+    P.moveTo(pts[0] * s, pts[1] * s);
+    for (let i = 1; i < n; i++)
+        P.lineTo(pts[2 * i] * s, pts[2 * i + 1] * s);
+    P.closePath();
+    return P;
+};
+/** The string as an extruded, centred geometry. `font` is a loaded packed outline font (outlineFontSync / loadOutlineFont). */
+export function buildTextGeometry(font, o) {
+    const size = Math.max(1e-4, o.size ?? 1), depth = Math.max(1e-4, o.height ?? 0.2);
+    const text = String(o.text ?? 'Hello');
+    const layout = layoutOutline(font, text.length ? text : ' ', { align: 'center', letterSpacing: o.letterSpacing ?? 0 });
+    const shapes = [];
+    // contours come per glyph, outer first then counters (layoutOutline sorts them so); a counter belongs to the
+    // outer contour of its glyph that contains it
+    const byGlyph = new Map();
+    for (const s of layout.strokes) {
+        let g = byGlyph.get(s.glyph);
+        if (!g) {
+            g = { outers: [], holes: [] };
+            byGlyph.set(s.glyph, g);
+        }
+        if (s.hole)
+            g.holes.push(s.pts);
+        else {
+            const shape = pathOf(s.pts, new Shape(), size);
+            g.outers.push({ pts: s.pts, shape });
+            shapes.push(shape);
+        }
+    }
+    for (const g of byGlyph.values()) {
+        if (!g.outers.length)
+            continue;
+        for (const h of g.holes) {
+            const owner = g.outers.find((oc) => inside(h[0], h[1], oc.pts.subarray(0, oc.pts.length - 2))) ?? g.outers[0];
+            owner.shape.holes.push(pathOf(h, new Path(), size));
+        }
+    }
+    if (!shapes.length)
+        return new BufferGeometry();
+    const bevel = !!o.bevelEnabled;
+    const geo = new ExtrudeGeometry(shapes, {
+        depth, curveSegments: 1, bevelEnabled: bevel,
+        bevelThickness: bevel ? Math.max(0, o.bevelThickness ?? 0.03) : 0,
+        bevelSize: bevel ? Math.max(0, o.bevelSize ?? 0.02) : 0,
+        bevelOffset: 0,
+        bevelSegments: bevel ? Math.max(1, Math.round(o.bevelSegments ?? 3)) : 1,
+    });
+    geo.center();
+    return geo;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3driseai/3drise-viewer",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -39,6 +39,6 @@
   },
   "dependencies": {
     "@3driseai/3drise-common": "^1.0.1",
-    "@3driseai/3drise-core": "^1.0.22"
+    "@3driseai/3drise-core": "^1.0.24"
   }
 }