dsh-file-activity 0.5.7 → 0.5.9

package/lib/store.js

@@ -1,85 +1,258 @@
 /**
  * Store lifecycle for file activity: async state load with buffering of
- * records that arrive before it completes, debounced atomic persistence
- * (tmp+rename) and a teardown flush. The exposed store object carries a live
- * `state` reference so route handlers always read the current document.
+ * records that arrive before it completes, incremental JSON Lines persistence
+ * (append + threshold compact; issue #197) and a teardown flush. The exposed
+ * store object carries a live `state` reference so route handlers always read
+ * the current document.
+ */
+import { createState, foldRecord, loadState, mapOp, stateFile } from './state.js';
+import { createPersist, readAppenderStats } from './persist.js';
+import { emptyEvicted, enforceQuota, normalizeLimits, } from './quota.js';
+import { statSync } from 'node:fs';
+/** compact 触发下限：快照成本必须远小于触发区间的事件流字节（写放大 ≤ 1.6 的关键）。 */
+const MIN_COMPACT_LINES = 20000;
+/** compact 触发行上限（文件大小上界 ≈ 上限行字节 + 快照字节）。 */
+const MAX_COMPACT_LINES = 60000;
+/** 事件行平均字节（保守估计；用于把快照字节折算成"应当攒多少行再 compact"）。 */
+const AVG_EVENT_BYTES = 80;
+/**
+ * 自适应 compact 行阈值：快照越大，攒的事件行越多才 compact ——
+ * 目标让单次 compact 的快照成本 ≤ 触发区间事件流字节的 ~10%。
+ */
+function compactLinesFor(stateBytes) {
+    const scaled = Math.ceil((stateBytes * 12) / AVG_EVENT_BYTES);
+    return Math.min(MAX_COMPACT_LINES, Math.max(MIN_COMPACT_LINES, scaled));
+}
+/** Build the per-apply store: { state, record, schedulePersist, stats, dispose }. */
+export function createStore(ctx, deps = {}) {
+    const limits = normalizeLimits(deps.limits);
+    const store = {
+        state: createState(),
+        record: () => false,
+        schedulePersist: () => { },
+        stats: () => zeroStats(limits),
+        dispose: () => { },
+    };
+    const handle = {
+        ctx,
+        file: stateFile(),
+        store,
+        pending: [],
+        ready: false,
+        limits,
+        evicted: emptyEvicted(),
+        facts: [],
+        flushTimer: null,
+        persist: null,
+        dirtyChain: Promise.resolve(),
+        compactLines: deps.compactLines ?? MIN_COMPACT_LINES,
+        compactedEvents: 0,
+        compactLinesFixed: deps.compactLines !== undefined,
+    };
+    handle.persist = createPersist({
+        file: handle.file,
+        ctx,
+        factory: deps.appender,
+        flushMs: deps.flushMs,
+        // 内部阈值禁用：compact 完全由本层按「快照字节 / 事件字节」预算调度。
+        compactLines: Number.MAX_SAFE_INTEGER,
+    }, () => handle.store.state);
+    store.record = (sessionId, path, op, time) => record(handle, sessionId, path, op, time);
+    store.schedulePersist = () => enqueueFlush(handle, true);
+    store.stats = () => snapshotStats(handle);
+    store.dispose = () => dispose(handle);
+    void loadState(handle.file, limits, ctx.logger).then((loaded) => onLoaded(handle, loaded));
+    return store;
+}
+/** 空统计（加载完成前）。 */
+function zeroStats(limits) {
+    return {
+        bytesWritten: 0,
+        writes: 0,
+        persistEvents: 0,
+        fileBytes: 0,
+        evictedSessions: 0,
+        evictedPaths: 0,
+        evictedPathsTotal: 0,
+        maxSessions: limits.maxSessions,
+        maxPathsPerSession: limits.maxPathsPerSession,
+        maxPathsTotal: limits.maxPathsTotal,
+        pathCount: 0,
+    };
+}
+/** 当前资源统计（落盘字节 + 淘汰计数 + 上限，供资源冒烟/看门狗读取）。 */
+function snapshotStats(handle) {
+    const persist = handle.persist;
+    const ioStats = persist === null ? { bytesWritten: 0, writes: 0, events: 0 } : readAppenderStats(persist.appender);
+    return {
+        bytesWritten: ioStats.bytesWritten,
+        writes: ioStats.writes,
+        persistEvents: ioStats.events,
+        fileBytes: fileBytesOf(handle.file),
+        evictedSessions: handle.evicted.sessions,
+        evictedPaths: handle.evicted.paths,
+        evictedPathsTotal: handle.evicted.pathsTotal,
+        maxSessions: handle.limits.maxSessions,
+        maxPathsPerSession: handle.limits.maxPathsPerSession,
+        maxPathsTotal: handle.limits.maxPathsTotal,
+        pathCount: countPaths(handle.store.state),
+    };
+}
+/** 状态文件当前字节数（不存在返回 0）。 */
+function fileBytesOf(file) {
+    try {
+        return statSync(file).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/** 全局路径总数（内存有界断言口径）。 */
+function countPaths(state) {
+    let total = 0;
+    for (const session of Object.values(state.sessions))
+        total += Object.keys(session.counts).length;
+    return total;
+}
+/** 把淘汰计数合并进 state.stats（state 是落盘真相，两者必须一致）。 */
+function mergeEvicted(state, evicted) {
+    state.stats.evicted = { sessions: evicted.sessions, paths: evicted.paths, pathsTotal: evicted.pathsTotal };
+}
+/**
+ * State loaded: mark ready, drain buffered records, then rewrite the file in
+ * the JSON Lines format when anything changed — trimmed (caps/old history) or
+ * legacy (升级前的单行全量 JSON 快照). 只读不写的“纯加载”不产生任何写盘。
  */
-import { atomicWriteJson } from 'dsh-shared'
-import { applyRecord, createState, loadState, mapOp, stateFile, trimLoadedState } from './state.js'
-
-/** Build the per-apply store: { state, record, schedulePersist, dispose }. */
-export function createStore(ctx) {
-  const store = { state: createState() }
-  const handle = {
-    ctx,
-    file: stateFile(),
-    store,
-    pending: [],
-    ready: false,
-    persistTimer: null,
-    dirtyChain: Promise.resolve(),
-  }
-  handle.persistNow = () => persistNow(handle)
-  handle.persistSoon = () => persistSoon(handle)
-  store.record = (sessionId, path, op, time) => record(handle, sessionId, path, op, time)
-  store.schedulePersist = () => persistSoon(handle)
-  store.dispose = () => dispose(handle)
-  void loadState(handle.file).then((loaded) => onLoaded(handle, loaded))
-  return store
-}
-
-/** Write the current state atomically (serialized through dirtyChain). */
-function persistNow(handle) {
-  handle.dirtyChain = handle.dirtyChain
-    .then(() => atomicWriteJson(handle.file, handle.store.state, handle.ctx.logger, '[dsh-file-activity]'))
-    .catch(() => {})
-}
-
-/** Debounced (500ms) schedule of a persist. */
-function persistSoon(handle) {
-  if (handle.persistTimer !== null) return
-  handle.persistTimer = setTimeout(() => {
-    handle.persistTimer = null
-    persistNow(handle)
-  }, 500)
-}
-
-/** State loaded: normalize/trim, mark ready, drain buffered records. */
 function onLoaded(handle, loaded) {
-  const result = trimLoadedState(loaded)
-  handle.store.state = result.state
-  handle.ready = true
-  if (drainPending(handle) || result.trimmed) persistSoon(handle)
+    handle.store.state = loaded.state;
+    handle.evicted = { ...loaded.evicted };
+    mergeEvicted(handle.store.state, handle.evicted);
+    handle.ready = true;
+    const drained = drainPending(handle);
+    if (drained || loaded.trimmed || loaded.legacy) {
+        flushFacts(handle);
+        schedulePersist(handle);
+    }
 }
-
-/** Apply every record buffered before the state load finished. */
+/** Apply every record buffered before the state load finished (deferred flush). */
 function drainPending(handle) {
-  const drained = handle.pending.splice(0)
-  for (const item of drained) {
-    applyRecord(handle.store.state, item.sessionId, item.path, mapOp(item.op), item.time)
-  }
-  return drained.length > 0
-}
-
-/** Record an operation once state is loaded (buffered before that). */
+    const drained = handle.pending.splice(0);
+    if (drained.length === 0)
+        return false;
+    handle.ready = false;
+    for (const item of drained) {
+        const fact = applyToState(handle, item.sessionId, mapOp(item.op), item.path, item.time);
+        if (fact !== null)
+            handle.facts.push(fact);
+    }
+    handle.ready = true;
+    return true;
+}
+/** 记录一条操作（状态未就绪时缓冲；非法记录不入内存）。 */
 function record(handle, sessionId, path, op, time) {
-  if (!handle.ready) {
-    handle.pending.push({ sessionId, path, op, time })
-    return true
-  }
-  if (applyRecord(handle.store.state, sessionId, path, op, time)) {
-    persistSoon(handle)
-    return true
-  }
-  return false
-}
-
-/** Tear down on unload: flush pending persistence. */
+    if (!handle.ready) {
+        handle.pending.push({ sessionId, path, op, time });
+        return true;
+    }
+    const fact = applyToState(handle, sessionId, mapOp(op), path, time);
+    if (fact === null)
+        return false;
+    handle.facts.push(fact);
+    enqueueFlush(handle, false);
+    return true;
+}
+/** 应用一条记录到内存态并执行入口配额（非法记录返回 null）。 */
+function applyToState(handle, sessionId, op, path, time) {
+    const folded = foldRecord(handle.store.state, sessionId, path, op, time);
+    if (folded === null)
+        return null;
+    // 配额只在「新增条目」时可能被突破：命中已记录路径/删除不触发扫描（热路径 O(1)）。
+    if (!folded.created && !folded.newPath)
+        return { sessionId, path, op, time: typeof time === 'number' ? time : Date.now() };
+    const before = handle.evicted;
+    const evicted = emptyEvicted();
+    enforceQuota(handle.store.state, sessionId, handle.limits, evicted, handle.ctx.logger);
+    if (evicted.sessions + evicted.paths + evicted.pathsTotal > 0) {
+        handle.evicted = {
+            sessions: before.sessions + evicted.sessions,
+            paths: before.paths + evicted.paths,
+            pathsTotal: before.pathsTotal + evicted.pathsTotal,
+        };
+        mergeEvicted(handle.store.state, handle.evicted);
+    }
+    return { sessionId, path, op, time: typeof time === 'number' ? time : Date.now() };
+}
+/** 防抖排空：窗口内所有事件合并成一次 appendFile（写放大 ≤ 1 + 小系数）。 */
+function enqueueFlush(handle, immediate) {
+    if (immediate) {
+        flushFacts(handle);
+        return;
+    }
+    if (handle.flushTimer !== null)
+        return;
+    handle.flushTimer = setTimeout(() => {
+        handle.flushTimer = null;
+        flushFacts(handle);
+    }, 500);
+}
+/** 把挂起记录以 JSON Lines 增量追加落盘（O(事件字节)）。 */
+function flushFacts(handle) {
+    if (handle.flushTimer !== null) {
+        clearTimeout(handle.flushTimer);
+        handle.flushTimer = null;
+    }
+    const persist = handle.persist;
+    const facts = handle.facts.splice(0);
+    if (persist === null || facts.length === 0)
+        return;
+    for (const fact of facts)
+        persist.append(fact);
+    handle.dirtyChain = handle.dirtyChain.then(() => persist.flush()).catch(() => { });
+    maybeCompact(handle);
+}
+/**
+ * 预算驱动的 compact：累计追加行数达到阈值时原子快照一次（文件大小有界），
+ * 阈值随快照体积自适应 —— 保证 compact 写入摊薄到足够多的事件行上。
+ */
+function maybeCompact(handle) {
+    const persist = handle.persist;
+    if (persist === null)
+        return;
+    const total = readAppenderStats(persist.appender).events;
+    if (total - handle.compactedEvents < handle.compactLines)
+        return;
+    handle.compactedEvents = total;
+    handle.dirtyChain = handle.dirtyChain
+        .then(() => persist.compact(handle.store.state))
+        .then(() => {
+        if (handle.compactLinesFixed)
+            return;
+        handle.compactLines = compactLinesFor(Buffer.byteLength(JSON.stringify(handle.store.state)));
+    })
+        .catch(() => { });
+}
+/** 显式调度（schedulePersist：行冲刷 + 原子快照，文件大小有界）。 */
+function schedulePersist(handle) {
+    const persist = handle.persist;
+    if (persist === null)
+        return;
+    flushFacts(handle);
+    handle.dirtyChain = handle.dirtyChain.then(() => persist.compact(handle.store.state)).catch(() => { });
+}
+/** Tear down on unload: flush pending lines + compact once (memory = truth). */
 function dispose(handle) {
-  if (handle.persistTimer !== null) {
-    clearTimeout(handle.persistTimer)
-    handle.persistTimer = null
-  }
-  persistNow(handle)
-  void handle.dirtyChain
+    if (handle.flushTimer !== null) {
+        clearTimeout(handle.flushTimer);
+        handle.flushTimer = null;
+    }
+    const persist = handle.persist;
+    if (persist === null)
+        return;
+    for (const fact of handle.facts.splice(0))
+        persist.append(fact);
+    handle.dirtyChain = handle.dirtyChain
+        .then(() => persist.flush())
+        .then(() => persist.dispose())
+        .then(() => persist.compact(handle.store.state))
+        .catch(() => { });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-file-activity",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "DSH 侧边栏文件活动插件：按 LRU 记录文件读取/新增/修改事件（最近访问），按绝对路径树形统计（文件统计），点击文件浮窗预览（代码高亮/Markdown/图片/PDF）。DSH web plugin: file activity tracker — LRU recent-access list plus per-file read/create/modify counts in a folder tree, with floating preview.",
   "type": "module",
   "main": "lib/index.js",
@@ -12,7 +12,8 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "node scripts/build.mjs",
+    "build": "npx tsc -p tsconfig.json && node scripts/build.mjs",
+    "typecheck": "npx tsc --noEmit -p tsconfig.json && npx tsc --noEmit -p tsconfig.client.json",
     "test": "npx vitest run --coverage && cucumber-js test/features --import 'test/features/steps/*.mjs'"
   },
   "exports": {
@@ -41,17 +42,20 @@
     }
   },
   "dependencies": {
-    "dsh-better-sidebar": ">=0.14.0",
-    "dsh-shared": "^0.1.0"
+    "dsh-shared": "^0.1.4"
   },
   "peerDependencies": {
-    "cordis": "^4.0.0-rc.8",
-    "react": "^18.2.0 || ^19.2.0"
+    "cordis": "^4.0.0-rc.10",
+    "react": "^18.2.0 || ^19.3.0"
   },
   "peerDependenciesMeta": {
     "cordis": {
       "optional": true
     }
   },
+  "devDependencies": {
+    "@types/node": "^26.5.1",
+    "typescript": "^7.0.2"
+  },
   "license": "MIT"
 }

package/lib/parts/preview.part.js

@@ -1,308 +0,0 @@
-// ── floating preview window (reuses the sidebar's native viewer) ──────
-/** Resolve a possibly-relative path against the session cwd. */
-function resolvePath(path, cwd) {
-  if (typeof path !== 'string' || path === '') return path
-  if (path.startsWith('/')) return path
-  if (typeof cwd === 'string' && cwd !== '') return `${cwd.replace(/\/+$/, '')}/${path}`
-  return path
-}
-
-/** Whether the fs.read API response carries a text content payload. */
-function isFsReadOk(json) {
-  return json !== null && typeof json === 'object' && json.ok === true && typeof json.value?.content === 'string'
-}
-
-/** Error load state from an fs.read API response (or a generic message).
- *  Raw system errors are translated to friendly, locale-aware messages
- *  (issue #68): deleted files and workspace-fenced paths must never surface
- *  ENOENT / "is outside workspace" verbatim. */
-function fsReadError(json, viewer) {
-  const raw = json?.error?.message ?? ''
-  let message
-  if (raw === '') message = strings.previewFailed()
-  else if (/ENOENT|no such file|does not exist|cannot resolve/i.test(raw)) message = strings.fileMissing()
-  else if (/outside workspace/i.test(raw)) message = strings.fileOutside()
-  else message = raw
-  return { status: 'error', viewer, message }
-}
-
-/** Milliseconds after which an error-state preview closes itself (issue #76):
- *  a shell that failed to load any content is useless, so it must not linger
- *  over the main UI until the user finds the × button. */
-const AUTO_CLOSE_MS = 2500
-
-/** Whether a pointerdown target lies inside the floating window. The window
- *  surface carries the `.dfa-fp` class; anything else counts as "outside"
- *  and dismisses the preview (issue #76 — click anywhere outside closes). */
-function isInsideFloating(target) {
-  if (!target || typeof target.closest !== 'function') return false
-  return target.closest('.dfa-fp') !== null
-}
-
-/** Click behavior for the window surface: in the error state ANY click
- *  closes the shell (there is no content to interact with), otherwise the
- *  click is swallowed so the viewer's own interactions keep working. */
-function previewClickAction(load, event) {
-  if (load.status === 'error') return 'close'
-  if (event && event.stopPropagation) event.stopPropagation()
-  return 'stop'
-}
-
-/** Close the floating preview when the tab goes hidden (switching tabs /
- *  operating the main UI), so it never lingers over the interface. */
-function closePreviewOnHidden(visible, dataStore) {
-  if (!visible) dataStore.set({ preview: null })
-}
-
-/**
- * Load fsRead content through the sidebar API and resolve the viewer's
- * load state (ready with text, or error with the API message). When the
- * sidebar refuses a recorded path (its workspace fence, e.g. agent-read
- * files under ~/.dsh), fall back to the plugin's own text route, which
- * authorizes exactly the paths this session recorded (issue #68).
- */
-async function loadFsReadContent(viewer, path, scope, sessionId) {
-  const target = resolvePath(path, scope?.cwd ?? '')
-  const response = await fetch('/sidebar/api/fs.read', {
-    method: 'POST',
-    headers: { 'content-type': 'application/json' },
-    body: JSON.stringify({ sessionId, path: target }),
-  })
-  const json = await response.json()
-  if (isFsReadOk(json)) return { status: 'ready', viewer, content: json.value.content }
-  // The sidebar refused — try OUR recorded-path text route before giving up.
-  const textJson = await fetchTextContent(sessionId, path)
-  if (isFsReadOk(textJson)) return { status: 'ready', viewer, content: textJson.value.content }
-  return fsReadError(json, viewer)
-}
-
-/** Plugin text route (fs.read-shaped JSON), or null on any failure. */
-async function fetchTextContent(sessionId, path) {
-  try {
-    const response = await fetch(textUrlOf(sessionId, path))
-    return await response.json()
-  } catch {
-    return null
-  }
-}
-
-/**
- * Fetch the bytes the viewer's fetchStrategy needs (fsRead text /
- * mediaUrl / customData) and resolve its load state.
- */
-async function fetchPreviewLoad(viewer, path, scope, sessionId) {
-  const strategy = viewer.fetchStrategy
-  if (strategy === 'fsRead') return loadFsReadContent(viewer, path, scope, sessionId)
-  if (strategy === 'mediaUrl') {
-    return { status: 'ready', viewer, mediaUrl: mediaUrlOf(sessionId, path) }
-  }
-  if (strategy === 'custom') {
-    const data = await (viewer.load?.(path, scope) ?? Promise.resolve(undefined))
-    return { status: 'ready', viewer, customData: data }
-  }
-  // 'binary-download' and anything else: mount the viewer's own
-  // component (it handles the download / media itself).
-  return { status: 'ready', viewer }
-}
-
-/**
- * Resolve the file's viewer through the sidebar registry and load the
- * bytes it needs; failures become an error state shown in the window.
- */
-function usePreviewLoader(service, path, sessionId, scope) {
-  const [load, setLoad] = useState({ status: 'loading', viewer: null })
-  useEffect(() => {
-    let cancelled = false
-    const viewer = service?.matchFileViewer?.(path)
-    if (!viewer) {
-      setLoad({ status: 'error', viewer: null, message: strings.previewUnsupported() })
-      return () => {
-        cancelled = true
-      }
-    }
-    setLoad({ status: 'loading', viewer })
-    fetchPreviewLoad(viewer, path, scope, sessionId)
-      .then((next) => {
-        if (!cancelled) setLoad(next)
-      })
-      .catch((error) => {
-        if (!cancelled)
-          setLoad({
-            status: 'error',
-            viewer,
-            message: error instanceof Error ? error.message : String(error),
-          })
-      })
-    return () => {
-      cancelled = true
-    }
-  }, [path, sessionId, scope])
-  return load
-}
-
-/** Preview window body: loading note / error panel / viewer mount. */
-function renderPreviewBody(load, ctx, store, scope, path, title, sessionId) {
-  if (load.status === 'loading') {
-    return createElement('div', { className: 'dfa-fp-note' }, strings.loading())
-  }
-  if (load.status === 'error') {
-    return createElement(
-      'div',
-      { className: 'dfa-fp-err' },
-      strings.previewFailed(),
-      load.message
-        ? createElement('div', { style: { marginTop: '6px', fontSize: '11px', opacity: 0.85 } }, load.message)
-        : null,
-      createElement('div', { style: { marginTop: '6px', fontSize: '11px', opacity: 0.7 } }, strings.autoCloseHint()),
-    )
-  }
-  if (load.viewer.id === 'pdf') {
-    const url = mediaUrlOf(sessionId, path)
-    return createElement(PdfPreview, { src: url, download: `${url}&download=1`, title })
-  }
-  return createElement(load.viewer.component, {
-    ctx,
-    store,
-    scope,
-    path,
-    title,
-    viewerId: load.viewer.id,
-    content: load.content,
-    mediaUrl: load.mediaUrl,
-    customData: load.customData,
-  })
-}
-
-/**
- * A floating preview window. Instead of re-implementing rendering, it
- * asks the sidebar registry for the file's viewer (`matchFileViewer`),
- * fetches the bytes the viewer's fetchStrategy needs (fsRead text /
- * mediaUrl / customData), then mounts that viewer's own component — so
- * code gets syntax highlighting and markdown gets rendered by the SAME
- * built-in renderers the sidebar's editor tab uses.
- *
- * Media caveat: the sidebar's own media route (/sidebar/file) only serves
- * files inside the session working directory, while file activity records
- * files the agent touched anywhere (/tmp scratch files, sibling repos…).
- * Media bytes therefore come from OUR route (/file-activity/file), which
- * authorizes exactly the paths this session recorded; PDF is the one
- * built-in viewer that fetches its own URL internally (it ignores the
- * `mediaUrl` prop), so it gets a small iframe preview instead.
- */
-/**
- * Dismissal affordances (issue #76 — the preview must never linger):
- * 1. pointerdown anywhere OUTSIDE the window closes it (capture phase, so
- *    it fires even if another element sits above the scrim);
- * 2. the scrim's own onClick (kept as a fallback);
- * 3. Escape;
- * 4. the × button;
- * 5. an error state closes itself after AUTO_CLOSE_MS (no content to show).
- */
-function usePreviewDismiss(load, onClose) {
-  useEffect(() => {
-    if (typeof document === 'undefined' || typeof document.addEventListener !== 'function') return () => {}
-    const handler = (event) => {
-      if (!isInsideFloating(event?.target)) onClose()
-    }
-    document.addEventListener('pointerdown', handler, true)
-    return () => document.removeEventListener('pointerdown', handler, true)
-  }, [onClose])
-
-  useEffect(() => {
-    if (typeof document === 'undefined' || typeof document.addEventListener !== 'function') return () => {}
-    const handler = (event) => {
-      if (event && event.key === 'Escape') onClose()
-    }
-    document.addEventListener('keydown', handler)
-    return () => document.removeEventListener('keydown', handler)
-  }, [onClose])
-
-  useEffect(() => {
-    if (load.status !== 'error') return undefined
-    if (typeof window === 'undefined' || typeof window.setTimeout !== 'function') return undefined
-    const timer = window.setTimeout(onClose, AUTO_CLOSE_MS)
-    return () => window.clearTimeout(timer)
-  }, [load.status, onClose])
-}
-
-/** The floating window element: head (title + hint + close) and body. */
-function renderFloatingWindow(load, ctx, store, scope, path, title, sessionId, onClose) {
-  return createElement(
-    'div',
-    { className: 'dfa-fp-overlay', onClick: onClose },
-    createElement(
-      'div',
-      {
-        className: 'dfa-fp',
-        onClick: (event) => {
-          if (previewClickAction(load, event) === 'close') onClose()
-        },
-      },
-      createElement(
-        'div',
-        { className: 'dfa-fp-head' },
-        createElement('span', { className: 'dfa-fp-title' }, title),
-        createElement('span', { className: 'dfa-fp-hint' }, strings.clickOutsideToClose()),
-        createElement(
-          'span',
-          { className: 'dfa-fp-actions' },
-          createElement(
-            'button',
-            {
-              className: 'dfa-iconbtn',
-              title: strings.closePreview(),
-              'aria-label': strings.closePreview(),
-              onClick: () => onClose(),
-            },
-            icon.close(15),
-          ),
-        ),
-      ),
-      createElement(
-        'div',
-        { className: 'dfa-fp-body' },
-        renderPreviewBody(load, ctx, store, scope, path, title, sessionId),
-      ),
-    ),
-  )
-}
-
-function FloatingPreview({ ctx, store, scope, preview, onClose }) {
-  const sessionId = scope?.sessionId ?? ''
-  const path = preview.abs
-  const title = preview.name
-  const service = ctx.betterSidebar
-  const load = usePreviewLoader(service, path, sessionId, scope)
-  usePreviewDismiss(load, onClose)
-  return renderFloatingWindow(load, ctx, store, scope, path, title, sessionId, onClose)
-}
-
-/**
- * Lightweight PDF preview. better-sidebar's built-in PdfView fetches
- * `/sidebar/file` internally (it ignores any injected `mediaUrl` prop),
- * and that route refuses files outside the session working directory — so
- * a recorded /tmp PDF would never load. This tiny view embeds the bytes
- * from OUR media route in a native browser PDF frame, with a download
- * fallback in its toolbar.
- */
-function PdfPreview({ src, download, title }) {
-  return createElement(
-    'div',
-    { className: 'dfa-pdf' },
-    createElement(
-      'div',
-      { className: 'dfa-pdf-toolbar' },
-      createElement(
-        'a',
-        {
-          className: 'dfa-pdf-download',
-          href: download,
-          download: true,
-          title: strings.downloadToView(),
-        },
-        strings.downloadToView(),
-      ),
-    ),
-    createElement('iframe', { className: 'dfa-pdf-frame', src, title }),
-  )
-}