@questpie/admin 3.5.2 → 3.5.4

package/dist/factories.mjs

@@ -1,6 +1,6 @@
 import { adminConfig } from "./server/augmentation/index.mjs";
 import { component, editView, filterViewsByKind, listView, view } from "./server/registry-helpers.mjs";
-import { createActionCallbackProxy, createActionProxy, createComponentCallbackProxy, createComponentProxy, createDashboardCallbackContext, createDashboardContributionProxy, createFieldProxy, createSidebarCallbackContext, createSidebarContributionProxy, createViewCallbackProxy, createViewProxy, resolveDashboardCallback, resolveSidebarCallback } from "./server/proxy-factories.mjs";
+import { createActionCallbackProxy, createActionFieldBuilderProxy, createActionProxy, createComponentCallbackProxy, createComponentProxy, createDashboardCallbackContext, createDashboardContributionProxy, createFieldProxy, createSidebarCallbackContext, createSidebarContributionProxy, createViewCallbackProxy, createViewProxy, resolveDashboardCallback, resolveSidebarCallback } from "./server/proxy-factories.mjs";
 import { createBlocksPrefetchHook, processBlocksDocument, processDocumentBlocksPrefetch } from "./server/modules/admin/block/prefetch.mjs";
 import { BlockBuilder, block } from "./server/modules/admin/block/block-builder.mjs";
 import { getBlocksByCategory, introspectBlock, introspectBlocks } from "./server/modules/admin/block/introspection.mjs";
@@ -8,4 +8,4 @@ import { getAdminSession, isAdminUser, requireAdminAuth } from "./server/modules
 import { createNextAuthMiddleware, getNextAdminSession } from "./server/adapters/nextjs.mjs";
 import { createTanStackAuthGuard, createTanStackSessionLoader } from "./server/adapters/tanstack.mjs";
 
-export { BlockBuilder, adminConfig, block, component, createActionCallbackProxy, createActionProxy, createBlocksPrefetchHook, createComponentCallbackProxy, createComponentProxy, createDashboardCallbackContext, createDashboardContributionProxy, createFieldProxy, createNextAuthMiddleware, createSidebarCallbackContext, createSidebarContributionProxy, createTanStackAuthGuard, createTanStackSessionLoader, createViewCallbackProxy, createViewProxy, editView, filterViewsByKind, getAdminSession, getBlocksByCategory, getNextAdminSession, introspectBlock, introspectBlocks, isAdminUser, listView, processBlocksDocument, processDocumentBlocksPrefetch, requireAdminAuth, resolveDashboardCallback, resolveSidebarCallback, view };
+export { BlockBuilder, adminConfig, block, component, createActionCallbackProxy, createActionFieldBuilderProxy, createActionProxy, createBlocksPrefetchHook, createComponentCallbackProxy, createComponentProxy, createDashboardCallbackContext, createDashboardContributionProxy, createFieldProxy, createNextAuthMiddleware, createSidebarCallbackContext, createSidebarContributionProxy, createTanStackAuthGuard, createTanStackSessionLoader, createViewCallbackProxy, createViewProxy, editView, filterViewsByKind, getAdminSession, getBlocksByCategory, getNextAdminSession, introspectBlock, introspectBlocks, isAdminUser, listView, processBlocksDocument, processDocumentBlocksPrefetch, requireAdminAuth, resolveDashboardCallback, resolveSidebarCallback, view };

package/dist/index.d.mts

@@ -10,13 +10,26 @@ import { Admin, AppAdmin, InferAdminCMS } from "./client/builder/admin.mjs";
 import { createAdminClient } from "./client/create-admin-client.mjs";
 import { TypedHooks, createTypedHooks } from "./client/hooks/typed-hooks.mjs";
 import { createAdminAuthClient, useAuthClient } from "./client/hooks/use-auth.mjs";
-import { ComponentRegistry, FieldComponentProps, FormViewConfig } from "./client/builder/types/field-types.mjs";
+import { ComponentRegistry, DocumentViewConfig, FieldComponentProps, FormViewConfig } from "./client/builder/types/field-types.mjs";
 import { BrandLogoConfig, BrandingConfig } from "./client/types/admin-config.mjs";
 import { AdminProvider, AdminProviderProps, AdminState, AdminStore, selectAdmin, selectBasePath, selectClient, selectNavigate, useAdminStore } from "./client/runtime/provider.mjs";
 import { useShallow } from "./client/runtime/index.mjs";
 import { AdminSidebarBrandProps, AdminSidebarNavItemProps } from "./client/views/layout/admin-sidebar.mjs";
 import { AdminLayout, AdminShellRailProps } from "./client/views/layout/admin-layout.mjs";
 import { AdminLayoutProvider } from "./client/views/layout/admin-layout-provider.mjs";
+import { AdminViewHeader, AdminViewLayout } from "./client/views/layout/admin-view-layout.mjs";
+import { DocumentView } from "./client/views/collection/document-view.mjs";
+import { getFileIcon } from "./client/views/collection/cells/shared/asset-thumbnail.mjs";
+import { SearchInput } from "./client/components/ui/search-input.mjs";
+import { Button } from "./client/components/ui/button.mjs";
+import { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "./client/components/ui/table.mjs";
+import { Tooltip, TooltipContent, TooltipTrigger } from "./client/components/ui/tooltip.mjs";
+import { Dropzone } from "./client/components/primitives/dropzone.mjs";
+import { Sheet, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle } from "./client/components/ui/sheet.mjs";
+import { DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger } from "./client/components/ui/dropdown-menu.mjs";
+import { sanitizeFilename } from "./client/components/fields/field-utils.mjs";
+import { cn } from "./client/lib/utils.mjs";
+import { useResolveText } from "./client/i18n/hooks.mjs";
 import { AdminRouter, AdminRouterProps } from "./client/views/layout/admin-router.mjs";
 import { BlockCategory, BlockContent, BlockNode, BlockRendererProps as BlockRendererProps$1, EMPTY_BLOCK_CONTENT, isBlockContent } from "./client/blocks/types.mjs";
 import { BlockRenderer, BlockRendererProps } from "./client/blocks/block-renderer.mjs";
@@ -45,6 +58,7 @@ import { LoginPage } from "./client/views/pages/login-page.mjs";
 import { ResetPasswordPage } from "./client/views/pages/reset-password-page.mjs";
 import { SetupPage, SetupPageProps } from "./client/views/pages/setup-page.mjs";
 import { useCollectionCreate, useCollectionDelete, useCollectionItem, useCollectionList, useCollectionRestore, useCollectionRevertVersion, useCollectionUpdate, useCollectionVersions } from "./client/hooks/use-collection.mjs";
+import { Asset, useUpload } from "./client/hooks/use-upload.mjs";
 import { useCurrentUser } from "./client/hooks/use-current-user.mjs";
 import { BrandSnapshot, useBrand, useBrandSnapshotRef } from "./client/hooks/use-brand.mjs";
 import { OptionItem, UseFieldOptionsOptions, UseFieldOptionsResult, useFieldOptions } from "./client/hooks/use-field-options.mjs";
@@ -64,5 +78,5 @@ import { FocusContextValue, FocusProvider, FocusProviderProps, FocusState, parse
 import { ScopeContextValue, ScopeOption, ScopePickerProps, ScopeProviderProps } from "./client/scope/types.mjs";
 import { ScopePicker } from "./client/scope/picker.mjs";
 import { ScopeProvider, createScopedFetch, useScope, useScopeSafe, useScopedFetch } from "./client/scope/provider.mjs";
-import { AnyQuestpieClient, CollectionFieldKeys, CollectionItem, CollectionNames, GlobalNames } from "./client.mjs";
-export { AcceptInviteForm, AcceptInvitePage, Admin, AdminLayout, AdminLayoutProvider, AdminLink, AdminProvider, AdminProviderProps, AdminRouter, AdminRouterProps, AdminShellRailProps, AdminSidebarBrandProps, AdminSidebarNavItemProps, AdminState, AdminStore, AdminToPreviewMessage, type AnyAdminMeta, AnyQuestpieClient, AnyWidgetConfig, AppAdmin, type ArrayFieldAdminMeta, AuthDefaultLogo, AuthGuard, AuthLayout, AuthLayoutProps, AuthLoading, Badge, BadgeProps, type BaseAdminMeta, BaseFieldProps, BaseWidgetAdminMeta, BaseWidgetConfig, BlockCategory, BlockClickedMessage, BlockContent, BlockNode, BlockRenderer, BlockRendererProps as BlockRendererComponentProps, BlockRendererProps$1 as BlockRendererProps, BlockScopeContextValue, BlockScopeProvider, BlockScopeProviderProps, type BooleanFieldAdminMeta, BrandLogoConfig, BrandLogoMark, BrandLogoMarkProps, BrandSnapshot, BrandingConfig, ChartWidgetConfig, CollectionFieldKeys, CollectionFormViewProps, CollectionItem, CollectionListViewProps, CollectionNames, CommitMessage, ComponentRegistry, ComponentRenderer, ComponentRendererProps, ComponentRendererRegistry, CustomWidgetConfig, DashboardPage, type DateFieldAdminMeta, EMPTY_BLOCK_CONTENT, FieldClickedMessage, FieldComponentProps, FieldDefinition, FieldInstance, FieldValueEditedMessage, FlagConfig, FocusContextValue, FocusFieldMessage, FocusProvider, FocusProviderProps, FocusState, ForgotPasswordForm, ForgotPasswordPage, FormViewConfig, FormViewDefinition, FullResyncMessage, GlobalFormViewProps, GlobalNames, I18nContext, I18nText, IconComponent, IconifyIcon, IconifyIconProps, InferAdminCMS, InitSnapshotMessage, InvitePage, type JsonFieldAdminMeta, ListViewDefinition, LoginForm, LoginPage, MaybeLazyComponent, type NumberFieldAdminMeta, type ObjectFieldAdminMeta, OptionItem, PageDefinition, PatchAppliedMessage, PatchBatchMessage, PreviewBanner, PreviewBannerProps, PreviewConfig, PreviewField, PreviewFieldProps, PreviewPatchOp, PreviewProvider, PreviewReadyMessage, PreviewRefreshMessage, PreviewToAdminMessage, ProgressWidgetConfig, QuickActionsWidgetConfig, ReactiveFieldResult, ReactiveFieldState, RecentItemsWidgetConfig, RefreshCompleteMessage, type RelationFieldAdminMeta, ResetPasswordForm, ResetPasswordPage, ResyncRequestMessage, RichTextEditor, RichTextEditorProps, RichTextRenderer, RichTextStyles, ScopeContextValue, ScopeOption, ScopePicker, ScopePickerProps, ScopeProvider, ScopeProviderProps, SelectBlockMessage, type SelectFieldAdminMeta, SetupForm, SetupFormValues, SetupPage, SetupPageProps, SetupStatus, StandalonePreviewField, StatsWidgetConfig, TableWidgetConfig, type TextFieldAdminMeta, type TextareaFieldAdminMeta, type TimeFieldAdminMeta, TimelineWidgetConfig, TipTapDoc, TipTapNode, TypedHooks, type UploadFieldAdminMeta, UseCollectionPreviewOptions, UseCollectionPreviewResult, UseFieldOptionsOptions, UseFieldOptionsResult, UseReactiveFieldsOptions, UseReactiveFieldsResult, ValueWidgetConfig, ViewDefinition, ViewKind, WidgetComponentProps, WidgetConfig, WidgetDefinition, WidgetTypeRegistry, buildValidationSchema, buildZodFromIntrospection, configureField, createAdminAuthClient, createAdminClient, createFormSchema, createIconRenderer, createScopedFetch, createTypedHooks, field, getCountryCode, getFlagConfig, getFlagUrl, isAdminToPreviewMessage, isBlockContent, isComponentReference, isPreviewToAdminMessage, page, parsePreviewFieldPath, resolveIconElement, scrollFieldIntoView, selectAdmin, selectBasePath, selectClient, selectNavigate, useAdminStore, useAuthClient, useBlockScope, useBrand, useBrandSnapshotRef, useCollectionCreate, useCollectionDelete, useCollectionItem, useCollectionList, useCollectionPreview, useCollectionRestore, useCollectionRevertVersion, useCollectionUpdate, useCollectionVersions, useCurrentUser, useFieldOptions, useFocus, useFocusOptional, useGlobal, useGlobalRevertVersion, useGlobalUpdate, useGlobalVersions, useIsBlockFocused, useIsDesktop, useIsFieldFocused, useIsMobile, useMediaQuery, usePreviewContext, useReactiveFields, useResolveFieldPath, useScope, useScopeSafe, useScopedFetch, useSearchParamToggle, useServerWidgetData, useSetupStatus, useShallow, useSidebarSearchParam, view, widget };
+import { AnyQuestpieClient, CollectionFieldKeys, CollectionItem, CollectionNames, GlobalNames, toast } from "./client.mjs";
+export { AcceptInviteForm, AcceptInvitePage, Admin, AdminLayout, AdminLayoutProvider, AdminLink, AdminProvider, AdminProviderProps, AdminRouter, AdminRouterProps, AdminShellRailProps, AdminSidebarBrandProps, AdminSidebarNavItemProps, AdminState, AdminStore, AdminToPreviewMessage, AdminViewHeader, AdminViewLayout, type AnyAdminMeta, AnyQuestpieClient, AnyWidgetConfig, AppAdmin, type ArrayFieldAdminMeta, Asset, AuthDefaultLogo, AuthGuard, AuthLayout, AuthLayoutProps, AuthLoading, Badge, BadgeProps, type BaseAdminMeta, BaseFieldProps, BaseWidgetAdminMeta, BaseWidgetConfig, BlockCategory, BlockClickedMessage, BlockContent, BlockNode, BlockRenderer, BlockRendererProps as BlockRendererComponentProps, BlockRendererProps$1 as BlockRendererProps, BlockScopeContextValue, BlockScopeProvider, BlockScopeProviderProps, type BooleanFieldAdminMeta, BrandLogoConfig, BrandLogoMark, BrandLogoMarkProps, BrandSnapshot, BrandingConfig, Button, ChartWidgetConfig, CollectionFieldKeys, CollectionFormViewProps, CollectionItem, CollectionListViewProps, CollectionNames, CommitMessage, ComponentRegistry, ComponentRenderer, ComponentRendererProps, ComponentRendererRegistry, CustomWidgetConfig, DashboardPage, type DateFieldAdminMeta, DocumentView, DocumentViewConfig, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, Dropzone, EMPTY_BLOCK_CONTENT, FieldClickedMessage, FieldComponentProps, FieldDefinition, FieldInstance, FieldValueEditedMessage, FlagConfig, FocusContextValue, FocusFieldMessage, FocusProvider, FocusProviderProps, FocusState, ForgotPasswordForm, ForgotPasswordPage, FormViewConfig, FormViewDefinition, FullResyncMessage, GlobalFormViewProps, GlobalNames, I18nContext, I18nText, IconComponent, IconifyIcon, IconifyIconProps, InferAdminCMS, InitSnapshotMessage, InvitePage, type JsonFieldAdminMeta, ListViewDefinition, LoginForm, LoginPage, MaybeLazyComponent, type NumberFieldAdminMeta, type ObjectFieldAdminMeta, OptionItem, PageDefinition, PatchAppliedMessage, PatchBatchMessage, PreviewBanner, PreviewBannerProps, PreviewConfig, PreviewField, PreviewFieldProps, PreviewPatchOp, PreviewProvider, PreviewReadyMessage, PreviewRefreshMessage, PreviewToAdminMessage, ProgressWidgetConfig, QuickActionsWidgetConfig, ReactiveFieldResult, ReactiveFieldState, RecentItemsWidgetConfig, RefreshCompleteMessage, type RelationFieldAdminMeta, ResetPasswordForm, ResetPasswordPage, ResyncRequestMessage, RichTextEditor, RichTextEditorProps, RichTextRenderer, RichTextStyles, ScopeContextValue, ScopeOption, ScopePicker, ScopePickerProps, ScopeProvider, ScopeProviderProps, SearchInput, SelectBlockMessage, type SelectFieldAdminMeta, SetupForm, SetupFormValues, SetupPage, SetupPageProps, SetupStatus, Sheet, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, StandalonePreviewField, StatsWidgetConfig, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, TableWidgetConfig, type TextFieldAdminMeta, type TextareaFieldAdminMeta, type TimeFieldAdminMeta, TimelineWidgetConfig, TipTapDoc, TipTapNode, Tooltip, TooltipContent, TooltipTrigger, TypedHooks, type UploadFieldAdminMeta, UseCollectionPreviewOptions, UseCollectionPreviewResult, UseFieldOptionsOptions, UseFieldOptionsResult, UseReactiveFieldsOptions, UseReactiveFieldsResult, ValueWidgetConfig, ViewDefinition, ViewKind, WidgetComponentProps, WidgetConfig, WidgetDefinition, WidgetTypeRegistry, buildValidationSchema, buildZodFromIntrospection, cn, configureField, createAdminAuthClient, createAdminClient, createFormSchema, createIconRenderer, createScopedFetch, createTypedHooks, field, getCountryCode, getFileIcon, getFlagConfig, getFlagUrl, isAdminToPreviewMessage, isBlockContent, isComponentReference, isPreviewToAdminMessage, page, parsePreviewFieldPath, resolveIconElement, sanitizeFilename, scrollFieldIntoView, selectAdmin, selectBasePath, selectClient, selectNavigate, toast, useAdminStore, useAuthClient, useBlockScope, useBrand, useBrandSnapshotRef, useCollectionCreate, useCollectionDelete, useCollectionItem, useCollectionList, useCollectionPreview, useCollectionRestore, useCollectionRevertVersion, useCollectionUpdate, useCollectionVersions, useCurrentUser, useFieldOptions, useFocus, useFocusOptional, useGlobal, useGlobalRevertVersion, useGlobalUpdate, useGlobalVersions, useIsBlockFocused, useIsDesktop, useIsFieldFocused, useIsMobile, useMediaQuery, usePreviewContext, useReactiveFields, useResolveFieldPath, useResolveText, useScope, useScopeSafe, useScopedFetch, useSearchParamToggle, useServerWidgetData, useSetupStatus, useShallow, useSidebarSearchParam, useUpload, view, widget };

package/dist/index.mjs

@@ -1,14 +1,23 @@
 import { view } from "./client/builder/view/view.mjs";
 import { Admin } from "./client/builder/admin.mjs";
+import { useResolveText } from "./client/i18n/hooks.mjs";
+import { cn } from "./client/lib/utils.mjs";
 import { AdminProvider, selectAdmin, selectBasePath, selectClient, selectNavigate, useAdminStore } from "./client/runtime/provider.mjs";
 import { useShallow } from "./client/runtime/index.mjs";
 import { Badge, ComponentRenderer, IconifyIcon, createIconRenderer, isComponentReference, resolveIconElement } from "./client/components/component-renderer.mjs";
 import { configureField, field } from "./client/builder/field/field.mjs";
+import { Button } from "./client/components/ui/button.mjs";
 import { getCountryCode, getFlagConfig, getFlagUrl } from "./client/utils/locale-to-flag.mjs";
+import { DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger } from "./client/components/ui/dropdown-menu.mjs";
+import { Sheet, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle } from "./client/components/ui/sheet.mjs";
+import { sanitizeFilename } from "./client/components/fields/field-utils.mjs";
 import { EMPTY_BLOCK_CONTENT, isBlockContent } from "./client/blocks/types.mjs";
+import { Tooltip, TooltipContent, TooltipTrigger } from "./client/components/ui/tooltip.mjs";
+import { getFileIcon } from "./client/views/collection/cells/shared/asset-thumbnail.mjs";
 import { FocusProvider, parsePreviewFieldPath, scrollFieldIntoView, useFocus, useFocusOptional, useIsBlockFocused, useIsFieldFocused } from "./client/contexts/focus-context.mjs";
 import { useIsDesktop, useIsMobile, useMediaQuery } from "./client/hooks/use-media-query.mjs";
 import { buildValidationSchema, buildZodFromIntrospection, createFormSchema } from "./client/builder/validation.mjs";
+import { useReactiveFields } from "./client/hooks/use-reactive-fields.mjs";
 import { isAdminToPreviewMessage, isPreviewToAdminMessage } from "./client/preview/types.mjs";
 import { useGlobal, useGlobalRevertVersion, useGlobalUpdate, useGlobalVersions } from "./client/hooks/use-global.mjs";
 import { useSearchParamToggle } from "./client/hooks/use-search-param-toggle.mjs";
@@ -16,8 +25,11 @@ import { useSidebarSearchParam } from "./client/hooks/use-sidebar-search-param.m
 import { useCollectionCreate, useCollectionDelete, useCollectionItem, useCollectionList, useCollectionRestore, useCollectionRevertVersion, useCollectionUpdate, useCollectionVersions } from "./client/hooks/use-collection.mjs";
 import { createAdminAuthClient, useAuthClient } from "./client/hooks/use-auth.mjs";
 import { useCurrentUser } from "./client/hooks/use-current-user.mjs";
-import { useReactiveFields } from "./client/hooks/use-reactive-fields.mjs";
+import { AdminViewHeader, AdminViewLayout } from "./client/views/layout/admin-view-layout.mjs";
+import { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "./client/components/ui/table.mjs";
 import { AdminLink } from "./client/components/admin-link.mjs";
+import { useUpload } from "./client/hooks/use-upload.mjs";
+import { Dropzone } from "./client/components/primitives/dropzone.mjs";
 import { page } from "./client/builder/page/page.mjs";
 import { widget } from "./client/builder/widget/widget.mjs";
 import { createAdminClient } from "./client/create-admin-client.mjs";
@@ -27,6 +39,8 @@ import { AdminLayout } from "./client/views/layout/admin-layout.mjs";
 import { AuthLoading } from "./client/components/auth/auth-loading.mjs";
 import { AuthGuard } from "./client/components/auth/auth-guard.mjs";
 import { AdminLayoutProvider } from "./client/views/layout/admin-layout-provider.mjs";
+import DocumentView from "./client/views/collection/document-view.mjs";
+import { SearchInput } from "./client/components/ui/search-input.mjs";
 import { AdminRouter } from "./client/views/layout/admin-router.mjs";
 import { BlockScopeProvider, useBlockScope, useResolveFieldPath } from "./client/preview/block-scope-context.mjs";
 import { BlockRenderer } from "./client/blocks/block-renderer.mjs";
@@ -54,5 +68,6 @@ import { useFieldOptions } from "./client/hooks/use-field-options.mjs";
 import { useServerWidgetData } from "./client/hooks/use-server-widget-data.mjs";
 import { ScopeProvider, createScopedFetch, useScope, useScopeSafe, useScopedFetch } from "./client/scope/provider.mjs";
 import { ScopePicker } from "./client/scope/picker.mjs";
+import { toast } from "./client.mjs";
 
-export { AcceptInviteForm, AcceptInvitePage, Admin, AdminLayout, AdminLayoutProvider, AdminLink, AdminProvider, AdminRouter, AuthDefaultLogo, AuthGuard, AuthLayout, AuthLoading, Badge, BlockRenderer, BlockScopeProvider, BrandLogoMark, ComponentRenderer, DashboardPage, EMPTY_BLOCK_CONTENT, FocusProvider, ForgotPasswordForm, ForgotPasswordPage, IconifyIcon, InvitePage, LoginForm, LoginPage, PreviewBanner, PreviewField, PreviewProvider, ResetPasswordForm, ResetPasswordPage, RichTextEditor, RichTextRenderer, ScopePicker, ScopeProvider, SetupForm, SetupPage, StandalonePreviewField, buildValidationSchema, buildZodFromIntrospection, configureField, createAdminAuthClient, createAdminClient, createFormSchema, createIconRenderer, createScopedFetch, createTypedHooks, field, getCountryCode, getFlagConfig, getFlagUrl, isAdminToPreviewMessage, isBlockContent, isComponentReference, isPreviewToAdminMessage, page, parsePreviewFieldPath, resolveIconElement, scrollFieldIntoView, selectAdmin, selectBasePath, selectClient, selectNavigate, useAdminStore, useAuthClient, useBlockScope, useBrand, useBrandSnapshotRef, useCollectionCreate, useCollectionDelete, useCollectionItem, useCollectionList, useCollectionPreview, useCollectionRestore, useCollectionRevertVersion, useCollectionUpdate, useCollectionVersions, useCurrentUser, useFieldOptions, useFocus, useFocusOptional, useGlobal, useGlobalRevertVersion, useGlobalUpdate, useGlobalVersions, useIsBlockFocused, useIsDesktop, useIsFieldFocused, useIsMobile, useMediaQuery, usePreviewContext, useReactiveFields, useResolveFieldPath, useScope, useScopeSafe, useScopedFetch, useSearchParamToggle, useServerWidgetData, useSetupStatus, useShallow, useSidebarSearchParam, view, widget };
+export { AcceptInviteForm, AcceptInvitePage, Admin, AdminLayout, AdminLayoutProvider, AdminLink, AdminProvider, AdminRouter, AdminViewHeader, AdminViewLayout, AuthDefaultLogo, AuthGuard, AuthLayout, AuthLoading, Badge, BlockRenderer, BlockScopeProvider, BrandLogoMark, Button, ComponentRenderer, DashboardPage, DocumentView, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, Dropzone, EMPTY_BLOCK_CONTENT, FocusProvider, ForgotPasswordForm, ForgotPasswordPage, IconifyIcon, InvitePage, LoginForm, LoginPage, PreviewBanner, PreviewField, PreviewProvider, ResetPasswordForm, ResetPasswordPage, RichTextEditor, RichTextRenderer, ScopePicker, ScopeProvider, SearchInput, SetupForm, SetupPage, Sheet, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, StandalonePreviewField, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tooltip, TooltipContent, TooltipTrigger, buildValidationSchema, buildZodFromIntrospection, cn, configureField, createAdminAuthClient, createAdminClient, createFormSchema, createIconRenderer, createScopedFetch, createTypedHooks, field, getCountryCode, getFileIcon, getFlagConfig, getFlagUrl, isAdminToPreviewMessage, isBlockContent, isComponentReference, isPreviewToAdminMessage, page, parsePreviewFieldPath, resolveIconElement, sanitizeFilename, scrollFieldIntoView, selectAdmin, selectBasePath, selectClient, selectNavigate, toast, useAdminStore, useAuthClient, useBlockScope, useBrand, useBrandSnapshotRef, useCollectionCreate, useCollectionDelete, useCollectionItem, useCollectionList, useCollectionPreview, useCollectionRestore, useCollectionRevertVersion, useCollectionUpdate, useCollectionVersions, useCurrentUser, useFieldOptions, useFocus, useFocusOptional, useGlobal, useGlobalRevertVersion, useGlobalUpdate, useGlobalVersions, useIsBlockFocused, useIsDesktop, useIsFieldFocused, useIsMobile, useMediaQuery, usePreviewContext, useReactiveFields, useResolveFieldPath, useResolveText, useScope, useScopeSafe, useScopedFetch, useSearchParamToggle, useServerWidgetData, useSetupStatus, useShallow, useSidebarSearchParam, useUpload, view, widget };

package/dist/modules/admin.d.mts

@@ -1,10 +1,10 @@
+import { FilterOperator, FilterRule, SortConfig, ViewConfiguration } from "../shared/types/saved-views.types.mjs";
 import { ExecuteActionRequest, ExecuteActionResponse, actionFunctions, executeAction, executeActionFn, getActionsConfig, getActionsConfigFn } from "../server/modules/admin/routes/execute-action.mjs";
 import { PreviewTokenPayload, createPreviewFunctions, createPreviewTokenVerifier, verifyPreviewTokenDirect } from "../server/modules/admin/routes/preview.mjs";
 import { batchReactive, fieldOptions, reactiveFunctions } from "../server/modules/admin/routes/reactive.mjs";
 import { createFirstAdmin, isSetupRequired, setupFunctions } from "../server/modules/admin/routes/setup.mjs";
 import { fetchWidgetData, widgetDataFunctions } from "../server/modules/admin/routes/widget-data.mjs";
 import { AdminCollections } from "../server/modules/admin/.generated/module.mjs";
-import { FilterOperator, FilterRule, SortConfig, ViewConfiguration } from "../shared/types/saved-views.types.mjs";
 import { savedViewsCollection } from "../server/modules/admin-preferences/collections/saved-views.mjs";
 import { AdminModule, adminModule, adminRoutes } from "../server/modules/admin/index.mjs";
 export { type AdminCollections, type AdminModule, type ExecuteActionRequest, type ExecuteActionResponse, type FilterOperator, type FilterRule, type PreviewTokenPayload, type SortConfig, type ViewConfiguration, actionFunctions, adminModule, adminRoutes, batchReactive, createFirstAdmin, createPreviewFunctions, createPreviewTokenVerifier, executeAction, executeActionFn, fetchWidgetData, fieldOptions, getActionsConfig, getActionsConfigFn, isSetupRequired, reactiveFunctions, savedViewsCollection, setupFunctions, verifyPreviewTokenDirect, widgetDataFunctions };

package/dist/server/adapters/index.d.mts

@@ -0,0 +1,2 @@
+import { NextAuthMiddlewareOptions, createNextAuthMiddleware, getNextAdminSession } from "./nextjs.mjs";
+import { BeforeLoadContext, TanStackAuthGuardOptions, createTanStackAuthGuard, createTanStackSessionLoader } from "./tanstack.mjs";

package/dist/server/adapters/nextjs.d.mts

@@ -1,4 +1,5 @@
 import { AuthSession } from "../modules/admin/auth-helpers.mjs";
+import "../auth-helpers.mjs";
 import { Questpie } from "questpie";
 
 //#region src/server/adapters/nextjs.d.ts

package/dist/server/augmentation/actions.d.mts

@@ -1,6 +1,7 @@
-import { ComponentReference } from "./common.mjs";
+import { ComponentReference as ComponentReference$1 } from "./common.mjs";
 import { ComponentFactory } from "./views.mjs";
 import { I18nText } from "questpie/shared";
+import { ZodType } from "zod";
 
 //#region src/server/augmentation/actions.d.ts
 
@@ -91,6 +92,11 @@ interface ServerActionContext<TData = Record<string, unknown>> {
   locale?: string;
   /** Translation function for admin messages */
   t: (key: string, params?: Record<string, unknown>) => string;
+  /**
+   * Workflows API — present when a workflows plugin is registered.
+   * Resolved from the app like route handler contexts.
+   */
+  workflows?: unknown;
 }
 /**
  * Action handler function type
@@ -146,7 +152,7 @@ interface ServerActionFormFieldDefinition {
     required?: boolean;
   };
   /** Generate Zod schema for validation */
-  toZodSchema(): unknown;
+  toZodSchema(): ZodType;
 }
 /**
  * Server-side action form configuration
@@ -176,7 +182,7 @@ interface ServerActionDefinition<TData = Record<string, unknown>> {
   /** Action description */
   description?: I18nText;
   /** Icon reference */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Button variant */
   variant?: "default" | "destructive" | "outline" | "secondary" | "ghost";
   /** Where the action appears */

package/dist/server/augmentation/dashboard.d.mts

@@ -1,4 +1,4 @@
-import { ComponentReference } from "./common.mjs";
+import { ComponentReference as ComponentReference$1 } from "./common.mjs";
 import { ComponentFactory } from "./views.mjs";
 import { I18nText } from "questpie/shared";
 import { AppContext } from "questpie";
@@ -39,7 +39,7 @@ interface ServerStatsWidget {
   /** Widget label */
   label?: I18nText;
   /** Icon reference */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Collection to count */
   collection: string;
   /** Filter to apply */
@@ -141,7 +141,7 @@ interface ServerQuickAction {
   /** Action label */
   label: I18nText;
   /** Action icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Visual variant */
   variant?: "default" | "primary" | "secondary" | "outline";
   /** Action to perform */
@@ -189,7 +189,7 @@ interface ServerValueWidget {
   /** Widget label */
   label?: I18nText;
   /** Icon reference */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Card visual variant */
   cardVariant?: "default" | "compact" | "featured";
   /** Grid span (1-4) */
@@ -205,10 +205,10 @@ interface ServerValueWidget {
     label?: I18nText | string;
     subtitle?: I18nText | string;
     footer?: I18nText | string;
-    icon?: ComponentReference;
+    icon?: ComponentReference$1;
     trend?: {
       value: string;
-      icon?: ComponentReference;
+      icon?: ComponentReference$1;
     };
     classNames?: Record<string, string>;
   }>;
@@ -275,7 +275,7 @@ interface ServerTimelineWidget {
     title: string;
     description?: string;
     timestamp: Date | string;
-    icon?: ComponentReference;
+    icon?: ComponentReference$1;
     variant?: "default" | "success" | "warning" | "error" | "info";
     href?: string;
   }>>;
@@ -321,7 +321,7 @@ interface ServerDashboardSection {
   /** Section description */
   description?: I18nText;
   /** Section icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Layout mode */
   layout?: "grid" | "stack";
   /** Grid columns */
@@ -362,7 +362,7 @@ interface ServerDashboardTab {
   /** Tab label */
   label: I18nText;
   /** Tab icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Tab items */
   items: ServerDashboardItem[];
   /** Grid columns for this tab */
@@ -387,7 +387,7 @@ interface ServerDashboardAction {
   /** Action label */
   label: I18nText;
   /** Action icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Action URL */
   href: string;
   /** Visual variant */
@@ -427,7 +427,7 @@ type BrandLogo = string | {
   alt?: string;
   width?: number;
   height?: number;
-} | ComponentReference;
+} | ComponentReference$1;
 /**
  * Branding configuration for the admin panel. Covers content only — name,
  * logo, tagline, favicon. Visual tokens (colors, fonts, radius, shadows)

package/dist/server/augmentation/form-layout.d.mts

@@ -1,4 +1,5 @@
-import { ActionReference, ComponentReference } from "./common.mjs";
+import { ActionReference, ComponentReference as ComponentReference$1 } from "./common.mjs";
+import { FilterRule, QuickFilterConfig } from "../../shared/types/saved-views.types.mjs";
 import { I18nText } from "questpie/shared";
 
 //#region src/server/augmentation/form-layout.d.ts
@@ -13,7 +14,7 @@ interface AdminCollectionConfig {
   /** Description shown in tooltips/help text */
   description?: I18nText;
   /** Icon reference (resolved by client's icon component) */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Hide from admin sidebar */
   hidden?: boolean;
   /** Group in sidebar */
@@ -37,7 +38,7 @@ interface BlockCategoryConfig {
   /** Display label for the category */
   label: I18nText;
   /** Icon for the category */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Order in block picker (lower = first) */
   order?: number;
 }
@@ -64,7 +65,7 @@ interface AdminBlockConfig {
   /** Description shown in tooltips/help text */
   description?: I18nText;
   /** Icon reference (resolved by client's icon component) */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Category for grouping in block picker */
   category?: BlockCategoryConfig;
   /** Order within category in block picker (lower = first) */
@@ -137,6 +138,10 @@ interface ListViewConfig {
     field: string;
     direction: "asc" | "desc";
   };
+  /** Initial filters used when the user has no saved view state */
+  defaultFilters?: FilterRule[];
+  /** Header-level quick filter presets */
+  quickFilters?: QuickFilterConfig[];
   /**
    * Enables reorder mode for this list.
    * Requires a numeric field named `order` on the collection.
@@ -151,6 +156,11 @@ interface ListViewConfig {
   searchable?: string[];
   /** Filterable fields */
   filterable?: string[];
+  /**
+   * Enable realtime invalidation for list queries.
+   * Falls back to AdminProvider realtime config when undefined.
+   */
+  realtime?: boolean;
   /** Client-side grouping options for the current fetched page */
   grouping?: {
     /** Fields users can group by */
@@ -250,7 +260,7 @@ interface FormTabConfig {
   /** Tab label */
   label: I18nText;
   /** Tab icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Fields in this tab */
   fields: FieldLayoutItem[];
   /** Conditional visibility */
@@ -416,7 +426,7 @@ interface AdminGlobalConfig {
   /** Description */
   description?: I18nText;
   /** Icon reference */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Hide from admin */
   hidden?: boolean;
   /** Group in sidebar */

package/dist/server/augmentation/index.d.mts

@@ -5,6 +5,7 @@ import { BrandLogo, DashboardActionFactory, DashboardActionProxy, DashboardCallb
 import { ServerSidebarCollectionItem, ServerSidebarConfig, ServerSidebarDividerItem, ServerSidebarGlobalItem, ServerSidebarItem, ServerSidebarLinkItem, ServerSidebarPageItem, ServerSidebarSection, SidebarCallback, SidebarCallbackContext, SidebarConfigContext, SidebarContribution, SidebarItemDef, SidebarProxy, SidebarSectionDef } from "./sidebar.mjs";
 import { AdminShellRailPlacement, AdminShellRouteRules, ServerAdminShellConfig, ServerAdminShellRailConfig } from "./shell.mjs";
 import { ActionsConfigContext, BuiltinActionType, ServerActionContext, ServerActionDefinition, ServerActionDownload, ServerActionEffects, ServerActionError, ServerActionForm, ServerActionFormField, ServerActionFormFieldConfig, ServerActionFormFieldDefinition, ServerActionHandler, ServerActionRedirect, ServerActionResult, ServerActionSuccess, ServerActionsConfig } from "./actions.mjs";
+import { AdminSidebarMode } from "questpie";
 
 //#region src/server/augmentation/index.d.ts
 
@@ -27,6 +28,12 @@ import { ActionsConfigContext, BuiltinActionType, ServerActionContext, ServerAct
  * ```
  */
 interface AdminConfigInput {
+  /**
+   * How module `sidebar` contributions combine with the app config.
+   * `append` (default): merge module items into the app sidebar.
+   * `replace`: keep only this file's `sidebar` (no module nav injection).
+   */
+  sidebarMode?: AdminSidebarMode;
   sidebar?: SidebarContribution;
   dashboard?: DashboardContribution | ServerDashboardConfig;
   shell?: ServerAdminShellConfig;

package/dist/server/augmentation/sidebar.d.mts

@@ -1,4 +1,4 @@
-import { ComponentReference } from "./common.mjs";
+import { ComponentReference as ComponentReference$1 } from "./common.mjs";
 import { ComponentFactory } from "./views.mjs";
 import { I18nText } from "questpie/shared";
 
@@ -18,7 +18,7 @@ interface ServerSidebarCollectionItem {
   /** Override display label */
   label?: I18nText;
   /** Override icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
 }
 /**
  * Global item in sidebar
@@ -30,7 +30,7 @@ interface ServerSidebarGlobalItem {
   /** Override display label */
   label?: I18nText;
   /** Override icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
 }
 /**
  * Custom page item in sidebar
@@ -42,7 +42,7 @@ interface ServerSidebarPageItem {
   /** Display label */
   label?: I18nText;
   /** Icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
 }
 /**
  * External link item in sidebar
@@ -54,7 +54,7 @@ interface ServerSidebarLinkItem {
   /** Link URL */
   href: string;
   /** Icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Open in new tab */
   external?: boolean;
 }
@@ -73,7 +73,7 @@ interface ServerSidebarSection {
   /** Section title */
   title?: I18nText;
   /** Section icon */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Whether this section can be collapsed/expanded by the user */
   collapsible?: boolean;
   /** Section items */
@@ -108,7 +108,7 @@ interface SidebarSectionDef {
   /** Section title. */
   title?: I18nText;
   /** Section icon. */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Whether section is collapsible. */
   collapsible?: boolean;
 }
@@ -134,7 +134,7 @@ interface SidebarItemDef extends Omit<ServerSidebarItem, "type"> {
   /** URL (for links). */
   href?: string;
   /** Icon reference. */
-  icon?: ComponentReference;
+  icon?: ComponentReference$1;
   /** Open in new tab (for links). */
   external?: boolean;
 }

package/dist/server/augmentation/views.d.mts

@@ -31,6 +31,7 @@ import { FormViewConfig, ListViewConfig } from "./form-layout.mjs";
 interface ViewKindRegistry {
   list: {};
   form: {};
+  document: {};
 }
 /**
  * Union of all registered view kind names.
@@ -191,7 +192,7 @@ type EditViewFactory<TEditViews extends Record<string, any> | string = string> =
  * `TListViews` can be either a views record (per-view typed config)
  * or a string union (backward-compatible, all views use `ListViewConfig`).
  */
-interface ListViewConfigContext<TFields extends Record<string, any> = Record<string, any>, TListViews extends Record<string, any> | string = string> {
+interface ListViewConfigContext<TFields extends Record<string, any> = Record<string, any>, TListViews extends Record<string, any> | string = string, TComponents extends Record<string, any> | string = string> {
   /** View factory — per-view typed config extracted from ViewDefinition */
   v: ListViewFactory<TListViews>;
   /** Field reference proxy - returns field names as strings */
@@ -211,6 +212,8 @@ interface ListViewConfigContext<TFields extends Record<string, any> = Record<str
       config?: unknown;
     };
   };
+  /** Component factory — produces ComponentReference objects */
+  c: ComponentFactory<TComponents>;
 }
 /**
  * Context for form view config functions.

package/dist/server/auth-helpers.d.mts

@@ -0,0 +1 @@
+import { AuthSession, GetAdminSessionOptions, RequireAdminAuthOptions, getAdminSession, isAdminUser, requireAdminAuth } from "./modules/admin/auth-helpers.mjs";

package/dist/server/codegen/admin-client-template.mjs

@@ -61,11 +61,12 @@ function generateAdminClientTemplate(ctx) {
 	lines.push("");
 	if (modulesFile) {
 		lines.push(importStatement(modulesFile));
-		lines.push(`const _mergedModules = Array.isArray(${modulesFile.varName})`);
-		lines.push(`\t? ${modulesFile.varName}.reduce((acc: any, m: any) => {`);
-		lines.push("		for (const [k, v] of Object.entries(m)) acc[k] = typeof v === \"object\" && v !== null && !Array.isArray(v) ? { ...acc[k], ...v } : v;");
+		lines.push("type _AdminModuleMergeAcc = Record<string, unknown>;");
+		lines.push(`const _mergedModules = (Array.isArray(${modulesFile.varName})`);
+		lines.push(`\t? ${modulesFile.varName}.reduce<_AdminModuleMergeAcc>((acc, mod) => {`);
+		lines.push("		for (const [k, v] of Object.entries(mod)) acc[k] = typeof v === \"object\" && v !== null && !Array.isArray(v) ? { ...(typeof acc[k] === \"object\" && acc[k] !== null && !Array.isArray(acc[k]) ? acc[k] as Record<string, unknown> : {}), ...(v as Record<string, unknown>) } : v;");
 		lines.push("		return acc;");
-		lines.push(`\t}, {} as any) : ${modulesFile.varName};`);
+		lines.push(`\t}, {}) : ${modulesFile.varName}) as _AdminModuleMergeAcc;`);
 	}
 	const categoryFiles = /* @__PURE__ */ new Map();
 	for (const [cat, fileMap] of ctx.discovered.categories) if (fileMap.size > 0) {
@@ -95,8 +96,8 @@ function generateAdminClientTemplate(ctx) {
 			const catDecl = ctx.target.categories?.[cat];
 			if (modulesFile && files && files.length > 0) {
 				const entries = files.map((f) => categoryRecordEntry(f, catDecl)).join(", ");
-				lines.push(`\t${cat}: { ..._mergedModules.${cat}, ${entries} },`);
-			} else if (modulesFile && (!files || files.length === 0)) lines.push(`\t${cat}: { ..._mergedModules.${cat} },`);
+				lines.push(`\t${cat}: { ...(_mergedModules[${JSON.stringify(cat)}] as Record<string, unknown>), ${entries} },`);
+			} else if (modulesFile && (!files || files.length === 0)) lines.push(`\t${cat}: { ...(_mergedModules[${JSON.stringify(cat)}] as Record<string, unknown>) },`);
 			else if (files && files.length > 0) {
 				const entries = files.map((f) => categoryRecordEntry(f, catDecl)).join(", ");
 				lines.push(`\t${cat}: { ${entries} },`);

package/dist/server/fields/blocks.mjs

@@ -125,13 +125,16 @@ function createBlocksState() {
 			const doc = value;
 			if (!doc._tree || !doc._values) return value;
 			try {
-				const { app, db, locale } = getContext();
+				const { app, db, locale, session, accessMode, stage } = getContext();
 				const blockDefs = app.state?.blocks;
 				if (!blockDefs || Object.keys(blockDefs).length === 0) return value;
 				return await processBlocksDocument(doc, blockDefs, {
 					app,
 					db,
+					session,
 					locale,
+					accessMode,
+					stage,
 					collections: app.collections,
 					globals: app.globals
 				});

package/dist/server/fields/index.d.mts

@@ -1,5 +1,5 @@
 import { BlockNode, BlockValues, BlocksDocument, BlocksFieldMeta, BlocksFieldState, blocks, blocksFieldType } from "./blocks.mjs";
-import { RichTextFeature, RichTextFieldMeta, RichTextFieldState, TipTapDocument, TipTapNode, richText, richTextFieldType } from "./rich-text.mjs";
+import { RichTextFeature, RichTextFieldMeta, RichTextFieldState, RichTextMode, RichTextOptions, TipTapDocument, TipTapNode, richText, richTextFieldType } from "./rich-text.mjs";
 
 //#region src/server/fields/index.d.ts
 

package/dist/server/fields/reactive-runtime.mjs

@@ -0,0 +1,3 @@
+import { serializeFormLayoutProps, serializeReactivePropsRecord } from "questpie";
+
+export { serializeFormLayoutProps, serializeReactivePropsRecord };

package/dist/server/fields/rich-text.d.mts

@@ -1,5 +1,5 @@
 import { DefaultFieldState, Field, FieldTypeDefinition } from "questpie";
-import { PgJsonbBuilder } from "questpie/drizzle-pg-core";
+import { PgJsonbBuilder, PgTextBuilder } from "questpie/drizzle-pg-core";
 
 //#region src/server/fields/rich-text.d.ts
 
@@ -48,28 +48,27 @@ interface RichTextFieldMeta {
  * Available rich text editor features.
  */
 type RichTextFeature = "bold" | "italic" | "underline" | "strike" | "code" | "subscript" | "superscript" | "heading" | "bulletList" | "orderedList" | "taskList" | "blockquote" | "codeBlock" | "horizontalRule" | "link" | "image" | "table" | "textAlign" | "textColor" | "highlight" | "mention";
-/**
- * Rich text field factory.
- * Creates a TipTap-based rich text editor field.
- *
- * @example
- * ```ts
- * // In collection fields callback:
- * content: f.richText().required().localized()
- * ```
- */
-type RichTextFieldState = DefaultFieldState & {
+type RichTextMode = "json" | "markdown";
+type RichTextOptions = {
+  mode?: RichTextMode;
+};
+type RichTextData<TMode extends RichTextMode> = TMode extends "markdown" ? string : TipTapDocument;
+type RichTextColumn<TMode extends RichTextMode> = TMode extends "markdown" ? PgTextBuilder : PgJsonbBuilder;
+type RichTextFieldState<TMode extends RichTextMode = "json"> = DefaultFieldState & {
   type: "richText";
-  data: TipTapDocument;
-  column: PgJsonbBuilder;
+  data: RichTextData<TMode>;
+  column: RichTextColumn<TMode>;
 };
-declare function richText(): Field<RichTextFieldState>;
+declare function richText(): Field<RichTextFieldState<"json">>;
+declare function richText<const TMode extends RichTextMode>(options: {
+  mode: TMode;
+}): Field<RichTextFieldState<TMode>>;
 /**
  * Rich text field type definition (v3 API).
  *
  * Use this with the `fieldType()` discovery system instead of the
  * legacy `richText()` factory function.
  */
-declare const richTextFieldType: FieldTypeDefinition<"richText", []>;
+declare const richTextFieldType: FieldTypeDefinition<"richText", [RichTextOptions?]>;
 //#endregion
-export { RichTextFeature, RichTextFieldMeta, RichTextFieldState, TipTapDocument, TipTapNode, richText, richTextFieldType };
+export { RichTextFeature, RichTextFieldMeta, RichTextFieldState, RichTextMode, RichTextOptions, TipTapDocument, TipTapNode, richText, richTextFieldType };