@deepseek-ai/dsh-client-ui-sidebar-documentpreview 0.1.6-alpha.1 → 0.1.7-alpha.1

package/lib/index.js

@@ -1,6 +1,35 @@
+import z from "@deepseek-ai/schemastery";
+//#region lib/types/config.js
+/** Cache limits shared by the Host configuration and browser document previews. */
+/** Deployment limits applied before Office preview registration. */
+const Config = z.object({
+	office: z.object({
+		maxCachedEntries: z.natural().min(1).max(Number.MAX_SAFE_INTEGER).default(8),
+		maxCachedBytes: z.natural().min(1).max(Number.MAX_SAFE_INTEGER).default(64 * 1024 * 1024),
+		maxPending: z.natural().min(1).max(Number.MAX_SAFE_INTEGER).default(8),
+		maxReaders: z.natural().min(1).max(Number.MAX_SAFE_INTEGER).default(32)
+	}),
+	excel: z.object({
+		maxBytes: z.natural().min(1).max(Number.MAX_SAFE_INTEGER).default(16 * 1024 * 1024),
+		maxCells: z.natural().min(1).max(Number.MAX_SAFE_INTEGER).default(25e4),
+		timeoutMs: z.natural().min(1).max(2147483647).default(15e3)
+	})
+});
+//#endregion
 //#region lib/types/index.js
-/** Pure host half; the whole preview lives in the browser export. */
-/** Host plugin body: the preview contributes nothing to the host tree. */
-function apply() {}
+/**
+* Embed validated preview settings in browser pages.
+* @param ctx - Host context serving browser pages.
+* @param config - Cache limits adopted when the page loads.
+*/
+function apply(ctx, config) {
+	ctx.on("webserver/index-inject", (table) => {
+		table.push({
+			kind: "global",
+			name: "__DSH_DOCUMENT_PREVIEW_CONFIG__",
+			value: config
+		});
+	});
+}
 //#endregion
-export { apply };
+export { Config, apply };

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

@@ -13,11 +13,11 @@ export interface TextPreviewInjected extends TextInjected {
     };
 }
 /** The body's composed props: the tab, its navigation, the shared store and face, and copy. */
-export type TextPreviewProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsRenderSlots<'sidebar.right.tab.document'> & PropsStore<TextStore> & InjectFace<TextPreviewInjected> & PropsLocale<'sidebarDocumentPreview'>;
+export type TextPreviewProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsRenderSlots<'sidebar.right.tab.document' | 'sidebar.right.tab.document.action' | 'sidebar.right.tab.document.actions' | 'sidebar.right.tab.document.unpreviewable'> & PropsStore<TextStore> & InjectFace<TextPreviewInjected> & PropsLocale<'sidebarDocumentPreview'>;
 /**
  * The text type's body, registered under `sidebar.right.pane.tab` as `text`.
  * @param props - composed slot props.
  * @returns the content read so far with its controls, or a progress line.
  */
-export declare function TextPreview({ useTabInfo, useResource, useStore, actions, loadPage, reloadPages, loadAll, reloadAll, useDocumentPreviews, renderSlot, t, }: TextPreviewProps): ReactNode;
+export declare function TextPreview({ useTabInfo, useResource, useStore, actions, loadPage, reloadPages, loadAll, reloadAll, prepareRenderer, useDocumentPreviews, renderSlot, t, addResource, setResources, }: TextPreviewProps): ReactNode;
 //# sourceMappingURL=TextPreview.d.ts.map

package/lib/types/client/document/contract.d.ts

@@ -9,7 +9,7 @@ export interface DocumentTextPage {
     readonly lines: number;
 }
 /**
- * Contents prepared by the preview owner using ordinary file reads.
+ * Ordinary file contents, or a request for the selected renderer to load its content.
  * Byte arrays are transient UI input, never persisted layout or Session data.
  */
 export type DocumentContent = {
@@ -20,22 +20,76 @@ export type DocumentContent = {
 } | {
     readonly kind: 'bytes';
     readonly data: Uint8Array<ArrayBuffer>;
+} | {
+    readonly kind: 'renderer';
+    /** Changes on reload or implementation replacement; retained contents belong to one revision. */
+    readonly revision: number;
+    /** Report the displayed source version; stale revisions cannot update the owner. @param version - loaded source version. */
+    readonly loaded: (version: string) => void;
+    /** End a failed load; a later file change can start another revision. */
+    readonly failed: () => void;
+    /** Cancel the current load and start a new revision. */
+    readonly reload: () => void;
 };
+/** Content and viewing inputs shared by document bodies and nested PDF presentation. */
+export interface DocumentBodyOwner {
+    /** Observe a file read by this renderer. @param address - complete file resource address. */
+    readonly addResource: (address: string) => void;
+    /** Replace this renderer's dependencies. @param addresses - complete file resource addresses. */
+    readonly setResources: (addresses: readonly string[]) => void;
+    /** Original file address, also readable through the standard useResource hook. */
+    readonly resourceAddress: string;
+    /** Ordinary file content or a renderer-owned loading request; text accumulates until eof. */
+    readonly content: DocumentContent;
+    /** The document toolbar's current wrapping preference. */
+    readonly wrap: boolean;
+    /** Report a renderer-owned scrollport; passing `null` restores the shared body as the owner. */
+    readonly scrollportRef: RefCallback<HTMLElement>;
+}
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface SlotMap {
         /** Document body selected by a registered implementation id. */
         'sidebar.right.tab.document': {
+            kind: 'keyed';
+            scope: 'session';
+            owner: DocumentBodyOwner;
+            hookContext: UseSidebarRightTabInfo;
+            inject: {
+                hooks: {
+                    tabInfo: SlotHookFactory<'sidebar.right.tab.document', UseSidebarRightTabInfo>;
+                };
+            };
+        };
+        /**
+         * Header toolbar contributions acting on the previewed file, rendered
+         * after the preview's own controls once the file's Host path is known.
+         */
+        'sidebar.right.tab.document.actions': {
+            kind: 'list';
+            scope: 'session';
+            owner: {
+                /** Absolute path in the file's execution environment; native actions must verify a Host mapping. */
+                readonly absolutePath: string;
+            };
+        };
+        /**
+         * Empty-state contributions for a file this preview cannot render,
+         * offered where Retry would stand once the file's Host path is known.
+         */
+        'sidebar.right.tab.document.unpreviewable': {
+            kind: 'list';
+            scope: 'session';
+            owner: {
+                /** Absolute path in the file's execution environment; native actions must verify a Host mapping. */
+                readonly absolutePath: string;
+            };
+        };
+        /** Renderer-specific controls before the document toolbar's reload button. */
+        'sidebar.right.tab.document.action': {
             kind: 'keyed';
             scope: 'session';
             owner: {
-                /** Original file address, also readable through the standard useResource hook. */
-                readonly resourceAddress: string;
-                /** Loaded content; text is an accumulated prefix until eof. */
                 readonly content: DocumentContent;
-                /** The document toolbar's current wrapping preference. */
-                readonly wrap: boolean;
-                /** Report a renderer-owned scrollport; passing `null` restores the shared body as the owner. */
-                readonly scrollportRef: RefCallback<HTMLElement>;
             };
             hookContext: UseSidebarRightTabInfo;
             inject: {

package/lib/types/client/document/registry.d.ts

@@ -1,5 +1,5 @@
-/** How the document owner delivers file contents to a renderer. */
-export type DocumentLoadMode = 'text-pages' | 'bytes-complete';
+/** Shared text or byte reads, or content loading owned by the renderer. */
+export type DocumentLoadMode = 'text-pages' | 'bytes-complete' | 'renderer';
 /** One renderer implementation, independent of its component registration. */
 export interface DocumentPreviewDefinition {
     /** Unique implementation name, also used as the document slot key. */

package/lib/types/client/document/resource-group.d.ts

@@ -0,0 +1,23 @@
+/** File-resource membership and invalidation for one document preview. */
+import type { Resources } from '@deepseek-ai/dsh-client-resources/client';
+/** Forwards member metadata changes to one document preview. */
+export declare class ResourceGroup {
+    private readonly resources;
+    private readonly changed;
+    private readonly members;
+    /** @param resources - shared file sources. @param changed - marks the owning preview stale. */
+    constructor(resources: Resources, changed: () => void);
+    /**
+     * Subscribe once; initial metadata establishes the baseline for later changes.
+     * @param address - complete resource address.
+     */
+    add(address: string): void;
+    /**
+     * Release dependencies absent from the current document.
+     * @param addresses - complete membership of the latest document load.
+     */
+    set(addresses: readonly string[]): void;
+    /** Release every member when the preview tab ends. */
+    close(): void;
+}
+//# sourceMappingURL=resource-group.d.ts.map

package/lib/types/client/document/tab-lifetime.d.ts

@@ -0,0 +1,10 @@
+/** Document view state belongs to tab records, including while their bodies are hidden. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
+/**
+ * Release retained view state on tab closure or plugin disposal.
+ * @param ctx - owning preview plugin context.
+ * @returns a callback accepting the tab, its lifetime signal, and its store's forget action; repeated holds share one listener.
+ */
+export declare function retainDocumentTabs(ctx: Context): (tabId: TabId, signal: AbortSignal, forget: (tabId: TabId) => void) => void;
+//# sourceMappingURL=tab-lifetime.d.ts.map

package/lib/types/client/excel/LazyExcelBody.d.ts

@@ -0,0 +1,21 @@
+/** Load the spreadsheet renderer only when a supported workbook is opened. */
+import { type ReactNode } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DocumentPreviewProps } from '../document/contract.ts';
+import { type ExcelFormat } from './format.ts';
+import type { ExcelLimits } from './model.ts';
+/** Document input plus parser limits and localized copy. */
+export type ExcelBodyProps = DocumentPreviewProps & PropsLocale<'sidebarExcel'> & {
+    readonly limits: ExcelLimits;
+};
+/** Lazily loaded renderer input with the filename-derived parser choice. */
+export type LoadedExcelBodyProps = ExcelBodyProps & {
+    readonly format: ExcelFormat;
+};
+/**
+ * Load the browser spreadsheet renderer for every registered format.
+ * @param props - Complete file bytes and standard document seats.
+ * @returns Localized loading state or Excel preview.
+ */
+export declare function LazyExcelBody(props: ExcelBodyProps): ReactNode;
+//# sourceMappingURL=LazyExcelBody.d.ts.map

package/lib/types/client/excel/convert.d.ts

@@ -0,0 +1,12 @@
+/** Format-specific parsing into one read-only FortuneSheet representation. */
+import type { ExcelFormat } from './format.ts';
+import type { ExcelLimits, ExcelPreview } from './model.ts';
+/**
+ * Decode spreadsheet bytes without recalculating saved formulas.
+ * @param bytes - Borrowed complete file bytes.
+ * @param format - Format selected by the registered filename suffix.
+ * @param limits - File and matrix allocation limits.
+ * @returns Display sheets and missing formula-cache count.
+ */
+export declare function convertExcel(bytes: Uint8Array<ArrayBuffer>, format: ExcelFormat, limits: ExcelLimits): Promise<ExcelPreview>;
+//# sourceMappingURL=convert.d.ts.map

package/lib/types/client/excel/delimited.d.ts

@@ -0,0 +1,10 @@
+import { type ExcelLimits, type ExcelPreview } from './model.ts';
+/**
+ * Parse delimited UTF-8 or BOM-marked UTF-16 without type inference.
+ * @param bytes - Borrowed complete file bytes.
+ * @param format - Comma or tab-separated input.
+ * @param limits - Maximum worksheet area.
+ * @returns A single sheet with literal field values.
+ */
+export declare function convertDelimited(bytes: Uint8Array<ArrayBuffer>, format: 'csv' | 'tsv', limits: ExcelLimits): ExcelPreview;
+//# sourceMappingURL=delimited.d.ts.map

package/lib/types/client/excel/error.d.ts

@@ -0,0 +1,7 @@
+/** Locale-independent spreadsheet parser failure categories. */
+export declare class ExcelPreviewError extends Error {
+    readonly code: 'invalid' | 'tooLarge' | 'timeout' | 'encoding';
+    /** @param code - User-actionable parser failure. */
+    constructor(code: 'invalid' | 'tooLarge' | 'timeout' | 'encoding', options?: ErrorOptions);
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1,10 @@
+/** Read-only spreadsheet surface backed by browser-parsed workbook data. */
+import { type ReactNode } from 'react';
+import type { LoadedExcelBodyProps } from './LazyExcelBody.tsx';
+/**
+ * Display stored spreadsheet values and formats without editing or recalculation.
+ * @param props - Complete workbook bytes, limits, and locale.
+ * @returns An isolated spreadsheet surface with cancellable loading.
+ */
+export declare function ExcelBody({ content, format, limits, t }: LoadedExcelBodyProps): ReactNode;
+//# sourceMappingURL=excel.d.ts.map

package/lib/types/client/excel/format.d.ts

@@ -0,0 +1,9 @@
+/** File formats admitted by the spreadsheet preview. */
+export type ExcelFormat = 'xlsx' | 'xls' | 'csv' | 'tsv';
+/**
+ * Resolve a registered filename to its parser.
+ * @param path - Decoded file path.
+ * @returns The supported suffix; rejects unsupported filenames.
+ */
+export declare function excelFormat(path: string): ExcelFormat;
+//# sourceMappingURL=format.d.ts.map

package/lib/types/client/excel/index.d.ts

@@ -0,0 +1,10 @@
+/** Excel previews use ordinary authorized file bytes without Office conversion. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Config } from '../../config.ts';
+/**
+ * Register the browser Excel viewer and its lifecycle-owned slot.
+ * @param ctx - Preview and locale registries.
+ * @param limits - Resolved parser limits.
+ */
+export declare function apply(ctx: Context, limits: Config['excel']): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/excel/locales.d.ts

@@ -0,0 +1,45 @@
+/** Locale-owned Excel preview controls and parser feedback. */
+export declare const zh: {
+    title: string;
+    language: string;
+    loading: string;
+    invalid: string;
+    tooLarge: string;
+    timeout: string;
+    encoding: string;
+    formulaWarning: string;
+    unsupportedNotice: string;
+    charts: string;
+    images: string;
+    shapes: string;
+    conditionalFormatting: string;
+    featureSeparator: string;
+    retry: string;
+};
+/** Excel preview dictionary keys. */
+export type ExcelPreviewKey = keyof typeof zh;
+/** English Excel preview copy. */
+export declare const en: {
+    title: string;
+    language: string;
+    loading: string;
+    invalid: string;
+    tooLarge: string;
+    timeout: string;
+    encoding: string;
+    formulaWarning: string;
+    unsupportedNotice: string;
+    charts: string;
+    images: string;
+    shapes: string;
+    conditionalFormatting: string;
+    featureSeparator: string;
+    retry: string;
+};
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Excel preview status and third-party locale selection. */
+        sidebarExcel: ExcelPreviewKey;
+    }
+}
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/excel/model.d.ts

@@ -0,0 +1,35 @@
+/** Shared display cells, resource limits, and parser failure categories. */
+import { type Cell, type Sheet, type SheetConfig } from '@fortune-sheet/core';
+/** Resource limits applied before allocating FortuneSheet's dense cell matrices. */
+export interface ExcelLimits {
+    /** Maximum source file bytes. */
+    maxBytes: number;
+    /** Maximum combined rectangular cell area across worksheets. */
+    maxCells: number;
+    /** Maximum time allowed for one parser Worker. */
+    timeoutMs: number;
+}
+/** Content categories reported in stable order when XLSX preview omits them. */
+export declare const EXCEL_UNSUPPORTED_FEATURES: readonly ["charts", "images", "shapes", "conditionalFormatting"];
+/** A detected workbook feature that the spreadsheet preview does not display. */
+export type ExcelUnsupportedFeature = typeof EXCEL_UNSUPPORTED_FEATURES[number];
+/** Preview data, missing formula results, and detected content that is not displayed. */
+export interface ExcelPreview {
+    sheets: Sheet[];
+    missingResults: number;
+    unsupportedFeatures: ExcelUnsupportedFeature[];
+}
+/**
+ * Retain an addressable A1 selection, including an A1 merge.
+ * @param config - Worksheet layout.
+ * @returns The initial selection used when activating a worksheet.
+ */
+export declare function initialSelection(config: SheetConfig): NonNullable<Sheet['luckysheet_select_save']>;
+/**
+ * Apply number formatting and default alignment without evaluating formulas.
+ * @param cell - Owned display cell to complete.
+ * @param numberFormat - Excel number format code.
+ * @returns The same cell with its display text and value type.
+ */
+export declare function formatCell(cell: Cell, numberFormat: string): Cell;
+//# sourceMappingURL=model.d.ts.map

package/lib/types/client/excel/parse.d.ts

@@ -0,0 +1,12 @@
+import type { ExcelFormat } from './format.ts';
+import { type ExcelLimits, type ExcelPreview } from './model.ts';
+/**
+ * Parse workbook bytes in a disposable Worker, copying the retained preview buffer.
+ * @param bytes - Borrowed complete file bytes.
+ * @param format - Format selected by the registered filename suffix.
+ * @param limits - File, matrix, and elapsed-time limits.
+ * @param signal - Document body's lifetime.
+ * @returns Parsed sheets; rejects with a locale key on parser failures.
+ */
+export declare function parseExcel(bytes: Uint8Array<ArrayBuffer>, format: ExcelFormat, limits: ExcelLimits, signal: AbortSignal): Promise<ExcelPreview>;
+//# sourceMappingURL=parse.d.ts.map

package/lib/types/client/excel/worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/lib/types/client/excel/xls.d.ts

@@ -0,0 +1,18 @@
+/** Legacy BIFF workbooks mapped to saved values and basic spreadsheet layout. */
+import { type WorkBook } from 'xlsx';
+import { type ExcelLimits, type ExcelPreview } from './model.ts';
+/**
+ * Decode a binary XLS workbook without accepting renamed text or HTML files.
+ * @param bytes - Borrowed complete workbook bytes.
+ * @param limits - Maximum combined worksheet area.
+ * @returns Saved values, formulas, and supported workbook layout.
+ */
+export declare function convertXls(bytes: Uint8Array<ArrayBuffer>, limits: ExcelLimits): ExcelPreview;
+/**
+ * Map SheetJS values and optional BIFF layout metadata without retaining the workbook.
+ * @param workbook - Parsed legacy workbook.
+ * @param limits - Maximum combined worksheet area.
+ * @returns FortuneSheet display data.
+ */
+export declare function mapXlsWorkbook(workbook: WorkBook, limits: ExcelLimits): ExcelPreview;
+//# sourceMappingURL=xls.d.ts.map

package/lib/types/client/excel/xlsx-archive.d.ts

@@ -0,0 +1,19 @@
+/** Owns the unpacked preview copy and its detected unsupported content. */
+export declare class XlsxPreviewArchive {
+    private readonly bytes;
+    /** Detected workbook content that the preview does not display. */
+    readonly unsupportedFeatures: Set<"charts" | "images" | "shapes" | "conditionalFormatting">;
+    private readonly files;
+    /**
+     * Read an archive without modifying the borrowed source buffer.
+     * @param bytes - Complete XLSX source bytes.
+     */
+    constructor(bytes: Uint8Array<ArrayBuffer>);
+    /**
+     * Omit DrawingML parts before ExcelJS parses them; callers must also ignore worksheet drawing references.
+     * @returns Source bytes when no parts were omitted, otherwise an uncompressed temporary ZIP.
+     */
+    withoutDrawings(): Uint8Array<ArrayBuffer>;
+    private inspectContent;
+}
+//# sourceMappingURL=xlsx-archive.d.ts.map

package/lib/types/client/excel/xlsx.d.ts

@@ -0,0 +1,9 @@
+import { type ExcelLimits, type ExcelPreview } from './model.ts';
+/**
+ * Decode an XLSX into display cells, omitting drawings and retaining formulas without recalculation.
+ * @param bytes - Complete borrowed workbook bytes.
+ * @param limits - File and matrix allocation limits.
+ * @returns Sheets ready for a read-only FortuneSheet workbook.
+ */
+export declare function convertXlsx(bytes: Uint8Array<ArrayBuffer>, limits: ExcelLimits): Promise<ExcelPreview>;
+//# sourceMappingURL=xlsx.d.ts.map

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

@@ -21,8 +21,13 @@ import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { ReadDocumentBytes, ReadWorkspaceFilePage, SessionFile } from './rpc.ts';
 import type { TextStore } from './store.ts';
+import type { Resources } from '@deepseek-ai/dsh-client-resources/client';
 /** The preview's injected business face, as the body receives it. */
 export interface TextInjected {
+    /** Observe one renderer dependency. @param tabId - owning tab. @param address - resource address. @param signal - tab lifetime. */
+    readonly addResource: (tabId: TabId, address: string, signal: AbortSignal) => void;
+    /** Replace dependency membership. @param tabId - owning tab. @param addresses - resource addresses. @param signal - tab lifetime. */
+    readonly setResources: (tabId: TabId, addresses: readonly string[], signal: AbortSignal) => void;
     /**
      * Read one page into the store. A page of a newer file version than the pages
      * held, arriving past the first line, is not kept: the tab's pages are dropped
@@ -61,12 +66,22 @@ export interface TextInjected {
      * @param observedVersion - metadata version observed at read start.
      */
     readonly reloadAll: (tabId: TabId, file: SessionFile, signal: AbortSignal, observedVersion?: string) => void;
+    /**
+     * Begin a renderer-owned load without reading source bytes.
+     * @param tabId - owning tab.
+     * @param signal - tab lifetime.
+     * @param rendererId - selected implementation.
+     * @param observedVersion - metadata version observed at request start.
+     * @param reload - discard the previous content revision.
+     */
+    readonly prepareRenderer: (tabId: TabId, signal: AbortSignal, rendererId: string, observedVersion?: string, reload?: boolean) => void;
 }
 /**
  * Bind the preview's face to one paged read and one complete-byte read.
  * @param read - the bound `workspaceFiles.read` call.
- * @param readAll - ordinary complete-byte Remote read.
+ * @param readAll - complete-byte workspace Remote read.
+ * @param resources - shared metadata sources for the document and its dependencies.
  * @returns the Slot `inject` factory: bound actions in, face out. The slot's session id is unused because the address carries its own.
  */
-export declare function textFace(read: ReadWorkspaceFilePage, readAll: ReadDocumentBytes): (sessionId: SessionId, actions: BoundActions<TextStore>) => TextInjected;
+export declare function textFace(read: ReadWorkspaceFilePage, readAll: ReadDocumentBytes, resources: Resources): (sessionId: SessionId, actions: BoundActions<TextStore>) => TextInjected;
 //# sourceMappingURL=face.d.ts.map

package/lib/types/client/failure-line.d.ts

@@ -14,4 +14,14 @@ import type { TranslateNS } from '@deepseek-ai/dsh-client-locale/client';
  * @returns the line to show in place of the file.
  */
 export declare function failureLine(t: TranslateNS<'sidebarDocumentPreview'>, failure: RemoteFailure): string;
+/** The action an empty preview offers beside its failure line. */
+export type EmptyFailureRecourse = 'open' | 'retry' | 'none';
+/**
+ * Choose the empty state's action for one settled read failure.
+ * @param failure - the settled Remote failure.
+ * @returns `open` for a readable file this preview cannot render, `none` for a
+ * path with nothing to show or open, `retry` for the rest: carrier and
+ * unclassified failures a second read may resolve.
+ */
+export declare function emptyFailureRecourse(failure: RemoteFailure): EmptyFailureRecourse;
 //# sourceMappingURL=failure-line.d.ts.map

package/lib/types/client/html/HtmlBody.d.ts

@@ -1,16 +1,22 @@
 import type { ReactNode } from 'react';
-import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
 import type { DocumentPreviewProps } from '../document/contract.ts';
 import type { ReadHtmlRelated } from './read-relative.ts';
 /** Standard document inputs plus this renderer's dictionary. */
-export type HtmlBodyProps = DocumentPreviewProps & PropsLocale<'documentHtml'> & {
+export type HtmlBodyProps = DocumentPreviewProps & PropsLocale<'documentHtml'> & InjectFace<HtmlBodyInjected>;
+/** Related-file reader and accepted preview mode supplied by the plugin. */
+export interface HtmlBodyInjected {
+    hooks: {
+        interactivePreview: ObservableSnapshot<boolean>;
+    };
     /** Ordinary Remote callback bound by this renderer's Slot inject. */
     readonly readRelated: ReadHtmlRelated;
-};
+}
 /**
  * Render complete HTML with the standard file and tab hooks.
  * @param props - document bytes, hooks, related-file reader and locale.
  * @returns an isolated HTML document, or nothing for text delivery.
  */
-export declare function HtmlBody({ content, resourceAddress, readRelated, useTabInfo, t }: HtmlBodyProps): ReactNode;
+export declare function HtmlBody({ content, resourceAddress, readRelated, useTabInfo, useInteractivePreview, addResource, setResources, t, }: HtmlBodyProps): ReactNode;
 //# sourceMappingURL=HtmlBody.d.ts.map

package/lib/types/client/html/basic-document.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Prepare static content before the browser can load any document resources.
+ * @param data - complete UTF-8 HTML bytes.
+ * @returns document with the restrictive CSP first in its head.
+ */
+export declare function createBasicHtmlDocument(data: Uint8Array<ArrayBuffer>): string;
+//# sourceMappingURL=basic-document.d.ts.map

package/lib/types/client/html/read-relative.d.ts

@@ -1,21 +1,22 @@
-/** Adapt a Remote relative read without changing its Session or Host path authority. */
+/** Adapt a relative workspace read without changing its Session or Host path authority. */
 import type { RemoteResult } from '@deepseek-ai/dsh-api-remotes/client';
-import type { WorkspaceFileBytes } from '@deepseek-ai/dsh-api-workspace-files/types';
+import type { DocumentFileBytes } from '../rpc.ts';
 import type { ReadHtmlRelative } from './pack.ts';
 /**
  * Read one dependency relative to the addressed HTML file through the Host.
  * @param address - root HTML file address.
  * @param relativePath - decoded dependency path, resolved only by the Host.
  * @param signal - cancellation shared by the tab and packing operation.
- * @returns the Remote complete-byte result, including declared failures.
+ * @returns the complete-byte result, including declared failures.
  */
-export type ReadHtmlRelated = (address: string, relativePath: string, signal: AbortSignal) => Promise<RemoteResult<WorkspaceFileBytes>>;
+export type ReadHtmlRelated = (address: string, relativePath: string, signal: AbortSignal) => Promise<RemoteResult<DocumentFileBytes>>;
 /**
  * Bind a package reader to the original HTML file's address.
- * @param readRelated - Remote reader using the Session in the root HTML address.
+ * @param readRelated - workspace reader using the Session in the root HTML address.
  * @param address - root HTML file address.
  * @param lifetime - tab lifetime.
+ * @param addResource - subscribes to the dependency path reported by the Host.
  * @returns a reader that strips URL query/fragment, decodes one path, and preserves Host failures.
  */
-export declare function createReadHtmlRelative(readRelated: ReadHtmlRelated, address: string, lifetime: AbortSignal): ReadHtmlRelative;
+export declare function createReadHtmlRelative(readRelated: ReadHtmlRelated, address: string, lifetime: AbortSignal, addResource: (address: string) => void): ReadHtmlRelative;
 //# sourceMappingURL=read-relative.d.ts.map

package/lib/types/client/image/ImageBody.d.ts

@@ -1,7 +1,8 @@
-/** Complete image bytes rendered rounded within an inset frame, scaled down to the pane's width. */
+/** Complete image bytes rendered in a shared zoom viewport. */
 import { type ReactNode } from 'react';
-import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PropsLocale, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
 import type { DocumentPreviewProps } from '../document/contract.ts';
+import { type ZoomInjected, type ZoomStore } from '../zoom/store.ts';
 declare const IMAGE_MEDIA_TYPES: {
     readonly png: "image/png";
     readonly jpg: "image/jpeg";
@@ -14,7 +15,7 @@ declare const IMAGE_MEDIA_TYPES: {
 };
 type ImageMediaType = typeof IMAGE_MEDIA_TYPES[keyof typeof IMAGE_MEDIA_TYPES];
 /** Standard document props plus the image renderer's dictionary. */
-export type ImageBodyProps = DocumentPreviewProps & PropsLocale<'sidebarImage'>;
+export type ImageBodyProps = DocumentPreviewProps & PropsLocale<'sidebarImage'> & PropsStore<ZoomStore> & ZoomInjected;
 /**
  * Resolve a supported filename to the media type assigned to its Blob.
  * @param path - decoded workspace file path.
@@ -22,12 +23,10 @@ export type ImageBodyProps = DocumentPreviewProps & PropsLocale<'sidebarImage'>;
  */
 export declare function imageMediaType(path: string): ImageMediaType | undefined;
 /**
- * Present complete image bytes fitted to the pane's width.
+ * Present complete image bytes with fit-width and fixed-scale viewing.
  * @param props - document bytes, resource identity, and locale.
- * @returns a rounded image scaled down to the pane's width at its aspect
- * ratio — a smaller image centres at its intrinsic size — whose containing
- * document body provides vertical scrolling.
+ * @returns a rounded image fitted or scaled at its intrinsic aspect ratio.
  */
-export declare function ImageBody({ content, resourceAddress, t }: ImageBodyProps): ReactNode;
+export declare function ImageBody(props: ImageBodyProps): ReactNode;
 export {};
 //# sourceMappingURL=ImageBody.d.ts.map

package/lib/types/client/image/locales.d.ts

@@ -5,6 +5,12 @@ export declare const zh: {
     loading: string;
     failed: string;
     unsupported: string;
+    zoomControls: "缩放控件";
+    zoomMenu: "选择缩放比例";
+    zoomOut: "缩小";
+    zoomIn: "放大";
+    zoomFitWidth: "适应宽度";
+    zoomValue: "{percent}%";
 };
 /** Image renderer dictionary keys. */
 export type ImagePreviewKey = keyof typeof zh;
@@ -15,6 +21,12 @@ export declare const en: {
     loading: string;
     failed: string;
     unsupported: string;
+    zoomControls: string;
+    zoomMenu: string;
+    zoomOut: string;
+    zoomIn: string;
+    zoomFitWidth: string;
+    zoomValue: string;
 };
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {