@rebasepro/app 0.13.0 → 0.13.1-canary.g3660bd5

package/dist/index.es.js

@@ -1,6 +1,7 @@
 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";
@@ -13,7 +14,6 @@ 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,97 @@ function SchemaDriftBanner({ className }) {
 	});
 }
 //#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 +525,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 = ["*"];
 /**
@@ -1254,7 +1357,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);
 			});
 		}
@@ -2325,21 +2436,32 @@ 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/components/common/useColumnsIds.tsx
 function getSubcollectionColumnId(collection) {
 	return `subcollection:${collection.slug}`;
 }
@@ -9821,6 +9943,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 +10755,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 +10844,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 +11701,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 +12548,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 +13395,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",
@@ -14114,6 +14242,7 @@ var hi = {
 	column_cannot_be_edited: "इस कॉलम को सीधे संपादित नहीं किया जा सकता",
 	close: "बंद करें",
 	hide_list: "सूची छिपाएँ",
+	show_list: "सूची दिखाएँ",
 	unsaved_local_changes: "सहेजे नहीं गए स्थानीय परिवर्तन",
 	unsaved_local_changes_description: "इस दस्तावेज़ को स्थानीय स्तर पर संपादित किया गया था और इसमें सहेजे नहीं गए परिवर्तन हैं। यदि आप इन्हें लागू नहीं करते हैं तो ये स्थानीय परिवर्तन खो जाएंगे।",
 	preview_changes: "परिवर्तनों का पूर्वावलोकन करें",
@@ -14965,6 +15094,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 +15970,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 +16336,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;
@@ -17359,8 +17496,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 +17598,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
@@ -17796,7 +18143,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 +18427,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 +18506,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 +18550,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 +18611,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, getRelationIncludeParams, getRowHeight, getSubcollectionColumnId, getTitlePropertyCandidates, getTitlePropertyKey, getTitlePropertyKeyForValues, hasDeclaredDisplay, iconsSearch, isAuditTimestamp, 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