@ngxs/store 19.0.0-dev.master-5c4900f → 19.0.0-dev.master-81c7a7c

package/fesm2022/ngxs-store.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Injectable, inject, NgZone, InjectionToken, INJECTOR, DestroyRef, Injector, runInInjectionContext, ErrorHandler, ɵisPromise as _isPromise, computed, makeEnvironmentProviders, ENVIRONMENT_INITIALIZER, NgModule, APP_BOOTSTRAP_LISTENER, ApplicationRef, PendingTasks } from '@angular/core';
+import { inject, Injectable, InjectionToken, DestroyRef, NgZone, Injector, runInInjectionContext, ErrorHandler, ɵisPromise as _isPromise, computed, makeEnvironmentProviders, provideEnvironmentInitializer, NgModule, APP_BOOTSTRAP_LISTENER, ApplicationRef, PendingTasks } from '@angular/core';
 import { config, Observable, Subject, share, forkJoin, map, throwError, shareReplay, filter, take, mergeMap, EMPTY, defaultIfEmpty, catchError, from, isObservable, takeUntil, finalize, distinctUntilChanged, startWith, skip, buffer, debounceTime } from 'rxjs';
 import { ɵwrapObserverCalls as _wrapObserverCalls, ɵOrderedSubject as _OrderedSubject, ɵStateStream as _StateStream, ɵof as _of, ɵmemoize as _memoize, ɵgetStoreMetadata as _getStoreMetadata, ɵgetSelectorMetadata as _getSelectorMetadata, ɵMETA_KEY as _META_KEY, ɵINITIAL_STATE_TOKEN as _INITIAL_STATE_TOKEN, ɵNgxsAppBootstrappedState as _NgxsAppBootstrappedState, ɵensureStoreMetadata as _ensureStoreMetadata, ɵMETA_OPTIONS_KEY as _META_OPTIONS_KEY, ɵensureSelectorMetadata as _ensureSelectorMetadata, ɵNGXS_STATE_CONTEXT_FACTORY as _NGXS_STATE_CONTEXT_FACTORY, ɵNGXS_STATE_FACTORY as _NGXS_STATE_FACTORY } from '@ngxs/store/internals';
 export { StateToken } from '@ngxs/store/internals';
@@ -7,159 +7,6 @@ import { NGXS_PLUGINS, getActionTypeFromInstance, InitState, UpdateState, setVal
 export { InitState, NGXS_PLUGINS, UpdateState, actionMatcher, getActionTypeFromInstance, getValue, setValue } from '@ngxs/store/plugins';
 import { isStateOperator } from '@ngxs/store/operators';
 
-class NoopNgxsExecutionStrategy {
-    enter(func) {
-        return func();
-    }
-    leave(func) {
-        return func();
-    }
-    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NoopNgxsExecutionStrategy, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NoopNgxsExecutionStrategy, providedIn: 'root' }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NoopNgxsExecutionStrategy, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }] });
-
-function throwStateNameError(name) {
-    throw new Error(`${name} is not a valid state name. It needs to be a valid object property name.`);
-}
-function throwStateNamePropertyError() {
-    throw new Error(`States must register a 'name' property.`);
-}
-function throwStateUniqueError(current, newName, oldName) {
-    throw new Error(`State name '${current}' from ${newName} already exists in ${oldName}.`);
-}
-function throwStateDecoratorError(name) {
-    throw new Error(`States must be decorated with @State() decorator, but "${name}" isn't.`);
-}
-function throwActionDecoratorError() {
-    throw new Error('@Action() decorator cannot be used with static methods.');
-}
-function throwSelectorDecoratorError() {
-    throw new Error('Selectors only work on methods.');
-}
-function getZoneWarningMessage() {
-    return ('Your application was bootstrapped with nooped zone and your execution strategy requires an actual NgZone!\n' +
-        'Please set the value of the executionStrategy property to NoopNgxsExecutionStrategy.\n' +
-        'NgxsModule.forRoot(states, { executionStrategy: NoopNgxsExecutionStrategy })');
-}
-function getUndecoratedStateWithInjectableWarningMessage(name) {
-    return `'${name}' class should be decorated with @Injectable() right after the @State() decorator`;
-}
-function getInvalidInitializationOrderMessage(addedStates) {
-    let message = 'You have an invalid state initialization order. This typically occurs when `NgxsModule.forFeature`\n' +
-        'or `provideStates` is called before `NgxsModule.forRoot` or `provideStore`.\n' +
-        'One example is when `NgxsRouterPluginModule.forRoot` is called before `NgxsModule.forRoot`.';
-    if (addedStates) {
-        const stateNames = Object.keys(addedStates).map(stateName => `"${stateName}"`);
-        message +=
-            '\nFeature states added before the store initialization is complete: ' +
-                `${stateNames.join(', ')}.`;
-    }
-    return message;
-}
-function throwSelectFactoryNotConnectedError() {
-    throw new Error('You have forgotten to import the NGXS module!');
-}
-function throwPatchingArrayError() {
-    throw new Error('Patching arrays is not supported.');
-}
-function throwPatchingPrimitiveError() {
-    throw new Error('Patching primitives is not supported.');
-}
-
-class DispatchOutsideZoneNgxsExecutionStrategy {
-    constructor() {
-        this._ngZone = inject(NgZone);
-        if (typeof ngDevMode !== 'undefined' && ngDevMode) {
-            verifyZoneIsNotNooped(this._ngZone);
-        }
-    }
-    enter(func) {
-        if (typeof ngServerMode !== 'undefined' && ngServerMode) {
-            return this.runInsideAngular(func);
-        }
-        return this.runOutsideAngular(func);
-    }
-    leave(func) {
-        return this.runInsideAngular(func);
-    }
-    runInsideAngular(func) {
-        if (NgZone.isInAngularZone()) {
-            return func();
-        }
-        return this._ngZone.run(func);
-    }
-    runOutsideAngular(func) {
-        if (NgZone.isInAngularZone()) {
-            return this._ngZone.runOutsideAngular(func);
-        }
-        return func();
-    }
-    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: DispatchOutsideZoneNgxsExecutionStrategy, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: DispatchOutsideZoneNgxsExecutionStrategy, providedIn: 'root' }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: DispatchOutsideZoneNgxsExecutionStrategy, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }], ctorParameters: () => [] });
-// Caretaker note: this should exist as a separate function and not a class method,
-// since class methods are not tree-shakable.
-function verifyZoneIsNotNooped(ngZone) {
-    // `NoopNgZone` is not exposed publicly as it doesn't expect
-    // to be used outside of the core Angular code, thus we just have
-    // to check if the zone doesn't extend or instanceof `NgZone`.
-    if (ngZone instanceof NgZone) {
-        return;
-    }
-    console.warn(getZoneWarningMessage());
-}
-
-/**
- * Consumers have the option to utilize the execution strategy provided by
- * `NgxsModule.forRoot({executionStrategy})` or `provideStore([], {executionStrategy})`.
- */
-const CUSTOM_NGXS_EXECUTION_STRATEGY = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'CUSTOM_NGXS_EXECUTION_STRATEGY' : '');
-/**
- * The injection token is used internally to resolve an instance of the execution
- * strategy. It checks whether consumers have provided their own `executionStrategy`
- * and also verifies if we are operating in a zone-aware environment.
- */
-const NGXS_EXECUTION_STRATEGY = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'NGXS_EXECUTION_STRATEGY' : '', {
-    providedIn: 'root',
-    factory: () => {
-        const ngZone = inject(NgZone);
-        const injector = inject(INJECTOR);
-        const executionStrategy = injector.get(CUSTOM_NGXS_EXECUTION_STRATEGY);
-        const isNgZoneEnabled = ngZone instanceof NgZone;
-        return executionStrategy
-            ? injector.get(executionStrategy)
-            : injector.get(isNgZoneEnabled
-                ? DispatchOutsideZoneNgxsExecutionStrategy
-                : NoopNgxsExecutionStrategy);
-    }
-});
-
-class InternalNgxsExecutionStrategy {
-    constructor() {
-        this._executionStrategy = inject(NGXS_EXECUTION_STRATEGY);
-    }
-    enter(func) {
-        return this._executionStrategy.enter(func);
-    }
-    leave(func) {
-        return this._executionStrategy.leave(func);
-    }
-    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: InternalNgxsExecutionStrategy, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: InternalNgxsExecutionStrategy, providedIn: 'root' }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: InternalNgxsExecutionStrategy, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }] });
-
 class PluginManager {
     constructor() {
         this.plugins = [];
@@ -271,6 +118,90 @@ function fallbackSubscriber(ngZone) {
     };
 }
 
+// The injection token is used to resolve a list of states provided at
+// the root level through either `NgxsModule.forRoot` or `provideStore`.
+const ROOT_STATE_TOKEN = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'ROOT_STATE_TOKEN' : '');
+// The injection token is used to resolve a list of states provided at
+// the feature level through either `NgxsModule.forFeature` or `provideStates`.
+// The Array<Array> is used to overload the resolved value of the token because
+// it is a multi-provider token.
+const FEATURE_STATE_TOKEN = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'FEATURE_STATE_TOKEN' : '');
+// The injection token is used to resolve to options provided at the root
+// level through either `NgxsModule.forRoot` or `provideStore`.
+const NGXS_OPTIONS = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'NGXS_OPTIONS' : '');
+/**
+ * The NGXS config settings.
+ */
+class NgxsConfig {
+    constructor() {
+        this.compatibility = {
+            strictContentSecurityPolicy: false
+        };
+        /**
+         * Defining shared selector options
+         */
+        this.selectorOptions = {
+            injectContainerState: false,
+            suppressErrors: false
+        };
+    }
+    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NgxsConfig, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NgxsConfig, providedIn: 'root', useFactory: () => {
+            const defaultConfig = new NgxsConfig();
+            const config = inject(NGXS_OPTIONS);
+            return {
+                ...defaultConfig,
+                ...config,
+                selectorOptions: {
+                    ...defaultConfig.selectorOptions,
+                    ...config.selectorOptions
+                }
+            };
+        } }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NgxsConfig, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                    useFactory: () => {
+                        const defaultConfig = new NgxsConfig();
+                        const config = inject(NGXS_OPTIONS);
+                        return {
+                            ...defaultConfig,
+                            ...config,
+                            selectorOptions: {
+                                ...defaultConfig.selectorOptions,
+                                ...config.selectorOptions
+                            }
+                        };
+                    }
+                }]
+        }] });
+/**
+ * Represents a basic change from a previous to a new value for a single state instance.
+ * Passed as a value in a NgxsSimpleChanges object to the ngxsOnChanges hook.
+ */
+class NgxsSimpleChange {
+    constructor(previousValue, currentValue, firstChange) {
+        this.previousValue = previousValue;
+        this.currentValue = currentValue;
+        this.firstChange = firstChange;
+    }
+}
+
+/**
+ * The injection token is used internally to resolve an instance of the execution
+ * strategy. It checks whether consumers have provided their own `executionStrategy`
+ * and also verifies if we are operating in a zone-aware environment.
+ */
+const NGXS_EXECUTION_STRATEGY = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'NGXS_EXECUTION_STRATEGY' : '', {
+    providedIn: 'root',
+    factory: () => {
+        const options = inject(NGXS_OPTIONS);
+        return inject(options.executionStrategy);
+    }
+});
+
 /**
  * Internal Action result stream that is emitted when an action is completed.
  * This is used as a method of returning the action result to the dispatcher
@@ -331,7 +262,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImpor
 class Actions extends Observable {
     constructor() {
         const internalActions$ = inject(InternalActions);
-        const internalExecutionStrategy = inject(InternalNgxsExecutionStrategy);
+        const internalExecutionStrategy = inject(NGXS_EXECUTION_STRATEGY);
         const sharedInternalActions$ = internalActions$.pipe(leaveNgxs(internalExecutionStrategy), 
         // The `InternalActions` subject emits outside of the Angular zone.
         // We have to re-enter the Angular zone for any incoming consumer.
@@ -362,7 +293,7 @@ class InternalDispatcher {
         this._actionResults = inject(InternalDispatchedActionResults);
         this._pluginManager = inject(PluginManager);
         this._stateStream = inject(_StateStream);
-        this._ngxsExecutionStrategy = inject(InternalNgxsExecutionStrategy);
+        this._ngxsExecutionStrategy = inject(NGXS_EXECUTION_STRATEGY);
         this._injector = inject(Injector);
     }
     /**
@@ -455,89 +386,6 @@ const compose = (injector, funcs) => (...args) => {
     return runInInjectionContext(injector, () => curr(...args, (...nextArgs) => compose(injector, funcs)(...nextArgs)));
 };
 
-// The injection token is used to resolve a list of states provided at
-// the root level through either `NgxsModule.forRoot` or `provideStore`.
-const ROOT_STATE_TOKEN = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'ROOT_STATE_TOKEN' : '');
-// The injection token is used to resolve a list of states provided at
-// the feature level through either `NgxsModule.forFeature` or `provideStates`.
-// The Array<Array> is used to overload the resolved value of the token because
-// it is a multi-provider token.
-const FEATURE_STATE_TOKEN = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'FEATURE_STATE_TOKEN' : '');
-// The injection token is used to resolve to options provided at the root
-// level through either `NgxsModule.forRoot` or `provideStore`.
-const NGXS_OPTIONS = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'NGXS_OPTIONS' : '');
-/**
- * The NGXS config settings.
- */
-class NgxsConfig {
-    constructor() {
-        this.compatibility = {
-            strictContentSecurityPolicy: false
-        };
-        /**
-         * Determines the execution context to perform async operations inside. An implementation can be
-         * provided to override the default behaviour where the async operations are run
-         * outside Angular's zone but all observable behaviours of NGXS are run back inside Angular's zone.
-         * These observable behaviours are from:
-         *   `store.selectSignal(...)`, `store.select(...)`, `actions.subscribe(...)` or `store.dispatch(...).subscribe(...)`
-         * Every `zone.run` causes Angular to run change detection on the whole tree (`app.tick()`) so of your
-         * application doesn't rely on zone.js running change detection then you can switch to the
-         * `NoopNgxsExecutionStrategy` that doesn't interact with zones.
-         * (default: null)
-         */
-        this.executionStrategy = DispatchOutsideZoneNgxsExecutionStrategy;
-        /**
-         * Defining shared selector options
-         */
-        this.selectorOptions = {
-            injectContainerState: false,
-            suppressErrors: false
-        };
-    }
-    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NgxsConfig, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NgxsConfig, providedIn: 'root', useFactory: () => {
-            const defaultConfig = new NgxsConfig();
-            const config = inject(NGXS_OPTIONS);
-            return {
-                ...defaultConfig,
-                ...config,
-                selectorOptions: {
-                    ...defaultConfig.selectorOptions,
-                    ...config.selectorOptions
-                }
-            };
-        } }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NgxsConfig, decorators: [{
-            type: Injectable,
-            args: [{
-                    providedIn: 'root',
-                    useFactory: () => {
-                        const defaultConfig = new NgxsConfig();
-                        const config = inject(NGXS_OPTIONS);
-                        return {
-                            ...defaultConfig,
-                            ...config,
-                            selectorOptions: {
-                                ...defaultConfig.selectorOptions,
-                                ...config.selectorOptions
-                            }
-                        };
-                    }
-                }]
-        }] });
-/**
- * Represents a basic change from a previous to a new value for a single state instance.
- * Passed as a value in a NgxsSimpleChanges object to the ngxsOnChanges hook.
- */
-class NgxsSimpleChange {
-    constructor(previousValue, currentValue, firstChange) {
-        this.previousValue = previousValue;
-        this.currentValue = currentValue;
-        this.firstChange = firstChange;
-    }
-}
-
 /**
  * Object freeze code
  * https://github.com/jsdf/deep-freeze
@@ -938,6 +786,54 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImpor
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [] });
 
+function throwStateNameError(name) {
+    throw new Error(`${name} is not a valid state name. It needs to be a valid object property name.`);
+}
+function throwStateNamePropertyError() {
+    throw new Error(`States must register a 'name' property.`);
+}
+function throwStateUniqueError(current, newName, oldName) {
+    throw new Error(`State name '${current}' from ${newName} already exists in ${oldName}.`);
+}
+function throwStateDecoratorError(name) {
+    throw new Error(`States must be decorated with @State() decorator, but "${name}" isn't.`);
+}
+function throwActionDecoratorError() {
+    throw new Error('@Action() decorator cannot be used with static methods.');
+}
+function throwSelectorDecoratorError() {
+    throw new Error('Selectors only work on methods.');
+}
+function getZoneWarningMessage() {
+    return ('Your application was bootstrapped with nooped zone and your execution strategy requires an actual NgZone!\n' +
+        'Please set the value of the executionStrategy property to NoopNgxsExecutionStrategy.\n' +
+        'NgxsModule.forRoot(states, { executionStrategy: NoopNgxsExecutionStrategy })');
+}
+function getUndecoratedStateWithInjectableWarningMessage(name) {
+    return `'${name}' class should be decorated with @Injectable() right after the @State() decorator`;
+}
+function getInvalidInitializationOrderMessage(addedStates) {
+    let message = 'You have an invalid state initialization order. This typically occurs when `NgxsModule.forFeature`\n' +
+        'or `provideStates` is called before `NgxsModule.forRoot` or `provideStore`.\n' +
+        'One example is when `NgxsRouterPluginModule.forRoot` is called before `NgxsModule.forRoot`.';
+    if (addedStates) {
+        const stateNames = Object.keys(addedStates).map(stateName => `"${stateName}"`);
+        message +=
+            '\nFeature states added before the store initialization is complete: ' +
+                `${stateNames.join(', ')}.`;
+    }
+    return message;
+}
+function throwSelectFactoryNotConnectedError() {
+    throw new Error('You have forgotten to import the NGXS module!');
+}
+function throwPatchingArrayError() {
+    throw new Error('Patching arrays is not supported.');
+}
+function throwPatchingPrimitiveError() {
+    throw new Error('Patching primitives is not supported.');
+}
+
 const stateNameRegex = /* @__PURE__ */ new RegExp('^[a-zA-Z0-9_]+$');
 function ensureStateNameIsValid(name) {
     if (!name) {
@@ -1535,7 +1431,7 @@ class Store {
         this._stateStream = inject(_StateStream);
         this._internalStateOperations = inject(InternalStateOperations);
         this._config = inject(NgxsConfig);
-        this._internalExecutionStrategy = inject(InternalNgxsExecutionStrategy);
+        this._internalExecutionStrategy = inject(NGXS_EXECUTION_STRATEGY);
         this._stateFactory = inject(StateFactory);
         /**
          * This is a derived state stream that leaves NGXS execution strategy to emit state changes within the Angular zone,
@@ -1854,13 +1750,7 @@ const NGXS_ROOT_STORE_INITIALIZER = new InjectionToken(typeof ngDevMode !== 'und
 const NGXS_FEATURE_STORE_INITIALIZER = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'NGXS_FEATURE_STORE_INITIALIZER' : '');
 const NGXS_ROOT_ENVIRONMENT_INITIALIZER = [
     { provide: NGXS_ROOT_STORE_INITIALIZER, useFactory: rootStoreInitializer },
-    {
-        provide: ENVIRONMENT_INITIALIZER,
-        multi: true,
-        useFactory() {
-            return () => inject(NGXS_ROOT_STORE_INITIALIZER);
-        }
-    }
+    provideEnvironmentInitializer(() => inject(NGXS_ROOT_STORE_INITIALIZER))
 ];
 /**
  * The `NGXS_FEATURE_ENVIRONMENT_INITIALIZER` functions as an environment initializer
@@ -1870,13 +1760,7 @@ const NGXS_ROOT_ENVIRONMENT_INITIALIZER = [
  */
 const NGXS_FEATURE_ENVIRONMENT_INITIALIZER = [
     { provide: NGXS_FEATURE_STORE_INITIALIZER, useFactory: featureStatesInitializer },
-    {
-        provide: ENVIRONMENT_INITIALIZER,
-        multi: true,
-        useFactory() {
-            return () => inject(NGXS_FEATURE_STORE_INITIALIZER);
-        }
-    }
+    provideEnvironmentInitializer(() => inject(NGXS_FEATURE_STORE_INITIALIZER))
 ];
 
 /**
@@ -1931,10 +1815,6 @@ function getRootProviders(states, options) {
         {
             provide: NGXS_OPTIONS,
             useValue: options
-        },
-        {
-            provide: CUSTOM_NGXS_EXECUTION_STRATEGY,
-            useValue: options.executionStrategy
         }
     ];
 }
@@ -1956,7 +1836,7 @@ function getFeatureProviders(states) {
 }
 
 class NgxsModule {
-    static forRoot(states = [], options = {}) {
+    static forRoot(states = [], options) {
         return {
             ngModule: NgxsRootModule,
             providers: getRootProviders(states, options)
@@ -2180,6 +2060,68 @@ function Selector(selectors) {
     };
 }
 
+class DispatchOutsideZoneNgxsExecutionStrategy {
+    constructor() {
+        this._ngZone = inject(NgZone);
+        if (typeof ngDevMode !== 'undefined' && ngDevMode) {
+            verifyZoneIsNotNooped(this._ngZone);
+        }
+    }
+    enter(func) {
+        if (typeof ngServerMode !== 'undefined' && ngServerMode) {
+            return this.runInsideAngular(func);
+        }
+        return this.runOutsideAngular(func);
+    }
+    leave(func) {
+        return this.runInsideAngular(func);
+    }
+    runInsideAngular(func) {
+        if (NgZone.isInAngularZone()) {
+            return func();
+        }
+        return this._ngZone.run(func);
+    }
+    runOutsideAngular(func) {
+        if (NgZone.isInAngularZone()) {
+            return this._ngZone.runOutsideAngular(func);
+        }
+        return func();
+    }
+    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: DispatchOutsideZoneNgxsExecutionStrategy, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: DispatchOutsideZoneNgxsExecutionStrategy, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: DispatchOutsideZoneNgxsExecutionStrategy, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [] });
+// Caretaker note: this should exist as a separate function and not a class method,
+// since class methods are not tree-shakable.
+function verifyZoneIsNotNooped(ngZone) {
+    // `NoopNgZone` is not exposed publicly as it doesn't expect
+    // to be used outside of the core Angular code, thus we just have
+    // to check if the zone doesn't extend or instanceof `NgZone`.
+    if (ngZone instanceof NgZone) {
+        return;
+    }
+    console.warn(getZoneWarningMessage());
+}
+
+class NoopNgxsExecutionStrategy {
+    enter(func) {
+        return func();
+    }
+    leave(func) {
+        return func();
+    }
+    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NoopNgxsExecutionStrategy, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NoopNgxsExecutionStrategy, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: NoopNgxsExecutionStrategy, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
 class NgxsDevelopmentModule {
     static forRoot(options) {
         return {
@@ -2375,28 +2317,30 @@ function withNgxsPendingTasks() {
     });
 }
 
-function provideStore(states = [], ...optionsAndFeatures) {
-    const features = [];
-    // Options are empty by default (see `forRoot`).
-    let options = {};
-    if (optionsAndFeatures.length > 0) {
-        if (isEnvironmentProvider(optionsAndFeatures[0])) {
-            features.push(...optionsAndFeatures);
-        }
-        else {
-            options = optionsAndFeatures[0];
-            features.push(...optionsAndFeatures.slice(1));
-        }
-    }
+/**
+ * This function provides global store providers and initializes the store.
+ *
+ * ```ts
+ * bootstrapApplication(AppComponent, {
+ *   providers: [provideStore([CountriesState])]
+ * });
+ * ```
+ *
+ * The `provideStore` may be optionally called with a config before the list of features:
+ *
+ * ```ts
+ * provideStore([CountriesState], {
+ *   developmentMode: !environment.production
+ * });
+ * ```
+ */
+function provideStore(states = [], options, ...features) {
     return makeEnvironmentProviders([
         ...getRootProviders(states, options),
         NGXS_ROOT_ENVIRONMENT_INITIALIZER,
         features
     ]);
 }
-function isEnvironmentProvider(target) {
-    return !!target.ɵproviders;
-}
 
 /**
  * This version serves as a standalone alternative to `NgxsModule.forFeature`.
@@ -2443,11 +2387,7 @@ function withNgxsPlugin(plugin) {
         // We should inject the `PluginManager` to retrieve `NGXS_PLUGINS` and
         // register those plugins. The plugin can be added from inside the child
         // route, so the plugin manager should be re-injected.
-        {
-            provide: ENVIRONMENT_INITIALIZER,
-            useValue: () => inject(PluginManager),
-            multi: true
-        }
+        provideEnvironmentInitializer(() => inject(PluginManager))
     ]);
 }
 
@@ -2518,5 +2458,5 @@ function ɵprovideNgxsInternalStateTokens() {
  * Generated bundle index. Do not edit.
  */
 
-export { Action, Actions, NgxsConfig, NgxsDevelopmentModule, NgxsModule, NgxsSimpleChange, NgxsUnhandledActionsLogger, NgxsUnhandledErrorHandler, NoopNgxsExecutionStrategy, Select, Selector, SelectorOptions, State, Store, 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, ɵprovideNgxsInternalStateTokens };
+export { Action, Actions, DispatchOutsideZoneNgxsExecutionStrategy, NgxsConfig, NgxsDevelopmentModule, NgxsModule, NgxsSimpleChange, NgxsUnhandledActionsLogger, NgxsUnhandledErrorHandler, NoopNgxsExecutionStrategy, Select, Selector, SelectorOptions, State, Store, 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, ɵprovideNgxsInternalStateTokens };
 //# sourceMappingURL=ngxs-store.mjs.map