@reykjavik/webtools 0.3.12 → 0.3.13

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 - ... <!-- Add new lines here. -->
 
+## 0.3.13
+
+_2026-03-17_
+
+- `@reykjavik/webtools/alertsStore`:
+  - feat: Add "message-only" shorthand signature to alerter dispatcher methods
+
 ## 0.3.12
 
 _2026-03-17_

package/README.md

@@ -1034,17 +1034,44 @@ alerter.success({
   message: 'All is good',
   // flags: ['pristine'],
   duration: 'MEDIUM',
-  delay: 500, // Optional delay
+  delay: 500, // Optional delay in milliseconds
 });
-// after 500ms the above alert is added to the store, and all subscribers
-// are notified. The subscriber in `appRoot.ts` will log the following;
+alerter.info('Simple message!'); // Shorthand syntax
+
+// On the next event loop tick the "info" alert (with no delay) is emitted, and all
+// subscribers are notified. The subscriber in `appRoot.ts` will log the following;
 /*
   Current alerts: [
     {
-      id: '_234566-27_', // autugenerated
+      id: '_234566-28_', // auto-generated
+      level: 'info',
+      message: 'Simple message!',
+      duration: 5000, // ms
+      dismiss: <Function>,
+      setFalgs: <Function>,
+    }
+  ]
+  Change type: 'add'
+  Affected alert IDs: ['_234566-28_']
+*/
+
+// Then after 500ms the "success" alert is added to the store, and all subscribers
+// are notified again. The subscriber in `appRoot.ts` will log the following;
+/*
+  Current alerts: [
+    {
+      id: '_234566-28_',
+      level: 'info',
+      message: 'Simple message!',
+      duration: 5000, // ms
+      dismiss: <Function>,
+      setFalgs: <Function>,
+    },
+    {
+      id: '_234566-27_',
       level: 'success',
       message: 'All is good',
-      duration: 5000, // ms
+      duration: 5000,
       dismiss: <Function>,
       setFalgs: <Function>,
     }

package/alertsStore/index.d.ts

@@ -121,7 +121,7 @@ export declare const createAlerterStore: <Level extends string = (typeof default
      *
      * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
      */
-    alerter: Record<Level, (payload: {
+    alerter: Record<Level, (payload: AlertMessage | ({
         /**
          * A simple string containing the alert message.
          *
@@ -163,7 +163,7 @@ export declare const createAlerterStore: <Level extends string = (typeof default
          * May also be used for more basic styling or categorization purposes.
          */
         type?: Type;
-    })) => void>;
+    }))) => void>;
     /**
      * Subscribes to alert events. The provided callback will be called whenever a
      * alert is added or cleared.

package/alertsStore/index.js

@@ -225,7 +225,10 @@ const createAlerterStore = (cfg = {}) => {
         }, showAt - Date.now());
     };
     const _addAlert = (payload, level) => {
-        const notification = buildNotification(payload, level);
+        const _payload = typeof payload === 'string' || Array.isArray(payload)
+            ? { message: payload }
+            : payload;
+        const notification = buildNotification(_payload, level);
         if (!notification.showAt) {
             // Notification starts active. Clone the array.
             alerts.active = [...alerts.active, addMethodsToAlertInfo(notification)];

package/esm/alertsStore/index.d.ts

@@ -121,7 +121,7 @@ export declare const createAlerterStore: <Level extends string = (typeof default
      *
      * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#createalerterstore
      */
-    alerter: Record<Level, (payload: {
+    alerter: Record<Level, (payload: AlertMessage | ({
         /**
          * A simple string containing the alert message.
          *
@@ -163,7 +163,7 @@ export declare const createAlerterStore: <Level extends string = (typeof default
          * May also be used for more basic styling or categorization purposes.
          */
         type?: Type;
-    })) => void>;
+    }))) => void>;
     /**
      * Subscribes to alert events. The provided callback will be called whenever a
      * alert is added or cleared.

package/esm/alertsStore/index.js

@@ -189,7 +189,10 @@ export const createAlerterStore = (cfg = {}) => {
         }, showAt - Date.now());
     };
     const _addAlert = (payload, level) => {
-        const notification = buildNotification(payload, level);
+        const _payload = typeof payload === 'string' || Array.isArray(payload)
+            ? { message: payload }
+            : payload;
+        const notification = buildNotification(_payload, level);
         if (!notification.showAt) {
             // Notification starts active. Clone the array.
             alerts.active = [...alerts.active, addMethodsToAlertInfo(notification)];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@reykjavik/webtools",
-	"version": "0.3.12",
+	"version": "0.3.13",
 	"description": "Misc. JS/TS helpers used by Reykjavík City's web dev teams.",
 	"main": "index.js",
 	"repository": "ssh://git@github.com:reykjavikcity/webtools.git",