@ng-doc/builder 22.1.0 → 22.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Aleksandr Skoropad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/generator/bootstrap/bin.js

@@ -256,6 +256,21 @@ var ENGINE_SWITCHES = Object.freeze([
     values: /^(0|false|off|no)$/i,
     effect: "adding or removing a page compiles the application twice"
   },
+  {
+    name: "NGDOC_ANGULAR_DESCRIPTION_PASS",
+    values: /^(0|false|off|no)$/i,
+    effect: "a page title edit compiles the application twice"
+  },
+  {
+    name: "NGDOC_VITE_CONTENT_UPDATE",
+    values: /^(0|false|off|no)$/i,
+    effect: "guide text edits reload the page"
+  },
+  {
+    name: "NGDOC_VITE_MODULELESS_SETTLE",
+    values: /^(0|false|off|no)$/i,
+    effect: "hot updates of files the browser never loaded wait for the newest generation"
+  },
   {
     name: "NGDOC_VITE_BUILD_HANDOFF",
     values: /^(0|false|off|no)$/i,
@@ -1612,7 +1627,7 @@ function createParcelEventSource(root, options = {}, subscribe2 = parcel.subscri
 
 // libs/builder/generator/bootstrap/constants.ts
 var GENERATOR_COMPILER_VERSION = "0.0.1";
-var GENERATOR_TOOLCHAIN_DIGEST = "d3b66d41f47865fb003a881897f703f6b49568eefa8f301d410768b97f5647e2";
+var GENERATOR_TOOLCHAIN_DIGEST = "495b74972f5c2d99ad311bd24b03e2560f77343e401abd7c4d8185e4fee96764";
 
 // libs/builder/generator/bootstrap/index.ts
 import path7 from "node:path";
@@ -1630,7 +1645,10 @@ var INCREMENTAL_PROGRAM_FLAG = "NGDOC_INCREMENTAL_PROGRAM";
 var SHAPE_CLOSURE_FLAG = "NGDOC_SHAPE_CLOSURE";
 var ANGULAR_SHARED_PASS_FLAG = "NGDOC_ANGULAR_SHARED_PASS";
 var ANGULAR_STRUCTURAL_PASS_FLAG = "NGDOC_ANGULAR_STRUCTURAL_PASS";
+var ANGULAR_DESCRIPTION_PASS_FLAG = "NGDOC_ANGULAR_DESCRIPTION_PASS";
+var VITE_CONTENT_UPDATE_FLAG = "NGDOC_VITE_CONTENT_UPDATE";
 var VITE_BUILD_HANDOFF_FLAG = "NGDOC_VITE_BUILD_HANDOFF";
+var VITE_MODULELESS_SETTLE_FLAG = "NGDOC_VITE_MODULELESS_SETTLE";
 var TRACKED_PROGRAM_REUSE_FLAG = "NGDOC_TRACKED_PROGRAM_REUSE";
 var FAST_START_FLAG = "NGDOC_FAST_START";
 var PARALLEL_WRITES_FLAG = "NGDOC_PARALLEL_WRITES";
@@ -1705,6 +1723,21 @@ var FLAGS = Object.freeze(
       description: "In the Vite host, the generated modules and description modules a generation creates or deletes join that generation's Angular compiler pass instead of starting a pass of their own.",
       verify: false
     },
+    {
+      name: ANGULAR_DESCRIPTION_PASS_FLAG,
+      description: "In the Vite host, an edited description module joins the Angular compiler pass of the generation it starts, when that generation rewrites generated TypeScript modules, instead of taking a pass of its own first.",
+      verify: false
+    },
+    {
+      name: VITE_CONTENT_UPDATE_FLAG,
+      description: "In the Vite host, a generation that changes only content modules and the search index updates the open pages in place instead of reloading them.",
+      verify: false
+    },
+    {
+      name: VITE_MODULELESS_SETTLE_FLAG,
+      description: "In the Vite host, a hot update that hands Vite no module to update settles once it is acknowledged, instead of waiting for the newest generation to be published.",
+      verify: false
+    },
     {
       name: VITE_BUILD_HANDOFF_FLAG,
       description: "The server build of the Vite production pipeline publishes the browser build's generation instead of generating again.",
@@ -2690,29 +2723,29 @@ function projectWatchInputs(dependencies) {
   const scopes = /* @__PURE__ */ new Map();
   const references = [];
   for (const dependency of dependencies) {
-    if (!isRecord(dependency) || typeof dependency.kind !== "string")
+    if (!isRecord(dependency) || typeof dependency["kind"] !== "string")
       throw new Error("Invalid dependency");
-    switch (dependency.kind) {
+    switch (dependency["kind"]) {
       case "content": {
         if (!hasExactKeys(dependency, ["digest", "kind", "path"]))
           throw new Error("Invalid content dependency");
-        files.add(path4(dependency.path, "content path"));
-        string(dependency.digest, "content digest");
+        files.add(path4(dependency["path"], "content path"));
+        string(dependency["digest"], "content digest");
         break;
       }
       case "existence": {
-        if (!hasExactKeys(dependency, ["exists", "kind", "path"]) || typeof dependency.exists !== "boolean")
+        if (!hasExactKeys(dependency, ["exists", "kind", "path"]) || typeof dependency["exists"] !== "boolean")
           throw new Error("Invalid existence dependency");
-        files.add(path4(dependency.path, "existence path"));
+        files.add(path4(dependency["path"], "existence path"));
         break;
       }
       case "glob": {
         if (!hasExactKeys(dependency, ["exclude", "include", "kind", "members", "root"]))
           throw new Error("Invalid glob dependency");
-        const root = path4(dependency.root, "glob root");
-        const include = strings(dependency.include, "glob include");
-        const exclude = strings(dependency.exclude, "glob exclude");
-        paths(dependency.members, "glob members").forEach((member) => files.add(member));
+        const root = path4(dependency["root"], "glob root");
+        const include = strings(dependency["include"], "glob include");
+        const exclude = strings(dependency["exclude"], "glob exclude");
+        paths(dependency["members"], "glob members").forEach((member) => files.add(member));
         const glob = { root, include, exclude };
         globs.set(JSON.stringify(glob), glob);
         break;
@@ -2720,10 +2753,10 @@ function projectWatchInputs(dependencies) {
       case "semantic": {
         if (!hasExactKeys(dependency, ["digest", "files", "kind", "reason", "scopeId"]))
           throw new Error("Invalid semantic dependency");
-        const scopeId = string(dependency.scopeId, "semantic scope ID");
-        const digest = string(dependency.digest, "semantic digest");
-        string(dependency.reason, "semantic reason");
-        const scopeFiles = paths(dependency.files, "semantic files");
+        const scopeId = string(dependency["scopeId"], "semantic scope ID");
+        const digest = string(dependency["digest"], "semantic digest");
+        string(dependency["reason"], "semantic reason");
+        const scopeFiles = paths(dependency["files"], "semantic files");
         scopeFiles.forEach((file) => files.add(file));
         const registered = scopes.get(scopeId) ?? [];
         registered.push({ digest });
@@ -2734,17 +2767,17 @@ function projectWatchInputs(dependencies) {
         if (!hasExactKeys(dependency, ["digest", "kind", "reason", "scopeId"]))
           throw new Error("Invalid semantic-reference dependency");
         references.push({
-          scopeId: string(dependency.scopeId, "semantic-reference scope ID"),
-          digest: string(dependency.digest, "semantic-reference digest")
+          scopeId: string(dependency["scopeId"], "semantic-reference scope ID"),
+          digest: string(dependency["digest"], "semantic-reference digest")
         });
-        string(dependency.reason, "semantic-reference reason");
+        string(dependency["reason"], "semantic-reference reason");
         break;
       }
       case "keyword": {
         if (!hasExactKeys(dependency, ["digest", "key", "kind"]))
           throw new Error("Invalid keyword dependency");
-        string(dependency.key, "keyword key");
-        string(dependency.digest, "keyword digest");
+        string(dependency["key"], "keyword key");
+        string(dependency["digest"], "keyword digest");
         break;
       }
       // The non-physical kinds are validated but are never watch inputs: they name no path, and
@@ -2752,16 +2785,16 @@ function projectWatchInputs(dependencies) {
       case "semantic-closure": {
         if (!hasExactKeys(dependency, ["digest", "key", "kind", "scopeId"]))
           throw new Error("Invalid semantic-closure dependency");
-        string(dependency.scopeId, "semantic-closure scope ID");
-        string(dependency.key, "semantic-closure key");
-        string(dependency.digest, "semantic-closure digest");
+        string(dependency["scopeId"], "semantic-closure scope ID");
+        string(dependency["key"], "semantic-closure key");
+        string(dependency["digest"], "semantic-closure digest");
         break;
       }
       case "evaluated": {
         if (!hasExactKeys(dependency, ["digest", "entryId", "kind"]))
           throw new Error("Invalid evaluated dependency");
-        string(dependency.entryId, "evaluated entry ID");
-        string(dependency.digest, "evaluated digest");
+        string(dependency["entryId"], "evaluated entry ID");
+        string(dependency["digest"], "evaluated digest");
         break;
       }
       default:
@@ -5778,7 +5811,7 @@ function normalizeRelative(value) {
   return normalized;
 }
 function trustedBase(last, request) {
-  const published = (manifest) => isRecord2(manifest) && manifest.projectId === last.projectId && manifest.revision === last.revision && manifest.generation === last.generation;
+  const published = (manifest) => isRecord2(manifest) && manifest["projectId"] === last.projectId && manifest["revision"] === last.revision && manifest["generation"] === last.generation;
   const base = request.base;
   return isRecord2(base) && published(base.manifest) && published(request.previous) && isRecord2(base.snapshot) && base.snapshot.projectId === last.projectId && base.snapshot.revision === last.revision;
 }
@@ -5792,17 +5825,17 @@ function sameManifestStamp(left, right) {
   return left.dev === right.dev && left.ino === right.ino && left.size === right.size && left.mtimeNs === right.mtimeNs && left.ctimeNs === right.ctimeNs;
 }
 function configurationDigest(candidate) {
-  return isRecord2(candidate) && isRecord2(candidate.configuration) ? candidate.configuration.digest : void 0;
+  return isRecord2(candidate) && isRecord2(candidate["configuration"]) ? candidate["configuration"]["digest"] : void 0;
 }
 function unchangedArtifact(artifact, last) {
-  const id = artifact.id;
-  const outputs = artifact.outputs;
-  if (!string2(artifact.revision) || last.revisions.get(id) !== artifact.revision || !Array.isArray(outputs) || outputs.length !== (last.counts.get(id) ?? 0))
+  const id = artifact["id"];
+  const outputs = artifact["outputs"];
+  if (!string2(artifact["revision"]) || last.revisions.get(id) !== artifact["revision"] || !Array.isArray(outputs) || outputs.length !== (last.counts.get(id) ?? 0))
     return false;
   return outputs.every((output) => {
-    if (!isRecord2(output) || !string2(output.path)) return false;
-    const entry = last.files.get(output.path);
-    return entry?.ownerId === id && entry.digest === output.digest && entry.role === output.role;
+    if (!isRecord2(output) || !string2(output["path"])) return false;
+    const entry = last.files.get(output["path"]);
+    return entry?.ownerId === id && entry.digest === output["digest"] && entry.role === output["role"];
   });
 }
 var EMPTY_SCOPE_FACTS = canonicalJson({ definitions: [], references: [] });
@@ -5985,7 +6018,7 @@ function stringArray(value) {
 function isIdentity(value) {
   if (!isRecord2(value) || !exact(value, ["projectId", "entryId", "role"], ["declarationId", "part"]))
     return false;
-  return string2(value.projectId) && string2(value.entryId) && [
+  return string2(value["projectId"]) && string2(value["entryId"]) && [
     "page-shell",
     "content",
     "demo-assets",
@@ -5993,7 +6026,7 @@ function isIdentity(value) {
     "category",
     "api-list",
     "aggregate"
-  ].includes(String(value.role)) && (value.declarationId === void 0 || string2(value.declarationId)) && (value.part === void 0 || string2(value.part));
+  ].includes(String(value["role"])) && (value["declarationId"] === void 0 || string2(value["declarationId"])) && (value["part"] === void 0 || string2(value["part"]));
 }
 function isFingerprint(value) {
   return isRecord2(value) && exact(value, [
@@ -6003,40 +6036,40 @@ function isFingerprint(value) {
     "configurationDigest",
     "inputDigest",
     "keywordDigest"
-  ]) && value.schemaVersion === SCHEMA_VERSION && [
-    value.compilerVersion,
-    value.toolchainDigest,
-    value.configurationDigest,
-    value.inputDigest,
-    value.keywordDigest
+  ]) && value["schemaVersion"] === SCHEMA_VERSION && [
+    value["compilerVersion"],
+    value["toolchainDigest"],
+    value["configurationDigest"],
+    value["inputDigest"],
+    value["keywordDigest"]
   ].every(string2);
 }
 function isDependency(value) {
-  if (!isRecord2(value) || !string2(value.kind)) return false;
-  if (value.kind === "content")
-    return exact(value, ["kind", "path", "digest"]) && string2(value.path) && string2(value.digest);
-  if (value.kind === "existence")
-    return exact(value, ["kind", "path", "exists"]) && string2(value.path) && typeof value.exists === "boolean";
-  if (value.kind === "glob")
-    return exact(value, ["kind", "root", "include", "exclude", "members"]) && string2(value.root) && stringArray(value.include) && stringArray(value.exclude) && stringArray(value.members);
-  if (value.kind === "semantic")
-    return exact(value, ["kind", "scopeId", "digest", "files", "reason"]) && string2(value.scopeId) && string2(value.digest) && stringArray(value.files) && string2(value.reason);
-  if (value.kind === "semantic-reference")
-    return exact(value, ["kind", "scopeId", "digest", "reason"]) && string2(value.scopeId) && string2(value.digest) && string2(value.reason);
-  if (value.kind === "semantic-closure")
-    return exact(value, ["kind", "scopeId", "key", "digest"]) && string2(value.scopeId) && string2(value.key) && string2(value.digest);
-  if (value.kind === "evaluated")
-    return exact(value, ["kind", "entryId", "digest"]) && string2(value.entryId) && string2(value.digest);
-  return value.kind === "keyword" && exact(value, ["kind", "key", "digest"]) && string2(value.key) && string2(value.digest);
+  if (!isRecord2(value) || !string2(value["kind"])) return false;
+  if (value["kind"] === "content")
+    return exact(value, ["kind", "path", "digest"]) && string2(value["path"]) && string2(value["digest"]);
+  if (value["kind"] === "existence")
+    return exact(value, ["kind", "path", "exists"]) && string2(value["path"]) && typeof value["exists"] === "boolean";
+  if (value["kind"] === "glob")
+    return exact(value, ["kind", "root", "include", "exclude", "members"]) && string2(value["root"]) && stringArray(value["include"]) && stringArray(value["exclude"]) && stringArray(value["members"]);
+  if (value["kind"] === "semantic")
+    return exact(value, ["kind", "scopeId", "digest", "files", "reason"]) && string2(value["scopeId"]) && string2(value["digest"]) && stringArray(value["files"]) && string2(value["reason"]);
+  if (value["kind"] === "semantic-reference")
+    return exact(value, ["kind", "scopeId", "digest", "reason"]) && string2(value["scopeId"]) && string2(value["digest"]) && string2(value["reason"]);
+  if (value["kind"] === "semantic-closure")
+    return exact(value, ["kind", "scopeId", "key", "digest"]) && string2(value["scopeId"]) && string2(value["key"]) && string2(value["digest"]);
+  if (value["kind"] === "evaluated")
+    return exact(value, ["kind", "entryId", "digest"]) && string2(value["entryId"]) && string2(value["digest"]);
+  return value["kind"] === "keyword" && exact(value, ["kind", "key", "digest"]) && string2(value["key"]) && string2(value["digest"]);
 }
 function isKeyword(value) {
-  return isRecord2(value) && exact(value, ["key", "title", "path"], ["type", "languages", "description"]) && string2(value.key) && string2(value.title) && string2(value.path) && (value.type === void 0 || value.type === "link") && (value.languages === void 0 || stringArray(value.languages)) && [value.description, value.signature].every((item) => item === void 0 || string2(item));
+  return isRecord2(value) && exact(value, ["key", "title", "path"], ["type", "languages", "description"]) && string2(value["key"]) && string2(value["title"]) && string2(value["path"]) && (value["type"] === void 0 || value["type"] === "link") && (value["languages"] === void 0 || stringArray(value["languages"])) && [value["description"], value["signature"]].every((item) => item === void 0 || string2(item));
 }
 function isSource(value) {
-  return isRecord2(value) && exact(value, ["path"], ["line", "column"]) && string2(value.path) && (value.line === void 0 || finite(value.line)) && (value.column === void 0 || finite(value.column));
+  return isRecord2(value) && exact(value, ["path"], ["line", "column"]) && string2(value["path"]) && (value["line"] === void 0 || finite(value["line"])) && (value["column"] === void 0 || finite(value["column"]));
 }
 function isDiagnostic(value) {
-  return isRecord2(value) && exact(value, ["code", "severity", "message", "stage"], ["source", "ownerId", "related"]) && string2(value.code) && ["error", "warning", "info"].includes(String(value.severity)) && string2(value.message) && [
+  return isRecord2(value) && exact(value, ["code", "severity", "message", "stage"], ["source", "ownerId", "related"]) && string2(value["code"]) && ["error", "warning", "info"].includes(String(value["severity"])) && string2(value["message"]) && [
     "discovery",
     "evaluation",
     "semantic",
@@ -6045,8 +6078,8 @@ function isDiagnostic(value) {
     "cache",
     "commit",
     "host"
-  ].includes(String(value.stage)) && (value.source === void 0 || isSource(value.source)) && (value.ownerId === void 0 || string2(value.ownerId)) && (value.related === void 0 || Array.isArray(value.related) && value.related.every(
-    (item) => isRecord2(item) && exact(item, ["message", "source"]) && string2(item.message) && isSource(item.source)
+  ].includes(String(value["stage"])) && (value["source"] === void 0 || isSource(value["source"])) && (value["ownerId"] === void 0 || string2(value["ownerId"])) && (value["related"] === void 0 || Array.isArray(value["related"]) && value["related"].every(
+    (item) => isRecord2(item) && exact(item, ["message", "source"]) && string2(item["message"]) && isSource(item["source"])
   ));
 }
 function isSearch(value) {
@@ -6054,17 +6087,17 @@ function isSearch(value) {
     value,
     ["breadcrumbs", "pageType", "title", "section", "route", "content"],
     ["fragment", "kind", "signature", "description"]
-  ) && stringArray(value.breadcrumbs) && ["guide", "api"].includes(String(value.pageType)) && [value.title, value.section, value.route, value.content].every(string2) && [value.fragment, value.kind, value.signature, value.description].every(
+  ) && stringArray(value["breadcrumbs"]) && ["guide", "api"].includes(String(value["pageType"])) && [value["title"], value["section"], value["route"], value["content"]].every(string2) && [value["fragment"], value["kind"], value["signature"], value["description"]].every(
     (item) => item === void 0 || string2(item)
   );
 }
 function isAnchor(value) {
-  return isRecord2(value) && exact(value, ["anchorId", "anchor", "title", "type"], ["scope"]) && [value.anchorId, value.anchor, value.title].every(string2) && ["heading", "member"].includes(String(value.type)) && (value.scope === void 0 || isRecord2(value.scope) && exact(value.scope, ["key", "title"]) && string2(value.scope.key) && string2(value.scope.title));
+  return isRecord2(value) && exact(value, ["anchorId", "anchor", "title", "type"], ["scope"]) && [value["anchorId"], value["anchor"], value["title"]].every(string2) && ["heading", "member"].includes(String(value["type"])) && (value["scope"] === void 0 || isRecord2(value["scope"]) && exact(value["scope"], ["key", "title"]) && string2(value["scope"]["key"]) && string2(value["scope"]["title"]));
 }
 function isLinkedContent(value) {
-  if (!isRecord2(value) || !exact(value, ["ir", "html", "searchRecords", "keywordDigest"]) || !string2(value.html) || !string2(value.keywordDigest) || !Array.isArray(value.searchRecords) || !value.searchRecords.every(isSearch) || !isRecord2(value.ir))
+  if (!isRecord2(value) || !exact(value, ["ir", "html", "searchRecords", "keywordDigest"]) || !string2(value["html"]) || !string2(value["keywordDigest"]) || !Array.isArray(value["searchRecords"]) || !value["searchRecords"].every(isSearch) || !isRecord2(value["ir"]))
     return false;
-  const ir = value.ir;
+  const ir = value["ir"];
   return exact(
     ir,
     [
@@ -6083,7 +6116,9 @@ function isLinkedContent(value) {
       "diagnostics"
     ],
     ["icon", "searchBreadcrumbs"]
-  ) && ir.schemaVersion === SCHEMA_VERSION && [ir.id, ir.entryId, ir.title, ir.route, ir.absoluteRoute, ir.html].every(string2) && ["guide-tab", "api-tab", "header", "demo-assets"].includes(String(ir.role)) && (ir.searchBreadcrumbs === void 0 || stringArray(ir.searchBreadcrumbs)) && (ir.icon === void 0 || string2(ir.icon)) && Array.isArray(ir.anchors) && ir.anchors.every(isAnchor) && Array.isArray(ir.exportedKeywords) && ir.exportedKeywords.every(isKeyword) && stringArray(ir.usedKeywords) && Array.isArray(ir.dependencies) && ir.dependencies.every(isDependency) && Array.isArray(ir.diagnostics) && ir.diagnostics.every(isDiagnostic);
+  ) && ir["schemaVersion"] === SCHEMA_VERSION && [ir["id"], ir["entryId"], ir["title"], ir["route"], ir["absoluteRoute"], ir["html"]].every(
+    string2
+  ) && ["guide-tab", "api-tab", "header", "demo-assets"].includes(String(ir["role"])) && (ir["searchBreadcrumbs"] === void 0 || stringArray(ir["searchBreadcrumbs"])) && (ir["icon"] === void 0 || string2(ir["icon"])) && Array.isArray(ir["anchors"]) && ir["anchors"].every(isAnchor) && Array.isArray(ir["exportedKeywords"]) && ir["exportedKeywords"].every(isKeyword) && stringArray(ir["usedKeywords"]) && Array.isArray(ir["dependencies"]) && ir["dependencies"].every(isDependency) && Array.isArray(ir["diagnostics"]) && ir["diagnostics"].every(isDiagnostic);
 }
 function isRoute(value) {
   return isRecord2(value) && exact(
@@ -6099,23 +6134,29 @@ function isRoute(value) {
       "modulePath",
       "apiListSegment",
       "demoModulePath",
-      "demoNames"
+      "demoNames",
+      "playgroundPages"
     ]
-  ) && [value.id, value.path, value.title].every(string2) && (value.parentId === void 0 || string2(value.parentId)) && (value.order === void 0 || finite(value.order)) && (value.hidden === void 0 || typeof value.hidden === "boolean") && (value.icon === void 0 || string2(value.icon)) && (value.modulePath === void 0 || string2(value.modulePath)) && (value.apiListSegment === void 0 || string2(value.apiListSegment)) && (value.demoModulePath === void 0 || string2(value.demoModulePath)) && (value.demoNames === void 0 || stringArray(value.demoNames)) && (value.metadata === void 0 || isRecord2(value.metadata) && exact(value.metadata, ["description", "tags"]) && string2(value.metadata.description) && isRecord2(value.metadata.tags) && Object.values(value.metadata.tags).every(stringArray)) && (value.category === void 0 || isRecord2(value.category) && exact(value.category, ["runtimeImport"], ["expandable", "expanded"]) && isRecord2(value.category.runtimeImport) && exact(value.category.runtimeImport, ["source", "exportName"]) && string2(value.category.runtimeImport.source) && string2(value.category.runtimeImport.exportName) && (value.category.expandable === void 0 || typeof value.category.expandable === "boolean") && (value.category.expanded === void 0 || typeof value.category.expanded === "boolean"));
+  ) && [value["id"], value["path"], value["title"]].every(string2) && (value["parentId"] === void 0 || string2(value["parentId"])) && (value["order"] === void 0 || finite(value["order"])) && (value["hidden"] === void 0 || typeof value["hidden"] === "boolean") && (value["icon"] === void 0 || string2(value["icon"])) && (value["modulePath"] === void 0 || string2(value["modulePath"])) && (value["apiListSegment"] === void 0 || string2(value["apiListSegment"])) && (value["demoModulePath"] === void 0 || string2(value["demoModulePath"])) && (value["demoNames"] === void 0 || stringArray(value["demoNames"])) && (value["playgroundPages"] === void 0 || stringArray(value["playgroundPages"])) && (value["metadata"] === void 0 || isRecord2(value["metadata"]) && exact(value["metadata"], ["description", "tags"]) && string2(value["metadata"]["description"]) && isRecord2(value["metadata"]["tags"]) && Object.values(value["metadata"]["tags"]).every(stringArray)) && (value["category"] === void 0 || isRecord2(value["category"]) && exact(value["category"], ["runtimeImport"], ["expandable", "expanded"]) && isRecord2(value["category"]["runtimeImport"]) && exact(value["category"]["runtimeImport"], ["source", "exportName"]) && string2(value["category"]["runtimeImport"]["source"]) && string2(value["category"]["runtimeImport"]["exportName"]) && (value["category"]["expandable"] === void 0 || typeof value["category"]["expandable"] === "boolean") && (value["category"]["expanded"] === void 0 || typeof value["category"]["expanded"] === "boolean"));
 }
 function isApiList(value) {
   return isRecord2(value) && exact(
     value,
     ["apiEntryId", "scopeId", "scopeTitle", "name", "type", "route"],
     ["description", "signature"]
-  ) && [value.apiEntryId, value.scopeId, value.scopeTitle, value.name, value.type, value.route].every(
-    string2
-  ) && [value.description, value.signature].every((item) => item === void 0 || string2(item));
+  ) && [
+    value["apiEntryId"],
+    value["scopeId"],
+    value["scopeTitle"],
+    value["name"],
+    value["type"],
+    value["route"]
+  ].every(string2) && [value["description"], value["signature"]].every((item) => item === void 0 || string2(item));
 }
 function isFileOutput(value) {
-  return isRecord2(value) && exact(value, ["path", "role", "encoding", "content", "digest"]) && string2(value.path) && ["angular", "content", "asset", "routes", "context", "search", "api-list"].includes(
-    String(value.role)
-  ) && ["utf8", "base64"].includes(String(value.encoding)) && string2(value.content) && string2(value.digest);
+  return isRecord2(value) && exact(value, ["path", "role", "encoding", "content", "digest"]) && string2(value["path"]) && ["angular", "content", "asset", "routes", "context", "search", "api-list"].includes(
+    String(value["role"])
+  ) && ["utf8", "base64"].includes(String(value["encoding"])) && string2(value["content"]) && string2(value["digest"]);
 }
 function isContentDescriptor(value) {
   if (!isRecord2(value) || !exact(
@@ -6139,23 +6180,23 @@ function isContentDescriptor(value) {
     ["icon", "keyword"]
   ))
     return false;
-  if (value.schemaVersion !== SCHEMA_VERSION || ![
-    value.id,
-    value.ownerId,
-    value.title,
-    value.route,
-    value.absoluteRoute,
-    value.inputDigest,
-    value.requestDigest
-  ].every(string2) || ![value.id, value.ownerId, value.inputDigest, value.requestDigest].every(
+  if (value["schemaVersion"] !== SCHEMA_VERSION || ![
+    value["id"],
+    value["ownerId"],
+    value["title"],
+    value["route"],
+    value["absoluteRoute"],
+    value["inputDigest"],
+    value["requestDigest"]
+  ].every(string2) || ![value["id"], value["ownerId"], value["inputDigest"], value["requestDigest"]].every(
     (item) => string2(item) && item.length > 0 && !item.includes("\0")
-  ) || !finite(value.ordinal) || value.ordinal < 0 || !Number.isInteger(value.ordinal) || !["guide-tab", "api-tab", "header"].includes(String(value.role)) || !stringArray(value.searchBreadcrumbs) || !Array.isArray(value.dependencies) || !value.dependencies.every((dependency) => isPhysicalDescriptorDependency(dependency)) || new Set(value.dependencies.map((dependency) => canonicalJson(dependency))).size !== value.dependencies.length || !stringArray(value.closureIds) || value.icon !== void 0 && !string2(value.icon) || value.keyword !== void 0 && !string2(value.keyword) || !isRecord2(value.locator))
+  ) || !finite(value["ordinal"]) || value["ordinal"] < 0 || !Number.isInteger(value["ordinal"]) || !["guide-tab", "api-tab", "header"].includes(String(value["role"])) || !stringArray(value["searchBreadcrumbs"]) || !Array.isArray(value["dependencies"]) || !value["dependencies"].every((dependency) => isPhysicalDescriptorDependency(dependency)) || new Set(value["dependencies"].map((dependency) => canonicalJson(dependency))).size !== value["dependencies"].length || !stringArray(value["closureIds"]) || value["icon"] !== void 0 && !string2(value["icon"]) || value["keyword"] !== void 0 && !string2(value["keyword"]) || !isRecord2(value["locator"]))
     return false;
-  const locator = value.locator;
-  return value.role === "header" ? exact(locator, ["kind"]) && locator.kind === "header" : value.role === "guide-tab" ? exact(locator, ["kind", "markdown"]) && locator.kind === "guide-tab" && string2(locator.markdown) : exact(locator, ["kind", "declarationId"]) && locator.kind === "api-tab" && string2(locator.declarationId);
+  const locator = value["locator"];
+  return value["role"] === "header" ? exact(locator, ["kind"]) && locator["kind"] === "header" : value["role"] === "guide-tab" ? exact(locator, ["kind", "markdown"]) && locator["kind"] === "guide-tab" && string2(locator["markdown"]) : exact(locator, ["kind", "declarationId"]) && locator["kind"] === "api-tab" && string2(locator["declarationId"]);
 }
 function isPhysicalDescriptorDependency(value) {
-  return isRecord2(value) && (value.kind === "content" && exact(value, ["kind", "path", "digest"]) && absoluteNormalizedPath(value.path) && string2(value.digest) || value.kind === "existence" && exact(value, ["kind", "path", "exists"]) && absoluteNormalizedPath(value.path) && typeof value.exists === "boolean");
+  return isRecord2(value) && (value["kind"] === "content" && exact(value, ["kind", "path", "digest"]) && absoluteNormalizedPath(value["path"]) && string2(value["digest"]) || value["kind"] === "existence" && exact(value, ["kind", "path", "exists"]) && absoluteNormalizedPath(value["path"]) && typeof value["exists"] === "boolean");
 }
 function validDescriptorPlan(artifact) {
   const descriptors = artifact.contentDescriptors;
@@ -6240,7 +6281,7 @@ function isPageArtifact(value) {
       "diagnostics"
     ],
     ["contentDescriptors"]
-  ) && string2(value.id) && isIdentity(value.identity) && string2(value.revision) && isFingerprint(value.fingerprint) && Array.isArray(value.dependencies) && value.dependencies.every(isDependency) && Array.isArray(value.content) && value.content.every(isLinkedContent) && Array.isArray(value.exportedKeywords) && value.exportedKeywords.every(isKeyword) && stringArray(value.usedKeywords) && Array.isArray(value.searchRecords) && value.searchRecords.every(isSearch) && Array.isArray(value.routes) && value.routes.every(isRoute) && Array.isArray(value.apiList) && value.apiList.every(isApiList) && Array.isArray(value.outputs) && value.outputs.every((output) => isFileOutput(output) && validOutputDigest(output)) && Array.isArray(value.diagnostics) && value.diagnostics.every(isDiagnostic) && validDescriptorPlan(value);
+  ) && string2(value["id"]) && isIdentity(value["identity"]) && string2(value["revision"]) && isFingerprint(value["fingerprint"]) && Array.isArray(value["dependencies"]) && value["dependencies"].every(isDependency) && Array.isArray(value["content"]) && value["content"].every(isLinkedContent) && Array.isArray(value["exportedKeywords"]) && value["exportedKeywords"].every(isKeyword) && stringArray(value["usedKeywords"]) && Array.isArray(value["searchRecords"]) && value["searchRecords"].every(isSearch) && Array.isArray(value["routes"]) && value["routes"].every(isRoute) && Array.isArray(value["apiList"]) && value["apiList"].every(isApiList) && Array.isArray(value["outputs"]) && value["outputs"].every((output) => isFileOutput(output) && validOutputDigest(output)) && Array.isArray(value["diagnostics"]) && value["diagnostics"].every(isDiagnostic) && validDescriptorPlan(value);
 }
 function isJsonTree(value, ancestors = /* @__PURE__ */ new WeakSet()) {
   if (value === null || string2(value) || typeof value === "boolean") return true;
@@ -6275,19 +6316,19 @@ function validOutputDigest(output) {
   }
 }
 function isPublishedGeneratorConfiguration(value) {
-  return isJsonTree(value) && isRecord2(value) && exact(value, ["outputRoot", "cacheRoot", "assetDirectory", "themes", "digest"]) && [value.outputRoot, value.cacheRoot].every(
+  return isJsonTree(value) && isRecord2(value) && exact(value, ["outputRoot", "cacheRoot", "assetDirectory", "themes", "digest"]) && [value["outputRoot"], value["cacheRoot"]].every(
     (item) => string2(item) && path6.isAbsolute(item) && path6.resolve(item).replace(/\\/g, "/") === item && !item.includes("\0")
-  ) && string2(value.assetDirectory) && !path6.win32.parse(value.assetDirectory).root && safeRelative(value.assetDirectory) && isRecord2(value.themes) && exact(value.themes, ["light", "dark"]) && string2(value.themes.light) && string2(value.themes.dark) && string2(value.digest);
+  ) && string2(value["assetDirectory"]) && !path6.win32.parse(value["assetDirectory"]).root && safeRelative(value["assetDirectory"]) && isRecord2(value["themes"]) && exact(value["themes"], ["light", "dark"]) && string2(value["themes"]["light"]) && string2(value["themes"]["dark"]) && string2(value["digest"]);
 }
 function isArtifactSnapshotShape(value) {
   return isJsonTree(value) && isRecord2(value) && exact(
     value,
     ["projectId", "revision", "artifacts", "globalKeywords", "remoteKeywords"],
     ["configuration"]
-  ) && (value.configuration === void 0 || isPublishedGeneratorConfiguration(value.configuration)) && string2(value.projectId) && string2(value.revision) && Array.isArray(value.artifacts) && value.artifacts.every(isPageArtifact) && Array.isArray(value.globalKeywords) && value.globalKeywords.every(isKeyword) && Array.isArray(value.remoteKeywords) && value.remoteKeywords.every(isRemoteKeywords);
+  ) && (value["configuration"] === void 0 || isPublishedGeneratorConfiguration(value["configuration"])) && string2(value["projectId"]) && string2(value["revision"]) && Array.isArray(value["artifacts"]) && value["artifacts"].every(isPageArtifact) && Array.isArray(value["globalKeywords"]) && value["globalKeywords"].every(isKeyword) && Array.isArray(value["remoteKeywords"]) && value["remoteKeywords"].every(isRemoteKeywords);
 }
 function isRemoteKeywords(remote) {
-  return isRecord2(remote) && exact(remote, ["loaderId", "digest", "keywords"], ["validator"]) && string2(remote.loaderId) && string2(remote.digest) && Array.isArray(remote.keywords) && remote.keywords.every(isKeyword) && (remote.validator === void 0 || string2(remote.validator));
+  return isRecord2(remote) && exact(remote, ["loaderId", "digest", "keywords"], ["validator"]) && string2(remote["loaderId"]) && string2(remote["digest"]) && Array.isArray(remote["keywords"]) && remote["keywords"].every(isKeyword) && (remote["validator"] === void 0 || string2(remote["validator"]));
 }
 function isSnapshotEnvelope(value) {
   if (!isRecord2(value) || Object.getPrototypeOf(value) !== Object.prototype) return false;
@@ -6298,7 +6339,7 @@ function isSnapshotEnvelope(value) {
     return descriptor?.enumerable === true && "value" in descriptor;
   }))
     return false;
-  const artifacts = value.artifacts;
+  const artifacts = value["artifacts"];
   if (!Array.isArray(artifacts) || Object.getPrototypeOf(artifacts) !== Array.prototype || Reflect.ownKeys(artifacts).length !== artifacts.length + 1)
     return false;
   for (let index = 0; index < artifacts.length; index += 1)
@@ -6307,14 +6348,14 @@ function isSnapshotEnvelope(value) {
     value,
     ["projectId", "revision", "artifacts", "globalKeywords", "remoteKeywords"],
     ["configuration"]
-  ) && (value.configuration === void 0 || isPublishedGeneratorConfiguration(value.configuration)) && string2(value.projectId) && string2(value.revision) && isJsonTree(value.globalKeywords) && Array.isArray(value.globalKeywords) && value.globalKeywords.every(isKeyword) && isJsonTree(value.remoteKeywords) && Array.isArray(value.remoteKeywords) && value.remoteKeywords.every(isRemoteKeywords);
+  ) && (value["configuration"] === void 0 || isPublishedGeneratorConfiguration(value["configuration"])) && string2(value["projectId"]) && string2(value["revision"]) && isJsonTree(value["globalKeywords"]) && Array.isArray(value["globalKeywords"]) && value["globalKeywords"].every(isKeyword) && isJsonTree(value["remoteKeywords"]) && Array.isArray(value["remoteKeywords"]) && value["remoteKeywords"].every(isRemoteKeywords);
 }
 function isOutputManifest(value) {
-  return isJsonTree(value) && isRecord2(value) && exact(value, ["schemaVersion", "projectId", "generation", "revision", "files"]) && value.schemaVersion === OUTPUT_SCHEMA_VERSION && string2(value.projectId) && finite(value.generation) && string2(value.revision) && Array.isArray(value.files) && value.files.every(
-    (file) => isRecord2(file) && exact(file, ["path", "ownerId", "digest", "role"]) && string2(file.path) && string2(file.ownerId) && string2(file.digest) && safeRelative(file.path) && ["angular", "content", "asset", "routes", "context", "search", "api-list"].includes(
-      String(file.role)
+  return isJsonTree(value) && isRecord2(value) && exact(value, ["schemaVersion", "projectId", "generation", "revision", "files"]) && value["schemaVersion"] === OUTPUT_SCHEMA_VERSION && string2(value["projectId"]) && finite(value["generation"]) && string2(value["revision"]) && Array.isArray(value["files"]) && value["files"].every(
+    (file) => isRecord2(file) && exact(file, ["path", "ownerId", "digest", "role"]) && string2(file["path"]) && string2(file["ownerId"]) && string2(file["digest"]) && safeRelative(file["path"]) && ["angular", "content", "asset", "routes", "context", "search", "api-list"].includes(
+      String(file["role"])
     )
-  ) && new Set(value.files.map((file) => file.path)).size === value.files.length;
+  ) && new Set(value["files"].map((file) => file.path)).size === value["files"].length;
 }
 function safeRelative(value) {
   try {
@@ -6606,16 +6647,18 @@ function quoteWindowsArgument(value, twice = false) {
 }
 function nodeEntry(command, options) {
   const exists2 = options.isFile ?? isFile;
-  const name = /^(ng|npm|npx)(?:\.cmd)?$/i.exec(command)?.[1]?.toLowerCase();
+  const name = /^(ng|npm|npx|pnpm|pnpx)(?:\.cmd)?$/i.exec(command)?.[1]?.toLowerCase();
   if (!name) return void 0;
+  const nodeDirectory = path8.win32.dirname(options.execPath ?? process.execPath);
+  if (name === "pnpm" || name === "pnpx") {
+    const shim = resolveWindowsCommand(name, options);
+    if (!shim || path8.win32.dirname(shim).toLowerCase() !== nodeDirectory.toLowerCase())
+      return void 0;
+    const entry = path8.win32.join(nodeDirectory, "node_modules", "corepack", "dist", `${name}.js`);
+    return exists2(entry) ? entry : void 0;
+  }
   if (name !== "ng") {
-    const entry = path8.win32.join(
-      path8.win32.dirname(options.execPath ?? process.execPath),
-      "node_modules",
-      "npm",
-      "bin",
-      `${name}-cli.js`
-    );
+    const entry = path8.win32.join(nodeDirectory, "node_modules", "npm", "bin", `${name}-cli.js`);
     return exists2(entry) ? entry : void 0;
   }
   for (let directory = path8.win32.resolve(options.cwd); ; ) {