@ngxs/router-plugin 18.1.2 → 18.1.3

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/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ (The MIT License)
2
+
3
+ Copyright (c) 2018 <amcdaniel2@gmail.com>
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining
6
+ a copy of this software and associated documentation files (the
7
+ 'Software'), to deal in the Software without restriction, including
8
+ without limitation the rights to use, copy, modify, merge, publish,
9
+ distribute, sublicense, and/or sell copies of the Software, and to
10
+ permit persons to whom the Software is furnished to do so, subject to
11
+ the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19
+ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
20
+ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
21
+ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22
+ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
package/index.d.ts CHANGED
@@ -1,4 +1,166 @@
1
+ import * as i0 from '@angular/core';
2
+ import { ModuleWithProviders, EnvironmentProviders, OnDestroy, NgZone, Injector } from '@angular/core';
3
+ import { NgxsRouterPluginOptions } from '@ngxs/router-plugin/internals';
4
+ export { NavigationActionTiming, NgxsRouterPluginOptions } from '@ngxs/router-plugin/internals';
5
+ import * as i1 from '@ngxs/store';
6
+ import { StateToken, Store, StateContext } from '@ngxs/store';
7
+ import { Params, NavigationExtras, RouterStateSnapshot, NavigationStart, RoutesRecognized, NavigationCancel, NavigationError, ResolveEnd, NavigationEnd, ActivatedRouteSnapshot, Router } from '@angular/router';
8
+
9
+ declare class NgxsRouterPluginModule {
10
+ static forRoot(options?: NgxsRouterPluginOptions): ModuleWithProviders<NgxsRouterPluginModule>;
11
+ static ɵfac: i0.ɵɵFactoryDeclaration<NgxsRouterPluginModule, never>;
12
+ static ɵmod: i0.ɵɵNgModuleDeclaration<NgxsRouterPluginModule, never, [typeof i1.ɵNgxsFeatureModule], never>;
13
+ static ɵinj: i0.ɵɵInjectorDeclaration<NgxsRouterPluginModule>;
14
+ }
15
+ declare function withNgxsRouterPlugin(options?: NgxsRouterPluginOptions): EnvironmentProviders;
16
+
1
17
  /**
2
- * The public api for consumers of @ngxs/router-plugin
18
+ * Public event api of the router
3
19
  */
4
- export * from './src/public_api';
20
+ declare class Navigate {
21
+ path: any[];
22
+ queryParams?: Params | undefined;
23
+ extras?: NavigationExtras | undefined;
24
+ static readonly type = "[Router] Navigate";
25
+ constructor(path: any[], queryParams?: Params | undefined, extras?: NavigationExtras | undefined);
26
+ }
27
+ /**
28
+ *
29
+ * Angular Routers internal state events
30
+ *
31
+ */
32
+ /**
33
+ * An action dispatched when the router starts the navigation.
34
+ */
35
+ declare class RouterRequest<T = RouterStateSnapshot> {
36
+ routerState: T;
37
+ event: NavigationStart;
38
+ trigger: RouterTrigger;
39
+ static readonly type = "[Router] RouterRequest";
40
+ constructor(routerState: T, event: NavigationStart, trigger?: RouterTrigger);
41
+ }
42
+ /**
43
+ * An action dispatched when the router navigates.
44
+ */
45
+ declare class RouterNavigation<T = RouterStateSnapshot> {
46
+ routerState: T;
47
+ event: RoutesRecognized;
48
+ trigger: RouterTrigger;
49
+ static readonly type = "[Router] RouterNavigation";
50
+ constructor(routerState: T, event: RoutesRecognized, trigger?: RouterTrigger);
51
+ }
52
+ /**
53
+ * An action dispatched when the router cancel navigation.
54
+ */
55
+ declare class RouterCancel<T, V = RouterStateSnapshot> {
56
+ routerState: V;
57
+ storeState: T;
58
+ event: NavigationCancel;
59
+ trigger: RouterTrigger;
60
+ static readonly type = "[Router] RouterCancel";
61
+ constructor(routerState: V, storeState: T, event: NavigationCancel, trigger?: RouterTrigger);
62
+ }
63
+ /**
64
+ * An action dispatched when the router errors.
65
+ */
66
+ declare class RouterError<T, V = RouterStateSnapshot> {
67
+ routerState: V;
68
+ storeState: T;
69
+ event: NavigationError;
70
+ trigger: RouterTrigger;
71
+ static readonly type = "[Router] RouterError";
72
+ constructor(routerState: V, storeState: T, event: NavigationError, trigger?: RouterTrigger);
73
+ }
74
+ /**
75
+ * An action dispatched when the `ResolveEnd` event is triggered.
76
+ */
77
+ declare class RouterDataResolved<T = RouterStateSnapshot> {
78
+ routerState: T;
79
+ event: ResolveEnd;
80
+ trigger: RouterTrigger;
81
+ static readonly type = "[Router] RouterDataResolved";
82
+ constructor(routerState: T, event: ResolveEnd, trigger?: RouterTrigger);
83
+ }
84
+ /**
85
+ * An action dispatched when the router navigation has been finished successfully.
86
+ */
87
+ declare class RouterNavigated<T = RouterStateSnapshot> {
88
+ routerState: T;
89
+ event: NavigationEnd;
90
+ trigger: RouterTrigger;
91
+ static readonly type = "[Router] RouterNavigated";
92
+ constructor(routerState: T, event: NavigationEnd, trigger?: RouterTrigger);
93
+ }
94
+ /**
95
+ * An union type of router actions.
96
+ */
97
+ type RouterAction<T, V = RouterStateSnapshot> = RouterRequest<V> | RouterNavigation<V> | RouterCancel<T, V> | RouterError<T, V> | RouterDataResolved<V> | RouterNavigated<V>;
98
+
99
+ declare abstract class RouterStateSerializer<T> {
100
+ abstract serialize(routerState: RouterStateSnapshot): T;
101
+ }
102
+ interface SerializedRouterStateSnapshot {
103
+ root: ActivatedRouteSnapshot;
104
+ url: string;
105
+ }
106
+ declare class DefaultRouterStateSerializer implements RouterStateSerializer<SerializedRouterStateSnapshot> {
107
+ serialize(routerState: RouterStateSnapshot): SerializedRouterStateSnapshot;
108
+ private serializeRoute;
109
+ }
110
+
111
+ interface RouterStateModel<T = RouterStateSnapshot> {
112
+ state?: T;
113
+ navigationId?: number;
114
+ trigger: RouterTrigger;
115
+ }
116
+ type RouterTrigger = 'none' | 'router' | 'store' | 'devtools';
117
+ declare const ROUTER_STATE_TOKEN: StateToken<RouterStateModel<RouterStateSnapshot>>;
118
+ declare class RouterState implements OnDestroy {
119
+ private _store;
120
+ private _router;
121
+ private _serializer;
122
+ private _ngZone;
123
+ /**
124
+ * Determines how navigation was performed by the `RouterState` itself
125
+ * or outside via `new Navigate(...)`
126
+ */
127
+ private _trigger;
128
+ /**
129
+ * That's the serialized state from the `Router` class
130
+ */
131
+ private _routerState;
132
+ /**
133
+ * That's the value of the `RouterState` state
134
+ */
135
+ private _storeState;
136
+ private _lastEvent;
137
+ private _options;
138
+ private _destroy$;
139
+ static state<T = RouterStateSnapshot>(state: RouterStateModel<T>): T | undefined;
140
+ static url(state: RouterStateModel): string | undefined;
141
+ constructor(_store: Store, _router: Router, _serializer: RouterStateSerializer<RouterStateSnapshot>, _ngZone: NgZone, injector: Injector);
142
+ ngOnDestroy(): void;
143
+ navigate(_: StateContext<RouterStateModel>, action: Navigate): Promise<boolean>;
144
+ angularRouterAction(ctx: StateContext<RouterStateModel>, action: RouterAction<RouterStateModel, RouterStateSnapshot>): void;
145
+ private _setUpStoreListener;
146
+ private _navigateIfNeeded;
147
+ private _setUpRouterEventsListener;
148
+ /** Reacts to `NavigationStart`. */
149
+ private _navigationStart;
150
+ /** Reacts to `ResolveEnd`. */
151
+ private _dispatchRouterDataResolved;
152
+ /** Reacts to `RoutesRecognized` or `NavigationEnd`, depends on the `navigationActionTiming`. */
153
+ private _dispatchRouterNavigation;
154
+ /** Reacts to `NavigationCancel`. */
155
+ private _dispatchRouterCancel;
156
+ /** Reacts to `NavigationEnd`. */
157
+ private _dispatchRouterError;
158
+ /** Reacts to `NavigationEnd`. */
159
+ private _dispatchRouterNavigated;
160
+ private _dispatchRouterAction;
161
+ private _reset;
162
+ static ɵfac: i0.ɵɵFactoryDeclaration<RouterState, never>;
163
+ static ɵprov: i0.ɵɵInjectableDeclaration<RouterState>;
164
+ }
165
+
166
+ export { DefaultRouterStateSerializer, Navigate, NgxsRouterPluginModule, ROUTER_STATE_TOKEN, type RouterAction, RouterCancel, RouterDataResolved, RouterError, RouterNavigated, RouterNavigation, RouterRequest, RouterState, type RouterStateModel, RouterStateSerializer, type SerializedRouterStateSnapshot, withNgxsRouterPlugin };
@@ -1 +1,14 @@
1
- export * from './symbols';
1
+ import { InjectionToken } from '@angular/core';
2
+
3
+ declare const enum NavigationActionTiming {
4
+ PreActivation = 1,
5
+ PostActivation = 2
6
+ }
7
+ interface NgxsRouterPluginOptions {
8
+ navigationActionTiming?: NavigationActionTiming;
9
+ }
10
+ declare const ɵUSER_OPTIONS: InjectionToken<NgxsRouterPluginOptions | undefined>;
11
+ declare const ɵNGXS_ROUTER_PLUGIN_OPTIONS: InjectionToken<NgxsRouterPluginOptions>;
12
+ declare function ɵcreateRouterPluginOptions(options: NgxsRouterPluginOptions | undefined): NgxsRouterPluginOptions;
13
+
14
+ export { NavigationActionTiming, type NgxsRouterPluginOptions, ɵNGXS_ROUTER_PLUGIN_OPTIONS, ɵUSER_OPTIONS, ɵcreateRouterPluginOptions };
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "@ngxs/router-plugin",
3
3
  "description": "router plugin for @ngxs/store",
4
- "version": "18.1.2",
4
+ "version": "18.1.3",
5
5
  "sideEffects": false,
6
6
  "peerDependencies": {
7
- "@ngxs/store": "^18.1.2 || ^18.1.2-dev",
7
+ "@ngxs/store": "^18.1.3 || ^18.1.3-dev",
8
8
  "@angular/core": ">=16.0.0 <19.0.0",
9
9
  "@angular/router": ">=16.0.0 <19.0.0",
10
10
  "rxjs": ">=6.5.5"
@@ -1,11 +0,0 @@
1
- import { InjectionToken } from '@angular/core';
2
- export declare const enum NavigationActionTiming {
3
- PreActivation = 1,
4
- PostActivation = 2
5
- }
6
- export interface NgxsRouterPluginOptions {
7
- navigationActionTiming?: NavigationActionTiming;
8
- }
9
- export declare const ɵUSER_OPTIONS: InjectionToken<NgxsRouterPluginOptions | undefined>;
10
- export declare const ɵNGXS_ROUTER_PLUGIN_OPTIONS: InjectionToken<NgxsRouterPluginOptions>;
11
- export declare function ɵcreateRouterPluginOptions(options: NgxsRouterPluginOptions | undefined): NgxsRouterPluginOptions;
@@ -1,5 +0,0 @@
1
- export { NgxsRouterPluginModule, withNgxsRouterPlugin } from './router.module';
2
- export { ROUTER_STATE_TOKEN, RouterState, RouterStateModel } from './router.state';
3
- export { RouterStateSerializer, DefaultRouterStateSerializer, SerializedRouterStateSnapshot } from './serializer';
4
- export * from './router.actions';
5
- export { NavigationActionTiming, NgxsRouterPluginOptions } from '@ngxs/router-plugin/internals';
@@ -1,83 +0,0 @@
1
- import { NavigationCancel, NavigationError, NavigationExtras, Params, RouterStateSnapshot, RoutesRecognized, ResolveEnd, NavigationStart, NavigationEnd } from '@angular/router';
2
- import { RouterTrigger } from './router.state';
3
- /**
4
- * Public event api of the router
5
- */
6
- export declare class Navigate {
7
- path: any[];
8
- queryParams?: Params | undefined;
9
- extras?: NavigationExtras | undefined;
10
- static readonly type = "[Router] Navigate";
11
- constructor(path: any[], queryParams?: Params | undefined, extras?: NavigationExtras | undefined);
12
- }
13
- /**
14
- *
15
- * Angular Routers internal state events
16
- *
17
- */
18
- /**
19
- * An action dispatched when the router starts the navigation.
20
- */
21
- export declare class RouterRequest<T = RouterStateSnapshot> {
22
- routerState: T;
23
- event: NavigationStart;
24
- trigger: RouterTrigger;
25
- static readonly type = "[Router] RouterRequest";
26
- constructor(routerState: T, event: NavigationStart, trigger?: RouterTrigger);
27
- }
28
- /**
29
- * An action dispatched when the router navigates.
30
- */
31
- export declare class RouterNavigation<T = RouterStateSnapshot> {
32
- routerState: T;
33
- event: RoutesRecognized;
34
- trigger: RouterTrigger;
35
- static readonly type = "[Router] RouterNavigation";
36
- constructor(routerState: T, event: RoutesRecognized, trigger?: RouterTrigger);
37
- }
38
- /**
39
- * An action dispatched when the router cancel navigation.
40
- */
41
- export declare class RouterCancel<T, V = RouterStateSnapshot> {
42
- routerState: V;
43
- storeState: T;
44
- event: NavigationCancel;
45
- trigger: RouterTrigger;
46
- static readonly type = "[Router] RouterCancel";
47
- constructor(routerState: V, storeState: T, event: NavigationCancel, trigger?: RouterTrigger);
48
- }
49
- /**
50
- * An action dispatched when the router errors.
51
- */
52
- export declare class RouterError<T, V = RouterStateSnapshot> {
53
- routerState: V;
54
- storeState: T;
55
- event: NavigationError;
56
- trigger: RouterTrigger;
57
- static readonly type = "[Router] RouterError";
58
- constructor(routerState: V, storeState: T, event: NavigationError, trigger?: RouterTrigger);
59
- }
60
- /**
61
- * An action dispatched when the `ResolveEnd` event is triggered.
62
- */
63
- export declare class RouterDataResolved<T = RouterStateSnapshot> {
64
- routerState: T;
65
- event: ResolveEnd;
66
- trigger: RouterTrigger;
67
- static readonly type = "[Router] RouterDataResolved";
68
- constructor(routerState: T, event: ResolveEnd, trigger?: RouterTrigger);
69
- }
70
- /**
71
- * An action dispatched when the router navigation has been finished successfully.
72
- */
73
- export declare class RouterNavigated<T = RouterStateSnapshot> {
74
- routerState: T;
75
- event: NavigationEnd;
76
- trigger: RouterTrigger;
77
- static readonly type = "[Router] RouterNavigated";
78
- constructor(routerState: T, event: NavigationEnd, trigger?: RouterTrigger);
79
- }
80
- /**
81
- * An union type of router actions.
82
- */
83
- export type RouterAction<T, V = RouterStateSnapshot> = RouterRequest<V> | RouterNavigation<V> | RouterCancel<T, V> | RouterError<T, V> | RouterDataResolved<V> | RouterNavigated<V>;
@@ -1,11 +0,0 @@
1
- import { EnvironmentProviders, ModuleWithProviders } from '@angular/core';
2
- import { NgxsRouterPluginOptions } from '@ngxs/router-plugin/internals';
3
- import * as i0 from "@angular/core";
4
- import * as i1 from "@ngxs/store";
5
- export declare class NgxsRouterPluginModule {
6
- static forRoot(options?: NgxsRouterPluginOptions): ModuleWithProviders<NgxsRouterPluginModule>;
7
- static ɵfac: i0.ɵɵFactoryDeclaration<NgxsRouterPluginModule, never>;
8
- static ɵmod: i0.ɵɵNgModuleDeclaration<NgxsRouterPluginModule, never, [typeof i1.ɵNgxsFeatureModule], never>;
9
- static ɵinj: i0.ɵɵInjectorDeclaration<NgxsRouterPluginModule>;
10
- }
11
- export declare function withNgxsRouterPlugin(options?: NgxsRouterPluginOptions): EnvironmentProviders;
@@ -1,60 +0,0 @@
1
- import { NgZone, OnDestroy, Injector } from '@angular/core';
2
- import { Router, RouterStateSnapshot } from '@angular/router';
3
- import { StateContext, StateToken, Store } from '@ngxs/store';
4
- import { Navigate, RouterAction } from './router.actions';
5
- import { RouterStateSerializer } from './serializer';
6
- import * as i0 from "@angular/core";
7
- export interface RouterStateModel<T = RouterStateSnapshot> {
8
- state?: T;
9
- navigationId?: number;
10
- trigger: RouterTrigger;
11
- }
12
- export type RouterTrigger = 'none' | 'router' | 'store' | 'devtools';
13
- export declare const ROUTER_STATE_TOKEN: StateToken<RouterStateModel<RouterStateSnapshot>>;
14
- export declare class RouterState implements OnDestroy {
15
- private _store;
16
- private _router;
17
- private _serializer;
18
- private _ngZone;
19
- /**
20
- * Determines how navigation was performed by the `RouterState` itself
21
- * or outside via `new Navigate(...)`
22
- */
23
- private _trigger;
24
- /**
25
- * That's the serialized state from the `Router` class
26
- */
27
- private _routerState;
28
- /**
29
- * That's the value of the `RouterState` state
30
- */
31
- private _storeState;
32
- private _lastEvent;
33
- private _options;
34
- private _destroy$;
35
- static state<T = RouterStateSnapshot>(state: RouterStateModel<T>): T | undefined;
36
- static url(state: RouterStateModel): string | undefined;
37
- constructor(_store: Store, _router: Router, _serializer: RouterStateSerializer<RouterStateSnapshot>, _ngZone: NgZone, injector: Injector);
38
- ngOnDestroy(): void;
39
- navigate(_: StateContext<RouterStateModel>, action: Navigate): Promise<boolean>;
40
- angularRouterAction(ctx: StateContext<RouterStateModel>, action: RouterAction<RouterStateModel, RouterStateSnapshot>): void;
41
- private _setUpStoreListener;
42
- private _navigateIfNeeded;
43
- private _setUpRouterEventsListener;
44
- /** Reacts to `NavigationStart`. */
45
- private _navigationStart;
46
- /** Reacts to `ResolveEnd`. */
47
- private _dispatchRouterDataResolved;
48
- /** Reacts to `RoutesRecognized` or `NavigationEnd`, depends on the `navigationActionTiming`. */
49
- private _dispatchRouterNavigation;
50
- /** Reacts to `NavigationCancel`. */
51
- private _dispatchRouterCancel;
52
- /** Reacts to `NavigationEnd`. */
53
- private _dispatchRouterError;
54
- /** Reacts to `NavigationEnd`. */
55
- private _dispatchRouterNavigated;
56
- private _dispatchRouterAction;
57
- private _reset;
58
- static ɵfac: i0.ɵɵFactoryDeclaration<RouterState, never>;
59
- static ɵprov: i0.ɵɵInjectableDeclaration<RouterState>;
60
- }
@@ -1,12 +0,0 @@
1
- import { ActivatedRouteSnapshot, RouterStateSnapshot } from '@angular/router';
2
- export declare abstract class RouterStateSerializer<T> {
3
- abstract serialize(routerState: RouterStateSnapshot): T;
4
- }
5
- export interface SerializedRouterStateSnapshot {
6
- root: ActivatedRouteSnapshot;
7
- url: string;
8
- }
9
- export declare class DefaultRouterStateSerializer implements RouterStateSerializer<SerializedRouterStateSnapshot> {
10
- serialize(routerState: RouterStateSnapshot): SerializedRouterStateSnapshot;
11
- private serializeRoute;
12
- }