@lukoweb/apitogo 0.1.54 → 0.1.56

package/dist/declarations/lib/components/HeaderAuthActions.d.ts

@@ -0,0 +1,3 @@
+export declare const HeaderAuthActions: ({ className }: {
+    className?: string;
+}) => import("react/jsx-runtime").JSX.Element | null;

package/dist/declarations/lib/components/SiteTitle.d.ts

@@ -0,0 +1,6 @@
+type SiteTitleProps = {
+    title: string;
+    className?: string;
+};
+export declare const SiteTitle: ({ title, className }: SiteTitleProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/declarations/lib/components/ThemeSwitch.d.ts

@@ -1 +1,3 @@
-export declare const ThemeSwitch: () => import("react/jsx-runtime").JSX.Element;
+export declare const ThemeSwitch: ({ variant, }: {
+    variant?: "default" | "compact";
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/declarations/lib/components/TopNavigation.d.ts

@@ -1,6 +1,6 @@
 import { type NavLinkProps } from "react-router";
 import type { NavigationItem } from "../../config/validators/NavigationSchema.js";
-export declare const TopNavigation: () => import("react/jsx-runtime").JSX.Element;
+export declare const TopNavigation: () => import("react/jsx-runtime").JSX.Element | null;
 export declare const TopNavLink: ({ isActive, children, ...props }: {
     isActive?: boolean;
     children: React.ReactNode;

package/dist/declarations/lib/core/ZudokuContext.d.ts

@@ -50,6 +50,7 @@ type Site = Partial<{
     dir?: "ltr" | "rtl";
     showPoweredBy?: boolean;
     title?: string;
+    showTitleInHeader?: boolean;
     logo?: {
         src: {
             light: string;

package/dist/flat-config.d.ts

@@ -64,7 +64,7 @@ export type _Schema15 = boolean
 /**
  * Gateway plan catalog for /pricing preview and publish (canonical storage).
  */
-export type _Schema35 = {
+export type _Schema37 = {
   sku: string
   displayName: string
   priceAmount?: number
@@ -73,31 +73,31 @@ export type _Schema35 = {
   limitsJson?: string
   includedActionKeys?: string[]
 }[]
-export type _Schema36 = ({
+export type _Schema38 = ({
   type: "url"
-  input: (string | _Schema37[])
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  input: (string | _Schema39[])
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 } | {
   type: "file"
-  input: (string | (string | _Schema37)[])
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  input: (string | (string | _Schema39)[])
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 } | {
   type: "raw"
   input: string
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 })
-export type _Schema38 = string
-export type _Schema39 = string
-export type _Schema40 = {
+export type _Schema40 = string
+export type _Schema41 = string
+export type _Schema42 = {
   label: string
   tags: string[]
 }[]
@@ -137,6 +137,7 @@ export interface FlatZudokuConfig {
   }
   site?: {
     title?: string
+    showTitleInHeader?: boolean
     logoUrl?: string
     dir?: ("ltr" | "rtl")
     logo?: _Schema0
@@ -395,10 +396,10 @@ export interface FlatZudokuConfig {
   modules?: {
     docs?: _Schema14
     landing?: _Schema16
-    userPanel?: _Schema23
+    userPanel?: _Schema25
   }
-  apis?: (_Schema36 | _Schema36[])
-  catalogs?: (_Schema43 | _Schema43[])
+  apis?: (_Schema38 | _Schema38[])
+  catalogs?: (_Schema45 | _Schema45[])
   apiKeys?: {
     enabled: boolean
     getConsumers?: unknown
@@ -426,7 +427,7 @@ export interface FlatZudokuConfig {
   }
   enableStatusPages?: boolean
   defaults?: {
-    apis: _Schema42
+    apis: _Schema44
     examplesLanguage?: string
   }
   __pluginDirs?: string[]
@@ -524,6 +525,10 @@ export interface _Schema16 {
    */
   layout?: ("default" | "landing" | "none")
   content?: _Schema21
+  /**
+   * When true, merge DEFAULT_LANDING_CONTENT for unset sections. When false or omitted, only configured sections are shown.
+   */
+  useDefaults?: boolean
 }
 /**
  * Default landing page content when no custom component is provided.
@@ -531,25 +536,77 @@ export interface _Schema16 {
 export interface _Schema21 {
   hero?: {
     title?: string
+    /**
+     * Accent-colored word or phrase shown on a new line after the title.
+     */
+    titleAccent?: string
     subtitle?: string
     description?: string
+    badge?: string
+    highlights?: string[]
+    codeExample?: {
+      filename?: string
+      language?: string
+      code: string
+    }
+  }
+  featuresSection?: {
+    label?: string
+    title?: string
+    description?: string
   }
   features?: {
     title: string
     description: string
+    icon?: string
   }[]
-  primaryAction?: _Schema22
-  secondaryAction?: _Schema22
+  primaryAction?: _Schema23
+  secondaryAction?: _Schema23
+  ticker?: {
+    enabled?: boolean
+    items?: {
+      label: string
+      value: string
+      change?: string
+    }[]
+  }
+  trust?: {
+    enabled?: boolean
+    title?: string
+    logos?: string[]
+  }
+  apiShowcase?: {
+    enabled?: boolean
+    title?: string
+    subtitle?: string
+    browseAllHref?: string
+    browseAllLabel?: string
+    autoFromOpenApi?: boolean
+    items?: {
+      name: string
+      path: string
+      icon?: string
+      latency?: string
+      summary?: string
+    }[]
+  }
+  pricingCta?: {
+    enabled?: boolean
+    title?: string
+    description?: string
+    primaryAction?: _Schema23
+    secondaryAction?: _Schema23
+  }
   showPoweredBy?: boolean
 }
-export interface _Schema22 {
+export interface _Schema23 {
   label: string
   href: string
 }
 /**
  * User panel module — authenticated user area with sub-modules.
  */
-export interface _Schema23 {
+export interface _Schema25 {
   enabled?: _Schema15
   /**
    * Base path prefix for user panel routes.
@@ -571,7 +628,7 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema30
+    content?: _Schema32
   }
   userManagement?: {
     enabled?: _Schema15
@@ -591,7 +648,7 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema31
+    content?: _Schema33
   }
   apiKeys?: {
     enabled?: _Schema15
@@ -616,30 +673,30 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema34
-    items?: _Schema35
+    content?: _Schema36
+    items?: _Schema37
   }
 }
 /**
  * Default dashboard page content when no custom component is provided.
  */
-export interface _Schema30 {
+export interface _Schema32 {
   title?: string
   subtitle?: string
   description?: string
-  quickLinks?: _Schema22[]
+  quickLinks?: _Schema23[]
 }
 /**
  * Default profile page content when no custom component is provided.
  */
-export interface _Schema31 {
+export interface _Schema33 {
   title?: string
   description?: string
 }
 /**
  * Default plans page content when no custom component is provided.
  */
-export interface _Schema34 {
+export interface _Schema36 {
   title?: string
   description?: string
   tiers?: {
@@ -648,12 +705,12 @@ export interface _Schema34 {
     description?: string
   }[]
 }
-export interface _Schema37 {
+export interface _Schema39 {
   path: string
   input: string
   label?: string
 }
-export interface _Schema42 {
+export interface _Schema44 {
   examplesLanguage?: string
   supportedLanguages?: {
     value: string
@@ -670,7 +727,7 @@ export interface _Schema42 {
   transformExamples?: unknown
   generateCodeSnippet?: unknown
 }
-export interface _Schema43 {
+export interface _Schema45 {
   path: string
   label: string
   items?: string[]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "type": "module",
   "sideEffects": [
     "**/*.css",

package/src/app/main.css

@@ -102,8 +102,8 @@
 
 @layer base {
   :root {
-    --top-header-height: 65px;
-    --top-nav-height: 50px;
+    --top-header-height: 64px;
+    --top-nav-height: 0px;
     --banner-height: 35px;
     --header-height: calc(
       var(--top-header-height) + var(--top-nav-height) + var(--banner-height)

package/src/config/apitogo-config-core.ts

@@ -12,6 +12,7 @@ const DERIVED_MANIFEST_KEYS = [
   "backend",
   "gateway",
   "projectId",
+  "landing",
 ] as const;
 
 const SITE_CONFIG_KEYS = [
@@ -542,6 +543,18 @@ export function deriveManifestFields(
       }
       continue;
     }
+    if (key === "landing") {
+      const modules = asRecord(normalized.modules);
+      const landing = asRecord(modules?.landing);
+      if (landing?.content || landing?.enabled !== undefined) {
+        manifest.landing = {
+          enabled:
+            typeof landing.enabled === "boolean" ? landing.enabled : undefined,
+          content: landing.content,
+        };
+      }
+      continue;
+    }
     if (normalized[key] !== undefined) {
       manifest[key] = normalized[key];
     }

package/src/config/apitogo-config-loader.browser.ts

@@ -0,0 +1,17 @@
+import type {
+  ApitogoJsonConfig,
+  AuthenticationSecrets,
+} from "./apitogo-config-core.js";
+
+/** Browser stub — JSON config is embedded by the Vite config plugin on the client. */
+export function loadApitogoConfig(_rootDir?: string): ApitogoJsonConfig {
+  return {};
+}
+
+export function readAuthenticationSecrets(): AuthenticationSecrets {
+  return {};
+}
+
+export function apitogoConfigPath(rootDir: string): string {
+  return rootDir;
+}

package/src/config/build-apitogo-config.ts

@@ -11,6 +11,13 @@ type BuildApitogoConfigOptions = Partial<ApitogoConfig> &
     plugins?: ApitogoPlugin[];
   };
 
+function mergeOptionalRecord<T extends Record<string, unknown>>(
+  ...records: Array<T | undefined>
+): T | undefined {
+  const merged = Object.assign({}, ...records.filter(Boolean)) as T;
+  return Object.keys(merged).length > 0 ? merged : undefined;
+}
+
 export function buildApitogoConfig({
   plugins,
   plans: _legacyPlans,
@@ -24,14 +31,16 @@ export function buildApitogoConfig({
   const { plans: _rootPlans, ...restOverrides } =
     jsonOverrides as ApitogoJsonConfig;
 
+  const authentication = mergeOptionalRecord(
+    siteConfig.authentication as ApitogoConfig["authentication"],
+    jsonOverrides.authentication as ApitogoConfig["authentication"],
+  );
+
   return {
     ...siteConfig,
     ...restOverrides,
     plugins,
-    authentication: {
-      ...(siteConfig.authentication as ApitogoConfig["authentication"]),
-      ...jsonOverrides.authentication,
-    },
+    ...(authentication ? { authentication } : {}),
     site: {
       ...(siteConfig.site as ApitogoConfig["site"]),
       ...jsonOverrides.site,

package/src/config/default-landing-content.ts

@@ -0,0 +1,154 @@
+import type { ResolvedLandingContent } from "./validators/ModulesSchema.js";
+
+/** Default landing sections aligned with webapp-template/APIToGo.dc.html */
+export const DEFAULT_LANDING_CONTENT: ResolvedLandingContent = {
+  hero: {
+    badge: "99.98% uptime",
+    subtitle: "Production-ready APIs, one endpoint away",
+    title: "Developer APIs that ship",
+    titleAccent: "today.",
+    description:
+      "Documentation, interactive API reference, auth, and billing — sub-40ms responses, one API key, generous free tier.",
+    highlights: ["No credit card", "10k requests free", "SDKs for 6 languages"],
+    codeExample: {
+      filename: "example.sh",
+      language: "bash",
+      code: `$ curl https://api.example.com/v1/items \\
+  -H "Authorization: Bearer YOUR_API_KEY" \\
+  -d "limit=10"
+
+{
+  "items": [
+    { "id": "item_1", "name": "Widget", "status": "active" },
+    { "id": "item_2", "name": "Gadget", "status": "active" }
+  ]
+} // 28ms`,
+    },
+  },
+  primaryAction: { label: "Get your API key", href: "/register" },
+  secondaryAction: { label: "Read the docs", href: "/introduction" },
+  ticker: {
+    items: [
+      { label: "GET", value: "/v1/items", change: "28ms" },
+      { label: "POST", value: "/v1/items", change: "34ms" },
+      { label: "GET", value: "/v1/users", change: "19ms" },
+      { label: "PATCH", value: "/v1/users/{id}", change: "41ms" },
+      { label: "GET", value: "/v1/health", change: "16ms" },
+      { label: "DELETE", value: "/v1/items/{id}", change: "22ms" },
+      { label: "GET", value: "/v1/search", change: "47ms" },
+      { label: "POST", value: "/v1/auth/token", change: "52ms" },
+    ],
+  },
+  trust: {
+    title: "Trusted by teams shipping production APIs",
+    logos: ["Acme Corp", "BuildFast", "DataFlow", "ShipKit", "DevStack", "LaunchPad"],
+  },
+  featuresSection: {
+    label: "// why us",
+    title: "Everything you need to build on your API",
+    description:
+      "Skip the infra. We handle docs, auth, keys, and billing so you can focus on your product.",
+  },
+  features: [
+    {
+      icon: "gauge",
+      title: "Sub-40ms responses",
+      description:
+        "Edge-cached and globally distributed, so your app feels instant anywhere.",
+    },
+    {
+      icon: "radio",
+      title: "Real-time streams",
+      description:
+        "WebSocket feeds with automatic reconnection for live data and events.",
+    },
+    {
+      icon: "blocks",
+      title: "Unified schema",
+      description:
+        "One consistent API design — no per-endpoint glue code or custom adapters.",
+    },
+    {
+      icon: "shield-check",
+      title: "99.98% uptime",
+      description:
+        "Redundant infra with a public status page and an SLA on paid plans.",
+    },
+    {
+      icon: "code",
+      title: "SDKs for 6 languages",
+      description:
+        "Typed clients for JS, Python, Go, Rust, Ruby and PHP. Copy, paste, ship.",
+    },
+    {
+      icon: "webhook",
+      title: "Webhooks & alerts",
+      description:
+        "Push events and threshold alerts straight to your endpoints.",
+    },
+  ],
+  apiShowcase: {
+    title: "Production APIs. One key.",
+    browseAllLabel: "Browse all APIs",
+    browseAllHref: "/api",
+    autoFromOpenApi: true,
+    items: [
+      {
+        name: "List resources",
+        path: "/v1/items",
+        icon: "boxes",
+        latency: "28ms",
+      },
+      {
+        name: "Create resource",
+        path: "/v1/items",
+        icon: "badge-dollar-sign",
+        latency: "34ms",
+      },
+      {
+        name: "Get resource",
+        path: "/v1/items/{id}",
+        icon: "layers",
+        latency: "19ms",
+      },
+      {
+        name: "Search",
+        path: "/v1/search",
+        icon: "arrow-left-right",
+        latency: "41ms",
+      },
+      {
+        name: "User profile",
+        path: "/v1/users/me",
+        icon: "wallet",
+        latency: "52ms",
+      },
+      {
+        name: "Health check",
+        path: "/v1/health",
+        icon: "activity",
+        latency: "16ms",
+      },
+      {
+        name: "Metadata",
+        path: "/v1/meta",
+        icon: "coins",
+        latency: "22ms",
+      },
+      {
+        name: "Rate limits",
+        path: "/v1/limits",
+        icon: "gauge",
+        latency: "16ms",
+      },
+    ],
+  },
+  pricingCta: {
+    title: "Start free. Scale when you do.",
+    description:
+      "10,000 requests a month, free forever. Upgrade only when your app takes off.",
+    primaryAction: { label: "Create free account", href: "/register" },
+    secondaryAction: { label: "See pricing", href: "/pricing" },
+  },
+  showPoweredBy: true,
+};

package/src/config/landing-manifest.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import { LandingContentSchema } from "./validators/ModulesSchema.js";
+
+export const LandingManifestContentSchema = LandingContentSchema;
+
+export type LandingManifestContent = z.infer<typeof LandingContentSchema>;
+
+export type LandingManifestInput = {
+  enabled?: boolean;
+  content?: LandingManifestContent;
+};

package/src/config/landing-openapi-showcase.ts

@@ -0,0 +1,115 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import type { LandingApiShowcaseItemConfig } from "./validators/ModulesSchema.js";
+import type { ZudokuConfig } from "./validators/ZudokuConfig.js";
+
+const HTTP_METHODS = [
+  "get",
+  "post",
+  "put",
+  "patch",
+  "delete",
+  "head",
+  "options",
+] as const;
+
+type OpenApiDocument = {
+  paths?: Record<
+    string,
+    Partial<Record<(typeof HTTP_METHODS)[number], { summary?: string }>>
+  >;
+};
+
+function readOpenApiDocument(
+  rootDir: string,
+  openApiPath: string,
+): OpenApiDocument | null {
+  try {
+    const absolutePath = path.isAbsolute(openApiPath)
+      ? openApiPath
+      : path.resolve(rootDir, openApiPath);
+    const raw = readFileSync(absolutePath, "utf8");
+    return JSON.parse(raw) as OpenApiDocument;
+  } catch {
+    return null;
+  }
+}
+
+function resolveOpenApiPath(config: ZudokuConfig): string | undefined {
+  const backend = (config as { backend?: { openApiPath?: string } }).backend;
+  if (backend?.openApiPath) {
+    return backend.openApiPath;
+  }
+
+  const apis = config.apis;
+  if (!apis) {
+    return undefined;
+  }
+
+  const entries = Array.isArray(apis) ? apis : [apis];
+  for (const entry of entries) {
+    if (typeof entry === "object" && entry !== null && "type" in entry) {
+      const api = entry as { type?: string; input?: string };
+      if (api.type === "file" && typeof api.input === "string") {
+        return api.input;
+      }
+    }
+  }
+
+  return undefined;
+}
+
+export function extractApiShowcaseItemsFromOpenApi(
+  config: ZudokuConfig,
+  rootDir: string,
+  limit = 8,
+): LandingApiShowcaseItemConfig[] {
+  const openApiPath = resolveOpenApiPath(config);
+  if (!openApiPath) {
+    return [];
+  }
+
+  const document = readOpenApiDocument(rootDir, openApiPath);
+  if (!document?.paths) {
+    return [];
+  }
+
+  const items: LandingApiShowcaseItemConfig[] = [];
+
+  for (const [routePath, methods] of Object.entries(document.paths)) {
+    for (const method of HTTP_METHODS) {
+      const operation = methods?.[method];
+      if (!operation) {
+        continue;
+      }
+
+      items.push({
+        name: operation.summary ?? `${method.toUpperCase()} ${routePath}`,
+        path: routePath,
+        summary: operation.summary,
+      });
+
+      if (items.length >= limit) {
+        return items;
+      }
+    }
+  }
+
+  return items;
+}
+
+export function enrichResolvedLandingApiShowcase(
+  config: ZudokuConfig,
+  resolved: { landing: { content: { apiShowcase?: { autoFromOpenApi?: boolean; items?: LandingApiShowcaseItemConfig[] } } } },
+  rootDir: string,
+): void {
+  const showcase = resolved.landing.content.apiShowcase;
+  if (
+    !showcase?.autoFromOpenApi ||
+    (showcase.items && showcase.items.length > 0)
+  ) {
+    return;
+  }
+
+  showcase.items = extractApiShowcaseItemsFromOpenApi(config, rootDir);
+}