@lukoweb/apitogo 0.1.24 → 0.1.38

package/dist/flat-config.d.ts

@@ -57,31 +57,35 @@ export type _Schema9 = (("Inter" | "Roboto" | "Open Sans" | "Poppins" | "Montser
   url: string
   fontFamily?: string
 })
-export type _Schema14 = ({
+/**
+ * Whether this module is active in the application.
+ */
+export type _Schema15 = boolean
+export type _Schema35 = ({
   type: "url"
-  input: (string | _Schema15[])
-  server?: _Schema16
-  path?: _Schema17
-  categories?: _Schema18
-  options?: _Schema20
+  input: (string | _Schema36[])
+  server?: _Schema37
+  path?: _Schema38
+  categories?: _Schema39
+  options?: _Schema41
 } | {
   type: "file"
-  input: (string | (string | _Schema15)[])
-  server?: _Schema16
-  path?: _Schema17
-  categories?: _Schema18
-  options?: _Schema20
+  input: (string | (string | _Schema36)[])
+  server?: _Schema37
+  path?: _Schema38
+  categories?: _Schema39
+  options?: _Schema41
 } | {
   type: "raw"
   input: string
-  server?: _Schema16
-  path?: _Schema17
-  categories?: _Schema18
-  options?: _Schema20
+  server?: _Schema37
+  path?: _Schema38
+  categories?: _Schema39
+  options?: _Schema41
 })
-export type _Schema16 = string
-export type _Schema17 = string
-export type _Schema18 = {
+export type _Schema37 = string
+export type _Schema38 = string
+export type _Schema39 = {
   label: string
   tags: string[]
 }[]
@@ -301,6 +305,12 @@ export interface FlatZudokuConfig {
     redirectToAfterSignUp?: string
     redirectToAfterSignIn?: string
     redirectToAfterSignOut?: string
+  } | {
+    type: "dev-portal"
+    apiBaseUrl?: string
+    redirectToAfterSignUp?: string
+    redirectToAfterSignIn?: string
+    redirectToAfterSignOut?: string
   })
   search?: ({
     type: "inkeep"
@@ -353,8 +363,13 @@ export interface FlatZudokuConfig {
       includeProtected?: boolean
     }
   }
-  apis?: (_Schema14 | _Schema14[])
-  catalogs?: (_Schema21 | _Schema21[])
+  modules?: {
+    docs?: _Schema14
+    landing?: _Schema16
+    userPanel?: _Schema23
+  }
+  apis?: (_Schema35 | _Schema35[])
+  catalogs?: (_Schema42 | _Schema42[])
   apiKeys?: {
     enabled: boolean
     getConsumers?: unknown
@@ -382,7 +397,7 @@ export interface FlatZudokuConfig {
   }
   enableStatusPages?: boolean
   defaults?: {
-    apis: _Schema20
+    apis: _Schema41
     examplesLanguage?: string
   }
   __pluginDirs?: string[]
@@ -432,12 +447,182 @@ export interface _Schema8 {
   ring?: string
   radius?: string
 }
-export interface _Schema15 {
+/**
+ * Documentation module — MD/MDX pages and OpenAPI reference.
+ */
+export interface _Schema14 {
+  enabled?: _Schema15
+  files?: (string | string[])
+  publishMarkdown?: boolean
+  defaultOptions?: {
+    toc?: boolean
+    copyPage?: boolean
+    disablePager?: boolean
+    showLastModified?: boolean
+    suggestEdit?: {
+      url: string
+      text?: string
+    }
+  }
+  llms?: {
+    llmsTxt?: boolean
+    llmsTxtFull?: boolean
+    includeProtected?: boolean
+  }
+}
+/**
+ * Landing page module — marketing or home page.
+ */
+export interface _Schema16 {
+  enabled?: _Schema15
+  /**
+   * Route path for the landing page.
+   */
+  path?: string
+  /**
+   * Custom React component for the landing page.
+   */
+  component?: {
+    [k: string]: unknown
+  }
+  /**
+   * Path to a custom landing page component file, relative to the project root.
+   */
+  page?: string
+  /**
+   * Layout wrapper: landing (header + footer), default (docs layout), or none.
+   */
+  layout?: ("default" | "landing" | "none")
+  content?: _Schema21
+}
+/**
+ * Default landing page content when no custom component is provided.
+ */
+export interface _Schema21 {
+  hero?: {
+    title?: string
+    subtitle?: string
+    description?: string
+  }
+  features?: {
+    title: string
+    description: string
+  }[]
+  primaryAction?: _Schema22
+  secondaryAction?: _Schema22
+  showPoweredBy?: boolean
+}
+export interface _Schema22 {
+  label: string
+  href: string
+}
+/**
+ * User panel module — authenticated user area with sub-modules.
+ */
+export interface _Schema23 {
+  enabled?: _Schema15
+  /**
+   * Base path prefix for user panel routes.
+   */
+  basePath?: string
+  dashboard?: {
+    enabled?: _Schema15
+    /**
+     * Route path for the user dashboard.
+     */
+    path?: string
+    /**
+     * Path to a custom page component file, relative to the project root.
+     */
+    page?: string
+    /**
+     * Custom React component for this sub-module page.
+     */
+    component?: {
+      [k: string]: unknown
+    }
+    content?: _Schema30
+  }
+  userManagement?: {
+    enabled?: _Schema15
+    routes?: {
+      login?: string
+      register?: string
+      profile?: string
+      logout?: string
+    }
+    /**
+     * Path to a custom page component file, relative to the project root.
+     */
+    page?: string
+    /**
+     * Custom React component for this sub-module page.
+     */
+    component?: {
+      [k: string]: unknown
+    }
+    content?: _Schema31
+  }
+  apiKeys?: {
+    enabled?: _Schema15
+    /**
+     * Route path for API key management.
+     */
+    path?: string
+  }
+  plans?: {
+    enabled?: _Schema15
+    /**
+     * Route path for plans and subscription management.
+     */
+    path?: string
+    /**
+     * Path to a custom page component file, relative to the project root.
+     */
+    page?: string
+    /**
+     * Custom React component for this sub-module page.
+     */
+    component?: {
+      [k: string]: unknown
+    }
+    content?: _Schema34
+  }
+}
+/**
+ * Default dashboard page content when no custom component is provided.
+ */
+export interface _Schema30 {
+  title?: string
+  subtitle?: string
+  description?: string
+  quickLinks?: _Schema22[]
+}
+/**
+ * Default profile page content when no custom component is provided.
+ */
+export interface _Schema31 {
+  title?: string
+  description?: string
+}
+/**
+ * Default plans page content when no custom component is provided.
+ */
+export interface _Schema34 {
+  title?: string
+  description?: string
+  tiers?: {
+    name: string
+    price?: string
+    description?: string
+  }[]
+}
+export interface _Schema36 {
   path: string
   input: string
   label?: string
 }
-export interface _Schema20 {
+export interface _Schema41 {
   examplesLanguage?: string
   supportedLanguages?: {
     value: string
@@ -454,7 +639,7 @@ export interface _Schema20 {
   transformExamples?: unknown
   generateCodeSnippet?: unknown
 }
-export interface _Schema21 {
+export interface _Schema42 {
   path: string
   label: string
   items?: string[]

package/docs/components/alert.mdx

@@ -0,0 +1,130 @@
+---
+title: Alert
+sidebar_icon: triangle-alert
+---
+
+import { Alert, AlertDescription, AlertTitle } from "@lukoweb/apitogo/ui/Alert";
+import { CheckCircle2Icon, TerminalIcon } from "@lukoweb/apitogo/icons";
+import { ReactComponentDoc } from "@lukoweb/apitogo/ui/ReactComponentDoc";
+
+An alert component for displaying important information to users with different severity levels.
+
+## Import
+
+```tsx
+import { Alert, AlertDescription, AlertTitle } from "@lukoweb/apitogo/ui/Alert";
+```
+
+## Components
+
+The Alert component consists of several sub-components:
+
+- `Alert` - The main container
+- `AlertTitle` - Title for the alert
+- `AlertDescription` - Description content for the alert
+
+## Default Alert
+
+<Alert className="not-prose">
+  <TerminalIcon className="h-4 w-4" />
+  <AlertTitle>Heads up!</AlertTitle>
+  <AlertDescription>
+    You can add components and dependencies to your app using the cli.
+  </AlertDescription>
+</Alert>
+
+```tsx title="Alert"
+<Alert>
+  <TerminalIcon className="h-4 w-4" />
+  <AlertTitle>Heads up!</AlertTitle>
+  <AlertDescription>
+    You can add components and dependencies to your app using the cli.
+  </AlertDescription>
+</Alert>
+```
+
+## Destructive Alert
+
+<Alert variant="destructive">
+  <AlertTitle>Error</AlertTitle>
+  <AlertDescription>Your session has expired. Please log in again.</AlertDescription>
+</Alert>
+
+```tsx
+<Alert variant="destructive">
+  <AlertTitle>Error</AlertTitle>
+  <AlertDescription>Your session has expired. Please log in again.</AlertDescription>
+</Alert>
+```
+
+## Without Title
+
+<Alert>
+  <TerminalIcon className="h-4 w-4" />
+  <AlertDescription>
+    You can add components and dependencies to your app using the cli.
+  </AlertDescription>
+</Alert>
+
+```tsx
+<Alert>
+  <TerminalIcon className="h-4 w-4" />
+  <AlertDescription>
+    You can add components and dependencies to your app using the cli.
+  </AlertDescription>
+</Alert>
+```
+
+## Without Icon
+
+<Alert>
+  <AlertTitle>Heads up!</AlertTitle>
+  <AlertDescription>
+    You can add components and dependencies to your app using the cli.
+  </AlertDescription>
+</Alert>
+
+```tsx
+<Alert>
+  <AlertTitle>Heads up!</AlertTitle>
+  <AlertDescription>
+    You can add components and dependencies to your app using the cli.
+  </AlertDescription>
+</Alert>
+```
+
+## Usage Examples
+
+### Success Alert
+
+<Alert className="border-green-200 bg-green-50 text-green-800 dark:border-green-800 dark:bg-green-950 dark:text-green-400">
+  <CheckCircle2Icon className="h-4 w-4" />
+  <AlertTitle>Success!</AlertTitle>
+  <AlertDescription>Your changes have been saved successfully.</AlertDescription>
+</Alert>
+
+```tsx
+<Alert className="border-green-200 bg-green-50 text-green-800 dark:border-green-800 dark:bg-green-950 dark:text-green-400">
+  <CheckCircle2Icon className="h-4 w-4" />
+  <AlertTitle>Success!</AlertTitle>
+  <AlertDescription>Your changes have been saved successfully.</AlertDescription>
+</Alert>
+```
+
+### Warning Alert
+
+<Alert className="border-yellow-200 bg-yellow-50 text-yellow-800 dark:border-yellow-800 dark:bg-yellow-950 dark:text-yellow-400">
+  <AlertTitle>Warning!</AlertTitle>
+  <AlertDescription>This action cannot be undone. Please proceed with caution.</AlertDescription>
+</Alert>
+
+```tsx
+<Alert className="border-yellow-200 bg-yellow-50 text-yellow-800 dark:border-yellow-800 dark:bg-yellow-950 dark:text-yellow-400">
+  <AlertTitle>Warning!</AlertTitle>
+  <AlertDescription>This action cannot be undone. Please proceed with caution.</AlertDescription>
+</Alert>
+```
+
+# Props
+
+<ReactComponentDoc component={Alert} />

package/docs/components/badge.mdx

@@ -0,0 +1,70 @@
+---
+title: Badge
+sidebar_icon: tag
+---
+
+A small badge component used to display status information or labels.
+
+## Import
+
+```tsx
+import { Badge } from "@lukoweb/apitogo/ui/Badge";
+```
+
+## Variants
+
+### Default
+
+<Badge variant="default">Default</Badge>
+
+```tsx
+<Badge variant="default">Default</Badge>
+```
+
+### Secondary
+
+<Badge variant="secondary">Secondary</Badge>
+
+```tsx
+<Badge variant="secondary">Secondary</Badge>
+```
+
+### Muted
+
+<Badge variant="muted">Muted</Badge>
+
+```tsx
+<Badge variant="muted">Muted</Badge>
+```
+
+### Destructive
+
+<Badge variant="destructive">Destructive</Badge>
+
+```tsx
+<Badge variant="destructive">Destructive</Badge>
+```
+
+### Outline
+
+<Badge variant="outline">Outline</Badge>
+
+```tsx
+<Badge variant="outline">Outline</Badge>
+```
+
+## Usage
+
+Badges are perfect for showing status, categories, or counts:
+
+<div className="flex gap-2">
+  <Badge variant="default">New</Badge>
+  <Badge variant="secondary">Main</Badge>
+  <Badge variant="muted">10</Badge>
+</div>
+
+```tsx
+<Badge variant="default">New</Badge>
+<Badge variant="secondary">Main</Badge>
+<Badge variant="muted">10</Badge>
+```

package/docs/components/button.mdx

@@ -0,0 +1,132 @@
+---
+title: Button
+sidebar_icon: mouse-pointer-click
+---
+
+import { Button } from "@lukoweb/apitogo/ui/Button";
+import { PopcornIcon } from "@lukoweb/apitogo/icons";
+
+A flexible button component with multiple variants and sizes for different use cases.
+
+## Import
+
+```tsx
+import { Button } from "@lukoweb/apitogo/ui/Button";
+```
+
+## Variants
+
+### Default
+
+<Button variant="default">Default Button</Button>
+
+```tsx
+<Button variant="default">Default Button</Button>
+```
+
+### Destructive
+
+<Button variant="destructive">Delete</Button>
+
+```tsx
+<Button variant="destructive">Delete</Button>
+```
+
+### Outline
+
+<Button variant="outline">Outline Button</Button>
+
+```tsx
+<Button variant="outline">Outline Button</Button>
+```
+
+### Secondary
+
+<Button variant="secondary">Secondary</Button>
+
+```tsx
+<Button variant="secondary">Secondary</Button>
+```
+
+### Ghost
+
+<Button variant="ghost">Ghost Button</Button>
+
+```tsx
+<Button variant="ghost">Ghost Button</Button>
+```
+
+### Link
+
+<Button variant="link">Link Button</Button>
+
+```tsx
+<Button variant="link">Link Button</Button>
+```
+
+## Sizes
+
+### Default Size
+
+<Button size="default">Default Size</Button>
+
+```tsx
+<Button size="default">Default Size</Button>
+```
+
+### Small
+
+<Button size="sm">Small Button</Button>
+
+```tsx
+<Button size="sm">Small Button</Button>
+```
+
+### Large
+
+<Button size="lg">Large Button</Button>
+
+```tsx
+<Button size="lg">Large Button</Button>
+```
+
+### Extra Large
+
+<Button size="xl">Extra Large</Button>
+
+```tsx
+<Button size="xl">Extra Large</Button>
+```
+
+### Icon
+
+<Button size="icon">
+  <PopcornIcon size={16} />
+</Button>
+
+```tsx
+<Button size="icon">
+  <PopcornIcon size={16} />
+</Button>
+```
+
+## As Child
+
+Use the `asChild` prop to render the button as a different element while maintaining button styling:
+
+```tsx
+<Button asChild>
+  <a href="/link">Link as Button</a>
+</Button>
+```
+
+## Custom Styling
+
+The Button component accepts all standard button HTML attributes and can be customized with
+additional className:
+
+```tsx
+<Button className="w-full" variant="outline">
+  Full Width Button
+</Button>
+```