@3driseai/3drise-viewer 0.1.29 → 0.1.30

package/dist/operations/catalogue/unweave.js

@@ -6,7 +6,8 @@
 //        of light beyond the object on that side (left/right: screen, at trigger)
 //   random   every thread segment flies off on its own heading and fades
 //   scale    the whole thread sculpture expands outward, keeping its shape, and fades
-// With dispersing off, the object simply stays as a woven thread sculpture.
+// With Disappear off (an object effect's default) the object stays as a woven thread
+// sculpture and holds: light pulses run along the rings, threads shimmer.
 // Reverting weaves the object back together.
 import { AdditiveBlending, BufferAttribute, BufferGeometry, Color, LineSegments, Matrix4, ShaderMaterial, Vector3 } from 'three';
 import { defineOperation } from '../types.js';
@@ -19,6 +20,8 @@ const KEY = 'unweave';
 const STATE = '__opUnweave';
 const MAX_TRIS = 300_000;
 const MAX_SEGMENTS = 200_000;
+/** The threads run on past the surface (0 → 1) to 1.6 while dispersing. */
+const END = 1.6;
 const MODES = ['up', 'down', 'left', 'right', 'random', 'scale'];
 /** Slice every mesh of the target with `levels` horizontal planes (root space). */
 function contourSegments(target, levels) {
@@ -76,17 +79,19 @@ function contourSegments(target, levels) {
 export default defineOperation({
     value: 'unweave',
     label: 'Unweave',
-    description: 'Re-draw the targets as glowing threads that unravel into a point of light — reverting weaves them back',
+    description: 'Re-draw the targets as glowing threads that unravel into a point of light (or, Disappear off, stay as a thread sculpture) — reverting weaves them back',
     channel: 'visual',
     multi: true,
     toggles: true,
-    usableIn: ['interaction', 'action'],
+    usableIn: ['interaction', 'action', 'object'],
+    objectParams: { disappear: false },
+    // no presence: with Disappear off the look decorates the object (it appears, then is re-drawn); on, it is the entrance / exit
     params: {
         color: { type: 'color', label: 'Thread', default: '#ffcf7a' },
         threads: { type: 'number', label: 'Threads', default: 56, min: 8, max: 200, step: 1, hint: 'Contour lines from bottom to top' },
-        disperse: { type: 'boolean', label: 'Disperse', default: true, hint: 'Off: the object stays as a thread sculpture' },
+        disappear: { type: 'boolean', label: 'Disappear', default: true, hint: 'Off: the object stays as a glowing thread sculpture' },
         mode: {
-            type: 'select', label: 'Dispersal', default: 'up',
+            type: 'select', label: 'Dispersal', default: 'up', showWhen: { disappear: ['true'] },
             options: [
                 { value: 'up', label: 'Unravel upward' }, { value: 'down', label: 'Unravel downward' },
                 { value: 'left', label: 'Unravel left → right' }, { value: 'right', label: 'Unravel right → left' },
@@ -114,7 +119,7 @@ export default defineOperation({
                 uniforms: uniforms,
                 vertexShader: `${decl}
 attribute float aUnwLevel; attribute float aUnwAng; attribute float aUnwRand;
-varying float vUnwA; varying float vUnwU;
+varying float vUnwA; varying float vUnwU; varying float vUnwL; varying float vUnwR;
 ${fieldGlsl(P)}
 ${GLSL_ROT}
 void main() {
@@ -136,6 +141,7 @@ void main() {
   float u = clamp((prog - 0.55 - delay * 0.9) / 0.4, 0.0, 1.0) * uUnwDisperse;
   u = u * u * (3.0 - 2.0 * u);
   vUnwU = u;
+  vUnwL = s; vUnwR = aUnwRand;
   vec3 p;
   if (uUnwMode < 3.5) {
     vec3 rel = fxRot(ax, u * (2.5 + aUnwRand)) * rel0;
@@ -152,10 +158,16 @@ void main() {
   gl_Position = projectionMatrix * modelViewMatrix * vec4(p, 1.0);
 }`,
                 fragmentShader: `
-uniform vec3 uUnwColor; varying float vUnwA; varying float vUnwU;
+uniform vec3 uUnwColor; uniform float uUnwTime; uniform float uUnwDisperse; uniform float uUnwProgress;
+varying float vUnwA; varying float vUnwU; varying float vUnwL; varying float vUnwR;
 void main() {
   float a = vUnwA * (1.0 - smoothstep(0.85, 1.0, vUnwU));
-  vec3 c = uUnwColor * (1.2 + 2.5 * vUnwU);
+  // holding as a sculpture: a pulse of light climbs the rings, threads shimmer
+  float held = (1.0 - uUnwDisperse) * step(0.9999, uUnwProgress);
+  float pulse = 0.5 + 0.5 * sin((vUnwL * 7.0 - uUnwTime * 1.3) * 6.2832);
+  float shimmer = 0.6 + 0.4 * sin(uUnwTime * (2.0 + 3.0 * vUnwR) + vUnwR * 40.0);
+  float glow = mix(1.0, 0.55 + 0.9 * pulse * pulse + 0.35 * shimmer, held);
+  vec3 c = uUnwColor * (1.2 + 2.5 * vUnwU) * glow;
   gl_FragColor = vec4(c * a, a);
   #include <tonemapping_fragment>
   #include <colorspace_fragment>
@@ -186,7 +198,7 @@ void main() {
         s.color.value.set(String(p.color));
         const mode = MODES.includes(String(p.mode)) ? String(p.mode) : 'up';
         s.mode.value = MODES.indexOf(mode);
-        s.disperse.value = p.disperse === false ? 0 : 1;
+        s.disperse.value = p.disappear === false ? 0 : 1;
         if (mode === 'up')
             s.axis.value.set(0, 1, 0);
         else if (mode === 'down')
@@ -205,12 +217,18 @@ void main() {
             s.field.sweep.value.copy(s.axis.value).negate();
         }
         s.lines.visible = true;
-        const keep = s.disperse.value === 0;
-        // 0 → 1: surface goes (field clamps at 1); the threads run on to 1.6
-        return runProgress(target, s.field, 1.6, {
+        if (s.disperse.value === 0) {
+            // keep: the surface goes (0 → 1), the sculpture stays and holds
+            return runProgress(target, s.field, 1, {
+                duration: Number(p.duration) * (1 / END), ease: 'none', hold: true,
+                onComplete: () => hideMeshes(target, KEY, true),
+            });
+        }
+        hideMeshes(target, KEY, false);
+        // 0 → 1: surface goes (field clamps at 1); the threads run on to END
+        return runProgress(target, s.field, END, {
             duration: Number(p.duration), ease: 'none',
-            onComplete: () => { hideMeshes(target, KEY, true); if (!keep)
-                s.lines.visible = false; },
+            onComplete: () => { hideMeshes(target, KEY, true); s.lines.visible = false; },
         });
     },
     revert(target, p) {
@@ -219,8 +237,9 @@ void main() {
             return;
         hideMeshes(target, KEY, false);
         s.lines.visible = true;
+        // from a hold it only has part of the way to go: keep the same speed
         return runProgress(target, s.field, 0, {
-            duration: Number(p.duration), ease: 'none',
+            duration: Number(p.duration) * Math.min(1, Math.max(0.1, s.field.progress.value / END)), ease: 'none',
             onComplete: () => {
                 s.mats.forEach(m => removeLayer(m, KEY));
                 s.lines.removeFromParent();

package/dist/operations/catalogue/voxelize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voxelize.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/voxelize.ts"],"names":[],"mappings":";AAsDA,wBAoFG"}
+{"version":3,"file":"voxelize.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/voxelize.ts"],"names":[],"mappings":";AA0DA,wBA2GG"}

package/dist/operations/catalogue/voxelize.js

@@ -4,6 +4,8 @@
 // passes, the surface goes and its voxel pops in with a brief flash; a moment
 // later the voxel lifts off along the surface normal and upward, tumbling and
 // shrinking. Reverting flies every cube back and the surface re-forms.
+// With Disappear off (an object effect's default) the whole object stays digitised:
+// every cube in place, and holds — a scan line climbs the rows, a few cubes flicker.
 import { BoxGeometry } from 'three';
 import { defineOperation } from '../types.js';
 import { GLSL_ROT, addLayer, forEachMeshMaterial, removeLayer } from './shaderLayers.js';
@@ -14,6 +16,8 @@ const P = 'Vox';
 const KEY = 'voxelize';
 const STATE = '__opVoxelize';
 const LIFE = 0.75;
+/** Keep: the voxel age is clamped here — popped in, flash gone, not yet lifting off. */
+const KEEP_AGE = 0.28;
 /** Quantise surface samples to a grid: one voxel per occupied cell, averaged. */
 function buildVoxels(target, resolution) {
     const sample = sampleSurfaceCached(target, 40000, 37);
@@ -61,15 +65,18 @@ function buildVoxels(target, resolution) {
 export default defineOperation({
     value: 'voxelize',
     label: 'Voxelise',
-    description: 'Digitise the targets into cubes that peel off and float away — reverting clicks them back',
+    description: 'Digitise the targets into cubes that peel off and float away (or, Disappear off, stay as a voxel model) — reverting clicks them back',
     channel: 'visual',
     multi: true,
     toggles: true,
-    usableIn: ['interaction', 'action'],
+    usableIn: ['interaction', 'action', 'object'],
+    objectParams: { disappear: false },
+    // no presence: with Disappear off the look decorates the object (it appears, then is re-drawn); on, it is the entrance / exit
     params: {
         direction: { type: 'select', label: 'Direction', default: 'up', options: DIRECTION_OPTIONS },
         resolution: { type: 'number', label: 'Resolution', default: 26, min: 6, max: 70, step: 1, hint: 'Cubes across the object’s largest side' },
-        lift: { type: 'number', label: 'Float', default: 1, min: 0, max: 4, step: 0.05, unit: '×' },
+        lift: { type: 'number', label: 'Float', default: 1, min: 0, max: 4, step: 0.05, unit: '×', showWhen: { disappear: ['true'] } },
+        disappear: { type: 'boolean', label: 'Disappear', default: true, hint: 'Off: the object stays as a model of cubes' },
         edgeColor: { type: 'color', label: 'Scan colour', default: '#7fe3ff' },
         scale: { type: 'number', label: 'Pattern', default: 2, min: 0.5, max: 12, step: 0.1 },
         duration: { type: 'number', label: 'Duration', default: 3, min: 0.3, max: 12, step: 0.1, unit: 's' },
@@ -79,7 +86,7 @@ export default defineOperation({
         if (!st) {
             const field = createFieldState(target);
             field.edgeWidth.value = 0.04;
-            const life = { value: LIFE }, lift = { value: 1 };
+            const life = { value: LIFE }, lift = { value: 1 }, keep = { value: 0 };
             const vox = buildVoxels(target, Math.round(Number(p.resolution)));
             const s = vox.cell * 0.94;
             const mesh = createFxInstances(target, {
@@ -88,11 +95,11 @@ export default defineOperation({
                 attributes: { aVoxP: [vox.positions, 3], aVoxN: [vox.normals, 3], aVoxR: [vox.rand, 4] },
                 layerKey: 'voxelInstances', roughness: 0.55, metalness: 0.05,
                 layer: {
-                    uniforms: { ...fieldUniforms(P, field), uVoxLife: life, uVoxLift: lift },
-                    common: `varying float vVoxFlash;\n${fieldGlsl(P)}\n${GLSL_ROT}`,
+                    uniforms: { ...fieldUniforms(P, field), uVoxLife: life, uVoxLift: lift, uVoxKeep: keep },
+                    common: `varying float vVoxFlash; varying float vVoxHold; varying vec2 vVoxYR;\n${fieldGlsl(P)}\n${GLSL_ROT}`,
                     vertexPars: /* glsl */ `
                     attribute vec3 aVoxP; attribute vec3 aVoxN; attribute vec4 aVoxR;
-                    float voxAge() { return (uVoxProgress - VoxBirthOf(VoxField(VoxNorm(aVoxP)))) / uVoxLife; }
+                    float voxAge() { const float KEEP_AGE = ${KEEP_AGE.toFixed(2)}; float a = (uVoxProgress - VoxBirthOf(VoxField(VoxNorm(aVoxP)))) / uVoxLife; return mix(a, min(a, KEEP_AGE), uVoxKeep); }
                     mat3 voxSpin(float a) { float fly = smoothstep(0.3, 1.0, a); return fxRot(normalize(aVoxR.xyz - 0.5 + vec3(1e-3)), fly * fly * (2.0 + 3.0 * aVoxR.w)); }`,
                     normal: `{ objectNormal = voxSpin(voxAge()) * objectNormal; }`,
                     vertex: /* glsl */ `
@@ -106,11 +113,21 @@ export default defineOperation({
                                + (aVoxR.xyz - 0.5) * E * 0.25 * fly;
                       transformed = voxSpin(a) * (transformed * sc) + off;
                       vVoxFlash = pop * (1.0 - smoothstep(0.1, 0.24, a));
+                      // holding as a voxel model
+                      vVoxHold = uVoxKeep * step(0.9999, uVoxProgress);
+                      vVoxYR = vec2(VoxNorm(aVoxP).y, aVoxR.w);
+                    }`,
+                    emissive: /* glsl */ `
+                    {
+                      // a scan line climbs the rows now and then; a few cubes flicker
+                      float scan = fract(uVoxTime * 0.22);
+                      float line = exp(-pow((vVoxYR.x - scan * 1.2 + 0.1) * 18.0, 2.0));
+                      float flick = step(0.955, vVoxYR.y) * (0.5 + 0.5 * sin(uVoxTime * (7.0 + 9.0 * vVoxYR.y) + vVoxYR.y * 50.0));
+                      totalEmissiveRadiance += uVoxEdgeColor * (vVoxFlash * 0.7 + vVoxHold * (0.35 * line + 0.3 * flick * flick));
                     }`,
-                    emissive: `totalEmissiveRadiance += uVoxEdgeColor * vVoxFlash * 0.7;`,
                 },
             });
-            st = { field, life, lift, mesh, mats: new Set() };
+            st = { field, life, lift, keep, mesh, mats: new Set() };
             const own = st;
             const layer = surfaceLayer(P, field, 'tint');
             forEachMeshMaterial(target, (mat, m) => {
@@ -125,6 +142,15 @@ export default defineOperation({
         setFieldParams(s.field, p, target, ctx);
         s.lift.value = Number(p.lift);
         s.mesh.visible = true;
+        s.keep.value = p.disappear === false ? 1 : 0;
+        if (s.keep.value) {
+            // keep: the surface goes (0 → 1), every cube stays in place and holds
+            return runProgress(target, s.field, 1, {
+                duration: Number(p.duration) / (1 + LIFE), ease: 'none', hold: true,
+                onComplete: () => hideMeshes(target, KEY, true),
+            });
+        }
+        hideMeshes(target, KEY, false);
         return runProgress(target, s.field, 1 + LIFE, {
             duration: Number(p.duration), ease: 'none',
             onComplete: () => { hideMeshes(target, KEY, true); s.mesh.visible = false; },
@@ -136,8 +162,9 @@ export default defineOperation({
             return;
         hideMeshes(target, KEY, false);
         s.mesh.visible = true;
+        // from a hold it only has part of the way to go: keep the same speed
         return runProgress(target, s.field, 0, {
-            duration: Number(p.duration), ease: 'none',
+            duration: Number(p.duration) * Math.min(1, Math.max(0.1, s.field.progress.value / (1 + LIFE))), ease: 'none',
             onComplete: () => {
                 s.mats.forEach(m => removeLayer(m, KEY));
                 disposeFxInstances(s.mesh);

package/dist/triggers/engine.d.ts

@@ -17,7 +17,7 @@ export interface RunOptions {
     catalog?: TriggerCatalog;
     effects?: boolean;
 }
-export type RunResult = 'ran' | 'queued' | 'waiting' | 'cycle' | 'refused' | 'unknown' | 'invalid';
+export type RunResult = 'ran' | 'queued' | 'waiting' | 'cycle' | 'refused' | 'unknown' | 'invalid' | 'off';
 export interface EngineContext extends TriggerContext {
     catalog: TriggerCatalog;
 }

package/dist/triggers/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/triggers/engine.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjE,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAChD,IAAI,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACrD,KAAK,CAAC,IAAI,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9B,sFAAsF;IACtF,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnG,MAAM,WAAW,aAAc,SAAQ,cAAc;IACjD,OAAO,EAAE,cAAc,CAAC;CAC3B;AAmBD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAG1E;AAYD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAI7E;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CAIrF;AAED,uEAAuE;AACvE,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,aAAa,GAAG,SAA4B,CAAC;AAEvF,oEAAoE;AACpE,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAG9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,CAiCzE;AA6CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAGrI;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,IAAI,IAAI,CAAoB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/triggers/engine.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjE,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAChD,IAAI,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACrD,KAAK,CAAC,IAAI,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9B,sFAAsF;IACtF,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3G,MAAM,WAAW,aAAc,SAAQ,cAAc;IACjD,OAAO,EAAE,cAAc,CAAC;CAC3B;AAmBD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAG1E;AAYD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAI7E;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CAIrF;AAED,uEAAuE;AACvE,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,aAAa,GAAG,SAA4B,CAAC;AAEvF,oEAAoE;AACpE,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAG9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,CAmCzE;AA6CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAGrI;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,IAAI,IAAI,CAAoB"}

package/dist/triggers/engine.js

@@ -62,6 +62,9 @@ export function currentChain() {
 export function runCommand(cmd, opts) {
     if (!cmd || typeof cmd !== 'object' || !cmd.kind)
         return 'invalid';
+    // an effect switched off in its list is kept but never runs (a revert still goes through: it may have been on)
+    if (cmd.kind === 'effect' && cmd.effect?.enabled === false && cmd.command !== 'revert')
+        return 'off';
     const top = stack[stack.length - 1];
     const ctx = {
         source: opts.source,

package/dist/triggers/hosts/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/triggers/hosts/actions.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG3F,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,YAAY,EACrC,CAAC;AAE9D,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAAI,QAAQ,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,eAAe,EAClB,CAAC;AAEnF,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAUxF"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/triggers/hosts/actions.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG3F,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,YAAY,EACrC,CAAC;AAE9D,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAAI,QAAQ,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,eAAe,EACY,CAAC;AAEjH,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAUxF"}

package/dist/triggers/hosts/actions.js

@@ -2,7 +2,7 @@ import { runCommand } from '../engine.js';
 /** An action's commands, in the order they run. */
 export const actionCommandsOf = (action) => (Array.isArray(action?.commands) ? action.commands : []);
 /** The effects among an action's commands (to pre-warm their shaders). */
-export const actionEffectsOf = (action) => actionCommandsOf(action).flatMap(c => (c.kind === 'effect' ? [c.effect] : []));
+export const actionEffectsOf = (action) => actionCommandsOf(action).flatMap(c => (c.kind === 'effect' && c.effect.enabled !== false ? [c.effect] : []));
 /** Switch an action's commands on (apply) or off (revert). */
 export function runActionCommands(action, mode) {
     const source = { host: 'action', id: action.id };

package/dist/triggers/hosts/interactions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../../src/triggers/hosts/interactions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvE,wDAAwD;AACxD,eAAO,MAAM,UAAU,GAAI,aAAa,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,YAAY,EACvB,CAAC;AAExE,+EAA+E;AAC/E,eAAO,MAAM,SAAS,GAAI,aAAa,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,sDACG,CAAC"}
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../../src/triggers/hosts/interactions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvE,wDAAwD;AACxD,eAAO,MAAM,UAAU,GAAI,aAAa,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,YAAY,EACvB,CAAC;AAExE,+EAA+E;AAC/E,eAAO,MAAM,SAAS,GAAI,aAAa,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,sDACiC,CAAC"}

package/dist/triggers/hosts/interactions.js

@@ -1,4 +1,4 @@
 /** An interaction's commands, in the order they run. */
 export const commandsOf = (interaction) => (Array.isArray(interaction?.commands) ? interaction.commands : []);
 /** The effects among an interaction's commands (to pre-warm their shaders). */
-export const effectsOf = (interaction) => commandsOf(interaction).flatMap(c => (c.kind === 'effect' ? [c.effect] : []));
+export const effectsOf = (interaction) => commandsOf(interaction).flatMap(c => (c.kind === 'effect' && c.effect.enabled !== false ? [c.effect] : []));

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/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.30",
   "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.23"
   }
 }