@appius-fr/apx 2.4.0 → 2.5.0

package/APX.mjs

@@ -1,6 +1,7 @@
 import augmentWithListen from './modules/listen/listen.mjs';
 import augmentWithTristate from './modules/tristate/tristate.mjs';
 import dialog from './modules/dialog/dialog.mjs';
+import toast from './modules/toast/toast.mjs';
 import { loadCss } from './modules/common.mjs';
 
 /**
@@ -107,6 +108,7 @@ const APX = function (input, context = document) {
 
 APX.loadCss = loadCss;
 APX.dialog = dialog;
+APX.toast = toast;
 APX.isAPXObject = function (obj) {
     return obj && obj._isAPXObject === true;
 }

package/README.md

@@ -53,6 +53,41 @@ const myDialog = APX.dialog({
 myDialog.open();
 ```
 
+### `toast` (since 2.5.0)
+
+Minimal, framework‑agnostic toast notifications with auto‑loaded CSS and a small API. Exposed as `APX.toast`.
+
+Quick start:
+
+```javascript
+// One‑liners on the default manager
+APX.toast.success('Saved!');
+APX.toast.warning('Heads up', { durationMs: 4000 });
+
+// Callable shorthand (equivalent to show)
+APX.toast({ message: 'Processing…', type: 'info', durationMs: 0 });
+
+// Configure defaults
+APX.toast.configure({ position: 'top-right', maxToasts: 4, dedupe: true });
+
+// Dedupe requires a stable id
+APX.toast.show({ id: 'status', message: 'Working…', type: 'info', durationMs: 0 });
+APX.toast.show({ id: 'status', message: 'Done', type: 'success', durationMs: 1500 });
+
+// Named managers (profiles)
+APX.toast.create('admin', { position: 'bottom-left' });
+APX.toast.use('admin').info('Admin ready');
+```
+
+Notes:
+- CSS is auto‑imported by the toast module; no `<link>` needed.
+- Overflow policy enforces a strict cap: if `maxToasts` is exceeded, the oldest is removed immediately.
+- Named managers are accessible via `APX.toast.use('<name>')`.
+
+Demo pages (work from file:// via standalone build):
+- `demo/index.html` (landing)
+- `demo/modules/toast/index.html` (basic and advanced examples with code viewer)
+
 ### Utilities
 
 - **`loadCss`**: Dynamically load CSS files into your document.