@nx/angular 21.0.0-canary.20250416-caa26a7 → 21.0.0-canary.20250419-8619c1d

package/fesm2022/nx-angular.mjs

@@ -1,356 +1,4 @@
-import { ROUTER_NAVIGATION } from '@ngrx/router-store';
-import { isObservable, of } from 'rxjs';
-import { concatMap, groupBy, mergeMap, switchMap, filter, map, catchError } from 'rxjs/operators';
-
-/**
- * @whatItDoes Handles pessimistic updates (updating the server first).
- *
- * Updating the server, when implemented naively, suffers from race conditions and poor error handling.
- *
- * `pessimisticUpdate` addresses these problems. It runs all fetches in order, which removes race conditions
- * and forces the developer to handle errors.
- *
- * ## Example:
- *
- * ```typescript
- * @Injectable()
- * class TodoEffects {
- *   updateTodo$ = createEffect(() =>
- *     this.actions$.pipe(
- *       ofType('UPDATE_TODO'),
- *       pessimisticUpdate({
- *         // provides an action
- *         run: (action: UpdateTodo) => {
- *           // update the backend first, and then dispatch an action that will
- *           // update the client side
- *           return this.backend.updateTodo(action.todo.id, action.todo).pipe(
- *             map((updated) => ({
- *               type: 'UPDATE_TODO_SUCCESS',
- *               todo: updated,
- *             }))
- *           );
- *         },
- *         onError: (action: UpdateTodo, error: any) => {
- *           // we don't need to undo the changes on the client side.
- *           // we can dispatch an error, or simply log the error here and return `null`
- *           return null;
- *         },
- *       })
- *     )
- *   );
- *
- *   constructor(private actions$: Actions, private backend: Backend) {}
- * }
- * ```
- *
- * Note that if you don't return a new action from the run callback, you must set the dispatch property
- * of the effect to false, like this:
- *
- * ```typescript
- * class TodoEffects {
- *   updateTodo$ = createEffect(() =>
- *     this.actions$.pipe(
- *       //...
- *     ), { dispatch: false }
- *   );
- * }
- * ```
- *
- * @param opts
- *
- * @deprecated This will be removed in Nx v21. Import `pessimisticUpdate` from `@ngrx/router-store/data-persistence` instead.
- */
-function pessimisticUpdate(opts) {
-    return (source) => {
-        return source.pipe(mapActionAndState(), concatMap(runWithErrorHandling(opts.run, opts.onError)));
-    };
-}
-/**
- * @whatItDoes Handles optimistic updates (updating the client first).
- *
- * It runs all fetches in order, which removes race conditions and forces the developer to handle errors.
- *
- * When using `optimisticUpdate`, in case of a failure, the developer has already updated the state locally,
- * so the developer must provide an undo action.
- *
- * The error handling must be done in the callback, or by means of the undo action.
- *
- * ## Example:
- *
- * ```typescript
- * @Injectable()
- * class TodoEffects {
- *   updateTodo$ = createEffect(() =>
- *     this.actions$.pipe(
- *       ofType('UPDATE_TODO'),
- *       optimisticUpdate({
- *         // provides an action
- *         run: (action: UpdateTodo) => {
- *           return this.backend.updateTodo(action.todo.id, action.todo).pipe(
- *             mapTo({
- *               type: 'UPDATE_TODO_SUCCESS',
- *             })
- *           );
- *         },
- *         undoAction: (action: UpdateTodo, error: any) => {
- *           // dispatch an undo action to undo the changes in the client state
- *           return {
- *             type: 'UNDO_TODO_UPDATE',
- *             todo: action.todo,
- *           };
- *         },
- *       })
- *     )
- *   );
- *
- *   constructor(private actions$: Actions, private backend: Backend) {}
- * }
- * ```
- *
- * Note that if you don't return a new action from the run callback, you must set the dispatch property
- * of the effect to false, like this:
- *
- * ```typescript
- * class TodoEffects {
- *   updateTodo$ = createEffect(() =>
- *     this.actions$.pipe(
- *       //...
- *     ), { dispatch: false }
- *   );
- * }
- * ```
- *
- * @param opts
- *
- * @deprecated This will be removed in Nx v21. Import `optimisticUpdate` from `@ngrx/router-store/data-persistence` instead.
- */
-function optimisticUpdate(opts) {
-    return (source) => {
-        return source.pipe(mapActionAndState(), concatMap(runWithErrorHandling(opts.run, opts.undoAction)));
-    };
-}
-/**
- * @whatItDoes Handles data fetching.
- *
- * Data fetching implemented naively suffers from race conditions and poor error handling.
- *
- * `fetch` addresses these problems. It runs all fetches in order, which removes race conditions
- * and forces the developer to handle errors.
- *
- * ## Example:
- *
- * ```typescript
- * @Injectable()
- * class TodoEffects {
- *   loadTodos$ = createEffect(() =>
- *     this.actions$.pipe(
- *       ofType('GET_TODOS'),
- *       fetch({
- *         // provides an action
- *         run: (a: GetTodos) => {
- *           return this.backend.getAll().pipe(
- *             map((response) => ({
- *               type: 'TODOS',
- *               todos: response.todos,
- *             }))
- *           );
- *         },
- *         onError: (action: GetTodos, error: any) => {
- *           // dispatch an undo action to undo the changes in the client state
- *           return null;
- *         },
- *       })
- *     )
- *   );
- *
- *   constructor(private actions$: Actions, private backend: Backend) {}
- * }
- * ```
- *
- * This is correct, but because it set the concurrency to 1, it may not be performant.
- *
- * To fix that, you can provide the `id` function, like this:
- *
- * ```typescript
- * @Injectable()
- * class TodoEffects {
- *   loadTodo$ = createEffect(() =>
- *     this.actions$.pipe(
- *       ofType('GET_TODO'),
- *       fetch({
- *         id: (todo: GetTodo) => {
- *           return todo.id;
- *         },
- *         // provides an action
- *         run: (todo: GetTodo) => {
- *           return this.backend.getTodo(todo.id).map((response) => ({
- *             type: 'LOAD_TODO_SUCCESS',
- *             todo: response.todo,
- *           }));
- *         },
- *         onError: (action: GetTodo, error: any) => {
- *           // dispatch an undo action to undo the changes in the client state
- *           return null;
- *         },
- *       })
- *     )
- *   );
- *
- *   constructor(private actions$: Actions, private backend: Backend) {}
- * }
- * ```
- *
- * With this setup, the requests for Todo 1 will run concurrently with the requests for Todo 2.
- *
- * In addition, if there are multiple requests for Todo 1 scheduled, it will only run the last one.
- *
- * @param opts
- *
- * @deprecated This will be removed in Nx v21. Import `fetch` from `@ngrx/router-store/data-persistence` instead.
- */
-function fetch(opts) {
-    return (source) => {
-        if (opts.id) {
-            const groupedFetches = source.pipe(mapActionAndState(), groupBy(([action, ...store]) => {
-                return opts.id(action, ...store);
-            }));
-            return groupedFetches.pipe(mergeMap((pairs) => pairs.pipe(switchMap(runWithErrorHandling(opts.run, opts.onError)))));
-        }
-        return source.pipe(mapActionAndState(), concatMap(runWithErrorHandling(opts.run, opts.onError)));
-    };
-}
-/**
- * @whatItDoes Handles data fetching as part of router navigation.
- *
- * Data fetching implemented naively suffers from race conditions and poor error handling.
- *
- * `navigation` addresses these problems.
- *
- * It checks if an activated router state contains the passed in component type, and, if it does, runs the `run`
- * callback. It provides the activated snapshot associated with the component and the current state. And it only runs
- * the last request.
- *
- * ## Example:
- *
- * ```typescript
- * @Injectable()
- * class TodoEffects {
- *   loadTodo$ = createEffect(() =>
- *     this.actions$.pipe(
- *       // listens for the routerNavigation action from @ngrx/router-store
- *       navigation(TodoComponent, {
- *         run: (activatedRouteSnapshot: ActivatedRouteSnapshot) => {
- *           return this.backend
- *             .fetchTodo(activatedRouteSnapshot.params['id'])
- *             .pipe(
- *               map((todo) => ({
- *                 type: 'LOAD_TODO_SUCCESS',
- *                 todo: todo,
- *               }))
- *             );
- *         },
- *         onError: (
- *           activatedRouteSnapshot: ActivatedRouteSnapshot,
- *           error: any
- *         ) => {
- *           // we can log and error here and return null
- *           // we can also navigate back
- *           return null;
- *         },
- *       })
- *     )
- *   );
- *
- *   constructor(private actions$: Actions, private backend: Backend) {}
- * }
- * ```
- *
- * @param component
- * @param opts
- *
- * @deprecated This will be removed in Nx v21. Import `navigation` from `@ngrx/router-store/data-persistence` instead.
- */
-function navigation(component, opts) {
-    return (source) => {
-        const nav = source.pipe(mapActionAndState(), filter(([action]) => isStateSnapshot(action)), map(([action, ...slices]) => {
-            if (!isStateSnapshot(action)) {
-                // Because of the above filter we'll never get here,
-                // but this properly type narrows `action`
-                return;
-            }
-            return [
-                findSnapshot(component, action.payload.routerState.root),
-                ...slices,
-            ];
-        }), filter(([snapshot]) => !!snapshot));
-        return nav.pipe(switchMap(runWithErrorHandling(opts.run, opts.onError)));
-    };
-}
-function isStateSnapshot(action) {
-    return action.type === ROUTER_NAVIGATION;
-}
-function runWithErrorHandling(run, onError) {
-    return ([action, ...slices]) => {
-        try {
-            const r = wrapIntoObservable(run(action, ...slices));
-            return r.pipe(catchError((e) => wrapIntoObservable(onError(action, e))));
-        }
-        catch (e) {
-            return wrapIntoObservable(onError(action, e));
-        }
-    };
-}
-/**
- * @whatItDoes maps Observable<Action | [Action, State]> to
- * Observable<[Action, State]>
- */
-function mapActionAndState() {
-    return (source) => {
-        return source.pipe(map((value) => normalizeActionAndState(value)));
-    };
-}
-/**
- * @whatItDoes Normalizes either a bare action or an array of action and slices
- * into an array of action and slices (or undefined)
- */
-function normalizeActionAndState(args) {
-    let action, slices;
-    if (args instanceof Array) {
-        [action, ...slices] = args;
-    }
-    else {
-        slices = [];
-        action = args;
-    }
-    return [action, ...slices];
-}
-function findSnapshot(component, s) {
-    if (s.routeConfig && s.routeConfig.component === component) {
-        return s;
-    }
-    for (const c of s.children) {
-        const ss = findSnapshot(component, c);
-        if (ss) {
-            return ss;
-        }
-    }
-    return null;
-}
-function wrapIntoObservable(obj) {
-    if (isObservable(obj)) {
-        return obj;
-    }
-    else if (!obj) {
-        return of();
-    }
-    else {
-        return of(obj);
-    }
-}
-
 /**
  * Generated bundle index. Do not edit.
  */
-
-export { fetch, navigation, optimisticUpdate, pessimisticUpdate };
 //# sourceMappingURL=nx-angular.mjs.map

package/fesm2022/nx-angular.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"nx-angular.mjs","sources":["../../../../packages/angular/src/runtime/nx/data-persistence.ts","../../../../packages/angular/nx-angular.ts"],"sourcesContent":["import type { Type } from '@angular/core';\nimport type {\n  ActivatedRouteSnapshot,\n  RouterStateSnapshot,\n} from '@angular/router';\nimport type { RouterNavigationAction } from '@ngrx/router-store';\nimport { ROUTER_NAVIGATION } from '@ngrx/router-store';\nimport type { Action } from '@ngrx/store';\nimport type { Observable } from 'rxjs';\nimport { isObservable, of } from 'rxjs';\nimport {\n  catchError,\n  concatMap,\n  filter,\n  groupBy,\n  map,\n  mergeMap,\n  switchMap,\n} from 'rxjs/operators';\n\nexport interface PessimisticUpdateOpts<T extends Array<unknown>, A> {\n  run(a: A, ...slices: [...T]): Observable<Action> | Action | void;\n  onError(a: A, e: any): Observable<any> | any;\n}\n\nexport interface OptimisticUpdateOpts<T extends Array<unknown>, A> {\n  run(a: A, ...slices: [...T]): Observable<Action> | Action | void;\n  undoAction(a: A, e: any): Observable<Action> | Action;\n}\n\nexport interface FetchOpts<T extends Array<unknown>, A> {\n  id?(a: A, ...slices: [...T]): any;\n  run(a: A, ...slices: [...T]): Observable<Action> | Action | void;\n  onError?(a: A, e: any): Observable<any> | any;\n}\n\nexport interface HandleNavigationOpts<T extends Array<unknown>> {\n  run(\n    a: ActivatedRouteSnapshot,\n    ...slices: [...T]\n  ): Observable<Action> | Action | void;\n  onError?(a: ActivatedRouteSnapshot, e: any): Observable<any> | any;\n}\n\nexport type ActionOrActionWithStates<T extends Array<unknown>, A> =\n  | A\n  | [A, ...T];\nexport type ActionOrActionWithState<T, A> = ActionOrActionWithStates<[T], A>;\nexport type ActionStatesStream<T extends Array<unknown>, A> = Observable<\n  ActionOrActionWithStates<T, A>\n>;\nexport type ActionStateStream<T, A> = Observable<\n  ActionOrActionWithStates<[T], A>\n>;\n\n/**\n * @whatItDoes Handles pessimistic updates (updating the server first).\n *\n * Updating the server, when implemented naively, suffers from race conditions and poor error handling.\n *\n * `pessimisticUpdate` addresses these problems. It runs all fetches in order, which removes race conditions\n * and forces the developer to handle errors.\n *\n * ## Example:\n *\n * ```typescript\n * @Injectable()\n * class TodoEffects {\n *   updateTodo$ = createEffect(() =>\n *     this.actions$.pipe(\n *       ofType('UPDATE_TODO'),\n *       pessimisticUpdate({\n *         // provides an action\n *         run: (action: UpdateTodo) => {\n *           // update the backend first, and then dispatch an action that will\n *           // update the client side\n *           return this.backend.updateTodo(action.todo.id, action.todo).pipe(\n *             map((updated) => ({\n *               type: 'UPDATE_TODO_SUCCESS',\n *               todo: updated,\n *             }))\n *           );\n *         },\n *         onError: (action: UpdateTodo, error: any) => {\n *           // we don't need to undo the changes on the client side.\n *           // we can dispatch an error, or simply log the error here and return `null`\n *           return null;\n *         },\n *       })\n *     )\n *   );\n *\n *   constructor(private actions$: Actions, private backend: Backend) {}\n * }\n * ```\n *\n * Note that if you don't return a new action from the run callback, you must set the dispatch property\n * of the effect to false, like this:\n *\n * ```typescript\n * class TodoEffects {\n *   updateTodo$ = createEffect(() =>\n *     this.actions$.pipe(\n *       //...\n *     ), { dispatch: false }\n *   );\n * }\n * ```\n *\n * @param opts\n *\n * @deprecated This will be removed in Nx v21. Import `pessimisticUpdate` from `@ngrx/router-store/data-persistence` instead.\n */\nexport function pessimisticUpdate<T extends Array<unknown>, A extends Action>(\n  opts: PessimisticUpdateOpts<T, A>\n) {\n  return (source: ActionStatesStream<T, A>): Observable<Action> => {\n    return source.pipe(\n      mapActionAndState(),\n      concatMap(runWithErrorHandling(opts.run, opts.onError))\n    );\n  };\n}\n\n/**\n * @whatItDoes Handles optimistic updates (updating the client first).\n *\n * It runs all fetches in order, which removes race conditions and forces the developer to handle errors.\n *\n * When using `optimisticUpdate`, in case of a failure, the developer has already updated the state locally,\n * so the developer must provide an undo action.\n *\n * The error handling must be done in the callback, or by means of the undo action.\n *\n * ## Example:\n *\n * ```typescript\n * @Injectable()\n * class TodoEffects {\n *   updateTodo$ = createEffect(() =>\n *     this.actions$.pipe(\n *       ofType('UPDATE_TODO'),\n *       optimisticUpdate({\n *         // provides an action\n *         run: (action: UpdateTodo) => {\n *           return this.backend.updateTodo(action.todo.id, action.todo).pipe(\n *             mapTo({\n *               type: 'UPDATE_TODO_SUCCESS',\n *             })\n *           );\n *         },\n *         undoAction: (action: UpdateTodo, error: any) => {\n *           // dispatch an undo action to undo the changes in the client state\n *           return {\n *             type: 'UNDO_TODO_UPDATE',\n *             todo: action.todo,\n *           };\n *         },\n *       })\n *     )\n *   );\n *\n *   constructor(private actions$: Actions, private backend: Backend) {}\n * }\n * ```\n *\n * Note that if you don't return a new action from the run callback, you must set the dispatch property\n * of the effect to false, like this:\n *\n * ```typescript\n * class TodoEffects {\n *   updateTodo$ = createEffect(() =>\n *     this.actions$.pipe(\n *       //...\n *     ), { dispatch: false }\n *   );\n * }\n * ```\n *\n * @param opts\n *\n * @deprecated This will be removed in Nx v21. Import `optimisticUpdate` from `@ngrx/router-store/data-persistence` instead.\n */\nexport function optimisticUpdate<T extends Array<unknown>, A extends Action>(\n  opts: OptimisticUpdateOpts<T, A>\n) {\n  return (source: ActionStatesStream<T, A>): Observable<Action> => {\n    return source.pipe(\n      mapActionAndState(),\n      concatMap(runWithErrorHandling(opts.run, opts.undoAction))\n    );\n  };\n}\n\n/**\n * @whatItDoes Handles data fetching.\n *\n * Data fetching implemented naively suffers from race conditions and poor error handling.\n *\n * `fetch` addresses these problems. It runs all fetches in order, which removes race conditions\n * and forces the developer to handle errors.\n *\n * ## Example:\n *\n * ```typescript\n * @Injectable()\n * class TodoEffects {\n *   loadTodos$ = createEffect(() =>\n *     this.actions$.pipe(\n *       ofType('GET_TODOS'),\n *       fetch({\n *         // provides an action\n *         run: (a: GetTodos) => {\n *           return this.backend.getAll().pipe(\n *             map((response) => ({\n *               type: 'TODOS',\n *               todos: response.todos,\n *             }))\n *           );\n *         },\n *         onError: (action: GetTodos, error: any) => {\n *           // dispatch an undo action to undo the changes in the client state\n *           return null;\n *         },\n *       })\n *     )\n *   );\n *\n *   constructor(private actions$: Actions, private backend: Backend) {}\n * }\n * ```\n *\n * This is correct, but because it set the concurrency to 1, it may not be performant.\n *\n * To fix that, you can provide the `id` function, like this:\n *\n * ```typescript\n * @Injectable()\n * class TodoEffects {\n *   loadTodo$ = createEffect(() =>\n *     this.actions$.pipe(\n *       ofType('GET_TODO'),\n *       fetch({\n *         id: (todo: GetTodo) => {\n *           return todo.id;\n *         },\n *         // provides an action\n *         run: (todo: GetTodo) => {\n *           return this.backend.getTodo(todo.id).map((response) => ({\n *             type: 'LOAD_TODO_SUCCESS',\n *             todo: response.todo,\n *           }));\n *         },\n *         onError: (action: GetTodo, error: any) => {\n *           // dispatch an undo action to undo the changes in the client state\n *           return null;\n *         },\n *       })\n *     )\n *   );\n *\n *   constructor(private actions$: Actions, private backend: Backend) {}\n * }\n * ```\n *\n * With this setup, the requests for Todo 1 will run concurrently with the requests for Todo 2.\n *\n * In addition, if there are multiple requests for Todo 1 scheduled, it will only run the last one.\n *\n * @param opts\n *\n * @deprecated This will be removed in Nx v21. Import `fetch` from `@ngrx/router-store/data-persistence` instead.\n */\nexport function fetch<T extends Array<unknown>, A extends Action>(\n  opts: FetchOpts<T, A>\n) {\n  return (source: ActionStatesStream<T, A>): Observable<Action> => {\n    if (opts.id) {\n      const groupedFetches = source.pipe(\n        mapActionAndState(),\n        groupBy(([action, ...store]) => {\n          return opts.id(action, ...store);\n        })\n      );\n\n      return groupedFetches.pipe(\n        mergeMap((pairs) =>\n          pairs.pipe(switchMap(runWithErrorHandling(opts.run, opts.onError)))\n        )\n      );\n    }\n\n    return source.pipe(\n      mapActionAndState(),\n      concatMap(runWithErrorHandling(opts.run, opts.onError))\n    );\n  };\n}\n\n/**\n * @whatItDoes Handles data fetching as part of router navigation.\n *\n * Data fetching implemented naively suffers from race conditions and poor error handling.\n *\n * `navigation` addresses these problems.\n *\n * It checks if an activated router state contains the passed in component type, and, if it does, runs the `run`\n * callback. It provides the activated snapshot associated with the component and the current state. And it only runs\n * the last request.\n *\n * ## Example:\n *\n * ```typescript\n * @Injectable()\n * class TodoEffects {\n *   loadTodo$ = createEffect(() =>\n *     this.actions$.pipe(\n *       // listens for the routerNavigation action from @ngrx/router-store\n *       navigation(TodoComponent, {\n *         run: (activatedRouteSnapshot: ActivatedRouteSnapshot) => {\n *           return this.backend\n *             .fetchTodo(activatedRouteSnapshot.params['id'])\n *             .pipe(\n *               map((todo) => ({\n *                 type: 'LOAD_TODO_SUCCESS',\n *                 todo: todo,\n *               }))\n *             );\n *         },\n *         onError: (\n *           activatedRouteSnapshot: ActivatedRouteSnapshot,\n *           error: any\n *         ) => {\n *           // we can log and error here and return null\n *           // we can also navigate back\n *           return null;\n *         },\n *       })\n *     )\n *   );\n *\n *   constructor(private actions$: Actions, private backend: Backend) {}\n * }\n * ```\n *\n * @param component\n * @param opts\n *\n * @deprecated This will be removed in Nx v21. Import `navigation` from `@ngrx/router-store/data-persistence` instead.\n */\nexport function navigation<T extends Array<unknown>, A extends Action>(\n  component: Type<any>,\n  opts: HandleNavigationOpts<T>\n) {\n  return (source: ActionStatesStream<T, A>) => {\n    const nav = source.pipe(\n      mapActionAndState(),\n      filter(([action]) => isStateSnapshot(action)),\n      map(([action, ...slices]) => {\n        if (!isStateSnapshot(action)) {\n          // Because of the above filter we'll never get here,\n          // but this properly type narrows `action`\n          return;\n        }\n\n        return [\n          findSnapshot(component, action.payload.routerState.root),\n          ...slices,\n        ] as [ActivatedRouteSnapshot, ...T];\n      }),\n      filter(([snapshot]) => !!snapshot)\n    );\n\n    return nav.pipe(switchMap(runWithErrorHandling(opts.run, opts.onError)));\n  };\n}\n\nfunction isStateSnapshot(\n  action: any\n): action is RouterNavigationAction<RouterStateSnapshot> {\n  return action.type === ROUTER_NAVIGATION;\n}\n\nfunction runWithErrorHandling<T extends Array<unknown>, A, R>(\n  run: (a: A, ...slices: [...T]) => Observable<R> | R | void,\n  onError: any\n) {\n  return ([action, ...slices]: [A, ...T]): Observable<R> => {\n    try {\n      const r = wrapIntoObservable(run(action, ...slices));\n      return r.pipe(catchError((e) => wrapIntoObservable(onError(action, e))));\n    } catch (e) {\n      return wrapIntoObservable(onError(action, e));\n    }\n  };\n}\n\n/**\n * @whatItDoes maps Observable<Action | [Action, State]> to\n * Observable<[Action, State]>\n */\nfunction mapActionAndState<T extends Array<unknown>, A>() {\n  return (source: Observable<ActionOrActionWithStates<T, A>>) => {\n    return source.pipe(\n      map((value) => normalizeActionAndState(value) as [A, ...T])\n    );\n  };\n}\n\n/**\n * @whatItDoes Normalizes either a bare action or an array of action and slices\n * into an array of action and slices (or undefined)\n */\nfunction normalizeActionAndState<T extends Array<unknown>, A>(\n  args: ActionOrActionWithStates<T, A>\n): [A, ...T] {\n  let action: A, slices: T;\n\n  if (args instanceof Array) {\n    [action, ...slices] = args;\n  } else {\n    slices = [] as T;\n    action = args;\n  }\n\n  return [action, ...slices];\n}\n\nfunction findSnapshot(\n  component: Type<any>,\n  s: ActivatedRouteSnapshot\n): ActivatedRouteSnapshot {\n  if (s.routeConfig && s.routeConfig.component === component) {\n    return s;\n  }\n  for (const c of s.children) {\n    const ss = findSnapshot(component, c);\n    if (ss) {\n      return ss;\n    }\n  }\n  return null;\n}\n\nfunction wrapIntoObservable<O>(obj: Observable<O> | O | void): Observable<O> {\n  if (isObservable(obj)) {\n    return obj;\n  } else if (!obj) {\n    return of();\n  } else {\n    return of(obj as O);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"nx-angular.mjs","sources":["../../../../packages/angular/nx-angular.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"AAAA;;AAEG"}

package/generators.json

@@ -86,7 +86,7 @@
       "schema": "./src/generators/move/schema.json",
       "aliases": ["mv"],
       "description": "Moves an Angular application or library to another folder within the workspace and updates the project configuration.",
-      "x-deprecated": "Use the `@nx/workspace:move` generator instead. This generator will be removed in Nx v19."
+      "x-deprecated": "Use the `@nx/workspace:move` generator instead. This generator will be removed in Nx v22."
     },
     "convert-to-with-mf": {
       "factory": "./src/generators/convert-to-with-mf/convert-to-with-mf",
@@ -110,7 +110,7 @@
       "factory": "./src/generators/ngrx/ngrx",
       "schema": "./src/generators/ngrx/schema.json",
       "description": "Adds NgRx support to an application or library.",
-      "x-deprecated": "This generator is deprecated and will be removed in a future version of Nx. Use the 'ngrx-root-store' and 'ngrx-feature-store' generators instead."
+      "x-deprecated": "Use the 'ngrx-root-store' and 'ngrx-feature-store' generators instead. It will be removed in Nx v22."
     },
     "ngrx-feature-store": {
       "factory": "./src/generators/ngrx-feature-store/ngrx-feature-store",

package/index.d.ts

@@ -1 +1 @@
-export { fetch, navigation, optimisticUpdate, pessimisticUpdate, } from './src/runtime/nx/data-persistence';
+export {};

package/migrations.json

@@ -1,74 +1,5 @@
 {
   "generators": {
-    "remove-library-generator-simple-module-name-option": {
-      "cli": "nx",
-      "version": "16.0.0-beta.1",
-      "description": "Replace the deprecated library generator 'simpleModuleName' option from generator defaults with 'simpleName'",
-      "factory": "./src/migrations/update-16-0-0/remove-library-generator-simple-module-name-option"
-    },
-    "update-16-0-0-add-nx-packages": {
-      "cli": "nx",
-      "version": "16.0.0-beta.1",
-      "description": "Replace @nrwl/angular with @nx/angular",
-      "implementation": "./src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages"
-    },
-    "remove-protractor-defaults-from-generators": {
-      "cli": "nx",
-      "version": "16.0.0-beta.6",
-      "description": "Remove protractor as default e2eTestRunner from nxJson and project configurations",
-      "implementation": "./src/migrations/update-16-0-0/remove-protractor-defaults"
-    },
-    "remove-karma-defaults-from-generators": {
-      "cli": "nx",
-      "version": "16.0.0-beta.6",
-      "description": "Remove karma as default unitTestRunner from nxJson and project configurations",
-      "implementation": "./src/migrations/update-16-0-0/remove-karma-defaults"
-    },
-    "remove-render-module-platform-server-exports": {
-      "cli": "nx",
-      "version": "16.1.0-beta.1",
-      "requires": {
-        "@angular/core": ">=15.0.0"
-      },
-      "description": "Remove exported `@angular/platform-server` `renderModule` method. The `renderModule` method is now exported by the Angular CLI.",
-      "factory": "./src/migrations/update-16-1-0/remove-render-module-platform-server-exports"
-    },
-    "remove-ngcc-invocation": {
-      "cli": "nx",
-      "version": "16.1.0-beta.1",
-      "requires": {
-        "@angular/core": ">=16.0.0-rc.4"
-      },
-      "description": "Remove 'ngcc' invocation if exists from the 'postinstall' script in package.json.",
-      "factory": "./src/migrations/update-16-1-0/remove-ngcc-invocation"
-    },
-    "extract-app-config-for-standalone": {
-      "cli": "nx",
-      "version": "16.1.0-beta.1",
-      "requires": {
-        "@angular/core": ">=16.0.0-rc.4"
-      },
-      "description": "Extract the app config for standalone apps",
-      "factory": "./src/migrations/update-16-1-0/extract-standalone-config-from-bootstrap"
-    },
-    "update-server-executor-config": {
-      "cli": "nx",
-      "version": "16.1.0-beta.1",
-      "requires": {
-        "@angular/core": ">=16.0.0-rc.4"
-      },
-      "description": "Update server executors' configuration to disable 'buildOptimizer' for non optimized builds.",
-      "factory": "./src/migrations/update-16-1-0/update-server-executor-config"
-    },
-    "update-angular-cli-version-16-0-0": {
-      "cli": "nx",
-      "version": "16.1.0-beta.1",
-      "requires": {
-        "@angular/core": ">=16.0.0"
-      },
-      "description": "Update the @angular/cli package version to ~16.0.0.",
-      "factory": "./src/migrations/update-16-1-0/update-angular-cli"
-    },
     "switch-data-persistence-operators-imports-to-ngrx-router-store": {
       "cli": "nx",
       "version": "16.2.0-beta.0",
@@ -362,6 +293,15 @@
       "version": "21.0.0-beta.3",
       "description": "Set the `continuous` option to `true` for continuous tasks.",
       "factory": "./src/migrations/update-21-0-0/set-continuous-option"
+    },
+    "change-data-persistence-operators-imports-to-ngrx-router-store-data-persistence": {
+      "cli": "nx",
+      "version": "21.0.0-beta.5",
+      "requires": {
+        "@ngrx/store": ">=16.0.0"
+      },
+      "description": "Change the data persistence operator imports to '@ngrx/router-store/data-persistence'.",
+      "factory": "./src/migrations/update-21-0-0/change-data-persistence-operators-imports-to-ngrx-router-store-data-persistence"
     }
   },
   "packageJsonUpdates": {
@@ -1666,6 +1606,15 @@
           "alwaysAddToPackageJson": false
         }
       }
+    },
+    "20.8.1": {
+      "version": "20.8.1-beta.0",
+      "packages": {
+        "@nx/angular-rspack": {
+          "version": "^20.7.0",
+          "alwaysAddToPackageJson": false
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/angular",
-  "version": "21.0.0-canary.20250416-caa26a7",
+  "version": "21.0.0-canary.20250419-8619c1d",
   "private": false,
   "description": "The Nx Plugin for Angular contains executors, generators, and utilities for managing Angular applications and libraries within an Nx workspace. It provides: \n\n- Integration with libraries such as Storybook, Jest, ESLint, Tailwind CSS, Playwright and Cypress. \n\n- Generators to help scaffold code quickly (like: Micro Frontends, Libraries, both internal to your codebase and publishable to npm) \n\n- Single Component Application Modules (SCAMs) \n\n- NgRx helpers. \n\n- Utilities for automatic workspace refactoring.",
   "repository": {
@@ -33,7 +33,6 @@
     "./src/builders/*.impl": "./src/builders/*.impl.js",
     "./src/executors/*/schema.json": "./src/executors/*/schema.json",
     "./src/executors/*.impl": "./src/executors/*.impl.js",
-    "./src/executors/*/compat": "./src/executors/*/compat.js",
     "./package.json": {
       "default": "./package.json"
     },
@@ -44,10 +43,6 @@
     "./mf": {
       "types": "./mf/index.d.ts",
       "default": "./fesm2022/nx-angular-mf.mjs"
-    },
-    "./testing": {
-      "types": "./testing/index.d.ts",
-      "default": "./fesm2022/nx-angular-testing.mjs"
     }
   },
   "author": "Victor Savkin",
@@ -72,14 +67,14 @@
     "semver": "^7.5.3",
     "tslib": "^2.3.0",
     "webpack-merge": "^5.8.0",
-    "@nx/devkit": "21.0.0-canary.20250416-caa26a7",
-    "@nx/js": "21.0.0-canary.20250416-caa26a7",
-    "@nx/eslint": "21.0.0-canary.20250416-caa26a7",
-    "@nx/webpack": "21.0.0-canary.20250416-caa26a7",
-    "@nx/rspack": "21.0.0-canary.20250416-caa26a7",
-    "@nx/module-federation": "21.0.0-canary.20250416-caa26a7",
-    "@nx/web": "21.0.0-canary.20250416-caa26a7",
-    "@nx/workspace": "21.0.0-canary.20250416-caa26a7",
+    "@nx/devkit": "21.0.0-canary.20250419-8619c1d",
+    "@nx/js": "21.0.0-canary.20250419-8619c1d",
+    "@nx/eslint": "21.0.0-canary.20250419-8619c1d",
+    "@nx/webpack": "21.0.0-canary.20250419-8619c1d",
+    "@nx/rspack": "21.0.0-canary.20250419-8619c1d",
+    "@nx/module-federation": "21.0.0-canary.20250419-8619c1d",
+    "@nx/web": "21.0.0-canary.20250419-8619c1d",
+    "@nx/workspace": "21.0.0-canary.20250419-8619c1d",
     "piscina": "^4.4.0"
   },
   "peerDependencies": {

package/src/builders/dev-server/schema.d.ts

@@ -25,6 +25,9 @@ interface BaseSchema {
 }
 
 export type SchemaWithBrowserTarget = BaseSchema & {
+  /**
+   * @deprecated Use `buildTarget` instead. It will be removed when Angular v20 is released.
+   */
   browserTarget: string;
 };
 

package/src/builders/dev-server/schema.json

@@ -17,7 +17,7 @@
       "type": "string",
       "description": "A browser builder target to serve in the format of `project:target[:configuration]`. Ignored if `buildTarget` is set.",
       "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$",
-      "x-deprecated": "Use 'buildTarget' instead. It will be removed in Nx v20."
+      "x-deprecated": "Use 'buildTarget' instead. It will be removed when Angular v20 is released."
     },
     "buildTarget": {
       "type": "string",

package/src/builders/webpack-browser/schema.d.ts

@@ -7,9 +7,4 @@ export type BrowserBuilderSchema = Schema & {
   indexHtmlTransformer?: string;
   buildLibsFromSource?: boolean;
   watchDependencies?: boolean;
-
-  /**
-   * @deprecated Use `indexHtmlTransformer` instead. It will be removed in Nx 21.
-   */
-  indexFileTransformer?: string;
 };

package/src/builders/webpack-browser/webpack-browser.impl.js

@@ -26,7 +26,7 @@ function shouldSkipInitialTargetRun(projectGraph, project, target) {
 function executeWebpackBrowserBuilder(options, context) {
     options.buildLibsFromSource ??= true;
     options.watchDependencies ??= true;
-    const { buildLibsFromSource, customWebpackConfig, indexHtmlTransformer, indexFileTransformer, watchDependencies, ...delegateBuilderOptions } = options;
+    const { buildLibsFromSource, customWebpackConfig, indexHtmlTransformer, watchDependencies, ...delegateBuilderOptions } = options;
     process.env.NX_BUILD_LIBS_FROM_SOURCE = `${buildLibsFromSource}`;
     process.env.NX_BUILD_TARGET = (0, devkit_1.targetToTargetString)({ ...context.target });
     const pathToWebpackConfig = customWebpackConfig?.path &&
@@ -34,9 +34,8 @@ function executeWebpackBrowserBuilder(options, context) {
     if (pathToWebpackConfig && !(0, fs_1.existsSync)(pathToWebpackConfig)) {
         throw new Error(`Custom Webpack Config File Not Found!\nTo use a custom webpack config, please ensure the path to the custom webpack file is correct: \n${pathToWebpackConfig}`);
     }
-    const normalizedIndexHtmlTransformer = indexHtmlTransformer ?? indexFileTransformer;
-    const pathToIndexFileTransformer = normalizedIndexHtmlTransformer &&
-        (0, devkit_1.joinPathFragments)(context.workspaceRoot, normalizedIndexHtmlTransformer);
+    const pathToIndexFileTransformer = indexHtmlTransformer &&
+        (0, devkit_1.joinPathFragments)(context.workspaceRoot, indexHtmlTransformer);
     if (pathToIndexFileTransformer && !(0, fs_1.existsSync)(pathToIndexFileTransformer)) {
         throw new Error(`File containing Index File Transformer function Not Found!\n Please ensure the path to the file containing the function is correct: \n${pathToIndexFileTransformer}`);
     }

package/src/executors/module-federation-dev-server/schema.d.ts

@@ -29,6 +29,9 @@ interface BaseSchema {
 }
 
 export type SchemaWithBrowserTarget = BaseSchema & {
+  /**
+   * @deprecated Use `buildTarget` instead. It will be removed when Angular v20 is released.
+   */
   browserTarget: string;
 };
 

package/src/executors/module-federation-dev-server/schema.json

@@ -15,7 +15,7 @@
       "type": "string",
       "description": "A browser builder target to serve in the format of `project:target[:configuration]`.",
       "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$",
-      "x-deprecated": "Use 'buildTarget' instead. It will be removed in Nx v20."
+      "x-deprecated": "Use 'buildTarget' instead. It will be removed when Angular v20 is released."
     },
     "buildTarget": {
       "type": "string",

package/src/generators/add-linting/lib/create-eslint-configuration.d.ts

@@ -5,7 +5,7 @@ type EslintExtensionSchema = {
     prefix: string;
 };
 /**
- * @deprecated Use tools from `@nx/eslint/src/generators/utils/eslint-file` instead
+ * @deprecated Use tools from `@nx/eslint/src/generators/utils/eslint-file` instead. It will be removed in Nx v22.
  */
 export declare const extendAngularEslintJson: (json: Linter.Config, options: EslintExtensionSchema) => {
     overrides: ({
@@ -75,7 +75,7 @@ export declare const extendAngularEslintJson: (json: Linter.Config, options: Esl
     rules?: Partial<Linter.RulesRecord>;
 };
 /**
- * @deprecated Use {@link extendAngularEslintJson} instead
+ * @deprecated Use {@link extendAngularEslintJson} instead. It will be removed in Nx v22.
  */
 export declare function createEsLintConfiguration(tree: Tree, options: AddLintingGeneratorSchema): void;
 export {};