ustor 0.2.0 → 0.3.1

package/README.md

@@ -18,6 +18,7 @@ A tiny, dependency-free reactive store for JavaScript objects and arrays. UStor
 - [Installation](#installation)
 - [Quickstart](#quickstart)
 - [Common use cases](#common-use-cases)
+- [Examples](#examples)
 - [API reference](#api-reference)
 - [Arrays](#arrays)
 - [Supported adapters](#supported-adapters)
@@ -53,10 +54,10 @@ import { signal, computed, effect } from "@preact/signals-core";
 
 Object.assign(api, {
 	signal,
-	memo: computed,
+	computed,
 	effect,
 	get: (value) => value.value,
-	getMemo: (value) => value.value,
+	getComputed: (value) => value.value,
 	set: (target, value) => { target.value = value; },
 	is: (value) => typeof value?.peek === "function",
 });
@@ -147,6 +148,10 @@ ui.theme = "dark";
 
 Create request- or component-specific stores when the state must not be shared. See [SSR and Next.js](#ssr-and-nextjs).
 
+## Examples
+
+The [source example collection](examples/README.md) contains runnable Node programs for counters, carts, validation, async race handling, undo history, Vue, and RxJS; React and Next.js components; a browser import-map demo; and TypeScript examples. Run `npm run examples` to build, execute the isolated Node examples, and type-check the component/TypeScript sources.
+
 ## API reference
 
 ### `store(values, proto?)`
@@ -190,7 +195,7 @@ is(null);    // false
 
 ### `state.$property`
 
-Exposes the underlying signal for a data property, or the underlying memo for a memoized getter.
+Exposes the underlying signal for a data property, or the underlying computed value for a computed getter.
 
 ```javascript
 const state = store({ count: 0 });
@@ -199,7 +204,7 @@ state.$count.value = 2; // Preact signal example
 console.log(state.count); // 2
 ```
 
-Aliases are non-enumerable. Getters without `api.memo` do not have a `$` alias. If an input explicitly defines a conflicting key such as `$count`, the user-defined property takes precedence.
+Aliases are non-enumerable. Getters without `api.computed` do not have a `$` alias. If an input explicitly defines a conflicting key such as `$count`, the user-defined property takes precedence.
 
 ### Adapter API
 
@@ -216,11 +221,11 @@ Optional operations:
 
 | Operation | Purpose |
 | --- | --- |
-| `api.memo(fn)` | Create a lazy computed value. |
-| `api.getMemo(memo)` | Read a memo; defaults to `api.get`. |
+| `api.computed(fn)` | Create a lazy computed value. |
+| `api.getComputed(computed)` | Read a computed value; defaults to `api.get`. |
 | `api.effect(fn)` | Required by `ustor/react`; must auto-track synchronously and return a cleanup function. |
 
-Without `api.memo`, getters execute on each access and still participate in compatible effects. With `api.memo`, getters are lazy and cached while their dependencies remain unchanged.
+Without `api.computed`, getters execute on each access and still participate in compatible effects. With `api.computed`, getters are lazy and cached while their dependencies remain unchanged.
 
 ## Arrays
 
@@ -253,35 +258,35 @@ The configurations in `adapters.spec.js` are executable documentation and includ
 
 | Package | Getter support |
 | --- | --- |
-| `@preact/signals-core` | Automatic memoization |
-| `solid-js` | Automatic memoization |
-| `oby` | Automatic memoization |
-| `sinuous/observable` | Automatic memoization |
-| `ulive` | Automatic memoization |
-| `usignal` | Automatic memoization |
-| `@vue/reactivity` | Automatic memoization using `shallowRef` |
-| `alien-signals` | Automatic memoization |
-| `s-js` | Automatic memoization using the provided branded factory |
-| `mobx` | Automatic memoization using shallow observable boxes |
-| `@tanstack/store` | Automatic memoization using the provided value wrapper |
-| `@webreflection/signal` | Automatic memoization |
-| `@webreflection/signals` | Automatic memoization |
-| `@webreflection/alien-signals` | Automatic memoization |
+| `@preact/signals-core` | Automatic computed values |
+| `solid-js` | Automatic computed values |
+| `oby` | Automatic computed values |
+| `sinuous/observable` | Automatic computed values |
+| `ulive` | Automatic computed values |
+| `usignal` | Automatic computed values |
+| `@vue/reactivity` | Automatic computed values using `shallowRef` |
+| `alien-signals` | Automatic computed values |
+| `s-js` | Automatic computed values using the provided branded factory |
+| `mobx` | Automatic computed values using shallow observable boxes |
+| `@tanstack/store` | Automatic computed values using the provided value wrapper |
+| `@webreflection/signal` | Automatic computed values |
+| `@webreflection/signals` | Automatic computed values |
+| `@webreflection/alien-signals` | Automatic computed values |
 | `rxjs` | Basic: `BehaviorSubject` values and direct getters |
 | `nanostores` | Basic: atoms and direct getters |
 
-**Basic adapters** support synchronous values, nested objects, arrays, and getters evaluated on access. RxJS and Nanostores do not automatically discover arbitrary getter dependencies, so automatic memoization is not advertised for them.
+**Basic adapters** support synchronous values, nested objects, arrays, and getters evaluated on access. RxJS and Nanostores do not automatically discover arbitrary getter dependencies, so automatic computed values are not advertised for them.
 
 Adapter-specific notes:
 
 - Vue and MobX use shallow containers to avoid wrapping UStor's proxies twice.
 - TanStack Store treats bare functions as computed values; its tested adapter wraps writable values.
-- S.js has no built-in signal brand; use the tested factory and create memoized stores inside an S.js root.
-- Solid.js, Vue, S.js, and similar libraries may require their own owner/scope lifecycle for short-lived memos.
+- S.js has no built-in signal brand; use the tested factory and create stores with computed values inside an S.js root.
+- Solid.js, Vue, S.js, and similar libraries may require their own owner/scope lifecycle for short-lived computed values.
 
 ## Porting any signal library
 
-You normally **do not need to modify UStor's core**. Port a library by translating its synchronous read/write API into four required functions, then add optional memo/effect functions when supported.
+You normally **do not need to modify UStor's core**. Port a library by translating its synchronous read/write API into four required functions, then add optional computed/effect functions when supported.
 
 ### 1. Map the four required operations
 
@@ -370,20 +375,20 @@ api.is = (value) => signals.has(value);
 
 Create external signals through `api.signal` when using this approach. The S.js configuration in `adapters.spec.js` demonstrates it.
 
-### 4. Add memoization only when dependencies are automatic
+### 4. Add computed values only when dependencies are automatic
 
 If the library can compute a value by automatically tracking signals read inside `fn`, add:
 
 ```javascript
 Object.assign(api, {
-	memo: (fn) => library.computed(fn),
-	getMemo: (memo) => library.read(memo),
+	computed: (fn) => library.computed(fn),
+	getComputed: (computed) => library.read(computed),
 });
 ```
 
-The memo may be lazy or eager, but it must invalidate when any dependency changes, including conditional dependencies.
+The computed value may be lazy or eager, but it must invalidate when any dependency changes, including conditional dependencies.
 
-If the library requires an explicit dependency list—as with RxJS or Nanostores—**omit `memo` and `getMemo`**. UStor then uses direct getters evaluated on access. Do not emulate automatic memoization incorrectly.
+If the library requires an explicit dependency list—as with RxJS or Nanostores—**omit `computed` and `getComputed`**. UStor then uses direct getters evaluated on access. Do not emulate automatic dependency tracking incorrectly.
 
 ### 5. Add effects for React integration only when compatible
 
@@ -406,11 +411,11 @@ The core store does not require `api.effect`. Basic adapters without automatic d
 
 ### 6. Configure once and manage lifecycle
 
-Configure `api` before creating stores and keep the same implementation for their lifetime. If your library requires an owner, scope, root, or disposer for memos/effects, create short-lived stores in that lifecycle and dispose them with their owner.
+Configure `api` before creating stores and keep the same implementation for their lifetime. If your library requires an owner, scope, root, or disposer for computed values/effects, create short-lived stores in that lifecycle and dispose them with their owner.
 
 ### 7. Validate the adapter
 
-This Node script checks the required behavior, function preservation, nested updates, arrays, and optional memoization:
+This Node script checks the required behavior, function preservation, nested updates, arrays, and optional computed values:
 
 ```javascript
 import assert from "node:assert/strict";
@@ -444,15 +449,15 @@ assert.equal(state.total, 11);
 state.list[0] = 5;
 assert.equal(state.total, 15);
 
-if (api.memo) {
-	assert.equal((api.getMemo || api.get)(state.$total), 15);
+if (api.computed) {
+	assert.equal((api.getComputed || api.get)(state.$total), 15);
 }
 ```
 
 A production-quality adapter should also verify:
 
 - Whole-array replacement, deletion, and length changes.
-- Conditional memo dependencies and no-op writes.
+- Conditional computed dependencies and no-op writes.
 - Effect cleanup and behavior under nested/batched updates.
 - React StrictMode and unmount behavior when used with `ustor/react`.
 - Owner/scope disposal and long-running memory behavior.
@@ -468,22 +473,23 @@ npm run profile
 
 ## React
 
-Install React and import the optional hooks:
+Install React and import the optional hook:
 
 ```bash
 npm install react
 ```
 
 ```jsx
-import { useSignal, useStore } from "ustor/react";
+import { useSelector } from "ustor/react";
 
 // Uses the Preact configuration from Quickstart, including api.effect.
 const state = store({ count: 1, items: [1, 2] });
+const selectCount = () => state.count;
 const selectTotal = () => state.items.reduce((sum, value) => sum + value, 0);
 
 export function Counter() {
-	const count = useSignal(state.$count);
-	const total = useStore(selectTotal);
+	const count = useSelector(selectCount);
+	const total = useSelector(selectTotal);
 
 	return (
 		<button onClick={() => { state.count++; state.items.push(state.count); }}>
@@ -493,18 +499,18 @@ export function Counter() {
 }
 ```
 
-- `useSignal(signal)` subscribes to one `$property` signal.
-- `useStore(selector)` tracks all compatible signal reads in the selector, including array versions.
+- `useSelector(selector)` is the single React hook for both simple properties and derived values.
+- It tracks all compatible signal reads in the selector, including array versions.
 - Selectors must return a primitive or stable reference, not a fresh object on every read.
 - Keep selector functions stable with `useCallback` when they are created inside a component.
 - React is an optional peer dependency and is excluded from the core bundle.
 - StrictMode and unmount cleanup are tested.
 
-Plain property reads do not schedule React renders by themselves; use the hooks or another React binding.
+Plain property reads do not schedule React renders by themselves; use the hook or another React binding.
 
 ## SSR and Next.js
 
-Yes. `useStore` and `useSignal` provide a server snapshot through `useSyncExternalStore`. Server rendering creates no effects; subscriptions start on the client.
+Yes. `useSelector` provides a server snapshot through `useSyncExternalStore`. Server rendering creates no effects; subscriptions start on the client.
 
 The test suite verifies:
 
@@ -515,14 +521,14 @@ The test suite verifies:
 
 ### Next.js App Router example
 
-Use the hooks in a **Client Component**. Create request- or component-owned state instead of exporting a request-specific singleton.
+Use the hook in a **Client Component**. Create request- or component-owned state instead of exporting a request-specific singleton.
 
 ```jsx
 "use client";
 
 import { useCallback, useState } from "react";
 import { store } from "ustor";
-import { useSignal, useStore } from "ustor/react";
+import { useSelector } from "ustor/react";
 // Import your shared adapter configuration once:
 // import "@/lib/ustor-setup";
 
@@ -531,12 +537,13 @@ export default function Counter({ initialCount }) {
 		count: initialCount,
 		items: [1, 2],
 	}));
+	const selectCount = useCallback(() => state.count, [state]);
 	const selectTotal = useCallback(
 		() => state.items.reduce((sum, value) => sum + value, 0),
 		[state],
 	);
-	const count = useSignal(state.$count);
-	const total = useStore(selectTotal);
+	const count = useSelector(selectCount);
+	const total = useSelector(selectTotal);
 
 	return (
 		<button onClick={() => { state.count++; state.items.push(1); }}>
@@ -572,7 +579,7 @@ Declarations are included for both entry points; no separate `@types/ustor` pack
 
 ```typescript
 import { store } from "ustor";
-import { useStore } from "ustor/react";
+import { useSelector } from "ustor/react";
 
 const state = store({
 	count: 1,
@@ -586,14 +593,13 @@ state.count = 2;             // valid
 
 const doubled: number = state.double;
 const text: string = state.nested.text;
-const total = useStore(() => state.list.reduce((sum, value) => sum + value, 0));
+const total = useSelector(() => state.list.reduce((sum, value) => sum + value, 0));
 ```
 
 Exported type utilities:
 
-- `SignalApi<Signal, Memo>` for custom adapters.
+- `SignalApi<Signal, Computed>` for custom adapters.
 - `Store<T>` for reactive store inference.
-- `SignalValue<Signal>` for React signal-value inference.
 
 Run the repository's strict compile-time tests with:
 
@@ -605,7 +611,7 @@ npm run typecheck
 
 The profiler uses Preact Signals and measures:
 
-- High-frequency memoized property updates.
+- High-frequency computed property updates.
 - Batched property updates.
 - Bounded array mutation workloads.
 - Repeated store/effect creation, updates, and disposal with heap/RSS samples.
@@ -672,6 +678,7 @@ npm test                 # build, type tests, unit/adapter/React/SSR tests, pack
 npm run typecheck        # strict TypeScript declaration tests
 npm run test:coverage    # enforced 100% runtime coverage
 npm run test:watch
+npm run examples         # isolated Node examples and JSX/TypeScript checks
 npm run profile:smoke
 npm run build
 ```

package/dist/index.cjs

@@ -76,14 +76,14 @@ const objectStore = (values, proto) => {
 		const desc = Object.getOwnPropertyDescriptor(values, key),
 			accessor = desc.get || desc.set,
 			getter = desc.get?.bind(state),
-			memoize = getter && api.memo,
+			createComputed = getter && api.computed,
 			signal = accessor ? undefined : api.is(desc.value) ? desc.value : api.signal(resolve(desc.value));
-		let memo;
-		const getSignal = () => getter ? (memo ||= memoize(getter)) : signal;
+		let computed;
+		const getSignal = () => getter ? (computed ||= createComputed(getter)) : signal;
 		Object.defineProperty(state, key, {
 			get: accessor
 				? getter
-					? () => memoize ? (api.getMemo || api.get)(getSignal()) : getter()
+					? () => createComputed ? (api.getComputed || api.get)(getSignal()) : getter()
 					: undefined
 				: () => api.get(signal),
 			set: accessor
@@ -94,7 +94,7 @@ const objectStore = (values, proto) => {
 			enumerable: desc.enumerable,
 		});
 		if (
-			(!accessor || memoize) &&
+			(!accessor || createComputed) &&
 			typeof key === "string" &&
 			!key.startsWith("$") &&
 			!Object.hasOwn(values, "$" + key)

package/dist/index.es.js

@@ -74,14 +74,14 @@ const objectStore = (values, proto) => {
 		const desc = Object.getOwnPropertyDescriptor(values, key),
 			accessor = desc.get || desc.set,
 			getter = desc.get?.bind(state),
-			memoize = getter && api.memo,
+			createComputed = getter && api.computed,
 			signal = accessor ? undefined : api.is(desc.value) ? desc.value : api.signal(resolve(desc.value));
-		let memo;
-		const getSignal = () => getter ? (memo ||= memoize(getter)) : signal;
+		let computed;
+		const getSignal = () => getter ? (computed ||= createComputed(getter)) : signal;
 		Object.defineProperty(state, key, {
 			get: accessor
 				? getter
-					? () => memoize ? (api.getMemo || api.get)(getSignal()) : getter()
+					? () => createComputed ? (api.getComputed || api.get)(getSignal()) : getter()
 					: undefined
 				: () => api.get(signal),
 			set: accessor
@@ -92,7 +92,7 @@ const objectStore = (values, proto) => {
 			enumerable: desc.enumerable,
 		});
 		if (
-			(!accessor || memoize) &&
+			(!accessor || createComputed) &&
 			typeof key === "string" &&
 			!key.startsWith("$") &&
 			!Object.hasOwn(values, "$" + key)

package/dist/index.min.js

@@ -1 +1 @@
-var ustor=function(e){const t={},r=Symbol(),n=new WeakMap,s=/^(copyWithin|fill|pop|push|reverse|shift|sort|splice|unshift)$/,o=e=>!!e?.[r],i=e=>{const t=e&&Object.getPrototypeOf(e);return null!=e&&(null===t||t?.constructor===Object)},c=e=>Array.isArray(e)||i(e)?a(e):e,a=(e,a)=>{if(o(e))return e;if(!Array.isArray(e)&&!i(e))return e;const l=n.get(e);if(l)return l;if(!(t.signal&&t.get&&t.set&&t.is))throw new Error("ustor: configure api.signal, api.get, api.set and api.is");return Array.isArray(e)?(e=>{const o=t.signal(0);let i=0,a=!1;const l=()=>t.get(o),u=()=>{a=!1,t.set(o,t.get(o)+1)},f=new Proxy(e,{get:(e,t,n)=>{if(t===r)return!0;l();const o=Reflect.get(e,t,n);return"string"==typeof t&&s.test(t)&&"function"==typeof o?(...e)=>{i++;try{return o.apply(n,e)}finally{! --i&&a&&u()}}:o},set:(e,t,r)=>{const n=c(r);return!!Object.is(e[t],n)||!!Reflect.set(e,t,n)&&(i?a=!0:u(),!0)},deleteProperty:(e,t)=>!Object.hasOwn(e,t)||!!Reflect.deleteProperty(e,t)&&(i?a=!0:u(),!0),ownKeys:e=>(l(),Reflect.ownKeys(e)),has:(e,t)=>(l(),Reflect.has(e,t))});return n.set(e,f),e.forEach(((t,r)=>{e[r]=c(t)})),f})(e):((e,s)=>{const o=Object.create(void 0===s?Object.getPrototypeOf(e):s);return n.set(e,o),Reflect.ownKeys(e).forEach((r=>{const n=Object.getOwnPropertyDescriptor(e,r),s=n.get||n.set,i=n.get?.bind(o),a=i&&t.memo,l=s?void 0:t.is(n.value)?n.value:t.signal(c(n.value));let u;const f=()=>i?u||=a(i):l;Object.defineProperty(o,r,{get:s?i?()=>a?(t.getMemo||t.get)(f()):i():void 0:()=>t.get(l),set:s?n.set?.bind(o):!1===n.writable?void 0:e=>t.set(l,c(e)),enumerable:n.enumerable}),s&&!a||"string"!=typeof r||r.startsWith("$")||Object.hasOwn(e,"$"+r)||Object.defineProperty(o,"$"+r,{get:f,enumerable:!1})})),Object.defineProperty(o,r,{value:!0}),Object.seal(o)})(e,a)};return e.api=t,e.is=o,e.store=a,e}({});
+var ustor=function(e){const t={},r=Symbol(),n=new WeakMap,s=/^(copyWithin|fill|pop|push|reverse|shift|sort|splice|unshift)$/,o=e=>!!e?.[r],i=e=>{const t=e&&Object.getPrototypeOf(e);return null!=e&&(null===t||t?.constructor===Object)},c=e=>Array.isArray(e)||i(e)?a(e):e,a=(e,a)=>{if(o(e))return e;if(!Array.isArray(e)&&!i(e))return e;const l=n.get(e);if(l)return l;if(!(t.signal&&t.get&&t.set&&t.is))throw new Error("ustor: configure api.signal, api.get, api.set and api.is");return Array.isArray(e)?(e=>{const o=t.signal(0);let i=0,a=!1;const l=()=>t.get(o),u=()=>{a=!1,t.set(o,t.get(o)+1)},f=new Proxy(e,{get:(e,t,n)=>{if(t===r)return!0;l();const o=Reflect.get(e,t,n);return"string"==typeof t&&s.test(t)&&"function"==typeof o?(...e)=>{i++;try{return o.apply(n,e)}finally{! --i&&a&&u()}}:o},set:(e,t,r)=>{const n=c(r);return!!Object.is(e[t],n)||!!Reflect.set(e,t,n)&&(i?a=!0:u(),!0)},deleteProperty:(e,t)=>!Object.hasOwn(e,t)||!!Reflect.deleteProperty(e,t)&&(i?a=!0:u(),!0),ownKeys:e=>(l(),Reflect.ownKeys(e)),has:(e,t)=>(l(),Reflect.has(e,t))});return n.set(e,f),e.forEach((t,r)=>{e[r]=c(t)}),f})(e):((e,s)=>{const o=Object.create(void 0===s?Object.getPrototypeOf(e):s);return n.set(e,o),Reflect.ownKeys(e).forEach(r=>{const n=Object.getOwnPropertyDescriptor(e,r),s=n.get||n.set,i=n.get?.bind(o),a=i&&t.computed,l=s?void 0:t.is(n.value)?n.value:t.signal(c(n.value));let u;const f=()=>i?u||=a(i):l;Object.defineProperty(o,r,{get:s?i?()=>a?(t.getComputed||t.get)(f()):i():void 0:()=>t.get(l),set:s?n.set?.bind(o):!1===n.writable?void 0:e=>t.set(l,c(e)),enumerable:n.enumerable}),s&&!a||"string"!=typeof r||r.startsWith("$")||Object.hasOwn(e,"$"+r)||Object.defineProperty(o,"$"+r,{get:f,enumerable:!1})}),Object.defineProperty(o,r,{value:!0}),Object.seal(o)})(e,a)};return e.api=t,e.is=o,e.store=a,e}({});

package/dist/index.umd.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).ustor={})}(this,(function(e){const t={},r=Symbol(),n=new WeakMap,s=/^(copyWithin|fill|pop|push|reverse|shift|sort|splice|unshift)$/,o=e=>!!e?.[r],i=e=>{const t=e&&Object.getPrototypeOf(e);return null!=e&&(null===t||t?.constructor===Object)},c=e=>Array.isArray(e)||i(e)?a(e):e,a=(e,a)=>{if(o(e))return e;if(!Array.isArray(e)&&!i(e))return e;const f=n.get(e);if(f)return f;if(!(t.signal&&t.get&&t.set&&t.is))throw new Error("ustor: configure api.signal, api.get, api.set and api.is");return Array.isArray(e)?(e=>{const o=t.signal(0);let i=0,a=!1;const f=()=>t.get(o),l=()=>{a=!1,t.set(o,t.get(o)+1)},u=new Proxy(e,{get:(e,t,n)=>{if(t===r)return!0;f();const o=Reflect.get(e,t,n);return"string"==typeof t&&s.test(t)&&"function"==typeof o?(...e)=>{i++;try{return o.apply(n,e)}finally{! --i&&a&&l()}}:o},set:(e,t,r)=>{const n=c(r);return!!Object.is(e[t],n)||!!Reflect.set(e,t,n)&&(i?a=!0:l(),!0)},deleteProperty:(e,t)=>!Object.hasOwn(e,t)||!!Reflect.deleteProperty(e,t)&&(i?a=!0:l(),!0),ownKeys:e=>(f(),Reflect.ownKeys(e)),has:(e,t)=>(f(),Reflect.has(e,t))});return n.set(e,u),e.forEach(((t,r)=>{e[r]=c(t)})),u})(e):((e,s)=>{const o=Object.create(void 0===s?Object.getPrototypeOf(e):s);return n.set(e,o),Reflect.ownKeys(e).forEach((r=>{const n=Object.getOwnPropertyDescriptor(e,r),s=n.get||n.set,i=n.get?.bind(o),a=i&&t.memo,f=s?void 0:t.is(n.value)?n.value:t.signal(c(n.value));let l;const u=()=>i?l||=a(i):f;Object.defineProperty(o,r,{get:s?i?()=>a?(t.getMemo||t.get)(u()):i():void 0:()=>t.get(f),set:s?n.set?.bind(o):!1===n.writable?void 0:e=>t.set(f,c(e)),enumerable:n.enumerable}),s&&!a||"string"!=typeof r||r.startsWith("$")||Object.hasOwn(e,"$"+r)||Object.defineProperty(o,"$"+r,{get:u,enumerable:!1})})),Object.defineProperty(o,r,{value:!0}),Object.seal(o)})(e,a)};e.api=t,e.is=o,e.store=a}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).ustor={})}(this,function(e){const t={},r=Symbol(),n=new WeakMap,s=/^(copyWithin|fill|pop|push|reverse|shift|sort|splice|unshift)$/,o=e=>!!e?.[r],i=e=>{const t=e&&Object.getPrototypeOf(e);return null!=e&&(null===t||t?.constructor===Object)},c=e=>Array.isArray(e)||i(e)?a(e):e,a=(e,a)=>{if(o(e))return e;if(!Array.isArray(e)&&!i(e))return e;const f=n.get(e);if(f)return f;if(!(t.signal&&t.get&&t.set&&t.is))throw new Error("ustor: configure api.signal, api.get, api.set and api.is");return Array.isArray(e)?(e=>{const o=t.signal(0);let i=0,a=!1;const f=()=>t.get(o),l=()=>{a=!1,t.set(o,t.get(o)+1)},u=new Proxy(e,{get:(e,t,n)=>{if(t===r)return!0;f();const o=Reflect.get(e,t,n);return"string"==typeof t&&s.test(t)&&"function"==typeof o?(...e)=>{i++;try{return o.apply(n,e)}finally{! --i&&a&&l()}}:o},set:(e,t,r)=>{const n=c(r);return!!Object.is(e[t],n)||!!Reflect.set(e,t,n)&&(i?a=!0:l(),!0)},deleteProperty:(e,t)=>!Object.hasOwn(e,t)||!!Reflect.deleteProperty(e,t)&&(i?a=!0:l(),!0),ownKeys:e=>(f(),Reflect.ownKeys(e)),has:(e,t)=>(f(),Reflect.has(e,t))});return n.set(e,u),e.forEach((t,r)=>{e[r]=c(t)}),u})(e):((e,s)=>{const o=Object.create(void 0===s?Object.getPrototypeOf(e):s);return n.set(e,o),Reflect.ownKeys(e).forEach(r=>{const n=Object.getOwnPropertyDescriptor(e,r),s=n.get||n.set,i=n.get?.bind(o),a=i&&t.computed,f=s?void 0:t.is(n.value)?n.value:t.signal(c(n.value));let l;const u=()=>i?l||=a(i):f;Object.defineProperty(o,r,{get:s?i?()=>a?(t.getComputed||t.get)(u()):i():void 0:()=>t.get(f),set:s?n.set?.bind(o):!1===n.writable?void 0:e=>t.set(f,c(e)),enumerable:n.enumerable}),s&&!a||"string"!=typeof r||r.startsWith("$")||Object.hasOwn(e,"$"+r)||Object.defineProperty(o,"$"+r,{get:u,enumerable:!1})}),Object.defineProperty(o,r,{value:!0}),Object.seal(o)})(e,a)};e.api=t,e.is=o,e.store=a});

package/dist/react.cjs

@@ -1 +1 @@
-"use strict";var e=require("react");const r={},t=t=>{const c=e.useCallback((e=>{if(!r.effect)throw new Error("ustor/react: configure api.effect with cleanup support");let c=!0;return r.effect((()=>{t(),c?c=!1:e()}))}),[t]);return e.useSyncExternalStore(c,t,t)};exports.useSignal=c=>{const s=e.useCallback((()=>r.get(c)),[c]);return t(s)},exports.useStore=t;
+"use strict";var e=require("react");const r={};exports.useSelector=t=>{const c=e.useCallback(e=>{if(!r.effect)throw new Error("ustor/react: configure api.effect with cleanup support");let c=!0;return r.effect(()=>{t(),c?c=!1:e()})},[t]);return e.useSyncExternalStore(c,t,t)};

package/dist/react.es.js

@@ -1 +1 @@
-import{useCallback as t,useSyncExternalStore as r}from"react";const e={},o=o=>{const c=t((t=>{if(!e.effect)throw new Error("ustor/react: configure api.effect with cleanup support");let r=!0;return e.effect((()=>{o(),r?r=!1:t()}))}),[o]);return r(c,o,o)},c=r=>{const c=t((()=>e.get(r)),[r]);return o(c)};export{c as useSignal,o as useStore};
+import{useCallback as r,useSyncExternalStore as t}from"react";const e={},o=o=>{const c=r(r=>{if(!e.effect)throw new Error("ustor/react: configure api.effect with cleanup support");let t=!0;return e.effect(()=>{o(),t?t=!1:r()})},[o]);return t(c,o,o)};export{o as useSelector};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "ustor",
 	"description": "A tiny, dependency-free reactive store with pluggable signal adapters and optional React hooks.",
-	"version": "0.2.0",
+	"version": "0.3.1",
 	"type": "module",
 	"source": "./src/index.js",
 	"types": "./types/index.d.ts",
@@ -40,6 +40,9 @@
 		"typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.nodenext.json",
 		"test:watch": "vitest",
 		"test:coverage": "vitest --run --coverage",
+		"examples": "npm run examples:node && npm run examples:typecheck",
+		"examples:node": "npm run build && node scripts/run-examples.mjs",
+		"examples:typecheck": "tsc -p tsconfig.examples.json",
 		"profile": "node --expose-gc scripts/profile.mjs",
 		"profile:smoke": "node --expose-gc scripts/profile.mjs --updates=5000 --array-updates=500 --seconds=0.5 --cycles=500 --sample-ms=100",
 		"prepack": "npm run build"
@@ -48,6 +51,7 @@
 		"@preact/signals-core": "^1.14.4",
 		"@rollup/plugin-terser": "^1.0.2",
 		"@tanstack/store": "^0.11.2",
+		"@types/react": "^19.3.0",
 		"@vitest/coverage-v8": "^5.0.5",
 		"@vue/reactivity": "^3.5.44",
 		"@webreflection/alien-signals": "^0.4.2",

package/types/index.d.ts

@@ -1,10 +1,10 @@
-export interface SignalApi<Signal = any, Memo = any> {
+export interface SignalApi<Signal = any, Computed = any> {
 	signal(value: any): Signal;
 	get(signal: Signal): any;
 	set(signal: Signal, value: any): void;
 	is(value: unknown): boolean;
-	memo?(fn: () => any): Memo;
-	getMemo?(memo: Memo): any;
+	computed?(fn: () => any): Computed;
+	getComputed?(computed: Computed): any;
 	effect?(fn: () => void): () => void;
 	[key: string]: unknown;
 }

package/types/react.d.ts

@@ -1,17 +1,2 @@
-export type SignalValue<Signal> = Signal extends { state: readonly (infer Value)[] }
-	? Value
-	: Signal extends { value: infer Value }
-		? Value
-		: Signal extends { get(): infer Value }
-			? Value
-			: Signal extends () => infer Value
-				? Value
-				: Signal extends readonly [() => infer Value, ...any[]]
-					? Value
-					: unknown;
-
 /** Subscribe to a selector that returns a primitive or stable reference. */
-export declare function useStore<Value>(selector: () => Value): Value;
-
-/** Subscribe to one underlying signal exposed as state.$property. */
-export declare function useSignal<Signal>(signal: Signal): SignalValue<Signal>;
+export declare function useSelector<Value>(selector: () => Value): Value;