@ng-doc/builder 22.1.0 → 22.2.0

package/generator/vite/index.js

@@ -1,5 +1,5 @@
 // libs/builder/generator/vite/plugin.ts
-import path20 from "node:path";
+import path21 from "node:path";
 
 // libs/builder/generator/artifacts/index.ts
 import { randomUUID } from "node:crypto";
@@ -49,24 +49,24 @@ function sha256Hex(value) {
 function canonicalJson(value) {
   return canonical(value, /* @__PURE__ */ new Set()) ?? "null";
 }
-function canonical(value, path25) {
+function canonical(value, path26) {
   if (value !== null && typeof value === "object" && typeof value.toJSON === "function")
     value = value.toJSON();
   if (value === null || typeof value !== "object") return JSON.stringify(value);
-  if (path25.has(value)) throw new TypeError("Converting circular structure to canonical JSON");
-  path25.add(value);
+  if (path26.has(value)) throw new TypeError("Converting circular structure to canonical JSON");
+  path26.add(value);
   let text5;
   if (Array.isArray(value)) {
-    text5 = `[${Array.from(value, (item) => canonical(item, path25) ?? "null").join(",")}]`;
+    text5 = `[${Array.from(value, (item) => canonical(item, path26) ?? "null").join(",")}]`;
   } else {
     const fields = [];
     for (const key of Object.keys(value).sort(compareCodeUnits)) {
-      const item = canonical(value[key], path25);
+      const item = canonical(value[key], path26);
       if (item !== void 0) fields.push(`${JSON.stringify(key)}:${item}`);
     }
     text5 = `{${fields.join(",")}}`;
   }
-  path25.delete(value);
+  path26.delete(value);
   return text5;
 }
 function digestOf(value) {
@@ -1608,7 +1608,7 @@ function normalizeRelative(value) {
   return normalized;
 }
 function trustedBase(last, request) {
-  const published = (manifest) => isRecord(manifest) && manifest.projectId === last.projectId && manifest.revision === last.revision && manifest.generation === last.generation;
+  const published = (manifest) => isRecord(manifest) && manifest["projectId"] === last.projectId && manifest["revision"] === last.revision && manifest["generation"] === last.generation;
   const base = request.base;
   return isRecord(base) && published(base.manifest) && published(request.previous) && isRecord(base.snapshot) && base.snapshot.projectId === last.projectId && base.snapshot.revision === last.revision;
 }
@@ -1622,17 +1622,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 isRecord(candidate) && isRecord(candidate.configuration) ? candidate.configuration.digest : void 0;
+  return isRecord(candidate) && isRecord(candidate["configuration"]) ? candidate["configuration"]["digest"] : void 0;
 }
 function unchangedArtifact(artifact, last) {
-  const id = artifact.id;
-  const outputs = artifact.outputs;
-  if (!string(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 (!string(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 (!isRecord(output) || !string(output.path)) return false;
-    const entry = last.files.get(output.path);
-    return entry?.ownerId === id && entry.digest === output.digest && entry.role === output.role;
+    if (!isRecord(output) || !string(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: [] });
@@ -1815,7 +1815,7 @@ function stringArray(value) {
 function isIdentity(value) {
   if (!isRecord(value) || !exact(value, ["projectId", "entryId", "role"], ["declarationId", "part"]))
     return false;
-  return string(value.projectId) && string(value.entryId) && [
+  return string(value["projectId"]) && string(value["entryId"]) && [
     "page-shell",
     "content",
     "demo-assets",
@@ -1823,7 +1823,7 @@ function isIdentity(value) {
     "category",
     "api-list",
     "aggregate"
-  ].includes(String(value.role)) && (value.declarationId === void 0 || string(value.declarationId)) && (value.part === void 0 || string(value.part));
+  ].includes(String(value["role"])) && (value["declarationId"] === void 0 || string(value["declarationId"])) && (value["part"] === void 0 || string(value["part"]));
 }
 function isFingerprint(value) {
   return isRecord(value) && exact(value, [
@@ -1833,40 +1833,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(string);
 }
 function isDependency(value) {
-  if (!isRecord(value) || !string(value.kind)) return false;
-  if (value.kind === "content")
-    return exact(value, ["kind", "path", "digest"]) && string(value.path) && string(value.digest);
-  if (value.kind === "existence")
-    return exact(value, ["kind", "path", "exists"]) && string(value.path) && typeof value.exists === "boolean";
-  if (value.kind === "glob")
-    return exact(value, ["kind", "root", "include", "exclude", "members"]) && string(value.root) && stringArray(value.include) && stringArray(value.exclude) && stringArray(value.members);
-  if (value.kind === "semantic")
-    return exact(value, ["kind", "scopeId", "digest", "files", "reason"]) && string(value.scopeId) && string(value.digest) && stringArray(value.files) && string(value.reason);
-  if (value.kind === "semantic-reference")
-    return exact(value, ["kind", "scopeId", "digest", "reason"]) && string(value.scopeId) && string(value.digest) && string(value.reason);
-  if (value.kind === "semantic-closure")
-    return exact(value, ["kind", "scopeId", "key", "digest"]) && string(value.scopeId) && string(value.key) && string(value.digest);
-  if (value.kind === "evaluated")
-    return exact(value, ["kind", "entryId", "digest"]) && string(value.entryId) && string(value.digest);
-  return value.kind === "keyword" && exact(value, ["kind", "key", "digest"]) && string(value.key) && string(value.digest);
+  if (!isRecord(value) || !string(value["kind"])) return false;
+  if (value["kind"] === "content")
+    return exact(value, ["kind", "path", "digest"]) && string(value["path"]) && string(value["digest"]);
+  if (value["kind"] === "existence")
+    return exact(value, ["kind", "path", "exists"]) && string(value["path"]) && typeof value["exists"] === "boolean";
+  if (value["kind"] === "glob")
+    return exact(value, ["kind", "root", "include", "exclude", "members"]) && string(value["root"]) && stringArray(value["include"]) && stringArray(value["exclude"]) && stringArray(value["members"]);
+  if (value["kind"] === "semantic")
+    return exact(value, ["kind", "scopeId", "digest", "files", "reason"]) && string(value["scopeId"]) && string(value["digest"]) && stringArray(value["files"]) && string(value["reason"]);
+  if (value["kind"] === "semantic-reference")
+    return exact(value, ["kind", "scopeId", "digest", "reason"]) && string(value["scopeId"]) && string(value["digest"]) && string(value["reason"]);
+  if (value["kind"] === "semantic-closure")
+    return exact(value, ["kind", "scopeId", "key", "digest"]) && string(value["scopeId"]) && string(value["key"]) && string(value["digest"]);
+  if (value["kind"] === "evaluated")
+    return exact(value, ["kind", "entryId", "digest"]) && string(value["entryId"]) && string(value["digest"]);
+  return value["kind"] === "keyword" && exact(value, ["kind", "key", "digest"]) && string(value["key"]) && string(value["digest"]);
 }
 function isKeyword(value) {
-  return isRecord(value) && exact(value, ["key", "title", "path"], ["type", "languages", "description"]) && string(value.key) && string(value.title) && string(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 || string(item));
+  return isRecord(value) && exact(value, ["key", "title", "path"], ["type", "languages", "description"]) && string(value["key"]) && string(value["title"]) && string(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 || string(item));
 }
 function isSource(value) {
-  return isRecord(value) && exact(value, ["path"], ["line", "column"]) && string(value.path) && (value.line === void 0 || finite(value.line)) && (value.column === void 0 || finite(value.column));
+  return isRecord(value) && exact(value, ["path"], ["line", "column"]) && string(value["path"]) && (value["line"] === void 0 || finite(value["line"])) && (value["column"] === void 0 || finite(value["column"]));
 }
 function isDiagnostic(value) {
-  return isRecord(value) && exact(value, ["code", "severity", "message", "stage"], ["source", "ownerId", "related"]) && string(value.code) && ["error", "warning", "info"].includes(String(value.severity)) && string(value.message) && [
+  return isRecord(value) && exact(value, ["code", "severity", "message", "stage"], ["source", "ownerId", "related"]) && string(value["code"]) && ["error", "warning", "info"].includes(String(value["severity"])) && string(value["message"]) && [
     "discovery",
     "evaluation",
     "semantic",
@@ -1875,8 +1875,8 @@ function isDiagnostic(value) {
     "cache",
     "commit",
     "host"
-  ].includes(String(value.stage)) && (value.source === void 0 || isSource(value.source)) && (value.ownerId === void 0 || string(value.ownerId)) && (value.related === void 0 || Array.isArray(value.related) && value.related.every(
-    (item) => isRecord(item) && exact(item, ["message", "source"]) && string(item.message) && isSource(item.source)
+  ].includes(String(value["stage"])) && (value["source"] === void 0 || isSource(value["source"])) && (value["ownerId"] === void 0 || string(value["ownerId"])) && (value["related"] === void 0 || Array.isArray(value["related"]) && value["related"].every(
+    (item) => isRecord(item) && exact(item, ["message", "source"]) && string(item["message"]) && isSource(item["source"])
   ));
 }
 function isSearch(value) {
@@ -1884,17 +1884,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(string) && [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(string) && [value["fragment"], value["kind"], value["signature"], value["description"]].every(
     (item) => item === void 0 || string(item)
   );
 }
 function isAnchor(value) {
-  return isRecord(value) && exact(value, ["anchorId", "anchor", "title", "type"], ["scope"]) && [value.anchorId, value.anchor, value.title].every(string) && ["heading", "member"].includes(String(value.type)) && (value.scope === void 0 || isRecord(value.scope) && exact(value.scope, ["key", "title"]) && string(value.scope.key) && string(value.scope.title));
+  return isRecord(value) && exact(value, ["anchorId", "anchor", "title", "type"], ["scope"]) && [value["anchorId"], value["anchor"], value["title"]].every(string) && ["heading", "member"].includes(String(value["type"])) && (value["scope"] === void 0 || isRecord(value["scope"]) && exact(value["scope"], ["key", "title"]) && string(value["scope"]["key"]) && string(value["scope"]["title"]));
 }
 function isLinkedContent(value) {
-  if (!isRecord(value) || !exact(value, ["ir", "html", "searchRecords", "keywordDigest"]) || !string(value.html) || !string(value.keywordDigest) || !Array.isArray(value.searchRecords) || !value.searchRecords.every(isSearch) || !isRecord(value.ir))
+  if (!isRecord(value) || !exact(value, ["ir", "html", "searchRecords", "keywordDigest"]) || !string(value["html"]) || !string(value["keywordDigest"]) || !Array.isArray(value["searchRecords"]) || !value["searchRecords"].every(isSearch) || !isRecord(value["ir"]))
     return false;
-  const ir = value.ir;
+  const ir = value["ir"];
   return exact(
     ir,
     [
@@ -1913,7 +1913,9 @@ function isLinkedContent(value) {
       "diagnostics"
     ],
     ["icon", "searchBreadcrumbs"]
-  ) && ir.schemaVersion === SCHEMA_VERSION && [ir.id, ir.entryId, ir.title, ir.route, ir.absoluteRoute, ir.html].every(string) && ["guide-tab", "api-tab", "header", "demo-assets"].includes(String(ir.role)) && (ir.searchBreadcrumbs === void 0 || stringArray(ir.searchBreadcrumbs)) && (ir.icon === void 0 || string(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(
+    string
+  ) && ["guide-tab", "api-tab", "header", "demo-assets"].includes(String(ir["role"])) && (ir["searchBreadcrumbs"] === void 0 || stringArray(ir["searchBreadcrumbs"])) && (ir["icon"] === void 0 || string(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 isRecord(value) && exact(
@@ -1929,23 +1931,29 @@ function isRoute(value) {
       "modulePath",
       "apiListSegment",
       "demoModulePath",
-      "demoNames"
+      "demoNames",
+      "playgroundPages"
     ]
-  ) && [value.id, value.path, value.title].every(string) && (value.parentId === void 0 || string(value.parentId)) && (value.order === void 0 || finite(value.order)) && (value.hidden === void 0 || typeof value.hidden === "boolean") && (value.icon === void 0 || string(value.icon)) && (value.modulePath === void 0 || string(value.modulePath)) && (value.apiListSegment === void 0 || string(value.apiListSegment)) && (value.demoModulePath === void 0 || string(value.demoModulePath)) && (value.demoNames === void 0 || stringArray(value.demoNames)) && (value.metadata === void 0 || isRecord(value.metadata) && exact(value.metadata, ["description", "tags"]) && string(value.metadata.description) && isRecord(value.metadata.tags) && Object.values(value.metadata.tags).every(stringArray)) && (value.category === void 0 || isRecord(value.category) && exact(value.category, ["runtimeImport"], ["expandable", "expanded"]) && isRecord(value.category.runtimeImport) && exact(value.category.runtimeImport, ["source", "exportName"]) && string(value.category.runtimeImport.source) && string(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(string) && (value["parentId"] === void 0 || string(value["parentId"])) && (value["order"] === void 0 || finite(value["order"])) && (value["hidden"] === void 0 || typeof value["hidden"] === "boolean") && (value["icon"] === void 0 || string(value["icon"])) && (value["modulePath"] === void 0 || string(value["modulePath"])) && (value["apiListSegment"] === void 0 || string(value["apiListSegment"])) && (value["demoModulePath"] === void 0 || string(value["demoModulePath"])) && (value["demoNames"] === void 0 || stringArray(value["demoNames"])) && (value["playgroundPages"] === void 0 || stringArray(value["playgroundPages"])) && (value["metadata"] === void 0 || isRecord(value["metadata"]) && exact(value["metadata"], ["description", "tags"]) && string(value["metadata"]["description"]) && isRecord(value["metadata"]["tags"]) && Object.values(value["metadata"]["tags"]).every(stringArray)) && (value["category"] === void 0 || isRecord(value["category"]) && exact(value["category"], ["runtimeImport"], ["expandable", "expanded"]) && isRecord(value["category"]["runtimeImport"]) && exact(value["category"]["runtimeImport"], ["source", "exportName"]) && string(value["category"]["runtimeImport"]["source"]) && string(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 isRecord(value) && exact(
     value,
     ["apiEntryId", "scopeId", "scopeTitle", "name", "type", "route"],
     ["description", "signature"]
-  ) && [value.apiEntryId, value.scopeId, value.scopeTitle, value.name, value.type, value.route].every(
-    string
-  ) && [value.description, value.signature].every((item) => item === void 0 || string(item));
+  ) && [
+    value["apiEntryId"],
+    value["scopeId"],
+    value["scopeTitle"],
+    value["name"],
+    value["type"],
+    value["route"]
+  ].every(string) && [value["description"], value["signature"]].every((item) => item === void 0 || string(item));
 }
 function isFileOutput(value) {
-  return isRecord(value) && exact(value, ["path", "role", "encoding", "content", "digest"]) && string(value.path) && ["angular", "content", "asset", "routes", "context", "search", "api-list"].includes(
-    String(value.role)
-  ) && ["utf8", "base64"].includes(String(value.encoding)) && string(value.content) && string(value.digest);
+  return isRecord(value) && exact(value, ["path", "role", "encoding", "content", "digest"]) && string(value["path"]) && ["angular", "content", "asset", "routes", "context", "search", "api-list"].includes(
+    String(value["role"])
+  ) && ["utf8", "base64"].includes(String(value["encoding"])) && string(value["content"]) && string(value["digest"]);
 }
 function isContentDescriptor(value) {
   if (!isRecord(value) || !exact(
@@ -1969,23 +1977,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(string) || ![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(string) || ![value["id"], value["ownerId"], value["inputDigest"], value["requestDigest"]].every(
     (item) => string(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 && !string(value.icon) || value.keyword !== void 0 && !string(value.keyword) || !isRecord(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 && !string(value["icon"]) || value["keyword"] !== void 0 && !string(value["keyword"]) || !isRecord(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" && string(locator.markdown) : exact(locator, ["kind", "declarationId"]) && locator.kind === "api-tab" && string(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" && string(locator["markdown"]) : exact(locator, ["kind", "declarationId"]) && locator["kind"] === "api-tab" && string(locator["declarationId"]);
 }
 function isPhysicalDescriptorDependency(value) {
-  return isRecord(value) && (value.kind === "content" && exact(value, ["kind", "path", "digest"]) && absoluteNormalizedPath(value.path) && string(value.digest) || value.kind === "existence" && exact(value, ["kind", "path", "exists"]) && absoluteNormalizedPath(value.path) && typeof value.exists === "boolean");
+  return isRecord(value) && (value["kind"] === "content" && exact(value, ["kind", "path", "digest"]) && absoluteNormalizedPath(value["path"]) && string(value["digest"]) || value["kind"] === "existence" && exact(value, ["kind", "path", "exists"]) && absoluteNormalizedPath(value["path"]) && typeof value["exists"] === "boolean");
 }
 function validDescriptorPlan(artifact) {
   const descriptors = artifact.contentDescriptors;
@@ -2070,7 +2078,7 @@ function isPageArtifact(value) {
       "diagnostics"
     ],
     ["contentDescriptors"]
-  ) && string(value.id) && isIdentity(value.identity) && string(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);
+  ) && string(value["id"]) && isIdentity(value["identity"]) && string(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 || string(value) || typeof value === "boolean") return true;
@@ -2105,19 +2113,19 @@ function validOutputDigest(output) {
   }
 }
 function isPublishedGeneratorConfiguration(value) {
-  return isJsonTree(value) && isRecord(value) && exact(value, ["outputRoot", "cacheRoot", "assetDirectory", "themes", "digest"]) && [value.outputRoot, value.cacheRoot].every(
+  return isJsonTree(value) && isRecord(value) && exact(value, ["outputRoot", "cacheRoot", "assetDirectory", "themes", "digest"]) && [value["outputRoot"], value["cacheRoot"]].every(
     (item) => string(item) && path2.isAbsolute(item) && path2.resolve(item).replace(/\\/g, "/") === item && !item.includes("\0")
-  ) && string(value.assetDirectory) && !path2.win32.parse(value.assetDirectory).root && safeRelative(value.assetDirectory) && isRecord(value.themes) && exact(value.themes, ["light", "dark"]) && string(value.themes.light) && string(value.themes.dark) && string(value.digest);
+  ) && string(value["assetDirectory"]) && !path2.win32.parse(value["assetDirectory"]).root && safeRelative(value["assetDirectory"]) && isRecord(value["themes"]) && exact(value["themes"], ["light", "dark"]) && string(value["themes"]["light"]) && string(value["themes"]["dark"]) && string(value["digest"]);
 }
 function isArtifactSnapshotShape(value) {
   return isJsonTree(value) && isRecord(value) && exact(
     value,
     ["projectId", "revision", "artifacts", "globalKeywords", "remoteKeywords"],
     ["configuration"]
-  ) && (value.configuration === void 0 || isPublishedGeneratorConfiguration(value.configuration)) && string(value.projectId) && string(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"])) && string(value["projectId"]) && string(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 isRecord(remote) && exact(remote, ["loaderId", "digest", "keywords"], ["validator"]) && string(remote.loaderId) && string(remote.digest) && Array.isArray(remote.keywords) && remote.keywords.every(isKeyword) && (remote.validator === void 0 || string(remote.validator));
+  return isRecord(remote) && exact(remote, ["loaderId", "digest", "keywords"], ["validator"]) && string(remote["loaderId"]) && string(remote["digest"]) && Array.isArray(remote["keywords"]) && remote["keywords"].every(isKeyword) && (remote["validator"] === void 0 || string(remote["validator"]));
 }
 function isSnapshotEnvelope(value) {
   if (!isRecord(value) || Object.getPrototypeOf(value) !== Object.prototype) return false;
@@ -2128,7 +2136,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)
@@ -2137,14 +2145,14 @@ function isSnapshotEnvelope(value) {
     value,
     ["projectId", "revision", "artifacts", "globalKeywords", "remoteKeywords"],
     ["configuration"]
-  ) && (value.configuration === void 0 || isPublishedGeneratorConfiguration(value.configuration)) && string(value.projectId) && string(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"])) && string(value["projectId"]) && string(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) && isRecord(value) && exact(value, ["schemaVersion", "projectId", "generation", "revision", "files"]) && value.schemaVersion === OUTPUT_SCHEMA_VERSION && string(value.projectId) && finite(value.generation) && string(value.revision) && Array.isArray(value.files) && value.files.every(
-    (file) => isRecord(file) && exact(file, ["path", "ownerId", "digest", "role"]) && string(file.path) && string(file.ownerId) && string(file.digest) && safeRelative(file.path) && ["angular", "content", "asset", "routes", "context", "search", "api-list"].includes(
-      String(file.role)
+  return isJsonTree(value) && isRecord(value) && exact(value, ["schemaVersion", "projectId", "generation", "revision", "files"]) && value["schemaVersion"] === OUTPUT_SCHEMA_VERSION && string(value["projectId"]) && finite(value["generation"]) && string(value["revision"]) && Array.isArray(value["files"]) && value["files"].every(
+    (file) => isRecord(file) && exact(file, ["path", "ownerId", "digest", "role"]) && string(file["path"]) && string(file["ownerId"]) && string(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 {
@@ -2171,7 +2179,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";
@@ -2246,6 +2257,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.",
@@ -2347,11 +2373,11 @@ async function changedInputs(inputs, ownedRoots) {
   const refresher = createDependencyRefresher();
   const changes = /* @__PURE__ */ new Map();
   const add = (kind, file) => {
-    const path25 = normalize(file);
-    if (owned(path25, roots)) return;
-    const existing = changes.get(path25);
+    const path26 = normalize(file);
+    if (owned(path26, roots)) return;
+    const existing = changes.get(path26);
     if (!existing || CHANGE_RANK[kind] > CHANGE_RANK[existing.kind])
-      changes.set(path25, { kind, path: path25 });
+      changes.set(path26, { kind, path: path26 });
   };
   for (let offset = 0; offset < inputs.length; offset += CONCURRENCY) {
     await Promise.all(
@@ -2849,29 +2875,29 @@ function projectWatchInputs(dependencies) {
   const scopes = /* @__PURE__ */ new Map();
   const references = [];
   for (const dependency of dependencies) {
-    if (!isRecord2(dependency) || typeof dependency.kind !== "string")
+    if (!isRecord2(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(path5(dependency.path, "content path"));
-        string2(dependency.digest, "content digest");
+        files.add(path5(dependency["path"], "content path"));
+        string2(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(path5(dependency.path, "existence path"));
+        files.add(path5(dependency["path"], "existence path"));
         break;
       }
       case "glob": {
         if (!hasExactKeys(dependency, ["exclude", "include", "kind", "members", "root"]))
           throw new Error("Invalid glob dependency");
-        const root = path5(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 = path5(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 glob2 = { root, include, exclude };
         globs.set(JSON.stringify(glob2), glob2);
         break;
@@ -2879,10 +2905,10 @@ function projectWatchInputs(dependencies) {
       case "semantic": {
         if (!hasExactKeys(dependency, ["digest", "files", "kind", "reason", "scopeId"]))
           throw new Error("Invalid semantic dependency");
-        const scopeId = string2(dependency.scopeId, "semantic scope ID");
-        const digest = string2(dependency.digest, "semantic digest");
-        string2(dependency.reason, "semantic reason");
-        const scopeFiles = paths(dependency.files, "semantic files");
+        const scopeId = string2(dependency["scopeId"], "semantic scope ID");
+        const digest = string2(dependency["digest"], "semantic digest");
+        string2(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 });
@@ -2893,17 +2919,17 @@ function projectWatchInputs(dependencies) {
         if (!hasExactKeys(dependency, ["digest", "kind", "reason", "scopeId"]))
           throw new Error("Invalid semantic-reference dependency");
         references.push({
-          scopeId: string2(dependency.scopeId, "semantic-reference scope ID"),
-          digest: string2(dependency.digest, "semantic-reference digest")
+          scopeId: string2(dependency["scopeId"], "semantic-reference scope ID"),
+          digest: string2(dependency["digest"], "semantic-reference digest")
         });
-        string2(dependency.reason, "semantic-reference reason");
+        string2(dependency["reason"], "semantic-reference reason");
         break;
       }
       case "keyword": {
         if (!hasExactKeys(dependency, ["digest", "key", "kind"]))
           throw new Error("Invalid keyword dependency");
-        string2(dependency.key, "keyword key");
-        string2(dependency.digest, "keyword digest");
+        string2(dependency["key"], "keyword key");
+        string2(dependency["digest"], "keyword digest");
         break;
       }
       // The non-physical kinds are validated but are never watch inputs: they name no path, and
@@ -2911,16 +2937,16 @@ function projectWatchInputs(dependencies) {
       case "semantic-closure": {
         if (!hasExactKeys(dependency, ["digest", "key", "kind", "scopeId"]))
           throw new Error("Invalid semantic-closure dependency");
-        string2(dependency.scopeId, "semantic-closure scope ID");
-        string2(dependency.key, "semantic-closure key");
-        string2(dependency.digest, "semantic-closure digest");
+        string2(dependency["scopeId"], "semantic-closure scope ID");
+        string2(dependency["key"], "semantic-closure key");
+        string2(dependency["digest"], "semantic-closure digest");
         break;
       }
       case "evaluated": {
         if (!hasExactKeys(dependency, ["digest", "entryId", "kind"]))
           throw new Error("Invalid evaluated dependency");
-        string2(dependency.entryId, "evaluated entry ID");
-        string2(dependency.digest, "evaluated digest");
+        string2(dependency["entryId"], "evaluated entry ID");
+        string2(dependency["digest"], "evaluated digest");
         break;
       }
       default:
@@ -3284,7 +3310,7 @@ var GeneratorBuildSession = class {
     const pending = state.pending;
     if (queued) {
       const changes = new Map(queued.changes.map((change) => [change.path, change]));
-      pending.changes.forEach((change, path25) => changes.set(path25, change));
+      pending.changes.forEach((change, path26) => changes.set(path26, change));
       queued.changes = [...changes.values()];
       queued.origin = queued.changes.length ? "filesystem" : "reconcile";
       queued.waiters.push(...pending.waiters);
@@ -4925,7 +4951,7 @@ function createCandidateOutputCommitter(options = {}, host = {}) {
 
 // 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
 var PERSISTENT_WORKER_ENV = PERSISTENT_WORKER_FLAG;
@@ -5147,6 +5173,13 @@ function observePhysicalVersion(file) {
   }
 }
 var HostUpdateCoordinator = class {
+  /**
+   * @param notify Announces the newest settled publication to the browser. `changes` lists the
+   *   generated files that differ from the last announcement, when nothing else asks for a full
+   *   reload; without it, or when the host cannot apply the changes in place, the page reloads.
+   * @param fail Reports a host error.
+   * @param recovery What the host does after a burst.
+   */
   constructor(notify, fail, recovery) {
     this.notify = notify;
     this.fail = fail;
@@ -5167,6 +5200,13 @@ var HostUpdateCoordinator = class {
     this.disposed = false;
     /** The start and the hot updates of the current burst-detection window. */
     this.window = { start: 0, events: 0 };
+    /** Whether a module-less host update settles without waiting for the current publication. */
+    this.modulelessSettle = !flagOff(VITE_MODULELESS_SETTLE_FLAG);
+    /**
+     * Whether the pending reload must reload the page whatever its outputs: an Angular source was
+     * compiled for it, or it repairs an earlier failure (the browser shows the error overlay).
+     */
+    this.pendingFull = false;
   }
   seed(outputRoot, manifest) {
     this.outputRoot = normalize3(outputRoot);
@@ -5341,7 +5381,8 @@ var HostUpdateCoordinator = class {
    * generated output that a generation claimed. Its host hooks settle only once the newest
    * generation is published and every host obligation is drained, and by then `flush()` has sent
    * that generation's reload (or its outputs equal the last announced ones). A native reload for
-   * the same output would be a second one.
+   * the same output would be a second one. A module-less one settles earlier (see
+   * {@link settle}), but Vite has nothing of it to reload either way.
    */
   announces(read) {
     const token = this.tokensByEvent.get(read);
@@ -5366,6 +5407,25 @@ var HostUpdateCoordinator = class {
       )
     ).map((expected) => expected.path).sort();
   }
+  /**
+   * Whether the generation that claimed this TypeScript source update committed and still has a
+   * generated TypeScript module update whose Angular pass has not completed: that pass is still to
+   * come, and the source can join it (`ngDocCompanionFiles`) instead of taking a pass of its own.
+   * False for anything else: a generated output, a source no generation claimed, a generation
+   * that failed, was cancelled or rewrote no TypeScript module, or whose passes all completed.
+   * Call it after `committed(ticket)`, which waits for the generation's result.
+   * @param ticket The source's hot update ticket.
+   */
+  generationPass(ticket) {
+    const token = ticket.token;
+    const attempt = token?.attempt;
+    if (this.disposed || !token || token.generated || !token.isClaimed || token.sourceKind !== "typescript" || token.type !== "update" || !attempt?.resultSeen || attempt.resultStatus !== "success") {
+      return false;
+    }
+    return [...attempt.expected.values()].some(
+      (expected) => expected.kind === "update" && !expected.completed && COMPILER_TYPESCRIPT.test(expected.path) && !JAVASCRIPT_MODULE.test(expected.path)
+    );
+  }
   /**
    * Whether `file` is a generated output: a path below the output root of the published
    * generation. Nothing is generated before the first publication or after disposal.
@@ -5407,10 +5467,28 @@ var HostUpdateCoordinator = class {
       this.diagnosticChanged = deferred2();
     }
   }
-  /** Waits for the current accepted publication and all peer host acknowledgments. */
-  async settle(ticket) {
+  /**
+   * Waits for the current accepted publication and all peer host acknowledgments.
+   *
+   * A module-less hot update does not wait: once its hooks return, Vite has no module to update
+   * and sends nothing, and its acknowledgment has already settled what it obliged (the reload,
+   * sent by `flush()` once every obligation is settled, is this coordinator's own). Waiting made
+   * it follow every generation that started meanwhile, so under sustained churn it settled only
+   * when the churn stopped, and each wait for the host obligations to drain could time out
+   * (`NGDOC_VITE_HOST_TIMEOUT`) while every single obligation was completed in time. Nothing
+   * else changes: obligations, the reload and what is published are the same, so the switch off
+   * (`NGDOC_VITE_MODULELESS_SETTLE=0`) only makes it wait as before.
+   * @param ticket The hot update's ticket, after its acknowledgment.
+   * @param modules Whether its hooks hand Vite any module to update (or a page reload Vite sends
+   *   itself, for an HTML file without modules). Only the caller, which sees Vite's context, knows.
+   */
+  async settle(ticket, modules = true) {
     const token = ticket.token;
     if (!token || this.disposed) return;
+    if (!modules && this.modulelessSettle) {
+      this.settleModuleless(token);
+      return;
+    }
     if (!token.generated && token.isClaimed && token.sourceKind === "typescript" && token.type === "update") {
       await this.awaitWithoutDiagnostic(token.attempt.publication.promise);
       if (token.attempt.publicationStatus === "skipped" || token.attempt.publicationStatus === "cancelled") {
@@ -5426,9 +5504,14 @@ var HostUpdateCoordinator = class {
     if (!token?.attempt || this.disposed) return;
     await token.attempt.result.promise;
   }
-  async complete(ticket) {
+  /**
+   * Acknowledges a hot update that takes no compiler pass, then settles it.
+   * @param ticket The hot update's ticket.
+   * @param modules See {@link settle}.
+   */
+  async complete(ticket, modules = true) {
     await this.acknowledge(ticket);
-    await this.settle(ticket);
+    await this.settle(ticket, modules);
   }
   published(result, recovered) {
     const attempt = this.attempts.get(result.generation);
@@ -5440,6 +5523,7 @@ var HostUpdateCoordinator = class {
     this.publishedGeneration = result.generation;
     this.publication(result.generation, "success");
     if (recovered || delta.changed || compilerSource || this.pendingGeneration !== void 0) {
+      if (recovered || compilerSource) this.pendingFull = true;
       this.pendingGeneration = result.generation;
       this.pendingManifest = structuredClone(result.manifest);
       this.flush();
@@ -5452,6 +5536,7 @@ var HostUpdateCoordinator = class {
     this.burst = void 0;
     this.pendingGeneration = void 0;
     this.pendingManifest = void 0;
+    this.pendingFull = false;
     for (const attempt of this.attempts.values()) {
       attempt.result.resolve();
       attempt.shapes.resolve();
@@ -5645,8 +5730,10 @@ var HostUpdateCoordinator = class {
       return;
     if (this.latestAttempt && this.pendingGeneration < this.latestAttempt.generation) return;
     this.pendingGeneration = void 0;
+    const changes = this.pendingFull || !this.pendingManifest || !this.outputRoot ? void 0 : this.changes(this.outputRoot, this.announcedManifest, this.pendingManifest);
+    this.pendingFull = false;
     try {
-      this.notify();
+      this.notify(changes?.length ? changes : void 0);
       if (this.pendingManifest) this.announcedManifest = this.pendingManifest;
       this.pendingManifest = void 0;
     } catch (error2) {
@@ -5654,10 +5741,29 @@ var HostUpdateCoordinator = class {
     }
   }
   queueCurrentReload() {
+    this.pendingFull = true;
     this.pendingGeneration = this.publishedGeneration ?? this.manifest?.generation ?? this.pendingGeneration ?? 0;
     this.pendingManifest = structuredClone(this.manifest ?? this.announcedManifest);
     this.flush();
   }
+  /**
+   * Settles a module-less hot update without waiting (see {@link settle}).
+   * @param token The acknowledged hot update.
+   */
+  settleModuleless(token) {
+    const failure3 = this.diagnosticError();
+    if (failure3) throw failure3;
+    const attempt = token.attempt;
+    if (!attempt || token.generated || !token.isClaimed || token.sourceKind !== "typescript" || token.type !== "update") {
+      return;
+    }
+    void attempt.publication.promise.then(() => {
+      if (this.disposed || this.diagnosticError()) return;
+      if (attempt.publicationStatus === "skipped" || attempt.publicationStatus === "cancelled") {
+        this.queueCurrentReload();
+      }
+    });
+  }
   async awaitCurrentPublication(initial) {
     if (this.diagnosticError()) throw this.diagnosticError();
     let attempt = initial ?? this.latestAttempt;
@@ -5714,6 +5820,28 @@ var HostUpdateCoordinator = class {
     }
     return { changed };
   }
+  /**
+   * The generated files that differ between two manifests, in path order.
+   * @param previousManifest The outputs the browser was last told about.
+   * @param nextManifest The outputs announced now.
+   */
+  changes(root, previousManifest, nextManifest) {
+    const previous = manifestMap(previousManifest);
+    const next2 = manifestMap(nextManifest);
+    const changes = [];
+    for (const relative of [.../* @__PURE__ */ new Set([...previous.keys(), ...next2.keys()])].sort()) {
+      const before = previous.get(relative);
+      const after = next2.get(relative);
+      if (sameFile(before, after)) continue;
+      changes.push({
+        path: relative,
+        file: normalize3(path8.join(root, relative)),
+        ...before ? { before: { digest: before.digest, role: before.role } } : {},
+        ...after ? { after: { digest: after.digest, role: after.role } } : {}
+      });
+    }
+    return changes;
+  }
   prune(generation) {
     for (const [candidate, attempt] of this.attempts) {
       if (candidate < generation && ![...attempt.expected.values()].some((item) => !item.completed)) {
@@ -5865,10 +5993,23 @@ function globalStyleSheet(context) {
   };
   return context.modules.every(global) && virtual;
 }
+function handsViteModules(file, modules) {
+  return modules.length > 0 || file.endsWith(".html");
+}
+function handedModules(context, result) {
+  return Array.isArray(result) ? result : context.modules;
+}
 function analogHostHooks(compiler) {
   const hooks = compiler?.api?.ngDocHost;
   return hooks && typeof hooks === "object" && typeof hooks.passes === "number" ? hooks : void 0;
 }
+function released() {
+  let resolve;
+  const promise = new Promise((done) => {
+    resolve = done;
+  });
+  return { promise, resolve };
+}
 function error(code, message4, cause) {
   return Object.assign(
     new Error(`[${code}] ${message4}`, cause === void 0 ? void 0 : { cause }),
@@ -5950,10 +6091,10 @@ var CompilerAdmission = class {
     this.drained = new Promise((resolve) => {
       this.drainedResolve = resolve;
     });
-    let released = false;
+    let released2 = false;
     waiter.resolve(() => {
-      if (released) return;
-      released = true;
+      if (released2) return;
+      released2 = true;
       this.locked = false;
       this.drainedResolve?.();
       this.drainedResolve = void 0;
@@ -6018,6 +6159,9 @@ function composeAngularPlugins(angularPlugins, componentProbe, bridge) {
   const sharedPasses = !flagOff(ANGULAR_SHARED_PASS_FLAG);
   const compiledStates = /* @__PURE__ */ new Map();
   const hooks = flagOff(ANGULAR_STRUCTURAL_PASS_FLAG) ? void 0 : analogHostHooks(compiler);
+  const descriptionPasses = sharedPasses && !flagOff(ANGULAR_DESCRIPTION_PASS_FLAG);
+  const waitingSources = /* @__PURE__ */ new Map();
+  let admissionReleased = released();
   if (hooks)
     hooks.claimFilesystemChange = (file) => !disposed && bridge.claimsFilesystemChange?.(file) === true;
   const captureInitialCompilation = async () => {
@@ -6157,20 +6301,26 @@ function composeAngularPlugins(angularPlugins, componentProbe, bridge) {
     if (!compilerTrigger) {
       const result2 = await Reflect.apply(originalHot, this, [context]);
       await bridge.acknowledge(ticket, false);
-      await bridge.settle(ticket);
+      await bridge.settle(ticket, handsViteModules(context.file, handedModules(context, result2)));
       return result2;
     }
     await preflight();
     const resource = COMPILER_RESOURCE2.test(context.file);
     if (resource) await bridge.committed(ticket);
     else await ticket.ready;
+    if (!resource && descriptionPasses && bridge.descriptionModule?.(context.file)) {
+      await joinGenerationPass(context, ticket);
+    }
     const release = await admission.acquire();
     let result;
     try {
       if (!resource && (await coveredByInitialCompilation(context) || await coveredByCompanionPass(context))) {
         await bridge.acknowledge(ticket, false);
       } else {
-        const companions = sharedPasses && !resource ? await captureCompanions(bridge.companions?.(ticket) ?? []) : /* @__PURE__ */ new Map();
+        const companions = sharedPasses && !resource ? await captureCompanions([
+          ...bridge.companions?.(ticket) ?? [],
+          ...takeWaitingSources(context.file)
+        ]) : /* @__PURE__ */ new Map();
         const hotContext = companions.size > 0 ? { ...context, ngDocCompanionFiles: [...companions.keys()].map(analogFileId) } : context;
         const own = companions.size > 0 ? await observePhysicalState(path9.resolve(context.file)).catch(() => void 0) : void 0;
         const mark = companions.size > 0 ? bridge.diagnosticMark?.() : void 0;
@@ -6197,10 +6347,47 @@ function composeAngularPlugins(angularPlugins, componentProbe, bridge) {
       throw cause;
     } finally {
       release();
+      const ended = admissionReleased;
+      admissionReleased = released();
+      ended.resolve();
     }
-    await bridge.settle(ticket);
+    await bridge.settle(ticket, handsViteModules(context.file, handedModules(context, result)));
     return result;
   };
+  const joinGenerationPass = async (context, ticket) => {
+    await bridge.committed(ticket);
+    if (disposed || !bridge.generationPass?.(ticket)) return;
+    const file = path9.resolve(context.file);
+    const entry = { taken: false };
+    waitingSources.set(file, entry);
+    const deadline = Date.now() + HOST_COMPLETION_TIMEOUT_MS;
+    try {
+      while (!entry.taken && !disposed && bridge.generationPass(ticket)) {
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) return;
+        let timer2;
+        await Promise.race([
+          admissionReleased.promise,
+          new Promise((resolve) => {
+            timer2 = setTimeout(resolve, remaining);
+            timer2.unref?.();
+          })
+        ]);
+        clearTimeout(timer2);
+      }
+    } finally {
+      if (waitingSources.get(file) === entry) waitingSources.delete(file);
+    }
+  };
+  const takeWaitingSources = (file) => {
+    if (!bridge.generated?.(file)) return [];
+    const taken = [];
+    for (const [source, entry] of waitingSources) {
+      entry.taken = true;
+      taken.push(source);
+    }
+    return taken;
+  };
   const wrappedCompiler = {
     ...compiler,
     buildStart: replaceHandler(
@@ -6454,14 +6641,101 @@ function sameRuntimeConfiguration(left, right) {
   return left.outputRoot === right.outputRoot && left.cacheRoot === right.cacheRoot && left.assetDirectory === right.assetDirectory;
 }
 
+// libs/builder/generator/vite/content-updates.ts
+import path11 from "node:path";
+var CONTENT_UPDATE_EVENT = "ng-doc:content-update";
+var CONTENT_CLIENT_EVENT = "ng-doc:content-client";
+var CONTENT_UPDATE_VERSION = 1;
+var CONTENT_UPDATE_CLIENT = `
+const hot = import.meta.hot;
+if (hot) {
+  let queue = Promise.resolve();
+  hot.on(${JSON.stringify(CONTENT_UPDATE_EVENT)}, (update) => {
+    queue = queue.then(async () => {
+      try {
+        const payloads = await Promise.all(
+          update.modules.map(async (url) => (await import(/* @vite-ignore */ url)).default),
+        );
+        const event = new CustomEvent(${JSON.stringify(CONTENT_UPDATE_EVENT)}, {
+          cancelable: true,
+          detail: { payloads, search: update.search },
+        });
+        if (window.dispatchEvent(event)) location.reload();
+      } catch (error) {
+        console.error('[ng-doc] The content update failed; reloading the page.', error);
+        location.reload();
+      }
+    });
+  });
+  hot.send(${JSON.stringify(CONTENT_CLIENT_EVENT)}, { version: ${CONTENT_UPDATE_VERSION} });
+}
+`;
+var CLIENT_MARKER = "data-ng-doc-content-updates";
+function contentUpdateClientTags(html) {
+  if (!contentUpdatesEnabled() || html.includes(CLIENT_MARKER)) return [];
+  return [
+    {
+      tag: "script",
+      attrs: { type: "module", [CLIENT_MARKER]: "" },
+      children: CONTENT_UPDATE_CLIENT,
+      injectTo: "head"
+    }
+  ];
+}
+function contentUpdatesEnabled() {
+  return !flagOff(VITE_CONTENT_UPDATE_FLAG);
+}
+function contentOnly(changes, assetDirectory) {
+  if (!changes?.length) return void 0;
+  const keywords = path11.posix.join(assetDirectory.replace(/\\/g, "/"), "keywords.json");
+  const modules = [];
+  let search = false;
+  for (const change of changes) {
+    const { before, after } = change;
+    if (!before || !after || before.role !== after.role) return void 0;
+    if (after.role === "content" && change.path.endsWith(".content.mjs")) {
+      modules.push(change.file);
+    } else if (after.role === "search") {
+      search = true;
+    } else if (!(after.role === "asset" && change.path === keywords)) {
+      return void 0;
+    }
+  }
+  return { modules, search };
+}
+function sendContentUpdate(server, clients, changes, timestamp) {
+  const connected = [...server.ws.clients ?? []];
+  if (connected.length === 0) {
+    server.ws.send({ type: "full-reload" });
+    return;
+  }
+  const graph = server.environments["client"]?.moduleGraph;
+  const urls = /* @__PURE__ */ new Set();
+  for (const file of changes.modules) {
+    for (const module of graph?.getModulesByFile(file) ?? []) urls.add(module.url);
+  }
+  const base = server.config.base.endsWith("/") ? server.config.base : `${server.config.base}/`;
+  const message4 = {
+    version: CONTENT_UPDATE_VERSION,
+    modules: [...urls].sort().map(
+      (url) => `${base}${url.replace(/^\//, "")}${url.includes("?") ? "&" : "?"}t=${timestamp}`
+    ),
+    search: changes.search
+  };
+  for (const client of connected) {
+    if (clients.has(client)) client.send(CONTENT_UPDATE_EVENT, message4);
+    else client.send({ type: "full-reload" });
+  }
+}
+
 // libs/builder/generator/vite/demo-application.ts
 import { readFile as readFile5 } from "node:fs/promises";
-import path11 from "node:path";
+import path12 from "node:path";
 var DEMO_APPLICATION_MODULE = "demo-app.ts";
 var DEMO_PATH = /^export const NG_DOC_DEMO_PATH = '([^'\\\n]*)';$/m;
 var DEMO_PAGES = /^export const NG_DOC_DEMO_PAGES: string\[\] = (.*);$/m;
 async function readDemoApplication(outputRoot) {
-  const module = path11.join(outputRoot, DEMO_APPLICATION_MODULE);
+  const module = path12.join(outputRoot, DEMO_APPLICATION_MODULE);
   const source = await readFile5(module, "utf8").catch(() => void 0);
   const demoPath = source === void 0 ? void 0 : DEMO_PATH.exec(source)?.[1];
   const pages2 = source === void 0 ? void 0 : demoPages(DEMO_PAGES.exec(source)?.[1]);
@@ -6491,7 +6765,7 @@ function hostDiagnostic(code, message4) {
 }
 
 // libs/builder/generator/vite/lease.ts
-import path12 from "node:path";
+import path13 from "node:path";
 var identities = /* @__PURE__ */ new Map();
 var outputRoots = /* @__PURE__ */ new Map();
 function acquireOutputLease(identity2, defaultOutputRoot) {
@@ -6499,7 +6773,7 @@ function acquireOutputLease(identity2, defaultOutputRoot) {
     throw new Error(`[NGDOC_VITE_OUTPUT_LEASE] Output owner is already active for ${identity2}.`);
   }
   const token = Symbol(identity2);
-  const initialRoot = canonicalDrive(path12.resolve(defaultOutputRoot).replace(/\\/g, "/"));
+  const initialRoot = canonicalDrive(path13.resolve(defaultOutputRoot).replace(/\\/g, "/"));
   if (outputRoots.has(initialRoot)) {
     throw new Error(
       `[NGDOC_VITE_OUTPUT_LEASE] Default output root is already active: ${initialRoot}.`
@@ -6513,7 +6787,7 @@ function acquireOutputLease(identity2, defaultOutputRoot) {
   return {
     admit(value) {
       if (disposed) throw new Error("[NGDOC_VITE_OUTPUT_LEASE] Output lease is disposed.");
-      const normalized = canonicalDrive(path12.resolve(value).replace(/\\/g, "/"));
+      const normalized = canonicalDrive(path13.resolve(value).replace(/\\/g, "/"));
       const owner = outputRoots.get(normalized);
       if (owner && owner !== token) {
         throw new Error(
@@ -6544,11 +6818,11 @@ function acquireOutputLease(identity2, defaultOutputRoot) {
 
 // libs/builder/generator/vite/lifecycle.ts
 import { existsSync as existsSync5 } from "node:fs";
-import path17 from "node:path";
+import path18 from "node:path";
 
 // libs/builder/generator/vite/assets.ts
 import { readFile as readFile6 } from "node:fs/promises";
-import path13 from "node:path";
+import path14 from "node:path";
 var GENERATED_ASSET_PATH = "assets/ng-doc";
 var MIME = /* @__PURE__ */ new Map([
   [".css", "text/css; charset=utf-8"],
@@ -6570,7 +6844,7 @@ function normalizedBase(base) {
   return value.endsWith("/") ? value : `${value}/`;
 }
 function safeRelative2(value) {
-  return !!value && !value.includes("\0") && !value.includes("\\") && !path13.posix.isAbsolute(value) && !value.split("/").some((segment) => segment === ".." || segment === "");
+  return !!value && !value.includes("\0") && !value.includes("\\") && !path14.posix.isAbsolute(value) && !value.split("/").some((segment) => segment === ".." || segment === "");
 }
 function inventory(configuration, manifest) {
   const prefix = `${configuration.assetDirectory.replace(/\\/g, "/").replace(/\/$/, "")}/`;
@@ -6587,7 +6861,7 @@ function inventory(configuration, manifest) {
       throw new Error(`[NGDOC_VITE_ASSET_COLLISION] Duplicate generated asset: ${relative}.`);
     }
     result.set(relative, {
-      file: path13.join(configuration.outputRoot, output),
+      file: path14.join(configuration.outputRoot, output),
       outputName: outputName2
     });
   }
@@ -6631,7 +6905,7 @@ var GeneratedAssetInventory = class {
           response.statusCode = 200;
           response.setHeader(
             "Content-Type",
-            MIME.get(path13.extname(relative).toLowerCase()) ?? "application/octet-stream"
+            MIME.get(path14.extname(relative).toLowerCase()) ?? "application/octet-stream"
           );
           response.end(source);
         },
@@ -6665,7 +6939,7 @@ var GeneratedAssetInventory = class {
 
 // libs/builder/generator/vite/vite-event-source.ts
 import { existsSync as existsSync4, realpathSync as realpathSync2, statSync as statSync6 } from "node:fs";
-import path16 from "node:path";
+import path17 from "node:path";
 
 // libs/builder/generator/vite/external-probes.ts
 import { statSync as statSync5 } from "node:fs";
@@ -6746,7 +7020,7 @@ var ExternalProbeWatcher = class {
 
 // libs/builder/generator/vite/missing-paths.ts
 import { existsSync as existsSync3, watch as watchDirectory } from "node:fs";
-import path14 from "node:path";
+import path15 from "node:path";
 var MAX_MISSING_PATH_DIRECTORIES = 1024;
 var defaultWatch = (directory, listener) => watchDirectory(
   directory,
@@ -6754,9 +7028,9 @@ var defaultWatch = (directory, listener) => watchDirectory(
   (event, name) => listener(event, typeof name === "string" ? name : null)
 );
 function anchorOf(target) {
-  let cursor = path14.dirname(target);
+  let cursor = path15.dirname(target);
   while (!existsSync3(cursor)) {
-    const parent = path14.dirname(cursor);
+    const parent = path15.dirname(cursor);
     if (parent === cursor) break;
     cursor = parent;
   }
@@ -6843,7 +7117,7 @@ var MissingPathWatcher = class {
     const members2 = [...this.members.get(anchor) ?? []];
     const gone = !existsSync3(anchor);
     for (const target of members2) {
-      const entry = path14.relative(anchor, target).split(path14.sep)[0];
+      const entry = path15.relative(anchor, target).split(path15.sep)[0];
       if (!gone && name !== null && name !== entry) continue;
       this.refresh(target);
     }
@@ -6866,9 +7140,9 @@ var MissingPathWatcher = class {
 // libs/builder/generator/vite/watch-inputs.ts
 import { Minimatch } from "minimatch";
 import { access } from "node:fs/promises";
-import path15 from "node:path";
+import path16 from "node:path";
 function normalize4(value) {
-  return path15.resolve(value).replace(/\\/g, "/");
+  return path16.resolve(value).replace(/\\/g, "/");
 }
 function union(left, right) {
   const files = new Set([...left?.files ?? [], ...right?.files ?? []].map(normalize4));
@@ -6890,14 +7164,14 @@ function inputKey(inputs) {
   return JSON.stringify(inputs);
 }
 function absolutePattern(root, pattern) {
-  return normalize4(path15.isAbsolute(pattern) ? pattern : path15.join(root, pattern));
+  return normalize4(path16.isAbsolute(pattern) ? pattern : path16.join(root, pattern));
 }
 function patternBase(root, pattern) {
   const absolute2 = absolutePattern(root, pattern);
   const magic = absolute2.search(/[*?{}[\]()!]/);
-  if (magic < 0) return path15.dirname(absolute2).replace(/\\/g, "/");
+  if (magic < 0) return path16.dirname(absolute2).replace(/\\/g, "/");
   const slash2 = absolute2.lastIndexOf("/", magic);
-  return (slash2 > 0 ? absolute2.slice(0, slash2) : path15.parse(absolute2).root).replace(/\\/g, "/");
+  return (slash2 > 0 ? absolute2.slice(0, slash2) : path16.parse(absolute2).root).replace(/\\/g, "/");
 }
 async function nearestExisting(value) {
   let cursor = normalize4(value);
@@ -6906,7 +7180,7 @@ async function nearestExisting(value) {
       await access(cursor);
       return cursor;
     } catch {
-      const parent = path15.dirname(cursor).replace(/\\/g, "/");
+      const parent = path16.dirname(cursor).replace(/\\/g, "/");
       if (parent === cursor) return cursor;
       cursor = parent;
     }
@@ -6916,16 +7190,16 @@ function ancestorOf(target, candidate) {
   return target === candidate || target.startsWith(`${candidate}/`);
 }
 function globPattern(pattern) {
-  return path15.sep === "\\" ? pattern.replace(/\\/g, "/") : pattern;
+  return path16.sep === "\\" ? pattern.replace(/\\/g, "/") : pattern;
 }
 function compilePattern(pattern) {
   return {
-    absolute: path15.isAbsolute(pattern),
+    absolute: path16.isAbsolute(pattern),
     matcher: new Minimatch(globPattern(pattern), { dot: true })
   };
 }
 function patternMatches(glob2, pattern, changed) {
-  const subject = pattern.absolute ? changed : path15.relative(glob2.root, changed).replace(/\\/g, "/");
+  const subject = pattern.absolute ? changed : path16.relative(glob2.root, changed).replace(/\\/g, "/");
   return pattern.matcher.match(subject);
 }
 function globMatches(glob2, changed) {
@@ -7012,7 +7286,7 @@ var WatchInputRegistry = class {
     const directories = /* @__PURE__ */ new Set();
     for (const target of globBases) {
       const existing = await nearestExisting(target);
-      if (existing === path15.parse(existing).root.replace(/\\/g, "/")) {
+      if (existing === path16.parse(existing).root.replace(/\\/g, "/")) {
         throw new Error(
           `[NGDOC_VITE_WATCH_ROOT] Refusing an unbounded filesystem-root glob watch for ${target}.`
         );
@@ -7023,7 +7297,7 @@ var WatchInputRegistry = class {
       }
     }
     for (const target of desired) {
-      if (target === path15.parse(target).root.replace(/\\/g, "/")) {
+      if (target === path16.parse(target).root.replace(/\\/g, "/")) {
         throw new Error(
           `[NGDOC_VITE_WATCH_ROOT] Refusing an unbounded filesystem-root file watch for ${target}.`
         );
@@ -7082,7 +7356,7 @@ var WatchInputRegistry = class {
 
 // libs/builder/generator/vite/vite-event-source.ts
 function normalize5(value) {
-  return canonicalDrive(path16.resolve(value).replace(/\\/g, "/"));
+  return canonicalDrive(path17.resolve(value).replace(/\\/g, "/"));
 }
 function within2(target, root) {
   return target === root || target.startsWith(`${root}/`);
@@ -7103,12 +7377,12 @@ function statVersion(file) {
   }
 }
 function listed(watched, target) {
-  return watched.has(target) || (watched.get(path16.dirname(target))?.includes(path16.basename(target)) ?? false);
+  return watched.has(target) || (watched.get(path17.dirname(target))?.includes(path17.basename(target)) ?? false);
 }
 function nearestExistingPath(target) {
   let cursor = target;
   while (!existsSync4(cursor)) {
-    const parent = path16.dirname(cursor);
+    const parent = path17.dirname(cursor);
     if (parent === cursor) return cursor;
     cursor = parent;
   }
@@ -7133,7 +7407,7 @@ function workspaceRoots(root) {
     roots.add(normalize5(realpathSync2.native(root)));
   } catch {
   }
-  return [...roots].filter((value) => value !== normalize5(path16.parse(value).root));
+  return [...roots].filter((value) => value !== normalize5(path17.parse(value).root));
 }
 function watchesMissingPaths(watcher) {
   const options = watcher.options;
@@ -7585,8 +7859,20 @@ var ViteAdapterLifecycle = class {
     this.registration = Promise.resolve();
     this.disposed = false;
     this.latestStarted = -1;
+    /** Whether a content-only reload updates the open pages in place (`NGDOC_VITE_CONTENT_UPDATE`). */
+    this.contentUpdates = contentUpdatesEnabled();
+    /** The browser clients whose NgDoc client listens for content updates. */
+    this.contentClients = /* @__PURE__ */ new WeakSet();
+    /** The timestamp of the last content update: each one imports the modules anew. */
+    this.contentStamp = 0;
+    /** Records the clients that announce the NgDoc client. */
+    this.contentClient = (data, client) => {
+      if (data?.version === CONTENT_UPDATE_VERSION) {
+        this.contentClients.add(client);
+      }
+    };
     this.hostUpdates = new HostUpdateCoordinator(
-      () => this.server?.ws.send({ type: "full-reload" }),
+      (changes) => this.announce(changes),
       (error2) => this.fail(error2),
       {
         warn: (message4) => this.warn(message4),
@@ -7616,9 +7902,40 @@ var ViteAdapterLifecycle = class {
   }
   attachServer(server, source) {
     if (this.disposed) throw new Error("Vite adapter is disposed.");
+    if (this.contentUpdates && this.server !== server) {
+      this.stopContentClients();
+      if (typeof server.ws?.on === "function")
+        server.ws.on(CONTENT_CLIENT_EVENT, this.contentClient);
+    }
     this.server = server;
     this.source = source;
   }
+  /** Stops recording the clients that announce the NgDoc client. */
+  stopContentClients() {
+    try {
+      if (typeof this.server?.ws?.off === "function") {
+        this.server.ws.off(CONTENT_CLIENT_EVENT, this.contentClient);
+      }
+    } catch {
+    }
+  }
+  /**
+   * Tells the browser about the newest settled publication: a content update when it changed only
+   * content (see `contentOnly`), else a full reload.
+   * @param changes The generated files that differ from the last announcement, if the reload may
+   *   be applied in place.
+   */
+  announce(changes) {
+    const server = this.server;
+    if (!server) return;
+    const content = this.contentUpdates && this.configuration ? contentOnly(changes, this.configuration.assetDirectory) : void 0;
+    if (!content) {
+      server.ws.send({ type: "full-reload" });
+      return;
+    }
+    this.contentStamp = Math.max(Date.now(), this.contentStamp + 1);
+    sendContentUpdate(server, this.contentClients, content, this.contentStamp);
+  }
   attachWatch(watch) {
     if (this.disposed) throw new Error("Vite adapter is disposed.");
     this.watch = watch;
@@ -7669,13 +7986,13 @@ var ViteAdapterLifecycle = class {
       const read = /* @__PURE__ */ new Set();
       for (const artifact of committed.snapshot.artifacts) {
         for (const dependency of artifact.dependencies) {
-          if (dependency.kind === "content" && DESCRIPTION_MODULE.test(path17.basename(dependency.path)))
-            read.add(canonicalDrive(path17.resolve(dependency.path)));
+          if (dependency.kind === "content" && DESCRIPTION_MODULE.test(path18.basename(dependency.path)))
+            read.add(canonicalDrive(path18.resolve(dependency.path)));
         }
       }
       committed.read = read;
     }
-    return committed.read.has(canonicalDrive(path17.resolve(file)));
+    return committed.read.has(canonicalDrive(path18.resolve(file)));
   }
   hostUpdateStarted(file, type, read) {
     const change = { kind: type, path: file };
@@ -7684,13 +8001,34 @@ var ViteAdapterLifecycle = class {
     if (relevant) this.source.forward(change);
     return ticket;
   }
-  hostUpdateCompleted(ticket) {
-    return this.hostUpdates.complete(ticket);
+  /**
+   * See {@link HostUpdateCoordinator.complete}.
+   * @param ticket The hot update's ticket.
+   * @param modules Whether its hooks hand Vite any module to update.
+   */
+  hostUpdateCompleted(ticket, modules = true) {
+    return this.hostUpdates.complete(ticket, modules);
   }
   /** The adapter reloads for this settled hot update itself. */
   hostUpdateAnnounced(read) {
     return !this.disposed && this.hostUpdates.announces(read);
   }
+  /** See {@link HostUpdateCoordinator.generationPass}. */
+  hostGenerationPass(ticket) {
+    return !this.disposed && this.hostUpdates.generationPass(ticket);
+  }
+  /**
+   * Whether `file` is a description module (`ng-doc.page.ts`, `ng-doc.category.ts`,
+   * `ng-doc.api.ts`) the generator watches: its edit starts a generation that reads it.
+   * @param file An absolute path.
+   */
+  hostDescriptionModule(file) {
+    return !this.disposed && DESCRIPTION_MODULE.test(path18.basename(file)) && (this.source?.matches({ kind: "update", path: file }) ?? false);
+  }
+  /** Whether `file` is a generated output (see {@link HostUpdateCoordinator.generated}). */
+  hostGenerated(file) {
+    return !this.disposed && this.hostUpdates.generated(file);
+  }
   /** See {@link HostUpdateCoordinator.compilerCompanions}. */
   hostUpdateCompanions(ticket) {
     return this.disposed ? [] : this.hostUpdates.compilerCompanions(ticket);
@@ -7720,7 +8058,7 @@ var ViteAdapterLifecycle = class {
   hostClaimsFilesystemChange(file) {
     if (this.disposed) return false;
     if (this.hostUpdates.generated(file)) return true;
-    if (!DESCRIPTION_MODULE.test(path17.basename(file)) || !(this.source?.matches({ kind: "update", path: file }) ?? false))
+    if (!DESCRIPTION_MODULE.test(path18.basename(file)) || !(this.source?.matches({ kind: "update", path: file }) ?? false))
       return false;
     return !(this.committedDescriptionModule(file) && existsSync5(file));
   }
@@ -7738,8 +8076,13 @@ var ViteAdapterLifecycle = class {
     this.hostUpdates.diagnostic(ticket, error2);
     this.report(error2);
   }
-  hostUpdateSettled(ticket) {
-    return this.hostUpdates.settle(ticket);
+  /**
+   * See {@link HostUpdateCoordinator.settle}.
+   * @param ticket The hot update's ticket.
+   * @param modules Whether its hooks hand Vite any module to update.
+   */
+  hostUpdateSettled(ticket, modules = true) {
+    return this.hostUpdates.settle(ticket, modules);
   }
   hostUpdateCommitted(ticket) {
     return this.hostUpdates.committed(ticket);
@@ -7908,6 +8251,7 @@ var ViteAdapterLifecycle = class {
   }
   async disposeAll() {
     this.hostUpdates.dispose();
+    this.stopContentClients();
     const results = await Promise.allSettled([
       this.registration,
       this.watch?.dispose(),
@@ -7924,7 +8268,7 @@ var ViteAdapterLifecycle = class {
 var NG_DOC_SYNTAX_THEME_NAME = "css-variables";
 
 // libs/builder/generator/vite/options.ts
-import path18 from "node:path";
+import path19 from "node:path";
 
 // libs/builder/generator/progress/settings.ts
 var PROGRESS_SETTINGS = Object.freeze([
@@ -8043,6 +8387,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,
@@ -8118,7 +8477,7 @@ function resolveOptions(options) {
     );
   }
   const angularComponentProbe = text2(options.angularComponentProbe, "angularComponentProbe");
-  if (!path18.isAbsolute(angularComponentProbe) || !/\.ts$/.test(angularComponentProbe) || /\.d\.ts$/.test(angularComponentProbe) || angularComponentProbe.includes("?")) {
+  if (!path19.isAbsolute(angularComponentProbe) || !/\.ts$/.test(angularComponentProbe) || /\.d\.ts$/.test(angularComponentProbe) || angularComponentProbe.includes("?")) {
     throw new TypeError(
       "angularComponentProbe must be an absolute application .ts component path."
     );
@@ -8137,8 +8496,8 @@ function resolveOptions(options) {
   if (options.progress !== void 0 && (!isProgressSetting(options.progress) || options.progress === "json")) {
     throw new TypeError("progress must be auto, live, plain, verbose, summary or off.");
   }
-  const workspace = path18.resolve(text2(options.generator.workspaceRoot, "workspaceRoot"));
-  const defaultRoot = path18.resolve(
+  const workspace = path19.resolve(text2(options.generator.workspaceRoot, "workspaceRoot"));
+  const defaultRoot = path19.resolve(
     text2(options.generator.defaults.outputRoot, "defaults.outputRoot")
   );
   return {
@@ -8148,7 +8507,7 @@ function resolveOptions(options) {
     themeModules,
     leaseIdentity: `${text2(options.generator.projectId, "projectId")}\0${workspace}\0${defaultRoot}`,
     angularPlugins: [...options.angularPlugins],
-    angularComponentProbe: path18.normalize(angularComponentProbe),
+    angularComponentProbe: path19.normalize(angularComponentProbe),
     ...options.progress ? { progress: options.progress } : {}
   };
 }
@@ -8165,14 +8524,14 @@ function themeImports(options, configuration) {
   ].sort();
 }
 function within3(root, file) {
-  const relative = path18.relative(root, file);
-  return relative === "" || !relative.startsWith("..") && !path18.isAbsolute(relative);
+  const relative = path19.relative(root, file);
+  return relative === "" || !relative.startsWith("..") && !path19.isAbsolute(relative);
 }
 var CacheRootWatchIgnore = class {
   constructor(options) {
     this.options = options;
     const cacheRoot = options.generator.defaults.cacheRoot;
-    this.cacheRoot = typeof cacheRoot === "string" && path18.isAbsolute(cacheRoot) ? canonicalDrive(path18.resolve(cacheRoot)) : void 0;
+    this.cacheRoot = typeof cacheRoot === "string" && path19.isAbsolute(cacheRoot) ? canonicalDrive(path19.resolve(cacheRoot)) : void 0;
     this.active = this.cacheRoot !== void 0;
   }
   get ignoring() {
@@ -8186,11 +8545,11 @@ var CacheRootWatchIgnore = class {
       workspaceRoot,
       defaults.outputRoot,
       defaults.docsRoot,
-      typeof defaults.tsConfig === "string" ? path18.dirname(defaults.tsConfig) : void 0
+      typeof defaults.tsConfig === "string" ? path19.dirname(defaults.tsConfig) : void 0
     ]);
     const cacheRoot = this.cacheRoot;
     if (!this.active || !cacheRoot) return void 0;
-    return (file) => this.active && typeof file === "string" && within3(cacheRoot, path18.resolve(file));
+    return (file) => this.active && typeof file === "string" && within3(cacheRoot, path19.resolve(file));
   }
   /** Re-checks the finally resolved Vite root (a later plugin can change `root`). */
   confirmRoot(viteRoot) {
@@ -8203,7 +8562,7 @@ var CacheRootWatchIgnore = class {
   admit(configuration) {
     const cacheRoot = this.cacheRoot;
     if (!this.active || !cacheRoot) return false;
-    const publishedCache = typeof configuration.cacheRoot === "string" ? canonicalDrive(path18.resolve(configuration.cacheRoot)) : void 0;
+    const publishedCache = typeof configuration.cacheRoot === "string" ? canonicalDrive(path19.resolve(configuration.cacheRoot)) : void 0;
     if (publishedCache === cacheRoot && this.guard([configuration.outputRoot])) return false;
     this.active = false;
     return true;
@@ -8211,7 +8570,7 @@ var CacheRootWatchIgnore = class {
   guard(roots) {
     const cacheRoot = this.cacheRoot;
     if (!this.active || !cacheRoot || // Unvalidated roots are rejected by bootstrap later; never ignore when one is missing.
-    roots.some((value) => typeof value !== "string" || !value) || roots.some((value) => within3(cacheRoot, path18.resolve(value)))) {
+    roots.some((value) => typeof value !== "string" || !value) || roots.some((value) => within3(cacheRoot, path19.resolve(value)))) {
       this.active = false;
     }
     return this.active;
@@ -8219,26 +8578,26 @@ var CacheRootWatchIgnore = class {
 };
 function metadataWatchIgnore(options, viteRoot) {
   const { workspaceRoot, defaults } = options.generator;
-  if (typeof workspaceRoot !== "string" || !path18.isAbsolute(workspaceRoot)) return void 0;
-  const idea = path18.resolve(workspaceRoot, ".idea");
+  if (typeof workspaceRoot !== "string" || !path19.isAbsolute(workspaceRoot)) return void 0;
+  const idea = path19.resolve(workspaceRoot, ".idea");
   const roots = [
     viteRoot,
     defaults.outputRoot,
     defaults.docsRoot,
-    typeof defaults.tsConfig === "string" ? path18.dirname(defaults.tsConfig) : void 0
+    typeof defaults.tsConfig === "string" ? path19.dirname(defaults.tsConfig) : void 0
   ];
   const ignoreIdea = !roots.some(
-    (value) => typeof value === "string" && value && within3(idea, path18.resolve(value))
+    (value) => typeof value === "string" && value && within3(idea, path19.resolve(value))
   );
   return (file) => {
     if (typeof file !== "string") return false;
-    const target = path18.resolve(file);
-    return path18.basename(target) === ".DS_Store" || ignoreIdea && within3(idea, target);
+    const target = path19.resolve(file);
+    return path19.basename(target) === ".DS_Store" || ignoreIdea && within3(idea, target);
   };
 }
 function staticViteConfig(options, viteRoot = process.cwd(), cacheWatch = new CacheRootWatchIgnore(options)) {
-  const cacheIgnore = cacheWatch.matcher(path18.resolve(viteRoot));
-  const metadataIgnore = metadataWatchIgnore(options, path18.resolve(viteRoot));
+  const cacheIgnore = cacheWatch.matcher(path19.resolve(viteRoot));
+  const metadataIgnore = metadataWatchIgnore(options, path19.resolve(viteRoot));
   const ignored = [GENERATED_STAGE_IGNORE];
   if (cacheIgnore) ignored.push(cacheIgnore);
   if (metadataIgnore) ignored.push(metadataIgnore);
@@ -8274,10 +8633,10 @@ function assertThemeModules(options, configuration) {
 
 // libs/builder/generator/vite/output-watch.ts
 import { realpathSync as realpathSync3 } from "node:fs";
-import path19 from "node:path";
+import path20 from "node:path";
 var OUTPUT_WATCH_ATTACH_TIMEOUT_MS = 1e4;
 function normalize6(value) {
-  return canonicalDrive(path19.resolve(value).replace(/\\/g, "/"));
+  return canonicalDrive(path20.resolve(value).replace(/\\/g, "/"));
 }
 function within4(target, root) {
   return target === root || target.startsWith(`${root}/`);
@@ -8309,9 +8668,9 @@ async function watchOutputRoot(watcher, viteRoot, outputRoot, files, options = {
   for (const file of files) {
     let target = `${root}/${file.replace(/\\/g, "/")}`;
     while (target !== root && within4(target, root)) {
-      const parent = path19.posix.dirname(target);
+      const parent = path20.posix.dirname(target);
       const listed2 = entries.get(parent) ?? /* @__PURE__ */ new Set();
-      listed2.add(path19.posix.basename(target));
+      listed2.add(path20.posix.basename(target));
       entries.set(parent, listed2);
       target = parent;
     }
@@ -9727,7 +10086,7 @@ function hotPayload(value, childToServer = false) {
     case "full-reload":
       return (value.path === void 0 || typeof value.path === "string") && (value.triggeredBy === void 0 || typeof value.triggeredBy === "string");
     case "prune":
-      return Array.isArray(value.paths) && value.paths.every((path25) => typeof path25 === "string");
+      return Array.isArray(value.paths) && value.paths.every((path26) => typeof path26 === "string");
     case "update":
       return Array.isArray(value.updates) && value.updates.every(
         (update) => record2(update) && (update.type === "js-update" || update.type === "css-update") && typeof update.path === "string" && typeof update.acceptedPath === "string" && Number.isFinite(update.timestamp)
@@ -10786,6 +11145,15 @@ function createPlugin(options) {
       diagnosticMark() {
         return (active?.lifecycle ?? pendingLifecycle)?.hostDiagnosticMark() ?? 0;
       },
+      generationPass(ticket) {
+        return (active?.lifecycle ?? pendingLifecycle)?.hostGenerationPass(ticket) ?? false;
+      },
+      descriptionModule(file) {
+        return (active?.lifecycle ?? pendingLifecycle)?.hostDescriptionModule(file) ?? false;
+      },
+      generated(file) {
+        return (active?.lifecycle ?? pendingLifecycle)?.hostGenerated(file) ?? false;
+      },
       claimsFilesystemChange(file) {
         return (active?.lifecycle ?? pendingLifecycle)?.hostClaimsFilesystemChange(file) ?? false;
       },
@@ -10803,8 +11171,8 @@ function createPlugin(options) {
       committed(ticket) {
         return (active?.lifecycle ?? pendingLifecycle)?.hostUpdateCommitted(ticket) ?? Promise.resolve();
       },
-      settle(ticket) {
-        return (active?.lifecycle ?? pendingLifecycle)?.hostUpdateSettled(ticket) ?? Promise.resolve();
+      settle(ticket, modules) {
+        return (active?.lifecycle ?? pendingLifecycle)?.hostUpdateSettled(ticket, modules) ?? Promise.resolve();
       },
       fail(error2) {
         (active?.lifecycle ?? pendingLifecycle)?.hostUpdateFailed(error2);
@@ -10853,7 +11221,7 @@ function createPlugin(options) {
           "[NGDOC_VITE_BUILD_WATCH] Vite build watch is unsupported; use the development server."
         );
       }
-      return staticViteConfig(resolved, path20.resolve(config.root ?? process.cwd()), cacheWatch);
+      return staticViteConfig(resolved, path21.resolve(config.root ?? process.cwd()), cacheWatch);
     },
     configResolved(config) {
       vite = config;
@@ -10984,7 +11352,14 @@ function createPlugin(options) {
     load(id) {
       return ssrRenderer.controlModule(id) ?? null;
     },
-    transformIndexHtml: { order: "pre", handler: transformNgDocIndex },
+    transformIndexHtml: {
+      order: "pre",
+      async handler(html, context) {
+        const transformed = await transformNgDocIndex(html);
+        const tags = context?.server ? contentUpdateClientTags(transformed) : [];
+        return tags.length > 0 ? { html: transformed, tags } : transformed;
+      }
+    },
     async generateBundle(_output, bundle) {
       if (vite?.command === "build" && active) await active.lifecycle.assets.emit(this, bundle);
     },
@@ -11012,7 +11387,10 @@ function createPlugin(options) {
         const ticket = hostUpdates.get(context);
         if (ticket) {
           hostUpdates.delete(context);
-          await (active?.lifecycle ?? pendingLifecycle)?.hostUpdateCompleted(ticket);
+          const modules = handsViteModules(context.file, context.modules) || Object.values(devServer?.environments ?? {}).some(
+            (environment) => environment !== this.environment && (environment.moduleGraph.getModulesByFile(context.file)?.size ?? 0) > 0
+          );
+          await (active?.lifecycle ?? pendingLifecycle)?.hostUpdateCompleted(ticket, modules);
         }
         if (!(active?.lifecycle ?? pendingLifecycle)?.hostUpdateAnnounced(context.read)) return;
         const invalidated = /* @__PURE__ */ new Set();
@@ -11036,11 +11414,11 @@ import { minimatch as minimatch2 } from "minimatch";
 import { existsSync as existsSync6 } from "node:fs";
 import { mkdir as mkdir2, readdir, readFile as readFile8, stat as stat5, writeFile as writeFile2 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
-import path23 from "node:path";
+import path24 from "node:path";
 import { escapePath, glob } from "tinyglobby";
 
 // libs/builder/generator/vite/dev-styles.ts
-import path21 from "node:path";
+import path22 from "node:path";
 var GATE_TIMINGS = { sheet: 5e3, quiet: 1500, limit: 1e4 };
 function ngDocDevStyleGate(timings = GATE_TIMINGS) {
   return `(() => {
@@ -11099,8 +11477,8 @@ async function ngDocDevStyleTags(server, styles) {
     { tag: "script", children: NG_DOC_DEV_STYLE_GATE, injectTo: "head-prepend" }
   ];
   for (const style of styles) {
-    const relative = path21.relative(root, style);
-    const url = relative && !relative.startsWith("..") && !path21.isAbsolute(relative) ? `/${relative.split(path21.sep).join("/")}` : `/@fs/${style.split(path21.sep).join("/").replace(/^\/+/, "")}`;
+    const relative = path22.relative(root, style);
+    const url = relative && !relative.startsWith("..") && !path22.isAbsolute(relative) ? `/${relative.split(path22.sep).join("/")}` : `/@fs/${style.split(path22.sep).join("/").replace(/^\/+/, "")}`;
     try {
       const sheet = cssModuleSheet((await environment.transformRequest(url))?.code ?? "");
       if (!sheet) continue;
@@ -11132,7 +11510,7 @@ function cssModuleSheet(code) {
 }
 
 // libs/builder/generator/vite/mime.ts
-import path22 from "node:path";
+import path23 from "node:path";
 var TYPES = {
   ".aac": "audio/aac",
   ".apng": "image/apng",
@@ -11182,7 +11560,7 @@ var TYPES = {
   ".zip": "application/zip"
 };
 function contentType(file) {
-  return TYPES[path22.extname(file).toLowerCase()] ?? "application/octet-stream";
+  return TYPES[path23.extname(file).toLowerCase()] ?? "application/octet-stream";
 }
 
 // libs/builder/generator/vite/application.ts
@@ -11288,23 +11666,23 @@ function posix(value) {
   return value.replace(/\\/g, "/");
 }
 function specifier(workspaceRoot, value) {
-  const file = path23.resolve(workspaceRoot, value);
-  return value.startsWith(".") || path23.isAbsolute(value) || existsSync6(file) ? posix(file) : value;
+  const file = path24.resolve(workspaceRoot, value);
+  return value.startsWith(".") || path24.isAbsolute(value) || existsSync6(file) ? posix(file) : value;
 }
 async function resolveAssets(assets, workspaceRoot, sourceRoot) {
   const resolved = [];
   for (const [index, asset] of assets.entries()) {
     if (typeof asset === "string") {
-      const input = path23.resolve(workspaceRoot, text4(asset, `assets[${index}]`));
+      const input = path24.resolve(workspaceRoot, text4(asset, `assets[${index}]`));
       const file = await stat5(input).then(
         (value) => value.isFile(),
         () => {
           throw optionError(`assets[${index}] does not exist: ${asset}`);
         }
       );
-      const directory = file ? path23.dirname(input) : input;
-      const relative = path23.relative(sourceRoot, directory);
-      if (relative.startsWith("..") || path23.isAbsolute(relative)) {
+      const directory = file ? path24.dirname(input) : input;
+      const relative = path24.relative(sourceRoot, directory);
+      if (relative.startsWith("..") || path24.isAbsolute(relative)) {
         throw optionError(
           `assets[${index}] (${asset}) is outside sourceRoot (${sourceRoot}); use a { glob, input, output } entry.`
         );
@@ -11312,18 +11690,18 @@ async function resolveAssets(assets, workspaceRoot, sourceRoot) {
       resolved.push({
         input: directory,
         output: posix(relative),
-        glob: file ? path23.basename(input) : "**/*",
+        glob: file ? path24.basename(input) : "**/*",
         ignore: []
       });
       continue;
     }
     if (!asset || typeof asset !== "object") throw optionError(`assets[${index}] is invalid.`);
     const output = posix(asset.output ?? "").replace(/^\/+|\/+$/g, "");
-    if (output.split("/").includes("..") || path23.isAbsolute(output)) {
+    if (output.split("/").includes("..") || path24.isAbsolute(output)) {
       throw optionError(`assets[${index}].output must stay inside the output directory.`);
     }
     resolved.push({
-      input: path23.resolve(workspaceRoot, text4(asset.input, `assets[${index}].input`)),
+      input: path24.resolve(workspaceRoot, text4(asset.input, `assets[${index}].input`)),
       output,
       glob: text4(asset.glob, `assets[${index}].glob`),
       ignore: [...asset.ignore ?? []]
@@ -11345,7 +11723,7 @@ async function collectAssets(assets) {
       expandDirectories: false
     });
     for (const relative of matches.map(posix).sort()) {
-      files.set(outputName(asset, relative), path23.join(asset.input, relative));
+      files.set(outputName(asset, relative), path24.join(asset.input, relative));
     }
   }
   return files;
@@ -11365,14 +11743,14 @@ function matchAssets(assets, base, url) {
   for (const asset of [...assets].reverse()) {
     const relative = asset.output ? requested.startsWith(`${asset.output}/`) ? requested.slice(asset.output.length + 1) : void 0 : requested;
     if (relative && minimatch2(relative, asset.glob, { dot: true }) && !asset.ignore.some((pattern) => minimatch2(relative, pattern, { dot: true }))) {
-      candidates.push({ file: path23.join(asset.input, relative), relative });
+      candidates.push({ file: path24.join(asset.input, relative), relative });
     }
   }
   return candidates;
 }
 function resolvable(root, name) {
   try {
-    createRequire2(path23.join(root, "package.json")).resolve(`${name}/package.json`);
+    createRequire2(path24.join(root, "package.json")).resolve(`${name}/package.json`);
     return true;
   } catch {
     return false;
@@ -11380,17 +11758,17 @@ function resolvable(root, name) {
 }
 async function coreImports(root) {
   const found = /* @__PURE__ */ new Set();
-  const require2 = createRequire2(path23.join(root, "package.json"));
+  const require2 = createRequire2(path24.join(root, "package.json"));
   for (const name of ["@ng-doc/app", "@ng-doc/ui-kit"]) {
     let directory;
     try {
-      directory = path23.join(path23.dirname(require2.resolve(`${name}/package.json`)), "fesm2022");
+      directory = path24.join(path24.dirname(require2.resolve(`${name}/package.json`)), "fesm2022");
     } catch {
       continue;
     }
     const files = await readdir(directory).catch(() => []);
     for (const file of files.filter((item) => item.endsWith(".mjs")).sort()) {
-      for (const match of (await readFile8(path23.join(directory, file), "utf8")).matchAll(
+      for (const match of (await readFile8(path24.join(directory, file), "utf8")).matchAll(
         CORE_IMPORT
       )) {
         found.add(match[1]);
@@ -11410,8 +11788,8 @@ function demoDocument(index) {
   ) : `${index}${DEMO_ROOT}`;
 }
 function withDemoInput(input, key, id, next2) {
-  const record3 = typeof input === "string" ? { [path23.parse(input).name]: input } : Array.isArray(input) ? Object.fromEntries(input.map((item) => [path23.parse(item).name, item])) : { ...input ?? {} };
-  if (Object.values(record3).some((item) => item === id || posix(path23.resolve(item)) === id)) {
+  const record3 = typeof input === "string" ? { [path24.parse(input).name]: input } : Array.isArray(input) ? Object.fromEntries(input.map((item) => [path24.parse(item).name, item])) : { ...input ?? {} };
+  if (Object.values(record3).some((item) => item === id || posix(path24.resolve(item)) === id)) {
     record3[key] = next2;
   }
   return record3;
@@ -11427,15 +11805,15 @@ function withBase(html, base) {
 function createNgDocApplicationPlugin(options) {
   if (!options || typeof options !== "object") throw optionError("options must be an object.");
   const warnings = checkOptionKeys(options);
-  const workspaceRoot = path23.resolve(options.workspaceRoot ?? process.cwd());
-  const browser = path23.resolve(workspaceRoot, text4(options.browser, "browser"));
-  const server = options.server === void 0 ? void 0 : path23.resolve(workspaceRoot, text4(options.server, "server"));
-  const sourceRoot = path23.resolve(workspaceRoot, options.sourceRoot ?? path23.dirname(browser));
+  const workspaceRoot = path24.resolve(options.workspaceRoot ?? process.cwd());
+  const browser = path24.resolve(workspaceRoot, text4(options.browser, "browser"));
+  const server = options.server === void 0 ? void 0 : path24.resolve(workspaceRoot, text4(options.server, "server"));
+  const sourceRoot = path24.resolve(workspaceRoot, options.sourceRoot ?? path24.dirname(browser));
   const polyfills = (options.polyfills ?? []).map(
     (item, index) => specifier(workspaceRoot, text4(item, `polyfills[${index}]`))
   );
   const styles = (options.styles ?? []).map(
-    (item, index) => posix(path23.resolve(workspaceRoot, text4(item, `styles[${index}]`)))
+    (item, index) => posix(path24.resolve(workspaceRoot, text4(item, `styles[${index}]`)))
   );
   const assetPatterns = [...options.assets ?? []];
   const zone = (options.polyfills ?? []).some(
@@ -11444,7 +11822,7 @@ function createNgDocApplicationPlugin(options) {
   let viteRoot = process.cwd();
   let demoApi;
   let demo;
-  const demoPage = () => posix(path23.join(viteRoot, NG_DOC_DEMO_PAGE));
+  const demoPage = () => posix(path24.join(viteRoot, NG_DOC_DEMO_PAGE));
   const currentDemo = async () => config?.command === "build" ? demo : await demoApi?.current().catch(() => void 0);
   let assets;
   const resolvedAssets = () => assets ??= resolveAssets(assetPatterns, workspaceRoot, sourceRoot);
@@ -11453,12 +11831,12 @@ function createNgDocApplicationPlugin(options) {
     include: [
       .../* @__PURE__ */ new Set([
         ...await coreImports(viteRoot2),
-        ...polyfills.filter((item) => !path23.isAbsolute(item)),
+        ...polyfills.filter((item) => !path24.isAbsolute(item)),
         ...resolvable(viteRoot2, "tslib") ? ["tslib"] : []
       ])
     ].sort(),
-    entries: [...polyfills.filter((item) => path23.isAbsolute(item)), posix(browser)].map(
-      (file) => escapePath(posix(path23.relative(viteRoot2, file)))
+    entries: [...polyfills.filter((item) => path24.isAbsolute(item)), posix(browser)].map(
+      (file) => escapePath(posix(path24.relative(viteRoot2, file)))
     )
   });
   const api = Object.freeze({
@@ -11470,7 +11848,7 @@ function createNgDocApplicationPlugin(options) {
     enforce: "pre",
     api: { ngDocApplication: api },
     async config(user, environment) {
-      viteRoot = path23.resolve(user.root ?? process.cwd());
+      viteRoot = path24.resolve(user.root ?? process.cwd());
       return {
         resolve: { dedupe: ANGULAR_DEDUPE },
         // Every `vite build` is a production build of the application (the Angular CLI's
@@ -11509,9 +11887,9 @@ function createNgDocApplicationPlugin(options) {
           NG_DOC_SERVER_ENTRY,
           NG_DOC_DEMO_SERVER_ENTRY
         ) : withDemoInput(
-          input.input ?? path23.join(viteRoot, "index.html"),
+          input.input ?? path24.join(viteRoot, "index.html"),
           "ng-doc-demo",
-          posix(path23.join(viteRoot, "index.html")),
+          posix(path24.join(viteRoot, "index.html")),
           demoPage()
         )
       };
@@ -11520,7 +11898,7 @@ function createNgDocApplicationPlugin(options) {
       if (source === NG_DOC_BROWSER_ENTRY) return BROWSER_ID;
       if (source === NG_DOC_DEMO_ENTRY) return DEMO_ID;
       if (source === NG_DOC_DEMO_SERVER_ENTRY) return DEMO_SERVER_ID;
-      if (config?.command === "build" && demo && posix(path23.resolve(viteRoot, source)) === demoPage()) {
+      if (config?.command === "build" && demo && posix(path24.resolve(viteRoot, source)) === demoPage()) {
         return demoPage();
       }
       if ((importer === BROWSER_ID || importer === DEMO_ID) && config?.command === "build") {
@@ -11539,7 +11917,7 @@ function createNgDocApplicationPlugin(options) {
     },
     load(id) {
       if (config?.command === "build" && demo && id === demoPage()) {
-        const index = path23.join(viteRoot, "index.html");
+        const index = path24.join(viteRoot, "index.html");
         this.addWatchFile(index);
         return readFile8(index, "utf8").then(demoDocument);
       }
@@ -11622,7 +12000,7 @@ function createNgDocApplicationPlugin(options) {
             next2();
             return;
           }
-          const index = await readFile8(path23.join(viteRoot, "index.html"), "utf8");
+          const index = await readFile8(path24.join(viteRoot, "index.html"), "utf8");
           const html = await server2.transformIndexHtml(
             url,
             demoDocument(index),
@@ -11639,11 +12017,11 @@ function createNgDocApplicationPlugin(options) {
     // replaces each copy with the rendered page.
     async writeBundle(output) {
       if (config?.command !== "build" || config.build.ssr || !demo || !output.dir) return;
-      const page = await readFile8(path23.join(output.dir, NG_DOC_DEMO_PAGE), "utf8");
+      const page = await readFile8(path24.join(output.dir, NG_DOC_DEMO_PAGE), "utf8");
       for (const route of [...demo.pages].sort()) {
         if (unsafeSegment(route)) continue;
-        const file = path23.join(output.dir, ...route.split("/"), "index.html");
-        await mkdir2(path23.dirname(file), { recursive: true });
+        const file = path24.join(output.dir, ...route.split("/"), "index.html");
+        await mkdir2(path24.dirname(file), { recursive: true });
         await writeFile2(file, page);
       }
     },
@@ -11794,7 +12172,7 @@ function prerenderNgDoc(options) {
 // libs/builder/generator/vite/production.ts
 import { existsSync as existsSync7 } from "node:fs";
 import { rm as rm2, writeFile as writeFile3 } from "node:fs/promises";
-import path24 from "node:path";
+import path25 from "node:path";
 import { build as viteBuild } from "vite";
 var defaultDependencies = {
   build: viteBuild,
@@ -11831,11 +12209,11 @@ function applicationProbe() {
 async function buildNgDocViteApplication(options, dependencies = defaultDependencies) {
   assertSupportedViteVersion();
   assertConsistentAngularBuild();
-  const configFile = path24.resolve(options.configFile);
-  const outputPath = path24.resolve(options.outputPath);
-  const browser = path24.join(outputPath, "browser");
-  const serverDirectory = path24.join(outputPath, "server");
-  const serverEntry = path24.join(serverDirectory, "server.mjs");
+  const configFile = path25.resolve(options.configFile);
+  const outputPath = path25.resolve(options.outputPath);
+  const browser = path25.join(outputPath, "browser");
+  const serverDirectory = path25.join(outputPath, "server");
+  const serverEntry = path25.join(serverDirectory, "server.mjs");
   const mode = options.mode ?? "production";
   const log = options.log ?? (() => {
   });
@@ -11872,7 +12250,7 @@ async function buildNgDocViteApplication(options, dependencies = defaultDependen
     ssr ??= entry !== void 0;
     if (!ssr) {
       await rm2(serverDirectory, { recursive: true, force: true });
-      await rm2(path24.join(outputPath, "prerendered-routes.json"), { force: true });
+      await rm2(path25.join(outputPath, "prerendered-routes.json"), { force: true });
       if (options.prerender === true) throw noServer();
     } else {
       if (!entry) {
@@ -11907,13 +12285,13 @@ async function buildNgDocViteApplication(options, dependencies = defaultDependen
   }
   const prerender = options.prerender ?? (options.skipBuild ? true : ssr === true);
   if (!prerender) return { browser, ...ssr ? { server: serverEntry } : {} };
-  const demoServerEntry = path24.join(serverDirectory, "demo-server.mjs");
+  const demoServerEntry = path25.join(serverDirectory, "demo-server.mjs");
   const report = await timed(
     "Prerendered the routes",
     () => dependencies.prerender({
       browserDir: browser,
       serverEntry,
-      ...existsSync7(demoServerEntry) && existsSync7(path24.join(browser, "ng-doc-demo.html")) ? { demoServerEntry } : {},
+      ...existsSync7(demoServerEntry) && existsSync7(path25.join(browser, "ng-doc-demo.html")) ? { demoServerEntry } : {},
       routes: options.routes ?? [],
       discoverRoutes: options.discoverRoutes ?? true,
       ...options.routeTimeoutMs === void 0 ? {} : { routeTimeoutMs: options.routeTimeoutMs },
@@ -11921,7 +12299,7 @@ async function buildNgDocViteApplication(options, dependencies = defaultDependen
     })
   );
   await writeFile3(
-    path24.join(outputPath, "prerendered-routes.json"),
+    path25.join(outputPath, "prerendered-routes.json"),
     `${JSON.stringify({ routes: report.routes, excluded: report.excluded }, null, 2)}
 `
   );