@proveanything/smartlinks-utils-ui 0.11.10 → 0.12.1

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

@@ -67,7 +67,22 @@ interface RecordSummary<TData = unknown> {
     ref: string;
     scope: ParsedRef;
     data: TData | null;
+    /**
+     * Data-completeness status (NOT lifecycle). One of `'configured' |
+     * 'partial' | 'empty'`. Driven by `classify` and used by the rail's
+     * status-pill filter and default subtitle. For lifecycle (active /
+     * archived / draft), see {@link RecordSummary.lifecycleStatus}.
+     */
     status: RecordStatus;
+    /**
+     * Raw lifecycle status string from the SDK (`AppRecord.status`).
+     * Free-form by SDK contract; the shell treats values in
+     * `RecordsAdminShellProps.activeStatuses` (default `['active']`) plus
+     * `null` / `undefined` as "active". Anything else is history (archived,
+     * draft, etc.) and gets collapsed behind the rail's history disclosure.
+     * Distinct from {@link RecordSummary.status} which is data-completeness.
+     */
+    lifecycleStatus?: string;
     /** Display label for the list row. */
     label: string;
     /** Optional subtitle (e.g. SKU, GTIN). */
@@ -318,6 +333,14 @@ type TelemetryEvent = {
     recordType?: string;
     key: string;
     ref: string;
+}
+/** Lifecycle status flipped from the footer / header status menu. */
+ | {
+    type: 'lifecycle.change';
+    recordType?: string;
+    ref: string;
+    from: string | undefined;
+    to: string;
 };
 
 interface RecordsAdminI18n {
@@ -479,6 +502,33 @@ interface RecordsAdminI18n {
     hookAfterSaveFailed: string;
     hookBeforeDeleteFailed: string;
     hookAfterDeleteFailed: string;
+    /**
+     * History disclosure (per-slot collapsed footer for non-active records).
+     * `{n}` is replaced with the count.
+     */
+    historyDisclosureShow: string;
+    historyDisclosureHide: string;
+    /** Lifecycle controls (editor header dropdown + row menu). */
+    lifecycleStatusLabel: string;
+    lifecycleStatusActive: string;
+    lifecycleStatusArchived: string;
+    lifecycleStatusDraft: string;
+    /** Tooltip on the editor's status control. */
+    lifecycleStatusHint: string;
+    actionArchive: string;
+    actionRestore: string;
+    /** Footer / header status menu. */
+    lifecycleMenuLabel: string;
+    lifecycleChangeTo: string;
+    lifecycleCurrentBadge: string;
+    /** Singleton-slot conflict banner. */
+    conflictBannerTitle: string;
+    conflictBannerBodyOne: string;
+    conflictBannerBodyMany: string;
+    conflictArchiveDuplicates: string;
+    conflictDeleteDuplicates: string;
+    conflictDeleteConfirm: string;
+    conflictResolveLabel: string;
 }
 declare const DEFAULT_I18N: RecordsAdminI18n;
 
@@ -934,6 +984,36 @@ interface RecordsAdminShellProps<TData = unknown> {
     i18n?: Partial<RecordsAdminI18n>;
     onTelemetry?: (event: TelemetryEvent) => void;
     className?: string;
+    /**
+     * Lifecycle values treated as "active" by the rail and the singleton
+     * conflict detector. Defaults to `['active']`. Records with a missing
+     * `status` are always treated as active for back-compat. Set this only
+     * if your data uses a different vocabulary (e.g. `['active', 'live']`).
+     *
+     * @deprecated Prefer `lifecycle.statuses` (mark each def with `isActive`).
+     *   This prop continues to work as a back-compat shortcut and is merged
+     *   into the resolved active set.
+     */
+    activeStatuses?: readonly string[];
+    /**
+     * Lifecycle config — controls how the shell treats record status as a
+     * primary surface. See {@link LifecycleConfig}. When omitted the
+     * built-in trio (Draft / Active / Archived) is used and a single-button
+     * status menu is rendered in the editor footer next to Delete.
+     */
+    lifecycle?: LifecycleConfig;
+    /**
+     * Singleton-slot conflict resolution actions. The shell always *detects*
+     * duplicates (multiple active records sharing the same slot) and surfaces
+     * the banner; this prop only controls which bulk-resolution buttons the
+     * banner offers.
+     *
+     * Defaults: both `archiveDuplicates` and `deleteDuplicates` are enabled.
+     * Set either to `false` to hide that button. If both are disabled the
+     * banner falls back to detection-only with the legacy "Resolve" CTA that
+     * jumps to the first duplicate.
+     */
+    conflicts?: ConflictsConfig;
 }
 interface HeaderStatsConfig {
     /** Show a counts strip in the header. */
@@ -1173,6 +1253,96 @@ interface ActionsConfig {
     /** Optional icon component rendered before each action label. */
     icons?: Partial<Record<RecordsAdminActionKey, RecordsAdminActionIcon>>;
 }
+/**
+ * Bulk-resolution affordances offered in the singleton conflict banner.
+ * Detection is always on; this only gates the action buttons.
+ */
+interface ConflictsConfig {
+    /** Show the "Archive duplicates" button. Default `true`. */
+    archiveDuplicates?: boolean;
+    /** Show the "Delete duplicates" button. Default `true`. */
+    deleteDuplicates?: boolean;
+    /** Lifecycle status string written when archiving. Default `'archived'`. */
+    archivedStatus?: string;
+}
+/**
+ * One row in the host-configurable lifecycle vocabulary. The shell uses
+ * these to populate the footer status menu, drive the rail's auto-grouping
+ * tones, and decide which records are considered "active" by the resolver
+ * and the singleton conflict detector.
+ *
+ * Built-in defaults live in `data/lifecycleStatuses.ts` —
+ * `[draft (warning), active (success, isActive), archived (muted)]`.
+ */
+interface LifecycleStatusDef {
+    /** The literal status string written to `AppRecord.status`. */
+    value: string;
+    /** Visible label in menus / group headers. */
+    label: string;
+    /** Semantic tone — drives the dot colour and the rail bucket tone. */
+    tone: 'success' | 'warning' | 'muted' | 'danger' | 'default';
+    /**
+     * Mark this status as part of the "live" set. Active records are the
+     * ones the resolver / public consumer sees and the only ones flagged in
+     * singleton-slot conflict detection. Default `false`.
+     */
+    isActive?: boolean;
+    /** Optional Lucide-style icon rendered before the label. */
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+}
+/**
+ * Context passed to `lifecycle.beforeChange`. Return `false` to veto the
+ * status flip (the menu re-opens with the change rejected; nothing is
+ * written to the SDK). Throwing has the same effect.
+ */
+interface LifecycleChangeCtx {
+    recordId: string;
+    from: string | undefined;
+    to: string;
+    scope: ParsedRef;
+}
+/**
+ * Lifecycle configuration. All fields optional — omit the prop entirely
+ * to get the built-in trio + footer menu + conditional auto-grouping.
+ */
+interface LifecycleConfig {
+    /**
+     * Replace or extend the built-in vocabulary. The first `isActive: true`
+     * status is treated as the canonical "live" value. Hosts typically
+     * spread `DEFAULT_LIFECYCLE_STATUSES` here when adding extra values
+     * (e.g. `'scheduled'`, `'under-review'`).
+     */
+    statuses?: readonly LifecycleStatusDef[];
+    /**
+     * Status assigned to brand-new records on first save. Default
+     * `'active'`. Apps that publish in two steps (CMS, FAQ, votes, etc.)
+     * typically set this to `'draft'`.
+     */
+    defaultStatus?: string;
+    /**
+     * Where the status switcher appears.
+     * - `'footer'` *(default)* — single button next to Delete in the footer.
+     * - `'header'` — legacy header dropdown (compact, less discoverable).
+     * - `'both'` — render in both places.
+     * - `'off'` — host opts out entirely (e.g. status managed elsewhere).
+     */
+    surface?: 'footer' | 'header' | 'both' | 'off';
+    /**
+     * Whether the rail automatically groups records by lifecycle bucket
+     * when the data contains non-active statuses AND the host hasn't
+     * supplied its own `rail.groupBy`. Default `true`. Setting to `false`
+     * keeps the flat list regardless of mixed data.
+     */
+    autoGroup?: boolean;
+    /**
+     * Veto hook fired before every status flip. Return `false` (or throw)
+     * to abort. Use this for app-side validation — e.g. "can't publish
+     * without a question text", "can't archive while a vote is running".
+     */
+    beforeChange?: (ctx: LifecycleChangeCtx) => boolean | Promise<boolean>;
+}
 /**
  * Controls the small tab strip that appears above the editor body inside the
  * product drill-down.
@@ -1219,7 +1389,7 @@ interface RecordBrowserProps {
 }
 declare const RecordBrowser: ({ scopes, activeScope, onActiveScopeChange, selectedId, onSelectRef, items, counts, isLoading, error, filter, onFilterChange, search, onSearchChange, hasNextPage, isFetchingNextPage, onLoadMore, scopesLoading, i18n, }: RecordBrowserProps) => react_jsx_runtime.JSX.Element;
 
-interface Props$h {
+interface Props$i {
     scopes: ScopeKind[];
     active: ScopeKind;
     onChange: (s: ScopeKind) => void;
@@ -1237,20 +1407,20 @@ interface Props$h {
     /** Override icons used per scope. Falls back to DEFAULT_ICONS.scope. */
     icons?: RecordsAdminIcons['scope'];
 }
-declare const ScopeTabs: ({ scopes, active, onChange, loading, counts, tooltips, icons, }: Props$h) => react_jsx_runtime.JSX.Element;
+declare const ScopeTabs: ({ scopes, active, onChange, loading, counts, tooltips, icons, }: Props$i) => react_jsx_runtime.JSX.Element;
 
-interface Props$g {
+interface Props$h {
     source?: RecordSource;
     status?: RecordStatus;
     className?: string;
 }
 /** Emerald = own data, amber = inherited, muted = empty */
-declare const StatusDot: ({ source, status, className }: Props$g) => react_jsx_runtime.JSX.Element;
+declare const StatusDot: ({ source, status, className }: Props$h) => react_jsx_runtime.JSX.Element;
 
 type StatusTone = 'own' | 'shared' | 'missing';
 /** Semantic tones used by host-driven iconography (e.g. lifecycle buckets). */
 type SemanticTone = 'success' | 'warning' | 'danger' | 'muted' | 'info' | 'default';
-interface Props$f {
+interface Props$g {
     source?: RecordSource;
     status?: RecordStatus;
     className?: string;
@@ -1272,11 +1442,11 @@ interface Props$f {
      */
     semanticTone?: SemanticTone;
 }
-declare const StatusIcon: ({ source, status, className, size, label, iconHint, semanticTone, }: Props$f) => react_jsx_runtime.JSX.Element;
+declare const StatusIcon: ({ source, status, className, size, label, iconHint, semanticTone, }: Props$g) => react_jsx_runtime.JSX.Element;
 /** Short label rendered next to / under the row title. */
 declare const statusToneLabel: (tone: StatusTone) => string;
 
-interface Props$e {
+interface Props$f {
     value: 'all' | RecordStatus;
     onChange: (v: 'all' | RecordStatus) => void;
     counts: {
@@ -1291,9 +1461,9 @@ interface Props$e {
      *  active filter is always rendered so users never lose context. */
     hideZero?: Array<'all' | RecordStatus>;
 }
-declare const StatusFilterPills: ({ value, onChange, counts, i18n, hideZero }: Props$e) => react_jsx_runtime.JSX.Element;
+declare const StatusFilterPills: ({ value, onChange, counts, i18n, hideZero }: Props$f) => react_jsx_runtime.JSX.Element;
 
-interface Props$d {
+interface Props$e {
     items: RecordSummary[];
     /**
      * UUID of the currently-selected row. Matches `RecordSummary.id`. Records
@@ -1364,12 +1534,20 @@ interface Props$d {
     rowActions?: (record: RecordSummary) => RecordAction[] | null | undefined;
     /** Resolved i18n strings — used by default row/card renderers. */
     i18n?: RecordsAdminI18n;
+    /**
+     * Optional map of non-active records keyed by `slotKey`. When provided,
+     * each rendered active row that has a matching bucket gets a disclosure
+     * footer (`Show N archived`) appended. Expanded buckets render the
+     * history records inline beneath the active row, dimmed and badged with
+     * their lifecycle status. Pass `undefined` (default) to opt out.
+     */
+    historyBySlot?: ReadonlyMap<string, readonly RecordSummary[]>;
 }
-declare const RecordList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$d) => react_jsx_runtime.JSX.Element;
-declare const ProductList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$d) => react_jsx_runtime.JSX.Element;
-declare const FacetList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$d) => react_jsx_runtime.JSX.Element;
-declare const VariantList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$d) => react_jsx_runtime.JSX.Element;
-declare const BatchList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$d) => react_jsx_runtime.JSX.Element;
+declare const RecordList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, historyBySlot, }: Props$e) => react_jsx_runtime.JSX.Element;
+declare const ProductList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, historyBySlot, }: Props$e) => react_jsx_runtime.JSX.Element;
+declare const FacetList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, historyBySlot, }: Props$e) => react_jsx_runtime.JSX.Element;
+declare const VariantList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, historyBySlot, }: Props$e) => react_jsx_runtime.JSX.Element;
+declare const BatchList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, historyBySlot, }: Props$e) => react_jsx_runtime.JSX.Element;
 
 interface DefaultRecordRowProps {
     record: RecordSummary;
@@ -1411,7 +1589,7 @@ declare const ErrorState: ({ error }: {
     error: Error;
 }) => react_jsx_runtime.JSX.Element;
 
-interface Props$c {
+interface Props$d {
     i18n: RecordsAdminI18n;
     onApplyToMany?: () => void;
     onCopyFrom?: () => void;
@@ -1419,9 +1597,9 @@ interface Props$c {
     onImportCsv?: () => void;
     onExportCsv?: () => void;
 }
-declare const BulkActionsMenu: ({ i18n, onApplyToMany, onCopyFrom, onClearMany, onImportCsv, onExportCsv, }: Props$c) => react_jsx_runtime.JSX.Element | null;
+declare const BulkActionsMenu: ({ i18n, onApplyToMany, onCopyFrom, onClearMany, onImportCsv, onExportCsv, }: Props$d) => react_jsx_runtime.JSX.Element | null;
 
-interface Props$b<T> {
+interface Props$c<T> {
     ctx: EditorContext<T>;
     i18n: RecordsAdminI18n;
     children: ReactNode;
@@ -1440,6 +1618,21 @@ interface Props$b<T> {
      * the editor header without scrolling to the Targeting section.
      */
     targetingControl?: ReactNode;
+    /**
+     * Optional small control rendered in the header's right cluster for
+     * lifecycle status (Active / Archived / Draft). The shell wires this
+     * for records that already exist on the server (no point until first
+     * save). Independent of dirty draft state — flipping status saves
+     * immediately via `records.update`.
+     */
+    lifecycleControl?: ReactNode;
+    /**
+     * Optional lifecycle status switcher rendered in the footer's left
+     * cluster, between Delete and the clipboard buttons. This is the
+     * primary surface for status (`LifecycleStatusMenu`); the header
+     * `lifecycleControl` slot is the legacy / opt-in alternative.
+     */
+    lifecycleControlFooter?: ReactNode;
     bulkActions?: React.ComponentProps<typeof BulkActionsMenu>;
     /** Extra slot rendered in the footer between the danger actions and Save. */
     footerExtra?: ReactNode;
@@ -1468,6 +1661,13 @@ interface Props$b<T> {
      * without it competing with the friendly name as a subtitle.
      */
     headerMeta?: string;
+    /**
+     * Optional inline notice rendered at the top of the editor body, above
+     * `targeting`. Used by the shell to surface singleton-slot conflict
+     * warnings ("This is 1 of 4 records sharing this slot…") so the admin
+     * sees the problem while editing the record.
+     */
+    headerNotice?: ReactNode;
     /**
      * Clipboard footer actions. The shell wires these when `enableClipboard`
      * is on. Copy is always offered when there's an editing scope; Paste is
@@ -1495,7 +1695,7 @@ interface Props$b<T> {
     /** Host-provided icons rendered before save / discard / delete labels. */
     actionIcons?: Partial<Record<RecordsAdminActionKey, RecordsAdminActionIcon>>;
 }
-declare function RecordEditor<T>({ ctx, i18n, children, preview, targeting, targetingControl, bulkActions, footerExtra, onBeforeDelete, headerLabel, headerSubtitle, headerMeta, headerLeading, clipboard, actionLabels, actionIcons, }: Props$b<T>): react_jsx_runtime.JSX.Element;
+declare function RecordEditor<T>({ ctx, i18n, children, preview, targeting, targetingControl, lifecycleControl, lifecycleControlFooter, bulkActions, footerExtra, onBeforeDelete, headerLabel, headerSubtitle, headerMeta, headerLeading, headerNotice, clipboard, actionLabels, actionIcons, }: Props$c<T>): react_jsx_runtime.JSX.Element;
 
 interface InheritanceCtx {
     parentValue?: Record<string, unknown> | null;
@@ -1513,10 +1713,10 @@ interface MarkerProps {
 }
 declare const InheritanceMarker: ({ field, inheritedValue, value, children }: MarkerProps) => react_jsx_runtime.JSX.Element;
 
-interface Props$a {
+interface Props$b {
     children: ReactNode;
 }
-declare const ResolvedPreview: ({ children }: Props$a) => react_jsx_runtime.JSX.Element;
+declare const ResolvedPreview: ({ children }: Props$b) => react_jsx_runtime.JSX.Element;
 
 interface ProductChildItem {
     /** Variant or batch id (the `<id>` part of `variant:<id>` / `batch:<id>`). */
@@ -1547,7 +1747,7 @@ declare const useProductChildren: (args: UseProductChildrenArgs) => {
 };
 
 type DrillTab = 'product' | 'variant' | 'batch';
-interface Props$9 {
+interface Props$a {
     productLabel: string;
     /** Which child types are available on the collection. */
     showVariants: boolean;
@@ -1572,7 +1772,7 @@ interface Props$9 {
      */
     hideSingleTab?: boolean;
 }
-declare const ProductDrillDown: ({ productLabel, showVariants, showBatches, active, onChange, selectedChildId, onSelectChild, variants, batches, variantsLoading, batchesLoading, children, hideSingleTab, }: Props$9) => react_jsx_runtime.JSX.Element;
+declare const ProductDrillDown: ({ productLabel, showVariants, showBatches, active, onChange, selectedChildId, onSelectChild, variants, batches, variantsLoading, batchesLoading, children, hideSingleTab, }: Props$a) => react_jsx_runtime.JSX.Element;
 
 type PreviewMode = 'inline' | 'side' | 'tab' | 'drawer';
 interface CommonProps {
@@ -1640,7 +1840,7 @@ interface PreviewScopePickerProps {
 }
 declare const PreviewScopePicker: ({ SL, collectionId, editingScope, value, onChange, showVariants, showBatches, activeScope, i18n, }: PreviewScopePickerProps) => react_jsx_runtime.JSX.Element | null;
 
-interface Props$8 {
+interface Props$9 {
     /** Element whose right edge the pill should anchor to. */
     anchorRef: React.RefObject<HTMLElement>;
     onClick: () => void;
@@ -1648,14 +1848,14 @@ interface Props$8 {
     title: string;
     children: ReactNode;
 }
-declare function PreviewReopenPill({ anchorRef, onClick, ariaLabel, title, children }: Props$8): React$1.ReactPortal | null;
+declare function PreviewReopenPill({ anchorRef, onClick, ariaLabel, title, children }: Props$9): React$1.ReactPortal | null;
 
 declare const ScopeBreadcrumb: ({ scope }: {
     scope: ParsedRef;
 }) => react_jsx_runtime.JSX.Element | null;
 
 type IntroTone = 'info' | 'success' | 'warning';
-interface Props$7 {
+interface Props$8 {
     title: string;
     body: ReactNode;
     onDismiss: () => void;
@@ -1664,16 +1864,16 @@ interface Props$7 {
     /** Optional "Learn more" link or button rendered inline after the body. */
     action?: ReactNode;
 }
-declare const IntroCard: ({ title, body, onDismiss, tone, action }: Props$7) => react_jsx_runtime.JSX.Element;
+declare const IntroCard: ({ title, body, onDismiss, tone, action }: Props$8) => react_jsx_runtime.JSX.Element;
 
-interface Props$6 {
+interface Props$7 {
     label: string;
     /** Optional override for the button label. When set, takes precedence over `label`. */
     customLabel?: string;
     introHidden: boolean;
     onShowIntro?: () => void;
 }
-declare const UtilityRow: ({ label, customLabel, introHidden, onShowIntro }: Props$6) => react_jsx_runtime.JSX.Element | null;
+declare const UtilityRow: ({ label, customLabel, introHidden, onShowIntro }: Props$7) => react_jsx_runtime.JSX.Element | null;
 
 /** Flat anchor shape — matches `UpsertRecordInput` / `BulkUpsertItem`. */
 interface RecordAnchors {
@@ -1831,10 +2031,20 @@ interface UseRecordListArgs {
     };
     /** Page size requested from the SDK (default 100). */
     pageSize?: number;
+    /**
+     * Lifecycle values treated as "active". Defaults to `['active']`. Records
+     * with a missing/empty `status` are always treated as active (legacy
+     * back-compat). Hosts override this if their vocabulary differs (e.g.
+     * `['active', 'live']`).
+     */
+    activeStatuses?: readonly string[];
 }
 declare const useRecordList: (args: UseRecordListArgs) => {
     allItems: RecordSummary<unknown>[];
     items: RecordSummary<unknown>[];
+    activeItems: RecordSummary<unknown>[];
+    historyItems: RecordSummary<unknown>[];
+    historyBySlot: Map<string, RecordSummary<unknown>[]>;
     total: number;
     counts: {
         all: number;
@@ -2504,7 +2714,7 @@ declare function useItemViewPref(args: {
     defaultValue: ItemView;
 }): [ItemView, (next: ItemView) => void];
 
-interface Props$5<T> {
+interface Props$6<T> {
     items: RecordSummary<T>[];
     isLoading: boolean;
     error: Error | null;
@@ -2555,22 +2765,22 @@ interface Props$5<T> {
     onLoadMore?: () => void;
     i18n: RecordsAdminI18n;
 }
-declare function ItemListView<T>({ items, isLoading, error, ctx, itemNoun, ruleSummary, view, views, onViewChange, renderItemList, renderItemCard, renderItemEmpty, itemColumns, cardSize, rowActions, rowClipboard, searchableFields, searchable, total, hasNextPage, isFetchingNextPage, onLoadMore, i18n, }: Props$5<T>): react_jsx_runtime.JSX.Element;
+declare function ItemListView<T>({ items, isLoading, error, ctx, itemNoun, ruleSummary, view, views, onViewChange, renderItemList, renderItemCard, renderItemEmpty, itemColumns, cardSize, rowActions, rowClipboard, searchableFields, searchable, total, hasNextPage, isFetchingNextPage, onLoadMore, i18n, }: Props$6<T>): react_jsx_runtime.JSX.Element;
 
-interface Props$4 {
+interface Props$5 {
     options: ItemView[];
     value: ItemView;
     onChange: (next: ItemView) => void;
     i18n: Pick<RecordsAdminI18n, 'itemViewTable' | 'itemViewCards' | 'itemViewGallery'>;
 }
-declare const ItemViewSwitcher: ({ options, value, onChange, i18n }: Props$4) => react_jsx_runtime.JSX.Element | null;
+declare const ItemViewSwitcher: ({ options, value, onChange, i18n }: Props$5) => react_jsx_runtime.JSX.Element | null;
 
 type SortDir = 'asc' | 'desc' | null;
 interface SortState {
     key: string | null;
     dir: SortDir;
 }
-interface Props$3<T> {
+interface Props$4<T> {
     items: RecordSummary<T>[];
     columns?: ItemColumn<T>[];
     selectedId?: string;
@@ -2592,9 +2802,9 @@ interface Props$3<T> {
     } | null;
     i18n: Pick<RecordsAdminI18n, 'itemColumnLabel' | 'itemColumnUpdated' | 'itemActions' | 'delete'>;
 }
-declare function DefaultItemTable<T>({ items, columns, selectedId, onOpen, onDelete, sort, onToggleSort, rowActions, rowClipboard, i18n, }: Props$3<T>): react_jsx_runtime.JSX.Element;
+declare function DefaultItemTable<T>({ items, columns, selectedId, onOpen, onDelete, sort, onToggleSort, rowActions, rowClipboard, i18n, }: Props$4<T>): react_jsx_runtime.JSX.Element;
 
-interface Props$2<T> {
+interface Props$3<T> {
     items: RecordSummary<T>[];
     variant: 'cards' | 'gallery';
     selectedId?: string;
@@ -2611,9 +2821,9 @@ interface Props$2<T> {
     } | null;
     i18n: Pick<RecordsAdminI18n, 'delete'>;
 }
-declare function DefaultItemCards<T>({ items, variant, selectedId, ctx, renderCard, cardSize, rowActions, rowClipboard, i18n, }: Props$2<T>): react_jsx_runtime.JSX.Element;
+declare function DefaultItemCards<T>({ items, variant, selectedId, ctx, renderCard, cardSize, rowActions, rowClipboard, i18n, }: Props$3<T>): react_jsx_runtime.JSX.Element;
 
-interface Props$1 {
+interface Props$2 {
     /** Friendly name of the item being edited (mostly for screen readers). */
     label?: string;
     /** 1-based position within the current sibling list. */
@@ -2633,9 +2843,9 @@ interface Props$1 {
      */
     embedded?: boolean;
 }
-declare const EditorItemNav: ({ label, position, total, onBack, onPrev, onNext, canPrev, canNext, i18n, embedded, }: Props$1) => react_jsx_runtime.JSX.Element;
+declare const EditorItemNav: ({ label, position, total, onBack, onPrev, onNext, canPrev, canNext, i18n, embedded, }: Props$2) => react_jsx_runtime.JSX.Element;
 
-interface Props<T> {
+interface Props$1<T> {
     items: RecordSummary<T>[];
     selectedItemId?: string;
     isLoading: boolean;
@@ -2677,7 +2887,7 @@ interface Props<T> {
     onLoadMore?: () => void;
     i18n: Pick<RecordsAdminI18n, 'backToScopes' | 'siblingsHeading' | 'noItemsTitle' | 'noItemsBody' | 'backToList' | 'newItem'>;
 }
-declare function SiblingRail<T>({ items, selectedItemId, isLoading, error, onBack, onSelect, contextKind, contextSummary, onCreate, itemNoun, dirtyKeys, errorKeys, i18n, total, hasNextPage, isFetchingNextPage, onLoadMore, }: Props<T>): react_jsx_runtime.JSX.Element;
+declare function SiblingRail<T>({ items, selectedItemId, isLoading, error, onBack, onSelect, contextKind, contextSummary, onCreate, itemNoun, dirtyKeys, errorKeys, i18n, total, hasNextPage, isFetchingNextPage, onLoadMore, }: Props$1<T>): react_jsx_runtime.JSX.Element;
 
 interface ClipboardEntry<T = unknown> {
     value: T;
@@ -2750,6 +2960,65 @@ interface DeleteButtonProps {
 }
 declare const DeleteButton: ({ onConfirm, onBeforeDelete, label, confirmLabel, revertMs, disabled, icon, }: DeleteButtonProps) => react_jsx_runtime.JSX.Element;
 
+interface Props {
+    SL: SmartLinksSDK;
+    collectionId: string;
+    appId: string;
+    recordId: string;
+    scope: ParsedRef;
+    /** Current lifecycle value on the record (may be undefined for legacy data). */
+    current: string | undefined;
+    /** Available statuses (defaults are passed by the shell). */
+    statuses: readonly LifecycleStatusDef[];
+    i18n: RecordsAdminI18n;
+    /** Optional veto hook — return false / throw to abort the change. */
+    beforeChange?: (ctx: LifecycleChangeCtx) => boolean | Promise<boolean>;
+    /** Fires after a successful flip with the new value. */
+    onChanged?: (next: string) => void;
+    /** Telemetry hook — receives `{ from, to }`. */
+    onTelemetry?: (event: {
+        from: string | undefined;
+        to: string;
+    }) => void;
+    /**
+     * Visual size — `'sm'` matches the editor footer button height; `'xs'`
+     * matches the legacy header pill. Defaults to `'sm'`.
+     */
+    size?: 'sm' | 'xs';
+}
+declare const LifecycleStatusMenu: ({ SL, collectionId, appId, recordId, scope, current, statuses, i18n, beforeChange, onChanged, onTelemetry, size, }: Props) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Canonical built-in trio. `active` is the only status flagged
+ * `isActive: true` — drafts and archived records are excluded from the
+ * "live" set used by the rail and the singleton conflict detector.
+ *
+ * Hosts can extend this set (e.g. add `'scheduled'`) by passing a custom
+ * `lifecycle.statuses` array — typically `[...DEFAULT_LIFECYCLE_STATUSES, …]`.
+ */
+declare const DEFAULT_LIFECYCLE_STATUSES: readonly LifecycleStatusDef[];
+/** Resolve the host-configured status list, falling back to the trio. */
+declare const getLifecycleStatuses: (config?: LifecycleConfig) => readonly LifecycleStatusDef[];
+/**
+ * Lifecycle values treated as "live" by the rail and the resolver.
+ * Records with a missing/empty `status` are ALWAYS treated as active for
+ * back-compat with legacy data — that rule lives in `singletonConflicts.isActive`
+ * and is preserved by callers; this helper only enumerates the explicit set.
+ *
+ * Back-compat: when the host passes the legacy `activeStatuses` prop, the
+ * shell merges it on top so old call sites keep working.
+ */
+declare const getActiveStatusValues: (config?: LifecycleConfig, legacyActiveStatuses?: readonly string[]) => readonly string[];
+/**
+ * Look up the def that matches a record's current `lifecycleStatus`.
+ * Falls back to the `'active'` def when the record has no status set
+ * (legacy back-compat — missing status counts as active).
+ */
+declare const resolveLifecycleStatus: (record: Pick<RecordSummary, "lifecycleStatus">, config?: LifecycleConfig) => LifecycleStatusDef;
+/** True when at least one record uses a non-active lifecycle status. */
+declare const hasMixedLifecycle: (records: readonly RecordSummary[], activeValues: readonly string[]) => boolean;
+declare const compareLifecycleBuckets: (a: string, b: string) => number;
+
 declare const parseRef: (raw: string) => ParsedRef;
 interface BuildRefArgs {
     collectionId?: string;
@@ -2834,4 +3103,4 @@ declare const exportCsv: <T>(records: RecordSummary<T>[], schema: CsvSchema<T>)
 declare const importCsv: <T>(file: File, schema: CsvSchema<T>, ctx: RecordsCtx) => Promise<ImportReport>;
 declare const downloadBlob: (blob: Blob, filename: string) => void;
 
-export { ALL_ITEM_VIEWS, ALL_PRESENTATIONS, BatchList, BulkActionsMenu, type ClipboardEntry, type CollectedRecord, type CollectedSort, type CollectionRailMode, type CsvSchema, type CsvSchemaColumn, DEFAULT_DEEP_LINK_PARAM_NAMES, DEFAULT_I18N, DEFAULT_ICONS, type DeepLinkAdapter, type DeepLinkChangeKind, type DeepLinkHistoryMode, type DeepLinkOptions, type DeepLinkParamNames, type DeepLinkState, DefaultItemCards, DefaultItemTable, DefaultRecordCard, DefaultRecordRow, DeleteButton, type DirtyDraft, DirtyDraftProvider, type DirtyDraftStatus, type DirtyDraftStore, type DirtyStrategy, DrawerPreview, type EditorContext, EditorItemNav, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, type ItemColumn, ItemListView, type ItemSlotContext, type ItemView, type ItemViewContext, ItemViewSwitcher, LoadingState, type MergeStrategy, type MergedRecord, type NavConfirmI18n, type NormalisedRule, type ParsedRef, type PasteCompatibility, type PasteCompatibilityResult, PresentationSwitcher, type PreviewMode, PreviewReopenPill, PreviewScopePicker, PreviewToggleButton, type ProductBrowseItem, type ProductChildItem, ProductDrillDown, ProductList, type RecordAction, type RecordBadge, RecordBrowser, type RecordCardinality, RecordEditor, RecordList, type RecordPresentation, type RecordSlotContext, type RecordSource, type RecordStatus, type RecordSummary, type RecordsAdminActionIcon, type RecordsAdminActionKey, type RecordsAdminI18n, type RecordsAdminIcons, RecordsAdminShell, type RecordsAdminShellProps, type ResolvedDeepLinkParamNames, ResolvedPreview, type ResolvedRecord, type RouterParamsGetter, type RouterParamsSetter, ScopeBreadcrumb, type ScopeCounts, type ScopeKind, ScopeTabs, SiblingRail, SidePreview, type SmartLinksSDK, StatusDot, StatusFilterPills, StatusIcon, type StatusTone, TabbedPreview, type TelemetryEvent, type UseCollectionItemsArgs, type UseRecordClipboardArgs, type UseRecordClipboardReturn, type UseResolveAllRecordsArgs, type UseResolveAllResult, type UseRulePreviewArgs, type UseRulePreviewResult, type UseScopeCountsArgs, type UseScopeCountsResult, UtilityRow, VariantList, buildDraftKey, buildRef, bulkDelete, bulkUpsert, checkPasteCompatibility, cloneValue, createDefaultDeepLinkAdapter, createPostMessageDeepLinkAdapter, createRecord, createRouterDeepLinkAdapter, downloadBlob, exportCsv, getRecordById, importCsv, isInSmartLinksIframe, listRecords, matchRecords, mergeIcons, normaliseRule, parseRef, parsedRefToScope, parsedRefToTarget, pickHeaderIcon, removeRecord, resolutionChain, resolveRecord, restoreRecord, ruleHash, rulesEqual, scopeCountsQueryKey, scopesEqual, statusToneLabel, summariseRule, upsertRecord, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyDraft, useDirtyDraftActions, useDirtyDraftStore, useDirtyDrafts, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeCounts, useScopeProbe, useUnsavedGuard };
+export { ALL_ITEM_VIEWS, ALL_PRESENTATIONS, BatchList, BulkActionsMenu, type ClipboardEntry, type CollectedRecord, type CollectedSort, type CollectionRailMode, type ConflictsConfig, type CsvSchema, type CsvSchemaColumn, DEFAULT_DEEP_LINK_PARAM_NAMES, DEFAULT_I18N, DEFAULT_ICONS, DEFAULT_LIFECYCLE_STATUSES, type DeepLinkAdapter, type DeepLinkChangeKind, type DeepLinkHistoryMode, type DeepLinkOptions, type DeepLinkParamNames, type DeepLinkState, DefaultItemCards, DefaultItemTable, DefaultRecordCard, DefaultRecordRow, DeleteButton, type DirtyDraft, DirtyDraftProvider, type DirtyDraftStatus, type DirtyDraftStore, type DirtyStrategy, DrawerPreview, type EditorContext, EditorItemNav, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, type ItemColumn, ItemListView, type ItemSlotContext, type ItemView, type ItemViewContext, ItemViewSwitcher, type LifecycleChangeCtx, type LifecycleConfig, type LifecycleStatusDef, LifecycleStatusMenu, LoadingState, type MergeStrategy, type MergedRecord, type NavConfirmI18n, type NormalisedRule, type ParsedRef, type PasteCompatibility, type PasteCompatibilityResult, PresentationSwitcher, type PreviewMode, PreviewReopenPill, PreviewScopePicker, PreviewToggleButton, type ProductBrowseItem, type ProductChildItem, ProductDrillDown, ProductList, type RecordAction, type RecordBadge, RecordBrowser, type RecordCardinality, RecordEditor, RecordList, type RecordPresentation, type RecordSlotContext, type RecordSource, type RecordStatus, type RecordSummary, type RecordsAdminActionIcon, type RecordsAdminActionKey, type RecordsAdminI18n, type RecordsAdminIcons, RecordsAdminShell, type RecordsAdminShellProps, type ResolvedDeepLinkParamNames, ResolvedPreview, type ResolvedRecord, type RouterParamsGetter, type RouterParamsSetter, ScopeBreadcrumb, type ScopeCounts, type ScopeKind, ScopeTabs, SiblingRail, SidePreview, type SmartLinksSDK, StatusDot, StatusFilterPills, StatusIcon, type StatusTone, TabbedPreview, type TelemetryEvent, type UseCollectionItemsArgs, type UseRecordClipboardArgs, type UseRecordClipboardReturn, type UseResolveAllRecordsArgs, type UseResolveAllResult, type UseRulePreviewArgs, type UseRulePreviewResult, type UseScopeCountsArgs, type UseScopeCountsResult, UtilityRow, VariantList, buildDraftKey, buildRef, bulkDelete, bulkUpsert, checkPasteCompatibility, cloneValue, compareLifecycleBuckets, createDefaultDeepLinkAdapter, createPostMessageDeepLinkAdapter, createRecord, createRouterDeepLinkAdapter, downloadBlob, exportCsv, getActiveStatusValues, getLifecycleStatuses, getRecordById, hasMixedLifecycle, importCsv, isInSmartLinksIframe, listRecords, matchRecords, mergeIcons, normaliseRule, parseRef, parsedRefToScope, parsedRefToTarget, pickHeaderIcon, removeRecord, resolutionChain, resolveLifecycleStatus, resolveRecord, restoreRecord, ruleHash, rulesEqual, scopeCountsQueryKey, scopesEqual, statusToneLabel, summariseRule, upsertRecord, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyDraft, useDirtyDraftActions, useDirtyDraftStore, useDirtyDrafts, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeCounts, useScopeProbe, useUnsavedGuard };