@qualcomm-ui/mdx-vite 1.1.0 → 2.1.0

package/dist/cli.js

@@ -3501,172 +3501,11 @@ var {
   Help
 } = import_index.default;
 
-// src/open-web-ui-knowledge/download-knowledge.ts
-import { mkdir, writeFile } from "node:fs/promises";
-import { resolve } from "node:path";
-
-// src/open-web-ui-knowledge/common.ts
-import { config } from "dotenv";
-function loadEnv() {
-  const options = program.optsWithGlobals();
-  console.debug(options);
-  if (options.env) {
-    config({ path: options.env });
-  } else {
-    config();
-  }
-}
-function getConfigFromEnv() {
-  const openWebUiUrl = process.env.WEB_UI_URL;
-  const openWebUiKey = process.env.WEB_UI_KEY;
-  const knowledgeId = process.env.KNOWLEDGE_ID;
-  if (!openWebUiUrl || !openWebUiKey || !knowledgeId) {
-    throw new Error("WEB_UI_URL, WEB_UI_KEY, and KNOWLEDGE_ID must be set");
-  }
-  return {
-    knowledgeId,
-    webUiKey: openWebUiKey,
-    webUiUrl: openWebUiUrl
-  };
-}
-var KnowledgeApi = class {
-  config;
-  knowledgeCache = null;
-  constructor(config2) {
-    this.config = config2;
-  }
-  get headers() {
-    return {
-      Authorization: `Bearer ${this.config.webUiKey}`
-    };
-  }
-  async listKnowledgeFiles() {
-    if (this.knowledgeCache) {
-      return this.knowledgeCache;
-    }
-    const knowledge = await fetch(
-      `${this.config.webUiUrl}/api/v1/knowledge/${this.config.knowledgeId}`,
-      {
-        headers: {
-          ...this.headers,
-          Accept: "application/json"
-        }
-      }
-    ).then((res) => res.json());
-    if ("detail" in knowledge) {
-      throw new Error(knowledge.detail);
-    } else {
-      this.knowledgeCache = knowledge;
-    }
-    return this.knowledgeCache;
-  }
-  async downloadFile(fileId) {
-    const fileResponse = await fetch(
-      `${this.config.webUiUrl}/api/v1/files/${fileId}`,
-      {
-        headers: {
-          ...this.headers,
-          Accept: "application/json"
-        }
-      }
-    ).then((res) => res.json());
-    return fileResponse?.data?.content ?? "";
-  }
-  async removeKnowledgeFile(id) {
-    return fetch(
-      `${this.config.webUiUrl}/api/v1/knowledge/${this.config.knowledgeId}/file/remove`,
-      {
-        body: JSON.stringify({ file_id: id }),
-        headers: {
-          ...this.headers,
-          "Content-Type": "application/json"
-        },
-        method: "POST"
-      }
-    ).then((res) => res.json());
-  }
-  async deleteFile(id) {
-    return fetch(`${this.config.webUiUrl}/api/v1/files/${id}`, {
-      headers: {
-        ...this.headers,
-        "Content-Type": "application/json"
-      },
-      method: "DELETE"
-    }).then((res) => res.json());
-  }
-  async uploadFile(fileBuffer, name) {
-    const formData = new FormData();
-    formData.append("file", new Blob([fileBuffer]), name);
-    formData.append("knowledge_id", this.config.knowledgeId);
-    return fetch(`${this.config.webUiUrl}/api/v1/files/`, {
-      body: formData,
-      headers: {
-        ...this.headers,
-        Accept: "application/json"
-      },
-      method: "POST"
-    }).then((res) => res.json());
-  }
-  async associateFile(fileId) {
-    return fetch(
-      `${this.config.webUiUrl}/api/v1/knowledge/${this.config.knowledgeId}/file/add`,
-      {
-        body: JSON.stringify({ file_id: fileId }),
-        headers: {
-          ...this.headers,
-          "Content-Type": "application/json"
-        },
-        method: "POST"
-      }
-    ).then((res) => res.json());
-  }
-};
-
-// src/open-web-ui-knowledge/download-knowledge.ts
-function addDownloadKnowledgeCommand() {
-  program.command("download-knowledge").description("Download files from an Open Web UI knowledge base").requiredOption("-o, --output-dir <outputDir>", "Folder path").action(async (opts) => {
-    loadEnv();
-    await mkdir(opts.outputDir, { recursive: true }).catch();
-    const api = new KnowledgeApi(getConfigFromEnv());
-    const knowledge = await api.listKnowledgeFiles();
-    for (const file of knowledge.files) {
-      const data = await api.downloadFile(file.id);
-      if (data) {
-        await writeFile(
-          resolve(opts.outputDir, file.meta.name),
-          data,
-          "utf-8"
-        );
-      }
-    }
-  });
-}
-
-// src/open-web-ui-knowledge/generate-knowledge.ts
-import { kebabCase } from "change-case";
-import {
-  access,
-  mkdir as mkdir2,
-  readdir,
-  readFile,
-  rm,
-  stat,
-  writeFile as writeFile2
-} from "node:fs/promises";
-import { basename, dirname, extname, join as join3, resolve as resolve4 } from "node:path";
-import remarkFrontmatter3 from "remark-frontmatter";
-import remarkParse4 from "remark-parse";
-import remarkParseFrontmatter2 from "remark-parse-frontmatter";
-import remarkStringify3 from "remark-stringify";
-import { unified as unified4 } from "unified";
-
-// src/docs-plugin/docs-plugin.ts
-import chalk3 from "chalk";
-import chokidar from "chokidar";
+// src/docs-plugin/generate-page-map.ts
 import { glob } from "glob";
-import { readFileSync as readFileSync2 } from "node:fs";
-import { resolve as resolve2 } from "node:path";
-import prettyMilliseconds from "pretty-ms";
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { cwd } from "node:process";
 
 // src/docs-plugin/internal/config-loader.ts
 import { cosmiconfigSync } from "cosmiconfig";
@@ -4043,12 +3882,15 @@ var MarkdownFileReader = class {
   reset() {
     this.cachedFileCount = 0;
   }
-  checkCache(filepath, fileContents) {
+  readCache(filePath) {
+    return this.mdxCache[filePath] || null;
+  }
+  checkCache(filePath, fileContents) {
     if (!this.enabled) {
       return;
     }
     const fileMd5 = this.hash(fileContents);
-    const cached = this.mdxCache[filepath];
+    const cached = this.mdxCache[filePath];
     if (cached?.md5 !== fileMd5) {
       return;
     }
@@ -4569,9 +4411,9 @@ function getRouteMeta(pathSegments, metaJson) {
 }
 
 // src/docs-plugin/internal/services/nav-builder/nav-builder.ts
-import { capitalCase } from "change-case";
 import { sortBy } from "lodash-es";
 import { v4 as uuidv4 } from "uuid";
+import { capitalCase } from "@qualcomm-ui/utils/change-case";
 var NavBuilder = class {
   initialRoutes = [];
   flatNavItems = [];
@@ -4856,8 +4698,8 @@ var NavBuilder = class {
 };
 
 // src/docs-plugin/internal/services/nav-builder/page-map.ts
-import { capitalCase as capitalCase2 } from "change-case";
 import { join } from "node:path";
+import { capitalCase as capitalCase2 } from "@qualcomm-ui/utils/change-case";
 function getPathnameFromPathSegments(segments) {
   return `/${segments.join("/")}`;
 }
@@ -5127,11 +4969,25 @@ var SearchIndexer = class {
    * Parses an MDX file to extract the site data for the nav items, doc props,
    * breadcrumbs, and search index.
    */
-  compileMdxFile(filepath) {
-    const { cached, fileContents, frontmatter } = this.fileCache.readFile(filepath);
+  compileMdxFile(filePath) {
+    const { cached, fileContents, frontmatter } = this.fileCache.readFile(filePath);
+    const metadata = {
+      changed: {},
+      filePath
+    };
+    if (!cached) {
+      const previousData = this.fileCache.readCache(filePath);
+      if (previousData) {
+        const cachedFm = JSON.stringify(previousData.frontmatter);
+        const currentFm = JSON.stringify(frontmatter);
+        if (cachedFm !== currentFm) {
+          metadata.changed.frontmatter = true;
+        }
+      }
+    }
     this.docPropsIndexer.reset();
     this.markdownIndexer.reset();
-    const defaultSection = this.getPageEntry(filepath, frontmatter);
+    const defaultSection = this.getPageEntry(filePath, frontmatter);
     if (!defaultSection.categories.length && defaultSection.title) {
       defaultSection.categories = [defaultSection.title];
     }
@@ -5146,9 +5002,9 @@ var SearchIndexer = class {
       console.debug(
         `${chalk2.yellowBright.bold(
           "Failed to parse mdx page content."
-        )} ${chalk2.blueBright.bold(filepath)}`
+        )} ${chalk2.blueBright.bold(filePath)}`
       );
-      return [defaultSection];
+      return { metadata, pageSections: [defaultSection] };
     }
     const { sections, toc } = indexedPage;
     if (toc.length) {
@@ -5163,17 +5019,17 @@ var SearchIndexer = class {
     if (docPropSections.length) {
       this._pageDocProps[defaultSection.pathname] = docProps;
     }
-    this.fileCache.updateCache(filepath, fileContents, {
+    this.fileCache.updateCache(filePath, fileContents, {
       frontmatter,
       page: indexedPage,
       pageDocProps: docProps,
       pageDocPropSections: docPropSections
     });
     if (frontmatter.hideFromSearch) {
-      return [defaultSection];
+      return { metadata, pageSections: [defaultSection] };
     }
     if (!sections.length && !docPropSections.length) {
-      return [defaultSection];
+      return { metadata, pageSections: [defaultSection] };
     }
     const sectionReturn = [
       ...this.formatSections(sections, defaultSection, false)
@@ -5183,7 +5039,7 @@ var SearchIndexer = class {
         ...this.formatSections(docPropSections, defaultSection, true)
       );
     }
-    return sectionReturn;
+    return { metadata, pageSections: sectionReturn };
   }
   formatSections(sections, { toc: _toc, ...defaultSection }, isDocProp) {
     return sections.map((section, index) => {
@@ -5228,7 +5084,8 @@ var SearchIndexer = class {
       this.config.routingStrategy
     );
     this._mdxFileCount = mdxFileGlob.length;
-    const mdxIndex = mdxFileGlob.map((file) => this.compileMdxFile(file)).flat();
+    const compiledFiles = mdxFileGlob.map((file) => this.compileMdxFile(file));
+    const mdxIndex = compiledFiles.map((fileData) => fileData.pageSections).flat();
     filterFileGlob(
       fileGlob,
       "tsx",
@@ -5237,11 +5094,228 @@ var SearchIndexer = class {
     ).map((file) => this.compileTsxFile(file));
     this._searchIndex.push(...mdxIndex.filter((entry) => !entry.hideFromSearch));
     this.navBuilder.build();
+    return compiledFiles;
   }
 };
 
+// src/docs-plugin/generate-page-map.ts
+function addGeneratePageMapCommand() {
+  program.command("generate-page-map").description(
+    "Invokes the docs-plugin once to build the site data and writes it to json"
+  ).option(
+    "-c, --config-file <configFile>",
+    "Path to the qui-docs.config.ts config file"
+  ).option(
+    "-r, --routes-dir <routesDir>",
+    "Path to the routes directory",
+    "src/routes"
+  ).option(
+    "-o, --output <output>",
+    "Output path for the site data json",
+    "site-data.json"
+  ).action(async (options) => {
+    try {
+      const configLoader = new ConfigLoader({ configFile: options.configFile });
+      const resolvedConfig = configLoader.loadConfig();
+      const routesDir = fixPath(
+        resolve(resolvedConfig.appDirectory, resolvedConfig.pageDirectory)
+      );
+      const indexer = new SearchIndexer({
+        ...resolvedConfig,
+        srcDir: fixPath(resolve(cwd(), resolvedConfig.appDirectory)),
+        typeDocProps: {}
+      });
+      const files = glob.sync(
+        [`${routesDir}/**/*.mdx`, `${routesDir}/**/*.tsx`],
+        {
+          absolute: true,
+          cwd: cwd()
+        }
+      );
+      indexer.buildIndex(files, true);
+      await writeFile(
+        resolve(cwd(), options.output),
+        JSON.stringify(indexer.pageMap, null, 2),
+        "utf-8"
+      );
+    } catch (error) {
+      console.error(
+        "Generate Site Data Error:",
+        error instanceof Error ? error.message : String(error)
+      );
+      process.exit(1);
+    }
+  });
+}
+
+// src/open-web-ui-knowledge/download-knowledge.ts
+import { mkdir, writeFile as writeFile2 } from "node:fs/promises";
+import { resolve as resolve2 } from "node:path";
+
+// src/open-web-ui-knowledge/common.ts
+import { config } from "dotenv";
+function loadEnv() {
+  const options = program.optsWithGlobals();
+  console.debug(options);
+  if (options.env) {
+    config({ path: options.env });
+  } else {
+    config();
+  }
+}
+function getConfigFromEnv() {
+  const openWebUiUrl = process.env.WEB_UI_URL;
+  const openWebUiKey = process.env.WEB_UI_KEY;
+  const knowledgeId = process.env.KNOWLEDGE_ID;
+  if (!openWebUiUrl || !openWebUiKey || !knowledgeId) {
+    throw new Error("WEB_UI_URL, WEB_UI_KEY, and KNOWLEDGE_ID must be set");
+  }
+  return {
+    knowledgeId,
+    webUiKey: openWebUiKey,
+    webUiUrl: openWebUiUrl
+  };
+}
+var KnowledgeApi = class {
+  config;
+  knowledgeCache = null;
+  constructor(config2) {
+    this.config = config2;
+  }
+  get headers() {
+    return {
+      Authorization: `Bearer ${this.config.webUiKey}`
+    };
+  }
+  async listKnowledgeFiles() {
+    if (this.knowledgeCache) {
+      return this.knowledgeCache;
+    }
+    const knowledge = await fetch(
+      `${this.config.webUiUrl}/api/v1/knowledge/${this.config.knowledgeId}`,
+      {
+        headers: {
+          ...this.headers,
+          Accept: "application/json"
+        }
+      }
+    ).then((res) => res.json());
+    if ("detail" in knowledge) {
+      throw new Error(knowledge.detail);
+    } else {
+      this.knowledgeCache = knowledge;
+    }
+    return this.knowledgeCache;
+  }
+  async downloadFile(fileId) {
+    const fileResponse = await fetch(
+      `${this.config.webUiUrl}/api/v1/files/${fileId}`,
+      {
+        headers: {
+          ...this.headers,
+          Accept: "application/json"
+        }
+      }
+    ).then((res) => res.json());
+    return fileResponse?.data?.content ?? "";
+  }
+  async removeKnowledgeFile(id) {
+    return fetch(
+      `${this.config.webUiUrl}/api/v1/knowledge/${this.config.knowledgeId}/file/remove`,
+      {
+        body: JSON.stringify({ file_id: id }),
+        headers: {
+          ...this.headers,
+          "Content-Type": "application/json"
+        },
+        method: "POST"
+      }
+    ).then((res) => res.json());
+  }
+  async deleteFile(id) {
+    return fetch(`${this.config.webUiUrl}/api/v1/files/${id}`, {
+      headers: {
+        ...this.headers,
+        "Content-Type": "application/json"
+      },
+      method: "DELETE"
+    }).then((res) => res.json());
+  }
+  async uploadFile(fileBuffer, name) {
+    const formData = new FormData();
+    formData.append("file", new Blob([fileBuffer]), name);
+    formData.append("knowledge_id", this.config.knowledgeId);
+    return fetch(`${this.config.webUiUrl}/api/v1/files/`, {
+      body: formData,
+      headers: {
+        ...this.headers,
+        Accept: "application/json"
+      },
+      method: "POST"
+    }).then((res) => res.json());
+  }
+  async associateFile(fileId) {
+    return fetch(
+      `${this.config.webUiUrl}/api/v1/knowledge/${this.config.knowledgeId}/file/add`,
+      {
+        body: JSON.stringify({ file_id: fileId }),
+        headers: {
+          ...this.headers,
+          "Content-Type": "application/json"
+        },
+        method: "POST"
+      }
+    ).then((res) => res.json());
+  }
+};
+
+// src/open-web-ui-knowledge/download-knowledge.ts
+function addDownloadKnowledgeCommand() {
+  program.command("download-knowledge").description("Download files from an Open Web UI knowledge base").requiredOption("-o, --output-dir <outputDir>", "Folder path").action(async (opts) => {
+    loadEnv();
+    await mkdir(opts.outputDir, { recursive: true }).catch();
+    const api = new KnowledgeApi(getConfigFromEnv());
+    const knowledge = await api.listKnowledgeFiles();
+    for (const file of knowledge.files) {
+      const data = await api.downloadFile(file.id);
+      if (data) {
+        await writeFile2(
+          resolve2(opts.outputDir, file.meta.name),
+          data,
+          "utf-8"
+        );
+      }
+    }
+  });
+}
+
+// src/open-web-ui-knowledge/generate-knowledge.ts
+import {
+  access,
+  mkdir as mkdir2,
+  readdir,
+  readFile,
+  rm,
+  stat,
+  writeFile as writeFile3
+} from "node:fs/promises";
+import { basename, dirname, extname, join as join3, resolve as resolve5 } from "node:path";
+import remarkFrontmatter3 from "remark-frontmatter";
+import remarkParse4 from "remark-parse";
+import remarkParseFrontmatter2 from "remark-parse-frontmatter";
+import remarkStringify3 from "remark-stringify";
+import { unified as unified4 } from "unified";
+import { kebabCase } from "@qualcomm-ui/utils/change-case";
+
 // src/docs-plugin/docs-plugin.ts
+import chalk3 from "chalk";
+import chokidar from "chokidar";
+import { glob as glob2 } from "glob";
+import { readFileSync as readFileSync2 } from "node:fs";
+import { resolve as resolve3 } from "node:path";
+import prettyMilliseconds from "pretty-ms";
 var isDev = process.env.NODE_ENV === "development";
+var VIRTUAL_MODULE_ID = "\0@qualcomm-ui/mdx-vite-plugin";
 var PluginState = class {
   buildCount = 0;
   configFilePath = "";
@@ -5252,14 +5326,9 @@ var PluginState = class {
   servers = [];
   timeout = void 0;
   watching = false;
-  resolvedVirtualModuleId;
-  virtualModuleId = "@qualcomm-ui/mdx-vite-plugin";
   cwd;
-  constructor() {
-    this.resolvedVirtualModuleId = `\0${this.virtualModuleId}`;
-  }
-  init(cwd) {
-    this.cwd = cwd;
+  init(cwd2) {
+    this.cwd = cwd2;
   }
   get docPropsDirectory() {
     if (!this.docPropsFilePath) {
@@ -5270,6 +5339,14 @@ var PluginState = class {
       this.docPropsFilePath.lastIndexOf("/")
     );
   }
+  get siteData() {
+    return {
+      navItems: state.indexer.navItems,
+      pageDocProps: state.indexer.pageDocProps,
+      pageMap: state.indexer.pageMap,
+      searchIndex: state.indexer.searchIndex
+    };
+  }
   resolveDocProps() {
     if (!this.docPropsFilePath) {
       return {};
@@ -5285,16 +5362,16 @@ var PluginState = class {
   }
   createIndexer(config2) {
     this.configFilePath = config2.filePath;
-    this.docPropsFilePath = config2.typeDocProps ? fixPath(resolve2(this.cwd, config2.typeDocProps)) : "";
-    this.routesDir = fixPath(resolve2(config2.appDirectory, config2.pageDirectory));
+    this.docPropsFilePath = config2.typeDocProps ? fixPath(resolve3(this.cwd, config2.typeDocProps)) : "";
+    this.routesDir = fixPath(resolve3(config2.appDirectory, config2.pageDirectory));
     this.indexer = new SearchIndexer({
       ...config2,
-      srcDir: fixPath(resolve2(this.cwd, config2.appDirectory)),
+      srcDir: fixPath(resolve3(this.cwd, config2.appDirectory)),
       typeDocProps: this.resolveDocProps()
     });
   }
   buildIndex(shouldLog) {
-    const files = glob.sync(
+    const files = glob2.sync(
       [`${this.routesDir}/**/*.mdx`, `${this.routesDir}/**/*.tsx`],
       {
         absolute: true,
@@ -5302,38 +5379,37 @@ var PluginState = class {
       }
     );
     if (!files.length) {
-      return;
+      return [];
     }
     const startTime = Date.now();
-    this.indexer.buildIndex(files, shouldLog);
+    const compiledMdxFiles = this.indexer.buildIndex(files, shouldLog);
     if (isDev && shouldLog) {
       console.debug(
         `${chalk3.magenta.bold(`@qualcomm-ui/mdx-vite/docs-plugin:`)} Compiled search index in: ${chalk3.blueBright.bold(prettyMilliseconds(Date.now() - startTime))}${state.indexer.cachedFileCount ? chalk3.greenBright.bold(` (${state.indexer.cachedFileCount}/${state.indexer.mdxFileCount} files cached)`) : ""}`
       );
     }
+    return compiledMdxFiles;
   }
   /**
-   * When the user edits MDX content or modifies the plugin config, we re-index the
-   * site. This function handles module invalidation so that virtual file imports
-   * are refreshed as expected by the consumer's dev server.
+   * When the user adds or removes mdx files, we re-index the site. This function
+   * handles module invalidation so that virtual file imports are refreshed as
+   * expected by the consumer's dev server.
    */
   sendUpdate() {
     for (const server of this.servers) {
-      const virtualModule = server.moduleGraph.getModuleById(
-        this.resolvedVirtualModuleId
-      );
+      const virtualModule = server.moduleGraph.getModuleById(VIRTUAL_MODULE_ID);
       if (virtualModule) {
         server.moduleGraph.invalidateModule(virtualModule);
         server.reloadModule(virtualModule);
       }
     }
   }
-  handleChange(callback) {
+  handleChange(opts = {}) {
     clearTimeout(this.timeout);
     this.timeout = setTimeout(() => {
       this.buildIndex(true);
       this.sendUpdate();
-      callback?.();
+      opts?.onComplete?.();
     }, 300);
   }
   initWatchers(configFile) {
@@ -5356,7 +5432,13 @@ var PluginState = class {
       const resolvedConfig = this.configLoader.loadConfig();
       this.configFilePath = resolvedConfig.filePath;
       this.createIndexer(resolvedConfig);
-      this.handleChange();
+      this.handleChange({
+        onComplete: () => {
+          this.servers.forEach(
+            (server) => server.ws.send({ type: "full-reload" })
+          );
+        }
+      });
     });
   }
 };
@@ -5364,6 +5446,16 @@ var state = new PluginState();
 
 // src/docs-plugin/mdx-plugins.ts
 import rehypeShiki from "@shikijs/rehype";
+import {
+  transformerNotationDiff,
+  transformerNotationErrorLevel,
+  transformerNotationFocus,
+  transformerNotationHighlight,
+  transformerNotationWordHighlight,
+  transformerRemoveNotationEscape,
+  transformerRenderIndentGuides
+} from "@shikijs/transformers";
+import { merge } from "lodash-es";
 import { quiCustomDarkTheme } from "@qualcomm-ui/mdx-common";
 
 // src/exports.ts
@@ -5430,7 +5522,7 @@ import { visit as visit6 } from "unist-util-visit";
 
 // src/open-web-ui-knowledge/load-config-from-env.ts
 import { existsSync } from "node:fs";
-import { join as join2, resolve as resolve3 } from "node:path";
+import { join as join2, resolve as resolve4 } from "node:path";
 function loadKnowledgeConfigFromEnv(options) {
   const knowledgeId = process.env.KNOWLEDGE_ID;
   const exclude = options.exclude || (process.env.FILE_EXCLUDE_PATTERN ?? "").split(",");
@@ -5448,7 +5540,7 @@ function loadKnowledgeConfigFromEnv(options) {
     resolvedConfig.appDirectory,
     resolvedConfig.pageDirectory
   );
-  if (!existsSync(resolve3(routeDir))) {
+  if (!existsSync(resolve4(routeDir))) {
     throw new Error(`Route directory ${routeDir} does not exist`);
   }
   return {
@@ -5468,7 +5560,7 @@ async function exists(dirPath) {
   return access(dirPath).then(() => true).catch(() => false);
 }
 async function loadDocProps(routesFolder, docPropsPath, verbose) {
-  const resolvedDocPropsPath = docPropsPath ? await exists(docPropsPath) ? docPropsPath : resolve4(process.cwd(), docPropsPath) : join3(dirname(routesFolder), "doc-props.json");
+  const resolvedDocPropsPath = docPropsPath ? await exists(docPropsPath) ? docPropsPath : resolve5(process.cwd(), docPropsPath) : join3(dirname(routesFolder), "doc-props.json");
   if (!await exists(resolvedDocPropsPath)) {
     if (verbose) {
       console.log(`Doc props file not found at: ${resolvedDocPropsPath}`);
@@ -5700,7 +5792,7 @@ function extractRelativeImports(content) {
 }
 async function resolveModulePath(importPath, fromFile) {
   const fromDir = dirname(fromFile);
-  const baseResolved = resolve4(fromDir, importPath);
+  const baseResolved = resolve5(fromDir, importPath);
   const extensions = [".ts", ".tsx", ".js", ".jsx", ""];
   for (const ext of extensions) {
     const fullPath = baseResolved + ext;
@@ -5717,7 +5809,7 @@ async function resolveModulePath(importPath, fromFile) {
   return null;
 }
 async function collectRelativeImports(filePath, visited = /* @__PURE__ */ new Set(), verbose) {
-  const normalizedPath = resolve4(filePath);
+  const normalizedPath = resolve5(filePath);
   if (visited.has(normalizedPath)) {
     return [];
   }
@@ -5796,10 +5888,10 @@ ${JSON.stringify(propsDoc, null, 2)}
   } else {
     processedContent = processedContent.replace(/<TypeDocProps\s+[^>]*\/>/g, "");
   }
-  let demoRegex = /<(?:QdsDemo|CodeDemo)\s+[^>]*name="(\w+)"[^>]*\/>/g;
+  let demoRegex = /<(?:QdsDemo|CodeDemo|Demo)\s+[^>]*name="(\w+)"[^>]*\/>/g;
   let demoMatches = Array.from(processedContent.matchAll(demoRegex));
   if (!demoMatches.length) {
-    demoRegex = /<(?:QdsDemo|CodeDemo)\s+[^>]*node=\{Demo\.(\w+)\}[^>]*\/>/g;
+    demoRegex = /<(?:QdsDemo|CodeDemo|Demo)\s+[^>]*node=\{Demo\.(\w+)\}[^>]*\/>/g;
     demoMatches = Array.from(processedContent.matchAll(demoRegex));
   }
   const replacements = await Promise.all(
@@ -5963,8 +6055,8 @@ async function generatePerPageExports({
           }
         }
       }
-      const outfile = `${resolve4(outputPath)}/${kebabCase(page.name)}.md`;
-      await writeFile2(outfile, lines.join("\n"), "utf-8");
+      const outfile = `${resolve5(outputPath)}/${kebabCase(page.name)}.md`;
+      await writeFile3(outfile, lines.join("\n"), "utf-8");
       const stats = await stat(outfile);
       totalSize += stats.size / 1024;
     })
@@ -6032,7 +6124,7 @@ async function generate({
       baseUrl
     );
     await mkdir2(dirname(outputPath), { recursive: true }).catch();
-    await writeFile2(outputPath, llmsTxtContent, "utf-8");
+    await writeFile3(outputPath, llmsTxtContent, "utf-8");
     const outputStats = await stat(outputPath);
     const outputSizeKb = (outputStats.size / 1024).toFixed(1);
     console.log(
@@ -6078,9 +6170,9 @@ import {
   readdir as readdir2,
   readFile as readFile2,
   stat as stat2,
-  writeFile as writeFile3
+  writeFile as writeFile4
 } from "node:fs/promises";
-import { resolve as resolve5 } from "node:path";
+import { resolve as resolve6 } from "node:path";
 import { setTimeout as setTimeout2 } from "node:timers/promises";
 import ora from "ora";
 function calculateFileHash(fileData) {
@@ -6104,7 +6196,7 @@ var Uploader = class {
     const files = await Promise.all(
       fileNames.map(async (name) => ({
         contents: await readFile2(
-          resolve5(this.config.knowledgeFilePath, name),
+          resolve6(this.config.knowledgeFilePath, name),
           "utf-8"
         ),
         name
@@ -6155,16 +6247,16 @@ var Uploader = class {
         if (calculateFileHash(data) === calculateFileHash(contents)) {
           return { skipped: true, success: true };
         }
-        await mkdir3(resolve5(process.cwd(), `./temp/diff`), {
+        await mkdir3(resolve6(process.cwd(), `./temp/diff`), {
           recursive: true
         }).catch();
-        await writeFile3(
-          resolve5(process.cwd(), `./temp/diff/${name}-current.md`),
+        await writeFile4(
+          resolve6(process.cwd(), `./temp/diff/${name}-current.md`),
           contents,
           "utf-8"
         );
-        await writeFile3(
-          resolve5(process.cwd(), `./temp/diff/${name}-owui.md`),
+        await writeFile4(
+          resolve6(process.cwd(), `./temp/diff/${name}-owui.md`),
           data,
           "utf-8"
         );
@@ -6181,7 +6273,7 @@ var Uploader = class {
       }
     }
     const fileBuffer = await readFile2(
-      resolve5(this.config.knowledgeFilePath, name)
+      resolve6(this.config.knowledgeFilePath, name)
     );
     if (knowledgeFile) {
       await this.api.removeKnowledgeFile(knowledgeFile.id);
@@ -6207,7 +6299,7 @@ var Uploader = class {
     }
   }
   async uploadKnowledge() {
-    const resolvedPath = resolve5(this.config.knowledgeFilePath);
+    const resolvedPath = resolve6(this.config.knowledgeFilePath);
     if (!await access2(resolvedPath).then(() => true).catch(() => false)) {
       throw new Error(`File or folder not found at ${resolvedPath}`);
     }
@@ -6241,16 +6333,16 @@ function addUploadKnowledgeCommand() {
 }
 
 // src/react-demo-plugin/generate-lazy-demo-map.ts
-import { glob as glob2 } from "glob";
+import { glob as glob3 } from "glob";
 import { uniqBy } from "lodash-es";
-import { writeFile as writeFile4 } from "node:fs/promises";
-import { resolve as resolve7 } from "node:path";
+import { writeFile as writeFile5 } from "node:fs/promises";
+import { resolve as resolve8 } from "node:path";
 import { dedent } from "@qualcomm-ui/utils/dedent";
 
 // src/react-demo-plugin/demo-plugin-utils.ts
 import chalk4 from "chalk";
 import { existsSync as existsSync2, readFileSync as readFileSync3 } from "node:fs";
-import { dirname as dirname2, join as join4, relative, resolve as resolve6, sep } from "node:path";
+import { dirname as dirname2, join as join4, relative, resolve as resolve7, sep } from "node:path";
 import * as ts from "typescript";
 import { pascalCase } from "@qualcomm-ui/utils/change-case";
 function extractPageId(filePath, routesDir) {
@@ -6264,8 +6356,7 @@ function extractPageId(filePath, routesDir) {
 }
 function isDemoFile(filePath) {
   try {
-    return filePath.includes("/demos/") && filePath.endsWith(".tsx") && // could also be in a comment, probably need to use TS parser
-    readFileSync3(filePath, "utf-8").includes("export default");
+    return filePath.includes("/demos/") && filePath.endsWith(".tsx") && !readFileSync3(filePath).includes("export default");
   } catch (error) {
     return false;
   }
@@ -6276,7 +6367,7 @@ async function scanForDemoPages({
   demoPattern = "src/routes/**/demos/*.tsx",
   routesDir = "src/routes"
 }) {
-  const demoFiles = (await glob2(demoPattern)).filter((file) => isDemoFile(file));
+  const demoFiles = (await glob3(demoPattern)).filter((file) => isDemoFile(file));
   return uniqBy(
     demoFiles.map((file) => ({
       pageId: extractPageId(file, routesDir),
@@ -6308,12 +6399,12 @@ function generateLazyDemoLoader(demoPages) {
 }
 async function generateLazyDemoMap(options) {
   const routesDir = options.routesDir;
-  const outputPath = resolve7(options.output);
+  const outputPath = resolve8(options.output);
   console.log(`Scanning for demo pages in: ${routesDir}`);
   const demoPages = await scanForDemoPages({ routesDir });
   console.log(`Found ${demoPages.length} pages with demos`);
   const content = generateLazyDemoLoader(demoPages);
-  await writeFile4(outputPath, content, "utf-8");
+  await writeFile5(outputPath, content, "utf-8");
   console.log(`
 Generated lazy demo loader at: ${outputPath}`);
 }
@@ -6344,6 +6435,7 @@ function setupCli() {
   addUploadKnowledgeCommand();
   addDownloadKnowledgeCommand();
   addGenerateLazyDemoMapCommand();
+  addGeneratePageMapCommand();
   program.parse();
 }
 setupCli();