refactor(@angular-devkit/core): deprecate deps parameter in SchemaRegistry transforms

The deps parameter in addPreTransform and addPostTransform is deprecated. Consumers should ensure that transforms are added in the desired execution order instead of relying on the dependency tracking system, which will be removed in a future version.

Author: clydin

packages/angular_devkit/core/src/json/schema/interface.ts

@@ -85,7 +85,7 @@ export interface SchemaRegistry {
   /**
    * Add a transformation step before the validation of any Json.
    * @param {JsonVisitor} visitor The visitor to transform every value.
-   * @param {JsonVisitor[]} deps A list of other visitors to run before.
+   * @param {JsonVisitor[]} deps [Deprecated] A list of other visitors to run before. Add transforms in the desired execution order instead.
    */
   addPreTransform(visitor: JsonVisitor, deps?: JsonVisitor[]): void;
 
@@ -94,7 +94,7 @@ export interface SchemaRegistry {
    * after the POST, so if transformations are not compatible with the Schema it will not result
    * in an error.
    * @param {JsonVisitor} visitor The visitor to transform every value.
-   * @param {JsonVisitor[]} deps A list of other visitors to run before.
+   * @param {JsonVisitor[]} deps [Deprecated] A list of other visitors to run before. Add transforms in the desired execution order instead.
    */
   addPostTransform(visitor: JsonVisitor, deps?: JsonVisitor[]): void;
 }

packages/angular_devkit/core/src/json/schema/registry.ts

@@ -171,7 +171,7 @@ export class CoreSchemaRegistry implements SchemaRegistry {
   /**
    * Add a transformation step before the validation of any Json.
    * @param {JsonVisitor} visitor The visitor to transform every value.
-   * @param {JsonVisitor[]} deps A list of other visitors to run before.
+   * @param {JsonVisitor[]} deps [Deprecated] A list of other visitors to run before. Add transforms in the desired execution order instead.
    */
   addPreTransform(visitor: JsonVisitor, deps?: JsonVisitor[]): void {
     this._pre.add(visitor, deps);
@@ -182,7 +182,7 @@ export class CoreSchemaRegistry implements SchemaRegistry {
    * after the POST, so if transformations are not compatible with the Schema it will not result
    * in an error.
    * @param {JsonVisitor} visitor The visitor to transform every value.
-   * @param {JsonVisitor[]} deps A list of other visitors to run before.
+   * @param {JsonVisitor[]} deps [Deprecated] A list of other visitors to run before. Add transforms in the desired execution order instead.
    */
   addPostTransform(visitor: JsonVisitor, deps?: JsonVisitor[]): void {
     this._post.add(visitor, deps);