@alwatr/flux 9.24.0 → 9.26.0

package/README.md

@@ -308,7 +308,7 @@ import {createStateSignal} from '@alwatr/flux';
 
 const userSignal = createStateSignal<UserProfile | null>({
   name: 'user',
-  initialValue: userProfile.value, // hydrated from DOM, no API call needed
+  initialValue: userProfile.instance, // hydrated from DOM, no API call needed
 });
 ```
 
@@ -752,16 +752,23 @@ setupActionDelegation([...DEFAULT_DELEGATED_EVENTS, 'keydown', 'focus']);
 
 #### `onAction<K>(type, handler)`
 
-Subscribes to a typed action. The handler receives the full `Action<K>` object.
+Subscribes to a single typed action or an array of actions. The handler receives the full `Action<K>` object.
 
 ```typescript
+// Subscribe to a single action
 const sub = onAction('ui_add_to_cart', (action) => {
   cartService.add(action.payload.productId, action.payload.qty);
   console.log(action.context); // e.g. 'product-list' or undefined
   console.log(action.meta); // any metadata set by modifiers
 });
 
+// Subscribe to multiple actions with a single handler
+const multiSub = onAction(['ui_increment', 'ui_decrement'], (action) => {
+  console.log('Action triggered:', action.type);
+});
+
 sub.unsubscribe(); // Clean up when done
+multiSub.unsubscribe();
 ```
 
 #### `dispatchAction<K>(action)`
@@ -1031,13 +1038,13 @@ const cartSignal = createStateSignal<CartState>({
 import {lazy} from '@alwatr/lazy';
 import {EmbeddedDataCollector} from '@alwatr/flux';
 
-// Extraction is deferred until .value is first accessed
+// Extraction is deferred until .instance is first accessed
 export const serverConfig = lazy(() =>
   new EmbeddedDataCollector<ServerConfig>('data-server-config', isServerConfig).collect(),
 );
 
 // Somewhere in your bootstrap code:
-const config = serverConfig.value; // extracted here, cached forever
+const config = serverConfig.instance; // extracted here, cached forever
 ```
 
 ---

package/dist/main.d.ts

@@ -2,6 +2,7 @@ export * from '@alwatr/signal';
 export * from '@alwatr/action';
 export * from '@alwatr/directive';
 export * from '@alwatr/embedded-data';
+export * from '@alwatr/keyboard-shortcut';
 export * from '@alwatr/render-state';
 export * from '@alwatr/local-storage';
 export * from '@alwatr/session-storage';

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,mBAAmB,qBAAqB,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,mBAAmB,qBAAqB,CAAC"}

package/dist/main.js

@@ -1,5 +1,5 @@
-/* 📦 @alwatr/flux v9.24.0 */
-export*from"@alwatr/signal";export*from"@alwatr/action";export*from"@alwatr/directive";export*from"@alwatr/embedded-data";export*from"@alwatr/render-state";export*from"@alwatr/local-storage";export*from"@alwatr/session-storage";export*from"@alwatr/page-ready";import{html as e,svg as a,mathml as p,render as f,noChange as n,nothing as t}from"lit-html";import{unsafeSVG as g}from"lit-html/directives/unsafe-svg.js";import{ifDefined as i}from"lit-html/directives/if-defined.js";import{cache as s}from"lit-html/directives/cache.js";import{classMap as b}from"lit-html/directives/class-map.js";import{when as d}from"lit-html/directives/when.js";import{repeat as I}from"lit-html/directives/repeat.js";export{d as when,g as unsafeSVG,a as svg,I as repeat,f as render,t as nothing,n as noChange,p as mathml,i as ifDefined,e as html,b as classMap,s as cache};
+/* 📦 @alwatr/flux v9.26.0 */
+export*from"@alwatr/signal";export*from"@alwatr/action";export*from"@alwatr/directive";export*from"@alwatr/embedded-data";export*from"@alwatr/keyboard-shortcut";export*from"@alwatr/render-state";export*from"@alwatr/local-storage";export*from"@alwatr/session-storage";export*from"@alwatr/page-ready";import{html as e,svg as p,mathml as a,render as f,noChange as t,nothing as n}from"lit-html";import{unsafeSVG as g}from"lit-html/directives/unsafe-svg.js";import{ifDefined as i}from"lit-html/directives/if-defined.js";import{cache as s}from"lit-html/directives/cache.js";import{classMap as b}from"lit-html/directives/class-map.js";import{when as d}from"lit-html/directives/when.js";import{repeat as I}from"lit-html/directives/repeat.js";export{d as when,g as unsafeSVG,p as svg,I as repeat,f as render,n as nothing,t as noChange,a as mathml,i as ifDefined,e as html,b as classMap,s as cache};
 
-//# debugId=AF2D31613C9029E164756E2164756E21
+//# debugId=B53609D2635793FE64756E2164756E21
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -2,10 +2,10 @@
   "version": 3,
   "sources": ["../src/main.ts", "../src/lit-html.ts"],
   "sourcesContent": [
-    "// UI and reactive bundle — signals, actions, directives, and client-side storage.\n// This package aggregates all UI-layer nanolibs for convenient single-import usage.\n\nexport * from '@alwatr/signal';\nexport * from '@alwatr/action';\nexport * from '@alwatr/directive';\nexport * from '@alwatr/embedded-data';\nexport * from '@alwatr/render-state';\nexport * from '@alwatr/local-storage';\nexport * from '@alwatr/session-storage';\nexport * from '@alwatr/page-ready';\nexport * from './lit-html.js';\nexport type * from '@alwatr/type-helper';\n",
+    "// UI and reactive bundle — signals, actions, directives, and client-side storage.\n// This package aggregates all UI-layer nanolibs for convenient single-import usage.\n\nexport * from '@alwatr/signal';\nexport * from '@alwatr/action';\nexport * from '@alwatr/directive';\nexport * from '@alwatr/embedded-data';\nexport * from '@alwatr/keyboard-shortcut';\nexport * from '@alwatr/render-state';\nexport * from '@alwatr/local-storage';\nexport * from '@alwatr/session-storage';\nexport * from '@alwatr/page-ready';\nexport * from './lit-html.js';\nexport type * from '@alwatr/type-helper';\n",
     "/**\n * Curated re-exports from `lit-html` for use within `@alwatr/flux`.\n *\n * Only the subset of `lit-html` APIs that are commonly needed in a Flux-based\n * application is exported here. This keeps the public surface minimal and\n * avoids pulling in advanced directive utilities that most consumers never use.\n *\n * **Exported APIs:**\n * - `html` — tagged template literal that produces a `TemplateResult`\n * - `render` — renders a `TemplateResult` into a DOM container\n * - `noChange` — sentinel that tells lit-html to leave the current part value unchanged\n * - `nothing` — sentinel that renders nothing (removes the node/attribute)\n * - `ifDefined` — renders a value only when it is not `undefined`\n * - `cache` — caches rendered templates to avoid re-parsing on state changes\n * - `classMap` — efficiently sets/removes CSS classes from an object map\n * - `when` — conditional rendering helper (`when(condition, trueCase, falseCase)`)\n *\n * @example\n * ```typescript\n * import {html, render, classMap, when} from '@alwatr/flux';\n *\n * const template = (isActive: boolean) => html`\n *   <div class=${classMap({active: isActive, hidden: !isActive})}>\n *     ${when(isActive, () => html`<span>Active</span>`, () => html`<span>Inactive</span>`)}\n *   </div>\n * `;\n *\n * render(template(true), document.getElementById('app')!);\n * ```\n */\nexport {\n  html,\n  svg,\n  mathml,\n  render,\n  noChange,\n  nothing,\n  type TemplateResult,\n  type HTMLTemplateResult,\n  type SVGTemplateResult,\n  type MathMLTemplateResult,\n} from 'lit-html';\nexport {unsafeSVG} from 'lit-html/directives/unsafe-svg.js';\nexport {ifDefined} from 'lit-html/directives/if-defined.js';\nexport {cache} from 'lit-html/directives/cache.js';\nexport {classMap, type ClassInfo} from 'lit-html/directives/class-map.js';\nexport {when} from 'lit-html/directives/when.js';\nexport {repeat, type RepeatDirectiveFn, type KeyFn, type ItemTemplate} from 'lit-html/directives/repeat.js';\n"
   ],
-  "mappings": ";AAGA,4BACA,4BACA,+BACA,mCACA,kCACA,mCACA,qCACA,gCCoBA,eACE,SACA,YACA,YACA,cACA,aACA,iBAMF,oBAAQ,0CACR,oBAAQ,0CACR,gBAAQ,qCACR,mBAAQ,yCACR,eAAQ,oCACR,iBAAQ",
-  "debugId": "AF2D31613C9029E164756E2164756E21",
+  "mappings": ";AAGA,4BACA,4BACA,+BACA,mCACA,uCACA,kCACA,mCACA,qCACA,gCCmBA,eACE,SACA,YACA,YACA,cACA,aACA,iBAMF,oBAAQ,0CACR,oBAAQ,0CACR,gBAAQ,qCACR,mBAAQ,yCACR,eAAQ,oCACR,iBAAQ",
+  "debugId": "B53609D2635793FE64756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwatr/flux",
-  "version": "9.24.0",
+  "version": "9.26.0",
   "description": "UI and reactive library bundle for ECMAScript (JavaScript/TypeScript) projects — signals, actions, directives, and storage.",
   "license": "MPL-2.0",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com> (https://ali.mihandoost.com)",
@@ -21,19 +21,20 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@alwatr/action": "9.24.0",
-    "@alwatr/directive": "9.24.0",
-    "@alwatr/embedded-data": "9.24.0",
-    "@alwatr/local-storage": "9.24.0",
-    "@alwatr/page-ready": "9.24.0",
-    "@alwatr/render-state": "9.24.0",
-    "@alwatr/session-storage": "9.24.0",
-    "@alwatr/signal": "9.24.0",
+    "@alwatr/action": "9.26.0",
+    "@alwatr/directive": "9.26.0",
+    "@alwatr/embedded-data": "9.25.0",
+    "@alwatr/keyboard-shortcut": "9.26.0",
+    "@alwatr/local-storage": "9.25.0",
+    "@alwatr/page-ready": "9.26.0",
+    "@alwatr/render-state": "9.25.0",
+    "@alwatr/session-storage": "9.25.0",
+    "@alwatr/signal": "9.26.0",
     "@alwatr/type-helper": "9.14.0",
     "lit-html": "^3.3.3"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "9.14.0",
+    "@alwatr/nano-build": "9.25.0",
     "@alwatr/standard": "9.16.0",
     "typescript": "^6.0.3"
   },
@@ -83,5 +84,5 @@
     "ui",
     "unidirectional-data-flow"
   ],
-  "gitHead": "7953ae95627dcfcea72516a288560769c7d8fb06"
+  "gitHead": "ef62969b649929413c640e69d241f4e99d6062e8"
 }

package/src/main.ts

@@ -5,6 +5,7 @@ export * from '@alwatr/signal';
 export * from '@alwatr/action';
 export * from '@alwatr/directive';
 export * from '@alwatr/embedded-data';
+export * from '@alwatr/keyboard-shortcut';
 export * from '@alwatr/render-state';
 export * from '@alwatr/local-storage';
 export * from '@alwatr/session-storage';