refactor(@angular-devkit/schematics): deprecate NodePackageLinkTask

DEPRECATED: `NodePackageLinkTask` in `@angular-devkit/schematics`. A custom task should be created instead.

Author: alan-agius4

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

@@ -27,7 +27,7 @@ export class NodePackageInstallTask implements TaskConfigurationGenerator<NodePa
     workingDirectory?: string;
 }
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 export class NodePackageLinkTask implements TaskConfigurationGenerator<NodePackageTaskOptions> {
     constructor(packageName?: string | undefined, workingDirectory?: string | undefined);
     // (undocumented)

Diff for: packages/angular_devkit/schematics/tasks/package-manager/link-task.ts

@@ -9,10 +9,16 @@
 import { TaskConfiguration, TaskConfigurationGenerator } from '../../src';
 import { NodePackageName, NodePackageTaskOptions } from './options';
 
+/**
+ * @deprecated since version 18. Create a custom task if required.
+ */
 export class NodePackageLinkTask implements TaskConfigurationGenerator<NodePackageTaskOptions> {
   quiet = true;
 
-  constructor(public packageName?: string, public workingDirectory?: string) {}
+  constructor(
+    public packageName?: string,
+    public workingDirectory?: string,
+  ) {}
 
   toConfiguration(): TaskConfiguration<NodePackageTaskOptions> {
     return {