@qualcomm-ui/mdx-vite 2.8.0 → 2.10.0

package/dist/cli.js

@@ -520,9 +520,9 @@ var require_help = __commonJS({
        * @param {Help} helper
        * @returns string[]
        */
-      formatItemList(heading2, items, helper) {
+      formatItemList(heading, items, helper) {
         if (items.length === 0) return [];
-        return [helper.styleTitle(heading2), ...items, ""];
+        return [helper.styleTitle(heading), ...items, ""];
       }
       /**
        * Group items by their help group heading.
@@ -1002,8 +1002,8 @@ var require_option = __commonJS({
        * @param {string} heading
        * @return {Option}
        */
-      helpGroup(heading2) {
-        this.helpGroupHeading = heading2;
+      helpGroup(heading) {
+        this.helpGroupHeading = heading;
         return this;
       }
       /**
@@ -3099,9 +3099,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [heading]
        * @return {Command | string}
        */
-      helpGroup(heading2) {
-        if (heading2 === void 0) return this._helpGroupHeading ?? "";
-        this._helpGroupHeading = heading2;
+      helpGroup(heading) {
+        if (heading === void 0) return this._helpGroupHeading ?? "";
+        this._helpGroupHeading = heading;
         return this;
       }
       /**
@@ -3117,9 +3117,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [heading]
        * @returns {Command | string}
        */
-      commandsGroup(heading2) {
-        if (heading2 === void 0) return this._defaultCommandGroup ?? "";
-        this._defaultCommandGroup = heading2;
+      commandsGroup(heading) {
+        if (heading === void 0) return this._defaultCommandGroup ?? "";
+        this._defaultCommandGroup = heading;
         return this;
       }
       /**
@@ -3135,9 +3135,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [heading]
        * @returns {Command | string}
        */
-      optionsGroup(heading2) {
-        if (heading2 === void 0) return this._defaultOptionGroup ?? "";
-        this._defaultOptionGroup = heading2;
+      optionsGroup(heading) {
+        if (heading === void 0) return this._defaultOptionGroup ?? "";
+        this._defaultOptionGroup = heading;
         return this;
       }
       /**
@@ -3552,13 +3552,23 @@ var typeDocPropsSchema = implement().with({
 var knowledgeExtraFileSchema = implement().with({
   contents: z2.string(),
   id: z2.string(),
-  title: z2.string()
+  processAsMdx: z2.boolean().optional(),
+  title: z2.string().optional()
+});
+var knowledgeExportsSchema = implement().with({
+  enabled: z2.boolean().optional(),
+  exclude: z2.array(z2.string()).optional(),
+  extraFiles: z2.array(knowledgeExtraFileSchema).optional(),
+  metadata: z2.record(z2.string(), z2.string()).optional(),
+  pageTitlePrefix: z2.string().optional(),
+  staticPath: z2.string().optional()
 });
 var knowledgeIntegrationSchema = implement().with(
   {
     baseUrl: z2.string().optional(),
     description: z2.string().optional(),
     exclude: z2.array(z2.string()).optional(),
+    exports: knowledgeExportsSchema.optional(),
     extraFiles: z2.array(knowledgeExtraFileSchema).optional(),
     metadata: z2.record(z2.string(), z2.string()).optional(),
     name: z2.string().optional(),
@@ -3871,7 +3881,7 @@ var DocPropsIndexer = class {
   }
   assembleProp(prop, id) {
     const name = prop.name;
-    const heading2 = {
+    const heading = {
       headingLevel: 4,
       id,
       tagName: "a",
@@ -3879,7 +3889,7 @@ var DocPropsIndexer = class {
     };
     const comment = prop.comment;
     if (!comment) {
-      return { content: [], heading: heading2, richContent: [] };
+      return { content: [], heading, richContent: [] };
     }
     const content = {
       tagName: "p",
@@ -3887,7 +3897,7 @@ var DocPropsIndexer = class {
         comment.summary.map((entry) => entry.text.replaceAll("\n", " ")).join("")
       ]
     };
-    return { content: [content], heading: heading2, richContent: [] };
+    return { content: [content], heading, richContent: [] };
   }
 };
 
@@ -4354,6 +4364,36 @@ var alertToEmphasis = {
   warning: "warning"
 };
 
+// src/docs-plugin/remark/remark-frontmatter-interpolation.ts
+import { visit as visit4 } from "unist-util-visit";
+var FRONTMATTER_PATTERN = /^\s*frontmatter\.(\w+)\s*$/;
+function isMdxExpression(node) {
+  const n = node;
+  return (n.type === "mdxFlowExpression" || n.type === "mdxTextExpression") && typeof n.value === "string";
+}
+var remarkFrontmatterInterpolation = (frontmatter) => {
+  return (tree) => {
+    visit4(tree, (node, index, parent) => {
+      if (!isMdxExpression(node) || index === void 0 || !parent) {
+        return;
+      }
+      const match = node.value.match(FRONTMATTER_PATTERN);
+      if (!match) {
+        return;
+      }
+      const key = match[1];
+      const value = frontmatter[key];
+      if (typeof value === "string" || typeof value === "number") {
+        const textNode = {
+          type: "text",
+          value: String(value)
+        };
+        parent.children[index] = textNode;
+      }
+    });
+  };
+};
+
 // src/docs-plugin/internal/services/markdown/remark-remove-code-blocks.ts
 import { remove } from "unist-util-remove";
 var remarkRemoveMermaidCodeBlocks = () => {
@@ -4398,8 +4438,8 @@ var MarkdownIndexer = class {
     this.resetSection();
     this.headingLevels = headingLevels;
   }
-  appendTocItem(heading2) {
-    this._toc.push(heading2);
+  appendTocItem(heading) {
+    this._toc.push(heading);
   }
   warn(...data) {
     if (process.env.DEBUG) {
@@ -4434,11 +4474,11 @@ var MarkdownIndexer = class {
         this.sections.push(clone(this.currentSection));
         this.resetSection();
       }
-      const heading2 = this.parseHeading(element);
+      const heading = this.parseHeading(element);
       if (!isRootHeading) {
-        this.appendTocItem(heading2);
+        this.appendTocItem(heading);
       }
-      this.currentSection.heading = heading2;
+      this.currentSection.heading = heading;
       return;
     }
     this.currentSection.richContent.push(element);
@@ -4451,14 +4491,9 @@ var MarkdownIndexer = class {
     }
   }
   parseMarkdown(fileContents, frontmatter) {
-    const file = unified3().use(remarkMdx2).use(remarkRemoveJsx).use(remarkRemoveMermaidCodeBlocks).use(remarkParse3).use(remarkGfm).use(remarkAlerts).use(remarkRehype).use(rehypeStringify).processSync(fileContents);
+    const file = unified3().use(remarkMdx2).use(remarkRemoveJsx).use(remarkRemoveMermaidCodeBlocks).use(remarkParse3).use(remarkGfm).use(remarkAlerts).use(remarkFrontmatterInterpolation, frontmatter).use(remarkRehype).use(rehypeStringify).processSync(fileContents);
     let contents = file.toString();
     contents = contents.substring(contents.indexOf("<h1>"));
-    for (const [key, value] of Object.entries(frontmatter)) {
-      if (typeof value === "string" || typeof value === "number") {
-        contents = contents.replaceAll(`frontmatter.${key}`, `${value}`);
-      }
-    }
     const htmlAst = unified3().data("settings", { fragment: true }).use(rehypeParse).use(rehypeStringify).use(rehypeSlug).processSync(contents);
     contents = htmlAst.toString();
     return this.build(contents);
@@ -4825,7 +4860,7 @@ function getRemixFlatRoutesSegments(name, index, paramPrefixChar = "$") {
   let routeSegments = [];
   let i = 0;
   let routeSegment = "";
-  let state2 = "START";
+  let state = "START";
   let subState = "NORMAL";
   let hasPlus = false;
   if (name.endsWith("_layout")) {
@@ -4852,7 +4887,7 @@ function getRemixFlatRoutesSegments(name, index, paramPrefixChar = "$") {
   };
   while (i < name.length) {
     const char = name[i];
-    switch (state2) {
+    switch (state) {
       case "START":
         if (routeSegment.includes(paramPrefixChar) && !(routeSegment.startsWith(paramPrefixChar) || routeSegment.startsWith(`(${paramPrefixChar}`))) {
           throw new Error(
@@ -4866,12 +4901,12 @@ function getRemixFlatRoutesSegments(name, index, paramPrefixChar = "$") {
         }
         pushRouteSegment(routeSegment);
         routeSegment = "";
-        state2 = "PATH";
+        state = "PATH";
         continue;
       // restart without advancing index
       case "PATH":
         if (isPathSeparator(char) && subState === "NORMAL") {
-          state2 = "START";
+          state = "START";
           break;
         } else if (char === "[") {
           subState = "ESCAPE";
@@ -5363,7 +5398,7 @@ var FilesApi = class {
       if (status.status === "completed" || status.status === "failed") {
         return status;
       }
-      await new Promise((resolve9) => setTimeout(resolve9, intervalMs));
+      await new Promise((resolve8) => setTimeout(resolve8, intervalMs));
     }
     throw new Error(`File processing timed out after ${maxAttempts} attempts`);
   }
@@ -5623,238 +5658,19 @@ import {
   stat,
   writeFile as writeFile3
 } from "node:fs/promises";
-import { basename, dirname, extname, join as join3, relative as relative2, resolve as resolve5 } from "node:path";
-import remarkFrontmatter3 from "remark-frontmatter";
+import { basename, dirname, extname, join as join3, relative as relative2, resolve as resolve4 } from "node:path";
+import remarkFrontmatter2 from "remark-frontmatter";
 import remarkMdx3 from "remark-mdx";
 import remarkParse4 from "remark-parse";
 import remarkParseFrontmatter2 from "remark-parse-frontmatter";
 import remarkStringify3 from "remark-stringify";
 import { unified as unified4 } from "unified";
-import { visit as visit8 } from "unist-util-visit";
-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 = "";
-  docPropsFilePath = "";
-  indexer;
-  configLoader = null;
-  routesDir;
-  servers = [];
-  timeout = void 0;
-  watching = false;
-  cwd;
-  init(cwd2) {
-    this.cwd = cwd2;
-  }
-  get docPropsDirectory() {
-    if (!this.docPropsFilePath) {
-      return "";
-    }
-    return this.docPropsFilePath.substring(
-      0,
-      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 {};
-    }
-    try {
-      return JSON.parse(readFileSync2(this.docPropsFilePath, "utf-8"))?.props;
-    } catch (e) {
-      console.debug(
-        "Invalid doc props file. Unable to parse JSON. Please check the file"
-      );
-      return {};
-    }
-  }
-  createIndexer(config2) {
-    this.configFilePath = config2.filePath;
-    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(resolve3(this.cwd, config2.appDirectory)),
-      typeDocProps: this.resolveDocProps()
-    });
-  }
-  buildIndex(shouldLog) {
-    const files = glob2.sync(
-      [`${this.routesDir}/**/*.mdx`, `${this.routesDir}/**/*.tsx`],
-      {
-        absolute: true,
-        cwd: this.cwd
-      }
-    );
-    if (!files.length) {
-      return [];
-    }
-    const startTime = Date.now();
-    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 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(VIRTUAL_MODULE_ID);
-      if (virtualModule) {
-        server.moduleGraph.invalidateModule(virtualModule);
-        server.reloadModule(virtualModule);
-      }
-    }
-  }
-  handleChange(opts = {}) {
-    clearTimeout(this.timeout);
-    this.timeout = setTimeout(() => {
-      this.buildIndex(true);
-      this.sendUpdate();
-      opts?.onComplete?.();
-    }, 300);
-  }
-  initWatchers(configFile) {
-    if (this.watching) {
-      return;
-    }
-    this.initConfigWatcher(configFile);
-    this.watching = true;
-  }
-  initConfigWatcher(configFile) {
-    const paths = [this.configFilePath];
-    if (this.docPropsFilePath) {
-      paths.push(this.docPropsFilePath);
-    }
-    chokidar.watch(paths, {
-      cwd: this.cwd
-    }).on("change", () => {
-      console.debug(`qui-docs config changed, reloading plugin`);
-      this.configLoader = new ConfigLoader({ configFile });
-      const resolvedConfig = this.configLoader.loadConfig();
-      this.configFilePath = resolvedConfig.filePath;
-      this.createIndexer(resolvedConfig);
-      this.handleChange({
-        onComplete: () => {
-          this.servers.forEach(
-            (server) => server.ws.send({ type: "full-reload" })
-          );
-        }
-      });
-    });
-  }
-};
-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
-import rehypeMdxCodeProps from "rehype-mdx-code-props";
-import remarkFrontmatter2 from "remark-frontmatter";
-import remarkGfm2 from "remark-gfm";
-import remarkMdxFrontmatter from "remark-mdx-frontmatter";
-
-// src/docs-plugin/rehype/rehype-sectionize.ts
-import { heading } from "hast-util-heading";
-import { headingRank as headingRank2 } from "hast-util-heading-rank";
-
-// src/docs-plugin/remark/remark-code-tabs.ts
-import { visit as visit4 } from "unist-util-visit";
-
-// src/docs-plugin/remark/remark-frontmatter-description.ts
 import { visit as visit5 } from "unist-util-visit";
-
-// src/docs-plugin/remark/remark-self-link-headings.ts
-import { toString as toString2 } from "mdast-util-to-string";
-import { visit as visit6 } from "unist-util-visit";
-var emptyOptions2 = {};
-function remarkSelfLinkHeadings(baseUrl = "", options) {
-  if (!baseUrl) {
-    return () => {
-    };
-  }
-  return () => {
-    const settings = options || emptyOptions2;
-    const prefix = settings.prefix || "";
-    const allowedLevels = new Set(settings.allowedLevels || [2, 3, 4]);
-    const seenIds = /* @__PURE__ */ new Map();
-    function createSlug(text) {
-      const cleaned = text.replace(/[<>]/g, "").replace(/[^\w\s-]/g, "").trim();
-      let slug;
-      if (cleaned.includes(" ")) {
-        slug = cleaned.toLowerCase().replace(/\s+/g, "-").replace(/^-+|-+$/g, "");
-      } else if ((cleaned.match(/[A-Z]/g) || []).length >= 2) {
-        slug = cleaned.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").toLowerCase();
-      } else {
-        slug = cleaned.toLowerCase();
-      }
-      const count = seenIds.get(slug) || 0;
-      seenIds.set(slug, count + 1);
-      return count > 0 ? `${slug}-${count}` : slug;
-    }
-    return (tree) => {
-      seenIds.clear();
-      visit6(tree, "heading", (node) => {
-        if (allowedLevels.has(node.depth)) {
-          const text = toString2(node);
-          const slug = prefix + createSlug(text);
-          const linkNode = {
-            children: node.children,
-            type: "link",
-            url: `${baseUrl}#${slug}`
-          };
-          node.children = [linkNode];
-        }
-      });
-    };
-  };
-}
-
-// src/docs-plugin/remark/remark-spoilers.ts
-import { visit as visit7 } from "unist-util-visit";
-
-// src/docs-plugin/shiki/shiki-transformer-preview-block.ts
-import { dedent } from "@qualcomm-ui/utils/dedent";
+import { kebabCase } from "@qualcomm-ui/utils/change-case";
 
 // src/open-web-ui-knowledge/load-config-from-env.ts
 import { existsSync } from "node:fs";
-import { join as join2, resolve as resolve4 } from "node:path";
+import { join as join2, resolve as resolve3 } from "node:path";
 function parseCliMetadata(cliMetadata) {
   if (!cliMetadata?.length) {
     return void 0;
@@ -5874,7 +5690,7 @@ function loadKnowledgeConfigFromEnv(options) {
     resolvedConfig.appDirectory,
     resolvedConfig.pageDirectory
   );
-  if (!existsSync(resolve4(routeDir))) {
+  if (!existsSync(resolve3(routeDir))) {
     throw new Error(`Route directory ${routeDir} does not exist`);
   }
   const cliMetadata = parseCliMetadata(options.metadata);
@@ -5938,7 +5754,7 @@ function extractRelativeImports(content) {
 }
 async function resolveModulePath(importPath, fromFile) {
   const fromDir = dirname(fromFile);
-  const baseResolved = resolve5(fromDir, importPath);
+  const baseResolved = resolve4(fromDir, importPath);
   const extensions = [".ts", ".tsx", ".js", ".jsx", ""];
   for (const ext of extensions) {
     const fullPath = baseResolved + ext;
@@ -5959,7 +5775,7 @@ function extractMetadata(metadata) {
 }
 var replaceNpmInstallTabs = () => {
   return (tree, _file, done) => {
-    visit8(tree, "mdxJsxFlowElement", (node) => {
+    visit5(tree, "mdxJsxFlowElement", (node) => {
       if (node?.name === "NpmInstallTabs") {
         const packages = node.attributes?.find(
           (attr) => attr.type === "mdxJsxAttribute" && attr.name === "packages"
@@ -5982,6 +5798,37 @@ function getPath(obj, path) {
     obj
   );
 }
+function escapeText(value) {
+  return value.replace(/\n/g, " ");
+}
+function propsToDefinitionList(props) {
+  if (props.length === 0) {
+    return "";
+  }
+  return props.map((prop) => {
+    const parts = [`- **${prop.name}** (\`${escapeText(prop.type)}\``];
+    if (prop.defaultValue) {
+      parts.push(`, default: \`${escapeText(prop.defaultValue)}\``);
+    }
+    if (prop.required) {
+      parts.push(", required");
+    }
+    parts.push(")");
+    if (prop.description) {
+      parts.push(` - ${escapeText(prop.description)}`);
+    }
+    return parts.join("");
+  }).join("\n");
+}
+function themeDataToJson(data, cssPropertyName) {
+  if (!data || typeof data !== "object") {
+    return "";
+  }
+  if (cssPropertyName) {
+    return JSON.stringify({ cssProperty: cssPropertyName, data }, null, 2);
+  }
+  return JSON.stringify(data, null, 2);
+}
 var KnowledgeGenerator = class {
   config;
   docProps = null;
@@ -6003,7 +5850,7 @@ var KnowledgeGenerator = class {
     this.docProps = docProps;
     if (pages.length === 0) {
       console.log("No pages found.");
-      return;
+      return [];
     }
     if (this.config.verbose) {
       console.log(`Found ${pages.length} page(s)`);
@@ -6011,7 +5858,7 @@ var KnowledgeGenerator = class {
     const processedPages = [];
     for (const page of pages) {
       try {
-        const processed = await this.processComponent(page);
+        const processed = await this.processMdxPage(page);
         processedPages.push(processed);
       } catch (error) {
         console.error(`Failed to process page: ${page.name}`);
@@ -6036,9 +5883,10 @@ var KnowledgeGenerator = class {
       );
       await this.generateExtraFiles(extractedMetadata);
     }
+    return pages;
   }
   async loadDocProps() {
-    const resolvedDocPropsPath = this.config.docPropsPath ? await exists(this.config.docPropsPath) ? this.config.docPropsPath : resolve5(process.cwd(), this.config.docPropsPath) : join3(dirname(this.config.routeDir), "doc-props.json");
+    const resolvedDocPropsPath = this.config.docPropsPath ? await exists(this.config.docPropsPath) ? this.config.docPropsPath : resolve4(process.cwd(), this.config.docPropsPath) : join3(dirname(this.config.routeDir), "doc-props.json");
     if (!await exists(resolvedDocPropsPath)) {
       if (this.config.verbose) {
         console.log(`Doc props file not found at: ${resolvedDocPropsPath}`);
@@ -6097,10 +5945,11 @@ var KnowledgeGenerator = class {
         const url = getPathnameFromPathSegments(segments);
         components.push({
           demosFolder: demosFolderPath,
+          filePath: dirPath,
           id: segments.join("-").trim(),
           mdxFile: join3(dirPath, mdxFile.name),
           name: segments.at(-1),
-          path: dirPath,
+          pathname: url,
           url: this.config.baseUrl ? new URL(url, this.config.baseUrl).toString() : void 0
         });
         if (this.config.verbose) {
@@ -6120,7 +5969,7 @@ var KnowledgeGenerator = class {
     return components;
   }
   async collectRelativeImports(filePath, visited = /* @__PURE__ */ new Set()) {
-    const normalizedPath = resolve5(filePath);
+    const normalizedPath = resolve4(filePath);
     if (visited.has(normalizedPath)) {
       return [];
     }
@@ -6228,7 +6077,9 @@ ${codeText}
           }
         default:
           if (this.config.outputMode === "per-page" && "tag" in part && part.tag === "@link" && typeof part.target === "string") {
-            return `[${part.text}](${part.target})`;
+            if (part.text === "Learn more") {
+              return "";
+            }
           }
           return part.text;
       }
@@ -6247,8 +6098,8 @@ ${codeText}
     };
   }
   /**
-   * Creates a remark plugin that replaces TypeDocProps JSX elements with JSON
-   * code blocks containing component prop documentation.
+   * Creates a remark plugin that replaces theme JSX elements with
+   * markdown tables containing theme data.
    */
   async replaceThemeNodes() {
     let themes = null;
@@ -6275,7 +6126,7 @@ ${codeText}
       }
     };
     return () => (tree, _file, done) => {
-      visit8(tree, "mdxJsxFlowElement", (node) => {
+      visit5(tree, "mdxJsxFlowElement", (node) => {
         const handler = node.name && handlers[node.name];
         if (!handler) {
           return;
@@ -6285,11 +6136,21 @@ ${codeText}
           console.warn(`No theme data for ${node.name}`);
           return;
         }
+        let markdownTable;
+        if (typeof data === "object" && data !== null && "cssPropertyName" in data && "data" in data) {
+          const { cssPropertyName, data: themeData } = data;
+          markdownTable = themeDataToJson(themeData, cssPropertyName);
+        } else {
+          markdownTable = themeDataToJson(data);
+        }
+        if (!markdownTable) {
+          return;
+        }
         Object.assign(node, {
           lang: "json",
           meta: null,
           type: "code",
-          value: JSON.stringify(data, null, 2)
+          value: markdownTable
         });
       });
       done();
@@ -6310,12 +6171,30 @@ ${codeText}
     return null;
   }
   /**
-   * Creates a remark plugin that replaces TypeDocProps JSX elements with JSON
-   * code blocks containing component prop documentation.
+   * Creates a remark plugin that transforms relative URLs to absolute URLs.
+   */
+  transformRelativeUrls(pageUrl) {
+    const baseUrl = this.config.baseUrl;
+    return () => (tree) => {
+      if (!baseUrl || this.config.outputMode !== "per-page") {
+        return;
+      }
+      visit5(tree, "link", (node) => {
+        if (node.url.startsWith("/")) {
+          node.url = `${baseUrl}${node.url}`;
+        } else if (node.url.startsWith("./#") && pageUrl) {
+          node.url = `${pageUrl}${node.url.slice(2)}`;
+        }
+      });
+    };
+  }
+  /**
+   * Creates a remark plugin that replaces TypeDocProps JSX elements with
+   * markdown tables containing component prop documentation.
    */
   replaceTypeDocProps() {
     return () => (tree, _file, done) => {
-      visit8(
+      visit5(
         tree,
         "mdxJsxFlowElement",
         (node, index, parent) => {
@@ -6358,11 +6237,35 @@ ${codeText}
               `  Replaced TypeDocProps ${propsName} with API documentation`
             );
           }
+          const regularProps = propsDoc.filter((p) => p.propType === void 0);
+          const inputs = propsDoc.filter((p) => p.propType === "input");
+          const outputs = propsDoc.filter((p) => p.propType === "output");
+          const sections = [];
+          if (regularProps.length > 0) {
+            sections.push(propsToDefinitionList(regularProps));
+          }
+          if (inputs.length > 0) {
+            sections.push(`**Inputs**
+
+${propsToDefinitionList(inputs)}`);
+          }
+          if (outputs.length > 0) {
+            sections.push(`**Outputs**
+
+${propsToDefinitionList(outputs)}`);
+          }
+          const markdownContent = sections.join("\n\n");
+          if (!markdownContent) {
+            if (parent && index !== void 0) {
+              parent.children.splice(index, 1);
+            }
+            return;
+          }
           Object.assign(node, {
-            lang: "json",
+            lang: null,
             meta: null,
             type: "code",
-            value: JSON.stringify(propsDoc, null, 2)
+            value: markdownContent
           });
         }
       );
@@ -6376,7 +6279,7 @@ ${codeText}
   replaceDemos(demosFolder, demoFiles) {
     return () => async (tree) => {
       const promises = [];
-      visit8(
+      visit5(
         tree,
         "mdxJsxFlowElement",
         (node, index, parent) => {
@@ -6464,9 +6367,9 @@ ${codeText}
       await Promise.all(promises);
     };
   }
-  replaceFrontmatterDescription(frontmatter) {
+  replaceFrontmatterExpressions(frontmatter) {
     return () => (tree) => {
-      visit8(
+      visit5(
         tree,
         "mdxFlowExpression",
         (node, index, parent) => {
@@ -6483,6 +6386,18 @@ ${codeText}
           }
         }
       );
+      const root = tree;
+      const h1Index = root.children.findIndex((node) => {
+        if (node.type !== "heading" || node.depth !== 1) {
+          return false;
+        }
+        return node.children?.some(
+          (child) => child.type === "mdxTextExpression" && child.value?.includes("frontmatter")
+        );
+      });
+      if (h1Index >= 0) {
+        root.children.splice(h1Index, 1);
+      }
     };
   }
   /**
@@ -6491,57 +6406,41 @@ ${codeText}
    */
   async processMdxContent(mdxContent, pageUrl, demosFolder, frontmatter) {
     const demoFiles = [];
-    let processedContent = mdxContent;
-    const lines = processedContent.split("\n");
-    const titleLine = lines.findIndex((line) => line.startsWith("# "));
-    processedContent = titleLine >= 0 ? lines.slice(titleLine + 1).join("\n") : processedContent;
-    processedContent = processedContent.replace(
-      /\[([^\]]+)\]\(\.\/#([^)]+)\)/g,
-      (_, text, anchor) => pageUrl && this.config.outputMode === "per-page" ? `[${text}](${pageUrl}#${anchor})` : text
-    );
-    const processor = unified4().use(remarkParse4).use(remarkMdx3).use(this.replaceTypeDocProps()).use(this.replaceFrontmatterDescription(frontmatter)).use(await this.replaceThemeNodes()).use(this.replaceDemos(demosFolder, demoFiles)).use(remarkStringify3);
-    const processed = await processor.process(processedContent);
-    processedContent = String(processed);
-    processedContent = processedContent.replace(/\n\s*\n\s*\n/g, "\n\n");
+    const processor = unified4().use(remarkParse4).use(remarkMdx3).use(remarkFrontmatter2, ["yaml"]).use(this.replaceTypeDocProps()).use(this.replaceFrontmatterExpressions(frontmatter)).use(await this.replaceThemeNodes()).use(this.replaceDemos(demosFolder, demoFiles)).use(this.transformRelativeUrls(pageUrl)).use(remarkStringify3);
+    const processed = await processor.process(mdxContent);
+    const processedContent = String(processed).replace(/\n\s*\n\s*\n/g, "\n\n");
     return { content: processedContent, demoFiles };
   }
-  async processComponent(component) {
+  async processMdxPage(pageInfo) {
     try {
-      const mdxContent = await readFile(component.mdxFile, "utf-8");
+      const mdxContent = await readFile(pageInfo.mdxFile, "utf-8");
       if (this.config.verbose) {
-        console.log(`Processing page: ${component.name}`);
-      }
-      const processor = unified4().use(remarkParse4).use(remarkMdx3).use(replaceNpmInstallTabs).use(remarkFrontmatter3, ["yaml"]).use(remarkParseFrontmatter2);
-      if (this.config.outputMode === "per-page") {
-        processor.use(remarkSelfLinkHeadings(component.url));
+        console.log(`Processing page: ${pageInfo.name}`);
       }
-      processor.use(remarkStringify3);
+      const processor = unified4().use(remarkParse4).use(remarkMdx3).use(replaceNpmInstallTabs).use(remarkFrontmatter2, ["yaml"]).use(remarkParseFrontmatter2).use(remarkStringify3);
       const parsed = await processor.process(mdxContent);
       const frontmatter = parsed.data?.frontmatter || {};
       const { content: processedContent, demoFiles } = await this.processMdxContent(
         String(parsed),
-        component.url,
-        component.demosFolder,
+        pageInfo.url,
+        pageInfo.demosFolder,
         frontmatter
       );
-      const removeJsxProcessor = unified4().use(remarkParse4).use(remarkMdx3).use(remarkRemoveJsx).use(remarkStringify3);
+      const removeJsxProcessor = unified4().use(remarkParse4).use(remarkMdx3).use(remarkFrontmatter2, ["yaml"]).use(remarkRemoveJsx).use(remarkStringify3);
       const removedJsx = String(
         await removeJsxProcessor.process(processedContent)
       );
-      const contentWithoutFrontmatter = removedJsx.replace(
-        /^---[\s\S]*?---\n/,
-        ""
-      );
-      const title = frontmatter.title || component.name;
+      const contentWithoutFrontmatter = removedJsx.replace(/^---[\s\S]*?---\n/, "").replace(/(^#{1,6} .*\\<[^>]+)>/gm, "$1\\>");
+      const title = frontmatter.title || pageInfo.name;
       return {
         content: contentWithoutFrontmatter.trim(),
         demoFiles,
         frontmatter,
         title,
-        url: component.url
+        url: pageInfo.url
       };
     } catch (error) {
-      console.error(`Error processing component ${component.name}:`, error);
+      console.error(`Error processing component ${pageInfo.name}:`, error);
       throw error;
     }
   }
@@ -6589,6 +6488,11 @@ ${codeText}
     let totalSize = 0;
     await Promise.all(
       extraFiles.map(async (extraFile) => {
+        let contents = extraFile.contents;
+        if (extraFile.processAsMdx) {
+          const removeJsxProcessor = unified4().use(remarkParse4).use(remarkMdx3).use(remarkFrontmatter2, ["yaml"]).use(remarkRemoveJsx).use(this.transformRelativeUrls()).use(remarkStringify3);
+          contents = String(await removeJsxProcessor.process(contents));
+        }
         const lines = [];
         if (metadata.length) {
           lines.push("---");
@@ -6598,11 +6502,13 @@ ${codeText}
           lines.push("---");
           lines.push("");
         }
-        lines.push(`# ${extraFile.title}`);
-        lines.push("");
-        lines.push(extraFile.contents);
+        if (extraFile.title) {
+          lines.push(`# ${extraFile.title}`);
+          lines.push("");
+        }
+        lines.push(contents);
         lines.push("");
-        const outfile = `${resolve5(this.config.outputPath)}/${kebabCase(extraFile.id)}.md`;
+        const outfile = `${resolve4(this.config.outputPath)}/${kebabCase(extraFile.id)}.md`;
         await writeFile3(outfile, lines.join("\n"), "utf-8");
         const stats = await stat(outfile);
         totalSize += stats.size / 1024;
@@ -6642,6 +6548,10 @@ ${codeText}
           page.name = processedPage.frontmatter.title;
         }
         let content = processedPage.content;
+        content = content.replace(
+          new RegExp(`^# ${processedPage.title}\\n+`, ""),
+          ""
+        );
         if (this.config.pageTitlePrefix) {
           content = content.replace(
             `# ${page.name}`,
@@ -6687,7 +6597,7 @@ ${codeText}
             }
           }
         }
-        const outfile = `${resolve5(this.config.outputPath)}/${kebabCase(page.id || page.name)}.md`;
+        const outfile = `${resolve4(this.config.outputPath)}/${kebabCase(page.id || page.name)}.md`;
         await writeFile3(outfile, lines.join("\n"), "utf-8");
         const stats = await stat(outfile);
         totalSize += stats.size / 1024;
@@ -6699,7 +6609,7 @@ ${codeText}
 };
 async function generate(config2) {
   const generator = new KnowledgeGenerator(config2);
-  await generator.run();
+  return generator.run();
 }
 function addGenerateKnowledgeCommand() {
   program.description("Generate llms.txt from QUI Docs documentation").command("generate-llms-txt").option("-n, --name <name>", "Project name for llms.txt header").requiredOption("-m, --output-mode <outputMode>").option("-o, --outputPath <outputPath>", "Output file or directory.").option(
@@ -6723,7 +6633,7 @@ function addGenerateKnowledgeCommand() {
 import { createHash as createHash2 } from "node:crypto";
 import { writeFileSync } from "node:fs";
 import { access as access2, readdir as readdir2, readFile as readFile2, stat as stat2 } from "node:fs/promises";
-import { resolve as resolve6 } from "node:path";
+import { resolve as resolve5 } from "node:path";
 import { setTimeout as setTimeout2 } from "node:timers/promises";
 import ora from "ora";
 
@@ -6853,7 +6763,7 @@ var Uploader = class {
     const files = await Promise.all(
       fileNames.map(async (name) => ({
         contents: await readFile2(
-          resolve6(this.config.knowledgeFilePath, name),
+          resolve5(this.config.knowledgeFilePath, name),
           "utf-8"
         ),
         name
@@ -6902,7 +6812,7 @@ var Uploader = class {
       try {
         const fileId = knowledgeFile.id;
         const fileString = await readFile2(
-          resolve6(this.config.knowledgeFilePath, name),
+          resolve5(this.config.knowledgeFilePath, name),
           "utf-8"
         );
         const spinner2 = ora(`Updating ${name}`).start();
@@ -6917,7 +6827,7 @@ var Uploader = class {
     }
     const spinner = ora(`Uploading ${name}`).start();
     const fileBuffer = await readFile2(
-      resolve6(this.config.knowledgeFilePath, name)
+      resolve5(this.config.knowledgeFilePath, name)
     );
     let uploadedFileId = void 0;
     try {
@@ -6955,7 +6865,7 @@ var Uploader = class {
     }
   }
   async uploadKnowledge() {
-    const resolvedPath = resolve6(this.config.knowledgeFilePath);
+    const resolvedPath = resolve5(this.config.knowledgeFilePath);
     if (!await access2(resolvedPath).then(() => true).catch(() => false)) {
       throw new Error(`File or folder not found at ${resolvedPath}`);
     }
@@ -6995,7 +6905,7 @@ function addUploadKnowledgeCommand() {
     const files = await uploader.filesApi.search("*");
     console.debug(`found ${files.length} files`);
     writeFileSync(
-      resolve6(uploader.config.knowledgeFilePath, "files.json"),
+      resolve5(uploader.config.knowledgeFilePath, "files.json"),
       JSON.stringify(files, null, 2),
       "utf-8"
     );
@@ -7038,16 +6948,16 @@ function addUploadKnowledgeCommand() {
 }
 
 // src/react-demo-plugin/generate-lazy-demo-map.ts
-import { glob as glob3 } from "glob";
+import { glob as glob2 } from "glob";
 import { uniqBy } from "lodash-es";
 import { writeFile as writeFile4 } from "node:fs/promises";
-import { resolve as resolve8 } from "node:path";
-import { dedent as dedent2 } from "@qualcomm-ui/utils/dedent";
+import { resolve as resolve7 } 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 as relative3, resolve as resolve7, sep } from "node:path";
+import chalk3 from "chalk";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { dirname as dirname2, join as join4, relative as relative3, resolve as resolve6, sep } from "node:path";
 import * as ts from "typescript";
 import { pascalCase } from "@qualcomm-ui/utils/change-case";
 function extractPageId(filePath, routesDir) {
@@ -7061,7 +6971,7 @@ function extractPageId(filePath, routesDir) {
 }
 function isDemoFile(filePath) {
   try {
-    return filePath.includes("/demos/") && filePath.endsWith(".tsx") && !readFileSync3(filePath).includes("export default");
+    return filePath.includes("/demos/") && filePath.endsWith(".tsx") && !readFileSync2(filePath).includes("export default");
   } catch (error) {
     return false;
   }
@@ -7072,7 +6982,7 @@ async function scanForDemoPages({
   demoPattern = "src/routes/**/demos/*.tsx",
   routesDir = "src/routes"
 }) {
-  const demoFiles = (await glob3(demoPattern)).filter((file) => isDemoFile(file));
+  const demoFiles = (await glob2(demoPattern)).filter((file) => isDemoFile(file));
   return uniqBy(
     demoFiles.map((file) => ({
       pageId: extractPageId(file, routesDir),
@@ -7086,7 +6996,7 @@ function generateLazyDemoLoader(demoPages) {
     return `  "${routePath}": () =>
     import("virtual:qui-demo-scope/page:${pageId}")`;
   }).sort().join(",\n");
-  return dedent2`
+  return dedent`
     /* eslint-disable */
 
     // This file is generated automatically. Don't edit it directly.
@@ -7104,7 +7014,7 @@ function generateLazyDemoLoader(demoPages) {
 }
 async function generateLazyDemoMap(options) {
   const routesDir = options.routesDir;
-  const outputPath = resolve8(options.output);
+  const outputPath = resolve7(options.output);
   console.log(`Scanning for demo pages in: ${routesDir}`);
   const demoPages = await scanForDemoPages({ routesDir });
   console.log(`Found ${demoPages.length} pages with demos`);