@qualcomm-ui/mdx-vite 2.15.0 → 2.16.0

package/dist/ai-knowledge/generator/doc-props-plugin.d.ts

@@ -11,6 +11,6 @@ export declare class PropFormatter {
      * Creates a remark plugin that replaces TypeDocProps JSX elements with
      * Markdown tables containing component prop documentation.
      */
-    formatTypeDocProps(): Plugin;
+    propsToMarkdownList(): Plugin;
 }
 //# sourceMappingURL=doc-props-plugin.d.ts.map

package/dist/ai-knowledge/generator/doc-props-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-props-plugin.d.ts","sourceRoot":"","sources":["../../../src/ai-knowledge/generator/doc-props-plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,SAAS,CAAA;AAWnC,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EAER,cAAc,EACf,MAAM,mBAAmB,CAAA;AAoD1B,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAwB;IAElC,YAAY,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAqC9C,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,aAAa;IAoCrB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,GAAG,cAAc,EAAE;IA0BzE,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,kBAAkB,IAAI,MAAM;CA6F7B"}
+{"version":3,"file":"doc-props-plugin.d.ts","sourceRoot":"","sources":["../../../src/ai-knowledge/generator/doc-props-plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,SAAS,CAAA;AAWnC,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EAER,cAAc,EACf,MAAM,mBAAmB,CAAA;AAoD1B,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAwB;IAElC,YAAY,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAqC9C,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,aAAa;IAoCrB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,GAAG,cAAc,EAAE;IA0BzE,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,mBAAmB,IAAI,MAAM;CA8F9B"}

package/dist/ai-knowledge/generator/section-extractor.d.ts

@@ -31,9 +31,8 @@ export declare class SectionExtractor {
     extract(tree: Root, pageInfo: PageInfo): SectionEntry[];
     private getHeadingText;
     private buildSectionEntry;
-    private extractMetadata;
-    private parseMetaBlock;
-    private parseValue;
+    private extractTerms;
+    private parseTermsBlock;
     /**
      * Convert links to inline code. URLs are not relevant for text embeddings
      * and will muddy the vector storage.

package/dist/ai-knowledge/generator/section-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"section-extractor.d.ts","sourceRoot":"","sources":["../../../src/ai-knowledge/generator/section-extractor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA8B,IAAI,EAAoB,MAAM,OAAO,CAAA;AAO/E,OAAO,KAAK,EAAc,YAAY,EAAkB,MAAM,iBAAiB,CAAA;AAE/E,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IAEjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAaD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;gBAE7B,OAAO,CAAC,EAAE,uBAAuB;IAM7C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,YAAY,EAAE;IAyDvD,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IA+DzB,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,UAAU;IAclB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,gBAAgB;CAGzB"}
+{"version":3,"file":"section-extractor.d.ts","sourceRoot":"","sources":["../../../src/ai-knowledge/generator/section-extractor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA8B,IAAI,EAAoB,MAAM,OAAO,CAAA;AAQ/E,OAAO,KAAK,EAAc,YAAY,EAAe,MAAM,iBAAiB,CAAA;AAG5E,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IAEjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAaD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;gBAE7B,OAAO,CAAC,EAAE,uBAAuB;IAM7C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,YAAY,EAAE;IAyDvD,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAgEzB,OAAO,CAAC,YAAY;IAwCpB,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,gBAAgB;CAGzB"}

package/dist/ai-knowledge/generator/section.types.d.ts

@@ -1,3 +1,4 @@
+import type { SimplifiedProp } from "./generator.types";
 /**
  * A code example extracted from a section.
  */
@@ -12,16 +13,24 @@ export interface CodeExample {
     language: string;
 }
 /**
- * Metadata extracted from ::: meta ::: blocks within a section.
+ * Metadata extracted from ::: terms ::: blocks within a section.
  */
 export interface SectionMetadata {
     [key: string]: string | string[] | undefined;
     category?: string;
     component?: string;
-    keywords?: string[];
-    props?: string[];
     type?: string;
 }
+export interface SectionTypes {
+    /**
+     * Props extracted from the TypeDoc code block.
+     */
+    props: SimplifiedProp[];
+    /**
+     * Name of the type, interface, or class.
+     */
+    type: string;
+}
 /**
  * A single section entry extracted from documentation.
  */
@@ -44,10 +53,6 @@ export interface SectionEntry {
      * @example ["Button", "Examples", "Variants"]
      */
     headerPath: string[];
-    /**
-     * Metadata extracted from ::: meta ::: blocks within this section.
-     */
-    metadata?: SectionMetadata;
     /**
      * Frontmatter from the source page.
      */
@@ -65,6 +70,14 @@ export interface SectionEntry {
      * @example "button-examples-variants"
      */
     sectionId: string;
+    /**
+     * Search terms extracted from ::: terms ::: blocks within this section.
+     */
+    terms?: string[];
+    /**
+     * Name of the types or interfaces described by typeDocProps in this section.
+     */
+    types?: SectionTypes[];
     /**
      * URL with anchor to this specific section.
      */

package/dist/ai-knowledge/generator/section.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"section.types.d.ts","sourceRoot":"","sources":["../../../src/ai-knowledge/generator/section.types.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAE5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,CAAA;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;IAE1B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEzC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,CAAC,CAAA;CACX"}
+{"version":3,"file":"section.types.d.ts","sourceRoot":"","sources":["../../../src/ai-knowledge/generator/section.types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,mBAAmB,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,KAAK,EAAE,cAAc,EAAE,CAAA;IAEvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAE5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,CAAA;IAEpB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEzC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,YAAY,EAAE,CAAA;IAEtB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,CAAC,CAAA;CACX"}

package/dist/cli.js

@@ -5441,6 +5441,9 @@ function parseMetaContent(content) {
   }
   return result;
 }
+function parseTermsContent(content) {
+  return content.split("\n").map((line) => line.trim()).filter((line) => line && line !== ":::");
+}
 var remarkExtractMeta = (metadata = {}) => {
   return (tree) => {
     const nodesToRemove = [];
@@ -5453,16 +5456,27 @@ var remarkExtractMeta = (metadata = {}) => {
         return;
       }
       const text = firstChild.value;
-      const openMatch = text.match(/^:::\s*meta\s*/);
-      if (!openMatch) {
+      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);
-        const parsed = parseMetaContent(content);
-        Object.assign(metadata, parsed);
+        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;
       }
@@ -5477,8 +5491,16 @@ var remarkExtractMeta = (metadata = {}) => {
       const closeIndexFull = afterOpenFull.lastIndexOf(":::");
       if (closeIndexFull !== -1) {
         const content = afterOpenFull.slice(0, closeIndexFull);
-        const parsed = parseMetaContent(content);
-        Object.assign(metadata, parsed);
+        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;
       }
@@ -5889,7 +5911,7 @@ ${tagContent.trim()}
    * Creates a remark plugin that replaces TypeDocProps JSX elements with
    * Markdown tables containing component prop documentation.
    */
-  formatTypeDocProps() {
+  propsToMarkdownList() {
     return () => (tree, _file, done) => {
       visit7(
         tree,
@@ -5928,15 +5950,18 @@ ${tagContent.trim()}
             }
             return;
           }
-          const propsDoc = this.extractProps(componentProps, Boolean(isPartial));
+          const propTypes = this.extractProps(
+            componentProps,
+            Boolean(isPartial)
+          );
           if (getConfig().verbose) {
             console.log(
               `  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 regularProps = propTypes.filter((p) => p.propType === void 0);
+          const inputs = propTypes.filter((p) => p.propType === "input");
+          const outputs = propTypes.filter((p) => p.propType === "output");
           const sections = [];
           if (regularProps.length > 0) {
             sections.push(propsToDefinitionList(regularProps));
@@ -5958,9 +5983,8 @@ ${propsToDefinitionList(outputs)}`);
             }
             return;
           }
-          const propNames = propsDoc.map((p) => p.name);
           Object.assign(node, {
-            data: { typeDocProps: { name: propsName, props: propNames } },
+            data: { typeDocProps: { name: propsName, props: propTypes } },
             lang: null,
             meta: null,
             type: "code",
@@ -6161,19 +6185,19 @@ var SectionExtractor = class {
     return text.trim();
   }
   buildSectionEntry(section, pageInfo) {
-    const { metadata, nodes } = this.extractMetadata(section.nodes);
+    const { nodes, terms } = this.extractTerms(section.nodes);
     if (nodes.length === 0) {
       return null;
     }
     const contentNodes = [];
     const codeExamples = [];
+    const sectionTypes = [];
     for (const node of nodes) {
       if (node.type === "code") {
         const codeNode = node;
         if (codeNode.data?.typeDocProps) {
           const { name, props } = codeNode.data.typeDocProps;
-          metadata.props = [...metadata.props ?? [], ...props];
-          metadata.type = name;
+          sectionTypes.push({ props, type: name });
         }
         codeExamples.push({
           code: codeNode.value,
@@ -6189,71 +6213,57 @@ var SectionExtractor = class {
     const url = pageInfo.url ? `${pageInfo.url}#${this.generateAnchorId(section.headerPath.at(-1) ?? "")}` : void 0;
     const hashData = {
       headerPath: section.headerPath,
-      metadata: Object.keys(metadata).length ? metadata : void 0,
       pageFrontmatter: Object.keys(pageInfo.frontmatter).length ? pageInfo.frontmatter : void 0,
       pageId: pageInfo.id,
-      rawContent: rawContent.trim()
+      rawContent: rawContent.trim(),
+      terms: terms.length ? terms : void 0,
+      types: sectionTypes.length ? sectionTypes : void 0,
+      url
     };
-    const sectionHash = JSON.stringify(hashData);
+    const sectionHash = computeMd5(JSON.stringify(hashData));
     return {
       ...hashData,
       codeExamples: codeExamples.length ? codeExamples : void 0,
       content: content.trim(),
       hash: sectionHash,
-      sectionId,
-      url
+      sectionId
     };
   }
-  extractMetadata(nodes) {
-    const metadata = {};
+  extractTerms(nodes) {
     const filteredNodes = [];
+    const terms = [];
     for (const node of nodes) {
       if (node.type === "paragraph") {
-        const firstChild = node.children?.[0];
+        const children = node.children ?? [];
+        const firstChild = children[0];
         if (firstChild?.type === "text") {
-          const text = firstChild.value;
-          const metaMatch = text.match(/^:::\s*meta\s*/);
-          if (metaMatch) {
-            const parsed = this.parseMetaBlock(text);
-            Object.assign(metadata, parsed);
+          const firstText = firstChild.value;
+          const termsMatch = firstText.match(/^:::\s*terms\s*/);
+          if (termsMatch) {
+            let fullText = firstText;
+            for (let i = 1; i < children.length; i++) {
+              const child = children[i];
+              if (child.type === "text") {
+                fullText += child.value;
+              } else if (child.type === "softBreak") {
+                fullText += "\n";
+              }
+            }
+            const parsedTerms = this.parseTermsBlock(fullText);
+            terms.push(...parsedTerms);
             continue;
           }
         }
       }
       filteredNodes.push(node);
     }
-    return { metadata, nodes: filteredNodes };
+    return { nodes: filteredNodes, terms };
   }
-  parseMetaBlock(text) {
-    const metadata = {};
-    const afterOpen = text.replace(/^:::\s*meta\s*/, "");
+  parseTermsBlock(text) {
+    const afterOpen = text.replace(/^:::\s*terms\s*/, "");
     const closeIndex = afterOpen.lastIndexOf(":::");
     const content = closeIndex !== -1 ? afterOpen.slice(0, closeIndex) : afterOpen;
-    const lines = content.split("\n");
-    for (const line of lines) {
-      const trimmed = line.trim();
-      if (!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) {
-        metadata[key] = this.parseValue(value);
-      }
-    }
-    return metadata;
-  }
-  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;
+    return content.split("\n").map((line) => line.trim()).filter((line) => line && line !== ":::");
   }
   /**
    * Convert links to inline code. URLs are not relevant for text embeddings
@@ -6496,7 +6506,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.formatTypeDocProps()).use(this.formatFrontmatterExpressions(frontmatter)).use(await formatThemeNodes()).use(formatDemos(pageInfo.demosFolder)).use(this.transformRelativeUrls(pageInfo.url));
+    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));
     this.applyPlugins(pageInfo, processor);
     processor.use(remarkStringify4);
     return await processor.run(processor.parse(mdxContent));