@btst/stack 2.12.2 → 3.0.0-rc.1

package/dist/plugins/media/api/index.d.mts

@@ -1,5 +1,4 @@
-export { C as CreateAssetInput, e as CreateFolderInput, M as MEDIA_QUERY_KEYS, g as MediaApiContext, j as MediaApiRouter, i as MediaBackendConfig, h as MediaBackendHooks, U as UpdateAssetInput, f as assetListDiscriminator, c as createAsset, a as createFolder, d as deleteAsset, b as deleteFolder, m as mediaBackendPlugin, u as updateAsset } from '../../../shared/stack.zpwVhSJb.mjs';
-export { A as AssetListParams, d as AssetListResult, F as FolderListParams, g as getAssetById, b as getFolderById, c as getFolderByName, l as listAssets, a as listFolders } from '../../../shared/stack.C7u9lq9T.mjs';
+export { A as AssetListParams, d as AssetListResult, C as CreateAssetInput, j as CreateFolderInput, F as FolderListParams, M as MEDIA_QUERY_KEYS, n as MediaApiContext, r as MediaApiRouter, p as MediaBackendConfig, o as MediaBackendHooks, U as UpdateAssetInput, k as assetListDiscriminator, e as createAsset, h as createFolder, f as deleteAsset, i as deleteFolder, m as folderListDiscriminator, g as getAssetById, b as getFolderById, c as getFolderByName, l as listAssets, a as listFolders, q as mediaBackendPlugin, u as updateAsset } from '../../../shared/stack.DQq8DEIv.mjs';
 import { A as Asset, S as SerializedAsset, F as Folder, a as SerializedFolder } from '../../../shared/stack.BMlLOMED.mjs';
 export { D as DirectStorageAdapter, a as S3StorageAdapter, b as S3UploadToken, S as StorageAdapter, U as UploadOptions, c as VercelBlobHandlerCallbacks, V as VercelBlobStorageAdapter } from '../../../shared/stack.lkebw2nj.mjs';
 import '@btst/stack/plugins/api';

package/dist/plugins/media/api/index.d.ts

@@ -1,5 +1,4 @@
-export { C as CreateAssetInput, e as CreateFolderInput, M as MEDIA_QUERY_KEYS, g as MediaApiContext, j as MediaApiRouter, i as MediaBackendConfig, h as MediaBackendHooks, U as UpdateAssetInput, f as assetListDiscriminator, c as createAsset, a as createFolder, d as deleteAsset, b as deleteFolder, m as mediaBackendPlugin, u as updateAsset } from '../../../shared/stack.COetIi--.js';
-export { A as AssetListParams, d as AssetListResult, F as FolderListParams, g as getAssetById, b as getFolderById, c as getFolderByName, l as listAssets, a as listFolders } from '../../../shared/stack.DD-ZORI7.js';
+export { A as AssetListParams, d as AssetListResult, C as CreateAssetInput, j as CreateFolderInput, F as FolderListParams, M as MEDIA_QUERY_KEYS, n as MediaApiContext, r as MediaApiRouter, p as MediaBackendConfig, o as MediaBackendHooks, U as UpdateAssetInput, k as assetListDiscriminator, e as createAsset, h as createFolder, f as deleteAsset, i as deleteFolder, m as folderListDiscriminator, g as getAssetById, b as getFolderById, c as getFolderByName, l as listAssets, a as listFolders, q as mediaBackendPlugin, u as updateAsset } from '../../../shared/stack.C8SwdUz8.js';
 import { A as Asset, S as SerializedAsset, F as Folder, a as SerializedFolder } from '../../../shared/stack.BMlLOMED.js';
 export { D as DirectStorageAdapter, a as S3StorageAdapter, b as S3UploadToken, S as StorageAdapter, U as UploadOptions, c as VercelBlobHandlerCallbacks, V as VercelBlobStorageAdapter } from '../../../shared/stack.lkebw2nj.js';
 import '@btst/stack/plugins/api';

package/dist/plugins/media/api/index.mjs

@@ -2,4 +2,4 @@ export { mediaBackendPlugin } from '../../../packages/stack/src/plugins/media/ap
 export { getAssetById, getFolderById, getFolderByName, listAssets, listFolders } from '../../../packages/stack/src/plugins/media/api/getters.mjs';
 export { createAsset, createFolder, deleteAsset, deleteFolder, updateAsset } from '../../../packages/stack/src/plugins/media/api/mutations.mjs';
 export { serializeAsset, serializeFolder } from '../../../packages/stack/src/plugins/media/api/serializers.mjs';
-export { MEDIA_QUERY_KEYS, assetListDiscriminator } from '../../../packages/stack/src/plugins/media/api/query-key-defs.mjs';
+export { MEDIA_QUERY_KEYS, assetListDiscriminator, folderListDiscriminator } from '../../../packages/stack/src/plugins/media/api/query-key-defs.mjs';

package/dist/plugins/media/client/components/index.d.cts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { S as SerializedAsset } from '../../../../shared/stack.BMlLOMED.cjs';
+export { L as LibraryPageComponent } from '../../../../shared/stack.Dg_m1SkT.cjs';
 
 interface MediaPickerProps {
     /**
@@ -24,8 +25,7 @@ interface MediaPickerProps {
 /**
  * MediaPicker — a Popover-based media browser.
  *
- * Reads API config from the `media` plugin overrides context (set up in StackProvider).
- * Must be rendered inside a `StackProvider` that includes media overrides.
+ * Reads API and router config from `StackProvider`.
  *
  * @example
  * ```tsx
@@ -49,7 +49,5 @@ declare function ImageInputField({ value, onChange, }: {
     onChange: (v: string) => void;
 }): react_jsx_runtime.JSX.Element;
 
-declare function LibraryPageComponent(): react_jsx_runtime.JSX.Element;
-
-export { ImageInputField, LibraryPageComponent, MediaPicker };
+export { ImageInputField, MediaPicker };
 export type { MediaPickerProps };

package/dist/plugins/media/client/components/index.d.mts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { S as SerializedAsset } from '../../../../shared/stack.BMlLOMED.mjs';
+export { L as LibraryPageComponent } from '../../../../shared/stack.Dg_m1SkT.mjs';
 
 interface MediaPickerProps {
     /**
@@ -24,8 +25,7 @@ interface MediaPickerProps {
 /**
  * MediaPicker — a Popover-based media browser.
  *
- * Reads API config from the `media` plugin overrides context (set up in StackProvider).
- * Must be rendered inside a `StackProvider` that includes media overrides.
+ * Reads API and router config from `StackProvider`.
  *
  * @example
  * ```tsx
@@ -49,7 +49,5 @@ declare function ImageInputField({ value, onChange, }: {
     onChange: (v: string) => void;
 }): react_jsx_runtime.JSX.Element;
 
-declare function LibraryPageComponent(): react_jsx_runtime.JSX.Element;
-
-export { ImageInputField, LibraryPageComponent, MediaPicker };
+export { ImageInputField, MediaPicker };
 export type { MediaPickerProps };

package/dist/plugins/media/client/components/index.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { S as SerializedAsset } from '../../../../shared/stack.BMlLOMED.js';
+export { L as LibraryPageComponent } from '../../../../shared/stack.Dg_m1SkT.js';
 
 interface MediaPickerProps {
     /**
@@ -24,8 +25,7 @@ interface MediaPickerProps {
 /**
  * MediaPicker — a Popover-based media browser.
  *
- * Reads API config from the `media` plugin overrides context (set up in StackProvider).
- * Must be rendered inside a `StackProvider` that includes media overrides.
+ * Reads API and router config from `StackProvider`.
  *
  * @example
  * ```tsx
@@ -49,7 +49,5 @@ declare function ImageInputField({ value, onChange, }: {
     onChange: (v: string) => void;
 }): react_jsx_runtime.JSX.Element;
 
-declare function LibraryPageComponent(): react_jsx_runtime.JSX.Element;
-
-export { ImageInputField, LibraryPageComponent, MediaPicker };
+export { ImageInputField, MediaPicker };
 export type { MediaPickerProps };

package/dist/plugins/media/client/hooks/index.cjs

@@ -6,8 +6,10 @@ const useMedia = require('../../../../packages/stack/src/plugins/media/client/ho
 
 exports.useAssets = useMedia.useAssets;
 exports.useCreateFolder = useMedia.useCreateFolder;
+exports.useCreateFolderForm = useMedia.useCreateFolderForm;
 exports.useDeleteAsset = useMedia.useDeleteAsset;
 exports.useDeleteFolder = useMedia.useDeleteFolder;
 exports.useFolders = useMedia.useFolders;
 exports.useRegisterAsset = useMedia.useRegisterAsset;
+exports.useRegisterAssetForm = useMedia.useRegisterAssetForm;
 exports.useUploadAsset = useMedia.useUploadAsset;

package/dist/plugins/media/client/hooks/index.d.cts

@@ -1,53 +1,62 @@
+import { RegisterAssetInput, CreateMediaFolderInput } from '../../query-keys.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { A as AssetListParams } from '../../../../shared/stack.jU2iG86n.cjs';
+import { ResourceFormResult } from '@btst/stack/plugins/client/hooks';
+import { A as AssetListParams } from '../../../../shared/stack.C5Y5lViI.cjs';
 import { S as SerializedAsset, a as SerializedFolder } from '../../../../shared/stack.BMlLOMED.cjs';
+import '@btst/stack/plugins/client';
+import '@btst/stack/plugins/api';
+import '../../../../shared/stack.lkebw2nj.cjs';
+import 'better-call';
+import 'zod';
 import '@btst/db';
 
-/**
- * Infinite-scroll list of assets, optionally filtered by folder / MIME type / search.
- */
+/** Infinite-scroll list of assets, optionally filtered by folder, MIME type, or search. */
 declare function useAssets(params?: AssetListParams): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<{
     items: SerializedAsset[];
     total: number;
     limit?: number;
     offset?: number;
-}, unknown>, Error>;
-/**
- * List of folders, optionally filtered by parentId.
- * Pass `null` for root-level folders, `undefined` for all folders.
- */
+}, number>, Error>;
+/** Pass `null` for root-level folders and `undefined` for all folders. */
 declare function useFolders(parentId?: string | null): _tanstack_react_query.UseQueryResult<SerializedFolder[], Error>;
 /**
- * Upload an asset — adapter-aware. Handles direct, S3, and Vercel Blob flows.
+ * Upload an asset through the configured direct, S3, or Vercel Blob transport.
+ * This remains custom because the resource factory models JSON requests only.
  */
 declare function useUploadAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, {
     file: File;
     folderId?: string;
 }, unknown>;
-/**
- * Register an asset URL directly (for when the URL already exists).
- */
-declare function useRegisterAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, {
+/** Register an already-hosted asset URL. */
+declare function useRegisterAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, RegisterAssetInput>;
+/** Delete an asset by ID. */
+declare function useDeleteAsset(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, string>;
+/** Create a new folder. */
+declare function useCreateFolder(): _tanstack_react_query.UseMutationResult<SerializedFolder, Error, CreateMediaFolderInput>;
+/** Delete a folder by ID. */
+declare function useDeleteFolder(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, string>;
+interface RegisterAssetFormValues {
     url: string;
-    filename: string;
-    mimeType?: string;
-    size?: number;
+}
+interface UseRegisterAssetFormOptions {
     folderId?: string;
-}, unknown>;
-/**
- * Delete an asset by ID.
- */
-declare function useDeleteAsset(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
-/**
- * Create a new folder.
- */
-declare function useCreateFolder(): _tanstack_react_query.UseMutationResult<SerializedFolder, Error, {
+    onSuccess?: (asset: SerializedAsset) => void | Promise<void>;
+}
+/** Form lifecycle for registering a hosted asset URL. */
+declare function useRegisterAssetForm(options?: UseRegisterAssetFormOptions): ResourceFormResult<RegisterAssetFormValues, null, SerializedAsset>;
+interface CreateFolderFormValues {
     name: string;
+}
+interface UseCreateFolderFormOptions {
     parentId?: string;
-}, unknown>;
-/**
- * Delete a folder by ID.
- */
-declare function useDeleteFolder(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+    onSuccess?: (folder: SerializedFolder) => void | Promise<void>;
+}
+/** Form lifecycle for creating a media folder. */
+declare function useCreateFolderForm(options?: UseCreateFolderFormOptions): ResourceFormResult<CreateFolderFormValues, null, SerializedFolder>;
 
-export { useAssets, useCreateFolder, useDeleteAsset, useDeleteFolder, useFolders, useRegisterAsset, useUploadAsset };
+export { useAssets, useCreateFolder, useCreateFolderForm, useDeleteAsset, useDeleteFolder, useFolders, useRegisterAsset, useRegisterAssetForm, useUploadAsset };
+export type { CreateFolderFormValues, RegisterAssetFormValues, UseCreateFolderFormOptions, UseRegisterAssetFormOptions };

package/dist/plugins/media/client/hooks/index.d.mts

@@ -1,53 +1,62 @@
+import { RegisterAssetInput, CreateMediaFolderInput } from '../../query-keys.mjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { A as AssetListParams } from '../../../../shared/stack.C7u9lq9T.mjs';
+import { ResourceFormResult } from '@btst/stack/plugins/client/hooks';
+import { A as AssetListParams } from '../../../../shared/stack.DQq8DEIv.mjs';
 import { S as SerializedAsset, a as SerializedFolder } from '../../../../shared/stack.BMlLOMED.mjs';
+import '@btst/stack/plugins/client';
+import '@btst/stack/plugins/api';
+import '../../../../shared/stack.lkebw2nj.mjs';
+import 'better-call';
+import 'zod';
 import '@btst/db';
 
-/**
- * Infinite-scroll list of assets, optionally filtered by folder / MIME type / search.
- */
+/** Infinite-scroll list of assets, optionally filtered by folder, MIME type, or search. */
 declare function useAssets(params?: AssetListParams): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<{
     items: SerializedAsset[];
     total: number;
     limit?: number;
     offset?: number;
-}, unknown>, Error>;
-/**
- * List of folders, optionally filtered by parentId.
- * Pass `null` for root-level folders, `undefined` for all folders.
- */
+}, number>, Error>;
+/** Pass `null` for root-level folders and `undefined` for all folders. */
 declare function useFolders(parentId?: string | null): _tanstack_react_query.UseQueryResult<SerializedFolder[], Error>;
 /**
- * Upload an asset — adapter-aware. Handles direct, S3, and Vercel Blob flows.
+ * Upload an asset through the configured direct, S3, or Vercel Blob transport.
+ * This remains custom because the resource factory models JSON requests only.
  */
 declare function useUploadAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, {
     file: File;
     folderId?: string;
 }, unknown>;
-/**
- * Register an asset URL directly (for when the URL already exists).
- */
-declare function useRegisterAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, {
+/** Register an already-hosted asset URL. */
+declare function useRegisterAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, RegisterAssetInput>;
+/** Delete an asset by ID. */
+declare function useDeleteAsset(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, string>;
+/** Create a new folder. */
+declare function useCreateFolder(): _tanstack_react_query.UseMutationResult<SerializedFolder, Error, CreateMediaFolderInput>;
+/** Delete a folder by ID. */
+declare function useDeleteFolder(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, string>;
+interface RegisterAssetFormValues {
     url: string;
-    filename: string;
-    mimeType?: string;
-    size?: number;
+}
+interface UseRegisterAssetFormOptions {
     folderId?: string;
-}, unknown>;
-/**
- * Delete an asset by ID.
- */
-declare function useDeleteAsset(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
-/**
- * Create a new folder.
- */
-declare function useCreateFolder(): _tanstack_react_query.UseMutationResult<SerializedFolder, Error, {
+    onSuccess?: (asset: SerializedAsset) => void | Promise<void>;
+}
+/** Form lifecycle for registering a hosted asset URL. */
+declare function useRegisterAssetForm(options?: UseRegisterAssetFormOptions): ResourceFormResult<RegisterAssetFormValues, null, SerializedAsset>;
+interface CreateFolderFormValues {
     name: string;
+}
+interface UseCreateFolderFormOptions {
     parentId?: string;
-}, unknown>;
-/**
- * Delete a folder by ID.
- */
-declare function useDeleteFolder(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+    onSuccess?: (folder: SerializedFolder) => void | Promise<void>;
+}
+/** Form lifecycle for creating a media folder. */
+declare function useCreateFolderForm(options?: UseCreateFolderFormOptions): ResourceFormResult<CreateFolderFormValues, null, SerializedFolder>;
 
-export { useAssets, useCreateFolder, useDeleteAsset, useDeleteFolder, useFolders, useRegisterAsset, useUploadAsset };
+export { useAssets, useCreateFolder, useCreateFolderForm, useDeleteAsset, useDeleteFolder, useFolders, useRegisterAsset, useRegisterAssetForm, useUploadAsset };
+export type { CreateFolderFormValues, RegisterAssetFormValues, UseCreateFolderFormOptions, UseRegisterAssetFormOptions };

package/dist/plugins/media/client/hooks/index.d.ts

@@ -1,53 +1,62 @@
+import { RegisterAssetInput, CreateMediaFolderInput } from '../../query-keys.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { A as AssetListParams } from '../../../../shared/stack.DD-ZORI7.js';
+import { ResourceFormResult } from '@btst/stack/plugins/client/hooks';
+import { A as AssetListParams } from '../../../../shared/stack.C8SwdUz8.js';
 import { S as SerializedAsset, a as SerializedFolder } from '../../../../shared/stack.BMlLOMED.js';
+import '@btst/stack/plugins/client';
+import '@btst/stack/plugins/api';
+import '../../../../shared/stack.lkebw2nj.js';
+import 'better-call';
+import 'zod';
 import '@btst/db';
 
-/**
- * Infinite-scroll list of assets, optionally filtered by folder / MIME type / search.
- */
+/** Infinite-scroll list of assets, optionally filtered by folder, MIME type, or search. */
 declare function useAssets(params?: AssetListParams): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<{
     items: SerializedAsset[];
     total: number;
     limit?: number;
     offset?: number;
-}, unknown>, Error>;
-/**
- * List of folders, optionally filtered by parentId.
- * Pass `null` for root-level folders, `undefined` for all folders.
- */
+}, number>, Error>;
+/** Pass `null` for root-level folders and `undefined` for all folders. */
 declare function useFolders(parentId?: string | null): _tanstack_react_query.UseQueryResult<SerializedFolder[], Error>;
 /**
- * Upload an asset — adapter-aware. Handles direct, S3, and Vercel Blob flows.
+ * Upload an asset through the configured direct, S3, or Vercel Blob transport.
+ * This remains custom because the resource factory models JSON requests only.
  */
 declare function useUploadAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, {
     file: File;
     folderId?: string;
 }, unknown>;
-/**
- * Register an asset URL directly (for when the URL already exists).
- */
-declare function useRegisterAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, {
+/** Register an already-hosted asset URL. */
+declare function useRegisterAsset(): _tanstack_react_query.UseMutationResult<SerializedAsset, Error, RegisterAssetInput>;
+/** Delete an asset by ID. */
+declare function useDeleteAsset(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, string>;
+/** Create a new folder. */
+declare function useCreateFolder(): _tanstack_react_query.UseMutationResult<SerializedFolder, Error, CreateMediaFolderInput>;
+/** Delete a folder by ID. */
+declare function useDeleteFolder(): _tanstack_react_query.UseMutationResult<{
+    success: boolean;
+}, Error, string>;
+interface RegisterAssetFormValues {
     url: string;
-    filename: string;
-    mimeType?: string;
-    size?: number;
+}
+interface UseRegisterAssetFormOptions {
     folderId?: string;
-}, unknown>;
-/**
- * Delete an asset by ID.
- */
-declare function useDeleteAsset(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
-/**
- * Create a new folder.
- */
-declare function useCreateFolder(): _tanstack_react_query.UseMutationResult<SerializedFolder, Error, {
+    onSuccess?: (asset: SerializedAsset) => void | Promise<void>;
+}
+/** Form lifecycle for registering a hosted asset URL. */
+declare function useRegisterAssetForm(options?: UseRegisterAssetFormOptions): ResourceFormResult<RegisterAssetFormValues, null, SerializedAsset>;
+interface CreateFolderFormValues {
     name: string;
+}
+interface UseCreateFolderFormOptions {
     parentId?: string;
-}, unknown>;
-/**
- * Delete a folder by ID.
- */
-declare function useDeleteFolder(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+    onSuccess?: (folder: SerializedFolder) => void | Promise<void>;
+}
+/** Form lifecycle for creating a media folder. */
+declare function useCreateFolderForm(options?: UseCreateFolderFormOptions): ResourceFormResult<CreateFolderFormValues, null, SerializedFolder>;
 
-export { useAssets, useCreateFolder, useDeleteAsset, useDeleteFolder, useFolders, useRegisterAsset, useUploadAsset };
+export { useAssets, useCreateFolder, useCreateFolderForm, useDeleteAsset, useDeleteFolder, useFolders, useRegisterAsset, useRegisterAssetForm, useUploadAsset };
+export type { CreateFolderFormValues, RegisterAssetFormValues, UseCreateFolderFormOptions, UseRegisterAssetFormOptions };

package/dist/plugins/media/client/hooks/index.mjs

@@ -1 +1 @@
-export { useAssets, useCreateFolder, useDeleteAsset, useDeleteFolder, useFolders, useRegisterAsset, useUploadAsset } from '../../../../packages/stack/src/plugins/media/client/hooks/use-media.mjs';
+export { useAssets, useCreateFolder, useCreateFolderForm, useDeleteAsset, useDeleteFolder, useFolders, useRegisterAsset, useRegisterAssetForm, useUploadAsset } from '../../../../packages/stack/src/plugins/media/client/hooks/use-media.mjs';

package/dist/plugins/media/client/index.d.cts

@@ -2,7 +2,9 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
+import { L as LibraryPageComponent } from '../../../shared/stack.Dg_m1SkT.cjs';
 import { S as SerializedAsset } from '../../../shared/stack.BMlLOMED.cjs';
+import 'react/jsx-runtime';
 
 interface MediaLoaderContext {
     path: string;
@@ -64,34 +66,26 @@ interface MediaClientConfig {
  * ```
  */
 declare const mediaClientPlugin: (config: MediaClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
-    library: {
-        (inputCtx_0?: _btst_yar.InputContext<"/media", _btst_yar.RouteOptions> | undefined): {
-            PageComponent?: ComponentType<{}> | undefined;
-            LoadingComponent?: ComponentType<{}> | undefined;
-            ErrorComponent?: ComponentType<{}> | undefined;
-            loader?: (() => Promise<void>) | undefined;
-            meta?: (() => ({
-                title: string;
-                name?: undefined;
-                content?: undefined;
-                property?: undefined;
-            } | {
-                name: string;
-                content: string;
-                title?: undefined;
-                property?: undefined;
-            } | {
-                property: string;
-                content: string;
-                title?: undefined;
-                name?: undefined;
-            })[]) | undefined;
-            extra?: (() => any) | undefined;
-        };
-        options: _btst_yar.RouteOptions | undefined;
-        path: "/media";
-        meta: _btst_yar.RouteMeta | undefined;
-    };
+    library: _btst_yar.DefinedRoute<"/media", {
+        readonly page: typeof LibraryPageComponent;
+        readonly loader: () => Promise<void>;
+        readonly meta: () => ({
+            title: string;
+            name?: undefined;
+            content?: undefined;
+            property?: undefined;
+        } | {
+            name: string;
+            content: string;
+            title?: undefined;
+            property?: undefined;
+        } | {
+            property: string;
+            content: string;
+            title?: undefined;
+            name?: undefined;
+        })[];
+    }, _btst_yar.RouteMeta>;
 }>;
 
 /**
@@ -138,14 +132,6 @@ type MediaUploadMode = "direct" | "s3" | "vercel-blob";
  * via the StackProvider overrides.
  */
 interface MediaPluginOverrides {
-    /**
-     * Base URL for API calls (e.g., "http://localhost:3000").
-     */
-    apiBaseURL: string;
-    /**
-     * Path where the API is mounted (e.g., "/api/data").
-     */
-    apiBasePath: string;
     /**
      * React Query client — used by the MediaPicker to cache and fetch assets.
      */
@@ -159,27 +145,6 @@ interface MediaPluginOverrides {
      * Optional headers to pass with API requests (e.g., for SSR auth).
      */
     headers?: HeadersInit;
-    /**
-     * Navigation function for programmatic navigation.
-     */
-    navigate: (path: string) => void | Promise<void>;
-    /**
-     * Link component for navigation within the media library page.
-     */
-    Link?: ComponentType<React.ComponentProps<"a"> & Record<string, any>>;
-    /**
-     * Image component for rendering asset thumbnails and previews.
-     *
-     * When provided, replaces the default `<img>` element in asset cards,
-     * the media library grid, and the ImageInputField preview. Use this
-     * to plug in Next.js `<Image>` for automatic optimisation.
-     *
-     * @example
-     * ```tsx
-     * Image: (props) => <NextImage {...props} />
-     * ```
-     */
-    Image?: ComponentType<React.ImgHTMLAttributes<HTMLImageElement> & Record<string, any>>;
     /**
      * Client-side image compression applied before upload via the Canvas API.
      *
@@ -200,19 +165,6 @@ interface MediaPluginOverrides {
      * Called when a media route encounters an error.
      */
     onRouteError?: (routeName: string, error: Error, context: MediaRouteContext) => void | Promise<void>;
-    /**
-     * Called before the media library page is rendered.
-     * Return `false` to prevent rendering (e.g., redirect unauthenticated users).
-     *
-     * @example
-     * ```ts
-     * media: {
-     *   onBeforeLibraryPageRendered: (context) => !!currentUser?.isAdmin,
-     *   onRouteError: (routeName, error, context) => navigate("/login"),
-     * }
-     * ```
-     */
-    onBeforeLibraryPageRendered?: (context: MediaRouteContext) => boolean;
 }
 interface MediaRouteContext {
     /** Current route path */
@@ -224,7 +176,13 @@ interface MediaRouteContext {
     [key: string]: unknown;
 }
 
-type MediaUploadClientConfig = Pick<MediaPluginOverrides, "apiBaseURL" | "apiBasePath" | "headers" | "uploadMode" | "imageCompression">;
+interface MediaUploadClientConfig {
+    apiBaseURL: string;
+    apiBasePath: string;
+    headers?: HeadersInit;
+    uploadMode?: MediaUploadMode;
+    imageCompression?: ImageCompressionOptions | false;
+}
 interface UploadAssetInput {
     file: File;
     folderId?: string;