@solhun/feedback-kit-core 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -1,3 +1,93 @@
+/** 궤적 상한. 넘으면 오래된 것부터 버린다. */
+declare const ROUTE_TRAIL_LIMIT = 20;
+/** 탭 저장소에 쓰는 키. */
+declare const ROUTE_TRAIL_KEY = "feedback-kit:route-trail";
+/** 궤적 한 줄. */
+interface RouteTrailEntry {
+    /** 그 경로에 **처음 도착한** 시각(epoch ms 정수). 접힘(count)으로는 갱신하지 않는다. */
+    at: number;
+    /** 직전 경로. 버퍼의 첫 항목은 `null`. */
+    from: string | null;
+    /** 도착 경로. */
+    to: string;
+    /** 같은 경로로 연속 이동해 접힌 횟수. 기본 1. */
+    count: number;
+}
+/**
+ * 경로 감시자 주입 계약 — **구독 함수 하나**다.
+ *
+ * 구독하면 **현재 경로를 한 번 흘리고**(마운트 시점의 화면이 궤적의 첫 줄이 된다),
+ * 이후 경로가 바뀔 때마다 새 경로를 넘긴다. 돌려주는 함수를 부르면 구독이 끊긴다.
+ * 뒤로가기·앞으로가기도 이동이므로 함께 흘려야 한다.
+ */
+type RouteWatcher = (onPath: (route: string) => void) => () => void;
+/**
+ * 궤적을 남길 **동기** 저장소. `sessionStorage` 와 같은 모양이라 웹은 그대로 넘기면 된다.
+ *
+ * 코어의 `FeedbackStorage`(Promise)를 쓰지 않는 이유: 이동 직후 새로고침이 일어나면
+ * await 가 끝나기 전에 페이지가 사라져 그 이동이 통째로 유실된다.
+ */
+interface RouteTrailStore {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+interface RouteTrailOpts {
+    /** 탭 단위 저장소. 없으면 메모리로만 동작한다(새로고침에서 끊긴다). */
+    storage?: RouteTrailStore | null;
+    limit?: number;
+    key?: string;
+    now?: () => number;
+}
+/**
+ * 경로에서 쿼리스트링과 해시를 뺀다.
+ *
+ * 값 하나하나를 가려내지 않고 **쿼리를 통째로 버린다** — 그래야 `?token=…` 같은
+ * 자격증명형 파라미터가 애초에 들어올 자리가 없다. 화면 식별에는 경로만으로 충분하다.
+ *
+ * 인자를 `route` 라 부르는 이유: 화면 경로를 가리키는 더 흔한 영어 단어는 라쏘런 봉투가
+ * **요소 선택자**를 부르는 필드명이기도 하다. 그 단어가 코어 본체에 등장하면 경계 검사
+ * (`adapters.test.ts` TC5)가 "코어가 대상 필드명을 안다"로 잡는다 — 검사를 느슨하게
+ * 하는 대신 이쪽 이름을 비켰다.
+ */
+declare function normalizeRoutePath(route: string): string;
+/**
+ * 화면 이동 궤적 버퍼.
+ *
+ * 진단 링버퍼(network·logs)와 다른 점은 **탭 저장소에 남는다**는 것 하나다.
+ * 메모리에만 두면 전체 새로고침 한 번에 궤적이 끊기는데, 정작 재현 절차에
+ * 새로고침이 끼어 있는 제보가 많다.
+ */
+declare class RouteTrail {
+    readonly limit: number;
+    private entries;
+    private storage;
+    private readonly key;
+    private readonly now;
+    private unwatch;
+    constructor(opts?: RouteTrailOpts);
+    /** 감시자를 붙인다. 이미 붙어 있으면 먼저 끊는다(감시자가 둘이면 이동이 두 번 기록된다). */
+    watch(watcher: RouteWatcher): void;
+    /** 감시자를 뗀다. 버퍼 내용은 그대로 남는다. */
+    unwatchRoutes(): void;
+    /**
+     * 이동 하나를 기록한다.
+     *
+     * 같은 경로로 연속 이동하면 새 줄을 만들지 않고 `count` 만 올린다. 판정은 **직전 항목의
+     * `to`** 와 비교한다 — 새로고침 직후 같은 화면에서 다시 시작해도 줄이 늘지 않는다.
+     */
+    record(route: string): void;
+    /** 지금까지의 궤적. 사본이라 이후 이동이 이미 만든 제보를 바꾸지 않는다. */
+    snapshot(): RouteTrailEntry[];
+    get size(): number;
+    /** 버퍼와 저장분을 모두 비운다. */
+    clear(): void;
+    /** 저장소를 나중에 붙인다. 이미 저장돼 있던 궤적이 있으면 그것을 이어받는다. */
+    attachStorage(storage: RouteTrailStore | null): void;
+    private readRaw;
+    private restore;
+    private persist;
+}
+
 /**
  * 힌트가 어디에 뜨는가.
  * `screen`=일반 모달(화면 전체를 묻는 흐름), `element`=요소 지목 모달, `both`=둘 다.
@@ -264,14 +354,19 @@ interface DiagLogEntry {
 /**
  * 제보에 실리는 진단 스냅샷.
  *
- * 두 배열은 **수집기가 실제로 모은 결과**다. 제출 시점에 비어 있는 것은 정상이고
- * (그 세션에 요청·경고가 없었다는 뜻), 배선이 안 됐을 때는 배열이 아니라
+ * 세 배열은 **수집기가 실제로 모은 결과**다. 제출 시점에 비어 있는 것은 정상이고
+ * (그 세션에 요청·경고·이동이 없었다는 뜻), 배선이 안 됐을 때는 배열이 아니라
  * 컨텍스트의 `diagnostics` 자체가 `null`이 된다. 그래서 "빈 배열"과
  * "수집 안 함"이 페이로드에서 구분된다.
  */
 interface DiagnosticsPayload {
     network: DiagNetworkEntry[];
     logs: DiagLogEntry[];
+    /**
+     * 화면 이동 궤적. 감시자를 주입하지 않은 호스트에서는 이것만 비고 나머지는 그대로 모인다
+     * — 궤적이 없다고 진단 전체를 `null` 로 만들지 않는다.
+     */
+    routes: RouteTrailEntry[];
 }
 /** 앱 빌드 정보. 어느 빌드에서 났는지 특정하는 데 쓴다. */
 interface AppInfo {
@@ -711,6 +806,16 @@ interface DiagnosticsInstallOpts {
      * 그게 제보를 덮어 정작 중요한 경고가 묻힌다. 그래서 프로젝트마다 정한다.
      */
     logs?: "problems" | "all" | "off";
+    /**
+     * 화면 이동을 알려주는 감시자. 코어는 `window`·`navigation` 을 보지 않으므로 플랫폼이
+     * 주입한다. 주지 않으면 **궤적만 비고** 네트워크·로그 수집은 그대로 돌아간다.
+     */
+    watchRoutes?: RouteWatcher | null;
+    /**
+     * 궤적을 남길 탭 단위 저장소(웹은 `sessionStorage`). 주지 않으면 메모리로만 동작한다 —
+     * 전체 새로고침에서 궤적이 끊길 뿐, 수집 자체는 계속된다.
+     */
+    routeStorage?: RouteTrailStore | null;
     /** 시각 주입(테스트용). */
     now?: () => number;
     iso?: (n: number) => string;
@@ -718,6 +823,11 @@ interface DiagnosticsInstallOpts {
 declare class DiagnosticsCollector {
     readonly network: RingBuffer<DiagNetworkEntry>;
     readonly logs: RingBuffer<DiagLogEntry>;
+    /**
+     * 화면 이동 궤적. network·logs 와 **같은 스위치(`captureDiagnostics`)** 로 켜고 끈다 —
+     * 별도 설정을 만들지 않는다. 다른 점은 탭 저장소에 남는다는 것 하나다.
+     */
+    readonly routes: RouteTrail;
     private installed;
     private originalFetch;
     private originalXhrOpen;
@@ -742,6 +852,8 @@ declare class DiagnosticsCollector {
         iso?: (n: number) => string;
         networkLimit?: number;
         logLimit?: number;
+        routeLimit?: number;
+        routeStorage?: RouteTrailStore | null;
     });
     /** 위젯이 자신의 로그를 캡처 없이 찍을 때 쓰는 원본 console. */
     readonly originalConsole: {
@@ -758,7 +870,7 @@ declare class DiagnosticsCollector {
      * 반환 배열은 사본이라 이후 수집이 제보 페이로드를 바꾸지 않는다.
      */
     snapshot(): DiagnosticsPayload;
-    /** 두 버퍼를 비운다. */
+    /** 세 버퍼를 비운다. */
     clear(): void;
     /** 실패 사유 한 줄. 예외 객체엔 요청 본문이 들어 있을 수 있어 메시지만, 길이도 자른다. */
     private recordNetwork;
@@ -919,7 +1031,7 @@ declare function isInternalUser(resolved: ResolvedConfig, env: VisibilityEnv): b
 declare function shouldShowWidget(resolved: ResolvedConfig, input?: Partial<VisibilityEnv>): boolean;
 /** `DiagnosticsCollector` 중 설정 배선에 필요한 최소 형태. */
 interface DiagnosticsSource {
-    install(): void;
+    install(opts?: DiagnosticsInstallOpts): void;
     snapshot(): DiagnosticsPayload;
 }
 /**
@@ -929,7 +1041,7 @@ interface DiagnosticsSource {
  * 돌려주는 공급자를 만들면 "수집했는데 아무 일도 없었다"와 "애초에 수집하지 않았다"가
  * 구분되지 않는다. 공급자가 없으면 `buildContext` 가 `diagnostics: null` 을 쓴다.
  */
-declare function diagnosticsProviderFor(resolved: Pick<ResolvedConfig, "captureDiagnostics">, collector: DiagnosticsSource): (() => DiagnosticsPayload) | undefined;
+declare function diagnosticsProviderFor(resolved: Pick<ResolvedConfig, "captureDiagnostics">, collector: DiagnosticsSource, installOpts?: DiagnosticsInstallOpts): (() => DiagnosticsPayload) | undefined;
 
 /** 빌드 플러그인이 심는 속성 이름. `data-` 라서 DOM 이 그대로 통과시킨다. */
 declare const SOURCE_ATTR = "data-fk-source";
@@ -1512,6 +1624,11 @@ interface LassoReportContext {
         device: Record<string, unknown>;
         display: Record<string, unknown>;
     } | null;
+    /**
+     * 화면 이동 궤적(도착 순서). 서버가 `meta` 로 펼치므로 제보를 다시 열었을 때
+     * "어디를 거쳐 여기까지 왔는지"를 읽을 수 있다. 감시자가 없으면 빈 배열이다.
+     */
+    routes: RouteTrailEntry[];
     /** 호스트가 넣은 자유 메타. 우리가 해석하지 않는다. */
     extra: Record<string, unknown>;
 }
@@ -1737,4 +1854,4 @@ declare function parseHintCatalog(raw: unknown): HintCatalog | null;
  */
 declare function rankHints(hints: readonly FeedbackHint[], input: HintRankInput, limit: number): FeedbackHint[];
 
-export { type AdapterName, type AppInfo, BACKOFF_BASE_MS, BACKOFF_MAX_MS, type BuildContextOpts, type BuildReportOpts, COMMENT_MAX_CHARS, COMMENT_REQUIRED_MESSAGE, COMMENT_TOO_LONG_MESSAGE, type CaptureWithinLimitOpts, type ConfigWarning, type ConfigWarningCode, type ContextProviders, type ContextUser, DEFAULT_ADAPTER, DEFAULT_INTERNAL_ROLES, DEFAULT_POSITION, type DeviceInfo, type DiagLogEntry, type DiagNetworkEntry, type DiagRequestRef, DiagnosticsCollector, type DiagnosticsExcludeMatcher, type DiagnosticsInstallOpts, type DiagnosticsPayload, type DiagnosticsSource, type DisplayInfo, ENDPOINT_FROM_ADAPTER, type ElementInfo, type ElementLike, FLOATING_BUTTON_ID, type FeedbackAdapter, type FeedbackConfig, type FeedbackContext, type FeedbackHint, type FeedbackKind, type FeedbackPin, type FeedbackPriority, FeedbackQueue, type FeedbackQueueOpts, type FeedbackReport, type FeedbackScreenshot, type FeedbackStorage, type FeedbackUser, FocusRing, type GetCurrentScreenFn, type GetUserFn, HINT_DISPLAY_DEFAULT, HINT_DISPLAY_MAX, HINT_DISPLAY_MIN, HINT_DRAFT_MAX_CHARS, HINT_FAIL_COOLDOWN_MS, HINT_LABEL_MAX_CHARS, HINT_MAX_ITEMS, HINT_TIMEOUT_MS, HINT_TTL_MS, type HintCacheEntry, type HintCatalog, type HintElementRule, type HintFetchResult, type HintPlatform, HintProvider, type HintProviderOpts, type HintRankInput, type HintScope, type HintSource, KEEPALIVE_BODY_LIMIT_BYTES, LASSO_DEFAULT_ENDPOINT, LOG_BUFFER_LIMIT, type LassoAdapterOpts, type LassoEnvelope, type LassoFetch, type LassoReportContext, type LassoRequestInit, type LassoResponseLike, type LinearIssueInput, MAX_LOG_MESSAGE_CHARS, MAX_QUEUE_AGE_MS, MAX_QUEUE_ITEMS, MODAL_ACTION_ATTACH, MODAL_ACTION_CANCEL, MODAL_ACTION_HINT_TOGGLE, MODAL_ACTION_PICK, MODAL_ACTION_PIN, MODAL_ACTION_REMOVE_SCREENSHOT, MODAL_ACTION_RETRY, MODAL_ACTION_SEND, MODAL_FIELD_COMMENT, MODAL_FIELD_PRIORITY, type ModalQueueLike, type ModalSubmitStatus, NETWORK_BUFFER_LIMIT, type NativeContext, type NotionPageInput, PinController, type PixelPoint, type PixelSize, type QueueStatus, type QueueStatusListener, RATE_LIMIT_MIN_DELAY_MS, REDACTED, ReportModalController, type ReportModalListener, type ReportModalOpts, type ReportModalState, type ReportParts, type ResolvedConfig, RingBuffer, SCORE_ELEMENT, SCORE_PATH_EXACT, SCORE_PATH_PATTERN, SCREENSHOT_FAILED_MESSAGE, SCREENSHOT_MAX_BASE64_BYTES, SCREENSHOT_QUALITY_STEPS, SOURCE_ATTR, SUBMIT_DONE_MESSAGE, SUBMIT_FAILED_MESSAGE, SUBMIT_PENDING_MESSAGE, type ScreenshotCapture, type ScreenshotOutcome, type ScreenshotReencode, type ScreenshotStatus, type SourceLocation, type SourceMapping, type SubmitOutcome, type SubmitResult, TITLE_MAX_CHARS, type Visibility, type VisibilityEnv, type VisibilityFn, type WebContext, type WebContextInput, WidgetController, type WidgetControllerOpts, type WidgetCorner, type WidgetListener, type WidgetPlatform, type WidgetPosition, type WidgetScreen, type WidgetState, appPathFromNav, buildContext, buildLassoContext, buildLassoEnvelope, buildLinearIssue, buildNotionPage, buildReport, buildTitle, byteLengthOf, canUseKeepalive, captureWithinLimit, createLassoAdapter, defaultBackoff, denormalizePin, detectDevBuild, diagnosticsProviderFor, getOrCreateGuestId, guestUser, hintCharCount, isInternalUser, matchElement, matchPath, normalizePin, normalizeUser, parseHintCatalog, parseSourceAttr, rankHints, renderReportBody, resolveConfig, resolveContextUser, sanitizeUrl, screenshotBytes, sharedDiagnostics, shouldShowWidget, sourceFromElement, uuidv4 };
+export { type AdapterName, type AppInfo, BACKOFF_BASE_MS, BACKOFF_MAX_MS, type BuildContextOpts, type BuildReportOpts, COMMENT_MAX_CHARS, COMMENT_REQUIRED_MESSAGE, COMMENT_TOO_LONG_MESSAGE, type CaptureWithinLimitOpts, type ConfigWarning, type ConfigWarningCode, type ContextProviders, type ContextUser, DEFAULT_ADAPTER, DEFAULT_INTERNAL_ROLES, DEFAULT_POSITION, type DeviceInfo, type DiagLogEntry, type DiagNetworkEntry, type DiagRequestRef, DiagnosticsCollector, type DiagnosticsExcludeMatcher, type DiagnosticsInstallOpts, type DiagnosticsPayload, type DiagnosticsSource, type DisplayInfo, ENDPOINT_FROM_ADAPTER, type ElementInfo, type ElementLike, FLOATING_BUTTON_ID, type FeedbackAdapter, type FeedbackConfig, type FeedbackContext, type FeedbackHint, type FeedbackKind, type FeedbackPin, type FeedbackPriority, FeedbackQueue, type FeedbackQueueOpts, type FeedbackReport, type FeedbackScreenshot, type FeedbackStorage, type FeedbackUser, FocusRing, type GetCurrentScreenFn, type GetUserFn, HINT_DISPLAY_DEFAULT, HINT_DISPLAY_MAX, HINT_DISPLAY_MIN, HINT_DRAFT_MAX_CHARS, HINT_FAIL_COOLDOWN_MS, HINT_LABEL_MAX_CHARS, HINT_MAX_ITEMS, HINT_TIMEOUT_MS, HINT_TTL_MS, type HintCacheEntry, type HintCatalog, type HintElementRule, type HintFetchResult, type HintPlatform, HintProvider, type HintProviderOpts, type HintRankInput, type HintScope, type HintSource, KEEPALIVE_BODY_LIMIT_BYTES, LASSO_DEFAULT_ENDPOINT, LOG_BUFFER_LIMIT, type LassoAdapterOpts, type LassoEnvelope, type LassoFetch, type LassoReportContext, type LassoRequestInit, type LassoResponseLike, type LinearIssueInput, MAX_LOG_MESSAGE_CHARS, MAX_QUEUE_AGE_MS, MAX_QUEUE_ITEMS, MODAL_ACTION_ATTACH, MODAL_ACTION_CANCEL, MODAL_ACTION_HINT_TOGGLE, MODAL_ACTION_PICK, MODAL_ACTION_PIN, MODAL_ACTION_REMOVE_SCREENSHOT, MODAL_ACTION_RETRY, MODAL_ACTION_SEND, MODAL_FIELD_COMMENT, MODAL_FIELD_PRIORITY, type ModalQueueLike, type ModalSubmitStatus, NETWORK_BUFFER_LIMIT, type NativeContext, type NotionPageInput, PinController, type PixelPoint, type PixelSize, type QueueStatus, type QueueStatusListener, RATE_LIMIT_MIN_DELAY_MS, REDACTED, ROUTE_TRAIL_KEY, ROUTE_TRAIL_LIMIT, ReportModalController, type ReportModalListener, type ReportModalOpts, type ReportModalState, type ReportParts, type ResolvedConfig, RingBuffer, RouteTrail, type RouteTrailEntry, type RouteTrailOpts, type RouteTrailStore, type RouteWatcher, SCORE_ELEMENT, SCORE_PATH_EXACT, SCORE_PATH_PATTERN, SCREENSHOT_FAILED_MESSAGE, SCREENSHOT_MAX_BASE64_BYTES, SCREENSHOT_QUALITY_STEPS, SOURCE_ATTR, SUBMIT_DONE_MESSAGE, SUBMIT_FAILED_MESSAGE, SUBMIT_PENDING_MESSAGE, type ScreenshotCapture, type ScreenshotOutcome, type ScreenshotReencode, type ScreenshotStatus, type SourceLocation, type SourceMapping, type SubmitOutcome, type SubmitResult, TITLE_MAX_CHARS, type Visibility, type VisibilityEnv, type VisibilityFn, type WebContext, type WebContextInput, WidgetController, type WidgetControllerOpts, type WidgetCorner, type WidgetListener, type WidgetPlatform, type WidgetPosition, type WidgetScreen, type WidgetState, appPathFromNav, buildContext, buildLassoContext, buildLassoEnvelope, buildLinearIssue, buildNotionPage, buildReport, buildTitle, byteLengthOf, canUseKeepalive, captureWithinLimit, createLassoAdapter, defaultBackoff, denormalizePin, detectDevBuild, diagnosticsProviderFor, getOrCreateGuestId, guestUser, hintCharCount, isInternalUser, matchElement, matchPath, normalizePin, normalizeRoutePath, normalizeUser, parseHintCatalog, parseSourceAttr, rankHints, renderReportBody, resolveConfig, resolveContextUser, sanitizeUrl, screenshotBytes, sharedDiagnostics, shouldShowWidget, sourceFromElement, uuidv4 };

package/dist/index.d.ts

@@ -1,3 +1,93 @@
+/** 궤적 상한. 넘으면 오래된 것부터 버린다. */
+declare const ROUTE_TRAIL_LIMIT = 20;
+/** 탭 저장소에 쓰는 키. */
+declare const ROUTE_TRAIL_KEY = "feedback-kit:route-trail";
+/** 궤적 한 줄. */
+interface RouteTrailEntry {
+    /** 그 경로에 **처음 도착한** 시각(epoch ms 정수). 접힘(count)으로는 갱신하지 않는다. */
+    at: number;
+    /** 직전 경로. 버퍼의 첫 항목은 `null`. */
+    from: string | null;
+    /** 도착 경로. */
+    to: string;
+    /** 같은 경로로 연속 이동해 접힌 횟수. 기본 1. */
+    count: number;
+}
+/**
+ * 경로 감시자 주입 계약 — **구독 함수 하나**다.
+ *
+ * 구독하면 **현재 경로를 한 번 흘리고**(마운트 시점의 화면이 궤적의 첫 줄이 된다),
+ * 이후 경로가 바뀔 때마다 새 경로를 넘긴다. 돌려주는 함수를 부르면 구독이 끊긴다.
+ * 뒤로가기·앞으로가기도 이동이므로 함께 흘려야 한다.
+ */
+type RouteWatcher = (onPath: (route: string) => void) => () => void;
+/**
+ * 궤적을 남길 **동기** 저장소. `sessionStorage` 와 같은 모양이라 웹은 그대로 넘기면 된다.
+ *
+ * 코어의 `FeedbackStorage`(Promise)를 쓰지 않는 이유: 이동 직후 새로고침이 일어나면
+ * await 가 끝나기 전에 페이지가 사라져 그 이동이 통째로 유실된다.
+ */
+interface RouteTrailStore {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+interface RouteTrailOpts {
+    /** 탭 단위 저장소. 없으면 메모리로만 동작한다(새로고침에서 끊긴다). */
+    storage?: RouteTrailStore | null;
+    limit?: number;
+    key?: string;
+    now?: () => number;
+}
+/**
+ * 경로에서 쿼리스트링과 해시를 뺀다.
+ *
+ * 값 하나하나를 가려내지 않고 **쿼리를 통째로 버린다** — 그래야 `?token=…` 같은
+ * 자격증명형 파라미터가 애초에 들어올 자리가 없다. 화면 식별에는 경로만으로 충분하다.
+ *
+ * 인자를 `route` 라 부르는 이유: 화면 경로를 가리키는 더 흔한 영어 단어는 라쏘런 봉투가
+ * **요소 선택자**를 부르는 필드명이기도 하다. 그 단어가 코어 본체에 등장하면 경계 검사
+ * (`adapters.test.ts` TC5)가 "코어가 대상 필드명을 안다"로 잡는다 — 검사를 느슨하게
+ * 하는 대신 이쪽 이름을 비켰다.
+ */
+declare function normalizeRoutePath(route: string): string;
+/**
+ * 화면 이동 궤적 버퍼.
+ *
+ * 진단 링버퍼(network·logs)와 다른 점은 **탭 저장소에 남는다**는 것 하나다.
+ * 메모리에만 두면 전체 새로고침 한 번에 궤적이 끊기는데, 정작 재현 절차에
+ * 새로고침이 끼어 있는 제보가 많다.
+ */
+declare class RouteTrail {
+    readonly limit: number;
+    private entries;
+    private storage;
+    private readonly key;
+    private readonly now;
+    private unwatch;
+    constructor(opts?: RouteTrailOpts);
+    /** 감시자를 붙인다. 이미 붙어 있으면 먼저 끊는다(감시자가 둘이면 이동이 두 번 기록된다). */
+    watch(watcher: RouteWatcher): void;
+    /** 감시자를 뗀다. 버퍼 내용은 그대로 남는다. */
+    unwatchRoutes(): void;
+    /**
+     * 이동 하나를 기록한다.
+     *
+     * 같은 경로로 연속 이동하면 새 줄을 만들지 않고 `count` 만 올린다. 판정은 **직전 항목의
+     * `to`** 와 비교한다 — 새로고침 직후 같은 화면에서 다시 시작해도 줄이 늘지 않는다.
+     */
+    record(route: string): void;
+    /** 지금까지의 궤적. 사본이라 이후 이동이 이미 만든 제보를 바꾸지 않는다. */
+    snapshot(): RouteTrailEntry[];
+    get size(): number;
+    /** 버퍼와 저장분을 모두 비운다. */
+    clear(): void;
+    /** 저장소를 나중에 붙인다. 이미 저장돼 있던 궤적이 있으면 그것을 이어받는다. */
+    attachStorage(storage: RouteTrailStore | null): void;
+    private readRaw;
+    private restore;
+    private persist;
+}
+
 /**
  * 힌트가 어디에 뜨는가.
  * `screen`=일반 모달(화면 전체를 묻는 흐름), `element`=요소 지목 모달, `both`=둘 다.
@@ -264,14 +354,19 @@ interface DiagLogEntry {
 /**
  * 제보에 실리는 진단 스냅샷.
  *
- * 두 배열은 **수집기가 실제로 모은 결과**다. 제출 시점에 비어 있는 것은 정상이고
- * (그 세션에 요청·경고가 없었다는 뜻), 배선이 안 됐을 때는 배열이 아니라
+ * 세 배열은 **수집기가 실제로 모은 결과**다. 제출 시점에 비어 있는 것은 정상이고
+ * (그 세션에 요청·경고·이동이 없었다는 뜻), 배선이 안 됐을 때는 배열이 아니라
  * 컨텍스트의 `diagnostics` 자체가 `null`이 된다. 그래서 "빈 배열"과
  * "수집 안 함"이 페이로드에서 구분된다.
  */
 interface DiagnosticsPayload {
     network: DiagNetworkEntry[];
     logs: DiagLogEntry[];
+    /**
+     * 화면 이동 궤적. 감시자를 주입하지 않은 호스트에서는 이것만 비고 나머지는 그대로 모인다
+     * — 궤적이 없다고 진단 전체를 `null` 로 만들지 않는다.
+     */
+    routes: RouteTrailEntry[];
 }
 /** 앱 빌드 정보. 어느 빌드에서 났는지 특정하는 데 쓴다. */
 interface AppInfo {
@@ -711,6 +806,16 @@ interface DiagnosticsInstallOpts {
      * 그게 제보를 덮어 정작 중요한 경고가 묻힌다. 그래서 프로젝트마다 정한다.
      */
     logs?: "problems" | "all" | "off";
+    /**
+     * 화면 이동을 알려주는 감시자. 코어는 `window`·`navigation` 을 보지 않으므로 플랫폼이
+     * 주입한다. 주지 않으면 **궤적만 비고** 네트워크·로그 수집은 그대로 돌아간다.
+     */
+    watchRoutes?: RouteWatcher | null;
+    /**
+     * 궤적을 남길 탭 단위 저장소(웹은 `sessionStorage`). 주지 않으면 메모리로만 동작한다 —
+     * 전체 새로고침에서 궤적이 끊길 뿐, 수집 자체는 계속된다.
+     */
+    routeStorage?: RouteTrailStore | null;
     /** 시각 주입(테스트용). */
     now?: () => number;
     iso?: (n: number) => string;
@@ -718,6 +823,11 @@ interface DiagnosticsInstallOpts {
 declare class DiagnosticsCollector {
     readonly network: RingBuffer<DiagNetworkEntry>;
     readonly logs: RingBuffer<DiagLogEntry>;
+    /**
+     * 화면 이동 궤적. network·logs 와 **같은 스위치(`captureDiagnostics`)** 로 켜고 끈다 —
+     * 별도 설정을 만들지 않는다. 다른 점은 탭 저장소에 남는다는 것 하나다.
+     */
+    readonly routes: RouteTrail;
     private installed;
     private originalFetch;
     private originalXhrOpen;
@@ -742,6 +852,8 @@ declare class DiagnosticsCollector {
         iso?: (n: number) => string;
         networkLimit?: number;
         logLimit?: number;
+        routeLimit?: number;
+        routeStorage?: RouteTrailStore | null;
     });
     /** 위젯이 자신의 로그를 캡처 없이 찍을 때 쓰는 원본 console. */
     readonly originalConsole: {
@@ -758,7 +870,7 @@ declare class DiagnosticsCollector {
      * 반환 배열은 사본이라 이후 수집이 제보 페이로드를 바꾸지 않는다.
      */
     snapshot(): DiagnosticsPayload;
-    /** 두 버퍼를 비운다. */
+    /** 세 버퍼를 비운다. */
     clear(): void;
     /** 실패 사유 한 줄. 예외 객체엔 요청 본문이 들어 있을 수 있어 메시지만, 길이도 자른다. */
     private recordNetwork;
@@ -919,7 +1031,7 @@ declare function isInternalUser(resolved: ResolvedConfig, env: VisibilityEnv): b
 declare function shouldShowWidget(resolved: ResolvedConfig, input?: Partial<VisibilityEnv>): boolean;
 /** `DiagnosticsCollector` 중 설정 배선에 필요한 최소 형태. */
 interface DiagnosticsSource {
-    install(): void;
+    install(opts?: DiagnosticsInstallOpts): void;
     snapshot(): DiagnosticsPayload;
 }
 /**
@@ -929,7 +1041,7 @@ interface DiagnosticsSource {
  * 돌려주는 공급자를 만들면 "수집했는데 아무 일도 없었다"와 "애초에 수집하지 않았다"가
  * 구분되지 않는다. 공급자가 없으면 `buildContext` 가 `diagnostics: null` 을 쓴다.
  */
-declare function diagnosticsProviderFor(resolved: Pick<ResolvedConfig, "captureDiagnostics">, collector: DiagnosticsSource): (() => DiagnosticsPayload) | undefined;
+declare function diagnosticsProviderFor(resolved: Pick<ResolvedConfig, "captureDiagnostics">, collector: DiagnosticsSource, installOpts?: DiagnosticsInstallOpts): (() => DiagnosticsPayload) | undefined;
 
 /** 빌드 플러그인이 심는 속성 이름. `data-` 라서 DOM 이 그대로 통과시킨다. */
 declare const SOURCE_ATTR = "data-fk-source";
@@ -1512,6 +1624,11 @@ interface LassoReportContext {
         device: Record<string, unknown>;
         display: Record<string, unknown>;
     } | null;
+    /**
+     * 화면 이동 궤적(도착 순서). 서버가 `meta` 로 펼치므로 제보를 다시 열었을 때
+     * "어디를 거쳐 여기까지 왔는지"를 읽을 수 있다. 감시자가 없으면 빈 배열이다.
+     */
+    routes: RouteTrailEntry[];
     /** 호스트가 넣은 자유 메타. 우리가 해석하지 않는다. */
     extra: Record<string, unknown>;
 }
@@ -1737,4 +1854,4 @@ declare function parseHintCatalog(raw: unknown): HintCatalog | null;
  */
 declare function rankHints(hints: readonly FeedbackHint[], input: HintRankInput, limit: number): FeedbackHint[];
 
-export { type AdapterName, type AppInfo, BACKOFF_BASE_MS, BACKOFF_MAX_MS, type BuildContextOpts, type BuildReportOpts, COMMENT_MAX_CHARS, COMMENT_REQUIRED_MESSAGE, COMMENT_TOO_LONG_MESSAGE, type CaptureWithinLimitOpts, type ConfigWarning, type ConfigWarningCode, type ContextProviders, type ContextUser, DEFAULT_ADAPTER, DEFAULT_INTERNAL_ROLES, DEFAULT_POSITION, type DeviceInfo, type DiagLogEntry, type DiagNetworkEntry, type DiagRequestRef, DiagnosticsCollector, type DiagnosticsExcludeMatcher, type DiagnosticsInstallOpts, type DiagnosticsPayload, type DiagnosticsSource, type DisplayInfo, ENDPOINT_FROM_ADAPTER, type ElementInfo, type ElementLike, FLOATING_BUTTON_ID, type FeedbackAdapter, type FeedbackConfig, type FeedbackContext, type FeedbackHint, type FeedbackKind, type FeedbackPin, type FeedbackPriority, FeedbackQueue, type FeedbackQueueOpts, type FeedbackReport, type FeedbackScreenshot, type FeedbackStorage, type FeedbackUser, FocusRing, type GetCurrentScreenFn, type GetUserFn, HINT_DISPLAY_DEFAULT, HINT_DISPLAY_MAX, HINT_DISPLAY_MIN, HINT_DRAFT_MAX_CHARS, HINT_FAIL_COOLDOWN_MS, HINT_LABEL_MAX_CHARS, HINT_MAX_ITEMS, HINT_TIMEOUT_MS, HINT_TTL_MS, type HintCacheEntry, type HintCatalog, type HintElementRule, type HintFetchResult, type HintPlatform, HintProvider, type HintProviderOpts, type HintRankInput, type HintScope, type HintSource, KEEPALIVE_BODY_LIMIT_BYTES, LASSO_DEFAULT_ENDPOINT, LOG_BUFFER_LIMIT, type LassoAdapterOpts, type LassoEnvelope, type LassoFetch, type LassoReportContext, type LassoRequestInit, type LassoResponseLike, type LinearIssueInput, MAX_LOG_MESSAGE_CHARS, MAX_QUEUE_AGE_MS, MAX_QUEUE_ITEMS, MODAL_ACTION_ATTACH, MODAL_ACTION_CANCEL, MODAL_ACTION_HINT_TOGGLE, MODAL_ACTION_PICK, MODAL_ACTION_PIN, MODAL_ACTION_REMOVE_SCREENSHOT, MODAL_ACTION_RETRY, MODAL_ACTION_SEND, MODAL_FIELD_COMMENT, MODAL_FIELD_PRIORITY, type ModalQueueLike, type ModalSubmitStatus, NETWORK_BUFFER_LIMIT, type NativeContext, type NotionPageInput, PinController, type PixelPoint, type PixelSize, type QueueStatus, type QueueStatusListener, RATE_LIMIT_MIN_DELAY_MS, REDACTED, ReportModalController, type ReportModalListener, type ReportModalOpts, type ReportModalState, type ReportParts, type ResolvedConfig, RingBuffer, SCORE_ELEMENT, SCORE_PATH_EXACT, SCORE_PATH_PATTERN, SCREENSHOT_FAILED_MESSAGE, SCREENSHOT_MAX_BASE64_BYTES, SCREENSHOT_QUALITY_STEPS, SOURCE_ATTR, SUBMIT_DONE_MESSAGE, SUBMIT_FAILED_MESSAGE, SUBMIT_PENDING_MESSAGE, type ScreenshotCapture, type ScreenshotOutcome, type ScreenshotReencode, type ScreenshotStatus, type SourceLocation, type SourceMapping, type SubmitOutcome, type SubmitResult, TITLE_MAX_CHARS, type Visibility, type VisibilityEnv, type VisibilityFn, type WebContext, type WebContextInput, WidgetController, type WidgetControllerOpts, type WidgetCorner, type WidgetListener, type WidgetPlatform, type WidgetPosition, type WidgetScreen, type WidgetState, appPathFromNav, buildContext, buildLassoContext, buildLassoEnvelope, buildLinearIssue, buildNotionPage, buildReport, buildTitle, byteLengthOf, canUseKeepalive, captureWithinLimit, createLassoAdapter, defaultBackoff, denormalizePin, detectDevBuild, diagnosticsProviderFor, getOrCreateGuestId, guestUser, hintCharCount, isInternalUser, matchElement, matchPath, normalizePin, normalizeUser, parseHintCatalog, parseSourceAttr, rankHints, renderReportBody, resolveConfig, resolveContextUser, sanitizeUrl, screenshotBytes, sharedDiagnostics, shouldShowWidget, sourceFromElement, uuidv4 };
+export { type AdapterName, type AppInfo, BACKOFF_BASE_MS, BACKOFF_MAX_MS, type BuildContextOpts, type BuildReportOpts, COMMENT_MAX_CHARS, COMMENT_REQUIRED_MESSAGE, COMMENT_TOO_LONG_MESSAGE, type CaptureWithinLimitOpts, type ConfigWarning, type ConfigWarningCode, type ContextProviders, type ContextUser, DEFAULT_ADAPTER, DEFAULT_INTERNAL_ROLES, DEFAULT_POSITION, type DeviceInfo, type DiagLogEntry, type DiagNetworkEntry, type DiagRequestRef, DiagnosticsCollector, type DiagnosticsExcludeMatcher, type DiagnosticsInstallOpts, type DiagnosticsPayload, type DiagnosticsSource, type DisplayInfo, ENDPOINT_FROM_ADAPTER, type ElementInfo, type ElementLike, FLOATING_BUTTON_ID, type FeedbackAdapter, type FeedbackConfig, type FeedbackContext, type FeedbackHint, type FeedbackKind, type FeedbackPin, type FeedbackPriority, FeedbackQueue, type FeedbackQueueOpts, type FeedbackReport, type FeedbackScreenshot, type FeedbackStorage, type FeedbackUser, FocusRing, type GetCurrentScreenFn, type GetUserFn, HINT_DISPLAY_DEFAULT, HINT_DISPLAY_MAX, HINT_DISPLAY_MIN, HINT_DRAFT_MAX_CHARS, HINT_FAIL_COOLDOWN_MS, HINT_LABEL_MAX_CHARS, HINT_MAX_ITEMS, HINT_TIMEOUT_MS, HINT_TTL_MS, type HintCacheEntry, type HintCatalog, type HintElementRule, type HintFetchResult, type HintPlatform, HintProvider, type HintProviderOpts, type HintRankInput, type HintScope, type HintSource, KEEPALIVE_BODY_LIMIT_BYTES, LASSO_DEFAULT_ENDPOINT, LOG_BUFFER_LIMIT, type LassoAdapterOpts, type LassoEnvelope, type LassoFetch, type LassoReportContext, type LassoRequestInit, type LassoResponseLike, type LinearIssueInput, MAX_LOG_MESSAGE_CHARS, MAX_QUEUE_AGE_MS, MAX_QUEUE_ITEMS, MODAL_ACTION_ATTACH, MODAL_ACTION_CANCEL, MODAL_ACTION_HINT_TOGGLE, MODAL_ACTION_PICK, MODAL_ACTION_PIN, MODAL_ACTION_REMOVE_SCREENSHOT, MODAL_ACTION_RETRY, MODAL_ACTION_SEND, MODAL_FIELD_COMMENT, MODAL_FIELD_PRIORITY, type ModalQueueLike, type ModalSubmitStatus, NETWORK_BUFFER_LIMIT, type NativeContext, type NotionPageInput, PinController, type PixelPoint, type PixelSize, type QueueStatus, type QueueStatusListener, RATE_LIMIT_MIN_DELAY_MS, REDACTED, ROUTE_TRAIL_KEY, ROUTE_TRAIL_LIMIT, ReportModalController, type ReportModalListener, type ReportModalOpts, type ReportModalState, type ReportParts, type ResolvedConfig, RingBuffer, RouteTrail, type RouteTrailEntry, type RouteTrailOpts, type RouteTrailStore, type RouteWatcher, SCORE_ELEMENT, SCORE_PATH_EXACT, SCORE_PATH_PATTERN, SCREENSHOT_FAILED_MESSAGE, SCREENSHOT_MAX_BASE64_BYTES, SCREENSHOT_QUALITY_STEPS, SOURCE_ATTR, SUBMIT_DONE_MESSAGE, SUBMIT_FAILED_MESSAGE, SUBMIT_PENDING_MESSAGE, type ScreenshotCapture, type ScreenshotOutcome, type ScreenshotReencode, type ScreenshotStatus, type SourceLocation, type SourceMapping, type SubmitOutcome, type SubmitResult, TITLE_MAX_CHARS, type Visibility, type VisibilityEnv, type VisibilityFn, type WebContext, type WebContextInput, WidgetController, type WidgetControllerOpts, type WidgetCorner, type WidgetListener, type WidgetPlatform, type WidgetPosition, type WidgetScreen, type WidgetState, appPathFromNav, buildContext, buildLassoContext, buildLassoEnvelope, buildLinearIssue, buildNotionPage, buildReport, buildTitle, byteLengthOf, canUseKeepalive, captureWithinLimit, createLassoAdapter, defaultBackoff, denormalizePin, detectDevBuild, diagnosticsProviderFor, getOrCreateGuestId, guestUser, hintCharCount, isInternalUser, matchElement, matchPath, normalizePin, normalizeRoutePath, normalizeUser, parseHintCatalog, parseSourceAttr, rankHints, renderReportBody, resolveConfig, resolveContextUser, sanitizeUrl, screenshotBytes, sharedDiagnostics, shouldShowWidget, sourceFromElement, uuidv4 };

package/dist/index.js

@@ -151,6 +151,7 @@ function normalizeDiagnostics(snap) {
   if (!snap || !Array.isArray(snap.network) || !Array.isArray(snap.logs)) {
     return null;
   }
+  if (!Array.isArray(snap.routes)) return { ...snap, routes: [] };
   return snap;
 }
 function safeCall(fn, fallback) {
@@ -625,6 +626,130 @@ var RingBuffer = class {
   }
 };
 
+// src/route-trail.ts
+var ROUTE_TRAIL_LIMIT = 20;
+var ROUTE_TRAIL_KEY = "feedback-kit:route-trail";
+function normalizeRoutePath(route) {
+  const raw = typeof route === "string" ? route : "";
+  const cut = [raw.indexOf("?"), raw.indexOf("#")].filter((i) => i >= 0);
+  const trimmed = (cut.length > 0 ? raw.slice(0, Math.min(...cut)) : raw).trim();
+  return trimmed.length > 0 ? trimmed : "/";
+}
+function parseEntries(raw) {
+  if (!raw) return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return [];
+  }
+  if (!Array.isArray(parsed)) return [];
+  const out = [];
+  for (const item of parsed) {
+    if (typeof item !== "object" || item === null) continue;
+    const e = item;
+    if (typeof e.to !== "string" || typeof e.at !== "number") continue;
+    out.push({
+      at: e.at,
+      from: typeof e.from === "string" ? e.from : null,
+      to: e.to,
+      count: typeof e.count === "number" && e.count > 0 ? Math.floor(e.count) : 1
+    });
+  }
+  return out;
+}
+var RouteTrail = class {
+  constructor(opts = {}) {
+    this.entries = [];
+    this.unwatch = null;
+    this.limit = opts.limit !== void 0 && opts.limit > 0 ? Math.floor(opts.limit) : ROUTE_TRAIL_LIMIT;
+    this.key = opts.key ?? ROUTE_TRAIL_KEY;
+    this.now = opts.now ?? (() => Date.now());
+    this.storage = opts.storage ?? null;
+    this.restore();
+  }
+  /** 감시자를 붙인다. 이미 붙어 있으면 먼저 끊는다(감시자가 둘이면 이동이 두 번 기록된다). */
+  watch(watcher) {
+    this.unwatchRoutes();
+    try {
+      this.unwatch = watcher((route) => this.record(route));
+    } catch {
+      this.unwatch = null;
+    }
+  }
+  /** 감시자를 뗀다. 버퍼 내용은 그대로 남는다. */
+  unwatchRoutes() {
+    if (!this.unwatch) return;
+    const off = this.unwatch;
+    this.unwatch = null;
+    try {
+      off();
+    } catch {
+    }
+  }
+  /**
+   * 이동 하나를 기록한다.
+   *
+   * 같은 경로로 연속 이동하면 새 줄을 만들지 않고 `count` 만 올린다. 판정은 **직전 항목의
+   * `to`** 와 비교한다 — 새로고침 직후 같은 화면에서 다시 시작해도 줄이 늘지 않는다.
+   */
+  record(route) {
+    const to = normalizeRoutePath(route);
+    const last = this.entries[this.entries.length - 1];
+    if (last && last.to === to) {
+      last.count += 1;
+    } else {
+      this.entries.push({ at: this.now(), from: last ? last.to : null, to, count: 1 });
+      const overflow = this.entries.length - this.limit;
+      if (overflow > 0) this.entries.splice(0, overflow);
+    }
+    this.persist();
+  }
+  /** 지금까지의 궤적. 사본이라 이후 이동이 이미 만든 제보를 바꾸지 않는다. */
+  snapshot() {
+    return this.entries.map((e) => ({ ...e }));
+  }
+  get size() {
+    return this.entries.length;
+  }
+  /** 버퍼와 저장분을 모두 비운다. */
+  clear() {
+    this.entries = [];
+    this.persist();
+  }
+  /** 저장소를 나중에 붙인다. 이미 저장돼 있던 궤적이 있으면 그것을 이어받는다. */
+  attachStorage(storage) {
+    this.storage = storage;
+    if (!storage) return;
+    const restored = parseEntries(this.readRaw());
+    if (restored.length > 0) {
+      this.entries = [...restored, ...this.entries].slice(-this.limit);
+    }
+    this.persist();
+  }
+  // ── 내부: 저장소 ──────────────────────────────────────────
+  // 저장은 **거들 뿐**이다. 던지면 이동 한 번에 앱이 죽는다(프라이빗 모드 등에서
+  // getItem/setItem 이 실제로 던진다). 그래서 전부 삼키고 메모리로 계속 간다.
+  readRaw() {
+    if (!this.storage) return null;
+    try {
+      return this.storage.getItem(this.key);
+    } catch {
+      return null;
+    }
+  }
+  restore() {
+    this.entries = parseEntries(this.readRaw()).slice(-this.limit);
+  }
+  persist() {
+    if (!this.storage) return;
+    try {
+      this.storage.setItem(this.key, JSON.stringify(this.entries));
+    } catch {
+    }
+  }
+};
+
 // src/diagnostics.ts
 var NETWORK_BUFFER_LIMIT = 30;
 var LOG_BUFFER_LIMIT = 50;
@@ -671,6 +796,11 @@ var DiagnosticsCollector = class {
       opts.networkLimit ?? NETWORK_BUFFER_LIMIT
     );
     this.logs = new RingBuffer(opts.logLimit ?? LOG_BUFFER_LIMIT);
+    this.routes = new RouteTrail({
+      limit: opts.routeLimit ?? ROUTE_TRAIL_LIMIT,
+      storage: opts.routeStorage ?? null,
+      now: () => this.now()
+    });
   }
   /** 글로벌 fetch/XHR/console 을 패치한다. 이미 설치했으면 no-op. */
   install(opts = {}) {
@@ -683,6 +813,8 @@ var DiagnosticsCollector = class {
     this.patchFetch();
     this.patchXhr();
     this.patchConsole();
+    if (opts.routeStorage !== void 0) this.routes.attachStorage(opts.routeStorage);
+    if (opts.watchRoutes) this.routes.watch(opts.watchRoutes);
   }
   /** 글로벌 패치를 모두 원복한다. 버퍼 내용은 그대로 남는다. */
   uninstall() {
@@ -709,18 +841,24 @@ var DiagnosticsCollector = class {
     this.originalLog = null;
     this.excludeMatcher = null;
     this.fetchDepth = 0;
+    this.routes.unwatchRoutes();
   }
   /**
    * 지금까지 모인 것을 그대로 스냅샷으로 낸다.
    * 반환 배열은 사본이라 이후 수집이 제보 페이로드를 바꾸지 않는다.
    */
   snapshot() {
-    return { network: this.network.toArray(), logs: this.logs.toArray() };
+    return {
+      network: this.network.toArray(),
+      logs: this.logs.toArray(),
+      routes: this.routes.snapshot()
+    };
   }
-  /** 두 버퍼를 비운다. */
+  /** 세 버퍼를 비운다. */
   clear() {
     this.network.clear();
     this.logs.clear();
+    this.routes.clear();
   }
   // ── 내부: 기록 ────────────────────────────────────────────
   /** 실패 사유 한 줄. 예외 객체엔 요청 본문이 들어 있을 수 있어 메시지만, 길이도 자른다. */
@@ -1125,9 +1263,9 @@ function shouldShowWidget(resolved, input = {}) {
     return false;
   }
 }
-function diagnosticsProviderFor(resolved, collector) {
+function diagnosticsProviderFor(resolved, collector, installOpts) {
   if (!resolved.captureDiagnostics) return void 0;
-  collector.install();
+  collector.install(installOpts);
   return () => collector.snapshot();
 }
 
@@ -2277,6 +2415,9 @@ function buildLassoContext(report) {
       device: { ...c.native.device },
       display: { ...c.native.display }
     } : null,
+    // 미수집(진단 자체가 null)과 "이동이 없었음"을 굳이 나누지 않는다 — 둘 다 빈 배열.
+    // 나누려면 서버가 null 을 보존해야 하는데, 그건 확인된 계약이 아니다.
+    routes: [...c.diagnostics?.routes ?? []],
     extra: c.extra
   };
 }
@@ -2940,8 +3081,11 @@ export {
   PinController,
   RATE_LIMIT_MIN_DELAY_MS,
   REDACTED,
+  ROUTE_TRAIL_KEY,
+  ROUTE_TRAIL_LIMIT,
   ReportModalController,
   RingBuffer,
+  RouteTrail,
   SCORE_ELEMENT,
   SCORE_PATH_EXACT,
   SCORE_PATH_PATTERN,
@@ -2977,6 +3121,7 @@ export {
   matchElement,
   matchPath,
   normalizePin,
+  normalizeRoutePath,
   normalizeUser,
   parseHintCatalog,
   parseSourceAttr,