@ngxs/store 19.0.0-dev.master-287dcb1 → 19.0.0-dev.master-f0409e4

package/index.d.ts

@@ -520,6 +520,9 @@ declare function provideStore(states?: _StateClass[], options?: NgxsModuleOption
  *   }
  * ];
  * ```
+ *
+ * To lazy-load feature states at the route level,
+ * please refer to the `lazyProvider` utility function.
  */
 declare function provideStates(states: _StateClass[], ...features: EnvironmentProviders[]): EnvironmentProviders;
 
@@ -584,6 +587,39 @@ declare function createSelectMap<T extends SelectorMap>(selectorMap: T): { reado
 type ActionMap = Record<string, ActionDef<any>>;
 declare function createDispatchMap<T extends ActionMap>(actionMap: T): { readonly [K in keyof T]: (...args: ConstructorParameters<T[K]>) => Observable<void>; };
 
+interface DefaultExport<T> {
+    default: T;
+}
+/**
+ * This function serves as a utility to lazy-load providers at the injection
+ * context level — for example, at the route level. If the feature state needs
+ * to be provided in more than one place, it might be indirectly included in
+ * the main bundle, which we want to avoid. This function can be used at the
+ * guard level to lazy-load the state provider before resolvers run and the
+ * component is initialized:
+ *
+ * ```ts
+ * const routes = [
+ *   {
+ *     path: 'home',
+ *     loadComponent: () => import(...),
+ *     canActivate: [
+ *       lazyProvider(async () => (await import('path-to-state-library')).invoicesStateProvider)
+ *     ]
+ *   }
+ * ];
+ * ```
+ *
+ * Where `invoicesStateProvider` is the following:
+ *
+ * ```ts
+ * // path-to-state-library/index.ts
+ *
+ * export const invoicesStateProvider = provideStates([InvoicesState]);
+ * ```
+ */
+declare function lazyProvider(factory: () => Promise<EnvironmentProviders | DefaultExport<EnvironmentProviders>>): () => Promise<boolean>;
+
 declare function ɵprovideNgxsInternalStateTokens(): i0.EnvironmentProviders;
 
-export { Action, type ActionCompletion, type ActionContext, type ActionDef, type ActionMap, ActionStatus, type ActionType, Actions, type NgxsAfterBootstrap, NgxsConfig, NgxsDevelopmentModule, type NgxsDevelopmentOptions, NgxsModule, type NgxsModuleOptions, type NgxsOnChanges, type NgxsOnInit, NgxsSimpleChange, NgxsUnhandledActionsLogger, type NgxsUnhandledErrorContext, NgxsUnhandledErrorHandler, type PropertySelectors, Select, Selector, type SelectorMap, SelectorOptions, State, type StateContext, Store, type TypedSelector, createDispatchMap, createModelSelector, createPickSelector, createPropertySelectors, createSelectMap, createSelector, dispatch, ofAction, ofActionCanceled, ofActionCompleted, ofActionDispatched, ofActionErrored, ofActionSuccessful, provideStates, provideStore, select, withNgxsDevelopmentOptions, withNgxsPendingTasks, withNgxsPlugin, withNgxsPreboot, NgxsFeatureModule as ɵNgxsFeatureModule, NgxsRootModule as ɵNgxsRootModule, type ɵSelectorDef, type ɵSelectorFunc, type ɵSelectorReturnType, type ɵStateSelector, ɵprovideNgxsInternalStateTokens };
+export { Action, type ActionCompletion, type ActionContext, type ActionDef, type ActionMap, ActionStatus, type ActionType, Actions, type NgxsAfterBootstrap, NgxsConfig, NgxsDevelopmentModule, type NgxsDevelopmentOptions, NgxsModule, type NgxsModuleOptions, type NgxsOnChanges, type NgxsOnInit, NgxsSimpleChange, NgxsUnhandledActionsLogger, type NgxsUnhandledErrorContext, NgxsUnhandledErrorHandler, type PropertySelectors, Select, Selector, type SelectorMap, SelectorOptions, State, type StateContext, Store, type TypedSelector, createDispatchMap, createModelSelector, createPickSelector, createPropertySelectors, createSelectMap, createSelector, dispatch, lazyProvider, ofAction, ofActionCanceled, ofActionCompleted, ofActionDispatched, ofActionErrored, ofActionSuccessful, provideStates, provideStore, select, withNgxsDevelopmentOptions, withNgxsPendingTasks, withNgxsPlugin, withNgxsPreboot, NgxsFeatureModule as ɵNgxsFeatureModule, NgxsRootModule as ɵNgxsRootModule, type ɵSelectorDef, type ɵSelectorFunc, type ɵSelectorReturnType, type ɵStateSelector, ɵprovideNgxsInternalStateTokens };

package/internals/index.d.ts

@@ -201,8 +201,6 @@ declare class ɵStateStream extends ɵOrderedBehaviorSubject<ɵPlainObject> {
     static ɵprov: i0.ɵɵInjectableDeclaration<ɵStateStream>;
 }
 
-declare function ɵof<T>(value: T): Observable<T>;
-
 declare const ɵhasOwnProperty: (target: any, key: PropertyKey) => boolean;
 declare const ɵdefineProperty: <T>(o: T, p: PropertyKey, attributes: PropertyDescriptor & ThisType<any>) => T;
 
@@ -216,4 +214,4 @@ declare class ɵNgxsActionRegistry {
     static ɵprov: i0.ɵɵInjectableDeclaration<ɵNgxsActionRegistry>;
 }
 
-export { StateToken, type ɵActionHandlerMetaData, type ɵActionOptions, type ɵExtractTokenType, ɵINITIAL_STATE_TOKEN, ɵInitialState, ɵMETA_KEY, ɵMETA_OPTIONS_KEY, type ɵMetaDataModel, ɵNGXS_STATE_CONTEXT_FACTORY, ɵNGXS_STATE_FACTORY, ɵNgxsActionRegistry, ɵNgxsAppBootstrappedState, ɵOrderedBehaviorSubject, ɵOrderedSubject, type ɵPlainObject, type ɵPlainObjectOf, type ɵRuntimeSelectorContext, ɵSELECTOR_META_KEY, type ɵSelectFromRootState, type ɵSelectorFactory, type ɵSelectorMetaDataModel, type ɵSharedSelectorOptions, type ɵStateClass, type ɵStateClassInternal, ɵStateStream, type ɵStateToken, type ɵStoreOptions, type ɵTokenName, ɵdefineProperty, ɵensureSelectorMetadata, ɵensureStoreMetadata, ɵgetSelectorMetadata, ɵgetStoreMetadata, ɵhasOwnProperty, ɵmemoize, ɵof, ɵwrapObserverCalls };
+export { StateToken, type ɵActionHandlerMetaData, type ɵActionOptions, type ɵExtractTokenType, ɵINITIAL_STATE_TOKEN, ɵInitialState, ɵMETA_KEY, ɵMETA_OPTIONS_KEY, type ɵMetaDataModel, ɵNGXS_STATE_CONTEXT_FACTORY, ɵNGXS_STATE_FACTORY, ɵNgxsActionRegistry, ɵNgxsAppBootstrappedState, ɵOrderedBehaviorSubject, ɵOrderedSubject, type ɵPlainObject, type ɵPlainObjectOf, type ɵRuntimeSelectorContext, ɵSELECTOR_META_KEY, type ɵSelectFromRootState, type ɵSelectorFactory, type ɵSelectorMetaDataModel, type ɵSharedSelectorOptions, type ɵStateClass, type ɵStateClassInternal, ɵStateStream, type ɵStateToken, type ɵStoreOptions, type ɵTokenName, ɵdefineProperty, ɵensureSelectorMetadata, ɵensureStoreMetadata, ɵgetSelectorMetadata, ɵgetStoreMetadata, ɵhasOwnProperty, ɵmemoize, ɵwrapObserverCalls };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngxs/store",
-  "version": "19.0.0-dev.master-287dcb1",
+  "version": "19.0.0-dev.master-f0409e4",
   "license": "MIT",
   "sideEffects": false,
   "peerDependencies": {