react-native-webrtc-kaleidoscope 2.7.4 → 2.7.6

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. 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"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/kaleidoscope/types.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,EAAE;AACF,kEAAkE;AAClE,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,kDAAkD;AAClD,kFAAkF;AAClF,kFAAkF;AAClF,iFAAiF;AACjF,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,+EAA+E;AAC/E,8EAA8E","sourcesContent":["// The four-verb surface: types.\n//\n// Bind a track and a preset book once; get four 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//   - dispose()                 tear down the pipeline; release the bound track.\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 four 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/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/persistence/provider.tsx"],"names":[],"mappings":"AAoBA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,EAEL,KAAK,sBAAsB,EAI3B,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,sBAAsB,GAAG,sBAAsB,IAAI;IAC9F,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7C,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5E,wFAAwF;IACxF,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B,CAAC;AAIF,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,sBAAsB,IAAI;IAC7E,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,CAAC;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,CAAC;AAQF,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,sBAAsB,EAAE,EAC1E,OAAO,EACP,KAAK,EACL,WAA0B,EAC1B,QAAQ,GACT,EAAE,8BAA8B,CAAC,CAAC,CAAC,GAAG,YAAY,CA4DlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,SAAS,sBAAsB,GAAG,sBAAsB,KACtD,sBAAsB,CAAC,CAAC,CAAC,CAY7B"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/persistence/provider.tsx"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,EAEL,KAAK,sBAAsB,EAI3B,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,sBAAsB,GAAG,sBAAsB,IAAI;IAC9F,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7C,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5E,wFAAwF;IACxF,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B,CAAC;AAIF,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,sBAAsB,IAAI;IAC7E,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,CAAC;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,CAAC;AAQF,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,sBAAsB,EAAE,EAC1E,OAAO,EACP,KAAK,EACL,WAA0B,EAC1B,QAAQ,GACT,EAAE,8BAA8B,CAAC,CAAC,CAAC,GAAG,YAAY,CA4DlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,SAAS,sBAAsB,GAAG,sBAAsB,KACtD,sBAAsB,CAAC,CAAC,CAAC,CAY7B"}

package/dist/src/persistence/provider.js

@@ -11,9 +11,12 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 // verbs. The host applies the restored selection itself (gated on `hydrated`,
 // so a stored preset is not flashed over by the default):
 //
+//   // `controls` is the binding from bindKaleidoscope(track, { presets }).
 //   const { hydrated, presetId, patchesFor, mask, ... } = useKaleidoscopeState<typeof presets>();
 //   useEffect(() => {
 //     if (!hydrated || !controls) return;
+//     // patchesFor reads this render's patches; live edits go through onPatch,
+//     // not this re-apply, so it stays out of the deps.
 //     if (presetId) controls.kaleidoscope(presetId, patchesFor(presetId));
 //     else controls.kaleidoscope(null);
 //   }, [hydrated, controls, presetId]);

package/dist/src/persistence/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/persistence/provider.tsx"],"names":[],"mappings":"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","sourcesContent":["// Persistence: the React surface. `KaleidoscopeStateProvider` hydrates the\n// stored selection once at mount and writes through on every change;\n// `useKaleidoscopeState` hands the host the hydrated values plus the setters.\n//\n// The provider owns STORAGE state only; it never binds a track or calls the\n// verbs. The host applies the restored selection itself (gated on `hydrated`,\n// so a stored preset is not flashed over by the default):\n//\n//   const { hydrated, presetId, patchesFor, mask, ... } = useKaleidoscopeState<typeof presets>();\n//   useEffect(() => {\n//     if (!hydrated || !controls) return;\n//     if (presetId) controls.kaleidoscope(presetId, patchesFor(presetId));\n//     else controls.kaleidoscope(null);\n//   }, [hydrated, controls, presetId]);\n//\n// The backing store defaults to AsyncStorage; pass any `KaleidoscopeStateStore`\n// to swap it. Importing this subpath is what brings the optional\n// `@react-native-async-storage/async-storage` peer onto your bundle path\n// (Metro resolves it at bundle time either way, so there is no lazy escape).\n\nimport {\n  createContext,\n  type ReactElement,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\nimport type { MaskInput, PatchesFor } from '../kaleidoscope/types';\nimport type { KaleidoscopePresetBook } from '../kaleidoscope.preset-book.types';\nimport { kaleidoscopeAsyncStorageStore } from './async-storage-store';\nimport {\n  DEFAULT_MASK,\n  type KaleidoscopeStateStore,\n  mergePatch,\n  patchListFor,\n  pruneStoredState,\n  type StoredPatch,\n  type StoredPatches,\n} from './state';\n\nexport type KaleidoscopeStateValue<P extends KaleidoscopePresetBook = KaleidoscopePresetBook> = {\n  /** False until the persisted selection has been read; apply no effects before then. */\n  readonly hydrated: boolean;\n  /** The selected preset id, or null when nothing is selected. */\n  readonly presetId: (keyof P & string) | null;\n  /** The shared segmentation edge. */\n  readonly mask: MaskInput;\n  /** Every preset's stored per-layer overrides (keyed by preset id, then layer id). */\n  readonly patches: StoredPatches;\n  readonly setPreset: (presetId: (keyof P & string) | null) => void;\n  readonly setMask: (mask: MaskInput) => void;\n  /** Record one control-panel patch against a preset (and persist it). */\n  readonly setPatch: (presetId: keyof P & string, patch: StoredPatch) => void;\n  /** A preset's stored overrides in the array shape `kaleidoscope(id, patches)` takes. */\n  readonly patchesFor: <K extends keyof P & string>(presetId: K) => PatchesFor<P, K>;\n  /** Clear the stored selection back to defaults (and persist the cleared state). */\n  readonly reset: () => void;\n};\n\nconst KaleidoscopeStateContext = createContext<KaleidoscopeStateValue | null>(null);\n\nexport type KaleidoscopeStateProviderProps<P extends KaleidoscopePresetBook> = {\n  /** The consumer's preset book; stored state is pruned against it at hydrate. */\n  readonly presets: P;\n  /** The backing store. Defaults to the AsyncStorage store (lazily loaded). */\n  readonly store?: KaleidoscopeStateStore;\n  /** The mask used before hydration and after `reset`. Defaults to 0.5/0.5. */\n  readonly defaultMask?: MaskInput;\n  readonly children: ReactNode;\n};\n\ntype Selection = {\n  readonly presetId: string | null;\n  readonly mask: MaskInput;\n  readonly patches: StoredPatches;\n};\n\nexport function KaleidoscopeStateProvider<P extends KaleidoscopePresetBook>({\n  presets,\n  store,\n  defaultMask = DEFAULT_MASK,\n  children,\n}: KaleidoscopeStateProviderProps<P>): ReactElement {\n  const [hydrated, setHydrated] = useState(false);\n  const [selection, setSelection] = useState<Selection>({\n    presetId: null,\n    mask: defaultMask,\n    patches: {},\n  });\n  // A write before hydration wins over the stored value (the person acted; do\n  // not clobber their fresh choice with yesterday's).\n  const dirty = useRef(false);\n  // Pinned for the provider's lifetime: hydrate and every write-through go to\n  // the same store the first render saw.\n  const storeRef = useRef(store ?? kaleidoscopeAsyncStorageStore);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: hydrate exactly once; the book and store are bind-time constants.\n  useEffect(() => {\n    let cancelled = false;\n    storeRef.current.load().then(\n      (stored) => {\n        if (cancelled) return;\n        if (stored && !dirty.current) {\n          const pruned = pruneStoredState(stored, presets);\n          setSelection({ presetId: pruned.presetId, mask: pruned.mask, patches: pruned.patches });\n        }\n        setHydrated(true);\n      },\n      () => {\n        if (!cancelled) setHydrated(true);\n      },\n    );\n    return () => {\n      cancelled = true;\n    };\n  }, []);\n\n  const commit = (next: Selection): void => {\n    dirty.current = true;\n    setSelection(next);\n    void storeRef.current.save({ version: 1, ...next });\n  };\n\n  const value: KaleidoscopeStateValue = {\n    hydrated,\n    presetId: selection.presetId,\n    mask: selection.mask,\n    patches: selection.patches,\n    setPreset: (presetId) => commit({ ...selection, presetId }),\n    setMask: (mask) => commit({ ...selection, mask }),\n    setPatch: (presetId, patch) =>\n      commit({ ...selection, patches: mergePatch(selection.patches, presetId, patch) }),\n    // The stored wire shape is book-agnostic; the typed view is recovered at the\n    // hook (`useKaleidoscopeState<typeof presets>()`), so the cast is the seam.\n    patchesFor: ((presetId: string) =>\n      patchListFor(selection.patches, presetId)) as KaleidoscopeStateValue['patchesFor'],\n    reset: () => commit({ presetId: null, mask: defaultMask, patches: {} }),\n  };\n\n  return (\n    <KaleidoscopeStateContext.Provider value={value}>{children}</KaleidoscopeStateContext.Provider>\n  );\n}\n\n/**\n * The persisted selection plus its setters. Typed by the consumer's book:\n * `useKaleidoscopeState<typeof presets>()`. Throws outside the provider.\n */\nexport function useKaleidoscopeState<\n  P extends KaleidoscopePresetBook = KaleidoscopePresetBook,\n>(): KaleidoscopeStateValue<P> {\n  const value = useContext(KaleidoscopeStateContext);\n  if (value === null) {\n    throw new Error(\n      'useKaleidoscopeState: no <KaleidoscopeStateProvider> above this component. ' +\n        'Wrap your app (or the screen using the picker) in the provider from ' +\n        \"'react-native-webrtc-kaleidoscope/persistence'.\",\n    );\n  }\n  // Safe by construction: the provider pruned ids against the same book the\n  // consumer parameterizes with; the runtime shapes are identical.\n  return value as unknown as KaleidoscopeStateValue<P>;\n}\n"]}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/persistence/provider.tsx"],"names":[],"mappings":"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","sourcesContent":["// Persistence: the React surface. `KaleidoscopeStateProvider` hydrates the\n// stored selection once at mount and writes through on every change;\n// `useKaleidoscopeState` hands the host the hydrated values plus the setters.\n//\n// The provider owns STORAGE state only; it never binds a track or calls the\n// verbs. The host applies the restored selection itself (gated on `hydrated`,\n// so a stored preset is not flashed over by the default):\n//\n//   // `controls` is the binding from bindKaleidoscope(track, { presets }).\n//   const { hydrated, presetId, patchesFor, mask, ... } = useKaleidoscopeState<typeof presets>();\n//   useEffect(() => {\n//     if (!hydrated || !controls) return;\n//     // patchesFor reads this render's patches; live edits go through onPatch,\n//     // not this re-apply, so it stays out of the deps.\n//     if (presetId) controls.kaleidoscope(presetId, patchesFor(presetId));\n//     else controls.kaleidoscope(null);\n//   }, [hydrated, controls, presetId]);\n//\n// The backing store defaults to AsyncStorage; pass any `KaleidoscopeStateStore`\n// to swap it. Importing this subpath is what brings the optional\n// `@react-native-async-storage/async-storage` peer onto your bundle path\n// (Metro resolves it at bundle time either way, so there is no lazy escape).\n\nimport {\n  createContext,\n  type ReactElement,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\nimport type { MaskInput, PatchesFor } from '../kaleidoscope/types';\nimport type { KaleidoscopePresetBook } from '../kaleidoscope.preset-book.types';\nimport { kaleidoscopeAsyncStorageStore } from './async-storage-store';\nimport {\n  DEFAULT_MASK,\n  type KaleidoscopeStateStore,\n  mergePatch,\n  patchListFor,\n  pruneStoredState,\n  type StoredPatch,\n  type StoredPatches,\n} from './state';\n\nexport type KaleidoscopeStateValue<P extends KaleidoscopePresetBook = KaleidoscopePresetBook> = {\n  /** False until the persisted selection has been read; apply no effects before then. */\n  readonly hydrated: boolean;\n  /** The selected preset id, or null when nothing is selected. */\n  readonly presetId: (keyof P & string) | null;\n  /** The shared segmentation edge. */\n  readonly mask: MaskInput;\n  /** Every preset's stored per-layer overrides (keyed by preset id, then layer id). */\n  readonly patches: StoredPatches;\n  readonly setPreset: (presetId: (keyof P & string) | null) => void;\n  readonly setMask: (mask: MaskInput) => void;\n  /** Record one control-panel patch against a preset (and persist it). */\n  readonly setPatch: (presetId: keyof P & string, patch: StoredPatch) => void;\n  /** A preset's stored overrides in the array shape `kaleidoscope(id, patches)` takes. */\n  readonly patchesFor: <K extends keyof P & string>(presetId: K) => PatchesFor<P, K>;\n  /** Clear the stored selection back to defaults (and persist the cleared state). */\n  readonly reset: () => void;\n};\n\nconst KaleidoscopeStateContext = createContext<KaleidoscopeStateValue | null>(null);\n\nexport type KaleidoscopeStateProviderProps<P extends KaleidoscopePresetBook> = {\n  /** The consumer's preset book; stored state is pruned against it at hydrate. */\n  readonly presets: P;\n  /** The backing store. Defaults to the AsyncStorage store (lazily loaded). */\n  readonly store?: KaleidoscopeStateStore;\n  /** The mask used before hydration and after `reset`. Defaults to 0.5/0.5. */\n  readonly defaultMask?: MaskInput;\n  readonly children: ReactNode;\n};\n\ntype Selection = {\n  readonly presetId: string | null;\n  readonly mask: MaskInput;\n  readonly patches: StoredPatches;\n};\n\nexport function KaleidoscopeStateProvider<P extends KaleidoscopePresetBook>({\n  presets,\n  store,\n  defaultMask = DEFAULT_MASK,\n  children,\n}: KaleidoscopeStateProviderProps<P>): ReactElement {\n  const [hydrated, setHydrated] = useState(false);\n  const [selection, setSelection] = useState<Selection>({\n    presetId: null,\n    mask: defaultMask,\n    patches: {},\n  });\n  // A write before hydration wins over the stored value (the person acted; do\n  // not clobber their fresh choice with yesterday's).\n  const dirty = useRef(false);\n  // Pinned for the provider's lifetime: hydrate and every write-through go to\n  // the same store the first render saw.\n  const storeRef = useRef(store ?? kaleidoscopeAsyncStorageStore);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: hydrate exactly once; the book and store are bind-time constants.\n  useEffect(() => {\n    let cancelled = false;\n    storeRef.current.load().then(\n      (stored) => {\n        if (cancelled) return;\n        if (stored && !dirty.current) {\n          const pruned = pruneStoredState(stored, presets);\n          setSelection({ presetId: pruned.presetId, mask: pruned.mask, patches: pruned.patches });\n        }\n        setHydrated(true);\n      },\n      () => {\n        if (!cancelled) setHydrated(true);\n      },\n    );\n    return () => {\n      cancelled = true;\n    };\n  }, []);\n\n  const commit = (next: Selection): void => {\n    dirty.current = true;\n    setSelection(next);\n    void storeRef.current.save({ version: 1, ...next });\n  };\n\n  const value: KaleidoscopeStateValue = {\n    hydrated,\n    presetId: selection.presetId,\n    mask: selection.mask,\n    patches: selection.patches,\n    setPreset: (presetId) => commit({ ...selection, presetId }),\n    setMask: (mask) => commit({ ...selection, mask }),\n    setPatch: (presetId, patch) =>\n      commit({ ...selection, patches: mergePatch(selection.patches, presetId, patch) }),\n    // The stored wire shape is book-agnostic; the typed view is recovered at the\n    // hook (`useKaleidoscopeState<typeof presets>()`), so the cast is the seam.\n    patchesFor: ((presetId: string) =>\n      patchListFor(selection.patches, presetId)) as KaleidoscopeStateValue['patchesFor'],\n    reset: () => commit({ presetId: null, mask: defaultMask, patches: {} }),\n  };\n\n  return (\n    <KaleidoscopeStateContext.Provider value={value}>{children}</KaleidoscopeStateContext.Provider>\n  );\n}\n\n/**\n * The persisted selection plus its setters. Typed by the consumer's book:\n * `useKaleidoscopeState<typeof presets>()`. Throws outside the provider.\n */\nexport function useKaleidoscopeState<\n  P extends KaleidoscopePresetBook = KaleidoscopePresetBook,\n>(): KaleidoscopeStateValue<P> {\n  const value = useContext(KaleidoscopeStateContext);\n  if (value === null) {\n    throw new Error(\n      'useKaleidoscopeState: no <KaleidoscopeStateProvider> above this component. ' +\n        'Wrap your app (or the screen using the picker) in the provider from ' +\n        \"'react-native-webrtc-kaleidoscope/persistence'.\",\n    );\n  }\n  // Safe by construction: the provider pruned ids against the same book the\n  // consumer parameterizes with; the runtime shapes are identical.\n  return value as unknown as KaleidoscopeStateValue<P>;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-webrtc-kaleidoscope",
-  "version": "2.7.4",
+  "version": "2.7.6",
   "description": "Live video effects (blur, background replacement, generative backgrounds, flip/rotate) for react-native-webrtc, packaged as a managed-Expo-friendly Expo Module. Working on web, Android, and iOS. Active development.",
   "keywords": [
     "react-native",
@@ -538,15 +538,11 @@
     "./expo-module.config.json": "./expo-module.config.json",
     "./package.json": "./package.json"
   },
-  "bin": {
-    "kaleidoscope-thumbnails": "./tools/thumbnails/make-thumbnails.ts"
-  },
   "files": [
     "src",
     "catalog",
     "dist",
-    "tools",
-    "android/src",
+    "android/src/main",
     "android/build.gradle",
     "ios",
     "app.plugin.js",

package/src/index.ts

@@ -192,7 +192,7 @@ const specToNativeName = (spec: ReturnType<typeof toEffectSpec>): string => {
 const lastAppliedSignatureByTrack = new WeakMap<object, string>();
 
 // The lower-level native primitive: route a spec array through the upstream
-// `_setVideoEffects`. Internal now (the public surface is the three verbs);
+// `_setVideoEffects`. Internal now (the public surface is the four verbs);
 // `bindKaleidoscope`'s reconcile drives it.
 const applyVideoEffects: ApplyVideoEffects = (track, effects) => {
   const t = track as MediaStreamTrack & WebRTCTrackExtensions;
@@ -264,8 +264,8 @@ const applyVideoEffects: ApplyVideoEffects = (track, effects) => {
 };
 
 /**
- * Bind a track and a preset book; get the three verbs back
- * (`{ kaleidoscope, transform, mask }`). On native the track is mutated in
+ * Bind a track and a preset book; get the four verbs back
+ * (`{ kaleidoscope, transform, mask, dispose }`). On native the track is mutated in
  * place, so `controls.track` is the bound track and `onTrack` fires with it
  * after each `kaleidoscope` preset switch and `transform` command. `mask`
  * updates the segmentation edge the per-frame processors read.

package/src/index.web.ts

@@ -152,8 +152,8 @@ export const applyVideoEffectsDisposable = (
 };
 
 /**
- * Bind a track and a preset book; get the three verbs back
- * (`{ kaleidoscope, transform, mask }`). Presets live in the consumer's
+ * Bind a track and a preset book; get the four verbs back
+ * (`{ kaleidoscope, transform, mask, dispose }`). Presets live in the consumer's
  * project; these verbs drive them. On web each `kaleidoscope` preset switch and
  * each `transform` command rebuilds the Insertable-Streams pipeline and yields a
  * new output track, so read the live track from `onTrack` (or `controls.track`);

package/src/kaleidoscope/controls.ts

@@ -1,4 +1,4 @@
-// The three-verb controls: shared composite-state machine, platform-agnostic.
+// The four-verb controls: shared composite-state machine, platform-agnostic.
 //
 // Holds the art effect (one composite) and the transform op list, reconciles
 // them into an ordered EffectSpec array (art FIRST so segmentation sees the

package/src/kaleidoscope/types.ts

@@ -1,6 +1,6 @@
-// The three-verb surface: types.
+// The four-verb surface: types.
 //
-// Bind a track and a preset book once; get three typed verbs back:
+// Bind a track and a preset book once; get four typed verbs back:
 //   - kaleidoscope(cmd, patches?)  the art axis: which composite (layer stack)
 //     fills the frame. cmd is a preset id from the book (narrowed), or null to
 //     clear. patches optionally merge per-layer uniform overrides (addressed by
@@ -8,6 +8,7 @@
 //     no-rebuild channel, so sliders stay smooth.
 //   - transform(t?)             the geometry axis: absolute flips + 90° rotation.
 //   - mask(m)                   the segmentation edge shared by every art effect.
+//   - dispose()                 tear down the pipeline; release the bound track.
 //
 // Shaders live in the library; consumers add presets (composites) over them,
 // never new shaders. Per shader-world convention, numeric uniforms are
@@ -88,7 +89,7 @@ type KaleidoscopeCommand<P extends KaleidoscopePresetBook> = <K extends keyof P>
 ) => void;
 
 /**
- * The three verbs for one bound track and book, plus the live track and a
+ * The four verbs for one bound track and book, plus the live track and a
  * teardown. `kaleidoscope` (preset switch) and `transform` rebuild the composite
  * (web yields a new track via onTrack); a `kaleidoscope` patch of the active
  * preset and `mask` both update what the running composite reads each frame, so

package/src/persistence/provider.tsx

@@ -6,9 +6,12 @@
 // verbs. The host applies the restored selection itself (gated on `hydrated`,
 // so a stored preset is not flashed over by the default):
 //
+//   // `controls` is the binding from bindKaleidoscope(track, { presets }).
 //   const { hydrated, presetId, patchesFor, mask, ... } = useKaleidoscopeState<typeof presets>();
 //   useEffect(() => {
 //     if (!hydrated || !controls) return;
+//     // patchesFor reads this render's patches; live edits go through onPatch,
+//     // not this re-apply, so it stays out of the deps.
 //     if (presetId) controls.kaleidoscope(presetId, patchesFor(presetId));
 //     else controls.kaleidoscope(null);
 //   }, [hydrated, controls, presetId]);

package/android/src/test/java/com/simiancraft/kaleidoscope/CompositeLayersTest.kt

@@ -1,165 +0,0 @@
-package com.simiancraft.kaleidoscope
-
-import org.junit.Assert.assertArrayEquals
-import org.junit.Assert.assertEquals
-import org.junit.Assert.assertNull
-import org.junit.Assert.assertTrue
-import org.junit.Before
-import org.junit.Test
-
-/**
- * Unit tests for the composite layer-stack wire contract: the JSON that
- * serializeCompositeLayers (src/index.ts) sends across the bridge and that
- * CompositeLayers.set/get/clear parses into the snapshot the compositor reads each
- * frame. These pin the parse rules the iOS CompositeLayers.swift port must match;
- * the same cases are mirrored in the iOS XCTest suite, so a divergence in either
- * parser fails on one side.
- *
- * Runs as a JVM unit test (testDebugUnitTest): the real org.json is on the test
- * classpath and android.util.Log is a no-op stub (unitTests.returnDefaultValues).
- */
-class CompositeLayersTest {
-    // CompositeLayers is a process-global singleton; reset between cases so a prior
-    // set() can't leak into the next assertion.
-    @Before
-    fun reset() = CompositeLayers.clear()
-
-    // The wizard-tower composite exactly as serializeCompositeLayers emits it: a
-    // generative base (clouds, uniforms), the cut-out image (image, source = the
-    // stable image id), then you (direct, subject). The canonical happy path.
-    @Test
-    fun parsesWizardTowerStack() {
-        CompositeLayers.set(
-            """
-            [
-              {"id":"sky","shader":"clouds","target":"background","uniforms":{"uExposure":1.26,"uSkyLowColor":[0.99,0.62,0.03],"uCloudSpeed":0.92}},
-              {"id":"tower","shader":"image","target":"background","source":"wizards-tower"},
-              {"id":"you","shader":"direct","target":"subject"}
-            ]
-            """.trimIndent(),
-        )
-        val layers = CompositeLayers.get()
-        assertEquals(3, layers.size)
-
-        val clouds = layers[0]
-        assertEquals("sky", clouds.id)
-        assertEquals("clouds", clouds.shader)
-        assertEquals("background", clouds.target)
-        assertNull(clouds.blend)
-        assertNull(clouds.source)
-        assertArrayEquals(floatArrayOf(1.26f), clouds.uniforms["uExposure"], EPS)
-        assertArrayEquals(floatArrayOf(0.99f, 0.62f, 0.03f), clouds.uniforms["uSkyLowColor"], EPS)
-
-        val image = layers[1]
-        assertEquals("tower", image.id)
-        assertEquals("image", image.shader)
-        assertEquals("wizards-tower", image.source)
-        assertTrue(image.uniforms.isEmpty())
-
-        val you = layers[2]
-        assertEquals("you", you.id)
-        assertEquals("direct", you.shader)
-        assertEquals("subject", you.target)
-        assertNull(you.source)
-    }
-
-    // An overlay layer carries a blend mode; additive must round-trip, and the
-    // base layer (no blend key) must stay null (the compositor reads null = opaque).
-    @Test
-    fun parsesAdditiveBlendOverOpaqueBase() {
-        CompositeLayers.set(
-            """
-            [
-              {"id":"image","shader":"image","target":"background","source":"stylized-dark"},
-              {"id":"rays","shader":"godrays","target":"background","blend":"additive","uniforms":{"uRayCount":11}}
-            ]
-            """.trimIndent(),
-        )
-        val layers = CompositeLayers.get()
-        assertEquals(2, layers.size)
-        assertEquals("image", layers[0].id)
-        assertNull(layers[0].blend)
-        assertEquals("rays", layers[1].id)
-        assertEquals("additive", layers[1].blend)
-        assertArrayEquals(floatArrayOf(11f), layers[1].uniforms["uRayCount"], EPS)
-    }
-
-    // `id` is always on the wire now; a payload missing it falls back to the array
-    // index so the address stays stable and unique-per-stack rather than colliding.
-    @Test
-    fun fallsBackToIndexWhenIdMissing() {
-        CompositeLayers.set(
-            """[{"shader":"clouds","uniforms":{}},{"shader":"direct","target":"subject"}]""",
-        )
-        val layers = CompositeLayers.get()
-        assertEquals(2, layers.size)
-        assertEquals("0", layers[0].id)
-        assertEquals("1", layers[1].id)
-    }
-
-    // target defaults to "background" when the wire omits it.
-    @Test
-    fun defaultsMissingTargetToBackground() {
-        CompositeLayers.set("""[{"shader":"clouds","uniforms":{}}]""")
-        assertEquals("background", CompositeLayers.get()[0].target)
-    }
-
-    // A scalar uniform normalizes to a one-element array; a numeric array stays a
-    // vector, in order.
-    @Test
-    fun normalizesScalarAndVectorUniforms() {
-        CompositeLayers.set("""[{"shader":"plasma","uniforms":{"speed":0.3,"colorA":[0.0,0.3,0.6]}}]""")
-        val u = CompositeLayers.get()[0].uniforms
-        assertArrayEquals(floatArrayOf(0.3f), u["speed"], EPS)
-        assertArrayEquals(floatArrayOf(0.0f, 0.3f, 0.6f), u["colorA"], EPS)
-    }
-
-    // A uniform whose value is neither a number nor a numeric array is skipped;
-    // the shader keeps its GLSL default for that name. Well-formed siblings stay.
-    @Test
-    fun skipsNonNumericUniformKeepingSiblings() {
-        CompositeLayers.set("""[{"shader":"plasma","uniforms":{"speed":0.3,"bad":"nope"}}]""")
-        val u = CompositeLayers.get()[0].uniforms
-        assertArrayEquals(floatArrayOf(0.3f), u["speed"], EPS)
-        assertNull(u["bad"])
-    }
-
-    // A layer with no shader is skipped; well-formed siblings survive (the parse
-    // is per-layer lenient, not all-or-nothing).
-    @Test
-    fun skipsLayerWithoutShader() {
-        CompositeLayers.set("""[{"target":"background"},{"shader":"direct","target":"subject"}]""")
-        val layers = CompositeLayers.get()
-        assertEquals(1, layers.size)
-        assertEquals("direct", layers[0].shader)
-    }
-
-    @Test
-    fun parsesEmptyStack() {
-        CompositeLayers.set("[]")
-        assertTrue(CompositeLayers.get().isEmpty())
-    }
-
-    // A whole-payload parse failure (not a JSON array) leaves the previous composite
-    // in place rather than blanking the frame.
-    @Test
-    fun keepsPreviousCompositeOnMalformedPayload() {
-        CompositeLayers.set("""[{"shader":"direct","target":"subject"}]""")
-        CompositeLayers.set("not json at all")
-        val layers = CompositeLayers.get()
-        assertEquals(1, layers.size)
-        assertEquals("direct", layers[0].shader)
-    }
-
-    // clear() drops the active composite (a non-composite effect taking over).
-    @Test
-    fun clearEmptiesStack() {
-        CompositeLayers.set("""[{"shader":"direct","target":"subject"}]""")
-        CompositeLayers.clear()
-        assertTrue(CompositeLayers.get().isEmpty())
-    }
-
-    private companion object {
-        const val EPS = 1e-6f
-    }
-}

package/tools/thumbnails/book-loader.ts

@@ -1,104 +0,0 @@
-// Loads a preset book as DATA by executing it under Bun with three shims
-// (issue #65). The book is real TypeScript that imports React control
-// components, expo-asset, and bundled images; none of those matter to a
-// thumbnail, so each is replaced with the smallest stand-in that keeps the
-// module graph executable:
-//
-//   - `expo-asset`: `Asset.fromModule(m).uri` returns the module value itself,
-//     which (via the asset shim below) is the file's absolute path.
-//   - control components (`*.form.*`, `*.controls.*`): a Proxy that satisfies
-//     any named import without pulling React in; presets reference these as
-//     values but thumbnails never render them.
-//   - bundled images (`.webp` / `.png` / `.jpg`): the file's absolute path as
-//     the default export, so an image layer's `source` resolves to something
-//     the CLI can read and embed.
-//
-// Executing (vs static parsing, which the prebuild plugin does for asset
-// collection) is what yields exact per-preset layer stacks and uniform values
-// with no fragile object-literal parsing. This is Bun-only by design; the
-// thumbnail maker is an opt-in dev command, not runtime code.
-
-import path from 'node:path';
-import { plugin } from 'bun';
-
-/** One layer as authored in a book (the subset thumbnails care about). */
-type LoadedLayer = {
-  readonly id?: string;
-  readonly shader: string;
-  readonly target?: string;
-  readonly blend?: string;
-  readonly source?: string;
-  readonly uniforms?: Record<string, number | readonly number[]>;
-};
-
-/** One preset as authored in a book. */
-export type LoadedPreset = {
-  readonly name: string;
-  readonly taxonomy: readonly string[];
-  readonly thumbnail?: string | number;
-  readonly layers: readonly LoadedLayer[];
-};
-
-plugin({
-  name: 'kaleidoscope-thumbnails-book-shims',
-  setup(build) {
-    // Path-based onLoad (not onResolve, which Bun's runtime plugins do not
-    // reliably fire): any file inside the expo-asset package becomes the
-    // shim, so its entry never executes and never drags React Native's
-    // Flow-typed asset registry in.
-    build.onLoad({ filter: /node_modules\/expo-asset\/.*\.[cm]?js$/ }, () => ({
-      contents: [
-        'function unwrap(m) {',
-        '  if (typeof m === "string") return m;',
-        '  try { if (m && typeof m.default === "string") return m.default; } catch {}',
-        '  try { if (m && typeof m.uri === "string") return m.uri; } catch {}',
-        '  try { return String(m); } catch { return ""; }',
-        '}',
-        'export const Asset = { fromModule: (m) => ({ uri: unwrap(m) }) };',
-      ].join('\n'),
-      loader: 'js',
-    }));
-    // Control components are imported by NAME, and ESM named imports need the
-    // name to exist; the name is convention-derived from the filename
-    // (`clouds.controls.js` -> CloudsControls, `plasma.form.tsx` -> PlasmaForm),
-    // so the stub synthesizes exactly that export.
-    build.onLoad({ filter: /\.(form|controls)\.(tsx|jsx|ts|js)$/ }, (args) => {
-      const base = path.basename(args.path);
-      const stem = base.split('.')[0] ?? 'stub';
-      const kind = base.includes('.controls.') ? 'Controls' : 'Form';
-      const pascal = stem
-        .split('-')
-        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
-        .join('');
-      const name = `${pascal}${kind}`;
-      return {
-        contents: `export const ${name} = () => null;\nexport default ${name};`,
-        loader: 'js',
-      };
-    });
-    // Bun materializes plugin modules as ESM namespaces even when authored as
-    // CJS, so the path rides the default export; `import x from './x.webp'`
-    // unwraps it natively and the Asset shim's unwrap() handles the
-    // `require('./x.webp')` namespace form.
-    build.onLoad({ filter: /\.(webp|png|jpe?g|gif)$/ }, (args) => ({
-      contents: `export default ${JSON.stringify(args.path)};`,
-      loader: 'js',
-    }));
-  },
-});
-
-/**
- * Import the book and return its preset map. Accepts the conventional
- * `export const presets` (the demo's shape) or a default export.
- */
-export async function loadPresetBook(bookPath: string): Promise<Record<string, LoadedPreset>> {
-  const abs = path.resolve(bookPath);
-  const mod = (await import(abs)) as { presets?: unknown; default?: unknown };
-  const book = mod.presets ?? mod.default;
-  if (!book || typeof book !== 'object') {
-    throw new Error(
-      `${bookPath} did not export a preset book (expected \`export const presets = {...}\` or a default export).`,
-    );
-  }
-  return book as Record<string, LoadedPreset>;
-}