feat(@angular-devkit/schematics): support null for options parameter from OptionTransform type

Author: ddubrava

Diff for: goldens/public-api/angular_devkit/schematics/tools/index.md

@@ -117,7 +117,7 @@ export abstract class FileSystemEngineHostBase implements FileSystemEngineHost_2
     // (undocumented)
     registerContextTransform(t: ContextTransform): void;
     // (undocumented)
-    registerOptionsTransform<T extends object, R extends object>(t: OptionTransform<T, R>): void;
+    registerOptionsTransform<T extends object | null, R extends object>(t: OptionTransform<T, R>): void;
     // (undocumented)
     registerTaskExecutor<T>(factory: TaskExecutorFactory<T>, options?: T): void;
     // (undocumented)
@@ -235,7 +235,7 @@ export interface NodeWorkflowOptions {
     // (undocumented)
     force?: boolean;
     // (undocumented)
-    optionTransforms?: OptionTransform<object, object>[];
+    optionTransforms?: OptionTransform<Record<string, unknown> | null, object>[];
     // (undocumented)
     packageManager?: string;
     // (undocumented)
@@ -251,7 +251,7 @@ export interface NodeWorkflowOptions {
 }
 
 // @public (undocumented)
-export type OptionTransform<T extends object, R extends object> = (schematic: FileSystemSchematicDescription, options: T, context?: FileSystemSchematicContext) => Observable<R> | PromiseLike<R> | R;
+export type OptionTransform<T extends object | null, R extends object> = (schematic: FileSystemSchematicDescription, options: T, context?: FileSystemSchematicContext) => Observable<R> | PromiseLike<R> | R;
 
 // @public (undocumented)
 export class SchematicMissingDescriptionException extends BaseException {
@@ -274,7 +274,7 @@ export class SchematicNameCollisionException extends BaseException {
 }
 
 // @public (undocumented)
-export function validateOptionsWithSchema(registry: schema.SchemaRegistry): <T extends {}>(schematic: FileSystemSchematicDescription, options: T, context?: FileSystemSchematicContext | undefined) => Observable<T>;
+export function validateOptionsWithSchema(registry: schema.SchemaRegistry): <T extends {} | null>(schematic: FileSystemSchematicDescription, options: T, context?: FileSystemSchematicContext | undefined) => Observable<T>;
 
 // (No @packageDocumentation comment for this package)
 

Diff for: packages/angular_devkit/schematics/tools/file-system-engine-host-base.ts

@@ -29,7 +29,7 @@ import {
 } from './description';
 import { readJsonFile } from './file-system-utility';
 
-export declare type OptionTransform<T extends object, R extends object> = (
+export declare type OptionTransform<T extends object | null, R extends object> = (
   schematic: FileSystemSchematicDescription,
   options: T,
   context?: FileSystemSchematicContext,
@@ -140,7 +140,7 @@ export abstract class FileSystemEngineHostBase implements FileSystemEngineHost {
     return schematics;
   }
 
-  registerOptionsTransform<T extends object, R extends object>(t: OptionTransform<T, R>) {
+  registerOptionsTransform<T extends object | null, R extends object>(t: OptionTransform<T, R>) {
     this._transforms.push(t);
   }
 

Diff for: packages/angular_devkit/schematics/tools/schema-option-transform.ts

@@ -22,7 +22,7 @@ export class InvalidInputOptions<T = {}> extends schema.SchemaValidationExceptio
 
 // This can only be used in NodeJS.
 export function validateOptionsWithSchema(registry: schema.SchemaRegistry) {
-  return <T extends {}>(
+  return <T extends {} | null>(
     schematic: FileSystemSchematicDescription,
     options: T,
     context?: FileSystemSchematicContext,

Diff for: packages/angular_devkit/schematics/tools/workflow/node-workflow.ts

@@ -24,7 +24,7 @@ export interface NodeWorkflowOptions {
   registry?: schema.CoreSchemaRegistry;
   resolvePaths?: string[];
   schemaValidation?: boolean;
-  optionTransforms?: OptionTransform<object, object>[];
+  optionTransforms?: OptionTransform<Record<string, unknown> | null, object>[];
   engineHostCreator?: (options: NodeWorkflowOptions) => NodeModulesEngineHost;
 }