@useupup/core 3.3.0

package/dist/vars-d3421f6c.d.cts

@@ -0,0 +1,240 @@
+/**
+ * Component-scoped slot definitions.
+ * Each component key maps to a record of slot names -> optional className override.
+ *
+ * Users can pass `theme.slots` to override specific slots without
+ * touching the global token system.
+ */
+interface UpupThemeSlots {
+    uploader: {
+        root?: string;
+        container?: string;
+    };
+    dropZone: {
+        root?: string;
+    };
+    sourceSelector: {
+        root?: string;
+        sourceList?: string;
+        sourceButton?: string;
+        sourceButtonIcon?: string;
+        sourceButtonText?: string;
+        browseText?: string;
+        dragText?: string;
+    };
+    sourceView: {
+        root?: string;
+        header?: string;
+        cancelButton?: string;
+    };
+    fileList: {
+        root?: string;
+        header?: string;
+        cancelButton?: string;
+        addMoreButton?: string;
+        fileCount?: string;
+        body?: string;
+        footer?: string;
+        uploadButton?: string;
+        doneButton?: string;
+    };
+    filePreview: {
+        root?: string;
+        thumbnail?: string;
+        icon?: string;
+        info?: string;
+        name?: string;
+        size?: string;
+        previewButton?: string;
+        deleteButton?: string;
+    };
+    progressBar: {
+        root?: string;
+        track?: string;
+        fill?: string;
+        text?: string;
+    };
+    notifier: {
+        root?: string;
+        message?: string;
+    };
+    urlUploader: {
+        input?: string;
+        fetchButton?: string;
+    };
+    cameraUploader: {
+        previewContainer?: string;
+        deleteButton?: string;
+        captureButton?: string;
+        rotateButton?: string;
+        mirrorButton?: string;
+        addButton?: string;
+        modeToggle?: string;
+        videoRecordButton?: string;
+        videoStopButton?: string;
+        videoPreview?: string;
+        videoAddButton?: string;
+        videoDeleteButton?: string;
+    };
+    audioUploader: {
+        root?: string;
+        playbackContainer?: string;
+        deleteButton?: string;
+        addButton?: string;
+    };
+    screenCaptureUploader: {
+        root?: string;
+        preview?: string;
+        addButton?: string;
+        deleteButton?: string;
+    };
+    driveBrowser: {
+        root?: string;
+        header?: string;
+        searchContainer?: string;
+        searchInput?: string;
+        body?: string;
+        footer?: string;
+        itemDefault?: string;
+        itemSelected?: string;
+        itemInner?: string;
+        itemInnerText?: string;
+        addFilesButton?: string;
+        cancelFilesButton?: string;
+        logoutButton?: string;
+        loading?: string;
+    };
+    driveAuthFallback: {
+        root?: string;
+    };
+    filePreviewPortal: {
+        root?: string;
+    };
+    imageEditor: {
+        root?: string;
+        modal?: string;
+    };
+}
+/**
+ * All valid slot path strings, e.g. "uploader.root", "fileList.uploadButton".
+ * Useful for data-upup-slot attribute values.
+ */
+type UpupSlotPath = {
+    [C in keyof UpupThemeSlots]: {
+        [S in keyof UpupThemeSlots[C]]: `${C & string}.${S & string}`;
+    }[keyof UpupThemeSlots[C]];
+}[keyof UpupThemeSlots];
+type DeepPartialSlots = {
+    [C in keyof UpupThemeSlots]?: Partial<UpupThemeSlots[C]>;
+};
+/**
+ * Flat shape the internal React runtime reads from. Produced by
+ * `flattenSlotsToClassNames()` and kept as an implementation detail — do not
+ * consume directly. Consumers override slots via `theme.slots` in v2.
+ */
+type InternalFlatClassNames = Partial<Record<string, string>>;
+/**
+ * Project a `theme.slots` override map into the flat className shape the
+ * internal React tree currently consumes. Later v2 iterations may migrate
+ * components to read slot paths directly; until then, this flattener keeps
+ * the public slot API wired without requiring per-component rewrites.
+ *
+ * Precedence inside a single call: later slot writes to the same flat key
+ * win, which matches the intuitive "deepest override wins" rule.
+ */
+declare function flattenSlotsToClassNames(slots: DeepPartialSlots | undefined): InternalFlatClassNames;
+
+/** Individual color tokens for the upup theme */
+interface UpupColorTokens {
+    /** Main surface background (e.g. uploader container) */
+    surface: string;
+    /** Alternate surface (e.g. file list header/footer) */
+    surfaceAlt: string;
+    /** Primary action color (buttons, links) */
+    primary: string;
+    /** Primary hover state */
+    primaryHover: string;
+    /** Main text color */
+    text: string;
+    /** Muted/secondary text */
+    textMuted: string;
+    /** Default border color */
+    border: string;
+    /** Active/focused border color */
+    borderActive: string;
+    /** Error/danger color */
+    danger: string;
+    /** Success color */
+    success: string;
+    /** Drag-over background */
+    dragBg: string;
+    /** Overlay/backdrop color */
+    overlay: string;
+}
+interface UpupRadiusTokens {
+    sm: string;
+    md: string;
+    lg: string;
+    full: string;
+}
+interface UpupShadowTokens {
+    sm: string;
+    md: string;
+    lg: string;
+}
+interface UpupSpacingTokens {
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+}
+interface UpupThemeTokens {
+    color: UpupColorTokens;
+    radius: UpupRadiusTokens;
+    shadow: UpupShadowTokens;
+    spacing: UpupSpacingTokens;
+}
+type UpupThemeMode = 'light' | 'dark' | 'system';
+/**
+ * Full theme configuration object.
+ * Users can pass partial overrides; resolveTheme() fills in defaults.
+ */
+interface UpupThemeConfig {
+    /** 'light' | 'dark' | 'system' — controls which preset to use as base */
+    mode?: UpupThemeMode;
+    /** Partial token overrides applied on top of the mode preset */
+    tokens?: DeepPartial<UpupThemeTokens>;
+    /** Per-component slot class overrides */
+    slots?: DeepPartial<UpupThemeSlots>;
+}
+/** Resolved theme — all tokens are guaranteed present */
+interface UpupResolvedTheme {
+    mode: UpupThemeMode;
+    tokens: UpupThemeTokens;
+    slots: DeepPartial<UpupThemeSlots>;
+}
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+declare const UPUP_VAR_PREFIX = "--upup-";
+/**
+ * Convert a full UpupThemeTokens object to a flat Record of CSS variable
+ * assignments: { '--upup-color-surface': '#FFFFFF', ... }
+ *
+ * Suitable for passing to `style` attribute on root element.
+ */
+declare function tokensToVars(tokens: UpupThemeTokens): Record<string, string>;
+/**
+ * Generate a UpupThemeTokens-shaped object where each leaf is a
+ * `var(--upup-<group>-<key>)` reference string.
+ *
+ * NOTE (2026-07): currently unconsumed. No component or theme slot reads
+ * these var-ref strings today — components apply tokens via inline cn()
+ * class strings (see UploaderPanel.tsx). Retained as part of the public
+ * theme surface for future slot-level styling; do not assume the spacing
+ * group is wired until a component actually references it.
+ */
+declare function tokensToVarRefs(): UpupThemeTokens;
+
+export { type DeepPartial as D, type InternalFlatClassNames as I, type UpupColorTokens as U, type UpupRadiusTokens as a, type UpupShadowTokens as b, type UpupSpacingTokens as c, type UpupThemeTokens as d, type UpupThemeMode as e, type UpupThemeConfig as f, type UpupResolvedTheme as g, UPUP_VAR_PREFIX as h, tokensToVarRefs as i, type UpupThemeSlots as j, type UpupSlotPath as k, type DeepPartialSlots as l, flattenSlotsToClassNames as m, tokensToVars as t };

package/dist/vars-d3421f6c.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Component-scoped slot definitions.
+ * Each component key maps to a record of slot names -> optional className override.
+ *
+ * Users can pass `theme.slots` to override specific slots without
+ * touching the global token system.
+ */
+interface UpupThemeSlots {
+    uploader: {
+        root?: string;
+        container?: string;
+    };
+    dropZone: {
+        root?: string;
+    };
+    sourceSelector: {
+        root?: string;
+        sourceList?: string;
+        sourceButton?: string;
+        sourceButtonIcon?: string;
+        sourceButtonText?: string;
+        browseText?: string;
+        dragText?: string;
+    };
+    sourceView: {
+        root?: string;
+        header?: string;
+        cancelButton?: string;
+    };
+    fileList: {
+        root?: string;
+        header?: string;
+        cancelButton?: string;
+        addMoreButton?: string;
+        fileCount?: string;
+        body?: string;
+        footer?: string;
+        uploadButton?: string;
+        doneButton?: string;
+    };
+    filePreview: {
+        root?: string;
+        thumbnail?: string;
+        icon?: string;
+        info?: string;
+        name?: string;
+        size?: string;
+        previewButton?: string;
+        deleteButton?: string;
+    };
+    progressBar: {
+        root?: string;
+        track?: string;
+        fill?: string;
+        text?: string;
+    };
+    notifier: {
+        root?: string;
+        message?: string;
+    };
+    urlUploader: {
+        input?: string;
+        fetchButton?: string;
+    };
+    cameraUploader: {
+        previewContainer?: string;
+        deleteButton?: string;
+        captureButton?: string;
+        rotateButton?: string;
+        mirrorButton?: string;
+        addButton?: string;
+        modeToggle?: string;
+        videoRecordButton?: string;
+        videoStopButton?: string;
+        videoPreview?: string;
+        videoAddButton?: string;
+        videoDeleteButton?: string;
+    };
+    audioUploader: {
+        root?: string;
+        playbackContainer?: string;
+        deleteButton?: string;
+        addButton?: string;
+    };
+    screenCaptureUploader: {
+        root?: string;
+        preview?: string;
+        addButton?: string;
+        deleteButton?: string;
+    };
+    driveBrowser: {
+        root?: string;
+        header?: string;
+        searchContainer?: string;
+        searchInput?: string;
+        body?: string;
+        footer?: string;
+        itemDefault?: string;
+        itemSelected?: string;
+        itemInner?: string;
+        itemInnerText?: string;
+        addFilesButton?: string;
+        cancelFilesButton?: string;
+        logoutButton?: string;
+        loading?: string;
+    };
+    driveAuthFallback: {
+        root?: string;
+    };
+    filePreviewPortal: {
+        root?: string;
+    };
+    imageEditor: {
+        root?: string;
+        modal?: string;
+    };
+}
+/**
+ * All valid slot path strings, e.g. "uploader.root", "fileList.uploadButton".
+ * Useful for data-upup-slot attribute values.
+ */
+type UpupSlotPath = {
+    [C in keyof UpupThemeSlots]: {
+        [S in keyof UpupThemeSlots[C]]: `${C & string}.${S & string}`;
+    }[keyof UpupThemeSlots[C]];
+}[keyof UpupThemeSlots];
+type DeepPartialSlots = {
+    [C in keyof UpupThemeSlots]?: Partial<UpupThemeSlots[C]>;
+};
+/**
+ * Flat shape the internal React runtime reads from. Produced by
+ * `flattenSlotsToClassNames()` and kept as an implementation detail — do not
+ * consume directly. Consumers override slots via `theme.slots` in v2.
+ */
+type InternalFlatClassNames = Partial<Record<string, string>>;
+/**
+ * Project a `theme.slots` override map into the flat className shape the
+ * internal React tree currently consumes. Later v2 iterations may migrate
+ * components to read slot paths directly; until then, this flattener keeps
+ * the public slot API wired without requiring per-component rewrites.
+ *
+ * Precedence inside a single call: later slot writes to the same flat key
+ * win, which matches the intuitive "deepest override wins" rule.
+ */
+declare function flattenSlotsToClassNames(slots: DeepPartialSlots | undefined): InternalFlatClassNames;
+
+/** Individual color tokens for the upup theme */
+interface UpupColorTokens {
+    /** Main surface background (e.g. uploader container) */
+    surface: string;
+    /** Alternate surface (e.g. file list header/footer) */
+    surfaceAlt: string;
+    /** Primary action color (buttons, links) */
+    primary: string;
+    /** Primary hover state */
+    primaryHover: string;
+    /** Main text color */
+    text: string;
+    /** Muted/secondary text */
+    textMuted: string;
+    /** Default border color */
+    border: string;
+    /** Active/focused border color */
+    borderActive: string;
+    /** Error/danger color */
+    danger: string;
+    /** Success color */
+    success: string;
+    /** Drag-over background */
+    dragBg: string;
+    /** Overlay/backdrop color */
+    overlay: string;
+}
+interface UpupRadiusTokens {
+    sm: string;
+    md: string;
+    lg: string;
+    full: string;
+}
+interface UpupShadowTokens {
+    sm: string;
+    md: string;
+    lg: string;
+}
+interface UpupSpacingTokens {
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+}
+interface UpupThemeTokens {
+    color: UpupColorTokens;
+    radius: UpupRadiusTokens;
+    shadow: UpupShadowTokens;
+    spacing: UpupSpacingTokens;
+}
+type UpupThemeMode = 'light' | 'dark' | 'system';
+/**
+ * Full theme configuration object.
+ * Users can pass partial overrides; resolveTheme() fills in defaults.
+ */
+interface UpupThemeConfig {
+    /** 'light' | 'dark' | 'system' — controls which preset to use as base */
+    mode?: UpupThemeMode;
+    /** Partial token overrides applied on top of the mode preset */
+    tokens?: DeepPartial<UpupThemeTokens>;
+    /** Per-component slot class overrides */
+    slots?: DeepPartial<UpupThemeSlots>;
+}
+/** Resolved theme — all tokens are guaranteed present */
+interface UpupResolvedTheme {
+    mode: UpupThemeMode;
+    tokens: UpupThemeTokens;
+    slots: DeepPartial<UpupThemeSlots>;
+}
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+declare const UPUP_VAR_PREFIX = "--upup-";
+/**
+ * Convert a full UpupThemeTokens object to a flat Record of CSS variable
+ * assignments: { '--upup-color-surface': '#FFFFFF', ... }
+ *
+ * Suitable for passing to `style` attribute on root element.
+ */
+declare function tokensToVars(tokens: UpupThemeTokens): Record<string, string>;
+/**
+ * Generate a UpupThemeTokens-shaped object where each leaf is a
+ * `var(--upup-<group>-<key>)` reference string.
+ *
+ * NOTE (2026-07): currently unconsumed. No component or theme slot reads
+ * these var-ref strings today — components apply tokens via inline cn()
+ * class strings (see UploaderPanel.tsx). Retained as part of the public
+ * theme surface for future slot-level styling; do not assume the spacing
+ * group is wired until a component actually references it.
+ */
+declare function tokensToVarRefs(): UpupThemeTokens;
+
+export { type DeepPartial as D, type InternalFlatClassNames as I, type UpupColorTokens as U, type UpupRadiusTokens as a, type UpupShadowTokens as b, type UpupSpacingTokens as c, type UpupThemeTokens as d, type UpupThemeMode as e, type UpupThemeConfig as f, type UpupResolvedTheme as g, UPUP_VAR_PREFIX as h, tokensToVarRefs as i, type UpupThemeSlots as j, type UpupSlotPath as k, type DeepPartialSlots as l, flattenSlotsToClassNames as m, tokensToVars as t };

package/package.json

@@ -0,0 +1,182 @@
+{
+  "name": "@useupup/core",
+  "version": "3.3.0",
+  "description": "Headless, framework-agnostic file-upload engine powering the upup uploader — file state, upload pipeline (compression, HEIC, web-worker offload), cloud-drive sources, i18n, and theming.",
+  "keywords": [
+    "file-upload",
+    "file-uploader",
+    "uploader",
+    "headless",
+    "drag-and-drop",
+    "dropzone",
+    "file-picker",
+    "image-upload",
+    "s3",
+    "presigned-url",
+    "google-drive",
+    "one-drive",
+    "dropbox",
+    "camera",
+    "cloud-storage",
+    "typescript"
+  ],
+  "homepage": "https://useupup.com",
+  "bugs": {
+    "url": "https://github.com/DevinoSolutions/upup/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DevinoSolutions/upup.git",
+    "directory": "packages/core"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./contracts": {
+      "types": "./dist/contracts.d.ts",
+      "import": "./dist/contracts.js",
+      "require": "./dist/contracts.cjs"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js",
+      "require": "./dist/internal.cjs"
+    },
+    "./i18n": {
+      "types": "./dist/i18n/index.d.ts",
+      "import": "./dist/i18n/index.js",
+      "require": "./dist/i18n/index.cjs"
+    },
+    "./theme": {
+      "types": "./dist/theme/index.d.ts",
+      "import": "./dist/theme/index.js",
+      "require": "./dist/theme/index.cjs"
+    },
+    "./strategies": {
+      "types": "./dist/strategies/index.d.ts",
+      "import": "./dist/strategies/index.js",
+      "require": "./dist/strategies/index.cjs"
+    },
+    "./strategies/tus-upload": {
+      "types": "./dist/strategies/tus-upload.d.ts",
+      "import": "./dist/strategies/tus-upload.js",
+      "require": "./dist/strategies/tus-upload.cjs"
+    },
+    "./pipeline": {
+      "types": "./dist/pipeline/index.d.ts",
+      "import": "./dist/pipeline/index.js",
+      "require": "./dist/pipeline/index.cjs"
+    },
+    "./steps/hash": {
+      "types": "./dist/steps/hash.d.ts",
+      "import": "./dist/steps/hash.js",
+      "require": "./dist/steps/hash.cjs"
+    },
+    "./steps/heic": {
+      "types": "./dist/steps/heic.d.ts",
+      "import": "./dist/steps/heic.js",
+      "require": "./dist/steps/heic.cjs"
+    },
+    "./steps/exif": {
+      "types": "./dist/steps/exif.d.ts",
+      "import": "./dist/steps/exif.js",
+      "require": "./dist/steps/exif.cjs"
+    },
+    "./steps/compress": {
+      "types": "./dist/steps/compress.d.ts",
+      "import": "./dist/steps/compress.js",
+      "require": "./dist/steps/compress.cjs"
+    },
+    "./steps/thumbnail": {
+      "types": "./dist/steps/thumbnail.d.ts",
+      "import": "./dist/steps/thumbnail.js",
+      "require": "./dist/steps/thumbnail.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "contracts": [
+        "dist/contracts.d.ts"
+      ],
+      "internal": [
+        "dist/internal.d.ts"
+      ],
+      "i18n": [
+        "dist/i18n/index.d.ts"
+      ],
+      "theme": [
+        "dist/theme/index.d.ts"
+      ],
+      "strategies": [
+        "dist/strategies/index.d.ts"
+      ],
+      "strategies/tus-upload": [
+        "dist/strategies/tus-upload.d.ts"
+      ],
+      "pipeline": [
+        "dist/pipeline/index.d.ts"
+      ],
+      "steps/hash": [
+        "dist/steps/hash.d.ts"
+      ],
+      "steps/heic": [
+        "dist/steps/heic.d.ts"
+      ],
+      "steps/exif": [
+        "dist/steps/exif.d.ts"
+      ],
+      "steps/compress": [
+        "dist/steps/compress.d.ts"
+      ],
+      "steps/thumbnail": [
+        "dist/steps/thumbnail.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "intl-messageformat": "^11.2.0",
+    "tailwind-merge": "^3.6.0"
+  },
+  "optionalDependencies": {
+    "libheif-js": "^1.19.8",
+    "tus-js-client": "^4.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "@vitest/coverage-v8": "^4.1.2",
+    "eslint": "^10.6.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.3.2",
+    "vitest": "^4.1.2",
+    "@useupup/eslint-config": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint . --max-warnings 0",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json --noEmit"
+  }
+}