muya 2.0.8 → 2.0.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -0
- package/cjs/index.js +1 -1
- package/esm/select.js +1 -1
- package/esm/use-value.js +1 -1
- package/package.json +1 -1
- package/src/__tests__/select.test.tsx +3 -3
- package/src/select.ts +12 -11
- package/src/types.ts +1 -1
- package/src/use-value.ts +3 -3
- package/types/select.d.ts +4 -1
- package/types/types.d.ts +1 -1
- package/types/use-value.d.ts +1 -1
package/README.md
CHANGED
|
@@ -251,6 +251,11 @@ So how `set` state will behave with async initial value?
|
|
|
251
251
|
1. Directly call `.set(2)` will be sync, and will set the value to 2 (it will cancel the initial promise)
|
|
252
252
|
2. Call `.set((prev) => prev + 1)` will wait until previous promise is resolved, so previous value in set callback is always resolved.
|
|
253
253
|
|
|
254
|
+
### Async selectors knowledge base
|
|
255
|
+
1. Values in selectors derived from another async selectors will be always sync **(not promise)**
|
|
256
|
+
2. If the selector is async (`state.select(async (s) => s + 1)`) it will automatically use suspense mode, so on each change it firstly resolved promise (hit suspense) and then update the value.
|
|
257
|
+
3. If the selector is sync, but it's derived from async selector, it will also be in suspense mode - but it depends what the parent is, if the parent is async state, it will hit the suspense only once, on initial load, but if the parent is another async selector, it will hit suspense on each change.
|
|
258
|
+
|
|
254
259
|
### Debugging
|
|
255
260
|
`Muya` in dev mode automatically connects to the `redux` devtools extension if it is installed in the browser. For now devtool api is simple - state updates.
|
|
256
261
|
|
|
@@ -258,3 +263,6 @@ So how `set` state will behave with async initial value?
|
|
|
258
263
|
|
|
259
264
|
This library is a fun, experimental project and not a replacement for robust state management tools. For more advanced use cases, consider libraries like `Zustand`, `Jotai`, or `Redux`.
|
|
260
265
|
If you enjoy `Muya`, please give it a ⭐️! :)
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
|
package/cjs/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";var
|
|
1
|
+
"use strict";var I=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var K=(e,t)=>{for(var r in t)I(e,r,{get:t[r],enumerable:!0})},Y=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of N(t))!_.call(e,o)&&o!==r&&I(e,o,{get:()=>t[o],enumerable:!(n=j(t,o))||n.enumerable});return e};var J=e=>Y(I({},"__esModule",{value:!0}),e);var $={};K($,{EMPTY_SELECTOR:()=>F,create:()=>L,isAbortError:()=>v,isArray:()=>k,isEqualBase:()=>S,isError:()=>D,isFunction:()=>w,isMap:()=>E,isPromise:()=>f,isSet:()=>g,isSetValueFunction:()=>G,isState:()=>W,isUndefined:()=>d,select:()=>P,shallow:()=>z,useValue:()=>V});module.exports=J($);var T=class extends Error{static Error="AbortError"};function Q(e,t){t&&t.abort();let r=new AbortController,{signal:n}=r;return{promise:new Promise((u,s)=>{n.addEventListener("abort",()=>{s(new T)}),e.then(u).catch(s)}),controller:r}}function x(e,t=S){if(!d(e.current)){if(!d(e.previous)&&t(e.current,e.previous))return!1;e.previous=e.current}return!0}function p(e,t,r){if(!f(r))return r;e.abortController&&e.abortController.abort();let{promise:n,controller:o}=Q(r,e.abortController);return e.abortController=o,n.then(u=>{e.current=u,t()}).catch(u=>{v(u)||(e.current=u,t())})}function f(e){return e instanceof Promise}function w(e){return typeof e=="function"}function E(e){return e instanceof Map}function g(e){return e instanceof Set}function k(e){return Array.isArray(e)}function S(e,t){return e===t?!0:!!Object.is(e,t)}function G(e){return typeof e=="function"}function v(e){return e instanceof T}function D(e){return e instanceof Error}function d(e){return e===void 0}function W(e){return w(e)&&"get"in e&&"set"in e&&"isSet"in e&&e.isSet===!0}var F=e=>e;function q(){let e=new Map,t=new Set,r=performance.now(),n=!1;function o(){let s=performance.now(),a=s-r,{size:i}=t;if(a<.2&&i>0&&i<10){r=s,u();return}n||(n=!0,Promise.resolve().then(()=>{n=!1,r=performance.now(),u()}))}function u(){if(t.size===0)return;let s=new Set;for(let a of t){if(e.has(a.id)){s.add(a.id);let{onResolveItem:i}=e.get(a.id);i&&i(a.value)}t.delete(a)}if(t.size>0){o();return}for(let a of s)e.get(a)?.onFinish()}return{add(s,a){return e.set(s,a),()=>{e.delete(s)}},schedule(s,a){t.add({value:a,id:s}),o()}}}function P(e,t,r){let n={};function o(){let c=!1,l=e.map(O=>{let y=O.get();return f(y)&&(c=!0),y});return c?new Promise((O,y)=>{Promise.all(l).then(U=>{if(U.some(H=>d(H)))return y(new T);let M=t(...U);O(M)})}):t(...l)}function u(){if(d(n.current)){let c=o();n.current=p(n,i.emitter.emit,c)}return n.current}function s(){if(d(n.current)){let l=o();n.current=p(n,i.emitter.emit,l)}let{current:c}=n;return f(c)?new Promise(l=>{c.then(b=>{if(d(b)){l(s());return}l(b)})}):n.current}let a=[];for(let c of e){let l=c.emitter.subscribe(()=>{h.schedule(i.id,null)});a.push(l)}let i=C({destroy(){for(let c of a)c();m(),i.emitter.clear(),n.current=void 0},get:s,getSnapshot:u}),m=h.add(i.id,{onFinish(){let c=o();n.current=p(n,i.emitter.emit,c),x(n,r)&&i.emitter.emit()}});return i}var A=require("react");function V(e,t=F){let{emitter:r}=e,n=(0,A.useSyncExternalStore)(e.emitter.subscribe,()=>t(r.getSnapshot()),()=>t(r.getInitialSnapshot?r.getInitialSnapshot():r.getSnapshot()));if((0,A.useDebugValue)(n),f(n)||D(n))throw n;return n}function R(e,t){let r=new Set,n=[];return{clear:()=>{for(let o of n)o();r.clear()},subscribe:o=>(r.add(o),()=>{r.delete(o)}),emit:(...o)=>{for(let u of r)u(...o)},contains:o=>r.has(o),getSnapshot:e,getInitialSnapshot:t,getSize:()=>r.size,subscribeToOtherEmitter(o){let u=o.subscribe(()=>{this.emit()});n.push(u)}}}var X=0;function Z(){return X++}function C(e){let{get:t,destroy:r,set:n,getSnapshot:o}=e,u=!!n,s=function(a){return V(s,a)};return s.isSet=u,s.id=Z(),s.emitter=R(o),s.destroy=r,s.listen=function(a){return this.emitter.subscribe(()=>{let i=t();f(i)||a(t())})},s.withName=function(a){return this.stateName=a,this},s.select=function(a,i=S){return P([s],a,i)},s.get=t,s.set=n,s}var h=q();function L(e,t=S){let r={};function n(){try{if(d(r.current)){let i=w(e)?e():e,m=p(r,s.emitter.emit,i);return r.current=m,r.current}return r.current}catch(i){r.current=i}return r.current}async function o(i,m){await i;let c=m(r.current),l=p(r,s.emitter.emit,c);r.current=l}function u(i){let m=n(),c=G(i);if(c&&f(m)){o(m,i);return}r.abortController&&r.abortController.abort();let l=c?i(m):i,b=p(r,s.emitter.emit,l);r.current=b}let s=C({get:n,destroy(){n(),a(),s.emitter.clear(),r.current=void 0},set(i){h.schedule(s.id,i)},getSnapshot:n}),a=h.add(s.id,{onFinish(){r.current=n(),x(r,t)&&s.emitter.emit()},onResolveItem:u});return w(e)||n(),s}function z(e,t){if(e==t)return!0;if(typeof e!="object"||e==null||typeof t!="object"||t==null)return!1;if(E(e)&&E(t)){if(e.size!==t.size)return!1;for(let[o,u]of e)if(!Object.is(u,t.get(o)))return!1;return!0}if(g(e)&&g(t)){if(e.size!==t.size)return!1;for(let o of e)if(!t.has(o))return!1;return!0}if(k(e)&&k(t)){if(e.length!==t.length)return!1;for(let[o,u]of e.entries())if(!Object.is(u,t[o]))return!1;return!0}let r=Object.keys(e),n=Object.keys(t);if(r.length!==n.length)return!1;for(let o of r)if(!Object.prototype.hasOwnProperty.call(t,o)||!Object.is(e[o],t[o]))return!1;return!0}
|
package/esm/select.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{stateScheduler as T}from"./create";import{createState as
|
|
1
|
+
import{stateScheduler as T}from"./create";import{createState as b}from"./create-state";import{subscribeToDevelopmentTools as P}from"./debug/development-tools";import{AbortError as V,canUpdate as g,handleAsyncUpdate as c}from"./utils/common";import{isPromise as y,isUndefined as i}from"./utils/is";function U(m,d,w){const e={};function s(){let t=!1;const r=m.map(u=>{const o=u.get();return y(o)&&(t=!0),o});return t?new Promise((u,o)=>{Promise.all(r).then(p=>{if(p.some(k=>i(k)))return o(new V);const A=d(...p);u(A)})}):d(...r)}function S(){if(i(e.current)){const t=s();e.current=c(e,n.emitter.emit,t)}return e.current}function f(){if(i(e.current)){const r=s();e.current=c(e,n.emitter.emit,r)}const{current:t}=e;return y(t)?new Promise(r=>{t.then(a=>{if(i(a)){r(f());return}r(a)})}):e.current}const l=[];for(const t of m){const r=t.emitter.subscribe(()=>{T.schedule(n.id,null)});l.push(r)}const n=b({destroy(){for(const t of l)t();h(),n.emitter.clear(),e.current=void 0},get:f,getSnapshot:S}),h=T.add(n.id,{onFinish(){const t=s();e.current=c(e,n.emitter.emit,t),g(e,w)&&n.emitter.emit()}});return P(n),n}export{U as select};
|
package/esm/use-value.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{useDebugValue as
|
|
1
|
+
import{useDebugValue as n,useSyncExternalStore as r}from"react";import{EMPTY_SELECTOR as o}from"./types";import{isError as s,isPromise as S}from"./utils/is";function p(i,a=o){const{emitter:e}=i,t=r(i.emitter.subscribe,()=>a(e.getSnapshot()),()=>a(e.getInitialSnapshot?e.getInitialSnapshot():e.getSnapshot()));if(n(t),S(t)||s(t))throw t;return t}export{p as useValue};
|
package/package.json
CHANGED
|
@@ -87,7 +87,7 @@ describe('select', () => {
|
|
|
87
87
|
const state = create(longPromise(100))
|
|
88
88
|
const selectedState = select([state], async (value) => {
|
|
89
89
|
await longPromise(100)
|
|
90
|
-
return
|
|
90
|
+
return value + 1
|
|
91
91
|
})
|
|
92
92
|
const listener = jest.fn()
|
|
93
93
|
selectedState.listen(listener)
|
|
@@ -100,7 +100,7 @@ describe('select', () => {
|
|
|
100
100
|
const state = create(longPromise(100))
|
|
101
101
|
const selectedState = select([state], async (value) => {
|
|
102
102
|
await longPromise(100)
|
|
103
|
-
return
|
|
103
|
+
return value + 1
|
|
104
104
|
})
|
|
105
105
|
const selectedState2 = selectedState.select(async (value) => value + 1)
|
|
106
106
|
const listener = jest.fn()
|
|
@@ -114,7 +114,7 @@ describe('select', () => {
|
|
|
114
114
|
const state = create(longPromise(100))
|
|
115
115
|
const selectedState = select([state], async (value) => {
|
|
116
116
|
// await longPromise(100)
|
|
117
|
-
return
|
|
117
|
+
return value + 1
|
|
118
118
|
})
|
|
119
119
|
const listener = jest.fn()
|
|
120
120
|
selectedState.listen(listener)
|
package/src/select.ts
CHANGED
|
@@ -9,29 +9,30 @@ type StateDependencies<T extends Array<unknown>> = {
|
|
|
9
9
|
[K in keyof T]: GetState<T[K]>
|
|
10
10
|
}
|
|
11
11
|
|
|
12
|
+
type AwaitedArray<T extends Array<unknown>> = {
|
|
13
|
+
[K in keyof T]: Awaited<T[K]>
|
|
14
|
+
}
|
|
12
15
|
/**
|
|
13
16
|
* Selecting state from multiple states.
|
|
14
17
|
* It will create new state in read-only mode (without set).
|
|
15
18
|
*/
|
|
16
19
|
export function select<T = unknown, S extends Array<unknown> = []>(
|
|
17
20
|
states: StateDependencies<S>,
|
|
18
|
-
selector: (...values: S) => T,
|
|
21
|
+
selector: (...values: AwaitedArray<S>) => T,
|
|
19
22
|
isEqual?: IsEqual<T>,
|
|
20
23
|
): GetState<T> {
|
|
21
24
|
const cache: Cache<T> = {}
|
|
22
25
|
|
|
23
26
|
function computedValue(): T {
|
|
24
|
-
// const values = states.map((state) => state.get()) as S
|
|
25
|
-
|
|
26
|
-
const values: unknown[] = []
|
|
27
27
|
let hasPromise = false
|
|
28
|
-
|
|
29
|
-
const
|
|
30
|
-
if (isPromise(
|
|
28
|
+
const values = states.map((state) => {
|
|
29
|
+
const stateValue = state.get()
|
|
30
|
+
if (isPromise(stateValue)) {
|
|
31
31
|
hasPromise = true
|
|
32
32
|
}
|
|
33
|
-
|
|
34
|
-
}
|
|
33
|
+
return stateValue
|
|
34
|
+
}) as S
|
|
35
|
+
|
|
35
36
|
if (hasPromise) {
|
|
36
37
|
return new Promise((resolve, reject) => {
|
|
37
38
|
Promise.all(values).then((resolvedValues) => {
|
|
@@ -40,12 +41,12 @@ export function select<T = unknown, S extends Array<unknown> = []>(
|
|
|
40
41
|
if (resolvedValues.some((element) => isUndefined(element))) {
|
|
41
42
|
return reject(new AbortError())
|
|
42
43
|
}
|
|
43
|
-
const resolved = selector(...
|
|
44
|
+
const resolved = selector(...resolvedValues)
|
|
44
45
|
resolve(resolved)
|
|
45
46
|
})
|
|
46
47
|
}) as T
|
|
47
48
|
}
|
|
48
|
-
const result = selector(...(values as S))
|
|
49
|
+
const result = selector(...(values as AwaitedArray<S>))
|
|
49
50
|
return result
|
|
50
51
|
}
|
|
51
52
|
function getSnapshot(): T {
|
package/src/types.ts
CHANGED
|
@@ -14,7 +14,7 @@ export interface Cache<T> {
|
|
|
14
14
|
export const EMPTY_SELECTOR = <T, S>(stateValue: T) => stateValue as unknown as S
|
|
15
15
|
|
|
16
16
|
export interface GetState<T, IsFroMPromise extends boolean = false> {
|
|
17
|
-
<S>(selector?: (stateValue: T) => S): Awaited<undefined extends S ? T : S>
|
|
17
|
+
<S>(selector?: (stateValue: Awaited<T>) => S): Awaited<undefined extends S ? T : S>
|
|
18
18
|
/**
|
|
19
19
|
* Get the cached state value.
|
|
20
20
|
*/
|
package/src/use-value.ts
CHANGED
|
@@ -4,13 +4,13 @@ import { isError, isPromise } from './utils/is'
|
|
|
4
4
|
|
|
5
5
|
export function useValue<T, S>(
|
|
6
6
|
state: GetState<T>,
|
|
7
|
-
selector: (stateValue: T) => S = EMPTY_SELECTOR,
|
|
7
|
+
selector: (stateValue: Awaited<T>) => S = EMPTY_SELECTOR,
|
|
8
8
|
): Awaited<undefined extends S ? T : S> {
|
|
9
9
|
const { emitter } = state
|
|
10
10
|
const value = useSyncExternalStore<S>(
|
|
11
11
|
state.emitter.subscribe,
|
|
12
|
-
() => selector(emitter.getSnapshot()),
|
|
13
|
-
() => selector(emitter.getInitialSnapshot ? emitter.getInitialSnapshot() : emitter.getSnapshot()),
|
|
12
|
+
() => selector(emitter.getSnapshot() as Awaited<T>),
|
|
13
|
+
() => selector((emitter.getInitialSnapshot ? emitter.getInitialSnapshot() : emitter.getSnapshot()) as Awaited<T>),
|
|
14
14
|
)
|
|
15
15
|
useDebugValue(value)
|
|
16
16
|
if (isPromise(value)) {
|
package/types/select.d.ts
CHANGED
|
@@ -2,9 +2,12 @@ import type { GetState, IsEqual } from './types';
|
|
|
2
2
|
type StateDependencies<T extends Array<unknown>> = {
|
|
3
3
|
[K in keyof T]: GetState<T[K]>;
|
|
4
4
|
};
|
|
5
|
+
type AwaitedArray<T extends Array<unknown>> = {
|
|
6
|
+
[K in keyof T]: Awaited<T[K]>;
|
|
7
|
+
};
|
|
5
8
|
/**
|
|
6
9
|
* Selecting state from multiple states.
|
|
7
10
|
* It will create new state in read-only mode (without set).
|
|
8
11
|
*/
|
|
9
|
-
export declare function select<T = unknown, S extends Array<unknown> = []>(states: StateDependencies<S>, selector: (...values: S) => T, isEqual?: IsEqual<T>): GetState<T>;
|
|
12
|
+
export declare function select<T = unknown, S extends Array<unknown> = []>(states: StateDependencies<S>, selector: (...values: AwaitedArray<S>) => T, isEqual?: IsEqual<T>): GetState<T>;
|
|
10
13
|
export {};
|
package/types/types.d.ts
CHANGED
|
@@ -11,7 +11,7 @@ export interface Cache<T> {
|
|
|
11
11
|
}
|
|
12
12
|
export declare const EMPTY_SELECTOR: <T, S>(stateValue: T) => S;
|
|
13
13
|
export interface GetState<T, IsFroMPromise extends boolean = false> {
|
|
14
|
-
<S>(selector?: (stateValue: T) => S): Awaited<undefined extends S ? T : S>;
|
|
14
|
+
<S>(selector?: (stateValue: Awaited<T>) => S): Awaited<undefined extends S ? T : S>;
|
|
15
15
|
/**
|
|
16
16
|
* Get the cached state value.
|
|
17
17
|
*/
|
package/types/use-value.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
import { type GetState } from './types';
|
|
2
|
-
export declare function useValue<T, S>(state: GetState<T>, selector?: (stateValue: T) => S): Awaited<undefined extends S ? T : S>;
|
|
2
|
+
export declare function useValue<T, S>(state: GetState<T>, selector?: (stateValue: Awaited<T>) => S): Awaited<undefined extends S ? T : S>;
|