@angular/core 17.0.0-next.3 → 17.0.0-next.5

package/fesm2022/rxjs-interop.mjs

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

package/fesm2022/testing.mjs

@@ -1,10 +1,11 @@
 /**
- * @license Angular v17.0.0-next.3
+ * @license Angular v17.0.0-next.5
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
 
-import { getDebugNode, RendererFactory2, InjectionToken, ɵstringify, ɵReflectionCapabilities, Directive, Component, Pipe, NgModule, ɵgetAsyncClassMetadata, ɵgenerateStandaloneInDeclarationsError, ɵUSE_RUNTIME_DEPS_TRACKER_FOR_JIT, ɵdepsTracker, ɵgetInjectableDef, resolveForwardRef, ɵNG_COMP_DEF, ɵisComponentDefPendingResolution, ɵresolveComponentResources, ɵRender3NgModuleRef, ApplicationInitStatus, LOCALE_ID, ɵDEFAULT_LOCALE_ID, ɵsetLocaleId, ɵRender3ComponentFactory, ɵcompileComponent, ɵNG_DIR_DEF, ɵcompileDirective, ɵNG_PIPE_DEF, ɵcompilePipe, ɵNG_MOD_DEF, ɵtransitiveScopesFor, ɵpatchComponentDefWithScope, ɵNG_INJ_DEF, ɵcompileNgModuleDefs, ɵclearResolutionOfComponentResourcesQueue, ɵrestoreComponentResolutionQueue, provideZoneChangeDetection, Compiler, COMPILER_OPTIONS, Injector, ɵisEnvironmentProviders, ɵNgModuleFactory, ModuleWithComponentFactories, ɵconvertToBitFlags, InjectFlags, ɵsetAllowDuplicateNgModuleIdsForTest, ɵresetCompiledComponents, ɵsetUnknownElementStrictMode, ɵsetUnknownPropertyStrictMode, ɵgetUnknownElementStrictMode, ɵgetUnknownPropertyStrictMode, EnvironmentInjector, NgZone, ɵflushModuleScopingQueueAsMuchAsPossible } from '@angular/core';
+import { ɵDeferBlockState, ɵtriggerResourceLoading, ɵrenderDeferBlockState, ɵCONTAINER_HEADER_OFFSET, ɵgetDeferBlocks, getDebugNode, RendererFactory2, InjectionToken, ɵstringify, ɵReflectionCapabilities, Directive, Component, Pipe, NgModule, ɵgetAsyncClassMetadata, ɵgenerateStandaloneInDeclarationsError, ɵDeferBlockBehavior, ɵUSE_RUNTIME_DEPS_TRACKER_FOR_JIT, ɵdepsTracker, ɵgetInjectableDef, resolveForwardRef, ɵNG_COMP_DEF, ɵisComponentDefPendingResolution, ɵresolveComponentResources, ɵRender3NgModuleRef, ApplicationInitStatus, LOCALE_ID, ɵDEFAULT_LOCALE_ID, ɵsetLocaleId, ɵRender3ComponentFactory, ɵcompileComponent, ɵNG_DIR_DEF, ɵcompileDirective, ɵNG_PIPE_DEF, ɵcompilePipe, ɵNG_MOD_DEF, ɵtransitiveScopesFor, ɵpatchComponentDefWithScope, ɵNG_INJ_DEF, ɵcompileNgModuleDefs, ɵclearResolutionOfComponentResourcesQueue, ɵrestoreComponentResolutionQueue, provideZoneChangeDetection, Compiler, ɵDEFER_BLOCK_CONFIG, COMPILER_OPTIONS, Injector, ɵisEnvironmentProviders, ɵNgModuleFactory, ModuleWithComponentFactories, ɵconvertToBitFlags, InjectFlags, ɵsetAllowDuplicateNgModuleIdsForTest, ɵresetCompiledComponents, ɵsetUnknownElementStrictMode, ɵsetUnknownPropertyStrictMode, ɵgetUnknownElementStrictMode, ɵgetUnknownPropertyStrictMode, EnvironmentInjector, NgZone, ɵZoneAwareQueueingScheduler, ɵflushModuleScopingQueueAsMuchAsPossible } from '@angular/core';
+export { ɵDeferBlockBehavior as DeferBlockBehavior, ɵDeferBlockState as DeferBlockState } from '@angular/core';
 import { ResourceLoader } from '@angular/compiler';
 
 /**
@@ -50,15 +51,93 @@ function async(fn) {
     return waitForAsync(fn);
 }
 
+/**
+ * Represents an individual `{#defer}` block for testing purposes.
+ *
+ * @publicApi
+ * @developerPreview
+ */
+class DeferBlockFixture {
+    /** @nodoc */
+    constructor(block, componentFixture) {
+        this.block = block;
+        this.componentFixture = componentFixture;
+    }
+    /**
+     * Renders the specified state of the defer fixture.
+     * @param state the defer state to render
+     */
+    async render(state) {
+        if (!hasStateTemplate(state, this.block)) {
+            const stateAsString = getDeferBlockStateNameFromEnum(state);
+            throw new Error(`Tried to render this defer block in the \`${stateAsString}\` state, ` +
+                `but there was no \`{:${stateAsString.toLowerCase()}}\` section defined in a template.`);
+        }
+        if (state === ɵDeferBlockState.Complete) {
+            await ɵtriggerResourceLoading(this.block.tDetails, this.block.lView);
+        }
+        ɵrenderDeferBlockState(state, this.block.tNode, this.block.lContainer);
+        this.componentFixture.detectChanges();
+        return this.componentFixture.whenStable();
+    }
+    /**
+     * Retrieves all nested child defer block fixtures
+     * in a given defer block.
+     */
+    getDeferBlocks() {
+        const deferBlocks = [];
+        // An LContainer that represents a defer block has at most 1 view, which is
+        // located right after an LContainer header. Get a hold of that view and inspect
+        // it for nested defer blocks.
+        const deferBlockFixtures = [];
+        if (this.block.lContainer.length >= ɵCONTAINER_HEADER_OFFSET) {
+            const lView = this.block.lContainer[ɵCONTAINER_HEADER_OFFSET];
+            ɵgetDeferBlocks(lView, deferBlocks);
+            for (const block of deferBlocks) {
+                deferBlockFixtures.push(new DeferBlockFixture(block, this.componentFixture));
+            }
+        }
+        return Promise.resolve(deferBlockFixtures);
+    }
+}
+function hasStateTemplate(state, block) {
+    switch (state) {
+        case ɵDeferBlockState.Placeholder:
+            return block.tDetails.placeholderTmplIndex !== null;
+        case ɵDeferBlockState.Loading:
+            return block.tDetails.loadingTmplIndex !== null;
+        case ɵDeferBlockState.Error:
+            return block.tDetails.errorTmplIndex !== null;
+        case ɵDeferBlockState.Complete:
+            return true;
+        default:
+            return false;
+    }
+}
+function getDeferBlockStateNameFromEnum(state) {
+    switch (state) {
+        case ɵDeferBlockState.Placeholder:
+            return 'Placeholder';
+        case ɵDeferBlockState.Loading:
+            return 'Loading';
+        case ɵDeferBlockState.Error:
+            return 'Error';
+        default:
+            return 'Main';
+    }
+}
+
 /**
  * Fixture for debugging and testing a component.
  *
  * @publicApi
  */
 class ComponentFixture {
-    constructor(componentRef, ngZone, _autoDetect) {
+    /** @nodoc */
+    constructor(componentRef, ngZone, effectRunner, _autoDetect) {
         this.componentRef = componentRef;
         this.ngZone = ngZone;
+        this.effectRunner = effectRunner;
         this._autoDetect = _autoDetect;
         this._isStable = true;
         this._isDestroyed = false;
@@ -131,6 +210,7 @@ class ComponentFixture {
      * Trigger a change detection cycle for the component.
      */
     detectChanges(checkNoChanges = true) {
+        this.effectRunner?.flush();
         if (this.ngZone != null) {
             // Run the change detection inside the NgZone so that any async tasks as part of the change
             // detection are captured by the zone and can be waited for in isStable.
@@ -188,6 +268,19 @@ class ComponentFixture {
             return this._promise;
         }
     }
+    /**
+     * Retrieves all defer block fixtures in the component fixture
+     */
+    getDeferBlocks() {
+        const deferBlocks = [];
+        const lView = this.componentRef.hostView['_lView'];
+        ɵgetDeferBlocks(lView, deferBlocks);
+        const deferBlockFixtures = [];
+        for (const block of deferBlocks) {
+            deferBlockFixtures.push(new DeferBlockFixture(block, this));
+        }
+        return Promise.resolve(deferBlockFixtures);
+    }
     _getRenderer() {
         if (this._renderer === undefined) {
             this._renderer = this.componentRef.injector.get(RendererFactory2, null);
@@ -672,6 +765,7 @@ class TestBedCompiler {
         this.providerOverridesByToken = new Map();
         this.scopesWithOverriddenProviders = new Set();
         this.testModuleRef = null;
+        this.deferBlockBehavior = ɵDeferBlockBehavior.Manual;
         class DynamicTestModule {
         }
         this.testModuleType = DynamicTestModule;
@@ -699,6 +793,7 @@ class TestBedCompiler {
         if (moduleDef.schemas !== undefined) {
             this.schemas.push(...moduleDef.schemas);
         }
+        this.deferBlockBehavior = moduleDef.deferBlockBehavior ?? ɵDeferBlockBehavior.Manual;
     }
     overrideModule(ngModule, override) {
         if (ɵUSE_RUNTIME_DEPS_TRACKER_FOR_JIT) {
@@ -775,7 +870,7 @@ class TestBedCompiler {
         const def = type[ɵNG_COMP_DEF];
         const hasStyleUrls = () => {
             const metadata = this.resolvers.component.resolve(type);
-            return !!metadata.styleUrls && metadata.styleUrls.length > 0;
+            return !!metadata.styleUrl || !!metadata.styleUrls?.length;
         };
         const overrideStyleUrls = !!def && !ɵisComponentDefPendingResolution(type) && hasStyleUrls();
         // In Ivy, compiling a component does not require knowing the module providing the
@@ -785,7 +880,7 @@ class TestBedCompiler {
         // resolution). In order to avoid this, we preemptively set styleUrls to an empty array,
         // preserve current styles available on Component def and restore styles back once compilation
         // is complete.
-        const override = overrideStyleUrls ? { template, styles: [], styleUrls: [] } : { template };
+        const override = overrideStyleUrls ? { template, styles: [], styleUrls: [], styleUrl: undefined } : { template };
         this.overrideComponent(type, { set: override });
         if (overrideStyleUrls && def.styles && def.styles.length > 0) {
             this.existingComponentStyles.set(type, def.styles);
@@ -1287,6 +1382,7 @@ class TestBedCompiler {
         const providers = [
             provideZoneChangeDetection(),
             { provide: Compiler, useFactory: () => new R3TestCompiler(this) },
+            { provide: ɵDEFER_BLOCK_CONFIG, useValue: { behavior: this.deferBlockBehavior } },
             ...this.providers,
             ...this.providerOverrides,
         ];
@@ -1496,6 +1592,11 @@ function getTestBed() {
  */
 class TestBedImpl {
     constructor() {
+        /**
+         * Defer block behavior option that specifies whether defer blocks will be triggered manually
+         * or set to play through.
+         */
+        this._instanceDeferBlockBehavior = ɵDeferBlockBehavior.Manual;
         // Properties
         this.platform = null;
         this.ngModule = null;
@@ -1614,6 +1715,9 @@ class TestBedImpl {
     static get ngModule() {
         return TestBedImpl.INSTANCE.ngModule;
     }
+    static flushEffects() {
+        return TestBedImpl.INSTANCE.flushEffects();
+    }
     /**
      * Initialize the environment for testing with a compiler factory, a PlatformRef, and an
      * angular module. These are common to every test in the suite.
@@ -1684,6 +1788,7 @@ class TestBedImpl {
                 this._instanceTeardownOptions = undefined;
                 this._instanceErrorOnUnknownElementsOption = undefined;
                 this._instanceErrorOnUnknownPropertiesOption = undefined;
+                this._instanceDeferBlockBehavior = ɵDeferBlockBehavior.Manual;
             }
         }
         return this;
@@ -1709,6 +1814,7 @@ class TestBedImpl {
         this._instanceTeardownOptions = moduleDef.teardown;
         this._instanceErrorOnUnknownElementsOption = moduleDef.errorOnUnknownElements;
         this._instanceErrorOnUnknownPropertiesOption = moduleDef.errorOnUnknownProperties;
+        this._instanceDeferBlockBehavior = moduleDef.deferBlockBehavior ?? ɵDeferBlockBehavior.Manual;
         // Store the current value of the strict mode option,
         // so we can restore it later
         this._previousErrorOnUnknownElementsOption = ɵgetUnknownElementStrictMode();
@@ -1795,7 +1901,7 @@ class TestBedImpl {
         const componentFactory = new ɵRender3ComponentFactory(componentDef);
         const initComponent = () => {
             const componentRef = componentFactory.create(Injector.NULL, [], `#${rootElId}`, this.testModuleRef);
-            return new ComponentFixture(componentRef, ngZone, autoDetect);
+            return new ComponentFixture(componentRef, ngZone, this.inject(ɵZoneAwareQueueingScheduler, null), autoDetect);
         };
         const fixture = ngZone ? ngZone.run(initComponent) : initComponent();
         this._activeFixtures.push(fixture);
@@ -1894,6 +2000,9 @@ class TestBedImpl {
             TestBedImpl._environmentTeardownOptions?.destroyAfterEach ??
             TEARDOWN_TESTING_MODULE_ON_DESTROY_DEFAULT;
     }
+    getDeferBlockBehavior() {
+        return this._instanceDeferBlockBehavior;
+    }
     tearDownTestingModule() {
         // If the module ref has already been destroyed, we won't be able to get a test renderer.
         if (this._testModuleRef === null) {
@@ -1920,6 +2029,14 @@ class TestBedImpl {
             testRenderer.removeAllRootElements?.();
         }
     }
+    /**
+     * Execute any pending effects.
+     *
+     * @developerPreview
+     */
+    flushEffects() {
+        this.inject(ɵZoneAwareQueueingScheduler).flush();
+    }
 }
 /**
  * @description
@@ -2046,5 +2163,5 @@ const __core_private_testing_placeholder__ = '';
  * Generated bundle index. Do not edit.
  */
 
-export { ComponentFixture, ComponentFixtureAutoDetect, ComponentFixtureNoNgZone, InjectSetupWrapper, TestBed, TestComponentRenderer, __core_private_testing_placeholder__, async, discardPeriodicTasks, fakeAsync, flush, flushMicrotasks, getTestBed, inject, resetFakeAsyncZone, tick, waitForAsync, withModule, MetadataOverrider as ɵMetadataOverrider };
+export { ComponentFixture, ComponentFixtureAutoDetect, ComponentFixtureNoNgZone, DeferBlockFixture, InjectSetupWrapper, TestBed, TestComponentRenderer, __core_private_testing_placeholder__, async, discardPeriodicTasks, fakeAsync, flush, flushMicrotasks, getTestBed, inject, resetFakeAsyncZone, tick, waitForAsync, withModule, MetadataOverrider as ɵMetadataOverrider };
 //# sourceMappingURL=testing.mjs.map