@nivaro/react 0.3.42 → 0.3.44

package/dist/hooks/useSessionRecorder.js

@@ -9,7 +9,7 @@ import { noteReplayEvent as _e, createReplayCheckoutState as De } from "../share
 import { emitReplayTap as Te, setReplayRecorderMode as N, registerReplayCapture as qe, clipEndOffset as Le, withClipKind as Pe } from "../shared/lib/replay-capture.js";
 import { instrumentConsole as Ne, instrumentRequests as Fe, redactSecrets as Me } from "../shared/lib/replay-context.js";
 import { instrumentSocket as Oe } from "../shared/lib/replay-socket.js";
-const Ue = "nivaro-react@0.3.42", j = 1e4, We = 150, He = 3e3, Ke = 600, $e = (n) => `nvr_replay_resume${n ? `:${n}` : ""}`, G = () => typeof navigator > "u" || navigator.onLine !== !1;
+const Ue = "nivaro-react@0.3.44", j = 1e4, We = 150, He = 3e3, Ke = 600, $e = (n) => `nvr_replay_resume${n ? `:${n}` : ""}`, G = () => typeof navigator > "u" || navigator.onLine !== !1;
 function Be(n) {
   return typeof n.url != "string" || typeof fetch != "function" ? null : (f, a) => {
     const u = typeof n.getToken == "function" ? n.getToken() : void 0, d = { "Content-Type": "application/json" };

package/dist/index.d.ts

@@ -2693,6 +2693,20 @@ declare interface DisplayPrefs {
 
 export declare function DisplayPrefsCard(): JSX.Element;
 
+/**
+ * The crumbs to show: walk back from the current page, newest first, skipping
+ * the current page itself and repeats (the NEWEST visit of a page wins — the
+ * fewest steps back), and stop after the first "root" page (a list or hub the
+ * person started from) or `max` crumbs. Oldest first.
+ */
+export declare function displayTrail(chain: TrailEntry[], current: {
+    idx: number;
+    path: string;
+}, opts?: {
+    isRoot?: (pathname: string) => boolean;
+    max?: number;
+}): TrailCrumb[];
+
 declare type DmOpener = (userId: string, displayName?: string) => void;
 
 export declare function dmPeer(room: string, self: string): string | null;
@@ -8760,6 +8774,9 @@ declare type RecordingHandoff = {
     };
 };
 
+/** Feed one location change. Returns the entry now current. */
+export declare function recordNavigation(ev: TrailEvent): TrailEntry | undefined;
+
 /**
  * Mounted ONCE by a host (admin's AppLayout), inside a NivaroProvider and a
  * QueryClientProvider: binds the outbox to the signed-in person so saves left
@@ -9787,6 +9804,13 @@ export declare function setServerClockOffset(ms: number): void;
 
 export declare function setTimeDisplay(mode: string | null | undefined): void;
 
+/**
+ * Name a page in the trail (what later crumbs will show for it): the current
+ * entry — and, when a key is given, only while that key is still current (a
+ * label that lands after the person moved on is dropped, never misfiled).
+ */
+export declare function setTrailLabel(label: string | null | undefined, key?: string): void;
+
 /** True when this browser can share a socket between tabs. */
 export declare function sharedWorkerSupported(): boolean;
 
@@ -10714,6 +10738,68 @@ export declare function TrafficMiniMap({ window: win, tone, href, refreshMs, cla
     className?: string;
 }): JSX.Element | null;
 
+/**
+ * #3225 — breadcrumbs that know the path. A per-TAB record of the history
+ * entries this tab walked through (sessionStorage, so a reload keeps it and
+ * another tab has its own), keyed by the router's history index. The page
+ * header turns the entries before the current one into crumbs — how the
+ * person actually got here (Queue "Pending approvals" → PO 4471 → Line 3) —
+ * and a crumb click goes BACK that many history entries, so the page comes
+ * back exactly as it was left: same URL (filters, tab), and the scroll
+ * position the trail remembered.
+ *
+ * The host feeds it: call `recordNavigation()` on every location change with
+ * the router's action ('PUSH' | 'REPLACE' | 'POP'), the location key and
+ * `history.state.idx` (React Router keeps the index there across reloads).
+ * Nothing here touches the router, so any host (admin, efp-new) can wire it.
+ *
+ * Pure parts (`reduceTrail`, `trailChain`, `displayTrail`) are tested on their own.
+ */
+declare type TrailAction = 'PUSH' | 'REPLACE' | 'POP';
+
+/** The unbroken run of entries right before the current one, oldest first. */
+export declare function trailChain(state: TrailState): TrailEntry[];
+
+declare interface TrailCrumb {
+    key: string;
+    path: string;
+    label?: string;
+    /** History steps to go back to reach it (negative). */
+    delta: number;
+}
+
+declare interface TrailEntry {
+    key: string;
+    idx: number;
+    /** pathname + search + hash */
+    path: string;
+    label?: string;
+    scroll?: TrailScroll[];
+    at: number;
+}
+
+declare interface TrailEvent {
+    action: TrailAction;
+    key: string;
+    idx: number;
+    path: string;
+    at?: number;
+}
+
+declare interface TrailScroll {
+    /** '' = the page scroller itself; otherwise a child path from it (see scrollPathOf). */
+    path: string;
+    top: number;
+}
+
+declare interface TrailState {
+    entries: TrailEntry[];
+    current: {
+        key: string;
+        idx: number;
+    } | null;
+}
+
 /**
  * Translate scope values (target-collection IDS) into a filter's value space.
  * When the filter compares ids (valueField 'id'/undefined) this is identity;
@@ -11377,6 +11463,9 @@ export declare function useMyScopes(): {
 
 export declare function useNavigation(): NavigationContextValue;
 
+/** The tab's trail, re-rendering on every change. */
+export declare function useNavTrail(): TrailState;
+
 export declare function useNivaroClient(): NivaroClient;
 
 /**

package/dist/index.js

@@ -11,7 +11,7 @@ import { NivaroField as g } from "./components/NivaroField.js";
 import { NivaroForm as y } from "./components/NivaroForm.js";
 import { useAutoRecord as w } from "./hooks/useAutoRecord.js";
 import { clearFormSchemaCache as I, fetchSchema as k, useFormSchema as E } from "./hooks/useFormSchema.js";
-import { useFieldArray as D, useFieldState as v, useFormDirty as V, useFormStatus as O, useOrderedLayout as b, useSectionState as L, useTabState as N, useWatchFields as B } from "./hooks/useLayoutHooks.js";
+import { useFieldArray as v, useFieldState as D, useFormDirty as V, useFormStatus as O, useOrderedLayout as b, useSectionState as L, useTabState as N, useWatchFields as B } from "./hooks/useLayoutHooks.js";
 import { liveListKey as M, liveRecordKey as _, useLiveList as W, useLiveRecord as G } from "./hooks/useLive.js";
 import { useNivaroForm as Q } from "./hooks/useNivaroForm.js";
 import { useRelationOptions as z } from "./hooks/useRelationOptions.js";
@@ -24,7 +24,7 @@ import { AddendumPanel as ye } from "./shared/components/panels/AddendumPanel.js
 import { AiAnalyticsView as we } from "./shared/components/ai/AiAnalyticsView.js";
 import { AiFeedbackButtons as Ie } from "./shared/components/ai/AiFeedbackButtons.js";
 import { AiMarkdown as Ee } from "./shared/components/ai/AiMarkdown.js";
-import { AiMemorySuggestions as De } from "./shared/components/ai/AiMemorySuggestions.js";
+import { AiMemorySuggestions as ve } from "./shared/components/ai/AiMemorySuggestions.js";
 import { AiPlanCard as Ve } from "./shared/components/ai/AiPlanCard.js";
 import { AiReviewCard as be, OwnerGapsCard as Le, PipelineEditorView as Ne, PipelineSimulatorCard as Be } from "./shared/components/pipeline/PipelineEditorView.js";
 import { AlertManagerView as Me } from "./shared/components/alerts/AlertManagerView.js";
@@ -43,7 +43,7 @@ import { BaseMap as co } from "./shared/components/BaseMap.js";
 import { BroadcastView as Ro } from "./shared/components/BroadcastView.js";
 import { BrowserPushCard as ho } from "./shared/components/profile/BrowserPushCard.js";
 import { BulkActionButtons as Po, useAvailableBulkActions as yo } from "./shared/components/bulk/BulkActionButtons.js";
-import { CLEAN_RECORDING_ATTR as wo, DEMO_USER as Ao, RECORDING_ATTR as Io, RECORDING_HIDE_ATTR as ko, beginCleanRecording as Eo, beginRecordingScreen as Fo, isCleanRecording as Do, setRecordingSelf as vo, useCleanRecording as Vo, useIsRecordingSelf as Oo } from "./shared/components/help-videos/recorder/cleanRecording.js";
+import { CLEAN_RECORDING_ATTR as wo, DEMO_USER as Ao, RECORDING_ATTR as Io, RECORDING_HIDE_ATTR as ko, beginCleanRecording as Eo, beginRecordingScreen as Fo, isCleanRecording as vo, setRecordingSelf as Do, useCleanRecording as Vo, useIsRecordingSelf as Oo } from "./shared/components/help-videos/recorder/cleanRecording.js";
 import { CLIENT_CHAOS_HEADER as Lo, bindClientChaosSocket as No, canUseClientChaos as Bo, clientChaosAxiosInterceptor as Ho, getClientChaos as Mo, installClientChaosFetch as _o, startClientChaos as Wo, stopClientChaos as Go, subscribeClientChaos as Uo, withClientChaos as Qo } from "./shared/lib/client-chaos.js";
 import { CLIENT_CHAOS_SHORTCUT as zo, ClientChaosToolbar as qo, clientChaosSummary as Yo, openClientChaosToolbar as Jo } from "./shared/components/ClientChaosToolbar.js";
 import { CacheStamp as jo } from "./shared/components/CacheStamp.js";
@@ -56,7 +56,7 @@ import { ChatAppearAwayRow as dr, ChatChannelBrowser as cr, ChatChannelSettings
 import { CloneDialog as wr } from "./shared/components/item-edit/CloneDialog.js";
 import { CollectionBrowserView as Ir } from "./shared/components/CollectionBrowserView.js";
 import { CollectionImportPanel as Er } from "./shared/components/imports/CollectionImportPanel.js";
-import { CommandCenterView as Dr } from "./shared/components/command-center/CommandCenterView.js";
+import { CommandCenterView as vr } from "./shared/components/command-center/CommandCenterView.js";
 import { CommentPanel as Vr } from "./shared/components/panels/CommentPanel.js";
 import { ConformanceView as br } from "./shared/components/ConformanceView.js";
 import { CopyAsButton as Nr } from "./shared/components/CopyAsButton.js";
@@ -74,7 +74,7 @@ import { DisplayPrefsCard as mt, NotificationRulesCard as ft, ProfileFieldsCard
 import { DndMark as Ct, DoNotDisturbRow as Rt, useDndActive as St } from "./shared/components/DoNotDisturb.js";
 import { DocumentAutofillButton as gt } from "./shared/components/import/DocumentAutofillButton.js";
 import { DrillBanner as yt, useArmedFaults as Tt, useDrillBannerShowing as wt } from "./shared/components/chaos/DrillBanner.js";
-import { DrilldownContext as It, DrilldownViewsContext as kt, GridFlushContext as Et, ItemEditAuthContext as Ft, NavigationContext as Dt, NivaroProvider as vt, OverlayHistoryContext as Vt, RecordSurfaceContext as Ot, decodePrefill as bt, defaultItemUrl as Lt, encodePrefill as Nt, fieldDrilldownConfig as Bt, useApiFetchConfig as Ht, useDrilldown as Mt, useDrilldownViews as _t, useGridFlush as Wt, useItemEditAuth as Gt, useItemNavigation as Ut, useNavigation as Qt, useNivaroClient as Kt, useOptionalNivaroClient as zt, useOverlayState as qt } from "./shared/context.js";
+import { DrilldownContext as It, DrilldownViewsContext as kt, GridFlushContext as Et, ItemEditAuthContext as Ft, NavigationContext as vt, NivaroProvider as Dt, OverlayHistoryContext as Vt, RecordSurfaceContext as Ot, decodePrefill as bt, defaultItemUrl as Lt, encodePrefill as Nt, fieldDrilldownConfig as Bt, useApiFetchConfig as Ht, useDrilldown as Mt, useDrilldownViews as _t, useGridFlush as Wt, useItemEditAuth as Gt, useItemNavigation as Ut, useNavigation as Qt, useNivaroClient as Kt, useOptionalNivaroClient as zt, useOverlayState as qt } from "./shared/context.js";
 import { EmptyState as Jt } from "./shared/components/EmptyState.js";
 import { ErpFailureBanner as jt } from "./shared/components/panels/ErpFailureBanner.js";
 import { ErrorSurface as $t } from "./shared/components/ErrorSurface.js";
@@ -91,7 +91,7 @@ import { HelpVideoButton as yi } from "./shared/components/help-videos/viewer/He
 import { HelpVideoEditor as wi } from "./shared/components/help-videos/editor/HelpVideoEditor.js";
 import { HelpVideoLibrary as Ii } from "./shared/components/help-videos/library/HelpVideoLibrary.js";
 import { HelpVideoMatchChip as Ei } from "./shared/components/help-videos/viewer/HelpVideoMatchChip.js";
-import { HelpVideoPlayer as Di } from "./shared/components/help-videos/HelpVideoPlayer.js";
+import { HelpVideoPlayer as vi } from "./shared/components/help-videos/HelpVideoPlayer.js";
 import { HelpVideoRecorder as Vi } from "./shared/components/help-videos/recorder/HelpVideoRecorder.js";
 import { HelpVideoRecordingProvider as bi, useHelpVideoRecording as Li } from "./shared/components/help-videos/recorder/HelpVideoRecordingProvider.js";
 import { HelpVideoSheet as Bi } from "./shared/components/help-videos/viewer/HelpVideoSheet.js";
@@ -113,7 +113,7 @@ import { IntegrationObligationsView as ya } from "./shared/components/integratio
 import { IntegrationsConsole as wa } from "./shared/components/integrations/console/IntegrationsConsole.js";
 import { ItemActionButtons as Ia } from "./shared/components/panels/ItemActionButtons.js";
 import { ItemEditForm as Ea } from "./shared/components/ItemEditForm.js";
-import { ItemLockBanner as Da, useItemLock as va } from "./shared/components/panels/ItemLockBanner.js";
+import { ItemLockBanner as va, useItemLock as Da } from "./shared/components/panels/ItemLockBanner.js";
 import { JobsTray as Oa } from "./shared/components/JobsTray.js";
 import { JsonMapEditor as La } from "./shared/components/JsonMapEditor.js";
 import { LAYOUT_PUSH_SETTLE_MS as Ba, useLayoutEditingQuiet as Ha } from "./shared/components/item-edit/layout-editing-quiet.js";
@@ -130,7 +130,7 @@ import { NotificationAnalyticsView as yn } from "./shared/components/notificatio
 import { NotificationBell as wn } from "./shared/components/NotificationBell.js";
 import { NotificationCenterView as In } from "./shared/components/notifications/NotificationCenterView.js";
 import { NotificationSourcesCard as En } from "./shared/components/NotificationSourcesCard.js";
-import { NotificationSubscriptionsView as Dn } from "./shared/components/notifications/NotificationSubscriptionsView.js";
+import { NotificationSubscriptionsView as vn } from "./shared/components/notifications/NotificationSubscriptionsView.js";
 import { NotificationTemplatesView as Vn } from "./shared/components/notifications/NotificationTemplatesView.js";
 import { OfflineBanner as bn } from "./shared/components/OfflineBanner.js";
 import { OpsTasksView as Nn } from "./shared/components/ops/OpsTasksView.js";
@@ -151,7 +151,7 @@ import { SectionCard as ys } from "./shared/components/profile/primitives.js";
 import { QualityRulesView as ws } from "./shared/components/QualityRulesView.js";
 import { QueryStatStrip as Is } from "./shared/components/QueryStatStrip.js";
 import { QueryTable as Es } from "./shared/components/QueryTable.js";
-import { QueryWidgetBody as Ds, ReportView as vs, ReportWidgetCard as Vs } from "./shared/components/ReportView.js";
+import { QueryWidgetBody as vs, ReportView as Ds, ReportWidgetCard as Vs } from "./shared/components/ReportView.js";
 import { QueueBulkBar as bs } from "./shared/components/queue/QueueBulkBar.js";
 import { QueueItemSheet as Ns } from "./shared/components/queue/QueueItemSheet.js";
 import { QueueKanbanBoard as Hs } from "./shared/components/queue/QueueKanbanBoard.js";
@@ -159,7 +159,7 @@ import { QueueWorklist as _s } from "./shared/components/queue/QueueWorklist.js"
 import { QueueWorkloadView as Gs } from "./shared/components/queue/QueueWorkloadView.js";
 import { QuickPicker as Qs } from "./shared/components/item-edit/QuickPicker.js";
 import { QuickPickerDialog as zs, useQuickPickerSteps as qs } from "./shared/components/item-edit/QuickPickerDialog.js";
-import { REACTION_EMOJI as Js, canOpenChatRoom as Xs, canOpenDm as js, chatAvatarColor as Zs, chatInitials as $s, chatRoomTypesQuery as ep, dmPeer as op, dmRoom as rp, getMentionQuery as tp, openChatRoom as ip, openDmWith as ap, registerDmOpener as np, registerRoomOpener as sp, splitMessageTokens as pp, useChannelAdmin as lp, useChannelDirectory as mp, useChannelMembers as fp, useChatConfig as up, useChatMessages as xp, useChatRoles as dp, useChatRooms as cp, useChatSearch as Cp, useCreateChannel as Rp, useCreateGroupDm as Sp, useDeleteMessage as hp, useEditMessage as gp, useEntityRoomLink as Pp, useMarkRoomRead as yp, useNotificationSoundPreference as Tp, useOpenRoomRegistration as wp, usePeerReadAt as Ap, useRoomMembership as Ip, useRoomPins as kp, useSendChatMessage as Ep, useTogglePin as Fp, useToggleReaction as Dp, useTypingIndicator as vp, useUnreadChirp as Vp, useUserSearch as Op } from "./shared/components/chat/chat-core.js";
+import { REACTION_EMOJI as Js, canOpenChatRoom as Xs, canOpenDm as js, chatAvatarColor as Zs, chatInitials as $s, chatRoomTypesQuery as ep, dmPeer as op, dmRoom as rp, getMentionQuery as tp, openChatRoom as ip, openDmWith as ap, registerDmOpener as np, registerRoomOpener as sp, splitMessageTokens as pp, useChannelAdmin as lp, useChannelDirectory as mp, useChannelMembers as fp, useChatConfig as up, useChatMessages as xp, useChatRoles as dp, useChatRooms as cp, useChatSearch as Cp, useCreateChannel as Rp, useCreateGroupDm as Sp, useDeleteMessage as hp, useEditMessage as gp, useEntityRoomLink as Pp, useMarkRoomRead as yp, useNotificationSoundPreference as Tp, useOpenRoomRegistration as wp, usePeerReadAt as Ap, useRoomMembership as Ip, useRoomPins as kp, useSendChatMessage as Ep, useTogglePin as Fp, useToggleReaction as vp, useTypingIndicator as Dp, useUnreadChirp as Vp, useUserSearch as Op } from "./shared/components/chat/chat-core.js";
 import { ROW_HIGHLIGHT_TINTS as Lp, rowHighlightClass as Np, rowHighlightTextClass as Bp } from "./shared/lib/row-highlight.js";
 import { RealtimeContext as Mp, updateItemIds as _p, updateTouches as Wp, useOptionalRealtime as Gp, useRealtimeStatus as Up } from "./shared/lib/realtime.js";
 import { RealtimeStaleMark as Kp, RealtimeStatusBanner as zp } from "./shared/components/RealtimeStatusBanner.js";
@@ -180,7 +180,7 @@ import { RequiredVideosCard as yl } from "./shared/components/help-videos/viewer
 import { ReviewListWidget as wl } from "./shared/components/widgets/ReviewListWidget.js";
 import { RevisionsPanel as Il } from "./shared/components/panels/RevisionsPanel.js";
 import { RowPresence as El } from "./shared/components/RowPresence.js";
-import { SOMETHING_WENT_WRONG as Dl, isCodeError as vl, reportCodeError as Vl, userErrorMessage as Ol } from "./shared/lib/safe-error.js";
+import { SOMETHING_WENT_WRONG as vl, isCodeError as Dl, reportCodeError as Vl, userErrorMessage as Ol } from "./shared/lib/safe-error.js";
 import { SearchHighlight as Ll } from "./shared/components/SearchHighlight.js";
 import { SignalCard as Bl } from "./shared/components/integrations/console/SignalCard.js";
 import { SkipReportCard as Ml, TemplateLintCard as _l } from "./shared/components/pipeline/PipelineHealthCards.js";
@@ -203,7 +203,7 @@ import { TipLayer as ym } from "./shared/components/TipLayer.js";
 import { TrafficMiniMap as wm } from "./shared/components/monitoring/TrafficMiniMap.js";
 import { UserAvatar as Im } from "./shared/components/UserAvatar.js";
 import { UserChip as Em, UserRosterCluster as Fm } from "./shared/components/item-edit/UserChip.js";
-import { WidgetSlot as vm } from "./shared/components/WidgetSlot.js";
+import { WidgetSlot as Dm } from "./shared/components/WidgetSlot.js";
 import { WorkflowPanel as Om } from "./shared/components/panels/WorkflowPanel.js";
 import { activityWhy as Lm, actorName as Nm, groupActivity as Bm, renderActivityGroupSentence as Hm, renderActivitySentence as Mm } from "./shared/lib/activity-sentence.js";
 import { agingBucket as Wm, buildGroups as Gm, deriveGroupKey as Um } from "./shared/lib/queue-grouping.js";
@@ -219,56 +219,57 @@ import { captureReplayClip as Cf, clipEndOffset as Rf, prepareReplayClip as Sf,
 import { clearRecordOutbox as Tf } from "./shared/lib/record-outbox.js";
 import { configureTabSound as Af } from "./shared/lib/tab-sound.js";
 import { configureUserSync as kf, useUserSync as Ef } from "./shared/lib/user-sync.js";
-import { createGatedClient as Df, forgetSettledReads as vf, releaseGatedReads as Vf, releaseGatedReadsOnSharedFetch as Of, withGetCoalescing as bf } from "./shared/lib/request-gate.js";
+import { createGatedClient as vf, forgetSettledReads as Df, releaseGatedReads as Vf, releaseGatedReadsOnSharedFetch as Of, withGetCoalescing as bf } from "./shared/lib/request-gate.js";
 import { createLeaderSocket as Nf } from "./shared/lib/leader-socket.js";
 import { createSocketRealtime as Hf } from "./shared/lib/socket-realtime.js";
 import { createWorkerSocket as _f, sharedWorkerSupported as Wf, shouldUseWorkerSocket as Gf, workerSocketPreference as Uf } from "./shared/lib/worker-socket.js";
 import { dismissAutofillRun as Kf, getAutofillRuns as zf, startAutofillRun as qf, useAutofillRuns as Yf } from "./shared/lib/autofill-runs.js";
-import { dotsForRecord as Xf } from "./shared/lib/integration-dots.js";
-import { effectiveScopeSeedIds as Zf, matchScopeDimension as $f, translateScopeValues as eu, useMyScopes as ou } from "./shared/lib/use-my-scopes.js";
-import { endHelpVideoWalk as tu, registerHelpVideoPage as iu, startHelpVideoWalk as au, useCurrentHelpVideoPage as nu } from "./shared/components/help-videos/walk/store.js";
-import { evaluateBoolean as pu, evaluateExpression as lu, evaluateNumeric as mu, extractExpressionTokens as fu, formulaConstant as uu, networkdaysBetween as xu, parseExpression as du, setFormulaConstants as cu, validateExpression as Cu } from "./shared/lib/expression.js";
-import { expandTokens as Su, foldSearchText as hu, highlightParts as gu, matchesSearch as Pu, searchRankTier as yu, tokenize as Tu } from "./shared/lib/search-text.js";
-import { extSlotKey as Au, getLayoutSlot as Iu, registerLayoutSlot as ku } from "./shared/lib/layout-slots.js";
-import { fiscalPeriodOf as Fu, fiscalQuarterOf as Du, fiscalYearOf as vu, getFiscalStartMonth as Vu, setFiscalStartMonth as Ou } from "./shared/lib/fiscal.js";
-import { formSkeletonFromLayout as Lu, skeletonColumnsFrom as Nu } from "./shared/lib/skeleton-shapes.js";
-import { formatMultiValue as Hu, formatValue as Mu, numericIntlOptions as _u, precisionOf as Wu } from "./shared/lib/format-value.js";
-import { formatReplayTail as Uu, getReplayTail as Qu, installReplayTail as Ku } from "./shared/lib/replay-tail.js";
-import { getApiUpdate as qu, startApiVersionWatch as Yu, useApiUpdate as Ju } from "./shared/lib/api-version.js";
-import { getFieldInterface as ju, listFieldInterfaces as Zu, onFieldInterfacesChange as $u, registerFieldInterface as ex } from "./shared/lib/field-interfaces.js";
-import { guardIdentityCall as rx, isSignedOut as tx, isSignedOutError as ix, noteCredentialChanged as ax, noteSignedIn as nx, noteUnauthorized as sx, onSignedIn as px } from "./shared/lib/signed-out.js";
-import { hasUnsavedWork as mx, isReloadingForUpdate as fx, registerUnsavedWork as ux, subscribeUnsavedWork as xx, unsavedWorkLabels as dx, useUnsavedWork as cx } from "./shared/lib/unsaved-work.js";
-import { helpVideoApi as Rx, helpVideoKeys as Sx, useHelpVideo as hx, useHelpVideoWalk as gx, useHelpVideosFor as Px, useRequiredVideos as yx } from "./shared/components/help-videos/api.js";
-import { holdNotification as wx, huddleHolds as Ax, releaseHeld as Ix } from "./shared/components/chat/huddle/huddle-hold.js";
-import { installStaleChunkRecovery as Ex, isStaleChunkError as Fx } from "./shared/lib/stale-chunk.js";
-import { isListTimeout as vx, listLoadErrorText as Vx, loadErrorText as Ox } from "./shared/lib/load-error.js";
-import { knownTotalFrom as Lx, slowReasonText as Nx } from "./shared/lib/slow-reason.js";
-import { measureClockOffset as Hx, serverNow as Mx, setServerClockOffset as _x } from "./shared/lib/server-clock.js";
-import { normalizeFieldType as Gx } from "./hooks/schemaBuilder.js";
-import { obligationQueryParams as Qx, toneForOutcome as Kx } from "./shared/lib/obligation-filters.js";
-import { pageAtPayload as qx, usePageAt as Yx } from "./shared/lib/use-page-at.js";
-import { playNotificationSound as Xx } from "./shared/lib/notification-sound.js";
-import { rankTeamForFilters as Zx, useScopeDimensions as $x } from "./shared/components/pipeline/teamScopes.js";
-import { registerReloadHold as od } from "./shared/lib/reload-holds.js";
-import { resolveNotificationTarget as td, resolveNotificationTargetFor as id, runNotificationTarget as ad } from "./shared/lib/notification-target.js";
-import { restoreMetadata as sd, startMetadataPersistence as pd, wipeMetadataCache as ld } from "./shared/lib/metadata-persist.js";
-import { rowPresenceKey as fd, useFieldFocus as ud, usePresence as xd, useRowPresence as dd, useTyping as cd } from "./shared/lib/presence-hooks.js";
-import { rumRouteChange as Rd, rumWidget as Sd, startRum as hd } from "./shared/lib/rum.js";
-import { seedQuickPickerSteps as Pd } from "./shared/components/item-edit/helpers.js";
-import { signalSentence as Td, useRecordSignalPeers as wd, useRecordSignalWhile as Ad, useTopicPresence as Id } from "./shared/lib/presence-signals.js";
-import { stuckText as Ed } from "./shared/lib/presence-state.js";
-import { tapReplaySocket as Dd } from "./shared/lib/replay-socket.js";
-import { useAfterIdle as Vd } from "./shared/lib/defer.js";
-import { useBackgroundRun as bd } from "./shared/lib/background-runs.js";
-import { useClientChaos as Nd, useClientChaosGate as Bd } from "./shared/components/client-chaos-gate.js";
-import { useDebounced as Md } from "./shared/hooks/useDebounced.js";
-import { useElapsedLoading as Wd } from "./shared/hooks/useElapsedLoading.js";
-import { useEventPath as Ud, usePartner as Qd, usePartners as Kd, useRecordIntegrationActivity as zd, useRefreshSignals as qd, useSignalAction as Yd, useSignals as Jd, useSnooze as Xd } from "./shared/components/integrations/console/api.js";
-import { useFeatureFlag as Zd, useFeatureFlags as $d } from "./shared/lib/feature-flags.js";
-import { useFileHealth as oc } from "./shared/hooks/useFileHealth.js";
-import { useOnlineUsers as tc } from "./shared/lib/use-online-users.js";
-import { usePersonProfile as ac } from "./shared/components/profile/types.js";
-import { useSlowReason as sc } from "./shared/hooks/useSlowReason.js";
+import { displayTrail as Xf, recordNavigation as jf, setTrailLabel as Zf, trailChain as $f, useNavTrail as eu } from "./shared/lib/nav-trail.js";
+import { dotsForRecord as ru } from "./shared/lib/integration-dots.js";
+import { effectiveScopeSeedIds as iu, matchScopeDimension as au, translateScopeValues as nu, useMyScopes as su } from "./shared/lib/use-my-scopes.js";
+import { endHelpVideoWalk as lu, registerHelpVideoPage as mu, startHelpVideoWalk as fu, useCurrentHelpVideoPage as uu } from "./shared/components/help-videos/walk/store.js";
+import { evaluateBoolean as du, evaluateExpression as cu, evaluateNumeric as Cu, extractExpressionTokens as Ru, formulaConstant as Su, networkdaysBetween as hu, parseExpression as gu, setFormulaConstants as Pu, validateExpression as yu } from "./shared/lib/expression.js";
+import { expandTokens as wu, foldSearchText as Au, highlightParts as Iu, matchesSearch as ku, searchRankTier as Eu, tokenize as Fu } from "./shared/lib/search-text.js";
+import { extSlotKey as Du, getLayoutSlot as Vu, registerLayoutSlot as Ou } from "./shared/lib/layout-slots.js";
+import { fiscalPeriodOf as Lu, fiscalQuarterOf as Nu, fiscalYearOf as Bu, getFiscalStartMonth as Hu, setFiscalStartMonth as Mu } from "./shared/lib/fiscal.js";
+import { formSkeletonFromLayout as Wu, skeletonColumnsFrom as Gu } from "./shared/lib/skeleton-shapes.js";
+import { formatMultiValue as Qu, formatValue as Ku, numericIntlOptions as zu, precisionOf as qu } from "./shared/lib/format-value.js";
+import { formatReplayTail as Ju, getReplayTail as Xu, installReplayTail as ju } from "./shared/lib/replay-tail.js";
+import { getApiUpdate as $u, startApiVersionWatch as ex, useApiUpdate as ox } from "./shared/lib/api-version.js";
+import { getFieldInterface as tx, listFieldInterfaces as ix, onFieldInterfacesChange as ax, registerFieldInterface as nx } from "./shared/lib/field-interfaces.js";
+import { guardIdentityCall as px, isSignedOut as lx, isSignedOutError as mx, noteCredentialChanged as fx, noteSignedIn as ux, noteUnauthorized as xx, onSignedIn as dx } from "./shared/lib/signed-out.js";
+import { hasUnsavedWork as Cx, isReloadingForUpdate as Rx, registerUnsavedWork as Sx, subscribeUnsavedWork as hx, unsavedWorkLabels as gx, useUnsavedWork as Px } from "./shared/lib/unsaved-work.js";
+import { helpVideoApi as Tx, helpVideoKeys as wx, useHelpVideo as Ax, useHelpVideoWalk as Ix, useHelpVideosFor as kx, useRequiredVideos as Ex } from "./shared/components/help-videos/api.js";
+import { holdNotification as vx, huddleHolds as Dx, releaseHeld as Vx } from "./shared/components/chat/huddle/huddle-hold.js";
+import { installStaleChunkRecovery as bx, isStaleChunkError as Lx } from "./shared/lib/stale-chunk.js";
+import { isListTimeout as Bx, listLoadErrorText as Hx, loadErrorText as Mx } from "./shared/lib/load-error.js";
+import { knownTotalFrom as Wx, slowReasonText as Gx } from "./shared/lib/slow-reason.js";
+import { measureClockOffset as Qx, serverNow as Kx, setServerClockOffset as zx } from "./shared/lib/server-clock.js";
+import { normalizeFieldType as Yx } from "./hooks/schemaBuilder.js";
+import { obligationQueryParams as Xx, toneForOutcome as jx } from "./shared/lib/obligation-filters.js";
+import { pageAtPayload as $x, usePageAt as ed } from "./shared/lib/use-page-at.js";
+import { playNotificationSound as rd } from "./shared/lib/notification-sound.js";
+import { rankTeamForFilters as id, useScopeDimensions as ad } from "./shared/components/pipeline/teamScopes.js";
+import { registerReloadHold as sd } from "./shared/lib/reload-holds.js";
+import { resolveNotificationTarget as ld, resolveNotificationTargetFor as md, runNotificationTarget as fd } from "./shared/lib/notification-target.js";
+import { restoreMetadata as xd, startMetadataPersistence as dd, wipeMetadataCache as cd } from "./shared/lib/metadata-persist.js";
+import { rowPresenceKey as Rd, useFieldFocus as Sd, usePresence as hd, useRowPresence as gd, useTyping as Pd } from "./shared/lib/presence-hooks.js";
+import { rumRouteChange as Td, rumWidget as wd, startRum as Ad } from "./shared/lib/rum.js";
+import { seedQuickPickerSteps as kd } from "./shared/components/item-edit/helpers.js";
+import { signalSentence as Fd, useRecordSignalPeers as vd, useRecordSignalWhile as Dd, useTopicPresence as Vd } from "./shared/lib/presence-signals.js";
+import { stuckText as bd } from "./shared/lib/presence-state.js";
+import { tapReplaySocket as Nd } from "./shared/lib/replay-socket.js";
+import { useAfterIdle as Hd } from "./shared/lib/defer.js";
+import { useBackgroundRun as _d } from "./shared/lib/background-runs.js";
+import { useClientChaos as Gd, useClientChaosGate as Ud } from "./shared/components/client-chaos-gate.js";
+import { useDebounced as Kd } from "./shared/hooks/useDebounced.js";
+import { useElapsedLoading as qd } from "./shared/hooks/useElapsedLoading.js";
+import { useEventPath as Jd, usePartner as Xd, usePartners as jd, useRecordIntegrationActivity as Zd, useRefreshSignals as $d, useSignalAction as ec, useSignals as oc, useSnooze as rc } from "./shared/components/integrations/console/api.js";
+import { useFeatureFlag as ic, useFeatureFlags as ac } from "./shared/lib/feature-flags.js";
+import { useFileHealth as sc } from "./shared/hooks/useFileHealth.js";
+import { useOnlineUsers as lc } from "./shared/lib/use-online-users.js";
+import { usePersonProfile as fc } from "./shared/components/profile/types.js";
+import { useSlowReason as xc } from "./shared/hooks/useSlowReason.js";
 export {
   j as ACTIVE_GAMEDAYS_KEY,
   oe as ACTIVE_USER_OPTION_FILTER,
@@ -279,7 +280,7 @@ export {
   we as AiAnalyticsView,
   Ie as AiFeedbackButtons,
   Ee as AiMarkdown,
-  De as AiMemorySuggestions,
+  ve as AiMemorySuggestions,
   Ve as AiPlanCard,
   be as AiReviewCard,
   Me as AlertManagerView,
@@ -321,7 +322,7 @@ export {
   wr as CloneDialog,
   Ir as CollectionBrowserView,
   Er as CollectionImportPanel,
-  Dr as CommandCenterView,
+  vr as CommandCenterView,
   Vr as CommentPanel,
   br as ConformanceView,
   Nr as CopyAsButton,
@@ -366,7 +367,7 @@ export {
   wi as HelpVideoEditor,
   Ii as HelpVideoLibrary,
   Ei as HelpVideoMatchChip,
-  Di as HelpVideoPlayer,
+  vi as HelpVideoPlayer,
   Vi as HelpVideoRecorder,
   bi as HelpVideoRecordingProvider,
   Bi as HelpVideoSheet,
@@ -393,7 +394,7 @@ export {
   Ia as ItemActionButtons,
   Ft as ItemEditAuthContext,
   Ea as ItemEditForm,
-  Da as ItemLockBanner,
+  va as ItemLockBanner,
   Oa as JobsTray,
   La as JsonMapEditor,
   Ba as LAYOUT_PUSH_SETTLE_MS,
@@ -406,18 +407,18 @@ export {
   en as MAX_PREFETCH_IN_FLIGHT,
   dn as MatrixEditor,
   Cn as MyWorkView,
-  Dt as NavigationContext,
+  vt as NavigationContext,
   Sn as NewImportDialog,
   g as NivaroField,
   y as NivaroForm,
-  vt as NivaroProvider,
+  Dt as NivaroProvider,
   gn as NotificationActions,
   yn as NotificationAnalyticsView,
   wn as NotificationBell,
   In as NotificationCenterView,
   ft as NotificationRulesCard,
   En as NotificationSourcesCard,
-  Dn as NotificationSubscriptionsView,
+  vn as NotificationSubscriptionsView,
   Vn as NotificationTemplatesView,
   p as NumberField,
   bn as OfflineBanner,
@@ -451,7 +452,7 @@ export {
   ws as QualityRulesView,
   Is as QueryStatStrip,
   Es as QueryTable,
-  Ds as QueryWidgetBody,
+  vs as QueryWidgetBody,
   Jn as QueryWidgetView,
   bs as QueueBulkBar,
   Ns as QueueItemSheet,
@@ -484,13 +485,13 @@ export {
   m as RelationField,
   Rl as RenderSettingsButton,
   hl as ReportProblemButton,
-  vs as ReportView,
+  Ds as ReportView,
   Vs as ReportWidgetCard,
   yl as RequiredVideosCard,
   wl as ReviewListWidget,
   Il as RevisionsPanel,
   El as RowPresence,
-  Dl as SOMETHING_WENT_WRONG,
+  vl as SOMETHING_WENT_WRONG,
   Ll as SearchHighlight,
   u as SelectField,
   Bl as SignalCard,
@@ -524,7 +525,7 @@ export {
   Im as UserAvatar,
   Em as UserChip,
   Fm as UserRosterCluster,
-  vm as WidgetSlot,
+  Dm as WidgetSlot,
   Om as WorkflowPanel,
   Qr as activeCustomStatus,
   Lm as activityWhy,
@@ -564,7 +565,7 @@ export {
   Af as configureTabSound,
   kf as configureUserSync,
   rn as connectionAllowsPrefetch,
-  Df as createGatedClient,
+  vf as createGatedClient,
   Nf as createLeaderSocket,
   Wa as createLiveQueryBridge,
   Hf as createSocketRealtime,
@@ -575,183 +576,187 @@ export {
   Um as deriveGroupKey,
   Mr as describeCron,
   Kf as dismissAutofillRun,
+  Xf as displayTrail,
   op as dmPeer,
   rp as dmRoom,
-  Xf as dotsForRecord,
-  Zf as effectiveScopeSeedIds,
+  ru as dotsForRecord,
+  iu as effectiveScopeSeedIds,
   Nt as encodePrefill,
-  tu as endHelpVideoWalk,
-  pu as evaluateBoolean,
-  lu as evaluateExpression,
-  mu as evaluateNumeric,
-  Su as expandTokens,
-  Au as extSlotKey,
-  fu as extractExpressionTokens,
+  lu as endHelpVideoWalk,
+  du as evaluateBoolean,
+  cu as evaluateExpression,
+  Cu as evaluateNumeric,
+  wu as expandTokens,
+  Du as extSlotKey,
+  Ru as extractExpressionTokens,
   k as fetchSchema,
   Bt as fieldDrilldownConfig,
   Jr as filterDefLabel,
   Xr as filterValueDisplay,
-  Fu as fiscalPeriodOf,
-  Du as fiscalQuarterOf,
-  vu as fiscalYearOf,
+  Lu as fiscalPeriodOf,
+  Nu as fiscalQuarterOf,
+  Bu as fiscalYearOf,
   _n as focusRecordTarget,
-  hu as foldSearchText,
-  vf as forgetSettledReads,
-  Lu as formSkeletonFromLayout,
+  Au as foldSearchText,
+  Df as forgetSettledReads,
+  Wu as formSkeletonFromLayout,
   ie as formatDate,
   ae as formatDateTime,
   ne as formatFileSize,
-  Hu as formatMultiValue,
+  Qu as formatMultiValue,
   se as formatNumber,
   pe as formatRelative,
-  Uu as formatReplayTail,
+  Ju as formatReplayTail,
   Kr as formatStatusExpiry,
-  Mu as formatValue,
-  uu as formulaConstant,
-  qu as getApiUpdate,
+  Ku as formatValue,
+  Su as formulaConstant,
+  $u as getApiUpdate,
   zf as getAutofillRuns,
   Mo as getClientChaos,
-  ju as getFieldInterface,
-  Vu as getFiscalStartMonth,
-  Iu as getLayoutSlot,
+  tx as getFieldInterface,
+  Hu as getFiscalStartMonth,
+  Vu as getLayoutSlot,
   tp as getMentionQuery,
-  Qu as getReplayTail,
+  Xu as getReplayTail,
   Bm as groupActivity,
-  rx as guardIdentityCall,
-  mx as hasUnsavedWork,
-  Rx as helpVideoApi,
-  Sx as helpVideoKeys,
-  gu as highlightParts,
-  wx as holdNotification,
+  px as guardIdentityCall,
+  Cx as hasUnsavedWork,
+  Tx as helpVideoApi,
+  wx as helpVideoKeys,
+  Iu as highlightParts,
+  vx as holdNotification,
   Qi as huddleCallLayerMounted,
-  Ax as huddleHolds,
+  Dx as huddleHolds,
   qi as idleState,
   _o as installClientChaosFetch,
   tn as installIntentPrefetch,
-  Ku as installReplayTail,
-  Ex as installStaleChunkRecovery,
+  ju as installReplayTail,
+  bx as installStaleChunkRecovery,
   an as intentProps,
   yr as isChatPanelPinned,
-  Do as isCleanRecording,
-  vl as isCodeError,
-  vx as isListTimeout,
-  fx as isReloadingForUpdate,
-  tx as isSignedOut,
-  ix as isSignedOutError,
-  Fx as isStaleChunkError,
-  Lx as knownTotalFrom,
+  vo as isCleanRecording,
+  Dl as isCodeError,
+  Bx as isListTimeout,
+  Rx as isReloadingForUpdate,
+  lx as isSignedOut,
+  mx as isSignedOutError,
+  Lx as isStaleChunkError,
+  Wx as knownTotalFrom,
   hs as layoutPretendDownOptions,
-  Zu as listFieldInterfaces,
-  Vx as listLoadErrorText,
+  ix as listFieldInterfaces,
+  Hx as listLoadErrorText,
   nn as listQueryKeys,
   M as liveListKey,
   Ga as liveQueryMeta,
   _ as liveRecordKey,
   Ua as liveRefetchInterval,
-  Ox as loadErrorText,
+  Mx as loadErrorText,
   df as maskInputsIn,
-  $f as matchScopeDimension,
-  Pu as matchesSearch,
-  Hx as measureClockOffset,
-  xu as networkdaysBetween,
-  Gx as normalizeFieldType,
-  ax as noteCredentialChanged,
-  nx as noteSignedIn,
-  sx as noteUnauthorized,
-  _u as numericIntlOptions,
-  Qx as obligationQueryParams,
-  $u as onFieldInterfacesChange,
+  au as matchScopeDimension,
+  ku as matchesSearch,
+  Qx as measureClockOffset,
+  hu as networkdaysBetween,
+  Yx as normalizeFieldType,
+  fx as noteCredentialChanged,
+  ux as noteSignedIn,
+  xx as noteUnauthorized,
+  zu as numericIntlOptions,
+  Xx as obligationQueryParams,
+  ax as onFieldInterfacesChange,
   Yi as onIdleChange,
-  px as onSignedIn,
+  dx as onSignedIn,
   eo as openAskPanel,
   nf as openCatalogItem,
   ip as openChatRoom,
   Jo as openClientChaosToolbar,
   ap as openDmWith,
-  qx as pageAtPayload,
-  du as parseExpression,
-  Xx as playNotificationSound,
-  Wu as precisionOf,
+  $x as pageAtPayload,
+  gu as parseExpression,
+  rd as playNotificationSound,
+  qu as precisionOf,
   sn as prefetchCollectionList,
   pn as prefetchRecord,
   Sf as prepareReplayClip,
   di as rankSignals,
-  Zx as rankTeamForFilters,
+  id as rankTeamForFilters,
+  jf as recordNavigation,
   ln as recordQueryKeys,
   sf as registerCatalogItemOpener,
   np as registerDmOpener,
-  ex as registerFieldInterface,
-  iu as registerHelpVideoPage,
-  ku as registerLayoutSlot,
-  od as registerReloadHold,
+  nx as registerFieldInterface,
+  mu as registerHelpVideoPage,
+  Ou as registerLayoutSlot,
+  sd as registerReloadHold,
   hf as registerReplayCapture,
   sp as registerRoomOpener,
-  ux as registerUnsavedWork,
+  Sx as registerUnsavedWork,
   mf as registerViewAsOpener,
   Vf as releaseGatedReads,
   Of as releaseGatedReadsOnSharedFetch,
-  Ix as releaseHeld,
+  Vx as releaseHeld,
   Hm as renderActivityGroupSentence,
   Mm as renderActivitySentence,
   gf as replayHref,
   $m as reportClientCrash,
   Vl as reportCodeError,
   le as resolveCollectionIcon,
-  td as resolveNotificationTarget,
-  id as resolveNotificationTargetFor,
-  sd as restoreMetadata,
+  ld as resolveNotificationTarget,
+  md as resolveNotificationTargetFor,
+  xd as restoreMetadata,
   Np as rowHighlightClass,
   Bp as rowHighlightTextClass,
-  fd as rowPresenceKey,
-  Rd as rumRouteChange,
-  Sd as rumWidget,
-  ad as runNotificationTarget,
-  yu as searchRankTier,
-  Pd as seedQuickPickerSteps,
-  Mx as serverNow,
+  Rd as rowPresenceKey,
+  Td as rumRouteChange,
+  wd as rumWidget,
+  fd as runNotificationTarget,
+  Eu as searchRankTier,
+  kd as seedQuickPickerSteps,
+  Kx as serverNow,
   me as setDisplayTimezone,
-  Ou as setFiscalStartMonth,
-  cu as setFormulaConstants,
+  Mu as setFiscalStartMonth,
+  Pu as setFormulaConstants,
   fe as setNumberFormat,
-  vo as setRecordingSelf,
-  _x as setServerClockOffset,
+  Do as setRecordingSelf,
+  zx as setServerClockOffset,
   ue as setTimeDisplay,
+  Zf as setTrailLabel,
   Wf as sharedWorkerSupported,
   Gf as shouldUseWorkerSocket,
-  Td as signalSentence,
-  Nu as skeletonColumnsFrom,
-  Nx as slowReasonText,
+  Fd as signalSentence,
+  Gu as skeletonColumnsFrom,
+  Gx as slowReasonText,
   pp as splitMessageTokens,
-  Yu as startApiVersionWatch,
+  ex as startApiVersionWatch,
   qf as startAutofillRun,
   Wo as startClientChaos,
-  au as startHelpVideoWalk,
-  pd as startMetadataPersistence,
-  hd as startRum,
+  fu as startHelpVideoWalk,
+  dd as startMetadataPersistence,
+  Ad as startRum,
   Go as stopClientChaos,
-  Ed as stuckText,
+  bd as stuckText,
   Uo as subscribeClientChaos,
-  xx as subscribeUnsavedWork,
-  Dd as tapReplaySocket,
+  hx as subscribeUnsavedWork,
+  Nd as tapReplaySocket,
   xe as titleCase,
-  Tu as tokenize,
-  Kx as toneForOutcome,
+  Fu as tokenize,
+  jx as toneForOutcome,
   Ji as trackActivity,
-  eu as translateScopeValues,
-  dx as unsavedWorkLabels,
+  $f as trailChain,
+  nu as translateScopeValues,
+  gx as unsavedWorkLabels,
   _p as updateItemIds,
   Wp as updateTouches,
   $ as useActiveGamedays,
   ge as useActivityLabels,
-  Vd as useAfterIdle,
+  Hd as useAfterIdle,
   Ht as useApiFetchConfig,
-  Ju as useApiUpdate,
+  ox as useApiUpdate,
   Tt as useArmedFaults,
   oo as useAskRecordDrag,
   w as useAutoRecord,
   Yf as useAutofillRuns,
   yo as useAvailableBulkActions,
-  bd as useBackgroundRun,
+  _d as useBackgroundRun,
   lp as useChannelAdmin,
   mp as useChannelDirectory,
   fp as useChannelMembers,
@@ -761,12 +766,12 @@ export {
   cp as useChatRooms,
   Cp as useChatSearch,
   Vo as useCleanRecording,
-  Nd as useClientChaos,
-  Bd as useClientChaosGate,
+  Gd as useClientChaos,
+  Ud as useClientChaosGate,
   Rp as useCreateChannel,
   Sp as useCreateGroupDm,
-  nu as useCurrentHelpVideoPage,
-  Md as useDebounced,
+  uu as useCurrentHelpVideoPage,
+  Kd as useDebounced,
   hp as useDeleteMessage,
   zm as useDisplayPreferences,
   St as useDndActive,
@@ -774,29 +779,29 @@ export {
   Mt as useDrilldown,
   _t as useDrilldownViews,
   gp as useEditMessage,
-  Wd as useElapsedLoading,
+  qd as useElapsedLoading,
   Pp as useEntityRoomLink,
-  Ud as useEventPath,
-  Zd as useFeatureFlag,
-  $d as useFeatureFlags,
-  D as useFieldArray,
-  ud as useFieldFocus,
-  v as useFieldState,
-  oc as useFileHealth,
+  Jd as useEventPath,
+  ic as useFeatureFlag,
+  ac as useFeatureFlags,
+  v as useFieldArray,
+  Sd as useFieldFocus,
+  D as useFieldState,
+  sc as useFileHealth,
   V as useFormDirty,
   E as useFormSchema,
   O as useFormStatus,
   Wt as useGridFlush,
-  hx as useHelpVideo,
+  Ax as useHelpVideo,
   Li as useHelpVideoRecording,
-  gx as useHelpVideoWalk,
-  Px as useHelpVideosFor,
+  Ix as useHelpVideoWalk,
+  kx as useHelpVideosFor,
   mn as useIdleNextPage,
   sa as useImportHealth,
   fn as useIntentPrefetch,
   Oo as useIsRecordingSelf,
   Gt as useItemEditAuth,
-  va as useItemLock,
+  Da as useItemLock,
   Ut as useItemNavigation,
   Ha as useLayoutEditingQuiet,
   W as useLiveList,
@@ -805,64 +810,65 @@ export {
   G as useLiveRecord,
   za as useLiveRefetchInterval,
   yp as useMarkRoomRead,
-  ou as useMyScopes,
+  su as useMyScopes,
+  eu as useNavTrail,
   Qt as useNavigation,
   Kt as useNivaroClient,
   Q as useNivaroForm,
   Tp as useNotificationSoundPreference,
-  tc as useOnlineUsers,
+  lc as useOnlineUsers,
   wp as useOpenRoomRegistration,
   zt as useOptionalNivaroClient,
   Gp as useOptionalRealtime,
   b as useOrderedLayout,
   qt as useOverlayState,
-  Yx as usePageAt,
-  Qd as usePartner,
-  Kd as usePartners,
+  ed as usePageAt,
+  Xd as usePartner,
+  jd as usePartners,
   Ap as usePeerReadAt,
-  ac as usePersonProfile,
+  fc as usePersonProfile,
   us as usePlanGridHost,
   un as usePrefetchIntent,
-  xd as usePresence,
+  hd as usePresence,
   gs as usePretendDownScope,
   ro as usePublishAskContext,
   qs as useQuickPickerSteps,
   Up as useRealtimeStatus,
-  zd as useRecordIntegrationActivity,
-  wd as useRecordSignalPeers,
-  Ad as useRecordSignalWhile,
-  qd as useRefreshSignals,
+  Zd as useRecordIntegrationActivity,
+  vd as useRecordSignalPeers,
+  Dd as useRecordSignalWhile,
+  $d as useRefreshSignals,
   z as useRelationOptions,
-  yx as useRequiredVideos,
+  Ex as useRequiredVideos,
   Ip as useRoomMembership,
   kp as useRoomPins,
-  dd as useRowPresence,
-  $x as useScopeDimensions,
+  gd as useRowPresence,
+  ad as useScopeDimensions,
   L as useSectionState,
   Ep as useSendChatMessage,
   J as useSessionRecorder,
   pa as useSetImportCadence,
-  Yd as useSignalAction,
-  Jd as useSignals,
-  sc as useSlowReason,
-  Xd as useSnooze,
+  ec as useSignalAction,
+  oc as useSignals,
+  xc as useSlowReason,
+  rc as useSnooze,
   em as useSubscriptionMutations,
   N as useTabState,
   Fp as useTogglePin,
-  Dp as useToggleReaction,
-  Id as useTopicPresence,
-  cd as useTyping,
-  vp as useTypingIndicator,
+  vp as useToggleReaction,
+  Vd as useTopicPresence,
+  Pd as useTyping,
+  Dp as useTypingIndicator,
   Vp as useUnreadChirp,
-  cx as useUnsavedWork,
+  Px as useUnsavedWork,
   Op as useUserSearch,
   Ef as useUserSync,
   B as useWatchFields,
   Ol as userErrorMessage,
   de as userOptionFilter,
-  Cu as validateExpression,
+  yu as validateExpression,
   ff as viewAs,
-  ld as wipeMetadataCache,
+  cd as wipeMetadataCache,
   Qo as withClientChaos,
   Pf as withClipKind,
   bf as withGetCoalescing,

package/dist/shared/lib/nav-trail.js

@@ -0,0 +1,107 @@
+import { useSyncExternalStore as m } from "react";
+const p = "nvr:nav-trail", y = 60, f = (n) => n.split(/[?#]/)[0] || "/";
+function k(n, t) {
+  const i = t.at ?? Date.now(), e = Number.isFinite(t.idx) ? Math.max(0, Math.floor(t.idx)) : 0, r = n.entries.find((s) => s.idx === e);
+  let o;
+  if (t.action === "PUSH")
+    o = [...n.entries.filter((s) => s.idx < e), { key: t.key, idx: e, path: t.path, at: i }];
+  else if (r && r.key === t.key && r.path === t.path)
+    o = n.entries;
+  else {
+    const s = r && f(r.path) === f(t.path) ? r : null, c = {
+      key: t.key,
+      idx: e,
+      path: t.path,
+      at: i,
+      ...s != null && s.label ? { label: s.label } : {},
+      ...s != null && s.scroll && t.action === "REPLACE" ? { scroll: s.scroll } : {}
+    };
+    o = [...n.entries.filter((l) => l.idx !== e), c].sort((l, a) => l.idx - a.idx);
+  }
+  return o.length > y && (o = o.slice(o.length - y)), { entries: o, current: { key: t.key, idx: e } };
+}
+function I(n) {
+  const t = n.current;
+  if (!t) return [];
+  const i = new Map(n.entries.map((r) => [r.idx, r])), e = [];
+  for (let r = t.idx - 1; r >= 0; r--) {
+    const o = i.get(r);
+    if (!o) break;
+    e.unshift(o);
+  }
+  return e;
+}
+function A(n, t, i = {}) {
+  var c;
+  const e = i.max ?? 4, r = f(t.path), o = /* @__PURE__ */ new Set([r]), s = [];
+  for (let l = n.length - 1; l >= 0 && s.length < e; l--) {
+    const a = n[l], d = f(a.path);
+    if (!o.has(d) && (o.add(d), s.unshift({ key: a.key, path: a.path, label: a.label, delta: a.idx - t.idx }), (c = i.isRoot) != null && c.call(i, d)))
+      break;
+  }
+  return s;
+}
+const b = { entries: [], current: null };
+let u = null;
+const x = /* @__PURE__ */ new Set();
+function h() {
+  if (u) return u;
+  try {
+    const n = typeof sessionStorage < "u" ? sessionStorage.getItem(p) : null, t = n ? JSON.parse(n) : null;
+    u = { entries: Array.isArray(t == null ? void 0 : t.entries) ? t.entries.filter(
+      (e) => !!e && typeof e.key == "string" && typeof e.path == "string" && Number.isFinite(e.idx)
+    ) : [], current: (t == null ? void 0 : t.current) ?? null };
+  } catch {
+    u = b;
+  }
+  return u;
+}
+function g(n) {
+  u = n;
+  try {
+    sessionStorage.setItem(p, JSON.stringify(n));
+  } catch {
+  }
+  for (const t of x) t();
+}
+function S() {
+  return h();
+}
+function w(n) {
+  const t = k(h(), n);
+  return t !== u && g(t), t.entries.find((i) => {
+    var e;
+    return i.idx === ((e = t.current) == null ? void 0 : e.idx);
+  });
+}
+function N(n, t) {
+  const i = h(), e = i.current, r = n ? e && e.key === n ? i.entries.findIndex((c) => c.idx === e.idx && c.key === n) : -1 : e ? i.entries.findIndex((c) => c.idx === e.idx && c.key === e.key) : -1;
+  if (r < 0) return;
+  const o = t(i.entries[r]);
+  if (!o) return;
+  const s = [...i.entries];
+  s[r] = o, g({ ...i, entries: s });
+}
+function M(n, t) {
+  const i = (n ?? "").trim().slice(0, 120);
+  i && N(t, (e) => e.label === i ? null : { ...e, label: i });
+}
+function T(n) {
+  return x.add(n), () => {
+    x.delete(n);
+  };
+}
+function R() {
+  return m(T, S, () => b);
+}
+export {
+  p as NAV_TRAIL_KEY,
+  A as displayTrail,
+  S as getNavTrail,
+  w as recordNavigation,
+  k as reduceTrail,
+  M as setTrailLabel,
+  T as subscribeNavTrail,
+  I as trailChain,
+  R as useNavTrail
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nivaro/react",
-  "version": "0.3.42",
+  "version": "0.3.44",
   "description": "React hooks and components for Nivaro CMS forms",
   "type": "module",
   "main": "./dist/index.js",