@mintlify/validation 0.1.891 → 0.1.893

package/dist/index.js

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 import { mintConfigSchema } from './mint-config/schemas/v1/config.js';
 import { docsConfigSchema } from './mint-config/schemas/v2/index.js';
@@ -36,7 +37,14 @@ export { collectOpenApiOverlayConfig, normalizeOpenApiSourceKey, } from './mint-
 export { overlayDocumentSchema, overlayActionSchema, overlayInfoSchema, isOverlayDocument, parseOverlayDocument, safeParseOverlayDocument, } from './openapi/overlay.js';
 export { convertMintDecoratedNavToDocsDecoratedNav } from './mint-config/upgrades/convertMintDecoratedNavToDocsDecoratedNav.js';
 export const mintConfigJsonSchema = zodToJsonSchema(mintConfigSchema, 'Schema');
-export const docsConfigJsonSchema = zodToJsonSchema(docsConfigSchema, {
+const omitUnreleasedKeys = (schema) => schema.omit({ packages: true });
+const [firstThemeSchema, secondThemeSchema, ...otherThemeSchemas] = docsConfigSchema.options;
+const publicDocsConfigSchema = z.union([
+    omitUnreleasedKeys(firstThemeSchema),
+    omitUnreleasedKeys(secondThemeSchema),
+    ...otherThemeSchemas.map(omitUnreleasedKeys),
+]);
+export const docsConfigJsonSchema = zodToJsonSchema(publicDocsConfigSchema, {
     definitions: {
         anchorSchema,
         anchorsSchema,

package/dist/mint-config/schemas/v2/index.d.ts

@@ -1866,6 +1866,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"mint">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -2307,6 +2326,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "mint";
@@ -2747,6 +2773,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>, z.ZodObject<{
     $schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     name: z.ZodString;
@@ -4611,6 +4638,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"maple">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -5052,6 +5098,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "maple";
@@ -5492,6 +5545,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>, z.ZodObject<{
     $schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     name: z.ZodString;
@@ -7356,6 +7410,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"palm">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -7797,6 +7870,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "palm";
@@ -8237,6 +8317,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>, z.ZodObject<{
     variations: z.ZodOptional<z.ZodEffects<z.ZodObject<{
         options: z.ZodArray<z.ZodObject<{
@@ -10133,6 +10214,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"willow">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -10574,6 +10674,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
     variations?: {
         options: {
             id: string;
@@ -11020,6 +11127,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
     variations?: {
         options: {
             id: string;
@@ -12890,6 +12998,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"linden">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -13331,6 +13458,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "linden";
@@ -13771,6 +13905,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>, z.ZodObject<{
     $schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     name: z.ZodString;
@@ -15635,6 +15770,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"almond">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -16076,6 +16230,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "almond";
@@ -16516,6 +16677,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>, z.ZodObject<{
     $schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     name: z.ZodString;
@@ -18380,6 +18542,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"aspen">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -18821,6 +19002,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "aspen";
@@ -19261,6 +19449,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>, z.ZodObject<{
     $schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     name: z.ZodString;
@@ -21125,6 +21314,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"luma">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -21566,6 +21774,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "luma";
@@ -22006,6 +22221,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>, z.ZodObject<{
     $schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     name: z.ZodString;
@@ -23870,6 +24086,25 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodLiteral<"sequoia">;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -24311,6 +24546,13 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "sequoia";
@@ -24751,6 +24993,7 @@ export declare const docsConfigSchema: z.ZodDiscriminatedUnion<"theme", [z.ZodOb
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>]>;
 export declare const docsConfigUnifiedSchema: z.ZodObject<{
     $schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -26616,6 +26859,25 @@ export declare const docsConfigUnifiedSchema: z.ZodObject<{
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     }>>>;
+    packages: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+        css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        ssr: z.ZodOptional<z.ZodBoolean>;
+        isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+    }, "strip", z.ZodTypeAny, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }, {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    }>>>;
     theme: z.ZodEnum<["mint", "maple", "palm", "willow", "linden", "almond", "aspen", "luma", "sequoia"]>;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -27057,6 +27319,13 @@ export declare const docsConfigUnifiedSchema: z.ZodObject<{
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: {
+        registries?: Record<string, string> | undefined;
+        css?: string[] | undefined;
+        provider?: string | undefined;
+        ssr?: boolean | undefined;
+        isolation?: "page" | "frame" | undefined;
+    } | undefined;
 }, {
     name: string;
     theme: "mint" | "maple" | "palm" | "willow" | "linden" | "almond" | "aspen" | "luma" | "sequoia";
@@ -27497,4 +27766,5 @@ export declare const docsConfigUnifiedSchema: z.ZodObject<{
         schema?: boolean | undefined;
         instructions?: string | string[] | undefined;
     } | undefined;
+    packages?: unknown;
 }>;

package/dist/mint-config/schemas/v2/properties/index.d.ts

@@ -19,3 +19,4 @@ export * from './thumbnails.js';
 export * from './metadata.js';
 export * from './variations.js';
 export * from './shikiThemes.js';
+export * from './packages.js';

package/dist/mint-config/schemas/v2/properties/index.js

@@ -19,3 +19,4 @@ export * from './thumbnails.js';
 export * from './metadata.js';
 export * from './variations.js';
 export * from './shikiThemes.js';
+export * from './packages.js';

package/dist/mint-config/schemas/v2/properties/packages.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const PACKAGE_SCOPE_REGEX: RegExp;
+export declare const packageIsolationModes: readonly ["page", "frame"];
+export declare const packagesSchema: z.ZodObject<{
+    registries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    css: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    provider: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    ssr: z.ZodOptional<z.ZodBoolean>;
+    isolation: z.ZodOptional<z.ZodEnum<["page", "frame"]>>;
+}, "strip", z.ZodTypeAny, {
+    registries?: Record<string, string> | undefined;
+    css?: string[] | undefined;
+    provider?: string | undefined;
+    ssr?: boolean | undefined;
+    isolation?: "page" | "frame" | undefined;
+}, {
+    registries?: Record<string, string> | undefined;
+    css?: string[] | undefined;
+    provider?: string | undefined;
+    ssr?: boolean | undefined;
+    isolation?: "page" | "frame" | undefined;
+}>;
+export type PackagesConfig = z.infer<typeof packagesSchema>;
+export type PackageIsolationMode = (typeof packageIsolationModes)[number];

package/dist/mint-config/schemas/v2/properties/packages.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+export const PACKAGE_SCOPE_REGEX = /^@[a-z0-9-~][a-z0-9-._~]*$/;
+export const packageIsolationModes = ['page', 'frame'];
+const registryScopeSchema = z
+    .string()
+    .regex(PACKAGE_SCOPE_REGEX, 'Registry keys must be npm scopes such as `@acme` (lowercase, starting with `@`)');
+const WHITESPACE_OR_CONTROL_REGEX = /[\s\u0000-\u001f\u007f]/;
+const MAX_REGISTRY_URL_LENGTH = 512;
+const registryUrlProblem = (value) => {
+    if (WHITESPACE_OR_CONTROL_REGEX.test(value))
+        return 'Registry URLs cannot contain whitespace';
+    if (value.includes('${')) {
+        return 'Registry URLs cannot contain `${`, which npm expands from environment variables';
+    }
+    if (/[;#\\]/.test(value)) {
+        return 'Registry URLs cannot contain `;`, `#` or `\\`, which npm reads as a comment or escape in .npmrc';
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch (_a) {
+        return undefined;
+    }
+    if (url.username !== '' || url.password !== '') {
+        return 'Registry URLs cannot include a username, password or token';
+    }
+    if (value.includes('?') || url.hash !== '') {
+        return 'Registry URLs cannot include a query string or fragment';
+    }
+    if (url.href.includes('${') || /[;#\\]/.test(url.href)) {
+        return 'Registry URLs cannot parse to a URL with `${`, `;`, `#` or `\\`, such as from full-width characters in the host, which npm rewrites in .npmrc';
+    }
+    if (url.hostname.includes('=') || url.pathname.includes('=')) {
+        return 'Registry URLs cannot have `=` in the host or path, which npm reads as the end of the auth token key in .npmrc';
+    }
+    return undefined;
+};
+const registryUrlSchema = z
+    .string()
+    .max(MAX_REGISTRY_URL_LENGTH, `Registry URLs cannot be longer than ${MAX_REGISTRY_URL_LENGTH} characters`)
+    .url('Must be a valid URL')
+    .regex(/^https:\/\/[^/]/, 'Registry URLs must start with `https://` and then the host')
+    .superRefine((value, ctx) => {
+    const message = registryUrlProblem(value);
+    if (message)
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message });
+});
+const URL_SCHEME_REGEX = /^[a-z][a-z\d+.-]*:/i;
+const isPackageCssPath = (value) => !/^[./\\]/.test(value) && !URL_SCHEME_REGEX.test(value) && !value.split(/[\\/]/).includes('..');
+const cssEntrySchema = z
+    .string()
+    .min(1, 'CSS entries cannot be empty')
+    .refine(isPackageCssPath, 'CSS entries must be paths inside an installed package, such as `@acme/ui/dist/styles.css`');
+const providerPathProblem = (value) => {
+    if (value === '')
+        return undefined;
+    const path = value.replace(/\\/g, '/');
+    const segments = path.replace(/^\/+/, '').split('/');
+    if (segments.includes('..'))
+        return 'Provider path cannot contain `..` segments';
+    if (segments.includes('')) {
+        return 'Provider path must name a file, such as `/snippets/provider.jsx`, with no empty segments or trailing slash';
+    }
+    const stripped = path.replace(/[?#].*$/, '');
+    const strippedRel = stripped.replace(/^\/+|\/+$/g, '');
+    const searched = strippedRel === '' || strippedRel.split('/').includes('..') ? path : stripped;
+    if (searched.split('/').slice(0, -1).includes('node_modules')) {
+        return 'Provider path cannot be inside a `node_modules` folder';
+    }
+    if (!value.startsWith('/')) {
+        return 'Provider path must start with `/`, such as `/snippets/provider.jsx`';
+    }
+    if (segments.some((seg) => /[:\0]/.test(seg) || (seg !== '.' && /[. ]$/.test(seg)))) {
+        return 'Provider path cannot contain `:` or NUL, or a name that ends in `.` or a space';
+    }
+    return undefined;
+};
+const providerPathSchema = z
+    .string()
+    .min(1, 'Provider path cannot be empty')
+    .superRefine((value, ctx) => {
+    const message = providerPathProblem(value);
+    if (message)
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message });
+});
+export const packagesSchema = z
+    .object({
+    registries: z
+        .record(registryScopeSchema, registryUrlSchema)
+        .optional()
+        .describe('Registry to install each npm scope from, e.g. `{ "@acme": "https://npm.acme.com/" }`. One registry per scope. Unscoped packages always install from registry.npmjs.org.'),
+    css: z
+        .array(cssEntrySchema)
+        .optional()
+        .describe('Compiled CSS files shipped by your packages to load on every page, e.g. `@acme/ui/dist/styles.css`'),
+    provider: providerPathSchema
+        .optional()
+        .describe('Path to a snippet that exports a `Provider` component, e.g. `/snippets/provider.jsx`. It wraps every package component.'),
+    ssr: z
+        .boolean()
+        .optional()
+        .describe('Whether to render package components to HTML at build time so they show before their JavaScript loads. Defaults to true.'),
+    isolation: z
+        .enum(packageIsolationModes)
+        .optional()
+        .describe('How package components run in the browser. `page` (default) renders them in the docs page; `frame` runs each one in a sandboxed iframe.'),
+})
+    .describe('Use npm packages from package.json in MDX pages and snippets. Adding this key, even as `{}`, turns the feature on. Requires a package-lock.json or pnpm-lock.yaml next to docs.json.');