@rebasepro/admin 0.14.1 → 0.14.2-canary.g27a129e

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rebasepro/admin",
   "type": "module",
-  "version": "0.14.1",
+  "version": "0.14.2-canary.g27a129e",
   "description": "Rebase CMS — content management views, forms, and routing",
   "funding": {
     "url": "https://github.com/sponsors/rebaseco"
@@ -83,14 +83,14 @@
     "react-dropzone": "^19.1.1",
     "react-use-measure": "^2.1.7",
     "zod": "^4.4.3",
-    "@rebasepro/admin-types": "0.14.1",
-    "@rebasepro/forms": "0.14.1",
-    "@rebasepro/app": "0.14.1",
-    "@rebasepro/common": "0.14.1",
-    "@rebasepro/inference": "0.14.1",
-    "@rebasepro/types": "0.14.1",
-    "@rebasepro/ui": "0.14.1",
-    "@rebasepro/utils": "0.14.1"
+    "@rebasepro/forms": "0.14.2-canary.g27a129e",
+    "@rebasepro/common": "0.14.2-canary.g27a129e",
+    "@rebasepro/admin-types": "0.14.2-canary.g27a129e",
+    "@rebasepro/app": "0.14.2-canary.g27a129e",
+    "@rebasepro/types": "0.14.2-canary.g27a129e",
+    "@rebasepro/utils": "0.14.2-canary.g27a129e",
+    "@rebasepro/ui": "0.14.2-canary.g27a129e",
+    "@rebasepro/inference": "0.14.2-canary.g27a129e"
   },
   "peerDependencies": {
     "react": ">=19.2.7",

package/src/collection_editor/serializable_types.ts

@@ -432,6 +432,12 @@ export interface SerializableCollectionConfig {
     defaultEntityAction?: "view" | "edit";
     defaultViewMode?: ViewMode;
     enabledViews?: ViewMode[];
+    /**
+     * Keys only. A custom view declared inline carries a `Builder` function,
+     * which does not survive a round trip through a config file — the editor
+     * can reference app-registered views, not author new ones.
+     */
+    customViews?: string[];
     kanban?: KanbanConfig<Record<string, unknown>>;
     defaultSize?: CollectionSize;
     sideDialogWidth?: number | string;

package/src/collection_editor/serializable_utils.ts

@@ -501,6 +501,14 @@ export function toSerializableCollectionConfig(collection: AdminCollection): Ser
     if (collection.previewProperties) result.previewProperties = collection.previewProperties;
     if (collection.listProperties) result.listProperties = collection.listProperties;
     if (collection.enabledViews) result.enabledViews = collection.enabledViews;
+    // Inline views are dropped rather than mangled: their `Builder` cannot be
+    // serialized, and writing back a half of one would delete it from the
+    // running config. Keys survive, so a collection edited in the panel keeps
+    // whichever registered views it named.
+    if (collection.customViews) {
+        const keys = collection.customViews.filter((v): v is string => typeof v === "string");
+        if (keys.length > 0) result.customViews = keys;
+    }
     if (collection.disableDefaultActions) result.disableDefaultActions = collection.disableDefaultActions;
     if (collection.securityRules) result.securityRules = collection.securityRules;
     if (isRelationalCollectionConfig(collection) && collection.disableDefaultPolicies !== undefined) {

package/src/collection_editor/ui/collection_editor/ViewModeSwitch.tsx

@@ -1,4 +1,4 @@
-import { ViewMode } from "@rebasepro/admin-types";
+import { CollectionCustomView, ViewMode } from "@rebasepro/admin-types";
 import {
     cls,
     KanbanIcon,
@@ -8,6 +8,7 @@ import {
     ToggleButtonGroup,
     Typography
 } from "@rebasepro/ui";
+import { getIcon, useCustomizationController } from "@rebasepro/app";
 
 export function ViewModeSwitch({
     value,
@@ -19,6 +20,14 @@ export function ViewModeSwitch({
     className?: string;
 }) {
 
+    const customizationController = useCustomizationController();
+
+    // Only app-registered views are offerable here. A view declared inline on
+    // a collection carries a `Builder` function, which the editor cannot write
+    // back into a config file — registering it on `<RebaseAdmin>` and naming
+    // the key is what makes it editable, the same bargain `entityViews` makes.
+    const registeredViews: CollectionCustomView[] = customizationController.collectionViews ?? [];
+
     return <div className={cls(className)}>
         <Typography variant={"label"} color={"secondary"} className={"ml-3.5"}>Default collection view</Typography>
         <div className={"my-2"}>
@@ -45,7 +54,12 @@ export function ViewModeSwitch({
                         value: "kanban",
                         label: "Kanban",
                         icon: <KanbanIcon/>
-                    }
+                    },
+                    ...registeredViews.map((view) => ({
+                        value: view.key,
+                        label: view.name,
+                        icon: getIcon(view.icon) ?? <ListIcon/>
+                    }))
                 ]}
             />
         </div>

package/src/components/CollectionEditorDialogs.tsx

@@ -1,15 +1,16 @@
-import React, { lazy, Suspense } from "react";
+import React, { Suspense } from "react";
+import { lazyChunk } from "@rebasepro/ui";
 import { useCollectionEditorDialogsState } from "../collection_editor/CollectionEditorDialogsContext";
 
 // Dynamic imports targeting the separate collection_editor_ui entry point.
 // This ensures the heavy editor UI lands in its own chunk and is only fetched
 // when a dialog is actually opened.
-const CollectionEditorDialog = lazy(() =>
+const CollectionEditorDialog = lazyChunk(() =>
     import("../collection_editor/ui/collection_editor/CollectionEditorDialog")
         .then(m => ({ default: m.CollectionEditorDialog }))
 );
 
-const PropertyFormDialog = lazy(() =>
+const PropertyFormDialog = lazyChunk(() =>
     import("../collection_editor/ui/collection_editor/PropertyEditView")
         .then(m => ({ default: m.PropertyFormDialog }))
 );

package/src/components/CollectionViewBinding/CollectionViewActions.tsx

@@ -1,16 +1,16 @@
 
 
-import React, { lazy, Suspense } from "react";
+import React, { Suspense } from "react";
 
 import { useLargeLayout, useTranslation, useSlot, resolveComponentRef } from "@rebasepro/app";
 import { CollectionActionsProps, EntityTableController, SelectionController, AdminCollection } from "@rebasepro/admin-types";
-import { Button, IconButton, Tooltip, Popover, iconSize } from "@rebasepro/ui";
+import { Button, IconButton, Tooltip, Popover, iconSize, lazyChunk } from "@rebasepro/ui";
 import { ErrorBoundary, Link2Icon, MoreVerticalIcon, PlusIcon, Trash2Icon } from "@rebasepro/ui";
 import { usePermissions } from "@rebasepro/app";
 import { toArray } from "@rebasepro/utils";
 // Lazy-load import/export — pulls in exceljs only on demand
-const ImportCollectionAction = lazy(() => import("../../data_import/import").then(m => ({ default: m.ImportCollectionAction })));
-const ExportCollectionAction = lazy(() => import("../../data_export/export").then(m => ({ default: m.ExportCollectionAction })));
+const ImportCollectionAction = lazyChunk(() => import("../../data_import/import").then(m => ({ default: m.ImportCollectionAction })));
+const ExportCollectionAction = lazyChunk(() => import("../../data_export/export").then(m => ({ default: m.ExportCollectionAction })));
 import { EditorCollectionAction } from "../../collection_editor/ui/EditorCollectionAction";
 import { useCollectionEditorController } from "../../collection_editor/useCollectionEditorController";
 import { useAdminContext } from "../../hooks/useAdminContext";

package/src/components/CollectionViewBinding/CollectionViewBinding.tsx

@@ -8,6 +8,7 @@ import {
     getCollectionDataPath
 } from "@rebasepro/types";
 import {
+    CollectionCustomViewParams,
     CollectionSize,
     EntityTableController,
     PartialCollectionConfig,
@@ -23,7 +24,7 @@ import { getEntityChildViews } from "@rebasepro/common";
 import { useCollectionInlineEditor } from "./hooks/useCollectionInlineEditor";
 import { navigateToEntity } from "../../util/navigation_utils";
 import { mergeEntityActions } from "../../util/entity_actions";
-import { resolveEntityAction } from "../../util/resolutions";
+import { resolveCollectionViews, resolveEntityAction } from "../../util/resolutions";
 import { getPropertyInPath } from "../../util/property_utils";
 import { ReferencePreview } from "../../preview";
 import {
@@ -74,7 +75,7 @@ import { DeleteEntityDialog } from "../DeleteEntityDialog";
 import { useSelectionController } from "./useSelectionController";
 import { CollectionViewStartActions } from "./CollectionViewStartActions";
 import { addRecentId, getRecentIds } from "./utils";
-import { isViewMode, OpenEntityMode, resolveOpenEntityMode, VIEW_MODE_PARAM } from "../../util/view_mode";
+import { isViewMode, OpenEntityMode, resolveOpenEntityMode, VIEW_MODE_PARAM, VIEW_MODES } from "../../util/view_mode";
 import { mergeDeep } from "@rebasepro/utils";
 import { useBreadcrumbsController } from "../../hooks/useBreadcrumbsController";
 import { useAdminContext } from "../../hooks/useAdminContext";
@@ -83,7 +84,7 @@ import { useSidePanel } from "../../hooks/useSidePanel";
 import { useUrlController } from "../../hooks/navigation/contexts/UrlContext";
 import { useChildViewSource } from "../../hooks/useChildViewSource";
 import { useSelectionDialog } from "../../hooks/useSelectionDialog";
-import { saveEntityWithCallbacks } from "@rebasepro/app";
+import { resolveComponentRef, saveEntityWithCallbacks } from "@rebasepro/app";
 
 const EMPTY_ARRAY: never[] = [];
 
@@ -250,21 +251,47 @@ const CollectionViewBindingInner = React.memo(
 
         const [popOverOpen, setPopOverOpen] = useState(false);
 
+        // Custom view modes this collection can render: the ones declared
+        // inline plus the ones it names by key from the app-level registry.
+        // Anything unresolvable is dropped here, once, so every consumer below
+        // — the switcher, `enabledViews`, the URL and saved-config checks —
+        // agrees on what exists.
+        const resolvedCustomViews = useMemo(
+            () => resolveCollectionViews(collection.customViews, customizationController.collectionViews),
+            [collection.customViews, customizationController]
+        );
+
+        const customViewKeys = useMemo(
+            () => resolvedCustomViews.map((v) => v.key),
+            [resolvedCustomViews]
+        );
+
         // View mode priority: URL > saved user config > collection.defaultViewMode
-        const defaultViewMode = collection.defaultViewMode ?? "list";
+        const defaultViewMode = isViewMode(collection.defaultViewMode, customViewKeys)
+            ? collection.defaultViewMode
+            // Covers a `defaultViewMode` naming a custom view that has since
+            // been removed from config; without this the collection would open
+            // on a mode nothing renders.
+            : "list";
         const [searchParams, setSearchParams] = useSearchParams();
 
         // Read view from React Router's searchParams (reactive on back/forward)
         const urlView = useMemo((): ViewMode | null => {
             const v = searchParams.get(VIEW_MODE_PARAM);
-            return isViewMode(v) ? v : null;
-        }, [searchParams]);
-
-        // Get saved view from local persistence
+            return isViewMode(v, customViewKeys) ? v : null;
+        }, [searchParams, customViewKeys]);
+
+        // Get saved view from local persistence.
+        //
+        // Validated rather than cast: what is stored is whatever the user last
+        // picked, and a custom view removed from config since then would come
+        // back as a mode nothing renders — a blank panel with a working
+        // toolbar above it. An unrecognised value reads as "nothing saved",
+        // which falls through to the collection default.
         const getSavedView = useCallback((): ViewMode | null => {
             const saved = userConfigPersistence?.getCollectionConfig<M>(path)?.defaultViewMode;
-            return (saved as ViewMode) ?? null;
-        }, [userConfigPersistence, path]);
+            return isViewMode(saved, customViewKeys) ? saved : null;
+        }, [userConfigPersistence, path, customViewKeys]);
 
         const [viewMode, setViewModeState] = useState<ViewMode>(() => {
             // Priority: URL > saved config > collection default
@@ -274,9 +301,15 @@ const CollectionViewBindingInner = React.memo(
             return defaultViewMode;
         });
 
+        const activeCustomView = useMemo(
+            () => resolvedCustomViews.find((v) => v.key === viewMode),
+            [resolvedCustomViews, viewMode]
+        );
+
         const openEntityMode = resolveOpenEntityMode({
             collection,
-            viewMode
+            viewMode,
+            customView: activeCustomView
         });
 
         // Sync URL with current view on init (if view came from saved config)
@@ -335,6 +368,12 @@ const CollectionViewBindingInner = React.memo(
         // Table view size state - controls row height
         const [tableSize, setTableSize] = useState<CollectionSize>(collection.defaultSize ?? "m");
 
+        // Size for custom views that opted in with `sizeable`. One piece of
+        // state for all of them: only the active view reads it, and switching
+        // between two sizeable custom views keeping the same density is the
+        // less surprising behaviour.
+        const [customViewSize, setCustomViewSize] = useState<CollectionSize>(collection.defaultSize ?? "m");
+
         const selectionController = useSelectionController<M>();
         const usedSelectionController = collection.selectionController ?? selectionController;
         const {
@@ -513,7 +552,7 @@ parentEntityIds: parentEntityIds ?? EMPTY_ARRAY,
             onNewClick
         });
 
-        const pluginInsights = useSlot("collection.insights", {
+        const pluginWidgets = useSlot("collection.widgets", {
             path,
             parentCollectionSlugs: parentCollectionSlugs ?? EMPTY_ARRAY,
 parentEntityIds: parentEntityIds ?? EMPTY_ARRAY,
@@ -587,19 +626,26 @@ parentEntityIds: parentEntityIds ?? EMPTY_ARRAY,
         }, [collection.kanban?.columnProperty, resolvedCollection.properties]);
 
         // Compute the effective enabled views:
-        // - Start from collection.enabledViews (defaults to all three)
+        // - Start from collection.enabledViews (defaults to every built-in
+        //   plus every custom view the collection declared)
+        // - Drop anything that resolves to nothing renderable
         // - Filter out kanban if no enum properties exist
         const hasEnumProperty = useMemo(() => {
             return Object.values(resolvedCollection.properties).some((p: Property) => p.type === "string" && "enum" in p && p.enum);
         }, [resolvedCollection.properties]);
 
         const enabledViews: ViewMode[] = useMemo(() => {
-            const configured = collection.enabledViews ?? ["list", "table", "cards", "kanban"];
+            // Declaring a custom view is enough to offer it — a collection
+            // should not have to restate the built-ins in `enabledViews` just
+            // to add one. Setting `enabledViews` explicitly still wins.
+            const configured = collection.enabledViews
+                ?? [...VIEW_MODES, ...customViewKeys];
+            const renderable = configured.filter(v => isViewMode(v, customViewKeys));
             if (!hasEnumProperty) {
-                return configured.filter(v => v !== "kanban");
+                return renderable.filter(v => v !== "kanban");
             }
-            return configured;
-        }, [collection.enabledViews, hasEnumProperty]);
+            return renderable;
+        }, [collection.enabledViews, hasEnumProperty, customViewKeys]);
 
         // Compute available enum properties for kanban column selection
         const kanbanPropertyOptions: KanbanPropertyOption[] = useMemo(() => {
@@ -938,8 +984,9 @@ parentEntityIds: parentEntityIds ?? EMPTY_ARRAY
                 viewMode={viewMode}
                 onViewModeChange={onViewModeChange}
                 enabledViews={enabledViews}
-                size={viewMode === "list" ? listSize : viewMode === "table" ? tableSize : viewMode === "cards" ? cardSize : undefined}
-                onSizeChanged={viewMode === "list" ? onListSizeChanged : viewMode === "table" ? onTableSizeChanged : viewMode === "cards" ? setCardSize : undefined}
+                customViews={resolvedCustomViews}
+                size={activeCustomView ? (activeCustomView.sizeable ? customViewSize : undefined) : viewMode === "list" ? listSize : viewMode === "table" ? tableSize : viewMode === "cards" ? cardSize : undefined}
+                onSizeChanged={activeCustomView ? (activeCustomView.sizeable ? setCustomViewSize : undefined) : viewMode === "list" ? onListSizeChanged : viewMode === "table" ? onTableSizeChanged : viewMode === "cards" ? setCardSize : undefined}
                 open={viewModePopoverOpen}
                 onOpenChange={setViewModePopoverOpen}
                 kanbanPropertyOptions={kanbanPropertyOptions}
@@ -1014,7 +1061,37 @@ parentEntityIds,
                     </ResolvedCollectionActions>
                 }
             />
-        ); const innerView = viewMode === "kanban" ? (
+        );
+
+        // A custom view wins over the built-in chain, but only after the
+        // built-in keys have been ruled out — `resolveCollectionViews` refuses
+        // a view keyed "table", so this cannot shadow one.
+        const CustomViewBuilder = activeCustomView
+            ? resolveComponentRef<CollectionCustomViewParams<M>>(activeCustomView.Builder)
+            : undefined;
+
+        const innerView = CustomViewBuilder ? (
+            <ErrorBoundary>
+                <CustomViewBuilder
+                    key={`custom-view-${activeCustomView!.key}-${path}`}
+                    collection={collection}
+                    tableController={tableController}
+                    path={path}
+                    parentCollectionSlugs={parentCollectionSlugs}
+                    parentEntityIds={parentEntityIds}
+                    onEntityClick={onEntityClick}
+                    onNewClick={canCreateEntities ? onNewClick : undefined}
+                    canCreate={canCreateEntities}
+                    selectionController={usedSelectionController}
+                    selectionEnabled={selectionEnabled}
+                    highlightedEntities={highlightedEntity ? [highlightedEntity] : []}
+                    deletedEntities={deletedEntities}
+                    emptyComponent={emptyComponent}
+                    size={activeCustomView!.sizeable ? customViewSize : undefined}
+                    viewMode={viewMode}
+                />
+            </ErrorBoundary>
+        ) : viewMode === "kanban" ? (
             <CollectionBoardViewBinding
                 key={`kanban-view-${path}-${selectedKanbanProperty}`}
                 collection={collection}
@@ -1124,7 +1201,7 @@ parentEntityIds,
                             </Typography>
                         </div>
                     </div>
-                    {pluginInsights.length > 0 && (
+                    {pluginWidgets.length > 0 && (
                         <div
                             className={cls(
                                 "grid transition-[grid-template-rows] duration-150 ease-out",
@@ -1132,7 +1209,7 @@ parentEntityIds,
                             )}
                         >
                             <div className="overflow-hidden flex-shrink-0">
-                                {pluginInsights}
+                                {pluginWidgets}
                             </div>
                         </div>
                     )}

package/src/components/CollectionViewBinding/ViewModeToggle.tsx

@@ -1,6 +1,6 @@
 
 import React, { useMemo } from "react";
-import { CollectionSize, ViewMode } from "@rebasepro/admin-types";
+import { CollectionCustomView, CollectionSize, ViewMode } from "@rebasepro/admin-types";
 import {
     Button,
     ColumnsIcon,
@@ -15,7 +15,7 @@ import {
     ToggleButtonGroup,
     ToggleButtonOption
 } from "@rebasepro/ui";
-import { useTranslation } from "@rebasepro/app";
+import { getIcon, useTranslation } from "@rebasepro/app";
 
 export type KanbanPropertyOption = {
     key: string;
@@ -26,11 +26,17 @@ export type ViewModeToggleProps = {
     viewMode?: ViewMode;
     onViewModeChange?: (mode: ViewMode) => void;
     /**
-     * Which view modes are enabled for this collection.
-     * Only these modes will appear in the toggle.
-     * Defaults to all three: ["table", "cards", "kanban"].
+     * Which view modes are enabled for this collection, in the order they
+     * should appear. Only these modes appear in the toggle.
+     * Defaults to the four built-ins.
      */
     enabledViews?: ViewMode[];
+    /**
+     * Custom views this collection can render, already resolved. Their `key`s
+     * appear in `enabledViews` alongside the built-ins, and each supplies the
+     * name and icon its entry is drawn with.
+     */
+    customViews?: CollectionCustomView<any>[];
     /**
      * Current size for card/table views
      */
@@ -67,6 +73,7 @@ export function ViewModeToggle({
     viewMode = "table",
     onViewModeChange,
     enabledViews = ALL_VIEW_MODES,
+    customViews,
     size,
     onSizeChanged,
     open,
@@ -85,7 +92,16 @@ export function ViewModeToggle({
     // labelled buttons open the toolbar together, and at 16 against its 20 this
     // one read as the smaller of the pair. The options inside the popover stay
     // at `smallest`, which is the size every other menu icon uses.
+    const activeCustomView = customViews?.find((v) => v.key === viewMode);
+
     const getViewModeIcon = () => {
+        if (activeCustomView) {
+            // Falls back to the list glyph rather than rendering nothing, so a
+            // custom view that declared no icon still gets a trigger the same
+            // width as every other mode's.
+            return getIcon(activeCustomView.icon, undefined, undefined, "small")
+                ?? <ListIcon size={iconSize.small}/>;
+        }
         if (viewMode === "kanban") return <KanbanIcon size={iconSize.small}/>;
         if (viewMode === "cards") return <LayoutGridIcon size={iconSize.small}/>;
         if (viewMode === "table") return <TableIcon size={iconSize.small}/>;
@@ -93,51 +109,69 @@ export function ViewModeToggle({
     };
 
     const getViewModeName = () => {
+        // The declared name, untranslated — it is app-supplied copy, and there
+        // is no key for it in the admin's bundles.
+        if (activeCustomView) return activeCustomView.name;
         if (viewMode === "kanban") return t("board");
         if (viewMode === "cards") return t("cards");
         if (viewMode === "table") return t("table_view_mode");
         return t("list");
     };
 
-    const showSizeSelector = size && onSizeChanged && (viewMode === "list" || viewMode === "table" || viewMode === "cards");
+    const showSizeSelector = size && onSizeChanged &&
+        (activeCustomView
+            ? activeCustomView.sizeable
+            : viewMode === "list" || viewMode === "table" || viewMode === "cards");
     const showKanbanPropertySelector = viewMode === "kanban" &&
         kanbanPropertyOptions &&
         kanbanPropertyOptions.length > 0 &&
         onKanbanPropertyChange;
 
-    // Build toggle options
+    // Build toggle options, in `enabledViews` order.
+    //
+    // This used to return all four built-ins unconditionally: `enabledViews`
+    // was destructured and then read nowhere, so a collection that asked for
+    // `["list", "table"]` still offered cards and kanban, and picking one
+    // rendered it. Honouring the prop is what the doc comment always claimed,
+    // and it is what lets a custom-only `enabledViews` hide the switcher.
     const viewModeOptions: ToggleButtonOption<ViewMode>[] = useMemo(() => {
-        const allOptions: ToggleButtonOption<ViewMode>[] = [
-            {
-                value: "list",
-                label: t("list"),
-                icon: <ListIcon size={iconSize.smallest}/>
-            },
-            {
-                value: "table",
-                label: t("table_view_mode"),
-                icon: <TableIcon size={iconSize.smallest}/>
-            },
-            {
-                value: "cards",
-                label: t("cards"),
-                icon: <LayoutGridIcon size={iconSize.smallest}/>
-            },
-            {
-                value: "kanban",
-                label: t("board"),
-                icon: <KanbanIcon size={iconSize.smallest}/>
-            }
-        ];
-
-        return allOptions;
-    }, [t]);
+        const builtIns: Record<string, { label: string, icon: React.ReactNode }> = {
+            list: { label: t("list"), icon: <ListIcon size={iconSize.smallest}/> },
+            table: { label: t("table_view_mode"), icon: <TableIcon size={iconSize.smallest}/> },
+            cards: { label: t("cards"), icon: <LayoutGridIcon size={iconSize.smallest}/> },
+            kanban: { label: t("board"), icon: <KanbanIcon size={iconSize.smallest}/> }
+        };
+
+        return enabledViews.flatMap((mode) => {
+            const builtIn = builtIns[mode];
+            if (builtIn) return [{ value: mode, ...builtIn }];
+
+            const custom = customViews?.find((v) => v.key === mode);
+            // An `enabledViews` entry naming nothing registered is skipped
+            // rather than drawn as a nameless button.
+            if (!custom) return [];
+            return [{
+                value: mode,
+                label: custom.name,
+                icon: getIcon(custom.icon, undefined, undefined, "smallest")
+                    ?? <ListIcon size={iconSize.smallest}/>
+            }];
+        });
+    }, [t, enabledViews, customViews]);
 
     // ── Guard (after hooks to preserve Rules of Hooks) ──────────────
     if (!onViewModeChange) {
         return null;
     }
 
+    // Nothing to switch between and nothing else in the popover: a trigger
+    // that opens an empty panel is worse than no trigger. The size and
+    // group-by selectors live behind the same button, so a single-mode
+    // collection that still has one of those keeps it.
+    if (viewModeOptions.length <= 1 && !showSizeSelector && !showKanbanPropertySelector) {
+        return null;
+    }
+
     return (
         <div className="overflow-visible">
             <Popover

package/src/components/EntityInspector.tsx

@@ -1,7 +1,7 @@
 import type { AdminCollection } from "@rebasepro/admin-types";
 import type { Entity } from "@rebasepro/types";
 import type { FormContext } from "../types/fields";
-import React, { lazy, Suspense, useEffect } from "react";
+import React, { Suspense, useEffect } from "react";
 import {
     CircularProgressCenter,
     cls,
@@ -9,6 +9,7 @@ import {
     ErrorBoundary,
     IconButton,
     iconSize,
+    lazyChunk,
     Tab,
     Tabs,
     XIcon
@@ -16,7 +17,7 @@ import {
 import { useTranslation } from "@rebasepro/app";
 import { JsonPreviewBinding } from "./JsonPreviewBinding";
 
-const EntityHistoryView = lazy(() => import("./history").then(m => ({ default: m.EntityHistoryView })));
+const EntityHistoryView = lazyChunk(() => import("./history").then(m => ({ default: m.EntityHistoryView })));
 
 export type InspectorTab = "json" | "history";
 

package/src/components/HomePage/NavigationCardBinding.tsx

@@ -76,7 +76,7 @@ export function NavigationCardBinding({
         context
     });
 
-    const pluginCardInsights = useSlot("home.card.insight", {
+    const pluginCardWidgets = useSlot("home.card.widget", {
         slug: slug,
         collection: collection!,
         context
@@ -92,7 +92,7 @@ export function NavigationCardBinding({
         name={name}
         description={description}
         actions={actions}
-        additionalContent={pluginCardInsights.length > 0 ? <>{pluginCardInsights}</> : undefined}
+        additionalContent={pluginCardWidgets.length > 0 ? <>{pluginCardWidgets}</> : undefined}
         onClick={() => {
             onClick?.();
             navigate(url);

package/src/components/RebaseAdmin.tsx

@@ -10,7 +10,7 @@ import type { RebaseAdminConfig } from "@rebasepro/admin-types";
  * is auto-wired as a native feature (slots, provider, Studio view) without
  * needing any external plugin.
  */
-export function RebaseAdmin({ collections, views, homePage, entityViews, entityActions, collectionEditor, navigationGroupMappings, basePath }: RebaseAdminConfig) {
+export function RebaseAdmin({ collections, views, homePage, entityViews, collectionViews, entityActions, collectionEditor, navigationGroupMappings, basePath }: RebaseAdminConfig) {
     const dispatch = useRebaseRegistryDispatch();
 
     useLayoutEffect(() => {
@@ -18,12 +18,13 @@ export function RebaseAdmin({ collections, views, homePage, entityViews, entityA
 views,
 homePage,
 entityViews,
+collectionViews,
 entityActions,
 collectionEditor,
 navigationGroupMappings,
 basePath });
         return () => dispatch.unregisterAdmin();
-    }, [dispatch, collections, views, homePage, entityViews, entityActions, collectionEditor, navigationGroupMappings, basePath]);
+    }, [dispatch, collections, views, homePage, entityViews, collectionViews, entityActions, collectionEditor, navigationGroupMappings, basePath]);
 
     return null;
 }