@benz-ai-x/dsh-md-preview 0.7.1 → 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/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/locale.d.ts

@@ -72,6 +72,7 @@ export declare const zh: {
     'chip.preview': string;
     'chip.open': string;
     'action.label': string;
+    'dock.browse': string;
     'action.open': string;
     copy: string;
     copied: string;

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.7.1",
+  "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": {