@evixcard/evx-ui-kit 1.11.1 → 1.11.2

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

@@ -1,8 +1,21 @@
-import { EvToastVariant } from './types';
+import { EvToastAppearance, EvToastVariant } from './types';
 export interface EvToastProps {
     variant?: EvToastVariant;
     title?: string;
     description?: string;
+    /**
+     * Card look. `default` = compact card with a leading status icon (admin style);
+     * `plain` = larger, icon-less card with a display-size title (customer style).
+     */
+    appearance?: EvToastAppearance;
+    /**
+     * Force the leading status icon on/off. Defaults to on for `default` and off for
+     * `plain`. Set `true` on a `plain` toast to keep the white card but add a colored
+     * status icon (e.g. a red icon for errors).
+     */
+    icon?: boolean;
+    /** Show a spinner in place of the status icon (even in `plain`). */
+    loading?: boolean;
     class?: string;
 }
 declare function __VLS_template(): {
@@ -21,6 +34,8 @@ declare const __VLS_component: import('vue').DefineComponent<EvToastProps, {}, {
     onDismiss?: (() => any) | undefined;
 }>, {
     variant: EvToastVariant;
+    icon: boolean;
+    appearance: EvToastAppearance;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

package/dist/components/EvToast/EvToastContainer.vue.d.ts

@@ -1,2 +1,12 @@
-declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+import { EvToastAppearance, EvToastPlacement } from './types';
+export interface EvToastContainerProps {
+    /** Where the stack is anchored. Default `bottom-right` (admin). */
+    placement?: EvToastPlacement;
+    /** Card look applied to every toast in the stack. Default `default` (admin). */
+    appearance?: EvToastAppearance;
+}
+declare const _default: import('vue').DefineComponent<EvToastContainerProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<EvToastContainerProps> & Readonly<{}>, {
+    appearance: EvToastAppearance;
+    placement: EvToastPlacement;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/EvToast/index.d.ts

@@ -2,6 +2,7 @@ export { default } from './EvToast.vue';
 export { default as EvToast } from './EvToast.vue';
 export type { EvToastProps } from './EvToast.vue';
 export { default as EvToastContainer } from './EvToastContainer.vue';
+export type { EvToastContainerProps } from './EvToastContainer.vue';
 export { useToast } from './useToast';
 export type { UseToastReturn } from './useToast';
-export type { EvToastVariant, EvToastOptions, EvToastItem } from './types';
+export type { EvToastVariant, EvToastAppearance, EvToastPlacement, EvToastOptions, EvToastItem, } from './types';

package/dist/components/EvToast/types.d.ts

@@ -1,4 +1,11 @@
 export type EvToastVariant = 'info' | 'success' | 'warning' | 'error';
+/**
+ * Card look. `default` = compact card with a leading status icon (admin style);
+ * `plain` = larger, icon-less card with a display-size title (customer style).
+ */
+export type EvToastAppearance = 'default' | 'plain';
+/** Where the toast stack is anchored on screen. */
+export type EvToastPlacement = 'bottom-right' | 'top-center';
 export interface EvToastOptions {
     /** Optional bold title line. */
     title?: string;
@@ -8,9 +15,48 @@ export interface EvToastOptions {
     variant?: EvToastVariant;
     /** Auto-dismiss delay in ms. `0` (or negative) disables auto-dismiss. Default `4000`. */
     duration?: number;
+    /**
+     * Force the leading status icon on/off. Defaults to `true` for the `default`
+     * appearance and `false` for `plain`. Set `true` on a `plain` toast to keep the
+     * white card but add a colored status icon (e.g. a red icon for errors).
+     */
+    icon?: boolean;
+    /**
+     * Show a spinner in place of the status icon (even in `plain`) and keep the
+     * toast sticky — auto-dismiss is disabled until it is `update()`d or dismissed.
+     * Default `false`.
+     */
+    loading?: boolean;
 }
 export interface EvToastItem extends Required<Pick<EvToastOptions, 'variant' | 'duration'>> {
     id: number;
     title?: string;
     description?: string;
+    icon?: boolean;
+    loading?: boolean;
+}
+/**
+ * Content for one state of a promise-toast: a plain title string, a
+ * `{ title, description }` object, or a function of the resolved value / error
+ * returning either.
+ */
+export type EvToastContent<T = unknown> = string | {
+    title?: string;
+    description?: string;
+} | ((arg: T) => string | {
+    title?: string;
+    description?: string;
+});
+export interface EvToastPromiseOptions<T = unknown> {
+    /** Shown immediately with a spinner while the promise is pending. */
+    loading: string | {
+        title?: string;
+        description?: string;
+    };
+    /** Shown when the promise resolves. Receives the resolved value. */
+    success: EvToastContent<T>;
+    /** Shown when the promise rejects. Receives the thrown error. */
+    error: EvToastContent<unknown>;
+    /** Auto-dismiss delay (ms) for the resolved success/error toast. Default `4000`. */
+    duration?: number;
 }

package/dist/components/EvToast/useToast.d.ts

@@ -1,10 +1,12 @@
 import { DeepReadonly, Ref } from 'vue';
-import { EvToastItem, EvToastOptions } from './types';
+import { EvToastItem, EvToastOptions, EvToastPromiseOptions } from './types';
 export interface UseToastReturn {
     /** Reactive, read-only list of currently visible toasts. */
     items: DeepReadonly<Ref<EvToastItem[]>>;
     /** Push a toast; returns its id. */
     push: (toast?: EvToastOptions) => number;
+    /** Merge a patch into an existing toast (re-arms auto-dismiss if `duration` is set). */
+    update: (id: number, patch?: Partial<EvToastOptions>) => void;
     /** Dismiss a toast by id. */
     dismiss: (id: number) => void;
     /** Dismiss every toast. */
@@ -13,5 +15,9 @@ export interface UseToastReturn {
     showSuccess: (titleOrOptions?: string | EvToastOptions, description?: string, options?: EvToastOptions) => number;
     showWarning: (titleOrOptions?: string | EvToastOptions, description?: string, options?: EvToastOptions) => number;
     showError: (titleOrOptions?: string | EvToastOptions, description?: string, options?: EvToastOptions) => number;
+    /** Push a sticky loading toast (spinner, no auto-dismiss); returns its id. */
+    showLoading: (titleOrOptions?: string | EvToastOptions, description?: string, options?: EvToastOptions) => number;
+    /** Bind a promise to a loading toast that resolves in place to success/error. */
+    promise: <T>(promise: Promise<T>, options: EvToastPromiseOptions<T>) => Promise<T>;
 }
 export declare function useToast(): UseToastReturn;