@rebasepro/admin 0.13.0 → 0.13.1-canary.g249daa1

package/dist/form/components/FieldBlock.d.ts

@@ -1,5 +1,21 @@
 import type { Property } from "@rebasepro/types";
+import type { PropertySpan } from "@rebasepro/admin-types";
 import React from "react";
+/**
+ * Grid placement for a span.
+ *
+ * Written out as literal class strings rather than composed, because Tailwind
+ * scans source text: a template literal would produce classes that exist at
+ * runtime and were never generated into the stylesheet.
+ *
+ * Below the column breakpoint every field takes the single available column, so
+ * the side panel, the dialog and mobile all get a plain stack.
+ *
+ * Lives here rather than in the form, because the read-only rendering of a
+ * record places its fields on the same grid — a record that changes shape when
+ * you press Edit is the bug this whole layout exists to avoid.
+ */
+export declare function spanClass(span: PropertySpan): string;
 /**
  * Does this property's editor supply its own heading?
  *
@@ -13,18 +29,56 @@ import React from "react";
  * in step: the self-labelling types are exactly the ones that take a full row.
  */
 export declare function isSelfLabellingProperty(property: Property | undefined): boolean;
+/**
+ * The type icon in a field label, in px.
+ *
+ * Matched to the label's 13px rather than taken from `iconSize.smallest` (16),
+ * which is sized for buttons. Exported so the surfaces that draw a label
+ * themselves — the additional-field cards, the rail — can stay in step.
+ */
+export declare const LABEL_ICON_SIZE = 14;
 export interface FieldBlockProps {
     propertyKey: string;
     property?: Property;
     /** Rendered by the form rather than by the field, unless self-labelling. */
     showLabel: boolean;
+    /**
+     * Which of the two renderings this block frames.
+     *
+     * The **label is identical in both** — same size, same weight, same colour,
+     * same type icon, same required marker. A field is the same field whether or
+     * not you are editing it, and a record whose labels restyle themselves under
+     * Edit reads as two different screens.
+     *
+     * What `"read"` drops is the *description*, which is not part of the label:
+     * it is input help. "Sum of all line items before tax and shipping" under a
+     * number that is visibly a sum tells a reader nothing, and a line of it
+     * under every field is what a record has instead of room.
+     */
+    mode?: "edit" | "read";
+    /**
+     * Label text, when there is no property to take it from.
+     *
+     * For additional fields, which are columns a collection computes rather
+     * than stores. They go on the same grid as the properties and so have to
+     * carry the same label — drawing their own is how they ended up a size out
+     * and a couple of pixels off from the field beside them.
+     */
+    label?: string;
+    /** Type icon, when there is no property to derive one from. */
+    icon?: React.ReactNode;
     children: React.ReactNode;
 }
 /**
  * One field's worth of the form grid: label, control, description.
  *
- * The label carries a small type icon so a number reads differently from a
- * relation at a glance, and the description sits under the control where it
- * annotates what you just filled in.
+ * The same block frames the read-only rendering of a record, so a field sits in
+ * the same place, at the same width, under the same label whether or not you are
+ * editing it — see {@link EntityViewBinding}.
+ *
+ * The label is one size down from the control it names (13px against the body's
+ * 14) with its icon matched to it at 14px. Labels are scaffolding: you read them
+ * to find the value, then read the value. Setting them at body size made a
+ * column of records scan as a column of field names with data attached.
  */
-export declare function FieldBlock({ propertyKey, property, showLabel, children }: FieldBlockProps): React.JSX.Element;
+export declare function FieldBlock({ propertyKey, property, showLabel, mode, label, icon, children }: FieldBlockProps): React.JSX.Element;

package/dist/form/components/FormRail.d.ts

@@ -16,3 +16,16 @@ export interface FormRailProps {
  * visible while you scroll.
  */
 export declare function FormRail({ fields, showRecordMeta, entity, renderField }: FormRailProps): React.JSX.Element | null;
+/**
+ * The record's id and audit timestamps.
+ *
+ * Exported because the rail is not the only place it renders. The rail is shown
+ * only when it has been *measured* to fit, and every layout narrower than that —
+ * the split pane, the side panel, the dialog — folds its contents back into the
+ * column. The fields folded back but this block did not, so on three of the four
+ * layouts a record simply had no id on screen: the only copy of it was the
+ * truncated `e166a394…b422` chip in the identity bar.
+ */
+export declare function RecordMeta({ entity }: {
+    entity: Entity<Record<string, unknown>>;
+}): React.JSX.Element;

package/dist/form/components/FormSections.d.ts

@@ -12,5 +12,19 @@ export interface FormSectionsProps {
      */
     errorKeys: ReadonlySet<string>;
     renderField: (field: ResolvedFormField) => React.ReactNode;
+    /**
+     * Which rendering this is. `"read"` opens the gaps up rather than closing
+     * them: a control is a bordered 40px box that separates itself from the next
+     * one, and a value is bare text that does not. The form can also afford
+     * tighter rows because a description usually sits between them; with that
+     * gone, the same numbers ran a record's values together into one block.
+     */
+    mode?: "edit" | "read";
+    /**
+     * Renders one field as a summary row, for a section that asked for
+     * `readVariant: "summary"`. Only the read view supplies it; without it such
+     * a section falls back to the grid rather than to nothing.
+     */
+    renderSummaryField?: (field: ResolvedFormField, index: number, total: number) => React.ReactNode;
 }
-export declare function FormSections({ sections, collapsed, onToggle, errorKeys, renderField }: FormSectionsProps): React.JSX.Element;
+export declare function FormSections({ sections, collapsed, onToggle, errorKeys, renderField, mode, renderSummaryField }: FormSectionsProps): React.JSX.Element;

package/dist/form/components/useRailVisible.d.ts

@@ -2,10 +2,11 @@ import React from "react";
 /**
  * Below this the form is a single column and the rail is not shown.
  *
- * Roughly the 288px rail plus a content column still wide enough to hold a
- * four-up row. Above it the rail is worth having even in the split view; below
- * it — a narrow split pane, the side panel, the dialog, a phone — its fields
- * fold back into the column.
+ * Roughly the 320px rail plus a content column still wide enough to hold a
+ * four-up row — at the threshold that leaves ~680px, which is four columns of
+ * ~145px once the gutters are taken out. Above it the rail is worth having even
+ * in the split view; below it — a narrow split pane, the side panel, the dialog,
+ * a phone — its fields fold back into the column.
  */
 export declare const RAIL_MIN_WIDTH = 1000;
 /**

package/dist/form/form_utils.d.ts

@@ -1,9 +1,46 @@
 import type { PropertyConfig, AdminCollection } from "@rebasepro/admin-types";
-import type { Entity, EntityValues } from "@rebasepro/types";
+import type { Entity, EntityStatus, EntityValues } from "@rebasepro/types";
 import type { AuthController } from "@rebasepro/admin-types";
 import { z } from "zod";
 export declare function extractTouchedValues(values: unknown, touched: Record<string, boolean>): Record<string, unknown>;
 export declare function removeEmptyContainers(obj: unknown): unknown;
 export declare function getChanges<T extends object>(source: Partial<T>, comparison: Partial<T>): Partial<T>;
+/**
+ * What the local-changes backup still has to offer, given what the form is
+ * already showing — the answer the "unsaved local changes" banner is asking for.
+ * `undefined` means there is nothing left to apply, and no banner.
+ *
+ * Measured against what the form *opens showing*, not against the stored
+ * record. The banner exists to offer a draft the form is not already displaying,
+ * and an edit carried across a change of layout is in both the backup and the
+ * form: measuring against the stored values alone offered to restore the values
+ * already on screen, over an edit the user had never left.
+ */
+export declare function getUnappliedLocalChanges<M extends Record<string, unknown>>(backupValues: Partial<M>, openingValues: Partial<M>): Partial<M> | undefined;
+/**
+ * What travels when the same record changes layout — the split's "hide list",
+ * full screen's "show list", the side panel's "open full screen". One mounted
+ * form is replaced by another showing the same record, so the edit in progress
+ * has to be handed over; left to the local-changes backup alone, the new form
+ * met it as a draft from a closed tab and raised the "unsaved local changes"
+ * banner over changes the user had made a second earlier and never left.
+ *
+ * Returns `undefined` when there is nothing to carry, which is its own answer: a
+ * record nobody edited must open in the next layout exactly as clean as it was.
+ *
+ * Only what was edited here travels, keyed by `touched` — the same subset the
+ * backup stores. Carrying the whole record instead marks every field touched in
+ * the receiving form, which lights up every empty required field as an error and
+ * writes the entire record back out as a "local change".
+ */
+export declare function getEditHandoffValues<M extends Record<string, unknown>>({ status, dirty, values, touched, storedValues }: {
+    status: EntityStatus;
+    /** Whether `values` differ from what is stored. */
+    dirty: boolean;
+    values: Partial<M>;
+    touched: Record<string, boolean>;
+    /** The stored record, for the fallback below. Absent for a new one. */
+    storedValues?: Partial<M>;
+}): Partial<M> | undefined;
 export declare function getInitialEntityValues<M extends Record<string, unknown>>(authController: AuthController, collection: AdminCollection, path: string, status: "new" | "existing" | "copy", entity: Entity<M> | undefined, propertyConfigs?: Record<string, PropertyConfig>): Partial<EntityValues<M>>;
 export declare function zodToFormErrors(zodError: z.ZodError): Record<string, string>;

package/dist/{history-D7L_JlLO.js → history-By7QT3V0.js}

@@ -1,4 +1,4 @@
-import { et as useHistory, hn as PropertyPreview, pr as getPropertyInPath } from "./util-GiwPgxnL.js";
+import { Y as useHistory, _n as PropertyPreview, gr as getPropertyInPath$1 } from "./util-B8hurkxt.js";
 import * as React$1 from "react";
 import { useEffect, useRef, useState } from "react";
 import { ArrowLeftIcon, Chip, ErrorBoundary, HistoryIcon, IconButton, Label, Tooltip, Typography, cls, defaultBorderMixin, iconSize } from "@rebasepro/ui";
@@ -87,7 +87,7 @@ function EntityHistoryEntry({ actions, hover, collection, size, entry }) {
 		const all = entry.changed_fields;
 		if (!all || !collection) return all;
 		return all.filter((key) => {
-			const property = getPropertyInPath(collection.properties, key);
+			const property = getPropertyInPath$1(collection.properties, key);
 			if (!property) return true;
 			if ("isId" in property && property.isId) return false;
 			return !(property.type === "date" && "autoValue" in property && property.autoValue);
@@ -123,7 +123,7 @@ function EntityHistoryEntry({ actions, hover, collection, size, entry }) {
 			children: [actions, /* @__PURE__ */ jsxs("div", {
 				className: "flex flex-col grow w-full m-1 shrink min-w-0",
 				children: [changedFields && collection && changedFields.map((key) => {
-					const childProperty = getPropertyInPath(collection.properties, key);
+					const childProperty = getPropertyInPath$1(collection.properties, key);
 					const valueInPath = entry.values ? getValueInPath(entry.values, key) : void 0;
 					const previousValueInPath = previousValues ? getValueInPath(previousValues, key) : void 0;
 					const element = childProperty ? /* @__PURE__ */ jsx(PropertyPreview, {
@@ -310,4 +310,4 @@ function EntityHistoryView({ entity, collection, formContext, refreshToken }) {
 //#endregion
 export { EntityHistoryView };
 
-//# sourceMappingURL=history-D7L_JlLO.js.map
+//# sourceMappingURL=history-By7QT3V0.js.map

package/dist/{history-D7L_JlLO.js.map → history-By7QT3V0.js.map}

@@ -1 +1 @@
-{"version":3,"file":"history-D7L_JlLO.js","names":[],"sources":["../src/components/history/UserChip.tsx","../src/components/history/EntityHistoryEntry.tsx","../src/components/history/EntityHistoryView.tsx"],"sourcesContent":["import { User } from \"@rebasepro/types\";\nimport { Chip, Tooltip } from \"@rebasepro/ui\";\n\nexport function UserChip({ user }: { user: User }) {\n    return (\n        <Tooltip title={user.email ?? user.uid}>\n            <Chip size={\"small\"} className={\"flex items-center\"}>\n                {user.photoURL && <img\n                    className={\"rounded-full w-6 h-6 mr-2\"}\n                    src={user.photoURL} alt={user.displayName ?? \"User picture\"}/>}\n                <span>{user.displayName ?? user.email ?? user.uid}</span>\n            </Chip>\n        </Tooltip>\n    );\n}\n","\nimport type { Property } from \"@rebasepro/types\";\nimport * as React from \"react\";\n\nimport { ArrowLeftIcon, Chip, cls, defaultBorderMixin, iconSize, Tooltip, Typography } from \"@rebasepro/ui\";\nimport { PreviewSize } from \"../../types/components/PropertyPreviewProps\";\nimport { getPropertyInPath } from \"../../util/property_utils\";\nimport { PropertyPreview } from \"../../preview/PropertyPreview\";\nimport { SkeletonPropertyComponent } from \"../../preview/property_previews/SkeletonPropertyComponent\";\nimport { useAuthController } from \"@rebasepro/app\";\nimport { UserChip } from \"./UserChip\";\nimport { HistoryEntryData } from \"../../hooks\";\nimport { getValueInPath } from \"@rebasepro/utils\";\nimport type { AdminCollection } from \"@rebasepro/admin-types\";\n\n/**\n * Recursive deep equality for primitives, arrays and plain objects.\n */\nfunction deepEqual(a: unknown, b: unknown): boolean {\n    if (a === b) return true;\n    if (a == null || b == null) return a === b;\n    if (typeof a !== typeof b) return false;\n    if (typeof a !== \"object\") return false;\n\n    if (Array.isArray(a)) {\n        if (!Array.isArray(b) || a.length !== (b as unknown[]).length) return false;\n        return a.every((item, i) => deepEqual(item, (b as unknown[])[i]));\n    }\n\n    if (Array.isArray(b)) return false;\n\n    const aObj = a as Record<string, unknown>;\n    const bObj = b as Record<string, unknown>;\n    const aKeys = Object.keys(aObj);\n    const bKeys = Object.keys(bObj);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every(key => key in bObj && deepEqual(aObj[key], bObj[key]));\n}\n\nexport type EntityHistoryEntryProps = {\n    size: PreviewSize;\n    actions?: React.ReactNode;\n    collection?: AdminCollection;\n    hover?: boolean;\n    entry: HistoryEntryData;\n    onClick?: (e: React.SyntheticEvent) => void;\n};\n\nfunction PreviousValueView({\n    previousValueInPath,\n    childProperty,\n    propertyKey\n}: {\n    previousValueInPath: unknown;\n    childProperty: Property;\n    propertyKey: string;\n}) {\n    if (typeof previousValueInPath === \"string\" || typeof previousValueInPath === \"number\") {\n        return <Typography variant={\"caption\"} color={\"secondary\"} className=\"line-through\">\n            {previousValueInPath}\n        </Typography>;\n    } else if (typeof previousValueInPath === \"boolean\") {\n        return <Typography variant={\"caption\"} color={\"secondary\"} className=\"line-through\">\n            {previousValueInPath ? \"true\" : \"false\"}\n        </Typography>;\n    } else {\n        return <Tooltip\n            side={\"left\"}\n            title={<div className={\"flex flex-col gap-2\"}>\n                <Typography variant={\"caption\"} color={\"secondary\"}>\n                    Previous value\n                </Typography>\n                <PropertyPreview\n                    propertyKey={propertyKey as string}\n                    value={previousValueInPath as never}\n                    property={childProperty as Property}\n                    size={\"small\"}/>\n            </div>}>\n            <ArrowLeftIcon size={iconSize.smallest} color={\"disabled\"} className={\"mb-1\"}/>\n        </Tooltip>\n    }\n}\n\n/**\n * Displays a single entity history revision entry.\n * Adapted from the entity_history plugin — now reads from backend API data.\n */\nexport function EntityHistoryEntry({\n    actions,\n    hover,\n    collection,\n    size,\n    entry\n}: EntityHistoryEntryProps) {\n\n    const authController = useAuthController();\n\n    // The backend reports the whole row as changed, which includes the columns\n    // that cannot meaningfully change: a timestamp it stamps itself on every\n    // write, and the primary key, which is what identifies the row being\n    // revised. Every revision was listing `updated_at: <now>` and `id: <the id\n    // in the title bar>` around the one field the user actually edited.\n    const changedFields = React.useMemo(() => {\n        const all = entry.changed_fields;\n        if (!all || !collection) return all;\n        return all.filter(key => {\n            const property = getPropertyInPath(collection.properties, key);\n            if (!property) return true;\n            if (\"isId\" in property && property.isId) return false;\n            return !(property.type === \"date\" && \"autoValue\" in property && property.autoValue);\n        });\n    }, [entry.changed_fields, collection]);\n\n    const previousValues = entry.previous_values;\n    const updatedOn = new Date(entry.updated_at);\n    const updatedBy = entry.updated_by;\n\n    // Resolve user display\n    const currentUser = authController.user;\n    const userDisplay = updatedBy === currentUser?.uid\n        ? currentUser\n        : undefined;\n\n    return <div className={\"@container/histentry w-full flex flex-col gap-2\"}>\n        <div className={\"flex items-center flex-wrap gap-2\"}>\n            <Typography variant={\"body2\"} color={\"secondary\"}>\n                {updatedOn.toLocaleString()}\n            </Typography>\n            <Chip size={\"small\"}>\n                {entry.action}\n            </Chip>\n            {!userDisplay && updatedBy && <Chip size={\"small\"}>{updatedBy}</Chip>}\n            {userDisplay && <UserChip user={userDisplay}/>}\n        </div>\n        <div\n            className={cls(\n                \"bg-white dark:bg-surface-900\",\n                \"min-h-[44px]\",\n                \"w-full\",\n                \"items-center\",\n                hover ? \"hover:bg-surface-accent-50 dark:hover:bg-surface-800\" : \"\",\n                size === \"small\" ? \"p-1\" : \"px-2 py-1\",\n                \"flex border rounded-lg\",\n                defaultBorderMixin\n            )}>\n\n            {actions}\n\n            <div className={\"flex flex-col grow w-full m-1 shrink min-w-0\"}>\n\n                {changedFields && collection && changedFields.map((key: string) => {\n                    const childProperty = getPropertyInPath(collection.properties, key);\n                    const valueInPath = entry.values ? getValueInPath(entry.values, key) : undefined;\n                    const previousValueInPath = previousValues ? getValueInPath(previousValues, key) : undefined;\n\n                    const element = childProperty\n                        ? <PropertyPreview\n                            propertyKey={key}\n                            value={valueInPath as never}\n                            property={childProperty as Property}\n                            size={\"small\"}/>\n                        : <Typography variant={\"body2\"}>\n                            {typeof valueInPath === \"string\" ? valueInPath : JSON.stringify(valueInPath)}\n                        </Typography>;\n\n                    // The key column used to be `min-w-[200px] w-1/5` beside a\n                    // `w-4/5` value — 200px of label and 80% of the row, which\n                    // adds up to more than the row in anything narrower than a\n                    // full page. In the inspector that pushed every value off\n                    // the right edge and wrapped ids one character per line.\n                    // It stacks until the entry itself is wide enough.\n                    return (\n                        <div key={\"ref_prev_\" + key}\n                            className=\"flex flex-col @sm/histentry:flex-row @sm/histentry:items-baseline gap-x-4 gap-y-0.5 w-full my-1.5\">\n                            <Typography variant={\"caption\"}\n                                color={\"secondary\"}\n                                className=\"shrink-0 break-all @sm/histentry:w-40 @sm/histentry:text-right @sm/histentry:break-normal @sm/histentry:truncate\">\n                                {key}\n                            </Typography>\n                            <div className=\"min-w-0 flex-1 flex flex-col items-start gap-0.5\">\n                                {previousValueInPath !== undefined && !deepEqual(previousValueInPath, valueInPath) &&\n                                    <PreviousValueView previousValueInPath={previousValueInPath}\n                                        childProperty={childProperty as Property}\n                                        propertyKey={key}/>\n                                }\n                                {element}\n                            </div>\n                        </div>\n                    );\n                })}\n\n                {(!changedFields || changedFields.length === 0) && (\n                    <Typography variant={\"caption\"} color={\"secondary\"}>\n                        {entry.action === \"create\" ? \"Entity created\" :\n                            entry.action === \"delete\" ? \"Entity deleted\" : \"No field changes recorded\"}\n                    </Typography>\n                )}\n\n            </div>\n\n        </div>\n    </div>;\n}\n","\nimport type { EntityCustomViewParams } from \"@rebasepro/admin-types\";\nimport { useRef, useEffect } from \"react\";\nimport { cls, IconButton, Label, Tooltip, Typography } from \"@rebasepro/ui\";\nimport { ErrorBoundary, HistoryIcon } from \"@rebasepro/ui\";\nimport { EntityHistoryEntry } from \"./EntityHistoryEntry\";\nimport { useSnackbarController, useAuthController, useTranslation } from \"@rebasepro/app\";\nimport { ConfirmationDialog } from \"@rebasepro/app\";\nimport { useState } from \"react\";\nimport { useHistory } from \"../../hooks/useHistory\";\n\n/**\n * Entity history tab view. Shows a paginated list of entity revisions\n * fetched from the backend API. Supports infinite scroll and revert.\n */\nexport function EntityHistoryView<M extends Record<string, unknown>>({\n    entity,\n    collection,\n    formContext,\n    refreshToken\n}: EntityCustomViewParams<M> & {\n    /** Bumped once per save, so the list picks up the revision it just made. */\n    refreshToken?: number;\n}) {\n\n    const { t } = useTranslation();\n    const snackbarController = useSnackbarController();\n    const authController = useAuthController();\n    const dirty = formContext?.formex.dirty;\n\n    const slug = collection.slug;\n    const entityId = entity?.id;\n\n    const {\n        entries,\n        isLoading,\n        hasMore,\n        loadMore,\n        revert\n    } = useHistory({\n        slug,\n        entityId,\n        enabled: !!entityId,\n        pageSize: 10,\n        refreshToken\n    });\n\n    const [revertHistoryId, setRevertHistoryId] = useState<string | undefined>();\n    const [isReverting, setIsReverting] = useState(false);\n\n    const containerRef = useRef<HTMLDivElement>(null);\n    const loadMoreRef = useRef<HTMLDivElement>(null);\n\n    // Intersection observer for infinite scroll\n    useEffect(() => {\n        const currentContainer = containerRef.current;\n        const currentLoadMore = loadMoreRef.current;\n\n        if (!currentContainer || !currentLoadMore || !hasMore || isLoading) return;\n\n        const observer = new IntersectionObserver(\n            (observerEntries) => {\n                if (observerEntries[0].isIntersecting && hasMore && !isLoading) {\n                    loadMore();\n                }\n            },\n            {\n                root: currentContainer,\n                rootMargin: \"0px 0px 200px 0px\",\n                threshold: 0.01\n            }\n        );\n\n        observer.observe(currentLoadMore);\n\n        return () => observer.disconnect();\n    }, [hasMore, isLoading, entries.length, loadMore]);\n\n    if (!entity) {\n        return <div className=\"flex items-center justify-center h-full\">\n            <Label>{t(\"history_new_entity\") ?? \"History is only available for existing records\"}</Label>\n        </div>;\n    }\n\n    async function doRevert(historyId: string) {\n        setIsReverting(true);\n        try {\n            const revertedValues = await revert(historyId);\n            setRevertHistoryId(undefined);\n\n            // Reset the form with the reverted values so the UI updates\n            // immediately without requiring a page refresh.\n            if (formContext?.formex?.resetForm && revertedValues) {\n                formContext.formex.resetForm({\n                    values: revertedValues as M,\n                    submitCount: 0,\n                    touched: {}\n                });\n            }\n\n            snackbarController.open({\n                message: t(\"history_reverted\") ?? \"Reverted to selected version\",\n                type: \"info\"\n            });\n        } catch (error) {\n            console.error(\"Error reverting entity:\", error);\n            snackbarController.open({\n                message: t(\"history_revert_error\") ?? \"Error reverting entity\",\n                type: \"error\"\n            });\n        } finally {\n            setIsReverting(false);\n        }\n    }\n\n    const revertEntry = revertHistoryId\n        ? entries.find(e => e.id === revertHistoryId)\n        : undefined;\n\n    // `p-8` plus a `mt-24` heading were sized for a full-width tab that no\n    // longer exists. In the inspector panel that was 96px of nothing above the\n    // first revision, and 32px of gutter on each side of a 448px column.\n    return <div\n        ref={containerRef}\n        className={cls(\"relative flex-1 h-full overflow-auto w-full flex flex-col gap-4 p-4 sm:p-5\")}>\n        <div className=\"flex flex-col gap-2 max-w-6xl mx-auto w-full\">\n\n            {isLoading && entries.length === 0 && (\n                <div className=\"flex flex-col gap-4\">\n                    {[1, 2, 3].map(i => (\n                        <div key={i} className=\"flex flex-col gap-2 animate-pulse\">\n                            <div className=\"h-4 w-48 bg-surface-200 dark:bg-surface-700 rounded\"/>\n                            <div className=\"h-12 w-full bg-surface-100 dark:bg-surface-900 rounded-lg border border-surface-200 dark:border-surface-700\"/>\n                        </div>\n                    ))}\n                </div>\n            )}\n\n            {!isLoading && entries.length === 0 && <>\n                <Label>\n                    {t(\"history_empty\") ?? \"No history available\"}\n                </Label>\n                <Typography variant={\"caption\"}>\n                    {t(\"history_empty_description\") ?? \"When you save a record, a new version is created and stored in the history.\"}\n                </Typography>\n            </>}\n\n            {entries.map((entry) => (\n                <div key={entry.id} className=\"flex flex-col gap-2 w-full\">\n                    <EntityHistoryEntry\n                        entry={entry}\n                        collection={collection}\n                        size={\"medium\"}\n                        actions={\n                            <Tooltip title={t(\"history_revert\") ?? \"Revert to this version\"}\n                                className={\"m-2 grow-0 self-start\"}>\n                                <IconButton\n                                    onClick={() => {\n                                        if (dirty) {\n                                            snackbarController.open({\n                                                message: t(\"history_revert_dirty\") ?? \"Please save or discard your changes before reverting\",\n                                                type: \"warning\"\n                                            });\n                                        } else {\n                                            setRevertHistoryId(entry.id);\n                                        }\n                                    }}>\n                                    <HistoryIcon/>\n                                </IconButton>\n                            </Tooltip>\n                        }\n                    />\n                </div>\n            ))}\n\n            {/* Load more sentinel */}\n            {entries.length > 0 && (\n                <div ref={loadMoreRef} className=\"py-4 text-center\">\n                    {isLoading && <Label>{t(\"loading\")}</Label>}\n                    {!hasMore && entries.length > 10 && <Label>{t(\"history_no_more\") ?? \"No more history\"}</Label>}\n                </div>\n            )}\n        </div>\n\n        <ErrorBoundary>\n            <ConfirmationDialog\n                open={Boolean(revertHistoryId)}\n                onAccept={() => {\n                    if (revertHistoryId) doRevert(revertHistoryId);\n                }}\n                onCancel={() => setRevertHistoryId(undefined)}\n                title={<Typography variant={\"subtitle2\"}>{t(\"history_revert_title\") ?? \"Revert data to this version?\"}</Typography>}\n                body={revertEntry\n                    ? <div className=\"p-4\">\n                        <Typography variant={\"caption\"} color={\"secondary\"}>\n                            This will save the entity with the values from{\" \"}\n                            {new Date(revertEntry.updated_at).toLocaleString()}.\n                            A new history entry will be created for the revert.\n                        </Typography>\n                    </div>\n                    : null\n                }\n            />\n        </ErrorBoundary>\n    </div>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"history-By7QT3V0.js","names":[],"sources":["../src/components/history/UserChip.tsx","../src/components/history/EntityHistoryEntry.tsx","../src/components/history/EntityHistoryView.tsx"],"sourcesContent":["import { User } from \"@rebasepro/types\";\nimport { Chip, Tooltip } from \"@rebasepro/ui\";\n\nexport function UserChip({ user }: { user: User }) {\n    return (\n        <Tooltip title={user.email ?? user.uid}>\n            <Chip size={\"small\"} className={\"flex items-center\"}>\n                {user.photoURL && <img\n                    className={\"rounded-full w-6 h-6 mr-2\"}\n                    src={user.photoURL} alt={user.displayName ?? \"User picture\"}/>}\n                <span>{user.displayName ?? user.email ?? user.uid}</span>\n            </Chip>\n        </Tooltip>\n    );\n}\n","\nimport type { Property } from \"@rebasepro/types\";\nimport * as React from \"react\";\n\nimport { ArrowLeftIcon, Chip, cls, defaultBorderMixin, iconSize, Tooltip, Typography } from \"@rebasepro/ui\";\nimport { PreviewSize } from \"../../types/components/PropertyPreviewProps\";\nimport { getPropertyInPath } from \"../../util/property_utils\";\nimport { PropertyPreview } from \"../../preview/PropertyPreview\";\nimport { SkeletonPropertyComponent } from \"../../preview/property_previews/SkeletonPropertyComponent\";\nimport { useAuthController } from \"@rebasepro/app\";\nimport { UserChip } from \"./UserChip\";\nimport { HistoryEntryData } from \"../../hooks\";\nimport { getValueInPath } from \"@rebasepro/utils\";\nimport type { AdminCollection } from \"@rebasepro/admin-types\";\n\n/**\n * Recursive deep equality for primitives, arrays and plain objects.\n */\nfunction deepEqual(a: unknown, b: unknown): boolean {\n    if (a === b) return true;\n    if (a == null || b == null) return a === b;\n    if (typeof a !== typeof b) return false;\n    if (typeof a !== \"object\") return false;\n\n    if (Array.isArray(a)) {\n        if (!Array.isArray(b) || a.length !== (b as unknown[]).length) return false;\n        return a.every((item, i) => deepEqual(item, (b as unknown[])[i]));\n    }\n\n    if (Array.isArray(b)) return false;\n\n    const aObj = a as Record<string, unknown>;\n    const bObj = b as Record<string, unknown>;\n    const aKeys = Object.keys(aObj);\n    const bKeys = Object.keys(bObj);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every(key => key in bObj && deepEqual(aObj[key], bObj[key]));\n}\n\nexport type EntityHistoryEntryProps = {\n    size: PreviewSize;\n    actions?: React.ReactNode;\n    collection?: AdminCollection;\n    hover?: boolean;\n    entry: HistoryEntryData;\n    onClick?: (e: React.SyntheticEvent) => void;\n};\n\nfunction PreviousValueView({\n    previousValueInPath,\n    childProperty,\n    propertyKey\n}: {\n    previousValueInPath: unknown;\n    childProperty: Property;\n    propertyKey: string;\n}) {\n    if (typeof previousValueInPath === \"string\" || typeof previousValueInPath === \"number\") {\n        return <Typography variant={\"caption\"} color={\"secondary\"} className=\"line-through\">\n            {previousValueInPath}\n        </Typography>;\n    } else if (typeof previousValueInPath === \"boolean\") {\n        return <Typography variant={\"caption\"} color={\"secondary\"} className=\"line-through\">\n            {previousValueInPath ? \"true\" : \"false\"}\n        </Typography>;\n    } else {\n        return <Tooltip\n            side={\"left\"}\n            title={<div className={\"flex flex-col gap-2\"}>\n                <Typography variant={\"caption\"} color={\"secondary\"}>\n                    Previous value\n                </Typography>\n                <PropertyPreview\n                    propertyKey={propertyKey as string}\n                    value={previousValueInPath as never}\n                    property={childProperty as Property}\n                    size={\"small\"}/>\n            </div>}>\n            <ArrowLeftIcon size={iconSize.smallest} color={\"disabled\"} className={\"mb-1\"}/>\n        </Tooltip>\n    }\n}\n\n/**\n * Displays a single entity history revision entry.\n * Adapted from the entity_history plugin — now reads from backend API data.\n */\nexport function EntityHistoryEntry({\n    actions,\n    hover,\n    collection,\n    size,\n    entry\n}: EntityHistoryEntryProps) {\n\n    const authController = useAuthController();\n\n    // The backend reports the whole row as changed, which includes the columns\n    // that cannot meaningfully change: a timestamp it stamps itself on every\n    // write, and the primary key, which is what identifies the row being\n    // revised. Every revision was listing `updated_at: <now>` and `id: <the id\n    // in the title bar>` around the one field the user actually edited.\n    const changedFields = React.useMemo(() => {\n        const all = entry.changed_fields;\n        if (!all || !collection) return all;\n        return all.filter(key => {\n            const property = getPropertyInPath(collection.properties, key);\n            if (!property) return true;\n            if (\"isId\" in property && property.isId) return false;\n            return !(property.type === \"date\" && \"autoValue\" in property && property.autoValue);\n        });\n    }, [entry.changed_fields, collection]);\n\n    const previousValues = entry.previous_values;\n    const updatedOn = new Date(entry.updated_at);\n    const updatedBy = entry.updated_by;\n\n    // Resolve user display\n    const currentUser = authController.user;\n    const userDisplay = updatedBy === currentUser?.uid\n        ? currentUser\n        : undefined;\n\n    return <div className={\"@container/histentry w-full flex flex-col gap-2\"}>\n        <div className={\"flex items-center flex-wrap gap-2\"}>\n            <Typography variant={\"body2\"} color={\"secondary\"}>\n                {updatedOn.toLocaleString()}\n            </Typography>\n            <Chip size={\"small\"}>\n                {entry.action}\n            </Chip>\n            {!userDisplay && updatedBy && <Chip size={\"small\"}>{updatedBy}</Chip>}\n            {userDisplay && <UserChip user={userDisplay}/>}\n        </div>\n        <div\n            className={cls(\n                \"bg-white dark:bg-surface-900\",\n                \"min-h-[44px]\",\n                \"w-full\",\n                \"items-center\",\n                hover ? \"hover:bg-surface-accent-50 dark:hover:bg-surface-800\" : \"\",\n                size === \"small\" ? \"p-1\" : \"px-2 py-1\",\n                \"flex border rounded-lg\",\n                defaultBorderMixin\n            )}>\n\n            {actions}\n\n            <div className={\"flex flex-col grow w-full m-1 shrink min-w-0\"}>\n\n                {changedFields && collection && changedFields.map((key: string) => {\n                    const childProperty = getPropertyInPath(collection.properties, key);\n                    const valueInPath = entry.values ? getValueInPath(entry.values, key) : undefined;\n                    const previousValueInPath = previousValues ? getValueInPath(previousValues, key) : undefined;\n\n                    const element = childProperty\n                        ? <PropertyPreview\n                            propertyKey={key}\n                            value={valueInPath as never}\n                            property={childProperty as Property}\n                            size={\"small\"}/>\n                        : <Typography variant={\"body2\"}>\n                            {typeof valueInPath === \"string\" ? valueInPath : JSON.stringify(valueInPath)}\n                        </Typography>;\n\n                    // The key column used to be `min-w-[200px] w-1/5` beside a\n                    // `w-4/5` value — 200px of label and 80% of the row, which\n                    // adds up to more than the row in anything narrower than a\n                    // full page. In the inspector that pushed every value off\n                    // the right edge and wrapped ids one character per line.\n                    // It stacks until the entry itself is wide enough.\n                    return (\n                        <div key={\"ref_prev_\" + key}\n                            className=\"flex flex-col @sm/histentry:flex-row @sm/histentry:items-baseline gap-x-4 gap-y-0.5 w-full my-1.5\">\n                            <Typography variant={\"caption\"}\n                                color={\"secondary\"}\n                                className=\"shrink-0 break-all @sm/histentry:w-40 @sm/histentry:text-right @sm/histentry:break-normal @sm/histentry:truncate\">\n                                {key}\n                            </Typography>\n                            <div className=\"min-w-0 flex-1 flex flex-col items-start gap-0.5\">\n                                {previousValueInPath !== undefined && !deepEqual(previousValueInPath, valueInPath) &&\n                                    <PreviousValueView previousValueInPath={previousValueInPath}\n                                        childProperty={childProperty as Property}\n                                        propertyKey={key}/>\n                                }\n                                {element}\n                            </div>\n                        </div>\n                    );\n                })}\n\n                {(!changedFields || changedFields.length === 0) && (\n                    <Typography variant={\"caption\"} color={\"secondary\"}>\n                        {entry.action === \"create\" ? \"Entity created\" :\n                            entry.action === \"delete\" ? \"Entity deleted\" : \"No field changes recorded\"}\n                    </Typography>\n                )}\n\n            </div>\n\n        </div>\n    </div>;\n}\n","\nimport type { EntityCustomViewParams } from \"@rebasepro/admin-types\";\nimport { useRef, useEffect } from \"react\";\nimport { cls, IconButton, Label, Tooltip, Typography } from \"@rebasepro/ui\";\nimport { ErrorBoundary, HistoryIcon } from \"@rebasepro/ui\";\nimport { EntityHistoryEntry } from \"./EntityHistoryEntry\";\nimport { useSnackbarController, useAuthController, useTranslation } from \"@rebasepro/app\";\nimport { ConfirmationDialog } from \"@rebasepro/app\";\nimport { useState } from \"react\";\nimport { useHistory } from \"../../hooks/useHistory\";\n\n/**\n * Entity history tab view. Shows a paginated list of entity revisions\n * fetched from the backend API. Supports infinite scroll and revert.\n */\nexport function EntityHistoryView<M extends Record<string, unknown>>({\n    entity,\n    collection,\n    formContext,\n    refreshToken\n}: EntityCustomViewParams<M> & {\n    /** Bumped once per save, so the list picks up the revision it just made. */\n    refreshToken?: number;\n}) {\n\n    const { t } = useTranslation();\n    const snackbarController = useSnackbarController();\n    const authController = useAuthController();\n    const dirty = formContext?.formex.dirty;\n\n    const slug = collection.slug;\n    const entityId = entity?.id;\n\n    const {\n        entries,\n        isLoading,\n        hasMore,\n        loadMore,\n        revert\n    } = useHistory({\n        slug,\n        entityId,\n        enabled: !!entityId,\n        pageSize: 10,\n        refreshToken\n    });\n\n    const [revertHistoryId, setRevertHistoryId] = useState<string | undefined>();\n    const [isReverting, setIsReverting] = useState(false);\n\n    const containerRef = useRef<HTMLDivElement>(null);\n    const loadMoreRef = useRef<HTMLDivElement>(null);\n\n    // Intersection observer for infinite scroll\n    useEffect(() => {\n        const currentContainer = containerRef.current;\n        const currentLoadMore = loadMoreRef.current;\n\n        if (!currentContainer || !currentLoadMore || !hasMore || isLoading) return;\n\n        const observer = new IntersectionObserver(\n            (observerEntries) => {\n                if (observerEntries[0].isIntersecting && hasMore && !isLoading) {\n                    loadMore();\n                }\n            },\n            {\n                root: currentContainer,\n                rootMargin: \"0px 0px 200px 0px\",\n                threshold: 0.01\n            }\n        );\n\n        observer.observe(currentLoadMore);\n\n        return () => observer.disconnect();\n    }, [hasMore, isLoading, entries.length, loadMore]);\n\n    if (!entity) {\n        return <div className=\"flex items-center justify-center h-full\">\n            <Label>{t(\"history_new_entity\") ?? \"History is only available for existing records\"}</Label>\n        </div>;\n    }\n\n    async function doRevert(historyId: string) {\n        setIsReverting(true);\n        try {\n            const revertedValues = await revert(historyId);\n            setRevertHistoryId(undefined);\n\n            // Reset the form with the reverted values so the UI updates\n            // immediately without requiring a page refresh.\n            if (formContext?.formex?.resetForm && revertedValues) {\n                formContext.formex.resetForm({\n                    values: revertedValues as M,\n                    submitCount: 0,\n                    touched: {}\n                });\n            }\n\n            snackbarController.open({\n                message: t(\"history_reverted\") ?? \"Reverted to selected version\",\n                type: \"info\"\n            });\n        } catch (error) {\n            console.error(\"Error reverting entity:\", error);\n            snackbarController.open({\n                message: t(\"history_revert_error\") ?? \"Error reverting entity\",\n                type: \"error\"\n            });\n        } finally {\n            setIsReverting(false);\n        }\n    }\n\n    const revertEntry = revertHistoryId\n        ? entries.find(e => e.id === revertHistoryId)\n        : undefined;\n\n    // `p-8` plus a `mt-24` heading were sized for a full-width tab that no\n    // longer exists. In the inspector panel that was 96px of nothing above the\n    // first revision, and 32px of gutter on each side of a 448px column.\n    return <div\n        ref={containerRef}\n        className={cls(\"relative flex-1 h-full overflow-auto w-full flex flex-col gap-4 p-4 sm:p-5\")}>\n        <div className=\"flex flex-col gap-2 max-w-6xl mx-auto w-full\">\n\n            {isLoading && entries.length === 0 && (\n                <div className=\"flex flex-col gap-4\">\n                    {[1, 2, 3].map(i => (\n                        <div key={i} className=\"flex flex-col gap-2 animate-pulse\">\n                            <div className=\"h-4 w-48 bg-surface-200 dark:bg-surface-700 rounded\"/>\n                            <div className=\"h-12 w-full bg-surface-100 dark:bg-surface-900 rounded-lg border border-surface-200 dark:border-surface-700\"/>\n                        </div>\n                    ))}\n                </div>\n            )}\n\n            {!isLoading && entries.length === 0 && <>\n                <Label>\n                    {t(\"history_empty\") ?? \"No history available\"}\n                </Label>\n                <Typography variant={\"caption\"}>\n                    {t(\"history_empty_description\") ?? \"When you save a record, a new version is created and stored in the history.\"}\n                </Typography>\n            </>}\n\n            {entries.map((entry) => (\n                <div key={entry.id} className=\"flex flex-col gap-2 w-full\">\n                    <EntityHistoryEntry\n                        entry={entry}\n                        collection={collection}\n                        size={\"medium\"}\n                        actions={\n                            <Tooltip title={t(\"history_revert\") ?? \"Revert to this version\"}\n                                className={\"m-2 grow-0 self-start\"}>\n                                <IconButton\n                                    onClick={() => {\n                                        if (dirty) {\n                                            snackbarController.open({\n                                                message: t(\"history_revert_dirty\") ?? \"Please save or discard your changes before reverting\",\n                                                type: \"warning\"\n                                            });\n                                        } else {\n                                            setRevertHistoryId(entry.id);\n                                        }\n                                    }}>\n                                    <HistoryIcon/>\n                                </IconButton>\n                            </Tooltip>\n                        }\n                    />\n                </div>\n            ))}\n\n            {/* Load more sentinel */}\n            {entries.length > 0 && (\n                <div ref={loadMoreRef} className=\"py-4 text-center\">\n                    {isLoading && <Label>{t(\"loading\")}</Label>}\n                    {!hasMore && entries.length > 10 && <Label>{t(\"history_no_more\") ?? \"No more history\"}</Label>}\n                </div>\n            )}\n        </div>\n\n        <ErrorBoundary>\n            <ConfirmationDialog\n                open={Boolean(revertHistoryId)}\n                onAccept={() => {\n                    if (revertHistoryId) doRevert(revertHistoryId);\n                }}\n                onCancel={() => setRevertHistoryId(undefined)}\n                title={<Typography variant={\"subtitle2\"}>{t(\"history_revert_title\") ?? \"Revert data to this version?\"}</Typography>}\n                body={revertEntry\n                    ? <div className=\"p-4\">\n                        <Typography variant={\"caption\"} color={\"secondary\"}>\n                            This will save the entity with the values from{\" \"}\n                            {new Date(revertEntry.updated_at).toLocaleString()}.\n                            A new history entry will be created for the revert.\n                        </Typography>\n                    </div>\n                    : null\n                }\n            />\n        </ErrorBoundary>\n    </div>;\n}\n"],"mappings":"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"}

package/dist/hooks/useEntityDisplay.d.ts

@@ -0,0 +1,102 @@
+import type { AdminCollection, EntityDisplayRole } from "@rebasepro/admin-types";
+import type { Entity, Property } from "@rebasepro/types";
+import { ENTITY_DISPLAY_ROLES } from "@rebasepro/admin-types";
+import { EntityDisplayCache } from "@rebasepro/app";
+/**
+ * What fills one display role for one record.
+ *
+ * `value` is `undefined` rather than a placeholder when nothing resolved,
+ * because the substitute differs by surface and each one knows its own better
+ * than this hook does: a page heading wants the singular collection name, a link
+ * wants the id, a draft wants "New customer". A single baked-in fallback is
+ * exactly what produced three different ones scattered across the consumers.
+ */
+export interface ResolvedDisplayValue<T = unknown> {
+    /** What goes in the slot. `undefined` when the record has nothing for it. */
+    value: T | undefined;
+    /**
+     * A resolver is in flight, and `value` currently holds the derived answer or
+     * nothing. Surfaces that can show a skeleton may; none has to.
+     */
+    loading: boolean;
+    /**
+     * Set only when the value came from a property of this collection. Carries
+     * what a rich renderer needs — a status shows as its enum's coloured chip,
+     * an image as a storage thumbnail — which a bare resolved string cannot
+     * describe.
+     */
+    source?: {
+        key: string;
+        property: Property | undefined;
+        value: unknown;
+    };
+}
+/**
+ * The store behind {@link useEntityDisplay}, for invalidating after a write.
+ *
+ * Built on first use rather than at module scope. Importing a module should not
+ * construct anything: it runs during SSR where there is nothing to cache, and it
+ * made this module unimportable from any test that stubs `@rebasepro/app` —
+ * which several do, and which is a legitimate thing for them to do.
+ */
+export declare function useEntityDisplayCache(): EntityDisplayCache;
+export interface UseEntityDisplayParams<M extends Record<string, unknown>> {
+    /**
+     * Optional because several callers look the collection up in the registry by
+     * path and may not find it — a relation into a collection the panel does not
+     * register. A hook that could not be called until that succeeded would have
+     * to sit below an early return, which is not where hooks go.
+     */
+    collection?: AdminCollection<M>;
+    /**
+     * The record. A resolver is handed the whole entity — its id and path are
+     * how it reaches anything the record does not carry — so a computed value is
+     * only available once there is an entity to compute it from.
+     */
+    entity?: Entity<M>;
+    /**
+     * Values to read a declared path from when they are newer than the entity:
+     * the live form values while editing. Falls back to `entity.values`.
+     */
+    values?: Record<string, unknown>;
+    /** Set false to skip resolver work entirely — a draft has nothing to show. */
+    enabled?: boolean;
+}
+/**
+ * What fills one display role of one record.
+ *
+ * This is the only implementation. Before it there were seven for the title
+ * alone — the identity bar, the detail header, inline previews, reference cards,
+ * list slots, relation chips and the headless view — each re-deriving it from
+ * `collection.properties` and disagreeing about the answer.
+ *
+ * Resolution order, per role:
+ *
+ * 1. `admin.display[role]` as a **resolver** — awaited, cached per record and
+ *    role, with the derived value showing meanwhile so nothing flickers empty.
+ * 2. `admin.display[role]` as a **property path** (or, for the title, the
+ *    deprecated `titleProperty`).
+ * 3. The **derived** answer: for the title, the best-ranked property carrying a
+ *    readable value; for the rest, today's per-role heuristics.
+ *
+ * A user-picker title resolves to the person behind the id, as it always did —
+ * that path is now here rather than in two of the seven.
+ */
+export declare function useEntityDisplay<T = unknown, M extends Record<string, unknown> = Record<string, unknown>>(role: EntityDisplayRole, { collection, entity, values: valuesProp, enabled }: UseEntityDisplayParams<M>): ResolvedDisplayValue<T>;
+/**
+ * Every display role of a record at once — what a list row, a card or a board
+ * card needs, in one call rather than six.
+ *
+ * The role list is iterated from {@link ENTITY_DISPLAY_ROLES} so the hook order
+ * is fixed and adding a role does not mean editing every caller.
+ */
+export declare function useEntityDisplayValues<M extends Record<string, unknown>>(params: UseEntityDisplayParams<M>): Record<EntityDisplayRole, ResolvedDisplayValue> & {
+    loading: boolean;
+};
+/**
+ * What the record is called — the one role asked for often enough on its own to
+ * deserve a name.
+ */
+export declare function useEntityTitle<M extends Record<string, unknown>>(params: UseEntityDisplayParams<M>): ResolvedDisplayValue<string>;
+/** Re-exported so a caller can iterate roles without reaching into types. */
+export { ENTITY_DISPLAY_ROLES };

package/dist/hooks/useEntityDisplayTitle.d.ts

@@ -1,18 +1,27 @@
 import type { AdminCollection } from "@rebasepro/admin-types";
-import type { EntityStatus } from "@rebasepro/types";
+import type { Entity, EntityStatus } from "@rebasepro/types";
 export interface UseEntityDisplayTitleParams<M extends Record<string, unknown>> {
     collection: AdminCollection<M>;
+    /** The record. Needed for a computed title; see {@link useEntityTitle}. */
+    entity?: Entity<M>;
+    /** Live form values, when they are ahead of the entity. */
     values?: Record<string, unknown>;
-    entityId?: string | number;
     status: EntityStatus;
 }
 /**
- * The human name for a record, for the identity bar and the breadcrumb.
+ * The heading for a record: the identity bar and the breadcrumb.
  *
- * The guard on `status` is the point. The title resolver walks candidate
- * properties and returns the first non-empty one, and on a brand new entity the
- * only populated values are the property defaults — so creating a blog post
- * opened a page headed **draft**, the default of its `status` enum. A record
- * that does not exist yet has no name; it has an intent.
+ * Everything about *what a record is called* lives in {@link useEntityTitle}.
+ * What is left here is the heading's own two rules, which are presentation, not
+ * identity:
+ *
+ * The guard on `status` is the first. The title resolver returns the first
+ * candidate carrying a value, and on a brand new entity the only values are the
+ * property defaults — so creating a blog post opened a page headed **draft**,
+ * the default of its `status` enum. A record that does not exist yet has no
+ * name; it has an intent.
+ *
+ * The fallback is the second. A page needs a heading even when the record has
+ * nothing readable in it, and the honest one is what kind of thing it is.
  */
-export declare function useEntityDisplayTitle<M extends Record<string, unknown>>({ collection, values, entityId, status }: UseEntityDisplayTitleParams<M>): string;
+export declare function useEntityDisplayTitle<M extends Record<string, unknown>>({ collection, entity, values, status }: UseEntityDisplayTitleParams<M>): string;

package/dist/{import-BvYl--U4.js → import-CYbvYa_x.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { $t as CollectionTableBinding, Ct as convertDataToEntity, Dt as useImportConfig, Et as getInferenceType, Ln as useCollectionRegistryController, Nt as PropertyConfigBadge, Ot as ImportSaveInProgress, St as DataNewPropertiesMapping, Zt as useSelectionController, fr as getPropertiesWithPropertiesOrder, k as getFieldConfig, kt as ImportFileUpload, pr as getPropertyInPath } from "./util-GiwPgxnL.js";
+import { $t as CollectionTableBinding, Ct as convertDataToEntity, Dt as useImportConfig, Et as getInferenceType, Ln as useCollectionRegistryController, Nt as PropertyConfigBadge, Ot as ImportSaveInProgress, St as DataNewPropertiesMapping, Zt as useSelectionController, gr as getPropertyInPath$1, hr as getPropertiesWithPropertiesOrder, kt as ImportFileUpload, w as getFieldConfig } from "./util-B8hurkxt.js";
 import React, { useCallback, useEffect } from "react";
 import { Button, Dialog, DialogActions, DialogContent, DialogTitle, IconButton, Select, SelectItem, Tooltip, Typography, UploadIcon, cls, defaultBorderMixin, iconSize } from "@rebasepro/ui";
 import { useAuthController, useCustomizationController, useSnackbarController } from "@rebasepro/app";
@@ -155,7 +155,7 @@ function ImportCollectionAction({ collection, path, onAnalyticsEvent }) {
 }
 var internalIDValue = "__internal_id__";
 function PropertyTreeSelect({ selectedPropertyKey, properties, onPropertySelected, onIdSelected, propertiesAndLevel, isIdColumn }) {
-	const selectedProperty = selectedPropertyKey ? getPropertyInPath(properties, selectedPropertyKey) : null;
+	const selectedProperty = selectedPropertyKey ? getPropertyInPath$1(properties, selectedPropertyKey) : null;
 	const renderValue = useCallback((selectedPropertyKey) => {
 		if (selectedPropertyKey === internalIDValue) return /* @__PURE__ */ jsx(Typography, {
 			variant: "body2",
@@ -325,4 +325,4 @@ var import_exports = /* @__PURE__ */ __exportAll({
 //#endregion
 export { PropertySelectEntry as i, ImportCollectionAction as n, ImportDataPreview as r, import_exports as t };
 
-//# sourceMappingURL=import-BvYl--U4.js.map
+//# sourceMappingURL=import-CYbvYa_x.js.map