@btst/stack 1.7.0 → 1.9.0

package/dist/plugins/route-docs/client/index.d.cts

@@ -0,0 +1,126 @@
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
+import * as react from 'react';
+import * as _btst_yar from '@btst/yar';
+import { QueryClient } from '@tanstack/react-query';
+import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.cjs';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Represents a documented route parameter
+ */
+interface RouteParameter {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    schema?: Record<string, any>;
+}
+/**
+ * Sitemap entry with plugin source
+ */
+interface PluginSitemapEntry extends SitemapEntry {
+    pluginKey: string;
+}
+/**
+ * Represents a documented route
+ */
+interface DocumentedRoute {
+    /** Route key from the plugin */
+    key: string;
+    /** The route path pattern (e.g., "/users/:id") */
+    path: string;
+    /** Path parameters extracted from the path */
+    pathParams: RouteParameter[];
+    /** Query parameters from the route's query schema */
+    queryParams: RouteParameter[];
+    /** Route metadata */
+    meta?: {
+        title?: string;
+        description?: string;
+        tags?: string[];
+        [key: string]: any;
+    };
+}
+/**
+ * Represents a plugin's documented routes
+ */
+interface DocumentedPlugin {
+    /** Plugin key */
+    key: string;
+    /** Plugin name */
+    name: string;
+    /** Routes from this plugin */
+    routes: DocumentedRoute[];
+    /** Sitemap entries from this plugin */
+    sitemapEntries: PluginSitemapEntry[];
+}
+/**
+ * The complete route documentation schema
+ */
+interface RouteDocsSchema {
+    /** All documented plugins */
+    plugins: DocumentedPlugin[];
+    /** Generation timestamp */
+    generatedAt: string;
+    /** All sitemap entries aggregated */
+    allSitemapEntries: PluginSitemapEntry[];
+}
+
+/**
+ * Query key for route docs schema
+ */
+declare const ROUTE_DOCS_QUERY_KEY: readonly ["route-docs", "schema"];
+/**
+ * Get the stored client stack context
+ * Used by the docs page component to generate schema on client-side navigation
+ */
+declare function getStoredContext(): ClientStackContext | null;
+/**
+ * Generate the route docs schema from the stored context
+ * This can be called from both server and client
+ */
+declare function generateSchema(): Promise<RouteDocsSchema>;
+/**
+ * Configuration for Route Docs client plugin
+ */
+interface RouteDocsClientConfig {
+    /** React Query client for SSR prefetching */
+    queryClient: QueryClient;
+    /** Title for the documentation page */
+    title?: string;
+    /** Description for the documentation page */
+    description?: string;
+    /** Site base path for constructing URLs (e.g., "/pages") */
+    siteBasePath: string;
+}
+/**
+ * Route Docs client plugin
+ * Provides a route that displays documentation for all client routes
+ */
+declare const routeDocsClientPlugin: (config: RouteDocsClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
+    docs: {
+        (inputCtx_0?: _btst_yar.InputContext<"/route-docs", _btst_yar.RouteOptions> | undefined): {
+            PageComponent?: react.ComponentType<unknown> | undefined;
+            LoadingComponent?: react.ComponentType<unknown> | undefined;
+            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            loader?: (() => Promise<void>) | undefined;
+            meta?: (() => ({
+                title: string;
+                name?: undefined;
+                content?: undefined;
+            } | {
+                name: string;
+                content: string;
+                title?: undefined;
+            })[]) | undefined;
+            extra?: (() => any) | undefined;
+        };
+        options: _btst_yar.RouteOptions | undefined;
+        path: "/route-docs";
+        meta: _btst_yar.RouteMeta | undefined;
+    };
+}>;
+
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin };
+export type { RouteDocsClientConfig };

package/dist/plugins/route-docs/client/index.d.mts

@@ -0,0 +1,126 @@
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
+import * as react from 'react';
+import * as _btst_yar from '@btst/yar';
+import { QueryClient } from '@tanstack/react-query';
+import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.mjs';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Represents a documented route parameter
+ */
+interface RouteParameter {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    schema?: Record<string, any>;
+}
+/**
+ * Sitemap entry with plugin source
+ */
+interface PluginSitemapEntry extends SitemapEntry {
+    pluginKey: string;
+}
+/**
+ * Represents a documented route
+ */
+interface DocumentedRoute {
+    /** Route key from the plugin */
+    key: string;
+    /** The route path pattern (e.g., "/users/:id") */
+    path: string;
+    /** Path parameters extracted from the path */
+    pathParams: RouteParameter[];
+    /** Query parameters from the route's query schema */
+    queryParams: RouteParameter[];
+    /** Route metadata */
+    meta?: {
+        title?: string;
+        description?: string;
+        tags?: string[];
+        [key: string]: any;
+    };
+}
+/**
+ * Represents a plugin's documented routes
+ */
+interface DocumentedPlugin {
+    /** Plugin key */
+    key: string;
+    /** Plugin name */
+    name: string;
+    /** Routes from this plugin */
+    routes: DocumentedRoute[];
+    /** Sitemap entries from this plugin */
+    sitemapEntries: PluginSitemapEntry[];
+}
+/**
+ * The complete route documentation schema
+ */
+interface RouteDocsSchema {
+    /** All documented plugins */
+    plugins: DocumentedPlugin[];
+    /** Generation timestamp */
+    generatedAt: string;
+    /** All sitemap entries aggregated */
+    allSitemapEntries: PluginSitemapEntry[];
+}
+
+/**
+ * Query key for route docs schema
+ */
+declare const ROUTE_DOCS_QUERY_KEY: readonly ["route-docs", "schema"];
+/**
+ * Get the stored client stack context
+ * Used by the docs page component to generate schema on client-side navigation
+ */
+declare function getStoredContext(): ClientStackContext | null;
+/**
+ * Generate the route docs schema from the stored context
+ * This can be called from both server and client
+ */
+declare function generateSchema(): Promise<RouteDocsSchema>;
+/**
+ * Configuration for Route Docs client plugin
+ */
+interface RouteDocsClientConfig {
+    /** React Query client for SSR prefetching */
+    queryClient: QueryClient;
+    /** Title for the documentation page */
+    title?: string;
+    /** Description for the documentation page */
+    description?: string;
+    /** Site base path for constructing URLs (e.g., "/pages") */
+    siteBasePath: string;
+}
+/**
+ * Route Docs client plugin
+ * Provides a route that displays documentation for all client routes
+ */
+declare const routeDocsClientPlugin: (config: RouteDocsClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
+    docs: {
+        (inputCtx_0?: _btst_yar.InputContext<"/route-docs", _btst_yar.RouteOptions> | undefined): {
+            PageComponent?: react.ComponentType<unknown> | undefined;
+            LoadingComponent?: react.ComponentType<unknown> | undefined;
+            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            loader?: (() => Promise<void>) | undefined;
+            meta?: (() => ({
+                title: string;
+                name?: undefined;
+                content?: undefined;
+            } | {
+                name: string;
+                content: string;
+                title?: undefined;
+            })[]) | undefined;
+            extra?: (() => any) | undefined;
+        };
+        options: _btst_yar.RouteOptions | undefined;
+        path: "/route-docs";
+        meta: _btst_yar.RouteMeta | undefined;
+    };
+}>;
+
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin };
+export type { RouteDocsClientConfig };

package/dist/plugins/route-docs/client/index.d.ts

@@ -0,0 +1,126 @@
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
+import * as react from 'react';
+import * as _btst_yar from '@btst/yar';
+import { QueryClient } from '@tanstack/react-query';
+import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.js';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Represents a documented route parameter
+ */
+interface RouteParameter {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    schema?: Record<string, any>;
+}
+/**
+ * Sitemap entry with plugin source
+ */
+interface PluginSitemapEntry extends SitemapEntry {
+    pluginKey: string;
+}
+/**
+ * Represents a documented route
+ */
+interface DocumentedRoute {
+    /** Route key from the plugin */
+    key: string;
+    /** The route path pattern (e.g., "/users/:id") */
+    path: string;
+    /** Path parameters extracted from the path */
+    pathParams: RouteParameter[];
+    /** Query parameters from the route's query schema */
+    queryParams: RouteParameter[];
+    /** Route metadata */
+    meta?: {
+        title?: string;
+        description?: string;
+        tags?: string[];
+        [key: string]: any;
+    };
+}
+/**
+ * Represents a plugin's documented routes
+ */
+interface DocumentedPlugin {
+    /** Plugin key */
+    key: string;
+    /** Plugin name */
+    name: string;
+    /** Routes from this plugin */
+    routes: DocumentedRoute[];
+    /** Sitemap entries from this plugin */
+    sitemapEntries: PluginSitemapEntry[];
+}
+/**
+ * The complete route documentation schema
+ */
+interface RouteDocsSchema {
+    /** All documented plugins */
+    plugins: DocumentedPlugin[];
+    /** Generation timestamp */
+    generatedAt: string;
+    /** All sitemap entries aggregated */
+    allSitemapEntries: PluginSitemapEntry[];
+}
+
+/**
+ * Query key for route docs schema
+ */
+declare const ROUTE_DOCS_QUERY_KEY: readonly ["route-docs", "schema"];
+/**
+ * Get the stored client stack context
+ * Used by the docs page component to generate schema on client-side navigation
+ */
+declare function getStoredContext(): ClientStackContext | null;
+/**
+ * Generate the route docs schema from the stored context
+ * This can be called from both server and client
+ */
+declare function generateSchema(): Promise<RouteDocsSchema>;
+/**
+ * Configuration for Route Docs client plugin
+ */
+interface RouteDocsClientConfig {
+    /** React Query client for SSR prefetching */
+    queryClient: QueryClient;
+    /** Title for the documentation page */
+    title?: string;
+    /** Description for the documentation page */
+    description?: string;
+    /** Site base path for constructing URLs (e.g., "/pages") */
+    siteBasePath: string;
+}
+/**
+ * Route Docs client plugin
+ * Provides a route that displays documentation for all client routes
+ */
+declare const routeDocsClientPlugin: (config: RouteDocsClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
+    docs: {
+        (inputCtx_0?: _btst_yar.InputContext<"/route-docs", _btst_yar.RouteOptions> | undefined): {
+            PageComponent?: react.ComponentType<unknown> | undefined;
+            LoadingComponent?: react.ComponentType<unknown> | undefined;
+            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            loader?: (() => Promise<void>) | undefined;
+            meta?: (() => ({
+                title: string;
+                name?: undefined;
+                content?: undefined;
+            } | {
+                name: string;
+                content: string;
+                title?: undefined;
+            })[]) | undefined;
+            extra?: (() => any) | undefined;
+        };
+        options: _btst_yar.RouteOptions | undefined;
+        path: "/route-docs";
+        meta: _btst_yar.RouteMeta | undefined;
+    };
+}>;
+
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin };
+export type { RouteDocsClientConfig };

package/dist/plugins/route-docs/client/index.mjs

@@ -0,0 +1 @@
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin } from '../../../packages/better-stack/src/plugins/route-docs/client/plugin.mjs';

package/dist/plugins/route-docs/client.css

@@ -0,0 +1,3 @@
+/* Route Docs Plugin Client CSS */
+/* No custom styles needed - uses shadcn/ui components and Tailwind */
+

package/dist/plugins/route-docs/style.css

@@ -0,0 +1,19 @@
+@import "./client.css";
+
+/*
+ * Route Docs Plugin CSS - Includes Tailwind class scanning
+ * 
+ * When consumed from npm, Tailwind v4 will automatically scan this package's
+ * source files for Tailwind classes. Consumers only need:
+ *   @import "@btst/stack/plugins/route-docs/css";
+ */
+
+/* Scan this package's source files for Tailwind classes */
+@source "../../../src/**/*.{ts,tsx}";
+
+/* Scan UI package components (when installed as npm package the UI package will be in this dir) */
+@source "../../packages/ui/src";
+
+/*
+* alternatively consumer can use @source "../node_modules/@btst/stack/src/**\/*.{ts,tsx}";
+*/

package/dist/shared/{stack.L-UFwz2G.d.mts → stack.oGOteE6g.d.cts}

@@ -58,6 +58,19 @@ type ContentItem = {
     createdAt: Date;
     updatedAt: Date;
 };
+/**
+ * Represents an inverse relation (content types that reference this type via belongsTo)
+ */
+interface InverseRelation {
+    /** The content type slug that has the belongsTo relation */
+    sourceType: string;
+    /** Display name of the source content type */
+    sourceTypeName: string;
+    /** The field name that contains the belongsTo relation */
+    fieldName: string;
+    /** Count of items with this relation (when itemId is provided) */
+    count: number;
+}
 /**
  * Serialized content type for API responses (dates as strings)
  */
@@ -81,6 +94,11 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
     parsedData: TData;
     /** Joined content type */
     contentType?: SerializedContentType;
+    /**
+     * Populated relation data (only present when using populated endpoints/hooks).
+     * Keys are field names, values are arrays of related content items.
+     */
+    _relations?: Record<string, SerializedContentItemWithType[]>;
 }
 /**
  * Paginated list response for content items
@@ -105,14 +123,18 @@ interface CMSHookContext {
 }
 /**
  * Hooks for customizing CMS backend behavior
+ *
+ * Note: Before hooks can only deny operations by returning `false`.
+ * They cannot modify the data being saved. This ensures consistency
+ * between the stored content item data and relation junction tables.
  */
 interface CMSBackendHooks {
-    /** Called before creating a content item */
-    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before creating a content item. Return false to deny the operation. */
+    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after creating a content item */
     onAfterCreate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
-    /** Called before updating a content item */
-    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before updating a content item. Return false to deny the operation. */
+    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after updating a content item */
     onAfterUpdate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
     /** Called before deleting a content item */
@@ -132,4 +154,4 @@ interface CMSBackendConfig {
     hooks?: CMSBackendHooks;
 }
 
-export type { CMSBackendConfig as C, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };
+export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };

package/dist/shared/{stack.L-UFwz2G.d.ts → stack.oGOteE6g.d.mts}

@@ -58,6 +58,19 @@ type ContentItem = {
     createdAt: Date;
     updatedAt: Date;
 };
+/**
+ * Represents an inverse relation (content types that reference this type via belongsTo)
+ */
+interface InverseRelation {
+    /** The content type slug that has the belongsTo relation */
+    sourceType: string;
+    /** Display name of the source content type */
+    sourceTypeName: string;
+    /** The field name that contains the belongsTo relation */
+    fieldName: string;
+    /** Count of items with this relation (when itemId is provided) */
+    count: number;
+}
 /**
  * Serialized content type for API responses (dates as strings)
  */
@@ -81,6 +94,11 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
     parsedData: TData;
     /** Joined content type */
     contentType?: SerializedContentType;
+    /**
+     * Populated relation data (only present when using populated endpoints/hooks).
+     * Keys are field names, values are arrays of related content items.
+     */
+    _relations?: Record<string, SerializedContentItemWithType[]>;
 }
 /**
  * Paginated list response for content items
@@ -105,14 +123,18 @@ interface CMSHookContext {
 }
 /**
  * Hooks for customizing CMS backend behavior
+ *
+ * Note: Before hooks can only deny operations by returning `false`.
+ * They cannot modify the data being saved. This ensures consistency
+ * between the stored content item data and relation junction tables.
  */
 interface CMSBackendHooks {
-    /** Called before creating a content item */
-    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before creating a content item. Return false to deny the operation. */
+    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after creating a content item */
     onAfterCreate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
-    /** Called before updating a content item */
-    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before updating a content item. Return false to deny the operation. */
+    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after updating a content item */
     onAfterUpdate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
     /** Called before deleting a content item */
@@ -132,4 +154,4 @@ interface CMSBackendConfig {
     hooks?: CMSBackendHooks;
 }
 
-export type { CMSBackendConfig as C, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };
+export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };

package/dist/shared/{stack.L-UFwz2G.d.cts → stack.oGOteE6g.d.ts}

@@ -58,6 +58,19 @@ type ContentItem = {
     createdAt: Date;
     updatedAt: Date;
 };
+/**
+ * Represents an inverse relation (content types that reference this type via belongsTo)
+ */
+interface InverseRelation {
+    /** The content type slug that has the belongsTo relation */
+    sourceType: string;
+    /** Display name of the source content type */
+    sourceTypeName: string;
+    /** The field name that contains the belongsTo relation */
+    fieldName: string;
+    /** Count of items with this relation (when itemId is provided) */
+    count: number;
+}
 /**
  * Serialized content type for API responses (dates as strings)
  */
@@ -81,6 +94,11 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
     parsedData: TData;
     /** Joined content type */
     contentType?: SerializedContentType;
+    /**
+     * Populated relation data (only present when using populated endpoints/hooks).
+     * Keys are field names, values are arrays of related content items.
+     */
+    _relations?: Record<string, SerializedContentItemWithType[]>;
 }
 /**
  * Paginated list response for content items
@@ -105,14 +123,18 @@ interface CMSHookContext {
 }
 /**
  * Hooks for customizing CMS backend behavior
+ *
+ * Note: Before hooks can only deny operations by returning `false`.
+ * They cannot modify the data being saved. This ensures consistency
+ * between the stored content item data and relation junction tables.
  */
 interface CMSBackendHooks {
-    /** Called before creating a content item */
-    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before creating a content item. Return false to deny the operation. */
+    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after creating a content item */
     onAfterCreate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
-    /** Called before updating a content item */
-    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before updating a content item. Return false to deny the operation. */
+    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after updating a content item */
     onAfterUpdate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
     /** Called before deleting a content item */
@@ -132,4 +154,4 @@ interface CMSBackendConfig {
     hooks?: CMSBackendHooks;
 }
 
-export type { CMSBackendConfig as C, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };
+export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };

package/dist/shared/{stack.CSce37mX.d.cts → stack.u9iYV6vt.d.cts}

@@ -14,6 +14,16 @@ interface BetterStackContext {
     /** The database adapter */
     adapter: Adapter;
 }
+/**
+ * Context passed to client plugins during route creation
+ * Provides access to all registered plugins for introspection (used by routeDocs plugin)
+ */
+interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, any>> = Record<string, ClientPlugin<any, any>>> {
+    /** All registered client plugins */
+    plugins: TPlugins;
+    /** The base path for the client (e.g., "/app") */
+    basePath?: string;
+}
 /**
  * Backend plugin definition
  * Defines API routes and data access for a feature
@@ -50,8 +60,10 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
     /**
      * Define routes (pages) for this plugin
      * Returns yar routes that will be composed into the router
+     *
+     * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: () => TRoutes;
+    routes: (context?: ClientStackContext) => TRoutes;
     /**
      * Optional sitemap generator for this plugin. Should return absolute URLs.
      * Implementations can call their own API endpoints to include dynamic routes.
@@ -142,4 +154,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, Sitemap as S, BetterStackContext as a, PluginRoutes as b, ClientLibConfig as c, ClientLib as d, PrefixedPluginRoutes as e, BackendLibConfig as f, BackendLib as g };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, SitemapEntry as S, BetterStackContext as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };

package/dist/shared/{stack.CSce37mX.d.mts → stack.u9iYV6vt.d.mts}

@@ -14,6 +14,16 @@ interface BetterStackContext {
     /** The database adapter */
     adapter: Adapter;
 }
+/**
+ * Context passed to client plugins during route creation
+ * Provides access to all registered plugins for introspection (used by routeDocs plugin)
+ */
+interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, any>> = Record<string, ClientPlugin<any, any>>> {
+    /** All registered client plugins */
+    plugins: TPlugins;
+    /** The base path for the client (e.g., "/app") */
+    basePath?: string;
+}
 /**
  * Backend plugin definition
  * Defines API routes and data access for a feature
@@ -50,8 +60,10 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
     /**
      * Define routes (pages) for this plugin
      * Returns yar routes that will be composed into the router
+     *
+     * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: () => TRoutes;
+    routes: (context?: ClientStackContext) => TRoutes;
     /**
      * Optional sitemap generator for this plugin. Should return absolute URLs.
      * Implementations can call their own API endpoints to include dynamic routes.
@@ -142,4 +154,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, Sitemap as S, BetterStackContext as a, PluginRoutes as b, ClientLibConfig as c, ClientLib as d, PrefixedPluginRoutes as e, BackendLibConfig as f, BackendLib as g };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, SitemapEntry as S, BetterStackContext as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };