mtrl 0.7.0 → 0.7.1

package/dist/components/snackbar/api.d.ts

@@ -4,4 +4,4 @@ import { BaseComponent, SnackbarComponent, ApiOptions } from "./types";
  * @param {ApiOptions} options - API configuration
  * @returns {Function} Higher-order function that adds API methods to component
  */
-export declare const withAPI: ({ lifecycle, queue }: ApiOptions) => (component: BaseComponent) => SnackbarComponent;
+export declare const withAPI: ({ lifecycle, queue, queueBehavior }: ApiOptions) => (component: BaseComponent) => SnackbarComponent;

package/dist/components/snackbar/config.d.ts

@@ -48,6 +48,7 @@ export declare const getTextConfig: (config: SnackbarConfig) => {
     message: string;
     action?: string;
     duration?: number;
+    queueBehavior?: import("./types").SnackbarQueueBehavior;
     onAction?: (event: import("./types").SnackbarEvent) => void;
     onOpen?: (event: import("./types").SnackbarEvent) => void;
     onClose?: (event: import("./types").SnackbarEvent) => void;
@@ -62,5 +63,5 @@ export declare const getTextConfig: (config: SnackbarConfig) => {
  * @param {SnackbarQueue} queue - Snackbar queue manager
  * @returns {ApiOptions} API configuration object
  */
-export declare const getApiConfig: (comp: BaseComponent, queue: any) => ApiOptions;
+export declare const getApiConfig: (comp: BaseComponent, queue: any, config?: SnackbarConfig) => ApiOptions;
 export default defaultConfig;

package/dist/components/snackbar/constants.d.ts

@@ -30,6 +30,20 @@ export declare const SNACKBAR_STATES: {
     /** Snackbar is hidden */
     readonly HIDDEN: "hidden";
 };
+/**
+ * Snackbar queue behaviors
+ *
+ * Controls how a newly shown snackbar interacts with the one currently on
+ * screen and any still waiting in the queue.
+ * @category Components
+ */
+export declare const SNACKBAR_QUEUE_BEHAVIORS: {
+    /** Wait in line — shown one at a time, in order (default) */
+    readonly QUEUE: "queue";
+    /** Replace — immediately dismiss the current snackbar, drop any pending
+     *  ones, and show this snackbar right away (last-wins) */
+    readonly REPLACE: "replace";
+};
 /**
  * Snackbar event types
  * @category Components
@@ -55,6 +69,10 @@ export declare const SNACKBAR_DEFAULTS: {
     readonly POSITION: "center";
     /** Default display duration in milliseconds (4 seconds) */
     readonly DURATION: 4000;
+    /** Default queue behavior */
+    readonly QUEUE_BEHAVIOR: "queue";
+    /** Delay in milliseconds between a dismissed snackbar and the next one */
+    readonly QUEUE_GAP: 200;
     /** Default z-index for snackbars */
     readonly Z_INDEX: 1000;
     /** Default animation duration in milliseconds */

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

@@ -1,2 +1,3 @@
 export { default } from "./snackbar";
-export { SnackbarConfig, SnackbarComponent } from "./types";
+export { SnackbarConfig, SnackbarComponent, SnackbarQueueBehavior, } from "./types";
+export { SNACKBAR_QUEUE_BEHAVIORS } from "./constants";

package/dist/components/snackbar/queue.d.ts

@@ -1,7 +1,15 @@
 import { SnackbarQueue } from './types';
 /**
  * Creates a queue manager for snackbars
- * Ensures only one snackbar is visible at a time
+ *
+ * Ensures only one snackbar is visible at a time. Supports two behaviors when
+ * a new snackbar is added (see {@link SnackbarQueueAddOptions}):
+ * - `'queue'` (default): the snackbar waits its turn and is shown in order.
+ * - `'replace'`: the snackbar evicts whatever is currently on screen, drops any
+ *   still-pending snackbars, and shows immediately. This keeps rapid, repeated
+ *   actions snappy instead of serializing a long backlog.
+ *
+ * @param {number} gap - Delay in ms between a dismissed snackbar and the next
  * @returns {SnackbarQueue} Queue manager with add/clear methods
  */
-export declare const createSnackbarQueue: () => SnackbarQueue;
+export declare const createSnackbarQueue: (gap?: number) => SnackbarQueue;

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

@@ -21,6 +21,19 @@ export declare const SNACKBAR_POSITIONS: {
     readonly START: "start";
     readonly END: "end";
 };
+/**
+ * Available snackbar queue behaviors
+ */
+export type SnackbarQueueBehavior = 'queue' | 'replace';
+/**
+ * Snackbar queue behaviors
+ */
+export declare const SNACKBAR_QUEUE_BEHAVIORS: {
+    /** Shown one at a time, in order (default) */
+    readonly QUEUE: "queue";
+    /** Replace the current snackbar and drop pending ones (last-wins) */
+    readonly REPLACE: "replace";
+};
 /**
  * Snackbar visibility states
  */
@@ -65,6 +78,14 @@ export interface SnackbarConfig {
     action?: string;
     /** Duration in milliseconds to show the snackbar (0 for indefinite) */
     duration?: number;
+    /**
+     * How this snackbar interacts with the queue when shown.
+     * - `'queue'` (default): wait in line and show one at a time, in order.
+     * - `'replace'`: immediately dismiss the current snackbar, drop any pending
+     *   ones, and show this snackbar right away. Useful for rapid, repeated
+     *   actions where only the latest message matters.
+     */
+    queueBehavior?: SnackbarQueueBehavior;
     /** Action button callback function */
     onAction?: (event: SnackbarEvent) => void;
     /** Callback function when the snackbar opens */
@@ -144,20 +165,33 @@ export interface BaseComponent {
 export interface SnackbarTimer {
     start: () => void;
     stop: () => void;
+    /** Sets the auto-dismiss duration in milliseconds */
+    setDuration: (duration: number) => void;
+    /** Gets the current auto-dismiss duration in milliseconds */
+    getDuration: () => number;
 }
 /**
  * Interface for snackbars managed by the queue
  */
 export interface QueuedSnackbar {
     _show: () => void;
+    /** Visually dismisses the snackbar without advancing the queue */
+    _hide?: () => void;
     on: (event: string, handler: () => void) => void;
     off: (event: string, handler: () => void) => void;
 }
+/**
+ * Options controlling how a snackbar is added to the queue
+ */
+export interface SnackbarQueueAddOptions {
+    /** Behavior to apply when adding this snackbar (defaults to `'queue'`) */
+    behavior?: SnackbarQueueBehavior;
+}
 /**
  * Interface for the snackbar queue manager
  */
 export interface SnackbarQueue {
-    add: (snackbar: QueuedSnackbar) => void;
+    add: (snackbar: QueuedSnackbar, options?: SnackbarQueueAddOptions) => void;
     clear: () => void;
     getLength: () => number;
 }
@@ -169,4 +203,6 @@ export interface ApiOptions {
         destroy: () => void;
     };
     queue: SnackbarQueue;
+    /** Queue behavior applied when the snackbar is shown */
+    queueBehavior?: SnackbarQueueBehavior;
 }