@qualcomm-ui/mdx-vite 2.16.2 → 2.17.1

package/dist/cli.js

@@ -520,9 +520,9 @@ var require_help = __commonJS({
        * @param {Help} helper
        * @returns string[]
        */
-      formatItemList(heading, items, helper) {
+      formatItemList(heading2, items, helper) {
         if (items.length === 0) return [];
-        return [helper.styleTitle(heading), ...items, ""];
+        return [helper.styleTitle(heading2), ...items, ""];
       }
       /**
        * Group items by their help group heading.
@@ -1002,8 +1002,8 @@ var require_option = __commonJS({
        * @param {string} heading
        * @return {Option}
        */
-      helpGroup(heading) {
-        this.helpGroupHeading = heading;
+      helpGroup(heading2) {
+        this.helpGroupHeading = heading2;
         return this;
       }
       /**
@@ -3099,9 +3099,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [heading]
        * @return {Command | string}
        */
-      helpGroup(heading) {
-        if (heading === void 0) return this._helpGroupHeading ?? "";
-        this._helpGroupHeading = heading;
+      helpGroup(heading2) {
+        if (heading2 === void 0) return this._helpGroupHeading ?? "";
+        this._helpGroupHeading = heading2;
         return this;
       }
       /**
@@ -3117,9 +3117,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [heading]
        * @returns {Command | string}
        */
-      commandsGroup(heading) {
-        if (heading === void 0) return this._defaultCommandGroup ?? "";
-        this._defaultCommandGroup = heading;
+      commandsGroup(heading2) {
+        if (heading2 === void 0) return this._defaultCommandGroup ?? "";
+        this._defaultCommandGroup = heading2;
         return this;
       }
       /**
@@ -3135,9 +3135,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [heading]
        * @returns {Command | string}
        */
-      optionsGroup(heading) {
-        if (heading === void 0) return this._defaultOptionGroup ?? "";
-        this._defaultOptionGroup = heading;
+      optionsGroup(heading2) {
+        if (heading2 === void 0) return this._defaultOptionGroup ?? "";
+        this._defaultOptionGroup = heading2;
         return this;
       }
       /**
@@ -3921,7 +3921,7 @@ var DocPropsIndexer = class {
   }
   assembleProp(prop, id) {
     const name = prop.name;
-    const heading = {
+    const heading2 = {
       headingLevel: 4,
       id,
       tagName: "a",
@@ -3929,7 +3929,7 @@ var DocPropsIndexer = class {
     };
     const comment = prop.comment;
     if (!comment) {
-      return { content: [], heading, richContent: [] };
+      return { content: [], heading: heading2, richContent: [] };
     }
     const content = {
       tagName: "p",
@@ -3937,7 +3937,7 @@ var DocPropsIndexer = class {
         comment.summary.map((entry) => entry.text.replaceAll("\n", " ")).join("")
       ]
     };
-    return { content: [content], heading, richContent: [] };
+    return { content: [content], heading: heading2, richContent: [] };
   }
 };
 
@@ -4404,8 +4404,109 @@ var alertToEmphasis = {
   warning: "warning"
 };
 
+// src/docs-plugin/remark/remark-extract-meta.ts
+import { SKIP, visit as visit4 } from "unist-util-visit";
+function parseValue(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+    const inner = trimmed.slice(1, -1);
+    return inner.split(",").map((item) => item.trim()).filter(Boolean);
+  }
+  return trimmed;
+}
+function parseMetaContent(content) {
+  const result = {};
+  const lines = content.split("\n");
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed === ":::") {
+      continue;
+    }
+    const colonIndex = trimmed.indexOf(":");
+    if (colonIndex === -1) {
+      continue;
+    }
+    const key = trimmed.slice(0, colonIndex).trim();
+    const value = trimmed.slice(colonIndex + 1).trim();
+    if (key && value) {
+      result[key] = parseValue(value);
+    }
+  }
+  return result;
+}
+function parseTermsContent(content) {
+  return content.split("\n").map((line) => line.trim()).filter((line) => line && line !== ":::");
+}
+var remarkExtractMeta = (metadata = {}) => {
+  return (tree) => {
+    const nodesToRemove = [];
+    visit4(tree, "paragraph", (node, index, parent) => {
+      if (!parent || index === void 0) {
+        return;
+      }
+      const firstChild = node.children[0];
+      if (firstChild?.type !== "text") {
+        return;
+      }
+      const text = firstChild.value;
+      const metaMatch = text.match(/^:::\s*meta\s*/);
+      const termsMatch = text.match(/^:::\s*terms\s*/);
+      if (!metaMatch && !termsMatch) {
+        return;
+      }
+      const openMatch = metaMatch || termsMatch;
+      const isTermsBlock = !!termsMatch;
+      if (text.includes(":::") && text.lastIndexOf(":::") > openMatch[0].length) {
+        const afterOpen = text.slice(openMatch[0].length);
+        const closeIndex = afterOpen.lastIndexOf(":::");
+        const content = afterOpen.slice(0, closeIndex);
+        if (isTermsBlock) {
+          const terms = parseTermsContent(content);
+          if (terms.length > 0) {
+            const existing = metadata.terms;
+            metadata.terms = Array.isArray(existing) ? [...existing, ...terms] : terms;
+          }
+        } else {
+          const parsed = parseMetaContent(content);
+          Object.assign(metadata, parsed);
+        }
+        nodesToRemove.push({ index, parent });
+        return SKIP;
+      }
+      let fullText = text;
+      for (let i = 1; i < node.children.length; i++) {
+        const child = node.children[i];
+        if (child.type === "text") {
+          fullText += child.value;
+        }
+      }
+      const afterOpenFull = fullText.slice(openMatch[0].length);
+      const closeIndexFull = afterOpenFull.lastIndexOf(":::");
+      if (closeIndexFull !== -1) {
+        const content = afterOpenFull.slice(0, closeIndexFull);
+        if (isTermsBlock) {
+          const terms = parseTermsContent(content);
+          if (terms.length > 0) {
+            const existing = metadata.terms;
+            metadata.terms = Array.isArray(existing) ? [...existing, ...terms] : terms;
+          }
+        } else {
+          const parsed = parseMetaContent(content);
+          Object.assign(metadata, parsed);
+        }
+        nodesToRemove.push({ index, parent });
+        return SKIP;
+      }
+    });
+    for (let i = nodesToRemove.length - 1; i >= 0; i--) {
+      const { index, parent } = nodesToRemove[i];
+      parent.children.splice(index, 1);
+    }
+  };
+};
+
 // src/docs-plugin/remark/remark-frontmatter-interpolation.ts
-import { visit as visit4 } from "unist-util-visit";
+import { visit as visit5 } from "unist-util-visit";
 var FRONTMATTER_PATTERN = /^\s*frontmatter\.(\w+)\s*$/;
 function isMdxExpression(node) {
   const n = node;
@@ -4413,7 +4514,7 @@ function isMdxExpression(node) {
 }
 var remarkFrontmatterInterpolation = (frontmatter) => {
   return (tree) => {
-    visit4(tree, (node, index, parent) => {
+    visit5(tree, (node, index, parent) => {
       if (!isMdxExpression(node) || index === void 0 || !parent) {
         return;
       }
@@ -4479,8 +4580,8 @@ var MarkdownIndexer = class {
     this.resetSection();
     this.headingLevels = headingLevels;
   }
-  appendTocItem(heading) {
-    this._toc.push(heading);
+  appendTocItem(heading2) {
+    this._toc.push(heading2);
   }
   warn(...data) {
     if (process.env.DEBUG) {
@@ -4515,11 +4616,11 @@ var MarkdownIndexer = class {
         this.sections.push(clone(this.currentSection));
         this.resetSection();
       }
-      const heading = this.parseHeading(element);
+      const heading2 = this.parseHeading(element);
       if (!isRootHeading) {
-        this.appendTocItem(heading);
+        this.appendTocItem(heading2);
       }
-      this.currentSection.heading = heading;
+      this.currentSection.heading = heading2;
       return;
     }
     this.currentSection.richContent.push(element);
@@ -4532,7 +4633,7 @@ var MarkdownIndexer = class {
     }
   }
   parseMarkdown(fileContents, frontmatter) {
-    const file = unified3().use(remarkMdx2).use(remarkRemoveJsx).use(remarkRemoveMermaidCodeBlocks).use(remarkParse3).use(remarkGfm).use(remarkAlerts).use(remarkFrontmatterInterpolation, frontmatter).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(remarkExtractMeta, {}).use(remarkRehype).use(rehypeStringify).processSync(fileContents);
     let contents = file.toString();
     contents = contents.substring(contents.indexOf("<h1>"));
     const htmlAst = unified3().data("settings", { fragment: true }).use(rehypeParse).use(rehypeStringify).use(rehypeSlug).processSync(contents);
@@ -4901,7 +5002,7 @@ function getRemixFlatRoutesSegments(name, index, paramPrefixChar = "$") {
   let routeSegments = [];
   let i = 0;
   let routeSegment = "";
-  let state = "START";
+  let state2 = "START";
   let subState = "NORMAL";
   let hasPlus = false;
   if (name.endsWith("_layout")) {
@@ -4928,7 +5029,7 @@ function getRemixFlatRoutesSegments(name, index, paramPrefixChar = "$") {
   };
   while (i < name.length) {
     const char = name[i];
-    switch (state) {
+    switch (state2) {
       case "START":
         if (routeSegment.includes(paramPrefixChar) && !(routeSegment.startsWith(paramPrefixChar) || routeSegment.startsWith(`(${paramPrefixChar}`))) {
           throw new Error(
@@ -4942,12 +5043,12 @@ function getRemixFlatRoutesSegments(name, index, paramPrefixChar = "$") {
         }
         pushRouteSegment(routeSegment);
         routeSegment = "";
-        state = "PATH";
+        state2 = "PATH";
         continue;
       // restart without advancing index
       case "PATH":
         if (isPathSeparator(char) && subState === "NORMAL") {
-          state = "START";
+          state2 = "START";
           break;
         } else if (char === "[") {
           subState = "ESCAPE";
@@ -5398,120 +5499,19 @@ function loadEnvironmentConfigs(options = {}) {
 
 // src/ai-knowledge/generator/knowledge-generator.ts
 import AdmZip from "adm-zip";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import { minimatch } from "minimatch";
 import { mkdir, readdir, readFile as readFile4, rm, stat, writeFile } from "node:fs/promises";
-import { basename as basename2, dirname as dirname3, join as join6, relative as relative2, resolve as resolve4 } from "node:path";
-import remarkFrontmatter2 from "remark-frontmatter";
+import { basename as basename2, dirname as dirname3, join as join7, relative as relative2, resolve as resolve5 } from "node:path";
+import remarkFrontmatter3 from "remark-frontmatter";
 import remarkMdx3 from "remark-mdx";
 import remarkParse4 from "remark-parse";
 import remarkParseFrontmatter2 from "remark-parse-frontmatter";
 import remarkStringify4 from "remark-stringify";
 import { unified as unified5 } from "unified";
-import { visit as visit11 } from "unist-util-visit";
+import { visit as visit18 } from "unist-util-visit";
 import { kebabCase as kebabCase3 } from "@qualcomm-ui/utils/change-case";
 
-// src/docs-plugin/remark/remark-extract-meta.ts
-import { SKIP, visit as visit5 } from "unist-util-visit";
-function parseValue(value) {
-  const trimmed = value.trim();
-  if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
-    const inner = trimmed.slice(1, -1);
-    return inner.split(",").map((item) => item.trim()).filter(Boolean);
-  }
-  return trimmed;
-}
-function parseMetaContent(content) {
-  const result = {};
-  const lines = content.split("\n");
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed === ":::") {
-      continue;
-    }
-    const colonIndex = trimmed.indexOf(":");
-    if (colonIndex === -1) {
-      continue;
-    }
-    const key = trimmed.slice(0, colonIndex).trim();
-    const value = trimmed.slice(colonIndex + 1).trim();
-    if (key && value) {
-      result[key] = parseValue(value);
-    }
-  }
-  return result;
-}
-function parseTermsContent(content) {
-  return content.split("\n").map((line) => line.trim()).filter((line) => line && line !== ":::");
-}
-var remarkExtractMeta = (metadata = {}) => {
-  return (tree) => {
-    const nodesToRemove = [];
-    visit5(tree, "paragraph", (node, index, parent) => {
-      if (!parent || index === void 0) {
-        return;
-      }
-      const firstChild = node.children[0];
-      if (firstChild?.type !== "text") {
-        return;
-      }
-      const text = firstChild.value;
-      const metaMatch = text.match(/^:::\s*meta\s*/);
-      const termsMatch = text.match(/^:::\s*terms\s*/);
-      if (!metaMatch && !termsMatch) {
-        return;
-      }
-      const openMatch = metaMatch || termsMatch;
-      const isTermsBlock = !!termsMatch;
-      if (text.includes(":::") && text.lastIndexOf(":::") > openMatch[0].length) {
-        const afterOpen = text.slice(openMatch[0].length);
-        const closeIndex = afterOpen.lastIndexOf(":::");
-        const content = afterOpen.slice(0, closeIndex);
-        if (isTermsBlock) {
-          const terms = parseTermsContent(content);
-          if (terms.length > 0) {
-            const existing = metadata.terms;
-            metadata.terms = Array.isArray(existing) ? [...existing, ...terms] : terms;
-          }
-        } else {
-          const parsed = parseMetaContent(content);
-          Object.assign(metadata, parsed);
-        }
-        nodesToRemove.push({ index, parent });
-        return SKIP;
-      }
-      let fullText = text;
-      for (let i = 1; i < node.children.length; i++) {
-        const child = node.children[i];
-        if (child.type === "text") {
-          fullText += child.value;
-        }
-      }
-      const afterOpenFull = fullText.slice(openMatch[0].length);
-      const closeIndexFull = afterOpenFull.lastIndexOf(":::");
-      if (closeIndexFull !== -1) {
-        const content = afterOpenFull.slice(0, closeIndexFull);
-        if (isTermsBlock) {
-          const terms = parseTermsContent(content);
-          if (terms.length > 0) {
-            const existing = metadata.terms;
-            metadata.terms = Array.isArray(existing) ? [...existing, ...terms] : terms;
-          }
-        } else {
-          const parsed = parseMetaContent(content);
-          Object.assign(metadata, parsed);
-        }
-        nodesToRemove.push({ index, parent });
-        return SKIP;
-      }
-    });
-    for (let i = nodesToRemove.length - 1; i >= 0; i--) {
-      const { index, parent } = nodesToRemove[i];
-      parent.children.splice(index, 1);
-    }
-  };
-};
-
 // src/ai-knowledge/generator/config.ts
 var currentConfig = null;
 function setConfig(config3) {
@@ -5997,11 +5997,292 @@ ${propsToDefinitionList(outputs)}`);
   }
 };
 
-// src/ai-knowledge/generator/npm-install-tabs-plugin.ts
+// src/ai-knowledge/generator/filter-text-directives.ts
+import { visit as visit14 } from "unist-util-visit";
+
+// src/docs-plugin/docs-plugin.ts
+import chalk3 from "chalk";
+import chokidar from "chokidar";
+import { glob } from "glob";
+import { readFileSync as readFileSync2 } from "node:fs";
+import { join as join6, resolve as resolve4 } 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;
+  config = null;
+  configFilePath = "";
+  docPropsFilePath = "";
+  exports = { basePath: "", enabled: false, pages: [] };
+  indexer;
+  configLoader = null;
+  knowledgeConfig = void 0;
+  routesDir;
+  servers = [];
+  timeout = void 0;
+  exportsTimeout = void 0;
+  watching = false;
+  cwd;
+  init(cwd2) {
+    this.cwd = cwd2;
+  }
+  getCwd() {
+    return this.cwd;
+  }
+  get docPropsDirectory() {
+    if (!this.docPropsFilePath) {
+      return "";
+    }
+    return this.docPropsFilePath.substring(
+      0,
+      this.docPropsFilePath.lastIndexOf("/")
+    );
+  }
+  get siteData() {
+    const { filePath: _filePath, ...config3 } = this.config ?? {};
+    return {
+      config: config3,
+      exports: this.exports,
+      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(config3) {
+    this.config = config3;
+    this.configFilePath = config3.filePath;
+    this.docPropsFilePath = config3.typeDocProps ? fixPath(resolve4(this.cwd, config3.typeDocProps)) : "";
+    this.routesDir = fixPath(resolve4(config3.appDirectory, config3.pageDirectory));
+    this.knowledgeConfig = config3.knowledge;
+    this.indexer = new SearchIndexer({
+      ...config3,
+      srcDir: fixPath(resolve4(this.cwd, config3.appDirectory)),
+      typeDocProps: this.resolveDocProps()
+    });
+    const exportsConfig = config3.knowledge?.global?.exports;
+    const exportsEnabled = exportsConfig?.enabled ?? false;
+    const exportsPath = exportsConfig?.staticPath ?? "exports/md";
+    this.exports = {
+      basePath: exportsEnabled ? `/${exportsPath}` : "",
+      enabled: exportsEnabled,
+      pages: []
+    };
+  }
+  buildIndex(shouldLog) {
+    const files = glob.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" })
+          );
+        }
+      });
+    });
+  }
+  async generateExports(publicDir) {
+    if (!this.exports.enabled || !this.knowledgeConfig?.global) {
+      return;
+    }
+    const globalConfig = this.knowledgeConfig.global;
+    const exportsConfig = globalConfig.exports ?? {};
+    const exportsPath = exportsConfig.staticPath ?? "exports/md";
+    const outputPath = join6(publicDir, exportsPath);
+    const manifestPath = exportsConfig.manifestPath ?? "exports";
+    const manifestOutputPath = join6(publicDir, manifestPath);
+    const startTime = Date.now();
+    const pageIds = await generate({
+      baseUrl: globalConfig.baseUrl,
+      clean: true,
+      docPropsPath: this.docPropsFilePath || void 0,
+      exclude: exportsConfig.exclude ?? globalConfig.exclude,
+      extraFiles: exportsConfig.extraFiles ?? globalConfig.extraFiles,
+      frontmatter: exportsConfig.frontmatter ?? globalConfig.frontmatter,
+      generateBulkZip: exportsConfig.generateBulkZip ?? true,
+      generateManifest: exportsConfig.generateManifest ?? true,
+      manifestOutputPath,
+      metadata: exportsConfig.metadata ?? globalConfig.metadata,
+      outputMode: "per-page",
+      outputPath,
+      pageTitlePrefix: exportsConfig.pageTitlePrefix ?? globalConfig.pageTitlePrefix,
+      routeDir: this.routesDir,
+      sections: exportsConfig.sections
+    });
+    this.exports.pages = pageIds;
+    console.debug(
+      `${chalk3.magenta.bold(`@qualcomm-ui/mdx-vite/docs-plugin:`)} Generated Markdown exports in: ${chalk3.blueBright.bold(prettyMilliseconds(Date.now() - startTime))}`
+    );
+  }
+  debouncedGenerateExports(publicDir) {
+    if (!this.exports.enabled) {
+      return;
+    }
+    clearTimeout(this.exportsTimeout);
+    this.exportsTimeout = setTimeout(() => {
+      void this.generateExports(publicDir);
+    }, 500);
+  }
+};
+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 visit8 } from "unist-util-visit";
+
+// src/docs-plugin/remark/remark-frontmatter-description.ts
+import { visit as visit9 } from "unist-util-visit";
+
+// src/docs-plugin/remark/remark-frontmatter-title.ts
+import { visit as visit10 } 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 visit11 } from "unist-util-visit";
+
+// src/docs-plugin/remark/remark-spoilers.ts
+import { visit as visit12 } from "unist-util-visit";
+function getSpoilerStartMatch(text) {
+  return text.match(/^:::\s*spoiler\s*(.*)$/);
+}
+function getSpoilerEndMatch(text) {
+  return text.trim() === ":::";
+}
+function isSpoilerBlock(text) {
+  return !!getSpoilerStartMatch(text) || getSpoilerEndMatch(text);
+}
+
+// src/docs-plugin/remark/remark-steps.ts
+import { visit as visit13 } from "unist-util-visit";
+function getStepStartMatch(text) {
+  return text.match(/^:::\s*steps(?:\s+(h[1-6](?:-h[1-6])?))?\s*$/);
+}
+function getStepEndMatch(text) {
+  return text.match(/^:::\s*\/steps\s*$/);
+}
+function isStepBlock(text) {
+  return !!(getStepStartMatch(text) || getStepEndMatch(text));
+}
+
+// src/docs-plugin/shiki/shiki-transformer-preview-block.ts
+import { dedent } from "@qualcomm-ui/utils/dedent";
+
+// src/ai-knowledge/generator/filter-text-directives.ts
+var filterTextDirectives = () => {
+  return (tree, _file, done) => {
+    visit14(tree, "text", (node) => {
+      const value = node.value?.trim?.();
+      if (value && (isStepBlock(value) || isSpoilerBlock(value))) {
+        Object.assign(node, {
+          value: ``
+        });
+      }
+    });
+    done();
+  };
+};
+
+// src/ai-knowledge/generator/npm-install-tabs-plugin.ts
+import { visit as visit15 } from "unist-util-visit";
 var formatNpmInstallTabs = () => {
   return (tree, _file, done) => {
-    visit8(
+    visit15(
       tree,
       "mdxJsxFlowElement",
       (node, index, parent) => {
@@ -6030,7 +6311,7 @@ var formatNpmInstallTabs = () => {
 };
 
 // src/ai-knowledge/generator/qds-theme-plugin.ts
-import { visit as visit9 } from "unist-util-visit";
+import { visit as visit16 } from "unist-util-visit";
 function themeDataToJson(data, cssPropertyName) {
   if (!data || typeof data !== "object") {
     return "";
@@ -6089,7 +6370,7 @@ async function formatThemeNodes() {
     }
   };
   return () => (tree, _file, done) => {
-    visit9(tree, "mdxJsxFlowElement", (node) => {
+    visit16(tree, "mdxJsxFlowElement", (node) => {
       const handler = node.name && handlers[node.name];
       if (!handler) {
         return;
@@ -6121,10 +6402,10 @@ async function formatThemeNodes() {
 }
 
 // src/ai-knowledge/generator/section-extractor.ts
-import { toString as toString2 } from "mdast-util-to-string";
+import { toString as toString3 } from "mdast-util-to-string";
 import remarkStringify3 from "remark-stringify";
 import { unified as unified4 } from "unified";
-import { visit as visit10 } from "unist-util-visit";
+import { visit as visit17 } from "unist-util-visit";
 import { kebabCase as kebabCase2 } from "@qualcomm-ui/utils/change-case";
 var SectionExtractor = class {
   depths;
@@ -6156,8 +6437,8 @@ var SectionExtractor = class {
         continue;
       }
       if (node.type === "heading") {
-        const heading = node;
-        if (!this.depths.has(heading.depth)) {
+        const heading2 = node;
+        if (!this.depths.has(heading2.depth)) {
           if (pendingSection) {
             pendingSection.nodes.push(node);
           } else {
@@ -6170,11 +6451,11 @@ var SectionExtractor = class {
           continue;
         }
         finalizeSection();
-        while (headerStack.length > 0 && headerStack[headerStack.length - 1].depth >= heading.depth) {
+        while (headerStack.length > 0 && headerStack[headerStack.length - 1].depth >= heading2.depth) {
           headerStack.pop();
         }
-        const headingText = toString2(heading);
-        headerStack.push({ depth: heading.depth, text: headingText });
+        const headingText = toString3(heading2);
+        headerStack.push({ depth: heading2.depth, text: headingText });
         pendingSection = {
           headerPath: headerStack.map((h) => h.text),
           nodes: [],
@@ -6212,6 +6493,7 @@ var SectionExtractor = class {
           code: codeNode.value,
           language: codeNode.lang ?? ""
         });
+      } else if (node.type === "text" && (isStepBlock(node.value.trim()) || isSpoilerBlock(node.value.trim()))) {
       } else {
         contentNodes.push(node);
       }
@@ -6280,9 +6562,9 @@ var SectionExtractor = class {
    */
   transformLinks() {
     return () => (tree) => {
-      visit10(tree, "link", (node) => {
+      visit17(tree, "link", (node) => {
         let text = "";
-        visit10(node, "text", (textNode) => {
+        visit17(node, "text", (textNode) => {
           text += textNode.value;
         });
         Object.assign(node, {
@@ -6393,14 +6675,14 @@ var KnowledgeGenerator = class {
       }
       const entries = await readdir(dirPath, { withFileTypes: true });
       const mdxFiles = entries.filter(
-        (f) => f.name.endsWith(".mdx") && !shouldExclude(join6(dirPath, f.name))
+        (f) => f.name.endsWith(".mdx") && !shouldExclude(join7(dirPath, f.name))
       ) ?? [];
       const pageIdPrefix = this.config.pageIdPrefix ?? "";
       for (const mdxFile of mdxFiles) {
         const demosFolder = entries.find((f) => f.name === "demos");
-        const demosFolderPath = demosFolder ? join6(dirPath, demosFolder.name) : void 0;
+        const demosFolderPath = demosFolder ? join7(dirPath, demosFolder.name) : void 0;
         const segments = getPathSegmentsFromFileName(
-          join6(dirPath, mdxFile.name),
+          join7(dirPath, mdxFile.name),
           this.config.routeDir
         );
         const url = getPathnameFromPathSegments(segments);
@@ -6408,7 +6690,7 @@ var KnowledgeGenerator = class {
           demosFolder: demosFolderPath,
           filePath: dirPath,
           id: `${pageIdPrefix ? `${pageIdPrefix}-` : ""}${segments.join("-").trim()}`,
-          mdxFile: join6(dirPath, mdxFile.name),
+          mdxFile: join7(dirPath, mdxFile.name),
           name: segments.at(-1),
           pathname: url,
           url: this.config.baseUrl ? new URL(url, this.config.baseUrl).toString() : void 0
@@ -6419,7 +6701,7 @@ var KnowledgeGenerator = class {
         }
       }
       for (const entry of entries) {
-        const fullPath = join6(dirPath, entry.name);
+        const fullPath = join7(dirPath, entry.name);
         const stats = await stat(fullPath);
         if (stats.isDirectory()) {
           await scanDirectory(fullPath);
@@ -6431,7 +6713,7 @@ var KnowledgeGenerator = class {
   }
   formatFrontmatterExpressions(frontmatter) {
     return () => (tree) => {
-      visit11(
+      visit18(
         tree,
         "mdxFlowExpression",
         (node, index, parent) => {
@@ -6471,7 +6753,7 @@ var KnowledgeGenerator = class {
       if (!baseUrl || this.config.outputMode !== "per-page") {
         return;
       }
-      visit11(tree, "link", (node) => {
+      visit18(tree, "link", (node) => {
         if (node.url.startsWith("/")) {
           node.url = `${baseUrl}${node.url}`;
         } else if (node.url.startsWith("./#") && pageUrl) {
@@ -6515,7 +6797,7 @@ var KnowledgeGenerator = class {
    * into Markdown, resolving relative links, and cleaning up formatting.
    */
   async processMdxContent(mdxContent, pageInfo, frontmatter) {
-    const processor = unified5().use(remarkParse4).use(remarkMdx3).use(remarkFrontmatter2, ["yaml"]).use(this.propFormatter.propsToMarkdownList()).use(this.formatFrontmatterExpressions(frontmatter)).use(await formatThemeNodes()).use(formatDemos(pageInfo.demosFolder)).use(this.transformRelativeUrls(pageInfo.url));
+    const processor = unified5().use(remarkParse4).use(remarkMdx3).use(remarkFrontmatter3, ["yaml"]).use(this.propFormatter.propsToMarkdownList()).use(this.formatFrontmatterExpressions(frontmatter)).use(await formatThemeNodes()).use(formatDemos(pageInfo.demosFolder)).use(filterTextDirectives).use(this.transformRelativeUrls(pageInfo.url));
     this.applyPlugins(pageInfo, processor);
     processor.use(remarkStringify4);
     return await processor.run(processor.parse(mdxContent));
@@ -6526,7 +6808,7 @@ var KnowledgeGenerator = class {
       if (this.config.verbose) {
         console.log(`Processing page: ${pageInfo.name}`);
       }
-      const processor = unified5().use(remarkParse4).use(remarkMdx3).use(formatNpmInstallTabs).use(remarkFrontmatter2, ["yaml"]).use(remarkParseFrontmatter2).use(remarkStringify4);
+      const processor = unified5().use(remarkParse4).use(remarkMdx3).use(formatNpmInstallTabs).use(remarkFrontmatter3, ["yaml"]).use(remarkParseFrontmatter2).use(remarkStringify4);
       const parsed = await processor.process(mdxContent);
       const frontmatter = parsed.data?.frontmatter || {};
       const ast = await this.processMdxContent(
@@ -6534,7 +6816,7 @@ var KnowledgeGenerator = class {
         pageInfo,
         frontmatter
       );
-      const removeJsxProcessor = unified5().use(remarkMdx3).use(remarkFrontmatter2, ["yaml"]).use(remarkRemoveJsx).use(remarkStringify4);
+      const removeJsxProcessor = unified5().use(remarkMdx3).use(remarkFrontmatter3, ["yaml"]).use(remarkRemoveJsx).use(remarkStringify4);
       const sectionAst = removeJsxProcessor.runSync(ast);
       const removedJsx = String(removeJsxProcessor.stringify(sectionAst));
       const rawContent = removedJsx.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, "").replace(/(^#{1,6} .*\\<[^>]+)>/gm, "$1\\>");
@@ -6604,7 +6886,7 @@ var KnowledgeGenerator = class {
       extraFiles.map(async (extraFile) => {
         let contents = extraFile.contents;
         if (extraFile.processAsMdx) {
-          const removeJsxProcessor = unified5().use(remarkParse4).use(remarkMdx3).use(remarkFrontmatter2, ["yaml"]).use(remarkRemoveJsx).use(this.transformRelativeUrls()).use(remarkStringify4);
+          const removeJsxProcessor = unified5().use(remarkParse4).use(remarkMdx3).use(remarkFrontmatter3, ["yaml"]).use(remarkRemoveJsx).use(this.transformRelativeUrls()).use(remarkStringify4);
           contents = String(await removeJsxProcessor.process(contents));
         }
         const lines = [];
@@ -6624,7 +6906,7 @@ var KnowledgeGenerator = class {
         lines.push("");
         const fileContent = lines.join("\n");
         const fileName = `${kebabCase3(extraFile.id)}.md`;
-        const outfile = `${resolve4(this.config.outputPath)}/${fileName}`;
+        const outfile = `${resolve5(this.config.outputPath)}/${fileName}`;
         await writeFile(outfile, fileContent, "utf-8");
         const stats = await stat(outfile);
         totalSize += stats.size / 1024;
@@ -6727,7 +7009,7 @@ var KnowledgeGenerator = class {
         lines.push("");
         const fileContent = lines.join("\n");
         const fileName = `${kebabCase3(page.id || page.name)}.md`;
-        const outfile = `${resolve4(this.config.outputPath)}/${fileName}`;
+        const outfile = `${resolve5(this.config.outputPath)}/${fileName}`;
         await writeFile(outfile, fileContent, "utf-8");
         const stats = await stat(outfile);
         totalSize += stats.size / 1024;
@@ -6763,7 +7045,7 @@ var KnowledgeGenerator = class {
       );
     }
     console.log(
-      `Generated ${count + extraFilesResult.count} files(s) in ${chalk3.magenta.bold(`${Math.round(performance.now() - start + extraFilesResult.duration)}ms`)} at ${chalk3.blue.bold(this.config.outputPath)} - ${(totalSize + extraFilesResult.totalSize).toFixed(1)} KB`
+      `Generated ${count + extraFilesResult.count} files(s) in ${chalk4.magenta.bold(`${Math.round(performance.now() - start + extraFilesResult.duration)}ms`)} at ${chalk4.blue.bold(this.config.outputPath)} - ${(totalSize + extraFilesResult.totalSize).toFixed(1)} KB`
     );
   }
   computeAggregateHash(entries) {
@@ -6785,7 +7067,7 @@ var KnowledgeGenerator = class {
     await mkdir(outputPath, { recursive: true }).catch(() => {
     });
     await writeFile(
-      join6(outputPath, "manifest.json"),
+      join7(outputPath, "manifest.json"),
       JSON.stringify(manifest, null, 2),
       "utf-8"
     );
@@ -6794,10 +7076,10 @@ var KnowledgeGenerator = class {
   async generateBulkZip(outputPath, entries) {
     await mkdir(outputPath, { recursive: true }).catch(() => {
     });
-    const zipPath = join6(outputPath, "bulk.zip");
+    const zipPath = join7(outputPath, "bulk.zip");
     const zip = new AdmZip();
     for (const entry of entries) {
-      const filePath = join6(this.config.outputPath, entry.path);
+      const filePath = join7(this.config.outputPath, entry.path);
       const content = await readFile4(filePath);
       zip.addFile(entry.path, content);
     }
@@ -6830,7 +7112,7 @@ var KnowledgeGenerator = class {
       totalSections: allSections.length,
       version: 1
     };
-    const sectionsPath = join6(
+    const sectionsPath = join7(
       outputPath,
       sectionsConfig.outputPath ?? "sections.json"
     );
@@ -6839,7 +7121,7 @@ var KnowledgeGenerator = class {
     await writeFile(sectionsPath, JSON.stringify(output, null, 2), "utf-8");
     if (this.config.verbose) {
       console.log(
-        `Generated ${allSections.length} sections at ${chalk3.blue.bold(sectionsPath)}`
+        `Generated ${allSections.length} sections at ${chalk4.blue.bold(sectionsPath)}`
       );
     }
   }
@@ -6889,7 +7171,7 @@ Generated knowledge for ${configs.length} environment(s)`
 // src/ai-knowledge/open-web-ui/download-knowledge.ts
 import dotenv from "dotenv";
 import { mkdir as mkdir2, writeFile as writeFile2 } from "node:fs/promises";
-import { resolve as resolve5 } from "node:path";
+import { resolve as resolve6 } from "node:path";
 
 // src/ai-knowledge/open-web-ui/api.ts
 function isErrorResponse(response) {
@@ -7000,7 +7282,7 @@ var FilesApi = class {
       if (status.status === "completed" || status.status === "failed") {
         return status;
       }
-      await new Promise((resolve10) => setTimeout(resolve10, intervalMs));
+      await new Promise((resolve11) => setTimeout(resolve11, intervalMs));
     }
     throw new Error(`File processing timed out after ${maxAttempts} attempts`);
   }
@@ -7214,7 +7496,7 @@ function addDownloadKnowledgeCommand() {
         const content = await filesApi.getDataContent(file.id);
         if (content?.content) {
           await writeFile2(
-            resolve5(opts.outputDir, fileName),
+            resolve6(opts.outputDir, fileName),
             content.content,
             "utf-8"
           );
@@ -7230,7 +7512,7 @@ function addDownloadKnowledgeCommand() {
 import { createHash as createHash3 } from "node:crypto";
 import { writeFileSync } from "node:fs";
 import { access as access2, readdir as readdir2, readFile as readFile5, stat as stat2 } from "node:fs/promises";
-import { resolve as resolve6 } from "node:path";
+import { resolve as resolve7 } from "node:path";
 import { setTimeout as setTimeout2 } from "node:timers/promises";
 import ora from "ora";
 
@@ -7437,7 +7719,7 @@ var Uploader = class {
     const files = await Promise.all(
       fileNames.map(async (name) => ({
         contents: await readFile5(
-          resolve6(this.config.knowledgeFilePath, name),
+          resolve7(this.config.knowledgeFilePath, name),
           "utf-8"
         ),
         name
@@ -7489,7 +7771,7 @@ var Uploader = class {
       try {
         const fileId = knowledgeFile.id;
         const fileString = await readFile5(
-          resolve6(this.config.knowledgeFilePath, name),
+          resolve7(this.config.knowledgeFilePath, name),
           "utf-8"
         );
         const spinner2 = ora(`Updating ${name}`).start();
@@ -7504,7 +7786,7 @@ var Uploader = class {
     }
     const spinner = ora(`Uploading ${name}`).start();
     const fileBuffer = await readFile5(
-      resolve6(this.config.knowledgeFilePath, name)
+      resolve7(this.config.knowledgeFilePath, name)
     );
     let uploadedFileId = void 0;
     try {
@@ -7542,7 +7824,7 @@ var Uploader = class {
     }
   }
   async uploadKnowledge() {
-    const resolvedPath = resolve6(this.config.knowledgeFilePath);
+    const resolvedPath = resolve7(this.config.knowledgeFilePath);
     if (!await access2(resolvedPath).then(() => true).catch(() => false)) {
       throw new Error(`File or folder not found at ${resolvedPath}`);
     }
@@ -7629,7 +7911,7 @@ Uploaded to ${successCount} integration(s)${failureCount > 0 ? `, ${failureCount
     const files = await uploader.filesApi.search("*");
     console.debug(`found ${files.length} files`);
     writeFileSync(
-      resolve6(uploader.config.knowledgeFilePath, "files.json"),
+      resolve7(uploader.config.knowledgeFilePath, "files.json"),
       JSON.stringify(files, null, 2),
       "utf-8"
     );
@@ -7672,9 +7954,9 @@ Uploaded to ${successCount} integration(s)${failureCount > 0 ? `, ${failureCount
 }
 
 // src/docs-plugin/generate-page-map.ts
-import { glob } from "glob";
+import { glob as glob2 } from "glob";
 import { writeFile as writeFile3 } from "node:fs/promises";
-import { resolve as resolve7 } from "node:path";
+import { resolve as resolve8 } from "node:path";
 import { cwd } from "node:process";
 function addGeneratePageMapCommand() {
   program.command("generate-page-map").description(
@@ -7695,14 +7977,14 @@ function addGeneratePageMapCommand() {
       const configLoader = new ConfigLoader({ configFile: options.configFile });
       const resolvedConfig = configLoader.loadConfig();
       const routesDir = fixPath(
-        resolve7(resolvedConfig.appDirectory, resolvedConfig.pageDirectory)
+        resolve8(resolvedConfig.appDirectory, resolvedConfig.pageDirectory)
       );
       const indexer = new SearchIndexer({
         ...resolvedConfig,
-        srcDir: fixPath(resolve7(cwd(), resolvedConfig.appDirectory)),
+        srcDir: fixPath(resolve8(cwd(), resolvedConfig.appDirectory)),
         typeDocProps: {}
       });
-      const files = glob.sync(
+      const files = glob2.sync(
         [`${routesDir}/**/*.mdx`, `${routesDir}/**/*.tsx`],
         {
           absolute: true,
@@ -7711,7 +7993,7 @@ function addGeneratePageMapCommand() {
       );
       indexer.buildIndex(files, true);
       await writeFile3(
-        resolve7(cwd(), options.output),
+        resolve8(cwd(), options.output),
         JSON.stringify(indexer.pageMap, null, 2),
         "utf-8"
       );
@@ -7726,16 +8008,16 @@ function addGeneratePageMapCommand() {
 }
 
 // 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 resolve9 } from "node:path";
-import { dedent } from "@qualcomm-ui/utils/dedent";
+import { resolve as resolve10 } from "node:path";
+import { dedent as dedent2 } from "@qualcomm-ui/utils/dedent";
 
 // src/react-demo-plugin/demo-plugin-utils.ts
-import chalk4 from "chalk";
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import { dirname as dirname4, join as join7, relative as relative3, resolve as resolve8, sep } from "node:path";
+import chalk5 from "chalk";
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "node:fs";
+import { dirname as dirname4, join as join8, relative as relative3, resolve as resolve9, sep } from "node:path";
 import * as ts2 from "typescript";
 import { pascalCase } from "@qualcomm-ui/utils/change-case";
 function extractPageId(filePath, routesDir) {
@@ -7749,7 +8031,7 @@ function extractPageId(filePath, routesDir) {
 }
 function isDemoFile(filePath) {
   try {
-    return filePath.includes("/demos/") && filePath.endsWith(".tsx") && !readFileSync2(filePath).includes("export default");
+    return filePath.includes("/demos/") && filePath.endsWith(".tsx") && !readFileSync3(filePath).includes("export default");
   } catch (error) {
     return false;
   }
@@ -7760,7 +8042,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),
@@ -7774,7 +8056,7 @@ function generateLazyDemoLoader(demoPages) {
     return `  "${routePath}": () =>
     import("virtual:qui-demo-scope/page:${pageId}")`;
   }).sort().join(",\n");
-  return dedent`
+  return dedent2`
     /* eslint-disable */
 
     // This file is generated automatically. Don't edit it directly.
@@ -7792,7 +8074,7 @@ function generateLazyDemoLoader(demoPages) {
 }
 async function generateLazyDemoMap(options) {
   const routesDir = options.routesDir;
-  const outputPath = resolve9(options.output);
+  const outputPath = resolve10(options.output);
   console.log(`Scanning for demo pages in: ${routesDir}`);
   const demoPages = await scanForDemoPages({ routesDir });
   console.log(`Found ${demoPages.length} pages with demos`);