handy-uploader 2.0.0 → 2.0.2

package/README.md

@@ -1,10 +1,12 @@
-# Handy Uploader Vue
+# Handy Uploader
 
-[![npm version](https://badge.fury.io/js/handy-uploader-vue.svg)](https://badge.fury.io/js/handy-uploader-vue)
+[![npm version](https://badge.fury.io/js/handy-uploader.svg)](https://badge.fury.io/js/handy-uploader)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Vue 3](https://img.shields.io/badge/Vue-3.x-4FC08D.svg)](https://vuejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 
+## 🚀 [Live Demo](https://friendly-varahamihira-45c09f.netlify.app)
+
 A comprehensive Vue 3 file uploader component library with advanced features including **automatic video thumbnail generation**, multiple upload styles, and extensive file type support.
 
 ## ✨ Key Features
@@ -37,15 +39,15 @@ A comprehensive Vue 3 file uploader component library with advanced features inc
 ## 📦 Installation
 
 ```bash
-npm install handy-uploader-vue
+npm install handy-uploader
 ```
 
 ```bash
-yarn add handy-uploader-vue
+yarn add handy-uploader
 ```
 
 ```bash
-pnpm add handy-uploader-vue
+pnpm add handy-uploader
 ```
 
 ## 🚀 Quick Start
@@ -75,8 +77,8 @@ npm install vue@^3.0.0 vuetify@^3.0.0
 </template>
 
 <script setup lang="ts">
-import { ThumbnailUploader } from 'handy-uploader-vue'
-import type { FileData } from 'handy-uploader-vue'
+import { ThumbnailUploader } from 'handy-uploader'
+import type { FileData } from 'handy-uploader'
 
 const handleFilesSelected = (files: FileData[]) => {
   console.log('Selected files:', files)
@@ -122,7 +124,7 @@ Perfect for media files with automatic video thumbnail generation:
 </template>
 
 <script setup>
-import { ThumbnailUploader } from 'handy-uploader-vue'
+import { ThumbnailUploader } from 'handy-uploader'
 
 const onFilesSelected = (files) => {
   // Video files will have thumbnails automatically generated
@@ -342,7 +344,7 @@ export default createVuetify({
 
 <script setup lang="ts">
 import { ref } from 'vue'
-import { ThumbnailUploader, type FileData } from 'handy-uploader-vue'
+import { ThumbnailUploader, type FileData } from 'handy-uploader'
 
 const selectedFiles = ref<FileData[]>([])
 const currentLanguage = ref('en')
@@ -385,16 +387,16 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## 🔗 Links
 
-- [GitHub Repository](https://github.com/yourusername/handy-uploader-vue)
-- [npm Package](https://www.npmjs.com/package/handy-uploader-vue)
-- [Documentation](https://github.com/yourusername/handy-uploader-vue#readme)
-- [Issues](https://github.com/yourusername/handy-uploader-vue/issues)
+- [GitHub Repository](https://github.com/alijahanpak/vue-file-uploader)
+- [npm Package](https://www.npmjs.com/package/handy-uploader)
+- [Documentation](https://github.com/alijahanpak/vue-file-uploader#readme)
+- [Issues](https://github.com/alijahanpak/vue-file-uploader/issues)
 
 ## 📊 Stats
 
-![npm downloads](https://img.shields.io/npm/dm/handy-uploader-vue.svg)
-![GitHub stars](https://img.shields.io/github/stars/yourusername/handy-uploader-vue.svg)
-![GitHub issues](https://img.shields.io/github/issues/yourusername/handy-uploader-vue.svg)
+![npm downloads](https://img.shields.io/npm/dm/handy-uploader.svg)
+![GitHub stars](https://img.shields.io/github/stars/alijahanpak/handy-uploader.svg)
+![GitHub issues](https://img.shields.io/github/issues/alijahanpak/handy-uploader.svg)
 
 ---
 

package/dist/components/InsertButton.vue.d.ts

@@ -0,0 +1,24 @@
+import type { DocumentAttachment, LanguageCollection } from '@/types';
+interface Props {
+    documentAttachment: DocumentAttachment[];
+    badgeCounter: boolean;
+    btnColor: string;
+    lang: string;
+    maxFileCount: number;
+    selectedLang: LanguageCollection;
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    openInputDocumentModal: (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>> & Readonly<{
+    onOpenInputDocumentModal?: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/SelectFileIconType.vue.d.ts

@@ -0,0 +1,29 @@
+interface Props {
+    fileFormat: string;
+    size: number;
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    size: number;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    size: number;
+}>>> & Readonly<{}>, {
+    size: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/SimpleUploader.vue.d.ts

@@ -0,0 +1,60 @@
+import type { DocumentAttachment, LanguageCollection } from '@/types';
+interface Props {
+    documentAttachment: DocumentAttachment[];
+    lang: string;
+    thumb: boolean;
+    cols: number;
+    editPermission: boolean;
+    cardType?: string;
+    outlined?: boolean;
+    raised?: boolean;
+    shaped?: boolean;
+    tile?: boolean;
+    deletePermission: boolean;
+    selectedLang: LanguageCollection;
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    thumb: boolean;
+    lang: string;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    openDeleteDialog: (...args: any[]) => void;
+    openEditDocumentDialog: (...args: any[]) => void;
+    setCardTheme: (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    thumb: boolean;
+    lang: string;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+}>>> & Readonly<{
+    onOpenDeleteDialog?: ((...args: any[]) => any) | undefined;
+    onOpenEditDocumentDialog?: ((...args: any[]) => any) | undefined;
+    onSetCardTheme?: ((...args: any[]) => any) | undefined;
+}>, {
+    lang: string;
+    thumb: boolean;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/TableUploader.vue.d.ts

@@ -0,0 +1,62 @@
+import type { DocumentAttachment, LanguageCollection } from '@/types';
+interface Props {
+    documentAttachment: DocumentAttachment[];
+    thumb: boolean;
+    lang: string;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+    tableThumbColumn: boolean;
+    tableFixedHeader: boolean;
+    tableHeight: number;
+    selectedLang: LanguageCollection;
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    thumb: boolean;
+    lang: string;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+    tableFixedHeader: boolean;
+    tableHeight: number;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    openDeleteDialog: (...args: any[]) => void;
+    openEditDocumentDialog: (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    thumb: boolean;
+    lang: string;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+    tableFixedHeader: boolean;
+    tableHeight: number;
+}>>> & Readonly<{
+    onOpenDeleteDialog?: ((...args: any[]) => any) | undefined;
+    onOpenEditDocumentDialog?: ((...args: any[]) => any) | undefined;
+}>, {
+    tableFixedHeader: boolean;
+    tableHeight: number;
+    lang: string;
+    thumb: boolean;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/ThumbnailUploader.vue.d.ts

@@ -0,0 +1,59 @@
+import type { DocumentAttachment, BaseUploaderProps, CardThemeProps, LanguageCode } from "@/types";
+interface Props extends BaseUploaderProps, CardThemeProps {
+    lang: LanguageCode;
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    thumb: boolean;
+    lang: string;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+    outlined: boolean;
+    raised: boolean;
+    shaped: boolean;
+    tile: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    openDeleteDialog: (index: number, deleteId: string) => void;
+    openEditDocumentDialog: (item: DocumentAttachment, index: number) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    thumb: boolean;
+    lang: string;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+    outlined: boolean;
+    raised: boolean;
+    shaped: boolean;
+    tile: boolean;
+}>>> & Readonly<{
+    onOpenDeleteDialog?: ((index: number, deleteId: string) => any) | undefined;
+    onOpenEditDocumentDialog?: ((item: DocumentAttachment, index: number) => any) | undefined;
+}>, {
+    outlined: boolean;
+    shaped: boolean;
+    raised: boolean;
+    tile: boolean;
+    lang: LanguageCode;
+    thumb: boolean;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/handyUploader.vue.d.ts

@@ -0,0 +1,146 @@
+import type { DocumentAttachment, LanguageCode, CardType, FileUploaderType, LanguageCollection } from "@/types";
+interface Props {
+    documentAttachment: DocumentAttachment[];
+    lang: LanguageCode;
+    maxFileSize?: number;
+    fileUploaderType?: FileUploaderType;
+    maxFileCount?: number;
+    badgeCounter?: boolean;
+    btnColor?: string;
+    imageCompressor?: boolean;
+    imageCompressLevel?: number;
+    fileAccept?: string;
+    thumb?: boolean;
+    tableThumbColumn?: boolean;
+    tableFixedHeader?: boolean;
+    tableHeight?: number;
+    rtlSupport?: boolean;
+    changeFileName?: boolean;
+    addFileDescription?: boolean;
+    addFileTag?: boolean;
+    tags?: string[];
+    customLang?: LanguageCollection | null;
+    insertPermission?: boolean;
+    cols?: number;
+    editPermission?: boolean;
+    deletePermission?: boolean;
+    cardType?: CardType;
+    outlined?: boolean;
+    raised?: boolean;
+    shaped?: boolean;
+    tile?: boolean;
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    maxFileSize: number;
+    fileUploaderType: string;
+    maxFileCount: number;
+    badgeCounter: boolean;
+    btnColor: string;
+    imageCompressLevel: number;
+    thumb: boolean;
+    tableFixedHeader: boolean;
+    tableHeight: number;
+    lang: string;
+    rtlSupport: boolean;
+    changeFileName: boolean;
+    addFileDescription: boolean;
+    addFileTag: boolean;
+    cols: number;
+    customLang: null;
+    insertPermission: boolean;
+    editPermission: boolean;
+    deletePermission: boolean;
+    cardType: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    updateCardType: (...args: any[]) => void;
+    updateBadgeCounter: (...args: any[]) => void;
+    updateMaxFileCount: (...args: any[]) => void;
+    updateMaxFileSize: (...args: any[]) => void;
+    updateImageCompressor: (...args: any[]) => void;
+    updateImageCompressLevel: (...args: any[]) => void;
+    updateFileAccept: (...args: any[]) => void;
+    updateThumb: (...args: any[]) => void;
+    updateChangeFileName: (...args: any[]) => void;
+    updateAddFileDescription: (...args: any[]) => void;
+    updateTableThumbColumn: (...args: any[]) => void;
+    updateTableFixedHeader: (...args: any[]) => void;
+    updateTableHeight: (...args: any[]) => void;
+    updateLang: (...args: any[]) => void;
+    updateDocumentAttachment: (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    maxFileSize: number;
+    fileUploaderType: string;
+    maxFileCount: number;
+    badgeCounter: boolean;
+    btnColor: string;
+    imageCompressLevel: number;
+    thumb: boolean;
+    tableFixedHeader: boolean;
+    tableHeight: number;
+    lang: string;
+    rtlSupport: boolean;
+    changeFileName: boolean;
+    addFileDescription: boolean;
+    addFileTag: boolean;
+    cols: number;
+    customLang: null;
+    insertPermission: boolean;
+    editPermission: boolean;
+    deletePermission: boolean;
+    cardType: string;
+}>>> & Readonly<{
+    onUpdateCardType?: ((...args: any[]) => any) | undefined;
+    onUpdateBadgeCounter?: ((...args: any[]) => any) | undefined;
+    onUpdateMaxFileCount?: ((...args: any[]) => any) | undefined;
+    onUpdateMaxFileSize?: ((...args: any[]) => any) | undefined;
+    onUpdateImageCompressor?: ((...args: any[]) => any) | undefined;
+    onUpdateImageCompressLevel?: ((...args: any[]) => any) | undefined;
+    onUpdateFileAccept?: ((...args: any[]) => any) | undefined;
+    onUpdateThumb?: ((...args: any[]) => any) | undefined;
+    onUpdateChangeFileName?: ((...args: any[]) => any) | undefined;
+    onUpdateAddFileDescription?: ((...args: any[]) => any) | undefined;
+    onUpdateTableThumbColumn?: ((...args: any[]) => any) | undefined;
+    onUpdateTableFixedHeader?: ((...args: any[]) => any) | undefined;
+    onUpdateTableHeight?: ((...args: any[]) => any) | undefined;
+    onUpdateLang?: ((...args: any[]) => any) | undefined;
+    onUpdateDocumentAttachment?: ((...args: any[]) => any) | undefined;
+}>, {
+    maxFileSize: number;
+    fileUploaderType: FileUploaderType;
+    maxFileCount: number;
+    badgeCounter: boolean;
+    btnColor: string;
+    imageCompressLevel: number;
+    tableFixedHeader: boolean;
+    tableHeight: number;
+    rtlSupport: boolean;
+    changeFileName: boolean;
+    addFileDescription: boolean;
+    addFileTag: boolean;
+    customLang: LanguageCollection | null;
+    insertPermission: boolean;
+    lang: LanguageCode;
+    thumb: boolean;
+    cols: number;
+    editPermission: boolean;
+    deletePermission: boolean;
+    cardType: CardType;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/composables/useErrorHandler.d.ts

@@ -0,0 +1,39 @@
+export interface ErrorInfo {
+    id: string;
+    message: string;
+    type: 'error' | 'warning' | 'info' | 'success';
+    timestamp: Date;
+    context?: Record<string, any>;
+    action?: {
+        label: string;
+        handler: () => void;
+    };
+}
+export interface ErrorHandlerOptions {
+    maxErrors?: number;
+    autoRemoveTimeout?: number;
+    logToConsole?: boolean;
+}
+export declare function useErrorHandler(options?: ErrorHandlerOptions): {
+    errors: unknown;
+    isLoading: unknown;
+    addError: (message: string, type?: ErrorInfo['type'], context?: Record<string, any>, action?: ErrorInfo['action']) => string;
+    removeError: (id: string) => boolean;
+    clearErrors: () => void;
+    clearErrorsByType: (type: ErrorInfo['type']) => void;
+    handleAsync: <T>(operation: () => Promise<T>, errorMessage?: string, context?: Record<string, any>) => Promise<T | null>;
+    validate: (condition: boolean, message: string, context?: Record<string, any>) => boolean;
+    showSuccess: (message: string, context?: Record<string, any>) => string;
+    showWarning: (message: string, context?: Record<string, any>) => string;
+    showInfo: (message: string, context?: Record<string, any>) => string;
+    getErrorsByType: (type: ErrorInfo['type']) => ErrorInfo[];
+    getLatestError: () => ErrorInfo | null;
+    hasErrors: (type?: ErrorInfo['type']) => boolean;
+    fileUploadErrors: {
+        fileSizeExceeded: (fileName: string, maxSize: number) => string;
+        fileCountExceeded: (maxCount: number) => string;
+        invalidFileType: (fileName: string, allowedTypes: string) => string;
+        uploadFailed: (fileName: string, reason?: string) => string;
+        compressionFailed: (fileName: string) => string;
+    };
+};

package/dist/composables/useFileUpload.d.ts

@@ -0,0 +1,33 @@
+import { type Ref } from 'vue';
+import type { DocumentAttachment, FileData, SnackbarConfig } from '../types';
+export interface UseFileUploadOptions {
+    maxFileSize?: number;
+    maxFileCount?: number;
+    imageCompressor?: boolean;
+    imageCompressLevel?: number;
+    fileAccept?: string;
+}
+export declare function useFileUpload(documentAttachment: Ref<DocumentAttachment[]>, options?: UseFileUploadOptions): {
+    isUploading: Readonly<Ref<boolean, boolean>>;
+    snackbar: Readonly<Ref<SnackbarConfig | {
+        show: boolean;
+        text: string;
+        color: string;
+    }, SnackbarConfig | {
+        show: boolean;
+        text: string;
+        color: string;
+    }>>;
+    fileCount: import("vue").ComputedRef<number>;
+    canAddMoreFiles: import("vue").ComputedRef<boolean>;
+    totalSize: import("vue").ComputedRef<number>;
+    uploadFiles: (files: FileList | File[]) => Promise<boolean>;
+    removeFile: (index: number) => boolean;
+    updateFileMetadata: (index: number, updates: Partial<Pick<FileData, 'name' | 'description' | 'tags'>>) => boolean;
+    clearAllFiles: () => void;
+    validateFile: (file: File) => {
+        valid: boolean;
+        error?: string;
+    };
+    showSnackbar: (text: string, color?: 'success' | 'error' | 'warning') => void;
+};