dsh-coding-sidebar 1.0.2 → 1.0.4

package/lib/index.js

@@ -42,15 +42,12 @@ const SIDEBAR_PREFS_DEFAULTS = {
 	customCss: "",
 	titleBarCompat: false,
 	titleBarStripPx: 40,
-	htmlViewerNoSandbox: false,
-	htmlViewerDefaultUnsafe: false,
 	browserNoSandbox: false,
 	browserInterceptLinks: true,
 	browserInterceptHttp: true,
 	browserInterceptHttps: false,
 	browserAllowedLoopback: "",
 	tabsEnabled: {},
-	viewersEnabled: {},
 	pluginSettings: {}
 };
 //#endregion
@@ -114,15 +111,12 @@ const PrefsSchema = z.object({
 	customCss: z.string(),
 	titleBarCompat: z.boolean().default(false),
 	titleBarStripPx: z.number().step(1).min(0).max(120).default(40),
-	htmlViewerNoSandbox: z.boolean().default(false),
-	htmlViewerDefaultUnsafe: z.boolean().default(false),
 	browserNoSandbox: z.boolean().default(false),
 	browserInterceptLinks: z.boolean().default(true),
 	browserInterceptHttp: z.boolean().default(true),
 	browserInterceptHttps: z.boolean().default(false),
 	browserAllowedLoopback: z.string().default(""),
 	tabsEnabled: z.dict(z.boolean()).default({}),
-	viewersEnabled: z.dict(z.boolean()).default({}),
 	pluginSettings: z.dict(z.dict(z.any())).default({})
 });
 //#endregion
@@ -541,60 +535,6 @@ async function searchFiles(root, query, opts = {}) {
 		truncated
 	};
 }
-/**
-* Decode a route pathname into the session + absolute file path. Rejects
-* a wrong prefix (404), an empty path, malformed percent encoding, and a
-* missing sessionId or file path (400). The caller still must bound the
-* decoded path with the workspace real-path guard — a decoded `..`
-* segment resolves outside the cwd and is refused there.
-*/
-function decodeHtmlUrl(pathname) {
-	if (!pathname.startsWith("/sidebar/html/")) return {
-		ok: false,
-		status: 404,
-		message: "not an html route"
-	};
-	const rest = pathname.slice(14);
-	if (rest === "") return {
-		ok: false,
-		status: 400,
-		message: "invalid html route path"
-	};
-	let segments;
-	try {
-		segments = rest.split("/").map((segment) => decodeURIComponent(segment));
-	} catch {
-		return {
-			ok: false,
-			status: 400,
-			message: "malformed URL encoding"
-		};
-	}
-	const [sessionId, ...pathSegments] = segments;
-	if (sessionId === void 0 || sessionId === "") return {
-		ok: false,
-		status: 400,
-		message: "sessionId and file path are required"
-	};
-	const unc = pathSegments[0] === "";
-	const tail = unc ? pathSegments.slice(1) : pathSegments;
-	if (tail.length === 0 || tail.some((segment) => segment === "")) return {
-		ok: false,
-		status: 400,
-		message: "sessionId and file path are required"
-	};
-	let path;
-	if (unc) path = `//${tail.join("/")}`;
-	else if (/^[A-Za-z]:$/.test(tail[0] ?? "")) path = tail.join("/");
-	else path = `/${tail.join("/")}`;
-	return {
-		ok: true,
-		ref: {
-			sessionId,
-			path
-		}
-	};
-}
 //#endregion
 //#region src/browser-probe.ts
 /**
@@ -692,11 +632,7 @@ function isTrustedApiRequest(request, trustedHosts) {
 * only allowlisted chunk names are servable (no path traversal).
 */
 /** The chunk names the client may request (mirror of src/client/chunk-loader.ts). */
-const CHUNK_NAMES = [
-	"terminal",
-	"editor",
-	"mermaid"
-];
+const CHUNK_NAMES = ["terminal", "editor"];
 /** Directory of this host-half module (lib/ — the chunk scripts live next to it). */
 const LIB_DIR = dirname(fileURLToPath(import.meta.url));
 /** sha1 content hash shortened to 12 hex chars (same shape as the client-modules rev). */
@@ -2962,7 +2898,7 @@ const MIRROR_MAX_ENTRIES = 200;
 * The live job_output mirror: subscribes to the session append feed and
 * caches the job_output traces the session store's own log can lag behind
 * (after a host restart the store session stays frozen at its rehydration
-* boundary, so `session.events` misses everything appended since — the very
+* boundary, so a stale snapshot misses everything appended since — the very
 * reads the pane exists to show). Zero DSH writes: the api-proxy pushes the
 * same feed to browsers.
 */
@@ -3025,7 +2961,8 @@ function buildJobsApi(ctx, outputLimit) {
 			const sessionId = requireString(payload, "sessionId");
 			const id = requireString(payload, "id");
 			const bySeq = /* @__PURE__ */ new Map();
-			for (const event of ctx.sessions.get(sessionId)?.events ?? []) {
+			const store = ctx.sessions.get(sessionId);
+			for (const event of (store?.snapshotEvents !== void 0 ? store.snapshotEvents() : []) ?? []) {
 				const trace = traceOf(event);
 				if (trace !== void 0) bySeq.set(trace.seq, trace);
 			}
@@ -3420,7 +3357,8 @@ function buildSubagentLiveApi(ctx) {
 			if (entry.kind !== "child" || entry.activity !== "running") continue;
 			if (entry.label?.startsWith("Side: ") ?? false) continue;
 			try {
-				const activity = lastActivity(ctx.sessions.get(entry.id)?.events ?? [], 12);
+				const stored = ctx.sessions.get(entry.id);
+				const activity = lastActivity(stored?.snapshotEvents !== void 0 ? stored.snapshotEvents() : [], 12);
 				if (activity.text !== void 0 || activity.tool !== void 0) live[entry.id] = activity;
 			} catch {}
 		}
@@ -3480,8 +3418,10 @@ async function composeChildSetup(ctx, presetId) {
 async function composePersistedSetup(ctx, childId) {
 	const persistence = ctx.get("sessionPersistence");
 	if (persistence === void 0) return () => Promise.resolve();
-	const inspected = await persistence.inspect(childId);
-	const presetId = resolvePresetId(inspected.meta, inspected.events);
+	const handle = await persistence.open(childId, "read");
+	const { events } = await handle.read();
+	const presetId = resolvePresetId(handle.header, events);
+	await handle.close();
 	const presets = ctx.get("agentPresets");
 	if (presets === void 0 || presetId === void 0) return () => Promise.resolve();
 	const resolved = await presets.resolve(presetId);
@@ -3542,8 +3482,8 @@ function buildSidechatApi(ctx) {
 			const parent = liveThreadAgent(ctx, sessionId);
 			if (parent === void 0) throw new SidebarError("sidechat-error", `parent session "${sessionId}" is not running`, 409);
 			const parentSession = parent.session;
-			const inheritance = buildSidechatInheritance(parentSession.events);
-			const { agentPreset, setup } = await composeChildSetup(ctx, resolvePresetId(parentSession.header, parentSession.events));
+			const inheritance = buildSidechatInheritance(parentSession.snapshotEvents());
+			const { agentPreset, setup } = await composeChildSetup(ctx, resolvePresetId(parentSession.header, parentSession.snapshotEvents()));
 			const childId = `session-${randomUUID()}`;
 			const label = question === "" ? SIDE_NEW_THREAD_TITLE : sideLabel(question);
 			const descriptor = snapshotSubagentDescriptor({
@@ -3565,7 +3505,7 @@ function buildSidechatApi(ctx) {
 				meta: {
 					...parentSession.header.cwd === void 0 ? {} : { cwd: parentSession.header.cwd },
 					parentSession: parentSession.id,
-					seedLength: seed.length,
+					isSeeded: seed.length > 0,
 					origin: "subagent",
 					delegationDepth: (parentSession.header.delegationDepth ?? 0) + 1,
 					...agentPreset === void 0 ? {} : { agentPreset }
@@ -3622,7 +3562,7 @@ function buildSidechatApi(ctx) {
 					throw new SidebarError("sidechat-error", `thread resume failed: ${error instanceof Error ? error.message : String(error)}`, 500);
 				}
 			}
-			if (boundaryDelivered(agent.session.events)) admitFollowup(agent, textPrompt(text));
+			if (boundaryDelivered(agent.session.snapshotEvents())) admitFollowup(agent, textPrompt(text));
 			else {
 				const parts = [SIDE_BOUNDARY_PROMPT];
 				const snapshot = pendingSnapshots.get(childId);
@@ -3668,8 +3608,10 @@ function buildSidechatApi(ctx) {
 			}
 			const persistence = ctx.get("sessionPersistence");
 			if (persistence !== void 0) try {
-				const inspected = await persistence.inspect(childId);
-				const preset = resolvePresetId(inspected.meta, inspected.events);
+				const handle = await persistence.open(childId, "read");
+				const { events } = await handle.read();
+				const preset = resolvePresetId(handle.header, events);
+				await handle.close();
 				return {
 					live: false,
 					...preset === void 0 ? {} : { preset }
@@ -3683,8 +3625,8 @@ function buildSidechatApi(ctx) {
 //#region src/index.ts
 /**
 * dsh-coding-sidebar host half: the /sidebar JSON API (explorer listing, file
-* read/write, git), the /sidebar/file media route (images), the /sidebar/html
-* preview route, the /sidebar/bundle lazy-chunk route (client code splits),
+* read/write, git), the /sidebar/file media route (file bytes / downloads),
+* the /sidebar/bundle lazy-chunk route (client code splits),
 * and the terminal WebSocket upgrade. Every route passes the same
 * browser-trust fence as the /api gateway — Host-header loopback or the
 * web runtime's `trustedHosts` (LAN IP literals sampled at boot plus
@@ -3715,10 +3657,7 @@ const MEDIA_TYPES = {
 	".svg": "image/svg+xml",
 	".bmp": "image/bmp",
 	".ico": "image/x-icon",
-	".avif": "image/avif",
-	".pdf": "application/pdf",
-	".html": "text/html",
-	".htm": "text/html"
+	".avif": "image/avif"
 };
 /** Content type served by /sidebar/file (binary-safe fallback for unknowns). */
 function mediaTypeForPath(path) {
@@ -3749,7 +3688,9 @@ async function sessionCwdOf(ctx, sessionId, clientCwd) {
 	}
 	const persistence = ctx.get("sessionPersistence");
 	if (persistence !== void 0) {
-		const metaCwd = (await persistence.inspect(sessionId)).meta.cwd;
+		const handle = await persistence.open(sessionId, "read");
+		const metaCwd = handle.header.cwd;
+		await handle.close();
 		if (metaCwd !== void 0 && metaCwd !== "") try {
 			return requireAbsolute(metaCwd);
 		} catch {
@@ -4294,45 +4235,6 @@ function apply(ctx, config) {
 			}
 		}
 	}), "dsh-coding-sidebar: /sidebar/file media route");
-	ctx.effect(() => ctx.webServer.register({
-		kind: "prefix",
-		path: "/sidebar/html",
-		handler: async (req, res) => {
-			if (!fence(req)) {
-				res.writeHead(403);
-				res.end("forbidden");
-				return;
-			}
-			if (req.method !== "GET") {
-				res.writeHead(405);
-				res.end();
-				return;
-			}
-			try {
-				const decoded = decodeHtmlUrl(new URL(req.url ?? "/", "http://dsh.internal").pathname);
-				if (!decoded.ok) {
-					writeError(res, new SidebarError("bad-request", decoded.message, decoded.status));
-					return;
-				}
-				const { sessionId, path } = decoded.ref;
-				const absolute = await ensureWorkspacePath(await sessionCwdOf(ctx, sessionId), path);
-				const info = await stat(absolute);
-				if (!info.isFile() || info.size > resolved.mediaLimit) throw new SidebarError("fs-error", "not a file or too large", 400);
-				const type = mediaTypeForPath(absolute);
-				const body = await readFile(absolute);
-				res.writeHead(200, {
-					"content-type": type === "text/html" ? "text/html; charset=utf-8" : type,
-					"cache-control": "no-cache",
-					"x-content-type-options": "nosniff",
-					"referrer-policy": "no-referrer",
-					"content-security-policy": "sandbox allow-scripts allow-popups allow-downloads allow-modals; object-src 'none'"
-				});
-				res.end(body);
-			} catch (error) {
-				writeError(res, error);
-			}
-		}
-	}), "dsh-coding-sidebar: /sidebar/html preview route");
 	const wss = new WebSocketServer({ noServer: true });
 	ctx.effect(() => ctx.webServer.registerUpgrade({
 		path: "/sidebar/ws/terminal",

package/lib/types/bundle-route.d.ts

@@ -1,6 +1,6 @@
 import type { Context, SidebarHttpRequest, SidebarHttpResponse } from './context-types.ts';
 /** The chunk names the client may request (mirror of src/client/chunk-loader.ts). */
-export declare const CHUNK_NAMES: readonly ["terminal", "editor", "mermaid"];
+export declare const CHUNK_NAMES: readonly ["terminal", "editor"];
 export type ChunkName = (typeof CHUNK_NAMES)[number];
 /**
  * Build the /sidebar/bundle route handler. `fence` is the shared browser-

package/lib/types/client/SideCardSection.d.ts

@@ -1,7 +1,7 @@
 import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { type SidebarPrefs } from '../prefs-shared.ts';
 import type { SidebarStore } from './state.ts';
-import type { BetterSidebarService, FileViewerDescriptor, SidebarSettingToggle, TabDescriptor } from './service.ts';
+import type { BetterSidebarService, SidebarSettingToggle, TabDescriptor } from './service.ts';
 /** Injected business face: the shared store (prefs cache) + the sidebar service (registries). */
 export interface SideCardSectionInjected {
     store: SidebarStore;
@@ -43,7 +43,7 @@ export declare function FeatureSettingsRows(props: {
     valueSource?: (key: string) => unknown;
 }): import("react").JSX.Element;
 /**
- * The secondary settings popup body of one feature (tab or viewer):
+ * The secondary settings popup body of one registered tab:
  * - the host-prefs `toggles` rows, then the plugin-owned `pluginToggles`
  *   rows (their values live in `pluginSettings[feature.id]`, projected onto
  *   the prefs face so the shared row renderer reads them);
@@ -53,7 +53,7 @@ export declare function FeatureSettingsRows(props: {
  *   open-behavior picker) and still ship a custom configuration area.
  */
 export declare function SettingsBody(props: {
-    feature: TabDescriptor | FileViewerDescriptor;
+    feature: TabDescriptor;
     prefs: SidebarPrefs;
     store: SidebarStore;
     service: BetterSidebarService;

package/lib/types/client/TextEditor.d.ts

@@ -1,10 +1,20 @@
-import type { FileViewerProps } from './service.ts';
-/**
- * The sandbox tokens of the HTML preview iframe. NO allow-same-origin (the
- * preview must stay in an opaque origin — with the route's own origin it
- * could read session data) and NO allow-top-navigation (a previewed page
- * must not hijack the GUI). The user can disable the sandbox per-feature
- * in the side card settings (warned); the toggle below reflects it.
- */
-export declare const HTML_IFRAME_SANDBOX = "allow-scripts allow-popups allow-downloads allow-modals";
-export declare function TextEditor(props: FileViewerProps): import("react").JSX.Element;
+import type { EditorToolbarControls, EditorToolbarState } from './service.ts';
+import type { Context } from '../context-types.ts';
+import type { SessionScope } from './api.ts';
+import type { SidebarStore } from './state.ts';
+/** Props of the sidebar text editor (the editor tab's content). */
+export interface TextEditorProps {
+    ctx: Context;
+    store?: SidebarStore;
+    scope: SessionScope;
+    path: string;
+    /** fs.read text content (undefined while loading / for non-editable reads). */
+    content?: string;
+    truncated?: boolean;
+    /** 'host' skips the own toolbar row — the editor host's merged-mode header
+     *  renders it instead, fed through the two callbacks below. */
+    toolbar?: 'self' | 'host';
+    onToolbarState?: (state: EditorToolbarState) => void;
+    onToolbarControls?: (controls: EditorToolbarControls | null) => void;
+}
+export declare function TextEditor(props: TextEditorProps): import("react").JSX.Element;

package/lib/types/client/add-plugin-modal.d.ts

@@ -1,15 +1,11 @@
 import type { BetterSidebarService } from './service.ts';
-/** Which extension point the modal is adding a plugin for. */
-export type PluginKind = 'tab' | 'viewer';
 /** The modal body: the GitHub topic button + the recommended plugin list
  *  with per-entry jump/copy buttons (extracted for direct testing). */
 export declare function PluginListBody(props: {
     service: BetterSidebarService;
-    kind: PluginKind;
 }): import("react").JSX.Element;
 /** The modal itself (mounted only while open — see the module comment). */
 export declare function AddPluginModal(props: {
     service: BetterSidebarService;
     onClose: () => void;
-    kind: PluginKind;
 }): import("react").JSX.Element;

package/lib/types/client/api.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Typed fetch wrapper over the /sidebar JSON API. Every call posts to
+ * `/sidebar/api/<method>` with the sessionId and — when known — the session's
+ * cwd from the client's own list summary. The host prefers its attached
+ * session header and uses the summary cwd only while the session is still
+ * hydrating at page load (a detached session would otherwise fail the
+ * request). Failures surface as {@link SidebarApiError} with the wire code.
+ */
 import type { LastActivity } from '../subagent-activity.ts';
 import type { SidechatThreadInfo } from '../sidechat-core.ts';
 import type { BrowserProbeResult } from './browser.ts';
@@ -259,17 +267,6 @@ export declare const api: {
         started: boolean;
     }>;
 };
-/** Absolute URL of the media route for one path (images only). */
-export declare function mediaUrl(scope: SessionScope, path: string): string;
 /** Absolute URL of the download route: serves raw bytes (binary-safe) with
  *  `Content-Disposition: attachment`, so the browser saves the file. */
 export declare function downloadUrl(scope: SessionScope, path: string): string;
-/**
- * Absolute URL of the HTML preview route (see html-route.ts): the path is
- * fully encoded so the previewed page's relative assets resolve back into
- * the same route with the session scope intact. The UNC marker is
- * platform-neutral — the host's requireAbsolute resolves the decoded
- * forward-slash `//server/share/...` form on both win32 and POSIX — so no
- * client-side platform signal is needed.
- */
-export declare function htmlUrl(scope: SessionScope, path: string): string;

package/lib/types/client/builtins/index.d.ts

@@ -1,18 +1,18 @@
 /**
- * Built-in registration: the plugin registers its own tab pages and file
- * previewers through the same {@link BetterSidebarService} external plugins
- * use — eating its own dogfood. The descriptors live next to their feature
- * modules (tabs.tsx / viewers.tsx); this module only aggregates them and
- * owns the disposer lifecycle (cordis auto-invokes it on fiber disposal,
- * HMR-safe).
+ * Built-in registration: the plugin registers its own tab pages through the
+ * same {@link BetterSidebarService} external plugins use — eating its own
+ * dogfood. The descriptors live next to their feature modules (tabs.tsx);
+ * this module only aggregates them and owns the disposer lifecycle (cordis
+ * auto-invokes it on fiber disposal, HMR-safe).
+ *
+ * (v1.0.4: the built-in file viewers were retired with the file-viewer
+ * registry — file preview is the host's job now.)
  */
 import type { Context } from '../../context-types.ts';
 import type { BetterSidebarService } from '../service.ts';
 import { type BuiltinTabOptions } from './tabs.tsx';
 /**
- * Register all built-in tabs and viewers with the service. Returns a
- * disposer that unregisters everything (cordis auto-invokes it on fiber
- * disposal). The `ctx` is threaded into tab descriptors that need it
- * (EditorHost reads `ctx.betterSidebar` for file-viewer matching).
+ * Register all built-in tabs with the service. Returns a disposer that
+ * unregisters everything (cordis auto-invokes it on fiber disposal).
  */
 export declare function registerBuiltins(ctx: Context, service: BetterSidebarService, options?: BuiltinTabOptions): () => void;

package/lib/types/client/chunk-loader.d.ts

@@ -1,11 +1,10 @@
 /**
- * Lazy chunk loader for the client bundle. The heavy preview/terminal
- * libraries (CodeMirror, xterm — the editor/terminal stacks, several MB)
- * live in separate build-time bundles (`lib/client-<name>.js`) fetched only
- * on first use of the feature that needs them, so startup downloads/parses
- * only the ~1MB core bundle. (The office stack — Univer / docx-preview /
- * pptx-renderer — is no longer bundled here: Office previews moved to the
- * recommended office plugin, see plugins-viewers.ts.)
+ * Lazy chunk loader for the client bundle. The heavy editor/terminal
+ * libraries (CodeMirror, xterm — several MB) live in separate build-time
+ * bundles (`lib/client-<name>.js`) fetched only on first use of the feature
+ * that needs them, so startup downloads/parses only the ~1MB core bundle.
+ * (v1.0.4: the mermaid chunk was retired with the file-viewer line; the
+ * office stack moved to the ecosystem even earlier.)
  *
  * How a chunk script works (see tsdown.config.ts chunkBundle):
  *
@@ -49,7 +48,7 @@
  * client.js); an edit that does land while a core HMR happens is caught by
  * the ETag comparison on the next activation.
  */
-export type ChunkName = 'terminal' | 'editor' | 'mermaid';
+export type ChunkName = 'terminal' | 'editor';
 /** The module exports a chunk factory provides (namespace-ish record). */
 export type ChunkExports = Record<string, unknown>;
 /**

package/lib/types/client/locales.d.ts

@@ -94,14 +94,6 @@ export declare const zh: {
     terminalDepsFailed: string;
     terminalDepsHint: string;
     terminalDepsProfile: string;
-    preview: string;
-    toc: string;
-    edit: string;
-    mermaidError: string;
-    mermaidZoomIn: string;
-    mermaidZoomOut: string;
-    mermaidZoomReset: string;
-    mermaidZoomHint: string;
     refresh: string;
     refreshUnsavedConfirm: string;
     save: string;
@@ -244,16 +236,8 @@ export declare const zh: {
     settingsShellArgsDesc: string;
     settingsShellArgsPlaceholder: string;
     settingsTabsTitle: string;
-    settingsViewersTitle: string;
     settingsGeneralTitle: string;
     settingsPopup: string;
-    settingsViewerCatchAll: string;
-    viewerImage: string;
-    viewerPdf: string;
-    viewerMarkdown: string;
-    viewerCode: string;
-    viewerBinary: string;
-    viewerHtml: string;
     browser: string;
     browserPlaceholder: string;
     browserGo: string;
@@ -264,14 +248,9 @@ export declare const zh: {
     browserBlockedLoopback: string;
     browserInvalid: string;
     browserNoSandboxWarning: string;
-    htmlNoSandboxWarning: string;
     sandboxStatusOn: string;
     sandboxUnlock: string;
     sandboxRestore: string;
-    settingsHtmlDefaultUnsafeTitle: string;
-    settingsHtmlDefaultUnsafeDesc: string;
-    settingsHtmlSandboxTitle: string;
-    settingsHtmlSandboxDesc: string;
     settingsBrowserSandboxTitle: string;
     settingsBrowserSandboxDesc: string;
     settingsBrowserLinksTitle: string;
@@ -352,10 +331,7 @@ export declare const zh: {
     jobKillError: string;
     addPluginsTabCard: string;
     addPluginsTabCardDesc: string;
-    addPluginsViewerCard: string;
-    addPluginsViewerCardDesc: string;
     addPluginsTabDesc: string;
-    addPluginsViewerDesc: string;
     addPluginsBrowseMore: string;
     addPluginsSearch: string;
     addPluginsNoMatch: string;
@@ -363,7 +339,6 @@ export declare const zh: {
     addPluginsEmpty: string;
     openPlugin: string;
     copyInstall: string;
-    pluginOfficeDesc: string;
     pluginFlowglassDesc: string;
     pluginGitForgeDesc: string;
     pluginGitRemotesDesc: string;
@@ -371,7 +346,6 @@ export declare const zh: {
     pluginSidebarQaDesc: string;
     pluginSshTunnelDesc: string;
     pluginTurnReviewDesc: string;
-    pluginVideoPreviewDesc: string;
     pluginDocsPanelDesc: string;
     pluginEgoBrowserDesc: string;
 };

package/lib/types/client/native-avoid.d.ts

@@ -0,0 +1,2 @@
+import type { SidebarStore } from './state.ts';
+export declare function installNativeSidebarAvoidance(store: SidebarStore): () => void;

package/lib/types/client/plugins-shared.d.ts

@@ -1,10 +1,10 @@
 /**
- * Shared vocabulary of the recommended plugin catalogs: the entry shape and
- * the GitHub topic URL. The two catalogs live in sibling modules —
- * `plugins-tabs.ts` (tab registrations) and `plugins-viewers.ts` (file
- * previewer registrations) — and are shown in the two "add plugin" modals
- * (Side card settings → the dashed cards at the end of the 侧边栏内容 /
- * 文件预览 grids).
+ * Shared vocabulary of the recommended plugin catalog: the entry shape and
+ * the GitHub topic URL. The catalog lives in the sibling module
+ * `plugins-tabs.ts` (tab registrations) and is shown in the "add plugin"
+ * modal (Side card settings → the dashed card at the end of the 侧边栏内容
+ * grid). (v1.0.4: the file-previewer catalog was retired with the
+ * file-viewer registry.)
  */
 /** The GitHub topic page listing every repo tagged `dsh-coding-sidebar`. */
 export declare const PLUGIN_TOPIC_URL = "https://github.com/topics/dsh-coding-sidebar";