redux-sacala 0.3.3 → 0.3.5

package/README.md

@@ -1,5 +1,7 @@
 # Redux Sacala
 
+[![Tests](https://github.com/monkin/redux-sacala/actions/workflows/test.yml/badge.svg)](https://github.com/monkin/redux-sacala/actions/workflows/test.yml)
+
 A library for creating composable Redux blocks with state, actions, and effects.
 
 ## Terms Definition
@@ -167,6 +169,39 @@ const mappedBlock = ReduxBlock.mapContext(
 // Now mappedBlock expects NewContext
 ```
 
+### Selector Mapping
+
+You can adapt a block's selectors to work with a different state shape using `ReduxBlock.mapSelectors`. This is useful when you want to embed a block as part of a larger state structure or reuse a block with different state organization.
+
+```typescript
+const counterBlock = ReduxBlock.builder("counter", { count: 0 })
+    .action("inc", (state) => ({ count: state.count + 1 }))
+    .selectors({
+        count: (state) => state.count,
+        doubleCount: (state) => state.count * 2,
+    })
+    .build();
+
+// Original selector expects { count: number }
+// counterBlock.select.count({ count: 5 }) -> 5
+
+// Map selectors to work with a different state shape
+interface AppState {
+    myCounter: { count: number };
+}
+
+const mappedBlock = ReduxBlock.mapSelectors(
+    counterBlock,
+    (state: AppState) => state.myCounter
+);
+
+// Now selectors expect AppState
+// mappedBlock.select.count({ myCounter: { count: 5 } }) -> 5
+// mappedBlock.select.doubleCount({ myCounter: { count: 5 } }) -> 10
+```
+
+Note: In most cases, compositions handle selector lifting automatically. Use `mapSelectors` when you need explicit control over how selectors access state, such as when integrating with existing Redux stores or creating reusable blocks.
+
 ### Minimal Redux Toolkit Example
 
 ```typescript

package/package.json

@@ -1,7 +1,15 @@
 {
     "name": "redux-sacala",
-    "version": "0.3.3",
+    "version": "0.3.5",
     "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/monkin/redux-sacala.git"
+    },
+    "bugs": {
+        "url": "https://github.com/monkin/redux-sacala/issues"
+    },
+    "homepage": "https://github.com/monkin/redux-sacala#readme",
     "type": "module",
     "author": {
         "name": "Andrey Monkin",
@@ -29,7 +37,7 @@
         "@typescript-eslint/parser": "8.53.0",
         "eslint": "9.39.2",
         "eslint-config-prettier": "10.1.8",
-        "prettier": "3.7.4",
+        "prettier": "3.8.0",
         "typescript": "5.9.3",
         "typescript-eslint": "8.53.0",
         "vite": "7.3.1",