@lukoweb/apitogo 0.2.22 → 0.2.24

package/src/config/validators/ModulesSchema.ts

@@ -1,502 +1,502 @@
-import type { ComponentType, ReactNode } from "react";
-import { z } from "zod";
-
-const ModuleToggleSchema = z
-  .object({
-    enabled: z
-      .boolean()
-      .describe("Whether this module is active in the application."),
-  })
-  .partial();
-
-export const DocsModuleSchema = ModuleToggleSchema.extend({
-  files: z.union([z.string(), z.array(z.string())]).optional(),
-  publishMarkdown: z.boolean().optional(),
-  defaultOptions: z
-    .object({
-      toc: z.boolean(),
-      copyPage: z.boolean().optional(),
-      disablePager: z.boolean(),
-      showLastModified: z.boolean(),
-      suggestEdit: z
-        .object({
-          url: z.string(),
-          text: z.string().optional(),
-        })
-        .optional(),
-    })
-    .partial()
-    .optional(),
-  llms: z
-    .object({
-      llmsTxt: z.boolean().optional(),
-      llmsTxtFull: z.boolean().optional(),
-      includeProtected: z.boolean().optional(),
-    })
-    .optional(),
-});
-
-export const LandingLinkSchema = z.object({
-  label: z.string(),
-  href: z.string(),
-});
-
-export const LandingFeatureSchema = z.object({
-  title: z.string(),
-  description: z.string(),
-  icon: z.string().optional(),
-});
-
-export const LandingCodeExampleSchema = z
-  .object({
-    filename: z.string().optional(),
-    language: z.string().optional(),
-    code: z.string(),
-  })
-  .optional();
-
-export const LandingHeroSchema = z
-  .object({
-    title: z.string().optional(),
-    titleAccent: z
-      .string()
-      .optional()
-      .describe(
-        "Accent-colored word or phrase shown on a new line after the title.",
-      ),
-    subtitle: z.string().optional(),
-    description: z.string().optional(),
-    badge: z.string().optional(),
-    highlights: z.array(z.string()).optional(),
-    codeExample: LandingCodeExampleSchema,
-  })
-  .optional();
-
-export const LandingFeaturesSectionSchema = z
-  .object({
-    label: z.string().optional(),
-    title: z.string().optional(),
-    description: z.string().optional(),
-  })
-  .optional();
-
-export const LandingTrustSchema = z
-  .object({
-    enabled: z.boolean().optional(),
-    title: z.string().optional(),
-    logos: z.array(z.string()).optional(),
-  })
-  .optional();
-
-export const LandingApiShowcaseItemSchema = z.object({
-  name: z.string(),
-  path: z.string(),
-  icon: z.string().optional(),
-  latency: z.string().optional(),
-  summary: z.string().optional(),
-  method: z.string().optional(),
-});
-
-export const LandingApiShowcaseSchema = z
-  .object({
-    enabled: z.boolean().optional(),
-    title: z.string().optional(),
-    subtitle: z.string().optional(),
-    browseAllHref: z.string().optional(),
-    browseAllLabel: z.string().optional(),
-    autoFromOpenApi: z.boolean().optional(),
-    layout: z.enum(["grid", "list"]).optional(),
-    items: z.array(LandingApiShowcaseItemSchema).optional(),
-  })
-  .optional();
-
-export const LandingPricingCtaSchema = z
-  .object({
-    enabled: z.boolean().optional(),
-    title: z.string().optional(),
-    description: z.string().optional(),
-    primaryAction: LandingLinkSchema.optional(),
-    secondaryAction: LandingLinkSchema.optional(),
-  })
-  .optional();
-
-export const LandingFooterBrandSchema = z
-  .object({
-    name: z.string().optional(),
-    tagline: z.string().optional(),
-    logoSrc: z.string().optional(),
-  })
-  .optional();
-
-export const LandingFooterColumnSchema = z.object({
-  title: z.string(),
-  links: z.array(LandingLinkSchema),
-});
-
-export const LandingFooterSocialSchema = z.object({
-  icon: z.string(),
-  href: z.string(),
-  label: z.string().optional(),
-});
-
-export const LandingFooterSchema = z
-  .object({
-    enabled: z.boolean().optional(),
-    brand: LandingFooterBrandSchema,
-    columns: z.array(LandingFooterColumnSchema).optional(),
-    copyright: z.string().optional(),
-    social: z.array(LandingFooterSocialSchema).optional(),
-  })
-  .optional();
-
-export const LandingContentSchema = z
-  .object({
-    hero: LandingHeroSchema,
-    featuresSection: LandingFeaturesSectionSchema,
-    features: z.array(LandingFeatureSchema).optional(),
-    primaryAction: LandingLinkSchema.optional(),
-    secondaryAction: LandingLinkSchema.optional(),
-    trust: LandingTrustSchema,
-    apiShowcase: LandingApiShowcaseSchema,
-    pricingCta: LandingPricingCtaSchema,
-    footer: LandingFooterSchema,
-    showPoweredBy: z.boolean().optional(),
-  })
-  .optional();
-
-export const DashboardContentSchema = z
-  .object({
-    title: z.string().optional(),
-    subtitle: z.string().optional(),
-    description: z.string().optional(),
-    quickLinks: z.array(LandingLinkSchema).optional(),
-  })
-  .optional();
-
-export const ProfileContentSchema = z
-  .object({
-    title: z.string().optional(),
-    description: z.string().optional(),
-  })
-  .optional();
-
-export const PlanTierSchema = z.object({
-  name: z.string(),
-  price: z.string().optional(),
-  description: z.string().optional(),
-});
-
-export const PlansContentSchema = z
-  .object({
-    title: z.string().optional(),
-    description: z.string().optional(),
-    tiers: z.array(PlanTierSchema).optional(),
-  })
-  .optional();
-
-export const SubmodulePageFields = {
-  page: z
-    .string()
-    .optional()
-    .describe(
-      "Path to a custom page component file, relative to the project root.",
-    ),
-  component: z
-    .custom<ComponentType | ReactNode>()
-    .optional()
-    .describe("Custom React component for this sub-module page."),
-};
-
-export const LandingModuleSchema = ModuleToggleSchema.extend({
-  path: z.string().default("/").describe("Route path for the landing page."),
-  component: z
-    .custom<ComponentType | ReactNode>()
-    .optional()
-    .describe("Custom React component for the landing page."),
-  page: z
-    .string()
-    .optional()
-    .describe(
-      "Path to a custom landing page component file, relative to the project root.",
-    ),
-  layout: z
-    .enum(["default", "landing", "none"])
-    .default("landing")
-    .describe(
-      "Layout wrapper: landing (header + footer), default (docs layout), or none.",
-    ),
-  content: LandingContentSchema.describe(
-    "Default landing page content when no custom component is provided.",
-  ),
-  useDefaults: z
-    .boolean()
-    .optional()
-    .describe(
-      "When true, merge DEFAULT_LANDING_CONTENT for unset sections. When false or omitted, only configured sections are shown.",
-    ),
-});
-
-export const UserManagementModuleSchema = ModuleToggleSchema.extend({
-  routes: z
-    .object({
-      login: z.string().default("/signin"),
-      register: z.string().default("/signup"),
-      profile: z.string().default("profile"),
-      logout: z.string().default("/signout"),
-    })
-    .partial()
-    .optional(),
-  page: SubmodulePageFields.page,
-  component: SubmodulePageFields.component,
-  content: ProfileContentSchema.describe(
-    "Default profile page content when no custom component is provided.",
-  ),
-});
-
-export const ApiKeysModuleSchema = ModuleToggleSchema.extend({
-  path: z
-    .string()
-    .default("settings/api-keys")
-    .describe("Route path for API key management."),
-});
-
-const PlanCatalogItemSchema = z.object({
-  sku: z.string(),
-  displayName: z.string(),
-  priceAmount: z.number().default(0),
-  pricingModel: z
-    .enum(["fixed", "custom"])
-    .optional()
-    .describe(
-      '"custom" shows a contact-sales form instead of checkout; priceAmount must be 0.',
-    ),
-  priceLabel: z
-    .string()
-    .max(64)
-    .optional()
-    .describe('Text shown instead of the price, e.g. "Custom".'),
-  priceCurrency: z
-    .string()
-    .trim()
-    .toLowerCase()
-    .regex(
-      /^[a-z]{3}$/,
-      "priceCurrency must be a 3-letter ISO 4217 code (lowercase)",
-    )
-    .optional(),
-  billingPeriod: z.string().optional(),
-  limits: z
-    .object({
-      rateLimit: z
-        .object({
-          calls: z.number(),
-          renewalPeriodSeconds: z.number().optional(),
-        })
-        .passthrough()
-        .optional(),
-      quota: z
-        .object({
-          calls: z.number(),
-          renewalPeriodDays: z.number().optional(),
-        })
-        .passthrough()
-        .optional(),
-    })
-    .passthrough()
-    .optional(),
-  limitsJson: z.string().optional(),
-  includedActionKeys: z.array(z.string()).optional(),
-});
-
-export const PlansModuleSchema = ModuleToggleSchema.extend({
-  path: z
-    .string()
-    .default("plans")
-    .describe("Route path for plans and subscription management."),
-  page: SubmodulePageFields.page,
-  component: SubmodulePageFields.component,
-  content: PlansContentSchema.describe(
-    "Default plans page content when no custom component is provided.",
-  ),
-  items: z
-    .array(PlanCatalogItemSchema)
-    .optional()
-    .describe(
-      "Gateway plan catalog for /pricing preview and publish (canonical storage).",
-    ),
-});
-
-export const DashboardModuleSchema = ModuleToggleSchema.extend({
-  path: z
-    .string()
-    .default("dashboard")
-    .describe("Route path for the user dashboard."),
-  page: SubmodulePageFields.page,
-  component: SubmodulePageFields.component,
-  content: DashboardContentSchema.describe(
-    "Default dashboard page content when no custom component is provided.",
-  ),
-});
-
-export const UserPanelModuleSchema = ModuleToggleSchema.extend({
-  basePath: z
-    .string()
-    .default("/account")
-    .describe("Base path prefix for user panel routes."),
-  dashboard: DashboardModuleSchema.optional(),
-  userManagement: UserManagementModuleSchema.optional(),
-  apiKeys: ApiKeysModuleSchema.optional(),
-  plans: PlansModuleSchema.optional(),
-});
-
-export const ModulesSchema = z
-  .object({
-    docs: DocsModuleSchema.optional().describe(
-      "Documentation module — MD/MDX pages and OpenAPI reference.",
-    ),
-    landing: LandingModuleSchema.optional().describe(
-      "Landing page module — marketing or home page.",
-    ),
-    userPanel: UserPanelModuleSchema.optional().describe(
-      "User panel module — authenticated user area with sub-modules.",
-    ),
-  })
-  .optional();
-
-export type DocsModuleConfig = z.infer<typeof DocsModuleSchema>;
-export type LandingModuleConfig = z.infer<typeof LandingModuleSchema>;
-export type UserManagementModuleConfig = z.infer<
-  typeof UserManagementModuleSchema
->;
-export type ApiKeysModuleConfig = z.infer<typeof ApiKeysModuleSchema>;
-export type PlansModuleConfig = z.infer<typeof PlansModuleSchema>;
-export type DashboardModuleConfig = z.infer<typeof DashboardModuleSchema>;
-export type UserPanelModuleConfig = z.infer<typeof UserPanelModuleSchema>;
-export type ModulesConfig = z.infer<typeof ModulesSchema>;
-
-export type ResolvedDocsModule = {
-  enabled: boolean;
-  files?: string | string[];
-  publishMarkdown?: boolean;
-  defaultOptions?: DocsModuleConfig["defaultOptions"];
-  llms?: DocsModuleConfig["llms"];
-};
-
-export type LandingLinkConfig = z.infer<typeof LandingLinkSchema>;
-export type LandingFeatureConfig = z.infer<typeof LandingFeatureSchema>;
-export type LandingContentConfig = z.infer<typeof LandingContentSchema>;
-export type DashboardContentConfig = z.infer<typeof DashboardContentSchema>;
-export type ProfileContentConfig = z.infer<typeof ProfileContentSchema>;
-export type PlansContentConfig = z.infer<typeof PlansContentSchema>;
-export type PlanTierConfig = z.infer<typeof PlanTierSchema>;
-
-export type LandingCodeExampleConfig = z.infer<typeof LandingCodeExampleSchema>;
-export type LandingTrustConfig = z.infer<typeof LandingTrustSchema>;
-export type LandingApiShowcaseItemConfig = z.infer<
-  typeof LandingApiShowcaseItemSchema
->;
-export type LandingApiShowcaseConfig = z.infer<typeof LandingApiShowcaseSchema>;
-export type LandingPricingCtaConfig = z.infer<typeof LandingPricingCtaSchema>;
-export type LandingFooterBrandConfig = z.infer<typeof LandingFooterBrandSchema>;
-export type LandingFooterColumnConfig = z.infer<
-  typeof LandingFooterColumnSchema
->;
-export type LandingFooterSocialConfig = z.infer<
-  typeof LandingFooterSocialSchema
->;
-export type LandingFooterConfig = z.infer<typeof LandingFooterSchema>;
-
-export type ResolvedLandingContent = {
-  hero?: {
-    title?: string;
-    titleAccent?: string;
-    subtitle?: string;
-    description?: string;
-    badge?: string;
-    highlights?: string[];
-    codeExample?: NonNullable<LandingCodeExampleConfig>;
-  };
-  featuresSection?: {
-    label?: string;
-    title?: string;
-    description?: string;
-  };
-  features?: LandingFeatureConfig[];
-  primaryAction?: LandingLinkConfig;
-  secondaryAction?: LandingLinkConfig;
-  trust?: LandingTrustConfig;
-  apiShowcase?: LandingApiShowcaseConfig;
-  pricingCta?: LandingPricingCtaConfig;
-  footer?: LandingFooterConfig;
-  showPoweredBy?: boolean;
-};
-
-export type ResolvedLandingModule = {
-  enabled: boolean;
-  path: string;
-  component?: ComponentType | ReactNode;
-  layout: "default" | "landing" | "none";
-  content: ResolvedLandingContent;
-};
-
-export type ResolvedDashboardContent = {
-  title?: string;
-  subtitle?: string;
-  description?: string;
-  quickLinks?: LandingLinkConfig[];
-};
-
-export type ResolvedProfileContent = {
-  title?: string;
-  description?: string;
-};
-
-export type ResolvedPlansContent = {
-  title?: string;
-  description?: string;
-  tiers?: PlanTierConfig[];
-};
-
-export type ResolvedUserManagementModule = {
-  enabled: boolean;
-  routes: {
-    login: string;
-    register: string;
-    profile: string;
-    logout: string;
-  };
-  content: ResolvedProfileContent;
-};
-
-export type ResolvedApiKeysModule = {
-  enabled: boolean;
-  path: string;
-};
-
-export type ResolvedPlansModule = {
-  enabled: boolean;
-  path: string;
-  content: ResolvedPlansContent;
-  items?: z.infer<typeof PlanCatalogItemSchema>[];
-};
-
-export type ResolvedDashboardModule = {
-  enabled: boolean;
-  path: string;
-  content: ResolvedDashboardContent;
-};
-
-export type ResolvedUserPanelModule = {
-  enabled: boolean;
-  basePath: string;
-  dashboard: ResolvedDashboardModule;
-  userManagement: ResolvedUserManagementModule;
-  apiKeys: ResolvedApiKeysModule;
-  plans: ResolvedPlansModule;
-};
-
-export type ResolvedModulesConfig = {
-  docs: ResolvedDocsModule;
-  landing: ResolvedLandingModule;
-  userPanel: ResolvedUserPanelModule;
-};
+import type { ComponentType, ReactNode } from "react";
+import { z } from "zod";
+
+const ModuleToggleSchema = z
+  .object({
+    enabled: z
+      .boolean()
+      .describe("Whether this module is active in the application."),
+  })
+  .partial();
+
+export const DocsModuleSchema = ModuleToggleSchema.extend({
+  files: z.union([z.string(), z.array(z.string())]).optional(),
+  publishMarkdown: z.boolean().optional(),
+  defaultOptions: z
+    .object({
+      toc: z.boolean(),
+      copyPage: z.boolean().optional(),
+      disablePager: z.boolean(),
+      showLastModified: z.boolean(),
+      suggestEdit: z
+        .object({
+          url: z.string(),
+          text: z.string().optional(),
+        })
+        .optional(),
+    })
+    .partial()
+    .optional(),
+  llms: z
+    .object({
+      llmsTxt: z.boolean().optional(),
+      llmsTxtFull: z.boolean().optional(),
+      includeProtected: z.boolean().optional(),
+    })
+    .optional(),
+});
+
+export const LandingLinkSchema = z.object({
+  label: z.string(),
+  href: z.string(),
+});
+
+export const LandingFeatureSchema = z.object({
+  title: z.string(),
+  description: z.string(),
+  icon: z.string().optional(),
+});
+
+export const LandingCodeExampleSchema = z
+  .object({
+    filename: z.string().optional(),
+    language: z.string().optional(),
+    code: z.string(),
+  })
+  .optional();
+
+export const LandingHeroSchema = z
+  .object({
+    title: z.string().optional(),
+    titleAccent: z
+      .string()
+      .optional()
+      .describe(
+        "Accent-colored word or phrase shown on a new line after the title.",
+      ),
+    subtitle: z.string().optional(),
+    description: z.string().optional(),
+    badge: z.string().optional(),
+    highlights: z.array(z.string()).optional(),
+    codeExample: LandingCodeExampleSchema,
+  })
+  .optional();
+
+export const LandingFeaturesSectionSchema = z
+  .object({
+    label: z.string().optional(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+  })
+  .optional();
+
+export const LandingTrustSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    title: z.string().optional(),
+    logos: z.array(z.string()).optional(),
+  })
+  .optional();
+
+export const LandingApiShowcaseItemSchema = z.object({
+  name: z.string(),
+  path: z.string(),
+  icon: z.string().optional(),
+  latency: z.string().optional(),
+  summary: z.string().optional(),
+  method: z.string().optional(),
+});
+
+export const LandingApiShowcaseSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    title: z.string().optional(),
+    subtitle: z.string().optional(),
+    browseAllHref: z.string().optional(),
+    browseAllLabel: z.string().optional(),
+    autoFromOpenApi: z.boolean().optional(),
+    layout: z.enum(["grid", "list"]).optional(),
+    items: z.array(LandingApiShowcaseItemSchema).optional(),
+  })
+  .optional();
+
+export const LandingPricingCtaSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    primaryAction: LandingLinkSchema.optional(),
+    secondaryAction: LandingLinkSchema.optional(),
+  })
+  .optional();
+
+export const LandingFooterBrandSchema = z
+  .object({
+    name: z.string().optional(),
+    tagline: z.string().optional(),
+    logoSrc: z.string().optional(),
+  })
+  .optional();
+
+export const LandingFooterColumnSchema = z.object({
+  title: z.string(),
+  links: z.array(LandingLinkSchema),
+});
+
+export const LandingFooterSocialSchema = z.object({
+  icon: z.string(),
+  href: z.string(),
+  label: z.string().optional(),
+});
+
+export const LandingFooterSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    brand: LandingFooterBrandSchema,
+    columns: z.array(LandingFooterColumnSchema).optional(),
+    copyright: z.string().optional(),
+    social: z.array(LandingFooterSocialSchema).optional(),
+  })
+  .optional();
+
+export const LandingContentSchema = z
+  .object({
+    hero: LandingHeroSchema,
+    featuresSection: LandingFeaturesSectionSchema,
+    features: z.array(LandingFeatureSchema).optional(),
+    primaryAction: LandingLinkSchema.optional(),
+    secondaryAction: LandingLinkSchema.optional(),
+    trust: LandingTrustSchema,
+    apiShowcase: LandingApiShowcaseSchema,
+    pricingCta: LandingPricingCtaSchema,
+    footer: LandingFooterSchema,
+    showPoweredBy: z.boolean().optional(),
+  })
+  .optional();
+
+export const DashboardContentSchema = z
+  .object({
+    title: z.string().optional(),
+    subtitle: z.string().optional(),
+    description: z.string().optional(),
+    quickLinks: z.array(LandingLinkSchema).optional(),
+  })
+  .optional();
+
+export const ProfileContentSchema = z
+  .object({
+    title: z.string().optional(),
+    description: z.string().optional(),
+  })
+  .optional();
+
+export const PlanTierSchema = z.object({
+  name: z.string(),
+  price: z.string().optional(),
+  description: z.string().optional(),
+});
+
+export const PlansContentSchema = z
+  .object({
+    title: z.string().optional(),
+    description: z.string().optional(),
+    tiers: z.array(PlanTierSchema).optional(),
+  })
+  .optional();
+
+export const SubmodulePageFields = {
+  page: z
+    .string()
+    .optional()
+    .describe(
+      "Path to a custom page component file, relative to the project root.",
+    ),
+  component: z
+    .custom<ComponentType | ReactNode>()
+    .optional()
+    .describe("Custom React component for this sub-module page."),
+};
+
+export const LandingModuleSchema = ModuleToggleSchema.extend({
+  path: z.string().default("/").describe("Route path for the landing page."),
+  component: z
+    .custom<ComponentType | ReactNode>()
+    .optional()
+    .describe("Custom React component for the landing page."),
+  page: z
+    .string()
+    .optional()
+    .describe(
+      "Path to a custom landing page component file, relative to the project root.",
+    ),
+  layout: z
+    .enum(["default", "landing", "none"])
+    .default("landing")
+    .describe(
+      "Layout wrapper: landing (header + footer), default (docs layout), or none.",
+    ),
+  content: LandingContentSchema.describe(
+    "Default landing page content when no custom component is provided.",
+  ),
+  useDefaults: z
+    .boolean()
+    .optional()
+    .describe(
+      "When true, merge DEFAULT_LANDING_CONTENT for unset sections. When false or omitted, only configured sections are shown.",
+    ),
+});
+
+export const UserManagementModuleSchema = ModuleToggleSchema.extend({
+  routes: z
+    .object({
+      login: z.string().default("/signin"),
+      register: z.string().default("/signup"),
+      profile: z.string().default("profile"),
+      logout: z.string().default("/signout"),
+    })
+    .partial()
+    .optional(),
+  page: SubmodulePageFields.page,
+  component: SubmodulePageFields.component,
+  content: ProfileContentSchema.describe(
+    "Default profile page content when no custom component is provided.",
+  ),
+});
+
+export const ApiKeysModuleSchema = ModuleToggleSchema.extend({
+  path: z
+    .string()
+    .default("settings/api-keys")
+    .describe("Route path for API key management."),
+});
+
+const PlanCatalogItemSchema = z.object({
+  sku: z.string(),
+  displayName: z.string(),
+  priceAmount: z.number().default(0),
+  pricingModel: z
+    .enum(["fixed", "custom"])
+    .optional()
+    .describe(
+      '"custom" shows a contact-sales form instead of checkout; priceAmount must be 0.',
+    ),
+  priceLabel: z
+    .string()
+    .max(64)
+    .optional()
+    .describe('Text shown instead of the price, e.g. "Custom".'),
+  priceCurrency: z
+    .string()
+    .trim()
+    .toLowerCase()
+    .regex(
+      /^[a-z]{3}$/,
+      "priceCurrency must be a 3-letter ISO 4217 code (lowercase)",
+    )
+    .optional(),
+  billingPeriod: z.string().optional(),
+  limits: z
+    .object({
+      rateLimit: z
+        .object({
+          calls: z.number(),
+          renewalPeriodSeconds: z.number().optional(),
+        })
+        .passthrough()
+        .optional(),
+      quota: z
+        .object({
+          calls: z.number(),
+          renewalPeriodDays: z.number().optional(),
+        })
+        .passthrough()
+        .optional(),
+    })
+    .passthrough()
+    .optional(),
+  limitsJson: z.string().optional(),
+  includedActionKeys: z.array(z.string()).optional(),
+});
+
+export const PlansModuleSchema = ModuleToggleSchema.extend({
+  path: z
+    .string()
+    .default("plans")
+    .describe("Route path for plans and subscription management."),
+  page: SubmodulePageFields.page,
+  component: SubmodulePageFields.component,
+  content: PlansContentSchema.describe(
+    "Default plans page content when no custom component is provided.",
+  ),
+  items: z
+    .array(PlanCatalogItemSchema)
+    .optional()
+    .describe(
+      "Gateway plan catalog for /pricing preview and publish (canonical storage).",
+    ),
+});
+
+export const DashboardModuleSchema = ModuleToggleSchema.extend({
+  path: z
+    .string()
+    .default("dashboard")
+    .describe("Route path for the user dashboard."),
+  page: SubmodulePageFields.page,
+  component: SubmodulePageFields.component,
+  content: DashboardContentSchema.describe(
+    "Default dashboard page content when no custom component is provided.",
+  ),
+});
+
+export const UserPanelModuleSchema = ModuleToggleSchema.extend({
+  basePath: z
+    .string()
+    .default("/account")
+    .describe("Base path prefix for user panel routes."),
+  dashboard: DashboardModuleSchema.optional(),
+  userManagement: UserManagementModuleSchema.optional(),
+  apiKeys: ApiKeysModuleSchema.optional(),
+  plans: PlansModuleSchema.optional(),
+});
+
+export const ModulesSchema = z
+  .object({
+    docs: DocsModuleSchema.optional().describe(
+      "Documentation module — MD/MDX pages and OpenAPI reference.",
+    ),
+    landing: LandingModuleSchema.optional().describe(
+      "Landing page module — marketing or home page.",
+    ),
+    userPanel: UserPanelModuleSchema.optional().describe(
+      "User panel module — authenticated user area with sub-modules.",
+    ),
+  })
+  .optional();
+
+export type DocsModuleConfig = z.infer<typeof DocsModuleSchema>;
+export type LandingModuleConfig = z.infer<typeof LandingModuleSchema>;
+export type UserManagementModuleConfig = z.infer<
+  typeof UserManagementModuleSchema
+>;
+export type ApiKeysModuleConfig = z.infer<typeof ApiKeysModuleSchema>;
+export type PlansModuleConfig = z.infer<typeof PlansModuleSchema>;
+export type DashboardModuleConfig = z.infer<typeof DashboardModuleSchema>;
+export type UserPanelModuleConfig = z.infer<typeof UserPanelModuleSchema>;
+export type ModulesConfig = z.infer<typeof ModulesSchema>;
+
+export type ResolvedDocsModule = {
+  enabled: boolean;
+  files?: string | string[];
+  publishMarkdown?: boolean;
+  defaultOptions?: DocsModuleConfig["defaultOptions"];
+  llms?: DocsModuleConfig["llms"];
+};
+
+export type LandingLinkConfig = z.infer<typeof LandingLinkSchema>;
+export type LandingFeatureConfig = z.infer<typeof LandingFeatureSchema>;
+export type LandingContentConfig = z.infer<typeof LandingContentSchema>;
+export type DashboardContentConfig = z.infer<typeof DashboardContentSchema>;
+export type ProfileContentConfig = z.infer<typeof ProfileContentSchema>;
+export type PlansContentConfig = z.infer<typeof PlansContentSchema>;
+export type PlanTierConfig = z.infer<typeof PlanTierSchema>;
+
+export type LandingCodeExampleConfig = z.infer<typeof LandingCodeExampleSchema>;
+export type LandingTrustConfig = z.infer<typeof LandingTrustSchema>;
+export type LandingApiShowcaseItemConfig = z.infer<
+  typeof LandingApiShowcaseItemSchema
+>;
+export type LandingApiShowcaseConfig = z.infer<typeof LandingApiShowcaseSchema>;
+export type LandingPricingCtaConfig = z.infer<typeof LandingPricingCtaSchema>;
+export type LandingFooterBrandConfig = z.infer<typeof LandingFooterBrandSchema>;
+export type LandingFooterColumnConfig = z.infer<
+  typeof LandingFooterColumnSchema
+>;
+export type LandingFooterSocialConfig = z.infer<
+  typeof LandingFooterSocialSchema
+>;
+export type LandingFooterConfig = z.infer<typeof LandingFooterSchema>;
+
+export type ResolvedLandingContent = {
+  hero?: {
+    title?: string;
+    titleAccent?: string;
+    subtitle?: string;
+    description?: string;
+    badge?: string;
+    highlights?: string[];
+    codeExample?: NonNullable<LandingCodeExampleConfig>;
+  };
+  featuresSection?: {
+    label?: string;
+    title?: string;
+    description?: string;
+  };
+  features?: LandingFeatureConfig[];
+  primaryAction?: LandingLinkConfig;
+  secondaryAction?: LandingLinkConfig;
+  trust?: LandingTrustConfig;
+  apiShowcase?: LandingApiShowcaseConfig;
+  pricingCta?: LandingPricingCtaConfig;
+  footer?: LandingFooterConfig;
+  showPoweredBy?: boolean;
+};
+
+export type ResolvedLandingModule = {
+  enabled: boolean;
+  path: string;
+  component?: ComponentType | ReactNode;
+  layout: "default" | "landing" | "none";
+  content: ResolvedLandingContent;
+};
+
+export type ResolvedDashboardContent = {
+  title?: string;
+  subtitle?: string;
+  description?: string;
+  quickLinks?: LandingLinkConfig[];
+};
+
+export type ResolvedProfileContent = {
+  title?: string;
+  description?: string;
+};
+
+export type ResolvedPlansContent = {
+  title?: string;
+  description?: string;
+  tiers?: PlanTierConfig[];
+};
+
+export type ResolvedUserManagementModule = {
+  enabled: boolean;
+  routes: {
+    login: string;
+    register: string;
+    profile: string;
+    logout: string;
+  };
+  content: ResolvedProfileContent;
+};
+
+export type ResolvedApiKeysModule = {
+  enabled: boolean;
+  path: string;
+};
+
+export type ResolvedPlansModule = {
+  enabled: boolean;
+  path: string;
+  content: ResolvedPlansContent;
+  items?: z.infer<typeof PlanCatalogItemSchema>[];
+};
+
+export type ResolvedDashboardModule = {
+  enabled: boolean;
+  path: string;
+  content: ResolvedDashboardContent;
+};
+
+export type ResolvedUserPanelModule = {
+  enabled: boolean;
+  basePath: string;
+  dashboard: ResolvedDashboardModule;
+  userManagement: ResolvedUserManagementModule;
+  apiKeys: ResolvedApiKeysModule;
+  plans: ResolvedPlansModule;
+};
+
+export type ResolvedModulesConfig = {
+  docs: ResolvedDocsModule;
+  landing: ResolvedLandingModule;
+  userPanel: ResolvedUserPanelModule;
+};