@proveanything/smartlinks-utils-ui 0.9.1 → 0.9.3

package/dist/components/RecordsAdmin/index.js

@@ -1,3 +1,4 @@
+import { assertComponentStylesLoaded } from '../../chunk-OLYC54YT.js';
 import '../../chunk-5UQQYXCX.js';
 import { FacetRuleEditor } from '../../chunk-JMCV6FOW.js';
 import { useFacets } from '../../chunk-4LHF5JB7.js';
@@ -5,7 +6,7 @@ import { cn } from '../../chunk-L7FQ52F5.js';
 import { parsedRefToTarget, parsedRefToScope, matchRecords, scopesEqual, getRecordById, listRecords, upsertRecord, updateRecord, createRecord, removeRecord } from '../../chunk-KFKVGUUP.js';
 export { bulkDelete, bulkUpsert, createRecord, getRecordById, listRecords, matchRecords, parsedRefToScope, parsedRefToTarget, removeRecord, restoreRecord, scopesEqual, upsertRecord } from '../../chunk-KFKVGUUP.js';
 import { createContext, useState, useEffect, useCallback, useMemo, useRef, useContext, useSyncExternalStore, createElement, useId } from 'react';
-import { ChevronDown, Database, Lightbulb, SearchX, Inbox, LayoutGrid, Eye, MoreHorizontal, Download, Upload, Trash2, Copy, Pencil, Plus, CircleDashed, ArrowDownLeft, CheckCircle2, List, SlidersHorizontal, Globe, Tag, Boxes, Layers, Package, Rows3, ChevronRight, Eraser, ClipboardPaste, Box, X, Image, Table, ArrowLeft, ChevronLeft, AlertTriangle, Info, HelpCircle, Search, CornerDownLeft, Circle, AlertCircle, Undo2, Save, Loader2, XCircle, ArrowRight, BookOpen, Globe2, Target, Check, Settings2 } from 'lucide-react';
+import { ChevronDown, Database, Lightbulb, SearchX, Inbox, LayoutGrid, Eye, MoreHorizontal, Download, Upload, Trash2, Copy, Pencil, Plus, CircleDashed, ArrowDownLeft, CheckCircle2, List, SlidersHorizontal, Globe, Tag, Boxes, Layers, Package, Rows3, ChevronRight, Eraser, ClipboardPaste, Box, X, Search, Image, Table, ArrowLeft, ChevronLeft, AlertTriangle, Info, HelpCircle, CornerDownLeft, Circle, AlertCircle, Undo2, Save, Loader2, XCircle, ArrowRight, BookOpen, Globe2, Target, Check, Settings2 } from 'lucide-react';
 import { useQuery, useQueryClient, useInfiniteQuery } from '@tanstack/react-query';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { createPortal } from 'react-dom';
@@ -146,7 +147,11 @@ var DEFAULT_I18N = {
   subtitleConfigured: "Configured",
   subtitleInherited: "Inherited",
   rulesTabTooltip: "Use rules to scope records to a targeted audience or a subset of products.",
-  rulesEmptyBody: "Create a rule to target a subset of products or a specific audience \u2014 for example, \u201Conly premium tier customers in Germany\u201D."
+  rulesEmptyBody: "Create a rule to target a subset of products or a specific audience \u2014 for example, \u201Conly premium tier customers in Germany\u201D.",
+  hookBeforeSaveFailed: "Couldn't save: {message}",
+  hookAfterSaveFailed: "Saved, but a follow-up step failed: {message}",
+  hookBeforeDeleteFailed: "Couldn't delete: {message}",
+  hookAfterDeleteFailed: "Deleted, but a follow-up step failed: {message}"
 };
 
 // src/components/RecordsAdmin/types/presentation.ts
@@ -1819,7 +1824,8 @@ function useShellNavigation(args) {
     deepLinkState,
     onTelemetry,
     onBeforeDelete,
-    generateItemId
+    generateItemId,
+    hooks
   } = args;
   const buildItemUrlValue = useCallback((id) => {
     if (!baseScopeRef && id.startsWith("item:")) return id;
@@ -1904,6 +1910,34 @@ function useShellNavigation(args) {
       const ok = await onBeforeDelete(editingScope ?? parseRef(""));
       if (!ok) return;
     }
+    const row = collectionItems.items.find(
+      (it) => it.itemId === itemId || it.id === itemId
+    );
+    const hookCtxBase = {
+      collectionId: ctx.collectionId,
+      appId: ctx.appId,
+      recordType: ctx.recordType,
+      scope: editingScope?.kind ?? "collection",
+      targetRef: editingScope?.raw || void 0,
+      admin: true
+    };
+    const recordSummary = row ?? {
+      id: itemId,
+      ref: editingScope?.raw ?? "",
+      scope: editingScope ?? parseRef(""),
+      data: null,
+      status: "configured",
+      label: itemId
+    };
+    if (hooks?.beforeDelete) {
+      try {
+        const result = await hooks.beforeDelete({ ...hookCtxBase, record: recordSummary });
+        if (result === false) return;
+      } catch (err) {
+        console.warn("[RecordsAdmin] item beforeDelete hook cancelled delete", err);
+        return;
+      }
+    }
     try {
       const { removeRecord: removeRecord2 } = await import('../../records-AYYQSP7E.js');
       await removeRecord2(ctx, itemId);
@@ -1911,6 +1945,13 @@ function useShellNavigation(args) {
       if (selectedItemId === itemId) setSelectedItemId(null);
       if (selectedItemId === itemId) deepLinkState.emit({ recordId: null }, "record.close");
       collectionItems.refetch();
+      if (hooks?.afterDelete) {
+        try {
+          await hooks.afterDelete({ ...hookCtxBase, record: recordSummary });
+        } catch (err) {
+          console.warn("[RecordsAdmin] item afterDelete hook failed", err);
+        }
+      }
     } catch (err) {
       console.error("[RecordsAdminShell] item delete failed", err);
     }
@@ -1925,7 +1966,8 @@ function useShellNavigation(args) {
     collectionItems,
     deepLinkState,
     editingScope,
-    setSelectedItemId
+    setSelectedItemId,
+    hooks
   ]);
   const itemViewCtx = useMemo(() => ({
     onOpen: onItemOpen,
@@ -2072,13 +2114,24 @@ var useShellDeepLink = (args) => {
     setSelectedVariantId,
     selectedBatchId,
     setSelectedBatchId,
-    setFacetBrowseFilter
+    setFacetBrowseFilter,
+    isCollection,
+    setSelectedItemId,
+    collectionItems,
+    recordListItems,
+    recordListLoading,
+    skipNextItemResetRef
   } = args;
   const lastAppliedDLRef = useRef("");
   const [pendingDeepLinkRecordId, setPendingDeepLinkRecordId] = useState(null);
+  const warnedMissingRef = useRef(/* @__PURE__ */ new Set());
   useEffect(() => {
     if (!deepLinkState.enabled) return;
     if (selectedItemId) return;
+    console.debug("[RecordsAdminShell] rail-scope emit", {
+      scope: editingScope?.raw ?? null,
+      itemView
+    });
     deepLinkState.emit({ scope: editingScope?.raw ?? null, recordId: null }, "scope");
     lastAppliedDLRef.current = `${""}|${editingScope?.raw ?? ""}|${itemView}`;
   }, [deepLinkState.enabled, editingScope?.raw, selectedItemId, itemView]);
@@ -2118,6 +2171,53 @@ var useShellDeepLink = (args) => {
       });
     }
   }, [deepLinkState.enabled, deepLinkState.urlState]);
+  useEffect(() => {
+    const pending = pendingDeepLinkRecordId;
+    if (!pending) return;
+    if (isCollection) {
+      const hit2 = collectionItems.items.find((it) => it.id === pending || it.itemId === pending);
+      if (hit2) {
+        skipNextItemResetRef.current = true;
+        setSelectedItemId(pending);
+        setPendingDeepLinkRecordId(null);
+        return;
+      }
+      if (!collectionItems.isLoading) {
+        if (!warnedMissingRef.current.has(pending)) {
+          warnedMissingRef.current.add(pending);
+          console.warn("[RecordsAdminShell] deep-linked recordId not found in collection items \u2014 clearing pending selection", {
+            recordId: pending,
+            scope: editingScope?.raw ?? null
+          });
+        }
+        setPendingDeepLinkRecordId(null);
+      }
+      return;
+    }
+    const hit = recordListItems.find((it) => it.id === pending);
+    if (hit) {
+      if (selectedRecordId !== pending) setSelectedRecordId(pending);
+      setPendingDeepLinkRecordId(null);
+      return;
+    }
+    if (!recordListLoading) {
+      if (!warnedMissingRef.current.has(pending)) {
+        warnedMissingRef.current.add(pending);
+        console.warn("[RecordsAdminShell] deep-linked recordId not found in records list \u2014 clearing pending selection", {
+          recordId: pending,
+          scope: editingScope?.raw ?? null
+        });
+      }
+      setPendingDeepLinkRecordId(null);
+    }
+  }, [
+    pendingDeepLinkRecordId,
+    isCollection,
+    collectionItems.items,
+    collectionItems.isLoading,
+    recordListItems,
+    recordListLoading
+  ]);
   return { pendingDeepLinkRecordId, lastAppliedDLRef };
 };
 var isFacetRuleValid = (rule) => {
@@ -2231,6 +2331,25 @@ var createEditorStore = () => {
   const listeners = /* @__PURE__ */ new Set();
   let cachedList = [];
   let nextOrder = 0;
+  let hooksBundle = null;
+  let notifier = null;
+  const buildRecordSummary = (entry, value) => ({
+    id: entry.recordId ?? null,
+    ref: entry.spec.scope.raw,
+    scope: entry.spec.scope,
+    label: entry.label,
+    status: "configured",
+    data: value,
+    facetRule: entry.facetRule
+  });
+  const buildHookCtxBase = (entry) => ({
+    collectionId: entry.saveSpec.ctx.collectionId,
+    appId: entry.saveSpec.ctx.appId,
+    recordType: entry.saveSpec.ctx.recordType,
+    scope: entry.spec.scope.kind,
+    targetRef: entry.spec.scope.raw || void 0,
+    admin: true
+  });
   const recompute = () => {
     cachedList = Array.from(map.values()).sort((a, b) => a.order - b.order);
   };
@@ -2384,10 +2503,35 @@ var createEditorStore = () => {
       const entry = map.get(editorId);
       if (!entry) return;
       if (entry.status !== "dirty" && entry.status !== "error") return;
-      const persistedValue = entry.value;
+      let persistedValue = entry.value;
       const persistedFacetRule = entry.facetRule;
       const { ctx, anchors } = entry.saveSpec;
       const spec = entry.spec;
+      const isCreate = !(entry.recordId && entry.source === "self") || !!spec.createMode;
+      if (hooksBundle?.beforeSave) {
+        try {
+          const hookCtx = {
+            ...buildHookCtxBase(entry),
+            isCreate,
+            record: buildRecordSummary(entry, persistedValue),
+            before: !isCreate ? buildRecordSummary(entry, entry.baseline) : void 0
+          };
+          const result = await hooksBundle.beforeSave(hookCtx);
+          if (result === false) {
+            return;
+          }
+          if (result && typeof result === "object") {
+            persistedValue = persistedValue && typeof persistedValue === "object" ? { ...persistedValue, ...result } : result;
+          }
+        } catch (err) {
+          notifier?.({ kind: "hook-before-save", error: err, recordLabel: entry.label });
+          update(editorId, (e) => {
+            e.status = "error";
+            e.error = err;
+          });
+          return;
+        }
+      }
       update(editorId, (e) => {
         e.status = "saving";
         e.error = void 0;
@@ -2424,6 +2568,9 @@ var createEditorStore = () => {
           nextRecordId = upserted.record?.id ?? nextRecordId;
         }
         update(editorId, (e) => {
+          if (persistedValue !== entry.value) {
+            e.value = cloneDeep(persistedValue);
+          }
           e.baseline = cloneDeep(e.value);
           e.baselineFacetRule = e.facetRule;
           e.recordId = nextRecordId;
@@ -2431,6 +2578,21 @@ var createEditorStore = () => {
           e.status = "saved";
           e.error = void 0;
         });
+        if (hooksBundle?.afterSave) {
+          const refreshed = map.get(editorId);
+          const hookCtx = {
+            ...buildHookCtxBase(refreshed ?? entry),
+            isCreate,
+            record: buildRecordSummary(refreshed ?? entry, persistedValue),
+            before: !isCreate ? buildRecordSummary(entry, entry.baseline) : void 0
+          };
+          try {
+            await hooksBundle.afterSave(hookCtx);
+          } catch (err) {
+            notifier?.({ kind: "hook-after-save", error: err, recordLabel: entry.label });
+            console.warn("[RecordsAdmin] afterSave hook failed", err);
+          }
+        }
       } catch (err) {
         update(editorId, (e) => {
           e.status = "error";
@@ -2452,9 +2614,35 @@ var createEditorStore = () => {
       if (!entry) return;
       if (entry.source !== "self") return;
       if (!entry.recordId) return;
+      if (hooksBundle?.beforeDelete) {
+        try {
+          const hookCtx = {
+            ...buildHookCtxBase(entry),
+            record: buildRecordSummary(entry, entry.value)
+          };
+          const result = await hooksBundle.beforeDelete(hookCtx);
+          if (result === false) return;
+        } catch (err) {
+          notifier?.({ kind: "hook-before-delete", error: err, recordLabel: entry.label });
+          console.warn("[RecordsAdmin] beforeDelete hook cancelled delete", err);
+          return;
+        }
+      }
+      const deletedSnapshot = hooksBundle?.afterDelete ? {
+        ...buildHookCtxBase(entry),
+        record: buildRecordSummary(entry, entry.value)
+      } : null;
       await removeRecord(entry.saveSpec.ctx, entry.recordId);
       map.delete(editorId);
       emit();
+      if (hooksBundle?.afterDelete && deletedSnapshot) {
+        try {
+          await hooksBundle.afterDelete(deletedSnapshot);
+        } catch (err) {
+          notifier?.({ kind: "hook-after-delete", error: err, recordLabel: entry.label });
+          console.warn("[RecordsAdmin] afterDelete hook failed", err);
+        }
+      }
     },
     enforcePoolLimit(max, exceptEditorId) {
       const alive = Array.from(map.values());
@@ -2475,6 +2663,12 @@ var createEditorStore = () => {
       return () => {
         listeners.delete(listener);
       };
+    },
+    setHooks(hooks) {
+      hooksBundle = hooks ?? null;
+    },
+    setNotifier(notify2) {
+      notifier = notify2 ?? null;
     }
   };
 };
@@ -2496,10 +2690,14 @@ var EditorSessionProvider = ({
   ctx,
   children,
   maxOpenEditors = 8,
-  defaultValueFactory
+  defaultValueFactory,
+  hooks,
+  onHookNotice
 }) => {
   const storeRef = useRef(null);
   if (!storeRef.current) storeRef.current = createEditorStore();
+  storeRef.current.setHooks(hooks ?? null);
+  storeRef.current.setNotifier(onHookNotice ?? null);
   const currentRef = useRef(void 0);
   const listenersRef = useRef(/* @__PURE__ */ new Set());
   const subscribeCurrent = useCallback((cb) => {
@@ -3873,7 +4071,7 @@ var classify2 = (mode, kind) => {
   return SMART_PUSH.includes(kind) ? "push" : "replace";
 };
 function useDeepLinkState(options) {
-  const enabled = !!options?.enabled;
+  const enabled = options?.enabled !== false;
   const history = options?.history ?? "smart";
   const paramNames = useMemo(() => ({
     ...DEFAULT_DEEP_LINK_PARAM_NAMES,
@@ -3903,8 +4101,15 @@ function useDeepLinkState(options) {
     return adapter.subscribe(() => setUrlState(adapter.read()));
   }, [adapter]);
   const emit = useCallback((partial, kind) => {
-    if (!adapter) return;
+    if (!adapter) {
+      console.debug("[smartlinks-ui] deep-link emit skipped \u2014 no adapter (deepLink not enabled?)", {
+        partial,
+        kind
+      });
+      return;
+    }
     const mode = classify2(history, kind);
+    console.debug("[smartlinks-ui] deep-link emit", { partial, kind, mode });
     adapter.write(partial, mode);
     setUrlState((prev) => ({ ...prev, ...partial }));
   }, [adapter, history]);
@@ -4100,8 +4305,15 @@ function RecordEditor({
   const DeleteIcon = actionIcons?.delete;
   const showInherited = ctx.source === "inherited";
   const showEmpty = ctx.source === "empty";
+  const hasBreadcrumb = (() => {
+    const s = ctx.scope;
+    return Boolean(s?.facetId || s?.productId || s?.variantId || s?.batchId);
+  })();
+  const hasLeftContent = Boolean(headerLabel) || hasBreadcrumb;
+  const hasRightContent = showInherited || showEmpty || Boolean(headerMeta) || Boolean(bulkActions) || Boolean(targetingControl);
+  const showHeader = hasLeftContent || hasRightContent;
   return /* @__PURE__ */ jsxs("div", { className: "flex flex-col h-full", children: [
-    /* @__PURE__ */ jsxs(
+    showHeader && /* @__PURE__ */ jsxs(
       "header",
       {
         className: "sticky top-0 z-40 px-5 py-3 border-b flex items-start justify-between gap-3",
@@ -4955,14 +5167,16 @@ var PreviewScopePicker = ({
   onChange,
   showVariants,
   showBatches,
+  activeScope,
   i18n
 }) => {
   const productPinned = !!editingScope.productId;
+  const hideForTab = activeScope === "product" || activeScope === "variant" || activeScope === "batch";
   const products = useProductBrowse({
     SL,
     collectionId,
     pageSize: 100,
-    enabled: !productPinned
+    enabled: !productPinned && !hideForTab
   });
   const variants = useProductChildren({
     SL,
@@ -4976,11 +5190,8 @@ var PreviewScopePicker = ({
     productId: value.productId,
     kind: showBatches ? "batch" : null
   });
-  const isDefault = useMemo(
-    () => value.raw === editingScope.raw,
-    [value.raw, editingScope.raw]
-  );
   useEffect(() => {
+    if (hideForTab) return;
     if (productPinned) return;
     if (value.productId) return;
     const first = products.items[0];
@@ -4992,9 +5203,10 @@ var PreviewScopePicker = ({
       batchId: void 0,
       raw: `product:${first.id}`
     });
-  }, [productPinned, value.productId, products.items]);
-  const [productPickerOpen, setProductPickerOpen] = useState(false);
-  const showProductPicker = !productPinned && products.items.length > 1;
+  }, [hideForTab, productPinned, value.productId, products.items]);
+  const [lightboxOpen, setLightboxOpen] = useState(false);
+  if (hideForTab) return null;
+  const showProductPicker = !productPinned;
   const showVariantPicker = showVariants && !!value.productId && variants.items.length > 0;
   const showBatchPicker = showBatches && !!value.productId && batches.items.length > 0;
   if (!showProductPicker && !showVariantPicker && !showBatchPicker) {
@@ -5005,6 +5217,16 @@ var PreviewScopePicker = ({
     borderColor: "hsl(var(--ra-border))",
     color: "hsl(var(--ra-text))"
   };
+  const pickProduct = (productId) => {
+    onChange({
+      ...value,
+      productId,
+      variantId: void 0,
+      batchId: void 0,
+      raw: `product:${productId}`
+    });
+    setLightboxOpen(false);
+  };
   return /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 flex-wrap", children: [
     /* @__PURE__ */ jsxs(
       "span",
@@ -5017,56 +5239,27 @@ var PreviewScopePicker = ({
         ]
       }
     ),
-    !isDefault && /* @__PURE__ */ jsxs(
-      "button",
-      {
-        type: "button",
-        onClick: () => onChange(editingScope),
-        className: "text-[10px] px-2 py-1 rounded-md border hover:bg-[hsl(var(--ra-muted))]",
-        style: selectStyle,
-        children: [
-          "\u21BA ",
-          i18n?.previewAsDefault ?? "Same as edited"
-        ]
-      }
-    ),
-    showProductPicker && !productPickerOpen && currentProductName && /* @__PURE__ */ jsxs(
-      "button",
+    showProductPicker && /* @__PURE__ */ jsxs(
+      "span",
       {
-        type: "button",
-        onClick: () => setProductPickerOpen(true),
-        className: "text-[10px] px-2 py-1 rounded-md border hover:bg-[hsl(var(--ra-muted))] inline-flex items-center gap-1 max-w-[12rem] truncate",
-        style: selectStyle,
-        title: `Preview as ${currentProductName} \u2014 click to change`,
+        className: "inline-flex items-center gap-1.5 text-[11px] truncate max-w-[18rem]",
+        style: { color: "hsl(var(--ra-text))" },
         children: [
-          "as ",
-          /* @__PURE__ */ jsx("span", { className: "font-medium truncate", children: currentProductName }),
-          /* @__PURE__ */ jsx(ChevronDown, { className: "w-3 h-3 opacity-60" })
+          /* @__PURE__ */ jsx("span", { className: "font-medium truncate", title: currentProductName, children: currentProductName || "\u2014" }),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              onClick: () => setLightboxOpen(true),
+              className: "text-[10px] px-1.5 py-0.5 rounded-md border hover:bg-[hsl(var(--ra-muted))]",
+              style: selectStyle,
+              title: i18n?.change ?? "Change preview product",
+              children: i18n?.change ?? "Change"
+            }
+          )
         ]
       }
     ),
-    showProductPicker && productPickerOpen && /* @__PURE__ */ jsx(
-      "select",
-      {
-        className: SELECT_CLS,
-        style: selectStyle,
-        autoFocus: true,
-        onBlur: () => setProductPickerOpen(false),
-        value: value.productId ?? "",
-        onChange: (e) => {
-          const productId = e.target.value || void 0;
-          onChange({
-            ...value,
-            productId,
-            variantId: void 0,
-            batchId: void 0,
-            raw: productId ? `product:${productId}` : ""
-          });
-          setProductPickerOpen(false);
-        },
-        children: products.items.map((p) => /* @__PURE__ */ jsx("option", { value: p.id, children: p.name }, p.id))
-      }
-    ),
     showVariantPicker && /* @__PURE__ */ jsxs(
       "select",
       {
@@ -5107,9 +5300,161 @@ var PreviewScopePicker = ({
           batches.items.map((b) => /* @__PURE__ */ jsx("option", { value: b.id, children: b.name }, b.id))
         ]
       }
+    ),
+    lightboxOpen && /* @__PURE__ */ jsx(
+      ProductPickerLightbox,
+      {
+        SL,
+        collectionId,
+        currentProductId: value.productId,
+        onPick: pickProduct,
+        onClose: () => setLightboxOpen(false),
+        i18n
+      }
     )
   ] });
 };
+var ProductPickerLightbox = ({
+  SL,
+  collectionId,
+  currentProductId,
+  onPick,
+  onClose,
+  i18n
+}) => {
+  const [search, setSearch] = useState("");
+  const inputRef = useRef(null);
+  const browse = useProductBrowse({
+    SL,
+    collectionId,
+    search,
+    pageSize: 50,
+    enabled: true
+  });
+  useEffect(() => {
+    const prev = document.body.style.overflow;
+    document.body.style.overflow = "hidden";
+    const t = window.setTimeout(() => inputRef.current?.focus(), 0);
+    const onKey = (e) => {
+      if (e.key === "Escape") {
+        e.stopPropagation();
+        onClose();
+      }
+    };
+    window.addEventListener("keydown", onKey, true);
+    return () => {
+      window.clearTimeout(t);
+      window.removeEventListener("keydown", onKey, true);
+      document.body.style.overflow = prev;
+    };
+  }, [onClose]);
+  if (typeof document === "undefined") return null;
+  return createPortal(
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "ra-shell ra-confirm-root",
+        role: "presentation",
+        onMouseDown: (e) => e.stopPropagation(),
+        onClick: (e) => e.stopPropagation(),
+        onTouchStart: (e) => e.stopPropagation(),
+        children: [
+          /* @__PURE__ */ jsx("div", { className: "ra-confirm-backdrop", onClick: onClose }),
+          /* @__PURE__ */ jsxs(
+            "div",
+            {
+              role: "dialog",
+              "aria-modal": "true",
+              "aria-label": i18n?.searchProducts ?? "Search products",
+              className: "ra-confirm-card",
+              style: { width: "min(520px, 100%)", padding: "1rem" },
+              children: [
+                /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 mb-3", children: [
+                  /* @__PURE__ */ jsx(Search, { className: "w-4 h-4 opacity-60" }),
+                  /* @__PURE__ */ jsx(
+                    "input",
+                    {
+                      ref: inputRef,
+                      type: "text",
+                      value: search,
+                      onChange: (e) => setSearch(e.target.value),
+                      placeholder: i18n?.searchProducts ?? "Search products\u2026",
+                      className: "flex-1 text-sm px-2 py-1.5 rounded-md border bg-transparent focus:outline-none focus:ring-1",
+                      style: {
+                        borderColor: "hsl(var(--ra-border))",
+                        color: "hsl(var(--ra-text))"
+                      }
+                    }
+                  ),
+                  /* @__PURE__ */ jsx(
+                    "button",
+                    {
+                      type: "button",
+                      onClick: onClose,
+                      className: "p-1 rounded-md hover:bg-[hsl(var(--ra-muted))]",
+                      "aria-label": i18n?.close ?? "Close",
+                      style: { color: "hsl(var(--ra-muted-text))" },
+                      children: /* @__PURE__ */ jsx(X, { className: "w-4 h-4" })
+                    }
+                  )
+                ] }),
+                /* @__PURE__ */ jsxs(
+                  "div",
+                  {
+                    className: "overflow-y-auto rounded-md border",
+                    style: {
+                      maxHeight: "50vh",
+                      borderColor: "hsl(var(--ra-border))"
+                    },
+                    children: [
+                      browse.isLoading && browse.items.length === 0 ? /* @__PURE__ */ jsx("div", { className: "text-xs px-3 py-4 text-center", style: { color: "hsl(var(--ra-muted-text))" }, children: "Loading\u2026" }) : browse.items.length === 0 ? /* @__PURE__ */ jsx("div", { className: "text-xs px-3 py-4 text-center", style: { color: "hsl(var(--ra-muted-text))" }, children: "No products match." }) : /* @__PURE__ */ jsx("ul", { className: "divide-y", style: { borderColor: "hsl(var(--ra-border))" }, children: browse.items.map((p) => {
+                        const active = p.id === currentProductId;
+                        return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
+                          "button",
+                          {
+                            type: "button",
+                            onClick: () => onPick(p.id),
+                            className: "w-full text-left px-3 py-2 text-sm hover:bg-[hsl(var(--ra-muted))] flex items-center justify-between gap-3",
+                            style: {
+                              color: "hsl(var(--ra-text))",
+                              background: active ? "hsl(var(--ra-muted))" : "transparent"
+                            },
+                            children: [
+                              /* @__PURE__ */ jsxs("span", { className: "flex flex-col min-w-0", children: [
+                                /* @__PURE__ */ jsx("span", { className: "truncate font-medium", children: p.name }),
+                                p.sku ? /* @__PURE__ */ jsx("span", { className: "truncate text-[11px]", style: { color: "hsl(var(--ra-muted-text))" }, children: p.sku }) : null
+                              ] }),
+                              active ? /* @__PURE__ */ jsx("span", { className: "text-[10px] uppercase tracking-wide", style: { color: "hsl(var(--ra-muted-text))" }, children: "current" }) : null
+                            ]
+                          }
+                        ) }, p.id);
+                      }) }),
+                      browse.hasNextPage && /* @__PURE__ */ jsx("div", { className: "px-3 py-2 border-t", style: { borderColor: "hsl(var(--ra-border))" }, children: /* @__PURE__ */ jsx(
+                        "button",
+                        {
+                          type: "button",
+                          onClick: () => browse.fetchNextPage(),
+                          disabled: browse.isFetchingNextPage,
+                          className: "text-xs w-full py-1 rounded-md border hover:bg-[hsl(var(--ra-muted))]",
+                          style: {
+                            borderColor: "hsl(var(--ra-border))",
+                            color: "hsl(var(--ra-text))"
+                          },
+                          children: browse.isFetchingNextPage ? "Loading\u2026" : "Load more"
+                        }
+                      ) })
+                    ]
+                  }
+                )
+              ]
+            }
+          )
+        ]
+      }
+    ),
+    document.body
+  );
+};
 var ICONS2 = {
   table: Table,
   cards: LayoutGrid,
@@ -5309,6 +5654,7 @@ function ItemListView({
   error,
   ctx,
   itemNoun,
+  ruleSummary,
   view,
   views,
   onViewChange,
@@ -5406,6 +5752,27 @@ function ItemListView({
   }
   return /* @__PURE__ */ jsxs("div", { className: "ra-item-list", children: [
     toolbar,
+    ruleSummary ? /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "ra-item-rule-summary",
+        style: {
+          padding: "6px 12px",
+          fontSize: "11px",
+          color: "hsl(var(--ra-muted-text))",
+          borderBottom: "1px solid hsl(var(--ra-border))",
+          background: "hsl(var(--ra-muted) / 0.4)",
+          display: "flex",
+          alignItems: "center",
+          gap: "6px"
+        },
+        children: [
+          /* @__PURE__ */ jsx("span", { style: { fontWeight: 500, color: "hsl(var(--ra-text))" }, children: "Rule" }),
+          /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\xB7" }),
+          /* @__PURE__ */ jsx("span", { children: ruleSummary })
+        ]
+      }
+    ) : null,
     /* @__PURE__ */ jsx("div", { className: "ra-item-list-body", children: body })
   ] });
 }
@@ -6730,6 +7097,19 @@ function RecordsAdminShell(props) {
     {
       ctx,
       defaultValueFactory: props.defaultData,
+      hooks: props.hooks,
+      onHookNotice: (notice) => {
+        console.warn(`[RecordsAdmin] ${notice.kind} hook failed`, notice.error);
+        try {
+          props.onTelemetry?.({
+            type: "record.hook.error",
+            recordType: props.recordType,
+            kind: notice.kind,
+            message: notice.error instanceof Error ? notice.error.message : String(notice.error)
+          });
+        } catch {
+        }
+      },
       children: /* @__PURE__ */ jsx(RecordsAdminShellInner, { ...props })
     }
   );
@@ -6829,6 +7209,18 @@ function RecordsAdminShellInner(props) {
   const i18n = { ...DEFAULT_I18N, ...i18nOverride ?? {} };
   const icons = useMemo(() => mergeIcons(iconsOverride), [iconsOverride]);
   const deepLinkState = useDeepLinkState(deepLink);
+  const deepLinkLoggedRef = useRef(false);
+  if (!deepLinkLoggedRef.current) {
+    deepLinkLoggedRef.current = true;
+    console.debug("[RecordsAdminShell] deep-link config", {
+      enabled: deepLinkState.enabled,
+      hostPassedOption: !!deepLink,
+      // Resolved adapter mode: 'host' = host-supplied, 'default' = built-in
+      // (window.location standalone, postMessage inside the SmartLinks iframe).
+      adapterMode: deepLink?.adapter ? "host" : "default",
+      paramNames: deepLinkState.paramNames
+    });
+  }
   const multiOpenWarnedRef = useRef(false);
   if (editorTabs === "multi" && !multiOpenWarnedRef.current) {
     multiOpenWarnedRef.current = true;
@@ -7059,7 +7451,18 @@ function RecordsAdminShellInner(props) {
     setSelectedVariantId,
     selectedBatchId,
     setSelectedBatchId,
-    setFacetBrowseFilter
+    setFacetBrowseFilter,
+    // Pending-recordId resolution — without these the URL's `recordId` is
+    // parsed but never opens the editor on refresh / share-link load.
+    isCollection,
+    setSelectedItemId,
+    collectionItems: {
+      items: collectionItems.items,
+      isLoading: collectionItems.isLoading
+    },
+    recordListItems: recordList.items,
+    recordListLoading: recordList.isLoading,
+    skipNextItemResetRef
   });
   const supportedForResolution = useMemo(() => requestedScopes, [requestedScopes]);
   const resolved = useResolvedRecord({
@@ -7290,7 +7693,8 @@ function RecordsAdminShellInner(props) {
     deepLinkState,
     onTelemetry,
     onBeforeDelete,
-    generateItemId
+    generateItemId,
+    hooks: props.hooks
   });
   const renderEditorWithPreview = () => {
     if (!editingTargetScope) return null;
@@ -7305,6 +7709,7 @@ function RecordsAdminShellInner(props) {
         onChange: setPreviewScope,
         showVariants: drillVariantsAllowed,
         showBatches: drillBatchesAllowed,
+        activeScope,
         i18n: { previewAs: i18n.previewAs, previewAsDefault: i18n.previewAsDefault }
       }
     ) : null;
@@ -7497,12 +7902,13 @@ function RecordsAdminShellInner(props) {
     if (groupBy) return groupBy;
     if (isAllTab) return void 0;
     if (!isRuleTab) return void 0;
+    if (isCollection) return void 0;
     return (record) => {
       const hash = ruleHash(record.facetRule);
       if (!hash) return null;
       return { key: `rule:${hash}`, label: summariseRule(record.facetRule) };
     };
-  }, [groupBy, isRuleTab, isAllTab]);
+  }, [groupBy, isRuleTab, isAllTab, isCollection]);
   const [bulkRuleEditTarget, setBulkRuleEditTarget] = useState(null);
   const ruleCatalogue = useMemo(() => {
     const buckets = /* @__PURE__ */ new Map();
@@ -7601,6 +8007,32 @@ function RecordsAdminShellInner(props) {
     () => isRuleTab ? applyRuleFilters(recordList.items, ruleFilters) : recordList.items,
     [isRuleTab, recordList.items, ruleFilters]
   );
+  const collectionRuleRailItems = useMemo(() => {
+    if (!isRuleTab || !isCollection) return filteredRuleItems;
+    const buckets = /* @__PURE__ */ new Map();
+    for (const item of filteredRuleItems) {
+      const hash = ruleHash(item.facetRule);
+      if (!hash) continue;
+      const existing = buckets.get(hash);
+      if (existing) {
+        existing.count += 1;
+      } else {
+        buckets.set(hash, { rep: item, count: 1 });
+      }
+    }
+    return Array.from(buckets.values()).map(({ rep, count }) => ({
+      ...rep,
+      label: summariseRule(rep.facetRule),
+      subtitle: `${count} ${itemNoun}${count === 1 ? "" : "s"}`
+    }));
+  }, [isRuleTab, isCollection, filteredRuleItems, itemNoun]);
+  const activeRuleSummary = useMemo(() => {
+    if (!isRuleTab || !isCollection) return null;
+    if (!selectedRecordId || isDraftId3(selectedRecordId)) return null;
+    const hit = recordList.items.find((it) => it.id === selectedRecordId);
+    if (!hit?.facetRule) return null;
+    return summariseRule(hit.facetRule);
+  }, [isRuleTab, isCollection, selectedRecordId, recordList.items]);
   const applyFacetBrowseFilter = useCallback(
     (items2) => {
       if (!facetBrowseFilter) return items2;
@@ -7648,7 +8080,9 @@ function RecordsAdminShellInner(props) {
     }),
     [i18n.itemsAllLabel, collectionItems.items.length, itemNoun]
   );
-  const leftItems = isProductTab ? productListItems : isRuleTab ? applyFacetBrowseFilter(filteredRuleItems) : (isGlobalTab || isAllTab) && isCollection ? [collectionGlobalAllRow] : isRecordsTab ? applyFacetBrowseFilter(recordList.items) : [];
+  const leftItems = isProductTab ? productListItems : isRuleTab ? applyFacetBrowseFilter(
+    isCollection ? collectionRuleRailItems : filteredRuleItems
+  ) : (isGlobalTab || isAllTab) && isCollection ? [collectionGlobalAllRow] : isRecordsTab ? applyFacetBrowseFilter(recordList.items) : [];
   const leftLoading = isProductTab ? !productPinned && productBrowse.isLoading : isRecordsTab ? recordList.isLoading || probe.isLoading : false;
   const leftError = isProductTab ? productBrowse.error : isRecordsTab ? recordList.error : null;
   const leftSelectedId = isProductTab ? void 0 : selectedRecordId && selectedRecordId !== DRAFT_ID3 ? selectedRecordId : void 0;
@@ -8089,6 +8523,7 @@ function RecordsAdminShellInner(props) {
                     renderItemEmpty,
                     itemColumns,
                     cardSize: itemCardSize,
+                    ruleSummary: activeRuleSummary,
                     i18n
                   }
                 ),
@@ -9008,6 +9443,9 @@ function useMergedRecord(args) {
   };
 }
 
+// src/components/RecordsAdmin/index.ts
+assertComponentStylesLoaded("records-admin");
+
 export { ALL_ITEM_VIEWS, ALL_PRESENTATIONS, BatchList, BulkActionsMenu, DEFAULT_DEEP_LINK_PARAM_NAMES, DEFAULT_I18N, DEFAULT_ICONS, DefaultItemCards, DefaultItemTable, DefaultRecordCard, DefaultRecordRow, DeleteButton, DirtyDraftProvider, DrawerPreview, EditorItemNav, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, ItemListView, ItemViewSwitcher, LoadingState, PresentationSwitcher, PreviewScopePicker, PreviewToggleButton, ProductDrillDown, ProductList, RecordBrowser, RecordEditor, RecordList, RecordsAdminShell, ResolvedPreview, ScopeBreadcrumb, ScopeTabs, SiblingRail, SidePreview, StatusDot, StatusFilterPills, StatusIcon, TabbedPreview, UtilityRow, VariantList, buildDraftKey, buildRef, checkPasteCompatibility, cloneValue, createDefaultDeepLinkAdapter, createPostMessageDeepLinkAdapter, downloadBlob, exportCsv, importCsv, isInSmartLinksIframe, mergeIcons, normaliseRule, parseRef, pickHeaderIcon, resolutionChain, resolveRecord, ruleHash, rulesEqual, scopeCountsQueryKey, statusToneLabel, summariseRule, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyDraft, useDirtyDraftActions, useDirtyDraftStore, useDirtyDrafts, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeCounts, useScopeProbe, useUnsavedGuard };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map