react-native-webrtc-kaleidoscope 2.0.0 → 2.1.0

package/ios/KaleidoscopeModule/effects/BlurProcessor.swift

@@ -1,238 +0,0 @@
-// iOS blur effect. Mirrors android/.../effects/BlurFactory.kt + Mask.kt.
-//
-// Per frame (all on the capture thread, except segmentation which runs async
-// on the Segmenter's worker queue):
-//   1. Ingest the camera CVPixelBuffer (NV12) into the "original" BGRA Metal
-//      texture via CoreImage (colorspace conversion only; see TextureBridge).
-//   2. Read the latest completed mask; if none yet, forward the ORIGINAL frame
-//      (exactly like Android returning -1). Kick a new segmentation if idle.
-//   3. Two separable Gaussian passes on "original" via blur.metal (horizontal
-//      then vertical) into ping-pong textures.
-//   4. Composite original (foreground) + blurred (background) + mask via
-//      composite.metal into a pooled BGRA output buffer. Blurred bg is the
-//      same dims as original, so bg + mask UV transforms are identity.
-//   5. Wrap the output buffer into an RTCVideoFrame with rotation ._0 (the
-//      pixels are display-upright from ingest) and the source timestamp.
-//
-// One instance is registered under "blur" and shared across every frame, so
-// all mutable state is guarded by an os_unfair_lock. Every failure path logs
-// under Kaleidoscope.Blur and returns the ORIGINAL frame; the processor must
-// never crash the capture pipeline (no debugger on EAS).
-
-import Foundation
-import CoreVideo
-import Metal
-import os.log
-import WebRTC
-// Import whichever react-native-webrtc fork is present; both expose the same
-// VideoFrameProcessorDelegate / ProcessorProvider symbols. See Registration.swift.
-#if canImport(livekit_react_native_webrtc)
-import livekit_react_native_webrtc
-#elseif canImport(react_native_webrtc)
-import react_native_webrtc
-#endif
-
-@objc(KaleidoscopeBlurProcessor)
-public final class BlurProcessor: NSObject, VideoFrameProcessorDelegate {
-  private static let log = OSLog(subsystem: "com.simiancraft.kaleidoscope", category: "Blur")
-
-  private var unsafeLock = os_unfair_lock_s()
-  // Lazily constructed on the first frame so a Metal/library failure degrades
-  // to passthrough rather than crashing at registration time.
-  private var renderer: MetalRenderer?
-  private var rendererFailed = false
-  private let segmenter = Segmenter()
-  private var kernel = BlurKernel()
-
-  public override init() {
-    super.init()
-  }
-
-  @objc(capturer:didCaptureVideoFrame:)
-  public func capturer(
-    _ capturer: RTCVideoCapturer,
-    didCapture frame: RTCVideoFrame
-  ) -> RTCVideoFrame {
-    os_unfair_lock_lock(&unsafeLock)
-    defer { os_unfair_lock_unlock(&unsafeLock) }
-    do {
-      return try process(frame)
-    } catch {
-      os_log("blur failed; forwarding original. %{public}@",
-             log: BlurProcessor.log, type: .error, error.localizedDescription)
-      return frame
-    }
-  }
-
-  private func ensureRenderer() throws -> MetalRenderer {
-    if let renderer = renderer { return renderer }
-    if rendererFailed { throw RendererError.noMetalDevice }
-    do {
-      let created = try MetalRenderer(bundle: Bundle(for: BlurProcessor.self))
-      renderer = created
-      return created
-    } catch {
-      rendererFailed = true
-      throw error
-    }
-  }
-
-  private func process(_ frame: RTCVideoFrame) throws -> RTCVideoFrame {
-    guard let input = FrameBridge.inputPixelBuffer(frame) else {
-      return frame
-    }
-    let bufferW = CVPixelBufferGetWidth(input)
-    let bufferH = CVPixelBufferGetHeight(input)
-    guard bufferW > 0, bufferH > 0 else { return frame }
-
-    let renderer = try ensureRenderer()
-
-    // Step 1: ingest NV12 -> DISPLAY-UPRIGHT "original" BGRA texture. The display
-    // rotation is folded into the CoreImage render here (Ingest.swift), so the
-    // original is canonical and every downstream pass runs in upright screen
-    // space. `width`/`height` below are the DISPLAY dims (buffer dims swapped on
-    // a 90/270 frame); the rest of the pipeline (blur, segmenter, output, the
-    // emitted rotation 0) is sized from them.
-    let rotation = frame.rotation.rawValue
-    let width = Ingest.displayWidth(bufferWidth: bufferW, bufferHeight: bufferH, rotation: rotation)
-    let height = Ingest.displayHeight(bufferWidth: bufferW, bufferHeight: bufferH, rotation: rotation)
-    let (originalBuffer, originalTexture, originalWrapper) = try renderer.originalIngestTarget(
-      width: width, height: height
-    )
-    try TextureBridge.ingest(input: input, into: originalBuffer, frameRotation: rotation)
-
-    // Step 2: read latest mask; kick a new segmentation off the original
-    // buffer (now display-upright space; the segmenter only needs a uniform
-    // scale relationship to the foreground, which still holds) if the worker is
-    // idle. No mask yet -> forward the original frame, matching Android's -1
-    // fall-through.
-    guard let maskBuffer = segmenter.latestMask() else {
-      segmenter.kickIfIdle(input: originalBuffer)
-      return frame
-    }
-    segmenter.kickIfIdle(input: originalBuffer)
-
-    let (maskTexture, maskWrapper) = try TextureBridge.makeTexture(
-      from: maskBuffer,
-      cache: renderer.textureCache,
-      pixelFormat: .r8Unorm,
-      planeIndex: 0
-    )
-
-    // Step 3: blur kernel from EffectTuning (rebuilt only on sigma change).
-    kernel.ensure(sigma: EffectTuning.blurSigma)
-    // R1: blur at quarter area (half each axis), floored so the short side
-    // stays >= 256px. Source and output stay full-res; the composite upscales
-    // the downscaled blurred bg with the linear sampler for free.
-    let shortSide = min(width, height)
-    let blurTarget = max(256, Int((Double(shortSide) * 0.5).rounded()))
-    let blurScale = Double(blurTarget) / Double(shortSide)
-    let blurW = max(2, Int((Double(width) * blurScale).rounded()) & ~1)
-    let blurH = max(2, Int((Double(height) * blurScale).rounded()) & ~1)
-    let (blurA, blurB) = try renderer.blurPingPong(width: blurW, height: blurH)
-
-    let commandBuffer = try renderer.makeCommandBuffer()
-    commandBuffer.label = "Kaleidoscope.Blur"
-
-    // Downsample pass: original -> blurA. axis=0 collapses the kernel to its
-    // center tap (weights sum to 1), a plain bilinear box-average into the
-    // downscaled target. Both blur passes then run in downscaled space;
-    // sampling the full-res original with downscaled-spaced offsets serrates.
-    try renderer.encodeBlurPass(
-      commandBuffer: commandBuffer,
-      source: originalTexture,
-      target: blurA,
-      kernel: kernel,
-      axis: SIMD2<Float>(0.0, 0.0),
-      label: "blur-downsample"
-    )
-    // Horizontal pass: blurA -> blurB.
-    try renderer.encodeBlurPass(
-      commandBuffer: commandBuffer,
-      source: blurA,
-      target: blurB,
-      kernel: kernel,
-      axis: SIMD2<Float>(1.0 / Float(blurW), 0.0),
-      label: "blur-horizontal"
-    )
-    // Vertical pass: blurB -> blurA.
-    try renderer.encodeBlurPass(
-      commandBuffer: commandBuffer,
-      source: blurB,
-      target: blurA,
-      kernel: kernel,
-      axis: SIMD2<Float>(0.0, 1.0 / Float(blurH)),
-      label: "blur-vertical"
-    )
-
-    // Step 4: composite original (fg) + blurred (bg) + mask -> output.
-    let (maskLo, maskHi) = MaskTuning.smoothstepRange(
-      hardness: EffectTuning.maskHardness,
-      threshold: EffectTuning.maskThreshold
-    )
-    let output = try renderer.dequeueOutputBuffer(width: width, height: height)
-    let (outputTexture, outputWrapper) = try TextureBridge.makeTexture(
-      from: output,
-      cache: renderer.textureCache,
-      pixelFormat: .bgra8Unorm,
-      planeIndex: 0
-    )
-    try renderer.encodeComposite(
-      commandBuffer: commandBuffer,
-      target: outputTexture,
-      original: originalTexture,
-      background: blurA,
-      mask: maskTexture,
-      maskUvScale: SIMD2<Float>(1, 1),
-      maskUvOffset: SIMD2<Float>(0, 0),
-      maskHi: maskHi,
-      maskLo: maskLo,
-      // RENDER-PASS-PARITY V-flip (NOT a camera-orientation term). The blurred
-      // background passes through an odd number of .private render passes
-      // (downsample + H + V); each Metal pass flips vertically in buffer space
-      // (the transpiled passthrough does not negate gl_Position.y; see
-      // MetalRenderer header), so the background arrives flipped relative to the
-      // directly-sampled foreground (the composite samples uOriginal in its
-      // single pass). Cancel it with a V flip of the background UV
-      // (bgUv.y -> 1 - bgUv.y). This is independent of the camera: the ingest
-      // normalization (Ingest.swift) handles display rotation upstream and does
-      // NOT change how many ping-pong passes blur runs, so this term stays even
-      // though the per-effect ORIENTATION cascade was removed. iOS-only:
-      // Android's GL passes share the FBO origin and do not flip.
-      // The single calibration knob for camera orientation is
-      // Ingest.ROTATION_DIRECTION; do not repurpose this term for it.
-      bgUvScale: SIMD2<Float>(1, -1),
-      bgUvOffset: SIMD2<Float>(0, 1),
-      label: "blur-composite"
-    )
-
-    // R3 frame-pipelining: commit asynchronously and return the PREVIOUS
-    // frame's completed output (one frame of latency), instead of stalling on
-    // waitUntilCompleted every frame. The completion handler publishes `output`
-    // as ready only once the GPU finishes writing it, so the buffer we hand to
-    // WebRTC is always fully rendered. Before any frame has completed, forward
-    // the original frame (same fall-through as "no mask yet").
-    // Keep the GPU's per-frame inputs alive until the command buffer completes.
-    // The mask CVPixelBuffer (pool-owned; the worker queue may republish/reclaim
-    // otherwise) and the mask + output CVMetalTexture wrappers (which pin their
-    // IOSurfaces for the cache) outlive this frame's process() return under R3,
-    // so they ride the completion handler. The original ingest buffer + its
-    // wrapper are now pool-dequeued per frame (not a single renderer-cached
-    // buffer), so they MUST ride the completion handler too; otherwise the pool
-    // could recycle the buffer the GPU is still sampling.
-    // The blur ping-pong textures are device-private (.storageMode private), not
-    // IOSurface-backed pool buffers, and are owned by the renderer, so they need
-    // no keep-alive here.
-    guard let ready = renderer.commitPipelined(
-      commandBuffer,
-      currentOutput: output,
-      keepAlive: [maskBuffer, maskWrapper, outputWrapper, originalBuffer, originalWrapper],
-      debugTiming: EffectTuning.debugTiming,
-      timingLabel: "blur"
-    ) else {
-      return frame
-    }
-
-    return FrameBridge.makeOutputFrame(pixelBuffer: ready, like: frame)
-  }
-}

package/ios/KaleidoscopeModule/shaders/blur.metalsrc

@@ -1,72 +0,0 @@
-#pragma clang diagnostic ignored "-Wmissing-prototypes"
-#pragma clang diagnostic ignored "-Wmissing-braces"
-
-#include <metal_stdlib>
-#include <simd/simd.h>
-
-using namespace metal;
-
-template<typename T, size_t Num>
-struct spvUnsafeArray
-{
-    T elements[Num ? Num : 1];
-    
-    thread T& operator [] (size_t pos) thread
-    {
-        return elements[pos];
-    }
-    constexpr const thread T& operator [] (size_t pos) const thread
-    {
-        return elements[pos];
-    }
-    
-    device T& operator [] (size_t pos) device
-    {
-        return elements[pos];
-    }
-    constexpr const device T& operator [] (size_t pos) const device
-    {
-        return elements[pos];
-    }
-    
-    constexpr const constant T& operator [] (size_t pos) const constant
-    {
-        return elements[pos];
-    }
-    
-    threadgroup T& operator [] (size_t pos) threadgroup
-    {
-        return elements[pos];
-    }
-    constexpr const threadgroup T& operator [] (size_t pos) const threadgroup
-    {
-        return elements[pos];
-    }
-};
-
-struct main0_out
-{
-    float4 oColor [[color(0)]];
-};
-
-struct main0_in
-{
-    float2 vUv [[user(locn0)]];
-};
-
-fragment main0_out main0(main0_in in [[stage_in]], constant spvUnsafeArray<float, 5>& uWeights [[buffer(0)]], constant float2& uAxis [[buffer(5)]], constant spvUnsafeArray<float, 5>& uOffsets [[buffer(6)]], texture2d<float> uTex [[texture(0)]], sampler uTexSmplr [[sampler(0)]])
-{
-    main0_out out = {};
-    float4 _81;
-    _81 = uTex.sample(uTexSmplr, in.vUv) * uWeights[0];
-    for (int _80 = 1; _80 < 5; )
-    {
-        float2 _52 = uAxis * uOffsets[_80];
-        _81 = (_81 + (uTex.sample(uTexSmplr, (in.vUv + _52)) * uWeights[_80])) + (uTex.sample(uTexSmplr, (in.vUv - _52)) * uWeights[_80]);
-        _80++;
-        continue;
-    }
-    out.oColor = _81;
-    return out;
-}
-

package/ios/KaleidoscopeModule/shaders/composite.metalsrc

@@ -1,22 +0,0 @@
-#include <metal_stdlib>
-#include <simd/simd.h>
-
-using namespace metal;
-
-struct main0_out
-{
-    float4 oColor [[color(0)]];
-};
-
-struct main0_in
-{
-    float2 vUv [[user(locn0)]];
-};
-
-fragment main0_out main0(main0_in in [[stage_in]], constant float2& uMaskUvScale [[buffer(0)]], constant float2& uMaskUvOffset [[buffer(1)]], constant float& uMaskHi [[buffer(2)]], constant float& uMaskLo [[buffer(3)]], constant float2& uBgUvScale [[buffer(4)]], constant float2& uBgUvOffset [[buffer(5)]], texture2d<float> uMask [[texture(0)]], texture2d<float> uOriginal [[texture(1)]], texture2d<float> uBackground [[texture(2)]], sampler uMaskSmplr [[sampler(0)]], sampler uOriginalSmplr [[sampler(1)]], sampler uBackgroundSmplr [[sampler(2)]])
-{
-    main0_out out = {};
-    out.oColor = float4(mix(uBackground.sample(uBackgroundSmplr, fast::clamp((in.vUv * uBgUvScale) + uBgUvOffset, float2(0.0), float2(1.0))).xyz, uOriginal.sample(uOriginalSmplr, in.vUv).xyz, float3(smoothstep(uMaskLo, fast::max(uMaskHi, uMaskLo + 0.001000000047497451305389404296875), uMask.sample(uMaskSmplr, ((in.vUv * uMaskUvScale) + uMaskUvOffset)).x))), 1.0);
-    return out;
-}
-

package/src/backgrounds/README.md

@@ -1,83 +0,0 @@
-# Background presets
-
-Bundled example backgrounds for the `background-image` effect. Import a single
-preset and pass it as the effect's `source`:
-
-```ts
-import { applyVideoEffects } from 'react-native-webrtc-kaleidoscope';
-import { darkOffice } from 'react-native-webrtc-kaleidoscope/backgrounds/dark-office';
-
-applyVideoEffects(track, [{ name: 'background-image', source: darkOffice }]);
-```
-
-The bundled presets (the catalog lives in `presets.ts`) are `debug-resolutions`
-(a viewport/resolution calibration grid for verifying cover-fit), `dark-office`,
-and `light-office`.
-
-`darkOffice` resolves per platform via a build-time file split (`dark-office.ts`
-for native, `dark-office.web.ts` for web, with the shared contract in
-`preset-source.types.ts`); the bundler picks the variant, there is no runtime
-`Platform.OS` branch:
-
-- **Web:** the bundled WebP's URL, which the effect fetches and uploads as a texture.
-- **Native (iOS/Android):** the preset name (`'dark-office'`); the native module
-  loads its own bundled copy from native resources. The native variant imports
-  no WebP and no expo-asset, so native bundles neither.
-
-The barrel exports the preset catalog, not the sources:
-
-```ts
-import { BACKGROUND_PRESETS, type BackgroundPresetName } from 'react-native-webrtc-kaleidoscope/backgrounds';
-```
-
-Sources are imported per preset on purpose. Metro does not tree-shake, so a
-per-preset import is the only way to pull just the WebP you use.
-
-For a non-Expo web bundler, import the asset URL directly:
-
-```ts
-import darkOfficeUrl from 'react-native-webrtc-kaleidoscope/backgrounds/dark-office.webp';
-```
-
-## Optimal background: size, shape, format
-
-A background is composited behind the segmented subject and sampled with bilinear
-filtering and no mipmaps, so resolution beyond the output video size is discarded;
-it costs decode time, memory, and upload bandwidth without improving the picture.
-Smaller, well-sized assets shorten load and switch latency; they do not change
-steady-state shader cost (once uploaded, the file format is invisible to the GPU).
-
-Target:
-
-- **Resolution:** 1280x720. Matches typical WebRTC output. Go to 1920x1080 only
-  if your source art genuinely has that many pixels; upscaling produces a soft,
-  not crisp, 1080p.
-- **Shape:** 16:9, the call's aspect. Center-crop other ratios so the runtime
-  does not stretch or letterbox.
-- **Format:** lossy WebP, no alpha (a full-frame background needs none). WebP is
-  supported across the targets this library runs on.
-- **Quality:** ~q88. High enough to avoid banding on smooth walls and gradients,
-  while still landing well under ~100 KB for typical scenes. Lossless is the
-  wrong tool here: on photographic content it lands near the original PNG size.
-
-The shipped office presets were produced from 1536x1024 source art with ImageMagick:
-
-```sh
-convert in.png -resize "1280x720^" -gravity center -extent 1280x720 \
-  -quality 88 -define webp:method=6 dark-office.webp
-```
-
-## Adding a preset
-
-1. Append the name to `BACKGROUND_PRESETS` in `presets.ts`.
-2. Drop the optimized `<name>.webp` here (recipe above).
-3. Add the loader pair mirroring `dark-office`: `<name>.ts` (native, returns the
-   name) and `<name>.web.ts` (web, returns the WebP URL), both annotated with
-   `PresetSource` from `preset-source.types.ts`.
-4. Add the `./backgrounds/<name>` export (with `react-native`, `browser`,
-   `import`, `default` conditions) and `./backgrounds/<name>.webp` to the
-   package `exports`.
-5. For native support, add `<name>.png` under `android/src/main/assets/backgrounds/`
-   and `ios/KaleidoscopeModule/resources/backgrounds/`, and register the factory
-   on each native side (`Registration.kt`, `Registration.swift`). The
-   `test/registry-parity.test.ts` guard fails if a preset is missing on either side.

package/src/backgrounds/dark-office.ts

@@ -1,6 +0,0 @@
-import type { PresetSource } from './preset-source.types';
-
-// Native variant. The native module loads its own bundled resource by name, so
-// the source is just the preset name; no WebP import, no expo-asset on native.
-// Web is handled by dark-office.web.ts.
-export const darkOffice: PresetSource = 'dark-office';

package/src/backgrounds/dark-office.web.ts

@@ -1,9 +0,0 @@
-/// <reference path="./assets.d.ts" />
-import { Asset } from 'expo-asset';
-import darkOfficeAsset from './dark-office.webp';
-import type { PresetSource } from './preset-source.types';
-
-// Web variant. The bundled WebP's URL, which the background-image effect
-// fetches. Resolved with expo-asset because react-native-web has no
-// Image.resolveAssetSource; `.uri` is set synchronously by fromModule.
-export const darkOffice: PresetSource = Asset.fromModule(darkOfficeAsset).uri;

package/src/backgrounds/debug-resolutions.ts

@@ -1,7 +0,0 @@
-import type { PresetSource } from './preset-source.types';
-
-// Native variant. The native module loads its own bundled resource by name, so
-// the source is just the preset name. Web is handled by
-// debug-resolutions.web.ts. This is a viewport/resolution calibration grid for
-// verifying background cover-fit (clipping, crop, scale) on device.
-export const debugResolutions: PresetSource = 'debug-resolutions';

package/src/backgrounds/debug-resolutions.web.ts

@@ -1,9 +0,0 @@
-/// <reference path="./assets.d.ts" />
-import { Asset } from 'expo-asset';
-import debugResolutionsAsset from './debug-resolutions.webp';
-import type { PresetSource } from './preset-source.types';
-
-// Web variant. A viewport/resolution calibration grid (concentric labeled
-// rectangles for common capture resolutions) for verifying background
-// cover-fit clipping, crop, and scale on device.
-export const debugResolutions: PresetSource = Asset.fromModule(debugResolutionsAsset).uri;

package/src/backgrounds/home-dark.ts

@@ -1,6 +0,0 @@
-import type { PresetSource } from './preset-source.types';
-
-// Native variant. The native module loads its own bundled resource by name, so
-// the source is just the preset name; no WebP import, no expo-asset on native.
-// Web is handled by home-dark.web.ts.
-export const homeDark: PresetSource = 'home-dark';

package/src/backgrounds/home-dark.web.ts

@@ -1,7 +0,0 @@
-/// <reference path="./assets.d.ts" />
-import { Asset } from 'expo-asset';
-import homeDarkAsset from './home-dark.webp';
-import type { PresetSource } from './preset-source.types';
-
-// Web variant. The bundled WebP's URL, which the background-image effect fetches.
-export const homeDark: PresetSource = Asset.fromModule(homeDarkAsset).uri;

package/src/backgrounds/home-light.ts

@@ -1,6 +0,0 @@
-import type { PresetSource } from './preset-source.types';
-
-// Native variant. The native module loads its own bundled resource by name, so
-// the source is just the preset name; no WebP import, no expo-asset on native.
-// Web is handled by home-light.web.ts.
-export const homeLight: PresetSource = 'home-light';

package/src/backgrounds/home-light.web.ts

@@ -1,7 +0,0 @@
-/// <reference path="./assets.d.ts" />
-import { Asset } from 'expo-asset';
-import homeLightAsset from './home-light.webp';
-import type { PresetSource } from './preset-source.types';
-
-// Web variant. The bundled WebP's URL, which the background-image effect fetches.
-export const homeLight: PresetSource = Asset.fromModule(homeLightAsset).uri;

package/src/backgrounds/index.ts

@@ -1,7 +0,0 @@
-// Barrel for the backgrounds feature: the platform-agnostic preset catalog.
-// Preset *sources* are not re-exported here; import them per preset so each
-// pulls only its own WebP, e.g.
-// `import { darkOffice } from 'react-native-webrtc-kaleidoscope/backgrounds/dark-office'`.
-
-export type { BackgroundPresetName } from './presets';
-export { BACKGROUND_PRESETS } from './presets';

package/src/backgrounds/light-office.ts

@@ -1,6 +0,0 @@
-import type { PresetSource } from './preset-source.types';
-
-// Native variant. The native module loads its own bundled resource by name, so
-// the source is just the preset name; no WebP import, no expo-asset on native.
-// Web is handled by light-office.web.ts.
-export const lightOffice: PresetSource = 'light-office';

package/src/backgrounds/light-office.web.ts

@@ -1,9 +0,0 @@
-/// <reference path="./assets.d.ts" />
-import { Asset } from 'expo-asset';
-import lightOfficeAsset from './light-office.webp';
-import type { PresetSource } from './preset-source.types';
-
-// Web variant. The bundled WebP's URL, which the background-image effect
-// fetches. Resolved with expo-asset because react-native-web has no
-// Image.resolveAssetSource; `.uri` is set synchronously by fromModule.
-export const lightOffice: PresetSource = Asset.fromModule(lightOfficeAsset).uri;

package/src/backgrounds/nature-dark.ts

@@ -1,6 +0,0 @@
-import type { PresetSource } from './preset-source.types';
-
-// Native variant. The native module loads its own bundled resource by name, so
-// the source is just the preset name; no WebP import, no expo-asset on native.
-// Web is handled by nature-dark.web.ts.
-export const natureDark: PresetSource = 'nature-dark';

package/src/backgrounds/nature-dark.web.ts

@@ -1,7 +0,0 @@
-/// <reference path="./assets.d.ts" />
-import { Asset } from 'expo-asset';
-import natureDarkAsset from './nature-dark.webp';
-import type { PresetSource } from './preset-source.types';
-
-// Web variant. The bundled WebP's URL, which the background-image effect fetches.
-export const natureDark: PresetSource = Asset.fromModule(natureDarkAsset).uri;

package/src/backgrounds/nature-light.ts

@@ -1,6 +0,0 @@
-import type { PresetSource } from './preset-source.types';
-
-// Native variant. The native module loads its own bundled resource by name, so
-// the source is just the preset name; no WebP import, no expo-asset on native.
-// Web is handled by nature-light.web.ts.
-export const natureLight: PresetSource = 'nature-light';

package/src/backgrounds/nature-light.web.ts

@@ -1,7 +0,0 @@
-/// <reference path="./assets.d.ts" />
-import { Asset } from 'expo-asset';
-import natureLightAsset from './nature-light.webp';
-import type { PresetSource } from './preset-source.types';
-
-// Web variant. The bundled WebP's URL, which the background-image effect fetches.
-export const natureLight: PresetSource = Asset.fromModule(natureLightAsset).uri;

package/src/backgrounds/preset-source.types.ts

@@ -1,5 +0,0 @@
-// Shared contract for the platform-split preset loaders (office-N.ts / .web.ts).
-// The value a consumer passes as the `background-image` effect's `source`:
-// a fetchable URL on web, the preset name on native. Both variants annotate
-// their export against this so the pair cannot drift.
-export type PresetSource = string;

package/src/backgrounds/presets.ts

@@ -1,36 +0,0 @@
-// Background-image preset catalog. Single source of truth for the bundled
-// presets the library ships. Consumed by:
-//   - src/types.ts (BackgroundImageSpec.source narrows to BackgroundPresetName
-//     for autocomplete; a free-form string is also accepted on web for
-//     consumer-provided URLs),
-//   - src/index.ts (native allowlist derivation; the flat-string upstream
-//     registry encodes each preset as `background-image-${name}`),
-//   - the Android side mirrors this list at android/.../Registration.kt
-//     and android/src/main/assets/backgrounds/<name>.webp.
-//   - the iOS side mirrors it at ios/.../Registration.swift and
-//     ios/KaleidoscopeModule/resources/backgrounds/<name>.webp.
-//   - the demo at demo/app/index.tsx maps each preset name to a bundled
-//     WebP via Asset.fromModule for the web target.
-//
-// To add a new preset: append the name here, drop the matching
-// <name>.webp into android/src/main/assets/backgrounds/ and
-// ios/KaleidoscopeModule/resources/backgrounds/, add the require()'d
-// asset to the demo's preset map, and register the factory at both
-// Registration.kt and Registration.swift. The web side picks it up
-// automatically via the literal-union type and the derived native allowlist.
-
-export const BACKGROUND_PRESETS = [
-  'debug-resolutions',
-  'dark-office',
-  'light-office',
-  'home-light',
-  'home-dark',
-  'nature-light',
-  'nature-dark',
-  'stylized-light',
-  'stylized-dark',
-  'simiancraft-light',
-  'simiancraft-dark',
-] as const;
-
-export type BackgroundPresetName = (typeof BACKGROUND_PRESETS)[number];

package/src/backgrounds/simiancraft-dark.ts

@@ -1,6 +0,0 @@
-import type { PresetSource } from './preset-source.types';
-
-// Native variant. The native module loads its own bundled resource by name, so
-// the source is just the preset name; no WebP import, no expo-asset on native.
-// Web is handled by simiancraft-dark.web.ts.
-export const simiancraftDark: PresetSource = 'simiancraft-dark';