@qualcomm-ui/mdx-vite 2.10.1 → 2.11.0

package/dist/docs-plugin/internal/config-schema.d.ts

@@ -8,6 +8,38 @@ export declare const configSchema: z.ZodObject<{
     headings: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"h1">, z.ZodLiteral<"h2">, z.ZodLiteral<"h3">, z.ZodLiteral<"h4">, z.ZodLiteral<"h5">, z.ZodLiteral<"h6">]>>>;
     hotUpdateIgnore: z.ZodOptional<z.ZodCustom<RegExp, RegExp>>;
     knowledge: z.ZodOptional<z.ZodObject<{
+        environments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            baseUrl: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            exports: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                extraFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    contents: z.ZodString;
+                    id: z.ZodString;
+                    processAsMdx: z.ZodOptional<z.ZodBoolean>;
+                    title: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                pageTitlePrefix: z.ZodOptional<z.ZodString>;
+                staticPath: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            extraFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                contents: z.ZodString;
+                id: z.ZodString;
+                processAsMdx: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            frontmatterFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            id: z.ZodString;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            name: z.ZodOptional<z.ZodString>;
+            outputMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"per-page">, z.ZodLiteral<"aggregated">]>>;
+            outputPath: z.ZodString;
+            pageIdPrefix: z.ZodOptional<z.ZodString>;
+            pageTitlePrefix: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         global: z.ZodOptional<z.ZodObject<{
             baseUrl: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
@@ -31,12 +63,20 @@ export declare const configSchema: z.ZodObject<{
                 processAsMdx: z.ZodOptional<z.ZodBoolean>;
                 title: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
+            frontmatterFields: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodAny]>>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             name: z.ZodOptional<z.ZodString>;
             outputMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"per-page">, z.ZodLiteral<"aggregated">]>>;
             outputPath: z.ZodOptional<z.ZodString>;
+            pageIdPrefix: z.ZodOptional<z.ZodString>;
             pageTitlePrefix: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        integrations: z.ZodOptional<z.ZodObject<{
+            openWebUi: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                envFile: z.ZodOptional<z.ZodString>;
+                id: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     navConfig: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodType<RouteMeta, unknown, z.core.$ZodTypeInternals<RouteMeta, unknown>>, z.ZodObject<{}, z.core.$strip>]>>>;
     pageDirectory: z.ZodOptional<z.ZodString>;

package/dist/docs-plugin/internal/config-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../../src/docs-plugin/internal/config-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,CAAC,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAC,MAAM,KAAK,CAAA;AAErD,OAAO,KAAK,EAQV,SAAS,EACV,MAAM,UAAU,CAAA;AAIjB,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,EAAE,CAItC,CAAA;AAEF,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,SAAS,CAmB7C,CAAA;AA2CJ,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BvB,CAAA"}
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../../src/docs-plugin/internal/config-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,CAAC,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAC,MAAM,KAAK,CAAA;AAErD,OAAO,KAAK,EAWV,SAAS,EACV,MAAM,UAAU,CAAA;AAIjB,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,EAAE,CAItC,CAAA;AAEF,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,SAAS,CAmB7C,CAAA;AA0EJ,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BvB,CAAA"}

package/dist/docs-plugin/types.d.ts

@@ -1,4 +1,4 @@
-import type { PageFrontmatter, TocHeading } from "@qualcomm-ui/mdx-common";
+import type { KnowledgePageData, PageFrontmatter, TocHeading } from "@qualcomm-ui/mdx-common";
 import type { QuiPropTypes } from "@qualcomm-ui/typedoc-common";
 export type RoutingStrategy = "vite-generouted" | ((filePath: string) => string[]);
 /**
@@ -120,13 +120,19 @@ export interface KnowledgeIntegrationConfig {
      */
     exclude?: string[];
     /**
-     * Configuration for per-page markdown exports served from the public directory.
+     * Configuration for per-page Markdown exports served from the public directory.
      */
     exports?: KnowledgeExportsConfig;
     /**
      * Extra files to include in knowledge output beyond the generated page content.
      */
     extraFiles?: KnowledgeExtraFile[];
+    /**
+     * List of frontmatter fields to include in the generated Markdown output. These
+     * will be copied from each page's frontmatter, if present. Supply as a function
+     * and return the modified frontmatter object, which will be included instead.
+     */
+    frontmatterFields?: string[] | ((frontmatter: Record<string, string>, page: KnowledgePageData) => Record<string, string | undefined>);
     /**
      * Metadata key-value pairs to include in per-page output.
      */
@@ -143,6 +149,10 @@ export interface KnowledgeIntegrationConfig {
      * Output path for generated knowledge files.
      */
     outputPath?: string;
+    /**
+     * Prefix to prepend to each page ID.
+     */
+    pageIdPrefix?: string;
     /**
      * Prefix to prepend to each page title.
      */
@@ -206,11 +216,59 @@ export interface KnowledgeExportsConfig {
      */
     staticPath?: string;
 }
+/**
+ * Environment-specific knowledge generation configuration. Extends the base
+ * integration config with a required output path.
+ */
+export interface KnowledgeEnvironment extends KnowledgeIntegrationConfig {
+    /**
+     * Unique identifier for this environment.
+     */
+    id: string;
+    /**
+     * Output directory for this environment's generated knowledge files.
+     */
+    outputPath: string;
+}
+/**
+ * OpenWebUI integration configuration. References a generation environment
+ * and specifies how to load credentials.
+ */
+export interface OpenWebUiIntegration {
+    /**
+     * Path to env file containing `OPEN_WEB_UI_*` variables. Defaults to
+     * `.env.{id}` by convention.
+     */
+    envFile?: string;
+    /**
+     * Environment identifier. Must match an `id` in `knowledge.environments`.
+     */
+    id: string;
+}
+/**
+ * Container for platform-specific integration configurations.
+ */
+export interface KnowledgeIntegrations {
+    /**
+     * OpenWebUI integration configurations.
+     */
+    openWebUi?: OpenWebUiIntegration[];
+}
 export interface KnowledgeConfig {
     /**
-     * Configuration for all knowledge integrations.
+     * Generation environments. Each environment can override global settings and
+     * specifies its own output path.
+     */
+    environments?: KnowledgeEnvironment[];
+    /**
+     * Shared configuration inherited by all environments.
      */
     global?: KnowledgeIntegrationConfig;
+    /**
+     * Platform-specific integration configurations for uploading generated
+     * knowledge to external services.
+     */
+    integrations?: KnowledgeIntegrations;
 }
 export interface SearchIndexerOptions {
     /**

package/dist/docs-plugin/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docs-plugin/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docs-plugin/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,UAAU,EACX,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAA;AAE7D,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GACjC,KAAK,GACL,WAAW,GACX,oBAAoB,CAAA;AAExB;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,KAAK,CAAA;IAEV;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,sBACf,SAAQ,IAAI,CACV,eAAe,EACb,OAAO,GACP,SAAS,GACT,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,QAAQ,GACR,cAAc,CACjB;IACD;;OAEG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAA;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,CAAA;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;AAEtE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAE3C,MAAM,WAAW,SACf,SAAQ,IAAI,CAAC,sBAAsB,EAAE,UAAU,GAAG,OAAO,CAAC;IAC1D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAA;IAEtB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAEhC;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAEjC;;;;OAIG;IACH,iBAAiB,CAAC,EACd,MAAM,EAAE,GACR,CAAC,CACC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,IAAI,EAAE,iBAAiB,KACpB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAE5C;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;IAEtC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAEjC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEjC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,0BAA0B;IACtE;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,CAAC,EAAE,oBAAoB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAErC;;OAEG;IACH,MAAM,CAAC,EAAE,0BAA0B,CAAA;IAEnC;;;OAGG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAA;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;IAEvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAA;IAEvB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,yBAAyB,CAAA;IAEjD;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IAEjC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAE3C;;OAEG;IACH,mBAAmB,CAAC,EAAE,qBAAqB,CAAA;CAC5C;AAED,MAAM,WAAW,aACf,SAAQ,IAAI,CACV,oBAAoB,EACpB,QAAQ,GAAG,eAAe,GAAG,cAAc,CAC5C;IACD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAA;IAE3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,mBAAmB,CAAC,EAAE,qBAAqB,CAAA;CAC5C"}

package/dist/index.js

@@ -3485,7 +3485,7 @@ var require_extra_typings = __commonJS({
 });
 
 // src/angular-demo-plugin/angular-demo-plugin.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 import { watch } from "chokidar";
 import { glob as glob2 } from "glob";
 import { existsSync } from "node:fs";
@@ -3501,7 +3501,7 @@ import {
 import { dedent as dedent2 } from "@qualcomm-ui/utils/dedent";
 
 // src/docs-plugin/docs-plugin.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import chokidar from "chokidar";
 import { glob } from "glob";
 import { readFileSync as readFileSync2 } from "node:fs";
@@ -3526,6 +3526,7 @@ var {
 } = import_index.default;
 
 // src/open-web-ui-knowledge/generate-knowledge.ts
+import chalk3 from "chalk";
 import { minimatch } from "minimatch";
 import {
   access,
@@ -3609,15 +3610,41 @@ var knowledgeIntegrationSchema = implement().with(
     exclude: z2.array(z2.string()).optional(),
     exports: knowledgeExportsSchema.optional(),
     extraFiles: z2.array(knowledgeExtraFileSchema).optional(),
+    frontmatterFields: z2.union([z2.array(z2.string()), z2.any()]).optional(),
     metadata: z2.record(z2.string(), z2.string()).optional(),
     name: z2.string().optional(),
     outputMode: z2.union([z2.literal("per-page"), z2.literal("aggregated")]).optional(),
     outputPath: z2.string().optional(),
+    pageIdPrefix: z2.string().optional(),
     pageTitlePrefix: z2.string().optional()
   }
 );
+var knowledgeEnvironmentSchema = implement().with({
+  baseUrl: z2.string().optional(),
+  description: z2.string().optional(),
+  exclude: z2.array(z2.string()).optional(),
+  exports: knowledgeExportsSchema.optional(),
+  extraFiles: z2.array(knowledgeExtraFileSchema).optional(),
+  frontmatterFields: z2.array(z2.string()).optional(),
+  id: z2.string(),
+  metadata: z2.record(z2.string(), z2.string()).optional(),
+  name: z2.string().optional(),
+  outputMode: z2.union([z2.literal("per-page"), z2.literal("aggregated")]).optional(),
+  outputPath: z2.string(),
+  pageIdPrefix: z2.string().optional(),
+  pageTitlePrefix: z2.string().optional()
+});
+var openWebUiIntegrationSchema = implement().with({
+  envFile: z2.string().optional(),
+  id: z2.string()
+});
+var knowledgeIntegrationsSchema = implement().with({
+  openWebUi: z2.array(openWebUiIntegrationSchema).optional()
+});
 var knowledgeConfigSchema = implement().with({
-  global: knowledgeIntegrationSchema.optional()
+  environments: z2.array(knowledgeEnvironmentSchema).optional(),
+  global: knowledgeIntegrationSchema.optional(),
+  integrations: knowledgeIntegrationsSchema.optional()
 });
 var configSchema = implement().with({
   appDirectory: z2.string().optional(),
@@ -5449,7 +5476,6 @@ var KnowledgeGenerator = class {
         processedPages,
         extractedMetadata
       );
-      await this.generateExtraFiles(extractedMetadata);
     }
     return pages;
   }
@@ -5503,6 +5529,7 @@ var KnowledgeGenerator = class {
       const mdxFiles = entries.filter(
         (f) => f.name.endsWith(".mdx") && !shouldExclude(join2(dirPath, f.name))
       ) ?? [];
+      const pageIdPrefix = this.config.pageIdPrefix ?? "";
       for (const mdxFile of mdxFiles) {
         const demosFolder = entries.find((f) => f.name === "demos");
         const demosFolderPath = demosFolder ? join2(dirPath, demosFolder.name) : void 0;
@@ -5514,7 +5541,7 @@ var KnowledgeGenerator = class {
         components.push({
           demosFolder: demosFolderPath,
           filePath: dirPath,
-          id: segments.join("-").trim(),
+          id: `${pageIdPrefix ? `${pageIdPrefix}-` : ""}${segments.join("-").trim()}`,
           mdxFile: join2(dirPath, mdxFile.name),
           name: segments.at(-1),
           pathname: url,
@@ -6049,9 +6076,10 @@ ${propsToDefinitionList(outputs)}`);
     console.log(`File size: ${outputSizeKb} KB`);
   }
   async generateExtraFiles(metadata) {
+    const start = performance.now();
     const extraFiles = this.config.extraFiles ?? [];
     if (extraFiles.length === 0) {
-      return;
+      return { count: 0, duration: 0, totalSize: 0 };
     }
     let totalSize = 0;
     await Promise.all(
@@ -6082,11 +6110,14 @@ ${propsToDefinitionList(outputs)}`);
         totalSize += stats.size / 1024;
       })
     );
-    console.log(
-      `Generated ${extraFiles.length} extra file(s) (${totalSize.toFixed(1)} KB)`
-    );
+    return {
+      count: extraFiles.length,
+      duration: performance.now() - start,
+      totalSize
+    };
   }
   async generatePerPageExports(pages, processedPages, metadata) {
+    const start = performance.now();
     await mkdir(dirname(this.config.outputPath), { recursive: true }).catch(
       () => {
       }
@@ -6097,15 +6128,37 @@ ${propsToDefinitionList(outputs)}`);
       processedPages.map(async (processedPage, index) => {
         const page = pages[index];
         const lines = [];
-        if (metadata.length || page.url) {
-          lines.push("---");
-          if (page.url) {
-            lines.push(`url: ${page.url}`);
-          }
-          if (metadata.length) {
-            for (const [key, value] of metadata) {
-              lines.push(`${key}: ${value}`);
+        const frontmatterEntries = [];
+        if (page.url) {
+          frontmatterEntries.push(["url", page.url]);
+        }
+        for (const [key, value] of metadata) {
+          frontmatterEntries.push([key, value]);
+        }
+        if (this.config.frontmatterFields) {
+          if (typeof this.config.frontmatterFields === "function") {
+            const transformed = this.config.frontmatterFields(
+              processedPage.frontmatter,
+              page
+            );
+            for (const [key, value] of Object.entries(transformed)) {
+              if (value !== void 0) {
+                frontmatterEntries.push([key, String(value)]);
+              }
             }
+          } else {
+            for (const field of this.config.frontmatterFields) {
+              const value = processedPage.frontmatter[field];
+              if (value !== void 0) {
+                frontmatterEntries.push([field, String(value)]);
+              }
+            }
+          }
+        }
+        if (frontmatterEntries.length > 0) {
+          lines.push("---");
+          for (const [key, value] of frontmatterEntries) {
+            lines.push(`${key}: ${value}`);
           }
           lines.push("---");
           lines.push("");
@@ -6171,8 +6224,10 @@ ${propsToDefinitionList(outputs)}`);
         totalSize += stats.size / 1024;
       })
     );
-    console.log(`Generated ${count} files(s) in ${this.config.outputPath}`);
-    console.log(`Folder size: ${totalSize.toFixed(1)} KB`);
+    const extraFilesResult = await this.generateExtraFiles(metadata);
+    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`
+    );
   }
 };
 async function generate(config2) {
@@ -6272,7 +6327,7 @@ var PluginState = class {
     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)`) : ""}`
+        `${chalk4.magenta.bold(`@qualcomm-ui/mdx-vite/docs-plugin:`)} Compiled search index in: ${chalk4.blueBright.bold(prettyMilliseconds(Date.now() - startTime))}${state.indexer.cachedFileCount ? chalk4.greenBright.bold(` (${state.indexer.cachedFileCount}/${state.indexer.mdxFileCount} files cached)`) : ""}`
       );
     }
     return compiledMdxFiles;
@@ -6351,7 +6406,7 @@ var PluginState = class {
     });
     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))}`
+      `${chalk4.magenta.bold(`@qualcomm-ui/mdx-vite/docs-plugin:`)} Generated Markdown exports in: ${chalk4.blueBright.bold(prettyMilliseconds(Date.now() - startTime))}`
     );
   }
   debouncedGenerateExports(publicDir) {
@@ -7622,15 +7677,15 @@ function angularDemoPlugin({
             langs: ["angular-ts", "angular-html", "css"],
             themes: [theme.dark, theme.light]
           });
-          logDev(`${chalk4.blue.bold(LOG_PREFIX)} Shiki highlighter initialized`);
+          logDev(`${chalk5.blue.bold(LOG_PREFIX)} Shiki highlighter initialized`);
         } catch (error) {
           console.warn(
-            `${chalk4.blue.bold(LOG_PREFIX)} Failed to initialize highlighter:`,
+            `${chalk5.blue.bold(LOG_PREFIX)} Failed to initialize highlighter:`,
             error
           );
         }
       }
-      logDev(`${chalk4.blue.bold(LOG_PREFIX)} Initializing Angular demo scanner`);
+      logDev(`${chalk5.blue.bold(LOG_PREFIX)} Initializing Angular demo scanner`);
       await collectAngularDemos();
       if (process.env.NODE_ENV === "development") {
         if (!hasWatcherInitialized) {
@@ -7638,7 +7693,7 @@ function angularDemoPlugin({
           await setupAngularWatcher();
         } else {
           logDev(
-            `${chalk4.blue.bold(LOG_PREFIX)} Watcher already initialized by another instance`
+            `${chalk5.blue.bold(LOG_PREFIX)} Watcher already initialized by another instance`
           );
         }
       }
@@ -7695,7 +7750,7 @@ function angularDemoPlugin({
         return [];
       }
       logDev(
-        `${chalk4.blue.bold(LOG_PREFIX)} Processing Angular demo change: ${chalk4.cyan(file)}`
+        `${chalk5.blue.bold(LOG_PREFIX)} Processing Angular demo change: ${chalk5.cyan(file)}`
       );
       const code = await readFile3(file, "utf-8");
       const demoInfo = await parseAngularDemo(file, code);
@@ -7749,14 +7804,14 @@ function angularDemoPlugin({
     },
     writeBundle() {
       console.log(
-        `${chalk4.blue.bold(LOG_PREFIX)} Successfully integrated ${chalk4.green(demoRegistry.size)} component demos`
+        `${chalk5.blue.bold(LOG_PREFIX)} Successfully integrated ${chalk5.green(demoRegistry.size)} component demos`
       );
     }
   };
   async function collectAngularDemos() {
     if (demoRegistry.size) {
       logDev(
-        `${chalk4.magenta.bold(LOG_PREFIX)} Using cached ${chalk4.cyanBright.bold(demoRegistry.size)} demos`
+        `${chalk5.magenta.bold(LOG_PREFIX)} Using cached ${chalk5.cyanBright.bold(demoRegistry.size)} demos`
       );
       return;
     }
@@ -7775,7 +7830,7 @@ function angularDemoPlugin({
     for (const [demoId, demo] of demoRegistry.entries()) {
       if (demo.sourceCode.find((entry) => entry.filePath === file)) {
         logDev(
-          `${chalk4.blue.bold(LOG_PREFIX)} Reloading demo ${chalk4.cyan(demoId)} due to imported file change: ${chalk4.yellow(file)}`
+          `${chalk5.blue.bold(LOG_PREFIX)} Reloading demo ${chalk5.cyan(demoId)} due to imported file change: ${chalk5.yellow(file)}`
         );
         const code = await readFile3(demo.filePath, "utf-8");
         const updatedDemo = await parseAngularDemo(demo.filePath, code);
@@ -7843,7 +7898,7 @@ function angularDemoPlugin({
       };
     } catch (error) {
       console.warn(
-        `${chalk4.blue.bold(LOG_PREFIX)} Failed to highlight code with ${language} language:`,
+        `${chalk5.blue.bold(LOG_PREFIX)} Failed to highlight code with ${language} language:`,
         error
       );
       return { full: code };
@@ -7886,7 +7941,7 @@ function angularDemoPlugin({
       return relativeImports;
     } catch (error) {
       logDev(
-        `${chalk4.blue.bold(LOG_PREFIX)} ${chalk4.yellowBright("Failed to extract imports from")} ${chalk4.cyan(filePath)}:`,
+        `${chalk5.blue.bold(LOG_PREFIX)} ${chalk5.yellowBright("Failed to extract imports from")} ${chalk5.cyan(filePath)}:`,
         error
       );
       return [];
@@ -7933,7 +7988,7 @@ function angularDemoPlugin({
       });
     } catch (error) {
       logDev(
-        `${chalk4.blue.bold(LOG_PREFIX)} ${chalk4.redBright("Failed to strip imports from")} ${chalk4.cyan(fileName)}:`,
+        `${chalk5.blue.bold(LOG_PREFIX)} ${chalk5.redBright("Failed to strip imports from")} ${chalk5.cyan(fileName)}:`,
         error
       );
       return [];
@@ -8015,7 +8070,7 @@ function angularDemoPlugin({
       };
     } catch (error) {
       console.error(
-        `${chalk4.blue.bold(LOG_PREFIX)} Failed to parse Angular demo ${filePath}:`,
+        `${chalk5.blue.bold(LOG_PREFIX)} Failed to parse Angular demo ${filePath}:`,
         error
       );
       return null;
@@ -8143,7 +8198,7 @@ function angularDemoPlugin({
       });
     } catch (error) {
       console.log(
-        `${chalk4.blue.bold(LOG_PREFIX)} ${chalk4.redBright("Failed to read template file:")} ${chalk4.cyan(templatePath)}`,
+        `${chalk5.blue.bold(LOG_PREFIX)} ${chalk5.redBright("Failed to read template file:")} ${chalk5.cyan(templatePath)}`,
         error
       );
       return null;
@@ -8164,7 +8219,7 @@ function angularDemoPlugin({
         entries.push(entry);
       } catch (error) {
         logDev(
-          `${chalk4.blue.bold(LOG_PREFIX)} ${chalk4.yellowBright("Failed to process relative import:")} ${chalk4.cyan(resolvedPath)}`
+          `${chalk5.blue.bold(LOG_PREFIX)} ${chalk5.yellowBright("Failed to process relative import:")} ${chalk5.cyan(resolvedPath)}`
         );
       }
     }
@@ -8323,7 +8378,7 @@ export function getAngularDemoInfo(demoId) {
     });
     watcher.on("ready", () => {
       logDev(
-        `${chalk4.blue.bold(LOG_PREFIX)} Registered ${chalk4.green(demoRegistry.size)} demo files. Watching for file changes...`
+        `${chalk5.blue.bold(LOG_PREFIX)} Registered ${chalk5.green(demoRegistry.size)} demo files. Watching for file changes...`
       );
     });
     watcher.on("add", async (filePath) => {
@@ -8334,7 +8389,7 @@ export function getAngularDemoInfo(demoId) {
       }
       if (isAngularDemoFile(filePath)) {
         logDev(
-          `${chalk4.blue.bold(LOG_PREFIX)} New Angular demo: ${chalk4.green(filePath)}`
+          `${chalk5.blue.bold(LOG_PREFIX)} New Angular demo: ${chalk5.green(filePath)}`
         );
         await handleAngularDemoUpdate(filePath);
         triggerRegistryUpdate();
@@ -8349,7 +8404,7 @@ export function getAngularDemoInfo(demoId) {
           const [demoId] = demoEntry;
           demoRegistry.delete(demoId);
           logDev(
-            `${chalk4.blue.bold(LOG_PREFIX)} Removed demo: ${chalk4.red(demoId)}`
+            `${chalk5.blue.bold(LOG_PREFIX)} Removed demo: ${chalk5.red(demoId)}`
           );
           triggerRegistryUpdate();
         }
@@ -8498,7 +8553,7 @@ var NODE_BUILTINS = [
 ];
 
 // src/react-demo-plugin/demo-plugin-utils.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 import { existsSync as existsSync2, readFileSync as readFileSync3 } from "node:fs";
 import { readFile as readFile4 } from "node:fs/promises";
 import { dirname as dirname3, join as join5, relative as relative4, resolve as resolve4, sep } from "node:path";
@@ -8521,7 +8576,7 @@ async function extractFileImports(filePath) {
     return extractImports(content, filePath);
   } catch (error) {
     console.log(
-      `${chalk5.magenta.bold(LOG_PREFIX2)} ${chalk5.yellowBright("Failed to parse")} ${chalk5.blueBright.bold(filePath)}:`,
+      `${chalk6.magenta.bold(LOG_PREFIX2)} ${chalk6.yellowBright("Failed to parse")} ${chalk6.blueBright.bold(filePath)}:`,
       error
     );
     return null;
@@ -8795,7 +8850,7 @@ function isDemoFile(filePath) {
 }
 
 // src/react-demo-plugin/react-demo-plugin.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import { glob as glob3 } from "glob";
 import { readFile as readFile5 } from "node:fs/promises";
 import { basename as basename3, resolve as resolve5 } from "node:path";
@@ -8842,11 +8897,11 @@ function reactDemoPlugin({
             themes: [theme.dark, theme.light]
           });
           console.log(
-            `${chalk6.magenta.bold(LOG_PREFIX2)} Shiki highlighter initialized`
+            `${chalk7.magenta.bold(LOG_PREFIX2)} Shiki highlighter initialized`
           );
         } catch (error) {
           console.warn(
-            `${chalk6.magenta.bold(LOG_PREFIX2)} Failed to initialize highlighter:`,
+            `${chalk7.magenta.bold(LOG_PREFIX2)} Failed to initialize highlighter:`,
             error
           );
         } finally {
@@ -8901,7 +8956,7 @@ function reactDemoPlugin({
     },
     writeBundle() {
       console.log(
-        `${chalk6.blue.bold(LOG_PREFIX2)} Successfully integrated ${chalk6.green(demoRegistry2.size)} component demos`
+        `${chalk7.blue.bold(LOG_PREFIX2)} Successfully integrated ${chalk7.green(demoRegistry2.size)} component demos`
       );
     }
   };
@@ -8989,7 +9044,7 @@ function reactDemoPlugin({
       };
     } catch (error) {
       console.warn(
-        `${chalk6.magenta.bold(LOG_PREFIX2)} Failed to highlight code:`,
+        `${chalk7.magenta.bold(LOG_PREFIX2)} Failed to highlight code:`,
         error
       );
       return { full: code };