bertui 1.1.0 → 1.1.2

package/types/index.d.ts

@@ -0,0 +1,116 @@
+// bertui/types/index.d.ts
+
+declare namespace React {
+  type ReactNode = any;
+}
+
+declare global {
+  namespace JSX {
+    type Element = any;
+    interface IntrinsicElements {
+      [elemName: string]: any;
+    }
+  }
+}
+declare module 'bertui' {
+  import { BertuiConfig } from 'bertui/config';
+  
+  /**
+   * Logger utility
+   */
+  export interface Logger {
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    bigLog(message: string, options?: { color?: string }): void;
+    table(data: any[]): void;
+  }
+
+  /**
+   * Build options
+   */
+  export interface BuildOptions {
+    /** Project root directory */
+    root?: string;
+  }
+
+  /**
+   * Dev server options
+   */
+  export interface DevOptions {
+    /** Server port */
+    port?: number;
+    /** Project root directory */
+    root?: string;
+  }
+
+  /**
+   * Compile options
+   */
+  export interface CompileOptions {
+    /** Project root directory */
+    root?: string;
+  }
+
+  /**
+   * Logger instance
+   */
+  export const logger: Logger;
+
+  /**
+   * Default configuration
+   */
+  export const defaultConfig: BertuiConfig;
+
+  /**
+   * Load configuration
+   */
+  export function loadConfig(root: string): Promise<BertuiConfig>;
+
+  /**
+   * Start development server
+   */
+  export function startDev(options?: DevOptions): Promise<void>;
+
+  /**
+   * Build for production
+   */
+  export function buildProduction(options?: BuildOptions): Promise<void>;
+
+  /**
+   * Compile project
+   */
+  export function compileProject(root: string): Promise<{
+    outDir: string;
+    stats: { files: number; skipped: number };
+    routes: any[];
+  }>;
+
+  /**
+   * CLI program
+   */
+  export function program(): void;
+
+  /**
+   * BertUI version
+   */
+  export const version: string;
+}
+
+// Global declarations for Server Islands
+declare global {
+  /**
+   * Mark a page component as a Server Island (SSG)
+   * Add this export to any page to enable static generation:
+   * 
+   * @example
+   * ```tsx
+   * export const render = "server";
+   * ```
+   */
+  export const render: "server" | "client";
+}
+
+export {};

package/types/react.d.ts

@@ -0,0 +1,13 @@
+// bertui/types/react.d.ts
+import React from 'react';
+
+declare global {
+  namespace JSX {
+    interface IntrinsicElements {
+      [elemName: string]: React.DetailedHTMLProps<
+        React.HTMLAttributes<HTMLElement>, 
+        HTMLElement
+      >;
+    }
+  }
+}

package/types/router.d.ts

@@ -0,0 +1,79 @@
+// bertui/types/router.d.ts
+declare module 'bertui/router' {
+  import { ReactNode, ComponentType } from 'react';
+
+  /**
+   * Route parameter object
+   */
+  export interface RouteParams {
+    [key: string]: string;
+  }
+
+  /**
+   * Router context value
+   */
+  export interface RouterContext {
+    /** Current active route */
+    currentRoute: Route | null;
+    /** Dynamic route parameters */
+    params: RouteParams;
+    /** Navigate to a new path */
+    navigate: (path: string) => void;
+    /** Current pathname */
+    pathname: string;
+    /** Whether running in SSR mode */
+    isSSR?: boolean;
+  }
+
+  /**
+   * Route configuration object
+   */
+  export interface Route {
+    /** Route path (e.g., "/", "/blog", "/user/:id") */
+    path: string;
+    /** React component to render */
+    component: ComponentType<{ params?: RouteParams }>;
+    /** Route type: "static" or "dynamic" */
+    type: 'static' | 'dynamic';
+  }
+
+  /**
+   * Router component props
+   */
+  export interface RouterProps {
+    /** Array of route configurations */
+    routes: Route[];
+    /** Initial path for SSR */
+    initialPath?: string;
+  }
+
+  /**
+   * Link component props
+   */
+  export interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    /** Destination path */
+    to: string;
+    /** Link content */
+    children: ReactNode;
+  }
+
+  /**
+   * Router component for client-side routing
+   */
+  export const Router: ComponentType<RouterProps>;
+
+  /**
+   * Link component for navigation
+   */
+  export const Link: ComponentType<LinkProps>;
+
+  /**
+   * Hook to access router context
+   */
+  export function useRouter(): RouterContext;
+
+  /**
+   * Exported routes configuration
+   */
+  export const routes: Route[];
+}