@rebasepro/app 0.13.0 → 0.13.1-canary.g249daa1

package/dist/index.es.js

@@ -1,19 +1,19 @@
 import React, { createContext, lazy, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Alert, AlertCircleIcon, AlertTriangleIcon, AppWindow, ArrowDownIcon, ArrowLeftIcon, ArrowRightLeftIcon, ArrowUpDownIcon, ArrowUpIcon, Avatar, BooleanSwitch, Button, CalendarIcon, Card, CenteredView, CheckCircle2Icon, CheckIcon, Checkbox, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronsLeftIcon, ChevronsRightIcon, Chip, CircleDotIcon, CircleUserIcon, CircularProgress, ColumnsIcon, Container, Dialog, DialogActions, DialogContent, DialogTitle, DollarSignIcon, ErrorBoundary, FileIcon, FileTextIcon, FilterChip, FilterIcon, FolderIcon, FolderKanbanIcon, IconButton, KanbanIcon, KanbanView, LanguagesIcon, LayoutGridIcon, ListIcon, ListPlusIcon, ListTodoIcon, LoadingButton, LogOutIcon, MailIcon, Menu, MenuItem, MessageCircleIcon, MoonIcon, MultiSelect, MultiSelectItem, PanelLeftIcon, Paper, PenLineIcon, PencilIcon, PhoneIcon, PinIcon, PlusIcon, Popover, RefreshCwIcon, SearchBar, Select, SelectItem, Separator, SettingsIcon, Skeleton, StickyNoteIcon, SunIcon, SunMoonIcon, Tab, Table, TableBody, TableCell, TableHeader, TableRow, Tabs, TagIcon, TextField, ToggleButtonGroup, Tooltip, Trash2Icon, TrendingUpIcon, TypeIcon, Typography, UserIcon, UserPlus, UsersIcon, VideoIcon, Wand2Icon, WrenchIcon, XIcon, cls, colorClassesMapping, coolIconKeys, defaultBorderMixin, getColorSchemeForKey, getColorSchemeForSeed, iconKeys, iconSize, lucideIcons } from "@rebasepro/ui";
 import { ALL_WHERE_FILTER_OPS, DEFAULT_DATA_SOURCE_KEY, DEFAULT_FILTERABLE_RELATION_KINDS, DEFAULT_STORAGE_SOURCE_KEY, EntityReference, EntityRelation, GeoPoint, RebaseApiError, Vector, getDataSourceCapabilities, isLazyComponentRef, isRelationalCollectionConfig } from "@rebasepro/types";
+import { UNRENDERED_SLOTS, resolveAdminCollection } from "@rebasepro/admin-types";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { SnackbarProvider as SnackbarProvider$1, useSnackbar } from "notistack";
-import { buildRebaseData, canCreateEntity, canDeleteEntity, canEditEntity, canReadCollection, evaluateCondition, getEntityChildViews, getLabelOrConfigFrom, getPrimaryKeys, getSubcollections, isPropertyBuilder, resolveStorageFilenameString, resolveStoragePathString, resolveStorageSource, stripCollectionPath, wrapAsEntityData, wrapAsSdkData } from "@rebasepro/common";
+import { buildRebaseData, canCreateEntity, canDeleteEntity, canEditEntity, canReadCollection, evaluateCondition, getChildViewDeclaringProperties, getChildViewRelationPropertyKeys, getEntityChildViews, getLabelOrConfigFrom, getPrimaryKeys, getSubcollections, isPropertyBuilder, resolveStorageFilenameString, resolveStoragePathString, resolveStorageSource, stripCollectionPath, wrapAsEntityData, wrapAsSdkData } from "@rebasepro/common";
 import { getTitlePropertyKey as getTitlePropertyKey$1, removeInitialAndTrailingSlashes as removeInitialAndTrailingSlashes$1 } from "@rebasepro/app";
 import { Link, Routes, createBrowserRouter, useBlocker, useLocation } from "react-router";
-import { generateForeignKeyName, hashString, isObject, isPlainObject, mergeDeep, randomString, slugify } from "@rebasepro/utils";
+import { generateForeignKeyName, hashString, isArrayValue, isObject, isPlainObject, isRecordValue, mergeDeep, randomString, readStoredJson, slugify, writeStoredJson } from "@rebasepro/utils";
 import { I18nextProvider, initReactI18next, useTranslation as useTranslation$1 } from "react-i18next";
 import { deepEqual } from "fast-equals";
 import i18next from "i18next";
 import { RouterProvider } from "react-router/dom";
 import Fuse from "fuse.js";
 import Compressor from "compressorjs";
-import { resolveAdminCollection } from "@rebasepro/admin-types";
 //#region src/core/PluginProviderStack.tsx
 /**
 * Wraps children with all provider components from plugins that match the given scope.
@@ -414,6 +414,116 @@ function SchemaDriftBanner({ className }) {
 	});
 }
 //#endregion
+//#region src/hooks/data/collectionQuery.ts
+/**
+* Build the parameters for one collection read.
+*
+* Derived options live here rather than at the call sites, so they cannot
+* disagree: `searchExplain` rides along exactly when there is a search string
+* to explain, which is also the only time it costs anything.
+*/
+function toFindParams(input) {
+	const { searchString, ...rest } = input;
+	return {
+		...rest,
+		...searchString ? {
+			searchString,
+			searchExplain: true
+		} : {}
+	};
+}
+//#endregion
+//#region src/collections/summary-property.ts
+/**
+* Whether a property can stand in for a record in *one line*.
+*
+* Preview surfaces — the reference card, a list row, a board card — have a
+* single line per property and no way to grow. That is a constraint on the
+* *value*, not on the property's importance: a Markdown biography is the most
+* interesting column on an author, and it is still the wrong thing to paste
+* into a 44px card. Ranking it here means the picker can skip it without
+* anyone having to configure their way out of a broken card.
+*
+* Kept beside {@link getTitlePropertyCandidates} because the two answer
+* neighbouring questions — "what is this record called" and "what else can be
+* said about it in a line" — from the same property schema.
+*
+* @group Collections
+*/
+var SUMMARY_RANK = {
+	/**
+	* No single-line form exists. A map renders as a key/value table and an
+	* array of maps as a stack of them; there is no first line to take.
+	*/
+	UNUSABLE: 0,
+	/**
+	* Readable in one line, but only as an excerpt — the property holds a
+	* document, and the line is its opening. Worth showing when nothing better
+	* is available, never in preference to a value that fits whole.
+	*/
+	EXCERPT: 1,
+	/** Short and self-contained: the line *is* the value. */
+	DIRECT: 2
+};
+/**
+* File-storage backed content (single image, array of images, generic upload…).
+* Preview surfaces give these their own image slot, so they are never also a
+* text line.
+*
+* @group Collections
+*/
+function isStorageProperty(property) {
+	if (!property) return false;
+	if (property.type === "string" && (property.storage || property.admin?.urlPreview === "image")) return true;
+	if (property.type === "array" && property.of && !Array.isArray(property.of)) {
+		const inner = property.of;
+		if (inner.type === "string" && (inner.storage || inner.admin?.urlPreview === "image")) return true;
+	}
+	return false;
+}
+/**
+* True when the property holds free text long enough to be a document rather
+* than a value — Markdown, or an explicitly multi-line string.
+*
+* @group Collections
+*/
+function isLongTextProperty(property) {
+	if (!property || property.type !== "string") return false;
+	return Boolean(property.admin?.markdown || property.admin?.multiline);
+}
+/**
+* How well a property reads as one line of a preview. See {@link SUMMARY_RANK}.
+*
+* Decided from the property *schema* only: no values are consulted, so the
+* answer is stable for a collection and can be memoised per collection rather
+* than per row.
+*
+* @group Collections
+*/
+function rankSummaryProperty(property) {
+	if (!property) return SUMMARY_RANK.UNUSABLE;
+	if (isStorageProperty(property)) return SUMMARY_RANK.UNUSABLE;
+	if (property.type === "map") return SUMMARY_RANK.UNUSABLE;
+	if (property.type === "array") {
+		if (Array.isArray(property.of)) return SUMMARY_RANK.UNUSABLE;
+		if (!property.of) return property.oneOf ? SUMMARY_RANK.UNUSABLE : SUMMARY_RANK.DIRECT;
+		const innerRank = rankSummaryProperty(property.of);
+		if (innerRank === SUMMARY_RANK.UNUSABLE) return SUMMARY_RANK.UNUSABLE;
+		if (innerRank === SUMMARY_RANK.EXCERPT) return SUMMARY_RANK.UNUSABLE;
+		return SUMMARY_RANK.DIRECT;
+	}
+	if (isLongTextProperty(property)) return SUMMARY_RANK.EXCERPT;
+	return SUMMARY_RANK.DIRECT;
+}
+/**
+* True when the property has any single-line form at all.
+*
+* @group Collections
+*/
+function canSummariseProperty(property) {
+	return rankSummaryProperty(property) !== SUMMARY_RANK.UNUSABLE;
+}
+//#endregion
 //#region src/util/previews.ts
 function isReferenceProperty(property) {
 	if (!property) return null;
@@ -434,35 +544,47 @@ function isHiddenProperty(property) {
 	return Boolean(property.admin?.hideFromCollection);
 }
 /**
-* Returns true when the property holds file-storage content (single image,
-* array of images, generic upload, …).  These properties are rendered by the
-* dedicated image-slot and should NOT appear as regular preview columns.
+* The properties a preview surface should render for a record, best first.
+*
+* Three things decide the answer, in this order:
+*
+* 1. `previewProperties` — passed in, or declared on the collection. A stated
+*    list is returned verbatim, ranking and limit included: a developer who
+*    asks for the Markdown biography gets the Markdown biography.
+* 2. Whether the value has a one-line form at all. A map renders as a
+*    key/value table and a Markdown field as a document; neither fits a card
+*    line, so they never take a slot from a value that does. See
+*    {@link rankSummaryProperty}.
+* 3. `propertiesOrder`, which breaks ties.
+*
+* The middle step is the one that is easy to get wrong by leaving out.
+* `propertiesOrder` states the *column* order of a collection table — it is
+* not a statement that the first three columns summarise a record, and reading
+* it as one is how a card ends up rendering somebody's entire biography.
 */
-function isStorageProperty$1(property) {
-	if (!property) return false;
-	if (property.type === "string" && property.storage) return true;
-	if (property.type === "string" && property.admin?.urlPreview === "image") return true;
-	if (property.type === "array" && property.of && !Array.isArray(property.of)) {
-		const inner = property.of;
-		if (inner.type === "string" && (inner.storage || inner.admin?.urlPreview === "image")) return true;
-	}
-	return false;
-}
 function getEntityPreviewKeys(authController, targetCollection, fields, previewProperties, limit = 3) {
 	const allProperties = Object.keys(targetCollection.properties);
 	let listProperties = previewProperties?.filter((p) => allProperties.includes(p));
 	if (!listProperties && targetCollection.previewProperties) listProperties = targetCollection.previewProperties?.filter((p) => allProperties.includes(p));
 	if (listProperties && listProperties.length > 0) return listProperties;
-	else {
-		listProperties = targetCollection.propertiesOrder || allProperties;
-		return listProperties.filter((key) => {
-			const prop = targetCollection.properties[key];
-			return !(prop && typeof prop === "object" && "isId" in prop && Boolean(prop.isId)) && key !== "id";
-		}).filter((key) => {
-			const property = targetCollection.properties[key];
-			return property && !isPropertyBuilder(property) && !isReferenceProperty(property) && !isRelationProperty(property) && !isHiddenProperty(property) && !isStorageProperty$1(property);
-		}).slice(0, limit);
+	const hasExplicitOrder = !!targetCollection.propertiesOrder;
+	const order = targetCollection.propertiesOrder || allProperties;
+	const direct = [];
+	const excerpt = [];
+	for (const key of order) {
+		const property = targetCollection.properties[key];
+		if (!property || isPropertyBuilder(property)) continue;
+		if (key === "id" || "isId" in property && Boolean(property.isId)) continue;
+		if (isReferenceProperty(property)) continue;
+		if (!hasExplicitOrder && isRelationProperty(property)) continue;
+		if (isHiddenProperty(property)) continue;
+		if (isStorageProperty(property)) continue;
+		const rank = rankSummaryProperty(property);
+		if (rank === SUMMARY_RANK.UNUSABLE) continue;
+		(rank === SUMMARY_RANK.EXCERPT ? excerpt : direct).push(key);
+		if (direct.length >= limit) break;
 	}
+	return [...direct, ...excerpt].slice(0, limit);
 }
 var INCLUDE_ALL_RELATIONS = ["*"];
 /**
@@ -531,7 +653,7 @@ function useCollection({ path, collection, filterValues, sortBy, itemCount, offs
 		};
 		const accessor = dataClient.collection(path);
 		const includeParams = getRelationIncludeParams(collection);
-		if (accessor.listen) return accessor.listen({
+		if (accessor.listen) return accessor.listen(toFindParams({
 			where: whereParams,
 			limit: itemCount,
 			offset,
@@ -539,12 +661,13 @@ function useCollection({ path, collection, filterValues, sortBy, itemCount, offs
 			orderBy: orderByParams,
 			searchString,
 			include: includeParams
-		}, (res) => onEntitiesUpdate({
+		}), (res) => onEntitiesUpdate({
 			data: res.data,
 			meta: res.meta
 		}), onError);
 		else {
-			accessor.find({
+			let cancelled = false;
+			accessor.find(toFindParams({
 				where: whereParams,
 				limit: itemCount,
 				offset,
@@ -552,11 +675,19 @@ function useCollection({ path, collection, filterValues, sortBy, itemCount, offs
 				orderBy: orderByParams,
 				searchString,
 				include: includeParams
-			}).then((res) => onEntitiesUpdate({
-				data: res.data,
-				meta: res.meta
-			})).catch(onError);
-			return () => {};
+			})).then((res) => {
+				if (cancelled) return;
+				onEntitiesUpdate({
+					data: res.data,
+					meta: res.meta
+				});
+			}).catch((e) => {
+				if (cancelled) return;
+				onError(e);
+			});
+			return () => {
+				cancelled = true;
+			};
 		}
 	}, [
 		path,
@@ -836,8 +967,17 @@ function useFetch({ path, entityId, collection, databaseId, useCache = false })
 			const accessor = dataClient.collection(path);
 			if (accessor.listenById) return accessor.listenById(entityId, (entity) => onEntityUpdate(entity), onError);
 			else {
-				accessor.findById(entityId).then((entity) => onEntityUpdate(entity)).catch(onError);
-				return () => {};
+				let cancelled = false;
+				accessor.findById(entityId).then((entity) => {
+					if (cancelled) return;
+					onEntityUpdate(entity);
+				}).catch((e) => {
+					if (cancelled) return;
+					onError(e);
+				});
+				return () => {
+					cancelled = true;
+				};
 			}
 		} else {
 			onEntityUpdate(void 0);
@@ -948,6 +1088,7 @@ function useRelationSelector({ path, collection, fixedFilter, pageSize = DEFAULT
 			meta: res.meta
 		}), onErrorUpdate);
 		else {
+			let cancelled = false;
 			accessor.find({
 				where: whereParams,
 				limit,
@@ -955,11 +1096,19 @@ function useRelationSelector({ path, collection, fixedFilter, pageSize = DEFAULT
 				orderBy: void 0,
 				searchString: currentSearch,
 				include: includeParams
-			}).then((res) => onEntitiesUpdate({
-				data: res.data,
-				meta: res.meta
-			})).catch(onErrorUpdate);
-			unsubscribe = () => {};
+			}).then((res) => {
+				if (cancelled) return;
+				onEntitiesUpdate({
+					data: res.data,
+					meta: res.meta
+				});
+			}).catch((e) => {
+				if (cancelled) return;
+				onErrorUpdate(e);
+			});
+			unsubscribe = () => {
+				cancelled = true;
+			};
 		}
 		unsubscribeRef.current = unsubscribe || null;
 	}, [
@@ -1254,7 +1403,15 @@ function useAuthSubscription(authClient) {
 			setInitialLoading(true);
 			authClient.getUser().then((user) => {
 				if (user) setUser(user);
-			}).catch((e) => {}).finally(() => {
+				setAuthError(void 0);
+			}).catch((e) => {
+				const status = e?.status;
+				if (status === 401 || status === 403) {
+					setAuthError(void 0);
+					return;
+				}
+				setAuthError(e instanceof Error ? e : new Error(String(e)));
+			}).finally(() => {
 				setInitialLoading(false);
 			});
 		}
@@ -1630,8 +1787,10 @@ function useSlot(slot, props) {
 function useBuildLocalConfigurationPersistence() {
 	const configCache = useRef({});
 	const getCollectionFromStorage = useCallback((storageKey) => {
-		const item = localStorage.getItem(storageKey);
-		return item ? JSON.parse(item) : {};
+		return readStoredJson(storageKey, {
+			fallback: {},
+			accept: isRecordValue
+		});
 	}, []);
 	const getCollectionConfig = useCallback((path) => {
 		const storageKey = `collection_config::${stripCollectionPath(path)}`;
@@ -1640,29 +1799,33 @@ function useBuildLocalConfigurationPersistence() {
 	}, [getCollectionFromStorage]);
 	const onCollectionModified = useCallback((path, data) => {
 		const storageKey = `collection_config::${stripCollectionPath(path)}`;
-		localStorage.setItem(storageKey, JSON.stringify(data));
+		writeStoredJson(storageKey, data);
 		const cachedConfig = configCache.current[storageKey];
-		const newConfig = mergeDeep(cachedConfig ?? getCollectionFromStorage(path), data);
+		const newConfig = mergeDeep(cachedConfig ?? getCollectionFromStorage(storageKey), data);
 		configCache.current[storageKey] = mergeDeep(configCache.current[storageKey], newConfig);
 	}, [getCollectionFromStorage]);
 	const [recentlyVisitedPaths, _setRecentlyVisitedPaths] = useState([]);
 	const [favouritePaths, _setFavouritePaths] = useState([]);
 	const [collapsedGroups, _setCollapsedGroups] = useState([]);
 	useEffect(() => {
-		_setRecentlyVisitedPaths(localStorage.getItem("recently_visited_paths") ? JSON.parse(localStorage.getItem("recently_visited_paths")) : []);
-		_setFavouritePaths(localStorage.getItem("favourite_paths") ? JSON.parse(localStorage.getItem("favourite_paths")) : []);
-		_setCollapsedGroups(localStorage.getItem("collapsed_groups") ? JSON.parse(localStorage.getItem("collapsed_groups")) : []);
+		const readPaths = (key) => readStoredJson(key, {
+			fallback: [],
+			accept: isArrayValue
+		});
+		_setRecentlyVisitedPaths(readPaths("recently_visited_paths"));
+		_setFavouritePaths(readPaths("favourite_paths"));
+		_setCollapsedGroups(readPaths("collapsed_groups"));
 	}, []);
 	const setRecentlyVisitedPaths = useCallback((paths) => {
-		localStorage.setItem("recently_visited_paths", JSON.stringify(paths));
+		writeStoredJson("recently_visited_paths", paths);
 		_setRecentlyVisitedPaths(paths);
 	}, []);
 	const setFavouritePaths = useCallback((paths) => {
-		localStorage.setItem("favourite_paths", JSON.stringify(paths));
+		writeStoredJson("favourite_paths", paths);
 		_setFavouritePaths(paths);
 	}, []);
 	const setCollapsedGroups = useCallback((paths) => {
-		localStorage.setItem("collapsed_groups", JSON.stringify(paths));
+		writeStoredJson("collapsed_groups", paths);
 		_setCollapsedGroups(paths);
 	}, []);
 	return useMemo(() => ({
@@ -2325,24 +2488,202 @@ function useDebouncedData(data, deps, timeoutMs = 5e3) {
 	return immediateUpdate ? data : deferredData;
 }
 //#endregion
-//#region src/components/common/useColumnsIds.tsx
+//#region src/collections/property-path.ts
 /**
-* Get a property in a property tree from a dot-path like `address.street`.
-* Inlined here to avoid importing property-aware utilities from the admin layer.
+* The property at a dotted path, walking `map` children — `address.street`.
+*
+* The value counterpart is `getValueInPath` in `@rebasepro/utils`; this is the
+* schema half, and the two have to be used together. Reading a dotted path off
+* an entity while looking its property up with a flat `properties[path]` gives
+* the value and `undefined` for how to render it, which is how a declared title
+* on a nested field silently fell back to a derived one.
+*
+* There were three copies of this: one private to `useColumnsIds`, one exported
+* from the admin layer, and the flat lookup in the title resolver that was not
+* this function at all. This is the one, in the lowest layer that needs it —
+* admin re-exports it under the name it already published.
 */
 function getPropertyInPath(properties, path) {
-	if (typeof properties === "object") {
-		if (path in properties) return properties[path];
-		if (path.includes(".")) {
-			const pathSegments = path.split(".");
-			const childProperty = properties[pathSegments[0]];
-			if (typeof childProperty === "object" && childProperty.type === "map" && childProperty.properties) return getPropertyInPath(childProperty.properties, pathSegments.slice(1).join("."));
+	if (typeof properties !== "object" || !properties) return void 0;
+	if (path in properties) return properties[path];
+	if (path.includes(".")) {
+		const pathSegments = path.split(".");
+		const childProperty = properties[pathSegments[0]];
+		if (typeof childProperty === "object" && childProperty?.type === "map" && childProperty.properties) return getPropertyInPath(childProperty.properties, pathSegments.slice(1).join("."));
+	}
+}
+//#endregion
+//#region src/collections/property_presentation.ts
+/**
+* A condition stated as a literal rather than as a rule.
+*
+* `PropertyConditions` accepts either, and the two are answered in different
+* places: a rule needs a context and so can only be evaluated while rendering a
+* particular entity, but a literal is already the answer. Reading it here is
+* what makes `hidden: true` work without every gate below having to build a
+* condition context first — and without the caller reaching for
+* `{ "==": [1, 1] }` to say something it can say with a boolean.
+*/
+function literalCondition(condition) {
+	return condition === true;
+}
+function isReadOnly(property) {
+	if (property.admin?.readOnly) return true;
+	if (literalCondition(property.conditions?.readOnly)) return true;
+	if (property.type === "date") {
+		if (property.autoValue) return true;
+	}
+	if (property.type === "reference") return !property.path && !("Field" in (property.admin || {}) && property.admin?.Field);
+	return false;
+}
+function isHidden(property) {
+	if (literalCondition(property.conditions?.hidden)) return true;
+	return typeof property.admin?.disabled === "object" && Boolean(property.admin?.disabled.hidden);
+}
+/**
+* Whether the field is disabled by its own declaration, ignoring form state.
+*
+* The `admin.disabled` block and `conditions.disabled: true` say the same thing
+* two ways, so every caller that gated on the first now asks here instead of
+* growing a second check of its own.
+*/
+function isDisabled(property) {
+	return Boolean(property.admin?.disabled) || literalCondition(property.conditions?.disabled);
+}
+function applyPropertyConditions(property, context) {
+	const { conditions } = property;
+	if (!conditions) return property;
+	const result = { ...property };
+	if (conditions.disabled) {
+		if (evaluateCondition(conditions.disabled, context)) {
+			result.admin = result.admin || {};
+			result.admin.disabled = {
+				clearOnDisabled: conditions.clearOnDisabled ?? false,
+				disabledMessage: conditions.disabledMessage,
+				hidden: false
+			};
+		}
+	}
+	if (conditions.hidden) {
+		if (evaluateCondition(conditions.hidden, context)) {
+			result.admin = result.admin || {};
+			result.admin.disabled = {
+				...typeof result.admin?.disabled === "object" ? result.admin.disabled : {},
+				hidden: true,
+				clearOnDisabled: conditions.clearOnDisabled ?? false
+			};
+		}
+	}
+	if (conditions.readOnly) {
+		if (evaluateCondition(conditions.readOnly, context)) {
+			result.admin = result.admin || {};
+			result.admin.readOnly = true;
+		}
+	}
+	if (conditions.required !== void 0) {
+		const isRequired = evaluateCondition(conditions.required, context);
+		result.validation = {
+			...result.validation,
+			required: isRequired,
+			requiredMessage: conditions.requiredMessage
+		};
+	}
+	if (context.isNew && conditions.defaultValue !== void 0) result.defaultValue = evaluateCondition(conditions.defaultValue, context);
+	if ("enum" in result && result.enum && (conditions.enumConditions || conditions.allowedEnumValues || conditions.excludedEnumValues)) result.enum = applyEnumConditions(result.enum, conditions, context);
+	if (result.type === "reference") {
+		if (conditions.referencePath) result.path = evaluateCondition(conditions.referencePath, context);
+		if (conditions.referenceFilter) {
+			result.admin = result.admin || {};
+			result.admin.fixedFilter = evaluateCondition(conditions.referenceFilter, context);
+		}
+	}
+	if (result.type === "array") {
+		if (conditions.canAddElements !== void 0) {
+			result.admin = result.admin || {};
+			result.admin.canAddElements = evaluateCondition(conditions.canAddElements, context);
+		}
+		if (conditions.sortable !== void 0) {
+			result.admin = result.admin || {};
+			result.admin.sortable = evaluateCondition(conditions.sortable, context);
 		}
 	}
+	return result;
+}
+/**
+* Convert an object with numeric keys back to an array.
+* Firestore stores arrays as {"0": "a", "1": "b"} to avoid nested arrays.
+*/
+function objectToArray(obj) {
+	if (Array.isArray(obj)) return obj.map(String);
+	if (obj && typeof obj === "object") {
+		const keys = Object.keys(obj);
+		if (keys.length > 0 && keys.every((k) => !isNaN(Number(k)))) return keys.sort((a, b) => Number(a) - Number(b)).map((k) => obj[k]).filter((v) => typeof v === "string" || typeof v === "number").map(String);
+	}
+	return [];
+}
+/**
+* Apply enum-specific conditions to filter and modify enum values.
+*/
+function applyEnumConditions(enumValues, conditions, context) {
+	let result = [...enumValues];
+	if (conditions.allowedEnumValues) {
+		const allowedArray = objectToArray(evaluateCondition(conditions.allowedEnumValues, context));
+		if (allowedArray.length > 0) result = result.filter((ev) => allowedArray.includes(String(ev.id)));
+	}
+	if (conditions.excludedEnumValues) {
+		const excludedArray = objectToArray(evaluateCondition(conditions.excludedEnumValues, context));
+		if (excludedArray.length > 0) result = result.filter((ev) => !excludedArray.includes(String(ev.id)));
+	}
+	if (conditions.enumConditions) result = result.map((ev) => {
+		const evConditions = conditions.enumConditions?.[ev.id];
+		if (!evConditions) return ev;
+		if (evConditions.hidden && evaluateCondition(evConditions.hidden, context)) return null;
+		if (evConditions.disabled && evaluateCondition(evConditions.disabled, context)) return {
+			...ev,
+			disabled: true
+		};
+		return ev;
+	}).filter((ev) => ev !== null);
+	return result;
 }
+//#endregion
+//#region src/components/common/useColumnsIds.tsx
 function getSubcollectionColumnId(collection) {
 	return `subcollection:${collection.slug}`;
 }
+/**
+* The jump-to-tab columns a collection table does not need, because the relation
+* behind them already has a column of its own.
+*
+* Every child view gets a 200px button column that opens its tab. For a relation
+* declared in `relations` that button is the relation's only presence in the
+* table. For one declared as a property it is the second: the property's own
+* column is already there, hydrated by the list fetch's `include: ["*"]`, showing
+* the child rows themselves — and carrying the *same heading*, because the tab
+* takes its name from the declaring property. Two columns called "Applications",
+* one of them a button, and nothing in the header to tell them apart.
+*
+* The property column wins: it shows what the children are, and each chip in it
+* opens one. The tab stays reachable by opening the record, which is what the
+* rest of the table's rows do anyway.
+*
+* Unless the author hid that column — `hideFromCollection` on the property, or a
+* `propertiesOrder` that omits it, is a statement about the column and not about
+* the relation, so the button comes back rather than the relation dropping out
+* of the table altogether.
+*/
+function getRedundantChildViewColumnIds(collection) {
+	const redundant = /* @__PURE__ */ new Set();
+	const properties = collection.properties ?? {};
+	const order = collection.propertiesOrder;
+	for (const [viewKey, propertyKey] of getChildViewDeclaringProperties(collection)) {
+		const property = properties[propertyKey];
+		if (!property || property.admin?.hideFromCollection) continue;
+		if (order && !order.includes(propertyKey)) continue;
+		redundant.add(`subcollection:${viewKey}`);
+	}
+	return redundant;
+}
 function useColumnIds(collection, includeSubcollections) {
 	return useMemo(() => {
 		if (collection.propertiesOrder) return hideAndExpandKeys(collection, collection.propertiesOrder);
@@ -2357,8 +2698,10 @@ function hideAndExpandKeys(collection, keys) {
 		if (rootProperty && rootProperty.type === "map" && rootProperty.admin?.spreadChildren && rootProperty.properties) rootsWithExplicitChildren.add(rootKey);
 	}
 	const processedPropertyKeys = /* @__PURE__ */ new Set();
+	const redundantChildViewColumns = getRedundantChildViewColumnIds(collection);
 	const result = keys.flatMap((key) => {
 		if (processedPropertyKeys.has(key)) return [null];
+		if (redundantChildViewColumns.has(key)) return [null];
 		const property = collection.properties[key];
 		if (property) {
 			processedPropertyKeys.add(key);
@@ -2372,7 +2715,7 @@ function hideAndExpandKeys(collection, keys) {
 			}
 			return [{
 				key,
-				disabled: Boolean(property.admin?.disabled) || Boolean(property.admin?.readOnly)
+				disabled: isDisabled(property) || Boolean(property.admin?.readOnly)
 			}];
 		}
 		if (key.includes(".")) {
@@ -2387,7 +2730,7 @@ function hideAndExpandKeys(collection, keys) {
 					if (nestedProperty.admin?.disabled && typeof nestedProperty.admin?.disabled === "object" && nestedProperty.admin?.disabled.hidden) return [null];
 					return [{
 						key,
-						disabled: Boolean(rootProperty.admin?.disabled) || Boolean(rootProperty.admin?.readOnly) || Boolean(nestedProperty.admin?.disabled) || Boolean(nestedProperty.admin?.readOnly)
+						disabled: isDisabled(rootProperty) || Boolean(rootProperty.admin?.readOnly) || isDisabled(nestedProperty) || Boolean(nestedProperty.admin?.readOnly)
 					}];
 				}
 			}
@@ -2420,7 +2763,7 @@ function hideAndExpandKeys(collection, keys) {
 		} else {
 			result.push({
 				key: propKey,
-				disabled: Boolean(property.admin?.disabled) || Boolean(property.admin?.readOnly)
+				disabled: isDisabled(property) || Boolean(property.admin?.readOnly)
 			});
 			processedPropertyKeys.add(propKey);
 		}
@@ -2439,14 +2782,20 @@ function getDefaultColumnKeys(collection, includeSubCollections) {
 	return hideAndExpandKeys(collection, columnIds);
 }
 function getColumnKeysForProperty(property, key, disabled) {
-	if (property.type === "map" && property.admin?.spreadChildren && property.properties) return Object.entries(property.properties).flatMap(([childKey, childProperty]) => getColumnKeysForProperty(childProperty, `${key}.${childKey}`, disabled || Boolean(property.admin?.disabled) || Boolean(property.admin?.readOnly)));
+	if (!property) return [];
+	if (property.type === "map" && property.admin?.spreadChildren && property.properties) return Object.entries(property.properties).flatMap(([childKey, childProperty]) => getColumnKeysForProperty(childProperty, `${key}.${childKey}`, disabled || isDisabled(property) || Boolean(property.admin?.readOnly)));
 	return [{
 		key,
-		disabled: disabled || Boolean(property.admin?.disabled) || Boolean(property.admin?.readOnly)
+		disabled: disabled || isDisabled(property) || Boolean(property.admin?.readOnly)
 	}];
 }
 function getFormFieldKeys(collection) {
-	const propertyKeys = collection.properties ? Object.keys(collection.properties) : [];
+	const properties = collection.properties ?? {};
+	const consumedByChildView = getChildViewRelationPropertyKeys(collection);
+	const propertyKeys = Object.keys(properties).filter((key) => {
+		if (!consumedByChildView.has(key)) return true;
+		return properties[key].admin?.renderInForm === true;
+	});
 	const additionalFields = collection.additionalFields ?? [];
 	const allKeys = [...propertyKeys, ...additionalFields.map((field) => field.key)];
 	if (collection.propertiesOrder) return collection.propertiesOrder.filter((key) => allKeys.includes(key));
@@ -2610,21 +2959,21 @@ function useDataTableController({ path, collection, scrollRestoration, entitiesD
 		const orderByParams = sortBy ? [String(sortBy[0]), sortBy[1]] : void 0;
 		let unsubscribe;
 		const includeParams = getRelationIncludeParams(collection);
-		if (accessor.listen) unsubscribe = accessor.listen({
+		if (accessor.listen) unsubscribe = accessor.listen(toFindParams({
 			where: whereParams,
 			limit: itemCount,
 			orderBy: orderByParams,
 			searchString,
 			include: includeParams
-		}, (res) => onEntitiesUpdate(res.data), onError);
+		}), (res) => onEntitiesUpdate(res.data), onError);
 		else {
-			accessor.find({
+			accessor.find(toFindParams({
 				where: whereParams,
 				limit: itemCount,
 				orderBy: orderByParams,
 				searchString,
 				include: includeParams
-			}).then((res) => onEntitiesUpdate(res.data)).catch(onError);
+			})).then((res) => onEntitiesUpdate(res.data)).catch(onError);
 			unsubscribe = () => void 0;
 		}
 		return unsubscribe;
@@ -9821,6 +10170,7 @@ var en = {
 	column_cannot_be_edited: "This column can't be edited directly",
 	close: "Close",
 	hide_list: "Hide list",
+	show_list: "Show list",
 	unsaved_local_changes: "Unsaved Local changes",
 	unsaved_local_changes_description: "This document was edited locally and has unsaved changes. These local changes will be lost if you don't apply them.",
 	preview_changes: "Preview Changes",
@@ -10632,6 +10982,7 @@ var en = {
 	inspect_record: "Inspect record",
 	inspect: "Inspect",
 	close_inspector: "Close inspector",
+	open_in_live_site: "Open in the live site",
 	history_revert: "Revert to this version",
 	history_revert_title: "Revert data to this version?",
 	history_reverted: "Reverted to selected version",
@@ -10720,6 +11071,7 @@ var es = {
 	column_cannot_be_edited: "Esta columna no se puede editar directamente",
 	close: "Cerrar",
 	hide_list: "Ocultar lista",
+	show_list: "Mostrar lista",
 	unsaved_local_changes: "Cambios locales sin guardar",
 	unsaved_local_changes_description: "Este documento ha sido editado localmente y tiene cambios sin guardar. Estos cambios locales se perderán si no los aplicas.",
 	preview_changes: "Previsualizar cambios",
@@ -11576,6 +11928,7 @@ var de = {
 	column_cannot_be_edited: "Diese Spalte kann nicht direkt bearbeitet werden",
 	close: "Schließen",
 	hide_list: "Liste ausblenden",
+	show_list: "Liste einblenden",
 	unsaved_local_changes: "Ungespeicherte lokale Änderungen",
 	unsaved_local_changes_description: "Dieses Dokument wurde lokal bearbeitet und weist ungespeicherte Änderungen auf. Diese lokalen Änderungen gehen verloren, wenn Sie sie nicht anwenden.",
 	preview_changes: "Änderungen in der Vorschau anzeigen",
@@ -12422,6 +12775,7 @@ var fr = {
 	column_cannot_be_edited: "Cette colonne ne peut pas être modifiée directement",
 	close: "Fermer",
 	hide_list: "Masquer la liste",
+	show_list: "Afficher la liste",
 	unsaved_local_changes: "Modifications locales non enregistrées",
 	unsaved_local_changes_description: "Ce document a été modifié localement et contient des modifications non enregistrées. Ces modifications locales seront perdues si vous ne les appliquez pas.",
 	preview_changes: "Aperçu des modifications",
@@ -13268,6 +13622,7 @@ var it = {
 	column_cannot_be_edited: "Questa colonna non può essere modificata direttamente",
 	close: "Chiudi",
 	hide_list: "Nascondi elenco",
+	show_list: "Mostra elenco",
 	unsaved_local_changes: "Modifiche locali non salvate",
 	unsaved_local_changes_description: "Questo documento è stato modificato localmente e ha modifiche non salvate. Queste modifiche locali andranno perse se non le applichi.",
 	preview_changes: "Anteprima modifiche",
@@ -14106,7 +14461,7 @@ var hi = {
 	group_by: "इसके द्वारा समूहित करें",
 	initialize_kanban_order: "कानबन क्रम प्रारंभ करें",
 	copy_id: "ID कॉपी करें",
-	add_specific: "विशिष्ट {{name}} जोड़ें",
+	add_specific: "{{name}} जोड़ें",
 	select_specific: "विशिष्ट {{name}} चुनें",
 	select_from: "{{name}} से चुनें",
 	done: "हो गया",
@@ -14114,6 +14469,7 @@ var hi = {
 	column_cannot_be_edited: "इस कॉलम को सीधे संपादित नहीं किया जा सकता",
 	close: "बंद करें",
 	hide_list: "सूची छिपाएँ",
+	show_list: "सूची दिखाएँ",
 	unsaved_local_changes: "सहेजे नहीं गए स्थानीय परिवर्तन",
 	unsaved_local_changes_description: "इस दस्तावेज़ को स्थानीय स्तर पर संपादित किया गया था और इसमें सहेजे नहीं गए परिवर्तन हैं। यदि आप इन्हें लागू नहीं करते हैं तो ये स्थानीय परिवर्तन खो जाएंगे।",
 	preview_changes: "परिवर्तनों का पूर्वावलोकन करें",
@@ -14965,6 +15321,7 @@ var pt = {
 	column_cannot_be_edited: "Esta coluna não pode ser editada diretamente",
 	close: "Fechar",
 	hide_list: "Ocultar lista",
+	show_list: "Mostrar lista",
 	unsaved_local_changes: "Alterações locais não guardadas",
 	unsaved_local_changes_description: "Este documento foi editado localmente e tem alterações não guardadas. Estas alterações locais serão perdidas se não as aplicar.",
 	preview_changes: "Pré-visualizar alterações",
@@ -15840,6 +16197,11 @@ function Rebase(props) {
 		if (new Set(keys).size !== keys.length) console.error("Duplicate plugin keys detected:", keys.filter((k, i) => keys.indexOf(k) !== i));
 	}
 	const resolvedSlots = useMemo(() => [...directSlots, ...(plugins ?? []).flatMap((p) => p.slots ?? [])], [directSlots, plugins]);
+	useEffect(() => {
+		const dead = new Set(UNRENDERED_SLOTS);
+		const registered = new Set(resolvedSlots.map((s) => s.slot).filter((slot) => dead.has(slot)));
+		for (const slot of registered) console.warn(`[Rebase] A component is registered for the "${slot}" slot, which this build declares but renders nowhere — nothing will appear. This is a gap in Rebase, not in your plugin.`);
+	}, [resolvedSlots]);
 	const clientAuthController = useAuthSubscription(authControllerProp ? void 0 : client?.auth);
 	const authController = authControllerProp ?? clientAuthController;
 	const normalizedDataSources = useMemo(() => {
@@ -16201,7 +16563,9 @@ function useRebaseAuthController(props = {}) {
 		});
 		auth.getAuthConfig().then((config) => {
 			if (isMountedRef.current) setAuthConfig(config);
-		}).catch(() => {});
+		}).catch((e) => {
+			console.warn("[Rebase] Could not load the backend auth configuration; the login view will fall back to defaults.", e);
+		});
 		const unsubscribe = auth.onAuthStateChange(syncState);
 		return () => {
 			isMountedRef.current = false;
@@ -16636,6 +17000,21 @@ function createFormexStub(values) {
 //#endregion
 //#region src/util/entity_cache.ts
 var LOCAL_STORAGE_PREFIX = "entity_cache::";
+/**
+* The in-session handoff channel: an edit in flight, parked here by the layout
+* that is being replaced and picked up by the one taking over — the split's
+* "hide list", full screen's "show list", the side panel's "open full screen".
+* A record loaded from it opens *dirty*, because that is what it is for.
+*
+* Deliberately **not** hydrated from `sessionStorage`, and it is the one thing
+* here that isn't. The persisted half of this file is the local-changes backup:
+* a draft that outlives a reload, offered back through the banner or applied on
+* open, according to the collection's `localChangesBackup`. Loading those
+* drafts into this map on startup made every one of them look like a handoff —
+* the first visit to the record after a reload silently opened dirty carrying a
+* draft the user had walked away from, and the banner that exists to ask about
+* it never appeared.
+*/
 var entityCache = /* @__PURE__ */ new Map();
 var isSessionStorageAvailable = typeof sessionStorage !== "undefined";
 function customReplacer(key) {
@@ -16690,25 +17069,12 @@ function customReviver(_key, value) {
 	}
 	return value;
 }
-if (isSessionStorageAvailable) try {
-	for (let i = 0; i < sessionStorage.length; i++) {
-		const fullKey = sessionStorage.key(i);
-		if (fullKey && fullKey.startsWith(LOCAL_STORAGE_PREFIX)) {
-			const path = fullKey.substring(14);
-			const entityString = sessionStorage.getItem(fullKey);
-			if (entityString) try {
-				const entity = JSON.parse(entityString, customReviver);
-				entityCache.set(path, entity);
-			} catch (parseError) {
-				console.error(`Failed to parse entity for path "${path}" from sessionStorage:`, parseError);
-			}
-		}
-	}
-} catch (error) {
-	console.error("Error accessing sessionStorage during initialization:", error);
-}
 /**
-* Saves data to the in-memory cache and persists it individually in `sessionStorage`.
+* Saves data to the local-changes backup in `sessionStorage`.
+*
+* The backup only — a draft that survives a reload is not an edit in flight.
+* {@link saveEntityToMemoryCache} is the other channel; see {@link entityCache}
+* for what separates them.
 * @param path - The unique path/key for the data.
 * @param data - The data to cache and persist.
 */
@@ -16721,9 +17087,18 @@ function saveEntityToCache(path, data) {
 		console.error(`Failed to save entity for path "${path}" to sessionStorage:`, error);
 	}
 }
+/**
+* Consumes a handoff. The channel is one-shot: whoever picks an edit up owns it
+* from then on, and an edit left behind here is one that reopens a record dirty
+* long after the user stopped looking at it.
+*/
 function removeEntityFromMemoryCache(path) {
 	entityCache.delete(path);
 }
+/**
+* Parks an edit in flight for the layout about to take over. See
+* {@link entityCache}: this is the handoff, not the backup.
+*/
 function saveEntityToMemoryCache(path, data) {
 	entityCache.set(path, data);
 }
@@ -16731,8 +17106,11 @@ function getEntityFromMemoryCache(path) {
 	return entityCache.get(path);
 }
 /**
-* Retrieves a entity from the in-memory cache or `sessionStorage`.
-* If the entity is not in the cache but exists in `sessionStorage`, it loads it into the cache.
+* Retrieves a entity from the local-changes backup in `sessionStorage`.
+*
+* The backup only — the handoff channel is read through
+* {@link getEntityFromMemoryCache}, and the two mean different things to the
+* form that receives them.
 * @param path - The unique path/key for the entity.
 * @returns The cached entity or `undefined` if not found.
 */
@@ -17359,8 +17737,82 @@ function getAdminEntityChildViews(collection) {
 	}));
 }
 //#endregion
+//#region src/collections/entity-display.ts
+/**
+* Collections that have already warned about a deprecated field, so a list of
+* fifty rows produces one line in the console rather than fifty.
+*/
+var deprecationWarned = /* @__PURE__ */ new Set();
+function collectionId(collection) {
+	return collection.slug ?? collection.name ?? "collection";
+}
+function warnOnce(id, message) {
+	const key = `${id}:${message}`;
+	if (deprecationWarned.has(key)) return;
+	deprecationWarned.add(key);
+	console.warn(message);
+}
+/**
+* What the collection declares for a role, before deciding which form it is.
+*
+* `display.title` wins over the deprecated `titleProperty`: a collection setting
+* both is mid-migration, and the new field is the one it means.
+*/
+function getDeclaredSource(collection, role) {
+	const declared = collection.display?.[role];
+	if (declared !== void 0) return declared;
+	if (role === "title" && collection.titleProperty) {
+		const id = collectionId(collection);
+		warnOnce(id, `[rebase] Collection "${id}" uses admin.titleProperty, which is deprecated. Move it to admin.display.title — the same string works there, and display.title also accepts a resolver for a title the record does not carry.`);
+		return collection.titleProperty;
+	}
+}
+/**
+* The property path a role is declared to read, when it is declared as a path.
+*
+* Returns `undefined` for a role filled by a resolver — a resolver has no key —
+* and for a role the collection says nothing about, which is then derived.
+*
+* @group Collections
+*/
+function getDisplayPropertyKey(collection, role) {
+	const declared = getDeclaredSource(collection, role);
+	return typeof declared === "string" ? declared : void 0;
+}
+/**
+* The resolver a role is declared to use, when it is declared as one.
+*
+* @group Collections
+*/
+function getDisplayResolver(collection, role) {
+	const declared = getDeclaredSource(collection, role);
+	return typeof declared === "function" ? declared : void 0;
+}
+/**
+* True when the collection states this role at all, in either form.
+*
+* The derivation is a guess about what a collection probably means; a statement
+* outranks it, and the heuristics that look for "the first enum" or "the leading
+* relation" have to stand down when one exists.
+*
+* @group Collections
+*/
+function hasDeclaredDisplay(collection, role) {
+	return getDeclaredSource(collection, role) !== void 0;
+}
+//#endregion
 //#region src/collections/entity_image_preview.ts
+/**
+* The property that fills a record's image slot.
+*
+* `admin.display.image` first, then six fallbacks in descending confidence —
+* the first image-typed storage property, an array of them, a URL rendered as an
+* image, and so on. The ladder stays for collections that say nothing; a
+* collection that names its picture is not guessed at.
+*/
 function getEntityImagePreviewPropertyKey(collection) {
+	const declared = getDisplayPropertyKey(collection, "image");
+	if (declared) return declared;
 	for (const key in collection.properties) {
 		const property = collection.properties[key];
 		if (property.type === "string" && property.storage?.acceptedFiles?.includes("image/*")) return key;
@@ -17387,6 +17839,142 @@ function getEntityImagePreviewPropertyKey(collection) {
 	}
 }
 //#endregion
+//#region src/collections/entity-display-cache.ts
+/** The identity of one role of one record, as a cache key. */
+function entityDisplayKey(path, entityId, role) {
+	return `${role} ${path} ${entityId ?? ""}`;
+}
+var EntityDisplayCache = class {
+	entries = /* @__PURE__ */ new Map();
+	listeners = /* @__PURE__ */ new Set();
+	/**
+	* The resolved value, or `undefined` when this pair has not been resolved
+	* yet. `null` is a resolved absence, and the two must stay distinct: a
+	* caller that reads "not yet" as "nothing" flickers its fallback in on every
+	* mount.
+	*/
+	peek(key) {
+		const entry = this.entries.get(key);
+		if (!entry || "promise" in entry) return void 0;
+		return entry.value;
+	}
+	/** True while a resolution for this pair is in flight. */
+	isLoading(key) {
+		const entry = this.entries.get(key);
+		return Boolean(entry && "promise" in entry);
+	}
+	/**
+	* Resolve once per record and role. Concurrent callers share the first
+	* call's promise; later callers get the cached value with no promise at all.
+	*
+	* A resolver that throws is recorded as "nothing" rather than retried: the
+	* alternative is every render re-running a call that just failed. And it is
+	* reported here, which is a correction.
+	*
+	* It used to say "the caller that saw the rejection is the one that logs
+	* it", and `useEntityDisplay` duly attached a `.catch()` that warned. But
+	* both failure paths below swallow and return a *resolved* promise, so that
+	* catch could never run — the two halves each did the reasonable thing and
+	* between them the log was unreachable. A resolver that blew up produced a
+	* blank chip and total silence, which is the failure mode
+	* `EntityDisplayResolver`'s own contract ("treated as `undefined` and logged
+	* once") exists to rule out.
+	*
+	* Reporting belongs here for the reason the caller could not do it: this is
+	* the one place that runs exactly once per key, so "once" is a property of
+	* the code rather than a hope about how many components mount.
+	*/
+	resolve(key, resolver) {
+		const entry = this.entries.get(key);
+		if (entry) return "promise" in entry ? entry.promise : Promise.resolve(entry.value);
+		let produced;
+		try {
+			produced = resolver();
+		} catch (error) {
+			this.fail(key, error);
+			return Promise.resolve(null);
+		}
+		if (!isPromise(produced)) {
+			const value = normalize(produced);
+			this.set(key, value);
+			return Promise.resolve(value);
+		}
+		const promise = produced.then((resolved) => {
+			const value = normalize(resolved);
+			this.set(key, value);
+			return value;
+		}).catch((error) => {
+			this.fail(key, error);
+			return null;
+		});
+		this.entries.set(key, { promise });
+		return promise;
+	}
+	/**
+	* Drop what is known about a record, so the next ask resolves again. Called
+	* after a write: the row that just saved may be called something else now.
+	*/
+	invalidate(path, entityId) {
+		const suffix = ` ${path} ${entityId ?? ""}`;
+		let changed = false;
+		for (const key of [...this.entries.keys()]) if (entityId === void 0 ? key.includes(` ${path} `) || key.endsWith(` ${path} `) : key.endsWith(suffix)) {
+			this.entries.delete(key);
+			changed = true;
+		}
+		if (changed) this.emit();
+	}
+	/** Drop everything. The user signed out, or the app swapped datasource. */
+	clear() {
+		if (this.entries.size === 0) return;
+		this.entries.clear();
+		this.emit();
+	}
+	subscribe(listener) {
+		this.listeners.add(listener);
+		return () => {
+			this.listeners.delete(listener);
+		};
+	}
+	set(key, value) {
+		this.entries.set(key, { value });
+		this.emit();
+	}
+	/**
+	* Record a failed resolution as "nothing", and say so once.
+	*
+	* The key is the message: it is `<role> <path> <id>`, which is exactly what a
+	* reader needs to find the resolver that blew up. A warning with no key would
+	* tell them a display resolver failed somewhere in a list of fifty rows.
+	*
+	* `console.warn` rather than a thrown error, because this runs while a row is
+	* rendering: the contract is that a title which cannot be fetched must not
+	* take down the row that shows it.
+	*/
+	fail(key, error) {
+		console.warn(`[rebase] Could not resolve display value for ${key}:`, error);
+		this.set(key, null);
+	}
+	emit() {
+		for (const listener of [...this.listeners]) listener();
+	}
+};
+/**
+* Empty strings and empty arrays are absences, not values — a title of `"  "`
+* would otherwise beat the derived one and render as a blank heading.
+*/
+function normalize(value) {
+	if (value === void 0 || value === null) return null;
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		return trimmed.length > 0 ? trimmed : null;
+	}
+	if (Array.isArray(value)) return value.length > 0 ? value : null;
+	return value;
+}
+function isPromise(value) {
+	return typeof value?.then === "function";
+}
+//#endregion
 //#region src/collections/filter-operator-resolution.ts
 /**
 * Default operators offered per property type, before engine capabilities and
@@ -17497,115 +18085,6 @@ function resolveFilterOperators({ property, isArray, engine }) {
 	return typeDefaults.filter((op) => engineOps.has(op) && (narrowingSet === void 0 || narrowingSet.has(op)));
 }
 //#endregion
-//#region src/collections/property_presentation.ts
-function isReadOnly(property) {
-	if (property.admin?.readOnly) return true;
-	if (property.type === "date") {
-		if (property.autoValue) return true;
-	}
-	if (property.type === "reference") return !property.path && !("Field" in (property.admin || {}) && property.admin?.Field);
-	return false;
-}
-function isHidden(property) {
-	return typeof property.admin?.disabled === "object" && Boolean(property.admin?.disabled.hidden);
-}
-function applyPropertyConditions(property, context) {
-	const { conditions } = property;
-	if (!conditions) return property;
-	const result = { ...property };
-	if (conditions.disabled) {
-		if (evaluateCondition(conditions.disabled, context)) {
-			result.admin = result.admin || {};
-			result.admin.disabled = {
-				clearOnDisabled: conditions.clearOnDisabled ?? false,
-				disabledMessage: conditions.disabledMessage,
-				hidden: false
-			};
-		}
-	}
-	if (conditions.hidden) {
-		if (evaluateCondition(conditions.hidden, context)) {
-			result.admin = result.admin || {};
-			result.admin.disabled = {
-				...typeof result.admin?.disabled === "object" ? result.admin.disabled : {},
-				hidden: true,
-				clearOnDisabled: conditions.clearOnDisabled ?? false
-			};
-		}
-	}
-	if (conditions.readOnly) {
-		if (evaluateCondition(conditions.readOnly, context)) {
-			result.admin = result.admin || {};
-			result.admin.readOnly = true;
-		}
-	}
-	if (conditions.required !== void 0) {
-		const isRequired = evaluateCondition(conditions.required, context);
-		result.validation = {
-			...result.validation,
-			required: isRequired,
-			requiredMessage: conditions.requiredMessage
-		};
-	}
-	if (context.isNew && conditions.defaultValue !== void 0) result.defaultValue = evaluateCondition(conditions.defaultValue, context);
-	if ("enum" in result && result.enum && (conditions.enumConditions || conditions.allowedEnumValues || conditions.excludedEnumValues)) result.enum = applyEnumConditions(result.enum, conditions, context);
-	if (result.type === "reference") {
-		if (conditions.referencePath) result.path = evaluateCondition(conditions.referencePath, context);
-		if (conditions.referenceFilter) {
-			result.admin = result.admin || {};
-			result.admin.fixedFilter = evaluateCondition(conditions.referenceFilter, context);
-		}
-	}
-	if (result.type === "array") {
-		if (conditions.canAddElements !== void 0) {
-			result.admin = result.admin || {};
-			result.admin.canAddElements = evaluateCondition(conditions.canAddElements, context);
-		}
-		if (conditions.sortable !== void 0) {
-			result.admin = result.admin || {};
-			result.admin.sortable = evaluateCondition(conditions.sortable, context);
-		}
-	}
-	return result;
-}
-/**
-* Convert an object with numeric keys back to an array.
-* Firestore stores arrays as {"0": "a", "1": "b"} to avoid nested arrays.
-*/
-function objectToArray(obj) {
-	if (Array.isArray(obj)) return obj.map(String);
-	if (obj && typeof obj === "object") {
-		const keys = Object.keys(obj);
-		if (keys.length > 0 && keys.every((k) => !isNaN(Number(k)))) return keys.sort((a, b) => Number(a) - Number(b)).map((k) => obj[k]).filter((v) => typeof v === "string" || typeof v === "number").map(String);
-	}
-	return [];
-}
-/**
-* Apply enum-specific conditions to filter and modify enum values.
-*/
-function applyEnumConditions(enumValues, conditions, context) {
-	let result = [...enumValues];
-	if (conditions.allowedEnumValues) {
-		const allowedArray = objectToArray(evaluateCondition(conditions.allowedEnumValues, context));
-		if (allowedArray.length > 0) result = result.filter((ev) => allowedArray.includes(String(ev.id)));
-	}
-	if (conditions.excludedEnumValues) {
-		const excludedArray = objectToArray(evaluateCondition(conditions.excludedEnumValues, context));
-		if (excludedArray.length > 0) result = result.filter((ev) => !excludedArray.includes(String(ev.id)));
-	}
-	if (conditions.enumConditions) result = result.map((ev) => {
-		const evConditions = conditions.enumConditions?.[ev.id];
-		if (!evConditions) return ev;
-		if (evConditions.hidden && evaluateCondition(evConditions.hidden, context)) return null;
-		if (evConditions.disabled && evaluateCondition(evConditions.disabled, context)) return {
-			...ev,
-			disabled: true
-		};
-		return ev;
-	}).filter((ev) => ev !== null);
-	return result;
-}
-//#endregion
 //#region src/collections/form-layout.ts
 /**
 * Columns in the form grid.
@@ -17796,7 +18275,8 @@ function resolveFormLayout({ collection, fieldKeys, status }) {
 			title: section.title,
 			collapsible: section.collapsible ?? titled,
 			collapsed: titled ? Boolean(section.collapsed) : false,
-			fields
+			fields,
+			readVariant: section.readVariant
 		});
 	}
 	const leftovers = fieldKeys.map((key) => available.get(key)).filter((f) => Boolean(f));
@@ -18079,18 +18559,6 @@ function isHidden$1(property) {
 	return Boolean(property.admin?.hideFromCollection);
 }
 /**
-* File-storage backed content (single image, array of images, generic upload…).
-* Rendered by the dedicated image slot, so never a title.
-*/
-function isStorageProperty(property) {
-	if (property.type === "string" && (property.storage || property.admin?.urlPreview === "image")) return true;
-	if (property.type === "array" && property.of && !Array.isArray(property.of)) {
-		const inner = property.of;
-		if (inner.type === "string" && (inner.storage || inner.admin?.urlPreview === "image")) return true;
-	}
-	return false;
-}
-/**
 * Every column on this collection that stores a foreign key: the `localKey` of
 * each owning relation (declared inline on a property or in `relations[]`), the
 * source column of a junction, and the key a many-to-many joins on.
@@ -18170,7 +18638,8 @@ function scoreTitleCandidate(property, key, idKeys, foreignKeys) {
 */
 function getTitlePropertyCandidates(collection) {
 	if (!collection.properties) return [];
-	if (collection.titleProperty && collection.properties[collection.titleProperty]) return [collection.titleProperty];
+	const declared = getDisplayPropertyKey(collection, "title");
+	if (declared && getPropertyInPath(collection.properties, declared)) return [declared];
 	const idKeys = new Set(getPrimaryKeys(collection));
 	const foreignKeys = getForeignKeyColumns(collection);
 	const explicitOrder = collection.propertiesOrder;
@@ -18213,7 +18682,7 @@ function getTitlePropertyCandidates(collection) {
 */
 function getLeadingRelationTitleKey(collection) {
 	if (!collection.properties) return void 0;
-	if (collection.titleProperty) return void 0;
+	if (hasDeclaredDisplay(collection, "title")) return void 0;
 	const idKeys = new Set(getPrimaryKeys(collection));
 	const foreignKeys = getForeignKeyColumns(collection);
 	const order = collection.propertiesOrder ?? Object.keys(collection.properties);
@@ -18274,6 +18743,6 @@ function getTitlePropertyKeyForValues(collection, values, entityId) {
 	return candidates[0];
 }
 //#endregion
-export { AIIcon, AIModifiedIndicator, AdminModeControllerContext, AdminModeControllerProvider, AnalyticsContext, ApiConfigProvider, AuthControllerContext, CONTAINER_FULL_WIDTH, CollectionComponentOverrideProvider, CollectionResolverRegistrationContext, CollectionScopeContext, CollectionScopeProvider, ComponentOverrideContext, ConfirmationDialog, CrmDashboardDemo, CustomizationControllerContext, DEFAULT_API_PATH, DEFAULT_PAGE_SIZE, DataDriverContext, DataSourcesContext, DialogsControllerContext, DialogsProvider, EffectiveRoleControllerContext, EffectiveRoleControllerProvider, ErrorTooltip, ErrorView, FORM_CONTAINER_WIDTH, GlobalComponentOverrideProvider, IconForView, LanguageToggle, LoginView, ModeControllerContext, ModeControllerProvider, NavigationBlockerProvider, NotFoundPage, PluginProviderStack, REBASE_LOCALE_STORAGE_KEY, Rebase, RebaseAuth, RebaseClientInstanceContext, RebaseDataContext, RebaseI18nProvider, RebaseLogo, RebaseRegistryProvider, RebaseRouter, RebaseRoutes, SIDE_PANEL_DEFAULT_WIDTH, STUDIO_NAVIGATION_GROUPS, SchemaDriftBanner, SchemaDriftProvider, SnackbarProvider, StorageSourceContext, StorageSourcesContext, StudioBridgeContext, StudioBridgeProvider, StudioBridgeRegistryContext, StudioBridgeRegistryProvider, UIReferenceView, UIStyleGuide, UnsavedChangesDialog, UserConfigurationPersistenceContext, UserDisplay, UserSelectPopover, UserSettingsView, addInitialSlash, apiBaseOf, applyPropertyConditions, buildCollapsedDefaults, buildEnumLabel, clearAuthConfigCache, clearFetchCache, createAuthConfigCache, createFormexStub, deleteEntityWithCallbacks, deriveSpan, en, es, fetchAuthConfig, fillRows, flattenKeys, getAdminEntityChildViews, getAdminSubcollections, getCollectionBySlugWithin, getCollectionPathsCombinations, getColorScheme, getColumnKeysForProperty, getEntityFromCache, getEntityFromMemoryCache, getEntityImagePreviewPropertyKey, getEntityPreviewKeys, getEntityTitlePropertyKey, getFormFieldKeys, getIcon, getLastSegment, getLeadingRelationTitleKey, getLocalChangesBackup, getNavigationEntriesFromPath, getParentReferencesFromPath, getRelationIncludeParams, getRowHeight, getSubcollectionColumnId, getTitlePropertyCandidates, getTitlePropertyKey, getTitlePropertyKeyForValues, iconsSearch, isAuditTimestamp, isEnumValueDisabled, isFilterableRelation, isHidden, isIdPropertyEditable, isReadOnly, isSchemaDriftError, looksLikeIdentifierValue, populateFetchCache, removeEntityFromCache, removeEntityFromMemoryCache, removeInitialAndTrailingSlashes, removeInitialSlash, removeTrailingSlash, resolveCollectionPathIds, resolveComponentRef, resolveDefaultSelectedView, resolveFilterOperators, resolveFormLayout, saveEntityToCache, saveEntityToMemoryCache, saveEntityWithCallbacks, useAdminModeController, useAnalyticsController, useApiBase, useApiConfig, useAuthController, useAuthSubscription, useBackendStorageSource, useBridgeRegistration, useBrowserTitleAndIcon, useBuildAdminModeController, useBuildEffectiveRoleController, useBuildLocalConfigurationPersistence, useBuildModeController, useClipboard, useCollapsedGroups, useCollection, useCollectionScope, useColumnIds, useComponentOverride, useCustomizationController, useData, useDataSources, useDataTableController, useDebouncedData, useDialogsController, useEffectiveRoleController, useFetch, useLargeLayout, useModeController, useNavigationBlocker, usePermissions, useRebaseAuthController, useRebaseClient, useRebaseContext, useRebaseRegistry, useRebaseRegistryDispatch, useRelationSelector, useResolvedComponent, useRestoreScroll, useSchemaDriftContext, useScrollRestoration, useSlot, useSnackbarController, useStorageSource, useStorageSources, useStorageUploadController, useStudioBreadcrumbs, useStudioCapabilities, useStudioCollectionRegistry, useStudioNavigationState, useStudioSidePanelController, useStudioUrlController, useTranslation, useUnsavedChangesDialog, useUserConfigurationPersistence };
+export { AIIcon, AIModifiedIndicator, AdminModeControllerContext, AdminModeControllerProvider, AnalyticsContext, ApiConfigProvider, AuthControllerContext, CONTAINER_FULL_WIDTH, CollectionComponentOverrideProvider, CollectionResolverRegistrationContext, CollectionScopeContext, CollectionScopeProvider, ComponentOverrideContext, ConfirmationDialog, CrmDashboardDemo, CustomizationControllerContext, DEFAULT_API_PATH, DEFAULT_PAGE_SIZE, DataDriverContext, DataSourcesContext, DialogsControllerContext, DialogsProvider, EffectiveRoleControllerContext, EffectiveRoleControllerProvider, EntityDisplayCache, ErrorTooltip, ErrorView, FORM_CONTAINER_WIDTH, GlobalComponentOverrideProvider, IconForView, LanguageToggle, LoginView, ModeControllerContext, ModeControllerProvider, NavigationBlockerProvider, NotFoundPage, PluginProviderStack, REBASE_LOCALE_STORAGE_KEY, Rebase, RebaseAuth, RebaseClientInstanceContext, RebaseDataContext, RebaseI18nProvider, RebaseLogo, RebaseRegistryProvider, RebaseRouter, RebaseRoutes, SIDE_PANEL_DEFAULT_WIDTH, STUDIO_NAVIGATION_GROUPS, SUMMARY_RANK, SchemaDriftBanner, SchemaDriftProvider, SnackbarProvider, StorageSourceContext, StorageSourcesContext, StudioBridgeContext, StudioBridgeProvider, StudioBridgeRegistryContext, StudioBridgeRegistryProvider, UIReferenceView, UIStyleGuide, UnsavedChangesDialog, UserConfigurationPersistenceContext, UserDisplay, UserSelectPopover, UserSettingsView, addInitialSlash, apiBaseOf, applyPropertyConditions, buildCollapsedDefaults, buildEnumLabel, canSummariseProperty, clearAuthConfigCache, clearFetchCache, createAuthConfigCache, createFormexStub, deleteEntityWithCallbacks, deriveSpan, en, entityDisplayKey, es, fetchAuthConfig, fillRows, flattenKeys, getAdminEntityChildViews, getAdminSubcollections, getCollectionBySlugWithin, getCollectionPathsCombinations, getColorScheme, getColumnKeysForProperty, getDisplayPropertyKey, getDisplayResolver, getEntityFromCache, getEntityFromMemoryCache, getEntityImagePreviewPropertyKey, getEntityPreviewKeys, getEntityTitlePropertyKey, getFormFieldKeys, getIcon, getLastSegment, getLeadingRelationTitleKey, getLocalChangesBackup, getNavigationEntriesFromPath, getParentReferencesFromPath, getPropertyInPath, getRedundantChildViewColumnIds, getRelationIncludeParams, getRowHeight, getSubcollectionColumnId, getTitlePropertyCandidates, getTitlePropertyKey, getTitlePropertyKeyForValues, hasDeclaredDisplay, iconsSearch, isAuditTimestamp, isDisabled, isEnumValueDisabled, isFilterableRelation, isHidden, isIdPropertyEditable, isLongTextProperty, isReadOnly, isSchemaDriftError, isStorageProperty, looksLikeIdentifierValue, populateFetchCache, rankSummaryProperty, removeEntityFromCache, removeEntityFromMemoryCache, removeInitialAndTrailingSlashes, removeInitialSlash, removeTrailingSlash, resolveCollectionPathIds, resolveComponentRef, resolveDefaultSelectedView, resolveFilterOperators, resolveFormLayout, saveEntityToCache, saveEntityToMemoryCache, saveEntityWithCallbacks, useAdminModeController, useAnalyticsController, useApiBase, useApiConfig, useAuthController, useAuthSubscription, useBackendStorageSource, useBridgeRegistration, useBrowserTitleAndIcon, useBuildAdminModeController, useBuildEffectiveRoleController, useBuildLocalConfigurationPersistence, useBuildModeController, useClipboard, useCollapsedGroups, useCollection, useCollectionScope, useColumnIds, useComponentOverride, useCustomizationController, useData, useDataSources, useDataTableController, useDebouncedData, useDialogsController, useEffectiveRoleController, useFetch, useLargeLayout, useModeController, useNavigationBlocker, usePermissions, useRebaseAuthController, useRebaseClient, useRebaseContext, useRebaseRegistry, useRebaseRegistryDispatch, useRelationSelector, useResolvedComponent, useRestoreScroll, useSchemaDriftContext, useScrollRestoration, useSlot, useSnackbarController, useStorageSource, useStorageSources, useStorageUploadController, useStudioBreadcrumbs, useStudioCapabilities, useStudioCollectionRegistry, useStudioNavigationState, useStudioSidePanelController, useStudioUrlController, useTranslation, useUnsavedChangesDialog, useUserConfigurationPersistence };
 
 //# sourceMappingURL=index.es.js.map