@ng-doc/builder 22.0.0 → 22.2.0

package/generator/bootstrap/cli.js

@@ -250,6 +250,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,
@@ -260,6 +275,16 @@ var ENGINE_SWITCHES = Object.freeze([
     values: /^(0|false|off|no|verify)$/i,
     effect: "every code block is highlighted again"
   },
+  {
+    name: "NGDOC_FORMAT_CACHE",
+    values: /^(0|false|off|no|verify)$/i,
+    effect: "every signature and snippet is formatted again"
+  },
+  {
+    name: "NGDOC_USED_GRAMMARS",
+    values: /^(0|false|off|no)$/i,
+    effect: "every Shiki grammar is loaded before code is highlighted"
+  },
   {
     name: "NGDOC_PARALLEL_RENDER",
     values: /^(0|false|off|no|verify)$/i,
@@ -1596,7 +1621,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 = "a837a4b43736f6b95b5565f442aa62d2f2175fb549d7a44138d2955d465c9ac3";
+var GENERATOR_TOOLCHAIN_DIGEST = "495b74972f5c2d99ad311bd24b03e2560f77343e401abd7c4d8185e4fee96764";
 
 // libs/builder/generator/bootstrap/index.ts
 import path7 from "node:path";
@@ -1614,12 +1639,17 @@ 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";
 var HIGHLIGHT_CACHE_FLAG = "NGDOC_HIGHLIGHT_CACHE";
+var FORMAT_CACHE_FLAG = "NGDOC_FORMAT_CACHE";
 var PARALLEL_RENDER_FLAG = "NGDOC_PARALLEL_RENDER";
+var USED_GRAMMARS_FLAG = "NGDOC_USED_GRAMMARS";
 var FLAGS = Object.freeze(
   [
     {
@@ -1687,6 +1717,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.",
@@ -1697,6 +1742,16 @@ var FLAGS = Object.freeze(
       description: "Code blocks are highlighted with one Shiki highlighter per runtime and cached by their text, language, meta, themes and Shiki version; development keeps the cache beside the artifact cache.",
       verify: true
     },
+    {
+      name: FORMAT_CACHE_FLAG,
+      description: "The Prettier configuration is resolved once per generation, and formatted signatures and snippets are cached by their code, parser, configuration and Prettier version; development keeps the cache beside the artifact cache.",
+      verify: true
+    },
+    {
+      name: USED_GRAMMARS_FLAG,
+      description: "Code blocks are highlighted by a highlighter that loads only the Shiki grammars their languages reach, instead of every bundled grammar; the HTML is the same.",
+      verify: false
+    },
     {
       name: PARALLEL_RENDER_FLAG,
       description: "A large generation runs the HTML processing of its pages (highlighting, anchors, keyword links, search records) on up to four worker threads, while the main thread prepares the next pages in order.",
@@ -2662,29 +2717,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;
@@ -2692,10 +2747,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 });
@@ -2706,17 +2761,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
@@ -2724,16 +2779,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:
@@ -5750,7 +5805,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;
 }
@@ -5764,17 +5819,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: [] });
@@ -5957,7 +6012,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",
@@ -5965,7 +6020,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, [
@@ -5975,40 +6030,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",
@@ -6017,8 +6072,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) {
@@ -6026,17 +6081,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,
     [
@@ -6055,7 +6110,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(
@@ -6069,23 +6126,31 @@ function isRoute(value) {
       "metadata",
       "category",
       "modulePath",
-      "apiListSegment"
+      "apiListSegment",
+      "demoModulePath",
+      "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.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(
@@ -6109,23 +6174,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;
@@ -6210,7 +6275,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;
@@ -6245,19 +6310,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;
@@ -6268,7 +6333,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)
@@ -6277,14 +6342,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 {
@@ -6576,16 +6641,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); ; ) {