Add fourth approach: Static methods on child components

angular.json

@@ -287,6 +287,93 @@
           }
         }
       }
+    },
+    "static-factory-methods": {
+      "projectType": "application",
+      "schematics": {},
+      "root": "apps/static-factory-methods",
+      "sourceRoot": "apps/static-factory-methods/src",
+      "prefix": "nested-forms",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:browser",
+          "options": {
+            "outputPath": "dist/apps/static-factory-methods",
+            "index": "apps/static-factory-methods/src/index.html",
+            "main": "apps/static-factory-methods/src/main.ts",
+            "polyfills": "apps/static-factory-methods/src/polyfills.ts",
+            "tsConfig": "apps/static-factory-methods/tsconfig.app.json",
+            "aot": false,
+            "assets": [
+              "apps/static-factory-methods/src/favicon.ico",
+              "apps/static-factory-methods/src/assets"
+            ],
+            "styles": ["apps/static-factory-methods/src/styles.css"],
+            "scripts": []
+          },
+          "configurations": {
+            "production": {
+              "fileReplacements": [
+                {
+                  "replace": "apps/static-factory-methods/src/environments/environment.ts",
+                  "with": "apps/static-factory-methods/src/environments/environment.prod.ts"
+                }
+              ],
+              "optimization": true,
+              "outputHashing": "all",
+              "sourceMap": false,
+              "extractCss": true,
+              "namedChunks": false,
+              "aot": true,
+              "extractLicenses": true,
+              "vendorChunk": false,
+              "buildOptimizer": true,
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "2mb",
+                  "maximumError": "5mb"
+                }
+              ]
+            }
+          }
+        },
+        "serve": {
+          "builder": "@angular-devkit/build-angular:dev-server",
+          "options": {
+            "browserTarget": "static-factory-methods:build"
+          },
+          "configurations": {
+            "production": {
+              "browserTarget": "static-factory-methods:build:production"
+            }
+          }
+        },
+        "extract-i18n": {
+          "builder": "@angular-devkit/build-angular:extract-i18n",
+          "options": {
+            "browserTarget": "static-factory-methods:build"
+          }
+        },
+        "lint": {
+          "builder": "@angular-devkit/build-angular:tslint",
+          "options": {
+            "tsConfig": [
+              "apps/static-factory-methods/tsconfig.app.json",
+              "apps/static-factory-methods/tsconfig.spec.json"
+            ],
+            "exclude": ["**/node_modules/**", "!apps/static-factory-methods/**"]
+          }
+        },
+        "test": {
+          "builder": "@nrwl/jest:jest",
+          "options": {
+            "jestConfig": "apps/static-factory-methods/jest.config.js",
+            "tsConfig": "apps/static-factory-methods/tsconfig.spec.json",
+            "setupFile": "apps/static-factory-methods/src/test-setup.ts"
+          }
+        }
+      }
     }
   },
   "cli": {

apps/static-factory-methods/browserslist

@@ -0,0 +1,12 @@
+# This file is used by the build system to adjust CSS and JS output to support the specified browsers below.
+# For additional information regarding the format and rule options, please see:
+# https://github.com/browserslist/browserslist#queries
+
+# You can see what browsers were selected by your queries by running:
+#   npx browserslist
+
+> 0.5%
+last 2 versions
+Firefox ESR
+not dead
+not IE 9-11 # For IE 9-11 support, remove 'not'.

apps/static-factory-methods/jest.config.js

@@ -0,0 +1,9 @@
+module.exports = {
+  name: 'static-factory-methods',
+  preset: '../../jest.config.js',
+  coverageDirectory: '../../coverage/apps/static-factory-methods',
+  snapshotSerializers: [
+    'jest-preset-angular/AngularSnapshotSerializer.js',
+    'jest-preset-angular/HTMLCommentSerializer.js',
+  ],
+};

apps/static-factory-methods/src/app/address-list/address-list.component.html

@@ -0,0 +1,3 @@
+<ng-container *ngFor="let addr of addressArray?.controls">
+  <nested-forms-address [addressGroup]="addr"></nested-forms-address>
+</ng-container>

apps/static-factory-methods/src/app/address-list/address-list.component.spec.ts

@@ -0,0 +1,28 @@
+import { async, ComponentFixture, TestBed } from '@angular/core/testing';
+import { ReactiveFormsModule } from '@angular/forms';
+
+import { AddressComponent } from './../address/address.component';
+import { AddressListComponent } from './address-list.component';
+
+describe('AddressListComponent', () => {
+  let component: AddressListComponent;
+  let fixture: ComponentFixture<AddressListComponent>;
+
+  beforeEach(async(() => {
+    TestBed.configureTestingModule({
+      imports: [ReactiveFormsModule],
+      declarations: [ AddressListComponent, AddressComponent ]
+    })
+    .compileComponents();
+  }));
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(AddressListComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

apps/static-factory-methods/src/app/address-list/address-list.component.ts

@@ -0,0 +1,31 @@
+import { Component, Input, OnInit } from '@angular/core';
+import { FormArray, FormBuilder } from '@angular/forms';
+import { Address } from '@nested-forms/contact';
+import { AddressComponent } from '../address/address.component';
+
+@Component({
+  selector: 'nested-forms-address-list',
+  templateUrl: './address-list.component.html',
+  styleUrls: ['./address-list.component.css']
+})
+export class AddressListComponent implements OnInit {
+  @Input() addressArray: FormArray;
+
+  static createContactAddressListForm(addresses: Address[], fb: FormBuilder): FormArray {
+    const list: FormArray = fb.array([]);
+
+    if (addresses) {
+      addresses.forEach(addr => {
+        list.push(AddressComponent.createContactAddressForm(addr, fb));
+      });
+    }
+
+    return list;
+  }
+
+  constructor() { }
+
+  ngOnInit() {
+  }
+
+}

apps/static-factory-methods/src/app/address/address.component.html

@@ -0,0 +1,27 @@
+<form *ngIf="addressGroup" [formGroup]="addressGroup">
+    <div>
+      <label for="line1">Line 1: </label>
+      <input name="line1" formControlName="line1">
+    </div>
+  
+    <div>
+      <label for="line2">Line 2: </label>
+      <input name="line2" formControlName="line2">
+    </div>
+  
+    <div>
+      <label for="city">City: </label>
+      <input name="city" formControlName="city">
+    </div>
+  
+    <div>
+      <label for="state">State: </label>
+      <input name="state" formControlName="state">
+    </div>
+  
+    <div>
+      <label for="postalCode">Postal Code: </label>
+      <input name="postalCode" formControlName="postalCode">
+    </div>
+  </form>
+  

apps/static-factory-methods/src/app/address/address.component.spec.ts

@@ -0,0 +1,27 @@
+import { async, ComponentFixture, TestBed } from '@angular/core/testing';
+import { ReactiveFormsModule } from '@angular/forms';
+
+import { AddressComponent } from './address.component';
+
+describe('AddressComponent', () => {
+  let component: AddressComponent;
+  let fixture: ComponentFixture<AddressComponent>;
+
+  beforeEach(async(() => {
+    TestBed.configureTestingModule({
+      imports: [ReactiveFormsModule],
+      declarations: [ AddressComponent ]
+    })
+    .compileComponents();
+  }));
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(AddressComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

apps/static-factory-methods/src/app/address/address.component.ts

@@ -0,0 +1,28 @@
+import { Component, OnInit, Input } from '@angular/core';
+import { FormBuilder, FormGroup } from '@angular/forms';
+import { Address } from '@nested-forms/contact';
+
+@Component({
+  selector: 'nested-forms-address',
+  templateUrl: './address.component.html',
+  styleUrls: ['./address.component.css']
+})
+export class AddressComponent implements OnInit {
+  @Input() addressGroup: FormGroup;
+  
+  static createContactAddressForm(addr: Address, fb: FormBuilder): FormGroup {
+    return fb.group({
+      line1: [addr ? addr.line1 : ''],
+      line2: [addr ? addr.line2 : ''],
+      city: [addr ? addr.city : ''],
+      state: [addr ? addr.state : ''],
+      postalCode: [addr ? addr.postalCode : ''],
+    });
+  }
+
+  constructor() { }
+
+  ngOnInit() {
+  }
+
+}

apps/static-factory-methods/src/app/app.component.html

@@ -0,0 +1,8 @@
+<form [formGroup]="form">
+  <nested-forms-name [nameGroup]="form.get('name')"></nested-forms-name>
+  <nested-forms-address-list [addressArray]="form.get('addresses')"></nested-forms-address-list>
+</form>
+<hr />
+<pre>
+  {{ form.value | json }}
+</pre>

apps/static-factory-methods/src/app/app.component.spec.ts

@@ -0,0 +1,33 @@
+import { ReactiveFormsModule } from '@angular/forms';
+import { RouterTestingModule } from '@angular/router/testing';
+import { TestBed, async } from '@angular/core/testing';
+import { AppComponent } from './app.component';
+import { NameComponent } from './name/name.component';
+import { AddressListComponent } from './address-list/address-list.component';
+import { AddressComponent } from './address/address.component';
+import { ContactModule } from '@nested-forms/contact';
+
+describe('AppComponent', () => {
+  beforeEach(async(() => {
+    TestBed.configureTestingModule({
+      imports: [
+        RouterTestingModule,
+        ReactiveFormsModule,
+        ContactModule.forRoot(),
+      ],
+      declarations: [
+        AppComponent,
+        NameComponent,
+        AddressComponent,
+        AddressListComponent,
+      ],
+      providers: [],
+    }).compileComponents();
+  }));
+
+  it('should create the app', () => {
+    const fixture = TestBed.createComponent(AppComponent);
+    const app = fixture.debugElement.componentInstance;
+    expect(app).toBeTruthy();
+  });
+});

apps/static-factory-methods/src/app/app.component.ts

@@ -0,0 +1,44 @@
+import { Component, OnDestroy, OnInit } from '@angular/core';
+import { FormBuilder, FormGroup } from '@angular/forms';
+import {
+  Contact,
+  ContactService,
+} from '@nested-forms/contact';
+import { Subscription } from 'rxjs';
+import { NameComponent } from './name/name.component';
+import { AddressListComponent } from './address-list/address-list.component';
+
+@Component({
+  selector: 'nested-forms-root',
+  templateUrl: './app.component.html',
+  styleUrls: ['./app.component.css'],
+})
+export class AppComponent implements OnInit, OnDestroy {
+  contact: Contact;
+  form: FormGroup;
+
+  private subscription: Subscription;
+
+  constructor(
+    private service: ContactService,
+    private fb: FormBuilder,
+  ) {}
+
+  public ngOnInit() {
+    this.subscription = this.service
+      .loadContact()
+      .subscribe((data: Contact) => {
+        this.contact = data;
+        this.form = this.fb.group({
+          name: NameComponent.createContactNameForm(data.name, this.fb),
+          addresses: AddressListComponent.createContactAddressListForm(data.addresses, this.fb),
+        });
+      });
+  }
+
+  public ngOnDestroy() {
+    if (this.subscription) {
+      this.subscription.unsubscribe();
+    }
+  }
+}

apps/static-factory-methods/src/app/app.module.ts

@@ -0,0 +1,23 @@
+import { BrowserModule } from '@angular/platform-browser';
+import { NgModule } from '@angular/core';
+
+import { AppComponent } from './app.component';
+import { RouterModule } from '@angular/router';
+import { ReactiveFormsModule } from '@angular/forms';
+import { NameComponent } from './name/name.component';
+import { ContactModule } from '@nested-forms/contact';
+import { AddressListComponent } from './address-list/address-list.component';
+import { AddressComponent } from './address/address.component';
+
+@NgModule({
+  declarations: [AppComponent, NameComponent, AddressListComponent, AddressComponent],
+  imports: [
+    BrowserModule,
+    RouterModule.forRoot([], { initialNavigation: 'enabled' }),
+    ReactiveFormsModule,
+    ContactModule.forRoot()
+  ],
+  providers: [],
+  bootstrap: [AppComponent]
+})
+export class AppModule {}

apps/static-factory-methods/src/app/name/name.component.html

@@ -0,0 +1,27 @@
+<form *ngIf="nameGroup" [formGroup]="nameGroup">
+    <div>
+      <label for="firstName">First Name: </label>
+      <input name="firstName" formControlName="firstName">
+    </div>
+  
+    <div>
+      <label for="lastName">Last Name: </label>
+      <input name="lastName" formControlName="lastName">
+    </div>
+  
+    <div>
+      <label for="middleName">Middle Name: </label>
+      <input name="middleName" formControlName="middleName">
+    </div>
+  
+    <div>
+      <label for="prefix">Prefix: </label>
+      <input name="prefix" formControlName="prefix">
+    </div>
+  
+    <div>
+      <label for="suffix">Suffix: </label>
+      <input name="suffix" formControlName="suffix">
+    </div>
+    </form>
+  

apps/static-factory-methods/src/app/name/name.component.spec.ts

@@ -0,0 +1,26 @@
+import { async, ComponentFixture, TestBed } from '@angular/core/testing';
+import { ReactiveFormsModule } from '@angular/forms';
+
+import { NameComponent } from './name.component';
+
+describe('NameComponent', () => {
+  let component: NameComponent;
+  let fixture: ComponentFixture<NameComponent>;
+
+  beforeEach(async(() => {
+    TestBed.configureTestingModule({
+      imports: [ReactiveFormsModule],
+      declarations: [NameComponent]
+    }).compileComponents();
+  }));
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(NameComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

apps/static-factory-methods/src/app/name/name.component.ts

@@ -0,0 +1,26 @@
+import { FormBuilder, FormGroup } from '@angular/forms';
+import { Component, OnInit, Input } from '@angular/core';
+import { Name } from '@nested-forms/contact';
+
+@Component({
+  selector: 'nested-forms-name',
+  templateUrl: './name.component.html',
+  styleUrls: ['./name.component.css']
+})
+export class NameComponent implements OnInit {
+  @Input() nameGroup: FormGroup;
+
+  static createContactNameForm(name: Name, fb: FormBuilder): FormGroup {
+    return fb.group({
+      firstName: [name ? name.firstName : ''],
+      lastName: [name ? name.lastName : ''],
+      middleName: [name ? name.middleName : ''],
+      prefix: [name ? name.prefix : ''],
+      suffix: [name ? name.suffix : ''],
+    })
+  }
+
+  constructor() {}
+
+  ngOnInit() {}
+}

apps/static-factory-methods/src/environments/environment.prod.ts

@@ -0,0 +1,3 @@
+export const environment = {
+  production: true
+};

apps/static-factory-methods/src/environments/environment.ts

@@ -0,0 +1,16 @@
+// This file can be replaced during build by using the `fileReplacements` array.
+// `ng build --prod` replaces `environment.ts` with `environment.prod.ts`.
+// The list of file replacements can be found in `angular.json`.
+
+export const environment = {
+  production: false
+};
+
+/*
+ * For easier debugging in development mode, you can import the following file
+ * to ignore zone related error stack frames such as `zone.run`, `zoneDelegate.invokeTask`.
+ *
+ * This import should be commented out in production mode because it will have a negative impact
+ * on performance if an error is thrown.
+ */
+// import 'zone.js/dist/zone-error';  // Included with Angular CLI.

apps/static-factory-methods/src/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>GlobalForm</title>
+    <base href="/" />
+
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" type="image/x-icon" href="favicon.ico" />
+  </head>
+  <body>
+    <nested-forms-root></nested-forms-root>
+  </body>
+</html>

apps/static-factory-methods/src/main.ts

@@ -0,0 +1,13 @@
+import { enableProdMode } from '@angular/core';
+import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
+
+import { AppModule } from './app/app.module';
+import { environment } from './environments/environment';
+
+if (environment.production) {
+  enableProdMode();
+}
+
+platformBrowserDynamic()
+  .bootstrapModule(AppModule)
+  .catch(err => console.error(err));

apps/static-factory-methods/src/polyfills.ts

@@ -0,0 +1,62 @@
+/**
+ * This file includes polyfills needed by Angular and is loaded before the app.
+ * You can add your own extra polyfills to this file.
+ *
+ * This file is divided into 2 sections:
+ *   1. Browser polyfills. These are applied before loading ZoneJS and are sorted by browsers.
+ *   2. Application imports. Files imported after ZoneJS that should be loaded before your main
+ *      file.
+ *
+ * The current setup is for so-called "evergreen" browsers; the last versions of browsers that
+ * automatically update themselves. This includes Safari >= 10, Chrome >= 55 (including Opera),
+ * Edge >= 13 on the desktop, and iOS 10 and Chrome on mobile.
+ *
+ * Learn more in https://angular.io/guide/browser-support
+ */
+
+/***************************************************************************************************
+ * BROWSER POLYFILLS
+ */
+
+/** IE10 and IE11 requires the following for NgClass support on SVG elements */
+// import 'classlist.js';  // Run `npm install --save classlist.js`.
+
+/**
+ * Web Animations `@angular/platform-browser/animations`
+ * Only required if AnimationBuilder is used within the application and using IE/Edge or Safari.
+ * Standard animation support in Angular DOES NOT require any polyfills (as of Angular 6.0).
+ */
+// import 'web-animations-js';  // Run `npm install --save web-animations-js`.
+
+/**
+ * By default, zone.js will patch all possible macroTask and DomEvents
+ * user can disable parts of macroTask/DomEvents patch by setting following flags
+ * because those flags need to be set before `zone.js` being loaded, and webpack
+ * will put import in the top of bundle, so user need to create a separate file
+ * in this directory (for example: zone-flags.ts), and put the following flags
+ * into that file, and then add the following code before importing zone.js.
+ * import './zone-flags.ts';
+ *
+ * The flags allowed in zone-flags.ts are listed here.
+ *
+ * The following flags will work for all browsers.
+ *
+ * (window as any).__Zone_disable_requestAnimationFrame = true; // disable patch requestAnimationFrame
+ * (window as any).__Zone_disable_on_property = true; // disable patch onProperty such as onclick
+ * (window as any).__zone_symbol__UNPATCHED_EVENTS = ['scroll', 'mousemove']; // disable patch specified eventNames
+ *
+ *  in IE/Edge developer tools, the addEventListener will also be wrapped by zone.js
+ *  with the following flag, it will bypass `zone.js` patch for IE/Edge
+ *
+ *  (window as any).__Zone_enable_cross_context_check = true;
+ *
+ */
+
+/***************************************************************************************************
+ * Zone JS is required by default for Angular itself.
+ */
+import 'zone.js/dist/zone'; // Included with Angular CLI.
+
+/***************************************************************************************************
+ * APPLICATION IMPORTS
+ */

apps/static-factory-methods/src/styles.css

@@ -0,0 +1 @@
+/* You can add global styles to this file, and also import other style files */

apps/static-factory-methods/src/test-setup.ts

@@ -0,0 +1 @@
+import 'jest-preset-angular';

apps/static-factory-methods/tsconfig.app.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "types": []
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["src/test-setup.ts", "**/*.spec.ts"]
+}

apps/static-factory-methods/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "types": ["node", "jest"]
+  },
+  "include": ["**/*.ts"]
+}

apps/static-factory-methods/tsconfig.spec.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "module": "commonjs",
+    "types": ["jest", "node"]
+  },
+  "files": ["src/test-setup.ts"],
+  "include": ["**/*.spec.ts", "**/*.d.ts"]
+}

apps/static-factory-methods/tslint.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tslint.json",
+  "rules": {
+    "directive-selector": [true, "attribute", "nestedForms", "camelCase"],
+    "component-selector": [true, "element", "nested-forms", "kebab-case"]
+  }
+}

nx.json

@@ -19,6 +19,9 @@
     },
     "baseline": {
       "tags": []
+    },
+    "static-factory-methods": {
+      "tags": []
     }
   }
 }