@proveanything/smartlinks-utils-ui 0.7.4 → 0.7.5

package/dist/components/RecordsAdmin/index.d.ts

@@ -727,6 +727,14 @@ interface RecordsAdminShellProps<TData = unknown> {
     csvSchema?: CsvSchema<TData>;
     classify?: (record: RecordSummary<TData>) => RecordStatus;
     defaultData?: () => TData;
+    /**
+     * Optional derivation for the label that represents an in-flight draft
+     * in the unsaved-changes tray. Receives the editor's current value and
+     * its scope; return a short, human-readable title (or `undefined` to
+     * defer to the built-in heuristic). Useful when your record shape nests
+     * the title under a custom key the heuristic doesn't know about.
+     */
+    deriveDraftLabel?: (value: TData, scope: ParsedRef) => string | undefined;
     /**
      * Which layouts the rail offers. Default `['list']`. When more than one is
      * supplied, a switcher appears above the list and the choice persists
@@ -1566,6 +1574,15 @@ interface UseRecordEditorArgs<T> {
      * back a concrete `recordId`.
      */
     createMode?: boolean;
+    /**
+     * Optional host-supplied derivation for the label this editor registers
+     * with the unsaved-changes tray. Receives the in-flight value and the
+     * scope; should return a short, human-readable title. When omitted (or
+     * when it returns `undefined`), the hook falls back to a built-in heuristic
+     * that scans common title-shaped fields (`title`, `display.title`,
+     * `name`, `label`, `heading`, `question`, `slug`).
+     */
+    deriveDraftLabel?: (value: T, scope: ParsedRef) => string | undefined;
 }
 declare function useRecordEditor<T>(args: UseRecordEditorArgs<T>): EditorContext<T>;
 

package/dist/components/RecordsAdmin/index.js

@@ -692,7 +692,8 @@ function useRecordEditor(args) {
     onSaveError,
     reseed = "always",
     initialFacetRule = null,
-    createMode = false
+    createMode = false,
+    deriveDraftLabel
   } = args;
   const queryClient = useQueryClient();
   const draftStore = useDirtyDraftStore();
@@ -857,11 +858,29 @@ function useRecordEditor(args) {
     const anchors = parsedRefToScope(scope);
     const saveKind = resolved.recordId && resolved.source === "self" ? "update" : createMode ? "create" : "upsert";
     const deriveLabel = () => {
+      if (deriveDraftLabel) {
+        try {
+          const custom = deriveDraftLabel(value, scope);
+          if (typeof custom === "string" && custom.trim()) return custom.trim();
+        } catch {
+        }
+      }
+      const KEYS = ["title", "name", "label", "heading", "question", "slug"];
+      const pickString = (obj) => {
+        if (!obj || typeof obj !== "object") return void 0;
+        for (const key of KEYS) {
+          const raw = obj[key];
+          if (typeof raw === "string" && raw.trim()) return raw.trim();
+        }
+        return void 0;
+      };
       const v = value;
+      const top = pickString(v);
+      if (top) return top;
       if (v && typeof v === "object") {
-        for (const key of ["title", "name", "label", "heading", "question"]) {
-          const raw = v[key];
-          if (typeof raw === "string" && raw.trim()) return raw.trim();
+        for (const wrapper of ["display", "content", "meta", "data"]) {
+          const nested = pickString(v[wrapper]);
+          if (nested) return nested;
         }
       }
       if (scope.raw?.startsWith("item:")) return "Untitled item";
@@ -4668,6 +4687,11 @@ styleInject(".ra-shell {\n  color: hsl(var(--ra-text));\n  background: hsl(var(-
 var TOP_LEVEL_SCOPES = ["collection", "rule", "product"];
 var WARNED_FACET_DEPRECATED = false;
 var DRAFT_ID = "__draft__";
+var isDraftId = (id) => !!id && (id === DRAFT_ID || id.startsWith("draft:"));
+var mintDraftItemId = () => {
+  const rand = typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  return `draft:${rand}`;
+};
 var productItemToSummary = (p) => {
   const ref = buildRef({ productId: p.id });
   return {
@@ -4749,7 +4773,8 @@ function RecordsAdminShellInner(props) {
     renderItemEmpty,
     collectionRailMode = "siblings",
     // Deep linking
-    deepLink
+    deepLink,
+    deriveDraftLabel
   } = props;
   const i18n = { ...DEFAULT_I18N, ...i18nOverride ?? {} };
   const icons = useMemo(() => mergeIcons(iconsOverride), [iconsOverride]);
@@ -5060,7 +5085,7 @@ function RecordsAdminShellInner(props) {
     // fall back to anchor-based `match()` at the collection root and the
     // editor would mount against `null` data — surfacing as the host's
     // "Select a {noun} from the list to edit" placeholder.
-    recordId: isCollection && selectedItemId && selectedItemId !== DRAFT_ID ? selectedItemId : selectedRecordId && selectedRecordId !== DRAFT_ID ? selectedRecordId : void 0,
+    recordId: isCollection && selectedItemId && !isDraftId(selectedItemId) ? selectedItemId : selectedRecordId && !isDraftId(selectedRecordId) ? selectedRecordId : void 0,
     supportedScopes: supportedForResolution,
     enabled: !!editingTargetScope
   });
@@ -5115,7 +5140,8 @@ function RecordsAdminShellInner(props) {
         setSelectedBatchId(void 0);
       }
       refetchAll();
-    }
+    },
+    deriveDraftLabel
   });
   useUnsavedGuard({
     isDirty: editorCtx.isDirty,
@@ -5386,7 +5412,7 @@ function RecordsAdminShellInner(props) {
   const onItemCreate = useCallback(() => {
     if (!isCollection) return;
     void runWithGuard(() => {
-      const id = generateItemId ? generateItemId() : DRAFT_ID;
+      const id = generateItemId ? generateItemId() : mintDraftItemId();
       setSelectedItemId(id);
       onTelemetry?.({ type: "item.create", recordType, scopeRef: baseScopeRef });
       deepLinkState.emit({ recordId: null, scope: baseScopeRef || null }, "record.open");
@@ -5394,7 +5420,7 @@ function RecordsAdminShellInner(props) {
   }, [isCollection, runWithGuard, generateItemId, onTelemetry, recordType, baseScopeRef, deepLinkState, buildItemUrlValue]);
   const onItemDelete = useCallback(async (itemId) => {
     if (!isCollection) return;
-    if (itemId === DRAFT_ID) return;
+    if (isDraftId(itemId)) return;
     if (onBeforeDelete) {
       const ok = await onBeforeDelete(editingScope ?? parseRef(""));
       if (!ok) return;
@@ -5475,7 +5501,7 @@ function RecordsAdminShellInner(props) {
         i18n: { previewAs: i18n.previewAs, previewAsDefault: i18n.previewAsDefault }
       }
     ) : null;
-    const itemNav = isCollection && selectedItemId && itemPosition ? /* @__PURE__ */ jsx(
+    const itemNav = isCollection && selectedItemId && itemPosition && ruleWizardStep === null ? /* @__PURE__ */ jsx(
       EditorItemNav,
       {
         label: editorHeaderLabel,
@@ -5649,7 +5675,7 @@ function RecordsAdminShellInner(props) {
   }, []);
   const onRuleWizardCreateItem = useCallback(() => {
     if (!isCollection) return;
-    const id = generateItemId ? generateItemId() : DRAFT_ID;
+    const id = generateItemId ? generateItemId() : mintDraftItemId();
     setSelectedItemId(id);
   }, [isCollection, generateItemId]);
   const hasGlobalRecord = useMemo(
@@ -5899,7 +5925,7 @@ function RecordsAdminShellInner(props) {
             className: "flex-1 grid border-t overflow-hidden",
             style: { gridTemplateColumns: "minmax(260px, 320px) 1fr", borderColor: "hsl(var(--ra-border))", marginTop: "0.75rem" },
             children: [
-              /* @__PURE__ */ jsx("aside", { className: "border-r overflow-hidden flex flex-col", style: { borderColor: "hsl(var(--ra-border))", background: "hsl(var(--ra-surface))" }, children: isCollection && selectedItemId && collectionRailMode === "siblings" ? /* @__PURE__ */ jsx(
+              /* @__PURE__ */ jsx("aside", { className: "border-r overflow-hidden flex flex-col", style: { borderColor: "hsl(var(--ra-border))", background: "hsl(var(--ra-surface))" }, children: isCollection && selectedItemId && collectionRailMode === "siblings" && ruleWizardStep === null ? /* @__PURE__ */ jsx(
                 SiblingRail,
                 {
                   items: collectionItems.items,