@leesf/legend-state-selector 0.1.0

package/README.md

@@ -0,0 +1,78 @@
+# @leesf/legend-state-selector
+
+A small `createSelector` helper for [Legend State](https://legendapp.com/open-source/state/) v3.
+
+It creates per-key computed observables for selection state, so only the previously selected key and the next selected key are invalidated when the source value changes.
+
+## Installation
+
+```bash
+pnpm add @leesf/legend-state-selector @legendapp/state
+```
+
+## Usage
+
+```ts
+import { observable } from "@legendapp/state";
+import { createSelector } from "@leesf/legend-state-selector";
+
+const selected = observable("inbox");
+const isSelected = createSelector(selected);
+
+const inbox = isSelected("inbox");
+const archive = isSelected("archive");
+
+inbox.get(); // true
+archive.get(); // false
+
+selected.set("archive");
+
+inbox.get(); // false
+archive.get(); // true
+```
+
+## Object Values
+
+Pass a `getKey` function when the selected value is an object. The key is used for both map lookups and equality checks.
+
+```ts
+import { observable } from "@legendapp/state";
+import { createSelector } from "@leesf/legend-state-selector";
+
+const selected = observable({ id: "inbox", label: "Inbox" });
+
+const isSelected = createSelector(selected, (item) => item.id);
+
+const inbox = isSelected({ id: "inbox", label: "Unread" });
+const archive = isSelected({ id: "archive", label: "Archive" });
+
+inbox.get(); // true
+archive.get(); // false
+
+selected.set({ id: "archive", label: "All archived" });
+
+inbox.get(); // false
+archive.get(); // true
+```
+
+## API
+
+```ts
+createSelector<T>(
+  source: Observable<T>,
+  getKey?: (value: T) => unknown,
+): (key: T) => Observable<boolean>
+```
+
+- `source`: The Legend State observable holding the current selected value.
+- `getKey`: Optional function that converts a selected value into a stable key. Defaults to the value itself.
+- Returns a function that creates a computed boolean observable for a key.
+
+## Development
+
+```bash
+pnpm install
+pnpm test
+pnpm run typecheck
+pnpm run build
+```

package/dist/index.d.mts

@@ -0,0 +1,6 @@
+import { Observable } from "@legendapp/state";
+
+//#region src/index.d.ts
+declare function createSelector<T = null>(source: Observable<T>, getKey?: (value: T) => unknown): (key: T) => import("@legendapp/state").ObservableBoolean<boolean>;
+//#endregion
+export { createSelector };

package/dist/index.mjs

@@ -0,0 +1,33 @@
+import { batch, observable, observe } from "@legendapp/state";
+//#region src/index.ts
+function createSelector(source, getKey = (value) => value) {
+	let current = source.get();
+	let currentKey = getKey(current);
+	const versionByKey = /* @__PURE__ */ new Map();
+	observe(() => {
+		const next = source.get();
+		const nextKey = getKey(next);
+		if (Object.is(currentKey, nextKey)) return;
+		const prevKey = currentKey;
+		current = next;
+		currentKey = nextKey;
+		batch(() => {
+			versionByKey.get(prevKey)?.set((v) => v + 1);
+			versionByKey.get(nextKey)?.set((v) => v + 1);
+		});
+	});
+	return (key) => {
+		const selectorKey = getKey(key);
+		let keyVersion = versionByKey.get(selectorKey);
+		if (!keyVersion) {
+			keyVersion = observable(0);
+			versionByKey.set(selectorKey, keyVersion);
+		}
+		return observable(() => {
+			keyVersion.get();
+			return Object.is(currentKey, selectorKey);
+		});
+	};
+}
+//#endregion
+export { createSelector };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@leesf/legend-state-selector",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "A createSelector helper for Legend State.",
+  "keywords": [
+    "legend-state",
+    "selector",
+    "observable",
+    "state"
+  ],
+  "author": "Lee Shuen Fei",
+  "license": "MIT",
+  "homepage": "https://github.com/LeeSF03/legend-state-selector#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LeeSF03/legend-state-selector.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LeeSF03/legend-state-selector/issues"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "@typescript/native-preview": "7.0.0-dev.20260509.2",
+    "bumpp": "^11.1.0",
+    "tsdown": "^0.22.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "dependencies": {
+    "@legendapp/state": "3.0.0-beta.47"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "release": "bumpp"
+  }
+}