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

package/lib/index.js

@@ -12,6 +12,14 @@ const DEFAULT_PREVIEW_EXTENSIONS = [
 	".markdown",
 	".txt"
 ];
+/** Default search result cap: far above real agent-workspace document counts
+* (tens to low hundreds observed in DSH sessions) while bounding one answer. */
+const DEFAULT_SEARCH_MAX_RESULTS = 200;
+/** Default search traversal cap in directories: bounded for any deployment
+* workspace; a pathological tree reports `traversal-limit`, never hangs. */
+const DEFAULT_SEARCH_MAX_DIRECTORIES = 2e3;
+/** Default parallel `listDir` width for one search. */
+const DEFAULT_SEARCH_CONCURRENCY = 8;
 //#endregion
 //#region src/remote.ts
 var __runInitializers = function(thisArg, initializers, value) {
@@ -96,12 +104,14 @@ let MdPreviewService = (() => {
 	let _read_decorators;
 	let _write_decorators;
 	let _list_decorators;
+	let _search_decorators;
 	return class MdPreviewService extends _classSuper {
 		static {
 			const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
 			_read_decorators = [Remote];
 			_write_decorators = [Remote];
 			_list_decorators = [Remote];
+			_search_decorators = [Remote];
 			__esDecorate(this, null, _read_decorators, {
 				kind: "method",
 				name: "read",
@@ -135,6 +145,17 @@ let MdPreviewService = (() => {
 				},
 				metadata: _metadata
 			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _search_decorators, {
+				kind: "method",
+				name: "search",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "search" in obj,
+					get: (obj) => obj.search
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
 			if (_metadata) Object.defineProperty(this, Symbol.metadata, {
 				enumerable: true,
 				configurable: true,
@@ -262,6 +283,78 @@ let MdPreviewService = (() => {
 			};
 		}
 		/**
+		* Search previewable documents by name across the whole session workspace,
+		* including directories the browser face never expanded. First-version
+		* semantics: case-insensitive substring match on the entry name. The walk
+		* stays inside the session authority (root resolve + containment, visited
+		* dedupe so links cannot loop it), never reads file bodies, and reports
+		* honestly whether the answer is complete — a permission failure, a
+		* traversal bound, or the result cap each mark it incomplete with the
+		* matching limit.
+		* @param sessionId - owning session; its header cwd roots the walk.
+		* @param query - raw search text; matched case-insensitively against names.
+		* @param signal - caller cancellation carried through every fs call.
+		* @returns the query, its matches with workspace-relative paths, and
+		*   whether the walk finished whole.
+		* @throws RemoteError with a stable MdPreview failure code.
+		*/
+		async search(sessionId, query, signal) {
+			const q = query.trim().toLowerCase();
+			if (q.length === 0) throw failure("md-preview/bad-request", "mdPreview/search requires a non-empty query");
+			const { root } = await this.resolveContainedTarget(sessionId, "", signal, "search");
+			const rootPath = root.displayPath;
+			const previewable = [...this.config.allowedExtensions, ...this.config.previewExtensions];
+			const matches = [];
+			const limits = /* @__PURE__ */ new Set();
+			const visited = /* @__PURE__ */ new Set([rootPath]);
+			let frontier = [root];
+			while (frontier.length > 0) {
+				if (signal.aborted) throw new DOMException("aborted", "AbortError");
+				const batch = frontier.splice(0, this.config.searchConcurrency);
+				const listings = await Promise.all(batch.map(async (dir) => {
+					try {
+						return { entries: await this.ctx.fs.listDir(dir, signal) };
+					} catch (error) {
+						if (signal.aborted) throw error;
+						return { entries: null };
+					}
+				}));
+				for (const { entries } of listings) {
+					if (entries === null) {
+						limits.add("directory-failure");
+						continue;
+					}
+					for (const entry of entries) {
+						if (entry.type === "file" && entry.name.toLowerCase().includes(q) && isAllowedExtension(entry.name, previewable)) matches.push({
+							name: entry.name,
+							path: workspaceRelative(rootPath, entry.target.displayPath, entry.name)
+						});
+						if (entry.type !== "directory") continue;
+						const child = entry.target.displayPath;
+						if (visited.has(child) || !this.ctx.fs.contains(root, entry.target)) continue;
+						if (visited.size >= this.config.searchMaxDirectories) {
+							limits.add("traversal-limit");
+							continue;
+						}
+						visited.add(child);
+						frontier.push(entry.target);
+					}
+				}
+				if (matches.length >= this.config.searchMaxResults) {
+					limits.add("result-limit");
+					matches.length = this.config.searchMaxResults;
+					break;
+				}
+			}
+			matches.sort((a, b) => a.path.localeCompare(b.path));
+			return {
+				query,
+				matches,
+				complete: limits.size === 0,
+				limits: [...limits]
+			};
+		}
+		/**
 		* The shared authority preamble of the remote methods: resolve a path to a
 		* live, contained, regular workspace file, or reject it with the stable
 		* failure code. One home for the check order and the aborted-rethrow
@@ -329,7 +422,10 @@ let MdPreviewService = (() => {
 const Config = z.object({
 	maxBytes: z.number().min(1).default(DEFAULT_MAX_BYTES),
 	allowedExtensions: z.array(z.string()).default([...DEFAULT_ALLOWED_EXTENSIONS]),
-	previewExtensions: z.array(z.string()).default([...DEFAULT_PREVIEW_EXTENSIONS])
+	previewExtensions: z.array(z.string()).default([...DEFAULT_PREVIEW_EXTENSIONS]),
+	searchMaxResults: z.number().min(1).default(200),
+	searchMaxDirectories: z.number().min(1).default(DEFAULT_SEARCH_MAX_DIRECTORIES),
+	searchConcurrency: z.number().min(1).default(8)
 });
 //#endregion
 //#region src/protocol.ts
@@ -363,11 +459,14 @@ const inject = [
 function apply(ctx, config = {
 	maxBytes: DEFAULT_MAX_BYTES,
 	allowedExtensions: [...DEFAULT_ALLOWED_EXTENSIONS],
-	previewExtensions: [...DEFAULT_PREVIEW_EXTENSIONS]
+	previewExtensions: [...DEFAULT_PREVIEW_EXTENSIONS],
+	searchMaxResults: 200,
+	searchMaxDirectories: DEFAULT_SEARCH_MAX_DIRECTORIES,
+	searchConcurrency: 8
 }) {
 	ctx.plugin(MdPreviewService, config);
 }
 //#endregion
-export { Config, DEFAULT_ALLOWED_EXTENSIONS, DEFAULT_MAX_BYTES, DEFAULT_PREVIEW_EXTENSIONS, MD_PREVIEW_FAILURE_CODES, MdPreviewService, apply, inject, isAllowedExtension, name };
+export { Config, DEFAULT_ALLOWED_EXTENSIONS, DEFAULT_MAX_BYTES, DEFAULT_PREVIEW_EXTENSIONS, DEFAULT_SEARCH_CONCURRENCY, DEFAULT_SEARCH_MAX_DIRECTORIES, DEFAULT_SEARCH_MAX_RESULTS, MD_PREVIEW_FAILURE_CODES, MdPreviewService, apply, inject, isAllowedExtension, name };
 
 //# sourceMappingURL=index.js.map

package/lib/typert/remote-client.js

@@ -38,6 +38,21 @@ const listResult$schema = z.object({
 	path: z.string(),
 	entries: z.array(listEntry$schema)
 });
+const searchQuery$schema = z.string().min(1);
+const searchMatch$schema = z.object({
+	name: z.string(),
+	path: z.string()
+});
+const searchResult$schema = z.object({
+	query: z.string(),
+	matches: z.array(searchMatch$schema),
+	complete: z.boolean(),
+	limits: z.array(z.enum([
+		"directory-failure",
+		"traversal-limit",
+		"result-limit"
+	]))
+});
 /** The MdPreview contribution mounted by this package's browser entry. */
 const TYPERT_REMOTE = {
 	package: "@benz-ai-x/dsh-md-preview",
@@ -170,6 +185,38 @@ const TYPERT_REMOTE = {
 				typeSymbol: "@benz-ai-x/dsh-md-preview#mdPreview/list:result",
 				schema: listResult$schema
 			}
+		},
+		{
+			id: "@benz-ai-x/dsh-md-preview#mdPreview/search",
+			service: "mdPreview",
+			namespace: "mdPreview",
+			method: "search",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "sessionId",
+				wire: "sessionId",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+					schema: readSessionId$schema
+				}
+			}, {
+				name: "query",
+				wire: "query",
+				source: "json",
+				codec: {
+					mode: "strict",
+					typeSymbol: "@benz-ai-x/dsh-md-preview#mdPreview/search:query",
+					schema: searchQuery$schema
+				}
+			}],
+			cancellation: { parameter: "signal" },
+			result: {
+				mode: "strict",
+				typeSymbol: "@benz-ai-x/dsh-md-preview#mdPreview/search:result",
+				schema: searchResult$schema
+			}
 		}
 	]
 };

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

@@ -0,0 +1,7 @@
+/** One 16px icon family for document identity, tree rows and quick entries. */
+export declare function DocumentIcon({ kind, expanded, className }: {
+    kind?: 'directory' | 'markdown' | 'image' | 'text' | 'file';
+    expanded?: boolean;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=DocumentIcon.d.ts.map

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

@@ -0,0 +1,10 @@
+/** The panel relationship shared by the Session Header entry and its close control. */
+export declare const PREVIEW_PANEL_ID = "dsh-md-preview-panel";
+/** Distinct native glyphs for the document entry and close action, with localized next-action labels. */
+export declare function PanelToggle({ open, label, onClick, entry }: {
+    open: boolean;
+    label: string;
+    onClick(): void;
+    entry?: boolean;
+}): import("react").JSX.Element;
+//# sourceMappingURL=PanelToggle.d.ts.map

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

@@ -1,14 +1,19 @@
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { MdPreviewFile, MdPreviewListResult, MdPreviewWriteResult } from '../protocol.ts';
+import type { MdPreviewFile, MdPreviewListResult, MdPreviewSearchResult, MdPreviewWriteResult } from '../protocol.ts';
 import type { MdPreviewState, MdPreviewTarget } from './preview-state.ts';
+import type { LeaveIntentSeat } from './leave-intent.ts';
+import type { ReadingStore } from './reading.ts';
+import type { PanelPreferenceStore } from './preferences.ts';
 /** Read/write/list RPCs and panel dismissal, created in the plugin's apply world. */
 export interface PreviewOverlayInjected {
     hooks: {
         /** Current preview target; null while the panel is closed. */
         previewTarget: SnapshotStore<MdPreviewState>;
     };
+    /** The common leave-intent entry every plugin outlet shares (#21). */
+    leave: LeaveIntentSeat;
     /** Dismiss the panel and drop the target. */
     close(): void;
     /** Set the preview target (the browser face's file-open handoff). */
@@ -19,13 +24,25 @@ export interface PreviewOverlayInjected {
     write(sessionId: SessionId, path: string, content: string, fingerprint: string | undefined, force: boolean, signal: AbortSignal): Promise<import('@deepseek-ai/dsh-typert-protocol').RemoteResult<MdPreviewWriteResult>>;
     /** One workspace directory listing; blank path lists the root. */
     list(sessionId: SessionId, path: string, signal: AbortSignal): Promise<import('@deepseek-ai/dsh-typert-protocol').RemoteResult<MdPreviewListResult>>;
+    /** One workspace document search; the transport carries the AbortSignal. */
+    search(sessionId: SessionId, query: string, signal: AbortSignal): Promise<import('@deepseek-ai/dsh-typert-protocol').RemoteResult<MdPreviewSearchResult>>;
+    /** The reading record store (#25): per-(session, path) positions. */
+    reading: ReadingStore;
+    /** The current-turn outputs seat (#31): the session header's published
+     * view of the newest turn's produced documents. */
+    turnOutputs?: SnapshotStore<{
+        readonly sessionId: SessionId;
+        readonly paths: readonly string[];
+    } | null>;
+    /** The panel preference record (#26): manual geometry and navigation choices. */
+    preferences: PanelPreferenceStore;
 }
 /** Full composed panel props. */
 export type PreviewOverlayProps = PropsRuntime<'shell.overlay'> & InjectFace<PreviewOverlayInjected> & PropsLocale<'md-preview'>;
 /**
  * Render the preview panel for the current target.
- * @param props - target hook, read/write RPCs, dismissal, and the locale seat.
- * @returns the docked panel, or null while closed.
+ * @param props - target hook, leave seat, read/write RPCs, dismissal, and the locale seat.
+ * @returns the docked panel and its hidden shell anchor.
  */
-export declare function PreviewOverlay({ usePreviewTarget, close, setTarget, read, write, list, t }: PreviewOverlayProps): import("react").JSX.Element | null;
+export declare function PreviewOverlay({ usePreviewTarget, useSessions, leave, close, setTarget, read, write, list, search, reading, turnOutputs, preferences, t }: PreviewOverlayProps): import("react").JSX.Element;
 //# sourceMappingURL=PreviewOverlay.d.ts.map

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

@@ -1,7 +1,7 @@
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { MdPreviewEntry, MdPreviewListResult } from '../protocol.ts';
-/** Listing RPC and the file-open handoff, created in the plugin's apply world. */
+import type { MdPreviewListResult, MdPreviewSearchResult } from '../protocol.ts';
+/** Listing RPC, the search 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;
@@ -9,28 +9,41 @@ export interface WorkspaceBrowserProps {
     active: boolean;
     /** One directory listing; the transport carries the AbortSignal. */
     list(sessionId: SessionId, path: string, signal: AbortSignal): Promise<RemoteResult<MdPreviewListResult>>;
+    /** One workspace document search; the transport carries the AbortSignal. */
+    search(sessionId: SessionId, query: string, signal: AbortSignal): Promise<RemoteResult<MdPreviewSearchResult>>;
     /** Open one file as the panel's preview target. */
     onOpenFile(path: string): void;
+    /** Previewable documents the session's newest turn produced (#31); null
+     * while no owning-session facts were published, empty when it produced
+     * none — the section hides either way. */
+    turnOutputs?: readonly string[] | null;
+    /** The session's recently read documents, recency-first (#31). */
+    recentReads?: ReadonlyArray<{
+        readonly path: string;
+    }>;
     /** Workspace-relative path of the current preview target, if any. */
     currentPath: string | null;
+    /** Owning session's cwd, supplied by the platform selector, for display only. */
+    workspaceRoot?: string | undefined;
+    /** The session's continue-reading target, or null without a record (#28). */
+    continueTarget?: {
+        readonly path: string;
+    } | null;
+    /** Open the continue-reading target through the unified leave entry (#28). */
+    onContinue?: () => void;
     /** Locale seat. */
     t(key: string): string;
 }
+/** How long the search box waits for typing to settle before one RPC (#30). */
+export declare const SEARCH_DEBOUNCE_MS = 200;
+/** Quick entries stay few (#31): the caps each section shows. */
+export declare const QUICK_TURN_MAX = 5;
+export declare const QUICK_RECENT_MAX = 3;
 /**
- * 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.
+ * Render the workspace tree (and, while a query is live, the search results)
+ * for one session.
+ * @param props - session identity, listing/search RPCs, file-open handoff, locale seat.
+ * @returns the browse area's tree/search elements.
  */
-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, active, list, onOpenFile, currentPath, t }: WorkspaceBrowserProps): import("react").JSX.Element;
+export declare function WorkspaceBrowser({ sessionId, active, list, search, onOpenFile, turnOutputs, recentReads, currentPath, workspaceRoot, continueTarget, onContinue, t }: WorkspaceBrowserProps): import("react").JSX.Element;
 //# sourceMappingURL=WorkspaceBrowser.d.ts.map

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

@@ -1,23 +1,35 @@
 /**
- * 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.
+ * The document-sidebar toggle: a Session Header utility sitting next to
+ * the shipped Session-log download capsule. One entry with one meaning
+ * (#21): closed enters workspace browsing (the tree face), open requests the
+ * collapse — both through the common leave-intent entry, so a dirty draft is
+ * asked about before the panel folds. The panel owns docking and carries
+ * an X close control while the paperclip header entry stays mounted.
  */
-import type { ReactElement } from 'react';
+import { type ReactElement } from 'react';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 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'>;
+import type { MdPreviewState } from './preview-state.ts';
+import type { LeaveIntentSeat } from './leave-intent.ts';
+import { type TurnOutputsSnapshot } from './turn-files.ts';
+/** The composed props of the header utility: slot kit + inject face + locale. */
+export type WorkspaceDocsActionProps = PropsRuntime<'conversation.session.header.utilities'> & InjectFace<{
+    hooks: {
+        previewTarget: SnapshotStore<MdPreviewState>;
+    };
+    leave: LeaveIntentSeat;
+    /** Publish the session's current-turn outputs into the shared seat (#31). */
+    publishTurnOutputs?(sessionId: SessionId, paths: readonly string[]): void;
+}> & PropsLocale<'md-preview'> & {
+    /** The session binding's chat selector hook (ui-chat's standard source);
+     * absent when that plugin is not composed — nothing publishes then. */
+    useChat?: <T>(selector: (snapshot: TurnOutputsSnapshot) => T) => T;
+};
 /**
- * Render the header browse button for one session.
+ * Render the document sidebar toggle for the showing Session.
  * @param props - the composed action props.
- * @returns the header button.
+ * @returns the header utility button.
  */
-export declare function WorkspaceDocsAction(props: WorkspaceDocsActionProps): ReactElement;
+export declare function WorkspaceDocsAction({ sessionId, usePreviewTarget, leave, publishTurnOutputs, useChat, t }: WorkspaceDocsActionProps): ReactElement;
 //# sourceMappingURL=WorkspaceDocsAction.d.ts.map

package/lib/types/client/document-path.d.ts

@@ -0,0 +1,6 @@
+/** Display-only paths. Opening, saving and reading records keep the original identity. */
+/** Remove the owning session's known workspace prefix, never an inferred root. */
+export declare function workspaceDisplayPath(path: string, workspaceRoot?: string): string;
+/** Parent context without repeating the document name on the second line. */
+export declare function documentParent(path: string): string;
+//# sourceMappingURL=document-path.d.ts.map

package/lib/types/client/leave-intent.d.ts

@@ -0,0 +1,31 @@
+import type { MdPreviewTarget } from './preview-state.ts';
+/** One requested way out of the current preview session. */
+export type MdPreviewLeaveIntent = {
+    readonly kind: 'close';
+} | {
+    readonly kind: 'switchFace';
+} | {
+    readonly kind: 'open';
+    readonly target: MdPreviewTarget;
+};
+/** The leave-intent seat shared by every entry and the guarding panel. */
+export interface LeaveIntentSeat {
+    /**
+     * Request one leave. Ignored while an earlier intent still waits behind
+     * the guard — the pending target cannot be silently replaced.
+     * @param intent - the requested close, face switch, or open.
+     */
+    request(intent: MdPreviewLeaveIntent): void;
+    /** Drop the pending intent (「继续编辑」, or after execution). */
+    clear(): void;
+    /** Snapshot-store subscription face for the panel's binding. */
+    subscribe(listener: () => void): () => void;
+    /** The pending intent, or null while none waits. */
+    getSnapshot(): MdPreviewLeaveIntent | null;
+}
+/**
+ * Create the leave-intent seat for one plugin mount.
+ * @returns the seat to inject into the entries and the preview panel.
+ */
+export declare function createLeaveIntentSeat(): LeaveIntentSeat;
+//# sourceMappingURL=leave-intent.d.ts.map

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

@@ -5,11 +5,15 @@ export declare const NS = "md-preview";
 export declare const zh: {
     'panel.title': string;
     'panel.close': string;
+    'panel.maximize': string;
+    'panel.restore': string;
+    'panel.pickFile': string;
     'panel.loading': string;
     'panel.empty': string;
     'panel.error': string;
     'panel.unsupported': string;
     'panel.retry': string;
+    'panel.failBrowse': string;
     'panel.edit': string;
     'panel.view': string;
     'panel.face': string;
@@ -20,9 +24,12 @@ export declare const zh: {
     'panel.redo': string;
     'status.chars': string;
     'status.saved': string;
+    'status.saving': string;
+    'status.saveFailed': string;
     'status.unsaved': string;
     'status.clean': string;
     'panel.keys': string;
+    'panel.more': string;
     'keys.bold': string;
     'keys.italic': string;
     'keys.link': string;
@@ -37,8 +44,10 @@ export declare const zh: {
     'warn.dismiss': string;
     'panel.saved': string;
     'panel.saveError': string;
+    'panel.saved.readFailed': string;
     'panel.save.retry': string;
     'panel.conflict.title': string;
+    'panel.conflict.hint': string;
     'panel.conflict.reload': string;
     'panel.conflict.force': string;
     'panel.unsaved.title': string;
@@ -51,11 +60,25 @@ export declare const zh: {
     'browse.error': string;
     'browse.retry': string;
     'browse.refresh': string;
-    'browse.filter': string;
-    'browse.noMatch': string;
+    'browse.search': string;
+    'search.label': string;
+    'search.clear': string;
+    'search.results': string;
+    'search.searching': string;
+    'search.none': string;
+    'search.failed': string;
+    'search.retry': string;
+    'search.incomplete': string;
+    'search.limit.directory-failure': string;
+    'search.limit.traversal-limit': string;
+    'search.limit.result-limit': string;
     'rail.files': string;
     'rail.outline': string;
     'rail.noHeadings': string;
+    'continue.read': string;
+    'quick.turn': string;
+    'quick.recent': string;
+    'quick.open': string;
     'outline.open': string;
     'find.status': string;
     'find.phrases.find': string;
@@ -73,6 +96,7 @@ export declare const zh: {
     'chip.open': string;
     'action.label': string;
     'dock.browse': string;
+    'dock.expand': string;
     'action.open': string;
     copy: string;
     copied: string;

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

@@ -17,6 +17,8 @@ export interface OutlineEntry {
  * @returns ATX headings in order; fenced code is not scanned.
  */
 export declare function extractOutline(content: string): readonly OutlineEntry[];
+/** Whitespace-collapsed comparable form of a rendered heading's text. */
+export declare function comparable(text: string): string;
 /**
  * Resolve the rendered DOM heading of one outline entry.
  * @param container - the rendered document container.

package/lib/types/client/panel-dock.d.ts

@@ -0,0 +1,32 @@
+/** Reversible layout adapter for the pinned shell.overlay DOM (ADR-0004). */
+export interface PanelDockRequest {
+    readonly open: boolean;
+    readonly width: number;
+    readonly maximized: boolean;
+}
+export interface PanelDockBounds {
+    readonly left: number;
+    readonly top: number;
+    readonly height: number;
+    readonly width: number;
+    readonly reserved: number;
+}
+/** Resolve presentation geometry without changing the reader's width preference. */
+export declare function panelDockGeometry(available: number, requested: number, open: boolean, maximized: boolean): {
+    width: number;
+    reserved: number;
+};
+/** Ownership handle: frame style, geometry observations, and scheduled work share one lifetime. */
+export interface PanelDock {
+    /** Outside the clipping frame, inside the host root's inert/modal boundary. */
+    readonly container: HTMLElement;
+    update(request: PanelDockRequest): void;
+    dispose(): void;
+}
+/**
+ * Locate only the frame enclosing our own shell contribution. No host DOM is
+ * moved and no feature store or slot occupant is replaced. An unknown mount
+ * keeps the original overlay presentation instead of guessing a frame.
+ */
+export declare function attachPanelDock(anchor: HTMLElement, report: (bounds: PanelDockBounds) => void): PanelDock | null;
+//# sourceMappingURL=panel-dock.d.ts.map

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

@@ -0,0 +1,63 @@
+/**
+ * The panel preference record (#26): what lets the reader's own reading
+ * space survive closes and revisits. UI-local viewing preferences only —
+ * the dragged panel width, the rail width, the rail collapse choice, and
+ * the per-session files/outline choice; never file content, drafts, or
+ * session facts. The envelope is versioned, every loaded value validated,
+ * remembered sessions bounded, and every failing storage call degrades to
+ * the in-memory copy — a first open never lands on a bogus zero width.
+ */
+import type { StorageLike } from './reading.ts';
+/** Envelope format version; an unknown version means an old, unreadable record. */
+export declare const PANEL_PREFERENCE_VERSION = 1;
+/** Panel width support range (the overlay's drag bounds). */
+export declare const PANEL_MIN_WIDTH = 360;
+export declare const PANEL_MAX_WIDTH = 1200;
+export declare const PANEL_DEFAULT_WIDTH = 720;
+/** Rail width support range (the rail's drag bounds). */
+export declare const RAIL_MIN_WIDTH = 120;
+export declare const RAIL_MAX_WIDTH = 320;
+export declare const RAIL_DEFAULT_WIDTH = 220;
+/** Which rail mini-tab the panel shows. */
+export type RailTab = 'files' | 'outline';
+/** The geometry facts a reader may have manually chosen (null = never chosen). */
+export interface PanelGeometryPreferences {
+    readonly panelWidth: number | null;
+    readonly railWidth: number | null;
+    readonly railCollapsed: boolean | null;
+}
+/** The panel-facing preference store. */
+export interface PanelPreferenceStore {
+    /** The remembered geometry (validated; nulls where nothing valid lives). */
+    geometry(): PanelGeometryPreferences;
+    /** Record one or more manual geometry choices (later values win per field). */
+    recordGeometry(partial: Partial<PanelGeometryPreferences>): void;
+    /** The remembered files/outline choice of one session, or null. */
+    railTab(sessionId: string): RailTab | null;
+    /** Record one session's files/outline choice. */
+    recordRailTab(sessionId: string, tab: RailTab): void;
+}
+/** An in-memory StorageLike for tests and for browsers without storage. */
+export declare function createMemoryStorage(): StorageLike;
+/** The browser's localStorage when reachable, else null (memory fallback). */
+export declare function browserStorage(): StorageLike | null;
+/**
+ * Create the panel preference store over one storage backend.
+ * @param storage - the persistence face; failing calls degrade to memory.
+ */
+export declare function createPanelPreferenceStore(storage: StorageLike): PanelPreferenceStore;
+/**
+ * The width to open the panel at: the stored manual width when one exists,
+ * else the default preset — both clamped into the support range and the
+ * live viewport, so a shrunken screen never overflows and an absent value
+ * never lands on a bogus minimum.
+ * @param stored - the remembered manual width, or null when never chosen.
+ * @param viewportWidth - the live viewport width (0 = unknown).
+ */
+export declare function clampPanelWidth(stored: number | null, viewportWidth: number): number;
+/**
+ * The rail width to open at (the same treatment on the rail's own range).
+ * @param stored - the remembered manual rail width, or null.
+ */
+export declare function clampRailWidth(stored: number | null): number;
+//# sourceMappingURL=preferences.d.ts.map