juice-toast 1.3.1 → 1.3.2

package/API.md

@@ -248,6 +248,17 @@ juiceToast.custom("Hello World");
 
 ---
 
+## Background image
+```js
+juiceToast.setup({
+  bgImage: { "bgImage": "https://cdn.kyrt.my.id/image/ts-logo-128.svg" }
+});
+
+juiceToast.bgImage("Hi");
+```
+
+---
+
 ## 🧹 Utilities
 
 ```js
@@ -259,4 +270,4 @@ juiceToast.destroy(); // Remove all & cleanup
 
 ## 📄 License
 
-MIT License © 2026 OpenDN Foundation
+MIT License © 2026 OpenDN Foundation

package/CHANGELOG.md

@@ -1,46 +1,51 @@
-
-## v1.3.1
-- Improved iOS / Safari (WebKit) compatibility
-- Smoother swipe-to-dismiss on mobile
-- Better pause-on-touch behavior
-- Progress bar sync fixes
-- Accessibility & stability improvements
-
-v1.3.0
-- Add CSS Injection System (no external `style.css` needed)
-- Add Reduced Motion Support (prefers-reduced-motion)
-- Improve Animation System (enterAnimation + type animation)
-- Improve Glass UI with intensity control (0–100)
-- Improve Swipe to Dismiss
-- Improve Pause on Hover & Touch
-- Add Plugin System
-- Improve Accessibility (ARIA, keyboard focus)
-- Improve Icon Interaction & Animation
-- Add Animation Preset
-- Add Progress Bar
-- Bug fixes & internal refactor
-
-v1.2.0-rc.2026 / v1.2.1
-- Add A11Y support
-- Add Multiple Placement / Position
-- Experimental Glass UI (unstable)
-
-NEXT 120/2026
-- Improve Sound API (per-toast sound)
-- Add Exit Animation
-- Add Promise-based Toast API
-- Add Stack Grouping
-- Improve TypeScript Definitions
-
-v1.1.0
-- Add Size Preset
-- Add Compact Mode
-- Add Actions Button
-- Improve Style
-- Improve `.d.ts`
-
-v1.0.1
-- Add `style.css` file
-
-v1.0.0
-- Initial release
+## v1.3.2
+- Improved A11Y
+- Adding **Background Image**
+- Adding more Theme
+- Adding default toast (juiceToast.success|error|info|warning|loading)
+
+v1.3.1
+- Improved iOS / Safari (WebKit) compatibility
+- Smoother swipe-to-dismiss on mobile
+- Better pause-on-touch behavior
+- Progress bar sync fixes
+- Accessibility & stability improvements
+
+v1.3.0
+- Add CSS Injection System (no external `style.css` needed)
+- Add Reduced Motion Support (prefers-reduced-motion)
+- Improve Animation System (enterAnimation + type animation)
+- Improve Glass UI with intensity control (0–100)
+- Improve Swipe to Dismiss
+- Improve Pause on Hover & Touch
+- Add Plugin System
+- Improve Accessibility (ARIA, keyboard focus)
+- Improve Icon Interaction & Animation
+- Add Animation Preset
+- Add Progress Bar
+- Bug fixes & internal refactor
+
+v1.2.0-rc.2026 / v1.2.1
+- Add A11Y support
+- Add Multiple Placement / Position
+- Experimental Glass UI (unstable)
+
+NEXT 120/2026
+- Improve Sound API (per-toast sound)
+- Add Exit Animation
+- Add Promise-based Toast API
+- Add Stack Grouping
+- Improve TypeScript Definitions
+
+v1.1.0
+- Add Size Preset
+- Add Compact Mode
+- Add Actions Button
+- Improve Style
+- Improve `.d.ts`
+
+v1.0.1
+- Add `style.css` file
+
+v1.0.0
+- Initial release

package/LICENSE.md

@@ -0,0 +1,54 @@
+# MIT License
+
+**Project:** JuiceToast  
+**Copyright (c) 2026 OpenDN Foundation (Sholehuddin Khairy)**
+
+---
+
+## Permission
+
+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:
+
+---
+
+## Conditions
+
+The above copyright notice and this permission notice shall be included in all  
+copies or substantial portions of the Software.
+
+---
+
+## Disclaimer
+
+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.
+
+---
+
+## Additional Notes (Project-Specific)
+
+- You are free to use JuiceToast in **personal, educational, and commercial projects**.
+- Attribution is appreciated but not required beyond the MIT notice.
+- Contributions, improvements, and community extensions are welcome.
+
+---
+
+*Lightweight. Modern. Developer-friendly.*

package/README.md

@@ -1,5 +1,20 @@
 # 🍹 JuiceToast
 
+
+  ![npm download wekkly](https://img.shields.io/npm/dw/juice-toast)
+  ![npm download](https://img.shields.io/npm/dt/juice-toast)
+  ![npm version](https://img.shields.io/npm/v/juice-toast)
+  ![license](https://img.shields.io/npm/l/juice-toast)
+  ![stars](https://img.shields.io/github/stars/KhairyK/juiceToast)
+  ![issues](https://img.shields.io/github/issues/KhairyK/juiceToast)
+  ![repo size](https://img.shields.io/github/repo-size/KhairyK/juiceToast)
+  ![browser](https://img.shields.io/badge/browser-all%20modern-brightgreen)
+  ![deps](https://img.shields.io/badge/dependencies-0-brightgreen)
+  ![ts](https://img.shields.io/badge/types-TypeScript-blue)
+  ![last commit](https://img.shields.io/github/last-commit/KhairyK/juiceToast)
+  
+---
+
 **JuiceToast** is a lightweight, flexible, and dependency-free toast notification library for modern web applications.  
 Designed with a **clean API**, **extensive customization**, and **strong backward compatibility**, JuiceToast fits both small projects and enterprise-scale systems.
 
@@ -26,7 +41,7 @@ It supports **ESM**, **dynamic toast types**, **theme management**, **queue hand
 
 ### ESM
 ```js
-import juiceToast from "https://npdn.kyrt.my.id/npm/juice-toast@1.3.0/dist/juice-toast.esm.js";
+import juiceToast from "https://npdn.kyrt.my.id/npm/juice-toast@1.3.2dist/juice-toast.esm.js";
 ```
 
 ---
@@ -222,9 +237,6 @@ dark: {
 - Browser-only (DOM required)
 - Root element is automatically created: `#juice-toast-root`
 - Suitable for frameworks, custom runtimes, etc.
-- For JuiceToast ^v1.3.0, You don't need import `style.css` manually.
-- UMD Are deprecated for maintain reason
-- Need Improvment for Handphone user or WebKit user
 
 ---
 

package/dist/juice-toast-ios.d.ts

@@ -1,15 +1,9 @@
-/* JuiceToast v1.3.1 (iOS Enhanced)
+/* JuiceToast v1.3.2 (iOS User)
  * (C) 2026 OpenDN Foundation
  * Type Definitions
  */
 
-export type ToastType =
-  | "success"
-  | "error"
-  | "warning"
-  | "info"
-  | "loading"
-  | string
+/* ================= CORE ================= */
 
 export type ToastPosition =
   | "top-left"
@@ -18,124 +12,149 @@ export type ToastPosition =
   | "bottom-right"
   | "top-center"
   | "bottom-center"
+  | string;
 
-export type ToastSize = "sm" | "md" | "lg"
+export type ToastSize = "sm" | "md" | "lg";
 
-export type AnimationType =
+export type ToastAnimation =
   | "spin"
   | "pulse"
   | "shake"
   | "bounce"
   | "wiggle"
   | "pop"
-  | string
+  | string;
+
+/* ================= ACTIONS ================= */
 
 export interface ToastAction {
-  label: string
-  onClick?: (event: MouseEvent) => void
-  closeOnClick?: boolean
+  label: string;
+  onClick?: (ev: MouseEvent) => void;
+  closeOnClick?: boolean;
 }
 
+/* ================= OPTIONS ================= */
+
 export interface ToastOptions {
-  /* content */
-  title?: string
-  message?: string
-
-  /* icon */
-  icon?: string
-  iconPack?: string
-  iconSize?: string | number
-  iconPosition?: "left" | "right" | "top"
-  iconLink?: string
-  iconAnimate?: AnimationType
-
-  /* layout */
-  position?: ToastPosition
-  size?: ToastSize
-  width?: string
-  height?: string
-  compact?: boolean
-
-  /* behavior */
-  duration?: number
-  closable?: boolean
-  progress?: boolean
-  progressColor?: string
-  swipeThreshold?: number
-
-  /* style */
-  theme?: string
-  bg?: string
-  color?: string
-  border?: string
-  glassUI?: boolean | number
-
-  /* animation */
-  animation?: AnimationType
-  enterAnimation?: AnimationType
-
-  /* actions */
-  actions?: ToastAction[]
-
-  /* sound */
-  playSound?: string | null
-
-  /* legacy / alias (still supported internally) */
-  toast?: ToastPosition
-  closeable?: boolean
-  icon_left_top?: string
-  icon_config?: string
-  icon_onClick_url?: string
-  icon_onClick_animate?: AnimationType
+  title?: string;
+  message?: string;
+
+  theme?: string;
+  position?: ToastPosition;
+
+  duration?: number;
+  progress?: boolean;
+  progressColor?: string;
+
+  icon?: string;
+  iconPack?: string;
+  iconSize?: string;
+  iconPosition?: "left" | "right" | "top";
+
+  iconLink?: string;
+  iconAnimate?: ToastAnimation;
+
+  closable?: boolean;
+
+  bg?: string;
+  color?: string;
+  border?: string;
+
+  width?: string;
+  height?: string;
+
+  size?: ToastSize;
+  compact?: boolean;
+
+  glassUI?: number | boolean;
+
+  bgImage?: string;
+
+  enterAnimation?: ToastAnimation;
+  animation?: string;
+
+  actions?: ToastAction[];
+
+  /* AUDIO */
+  playSound?: string;
+
+  /* TTS */
+  tts?: boolean;
+  ttsLang?: string;
+  ttsRate?: number;
 }
 
-export interface JuiceToastConfig {
-  duration?: number
-  maxVisible?: number
-  swipeThreshold?: number
-  glassUI?: number | boolean
-  playSound?: string | null
-  dev?: boolean
-  injectCSS?: boolean
-  css?: string
-
-  /* custom toast type defaults */
-  [type: string]: any
+/* ================= INTERNAL DEFAULTS ================= */
+
+export interface JuiceToastDefaults {
+  duration: number;
+  maxVisible: number;
+  swipeThreshold: number;
+  glassUI: number;
+  playSound: string | null;
+  dev: boolean;
+  injectCSS: boolean;
+  css: string | null;
 }
 
-export interface ToastPluginContext {
-  toast: HTMLElement
-  cfg: ToastOptions
-  type: ToastType
-  root: HTMLElement
+/* ================= PLUGIN ================= */
+
+export interface JuiceToastPluginContext<T extends string = string> {
+  toast: HTMLElement;
+  cfg: ToastOptions;
+  type: T;
+  root: HTMLElement;
 }
 
-export type JuiceToastPlugin = (ctx: ToastPluginContext) => void
-
-export interface JuiceToast {
-  /* lifecycle */
-  setup(config?: JuiceToastConfig): void
-  clear(): void
-  destroy(): void
-
-  /* extension */
-  use(plugin: JuiceToastPlugin): void
-  addType(type: ToastType, defaults?: Partial<ToastOptions>): void
-  defineTheme(
-    name: string,
-    theme: {
-      bg?: string
-      color?: string
-      border?: string
-    }
-  ): void
-  setTheme(name: string): void
-
-  /* dynamic toast functions (success, error, custom, dll) */
-  [key: string]: any
+export type JuiceToastPlugin<T extends string = string> = (
+  ctx: JuiceToastPluginContext<T>
+) => void;
+
+/* ================= CONFIG ================= */
+
+export type ToastTypeConfig = Record<string, Partial<ToastOptions>>;
+
+/* ================= DYNAMIC METHODS ================= */
+
+type DynamicToastMethods<T extends string> = {
+  [K in T]: (payload?: string | ToastOptions) => void;
+};
+
+/* ================= CORE INSTANCE ================= */
+
+export interface JuiceToastBase<T extends string = string> {
+  _config: ToastTypeConfig;
+  _queue: any[];
+  _showing: boolean;
+  _theme: string;
+  _plugins: JuiceToastPlugin<T>[];
+  _defaults: JuiceToastDefaults;
+
+  /* ===== PUBLIC API ===== */
+
+  setup<C extends ToastTypeConfig>(
+    config: C
+  ): JuiceToastBase<keyof C & string> &
+    DynamicToastMethods<keyof C & string>;
+
+  use(plugin: JuiceToastPlugin<T>): void;
+
+  addType(name: string, cfg?: Partial<ToastOptions>): void;
+
+  defineTheme(name: string, styles: Record<string, string>): void;
+
+  setTheme(name: string): void;
+
+  clear(): void;
+  destroy(): void;
 }
 
-declare const juiceToast: JuiceToast
+/* ================= FINAL TYPE ================= */
+
+export type JuiceToast<T extends string = string> =
+  JuiceToastBase<T> & DynamicToastMethods<T>;
+
+declare const juiceToast: JuiceToast;
 
-export default juiceToast
-export { juiceToast }
+export default juiceToast;
+export { juiceToast };