@angular-devkit/schematics 14.0.0-next.1 → 14.0.0-next.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular-devkit/schematics",
-  "version": "14.0.0-next.1",
+  "version": "14.0.0-next.12",
   "description": "Angular Schematics - Library",
   "main": "src/index.js",
   "typings": "src/index.d.ts",
@@ -18,9 +18,9 @@
     "schematics"
   ],
   "dependencies": {
-    "@angular-devkit/core": "14.0.0-next.1",
+    "@angular-devkit/core": "14.0.0-next.12",
     "jsonc-parser": "3.0.0",
-    "magic-string": "0.25.7",
+    "magic-string": "0.26.1",
     "ora": "5.4.1",
     "rxjs": "6.6.7"
   },
@@ -29,7 +29,7 @@
     "url": "https://github.com/angular/angular-cli.git"
   },
   "engines": {
-    "node": "^12.20.0 || ^14.15.0 || >=16.10.0",
+    "node": "^14.15.0 || >=16.10.0",
     "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",
     "yarn": ">= 1.13.0"
   },

package/src/engine/engine.d.ts

@@ -44,7 +44,7 @@ export declare class CollectionImpl<CollectionT extends object, SchematicT exten
     get description(): CollectionDescription<CollectionT>;
     get name(): string;
     createSchematic(name: string, allowPrivate?: boolean): Schematic<CollectionT, SchematicT>;
-    listSchematicNames(): string[];
+    listSchematicNames(includeHidden?: boolean): string[];
 }
 export declare class TaskScheduler {
     private _context;
@@ -70,7 +70,7 @@ export declare class SchematicEngine<CollectionT extends object, SchematicT exte
     private _createCollectionDescription;
     createContext(schematic: Schematic<CollectionT, SchematicT>, parent?: Partial<TypedSchematicContext<CollectionT, SchematicT>>, executionOptions?: Partial<ExecutionOptions>): TypedSchematicContext<CollectionT, SchematicT>;
     createSchematic(name: string, collection: Collection<CollectionT, SchematicT>, allowPrivate?: boolean): Schematic<CollectionT, SchematicT>;
-    listSchematicNames(collection: Collection<CollectionT, SchematicT>): string[];
+    listSchematicNames(collection: Collection<CollectionT, SchematicT>, includeHidden?: boolean): string[];
     transformOptions<OptionT extends object, ResultT extends object>(schematic: Schematic<CollectionT, SchematicT>, options: OptionT, context?: TypedSchematicContext<CollectionT, SchematicT>): Observable<ResultT>;
     createSourceFromUrl(url: Url, context: TypedSchematicContext<CollectionT, SchematicT>): Source;
     executePostTasks(): Observable<void>;

package/src/engine/engine.js

@@ -79,8 +79,8 @@ class CollectionImpl {
     createSchematic(name, allowPrivate = false) {
         return this._engine.createSchematic(name, this, allowPrivate);
     }
-    listSchematicNames() {
-        return this._engine.listSchematicNames(this);
+    listSchematicNames(includeHidden) {
+        return this._engine.listSchematicNames(this, includeHidden);
     }
 }
 exports.CollectionImpl = CollectionImpl;
@@ -249,11 +249,11 @@ class SchematicEngine {
         schematicMap === null || schematicMap === void 0 ? void 0 : schematicMap.set(name, schematic);
         return schematic;
     }
-    listSchematicNames(collection) {
-        const names = this._host.listSchematicNames(collection.description);
+    listSchematicNames(collection, includeHidden) {
+        const names = this._host.listSchematicNames(collection.description, includeHidden);
         if (collection.baseDescriptions) {
             for (const base of collection.baseDescriptions) {
-                names.push(...this._host.listSchematicNames(base));
+                names.push(...this._host.listSchematicNames(base, includeHidden));
             }
         }
         // remove duplicates

package/src/engine/index.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/src/engine/interface.d.ts

@@ -64,7 +64,7 @@ export declare type SchematicDescription<CollectionMetadataT extends object, Sch
  */
 export interface EngineHost<CollectionMetadataT extends object, SchematicMetadataT extends object> {
     createCollectionDescription(name: string, requester?: CollectionDescription<CollectionMetadataT>): CollectionDescription<CollectionMetadataT>;
-    listSchematicNames(collection: CollectionDescription<CollectionMetadataT>): string[];
+    listSchematicNames(collection: CollectionDescription<CollectionMetadataT>, includeHidden?: boolean): string[];
     createSchematicDescription(name: string, collection: CollectionDescription<CollectionMetadataT>): SchematicDescription<CollectionMetadataT, SchematicMetadataT> | null;
     getSchematicRuleFactory<OptionT extends object>(schematic: SchematicDescription<CollectionMetadataT, SchematicMetadataT>, collection: CollectionDescription<CollectionMetadataT>): RuleFactory<OptionT>;
     createSourceFromUrl(url: Url, context: TypedSchematicContext<CollectionMetadataT, SchematicMetadataT>): Source | null;
@@ -102,7 +102,7 @@ export interface Collection<CollectionMetadataT extends object, SchematicMetadat
     readonly description: CollectionDescription<CollectionMetadataT>;
     readonly baseDescriptions?: Array<CollectionDescription<CollectionMetadataT>>;
     createSchematic(name: string, allowPrivate?: boolean): Schematic<CollectionMetadataT, SchematicMetadataT>;
-    listSchematicNames(): string[];
+    listSchematicNames(includeHidden?: boolean): string[];
 }
 /**
  * A Schematic as created by the Engine. This should be used by the tool to execute the main

package/src/index.d.ts

@@ -5,6 +5,7 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
+import { strings } from '@angular-devkit/core';
 import * as formats from './formats/index';
 import { FilePredicate, MergeStrategy, Tree as TreeInterface } from './tree/interface';
 import * as workflow from './workflow/index';
@@ -28,8 +29,7 @@ export * from './engine/schematic';
 export * from './sink/dryrun';
 export * from './sink/host';
 export * from './sink/sink';
-export { formats };
-export { workflow };
+export { formats, strings, workflow };
 export interface TreeConstructor {
     empty(): TreeInterface;
     branch(tree: TreeInterface): TreeInterface;

package/src/index.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -29,7 +33,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Tree = exports.workflow = exports.formats = exports.SchematicsException = void 0;
+exports.Tree = exports.workflow = exports.strings = exports.formats = exports.SchematicsException = void 0;
+const core_1 = require("@angular-devkit/core");
+Object.defineProperty(exports, "strings", { enumerable: true, get: function () { return core_1.strings; } });
 const formats = __importStar(require("./formats/index"));
 exports.formats = formats;
 const interface_1 = require("./tree/interface");

package/src/rules/move.js

@@ -28,7 +28,7 @@ function move(from, to) {
         else {
             // fromPath is a directory
             tree.getDir(fromPath).visit((path) => {
-                tree.rename(path, (0, core_1.join)(toPath, path.substr(fromPath.length)));
+                tree.rename(path, (0, core_1.join)(toPath, path.slice(fromPath.length)));
             });
         }
         return tree;

package/src/tree/delegate.d.ts

@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 /// <reference types="node" />
+import { JsonValue } from '@angular-devkit/core';
 import { Action } from './action';
 import { DirEntry, FileEntry, FileVisitor, MergeStrategy, Tree, UpdateRecorder } from './interface';
 export declare class DelegateTree implements Tree {
@@ -15,6 +16,8 @@ export declare class DelegateTree implements Tree {
     merge(other: Tree, strategy?: MergeStrategy): void;
     get root(): DirEntry;
     read(path: string): Buffer | null;
+    readText(path: string): string;
+    readJson(path: string): JsonValue;
     exists(path: string): boolean;
     get(path: string): FileEntry | null;
     getDir(path: string): DirEntry;

package/src/tree/delegate.js

@@ -26,6 +26,12 @@ class DelegateTree {
     read(path) {
         return this._other.read(path);
     }
+    readText(path) {
+        return this._other.readText(path);
+    }
+    readJson(path) {
+        return this._other.readJson(path);
+    }
     exists(path) {
         return this._other.exists(path);
     }

package/src/tree/host-tree.d.ts

@@ -6,7 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 /// <reference types="node" />
-import { Path, PathFragment, virtualFs } from '@angular-devkit/core';
+import { JsonValue, Path, PathFragment, virtualFs } from '@angular-devkit/core';
 import { Action } from './action';
 import { DirEntry, FileEntry, FilePredicate, FileVisitor, MergeStrategy, Tree, UpdateRecorder } from './interface';
 export declare class HostDirEntry implements DirEntry {
@@ -41,6 +41,8 @@ export declare class HostTree implements Tree {
     merge(other: Tree, strategy?: MergeStrategy): void;
     get root(): DirEntry;
     read(path: string): Buffer | null;
+    readText(path: string): string;
+    readJson(path: string): JsonValue;
     exists(path: string): boolean;
     get(path: string): FileEntry | null;
     getDir(path: string): DirEntry;

package/src/tree/host-tree.js

@@ -9,8 +9,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FilterHostTree = exports.HostCreateTree = exports.HostTree = exports.HostDirEntry = void 0;
 const core_1 = require("@angular-devkit/core");
+const jsonc_parser_1 = require("jsonc-parser");
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
+const util_1 = require("util");
 const exception_1 = require("../exception/exception");
 const delegate_1 = require("./delegate");
 const entry_1 = require("./entry");
@@ -208,6 +210,34 @@ class HostTree {
         const entry = this.get(path);
         return entry ? entry.content : null;
     }
+    readText(path) {
+        const data = this.read(path);
+        if (data === null) {
+            throw new exception_1.FileDoesNotExistException(path);
+        }
+        const decoder = new util_1.TextDecoder('utf-8', { fatal: true });
+        try {
+            // With the `fatal` option enabled, invalid data will throw a TypeError
+            return decoder.decode(data);
+        }
+        catch (e) {
+            if (e instanceof TypeError) {
+                throw new Error(`Failed to decode "${path}" as UTF-8 text.`);
+            }
+            throw e;
+        }
+    }
+    readJson(path) {
+        const content = this.readText(path);
+        const errors = [];
+        const result = (0, jsonc_parser_1.parse)(content, errors, { allowTrailingComma: true });
+        // If there is a parse error throw with the error information
+        if (errors[0]) {
+            const { error, offset } = errors[0];
+            throw new Error(`Failed to parse "${path}" as JSON. ${(0, jsonc_parser_1.printParseErrorCode)(error)} at offset: ${offset}.`);
+        }
+        return result;
+    }
     exists(path) {
         return this._recordSync.isFile(this._normalizePath(path));
     }

package/src/tree/interface.d.ts

@@ -6,7 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 /// <reference types="node" />
-import { Path, PathFragment } from '@angular-devkit/core';
+import { JsonValue, Path, PathFragment } from '@angular-devkit/core';
 import { Action } from './action';
 export declare enum MergeStrategy {
     AllowOverwriteConflict = 2,
@@ -41,6 +41,28 @@ export interface Tree {
     merge(other: Tree, strategy?: MergeStrategy): void;
     readonly root: DirEntry;
     read(path: string): Buffer | null;
+    /**
+     * Reads a file from the Tree as a UTF-8 encoded text file.
+     *
+     * @param path The path of the file to read.
+     * @returns A string containing the contents of the file.
+     * @throws {@link FileDoesNotExistException} if the file is not found.
+     * @throws An error if the file contains invalid UTF-8 characters.
+     */
+    readText(path: string): string;
+    /**
+     * Reads and parses a file from the Tree as a UTF-8 encoded JSON file.
+     * Supports parsing JSON (RFC 8259) with the following extensions:
+     * * Single-line and multi-line JavaScript comments
+     * * Trailing commas within objects and arrays
+     *
+     * @param path The path of the file to read.
+     * @returns A JsonValue containing the parsed contents of the file.
+     * @throws {@link FileDoesNotExistException} if the file is not found.
+     * @throws An error if the file contains invalid UTF-8 characters.
+     * @throws An error if the file contains malformed JSON.
+     */
+    readJson(path: string): JsonValue;
     exists(path: string): boolean;
     get(path: string): FileEntry | null;
     getDir(path: string): DirEntry;

package/src/tree/null.d.ts

@@ -6,7 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 /// <reference types="node" />
-import { BaseException, Path, PathFragment } from '@angular-devkit/core';
+import { BaseException, JsonValue, Path, PathFragment } from '@angular-devkit/core';
 import { Action } from './action';
 import { DirEntry, MergeStrategy, Tree, UpdateRecorder } from './interface';
 export declare class CannotCreateFileException extends BaseException {
@@ -28,6 +28,8 @@ export declare class NullTree implements Tree {
     readonly root: DirEntry;
     exists(_path: string): boolean;
     read(_path: string): null;
+    readText(path: string): string;
+    readJson(path: string): JsonValue;
     get(_path: string): null;
     getDir(path: string): NullTreeDirEntry;
     visit(): void;

package/src/tree/null.js

@@ -54,6 +54,12 @@ class NullTree {
     read(_path) {
         return null;
     }
+    readText(path) {
+        throw new exception_1.FileDoesNotExistException(path);
+    }
+    readJson(path) {
+        throw new exception_1.FileDoesNotExistException(path);
+    }
     get(_path) {
         return null;
     }

package/src/tree/scoped.d.ts

@@ -6,7 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 /// <reference types="node" />
-import { Path, PathFragment } from '@angular-devkit/core';
+import { JsonValue, Path, PathFragment } from '@angular-devkit/core';
 import { Action } from './action';
 import { DirEntry, FileEntry, FileVisitor, MergeStrategy, Tree, UpdateRecorder } from './interface';
 declare class ScopedDirEntry implements DirEntry {
@@ -29,6 +29,8 @@ export declare class ScopedTree implements Tree {
     branch(): Tree;
     merge(other: Tree, strategy?: MergeStrategy): void;
     read(path: string): Buffer | null;
+    readText(path: string): string;
+    readJson(path: string): JsonValue;
     exists(path: string): boolean;
     get(path: string): FileEntry | null;
     getDir(path: string): DirEntry;

package/src/tree/scoped.js

@@ -83,6 +83,12 @@ class ScopedTree {
     read(path) {
         return this._base.read(this._fullPath(path));
     }
+    readText(path) {
+        return this._base.readText(this._fullPath(path));
+    }
+    readJson(path) {
+        return this._base.readJson(this._fullPath(path));
+    }
     exists(path) {
         return this._base.exists(this._fullPath(path));
     }

package/src/workflow/index.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/tasks/node/index.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/tasks/package-manager/executor.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/tasks/repo-init/executor.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/testing/index.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/tools/description.d.ts

@@ -14,6 +14,7 @@ export interface FileSystemCollectionDescription {
     readonly schematics: {
         [name: string]: FileSystemSchematicDesc;
     };
+    readonly encapsulation?: boolean;
 }
 export interface FileSystemSchematicJsonDescription {
     readonly aliases?: string[];

package/tools/fallback-engine-host.d.ts

@@ -30,7 +30,7 @@ export declare class FallbackEngineHost implements EngineHost<{}, {}> {
     createSourceFromUrl(url: Url, context: FallbackContext): Source | null;
     transformOptions<OptionT extends object, ResultT extends object>(schematic: SchematicDescription<FallbackCollectionDescription, FallbackSchematicDescription>, options: OptionT, context?: FallbackContext): Observable<ResultT>;
     transformContext(context: FallbackContext): FallbackContext;
-    listSchematicNames(collection: CollectionDescription<FallbackCollectionDescription>): string[];
+    listSchematicNames(collection: CollectionDescription<FallbackCollectionDescription>, includeHidden?: boolean): string[];
     createTaskExecutor(name: string): Observable<TaskExecutor>;
     hasTaskExecutor(name: string): boolean;
 }

package/tools/fallback-engine-host.js

@@ -56,11 +56,13 @@ class FallbackEngineHost {
         });
         return result;
     }
-    listSchematicNames(collection) {
+    listSchematicNames(collection, includeHidden) {
         const allNames = new Set();
         this._hosts.forEach((host) => {
             try {
-                host.listSchematicNames(collection.description).forEach((name) => allNames.add(name));
+                host
+                    .listSchematicNames(collection.description, includeHidden)
+                    .forEach((name) => allNames.add(name));
             }
             catch (_) { }
         });

package/tools/file-system-engine-host-base.d.ts

@@ -11,7 +11,7 @@ import { Observable } from 'rxjs';
 import { Url } from 'url';
 import { RuleFactory, Source, TaskExecutor, TaskExecutorFactory } from '../src';
 import { FileSystemCollectionDesc, FileSystemEngineHost, FileSystemSchematicContext, FileSystemSchematicDesc, FileSystemSchematicDescription } from './description';
-export declare type OptionTransform<T extends object, R extends object> = (schematic: FileSystemSchematicDescription, options: T, context?: FileSystemSchematicContext) => Observable<R> | PromiseLike<R> | R;
+export declare type OptionTransform<T extends object | null, R extends object> = (schematic: FileSystemSchematicDescription, options: T, context?: FileSystemSchematicContext) => Observable<R> | PromiseLike<R> | R;
 export declare type ContextTransform = (context: FileSystemSchematicContext) => FileSystemSchematicContext;
 export declare class CollectionCannotBeResolvedException extends BaseException {
     constructor(name: string);
@@ -46,7 +46,7 @@ export declare class SchematicNameCollisionException extends BaseException {
  */
 export declare abstract class FileSystemEngineHostBase implements FileSystemEngineHost {
     protected abstract _resolveCollectionPath(name: string, requester?: string): string;
-    protected abstract _resolveReferenceString(name: string, parentPath: string): {
+    protected abstract _resolveReferenceString(name: string, parentPath: string, collectionDescription: FileSystemCollectionDesc): {
         ref: RuleFactory<{}>;
         path: string;
     } | null;
@@ -55,8 +55,8 @@ export declare abstract class FileSystemEngineHostBase implements FileSystemEngi
     private _transforms;
     private _contextTransforms;
     private _taskFactories;
-    listSchematicNames(collection: FileSystemCollectionDesc): string[];
-    registerOptionsTransform<T extends object, R extends object>(t: OptionTransform<T, R>): void;
+    listSchematicNames(collection: FileSystemCollectionDesc, includeHidden?: boolean): string[];
+    registerOptionsTransform<T extends object | null, R extends object>(t: OptionTransform<T, R>): void;
     registerContextTransform(t: ContextTransform): void;
     /**
      *

package/tools/file-system-engine-host-base.js

@@ -85,11 +85,11 @@ class FileSystemEngineHostBase {
         this._contextTransforms = [];
         this._taskFactories = new Map();
     }
-    listSchematicNames(collection) {
+    listSchematicNames(collection, includeHidden) {
         const schematics = [];
         for (const key of Object.keys(collection.schematics)) {
             const schematic = collection.schematics[key];
-            if (schematic.hidden || schematic.private) {
+            if ((schematic.hidden && !includeHidden) || schematic.private) {
                 continue;
             }
             // If extends is present without a factory it is an alias, do not return it
@@ -163,8 +163,8 @@ class FileSystemEngineHostBase {
         }
         if (partialDesc.extends) {
             const index = partialDesc.extends.indexOf(':');
-            const collectionName = index !== -1 ? partialDesc.extends.substr(0, index) : null;
-            const schematicName = index === -1 ? partialDesc.extends : partialDesc.extends.substr(index + 1);
+            const collectionName = index !== -1 ? partialDesc.extends.slice(0, index) : null;
+            const schematicName = index === -1 ? partialDesc.extends : partialDesc.extends.slice(index + 1);
             if (collectionName !== null) {
                 const extendCollection = this.createCollectionDescription(collectionName);
                 return this.createSchematicDescription(schematicName, extendCollection);
@@ -178,7 +178,7 @@ class FileSystemEngineHostBase {
         if (!partialDesc.factory) {
             throw new SchematicMissingFactoryException(name);
         }
-        const resolvedRef = this._resolveReferenceString(partialDesc.factory, collectionPath);
+        const resolvedRef = this._resolveReferenceString(partialDesc.factory, collectionPath, collection);
         if (!resolvedRef) {
             throw new FactoryCannotBeResolvedException(name);
         }

package/tools/file-system-engine-host.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/tools/index.js

@@ -8,7 +8,11 @@
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/tools/node-module-engine-host.d.ts

@@ -20,7 +20,7 @@ export declare class NodeModulesEngineHost extends FileSystemEngineHostBase {
     constructor(paths?: string[] | undefined);
     private resolve;
     protected _resolveCollectionPath(name: string, requester?: string): string;
-    protected _resolveReferenceString(refString: string, parentPath: string): {
+    protected _resolveReferenceString(refString: string, parentPath: string, collectionDescription?: FileSystemCollectionDesc): {
         ref: RuleFactory<{}>;
         path: string;
     } | null;

package/tools/node-module-engine-host.js

@@ -81,7 +81,7 @@ class NodeModulesEngineHost extends file_system_engine_host_base_1.FileSystemEng
         (0, file_system_utility_1.readJsonFile)(collectionPath);
         return collectionPath;
     }
-    _resolveReferenceString(refString, parentPath) {
+    _resolveReferenceString(refString, parentPath, collectionDescription) {
         const ref = new export_ref_1.ExportStringRef(refString, parentPath);
         if (!ref.ref) {
             return null;

package/tools/schema-option-transform.d.ts

@@ -11,4 +11,4 @@ import { FileSystemSchematicContext, FileSystemSchematicDescription } from './de
 export declare class InvalidInputOptions<T = {}> extends schema.SchemaValidationException {
     constructor(options: T, errors: schema.SchemaValidatorError[]);
 }
-export declare function validateOptionsWithSchema(registry: schema.SchemaRegistry): <T extends {}>(schematic: FileSystemSchematicDescription, options: T, context?: FileSystemSchematicContext | undefined) => Observable<T>;
+export declare function validateOptionsWithSchema(registry: schema.SchemaRegistry): <T extends {} | null>(schematic: FileSystemSchematicDescription, options: T, context?: FileSystemSchematicContext | undefined) => Observable<T>;

package/tools/workflow/node-workflow.d.ts

@@ -19,7 +19,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;
 }
 /**