@xmaxai/sdk 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,235 @@
+import { S as SDKLocale, a as SDKI18n, b as XmaxOpenClient } from './rtc-manager-gYDkADGw.cjs';
+export { A as ACTIVE_STATUS, C as ClientOptions, c as CosSts, L as LocalPublishReadyResult, M as MEDIA_TIME_EPSILON_S, d as MEDIA_TIME_LOOP_JUMP_S, e as MOBILE_PUBLISH_MAX_WIDTH_PX, f as ModelExtra, P as PUBLISH_COLD_FRAME_TIMEOUT_MS, g as PUBLISH_COLD_MIN_FRAMES, h as PUBLISH_COLD_WARMUP_MS, i as PUBLISH_START_FRAME_TIMEOUT_MS, j as PUBLISH_START_MIN_FRAMES, k as PUBLISH_WARM_SKIP_MS, l as RTC_PUBLISH_FPS, m as RTC_PUBLISH_FPS_MOBILE, n as RTC_PUBLISH_FPS_WEB, o as RTC_PUBLISH_FRAME_INTERVAL_MS, p as RTC_PUBLISH_FRAME_INTERVAL_S, q as RemoteSeiReceivedPayload, r as ResolveRtcPublishFpsOptions, s as RtcJoinInfo, t as RtcLogEntry, u as RtcManager, R as RtcStateSnapshot, v as SDKMessages, w as Session, x as StsCredentials, U as UploadImageResult, y as UploadVideoResult, z as XMAX_OPEN_API_BASE_URLS, B as XMAX_OPEN_API_PRODUCTION_BASE_URL, D as XmaxLogEntry, E as XmaxSdkRegion, F as createSDKI18n, G as getDefaultMessages, H as isMobilePublishEnvironment, I as resolveRtcPublishFps, J as resolveRtcPublishFrameIntervalS } from './rtc-manager-gYDkADGw.cjs';
+export { D as DragTrackController, a as DragTrackControllerOptions, N as NativeCameraStream, O as OpenNativeCameraStreamOptions, R as RealtimeConnectOptions, b as RealtimeInitialState, c as RealtimeModel, d as RealtimePrewarmHandle, e as RealtimePromptState, f as RealtimeRestartOptions, g as RealtimeSession, h as RealtimeSetImageOptions, i as RealtimeSetInput, j as RealtimeSetModeOptions, k as RemoteViewHost, X as XmaxClient, l as XmaxClientFiles, m as XmaxClientOptions, n as XmaxRealtimeSession, o as createDragTrackController, p as createNativeCameraStream, q as createRemoteViewHost, r as createXmaxClient, s as getContentRect, t as mapTargetPointToCanvas, u as mapViewportPointToCoordinateSpace, v as models, w as observeDragSurfaceVideoSync, x as openNativeCameraStream, y as syncDragSurfaceToVideo } from './index-Dai62Sos.cjs';
+
+/**
+ * Open API business error codes (46xxx) mapped to user-facing messages.
+ * Source: Open API v1 error code tables. Codes not listed here fall back to a
+ * generic retry message (see `errors.requestRetry`).
+ */
+type LocalizedMessage = Record<SDKLocale, string>;
+declare const API_ERROR_MESSAGES: Record<string, LocalizedMessage>;
+/** Resolve a business error code to a localized message, or `undefined` if unmapped. */
+declare function resolveApiErrorMessage(code: string | number | null | undefined, locale: SDKLocale): string | undefined;
+
+type StartRtcRoomEvent = {
+    event: "start";
+    user_id?: string;
+    uid?: string;
+    session_uid?: string;
+    params: {
+        model: string;
+        size: [number, number];
+        prompt: string;
+        ref_image_path?: string;
+        ref_image?: string;
+        static_generate?: boolean;
+    } & Record<string, unknown>;
+};
+type StopRtcRoomEvent = {
+    event: "stop";
+    user_id?: string;
+    session_uid?: string;
+};
+type TracksRtcRoomEvent = {
+    event: "tracks";
+    user_id?: string;
+    uid?: string;
+    session_uid?: string;
+    tracks: Array<[number, number]>;
+};
+type RtcRoomEvent = StartRtcRoomEvent | StopRtcRoomEvent | TracksRtcRoomEvent;
+/** Generation task id sent as `uid` / `session_uid` in RTC room events. */
+declare function createTaskUid(): string;
+declare function createStartRtcRoomEvent(input: {
+    userId?: string;
+    uid?: string;
+    sessionUid?: string;
+    model: string;
+    size: [number, number];
+    prompt?: string;
+    refImagePath?: string;
+    refImage?: string;
+    /** MoX instant — static image generation that follows drag tracks. */
+    staticGenerate?: boolean;
+    extraParams?: Record<string, unknown>;
+}): StartRtcRoomEvent;
+declare function createStopRtcRoomEvent(input: {
+    userId?: string;
+    sessionUid?: string;
+}): StopRtcRoomEvent;
+declare function createTracksRtcRoomEvent(input: {
+    userId?: string;
+    uid?: string;
+    sessionUid?: string;
+    tracks: Array<[number, number]>;
+}): TracksRtcRoomEvent;
+
+type VideoInputHealth = {
+    currentTime: number;
+    duration: number;
+    paused: boolean;
+    ended: boolean;
+    readyState: number;
+    trackReadyState: string;
+    trackMuted: boolean;
+    stalled: boolean;
+    timeSinceAdvanceMs: number;
+};
+
+type VideoFileStreamOptions = {
+    loop?: boolean;
+    muted?: boolean;
+    playbackRate?: number;
+    /** @deprecated Upload video is playback-driven; fps is measured from the source file. */
+    fps?: number;
+    /** @deprecated Mobile/web publish fps is derived from the uploaded file. */
+    mobile?: boolean;
+    targetSize?: [number, number];
+    i18n?: SDKI18n;
+    onHealthReport?: (health: VideoInputHealth) => void;
+    healthIntervalMs?: number;
+    /** Log each canvas draw (proxy for frames fed to RTC captureStream). */
+    logPublishFrames?: boolean;
+};
+type VideoFileStream = {
+    url: string;
+    /** Same MediaStream pushed to RTC; bind to preview via srcObject for WYSIWYG. */
+    previewStream: MediaStream;
+    /** Capture-only element; pinned off-screen. */
+    videoEl: HTMLVideoElement;
+    videoTrack: MediaStreamTrack;
+    /** Measured source fps — encoder ceiling hint only. */
+    fps: number;
+    /** Session publish dimensions (native source size by default). */
+    width: number;
+    height: number;
+    /** Original media dimensions before scale. */
+    sourceWidth: number;
+    sourceHeight: number;
+    destroy: () => void;
+};
+declare function createVideoFileStream(fileOrUrl: File | string, options?: VideoFileStreamOptions): Promise<VideoFileStream>;
+
+type ImageFileStreamOptions = VideoFileStreamOptions;
+declare function createImageFileStream(fileOrUrl: File | string, options?: ImageFileStreamOptions): Promise<VideoFileStream>;
+declare function isImageMediaFile(file: File | string): boolean;
+declare function isVideoMediaFile(file: File | string): boolean;
+declare function createMediaFileStream(fileOrUrl: File | string, options?: ImageFileStreamOptions): Promise<VideoFileStream>;
+
+type MirroredCameraStream = {
+    /** Original camera stream from getUserMedia. */
+    sourceStream: MediaStream;
+    /** Horizontally flipped stream for RTC publish and local preview. */
+    previewStream: MediaStream;
+    videoTrack: MediaStreamTrack;
+    videoEl: HTMLVideoElement;
+    width: number;
+    height: number;
+    destroy: () => void;
+};
+type MirroredCameraStreamOptions = {
+    fps?: number;
+    /** Mobile H5 uses 24fps publish; web uses 30fps. Auto-detected from viewport when omitted. */
+    mobile?: boolean;
+    i18n?: SDKI18n;
+    /** Session target size — center-crop + scale before publish (WYSIWYG with preview). */
+    targetSize?: [number, number];
+    /** Horizontal flip before crop/scale. Defaults to true for legacy mirror helper. */
+    mirror?: boolean;
+};
+type OpenMirroredCameraStreamOptions = MirroredCameraStreamOptions & {
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    facingMode?: ConstrainDOMString;
+};
+declare function openMirroredCameraStream(options?: OpenMirroredCameraStreamOptions): Promise<MirroredCameraStream>;
+/** Canvas pipeline: optional mirror + center-crop/scale to session size for WYSIWYG publish. */
+declare function createPublishCameraStream(sourceStream: MediaStream, options?: MirroredCameraStreamOptions): Promise<MirroredCameraStream>;
+declare function createMirroredCameraStreamFromMediaStream(sourceStream: MediaStream, options?: MirroredCameraStreamOptions): Promise<MirroredCameraStream>;
+
+/** UI preview frames are fixed 16:9 per design; session `size` is separate (see resolveUploadVideoSize). */
+declare const PREVIEW_CONTAINER_ASPECT_RATIO: number;
+/** CSS `aspect-ratio` string for a session target size — keeps UI layout aligned with passed `size`. */
+declare function resolvePreviewAspectRatio(size: [number, number]): string;
+/** Default landscape session size under the 832 rule (16:9). */
+declare const DEFAULT_SESSION_TARGET_SIZE: [number, number];
+/**
+ * Upload publish size — keep source resolution (even dimensions for H.264).
+ * Avoids canvas downscale blur; camera path still uses {@link resolveUploadVideoSize}.
+ */
+declare function resolveUploadPublishSize(sourceWidth: number, sourceHeight: number): [number, number];
+/**
+ * Adaptive RTC encode/session size — mirrors iOS `rtcVideoSize(for:)`.
+ * Keeps the base width and scales height for wide sources; tall sources use the full base size.
+ */
+declare function resolveAdaptiveRtcVideoSize(sourceWidth: number, sourceHeight: number, baseSize?: [number, number]): [number, number];
+/**
+ * Session video size (camera + upload): scale from base edge 832, cap at 9:16 or 16:9.
+ * Portrait keeps width at 832; landscape keeps height at 832; the other edge is 32-aligned.
+ */
+declare function resolveUploadVideoSize(sourceWidth: number, sourceHeight: number): [number, number];
+declare function resolveSessionTargetSize(input: {
+    localVideoSize?: {
+        width: number;
+        height: number;
+    } | null;
+    overrideSize?: [number, number];
+}): [number, number];
+
+type CameraCaptureOptions = {
+    width: number;
+    height: number;
+    frameRate?: number;
+    facingMode?: ConstrainDOMString;
+};
+/** Camera control fields from Media Capture extensions; not in default lib.dom typings. */
+type CameraTrackCapabilities = MediaTrackCapabilities & {
+    focusMode?: string[];
+    focusDistance?: {
+        min: number;
+        max: number;
+        step?: number;
+    };
+    zoom?: {
+        min: number;
+        max: number;
+        step?: number;
+    };
+};
+type CameraTrackSettings = MediaTrackSettings & {
+    focusDistance?: number;
+};
+type CameraEnvironmentIssue = 'insecure-context' | 'api-unavailable';
+/** Detect blockers before calling getUserMedia (HTTP hides mediaDevices in Chrome). */
+declare function getCameraEnvironmentIssue(): CameraEnvironmentIssue | null;
+type CameraAccessErrorKind = 'not-found' | 'not-allowed' | 'permission-denied' | 'in-use' | 'overconstrained' | 'unsupported' | 'capture-unsupported' | 'generic';
+/** True for getUserMedia failures that should prompt the user to open/allow the device camera. */
+declare function isCameraAccessError(error: unknown): boolean;
+/** Map getUserMedia / camera pipeline failures to a stable category for user-facing copy. */
+declare function classifyCameraAccessError(error: unknown): CameraAccessErrorKind | null;
+/**
+ * Best-effort stabilization for rear camera AF hunting when objects move in frame.
+ * - Android: lock focus after initial settle (single-shot, else manual distance).
+ * - iOS / others: lock zoom to 1x when supported (Safari 17+); focus APIs are unavailable.
+ */
+declare function stabilizeCameraVideoTrack(track: MediaStreamTrack, options?: {
+    facingMode?: ConstrainDOMString;
+}): Promise<void>;
+/** Prefer target resolution via min constraints; fall back to ideal-only when unsupported. */
+declare function requestCameraMediaStream(options: CameraCaptureOptions): Promise<MediaStream>;
+
+declare function resolveRefImageUrl(client: XmaxOpenClient, input: File | string): Promise<string>;
+
+declare const PREVIEW_UPLOAD_LAYOUT_ATTR = "data-preview-upload-layout";
+/** Mobile upload output fit — `portrait` (h-full w-auto) or `landscape` (w-full h-auto). */
+declare const PREVIEW_UPLOAD_FIT_ATTR = "data-preview-upload-fit";
+declare const PREVIEW_OUTPUT_LAYOUT_ATTR = "data-preview-output-layout";
+declare const PREVIEW_CONTAIN_ATTR = "data-preview-contain";
+declare const PREVIEW_COVER_ATTR = "data-preview-cover";
+/** Match Playground upload overlay — portrait: h-full w-auto; landscape: w-full h-auto; centered clip. */
+declare function applyUploadPreviewMediaLayout(container: HTMLElement): void;
+declare function observeUploadPreviewMediaLayout(container: HTMLElement): () => void;
+
+export { API_ERROR_MESSAGES, type CameraAccessErrorKind, type CameraCaptureOptions, type CameraEnvironmentIssue, type CameraTrackCapabilities, type CameraTrackSettings, DEFAULT_SESSION_TARGET_SIZE, type ImageFileStreamOptions, type MirroredCameraStream, type MirroredCameraStreamOptions, type OpenMirroredCameraStreamOptions, PREVIEW_CONTAINER_ASPECT_RATIO, PREVIEW_CONTAIN_ATTR, PREVIEW_COVER_ATTR, PREVIEW_OUTPUT_LAYOUT_ATTR, PREVIEW_UPLOAD_FIT_ATTR, PREVIEW_UPLOAD_LAYOUT_ATTR, type RtcRoomEvent, SDKI18n, SDKLocale, type StartRtcRoomEvent, type StopRtcRoomEvent, type TracksRtcRoomEvent, type VideoFileStream, type VideoFileStreamOptions, XmaxOpenClient, applyUploadPreviewMediaLayout, classifyCameraAccessError, createImageFileStream, createMediaFileStream, createMirroredCameraStreamFromMediaStream, createPublishCameraStream, createStartRtcRoomEvent, createStopRtcRoomEvent, createTaskUid, createTracksRtcRoomEvent, createVideoFileStream, getCameraEnvironmentIssue, isCameraAccessError, isImageMediaFile, isVideoMediaFile, observeUploadPreviewMediaLayout, openMirroredCameraStream, requestCameraMediaStream, resolveAdaptiveRtcVideoSize, resolveApiErrorMessage, resolvePreviewAspectRatio, resolveRefImageUrl, resolveSessionTargetSize, resolveUploadPublishSize, resolveUploadVideoSize, stabilizeCameraVideoTrack };

package/dist/index.d.ts

@@ -0,0 +1,235 @@
+import { S as SDKLocale, a as SDKI18n, b as XmaxOpenClient } from './rtc-manager-gYDkADGw.js';
+export { A as ACTIVE_STATUS, C as ClientOptions, c as CosSts, L as LocalPublishReadyResult, M as MEDIA_TIME_EPSILON_S, d as MEDIA_TIME_LOOP_JUMP_S, e as MOBILE_PUBLISH_MAX_WIDTH_PX, f as ModelExtra, P as PUBLISH_COLD_FRAME_TIMEOUT_MS, g as PUBLISH_COLD_MIN_FRAMES, h as PUBLISH_COLD_WARMUP_MS, i as PUBLISH_START_FRAME_TIMEOUT_MS, j as PUBLISH_START_MIN_FRAMES, k as PUBLISH_WARM_SKIP_MS, l as RTC_PUBLISH_FPS, m as RTC_PUBLISH_FPS_MOBILE, n as RTC_PUBLISH_FPS_WEB, o as RTC_PUBLISH_FRAME_INTERVAL_MS, p as RTC_PUBLISH_FRAME_INTERVAL_S, q as RemoteSeiReceivedPayload, r as ResolveRtcPublishFpsOptions, s as RtcJoinInfo, t as RtcLogEntry, u as RtcManager, R as RtcStateSnapshot, v as SDKMessages, w as Session, x as StsCredentials, U as UploadImageResult, y as UploadVideoResult, z as XMAX_OPEN_API_BASE_URLS, B as XMAX_OPEN_API_PRODUCTION_BASE_URL, D as XmaxLogEntry, E as XmaxSdkRegion, F as createSDKI18n, G as getDefaultMessages, H as isMobilePublishEnvironment, I as resolveRtcPublishFps, J as resolveRtcPublishFrameIntervalS } from './rtc-manager-gYDkADGw.js';
+export { D as DragTrackController, a as DragTrackControllerOptions, N as NativeCameraStream, O as OpenNativeCameraStreamOptions, R as RealtimeConnectOptions, b as RealtimeInitialState, c as RealtimeModel, d as RealtimePrewarmHandle, e as RealtimePromptState, f as RealtimeRestartOptions, g as RealtimeSession, h as RealtimeSetImageOptions, i as RealtimeSetInput, j as RealtimeSetModeOptions, k as RemoteViewHost, X as XmaxClient, l as XmaxClientFiles, m as XmaxClientOptions, n as XmaxRealtimeSession, o as createDragTrackController, p as createNativeCameraStream, q as createRemoteViewHost, r as createXmaxClient, s as getContentRect, t as mapTargetPointToCanvas, u as mapViewportPointToCoordinateSpace, v as models, w as observeDragSurfaceVideoSync, x as openNativeCameraStream, y as syncDragSurfaceToVideo } from './index-BIUk_kvb.js';
+
+/**
+ * Open API business error codes (46xxx) mapped to user-facing messages.
+ * Source: Open API v1 error code tables. Codes not listed here fall back to a
+ * generic retry message (see `errors.requestRetry`).
+ */
+type LocalizedMessage = Record<SDKLocale, string>;
+declare const API_ERROR_MESSAGES: Record<string, LocalizedMessage>;
+/** Resolve a business error code to a localized message, or `undefined` if unmapped. */
+declare function resolveApiErrorMessage(code: string | number | null | undefined, locale: SDKLocale): string | undefined;
+
+type StartRtcRoomEvent = {
+    event: "start";
+    user_id?: string;
+    uid?: string;
+    session_uid?: string;
+    params: {
+        model: string;
+        size: [number, number];
+        prompt: string;
+        ref_image_path?: string;
+        ref_image?: string;
+        static_generate?: boolean;
+    } & Record<string, unknown>;
+};
+type StopRtcRoomEvent = {
+    event: "stop";
+    user_id?: string;
+    session_uid?: string;
+};
+type TracksRtcRoomEvent = {
+    event: "tracks";
+    user_id?: string;
+    uid?: string;
+    session_uid?: string;
+    tracks: Array<[number, number]>;
+};
+type RtcRoomEvent = StartRtcRoomEvent | StopRtcRoomEvent | TracksRtcRoomEvent;
+/** Generation task id sent as `uid` / `session_uid` in RTC room events. */
+declare function createTaskUid(): string;
+declare function createStartRtcRoomEvent(input: {
+    userId?: string;
+    uid?: string;
+    sessionUid?: string;
+    model: string;
+    size: [number, number];
+    prompt?: string;
+    refImagePath?: string;
+    refImage?: string;
+    /** MoX instant — static image generation that follows drag tracks. */
+    staticGenerate?: boolean;
+    extraParams?: Record<string, unknown>;
+}): StartRtcRoomEvent;
+declare function createStopRtcRoomEvent(input: {
+    userId?: string;
+    sessionUid?: string;
+}): StopRtcRoomEvent;
+declare function createTracksRtcRoomEvent(input: {
+    userId?: string;
+    uid?: string;
+    sessionUid?: string;
+    tracks: Array<[number, number]>;
+}): TracksRtcRoomEvent;
+
+type VideoInputHealth = {
+    currentTime: number;
+    duration: number;
+    paused: boolean;
+    ended: boolean;
+    readyState: number;
+    trackReadyState: string;
+    trackMuted: boolean;
+    stalled: boolean;
+    timeSinceAdvanceMs: number;
+};
+
+type VideoFileStreamOptions = {
+    loop?: boolean;
+    muted?: boolean;
+    playbackRate?: number;
+    /** @deprecated Upload video is playback-driven; fps is measured from the source file. */
+    fps?: number;
+    /** @deprecated Mobile/web publish fps is derived from the uploaded file. */
+    mobile?: boolean;
+    targetSize?: [number, number];
+    i18n?: SDKI18n;
+    onHealthReport?: (health: VideoInputHealth) => void;
+    healthIntervalMs?: number;
+    /** Log each canvas draw (proxy for frames fed to RTC captureStream). */
+    logPublishFrames?: boolean;
+};
+type VideoFileStream = {
+    url: string;
+    /** Same MediaStream pushed to RTC; bind to preview via srcObject for WYSIWYG. */
+    previewStream: MediaStream;
+    /** Capture-only element; pinned off-screen. */
+    videoEl: HTMLVideoElement;
+    videoTrack: MediaStreamTrack;
+    /** Measured source fps — encoder ceiling hint only. */
+    fps: number;
+    /** Session publish dimensions (native source size by default). */
+    width: number;
+    height: number;
+    /** Original media dimensions before scale. */
+    sourceWidth: number;
+    sourceHeight: number;
+    destroy: () => void;
+};
+declare function createVideoFileStream(fileOrUrl: File | string, options?: VideoFileStreamOptions): Promise<VideoFileStream>;
+
+type ImageFileStreamOptions = VideoFileStreamOptions;
+declare function createImageFileStream(fileOrUrl: File | string, options?: ImageFileStreamOptions): Promise<VideoFileStream>;
+declare function isImageMediaFile(file: File | string): boolean;
+declare function isVideoMediaFile(file: File | string): boolean;
+declare function createMediaFileStream(fileOrUrl: File | string, options?: ImageFileStreamOptions): Promise<VideoFileStream>;
+
+type MirroredCameraStream = {
+    /** Original camera stream from getUserMedia. */
+    sourceStream: MediaStream;
+    /** Horizontally flipped stream for RTC publish and local preview. */
+    previewStream: MediaStream;
+    videoTrack: MediaStreamTrack;
+    videoEl: HTMLVideoElement;
+    width: number;
+    height: number;
+    destroy: () => void;
+};
+type MirroredCameraStreamOptions = {
+    fps?: number;
+    /** Mobile H5 uses 24fps publish; web uses 30fps. Auto-detected from viewport when omitted. */
+    mobile?: boolean;
+    i18n?: SDKI18n;
+    /** Session target size — center-crop + scale before publish (WYSIWYG with preview). */
+    targetSize?: [number, number];
+    /** Horizontal flip before crop/scale. Defaults to true for legacy mirror helper. */
+    mirror?: boolean;
+};
+type OpenMirroredCameraStreamOptions = MirroredCameraStreamOptions & {
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    facingMode?: ConstrainDOMString;
+};
+declare function openMirroredCameraStream(options?: OpenMirroredCameraStreamOptions): Promise<MirroredCameraStream>;
+/** Canvas pipeline: optional mirror + center-crop/scale to session size for WYSIWYG publish. */
+declare function createPublishCameraStream(sourceStream: MediaStream, options?: MirroredCameraStreamOptions): Promise<MirroredCameraStream>;
+declare function createMirroredCameraStreamFromMediaStream(sourceStream: MediaStream, options?: MirroredCameraStreamOptions): Promise<MirroredCameraStream>;
+
+/** UI preview frames are fixed 16:9 per design; session `size` is separate (see resolveUploadVideoSize). */
+declare const PREVIEW_CONTAINER_ASPECT_RATIO: number;
+/** CSS `aspect-ratio` string for a session target size — keeps UI layout aligned with passed `size`. */
+declare function resolvePreviewAspectRatio(size: [number, number]): string;
+/** Default landscape session size under the 832 rule (16:9). */
+declare const DEFAULT_SESSION_TARGET_SIZE: [number, number];
+/**
+ * Upload publish size — keep source resolution (even dimensions for H.264).
+ * Avoids canvas downscale blur; camera path still uses {@link resolveUploadVideoSize}.
+ */
+declare function resolveUploadPublishSize(sourceWidth: number, sourceHeight: number): [number, number];
+/**
+ * Adaptive RTC encode/session size — mirrors iOS `rtcVideoSize(for:)`.
+ * Keeps the base width and scales height for wide sources; tall sources use the full base size.
+ */
+declare function resolveAdaptiveRtcVideoSize(sourceWidth: number, sourceHeight: number, baseSize?: [number, number]): [number, number];
+/**
+ * Session video size (camera + upload): scale from base edge 832, cap at 9:16 or 16:9.
+ * Portrait keeps width at 832; landscape keeps height at 832; the other edge is 32-aligned.
+ */
+declare function resolveUploadVideoSize(sourceWidth: number, sourceHeight: number): [number, number];
+declare function resolveSessionTargetSize(input: {
+    localVideoSize?: {
+        width: number;
+        height: number;
+    } | null;
+    overrideSize?: [number, number];
+}): [number, number];
+
+type CameraCaptureOptions = {
+    width: number;
+    height: number;
+    frameRate?: number;
+    facingMode?: ConstrainDOMString;
+};
+/** Camera control fields from Media Capture extensions; not in default lib.dom typings. */
+type CameraTrackCapabilities = MediaTrackCapabilities & {
+    focusMode?: string[];
+    focusDistance?: {
+        min: number;
+        max: number;
+        step?: number;
+    };
+    zoom?: {
+        min: number;
+        max: number;
+        step?: number;
+    };
+};
+type CameraTrackSettings = MediaTrackSettings & {
+    focusDistance?: number;
+};
+type CameraEnvironmentIssue = 'insecure-context' | 'api-unavailable';
+/** Detect blockers before calling getUserMedia (HTTP hides mediaDevices in Chrome). */
+declare function getCameraEnvironmentIssue(): CameraEnvironmentIssue | null;
+type CameraAccessErrorKind = 'not-found' | 'not-allowed' | 'permission-denied' | 'in-use' | 'overconstrained' | 'unsupported' | 'capture-unsupported' | 'generic';
+/** True for getUserMedia failures that should prompt the user to open/allow the device camera. */
+declare function isCameraAccessError(error: unknown): boolean;
+/** Map getUserMedia / camera pipeline failures to a stable category for user-facing copy. */
+declare function classifyCameraAccessError(error: unknown): CameraAccessErrorKind | null;
+/**
+ * Best-effort stabilization for rear camera AF hunting when objects move in frame.
+ * - Android: lock focus after initial settle (single-shot, else manual distance).
+ * - iOS / others: lock zoom to 1x when supported (Safari 17+); focus APIs are unavailable.
+ */
+declare function stabilizeCameraVideoTrack(track: MediaStreamTrack, options?: {
+    facingMode?: ConstrainDOMString;
+}): Promise<void>;
+/** Prefer target resolution via min constraints; fall back to ideal-only when unsupported. */
+declare function requestCameraMediaStream(options: CameraCaptureOptions): Promise<MediaStream>;
+
+declare function resolveRefImageUrl(client: XmaxOpenClient, input: File | string): Promise<string>;
+
+declare const PREVIEW_UPLOAD_LAYOUT_ATTR = "data-preview-upload-layout";
+/** Mobile upload output fit — `portrait` (h-full w-auto) or `landscape` (w-full h-auto). */
+declare const PREVIEW_UPLOAD_FIT_ATTR = "data-preview-upload-fit";
+declare const PREVIEW_OUTPUT_LAYOUT_ATTR = "data-preview-output-layout";
+declare const PREVIEW_CONTAIN_ATTR = "data-preview-contain";
+declare const PREVIEW_COVER_ATTR = "data-preview-cover";
+/** Match Playground upload overlay — portrait: h-full w-auto; landscape: w-full h-auto; centered clip. */
+declare function applyUploadPreviewMediaLayout(container: HTMLElement): void;
+declare function observeUploadPreviewMediaLayout(container: HTMLElement): () => void;
+
+export { API_ERROR_MESSAGES, type CameraAccessErrorKind, type CameraCaptureOptions, type CameraEnvironmentIssue, type CameraTrackCapabilities, type CameraTrackSettings, DEFAULT_SESSION_TARGET_SIZE, type ImageFileStreamOptions, type MirroredCameraStream, type MirroredCameraStreamOptions, type OpenMirroredCameraStreamOptions, PREVIEW_CONTAINER_ASPECT_RATIO, PREVIEW_CONTAIN_ATTR, PREVIEW_COVER_ATTR, PREVIEW_OUTPUT_LAYOUT_ATTR, PREVIEW_UPLOAD_FIT_ATTR, PREVIEW_UPLOAD_LAYOUT_ATTR, type RtcRoomEvent, SDKI18n, SDKLocale, type StartRtcRoomEvent, type StopRtcRoomEvent, type TracksRtcRoomEvent, type VideoFileStream, type VideoFileStreamOptions, XmaxOpenClient, applyUploadPreviewMediaLayout, classifyCameraAccessError, createImageFileStream, createMediaFileStream, createMirroredCameraStreamFromMediaStream, createPublishCameraStream, createStartRtcRoomEvent, createStopRtcRoomEvent, createTaskUid, createTracksRtcRoomEvent, createVideoFileStream, getCameraEnvironmentIssue, isCameraAccessError, isImageMediaFile, isVideoMediaFile, observeUploadPreviewMediaLayout, openMirroredCameraStream, requestCameraMediaStream, resolveAdaptiveRtcVideoSize, resolveApiErrorMessage, resolvePreviewAspectRatio, resolveRefImageUrl, resolveSessionTargetSize, resolveUploadPublishSize, resolveUploadVideoSize, stabilizeCameraVideoTrack };