@pickleball/expo-sdk 0.2.0 → 1.0.0

package/dist/ui/index.d.ts

@@ -0,0 +1,493 @@
+import React, { ReactNode, ComponentType } from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+import { d as CameraSettingsStore, A as AntiFlickerMode, a as CameraCapabilities } from '../camera-controls-rCBUGGPC.js';
+import { k as ExpoSdkErrorCode, e as CameraDeviceInfo, n as LivestreamState } from '../engine-BSvSdCSE.js';
+
+/**
+ * Chữ trên màn hình camera + sheet cấu hình (vi/en). Chuyển từ
+ * apps/device-streamer; bản en là bản dịch tương đương để app đối tác dùng
+ * được ngay. App muốn chữ khác thì truyền prop (statusPill/statusHint/title)
+ * — không cần fork màn hình.
+ */
+
+type UiLocale = "vi" | "en";
+interface UiCopy {
+    pill: {
+        opening: string;
+        ready: string;
+        connecting: string;
+        paused: string;
+        court: string;
+        standby: string;
+        live: string;
+        reconnecting: string;
+        ending: string;
+        error: string;
+    };
+    hint: {
+        casualPreview: string;
+        casualStandby: string;
+        paused: string;
+        courtPreview: string;
+        courtStandby: (court: string) => string;
+        courtStandbyNoCourt: string;
+        connecting: string;
+        reconnecting: string;
+        ending: string;
+        errorFallback: string;
+        cameraOpening: string;
+        cameraError: string;
+    };
+    button: {
+        goLive: string;
+        publishNow: string;
+        resume: string;
+        stop: string;
+        stopQuestion: string;
+        confirmStop: string;
+        cancel: string;
+        retry: string;
+        connecting: string;
+        ending: string;
+    };
+    lens: {
+        front: string;
+    };
+    thermal: {
+        title: string;
+        subtitle: string;
+    };
+    /** Tiêu đề + cách xử lý theo mã lỗi (chuyển từ LivestreamScreen 0.x). */
+    errors: {
+        title: Record<ExpoSdkErrorCode, string>;
+        remediation: Record<ExpoSdkErrorCode, string>;
+        technicalDetail: string;
+    };
+    sheet: {
+        title: string;
+        close: string;
+        /** Nhãn a11y của vùng nền bấm-để-đóng (khác nút ✕ để test/đọc màn hình phân biệt). */
+        closeBackdrop: string;
+        resolution: string;
+        fps: string;
+        fps60Note: string;
+        antiFlicker: string;
+        antiFlickerNote: string;
+        auto: string;
+        lockedNote: string;
+        defaultCamera: string;
+        autoCamera: string;
+        autoCameraHint: string;
+        frontCamera: string;
+        backCamera: string;
+        cameraIdHint: (id: string) => string;
+        zoom: string;
+        ev: string;
+        focusLock: string;
+        exposureLock: string;
+        torch: string;
+        network: string;
+        runCheck: string;
+        running: string;
+        busyNote: string;
+        resultLine: (input: {
+            uploadMbps: number;
+            requiredMbps: number;
+            resolution: number;
+            fps: number;
+            pingMs: number | null;
+        }) => string;
+        good: string;
+        ok: string;
+        low: string;
+        checkError: string;
+    };
+}
+declare const uiCopy: Record<UiLocale, UiCopy>;
+
+interface CameraControlsSheetSections {
+    quality?: boolean;
+    antiFlicker?: boolean;
+    camera?: boolean;
+    zoom?: boolean;
+    exposure?: boolean;
+    locks?: boolean;
+    torch?: boolean;
+    uplink?: boolean;
+}
+interface CameraControlsSheetProps {
+    visible: boolean;
+    onClose: () => void;
+    settings: CameraSettingsStore;
+    /** Ẩn mục không cần (mặc định hiện tất cả). */
+    sections?: CameraControlsSheetSections;
+    /** Đo mạng: đích POST + HEAD đo RTT (VD ingest của bạn). */
+    uplink?: {
+        uploadUrl?: string;
+        pingUrl?: string;
+    };
+    /**
+     * "side": panel nửa phải (màn ngang); "bottom": bottom-sheet (màn dọc);
+     * "auto" (mặc định) theo kích thước cửa sổ.
+     */
+    layout?: "auto" | "side" | "bottom";
+    title?: string;
+    /** Hàng thêm của app ở cuối sheet (Picklive Camera: Nguồn, Thoát kiosk, badge OTA). */
+    footer?: ReactNode;
+    locale?: UiLocale;
+}
+declare function CameraControlsSheet(props: CameraControlsSheetProps): React.JSX.Element;
+
+/** Luật THUẦN của màn hình camera — test được, không React. */
+interface StatusPill$1 {
+    label: string;
+    color: string;
+}
+/** Màu ngữ nghĩa của pill — trùng bảng màu app Picklive Camera (không theo theme). */
+declare const PILL_COLORS: Readonly<{
+    gray: "#6b7280";
+    green: "#22c55e";
+    amber: "#f59e0b";
+    orange: "#f97316";
+    red: "#ef4444";
+    darkRed: "#b91c1c";
+}>;
+interface StatusPillOptions {
+    /** elapsedMs > 0 ở standby = đã phát rồi hạ về chờ (tạm dừng). */
+    elapsedMs?: number;
+    /** Phiên gắn sân: standby là "TRỰC SÂN" thay vì "SẴN SÀNG PHÁT". */
+    courtBound?: boolean;
+    locale?: UiLocale;
+}
+/** Pill theo TỪNG trạng thái engine — không gộp chung "Đang chờ". */
+declare function statusPillFor(state: LivestreamState, options?: StatusPillOptions): StatusPill$1;
+/** Đuôi sessionId để đối chiếu với URL /dashboard/<id> — đủ phân biệt, không tràn màn hình. */
+declare function shortSessionId(sessionId: string): string;
+/** mm:ss (hoặc h:mm:ss khi qua giờ) từ elapsedMs của engine — đếm thời gian PHÁT. */
+declare function formatElapsed(ms: number): string;
+/**
+ * Nhãn lens từ label tiếng Anh của native ("Back Ultra Wide Camera", "Back
+ * Telephoto Camera", …) — load-bearing: native dựng nhãn đúng dạng này để UI
+ * dò được (native-contract test giữ hợp đồng).
+ */
+declare function lensShortLabel(label: string): string;
+/** previewTrack của engine ở mode device-rtmp là `{kind:"rtmp"}` — JS không có track để bind. */
+declare function isRtmpPreview(previewTrack: unknown): boolean;
+/** Lens đang chọn: id engine chọn tường minh, không thì lens 1x mặc định của camera sau. */
+declare function activeLensId(cameras: CameraDeviceInfo[], selectedCameraId: string | null): string | null;
+
+/**
+ * Màn hình camera dựng sẵn — bố cục của Picklive Camera (preview full-bleed,
+ * pill + tên/id phiên, hint, hàng lens, dòng info, •••, tối màn hình tiết kiệm
+ * nhiệt) cộng nút chính cho chế độ casual.
+ *
+ * Màn hình KHÔNG tự xin grant: casual thì `onGoLive` của app xin grant từ
+ * backend đối tác rồi gọi `live.start(input, {autoPublish:true})`; chế độ sân
+ * thì app arm bằng useStandbySession và trọng tài lật live qua match-start.
+ * Mọi ô chữ đều ghi đè được bằng prop để app fleet/đối tác chèn trạng thái
+ * của riêng mình (CHỜ GHÉP, tên máy, mã ghép…).
+ */
+type CameraScreenMode = "casual" | "court";
+interface CameraScreenSheetRenderProps {
+    visible: boolean;
+    onClose: () => void;
+}
+interface PickleballCameraScreenProps {
+    /** casual (mặc định): user bấm phát/dừng trên máy; court: đứng chờ lệnh server. */
+    mode?: CameraScreenMode;
+    /** Store cấu hình camera — nuôi dòng info + sheet ••• + chống chớp đèn. */
+    settings?: CameraSettingsStore;
+    /** Nút chính (Bắt đầu phát / Phát ngay / Dừng). Mặc định: bật ở casual, tắt ở court. */
+    showGoLiveButton?: boolean;
+    /** Casual, ở preview: app xin grant rồi start(autoPublish). Không có → ẩn nút ở preview. */
+    onGoLive?: () => void | Promise<void>;
+    /** Mặc định live.stop("user"). */
+    onStop?: () => void | Promise<void>;
+    /** Tiêu đề phiên (SDK không giữ tiêu đề trong snapshot). */
+    title?: string;
+    /** Nhãn sân cho hint chế độ court. */
+    courtLabel?: string;
+    /** Ghi đè pill (null = ẩn; undefined = mặc định theo state). */
+    statusPill?: StatusPill$1 | null;
+    /** Ghi đè dòng hint (null = ẩn; undefined = mặc định theo state/mode). */
+    statusHint?: string | null;
+    /** Màu chấm trước hint (app fleet: xanh khi kênh điều khiển đã mở). */
+    statusHintDotColor?: string;
+    /** Góc trên phải, cạnh nút ••• (fleet: chip tên máy). */
+    renderTopRight?: () => ReactNode;
+    /** Dưới dòng info (fleet: badge OTA). */
+    renderBottom?: () => ReactNode;
+    /** Giữa màn hình (fleet: thẻ mã ghép). */
+    children?: ReactNode;
+    /**
+     * Sheet •••: false = không có nút; bỏ trống = CameraControlsSheet mặc định
+     * (cần `settings`); hàm = app dựng sheet của mình với {visible,onClose}.
+     */
+    controls?: false | ((sheet: CameraScreenSheetRenderProps) => ReactNode);
+    /** Props chuyển cho CameraControlsSheet mặc định (sections/uplink/footer/layout). */
+    controlsProps?: Omit<CameraControlsSheetProps, "visible" | "onClose" | "settings">;
+    /** Hàng chọn lens (mặc định bật). */
+    lensRow?: boolean;
+    /** Dòng info dưới lens (null = ẩn; mặc định "720p • 30 fps • H.264" từ settings). */
+    infoLine?: string | null;
+    /** Tự mở camera khi idle/ended (mặc định bật). Tắt nếu app tự lo (fleet có chế độ nghỉ). */
+    autoPrepare?: boolean;
+    captureOrientation?: "portrait" | "landscape";
+    /** Tối màn hình sau chừng này ms ở LIVE; null = tắt. Mặc định 30s. */
+    thermalDimAfterMs?: number | null;
+    /** Dòng phụ trên màn tối (fleet: tên máy). */
+    thermalDimCaption?: string;
+    locale?: UiLocale;
+    style?: StyleProp<ViewStyle>;
+}
+declare function PickleballCameraScreen(props: PickleballCameraScreenProps): React.JSX.Element;
+
+/**
+ * Bounds + cờ hỗ trợ của lens đang gắn — đọc lại khi `active` bật (mở sheet)
+ * và khi đổi lens. null = module/hàm chưa có hoặc camera chưa mở → UI ẩn control.
+ */
+declare function useCameraCapabilities(active: boolean, cameraKey: string | null): CameraCapabilities | null;
+/**
+ * Tự tối màn hình tiết kiệm nhiệt/pin sau `afterMs` ở trạng thái LIVE; chạm để
+ * bật lại (setDimmed(false)). null = tắt tính năng.
+ */
+declare function useThermalDim(state: LivestreamState, afterMs: number | null): [boolean, (dimmed: boolean) => void];
+/**
+ * Đẩy chế độ chống chớp xuống native khi mount + mỗi lần đổi. Gọi trước khi
+ * camera mở cũng không mất — native lưu giá trị và tự áp lại mỗi lần
+ * attachCamera (kể cả đổi lens). iOS/binary cũ thiếu hàm → no-op.
+ */
+declare function useAntiFlicker(mode: AntiFlickerMode | undefined): void;
+
+type PreviewComponent = ComponentType<{
+    style?: StyleProp<ViewStyle>;
+}>;
+/**
+ * View native của @pickleball/rtmp-native, nạp LƯỜI: import tĩnh là app nào
+ * chưa cài module (hoặc static-render web của expo-router) gãy ngay lúc
+ * import subpath ./ui. Không có module → null, màn hình vẽ nền tối thay vì
+ * khung hình.
+ *
+ * BẮT BUỘC render view này khi camera đã mở, nếu không màn preview TỐI ĐEN:
+ * native vẫn encode bình thường nhưng không có đích để vẽ khung hình.
+ */
+declare function getRtmpPreviewView(): PreviewComponent | null;
+/** Cho test: xoá cache để mock module khác. */
+declare function resetRtmpPreviewViewCache(): void;
+declare function RtmpPreview({ style }: {
+    style?: StyleProp<ViewStyle>;
+}): React.JSX.Element | null;
+
+/**
+ * Khối dựng sẵn của màn hình camera / sheet cấu hình — export để app đối tác
+ * ghép thêm hàng của riêng mình vào footer sheet (Picklive Camera: "Nguồn",
+ * "Thoát kiosk") mà vẫn cùng một ngôn ngữ hình ảnh.
+ */
+declare const uiColors: Readonly<{
+    ink: "#0a0a0b";
+    text: "#ffffff";
+    textSecondary: "#e5e7eb";
+    textMuted: "#d1d5db";
+    textDim: "#9ca3af";
+    border: "#3f3f46";
+    panel: "rgba(15,15,19,0.93)";
+    chip: "rgba(0,0,0,0.55)";
+    chipStrong: "rgba(0,0,0,0.72)";
+    surface: "rgba(255,255,255,0.06)";
+    hairline: "rgba(255,255,255,0.08)";
+    good: "#4ade80";
+    ok: "#facc15";
+    low: "#f87171";
+}>;
+declare function StatusPill({ label, color, style, }: {
+    label: string;
+    color: string;
+    style?: StyleProp<ViewStyle>;
+}): React.JSX.Element;
+declare function ControlRow({ label, children }: {
+    label: string;
+    children?: ReactNode;
+}): React.JSX.Element;
+declare function Note({ children }: {
+    children: ReactNode;
+}): React.JSX.Element;
+declare function ActionButton({ label, onPress, disabled, accessibilityLabel, }: {
+    label: string;
+    onPress: () => void;
+    disabled?: boolean;
+    accessibilityLabel?: string;
+}): React.JSX.Element;
+/** Một dòng chọn camera — nhãn + id, vì nhãn máy thật hay trùng nhau. */
+declare function CameraOption({ label, hint, active, disabled, onPress, }: {
+    label: string;
+    hint: string;
+    active: boolean;
+    disabled?: boolean;
+    onPress: () => void;
+}): React.JSX.Element;
+declare function Segmented<T extends number | string>({ options, value, disabled, onChange, }: {
+    options: Array<{
+        value: T;
+        label: string;
+    }>;
+    value: T;
+    disabled?: boolean;
+    onChange: (value: T) => void;
+}): React.JSX.Element;
+declare function PresetButton({ label, active, onPress, }: {
+    label: string;
+    active: boolean;
+    onPress: () => void;
+}): React.JSX.Element;
+/** Hàng chọn ống kính: 0.5x / 1x / Tele (camera sau) + camera trước nếu có. */
+declare function LensRow({ cameras, selectedCameraId, onSelect, locale, }: {
+    cameras: CameraDeviceInfo[];
+    selectedCameraId: string | null;
+    onSelect: (deviceId: string) => void;
+    locale?: UiLocale;
+}): React.JSX.Element | null;
+declare const uiStyles: {
+    pill: {
+        borderRadius: number;
+        paddingHorizontal: number;
+        paddingVertical: number;
+    };
+    pillText: {
+        color: "#ffffff";
+        fontWeight: "800";
+        fontSize: number;
+        letterSpacing: number;
+        fontVariant: "tabular-nums"[];
+    };
+    row: {
+        flexDirection: "row";
+        alignItems: "center";
+        justifyContent: "space-between";
+        gap: number;
+        minHeight: number;
+    };
+    rowLabel: {
+        color: "#e5e7eb";
+        fontSize: number;
+        fontWeight: "600";
+    };
+    note: {
+        color: "#9ca3af";
+        fontSize: number;
+        lineHeight: number;
+    };
+    actionButton: {
+        borderRadius: number;
+        backgroundColor: "rgba(255,255,255,0.06)";
+        borderWidth: number;
+        borderColor: "#3f3f46";
+        paddingHorizontal: number;
+        paddingVertical: number;
+        alignSelf: "flex-start";
+    };
+    actionButtonText: {
+        color: "#e5e7eb";
+        fontSize: number;
+        fontWeight: "700";
+    };
+    cameraOption: {
+        flexDirection: "row";
+        alignItems: "center";
+        justifyContent: "space-between";
+        gap: number;
+        backgroundColor: "rgba(255,255,255,0.06)";
+        borderRadius: number;
+        paddingHorizontal: number;
+        paddingVertical: number;
+    };
+    cameraOptionActive: {
+        backgroundColor: "#ffffff";
+    };
+    cameraOptionText: {
+        color: "#d1d5db";
+        fontSize: number;
+        fontWeight: "700";
+    };
+    cameraOptionHint: {
+        color: "#9ca3af";
+        fontSize: number;
+        flexShrink: number;
+    };
+    cameraOptionTextActive: {
+        color: "#0a0a0b";
+    };
+    segmented: {
+        flexDirection: "row";
+        backgroundColor: "rgba(255,255,255,0.06)";
+        borderRadius: number;
+        padding: number;
+    };
+    segment: {
+        borderRadius: number;
+        paddingHorizontal: number;
+        paddingVertical: number;
+    };
+    segmentActive: {
+        backgroundColor: "#ffffff";
+    };
+    segmentText: {
+        color: "#d1d5db";
+        fontSize: number;
+        fontWeight: "700";
+    };
+    segmentTextActive: {
+        color: "#0a0a0b";
+    };
+    disabled: {
+        opacity: number;
+    };
+    presetRow: {
+        flexDirection: "row";
+        gap: number;
+        flexWrap: "wrap";
+    };
+    preset: {
+        borderRadius: number;
+        borderWidth: number;
+        borderColor: "#3f3f46";
+        paddingHorizontal: number;
+        paddingVertical: number;
+    };
+    presetActive: {
+        backgroundColor: "#ffffff";
+        borderColor: "#ffffff";
+    };
+    presetText: {
+        color: "#d1d5db";
+        fontSize: number;
+        fontWeight: "700";
+    };
+    presetTextActive: {
+        color: "#0a0a0b";
+    };
+    lensRow: {
+        flexDirection: "row";
+        gap: number;
+        backgroundColor: "rgba(0,0,0,0.55)";
+        borderRadius: number;
+        padding: number;
+    };
+    lensButton: {
+        borderRadius: number;
+        paddingHorizontal: number;
+        paddingVertical: number;
+    };
+    lensButtonActive: {
+        backgroundColor: "#ffffff";
+    };
+    lensText: {
+        color: "#e5e7eb";
+        fontSize: number;
+        fontWeight: "700";
+    };
+    lensTextActive: {
+        color: "#0a0a0b";
+    };
+};
+
+export { ActionButton, CameraControlsSheet, type CameraControlsSheetProps, type CameraControlsSheetSections, CameraOption, type CameraScreenMode, type CameraScreenSheetRenderProps, ControlRow, LensRow, Note, PILL_COLORS, PickleballCameraScreen, type PickleballCameraScreenProps, PresetButton, RtmpPreview, Segmented, StatusPill, type StatusPillOptions, type StatusPill$1 as StatusPillValue, type UiCopy, type UiLocale, activeLensId, formatElapsed, getRtmpPreviewView, isRtmpPreview, lensShortLabel, resetRtmpPreviewViewCache, shortSessionId, statusPillFor, uiColors, uiCopy, uiStyles, useAntiFlicker, useCameraCapabilities, useThermalDim };