stream-chat-react-native-core 9.10.2 → 9.11.0-beta.2

package/lib/typescript/ai-components/transcription/useDictationAudioLevel.d.ts

@@ -0,0 +1,11 @@
+import { type SharedValue } from 'react-native-reanimated';
+/**
+ * The microphone's live level while dictation listens, from 0 to 1, for the `audioLevel` of
+ * `VoiceWave` and `VoiceGlow`. It is `null` while dictation is not listening, which lets a
+ * visualization animate speech on its own.
+ *
+ * The level is a shared value rather than state, so a level changing many times a second
+ * re-renders nothing: the visualizations read it once a frame on the UI thread.
+ */
+export declare const useDictationAudioLevel: () => SharedValue<number | null>;
+//# sourceMappingURL=useDictationAudioLevel.d.ts.map

package/lib/typescript/ai-components/transcription/useDictationAudioLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictationAudioLevel.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/transcription/useDictationAudioLevel.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,yBAAyB,CAAC;AAI3E;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAO,WAAW,CAAC,MAAM,GAAG,IAAI,CAuBlE,CAAC"}

package/lib/typescript/ai-components/voice-visualization/VoiceGlow.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { VoiceVisualizationProps } from './types';
+export type VoiceGlowProps = VoiceVisualizationProps;
+/**
+ * A voice agent as a soft, airy globe: color masses orbit inside it and swell with speech, and the
+ * gaps between them let the background show through. Tapping the globe bounces it and ripples it
+ * from the touch, and so does a hovering mouse or pen.
+ *
+ * It has no size of its own and draws in the middle of the view it is given, about half as wide
+ * as its shorter side, so give it a square.
+ */
+export declare const VoiceGlow: (props: VoiceGlowProps) => React.JSX.Element;
+//# sourceMappingURL=VoiceGlow.d.ts.map

package/lib/typescript/ai-components/voice-visualization/VoiceGlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceGlow.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/VoiceGlow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAIvD,MAAM,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAuDrD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,sBAE9C,CAAC"}

package/lib/typescript/ai-components/voice-visualization/VoiceVisualizationView.d.ts

@@ -0,0 +1,26 @@
+import React, { type ReactNode } from 'react';
+import type { VoiceVisualizationStyle } from './styles';
+import type { VoiceVisualizationProps } from './types';
+import { type VoiceVisualization } from './useVoiceVisualization';
+/** What the renderer draws in: the canvas size, in its own units, and the screen's pixels per unit. */
+export type VoiceCanvasSize = {
+    height: number;
+    pixelRatio: number;
+    width: number;
+};
+type ViewProps = VoiceVisualizationProps & {
+    /** Draws the visualization into a canvas of the given size. */
+    renderCanvas: (visualization: VoiceVisualization, size: VoiceCanvasSize) => ReactNode;
+    visualStyle: VoiceVisualizationStyle;
+};
+/**
+ * What VoiceWave and VoiceGlow share: the motion, the canvas kept at the view's size and at most
+ * the style's density, reduced motion, taps and hover, and accessibility.
+ *
+ * It names itself "Voice agent" with its state as the value, as on iOS and Android. Touches are
+ * only watched, never claimed, so a press handler on the view or a parent still gets them, and
+ * only the shape takes them: around it they reach whatever is behind.
+ */
+export declare const VoiceVisualizationView: ({ accessibilityLabel, accessibilityValue, audioLevel, colors, expressivity, onLayout, pointerEvents, renderCanvas, state, stateLabels, style, visualStyle, ...restProps }: ViewProps) => React.JSX.Element;
+export {};
+//# sourceMappingURL=VoiceVisualizationView.d.ts.map

package/lib/typescript/ai-components/voice-visualization/VoiceVisualizationView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceVisualizationView.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/VoiceVisualizationView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAkC,MAAM,OAAO,CAAC;AAY9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAmB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEzF,uGAAuG;AACvG,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,KAAK,SAAS,GAAG,uBAAuB,GAAG;IACzC,+DAA+D;IAC/D,YAAY,EAAE,CAAC,aAAa,EAAE,kBAAkB,EAAE,IAAI,EAAE,eAAe,KAAK,SAAS,CAAC;IACtF,WAAW,EAAE,uBAAuB,CAAC;CACtC,CAAC;AAUF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,2KAcpC,SAAS,sBAsHX,CAAC"}

package/lib/typescript/ai-components/voice-visualization/VoiceWave.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { VoiceVisualizationProps } from './types';
+export type VoiceWaveProps = VoiceVisualizationProps;
+/**
+ * A voice agent as a single string, flat at its ends, carrying a wave packet that erupts with
+ * speech while its colors flow along it. Tapping the string ripples it from the touch, and so does
+ * a hovering mouse or pen.
+ *
+ * It has no size of its own and draws in the middle of the view it is given, about 80% as wide as
+ * its shorter side, so give it a square or a wide box.
+ */
+export declare const VoiceWave: (props: VoiceWaveProps) => React.JSX.Element;
+//# sourceMappingURL=VoiceWave.d.ts.map

package/lib/typescript/ai-components/voice-visualization/VoiceWave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceWave.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/VoiceWave.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAYvD,MAAM,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAqCrD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,sBAE9C,CAAC"}

package/lib/typescript/ai-components/voice-visualization/bounce.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The bounce of a tap: a dip to 93% and an overshoot to 103% before settling, over 340 ms.
+ *
+ * These are authored keyframes rather than a spring: the ease-out curve times the whole run and
+ * the keyframes are linear between their stops.
+ */
+export declare const BOUNCE_DURATION = 0.34;
+/** How long ago the last bounce started, in seconds; infinite before the first. */
+export type BounceState = {
+    age: number;
+};
+export declare const createBounce: () => BounceState;
+export declare const startBounce: (bounce: BounceState) => void;
+export declare const advanceBounce: (bounce: BounceState, seconds: number) => void;
+/** CSS `ease-out`, `cubic-bezier(0, 0, 0.58, 1)`. */
+export declare const easeOut: (x: number) => number;
+/** The keyframed scale at `progress`, from 0 to 1. */
+export declare const scaleAt: (progress: number) => number;
+export declare const bounceScale: (bounce: BounceState) => number;
+//# sourceMappingURL=bounce.d.ts.map

package/lib/typescript/ai-components/voice-visualization/bounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounce.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/bounce.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAKpC,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,eAAO,MAAM,YAAY,QAAO,WAAkD,CAAC;AAEnF,eAAO,MAAM,WAAW,GAAI,QAAQ,WAAW,SAG9C,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,QAAQ,WAAW,EAAE,SAAS,MAAM,SAGjE,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,WAehC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,OAAO,GAAI,UAAU,MAAM,WASvC,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,QAAQ,WAAW,WAI9C,CAAC"}

package/lib/typescript/ai-components/voice-visualization/driver.d.ts

@@ -0,0 +1,96 @@
+import { type BounceState } from './bounce';
+import type { Hsv, VoiceAgentState } from './types';
+/**
+ * The share of the way the live level moves each frame at 60 Hz, toward a louder or a quieter
+ * level.
+ */
+export type LevelResponse = {
+    rise: number;
+    fall: number;
+};
+export declare const LEVEL_RESPONSE: {
+    /** Follows the level closely, both ways. The glow's. */
+    steady: {
+        fall: number;
+        rise: number;
+    };
+    /**
+     * Follows the level like a VU meter: about 0.1 s up to a louder reading, about 0.3 s down from
+     * it, so a meter's per-syllable jumps swell with the phrase instead. The wave's.
+     */
+    smooth: {
+        fall: number;
+        rise: number;
+    };
+};
+export type VoiceDriverInput = {
+    state: VoiceAgentState;
+    /** One to five colors. */
+    colors: Hsv[];
+    /** From 0 to 2. */
+    expressivity: number;
+    /** From 0 to 1, or null when no live audio drives the motion. */
+    audioLevel: number | null;
+    reduceMotion: boolean;
+};
+/**
+ * The motion of a voice visualization: where it is in time, how it moves, and its colors. A plain
+ * object rather than a class, so it can live in a shared value and be advanced on the UI thread.
+ */
+export type VoiceDriverState = {
+    speed: number;
+    bright: number;
+    sat: number;
+    load: number;
+    flow: number;
+    baseReact: number;
+    expressivity: number;
+    time: number;
+    flowSpin: number;
+    orbSpin: number;
+    count: number;
+    tapX: number;
+    tapY: number;
+    tapAge: number;
+    hoverX: number;
+    hoverY: number;
+    hoverAmount: number;
+    isHovering: boolean;
+    mic: number;
+    voice: number;
+    /** The colors drawn, eased in place toward the input's color slots. */
+    colors: Hsv[];
+    bounce: BounceState;
+    levelResponse: LevelResponse;
+};
+export declare const NO_TAP = 100;
+/** How fast time runs under reduced motion. */
+export declare const REDUCED = 0.07;
+/** Expressivity scales amplitude and speed, each with a floor so the motion breathes at 0. */
+export declare const scales: (expressivity: number) => {
+    amplitude: number;
+    speed: number;
+};
+/**
+ * The share of the way a value moves in `dt` seconds when it moves `perFrame` of the way each
+ * frame at 60 Hz.
+ */
+export declare const ease: (perFrame: number, dt: number) => number;
+/** The five color slots the renderers read; past the palette they repeat its first color. */
+export declare const slots: (colors: Hsv[]) => Hsv[];
+/** A driver settled on `input`, so the first frame shows it rather than easing into it. */
+export declare const createDriverState: (input: VoiceDriverInput, levelResponse?: LevelResponse) => VoiceDriverState;
+/** Live audio lifts the motion to its level, whatever the state. */
+export declare const driverReact: (d: VoiceDriverState) => number;
+/** The scale of a tap's bounce. */
+export declare const driverScale: (d: VoiceDriverState) => number;
+/** A tap at (x, y), centred and normalized to the shorter side with y up. */
+export declare const tapDriver: (d: VoiceDriverState, input: VoiceDriverInput, x: number, y: number) => void;
+/** Where a pointer hovers, or null once it has left. */
+export declare const hoverDriver: (d: VoiceDriverState, input: VoiceDriverInput, x: number | null, y: number | null) => void;
+/**
+ * Advances the motion by `seconds`, easing each value toward the input's motion by a fixed share
+ * per frame at 60 Hz, converted to time, so it moves the same at any refresh rate.
+ */
+export declare const advanceDriver: (d: VoiceDriverState, input: VoiceDriverInput, seconds: number) => void;
+//# sourceMappingURL=driver.d.ts.map

package/lib/typescript/ai-components/voice-visualization/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,WAAW,EAA0C,MAAM,UAAU,CAAC;AAEnG,OAAO,KAAK,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,eAAO,MAAM,cAAc;IACzB,wDAAwD;;;;;IAExD;;;OAGG;;;;;CAEoC,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,0BAA0B;IAC1B,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAuBF,eAAO,MAAM,MAAM,MAAM,CAAC;AAE1B,+CAA+C;AAC/C,eAAO,MAAM,OAAO,OAAO,CAAC;AAK5B,8FAA8F;AAC9F,eAAO,MAAM,MAAM,GAAI,cAAc,MAAM;;;CAG1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,UAAU,MAAM,EAAE,IAAI,MAAM,WAGhD,CAAC;AAgBF,6FAA6F;AAC7F,eAAO,MAAM,KAAK,GAAI,QAAQ,GAAG,EAAE,KAAG,GAAG,EAMxC,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,GAC5B,OAAO,gBAAgB,EACvB,gBAAe,aAAqC,KACnD,gBA6BF,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,WAAW,GAAI,GAAG,gBAAgB,WAG9C,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,WAAW,GAAI,GAAG,gBAAgB,WAG9C,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,SAAS,GAAI,GAAG,gBAAgB,EAAE,OAAO,gBAAgB,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,SAO3F,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,WAAW,GACtB,GAAG,gBAAgB,EACnB,OAAO,gBAAgB,EACvB,GAAG,MAAM,GAAG,IAAI,EAChB,GAAG,MAAM,GAAG,IAAI,SAUjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,gBAAgB,EAAE,OAAO,gBAAgB,EAAE,SAAS,MAAM,SAgC1F,CAAC"}

package/lib/typescript/ai-components/voice-visualization/glowShader.d.ts

@@ -0,0 +1,7 @@
+import { type SkRuntimeEffect } from '@shopify/react-native-skia';
+/**
+ * The compiled shader, shared by every glow: it compiles once, the first time a glow draws. Null
+ * if Skia cannot compile it, in which case the glow draws nothing.
+ */
+export declare const getGlowEffect: () => SkRuntimeEffect | null;
+//# sourceMappingURL=glowShader.d.ts.map

package/lib/typescript/ai-components/voice-visualization/glowShader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glowShader.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/glowShader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAoNxE;;;GAGG;AACH,eAAO,MAAM,aAAa,8BAUzB,CAAC"}

package/lib/typescript/ai-components/voice-visualization/index.d.ts

@@ -0,0 +1,4 @@
+export { VoiceGlow, type VoiceGlowProps } from './VoiceGlow';
+export { VoiceWave, type VoiceWaveProps } from './VoiceWave';
+export type { VoiceAgentState, VoiceVisualizationProps } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/ai-components/voice-visualization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/ai-components/voice-visualization/math.d.ts

@@ -0,0 +1,26 @@
+/** The shader math the wave runs on the CPU, once per frame, on the UI thread. */
+export declare const mix: (a: number, b: number, t: number) => number;
+export declare const fract: (x: number) => number;
+export declare const clamp: (x: number, low: number, high: number) => number;
+/** GLSL's smoothstep, evaluated the same with its edges either way round. */
+export declare const smoothstep: (edge0: number, edge1: number, x: number) => number;
+/** HSV, hue a fraction of a turn, into `out` as RGB. */
+export declare const hsvToRgb: (hue: number, saturation: number, value: number, out: number[]) => void;
+/** A palette color as is; dark mode lifts saturation a touch so it stays vivid on black. */
+export declare const vivid: (color: {
+    hue: number;
+    saturation: number;
+    value: number;
+}, dark: number, out: number[]) => void;
+/** Pushes `c` away from its luminance by `amount`; below 1 desaturates. */
+export declare const saturate: (c: number[], amount: number) => void;
+/**
+ * How much the agent is talking, 0 to 1: a slow phrase gate times a faster syllable wobble. The
+ * shader's own envelope, on the same simplex noise, so the wave and the glow speak alike.
+ */
+export declare const speechEnv: (t: number) => number;
+/** `expressivity` from 0 to 2; one that is not a number gets the default, 1. */
+export declare const expressivityInput: (expressivity: number | undefined) => number;
+/** `level` from 0 to 1; one that is not a number counts as no live audio, so it can't stall the motion. */
+export declare const audioLevelInput: (level: number | null | undefined) => number | null;
+//# sourceMappingURL=math.d.ts.map

package/lib/typescript/ai-components/voice-visualization/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/math.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAElF,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAGlD,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,WAG9B,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,WAGzD,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,GAAG,MAAM,WAIjE,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,YAAY,MAAM,EAAE,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,SAOrF,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,KAAK,GAChB,OAAO;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACzD,MAAM,MAAM,EACZ,KAAK,MAAM,EAAE,SAId,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,EAAE,QAAQ,MAAM,SAInD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,WAKlC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,GAAI,cAAc,MAAM,GAAG,SAAS,WACiC,CAAC;AAEpG,2GAA2G;AAC3G,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,kBAG/D,CAAC"}

package/lib/typescript/ai-components/voice-visualization/palette.d.ts

@@ -0,0 +1,18 @@
+import type { Hsv } from './types';
+export declare const MAXIMUM_COLORS = 5;
+export type Rgb = [number, number, number];
+/** Used when neither the `colors` prop nor the theme gives a readable color. */
+export declare const FALLBACK_COLOR = "#005fff";
+/**
+ * Reads any color React Native understands (names, `#rgb[a]`, `#rrggbb[aa]`, `rgb()`, `hsl()`, ...)
+ * into sRGB channels from 0 to 1, or null when it cannot be read. Platform colors have no
+ * channels to read and count as unreadable.
+ */
+export declare const parseColor: (color: string) => Rgb | null;
+/** RGB channels from 0 to 1 as HSV, keeping full saturation and value so muted colors render true. */
+export declare const rgbToHsv: ([r, g, b]: Rgb) => Hsv;
+/** Colors as the HSV the renderers read, at most five; colors that cannot be read are skipped. */
+export declare const toHsvPalette: (colors: readonly string[]) => Hsv[];
+/** Relative luminance of a color, or null when it cannot be read. */
+export declare const luminance: (color: string) => number | null;
+//# sourceMappingURL=palette.d.ts.map

package/lib/typescript/ai-components/voice-visualization/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/palette.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAEnC,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,gFAAgF;AAChF,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,GAAG,GAAG,IAQhD,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,QAAQ,GAAI,WAAW,GAAG,KAAG,GAezC,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,YAAY,GAAI,QAAQ,SAAS,MAAM,EAAE,KAAG,GAAG,EAK1C,CAAC;AAEnB,qEAAqE;AACrE,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,kBAKtC,CAAC"}

package/lib/typescript/ai-components/voice-visualization/simplex.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 3-D simplex noise, a port of the glow shader's `snoise` (Ashima Arts / Stefan Gustavson), so the
+ * wave drawn on the CPU moves with the same speech rhythm as the shader, as on iOS and the web.
+ *
+ * It runs in float32 like a GPU, with `mod` as a multiply by a float32 reciprocal, because the
+ * hash is sensitive to rounding: in exact arithmetic some inputs hash to a neighbouring gradient.
+ * Every function is a worklet, as the motion runs on the UI thread.
+ */
+/** Simplex noise at (x, y, z), from about -1 to 1. */
+export declare const snoise: (inX: number, inY: number, inZ: number) => number;
+//# sourceMappingURL=simplex.d.ts.map

package/lib/typescript/ai-components/voice-visualization/simplex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simplex.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/simplex.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6CH,sDAAsD;AACtD,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,WAsC3D,CAAC"}

package/lib/typescript/ai-components/voice-visualization/styles.d.ts

@@ -0,0 +1,24 @@
+import { type LevelResponse } from './driver';
+/**
+ * What tells the glow and the wave apart besides how they draw, as on iOS.
+ *
+ * - `levelResponse`: the wave's height tracks the level directly, so it follows it smoothly;
+ *   per-syllable jumps would make it jitter. The glow follows it closely.
+ * - `maxScale`: the densest it renders. The glow is soft all over, so 2x is enough; the wave's
+ *   thin line is drawn at the screen's own scale, up to 3x, to stay crisp.
+ * - `contains`: whether a point, centred and normalized to the shorter side with y up, is on the
+ *   shape rather than the empty space around it.
+ */
+export type VoiceVisualizationStyle = {
+    contains: (x: number, y: number) => boolean;
+    /** The shape's bounds as a share of the shorter side, for the area that takes touches. */
+    hitArea: {
+        width: number;
+        height: number;
+    };
+    levelResponse: LevelResponse;
+    maxScale: number;
+};
+export declare const GLOW_STYLE: VoiceVisualizationStyle;
+export declare const WAVE_STYLE: VoiceVisualizationStyle;
+//# sourceMappingURL=styles.d.ts.map

package/lib/typescript/ai-components/voice-visualization/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,0FAA0F;IAC1F,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAKF,eAAO,MAAM,UAAU,EAAE,uBAQxB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,uBAQxB,CAAC"}

package/lib/typescript/ai-components/voice-visualization/types.d.ts

@@ -0,0 +1,45 @@
+import type { ViewProps } from 'react-native';
+import type { SharedValue } from 'react-native-reanimated';
+/**
+ * What a voice agent is doing, which a voice visualization shows as motion.
+ *
+ * The states differ only in how a visualization moves, never in its colors, and changing the
+ * state eases from one motion into the next.
+ *
+ * - `idle`: waiting to be spoken to, a calm, barely-there shimmer.
+ * - `connecting`: not ready yet, a loader sweep with a pulsing breath.
+ * - `listening`: hearing somebody, a gentle expand and contract.
+ * - `thinking`: working on an answer, a slow turn or a travelling wave.
+ * - `speaking`: talking, strong motion that ebbs and pauses like speech.
+ */
+export type VoiceAgentState = 'idle' | 'connecting' | 'listening' | 'thinking' | 'speaking';
+export type VoiceVisualizationProps = Omit<ViewProps, 'children'> & {
+    /** What the agent is doing, which sets how the visualization moves. */
+    state: VoiceAgentState;
+    /**
+     * The level of whoever is talking, from 0 to 1, read once a frame on the UI thread. Feed it at
+     * 15 Hz or more for the visualization to move with the words; `null` animates speech on its own.
+     * See `useDictationAudioLevel` for the level of the microphone while dictating.
+     */
+    audioLevel?: SharedValue<number | null>;
+    /**
+     * One to five colors. Past five are ignored, and colors that cannot be read are skipped. When
+     * omitted or empty, the theme's `voiceVisualization.colors` are used.
+     */
+    colors?: string[];
+    /** From 0 to 2: how far and how fast it moves. Colors never change with it. Defaults to 1. */
+    expressivity?: number;
+    /**
+     * What screen readers read as the value for each state, for example to translate them. Defaults
+     * to "Ready", "Connecting", "Listening", "Thinking" and "Speaking". The label, "Voice agent", is
+     * `accessibilityLabel`.
+     */
+    stateLabels?: Partial<Record<VoiceAgentState, string>>;
+};
+/** A color as hue (a fraction of a turn), saturation and value, each from 0 to 1. */
+export type Hsv = {
+    hue: number;
+    saturation: number;
+    value: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/ai-components/voice-visualization/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5F,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG;IAClE,uEAAuE;IACvE,KAAK,EAAE,eAAe,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8FAA8F;IAC9F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,GAAG,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/lib/typescript/ai-components/voice-visualization/useReduceMotion.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Whether the system asks for less motion: Reduce Motion on iOS, animations off on Android. It
+ * follows the setting while mounted.
+ *
+ * The AI entry point cannot reach the core SDK's own hook, which also only applies once its
+ * accessibility layer is enabled; the voice visualizations always honour the setting, as on iOS
+ * and Android.
+ */
+export declare const useReduceMotion: () => boolean;
+//# sourceMappingURL=useReduceMotion.d.ts.map

package/lib/typescript/ai-components/voice-visualization/useReduceMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReduceMotion.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/useReduceMotion.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,eAsB3B,CAAC"}

package/lib/typescript/ai-components/voice-visualization/useVoiceVisualization.d.ts

@@ -0,0 +1,18 @@
+import type { VoiceVisualizationStyle } from './styles';
+import type { VoiceVisualizationProps } from './types';
+/**
+ * A voice visualization's motion, advanced once a frame on the UI thread.
+ *
+ * The driver lives in a shared value the renderers derive from, so a frame redraws without
+ * re-rendering React, and `audioLevel` is read in the frame callback, so a level changing many
+ * times a second re-renders nothing either.
+ */
+export declare const useVoiceVisualization: ({ audioLevel, colors, expressivity, state }: VoiceVisualizationProps, style: VoiceVisualizationStyle) => {
+    dark: import("react-native-reanimated").SharedValue<number>;
+    driver: import("react-native-reanimated").SharedValue<import("./driver").VoiceDriverState>;
+    hover: (x: number | null, y: number | null) => void;
+    opacity: import("react-native-reanimated").SharedValue<number>;
+    tap: (x: number, y: number) => void;
+};
+export type VoiceVisualization = ReturnType<typeof useVoiceVisualization>;
+//# sourceMappingURL=useVoiceVisualization.d.ts.map

package/lib/typescript/ai-components/voice-visualization/useVoiceVisualization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVoiceVisualization.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/useVoiceVisualization.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAkBvD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,6CAA6C,uBAAuB,EACpE,OAAO,uBAAuB;;;eAwFxB,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI;;aAf/B,MAAM,KAAK,MAAM;CA6BxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/lib/typescript/ai-components/voice-visualization/waveGeometry.d.ts

@@ -0,0 +1,25 @@
+import { type SkPath } from '@shopify/react-native-skia';
+import { type VoiceDriverState } from './driver';
+export declare const WAVE_STOPS = 13;
+export declare const WAVE_START = -0.42;
+export declare const WAVE_END = 0.42;
+/** The stops' positions along the gradient, evenly spaced. */
+export declare const WAVE_POSITIONS: number[];
+/** The string's height above its centre line at each point, centred and normalized, y up. */
+export declare const waveHeights: (d: VoiceDriverState) => {
+    xs: number[];
+    ys: number[];
+};
+/**
+ * The wave as a path in a `width` by `height` canvas. Newer Skia versions build immutable paths with
+ * `PathBuilder`; earlier 2.x versions mutate `SkPath` itself.
+ */
+export declare const wavePath: (d: VoiceDriverState, width: number, height: number) => SkPath;
+/**
+ * The string's colors at its gradient stops, as RGBA from 0 to 1: up to five bands drifting along
+ * it, weighed by how near their centres are, its ends fading out.
+ */
+export declare const waveColors: (d: VoiceDriverState, dark: number) => Float32Array<ArrayBufferLike>[];
+/** The line is 0.6% of the shorter side, and never under 1.5 device pixels, as on Android and iOS. */
+export declare const waveStrokeWidth: (width: number, height: number, pixelRatio: number) => number;
+//# sourceMappingURL=waveGeometry.d.ts.map

package/lib/typescript/ai-components/voice-visualization/waveGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waveGeometry.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/voice-visualization/waveGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAI3E,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,QAAQ,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAE7B,8DAA8D;AAC9D,eAAO,MAAM,cAAc,UAAqE,CAAC;AAuBjG,6FAA6F;AAC7F,eAAO,MAAM,WAAW,GAAI,GAAG,gBAAgB;;;CAkC9C,CAAC;AAOF;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,GAAG,gBAAgB,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,MAiB7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,gBAAgB,EAAE,MAAM,MAAM,oCA6B3D,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,EAAE,YAAY,MAAM,WACpB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stream-chat-react-native-core",
   "description": "The official React Native and Expo components for Stream Chat, a service for building chat applications",
-  "version": "9.10.2",
+  "version": "9.11.0-beta.2",
   "author": {
     "company": "Stream.io Inc",
     "name": "Stream.io Inc"
@@ -84,7 +84,7 @@
     "react-native-markdown-package": "1.8.2",
     "react-native-url-polyfill": "^2.0.0",
     "react-syntax-highlighter": "^16.1.0",
-    "stream-chat": "^9.54.1",
+    "stream-chat": "^9.54.2",
     "use-sync-external-store": "^1.5.0",
     "zod": "^4.1.12"
   },

package/src/ai-components/README.md

@@ -22,12 +22,12 @@ These components used to ship as the standalone `@stream-io/chat-react-native-ai
 
 2. Dictation is now opt-in on iOS (see [Dictation](#dictation-speech-to-text)): add `$StreamChatEnableDictation = true` to your `Podfile`, or, with Expo, replace the `@stream-io/chat-react-native-ai` config plugin with `stream-chat-expo`.
 3. Keep the `export-namespace-from` Babel plugin (see [Installation](#️-installation)); it is needed by the `zod` dependency.
-4. `ShimmeringView` and `toHexFromRNColor` were removed. `AITypingIndicatorView` now uses the SDK's native shimmer, so `@shopify/react-native-skia` is only needed for charts.
+4. `ShimmeringView` and `toHexFromRNColor` were removed. `AITypingIndicatorView` now uses the SDK's native shimmer, so `@shopify/react-native-skia` is only needed for charts and the voice visualizations.
 5. `SpeechToTextButton` and `isDictationAvailable` are now exported.
 
 ## 🛠️ Installation
 
-The AI components ship with `stream-chat-react-native` and `stream-chat-expo`; their JavaScript dependencies are installed with them. Charts additionally need the following peer dependencies, which only apps using the AI components have to install:
+The AI components ship with `stream-chat-react-native` and `stream-chat-expo`; their JavaScript dependencies are installed with them. Charts and the voice visualizations (`VoiceGlow`, `VoiceWave`) additionally need the following peer dependencies, which only apps using the AI components have to install:
 
 ```bash
 yarn add victory-native @shopify/react-native-skia
@@ -244,6 +244,54 @@ const options = {
 
 The `SpeechToTextButton` is already integrated within the `ComposerView`, however feel free to use it elsewhere as well. It renders nothing when dictation is not part of the build (see [Dictation](#dictation-speech-to-text)); `isDictationAvailable()` tells you whether it is.
 
+### `VoiceGlow` and `VoiceWave`
+
+Two visualizations of a voice agent, alike on iOS, Android, the web and React Native:
+
+- `VoiceGlow`: a soft, airy globe whose color masses orbit inside it and swell with speech. It is drawn by a Skia shader, every pixel on the GPU.
+- `VoiceWave`: a single string carrying a wave packet that erupts with speech, its colors flowing along it.
+
+Neither has a size of its own: each draws in the middle of the view it is given, the glow about half as wide as its shorter side and the wave about 80% as wide, so give the glow a square and the wave a square or a wide box. Both take the same props, and any other `View` prop goes to their root:
+
+| Name           | Type                                                                | Required | Description                                                                                                                                                                                              |
+| -------------- | ------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `state`        | `'idle' \| 'connecting' \| 'listening' \| 'thinking' \| 'speaking'` | yes      | What the agent is doing. The states differ only in how it moves, never in its colors, and changing the state eases from one motion into the next.                                                        |
+| `audioLevel`   | `SharedValue<number \| null>`                                       | no       | The level of whoever is talking, from 0 to 1, read once a frame on the UI thread. Feed it at 15 Hz or more for the motion to follow the words. While it is `null` or absent, speech animates on its own. |
+| `colors`       | `string[]`                                                          | no       | One to five colors. Past five are ignored, and colors that cannot be read are skipped. Defaults to the theme's `voiceVisualization.colors`.                                                              |
+| `expressivity` | `number`                                                            | no       | From 0 to 2: how far and how fast it moves. Colors never change with it. Defaults to `1`.                                                                                                                |
+| `stateLabels`  | `Partial<Record<VoiceAgentState, string>>`                          | no       | What screen readers read as the value for each state, for example to translate them. Defaults to "Ready", "Connecting", "Listening", "Thinking" and "Speaking".                                          |
+
+```tsx
+import { useDictationAudioLevel, VoiceGlow, VoiceWave } from 'stream-chat-react-native/ai-components';
+
+const VoiceAgent = ({ agentState, isListening }) => {
+  const micLevel = useDictationAudioLevel();
+
+  return (
+    <>
+      <VoiceGlow state={agentState} style={{ width: 320, height: 320 }} />
+      <VoiceWave
+        audioLevel={micLevel}
+        state={isListening ? 'listening' : 'idle'}
+        style={{ width: '100%', height: 120 }}
+      />
+    </>
+  );
+};
+```
+
+The motion runs entirely on the UI thread with Reanimated and Skia, so the visualizations stay smooth while the JS thread is busy streaming a reply, and a changing `audioLevel` re-renders nothing.
+
+**Audio level.** `useDictationAudioLevel()` gives the microphone's level while `useDictation` (or the `SpeechToTextButton`) is listening, and `null` otherwise. For any other source, such as a remote participant's audio level from Stream Video, keep a shared value of your own and write to it: `const level = useSharedValue<number | null>(null)`, then `level.value = participant.audioLevel`.
+
+**Interaction.** Tapping the shape bounces it and sends out a ripple, and a hovering mouse or pen ripples it too. Touches are only observed, never claimed, so a `Pressable` around the visualization still gets its press; touches beside the shape reach whatever is behind it.
+
+**Theming.** The theme's `voiceVisualization.colors` are the default palette (the accent color unless you set them). The visualizations draw for a light or a dark background following `voiceVisualization.backdropColor` when you set it, and the system color scheme otherwise.
+
+**Accessibility.** Each is an image named "Voice agent" with its state as the value ("Ready", "Connecting", "Listening", "Thinking", "Speaking"), as on iOS and Android. Pass `stateLabels` to translate the state values, `accessibilityLabel` to change the label, or `accessibilityValue` to replace the value outright. Under the system's Reduce Motion (animations off on Android), they barely move and ignore taps.
+
+**Differences from the native SDKs.** The glow has no `rendering` option: the shader runs on every Android version through Skia, so there is no Canvas fallback, and it does not switch to a cheaper look in battery saver as on Android. A visualization keeps animating while it is mounted, even when scrolled off screen; it pauses only while the app is in the background.
+
 ### Theming
 
 Each one of the components in the SDK is fully theme-compatible. The `StreamTheme` provider takes care of this for you.