@ngxs/store 3.8.1 → 3.8.2-dev.master-a75608e

package/schematics/src/utils/ng-utils/standalone/util.js

@@ -0,0 +1,138 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findProvidersLiteral = exports.isMergeAppConfigCall = exports.applyChangesToFile = exports.findBootstrapApplicationCall = exports.getSourceFile = exports.getMainFilePath = void 0;
+const schematics_1 = require("@angular-devkit/schematics");
+const ts = require("@schematics/angular/third_party/github.com/Microsoft/TypeScript/lib/typescript");
+const project_targets_1 = require("@schematics/angular/utility/project-targets");
+const workspace_1 = require("@schematics/angular/utility/workspace");
+const change_1 = require("@schematics/angular/utility/change");
+/**
+ * Finds the main file of a project.
+ * @param tree File tree for the project.
+ * @param projectName Name of the project in which to search.
+ */
+function getMainFilePath(tree, projectName) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const workspace = yield (0, workspace_1.getWorkspace)(tree);
+        const project = workspace.projects.get(projectName);
+        const buildTarget = project === null || project === void 0 ? void 0 : project.targets.get('build');
+        if (!buildTarget) {
+            throw (0, project_targets_1.targetBuildNotFoundError)();
+        }
+        const options = buildTarget.options;
+        return buildTarget.builder === '@angular-devkit/build-angular:application'
+            ? options.browser
+            : options.main;
+    });
+}
+exports.getMainFilePath = getMainFilePath;
+/**
+ * Gets a TypeScript source file at a specific path.
+ * @param tree File tree of a project.
+ * @param path Path to the file.
+ */
+function getSourceFile(tree, path) {
+    const content = tree.readText(path);
+    const source = ts.createSourceFile(path, content, ts.ScriptTarget.Latest, true);
+    return source;
+}
+exports.getSourceFile = getSourceFile;
+/** Finds the call to `bootstrapApplication` within a file. */
+function findBootstrapApplicationCall(tree, mainFilePath) {
+    const sourceFile = getSourceFile(tree, mainFilePath);
+    const localName = findImportLocalName(sourceFile, 'bootstrapApplication', '@angular/platform-browser');
+    if (localName) {
+        let result = null;
+        sourceFile.forEachChild(function walk(node) {
+            if (ts.isCallExpression(node) &&
+                ts.isIdentifier(node.expression) &&
+                node.expression.text === localName) {
+                result = node;
+            }
+            if (!result) {
+                node.forEachChild(walk);
+            }
+        });
+        if (result) {
+            return result;
+        }
+    }
+    throw new schematics_1.SchematicsException(`Could not find bootstrapApplication call in ${mainFilePath}`);
+}
+exports.findBootstrapApplicationCall = findBootstrapApplicationCall;
+/**
+ * Finds the local name of an imported symbol. Could be the symbol name itself or its alias.
+ * @param sourceFile File within which to search for the import.
+ * @param name Actual name of the import, not its local alias.
+ * @param moduleName Name of the module from which the symbol is imported.
+ */
+function findImportLocalName(sourceFile, name, moduleName) {
+    for (const node of sourceFile.statements) {
+        // Only look for top-level imports.
+        if (!ts.isImportDeclaration(node) ||
+            !ts.isStringLiteral(node.moduleSpecifier) ||
+            node.moduleSpecifier.text !== moduleName) {
+            continue;
+        }
+        // Filter out imports that don't have the right shape.
+        if (!node.importClause ||
+            !node.importClause.namedBindings ||
+            !ts.isNamedImports(node.importClause.namedBindings)) {
+            continue;
+        }
+        // Look through the elements of the declaration for the specific import.
+        for (const element of node.importClause.namedBindings.elements) {
+            if ((element.propertyName || element.name).text === name) {
+                // The local name is always in `name`.
+                return element.name.text;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Applies a set of changes to a file.
+ * @param tree File tree of the project.
+ * @param path Path to the file that is being changed.
+ * @param changes Changes that should be applied to the file.
+ */
+function applyChangesToFile(tree, path, changes) {
+    if (changes.length > 0) {
+        const recorder = tree.beginUpdate(path);
+        (0, change_1.applyToUpdateRecorder)(recorder, changes);
+        tree.commitUpdate(recorder);
+    }
+}
+exports.applyChangesToFile = applyChangesToFile;
+/** Checks whether a node is a call to `mergeApplicationConfig`. */
+function isMergeAppConfigCall(node) {
+    if (!ts.isCallExpression(node)) {
+        return false;
+    }
+    const localName = findImportLocalName(node.getSourceFile(), 'mergeApplicationConfig', '@angular/core');
+    return !!localName && ts.isIdentifier(node.expression) && node.expression.text === localName;
+}
+exports.isMergeAppConfigCall = isMergeAppConfigCall;
+/** Finds the `providers` array literal within an application config. */
+function findProvidersLiteral(config) {
+    for (const prop of config.properties) {
+        if (ts.isPropertyAssignment(prop) &&
+            ts.isIdentifier(prop.name) &&
+            prop.name.text === 'providers' &&
+            ts.isArrayLiteralExpression(prop.initializer)) {
+            return prop.initializer;
+        }
+    }
+    return null;
+}
+exports.findProvidersLiteral = findProvidersLiteral;
+//# sourceMappingURL=util.js.map

package/schematics/src/utils/ng-utils/standalone/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../../../../packages/store/schematics/src/utils/ng-utils/standalone/util.ts"],"names":[],"mappings":"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"}

package/schematics/src/utils/normalize-options.d.ts

@@ -0,0 +1,9 @@
+interface BaseOptions {
+    name: string;
+    path?: string;
+}
+export declare function normalizeBaseOptions<T extends BaseOptions>(options: T): T & Required<BaseOptions>;
+export declare function normalizePath(path: string | undefined): string;
+/** Returns `value` if it's "true" | "false" and default value otherwise */
+export declare function normalizeOptionalBoolean(value: boolean | undefined, defaultValue: boolean): boolean;
+export {};

package/schematics/src/utils/normalize-options.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptionalBoolean = exports.normalizePath = exports.normalizeBaseOptions = void 0;
+const core_1 = require("@angular-devkit/core");
+function normalizeBaseOptions(options) {
+    const name = core_1.strings.dasherize(options.name);
+    const path = normalizePath(options.path);
+    return Object.assign(Object.assign({}, options), { name,
+        path });
+}
+exports.normalizeBaseOptions = normalizeBaseOptions;
+function normalizePath(path) {
+    return path !== undefined ? (0, core_1.normalize)(path) : '';
+}
+exports.normalizePath = normalizePath;
+/** Returns `value` if it's "true" | "false" and default value otherwise */
+function normalizeOptionalBoolean(value, defaultValue) {
+    if (value === true || value === false) {
+        return value;
+    }
+    return defaultValue;
+}
+exports.normalizeOptionalBoolean = normalizeOptionalBoolean;
+//# sourceMappingURL=normalize-options.js.map

package/schematics/src/utils/normalize-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-options.js","sourceRoot":"","sources":["../../../../../packages/store/schematics/src/utils/normalize-options.ts"],"names":[],"mappings":";;;AAAA,+CAA0D;AAO1D,SAAgB,oBAAoB,CAClC,OAAU;IAEV,MAAM,IAAI,GAAW,cAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,uCACK,OAAO,KACV,IAAI;QACJ,IAAI,IACJ;AACJ,CAAC;AAVD,oDAUC;AAED,SAAgB,aAAa,CAAC,IAAwB;IACpD,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC;AAFD,sCAEC;AAED,2EAA2E;AAC3E,SAAgB,wBAAwB,CACtC,KAA0B,EAC1B,YAAqB;IAErB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK,EAAE;QACrC,OAAO,KAAK,CAAC;KACd;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AARD,4DAQC"}

package/schematics/src/utils/project.d.ts

@@ -0,0 +1,16 @@
+import { TargetDefinition } from '@schematics/angular/utility/workspace';
+import { Tree } from '@angular-devkit/schematics';
+export interface WorkspaceProject {
+    name: string;
+    root: string;
+    projectType: string;
+    architect: {
+        [key: string]: TargetDefinition;
+    };
+}
+export declare function getProject(host: Tree, project?: string): WorkspaceProject | null;
+export declare function getProjectPath(host: Tree, options: {
+    project?: string | undefined;
+    path?: string | undefined;
+}): string | null;
+export declare function isLib(host: Tree, project?: string): boolean;

package/schematics/src/utils/project.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLib = exports.getProjectPath = exports.getProject = void 0;
+const config_1 = require("./config");
+function getProject(host, project) {
+    const workspace = (0, config_1.getWorkspace)(host);
+    if (!project) {
+        const defaultProject = workspace.defaultProject;
+        project =
+            defaultProject !== undefined ? defaultProject : Object.keys(workspace.projects)[0];
+    }
+    const resolvedProject = workspace.projects[project];
+    if (resolvedProject) {
+        resolvedProject.name = project;
+        return resolvedProject;
+    }
+    return null;
+}
+exports.getProject = getProject;
+function getProjectPath(host, options) {
+    const project = getProject(host, options.project);
+    if (!project) {
+        return null;
+    }
+    if (project.root.slice(-1) === '/') {
+        project.root = project.root.substring(0, project.root.length - 1);
+    }
+    if (options.path === undefined) {
+        const projectDirName = project.projectType === 'application' ? 'app' : 'lib';
+        return `${project.root ? `/${project.root}` : ''}/src/${projectDirName}`;
+    }
+    return options.path;
+}
+exports.getProjectPath = getProjectPath;
+function isLib(host, project) {
+    const resolvedProject = getProject(host, project);
+    return (resolvedProject === null || resolvedProject === void 0 ? void 0 : resolvedProject.projectType) === 'library';
+}
+exports.isLib = isLib;
+//# sourceMappingURL=project.js.map

package/schematics/src/utils/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../../../packages/store/schematics/src/utils/project.ts"],"names":[],"mappings":";;;AACA,qCAAwC;AAYxC,SAAgB,UAAU,CAAC,IAAU,EAAE,OAAgB;IACrD,MAAM,SAAS,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,CAAC;IAErC,IAAI,CAAC,OAAO,EAAE;QACZ,MAAM,cAAc,GAAI,SAAyC,CAAC,cAAc,CAAC;QACjF,OAAO;YACL,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;KACtF;IAED,MAAM,eAAe,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,eAAe,EAAE;QACnB,eAAe,CAAC,IAAI,GAAG,OAAO,CAAC;QAE/B,OAAO,eAAe,CAAC;KACxB;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAhBD,gCAgBC;AAED,SAAgB,cAAc,CAC5B,IAAU,EACV,OAAoE;IAEpE,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD,IAAI,CAAC,OAAO,EAAE;QACZ,OAAO,IAAI,CAAC;KACb;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;QAClC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;KACnE;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE;QAC9B,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAE7E,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,cAAc,EAAE,CAAC;KAC1E;IAED,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC;AArBD,wCAqBC;AAED,SAAgB,KAAK,CAAC,IAAU,EAAE,OAAgB;IAChD,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAElD,OAAO,CAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,WAAW,MAAK,SAAS,CAAC;AACpD,CAAC;AAJD,sBAIC"}

package/schematics/src/utils/versions.json

@@ -0,0 +1,3 @@
+{
+  "@ngxs/store": "3.8.2"
+}

package/src/actions/actions.d.ts

@@ -3,13 +3,13 @@ import { PlainObject } from '@ngxs/store/internals';
  * Init action
  */
 export declare class InitState {
-    static get type(): string;
+    static readonly type = "@@INIT";
 }
 /**
  * Update action
  */
 export declare class UpdateState {
     addedStates?: PlainObject | undefined;
-    static get type(): string;
+    static readonly type = "@@UPDATE_STATE";
     constructor(addedStates?: PlainObject | undefined);
 }

package/src/configs/messages.config.d.ts

@@ -1,3 +1,4 @@
+import { PlainObject } from '@ngxs/store/internals';
 export declare function throwStateNameError(name: string): never;
 export declare function throwStateNamePropertyError(): never;
 export declare function throwStateUniqueError(current: string, newName: string, oldName: string): never;
@@ -6,6 +7,7 @@ export declare function throwActionDecoratorError(): never;
 export declare function throwSelectorDecoratorError(): never;
 export declare function getZoneWarningMessage(): string;
 export declare function getUndecoratedStateInIvyWarningMessage(name: string): string;
+export declare function getInvalidInitializationOrderMessage(addedStates?: PlainObject): string;
 export declare function throwSelectFactoryNotConnectedError(): never;
 export declare function throwPatchingArrayError(): never;
 export declare function throwPatchingPrimitiveError(): never;

package/src/decorators/state.d.ts

@@ -1,6 +1,6 @@
-import { StateClass } from '@ngxs/store/internals';
+import { ɵStateClass } from '@ngxs/store/internals';
 import { StoreOptions } from '../symbols';
 /**
  * Decorates a class with ngxs state information.
  */
-export declare function State<T>(options: StoreOptions<T>): (target: StateClass) => void;
+export declare function State<T>(options: StoreOptions<T>): (target: ɵStateClass) => void;

package/src/execution/symbols.d.ts

@@ -1,8 +1,14 @@
 import { InjectionToken, Type } from '@angular/core';
 /**
- * The strategy that might be provided by users through `options.executionStrategy`.
+ * Consumers have the option to utilize the execution strategy provided by
+ * `NgxsModule.forRoot({executionStrategy})` or `provideStore([], {executionStrategy})`.
+ */
+export declare const CUSTOM_NGXS_EXECUTION_STRATEGY: InjectionToken<Type<NgxsExecutionStrategy> | undefined>;
+/**
+ * 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.
  */
-export declare const USER_PROVIDED_NGXS_EXECUTION_STRATEGY: InjectionToken<Type<NgxsExecutionStrategy> | undefined>;
 export declare const NGXS_EXECUTION_STRATEGY: InjectionToken<NgxsExecutionStrategy>;
 export interface NgxsExecutionStrategy {
     enter<T>(func: () => T): T;

package/src/internal/custom-rxjs-subjects.d.ts

@@ -1,4 +1,4 @@
-import { Subject, BehaviorSubject } from 'rxjs';
+import { BehaviorSubject, Subject } from 'rxjs';
 /**
  * Custom Subject that ensures that subscribers are notified of values in the order that they arrived.
  * A standard Subject does not have this guarantee.

package/src/internal/internals.d.ts

@@ -1,10 +1,10 @@
-import { PlainObjectOf, StateClass } from '@ngxs/store/internals';
+import { PlainObjectOf, ɵStateClass, ɵMETA_KEY, ɵMETA_OPTIONS_KEY } from '@ngxs/store/internals';
 import { Observable } from 'rxjs';
-import { META_KEY, META_OPTIONS_KEY, NgxsConfig, StoreOptions } from '../symbols';
+import { NgxsConfig, StoreOptions } from '../symbols';
 import { ActionHandlerMetaData } from '../actions/symbols';
-export interface StateClassInternal<T = any, U = any> extends StateClass<T> {
-    [META_KEY]?: MetaDataModel;
-    [META_OPTIONS_KEY]?: StoreOptions<U>;
+export interface StateClassInternal<T = any, U = any> extends ɵStateClass<T> {
+    [ɵMETA_KEY]?: MetaDataModel;
+    [ɵMETA_OPTIONS_KEY]?: StoreOptions<U>;
 }
 export declare type StateKeyGraph = PlainObjectOf<string[]>;
 export declare type StatesByName = PlainObjectOf<StateClassInternal>;

package/src/internal/lifecycle-state-manager.d.ts

@@ -2,6 +2,7 @@ import { OnDestroy } from '@angular/core';
 import { NgxsBootstrapper } from '@ngxs/store/internals';
 import { Store } from '../store';
 import { InternalErrorReporter } from './error-handler';
+import { InitState, UpdateState } from '../actions/actions';
 import { StateContextFactory } from './state-context-factory';
 import { InternalStateOperations } from './state-operations';
 import { StatesAndDefaults } from './internals';
@@ -13,9 +14,10 @@ export declare class LifecycleStateManager implements OnDestroy {
     private _stateContextFactory;
     private _bootstrapper;
     private readonly _destroy$;
+    private _initStateHasBeenDispatched?;
     constructor(_store: Store, _internalErrorReporter: InternalErrorReporter, _internalStateOperations: InternalStateOperations, _stateContextFactory: StateContextFactory, _bootstrapper: NgxsBootstrapper);
     ngOnDestroy(): void;
-    ngxsBootstrap<T>(action: T, results: StatesAndDefaults | undefined): void;
+    ngxsBootstrap(action: InitState | UpdateState, results: StatesAndDefaults | undefined): void;
     private _invokeInitOnStates;
     private _invokeBootstrapOnStates;
     private _getStateContext;

package/src/internal/state-factory.d.ts

@@ -36,7 +36,7 @@ export declare class StateFactory implements OnDestroy {
     private _statePaths;
     private get statePaths();
     getRuntimeSelectorContext: () => RuntimeSelectorContext;
-    private static cloneDefaults;
+    private static _cloneDefaults;
     ngOnDestroy(): void;
     /**
      * Add a new state to the global defs.

package/src/module.d.ts

@@ -1,23 +1,12 @@
 import { ModuleWithProviders } from '@angular/core';
-import { StateClass } from '@ngxs/store/internals';
+import { ɵStateClass } from '@ngxs/store/internals';
 import { NgxsModuleOptions } from './symbols';
 import { NgxsRootModule } from './modules/ngxs-root.module';
 import { NgxsFeatureModule } from './modules/ngxs-feature.module';
 import * as i0 from "@angular/core";
-/**
- * Ngxs Module
- */
 export declare class NgxsModule {
-    /**
-     * Root module factory
-     */
-    static forRoot(states?: StateClass[], options?: NgxsModuleOptions): ModuleWithProviders<NgxsRootModule>;
-    /**
-     * Feature module factory
-     */
-    static forFeature(states?: StateClass[]): ModuleWithProviders<NgxsFeatureModule>;
-    private static ngxsTokenProviders;
-    private static appBootstrapListenerFactory;
+    static forRoot(states?: ɵStateClass[], options?: NgxsModuleOptions): ModuleWithProviders<NgxsRootModule>;
+    static forFeature(states?: ɵStateClass[]): ModuleWithProviders<NgxsFeatureModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxsModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<NgxsModule, never, never, never>;
     static ɵinj: i0.ɵɵInjectorDeclaration<NgxsModule>;

package/src/modules/ngxs-feature.module.d.ts

@@ -1,17 +1,10 @@
-import { Store } from '../store';
-import { InternalStateOperations } from '../internal/state-operations';
-import { StateFactory } from '../internal/state-factory';
-import { LifecycleStateManager } from '../internal/lifecycle-state-manager';
-import { StateClassInternal } from '../internal/internals';
 import * as i0 from "@angular/core";
 /**
- * Feature module
  * @ignore
  */
 export declare class NgxsFeatureModule {
-    constructor(_store: Store, internalStateOperations: InternalStateOperations, factory: StateFactory, states: StateClassInternal<any, any>[][] | undefined, lifecycleStateManager: LifecycleStateManager);
-    private static flattenStates;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NgxsFeatureModule, [null, null, null, { optional: true; }, null]>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxsFeatureModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<NgxsFeatureModule, never, never, never>;
     static ɵinj: i0.ɵɵInjectorDeclaration<NgxsFeatureModule>;
 }

package/src/modules/ngxs-root.module.d.ts

@@ -1,17 +1,10 @@
-import { StateFactory } from '../internal/state-factory';
-import { InternalStateOperations } from '../internal/state-operations';
-import { Store } from '../store';
-import { SelectFactory } from '../decorators/select/select-factory';
-import { StateClassInternal } from '../internal/internals';
-import { LifecycleStateManager } from '../internal/lifecycle-state-manager';
 import * as i0 from "@angular/core";
 /**
- * Root module
  * @ignore
  */
 export declare class NgxsRootModule {
-    constructor(factory: StateFactory, internalStateOperations: InternalStateOperations, _store: Store, _select: SelectFactory, states: StateClassInternal<any, any>[] | undefined, lifecycleStateManager: LifecycleStateManager);
-    static ɵfac: i0.ɵɵFactoryDeclaration<NgxsRootModule, [null, null, null, null, { optional: true; }, null]>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxsRootModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<NgxsRootModule, never, never, never>;
     static ɵinj: i0.ɵɵInjectorDeclaration<NgxsRootModule>;
 }

package/src/public_api.d.ts

@@ -5,9 +5,9 @@ export { State } from './decorators/state';
 export { Select } from './decorators/select/select';
 export { SelectorOptions } from './decorators/selector-options';
 export { Actions, ActionContext, ActionStatus } from './actions-stream';
-export { getSelectorMetadata, getStoreMetadata, ensureStoreMetadata, ensureSelectorMetadata, } from './public_to_deprecate';
-export { ofAction, ofActionDispatched, ofActionSuccessful, ofActionCanceled, ofActionErrored, ofActionCompleted, ActionCompletion, } from './operators/of-action';
-export { StateContext, StateOperator, NgxsOnInit, NgxsAfterBootstrap, NgxsOnChanges, NgxsModuleOptions, NgxsSimpleChange, } from './symbols';
+export { getSelectorMetadata, getStoreMetadata, ensureStoreMetadata, ensureSelectorMetadata } from './public_to_deprecate';
+export { ofAction, ofActionDispatched, ofActionSuccessful, ofActionCanceled, ofActionErrored, ofActionCompleted, ActionCompletion } from './operators/of-action';
+export { StateContext, StateOperator, NgxsOnInit, NgxsAfterBootstrap, NgxsOnChanges, NgxsModuleOptions, NgxsSimpleChange } from './symbols';
 export { Selector } from './decorators/selector/selector';
 export { getActionTypeFromInstance, actionMatcher } from './utils/utils';
 export { NgxsExecutionStrategy } from './execution/symbols';
@@ -17,4 +17,5 @@ export { StateToken } from './state-token/state-token';
 export { NgxsDevelopmentOptions } from './dev-features/symbols';
 export { NgxsDevelopmentModule } from './dev-features/ngxs-development.module';
 export { NgxsUnhandledActionsLogger } from './dev-features/ngxs-unhandled-actions-logger';
-export { createModelSelector, createPickSelector, createPropertySelectors, createSelector, PropertySelectors, TypedSelector, } from './selectors';
+export { createModelSelector, createPickSelector, createPropertySelectors, createSelector, PropertySelectors, TypedSelector } from './selectors';
+export * from './standalone-features';

package/src/selectors/selector-types.util.d.ts

@@ -1,7 +1,7 @@
-import { StateClass } from '@ngxs/store/internals';
+import { ɵStateClass } from '@ngxs/store/internals';
 import { StateToken } from '../state-token/state-token';
 export declare type SelectorFunc<TModel> = (...arg: any[]) => TModel;
 export declare type TypedSelector<TModel> = StateToken<TModel> | SelectorFunc<TModel>;
-export declare type StateSelector = StateClass<any>;
+export declare type StateSelector = ɵStateClass<any>;
 export declare type SelectorDef<TModel> = StateSelector | TypedSelector<TModel>;
-export declare type SelectorReturnType<T extends SelectorDef<any>> = T extends StateToken<infer R1> ? R1 : T extends SelectorFunc<infer R2> ? R2 : T extends StateClass<any> ? any : never;
+export declare type SelectorReturnType<T extends SelectorDef<any>> = T extends StateToken<infer R1> ? R1 : T extends SelectorFunc<infer R2> ? R2 : T extends ɵStateClass<any> ? any : never;

package/src/standalone-features/feature-providers.d.ts

@@ -0,0 +1,7 @@
+import { Provider } from '@angular/core';
+import { ɵStateClass } from '@ngxs/store/internals';
+/**
+ * This function provides the required providers when calling `NgxsModule.forFeature`
+ * or `provideStates`. It is shared between the NgModule and standalone APIs.
+ */
+export declare function getFeatureProviders(states: ɵStateClass[]): Provider[];

package/src/standalone-features/index.d.ts

@@ -0,0 +1,3 @@
+export { provideStore } from './provide-store';
+export { provideStates } from './provide-states';
+export { withNgxsPlugin } from './plugin';

package/src/standalone-features/initializers.d.ts

@@ -0,0 +1,29 @@
+import { InjectionToken, Provider } from '@angular/core';
+/**
+ * This function is shared by both NgModule and standalone features.
+ * When using `NgxsModule.forRoot` and `provideStore`, we can depend on the
+ * same initialization functionality.
+ */
+export declare function rootStoreInitializer(): void;
+/**
+ * This function is utilized by both NgModule and standalone features.
+ * When using `NgxsModule.forFeature` and `provideStates`, we can depend on
+ * the same initialization functionality.
+ */
+export declare function featureStatesInitializer(): void;
+/**
+ * InjectionToken that registers the global Store.
+ */
+export declare const NGXS_ROOT_STORE_INITIALIZER: InjectionToken<void>;
+/**
+ * InjectionToken that registers feature states.
+ */
+export declare const NGXS_FEATURE_STORE_INITIALIZER: InjectionToken<void>;
+export declare const NGXS_ROOT_ENVIRONMENT_INITIALIZER: Provider[];
+/**
+ * The `NGXS_FEATURE_ENVIRONMENT_INITIALIZER` functions as an environment initializer
+ * at the `Route` level. Angular Router creates an environment route injector for each
+ * matched route where navigation occurs. The injector is created once, ensuring that
+ * the feature states initialization only happens once as well.
+ */
+export declare const NGXS_FEATURE_ENVIRONMENT_INITIALIZER: Provider[];

package/src/standalone-features/plugin.d.ts

@@ -0,0 +1,17 @@
+import { EnvironmentProviders, Type } from '@angular/core';
+import { NgxsPlugin } from '../symbols';
+/**
+ * This function registers a custom global plugin for the state.
+ *
+ * ```ts
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideStore(
+ *       [CountriesState],
+ *       withNgxsPlugin(logoutPlugin)
+ *     )
+ *   ]
+ * });
+ * ```
+ */
+export declare function withNgxsPlugin(plugin: Type<NgxsPlugin>): EnvironmentProviders;

package/src/standalone-features/provide-states.d.ts

@@ -0,0 +1,18 @@
+import { EnvironmentProviders } from '@angular/core';
+import { ɵStateClass } from '@ngxs/store/internals';
+/**
+ * This version serves as a standalone alternative to `NgxsModule.forFeature`.
+ * It can be used in a similar manner to register feature states, but at the
+ * `Route` providers level:
+ *
+ * ```ts
+ * const routes: Routes = [
+ *   {
+ *     path: 'products',
+ *     loadComponent: async () => {...},
+ *     providers: [provideStates([ProductsState])]
+ *   }
+ * ];
+ * ```
+ */
+export declare function provideStates(states: ɵStateClass[], ...features: EnvironmentProviders[]): EnvironmentProviders;

package/src/standalone-features/provide-store.d.ts

@@ -0,0 +1,22 @@
+import { EnvironmentProviders } from '@angular/core';
+import { ɵStateClass } from '@ngxs/store/internals';
+import { NgxsModuleOptions } from '../symbols';
+/**
+ * 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
+ * });
+ * ```
+ */
+export declare function provideStore(states?: ɵStateClass[], ...features: EnvironmentProviders[]): EnvironmentProviders;
+export declare function provideStore(states?: ɵStateClass[], options?: NgxsModuleOptions, ...features: EnvironmentProviders[]): EnvironmentProviders;

package/src/standalone-features/root-providers.d.ts

@@ -0,0 +1,8 @@
+import { Provider } from '@angular/core';
+import { ɵStateClass } from '@ngxs/store/internals';
+import { NgxsModuleOptions } from '../symbols';
+/**
+ * This function provides the required providers when invoking `NgxsModule.forRoot`
+ * or `provideStore`. It is shared between the NgModule and standalone APIs.
+ */
+export declare function getRootProviders(states: ɵStateClass[], options: NgxsModuleOptions): Provider[];

package/src/symbols.d.ts

@@ -1,18 +1,15 @@
 import { InjectionToken, Type } from '@angular/core';
 import { Observable } from 'rxjs';
-import { PlainObject, StateClass } from '@ngxs/store/internals';
+import { PlainObject, ɵStateClass } from '@ngxs/store/internals';
 import { StateOperator } from '@ngxs/store/operators';
 import { NgxsExecutionStrategy } from './execution/symbols';
 import { SharedSelectorOptions } from './internal/internals';
 import { StateToken } from './state-token/state-token';
 import * as i0 from "@angular/core";
-export declare const ROOT_OPTIONS: InjectionToken<Partial<NgxsConfig>>;
-export declare const ROOT_STATE_TOKEN: InjectionToken<any>;
-export declare const FEATURE_STATE_TOKEN: InjectionToken<any>;
+export declare const ROOT_STATE_TOKEN: InjectionToken<ɵStateClass<any>[]>;
+export declare const FEATURE_STATE_TOKEN: InjectionToken<ɵStateClass<any>[][]>;
 export declare const NGXS_PLUGINS: InjectionToken<unknown>;
-export declare const META_KEY = "NGXS_META";
-export declare const META_OPTIONS_KEY = "NGXS_OPTIONS_META";
-export declare const SELECTOR_META_KEY = "NGXS_SELECTOR_META";
+export declare const NGXS_OPTIONS: InjectionToken<Partial<NgxsConfig>>;
 export declare type NgxsLifeCycle = Partial<NgxsOnChanges> & Partial<NgxsOnInit> & Partial<NgxsAfterBootstrap>;
 export declare type NgxsPluginFn = (state: any, mutation: any, next: NgxsNextPluginFn) => any;
 /**
@@ -111,7 +108,7 @@ export interface StoreOptions<T> {
     /**
      * Sub states for the given state.
      */
-    children?: StateClass[];
+    children?: ɵStateClass[];
 }
 /**
  * Represents a basic change from a previous to a new value for a single state instance.

package/src/utils/store-validators.d.ts

@@ -1,7 +1,4 @@
 import { StateClassInternal, StatesByName } from '../internal/internals';
-export declare abstract class StoreValidators {
-    private static stateNameRegex;
-    static checkThatStateIsNamedCorrectly(name: string | null): void | never;
-    static checkThatStateNameIsUnique(stateName: string, state: StateClassInternal, statesByName: StatesByName): void | never;
-    static checkThatStateClassesHaveBeenDecorated(stateClasses: StateClassInternal[]): void | never;
-}
+export declare function ensureStateNameIsValid(name: string | null): void | never;
+export declare function ensureStateNameIsUnique(stateName: string, state: StateClassInternal, statesByName: StatesByName): void | never;
+export declare function ensureStatesAreDecorated(stateClasses: StateClassInternal[]): void | never;