@mdxui/do 3.0.0 → 4.0.0

package/dist/app/index.d.ts

@@ -1,14 +1,51 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { d as DOShellConfig, e as DOShellContextValue } from '../config-CmZBQQaT.js';
+import { d as DOShellConfig, c as DOCustomRoute } from '../config-CxvpD8Y6.js';
+import { a as BreadcrumbItemConfig } from '../breadcrumbs-C9Qn3S7d.js';
 import { Sidebar } from '@mdxui/primitives';
 import { useAuth } from '@workos-inc/authkit-react';
 export { DOClient, DOContextValue, DOProvider, DOProviderProps, useDO, useDOClient, useDOUrls, useDataProviderSafe, useSyncStatus } from '../providers/index.js';
 export { useQueryClient } from '@tanstack/react-query';
 import { z } from 'zod';
-import '../do-C-t9UgjT.js';
+import '../do-D27i5bU0.js';
 import '@mdxui/app';
+import '../capnweb-client-Bq78FtEA.js';
+
+/**
+ * DatabasesPage - Renders DataGridView with route params
+ *
+ * Route: /databases/:ns?/:type?
+ */
+declare function DatabasesPage(): react_jsx_runtime.JSX.Element;
+
+/**
+ * DocumentPage - Renders DocumentEditorView with route params
+ *
+ * Route: /things/$ns/$type/$id
+ */
+declare function DocumentPage(): react_jsx_runtime.JSX.Element;
+
+/**
+ * FunctionsPage - Renders FunctionEditorView
+ *
+ * Route: /functions
+ */
+declare function FunctionsPage(): react_jsx_runtime.JSX.Element;
+
+/**
+ * OverviewPage - Main dashboard landing page
+ *
+ * Shows stats, quick actions, and recent activity.
+ */
+declare function OverviewPage(): react_jsx_runtime.JSX.Element;
+
+/**
+ * ThingsPage - Renders DataBrowserView with route params
+ *
+ * Route: /things/$ns?/$type?
+ */
+declare function ThingsPage(): react_jsx_runtime.JSX.Element;
 
 interface DOAppProps {
     /** Shell configuration */
@@ -52,76 +89,28 @@ interface DOAppProps {
  * }
  * ```
  */
-declare function DOApp({ config, headerContent, sidebarHeaderContent }: DOAppProps): react_jsx_runtime.JSX.Element;
+declare function DOApp({ config, headerContent, sidebarHeaderContent, }: DOAppProps): react_jsx_runtime.JSX.Element;
 
-interface DOShellProps {
-    /** Optional children to render instead of using Outlet */
-    children?: React.ReactNode;
-    /** Optional header content for the sidebar */
-    sidebarHeaderContent?: React.ReactNode;
-    /** Optional content to render in the header after breadcrumbs */
-    headerContent?: React.ReactNode;
-    /** Breadcrumb items to display (future enhancement) */
-    breadcrumbs?: Array<{
-        label: string;
-        href?: string;
-    }>;
+interface AppProvidersProps {
+    config: DOShellConfig;
+    children: ReactNode;
 }
 /**
- * DOShell - Main layout wrapper for the DO Admin Dashboard.
- *
- * This layout provides:
- * - Authentication gate (shows landing page if not authenticated)
- * - A collapsible sidebar with navigation on the left
- * - A main content area with a header containing breadcrumbs
- * - Toast notifications via Sonner
- * - Responsive design that works on mobile and desktop
- *
- * The layout uses react-router-dom's Outlet for nested routes.
+ * AppProviders - Composed provider hierarchy for DOShell
  *
  * @example
  * ```tsx
- * // As a route layout using Outlet
- * <DOShell />
- *
- * // With custom children
- * <DOShell>
- *   <CustomContent />
- * </DOShell>
- *
- * // With header content
- * <DOShell headerContent={<SearchBar />} />
+ * <AppProviders
+ *   config={{
+ *     do: { apiEndpoint: '...', authMethod: 'jwt', bindings: [], realTimeUpdates: true },
+ *     identity: { clientId: 'client_xxx', devMode: true },
+ *   }}
+ * >
+ *   <DOShell />
+ * </AppProviders>
  * ```
  */
-declare function DOShell({ children, sidebarHeaderContent, headerContent, breadcrumbs, }: DOShellProps): react_jsx_runtime.JSX.Element;
-
-interface DOShellNavProps extends React.ComponentProps<typeof Sidebar> {
-    /** Optional header content to display at the top of the sidebar */
-    headerContent?: React.ReactNode;
-}
-/**
- * DOShellNav - Sidebar navigation component for the DO Shell.
- *
- * Features:
- * - Highlights active route based on current location
- * - Uses lucide-react icons for each navigation item
- * - Collapsible on mobile via the Sidebar component
- * - Supports custom header content
- * - Routes can be enabled/disabled via config
- */
-declare function DOShellNav({ headerContent, ...props }: DOShellNavProps): react_jsx_runtime.JSX.Element;
-
-interface UserMenuProps {
-    /** Whether to show in compact mode (icon only) */
-    compact?: boolean;
-}
-/**
- * UserMenu - User dropdown with profile info and sign out
- *
- * Displays the current user's avatar and name, with options for
- * settings and signing out.
- */
-declare function UserMenu({ compact }: UserMenuProps): react_jsx_runtime.JSX.Element | null;
+declare function AppProviders({ config, children }: AppProvidersProps): react_jsx_runtime.JSX.Element;
 
 interface AuthGateProps {
     children: ReactNode;
@@ -134,53 +123,87 @@ interface AuthGateProps {
  */
 declare function AuthGate({ children }: AuthGateProps): react_jsx_runtime.JSX.Element;
 
-interface DOShellProviderProps {
+/**
+ * Static config context value (no state, just config)
+ */
+interface DOConfigContextValue {
+    /** Merged shell configuration */
+    config: DOShellConfig;
+}
+interface DOConfigProviderProps {
     config: DOShellConfig;
     children: ReactNode;
 }
 /**
- * DOShellProvider - Context provider for DOShell configuration
+ * DOConfigProvider - Provides static shell configuration
  *
- * Provides shell configuration to all child components.
- * Should be used inside the DOAppProviders composition.
+ * This is a minimal context for static config only.
+ * Dynamic state (endpoint, namespace) is managed via TanStack Query.
  */
-declare function DOShellProvider({ config, children }: DOShellProviderProps): react_jsx_runtime.JSX.Element;
+declare function DOConfigProvider({ config, children }: DOConfigProviderProps): react_jsx_runtime.JSX.Element;
 /**
- * Hook to access DOShell configuration
+ * Hook to access static shell configuration
  */
-declare function useDOShell(): DOShellContextValue;
+declare function useDOConfig(): DOConfigContextValue;
 /**
  * Hook to access enabled routes configuration
  */
-declare function useDOShellRoutes(): Partial<Record<string, boolean>>;
+declare function useDORoutes(): Partial<Record<string, boolean>>;
+/**
+ * Hook to access custom routes
+ */
+declare function useDOCustomRoutes(): DOCustomRoute[];
 
-interface AppProvidersProps {
-    config: DOShellConfig;
-    children: ReactNode;
+interface DOShellProps {
+    /** Children to render in the main content area (typically TanStack Router Outlet) */
+    children: React.ReactNode;
+    /** Optional header content for the sidebar */
+    sidebarHeaderContent?: React.ReactNode;
+    /** Optional content to render in the header after breadcrumbs */
+    headerContent?: React.ReactNode;
+    /**
+     * Breadcrumb items to display.
+     * If not provided, auto-generates from current route.
+     * Pass empty array to disable breadcrumbs.
+     */
+    breadcrumbs?: BreadcrumbItemConfig[];
 }
 /**
- * AppProviders - Composed provider hierarchy for DOShell
+ * DOShell - Main layout wrapper for the DO Admin Dashboard.
+ *
+ * This layout provides:
+ * - Authentication gate (shows landing page if not authenticated)
+ * - A collapsible sidebar with navigation on the left
+ * - A main content area with a header containing breadcrumbs
+ * - Toast notifications via Sonner
+ * - Responsive design that works on mobile and desktop
  *
- * Provider hierarchy:
- * - ThemeProvider (next-themes) - Theme mode (light/dark/system)
- * - DOShellProvider - Shell config context
- * - DOIdentityProvider - WorkOS AuthKit authentication
- * - DOProvider - RPC client, namespace, TanStack Query
+ * Uses TanStack Router for navigation.
  *
  * @example
  * ```tsx
- * <AppProviders
- *   config={{
- *     do: { apiEndpoint: '...', authMethod: 'jwt', bindings: [], realTimeUpdates: true },
- *     identity: { clientId: 'client_xxx', devMode: true },
- *   }}
- * >
- *   <DOShell />
- * </AppProviders>
+ * <DOShell headerContent={<SearchBar />}>
+ *   <Outlet />
+ * </DOShell>
  * ```
  */
-declare function AppProviders({ config, children }: AppProvidersProps): react_jsx_runtime.JSX.Element;
-declare const DOAppProviders: typeof AppProviders;
+declare function DOShell({ children, sidebarHeaderContent, headerContent, breadcrumbs: breadcrumbsProp, }: DOShellProps): react_jsx_runtime.JSX.Element;
+
+interface DOShellNavProps extends React.ComponentProps<typeof Sidebar> {
+    /** Optional header content to display at the top of the sidebar */
+    headerContent?: React.ReactNode;
+}
+/**
+ * DOShellNav - Sidebar navigation component for the DO Shell.
+ *
+ * Features:
+ * - Highlights active route based on current location
+ * - Uses lucide-react icons for each navigation item
+ * - Collapsible on mobile via the Sidebar component
+ * - Supports custom header content
+ * - Routes can be enabled/disabled via config
+ */
+declare function DOShellNav({ headerContent, ...props }: DOShellNavProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Hook to access identity/auth state.
@@ -197,40 +220,17 @@ interface DOIdentityProviderProps {
  */
 declare function DOIdentityProvider({ children }: DOIdentityProviderProps): react_jsx_runtime.JSX.Element;
 
+interface UserMenuProps {
+    /** Whether to show in compact mode (icon only) */
+    compact?: boolean;
+}
 /**
- * OverviewPage - Main dashboard landing page
- *
- * Shows stats, quick actions, and recent activity.
- */
-declare function OverviewPage(): react_jsx_runtime.JSX.Element;
-
-/**
- * ThingsPage - Renders DataBrowserView with route params
- *
- * Route: /things/:ns?/:type?
- */
-declare function ThingsPage(): react_jsx_runtime.JSX.Element;
-
-/**
- * DatabasesPage - Renders DataGridView with route params
- *
- * Route: /databases/:ns?/:type?
- */
-declare function DatabasesPage(): react_jsx_runtime.JSX.Element;
-
-/**
- * DocumentPage - Renders DocumentEditorView with route params
- *
- * Route: /things/:ns/:type/:id
- */
-declare function DocumentPage(): react_jsx_runtime.JSX.Element;
-
-/**
- * FunctionsPage - Renders FunctionEditorView
+ * UserMenu - User dropdown with profile info and sign out
  *
- * Route: /functions
+ * Displays the current user's avatar and name, with options for
+ * settings and signing out.
  */
-declare function FunctionsPage(): react_jsx_runtime.JSX.Element;
+declare function UserMenu({ compact }: UserMenuProps): react_jsx_runtime.JSX.Element | null;
 
 interface PlaceholderPageProps {
     /** Title for the page */
@@ -285,13 +285,13 @@ declare const DocumentRouteParams: z.ZodObject<{
     type: z.ZodString;
     id: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    id: string;
     type: string;
     ns: string;
-    id: string;
 }, {
+    id: string;
     type: string;
     ns: string;
-    id: string;
 }>;
 type DocumentRouteParamsType = z.infer<typeof DocumentRouteParams>;
 /**
@@ -344,4 +344,4 @@ declare const doRoutePaths: {
 };
 type DORoutePath = typeof doRoutePaths[keyof typeof doRoutePaths];
 
-export { AppProviders, type AppProvidersProps, AuthGate, type AuthGateProps, DOApp, type DOAppProps, DOAppProviders, DOIdentityProvider, type DOIdentityProviderProps, type DORoutePath, DOShell, DOShellNav, type DOShellNavProps, type DOShellProps, DOShellProvider, DatabaseRouteParams, type DatabaseRouteParamsType, DatabasesPage, DocumentPage, DocumentRouteParams, type DocumentRouteParamsType, FunctionsPage, OverviewPage, PlaceholderPage, ThingsPage, ThingsRouteParams, type ThingsRouteParamsType, TypeFilteredRouteParams, type TypeFilteredRouteParamsType, UserMenu, doRoutePaths, useDOShell, useDOShellRoutes, useIdentity };
+export { AppProviders, type AppProvidersProps, AuthGate, type AuthGateProps, DOApp, type DOAppProps, type DOConfigContextValue, DOConfigProvider, DOIdentityProvider, type DOIdentityProviderProps, type DORoutePath, DOShell, DOShellNav, type DOShellNavProps, type DOShellProps, DatabaseRouteParams, type DatabaseRouteParamsType, DatabasesPage, DocumentPage, DocumentRouteParams, type DocumentRouteParamsType, FunctionsPage, OverviewPage, PlaceholderPage, ThingsPage, ThingsRouteParams, type ThingsRouteParamsType, TypeFilteredRouteParams, type TypeFilteredRouteParamsType, UserMenu, doRoutePaths, useDOConfig, useDOCustomRoutes, useDORoutes, useIdentity };

package/dist/app/index.js

@@ -1,12 +1,13 @@
-export { AppProviders, AuthGate, DOApp, DOAppProviders, DOIdentityProvider, DOShell, DOShellNav, DOShellProvider, DatabaseRouteParams, DatabasesPage, DocumentPage, DocumentRouteParams, FunctionsPage, OverviewPage, PlaceholderPage, ThingsPage, ThingsRouteParams, TypeFilteredRouteParams, UserMenu, doRoutePaths, useDOShell, useDOShellRoutes, useIdentity } from '../chunk-NTSEARBC.js';
-import '../chunk-YGIBMNRH.js';
-import '../chunk-5AWTQDRF.js';
+export { AppProviders, AuthGate, DOApp, DOConfigProvider, DOIdentityProvider, DOShell, DOShellNav, DatabaseRouteParams, DatabasesPage, DocumentPage, DocumentRouteParams, FunctionsPage, OverviewPage, PlaceholderPage, ThingsPage, ThingsRouteParams, TypeFilteredRouteParams, UserMenu, doRoutePaths, useDOConfig, useDOCustomRoutes, useDORoutes, useIdentity } from '../chunk-KT52UU3U.js';
+import '../chunk-7UFINK3Q.js';
+import '../chunk-JJLAES6W.js';
 import '../chunk-GKSP5RIA.js';
-import '../chunk-IESVTECE.js';
-import '../chunk-JWKIONEO.js';
+import '../chunk-NA652ART.js';
+import '../chunk-5SHZZC7L.js';
 import '../chunk-4KXVN3EQ.js';
-export { DOProvider, useDO, useDOClient, useDOUrls, useDataProviderSafe, useQueryClient, useSyncStatus } from '../chunk-FO3N7SXV.js';
-import '../chunk-OWEAW4U6.js';
+export { DOProvider, useDO, useDOClient, useDOUrls, useDataProviderSafe, useQueryClient, useSyncStatus } from '../chunk-WMNT4OIE.js';
+import '../chunk-OVLO7UOH.js';
+import '../chunk-3XKYQRXY.js';
 import '../chunk-Y52IEYVM.js';
 import '../chunk-GGO5GW72.js';
 //# sourceMappingURL=index.js.map

package/dist/breadcrumbs-C9Qn3S7d.d.ts

@@ -0,0 +1,81 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+/**
+ * Props for the Link component
+ */
+interface BreadcrumbLinkProps {
+    href: string;
+    children: React.ReactNode;
+    className?: string;
+    onClick?: () => void;
+}
+/**
+ * Single breadcrumb item configuration
+ */
+interface BreadcrumbItemConfig {
+    /** Display label */
+    label: string;
+    /** Route path - last item should not have href */
+    href?: string;
+}
+/**
+ * Props for the Breadcrumbs component
+ */
+interface BreadcrumbsProps {
+    /** Array of breadcrumb items */
+    items: BreadcrumbItemConfig[];
+    /** Custom link component (e.g., Next.js Link, TanStack Link) */
+    LinkComponent?: React.ComponentType<BreadcrumbLinkProps>;
+    /** Additional class names */
+    className?: string;
+    /** Maximum items to show before collapsing */
+    maxItems?: number;
+    /** Custom separator element */
+    separator?: React.ReactNode;
+}
+/**
+ * Breadcrumbs provides navigation context showing the user's location.
+ *
+ * Features:
+ * - Router-agnostic - works with any Link component
+ * - Automatic collapse with dropdown for long paths
+ * - Accessible breadcrumb semantics
+ * - Custom separator support
+ *
+ * @example
+ * ```tsx
+ * // With default anchor tags
+ * <Breadcrumbs
+ *   items={[
+ *     { label: 'Home', href: '/' },
+ *     { label: 'Users', href: '/users' },
+ *     { label: 'John Doe' },
+ *   ]}
+ * />
+ *
+ * // With TanStack Router Link
+ * import { Link } from '@tanstack/react-router'
+ *
+ * <Breadcrumbs
+ *   items={breadcrumbItems}
+ *   LinkComponent={({ href, children, className }) => (
+ *     <Link to={href} className={className}>{children}</Link>
+ *   )}
+ * />
+ *
+ * // With Next.js Link
+ * import NextLink from 'next/link'
+ *
+ * <Breadcrumbs
+ *   items={breadcrumbItems}
+ *   LinkComponent={NextLink}
+ * />
+ * ```
+ */
+declare function Breadcrumbs({ items, LinkComponent, className, maxItems, separator, }: BreadcrumbsProps): react_jsx_runtime.JSX.Element | null;
+declare namespace Breadcrumbs {
+    var displayName: string;
+}
+
+export { type BreadcrumbLinkProps as B, type BreadcrumbItemConfig as a, type BreadcrumbsProps as b, Breadcrumbs as c };

package/dist/capnweb-client-Bq78FtEA.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Cap'n Web Client Wrapper for DO Admin API
+ *
+ * This wraps the raw capnweb HTTP batch client to provide a structured interface
+ * matching the DOClient interface (client.Thing.list, client.Schema.discover, etc.)
+ *
+ * @module
+ */
+/** SQL execution result */
+interface SQLResult {
+    rows: Record<string, unknown>[];
+    columns: {
+        name: string;
+        type: string;
+    }[];
+    rowsAffected?: number;
+    executionTimeMs?: number;
+}
+interface CapnwebClientOptions {
+    /** Auth token to include in Authorization header */
+    authToken?: string;
+}
+/**
+ * Create a Cap'n Web client that matches the DOClient interface
+ *
+ * @param baseUrl - The base URL for the RPC endpoint
+ * @param options - Client options including auth token
+ */
+declare function createCapnwebClient(baseUrl: string, options?: CapnwebClientOptions): {
+    /**
+     * Namespace operations
+     */
+    Namespace: {
+        list(_params?: {
+            includeSystem?: boolean;
+        }): Promise<{
+            id: string;
+            name: string;
+        }[]>;
+    };
+    /**
+     * Schema operations
+     */
+    Schema: {
+        discover(_params?: {
+            ns?: string;
+        }): Promise<{
+            namespaces: string[];
+            types: string[];
+            schemas: string[];
+        }>;
+        get(params: {
+            ns?: string;
+            type: string;
+        }): Promise<unknown>;
+    };
+    /**
+     * Thing operations
+     */
+    Thing: {
+        types(params: {
+            ns?: string;
+            includeSystem?: boolean;
+        }): Promise<{
+            name: string;
+            ns: string;
+        }[]>;
+        list(params: {
+            ns?: string;
+            type?: string;
+            limit?: number;
+            offset?: number;
+        }): Promise<{
+            data: unknown[];
+            total: number;
+        }>;
+        get(params: {
+            ns?: string;
+            type: string;
+            id: string;
+        }): Promise<unknown>;
+        create(params: {
+            ns?: string;
+            type: string;
+            data: unknown;
+        }): Promise<unknown>;
+        update(params: {
+            ns?: string;
+            type: string;
+            id: string;
+            data: unknown;
+        }): Promise<unknown>;
+        delete(params: {
+            ns?: string;
+            type: string;
+            id: string;
+            hard?: boolean;
+        }): Promise<{
+            success: boolean;
+        }>;
+        versions(_params: {
+            ns?: string;
+            type: string;
+            id: string;
+        }): Promise<never[]>;
+        stats(_params: {
+            ns?: string;
+            type?: string;
+        }): Promise<{
+            total: number;
+            byType: Record<string, number>;
+        }>;
+    };
+    /**
+     * SQL operations (not supported by capnweb servers)
+     */
+    SQL: {
+        execute(_params: {
+            query: string;
+            params?: unknown[];
+        }): Promise<SQLResult>;
+    };
+    dup: () => /*elided*/ any;
+    onRpcBroken: (callback: (error: unknown) => void) => void;
+    [Symbol.dispose]: () => void;
+};
+/**
+ * Create a capnweb client context - factory function matching DOClient interface
+ */
+declare function $CapnwebContext(url: string, options?: CapnwebClientOptions): {
+    /**
+     * Namespace operations
+     */
+    Namespace: {
+        list(_params?: {
+            includeSystem?: boolean;
+        }): Promise<{
+            id: string;
+            name: string;
+        }[]>;
+    };
+    /**
+     * Schema operations
+     */
+    Schema: {
+        discover(_params?: {
+            ns?: string;
+        }): Promise<{
+            namespaces: string[];
+            types: string[];
+            schemas: string[];
+        }>;
+        get(params: {
+            ns?: string;
+            type: string;
+        }): Promise<unknown>;
+    };
+    /**
+     * Thing operations
+     */
+    Thing: {
+        types(params: {
+            ns?: string;
+            includeSystem?: boolean;
+        }): Promise<{
+            name: string;
+            ns: string;
+        }[]>;
+        list(params: {
+            ns?: string;
+            type?: string;
+            limit?: number;
+            offset?: number;
+        }): Promise<{
+            data: unknown[];
+            total: number;
+        }>;
+        get(params: {
+            ns?: string;
+            type: string;
+            id: string;
+        }): Promise<unknown>;
+        create(params: {
+            ns?: string;
+            type: string;
+            data: unknown;
+        }): Promise<unknown>;
+        update(params: {
+            ns?: string;
+            type: string;
+            id: string;
+            data: unknown;
+        }): Promise<unknown>;
+        delete(params: {
+            ns?: string;
+            type: string;
+            id: string;
+            hard?: boolean;
+        }): Promise<{
+            success: boolean;
+        }>;
+        versions(_params: {
+            ns?: string;
+            type: string;
+            id: string;
+        }): Promise<never[]>;
+        stats(_params: {
+            ns?: string;
+            type?: string;
+        }): Promise<{
+            total: number;
+            byType: Record<string, number>;
+        }>;
+    };
+    /**
+     * SQL operations (not supported by capnweb servers)
+     */
+    SQL: {
+        execute(_params: {
+            query: string;
+            params?: unknown[];
+        }): Promise<SQLResult>;
+    };
+    dup: () => /*elided*/ any;
+    onRpcBroken: (callback: (error: unknown) => void) => void;
+    [Symbol.dispose]: () => void;
+};
+
+export { $CapnwebContext as $, createCapnwebClient as c };