@uzum-tech/ui 2.3.1 → 2.3.2

package/lib/upload/src/interface.js

@@ -1,5 +1,63 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadInjectionKey = void 0;
+exports.uploadProps = exports.uploadInjectionKey = void 0;
+const _mixins_1 = require("../../_mixins");
 const _utils_1 = require("../../_utils");
+const utils_1 = require("./utils");
 exports.uploadInjectionKey = (0, _utils_1.createInjectionKey)('u-upload');
+exports.uploadProps = Object.assign(Object.assign({}, _mixins_1.useTheme.props), { name: {
+        type: String,
+        default: 'file'
+    }, accept: String, action: String, customRequest: Function, directory: Boolean, directoryDnd: { type: Boolean, default: undefined }, method: {
+        type: String,
+        default: 'POST'
+    }, multiple: Boolean, showFileList: {
+        type: Boolean,
+        default: true
+    }, data: [Object, Function], headers: [Object, Function], withCredentials: Boolean, responseType: {
+        type: String,
+        default: ''
+    }, disabled: {
+        type: Boolean,
+        default: undefined
+    }, vertical: {
+        type: Boolean,
+        default: false
+    }, icon: Object, onChange: Function, onRemove: Function, onFinish: Function, onError: Function, onRetry: Function, onBeforeUpload: Function, isErrorState: Function, onDownload: Function, defaultUpload: {
+        type: Boolean,
+        default: true
+    }, fileList: Array, 'onUpdate:fileList': [Function, Array], onUpdateFileList: [Function, Array], fileListClass: String, fileListStyle: [String, Object], defaultFileList: {
+        type: Array,
+        default: () => []
+    }, showCancelButton: {
+        type: Boolean,
+        default: true
+    }, showRemoveButton: {
+        type: Boolean,
+        default: true
+    }, showDownloadButton: Boolean, showRetryButton: {
+        type: Boolean,
+        default: true
+    }, customDownload: Function, showPreviewButton: {
+        type: Boolean,
+        default: true
+    }, listType: {
+        type: String,
+        default: 'text'
+    }, onPreview: Function, shouldUseThumbnailUrl: {
+        type: Function,
+        default: (file) => {
+            if (!utils_1.environmentSupportFile)
+                return false;
+            return (0, utils_1.isImageFile)(file);
+        }
+    }, createThumbnailUrl: Function, abstract: Boolean, max: Number, maxSize: Number, showTrigger: {
+        type: Boolean,
+        default: true
+    }, imageGroupProps: Object, inputProps: Object, triggerClass: String, triggerStyle: [String, Object], renderIcon: Function, label: String, size: {
+        type: String,
+        default: 'medium'
+    }, title: String, subtitle: String, noIcon: {
+        type: Boolean,
+        default: false
+    } });

package/lib/upload/src/public-types.d.ts

@@ -1,13 +1,28 @@
-import type { CustomRequestOptions, FileInfo, FuncOrRecordOrUndef, OnChange, OnDownload, OnFinish, OnRemove, OnRetry, SettledFileInfo, UploadInst as UploadInstInner } from './interface';
-export type { UploadProps } from './Upload';
+import type { CustomRequestOptions, FileInfo, FuncOrRecordOrUndef, IsErrorState, ListType, OnBeforeUpload, OnBeforeUploadPayload, OnChange, OnChangePayload, OnDownload, OnError, OnErrorPayload, OnFinish, OnFinishPayload, OnPreview, OnRemove, OnRemovePayload, OnRetry, OnRetryPayload, OnUpdateFileList, RenderIcon, SettledFileInfo, ShouldUseThumbnailUrl, SubmitOptions, UploadInst as UploadInstInner } from './interface';
+export type { UploadLocale, UploadProps, UploadSize } from './interface';
 export interface UploadInst extends UploadInstInner {
 }
 export type UploadFileInfo = FileInfo;
 export type UploadCustomRequestOptions = CustomRequestOptions;
 export type UploadSettledFileInfo = SettledFileInfo;
+export type UploadListType = ListType;
+export type UploadIsErrorState = IsErrorState;
+export type UploadRenderIcon = RenderIcon;
+export type UploadShouldUseThumbnailUrl = ShouldUseThumbnailUrl;
+export type UploadSubmitOptions = SubmitOptions;
 export type UploadOnChange = OnChange;
+export type UploadOnChangePayload = OnChangePayload;
 export type UploadOnFinish = OnFinish;
+export type UploadOnFinishPayload = OnFinishPayload;
+export type UploadOnError = OnError;
+export type UploadOnErrorPayload = OnErrorPayload;
 export type UploadOnRemove = OnRemove;
+export type UploadOnRemovePayload = OnRemovePayload;
 export type UploadOnDownload = OnDownload;
 export type UploadOnRetry = OnRetry;
+export type UploadOnRetryPayload = OnRetryPayload;
+export type UploadOnPreview = OnPreview;
+export type UploadOnBeforeUpload = OnBeforeUpload;
+export type UploadOnBeforeUploadPayload = OnBeforeUploadPayload;
+export type UploadOnUpdateFileList = OnUpdateFileList;
 export type { FuncOrRecordOrUndef };

package/lib/upload/src/useUploadActionsRender.d.ts

@@ -1,27 +1,2 @@
-import type { VNode } from 'vue';
-import type { ListType, RenderIcon, SettledFileInfo } from './interface';
-interface Options {
-    clsPrefix: string;
-    listType: ListType;
-    file: SettledFileInfo;
-    renderIcon?: RenderIcon;
-    showPreviewButton: string | boolean | null;
-    showRemoveButton: boolean;
-    showCancelButton: boolean;
-    showRetryButton: boolean;
-    showDownloadButton: boolean;
-    disabled: boolean;
-    buttonType: string | undefined;
-    mergedTheme: any;
-    buttonThemeOverrides: any;
-    handlePreviewClick: () => void;
-    handleRemoveOrCancelClick: (e: MouseEvent) => void;
-    handleRetryClick: () => void;
-    handleDownloadClick: (e: MouseEvent) => void;
-    capitalizeFirstLetter: (text: string) => string;
-}
-export declare function useUploadActionsRender(opts: Options): {
-    actionsNode: VNode;
-    icon: VNode;
-};
-export {};
+import type { UploadActionsRenderOptions, UploadActionsRenderReturn } from './interface';
+export declare function useUploadActionsRender(options: UploadActionsRenderOptions): UploadActionsRenderReturn;

package/lib/upload/src/useUploadActionsRender.js

@@ -5,8 +5,8 @@ const vue_1 = require("vue");
 const _internal_1 = require("../../_internal");
 const icons_1 = require("../../_internal/icons");
 const button_1 = require("../../button");
-function useUploadActionsRender(opts) {
-    const { clsPrefix, listType, file, renderIcon, showPreviewButton, showRemoveButton, showCancelButton, showRetryButton, showDownloadButton, disabled, buttonType, mergedTheme, buttonThemeOverrides, handlePreviewClick, handleRemoveOrCancelClick, handleRetryClick, handleDownloadClick, capitalizeFirstLetter } = opts;
+function useUploadActionsRender(options) {
+    const { clsPrefix, listType, file, renderIcon, showPreviewButton, showRemoveButton, showCancelButton, showRetryButton, showDownloadButton, disabled, buttonType, mergedTheme, buttonThemeOverrides, handlePreviewClick, handleRemoveOrCancelClick, handleRetryClick, handleDownloadClick, capitalizeFirstLetter } = options;
     const getExt = (name) => {
         const i = name.lastIndexOf('.');
         return i === -1 || i === name.length - 1 ? '' : name.slice(i + 1);

package/lib/upload/src/useUploadInternals.d.ts

@@ -1,25 +1,2 @@
-import type { Slots, VNode } from 'vue';
-interface UseUploadInternalsOptions {
-    mergedClsPrefix: string;
-    accept?: string;
-    multiple?: boolean;
-    inputProps?: Record<string, any>;
-    directory?: boolean;
-    onChange?: (e: Event) => void;
-    label?: string;
-    title?: string;
-    subtitle?: string;
-    vertical?: boolean;
-    noIcon?: boolean;
-    icon?: any;
-    localeRef: {
-        title: string;
-        subtitle: string;
-    };
-    slots: Slots;
-}
-export declare function useUploadInternals(options: UseUploadInternalsOptions): {
-    inputNode: VNode;
-    renderDefaultTrigger: () => VNode[];
-};
-export {};
+import type { UseUploadInternalsOptions, UseUploadInternalsReturn } from './interface';
+export declare function useUploadInternals(options: UseUploadInternalsOptions): UseUploadInternalsReturn;

package/lib/upload/src/utils.d.ts

@@ -10,6 +10,8 @@ export declare const environmentSupportFile: false | {
 export declare function isFileSystemDirectoryEntry(item: FileSystemEntry | FileSystemFileEntry | FileSystemDirectoryEntry): item is FileSystemDirectoryEntry;
 export declare function isFileSystemFileEntry(item: FileSystemEntry | FileSystemFileEntry | FileSystemDirectoryEntry): item is FileSystemFileEntry;
 export declare function getFilesFromEntries(entries: readonly FileSystemEntry[] | Array<FileSystemEntry | null>, directory: boolean): Promise<FileAndEntry[]>;
+export declare function getFilePreviewSrc(file: SettledFileInfo): string | null;
+export declare function isFileSizeExceeded(file: File | null | undefined, maxSize: number | undefined): boolean;
 export declare function createSettledFileInfo(fileInfo: FileInfo): SettledFileInfo;
 /**
  * This is a rather simple version. I may fix it later to make it more accurate.

package/lib/upload/src/utils.js

@@ -16,6 +16,8 @@ exports.createImageDataUrl = createImageDataUrl;
 exports.isFileSystemDirectoryEntry = isFileSystemDirectoryEntry;
 exports.isFileSystemFileEntry = isFileSystemFileEntry;
 exports.getFilesFromEntries = getFilesFromEntries;
+exports.getFilePreviewSrc = getFilePreviewSrc;
+exports.isFileSizeExceeded = isFileSizeExceeded;
 exports.createSettledFileInfo = createSettledFileInfo;
 exports.matchType = matchType;
 exports.download = download;
@@ -118,6 +120,14 @@ function getFilesFromEntries(entries, directory) {
         return fileAndEntries;
     });
 }
+function getFilePreviewSrc(file) {
+    return file.url || file.thumbnailUrl || null;
+}
+function isFileSizeExceeded(file, maxSize) {
+    if (maxSize === undefined || !file)
+        return false;
+    return file.size > maxSize;
+}
 function createSettledFileInfo(fileInfo) {
     const { id, name, percentage, status, url, file, thumbnailUrl, type, fullPath, batchId } = fileInfo;
     return {

package/lib/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "2.3.1";
+declare const _default: "2.3.2";
 export default _default;

package/lib/version.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = '2.3.1';
+exports.default = '2.3.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uzum-tech/ui",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "packageManager": "pnpm@10.33.0",
   "description": "A Vue 3 Component Library. Fairly Complete, Theme Customizable, Uses TypeScript, Fast",
   "author": {

package/web-types.json

@@ -2,7 +2,7 @@
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "framework": "vue",
   "name": "@uzum-tech/ui",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "js-types-syntax": "typescript",
   "contributions": {
     "html": {
@@ -2604,7 +2604,7 @@
               "name": "message-upload-props",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/chat",
               "type": "Partial<UploadProps>",
-              "description": "Props for upload display in messages.",
+              "description": "Props for upload display in messages. Attachments are rendered with `list-type=\"preview-list\"`, so the ones with a `preview`/`thumbnail` image open in the built-in image preview; it can be overridden here.",
               "default": "undefined"
             }
           ],
@@ -10395,14 +10395,14 @@
               "name": "attachments",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/message-bubble",
               "type": "MessageBubbleAttachment | MessageBubbleAttachment[]",
-              "description": "Attachments rendered through upload file list UI.",
+              "description": "Attachments rendered through upload file list UI. Attachments with a `preview` or `thumbnail` image can be opened in the built-in image preview.",
               "default": "undefined"
             },
             {
               "name": "upload-props",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/message-bubble",
               "type": "Partial<UploadProps>",
-              "description": "Props passed to internal `UUpload`.",
+              "description": "Props passed to internal `UUpload`. It's rendered with `list-type=\"preview-list\"` and a `should-use-thumbnail-url` that marks the attachments with an image as previewable, both can be overridden here.",
               "default": "undefined"
             },
             {
@@ -16619,6 +16619,28 @@
               "name": "default",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
               "description": "The content of the upload."
+            },
+            {
+              "name": "title",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "description": "Title of the default trigger. Overridden by the `title` prop."
+            },
+            {
+              "name": "subtitle",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "description": "Subtitle of the default trigger. Overridden by the `subtitle` prop."
+            },
+            {
+              "name": "upload-file-title",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "{ file: UploadSettledFileInfo }",
+              "description": "Title of a file item, the file name by default."
+            },
+            {
+              "name": "upload-file-subtitle",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "{ file: UploadSettledFileInfo }",
+              "description": "Subtitle of a file item, empty by default."
             }
           ],
           "attributes": [],
@@ -16750,6 +16772,13 @@
               "description": "The additional HTTP Headers of request.",
               "default": "undefined"
             },
+            {
+              "name": "icon",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "VNodeChild",
+              "description": "Icon of the default trigger.",
+              "default": "undefined"
+            },
             {
               "name": "input-props",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
@@ -16764,7 +16793,7 @@
               "name": "image-group-props",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
               "type": "ImageGroupProps",
-              "description": "Props of `u-image` inside upload. See [ImageGroup Props](image#ImageGroup-Props).",
+              "description": "Props of the `u-image-group` used for image preview. See [ImageGroup Props](image#ImageGroup-Props). With `list-type=\"preview-list\"` the `src-list`, `show` and `current` props of the group are managed by the component.",
               "default": "undefined",
               "description-sections": {
                 "since": "2.24.0"
@@ -16780,12 +16809,22 @@
                 "since": "2.29.1"
               }
             },
+            {
+              "name": "label",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "string",
+              "description": "Text rendered above the default trigger.",
+              "default": "undefined"
+            },
             {
               "name": "list-type",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
               "type": "string",
-              "description": "Built-in styles for file lists, `text`, `image` and `image-card`.",
-              "default": "'text'"
+              "description": "Built-in styles for file lists, `text`, `image`, `image-card` and `preview-list`. `preview-list` looks exactly like `text`, but image files are opened in the built-in image preview.",
+              "default": "'text'",
+              "description-sections": {
+                "since": "`preview-list` 2.3.2"
+              }
             },
             {
               "name": "max",
@@ -16794,6 +16833,16 @@
               "description": "Uploaded files limit.",
               "default": "undefined"
             },
+            {
+              "name": "max-size",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "number",
+              "description": "Max size of a single file in bytes. A file that exceeds it isn't uploaded — it's added to the file list with the `error` status.",
+              "default": "undefined",
+              "description-sections": {
+                "since": "2.3.2"
+              }
+            },
             {
               "name": "method",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
@@ -16815,11 +16864,18 @@
               "description": "The field name for the file(s) in the HTTP request's form data.",
               "default": "'file'"
             },
+            {
+              "name": "no-icon",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "boolean",
+              "description": "Whether to hide the icon of the default trigger.",
+              "default": "false"
+            },
             {
               "name": "render-icon",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
               "type": "(file: UploadSettledFileInfo) => VNodeChild",
-              "description": "Render function of file icon. It only works when `list-type=\"image\"` or `list-type=\"image-card\"`.",
+              "description": "Render function of file icon. Replaces the default icon of the file item for any `list-type`.",
               "default": "undefined",
               "description-sections": {
                 "since": "2.34.0"
@@ -16839,10 +16895,10 @@
               "name": "should-use-thumbnail-url",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
               "type": "(file: UploadSettledFileInfo) => boolean",
-              "description": "A function that determines whether to show thumbnail for the file. It only works when `list-type=\"image\"` or `list-type=\"image-card\"`.",
+              "description": "A function that determines whether to show thumbnail for the file. It only works when `list-type=\"image\"` or `list-type=\"image-card\"`. For `list-type=\"preview-list\"` it determines which files can be opened in the image preview.",
               "default": "A function that only returns `true` for image typed file.",
               "description-sections": {
-                "since": "2.34.0"
+                "since": "2.34.0, `preview-list` 2.3.2"
               }
             },
             {
@@ -16870,8 +16926,11 @@
               "name": "show-preview-button",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
               "type": "boolean",
-              "description": "Show a preview button (when `list-type` is `image-card`). Use the `on-preview` callback for this event.",
-              "default": "true"
+              "description": "Show a preview button (when `list-type` is `image-card` or `preview-list`). Use the `on-preview` callback to replace the built-in preview.",
+              "default": "true",
+              "description-sections": {
+                "since": "`preview-list` 2.3.2"
+              }
             },
             {
               "name": "show-remove-button",
@@ -16897,6 +16956,27 @@
                 "since": "2.21.5"
               }
             },
+            {
+              "name": "size",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "'small' | 'medium' | 'large'",
+              "description": "Size of the default trigger, it sets the dragger width from the theme (`small` — 140px, `medium` and `large` — auto). Falls back to the size of the parent form item.",
+              "default": "'medium'"
+            },
+            {
+              "name": "subtitle",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "string",
+              "description": "Subtitle of the default trigger. Falls back to the `subtitle` slot and then to the locale text.",
+              "default": "undefined"
+            },
+            {
+              "name": "title",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "string",
+              "description": "Title of the default trigger. Falls back to the `title` slot and then to the locale text.",
+              "default": "undefined"
+            },
             {
               "name": "trigger-class",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
@@ -16917,6 +16997,13 @@
                 "since": "2.29.1"
               }
             },
+            {
+              "name": "vertical",
+              "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
+              "type": "boolean",
+              "description": "Stack the icon and the text of the default trigger vertically.",
+              "default": "false"
+            },
             {
               "name": "with-credentials",
               "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
@@ -16968,22 +17055,16 @@
               {
                 "name": "preview",
                 "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
-                "type": "(file: FileInfo, detail: { event: MouseEvent }) => void",
-                "description": "Callback for clicking file links or preview buttons. You can use `preventDefault` to prevent default anchor link open behavior.",
-                "default": "undefined",
-                "description-sections": {
-                  "since": "`detail.event` 2.39.0"
-                }
+                "type": "(file: UploadFileInfo) => void",
+                "description": "Callback for clicking a file name or a preview button. When it's set, it replaces the built-in preview.",
+                "default": "undefined"
               },
               {
                 "name": "remove",
                 "doc-url": "https://uzum-ui.kapitalbank.uz/en-US/os-theme/components/upload",
-                "type": "(options: { file: UploadFileInfo, fileList: Array<UploadFileInfo>, index: number }) => Promise<boolean> | boolean | any",
+                "type": "(options: { file: UploadFileInfo, fileList: Array<UploadFileInfo> }) => Promise<boolean> | boolean | any",
                 "description": "File removed callback. Returning `false`, a promise resolved with `false`, or a rejected promise will cancel this removal.",
-                "default": "() => true",
-                "description-sections": {
-                  "since": "`index` 2.38.2"
-                }
+                "default": "() => true"
               },
               {
                 "name": "retry",