@proveanything/smartlinks-utils-ui 0.12.23 → 0.12.25

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

@@ -944,6 +944,22 @@ interface RecordsAdminShellProps<TData = unknown> {
     label: string;
     scopes: ScopeKind[];
     defaultScope?: ScopeKind;
+    /**
+     * Hard ceiling on inheritance-chain drill-down depth, regardless of what
+     * the collection has enabled.
+     *
+     * - `'product'` — never expose variant or batch tabs even if the collection
+     *   has those rungs turned on. Use when an app deliberately wants its
+     *   records to stay product-level (e.g. editorial content that must be
+     *   consistent across all variants).
+     * - `'variant'` — allow variant drill-down but hide batches.
+     * - `'batch'` (default) — allow the full chain when the collection supports it.
+     *
+     * Note: this is intentionally framed as a depth ceiling rather than a
+     * per-dimension list, so future sub-product dimensions are covered
+     * automatically. The `scopes` prop continues to define top-level tabs only.
+     */
+    maxDrillDepth?: 'product' | 'variant' | 'batch';
     /**
      * Context from the host URL (productId/variantId/batchId).
      * When provided, the browser is constrained to that subtree:
@@ -1827,6 +1843,10 @@ interface Props$a {
     batches: ProductChildItem[];
     variantsLoading: boolean;
     batchesLoading: boolean;
+    /** Variant ids that already have a record at this product. */
+    variantsWithRecord?: Set<string>;
+    /** Batch ids that already have a record at this product. */
+    batchesWithRecord?: Set<string>;
     /** Editor body rendered to the right of the picker. */
     children: ReactNode;
     /**
@@ -1838,7 +1858,7 @@ interface Props$a {
      */
     hideSingleTab?: boolean;
 }
-declare const ProductDrillDown: ({ productLabel, showVariants, showBatches, active, onChange, selectedChildId, onSelectChild, variants, batches, variantsLoading, batchesLoading, children, hideSingleTab, }: Props$a) => react_jsx_runtime.JSX.Element;
+declare const ProductDrillDown: ({ productLabel, showVariants, showBatches, active, onChange, selectedChildId, onSelectChild, variants, batches, variantsLoading, batchesLoading, variantsWithRecord, batchesWithRecord, children, hideSingleTab, }: Props$a) => react_jsx_runtime.JSX.Element;
 
 type PreviewMode = 'inline' | 'side' | 'tab' | 'drawer';
 interface CommonProps {

package/dist/components/RecordsAdmin/index.js

@@ -687,6 +687,60 @@ var useScopeProbe = ({ SL, collectionId, admin = true, enabled = true }) => {
     error: query.error ?? null
   };
 };
+var QK = ["records-admin", "product-sub-records"];
+var useProductSubRecords = (args) => {
+  const { SL, collectionId, appId, recordType, productId, enabled = true } = args;
+  const queryClient = useQueryClient();
+  const queryKey = useMemo(
+    () => [...QK, collectionId, appId, recordType ?? null, productId ?? null],
+    [collectionId, appId, recordType, productId]
+  );
+  const query = useQuery({
+    queryKey,
+    enabled: enabled && !!collectionId && !!appId && !!productId,
+    staleTime: 15e3,
+    queryFn: async () => {
+      if (!productId) return { variantIds: [], batchIds: [] };
+      const variantIds = /* @__PURE__ */ new Set();
+      const batchIds = /* @__PURE__ */ new Set();
+      let offset = 0;
+      const limit = 200;
+      for (let i = 0; i < 20; i++) {
+        const res = await SL.app.records.list(
+          collectionId,
+          appId,
+          {
+            ...recordType ? { recordType } : {},
+            limit,
+            offset
+          },
+          true
+        ).catch(() => null);
+        const data = res?.data ?? [];
+        for (const rec of data) {
+          const pId = rec.productId;
+          if (pId !== productId) continue;
+          const vId = rec.variantId;
+          const bId = rec.batchId;
+          if (vId) variantIds.add(vId);
+          if (bId) batchIds.add(bId);
+        }
+        if (!res?.pagination?.hasMore || data.length === 0) break;
+        offset += data.length;
+      }
+      return { variantIds: [...variantIds], batchIds: [...batchIds] };
+    }
+  });
+  const refetch = () => queryClient.invalidateQueries({
+    queryKey: [...QK, collectionId, appId, recordType ?? null, productId ?? null]
+  });
+  return {
+    variantIds: new Set(query.data?.variantIds ?? []),
+    batchIds: new Set(query.data?.batchIds ?? []),
+    isLoading: query.isLoading,
+    refetch
+  };
+};
 var QK_BASE = ["records-admin", "scope-counts"];
 var classify = (rec) => {
   const hasRule = !!rec.facetRule;
@@ -1048,7 +1102,7 @@ var useRecordList = (args) => {
   };
 };
 var LOG = "[RecordsAdmin/useFacetBrowse]";
-var QK = ["records-admin", "facet-browse"];
+var QK2 = ["records-admin", "facet-browse"];
 var toScaffoldSummary = (facet, value) => {
   const facetKey = facet.key ?? "";
   const valueKey = value.key ?? "";
@@ -1077,7 +1131,7 @@ var useFacetBrowse = ({
   const hasAnyList = hasAdminList || hasPublicList;
   const queryEnabled = enabled && !!collectionId && hasAnyList;
   const query = useQuery({
-    queryKey: [...QK, collectionId],
+    queryKey: [...QK2, collectionId],
     enabled: queryEnabled,
     staleTime: 3e4,
     queryFn: async () => {
@@ -1151,7 +1205,7 @@ var useFacetBrowse = ({
     empty: mergedItems.filter((item) => item.status === "empty").length
   }), [mergedItems]);
   const refetch = () => {
-    queryClient.invalidateQueries({ queryKey: [...QK, collectionId] });
+    queryClient.invalidateQueries({ queryKey: [...QK2, collectionId] });
   };
   return {
     items: filteredItems,
@@ -1168,7 +1222,7 @@ var useFacetBrowse = ({
     vocabulary: query.data ?? []
   };
 };
-var QK2 = ["records-admin", "product-browse"];
+var QK3 = ["records-admin", "product-browse"];
 var toBrowseItem = (p) => ({
   id: p.id ?? p.productId ?? "",
   name: p.name ?? p.id ?? "Untitled",
@@ -1179,7 +1233,7 @@ var useProductBrowse = (args) => {
   const { SL, collectionId, search = "", pageSize = 50, enabled = true, admin = true } = args;
   const queryClient = useQueryClient();
   const queryKey = useMemo(
-    () => [...QK2, collectionId, search.trim(), pageSize, admin],
+    () => [...QK3, collectionId, search.trim(), pageSize, admin],
     [collectionId, search, pageSize, admin]
   );
   const query = useInfiniteQuery({
@@ -1230,7 +1284,7 @@ var useProductBrowse = (args) => {
     () => query.data?.pages.flatMap((p) => p.items) ?? [],
     [query.data]
   );
-  const refetch = () => queryClient.invalidateQueries({ queryKey: [...QK2, collectionId] });
+  const refetch = () => queryClient.invalidateQueries({ queryKey: [...QK3, collectionId] });
   return {
     items,
     total: query.data?.pages[query.data.pages.length - 1]?.total,
@@ -1242,7 +1296,7 @@ var useProductBrowse = (args) => {
     refetch
   };
 };
-var QK3 = ["records-admin", "product-children"];
+var QK4 = ["records-admin", "product-children"];
 var variantToItem = (v) => ({
   id: v.id ?? v.variantId ?? "",
   name: v.name ?? v.label ?? v.id ?? "Untitled variant",
@@ -1257,7 +1311,7 @@ var useProductChildren = (args) => {
   const { SL, collectionId, productId, kind, enabled = true } = args;
   const queryClient = useQueryClient();
   const queryKey = useMemo(
-    () => [...QK3, collectionId, productId ?? null, kind],
+    () => [...QK4, collectionId, productId ?? null, kind],
     [collectionId, productId, kind]
   );
   const query = useQuery({
@@ -1275,7 +1329,7 @@ var useProductChildren = (args) => {
     }
   });
   const refetch = () => queryClient.invalidateQueries({
-    queryKey: [...QK3, collectionId, productId ?? null]
+    queryKey: [...QK4, collectionId, productId ?? null]
   });
   return {
     items: query.data ?? [],
@@ -1387,7 +1441,7 @@ function useShellBrowser(opts) {
     refetchAll
   };
 }
-var QK4 = ["records-admin", "single-product"];
+var QK5 = ["records-admin", "single-product"];
 var toBrowseItem2 = (p, fallbackId) => ({
   id: p?.id ?? p?.productId ?? fallbackId,
   name: p?.name ?? fallbackId,
@@ -1397,7 +1451,7 @@ var toBrowseItem2 = (p, fallbackId) => ({
 var useSingleProduct = (args) => {
   const { SL, collectionId, productId, enabled = true, admin = true } = args;
   const query = useQuery({
-    queryKey: [...QK4, collectionId, productId, admin],
+    queryKey: [...QK5, collectionId, productId, admin],
     enabled: enabled && !!collectionId && !!productId,
     staleTime: 6e4,
     queryFn: async () => {
@@ -6232,6 +6286,8 @@ var ProductDrillDown = ({
   batches,
   variantsLoading,
   batchesLoading,
+  variantsWithRecord,
+  batchesWithRecord,
   children,
   hideSingleTab
 }) => {
@@ -6242,6 +6298,7 @@ var ProductDrillDown = ({
   const childList = active === "variant" ? variants : active === "batch" ? batches : [];
   const childLoading = active === "variant" ? variantsLoading : active === "batch" ? batchesLoading : false;
   const childEmptyLabel = active === "variant" ? "No variants" : "No batches";
+  const childHasRecord = active === "variant" ? variantsWithRecord : active === "batch" ? batchesWithRecord : void 0;
   return /* @__PURE__ */ jsxs("div", { className: "flex flex-col h-full", children: [
     showTabStrip && /* @__PURE__ */ jsx(
       "div",
@@ -6291,7 +6348,8 @@ var ProductDrillDown = ({
             !childLoading && childList.length === 0 && /* @__PURE__ */ jsx("div", { className: "p-4 text-xs", style: { color: "hsl(var(--ra-muted-text))" }, children: childEmptyLabel }),
             !childLoading && childList.length > 0 && /* @__PURE__ */ jsx("ul", { className: "divide-y", style: { borderColor: "hsl(var(--ra-border))" }, children: childList.map((c) => {
               const isActive2 = c.id === selectedChildId;
-              return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
+              const hasRecord = childHasRecord?.has(c.id) ?? false;
+              return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
                 "button",
                 {
                   type: "button",
@@ -6300,10 +6358,20 @@ var ProductDrillDown = ({
                     "w-full text-left px-3 py-2 transition-colors hover:bg-[hsl(var(--ra-muted))]",
                     isActive2 && "ra-row-active"
                   ),
-                  children: [
-                    /* @__PURE__ */ jsx("div", { className: "text-sm truncate", style: { color: "hsl(var(--ra-text))" }, children: c.name }),
-                    c.subtitle && /* @__PURE__ */ jsx("div", { className: "text-xs truncate", style: { color: "hsl(var(--ra-muted-text))" }, children: c.subtitle })
-                  ]
+                  children: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1.5 min-w-0", children: [
+                    hasRecord ? /* @__PURE__ */ jsx(
+                      CheckCircle2,
+                      {
+                        "aria-label": "Has record",
+                        className: "w-3.5 h-3.5 shrink-0 ra-status-own-icon",
+                        style: { color: "hsl(var(--ra-status-own, 142 71% 45%))" }
+                      }
+                    ) : /* @__PURE__ */ jsx("span", { className: "w-3.5 h-3.5 shrink-0", "aria-hidden": "true" }),
+                    /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+                      /* @__PURE__ */ jsx("div", { className: "text-sm truncate", style: { color: "hsl(var(--ra-text))" }, children: c.name }),
+                      c.subtitle && /* @__PURE__ */ jsx("div", { className: "text-xs truncate", style: { color: "hsl(var(--ra-muted-text))" }, children: c.subtitle })
+                    ] })
+                  ] })
                 }
               ) }, c.id);
             }) })
@@ -9245,6 +9313,7 @@ function RecordsAdminShellInner(props) {
     defaultScope,
     contextScope,
     contextScopeMode = "strict",
+    maxDrillDepth = "batch",
     renderEditor,
     intro,
     csvSchema,
@@ -9438,13 +9507,16 @@ function RecordsAdminShellInner(props) {
     if (!productPinnedFromContext || contextScopeMode !== "strict") return topLevelScopes;
     return topLevelScopes.filter((s) => s !== "collection" && s !== "rule" && s !== "all");
   }, [productPinnedFromContext, contextScopeMode, topLevelScopes]);
+  const drillDepthAllowed = cardinality === "singleton";
+  const allowVariantDepth = drillDepthAllowed && (maxDrillDepth === "variant" || maxDrillDepth === "batch");
+  const allowBatchDepth = drillDepthAllowed && maxDrillDepth === "batch";
   const drillVariantsAllowed = useMemo(
-    () => requestedScopes.includes("variant") && (probe.isLoading || probe.hasVariants),
-    [requestedScopes, probe.isLoading, probe.hasVariants]
+    () => allowVariantDepth && (probe.isLoading || probe.hasVariants),
+    [allowVariantDepth, probe.isLoading, probe.hasVariants]
   );
   const drillBatchesAllowed = useMemo(
-    () => requestedScopes.includes("batch") && (probe.isLoading || probe.hasBatches),
-    [requestedScopes, probe.isLoading, probe.hasBatches]
+    () => allowBatchDepth && (probe.isLoading || probe.hasBatches),
+    [allowBatchDepth, probe.isLoading, probe.hasBatches]
   );
   const initialScope = useMemo(() => {
     if (contextScope?.productId && effectiveTopLevelScopes.includes("product")) return "product";
@@ -9563,6 +9635,14 @@ function RecordsAdminShellInner(props) {
     productId: contextScope?.productId,
     enabled: !!contextScope?.productId
   });
+  const productSubRecords = useProductSubRecords({
+    SL,
+    collectionId,
+    appId,
+    recordType,
+    productId: selectedProductId,
+    enabled: !!selectedProductId
+  });
   const productLookupItems = useMemo(() => {
     if (pinnedProduct.item) return [pinnedProduct.item];
     return productBrowse.items;
@@ -11612,61 +11692,70 @@ function RecordsAdminShellInner(props) {
                   }
                 ),
                 ruleWizardStep === null && !isCollection && !editingScope && activeScope === "product" && !selectedProductId && /* @__PURE__ */ jsx(EmptyState, { title: i18n.emptyTitle, body: i18n.emptyBody }),
-                ruleWizardStep === null && isProductTab && selectedProductId && (!isCollection || selectedItemId) && !(!isCollection && editingTargetScope && resolved.source !== "self" && selectedRecordId !== DRAFT_ID3) && /* @__PURE__ */ jsx(
-                  ProductDrillDown,
-                  {
-                    productLabel: productBrowse.items.find((p) => p.id === selectedProductId)?.name ?? selectedProductId,
-                    showVariants: drillVariantsAllowed,
-                    showBatches: drillBatchesAllowed,
-                    hideSingleTab: editorTabs === "off" || editorTabs === "multi",
-                    active: drillTab,
-                    onChange: (t) => {
-                      void runWithGuard(() => {
-                        setDrillTab(t);
-                        if (t === "product") {
-                          setSelectedVariantId(void 0);
-                          setSelectedBatchId(void 0);
-                        }
-                      });
-                    },
-                    selectedChildId: drillTab === "variant" ? selectedVariantId : drillTab === "batch" ? selectedBatchId : void 0,
-                    onSelectChild: (id) => {
-                      void runWithGuard(() => {
-                        if (drillTab === "variant") setSelectedVariantId(id);
-                        else if (drillTab === "batch") setSelectedBatchId(id);
-                      });
-                    },
-                    variants: variantChildren.items,
-                    batches: batchChildren.items,
-                    variantsLoading: variantChildren.isLoading,
-                    batchesLoading: batchChildren.isLoading,
-                    children: editingTargetScope ? renderEditorWithPreview() : /* @__PURE__ */ jsx(
-                      EmptyState,
-                      {
-                        title: drillTab === "variant" ? "Pick a variant" : "Pick a batch",
-                        body: `Select a ${drillTab} on the left to edit its ${recordType ?? label.toLowerCase()}.`
-                      }
-                    )
-                  }
-                ),
-                ruleWizardStep === null && isProductTab && selectedProductId && !isCollection && editingTargetScope && resolved.source !== "self" && selectedRecordId !== DRAFT_ID3 ? (() => {
-                  const productName = productLookupItems.find((p) => p.id === selectedProductId)?.name ?? selectedProductId;
+                ruleWizardStep === null && isProductTab && selectedProductId && (!isCollection || selectedItemId) && (() => {
+                  const productName = productLookupItems.find((p) => p.id === selectedProductId)?.name ?? productBrowse.items.find((p) => p.id === selectedProductId)?.name ?? selectedProductId;
+                  const variantName = drillTab === "variant" && selectedVariantId ? variantChildren.items.find((v) => v.id === selectedVariantId)?.name ?? selectedVariantId : void 0;
+                  const batchName = drillTab === "batch" && selectedBatchId ? batchChildren.items.find((b) => b.id === selectedBatchId)?.name ?? selectedBatchId : void 0;
+                  const targetKind = variantName ? "variant" : batchName ? "batch" : "product";
+                  const targetName = variantName ?? batchName ?? productName;
                   const pasteEntry = wizardClipboard.entry;
                   const pasteSourceLabel = pasteEntry?.sourceLabel ?? pasteEntry?.sourceScope.raw;
+                  const onlyNonActive = resolved.source === "self" && !!resolved.lifecycleStatus && !resolvedActiveStatuses.includes(resolved.lifecycleStatus);
+                  const needsChooser = !isCollection && editingTargetScope && selectedRecordId !== DRAFT_ID3 && (resolved.source !== "self" || onlyNonActive);
+                  const chooserTitle = onlyNonActive ? `No active ${itemNoun} for ${targetKind}: ${targetName}` : `No ${itemNoun} set for ${targetKind}: ${targetName}`;
+                  const chooserBody = onlyNonActive ? `The existing ${itemNoun} for this ${targetKind} is ${resolved.lifecycleStatus}. Start a fresh ${itemNoun} to replace it, or copy from the global default.` : `Choose whether to create a fresh ${itemNoun} for this ${targetKind} or start from the global default.`;
                   return /* @__PURE__ */ jsx(
-                    CreateRecordChooser,
+                    ProductDrillDown,
                     {
-                      title: `No ${itemNoun} set for product: ${productName}`,
-                      body: `Choose whether to create a fresh ${itemNoun} for this product or start from the global default.`,
-                      primaryLabel: "Start blank",
-                      onPrimary: () => onCreateProductRecord("blank"),
-                      secondaryLabel: singletonGlobalSeedAvailable ? "Copy from global" : void 0,
-                      onSecondary: singletonGlobalSeedAvailable ? () => onCreateProductRecord("global") : void 0,
-                      tertiaryLabel: pasteEntry ? pasteSourceLabel ? `Paste from ${pasteSourceLabel}` : "Paste from clipboard" : void 0,
-                      onTertiary: pasteEntry ? () => onCreateProductRecord("paste") : void 0
+                      productLabel: productName,
+                      showVariants: drillVariantsAllowed,
+                      showBatches: drillBatchesAllowed,
+                      hideSingleTab: editorTabs === "off" || editorTabs === "multi",
+                      active: drillTab,
+                      onChange: (t) => {
+                        void runWithGuard(() => {
+                          setDrillTab(t);
+                          if (t === "product") {
+                            setSelectedVariantId(void 0);
+                            setSelectedBatchId(void 0);
+                          }
+                        });
+                      },
+                      selectedChildId: drillTab === "variant" ? selectedVariantId : drillTab === "batch" ? selectedBatchId : void 0,
+                      onSelectChild: (id) => {
+                        void runWithGuard(() => {
+                          if (drillTab === "variant") setSelectedVariantId(id);
+                          else if (drillTab === "batch") setSelectedBatchId(id);
+                        });
+                      },
+                      variants: variantChildren.items,
+                      batches: batchChildren.items,
+                      variantsLoading: variantChildren.isLoading,
+                      batchesLoading: batchChildren.isLoading,
+                      variantsWithRecord: productSubRecords.variantIds,
+                      batchesWithRecord: productSubRecords.batchIds,
+                      children: needsChooser ? /* @__PURE__ */ jsx(
+                        CreateRecordChooser,
+                        {
+                          title: chooserTitle,
+                          body: chooserBody,
+                          primaryLabel: "Start blank",
+                          onPrimary: () => onCreateProductRecord("blank"),
+                          secondaryLabel: singletonGlobalSeedAvailable ? "Copy from global" : void 0,
+                          onSecondary: singletonGlobalSeedAvailable ? () => onCreateProductRecord("global") : void 0,
+                          tertiaryLabel: pasteEntry ? pasteSourceLabel ? `Paste from ${pasteSourceLabel}` : "Paste from clipboard" : void 0,
+                          onTertiary: pasteEntry ? () => onCreateProductRecord("paste") : void 0
+                        }
+                      ) : editingTargetScope ? renderEditorWithPreview() : /* @__PURE__ */ jsx(
+                        EmptyState,
+                        {
+                          title: drillTab === "variant" ? "Pick a variant" : "Pick a batch",
+                          body: `Select a ${drillTab} on the left to edit its ${recordType ?? label.toLowerCase()}.`
+                        }
+                      )
                     }
                   );
-                })() : null,
+                })(),
                 ruleWizardStep === null && !isProductTab && editingTargetScope && (!isCollection || selectedItemId) && renderEditorWithPreview()
               ] })
             ]