@useupup/svelte 3.3.0

package/dist/composables/useUploaderPanel.js

@@ -0,0 +1,43 @@
+import { onMount, onDestroy } from 'svelte';
+import { derived } from 'svelte/store';
+import { DragDropController } from '@useupup/core/internal';
+import { useUploaderFiles, useUploaderOptions, useUploaderRuntime, useUploaderView, } from '../context/uploader-context';
+import { toReadable } from '../lib/to-readable';
+export default function useUploaderPanel() {
+    const { core, orchestrator } = useUploaderRuntime();
+    const { setFiles } = useUploaderFiles();
+    const { flagDriveDropRejected } = useUploaderView();
+    const options = useUploaderOptions();
+    const { disableDragDrop, isProcessing, folderUploadAllowDrop } = options;
+    if (!core || !orchestrator)
+        throw new Error('useUploaderPanel must be used inside an initialized <UpupUploader />');
+    const controller = new DragDropController({
+        core,
+        orchestrator,
+        setFiles,
+        // The file list derives from the orchestrator snapshot — derive the
+        // border's file count from the same source so it stays in lockstep.
+        filesSize: () => orchestrator.getSnapshot().files.size,
+        options: () => options,
+        props: () => ({ disableDragDrop, isProcessing, folderUploadAllowDrop }),
+        onReadonlyDropRejected: source => {
+            flagDriveDropRejected(source);
+        },
+    });
+    const state = toReadable(controller);
+    onMount(() => {
+        controller.init();
+    });
+    onDestroy(() => {
+        controller.destroy();
+    });
+    return {
+        isDragging: derived(state, $s => $s.isDragging),
+        absoluteIsDragging: derived(state, $s => $s.absoluteIsDragging),
+        absoluteHasBorder: derived(state, $s => $s.absoluteHasBorder),
+        handleDragOver: controller.handleDragOver.bind(controller),
+        handleDragLeave: controller.handleDragLeave.bind(controller),
+        handleDrop: controller.handleDrop.bind(controller),
+        handlePaste: controller.handlePaste.bind(controller),
+    };
+}

package/dist/context/create-uploader-context.d.ts

@@ -0,0 +1,4 @@
+import type { UploaderProps } from '../shared/types';
+import type { IUploaderContext } from './uploader-context';
+export declare function createUploaderContext(props: UploaderProps): IUploaderContext;
+//# sourceMappingURL=create-uploader-context.d.ts.map

package/dist/context/create-uploader-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-uploader-context.d.ts","sourceRoot":"","sources":["../../src/context/create-uploader-context.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAqB1D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CA6Y5E"}

package/dist/context/create-uploader-context.js

@@ -0,0 +1,324 @@
+import { onMount, onDestroy } from 'svelte';
+import { derived } from 'svelte/store';
+import { normalizeUploaderOptions, createUploaderController, } from '@useupup/core/internal';
+import { useUpupUpload } from '../use-upup-upload';
+import { useSSEProcessing } from '../composables/useSSEProcessing';
+import { toReadable } from '../lib/to-readable';
+import EmptyIcon from '../components/EmptyIcon.svelte';
+import TrashIcon from '../components/TrashIcon.svelte';
+import DefaultAddMoreIcon from '../components/DefaultAddMoreIcon.svelte';
+const EMPTY_STYLE = {};
+/** Read-only drive provider → flattened i18n label key (the human provider name
+ *  for the drop-rejection toast). Typed `Record<CloudProvider, keyof
+ *  UiTranslations>` so the compiler enforces exhaustiveness against the same
+ *  drive-source union core's DragDropController gates on. */
+const DRIVE_SOURCE_LABEL_KEY = {
+    googleDrive: 'googleDrive',
+    oneDrive: 'oneDrive',
+    dropbox: 'dropbox',
+    box: 'box',
+};
+export function createUploaderContext(props) {
+    // ── Destructure props with defaults ──────────────────────────
+    const { allowedFileTypes: acceptProp = '*', mini = false, animations = true, isProcessing = false, allowPreview = true, folderUpload, showBranding = true, quietCompletion = false, disableDragDrop = false, className, style, maxFileSize: maxFileSizeProp, maxFiles, imageCompression = false, thumbnailGenerator = false, checksumVerification = false, webWorker, heicConversion = false, stripExifData = false, contentDeduplication = false, crashRecovery = false, 
+    // No destructure default: `undefined` must reach core so its default-on
+    // network awareness applies; only an explicit `false` opts out.
+    networkAware, sources, onError: errorHandler, onWarn: warningHandler, icons = {}, i18n, onIntegrationClick = () => { }, onFileClick = () => { }, onFileRemoved: onFileRemovedProp, onStatusChange, onFilesDragOver = () => { }, onFilesDragLeave = () => { }, onFilesDrop = () => { }, onFileTypeMismatch = () => { }, onBeforeFileAdded, onRestrictionFailed, enablePaste = false, autoUpload = false, maxConcurrentUploads, imageEditor: imageEditorProp, onUploadStart = () => { }, onFileUploadStart = () => { }, onFileUploadProgress = () => { }, onFilesUploadProgress = () => { }, onFileUploadComplete = () => { }, onFilesUploadComplete = () => { }, onUploadComplete = () => { }, onFilesSelected = () => { }, onDoneClicked = () => { }, onPrepareFiles, provider, mode: modeProp, uploadEndpoint, serverUrl, cloudDrives, metadata, cors, maxRetries, resumable, processingEndpoint, onFileProcessed, processingTimeout, } = props;
+    function onError(message) {
+        errorHandler?.(message);
+    }
+    function onWarn(message) {
+        warningHandler?.(message);
+    }
+    // ── Build factory-compatible options object ──────────────────
+    // UploaderProps.allowedFileTypes is string | string[] | undefined;
+    // UploaderControllerOptions.allowedFileTypes is string | undefined.
+    // normalizeUploaderOptions handles both via join cast.
+    const factoryOptions = {
+        provider,
+        mode: modeProp,
+        sources: sources,
+        uploadEndpoint,
+        serverUrl,
+        maxFiles,
+        theme: props.theme,
+        folderUpload,
+        cors,
+        cloudDrives,
+        imageCompression,
+        thumbnailGenerator,
+        checksumVerification,
+        webWorker,
+        heicConversion,
+        stripExifData,
+        contentDeduplication,
+        autoUpload,
+        maxConcurrentUploads,
+        crashRecovery,
+        networkAware,
+        allowedFileTypes: typeof acceptProp === 'string' ? acceptProp : acceptProp.join(','),
+        mini,
+        animations,
+        isProcessing,
+        allowPreview,
+        showBranding,
+        quietCompletion,
+        disableDragDrop,
+        className,
+        maxFileSize: maxFileSizeProp,
+        minFileSize: props.minFileSize,
+        maxTotalFileSize: props.maxTotalFileSize,
+        imageEditor: imageEditorProp,
+        metadata,
+        maxRetries,
+        resumable,
+        i18n,
+        onBeforeFileAdded,
+        onError: errorHandler,
+        onWarn: warningHandler,
+        onUploadStart,
+        onFileUploadStart,
+        onFileUploadProgress,
+        onFilesUploadProgress,
+        onFileUploadComplete,
+        onFilesUploadComplete,
+        onUploadComplete,
+        onFilesSelected,
+        onDoneClicked,
+        onPrepareFiles,
+        onFileRemoved: onFileRemovedProp,
+        onStatusChange,
+        onFileTypeMismatch,
+        onRestrictionFailed,
+    };
+    // ── Normalize options (pure) ─────────────────────────────────
+    const normalized = normalizeUploaderOptions(factoryOptions);
+    const { resolved } = normalized;
+    // ── Core (via useUpupUpload; owns core lifecycle) ────────────
+    const upload = useUpupUpload(normalized.coreOptions);
+    // ── SSE processing ──────────────────────────────────────────
+    const { connectSSE } = useSSEProcessing({
+        processingEndpoint,
+        onFileProcessed,
+        onError: err => {
+            onError(err.message);
+        },
+        processingTimeout,
+    });
+    // ── Uploader controller (created once, owns orchestrator/theme/plugins/commands) ──
+    const controller = createUploaderController({ core: upload.core, options: factoryOptions, normalized }, {
+        connectSSE: file => {
+            connectSSE(file);
+        },
+    });
+    controller.updateCallbacks({
+        onError,
+        onWarn,
+        onUploadStart,
+        onFileUploadStart,
+        onFileUploadProgress,
+        onFilesUploadProgress,
+        onFileUploadComplete,
+        onFilesUploadComplete,
+        onUploadComplete,
+        onFilesSelected,
+        onDoneClicked,
+        onPrepareFiles,
+        onFileRemoved: onFileRemovedProp,
+        onStatusChange,
+        onFileTypeMismatch,
+        onRestrictionFailed,
+        autoUpload,
+    });
+    // ── Subscribe to orchestrator state (toReadable handles sub/unsub) ──
+    const orchState = toReadable(controller.orchestrator);
+    // ── Subscribe to theme state (toReadable handles sub/unsub) ──
+    const themeState = toReadable(controller.theme);
+    // ── Subscribe to the transient-UI store (deferred removal / overlay / toast) ─
+    const transientState = toReadable(controller.transientUi);
+    // ── Subscribe to the motion gate (data-motion resolution) ────
+    const motionState = toReadable(controller.motionGate);
+    // Drop-rejection: core's DragDropController fires onReadonlyDropRejected with
+    // the drive FileSource; resolve its human provider label, then raise the
+    // toast (core store owns the 3s auto-clear).
+    function flagDriveDropRejected(source) {
+        const key = DRIVE_SOURCE_LABEL_KEY[source];
+        const label = key ? resolved.translations[key] : source;
+        controller.transientUi.flagDropRejected(label);
+    }
+    // ── Lifecycle via factory (idempotent init/destroy) ──────────
+    // controller.init() owns: orchestrator.init, theme.init, plugin registration,
+    //   status-change dedup, crash recovery.
+    // controller.destroy() owns: orchestrator.destroy, theme.destroy, plugin cleanup.
+    // core lifecycle remains owned by useUpupUpload's onDestroy.
+    onMount(() => {
+        controller.init();
+    });
+    onDestroy(() => {
+        controller.destroy();
+    });
+    // ── Input ref: delegate to factory (Svelte bind:this registration) ──────
+    // UpupUploader.svelte: $effect(() => ctx.registerFileInput(inputEl))
+    // must keep these field names; bodies delegate to controller.*.
+    const registerFileInput = (el) => {
+        controller.registerFileInput(el);
+    };
+    const getFileInput = () => controller.getFileInput();
+    const openFilePicker = () => {
+        controller.openFilePicker();
+    };
+    // ── Icons resolution (framework-specific) ───────────────────
+    const resolvedIcons = {
+        ContainerAddMoreIcon: icons.ContainerAddMoreIcon ?? DefaultAddMoreIcon,
+        FileDeleteIcon: icons.FileDeleteIcon ?? TrashIcon,
+        CameraCaptureIcon: icons.CameraCaptureIcon ?? EmptyIcon,
+        CameraRotateIcon: icons.CameraRotateIcon ?? EmptyIcon,
+        CameraDeleteIcon: icons.CameraDeleteIcon ?? EmptyIcon,
+        LoaderIcon: icons.LoaderIcon ?? EmptyIcon,
+    };
+    const resolvedStyle = style ?? EMPTY_STYLE;
+    // ── Assemble IUploaderContext ────────────────────────────────────
+    return {
+        core: upload.core,
+        orchestrator: controller.orchestrator,
+        mode: resolved.mode,
+        serverUrl: resolved.serverUrl,
+        registerFileInput,
+        getFileInput,
+        openFilePicker,
+        // Reactive so consumers (SourceView/UploaderPanel/FileList) re-render when the
+        // active source changes.
+        activeSource: derived(orchState, $s => $s.activeSource),
+        setActiveSource: (source) => {
+            controller.commands.setActiveSource(source);
+        },
+        isAddingMore: derived(orchState, $s => $s.isAddingMore),
+        setIsAddingMore: (v) => {
+            controller.commands.setIsAddingMore(v);
+        },
+        viewMode: derived(orchState, $s => $s.viewMode),
+        setViewMode: (m) => {
+            controller.commands.setViewMode(m);
+        },
+        isOnline: derived(orchState, $s => $s.isOnline),
+        motionMode: motionState,
+        sourceOverlayOpen: derived(transientState, $s => $s.sourceOverlayOpen),
+        sourceOverlayClosing: derived(transientState, $s => $s.sourceOverlayClosing),
+        openSourceOverlay: () => {
+            controller.transientUi.openSourceOverlay();
+        },
+        closeSourceOverlay: () => {
+            controller.transientUi.closeSourceOverlay();
+        },
+        dropRejected: derived(transientState, $s => $s.dropRejected),
+        flagDriveDropRejected,
+        translations: resolved.translations,
+        translator: resolved.translator,
+        lang: resolved.lang,
+        dir: resolved.dir,
+        theme: {
+            // All theme fields stay reactive (mirroring React): ThemeStore
+            // recomputes tokens/resolved/slotOverrides/slots at init() and on OS
+            // dark/light change, so `themeMode:'system'` resolves live instead of
+            // freezing the construction-time (light) values.
+            themeMode: derived(themeState, $s => $s.themeMode),
+            isDark: derived(themeState, $s => $s.isDark),
+            tokens: derived(themeState, $s => $s.tokens),
+            resolved: derived(themeState, $s => $s.resolved),
+            slotOverrides: derived(themeState, $s => $s.slotOverrides),
+            slots: derived(themeState, $s => $s.slots),
+        },
+        setThemeConfig: config => {
+            controller.theme.setThemeConfig(config);
+        },
+        files: derived(orchState, $s => $s.files),
+        leavingFileIds: derived(transientState, $s => $s.leavingFileIds),
+        // ContextFiles.setFiles is fire-and-forget (`=> void`); route the async
+        // command's rejection to onError rather than floating the promise.
+        setFiles: (newFiles) => {
+            controller.commands
+                .handleSetSelectedFiles(newFiles)
+                .catch((error) => {
+                onError(error instanceof Error ? error.message : String(error));
+            });
+        },
+        uploadFiles: (newFiles) => controller.commands.uploadFiles(newFiles),
+        resetState: () => {
+            controller.commands.resetState();
+        },
+        replaceFiles: (newFiles) => {
+            controller.commands.replaceFiles(newFiles);
+        },
+        handleDone: () => {
+            controller.commands.handleDone();
+        },
+        handleCancel: () => {
+            controller.commands.handleCancel();
+        },
+        handlePause: () => {
+            controller.commands.handlePause();
+        },
+        handleResume: () => {
+            controller.commands.handleResume();
+        },
+        handleFileRemove: (fileId) => {
+            controller.commands.handleFileRemove(fileId);
+        },
+        editingFile: derived(orchState, $s => $s.editingFile),
+        openImageEditor: (file) => {
+            controller.commands.openImageEditor(file);
+        },
+        closeImageEditor: () => {
+            controller.commands.closeImageEditor();
+        },
+        saveImageEdit: (editedImageData, mimeType) => {
+            controller.commands.saveImageEdit(editedImageData, mimeType);
+        },
+        replaceFile: (fileId, newFile) => {
+            controller.commands.replaceFile(fileId, newFile);
+        },
+        cloudDrives: resolved.cloudDrives,
+        upload: {
+            totalProgress: derived(orchState, $s => $s.totalProgress),
+            filesProgressMap: derived(orchState, $s => $s.filesProgressMap),
+            startUpload: () => controller.commands.startUpload(),
+            retryUpload: (fileId) => controller.commands.retryUpload(fileId),
+            uploadStatus: derived(orchState, $s => $s.uploadStatus),
+            uploadError: derived(orchState, $s => $s.uploadError),
+            uploadErrorCode: derived(orchState, $s => $s.uploadErrorCode),
+            uploadSpeed: derived(orchState, $s => $s.uploadSpeed),
+            uploadEta: derived(orchState, $s => $s.uploadEta),
+            uploadedBytes: derived(orchState, $s => $s.uploadedBytes),
+            totalBytes: derived(orchState, $s => $s.totalBytes),
+        },
+        props: {
+            mini,
+            maxRetries,
+            resumable,
+            onError,
+            onIntegrationClick,
+            onFileClick,
+            onFilesDragOver,
+            onFilesDragLeave,
+            onFilesDrop,
+            onWarn,
+            enablePaste,
+            sources: resolved.sources,
+            allowedFileTypes: resolved.allowedFileTypes,
+            maxFileSize: resolved.maxFileSize,
+            limit: resolved.limit,
+            isProcessing,
+            allowPreview,
+            folderUploadAllowDrop: resolved.folderUploadAllowDrop,
+            folderPickerButtonVisible: resolved.folderPickerButtonVisible,
+            showBranding,
+            quietCompletion,
+            disableDragDrop,
+            className: className ?? '',
+            style: resolvedStyle,
+            multiple: resolved.multiple,
+            icons: resolvedIcons,
+            imageEditor: resolved.imageEditor,
+        },
+    };
+}

package/dist/context/source-view-header-extra.d.ts

@@ -0,0 +1,14 @@
+import { type Writable } from 'svelte/store';
+export declare function provideSourceViewHeaderExtra(): Writable<HTMLElement | null>;
+export declare function useSourceViewHeaderExtra(): Writable<HTMLElement | null> | null;
+/**
+ * Svelte action: relocate `node` into `target` (the portal). `node` is a
+ * `display:contents` wrapper so its children render as if they were direct
+ * children of the host — matching React's createPortal / Vue's <Teleport>,
+ * which insert the extras as direct siblings of the Back button.
+ */
+export declare function portal(node: HTMLElement, target: HTMLElement | null): {
+    update(t: HTMLElement | null): void;
+    destroy(): void;
+};
+//# sourceMappingURL=source-view-header-extra.d.ts.map

package/dist/context/source-view-header-extra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-view-header-extra.d.ts","sourceRoot":"","sources":["../../src/context/source-view-header-extra.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAatD,wBAAgB,4BAA4B,IAAI,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,CAI3E;AAED,wBAAgB,wBAAwB,IAAI,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAM9E;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAClB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,GAAG,IAAI,GAC3B;IACC,MAAM,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAA;IACnC,OAAO,IAAI,IAAI,CAAA;CAClB,CAaA"}

package/dist/context/source-view-header-extra.js

@@ -0,0 +1,41 @@
+import { getContext, setContext } from 'svelte';
+import { writable } from 'svelte/store';
+/**
+ * DOM host inside the SourceView header row, just before the Back button.
+ * A source view portals its right-side header extras into it (e.g. the drive
+ * browser's avatar + log out + separator) so account controls share the top
+ * row instead of occupying their own strip. The store holds null until the host
+ * span mounts; consumers guard their portal on it. Svelte has no <Teleport>, so
+ * the DOM-host + `portal` action below is the framework idiom mirroring React's
+ * SourceViewHeaderExtraContext / Vue's <Teleport>.
+ */
+const SourceViewHeaderExtraKey = Symbol('upup-source-view-header-extra');
+export function provideSourceViewHeaderExtra() {
+    const store = writable(null);
+    setContext(SourceViewHeaderExtraKey, store);
+    return store;
+}
+export function useSourceViewHeaderExtra() {
+    return (getContext(SourceViewHeaderExtraKey) ?? null);
+}
+/**
+ * Svelte action: relocate `node` into `target` (the portal). `node` is a
+ * `display:contents` wrapper so its children render as if they were direct
+ * children of the host — matching React's createPortal / Vue's <Teleport>,
+ * which insert the extras as direct siblings of the Back button.
+ */
+export function portal(node, target) {
+    function mount(t) {
+        if (t)
+            t.appendChild(node);
+    }
+    mount(target);
+    return {
+        update(t) {
+            mount(t);
+        },
+        destroy() {
+            node.remove();
+        },
+    };
+}

package/dist/context/uploader-context.d.ts

@@ -0,0 +1,109 @@
+import type { Readable } from 'svelte/store';
+import type { FileSource, UploadFile, UpupThemeMode, ResolvedImageEditorOptions, FilesProgressMap } from '@useupup/core';
+import type { BaseContextUpload, BaseContextRuntime, BaseContextSource, BaseContextI18n, BaseContextFiles, BaseContextUploadControls, BaseContextView, BaseContextEditor, BaseContextTheme, MotionMode } from '@useupup/core/internal';
+import { UploadStatus } from '@useupup/core';
+import type { UploaderProps, UploaderIcons } from '../shared/types';
+export { UploadStatus };
+export type ContextUpload = Omit<BaseContextUpload, 'uploadStatus' | 'uploadError' | 'uploadErrorCode' | 'totalProgress' | 'filesProgressMap' | 'uploadSpeed' | 'uploadEta' | 'uploadedBytes' | 'totalBytes'> & {
+    uploadStatus: Readable<UploadStatus>;
+    uploadError: Readable<string | undefined>;
+    uploadErrorCode: Readable<string | undefined>;
+    totalProgress: Readable<number>;
+    filesProgressMap: Readable<FilesProgressMap>;
+    uploadSpeed: Readable<number>;
+    uploadEta: Readable<number>;
+    uploadedBytes: Readable<number>;
+    totalBytes: Readable<number>;
+};
+export type ContextRuntime = Omit<BaseContextRuntime, 'isOnline'> & {
+    /** Register the hidden file <input> (Svelte `bind:this`) so openFilePicker can click it. */
+    registerFileInput: (el: HTMLInputElement | null) => void;
+    /** Read the registered hidden file <input> (to toggle webkitdirectory/directory or reset value). */
+    getFileInput: () => HTMLInputElement | null;
+    isOnline: Readable<boolean>;
+    /** Resolved `data-motion` value ('on' | 'off') from the core motion gate. */
+    motionMode: Readable<MotionMode>;
+};
+export type ContextSource = Omit<BaseContextSource, 'activeSource'> & {
+    activeSource: Readable<FileSource | undefined>;
+};
+export type ContextI18n = BaseContextI18n;
+export type ContextFiles = Omit<BaseContextFiles, 'files'> & {
+    files: Readable<Map<string, UploadFile>>;
+    /** Transient: file ids currently playing their exit animation. Read by
+     *  FileList (hero) and FileItem (cards) to render `upup-fx-exit`. Sourced
+     *  from the core transient-UI store (deferred removal). */
+    leavingFileIds: Readable<ReadonlySet<string>>;
+};
+export type ContextUploadControls = Omit<BaseContextUploadControls, 'upload'> & {
+    upload: ContextUpload;
+};
+export type ContextView = Omit<BaseContextView, 'isAddingMore' | 'viewMode'> & {
+    isAddingMore: Readable<boolean>;
+    viewMode: Readable<'grid' | 'list'>;
+    /** Add-more source overlay: source surface mounted above the dimmed,
+     *  still-mounted file list. Sourced from the core transient-UI store. */
+    sourceOverlayOpen: Readable<boolean>;
+    /** Overlay is playing its reverse close-slide before it unmounts. */
+    sourceOverlayClosing: Readable<boolean>;
+    openSourceOverlay: () => void;
+    closeSourceOverlay: () => void;
+    /** Human provider label whose read-only picker just rejected an OS drop —
+     *  drives the drop-rejection toast. Null when no rejection is showing.
+     *  Auto-clears via the core transient-UI store's 3s window. */
+    dropRejected: Readable<string | null>;
+    /** Raise the drop-rejection toast for a read-only drive source (resolves the
+     *  provider label, then flags the core store). Wired to core's
+     *  DragDropController.onReadonlyDropRejected. */
+    flagDriveDropRejected: (source: FileSource) => void;
+};
+export type ContextEditor = Omit<BaseContextEditor, 'editingFile'> & {
+    editingFile: Readable<UploadFile | null>;
+};
+export type ContextTheme = Omit<BaseContextTheme, 'themeMode' | 'isDark' | 'tokens' | 'resolved' | 'slotOverrides' | 'slots'> & {
+    themeMode: Readable<Exclude<UpupThemeMode, 'system'>>;
+    isDark: Readable<boolean>;
+    tokens: Readable<BaseContextTheme['tokens']>;
+    resolved: Readable<BaseContextTheme['resolved']>;
+    slotOverrides: Readable<BaseContextTheme['slotOverrides']>;
+    slots: Readable<BaseContextTheme['slots']>;
+};
+type RequiredDefined<T, K extends keyof T> = {
+    [P in K]-?: NonNullable<T[P]>;
+};
+export type ContextProps = RequiredDefined<UploaderProps, 'sources' | 'isProcessing' | 'allowPreview' | 'mini' | 'onFileClick' | 'onIntegrationClick' | 'onFilesDragOver' | 'onFilesDragLeave' | 'onFilesDrop' | 'onWarn' | 'enablePaste' | 'onError' | 'showBranding' | 'quietCompletion' | 'className' | 'style' | 'disableDragDrop'> & {
+    maxFileSize?: UploaderProps['maxFileSize'];
+    maxRetries?: UploaderProps['maxRetries'];
+    resumable?: UploaderProps['resumable'];
+} & {
+    allowedFileTypes: string;
+    limit: number;
+    folderUploadAllowDrop: boolean;
+    folderPickerButtonVisible: boolean;
+    multiple: boolean;
+    icons: Required<UploaderIcons>;
+    imageEditor: ResolvedImageEditorOptions;
+};
+export interface IUploaderContext extends ContextRuntime, ContextSource, ContextI18n, ContextFiles, ContextUploadControls, ContextView, ContextEditor {
+    props: ContextProps;
+    theme: ContextTheme;
+    /**
+     * Re-resolve the live ThemeStore when the `theme` prop changes after mount
+     * (mirrors React's `controller.theme.setThemeConfig(theme)` effect). The
+     * store short-circuits on a structurally-equal config, so an inlined object
+     * literal per render does not loop.
+     */
+    setThemeConfig: (config: UploaderProps['theme']) => void;
+}
+export declare function provideUploaderContext(value: IUploaderContext): void;
+export declare const useUploaderContext: () => IUploaderContext;
+export declare const useUploaderRuntime: () => ContextRuntime;
+export declare const useUploaderSource: () => ContextSource;
+export declare const useUploaderI18n: () => ContextI18n;
+export declare const useUploaderFiles: () => ContextFiles;
+export declare const useUploaderUploadControls: () => ContextUploadControls;
+export declare const useUploaderView: () => ContextView;
+export declare const useUploaderEditor: () => ContextEditor;
+export declare const useUploaderOptions: () => ContextProps;
+export declare const useUploaderTheme: () => ContextTheme;
+//# sourceMappingURL=uploader-context.d.ts.map

package/dist/context/uploader-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploader-context.d.ts","sourceRoot":"","sources":["../../src/context/uploader-context.ts"],"names":[],"mappings":"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"}

package/dist/context/uploader-context.js

@@ -0,0 +1,96 @@
+import { getContext, setContext } from 'svelte';
+import { UploadStatus } from '@useupup/core';
+export { UploadStatus };
+// ─── Keys ───────────────────────────────────────────────────
+const RuntimeKey = Symbol('upup-runtime');
+const SourceKey = Symbol('upup-source');
+const I18nKey = Symbol('upup-i18n');
+const FilesKey = Symbol('upup-files');
+const UploadControlsKey = Symbol('upup-upload-controls');
+const ViewKey = Symbol('upup-view');
+const EditorKey = Symbol('upup-editor');
+const OptionsKey = Symbol('upup-options');
+const ThemeKey = Symbol('upup-theme');
+const RootKey = Symbol('upup-root');
+// ─── Provider ───────────────────────────────────────────────
+export function provideUploaderContext(value) {
+    setContext(RootKey, value);
+    setContext(RuntimeKey, {
+        core: value.core,
+        orchestrator: value.orchestrator,
+        mode: value.mode,
+        serverUrl: value.serverUrl,
+        registerFileInput: value.registerFileInput,
+        getFileInput: value.getFileInput,
+        openFilePicker: value.openFilePicker,
+        isOnline: value.isOnline,
+        motionMode: value.motionMode,
+    });
+    setContext(SourceKey, {
+        activeSource: value.activeSource,
+        setActiveSource: value.setActiveSource,
+        cloudDrives: value.cloudDrives,
+    });
+    setContext(I18nKey, {
+        translations: value.translations,
+        translator: value.translator,
+        lang: value.lang,
+        dir: value.dir,
+    });
+    setContext(FilesKey, {
+        files: value.files,
+        leavingFileIds: value.leavingFileIds,
+        setFiles: value.setFiles,
+        replaceFiles: value.replaceFiles,
+        resetState: value.resetState,
+        uploadFiles: value.uploadFiles,
+        handleFileRemove: value.handleFileRemove,
+    });
+    setContext(UploadControlsKey, {
+        upload: value.upload,
+        handleDone: value.handleDone,
+        handleCancel: value.handleCancel,
+        handlePause: value.handlePause,
+        handleResume: value.handleResume,
+    });
+    setContext(ViewKey, {
+        isAddingMore: value.isAddingMore,
+        setIsAddingMore: value.setIsAddingMore,
+        viewMode: value.viewMode,
+        setViewMode: value.setViewMode,
+        sourceOverlayOpen: value.sourceOverlayOpen,
+        sourceOverlayClosing: value.sourceOverlayClosing,
+        openSourceOverlay: value.openSourceOverlay,
+        closeSourceOverlay: value.closeSourceOverlay,
+        dropRejected: value.dropRejected,
+        flagDriveDropRejected: value.flagDriveDropRejected,
+    });
+    setContext(EditorKey, {
+        editingFile: value.editingFile,
+        openImageEditor: value.openImageEditor,
+        closeImageEditor: value.closeImageEditor,
+        saveImageEdit: value.saveImageEdit,
+        replaceFile: value.replaceFile,
+    });
+    setContext(OptionsKey, value.props);
+    setContext(ThemeKey, value.theme);
+}
+// ─── Consumers (throw outside <UpupUploader />) ─────────────
+// `value` carries T so the generic relates the passed-in context to the return
+// (a real generic, not a disguised assertion): each consumer reads its own
+// typed getContext and this asserts presence at the <UpupUploader /> boundary.
+function read(name, value) {
+    if (value === undefined)
+        throw new Error(`${name} must be used inside <UpupUploader />`);
+    return value;
+}
+export const useUploaderContext = () => read('useUploaderContext', getContext(RootKey));
+export const useUploaderRuntime = () => read('useUploaderRuntime', getContext(RuntimeKey));
+export const useUploaderSource = () => read('useUploaderSource', getContext(SourceKey));
+export const useUploaderI18n = () => read('useUploaderI18n', getContext(I18nKey));
+export const useUploaderFiles = () => read('useUploaderFiles', getContext(FilesKey));
+export const useUploaderUploadControls = () => read('useUploaderUploadControls', getContext(UploadControlsKey));
+export const useUploaderView = () => read('useUploaderView', getContext(ViewKey));
+export const useUploaderEditor = () => read('useUploaderEditor', getContext(EditorKey));
+export const useUploaderOptions = () => read('useUploaderOptions', getContext(OptionsKey));
+export const useUploaderTheme = () => read('useUploaderTheme', getContext(ThemeKey));