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

package/lib/client.pdf.js

@@ -32376,7 +32376,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar-documentpreview/src/client/pdf/PdfBody.module.css.mjs
-		const css = ".E0GbtG_body{box-sizing:border-box;background:var(--dsw-alias-bg-document-preview);width:100%;min-height:0;font-family:var(--dsw-font,sans-serif);white-space:normal;flex-direction:column;display:flex;overflow-x:hidden}.E0GbtG_page{box-sizing:border-box;width:100%;min-width:0;overflow-x:hidden}.E0GbtG_placeholder{aspect-ratio:3/4;background:var(--dsw-alias-bg-skeleton);width:100%}.E0GbtG_canvas{width:min(var(--pdf-page-width), 100%);max-width:100%;height:auto;margin-inline:auto;display:block}.E0GbtG_surface{max-width:100%;box-shadow:var(--dsw-elevation-prominent);margin-inline:auto;position:relative}.E0GbtG_surface[hidden]{display:none}.E0GbtG_text{position:absolute;inset:0;overflow:clip}.E0GbtG_text .textLayer{text-align:initial;letter-spacing:normal;word-spacing:normal;text-size-adjust:none;forced-color-adjust:none;transform-origin:0 0;caret-color:canvastext;z-index:0;--text-scale-factor:calc(var(--total-scale-factor) * var(--min-font-size));--min-font-size-inv:calc(1 / var(--min-font-size));line-height:1;position:absolute;inset:0;overflow:clip}.E0GbtG_text .textLayer[data-main-rotation=\"90\"]{transform:rotate(90deg)translateY(-100%)}.E0GbtG_text .textLayer[data-main-rotation=\"180\"]{transform:rotate(180deg)translate(-100%,-100%)}.E0GbtG_text .textLayer[data-main-rotation=\"270\"]{transform:rotate(270deg)translate(-100%)}.E0GbtG_text :is(span,br){color:#0000;white-space:pre;cursor:text;transform-origin:0 0;user-select:text;position:absolute}.E0GbtG_text .textLayer>:not(.markedContent),.E0GbtG_text .markedContent span:not(.markedContent){z-index:1;--font-height:0;--scale-x:1;--rotate:0deg;font-size:calc(var(--text-scale-factor) * var(--font-height));transform:rotate(var(--rotate)) scaleX(var(--scale-x)) scale(var(--min-font-size-inv))}.E0GbtG_text .markedContent{display:contents}.E0GbtG_text ::selection{background:var(--dsw-alias-interactive-bg-hover-accent);color:#0000}.E0GbtG_text br::selection{background:0 0}.E0GbtG_text .textLayer .endOfContent{z-index:0;cursor:default;user-select:none;display:block;position:absolute;inset:100% 0 0}.E0GbtG_text .selecting .endOfContent{top:0}.E0GbtG_status{color:var(--dsw-alias-label-secondary);align-items:center;gap:8px;padding:10px;font-size:13px;line-height:1.5;display:flex}.E0GbtG_body .E0GbtG_status{color:var(--dsw-alias-label-document-preview)}.E0GbtG_opening{box-sizing:border-box;justify-content:center;width:100%;min-height:100%}.E0GbtG_loadingIcon{flex:none;animation:.8s linear infinite E0GbtG_turn;display:flex}@keyframes E0GbtG_turn{to{transform:rotate(360deg)}}@media (prefers-reduced-motion:reduce){.E0GbtG_loadingIcon{animation:none}}";
+		const css = ".E0GbtG_body{box-sizing:border-box;background:var(--dsw-alias-bg-document-preview);width:100%;min-width:100%;min-height:0;font-family:var(--dsw-font,sans-serif);white-space:normal;flex-direction:column;display:flex;overflow:visible}.E0GbtG_page{box-sizing:border-box;width:100%;min-width:0;overflow-x:visible}.E0GbtG_placeholder{aspect-ratio:3/4;background:var(--dsw-alias-bg-skeleton);width:100%}.E0GbtG_canvas{width:100%;max-width:none;height:auto;margin-inline:auto;display:block}.E0GbtG_surface{max-width:none;box-shadow:var(--dsw-elevation-prominent);margin-inline:auto;position:relative}.E0GbtG_surface[hidden]{display:none}.E0GbtG_text{position:absolute;inset:0;overflow:clip}.E0GbtG_text .textLayer{text-align:initial;letter-spacing:normal;word-spacing:normal;text-size-adjust:none;forced-color-adjust:none;transform-origin:0 0;caret-color:canvastext;z-index:0;--text-scale-factor:calc(var(--total-scale-factor) * var(--min-font-size));--min-font-size-inv:calc(1 / var(--min-font-size));line-height:1;position:absolute;inset:0;overflow:clip}.E0GbtG_text .textLayer[data-main-rotation=\"90\"]{transform:rotate(90deg)translateY(-100%)}.E0GbtG_text .textLayer[data-main-rotation=\"180\"]{transform:rotate(180deg)translate(-100%,-100%)}.E0GbtG_text .textLayer[data-main-rotation=\"270\"]{transform:rotate(270deg)translate(-100%)}.E0GbtG_text :is(span,br){color:#0000;white-space:pre;cursor:text;transform-origin:0 0;user-select:text;position:absolute}.E0GbtG_text .textLayer>:not(.markedContent),.E0GbtG_text .markedContent span:not(.markedContent){z-index:1;--font-height:0;--scale-x:1;--rotate:0deg;font-size:calc(var(--text-scale-factor) * var(--font-height));transform:rotate(var(--rotate)) scaleX(var(--scale-x)) scale(var(--min-font-size-inv))}.E0GbtG_text .markedContent{display:contents}.E0GbtG_text ::selection{background:var(--dsw-alias-interactive-bg-hover-accent);color:#0000}.E0GbtG_text br::selection{background:0 0}.E0GbtG_text .textLayer .endOfContent{z-index:0;cursor:default;user-select:none;display:block;position:absolute;inset:100% 0 0}.E0GbtG_text .selecting .endOfContent{top:0}.E0GbtG_status{color:var(--dsw-alias-label-secondary);align-items:center;gap:8px;padding:10px;font-size:13px;line-height:1.5;display:flex}.E0GbtG_body .E0GbtG_status{color:var(--dsw-alias-label-document-preview)}.E0GbtG_opening{box-sizing:border-box;justify-content:center;width:100%;min-height:100%}";
 		const tagId = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/PdfBody.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -32388,19 +32388,18 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		var PdfBody_module_css_default = {
 			"body": "E0GbtG_body",
 			"canvas": "E0GbtG_canvas",
-			"loadingIcon": "E0GbtG_loadingIcon",
 			"opening": "E0GbtG_opening",
 			"page": "E0GbtG_page",
 			"placeholder": "E0GbtG_placeholder",
 			"status": "E0GbtG_status",
 			"surface": "E0GbtG_surface",
-			"text": "E0GbtG_text",
-			"turn": "E0GbtG_turn"
+			"text": "E0GbtG_text"
 		};
 		//#endregion
 		//#region lib/types/client/pdf/pdf.js
 		/** PDF page presentation; binary content and tab information come from the document owner. */
 		const DEFAULT_PDF_VIEW = { page: 1 };
+		const FIT_WIDTH = { kind: "fit-width" };
 		/**
 		* Present a PDF with tab-local viewing preferences and component-owned rendering resources.
 		* @param props - complete bytes and framework-owned tab/store/locale seats.
@@ -32412,10 +32411,23 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 			const data = props.content.kind === "bytes" ? props.content.data : void 0;
 			const [load, setLoad] = (0, react.useState)();
 			const [attempt, setAttempt] = (0, react.useState)(0);
-			const { retainTab, actions, t } = props;
+			const [pageWidth, setPageWidth] = (0, react.useState)();
+			const { retainTab, actions, t, ZoomViewport, zoomSurfaceClass } = props;
+			const preference = view.zoom ?? FIT_WIDTH;
+			const labels = {
+				controls: t("zoomControls"),
+				menu: t("zoomMenu"),
+				out: t("zoomOut"),
+				into: t("zoomIn"),
+				fitWidth: t("zoomFitWidth"),
+				value: (percent) => t("zoomValue", { percent })
+			};
 			const pageVisible = (0, react.useCallback)((page) => {
 				actions.page(tab.id, page);
 			}, [actions, tab.id]);
+			const setPreference = (0, react.useCallback)((value) => {
+				actions.zoom(tab.id, value);
+			}, [actions, tab.id]);
 			(0, react.useEffect)(() => {
 				retainTab(tab.id, tab.signal);
 			}, [
@@ -32467,11 +32479,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				role: "status",
 				"aria-label": t("loading"),
 				"data-document-loading": true,
-				children: (0, react_jsx_runtime.jsx)("span", {
-					className: PdfBody_module_css_default.loadingIcon,
-					"aria-hidden": "true",
-					children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutline16, {})
-				})
+				children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "ongoing" })
 			});
 			if (load.kind === "failed") return (0, react_jsx_runtime.jsxs)("div", {
 				className: PdfBody_module_css_default.status,
@@ -32484,7 +32492,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 					children: t("retry")
 				})]
 			});
-			return (0, react_jsx_runtime.jsx)("section", {
+			const pages = (0, react_jsx_runtime.jsx)("section", {
 				className: PdfBody_module_css_default.body,
 				"data-pdf-preview": true,
 				children: Array.from({ length: load.document.numPages }, (_, index) => (0, react_jsx_runtime.jsx)(PdfPage, {
@@ -32493,11 +32501,22 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 					requested: index === 0 || view.page === index + 1,
 					onVisible: pageVisible,
 					signal: tab.signal,
+					onWidth: index === 0 ? setPageWidth : void 0,
+					zoomSurfaceClass,
 					t
 				}, index))
 			});
+			return (0, react_jsx_runtime.jsx)(ZoomViewport, {
+				preference,
+				intrinsicWidth: pageWidth,
+				labels,
+				signal: tab.signal,
+				scrollportRef: props.scrollportRef,
+				onPreference: setPreference,
+				children: pages
+			});
 		}
-		function PdfPage({ document, page, requested: initiallyRequested, onVisible, signal, t }) {
+		function PdfPage({ document, page, requested: initiallyRequested, onVisible, signal, onWidth, zoomSurfaceClass, t }) {
 			const host = (0, react.useRef)(null);
 			const canvas = (0, react.useRef)(null);
 			const text = (0, react.useRef)(null);
@@ -32540,6 +32559,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				}).then((size) => {
 					if (!renderSignal.aborted) {
 						setWidth(size.width);
+						onWidth?.(size.width);
 						setState("ready");
 					}
 				}, (error) => {
@@ -32554,7 +32574,8 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				page,
 				requested,
 				signal,
-				attempt
+				attempt,
+				onWidth
 			]);
 			return (0, react_jsx_runtime.jsxs)("div", {
 				ref: host,
@@ -32578,8 +32599,9 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 						})]
 					}),
 					(0, react_jsx_runtime.jsxs)("div", {
-						className: PdfBody_module_css_default.surface,
-						style: { width },
+						className: `${PdfBody_module_css_default.surface} ${zoomSurfaceClass}`,
+						"data-document-zoom-surface": true,
+						style: { "--document-zoom-width": `${width ?? 0}px` },
 						hidden: state !== "ready" || failure !== void 0,
 						children: [(0, react_jsx_runtime.jsx)("canvas", {
 							ref: canvas,

package/lib/index.js

@@ -2,12 +2,19 @@ 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)
-}) });
+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
 /**

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, prepareRenderer, 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

@@ -26,11 +26,17 @@ export type DocumentContent = {
     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. */
@@ -54,6 +60,44 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
                 };
             };
         };
+        /**
+         * 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: {
+                readonly content: DocumentContent;
+            };
+            hookContext: UseSidebarRightTabInfo;
+            inject: {
+                hooks: {
+                    tabInfo: SlotHookFactory<'sidebar.right.tab.document', UseSidebarRightTabInfo>;
+                };
+            };
+        };
     }
 }
 /** Standard input for every document body; entry-local stores and locale props can be intersected with it. */

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/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,11 @@
+/** 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.
+ * Keep the mounted workbook sized to its preview pane.
+ * @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,21 @@
+/** 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;
+    private readonly parts;
+    /**
+     * Read an archive without modifying the borrowed source buffer.
+     * @param bytes - Complete XLSX source bytes.
+     * @throws When ZIP entries have ASCII case-equivalent names.
+     */
+    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
@@ -74,8 +79,9 @@ export interface TextInjected {
 /**
  * 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