react-native-webrtc-kaleidoscope 2.0.0 → 2.1.0

package/dist/src/components/ui/polygon-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon-field.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/polygon-field.tsx"],"names":[],"mappings":"AAiBA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,iBAAiB,2CAmDzE","sourcesContent":["// PolygonField: editor for a `kind: 'polygon'` uniform (a vec2 array, stored flat\n// as [x0,y0, x1,y1, ...]). It is COMPOSED OF POINTS: one <Point> editor per vertex,\n// laid out in a SPATIAL GRID rather than a flat row, so the editors sit where their\n// corners are. With the row-major corner convention (p0=TL, p1=TR, p2=BL, p3=BR), a\n// 2-column grid puts each editor in its quad position: top-left edits the top-left\n// corner. The grid is √-shaped (cols = ceil(√points)), so a 4-point polygon is 2x2.\n// Self-wires the flat array via `useField`; each Point writes back its (x, y) slice.\n\nimport { StyleSheet, View } from 'react-native';\nimport { useField } from '../form/use-field';\nimport { Label } from './label';\nimport { Point } from './point';\n\n/** Editing range for both axes; shaft anchors sit slightly off-screen (-0.2..1.2). */\nconst RANGE_MIN = -0.2;\nconst RANGE_MAX = 1.2;\n\nexport type PolygonFieldProps = {\n  /** The uniform key this field drives: a vec2 array, flat [x0,y0, x1,y1, ...]. */\n  readonly uniform: string;\n  /** Number of polygon vertices; laid out in a ceil(√points)-column grid. */\n  readonly points: number;\n  /** Display name; defaults to the uniform key. */\n  readonly label?: string;\n};\n\nexport function PolygonField({ uniform, points, label }: PolygonFieldProps) {\n  const field = useField(uniform);\n  const flat = Array.isArray(field.value) ? field.value : [];\n  const name = label ?? uniform;\n\n  const setPoint = (p: number, x: number, y: number) => {\n    const next = flat.slice();\n    while (next.length < points * 2) next.push(0);\n    next[p * 2] = x;\n    next[p * 2 + 1] = y;\n    field.onChange(next);\n  };\n\n  // Spatial grid: cols = ceil(√points) (2 for a quad), filled row-major so vertex\n  // order maps to grid position. Array.from callbacks (not mutated for-counters)\n  // keep the per-Point onChange closures off the React Compiler's bail list.\n  const cols = Math.max(1, Math.ceil(Math.sqrt(points)));\n  const rowCount = Math.ceil(points / cols);\n\n  return (\n    <View style={styles.wrap}>\n      <Label>{name}</Label>\n      <View style={styles.grid}>\n        {Array.from({ length: rowCount }, (_, r) => (\n          <View\n            // biome-ignore lint/suspicious/noArrayIndexKey: grid rows are positional and fixed in count.\n            key={r}\n            style={styles.gridRow}\n          >\n            {Array.from({ length: cols }, (_, ci) => {\n              const p = r * cols + ci;\n              if (p >= points) return null;\n              return (\n                <Point\n                  key={p}\n                  x={flat[p * 2] ?? 0}\n                  y={flat[p * 2 + 1] ?? 0}\n                  min={RANGE_MIN}\n                  max={RANGE_MAX}\n                  label={`p${p}`}\n                  disabled={field.disabled}\n                  testID={`${field.testID}.${p}`}\n                  onChange={(x, y) => setPoint(p, x, y)}\n                />\n              );\n            })}\n          </View>\n        ))}\n      </View>\n    </View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  wrap: { gap: 4 },\n  grid: { gap: 8, alignSelf: 'flex-start' },\n  gridRow: { flexDirection: 'row', gap: 8 },\n});\n"]}

package/dist/src/components/ui/polygon-field.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PolygonField = PolygonField;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// PolygonField: editor for a `kind: 'polygon'` uniform (a vec2 array, stored flat
+// as [x0,y0, x1,y1, ...]). It is COMPOSED OF POINTS: one <Point> editor per vertex,
+// laid out in a SPATIAL GRID rather than a flat row, so the editors sit where their
+// corners are. With the row-major corner convention (p0=TL, p1=TR, p2=BL, p3=BR), a
+// 2-column grid puts each editor in its quad position: top-left edits the top-left
+// corner. The grid is √-shaped (cols = ceil(√points)), so a 4-point polygon is 2x2.
+// Self-wires the flat array via `useField`; each Point writes back its (x, y) slice.
+const react_native_1 = require("react-native");
+const use_field_1 = require("../form/use-field");
+const label_1 = require("./label");
+const point_1 = require("./point");
+/** Editing range for both axes; shaft anchors sit slightly off-screen (-0.2..1.2). */
+const RANGE_MIN = -0.2;
+const RANGE_MAX = 1.2;
+function PolygonField({ uniform, points, label }) {
+    const field = (0, use_field_1.useField)(uniform);
+    const flat = Array.isArray(field.value) ? field.value : [];
+    const name = label ?? uniform;
+    const setPoint = (p, x, y) => {
+        const next = flat.slice();
+        while (next.length < points * 2)
+            next.push(0);
+        next[p * 2] = x;
+        next[p * 2 + 1] = y;
+        field.onChange(next);
+    };
+    // Spatial grid: cols = ceil(√points) (2 for a quad), filled row-major so vertex
+    // order maps to grid position. Array.from callbacks (not mutated for-counters)
+    // keep the per-Point onChange closures off the React Compiler's bail list.
+    const cols = Math.max(1, Math.ceil(Math.sqrt(points)));
+    const rowCount = Math.ceil(points / cols);
+    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.wrap, children: [(0, jsx_runtime_1.jsx)(label_1.Label, { children: name }), (0, jsx_runtime_1.jsx)(react_native_1.View, { style: styles.grid, children: Array.from({ length: rowCount }, (_, r) => ((0, jsx_runtime_1.jsx)(react_native_1.View
+                // biome-ignore lint/suspicious/noArrayIndexKey: grid rows are positional and fixed in count.
+                , { style: styles.gridRow, children: Array.from({ length: cols }, (_, ci) => {
+                        const p = r * cols + ci;
+                        if (p >= points)
+                            return null;
+                        return ((0, jsx_runtime_1.jsx)(point_1.Point, { x: flat[p * 2] ?? 0, y: flat[p * 2 + 1] ?? 0, min: RANGE_MIN, max: RANGE_MAX, label: `p${p}`, disabled: field.disabled, testID: `${field.testID}.${p}`, onChange: (x, y) => setPoint(p, x, y) }, p));
+                    }) }, r))) })] }));
+}
+const styles = react_native_1.StyleSheet.create({
+    wrap: { gap: 4 },
+    grid: { gap: 8, alignSelf: 'flex-start' },
+    gridRow: { flexDirection: 'row', gap: 8 },
+});
+//# sourceMappingURL=polygon-field.js.map

package/dist/src/components/ui/polygon-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon-field.js","sourceRoot":"","sources":["../../../../src/components/ui/polygon-field.tsx"],"names":[],"mappings":"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","sourcesContent":["// PolygonField: editor for a `kind: 'polygon'` uniform (a vec2 array, stored flat\n// as [x0,y0, x1,y1, ...]). It is COMPOSED OF POINTS: one <Point> editor per vertex,\n// laid out in a SPATIAL GRID rather than a flat row, so the editors sit where their\n// corners are. With the row-major corner convention (p0=TL, p1=TR, p2=BL, p3=BR), a\n// 2-column grid puts each editor in its quad position: top-left edits the top-left\n// corner. The grid is √-shaped (cols = ceil(√points)), so a 4-point polygon is 2x2.\n// Self-wires the flat array via `useField`; each Point writes back its (x, y) slice.\n\nimport { StyleSheet, View } from 'react-native';\nimport { useField } from '../form/use-field';\nimport { Label } from './label';\nimport { Point } from './point';\n\n/** Editing range for both axes; shaft anchors sit slightly off-screen (-0.2..1.2). */\nconst RANGE_MIN = -0.2;\nconst RANGE_MAX = 1.2;\n\nexport type PolygonFieldProps = {\n  /** The uniform key this field drives: a vec2 array, flat [x0,y0, x1,y1, ...]. */\n  readonly uniform: string;\n  /** Number of polygon vertices; laid out in a ceil(√points)-column grid. */\n  readonly points: number;\n  /** Display name; defaults to the uniform key. */\n  readonly label?: string;\n};\n\nexport function PolygonField({ uniform, points, label }: PolygonFieldProps) {\n  const field = useField(uniform);\n  const flat = Array.isArray(field.value) ? field.value : [];\n  const name = label ?? uniform;\n\n  const setPoint = (p: number, x: number, y: number) => {\n    const next = flat.slice();\n    while (next.length < points * 2) next.push(0);\n    next[p * 2] = x;\n    next[p * 2 + 1] = y;\n    field.onChange(next);\n  };\n\n  // Spatial grid: cols = ceil(√points) (2 for a quad), filled row-major so vertex\n  // order maps to grid position. Array.from callbacks (not mutated for-counters)\n  // keep the per-Point onChange closures off the React Compiler's bail list.\n  const cols = Math.max(1, Math.ceil(Math.sqrt(points)));\n  const rowCount = Math.ceil(points / cols);\n\n  return (\n    <View style={styles.wrap}>\n      <Label>{name}</Label>\n      <View style={styles.grid}>\n        {Array.from({ length: rowCount }, (_, r) => (\n          <View\n            // biome-ignore lint/suspicious/noArrayIndexKey: grid rows are positional and fixed in count.\n            key={r}\n            style={styles.gridRow}\n          >\n            {Array.from({ length: cols }, (_, ci) => {\n              const p = r * cols + ci;\n              if (p >= points) return null;\n              return (\n                <Point\n                  key={p}\n                  x={flat[p * 2] ?? 0}\n                  y={flat[p * 2 + 1] ?? 0}\n                  min={RANGE_MIN}\n                  max={RANGE_MAX}\n                  label={`p${p}`}\n                  disabled={field.disabled}\n                  testID={`${field.testID}.${p}`}\n                  onChange={(x, y) => setPoint(p, x, y)}\n                />\n              );\n            })}\n          </View>\n        ))}\n      </View>\n    </View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  wrap: { gap: 4 },\n  grid: { gap: 8, alignSelf: 'flex-start' },\n  gridRow: { flexDirection: 'row', gap: 8 },\n});\n"]}

package/dist/src/components/ui/readout.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react';
+import type { StyleProp, TextStyle } from 'react-native';
+export type ReadoutProps = {
+    readonly children: ReactNode;
+    /** NativeWind class; resolved via the `./nativewind` interop. */
+    readonly className?: string;
+    readonly style?: StyleProp<TextStyle>;
+};
+export declare function Readout({ children, style }: ReadoutProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=readout.d.ts.map

package/dist/src/components/ui/readout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readout.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/readout.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,YAAY,2CAKxD","sourcesContent":["// Readout: a themed Text for a control's current value (distinct slot from the\n// label, and named `readout` to avoid colliding with a control's mutating value).\n\nimport type { ReactNode } from 'react';\nimport type { StyleProp, TextStyle } from 'react-native';\nimport { StyleSheet, Text } from 'react-native';\nimport { useThemeSlot } from '../theme/provider';\n\nexport type ReadoutProps = {\n  readonly children: ReactNode;\n  /** NativeWind class; resolved via the `./nativewind` interop. */\n  readonly className?: string;\n  readonly style?: StyleProp<TextStyle>;\n};\n\nexport function Readout({ children, style }: ReadoutProps) {\n  const { style: themeStyle } = useThemeSlot('readout');\n  return (\n    <Text style={[styles.readout, themeStyle as StyleProp<TextStyle>, style]}>{children}</Text>\n  );\n}\n\nconst styles = StyleSheet.create({\n  readout: { color: '#8888ff', fontSize: 12, fontVariant: ['tabular-nums'] },\n});\n"]}

package/dist/src/components/ui/readout.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Readout = Readout;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_native_1 = require("react-native");
+const provider_1 = require("../theme/provider");
+function Readout({ children, style }) {
+    const { style: themeStyle } = (0, provider_1.useThemeSlot)('readout');
+    return ((0, jsx_runtime_1.jsx)(react_native_1.Text, { style: [styles.readout, themeStyle, style], children: children }));
+}
+const styles = react_native_1.StyleSheet.create({
+    readout: { color: '#8888ff', fontSize: 12, fontVariant: ['tabular-nums'] },
+});
+//# sourceMappingURL=readout.js.map

package/dist/src/components/ui/readout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readout.js","sourceRoot":"","sources":["../../../../src/components/ui/readout.tsx"],"names":[],"mappings":";;;;AAKA,+CAAgD;AAChD,gDAAiD;AASjD,iBAAwB,EAAE,QAAQ,EAAE,KAAK,EAAgB;IACvD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAA,uBAAY,EAAC,SAAS,CAAC,CAAC;IACtD,OAAO,CACL,uBAAC,mBAAI,IAAC,KAAK,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,UAAkC,EAAE,KAAK,CAAC,YAAG,QAAQ,GAAQ,CAC5F,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,yBAAU,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC,EAAE;CAC3E,CAAC,CAAC","sourcesContent":["// Readout: a themed Text for a control's current value (distinct slot from the\n// label, and named `readout` to avoid colliding with a control's mutating value).\n\nimport type { ReactNode } from 'react';\nimport type { StyleProp, TextStyle } from 'react-native';\nimport { StyleSheet, Text } from 'react-native';\nimport { useThemeSlot } from '../theme/provider';\n\nexport type ReadoutProps = {\n  readonly children: ReactNode;\n  /** NativeWind class; resolved via the `./nativewind` interop. */\n  readonly className?: string;\n  readonly style?: StyleProp<TextStyle>;\n};\n\nexport function Readout({ children, style }: ReadoutProps) {\n  const { style: themeStyle } = useThemeSlot('readout');\n  return (\n    <Text style={[styles.readout, themeStyle as StyleProp<TextStyle>, style]}>{children}</Text>\n  );\n}\n\nconst styles = StyleSheet.create({\n  readout: { color: '#8888ff', fontSize: 12, fontVariant: ['tabular-nums'] },\n});\n"]}

package/dist/src/components/ui/slider-value.d.ts

@@ -0,0 +1,8 @@
+export declare const safeSliderValue: (v: number) => number;
+/** Shared track/thumb tints so every slider in the kit reads the same. */
+export declare const SLIDER_TINTS: {
+    readonly minimumTrackTintColor: '#8888ff';
+    readonly maximumTrackTintColor: '#444';
+    readonly thumbTintColor: '#eeeeff';
+};
+//# sourceMappingURL=slider-value.d.ts.map

package/dist/src/components/ui/slider-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider-value.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/slider-value.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,MAAO,MAAM,KAAG,MACQ,CAAC;AAErD,0EAA0E;AAC1E,eAAO,MAAM,YAAY;aACvB,qBAAqB,EAAE,SAAS;aAChC,qBAAqB,EAAE,MAAM;aAC7B,cAAc,EAAE,SAAS;CACjB,CAAC","sourcesContent":["// The web slider wrapper maps an exact 0 (and NaN/undefined) to `undefined`,\n// then crashes calling `.toFixed()` on it. A hair above zero is visually\n// identical and keeps the control alive; the real (possibly 0) value still\n// flows through onChange and the readout, so this is presentation-only.\nconst SLIDER_EPSILON = 1e-4;\n\nexport const safeSliderValue = (v: number): number =>\n  Number.isFinite(v) && v !== 0 ? v : SLIDER_EPSILON;\n\n/** Shared track/thumb tints so every slider in the kit reads the same. */\nexport const SLIDER_TINTS = {\n  minimumTrackTintColor: '#8888ff',\n  maximumTrackTintColor: '#444',\n  thumbTintColor: '#eeeeff',\n} as const;\n"]}

package/dist/src/components/ui/slider-value.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SLIDER_TINTS = exports.safeSliderValue = void 0;
+// The web slider wrapper maps an exact 0 (and NaN/undefined) to `undefined`,
+// then crashes calling `.toFixed()` on it. A hair above zero is visually
+// identical and keeps the control alive; the real (possibly 0) value still
+// flows through onChange and the readout, so this is presentation-only.
+const SLIDER_EPSILON = 1e-4;
+const safeSliderValue = (v) => Number.isFinite(v) && v !== 0 ? v : SLIDER_EPSILON;
+exports.safeSliderValue = safeSliderValue;
+/** Shared track/thumb tints so every slider in the kit reads the same. */
+exports.SLIDER_TINTS = {
+    minimumTrackTintColor: '#8888ff',
+    maximumTrackTintColor: '#444',
+    thumbTintColor: '#eeeeff',
+};
+//# sourceMappingURL=slider-value.js.map

package/dist/src/components/ui/slider-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider-value.js","sourceRoot":"","sources":["../../../../src/components/ui/slider-value.ts"],"names":[],"mappings":";;;AAAA,6EAA6E;AAC7E,yEAAyE;AACzE,2EAA2E;AAC3E,wEAAwE;AACxE,MAAM,cAAc,GAAG,IAAI,CAAC;AAErB,MAAM,eAAe,GAAG,CAAC,CAAS,EAAU,EAAE,CACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;AADxC,QAAA,eAAe,GAAf,eAAe,CACyB;AAErD,0EAA0E;AAC7D,QAAA,YAAY,GAAG;IAC1B,qBAAqB,EAAE,SAAS;IAChC,qBAAqB,EAAE,MAAM;IAC7B,cAAc,EAAE,SAAS;CACjB,CAAC","sourcesContent":["// The web slider wrapper maps an exact 0 (and NaN/undefined) to `undefined`,\n// then crashes calling `.toFixed()` on it. A hair above zero is visually\n// identical and keeps the control alive; the real (possibly 0) value still\n// flows through onChange and the readout, so this is presentation-only.\nconst SLIDER_EPSILON = 1e-4;\n\nexport const safeSliderValue = (v: number): number =>\n  Number.isFinite(v) && v !== 0 ? v : SLIDER_EPSILON;\n\n/** Shared track/thumb tints so every slider in the kit reads the same. */\nexport const SLIDER_TINTS = {\n  minimumTrackTintColor: '#8888ff',\n  maximumTrackTintColor: '#444',\n  thumbTintColor: '#eeeeff',\n} as const;\n"]}

package/dist/src/components/ui/slider.d.ts

@@ -0,0 +1,15 @@
+import type { StyleProp, ViewStyle } from 'react-native';
+export type SliderProps = {
+    /** The uniform key this slider drives (a scalar). */
+    readonly uniform: string;
+    readonly min: number;
+    readonly max: number;
+    readonly step?: number;
+    /** Display name; defaults to the uniform key. */
+    readonly label?: string;
+    /** NativeWind class for the container; resolved via the `./nativewind` interop. */
+    readonly className?: string;
+    readonly style?: StyleProp<ViewStyle>;
+};
+export declare function Slider({ uniform, min, max, step, label, style }: SliderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=slider.d.ts.map

package/dist/src/components/ui/slider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/slider.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AASzD,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,WAAW,2CAkDnF","sourcesContent":["// Slider: a self-wiring scalar field. Reads/writes its uniform via `useField`\n// (so the thumb tracks the drag synchronously; only the ControlForm's emit\n// debounces), and pairs the slider with a typed number input so you can drag OR\n// type/paste an exact value. Renders its own label, themes via the `slider` slot.\n\nimport RNSlider from '@react-native-community/slider';\nimport { useState } from 'react';\nimport type { StyleProp, ViewStyle } from 'react-native';\nimport { StyleSheet, TextInput, View } from 'react-native';\nimport { useField } from '../form/use-field';\nimport { useThemeSlot } from '../theme/provider';\nimport { Label } from './label';\nimport { SLIDER_TINTS, safeSliderValue } from './slider-value';\n\nconst fmt = (v: number) => (Number.isFinite(v) ? String(Math.round(v * 1000) / 1000) : '0');\n\nexport type SliderProps = {\n  /** The uniform key this slider drives (a scalar). */\n  readonly uniform: string;\n  readonly min: number;\n  readonly max: number;\n  readonly step?: number;\n  /** Display name; defaults to the uniform key. */\n  readonly label?: string;\n  /** NativeWind class for the container; resolved via the `./nativewind` interop. */\n  readonly className?: string;\n  readonly style?: StyleProp<ViewStyle>;\n};\n\nexport function Slider({ uniform, min, max, step = 0.01, label, style }: SliderProps) {\n  const field = useField(uniform);\n  const { style: themeStyle } = useThemeSlot('slider');\n  const value = typeof field.value === 'number' ? field.value : 0;\n  const name = label ?? uniform;\n\n  // The number input holds its own draft text so partial entries (\"0.\", \"-\") and\n  // pastes survive; the slider writes the draft too, so dragging keeps it in sync.\n  // A preset switch remounts the form, so the draft re-seeds from the new value.\n  const [draft, setDraft] = useState(() => fmt(value));\n\n  const fromSlider = (v: number) => {\n    setDraft(fmt(v));\n    field.onChange(v);\n  };\n  const fromText = (t: string) => {\n    setDraft(t);\n    const v = Number.parseFloat(t);\n    if (Number.isFinite(v)) field.onChange(Math.min(max, Math.max(min, v)));\n  };\n\n  return (\n    <View style={[styles.row, themeStyle as StyleProp<ViewStyle>, style]}>\n      <View style={styles.line}>\n        <Label>{name}</Label>\n        <TextInput\n          style={styles.num}\n          testID={field.testID ? `${field.testID}.num` : undefined}\n          accessibilityLabel={`${name} value`}\n          value={draft}\n          keyboardType=\"numeric\"\n          editable={!field.disabled}\n          selectTextOnFocus\n          onChangeText={fromText}\n        />\n      </View>\n      <RNSlider\n        style={styles.slider}\n        testID={field.testID}\n        accessibilityLabel={name}\n        minimumValue={min}\n        maximumValue={max}\n        step={step}\n        value={safeSliderValue(value)}\n        disabled={field.disabled}\n        onValueChange={fromSlider}\n        {...SLIDER_TINTS}\n      />\n    </View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  row: { gap: 2 },\n  line: { flexDirection: 'row', justifyContent: 'space-between', alignItems: 'center' },\n  num: {\n    minWidth: 56,\n    color: '#8888ff',\n    fontSize: 12,\n    fontVariant: ['tabular-nums'],\n    textAlign: 'right',\n    paddingVertical: 0,\n    paddingHorizontal: 4,\n    borderWidth: StyleSheet.hairlineWidth,\n    borderColor: 'rgba(136,136,255,0.4)',\n    borderRadius: 3,\n  },\n  slider: { width: '100%', height: 32 },\n});\n"]}

package/dist/src/components/ui/slider.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Slider = Slider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// Slider: a self-wiring scalar field. Reads/writes its uniform via `useField`
+// (so the thumb tracks the drag synchronously; only the ControlForm's emit
+// debounces), and pairs the slider with a typed number input so you can drag OR
+// type/paste an exact value. Renders its own label, themes via the `slider` slot.
+const slider_1 = __importDefault(require("@react-native-community/slider"));
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const use_field_1 = require("../form/use-field");
+const provider_1 = require("../theme/provider");
+const label_1 = require("./label");
+const slider_value_1 = require("./slider-value");
+const fmt = (v) => (Number.isFinite(v) ? String(Math.round(v * 1000) / 1000) : '0');
+function Slider({ uniform, min, max, step = 0.01, label, style }) {
+    const field = (0, use_field_1.useField)(uniform);
+    const { style: themeStyle } = (0, provider_1.useThemeSlot)('slider');
+    const value = typeof field.value === 'number' ? field.value : 0;
+    const name = label ?? uniform;
+    // The number input holds its own draft text so partial entries ("0.", "-") and
+    // pastes survive; the slider writes the draft too, so dragging keeps it in sync.
+    // A preset switch remounts the form, so the draft re-seeds from the new value.
+    const [draft, setDraft] = (0, react_1.useState)(() => fmt(value));
+    const fromSlider = (v) => {
+        setDraft(fmt(v));
+        field.onChange(v);
+    };
+    const fromText = (t) => {
+        setDraft(t);
+        const v = Number.parseFloat(t);
+        if (Number.isFinite(v))
+            field.onChange(Math.min(max, Math.max(min, v)));
+    };
+    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: [styles.row, themeStyle, style], children: [(0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.line, children: [(0, jsx_runtime_1.jsx)(label_1.Label, { children: name }), (0, jsx_runtime_1.jsx)(react_native_1.TextInput, { style: styles.num, testID: field.testID ? `${field.testID}.num` : undefined, accessibilityLabel: `${name} value`, value: draft, keyboardType: "numeric", editable: !field.disabled, selectTextOnFocus: true, onChangeText: fromText })] }), (0, jsx_runtime_1.jsx)(slider_1.default, { style: styles.slider, testID: field.testID, accessibilityLabel: name, minimumValue: min, maximumValue: max, step: step, value: (0, slider_value_1.safeSliderValue)(value), disabled: field.disabled, onValueChange: fromSlider, ...slider_value_1.SLIDER_TINTS })] }));
+}
+const styles = react_native_1.StyleSheet.create({
+    row: { gap: 2 },
+    line: { flexDirection: 'row', justifyContent: 'space-between', alignItems: 'center' },
+    num: {
+        minWidth: 56,
+        color: '#8888ff',
+        fontSize: 12,
+        fontVariant: ['tabular-nums'],
+        textAlign: 'right',
+        paddingVertical: 0,
+        paddingHorizontal: 4,
+        borderWidth: react_native_1.StyleSheet.hairlineWidth,
+        borderColor: 'rgba(136,136,255,0.4)',
+        borderRadius: 3,
+    },
+    slider: { width: '100%', height: 32 },
+});
+//# sourceMappingURL=slider.js.map

package/dist/src/components/ui/slider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider.js","sourceRoot":"","sources":["../../../../src/components/ui/slider.tsx"],"names":[],"mappings":"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","sourcesContent":["// Slider: a self-wiring scalar field. Reads/writes its uniform via `useField`\n// (so the thumb tracks the drag synchronously; only the ControlForm's emit\n// debounces), and pairs the slider with a typed number input so you can drag OR\n// type/paste an exact value. Renders its own label, themes via the `slider` slot.\n\nimport RNSlider from '@react-native-community/slider';\nimport { useState } from 'react';\nimport type { StyleProp, ViewStyle } from 'react-native';\nimport { StyleSheet, TextInput, View } from 'react-native';\nimport { useField } from '../form/use-field';\nimport { useThemeSlot } from '../theme/provider';\nimport { Label } from './label';\nimport { SLIDER_TINTS, safeSliderValue } from './slider-value';\n\nconst fmt = (v: number) => (Number.isFinite(v) ? String(Math.round(v * 1000) / 1000) : '0');\n\nexport type SliderProps = {\n  /** The uniform key this slider drives (a scalar). */\n  readonly uniform: string;\n  readonly min: number;\n  readonly max: number;\n  readonly step?: number;\n  /** Display name; defaults to the uniform key. */\n  readonly label?: string;\n  /** NativeWind class for the container; resolved via the `./nativewind` interop. */\n  readonly className?: string;\n  readonly style?: StyleProp<ViewStyle>;\n};\n\nexport function Slider({ uniform, min, max, step = 0.01, label, style }: SliderProps) {\n  const field = useField(uniform);\n  const { style: themeStyle } = useThemeSlot('slider');\n  const value = typeof field.value === 'number' ? field.value : 0;\n  const name = label ?? uniform;\n\n  // The number input holds its own draft text so partial entries (\"0.\", \"-\") and\n  // pastes survive; the slider writes the draft too, so dragging keeps it in sync.\n  // A preset switch remounts the form, so the draft re-seeds from the new value.\n  const [draft, setDraft] = useState(() => fmt(value));\n\n  const fromSlider = (v: number) => {\n    setDraft(fmt(v));\n    field.onChange(v);\n  };\n  const fromText = (t: string) => {\n    setDraft(t);\n    const v = Number.parseFloat(t);\n    if (Number.isFinite(v)) field.onChange(Math.min(max, Math.max(min, v)));\n  };\n\n  return (\n    <View style={[styles.row, themeStyle as StyleProp<ViewStyle>, style]}>\n      <View style={styles.line}>\n        <Label>{name}</Label>\n        <TextInput\n          style={styles.num}\n          testID={field.testID ? `${field.testID}.num` : undefined}\n          accessibilityLabel={`${name} value`}\n          value={draft}\n          keyboardType=\"numeric\"\n          editable={!field.disabled}\n          selectTextOnFocus\n          onChangeText={fromText}\n        />\n      </View>\n      <RNSlider\n        style={styles.slider}\n        testID={field.testID}\n        accessibilityLabel={name}\n        minimumValue={min}\n        maximumValue={max}\n        step={step}\n        value={safeSliderValue(value)}\n        disabled={field.disabled}\n        onValueChange={fromSlider}\n        {...SLIDER_TINTS}\n      />\n    </View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  row: { gap: 2 },\n  line: { flexDirection: 'row', justifyContent: 'space-between', alignItems: 'center' },\n  num: {\n    minWidth: 56,\n    color: '#8888ff',\n    fontSize: 12,\n    fontVariant: ['tabular-nums'],\n    textAlign: 'right',\n    paddingVertical: 0,\n    paddingHorizontal: 4,\n    borderWidth: StyleSheet.hairlineWidth,\n    borderColor: 'rgba(136,136,255,0.4)',\n    borderRadius: 3,\n  },\n  slider: { width: '100%', height: 32 },\n});\n"]}

package/dist/src/components/ui/switch.d.ts

@@ -0,0 +1,8 @@
+export type SwitchProps = {
+    /** The uniform key this switch drives (0 = off, 1 = on). */
+    readonly uniform: string;
+    /** Display name; defaults to the uniform key. */
+    readonly label?: string;
+};
+export declare function Switch({ uniform, label }: SwitchProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=switch.d.ts.map

package/dist/src/components/ui/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/switch.tsx"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,WAAW,2CAgBrD","sourcesContent":["// Switch: a self-wiring boolean field for `kind: 'switch'` uniforms (0/1). Reads\n// and writes its uniform via `useField`, the same contract as Slider/ColorPicker.\n\nimport { Switch as RNSwitch, StyleSheet, View } from 'react-native';\nimport { useField } from '../form/use-field';\nimport { Label } from './label';\n\nexport type SwitchProps = {\n  /** The uniform key this switch drives (0 = off, 1 = on). */\n  readonly uniform: string;\n  /** Display name; defaults to the uniform key. */\n  readonly label?: string;\n};\n\nexport function Switch({ uniform, label }: SwitchProps) {\n  const field = useField(uniform);\n  const on = (typeof field.value === 'number' ? field.value : 0) > 0.5;\n  const name = label ?? uniform;\n  return (\n    <View style={styles.row}>\n      <Label>{name}</Label>\n      <RNSwitch\n        testID={field.testID}\n        accessibilityLabel={name}\n        value={on}\n        disabled={field.disabled}\n        onValueChange={(v) => field.onChange(v ? 1 : 0)}\n      />\n    </View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  row: {\n    flexDirection: 'row',\n    justifyContent: 'space-between',\n    alignItems: 'center',\n    paddingVertical: 2,\n  },\n});\n"]}

package/dist/src/components/ui/switch.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Switch = Switch;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// Switch: a self-wiring boolean field for `kind: 'switch'` uniforms (0/1). Reads
+// and writes its uniform via `useField`, the same contract as Slider/ColorPicker.
+const react_native_1 = require("react-native");
+const use_field_1 = require("../form/use-field");
+const label_1 = require("./label");
+function Switch({ uniform, label }) {
+    const field = (0, use_field_1.useField)(uniform);
+    const on = (typeof field.value === 'number' ? field.value : 0) > 0.5;
+    const name = label ?? uniform;
+    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.row, children: [(0, jsx_runtime_1.jsx)(label_1.Label, { children: name }), (0, jsx_runtime_1.jsx)(react_native_1.Switch, { testID: field.testID, accessibilityLabel: name, value: on, disabled: field.disabled, onValueChange: (v) => field.onChange(v ? 1 : 0) })] }));
+}
+const styles = react_native_1.StyleSheet.create({
+    row: {
+        flexDirection: 'row',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+        paddingVertical: 2,
+    },
+});
+//# sourceMappingURL=switch.js.map

package/dist/src/components/ui/switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.js","sourceRoot":"","sources":["../../../../src/components/ui/switch.tsx"],"names":[],"mappings":";;;;AAAA,iFAAiF;AACjF,kFAAkF;AAElF,+CAAoE;AACpE,iDAA6C;AAC7C,mCAAgC;AAShC,gBAAuB,EAAE,OAAO,EAAE,KAAK,EAAe;IACpD,MAAM,KAAK,GAAG,IAAA,oBAAQ,EAAC,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACrE,MAAM,IAAI,GAAG,KAAK,IAAI,OAAO,CAAC;IAC9B,OAAO,CACL,wBAAC,mBAAI,IAAC,KAAK,EAAE,MAAM,CAAC,GAAG,aACrB,uBAAC,aAAK,cAAE,IAAI,GAAS,EACrB,uBAAC,qBAAQ,IACP,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,kBAAkB,EAAE,IAAI,EACxB,KAAK,EAAE,EAAE,EACT,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC/C,IACG,CACR,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,yBAAU,CAAC,MAAM,CAAC;IAC/B,GAAG,EAAE;QACH,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,eAAe;QAC/B,UAAU,EAAE,QAAQ;QACpB,eAAe,EAAE,CAAC;KACnB;CACF,CAAC,CAAC","sourcesContent":["// Switch: a self-wiring boolean field for `kind: 'switch'` uniforms (0/1). Reads\n// and writes its uniform via `useField`, the same contract as Slider/ColorPicker.\n\nimport { Switch as RNSwitch, StyleSheet, View } from 'react-native';\nimport { useField } from '../form/use-field';\nimport { Label } from './label';\n\nexport type SwitchProps = {\n  /** The uniform key this switch drives (0 = off, 1 = on). */\n  readonly uniform: string;\n  /** Display name; defaults to the uniform key. */\n  readonly label?: string;\n};\n\nexport function Switch({ uniform, label }: SwitchProps) {\n  const field = useField(uniform);\n  const on = (typeof field.value === 'number' ? field.value : 0) > 0.5;\n  const name = label ?? uniform;\n  return (\n    <View style={styles.row}>\n      <Label>{name}</Label>\n      <RNSwitch\n        testID={field.testID}\n        accessibilityLabel={name}\n        value={on}\n        disabled={field.disabled}\n        onValueChange={(v) => field.onChange(v ? 1 : 0)}\n      />\n    </View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  row: {\n    flexDirection: 'row',\n    justifyContent: 'space-between',\n    alignItems: 'center',\n    paddingVertical: 2,\n  },\n});\n"]}

package/dist/src/index.d.ts

@@ -0,0 +1,18 @@
+import type { KaleidoscopeBinding, KaleidoscopeBindOptions } from './kaleidoscope/types';
+import type { KaleidoscopePresetBook } from './kaleidoscope.preset-book.types';
+export type { CatalogImageId } from '../catalog/images';
+export type { AnamorphicLensFlareUniforms, BlurUniforms, CloudsUniforms, CorporateBlobsUniforms, FirefliesUniforms, GodraysUniforms, LayerShaderName, LayerShaderOptions, LightBeamsAndMotesUniforms, NebulaUniforms, PatchableShaderName, PlasmaUniforms, ShaderUniformsMap, SimianlightsUniforms, UniformControl, } from '../catalog/shaders';
+export { ANAMORPHIC_LENSFLARE_CONTROLS, BLUR_CONTROLS, CLOUDS_CONTROLS, CORPORATE_BLOBS_CONTROLS, defaultUniforms, FIREFLIES_CONTROLS, GODRAYS_CONTROLS, LIGHT_BEAMS_AND_MOTES_CONTROLS, NEBULA_CONTROLS, PLASMA_CONTROLS, SIMIANLIGHTS_CONTROLS, } from '../catalog/shaders';
+export type { CompositeSpec, EffectInput, EffectName, EffectSpec, TransformName, TransformSpec, } from './kaleidoscope/effect.types';
+export type { KaleidoscopeBinding, KaleidoscopeBindOptions, MaskInput, PatchesFor, PatchFor, TransformInput, } from './kaleidoscope/types';
+export type { KaleidoscopeBlendMode, KaleidoscopeControls, KaleidoscopeLayer, KaleidoscopeLayerTarget, KaleidoscopePreset, KaleidoscopePresetBook, KaleidoscopePresetEntry, KaleidoscopeTaxonomy, } from './kaleidoscope.preset-book.types';
+export type { RGB } from './lib/primitives.types';
+/**
+ * Bind a track and a preset book; get the three verbs back
+ * (`{ kaleidoscope, transform, mask }`). 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.
+ */
+export declare const bindKaleidoscope: <P extends KaleidoscopePresetBook>(track: MediaStreamTrack, options: KaleidoscopeBindOptions<P>) => KaleidoscopeBinding<P>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAqB,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AA6BlG,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,2BAA2B,EAC3B,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,6BAA6B,EAC7B,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,8BAA8B,EAC9B,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AA6JlD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,sBAAsB,SACxD,gBAAgB,WACd,uBAAuB,CAAC,CAAC,CAAC,KAClC,mBAAmB,CAAC,CAAC,CAmBvB,CAAC","sourcesContent":["// Native entry point. Metro picks this up via package.json \"react-native\"\n// and the \".\" subpath export's \"react-native\" condition.\n//\n// Thin facade over `track._setVideoEffects(names)` from react-native-webrtc.\n// Native frame processors are registered at app boot by the Expo Module's\n// OnCreate hook (see android/.../KaleidoscopeModule.kt and ios/.../KaleidoscopeModule.swift);\n// this facade just dispatches into the existing upstream registry.\n\nimport { requireNativeModule } from 'expo-modules-core';\nimport { Platform } from 'react-native';\nimport {\n  createControls,\n  type Reconcile,\n  type ResetLayerUniforms,\n  type SetLayerUniforms,\n  type SetMask,\n} from './kaleidoscope/controls';\nimport { toEffectSpec } from './kaleidoscope/effect';\nimport type { ApplyVideoEffects, CompositeSpec } from './kaleidoscope/effect.types';\nimport type { KaleidoscopeBinding, KaleidoscopeBindOptions } from './kaleidoscope/types';\nimport type { KaleidoscopeLayer, KaleidoscopePresetBook } from './kaleidoscope.preset-book.types';\n\n// The native module's tuning functions. Only the three the JS layer drives are\n// declared: blur sigma (from a blur preset's options) and the mask edge (from\n// the mask() verb). The native module also exposes segmentation/debug/reset\n// functions, but nothing in JS calls them anymore, so they're not declared here.\ninterface KaleidoscopeNativeModule {\n  setMaskHardness: (value: number) => void;\n  setMaskThreshold: (value: number) => void;\n  // KaleidoscopePreset layer-stack channel. Optional: a native build predating the\n  // compositor won't expose it, so callers guard with `?.`. JS sends the active\n  // composite's ordered layer stack as a JSON string; native parses + composites\n  // it. Blur sigma and generative uniforms now ride inside each layer's\n  // `uniforms`, so there is no separate setBlurSigma/setShaderUniforms channel.\n  setCompositeLayers?: (json: string) => void;\n}\n\n// Lazy because the module is not available during pure-JS tests; the\n// getter throws if you call a setter outside a real native runtime, which\n// is the right failure mode.\nconst nativeModule = (): KaleidoscopeNativeModule =>\n  requireNativeModule<KaleidoscopeNativeModule>('RnWebrtcKaleidoscope');\n\n// The native tuning functions (setMaskHardness / setMaskThreshold) remain on the\n// native module and are called internally: the mask edge flows from the mask()\n// verb (see bindKaleidoscope). The composite layer stack flows through\n// setCompositeLayers. The old global set* JS exports are gone; effects are driven by\n// kaleidoscope / transform / mask, not loose setters.\n\nexport type { CatalogImageId } from '../catalog/images';\nexport type {\n  AnamorphicLensFlareUniforms,\n  BlurUniforms,\n  CloudsUniforms,\n  CorporateBlobsUniforms,\n  FirefliesUniforms,\n  GodraysUniforms,\n  LayerShaderName,\n  LayerShaderOptions,\n  LightBeamsAndMotesUniforms,\n  NebulaUniforms,\n  PatchableShaderName,\n  PlasmaUniforms,\n  ShaderUniformsMap,\n  SimianlightsUniforms,\n  UniformControl,\n} from '../catalog/shaders';\n// Per-shader control descriptors (platform-agnostic data). Imported individually\n// per the shader a preset's layer uses; there is no all-shaders aggregate.\nexport {\n  ANAMORPHIC_LENSFLARE_CONTROLS,\n  BLUR_CONTROLS,\n  CLOUDS_CONTROLS,\n  CORPORATE_BLOBS_CONTROLS,\n  defaultUniforms,\n  FIREFLIES_CONTROLS,\n  GODRAYS_CONTROLS,\n  LIGHT_BEAMS_AND_MOTES_CONTROLS,\n  NEBULA_CONTROLS,\n  PLASMA_CONTROLS,\n  SIMIANLIGHTS_CONTROLS,\n} from '../catalog/shaders';\nexport type {\n  CompositeSpec,\n  EffectInput,\n  EffectName,\n  EffectSpec,\n  TransformName,\n  TransformSpec,\n} from './kaleidoscope/effect.types';\nexport type {\n  KaleidoscopeBinding,\n  KaleidoscopeBindOptions,\n  MaskInput,\n  PatchesFor,\n  PatchFor,\n  TransformInput,\n} from './kaleidoscope/types';\nexport type {\n  KaleidoscopeBlendMode,\n  KaleidoscopeControls,\n  KaleidoscopeLayer,\n  KaleidoscopeLayerTarget,\n  KaleidoscopePreset,\n  KaleidoscopePresetBook,\n  KaleidoscopePresetEntry,\n  KaleidoscopeTaxonomy,\n} from './kaleidoscope.preset-book.types';\nexport type { RGB } from './lib/primitives.types';\n\ninterface WebRTCTrackExtensions {\n  remote?: boolean;\n  // Upstream's typed signature is `string[]`, but the platforms diverge on\n  // how to clear effects:\n  //   - Android: passing `null` takes the\n  //     `videoSource.setVideoProcessor(null)` branch (the only correct clear\n  //     path); passing `[]` crashes EglRenderer.\n  //   - iOS: the Obj-C method declares `names` as `nonnull NSArray<NSString *>`,\n  //     so `null` violates the bridge contract; `[]` is the supported clear\n  //     value (iOS's `VideoEffectProcessor` with no processors is a\n  //     passthrough).\n  // We type the parameter as the union so the facade can platform-split at\n  // the call site. See `applyVideoEffects` below.\n  _setVideoEffects?: (names: ReadonlyArray<string> | null) => void;\n}\n\n// Effect names registered native-side in Registration.kt / Registration.swift.\n// Anything not in this list gets filtered out before reaching upstream,\n// because rn-webrtc's setVideoEffects calls ProcessorProvider.getProcessor()\n// and filters nulls into an empty list, which then hits the\n// VideoEffectProcessor empty-processors-list bug (refcount goes negative,\n// EglRenderer crashes one frame later). Dropping an unregistered name here is\n// the safe behavior.\n//\n// The art axis is now one registered \"composite\" compositor: blur, images, and\n// generative shaders are all layers inside it, delivered out-of-band via\n// setCompositeLayers. The four geometric transform ops share one native processor\n// per platform (TransformFactory on Android, TransformProcessor on iOS); each is\n// a flat name. iOS registers the same set via ios/.../Registration.swift.\nconst TRANSFORM_EFFECTS: readonly string[] = ['flip-x', 'flip-y', 'rotate-cw', 'rotate-ccw'];\n\n// Android (Registration.kt) and iOS (Registration.swift) install an identical\n// effect set, so one list covers both natives. If the platforms ever diverge,\n// split this back into per-platform lists keyed off Platform.OS.\nconst NATIVE_REGISTERED_EFFECTS_LIST: readonly string[] = [...TRANSFORM_EFFECTS, 'composite'];\n\nconst registeredForPlatform = (): readonly string[] =>\n  Platform.OS === 'android' || Platform.OS === 'ios' ? NATIVE_REGISTERED_EFFECTS_LIST : [];\n\nconst NATIVE_REGISTERED_EFFECTS: ReadonlySet<string> = new Set(registeredForPlatform());\n\n// Serialize a composite's layer stack to the JSON shape the native CompositeLayers\n// channel parses: an array of { id, shader, target, blend?, source?, uniforms? }.\n// Every layer carries its `id`. An `image` layer's native `source` IS its `id`\n// (the bundled WebP basename the prebuild plugin copied under that name); all\n// other layers carry their uniforms.\nconst serializeCompositeLayers = (layers: ReadonlyArray<KaleidoscopeLayer>): string => {\n  const wire = layers.map((layer) => {\n    const base: Record<string, unknown> = {\n      id: layer.id,\n      shader: layer.shader,\n      target: layer.target ?? 'background',\n    };\n    if (layer.blend != null) base.blend = layer.blend;\n    if (layer.shader === 'image') {\n      // The layer id is the image id (the bundled WebP basename); the native\n      // compositor resolves assets/images/<id>.webp from it.\n      base.source = layer.id;\n    } else if ('uniforms' in layer) {\n      base.uniforms = layer.uniforms;\n    }\n    return base;\n  });\n  return JSON.stringify(wire);\n};\n\nconst specToNativeName = (spec: ReturnType<typeof toEffectSpec>): string => {\n  // The composite runs through the single registered \"composite\" compositor; its\n  // layer stack is delivered out-of-band via setCompositeLayers (see applyVideoEffects).\n  if (spec.name === 'composite') {\n    return 'composite';\n  }\n  return spec.name;\n};\n\n// Last effect set applied to each track, as a stable signature. Used to skip\n// redundant native calls: rn-webrtc rebuilds the native frame processors on\n// EVERY _setVideoEffects call (Android constructs a fresh processor per call),\n// so re-issuing an unchanged set (a React re-render, an idempotent effect\n// hook) churns GL + segmentation resources for no reason. The WeakMap lets the\n// entry be collected when the track is.\nconst lastAppliedSignatureByTrack = new WeakMap<object, string>();\n\n// The lower-level native primitive: route a spec array through the upstream\n// `_setVideoEffects`. Internal now (the public surface is the three verbs);\n// `bindKaleidoscope`'s reconcile drives it.\nconst applyVideoEffects: ApplyVideoEffects = (track, effects) => {\n  const t = track as MediaStreamTrack & WebRTCTrackExtensions;\n  if (t.remote) {\n    throw new Error('kaleidoscope: cannot apply effects to remote tracks');\n  }\n  if (typeof t._setVideoEffects !== 'function') {\n    throw new Error(\n      'kaleidoscope: track has no _setVideoEffects method (is react-native-webrtc >=124 installed?)',\n    );\n  }\n  const specs = effects.map(toEffectSpec);\n  // Deliver the composite's layer stack out-of-band before the \"composite\" name\n  // is dispatched. Blur sigma and generative uniforms ride inside each layer's\n  // `uniforms`. Guarded: a native build without the compositor lacks the function\n  // (and drops the \"composite\" name below if not registered).\n  for (const spec of specs) {\n    if (spec.name === 'composite') {\n      nativeModule().setCompositeLayers?.(serializeCompositeLayers((spec as CompositeSpec).layers));\n    }\n  }\n  // The composite name is book-driven: the prebuild copied the images and native\n  // registration installed the one \"composite\" compositor, so it passes the\n  // crash-guard. Transforms must be in the static set (always are).\n  const mapped = specs.map((spec) => ({\n    name: specToNativeName(spec),\n    trusted: spec.name === 'composite',\n  }));\n  const names = mapped\n    .filter((m) => m.trusted || NATIVE_REGISTERED_EFFECTS.has(m.name))\n    .map((m) => m.name);\n\n  // Dedup against the last set applied to this track. Order is significant\n  // (effects chain in array order), so the signature preserves it. Skip the\n  // native call when nothing changed; the first call for any given set always\n  // proceeds (no prior entry).\n  const signature = names.join('\\n');\n  if (lastAppliedSignatureByTrack.get(track) === signature) {\n    return track;\n  }\n  lastAppliedSignatureByTrack.set(track, signature);\n\n  const dropped = mapped\n    .filter((m) => !m.trusted && !NATIVE_REGISTERED_EFFECTS.has(m.name))\n    .map((m) => m.name);\n  if (dropped.length > 0) {\n    console.warn(\n      `kaleidoscope: dropping effects not registered on this native platform: ${dropped.join(', ')}. ` +\n        'Web has its own registry; this is a native-only filter.',\n    );\n  }\n  // Platforms diverge on how to clear effects:\n  //   - Android: rn-webrtc 124 has a bug where passing `[]` installs a\n  //     VideoEffectProcessor with an empty processors list, whose\n  //     onFrameCaptured then double-releases the input frame (retain once,\n  //     release twice) and crashes EglRenderer one frame later. The only\n  //     correct clear is `null`, which takes the upstream else-branch that\n  //     resets the processor via `videoSource.setVideoProcessor(null)`.\n  //   - iOS: the upstream Obj-C `_setVideoEffects` method declares\n  //     `names` as `(nonnull NSArray<NSString *> *)`, so passing `null`\n  //     violates the React Native bridge's nonnull contract. The supported\n  //     clear value is `[]`, which iOS's VideoEffectProcessor treats as a\n  //     passthrough (no double-release bug on this platform).\n  // The explicit type annotation is required; without it TS widens the\n  // empty-array literal to `never[] | null`.\n  const clearValue: ReadonlyArray<string> | null = Platform.OS === 'ios' ? [] : null;\n  t._setVideoEffects(names.length === 0 ? clearValue : names);\n  return track;\n};\n\n/**\n * Bind a track and a preset book; get the three verbs back\n * (`{ kaleidoscope, transform, mask }`). On native the track is mutated in\n * place, so `controls.track` is the bound track and `onTrack` fires with it\n * after each `kaleidoscope` preset switch and `transform` command. `mask`\n * updates the segmentation edge the per-frame processors read.\n */\nexport const bindKaleidoscope = <P extends KaleidoscopePresetBook>(\n  track: MediaStreamTrack,\n  options: KaleidoscopeBindOptions<P>,\n): KaleidoscopeBinding<P> => {\n  const reconcile: Reconcile = {\n    apply: (specs) => applyVideoEffects(track, specs),\n    dispose: () => {},\n  };\n  const setMask: SetMask = (hardness, threshold) => {\n    nativeModule().setMaskHardness(hardness);\n    nativeModule().setMaskThreshold(threshold);\n  };\n  // Native has no live per-layer uniform channel yet (Phase B): a patch of the\n  // active preset is a no-op here, so the verb's patch path is inert on native\n  // until the compositor reads layer-id-keyed overrides. The verb still drives\n  // preset switches through reconcile.\n  const setLayerUniforms: SetLayerUniforms = () => {};\n  // Native re-sends the full layer stack (with baked uniforms) on every preset\n  // switch via setCompositeLayers, so there is no stale override to clear; no-op for\n  // parity with the inert setLayerUniforms above.\n  const resetLayerUniforms: ResetLayerUniforms = () => {};\n  return createControls(track, options, reconcile, setMask, setLayerUniforms, resetLayerUniforms);\n};\n"]}

package/dist/src/index.js

@@ -0,0 +1,187 @@
+"use strict";
+// Native entry point. Metro picks this up via package.json "react-native"
+// and the "." subpath export's "react-native" condition.
+//
+// Thin facade over `track._setVideoEffects(names)` from react-native-webrtc.
+// Native frame processors are registered at app boot by the Expo Module's
+// OnCreate hook (see android/.../KaleidoscopeModule.kt and ios/.../KaleidoscopeModule.swift);
+// this facade just dispatches into the existing upstream registry.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindKaleidoscope = exports.SIMIANLIGHTS_CONTROLS = exports.PLASMA_CONTROLS = exports.NEBULA_CONTROLS = exports.LIGHT_BEAMS_AND_MOTES_CONTROLS = exports.GODRAYS_CONTROLS = exports.FIREFLIES_CONTROLS = exports.defaultUniforms = exports.CORPORATE_BLOBS_CONTROLS = exports.CLOUDS_CONTROLS = exports.BLUR_CONTROLS = exports.ANAMORPHIC_LENSFLARE_CONTROLS = void 0;
+const expo_modules_core_1 = require("expo-modules-core");
+const react_native_1 = require("react-native");
+const controls_1 = require("./kaleidoscope/controls");
+const effect_1 = require("./kaleidoscope/effect");
+// Lazy because the module is not available during pure-JS tests; the
+// getter throws if you call a setter outside a real native runtime, which
+// is the right failure mode.
+const nativeModule = () => (0, expo_modules_core_1.requireNativeModule)('RnWebrtcKaleidoscope');
+// Per-shader control descriptors (platform-agnostic data). Imported individually
+// per the shader a preset's layer uses; there is no all-shaders aggregate.
+var shaders_1 = require("../catalog/shaders");
+Object.defineProperty(exports, "ANAMORPHIC_LENSFLARE_CONTROLS", { enumerable: true, get: function () { return shaders_1.ANAMORPHIC_LENSFLARE_CONTROLS; } });
+Object.defineProperty(exports, "BLUR_CONTROLS", { enumerable: true, get: function () { return shaders_1.BLUR_CONTROLS; } });
+Object.defineProperty(exports, "CLOUDS_CONTROLS", { enumerable: true, get: function () { return shaders_1.CLOUDS_CONTROLS; } });
+Object.defineProperty(exports, "CORPORATE_BLOBS_CONTROLS", { enumerable: true, get: function () { return shaders_1.CORPORATE_BLOBS_CONTROLS; } });
+Object.defineProperty(exports, "defaultUniforms", { enumerable: true, get: function () { return shaders_1.defaultUniforms; } });
+Object.defineProperty(exports, "FIREFLIES_CONTROLS", { enumerable: true, get: function () { return shaders_1.FIREFLIES_CONTROLS; } });
+Object.defineProperty(exports, "GODRAYS_CONTROLS", { enumerable: true, get: function () { return shaders_1.GODRAYS_CONTROLS; } });
+Object.defineProperty(exports, "LIGHT_BEAMS_AND_MOTES_CONTROLS", { enumerable: true, get: function () { return shaders_1.LIGHT_BEAMS_AND_MOTES_CONTROLS; } });
+Object.defineProperty(exports, "NEBULA_CONTROLS", { enumerable: true, get: function () { return shaders_1.NEBULA_CONTROLS; } });
+Object.defineProperty(exports, "PLASMA_CONTROLS", { enumerable: true, get: function () { return shaders_1.PLASMA_CONTROLS; } });
+Object.defineProperty(exports, "SIMIANLIGHTS_CONTROLS", { enumerable: true, get: function () { return shaders_1.SIMIANLIGHTS_CONTROLS; } });
+// Effect names registered native-side in Registration.kt / Registration.swift.
+// Anything not in this list gets filtered out before reaching upstream,
+// because rn-webrtc's setVideoEffects calls ProcessorProvider.getProcessor()
+// and filters nulls into an empty list, which then hits the
+// VideoEffectProcessor empty-processors-list bug (refcount goes negative,
+// EglRenderer crashes one frame later). Dropping an unregistered name here is
+// the safe behavior.
+//
+// The art axis is now one registered "composite" compositor: blur, images, and
+// generative shaders are all layers inside it, delivered out-of-band via
+// setCompositeLayers. The four geometric transform ops share one native processor
+// per platform (TransformFactory on Android, TransformProcessor on iOS); each is
+// a flat name. iOS registers the same set via ios/.../Registration.swift.
+const TRANSFORM_EFFECTS = ['flip-x', 'flip-y', 'rotate-cw', 'rotate-ccw'];
+// Android (Registration.kt) and iOS (Registration.swift) install an identical
+// effect set, so one list covers both natives. If the platforms ever diverge,
+// split this back into per-platform lists keyed off Platform.OS.
+const NATIVE_REGISTERED_EFFECTS_LIST = [...TRANSFORM_EFFECTS, 'composite'];
+const registeredForPlatform = () => react_native_1.Platform.OS === 'android' || react_native_1.Platform.OS === 'ios' ? NATIVE_REGISTERED_EFFECTS_LIST : [];
+const NATIVE_REGISTERED_EFFECTS = new Set(registeredForPlatform());
+// Serialize a composite's layer stack to the JSON shape the native CompositeLayers
+// channel parses: an array of { id, shader, target, blend?, source?, uniforms? }.
+// Every layer carries its `id`. An `image` layer's native `source` IS its `id`
+// (the bundled WebP basename the prebuild plugin copied under that name); all
+// other layers carry their uniforms.
+const serializeCompositeLayers = (layers) => {
+    const wire = layers.map((layer) => {
+        const base = {
+            id: layer.id,
+            shader: layer.shader,
+            target: layer.target ?? 'background',
+        };
+        if (layer.blend != null)
+            base.blend = layer.blend;
+        if (layer.shader === 'image') {
+            // The layer id is the image id (the bundled WebP basename); the native
+            // compositor resolves assets/images/<id>.webp from it.
+            base.source = layer.id;
+        }
+        else if ('uniforms' in layer) {
+            base.uniforms = layer.uniforms;
+        }
+        return base;
+    });
+    return JSON.stringify(wire);
+};
+const specToNativeName = (spec) => {
+    // The composite runs through the single registered "composite" compositor; its
+    // layer stack is delivered out-of-band via setCompositeLayers (see applyVideoEffects).
+    if (spec.name === 'composite') {
+        return 'composite';
+    }
+    return spec.name;
+};
+// Last effect set applied to each track, as a stable signature. Used to skip
+// redundant native calls: rn-webrtc rebuilds the native frame processors on
+// EVERY _setVideoEffects call (Android constructs a fresh processor per call),
+// so re-issuing an unchanged set (a React re-render, an idempotent effect
+// hook) churns GL + segmentation resources for no reason. The WeakMap lets the
+// entry be collected when the track is.
+const lastAppliedSignatureByTrack = new WeakMap();
+// The lower-level native primitive: route a spec array through the upstream
+// `_setVideoEffects`. Internal now (the public surface is the three verbs);
+// `bindKaleidoscope`'s reconcile drives it.
+const applyVideoEffects = (track, effects) => {
+    const t = track;
+    if (t.remote) {
+        throw new Error('kaleidoscope: cannot apply effects to remote tracks');
+    }
+    if (typeof t._setVideoEffects !== 'function') {
+        throw new Error('kaleidoscope: track has no _setVideoEffects method (is react-native-webrtc >=124 installed?)');
+    }
+    const specs = effects.map(effect_1.toEffectSpec);
+    // Deliver the composite's layer stack out-of-band before the "composite" name
+    // is dispatched. Blur sigma and generative uniforms ride inside each layer's
+    // `uniforms`. Guarded: a native build without the compositor lacks the function
+    // (and drops the "composite" name below if not registered).
+    for (const spec of specs) {
+        if (spec.name === 'composite') {
+            nativeModule().setCompositeLayers?.(serializeCompositeLayers(spec.layers));
+        }
+    }
+    // The composite name is book-driven: the prebuild copied the images and native
+    // registration installed the one "composite" compositor, so it passes the
+    // crash-guard. Transforms must be in the static set (always are).
+    const mapped = specs.map((spec) => ({
+        name: specToNativeName(spec),
+        trusted: spec.name === 'composite',
+    }));
+    const names = mapped
+        .filter((m) => m.trusted || NATIVE_REGISTERED_EFFECTS.has(m.name))
+        .map((m) => m.name);
+    // Dedup against the last set applied to this track. Order is significant
+    // (effects chain in array order), so the signature preserves it. Skip the
+    // native call when nothing changed; the first call for any given set always
+    // proceeds (no prior entry).
+    const signature = names.join('\n');
+    if (lastAppliedSignatureByTrack.get(track) === signature) {
+        return track;
+    }
+    lastAppliedSignatureByTrack.set(track, signature);
+    const dropped = mapped
+        .filter((m) => !m.trusted && !NATIVE_REGISTERED_EFFECTS.has(m.name))
+        .map((m) => m.name);
+    if (dropped.length > 0) {
+        console.warn(`kaleidoscope: dropping effects not registered on this native platform: ${dropped.join(', ')}. ` +
+            'Web has its own registry; this is a native-only filter.');
+    }
+    // Platforms diverge on how to clear effects:
+    //   - Android: rn-webrtc 124 has a bug where passing `[]` installs a
+    //     VideoEffectProcessor with an empty processors list, whose
+    //     onFrameCaptured then double-releases the input frame (retain once,
+    //     release twice) and crashes EglRenderer one frame later. The only
+    //     correct clear is `null`, which takes the upstream else-branch that
+    //     resets the processor via `videoSource.setVideoProcessor(null)`.
+    //   - iOS: the upstream Obj-C `_setVideoEffects` method declares
+    //     `names` as `(nonnull NSArray<NSString *> *)`, so passing `null`
+    //     violates the React Native bridge's nonnull contract. The supported
+    //     clear value is `[]`, which iOS's VideoEffectProcessor treats as a
+    //     passthrough (no double-release bug on this platform).
+    // The explicit type annotation is required; without it TS widens the
+    // empty-array literal to `never[] | null`.
+    const clearValue = react_native_1.Platform.OS === 'ios' ? [] : null;
+    t._setVideoEffects(names.length === 0 ? clearValue : names);
+    return track;
+};
+/**
+ * Bind a track and a preset book; get the three verbs back
+ * (`{ kaleidoscope, transform, mask }`). 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.
+ */
+const bindKaleidoscope = (track, options) => {
+    const reconcile = {
+        apply: (specs) => applyVideoEffects(track, specs),
+        dispose: () => { },
+    };
+    const setMask = (hardness, threshold) => {
+        nativeModule().setMaskHardness(hardness);
+        nativeModule().setMaskThreshold(threshold);
+    };
+    // Native has no live per-layer uniform channel yet (Phase B): a patch of the
+    // active preset is a no-op here, so the verb's patch path is inert on native
+    // until the compositor reads layer-id-keyed overrides. The verb still drives
+    // preset switches through reconcile.
+    const setLayerUniforms = () => { };
+    // Native re-sends the full layer stack (with baked uniforms) on every preset
+    // switch via setCompositeLayers, so there is no stale override to clear; no-op for
+    // parity with the inert setLayerUniforms above.
+    const resetLayerUniforms = () => { };
+    return (0, controls_1.createControls)(track, options, reconcile, setMask, setLayerUniforms, resetLayerUniforms);
+};
+exports.bindKaleidoscope = bindKaleidoscope;
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,0EAA0E;AAC1E,yDAAyD;AACzD,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,8FAA8F;AAC9F,mEAAmE;;;AAEnE,yDAAwD;AACxD,+CAAwC;AACxC,sDAMiC;AACjC,kDAAqD;AAoBrD,qEAAqE;AACrE,0EAA0E;AAC1E,6BAA6B;AAC7B,MAAM,YAAY,GAAG,GAA6B,EAAE,CAClD,IAAA,uCAAmB,EAA2B,sBAAsB,CAAC,CAAC;AA0BxE,iFAAiF;AACjF,2EAA2E;AAC3E,8CAY4B;AAX1B,wHAAA,6BAA6B,OAAA;AAC7B,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AACf,mHAAA,wBAAwB,OAAA;AACxB,0GAAA,eAAe,OAAA;AACf,6GAAA,kBAAkB,OAAA;AAClB,2GAAA,gBAAgB,OAAA;AAChB,yHAAA,8BAA8B,OAAA;AAC9B,0GAAA,eAAe,OAAA;AACf,0GAAA,eAAe,OAAA;AACf,gHAAA,qBAAqB,OAAA;AA8CvB,+EAA+E;AAC/E,wEAAwE;AACxE,6EAA6E;AAC7E,4DAA4D;AAC5D,0EAA0E;AAC1E,8EAA8E;AAC9E,qBAAqB;AACrB,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,kFAAkF;AAClF,iFAAiF;AACjF,0EAA0E;AAC1E,MAAM,iBAAiB,GAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAE7F,8EAA8E;AAC9E,8EAA8E;AAC9E,iEAAiE;AACjE,MAAM,8BAA8B,GAAsB,CAAC,GAAG,iBAAiB,EAAE,WAAW,CAAC,CAAC;AAE9F,MAAM,qBAAqB,GAAG,GAAsB,EAAE,CACpD,uBAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,uBAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,CAAC;AAE3F,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAExF,mFAAmF;AACnF,kFAAkF;AAClF,+EAA+E;AAC/E,8EAA8E;AAC9E,qCAAqC;AACrC,MAAM,wBAAwB,GAAG,CAAC,MAAwC,EAAU,EAAE;IACpF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,MAAM,IAAI,GAA4B;YACpC,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,YAAY;SACrC,CAAC;QACF,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClD,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC7B,uEAAuE;YACvE,uDAAuD;YACvD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC;QACzB,CAAC;aAAM,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,IAAqC,EAAU,EAAE;IACzE,+EAA+E;IAC/E,uFAAuF;IACvF,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC,CAAC;AAEF,6EAA6E;AAC7E,4EAA4E;AAC5E,+EAA+E;AAC/E,0EAA0E;AAC1E,+EAA+E;AAC/E,wCAAwC;AACxC,MAAM,2BAA2B,GAAG,IAAI,OAAO,EAAkB,CAAC;AAElE,4EAA4E;AAC5E,4EAA4E;AAC5E,4CAA4C;AAC5C,MAAM,iBAAiB,GAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IAC9D,MAAM,CAAC,GAAG,KAAiD,CAAC;IAC5D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,8FAA8F,CAC/F,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAY,CAAC,CAAC;IACxC,8EAA8E;IAC9E,6EAA6E;IAC7E,gFAAgF;IAChF,4DAA4D;IAC5D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9B,YAAY,EAAE,CAAC,kBAAkB,EAAE,CAAC,wBAAwB,CAAE,IAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IACD,+EAA+E;IAC/E,0EAA0E;IAC1E,kEAAkE;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;QAC5B,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,WAAW;KACnC,CAAC,CAAC,CAAC;IACJ,MAAM,KAAK,GAAG,MAAM;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEtB,yEAAyE;IACzE,0EAA0E;IAC1E,4EAA4E;IAC5E,6BAA6B;IAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,2BAA2B,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,MAAM;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACnE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CACV,0EAA0E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC9F,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IACD,6CAA6C;IAC7C,qEAAqE;IACrE,gEAAgE;IAChE,yEAAyE;IACzE,uEAAuE;IACvE,yEAAyE;IACzE,sEAAsE;IACtE,iEAAiE;IACjE,sEAAsE;IACtE,yEAAyE;IACzE,wEAAwE;IACxE,4DAA4D;IAC5D,qEAAqE;IACrE,2CAA2C;IAC3C,MAAM,UAAU,GAAiC,uBAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACnF,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,CAC9B,KAAuB,EACvB,OAAmC,EACX,EAAE;IAC1B,MAAM,SAAS,GAAc;QAC3B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC;QACjD,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;KAClB,CAAC;IACF,MAAM,OAAO,GAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE;QAC/C,YAAY,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACzC,YAAY,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC,CAAC;IACF,6EAA6E;IAC7E,6EAA6E;IAC7E,6EAA6E;IAC7E,qCAAqC;IACrC,MAAM,gBAAgB,GAAqB,GAAG,EAAE,GAAE,CAAC,CAAC;IACpD,6EAA6E;IAC7E,mFAAmF;IACnF,gDAAgD;IAChD,MAAM,kBAAkB,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAC;IACxD,OAAO,IAAA,yBAAc,EAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;AAClG,CAAC,CAAC;AAtBW,QAAA,gBAAgB,GAAhB,gBAAgB,CAsB3B","sourcesContent":["// Native entry point. Metro picks this up via package.json \"react-native\"\n// and the \".\" subpath export's \"react-native\" condition.\n//\n// Thin facade over `track._setVideoEffects(names)` from react-native-webrtc.\n// Native frame processors are registered at app boot by the Expo Module's\n// OnCreate hook (see android/.../KaleidoscopeModule.kt and ios/.../KaleidoscopeModule.swift);\n// this facade just dispatches into the existing upstream registry.\n\nimport { requireNativeModule } from 'expo-modules-core';\nimport { Platform } from 'react-native';\nimport {\n  createControls,\n  type Reconcile,\n  type ResetLayerUniforms,\n  type SetLayerUniforms,\n  type SetMask,\n} from './kaleidoscope/controls';\nimport { toEffectSpec } from './kaleidoscope/effect';\nimport type { ApplyVideoEffects, CompositeSpec } from './kaleidoscope/effect.types';\nimport type { KaleidoscopeBinding, KaleidoscopeBindOptions } from './kaleidoscope/types';\nimport type { KaleidoscopeLayer, KaleidoscopePresetBook } from './kaleidoscope.preset-book.types';\n\n// The native module's tuning functions. Only the three the JS layer drives are\n// declared: blur sigma (from a blur preset's options) and the mask edge (from\n// the mask() verb). The native module also exposes segmentation/debug/reset\n// functions, but nothing in JS calls them anymore, so they're not declared here.\ninterface KaleidoscopeNativeModule {\n  setMaskHardness: (value: number) => void;\n  setMaskThreshold: (value: number) => void;\n  // KaleidoscopePreset layer-stack channel. Optional: a native build predating the\n  // compositor won't expose it, so callers guard with `?.`. JS sends the active\n  // composite's ordered layer stack as a JSON string; native parses + composites\n  // it. Blur sigma and generative uniforms now ride inside each layer's\n  // `uniforms`, so there is no separate setBlurSigma/setShaderUniforms channel.\n  setCompositeLayers?: (json: string) => void;\n}\n\n// Lazy because the module is not available during pure-JS tests; the\n// getter throws if you call a setter outside a real native runtime, which\n// is the right failure mode.\nconst nativeModule = (): KaleidoscopeNativeModule =>\n  requireNativeModule<KaleidoscopeNativeModule>('RnWebrtcKaleidoscope');\n\n// The native tuning functions (setMaskHardness / setMaskThreshold) remain on the\n// native module and are called internally: the mask edge flows from the mask()\n// verb (see bindKaleidoscope). The composite layer stack flows through\n// setCompositeLayers. The old global set* JS exports are gone; effects are driven by\n// kaleidoscope / transform / mask, not loose setters.\n\nexport type { CatalogImageId } from '../catalog/images';\nexport type {\n  AnamorphicLensFlareUniforms,\n  BlurUniforms,\n  CloudsUniforms,\n  CorporateBlobsUniforms,\n  FirefliesUniforms,\n  GodraysUniforms,\n  LayerShaderName,\n  LayerShaderOptions,\n  LightBeamsAndMotesUniforms,\n  NebulaUniforms,\n  PatchableShaderName,\n  PlasmaUniforms,\n  ShaderUniformsMap,\n  SimianlightsUniforms,\n  UniformControl,\n} from '../catalog/shaders';\n// Per-shader control descriptors (platform-agnostic data). Imported individually\n// per the shader a preset's layer uses; there is no all-shaders aggregate.\nexport {\n  ANAMORPHIC_LENSFLARE_CONTROLS,\n  BLUR_CONTROLS,\n  CLOUDS_CONTROLS,\n  CORPORATE_BLOBS_CONTROLS,\n  defaultUniforms,\n  FIREFLIES_CONTROLS,\n  GODRAYS_CONTROLS,\n  LIGHT_BEAMS_AND_MOTES_CONTROLS,\n  NEBULA_CONTROLS,\n  PLASMA_CONTROLS,\n  SIMIANLIGHTS_CONTROLS,\n} from '../catalog/shaders';\nexport type {\n  CompositeSpec,\n  EffectInput,\n  EffectName,\n  EffectSpec,\n  TransformName,\n  TransformSpec,\n} from './kaleidoscope/effect.types';\nexport type {\n  KaleidoscopeBinding,\n  KaleidoscopeBindOptions,\n  MaskInput,\n  PatchesFor,\n  PatchFor,\n  TransformInput,\n} from './kaleidoscope/types';\nexport type {\n  KaleidoscopeBlendMode,\n  KaleidoscopeControls,\n  KaleidoscopeLayer,\n  KaleidoscopeLayerTarget,\n  KaleidoscopePreset,\n  KaleidoscopePresetBook,\n  KaleidoscopePresetEntry,\n  KaleidoscopeTaxonomy,\n} from './kaleidoscope.preset-book.types';\nexport type { RGB } from './lib/primitives.types';\n\ninterface WebRTCTrackExtensions {\n  remote?: boolean;\n  // Upstream's typed signature is `string[]`, but the platforms diverge on\n  // how to clear effects:\n  //   - Android: passing `null` takes the\n  //     `videoSource.setVideoProcessor(null)` branch (the only correct clear\n  //     path); passing `[]` crashes EglRenderer.\n  //   - iOS: the Obj-C method declares `names` as `nonnull NSArray<NSString *>`,\n  //     so `null` violates the bridge contract; `[]` is the supported clear\n  //     value (iOS's `VideoEffectProcessor` with no processors is a\n  //     passthrough).\n  // We type the parameter as the union so the facade can platform-split at\n  // the call site. See `applyVideoEffects` below.\n  _setVideoEffects?: (names: ReadonlyArray<string> | null) => void;\n}\n\n// Effect names registered native-side in Registration.kt / Registration.swift.\n// Anything not in this list gets filtered out before reaching upstream,\n// because rn-webrtc's setVideoEffects calls ProcessorProvider.getProcessor()\n// and filters nulls into an empty list, which then hits the\n// VideoEffectProcessor empty-processors-list bug (refcount goes negative,\n// EglRenderer crashes one frame later). Dropping an unregistered name here is\n// the safe behavior.\n//\n// The art axis is now one registered \"composite\" compositor: blur, images, and\n// generative shaders are all layers inside it, delivered out-of-band via\n// setCompositeLayers. The four geometric transform ops share one native processor\n// per platform (TransformFactory on Android, TransformProcessor on iOS); each is\n// a flat name. iOS registers the same set via ios/.../Registration.swift.\nconst TRANSFORM_EFFECTS: readonly string[] = ['flip-x', 'flip-y', 'rotate-cw', 'rotate-ccw'];\n\n// Android (Registration.kt) and iOS (Registration.swift) install an identical\n// effect set, so one list covers both natives. If the platforms ever diverge,\n// split this back into per-platform lists keyed off Platform.OS.\nconst NATIVE_REGISTERED_EFFECTS_LIST: readonly string[] = [...TRANSFORM_EFFECTS, 'composite'];\n\nconst registeredForPlatform = (): readonly string[] =>\n  Platform.OS === 'android' || Platform.OS === 'ios' ? NATIVE_REGISTERED_EFFECTS_LIST : [];\n\nconst NATIVE_REGISTERED_EFFECTS: ReadonlySet<string> = new Set(registeredForPlatform());\n\n// Serialize a composite's layer stack to the JSON shape the native CompositeLayers\n// channel parses: an array of { id, shader, target, blend?, source?, uniforms? }.\n// Every layer carries its `id`. An `image` layer's native `source` IS its `id`\n// (the bundled WebP basename the prebuild plugin copied under that name); all\n// other layers carry their uniforms.\nconst serializeCompositeLayers = (layers: ReadonlyArray<KaleidoscopeLayer>): string => {\n  const wire = layers.map((layer) => {\n    const base: Record<string, unknown> = {\n      id: layer.id,\n      shader: layer.shader,\n      target: layer.target ?? 'background',\n    };\n    if (layer.blend != null) base.blend = layer.blend;\n    if (layer.shader === 'image') {\n      // The layer id is the image id (the bundled WebP basename); the native\n      // compositor resolves assets/images/<id>.webp from it.\n      base.source = layer.id;\n    } else if ('uniforms' in layer) {\n      base.uniforms = layer.uniforms;\n    }\n    return base;\n  });\n  return JSON.stringify(wire);\n};\n\nconst specToNativeName = (spec: ReturnType<typeof toEffectSpec>): string => {\n  // The composite runs through the single registered \"composite\" compositor; its\n  // layer stack is delivered out-of-band via setCompositeLayers (see applyVideoEffects).\n  if (spec.name === 'composite') {\n    return 'composite';\n  }\n  return spec.name;\n};\n\n// Last effect set applied to each track, as a stable signature. Used to skip\n// redundant native calls: rn-webrtc rebuilds the native frame processors on\n// EVERY _setVideoEffects call (Android constructs a fresh processor per call),\n// so re-issuing an unchanged set (a React re-render, an idempotent effect\n// hook) churns GL + segmentation resources for no reason. The WeakMap lets the\n// entry be collected when the track is.\nconst lastAppliedSignatureByTrack = new WeakMap<object, string>();\n\n// The lower-level native primitive: route a spec array through the upstream\n// `_setVideoEffects`. Internal now (the public surface is the three verbs);\n// `bindKaleidoscope`'s reconcile drives it.\nconst applyVideoEffects: ApplyVideoEffects = (track, effects) => {\n  const t = track as MediaStreamTrack & WebRTCTrackExtensions;\n  if (t.remote) {\n    throw new Error('kaleidoscope: cannot apply effects to remote tracks');\n  }\n  if (typeof t._setVideoEffects !== 'function') {\n    throw new Error(\n      'kaleidoscope: track has no _setVideoEffects method (is react-native-webrtc >=124 installed?)',\n    );\n  }\n  const specs = effects.map(toEffectSpec);\n  // Deliver the composite's layer stack out-of-band before the \"composite\" name\n  // is dispatched. Blur sigma and generative uniforms ride inside each layer's\n  // `uniforms`. Guarded: a native build without the compositor lacks the function\n  // (and drops the \"composite\" name below if not registered).\n  for (const spec of specs) {\n    if (spec.name === 'composite') {\n      nativeModule().setCompositeLayers?.(serializeCompositeLayers((spec as CompositeSpec).layers));\n    }\n  }\n  // The composite name is book-driven: the prebuild copied the images and native\n  // registration installed the one \"composite\" compositor, so it passes the\n  // crash-guard. Transforms must be in the static set (always are).\n  const mapped = specs.map((spec) => ({\n    name: specToNativeName(spec),\n    trusted: spec.name === 'composite',\n  }));\n  const names = mapped\n    .filter((m) => m.trusted || NATIVE_REGISTERED_EFFECTS.has(m.name))\n    .map((m) => m.name);\n\n  // Dedup against the last set applied to this track. Order is significant\n  // (effects chain in array order), so the signature preserves it. Skip the\n  // native call when nothing changed; the first call for any given set always\n  // proceeds (no prior entry).\n  const signature = names.join('\\n');\n  if (lastAppliedSignatureByTrack.get(track) === signature) {\n    return track;\n  }\n  lastAppliedSignatureByTrack.set(track, signature);\n\n  const dropped = mapped\n    .filter((m) => !m.trusted && !NATIVE_REGISTERED_EFFECTS.has(m.name))\n    .map((m) => m.name);\n  if (dropped.length > 0) {\n    console.warn(\n      `kaleidoscope: dropping effects not registered on this native platform: ${dropped.join(', ')}. ` +\n        'Web has its own registry; this is a native-only filter.',\n    );\n  }\n  // Platforms diverge on how to clear effects:\n  //   - Android: rn-webrtc 124 has a bug where passing `[]` installs a\n  //     VideoEffectProcessor with an empty processors list, whose\n  //     onFrameCaptured then double-releases the input frame (retain once,\n  //     release twice) and crashes EglRenderer one frame later. The only\n  //     correct clear is `null`, which takes the upstream else-branch that\n  //     resets the processor via `videoSource.setVideoProcessor(null)`.\n  //   - iOS: the upstream Obj-C `_setVideoEffects` method declares\n  //     `names` as `(nonnull NSArray<NSString *> *)`, so passing `null`\n  //     violates the React Native bridge's nonnull contract. The supported\n  //     clear value is `[]`, which iOS's VideoEffectProcessor treats as a\n  //     passthrough (no double-release bug on this platform).\n  // The explicit type annotation is required; without it TS widens the\n  // empty-array literal to `never[] | null`.\n  const clearValue: ReadonlyArray<string> | null = Platform.OS === 'ios' ? [] : null;\n  t._setVideoEffects(names.length === 0 ? clearValue : names);\n  return track;\n};\n\n/**\n * Bind a track and a preset book; get the three verbs back\n * (`{ kaleidoscope, transform, mask }`). On native the track is mutated in\n * place, so `controls.track` is the bound track and `onTrack` fires with it\n * after each `kaleidoscope` preset switch and `transform` command. `mask`\n * updates the segmentation edge the per-frame processors read.\n */\nexport const bindKaleidoscope = <P extends KaleidoscopePresetBook>(\n  track: MediaStreamTrack,\n  options: KaleidoscopeBindOptions<P>,\n): KaleidoscopeBinding<P> => {\n  const reconcile: Reconcile = {\n    apply: (specs) => applyVideoEffects(track, specs),\n    dispose: () => {},\n  };\n  const setMask: SetMask = (hardness, threshold) => {\n    nativeModule().setMaskHardness(hardness);\n    nativeModule().setMaskThreshold(threshold);\n  };\n  // Native has no live per-layer uniform channel yet (Phase B): a patch of the\n  // active preset is a no-op here, so the verb's patch path is inert on native\n  // until the compositor reads layer-id-keyed overrides. The verb still drives\n  // preset switches through reconcile.\n  const setLayerUniforms: SetLayerUniforms = () => {};\n  // Native re-sends the full layer stack (with baked uniforms) on every preset\n  // switch via setCompositeLayers, so there is no stale override to clear; no-op for\n  // parity with the inert setLayerUniforms above.\n  const resetLayerUniforms: ResetLayerUniforms = () => {};\n  return createControls(track, options, reconcile, setMask, setLayerUniforms, resetLayerUniforms);\n};\n"]}