@proveanything/smartlinks-utils-ui 0.10.7 → 0.10.8

package/dist/{IconPicker-BMMQLR5I.d.ts → IconPicker-DKpL5Hcc.d.ts}

@@ -40,4 +40,4 @@ interface IconPickerProps {
 
 declare const IconPicker: React$1.FC<IconPickerProps>;
 
-export { IconPicker as I, type IconPickerProps as a, type IconSelection as b, type IconFamily as c, type IconStyle as d };
+export { type IconFamily as I, type IconStyle as a, IconPicker as b, type IconPickerProps as c, type IconSelection as d };

package/dist/chunk-2MW54ZVG.js

@@ -0,0 +1,92 @@
+import { useId } from 'react';
+import { BookOpen, HelpCircle, AlertTriangle, CheckCircle2, Lightbulb, Info, X } from 'lucide-react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/components/AdminPageHeader/AdminPageHeader.tsx
+var TONE_ICON = {
+  info: Lightbulb,
+  success: CheckCircle2,
+  warning: AlertTriangle
+};
+function AdminPageHeader({
+  title,
+  subtitle,
+  icon,
+  helpUrl,
+  helpLabel,
+  actions,
+  aside,
+  intro,
+  className
+}) {
+  const titleId = useId();
+  const resolvedHelpLabel = helpLabel ?? "Help & documentation";
+  const resolvedReopenLabel = intro?.reopenLabel ?? "How it works";
+  const showReopen = !!intro && intro.dismissed && !!intro.onReopen;
+  const showIntro = !!intro && !intro.dismissed;
+  return /* @__PURE__ */ jsxs("header", { className: `sl-aph${className ? ` ${className}` : ""}`, "aria-labelledby": titleId, children: [
+    /* @__PURE__ */ jsxs("div", { className: "sl-aph__row", children: [
+      /* @__PURE__ */ jsx("div", { className: "sl-aph__main", children: /* @__PURE__ */ jsxs("div", { className: "sl-aph__text", children: [
+        /* @__PURE__ */ jsxs("h1", { className: "sl-aph__title", id: titleId, children: [
+          icon ? /* @__PURE__ */ jsx("span", { className: "sl-aph__icon", "aria-hidden": "true", children: icon }) : null,
+          /* @__PURE__ */ jsx("span", { children: title })
+        ] }),
+        subtitle ? /* @__PURE__ */ jsx("p", { className: "sl-aph__subtitle", children: subtitle }) : null
+      ] }) }),
+      actions || aside || helpUrl || showReopen ? /* @__PURE__ */ jsxs("div", { className: "sl-aph__aside", children: [
+        actions,
+        aside,
+        helpUrl ? /* @__PURE__ */ jsx(
+          "a",
+          {
+            href: helpUrl,
+            target: "_blank",
+            rel: "noopener noreferrer",
+            className: "sl-aph__icon-btn",
+            "aria-label": resolvedHelpLabel,
+            title: resolvedHelpLabel,
+            children: /* @__PURE__ */ jsx(BookOpen, { "aria-hidden": "true" })
+          }
+        ) : null,
+        showReopen ? /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            onClick: intro.onReopen,
+            className: "sl-aph__icon-btn",
+            "aria-label": resolvedReopenLabel,
+            title: resolvedReopenLabel,
+            children: /* @__PURE__ */ jsx(HelpCircle, { "aria-hidden": "true" })
+          }
+        ) : null
+      ] }) : null
+    ] }),
+    showIntro ? /* @__PURE__ */ jsx(AdminPageHeaderIntroCard, { intro }) : null
+  ] });
+}
+function AdminPageHeaderIntroCard({ intro }) {
+  const tone = intro.tone ?? "info";
+  const Icon = TONE_ICON[tone] ?? Info;
+  return /* @__PURE__ */ jsxs("div", { className: "sl-aph__intro", "data-tone": tone, role: "note", children: [
+    /* @__PURE__ */ jsx("div", { className: "sl-aph__intro-icon", children: /* @__PURE__ */ jsx(Icon, { "aria-hidden": "true", style: { width: "0.95rem", height: "0.95rem" } }) }),
+    /* @__PURE__ */ jsxs("div", { className: "sl-aph__intro-body", children: [
+      /* @__PURE__ */ jsx("h4", { className: "sl-aph__intro-title", children: intro.title }),
+      /* @__PURE__ */ jsx("span", { className: "sl-aph__intro-text", children: intro.body }),
+      intro.action ? /* @__PURE__ */ jsx("span", { className: "sl-aph__intro-action", children: intro.action }) : null
+    ] }),
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: intro.onDismiss,
+        "aria-label": "Dismiss",
+        className: "sl-aph__intro-dismiss",
+        children: /* @__PURE__ */ jsx(X, { "aria-hidden": "true", style: { width: "0.875rem", height: "0.875rem" } })
+      }
+    )
+  ] });
+}
+
+export { AdminPageHeader };
+//# sourceMappingURL=chunk-2MW54ZVG.js.map
+//# sourceMappingURL=chunk-2MW54ZVG.js.map

package/dist/chunk-2MW54ZVG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/AdminPageHeader/AdminPageHeader.tsx"],"names":[],"mappings":"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","file":"chunk-2MW54ZVG.js","sourcesContent":["// =============================================================================\r\n// AdminPageHeader\r\n//\r\n// A standardised page header for any SmartLinks admin surface. Designed to be\r\n// used standalone (lightweight apps that don't need the full RecordsAdminShell)\r\n// or composed inside other shells. Supports:\r\n//\r\n//   • Inline icon + title + full-width subtitle\r\n//   • Right-aligned slot for app-specific actions (e.g. \"+ New\" button)\r\n//   • External help link (icon-button that opens docs in a new tab)\r\n//   • Optional dismissible intro card with `?` reopen affordance\r\n//   • Optional `aside` slot for extra header content (stats strips, etc.)\r\n//\r\n// Styling is self-contained under `.sl-aph` and reuses the shared `--ra-*`\r\n// design tokens with sensible fallbacks, so it themes correctly whether the\r\n// host has loaded the records-admin token sheet or not.\r\n// =============================================================================\r\nimport { type ReactNode, useId } from 'react';\r\nimport { BookOpen, HelpCircle, X, Lightbulb, CheckCircle2, AlertTriangle, Info } from 'lucide-react';\r\nimport './admin-page-header.css';\r\n\r\nexport type AdminPageHeaderIntroTone = 'info' | 'success' | 'warning';\r\n\r\nexport interface AdminPageHeaderIntro {\r\n  /** Short headline shown in bold at the start of the intro card. */\r\n  title: string;\r\n  /** Body content — plain text or rich nodes. */\r\n  body: ReactNode;\r\n  /** Visual tone — controls icon and surface tint. Default `'info'`. */\r\n  tone?: AdminPageHeaderIntroTone;\r\n  /** Optional action node rendered inline after the body (e.g. a Learn-more link). */\r\n  action?: ReactNode;\r\n  /** Whether the intro is currently dismissed. Controlled. */\r\n  dismissed: boolean;\r\n  /** Called when the user clicks the dismiss `X`. */\r\n  onDismiss: () => void;\r\n  /**\r\n   * Called when the user clicks the reopen `?` button (only rendered when\r\n   * dismissed is true). Omit to hide the reopen affordance entirely.\r\n   */\r\n  onReopen?: () => void;\r\n  /** Tooltip / aria-label for the reopen button. Default \"How it works\". */\r\n  reopenLabel?: string;\r\n}\r\n\r\nexport interface AdminPageHeaderProps {\r\n  /** Page title — required. */\r\n  title: string;\r\n  /** Single-line muted subtitle under the title. */\r\n  subtitle?: string;\r\n  /** Icon rendered inline before the title. Pass a Lucide element or any node. */\r\n  icon?: ReactNode;\r\n  /**\r\n   * External help / documentation URL. When set, renders a small icon-button\r\n   * that opens the URL in a new tab. Use this to point at app-specific docs.\r\n   */\r\n  helpUrl?: string;\r\n  /** Tooltip / aria-label for the help link. Default \"Help & documentation\". */\r\n  helpLabel?: string;\r\n  /**\r\n   * Right-aligned action slot — typically a primary \"+ New\" button and/or\r\n   * secondary controls. Rendered before the help / intro-reopen icon-buttons.\r\n   */\r\n  actions?: ReactNode;\r\n  /**\r\n   * Extra header content rendered between `actions` and the trailing\r\n   * help / reopen icon-buttons. Used by RecordsAdminShell for its stats strip;\r\n   * standalone apps rarely need it.\r\n   */\r\n  aside?: ReactNode;\r\n  /**\r\n   * Optional dismissible intro card rendered below the header row.\r\n   * See {@link AdminPageHeaderIntro}.\r\n   */\r\n  intro?: AdminPageHeaderIntro;\r\n  /** Extra class on the root container for layout overrides. */\r\n  className?: string;\r\n}\r\n\r\nconst TONE_ICON = {\r\n  info: Lightbulb,\r\n  success: CheckCircle2,\r\n  warning: AlertTriangle,\r\n} as const;\r\n\r\nexport function AdminPageHeader({\r\n  title, subtitle, icon, helpUrl, helpLabel,\r\n  actions, aside, intro, className,\r\n}: AdminPageHeaderProps) {\r\n  const titleId = useId();\r\n  const resolvedHelpLabel = helpLabel ?? 'Help & documentation';\r\n  const resolvedReopenLabel = intro?.reopenLabel ?? 'How it works';\r\n  const showReopen = !!intro && intro.dismissed && !!intro.onReopen;\r\n  const showIntro = !!intro && !intro.dismissed;\r\n\r\n  return (\r\n    <header className={`sl-aph${className ? ` ${className}` : ''}`} aria-labelledby={titleId}>\r\n      <div className=\"sl-aph__row\">\r\n        <div className=\"sl-aph__main\">\r\n          <div className=\"sl-aph__text\">\r\n            <h1 className=\"sl-aph__title\" id={titleId}>\r\n              {icon ? (\r\n                <span className=\"sl-aph__icon\" aria-hidden=\"true\">{icon}</span>\r\n              ) : null}\r\n              <span>{title}</span>\r\n            </h1>\r\n            {subtitle ? <p className=\"sl-aph__subtitle\">{subtitle}</p> : null}\r\n          </div>\r\n        </div>\r\n        {(actions || aside || helpUrl || showReopen) ? (\r\n          <div className=\"sl-aph__aside\">\r\n            {actions}\r\n            {aside}\r\n            {helpUrl ? (\r\n              <a\r\n                href={helpUrl}\r\n                target=\"_blank\"\r\n                rel=\"noopener noreferrer\"\r\n                className=\"sl-aph__icon-btn\"\r\n                aria-label={resolvedHelpLabel}\r\n                title={resolvedHelpLabel}\r\n              >\r\n                <BookOpen aria-hidden=\"true\" />\r\n              </a>\r\n            ) : null}\r\n            {showReopen ? (\r\n              <button\r\n                type=\"button\"\r\n                onClick={intro!.onReopen}\r\n                className=\"sl-aph__icon-btn\"\r\n                aria-label={resolvedReopenLabel}\r\n                title={resolvedReopenLabel}\r\n              >\r\n                <HelpCircle aria-hidden=\"true\" />\r\n              </button>\r\n            ) : null}\r\n          </div>\r\n        ) : null}\r\n      </div>\r\n      {showIntro ? <AdminPageHeaderIntroCard intro={intro!} /> : null}\r\n    </header>\r\n  );\r\n}\r\n\r\nfunction AdminPageHeaderIntroCard({ intro }: { intro: AdminPageHeaderIntro }) {\r\n  const tone = intro.tone ?? 'info';\r\n  const Icon = TONE_ICON[tone] ?? Info;\r\n  return (\r\n    <div className=\"sl-aph__intro\" data-tone={tone} role=\"note\">\r\n      <div className=\"sl-aph__intro-icon\">\r\n        <Icon aria-hidden=\"true\" style={{ width: '0.95rem', height: '0.95rem' }} />\r\n      </div>\r\n      <div className=\"sl-aph__intro-body\">\r\n        <h4 className=\"sl-aph__intro-title\">{intro.title}</h4>\r\n        <span className=\"sl-aph__intro-text\">{intro.body}</span>\r\n        {intro.action ? <span className=\"sl-aph__intro-action\">{intro.action}</span> : null}\r\n      </div>\r\n      <button\r\n        type=\"button\"\r\n        onClick={intro.onDismiss}\r\n        aria-label=\"Dismiss\"\r\n        className=\"sl-aph__intro-dismiss\"\r\n      >\r\n        <X aria-hidden=\"true\" style={{ width: '0.875rem', height: '0.875rem' }} />\r\n      </button>\r\n    </div>\r\n  );\r\n}"]}

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

@@ -1,4 +1,4 @@
-export { a as AssetItem, c as AssetPicker, d as AssetPickerMode, e as AssetPickerProps, f as AssetPickerSelection, g as AssetScope, h as AssetViewMode, u as useAssets } from '../../useAssets-BM1bzzkq.js';
+export { A as AssetItem, a as AssetPicker, b as AssetPickerMode, c as AssetPickerProps, d as AssetPickerSelection, e as AssetScope, f as AssetViewMode, u as useAssets } from '../../useAssets-BAtXv6D5.js';
 import 'react';
 
 interface AppRegistryEntry {

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

@@ -1,5 +1,5 @@
-import { c as IconFamily, d as IconStyle } from '../../IconPicker-BMMQLR5I.js';
-export { I as IconPicker, a as IconPickerProps, b as IconSelection } from '../../IconPicker-BMMQLR5I.js';
+import { I as IconFamily, a as IconStyle } from '../../IconPicker-DKpL5Hcc.js';
+export { b as IconPicker, c as IconPickerProps, d as IconSelection } from '../../IconPicker-DKpL5Hcc.js';
 import 'react';
 
 declare function toFaClass(id: string, family: IconFamily, style: IconStyle | null): string;

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

@@ -962,7 +962,35 @@ interface RailConfig<TData = unknown> {
         key: string;
         label: string;
         icon?: ReactNode;
+        /**
+         * Whether this bucket should be expanded by default (records-driven
+         * accordion mode). Last-write-wins per key. Has no effect in the
+         * collection-cardinality lifecycle-rail mode where buckets are flat
+         * selectable rows rather than accordion sections.
+         */
+        defaultOpen?: boolean;
+        /**
+         * Semantic tone for the bucket — drives a CSS data attribute on the
+         * lifecycle bucket row (`data-tone="success" | "warning" | "muted"`).
+         * Apps style via `[data-tone="…"]` selectors against existing
+         * semantic tokens.
+         */
+        tone?: 'default' | 'success' | 'warning' | 'muted' | 'danger';
     } | null;
+    /**
+     * Initial bucket key to select on first mount of the lifecycle rail
+     * (collection cardinality + `'all'` / `'global'` scope + `groupBy`).
+     * Ignored when a deep-link state restores a different selection. Pass
+     * the same key shape your `groupBy` returns (e.g. `"1-open"`).
+     */
+    defaultGroupKey?: string;
+    /**
+     * EXPERIMENTAL — invoked the first time a lifecycle bucket is selected
+     * (collection-cardinality lifecycle rail). Hosts can use this to trigger
+     * supplemental fetches before the bucket-filtered table renders. May be
+     * called more than once per key. API may change before stabilising.
+     */
+    onGroupExpanded?: (key: string) => void;
     /** Visual density. Default `comfortable`. */
     density?: 'comfortable' | 'compact';
 }
@@ -1696,7 +1724,7 @@ declare const useRecordList: (args: UseRecordListArgs) => {
     };
     isLoading: boolean;
     error: Error | null;
-    refetch: () => void;
+    refetch: () => Promise<void>;
     hasNextPage: boolean;
     isFetchingNextPage: boolean;
     fetchNextPage: (options?: _tanstack_query_core.FetchNextPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<{
@@ -1841,7 +1869,7 @@ declare function useCollectionItems<T = unknown>(args: UseCollectionItemsArgs):
         hasMore: boolean;
         nextOffset: number;
     }, unknown>, Error>>;
-    refetch: () => void;
+    refetch: () => Promise<void>;
 };
 
 /**

package/dist/components/RecordsAdmin/index.js

@@ -1,3 +1,4 @@
+import { AdminPageHeader } from '../../chunk-2MW54ZVG.js';
 import { assertComponentStylesLoaded } from '../../chunk-OLYC54YT.js';
 import '../../chunk-5UQQYXCX.js';
 import { FacetRuleEditor } from '../../chunk-JMCV6FOW.js';
@@ -5,8 +6,8 @@ import { useFacets } from '../../chunk-4LHF5JB7.js';
 import { cn } from '../../chunk-L7FQ52F5.js';
 import { parsedRefToTarget, parsedRefToScope, matchRecords, scopesEqual, getRecordById, listRecords, upsertRecord, updateRecord, createRecord, removeRecord } from '../../chunk-KA4MKRHL.js';
 export { bulkDelete, bulkUpsert, createRecord, getRecordById, listRecords, matchRecords, parsedRefToScope, parsedRefToTarget, removeRecord, restoreRecord, scopesEqual, upsertRecord } from '../../chunk-KA4MKRHL.js';
-import { createContext, useState, useEffect, useCallback, useMemo, useRef, useContext, useSyncExternalStore, useLayoutEffect, 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, Target, Rows3, ChevronRight, Eraser, ClipboardPaste, Box, X, Search, Image, Table, ArrowLeft, ChevronLeft, AlertTriangle, Info, HelpCircle, CornerDownLeft, Circle, CopyPlus, AlertCircle, Undo2, Save, Loader2, XCircle, ArrowRight, BookOpen, Globe2, Check, Settings2 } from 'lucide-react';
+import { createContext, useState, useEffect, useCallback, useMemo, useRef, useContext, useSyncExternalStore, useLayoutEffect, createElement } 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, Target, Rows3, ChevronRight, Eraser, ClipboardPaste, Box, X, Search, Image, Table, ArrowLeft, ChevronLeft, AlertTriangle, Info, HelpCircle, CornerDownLeft, Circle, CopyPlus, AlertCircle, Undo2, Save, Loader2, XCircle, ArrowRight, Globe2, 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';
@@ -690,9 +691,9 @@ var useRecordList = (args) => {
     partial: items.filter((r) => r.status === "partial").length,
     empty: items.filter((r) => r.status === "empty").length
   }), [items]);
-  const refetch = useCallback(() => {
-    queryClient.invalidateQueries({ queryKey: [...QK_BASE2, ctx.collectionId, ctx.appId, ctx.recordType] });
-  }, [queryClient, ctx.collectionId, ctx.appId, ctx.recordType]);
+  const refetch = useCallback(() => queryClient.refetchQueries({
+    queryKey: [...QK_BASE2, ctx.collectionId, ctx.appId, ctx.recordType]
+  }), [queryClient, ctx.collectionId, ctx.appId, ctx.recordType]);
   const total = query.data?.pages[query.data.pages.length - 1]?.total ?? items.length;
   return {
     allItems: items,
@@ -3125,9 +3126,11 @@ var useShellSelection = (args) => {
   }, [contextScope?.batchId]);
   const [selectedItemId, setSelectedItemId] = useState(null);
   const skipNextItemResetRef = useRef(false);
+  const [selectedLifecycleKey, setSelectedLifecycleKey] = useState(null);
   useEffect(() => {
     setSelectedRecordId(null);
     setDraftKind(null);
+    setSelectedLifecycleKey(null);
   }, [activeScope]);
   return {
     activeScope,
@@ -3150,6 +3153,8 @@ var useShellSelection = (args) => {
     setSelectedBatchId,
     selectedItemId,
     setSelectedItemId,
+    selectedLifecycleKey,
+    setSelectedLifecycleKey,
     skipNextItemResetRef
   };
 };
@@ -4086,9 +4091,7 @@ function useCollectionItems(args) {
       return toSummary2(rec, base);
     }).filter((x) => x !== null);
   }, [query.data, toSummary2, scope, ruleSignature, includeAll]);
-  const refetch = useCallback(() => {
-    queryClient.invalidateQueries({ queryKey });
-  }, [queryClient, queryKey]);
+  const refetch = useCallback(() => queryClient.refetchQueries({ queryKey }), [queryClient, queryKey]);
   return {
     items,
     total: query.data?.pages[query.data.pages.length - 1]?.total ?? items.length,
@@ -6193,89 +6196,6 @@ var UtilityRow = ({ label, customLabel, introHidden, onShowIntro }) => {
     }
   );
 };
-var TONE_ICON2 = {
-  info: Lightbulb,
-  success: CheckCircle2,
-  warning: AlertTriangle
-};
-function AdminPageHeader({
-  title,
-  subtitle,
-  icon,
-  helpUrl,
-  helpLabel,
-  actions,
-  aside,
-  intro,
-  className
-}) {
-  const titleId = useId();
-  const resolvedHelpLabel = helpLabel ?? "Help & documentation";
-  const resolvedReopenLabel = intro?.reopenLabel ?? "How it works";
-  const showReopen = !!intro && intro.dismissed && !!intro.onReopen;
-  const showIntro = !!intro && !intro.dismissed;
-  return /* @__PURE__ */ jsxs("header", { className: `sl-aph${className ? ` ${className}` : ""}`, "aria-labelledby": titleId, children: [
-    /* @__PURE__ */ jsxs("div", { className: "sl-aph__row", children: [
-      /* @__PURE__ */ jsx("div", { className: "sl-aph__main", children: /* @__PURE__ */ jsxs("div", { className: "sl-aph__text", children: [
-        /* @__PURE__ */ jsxs("h1", { className: "sl-aph__title", id: titleId, children: [
-          icon ? /* @__PURE__ */ jsx("span", { className: "sl-aph__icon", "aria-hidden": "true", children: icon }) : null,
-          /* @__PURE__ */ jsx("span", { children: title })
-        ] }),
-        subtitle ? /* @__PURE__ */ jsx("p", { className: "sl-aph__subtitle", children: subtitle }) : null
-      ] }) }),
-      actions || aside || helpUrl || showReopen ? /* @__PURE__ */ jsxs("div", { className: "sl-aph__aside", children: [
-        actions,
-        aside,
-        helpUrl ? /* @__PURE__ */ jsx(
-          "a",
-          {
-            href: helpUrl,
-            target: "_blank",
-            rel: "noopener noreferrer",
-            className: "sl-aph__icon-btn",
-            "aria-label": resolvedHelpLabel,
-            title: resolvedHelpLabel,
-            children: /* @__PURE__ */ jsx(BookOpen, { "aria-hidden": "true" })
-          }
-        ) : null,
-        showReopen ? /* @__PURE__ */ jsx(
-          "button",
-          {
-            type: "button",
-            onClick: intro.onReopen,
-            className: "sl-aph__icon-btn",
-            "aria-label": resolvedReopenLabel,
-            title: resolvedReopenLabel,
-            children: /* @__PURE__ */ jsx(HelpCircle, { "aria-hidden": "true" })
-          }
-        ) : null
-      ] }) : null
-    ] }),
-    showIntro ? /* @__PURE__ */ jsx(AdminPageHeaderIntroCard, { intro }) : null
-  ] });
-}
-function AdminPageHeaderIntroCard({ intro }) {
-  const tone = intro.tone ?? "info";
-  const Icon = TONE_ICON2[tone] ?? Info;
-  return /* @__PURE__ */ jsxs("div", { className: "sl-aph__intro", "data-tone": tone, role: "note", children: [
-    /* @__PURE__ */ jsx("div", { className: "sl-aph__intro-icon", children: /* @__PURE__ */ jsx(Icon, { "aria-hidden": "true", style: { width: "0.95rem", height: "0.95rem" } }) }),
-    /* @__PURE__ */ jsxs("div", { className: "sl-aph__intro-body", children: [
-      /* @__PURE__ */ jsx("h4", { className: "sl-aph__intro-title", children: intro.title }),
-      /* @__PURE__ */ jsx("span", { className: "sl-aph__intro-text", children: intro.body }),
-      intro.action ? /* @__PURE__ */ jsx("span", { className: "sl-aph__intro-action", children: intro.action }) : null
-    ] }),
-    /* @__PURE__ */ jsx(
-      "button",
-      {
-        type: "button",
-        onClick: intro.onDismiss,
-        "aria-label": "Dismiss",
-        className: "sl-aph__intro-dismiss",
-        children: /* @__PURE__ */ jsx(X, { "aria-hidden": "true", style: { width: "0.875rem", height: "0.875rem" } })
-      }
-    )
-  ] });
-}
 function ShellHeader({
   title,
   subtitle,
@@ -7452,6 +7372,8 @@ function RecordsAdminShellInner(props) {
     renderListRow,
     renderEmpty: renderEmptyState,
     groupBy,
+    defaultGroupKey,
+    onGroupExpanded,
     density = "comfortable"
   } = rail ?? {};
   const {
@@ -7592,8 +7514,11 @@ function RecordsAdminShellInner(props) {
     setSelectedBatchId,
     selectedItemId,
     setSelectedItemId,
+    selectedLifecycleKey,
+    setSelectedLifecycleKey,
     skipNextItemResetRef
   } = selection;
+  const [isReconcilingRecordSelection, setIsReconcilingRecordSelection] = useState(false);
   const { dismissed, dismiss, undismiss } = useIntroDismissed(SL, collectionId, appId, recordType);
   const headerWillRender = useMemo(() => {
     const headerCustomised = !!title || !!subtitle || !!headerIcon || !!headerActions || showStats || !!statsItems || !!statsTitle || !!statsIcon || !!helpUrl;
@@ -7654,6 +7579,7 @@ function RecordsAdminShellInner(props) {
   useEffect(() => {
     if (activeScope !== "rule" && activeScope !== "collection" && activeScope !== "all") return;
     if (selectedRecordId !== null) return;
+    if (isReconcilingRecordSelection) return;
     if (ruleWizardStep !== null) return;
     if (draftKind !== null) return;
     if (activeScope === "collection" && cardinality === "collection") {
@@ -7664,7 +7590,7 @@ function RecordsAdminShellInner(props) {
     }
     const first = recordList.items[0];
     if (first?.id) setSelectedRecordId(first.id);
-  }, [activeScope, selectedRecordId, recordList.items, cardinality, ruleWizardStep, draftKind]);
+  }, [activeScope, selectedRecordId, recordList.items, cardinality, ruleWizardStep, draftKind, isReconcilingRecordSelection]);
   const editingScopes = useEditingScope({
     activeScope,
     cardinality,
@@ -7761,10 +7687,15 @@ function RecordsAdminShellInner(props) {
     supportedScopes: supportedForResolution,
     enabled: !!editingTargetScope
   });
-  const refetchAll = useCallback(() => {
-    recordList.refetch();
-    if (isCollection) collectionItems.refetch();
-  }, [recordList, isCollection, collectionItems]);
+  const refetchAll = useCallback(async () => {
+    await Promise.all([
+      recordList.refetch(),
+      isCollection ? collectionItems.refetch() : Promise.resolve(),
+      queryClient.refetchQueries({
+        queryKey: scopeCountsQueryKey(ctx.collectionId, ctx.appId, ctx.recordType)
+      })
+    ]);
+  }, [recordList, isCollection, collectionItems, queryClient, ctx.collectionId, ctx.appId, ctx.recordType]);
   const { editorCtx } = useShellEditorTarget({
     editingTargetScope,
     isCollection,
@@ -7783,7 +7714,7 @@ function RecordsAdminShellInner(props) {
     },
     defaultData,
     deriveDraftLabel,
-    onSaved: (isCreate, savedRecordId) => {
+    onSaved: async (isCreate, savedRecordId) => {
       onTelemetry?.({ type: "record.save", recordType, ref: editingTargetScope?.raw ?? "", isCreate });
       if (ruleWizardStep !== null) {
         setRuleWizardStep(null);
@@ -7791,15 +7722,20 @@ function RecordsAdminShellInner(props) {
         setDraftKind(null);
       }
       if (isCreate && selectedRecordId === DRAFT_ID3) {
-        setSelectedRecordId(savedRecordId ?? null);
+        setIsReconcilingRecordSelection(true);
+        setSelectedRecordId(null);
         setDraftKind(null);
       }
       if (isCreate && isCollection && savedRecordId && isDraftId3(selectedItemId)) {
         setSelectedItemId(savedRecordId);
       }
-      refetchAll();
+      await refetchAll();
+      if (!isCollection && isCreate && activeScope === "collection") {
+        setSelectedRecordId(savedRecordId ?? null);
+      }
+      setIsReconcilingRecordSelection(false);
     },
-    onDeleted: () => {
+    onDeleted: async () => {
       onTelemetry?.({ type: "record.delete", recordType, ref: editingTargetScope?.raw ?? "" });
       if (isCollection && selectedItemId) {
         setSelectedItemId(null);
@@ -7808,10 +7744,12 @@ function RecordsAdminShellInner(props) {
       } else if (drillTab === "batch") {
         setSelectedBatchId(void 0);
       } else if (selectedRecordId) {
+        setIsReconcilingRecordSelection(true);
         setSelectedRecordId(null);
         setDraftKind(null);
       }
-      refetchAll();
+      await refetchAll();
+      setIsReconcilingRecordSelection(false);
     }
   });
   useUnsavedGuard({
@@ -8426,17 +8364,93 @@ function RecordsAdminShellInner(props) {
     }),
     [i18n.itemsAllLabel, collectionItems.items.length, itemNoun]
   );
+  const isLifecycleRail = (isAllTab || isGlobalTab) && isCollection && !!groupBy;
+  const lifecycleBuckets = useMemo(() => {
+    if (!isLifecycleRail || !groupBy) return [];
+    const map = /* @__PURE__ */ new Map();
+    const order = [];
+    for (const item of collectionItems.items) {
+      const g = groupBy(item) ?? { key: "__other", label: "Other" };
+      let bucket = map.get(g.key);
+      if (!bucket) {
+        bucket = { key: g.key, label: g.label, icon: g.icon, tone: g.tone, items: [] };
+        map.set(g.key, bucket);
+        order.push(g.key);
+      }
+      bucket.items.push(item);
+    }
+    return order.sort().map((k) => map.get(k));
+  }, [isLifecycleRail, groupBy, collectionItems.items]);
+  const LIFECYCLE_PREFIX = "lifecycle:";
+  const lifecycleRows = useMemo(() => {
+    if (!isLifecycleRail) return [];
+    const rows = [
+      {
+        id: `${LIFECYCLE_PREFIX}__all`,
+        ref: "",
+        scope: parseRef(""),
+        data: null,
+        status: collectionItems.items.length ? "configured" : "empty",
+        label: i18n.itemsAllLabel,
+        subtitle: collectionItems.items.length ? `${collectionItems.items.length} ${itemNoun}${collectionItems.items.length === 1 ? "" : "s"}` : void 0
+      }
+    ];
+    for (const b of lifecycleBuckets) {
+      rows.push({
+        id: `${LIFECYCLE_PREFIX}${b.key}`,
+        ref: "",
+        scope: parseRef(""),
+        data: null,
+        status: b.items.length ? "configured" : "empty",
+        label: b.label,
+        subtitle: `${b.items.length} ${itemNoun}${b.items.length === 1 ? "" : "s"}`,
+        // Tone surfaces as a chip; we reuse `badges` for that.
+        badges: b.tone && b.tone !== "default" ? [{ label: b.tone, tone: b.tone === "success" ? "success" : b.tone === "warning" ? "warning" : b.tone === "danger" ? "danger" : "neutral" }] : void 0
+      });
+    }
+    return rows;
+  }, [isLifecycleRail, lifecycleBuckets, collectionItems.items.length, i18n.itemsAllLabel, itemNoun]);
+  const lifecycleSeededRef = useRef(false);
+  useEffect(() => {
+    if (!isLifecycleRail) {
+      lifecycleSeededRef.current = false;
+      return;
+    }
+    if (lifecycleSeededRef.current) return;
+    if (selectedLifecycleKey !== null) {
+      lifecycleSeededRef.current = true;
+      return;
+    }
+    if (!defaultGroupKey) return;
+    if (!lifecycleBuckets.some((b) => b.key === defaultGroupKey)) return;
+    setSelectedLifecycleKey(defaultGroupKey);
+    lifecycleSeededRef.current = true;
+  }, [isLifecycleRail, defaultGroupKey, lifecycleBuckets, selectedLifecycleKey, setSelectedLifecycleKey]);
+  const filteredCollectionItems = useMemo(() => {
+    if (!isLifecycleRail || !selectedLifecycleKey || !groupBy) return collectionItems.items;
+    return collectionItems.items.filter((it) => {
+      const g = groupBy(it) ?? { key: "__other" };
+      return g.key === selectedLifecycleKey;
+    });
+  }, [isLifecycleRail, selectedLifecycleKey, groupBy, collectionItems.items]);
   const leftItems = isProductTab ? productListItems : isRuleTab ? applyFacetBrowseFilter(
     isCollection ? collectionRuleRailItems : filteredRuleItems
-  ) : (isGlobalTab || isAllTab) && isCollection ? [collectionGlobalAllRow] : isRecordsTab ? applyFacetBrowseFilter(recordList.items) : [];
+  ) : isLifecycleRail ? lifecycleRows : (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;
+  const leftSelectedId = isProductTab ? void 0 : isLifecycleRail ? `${LIFECYCLE_PREFIX}${selectedLifecycleKey ?? "__all"}` : selectedRecordId && selectedRecordId !== DRAFT_ID3 ? selectedRecordId : void 0;
   const leftSelectedAnchorKey = isProductTab ? selectedProductId ? buildRef({ productId: selectedProductId }) : void 0 : void 0;
   const dirtyId = !editorCtx.isDirty ? void 0 : selectedRecordId && selectedRecordId !== DRAFT_ID3 ? selectedRecordId : void 0;
   const dirtyAnchorKey = !editorCtx.isDirty ? void 0 : isProductTab ? editingScope?.raw : void 0;
   const onLeftSelect = (item) => {
     void runWithGuard(() => {
+      if (isLifecycleRail && typeof item.id === "string" && item.id.startsWith(LIFECYCLE_PREFIX)) {
+        const key = item.id.slice(LIFECYCLE_PREFIX.length);
+        const next = key === "__all" ? null : key;
+        setSelectedLifecycleKey(next);
+        if (next && onGroupExpanded) onGroupExpanded(next);
+        return;
+      }
       if (isProductTab) {
         setSelectedProductId(item.scope.productId);
         setSelectedVariantId(void 0);
@@ -8794,7 +8808,7 @@ function RecordsAdminShellInner(props) {
                           // navigational anchor, not a real record — applying the
                           // host's groupBy bucketed it under "Other" (its
                           // data is null). Skip grouping for that single-row rail.
-                          (isGlobalTab || isAllTab) && isCollection ? void 0 : effectiveGroupBy
+                          (isGlobalTab || isAllTab) && isCollection || isLifecycleRail ? void 0 : effectiveGroupBy
                         ),
                         renderGroupActions: renderRuleGroupActions,
                         rowClipboard,
@@ -8883,7 +8897,7 @@ function RecordsAdminShellInner(props) {
                 ruleWizardStep === null && isCollection && editingScope && !selectedItemId && /* @__PURE__ */ jsx(
                   ItemListView,
                   {
-                    items: collectionItems.items,
+                    items: filteredCollectionItems,
                     isLoading: collectionItems.isLoading,
                     error: collectionItems.error,
                     ctx: itemViewCtx,