@angular/core 16.0.0-rc.3 → 16.0.0-rc.4

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v16.0.0-rc.3
+ * @license Angular v16.0.0-rc.4
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "16.0.0-rc.3",
+  "version": "16.0.0-rc.4",
   "description": "Angular - the core framework",
   "author": "angular",
   "license": "MIT",

package/rxjs-interop/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v16.0.0-rc.3
+ * @license Angular v16.0.0-rc.4
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -28,7 +28,7 @@ export declare function takeUntilDestroyed<T>(destroyRef?: DestroyRef): MonoType
  *
  * The signal's value will be propagated into the `Observable`'s subscribers using an `effect`.
  *
- * `toObservable` must be called in an injection context.
+ * `toObservable` must be called in an injection context unless an injector is provided via options.
  *
  * @developerPreview
  */
@@ -41,7 +41,7 @@ export declare function toObservable<T>(source: Signal<T>, options?: ToObservabl
  */
 export declare interface ToObservableOptions {
     /**
-     * The `Injector` to use when creating the effect.
+     * The `Injector` to use when creating the underlying `effect` which watches the signal.
      *
      * If this isn't specified, the current injection context will be used.
      */
@@ -56,16 +56,17 @@ export declare interface ToObservableOptions {
  * have the most recent value emitted by the subscription, and will throw an error if the
  * `Observable` errors.
  *
- * The subscription will last for the lifetime of the current injection context. That is, if
- * `toSignal` is called from a component context, the subscription will be cleaned up when the
- * component is destroyed. When called outside of a component, the current `EnvironmentInjector`'s
- * lifetime will be used (which is typically the lifetime of the application itself).
+ * Before the `Observable` emits its first value, the `Signal` will return `undefined`. To avoid
+ * this, either an `initialValue` can be passed or the `requireSync` option enabled.
  *
- * If the `Observable` does not produce a value before the `Signal` is read, the `Signal` will throw
- * an error. To avoid this, use a synchronous `Observable` (potentially created with the `startWith`
- * operator) or pass an initial value to `toSignal` as the second argument.
+ * By default, the subscription will be automatically cleaned up when the current injection context
+ * is destroyed. For example, when `toObservable` is called during the construction of a component,
+ * the subscription will be cleaned up when the component is destroyed. If an injection context is
+ * not available, an explicit `Injector` can be passed instead.
  *
- * `toSignal` must be called in an injection context.
+ * If the subscription should persist until the `Observable` itself completes, the `manualCleanup`
+ * option can be specified instead, which disables the automatic subscription teardown. No injection
+ * context is needed in this configuration as well.
  */
 export declare function toSignal<T>(source: Observable<T>): Signal<T | undefined>;
 
@@ -77,26 +78,116 @@ export declare function toSignal<T>(source: Observable<T>): Signal<T | undefined
  * have the most recent value emitted by the subscription, and will throw an error if the
  * `Observable` errors.
  *
- * The subscription will last for the lifetime of the current injection context. That is, if
- * `toSignal` is called from a component context, the subscription will be cleaned up when the
- * component is destroyed. When called outside of a component, the current `EnvironmentInjector`'s
- * lifetime will be used (which is typically the lifetime of the application itself).
+ * Before the `Observable` emits its first value, the `Signal` will return the configured
+ * `initialValue`, or `undefined` if no `initialValue` is provided. If the `Observable` is
+ * guaranteed to emit synchronously, then the `requireSync` option can be passed instead.
+ *
+ * By default, the subscription will be automatically cleaned up when the current injection context
+ * is destroyed. For example, when `toObservable` is called during the construction of a component,
+ * the subscription will be cleaned up when the component is destroyed. If an injection context is
+ * not available, an explicit `Injector` can be passed instead.
+ *
+ * If the subscription should persist until the `Observable` itself completes, the `manualCleanup`
+ * option can be specified instead, which disables the automatic subscription teardown. No injection
+ * context is needed in this configuration as well.
+ *
+ * @developerPreview
+ */
+export declare function toSignal<T>(source: Observable<T>, options?: ToSignalOptions<undefined> & {
+    requireSync?: false;
+}): Signal<T | undefined>;
+
+/**
+ * Get the current value of an `Observable` as a reactive `Signal`.
+ *
+ * `toSignal` returns a `Signal` which provides synchronous reactive access to values produced
+ * by the given `Observable`, by subscribing to that `Observable`. The returned `Signal` will always
+ * have the most recent value emitted by the subscription, and will throw an error if the
+ * `Observable` errors.
  *
  * Before the `Observable` emits its first value, the `Signal` will return the configured
- * `initialValue`. If the `Observable` is known to produce a value before the `Signal` will be read,
- * `initialValue` does not need to be passed.
+ * `initialValue`. If the `Observable` is guaranteed to emit synchronously, then the `requireSync`
+ * option can be passed instead.
  *
- * `toSignal` must be called in an injection context.
+ * By default, the subscription will be automatically cleaned up when the current injection context
+ * is destroyed. For example, when `toObservable` is called during the construction of a component,
+ * the subscription will be cleaned up when the component is destroyed. If an injection context is
+ * not available, an explicit `Injector` can be passed instead.
+ *
+ * If the subscription should persist until the `Observable` itself completes, the `manualCleanup`
+ * option can be specified instead, which disables the automatic subscription teardown. No injection
+ * context is needed in this configuration as well.
  *
  * @developerPreview
  */
-export declare function toSignal<T, U extends T | null | undefined>(source: Observable<T>, options: {
+export declare function toSignal<T, U extends T | null | undefined>(source: Observable<T>, options: ToSignalOptions<U> & {
     initialValue: U;
     requireSync?: false;
 }): Signal<T | U>;
 
-export declare function toSignal<T>(source: Observable<T>, options: {
+/**
+ * Get the current value of an `Observable` as a reactive `Signal`.
+ *
+ * `toSignal` returns a `Signal` which provides synchronous reactive access to values produced
+ * by the given `Observable`, by subscribing to that `Observable`. The returned `Signal` will always
+ * have the most recent value emitted by the subscription, and will throw an error if the
+ * `Observable` errors.
+ *
+ * With `requireSync` set to `true`, `toSignal` will assert that the `Observable` produces a value
+ * immediately upon subscription. No `initialValue` is needed in this case, and the returned signal
+ * does not include an `undefined` type.
+ *
+ * By default, the subscription will be automatically cleaned up when the current injection context
+ * is destroyed. For example, when `toObservable` is called during the construction of a component,
+ * the subscription will be cleaned up when the component is destroyed. If an injection context is
+ * not available, an explicit `Injector` can be passed instead.
+ *
+ * If the subscription should persist until the `Observable` itself completes, the `manualCleanup`
+ * option can be specified instead, which disables the automatic subscription teardown. No injection
+ * context is needed in this configuration as well.
+ *
+ * @developerPreview
+ */
+export declare function toSignal<T>(source: Observable<T>, options: ToSignalOptions<undefined> & {
     requireSync: true;
 }): Signal<T>;
 
+/**
+ * Options for `toSignal`.
+ *
+ * @publicApi
+ */
+export declare interface ToSignalOptions<T> {
+    /**
+     * Initial value for the signal produced by `toSignal`.
+     *
+     * This will be the value of the signal until the observable emits its first value.
+     */
+    initialValue?: T;
+    /**
+     * Whether to require that the observable emits synchronously when `toSignal` subscribes.
+     *
+     * If this is `true`, `toSignal` will assert that the observable produces a value immediately upon
+     * subscription. Setting this option removes the need to either deal with `undefined` in the
+     * signal type or provide an `initialValue`, at the cost of a runtime error if this requirement is
+     * not met.
+     */
+    requireSync?: boolean;
+    /**
+     * `Injector` which will provide the `DestroyRef` used to clean up the Observable subscription.
+     *
+     * If this is not provided, a `DestroyRef` will be retrieved from the current injection context,
+     * unless manual cleanup is requested.
+     */
+    injector?: Injector;
+    /**
+     * Whether the subscription should be automatically cleaned up (via `DestroyRef`) when
+     * `toObservable`'s creation context is destroyed.
+     *
+     * If manual cleanup is enabled, then `DestroyRef` is not used, and the subscription will persist
+     * until the `Observable` itself completes.
+     */
+    manualCleanup?: boolean;
+}
+
 export { }

package/schematics/migrations/guard-and-resolve-interfaces/bundle.js

@@ -60,7 +60,7 @@ var __async = (__this, __arguments, generator) => {
   });
 };
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/migrations/guard-and-resolve-interfaces/index.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/migrations/guard-and-resolve-interfaces/index.mjs
 var guard_and_resolve_interfaces_exports = {};
 __export(guard_and_resolve_interfaces_exports, {
   default: () => guard_and_resolve_interfaces_default
@@ -69,7 +69,7 @@ module.exports = __toCommonJS(guard_and_resolve_interfaces_exports);
 var import_schematics = require("@angular-devkit/schematics");
 var import_path3 = require("path");
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/project_tsconfig_paths.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/project_tsconfig_paths.mjs
 var import_core = require("@angular-devkit/core");
 function getProjectTsConfigPaths(tree) {
   return __async(this, null, function* () {
@@ -149,11 +149,11 @@ function getWorkspace(tree) {
   });
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/compiler_host.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/compiler_host.mjs
 var import_path = require("path");
 var import_typescript2 = __toESM(require("typescript"), 1);
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/parse_tsconfig.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/parse_tsconfig.mjs
 var path = __toESM(require("path"), 1);
 var import_typescript = __toESM(require("typescript"), 1);
 function parseTsconfigFile(tsconfigPath, basePath) {
@@ -170,7 +170,7 @@ function parseTsconfigFile(tsconfigPath, basePath) {
   return import_typescript.default.parseJsonConfigFileContent(config, parseConfigHost, basePath, {});
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/compiler_host.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/compiler_host.mjs
 function createMigrationProgram(tree, tsconfigPath, basePath, fakeFileRead, additionalFiles) {
   const { rootNames, options, host } = createProgramOptions(tree, tsconfigPath, basePath, fakeFileRead, additionalFiles);
   return import_typescript2.default.createProgram(rootNames, options, host);
@@ -203,13 +203,13 @@ function canMigrateFile(basePath, sourceFile, program) {
   return !(0, import_path.relative)(basePath, sourceFile.fileName).startsWith("..");
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/migrations/guard-and-resolve-interfaces/util.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/migrations/guard-and-resolve-interfaces/util.mjs
 var import_typescript7 = __toESM(require("typescript"), 1);
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/change_tracker.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/change_tracker.mjs
 var import_typescript4 = __toESM(require("typescript"), 1);
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/import_manager.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/import_manager.mjs
 var import_path2 = require("path");
 var import_typescript3 = __toESM(require("typescript"), 1);
 var ImportManager = class {
@@ -393,7 +393,7 @@ ${text}`;
   }
 };
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/change_tracker.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/change_tracker.mjs
 var ChangeTracker = class {
   constructor(_printer, _importRemapper) {
     __publicField(this, "_printer");
@@ -449,7 +449,7 @@ function normalizePath(path2) {
   return path2.replace(/\\/g, "/");
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/imports.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/imports.mjs
 var import_typescript5 = __toESM(require("typescript"), 1);
 function getImportOfIdentifier(typeChecker, node) {
   const symbol = typeChecker.getSymbolAtLocation(node);
@@ -521,7 +521,7 @@ function findImportSpecifier(nodes, specifierName) {
   });
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/nodes.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/nodes.mjs
 var import_typescript6 = __toESM(require("typescript"), 1);
 function closestNode(node, predicate) {
   let current = node.parent;
@@ -534,7 +534,7 @@ function closestNode(node, predicate) {
   return null;
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/migrations/guard-and-resolve-interfaces/util.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/migrations/guard-and-resolve-interfaces/util.mjs
 var deprecatedInterfaces = /* @__PURE__ */ new Set(["CanLoad", "CanMatch", "CanActivate", "CanDeactivate", "CanActivateChild", "Resolve"]);
 var routerModule = "@angular/router";
 function migrateFile(sourceFile, typeChecker, rewriteFn) {
@@ -647,7 +647,7 @@ function visitTypeReference(typeReference, typeChecker, changeTracker, sourceFil
   import_typescript7.default.forEachChild(typeReference, visitTypeReferenceChildren);
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/migrations/guard-and-resolve-interfaces/index.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/migrations/guard-and-resolve-interfaces/index.mjs
 function guard_and_resolve_interfaces_default() {
   return (tree) => __async(this, null, function* () {
     const { buildPaths, testPaths } = yield getProjectTsConfigPaths(tree);

package/schematics/migrations/remove-module-id/bundle.js

@@ -56,7 +56,7 @@ var __async = (__this, __arguments, generator) => {
   });
 };
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/migrations/remove-module-id/index.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/migrations/remove-module-id/index.mjs
 var remove_module_id_exports = {};
 __export(remove_module_id_exports, {
   default: () => remove_module_id_default
@@ -66,13 +66,13 @@ var import_schematics = require("@angular-devkit/schematics");
 var import_path2 = require("path");
 var import_typescript8 = __toESM(require("typescript"), 1);
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/extract_metadata.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/extract_metadata.mjs
 var import_typescript4 = __toESM(require("typescript"), 1);
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/decorators.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/decorators.mjs
 var import_typescript2 = __toESM(require("typescript"), 1);
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/imports.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/imports.mjs
 var import_typescript = __toESM(require("typescript"), 1);
 function getImportOfIdentifier(typeChecker, node) {
   const symbol = typeChecker.getSymbolAtLocation(node);
@@ -94,7 +94,7 @@ function getImportOfIdentifier(typeChecker, node) {
   };
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/decorators.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/decorators.mjs
 function getCallDecoratorImport(typeChecker, decorator) {
   if (!import_typescript2.default.isCallExpression(decorator.expression) || !import_typescript2.default.isIdentifier(decorator.expression.expression)) {
     return null;
@@ -103,7 +103,7 @@ function getCallDecoratorImport(typeChecker, decorator) {
   return getImportOfIdentifier(typeChecker, identifier);
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/ng_decorators.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/ng_decorators.mjs
 function getAngularDecorators(typeChecker, decorators) {
   return decorators.map((node) => ({ node, importData: getCallDecoratorImport(typeChecker, node) })).filter(({ importData }) => importData && importData.importModule.startsWith("@angular/")).map(({ node, importData }) => ({
     node,
@@ -113,7 +113,7 @@ function getAngularDecorators(typeChecker, decorators) {
   }));
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/functions.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/functions.mjs
 var import_typescript3 = __toESM(require("typescript"), 1);
 function unwrapExpression(node) {
   if (import_typescript3.default.isParenthesizedExpression(node) || import_typescript3.default.isAsExpression(node)) {
@@ -123,7 +123,7 @@ function unwrapExpression(node) {
   }
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/extract_metadata.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/extract_metadata.mjs
 function extractAngularClassMetadata(typeChecker, node) {
   const decorators = import_typescript4.default.getDecorators(node);
   if (!decorators || !decorators.length) {
@@ -150,7 +150,7 @@ function extractAngularClassMetadata(typeChecker, node) {
   };
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/project_tsconfig_paths.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/project_tsconfig_paths.mjs
 var import_core = require("@angular-devkit/core");
 function getProjectTsConfigPaths(tree) {
   return __async(this, null, function* () {
@@ -230,11 +230,11 @@ function getWorkspace(tree) {
   });
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/compiler_host.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/compiler_host.mjs
 var import_path = require("path");
 var import_typescript6 = __toESM(require("typescript"), 1);
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/parse_tsconfig.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/parse_tsconfig.mjs
 var path = __toESM(require("path"), 1);
 var import_typescript5 = __toESM(require("typescript"), 1);
 function parseTsconfigFile(tsconfigPath, basePath) {
@@ -251,7 +251,7 @@ function parseTsconfigFile(tsconfigPath, basePath) {
   return import_typescript5.default.parseJsonConfigFileContent(config, parseConfigHost, basePath, {});
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/compiler_host.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/compiler_host.mjs
 function createMigrationProgram(tree, tsconfigPath, basePath, fakeFileRead, additionalFiles) {
   const { rootNames, options, host } = createProgramOptions(tree, tsconfigPath, basePath, fakeFileRead, additionalFiles);
   return import_typescript6.default.createProgram(rootNames, options, host);
@@ -284,7 +284,7 @@ function canMigrateFile(basePath, sourceFile, program) {
   return !(0, import_path.relative)(basePath, sourceFile.fileName).startsWith("..");
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/utils/typescript/property_name.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/utils/typescript/property_name.mjs
 var import_typescript7 = __toESM(require("typescript"), 1);
 function getPropertyNameText(node) {
   if (import_typescript7.default.isIdentifier(node) || import_typescript7.default.isStringLiteralLike(node)) {
@@ -293,7 +293,7 @@ function getPropertyNameText(node) {
   return null;
 }
 
-// bazel-out/darwin-fastbuild/bin/packages/core/schematics/migrations/remove-module-id/index.mjs
+// bazel-out/darwin_arm64-fastbuild/bin/packages/core/schematics/migrations/remove-module-id/index.mjs
 function remove_module_id_default() {
   return (tree) => __async(this, null, function* () {
     const { buildPaths, testPaths } = yield getProjectTsConfigPaths(tree);