as-model 0.2.2 → 0.2.4

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/index.d.ts CHANGED
@@ -1,324 +1,325 @@
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
- update: (args?: {
104
- model?: Model<S, T>;
105
- key?: Key<S, T, R>;
106
- initialState?: S;
107
- state?: S;
108
- }) => void;
109
- destroy: () => void;
110
- payload: <P>(
111
- callback?: (payload: P | undefined) => P | undefined
112
- ) => P | undefined;
113
- isDestroyed: () => boolean;
114
- extends: <E extends Record<string, any>>(e: E) => Store<S, T, R> & E;
115
- }
116
-
117
- export declare function createStore<
118
- S,
119
- T extends ModelInstance,
120
- D extends S,
121
- R extends (instance: () => T) => any = (instance: () => T) => T
122
- >(
123
- model: Model<S, T> | Key<S, T, R> | ModelUsage<S, T, R>,
124
- state?: D
125
- ): Store<S, T, R>;
126
-
127
- /** createKey * */
128
-
129
- export declare interface ModelKey<
130
- S = any,
131
- T extends ModelInstance = any,
132
- R extends (instance: () => T) => any = (instance: () => T) => T
133
- > extends Key<S, T, R> {
134
- (s: S): T;
135
- createStore: <D extends S>(state?: D) => Store<S, T, R>;
136
- extends: <E extends Record<string, any>>(e: E) => ModelKey<S, T, R> & E;
137
- }
138
-
139
- export declare function createKey<
140
- S,
141
- T extends ModelInstance,
142
- D extends S,
143
- R extends (instance: () => T) => any = (instance: () => T) => T
144
- >(model: Model<S, T> | ModelUsage<S, T, R>, state?: D): ModelKey<S, T, R>;
145
-
146
- /** createStores * */
147
-
148
- export declare interface StoreCollection {
149
- find: <
150
- S,
151
- T extends ModelInstance,
152
- R extends (instance: () => T) => any = (instance: () => T) => T
153
- >(
154
- key: Key<S, T, R> | StoreIndex<S, T, R>
155
- ) => Store<S, T, R> | null;
156
- update: (...keys: (ModelKey | StoreIndex)[]) => void;
157
- keys: () => Key[];
158
- destroy: () => void;
159
- }
160
-
161
- export declare function createStores(
162
- ...modelKeys: (ModelKey | StoreIndex)[]
163
- ): StoreCollection;
164
-
165
- /** model API * */
166
-
167
- export declare interface ModelUsage<
168
- S,
169
- T extends ModelInstance,
170
- R extends (instance: () => T) => any = (instance: () => T) => T
171
- > {
172
- (s: S): ValidInstance<S, T>;
173
- createKey: <D extends S>(state?: D) => ModelKey<S, T, R>;
174
- createStore: <D extends S>(state?: D) => Store<S, T, R>;
175
- produce: <C extends (instance: () => T) => any = (instance: () => T) => T>(
176
- s: C
177
- ) => ModelUsage<S, T, C>;
178
- wrapper: R;
179
- extends: <E extends Record<string, any>>(e: E) => ModelUsage<S, T, R> & E;
180
- }
181
-
182
- // eslint-disable-next-line @typescript-eslint/naming-convention
183
- export declare interface model {
184
- <
185
- S,
186
- T extends ModelInstance,
187
- R extends (instance: () => T) => any = (instance: () => T) => T
188
- >(
189
- modelFn: Model<S, T>,
190
- s?: R
191
- ): ModelUsage<S, T, R>;
192
- createField: <P extends () => any>(
193
- callback: P,
194
- deps?: any[]
195
- ) => FieldStructure<ReturnType<P>>;
196
- createMethod: <P extends (...args: any[]) => any = (...args: any[]) => any>(
197
- method: P
198
- ) => MethodStructure<P>;
199
- }
200
-
201
- /** createSignal * */
202
-
203
- export interface SignalOptions {
204
- cutOff?: boolean;
205
- }
206
-
207
- // eslint-disable-next-line @typescript-eslint/no-redeclare
208
- declare interface SignalStore<
209
- S = any,
210
- T extends ModelInstance = any,
211
- R extends (instance: () => T) => any = (instance: () => T) => any
212
- > extends StoreIndex<S, T, R> {
213
- getToken: () => Token;
214
- subscribe: (dispatcher: Dispatch) => () => void;
215
- getSignal: () => {
216
- (options?: SignalOptions): ReturnType<R>;
217
- startStatistics: () => void;
218
- stopStatistics: () => void;
219
- subscribe: (dispatcher: Dispatch) => () => void;
220
- store: Store<S, T, R>;
221
- };
222
- }
223
-
224
- export declare function createSignal<
225
- S,
226
- T extends ModelInstance,
227
- R extends (instance: () => T) => any = (instance: () => T) => T
228
- >(store: Store<S, T, R>): SignalStore<S, T, R>;
229
-
230
- /** createSelector * */
231
-
232
- declare type SelectMethod<
233
- T extends ModelInstance = any,
234
- R extends (instance: () => T) => any = (instance: () => T) => T
235
- > = {
236
- (): ReturnType<R>;
237
- <C extends (instance: () => ReturnType<R>) => any>(
238
- selector: C
239
- ): ReturnType<C>;
240
- <C extends (instance: () => ReturnType<R>) => any>(
241
- selector?: C
242
- ): ReturnType<R> | ReturnType<C>;
243
- };
244
-
245
- // eslint-disable-next-line @typescript-eslint/no-redeclare
246
- declare interface SelectorStore<
247
- S = any,
248
- T extends ModelInstance = any,
249
- R extends (instance: () => T) => any = (instance: () => T) => T
250
- > extends StoreIndex<S, T, R> {
251
- getToken: () => Token;
252
- subscribe: (dispatcher: Dispatch) => () => void;
253
- select: SelectMethod<T, R>;
254
- }
255
-
256
- declare interface SelectorOption<T = any> {
257
- equality?: (current: T, next: T) => boolean;
258
- }
259
-
260
- export declare function createSelector<
261
- S,
262
- T extends ModelInstance,
263
- R extends (instance: () => T) => any = (instance: () => T) => T
264
- >(store: Store<S, T, R>, opts?: SelectorOption): SelectorStore<S, T, R>;
265
-
266
- /** config * */
267
- export declare function config(configuration: Config): {
268
- createStore: <
269
- S,
270
- T extends ModelInstance,
271
- D extends S,
272
- R extends (instance: () => T) => any = (instance: () => T) => T
273
- >(
274
- model: Model<S, T> | Key<S, T, R> | ModelUsage<S, T, R>,
275
- state?: D
276
- ) => Store<S, T, R>;
277
- createKey: <
278
- S,
279
- T extends ModelInstance,
280
- D extends S,
281
- R extends (instance: () => T) => any = (instance: () => T) => T
282
- >(
283
- model: Model<S, T> | ModelUsage<S, T, R>,
284
- state?: D
285
- ) => ModelKey<S, T, R>;
286
- createStores: (...modelKeys: (ModelKey | StoreIndex)[]) => StoreCollection;
287
- model: model;
288
- };
289
-
290
- /** validations * */
291
- export declare const validations: {
292
- isInstanceFromNoStateModel: (instance: any) => boolean;
293
- isModelKey: <
294
- S,
295
- T extends ModelInstance,
296
- R extends (ins: () => T) => any = (ins: () => T) => T
297
- >(
298
- data: any
299
- ) => data is ModelKey<S, T, R>;
300
- isModelStore: <
301
- S,
302
- T extends ModelInstance,
303
- R extends (ins: () => T) => any = (ins: () => T) => T
304
- >(
305
- data: any
306
- ) => data is Store<S, T, R>;
307
- isModelUsage: <
308
- S,
309
- T extends ModelInstance,
310
- R extends (ins: () => T) => any = (ins: () => T) => T
311
- >(
312
- data: any
313
- ) => data is ModelUsage<S, T, R>;
314
- isStoreIndex: <
315
- S,
316
- T extends ModelInstance,
317
- R extends (ins: () => T) => any = (ins: () => T) => T
318
- >(
319
- data: any
320
- ) => data is StoreIndex<S, T, R>;
321
- };
322
-
323
- /** tools * */
324
- 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, 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;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "private": false,
3
3
  "name": "as-model",
4
- "version": "0.2.2",
4
+ "version": "0.2.4",
5
5
  "description": "This is a model state management tool",
6
6
  "license": "MIT",
7
7
  "author": "Jimmy.Harding",