as-model 0.2.8 → 0.2.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.
Files changed (3) hide show
  1. package/README.md +558 -558
  2. package/index.d.ts +328 -325
  3. package/package.json +68 -68
package/index.d.ts CHANGED
@@ -1,325 +1,328 @@
1
- declare interface ModelInstance {
2
- [key: string]: any;
3
- [key: number]: any;
4
- }
5
-
6
- export declare type FieldStructure<R = any> = {
7
- callback: () => R;
8
- deps: any[] | undefined;
9
- identifier: (d: any) => d is FieldStructure<R>;
10
- value: R;
11
- get: () => R;
12
- };
13
-
14
- export declare type MethodStructure<
15
- R extends (...args: any[]) => any = (...args: any[]) => any
16
- > = R & {
17
- identifier: (d: any) => d is MethodStructure;
18
- };
19
-
20
- declare type ValidInstance<S, T extends ModelInstance> = {
21
- [K in keyof T]: T[K] extends
22
- | ((...args: any[]) => S)
23
- | (((...args: any[]) => any) & { identifier: (d: any) => boolean })
24
- ? T[K]
25
- : T[K] extends (...args: any[]) => any
26
- ? never
27
- : T[K];
28
- };
29
-
30
- export declare type Model<S, T extends ModelInstance> = (
31
- state: S
32
- ) => ValidInstance<S, T>;
33
-
34
- export declare type Action<S = any, T extends ModelInstance = ModelInstance> = {
35
- type: null | string;
36
- method: null | ((...args: any[]) => any);
37
- params?: any[];
38
- state: S;
39
- prevState?: S;
40
- instance: T;
41
- prevInstance?: T;
42
- };
43
-
44
- export interface Token {
45
- isDifferent: (token: Token) => boolean;
46
- value: unknown;
47
- }
48
-
49
- export declare type Dispatch = (action: Action) => any;
50
-
51
- export declare interface Key<
52
- S = any,
53
- T extends ModelInstance = any,
54
- R extends (instance: () => T) => any = (instance: () => T) => T
55
- > extends Model<S, T> {
56
- (s: S): T;
57
- source: Model<S, T>;
58
- selector: R;
59
- modelKeyIdentifier: () => boolean;
60
- [k: string]: any;
61
- defaultState?: S;
62
- }
63
-
64
- declare interface UpdaterStore<
65
- S = any,
66
- T extends ModelInstance = ModelInstance
67
- > {
68
- getState: () => { state: S; instance: T };
69
- dispatch: (action: Action) => void;
70
- }
71
-
72
- export declare type MiddleWare = (
73
- store: UpdaterStore
74
- ) => (next: Dispatch) => (action: Action) => void;
75
-
76
- export declare interface Config {
77
- middleWares?: MiddleWare[];
78
- controlled?: boolean;
79
- notify?: (
80
- notifier: (action: Action) => { errors: any[] | undefined },
81
- action: Action
82
- ) => any;
83
- }
84
-
85
- /** createStore * */
86
-
87
- export declare interface StoreIndex<
88
- S = any,
89
- T extends ModelInstance = any,
90
- R extends (instance: () => T) => any = (instance: () => T) => T
91
- > {
92
- key: Key<S, T, R>;
93
- }
94
-
95
- export declare interface Store<
96
- S = any,
97
- T extends ModelInstance = any,
98
- R extends (instance: () => T) => any = (instance: () => T) => T
99
- > extends StoreIndex<S, T, R> {
100
- subscribe: (dispatcher: Dispatch) => () => void;
101
- getToken: () => Token;
102
- getInstance: () => ReturnType<R>;
103
- getStoreInstance: () => T;
104
- update: (args?: {
105
- model?: Model<S, T>;
106
- key?: Key<S, T, R>;
107
- initialState?: S;
108
- state?: S;
109
- }) => void;
110
- destroy: () => void;
111
- payload: <P>(
112
- callback?: (payload: P | undefined) => P | undefined
113
- ) => P | undefined;
114
- isDestroyed: () => boolean;
115
- extends: <E extends Record<string, any>>(e: E) => Store<S, T, R> & E;
116
- }
117
-
118
- export declare function createStore<
119
- S,
120
- T extends ModelInstance,
121
- D extends S,
122
- R extends (instance: () => T) => any = (instance: () => T) => T
123
- >(
124
- model: Model<S, T> | Key<S, T, R> | ModelUsage<S, T, R>,
125
- state?: D
126
- ): Store<S, T, R>;
127
-
128
- /** createKey * */
129
-
130
- export declare interface ModelKey<
131
- S = any,
132
- T extends ModelInstance = any,
133
- R extends (instance: () => T) => any = (instance: () => T) => T
134
- > extends Key<S, T, R> {
135
- (s: S): T;
136
- createStore: <D extends S>(state?: D) => Store<S, T, R>;
137
- extends: <E extends Record<string, any>>(e: E) => ModelKey<S, T, R> & E;
138
- }
139
-
140
- export declare function createKey<
141
- S,
142
- T extends ModelInstance,
143
- D extends S,
144
- R extends (instance: () => T) => any = (instance: () => T) => T
145
- >(model: Model<S, T> | ModelUsage<S, T, R>, state?: D): ModelKey<S, T, R>;
146
-
147
- /** createStores * */
148
-
149
- export declare interface StoreCollection {
150
- find: <
151
- S,
152
- T extends ModelInstance,
153
- R extends (instance: () => T) => any = (instance: () => T) => T
154
- >(
155
- key: Key<S, T, R> | StoreIndex<S, T, R>
156
- ) => Store<S, T, R> | null;
157
- update: (...keys: (ModelKey | StoreIndex)[]) => void;
158
- keys: () => Key[];
159
- destroy: () => void;
160
- }
161
-
162
- export declare function createStores(
163
- ...modelKeys: (ModelKey | StoreIndex)[]
164
- ): StoreCollection;
165
-
166
- /** model API * */
167
-
168
- export declare interface ModelUsage<
169
- S,
170
- T extends ModelInstance,
171
- R extends (instance: () => T) => any = (instance: () => T) => T
172
- > {
173
- (s: S): ValidInstance<S, T>;
174
- createKey: <D extends S>(state?: D) => ModelKey<S, T, R>;
175
- createStore: <D extends S>(state?: D) => Store<S, T, R>;
176
- produce: <C extends (instance: () => T) => any = (instance: () => T) => T>(
177
- s: C
178
- ) => ModelUsage<S, T, C>;
179
- wrapper: R;
180
- extends: <E extends Record<string, any>>(e: E) => ModelUsage<S, T, R> & E;
181
- }
182
-
183
- // eslint-disable-next-line @typescript-eslint/naming-convention
184
- export declare interface model {
185
- <
186
- S,
187
- T extends ModelInstance,
188
- R extends (instance: () => T) => any = (instance: () => T) => T
189
- >(
190
- modelFn: Model<S, T>,
191
- s?: R
192
- ): ModelUsage<S, T, R>;
193
- createField: <P extends () => any>(
194
- callback: P,
195
- deps?: any[]
196
- ) => FieldStructure<ReturnType<P>>;
197
- createMethod: <P extends (...args: any[]) => any = (...args: any[]) => any>(
198
- method: P
199
- ) => MethodStructure<P>;
200
- }
201
-
202
- /** createSignal * */
203
-
204
- export interface SignalOptions {
205
- cutOff?: boolean;
206
- }
207
-
208
- // eslint-disable-next-line @typescript-eslint/no-redeclare
209
- declare interface SignalStore<
210
- S = any,
211
- T extends ModelInstance = any,
212
- R extends (instance: () => T) => any = (instance: () => T) => any
213
- > extends StoreIndex<S, T, R> {
214
- getToken: () => Token;
215
- subscribe: (dispatcher: Dispatch) => () => void;
216
- getSignal: () => {
217
- (options?: SignalOptions): ReturnType<R>;
218
- startStatistics: () => void;
219
- stopStatistics: () => void;
220
- subscribe: (dispatcher: Dispatch) => () => void;
221
- store: Store<S, T, R>;
222
- };
223
- }
224
-
225
- export declare function createSignal<
226
- S,
227
- T extends ModelInstance,
228
- R extends (instance: () => T) => any = (instance: () => T) => T
229
- >(store: Store<S, T, R>): SignalStore<S, T, R>;
230
-
231
- /** createSelector * */
232
-
233
- declare type SelectMethod<
234
- T extends ModelInstance = any,
235
- R extends (instance: () => T) => any = (instance: () => T) => T
236
- > = {
237
- (): ReturnType<R>;
238
- <C extends (instance: () => ReturnType<R>) => any>(
239
- selector: C
240
- ): ReturnType<C>;
241
- <C extends (instance: () => ReturnType<R>) => any>(
242
- selector?: C
243
- ): ReturnType<R> | ReturnType<C>;
244
- };
245
-
246
- // eslint-disable-next-line @typescript-eslint/no-redeclare
247
- declare interface SelectorStore<
248
- S = any,
249
- T extends ModelInstance = any,
250
- R extends (instance: () => T) => any = (instance: () => T) => T
251
- > extends StoreIndex<S, T, R> {
252
- getToken: () => Token;
253
- subscribe: (dispatcher: Dispatch) => () => void;
254
- select: SelectMethod<T, R>;
255
- }
256
-
257
- declare interface SelectorOption<T = any> {
258
- equality?: (current: T, next: T) => boolean;
259
- }
260
-
261
- export declare function createSelector<
262
- S,
263
- T extends ModelInstance,
264
- R extends (instance: () => T) => any = (instance: () => T) => T
265
- >(store: Store<S, T, R>, opts?: SelectorOption): SelectorStore<S, T, R>;
266
-
267
- /** config * */
268
- export declare function config(configuration: Config): {
269
- createStore: <
270
- S,
271
- T extends ModelInstance,
272
- D extends S,
273
- R extends (instance: () => T) => any = (instance: () => T) => T
274
- >(
275
- model: Model<S, T> | Key<S, T, R> | ModelUsage<S, T, R>,
276
- state?: D
277
- ) => Store<S, T, R>;
278
- createKey: <
279
- S,
280
- T extends ModelInstance,
281
- D extends S,
282
- R extends (instance: () => T) => any = (instance: () => T) => T
283
- >(
284
- model: Model<S, T> | ModelUsage<S, T, R>,
285
- state?: D
286
- ) => ModelKey<S, T, R>;
287
- createStores: (...modelKeys: (ModelKey | StoreIndex)[]) => StoreCollection;
288
- model: model;
289
- };
290
-
291
- /** validations * */
292
- export declare const validations: {
293
- isInstanceFromNoStateModel: (instance: any) => boolean;
294
- isModelKey: <
295
- S,
296
- T extends ModelInstance,
297
- R extends (ins: () => T) => any = (ins: () => T) => T
298
- >(
299
- data: any
300
- ) => data is ModelKey<S, T, R>;
301
- isModelStore: <
302
- S,
303
- T extends ModelInstance,
304
- R extends (ins: () => T) => any = (ins: () => T) => T
305
- >(
306
- data: any
307
- ) => data is Store<S, T, R>;
308
- isModelUsage: <
309
- S,
310
- T extends ModelInstance,
311
- R extends (ins: () => T) => any = (ins: () => T) => T
312
- >(
313
- data: any
314
- ) => data is ModelUsage<S, T, R>;
315
- isStoreIndex: <
316
- S,
317
- T extends ModelInstance,
318
- R extends (ins: () => T) => any = (ins: () => T) => T
319
- >(
320
- data: any
321
- ) => data is StoreIndex<S, T, R>;
322
- };
323
-
324
- /** tools * */
325
- export declare function shallowEqual(prev: any, current: any): boolean;
1
+ declare interface ModelInstance {
2
+ [key: string]: any;
3
+ [key: number]: any;
4
+ }
5
+
6
+ export declare type FieldStructure<R = any> = {
7
+ callback: () => R;
8
+ deps: any[] | undefined;
9
+ identifier: (d: any) => d is FieldStructure<R>;
10
+ value: R;
11
+ get: () => R;
12
+ };
13
+
14
+ export declare type MethodStructure<
15
+ R extends (...args: any[]) => any = (...args: any[]) => any
16
+ > = R & {
17
+ identifier: (d: any) => d is MethodStructure;
18
+ };
19
+
20
+ declare type ValidInstance<S, T extends ModelInstance> = {
21
+ [K in keyof T]: T[K] extends
22
+ | ((...args: any[]) => S)
23
+ | (((...args: any[]) => any) & { identifier: (d: any) => boolean })
24
+ ? T[K]
25
+ : T[K] extends (...args: any[]) => any
26
+ ? never
27
+ : T[K];
28
+ };
29
+
30
+ export declare type Model<S, T extends ModelInstance> = (
31
+ state: S
32
+ ) => ValidInstance<S, T>;
33
+
34
+ export declare type Action<S = any, T extends ModelInstance = ModelInstance> = {
35
+ type: null | string;
36
+ method: null | ((...args: any[]) => any);
37
+ params?: any[];
38
+ state: S;
39
+ prevState?: S;
40
+ instance: T;
41
+ prevInstance?: T;
42
+ };
43
+
44
+ export interface Token {
45
+ isDifferent: (token: Token) => boolean;
46
+ value: unknown;
47
+ }
48
+
49
+ export declare type Dispatch = (action: Action) => any;
50
+
51
+ export declare interface Key<
52
+ S = any,
53
+ T extends ModelInstance = any,
54
+ R extends (instance: () => T) => any = (instance: () => T) => T
55
+ > extends Model<S, T> {
56
+ (s: S): T;
57
+ source: Model<S, T>;
58
+ selector: R;
59
+ modelKeyIdentifier: () => boolean;
60
+ [k: string]: any;
61
+ defaultState?: S;
62
+ }
63
+
64
+ declare interface UpdaterStore<
65
+ S = any,
66
+ T extends ModelInstance = ModelInstance
67
+ > {
68
+ getState: () => { state: S; instance: T };
69
+ dispatch: (action: Action) => void;
70
+ }
71
+
72
+ export declare type MiddleWare = (
73
+ store: UpdaterStore
74
+ ) => (next: Dispatch) => (action: Action) => void;
75
+
76
+ export declare interface Config {
77
+ middleWares?: MiddleWare[];
78
+ controlled?: boolean;
79
+ notify?: (
80
+ notifier: (action: Action) => { errors: any[] | undefined },
81
+ action: Action
82
+ ) => any;
83
+ }
84
+
85
+ /** createStore * */
86
+
87
+ export declare interface StoreIndex<
88
+ S = any,
89
+ T extends ModelInstance = any,
90
+ R extends (instance: () => T) => any = (instance: () => T) => T
91
+ > {
92
+ key: Key<S, T, R>;
93
+ }
94
+
95
+ export declare interface Store<
96
+ S = any,
97
+ T extends ModelInstance = any,
98
+ R extends (instance: () => T) => any = (instance: () => T) => T
99
+ > extends StoreIndex<S, T, R> {
100
+ subscribe: (dispatcher: Dispatch) => () => void;
101
+ getToken: () => Token;
102
+ getInstance: () => ReturnType<R>;
103
+ getStoreInstance: () => T;
104
+ update: (args?: {
105
+ model?: Model<S, T>;
106
+ key?: Key<S, T, R>;
107
+ initialState?: S;
108
+ state?: S;
109
+ }) => void;
110
+ destroy: () => void;
111
+ payload: <P>(
112
+ callback?: (payload: P | undefined) => P | undefined
113
+ ) => P | undefined;
114
+ isDestroyed: () => boolean;
115
+ extends: <E extends Record<string, any>>(e: E) => Store<S, T, R> & E;
116
+ }
117
+
118
+ export declare function createStore<
119
+ S,
120
+ T extends ModelInstance,
121
+ D extends S,
122
+ R extends (instance: () => T) => any = (instance: () => T) => T
123
+ >(
124
+ model: Model<S, T> | Key<S, T, R> | ModelUsage<S, T, Model<S, T>, R>,
125
+ state?: D
126
+ ): Store<S, T, R>;
127
+
128
+ /** createKey * */
129
+
130
+ export declare interface ModelKey<
131
+ S = any,
132
+ T extends ModelInstance = any,
133
+ R extends (instance: () => T) => any = (instance: () => T) => T
134
+ > extends Key<S, T, R> {
135
+ (s: S): T;
136
+ createStore: <D extends S>(state?: D) => Store<S, T, R>;
137
+ extends: <E extends Record<string, any>>(e: E) => ModelKey<S, T, R> & E;
138
+ }
139
+
140
+ export declare function createKey<
141
+ S,
142
+ T extends ModelInstance,
143
+ D extends S,
144
+ R extends (instance: () => T) => any = (instance: () => T) => T
145
+ >(
146
+ model: Model<S, T> | ModelUsage<S, T, Model<S, T>, R>,
147
+ state?: D
148
+ ): ModelKey<S, T, R>;
149
+
150
+ /** createStores * */
151
+
152
+ export declare interface StoreCollection {
153
+ find: <
154
+ S,
155
+ T extends ModelInstance,
156
+ R extends (instance: () => T) => any = (instance: () => T) => T
157
+ >(
158
+ key: Key<S, T, R> | StoreIndex<S, T, R>
159
+ ) => Store<S, T, R> | null;
160
+ update: (...keys: (ModelKey | StoreIndex)[]) => void;
161
+ keys: () => Key[];
162
+ destroy: () => void;
163
+ }
164
+
165
+ export declare function createStores(
166
+ ...modelKeys: (ModelKey | StoreIndex)[]
167
+ ): StoreCollection;
168
+
169
+ /** model API * */
170
+
171
+ export declare type ModelUsage<
172
+ S,
173
+ T extends ModelInstance,
174
+ M extends Model<S, T>,
175
+ R extends (instance: () => T) => any = (instance: () => T) => T
176
+ > = M & {
177
+ createKey: <D extends S>(state?: D) => ModelKey<S, T, R>;
178
+ createStore: <D extends S>(state?: D) => Store<S, T, R>;
179
+ produce: <C extends (instance: () => T) => any = (instance: () => T) => T>(
180
+ s: C
181
+ ) => ModelUsage<S, T, M, C>;
182
+ wrapper: R;
183
+ extends: <E extends Record<string, any>>(e: E) => ModelUsage<S, T, M, R> & E;
184
+ };
185
+
186
+ // eslint-disable-next-line @typescript-eslint/naming-convention
187
+ export declare interface model {
188
+ <
189
+ S,
190
+ T extends ModelInstance,
191
+ R extends (instance: () => T) => any = (instance: () => T) => T
192
+ >(
193
+ modelFn: Model<S, T>,
194
+ s?: R
195
+ ): ModelUsage<S, T, typeof modelFn, R>;
196
+ createField: <P extends () => any>(
197
+ callback: P,
198
+ deps?: any[]
199
+ ) => FieldStructure<ReturnType<P>>;
200
+ createMethod: <P extends (...args: any[]) => any = (...args: any[]) => any>(
201
+ method: P
202
+ ) => MethodStructure<P>;
203
+ }
204
+
205
+ /** createSignal * */
206
+
207
+ export interface SignalOptions {
208
+ cutOff?: boolean;
209
+ }
210
+
211
+ // eslint-disable-next-line @typescript-eslint/no-redeclare
212
+ declare interface SignalStore<
213
+ S = any,
214
+ T extends ModelInstance = any,
215
+ R extends (instance: () => T) => any = (instance: () => T) => any
216
+ > extends StoreIndex<S, T, R> {
217
+ getToken: () => Token;
218
+ subscribe: (dispatcher: Dispatch) => () => void;
219
+ getSignal: () => {
220
+ (options?: SignalOptions): ReturnType<R>;
221
+ startStatistics: () => void;
222
+ stopStatistics: () => void;
223
+ subscribe: (dispatcher: Dispatch) => () => void;
224
+ store: Store<S, T, R>;
225
+ };
226
+ }
227
+
228
+ export declare function createSignal<
229
+ S,
230
+ T extends ModelInstance,
231
+ R extends (instance: () => T) => any = (instance: () => T) => T
232
+ >(store: Store<S, T, R>): SignalStore<S, T, R>;
233
+
234
+ /** createSelector * */
235
+
236
+ declare type SelectMethod<
237
+ T extends ModelInstance = any,
238
+ R extends (instance: () => T) => any = (instance: () => T) => T
239
+ > = {
240
+ (): ReturnType<R>;
241
+ <C extends (instance: () => ReturnType<R>) => any>(
242
+ selector: C
243
+ ): ReturnType<C>;
244
+ <C extends (instance: () => ReturnType<R>) => any>(
245
+ selector?: C
246
+ ): ReturnType<R> | ReturnType<C>;
247
+ };
248
+
249
+ // eslint-disable-next-line @typescript-eslint/no-redeclare
250
+ declare interface SelectorStore<
251
+ S = any,
252
+ T extends ModelInstance = any,
253
+ R extends (instance: () => T) => any = (instance: () => T) => T
254
+ > extends StoreIndex<S, T, R> {
255
+ getToken: () => Token;
256
+ subscribe: (dispatcher: Dispatch) => () => void;
257
+ select: SelectMethod<T, R>;
258
+ }
259
+
260
+ declare interface SelectorOption<T = any> {
261
+ equality?: (current: T, next: T) => boolean;
262
+ }
263
+
264
+ export declare function createSelector<
265
+ S,
266
+ T extends ModelInstance,
267
+ R extends (instance: () => T) => any = (instance: () => T) => T
268
+ >(store: Store<S, T, R>, opts?: SelectorOption): SelectorStore<S, T, R>;
269
+
270
+ /** config * */
271
+ export declare function config(configuration: Config): {
272
+ createStore: <
273
+ S,
274
+ T extends ModelInstance,
275
+ D extends S,
276
+ R extends (instance: () => T) => any = (instance: () => T) => T
277
+ >(
278
+ model: Model<S, T> | Key<S, T, R> | ModelUsage<S, T, R>,
279
+ state?: D
280
+ ) => Store<S, T, R>;
281
+ createKey: <
282
+ S,
283
+ T extends ModelInstance,
284
+ D extends S,
285
+ R extends (instance: () => T) => any = (instance: () => T) => T
286
+ >(
287
+ model: Model<S, T> | ModelUsage<S, T, R>,
288
+ state?: D
289
+ ) => ModelKey<S, T, R>;
290
+ createStores: (...modelKeys: (ModelKey | StoreIndex)[]) => StoreCollection;
291
+ model: model;
292
+ };
293
+
294
+ /** validations * */
295
+ export declare const validations: {
296
+ isInstanceFromNoStateModel: (instance: any) => boolean;
297
+ isModelKey: <
298
+ S,
299
+ T extends ModelInstance,
300
+ R extends (ins: () => T) => any = (ins: () => T) => T
301
+ >(
302
+ data: any
303
+ ) => data is ModelKey<S, T, R>;
304
+ isModelStore: <
305
+ S,
306
+ T extends ModelInstance,
307
+ R extends (ins: () => T) => any = (ins: () => T) => T
308
+ >(
309
+ data: any
310
+ ) => data is Store<S, T, R>;
311
+ isModelUsage: <
312
+ S,
313
+ T extends ModelInstance,
314
+ R extends (ins: () => T) => any = (ins: () => T) => T
315
+ >(
316
+ data: any
317
+ ) => data is ModelUsage<S, T, typeof data, R>;
318
+ isStoreIndex: <
319
+ S,
320
+ T extends ModelInstance,
321
+ R extends (ins: () => T) => any = (ins: () => T) => T
322
+ >(
323
+ data: any
324
+ ) => data is StoreIndex<S, T, R>;
325
+ };
326
+
327
+ /** tools * */
328
+ export declare function shallowEqual(prev: any, current: any): boolean;