motionary 6.9.0 → 7.1.0

package/dist/components/fx2.d.cts

@@ -122,8 +122,6 @@ declare function loadEffectPack(src: string | {
 declare const GPU_FX: EffectDefinition[];
 /** Register the 6.2 GPU pack (idempotent). */
 declare function registerGpuPack(): void;
-/** @deprecated since 6.9 — use `registerGpuPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerGpuEffects(): void;
 
 /**
  * 6.3 — Text effects 3.0 (`motionary/components/fx-text`), registered through
@@ -150,8 +148,6 @@ declare function splitChars(el: HTMLElement): HTMLElement[];
 declare const TEXT3_FX: EffectDefinition[];
 /** Register the 6.3 text pack (idempotent). */
 declare function registerTextPack(): void;
-/** @deprecated since 6.9 — use `registerTextPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerTextEffects3(): void;
 
 /**
  * 6.4 — Light & materials (`motionary/components/fx-light`), registered
@@ -180,8 +176,6 @@ declare function trackPointer(el: HTMLElement, ctx: EffectContext, fn: (x: numbe
 declare const LIGHT_FX: EffectDefinition[];
 /** Register the 6.4 light & materials pack (idempotent). */
 declare function registerLightPack(): void;
-/** @deprecated since 6.9 — use `registerLightPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerLightEffects(): void;
 
 /**
  * 6.5 — 3D scene cards (`motionary/components/fx-3d`), registered through
@@ -205,8 +199,6 @@ declare function registerLightEffects(): void;
 declare const DEPTH3_FX: EffectDefinition[];
 /** Register the 6.5 3D pack (idempotent). */
 declare function register3dPack(): void;
-/** @deprecated since 6.9 — use `register3dPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function register3dEffects(): void;
 
 /**
  * 6.6 — Morph & SVG 2.0 (`motionary/components/fx-morph`), registered
@@ -234,8 +226,6 @@ declare const pointsToPath: (pts: [number, number][]) => string;
 declare const MORPH2_FX: EffectDefinition[];
 /** Register the 6.6 morph & SVG pack (idempotent). */
 declare function registerMorphPack(): void;
-/** @deprecated since 6.9 — use `registerMorphPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerMorphEffects2(): void;
 
 /**
  * 6.7 — Transitions 2.0 (`motionary/components/fx-transitions`), registered
@@ -269,8 +259,6 @@ declare function pageTransition(update: () => void | Promise<void>, effect?: str
 declare function crossDocumentTransitions(effect?: string, duration?: number): () => void;
 /** Register the 6.7 transitions pack (idempotent). */
 declare function registerTransitionsPack(): void;
-/** @deprecated since 6.9 — use `registerTransitionsPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerTransitionEffects2(): void;
 
 /**
  * 6.8 — Weather & ambience (`motionary/components/fx-weather`), registered
@@ -297,8 +285,6 @@ declare function skyAt(hour: number): [string, string];
 declare const WEATHER_FX: EffectDefinition[];
 /** Register the 6.8 weather & ambience pack (idempotent). */
 declare function registerWeatherPack(): void;
-/** @deprecated since 6.9 — use `registerWeatherPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerWeatherEffects(): void;
 
 /**
  * 6.8 — Interactive physics 2.0 (`motionary/components/fx-physics`) on a tiny
@@ -346,8 +332,6 @@ declare class VerletWorld {
 declare const PHYSICS2_FX: EffectDefinition[];
 /** Register the 6.8 physics 2.0 pack (idempotent). */
 declare function registerPhysicsPack(): void;
-/** @deprecated since 6.9 — use `registerPhysicsPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerPhysicsEffects2(): void;
 
 /**
  * 6.9 — Focus & feedback (`motionary/components/fx-focus`), registered
@@ -370,6 +354,64 @@ declare const FOCUS_FX: EffectDefinition[];
 /** Register the 6.9 focus & feedback pack (idempotent). */
 declare function registerFocusPack(): void;
 
+/**
+ * 5.6 — sound-reactive effects (Web Audio).
+ *
+ * - `enableAudio(input)` — start analysing the microphone (`'mic'`), an
+ *   `<audio>` / `<video>` element (or a selector for one) or a `MediaStream`.
+ *   Browsers only allow an `AudioContext` to start inside a user gesture, so
+ *   call it from a click handler (or use `<usa-audio>`, which renders the
+ *   toggle button for you).
+ * - Background effects (kind `background`, Canvas 2D through
+ *   `canvasBackground()`): `spectrum-bars`, `pulse-ring`, `wave-ring`. Before
+ *   audio is enabled they idle gently.
+ * - Beat detection: `createBeatDetector()` (pure: energy → beat?), `onBeat(cb)`
+ *   and `bindBeat(el, effect, options)`, which plays any registered effect on
+ *   every beat. `<usa-audio>` does the same for `[data-usa-beat="effect"]`
+ *   children and emits `usa-beat`.
+ * - While audio runs, `--usa-audio-level` and `--usa-audio-bass` (0–1) are set
+ *   on `<html>` for CSS-driven reactions.
+ *
+ * Reduced motion: the visual effects are skipped, beats play no effects and
+ * the CSS variables stay at 0 — audio itself keeps playing.
+ */
+
+interface AudioSample {
+    /** Overall loudness (RMS of the waveform), 0–1. */
+    level: number;
+    /** Low-frequency energy (first ~8 % of the spectrum), 0–1. */
+    bass: number;
+    /** Frequency bins, 0–255 each. */
+    freq: Uint8Array;
+    /** Time-domain waveform, 0–255 (128 = silence). */
+    wave: Uint8Array;
+}
+
+/**
+ * 7.1 — Music visualization (`motionary/fx/music`, also
+ * `motionary/components/fx-music`), registered through `registerEffect()`.
+ * Every effect reads the running analyser (`enableAudio()` / `<usa-audio>`);
+ * without one it plays a gentle synthetic signal (`syntheticSample()`), so
+ * the visuals work as decoration too.
+ *
+ * - `waveform-scope` (background) — an oscilloscope line of the waveform.
+ * - `radial-spectrum` (background) — spectrum bars around a circle.
+ * - `spectrum-mirror` (background) — mirrored bars with a reflection.
+ * - `sound-particles` (background) — particles launched by the bass.
+ * - `beat-bounce` (loop) — the element pumps with the bass.
+ * - `vinyl-spin` (loop) — the element turns like a record; level speeds it.
+ *
+ * Reduced motion: backgrounds draw one static frame, loops do nothing.
+ */
+
+/** A smooth, deterministic fake analyser frame at time `t` (s). */
+declare function syntheticSample(t: number, bins?: number): AudioSample;
+/** The live analyser frame, or the synthetic one. */
+declare const musicSample: (t: number) => AudioSample;
+declare const MUSIC_FX: EffectDefinition[];
+/** Register the 7.1 music visualization pack (idempotent). */
+declare function registerMusicPack(): void;
+
 /**
  * 5.5 — generative backgrounds on Canvas 2D, registered through
  * `registerEffect()` (kind `background`): `flow-field`, `voronoi`,
@@ -414,6 +456,8 @@ interface GenerativeSpec {
 /** GLSL shared by every shader: uniforms, hash, value noise, fbm. */
 declare const GLSL_HEAD = "#version 300 es\nprecision highp float;\nuniform vec2 u_res;uniform float u_t;uniform vec3 u_c0,u_c1,u_c2;uniform vec2 u_ptr;uniform float u_speed,u_scale;\nout vec4 o;\nfloat h(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453);}\nfloat n(vec2 p){vec2 i=floor(p),f=fract(p);f=f*f*(3.-2.*f);return mix(mix(h(i),h(i+vec2(1,0)),f.x),mix(h(i+vec2(0,1)),h(i+1.),f.x),f.y);}\nfloat fbm(vec2 p){float v=0.,a=.5;for(int k=0;k<5;k++){v+=a*n(p);p=p*2.03+vec2(1.7,9.2);a*=.5;}return v;}\n";
 interface ShaderSpec {
+    /** 7.0: hand-written WGSL statements for the WebGPU backend (default: `glslToWgsl(body)`). */
+    wgsl?: string;
     /** GLSL body of `main()`: `uv` (0–1), `p` (aspect-corrected, scaled), `t` (s × speed) are in scope; write `o`. */
     body: string;
     /** Canvas 2D fallback. */
@@ -422,7 +466,9 @@ interface ShaderSpec {
 declare function supportsWebGL2(): boolean;
 /**
  * Mount a shader background behind `el` (options: `colors` [3 hex], `speed`,
- * `scale`, `quality`, `backend` = `'auto' | 'webgl2' | 'canvas'`). Returns the cleanup.
+ * `scale`, `quality`, `backend` = `'auto' | 'webgpu' | 'webgl2' | 'canvas'`).
+ * 7.0: `auto` tries WebGPU first, then WebGL2, then Canvas 2D
+ * (`el.dataset.usaBackend` names the one running). Returns the cleanup.
  */
 declare function shaderBackground(el: HTMLElement, fx: EffectContext, spec: ShaderSpec, o: any): () => void;
 /**
@@ -431,6 +477,39 @@ declare function shaderBackground(el: HTMLElement, fx: EffectContext, spec: Shad
  */
 declare function fieldFallback(color: (x: number, y: number, t: number, o: any) => [number, number, number], cell?: number): GenerativeSpec;
 
+/**
+ * 7.0 — WebGPU backend for the shader backgrounds (`shaderBackground()`).
+ *
+ * Every 6.x shader is written once as a small GLSL `main()` body. 7.0 runs it
+ * on **WebGPU** where the browser has it: `glslToWgsl()` translates the body
+ * (types, constructors, literals, loops, uniforms) into a WGSL fragment
+ * shader with the same noise helpers; a spec can also ship hand-written
+ * `wgsl`. If WebGPU is missing, the adapter / device is refused, or the
+ * shader does not compile, the effect falls back to **WebGL2**, then to the
+ * Canvas 2D fallback — `el.dataset.usaBackend` says which one runs.
+ */
+
+/** WGSL shared by every shader: uniforms, hash, value noise, fbm (mirrors `GLSL_HEAD`). */
+declare const WGSL_HEAD = "struct U{res:vec2f,ptr:vec2f,t:f32,speed:f32,scale:f32,pad:f32,c0:vec4f,c1:vec4f,c2:vec4f};\n@group(0) @binding(0) var<uniform> u:U;\nfn h(p:vec2f)->f32{return fract(sin(dot(p,vec2f(127.1,311.7)))*43758.5453);}\nfn n(p:vec2f)->f32{let i=floor(p);var f=fract(p);f=f*f*(3.0-2.0*f);return mix(mix(h(i),h(i+vec2f(1.0,0.0)),f.x),mix(h(i+vec2f(0.0,1.0)),h(i+vec2f(1.0,1.0)),f.x),f.y);}\nfn fbm(p0:vec2f)->f32{var v=0.0;var a=0.5;var p=p0;for(var k=0;k<5;k++){v+=a*n(p);p=p*2.03+vec2f(1.7,9.2);a*=0.5;}return v;}\n@vertex fn vs(@builtin(vertex_index) i:u32)->@builtin(position) vec4f{var q=array<vec2f,3>(vec2f(-1.0,-1.0),vec2f(3.0,-1.0),vec2f(-1.0,3.0));return vec4f(q[i],0.0,1.0);}\n";
+/**
+ * Translate a GLSL `main()` body (the 6.x `ShaderSpec.body` dialect) to WGSL
+ * statements. Throws on constructs it does not support (ternaries, `mod`,
+ * `discard`, user functions) so the caller can fall back to WebGL2.
+ */
+declare function glslToWgsl(body: string): string;
+/** The full WGSL module for a body. */
+declare const wgslModule: (body: string) => string;
+/** `true` when `navigator.gpu` exists (the adapter may still be refused). */
+declare const supportsWebGPU: () => boolean;
+/**
+ * Start a WebGPU shader background behind `el`. Resolves to its cleanup, or
+ * `null` when WebGPU cannot run this shader (the caller falls back).
+ */
+declare function webgpuBackground(el: HTMLElement, fx: EffectContext, spec: {
+    body: string;
+    wgsl?: string;
+}, o: any): Promise<(() => void) | null>;
+
 /**
  * The 6.x effect packs, one entry each (`motionary/components/fx-gpu`, …) so
  * their size budgets stay separate. This module (`registerFx2()`) registers
@@ -441,10 +520,6 @@ declare function fieldFallback(color: (x: number, y: number, t: number, o: any)
 declare const EFFECT_PACKS: Record<string, EffectDefinition[]>;
 /** Register every 6.x effect pack (idempotent). */
 declare function registerEffectPacks(): void;
-/** @deprecated since 6.9 — `EFFECT_PACKS` (removed in 7.0). */
-declare const FX2_PACKS: Record<string, EffectDefinition<Record<string, any>>[]>;
-/** @deprecated since 6.9 — use `registerEffectPacks()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerFx2(): void;
 
-export { DEPTH3_FX, EFFECT_PACKS, EFFECT_PACK_FORMAT, FOCUS_FX, FX2_PACKS, GLSL_HEAD, GPU_FX, LIGHT_FX, MORPH2_FX, PHYSICS2_FX, TEXT3_FX, TRANSITIONS2_FX, VerletWorld, WEATHER_FX, crossDocumentTransitions, fieldFallback, loadEffectPack, packManifest, pageTransition, pointsToPath, register3dEffects, register3dPack, registerEffectPacks, registerFocusPack, registerFx2, registerGpuEffects, registerGpuPack, registerLightEffects, registerLightPack, registerMorphEffects2, registerMorphPack, registerPhysicsEffects2, registerPhysicsPack, registerTextEffects3, registerTextPack, registerTransitionEffects2, registerTransitionsPack, registerWeatherEffects, registerWeatherPack, samplePath, shaderBackground, skyAt, splitChars, supportsWebGL2, trackPointer, validateManifest };
+export { DEPTH3_FX, EFFECT_PACKS, EFFECT_PACK_FORMAT, FOCUS_FX, GLSL_HEAD, GPU_FX, LIGHT_FX, MORPH2_FX, MUSIC_FX, PHYSICS2_FX, TEXT3_FX, TRANSITIONS2_FX, VerletWorld, WEATHER_FX, WGSL_HEAD, crossDocumentTransitions, fieldFallback, glslToWgsl, loadEffectPack, musicSample, packManifest, pageTransition, pointsToPath, register3dPack, registerEffectPacks, registerFocusPack, registerGpuPack, registerLightPack, registerMorphPack, registerMusicPack, registerPhysicsPack, registerTextPack, registerTransitionsPack, registerWeatherPack, samplePath, shaderBackground, skyAt, splitChars, supportsWebGL2, supportsWebGPU, syntheticSample, trackPointer, validateManifest, webgpuBackground, wgslModule };
 export type { EffectPackManifest, ShaderSpec };

package/dist/components/fx2.d.ts

@@ -122,8 +122,6 @@ declare function loadEffectPack(src: string | {
 declare const GPU_FX: EffectDefinition[];
 /** Register the 6.2 GPU pack (idempotent). */
 declare function registerGpuPack(): void;
-/** @deprecated since 6.9 — use `registerGpuPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerGpuEffects(): void;
 
 /**
  * 6.3 — Text effects 3.0 (`motionary/components/fx-text`), registered through
@@ -150,8 +148,6 @@ declare function splitChars(el: HTMLElement): HTMLElement[];
 declare const TEXT3_FX: EffectDefinition[];
 /** Register the 6.3 text pack (idempotent). */
 declare function registerTextPack(): void;
-/** @deprecated since 6.9 — use `registerTextPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerTextEffects3(): void;
 
 /**
  * 6.4 — Light & materials (`motionary/components/fx-light`), registered
@@ -180,8 +176,6 @@ declare function trackPointer(el: HTMLElement, ctx: EffectContext, fn: (x: numbe
 declare const LIGHT_FX: EffectDefinition[];
 /** Register the 6.4 light & materials pack (idempotent). */
 declare function registerLightPack(): void;
-/** @deprecated since 6.9 — use `registerLightPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerLightEffects(): void;
 
 /**
  * 6.5 — 3D scene cards (`motionary/components/fx-3d`), registered through
@@ -205,8 +199,6 @@ declare function registerLightEffects(): void;
 declare const DEPTH3_FX: EffectDefinition[];
 /** Register the 6.5 3D pack (idempotent). */
 declare function register3dPack(): void;
-/** @deprecated since 6.9 — use `register3dPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function register3dEffects(): void;
 
 /**
  * 6.6 — Morph & SVG 2.0 (`motionary/components/fx-morph`), registered
@@ -234,8 +226,6 @@ declare const pointsToPath: (pts: [number, number][]) => string;
 declare const MORPH2_FX: EffectDefinition[];
 /** Register the 6.6 morph & SVG pack (idempotent). */
 declare function registerMorphPack(): void;
-/** @deprecated since 6.9 — use `registerMorphPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerMorphEffects2(): void;
 
 /**
  * 6.7 — Transitions 2.0 (`motionary/components/fx-transitions`), registered
@@ -269,8 +259,6 @@ declare function pageTransition(update: () => void | Promise<void>, effect?: str
 declare function crossDocumentTransitions(effect?: string, duration?: number): () => void;
 /** Register the 6.7 transitions pack (idempotent). */
 declare function registerTransitionsPack(): void;
-/** @deprecated since 6.9 — use `registerTransitionsPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerTransitionEffects2(): void;
 
 /**
  * 6.8 — Weather & ambience (`motionary/components/fx-weather`), registered
@@ -297,8 +285,6 @@ declare function skyAt(hour: number): [string, string];
 declare const WEATHER_FX: EffectDefinition[];
 /** Register the 6.8 weather & ambience pack (idempotent). */
 declare function registerWeatherPack(): void;
-/** @deprecated since 6.9 — use `registerWeatherPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerWeatherEffects(): void;
 
 /**
  * 6.8 — Interactive physics 2.0 (`motionary/components/fx-physics`) on a tiny
@@ -346,8 +332,6 @@ declare class VerletWorld {
 declare const PHYSICS2_FX: EffectDefinition[];
 /** Register the 6.8 physics 2.0 pack (idempotent). */
 declare function registerPhysicsPack(): void;
-/** @deprecated since 6.9 — use `registerPhysicsPack()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerPhysicsEffects2(): void;
 
 /**
  * 6.9 — Focus & feedback (`motionary/components/fx-focus`), registered
@@ -370,6 +354,64 @@ declare const FOCUS_FX: EffectDefinition[];
 /** Register the 6.9 focus & feedback pack (idempotent). */
 declare function registerFocusPack(): void;
 
+/**
+ * 5.6 — sound-reactive effects (Web Audio).
+ *
+ * - `enableAudio(input)` — start analysing the microphone (`'mic'`), an
+ *   `<audio>` / `<video>` element (or a selector for one) or a `MediaStream`.
+ *   Browsers only allow an `AudioContext` to start inside a user gesture, so
+ *   call it from a click handler (or use `<usa-audio>`, which renders the
+ *   toggle button for you).
+ * - Background effects (kind `background`, Canvas 2D through
+ *   `canvasBackground()`): `spectrum-bars`, `pulse-ring`, `wave-ring`. Before
+ *   audio is enabled they idle gently.
+ * - Beat detection: `createBeatDetector()` (pure: energy → beat?), `onBeat(cb)`
+ *   and `bindBeat(el, effect, options)`, which plays any registered effect on
+ *   every beat. `<usa-audio>` does the same for `[data-usa-beat="effect"]`
+ *   children and emits `usa-beat`.
+ * - While audio runs, `--usa-audio-level` and `--usa-audio-bass` (0–1) are set
+ *   on `<html>` for CSS-driven reactions.
+ *
+ * Reduced motion: the visual effects are skipped, beats play no effects and
+ * the CSS variables stay at 0 — audio itself keeps playing.
+ */
+
+interface AudioSample {
+    /** Overall loudness (RMS of the waveform), 0–1. */
+    level: number;
+    /** Low-frequency energy (first ~8 % of the spectrum), 0–1. */
+    bass: number;
+    /** Frequency bins, 0–255 each. */
+    freq: Uint8Array;
+    /** Time-domain waveform, 0–255 (128 = silence). */
+    wave: Uint8Array;
+}
+
+/**
+ * 7.1 — Music visualization (`motionary/fx/music`, also
+ * `motionary/components/fx-music`), registered through `registerEffect()`.
+ * Every effect reads the running analyser (`enableAudio()` / `<usa-audio>`);
+ * without one it plays a gentle synthetic signal (`syntheticSample()`), so
+ * the visuals work as decoration too.
+ *
+ * - `waveform-scope` (background) — an oscilloscope line of the waveform.
+ * - `radial-spectrum` (background) — spectrum bars around a circle.
+ * - `spectrum-mirror` (background) — mirrored bars with a reflection.
+ * - `sound-particles` (background) — particles launched by the bass.
+ * - `beat-bounce` (loop) — the element pumps with the bass.
+ * - `vinyl-spin` (loop) — the element turns like a record; level speeds it.
+ *
+ * Reduced motion: backgrounds draw one static frame, loops do nothing.
+ */
+
+/** A smooth, deterministic fake analyser frame at time `t` (s). */
+declare function syntheticSample(t: number, bins?: number): AudioSample;
+/** The live analyser frame, or the synthetic one. */
+declare const musicSample: (t: number) => AudioSample;
+declare const MUSIC_FX: EffectDefinition[];
+/** Register the 7.1 music visualization pack (idempotent). */
+declare function registerMusicPack(): void;
+
 /**
  * 5.5 — generative backgrounds on Canvas 2D, registered through
  * `registerEffect()` (kind `background`): `flow-field`, `voronoi`,
@@ -414,6 +456,8 @@ interface GenerativeSpec {
 /** GLSL shared by every shader: uniforms, hash, value noise, fbm. */
 declare const GLSL_HEAD = "#version 300 es\nprecision highp float;\nuniform vec2 u_res;uniform float u_t;uniform vec3 u_c0,u_c1,u_c2;uniform vec2 u_ptr;uniform float u_speed,u_scale;\nout vec4 o;\nfloat h(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453);}\nfloat n(vec2 p){vec2 i=floor(p),f=fract(p);f=f*f*(3.-2.*f);return mix(mix(h(i),h(i+vec2(1,0)),f.x),mix(h(i+vec2(0,1)),h(i+1.),f.x),f.y);}\nfloat fbm(vec2 p){float v=0.,a=.5;for(int k=0;k<5;k++){v+=a*n(p);p=p*2.03+vec2(1.7,9.2);a*=.5;}return v;}\n";
 interface ShaderSpec {
+    /** 7.0: hand-written WGSL statements for the WebGPU backend (default: `glslToWgsl(body)`). */
+    wgsl?: string;
     /** GLSL body of `main()`: `uv` (0–1), `p` (aspect-corrected, scaled), `t` (s × speed) are in scope; write `o`. */
     body: string;
     /** Canvas 2D fallback. */
@@ -422,7 +466,9 @@ interface ShaderSpec {
 declare function supportsWebGL2(): boolean;
 /**
  * Mount a shader background behind `el` (options: `colors` [3 hex], `speed`,
- * `scale`, `quality`, `backend` = `'auto' | 'webgl2' | 'canvas'`). Returns the cleanup.
+ * `scale`, `quality`, `backend` = `'auto' | 'webgpu' | 'webgl2' | 'canvas'`).
+ * 7.0: `auto` tries WebGPU first, then WebGL2, then Canvas 2D
+ * (`el.dataset.usaBackend` names the one running). Returns the cleanup.
  */
 declare function shaderBackground(el: HTMLElement, fx: EffectContext, spec: ShaderSpec, o: any): () => void;
 /**
@@ -431,6 +477,39 @@ declare function shaderBackground(el: HTMLElement, fx: EffectContext, spec: Shad
  */
 declare function fieldFallback(color: (x: number, y: number, t: number, o: any) => [number, number, number], cell?: number): GenerativeSpec;
 
+/**
+ * 7.0 — WebGPU backend for the shader backgrounds (`shaderBackground()`).
+ *
+ * Every 6.x shader is written once as a small GLSL `main()` body. 7.0 runs it
+ * on **WebGPU** where the browser has it: `glslToWgsl()` translates the body
+ * (types, constructors, literals, loops, uniforms) into a WGSL fragment
+ * shader with the same noise helpers; a spec can also ship hand-written
+ * `wgsl`. If WebGPU is missing, the adapter / device is refused, or the
+ * shader does not compile, the effect falls back to **WebGL2**, then to the
+ * Canvas 2D fallback — `el.dataset.usaBackend` says which one runs.
+ */
+
+/** WGSL shared by every shader: uniforms, hash, value noise, fbm (mirrors `GLSL_HEAD`). */
+declare const WGSL_HEAD = "struct U{res:vec2f,ptr:vec2f,t:f32,speed:f32,scale:f32,pad:f32,c0:vec4f,c1:vec4f,c2:vec4f};\n@group(0) @binding(0) var<uniform> u:U;\nfn h(p:vec2f)->f32{return fract(sin(dot(p,vec2f(127.1,311.7)))*43758.5453);}\nfn n(p:vec2f)->f32{let i=floor(p);var f=fract(p);f=f*f*(3.0-2.0*f);return mix(mix(h(i),h(i+vec2f(1.0,0.0)),f.x),mix(h(i+vec2f(0.0,1.0)),h(i+vec2f(1.0,1.0)),f.x),f.y);}\nfn fbm(p0:vec2f)->f32{var v=0.0;var a=0.5;var p=p0;for(var k=0;k<5;k++){v+=a*n(p);p=p*2.03+vec2f(1.7,9.2);a*=0.5;}return v;}\n@vertex fn vs(@builtin(vertex_index) i:u32)->@builtin(position) vec4f{var q=array<vec2f,3>(vec2f(-1.0,-1.0),vec2f(3.0,-1.0),vec2f(-1.0,3.0));return vec4f(q[i],0.0,1.0);}\n";
+/**
+ * Translate a GLSL `main()` body (the 6.x `ShaderSpec.body` dialect) to WGSL
+ * statements. Throws on constructs it does not support (ternaries, `mod`,
+ * `discard`, user functions) so the caller can fall back to WebGL2.
+ */
+declare function glslToWgsl(body: string): string;
+/** The full WGSL module for a body. */
+declare const wgslModule: (body: string) => string;
+/** `true` when `navigator.gpu` exists (the adapter may still be refused). */
+declare const supportsWebGPU: () => boolean;
+/**
+ * Start a WebGPU shader background behind `el`. Resolves to its cleanup, or
+ * `null` when WebGPU cannot run this shader (the caller falls back).
+ */
+declare function webgpuBackground(el: HTMLElement, fx: EffectContext, spec: {
+    body: string;
+    wgsl?: string;
+}, o: any): Promise<(() => void) | null>;
+
 /**
  * The 6.x effect packs, one entry each (`motionary/components/fx-gpu`, …) so
  * their size budgets stay separate. This module (`registerFx2()`) registers
@@ -441,10 +520,6 @@ declare function fieldFallback(color: (x: number, y: number, t: number, o: any)
 declare const EFFECT_PACKS: Record<string, EffectDefinition[]>;
 /** Register every 6.x effect pack (idempotent). */
 declare function registerEffectPacks(): void;
-/** @deprecated since 6.9 — `EFFECT_PACKS` (removed in 7.0). */
-declare const FX2_PACKS: Record<string, EffectDefinition<Record<string, any>>[]>;
-/** @deprecated since 6.9 — use `registerEffectPacks()` (removed in 7.0; `npx usa-codemod-7`). */
-declare function registerFx2(): void;
 
-export { DEPTH3_FX, EFFECT_PACKS, EFFECT_PACK_FORMAT, FOCUS_FX, FX2_PACKS, GLSL_HEAD, GPU_FX, LIGHT_FX, MORPH2_FX, PHYSICS2_FX, TEXT3_FX, TRANSITIONS2_FX, VerletWorld, WEATHER_FX, crossDocumentTransitions, fieldFallback, loadEffectPack, packManifest, pageTransition, pointsToPath, register3dEffects, register3dPack, registerEffectPacks, registerFocusPack, registerFx2, registerGpuEffects, registerGpuPack, registerLightEffects, registerLightPack, registerMorphEffects2, registerMorphPack, registerPhysicsEffects2, registerPhysicsPack, registerTextEffects3, registerTextPack, registerTransitionEffects2, registerTransitionsPack, registerWeatherEffects, registerWeatherPack, samplePath, shaderBackground, skyAt, splitChars, supportsWebGL2, trackPointer, validateManifest };
+export { DEPTH3_FX, EFFECT_PACKS, EFFECT_PACK_FORMAT, FOCUS_FX, GLSL_HEAD, GPU_FX, LIGHT_FX, MORPH2_FX, MUSIC_FX, PHYSICS2_FX, TEXT3_FX, TRANSITIONS2_FX, VerletWorld, WEATHER_FX, WGSL_HEAD, crossDocumentTransitions, fieldFallback, glslToWgsl, loadEffectPack, musicSample, packManifest, pageTransition, pointsToPath, register3dPack, registerEffectPacks, registerFocusPack, registerGpuPack, registerLightPack, registerMorphPack, registerMusicPack, registerPhysicsPack, registerTextPack, registerTransitionsPack, registerWeatherPack, samplePath, shaderBackground, skyAt, splitChars, supportsWebGL2, supportsWebGPU, syntheticSample, trackPointer, validateManifest, webgpuBackground, wgslModule };
 export type { EffectPackManifest, ShaderSpec };

package/dist/components/fx2.js

@@ -1,25 +1,27 @@
-import { u as deprecate } from '../chunks/base-D5MHqeDd.js';
 export { EFFECT_PACK_FORMAT, loadEffectPack, packManifest, validateManifest } from './marketplace.js';
-import { G as GPU_FX, r as registerGpuPack } from '../chunks/gpu-DPhMkJq6.js';
-export { a as GLSL_HEAD, f as fieldFallback, b as registerGpuEffects, s as shaderBackground, c as supportsWebGL2 } from '../chunks/gpu-DPhMkJq6.js';
+import { G as GPU_FX, r as registerGpuPack } from '../chunks/gpu-DLPghVWr.js';
+export { a as GLSL_HEAD, W as WGSL_HEAD, f as fieldFallback, g as glslToWgsl, s as shaderBackground, b as supportsWebGL2, c as supportsWebGPU, w as webgpuBackground, d as wgslModule } from '../chunks/gpu-DLPghVWr.js';
 import { TEXT3_FX, registerTextPack } from './fx-text.js';
-export { registerTextEffects3, splitChars } from './fx-text.js';
+export { splitChars } from './fx-text.js';
 import { LIGHT_FX, registerLightPack } from './fx-light.js';
-export { registerLightEffects, trackPointer } from './fx-light.js';
+export { trackPointer } from './fx-light.js';
 import { DEPTH3_FX, register3dPack } from './fx-3d.js';
-export { register3dEffects } from './fx-3d.js';
 import { MORPH2_FX, registerMorphPack } from './fx-morph.js';
-export { pointsToPath, registerMorphEffects2, samplePath } from './fx-morph.js';
+export { pointsToPath, samplePath } from './fx-morph.js';
 import { TRANSITIONS2_FX, registerTransitionsPack } from './fx-transitions.js';
-export { crossDocumentTransitions, pageTransition, registerTransitionEffects2 } from './fx-transitions.js';
+export { crossDocumentTransitions, pageTransition } from './fx-transitions.js';
 import { WEATHER_FX, registerWeatherPack } from './fx-weather.js';
-export { registerWeatherEffects, skyAt } from './fx-weather.js';
+export { skyAt } from './fx-weather.js';
 import { PHYSICS2_FX, registerPhysicsPack } from './fx-physics.js';
-export { VerletWorld, registerPhysicsEffects2 } from './fx-physics.js';
+export { VerletWorld } from './fx-physics.js';
 import { FOCUS_FX, registerFocusPack } from './fx-focus.js';
-import '../chunks/registry-CTLWeg-J.js';
+import { MUSIC_FX, registerMusicPack } from './fx-music.js';
+export { musicSample, syntheticSample } from './fx-music.js';
+import '../chunks/registry-CyKExAmE.js';
+import '../chunks/base-2-yYc93C.js';
 import '../chunks/generative-2LhxG5BJ.js';
 import '../chunks/shared-CkKHWrtJ.js';
+import '../chunks/audio-DcPvT2Kh.js';
 
 /** The 6.x effect packs by name. */
 const EFFECT_PACKS = {
@@ -32,6 +34,7 @@ const EFFECT_PACKS = {
     weather: WEATHER_FX,
     physics: PHYSICS2_FX,
     focus: FOCUS_FX,
+    music: MUSIC_FX,
 };
 /** Register every 6.x effect pack (idempotent). */
 function registerEffectPacks() {
@@ -44,14 +47,8 @@ function registerEffectPacks() {
     registerWeatherPack();
     registerPhysicsPack();
     registerFocusPack();
-}
-/** @deprecated since 6.9 — `EFFECT_PACKS` (removed in 7.0). */
-const FX2_PACKS = EFFECT_PACKS;
-/** @deprecated since 6.9 — use `registerEffectPacks()` (removed in 7.0; `npx usa-codemod-7`). */
-function registerFx2() {
-    deprecate('registerFx2', 'registerFx2() is deprecated since 6.9 and removed in 7.0 — use registerEffectPacks() (npx usa-codemod-7).');
-    registerEffectPacks();
+    registerMusicPack();
 }
 
-export { DEPTH3_FX, EFFECT_PACKS, FOCUS_FX, FX2_PACKS, GPU_FX, LIGHT_FX, MORPH2_FX, PHYSICS2_FX, TEXT3_FX, TRANSITIONS2_FX, WEATHER_FX, register3dPack, registerEffectPacks, registerFocusPack, registerFx2, registerGpuPack, registerLightPack, registerMorphPack, registerPhysicsPack, registerTextPack, registerTransitionsPack, registerWeatherPack };
+export { DEPTH3_FX, EFFECT_PACKS, FOCUS_FX, GPU_FX, LIGHT_FX, MORPH2_FX, MUSIC_FX, PHYSICS2_FX, TEXT3_FX, TRANSITIONS2_FX, WEATHER_FX, register3dPack, registerEffectPacks, registerFocusPack, registerGpuPack, registerLightPack, registerMorphPack, registerMusicPack, registerPhysicsPack, registerTextPack, registerTransitionsPack, registerWeatherPack };
 //# sourceMappingURL=fx2.js.map

package/dist/components/fx2.js.map

@@ -1 +1 @@
-{"version":3,"file":"fx2.js","sources":["../../src/components/fx2/index.ts"],"sourcesContent":["/**\n * The 6.x effect packs, one entry each (`motionary/components/fx-gpu`, …) so\n * their size budgets stay separate. This module (`registerFx2()`) registers\n * them all — used by dist/widgets.umd.js and the showcase.\n */\nimport type { EffectDefinition } from '../fx/registry';\nimport { deprecate } from '../base';\nexport { EFFECT_PACK_FORMAT, packManifest, validateManifest, loadEffectPack } from './manifest';\nexport type { EffectPackManifest } from './manifest';\nimport { GPU_FX, registerGpuPack, registerGpuEffects } from './gpu';\nimport { TEXT3_FX, registerTextPack, registerTextEffects3, splitChars } from './text3';\nimport { LIGHT_FX, registerLightPack, registerLightEffects, trackPointer } from './light';\nimport { DEPTH3_FX, register3dPack, register3dEffects } from './depth3';\nimport { MORPH2_FX, registerMorphPack, registerMorphEffects2, samplePath, pointsToPath } from './morph2';\nimport { TRANSITIONS2_FX, registerTransitionsPack, registerTransitionEffects2, pageTransition, crossDocumentTransitions } from './transitions2';\nimport { WEATHER_FX, registerWeatherPack, registerWeatherEffects, skyAt } from './weather';\nimport { PHYSICS2_FX, registerPhysicsPack, registerPhysicsEffects2, VerletWorld } from './physics2';\nimport { FOCUS_FX, registerFocusPack } from './focus';\n\nexport { GPU_FX, registerGpuPack, registerGpuEffects, TEXT3_FX, registerTextPack, registerTextEffects3, splitChars };\nexport { shaderBackground, supportsWebGL2, fieldFallback, GLSL_HEAD } from './gl';\nexport type { ShaderSpec } from './gl';\n\nexport { LIGHT_FX, registerLightPack, registerLightEffects, trackPointer };\n\nexport { DEPTH3_FX, register3dPack, register3dEffects };\n\nexport { MORPH2_FX, registerMorphPack, registerMorphEffects2, samplePath, pointsToPath };\n\nexport { TRANSITIONS2_FX, registerTransitionsPack, registerTransitionEffects2, pageTransition, crossDocumentTransitions };\n\nexport { WEATHER_FX, registerWeatherPack, registerWeatherEffects, skyAt };\n\nexport { PHYSICS2_FX, registerPhysicsPack, registerPhysicsEffects2, VerletWorld };\n\nexport { FOCUS_FX, registerFocusPack };\n\n/** The 6.x effect packs by name. */\nexport const EFFECT_PACKS: Record<string, EffectDefinition[]> = {\n  gpu: GPU_FX,\n  text: TEXT3_FX,\n  light: LIGHT_FX,\n  depth: DEPTH3_FX,\n  morph: MORPH2_FX,\n  transitions: TRANSITIONS2_FX,\n  weather: WEATHER_FX,\n  physics: PHYSICS2_FX,\n  focus: FOCUS_FX,\n};\n\n/** Register every 6.x effect pack (idempotent). */\nexport function registerEffectPacks(): void {\n  registerGpuPack();\n  registerTextPack();\n  registerLightPack();\n  register3dPack();\n  registerMorphPack();\n  registerTransitionsPack();\n  registerWeatherPack();\n  registerPhysicsPack();\n  registerFocusPack();\n}\n\n/** @deprecated since 6.9 — `EFFECT_PACKS` (removed in 7.0). */\nexport const FX2_PACKS = EFFECT_PACKS;\n\n/** @deprecated since 6.9 — use `registerEffectPacks()` (removed in 7.0; `npx usa-codemod-7`). */\nexport function registerFx2(): void {\n  deprecate('registerFx2', 'registerFx2() is deprecated since 6.9 and removed in 7.0 — use registerEffectPacks() (npx usa-codemod-7).');\n  registerEffectPacks();\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAqCA;AACO,MAAM,YAAY,GAAuC;AAC9D,IAAA,GAAG,EAAE,MAAM;AACX,IAAA,IAAI,EAAE,QAAQ;AACd,IAAA,KAAK,EAAE,QAAQ;AACf,IAAA,KAAK,EAAE,SAAS;AAChB,IAAA,KAAK,EAAE,SAAS;AAChB,IAAA,WAAW,EAAE,eAAe;AAC5B,IAAA,OAAO,EAAE,UAAU;AACnB,IAAA,OAAO,EAAE,WAAW;AACpB,IAAA,KAAK,EAAE,QAAQ;;AAGjB;SACgB,mBAAmB,GAAA;AACjC,IAAA,eAAe,EAAE;AACjB,IAAA,gBAAgB,EAAE;AAClB,IAAA,iBAAiB,EAAE;AACnB,IAAA,cAAc,EAAE;AAChB,IAAA,iBAAiB,EAAE;AACnB,IAAA,uBAAuB,EAAE;AACzB,IAAA,mBAAmB,EAAE;AACrB,IAAA,mBAAmB,EAAE;AACrB,IAAA,iBAAiB,EAAE;AACrB;AAEA;AACO,MAAM,SAAS,GAAG;AAEzB;SACgB,WAAW,GAAA;AACzB,IAAA,SAAS,CAAC,aAAa,EAAE,2GAA2G,CAAC;AACrI,IAAA,mBAAmB,EAAE;AACvB;;;;"}
+{"version":3,"file":"fx2.js","sources":["../../src/components/fx2/index.ts"],"sourcesContent":["/**\n * The 6.x effect packs, one entry each (`motionary/components/fx-gpu`, …) so\n * their size budgets stay separate. This module (`registerFx2()`) registers\n * them all — used by dist/widgets.umd.js and the showcase.\n */\nimport type { EffectDefinition } from '../fx/registry';\nexport { EFFECT_PACK_FORMAT, packManifest, validateManifest, loadEffectPack } from './manifest';\nexport type { EffectPackManifest } from './manifest';\nimport { GPU_FX, registerGpuPack } from './gpu';\nimport { TEXT3_FX, registerTextPack, splitChars } from './text3';\nimport { LIGHT_FX, registerLightPack, trackPointer } from './light';\nimport { DEPTH3_FX, register3dPack } from './depth3';\nimport { MORPH2_FX, registerMorphPack, samplePath, pointsToPath } from './morph2';\nimport { TRANSITIONS2_FX, registerTransitionsPack, pageTransition, crossDocumentTransitions } from './transitions2';\nimport { WEATHER_FX, registerWeatherPack, skyAt } from './weather';\nimport { PHYSICS2_FX, registerPhysicsPack, VerletWorld } from './physics2';\nimport { FOCUS_FX, registerFocusPack } from './focus';\nimport { MUSIC_FX, registerMusicPack, syntheticSample, musicSample } from './music';\n\nexport { GPU_FX, registerGpuPack, TEXT3_FX, registerTextPack, splitChars };\nexport { shaderBackground, supportsWebGL2, fieldFallback, GLSL_HEAD } from './gl';\nexport { supportsWebGPU, glslToWgsl, wgslModule, webgpuBackground, WGSL_HEAD } from './webgpu';\nexport type { ShaderSpec } from './gl';\n\nexport { LIGHT_FX, registerLightPack, trackPointer };\n\nexport { DEPTH3_FX, register3dPack };\n\nexport { MORPH2_FX, registerMorphPack, samplePath, pointsToPath };\n\nexport { TRANSITIONS2_FX, registerTransitionsPack, pageTransition, crossDocumentTransitions };\n\nexport { WEATHER_FX, registerWeatherPack, skyAt };\n\nexport { PHYSICS2_FX, registerPhysicsPack, VerletWorld };\n\nexport { FOCUS_FX, registerFocusPack };\n\nexport { MUSIC_FX, registerMusicPack, syntheticSample, musicSample };\n\n/** The 6.x effect packs by name. */\nexport const EFFECT_PACKS: Record<string, EffectDefinition[]> = {\n  gpu: GPU_FX,\n  text: TEXT3_FX,\n  light: LIGHT_FX,\n  depth: DEPTH3_FX,\n  morph: MORPH2_FX,\n  transitions: TRANSITIONS2_FX,\n  weather: WEATHER_FX,\n  physics: PHYSICS2_FX,\n  focus: FOCUS_FX,\n  music: MUSIC_FX,\n};\n\n/** Register every 6.x effect pack (idempotent). */\nexport function registerEffectPacks(): void {\n  registerGpuPack();\n  registerTextPack();\n  registerLightPack();\n  register3dPack();\n  registerMorphPack();\n  registerTransitionsPack();\n  registerWeatherPack();\n  registerPhysicsPack();\n  registerFocusPack();\n  registerMusicPack();\n}\n\n\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAwCA;AACO,MAAM,YAAY,GAAuC;AAC9D,IAAA,GAAG,EAAE,MAAM;AACX,IAAA,IAAI,EAAE,QAAQ;AACd,IAAA,KAAK,EAAE,QAAQ;AACf,IAAA,KAAK,EAAE,SAAS;AAChB,IAAA,KAAK,EAAE,SAAS;AAChB,IAAA,WAAW,EAAE,eAAe;AAC5B,IAAA,OAAO,EAAE,UAAU;AACnB,IAAA,OAAO,EAAE,WAAW;AACpB,IAAA,KAAK,EAAE,QAAQ;AACf,IAAA,KAAK,EAAE,QAAQ;;AAGjB;SACgB,mBAAmB,GAAA;AACjC,IAAA,eAAe,EAAE;AACjB,IAAA,gBAAgB,EAAE;AAClB,IAAA,iBAAiB,EAAE;AACnB,IAAA,cAAc,EAAE;AAChB,IAAA,iBAAiB,EAAE;AACnB,IAAA,uBAAuB,EAAE;AACzB,IAAA,mBAAmB,EAAE;AACrB,IAAA,mBAAmB,EAAE;AACrB,IAAA,iBAAiB,EAAE;AACnB,IAAA,iBAAiB,EAAE;AACrB;;;;"}

package/dist/components/gesture.js

@@ -1,7 +1,7 @@
-import { y as defineElement, k as clamp } from '../chunks/base-D5MHqeDd.js';
-import { c as createSpring } from '../chunks/spring-B-9MZOrW.js';
-import { g as gesture } from '../chunks/core-ZGo4hOEk.js';
-export { p as pinchScale, s as swipeDirection } from '../chunks/core-ZGo4hOEk.js';
+import { u as defineElement, k as clamp } from '../chunks/base-2-yYc93C.js';
+import { c as createSpring } from '../chunks/spring-BK8DiezC.js';
+import { g as gesture } from '../chunks/core-DuO-AVXL.js';
+export { p as pinchScale, s as swipeDirection } from '../chunks/core-DuO-AVXL.js';
 
 var css = "usa-swipeable{display:block;touch-action:pan-y;user-select:none;-webkit-user-select:none}usa-swipeable[axis=\"y\"]{touch-action:pan-x}usa-swipeable>*{transform:translate3d(var(--usa-swipe,0px),0,0);opacity:calc(1 - var(--usa-swipe-p,0) * 0.5)}usa-swipeable[axis=\"y\"]>*{transform:translate3d(0,var(--usa-swipe,0px),0)}usa-swipeable:focus-visible{outline:2px solid currentColor;outline-offset:2px}usa-pinch-zoom{display:block;overflow:hidden;touch-action:none;position:relative}usa-pinch-zoom>*{transform:translate3d(var(--usa-zoom-x,0px),var(--usa-zoom-y,0px),0) scale(var(--usa-zoom,1));transform-origin:50% 50%}usa-pinch-zoom[data-zoomed]{cursor:grab}usa-pinch-zoom:focus-visible{outline:2px solid currentColor;outline-offset:2px}";