@questpie/admin 3.2.7 → 3.4.0

package/dist/client/views/layout/admin-layout.mjs

@@ -1,6 +1,8 @@
 import { useSafeI18n } from "../../i18n/hooks.mjs";
 import { cn } from "../../lib/utils.mjs";
 import { useAdminStore } from "../../runtime/provider.mjs";
+import { ComponentRenderer } from "../../components/component-renderer.mjs";
+import { useAdminConfig } from "../../hooks/use-admin-config.mjs";
 import { shouldHandleAdminShortcut } from "../../utils/keyboard-shortcuts.mjs";
 import { SidebarInset, SidebarProvider } from "../../components/ui/sidebar.mjs";
 import { Toaster } from "../../components/ui/sonner.mjs";
@@ -29,6 +31,54 @@ function useLayoutProps(props) {
 		navigate: props.navigate ?? storeNavigate
 	};
 }
+function normalizeRoute(route) {
+	return route.replace(/\/+$/, "") || "/";
+}
+function resolveRouteRule(rule, basePath) {
+	if (rule.startsWith("/")) return normalizeRoute(rule);
+	return normalizeRoute(`${basePath}/${rule.replace(/^\/+/, "")}`);
+}
+function routeMatchesRule(activeRoute, rule, basePath, match) {
+	if (!activeRoute) return false;
+	const active = normalizeRoute(activeRoute);
+	const target = resolveRouteRule(rule, basePath);
+	if (match === "exact") return active === target;
+	return active === target || active.startsWith(`${target}/`);
+}
+function shouldRenderShellRail(config, activeRoute, basePath) {
+	const routes = config.routes;
+	if (!routes) return true;
+	const match = routes.match ?? "prefix";
+	if (!(!routes.include?.length || routes.include.some((rule) => routeMatchesRule(activeRoute, rule, basePath, match)))) return false;
+	return !routes.exclude?.some((rule) => routeMatchesRule(activeRoute, rule, basePath, match));
+}
+function toCssLength(value) {
+	if (value === void 0) return void 0;
+	return typeof value === "number" ? `${value}px` : value;
+}
+function AdminShellRail({ config, activeRoute, basePath, navigate }) {
+	const placement = config.placement ?? "left";
+	const style = {
+		width: toCssLength(config.width ?? 320),
+		minWidth: toCssLength(config.minWidth ?? config.width ?? 280),
+		maxWidth: toCssLength(config.maxWidth)
+	};
+	return /* @__PURE__ */ jsx("aside", {
+		className: cn("qa-admin-layout__secondary-rail bg-background h-svh min-h-0 shrink-0 flex-col overflow-hidden", config.hiddenOnMobile === false ? "flex" : "hidden md:flex", placement === "left" ? "border-border-subtle border-r" : "border-border-subtle border-l", config.className),
+		"data-placement": placement,
+		style,
+		children: /* @__PURE__ */ jsx(ComponentRenderer, {
+			reference: config.component,
+			additionalProps: {
+				activeRoute,
+				basePath,
+				placement,
+				config,
+				navigate
+			}
+		})
+	});
+}
 /**
 * AdminLayout Component
 *
@@ -61,6 +111,15 @@ function AdminLayout({ LinkComponent, activeRoute, basePath = "/admin", brandNam
 	const [isSearchOpen, setIsSearchOpen] = React.useState(false);
 	const openSearch = React.useCallback(() => setIsSearchOpen(true), []);
 	const closeSearch = React.useCallback(() => setIsSearchOpen(false), []);
+	const { data: serverConfig } = useAdminConfig();
+	const currentActiveRoute = activeRoute ?? (typeof window !== "undefined" ? window.location.pathname : void 0);
+	const secondaryRailConfig = serverConfig?.shell?.secondaryRail;
+	const secondaryRail = !!secondaryRailConfig && shouldRenderShellRail(secondaryRailConfig, currentActiveRoute, basePath) && secondaryRailConfig ? /* @__PURE__ */ jsx(AdminShellRail, {
+		config: secondaryRailConfig,
+		activeRoute: currentActiveRoute,
+		basePath,
+		navigate
+	}) : null;
 	React.useEffect(() => {
 		const down = (e) => {
 			if (shouldHandleAdminShortcut(e, { key: "k" })) {
@@ -90,38 +149,43 @@ function AdminLayout({ LinkComponent, activeRoute, basePath = "/admin", brandNam
 				/* @__PURE__ */ jsxs(SidebarProvider, {
 					defaultOpen: !sidebarCollapsedProp,
 					className: "qa-admin-layout__sidebar-wrapper bg-sidebar mx-auto h-svh max-w-[1920px] overflow-hidden",
-					children: [/* @__PURE__ */ jsx(AdminSidebar, {
-						LinkComponent,
-						activeRoute,
-						basePath,
-						brandName,
-						theme,
-						setTheme,
-						showThemeToggle,
-						onSearchOpen: openSearch,
-						...sidebarProps
-					}), /* @__PURE__ */ jsxs(SidebarInset, {
-						className: "qa-admin-layout__content bg-background flex h-svh flex-col overflow-hidden md:rounded-tl-2xl",
-						children: [
-							shouldShowHeader && header && /* @__PURE__ */ jsx("header", {
-								className: "qa-admin-layout__header border-border-subtle border-b",
-								children: header
-							}),
-							/* @__PURE__ */ jsx("main", {
-								id: "main-content",
-								className: "qa-admin-layout__main min-w-0 flex-1 overflow-y-auto",
-								tabIndex: -1,
-								children: /* @__PURE__ */ jsx("div", {
-									className: cn("qa-admin-layout__main-content min-w-0", layoutMode === "default" && "mx-auto max-w-5xl px-3 pt-1 pb-6 md:px-4 md:pt-2 md:pb-8", layoutMode === "wide" && "px-3 pt-1 pb-6 md:px-4 md:pt-2 md:pb-8", layoutMode === "full" && "px-2 pt-1 pb-6 md:px-3 md:pb-8", layoutMode === "immersive" && "p-0"),
-									children
+					children: [
+						/* @__PURE__ */ jsx(AdminSidebar, {
+							LinkComponent,
+							activeRoute: currentActiveRoute,
+							basePath,
+							brandName,
+							theme,
+							setTheme,
+							showThemeToggle,
+							onSearchOpen: openSearch,
+							...sidebarProps
+						}),
+						secondaryRailConfig?.placement !== "right" && secondaryRail,
+						/* @__PURE__ */ jsxs(SidebarInset, {
+							className: "qa-admin-layout__content bg-background flex h-svh flex-col overflow-hidden md:rounded-tl-2xl",
+							children: [
+								shouldShowHeader && header && /* @__PURE__ */ jsx("header", {
+									className: "qa-admin-layout__header border-border-subtle border-b",
+									children: header
+								}),
+								/* @__PURE__ */ jsx("main", {
+									id: "main-content",
+									className: "qa-admin-layout__main min-w-0 flex-1 overflow-y-auto",
+									tabIndex: -1,
+									children: /* @__PURE__ */ jsx("div", {
+										className: cn("qa-admin-layout__main-content min-w-0", layoutMode === "default" && "mx-auto max-w-5xl px-3 pt-1 pb-6 md:px-4 md:pt-2 md:pb-8", layoutMode === "wide" && "px-3 pt-1 pb-6 md:px-4 md:pt-2 md:pb-8", layoutMode === "full" && "px-2 pt-1 pb-6 md:px-3 md:pb-8", layoutMode === "immersive" && "p-0"),
+										children
+									})
+								}),
+								shouldShowFooter && footer && /* @__PURE__ */ jsx("footer", {
+									className: "qa-admin-layout__footer border-border-subtle border-t",
+									children: footer
 								})
-							}),
-							shouldShowFooter && footer && /* @__PURE__ */ jsx("footer", {
-								className: "qa-admin-layout__footer border-border-subtle border-t",
-								children: footer
-							})
-						]
-					})]
+							]
+						}),
+						secondaryRailConfig?.placement === "right" && secondaryRail
+					]
 				}),
 				/* @__PURE__ */ jsx(Toaster, {
 					theme,

package/dist/client/views/layout/admin-sidebar.mjs

@@ -4,10 +4,10 @@ import { selectAdmin, selectBasePath, selectContentLocale, selectNavigate, selec
 import { useSafeContentLocales } from "../../runtime/content-locales-provider.mjs";
 import { ComponentRenderer } from "../../components/component-renderer.mjs";
 import { Button } from "../../components/ui/button.mjs";
-import { Tooltip, TooltipContent, TooltipTrigger } from "../../components/ui/tooltip.mjs";
-import { useAdminConfig } from "../../hooks/use-admin-config.mjs";
 import { getFlagUrl } from "../../utils/locale-to-flag.mjs";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from "../../components/ui/dropdown-menu.mjs";
+import { Tooltip, TooltipContent, TooltipTrigger } from "../../components/ui/tooltip.mjs";
+import { useAdminConfig } from "../../hooks/use-admin-config.mjs";
 import { useLazyComponent } from "../../utils/use-lazy-component.mjs";
 import { Skeleton } from "../../components/ui/skeleton.mjs";
 import { useAuthClientSafe } from "../../hooks/use-auth.mjs";

package/dist/client.d.mts

@@ -1,11 +1,11 @@
-import { BaseWidgetAdminMeta, WidgetTypeRegistry } from "./augmentation.mjs";
 import { I18nContext, I18nText } from "./client/i18n/types.mjs";
 import { BaseFieldProps, IconComponent, MaybeLazyComponent } from "./client/builder/types/common.mjs";
+import { FormViewDefinition, ListViewDefinition, ViewDefinition, ViewKind, view } from "./client/builder/view/view.mjs";
+import { Badge, BadgeProps, ComponentRenderer, ComponentRendererProps, ComponentRendererRegistry, IconifyIcon, IconifyIconProps, createIconRenderer, isComponentReference, resolveIconElement } from "./client/components/component-renderer.mjs";
 import { FieldDefinition, FieldInstance, configureField, field } from "./client/builder/field/field.mjs";
 import { PageDefinition, page } from "./client/builder/page/page.mjs";
-import { AnyWidgetConfig, BaseWidgetConfig, ChartWidgetConfig, CustomWidgetConfig, ProgressWidgetConfig, QuickActionsWidgetConfig, RecentItemsWidgetConfig, StatsWidgetConfig, TableWidgetConfig, TimelineWidgetConfig, ValueWidgetConfig, WidgetComponentProps, WidgetConfig } from "./client/builder/types/widget-types.mjs";
-import { FormViewDefinition, ListViewDefinition, ViewDefinition, ViewKind, view } from "./client/builder/view/view.mjs";
 import { WidgetDefinition, widget } from "./client/builder/widget/widget.mjs";
+import { AnyWidgetConfig, BaseWidgetConfig, ChartWidgetConfig, CustomWidgetConfig, ProgressWidgetConfig, QuickActionsWidgetConfig, RecentItemsWidgetConfig, StatsWidgetConfig, TableWidgetConfig, TimelineWidgetConfig, ValueWidgetConfig, WidgetComponentProps, WidgetConfig } from "./client/builder/types/widget-types.mjs";
 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";
@@ -15,7 +15,7 @@ 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 } from "./client/views/layout/admin-layout.mjs";
+import { AdminLayout, AdminShellRailProps } from "./client/views/layout/admin-layout.mjs";
 import { AdminLayoutProvider } from "./client/views/layout/admin-layout-provider.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";
@@ -33,7 +33,6 @@ import { UseCollectionPreviewOptions, UseCollectionPreviewResult, useCollectionP
 import "./client/preview/index.mjs";
 import { AuthGuard } from "./client/components/auth/auth-guard.mjs";
 import { AuthLoading } from "./client/components/auth/auth-loading.mjs";
-import { Badge, BadgeProps, ComponentRenderer, ComponentRendererProps, ComponentRendererRegistry, IconifyIcon, IconifyIconProps, createIconRenderer, isComponentReference, resolveIconElement } from "./client/components/component-renderer.mjs";
 import { AcceptInviteForm } from "./client/views/auth/accept-invite-form.mjs";
 import { AuthDefaultLogo, AuthLayout, AuthLayoutProps } from "./client/views/auth/auth-layout.mjs";
 import { BrandLogoMark, BrandLogoMarkProps } from "./client/components/brand-logo.mjs";
@@ -61,6 +60,7 @@ import { SetupStatus, useSetupStatus } from "./client/hooks/use-setup-status.mjs
 import { useSidebarSearchParam } from "./client/hooks/use-sidebar-search-param.mjs";
 import { AdminLink } from "./client/components/admin-link.mjs";
 import { FlagConfig, getCountryCode, getFlagConfig, getFlagUrl } from "./client/utils/locale-to-flag.mjs";
+import { BaseWidgetAdminMeta, WidgetTypeRegistry } from "./augmentation.mjs";
 import { CollectionFormViewProps, CollectionListViewProps, GlobalFormViewProps } from "./client/builder/types/views.mjs";
 import { buildValidationSchema, buildZodFromIntrospection, createFormSchema } from "./client/builder/validation.mjs";
 import { FocusContextValue, FocusProvider, FocusProviderProps, FocusState, parsePreviewFieldPath, scrollFieldIntoView, useFocus, useFocusOptional, useIsBlockFocused, useIsFieldFocused } from "./client/contexts/focus-context.mjs";
@@ -105,4 +105,4 @@ type CollectionFieldKeys<TApp extends QuestpieApp, TCollectionName extends strin
   select: infer TSelect;
 } ? keyof TSelect : never : never : never;
 //#endregion
-export { AcceptInviteForm, AcceptInvitePage, Admin, AdminLayout, AdminLayoutProvider, AdminLink, AdminProvider, type AdminProviderProps, AdminRouter, type AdminRouterProps, type AdminSidebarBrandProps, type AdminSidebarNavItemProps, type AdminState, type AdminStore, type AdminToPreviewMessage, AnyQuestpieClient, type AnyWidgetConfig, type AppAdmin, AuthDefaultLogo, AuthGuard, AuthLayout, type AuthLayoutProps, AuthLoading, Badge, type BadgeProps, type BaseFieldProps, type BaseWidgetAdminMeta, type BaseWidgetConfig, type BlockCategory, type BlockClickedMessage, type BlockContent, type BlockNode, BlockRenderer, type BlockRendererProps as BlockRendererComponentProps, type BlockRendererProps$1 as BlockRendererProps, type BlockScopeContextValue, BlockScopeProvider, type BlockScopeProviderProps, type BrandLogoConfig, BrandLogoMark, type BrandLogoMarkProps, type BrandSnapshot, type BrandingConfig, type ChartWidgetConfig, CollectionFieldKeys, type CollectionFormViewProps, CollectionItem, type CollectionListViewProps, CollectionNames, type CommitMessage, type ComponentRegistry, ComponentRenderer, type ComponentRendererProps, type ComponentRendererRegistry, type CustomWidgetConfig, DashboardPage, EMPTY_BLOCK_CONTENT, type FieldClickedMessage, type FieldComponentProps, type FieldDefinition, type FieldInstance, type FieldValueEditedMessage, type FlagConfig, type FocusContextValue, type FocusFieldMessage, FocusProvider, type FocusProviderProps, type FocusState, ForgotPasswordForm, ForgotPasswordPage, type FormViewConfig, type FormViewDefinition, type FullResyncMessage, type GlobalFormViewProps, GlobalNames, type I18nContext, type I18nText, type IconComponent, IconifyIcon, type IconifyIconProps, type InferAdminCMS, type InitSnapshotMessage, InvitePage, type ListViewDefinition, LoginForm, LoginPage, type MaybeLazyComponent, type OptionItem, type PageDefinition, type PatchAppliedMessage, type PatchBatchMessage, PreviewBanner, type PreviewBannerProps, type PreviewConfig, PreviewField, type PreviewFieldProps, type PreviewPatchOp, PreviewProvider, type PreviewReadyMessage, type PreviewRefreshMessage, type PreviewToAdminMessage, type ProgressWidgetConfig, type QuickActionsWidgetConfig, type ReactiveFieldResult, type ReactiveFieldState, type RecentItemsWidgetConfig, type RefreshCompleteMessage, ResetPasswordForm, ResetPasswordPage, type ResyncRequestMessage, RichTextEditor, type RichTextEditorProps, RichTextRenderer, type RichTextStyles, type ScopeContextValue, type ScopeOption, ScopePicker, type ScopePickerProps, ScopeProvider, type ScopeProviderProps, type SelectBlockMessage, SetupForm, type SetupFormValues, SetupPage, type SetupPageProps, type SetupStatus, StandalonePreviewField, type StatsWidgetConfig, type TableWidgetConfig, type TimelineWidgetConfig, type TipTapDoc, type TipTapNode, type TypedHooks, type UseCollectionPreviewOptions, type UseCollectionPreviewResult, type UseFieldOptionsOptions, type UseFieldOptionsResult, type UseReactiveFieldsOptions, type UseReactiveFieldsResult, type ValueWidgetConfig, type ViewDefinition, type ViewKind, type WidgetComponentProps, type WidgetConfig, type WidgetDefinition, type 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 };
+export { AcceptInviteForm, AcceptInvitePage, Admin, AdminLayout, AdminLayoutProvider, AdminLink, AdminProvider, type AdminProviderProps, AdminRouter, type AdminRouterProps, type AdminShellRailProps, type AdminSidebarBrandProps, type AdminSidebarNavItemProps, type AdminState, type AdminStore, type AdminToPreviewMessage, AnyQuestpieClient, type AnyWidgetConfig, type AppAdmin, AuthDefaultLogo, AuthGuard, AuthLayout, type AuthLayoutProps, AuthLoading, Badge, type BadgeProps, type BaseFieldProps, type BaseWidgetAdminMeta, type BaseWidgetConfig, type BlockCategory, type BlockClickedMessage, type BlockContent, type BlockNode, BlockRenderer, type BlockRendererProps as BlockRendererComponentProps, type BlockRendererProps$1 as BlockRendererProps, type BlockScopeContextValue, BlockScopeProvider, type BlockScopeProviderProps, type BrandLogoConfig, BrandLogoMark, type BrandLogoMarkProps, type BrandSnapshot, type BrandingConfig, type ChartWidgetConfig, CollectionFieldKeys, type CollectionFormViewProps, CollectionItem, type CollectionListViewProps, CollectionNames, type CommitMessage, type ComponentRegistry, ComponentRenderer, type ComponentRendererProps, type ComponentRendererRegistry, type CustomWidgetConfig, DashboardPage, EMPTY_BLOCK_CONTENT, type FieldClickedMessage, type FieldComponentProps, type FieldDefinition, type FieldInstance, type FieldValueEditedMessage, type FlagConfig, type FocusContextValue, type FocusFieldMessage, FocusProvider, type FocusProviderProps, type FocusState, ForgotPasswordForm, ForgotPasswordPage, type FormViewConfig, type FormViewDefinition, type FullResyncMessage, type GlobalFormViewProps, GlobalNames, type I18nContext, type I18nText, type IconComponent, IconifyIcon, type IconifyIconProps, type InferAdminCMS, type InitSnapshotMessage, InvitePage, type ListViewDefinition, LoginForm, LoginPage, type MaybeLazyComponent, type OptionItem, type PageDefinition, type PatchAppliedMessage, type PatchBatchMessage, PreviewBanner, type PreviewBannerProps, type PreviewConfig, PreviewField, type PreviewFieldProps, type PreviewPatchOp, PreviewProvider, type PreviewReadyMessage, type PreviewRefreshMessage, type PreviewToAdminMessage, type ProgressWidgetConfig, type QuickActionsWidgetConfig, type ReactiveFieldResult, type ReactiveFieldState, type RecentItemsWidgetConfig, type RefreshCompleteMessage, ResetPasswordForm, ResetPasswordPage, type ResyncRequestMessage, RichTextEditor, type RichTextEditorProps, RichTextRenderer, type RichTextStyles, type ScopeContextValue, type ScopeOption, ScopePicker, type ScopePickerProps, ScopeProvider, type ScopeProviderProps, type SelectBlockMessage, SetupForm, type SetupFormValues, SetupPage, type SetupPageProps, type SetupStatus, StandalonePreviewField, type StatsWidgetConfig, type TableWidgetConfig, type TimelineWidgetConfig, type TipTapDoc, type TipTapNode, type TypedHooks, type UseCollectionPreviewOptions, type UseCollectionPreviewResult, type UseFieldOptionsOptions, type UseFieldOptionsResult, type UseReactiveFieldsOptions, type UseReactiveFieldsResult, type ValueWidgetConfig, type ViewDefinition, type ViewKind, type WidgetComponentProps, type WidgetConfig, type WidgetDefinition, type 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 };

package/dist/client.mjs

@@ -4,8 +4,8 @@ import { AdminProvider, selectAdmin, selectBasePath, selectClient, selectNavigat
 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 { EMPTY_BLOCK_CONTENT, isBlockContent } from "./client/blocks/types.mjs";
 import { getCountryCode, getFlagConfig, getFlagUrl } from "./client/utils/locale-to-flag.mjs";
+import { EMPTY_BLOCK_CONTENT, isBlockContent } from "./client/blocks/types.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";

package/dist/components/rich-text/rich-text-renderer.d.mts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime20 from "react/jsx-runtime";
+import * as react_jsx_runtime19 from "react/jsx-runtime";
 
 //#region src/components/rich-text/rich-text-renderer.d.ts
 /**
@@ -98,6 +98,6 @@ declare function RichTextRenderer({
   content,
   styles: customStyles,
   className
-}: RichTextRendererProps): react_jsx_runtime20.JSX.Element | null;
+}: RichTextRendererProps): react_jsx_runtime19.JSX.Element | null;
 //#endregion
 export { RichTextRenderer, RichTextStyles, TipTapDoc, TipTapNode };

package/dist/factories.d.mts

@@ -0,0 +1,19 @@
+import { ActionReference, AdminLocaleConfig, ComponentReference, ComponentType, ComponentTypeRegistry } from "./server/augmentation/common.mjs";
+import { AdminBlockConfig, AdminCollectionConfig, AdminGlobalConfig, BlockCategoryConfig, FieldLayoutItem, FormFieldLayoutItem, FormReactiveConfig, FormReactiveContext, FormSectionLayout, FormSidebarConfig, FormTabConfig, FormTabsLayout, FormViewConfig, ListViewConfig, PreviewConfig } from "./server/augmentation/form-layout.mjs";
+import { AdminConfigContext, ComponentDefinition, ComponentFactory, EditViewDefinition, EditViewFactory, FilterViewsByKind, FormViewConfigContext, ListViewConfigContext, ListViewDefinition, ListViewFactory, ViewDefinition, ViewKind, ViewKindRegistry } from "./server/augmentation/views.mjs";
+import { DashboardActionFactory, DashboardActionProxy, DashboardCallback, DashboardCallbackContext, DashboardConfigContext, DashboardContribution, DashboardItemDef, DashboardProxy, DashboardSectionDef, ServerBrandingConfig, ServerChartWidget, ServerCustomWidget, ServerDashboardAction, ServerDashboardConfig, ServerDashboardItem, ServerDashboardSection, ServerDashboardTab, ServerDashboardTabs, ServerDashboardWidget, ServerProgressWidget, ServerQuickAction, ServerQuickActionsWidget, ServerRecentItemsWidget, ServerStatsWidget, ServerTableWidget, ServerTimelineWidget, ServerValueWidget, WidgetAccessRule, WidgetFetchContext } from "./server/augmentation/dashboard.mjs";
+import { ServerSidebarCollectionItem, ServerSidebarConfig, ServerSidebarDividerItem, ServerSidebarGlobalItem, ServerSidebarItem, ServerSidebarLinkItem, ServerSidebarPageItem, ServerSidebarSection, SidebarCallback, SidebarCallbackContext, SidebarConfigContext, SidebarContribution, SidebarItemDef, SidebarProxy, SidebarSectionDef } from "./server/augmentation/sidebar.mjs";
+import { AdminShellRailPlacement, AdminShellRouteRules, ServerAdminShellConfig, ServerAdminShellRailConfig } from "./server/augmentation/shell.mjs";
+import { ActionsConfigContext, BuiltinActionType, ServerActionContext, ServerActionDefinition, ServerActionDownload, ServerActionEffects, ServerActionError, ServerActionForm, ServerActionFormField, ServerActionHandler, ServerActionRedirect, ServerActionResult, ServerActionSuccess, ServerActionsConfig } from "./server/augmentation/actions.mjs";
+import { AdminConfigInput, adminConfig } from "./server/augmentation/index.mjs";
+import "./server/augmentation.mjs";
+import { AnyBlockBuilder, AnyBlockDefinition, BlockBuilder, BlockBuilderState, BlockDefinition, BlockPrefetchContext, BlockPrefetchFn, BlockPrefetchWith, BlockPrefetchWithOptions, ExpandWithResult, ExpandedRecord, InferBlockData, InferBlockValues, block } from "./server/modules/admin/block/block-builder.mjs";
+import { BlockSchema, getBlocksByCategory, introspectBlock, introspectBlocks } from "./server/modules/admin/block/introspection.mjs";
+import { BlocksPrefetchContext, createBlocksPrefetchHook, processBlocksDocument, processDocumentBlocksPrefetch } from "./server/modules/admin/block/prefetch.mjs";
+import "./server/block/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 { AuthSession, GetAdminSessionOptions, RequireAdminAuthOptions, getAdminSession, isAdminUser, requireAdminAuth } from "./server/modules/admin/auth-helpers.mjs";
+import { NextAuthMiddlewareOptions, createNextAuthMiddleware, getNextAdminSession } from "./server/adapters/nextjs.mjs";
+import { BeforeLoadContext, TanStackAuthGuardOptions, createTanStackAuthGuard, createTanStackSessionLoader } from "./server/adapters/tanstack.mjs";
+export { type ActionReference, type ActionsConfigContext, type AdminBlockConfig, type AdminCollectionConfig, type AdminConfigContext, type AdminConfigInput, type AdminGlobalConfig, type AdminLocaleConfig, type AdminShellRailPlacement, type AdminShellRouteRules, type AnyBlockBuilder, type AnyBlockDefinition, type AuthSession, BeforeLoadContext, BlockBuilder, type BlockBuilderState, type BlockCategoryConfig, type BlockDefinition, type BlockPrefetchContext, type BlockPrefetchFn, type BlockPrefetchWith, type BlockPrefetchWithOptions, type BlockSchema, type BlocksPrefetchContext, type BuiltinActionType, type ComponentDefinition, type ComponentFactory, type ComponentReference, type ComponentType, type ComponentTypeRegistry, type DashboardActionFactory, type DashboardActionProxy, type DashboardCallback, type DashboardCallbackContext, type DashboardConfigContext, type DashboardContribution, type DashboardItemDef, type DashboardProxy, type DashboardSectionDef, type EditViewDefinition, type EditViewFactory, type ExpandWithResult, type ExpandedRecord, type FieldLayoutItem, type FilterViewsByKind, type FormFieldLayoutItem, type FormReactiveConfig, type FormReactiveContext, type FormSectionLayout, type FormSidebarConfig, type FormTabConfig, type FormTabsLayout, type FormViewConfig, type FormViewConfigContext, type GetAdminSessionOptions, type InferBlockData, type InferBlockValues, type ListViewConfig, type ListViewConfigContext, type ListViewDefinition, type ListViewFactory, NextAuthMiddlewareOptions, type PreviewConfig, type RequireAdminAuthOptions, type ServerActionContext, type ServerActionDefinition, type ServerActionDownload, type ServerActionEffects, type ServerActionError, type ServerActionForm, type ServerActionFormField, type ServerActionHandler, type ServerActionRedirect, type ServerActionResult, type ServerActionSuccess, type ServerActionsConfig, type ServerAdminShellConfig, type ServerAdminShellRailConfig, type ServerBrandingConfig, type ServerChartWidget, type ServerCustomWidget, type ServerDashboardAction, type ServerDashboardConfig, type ServerDashboardItem, type ServerDashboardSection, type ServerDashboardTab, type ServerDashboardTabs, type ServerDashboardWidget, type ServerProgressWidget, type ServerQuickAction, type ServerQuickActionsWidget, type ServerRecentItemsWidget, type ServerSidebarCollectionItem, type ServerSidebarConfig, type ServerSidebarDividerItem, type ServerSidebarGlobalItem, type ServerSidebarItem, type ServerSidebarLinkItem, type ServerSidebarPageItem, type ServerSidebarSection, type ServerStatsWidget, type ServerTableWidget, type ServerTimelineWidget, type ServerValueWidget, type SidebarCallback, type SidebarCallbackContext, type SidebarConfigContext, type SidebarContribution, type SidebarItemDef, type SidebarProxy, type SidebarSectionDef, TanStackAuthGuardOptions, type ViewDefinition, type ViewKind, type ViewKindRegistry, type WidgetAccessRule, type WidgetFetchContext, 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 };

package/dist/factories.mjs

@@ -0,0 +1,11 @@
+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 { 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";
+import { getAdminSession, isAdminUser, requireAdminAuth } from "./server/modules/admin/auth-helpers.mjs";
+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 };

package/dist/fields.d.mts

@@ -0,0 +1,4 @@
+import { BlockNode, BlockValues, BlocksDocument, BlocksFieldMeta, BlocksFieldState, blocks, blocksFieldType } from "./server/fields/blocks.mjs";
+import { RichTextFeature, RichTextFieldMeta, RichTextFieldState, TipTapDocument, TipTapNode, richText, richTextFieldType } from "./server/fields/rich-text.mjs";
+import { adminFields } from "./server/fields/index.mjs";
+export { type BlockNode, type BlockValues, type BlocksDocument, type BlocksFieldMeta, type BlocksFieldState, type RichTextFeature, type RichTextFieldMeta, type RichTextFieldState, type TipTapDocument, type TipTapNode, adminFields, blocks, blocksFieldType, richText, richTextFieldType };

package/dist/fields.mjs

@@ -0,0 +1,5 @@
+import { blocks, blocksFieldType } from "./server/fields/blocks.mjs";
+import { richText, richTextFieldType } from "./server/fields/rich-text.mjs";
+import { adminFields } from "./server/fields/index.mjs";
+
+export { adminFields, blocks, blocksFieldType, richText, richTextFieldType };

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { AnyAdminMeta, ArrayFieldAdminMeta, BaseAdminMeta, BaseWidgetAdminMeta, BooleanFieldAdminMeta, DateFieldAdminMeta, JsonFieldAdminMeta, NumberFieldAdminMeta, ObjectFieldAdminMeta, RelationFieldAdminMeta, SelectFieldAdminMeta, TextFieldAdminMeta, TextareaFieldAdminMeta, TimeFieldAdminMeta, UploadFieldAdminMeta, WidgetTypeRegistry } from "./augmentation.mjs";
 import { I18nContext, I18nText } from "./client/i18n/types.mjs";
 import { BaseFieldProps, IconComponent, MaybeLazyComponent } from "./client/builder/types/common.mjs";
+import { FormViewDefinition, ListViewDefinition, ViewDefinition, ViewKind, view } from "./client/builder/view/view.mjs";
+import { Badge, BadgeProps, ComponentRenderer, ComponentRendererProps, ComponentRendererRegistry, IconifyIcon, IconifyIconProps, createIconRenderer, isComponentReference, resolveIconElement } from "./client/components/component-renderer.mjs";
 import { FieldDefinition, FieldInstance, configureField, field } from "./client/builder/field/field.mjs";
 import { PageDefinition, page } from "./client/builder/page/page.mjs";
-import { AnyWidgetConfig, BaseWidgetConfig, ChartWidgetConfig, CustomWidgetConfig, ProgressWidgetConfig, QuickActionsWidgetConfig, RecentItemsWidgetConfig, StatsWidgetConfig, TableWidgetConfig, TimelineWidgetConfig, ValueWidgetConfig, WidgetComponentProps, WidgetConfig } from "./client/builder/types/widget-types.mjs";
-import { FormViewDefinition, ListViewDefinition, ViewDefinition, ViewKind, view } from "./client/builder/view/view.mjs";
 import { WidgetDefinition, widget } from "./client/builder/widget/widget.mjs";
+import { AnyWidgetConfig, BaseWidgetConfig, ChartWidgetConfig, CustomWidgetConfig, ProgressWidgetConfig, QuickActionsWidgetConfig, RecentItemsWidgetConfig, StatsWidgetConfig, TableWidgetConfig, TimelineWidgetConfig, ValueWidgetConfig, WidgetComponentProps, WidgetConfig } from "./client/builder/types/widget-types.mjs";
 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";
@@ -15,7 +15,7 @@ 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 } from "./client/views/layout/admin-layout.mjs";
+import { AdminLayout, AdminShellRailProps } from "./client/views/layout/admin-layout.mjs";
 import { AdminLayoutProvider } from "./client/views/layout/admin-layout-provider.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";
@@ -30,7 +30,6 @@ import { AdminToPreviewMessage, BlockClickedMessage, CommitMessage, FieldClicked
 import { UseCollectionPreviewOptions, UseCollectionPreviewResult, useCollectionPreview } from "./client/preview/use-collection-preview.mjs";
 import { AuthGuard } from "./client/components/auth/auth-guard.mjs";
 import { AuthLoading } from "./client/components/auth/auth-loading.mjs";
-import { Badge, BadgeProps, ComponentRenderer, ComponentRendererProps, ComponentRendererRegistry, IconifyIcon, IconifyIconProps, createIconRenderer, isComponentReference, resolveIconElement } from "./client/components/component-renderer.mjs";
 import { AcceptInviteForm } from "./client/views/auth/accept-invite-form.mjs";
 import { AuthDefaultLogo, AuthLayout, AuthLayoutProps } from "./client/views/auth/auth-layout.mjs";
 import { BrandLogoMark, BrandLogoMarkProps } from "./client/components/brand-logo.mjs";
@@ -58,6 +57,7 @@ import { SetupStatus, useSetupStatus } from "./client/hooks/use-setup-status.mjs
 import { useSidebarSearchParam } from "./client/hooks/use-sidebar-search-param.mjs";
 import { AdminLink } from "./client/components/admin-link.mjs";
 import { FlagConfig, getCountryCode, getFlagConfig, getFlagUrl } from "./client/utils/locale-to-flag.mjs";
+import { AnyAdminMeta, ArrayFieldAdminMeta, BaseAdminMeta, BaseWidgetAdminMeta, BooleanFieldAdminMeta, DateFieldAdminMeta, JsonFieldAdminMeta, NumberFieldAdminMeta, ObjectFieldAdminMeta, RelationFieldAdminMeta, SelectFieldAdminMeta, TextFieldAdminMeta, TextareaFieldAdminMeta, TimeFieldAdminMeta, UploadFieldAdminMeta, WidgetTypeRegistry } from "./augmentation.mjs";
 import { CollectionFormViewProps, CollectionListViewProps, GlobalFormViewProps } from "./client/builder/types/views.mjs";
 import { buildValidationSchema, buildZodFromIntrospection, createFormSchema } from "./client/builder/validation.mjs";
 import { FocusContextValue, FocusProvider, FocusProviderProps, FocusState, parsePreviewFieldPath, scrollFieldIntoView, useFocus, useFocusOptional, useIsBlockFocused, useIsFieldFocused } from "./client/contexts/focus-context.mjs";
@@ -65,4 +65,4 @@ import { ScopeContextValue, ScopeOption, ScopePickerProps, ScopeProviderProps }
 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, 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 };
+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 };

package/dist/index.mjs

@@ -4,8 +4,8 @@ import { AdminProvider, selectAdmin, selectBasePath, selectClient, selectNavigat
 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 { EMPTY_BLOCK_CONTENT, isBlockContent } from "./client/blocks/types.mjs";
 import { getCountryCode, getFlagConfig, getFlagUrl } from "./client/utils/locale-to-flag.mjs";
+import { EMPTY_BLOCK_CONTENT, isBlockContent } from "./client/blocks/types.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";

package/dist/modules/admin.d.mts

@@ -0,0 +1,10 @@
+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/modules/admin.mjs

@@ -0,0 +1,9 @@
+import { savedViewsCollection } from "../server/modules/admin-preferences/collections/saved-views.mjs";
+import { actionFunctions, executeAction, executeActionFn, getActionsConfig, getActionsConfigFn } from "../server/modules/admin/routes/execute-action.mjs";
+import { 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 { adminModule, adminRoutes } from "../server/modules/admin/index.mjs";
+
+export { actionFunctions, adminModule, adminRoutes, batchReactive, createFirstAdmin, createPreviewFunctions, createPreviewTokenVerifier, executeAction, executeActionFn, fetchWidgetData, fieldOptions, getActionsConfig, getActionsConfigFn, isSetupRequired, reactiveFunctions, savedViewsCollection, setupFunctions, verifyPreviewTokenDirect, widgetDataFunctions };

package/dist/modules/audit.d.mts

@@ -0,0 +1,5 @@
+import { AUDIT_LOG_COLLECTION, auditLogCollection } from "../server/modules/audit/collections/audit-log.mjs";
+import { AuditModule, _module } from "../server/modules/audit/.generated/module.mjs";
+import { AuditActorType, AuditContext, LogAuditEntryOptions, logAuditEntry } from "../server/modules/audit/log-audit-entry.mjs";
+import "../server/modules/audit/index.mjs";
+export { AUDIT_LOG_COLLECTION, type AuditActorType, type AuditContext, type AuditModule, type LogAuditEntryOptions, auditLogCollection, _module as auditModule, logAuditEntry };

package/dist/modules/audit.mjs

@@ -0,0 +1,5 @@
+import { AUDIT_LOG_COLLECTION, auditLogCollection } from "../server/modules/audit/collections/audit-log.mjs";
+import module_default from "../server/modules/audit/.generated/module.mjs";
+import { logAuditEntry } from "../server/modules/audit/log-audit-entry.mjs";
+
+export { AUDIT_LOG_COLLECTION, auditLogCollection, module_default as auditModule, logAuditEntry };

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

@@ -72,9 +72,60 @@ interface AdminBlockConfig {
   /** Hide from block picker (useful for deprecated blocks) */
   hidden?: boolean;
 }
+interface ListViewLayoutConfig {
+  /** Visual density for row rendering. */
+  density?: "compact" | "comfortable";
+  /** Primary field rendered as the row title. Defaults to collection title. */
+  titleField?: string;
+  /** Secondary field rendered under the title. */
+  subtitleField?: string;
+  /** Fields rendered before the title, typically icons/status markers. */
+  leadingFields?: string[];
+  /** Fields rendered as compact badges near the title. */
+  badgeFields?: string[];
+  /** Fields rendered as muted right-side metadata. */
+  metaFields?: string[];
+}
+type ListViewOutlineLevel = {
+  kind: "field";
+  field: string;
+  labelField?: string;
+  order?: "asc" | "desc" | string[];
+} | {
+  kind: "relation-field";
+  relation: string;
+  field?: string;
+  labelField?: string;
+  order?: "asc" | "desc" | string[];
+} | {
+  kind: "edge";
+  collection: string;
+  parentField: string;
+  childField: string;
+  where?: Record<string, unknown>;
+  groupByEdgeField?: string;
+  repeat?: boolean | {
+    maxDepth?: number;
+  };
+} | {
+  kind: "path";
+  field: string;
+  separator?: string;
+  syntheticFolders?: boolean;
+  repeat?: boolean | {
+    maxDepth?: number;
+  };
+};
+interface ListViewOutlineConfig {
+  levels: ListViewOutlineLevel[];
+  defaultExpanded?: boolean | "roots";
+  maxDepth?: number;
+  showCounts?: boolean;
+  preserveMatchingBranches?: boolean;
+}
 /**
  * List view configuration for a collection.
- * Defines columns, sorting, filtering, and actions.
+ * Defines columns, sorting, filtering, outline grouping, and actions.
  */
 interface ListViewConfig {
   /** View type to use (e.g., "table", "cards") */
@@ -111,6 +162,10 @@ interface ListViewConfig {
     /** Show page-local item counts in group headers */
     showCounts?: boolean;
   };
+  /** Dense flex/list renderer layout hints for list-like views. */
+  layout?: ListViewLayoutConfig;
+  /** Renderer-agnostic multi-level outline/grouping configuration. */
+  outline?: ListViewOutlineConfig;
   /** Actions configuration */
   actions?: {
     header?: {
@@ -375,4 +430,4 @@ interface AdminGlobalConfig {
   audit?: boolean;
 }
 //#endregion
-export { AdminBlockConfig, AdminCollectionConfig, AdminGlobalConfig, BlockCategoryConfig, FieldLayoutItem, FormFieldLayoutItem, FormReactiveConfig, FormReactiveContext, FormReactivePropValue, FormSectionLayout, FormSidebarConfig, FormTabConfig, FormTabsLayout, FormViewConfig, ListViewConfig, PreviewConfig };
+export { AdminBlockConfig, AdminCollectionConfig, AdminGlobalConfig, BlockCategoryConfig, FieldLayoutItem, FormFieldLayoutItem, FormReactiveConfig, FormReactiveContext, FormReactivePropValue, FormSectionLayout, FormSidebarConfig, FormTabConfig, FormTabsLayout, FormViewConfig, ListViewConfig, ListViewLayoutConfig, ListViewOutlineConfig, ListViewOutlineLevel, PreviewConfig };

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

@@ -1,8 +1,9 @@
 import { ActionReference, AdminLocaleConfig, ComponentReference, ComponentType, ComponentTypeRegistry } from "./common.mjs";
-import { AdminBlockConfig, AdminCollectionConfig, AdminGlobalConfig, BlockCategoryConfig, FieldLayoutItem, FormFieldLayoutItem, FormReactiveConfig, FormReactiveContext, FormReactivePropValue, FormSectionLayout, FormSidebarConfig, FormTabConfig, FormTabsLayout, FormViewConfig, ListViewConfig, PreviewConfig } from "./form-layout.mjs";
+import { AdminBlockConfig, AdminCollectionConfig, AdminGlobalConfig, BlockCategoryConfig, FieldLayoutItem, FormFieldLayoutItem, FormReactiveConfig, FormReactiveContext, FormReactivePropValue, FormSectionLayout, FormSidebarConfig, FormTabConfig, FormTabsLayout, FormViewConfig, ListViewConfig, ListViewLayoutConfig, ListViewOutlineConfig, ListViewOutlineLevel, PreviewConfig } from "./form-layout.mjs";
 import { AdminConfigContext, ComponentDefinition, ComponentFactory, EditViewDefinition, EditViewFactory, FilterViewsByKind, FormViewConfigContext, ListViewConfigContext, ListViewDefinition, ListViewFactory, ViewDefinition, ViewKind, ViewKindRegistry } from "./views.mjs";
 import { BrandLogo, DashboardActionFactory, DashboardActionProxy, DashboardCallback, DashboardCallbackContext, DashboardConfigContext, DashboardContribution, DashboardItemDef, DashboardProxy, DashboardSectionDef, ServerBrandingConfig, ServerChartWidget, ServerCustomWidget, ServerDashboardAction, ServerDashboardConfig, ServerDashboardItem, ServerDashboardSection, ServerDashboardTab, ServerDashboardTabs, ServerDashboardWidget, ServerProgressWidget, ServerQuickAction, ServerQuickActionsWidget, ServerRecentItemsWidget, ServerStatsWidget, ServerTableWidget, ServerTimelineWidget, ServerValueWidget, WidgetAccessRule, WidgetFetchContext } from "./dashboard.mjs";
 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";
 
 //#region src/server/augmentation/index.d.ts
@@ -28,6 +29,7 @@ import { ActionsConfigContext, BuiltinActionType, ServerActionContext, ServerAct
 interface AdminConfigInput {
   sidebar?: SidebarContribution;
   dashboard?: DashboardContribution | ServerDashboardConfig;
+  shell?: ServerAdminShellConfig;
   branding?: ServerBrandingConfig;
   locale?: AdminLocaleConfig;
 }

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

@@ -0,0 +1,48 @@
+import { ComponentReference } from "./common.mjs";
+
+//#region src/server/augmentation/shell.d.ts
+
+type AdminShellRailPlacement = "left" | "right";
+interface AdminShellRouteRules {
+  /**
+   * Route prefixes or exact paths where this region should render.
+   * Relative values are resolved against the admin base path.
+   * Empty/omitted include means all admin routes.
+   */
+  include?: string[];
+  /** Route prefixes or exact paths where this region should be hidden. */
+  exclude?: string[];
+  /** How include/exclude rules are matched. Defaults to "prefix". */
+  match?: "prefix" | "exact";
+}
+interface ServerAdminShellRailConfig {
+  /** Client component reference rendered inside the shell rail. */
+  component: ComponentReference;
+  /**
+   * Where to place the rail relative to the main content.
+   * "left" renders between the primary sidebar and content.
+   * @default "left"
+   */
+  placement?: AdminShellRailPlacement;
+  /** CSS width. Numbers are treated as pixels. */
+  width?: number | string;
+  /** CSS min-width. Numbers are treated as pixels. */
+  minWidth?: number | string;
+  /** CSS max-width. Numbers are treated as pixels. */
+  maxWidth?: number | string;
+  /** Hide the rail below the md breakpoint. Defaults to true. */
+  hiddenOnMobile?: boolean;
+  /** Optional route rules controlling where this rail appears. */
+  routes?: AdminShellRouteRules;
+  /** Additional class name for the rail container. */
+  className?: string;
+}
+interface ServerAdminShellConfig {
+  /**
+   * Secondary side region for contextual app UI, such as recent work,
+   * conversations, inspectors, or project switchers.
+   */
+  secondaryRail?: ServerAdminShellRailConfig;
+}
+//#endregion
+export { AdminShellRailPlacement, AdminShellRouteRules, ServerAdminShellConfig, ServerAdminShellRailConfig };

package/dist/server/augmentation.d.mts

@@ -1,7 +1,8 @@
 import { ActionReference, AdminLocaleConfig, ComponentReference, ComponentType, ComponentTypeRegistry } from "./augmentation/common.mjs";
-import { AdminBlockConfig, AdminCollectionConfig, AdminGlobalConfig, BlockCategoryConfig, FieldLayoutItem, FormFieldLayoutItem, FormReactiveConfig, FormReactiveContext, FormReactivePropValue, FormSectionLayout, FormSidebarConfig, FormTabConfig, FormTabsLayout, FormViewConfig, ListViewConfig, PreviewConfig } from "./augmentation/form-layout.mjs";
+import { AdminBlockConfig, AdminCollectionConfig, AdminGlobalConfig, BlockCategoryConfig, FieldLayoutItem, FormFieldLayoutItem, FormReactiveConfig, FormReactiveContext, FormReactivePropValue, FormSectionLayout, FormSidebarConfig, FormTabConfig, FormTabsLayout, FormViewConfig, ListViewConfig, ListViewLayoutConfig, ListViewOutlineConfig, ListViewOutlineLevel, PreviewConfig } from "./augmentation/form-layout.mjs";
 import { AdminConfigContext, ComponentDefinition, ComponentFactory, EditViewDefinition, EditViewFactory, FilterViewsByKind, FormViewConfigContext, ListViewConfigContext, ListViewDefinition, ListViewFactory, ViewDefinition, ViewKind, ViewKindRegistry } from "./augmentation/views.mjs";
 import { BrandLogo, DashboardActionFactory, DashboardActionProxy, DashboardCallback, DashboardCallbackContext, DashboardConfigContext, DashboardContribution, DashboardItemDef, DashboardProxy, DashboardSectionDef, ServerBrandingConfig, ServerChartWidget, ServerCustomWidget, ServerDashboardAction, ServerDashboardConfig, ServerDashboardItem, ServerDashboardSection, ServerDashboardTab, ServerDashboardTabs, ServerDashboardWidget, ServerProgressWidget, ServerQuickAction, ServerQuickActionsWidget, ServerRecentItemsWidget, ServerStatsWidget, ServerTableWidget, ServerTimelineWidget, ServerValueWidget, WidgetAccessRule, WidgetFetchContext } from "./augmentation/dashboard.mjs";
 import { ServerSidebarCollectionItem, ServerSidebarConfig, ServerSidebarDividerItem, ServerSidebarGlobalItem, ServerSidebarItem, ServerSidebarLinkItem, ServerSidebarPageItem, ServerSidebarSection, SidebarCallback, SidebarCallbackContext, SidebarConfigContext, SidebarContribution, SidebarItemDef, SidebarProxy, SidebarSectionDef } from "./augmentation/sidebar.mjs";
+import { AdminShellRailPlacement, AdminShellRouteRules, ServerAdminShellConfig, ServerAdminShellRailConfig } from "./augmentation/shell.mjs";
 import { ActionsConfigContext, BuiltinActionType, ServerActionContext, ServerActionDefinition, ServerActionDownload, ServerActionEffects, ServerActionError, ServerActionForm, ServerActionFormField, ServerActionFormFieldConfig, ServerActionFormFieldDefinition, ServerActionHandler, ServerActionRedirect, ServerActionResult, ServerActionSuccess, ServerActionsConfig } from "./augmentation/actions.mjs";
 import { AdminConfigInput, adminConfig } from "./augmentation/index.mjs";