minisnackbar 2.0.0 → 3.0.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 MiniSnackbar
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 MiniSnackbar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,13 +2,9 @@
 
 ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat-square&logo=typescript&logoColor=white) ![License](https://img.shields.io/badge/license-MIT-blue.svg)
 
-A simple, lightweight vanilla JavaScript snackbar/toast library with no dependencies. Works standalone or seamlessly blends with [Material Web](https://material-web.dev/) components, adapting to your site's theme when available. Since Material Web doesn't provide a snackbar component, this library fills that gap.
+A simple, lightweight snackbar/toast library with no dependencies. Works standalone or seamlessly blends with [Material Web](https://material-web.dev/) components, adapting to your site's theme when available. Since Material Web doesn't provide a snackbar component, this library fills that gap.
 
-**Author:** Shanto Islam ([shantoislamdev.web.app](https://shantoislamdev.web.app))
-**License:** MIT  
-**Repository:** [github.com/shantoislamdev/minisnackbar](https://github.com/shantoislamdev/minisnackbar)
-
-## Installation
+## Install
 
 ```bash
 npm install minisnackbar
@@ -17,29 +13,47 @@ npm install minisnackbar
 ## Usage
 
 ```javascript
-// ES Module
 import { Snackbar } from 'minisnackbar'
 
-// CommonJS
-const { Snackbar } = require('minisnackbar')
-
-// Initialize
 Snackbar.init()
+Snackbar.add('Saved successfully')
 
-// Show a message
-Snackbar.add('Hello, world!')
+Snackbar.add('Item deleted', {
+  text: 'UNDO',
+  handler: () => restoreItem()
+})
 ```
 
-## Browser Support
+## CDN
+
+```html
+<script src="https://unpkg.com/minisnackbar@3.0.0/dist/minisnackbar.min.js"></script>
+<script>
+  Snackbar.init()
+  Snackbar.add('Hello from MiniSnackbar')
+</script>
+```
+
+## API
+
+- `Snackbar.init(options?)`
+- `Snackbar.add(message, action?, duration?)`
+- `Snackbar.show(message, action?, duration?)`
+- `Snackbar.clearQueue()`
+- `Snackbar.hideCurrent()`
+- `Snackbar.destroy()`
+- `Snackbar.isInitialized()`
+
+## Builds
 
-- Chrome 60+
-- Firefox 55+
-- Safari 12+
-- Edge 79+
+- ESM: `dist/minisnackbar.esm.js`
+- CommonJS: `dist/minisnackbar.cjs`
+- Browser global: `dist/minisnackbar.min.js`
+- Types: `dist/index.d.ts`
 
 ## Documentation
 
-For full documentation, API reference, and advanced usage, see [docs.md](docs.md).
+See [docs.md](docs.md) for configuration, styling, and advanced usage.
 
 ## License
 

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const SNACKBAR_ID = "mini-snackbar";
+export declare const STYLES_ID = "mini-snackbar-styles";
+export declare const SNACKBAR_CLASS = "mini-snackbar";
+export declare const SNACKBAR_VISIBLE_CLASS = "show";
+export declare const SNACKBAR_TEXT_CLASS = "mini-snackbar-text";
+export declare const SNACKBAR_ACTION_CLASS = "mini-snackbar-action";
+export declare const DEFAULT_DURATION = 3000;
+export declare const DEFAULT_TRANSITION_DURATION = 250;
+export declare const QUEUE_GAP_DURATION = 200;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,kBAAkB,CAAA;AAC1C,eAAO,MAAM,SAAS,yBAAyB,CAAA;AAE/C,eAAO,MAAM,cAAc,kBAAkB,CAAA;AAC7C,eAAO,MAAM,sBAAsB,SAAS,CAAA;AAC5C,eAAO,MAAM,mBAAmB,uBAAuB,CAAA;AACvD,eAAO,MAAM,qBAAqB,yBAAyB,CAAA;AAE3D,eAAO,MAAM,gBAAgB,OAAO,CAAA;AACpC,eAAO,MAAM,2BAA2B,MAAM,CAAA;AAC9C,eAAO,MAAM,kBAAkB,MAAM,CAAA"}

package/dist/controller.d.ts

@@ -0,0 +1,27 @@
+import type { SnackbarItem, SnackbarOptions } from './types';
+export declare class SnackbarController {
+    private queue;
+    private state;
+    private renderer;
+    private displayTimer;
+    private transitionTimer;
+    private queueGapTimer;
+    private transitionDuration;
+    private initialized;
+    init(options?: SnackbarOptions): void;
+    destroy(): void;
+    add(message: string, action?: SnackbarItem['action'], duration?: number): void;
+    show(message: string, action?: SnackbarItem['action'], duration?: number): void;
+    clearQueue(): void;
+    hideCurrent(): void;
+    isInitialized(): boolean;
+    getTransitionDuration(): number;
+    private showNext;
+    private showItem;
+    private hideActiveItem;
+    private finishCurrentItem;
+    private ensureInitialized;
+    private clearTimers;
+    private clearTimer;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAiB,MAAM,SAAS,CAAA;AAG3E,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,WAAW,CAAQ;IAE3B,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,IAAI;IAqBzC,OAAO,IAAI,IAAI;IAUf,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,YAAY,CAAC,QAAQ,CAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAUpF,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,YAAY,CAAC,QAAQ,CAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAuBrF,UAAU,IAAI,IAAI;IAKlB,WAAW,IAAI,IAAI;IAMnB,aAAa,IAAI,OAAO;IAIxB,qBAAqB,IAAI,MAAM;IAI/B,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;CAKnB"}

package/dist/index.d.ts

@@ -1,54 +1,24 @@
 /**
  * MiniSnackbar - A simple vanilla JavaScript snackbar/toast library
  *
- * @version 2.0.0
+ * @version 3.0.0
  * @author Shanto Islam <shantoislamdev@gmail.com>
  * @license MIT
  * @description A lightweight, zero-dependency snackbar library with Material Design integration
  * @repository https://github.com/shantoislamdev/minisnackbar
  * @homepage https://github.com/shantoislamdev/minisnackbar#readme
  */
-export interface SnackbarAction {
-    text: string;
-    handler: () => void;
-}
-export interface SnackbarOptions {
-    transitionDuration?: number;
-}
-export interface SnackbarItem {
-    message: string;
-    action: SnackbarAction | null;
-    duration: number;
-}
-type SnackbarState = 'idle' | 'showing' | 'transitioning';
+import type { SnackbarAction, SnackbarOptions } from './types';
+export type { SnackbarAction, SnackbarOptions };
 declare class Snackbar {
-    private static _queue;
-    private static _isShowing;
-    private static _currentTimeout;
-    private static _state;
-    private static _currentActionHandler;
-    private static _transitionDuration;
-    private static _initialized;
     static init(options?: SnackbarOptions): void;
     static destroy(): void;
     static getTransitionDuration(): number;
     static add(message: string, action?: SnackbarAction | null, duration?: number): void;
-    private static _cleanupAction;
-    private static _showSnackbar;
-    private static _hideSnackbar;
     static show(message: string, action?: SnackbarAction | null, duration?: number): void;
-    static showNext(): void;
     static clearQueue(): void;
     static hideCurrent(): void;
     static isInitialized(): boolean;
-    static get queue(): SnackbarItem[];
-    static set queue(value: SnackbarItem[]);
-    static get isShowing(): boolean;
-    static set isShowing(value: boolean);
-    static get currentTimeout(): ReturnType<typeof setTimeout> | null;
-    static set currentTimeout(value: ReturnType<typeof setTimeout> | null);
-    static get state(): SnackbarState;
-    static set state(value: SnackbarState);
 }
 export default Snackbar;
 export { Snackbar };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,KAAK,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,CAAA;AAGzD,cAAM,QAAQ;IACZ,OAAO,CAAC,MAAM,CAAC,MAAM,CAAqB;IAC1C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAiB;IAC1C,OAAO,CAAC,MAAM,CAAC,eAAe,CAA6C;IAC3E,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwB;IAC7C,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAA4B;IAChE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAc;IAChD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAiB;IAE5C,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,IAAI;IAqIhD,MAAM,CAAC,OAAO,IAAI,IAAI;IAiBtB,MAAM,CAAC,qBAAqB,IAAI,MAAM;IAkBtC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,cAAc,GAAG,IAAW,EAAE,QAAQ,GAAE,MAAa,GAAG,IAAI;IA8BhG,OAAO,CAAC,MAAM,CAAC,cAAc;IAY7B,OAAO,CAAC,MAAM,CAAC,aAAa;IA8C5B,OAAO,CAAC,MAAM,CAAC,aAAa;IAuB5B,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,cAAc,GAAG,IAAW,EACpC,QAAQ,GAAE,MAAa,GACtB,IAAI;IAwDP,MAAM,CAAC,QAAQ,IAAI,IAAI;IAgBvB,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB,MAAM,CAAC,WAAW,IAAI,IAAI;IAM1B,MAAM,CAAC,aAAa,IAAI,OAAO;IAK/B,MAAM,KAAK,KAAK,IAAI,YAAY,EAAE,CAEjC;IACD,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,EAErC;IACD,MAAM,KAAK,SAAS,IAAI,OAAO,CAE9B;IACD,MAAM,KAAK,SAAS,CAAC,KAAK,EAAE,OAAO,EAElC;IACD,MAAM,KAAK,cAAc,IAAI,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAEhE;IACD,MAAM,KAAK,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,EAEpE;IACD,MAAM,KAAK,KAAK,IAAI,aAAa,CAEhC;IACD,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE,aAAa,EAEpC;CACF;AAOD,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9D,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,CAAA;AAI/C,cAAM,QAAQ;IACZ,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,IAAI;IAIhD,MAAM,CAAC,OAAO,IAAI,IAAI;IAItB,MAAM,CAAC,qBAAqB,IAAI,MAAM;IAItC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,cAAc,GAAG,IAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1F,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,cAAc,GAAG,IAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3F,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB,MAAM,CAAC,WAAW,IAAI,IAAI;IAI1B,MAAM,CAAC,aAAa,IAAI,OAAO;CAGhC;AAED,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,CAAA"}