@keith9681/dsh-sidebar 0.15.2

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

@@ -0,0 +1,366 @@
+/**
+ * Minimal zh/en copy for the sidebar. The copy follows the DSH i18n system:
+ * the client apply attaches the locale service (`ctx.locale`, provided by
+ * `@deepseek-ai/dsh-client-locale`) through {@link attachLocale}, and
+ * `t()`/`isZh()` resolve the active locale from it — the Host-backed
+ * `locale.preference` wins over the raw browser language and switches live.
+ * Without an attached service (standalone/test compositions) the browser
+ * language is used, matching the previous behavior. The dictionaries are
+ * also registered into the DSH locale registry under {@link LOCALE_NS}.
+ */
+/** The zh dictionary (also registered into the DSH locale registry under {@link LOCALE_NS}). */
+export declare const zh: {
+    files: string;
+    explorer: string;
+    git: string;
+    terminal: string;
+    editor: string;
+    editorExplorer: string;
+    editorExplorerDesc: string;
+    editorExplorerMerged: string;
+    editorExplorerMergedDesc: string;
+    editorExplorerSplit: string;
+    editorExplorerSplitDesc: string;
+    editorTreeToggle: string;
+    editorPathPlaceholder: string;
+    editorSearchPlaceholder: string;
+    editorSearchNoResults: string;
+    editorSearchTruncated: string;
+    editorEmptyHint: string;
+    openFileNewTab: string;
+    openFileSide: string;
+    openWithMenu: string;
+    openWithSshSuffix: string;
+    pinOpenWith: string;
+    unpinOpenWith: string;
+    openWithExplorer: string;
+    openWithVscode: string;
+    openWithCursor: string;
+    openWithZed: string;
+    openWithSettingsSshTitle: string;
+    openWithSettingsSshDesc: string;
+    openWithSettingsSshPlaceholder: string;
+    openWithSettingsCustomTitle: string;
+    openWithSettingsCustomDesc: string;
+    openWithSettingsAdd: string;
+    openWithSettingsName: string;
+    openWithSettingsTemplate: string;
+    openWithSettingsFamily: string;
+    openWithSettingsFamilyDesc: string;
+    openWithSettingsRemove: string;
+    openWithSettingsInvalidHint: string;
+    newTab: string;
+    openExplorer: string;
+    brokenSymlink: string;
+    openGit: string;
+    newTerminal: string;
+    terminalLimit: string;
+    close: string;
+    closeOtherTabs: string;
+    closeLeftTabs: string;
+    closeRightTabs: string;
+    collapse: string;
+    expand: string;
+    terminalError: string;
+    terminalConnectFailed: string;
+    terminalRetry: string;
+    terminalDepsFailed: string;
+    terminalDepsHint: string;
+    terminalDepsProfile: string;
+    preview: string;
+    edit: string;
+    mermaidError: string;
+    mermaidZoomIn: string;
+    mermaidZoomOut: string;
+    mermaidZoomReset: string;
+    mermaidZoomHint: string;
+    refresh: string;
+    save: string;
+    saved: string;
+    unsaved: string;
+    saveFailed: string;
+    readOnlyMode: string;
+    editableMode: string;
+    switchReadOnlyTitle: string;
+    switchEditableTitle: string;
+    truncation: string;
+    binary: string;
+    loading: string;
+    error: string;
+    retry: string;
+    splitLeft: string;
+    splitRight: string;
+    splitUp: string;
+    splitDown: string;
+    notRepo: string;
+    noChanges: string;
+    stage: string;
+    unstage: string;
+    stageAll: string;
+    unstageAll: string;
+    commitPlaceholder: string;
+    commit: string;
+    commitError: string;
+    branch: string;
+    checkoutError: string;
+    history: string;
+    changes: string;
+    staged: string;
+    unstaged: string;
+    cancel: string;
+    diffEmpty: string;
+    diffLoadError: string;
+    diffBinary: string;
+    diffAdded: string;
+    diffDeleted: string;
+    diffRenamed: string;
+    diffExpand: string;
+    diffCollapse: string;
+    discard: string;
+    discardTitle: string;
+    discardDesc: string;
+    viewCommitDiff: string;
+    copyShortHash: string;
+    copyFullHash: string;
+    copySubject: string;
+    revertCommit: string;
+    revertTitle: string;
+    revertDesc: string;
+    cherryPickCommit: string;
+    cherryPickTitle: string;
+    cherryPickDesc: string;
+    timeJustNow: string;
+    timeMinutesAgo: string;
+    timeHoursAgo: string;
+    timeYesterday: string;
+    loadMore: string;
+    historyLoadError: string;
+    produced: string;
+    producedOpen: string;
+    disconnected: string;
+    exited: string;
+    noSession: string;
+    pluginNotLoaded: string;
+    hiddenFiles: string;
+    parent: string;
+    copied: string;
+    copy: string;
+    newFile: string;
+    openEditor: string;
+    gitDetail: string;
+    referenceFile: string;
+    addToConversation: string;
+    copyRelative: string;
+    copyAbsolute: string;
+    download: string;
+    uploadFiles: string;
+    uploadFolder: string;
+    uploadHere: string;
+    uploadDropHint: string;
+    uploadDropChat: string;
+    uploadTo: string;
+    uploadingTo: string;
+    uploadProgress: string;
+    uploadDone: string;
+    uploadFailed: string;
+    uploadFailedUnknown: string;
+    uploadTooLarge: string;
+    uploadCancelled: string;
+    settingsNav: string;
+    settingsIntro: string;
+    settingsPopupDesc: string;
+    settingsDone: string;
+    settingsOpenTitle: string;
+    settingsOpenDesc: string;
+    settingsWidthTitle: string;
+    settingsWidthDesc: string;
+    settingsWidthSuffix: string;
+    settingsOpenPathTitle: string;
+    settingsOpenPathDesc: string;
+    settingsTitleBarTitle: string;
+    settingsTitleBarDesc: string;
+    settingsTitleBarStripTitle: string;
+    settingsTitleBarStripDesc: string;
+    settingsSchemeAutoTitle: string;
+    settingsSchemeAutoDesc: string;
+    settingsSchemeWebTitle: string;
+    settingsSchemeWebDesc: string;
+    settingsSchemeCustomTitle: string;
+    settingsSchemeCustomDesc: string;
+    settingsSchemeDetectedSuffix: string;
+    settingsCustomCssTitle: string;
+    settingsCustomCssDesc: string;
+    settingsCustomCssPlaceholder: string;
+    settingsSaveFailed: string;
+    settingsConflict: string;
+    binaryNoPreview: string;
+    downloadToView: string;
+    settingsSubagentTitle: string;
+    settingsSubagentDesc: string;
+    settingsJobsTitle: string;
+    settingsJobsDesc: string;
+    settingsToolsTitle: string;
+    settingsToolsDesc: string;
+    settingsFontFamilyTitle: string;
+    settingsFontFamilyDesc: string;
+    settingsFontFamilyPlaceholder: string;
+    settingsFontSizeTitle: string;
+    settingsFontSizeDesc: string;
+    settingsFontSizeSuffix: string;
+    settingsShellTitle: string;
+    settingsShellDesc: string;
+    settingsShellPlaceholder: string;
+    settingsShellArgsTitle: string;
+    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;
+    browserBack: string;
+    browserForward: string;
+    browserStart: string;
+    browserBlockedScheme: string;
+    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;
+    settingsBrowserLinksDesc: string;
+    settingsBrowserHttpTitle: string;
+    settingsBrowserHttpDesc: string;
+    settingsBrowserHttpsTitle: string;
+    settingsBrowserHttpsDesc: string;
+    browserOpenExternal: string;
+    browserEmbedBlocked: string;
+    browserEmbedBlockedDesc: string;
+    browserEmbedAnyway: string;
+    subagent: string;
+    openSubagent: string;
+    subagentMainAgent: string;
+    subagentEmpty: string;
+    subagentEmptyDesc: string;
+    subagentRunning: string;
+    subagentInactive: string;
+    subagentModeOneShot: string;
+    subagentModeContinuable: string;
+    subagentCount: string;
+    subagentCountRunning: string;
+    subagentDiagCorrupt: string;
+    subagentDiagUnsupported: string;
+    subagentDiagUnavailable: string;
+    subagentThinking: string;
+    sideChat: string;
+    sideChatNew: string;
+    sideChatUntitled: string;
+    sideChatEmpty: string;
+    sideChatEmptyDesc: string;
+    sideChatCreating: string;
+    sideChatRetry: string;
+    sideChatThreads: string;
+    sideChatSave: string;
+    sideChatSaveTitle: string;
+    sideChatSaved: string;
+    sideChatNoTurn: string;
+    sideChatPendingDrop: string;
+    sideChatFirstPlaceholder: string;
+    sideChatComposerPlaceholder: string;
+    sideChatThinking: string;
+    sideChatThink: string;
+    sideChatInjection: string;
+    sideChatSend: string;
+    sideChatCancel: string;
+    sideChatCancelTitle: string;
+    sideChatClose: string;
+    sideChatCloseTitle: string;
+    sideChatError: string;
+    jobs: string;
+    jobsCount: string;
+    jobsCountRunning: string;
+    jobStatusRunning: string;
+    jobStatusStopping: string;
+    jobStatusCompleted: string;
+    jobStatusKilled: string;
+    jobStatusFailed: string;
+    jobDurationSeconds: string;
+    jobDurationMinutes: string;
+    jobDurationHours: string;
+    jobViewOutput: string;
+    jobHideOutput: string;
+    jobNoOutput: string;
+    jobNotReadYet: string;
+    jobOutputTruncated: string;
+    jobOutputError: string;
+    jobKill: string;
+    jobKillConfirm: string;
+    jobKillError: string;
+    addPluginsTabCard: string;
+    addPluginsTabCardDesc: string;
+    addPluginsViewerCard: string;
+    addPluginsViewerCardDesc: string;
+    addPluginsTabDesc: string;
+    addPluginsViewerDesc: string;
+    addPluginsBrowseMore: string;
+    addPluginsSearch: string;
+    addPluginsNoMatch: string;
+    addPluginsRecommended: string;
+    addPluginsEmpty: string;
+    openPlugin: string;
+    copyInstall: string;
+    pluginOfficeDesc: string;
+    pluginFlowglassDesc: string;
+    pluginGitForgeDesc: string;
+    pluginGitRemotesDesc: string;
+    pluginSentinelDesc: string;
+    pluginSidebarQaDesc: string;
+    pluginSshTunnelDesc: string;
+    pluginTurnReviewDesc: string;
+    pluginVideoPreviewDesc: string;
+    pluginDocsPanelDesc: string;
+};
+/** The en dictionary (key-set-equal to zh, enforced by the type annotation). */
+export declare const en: Record<keyof typeof zh, string>;
+/**
+ * The dictionary namespace this plugin owns in the DSH locale registry
+ * (`'sidebar'` is taken by DSH's own ui-sidebar, hence this distinct name).
+ */
+export declare const LOCALE_NS = "betterSidebar";
+/**
+ * Attach (or detach, with undefined) the DSH locale service. The sidebar
+ * mounts its own React root outside the slot system's locale seat, so the
+ * service rides this module-level holder: components keep calling the plain
+ * `t()` function, and the Sidebar root's locale subscription re-renders the
+ * whole tree on switches.
+ */
+export declare function attachLocale(service: {
+    getSnapshot(): {
+        active: string;
+    };
+} | undefined): void;
+/** Translate a copy key in the active locale (zh → zh, else en). */
+export type CopyKey = keyof typeof zh;
+/** Translate a copy key; `{name}` placeholders interpolate from `params`. */
+export declare function t(key: CopyKey, params?: Record<string, string | number>): string;
+/** Whether the active locale is Chinese (used for selectors). */
+export declare function isZh(): boolean;
+/** Format an ISO 8601 author date relative to now (刚刚 / N 分钟前 / N 小时前 / 昨天 / date). */
+export declare function relativeTime(iso: string): string;

package/lib/types/client/mermaid-blocks.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Markdown/mermaid fence detection for the markdown preview. The preview
+ * renders the WHOLE document through one DSH `MarkdownText` pass (so
+ * cross-fence semantics — reference-style links, footnotes, list
+ * continuity — stay intact) and the mermaid lazy chunk then swaps the
+ * rendered `language-mermaid` code blocks for diagrams. This module's pure
+ * splitter exists to detect whether the source contains a mermaid fence at
+ * all, so the mermaid chunk is only fetched when needed (unit-tested in
+ * tests/mermaid-blocks.spec.ts).
+ */
+/** One fenced mermaid diagram lifted out of the markdown source. */
+export interface MermaidBlock {
+    kind: 'mermaid';
+    /** The raw diagram source between the fences (info string stripped). */
+    code: string;
+}
+/** A span of plain markdown source (may itself contain non-mermaid fences). */
+export interface MarkdownBlock {
+    kind: 'markdown';
+    text: string;
+}
+export type MdBlock = MarkdownBlock | MermaidBlock;
+/** Props of the chunk-resident `MermaidMarkdown` component (shared contract). */
+export interface MermaidMarkdownProps {
+    /** The full markdown source (rendered in a single MarkdownText pass). */
+    text: string;
+    codeLabels: {
+        copyLabel: string;
+        copiedLabel: string;
+    };
+}
+/**
+ * Split markdown source into md/mermaid blocks for detection: only fences
+ * whose info string names mermaid are lifted; every other line stays in the
+ * markdown stream untouched. CommonMark fence rules are honored — opening
+ * fences of 3+ backticks OR tildes, and a closing fence must use the same
+ * character with at least as many characters as the opening fence. An
+ * unterminated mermaid fence swallows the rest of the file (the same
+ * recovery CommonMark applies to open fences).
+ */
+export declare function splitMermaidBlocks(text: string): MdBlock[];

package/lib/types/client/mermaid-sanitize.d.ts

@@ -0,0 +1,2 @@
+/** A parse failure keeps nothing of the input: the caller shows the error. */
+export declare function sanitizeSvg(svg: string): string;

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

@@ -0,0 +1,12 @@
+import type { MermaidMarkdownProps } from './mermaid-blocks.ts';
+/**
+ * The chunk-resident markdown preview renderer: ONE MarkdownText pass over
+ * the full source (cross-fence reference/footnote/list semantics intact),
+ * then every rendered `language-mermaid` code block is swapped for a
+ * `MermaidDiagram`. The `.md-code-block` host stays in the React tree —
+ * only its children are replaced — so reconciliation never loses the host;
+ * a block that stops being a mermaid fence gets its original children back.
+ * Only mounted when the source contains at least one mermaid fence (see
+ * TextEditor.tsx).
+ */
+export declare function MermaidMarkdown({ text, codeLabels }: MermaidMarkdownProps): React.ReactNode;

package/lib/types/client/open-when-sized.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Deferred one-shot open for hosts that may not have a real size yet.
+ *
+ * xterm's `Terminal.open()` must not run in a zero-size container: the
+ * renderer creation fails there (the DomRenderer is built from the host's
+ * dimensions), leaving the render service's renderer `undefined`, and the
+ * next Viewport refresh crashes reading `.dimensions` off it. WebKit-based
+ * hosts (WKWebView) reliably report zero while the bottom panel's expand
+ * slide is in flight; any `display:none`-hidden ancestor does the same.
+ *
+ * The caller's `open` callback (open + fit + resize) is invoked exactly
+ * once, on the first frame where the host reports a real size. While the
+ * host stays zero-sized the polling continues every frame; it stops when
+ * the host leaves the document (`isConnected`), so a pending open never
+ * fires after unmount. The returned cancel function drops a pending frame
+ * immediately (idempotent).
+ *
+ * `raf`/`caf` are injectable so tests can drive the polling deterministically.
+ */
+export declare function openWhenSized(host: HTMLElement, open: () => void, raf?: (cb: FrameRequestCallback) => number, caf?: (id: number) => void): () => void;

package/lib/types/client/open-with-settings.d.ts

@@ -0,0 +1,4 @@
+export declare function OpenWithSettings(props: {
+    pluginSettings: Record<string, unknown>;
+    updatePluginSetting: (key: string, value: unknown) => void;
+}): import("react").JSX.Element;

package/lib/types/client/open-with.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The file tree's "open with" vocabulary: which external editors / file
+ * managers the context menu can hand a row's path to, how the per-user
+ * configuration (custom editors, SSH host, pinned ids) is parsed out of the
+ * persisted blob, and how the external URL is built (local `file` URLs and
+ * VSCode-family SSH-remote URLs).
+ *
+ * Pure by design (no React / no `api`), so the whole surface is unit-testable
+ * without a DOM or a host route. The menu and the settings panel only consume
+ * the exported types and functions.
+ */
+import type { CopyKey } from './locales.ts';
+/** One user-configured editor (persisted in `pluginSettings['editor'].openWith`). */
+export interface CustomEditor {
+    id: string;
+    /** Human label shown in the menu (e.g. "Windsurf"). */
+    name: string;
+    /** URL template with a `{path}` placeholder (e.g. `cursor://file/{path}`). */
+    urlTemplate: string;
+    /** Whether the editor speaks the VSCode URL dialect — the only editors
+     *  with an SSH-remote form (`<scheme>://vscode-remote/ssh-remote+<host>/…`). */
+    isVscodeFamily: boolean;
+}
+/** The per-user "open with" configuration (one key of the editor blob). */
+export interface OpenWithConfig {
+    /** SSH host (user@host or an ~/.ssh/config alias); '' = local workspace. */
+    sshHost: string;
+    /** User-defined editors, appended after the built-ins. */
+    customEditors: CustomEditor[];
+    /** Ids of open-with targets pinned to the menu's top level
+     *  ('explorer' | 'vscode' | 'cursor' | 'zed' | 'custom:<id>'). */
+    pinned: string[];
+}
+/** One menu-visible open target (built-in or custom, SSH-filtered). */
+export interface OpenWithTarget {
+    /** Stable id (`explorer` / `vscode` / `cursor` / `zed` / `custom:<id>`). */
+    id: string;
+    /** Locale key of a built-in label (custom editors carry `name` instead). */
+    nameKey?: CopyKey;
+    /** User-defined label (custom editors only; '' for built-ins). */
+    name: string;
+    /** 'reveal' = show in the OS file manager; 'url' = open a URL. */
+    kind: 'reveal' | 'url';
+    /** URL template with `{path}`; undefined for reveal targets. */
+    urlTemplate?: string;
+    /** Whether the editor talks the VSCode URL dialect. */
+    isVscodeFamily: boolean;
+    /** Hidden in SSH mode (a host-local opener cannot reach a remote path). */
+    localOnly: boolean;
+}
+/** The default open-with configuration (fresh documents). */
+export declare const OPEN_WITH_DEFAULTS: OpenWithConfig;
+/** The built-in open targets, in menu order. */
+export declare const OPEN_WITH_BUILTINS: readonly OpenWithTarget[];
+/**
+ * Parse the persisted `openWith` blob (tolerant): malformed fields fall back
+ * to the defaults, malformed custom-editor rows are dropped, and pinned ids
+ * are kept verbatim (unknown ids are pruned when the targets are resolved —
+ * the menu is the only consumer of the resolved list).
+ */
+export declare function parseOpenWithConfig(raw: unknown): OpenWithConfig;
+/**
+ * The menu-visible open targets, in order (built-ins then custom editors).
+ * In SSH mode the local-only targets (the OS file manager, Zed, custom
+ * editors without the VSCode dialect) are dropped — they cannot reach a
+ * remote path. Unknown pinned ids are pruned here too.
+ */
+export declare function resolveOpenWithTargets(config: OpenWithConfig): OpenWithTarget[];
+/** The SSH hint appended to a target's label in remote mode. */
+export declare function openWithSshActive(config: OpenWithConfig): boolean;
+/**
+ * The URL to open for one resolved target, or undefined when the target has
+ * no URL form (reveal) or the template is malformed. The path is inserted
+ * RAW into the template (browsers percent-encode as needed; VSCode-family
+ * URL parsers consume the absolute path with its leading slash, e.g.
+ * `vscode://file//home/u/f.ts` or `vscode://file/C:/Users/u/f.ts`).
+ */
+export declare function openWithUrl(target: OpenWithTarget, path: string, config: OpenWithConfig): string | undefined;
+/** Normalize a filesystem path for embedding in a URL (backslashes → '/'). */
+export declare function normalizeUrlPath(path: string): string;
+/** A fresh custom-editor id (uuid when available, time-based fallback). */
+export declare function newCustomEditorId(): string;
+/** Validate one custom-editor row before the settings panel accepts it. */
+export declare function isValidCustomEditor(row: {
+    name: string;
+    urlTemplate: string;
+}): boolean;

package/lib/types/client/openpath-intercept.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Interception of the chat's file-open funnel. The client runtime's
+ * `ctx.workspaces.openPath` is the SINGLE door every chat-side file open goes
+ * through — ui-conversation's apply.ts resolves the path against the session
+ * cwd and calls it for tool-row path links, the produced-files row, and
+ * prose file mentions alike (verified against the DSH source:
+ * `packages/client/ui-conversation/src/client/apply.ts` is the only
+ * production caller). Wrapping that one method reroutes those opens into the
+ * sidebar editor instead of the Host OS — no DSH modification needed.
+ *
+ * The wrapper is dependency-free by design (no React / ui-primitives), so
+ * the takeover logic is unit-testable and the file stays importable from the
+ * test runtime.
+ */
+/** The one service method the wrapper replaces (mirror of the runtime IWorkspaces). */
+export interface OpenPathService {
+    openPath(path: string): Promise<void>;
+}
+/** Per-call decisions the wrapper needs (wired to the store + ctx in the client half). */
+export interface OpenPathInterceptDeps {
+    /**
+     * Whether to take over this call: the `interceptOpenPath` pref AND the
+     * editor tab's own enable switch must both be on (an editor that cannot
+     * open must not swallow opens — they fall through to the Host).
+     */
+    takeoverEnabled(): boolean;
+    /** The session whose scope the sidebar editor loads the file in (current session). */
+    currentSessionId(): string | undefined;
+    /** Route the open into the sidebar editor (the established openSidebarFile). */
+    openInSidebar(path: string, sessionId: string): void;
+}
+/**
+ * Wrap `workspaces.openPath`: intercepted calls open the file in the sidebar
+ * editor instead of the Host OS and resolve as success (the original's
+ * callers ignore the result); anything that declines falls through to the
+ * original method untouched.
+ * @param workspaces - the client workspaces service to wrap.
+ * @param deps - per-call takeover decisions.
+ * @returns the disposer restoring the original method (HMR-safe).
+ */
+export declare function wrapOpenPath(workspaces: OpenPathService, deps: OpenPathInterceptDeps): () => void;

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

@@ -0,0 +1,35 @@
+/**
+ * Path projection helpers shared by the explorer rows: a path relative to
+ * the session cwd (for the @-reference button and "copy relative path").
+ * The fs-tree joins with '/' even on Windows, so both separators normalize
+ * to '/' before comparison.
+ *
+ * This module is dependency-free (no node:path in the client bundle): the
+ * host is the authority for path semantics, so this mirror deliberately
+ * accepts a SUPERSET of absolute forms — anything a Windows host would emit
+ * (drive letters, UNC) plus POSIX roots. A form the host would reject
+ * (e.g. a backslash UNC path on a POSIX host) passes through here and then
+ * fails loudly in the host's requireAbsolute instead of being silently
+ * joined onto the cwd.
+ */
+/**
+ * Mirror of the host's absolute-path notion (see fs-tree.requireAbsolute):
+ * POSIX roots, Windows drive letters, and Windows UNC network shares in
+ * both backslash (`\\server\share\...`) and forward-slash
+ * (`//server/share/...`) form. Deliberately a superset — see the module
+ * comment — so a produced UNC path is never joined onto the cwd.
+ */
+export declare function isAbsolutePath(path: string): boolean;
+/**
+ * The path relative to the session's working directory.
+ * @param cwd - the explorer root (absolute).
+ * @param path - an absolute entry path from the fs-tree.
+ * @returns the relative path with '/' separators ('.' for the cwd itself),
+ * or `path` unchanged when it lies outside the cwd.
+ *
+ * The prefix test is case-insensitive: Windows paths (and macOS's
+ * case-insensitive volumes) may arrive with different casing than the cwd
+ * row, and the containment decision must not depend on it. The returned
+ * relative text keeps the caller's own casing.
+ */
+export declare function relativeTo(cwd: string, path: string): string;

package/lib/types/client/pdf-types.d.ts

@@ -0,0 +1,2 @@
+/** Pure PDF extension dispatch, separate from React for unit testing. */
+export declare function isPdfExt(ext: string): boolean;

package/lib/types/client/plugin-settings.d.ts

@@ -0,0 +1,8 @@
+import type { SidebarStore } from './state.ts';
+/**
+ * Merge one plugin-owned settings blob of one descriptor and persist it.
+ * @param store - the sidebar store (its prefs are replaced by the write result).
+ * @param descriptorId - the descriptor whose blob is patched ('editor' here).
+ * @param updater - pure patch function; receives a shallow copy of the blob.
+ */
+export declare function updatePluginSettings(store: SidebarStore, descriptorId: string, updater: (blob: Record<string, unknown>) => Record<string, unknown>): void;

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

@@ -0,0 +1,27 @@
+/**
+ * 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).
+ */
+/** The GitHub topic page listing every repo tagged `dsh-better-sidebar`. */
+export declare const PLUGIN_TOPIC_URL = "https://github.com/topics/dsh-better-sidebar";
+/** One curated plugin entry (name / url / description / install script). */
+export interface PluginEntry {
+    /** Unique id (the npm package name). */
+    id: string;
+    /** Short display name. */
+    name: string;
+    /** GitHub repository URL. */
+    url: string;
+    /** One-line description (i18n friendly: string or () => string). */
+    description: string | (() => string);
+    /** Optional catalog group heading (i18n friendly); entries without one
+     *  render under the plain list (a flat catalog stays flat). */
+    category?: string | (() => string);
+    /** The full shell command pre-filled into the install terminal (not
+     *  executed until the user presses Enter). */
+    install: string;
+}

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

@@ -0,0 +1,3 @@
+import type { PluginEntry } from './plugins-shared.ts';
+/** Tab-registration plugins (alphabetical order). */
+export declare const builtinTabPlugins: readonly PluginEntry[];

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

@@ -0,0 +1,3 @@
+import type { PluginEntry } from './plugins-shared.ts';
+/** File-previewer plugins (alphabetical order). */
+export declare const builtinViewerPlugins: readonly PluginEntry[];