@benz-ai-x/dsh-md-preview 0.4.0 → 0.7.1

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

@@ -1,10 +1,12 @@
 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. */
     sessionId: SessionId;
+    /** Whether the browse face is showing (refreshes revalidate on entry). */
+    active: boolean;
     /** One directory listing; the transport carries the AbortSignal. */
     list(sessionId: SessionId, path: string, signal: AbortSignal): Promise<RemoteResult<MdPreviewListResult>>;
     /** Open one file as the panel's preview target. */
@@ -14,10 +16,21 @@ 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.
  * @returns the tree element.
  */
-export declare function WorkspaceBrowser({ sessionId, list, onOpenFile, currentPath, t }: WorkspaceBrowserProps): import("react").JSX.Element;
+export declare function WorkspaceBrowser({ sessionId, active, list, onOpenFile, currentPath, t }: WorkspaceBrowserProps): import("react").JSX.Element;
 //# sourceMappingURL=WorkspaceBrowser.d.ts.map

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

@@ -0,0 +1,34 @@
+/**
+ * The diagram pass: once the platform renderer settles the document, the
+ * panel enhances mermaid code blocks inside its own rendered subtree. The
+ * block's banner stays (copy keeps reading the source), the code hides, and
+ * mermaid's SVG shows above it. Every failure — a bad diagram, a failed
+ * import, a shape the parity check refuses — falls back to the plain code
+ * block; the platform renderer itself is never touched.
+ */
+/**
+ * The fenced-block languages of one markdown document, in document order —
+ * the info word of each fence, lowercased. Indented (unfenced) code never
+ * lists, so the array aligns 1:1 with the rendered `.md-code-block` sequence.
+ */
+export declare function fenceLanguages(content: string): readonly string[];
+/**
+ * The panel's mermaid blocks: rendered `.md-code-block`s whose backing fence
+ * said mermaid. Matched by order parity — the only stable class the platform
+ * renderer guarantees — and refused wholesale on any count mismatch.
+ */
+export declare function findDiagramBlocks(root: ParentNode, fenceLangs: readonly string[]): readonly HTMLElement[];
+/** Labels the panel injects (locale lives in the React world, not here). */
+export interface DiagramLabels {
+    /** Caption under a block whose diagram failed to render. */
+    readonly error: string;
+}
+/**
+ * Render every not-yet-enhanced mermaid block of one rendered document.
+ * Idempotent per block; safe to re-run after the DOM is replaced.
+ * @param root - the panel's rendered document container.
+ * @param content - the document source backing the rendered container.
+ * @param labels - the fallback caption.
+ */
+export declare function enhanceDiagrams(root: ParentNode, content: string, labels: DiagramLabels): Promise<void>;
+//# sourceMappingURL=diagrams.d.ts.map

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

@@ -1,3 +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. */
@@ -6,11 +20,23 @@ export interface MarkdownEditorProps {
     onChange: (value: string) => void;
     /** Cmd/Ctrl-S from the editor's keymap. */
     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 and save callbacks.
+ * @param props - initial document plus change, save, and view callbacks.
  * @returns the editor host element.
  */
-export declare function MarkdownEditor({ initialValue, onChange, onSave }: 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,8 +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;
@@ -28,6 +50,25 @@ export declare const zh: {
     'browse.empty': string;
     '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;

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

@@ -0,0 +1,45 @@
+/**
+ * The outline: the ATX heading sequence of one previewed document, feeding
+ * the panel header's outline popover. Source-derived so both faces share one
+ * list; fenced code is skipped so `#` lines inside blocks never count, and
+ * setext (underlined) headings stay out by design — the view-face jump
+ * resolves rendered headings by text, the edit-face jump by source line.
+ */
+/** One outline entry: heading level, display text, and its 1-based source line. */
+export interface OutlineEntry {
+    readonly level: number;
+    readonly text: string;
+    readonly line: number;
+}
+/**
+ * Extract the outline of one markdown document.
+ * @param content - the document's full text.
+ * @returns ATX headings in order; fenced code is not scanned.
+ */
+export declare function extractOutline(content: string): readonly OutlineEntry[];
+/**
+ * Resolve the rendered DOM heading of one outline entry.
+ * @param container - the rendered document container.
+ * @param entries - the outline the popover shows.
+ * @param index - the entry being navigated to.
+ * @returns the matching heading element, or undefined when the rendered
+ *   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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@benz-ai-x/dsh-md-preview",
-  "version": "0.4.0",
+  "version": "0.7.1",
   "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": {
@@ -13,9 +13,16 @@
   "keywords": [
     "deepseek-harness",
     "dsh",
-    "plugin",
+    "dsh-plugin",
+    "cordis",
     "markdown",
-    "preview"
+    "markdown-preview",
+    "markdown-editor",
+    "codemirror",
+    "file-browser",
+    "workspace",
+    "preview-panel",
+    "react"
   ],
   "type": "module",
   "main": "./lib/index.js",
@@ -42,7 +49,8 @@
     "lib/typert/remote-client.js",
     "lib/types/**/*.d.ts",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "README.zh.md"
   ],
   "dsh": {
     "bundle": {
@@ -65,7 +73,6 @@
   "scripts": {
     "context:check": "node scripts/verify-dsh-context.mjs",
     "context:check:strict": "node scripts/verify-dsh-context.mjs --require-source",
-    "context:sync": "node scripts/verify-dsh-context.mjs --sync-links --require-source && pnpm install --no-frozen-lockfile",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "build": "tsc -p tsconfig.json && tsdown",
@@ -75,13 +82,17 @@
     "built:check": "node scripts/verify-built.mjs",
     "pack:publishable": "node scripts/pack.mjs",
     "publish:registry": "node scripts/pack.mjs --publish",
-    "verify": "pnpm context:check:strict && pnpm typecheck && pnpm test && pnpm build && pnpm built:check"
+    "verify": "pnpm context:check:strict && pnpm typecheck && pnpm test && pnpm build && pnpm built:check",
+    "prepare": "node scripts/prepare.mjs",
+    "context:link": "node scripts/verify-dsh-context.mjs --sync-links --require-source && pnpm install --no-frozen-lockfile"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "3.18.1",
+    "@deepseek-ai/schemastery": "3.18.2",
+    "tsdown": "^0.22.2",
+    "typescript": "6.0.3",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-typert-protocol": "0.1.2-alpha.3"
+    "@deepseek-ai/dsh-typert-protocol": "0.1.2-rc.1"
   }
 }