@lijian-ui/dsh-file-manager 0.1.20

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

@@ -0,0 +1,31 @@
+/**
+ * Framework-free drag machinery shared by the React hook (useResizableSplit)
+ * and the DOM layout controller: one pointer-down handler that owns capture,
+ * the rAF-flush loop, the e.buttons === 0 fallback, every end path, and the
+ * drag styles. Pure DOM — no React, so both callers run the exact same
+ * smoothness core (FileManager's useResizableSplit architecture, re-implemented).
+ * @module dsh-filemgr/client/drag
+ */
+export interface DragStartOptions {
+    /** Drag left = grow (handle on the left edge of its container). */
+    reverse: boolean;
+    /** Width at drag start (read at pointer-down time). */
+    getStartWidth: () => number;
+    /** Clamped width from the raw delta (px mode adds deltaX directly). */
+    compute: (startWidth: number, deltaX: number) => number;
+    /** Per-frame flush (rAF-merged; called at most once per frame). */
+    onFrame: (width: number) => void;
+    /** Final commit (also fired on every end path). */
+    onEnd: (width: number) => void;
+}
+/**
+ * Handle one pointer-down: wire capture + window listeners, run the rAF
+ * loop, and end on any of the five termination paths. Call from a
+ * onPointerDown handler (React or plain DOM).
+ * @param event - the raw pointerdown event.
+ * @param el - the handle element (capture target + reverse marker source).
+ * @param opts - drag behavior.
+ * @returns a disposer (idempotent; also called internally on end).
+ */
+export declare function handlePointerDragStart(event: PointerEvent, el: HTMLElement, opts: DragStartOptions): () => void;
+//# sourceMappingURL=drag.d.ts.map

package/lib/types/client/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../../../src/client/drag.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,aAAa,EAAE,MAAM,MAAM,CAAA;IAC3B,uEAAuE;IACvE,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;IACvD,mEAAmE;IACnE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,mDAAmD;IACnD,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AAOD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAqH/G"}

package/lib/types/client/file-source.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The `file` input-trigger source: registers the reference codec the shell's
+ * submit pipeline needs to serialize a file chip (`slash: no serializer for
+ * reference source "file"` disappears once this source is in the roster).
+ *
+ * The source is deliberately INERT as a menu participant: the file picker is
+ * our own pi-desktop-style tree modal (see picker/FilePickerModal.tsx), not
+ * the shell's flat trigger menu, so `candidates` returns nothing and `onPick`
+ * never fires. Its only jobs are (1) to be findable by
+ * `inputTriggers.serializeReference('file', ref)` and (2) to own the model
+ * projection of a chip — the `@path:lines` plain-text token.
+ *
+ * Trigger '@' keeps the chip family visually consistent with the other '@'
+ * sources; the menu group this source contributes is empty and is covered by
+ * the picker modal the moment a bare `@` lands.
+ * @module dsh-filemgr/client/file-source
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+/** The roster name the chip occurrences address (see reference.ts). */
+export declare const FILE_SOURCE_NAME = "file";
+/** Required services: the trigger roster plus the session scope carrier. */
+export declare const inject: string[];
+/**
+ * Register the inert `file` reference source (codec only). Safe to call
+ * multiple times (each call returns a disposer; the roster rejects a
+ * duplicate (trigger, name) seat, so guard with a module flag).
+ */
+export declare function registerFileReferenceSource(ctx: ClientContext): () => void;
+//# sourceMappingURL=file-source.d.ts.map

package/lib/types/client/file-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-source.d.ts","sourceRoot":"","sources":["../../../src/client/file-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAG3E,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,SAAS,CAAA;AAEtC,4EAA4E;AAC5E,eAAO,MAAM,MAAM,UAAoB,CAAA;AAEvC;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,IAAI,CAyB1E"}

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

@@ -0,0 +1,31 @@
+/**
+ * Preview content-type detection from a file name — the router's single
+ * source of truth for what a file becomes when opened (mirrors FileManager's
+ * getFileTypeInfo table, re-derived for the panel's format set).
+ * @module dsh-filemgr/client/fileType
+ */
+import type { PreviewContentType } from '../core/types.ts';
+/** Detect the preview content type of a file by name (lowercased). */
+export declare function detectContentType(name: string): PreviewContentType;
+/** Whether the type can be edited and saved back. */
+export declare function isEditableType(type: PreviewContentType): boolean;
+/** Whether the type reads its content as text (vs image data URL). */
+export declare function isTextType(type: PreviewContentType): boolean;
+/** A stable tab id from the file identity (root + path + type). */
+export declare function tabIdOf(root: string, path: string, type: PreviewContentType): string;
+/** The language hint for code tabs (extension without the dot). */
+export declare function languageOf(name: string): string;
+/** The title for a tab: the basename. */
+export declare function basenameOf(path: string): string;
+/** The parent relative path of a path ('' for a root-level item). */
+export declare function parentRel(path: string): string;
+/**
+ * The streaming URL a pdf tab renders: the host raw route serves the bytes
+ * with mime application/pdf, so the preview iframe loads them directly — no
+ * base64 round-trip and no read-size cap. The nonce defeats browser caching
+ * when the tab is refreshed after the file changed on disk.
+ *
+ * Contributed by EricWang1358 (#239).
+ */
+export declare function pdfPreviewUrl(root: string, path: string, nonce: number): string;
+//# sourceMappingURL=fileType.d.ts.map

package/lib/types/client/fileType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileType.d.ts","sourceRoot":"","sources":["../../../src/client/fileType.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAiD1D,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAwBlE;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAEhE;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAG5D;AAED,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAEpF;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/E"}

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

@@ -0,0 +1,27 @@
+/**
+ * Floating expand button geometry (issues #374 / #292): the button is a
+ * fixed chrome element docked at the viewport's top-right corner, just
+ * below the shell conversation header — the horizontal divider under the
+ * "Session log" row — so the re-expand control sits below the header
+ * chrome instead of overlapping it. Its top stays below the Window
+ * Controls Overlay titlebar strip when dsh-desktop reports one (issue
+ * #292). Every computed position is clamped into the usable range.
+ * @module dsh-filemgr/client/floating
+ */
+/** Breathing room above/below the button (px). */
+export declare const FLOATING_MARGIN_PX = 6;
+/** Gap between the shell header's bottom divider and the button top (px). */
+export declare const FLOATING_HEADER_GAP_PX = 8;
+/** The button's rendered size (kept in sync with tokens.module.css). */
+export declare const FLOATING_BUTTON_HEIGHT_PX = 24;
+/** Top offset of the explorer's collapse chevron inside its tab bar (px).
+ * Used only as a fallback when the shell conversation header is not found
+ * (kept in sync with the chevron rule in tokens.module.css). */
+export declare const COLLAPSE_CHEVRON_TOP_PX = 6;
+/** The WCO titlebar height when visible; 0 in a plain browser tab. */
+export declare function titlebarAreaHeight(): number;
+/** Clamp a requested top px into the usable vertical range. */
+export declare function clampFloatingTop(top: number, viewportHeight: number, buttonHeight: number, titlebar: number): number;
+/** The default top: aligned with the collapse chevron at the top-right. */
+export declare function topAlignedFloatingTop(viewportHeight: number, buttonHeight: number, titlebar: number): number;
+//# sourceMappingURL=floating.d.ts.map

package/lib/types/client/floating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating.d.ts","sourceRoot":"","sources":["../../../src/client/floating.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,IAAI,CAAA;AACnC,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,IAAI,CAAA;AACvC,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAC3C;;gEAEgE;AAChE,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAQxC,sEAAsE;AACtE,wBAAgB,kBAAkB,IAAI,MAAM,CAU3C;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO5G"}

package/lib/types/client/hooks/useResizableSplit.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The panel system's single drag engine hook — a thin React wrapper over the
+ * framework-free machinery in drag.ts (FileManager's useResizableSplit
+ * architecture, re-implemented): px or ratio units, range-validated
+ * localStorage persistence, double-click reset to the default width.
+ * @module dsh-filemgr/client/hooks/useResizableSplit
+ */
+import type { PointerEvent as ReactPointerEvent } from 'react';
+export interface UseResizableSplitOptions {
+    /** Default width (px or percent). */
+    defaultWidth?: number;
+    /** Minimum (same unit). */
+    minWidth?: number;
+    /** Maximum (same unit). */
+    maxWidth?: number;
+    /** localStorage key (preference persistence). */
+    storageKey?: string;
+    /** 'px' for fixed pixel widths, 'ratio' for percents (default 'ratio'). */
+    unit?: 'px' | 'ratio';
+}
+export interface DragHandleProps {
+    onPointerDown: (event: ReactPointerEvent<HTMLDivElement>) => void;
+    onDoubleClick: () => void;
+}
+/**
+ * Resizable-split engine.
+ * @param options - width contract + persistence key.
+ * @returns current width, the committed setter, handle props, and the clamp.
+ */
+export declare function useResizableSplit(options?: UseResizableSplitOptions): {
+    width: number;
+    setWidth: (value: number) => void;
+    handleProps: DragHandleProps;
+    clamp: (value: number) => number;
+    isPx: boolean;
+};
+//# sourceMappingURL=useResizableSplit.d.ts.map

package/lib/types/client/hooks/useResizableSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResizableSplit.d.ts","sourceRoot":"","sources":["../../../../src/client/hooks/useResizableSplit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAI9D,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IACjE,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B;;sBAsBjC,MAAM;;mBAUT,MAAM,KAAG,MAAM;;EAsBlD"}

package/lib/types/client/hooks/useStore.d.ts

@@ -0,0 +1,10 @@
+/**
+ * React bindings for the framework-free stores: useSyncExternalStore with a
+ * stable snapshot (the stores return immutable snapshots, so selector-free
+ * subscription is safe), plus a stable-callback helper for event handlers.
+ * @module dsh-filemgr/client/hooks/useStore
+ */
+import type { StateHandle } from '../store.ts';
+/** Subscribe a component to one store (full snapshot). */
+export declare function useStore<S>(store: StateHandle<S>): S;
+//# sourceMappingURL=useStore.d.ts.map

package/lib/types/client/hooks/useStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStore.d.ts","sourceRoot":"","sources":["../../../../src/client/hooks/useStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAEpD"}

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

@@ -0,0 +1,57 @@
+/**
+ * FileManager right-panel system — browser half: mounts the explorer and preview
+ * columns into the web shell's frame grid (through the layout controller),
+ * binds the four stores to the live client runtime (the active session's cwd
+ * is the project root), subscribes to the host change stream (fs + git), and
+ * follows the shell's dark marker (body[data-ds-dark-theme]) via CSS only.
+ *
+ * Failure policy: every DOM/runtime wiring failure is logged, never thrown —
+ * the web shell fails the whole boot when a plugin apply throws.
+ *
+ * FileManager right-panel design (Apache-2.0, iOfficeAI/FileManager) — re-implemented
+ * from measured behavior and architecture, not copied code.
+ * @module dsh-filemgr/client
+ */
+import type { ClientContext, SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-runtime/client';
+import { type FileManagerPanelKey } from './locales.ts';
+import './styles/chip.module.css';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Panel surface copy. */
+        'filemgr': FileManagerPanelKey;
+    }
+    interface SlotMap {
+        /**
+         * One family plugin card inside the Web UI Plugins group. Spelled here
+         * with the same shape so this package can register without depending on
+         * the sibling web-ui-settings package.
+         */
+        'web-ui.plugin.item': {
+            kind: 'list';
+            scope: 'root';
+            owner: SettingsPluginItemOwnerProps;
+        };
+    }
+}
+/** Owner share of a plugin card (the section supplies nothing). */
+export interface SettingsPluginItemOwnerProps {
+    /** Marker field: card owner props are intentionally empty. */
+    children?: never;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /**
+         * Optional rc.6 compatibility binder provided by dsh-web-ui-settings;
+         * absent when that group plugin is not installed, so callers fall back to
+         * the official settings scope.
+         */
+        webUiSettings?: {
+            bind<S>(spec: SettingsScopeSpec<S>): SettingsScope<S>;
+        };
+    }
+}
+/** Required services: sessions for the project root, locale for the copy, the settings scope for the master switch, and conversation for the composer draft edits (picker insert / @ button). */
+export declare const inject: string[];
+/** Apply the browser half. */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAa,aAAa,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAYxH,OAAO,EAAiC,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAUtF,OAAO,0BAA0B,CAAA;AAEjC,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,0BAA0B;QAC1B,SAAS,EAAE,mBAAmB,CAAA;KAC/B;IAED,UAAU,OAAO;QACf;;;;WAIG;QACH,oBAAoB,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,4BAA4B,CAAA;SAAE,CAAA;KAC3F;CACF;AAED,mEAAmE;AACnE,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf;;;;WAIG;QACH,aAAa,CAAC,EAAE;YAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;SAAE,CAAA;KAC1E;CACF;AAED,iMAAiM;AACjM,eAAO,MAAM,MAAM,UAA0D,CAAA;AAK7E,8BAA8B;AAC9B,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmT9C"}

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

@@ -0,0 +1,104 @@
+/**
+ * The DOM layout controller: extends the web shell's three-column frame
+ * (`[data-dsh-frame]`, a grid) with two trailing grid tracks — the preview
+ * region and the explorer column — by mirroring the shell's own inline
+ * grid-template-columns string and re-appending the two panel tracks on every
+ * shell update (MutationObserver, same frame before paint). Also owns the
+ * absolute drag handles (12px explorer / 20px preview hit zones), the
+ * floating expand button (docked at the top-right corner, just below the
+ * shell header's divider — issues #374 / #292), the collapse-as-width-0
+ * keep-mounted behavior, and the transient
+ * maximize mode (issue #315): while a panel is maximized the target column
+ * takes over the whole frame row (or renders as a fixed full-screen overlay
+ * on narrow viewports), and Esc / the header button restore the layout.
+ *
+ * The shell's inline style is the source of truth for the sidebar and details
+ * tracks; this controller never guesses their widths. Handles are out-of-flow
+ * (absolute), so appending tracks never disturbs the shell's own children.
+ *
+ * FileManager Layout architecture (Apache-2.0, re-implemented): the explorer
+ * column collapses to width 0 while staying mounted; the preview region keeps
+ * a 1px left border only (no outer margins — gaps would expose the window
+ * background, jarring in dark mode).
+ * @module dsh-filemgr/client/layout
+ */
+import type { LayoutStore } from './store.ts';
+/** Read the current frame element (undefined while the shell is not mounted). */
+export declare function getFrameElement(): HTMLElement | null;
+/**
+ * Parse an inline grid-template-columns string into its tracks. Handles
+ * "minmax(0, 1fr)" (spaces inside parens must not split). Empty on failure.
+ */
+export declare function parseGridTracks(input: string): string[];
+/** Extract a px width from one track (0 for fr/minmax/non-px tracks). */
+export declare function trackPx(track: string): number;
+/** One drag handle's geometry (hit zone + visual line) — pure CSS in the module. */
+export declare const EXPLORER_HANDLE_WIDTH = 12;
+export declare const PREVIEW_HANDLE_WIDTH = 20;
+/**
+ * Drag target width: apply the hard px bounds (the same min/max the handle
+ * always enforced), then the store's ordered container-aware clamp so the
+ * grid never re-clamps a width the drag showed.
+ */
+export declare function dragTargetWidth(kind: 'explorer' | 'preview', startWidth: number, deltaX: number, snapshot: {
+    availableWidth: number;
+    previewOpen: boolean;
+    explorerWidth: number;
+}): number;
+/** The layout controller: frame sync, handles, floating button, width math. */
+export declare class PanelLayoutController {
+    private readonly layout;
+    private frame;
+    private previewCol;
+    private explorerCol;
+    private explorerHandle;
+    private previewHandle;
+    private floatingButton;
+    private styleObserver;
+    private sizeObserver;
+    private waitObserver;
+    private frameWidth;
+    /** Cached shell details handle (re-resolved when the shell rebuilds it). */
+    private detailsHandle;
+    /** The shell's own 3 tracks (sidebar, center, details) — mirror of its inline style. */
+    private shellTracks;
+    private instantTimer;
+    private disposers;
+    constructor(layout: LayoutStore);
+    /** Start watching for the frame and attach once it appears. */
+    mount(): void;
+    /** Attach to the frame: columns, handles, observers, store subscription. */
+    private attach;
+    /** Create one drag handle element with its pointer wiring. */
+    private createHandle;
+    /** Toggle explorer collapse (width 0, kept mounted; no transition). */
+    toggleExplorer(): void;
+    /** Toggle the preview region (open = tabs exist; close keeps tabs). */
+    setPreviewOpen(open: boolean): void;
+    /**
+     * Locate the shell conversation header: its bottom border is the
+     * horizontal divider under the "Session log" row the button should
+     * sit below. Resolved per call (the shell may mount it late); null when
+     * the shell has no header (standalone installs, desktop variants).
+     */
+    private findHeaderBottom;
+    /** Position the floating button: docked at the top-right corner, just
+     * below the shell header's bottom divider (fallback: the chevron row). */
+    private positionFloatingButton;
+    /** Apply one store update with transitions disabled for exactly one frame. */
+    private instant;
+    /** Re-write the frame grid and reposition handles + floating button. */
+    private applyGrid;
+    /**
+     * Maximize layout: the target column takes over the whole frame row (the
+     * other tracks collapse to 0px). On narrow viewports the takeover grid is
+     * skipped and the column renders as a fixed full-screen overlay instead
+     * (issue #315). Everything stays mounted — only geometry changes.
+     */
+    private applyMaximized;
+    /** Remove the narrow-screen overlay class from both columns. */
+    private clearMaximizedChrome;
+    /** Detach everything (plugin unload). */
+    dispose(): void;
+}
+//# sourceMappingURL=layout.d.ts.map

package/lib/types/client/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/client/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAiBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAK7C,iFAAiF;AACjF,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAEpD;AAgBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBvD;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAChF,MAAM,CAQR;AAED,+EAA+E;AAC/E,qBAAa,qBAAqB;IAiBpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAhBnC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,UAAU,CAAI;IACtB,4EAA4E;IAC5E,OAAO,CAAC,aAAa,CAA2B;IAChD,wFAAwF;IACxF,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,SAAS,CAAwB;gBACZ,MAAM,EAAE,WAAW;IAEhD,+DAA+D;IAC/D,KAAK,IAAI,IAAI;IAYb,4EAA4E;IAC5E,OAAO,CAAC,MAAM;IAwId,8DAA8D;IAC9D,OAAO,CAAC,YAAY;IAkEpB,uEAAuE;IACvE,cAAc,IAAI,IAAI;IActB,uEAAuE;IACvE,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAOnC;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAWxB;8EAC0E;IAC1E,OAAO,CAAC,sBAAsB;IAa9B,8EAA8E;IAC9E,OAAO,CAAC,OAAO;IAef,wEAAwE;IACxE,OAAO,CAAC,SAAS;IAuEjB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAoBtB,gEAAgE;IAChE,OAAO,CAAC,oBAAoB;IAK5B,yCAAyC;IACzC,OAAO,IAAI,IAAI;CAchB"}

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

@@ -0,0 +1,125 @@
+/**
+ * Locale strings for the panel surfaces (zh/en). The client registers the
+ * dictionary through the locale service like the sibling plugins; copy is
+ * deliberately short and technical.
+ * @module dsh-filemgr/client/locales
+ */
+declare const zh: {
+    readonly 'explorer.tabs.files': "文件";
+    readonly 'explorer.tabs.changes': "变更";
+    readonly 'explorer.search.placeholder': "按文件名搜索";
+    readonly 'explorer.search.searching': "搜索中…";
+    readonly 'explorer.search.empty': "没有匹配的文件";
+    readonly 'explorer.search.error': "搜索失败";
+    readonly 'explorer.search.truncated': "结果过多，仅显示前 {count} 条";
+    readonly 'explorer.tree.empty': "项目为空";
+    readonly 'explorer.collapse': "收起面板";
+    readonly 'explorer.expand': "展开面板";
+    readonly 'explorer.maximize': "最大化文件面板";
+    readonly 'explorer.restore': "还原面板";
+    readonly 'explorer.openPreview': "打开预览";
+    readonly 'explorer.drag.dropHint': "松手插入文件路径";
+    readonly 'scm.repositories': "存储库";
+    readonly 'scm.changes': "变更";
+    readonly 'scm.staged': "已暂存";
+    readonly 'scm.unstaged': "变更";
+    readonly 'scm.untracked': "未跟踪";
+    readonly 'scm.conflicted': "冲突";
+    readonly 'scm.stage': "暂存";
+    readonly 'scm.unstage': "取消暂存";
+    readonly 'scm.discard': "放弃更改";
+    readonly 'scm.stageAll': "全部暂存";
+    readonly 'scm.discardAll': "全部放弃";
+    readonly 'scm.empty': "没有更改";
+    readonly 'scm.notRepo': "当前目录不是 git 仓库";
+    readonly 'scm.gitMissing': "未检测到 git，请先安装 git 后重试";
+    readonly 'scm.loading': "读取状态中…";
+    readonly 'scm.failed': "操作失败";
+    readonly 'scm.viewList': "列表视图";
+    readonly 'scm.viewTree': "树视图";
+    readonly 'scm.discardConfirmTracked': "放弃对 {count} 个文件的更改？此操作不可恢复。";
+    readonly 'scm.discardConfirmUntracked': "删除 {count} 个未跟踪文件？此操作不可恢复。";
+    readonly 'preview.noTabs': "没有打开的预览";
+    readonly 'preview.newUrlTab': "新建 URL 预览";
+    readonly 'preview.collapsePanel': "收起预览面板";
+    readonly 'preview.maximize': "最大化预览面板";
+    readonly 'preview.restore': "还原面板";
+    readonly 'preview.source': "源码";
+    readonly 'preview.preview': "预览";
+    readonly 'preview.editor': "编辑器";
+    readonly 'preview.split': "分屏";
+    readonly 'preview.refresh': "刷新";
+    readonly 'preview.refresh.updated': "文件已在磁盘更新";
+    readonly 'preview.save': "保存";
+    readonly 'preview.download': "下载";
+    readonly 'preview.copyCode': "复制代码";
+    readonly 'preview.copyCodeDone': "已复制";
+    readonly 'preview.openExternal': "在系统应用中打开";
+    readonly 'preview.dirty': "未保存的更改";
+    readonly 'preview.closeLeft': "关闭左侧";
+    readonly 'preview.closeRight': "关闭右侧";
+    readonly 'preview.closeOthers': "关闭其他";
+    readonly 'preview.closeAll': "关闭全部";
+    readonly 'preview.closeConfirmTitle': "关闭未保存的标签页";
+    readonly 'preview.closeConfirmBody': "{count} 个标签页有未保存的更改，关闭将丢失这些更改。";
+    readonly 'preview.saved': "已保存";
+    readonly 'preview.saveConflict': "文件已在磁盘上被修改，保存冲突：请刷新后重试";
+    readonly 'preview.errorOversized': "文件过大，仅加载前 80,000 字符";
+    readonly 'preview.unsupported': "此格式暂不支持预览";
+    readonly 'preview.downloadHint': "可在系统应用中打开或下载查看";
+    readonly 'preview.url.placeholder': "输入网址，回车打开";
+    readonly 'preview.url.hint': "按 Esc 还原";
+    readonly 'common.cancel': "取消";
+    readonly 'common.confirm': "确定";
+    readonly 'common.close': "关闭";
+    readonly 'common.delete': "删除";
+    readonly 'common.copyPath': "复制路径";
+    readonly 'common.copied': "已复制";
+    readonly 'explorer.menu.copyPath': "复制路径";
+    readonly 'explorer.menu.copyName': "复制名称";
+    readonly 'explorer.menu.reveal': "在文件管理器中显示";
+    readonly 'explorer.menu.openWithDefault': "用默认应用打开";
+    readonly 'explorer.menu.rename': "重命名";
+    readonly 'explorer.menu.newFile': "新建文件";
+    readonly 'explorer.menu.newFolder': "新建文件夹";
+    readonly 'explorer.menu.delete': "删除";
+    readonly 'explorer.rename.title': "重命名";
+    readonly 'explorer.newFile.title': "新建文件";
+    readonly 'explorer.newFolder.title': "新建文件夹";
+    readonly 'explorer.deleteConfirmTitle': "删除确认";
+    readonly 'explorer.deleteConfirmBody': "确定要删除「{name}」吗？此操作不可恢复。";
+    readonly 'explorer.opFailed': "操作失败";
+    readonly 'explorer.refToInput': "引用到输入框";
+    readonly 'settings.title': "右侧面板";
+    readonly 'settings.description': "Explorer / Preview 与 SCM 变更面板的总开关。";
+    readonly 'settings.enabled': "启用右侧面板";
+    readonly 'settings.enabledHint': "关闭后不再挂载右侧文件树与预览列、不显示浮动展开按钮、不注册 /filemgr 路由，也不做工作区监视与 git 轮询；聚合包其余插件不受影响。";
+    readonly 'settings.overridden': "已覆盖";
+    readonly 'settings.reset': "恢复默认";
+    readonly 'settings.notExposed': "当前 DSH 版本未向设置页暴露本插件的配置命名空间，表单不可用。可编辑 ~/.dsh/settings.yaml 直接配置，或为 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名单补充本命名空间后重启。";
+    readonly 'settings.readOnly': "当前部署的设置只读。";
+    readonly 'settings.inherit': "继承";
+    readonly 'settings.on': "开";
+    readonly 'settings.off': "关";
+    readonly 'settings.expand': "展开设置";
+    readonly 'settings.collapse': "收起设置";
+    readonly 'settings.save': "保存";
+    readonly 'settings.saving': "保存中…";
+    readonly 'settings.discard': "放弃";
+    readonly 'settings.unsaved': "未保存";
+    readonly 'settings.saveFailed': "部署未接受这些值，已保留供你修改。";
+    readonly 'settings.invalidNumber': "请输入数字，留空则使用默认值。";
+};
+export type FileManagerPanelKey = keyof typeof zh;
+/** The dictionary namespace this plugin owns. */
+export declare const NS = "filemgr";
+/** Format one copy string with {name} placeholders. */
+export declare function format(template: string, params: Record<string, string | number>): string;
+/** Simple dictionary access (zh/en by a global flag the client sets). */
+export declare const dictionaries: Record<'zh' | 'en', Record<FileManagerPanelKey, string>>;
+/** Set the active language (the client mirrors the locale service). */
+export declare function setLanguage(language: string): void;
+/** Translate one key with optional params. */
+export declare function t(key: FileManagerPanelKey, params?: Record<string, string | number>): string;
+export {};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,QAAA,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyGE,CAAA;AA6GV,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,EAAE,CAAA;AAEjD,iDAAiD;AACjD,eAAO,MAAM,EAAE,YAAY,CAAA;AAE3B,uDAAuD;AACvD,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAExF;AAED,yEAAyE;AACzE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAc,CAAA;AAIhG,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,8CAA8C;AAC9C,wBAAgB,CAAC,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAI5F"}

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

@@ -0,0 +1,24 @@
+/**
+ * Maximize-mode geometry (issue #315): when a panel is maximized the layout
+ * controller rewrites the frame grid so the target column takes the whole
+ * row (sidebar, details, chat and the other panel collapse to 0px tracks —
+ * everything stays mounted, nothing unmounts). On narrow viewports the
+ * maximized column instead leaves the grid and renders as a fixed
+ * full-screen overlay (mobile-friendly full-screen mode), so the shell's
+ * own narrow layout stays untouched behind it.
+ * @module dsh-filemgr/client/maximize
+ */
+import type { MaximizeTarget } from './store.ts';
+/** Below this available row width the maximized panel renders as a fixed
+ * full-screen overlay instead of a grid takeover. */
+export declare const MAXIMIZE_OVERLAY_BREAKPOINT_PX = 640;
+/**
+ * The five grid tracks while one panel is maximized: shell sidebar, chat,
+ * shell details and the other panel all collapse to 0px; the target column
+ * takes the whole measured frame width. Tracks are the same string shape the
+ * shell's own inline style uses (px + fr), so nothing else needs to change.
+ */
+export declare function maximizedGridTracks(target: MaximizeTarget, frameWidth: number): string;
+/** Whether the maximized panel should render as a fixed full-screen overlay. */
+export declare function maximizedOverlay(availableWidth: number): boolean;
+//# sourceMappingURL=maximize.d.ts.map

package/lib/types/client/maximize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maximize.d.ts","sourceRoot":"","sources":["../../../src/client/maximize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;qDACqD;AACrD,eAAO,MAAM,8BAA8B,MAAM,CAAA;AAEjD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKtF;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAEhE"}

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

@@ -0,0 +1,44 @@
+/**
+ * The '@' input-trigger source: a lazy directory-tree browser rooted at the
+ * active session's cwd, mirroring the Explorer panel's tree. Each keystroke
+ * lists the addressed directory on demand (no precomputed index); picking a
+ * file lands a plain-text `@<rel-path>` token in the draft — the same readable
+ * reference the Explorer's @-reference button inserts, and the Host validates
+ * it as an existence-only workspace reference.
+ *
+ * Directory navigation: the inline trigger menu cannot expand a directory
+ * (it closes on pick, and the shell only re-runs trigger detection on
+ * keyboard input), so picking a directory opens the tree-browser modal
+ * (FilePickerModal) anchored at that directory — a real recursive tree with
+ * lazy expansion, mirroring the pi-desktop picker.
+ *
+ * Type-only imports from @deepseek-ai/dsh-client-ui-input-trigger/client keep
+ * the client bundle purity gate satisfied (the service itself is injected by
+ * the shell, never bundled here).
+ * @module dsh-filemgr/client/mention
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { InputTriggerServiceContract, InputTriggerSource } from '@deepseek-ai/dsh-client-ui-input-trigger/client';
+import type { PanelApi } from './api.ts';
+declare module '@deepseek-ai/dsh-client-ui-input-trigger/client' {
+    interface InputTriggerCandidate {
+        /** Workspace-relative path (the token we insert). */
+        readonly value?: string;
+        /** Whether the entry is a directory (drives the trailing-slash suffix). */
+        readonly fmIsDir?: boolean;
+    }
+}
+/** Owner source name (lexicon + decoration routing key). Unique per trigger. */
+export declare const SOURCE_NAME = "file-manager";
+/**
+ * Build the '@' trigger source over the injected root context + the PanelApi.
+ * One source per plugin fiber; it reads the live session root on every key so
+ * switching sessions re-roots the browser automatically.
+ * @param ctx - root client context (captured for session projection).
+ * @param api - the panel fs client (lists directories on demand).
+ * @returns the source to register with `inputTriggers.registerSource`.
+ */
+export declare function createFileMentionSource(ctx: ClientContext, api: PanelApi): InputTriggerSource;
+/** The typed service contract the shell injects as `inputTriggers`. */
+export type { InputTriggerServiceContract };
+//# sourceMappingURL=mention.d.ts.map

package/lib/types/client/mention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.d.ts","sourceRoot":"","sources":["../../../src/client/mention.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,wCAAwC,CAAA;AACtF,OAAO,KAAK,EAEV,2BAA2B,EAC3B,kBAAkB,EACnB,MAAM,iDAAiD,CAAA;AAExD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAKxC,OAAO,QAAQ,iDAAiD,CAAC;IAC/D,UAAU,qBAAqB;QAC7B,qDAAqD;QACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;QACvB,2EAA2E;QAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAC3B;CACF;AAED,gFAAgF;AAChF,eAAO,MAAM,WAAW,iBAAiB,CAAA;AAyEzC;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,GAAG,kBAAkB,CAmD7F;AAED,uEAAuE;AACvE,YAAY,EAAE,2BAA2B,EAAE,CAAA"}

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

@@ -0,0 +1,22 @@
+/**
+ * DOM mounting: two React roots rendered into the panel columns the layout
+ * controller appends to the frame grid. The roots wait for their columns
+ * (the shell mounts asynchronously), and everything is wrapped so a DOM
+ * failure degrades the panels, never the GUI boot.
+ * @module dsh-filemgr/client/mount
+ */
+import type { PanelStores } from './store.ts';
+import type { FileReferenceSelection } from './preview/selection.ts';
+/**
+ * Mount both panel roots.
+ * @param stores - the panel store bundle.
+ * @param onToggleExplorer - collapse toggle (owned by the layout controller).
+ * @param onReference - insert a file-reference chip into the draft for a file
+ *   (the Explorer row @-reference button); folders should call a different
+ *   helper because the chip has no line concept for them.
+ * @param onAddFileReference - insert a file-reference chip into the draft for
+ *   a preview selection (path + start/end line).
+ * @returns a disposer unmounting both trees.
+ */
+export declare function mountPanels(stores: PanelStores, onToggleExplorer: () => void, onReference: (path: string, isDir: boolean) => void, onAddFileReference: (selection: FileReferenceSelection) => boolean): () => void;
+//# sourceMappingURL=mount.d.ts.map

package/lib/types/client/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../src/client/mount.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AA0BpE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,MAAM,IAAI,EAC5B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,EACnD,kBAAkB,EAAE,CAAC,SAAS,EAAE,sBAAsB,KAAK,OAAO,GACjE,MAAM,IAAI,CAmBZ"}