@startdownnotez404/ui 1.3.5 → 1.3.6

package/dist/modal.mjs

@@ -4,16 +4,18 @@ import {
   default as default2,
   muiModalPaperSx,
   muiModalRootSx
-} from "./chunk-UDREPVEY.mjs";
-import "./chunk-CWFWRZWU.mjs";
+} from "./chunk-RVSMEZE3.mjs";
+import "./chunk-2FK24ZPJ.mjs";
+import "./chunk-KSN33A6I.mjs";
 import "./chunk-3VUAM2GY.mjs";
 import "./chunk-UMJ5SCIQ.mjs";
-import "./chunk-JIU5GVM7.mjs";
+import "./chunk-ZVFYOXDE.mjs";
+import "./chunk-D4XPNSSI.mjs";
 import "./chunk-4Q54P737.mjs";
 import "./chunk-OP6LKXPA.mjs";
-import "./chunk-ZVFYOXDE.mjs";
 import "./chunk-4RPFRNXG.mjs";
-import "./chunk-S6EZVRZC.mjs";
+import "./chunk-PNSJC6PC.mjs";
+import "./chunk-AFLEG5ZC.mjs";
 import "./chunk-FJ6ZGZIA.mjs";
 export {
   MUI_MODAL_PAPER_RADIUS,

package/dist/process.d.mts

@@ -1,81 +1,33 @@
 import React from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
-type ValueOf<T> = T[keyof T];
-
-declare const FILE_STATUSs: {
-    readonly uploadingToLocal: "local-uploading";
-    readonly uploadedToLocal: "local-uploaded";
-    readonly localError: "local-error";
-    readonly pending: "pending";
-    readonly uploadPending: "upload-pending";
-    readonly gettingSignedURL: "upload-gettingSignedURL";
-    readonly beginUploadToS3: "upload-beginUploadToS3";
-    readonly uploadedToCloud: "upload-uploadedToCloud";
-    readonly error: "upload-error";
-    readonly downloadPending: "download-pending";
-    readonly downloading: "download-in-progress";
-    readonly downloaded: "download-completed";
-    readonly downloadError: "download-error";
-};
-type FileStatusType = ValueOf<typeof FILE_STATUSs>;
-type Attachment = {
-    url: string;
-    keyPath: string;
-    filename: string;
-    fileType: string;
-    hostname: string;
+/** Per-file upload lifecycle for progress UI driven from outside. */
+type FileUploadStatus = 'idle' | 'uploading' | 'success' | 'error';
+/**
+ * Controlled item shape — UseForm-friendly.
+ *
+ * Store `FileUploadItem[]` in form state; submit with `.map((i) => i.file)`.
+ * Drive progress from the parent by updating `progress` / `status` / `error`
+ * on the same items (keep stable `id`s).
+ */
+type FileUploadItem = {
+    id: string;
+    file: File;
+    /** 0–100. Shown when status is uploading or when explicitly set. */
+    progress?: number;
+    error?: string;
+    status?: FileUploadStatus;
 };
 
-interface PreviewableFileProps {
-    path?: string;
-    blobUrl?: string;
-    filename?: string;
-    randomName?: string;
-    fileType?: string;
-    mimeType?: Blob["type"];
-    size?: number;
-    displaySize?: string;
-    url?: string;
-    fetchOptions?: object;
-    putUrl?: string;
-    getUrl?: string;
-    status?: FileStatusType;
-    revokeable?: boolean;
-    imageProps?: {
-        width: number;
-        height: number;
-    };
-}
-declare class PreviewableFile {
-    path: NonNullable<PreviewableFileProps["path"]>;
-    blobUrl: NonNullable<PreviewableFileProps["blobUrl"]>;
-    filename: NonNullable<PreviewableFileProps["filename"]>;
-    randomName: NonNullable<PreviewableFileProps["randomName"]>;
-    fileType: NonNullable<PreviewableFileProps["fileType"]>;
-    mimeType: NonNullable<PreviewableFileProps["mimeType"]>;
-    size: NonNullable<PreviewableFileProps["size"]>;
-    displaySize: NonNullable<PreviewableFileProps["displaySize"]>;
-    url: NonNullable<PreviewableFileProps["url"]>;
-    fetchOptions: NonNullable<PreviewableFileProps["fetchOptions"]>;
-    putUrl: NonNullable<PreviewableFileProps["putUrl"]>;
-    getUrl: NonNullable<PreviewableFileProps["getUrl"]>;
-    status: NonNullable<PreviewableFileProps["status"]>;
-    revokeable: NonNullable<PreviewableFileProps["revokeable"]>;
-    imageProps: NonNullable<PreviewableFileProps["imageProps"]>;
-    constructor(props?: PreviewableFileProps);
-    toPlainObj(): this;
-    updateFile(file: PreviewableFile | undefined): void;
-    updateStatus(status: FileStatusType): void;
-    downloadFile(): Promise<this>;
-    _displayFileSize(): string;
-    getUploadFormat(): Attachment;
-}
-
-type ProgressHook = (file: PreviewableFile, isPaused: boolean) => number;
+/**
+ * Consumer-provided progress hook — called per file while the modal is open.
+ * Return 0–100. `isPaused` is true when the user paused the queue.
+ */
+type ProgressHook = (file: FileUploadItem, isPaused: boolean) => number;
 interface ProcessModalProps {
     openProps: [boolean, React.Dispatch<React.SetStateAction<boolean>>];
-    files: PreviewableFile[];
+    /** Upload queue — elemental FileUploadItem[] (id + file + optional progress/status). */
+    files: FileUploadItem[];
     useProgress?: ProgressHook;
     title?: string;
     description?: string;
@@ -84,6 +36,8 @@ interface ProcessModalProps {
     minimizable?: boolean;
     minimizePlacement?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
     autoClose?: boolean;
+    /** File list layout inside the modal. Default row. */
+    itemVariant?: 'row' | 'tile';
 }
 
 declare const ProcessModal: React.FC<ProcessModalProps>;
@@ -116,10 +70,14 @@ declare const ProcessAlertObserver: ({ observer, onMaximize }: {
     onMaximize: () => void;
 }) => react_jsx_runtime.JSX.Element;
 
-interface ProcessItemProps {
-    file: PreviewableFile;
+type ProcessItemProps = {
+    file: FileUploadItem;
     progress: number;
-}
+};
+/**
+ * Single-file progress row — soft FileUpload readOnly queue item.
+ * Prefer ProcessModal's batched FileUpload list for multi-file UIs.
+ */
 declare const ProcessItem: React.FC<ProcessItemProps>;
 
-export { ProcessAlertContent, ProcessAlertObserver, ProcessItem, ProcessModal, type ProcessModalProps, type ProgressHook };
+export { ProcessAlertContent, ProcessAlertObserver, ProcessItem, type ProcessItemProps, ProcessModal, type ProcessModalProps, type ProgressHook };

package/dist/process.d.ts

@@ -1,81 +1,33 @@
 import React from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
-type ValueOf<T> = T[keyof T];
-
-declare const FILE_STATUSs: {
-    readonly uploadingToLocal: "local-uploading";
-    readonly uploadedToLocal: "local-uploaded";
-    readonly localError: "local-error";
-    readonly pending: "pending";
-    readonly uploadPending: "upload-pending";
-    readonly gettingSignedURL: "upload-gettingSignedURL";
-    readonly beginUploadToS3: "upload-beginUploadToS3";
-    readonly uploadedToCloud: "upload-uploadedToCloud";
-    readonly error: "upload-error";
-    readonly downloadPending: "download-pending";
-    readonly downloading: "download-in-progress";
-    readonly downloaded: "download-completed";
-    readonly downloadError: "download-error";
-};
-type FileStatusType = ValueOf<typeof FILE_STATUSs>;
-type Attachment = {
-    url: string;
-    keyPath: string;
-    filename: string;
-    fileType: string;
-    hostname: string;
+/** Per-file upload lifecycle for progress UI driven from outside. */
+type FileUploadStatus = 'idle' | 'uploading' | 'success' | 'error';
+/**
+ * Controlled item shape — UseForm-friendly.
+ *
+ * Store `FileUploadItem[]` in form state; submit with `.map((i) => i.file)`.
+ * Drive progress from the parent by updating `progress` / `status` / `error`
+ * on the same items (keep stable `id`s).
+ */
+type FileUploadItem = {
+    id: string;
+    file: File;
+    /** 0–100. Shown when status is uploading or when explicitly set. */
+    progress?: number;
+    error?: string;
+    status?: FileUploadStatus;
 };
 
-interface PreviewableFileProps {
-    path?: string;
-    blobUrl?: string;
-    filename?: string;
-    randomName?: string;
-    fileType?: string;
-    mimeType?: Blob["type"];
-    size?: number;
-    displaySize?: string;
-    url?: string;
-    fetchOptions?: object;
-    putUrl?: string;
-    getUrl?: string;
-    status?: FileStatusType;
-    revokeable?: boolean;
-    imageProps?: {
-        width: number;
-        height: number;
-    };
-}
-declare class PreviewableFile {
-    path: NonNullable<PreviewableFileProps["path"]>;
-    blobUrl: NonNullable<PreviewableFileProps["blobUrl"]>;
-    filename: NonNullable<PreviewableFileProps["filename"]>;
-    randomName: NonNullable<PreviewableFileProps["randomName"]>;
-    fileType: NonNullable<PreviewableFileProps["fileType"]>;
-    mimeType: NonNullable<PreviewableFileProps["mimeType"]>;
-    size: NonNullable<PreviewableFileProps["size"]>;
-    displaySize: NonNullable<PreviewableFileProps["displaySize"]>;
-    url: NonNullable<PreviewableFileProps["url"]>;
-    fetchOptions: NonNullable<PreviewableFileProps["fetchOptions"]>;
-    putUrl: NonNullable<PreviewableFileProps["putUrl"]>;
-    getUrl: NonNullable<PreviewableFileProps["getUrl"]>;
-    status: NonNullable<PreviewableFileProps["status"]>;
-    revokeable: NonNullable<PreviewableFileProps["revokeable"]>;
-    imageProps: NonNullable<PreviewableFileProps["imageProps"]>;
-    constructor(props?: PreviewableFileProps);
-    toPlainObj(): this;
-    updateFile(file: PreviewableFile | undefined): void;
-    updateStatus(status: FileStatusType): void;
-    downloadFile(): Promise<this>;
-    _displayFileSize(): string;
-    getUploadFormat(): Attachment;
-}
-
-type ProgressHook = (file: PreviewableFile, isPaused: boolean) => number;
+/**
+ * Consumer-provided progress hook — called per file while the modal is open.
+ * Return 0–100. `isPaused` is true when the user paused the queue.
+ */
+type ProgressHook = (file: FileUploadItem, isPaused: boolean) => number;
 interface ProcessModalProps {
     openProps: [boolean, React.Dispatch<React.SetStateAction<boolean>>];
-    files: PreviewableFile[];
+    /** Upload queue — elemental FileUploadItem[] (id + file + optional progress/status). */
+    files: FileUploadItem[];
     useProgress?: ProgressHook;
     title?: string;
     description?: string;
@@ -84,6 +36,8 @@ interface ProcessModalProps {
     minimizable?: boolean;
     minimizePlacement?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
     autoClose?: boolean;
+    /** File list layout inside the modal. Default row. */
+    itemVariant?: 'row' | 'tile';
 }
 
 declare const ProcessModal: React.FC<ProcessModalProps>;
@@ -116,10 +70,14 @@ declare const ProcessAlertObserver: ({ observer, onMaximize }: {
     onMaximize: () => void;
 }) => react_jsx_runtime.JSX.Element;
 
-interface ProcessItemProps {
-    file: PreviewableFile;
+type ProcessItemProps = {
+    file: FileUploadItem;
     progress: number;
-}
+};
+/**
+ * Single-file progress row — soft FileUpload readOnly queue item.
+ * Prefer ProcessModal's batched FileUpload list for multi-file UIs.
+ */
 declare const ProcessItem: React.FC<ProcessItemProps>;
 
-export { ProcessAlertContent, ProcessAlertObserver, ProcessItem, ProcessModal, type ProcessModalProps, type ProgressHook };
+export { ProcessAlertContent, ProcessAlertObserver, ProcessItem, type ProcessItemProps, ProcessModal, type ProcessModalProps, type ProgressHook };