@btst/stack 2.12.2 → 3.0.0-rc.2

package/dist/react-router/index.d.cts

@@ -0,0 +1,132 @@
+import { S as StackRequestHandler, G as GetStackClient, R as ResolveStackClient } from '../shared/stack.EOPVnJrF.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { QueryClient, DehydrateOptions } from '@tanstack/react-query';
+import { ComponentType, ReactNode } from 'react';
+import { S as StackRouterConfig } from '../shared/stack.aqVZ6PEW.cjs';
+
+/**
+ * Wires a BTST API handler to the `loader`/`action` exports a React Router
+ * catch-all API route needs.
+ *
+ * Note: React Router's build cannot strip destructured exports from route
+ * modules, so export the fields individually rather than destructuring.
+ *
+ * @example
+ * ```ts
+ * // app/routes/api/data/$.ts
+ * import { toReactRouterHandlers } from "@btst/stack/react-router";
+ * import { handler } from "~/lib/stack";
+ *
+ * const handlers = toReactRouterHandlers(handler);
+ * export const loader = handlers.loader;
+ * export const action = handlers.action;
+ * ```
+ */
+declare function toReactRouterHandlers(handler: StackRequestHandler): {
+    loader: ({ request }: {
+        request: Request;
+    }) => Response | Promise<Response>;
+    action: ({ request }: {
+        request: Request;
+    }) => Response | Promise<Response>;
+};
+
+/**
+ * Loose structural form of React Router's generated `Route.LoaderArgs` /
+ * `Route.MetaArgs` for a catch-all route. The generated `./+types/$` types
+ * are not available inside the library, so the factory types the subset it
+ * uses; the results remain assignable to the generated route exports.
+ */
+interface ReactRouterPageLoaderArgs<TContext = unknown> {
+    /** The request that triggered the route loader. */
+    request: Request;
+    /** Parameters for the React Router catch-all route. */
+    params: {
+        "*"?: string;
+    } & Record<string, string | undefined>;
+    /** Request-local values supplied by React Router middleware. */
+    context: TContext;
+}
+interface CreateReactRouterPageOptions {
+    /** Returns the stack client for a given QueryClient (`lib/stack-client`). */
+    getStackClient: GetStackClient;
+    /** Returns the QueryClient for the current context (`lib/query-client`). */
+    getQueryClient: () => QueryClient;
+    /** Rendered when no route matches. Defaults to a "Route not found" div. */
+    NotFound?: ComponentType;
+    /**
+     * Rendered when the route errors. Defaults to a `<pre>` with the
+     * stringified error — provide your own component for a production-safe
+     * error UI (use `useRouteError()` from react-router to read the error).
+     */
+    ErrorBoundary?: ComponentType;
+    /** Wraps the rendered page (inside the `HydrationBoundary`). */
+    wrapPage?: (page: ReactNode) => ReactNode;
+    /**
+     * Options passed to `dehydrate()`. Defaults to dehydrating failed queries
+     * in addition to the React Query defaults, so the client does not refetch
+     * queries that errored during SSR. Override e.g. to sanitize error
+     * payloads before they are serialized into the HTML.
+     */
+    dehydrateOptions?: DehydrateOptions;
+}
+/**
+ * Creates the React Router catch-all route pieces for BTST plugin routes:
+ * SSR prefetch via `route.loader()`, React Query dehydration (including
+ * failed queries), and loader-before-meta ordering.
+ *
+ * @example
+ * ```tsx
+ * // app/routes/pages/$.tsx
+ * import { createReactRouterPage } from "@btst/stack/react-router";
+ * import { getOrCreateQueryClient } from "~/lib/query-client";
+ * import { getStackClient } from "~/lib/stack-client";
+ *
+ * const page = createReactRouterPage({ getStackClient, getQueryClient: getOrCreateQueryClient });
+ * export const loader = page.loader;
+ * export const meta = page.meta;
+ * export default page.Component;
+ * ```
+ */
+declare function createReactRouterPage(options: CreateReactRouterPageOptions): {
+    loader: (loaderArgs: ReactRouterPageLoaderArgs<unknown>) => Promise<{
+        path: string;
+        dehydratedState: _tanstack_react_query.DehydratedState;
+        meta: any;
+    }>;
+    createLoader: <TContext = unknown>(getLoaderStackClient?: ResolveStackClient<ReactRouterPageLoaderArgs<TContext>>) => (loaderArgs: ReactRouterPageLoaderArgs<TContext>) => Promise<{
+        path: string;
+        dehydratedState: _tanstack_react_query.DehydratedState;
+        meta: any;
+    }>;
+    meta: (args: {
+        loaderData?: {
+            path: string;
+            dehydratedState: _tanstack_react_query.DehydratedState;
+            meta: any;
+        };
+        data?: {
+            path: string;
+            dehydratedState: _tanstack_react_query.DehydratedState;
+            meta: any;
+        };
+    }) => any;
+    Component: () => react_jsx_runtime.JSX.Element;
+    ErrorBoundary: ComponentType | (() => react_jsx_runtime.JSX.Element);
+};
+
+/**
+ * Router preset for React Router (v7).
+ *
+ * @example
+ * ```tsx
+ * import { reactRouter } from "@btst/stack/react-router";
+ *
+ * <StackProvider basePath="/pages" router={reactRouter()} api={{ baseURL, basePath: "/api/data" }}>
+ * ```
+ */
+declare function reactRouter(): StackRouterConfig;
+
+export { GetStackClient, ResolveStackClient, StackRequestHandler, createReactRouterPage, reactRouter, toReactRouterHandlers };
+export type { CreateReactRouterPageOptions, ReactRouterPageLoaderArgs };

package/dist/react-router/index.d.mts

@@ -0,0 +1,132 @@
+import { S as StackRequestHandler, G as GetStackClient, R as ResolveStackClient } from '../shared/stack.EOPVnJrF.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { QueryClient, DehydrateOptions } from '@tanstack/react-query';
+import { ComponentType, ReactNode } from 'react';
+import { S as StackRouterConfig } from '../shared/stack.aqVZ6PEW.mjs';
+
+/**
+ * Wires a BTST API handler to the `loader`/`action` exports a React Router
+ * catch-all API route needs.
+ *
+ * Note: React Router's build cannot strip destructured exports from route
+ * modules, so export the fields individually rather than destructuring.
+ *
+ * @example
+ * ```ts
+ * // app/routes/api/data/$.ts
+ * import { toReactRouterHandlers } from "@btst/stack/react-router";
+ * import { handler } from "~/lib/stack";
+ *
+ * const handlers = toReactRouterHandlers(handler);
+ * export const loader = handlers.loader;
+ * export const action = handlers.action;
+ * ```
+ */
+declare function toReactRouterHandlers(handler: StackRequestHandler): {
+    loader: ({ request }: {
+        request: Request;
+    }) => Response | Promise<Response>;
+    action: ({ request }: {
+        request: Request;
+    }) => Response | Promise<Response>;
+};
+
+/**
+ * Loose structural form of React Router's generated `Route.LoaderArgs` /
+ * `Route.MetaArgs` for a catch-all route. The generated `./+types/$` types
+ * are not available inside the library, so the factory types the subset it
+ * uses; the results remain assignable to the generated route exports.
+ */
+interface ReactRouterPageLoaderArgs<TContext = unknown> {
+    /** The request that triggered the route loader. */
+    request: Request;
+    /** Parameters for the React Router catch-all route. */
+    params: {
+        "*"?: string;
+    } & Record<string, string | undefined>;
+    /** Request-local values supplied by React Router middleware. */
+    context: TContext;
+}
+interface CreateReactRouterPageOptions {
+    /** Returns the stack client for a given QueryClient (`lib/stack-client`). */
+    getStackClient: GetStackClient;
+    /** Returns the QueryClient for the current context (`lib/query-client`). */
+    getQueryClient: () => QueryClient;
+    /** Rendered when no route matches. Defaults to a "Route not found" div. */
+    NotFound?: ComponentType;
+    /**
+     * Rendered when the route errors. Defaults to a `<pre>` with the
+     * stringified error — provide your own component for a production-safe
+     * error UI (use `useRouteError()` from react-router to read the error).
+     */
+    ErrorBoundary?: ComponentType;
+    /** Wraps the rendered page (inside the `HydrationBoundary`). */
+    wrapPage?: (page: ReactNode) => ReactNode;
+    /**
+     * Options passed to `dehydrate()`. Defaults to dehydrating failed queries
+     * in addition to the React Query defaults, so the client does not refetch
+     * queries that errored during SSR. Override e.g. to sanitize error
+     * payloads before they are serialized into the HTML.
+     */
+    dehydrateOptions?: DehydrateOptions;
+}
+/**
+ * Creates the React Router catch-all route pieces for BTST plugin routes:
+ * SSR prefetch via `route.loader()`, React Query dehydration (including
+ * failed queries), and loader-before-meta ordering.
+ *
+ * @example
+ * ```tsx
+ * // app/routes/pages/$.tsx
+ * import { createReactRouterPage } from "@btst/stack/react-router";
+ * import { getOrCreateQueryClient } from "~/lib/query-client";
+ * import { getStackClient } from "~/lib/stack-client";
+ *
+ * const page = createReactRouterPage({ getStackClient, getQueryClient: getOrCreateQueryClient });
+ * export const loader = page.loader;
+ * export const meta = page.meta;
+ * export default page.Component;
+ * ```
+ */
+declare function createReactRouterPage(options: CreateReactRouterPageOptions): {
+    loader: (loaderArgs: ReactRouterPageLoaderArgs<unknown>) => Promise<{
+        path: string;
+        dehydratedState: _tanstack_react_query.DehydratedState;
+        meta: any;
+    }>;
+    createLoader: <TContext = unknown>(getLoaderStackClient?: ResolveStackClient<ReactRouterPageLoaderArgs<TContext>>) => (loaderArgs: ReactRouterPageLoaderArgs<TContext>) => Promise<{
+        path: string;
+        dehydratedState: _tanstack_react_query.DehydratedState;
+        meta: any;
+    }>;
+    meta: (args: {
+        loaderData?: {
+            path: string;
+            dehydratedState: _tanstack_react_query.DehydratedState;
+            meta: any;
+        };
+        data?: {
+            path: string;
+            dehydratedState: _tanstack_react_query.DehydratedState;
+            meta: any;
+        };
+    }) => any;
+    Component: () => react_jsx_runtime.JSX.Element;
+    ErrorBoundary: ComponentType | (() => react_jsx_runtime.JSX.Element);
+};
+
+/**
+ * Router preset for React Router (v7).
+ *
+ * @example
+ * ```tsx
+ * import { reactRouter } from "@btst/stack/react-router";
+ *
+ * <StackProvider basePath="/pages" router={reactRouter()} api={{ baseURL, basePath: "/api/data" }}>
+ * ```
+ */
+declare function reactRouter(): StackRouterConfig;
+
+export { GetStackClient, ResolveStackClient, StackRequestHandler, createReactRouterPage, reactRouter, toReactRouterHandlers };
+export type { CreateReactRouterPageOptions, ReactRouterPageLoaderArgs };

package/dist/react-router/index.d.ts

@@ -0,0 +1,132 @@
+import { S as StackRequestHandler, G as GetStackClient, R as ResolveStackClient } from '../shared/stack.EOPVnJrF.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { QueryClient, DehydrateOptions } from '@tanstack/react-query';
+import { ComponentType, ReactNode } from 'react';
+import { S as StackRouterConfig } from '../shared/stack.aqVZ6PEW.js';
+
+/**
+ * Wires a BTST API handler to the `loader`/`action` exports a React Router
+ * catch-all API route needs.
+ *
+ * Note: React Router's build cannot strip destructured exports from route
+ * modules, so export the fields individually rather than destructuring.
+ *
+ * @example
+ * ```ts
+ * // app/routes/api/data/$.ts
+ * import { toReactRouterHandlers } from "@btst/stack/react-router";
+ * import { handler } from "~/lib/stack";
+ *
+ * const handlers = toReactRouterHandlers(handler);
+ * export const loader = handlers.loader;
+ * export const action = handlers.action;
+ * ```
+ */
+declare function toReactRouterHandlers(handler: StackRequestHandler): {
+    loader: ({ request }: {
+        request: Request;
+    }) => Response | Promise<Response>;
+    action: ({ request }: {
+        request: Request;
+    }) => Response | Promise<Response>;
+};
+
+/**
+ * Loose structural form of React Router's generated `Route.LoaderArgs` /
+ * `Route.MetaArgs` for a catch-all route. The generated `./+types/$` types
+ * are not available inside the library, so the factory types the subset it
+ * uses; the results remain assignable to the generated route exports.
+ */
+interface ReactRouterPageLoaderArgs<TContext = unknown> {
+    /** The request that triggered the route loader. */
+    request: Request;
+    /** Parameters for the React Router catch-all route. */
+    params: {
+        "*"?: string;
+    } & Record<string, string | undefined>;
+    /** Request-local values supplied by React Router middleware. */
+    context: TContext;
+}
+interface CreateReactRouterPageOptions {
+    /** Returns the stack client for a given QueryClient (`lib/stack-client`). */
+    getStackClient: GetStackClient;
+    /** Returns the QueryClient for the current context (`lib/query-client`). */
+    getQueryClient: () => QueryClient;
+    /** Rendered when no route matches. Defaults to a "Route not found" div. */
+    NotFound?: ComponentType;
+    /**
+     * Rendered when the route errors. Defaults to a `<pre>` with the
+     * stringified error — provide your own component for a production-safe
+     * error UI (use `useRouteError()` from react-router to read the error).
+     */
+    ErrorBoundary?: ComponentType;
+    /** Wraps the rendered page (inside the `HydrationBoundary`). */
+    wrapPage?: (page: ReactNode) => ReactNode;
+    /**
+     * Options passed to `dehydrate()`. Defaults to dehydrating failed queries
+     * in addition to the React Query defaults, so the client does not refetch
+     * queries that errored during SSR. Override e.g. to sanitize error
+     * payloads before they are serialized into the HTML.
+     */
+    dehydrateOptions?: DehydrateOptions;
+}
+/**
+ * Creates the React Router catch-all route pieces for BTST plugin routes:
+ * SSR prefetch via `route.loader()`, React Query dehydration (including
+ * failed queries), and loader-before-meta ordering.
+ *
+ * @example
+ * ```tsx
+ * // app/routes/pages/$.tsx
+ * import { createReactRouterPage } from "@btst/stack/react-router";
+ * import { getOrCreateQueryClient } from "~/lib/query-client";
+ * import { getStackClient } from "~/lib/stack-client";
+ *
+ * const page = createReactRouterPage({ getStackClient, getQueryClient: getOrCreateQueryClient });
+ * export const loader = page.loader;
+ * export const meta = page.meta;
+ * export default page.Component;
+ * ```
+ */
+declare function createReactRouterPage(options: CreateReactRouterPageOptions): {
+    loader: (loaderArgs: ReactRouterPageLoaderArgs<unknown>) => Promise<{
+        path: string;
+        dehydratedState: _tanstack_react_query.DehydratedState;
+        meta: any;
+    }>;
+    createLoader: <TContext = unknown>(getLoaderStackClient?: ResolveStackClient<ReactRouterPageLoaderArgs<TContext>>) => (loaderArgs: ReactRouterPageLoaderArgs<TContext>) => Promise<{
+        path: string;
+        dehydratedState: _tanstack_react_query.DehydratedState;
+        meta: any;
+    }>;
+    meta: (args: {
+        loaderData?: {
+            path: string;
+            dehydratedState: _tanstack_react_query.DehydratedState;
+            meta: any;
+        };
+        data?: {
+            path: string;
+            dehydratedState: _tanstack_react_query.DehydratedState;
+            meta: any;
+        };
+    }) => any;
+    Component: () => react_jsx_runtime.JSX.Element;
+    ErrorBoundary: ComponentType | (() => react_jsx_runtime.JSX.Element);
+};
+
+/**
+ * Router preset for React Router (v7).
+ *
+ * @example
+ * ```tsx
+ * import { reactRouter } from "@btst/stack/react-router";
+ *
+ * <StackProvider basePath="/pages" router={reactRouter()} api={{ baseURL, basePath: "/api/data" }}>
+ * ```
+ */
+declare function reactRouter(): StackRouterConfig;
+
+export { GetStackClient, ResolveStackClient, StackRequestHandler, createReactRouterPage, reactRouter, toReactRouterHandlers };
+export type { CreateReactRouterPageOptions, ReactRouterPageLoaderArgs };

package/dist/react-router/index.mjs

@@ -0,0 +1,3 @@
+export { toReactRouterHandlers } from '../packages/stack/src/react-router/handlers.mjs';
+export { createReactRouterPage } from '../packages/stack/src/react-router/page.mjs';
+export { reactRouter } from '../packages/stack/src/react-router/router.mjs';

package/dist/shared/{stack.BmMB0LNC.d.ts → stack.7b3vsM8_.d.ts}

@@ -72,4 +72,4 @@ interface FunctionDefinition {
  */
 type FunctionRegistry = Record<string, FunctionDefinition>;
 
-export type { ComponentLayer as C, FunctionRegistry as F, PropValue as P, RegistryEntry as R, Variable as V, ComponentRegistry as a, FieldConfigFunction as b };
+export type { ComponentLayer as C, FieldConfigFunction as F, PropValue as P, RegistryEntry as R, Variable as V, ComponentRegistry as a, FunctionRegistry as b };

package/dist/shared/{stack.sba323Ml.d.mts → stack.9BAOaSqE.d.cts}

@@ -22,6 +22,7 @@ interface AiChatLocalization {
     SIDEBAR_SEARCH_PLACEHOLDER: string;
     CONVERSATION_RENAME: string;
     CONVERSATION_RENAME_PLACEHOLDER: string;
+    CONVERSATION_RENAME_DESCRIPTION: string;
     CONVERSATION_RENAME_SAVE: string;
     CONVERSATION_RENAME_CANCEL: string;
     CONVERSATION_DELETE: string;
@@ -29,6 +30,11 @@ interface AiChatLocalization {
     CONVERSATION_DELETE_CONFIRM_DESCRIPTION: string;
     CONVERSATION_DELETE_CONFIRM_BUTTON: string;
     CONVERSATION_DELETE_CANCEL: string;
+    CONVERSATION_RENAME_SUCCESS: string;
+    CONVERSATION_RENAME_FAILURE: string;
+    CONVERSATION_DELETE_SUCCESS: string;
+    CONVERSATION_DELETE_FAILURE: string;
+    CONVERSATION_TITLE_REQUIRED: string;
     IMAGE_UPLOAD_BUTTON: string;
     IMAGE_UPLOAD_UPLOADING: string;
     IMAGE_UPLOAD_ERROR_NOT_IMAGE: string;
@@ -39,6 +45,10 @@ interface AiChatLocalization {
     FILE_UPLOAD_ERROR_TOO_LARGE: string;
     FILE_UPLOAD_SUCCESS: string;
     FILE_UPLOAD_FAILURE: string;
+    FILE_REMOVE: string;
+    FILE_FALLBACK_NAME: string;
+    IMAGE_ATTACHED_ALT: string;
+    IMAGE_GENERATED_ALT: string;
     TIME_JUST_NOW: string;
     TIME_MINUTES_AGO: string;
     TIME_HOURS_AGO: string;
@@ -54,6 +64,24 @@ interface AiChatLocalization {
     A11Y_ASSISTANT_MESSAGE: string;
     A11Y_COPY_CODE: string;
     A11Y_CODE_COPIED: string;
+    A11Y_CONVERSATION_ACTIONS: string;
+    A11Y_CHAT_TITLE: string;
+    A11Y_CLEAR_CHAT: string;
+    A11Y_CLOSE_CHAT: string;
+    A11Y_OPEN_CHAT: string;
+    A11Y_OPEN_MENU: string;
+    A11Y_CLOSE_SIDEBAR: string;
+    A11Y_OPEN_SIDEBAR: string;
+    TOOL_STATUS_RUNNING: string;
+    TOOL_STATUS_EXECUTING: string;
+    TOOL_STATUS_ERROR: string;
+    TOOL_STATUS_COMPLETE: string;
+    TOOL_STATUS_PENDING: string;
+    TOOL_INPUT: string;
+    TOOL_OUTPUT: string;
+    TOOL_ID: string;
+    TOOL_EXECUTION_FAILED: string;
+    TOOL_HANDLER_MISSING: string;
 }
 
 /**
@@ -115,8 +143,8 @@ interface RouteContext {
 /**
  * Overridable components and functions for the AI Chat plugin
  *
- * External consumers can provide their own implementations of these
- * to customize the behavior for their framework (Next.js, React Router, etc.)
+ * External consumers can provide their own implementations to customize
+ * plugin-specific components and behavior.
  */
 interface AiChatPluginOverrides {
     /**
@@ -124,30 +152,6 @@ interface AiChatPluginOverrides {
      * @default 'authenticated'
      */
     mode?: AiChatMode;
-    /**
-     * API base URL
-     */
-    apiBaseURL: string;
-    /**
-     * API base path
-     */
-    apiBasePath: string;
-    /**
-     * Navigation function for programmatic navigation
-     */
-    navigate: (path: string) => void | Promise<void>;
-    /**
-     * Refresh function to invalidate server-side cache (e.g., Next.js router.refresh())
-     */
-    refresh?: () => void | Promise<void>;
-    /**
-     * Link component for navigation
-     */
-    Link?: ComponentType<React.ComponentProps<"a"> & Record<string, any>>;
-    /**
-     * Image component for displaying images
-     */
-    Image?: ComponentType<React.ImgHTMLAttributes<HTMLImageElement> & Record<string, any>>;
     /**
      * Function used to upload a file and return its URL.
      * Called for images, PDFs, text files, and other supported file types.
@@ -217,19 +221,6 @@ interface AiChatPluginOverrides {
      * @param context - Route context
      */
     onRouteError?: (routeName: string, error: Error, context: RouteContext) => void | Promise<void>;
-    /**
-     * Called before the chat page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param context - Route context
-     */
-    onBeforeChatPageRendered?: (context: RouteContext) => boolean;
-    /**
-     * Called before a conversation page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param id - The conversation ID
-     * @param context - Route context
-     */
-    onBeforeConversationPageRendered?: (id: string, context: RouteContext) => boolean;
 }
 
 interface ChatInterfaceProps {
@@ -245,10 +236,6 @@ interface ChatInterfaceProps {
 declare function ChatInterface({ apiPath, initialMessages, id, variant, className, onMessagesChange, }: ChatInterfaceProps): react_jsx_runtime.JSX.Element;
 
 interface ChatLayoutBaseProps {
-    /** API base URL */
-    apiBaseURL: string;
-    /** API base path */
-    apiBasePath: string;
     /** Current conversation ID (if viewing existing conversation) */
     conversationId?: string;
     /** Additional class name for the container */

package/dist/shared/{stack.sba323Ml.d.ts → stack.9BAOaSqE.d.mts}

@@ -22,6 +22,7 @@ interface AiChatLocalization {
     SIDEBAR_SEARCH_PLACEHOLDER: string;
     CONVERSATION_RENAME: string;
     CONVERSATION_RENAME_PLACEHOLDER: string;
+    CONVERSATION_RENAME_DESCRIPTION: string;
     CONVERSATION_RENAME_SAVE: string;
     CONVERSATION_RENAME_CANCEL: string;
     CONVERSATION_DELETE: string;
@@ -29,6 +30,11 @@ interface AiChatLocalization {
     CONVERSATION_DELETE_CONFIRM_DESCRIPTION: string;
     CONVERSATION_DELETE_CONFIRM_BUTTON: string;
     CONVERSATION_DELETE_CANCEL: string;
+    CONVERSATION_RENAME_SUCCESS: string;
+    CONVERSATION_RENAME_FAILURE: string;
+    CONVERSATION_DELETE_SUCCESS: string;
+    CONVERSATION_DELETE_FAILURE: string;
+    CONVERSATION_TITLE_REQUIRED: string;
     IMAGE_UPLOAD_BUTTON: string;
     IMAGE_UPLOAD_UPLOADING: string;
     IMAGE_UPLOAD_ERROR_NOT_IMAGE: string;
@@ -39,6 +45,10 @@ interface AiChatLocalization {
     FILE_UPLOAD_ERROR_TOO_LARGE: string;
     FILE_UPLOAD_SUCCESS: string;
     FILE_UPLOAD_FAILURE: string;
+    FILE_REMOVE: string;
+    FILE_FALLBACK_NAME: string;
+    IMAGE_ATTACHED_ALT: string;
+    IMAGE_GENERATED_ALT: string;
     TIME_JUST_NOW: string;
     TIME_MINUTES_AGO: string;
     TIME_HOURS_AGO: string;
@@ -54,6 +64,24 @@ interface AiChatLocalization {
     A11Y_ASSISTANT_MESSAGE: string;
     A11Y_COPY_CODE: string;
     A11Y_CODE_COPIED: string;
+    A11Y_CONVERSATION_ACTIONS: string;
+    A11Y_CHAT_TITLE: string;
+    A11Y_CLEAR_CHAT: string;
+    A11Y_CLOSE_CHAT: string;
+    A11Y_OPEN_CHAT: string;
+    A11Y_OPEN_MENU: string;
+    A11Y_CLOSE_SIDEBAR: string;
+    A11Y_OPEN_SIDEBAR: string;
+    TOOL_STATUS_RUNNING: string;
+    TOOL_STATUS_EXECUTING: string;
+    TOOL_STATUS_ERROR: string;
+    TOOL_STATUS_COMPLETE: string;
+    TOOL_STATUS_PENDING: string;
+    TOOL_INPUT: string;
+    TOOL_OUTPUT: string;
+    TOOL_ID: string;
+    TOOL_EXECUTION_FAILED: string;
+    TOOL_HANDLER_MISSING: string;
 }
 
 /**
@@ -115,8 +143,8 @@ interface RouteContext {
 /**
  * Overridable components and functions for the AI Chat plugin
  *
- * External consumers can provide their own implementations of these
- * to customize the behavior for their framework (Next.js, React Router, etc.)
+ * External consumers can provide their own implementations to customize
+ * plugin-specific components and behavior.
  */
 interface AiChatPluginOverrides {
     /**
@@ -124,30 +152,6 @@ interface AiChatPluginOverrides {
      * @default 'authenticated'
      */
     mode?: AiChatMode;
-    /**
-     * API base URL
-     */
-    apiBaseURL: string;
-    /**
-     * API base path
-     */
-    apiBasePath: string;
-    /**
-     * Navigation function for programmatic navigation
-     */
-    navigate: (path: string) => void | Promise<void>;
-    /**
-     * Refresh function to invalidate server-side cache (e.g., Next.js router.refresh())
-     */
-    refresh?: () => void | Promise<void>;
-    /**
-     * Link component for navigation
-     */
-    Link?: ComponentType<React.ComponentProps<"a"> & Record<string, any>>;
-    /**
-     * Image component for displaying images
-     */
-    Image?: ComponentType<React.ImgHTMLAttributes<HTMLImageElement> & Record<string, any>>;
     /**
      * Function used to upload a file and return its URL.
      * Called for images, PDFs, text files, and other supported file types.
@@ -217,19 +221,6 @@ interface AiChatPluginOverrides {
      * @param context - Route context
      */
     onRouteError?: (routeName: string, error: Error, context: RouteContext) => void | Promise<void>;
-    /**
-     * Called before the chat page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param context - Route context
-     */
-    onBeforeChatPageRendered?: (context: RouteContext) => boolean;
-    /**
-     * Called before a conversation page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param id - The conversation ID
-     * @param context - Route context
-     */
-    onBeforeConversationPageRendered?: (id: string, context: RouteContext) => boolean;
 }
 
 interface ChatInterfaceProps {
@@ -245,10 +236,6 @@ interface ChatInterfaceProps {
 declare function ChatInterface({ apiPath, initialMessages, id, variant, className, onMessagesChange, }: ChatInterfaceProps): react_jsx_runtime.JSX.Element;
 
 interface ChatLayoutBaseProps {
-    /** API base URL */
-    apiBaseURL: string;
-    /** API base path */
-    apiBasePath: string;
     /** Current conversation ID (if viewing existing conversation) */
     conversationId?: string;
     /** Additional class name for the container */