@ev-ry/fx 0.1.0-rc.2 → 0.1.0-rc.4

package/src/text-effect-path.js

@@ -1,61 +1,61 @@
-import {motionEnvelopeShader} from './motion-envelope.js';
-import {additionalTextMotion} from './text-edit-motions.js';
-
-// One evaluator allows optional rigid facet reflection for every preset. Only
-// the selected preset compiles; extra corner evaluations run only with bounce.
-export const textEffectPathShader=`${motionEnvelopeShader}
-vec3 thdPresetPosition(vec3 p,vec2 dustTarget,vec2 particle,vec4 r,vec4 clock,vec2 travel,float t,float seed,float drift,float pace){
-  float remain=1.0-t;
-  vec3 recipeOrigin=p;
-  vec2 cellSize=vec2(max(dustEm,0.0001));
-  vec2 cellMin=thdMotionCell(dustTarget,r.xy,dustEm);
-  #if THD_EDIT_CHARACTER_FRAME == 1
-  if(dustCharacterFrame.z>0.0&&dustCharacterFrame.w>0.0){
-    cellMin=dustCharacterFrame.xy+glyphOffset;
-    cellSize=dustCharacterFrame.zw;
-  }
-  #endif
-  vec2 cellCenter=cellMin+cellSize*0.5;
-  vec2 cellUV=clamp((dustTarget-cellMin)/cellSize,0.0,1.0);
-  float across=cellUV.x;
-  if(clock.y<0.0)across=1.0-across;
-  {${additionalTextMotion}}
-  if(dustRecipeDirection!=vec2(1.0,0.0)){
-    vec2 delta=p.xy-recipeOrigin.xy;
-    float sine=clock.y*dustRecipeDirection.y;
-    p.xy=recipeOrigin.xy+vec2(dustRecipeDirection.x*delta.x-sine*delta.y,sine*delta.x+dustRecipeDirection.x*delta.y);
-  }
-  if(dustRecipeDepth!=1.0)p.z=recipeOrigin.z+(p.z-recipeOrigin.z)*dustRecipeDepth;
-  dustGlow*=dustRecipeGlow;
-  if(dustRecipePalette.x>=0.0)dustGlowColor=dustRecipePalette;
-  return p;
-}
-`;
-export const textEffectApplicationShader=`
-  vec3 original=p;
-  p=thdPresetPosition(original,dustTarget,particle,r,clock,travel,t,seed,drift,pace);
-  // Regulate the shared triangle centre, preserving facet shape and orientation.
-  vec3 center=vec3(dustTarget,original.z);
-  float savedGlow=dustGlow,savedOutline=dustOutline;vec3 savedGlowColor=dustGlowColor;
-  vec3 moved=thdPresetPosition(center,dustTarget,particle,r,clock,travel,t,seed,drift,pace);
-  dustGlow=savedGlow;dustOutline=savedOutline;dustGlowColor=savedGlowColor;
-  vec3 delta=moved-center;
-  vec3 regulated=thdRegulateMotion(delta,dustEm);
-  vec3 adjustment=regulated-delta;
-  #if THD_EDIT_ADJUST == 1
-  adjustment+=regulated*(dustTransform-vec3(1.0));
-  #endif
-  p+=adjustment;
-  #if THD_EDIT_BOUNCE == 1
-  if(dustBounce>0.5 && t<1.0){
-    vec3 a=thdPresetPosition(dustCornerA+vec3(glyphOffset,0.0),dustTarget,particle,r,clock,travel,t,seed,drift,pace)+adjustment;
-    vec3 b=thdPresetPosition(dustCornerB+vec3(glyphOffset,0.0),dustTarget,particle,r,clock,travel,t,seed,drift,pace)+adjustment;
-    vec3 c=thdPresetPosition(dustCornerC+vec3(glyphOffset,0.0),dustTarget,particle,r,clock,travel,t,seed,drift,pace)+adjustment;
-    float centerY=(a.y+b.y+c.y)/3.0;
-    float low=dustFloor.x+glyphOffset.y+centerY-min(a.y,min(b.y,c.y));
-    float high=dustCeiling.x+glyphOffset.y-max(a.y,max(b.y,c.y))+centerY;
-    float span=high-low;
-    if(span>0.000001)p.y+=low+span-abs(mod(centerY-low,2.0*span)-span)-centerY;
-  }
-  #endif
-`;
+import {motionEnvelopeShader} from './motion-envelope.js';
+import {additionalTextMotion} from './text-edit-motions.js';
+
+// One evaluator allows optional rigid facet reflection for every preset. Only
+// the selected preset compiles; extra corner evaluations run only with bounce.
+export const textEffectPathShader=`${motionEnvelopeShader}
+vec3 thdPresetPosition(vec3 p,vec2 dustTarget,vec2 particle,vec4 r,vec4 clock,vec2 travel,float t,float seed,float drift,float pace){
+  float remain=1.0-t;
+  vec3 recipeOrigin=p;
+  vec2 cellSize=vec2(max(dustEm,0.0001));
+  vec2 cellMin=thdMotionCell(dustTarget,r.xy,dustEm);
+  #if THD_EDIT_CHARACTER_FRAME == 1
+  if(dustCharacterFrame.z>0.0&&dustCharacterFrame.w>0.0){
+    cellMin=dustCharacterFrame.xy+glyphOffset;
+    cellSize=dustCharacterFrame.zw;
+  }
+  #endif
+  vec2 cellCenter=cellMin+cellSize*0.5;
+  vec2 cellUV=clamp((dustTarget-cellMin)/cellSize,0.0,1.0);
+  float across=cellUV.x;
+  if(clock.y<0.0)across=1.0-across;
+  {${additionalTextMotion}}
+  if(dustRecipeDirection!=vec2(1.0,0.0)){
+    vec2 delta=p.xy-recipeOrigin.xy;
+    float sine=clock.y*dustRecipeDirection.y;
+    p.xy=recipeOrigin.xy+vec2(dustRecipeDirection.x*delta.x-sine*delta.y,sine*delta.x+dustRecipeDirection.x*delta.y);
+  }
+  if(dustRecipeDepth!=1.0)p.z=recipeOrigin.z+(p.z-recipeOrigin.z)*dustRecipeDepth;
+  dustGlow*=dustRecipeGlow;
+  if(dustRecipePalette.x>=0.0)dustGlowColor=dustRecipePalette;
+  return p;
+}
+`;
+export const textEffectApplicationShader=`
+  vec3 original=p;
+  p=thdPresetPosition(original,dustTarget,particle,r,clock,travel,t,seed,drift,pace);
+  // Regulate the shared triangle centre, preserving facet shape and orientation.
+  vec3 center=vec3(dustTarget,original.z);
+  float savedGlow=dustGlow,savedOutline=dustOutline;vec3 savedGlowColor=dustGlowColor;
+  vec3 moved=thdPresetPosition(center,dustTarget,particle,r,clock,travel,t,seed,drift,pace);
+  dustGlow=savedGlow;dustOutline=savedOutline;dustGlowColor=savedGlowColor;
+  vec3 delta=moved-center;
+  vec3 regulated=thdRegulateMotion(delta,dustEm);
+  vec3 adjustment=regulated-delta;
+  #if THD_EDIT_ADJUST == 1
+  adjustment+=regulated*(dustTransform-vec3(1.0));
+  #endif
+  p+=adjustment;
+  #if THD_EDIT_BOUNCE == 1
+  if(dustBounce>0.5 && t<1.0){
+    vec3 a=thdPresetPosition(dustCornerA+vec3(glyphOffset,0.0),dustTarget,particle,r,clock,travel,t,seed,drift,pace)+adjustment;
+    vec3 b=thdPresetPosition(dustCornerB+vec3(glyphOffset,0.0),dustTarget,particle,r,clock,travel,t,seed,drift,pace)+adjustment;
+    vec3 c=thdPresetPosition(dustCornerC+vec3(glyphOffset,0.0),dustTarget,particle,r,clock,travel,t,seed,drift,pace)+adjustment;
+    float centerY=(a.y+b.y+c.y)/3.0;
+    float low=dustFloor.x+glyphOffset.y+centerY-min(a.y,min(b.y,c.y));
+    float high=dustCeiling.x+glyphOffset.y-max(a.y,max(b.y,c.y))+centerY;
+    float span=high-low;
+    if(span>0.000001)p.y+=low+span-abs(mod(centerY-low,2.0*span)-span)-centerY;
+  }
+  #endif
+`;

package/src/text-motion-primitives.js

@@ -1,91 +1,98 @@
-// Small GPU building blocks shared by edit motions. All paths run from scattered
-// (t=0) to the untouched mesh (t=1); removal only reverses the captured phase.
-export const textMotionPrimitives=`
-  // Text effects live above their resting surface. Reflect inward depth instead
-  // of letting the opaque control body cut off a still-visible particle. This
-  // same path is reversed for removal; normal scene depth testing stays enabled.
-  float thdFrontDepth(float resting,float animated){
-    return resting+abs(animated-resting);
-  }
-  // A fixed one-em cell: longer edits add cells instead of stretching a path.
-  // All vertices of a triangle choose the cell using their shared centroid.
-  vec2 thdMotionCell(vec2 target,vec2 origin,float em){
-    float size=max(em,0.0001);
-    return origin+floor((target-origin)/size)*size;
-  }
-  // Preserve the tuned wind distribution for EVERY preset: no particle cohorts,
-  // no per-motion lifetime. Time = randomized distance / randomized speed.
-  vec2 thdParticleTravel(float seed,float drift,float pace,float seconds){
-    float spread=fract(seed*7.31+drift*13.71);
-    float distanceJitter=mix(0.8,1.2,spread);
-    float distance=mix(0.0,7.8,seed)*distanceJitter;
-    float speed=(7.8*1.2/max(seconds,0.001))*mix(1.0,4.0,pace);
-    return vec2(distance,distance/speed);
-  }
-  float thdMotionPhase(vec4 clock,float travelSeconds,float seconds){
-    float progress=travelSeconds>0.0?clamp(clock.x*seconds/travelSeconds,0.0,1.0):1.0;
-    float initial=travelSeconds>0.0?clamp(max(0.0,clock.z-1.0)*seconds/travelSeconds,0.0,1.0):1.0;
-    return clock.z>0.5?max(0.0,initial-progress):progress;
-  }
-  float thdStagger(float t,float order,float spread){
-    if(t>=1.0)return 1.0;
-    if(t<=0.0)return 0.0;
-    float delay=clamp(order,0.0,1.0)*spread;
-    return clamp((t-delay)/max(1.0-delay,0.001),0.0,1.0);
-  }
-  vec2 thdTurn(vec2 v,float angle){
-    return vec2(v.x*cos(angle)-v.y*sin(angle),v.x*sin(angle)+v.y*cos(angle));
-  }
-  vec3 thdFold(vec3 v,vec3 axis,float angle){
-    return v*cos(angle)+cross(axis,v)*sin(angle)+axis*dot(axis,v)*(1.0-cos(angle));
-  }
-  // Linear projected opening, while preserving each preset's initial angle.
-  // A linear angle looks almost flat too early because its projection is cosine.
-  float thdOpeningAngle(float progress,float initialAngle){
-    // Some GPU acos approximations leave a tiny angle at 1. Return exact ends.
-    if(progress>=1.0)return 0.0;
-    if(progress<=0.0)return initialAngle;
-    return acos(clamp(mix(cos(initialAngle),1.0,progress),-1.0,1.0));
-  }
-  vec3 thdHinge(vec3 point,vec3 pivot,vec3 axis,float angle){
-    return pivot+thdFold(point-pivot,axis,angle);
-  }
-  vec2 thdCurve(vec2 a,vec2 b,vec2 c,vec2 d,float t){
-    float q=1.0-t;
-    return q*q*q*a+3.0*q*q*t*b+3.0*q*t*t*c+t*t*t*d;
-  }
-  float thdPulse(float t){return 4.0*t*(1.0-t);}
-  // Bounded sinusoidal drift anchored at zero, so a shared path joins the text
-  // exactly without per-effect offsets or a separate deletion implementation.
-  float thdSway(float progress,float phase,float turns){
-    return sin(phase+progress*turns*6.2831853)-sin(phase);
-  }
-  // Ballistic drop + four diminishing rebounds. One drop time is the unit;
-  // restitution scales vertical speed at each impact (energy scales by e^2).
-  // Horizontal friction reduces speed after every impact. Result: height as
-  // a fraction of the original drop, and accumulated horizontal travel [0,1].
-  // This evaluates a pose directly, so reverse playback needs no simulation.
-  vec2 thdGravityBounce(float departure,float restitution,float friction){
-    float total=1.0,totalX=1.0,speed=restitution,slide=friction;
-    for(int i=0;i<4;i++){
-      total+=2.0*speed;totalX+=2.0*speed*slide;
-      speed*=restitution;slide*=friction;
-    }
-    float time=clamp(departure,0.0,1.0)*total;
-    if(time<=1.0)return vec2(max(0.0,1.0-time*time),time/totalX);
-    time-=1.0;
-    float distance=1.0;speed=restitution;slide=friction;
-    for(int i=0;i<4;i++){
-      float flight=2.0*speed;
-      if(time<=flight)return vec2(max(0.0,2.0*speed*time-time*time),(distance+slide*time)/totalX);
-      time-=flight;distance+=slide*flight;
-      speed*=restitution;slide*=friction;
-    }
-    return vec2(0.0,1.0);
-  }
-  float thdSpring(float t){return (1.0-t)*cos(t*10.9955743);}
-  float thdFall(float t){
-    if(t<0.64){float f=t/0.64;return 1.0-f*f;}
-    return 0.14*sin((t-0.64)/0.36*3.1415927);
-  }
-`;
+// Small GPU building blocks shared by edit motions. All paths run from scattered
+// (t=0) to the untouched mesh (t=1); removal only reverses the captured phase.
+export const textMotionPrimitives=`
+  // Text effects live above their resting surface. Reflect inward depth instead
+  // of letting the opaque control body cut off a still-visible particle. This
+  // same path is reversed for removal; normal scene depth testing stays enabled.
+  float thdFrontDepth(float resting,float animated){
+    return resting+abs(animated-resting);
+  }
+  // A fixed one-em cell: longer edits add cells instead of stretching a path.
+  // All vertices of a triangle choose the cell using their shared centroid.
+  vec2 thdMotionCell(vec2 target,vec2 origin,float em){
+    float size=max(em,0.0001);
+    return origin+floor((target-origin)/size)*size;
+  }
+  // Preserve the tuned wind distribution for EVERY preset: no particle cohorts,
+  // no per-motion lifetime. Time = randomized distance / randomized speed.
+  vec2 thdParticleTravel(float seed,float drift,float pace,float seconds){
+    float spread=fract(seed*7.31+drift*13.71);
+    float distanceJitter=mix(0.8,1.2,spread);
+    float distance=mix(0.0,7.8,seed)*distanceJitter;
+    float speed=(7.8*1.2/max(seconds,0.001))*mix(1.0,4.0,pace);
+    return vec2(distance,distance/speed);
+  }
+  float thdMotionPhase(vec4 clock,float travelSeconds,float seconds){
+    float progress=travelSeconds>0.0?clamp(clock.x*seconds/travelSeconds,0.0,1.0):1.0;
+    float initial=travelSeconds>0.0?clamp(max(0.0,clock.z-1.0)*seconds/travelSeconds,0.0,1.0):1.0;
+    return clock.z>0.5?max(0.0,initial-progress):progress;
+  }
+  float thdStagger(float t,float order,float spread){
+    if(t>=1.0)return 1.0;
+    if(t<=0.0)return 0.0;
+    float delay=clamp(order,0.0,1.0)*spread;
+    return clamp((t-delay)/max(1.0-delay,0.001),0.0,1.0);
+  }
+  // Continuous per-particle appearance: sparse at first, progressively denser.
+  // Use the existing reversible motion phase so exit follows the same envelope.
+  float thdParticleAppearance(float t,float order){
+    float start=0.55*sqrt(clamp(order,0.0,1.0));
+    float fade=clamp((t-start)/0.25,0.0,1.0);
+    return fade*fade;
+  }
+  vec2 thdTurn(vec2 v,float angle){
+    return vec2(v.x*cos(angle)-v.y*sin(angle),v.x*sin(angle)+v.y*cos(angle));
+  }
+  vec3 thdFold(vec3 v,vec3 axis,float angle){
+    return v*cos(angle)+cross(axis,v)*sin(angle)+axis*dot(axis,v)*(1.0-cos(angle));
+  }
+  // Linear projected opening, while preserving each preset's initial angle.
+  // A linear angle looks almost flat too early because its projection is cosine.
+  float thdOpeningAngle(float progress,float initialAngle){
+    // Some GPU acos approximations leave a tiny angle at 1. Return exact ends.
+    if(progress>=1.0)return 0.0;
+    if(progress<=0.0)return initialAngle;
+    return acos(clamp(mix(cos(initialAngle),1.0,progress),-1.0,1.0));
+  }
+  vec3 thdHinge(vec3 point,vec3 pivot,vec3 axis,float angle){
+    return pivot+thdFold(point-pivot,axis,angle);
+  }
+  vec2 thdCurve(vec2 a,vec2 b,vec2 c,vec2 d,float t){
+    float q=1.0-t;
+    return q*q*q*a+3.0*q*q*t*b+3.0*q*t*t*c+t*t*t*d;
+  }
+  float thdPulse(float t){return 4.0*t*(1.0-t);}
+  // Bounded sinusoidal drift anchored at zero, so a shared path joins the text
+  // exactly without per-effect offsets or a separate deletion implementation.
+  float thdSway(float progress,float phase,float turns){
+    return sin(phase+progress*turns*6.2831853)-sin(phase);
+  }
+  // Ballistic drop + four diminishing rebounds. One drop time is the unit;
+  // restitution scales vertical speed at each impact (energy scales by e^2).
+  // Horizontal friction reduces speed after every impact. Result: height as
+  // a fraction of the original drop, and accumulated horizontal travel [0,1].
+  // This evaluates a pose directly, so reverse playback needs no simulation.
+  vec2 thdGravityBounce(float departure,float restitution,float friction){
+    float total=1.0,totalX=1.0,speed=restitution,slide=friction;
+    for(int i=0;i<4;i++){
+      total+=2.0*speed;totalX+=2.0*speed*slide;
+      speed*=restitution;slide*=friction;
+    }
+    float time=clamp(departure,0.0,1.0)*total;
+    if(time<=1.0)return vec2(max(0.0,1.0-time*time),time/totalX);
+    time-=1.0;
+    float distance=1.0;speed=restitution;slide=friction;
+    for(int i=0;i<4;i++){
+      float flight=2.0*speed;
+      if(time<=flight)return vec2(max(0.0,2.0*speed*time-time*time),(distance+slide*time)/totalX);
+      time-=flight;distance+=slide*flight;
+      speed*=restitution;slide*=friction;
+    }
+    return vec2(0.0,1.0);
+  }
+  float thdSpring(float t){return (1.0-t)*cos(t*10.9955743);}
+  float thdFall(float t){
+    if(t<0.64){float f=t/0.64;return 1.0-f*f;}
+    return 0.14*sin((t-0.64)/0.36*3.1415927);
+  }
+`;

package/src/text-motion-recipes.js

@@ -1,71 +1,71 @@
-import {motionPrograms} from './text-motion-programs.js';
-
-const freeze=value=>{if(value&&typeof value==='object'&&!Object.isFrozen(value)){Object.values(value).forEach(freeze);Object.freeze(value);}return value;};
-// Trusted internal operation graphs. Public settings accept bounded values,
-// never expressions, GLSL, or executable source.
-export const textMotionRecipes=freeze(motionPrograms);
-export const textMotionAliases=freeze({});
-export const textRecipeControls=freeze({
-  angle:{label:'جهت حرکت',default:0,min:-180,max:180,step:15,choices:{'0':'اصلی','45':'مورب بالا','-45':'مورب پایین','90':'چرخش بالا','-90':'چرخش پایین','180':'معکوس'}},
-  depth:{label:'عمق',default:1,min:0,max:2,step:.1},
-  spin:{label:'پیچش',default:1,min:0,max:2,step:.1},
-  sway:{label:'موج و نوسان',default:1,min:0,max:2,step:.1},
-  shape:{label:'تغییر شکل مثلث‌ها',default:1,min:0,max:1.5,step:.1},
-  glow:{label:'درخشش',default:1,min:0,max:2,step:.1},
-  palette:{label:'رنگ درخشش',default:'original',choices:{original:'اصلی',cool:'آبی',warm:'گرم',mint:'نعنایی'}},
-  rebound:{label:'قدرت جهش',default:1,min:.25,max:1.5,step:.05},
-  pace:{label:'ریتم جهش',default:1,min:.25,max:2,step:.05}
-});
-export function normalizeTextMotionRecipe(value={},mode='dust-wind'){
-  if(!value||typeof value!=='object'||Array.isArray(value))throw TypeError('Recipe settings must be an object');
-  const result=Object.fromEntries(Object.entries(textRecipeControls).map(([key,control])=>[key,control.default]));
-  result.angle=textMotionAliases[mode]?.angle??(mode==='dust-wind-upward'?45:0);
-  for(const [key,v] of Object.entries(value)){
-    if(!Object.hasOwn(textRecipeControls,key))throw TypeError('Unknown recipe setting: '+key);
-    const control=textRecipeControls[key];
-    if(key==='palette'){if(typeof v!=='string'||!Object.hasOwn(control.choices,v))throw TypeError('Invalid recipe palette');}
-    else if(typeof v!=='number'||!Number.isFinite(v)||v<control.min||v>control.max)throw RangeError('Invalid recipe setting: '+key);
-    result[key]=v;
-  }
-  return Object.freeze(result);
-}
-
-// Shared compiler: expressions describe math, operations describe composition,
-// uniforms supply the bounded public intent controls.
-export function compileTextMotionRecipe(recipe){
-  if(!recipe||!Array.isArray(recipe.operations)||!recipe.operations.length)throw TypeError('Invalid motion recipe');
-  const types={face:recipe.ownFace?'vec2':'vec3'};
-  const lines=recipe.ownFace?[]:['vec3 face=p-vec3(dustTarget,p.z);'];
-  const expression=value=>{if(typeof value!=='string'||!value||/[;{}#]/.test(value))throw TypeError('Invalid recipe expression');return value;};
-  const target=value=>{if(typeof value!=='string'||!/^\w+(?:\.[xyzwrgba]{1,4})?$/.test(value))throw TypeError('Invalid recipe target');return value;};
-  for(const step of recipe.operations){
-    const v=step.value===undefined?'':expression(step.value);
-    if(step.op==='let'){
-      if(!['float','vec2','vec3','vec4','bool'].includes(step.type)||!/^\w+$/.test(step.name))throw TypeError('Invalid recipe declaration');
-      types[step.name]=step.type;lines.push(`${step.type} ${step.name}=${v};`);
-      if(step.parameter==='sway')lines.push(`${step.name}*=dustRecipeSway;`);
-      else if(step.parameter==='rebound')lines.push(`if(dustRecipeRebound!=1.0)${step.name}=clamp(${step.name}*dustRecipeRebound,0.05,0.95);`);
-      else if(step.parameter)throw TypeError('Unsupported recipe parameter');
-    }else if(['set','add','subtract','multiply'].includes(step.op)){
-      lines.push(`${target(step.target)}${{set:'=',add:'+=',subtract:'-=',multiply:'*='}[step.op]}${v};`);
-    }else if(step.op==='turn')lines.push(`${target(step.target)}=thdTurn(${expression(step.vector)},(${expression(step.angle)})*dustRecipeSpin);`);
-    else if(step.op==='hinge')lines.push(`${target(step.target)}=thdHinge(${expression(step.point)},${expression(step.pivot)},${expression(step.axis)},(${expression(step.angle)})*dustRecipeShape);`);
-    else if(step.op==='deform'){
-      const to=target(step.target),type=to.includes('.')?(to.split('.')[1].length===1?'float':'vec'+to.split('.')[1].length):types[to];
-      if(!type||type==='bool')throw TypeError('Invalid deformation type');
-      lines.push(`if(dustRecipeShape==1.0)${to}*=${v};else ${to}*=max(${type}(0.01),mix(${type}(1.0),${type}(${v}),dustRecipeShape));`);
-    }else throw TypeError('Unsupported recipe operation: '+step.op);
-  }
-  return lines.join('\n');
-}
-export const textRecipeUniformShader=`
-uniform vec2 dustRecipeDirection;
-uniform float dustRecipeDepth;
-uniform float dustRecipeSpin;
-uniform float dustRecipeSway;
-uniform float dustRecipeShape;
-uniform float dustRecipeGlow;
-uniform vec3 dustRecipePalette;
-uniform float dustRecipeRebound;
-uniform float dustRecipePace;
-`;
+import {motionPrograms} from './text-motion-programs.js';
+
+const freeze=value=>{if(value&&typeof value==='object'&&!Object.isFrozen(value)){Object.values(value).forEach(freeze);Object.freeze(value);}return value;};
+// Trusted internal operation graphs. Public settings accept bounded values,
+// never expressions, GLSL, or executable source.
+export const textMotionRecipes=freeze(motionPrograms);
+export const textMotionAliases=freeze({});
+export const textRecipeControls=freeze({
+  angle:{label:'جهت حرکت',default:0,min:-180,max:180,step:15,choices:{'0':'اصلی','45':'مورب بالا','-45':'مورب پایین','90':'چرخش بالا','-90':'چرخش پایین','180':'معکوس'}},
+  depth:{label:'عمق',default:1,min:0,max:2,step:.1},
+  spin:{label:'پیچش',default:1,min:0,max:2,step:.1},
+  sway:{label:'موج و نوسان',default:1,min:0,max:2,step:.1},
+  shape:{label:'تغییر شکل مثلث‌ها',default:1,min:0,max:1.5,step:.1},
+  glow:{label:'درخشش',default:1,min:0,max:2,step:.1},
+  palette:{label:'رنگ درخشش',default:'original',choices:{original:'اصلی',cool:'آبی',warm:'گرم',mint:'نعنایی'}},
+  rebound:{label:'قدرت جهش',default:1,min:.25,max:1.5,step:.05},
+  pace:{label:'ریتم جهش',default:1,min:.25,max:2,step:.05}
+});
+export function normalizeTextMotionRecipe(value={},mode='dust-wind'){
+  if(!value||typeof value!=='object'||Array.isArray(value))throw TypeError('Recipe settings must be an object');
+  const result=Object.fromEntries(Object.entries(textRecipeControls).map(([key,control])=>[key,control.default]));
+  result.angle=textMotionAliases[mode]?.angle??(mode==='dust-wind-upward'?45:0);
+  for(const [key,v] of Object.entries(value)){
+    if(!Object.hasOwn(textRecipeControls,key))throw TypeError('Unknown recipe setting: '+key);
+    const control=textRecipeControls[key];
+    if(key==='palette'){if(typeof v!=='string'||!Object.hasOwn(control.choices,v))throw TypeError('Invalid recipe palette');}
+    else if(typeof v!=='number'||!Number.isFinite(v)||v<control.min||v>control.max)throw RangeError('Invalid recipe setting: '+key);
+    result[key]=v;
+  }
+  return Object.freeze(result);
+}
+
+// Shared compiler: expressions describe math, operations describe composition,
+// uniforms supply the bounded public intent controls.
+export function compileTextMotionRecipe(recipe){
+  if(!recipe||!Array.isArray(recipe.operations)||!recipe.operations.length)throw TypeError('Invalid motion recipe');
+  const types={face:recipe.ownFace?'vec2':'vec3'};
+  const lines=recipe.ownFace?[]:['vec3 face=p-vec3(dustTarget,p.z);'];
+  const expression=value=>{if(typeof value!=='string'||!value||/[;{}#]/.test(value))throw TypeError('Invalid recipe expression');return value;};
+  const target=value=>{if(typeof value!=='string'||!/^\w+(?:\.[xyzwrgba]{1,4})?$/.test(value))throw TypeError('Invalid recipe target');return value;};
+  for(const step of recipe.operations){
+    const v=step.value===undefined?'':expression(step.value);
+    if(step.op==='let'){
+      if(!['float','vec2','vec3','vec4','bool'].includes(step.type)||!/^\w+$/.test(step.name))throw TypeError('Invalid recipe declaration');
+      types[step.name]=step.type;lines.push(`${step.type} ${step.name}=${v};`);
+      if(step.parameter==='sway')lines.push(`${step.name}*=dustRecipeSway;`);
+      else if(step.parameter==='rebound')lines.push(`if(dustRecipeRebound!=1.0)${step.name}=clamp(${step.name}*dustRecipeRebound,0.05,0.95);`);
+      else if(step.parameter)throw TypeError('Unsupported recipe parameter');
+    }else if(['set','add','subtract','multiply'].includes(step.op)){
+      lines.push(`${target(step.target)}${{set:'=',add:'+=',subtract:'-=',multiply:'*='}[step.op]}${v};`);
+    }else if(step.op==='turn')lines.push(`${target(step.target)}=thdTurn(${expression(step.vector)},(${expression(step.angle)})*dustRecipeSpin);`);
+    else if(step.op==='hinge')lines.push(`${target(step.target)}=thdHinge(${expression(step.point)},${expression(step.pivot)},${expression(step.axis)},(${expression(step.angle)})*dustRecipeShape);`);
+    else if(step.op==='deform'){
+      const to=target(step.target),type=to.includes('.')?(to.split('.')[1].length===1?'float':'vec'+to.split('.')[1].length):types[to];
+      if(!type||type==='bool')throw TypeError('Invalid deformation type');
+      lines.push(`if(dustRecipeShape==1.0)${to}*=${v};else ${to}*=max(${type}(0.01),mix(${type}(1.0),${type}(${v}),dustRecipeShape));`);
+    }else throw TypeError('Unsupported recipe operation: '+step.op);
+  }
+  return lines.join('\n');
+}
+export const textRecipeUniformShader=`
+uniform vec2 dustRecipeDirection;
+uniform float dustRecipeDepth;
+uniform float dustRecipeSpin;
+uniform float dustRecipeSway;
+uniform float dustRecipeShape;
+uniform float dustRecipeGlow;
+uniform vec3 dustRecipePalette;
+uniform float dustRecipeRebound;
+uniform float dustRecipePace;
+`;