react-native-webrtc-kaleidoscope 2.2.1 → 2.3.0

package/README.md

@@ -245,6 +245,36 @@ Like the picker, the editor is controlled and presentational: it emits patches a
 
 Live per-layer tuning runs on web today; on native the editor renders but the live per-layer uniform channel is in progress. Mask and transform are live on every platform.
 
+### Persistence (the selection that survives a reload)
+
+`react-native-webrtc-kaleidoscope/persistence` ships a provider + hook that keep the person's selection across launches: the last applied preset id, the per-layer uniform patches they dialed in through the control panels (kept per preset, so tweaks to several presets all survive), and the mask edge.
+
+```tsx
+// App root:
+import { KaleidoscopeStateProvider } from 'react-native-webrtc-kaleidoscope/persistence';
+import { presets } from './kaleidoscope.preset-book';
+
+<KaleidoscopeStateProvider presets={presets}>
+  <App />
+</KaleidoscopeStateProvider>;
+
+// In the screen that binds the track:
+import { useKaleidoscopeState } from 'react-native-webrtc-kaleidoscope/persistence';
+
+const { hydrated, presetId, mask, setPreset, setMask, setPatch, patchesFor, reset } =
+  useKaleidoscopeState<typeof presets>();
+
+useEffect(() => {
+  if (!hydrated || !controls) return; // wait: don't flash the default over the restored preset
+  if (presetId) controls.kaleidoscope(presetId, patchesFor(presetId));
+  else controls.kaleidoscope(null);
+}, [hydrated, controls, presetId]);
+```
+
+Route the picker's `onSelect` into `setPreset`, the editor's `onPatch` into `setPatch(presetId, patch)` (and apply the live patch as usual), and the mask panel into `setMask`; every write persists. Pass the editor `patches={patches[presetId]}` so restored tweaks appear in the sliders, and mount it after `hydrated` (the forms seed at mount). A stored preset that no longer exists in your book reads as "none" instead of crashing the picker.
+
+The default store is [`@react-native-async-storage/async-storage`](https://github.com/react-native-async-storage/async-storage) (an optional peer; install it alongside the library when you use this subpath; on web it is localStorage-backed). To back it with something else (MMKV, a server), pass any `{ load, save }` pair as the `store` prop; the stored shape is versioned and parses tolerantly, so a malformed payload reads as empty rather than throwing.
+
 ## Worlds
 
 Packaged composites: a multi-layer stack (a generative shader or a cut-out image, the masked person on top), imported and spread into your book (e.g. `import { wizardTower } from 'react-native-webrtc-kaleidoscope/composites/wizard-tower'`). They carry their own `taxonomy: ['Worlds', <group>]`, so the menu groups them under the Worlds tab.

package/android/src/main/java/com/simiancraft/kaleidoscope/gpu/ShadersGenerated.kt

@@ -174,7 +174,9 @@ in highp vec2 vUv;
 out vec4 oColor;
 
 // STEPS must stay a compile-time constant (GLSL ES loop bound).
-#define STEPS 48
+// 32 (was 48; issue #37): the distance-growing step in main() keeps the
+// marched range, so fewer steps buys speed instead of clipping the horizon.
+#define STEPS 32
 
 float hash(vec3 p) {
     p = fract(p * 0.3183099 + 0.1);
@@ -202,10 +204,13 @@ float noise(vec3 p) {
         f.z);
 }
 
+// 4 octaves (was 5; issue #37): the 5th octave is fine wisp detail the
+// smoothstep(uCoverage, uCoverage + uSoftness, n) threshold mostly eats; each
+// octave is 8 hash() calls per sample, so this is a flat -20% on the march.
 float fbm(vec3 p) {
     float v = 0.0;
     float a = 0.5;
-    for (int i = 0; i < 5; i++) {
+    for (int i = 0; i < 4; i++) {
         v += a * noise(p);
         p *= 2.03;
         a *= 0.5;
@@ -241,14 +246,21 @@ void main() {
         if (rd.y > 0.0 && p.y >= 3.0) break;
         if (rd.y < 0.0 && p.y <= 0.0) break;
         float d = cloudDensity(p);
+        // Distance-growing step (issue #37): far clouds are small on screen and
+        // tolerate coarser sampling, so the step stretches with t. 32 growing
+        // steps reach slightly past where 48 uniform steps did, spending the
+        // samples up close where banding would show. growth also scales the
+        // per-sample opacity so optical depth per unit distance stays consistent
+        // with the uniform-step tuning the presets were dialed against.
+        float growth = 1.0 + t * 0.15;
         if (d > 0.01) {
             float light = smoothstep(0.4, 2.8, p.y);
             vec3 sampleColor = mix(uCloudDarkColor, uCloudLightColor, light);
-            float a = d * uDensity;
+            float a = min(d * uDensity * growth, 1.0);
             accum += (1.0 - alpha) * sampleColor * a;
             alpha += (1.0 - alpha) * a;
         }
-        t += uStepSize;
+        t += uStepSize * growth;
         if (alpha > 0.95) break;
     }
     vec3 color = mix(skyColor, accum, alpha);
@@ -278,7 +290,9 @@ const float MIN_DIVIDE = 64.0;
 const float MAX_DIVIDE = 0.01;
 // Number of stacked starfield layers. Compile-time constant so the layer
 // loop has a fixed integer bound (cross-compile-safe; no float loop counter).
-const int STARFIELD_LAYERS_COUNT = 12;
+// 8 (was 12) for low-end-mobile cost (issue #39); the work is linear in the
+// count and dimByDensity rebalances per-star brightness automatically.
+const int STARFIELD_LAYERS_COUNT = 8;
 
 mat2 Rotate(float angle) {
   float s = sin(angle);
@@ -288,20 +302,30 @@ mat2 Rotate(float angle) {
 
 float Star(vec2 uv, float flaresize, float rotAngle, float randomN) {
   float d = length(uv);
+  // The concentric fade at the bottom is exactly 0 for d >= 1.0; the star is
+  // invisible there, so skip everything (issue #39: a large share of the 3x3
+  // neighbor sweep lands outside this radius; the cull is output-identical).
+  if (d >= 1.0) return 0.0;
   // Star core. Guard the division: length(uv) can be exactly 0 at a cell
   // center, which yields inf/NaN under Metal. max(d, 1e-4) caps the core
   // brightness without visibly changing the look (the concentric
   // smoothstep fade below already clamps it).
   float starcore = 0.05 * uStarGlow / max(d, 1e-4);
-  uv *= Rotate(-2.0 * PI * rotAngle);
-  float flareMax = 1.0;
-
-  // flares
-  float starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
-  starcore += starflares * flaresize;
-  uv *= Rotate(PI * 0.25);
-  starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
-  starcore += starflares * 0.3 * flaresize;
+  // Flares exist only on the brightest stars: flaresize is exactly 0 below the
+  // smoothstep(0.9, 1.0, size) knee (~90% of cells), and both Rotates feed
+  // nothing but the flares. Skipping the block is output-identical, and
+  // flaresize is constant per cell, so the branch is coherent (issue #39).
+  if (flaresize > 0.0) {
+    uv *= Rotate(-2.0 * PI * rotAngle);
+    float flareMax = 1.0;
+
+    // flares
+    float starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
+    starcore += starflares * flaresize;
+    uv *= Rotate(PI * 0.25);
+    starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
+    starcore += starflares * 0.3 * flaresize;
+  }
   // light can't go forever, fade it concentrically.
   starcore *= smoothstep(1.0, 0.05, d);
   return starcore;
@@ -548,20 +572,30 @@ mat2 Rotate(float angle) {
 
 float Star(vec2 uv, float flaresize, float rotAngle, float randomN) {
   float d = length(uv);
+  // The concentric fade at the bottom is exactly 0 for d >= 1.0; the star is
+  // invisible there, so skip everything (issue #39: a large share of the 3x3
+  // neighbor sweep lands outside this radius; the cull is output-identical).
+  if (d >= 1.0) return 0.0;
   // Star core. Guard the division: length(uv) can be exactly 0 at a cell
   // center, which yields inf/NaN under Metal. max(d, 1e-4) caps the core
   // brightness without visibly changing the look (the concentric
   // smoothstep fade below already clamps it).
   float starcore = 0.09 * uStarGlow / max(d, 1e-4);
-  uv *= Rotate(-2.0 * PI * rotAngle);
-  float flareMax = 1.0;
-
-  // flares
-  float starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
-  starcore += starflares * flaresize;
-  uv *= Rotate(PI * 0.25);
-  starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
-  starcore += starflares * 0.3 * flaresize;
+  // Flares exist only on the brightest stars: flaresize is exactly 0 below the
+  // smoothstep(0.9, 1.0, size) knee (~90% of cells), and both Rotates feed
+  // nothing but the flares. Skipping the block is output-identical, and
+  // flaresize is constant per cell, so the branch is coherent (issue #39).
+  if (flaresize > 0.0) {
+    uv *= Rotate(-2.0 * PI * rotAngle);
+    float flareMax = 1.0;
+
+    // flares
+    float starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
+    starcore += starflares * flaresize;
+    uv *= Rotate(PI * 0.25);
+    starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
+    starcore += starflares * 0.3 * flaresize;
+  }
   // light can't go forever, fade it concentrically.
   starcore *= smoothstep(1.0, 0.05, d);
   return starcore;

package/catalog/shaders/clouds/clouds.frag

@@ -6,9 +6,12 @@
 // compile-time constant (GLSL ES loop bound).
 //
 // Slab-bounded march (issue #37): the clouds live in 0 < p.y < 3 (the height
-// mask is 0 outside it), so cloudDensity() returns 0 before the 5-octave fbm()
+// mask is 0 outside it), so cloudDensity() returns 0 before the 4-octave fbm()
 // when p.y leaves the slab, and the march breaks once the ray exits it. Both
-// skip only zero-contribution samples; output is unchanged.
+// skip only zero-contribution samples; output is unchanged. The march itself
+// uses a distance-growing step (see main) so 32 steps cover the old 48-step
+// range; the growth factor also weights per-sample opacity to keep optical
+// depth per unit distance consistent.
 //
 // UV convention: matches passthrough.vert. vUv = (0, 0) bottom-left, (1, 1)
 // top-right; fragCoord is reconstructed as vUv * uResolution. Fully procedural
@@ -44,7 +47,9 @@ in highp vec2 vUv;
 out vec4 oColor;
 
 // STEPS must stay a compile-time constant (GLSL ES loop bound).
-#define STEPS 48
+// 32 (was 48; issue #37): the distance-growing step in main() keeps the
+// marched range, so fewer steps buys speed instead of clipping the horizon.
+#define STEPS 32
 
 float hash(vec3 p) {
     p = fract(p * 0.3183099 + 0.1);
@@ -72,10 +77,13 @@ float noise(vec3 p) {
         f.z);
 }
 
+// 4 octaves (was 5; issue #37): the 5th octave is fine wisp detail the
+// smoothstep(uCoverage, uCoverage + uSoftness, n) threshold mostly eats; each
+// octave is 8 hash() calls per sample, so this is a flat -20% on the march.
 float fbm(vec3 p) {
     float v = 0.0;
     float a = 0.5;
-    for (int i = 0; i < 5; i++) {
+    for (int i = 0; i < 4; i++) {
         v += a * noise(p);
         p *= 2.03;
         a *= 0.5;
@@ -111,14 +119,21 @@ void main() {
         if (rd.y > 0.0 && p.y >= 3.0) break;
         if (rd.y < 0.0 && p.y <= 0.0) break;
         float d = cloudDensity(p);
+        // Distance-growing step (issue #37): far clouds are small on screen and
+        // tolerate coarser sampling, so the step stretches with t. 32 growing
+        // steps reach slightly past where 48 uniform steps did, spending the
+        // samples up close where banding would show. growth also scales the
+        // per-sample opacity so optical depth per unit distance stays consistent
+        // with the uniform-step tuning the presets were dialed against.
+        float growth = 1.0 + t * 0.15;
         if (d > 0.01) {
             float light = smoothstep(0.4, 2.8, p.y);
             vec3 sampleColor = mix(uCloudDarkColor, uCloudLightColor, light);
-            float a = d * uDensity;
+            float a = min(d * uDensity * growth, 1.0);
             accum += (1.0 - alpha) * sampleColor * a;
             alpha += (1.0 - alpha) * a;
         }
-        t += uStepSize;
+        t += uStepSize * growth;
         if (alpha > 0.95) break;
     }
     vec3 color = mix(skyColor, accum, alpha);

package/catalog/shaders/nebula/nebula.frag

@@ -40,7 +40,9 @@ const float MIN_DIVIDE = 64.0;
 const float MAX_DIVIDE = 0.01;
 // Number of stacked starfield layers. Compile-time constant so the layer
 // loop has a fixed integer bound (cross-compile-safe; no float loop counter).
-const int STARFIELD_LAYERS_COUNT = 12;
+// 8 (was 12) for low-end-mobile cost (issue #39); the work is linear in the
+// count and dimByDensity rebalances per-star brightness automatically.
+const int STARFIELD_LAYERS_COUNT = 8;
 
 mat2 Rotate(float angle) {
   float s = sin(angle);
@@ -50,20 +52,30 @@ mat2 Rotate(float angle) {
 
 float Star(vec2 uv, float flaresize, float rotAngle, float randomN) {
   float d = length(uv);
+  // The concentric fade at the bottom is exactly 0 for d >= 1.0; the star is
+  // invisible there, so skip everything (issue #39: a large share of the 3x3
+  // neighbor sweep lands outside this radius; the cull is output-identical).
+  if (d >= 1.0) return 0.0;
   // Star core. Guard the division: length(uv) can be exactly 0 at a cell
   // center, which yields inf/NaN under Metal. max(d, 1e-4) caps the core
   // brightness without visibly changing the look (the concentric
   // smoothstep fade below already clamps it).
   float starcore = 0.05 * uStarGlow / max(d, 1e-4);
-  uv *= Rotate(-2.0 * PI * rotAngle);
-  float flareMax = 1.0;
-
-  // flares
-  float starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
-  starcore += starflares * flaresize;
-  uv *= Rotate(PI * 0.25);
-  starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
-  starcore += starflares * 0.3 * flaresize;
+  // Flares exist only on the brightest stars: flaresize is exactly 0 below the
+  // smoothstep(0.9, 1.0, size) knee (~90% of cells), and both Rotates feed
+  // nothing but the flares. Skipping the block is output-identical, and
+  // flaresize is constant per cell, so the branch is coherent (issue #39).
+  if (flaresize > 0.0) {
+    uv *= Rotate(-2.0 * PI * rotAngle);
+    float flareMax = 1.0;
+
+    // flares
+    float starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
+    starcore += starflares * flaresize;
+    uv *= Rotate(PI * 0.25);
+    starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
+    starcore += starflares * 0.3 * flaresize;
+  }
   // light can't go forever, fade it concentrically.
   starcore *= smoothstep(1.0, 0.05, d);
   return starcore;

package/catalog/shaders/simianlights/simianlights.frag

@@ -50,20 +50,30 @@ mat2 Rotate(float angle) {
 
 float Star(vec2 uv, float flaresize, float rotAngle, float randomN) {
   float d = length(uv);
+  // The concentric fade at the bottom is exactly 0 for d >= 1.0; the star is
+  // invisible there, so skip everything (issue #39: a large share of the 3x3
+  // neighbor sweep lands outside this radius; the cull is output-identical).
+  if (d >= 1.0) return 0.0;
   // Star core. Guard the division: length(uv) can be exactly 0 at a cell
   // center, which yields inf/NaN under Metal. max(d, 1e-4) caps the core
   // brightness without visibly changing the look (the concentric
   // smoothstep fade below already clamps it).
   float starcore = 0.09 * uStarGlow / max(d, 1e-4);
-  uv *= Rotate(-2.0 * PI * rotAngle);
-  float flareMax = 1.0;
-
-  // flares
-  float starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
-  starcore += starflares * flaresize;
-  uv *= Rotate(PI * 0.25);
-  starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
-  starcore += starflares * 0.3 * flaresize;
+  // Flares exist only on the brightest stars: flaresize is exactly 0 below the
+  // smoothstep(0.9, 1.0, size) knee (~90% of cells), and both Rotates feed
+  // nothing but the flares. Skipping the block is output-identical, and
+  // flaresize is constant per cell, so the branch is coherent (issue #39).
+  if (flaresize > 0.0) {
+    uv *= Rotate(-2.0 * PI * rotAngle);
+    float flareMax = 1.0;
+
+    // flares
+    float starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
+    starcore += starflares * flaresize;
+    uv *= Rotate(PI * 0.25);
+    starflares = max(0.0, flareMax - abs(uv.x * uv.y * 3000.0));
+    starcore += starflares * 0.3 * flaresize;
+  }
   // light can't go forever, fade it concentrically.
   starcore *= smoothstep(1.0, 0.05, d);
   return starcore;

package/dist/src/components/preset-control-panel/preset-control-panel.d.ts

@@ -6,7 +6,15 @@ export type PresetControlPanelProps<P extends KaleidoscopePresetBook> = {
     readonly value: (keyof P & string) | null;
     /** Routed to the host, which applies it via `kaleidoscope(value, [patch])`. */
     readonly onPatch: KaleidoscopeControls['onPatch'];
+    /**
+     * Per-layer uniform overrides (e.g. a persisted selection's stored patches)
+     * merged over the preset's baked uniforms when the forms seed. Seed-time
+     * only: the forms re-seed on a preset switch, not when this prop changes
+     * mid-mount, so hosts restoring persisted patches should mount the panel
+     * after hydration.
+     */
+    readonly patches?: KaleidoscopeControls['uniforms'];
     readonly disabled?: boolean;
 };
-export declare function PresetControlPanel<P extends KaleidoscopePresetBook>({ presets, value, onPatch, disabled, }: PresetControlPanelProps<P>): ReactElement | null;
+export declare function PresetControlPanel<P extends KaleidoscopePresetBook>({ presets, value, onPatch, patches, disabled, }: PresetControlPanelProps<P>): ReactElement | null;
 //# sourceMappingURL=preset-control-panel.d.ts.map

package/dist/src/components/preset-control-panel/preset-control-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preset-control-panel.d.ts","sourceRoot":"","sources":["../../../../src/components/preset-control-panel/preset-control-panel.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAG9C,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,sBAAsB,IAAI;IACtE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1C,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,sBAAsB,EAAE,EACnE,OAAO,EACP,KAAK,EACL,OAAO,EACP,QAAgB,GACjB,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,CAoBlD"}
+{"version":3,"file":"preset-control-panel.d.ts","sourceRoot":"","sources":["../../../../src/components/preset-control-panel/preset-control-panel.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAG9C,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,sBAAsB,IAAI;IACtE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1C,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,sBAAsB,EAAE,EACnE,OAAO,EACP,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAgB,GACjB,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,CAwBlD"}

package/dist/src/components/preset-control-panel/preset-control-panel.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PresetControlPanel = PresetControlPanel;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const scope_1 = require("../form/scope");
-function PresetControlPanel({ presets, value, onPatch, disabled = false, }) {
+function PresetControlPanel({ presets, value, onPatch, patches, disabled = false, }) {
     if (value === null)
         return null;
     const preset = presets[value];
@@ -11,11 +11,15 @@ function PresetControlPanel({ presets, value, onPatch, disabled = false, }) {
     if (!Controls)
         return null;
     // Per-layer baked uniforms keyed by id, for the controls component to seed each
-    // layer's ControlForm. Only tunable layers carry uniforms.
+    // layer's ControlForm. Only tunable layers carry uniforms; stored overrides
+    // merge over the baked values so restored tweaks appear in the forms.
     const uniforms = {};
     for (const layer of preset.layers) {
         if ('uniforms' in layer) {
-            uniforms[layer.id] = { ...layer.uniforms };
+            uniforms[layer.id] = {
+                ...layer.uniforms,
+                ...patches?.[layer.id],
+            };
         }
     }
     return ((0, jsx_runtime_1.jsx)(scope_1.ControlScopeContext.Provider, { value: value, children: (0, jsx_runtime_1.jsx)(Controls, { uniforms: uniforms, onPatch: onPatch, disabled: disabled }, value) }));

package/dist/src/components/preset-control-panel/preset-control-panel.js.map

@@ -1 +1 @@
-{"version":3,"file":"preset-control-panel.js","sourceRoot":"","sources":["../../../../src/components/preset-control-panel/preset-control-panel.tsx"],"names":[],"mappings":";;;;AAWA,yCAAoD;AAWpD,4BAAqE,EACnE,OAAO,EACP,KAAK,EACL,OAAO,EACP,QAAQ,GAAG,KAAK,GACW;IAC3B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC;IAClC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,gFAAgF;IAChF,2DAA2D;IAC3D,MAAM,QAAQ,GAA+D,EAAE,CAAC;IAChF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAgD,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,OAAO,CACL,uBAAC,2BAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACxC,uBAAC,QAAQ,IAAa,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAA/D,KAAK,CAA8D,GACrD,CAChC,CAAC;AACJ,CAAC","sourcesContent":["// PresetControlPanel: the thin, controlled editor. For the active preset it\n// renders that preset's `controls` component (keyed by preset id, so a switch\n// remounts and the ControlForms re-seed), handing it the per-layer baked\n// uniforms and a single shared onPatch. It never calls `kaleidoscope` itself;\n// the host routes onPatch into `kaleidoscope(activeId, [patch])`.\n\nimport type { ReactElement } from 'react';\nimport type {\n  KaleidoscopeControls,\n  KaleidoscopePresetBook,\n} from '../../kaleidoscope.preset-book.types';\nimport { ControlScopeContext } from '../form/scope';\n\nexport type PresetControlPanelProps<P extends KaleidoscopePresetBook> = {\n  readonly presets: P;\n  /** The active preset id, or null when nothing is selected. */\n  readonly value: (keyof P & string) | null;\n  /** Routed to the host, which applies it via `kaleidoscope(value, [patch])`. */\n  readonly onPatch: KaleidoscopeControls['onPatch'];\n  readonly disabled?: boolean;\n};\n\nexport function PresetControlPanel<P extends KaleidoscopePresetBook>({\n  presets,\n  value,\n  onPatch,\n  disabled = false,\n}: PresetControlPanelProps<P>): ReactElement | null {\n  if (value === null) return null;\n  const preset = presets[value];\n  const Controls = preset?.controls;\n  if (!Controls) return null;\n\n  // Per-layer baked uniforms keyed by id, for the controls component to seed each\n  // layer's ControlForm. Only tunable layers carry uniforms.\n  const uniforms: Record<string, Record<string, number | readonly number[]>> = {};\n  for (const layer of preset.layers) {\n    if ('uniforms' in layer) {\n      uniforms[layer.id] = { ...layer.uniforms } as Record<string, number | readonly number[]>;\n    }\n  }\n\n  return (\n    <ControlScopeContext.Provider value={value}>\n      <Controls key={value} uniforms={uniforms} onPatch={onPatch} disabled={disabled} />\n    </ControlScopeContext.Provider>\n  );\n}\n"]}
+{"version":3,"file":"preset-control-panel.js","sourceRoot":"","sources":["../../../../src/components/preset-control-panel/preset-control-panel.tsx"],"names":[],"mappings":";;;;AAWA,yCAAoD;AAmBpD,4BAAqE,EACnE,OAAO,EACP,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAQ,GAAG,KAAK,GACW;IAC3B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC;IAClC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,gFAAgF;IAChF,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,QAAQ,GAA+D,EAAE,CAAC;IAChF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG;gBACnB,GAAG,KAAK,CAAC,QAAQ;gBACjB,GAAG,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACuB,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,CACL,uBAAC,2BAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACxC,uBAAC,QAAQ,IAAa,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAA/D,KAAK,CAA8D,GACrD,CAChC,CAAC;AACJ,CAAC","sourcesContent":["// PresetControlPanel: the thin, controlled editor. For the active preset it\n// renders that preset's `controls` component (keyed by preset id, so a switch\n// remounts and the ControlForms re-seed), handing it the per-layer baked\n// uniforms and a single shared onPatch. It never calls `kaleidoscope` itself;\n// the host routes onPatch into `kaleidoscope(activeId, [patch])`.\n\nimport type { ReactElement } from 'react';\nimport type {\n  KaleidoscopeControls,\n  KaleidoscopePresetBook,\n} from '../../kaleidoscope.preset-book.types';\nimport { ControlScopeContext } from '../form/scope';\n\nexport type PresetControlPanelProps<P extends KaleidoscopePresetBook> = {\n  readonly presets: P;\n  /** The active preset id, or null when nothing is selected. */\n  readonly value: (keyof P & string) | null;\n  /** Routed to the host, which applies it via `kaleidoscope(value, [patch])`. */\n  readonly onPatch: KaleidoscopeControls['onPatch'];\n  /**\n   * Per-layer uniform overrides (e.g. a persisted selection's stored patches)\n   * merged over the preset's baked uniforms when the forms seed. Seed-time\n   * only: the forms re-seed on a preset switch, not when this prop changes\n   * mid-mount, so hosts restoring persisted patches should mount the panel\n   * after hydration.\n   */\n  readonly patches?: KaleidoscopeControls['uniforms'];\n  readonly disabled?: boolean;\n};\n\nexport function PresetControlPanel<P extends KaleidoscopePresetBook>({\n  presets,\n  value,\n  onPatch,\n  patches,\n  disabled = false,\n}: PresetControlPanelProps<P>): ReactElement | null {\n  if (value === null) return null;\n  const preset = presets[value];\n  const Controls = preset?.controls;\n  if (!Controls) return null;\n\n  // Per-layer baked uniforms keyed by id, for the controls component to seed each\n  // layer's ControlForm. Only tunable layers carry uniforms; stored overrides\n  // merge over the baked values so restored tweaks appear in the forms.\n  const uniforms: Record<string, Record<string, number | readonly number[]>> = {};\n  for (const layer of preset.layers) {\n    if ('uniforms' in layer) {\n      uniforms[layer.id] = {\n        ...layer.uniforms,\n        ...patches?.[layer.id],\n      } as Record<string, number | readonly number[]>;\n    }\n  }\n\n  return (\n    <ControlScopeContext.Provider value={value}>\n      <Controls key={value} uniforms={uniforms} onPatch={onPatch} disabled={disabled} />\n    </ControlScopeContext.Provider>\n  );\n}\n"]}

package/dist/src/kaleidoscope/controls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../../src/kaleidoscope/controls.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAsB,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAEhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAkB,MAAM,SAAS,CAAC;AAE5F,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,gBAAgB,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,KAC3D,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAiB5C,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,sBAAsB,aAClD,gBAAgB,wBACL,uBAAuB,CAAC,CAAC,CAAC,aACrC,SAAS,WACX,OAAO,oBACE,gBAAgB,sBACd,kBAAkB,KACrC,mBAAmB,CAAC,CAAC,CA0DvB,CAAC"}
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../../src/kaleidoscope/controls.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAsB,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAEhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAkB,MAAM,SAAS,CAAC;AAE5F,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,gBAAgB,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,KAC3D,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAiB5C,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,sBAAsB,aAClD,gBAAgB,wBACL,uBAAuB,CAAC,CAAC,CAAC,aACrC,SAAS,WACX,OAAO,oBACE,gBAAgB,sBACd,kBAAkB,KACrC,mBAAmB,CAAC,CAAC,CA6DvB,CAAC"}

package/dist/src/kaleidoscope/controls.js

@@ -65,10 +65,13 @@ const createControls = (baseTrack, { presets, onTrack }, reconcile, setMask, set
             // Switch the preset (or clear): rebuild. Drop every live override first so
             // a reused layer id (e.g. 'blur', shared by the low/medium/high blur
             // presets) takes the new preset's baked uniforms instead of carrying a
-            // stale slider override across. A transform rebuild does NOT pass through
-            // here, so slider tweaks survive flips/rotations of the active preset.
+            // stale slider override across. Patches given WITH the switch (e.g. a
+            // persisted selection's overrides) merge into the rebuilt stack itself,
+            // so they land on every platform, native included. A transform rebuild
+            // does NOT pass through here, so slider tweaks survive flips/rotations
+            // of the active preset.
             activeId = cmd;
-            art = cmd == null ? null : (0, shader_to_spec_1.compositeToEffectSpec)(presets[cmd]);
+            art = cmd == null ? null : (0, shader_to_spec_1.compositeToEffectSpec)(presets[cmd], patches);
             resetLayerUniforms();
             apply();
         },

package/dist/src/kaleidoscope/controls.js.map

@@ -1 +1 @@
-{"version":3,"file":"controls.js","sourceRoot":"","sources":["../../../src/kaleidoscope/controls.ts"],"names":[],"mappings":"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","sourcesContent":["// The three-verb controls: shared composite-state machine, platform-agnostic.\n//\n// Holds the art effect (one composite) and the transform op list, reconciles\n// them into an ordered EffectSpec array (art FIRST so segmentation sees the\n// upright frame, transform LAST so it reorients the finished composite), and\n// applies them through an injected platform `reconcile`. Web rebuilds the\n// pipeline and yields a new track (disposing the prior one); native mutates in\n// place. `mask` writes the segmentation edge through an injected `setMask`; the\n// running composite reads it per frame, so it needs no rebuild.\n//\n// The art verb is rebuild-aware: switching to a different preset rebuilds, but\n// patching the currently-active preset routes through an injected live\n// layer-uniform channel (`setLayerUniforms`, keyed by layer id) so a slider drag\n// updates the running composite without a rebuild.\n\nimport type { KaleidoscopePreset, KaleidoscopePresetBook } from '../kaleidoscope.preset-book.types';\nimport type { EffectSpec, TransformName } from './effect.types';\nimport { compositeToEffectSpec } from './shader-to-spec';\nimport type { KaleidoscopeBinding, KaleidoscopeBindOptions, TransformInput } from './types';\n\n/** Apply the ordered specs to the base track and return the output. */\nexport type Reconcile = {\n  apply: (specs: ReadonlyArray<EffectSpec>) => MediaStreamTrack;\n  dispose: () => void;\n};\n\n/** Write the segmentation mask edge (platform tuning channel). */\nexport type SetMask = (hardness: number, threshold: number) => void;\n\n/**\n * Write a live per-layer uniform override (platform tuning channel), keyed by\n * layer id. The running composite merges these over the layer's baked uniforms\n * each frame, with no rebuild. Mirrors `setMask`.\n */\nexport type SetLayerUniforms = (\n  id: string,\n  uniforms: Readonly<Record<string, number | readonly number[]>>,\n) => void;\n\n/**\n * Drop every live per-layer override (platform tuning channel). A preset switch\n * calls this so a reused layer id reverts to the new preset's baked uniforms\n * rather than inheriting a stale override from the prior preset.\n */\nexport type ResetLayerUniforms = () => void;\n\n// Decompose an absolute transform into the discrete ops the pipeline already\n// runs (reused on web and native). Flips first, then rotation; rotation snaps to\n// the nearest 90°. 180° is two CW steps; 270° is one CCW step.\nconst decomposeTransform = (t?: TransformInput): EffectSpec[] => {\n  if (!t) return [];\n  const names: TransformName[] = [];\n  if (t.flip?.x) names.push('flip-x');\n  if (t.flip?.y) names.push('flip-y');\n  const deg = (((Math.round((t.rotate ?? 0) / 90) * 90) % 360) + 360) % 360;\n  if (deg === 90) names.push('rotate-cw');\n  else if (deg === 180) names.push('rotate-cw', 'rotate-cw');\n  else if (deg === 270) names.push('rotate-ccw');\n  return names.map((name) => ({ name }));\n};\n\nexport const createControls = <P extends KaleidoscopePresetBook>(\n  baseTrack: MediaStreamTrack,\n  { presets, onTrack }: KaleidoscopeBindOptions<P>,\n  reconcile: Reconcile,\n  setMask: SetMask,\n  setLayerUniforms: SetLayerUniforms,\n  resetLayerUniforms: ResetLayerUniforms,\n): KaleidoscopeBinding<P> => {\n  let art: EffectSpec | null = null;\n  let transformOps: EffectSpec[] = [];\n  let current = baseTrack;\n  // The id of the active preset (null when cleared). A patch of THIS id routes\n  // through the live channel; any other cmd rebuilds.\n  let activeId: keyof P | null = null;\n\n  const apply = (): void => {\n    const specs: EffectSpec[] = [];\n    if (art) specs.push(art);\n    specs.push(...transformOps);\n    current = reconcile.apply(specs);\n    onTrack?.(current);\n  };\n\n  return {\n    kaleidoscope: (\n      cmd: keyof P | null,\n      patches?: ReadonlyArray<{\n        readonly id: string;\n        readonly uniforms: Readonly<Record<string, number | readonly number[]>>;\n      }>,\n    ) => {\n      // Patch the currently-active preset: route through the live no-rebuild\n      // channel, keyed by layer id. The `shader` field on a patch is only for\n      // narrowing; the channel resolves by `id`.\n      if (cmd != null && cmd === activeId && patches && patches.length > 0) {\n        for (const patch of patches) {\n          setLayerUniforms(patch.id, patch.uniforms);\n        }\n        return;\n      }\n      // Switch the preset (or clear): rebuild. Drop every live override first so\n      // a reused layer id (e.g. 'blur', shared by the low/medium/high blur\n      // presets) takes the new preset's baked uniforms instead of carrying a\n      // stale slider override across. A transform rebuild does NOT pass through\n      // here, so slider tweaks survive flips/rotations of the active preset.\n      activeId = cmd;\n      art = cmd == null ? null : compositeToEffectSpec(presets[cmd] as KaleidoscopePreset);\n      resetLayerUniforms();\n      apply();\n    },\n    transform: (t) => {\n      transformOps = decomposeTransform(t);\n      apply();\n    },\n    mask: (m) => {\n      // Updates the edge the per-frame composite reads; no pipeline rebuild.\n      setMask(m.hardness, m.threshold);\n    },\n    get track() {\n      return current;\n    },\n    dispose: () => {\n      reconcile.dispose();\n    },\n  };\n};\n"]}
+{"version":3,"file":"controls.js","sourceRoot":"","sources":["../../../src/kaleidoscope/controls.ts"],"names":[],"mappings":"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","sourcesContent":["// The three-verb controls: shared composite-state machine, platform-agnostic.\n//\n// Holds the art effect (one composite) and the transform op list, reconciles\n// them into an ordered EffectSpec array (art FIRST so segmentation sees the\n// upright frame, transform LAST so it reorients the finished composite), and\n// applies them through an injected platform `reconcile`. Web rebuilds the\n// pipeline and yields a new track (disposing the prior one); native mutates in\n// place. `mask` writes the segmentation edge through an injected `setMask`; the\n// running composite reads it per frame, so it needs no rebuild.\n//\n// The art verb is rebuild-aware: switching to a different preset rebuilds, but\n// patching the currently-active preset routes through an injected live\n// layer-uniform channel (`setLayerUniforms`, keyed by layer id) so a slider drag\n// updates the running composite without a rebuild.\n\nimport type { KaleidoscopePreset, KaleidoscopePresetBook } from '../kaleidoscope.preset-book.types';\nimport type { EffectSpec, TransformName } from './effect.types';\nimport { compositeToEffectSpec } from './shader-to-spec';\nimport type { KaleidoscopeBinding, KaleidoscopeBindOptions, TransformInput } from './types';\n\n/** Apply the ordered specs to the base track and return the output. */\nexport type Reconcile = {\n  apply: (specs: ReadonlyArray<EffectSpec>) => MediaStreamTrack;\n  dispose: () => void;\n};\n\n/** Write the segmentation mask edge (platform tuning channel). */\nexport type SetMask = (hardness: number, threshold: number) => void;\n\n/**\n * Write a live per-layer uniform override (platform tuning channel), keyed by\n * layer id. The running composite merges these over the layer's baked uniforms\n * each frame, with no rebuild. Mirrors `setMask`.\n */\nexport type SetLayerUniforms = (\n  id: string,\n  uniforms: Readonly<Record<string, number | readonly number[]>>,\n) => void;\n\n/**\n * Drop every live per-layer override (platform tuning channel). A preset switch\n * calls this so a reused layer id reverts to the new preset's baked uniforms\n * rather than inheriting a stale override from the prior preset.\n */\nexport type ResetLayerUniforms = () => void;\n\n// Decompose an absolute transform into the discrete ops the pipeline already\n// runs (reused on web and native). Flips first, then rotation; rotation snaps to\n// the nearest 90°. 180° is two CW steps; 270° is one CCW step.\nconst decomposeTransform = (t?: TransformInput): EffectSpec[] => {\n  if (!t) return [];\n  const names: TransformName[] = [];\n  if (t.flip?.x) names.push('flip-x');\n  if (t.flip?.y) names.push('flip-y');\n  const deg = (((Math.round((t.rotate ?? 0) / 90) * 90) % 360) + 360) % 360;\n  if (deg === 90) names.push('rotate-cw');\n  else if (deg === 180) names.push('rotate-cw', 'rotate-cw');\n  else if (deg === 270) names.push('rotate-ccw');\n  return names.map((name) => ({ name }));\n};\n\nexport const createControls = <P extends KaleidoscopePresetBook>(\n  baseTrack: MediaStreamTrack,\n  { presets, onTrack }: KaleidoscopeBindOptions<P>,\n  reconcile: Reconcile,\n  setMask: SetMask,\n  setLayerUniforms: SetLayerUniforms,\n  resetLayerUniforms: ResetLayerUniforms,\n): KaleidoscopeBinding<P> => {\n  let art: EffectSpec | null = null;\n  let transformOps: EffectSpec[] = [];\n  let current = baseTrack;\n  // The id of the active preset (null when cleared). A patch of THIS id routes\n  // through the live channel; any other cmd rebuilds.\n  let activeId: keyof P | null = null;\n\n  const apply = (): void => {\n    const specs: EffectSpec[] = [];\n    if (art) specs.push(art);\n    specs.push(...transformOps);\n    current = reconcile.apply(specs);\n    onTrack?.(current);\n  };\n\n  return {\n    kaleidoscope: (\n      cmd: keyof P | null,\n      patches?: ReadonlyArray<{\n        readonly id: string;\n        readonly uniforms: Readonly<Record<string, number | readonly number[]>>;\n      }>,\n    ) => {\n      // Patch the currently-active preset: route through the live no-rebuild\n      // channel, keyed by layer id. The `shader` field on a patch is only for\n      // narrowing; the channel resolves by `id`.\n      if (cmd != null && cmd === activeId && patches && patches.length > 0) {\n        for (const patch of patches) {\n          setLayerUniforms(patch.id, patch.uniforms);\n        }\n        return;\n      }\n      // Switch the preset (or clear): rebuild. Drop every live override first so\n      // a reused layer id (e.g. 'blur', shared by the low/medium/high blur\n      // presets) takes the new preset's baked uniforms instead of carrying a\n      // stale slider override across. Patches given WITH the switch (e.g. a\n      // persisted selection's overrides) merge into the rebuilt stack itself,\n      // so they land on every platform, native included. A transform rebuild\n      // does NOT pass through here, so slider tweaks survive flips/rotations\n      // of the active preset.\n      activeId = cmd;\n      art = cmd == null ? null : compositeToEffectSpec(presets[cmd] as KaleidoscopePreset, patches);\n      resetLayerUniforms();\n      apply();\n    },\n    transform: (t) => {\n      transformOps = decomposeTransform(t);\n      apply();\n    },\n    mask: (m) => {\n      // Updates the edge the per-frame composite reads; no pipeline rebuild.\n      setMask(m.hardness, m.threshold);\n    },\n    get track() {\n      return current;\n    },\n    dispose: () => {\n      reconcile.dispose();\n    },\n  };\n};\n"]}

package/dist/src/kaleidoscope/shader-to-spec.d.ts

@@ -1,4 +1,18 @@
 import type { KaleidoscopePreset } from '../kaleidoscope.preset-book.types';
 import type { EffectSpec } from './effect.types';
-export declare const compositeToEffectSpec: (composite: KaleidoscopePreset) => EffectSpec;
+/** The patch wire shape (layer id + partial uniforms), as the verb receives it. */
+type LayerPatchInput = {
+    readonly id: string;
+    readonly uniforms: Readonly<Record<string, number | readonly number[]>>;
+};
+/**
+ * Project a composite into the spec, optionally merging per-layer uniform
+ * patches over the baked values (a switch-with-patches, e.g. restoring a
+ * persisted selection). Merging here, at the seam, is what carries the patches
+ * to EVERY platform: web rebuilds from these layers, and native re-sends them
+ * over setCompositeLayers. A patch addressing a non-tunable or unknown layer id
+ * is ignored.
+ */
+export declare const compositeToEffectSpec: (composite: KaleidoscopePreset, patches?: ReadonlyArray<LayerPatchInput>) => EffectSpec;
+export {};
 //# sourceMappingURL=shader-to-spec.d.ts.map

package/dist/src/kaleidoscope/shader-to-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader-to-spec.d.ts","sourceRoot":"","sources":["../../../src/kaleidoscope/shader-to-spec.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,eAAO,MAAM,qBAAqB,cAAe,kBAAkB,KAAG,UAGpE,CAAC"}
+{"version":3,"file":"shader-to-spec.d.ts","sourceRoot":"","sources":["../../../src/kaleidoscope/shader-to-spec.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,mFAAmF;AACnF,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CACzE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,cACrB,kBAAkB,YACnB,aAAa,CAAC,eAAe,CAAC,KACvC,UAaF,CAAC"}

package/dist/src/kaleidoscope/shader-to-spec.js

@@ -9,9 +9,28 @@
 // blend. Transforms are not book entries; the transform verb handles them.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compositeToEffectSpec = void 0;
-const compositeToEffectSpec = (composite) => ({
-    name: 'composite',
-    layers: composite.layers,
-});
+/**
+ * Project a composite into the spec, optionally merging per-layer uniform
+ * patches over the baked values (a switch-with-patches, e.g. restoring a
+ * persisted selection). Merging here, at the seam, is what carries the patches
+ * to EVERY platform: web rebuilds from these layers, and native re-sends them
+ * over setCompositeLayers. A patch addressing a non-tunable or unknown layer id
+ * is ignored.
+ */
+const compositeToEffectSpec = (composite, patches) => {
+    if (!patches || patches.length === 0) {
+        return { name: 'composite', layers: composite.layers };
+    }
+    const byId = new Map(patches.map((patch) => [patch.id, patch.uniforms]));
+    return {
+        name: 'composite',
+        layers: composite.layers.map((layer) => {
+            const override = byId.get(layer.id);
+            if (!override || !('uniforms' in layer))
+                return layer;
+            return { ...layer, uniforms: { ...layer.uniforms, ...override } };
+        }),
+    };
+};
 exports.compositeToEffectSpec = compositeToEffectSpec;
 //# sourceMappingURL=shader-to-spec.js.map

package/dist/src/kaleidoscope/shader-to-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"shader-to-spec.js","sourceRoot":"","sources":["../../../src/kaleidoscope/shader-to-spec.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,iFAAiF;AACjF,8EAA8E;AAC9E,wCAAwC;AACxC,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,2EAA2E;;;AAKpE,MAAM,qBAAqB,GAAG,CAAC,SAA6B,EAAc,EAAE,CAAC,CAAC;IACnF,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,SAAS,CAAC,MAAM;CACzB,CAAC,CAAC;AAHU,QAAA,qBAAqB,GAArB,qBAAqB,CAG/B","sourcesContent":["// Translate a book composite into the lower-level EffectSpec the primitive\n// `applyVideoEffects` consumes. This is the seam between the book vocabulary the\n// consumer sees and the effect the pipeline runs; the controls own the active\n// composite and reconcile through here.\n//\n// Every book entry is a composite (an ordered layer stack), so this is a thin\n// projection: the layers already carry their own ids, sources, uniforms, and\n// blend. Transforms are not book entries; the transform verb handles them.\n\nimport type { KaleidoscopePreset } from '../kaleidoscope.preset-book.types';\nimport type { EffectSpec } from './effect.types';\n\nexport const compositeToEffectSpec = (composite: KaleidoscopePreset): EffectSpec => ({\n  name: 'composite',\n  layers: composite.layers,\n});\n"]}
+{"version":3,"file":"shader-to-spec.js","sourceRoot":"","sources":["../../../src/kaleidoscope/shader-to-spec.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,iFAAiF;AACjF,8EAA8E;AAC9E,wCAAwC;AACxC,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,2EAA2E;;;AAW3E;;;;;;;GAOG;AACI,MAAM,qBAAqB,GAAG,CACnC,SAA6B,EAC7B,OAAwC,EAC5B,EAAE;IACd,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtD,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAuB,CAAC;QACzF,CAAC,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAhBW,QAAA,qBAAqB,GAArB,qBAAqB,CAgBhC","sourcesContent":["// Translate a book composite into the lower-level EffectSpec the primitive\n// `applyVideoEffects` consumes. This is the seam between the book vocabulary the\n// consumer sees and the effect the pipeline runs; the controls own the active\n// composite and reconcile through here.\n//\n// Every book entry is a composite (an ordered layer stack), so this is a thin\n// projection: the layers already carry their own ids, sources, uniforms, and\n// blend. Transforms are not book entries; the transform verb handles them.\n\nimport type { KaleidoscopeLayer, KaleidoscopePreset } from '../kaleidoscope.preset-book.types';\nimport type { EffectSpec } from './effect.types';\n\n/** The patch wire shape (layer id + partial uniforms), as the verb receives it. */\ntype LayerPatchInput = {\n  readonly id: string;\n  readonly uniforms: Readonly<Record<string, number | readonly number[]>>;\n};\n\n/**\n * Project a composite into the spec, optionally merging per-layer uniform\n * patches over the baked values (a switch-with-patches, e.g. restoring a\n * persisted selection). Merging here, at the seam, is what carries the patches\n * to EVERY platform: web rebuilds from these layers, and native re-sends them\n * over setCompositeLayers. A patch addressing a non-tunable or unknown layer id\n * is ignored.\n */\nexport const compositeToEffectSpec = (\n  composite: KaleidoscopePreset,\n  patches?: ReadonlyArray<LayerPatchInput>,\n): EffectSpec => {\n  if (!patches || patches.length === 0) {\n    return { name: 'composite', layers: composite.layers };\n  }\n  const byId = new Map(patches.map((patch) => [patch.id, patch.uniforms]));\n  return {\n    name: 'composite',\n    layers: composite.layers.map((layer) => {\n      const override = byId.get(layer.id);\n      if (!override || !('uniforms' in layer)) return layer;\n      return { ...layer, uniforms: { ...layer.uniforms, ...override } } as KaleidoscopeLayer;\n    }),\n  };\n};\n"]}

package/dist/src/kaleidoscope/types.d.ts

@@ -58,7 +58,9 @@ export type KaleidoscopeBindOptions<P extends KaleidoscopePresetBook> = {
  * The art verb: select a composite by id (rebuilding the pipeline), or clear it
  * with `null`. When `cmd` is the currently-active preset id and `patches` is
  * given, the patches merge through the live no-rebuild uniform channel (keyed by
- * layer id) instead of rebuilding, so a slider drag stays smooth.
+ * layer id) instead of rebuilding, so a slider drag stays smooth. On a preset
+ * SWITCH, patches merge into the rebuilt layer stack itself, so a restored
+ * selection lands tuned on every platform, native included.
  */
 type KaleidoscopeCommand<P extends KaleidoscopePresetBook> = <K extends keyof P>(cmd: K | null, patches?: PatchesFor<P, K>) => void;
 /**

package/dist/src/kaleidoscope/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/kaleidoscope/types.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,mBAAmB,CAAC;CACtD,GACG;IAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,GACpE,KAAK,CAAC;AAEV;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,sBAAsB,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,aAAa,CACzF,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CACjC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/D,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG;IACtB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,sBAAsB,IAAI;IACtE,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF;;;;;GAKG;AACH,KAAK,mBAAmB,CAAC,CAAC,SAAS,sBAAsB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAC7E,GAAG,EAAE,CAAC,GAAG,IAAI,EACb,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KACvB,IAAI,CAAC;AAEV;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,sBAAsB;IACnE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/kaleidoscope/types.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,mBAAmB,CAAC;CACtD,GACG;IAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,GACpE,KAAK,CAAC;AAEV;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,sBAAsB,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,aAAa,CACzF,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CACjC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/D,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG;IACtB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,sBAAsB,IAAI;IACtE,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF;;;;;;;GAOG;AACH,KAAK,mBAAmB,CAAC,CAAC,SAAS,sBAAsB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAC7E,GAAG,EAAE,CAAC,GAAG,IAAI,EACb,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KACvB,IAAI,CAAC;AAEV;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,sBAAsB;IACnE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B"}

package/dist/src/kaleidoscope/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/kaleidoscope/types.ts"],"names":[],"mappings":";AAAA,iCAAiC;AACjC,EAAE;AACF,mEAAmE;AACnE,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,kDAAkD;AAClD,kFAAkF;AAClF,kFAAkF;AAClF,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,+EAA+E;AAC/E,8EAA8E","sourcesContent":["// The three-verb surface: types.\n//\n// Bind a track and a preset book once; get three typed verbs back:\n//   - kaleidoscope(cmd, patches?)  the art axis: which composite (layer stack)\n//     fills the frame. cmd is a preset id from the book (narrowed), or null to\n//     clear. patches optionally merge per-layer uniform overrides (addressed by\n//     layer id); patching the currently-active preset routes through the live\n//     no-rebuild channel, so sliders stay smooth.\n//   - transform(t?)             the geometry axis: absolute flips + 90° rotation.\n//   - mask(m)                   the segmentation edge shared by every art effect.\n//\n// Shaders live in the library; consumers add presets (composites) over them,\n// never new shaders. Per shader-world convention, numeric uniforms are\n// normalized 0..1 where practical; ranges are documented in JSDoc as hints for\n// IntelliSense and tooling, not enforced at runtime (validation is userland).\n\nimport type { PatchableShaderName, ShaderUniformsMap } from '../../catalog/shaders';\nimport type { KaleidoscopePresetBook } from '../kaleidoscope.preset-book.types';\n\n/**\n * A live per-layer uniform override for ONE layer, derived from the layer's own\n * type: `id` is the layer's id, `uniforms` is `Partial` of the shader's uniform\n * type (re-indexed from `ShaderUniformsMap` by the layer's literal `shader`).\n * Non-tunable layers (`image`, `direct`) distribute to `never`, so they cannot be\n * patched. The runtime resolves by `id`; the shader is never sent on the wire.\n */\nexport type PatchFor<L> = L extends {\n  readonly id: infer I extends string;\n  readonly shader: infer S extends PatchableShaderName;\n}\n  ? { readonly id: I; readonly uniforms: Partial<ShaderUniformsMap[S]> }\n  : never;\n\n/**\n * The patches `kaleidoscope` accepts for preset `K` in book `P`: per-layer\n * overrides, each addressed by one of that preset's tunable layer ids and typed\n * by that layer's shader. At a literal `cmd` call site this narrows to the\n * preset's ids/uniforms; with a variable `cmd` it widens to the book-wide union\n * and is runtime-checked by id.\n */\nexport type PatchesFor<P extends KaleidoscopePresetBook, K extends keyof P> = ReadonlyArray<\n  PatchFor<P[K]['layers'][number]>\n>;\n\n/**\n * Absolute, stateless geometric transform. Every call is the full desired state\n * from the identity orientation: re-passing is the caller's responsibility, and\n * `transform()` (or `transform({})`) resets to identity. Rotation snaps to the\n * nearest 90°; arbitrary angles and offset are a later step.\n */\nexport type TransformInput = {\n  /** Mirror flips about each axis. */\n  readonly flip?: { readonly x?: boolean; readonly y?: boolean };\n  /** Clockwise rotation in degrees; snapped to the nearest 90 (0/90/180/270). */\n  readonly rotate?: number;\n};\n\n/** The segmentation mask edge, shared by every art effect (not transforms). */\nexport type MaskInput = {\n  /** Edge hardness, 0..1. 0 = soft halo, 1 = near-step. */\n  readonly hardness: number;\n  /** Edge threshold, 0..1. Higher rejects low-confidence (chair-edge) pixels. */\n  readonly threshold: number;\n};\n\nexport type KaleidoscopeBindOptions<P extends KaleidoscopePresetBook> = {\n  /** The consumer's preset book. Declare it `as const satisfies KaleidoscopePresetBook`. */\n  readonly presets: P;\n  /**\n   * Called with the live output track after every art/transform command. On web\n   * each command yields a NEW MediaStreamTrack (the pipeline is rebuilt); on\n   * native the same track is mutated in place and passed back.\n   */\n  readonly onTrack?: (track: MediaStreamTrack) => void;\n};\n\n/**\n * The art verb: select a composite by id (rebuilding the pipeline), or clear it\n * with `null`. When `cmd` is the currently-active preset id and `patches` is\n * given, the patches merge through the live no-rebuild uniform channel (keyed by\n * layer id) instead of rebuilding, so a slider drag stays smooth.\n */\ntype KaleidoscopeCommand<P extends KaleidoscopePresetBook> = <K extends keyof P>(\n  cmd: K | null,\n  patches?: PatchesFor<P, K>,\n) => void;\n\n/**\n * The three verbs for one bound track and book, plus the live track and a\n * teardown. `kaleidoscope` (preset switch) and `transform` rebuild the composite\n * (web yields a new track via onTrack); a `kaleidoscope` patch of the active\n * preset and `mask` both update what the running composite reads each frame, so\n * they need no rebuild.\n */\nexport interface KaleidoscopeBinding<P extends KaleidoscopePresetBook> {\n  readonly kaleidoscope: KaleidoscopeCommand<P>;\n  readonly transform: (t?: TransformInput) => void;\n  readonly mask: (m: MaskInput) => void;\n  readonly track: MediaStreamTrack;\n  readonly dispose: () => void;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/kaleidoscope/types.ts"],"names":[],"mappings":";AAAA,iCAAiC;AACjC,EAAE;AACF,mEAAmE;AACnE,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,kDAAkD;AAClD,kFAAkF;AAClF,kFAAkF;AAClF,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,+EAA+E;AAC/E,8EAA8E","sourcesContent":["// The three-verb surface: types.\n//\n// Bind a track and a preset book once; get three typed verbs back:\n//   - kaleidoscope(cmd, patches?)  the art axis: which composite (layer stack)\n//     fills the frame. cmd is a preset id from the book (narrowed), or null to\n//     clear. patches optionally merge per-layer uniform overrides (addressed by\n//     layer id); patching the currently-active preset routes through the live\n//     no-rebuild channel, so sliders stay smooth.\n//   - transform(t?)             the geometry axis: absolute flips + 90° rotation.\n//   - mask(m)                   the segmentation edge shared by every art effect.\n//\n// Shaders live in the library; consumers add presets (composites) over them,\n// never new shaders. Per shader-world convention, numeric uniforms are\n// normalized 0..1 where practical; ranges are documented in JSDoc as hints for\n// IntelliSense and tooling, not enforced at runtime (validation is userland).\n\nimport type { PatchableShaderName, ShaderUniformsMap } from '../../catalog/shaders';\nimport type { KaleidoscopePresetBook } from '../kaleidoscope.preset-book.types';\n\n/**\n * A live per-layer uniform override for ONE layer, derived from the layer's own\n * type: `id` is the layer's id, `uniforms` is `Partial` of the shader's uniform\n * type (re-indexed from `ShaderUniformsMap` by the layer's literal `shader`).\n * Non-tunable layers (`image`, `direct`) distribute to `never`, so they cannot be\n * patched. The runtime resolves by `id`; the shader is never sent on the wire.\n */\nexport type PatchFor<L> = L extends {\n  readonly id: infer I extends string;\n  readonly shader: infer S extends PatchableShaderName;\n}\n  ? { readonly id: I; readonly uniforms: Partial<ShaderUniformsMap[S]> }\n  : never;\n\n/**\n * The patches `kaleidoscope` accepts for preset `K` in book `P`: per-layer\n * overrides, each addressed by one of that preset's tunable layer ids and typed\n * by that layer's shader. At a literal `cmd` call site this narrows to the\n * preset's ids/uniforms; with a variable `cmd` it widens to the book-wide union\n * and is runtime-checked by id.\n */\nexport type PatchesFor<P extends KaleidoscopePresetBook, K extends keyof P> = ReadonlyArray<\n  PatchFor<P[K]['layers'][number]>\n>;\n\n/**\n * Absolute, stateless geometric transform. Every call is the full desired state\n * from the identity orientation: re-passing is the caller's responsibility, and\n * `transform()` (or `transform({})`) resets to identity. Rotation snaps to the\n * nearest 90°; arbitrary angles and offset are a later step.\n */\nexport type TransformInput = {\n  /** Mirror flips about each axis. */\n  readonly flip?: { readonly x?: boolean; readonly y?: boolean };\n  /** Clockwise rotation in degrees; snapped to the nearest 90 (0/90/180/270). */\n  readonly rotate?: number;\n};\n\n/** The segmentation mask edge, shared by every art effect (not transforms). */\nexport type MaskInput = {\n  /** Edge hardness, 0..1. 0 = soft halo, 1 = near-step. */\n  readonly hardness: number;\n  /** Edge threshold, 0..1. Higher rejects low-confidence (chair-edge) pixels. */\n  readonly threshold: number;\n};\n\nexport type KaleidoscopeBindOptions<P extends KaleidoscopePresetBook> = {\n  /** The consumer's preset book. Declare it `as const satisfies KaleidoscopePresetBook`. */\n  readonly presets: P;\n  /**\n   * Called with the live output track after every art/transform command. On web\n   * each command yields a NEW MediaStreamTrack (the pipeline is rebuilt); on\n   * native the same track is mutated in place and passed back.\n   */\n  readonly onTrack?: (track: MediaStreamTrack) => void;\n};\n\n/**\n * The art verb: select a composite by id (rebuilding the pipeline), or clear it\n * with `null`. When `cmd` is the currently-active preset id and `patches` is\n * given, the patches merge through the live no-rebuild uniform channel (keyed by\n * layer id) instead of rebuilding, so a slider drag stays smooth. On a preset\n * SWITCH, patches merge into the rebuilt layer stack itself, so a restored\n * selection lands tuned on every platform, native included.\n */\ntype KaleidoscopeCommand<P extends KaleidoscopePresetBook> = <K extends keyof P>(\n  cmd: K | null,\n  patches?: PatchesFor<P, K>,\n) => void;\n\n/**\n * The three verbs for one bound track and book, plus the live track and a\n * teardown. `kaleidoscope` (preset switch) and `transform` rebuild the composite\n * (web yields a new track via onTrack); a `kaleidoscope` patch of the active\n * preset and `mask` both update what the running composite reads each frame, so\n * they need no rebuild.\n */\nexport interface KaleidoscopeBinding<P extends KaleidoscopePresetBook> {\n  readonly kaleidoscope: KaleidoscopeCommand<P>;\n  readonly transform: (t?: TransformInput) => void;\n  readonly mask: (m: MaskInput) => void;\n  readonly track: MediaStreamTrack;\n  readonly dispose: () => void;\n}\n"]}

package/dist/src/persistence/async-storage-store.d.ts

@@ -0,0 +1,3 @@
+import { type KaleidoscopeStateStore } from './state';
+export declare const kaleidoscopeAsyncStorageStore: KaleidoscopeStateStore;
+//# sourceMappingURL=async-storage-store.d.ts.map

package/dist/src/persistence/async-storage-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-storage-store.d.ts","sourceRoot":"","sources":["../../../src/persistence/async-storage-store.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,sBAAsB,EAI5B,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,6BAA6B,EAAE,sBAe3C,CAAC"}