@benz-ai-x/dsh-md-preview 0.6.0 → 0.7.2

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

@@ -0,0 +1,31 @@
+/**
+ * The header file-manager action: a collapse/expand button in the
+ * conversation header that opens a workspace file-tree popover. Opening a
+ * file hands it to the right preview panel; the popover stays open for
+ * further picks. jsdom coverage asserts content and behavior, not layout
+ * (no layout engine there).
+ */
+import { type ReactElement } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { MdPreviewListResult } from '../protocol.ts';
+import type { MdPreviewState } from './preview-state.ts';
+/** The composed props of the header action: slot kit + inject face + locale. */
+export type FileManagerActionProps = PropsRuntime<'conversation.session.header.actions'> & InjectFace<{
+    hooks: {
+        previewTarget: SnapshotStore<MdPreviewState>;
+    };
+    list(sessionId: SessionId, path: string, signal: AbortSignal): Promise<import('@deepseek-ai/dsh-typert-protocol').RemoteResult<MdPreviewListResult>>;
+    setTarget(target: {
+        sessionId: SessionId;
+        path: string;
+    } | null): void;
+}> & PropsLocale<'md-preview'>;
+/**
+ * Render the header file-manager button and its popover for one session.
+ * @param props - the composed action props.
+ * @returns the trigger button (popover renders beside it in the panel tree).
+ */
+export declare function FileManagerAction(props: FileManagerActionProps): ReactElement;
+//# sourceMappingURL=FileManagerAction.d.ts.map

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

@@ -0,0 +1,43 @@
+/**
+ * The left-edge document browser: a collapse-style strip hugging the
+ * conversation's left boundary (the app sidebar's right edge) that expands
+ * into the session workspace tree. Opening a file hands it to the right
+ * preview panel — left browser picks, right panel reads. The strip is
+ * driven by a session probe: a null-rendering composer-dock entry that
+ * publishes which conversation is showing.
+ */
+import { type ReactElement } from 'react';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { MdPreviewListResult } from '../protocol.ts';
+/**
+ * Publishes one conversation's session while that conversation shows.
+ * Renders nothing; the activate/deactivate pair comes from the slot's
+ * session-scoped inject closure.
+ */
+export declare function SessionProbe(props: {
+    activate(): void;
+    deactivate(): void;
+}): null;
+/** The composed props of the side browser entry: stores + RPC + locale. */
+export interface SideBrowserProps {
+    /** Selector hook over the conversation probe's session (null without one). */
+    useCurrentSession(selector: (state: unknown) => unknown): unknown;
+    /** Selector hook over the preview target (for the current-file mark). */
+    usePreviewTarget(selector: (state: unknown) => unknown): unknown;
+    /** One directory listing; the transport carries the AbortSignal. */
+    list(sessionId: SessionId, path: string, signal: AbortSignal): Promise<import('@deepseek-ai/dsh-typert-protocol').RemoteResult<MdPreviewListResult>>;
+    /** Open one file in the right preview panel. */
+    setTarget(target: {
+        sessionId: SessionId;
+        path: string;
+    } | null): void;
+    /** Locale seat. */
+    t(key: string): string;
+}
+/**
+ * Render the left-edge strip and, expanded, the workspace tree.
+ * @param props - stores, listing RPC, panel handoff, locale seat.
+ * @returns the side browser, or null while no conversation shows.
+ */
+export declare function SideBrowser({ useCurrentSession, usePreviewTarget, list, setTarget, t }: SideBrowserProps): ReactElement | null;
+//# sourceMappingURL=SideBrowser.d.ts.map

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

@@ -1,6 +1,6 @@
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { MdPreviewListResult } from '../protocol.ts';
+import type { MdPreviewEntry, MdPreviewListResult } from '../protocol.ts';
 /** Listing RPC and the file-open handoff, created in the plugin's apply world. */
 export interface WorkspaceBrowserProps {
     /** Owning session whose workspace the tree roots at. */
@@ -16,6 +16,17 @@ export interface WorkspaceBrowserProps {
     /** Locale seat. */
     t(key: string): string;
 }
+/**
+ * Entries visible under a filter query (#13): a name match, or a loaded
+ * descendant match, keeps an entry. A name-matched directory keeps its
+ * whole subtree (the caller renders children unfiltered from there).
+ * @param entries - one directory level, in listing order.
+ * @param query - the raw filter text; blank shows everything.
+ * @param childrenOf - resolves a loaded directory's entries (undefined
+ *   while unloaded or failed).
+ * @returns the entries this level should render.
+ */
+export declare function filterEntries(entries: readonly MdPreviewEntry[], query: string, childrenOf: (path: string) => readonly MdPreviewEntry[] | undefined): readonly MdPreviewEntry[];
 /**
  * Render the workspace tree for one session.
  * @param props - session identity, listing RPC, file-open handoff, locale seat.

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

@@ -0,0 +1,23 @@
+/**
+ * The header browse action: a file-tree button in the conversation header
+ * that opens the right preview panel on its browse face — the workspace
+ * tree shows first, and opening a file reads it in the document face.
+ */
+import type { ReactElement } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+/** The composed props of the header action: slot kit + inject face + locale. */
+export type WorkspaceDocsActionProps = PropsRuntime<'conversation.session.header.actions'> & InjectFace<{
+    setTarget(target: {
+        sessionId: SessionId;
+        path: string;
+        face: 'browse';
+    }): void;
+}> & PropsLocale<'md-preview'>;
+/**
+ * Render the header browse button for one session.
+ * @param props - the composed action props.
+ * @returns the header button.
+ */
+export declare function WorkspaceDocsAction(props: WorkspaceDocsActionProps): ReactElement;
+//# sourceMappingURL=WorkspaceDocsAction.d.ts.map

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

@@ -0,0 +1,40 @@
+/**
+ * The composer-dock entry: opens the preview panel on the session's
+ * workspace without waiting for a turn that produced markdown — the dock
+ * button lists the root, picks its first previewable file, and sets the
+ * preview target; an empty root shows a transient hint instead.
+ */
+import { type ReactElement } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { MdPreviewEntry } from '../protocol.ts';
+/**
+ * The first previewable file of a root listing.
+ * @param entries - one directory level, in listing order.
+ * @returns its workspace-relative path, or null when nothing previews.
+ */
+export declare function firstPreviewablePath(entries: readonly MdPreviewEntry[]): string | null;
+/** Props: the mount-bound open action plus the dock's locale seat. */
+export interface WorkspaceDocsDockProps {
+    /** Lists the workspace root and opens the first previewable file.
+     * Resolves 'none' when the root has nothing previewable. */
+    openWorkspace: () => Promise<'opened' | 'none'>;
+    /** Locale seat. */
+    t(key: string): string;
+}
+/** The registered header action: session slot kit + injected face + locale. */
+export type WorkspaceDocsDockActionProps = PropsRuntime<'conversation.session.header.actions'> & InjectFace<{
+    openWorkspace: () => Promise<'opened' | 'none'>;
+}> & PropsLocale<'md-preview'>;
+/**
+ * Bind the slot's injected face into the presentational entry.
+ * @param props - the header action's composed props.
+ * @returns the header entry element.
+ */
+export declare function WorkspaceDocsDockAction(props: WorkspaceDocsDockActionProps): ReactElement;
+/**
+ * Render the dock entry for one session's workspace.
+ * @param props - the bound open action and locale seat.
+ * @returns the entry button (or its transient empty hint).
+ */
+export declare function WorkspaceDocsDock({ openWorkspace, t }: WorkspaceDocsDockProps): import("react").JSX.Element;
+//# sourceMappingURL=WorkspaceDocsDock.d.ts.map

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

@@ -0,0 +1,29 @@
+/**
+ * The 文档 conversation view: the session workspace tree rendered inside
+ * the conversation area as a view tab (beside 对话/轨迹). Opening a file
+ * sets the preview target — the docked panel takes it from there.
+ */
+import type { ReactElement } from 'react';
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { MdPreviewState } from './preview-state.ts';
+import type { MdPreviewListResult } from '../protocol.ts';
+/** The composed props of the docs view tab: session kit + inject face + locale. */
+export type WorkspaceDocsViewProps = ConvViewProps & InjectFace<{
+    hooks: {
+        previewTarget: SnapshotStore<MdPreviewState>;
+    };
+    list(sessionId: string, path: string, signal: AbortSignal): Promise<import('@deepseek-ai/dsh-typert-protocol').RemoteResult<MdPreviewListResult>>;
+    setTarget(target: {
+        sessionId: string;
+        path: string;
+    } | null): void;
+}> & PropsLocale<'md-preview'>;
+/**
+ * Render the docs view tab body for one session.
+ * @param props - the view's composed props.
+ * @returns the workspace tree element.
+ */
+export declare function WorkspaceDocsView({ sessionId, usePreviewTarget, list, setTarget, t }: WorkspaceDocsViewProps): ReactElement;
+//# sourceMappingURL=WorkspaceDocsView.d.ts.map

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

@@ -1,4 +1,17 @@
 import { EditorView } from '@codemirror/view';
+/** What the find chip shows: total matches and the current one (1-based). */
+export interface SearchStatus {
+    readonly count: number;
+    readonly index: number;
+}
+/** What the edit status bar shows (#15), plus history availability. */
+export interface EditorStatus {
+    readonly line: number;
+    readonly col: number;
+    readonly chars: number;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+}
 /** Props the panel hands to the editor. */
 export interface MarkdownEditorProps {
     /** Document text at edit-session start; a changed value remounts the editor. */
@@ -9,11 +22,21 @@ export interface MarkdownEditorProps {
     onSave: () => void;
     /** Reports the mounted editor view (null on unmount) for panel-side calls. */
     onView?: (view: EditorView | null) => void;
+    /** Reports the cursor's 1-based line at mount and on doc/selection change. */
+    onCursorLine?: (line: number) => void;
+    /** Status-bar payload at mount and on doc/selection/history change; null on unmount. */
+    onStatus?: (status: EditorStatus | null) => void;
+    /** Opens the panel's keymap help (bound to Mod-/ inside the editor). */
+    onOpenKeys?: () => void;
+    /** Search panel localization: CM stock phrase key → panel word. */
+    searchPhrases?: Readonly<Record<string, string>>;
+    /** Match count and 1-based current index; null while search is inactive. */
+    onSearchStatus?: (status: SearchStatus | null) => void;
 }
 /**
  * Render one CodeMirror editor bound to the panel's edit session.
  * @param props - initial document plus change, save, and view callbacks.
  * @returns the editor host element.
  */
-export declare function MarkdownEditor({ initialValue, onChange, onSave, onView }: MarkdownEditorProps): import("react").JSX.Element;
+export declare function MarkdownEditor({ initialValue, onChange, onSave, onView, onCursorLine, onStatus, onOpenKeys, searchPhrases, onSearchStatus }: MarkdownEditorProps): import("react").JSX.Element;
 //# sourceMappingURL=editor.d.ts.map

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

@@ -11,9 +11,30 @@ export declare const zh: {
     'panel.unsupported': string;
     'panel.retry': string;
     'panel.edit': string;
+    'panel.view': string;
+    'panel.face': string;
     'panel.save': string;
     'panel.cancel': string;
     'panel.find': string;
+    'panel.undo': string;
+    'panel.redo': string;
+    'status.chars': string;
+    'status.saved': string;
+    'status.unsaved': string;
+    'status.clean': string;
+    'panel.keys': string;
+    'keys.bold': string;
+    'keys.italic': string;
+    'keys.link': string;
+    'keys.find': string;
+    'keys.save': string;
+    'keys.undo': string;
+    'keys.outline': string;
+    'keys.files': string;
+    'keys.help': string;
+    'keys.dismiss': string;
+    'warn.html': string;
+    'warn.dismiss': string;
     'panel.saved': string;
     'panel.saveError': string;
     'panel.save.retry': string;
@@ -30,11 +51,28 @@ export declare const zh: {
     'browse.error': string;
     'browse.retry': string;
     'browse.refresh': string;
+    'browse.filter': string;
+    'browse.noMatch': string;
+    'rail.files': string;
+    'rail.outline': string;
+    'rail.noHeadings': string;
     'outline.open': string;
+    'find.status': string;
+    'find.phrases.find': string;
+    'find.phrases.replace': string;
+    'find.phrases.next': string;
+    'find.phrases.previous': string;
+    'find.phrases.all': string;
+    'find.phrases.matchCase': string;
+    'find.phrases.regexp': string;
+    'find.phrases.byWord': string;
+    'find.phrases.replaceAll': string;
+    'find.phrases.close': string;
     'diagram.error': string;
     'chip.preview': string;
     'chip.open': string;
     'action.label': string;
+    'dock.browse': string;
     'action.open': string;
     copy: string;
     copied: string;

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

@@ -26,4 +26,20 @@ export declare function extractOutline(content: string): readonly OutlineEntry[]
  *   document spells it differently (setext forms the source scan skips).
  */
 export declare function findHeadingElement(container: ParentNode | null, entries: readonly OutlineEntry[], index: number): HTMLElement | undefined;
+/**
+ * The outline entry a source position falls under: the last entry whose
+ * 1-based line is at or above it.
+ * @param entries - the outline in document order.
+ * @param line - the 1-based source line of the position.
+ * @returns the owning entry's index, or -1 above the first heading.
+ */
+export declare function activeIndexForLine(entries: readonly OutlineEntry[], line: number): number;
+/**
+ * The outline entry a scroll position falls under: the last heading whose
+ * document offset is at or above the scroll position.
+ * @param tops - each heading's offset from the top of the scrolled document.
+ * @param scrollTop - the scroller's current offset.
+ * @returns the active entry's index, or -1 above the first heading.
+ */
+export declare function activeIndexForScroll(tops: readonly number[], scrollTop: number): number;
 //# sourceMappingURL=outline.d.ts.map

package/lib/types/client/preview-state.d.ts

@@ -4,6 +4,8 @@ import type { SessionId } from '@deepseek-ai/dsh-session/types';
 export interface MdPreviewTarget {
     readonly sessionId: SessionId;
     readonly path: string;
+    /** Entry face for the panel (default 'document'); 'browse' opens on the tree. */
+    readonly face?: 'document' | 'browse';
 }
 /** Whole preview panel state: the current target or the closed state. */
 export type MdPreviewState = MdPreviewTarget | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@benz-ai-x/dsh-md-preview",
-  "version": "0.6.0",
+  "version": "0.7.2",
   "description": "DSH markdown preview: clicking a markdown document in the conversation opens a rendered preview panel docked to the right of the chat.",
   "license": "MIT",
   "repository": {