@proveanything/smartlinks-utils-ui 0.11.0 → 0.11.1

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

@@ -1,4 +1,4 @@
-import React$1 from 'react';
+import React__default from 'react';
 
 /** FA7 icon families */
 type IconFamily = 'classic' | 'duotone' | 'brands';
@@ -38,6 +38,6 @@ interface IconPickerProps {
     className?: string;
 }
 
-declare const IconPicker: React$1.FC<IconPickerProps>;
+declare const IconPicker: React__default.FC<IconPickerProps>;
 
 export { type IconFamily as I, type IconStyle as a, IconPicker as b, type IconPickerProps as c, type IconSelection as d };

package/dist/{chunk-BNC6Z6WB.js → chunk-3RRHM4LP.js}

@@ -95,8 +95,8 @@ async function readShowHints(SL) {
   if (inflight) return inflight;
   inflight = (async () => {
     try {
-      const cfg = await SL?.userAppData?.getConfig?.(HINTS_PREFS_APP_ID);
-      const value = cfg?.[HINTS_PREFS_KEY];
+      const account = await SL?.auth?.getAccount?.();
+      const value = account?.prefs?.[HINTS_PREFS_KEY];
       const resolved = typeof value === "boolean" ? value : true;
       cachedShowHints = resolved;
       return resolved;
@@ -181,5 +181,5 @@ function useIntroState({ SL, persistKey }) {
 }
 
 export { AdminPageHeader, HINTS_PREFS_APP_ID, HINTS_PREFS_KEY, useHintsPreference, useIntroState };
-//# sourceMappingURL=chunk-BNC6Z6WB.js.map
-//# sourceMappingURL=chunk-BNC6Z6WB.js.map
+//# sourceMappingURL=chunk-3RRHM4LP.js.map
+//# sourceMappingURL=chunk-3RRHM4LP.js.map

package/dist/chunk-3RRHM4LP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/AdminPageHeader/AdminPageHeader.tsx","../src/hints/useHintsPreference.ts","../src/hints/useIntroState.ts"],"names":["useState","useEffect","useCallback"],"mappings":"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","file":"chunk-3RRHM4LP.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}","// =============================================================================\r\n// useHintsPreference\r\n//\r\n// Single source of truth for the user-level \"show inline hints?\" preference.\r\n// Reads from `SL.auth.getAccount().prefs` (the canonical account-level prefs\r\n// bag added in SmartLinks SDK 1.11.5+) so the same flag follows the user\r\n// across every SmartLinks admin app — flip it once, applies everywhere.\r\n// There is intentionally no per-app preference list; that's what\r\n// `useIntroState` (browser-level dismiss) is for.\r\n//\r\n// Writes still flow through `SL.userAppData('prefs')` because the SDK does\r\n// not yet expose a dedicated `auth.setPrefs(...)`. The server treats the\r\n// `prefs` userAppData document as the backing store for `account.prefs`,\r\n// so reads and writes stay in sync.\r\n//\r\n// Shape on `account.prefs`:\r\n//   { showHints?: boolean, ...other future flags }\r\n//\r\n// Default when unset / unauthenticated / SDK missing → `true` (show hints).\r\n// =============================================================================\r\nimport { useCallback, useEffect, useRef, useState } from 'react';\r\n\r\nexport const HINTS_PREFS_APP_ID = 'prefs';\r\nexport const HINTS_PREFS_KEY = 'showHints';\r\n\r\n/** Optional cross-tab cache so multiple components share one fetch per session. */\r\nlet cachedShowHints: boolean | undefined;\r\nlet inflight: Promise<boolean> | null = null;\r\n\r\nasync function readShowHints(SL: any): Promise<boolean> {\r\n  if (cachedShowHints !== undefined) return cachedShowHints;\r\n  if (inflight) return inflight;\r\n  inflight = (async () => {\r\n    try {\r\n      // Read from the authenticated account's prefs bag. `prefs` may be\r\n      // absent (server returned no document) — that's fine, we fall back\r\n      // to the default below.\r\n      const account = await SL?.auth?.getAccount?.();\r\n      const value = account?.prefs?.[HINTS_PREFS_KEY];\r\n      const resolved = typeof value === 'boolean' ? value : true;\r\n      cachedShowHints = resolved;\r\n      return resolved;\r\n    } catch {\r\n      cachedShowHints = true;\r\n      return true;\r\n    } finally {\r\n      inflight = null;\r\n    }\r\n  })();\r\n  return inflight;\r\n}\r\n\r\nasync function writeShowHints(SL: any, next: boolean): Promise<void> {\r\n  cachedShowHints = next;\r\n  try {\r\n    // No dedicated `auth.setPrefs` setter exists yet — write through\r\n    // userAppData('prefs'), which the server uses as the backing store\r\n    // for `account.prefs`.\r\n    const cfg = await SL?.userAppData?.getConfig?.(HINTS_PREFS_APP_ID).catch(() => ({}));\r\n    await SL?.userAppData?.setConfig?.(HINTS_PREFS_APP_ID, {\r\n      ...(cfg ?? {}),\r\n      [HINTS_PREFS_KEY]: next,\r\n    });\r\n  } catch { /* best-effort */ }\r\n}\r\n\r\nexport interface UseHintsPreferenceResult {\r\n  /** Whether inline hints / intro cards should be shown by default. */\r\n  showHints: boolean;\r\n  /** True until the first read from `userAppData` resolves. */\r\n  isLoading: boolean;\r\n  /** Persist a new value on the user record. */\r\n  setShowHints: (next: boolean) => Promise<void>;\r\n}\r\n\r\n/**\r\n * Subscribe to the user's global `showHints` preference. Optimistic; defaults\r\n * to `true` while loading so admins coming in fresh always see the help.\r\n */\r\nexport function useHintsPreference(SL: any): UseHintsPreferenceResult {\r\n  // NB: do NOT lazy-init from a module-level cache — Vite HMR reloads this\r\n  // module while React keeps the old hook queue, which trips\r\n  // \"Should have a queue. This is likely a bug in React.\". Always init to\r\n  // the same shape and rely on the effect below to hydrate.\r\n  const [showHints, setShowHintsState] = useState<boolean>(true);\r\n  const [isLoading, setIsLoading] = useState<boolean>(true);\r\n  const mounted = useRef(true);\r\n\r\n  useEffect(() => {\r\n    mounted.current = true;\r\n    if (cachedShowHints !== undefined) {\r\n      setShowHintsState(cachedShowHints);\r\n      setIsLoading(false);\r\n      return () => { mounted.current = false; };\r\n    }\r\n    readShowHints(SL).then((value) => {\r\n      if (!mounted.current) return;\r\n      setShowHintsState(value);\r\n      setIsLoading(false);\r\n    });\r\n    return () => { mounted.current = false; };\r\n  }, [SL]);\r\n\r\n  const setShowHints = useCallback(async (next: boolean) => {\r\n    setShowHintsState(next);\r\n    await writeShowHints(SL, next);\r\n  }, [SL]);\r\n\r\n  return { showHints, isLoading, setShowHints };\r\n}\r\n\r\n/** Test / sign-out helper — drop the in-memory cache. */\r\nexport function __resetHintsPreferenceCache() {\r\n  cachedShowHints = undefined;\r\n  inflight = null;\r\n}\r\n","// =============================================================================\r\n// useIntroState\r\n//\r\n// One hook that resolves the full intro-card state for an `<AdminPageHeader>`:\r\n//\r\n//   1. Global user preference (`prefs.showHints` on `userAppData`)\r\n//      → if `false`, the intro stays collapsed by default. The `?` reopen\r\n//        button is still rendered so the user can pop it open whenever.\r\n//   2. Per-browser, per-app temporary dismiss (`localStorage`)\r\n//      → flipped by the dismiss `X`, so reloads on this browser keep it\r\n//        collapsed until they click `?`.\r\n//\r\n// Apps just call:\r\n//   const intro = useIntroState({ SL, persistKey: appId });\r\n//   <AdminPageHeader intro={{ title, body, ...intro }} />\r\n// =============================================================================\r\nimport { useCallback, useEffect, useState } from 'react';\r\nimport { useHintsPreference } from './useHintsPreference';\r\n\r\nconst lsKey = (persistKey: string) => `sl:intro-dismissed:${persistKey}`;\r\n\r\nexport interface UseIntroStateArgs {\r\n  /** SmartLinks SDK namespace (`* as SL from '@proveanything/smartlinks'`). */\r\n  SL: any;\r\n  /**\r\n   * Stable per-app key used for the browser-level dismiss. Usually the\r\n   * app's `appId`. Pass a more specific value (e.g. `${appId}:rules`) if\r\n   * you have multiple intros within one app.\r\n   */\r\n  persistKey: string;\r\n}\r\n\r\nexport interface UseIntroStateResult {\r\n  /** Whether the intro card is currently dismissed/collapsed. */\r\n  dismissed: boolean;\r\n  /** Wire to AdminPageHeader's `intro.onDismiss`. */\r\n  onDismiss: () => void;\r\n  /** Wire to AdminPageHeader's `intro.onReopen`. Always available. */\r\n  onReopen: () => void;\r\n  /** True until the user preference has finished loading. */\r\n  isLoading: boolean;\r\n}\r\n\r\nfunction readBrowserDismissed(persistKey: string): boolean {\r\n  try { return localStorage.getItem(lsKey(persistKey)) === '1'; }\r\n  catch { return false; }\r\n}\r\n\r\n/** Resolve dismiss state from global pref + per-browser flag. */\r\nexport function useIntroState({ SL, persistKey }: UseIntroStateArgs): UseIntroStateResult {\r\n  const { showHints, isLoading } = useHintsPreference(SL);\r\n  const [browserDismissed, setBrowserDismissed] = useState<boolean>(() => readBrowserDismissed(persistKey));\r\n\r\n  // Re-read browser flag if the key changes (rare, but cheap).\r\n  useEffect(() => {\r\n    setBrowserDismissed(readBrowserDismissed(persistKey));\r\n  }, [persistKey]);\r\n\r\n  const onDismiss = useCallback(() => {\r\n    setBrowserDismissed(true);\r\n    try { localStorage.setItem(lsKey(persistKey), '1'); } catch { /* ignore */ }\r\n  }, [persistKey]);\r\n\r\n  const onReopen = useCallback(() => {\r\n    setBrowserDismissed(false);\r\n    try { localStorage.removeItem(lsKey(persistKey)); } catch { /* ignore */ }\r\n  }, [persistKey]);\r\n\r\n  // Dismissed when either: user opted out of hints globally, or they X'd it\r\n  // on this browser. Reopening always works (it just clears the browser flag\r\n  // for this session — global pref stays as-is).\r\n  const dismissed = !showHints || browserDismissed;\r\n\r\n  return { dismissed, onDismiss, onReopen, isLoading };\r\n}\r\n"]}

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

@@ -1,4 +1,4 @@
-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';
+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-DwUdZePm.js';
 import 'react';
 
 interface AppRegistryEntry {

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

@@ -1,7 +1,7 @@
-import React from 'react';
+import React__default from 'react';
 import { d as ConditionsEditorProps } from '../../types-a2DdgZ2H.js';
 export { C as Condition, a as ConditionGroup, b as ConditionType, c as ConditionTypeMeta, F as FacetOption, e as FacetValueOption, S as SelectOption, V as VersionOption } from '../../types-a2DdgZ2H.js';
 
-declare const ConditionsEditor: React.FC<ConditionsEditorProps>;
+declare const ConditionsEditor: React__default.FC<ConditionsEditorProps>;
 
 export { ConditionsEditor, ConditionsEditorProps };

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

@@ -1,4 +1,4 @@
-import React from 'react';
+import React__default from 'react';
 import { FacetRule } from '@proveanything/smartlinks/dist/types/appObjects';
 export { FacetRule, FacetRuleClause } from '@proveanything/smartlinks/dist/types/appObjects';
 import { F as FacetOption } from '../../types-a2DdgZ2H.js';
@@ -37,6 +37,6 @@ interface FacetRuleEditorProps {
     className?: string;
 }
 
-declare const FacetRuleEditor: React.FC<FacetRuleEditorProps>;
+declare const FacetRuleEditor: React__default.FC<FacetRuleEditorProps>;
 
 export { FacetOption, FacetRuleEditor, type FacetRuleEditorProps };

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

@@ -1,4 +1,4 @@
-import React$1 from 'react';
+import React__default from 'react';
 
 /** Where the font comes from */
 type FontSource = 'google' | 'custom';
@@ -121,7 +121,7 @@ interface FontPickerProps {
     admin?: boolean;
 }
 
-declare const FontPicker: React$1.FC<FontPickerProps>;
+declare const FontPicker: React__default.FC<FontPickerProps>;
 
 declare const GOOGLE_FONTS_CATALOG: FontEntry[];
 /** Get a Google Fonts CSS URL for a specific font */

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

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

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

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FacetRule, MatchedAt, AppRecord, RecordTarget, MatchResult, ResolveAllEntry } from '@proveanything/smartlinks/dist/types/appObjects';
+import * as React$1 from 'react';
 import { ReactNode, ComponentType } from 'react';
 import { LucideIcon } from 'lucide-react';
 import * as _tanstack_query_core from '@tanstack/query-core';
@@ -1203,7 +1204,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$g {
+interface Props$h {
     scopes: ScopeKind[];
     active: ScopeKind;
     onChange: (s: ScopeKind) => void;
@@ -1221,20 +1222,20 @@ interface Props$g {
     /** 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$g) => react_jsx_runtime.JSX.Element;
+declare const ScopeTabs: ({ scopes, active, onChange, loading, counts, tooltips, icons, }: Props$h) => react_jsx_runtime.JSX.Element;
 
-interface Props$f {
+interface Props$g {
     source?: RecordSource;
     status?: RecordStatus;
     className?: string;
 }
 /** Emerald = own data, amber = inherited, muted = empty */
-declare const StatusDot: ({ source, status, className }: Props$f) => react_jsx_runtime.JSX.Element;
+declare const StatusDot: ({ source, status, className }: Props$g) => 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$e {
+interface Props$f {
     source?: RecordSource;
     status?: RecordStatus;
     className?: string;
@@ -1256,11 +1257,11 @@ interface Props$e {
      */
     semanticTone?: SemanticTone;
 }
-declare const StatusIcon: ({ source, status, className, size, label, iconHint, semanticTone, }: Props$e) => react_jsx_runtime.JSX.Element;
+declare const StatusIcon: ({ source, status, className, size, label, iconHint, semanticTone, }: Props$f) => react_jsx_runtime.JSX.Element;
 /** Short label rendered next to / under the row title. */
 declare const statusToneLabel: (tone: StatusTone) => string;
 
-interface Props$d {
+interface Props$e {
     value: 'all' | RecordStatus;
     onChange: (v: 'all' | RecordStatus) => void;
     counts: {
@@ -1275,9 +1276,9 @@ interface Props$d {
      *  active filter is always rendered so users never lose context. */
     hideZero?: Array<'all' | RecordStatus>;
 }
-declare const StatusFilterPills: ({ value, onChange, counts, i18n, hideZero }: Props$d) => react_jsx_runtime.JSX.Element;
+declare const StatusFilterPills: ({ value, onChange, counts, i18n, hideZero }: Props$e) => react_jsx_runtime.JSX.Element;
 
-interface Props$c {
+interface Props$d {
     items: RecordSummary[];
     /**
      * UUID of the currently-selected row. Matches `RecordSummary.id`. Records
@@ -1348,11 +1349,11 @@ interface Props$c {
     /** Resolved i18n strings — used by default row/card renderers. */
     i18n?: RecordsAdminI18n;
 }
-declare const RecordList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const ProductList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const FacetList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const VariantList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const BatchList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+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;
 
 interface DefaultRecordRowProps {
     record: RecordSummary;
@@ -1394,7 +1395,7 @@ declare const ErrorState: ({ error }: {
     error: Error;
 }) => react_jsx_runtime.JSX.Element;
 
-interface Props$b {
+interface Props$c {
     i18n: RecordsAdminI18n;
     onApplyToMany?: () => void;
     onCopyFrom?: () => void;
@@ -1402,9 +1403,9 @@ interface Props$b {
     onImportCsv?: () => void;
     onExportCsv?: () => void;
 }
-declare const BulkActionsMenu: ({ i18n, onApplyToMany, onCopyFrom, onClearMany, onImportCsv, onExportCsv, }: Props$b) => react_jsx_runtime.JSX.Element | null;
+declare const BulkActionsMenu: ({ i18n, onApplyToMany, onCopyFrom, onClearMany, onImportCsv, onExportCsv, }: Props$c) => react_jsx_runtime.JSX.Element | null;
 
-interface Props$a<T> {
+interface Props$b<T> {
     ctx: EditorContext<T>;
     i18n: RecordsAdminI18n;
     children: ReactNode;
@@ -1469,7 +1470,7 @@ interface Props$a<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$a<T>): react_jsx_runtime.JSX.Element;
+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;
 
 interface InheritanceCtx {
     parentValue?: Record<string, unknown> | null;
@@ -1487,10 +1488,10 @@ interface MarkerProps {
 }
 declare const InheritanceMarker: ({ field, inheritedValue, value, children }: MarkerProps) => react_jsx_runtime.JSX.Element;
 
-interface Props$9 {
+interface Props$a {
     children: ReactNode;
 }
-declare const ResolvedPreview: ({ children }: Props$9) => react_jsx_runtime.JSX.Element;
+declare const ResolvedPreview: ({ children }: Props$a) => react_jsx_runtime.JSX.Element;
 
 interface ProductChildItem {
     /** Variant or batch id (the `<id>` part of `variant:<id>` / `batch:<id>`). */
@@ -1521,7 +1522,7 @@ declare const useProductChildren: (args: UseProductChildrenArgs) => {
 };
 
 type DrillTab = 'product' | 'variant' | 'batch';
-interface Props$8 {
+interface Props$9 {
     productLabel: string;
     /** Which child types are available on the collection. */
     showVariants: boolean;
@@ -1546,7 +1547,7 @@ interface Props$8 {
      */
     hideSingleTab?: boolean;
 }
-declare const ProductDrillDown: ({ productLabel, showVariants, showBatches, active, onChange, selectedChildId, onSelectChild, variants, batches, variantsLoading, batchesLoading, children, hideSingleTab, }: Props$8) => react_jsx_runtime.JSX.Element;
+declare const ProductDrillDown: ({ productLabel, showVariants, showBatches, active, onChange, selectedChildId, onSelectChild, variants, batches, variantsLoading, batchesLoading, children, hideSingleTab, }: Props$9) => react_jsx_runtime.JSX.Element;
 
 type PreviewMode = 'inline' | 'side' | 'tab' | 'drawer';
 interface CommonProps {
@@ -1614,6 +1615,16 @@ interface PreviewScopePickerProps {
 }
 declare const PreviewScopePicker: ({ SL, collectionId, editingScope, value, onChange, showVariants, showBatches, activeScope, i18n, }: PreviewScopePickerProps) => react_jsx_runtime.JSX.Element | null;
 
+interface Props$8 {
+    /** Element whose right edge the pill should anchor to. */
+    anchorRef: React.RefObject<HTMLElement>;
+    onClick: () => void;
+    ariaLabel: string;
+    title: string;
+    children: ReactNode;
+}
+declare function PreviewReopenPill({ anchorRef, onClick, ariaLabel, title, children }: Props$8): React$1.ReactPortal | null;
+
 declare const ScopeBreadcrumb: ({ scope }: {
     scope: ParsedRef;
 }) => react_jsx_runtime.JSX.Element | null;
@@ -2795,4 +2806,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, 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 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 };

package/dist/components/RecordsAdmin/index.js

@@ -1,4 +1,4 @@
-import { useIntroState, AdminPageHeader } from '../../chunk-BNC6Z6WB.js';
+import { useIntroState, AdminPageHeader } from '../../chunk-3RRHM4LP.js';
 import { assertComponentStylesLoaded } from '../../chunk-OLYC54YT.js';
 import '../../chunk-5UQQYXCX.js';
 import { FacetRuleEditor } from '../../chunk-JMCV6FOW.js';
@@ -6,7 +6,7 @@ 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, useMemo, useState, useEffect, useCallback, useRef, isValidElement, useContext, useSyncExternalStore, useLayoutEffect, createElement } from 'react';
+import { createContext, useMemo, useState, useEffect, useCallback, useRef, isValidElement, useLayoutEffect, useContext, useSyncExternalStore, 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, ArrowUpDown, ArrowUp, ArrowDown, MinusCircle, XCircle, CopyPlus, AlertCircle, Undo2, Save, Loader2, ArrowRight, Globe2, Check, Settings2 } from 'lucide-react';
 import { useQuery, useQueryClient, useInfiniteQuery } from '@tanstack/react-query';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -7390,12 +7390,19 @@ function PreviewReopenPill({ anchorRef, onClick, ariaLabel, title, children }) {
   const rafRef = useRef(null);
   useLayoutEffect(() => {
     const el = anchorRef.current;
-    if (!el || typeof window === "undefined") return;
+    if (typeof window === "undefined") return;
+    if (!el) {
+      setPos({ top: window.innerHeight / 2, right: 8 });
+      return;
+    }
     const measure = () => {
       if (rafRef.current != null) cancelAnimationFrame(rafRef.current);
       rafRef.current = requestAnimationFrame(() => {
         const rect = el.getBoundingClientRect();
-        if (rect.width === 0 && rect.height === 0) return;
+        if (rect.width === 0 && rect.height === 0) {
+          setPos({ top: window.innerHeight / 2, right: 8 });
+          return;
+        }
         setPos({
           top: rect.top + rect.height / 2,
           right: Math.max(0, window.innerWidth - rect.right)
@@ -7415,7 +7422,11 @@ function PreviewReopenPill({ anchorRef, onClick, ariaLabel, title, children }) {
       if (rafRef.current != null) cancelAnimationFrame(rafRef.current);
     };
   }, [anchorRef]);
-  if (typeof document === "undefined" || !pos) return null;
+  if (typeof document === "undefined") return null;
+  const effectivePos = pos ?? {
+    top: typeof window !== "undefined" ? window.innerHeight / 2 : 200,
+    right: 8
+  };
   return createPortal(
     /* @__PURE__ */ jsx(
       "button",
@@ -7427,8 +7438,8 @@ function PreviewReopenPill({ anchorRef, onClick, ariaLabel, title, children }) {
         title,
         style: {
           position: "fixed",
-          top: pos.top,
-          right: pos.right,
+          top: effectivePos.top,
+          right: effectivePos.right,
           // Pull half the pill width out into the gutter so it visually
           // anchors *to* the editor edge rather than sitting inside it.
           transform: "translate(50%, -50%)"
@@ -10474,6 +10485,6 @@ function useMergedRecord(args) {
 // src/components/RecordsAdmin/index.ts
 assertComponentStylesLoaded("records-admin");
 
-export { ALL_ITEM_VIEWS, ALL_PRESENTATIONS, BatchList, BulkActionsMenu, DEFAULT_DEEP_LINK_PARAM_NAMES, DEFAULT_I18N, DEFAULT_ICONS, DefaultItemCards, DefaultItemTable, DefaultRecordCard, DefaultRecordRow, DeleteButton, DirtyDraftProvider, DrawerPreview, EditorItemNav, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, ItemListView, ItemViewSwitcher, LoadingState, PresentationSwitcher, PreviewScopePicker, PreviewToggleButton, ProductDrillDown, ProductList, RecordBrowser, RecordEditor, RecordList, RecordsAdminShell, ResolvedPreview, ScopeBreadcrumb, ScopeTabs, SiblingRail, SidePreview, StatusDot, StatusFilterPills, StatusIcon, TabbedPreview, UtilityRow, VariantList, buildDraftKey, buildRef, checkPasteCompatibility, cloneValue, createDefaultDeepLinkAdapter, createPostMessageDeepLinkAdapter, createRouterDeepLinkAdapter, downloadBlob, exportCsv, importCsv, isInSmartLinksIframe, mergeIcons, normaliseRule, parseRef, pickHeaderIcon, resolutionChain, resolveRecord, ruleHash, rulesEqual, scopeCountsQueryKey, statusToneLabel, summariseRule, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyDraft, useDirtyDraftActions, useDirtyDraftStore, useDirtyDrafts, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeCounts, useScopeProbe, useUnsavedGuard };
+export { ALL_ITEM_VIEWS, ALL_PRESENTATIONS, BatchList, BulkActionsMenu, DEFAULT_DEEP_LINK_PARAM_NAMES, DEFAULT_I18N, DEFAULT_ICONS, DefaultItemCards, DefaultItemTable, DefaultRecordCard, DefaultRecordRow, DeleteButton, DirtyDraftProvider, DrawerPreview, EditorItemNav, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, ItemListView, ItemViewSwitcher, LoadingState, PresentationSwitcher, PreviewReopenPill, PreviewScopePicker, PreviewToggleButton, ProductDrillDown, ProductList, RecordBrowser, RecordEditor, RecordList, RecordsAdminShell, ResolvedPreview, ScopeBreadcrumb, ScopeTabs, SiblingRail, SidePreview, StatusDot, StatusFilterPills, StatusIcon, TabbedPreview, UtilityRow, VariantList, buildDraftKey, buildRef, checkPasteCompatibility, cloneValue, createDefaultDeepLinkAdapter, createPostMessageDeepLinkAdapter, createRouterDeepLinkAdapter, downloadBlob, exportCsv, importCsv, isInSmartLinksIframe, mergeIcons, normaliseRule, parseRef, pickHeaderIcon, resolutionChain, resolveRecord, ruleHash, rulesEqual, scopeCountsQueryKey, statusToneLabel, summariseRule, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyDraft, useDirtyDraftActions, useDirtyDraftStore, useDirtyDrafts, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeCounts, useScopeProbe, useUnsavedGuard };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map