@lijian-ui/dsh-file-manager 0.1.20

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

@@ -0,0 +1,104 @@
+/**
+ * Family-shared chrome for plugin settings cards: a disclosure header naming
+ * the plugin and what its settings govern, the controls inside, and the save
+ * that writes them. Renders nothing while the namespace is unavailable — a
+ * deployment that does not compose the owning plugin should show no trace of
+ * it. Inlined into each consumer's client bundle; mirrors the official
+ * ui-plugin-config PluginCard in a self-contained slice.
+ */
+import { type ReactNode } from 'react';
+import type { CardShell } from './settings-form.ts';
+/** Copy keys the card chrome itself reads; every consumer locale carries this shared vocabulary. */
+export declare const CARD_COPY_KEYS: readonly ["settings.collapse", "settings.expand", "settings.notExposed", "settings.unsaved", "settings.readOnly", "settings.saveFailed", "settings.discard", "settings.save", "settings.saving"];
+/** Copy key the card chrome itself reads. */
+export type CardCopyKey = (typeof CARD_COPY_KEYS)[number];
+/** Key domain for the plugin's own copy (inferred per consumer). */
+export type SettingsCardKey<TKey extends string = string> = TKey | CardCopyKey;
+/** Card chrome shared by every plugin settings card. */
+export interface PluginSettingsCardProps<TKey extends string = string> {
+    /** Locale reader for this card's copy. */
+    t: (key: SettingsCardKey<TKey>, params?: Record<string, string | number>) => string;
+    /** Locale key of the plugin's name. */
+    titleKey: TKey;
+    /** Locale key of the line describing what this plugin's settings govern. */
+    descriptionKey: TKey;
+    /** The card's form state: availability, writability, and what a save would do. */
+    state: CardShell;
+    /** Write every staged edit. */
+    onSave: () => void;
+    /** Drop every staged edit. */
+    onDiscard: () => void;
+    /**
+     * Render the controls expanded on arrival (still collapsible). Defaults to
+     * true: promoted first-level sections show their settings immediately.
+     */
+    defaultOpen?: boolean;
+    /**
+     * Render without the collapse affordance: a static header and an always
+     * visible body. Used by first-level settings sections whose nav entry
+     * already provides the selection.
+     */
+    alwaysOpen?: boolean;
+    /** The plugin's controls. */
+    children: ReactNode;
+}
+/**
+ * Render one plugin settings card.
+ * @param props - the plugin's copy keys, its form state, and its controls.
+ * @returns the card, or nothing while the namespace is still loading.
+ */
+export declare function PluginSettingsCard<TKey extends string = string>(props: PluginSettingsCardProps<TKey>): import("react").JSX.Element | null;
+/** Props every field control needs regardless of its value type. */
+export interface FieldProps {
+    /** Stable id associating the label with its control. */
+    id: string;
+    /** Visible label. */
+    label: string;
+    /** One-line explanation rendered under the control. */
+    hint: string;
+    /** Draft text this control renders. */
+    text: string;
+    /** True when saving would leave a user-layer entry for this field. */
+    overridden: boolean;
+    /** True when the draft is not a value this field accepts. */
+    invalid: boolean;
+    /** Copy for the overridden badge. */
+    overriddenLabel: string;
+    /** Copy for the reset control. */
+    resetLabel: string;
+    /** Copy shown in place of the hint while the draft is invalid. */
+    invalidLabel: string;
+    /** Disables every control (read-only document, or an unavailable namespace). */
+    disabled: boolean;
+    /** Stage draft text. */
+    onEdit: (text: string) => void;
+    /** Stage a clear so the field re-inherits the composition layer. */
+    onReset: () => void;
+}
+/** A staged value field. `numeric` only hints the keypad: which drafts a field accepts is decided by its spec. */
+export declare function ValueField(props: FieldProps & {
+    /** Hints a numeric keypad without narrowing what the control accepts. */
+    numeric?: boolean;
+    /** Placeholder shown while the draft is empty. */
+    placeholder?: string;
+}): import("react").JSX.Element;
+/** A staged boolean field: 继承 / 开 / 关. */
+export declare function BooleanField(props: FieldProps & {
+    /** Copy for the inherit option. */
+    inheritLabel: string;
+    /** Copy for the on option. */
+    onLabel: string;
+    /** Copy for the off option. */
+    offLabel: string;
+}): import("react").JSX.Element;
+/** A staged enumerated field rendered as a select. */
+export declare function ChoiceField(props: FieldProps & {
+    /** Copy for the inherit option (draft text is the empty string). */
+    inheritLabel: string;
+    /** Choices rendered in order; `value` is the draft/stored text. */
+    choices: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=PluginSettingsCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PluginSettingsCard.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,75 @@
+/**
+ * Browser client for the host /filemgr/* routes: typed JSON envelope
+ * calls plus the SSE change subscription. Same-origin relative fetch (the
+ * page and the routes share the webserver).
+ * @module dsh-filemgr/client/api
+ */
+import type { DirListing, FileRead, GitBatchResult, GitStatusView, PanelEnvelope, SearchView } from '../core/types.ts';
+/** Typed panel operations over the wire. */
+export declare class PanelApi {
+    /** List one directory of the project root (rel path; '' = root). */
+    list(root: string, path: string): Promise<PanelEnvelope<DirListing>>;
+    /** Read one file (text or image data URL). */
+    read(root: string, path: string, asImage: boolean): Promise<PanelEnvelope<FileRead>>;
+    /** Write text content back with an optional mtime conflict base. */
+    write(root: string, path: string, content: string, baseMtime?: number): Promise<PanelEnvelope<{
+        mtime: number;
+    }>>;
+    /** Filename search under the root. */
+    search(root: string, query: string): Promise<PanelEnvelope<SearchView>>;
+    /** Delete a path (untracked discard). */
+    delete(root: string, path: string): Promise<PanelEnvelope<{
+        ok: true;
+    }>>;
+    /** Reveal a path in the OS file manager (selecting the entry). */
+    reveal(root: string, path: string): Promise<PanelEnvelope<{
+        ok: true;
+    }>>;
+    /** Open a path with the OS default app. */
+    openWithDefault(root: string, path: string): Promise<PanelEnvelope<{
+        ok: true;
+    }>>;
+    /** Rename a path (newName is a bare name, no separators). */
+    rename(root: string, path: string, newName: string): Promise<PanelEnvelope<{
+        ok: true;
+    }>>;
+    /** Create a directory at a relative path (parent must exist). */
+    mkdir(root: string, path: string): Promise<PanelEnvelope<{
+        ok: true;
+    }>>;
+    /** Create an empty file at a relative path (refuses to overwrite). */
+    newFile(root: string, path: string): Promise<PanelEnvelope<{
+        ok: true;
+    }>>;
+    /** The repo status view; null when the root is not a repository. */
+    gitStatus(root: string): Promise<PanelEnvelope<GitStatusView | null>>;
+    /** The unified diff text of one path (staged = index vs HEAD). */
+    gitDiff(root: string, path: string, staged: boolean): Promise<PanelEnvelope<{
+        content: string;
+    }>>;
+    /** Stage paths. */
+    gitStage(root: string, paths: string[]): Promise<PanelEnvelope<GitBatchResult>>;
+    /** Unstage paths. */
+    gitUnstage(root: string, paths: string[]): Promise<PanelEnvelope<GitBatchResult>>;
+    /** Discard paths (worktree side; untracked paths are deleted). */
+    gitDiscard(root: string, paths: string[]): Promise<PanelEnvelope<GitBatchResult>>;
+}
+/** One SSE change event pushed by the host. */
+export type PanelChangeEvent = {
+    kind: 'fs';
+} | {
+    kind: 'git';
+    status: GitStatusView;
+} | {
+    kind: 'gitUnavailable';
+};
+/**
+ * Subscribe to host-pushed changes for one project root (fs watch events and
+ * git status polls). Reconnects are handled by the EventSource; the caller
+ * re-subscribes when the root changes.
+ * @param root - project root to watch.
+ * @param onChange - fired on every pushed change.
+ * @returns the disposer closing the stream.
+ */
+export declare function subscribePanelEvents(root: string, onChange: (event: PanelChangeEvent) => void): () => void;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/client/api.ts"],"names":[],"mappings":"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"}

package/lib/types/client/chat/AttachedFilesDock.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Attached file reference pills, rendered in the `conversation.input.dock`
+ * band directly above the composer card.
+ *
+ * Design: the composer draft is the single source of truth. The pill row is
+ * a pure visual scan of `@<path>:<line>` tokens in the live draft — no
+ * occurrence table, no `slash/input-insert-reference` bail (that path
+ * requires a registered codec and fails with
+ * `no serializer for reference source "file"`), so sending is always a
+ * plain-text sink. Because the row derives from the draft, every mutation
+ * (typing, backspace, send, session switch) updates the pills for free.
+ *
+ * Each pill shows the basename (directory suffix only when the basename is
+ * ambiguous), the line range, and a dismiss × that removes the token from
+ * the draft. The full relative path rides the title tooltip.
+ * @module dsh-filemgr/client/chat/AttachedFilesDock
+ */
+import type { JSX } from 'react';
+import type { ClientContext, SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+/** Minimal structural view of the conversation input service (see reference.ts). */
+interface DraftInput {
+    state: {
+        getSnapshot(): {
+            draft: string;
+            draftRev: number;
+        };
+        subscribe(listener: () => void): () => void;
+    };
+    setDraft(draft: string): void;
+}
+interface ConversationService {
+    input: {
+        for(actx: ClientContext): DraftInput;
+    };
+}
+/**
+ * The dock entry: subscribes to the session's draft and renders one pill per
+ * `@path:line` token. Renders nothing while the draft carries no references.
+ * @param sessionId - the addressed session (the dock is session-scoped).
+ * @param sessions - session scope resolver (actx for the input shell).
+ * @param conversation - conversation service face.
+ */
+export declare function AttachedFilesDock({ sessionId, sessions, conversation, }: {
+    sessionId: SessionId;
+    sessions: {
+        scope(id: SessionId): ClientContext | undefined;
+    };
+    conversation: ConversationService;
+}): JSX.Element | null;
+export {};
+//# sourceMappingURL=AttachedFilesDock.d.ts.map

package/lib/types/client/chat/AttachedFilesDock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachedFilesDock.d.ts","sourceRoot":"","sources":["../../../../src/client/chat/AttachedFilesDock.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AAMtF,oFAAoF;AACpF,UAAU,UAAU;IAClB,KAAK,EAAE;QACL,WAAW,IAAI;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;QAClD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;KAC5C,CAAA;IACD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AACD,UAAU,mBAAmB;IAC3B,KAAK,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAAA;KAAE,CAAA;CAChD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,QAAQ,EACR,YAAY,GACb,EAAE;IACD,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE;QAAE,KAAK,CAAC,EAAE,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAAA;KAAE,CAAA;IAC7D,YAAY,EAAE,mBAAmB,CAAA;CAClC,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAoDrB"}

package/lib/types/client/chat/file-ref.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Chat file-reference click handling (issue #314): the transcript renders
+ * workspace file paths as inline code, and clicking one should locate the
+ * file in the Explorer (switch to the Files tab, expand the ancestor chain,
+ * select the node) and open it in the Preview panel — directories are
+ * reveal-only. A document-level click listener (wired in the client apply)
+ * recognizes a conservative subset: a single-line `code` element whose text
+ * is a workspace-relative path or an absolute path under the project root.
+ * Links (`a`), multi-line fences, URLs, escaped (`..`) paths and anything
+ * inside the panels' own subtrees keep their existing behavior.
+ * @module dsh-filemgr/client/chat/file-ref
+ */
+import type { PanelApi } from '../api.ts';
+import type { PanelStores } from '../store.ts';
+/**
+ * Interpret a code span's text as a workspace path. Returns the workspace
+ * RELATIVE path ('' = the root itself), or null when the text is not a
+ * recognizable in-workspace path. Never resolves above the root: `..`
+ * segments, absolute outside paths, URLs and whitespace/multi-line text all
+ * fall back to null so the transcript keeps its normal behavior.
+ */
+export declare function pathFromText(text: string, root: string): string | null;
+/** The `code` element a click targets, when it is a candidate file ref. */
+export declare function fileRefElement(target: EventTarget | null): HTMLElement | null;
+/**
+ * Locate a workspace-relative path from the transcript: Files tab + expand
+ * ancestors + select; directories stay reveal-only, files also open in the
+ * Preview panel (dedup focuses the existing tab). The parent listing is
+ * consulted to classify the node; unknown paths keep the reveal and never
+ * issue a preview request.
+ */
+export declare function locateFileRef(stores: PanelStores, api: PanelApi, rel: string): Promise<void>;
+/** Document-level click handler: locate recognized chat file references. */
+export declare function handleFileRefClick(stores: PanelStores, api: PanelApi, event: MouseEvent): void;
+//# sourceMappingURL=file-ref.d.ts.map

package/lib/types/client/chat/file-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ref.d.ts","sourceRoot":"","sources":["../../../../src/client/chat/file-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAW9C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BtE;AAkBD,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAU7E;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlG;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAoB9F"}

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

@@ -0,0 +1,30 @@
+/**
+ * Chat-transcript mermaid enhancement: the core conversation renderer emits
+ * fenced code as `pre > code.language-mermaid`, and the shell has no slot
+ * for message-body post-processing — so this component rides the
+ * conversation input dock as a zero-render sentinel and observes the
+ * document for mermaid blocks the transcript mounts. Blocks inside the
+ * preview panel's own subtree are excluded (each surface owns its blocks).
+ *
+ * Streaming awareness: an assistant message re-renders continuously, so a
+ * diagram fence is often incomplete mid-stream. Renders that fail restore
+ * the block and the next mutation retries it — once the fence closes the
+ * diagram lands. Mutations are debounced to one rAF so long transcripts do
+ * not re-scan the whole document: each batch is mapped to the minimal
+ * mutated subtrees and scoped per-frame while the first scheduled pass scans
+ * the body once. The observer is disconnected on unmount.
+ * @module dsh-filemgr/client/chat/mermaid-chat
+ */
+import type { JSX } from 'react';
+/**
+ * Map a mutation batch to the minimal scan scopes that may contain new
+ * mermaid fences. Each record contributes its target and its added nodes
+ * (an added element directly; otherwise that node's parentElement), deduped
+ * by identity. Disconnected nodes and removed-only records yield nothing —
+ * removal never introduces a fence. Pure (DOM-read only) so tests can drive
+ * it in jsdom.
+ */
+export declare function enhanceScopesFor(records: MutationRecord[]): Element[];
+/** Hidden sentinel: renders nothing, owns the transcript observer. */
+export declare function MermaidChatEnhancer(): JSX.Element | null;
+//# sourceMappingURL=mermaid-chat.d.ts.map

package/lib/types/client/chat/mermaid-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-chat.d.ts","sourceRoot":"","sources":["../../../../src/client/chat/mermaid-chat.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAIhC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,CAerE;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAoDxD"}

package/lib/types/client/chat/placeholder-hint.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Composer placeholder hint: the shell owns the input-bar placeholder
+ * ("给智能体发消息") and exposes no override seam (the composer bar is a
+ * single slot owned by ui-conversation, and its locale namespace rejects
+ * duplicate registration), so this zero-render sentinel — riding the same
+ * `conversation.input.dock` band as the mermaid enhancer — rewrites the
+ * placeholder attribute in the DOM. It re-applies on any placeholder
+ * attribute change or node insert, which covers React re-renders that
+ * reset the attribute to the shell default. English UI is left untouched
+ * (exact-match on the Chinese string only).
+ * @module dsh-filemgr/client/chat/placeholder-hint
+ */
+import type { JSX } from 'react';
+/** Hidden sentinel: renders nothing, owns the placeholder rewriting observer. */
+export declare function PlaceholderHint(): JSX.Element | null;
+//# sourceMappingURL=placeholder-hint.d.ts.map

package/lib/types/client/chat/placeholder-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-hint.d.ts","sourceRoot":"","sources":["../../../../src/client/chat/placeholder-hint.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAYhC,iFAAiF;AACjF,wBAAgB,eAAe,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAkBpD"}

package/lib/types/client/components/ExplorerPanel.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The Explorer column: Files/Changes tab bar (37px), the persistent filename
+ * search at the top of the Files tab (150ms debounced; a hit click REVEALS
+ * the file in the tree — expand ancestors + select — never opens preview),
+ * the lazy file tree (34px rows, full-row expand/collapse, 16px icons), and
+ * the in-column collapse chevron.
+ *
+ * FileManager Explorer behavior (Apache-2.0, re-implemented): row click toggles
+ * folders (no need to hit the arrow), search results are reveal-only, and
+ * clicking a file opens it in the preview panel (dedup focuses the tab).
+ * @module dsh-filemgr/client/components/ExplorerPanel
+ */
+import type { JSX } from 'react';
+import type { PanelStores } from '../store.ts';
+import '../styles/tokens.module.css';
+/**
+ * The whole explorer column content.
+ * @param stores - the panel store bundle.
+ * @param onToggleCollapse - collapse the column (host chrome).
+ */
+export declare function ExplorerPanel({ stores, onToggleCollapse, onReference, }: {
+    stores: PanelStores;
+    onToggleCollapse: () => void;
+    onReference: (path: string, isDir: boolean) => void;
+}): JSX.Element;
+//# sourceMappingURL=ExplorerPanel.d.ts.map

package/lib/types/client/components/ExplorerPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplorerPanel.d.ts","sourceRoot":"","sources":["../../../../src/client/components/ExplorerPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAa,GAAG,EAAiC,MAAM,OAAO,CAAA;AAK1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAQ9C,OAAO,6BAA6B,CAAA;AAKpC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,gBAAgB,EAChB,WAAW,GACZ,EAAE;IACD,MAAM,EAAE,WAAW,CAAA;IACnB,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACpD,GAAG,GAAG,CAAC,OAAO,CAyMd"}

package/lib/types/client/components/FileIcon.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 16x16 file/folder icons for the tree — a small built-in set (folder
+ * open/closed, file variants by kind) using the token colors, so both themes
+ * stay consistent without pulling in a vscode-icons package.
+ * @module dsh-filemgr/client/components/FileIcon
+ */
+import type { JSX } from 'react';
+/** The icon for one tree entry (16x16, currentColor). */
+export declare function FileTypeIcon({ name, isDir, expanded, className, }: {
+    name: string;
+    isDir: boolean;
+    expanded: boolean;
+    className?: string;
+}): JSX.Element;
+//# sourceMappingURL=FileIcon.d.ts.map

package/lib/types/client/components/FileIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileIcon.d.ts","sourceRoot":"","sources":["../../../../src/client/components/FileIcon.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAMhC,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,SAAS,GACV,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,GAAG,CAAC,OAAO,CAqBd"}

package/lib/types/client/components/ScmPanel.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The Changes (SCM) panel: per-repo working-tree status grouped into staged /
+ * unstaged / untracked, with stage/unstage/discard actions on every row and
+ * bulk actions in the section header. The host status is the only truth — no
+ * optimistic rows; a failed batch surfaces its paths and the next refresh
+ * clears the flag. Discard confirms with copy split by recoverability
+ * (untracked = delete vs tracked = irreversible restore).
+ *
+ * FileManager ScmPanel behavior (Apache-2.0, re-implemented): window focus
+ * refreshes (external editors write without git events), unknown states
+ * render as a quiet '?', conflicted rows are visually distinct AND have no
+ * actions.
+ * @module dsh-filemgr/client/components/ScmPanel
+ */
+import type { JSX } from 'react';
+import type { PanelStores } from '../store.ts';
+/** The SCM tab body.
+ * @param stores - the panel store bundle.
+ */
+export declare function ScmPanel({ stores }: {
+    stores: PanelStores;
+}): JSX.Element;
+//# sourceMappingURL=ScmPanel.d.ts.map

package/lib/types/client/components/ScmPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScmPanel.d.ts","sourceRoot":"","sources":["../../../../src/client/components/ScmPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAIhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAuC9C;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CA2KzE"}

package/lib/types/client/components/a11y.d.ts

@@ -0,0 +1,12 @@
+import type { KeyboardEvent } from 'react';
+/**
+ * Keyboard activation parity for focusable rows/divs styled as buttons
+ * (role="button" + tabIndex={0}): Enter and Space trigger the same action as
+ * a click, and events bubbling out of nested interactive elements (a row's
+ * inline action buttons, a tab's close control) are ignored so they never
+ * double-activate the row.
+ * @param handler - the activation handler (the element's click action).
+ * @returns a keydown handler for the focusable element.
+ */
+export declare function activateOnKey(handler: () => void): (event: KeyboardEvent<HTMLElement>) => void;
+//# sourceMappingURL=a11y.d.ts.map

package/lib/types/client/components/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../../../src/client/components/a11y.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,IAAI,WAChC,aAAa,CAAC,WAAW,CAAC,KAAG,IAAI,CAOjD"}

package/lib/types/client/components/icons.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Inline 16px icon set for the panel surfaces (outline style, currentColor).
+ * No icon package is introduced; the set covers the explorer tree, SCM rows,
+ * and the preview toolbar/tabs with plain geometric shapes.
+ * @module dsh-filemgr/client/components/icons
+ */
+import type { JSX } from 'react';
+interface IconProps {
+    size?: number;
+    className?: string;
+}
+export declare function FolderIcon({ size, className }: IconProps): JSX.Element;
+export declare function FolderOpenIcon({ size, className }: IconProps): JSX.Element;
+export declare function FileIcon({ size, className }: IconProps): JSX.Element;
+export declare function FileCodeIcon({ size, className }: IconProps): JSX.Element;
+export declare function FileImageIcon({ size, className }: IconProps): JSX.Element;
+export declare function FileTextIcon({ size, className }: IconProps): JSX.Element;
+export declare function ChevronRightIcon({ size, className }: IconProps): JSX.Element;
+export declare function ChevronDownIcon({ size, className }: IconProps): JSX.Element;
+export declare function CloseIcon({ size, className }: IconProps): JSX.Element;
+export declare function PlusIcon({ size, className }: IconProps): JSX.Element;
+export declare function MinusIcon({ size, className }: IconProps): JSX.Element;
+export declare function UndoIcon({ size, className }: IconProps): JSX.Element;
+export declare function RefreshIcon({ size, className }: IconProps): JSX.Element;
+export declare function SplitIcon({ size, className }: IconProps): JSX.Element;
+export declare function CodeIcon({ size, className }: IconProps): JSX.Element;
+export declare function EyeIcon({ size, className }: IconProps): JSX.Element;
+export declare function SaveIcon({ size, className }: IconProps): JSX.Element;
+export declare function DownloadIcon({ size, className }: IconProps): JSX.Element;
+export declare function ExternalIcon({ size, className }: IconProps): JSX.Element;
+export declare function SearchIcon({ size, className }: IconProps): JSX.Element;
+export declare function BranchIcon({ size, className }: IconProps): JSX.Element;
+export declare function ListIcon({ size, className }: IconProps): JSX.Element;
+export declare function TreeIcon({ size, className }: IconProps): JSX.Element;
+export declare function ShrinkIcon({ size, className }: IconProps): JSX.Element;
+export declare function ExpandRightIcon({ size, className }: IconProps): JSX.Element;
+export declare function EmptyFolderIcon({ size, className }: IconProps): JSX.Element;
+export declare function MaximizeIcon({ size, className }: IconProps): JSX.Element;
+export declare function RestoreIcon({ size, className }: IconProps): JSX.Element;
+export {};
+//# sourceMappingURL=icons.d.ts.map

package/lib/types/client/components/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../../src/client/components/icons.tsx"],"names":[],"mappings":"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"}

package/lib/types/client/components/overlay.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Minimal overlay primitives for the panel: a toast and a context menu,
+ * rendered through plain DOM + portals so they can live outside the grid
+ * columns (fixed positioning, high z-index).
+ * @module dsh-filemgr/client/components/overlay
+ */
+import type { JSX } from 'react';
+/** One transient toast message. */
+export declare function toast(message: string): void;
+/** One context-menu entry (separators carry no handler). */
+export interface MenuEntry {
+    key: string;
+    label: string;
+    disabled?: boolean;
+    danger?: boolean;
+    onSelect?: () => void;
+}
+export interface MenuState {
+    x: number;
+    y: number;
+    entries: MenuEntry[];
+}
+/** The shared context-menu portal host (one at a time). */
+export declare function ContextMenu({ state, onClose }: {
+    state: MenuState | null;
+    onClose: () => void;
+}): JSX.Element | null;
+/** A single-text-input dialog (rename, new file / new folder). */
+export declare function PromptDialog({ title, initialValue, confirmLabel, onConfirm, onCancel, }: {
+    title: string;
+    initialValue?: string;
+    confirmLabel?: string;
+    onConfirm: (value: string) => void;
+    onCancel: () => void;
+}): JSX.Element;
+/** A confirmation dialog (dirty-close confirm, discard confirm). */
+export declare function ConfirmDialog({ title, body, confirmLabel, danger, onConfirm, onCancel, }: {
+    title: string;
+    body: string;
+    confirmLabel?: string;
+    danger?: boolean;
+    onConfirm: () => void;
+    onCancel: () => void;
+}): JSX.Element;
+//# sourceMappingURL=overlay.d.ts.map

package/lib/types/client/components/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../../../src/client/components/overlay.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAIhC,mCAAmC;AACnC,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAU3C;AAED,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,OAAO,EAAE,SAAS,EAAE,CAAA;CACrB;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAwEpH;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,GAAG,GAAG,CAAC,OAAO,CAmDd;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,SAAS,EACT,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,GAAG,GAAG,CAAC,OAAO,CA2Bd"}

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

@@ -0,0 +1,31 @@
+/**
+ * Composer dock inlay: the drop target for explorer file drags. It mounts
+ * in the official `conversation.input.dock` band (a session-scoped list
+ * slot declared by the shipped ui-conversation rc.6 shell), so it stacks
+ * with the git-graph chip above the composer card. While a file row is
+ * dragged over the page it shows a hint strip; on drop it splices the
+ * workspace-relative path into the active session's draft through the
+ * conversation input facade.
+ *
+ * The document-level listeners only claim drags carrying our custom MIME —
+ * the composer host's own drop handling (OS image files) is untouched. The
+ * host's `dragover` refuses every drop it does not claim, so this inlay
+ * must `preventDefault` its own drags to make the drop land.
+ * @module dsh-filemgr/client/drag/DragFileInlay
+ */
+import { type ReactElement } from 'react';
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Injected business face of the drag inlay (session-routed). */
+export interface DragFileInjected {
+    /** Splice a workspace-relative path into the active session's draft. */
+    insertPath: (path: string) => boolean;
+}
+/** Composed props: the dock's runtime share (sessionId) + the injected verb. */
+export type DragFileInlayProps = PropsRuntime<'conversation.input.dock'> & DragFileInjected;
+/**
+ * The composer dock entry: a zero-height anchor that shows a hint strip
+ * while a file row is dragged over the page and inserts the path on drop.
+ * @param props - the composed dock entry props.
+ */
+export declare function DragFileInlay(props: DragFileInlayProps): ReactElement;
+//# sourceMappingURL=DragFileInlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DragFileInlay.d.ts","sourceRoot":"","sources":["../../../../src/client/drag/DragFileInlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAMpE,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CACtC;AAED,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAC5B,YAAY,CAAC,yBAAyB,CAAC,GACrC,gBAAgB,CAAA;AAEpB;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAiDrE"}

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

@@ -0,0 +1,47 @@
+/**
+ * Pure drag-to-composer helpers shared by the explorer rows (the drag
+ * source) and the composer dock inlay (the drop target): the custom MIME
+ * type, the drag-state detector, and the draft-splicing rule. Deliberately
+ * framework-free so the splicing math is unit-testable in isolation.
+ *
+ * The composer host only accepts OS image drops (its document-level drop
+ * handler checks `dataTransfer.types` for `Files` and routes through the
+ * image pipeline), so a workspace file needs its own MIME. A plain relative
+ * path is inserted into the draft — the agent reads the file through its
+ * existing tools without any prefix grammar.
+ * @module dsh-filemgr/client/drag/file-drag
+ */
+/** Custom MIME carrying a workspace-relative file path. */
+export declare const FILE_DRAG_MIME = "application/x-dsh-file";
+/**
+ * Whether a drag event carries our file payload.
+ * @param types - the live `dataTransfer.types` list (read-only during drag).
+ * @returns true when our MIME is present.
+ */
+export declare function hasFileDrag(types: readonly string[] | undefined): boolean;
+/**
+ * Whether a drop payload is a plausible workspace-relative path. The custom
+ * MIME only proves the drag carries *some* string — a foreign page can set it
+ * too, so the payload itself is validated before it reaches the draft:
+ * relative POSIX shape only; no absolute paths, no '..' segments, no
+ * backslashes, no control characters, and a sane length.
+ * @param path - the raw payload from dataTransfer.
+ * @returns true when the payload is safe to splice into the draft.
+ */
+export declare function isValidFileDragPayload(path: string): boolean;
+/**
+ * Splice a workspace-relative path into a composer draft at the caret.
+ *
+ * Separator rule: one space is added before the path unless the caret sits
+ * at the start of the draft or right after whitespace; one space is added
+ * after the path unless the caret sits at the end of the draft or right
+ * before whitespace. Empty path or an out-of-range caret are no-ops.
+ *
+ * @param draft - the current draft text.
+ * @param path - the relative path to insert.
+ * @param caret - insertion offset (default: the end of the draft).
+ * @returns the next draft; the caller owns writing it through the input
+ * facade.
+ */
+export declare function insertPathIntoDraft(draft: string, path: string, caret?: number): string;
+//# sourceMappingURL=file-drag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-drag.d.ts","sourceRoot":"","sources":["../../../../src/client/drag/file-drag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,2DAA2D;AAC3D,eAAO,MAAM,cAAc,2BAA2B,CAAA;AAEtD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAQvF"}