@urun-sh/react 0.2.21 → 0.2.23

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## Unreleased
+
+- **Prebaked media I/O, bare-name canonical exports** (owner mandate 2026-07-13 — the UrunX
+  component convention is dead): the declarative send/show surface, keyed on session stream
+  names, bound via the new `<SessionScope session={...}>` (every component also takes an
+  explicit `session` prop).
+  - `<Video stream="output" />` — NEW root-entry live video display (the canonical
+    "LiveVideo" pattern the app frontends hand-rolled: one persistent `srcObject`,
+    muted+autoplay+playsinline with iOS attrs asserted, missed-event poll fallback,
+    fill-container sizing, honest empty state via `placeholder` +
+    `data-urun-video-live`). No video.js — the root entry stays player-framework-free.
+  - `<Image stream="canvas" />` — NEW semantic wrapper over `<Video>` for the platform
+    image lane (images ship as H.264 intra frames on a video stream; default stream
+    `"image"`).
+  - `<Camera stream="cam" front|back visible />` — canonical rename of `UrunCamera` plus
+    the declarative surface: `front`/`back` facing props, auto-start on mount
+    (level-triggered convergence; `autoStart={false}` for the imperative `ref.start()`
+    mode), and **viewless by default** (`visible` opts into the self-view).
+  - `<Mic stream="mic" />` — NEW viewless mic publish (capture-only half of `<Voice>`,
+    same one-capture/whenLive/attach engine); `visible` renders a minimal level meter.
+  - `<Audio stream="voice" />` — canonical rename of `UrunAudio` (sound-only by default,
+    `controls` for a native player; unchanged autoplay-unlock contract).
+  - `<Voice />` — canonical rename of `UrunVoice`; new `playback={false}` capture-only
+    mode (what `<Mic>` rides on).
+  - `@urun-sh/react/video`: `UrunVideo` renamed `VideoPlayer` — the video.js-backed
+    player now positioned for VOD/recordings playback (seek/scrub); live session streams
+    should use the root `<Video>`.
+  - Deprecated aliases kept for ONE release so pinned fleet frontends compile:
+    `UrunAudio`, `UrunVoice`, `UrunCamera` (behavior-preserving shim: preview on,
+    no auto-start), `UrunVideo` (subpath), plus their prop/handle type names.
+    **Removed next minor.**
+- Removed the dead compositing-era files (`use-scene`, `use-layout`,
+  `compositor-provider`, `scene-store` — never exported from the package root), guarded
+  against reintroduction by `compositing-era-removed.test.ts`.
+
 ## 0.2.19
 
 - `UrunProvider` gains an optional `eventsUrl` prop: a trusted (typically
@@ -20,7 +55,7 @@
   ride the same `stream.messages()` API, now fed exclusively by the §5
   server-push DataConsumer path).
 
-## Unreleased
+## 0.2.7
 
 - **BREAKING**: `UrunVideo` moved from the root entry to the `./video` subpath
   — import it as `import { UrunVideo } from '@urun-sh/react/video'`. video.js

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { RefObject, ReactNode, Component, ErrorInfo, ComponentType } from 'react';
+import { RefObject, ReactNode, Component, ErrorInfo, ComponentType, CSSProperties } from 'react';
 import { SessionInterface, SessionDocument, SessionStream, SessionPhase, SessionStatus, SessionDiagnostic, CaptureController, ActivationEvent, PrewakeResult, RuntimeAvailability } from '@urun-sh/core';
 export { ActivationEvent, ActivationState, App as AppInterface, AppOptions, PrewakeResult, PrewakeStatus, RuntimeAvailability, SessionDocument, Session as SessionInterface, SessionPhase, SessionPhaseName, SessionStream, describeSessionPhase, isWakingPhase } from '@urun-sh/core';
 import { ZodSchema, z } from 'zod';
@@ -375,18 +375,114 @@ declare function useMetricsPanel(props: MetricsPanelProps): {
 };
 declare function MetricsPanel(props: MetricsPanelProps): react_jsx_runtime.JSX.Element;
 
-interface UrunAudioStreamSource {
+interface ScopedStreamSource {
+    
+    readonly track: MediaStreamTrack | null;
+    
+    on(event: 'track', handler: (track: MediaStreamTrack | null) => void): () => void;
+    
+    attach(track: MediaStreamTrack): Promise<void>;
+    
+    detach(): Promise<void>;
+    
+    attachVideo(track: MediaStreamTrack): Promise<void>;
+    
+    detachVideo(): Promise<void>;
+}
+
+interface ScopedSession {
+    
+    stream(name: string): ScopedStreamSource;
+    
+    whenLive(options?: {
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    
+    readonly status?: SessionStatus;
+    
+    onRecovery?(hook: () => void): () => void;
+}
+
+interface SessionScopeProps {
+    
+    session: ScopedSession | null;
+    children: ReactNode;
+}
+
+declare function SessionScope({ session, children }: SessionScopeProps): react_jsx_runtime.JSX.Element;
+
+interface VideoStreamSource {
+    
+    readonly track: MediaStreamTrack | null;
+    
+    on(event: 'track', handler: (track: MediaStreamTrack | null) => void): () => void;
+}
+
+interface VideoSessionSource {
+    stream(name: string): VideoStreamSource;
+}
+
+interface VideoHandle {
+    
+    readonly element: HTMLVideoElement | null;
+    
+    readonly live: boolean;
+}
+
+interface VideoProps {
+    
+    session?: VideoSessionSource | null;
+    
+    stream?: string;
+    
+    track?: MediaStreamTrack | null;
+    
+    muted?: boolean;
+    
+    mirror?: boolean;
+    
+    objectFit?: CSSProperties['objectFit'];
+    
+    className?: string;
+    
+    style?: CSSProperties;
+    
+    videoClassName?: string;
+    
+    placeholder?: ReactNode;
+    
+    children?: ReactNode;
+    
+    onTrack?: (track: MediaStreamTrack | null) => void;
+}
+
+declare const Video: react.ForwardRefExoticComponent<VideoProps & react.RefAttributes<VideoHandle>>;
+
+type ImageProps = Omit<VideoProps, 'muted' | 'mirror' | 'stream'> & {
+    
+    stream?: string;
+};
+
+type ImageHandle = VideoHandle;
+
+declare const Image: react.ForwardRefExoticComponent<Omit<VideoProps, "stream" | "muted" | "mirror"> & {
+    
+    stream?: string;
+} & react.RefAttributes<VideoHandle>>;
+
+interface AudioStreamSource {
     
     readonly track: MediaStreamTrack | null;
     
     on(event: 'track', handler: (track: MediaStreamTrack | null) => void): () => void;
 }
 
-interface UrunAudioSessionSource {
-    stream(name: string): UrunAudioStreamSource;
+interface AudioSessionSource {
+    stream(name: string): AudioStreamSource;
 }
 
-interface UrunAudioHandle {
+interface AudioHandle {
     
     unlock(): void;
     
@@ -395,9 +491,9 @@ interface UrunAudioHandle {
     readonly element: HTMLAudioElement | null;
 }
 
-interface UrunAudioProps {
+interface AudioProps {
     
-    session?: UrunAudioSessionSource | null;
+    session?: AudioSessionSource | null;
     
     stream?: string;
     
@@ -414,15 +510,25 @@ interface UrunAudioProps {
     onAudioElement?: (el: HTMLAudioElement | null) => void;
 }
 
-declare const UrunAudio: react.ForwardRefExoticComponent<UrunAudioProps & react.RefAttributes<UrunAudioHandle>>;
+declare const Audio: react.ForwardRefExoticComponent<AudioProps & react.RefAttributes<AudioHandle>>;
+
+declare const UrunAudio: react.ForwardRefExoticComponent<AudioProps & react.RefAttributes<AudioHandle>>;
+
+type UrunAudioProps = AudioProps;
+
+type UrunAudioHandle = AudioHandle;
 
-interface UrunVoiceStreamSource extends UrunAudioStreamSource {
+type UrunAudioStreamSource = AudioStreamSource;
+
+type UrunAudioSessionSource = AudioSessionSource;
+
+interface VoiceStreamSource extends AudioStreamSource {
     attach(track: MediaStreamTrack): Promise<void>;
     detach(): Promise<void>;
 }
 
-interface UrunVoiceSessionSource {
-    stream(name: string): UrunVoiceStreamSource;
+interface VoiceSessionSource {
+    stream(name: string): VoiceStreamSource;
     
     whenLive(options?: {
         timeout?: number;
@@ -434,7 +540,7 @@ interface UrunVoiceSessionSource {
     onRecovery?(hook: () => void): () => void;
 }
 
-interface UrunVoiceHandle {
+interface VoiceHandle {
     
     start(): Promise<void>;
     
@@ -446,15 +552,17 @@ interface UrunVoiceHandle {
     
     unlock(): void;
     
-    readonly audio: UrunAudioHandle | null;
+    readonly audio: AudioHandle | null;
 }
 
-interface UrunVoiceProps {
+interface VoiceProps {
     
-    session: UrunVoiceSessionSource;
+    session?: VoiceSessionSource | null;
     
     stream?: string;
     
+    playback?: boolean;
+    
     constraints?: MediaTrackConstraints;
     
     connectTimeoutMs?: number;
@@ -478,15 +586,61 @@ interface UrunVoiceProps {
 
 declare const DEFAULT_VOICE_CONSTRAINTS: MediaTrackConstraints;
 
-declare const UrunVoice: react.ForwardRefExoticComponent<UrunVoiceProps & react.RefAttributes<UrunVoiceHandle>>;
+declare const Voice: react.ForwardRefExoticComponent<VoiceProps & react.RefAttributes<VoiceHandle>>;
+
+declare const UrunVoice: react.ForwardRefExoticComponent<VoiceProps & react.RefAttributes<VoiceHandle>>;
+
+type UrunVoiceProps = VoiceProps;
+
+type UrunVoiceHandle = VoiceHandle;
+
+type UrunVoiceStreamSource = VoiceStreamSource;
+
+type UrunVoiceSessionSource = VoiceSessionSource;
+
+interface MicHandle {
+    
+    start(): Promise<void>;
+    
+    stop(): Promise<void>;
+    
+    readonly active: boolean;
+    
+    readonly micStream: MediaStream | null;
+}
+
+interface MicProps {
+    
+    session?: VoiceSessionSource | null;
+    
+    stream?: string;
+    
+    constraints?: MediaTrackConstraints;
+    
+    autoStart?: boolean;
+    
+    visible?: boolean;
+    
+    className?: string;
+    
+    onActiveChange?: (active: boolean) => void;
+    
+    onError?: (error: Error) => void;
+    
+    onMicStream?: (stream: MediaStream | null) => void;
+    
+    capture?: CaptureController;
+}
+
+declare const Mic: react.ForwardRefExoticComponent<MicProps & react.RefAttributes<MicHandle>>;
 
-interface UrunCameraStreamSource {
+interface CameraStreamSource {
     attachVideo(track: MediaStreamTrack): Promise<void>;
     detachVideo(): Promise<void>;
 }
 
-interface UrunCameraSessionSource {
-    stream(name: string): UrunCameraStreamSource;
+interface CameraSessionSource {
+    stream(name: string): CameraStreamSource;
     
     whenLive(options?: {
         timeout?: number;
@@ -496,44 +650,50 @@ interface UrunCameraSessionSource {
     readonly status?: SessionStatus;
 }
 
-type UrunCameraFacing = 'user' | 'environment';
+type CameraFacing = 'user' | 'environment';
 
-interface UrunCameraHandle {
+interface CameraHandle {
     
     start(options?: {
-        facingMode?: UrunCameraFacing;
+        facingMode?: CameraFacing;
     }): Promise<void>;
     
     stop(): Promise<void>;
     
     flip(): Promise<void>;
     
-    setFacingMode(mode: UrunCameraFacing): Promise<void>;
+    setFacingMode(mode: CameraFacing): Promise<void>;
     
     readonly active: boolean;
     
-    readonly facingMode: UrunCameraFacing;
+    readonly facingMode: CameraFacing;
     
     readonly stream: MediaStream | null;
     
     readonly element: HTMLVideoElement | null;
 }
 
-interface UrunCameraProps {
+interface CameraProps {
     
-    session: UrunCameraSessionSource;
+    session?: CameraSessionSource | null;
     
     stream?: string;
     
     constraints?: MediaTrackConstraints;
     
-    facingMode?: UrunCameraFacing;
+    front?: boolean;
+    
+    back?: boolean;
+    
+    facingMode?: CameraFacing;
+    
+    autoStart?: boolean;
     
     mirror?: boolean | 'auto';
     
     connectTimeoutMs?: number;
     
-    preview?: boolean;
+    visible?: boolean;
     
     className?: string;
     
@@ -560,7 +720,24 @@ interface UrunCameraProps {
 
 declare const DEFAULT_CAMERA_CONSTRAINTS: MediaTrackConstraints;
 
-declare const UrunCamera: react.ForwardRefExoticComponent<UrunCameraProps & react.RefAttributes<UrunCameraHandle>>;
+declare const Camera: react.ForwardRefExoticComponent<CameraProps & react.RefAttributes<CameraHandle>>;
+
+interface UrunCameraProps extends Omit<CameraProps, 'session' | 'front' | 'back' | 'autoStart' | 'visible'> {
+    
+    session: CameraSessionSource;
+    
+    preview?: boolean;
+}
+
+declare const UrunCamera: react.ForwardRefExoticComponent<UrunCameraProps & react.RefAttributes<CameraHandle>>;
+
+type UrunCameraHandle = CameraHandle;
+
+type UrunCameraFacing = CameraFacing;
+
+type UrunCameraStreamSource = CameraStreamSource;
+
+type UrunCameraSessionSource = CameraSessionSource;
 
 interface UseUrunAudioLevelOptions {
     
@@ -885,4 +1062,4 @@ interface UrunActivationOverlayProps {
 
 declare function UrunActivationOverlay({ session, stream, videoElement, render, className, }: UrunActivationOverlayProps): react_jsx_runtime.JSX.Element | null;
 
-export { type ActivationProgress, type ChatMessage, type ChatRole, ComponentRenderer, type CreateDocStoreOptions, DEFAULT_CAMERA_CONSTRAINTS, DEFAULT_LOG_CAP, DEFAULT_VOICE_CONSTRAINTS, type DeepPartial, type DocPatch, DocPatchForm, type DocState, type DocStore, ImageFrame, ImageFrameSchema, type InputPresenceControls, type InputPresenceSession, type JsonObjectParse, MetricsPanel, MetricsPanelSchema, ProgressCard, ProgressCardSchema, type ReactApp, type ReactSession, type ReactSessionDocument, type ReactSessionStream, type RegisteredComponent, type RequestCapableSession, type RequestStream, type SessionIdleState, type SessionRequestOptions, type SessionWake, type SpineEntry, StatusBadge, StatusBadgeSchema, type StreamMessageEntry, TextStream, TextStreamSchema, type UrunAccessToken, type UrunAccessTokenProvider, UrunActivationOverlay, type UrunActivationOverlayProps, UrunAudio, type UrunAudioHandle, type UrunAudioLevel, type UrunAudioProps, type UrunAudioSessionSource, type UrunAudioStreamSource, type UrunAuthContextValue, type UrunAuthMode, UrunAuthProvider, type UrunAuthProviderProps, UrunCamera, type UrunCameraFacing, type UrunCameraHandle, type UrunCameraProps, type UrunCameraSessionSource, type UrunCameraStreamSource, UrunControlSender, type UrunControlSenderProps, UrunDocPanel, type UrunDocPanelProps, UrunErrorBoundary, UrunEventSpine, type UrunEventSpineProps, UrunIdleWarning, type UrunIdleWarningProps, UrunJwtProvider, UrunProvider, UrunSessionClock, type UrunSessionClockProps, UrunSessionEnded, type UrunSessionEndedProps, UrunSessionGate, type UrunSessionGateProps, UrunSessionStatus, type UrunSessionStatusProps, UrunSessionWaking, type UrunSessionWakingProps, UrunStreamTail, type UrunStreamTailProps, UrunVoice, type UrunVoiceHandle, type UrunVoiceProps, type UrunVoiceSessionSource, type UrunVoiceStreamSource, type UseChatOptions, type UseChatResult, type UseCompletionOptions, type UseCompletionResult, type UseInputPresenceOptions, type UseRequestOptions, type UseRequestResult, type UseSessionDocResult, type UseStreamMessagesOptions, type UseUrunAudioLevelOptions, type UseUrunPrewakeOptions, type WorkbenchDocSource, type WorkbenchSession, type WorkbenchStreamSource, authMode, createDocStore, formatPayload, getUrunAudioContext, parseJsonObject, pushCapped, registerComponent, resumeUrunAudioContext, urunPublicEnv, useActivation, useApp, useChat, useCompletion, useDocStore, useImageFrame, useInputPresence, useMetricsPanel, useProgressCard, useRequest, useSessionDoc, useSessionEndsAt, useSessionIdle, useSessionPhase, useSessionTrack, useSessionWake, useStatusBadge, useStreamMessages, useTextStream, useUrunAudioLevel, useUrunAuth, useUrunPrewake, usesWorkOSAuth };
+export { type ActivationProgress, Audio, type AudioHandle, type AudioProps, type AudioSessionSource, type AudioStreamSource, Camera, type CameraFacing, type CameraHandle, type CameraProps, type CameraSessionSource, type CameraStreamSource, type ChatMessage, type ChatRole, ComponentRenderer, type CreateDocStoreOptions, DEFAULT_CAMERA_CONSTRAINTS, DEFAULT_LOG_CAP, DEFAULT_VOICE_CONSTRAINTS, type DeepPartial, type DocPatch, DocPatchForm, type DocState, type DocStore, Image, ImageFrame, ImageFrameSchema, type ImageHandle, type ImageProps, type InputPresenceControls, type InputPresenceSession, type JsonObjectParse, MetricsPanel, MetricsPanelSchema, Mic, type MicHandle, type MicProps, ProgressCard, ProgressCardSchema, type ReactApp, type ReactSession, type ReactSessionDocument, type ReactSessionStream, type RegisteredComponent, type RequestCapableSession, type RequestStream, type ScopedSession, type ScopedStreamSource, type SessionIdleState, type SessionRequestOptions, SessionScope, type SessionScopeProps, type SessionWake, type SpineEntry, StatusBadge, StatusBadgeSchema, type StreamMessageEntry, TextStream, TextStreamSchema, type UrunAccessToken, type UrunAccessTokenProvider, UrunActivationOverlay, type UrunActivationOverlayProps, UrunAudio, type UrunAudioHandle, type UrunAudioLevel, type UrunAudioProps, type UrunAudioSessionSource, type UrunAudioStreamSource, type UrunAuthContextValue, type UrunAuthMode, UrunAuthProvider, type UrunAuthProviderProps, UrunCamera, type UrunCameraFacing, type UrunCameraHandle, type UrunCameraProps, type UrunCameraSessionSource, type UrunCameraStreamSource, UrunControlSender, type UrunControlSenderProps, UrunDocPanel, type UrunDocPanelProps, UrunErrorBoundary, UrunEventSpine, type UrunEventSpineProps, UrunIdleWarning, type UrunIdleWarningProps, UrunJwtProvider, UrunProvider, UrunSessionClock, type UrunSessionClockProps, UrunSessionEnded, type UrunSessionEndedProps, UrunSessionGate, type UrunSessionGateProps, UrunSessionStatus, type UrunSessionStatusProps, UrunSessionWaking, type UrunSessionWakingProps, UrunStreamTail, type UrunStreamTailProps, UrunVoice, type UrunVoiceHandle, type UrunVoiceProps, type UrunVoiceSessionSource, type UrunVoiceStreamSource, type UseChatOptions, type UseChatResult, type UseCompletionOptions, type UseCompletionResult, type UseInputPresenceOptions, type UseRequestOptions, type UseRequestResult, type UseSessionDocResult, type UseStreamMessagesOptions, type UseUrunAudioLevelOptions, type UseUrunPrewakeOptions, Video, type VideoHandle, type VideoProps, type VideoSessionSource, type VideoStreamSource, Voice, type VoiceHandle, type VoiceProps, type VoiceSessionSource, type VoiceStreamSource, type WorkbenchDocSource, type WorkbenchSession, type WorkbenchStreamSource, authMode, createDocStore, formatPayload, getUrunAudioContext, parseJsonObject, pushCapped, registerComponent, resumeUrunAudioContext, urunPublicEnv, useActivation, useApp, useChat, useCompletion, useDocStore, useImageFrame, useInputPresence, useMetricsPanel, useProgressCard, useRequest, useSessionDoc, useSessionEndsAt, useSessionIdle, useSessionPhase, useSessionTrack, useSessionWake, useStatusBadge, useStreamMessages, useTextStream, useUrunAudioLevel, useUrunAuth, useUrunPrewake, usesWorkOSAuth };