@3driseai/3drise-viewer 0.1.29 → 0.1.31

package/dist/components/particles/GrinderSparksParticles.d.ts

@@ -12,6 +12,11 @@ export interface GrinderSparksParticlesProps extends ObjectReadyProps {
     /** Per-domain keyframes; the `particles` domain drives this object's config knobs. */
     animations?: ObjectAnimations;
 }
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export declare const BOUNDS: {
+    center: number[];
+    radius: number;
+};
 declare const GrinderSparksParticles: React.FC<GrinderSparksParticlesProps>;
 export default GrinderSparksParticles;
 //# sourceMappingURL=GrinderSparksParticles.d.ts.map

package/dist/components/particles/GrinderSparksParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GrinderSparksParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/GrinderSparksParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACjE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;IACrC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA8pBD,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAqDjE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"GrinderSparksParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/GrinderSparksParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACjE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;IACrC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA4ID,gHAAgH;AAChH,eAAO,MAAM,MAAM;;;CAA0C,CAAC;AAkhB9D,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAqDjE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/components/particles/GrinderSparksParticles.js

@@ -139,7 +139,8 @@ const TR_MODE = { streak: TR, comet: 0.03, echo: 0.04 }; // arcs and smoulder lo
 // the editor's selection box and gizmo centre on the visible spray, not on the wheel.
 const C0 = [-1.3, 0.95, 0]; // contact point at rest (m)
 const SPRAY_MID = [-0.4, 0.6, 0];
-const BOUNDS = { center: [-0.2, 0.7, 0], radius: 2.3 };
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export const BOUNDS = { center: [-0.2, 0.7, 0], radius: 2.3 };
 const RHO_C = 7800 * 600; // steel density x heat capacity
 const SIGMA = 5.67e-8, EPS = 0.8, T_AIR = 300;
 const EL0 = -0.26; // rest elevation of the fan (rad)

package/dist/components/particles/MagneticBottleParticles.d.ts

@@ -12,6 +12,11 @@ export interface MagneticBottleParticlesProps extends ObjectReadyProps {
     /** Per-domain keyframes; the `particles` domain drives this object's config knobs. */
     animations?: ObjectAnimations;
 }
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export declare const BOUNDS: {
+    center: number[];
+    radius: number;
+};
 declare const MagneticBottleParticles: React.FC<MagneticBottleParticlesProps>;
 export default MagneticBottleParticles;
 //# sourceMappingURL=MagneticBottleParticles.d.ts.map

package/dist/components/particles/MagneticBottleParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MagneticBottleParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/MagneticBottleParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,4BAA6B,SAAQ,gBAAgB;IAClE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,6BAA6B,CAAC;IACtC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA6gBD,QAAA,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAuDnE,CAAC;AAEF,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"MagneticBottleParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/MagneticBottleParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO9G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,4BAA6B,SAAQ,gBAAgB;IAClE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,6BAA6B,CAAC;IACtC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAmHD,gHAAgH;AAChH,eAAO,MAAM,MAAM;;;CAAsC,CAAC;AA0Z1D,QAAA,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAuDnE,CAAC;AAEF,eAAe,uBAAuB,CAAC"}

package/dist/components/particles/MagneticBottleParticles.js

@@ -116,7 +116,8 @@ const H_STEP = 1 / 120;
 const V0 = 0.9; // speed along the orbit (units / s) at speed 1
 const TRAIL_LOOK = { streak: 0.25, comet: 1, echo: 1 };
 const TRAIL_ALPHA = { streak: 1.6, comet: 2, echo: 3 };
-const BOUNDS = { center: [0, 0, 0], radius: 1.25 };
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export const BOUNDS = { center: [0, 0, 0], radius: 1.25 };
 function createUniforms() {
     return {
         uTime: { value: 0 },

package/dist/components/particles/NeonRainParticles.d.ts

@@ -12,6 +12,11 @@ export interface NeonRainParticlesProps extends ObjectReadyProps {
     /** Per-domain keyframes; the `particles` domain drives this object's config knobs. */
     animations?: ObjectAnimations;
 }
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export declare const BOUNDS: {
+    center: number[];
+    radius: number;
+};
 declare const NeonRainParticles: React.FC<NeonRainParticlesProps>;
 export default NeonRainParticles;
 //# sourceMappingURL=NeonRainParticles.d.ts.map

package/dist/components/particles/NeonRainParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NeonRainParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/NeonRainParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMxG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC5D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,uBAAuB,CAAC;IAChC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAinBD,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAqDvD,CAAC;AAEF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"NeonRainParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/NeonRainParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMxG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC5D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,uBAAuB,CAAC;IAChC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA4HD,gHAAgH;AAChH,eAAO,MAAM,MAAM;;;CAAsC,CAAC;AAqf1D,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAqDvD,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/components/particles/NeonRainParticles.js

@@ -124,7 +124,8 @@ const H_STEP = 1 / 60;
 const GRAV = 9.81;
 const TR_MODE = { streak: 0.04, comet: 0.06, echo: 0.08 }; // physics seconds per trail unit
 const TRAIL_GAIN = { streak: 3, comet: 3.5, echo: 4.5 };
-const BOUNDS = { center: [0, 0, 0], radius: 1.75 };
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export const BOUNDS = { center: [0, 0, 0], radius: 1.75 };
 // neon light sources behind the rain (never drawn): segments [x0, y0, x1, y1, colour index], and a ring [cx, cy, r, colour]
 const SEGS = [[-0.9, -0.35, -0.9, 0.65, 0]];
 const RING = [0.78, 0.2, 0.3, 1];

package/dist/components/particles/ShapeBurstParticles.d.ts

@@ -12,6 +12,11 @@ export interface ShapeBurstParticlesProps extends ObjectReadyProps {
     /** Per-domain keyframes; the `particles` domain drives this object's config knobs. */
     animations?: ObjectAnimations;
 }
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export declare const BOUNDS: {
+    center: number[];
+    radius: number;
+};
 declare const ShapeBurstParticles: React.FC<ShapeBurstParticlesProps>;
 export default ShapeBurstParticles;
 //# sourceMappingURL=ShapeBurstParticles.d.ts.map

package/dist/components/particles/ShapeBurstParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShapeBurstParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/ShapeBurstParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,yBAAyB,CAAC;IAClC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA4eD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAuD3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"ShapeBurstParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/ShapeBurstParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,yBAAyB,CAAC;IAClC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA8HD,gHAAgH;AAChH,eAAO,MAAM,MAAM;;;CAAqC,CAAC;AA8WzD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAuD3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/components/particles/ShapeBurstParticles.js

@@ -126,7 +126,8 @@ const H_STEP = 1 / 120;
 const W_PER_FIELD = 4.2; // cyclotron rate (rad / s) per unit field
 const TRAIL_LOOK = { streak: 0.12, comet: 1, echo: 1 };
 const TRAIL_ALPHA = { streak: 1.4, comet: 1.6, echo: 2.4 };
-const BOUNDS = { center: [0, 0, 0], radius: 1.3 };
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export const BOUNDS = { center: [0, 0, 0], radius: 1.3 };
 const FADE = 1.2; // seconds of dissolve
 const INK_EVERY = 1; // particles that draw lines (1 = all)
 const INK_SPACING = 0.006;

package/dist/components/particles/ShapeFlowParticles.d.ts

@@ -12,6 +12,11 @@ export interface ShapeFlowParticlesProps extends ObjectReadyProps {
     /** Per-domain keyframes; the `particles` domain drives this object's config knobs. */
     animations?: ObjectAnimations;
 }
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export declare const BOUNDS: {
+    center: number[];
+    radius: number;
+};
 declare const ShapeFlowParticles: React.FC<ShapeFlowParticlesProps>;
 export default ShapeFlowParticles;
 //# sourceMappingURL=ShapeFlowParticles.d.ts.map

package/dist/components/particles/ShapeFlowParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShapeFlowParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/ShapeFlowParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC7D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,wBAAwB,CAAC;IACjC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAumBD,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuDzD,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"ShapeFlowParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/ShapeFlowParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC7D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,wBAAwB,CAAC;IACjC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAsID,gHAAgH;AAChH,eAAO,MAAM,MAAM;;;CAAqC,CAAC;AAiezD,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuDzD,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/components/particles/ShapeFlowParticles.js

@@ -134,7 +134,8 @@ const GX = 56, GY = 40, GZ = 40; // base-flow grid
 const DELTA = 0.32; // boundary-layer thickness for the potential ramp
 const TRAIL_LOOK = { streak: 0.35, comet: 1, echo: 1 };
 const TRAIL_ALPHA = { streak: 1.8, comet: 2, echo: 2.6 };
-const BOUNDS = { center: [0, 0, 0], radius: 1.6 };
+/** Selection / pick volume in sim units (× size): the off-screen culling sphere and the hover / click proxy. */
+export const BOUNDS = { center: [0, 0, 0], radius: 1.6 };
 function createUniforms() {
     return {
         uTime: { value: 0 },

package/dist/components/particles/TidalStreamParticles.d.ts

@@ -12,6 +12,11 @@ export interface TidalStreamParticlesProps extends ObjectReadyProps {
     /** Per-domain keyframes; the `particles` domain drives this object's config knobs. */
     animations?: ObjectAnimations;
 }
+/** Selection / pick volume in sim units (× size): the stream shells reach ~1.2 past the apocentre. */
+export declare const BOUNDS: {
+    center: number[];
+    radius: number;
+};
 declare const TidalStreamParticles: React.FC<TidalStreamParticlesProps>;
 export default TidalStreamParticles;
 //# sourceMappingURL=TidalStreamParticles.d.ts.map

package/dist/components/particles/TidalStreamParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TidalStreamParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/TidalStreamParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAmtBD,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAqD7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"TidalStreamParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/TidalStreamParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAwGD,sGAAsG;AACtG,eAAO,MAAM,MAAM;;;CAAsC,CAAC;AA6mB1D,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAqD7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/components/particles/TidalStreamParticles.js

@@ -100,6 +100,8 @@ const PERTURBER_MASS = 0.12;
 const HOLE_MASS = 0.07;
 const HOLE_SPIN = 0.018; // Lense–Thirring J (sim units) at strength 1
 const DISC_TRAIL_SHARE = 0.35; // disc stars trail at this fraction of trailShare
+/** Selection / pick volume in sim units (× size): the stream shells reach ~1.2 past the apocentre. */
+export const BOUNDS = { center: [0, 0, 0], radius: 1.35 };
 // orbit families: [apocentre radius, inclination, node angle, eccentricity offset, mass factor]
 const ORBITS = [
     [1.05, 0.28, 0.0, 0.0, 1.0], // main dwarf: long arcs

package/dist/components/particles/index.d.ts

@@ -20,4 +20,6 @@ export { default as ShapeBurstParticles } from './ShapeBurstParticles';
 export type { ShapeBurstParticlesProps } from './ShapeBurstParticles';
 export { default as ShapeFlowParticles } from './ShapeFlowParticles';
 export type { ShapeFlowParticlesProps } from './ShapeFlowParticles';
+export { default as FireworksParticles } from './FireworksParticles';
+export type { FireworksParticlesProps } from './FireworksParticles';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/particles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/particles/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACvF,YAAY,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACnF,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/particles/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACvF,YAAY,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACnF,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/components/particles/index.js

@@ -10,3 +10,4 @@ export { default as NeonRainParticles } from './NeonRainParticles.js';
 export { default as MagneticBottleParticles } from './MagneticBottleParticles.js';
 export { default as ShapeBurstParticles } from './ShapeBurstParticles.js';
 export { default as ShapeFlowParticles } from './ShapeFlowParticles.js';
+export { default as FireworksParticles } from './FireworksParticles.js';

package/dist/components/terrain/TerrainSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainSurface.d.ts","sourceRoot":"","sources":["../../../src/components/terrain/TerrainSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAkB1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAkI/C,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"TerrainSurface.d.ts","sourceRoot":"","sources":["../../../src/components/terrain/TerrainSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAkB1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAkBjD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA6I/C,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/terrain/TerrainSurface.js

@@ -11,6 +11,21 @@ import { applyTerrainAmbient, applyTerrainTextures, applyTerrainUniforms } from
 import { useTerrainTextures } from '../../hooks/useTerrainTextures.js';
 import { getAnimatableProperties } from '@3driseai/3drise-core';
 import { applyConfigKeyframeAnimations, applyConfigMouseMove, } from '../../utils/configAnimations.js';
+import { TERRAIN_DRAW_ORDER, ringDrawOrder } from '../../utils/environmentDrawOrder.js';
+import { isMobileDevice } from '../../utils/deviceTier.js';
+/**
+ * Phone / tablet tier, applied at render time only — the saved scene keeps its
+ * numbers, so the same project is full quality on a desktop. Measured on the
+ * desktop: textures within 100 m instead of 1500 saved ~2.8 ms, 5 octaves
+ * instead of 8 ~1.7 ms; the shadow march costs nothing measurable, so it stays.
+ * Fewer, coarser rings cut the vertex load by roughly half.
+ */
+const MOBILE = {
+    maxSegments: 96,
+    maxLevels: 8,
+    maxOctaves: 5,
+    maxTextureDistance: 400,
+};
 /**
  * The terrain renderer. One clipmap, one material, four landforms — they differ
  * by the shaping operator the height field applies, not by having separate
@@ -29,7 +44,8 @@ import { applyConfigKeyframeAnimations, applyConfigMouseMove, } from '../../util
  * the camera. Nothing here re-renders React.
  */
 const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, timeSettings, sunIntensity = 1, animations, mouseMove, onObjectReady, onObjectDispose, }) => {
-    const clipmap = useTerrainClipmap(quality.levels, quality.segments, quality.cellSize);
+    const mobile = isMobileDevice();
+    const clipmap = useTerrainClipmap(mobile ? Math.min(quality.levels, MOBILE.maxLevels) : quality.levels, mobile ? Math.min(quality.segments, MOBILE.maxSegments) : quality.segments, quality.cellSize);
     const { state: sun, update: updateSun } = useCloudSun({ skySettings, timeSettings });
     const material = useMemo(() => new TerrainMaterial(), []);
     // The four ground textures, packed into arrays. Repacks only when a map URL
@@ -46,9 +62,9 @@ const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, t
     useEffect(() => { liveConfig.current = {}; }, [config]);
     useEffect(() => { liveQuality.current = {}; }, [quality]);
     // The `terrain` keyframe / pointer domains: config -> keyframes -> pointer ->
-    // live drag, the clouds' order. Only the surface's lighting and colour knobs are
-    // in the set — the registry marks every land-shape knob non-animatable, so the
-    // ground itself never moves.
+    // live drag, the clouds' order. Every numeric / colour knob is in the set — shape
+    // and surface alike are shader uniforms, so the ground can rise or shift per frame;
+    // only the integer counts (octaves, strata) are structural in the registry.
     const animatable = useMemo(() => new Set(getAnimatableProperties({ type: 'terrain', config }, 'terrain').map(p => p.value)), [config.terrainType]);
     const override = useRef({});
     const startValues = useRef({});
@@ -91,6 +107,10 @@ const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, t
             applyConfigMouseMove(mouseMove.terrain.properties, config, o, state.pointer, animatable);
         }
         const cfg = { ...config, ...o, ...liveConfig.current };
+        if (mobile) {
+            cfg.octaves = Math.min(cfg.octaves, MOBILE.maxOctaves);
+            cfg.textureDistance = Math.min(cfg.textureDistance ?? 4000, MOBILE.maxTextureDistance);
+        }
         const qual = { ...quality, ...liveQuality.current };
         applyTerrainUniforms(material, cfg, qual);
         applyTerrainTextures(material, cfg, textures);
@@ -110,6 +130,8 @@ const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, t
         }
     });
     return (_jsx("group", { ref: rootRef, children: clipmap.levels.map((ring, i) => (_jsx("mesh", { ref: (m) => { meshRefs.current[i] = m; }, geometry: ring.geometry, material: material, receiveShadow: quality.receiveShadows, 
+            // After the water, inner ring first: see environmentDrawOrder.
+            renderOrder: ringDrawOrder(TERRAIN_DRAW_ORDER, ring.level), 
             // Displacement happens in the vertex shader, so the object-space
             // bounds describe a flat plane. Culling against them hides the
             // terrain the moment the camera tilts up.

package/dist/components/text/PlainText.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { AnimationOptions, MouseMoveDomain, PlainTextConfig } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface PlainTextProps extends ObjectReadyProps {
+    config: PlainTextConfig;
+    /** Scene object id: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on the config knobs (animations.text.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on the config knobs (mouseMove.text). */
+    mouseMove?: MouseMoveDomain;
+}
+declare const PlainText: React.FC<PlainTextProps>;
+export default PlainText;
+//# sourceMappingURL=PlainText.d.ts.map

package/dist/components/text/PlainText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlainText.d.ts","sourceRoot":"","sources":["../../../src/components/text/PlainText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAYhE,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,EAAE,eAAe,CAAC;IACxB,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAAyD,CAAC;AAElG,eAAe,SAAS,CAAC"}

package/dist/components/text/PlainText.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import TextObjectView from './TextObjectView.js';
+const PlainText = (props) => _jsx(TextObjectView, { look: "plain", ...props });
+export default PlainText;

package/dist/components/text/TextObjectView.d.ts

@@ -3,7 +3,9 @@ import type { TextObjectType } from '@3driseai/3drise-core';
 import { type TextObjectProps } from './useTextObject';
 /**
  * The shared body of every text look: an empty group that the look's mesh is built into once the font has
- * loaded. The inner group is the em scale, so the object's own transform stays the parent's.
+ * loaded, plus the pick proxy — an invisible plane over the text's box that is the only thing the pointer can
+ * hit (hover / click react to the text as a whole, not letter by letter). The inner group is the em scale, so
+ * the object's own transform stays the parent's.
  */
 declare const TextObjectView: React.FC<TextObjectProps & {
     look: TextObjectType;

package/dist/components/text/TextObjectView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextObjectView.d.ts","sourceRoot":"","sources":["../../../src/components/text/TextObjectView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;;GAGG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,GAAG;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAOxE,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"TextObjectView.d.ts","sourceRoot":"","sources":["../../../src/components/text/TextObjectView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG/E;;;;;GAKG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,GAAG;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAWxE,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/text/TextObjectView.js

@@ -1,11 +1,17 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo } from 'react';
 import { TEXT_EM, useTextObject } from './useTextObject.js';
+import { pickPlane } from '../../utils/pickProxy.js';
 /**
  * The shared body of every text look: an empty group that the look's mesh is built into once the font has
- * loaded. The inner group is the em scale, so the object's own transform stays the parent's.
+ * loaded, plus the pick proxy — an invisible plane over the text's box that is the only thing the pointer can
+ * hit (hover / click react to the text as a whole, not letter by letter). The inner group is the em scale, so
+ * the object's own transform stays the parent's.
  */
 const TextObjectView = ({ look, ...props }) => {
-    const { rootRef, innerRef } = useTextObject(look, props);
-    return (_jsx("group", { ref: rootRef, children: _jsx("group", { ref: innerRef, scale: TEXT_EM }) }));
+    const { rootRef, innerRef, proxyRef } = useTextObject(look, props);
+    const proxy = useMemo(() => pickPlane(), []);
+    useEffect(() => () => { proxy.geometry.dispose(); proxy.material.dispose(); }, [proxy]);
+    return (_jsx("group", { ref: rootRef, children: _jsx("group", { ref: innerRef, scale: TEXT_EM, children: _jsx("primitive", { ref: proxyRef, object: proxy }) }) }));
 };
 export default TextObjectView;

package/dist/components/text/engine/looks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/text/engine/looks/index.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,KAAK,EAAgM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/text/engine/looks/index.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,KAAK,EAAuM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC"}

package/dist/components/text/engine/looks/index.js

@@ -8,6 +8,7 @@ import inkBleed from './inkBleed.js';
 import lightPainting from './lightPainting.js';
 import liquidMetal from './liquidMetal.js';
 import plasmaDischarge from './plasmaDischarge.js';
+import plain from './plain.js';
 // Additive / max-blended glow passes write alpha 1 with black where they add nothing, which on a transparent canvas
 // (alpha: true, no scene background) paints opaque black quads. Make their output a valid premultiplied pixel instead:
 // alpha = brightest channel, blended One/One (same colour as before, no black rectangles).
@@ -45,4 +46,4 @@ const safe = (v) => ({
     },
 });
 // Text looks whose rendering is look-native (own shaders, per-pixel fields, own draw / erase methods).
-export const LOOKS = Object.fromEntries(Object.entries({ burnAway, chalkboard, constellation, embroidery, frostGrowth, inkBleed, lightPainting, liquidMetal, plasmaDischarge }).map(([k, v]) => [k, safe(v)]));
+export const LOOKS = Object.fromEntries(Object.entries({ burnAway, chalkboard, constellation, embroidery, frostGrowth, inkBleed, lightPainting, liquidMetal, plasmaDischarge, plain }).map(([k, v]) => [k, safe(v)]));

package/dist/components/text/engine/looks/plain.d.ts

@@ -0,0 +1,146 @@
+declare const _default: {
+    key: string;
+    source: string;
+    drawMethods: string[];
+    eraseMethods: string[];
+    drawDefault: string;
+    eraseDefault: string;
+    catalog: {
+        name: string;
+        description: string;
+        tags: string[];
+    };
+    animDefaults: {
+        text: string;
+        font: string;
+        drawDuration: number;
+        eraseDuration: number;
+    };
+    defaults: {
+        color: string;
+        color2: string;
+        weight: number;
+        outline: number;
+        fill: number;
+        softness: number;
+        opacity: number;
+    };
+    ui: {
+        main: ({
+            name: string;
+            label: string;
+            description: string;
+            type: string;
+            min?: undefined;
+            max?: undefined;
+            step?: undefined;
+            unit?: undefined;
+        } | {
+            name: string;
+            label: string;
+            description: string;
+            type: string;
+            min: number;
+            max: number;
+            step: number;
+            unit: string;
+        } | {
+            name: string;
+            label: string;
+            description: string;
+            type: string;
+            min: number;
+            max: number;
+            step: number;
+            unit?: undefined;
+        })[];
+        more: ({
+            name: string;
+            label: string;
+            description: string;
+            type: string;
+            min?: undefined;
+            max?: undefined;
+            step?: undefined;
+            unit?: undefined;
+        } | {
+            name: string;
+            label: string;
+            description: string;
+            type: string;
+            min: number;
+            max: number;
+            step: number;
+            unit?: undefined;
+        } | {
+            name: string;
+            label: string;
+            description: string;
+            type: string;
+            min: number;
+            max: number;
+            step: number;
+            unit: string;
+        })[];
+    };
+    structural: any[];
+    presets: ({
+        name: string;
+        description: string;
+        patch: {
+            weight?: undefined;
+            fill?: undefined;
+            outline?: undefined;
+            color2?: undefined;
+            softness?: undefined;
+            color?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        patch: {
+            weight: number;
+            fill?: undefined;
+            outline?: undefined;
+            color2?: undefined;
+            softness?: undefined;
+            color?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        patch: {
+            fill: number;
+            outline: number;
+            color2: string;
+            weight?: undefined;
+            softness?: undefined;
+            color?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        patch: {
+            softness: number;
+            weight: number;
+            fill?: undefined;
+            outline?: undefined;
+            color2?: undefined;
+            color?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        patch: {
+            color: string;
+            weight: number;
+            fill?: undefined;
+            outline?: undefined;
+            color2?: undefined;
+            softness?: undefined;
+        };
+    })[];
+    build(layout: any, cfg: any, anim: any): any;
+};
+export default _default;
+//# sourceMappingURL=plain.d.ts.map

package/dist/components/text/engine/looks/plain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain.d.ts","sourceRoot":"","sources":["../../../../../src/components/text/engine/looks/plain.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,wBAsDE"}

package/dist/components/text/engine/looks/plain.js

@@ -0,0 +1,104 @@
+import * as THREE from 'three';
+import { prepare, applyAnim, DRAW_METHODS, ERASE_METHODS } from '../methods.js';
+import { buildField, fieldMaterial, fieldQuad } from '../fieldkit.js';
+import { setReveal } from '../ribbon.js';
+// =========================================================================================
+// plain — flat, solid text from the font's outlines: the everyday label, caption and title.
+//
+// THE CONSTRUCTION
+//  1. The glyph outlines are baked once into a signed distance field over the text's extent (fieldkit: exact
+//     nearest-contour distance by jump flooding, negative inside the even-odd filled glyph). Shading is per pixel
+//     from that field, so the edge is anti-aliased in screen space with fwidth(d) — crisp at any camera distance,
+//     like SDF text rendering, and never a hard step.
+//  2. Weight offsets the zero contour (d - weight): a positive weight makes the face bolder, a negative one lighter,
+//     the way a variable font's wght axis thickens every stroke from its centreline outwards.
+//  3. Outline is the band 0 < d < outline just outside the (weighted) face, in colour2; fill is the face itself,
+//     with its own opacity so an outline-only label is one slider away. Softness widens the edge transition
+//     symmetrically for a soft, printed-on-fabric look.
+//  4. Draw / erase: every pixel carries the arrival of its nearest contour point (fieldkit gD / gO), so every
+//     shared method works unchanged — pen and trace ink the letters in from their contours, wipe / radial sweep
+//     across the face, scatter / dissolve break it up, fade is a plain cross-fade.
+//  There is no idle motion: a plain label stands still.
+// =========================================================================================
+const hex = (h) => new THREE.Color(h);
+const PLAIN_FRAG = /* glsl */ `
+uniform vec3 uColor; uniform vec3 uColor2; uniform float uOpacity; uniform float uFill; uniform float uWeight; uniform float uOutline; uniform float uSoft;
+void main(){
+  vec4 A = fieldA(vPos);
+  float d = A.x - uWeight;                                   // signed distance to the weighted face (em; < 0 inside)
+  float aa = max(fwidth(d), 1e-5)*0.7 + uSoft;               // derivatives first: no discard before them
+  float face = 1.0 - smoothstep(-aa, aa, d);
+  float ring = smoothstep(-aa, aa, d)*(1.0 - smoothstep(uOutline - aa, uOutline + aa, d))*step(0.0005, uOutline);
+  float vis = revealInG(A.y)*revealOutG(A.z)*uOpacity;
+  float f = face*uFill;
+  float a = (f + ring*(1.0 - f))*vis;
+  if (a < 0.002) discard;
+  vec3 col = (uColor*f + uColor2*ring*(1.0 - f))*vis;         // premultiplied
+  gl_FragColor = vec4(col, a);
+  #include <tonemapping_fragment>
+  #include <colorspace_fragment>
+}`;
+export default {
+    key: 'plain', source: 'outline', drawMethods: DRAW_METHODS, eraseMethods: ERASE_METHODS, drawDefault: 'fade', eraseDefault: 'fade',
+    catalog: {
+        name: 'Plain',
+        description: 'Flat solid text from the font outlines with a weight axis, an optional outline and soft edges, anti-aliased from a signed distance field. Use for labels, captions, prices, menus and titles.',
+        tags: ['plain', 'label', 'caption', 'solid', 'flat', 'sans', 'title', 'text'],
+    },
+    animDefaults: { text: 'Hello', font: 'inter', drawDuration: 1.2, eraseDuration: 0.8 },
+    defaults: { color: '#ffffff', color2: '#111111', weight: 0, outline: 0, fill: 1, softness: 0, opacity: 1 },
+    ui: {
+        main: [
+            { name: 'color', label: 'Colour', description: 'Colour of the face', type: 'color' },
+            { name: 'weight', label: 'Weight', description: 'Bolder (right) or lighter (left) face: offsets every edge of the letters', type: 'number', min: -0.04, max: 0.05, step: 0.001, unit: 'em' },
+            { name: 'outline', label: 'Outline', description: 'Width of the outline drawn just outside the face (0 = none)', type: 'number', min: 0, max: 0.08, step: 0.001, unit: 'em' },
+            { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        ],
+        more: [
+            { name: 'color2', label: 'Outline colour', description: 'Colour of the outline', type: 'color' },
+            { name: 'fill', label: 'Fill', description: 'Opacity of the face alone (0 with an outline = hollow letters)', type: 'number', min: 0, max: 1, step: 0.01 },
+            { name: 'softness', label: 'Softness', description: 'Width of the edge transition: 0 is crisp, more is a soft printed edge', type: 'number', min: 0, max: 0.06, step: 0.001, unit: 'em' },
+        ],
+    },
+    structural: [],
+    presets: [
+        { name: 'Default', description: 'White, crisp', patch: {} },
+        { name: 'Bold', description: 'A heavier face', patch: { weight: 0.025 } },
+        { name: 'Hollow', description: 'Outline only', patch: { fill: 0, outline: 0.03, color2: '#ffffff' } },
+        { name: 'Soft', description: 'Soft printed edge', patch: { softness: 0.03, weight: 0.012 } },
+        { name: 'Caption', description: 'Light grey, a little lighter in weight', patch: { color: '#c9ced6', weight: -0.01 } },
+    ],
+    build(layout, cfg, anim) {
+        const strokes = layout.strokes;
+        prepare(strokes, 'outline');
+        const G = layout.glyphs.length;
+        strokes.forEach((s) => { s.glyphN = s.glyph / Math.max(1, G - 1); });
+        const { infoD, infoE } = applyAnim(strokes, anim, G);
+        // The cheapest look, and the one read closest: a finer field than the others (1536 along the long side).
+        const field = buildField(strokes, { source: 'outline', texels: 1536, pad: 0.2, maxDist: 0.3 });
+        const mat = fieldMaterial(field, PLAIN_FRAG, {
+            uColor: { value: hex(cfg.color) }, uColor2: { value: hex(cfg.color2) }, uOpacity: { value: 1 }, uFill: { value: 1 }, uWeight: { value: 0 }, uOutline: { value: 0 }, uSoft: { value: 0 },
+        });
+        const mesh = fieldQuad(field, mat);
+        const group = new THREE.Group();
+        group.add(mesh);
+        const api = {
+            object: group,
+            apply(c) {
+                const u = mat.uniforms;
+                u.uColor.value.set(c.color);
+                u.uColor2.value.set(c.color2);
+                u.uOpacity.value = c.opacity;
+                u.uFill.value = c.fill;
+                u.uWeight.value = c.weight;
+                u.uOutline.value = c.outline;
+                u.uSoft.value = c.softness;
+                api.c = c;
+            },
+            update(S, time) { setReveal(mat.uniforms, S, infoD, infoE, anim.draw.duration, time); },
+            dispose() { mesh.geometry.dispose(); mat.dispose(); field.dispose(); },
+        };
+        api.apply(cfg);
+        return api;
+    },
+};