@ng-doc/builder 22.0.0 → 22.2.0

package/generator/vite/index.js

@@ -1,5 +1,5 @@
 // libs/builder/generator/vite/plugin.ts
-import path19 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, path24) {
+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 (path24.has(value)) throw new TypeError("Converting circular structure to canonical JSON");
-  path24.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, path24) ?? "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], path24);
+      const item = canonical(value[key], path26);
       if (item !== void 0) fields.push(`${JSON.stringify(key)}:${item}`);
     }
     text5 = `{${fields.join(",")}}`;
   }
-  path24.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(
@@ -1927,23 +1929,31 @@ function isRoute(value) {
       "metadata",
       "category",
       "modulePath",
-      "apiListSegment"
+      "apiListSegment",
+      "demoModulePath",
+      "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.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(
@@ -1967,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;
@@ -2068,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;
@@ -2103,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;
@@ -2126,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)
@@ -2135,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 {
@@ -2169,12 +2179,17 @@ var INCREMENTAL_PROGRAM_FLAG = "NGDOC_INCREMENTAL_PROGRAM";
 var SHAPE_CLOSURE_FLAG = "NGDOC_SHAPE_CLOSURE";
 var ANGULAR_SHARED_PASS_FLAG = "NGDOC_ANGULAR_SHARED_PASS";
 var ANGULAR_STRUCTURAL_PASS_FLAG = "NGDOC_ANGULAR_STRUCTURAL_PASS";
+var ANGULAR_DESCRIPTION_PASS_FLAG = "NGDOC_ANGULAR_DESCRIPTION_PASS";
+var VITE_CONTENT_UPDATE_FLAG = "NGDOC_VITE_CONTENT_UPDATE";
 var VITE_BUILD_HANDOFF_FLAG = "NGDOC_VITE_BUILD_HANDOFF";
+var VITE_MODULELESS_SETTLE_FLAG = "NGDOC_VITE_MODULELESS_SETTLE";
 var TRACKED_PROGRAM_REUSE_FLAG = "NGDOC_TRACKED_PROGRAM_REUSE";
 var FAST_START_FLAG = "NGDOC_FAST_START";
 var PARALLEL_WRITES_FLAG = "NGDOC_PARALLEL_WRITES";
 var HIGHLIGHT_CACHE_FLAG = "NGDOC_HIGHLIGHT_CACHE";
+var FORMAT_CACHE_FLAG = "NGDOC_FORMAT_CACHE";
 var PARALLEL_RENDER_FLAG = "NGDOC_PARALLEL_RENDER";
+var USED_GRAMMARS_FLAG = "NGDOC_USED_GRAMMARS";
 var FLAGS = Object.freeze(
   [
     {
@@ -2242,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.",
@@ -2252,6 +2282,16 @@ var FLAGS = Object.freeze(
       description: "Code blocks are highlighted with one Shiki highlighter per runtime and cached by their text, language, meta, themes and Shiki version; development keeps the cache beside the artifact cache.",
       verify: true
     },
+    {
+      name: FORMAT_CACHE_FLAG,
+      description: "The Prettier configuration is resolved once per generation, and formatted signatures and snippets are cached by their code, parser, configuration and Prettier version; development keeps the cache beside the artifact cache.",
+      verify: true
+    },
+    {
+      name: USED_GRAMMARS_FLAG,
+      description: "Code blocks are highlighted by a highlighter that loads only the Shiki grammars their languages reach, instead of every bundled grammar; the HTML is the same.",
+      verify: false
+    },
     {
       name: PARALLEL_RENDER_FLAG,
       description: "A large generation runs the HTML processing of its pages (highlighting, anchors, keyword links, search records) on up to four worker threads, while the main thread prepares the next pages in order.",
@@ -2333,11 +2373,11 @@ async function changedInputs(inputs, ownedRoots) {
   const refresher = createDependencyRefresher();
   const changes = /* @__PURE__ */ new Map();
   const add = (kind, file) => {
-    const path24 = normalize(file);
-    if (owned(path24, roots)) return;
-    const existing = changes.get(path24);
+    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(path24, { kind, path: path24 });
+      changes.set(path26, { kind, path: path26 });
   };
   for (let offset = 0; offset < inputs.length; offset += CONCURRENCY) {
     await Promise.all(
@@ -2835,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;
@@ -2865,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 });
@@ -2879,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
@@ -2897,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:
@@ -3270,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, path24) => changes.set(path24, 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);
@@ -4911,7 +4951,7 @@ function createCandidateOutputCommitter(options = {}, host = {}) {
 
 // libs/builder/generator/bootstrap/constants.ts
 var GENERATOR_COMPILER_VERSION = "0.0.1";
-var GENERATOR_TOOLCHAIN_DIGEST = "a837a4b43736f6b95b5565f442aa62d2f2175fb549d7a44138d2955d465c9ac3";
+var GENERATOR_TOOLCHAIN_DIGEST = "495b74972f5c2d99ad311bd24b03e2560f77343e401abd7c4d8185e4fee96764";
 
 // libs/builder/generator/bootstrap/index.ts
 var PERSISTENT_WORKER_ENV = PERSISTENT_WORKER_FLAG;
@@ -5062,6 +5102,9 @@ var COMPILER_TYPESCRIPT = /\.[cm]?ts(?![a-z])/;
 var JAVASCRIPT_MODULE = /\.[cm]?jsx?$/;
 var COMPILER_RESOURCE = /\.(?:html?|css|less|sass|scss)$/;
 var HOST_COMPLETION_TIMEOUT_MS = 3e4;
+var HOST_BURST_EVENTS = 1e3;
+var HOST_BURST_WINDOW_MS = 1e3;
+var HOST_BURST_QUIET_MS = 2e3;
 function deferred2(resolved = false) {
   let settled = false;
   let settle = () => {
@@ -5130,9 +5173,17 @@ function observePhysicalVersion(file) {
   }
 }
 var HostUpdateCoordinator = class {
-  constructor(notify, fail) {
+  /**
+   * @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;
+    this.recovery = recovery;
     this.attempts = /* @__PURE__ */ new Map();
     this.pendingSources = /* @__PURE__ */ new Map();
     this.claimedSources = /* @__PURE__ */ new Map();
@@ -5147,6 +5198,15 @@ var HostUpdateCoordinator = class {
     this.hostDrain = deferred2(true);
     this.sequence = 0;
     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);
@@ -5239,6 +5299,7 @@ var HostUpdateCoordinator = class {
     }
     const filePath = normalize3(file);
     const generated = !!this.outputRoot && relativeWithin(this.outputRoot, filePath) !== void 0;
+    if (this.outputRoot && !generated) this.hotUpdate();
     const token = {
       id: ++this.sequence,
       path: filePath,
@@ -5320,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);
@@ -5345,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.
@@ -5386,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") {
@@ -5405,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);
@@ -5419,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();
@@ -5427,8 +5532,11 @@ var HostUpdateCoordinator = class {
   }
   dispose() {
     this.disposed = true;
+    if (this.burst?.timer) clearTimeout(this.burst.timer);
+    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();
@@ -5622,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) {
@@ -5631,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;
@@ -5691,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)) {
@@ -5713,13 +5864,109 @@ var HostUpdateCoordinator = class {
         })
       ]).catch((error2) => {
         const failure3 = error2 instanceof Error ? error2 : new Error(String(error2));
-        this.fail(failure3);
+        this.timedOut(failure3);
         throw failure3;
       });
     } finally {
       if (timeout) clearTimeout(timeout);
     }
   }
+  /** Counts a hot update towards a burst of file events (see the class description). */
+  hotUpdate() {
+    const now = Date.now();
+    if (this.burst) {
+      this.burst.last = now;
+      this.burst.events = true;
+      return;
+    }
+    if (now - this.window.start >= HOST_BURST_WINDOW_MS) this.window = { start: now, events: 0 };
+    if (++this.window.events >= HOST_BURST_EVENTS) this.openBurst(now).events = true;
+  }
+  /**
+   * A host update did not settle in time. The first of a burst is reported as it happens (as
+   * every timeout was before); the others only count towards the burst's summary, so a flood of
+   * file events logs two lines instead of one per event.
+   * @param failure The timeout, thrown to its waiter as well.
+   */
+  timedOut(failure3) {
+    const burst = this.burst ?? this.openBurst(Date.now());
+    burst.last = Date.now();
+    if (burst.timeouts++ === 0) this.fail(failure3);
+  }
+  openBurst(now) {
+    const burst = { events: false, timeouts: 0, last: now };
+    this.burst = burst;
+    this.armBurst(burst, HOST_BURST_QUIET_MS);
+    return burst;
+  }
+  /**
+   * One timer per burst, re-armed for the rest of the quiet period when activity moved `last`.
+   * @param burst The open burst.
+   * @param delay When to check it next.
+   */
+  armBurst(burst, delay) {
+    burst.timer = setTimeout(() => {
+      if (this.burst !== burst || this.disposed) return;
+      const quiet = Date.now() - burst.last;
+      if (quiet < HOST_BURST_QUIET_MS) {
+        this.armBurst(burst, HOST_BURST_QUIET_MS - quiet);
+        return;
+      }
+      this.burst = void 0;
+      this.window = { start: 0, events: 0 };
+      void this.recover(burst);
+    }, delay);
+    burst.timer.unref?.();
+  }
+  /**
+   * The pass after a burst: the summary of its held-back timeouts, then every open output
+   * obligation whose file is still what its generation wrote is reported again, in path order,
+   * and every recorded input is re-observed once no generation is in flight. An output a newer generation rewrote since is left
+   * to that generation's own report, which supersedes the older expectation.
+   * @param burst The burst that ended.
+   */
+  async recover(burst) {
+    if (burst.timeouts > 1) {
+      this.recovery?.warn(
+        `[NGDOC_VITE_HOST_TIMEOUT] ${burst.timeouts - 1} more host update(s) did not settle within ${HOST_COMPLETION_TIMEOUT_MS / 1e3} s while files kept changing. NgDoc checks the generated files and the documentation inputs again.`
+      );
+    }
+    const open2 = /* @__PURE__ */ new Map();
+    for (const attempt of [...this.attempts.values()].sort(
+      (left, right) => right.generation - left.generation
+    )) {
+      if (!attempt.resultSeen) continue;
+      for (const expected of attempt.expected.values()) {
+        if (!expected.completed && !open2.has(expected.path)) open2.set(expected.path, expected);
+      }
+    }
+    for (const [file, expected] of [...open2].sort(([left], [right]) => left < right ? -1 : 1)) {
+      let current;
+      let written;
+      try {
+        [current, written] = await Promise.all([observePhysicalState(file), expected.state]);
+      } catch {
+        continue;
+      }
+      if (this.disposed) return;
+      const unchanged = expected.digest === void 0 ? current.version === "missing" : current.digest === expected.digest && current.version === written.version;
+      if (expected.completed || !unchanged) continue;
+      try {
+        this.recovery?.replay(
+          file,
+          expected.kind === "update" ? "update" : expected.digest === void 0 ? "delete" : "create"
+        );
+      } catch {
+      }
+    }
+    for (let latest = this.latestAttempt; latest && !latest.resultSeen && !this.disposed; latest = this.latestAttempt)
+      await latest.result.promise;
+    if (this.disposed) return;
+    try {
+      this.recovery?.rescan();
+    } catch {
+    }
+  }
 };
 
 // libs/builder/generator/vite/angular-composition.ts
@@ -5746,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 }),
@@ -5831,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;
@@ -5899,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 () => {
@@ -6038,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;
@@ -6078,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(
@@ -6335,6 +6641,115 @@ 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 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 = 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]);
+  return demoPath && pages2 ? { module, path: demoPath, pages: pages2 } : void 0;
+}
+function demoPages(json) {
+  try {
+    const value = json === void 0 ? void 0 : JSON.parse(json);
+    return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : void 0;
+  } catch {
+    return void 0;
+  }
+}
+
 // libs/builder/generator/vite/diagnostics.ts
 function diagnosticText(diagnostic4) {
   const source = diagnostic4.source ? ` (${diagnostic4.source.path}${diagnostic4.source.line ? `:${diagnostic4.source.line}` : ""})` : "";
@@ -6350,7 +6765,7 @@ function hostDiagnostic(code, message4) {
 }
 
 // libs/builder/generator/vite/lease.ts
-import path11 from "node:path";
+import path13 from "node:path";
 var identities = /* @__PURE__ */ new Map();
 var outputRoots = /* @__PURE__ */ new Map();
 function acquireOutputLease(identity2, defaultOutputRoot) {
@@ -6358,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(path11.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}.`
@@ -6372,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(path11.resolve(value).replace(/\\/g, "/"));
+      const normalized = canonicalDrive(path13.resolve(value).replace(/\\/g, "/"));
       const owner = outputRoots.get(normalized);
       if (owner && owner !== token) {
         throw new Error(
@@ -6403,11 +6818,11 @@ function acquireOutputLease(identity2, defaultOutputRoot) {
 
 // libs/builder/generator/vite/lifecycle.ts
 import { existsSync as existsSync5 } from "node:fs";
-import path16 from "node:path";
+import path18 from "node:path";
 
 // libs/builder/generator/vite/assets.ts
-import { readFile as readFile5 } from "node:fs/promises";
-import path12 from "node:path";
+import { readFile as readFile6 } from "node:fs/promises";
+import path14 from "node:path";
 var GENERATED_ASSET_PATH = "assets/ng-doc";
 var MIME = /* @__PURE__ */ new Map([
   [".css", "text/css; charset=utf-8"],
@@ -6429,7 +6844,7 @@ function normalizedBase(base) {
   return value.endsWith("/") ? value : `${value}/`;
 }
 function safeRelative2(value) {
-  return !!value && !value.includes("\0") && !value.includes("\\") && !path12.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(/\/$/, "")}/`;
@@ -6446,7 +6861,7 @@ function inventory(configuration, manifest) {
       throw new Error(`[NGDOC_VITE_ASSET_COLLISION] Duplicate generated asset: ${relative}.`);
     }
     result.set(relative, {
-      file: path12.join(configuration.outputRoot, output),
+      file: path14.join(configuration.outputRoot, output),
       outputName: outputName2
     });
   }
@@ -6485,12 +6900,12 @@ var GeneratedAssetInventory = class {
         next2();
         return;
       }
-      void readFile5(asset.file).then(
+      void readFile6(asset.file).then(
         (source) => {
           response.statusCode = 200;
           response.setHeader(
             "Content-Type",
-            MIME.get(path12.extname(relative).toLowerCase()) ?? "application/octet-stream"
+            MIME.get(path14.extname(relative).toLowerCase()) ?? "application/octet-stream"
           );
           response.end(source);
         },
@@ -6513,7 +6928,7 @@ var GeneratedAssetInventory = class {
       context.emitFile({
         type: "asset",
         fileName: asset.outputName,
-        source: await readFile5(asset.file)
+        source: await readFile6(asset.file)
       });
     }
   }
@@ -6524,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 path15 from "node:path";
+import path17 from "node:path";
 
 // libs/builder/generator/vite/external-probes.ts
 import { statSync as statSync5 } from "node:fs";
@@ -6605,7 +7020,7 @@ var ExternalProbeWatcher = class {
 
 // libs/builder/generator/vite/missing-paths.ts
 import { existsSync as existsSync3, watch as watchDirectory } from "node:fs";
-import path13 from "node:path";
+import path15 from "node:path";
 var MAX_MISSING_PATH_DIRECTORIES = 1024;
 var defaultWatch = (directory, listener) => watchDirectory(
   directory,
@@ -6613,9 +7028,9 @@ var defaultWatch = (directory, listener) => watchDirectory(
   (event, name) => listener(event, typeof name === "string" ? name : null)
 );
 function anchorOf(target) {
-  let cursor = path13.dirname(target);
+  let cursor = path15.dirname(target);
   while (!existsSync3(cursor)) {
-    const parent = path13.dirname(cursor);
+    const parent = path15.dirname(cursor);
     if (parent === cursor) break;
     cursor = parent;
   }
@@ -6702,7 +7117,7 @@ var MissingPathWatcher = class {
     const members2 = [...this.members.get(anchor) ?? []];
     const gone = !existsSync3(anchor);
     for (const target of members2) {
-      const entry = path13.relative(anchor, target).split(path13.sep)[0];
+      const entry = path15.relative(anchor, target).split(path15.sep)[0];
       if (!gone && name !== null && name !== entry) continue;
       this.refresh(target);
     }
@@ -6725,9 +7140,9 @@ var MissingPathWatcher = class {
 // libs/builder/generator/vite/watch-inputs.ts
 import { Minimatch } from "minimatch";
 import { access } from "node:fs/promises";
-import path14 from "node:path";
+import path16 from "node:path";
 function normalize4(value) {
-  return path14.resolve(value).replace(/\\/g, "/");
+  return path16.resolve(value).replace(/\\/g, "/");
 }
 function union(left, right) {
   const files = new Set([...left?.files ?? [], ...right?.files ?? []].map(normalize4));
@@ -6749,14 +7164,14 @@ function inputKey(inputs) {
   return JSON.stringify(inputs);
 }
 function absolutePattern(root, pattern) {
-  return normalize4(path14.isAbsolute(pattern) ? pattern : path14.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 path14.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) : path14.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);
@@ -6765,7 +7180,7 @@ async function nearestExisting(value) {
       await access(cursor);
       return cursor;
     } catch {
-      const parent = path14.dirname(cursor).replace(/\\/g, "/");
+      const parent = path16.dirname(cursor).replace(/\\/g, "/");
       if (parent === cursor) return cursor;
       cursor = parent;
     }
@@ -6775,16 +7190,16 @@ function ancestorOf(target, candidate) {
   return target === candidate || target.startsWith(`${candidate}/`);
 }
 function globPattern(pattern) {
-  return path14.sep === "\\" ? pattern.replace(/\\/g, "/") : pattern;
+  return path16.sep === "\\" ? pattern.replace(/\\/g, "/") : pattern;
 }
 function compilePattern(pattern) {
   return {
-    absolute: path14.isAbsolute(pattern),
+    absolute: path16.isAbsolute(pattern),
     matcher: new Minimatch(globPattern(pattern), { dot: true })
   };
 }
 function patternMatches(glob2, pattern, changed) {
-  const subject = pattern.absolute ? changed : path14.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) {
@@ -6871,7 +7286,7 @@ var WatchInputRegistry = class {
     const directories = /* @__PURE__ */ new Set();
     for (const target of globBases) {
       const existing = await nearestExisting(target);
-      if (existing === path14.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}.`
         );
@@ -6882,7 +7297,7 @@ var WatchInputRegistry = class {
       }
     }
     for (const target of desired) {
-      if (target === path14.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}.`
         );
@@ -6941,7 +7356,7 @@ var WatchInputRegistry = class {
 
 // libs/builder/generator/vite/vite-event-source.ts
 function normalize5(value) {
-  return canonicalDrive(path15.resolve(value).replace(/\\/g, "/"));
+  return canonicalDrive(path17.resolve(value).replace(/\\/g, "/"));
 }
 function within2(target, root) {
   return target === root || target.startsWith(`${root}/`);
@@ -6962,12 +7377,12 @@ function statVersion(file) {
   }
 }
 function listed(watched, target) {
-  return watched.has(target) || (watched.get(path15.dirname(target))?.includes(path15.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 = path15.dirname(cursor);
+    const parent = path17.dirname(cursor);
     if (parent === cursor) return cursor;
     cursor = parent;
   }
@@ -6992,7 +7407,7 @@ function workspaceRoots(root) {
     roots.add(normalize5(realpathSync2.native(root)));
   } catch {
   }
-  return [...roots].filter((value) => value !== normalize5(path15.parse(value).root));
+  return [...roots].filter((value) => value !== normalize5(path17.parse(value).root));
 }
 function watchesMissingPaths(watcher) {
   const options = watcher.options;
@@ -7444,9 +7859,38 @@ 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" }),
-      (error2) => this.fail(error2)
+      (changes) => this.announce(changes),
+      (error2) => this.fail(error2),
+      {
+        warn: (message4) => this.warn(message4),
+        // Exactly the event Vite's watcher emits for the file: Vite invalidates its modules and
+        // runs the hot update hooks, which the coordinator matches like the lost report.
+        replay: (file, type) => {
+          if (this.disposed) return;
+          this.server?.watcher.emit(
+            type === "create" ? "add" : type === "delete" ? "unlink" : "change",
+            file
+          );
+        },
+        rescan: () => {
+          if (this.disposed) return;
+          void this.session?.rescan().catch(() => {
+          });
+        }
+      }
     );
   }
   get failure() {
@@ -7458,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;
@@ -7511,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(path16.basename(dependency.path)))
-            read.add(canonicalDrive(path16.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(path16.resolve(file)));
+    return committed.read.has(canonicalDrive(path18.resolve(file)));
   }
   hostUpdateStarted(file, type, read) {
     const change = { kind: type, path: file };
@@ -7526,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);
@@ -7562,7 +8058,7 @@ var ViteAdapterLifecycle = class {
   hostClaimsFilesystemChange(file) {
     if (this.disposed) return false;
     if (this.hostUpdates.generated(file)) return true;
-    if (!DESCRIPTION_MODULE.test(path16.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));
   }
@@ -7580,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);
@@ -7717,6 +8218,14 @@ var ViteAdapterLifecycle = class {
     } catch {
     }
   }
+  warn(message4) {
+    if (!this.server) return;
+    this.interrupt();
+    try {
+      this.server.config.logger.warn(message4);
+    } catch {
+    }
+  }
   isCurrent(generation) {
     return !this.disposed && generation >= this.latestStarted && (!this.source || this.source.isCurrent(generation));
   }
@@ -7742,6 +8251,7 @@ var ViteAdapterLifecycle = class {
   }
   async disposeAll() {
     this.hostUpdates.dispose();
+    this.stopContentClients();
     const results = await Promise.allSettled([
       this.registration,
       this.watch?.dispose(),
@@ -7758,7 +8268,7 @@ var ViteAdapterLifecycle = class {
 var NG_DOC_SYNTAX_THEME_NAME = "css-variables";
 
 // libs/builder/generator/vite/options.ts
-import path17 from "node:path";
+import path19 from "node:path";
 
 // libs/builder/generator/progress/settings.ts
 var PROGRESS_SETTINGS = Object.freeze([
@@ -7877,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,
@@ -7887,6 +8412,16 @@ var ENGINE_SWITCHES = Object.freeze([
     values: /^(0|false|off|no|verify)$/i,
     effect: "every code block is highlighted again"
   },
+  {
+    name: "NGDOC_FORMAT_CACHE",
+    values: /^(0|false|off|no|verify)$/i,
+    effect: "every signature and snippet is formatted again"
+  },
+  {
+    name: "NGDOC_USED_GRAMMARS",
+    values: /^(0|false|off|no)$/i,
+    effect: "every Shiki grammar is loaded before code is highlighted"
+  },
   {
     name: "NGDOC_PARALLEL_RENDER",
     values: /^(0|false|off|no|verify)$/i,
@@ -7942,7 +8477,7 @@ function resolveOptions(options) {
     );
   }
   const angularComponentProbe = text2(options.angularComponentProbe, "angularComponentProbe");
-  if (!path17.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."
     );
@@ -7961,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 = path17.resolve(text2(options.generator.workspaceRoot, "workspaceRoot"));
-  const defaultRoot = path17.resolve(
+  const workspace = path19.resolve(text2(options.generator.workspaceRoot, "workspaceRoot"));
+  const defaultRoot = path19.resolve(
     text2(options.generator.defaults.outputRoot, "defaults.outputRoot")
   );
   return {
@@ -7972,7 +8507,7 @@ function resolveOptions(options) {
     themeModules,
     leaseIdentity: `${text2(options.generator.projectId, "projectId")}\0${workspace}\0${defaultRoot}`,
     angularPlugins: [...options.angularPlugins],
-    angularComponentProbe: path17.normalize(angularComponentProbe),
+    angularComponentProbe: path19.normalize(angularComponentProbe),
     ...options.progress ? { progress: options.progress } : {}
   };
 }
@@ -7989,14 +8524,14 @@ function themeImports(options, configuration) {
   ].sort();
 }
 function within3(root, file) {
-  const relative = path17.relative(root, file);
-  return relative === "" || !relative.startsWith("..") && !path17.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" && path17.isAbsolute(cacheRoot) ? canonicalDrive(path17.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() {
@@ -8010,11 +8545,11 @@ var CacheRootWatchIgnore = class {
       workspaceRoot,
       defaults.outputRoot,
       defaults.docsRoot,
-      typeof defaults.tsConfig === "string" ? path17.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, path17.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) {
@@ -8027,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(path17.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;
@@ -8035,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, path17.resolve(value)))) {
+    roots.some((value) => typeof value !== "string" || !value) || roots.some((value) => within3(cacheRoot, path19.resolve(value)))) {
       this.active = false;
     }
     return this.active;
@@ -8043,26 +8578,26 @@ var CacheRootWatchIgnore = class {
 };
 function metadataWatchIgnore(options, viteRoot) {
   const { workspaceRoot, defaults } = options.generator;
-  if (typeof workspaceRoot !== "string" || !path17.isAbsolute(workspaceRoot)) return void 0;
-  const idea = path17.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" ? path17.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, path17.resolve(value))
+    (value) => typeof value === "string" && value && within3(idea, path19.resolve(value))
   );
   return (file) => {
     if (typeof file !== "string") return false;
-    const target = path17.resolve(file);
-    return path17.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(path17.resolve(viteRoot));
-  const metadataIgnore = metadataWatchIgnore(options, path17.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);
@@ -8098,10 +8633,10 @@ function assertThemeModules(options, configuration) {
 
 // libs/builder/generator/vite/output-watch.ts
 import { realpathSync as realpathSync3 } from "node:fs";
-import path18 from "node:path";
+import path20 from "node:path";
 var OUTPUT_WATCH_ATTACH_TIMEOUT_MS = 1e4;
 function normalize6(value) {
-  return canonicalDrive(path18.resolve(value).replace(/\\/g, "/"));
+  return canonicalDrive(path20.resolve(value).replace(/\\/g, "/"));
 }
 function within4(target, root) {
   return target === root || target.startsWith(`${root}/`);
@@ -8133,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 = path18.posix.dirname(target);
+      const parent = path20.posix.dirname(target);
       const listed2 = entries.get(parent) ?? /* @__PURE__ */ new Set();
-      listed2.add(path18.posix.basename(target));
+      listed2.add(path20.posix.basename(target));
       entries.set(parent, listed2);
       target = parent;
     }
@@ -9551,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((path24) => typeof path24 === "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)
@@ -10367,10 +10902,10 @@ function getNgDocViteSsrRenderer(plugins, options) {
 }
 
 // libs/builder/generator/vite/theme-index.ts
-import { readFile as readFile6 } from "node:fs/promises";
+import { readFile as readFile7 } from "node:fs/promises";
 var MARKER = "data-ng-doc-theme-restore";
 async function createThemeIndexTransformer(scriptUrl = new URL("./restore-theme.js", import.meta.url)) {
-  const source = await readFile6(scriptUrl, "utf8");
+  const source = await readFile7(scriptUrl, "utf8");
   const tag = `<script ${MARKER}>${source}</script>`;
   return async (content) => {
     if (content.includes(MARKER)) return content;
@@ -10610,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;
       },
@@ -10627,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);
@@ -10642,6 +11186,20 @@ function createPlugin(options) {
       ngDocSsrRenderer: Object.freeze({
         schemaVersion: 1,
         select: (entry) => ssrRenderer.select(entry)
+      }),
+      ngDocDemoApplication: Object.freeze({
+        schemaVersion: 1,
+        // A build decides its inputs before it starts, so the application plugin asks for the
+        // generation early (its `options` hook); `buildStart` then finds it initialized.
+        async resolve() {
+          if (vite?.command === "build") await initializeBuild();
+          const state = active ?? await initialized;
+          return state ? readDemoApplication(state.configuration.outputRoot) : void 0;
+        },
+        async current() {
+          const configuration = active?.lifecycle.configuration ?? active?.configuration;
+          return configuration ? readDemoApplication(configuration.outputRoot) : void 0;
+        }
       })
     },
     enforce: "pre",
@@ -10663,7 +11221,7 @@ function createPlugin(options) {
           "[NGDOC_VITE_BUILD_WATCH] Vite build watch is unsupported; use the development server."
         );
       }
-      return staticViteConfig(resolved, path19.resolve(config.root ?? process.cwd()), cacheWatch);
+      return staticViteConfig(resolved, path21.resolve(config.root ?? process.cwd()), cacheWatch);
     },
     configResolved(config) {
       vite = config;
@@ -10794,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);
     },
@@ -10822,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();
@@ -10844,13 +11412,13 @@ function createPlugin(options) {
 // libs/builder/generator/vite/application.ts
 import { minimatch as minimatch2 } from "minimatch";
 import { existsSync as existsSync6 } from "node:fs";
-import { readdir, readFile as readFile7, stat as stat5 } from "node:fs/promises";
+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 path22 from "node:path";
+import path24 from "node:path";
 import { escapePath, glob } from "tinyglobby";
 
 // libs/builder/generator/vite/dev-styles.ts
-import path20 from "node:path";
+import path22 from "node:path";
 var GATE_TIMINGS = { sheet: 5e3, quiet: 1500, limit: 1e4 };
 function ngDocDevStyleGate(timings = GATE_TIMINGS) {
   return `(() => {
@@ -10909,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 = path20.relative(root, style);
-    const url = relative && !relative.startsWith("..") && !path20.isAbsolute(relative) ? `/${relative.split(path20.sep).join("/")}` : `/@fs/${style.split(path20.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;
@@ -10942,7 +11510,7 @@ function cssModuleSheet(code) {
 }
 
 // libs/builder/generator/vite/mime.ts
-import path21 from "node:path";
+import path23 from "node:path";
 var TYPES = {
   ".aac": "audio/aac",
   ".apng": "image/apng",
@@ -10992,14 +11560,21 @@ var TYPES = {
   ".zip": "application/zip"
 };
 function contentType(file) {
-  return TYPES[path21.extname(file).toLowerCase()] ?? "application/octet-stream";
+  return TYPES[path23.extname(file).toLowerCase()] ?? "application/octet-stream";
 }
 
 // libs/builder/generator/vite/application.ts
 var NG_DOC_BROWSER_ENTRY = "/@ng-doc-application/browser.js";
 var NG_DOC_SERVER_ENTRY = "/@ng-doc-application/server.js";
+var NG_DOC_DEMO_ENTRY = "/@ng-doc-application/demo.js";
+var NG_DOC_DEMO_SERVER_ENTRY = "/@ng-doc-application/demo-server.js";
+var NG_DOC_DEMO_PAGE = "ng-doc-demo.html";
+var NG_DOC_DEMO_SERVER_NAME = "demo-server";
 var BROWSER_ID = "\0ng-doc-application:browser";
 var SERVER_ID = "\0ng-doc-application:server";
+var DEMO_ID = "\0ng-doc-application:demo";
+var DEMO_SERVER_ID = "\0ng-doc-application:demo-server";
+var DEMO_ROOT = "<ng-doc-demo-app></ng-doc-demo-app>";
 var ANGULAR_DEDUPE = [
   "@angular/common",
   "@angular/compiler",
@@ -11091,23 +11666,23 @@ function posix(value) {
   return value.replace(/\\/g, "/");
 }
 function specifier(workspaceRoot, value) {
-  const file = path22.resolve(workspaceRoot, value);
-  return value.startsWith(".") || path22.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 = path22.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 ? path22.dirname(input) : input;
-      const relative = path22.relative(sourceRoot, directory);
-      if (relative.startsWith("..") || path22.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.`
         );
@@ -11115,18 +11690,18 @@ async function resolveAssets(assets, workspaceRoot, sourceRoot) {
       resolved.push({
         input: directory,
         output: posix(relative),
-        glob: file ? path22.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("..") || path22.isAbsolute(output)) {
+    if (output.split("/").includes("..") || path24.isAbsolute(output)) {
       throw optionError(`assets[${index}].output must stay inside the output directory.`);
     }
     resolved.push({
-      input: path22.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 ?? []]
@@ -11148,7 +11723,7 @@ async function collectAssets(assets) {
       expandDirectories: false
     });
     for (const relative of matches.map(posix).sort()) {
-      files.set(outputName(asset, relative), path22.join(asset.input, relative));
+      files.set(outputName(asset, relative), path24.join(asset.input, relative));
     }
   }
   return files;
@@ -11168,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: path22.join(asset.input, relative), relative });
+      candidates.push({ file: path24.join(asset.input, relative), relative });
     }
   }
   return candidates;
 }
 function resolvable(root, name) {
   try {
-    createRequire2(path22.join(root, "package.json")).resolve(`${name}/package.json`);
+    createRequire2(path24.join(root, "package.json")).resolve(`${name}/package.json`);
     return true;
   } catch {
     return false;
@@ -11183,17 +11758,17 @@ function resolvable(root, name) {
 }
 async function coreImports(root) {
   const found = /* @__PURE__ */ new Set();
-  const require2 = createRequire2(path22.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 = path22.join(path22.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 readFile7(path22.join(directory, file), "utf8")).matchAll(
+      for (const match of (await readFile8(path24.join(directory, file), "utf8")).matchAll(
         CORE_IMPORT
       )) {
         found.add(match[1]);
@@ -11205,6 +11780,20 @@ async function coreImports(root) {
 function escapeAttribute(value) {
   return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 }
+function demoDocument(index) {
+  const body = /<body(\s[^>]*)?>[\s\S]*<\/body>/i;
+  return body.test(index) ? index.replace(
+    body,
+    (_all, attributes) => `<body${attributes ?? ""}>${DEMO_ROOT}</body>`
+  ) : `${index}${DEMO_ROOT}`;
+}
+function withDemoInput(input, key, id, next2) {
+  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;
+}
 function withBase(html, base) {
   if (!base.startsWith("/")) return html;
   const href = escapeAttribute(base);
@@ -11216,30 +11805,38 @@ 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 = path22.resolve(options.workspaceRoot ?? process.cwd());
-  const browser = path22.resolve(workspaceRoot, text4(options.browser, "browser"));
-  const server = options.server === void 0 ? void 0 : path22.resolve(workspaceRoot, text4(options.server, "server"));
-  const sourceRoot = path22.resolve(workspaceRoot, options.sourceRoot ?? path22.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(path22.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(
+    (item) => item === "zone.js" || item.startsWith("zone.js/")
+  );
+  let viteRoot = process.cwd();
+  let demoApi;
+  let demo;
+  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);
   let config;
-  const developmentPrebundles = async (viteRoot) => ({
+  const developmentPrebundles = async (viteRoot2) => ({
     include: [
       .../* @__PURE__ */ new Set([
-        ...await coreImports(viteRoot),
-        ...polyfills.filter((item) => !path22.isAbsolute(item)),
-        ...resolvable(viteRoot, "tslib") ? ["tslib"] : []
+        ...await coreImports(viteRoot2),
+        ...polyfills.filter((item) => !path24.isAbsolute(item)),
+        ...resolvable(viteRoot2, "tslib") ? ["tslib"] : []
       ])
     ].sort(),
-    entries: [...polyfills.filter((item) => path22.isAbsolute(item)), posix(browser)].map(
-      (file) => escapePath(posix(path22.relative(viteRoot, file)))
+    entries: [...polyfills.filter((item) => path24.isAbsolute(item)), posix(browser)].map(
+      (file) => escapePath(posix(path24.relative(viteRoot2, file)))
     )
   });
   const api = Object.freeze({
@@ -11251,6 +11848,7 @@ function createNgDocApplicationPlugin(options) {
     enforce: "pre",
     api: { ngDocApplication: api },
     async config(user, environment) {
+      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
@@ -11260,7 +11858,7 @@ function createNgDocApplicationPlugin(options) {
             ["ngDevMode", "ngJitMode"].filter((name) => !(user.define && name in user.define)).map((name) => [name, "false"])
           )
         } : {},
-        ...environment.command === "serve" ? { optimizeDeps: await developmentPrebundles(path22.resolve(user.root ?? process.cwd())) } : {},
+        ...environment.command === "serve" ? { optimizeDeps: await developmentPrebundles(viteRoot) } : {},
         // The server bundle is imported by a plain Node process: it must hold every dependency,
         // partially compiled Angular libraries included.
         ...environment.command === "build" && environment.isSsrBuild ? { ssr: { noExternal: true } } : {}
@@ -11268,11 +11866,42 @@ function createNgDocApplicationPlugin(options) {
     },
     configResolved(resolved) {
       config = resolved;
+      viteRoot = resolved.root ?? viteRoot;
+      const apis = (resolved.plugins ?? []).map((plugin) => plugin.api?.ngDocDemoApplication).filter((api2) => api2?.schemaVersion === 1);
+      demoApi = apis.length === 1 ? apis[0] : void 0;
       for (const warning of warnings) resolved.logger.warn(warning);
     },
+    // A build with demo pages builds the demo application too: its page is a second input of the
+    // browser build and its server entry a second input of the server build. Whether there are
+    // demo pages is known once NgDoc has generated, so the NgDoc plugin generates here, before
+    // the build starts, instead of in its `buildStart`.
+    async options(input) {
+      if (config?.command !== "build" || !demoApi) return null;
+      demo = await demoApi.resolve();
+      if (!demo) return null;
+      return {
+        ...input,
+        input: config.build.ssr ? withDemoInput(
+          input.input,
+          NG_DOC_DEMO_SERVER_NAME,
+          NG_DOC_SERVER_ENTRY,
+          NG_DOC_DEMO_SERVER_ENTRY
+        ) : withDemoInput(
+          input.input ?? path24.join(viteRoot, "index.html"),
+          "ng-doc-demo",
+          posix(path24.join(viteRoot, "index.html")),
+          demoPage()
+        )
+      };
+    },
     resolveId(source, importer, resolveOptions2) {
       if (source === NG_DOC_BROWSER_ENTRY) return BROWSER_ID;
-      if (importer === BROWSER_ID && config?.command === "build") {
+      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(path24.resolve(viteRoot, source)) === demoPage()) {
+        return demoPage();
+      }
+      if ((importer === BROWSER_ID || importer === DEMO_ID) && config?.command === "build") {
         const { isEntry, custom } = resolveOptions2;
         return this.resolve(source, importer, { isEntry, custom, skipSelf: true }).then(
           (resolved) => resolved && !resolved.external ? { ...resolved, moduleSideEffects: true } : resolved
@@ -11287,6 +11916,25 @@ function createNgDocApplicationPlugin(options) {
       return SERVER_ID;
     },
     load(id) {
+      if (config?.command === "build" && demo && id === demoPage()) {
+        const index = path24.join(viteRoot, "index.html");
+        this.addWatchFile(index);
+        return readFile8(index, "utf8").then(demoDocument);
+      }
+      if (id === DEMO_ID || id === DEMO_SERVER_ID) {
+        return currentDemo().then((current) => {
+          if (!current) {
+            throw new Error(
+              "[NGDOC_VITE_DEMO_APPLICATION] The demo application was requested, but NgDoc generated no demo pages."
+            );
+          }
+          return demoEntry(id === DEMO_SERVER_ID ? "server" : "browser", current.module, {
+            polyfills: id === DEMO_SERVER_ID ? serverPolyfills(options.polyfills ?? []) : polyfills,
+            styles: id === DEMO_SERVER_ID ? [] : styles,
+            zone
+          });
+        });
+      }
       if (id === BROWSER_ID) {
         return [...polyfills, ...styles, posix(browser)].map((item) => `import ${JSON.stringify(item)};`).join("\n");
       }
@@ -11318,6 +11966,7 @@ function createNgDocApplicationPlugin(options) {
     transformIndexHtml: {
       order: "pre",
       async handler(html, context) {
+        const demoPageHtml = html.includes(DEMO_ROOT);
         return {
           html: withBase(html, config?.base ?? "/"),
           tags: [
@@ -11326,7 +11975,10 @@ function createNgDocApplicationPlugin(options) {
             ...context.server ? await ngDocDevStyleTags(context.server, styles) : [],
             {
               tag: "script",
-              attrs: { type: "module", src: NG_DOC_BROWSER_ENTRY },
+              attrs: {
+                type: "module",
+                src: demoPageHtml ? NG_DOC_DEMO_ENTRY : NG_DOC_BROWSER_ENTRY
+              },
               injectTo: "body"
             }
           ]
@@ -11335,6 +11987,43 @@ function createNgDocApplicationPlugin(options) {
     },
     configureServer(server2) {
       server2.middlewares.use(assetMiddleware(resolvedAssets, () => server2.config.base));
+      server2.middlewares.use((request, response, next2) => {
+        const accept = request.headers.accept;
+        const url = request.url ?? "/";
+        if (request.method !== "GET" || !(Array.isArray(accept) ? accept.join(",") : accept ?? "").includes("text/html")) {
+          next2();
+          return;
+        }
+        void currentDemo().then(async (current) => {
+          const prefix = `${server2.config.base.replace(/\/?$/, "/")}${current?.path}/`;
+          if (!current || !url.split(/[?#]/, 1)[0].startsWith(prefix)) {
+            next2();
+            return;
+          }
+          const index = await readFile8(path24.join(viteRoot, "index.html"), "utf8");
+          const html = await server2.transformIndexHtml(
+            url,
+            demoDocument(index),
+            request.originalUrl
+          );
+          response.statusCode = 200;
+          response.setHeader("Content-Type", "text/html");
+          response.end(html);
+        }).catch((error2) => next2(error2));
+      });
+    },
+    // Every demo page is a copy of the demo application's page, so a static host without a
+    // fallback serves it, as with hash URLs (which are built without prerendering). Prerendering
+    // 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(path24.join(output.dir, NG_DOC_DEMO_PAGE), "utf8");
+      for (const route of [...demo.pages].sort()) {
+        if (unsafeSegment(route)) continue;
+        const file = path24.join(output.dir, ...route.split("/"), "index.html");
+        await mkdir2(path24.dirname(file), { recursive: true });
+        await writeFile2(file, page);
+      }
     },
     async generateBundle(_output, bundle) {
       if (config?.command !== "build" || config.build.ssr) return;
@@ -11344,7 +12033,7 @@ function createNgDocApplicationPlugin(options) {
         if (bundle[fileName]) {
           throw new Error(`[NGDOC_VITE_ASSET_COLLISION] Vite bundle already owns ${fileName}.`);
         }
-        this.emitFile({ type: "asset", fileName, source: await readFile7(file) });
+        this.emitFile({ type: "asset", fileName, source: await readFile8(file) });
       }
     }
   };
@@ -11354,7 +12043,7 @@ function assetMiddleware(assets, base) {
     void assets().then(
       async (resolved) => {
         for (const match of matchAssets(resolved, base(), request.url ?? "/")) {
-          const source = await readFile7(match.file).catch(() => void 0);
+          const source = await readFile8(match.file).catch(() => void 0);
           if (!source) continue;
           response.statusCode = 200;
           response.setHeader("Content-Type", contentType(match.relative));
@@ -11367,6 +12056,50 @@ function assetMiddleware(assets, base) {
     );
   };
 }
+function demoEntry(platform, module, options) {
+  const imports = [...options.polyfills, ...options.styles].map(
+    (item) => `import ${JSON.stringify(item)};`
+  );
+  const application = [
+    `import { bootstrapApplication } from '@angular/platform-browser';`,
+    `import { NgDocDemoAppComponent, \u0275ngDocDemoApplicationConfig } from '@ng-doc/app/demo-app';`,
+    `import { NG_DOC_DEMO_PROVIDERS, NG_DOC_DEMO_ROUTES } from ${JSON.stringify(posix(module))};`
+  ];
+  if (platform === "browser") {
+    return [
+      ...imports,
+      ...application,
+      // A page the server rendered carries the serialized state (`<script id="ng-state">`, the
+      // default APP_ID); the other pages (the copies of the demo page, the development server's)
+      // start without hydration, as Angular warns (NG0505) when it finds no state.
+      `\u0275ngDocDemoApplicationConfig(NG_DOC_DEMO_ROUTES, NG_DOC_DEMO_PROVIDERS, {`,
+      `  zone: ${options.zone},`,
+      `  hydration: document.getElementById('ng-state') !== null,`,
+      `})`,
+      `  .then((config) => bootstrapApplication(NgDocDemoAppComponent, config))`,
+      `  .catch((error) => console.error(error));`
+    ].join("\n");
+  }
+  return [
+    ...imports,
+    ...application,
+    `import { provideServerRendering } from '@angular/platform-server';`,
+    `export const bootstrap = async (context) =>`,
+    `  bootstrapApplication(`,
+    `    NgDocDemoAppComponent,`,
+    `    await \u0275ngDocDemoApplicationConfig(NG_DOC_DEMO_ROUTES, NG_DOC_DEMO_PROVIDERS, {`,
+    `      zone: ${options.zone},`,
+    `      hydration: true,`,
+    `      providers: [provideServerRendering()],`,
+    `    }),`,
+    `    context,`,
+    `  );`,
+    `export default bootstrap;`,
+    `export { renderApplication } from '@angular/platform-server';`,
+    `export { Router } from '@angular/router';`,
+    `export { runInInjectionContext } from '@angular/core';`
+  ].join("\n");
+}
 
 // libs/builder/generator/vite/prerender.ts
 import { fork as fork3 } from "node:child_process";
@@ -11385,7 +12118,8 @@ function prerenderNgDoc(options) {
     serverEntry: options.serverEntry,
     routes: [...options.routes ?? []],
     discoverRoutes: options.discoverRoutes ?? true,
-    ...options.routeTimeoutMs === void 0 ? {} : { routeTimeoutMs: options.routeTimeoutMs }
+    ...options.routeTimeoutMs === void 0 ? {} : { routeTimeoutMs: options.routeTimeoutMs },
+    ...options.demoServerEntry ? { demoServerEntry: options.demoServerEntry } : {}
   };
   if (request.routeTimeoutMs !== void 0 && (!Number.isSafeInteger(request.routeTimeoutMs) || request.routeTimeoutMs < 1)) {
     return Promise.reject(
@@ -11436,8 +12170,9 @@ function prerenderNgDoc(options) {
 }
 
 // libs/builder/generator/vite/production.ts
-import { rm as rm2, writeFile as writeFile2 } from "node:fs/promises";
-import path23 from "node:path";
+import { existsSync as existsSync7 } from "node:fs";
+import { rm as rm2, writeFile as writeFile3 } from "node:fs/promises";
+import path25 from "node:path";
 import { build as viteBuild } from "vite";
 var defaultDependencies = {
   build: viteBuild,
@@ -11474,11 +12209,11 @@ function applicationProbe() {
 async function buildNgDocViteApplication(options, dependencies = defaultDependencies) {
   assertSupportedViteVersion();
   assertConsistentAngularBuild();
-  const configFile = path23.resolve(options.configFile);
-  const outputPath = path23.resolve(options.outputPath);
-  const browser = path23.join(outputPath, "browser");
-  const serverDirectory = path23.join(outputPath, "server");
-  const serverEntry = path23.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 ?? (() => {
   });
@@ -11515,7 +12250,7 @@ async function buildNgDocViteApplication(options, dependencies = defaultDependen
     ssr ??= entry !== void 0;
     if (!ssr) {
       await rm2(serverDirectory, { recursive: true, force: true });
-      await rm2(path23.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) {
@@ -11550,23 +12285,26 @@ async function buildNgDocViteApplication(options, dependencies = defaultDependen
   }
   const prerender = options.prerender ?? (options.skipBuild ? true : ssr === true);
   if (!prerender) return { browser, ...ssr ? { server: serverEntry } : {} };
+  const demoServerEntry = path25.join(serverDirectory, "demo-server.mjs");
   const report = await timed(
     "Prerendered the routes",
     () => dependencies.prerender({
       browserDir: browser,
       serverEntry,
+      ...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 },
       ...options.signal ? { signal: options.signal } : {}
     })
   );
-  await writeFile2(
-    path23.join(outputPath, "prerendered-routes.json"),
+  await writeFile3(
+    path25.join(outputPath, "prerendered-routes.json"),
     `${JSON.stringify({ routes: report.routes, excluded: report.excluded }, null, 2)}
 `
   );
   log(`Prerendered ${report.routes.length} route(s) into ${browser}`);
+  for (const { route, message: message4 } of report.warnings ?? []) log(`Warning: ${route}: ${message4}`);
   if (report.errors.length) {
     log(`The application logged ${report.errors.length} error(s) while prerendering:`);
     for (const { route, message: message4 } of report.errors.slice(0, 10)) log(`  ${route}: ${message4}`);