@useupup/vanilla 3.3.0

package/dist/types-412b3393.d.cts

@@ -0,0 +1,336 @@
+import { FileSource, UpupCore, UploadFile, UploadStatus, CoreOptions, UpupThemeConfig, UploadSource, LocaleBundle, PartialMessages, Translations, Translator, CloudDrivesConfig, ExtensionMethods, MaxFileSizeObject, ResolvedImageEditorOptions } from '@useupup/core';
+import { UploaderOrchestrator, ThemeStore, TransientUiSnapshot, MotionMode, DragDropController, DriveBrowserController } from '@useupup/core/internal';
+
+type RecordingState$1 = 'idle' | 'recording' | 'recorded';
+interface ScreenDeps {
+    setFiles: (files: File[]) => Promise<void>;
+    setActiveSource: (a: FileSource | undefined) => void;
+    invalidate: () => void;
+}
+interface ScreenSnapshot {
+    recordingState: RecordingState$1;
+    duration: number;
+    videoUrl: string | null;
+    error: string | null;
+}
+declare class ScreenCaptureController implements SourceController<ScreenSnapshot> {
+    private deps;
+    private recordingState;
+    private duration;
+    private videoUrl;
+    private error;
+    private mediaRecorder;
+    private chunks;
+    private timerHandle;
+    private streamRef;
+    private previewEl;
+    private destroyed;
+    constructor(deps: ScreenDeps);
+    /** STABLE ref (one identity per controller life) so lit-html only invokes it on real <video>
+     *  mount/unmount. An inline-arrow ref re-fires every render; the recording timer invalidates
+     *  each second, so an inline ref would re-bind srcObject + re-call play() every frame. */
+    readonly previewRef: (el: Element | undefined) => void;
+    activate(): void;
+    deactivate(): void;
+    setPreviewEl(el: HTMLVideoElement | null): void;
+    startRecording(): Promise<void>;
+    stopRecording(): void;
+    discardRecording(): void;
+    addRecording(): void;
+    retryRecording(): void;
+    formatTime(s: number): string;
+    getSnapshot(): ScreenSnapshot;
+    destroy(): void;
+}
+
+type RecordingState = 'idle' | 'recording' | 'recorded';
+interface AudioDeps {
+    setFiles: (files: File[]) => Promise<void>;
+    setActiveSource: (a: FileSource | undefined) => void;
+    invalidate: () => void;
+}
+interface AudioSnapshot {
+    recordingState: RecordingState;
+    duration: number;
+    audioUrl: string | null;
+    error: string | null;
+    /** Live mic stream while recording — feeds the AudioWaveform visual (mirrors
+     *  React AudioUploader's streamRef). Null when idle/recorded/torn down. */
+    stream: MediaStream | null;
+}
+declare class AudioRecorderController implements SourceController<AudioSnapshot> {
+    private deps;
+    private recordingState;
+    private duration;
+    private audioUrl;
+    private error;
+    private mediaRecorder;
+    private chunks;
+    private timerHandle;
+    private streamRef;
+    private destroyed;
+    constructor(deps: AudioDeps);
+    activate(): void;
+    deactivate(): void;
+    startRecording(): Promise<void>;
+    stopRecording(): void;
+    discardRecording(): void;
+    addRecording(): void;
+    formatTime(s: number): string;
+    getSnapshot(): AudioSnapshot;
+    destroy(): void;
+}
+
+declare enum FacingMode {
+    Environment = "environment",
+    User = "user"
+}
+interface CameraDeps {
+    core: UpupCore;
+    setFiles: (files: File[]) => Promise<void>;
+    setActiveSource: (a: FileSource | undefined) => void;
+    invalidate: () => void;
+}
+interface CameraSnapshot {
+    capturedUrl: string;
+    facingMode: FacingMode;
+    newCameraSide: 'front' | 'back';
+}
+declare class CameraController implements SourceController<CameraSnapshot> {
+    private deps;
+    private capturedUrl;
+    private facingMode;
+    private stream;
+    private videoEl;
+    private destroyed;
+    constructor(deps: CameraDeps);
+    /** STABLE ref callback (one identity for the controller's life) so lit-html only invokes it
+     *  on real <video> mount/unmount. An inline-arrow ref re-fires every render; since startCamera()
+     *  calls invalidate() on success, that would loop getUserMedia and restart the camera endlessly. */
+    readonly videoRef: (el: Element | undefined) => void;
+    setVideoEl(el: HTMLVideoElement | null): void;
+    activate(): void;
+    deactivate(): void;
+    startCamera(): Promise<void>;
+    stopCamera(): void;
+    capture(): void;
+    clearUrl(): void;
+    handleFetchImage(): Promise<void>;
+    handleCameraSwitch(): void;
+    getSnapshot(): CameraSnapshot;
+    destroy(): void;
+}
+
+interface FileInputDeps {
+    getFileInput: () => HTMLInputElement | null;
+    setFiles: (files: File[]) => Promise<void>;
+    invalidate: () => void;
+}
+type FileInputSnapshot = Record<string, never>;
+declare class FileInputController implements UploaderController<FileInputSnapshot> {
+    private deps;
+    constructor(deps: FileInputDeps);
+    open(): void;
+    openFolder(): void;
+    getSnapshot(): FileInputSnapshot;
+    destroy(): void;
+}
+
+/** Flat, framework-free snapshot the render loop reads and subscribe() emits. */
+interface UploaderSnapshot {
+    files: UploadFile[];
+    status: UploadStatus;
+    progress: {
+        totalFiles: number;
+        completedFiles: number;
+        percentage: number;
+    };
+    error: Error | null;
+    activeSource: FileSource | undefined;
+    viewMode: 'grid' | 'list';
+}
+/** Cloud-drive config shape accepted by createUploader (mirrors svelte UploaderProps.cloudDrives). */
+interface VanillaCloudDrives {
+    googleDrive?: {
+        clientId: string;
+        apiKey: string;
+        appId: string;
+    };
+    oneDrive?: {
+        clientId: string;
+        redirectUri?: string;
+    };
+    dropbox?: {
+        clientId: string;
+        redirectUri?: string;
+    };
+    box?: {
+        clientId: string;
+        redirectUri?: string;
+    };
+}
+/** Options accepted by createUploader: the CoreOptions surface + UI + convenience callbacks. */
+interface CreateUploaderOptions extends Omit<CoreOptions, 'cloudDrives'> {
+    /** Initial theme; true => dark. Maps to ThemeStore('dark'|'light'). */
+    dark?: boolean;
+    /** svelte UploaderProps.theme passthrough when present (takes precedence over `dark`). */
+    theme?: UpupThemeConfig;
+    sources?: UploadSource[];
+    /** Mirrors svelte UploaderProps.maxFiles — max number of files. Resolution: maxFiles ?? 10. */
+    maxFiles?: number;
+    className?: string;
+    showBranding?: boolean;
+    disableDragDrop?: boolean;
+    mini?: boolean;
+    /** Motion master switch. `false` disables every upup-fx animation (writes
+     *  data-motion="off"); the OS reduced-motion preference also forces off.
+     *  Default true. Not part of CoreOptions — resolved by normalizeUploaderOptions. */
+    animations?: boolean;
+    /** Quiet-completion mode: a successful run shows ONLY the checkmark overlay
+     *  (no Done/add-more/CTA); the host takes over via the completion callbacks.
+     *  Default false. */
+    quietCompletion?: boolean;
+    isProcessing?: boolean;
+    allowPreview?: boolean;
+    folderUpload?: {
+        allowDrop?: boolean;
+        showSelectFolderButton?: boolean;
+    };
+    cloudDrives?: VanillaCloudDrives;
+    i18n?: {
+        bundle?: LocaleBundle;
+        locale?: LocaleBundle | string;
+        fallbackLocale?: LocaleBundle | string;
+        overrides?: PartialMessages;
+    };
+    onFileAdded?: (files: UploadFile[]) => void;
+    onFileRemoved?: (file: UploadFile) => void;
+    onUploadProgress?: (p: {
+        fileId: string;
+        loaded: number;
+        total: number;
+    }) => void;
+    onUploadComplete?: (files: UploadFile[]) => void;
+    /** Called when the user clicks Done (before files are cleared) — mirrors svelte's onDoneClicked prop. */
+    onDoneClicked?: () => void;
+    /** Called when a source tile is clicked (before the source-click emit) — mirrors svelte's onIntegrationClick prop. */
+    onIntegrationClick?: (sourceId: string) => void;
+    onFilesDragOver?: (files: File[]) => void;
+    onFilesDragLeave?: (files: File[]) => void;
+    onFilesDrop?: (files: File[]) => void;
+    onWarn?: (message: string) => void;
+    enablePaste?: boolean;
+}
+/** Base controller contract. invalidate() is injected at construction by the render loop. */
+interface UploaderController<S = unknown> {
+    getSnapshot(): S;
+    destroy(): void;
+}
+/** Controllers that own a source view also implement activate/deactivate. */
+interface SourceController<S = unknown> extends UploaderController<S> {
+    activate(): void;
+    deactivate(): void;
+}
+/** Lazily-instantiated controllers, keyed; the render loop destroys inactive ones on source switch. */
+interface ControllerRegistry {
+    fileInput: FileInputController;
+    dragDrop: DragDropController;
+    /** active per-source controller cache (camera/audio/screen/drive); see context.ts getController(). */
+    getCamera(): CameraController;
+    getAudio(): AudioRecorderController;
+    getScreen(): ScreenCaptureController;
+    /** drive browser controllers are core DriveBrowserController instances, cached by FileSource. */
+    getDrive(source: FileSource): DriveBrowserController;
+    /** destroy every cached per-source controller (called on source switch + destroy). */
+    destroyActive(): void;
+    /** destroy everything including fileInput + dragDrop (called on destroy). */
+    destroyAll(): void;
+}
+/** Resolved props (plain values, mirroring svelte ContextProps). */
+interface UploaderContextProps {
+    mini: boolean;
+    sources: FileSource[];
+    allowedFileTypes: string;
+    limit: number;
+    maxFileSize: MaxFileSizeObject | undefined;
+    multiple: boolean;
+    isProcessing: boolean;
+    allowPreview: boolean;
+    showBranding: boolean;
+    disableDragDrop: boolean;
+    className: string;
+    folderUploadAllowDrop: boolean;
+    folderPickerButtonVisible: boolean;
+    imageEditor: ResolvedImageEditorOptions;
+    quietCompletion: boolean;
+    onIntegrationClick: (sourceId: string) => void;
+    resumable: CoreOptions['resumable'];
+}
+/** The flat root context every template fn receives. Replicates svelte createUploaderController data without core extraction. */
+interface UploaderContext {
+    core: UpupCore;
+    orchestrator: UploaderOrchestrator;
+    theme: ThemeStore;
+    mode: 'client' | 'server';
+    serverUrl: string | undefined;
+    translations: Translations;
+    translator: Translator;
+    lang: string;
+    dir: 'ltr' | 'rtl';
+    props: UploaderContextProps;
+    cloudDrives?: CloudDrivesConfig | undefined;
+    registerFileInput(el: HTMLInputElement | null): void;
+    getFileInput(): HTMLInputElement | null;
+    openFilePicker(): void;
+    setActiveSource(a: FileSource | undefined): void;
+    setIsAddingMore(v: boolean): void;
+    setViewMode(m: 'grid' | 'list'): void;
+    /** Current transient-UI snapshot (deferred removal / add-more overlay / drop
+     *  toast). Read in render; the render loop re-subscribes via controller.subscribe. */
+    getTransientUi(): TransientUiSnapshot;
+    /** Current motion-gate resolution ('on' | 'off'); the panel writes it as
+     *  data-motion so the shared CSS gates every upup-fx-* rule. */
+    getMotionMode(): MotionMode;
+    /** Add-more source overlay commands (core transient-UI store; idempotent). */
+    openSourceOverlay(): void;
+    closeSourceOverlay(): void;
+    /** Raise the drive drop-rejection toast for `source` (resolves the human
+     *  provider label, then core owns the 3s auto-clear). */
+    flagDriveDropRejected(source: FileSource): void;
+    setFiles(files: File[]): Promise<void>;
+    handleFileRemove(fileId: string): void;
+    handleRemoveAll(): void;
+    startUpload(): Promise<UploadFile[] | undefined>;
+    retryUpload(fileId?: string): Promise<UploadFile[] | undefined>;
+    handleDone(): void;
+    handleCancel(): void;
+    handlePause(): void;
+    handleResume(): void;
+    controllers: ControllerRegistry;
+    /** request a re-render (microtask-coalesced by the render loop). */
+    invalidate(): void;
+    /** Report a user-facing error message (routed to options.onError). Used by URL fetch + other views. */
+    onError?: (message: string) => void;
+}
+/** The public instance returned by createUploader. Mirrors svelte UseUpupUploadReturn + lifecycle. */
+interface UpupInstance {
+    getState(): UploaderSnapshot;
+    subscribe(cb: (s: UploaderSnapshot) => void): () => void;
+    addFiles(files: File[]): Promise<void>;
+    removeFile(id: string): void;
+    removeAll(): void;
+    setFiles(files: File[]): Promise<void>;
+    reorderFiles(ids: string[]): void;
+    upload(): Promise<UploadFile[]>;
+    pause(): void;
+    resume(): void;
+    cancel(): void;
+    retry(fileId?: string): Promise<UploadFile[]>;
+    on(event: string, h: (...a: unknown[]) => void): () => void;
+    ext: Record<string, ExtensionMethods>;
+    core: UpupCore;
+    el: HTMLElement;
+    destroy(): void;
+}
+
+export type { CreateUploaderOptions as C, UpupInstance as U, UploaderSnapshot as a, UploaderContext as b };

package/dist/types-412b3393.d.ts

@@ -0,0 +1,336 @@
+import { FileSource, UpupCore, UploadFile, UploadStatus, CoreOptions, UpupThemeConfig, UploadSource, LocaleBundle, PartialMessages, Translations, Translator, CloudDrivesConfig, ExtensionMethods, MaxFileSizeObject, ResolvedImageEditorOptions } from '@useupup/core';
+import { UploaderOrchestrator, ThemeStore, TransientUiSnapshot, MotionMode, DragDropController, DriveBrowserController } from '@useupup/core/internal';
+
+type RecordingState$1 = 'idle' | 'recording' | 'recorded';
+interface ScreenDeps {
+    setFiles: (files: File[]) => Promise<void>;
+    setActiveSource: (a: FileSource | undefined) => void;
+    invalidate: () => void;
+}
+interface ScreenSnapshot {
+    recordingState: RecordingState$1;
+    duration: number;
+    videoUrl: string | null;
+    error: string | null;
+}
+declare class ScreenCaptureController implements SourceController<ScreenSnapshot> {
+    private deps;
+    private recordingState;
+    private duration;
+    private videoUrl;
+    private error;
+    private mediaRecorder;
+    private chunks;
+    private timerHandle;
+    private streamRef;
+    private previewEl;
+    private destroyed;
+    constructor(deps: ScreenDeps);
+    /** STABLE ref (one identity per controller life) so lit-html only invokes it on real <video>
+     *  mount/unmount. An inline-arrow ref re-fires every render; the recording timer invalidates
+     *  each second, so an inline ref would re-bind srcObject + re-call play() every frame. */
+    readonly previewRef: (el: Element | undefined) => void;
+    activate(): void;
+    deactivate(): void;
+    setPreviewEl(el: HTMLVideoElement | null): void;
+    startRecording(): Promise<void>;
+    stopRecording(): void;
+    discardRecording(): void;
+    addRecording(): void;
+    retryRecording(): void;
+    formatTime(s: number): string;
+    getSnapshot(): ScreenSnapshot;
+    destroy(): void;
+}
+
+type RecordingState = 'idle' | 'recording' | 'recorded';
+interface AudioDeps {
+    setFiles: (files: File[]) => Promise<void>;
+    setActiveSource: (a: FileSource | undefined) => void;
+    invalidate: () => void;
+}
+interface AudioSnapshot {
+    recordingState: RecordingState;
+    duration: number;
+    audioUrl: string | null;
+    error: string | null;
+    /** Live mic stream while recording — feeds the AudioWaveform visual (mirrors
+     *  React AudioUploader's streamRef). Null when idle/recorded/torn down. */
+    stream: MediaStream | null;
+}
+declare class AudioRecorderController implements SourceController<AudioSnapshot> {
+    private deps;
+    private recordingState;
+    private duration;
+    private audioUrl;
+    private error;
+    private mediaRecorder;
+    private chunks;
+    private timerHandle;
+    private streamRef;
+    private destroyed;
+    constructor(deps: AudioDeps);
+    activate(): void;
+    deactivate(): void;
+    startRecording(): Promise<void>;
+    stopRecording(): void;
+    discardRecording(): void;
+    addRecording(): void;
+    formatTime(s: number): string;
+    getSnapshot(): AudioSnapshot;
+    destroy(): void;
+}
+
+declare enum FacingMode {
+    Environment = "environment",
+    User = "user"
+}
+interface CameraDeps {
+    core: UpupCore;
+    setFiles: (files: File[]) => Promise<void>;
+    setActiveSource: (a: FileSource | undefined) => void;
+    invalidate: () => void;
+}
+interface CameraSnapshot {
+    capturedUrl: string;
+    facingMode: FacingMode;
+    newCameraSide: 'front' | 'back';
+}
+declare class CameraController implements SourceController<CameraSnapshot> {
+    private deps;
+    private capturedUrl;
+    private facingMode;
+    private stream;
+    private videoEl;
+    private destroyed;
+    constructor(deps: CameraDeps);
+    /** STABLE ref callback (one identity for the controller's life) so lit-html only invokes it
+     *  on real <video> mount/unmount. An inline-arrow ref re-fires every render; since startCamera()
+     *  calls invalidate() on success, that would loop getUserMedia and restart the camera endlessly. */
+    readonly videoRef: (el: Element | undefined) => void;
+    setVideoEl(el: HTMLVideoElement | null): void;
+    activate(): void;
+    deactivate(): void;
+    startCamera(): Promise<void>;
+    stopCamera(): void;
+    capture(): void;
+    clearUrl(): void;
+    handleFetchImage(): Promise<void>;
+    handleCameraSwitch(): void;
+    getSnapshot(): CameraSnapshot;
+    destroy(): void;
+}
+
+interface FileInputDeps {
+    getFileInput: () => HTMLInputElement | null;
+    setFiles: (files: File[]) => Promise<void>;
+    invalidate: () => void;
+}
+type FileInputSnapshot = Record<string, never>;
+declare class FileInputController implements UploaderController<FileInputSnapshot> {
+    private deps;
+    constructor(deps: FileInputDeps);
+    open(): void;
+    openFolder(): void;
+    getSnapshot(): FileInputSnapshot;
+    destroy(): void;
+}
+
+/** Flat, framework-free snapshot the render loop reads and subscribe() emits. */
+interface UploaderSnapshot {
+    files: UploadFile[];
+    status: UploadStatus;
+    progress: {
+        totalFiles: number;
+        completedFiles: number;
+        percentage: number;
+    };
+    error: Error | null;
+    activeSource: FileSource | undefined;
+    viewMode: 'grid' | 'list';
+}
+/** Cloud-drive config shape accepted by createUploader (mirrors svelte UploaderProps.cloudDrives). */
+interface VanillaCloudDrives {
+    googleDrive?: {
+        clientId: string;
+        apiKey: string;
+        appId: string;
+    };
+    oneDrive?: {
+        clientId: string;
+        redirectUri?: string;
+    };
+    dropbox?: {
+        clientId: string;
+        redirectUri?: string;
+    };
+    box?: {
+        clientId: string;
+        redirectUri?: string;
+    };
+}
+/** Options accepted by createUploader: the CoreOptions surface + UI + convenience callbacks. */
+interface CreateUploaderOptions extends Omit<CoreOptions, 'cloudDrives'> {
+    /** Initial theme; true => dark. Maps to ThemeStore('dark'|'light'). */
+    dark?: boolean;
+    /** svelte UploaderProps.theme passthrough when present (takes precedence over `dark`). */
+    theme?: UpupThemeConfig;
+    sources?: UploadSource[];
+    /** Mirrors svelte UploaderProps.maxFiles — max number of files. Resolution: maxFiles ?? 10. */
+    maxFiles?: number;
+    className?: string;
+    showBranding?: boolean;
+    disableDragDrop?: boolean;
+    mini?: boolean;
+    /** Motion master switch. `false` disables every upup-fx animation (writes
+     *  data-motion="off"); the OS reduced-motion preference also forces off.
+     *  Default true. Not part of CoreOptions — resolved by normalizeUploaderOptions. */
+    animations?: boolean;
+    /** Quiet-completion mode: a successful run shows ONLY the checkmark overlay
+     *  (no Done/add-more/CTA); the host takes over via the completion callbacks.
+     *  Default false. */
+    quietCompletion?: boolean;
+    isProcessing?: boolean;
+    allowPreview?: boolean;
+    folderUpload?: {
+        allowDrop?: boolean;
+        showSelectFolderButton?: boolean;
+    };
+    cloudDrives?: VanillaCloudDrives;
+    i18n?: {
+        bundle?: LocaleBundle;
+        locale?: LocaleBundle | string;
+        fallbackLocale?: LocaleBundle | string;
+        overrides?: PartialMessages;
+    };
+    onFileAdded?: (files: UploadFile[]) => void;
+    onFileRemoved?: (file: UploadFile) => void;
+    onUploadProgress?: (p: {
+        fileId: string;
+        loaded: number;
+        total: number;
+    }) => void;
+    onUploadComplete?: (files: UploadFile[]) => void;
+    /** Called when the user clicks Done (before files are cleared) — mirrors svelte's onDoneClicked prop. */
+    onDoneClicked?: () => void;
+    /** Called when a source tile is clicked (before the source-click emit) — mirrors svelte's onIntegrationClick prop. */
+    onIntegrationClick?: (sourceId: string) => void;
+    onFilesDragOver?: (files: File[]) => void;
+    onFilesDragLeave?: (files: File[]) => void;
+    onFilesDrop?: (files: File[]) => void;
+    onWarn?: (message: string) => void;
+    enablePaste?: boolean;
+}
+/** Base controller contract. invalidate() is injected at construction by the render loop. */
+interface UploaderController<S = unknown> {
+    getSnapshot(): S;
+    destroy(): void;
+}
+/** Controllers that own a source view also implement activate/deactivate. */
+interface SourceController<S = unknown> extends UploaderController<S> {
+    activate(): void;
+    deactivate(): void;
+}
+/** Lazily-instantiated controllers, keyed; the render loop destroys inactive ones on source switch. */
+interface ControllerRegistry {
+    fileInput: FileInputController;
+    dragDrop: DragDropController;
+    /** active per-source controller cache (camera/audio/screen/drive); see context.ts getController(). */
+    getCamera(): CameraController;
+    getAudio(): AudioRecorderController;
+    getScreen(): ScreenCaptureController;
+    /** drive browser controllers are core DriveBrowserController instances, cached by FileSource. */
+    getDrive(source: FileSource): DriveBrowserController;
+    /** destroy every cached per-source controller (called on source switch + destroy). */
+    destroyActive(): void;
+    /** destroy everything including fileInput + dragDrop (called on destroy). */
+    destroyAll(): void;
+}
+/** Resolved props (plain values, mirroring svelte ContextProps). */
+interface UploaderContextProps {
+    mini: boolean;
+    sources: FileSource[];
+    allowedFileTypes: string;
+    limit: number;
+    maxFileSize: MaxFileSizeObject | undefined;
+    multiple: boolean;
+    isProcessing: boolean;
+    allowPreview: boolean;
+    showBranding: boolean;
+    disableDragDrop: boolean;
+    className: string;
+    folderUploadAllowDrop: boolean;
+    folderPickerButtonVisible: boolean;
+    imageEditor: ResolvedImageEditorOptions;
+    quietCompletion: boolean;
+    onIntegrationClick: (sourceId: string) => void;
+    resumable: CoreOptions['resumable'];
+}
+/** The flat root context every template fn receives. Replicates svelte createUploaderController data without core extraction. */
+interface UploaderContext {
+    core: UpupCore;
+    orchestrator: UploaderOrchestrator;
+    theme: ThemeStore;
+    mode: 'client' | 'server';
+    serverUrl: string | undefined;
+    translations: Translations;
+    translator: Translator;
+    lang: string;
+    dir: 'ltr' | 'rtl';
+    props: UploaderContextProps;
+    cloudDrives?: CloudDrivesConfig | undefined;
+    registerFileInput(el: HTMLInputElement | null): void;
+    getFileInput(): HTMLInputElement | null;
+    openFilePicker(): void;
+    setActiveSource(a: FileSource | undefined): void;
+    setIsAddingMore(v: boolean): void;
+    setViewMode(m: 'grid' | 'list'): void;
+    /** Current transient-UI snapshot (deferred removal / add-more overlay / drop
+     *  toast). Read in render; the render loop re-subscribes via controller.subscribe. */
+    getTransientUi(): TransientUiSnapshot;
+    /** Current motion-gate resolution ('on' | 'off'); the panel writes it as
+     *  data-motion so the shared CSS gates every upup-fx-* rule. */
+    getMotionMode(): MotionMode;
+    /** Add-more source overlay commands (core transient-UI store; idempotent). */
+    openSourceOverlay(): void;
+    closeSourceOverlay(): void;
+    /** Raise the drive drop-rejection toast for `source` (resolves the human
+     *  provider label, then core owns the 3s auto-clear). */
+    flagDriveDropRejected(source: FileSource): void;
+    setFiles(files: File[]): Promise<void>;
+    handleFileRemove(fileId: string): void;
+    handleRemoveAll(): void;
+    startUpload(): Promise<UploadFile[] | undefined>;
+    retryUpload(fileId?: string): Promise<UploadFile[] | undefined>;
+    handleDone(): void;
+    handleCancel(): void;
+    handlePause(): void;
+    handleResume(): void;
+    controllers: ControllerRegistry;
+    /** request a re-render (microtask-coalesced by the render loop). */
+    invalidate(): void;
+    /** Report a user-facing error message (routed to options.onError). Used by URL fetch + other views. */
+    onError?: (message: string) => void;
+}
+/** The public instance returned by createUploader. Mirrors svelte UseUpupUploadReturn + lifecycle. */
+interface UpupInstance {
+    getState(): UploaderSnapshot;
+    subscribe(cb: (s: UploaderSnapshot) => void): () => void;
+    addFiles(files: File[]): Promise<void>;
+    removeFile(id: string): void;
+    removeAll(): void;
+    setFiles(files: File[]): Promise<void>;
+    reorderFiles(ids: string[]): void;
+    upload(): Promise<UploadFile[]>;
+    pause(): void;
+    resume(): void;
+    cancel(): void;
+    retry(fileId?: string): Promise<UploadFile[]>;
+    on(event: string, h: (...a: unknown[]) => void): () => void;
+    ext: Record<string, ExtensionMethods>;
+    core: UpupCore;
+    el: HTMLElement;
+    destroy(): void;
+}
+
+export type { CreateUploaderOptions as C, UpupInstance as U, UploaderSnapshot as a, UploaderContext as b };