687a6c7 feat(@angular/build): add --inspect option to the dev-server

Author: Angular Builds

package.json

@@ -1,16 +1,16 @@
 {
   "name": "@angular-devkit/build-angular",
-  "version": "18.1.0-next.0+sha-cd1c181",
+  "version": "18.1.0-next.0+sha-687a6c7",
   "description": "Angular Webpack Build Facade",
   "main": "src/index.js",
   "typings": "src/index.d.ts",
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular/build": "github:angular/angular-build-builds#cd1c181",
-    "@angular-devkit/architect": "github:angular/angular-devkit-architect-builds#cd1c181",
-    "@angular-devkit/build-webpack": "github:angular/angular-devkit-build-webpack-builds#cd1c181",
-    "@angular-devkit/core": "github:angular/angular-devkit-core-builds#cd1c181",
+    "@angular/build": "github:angular/angular-build-builds#687a6c7",
+    "@angular-devkit/architect": "github:angular/angular-devkit-architect-builds#687a6c7",
+    "@angular-devkit/build-webpack": "github:angular/angular-devkit-build-webpack-builds#687a6c7",
+    "@angular-devkit/core": "github:angular/angular-devkit-core-builds#687a6c7",
     "@babel/core": "7.24.6",
     "@babel/generator": "7.24.6",
     "@babel/helper-annotate-as-pure": "7.24.6",
@@ -21,7 +21,7 @@
     "@babel/preset-env": "7.24.6",
     "@babel/runtime": "7.24.6",
     "@discoveryjs/json-ext": "0.5.7",
-    "@ngtools/webpack": "github:angular/ngtools-webpack-builds#cd1c181",
+    "@ngtools/webpack": "github:angular/ngtools-webpack-builds#687a6c7",
     "@vitejs/plugin-basic-ssl": "1.1.0",
     "ansi-colors": "4.1.3",
     "autoprefixer": "10.4.19",

src/builders/dev-server/options.d.ts

@@ -44,4 +44,8 @@ export declare function normalizeOptions(context: BuilderContext, projectName: s
     sslKey: string | undefined;
     forceEsbuild: boolean | undefined;
     prebundle: import("./schema").PrebundleUnion;
+    inspect: boolean | {
+        host?: string;
+        port?: number;
+    };
 }>;

src/builders/dev-server/options.js

@@ -50,6 +50,30 @@ async function normalizeOptions(context, projectName, options) {
             logger.warn('Prebundling has been configured but will not be used because scripts optimization is enabled.');
         }
     }
+    let inspect = false;
+    const inspectRaw = options.inspect;
+    if (inspectRaw === true || inspectRaw === '' || inspectRaw === 'true') {
+        inspect = {
+            host: undefined,
+            port: undefined,
+        };
+    }
+    else if (typeof inspectRaw === 'string' && inspectRaw !== 'false') {
+        const port = +inspectRaw;
+        if (isFinite(port)) {
+            inspect = {
+                host: undefined,
+                port,
+            };
+        }
+        else {
+            const [host, port] = inspectRaw.split(':');
+            inspect = {
+                host,
+                port: isNaN(+port) ? undefined : +port,
+            };
+        }
+    }
     // Initial options to keep
     const { host, port, poll, open, verbose, watch, allowedHosts, disableHostCheck, liveReload, hmr, headers, proxyConfig, servePath, publicHost, ssl, sslCert, sslKey, forceEsbuild, prebundle, } = options;
     // Return all the normalized options
@@ -78,5 +102,6 @@ async function normalizeOptions(context, projectName, options) {
         forceEsbuild,
         // Prebundling defaults to true but requires caching to function
         prebundle: cacheOptions.enabled && !optimization.scripts && (prebundle ?? true),
+        inspect,
     };
 }

src/builders/dev-server/schema.d.ts

@@ -44,6 +44,11 @@ export interface Schema {
      * Host to listen on.
      */
     host?: string;
+    /**
+     * Activate debugging inspector. This option only has an effect when 'SSR' or 'SSG' are
+     * enabled.
+     */
+    inspect?: Inspect;
     /**
      * Whether to reload the page on change, using live-reload.
      */
@@ -103,6 +108,11 @@ export interface Schema {
      */
     watch?: boolean;
 }
+/**
+ * Activate debugging inspector. This option only has an effect when 'SSR' or 'SSG' are
+ * enabled.
+ */
+export type Inspect = boolean | string;
 /**
  * Enable and control the Vite-based development server's prebundling capabilities. To
  * enable prebundling, the Angular CLI cache must also be enabled. This option has no effect

src/builders/dev-server/schema.json

@@ -102,6 +102,17 @@
       "type": "number",
       "description": "Enable and define the file watching poll time period in milliseconds."
     },
+    "inspect": {
+      "default": false,
+      "description": "Activate debugging inspector. This option only has an effect when 'SSR' or 'SSG' are enabled.",
+      "oneOf": [
+        {
+          "type": "string",
+          "description": "Activate the inspector on host and port in the format of `[[host:]port]`. See the security warning in https://nodejs.org/docs/latest-v22.x/api/cli.html#warning-binding-inspector-to-a-public-ipport-combination-is-insecure regarding the host parameter usage."
+        },
+        { "type": "boolean" }
+      ]
+    },
     "forceEsbuild": {
       "type": "boolean",
       "description": "Force the development server to use the 'browser-esbuild' builder when building. This is a developer preview option for the esbuild-based build system.",

src/utils/normalize-cache.js

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeCacheOptions = normalizeCacheOptions;
 const node_path_1 = require("node:path");
 /** Version placeholder is replaced during the build process with actual package version */
-const VERSION = '18.1.0-next.0+sha-cd1c181';
+const VERSION = '18.1.0-next.0+sha-687a6c7';
 function hasCacheMetadata(value) {
     return (!!value &&
         typeof value === 'object' &&

uniqueId

@@ -1 +1 @@
-Wed Jun 05 2024 14:10:24 GMT+0000 (Coordinated Universal Time)
+Wed Jun 05 2024 15:16:54 GMT+0000 (Coordinated Universal Time)