@useupup/core 3.3.0

package/dist/index.d.cts

@@ -0,0 +1,280 @@
+export { F as FileSource, d as PipelineContext, P as PipelineStep, a as UploadFile, U as UploadFileMetadata, b as UploadFileWithProgress, c as UploadStatus } from './contracts-pipeline-cf177270.cjs';
+export { F as FileUploadResult, N as NON_S3_STORAGE_PROVIDERS, R as RestrictionFailedReason, S as StorageProvider, a as UploadProvider, U as UploadSource, b as UploaderBaseProps, e as UpupAuthError, j as UpupConfigError, d as UpupError, c as UpupErrorCode, f as UpupNetworkError, h as UpupQuotaError, i as UpupStorageError, g as UpupValidationError, u as uploadErrorFromResponse } from './uploader-props-7f956e60.cjs';
+export { C as CrashRecoveryOptions, M as MaxFileSizeObject, g as MultipartAbortResponse, f as MultipartCompleteResponse, a as MultipartInitResponse, d as MultipartListPartsResponse, c as MultipartPart, e as MultipartResumeResponse, b as MultipartSignPartResponse, P as PresignedUrlResponse, R as ResumableUploadOptions } from './contracts-strategies-378a16b7.cjs';
+import { c as UpupPlugin, E as EventEmitter, D as DropboxConfig, G as GoogleDriveConfig, B as BoxConfig, O as OneDriveConfig } from './core-bea2ceca.cjs';
+export { b as CloudDrivesConfig, d as CoreOptions, g as ExtensionMethods, h as FileProgress, F as FilesProgressMap, a as ImageCompressionOptions, I as ImageEditorOptions, R as ResolvedImageEditorOptions, T as ThumbnailGeneratorOptions, e as UploadOptions, U as UpupCore, f as UpupCorsConfig, V as ValidationResult } from './core-bea2ceca.cjs';
+export { e as LOCALE_CODES, g as LOCALE_REGISTRY, L as LocaleBundle, P as PartialMessages, R as RegisteredLocaleCode, c as Translations, T as Translator, d as UiTranslations, a as UpupLocaleCode, U as UpupMessages, f as flattenTranslatorToUiTranslations, b as formatUiMessage, p as pluralUiMessage } from './ui-translations-c5d00392.cjs';
+export { L as LOCALE_META, a as LocaleMeta, T as TranslatorOptions, d as arSA, c as createTranslator, f as deDE, b as enUS, e as errorCodeToMessageKey, g as esES, h as frFR, j as jaJP, k as koKR, n as normalizeBcp47, z as zhCN, i as zhTW } from './error-code-map-dd5becfa.cjs';
+export { h as UPUP_VAR_PREFIX, U as UpupColorTokens, a as UpupRadiusTokens, b as UpupShadowTokens, k as UpupSlotPath, c as UpupSpacingTokens, f as UpupThemeConfig, e as UpupThemeMode, j as UpupThemeSlots, d as UpupThemeTokens, m as flattenSlotsToClassNames, t as tokensToVars } from './vars-d3421f6c.cjs';
+export { d as darkPreset, l as lightPreset, r as resolveTheme } from './resolve-theme-66cf8d98.cjs';
+import { D as DriveUser, a as DriveFile, b as DriveListPage, c as DriveState } from './server-mode-drive-controller-b5f8ee12.cjs';
+export { B as BOX_DESCRIPTOR, g as DROPBOX_DESCRIPTOR, f as DriveBrowserError, e as DriveEventMap, d as DriveFolder, G as GOOGLE_DRIVE_DESCRIPTOR, O as ONE_DRIVE_DESCRIPTOR, h as ObservableController, i as ServerDriveFile, j as ServerDriveListState, S as ServerModeProvider } from './server-mode-drive-controller-b5f8ee12.cjs';
+
+/**
+ * The single drive-plugin contract. Extends the generic UpupPlugin registration
+ * base with the drive lifecycle (id/init/destroy) AND the runtime surface the
+ * DriveBrowserController drives. The four concrete *Plugin classes implement this.
+ * Members marked optional may be omitted by a future provider that doesn't need them:
+ * authenticate is implemented by all current providers but only invoked on the GIS path;
+ * authenticateViaPopup/loadAllFilesInFolder are popup-provider-only (absent on GIS);
+ * getConfig is implemented by all and read for the GIS client id.
+ *
+ * Folds in the formerly-inline DriveBrowserPlugin (was in drive-browser-controller.ts)
+ * so the declared lifecycle interface and the driven runtime surface are one type.
+ */
+interface DrivePlugin extends UpupPlugin {
+    readonly id: string;
+    init(emitter: EventEmitter): void;
+    destroy(): void;
+    restoreSession(): boolean;
+    isAuthenticated(): boolean;
+    getAccessToken(): string | null;
+    getUserInfo(): Promise<DriveUser | null | undefined>;
+    loadFiles(folderArg?: string): Promise<unknown>;
+    downloadFiles(files: DriveFile[]): Promise<File[]>;
+    signOut(): void;
+    authenticate?(token: string, expiresIn?: number): Promise<void>;
+    authenticateViaPopup?(): Promise<void>;
+    loadAllFilesInFolder?(folderArg: string): Promise<DriveFile[]>;
+    getConfig?(): unknown;
+    loadMoreFiles?(cursor: string): Promise<DriveListPage>;
+}
+
+/**
+ * Shared config for the popup-OAuth providers (Box / OneDrive / Dropbox). All
+ * three declare exactly this shape (`{ clientId, redirectUri? }`) — see
+ * `configs.ts`; the subclasses re-export their own alias for public ergonomics.
+ */
+interface DriveOAuthConfig {
+    clientId: string;
+    redirectUri?: string;
+}
+/**
+ * Per-provider configuration for a {@link PopupOAuthPlugin} subclass. Everything
+ * that differs between Box, OneDrive, and Dropbox at the auth/popup/refresh layer
+ * is data here — the skeleton itself is provider-agnostic.
+ */
+interface PopupOAuthSpec {
+    /** Stable plugin id, e.g. 'box' / 'one-drive' / 'dropbox'. */
+    id: string;
+    /** Human-facing provider name used in diagnostic error messages, e.g. 'Box' / 'OneDrive' / 'Dropbox'. */
+    displayName: string;
+    /** Event namespace: emits `${eventPrefix}:state-change`, `:authenticated`, `:session-expired`, `:error`, `:signed-out`, `:files-loaded`. */
+    eventPrefix: string;
+    /** window.open target name, e.g. 'UpupBoxAuth'. */
+    popupName: string;
+    /** OAuth2 authorize endpoint. */
+    authUrl: string;
+    /** OAuth2 token endpoint. */
+    tokenUrl: string;
+    /** Default redirect path appended to `window.location.origin`, e.g. '/box_redirect'. */
+    redirectPath: string;
+    /** sessionStorage keys for the access / refresh tokens and the absolute expiry ms. */
+    storageKeys: {
+        access: string;
+        refresh: string;
+        expiry: string;
+    };
+    /** Space-joined OAuth scopes. Omitted by Box (its scopes are app-configured). */
+    scopes?: string;
+    /** Extra provider params merged onto the authorize URL (e.g. MS `response_mode`, Dropbox `token_access_type`). */
+    authParams?: Record<string, string>;
+}
+/**
+ * Abstract base owning the popup-OAuth / PKCE / token-refresh / lifecycle skeleton
+ * shared byte-for-byte across the three client-mode popup providers (F-121). A
+ * concrete provider supplies (a) a {@link PopupOAuthSpec} and (b) its genuinely
+ * provider-specific domain methods (`mapEntry`, `fetchUserProfile`, `loadFiles`,
+ * `downloadFiles`, …), which are moved verbatim from the hand-written plugins.
+ *
+ * The one intended behavior change vs. the pre-extraction plugins is that Box now
+ * inherits proactive token refresh + persisted expiry (F-126) — OneDrive/Dropbox
+ * already had it.
+ *
+ * Not for GoogleDrive: its GIS access-token model has no PKCE popup and no refresh
+ * token, so it stays a standalone `implements DrivePlugin`.
+ */
+declare abstract class PopupOAuthPlugin implements DrivePlugin {
+    abstract readonly spec: PopupOAuthSpec;
+    get id(): string;
+    get name(): string;
+    protected emitter: EventEmitter | null;
+    protected config: DriveOAuthConfig;
+    protected accessToken: string | null;
+    protected refreshTokenValue: string | null;
+    protected tokenExpiry: number;
+    protected state: DriveState;
+    private codeVerifier;
+    private popupWindow;
+    private pollTimer;
+    configure(config: DriveOAuthConfig): this;
+    getConfig(): Readonly<DriveOAuthConfig>;
+    init(emitter: EventEmitter): void;
+    destroy(): void;
+    getState(): DriveState;
+    protected setState(newState: DriveState): void;
+    getAuthUrl(): Promise<string>;
+    authenticate(code: string): Promise<void>;
+    authenticateViaPopup(): Promise<void>;
+    refreshAccessToken(): Promise<string | null>;
+    signOut(): void;
+    restoreSession(): boolean;
+    isAuthenticated(): boolean;
+    getAccessToken(): string | null;
+    getUserInfo(): Promise<DriveUser | null>;
+    protected apiRequest(url: string, options: RequestInit, isRetry?: boolean): Promise<Response>;
+    protected setTokens(access: string, refresh: string | null, expiresIn?: number): void;
+    protected clearTokens(): void;
+    protected ensureValidToken(): Promise<void>;
+    protected getRedirectUri(): string;
+    protected cleanupPopup(): void;
+    private cleanupPollTimer;
+    protected abstract mapEntry(entry: Record<string, unknown>): DriveFile;
+    protected abstract fetchUserProfile(): Promise<DriveUser>;
+    abstract loadFiles(folderArg?: string): Promise<unknown>;
+    abstract downloadFiles(files: DriveFile[]): Promise<File[]>;
+}
+
+declare class DropboxPlugin extends PopupOAuthPlugin {
+    readonly spec: PopupOAuthSpec;
+    configure(config: DropboxConfig): this;
+    getConfig(): Readonly<DropboxConfig>;
+    loadFiles(path?: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadMoreFiles(cursor: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadAllFilesInFolder(folderPath: string): Promise<DriveFile[]>;
+    downloadFiles(driveFiles: DriveFile[]): Promise<File[]>;
+    searchFiles(query: string, path?: string): Promise<DriveFile[]>;
+    protected mapEntry(entry: Record<string, unknown>): DriveFile;
+    private downloadSingleFile;
+    protected fetchUserProfile(): Promise<DriveUser>;
+}
+
+declare class GoogleDrivePlugin implements DrivePlugin {
+    readonly id = "google-drive";
+    readonly name = "google-drive";
+    private emitter;
+    private config;
+    private accessToken;
+    private tokenExpiry;
+    private state;
+    configure(config: GoogleDriveConfig): this;
+    getConfig(): Readonly<GoogleDriveConfig>;
+    init(emitter: EventEmitter): void;
+    destroy(): void;
+    getState(): DriveState;
+    private setState;
+    setAccessToken(token: string, expiresIn?: number): void;
+    authenticate(token: string, expiresIn?: number): Promise<void>;
+    signOut(): void;
+    restoreSession(): boolean;
+    isAuthenticated(): boolean;
+    getAccessToken(): string | null;
+    getUserInfo(): Promise<{
+        name: string;
+        email: string;
+        picture?: string;
+    }>;
+    loadFiles(folderId?: string): Promise<{
+        files: DriveFile[];
+        folderId: string;
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadMoreFiles(cursor: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    downloadFiles(driveFiles: DriveFile[]): Promise<File[]>;
+    downloadFile(driveFile: DriveFile): Promise<File | null>;
+    private downloadRegularFile;
+    private downloadWorkspaceFile;
+    private apiRequest;
+    private clearTokens;
+    private ensureValidToken;
+}
+
+declare class BoxPlugin extends PopupOAuthPlugin {
+    readonly spec: PopupOAuthSpec;
+    configure(config: BoxConfig): this;
+    getConfig(): Readonly<BoxConfig>;
+    loadFiles(folderId?: string, offset?: string): Promise<{
+        files: DriveFile[];
+        folderId: string;
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadMoreFiles(cursor: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    downloadFiles(driveFiles: DriveFile[]): Promise<File[]>;
+    loadAllFilesInFolder(folderId: string): Promise<DriveFile[]>;
+    searchFiles(query: string): Promise<DriveFile[]>;
+    protected mapEntry(entry: Record<string, unknown>): DriveFile;
+    private downloadSingleFile;
+    protected fetchUserProfile(): Promise<DriveUser>;
+}
+
+declare class OneDrivePlugin extends PopupOAuthPlugin {
+    readonly spec: PopupOAuthSpec;
+    configure(config: OneDriveConfig): this;
+    getConfig(): Readonly<OneDriveConfig>;
+    loadFiles(folderId?: string): Promise<{
+        files: DriveFile[];
+        folderId: string;
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadMoreFiles(cursor: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    downloadFiles(driveFiles: DriveFile[]): Promise<File[]>;
+    loadAllFilesInFolder(folderId: string): Promise<DriveFile[]>;
+    protected mapEntry(entry: Record<string, unknown>): DriveFile;
+    protected fetchUserProfile(): Promise<DriveUser>;
+    private graphRequest;
+    private downloadSingleFile;
+}
+
+interface AcceptPresetDefinition {
+    label: string;
+    accept: string;
+}
+declare const ACCEPT_PRESETS: Record<string, AcceptPresetDefinition>;
+type AcceptPreset = keyof typeof ACCEPT_PRESETS;
+declare function resolveAccept(input: string | string[]): string;
+
+declare const FILE_TYPE_EXTENSIONS: readonly ["bmp", "css", "csv", "docx", "html", "jpg", "js", "jsx", "pdf", "png", "php", "ppt", "rs", "sql", "svg", "ts", "tsx", "txt", "vue", "xls", "xml", "zip"];
+type FileTypeIconName = `file-${(typeof FILE_TYPE_EXTENSIONS)[number]}`;
+
+type IconName = 'my-device' | 'box' | 'dropbox' | 'google-drive' | 'one-drive' | 'link' | 'camera' | 'audio' | 'screen-capture' | 'upload' | 'loader' | 'x' | 'chevron-left' | 'trash' | 'camera-rotate' | 'capture' | 'plus' | 'layout-grid' | 'layout-list' | 'folder' | 'folder-filled' | 'search' | 'user' | 'file' | 'stacked-files' | 'storage' | 'player-play' | 'player-pause' | FileTypeIconName;
+interface IconDef {
+    /** e.g. '0 0 24 24' (stroke/filled) or '0 0 32 32' (brand). */
+    viewBox: string;
+    /** px width/height when the renderer is given no explicit size. */
+    defaultSize: number;
+    /** outer-<svg> presentation attrs merged onto the svg (kebab-case keys). */
+    attrs?: Record<string, string>;
+    /** baked brand-color class merged onto the svg, e.g. 'upup-text-[#0061fe]'. */
+    className?: string;
+    /** raw inner-SVG markup (paths/groups/defs/masks) — the single source of truth. */
+    inner: string;
+}
+declare const ICONS: Record<IconName, IconDef>;
+
+/** Resolve a file extension to its registry glyph name, or the generic 'file'. */
+declare function fileTypeIconName(extension: string): IconName;
+
+export { ACCEPT_PRESETS, type AcceptPreset, type AcceptPresetDefinition, BoxConfig, BoxPlugin, DriveFile, DriveListPage, type DrivePlugin, DriveState, DriveUser, DropboxConfig, DropboxPlugin, FILE_TYPE_EXTENSIONS, type FileTypeIconName, GoogleDriveConfig, GoogleDrivePlugin, ICONS, type IconDef, type IconName, OneDriveConfig, OneDrivePlugin, PopupOAuthPlugin, type PopupOAuthSpec, UpupPlugin, fileTypeIconName, resolveAccept };

package/dist/index.d.ts

@@ -0,0 +1,280 @@
+export { F as FileSource, d as PipelineContext, P as PipelineStep, a as UploadFile, U as UploadFileMetadata, b as UploadFileWithProgress, c as UploadStatus } from './contracts-pipeline-cf177270.js';
+export { F as FileUploadResult, N as NON_S3_STORAGE_PROVIDERS, R as RestrictionFailedReason, S as StorageProvider, a as UploadProvider, U as UploadSource, b as UploaderBaseProps, e as UpupAuthError, j as UpupConfigError, d as UpupError, c as UpupErrorCode, f as UpupNetworkError, h as UpupQuotaError, i as UpupStorageError, g as UpupValidationError, u as uploadErrorFromResponse } from './uploader-props-72242002.js';
+export { C as CrashRecoveryOptions, M as MaxFileSizeObject, g as MultipartAbortResponse, f as MultipartCompleteResponse, a as MultipartInitResponse, d as MultipartListPartsResponse, c as MultipartPart, e as MultipartResumeResponse, b as MultipartSignPartResponse, P as PresignedUrlResponse, R as ResumableUploadOptions } from './contracts-strategies-378a16b7.js';
+import { c as UpupPlugin, E as EventEmitter, D as DropboxConfig, G as GoogleDriveConfig, B as BoxConfig, O as OneDriveConfig } from './core-141335ac.js';
+export { b as CloudDrivesConfig, d as CoreOptions, g as ExtensionMethods, h as FileProgress, F as FilesProgressMap, a as ImageCompressionOptions, I as ImageEditorOptions, R as ResolvedImageEditorOptions, T as ThumbnailGeneratorOptions, e as UploadOptions, U as UpupCore, f as UpupCorsConfig, V as ValidationResult } from './core-141335ac.js';
+export { e as LOCALE_CODES, g as LOCALE_REGISTRY, L as LocaleBundle, P as PartialMessages, R as RegisteredLocaleCode, c as Translations, T as Translator, d as UiTranslations, a as UpupLocaleCode, U as UpupMessages, f as flattenTranslatorToUiTranslations, b as formatUiMessage, p as pluralUiMessage } from './ui-translations-c5d00392.js';
+export { L as LOCALE_META, a as LocaleMeta, T as TranslatorOptions, d as arSA, c as createTranslator, f as deDE, b as enUS, e as errorCodeToMessageKey, g as esES, h as frFR, j as jaJP, k as koKR, n as normalizeBcp47, z as zhCN, i as zhTW } from './error-code-map-9c44a425.js';
+export { h as UPUP_VAR_PREFIX, U as UpupColorTokens, a as UpupRadiusTokens, b as UpupShadowTokens, k as UpupSlotPath, c as UpupSpacingTokens, f as UpupThemeConfig, e as UpupThemeMode, j as UpupThemeSlots, d as UpupThemeTokens, m as flattenSlotsToClassNames, t as tokensToVars } from './vars-d3421f6c.js';
+export { d as darkPreset, l as lightPreset, r as resolveTheme } from './resolve-theme-01758105.js';
+import { D as DriveUser, a as DriveFile, b as DriveListPage, c as DriveState } from './server-mode-drive-controller-b5f8ee12.js';
+export { B as BOX_DESCRIPTOR, g as DROPBOX_DESCRIPTOR, f as DriveBrowserError, e as DriveEventMap, d as DriveFolder, G as GOOGLE_DRIVE_DESCRIPTOR, O as ONE_DRIVE_DESCRIPTOR, h as ObservableController, i as ServerDriveFile, j as ServerDriveListState, S as ServerModeProvider } from './server-mode-drive-controller-b5f8ee12.js';
+
+/**
+ * The single drive-plugin contract. Extends the generic UpupPlugin registration
+ * base with the drive lifecycle (id/init/destroy) AND the runtime surface the
+ * DriveBrowserController drives. The four concrete *Plugin classes implement this.
+ * Members marked optional may be omitted by a future provider that doesn't need them:
+ * authenticate is implemented by all current providers but only invoked on the GIS path;
+ * authenticateViaPopup/loadAllFilesInFolder are popup-provider-only (absent on GIS);
+ * getConfig is implemented by all and read for the GIS client id.
+ *
+ * Folds in the formerly-inline DriveBrowserPlugin (was in drive-browser-controller.ts)
+ * so the declared lifecycle interface and the driven runtime surface are one type.
+ */
+interface DrivePlugin extends UpupPlugin {
+    readonly id: string;
+    init(emitter: EventEmitter): void;
+    destroy(): void;
+    restoreSession(): boolean;
+    isAuthenticated(): boolean;
+    getAccessToken(): string | null;
+    getUserInfo(): Promise<DriveUser | null | undefined>;
+    loadFiles(folderArg?: string): Promise<unknown>;
+    downloadFiles(files: DriveFile[]): Promise<File[]>;
+    signOut(): void;
+    authenticate?(token: string, expiresIn?: number): Promise<void>;
+    authenticateViaPopup?(): Promise<void>;
+    loadAllFilesInFolder?(folderArg: string): Promise<DriveFile[]>;
+    getConfig?(): unknown;
+    loadMoreFiles?(cursor: string): Promise<DriveListPage>;
+}
+
+/**
+ * Shared config for the popup-OAuth providers (Box / OneDrive / Dropbox). All
+ * three declare exactly this shape (`{ clientId, redirectUri? }`) — see
+ * `configs.ts`; the subclasses re-export their own alias for public ergonomics.
+ */
+interface DriveOAuthConfig {
+    clientId: string;
+    redirectUri?: string;
+}
+/**
+ * Per-provider configuration for a {@link PopupOAuthPlugin} subclass. Everything
+ * that differs between Box, OneDrive, and Dropbox at the auth/popup/refresh layer
+ * is data here — the skeleton itself is provider-agnostic.
+ */
+interface PopupOAuthSpec {
+    /** Stable plugin id, e.g. 'box' / 'one-drive' / 'dropbox'. */
+    id: string;
+    /** Human-facing provider name used in diagnostic error messages, e.g. 'Box' / 'OneDrive' / 'Dropbox'. */
+    displayName: string;
+    /** Event namespace: emits `${eventPrefix}:state-change`, `:authenticated`, `:session-expired`, `:error`, `:signed-out`, `:files-loaded`. */
+    eventPrefix: string;
+    /** window.open target name, e.g. 'UpupBoxAuth'. */
+    popupName: string;
+    /** OAuth2 authorize endpoint. */
+    authUrl: string;
+    /** OAuth2 token endpoint. */
+    tokenUrl: string;
+    /** Default redirect path appended to `window.location.origin`, e.g. '/box_redirect'. */
+    redirectPath: string;
+    /** sessionStorage keys for the access / refresh tokens and the absolute expiry ms. */
+    storageKeys: {
+        access: string;
+        refresh: string;
+        expiry: string;
+    };
+    /** Space-joined OAuth scopes. Omitted by Box (its scopes are app-configured). */
+    scopes?: string;
+    /** Extra provider params merged onto the authorize URL (e.g. MS `response_mode`, Dropbox `token_access_type`). */
+    authParams?: Record<string, string>;
+}
+/**
+ * Abstract base owning the popup-OAuth / PKCE / token-refresh / lifecycle skeleton
+ * shared byte-for-byte across the three client-mode popup providers (F-121). A
+ * concrete provider supplies (a) a {@link PopupOAuthSpec} and (b) its genuinely
+ * provider-specific domain methods (`mapEntry`, `fetchUserProfile`, `loadFiles`,
+ * `downloadFiles`, …), which are moved verbatim from the hand-written plugins.
+ *
+ * The one intended behavior change vs. the pre-extraction plugins is that Box now
+ * inherits proactive token refresh + persisted expiry (F-126) — OneDrive/Dropbox
+ * already had it.
+ *
+ * Not for GoogleDrive: its GIS access-token model has no PKCE popup and no refresh
+ * token, so it stays a standalone `implements DrivePlugin`.
+ */
+declare abstract class PopupOAuthPlugin implements DrivePlugin {
+    abstract readonly spec: PopupOAuthSpec;
+    get id(): string;
+    get name(): string;
+    protected emitter: EventEmitter | null;
+    protected config: DriveOAuthConfig;
+    protected accessToken: string | null;
+    protected refreshTokenValue: string | null;
+    protected tokenExpiry: number;
+    protected state: DriveState;
+    private codeVerifier;
+    private popupWindow;
+    private pollTimer;
+    configure(config: DriveOAuthConfig): this;
+    getConfig(): Readonly<DriveOAuthConfig>;
+    init(emitter: EventEmitter): void;
+    destroy(): void;
+    getState(): DriveState;
+    protected setState(newState: DriveState): void;
+    getAuthUrl(): Promise<string>;
+    authenticate(code: string): Promise<void>;
+    authenticateViaPopup(): Promise<void>;
+    refreshAccessToken(): Promise<string | null>;
+    signOut(): void;
+    restoreSession(): boolean;
+    isAuthenticated(): boolean;
+    getAccessToken(): string | null;
+    getUserInfo(): Promise<DriveUser | null>;
+    protected apiRequest(url: string, options: RequestInit, isRetry?: boolean): Promise<Response>;
+    protected setTokens(access: string, refresh: string | null, expiresIn?: number): void;
+    protected clearTokens(): void;
+    protected ensureValidToken(): Promise<void>;
+    protected getRedirectUri(): string;
+    protected cleanupPopup(): void;
+    private cleanupPollTimer;
+    protected abstract mapEntry(entry: Record<string, unknown>): DriveFile;
+    protected abstract fetchUserProfile(): Promise<DriveUser>;
+    abstract loadFiles(folderArg?: string): Promise<unknown>;
+    abstract downloadFiles(files: DriveFile[]): Promise<File[]>;
+}
+
+declare class DropboxPlugin extends PopupOAuthPlugin {
+    readonly spec: PopupOAuthSpec;
+    configure(config: DropboxConfig): this;
+    getConfig(): Readonly<DropboxConfig>;
+    loadFiles(path?: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadMoreFiles(cursor: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadAllFilesInFolder(folderPath: string): Promise<DriveFile[]>;
+    downloadFiles(driveFiles: DriveFile[]): Promise<File[]>;
+    searchFiles(query: string, path?: string): Promise<DriveFile[]>;
+    protected mapEntry(entry: Record<string, unknown>): DriveFile;
+    private downloadSingleFile;
+    protected fetchUserProfile(): Promise<DriveUser>;
+}
+
+declare class GoogleDrivePlugin implements DrivePlugin {
+    readonly id = "google-drive";
+    readonly name = "google-drive";
+    private emitter;
+    private config;
+    private accessToken;
+    private tokenExpiry;
+    private state;
+    configure(config: GoogleDriveConfig): this;
+    getConfig(): Readonly<GoogleDriveConfig>;
+    init(emitter: EventEmitter): void;
+    destroy(): void;
+    getState(): DriveState;
+    private setState;
+    setAccessToken(token: string, expiresIn?: number): void;
+    authenticate(token: string, expiresIn?: number): Promise<void>;
+    signOut(): void;
+    restoreSession(): boolean;
+    isAuthenticated(): boolean;
+    getAccessToken(): string | null;
+    getUserInfo(): Promise<{
+        name: string;
+        email: string;
+        picture?: string;
+    }>;
+    loadFiles(folderId?: string): Promise<{
+        files: DriveFile[];
+        folderId: string;
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadMoreFiles(cursor: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    downloadFiles(driveFiles: DriveFile[]): Promise<File[]>;
+    downloadFile(driveFile: DriveFile): Promise<File | null>;
+    private downloadRegularFile;
+    private downloadWorkspaceFile;
+    private apiRequest;
+    private clearTokens;
+    private ensureValidToken;
+}
+
+declare class BoxPlugin extends PopupOAuthPlugin {
+    readonly spec: PopupOAuthSpec;
+    configure(config: BoxConfig): this;
+    getConfig(): Readonly<BoxConfig>;
+    loadFiles(folderId?: string, offset?: string): Promise<{
+        files: DriveFile[];
+        folderId: string;
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadMoreFiles(cursor: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    downloadFiles(driveFiles: DriveFile[]): Promise<File[]>;
+    loadAllFilesInFolder(folderId: string): Promise<DriveFile[]>;
+    searchFiles(query: string): Promise<DriveFile[]>;
+    protected mapEntry(entry: Record<string, unknown>): DriveFile;
+    private downloadSingleFile;
+    protected fetchUserProfile(): Promise<DriveUser>;
+}
+
+declare class OneDrivePlugin extends PopupOAuthPlugin {
+    readonly spec: PopupOAuthSpec;
+    configure(config: OneDriveConfig): this;
+    getConfig(): Readonly<OneDriveConfig>;
+    loadFiles(folderId?: string): Promise<{
+        files: DriveFile[];
+        folderId: string;
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    loadMoreFiles(cursor: string): Promise<{
+        files: DriveFile[];
+        hasMore: boolean;
+        cursor?: string;
+    }>;
+    downloadFiles(driveFiles: DriveFile[]): Promise<File[]>;
+    loadAllFilesInFolder(folderId: string): Promise<DriveFile[]>;
+    protected mapEntry(entry: Record<string, unknown>): DriveFile;
+    protected fetchUserProfile(): Promise<DriveUser>;
+    private graphRequest;
+    private downloadSingleFile;
+}
+
+interface AcceptPresetDefinition {
+    label: string;
+    accept: string;
+}
+declare const ACCEPT_PRESETS: Record<string, AcceptPresetDefinition>;
+type AcceptPreset = keyof typeof ACCEPT_PRESETS;
+declare function resolveAccept(input: string | string[]): string;
+
+declare const FILE_TYPE_EXTENSIONS: readonly ["bmp", "css", "csv", "docx", "html", "jpg", "js", "jsx", "pdf", "png", "php", "ppt", "rs", "sql", "svg", "ts", "tsx", "txt", "vue", "xls", "xml", "zip"];
+type FileTypeIconName = `file-${(typeof FILE_TYPE_EXTENSIONS)[number]}`;
+
+type IconName = 'my-device' | 'box' | 'dropbox' | 'google-drive' | 'one-drive' | 'link' | 'camera' | 'audio' | 'screen-capture' | 'upload' | 'loader' | 'x' | 'chevron-left' | 'trash' | 'camera-rotate' | 'capture' | 'plus' | 'layout-grid' | 'layout-list' | 'folder' | 'folder-filled' | 'search' | 'user' | 'file' | 'stacked-files' | 'storage' | 'player-play' | 'player-pause' | FileTypeIconName;
+interface IconDef {
+    /** e.g. '0 0 24 24' (stroke/filled) or '0 0 32 32' (brand). */
+    viewBox: string;
+    /** px width/height when the renderer is given no explicit size. */
+    defaultSize: number;
+    /** outer-<svg> presentation attrs merged onto the svg (kebab-case keys). */
+    attrs?: Record<string, string>;
+    /** baked brand-color class merged onto the svg, e.g. 'upup-text-[#0061fe]'. */
+    className?: string;
+    /** raw inner-SVG markup (paths/groups/defs/masks) — the single source of truth. */
+    inner: string;
+}
+declare const ICONS: Record<IconName, IconDef>;
+
+/** Resolve a file extension to its registry glyph name, or the generic 'file'. */
+declare function fileTypeIconName(extension: string): IconName;
+
+export { ACCEPT_PRESETS, type AcceptPreset, type AcceptPresetDefinition, BoxConfig, BoxPlugin, DriveFile, DriveListPage, type DrivePlugin, DriveState, DriveUser, DropboxConfig, DropboxPlugin, FILE_TYPE_EXTENSIONS, type FileTypeIconName, GoogleDriveConfig, GoogleDrivePlugin, ICONS, type IconDef, type IconName, OneDriveConfig, OneDrivePlugin, PopupOAuthPlugin, type PopupOAuthSpec, UpupPlugin, fileTypeIconName, resolveAccept };