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

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 {

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

@@ -40,12 +40,12 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
 }
 /**
  * Required browser services: the tab registry, the slot registry, copy, and the
- * Remote carrier with its `workspaceFiles` namespace.
+ * workspace Remote for bytes and paged text reads.
  */
 export declare const inject: string[];
 /**
  * Client plugin body: register the type, its dictionaries, its body, and its chip title.
- * @param ctx - client root context carrying the registry, the slots, copy, and the Remote face.
+ * @param ctx - client root context carrying the registry, slots, copy, and file readers.
  */
 export declare function apply(ctx: ClientContext): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -12,6 +12,9 @@ export declare const zh: {
     changed: string;
     reloadNow: string;
     reload: string;
+    autoRefresh: string;
+    'autoRefresh.enable': string;
+    'autoRefresh.disable': string;
     'wrap.enable': string;
     'wrap.disable': string;
     'wrap.aria': string;
@@ -36,6 +39,9 @@ export declare const en: {
     changed: string;
     reloadNow: string;
     reload: string;
+    autoRefresh: string;
+    'autoRefresh.enable': string;
+    'autoRefresh.disable': string;
     'wrap.enable': string;
     'wrap.disable': string;
     'wrap.aria': string;

package/lib/types/client/markdown/MarkdownBody.d.ts

@@ -8,5 +8,5 @@ export type MarkdownBodyProps = DocumentPreviewProps & PropsLocale<'documentMark
  * @param props - owner-loaded contents and localized primitive labels.
  * @returns Markdown content, or nothing for a non-text delivery.
  */
-export declare function MarkdownBody({ content, t }: MarkdownBodyProps): ReactNode;
+export declare function MarkdownBody({ content, resourceAddress, useResource, t }: MarkdownBodyProps): ReactNode;
 //# sourceMappingURL=MarkdownBody.d.ts.map

package/lib/types/client/markdown/path-images.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Build a file URL, resolving relative destinations beside the previewed file.
+ * @param base - document base URI, including any deployment prefix.
+ * @param documentPath - absolute source path reported by the Host, when available.
+ * @param destination - authored Markdown image URL; query and fragment are not filename components.
+ * @returns an HTTP(S) file URL, or undefined for unsupported or malformed destinations.
+ */
+export declare function markdownImageUrl(base: string, documentPath: string | undefined, destination: string): string | undefined;
+//# sourceMappingURL=path-images.d.ts.map

package/lib/types/client/office/FontNotice.d.ts

@@ -1,16 +1,14 @@
-/** Missing-font notice and a non-modal details panel for one source version. */
+/** Toolbar warning and non-modal details for the current preview’s missing fonts. */
 import { type ReactNode } from 'react';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 /** Notice inputs supplied by the document owner and Office locale registration. */
 export type FontNoticeProps = PropsLocale<'sidebarOffice'> & {
-    readonly resourceAddress: string;
-    readonly sourceVersion: string;
     readonly fonts: readonly string[];
 };
 /**
- * Show missing fonts; dismissal applies to the same source version while this component stays mounted.
- * @param props - source identity, converted content, and localized copy.
- * @returns a collapsible notice and its anchored details, or nothing when fonts are available.
+ * Show a warning while fonts are unavailable for the current preview.
+ * @param props - missing font families and localized copy.
+ * @returns a warning button and its anchored details, or nothing when fonts are available.
  */
-export declare function FontNotice({ resourceAddress, sourceVersion, fonts, t }: FontNoticeProps): ReactNode;
+export declare function FontNotice({ fonts, t }: FontNoticeProps): ReactNode;
 //# sourceMappingURL=FontNotice.d.ts.map

package/lib/types/client/office/OfficeBody.d.ts

@@ -1,11 +1,10 @@
-/** Office owns source loading, conversion failures, and font notices around the shared PDF view. */
+/** Office presents retained conversion results and font notices around the shared PDF view. */
 import { type ReactNode } from 'react';
 import type { PropsLocale, PropsRenderSlots, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
-import type { RemoteFailure } from '@deepseek-ai/dsh-api-remotes/client';
 import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
 import type { UseSidebarRightTabInfo } from '@deepseek-ai/dsh-client-ui-sidebar-right/client';
 import type { DocumentBodyOwner, DocumentPreviewProps } from '../document/contract.ts';
-import type { ReadOfficeDocument } from './cache.ts';
+import type { OfficeLoadInjected } from './face.ts';
 import type { OfficeStore } from './store.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface SlotMap {
@@ -24,12 +23,7 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
     }
 }
 /** Office loading callbacks supplied by the registration's services. */
-export interface OfficeBodyInjected {
-    readonly read: ReadOfficeDocument;
-    /** @param failure - declared file-read failure or conversion exception message. @returns localized display text. */
-    readonly describeFailure: (failure: RemoteFailure | {
-        readonly message: string;
-    }) => string;
+export interface OfficeBodyInjected extends OfficeLoadInjected {
     /** @param tab - owning tab. @param signal - tab lifetime, including hidden bodies. */
     readonly retainTab: (tab: TabId, signal: AbortSignal) => void;
 }
@@ -38,7 +32,7 @@ export type OfficeBodyProps = DocumentPreviewProps & PropsStore<OfficeStore> & O
 /**
  * Load one Office revision and preserve its result while its tab remains open.
  * @param props - renderer loading request, tab state, conversion callbacks, and PDF slot.
- * @returns conversion status or the font notice and PDF scrollport.
+ * @returns conversion status or the PDF scrollport.
  */
 export declare function OfficeBody(props: OfficeBodyProps): ReactNode;
 //# sourceMappingURL=OfficeBody.d.ts.map

package/lib/types/client/office/OfficeFontAction.d.ts

@@ -0,0 +1,13 @@
+/** Font warning for the Office revision displayed by the document toolbar. */
+import type { ReactNode } from 'react';
+import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { OfficeStore } from './store.ts';
+/** Office toolbar inputs share the body’s conversion result. */
+export type OfficeFontActionProps = PropsRuntime<'sidebar.right.tab.document.action'> & PropsStore<OfficeStore> & PropsLocale<'sidebarOffice'>;
+/**
+ * Expose font details only for the currently loaded Office revision.
+ * @param props - toolbar revision, tab reader, Office store, and localized copy.
+ * @returns the font warning, or nothing before conversion completes.
+ */
+export declare function OfficeFontAction({ content, useTabInfo, useStore, t }: OfficeFontActionProps): ReactNode;
+//# sourceMappingURL=OfficeFontAction.d.ts.map

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

@@ -0,0 +1,31 @@
+/** Office conversion reads and settlements bound to the renderer's declared store. */
+import type { BoundActions } from '@deepseek-ai/dsh-client-store';
+import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { RemoteFailure } from '@deepseek-ai/dsh-api-remotes/client';
+import type { SessionFile } from '../rpc.ts';
+import type { ReadOfficeDocument } from './cache.ts';
+import type { OfficeStore } from './store.ts';
+/** Conversion loading callback supplied to the Office body through Slot injection. */
+export interface OfficeLoadInjected {
+    /**
+     * Read one conversion revision; cancellation suppresses its store writes and version report.
+     * @param tabId - owning tab.
+     * @param revision - requested content revision.
+     * @param file - addressed Session and source path.
+     * @param signal - request lifetime, cancelled on replacement, unmount, or tab closure.
+     * @param loaded - report the displayed source version to the document owner.
+     * @param failed - report a failed load to the document owner.
+     */
+    readonly load: (tabId: TabId, revision: number, file: SessionFile, signal: AbortSignal, loaded: (version: string) => void, failed: () => void) => void;
+}
+/**
+ * Bind Office reads to store actions without exposing Remote work to the component.
+ * @param read - authorized conversion reader, including Client cache reuse.
+ * @param describeFailure - localized conversion or source-access failure text.
+ * @returns Slot inject factory; the file address supplies the read's Session authority.
+ */
+export declare function officeFace(read: ReadOfficeDocument, describeFailure: (failure: RemoteFailure | {
+    readonly message: string;
+}) => string): (sessionId: SessionId, actions: BoundActions<OfficeStore>) => OfficeLoadInjected;
+//# sourceMappingURL=face.d.ts.map

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

@@ -3,9 +3,7 @@ export declare const zh: {
     title: string;
     loading: string;
     retry: string;
-    missingFonts: string;
-    showMore: string;
-    dismissNotice: string;
+    viewMissingFonts: string;
     missingFontsTitle: string;
     missingFontsDescription: string;
     missingFontsCount: string;
@@ -25,9 +23,7 @@ export declare const en: {
     title: string;
     loading: string;
     retry: string;
-    missingFonts: string;
-    showMore: string;
-    dismissNotice: string;
+    viewMissingFonts: string;
     missingFontsTitle: string;
     missingFontsDescription: string;
     missingFontsCount: string;

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

@@ -9,6 +9,12 @@ export declare const zh: {
     workerFailed: string;
     unsupported: string;
     retry: string;
+    zoomControls: "缩放控件";
+    zoomMenu: "选择缩放比例";
+    zoomOut: "缩小";
+    zoomIn: "放大";
+    zoomFitWidth: "适应宽度";
+    zoomValue: "{percent}%";
 };
 /** PDF translation keys shared by both dictionaries. */
 export type PdfLocaleKey = keyof typeof zh;
@@ -23,6 +29,12 @@ export declare const en: {
     workerFailed: string;
     unsupported: string;
     retry: string;
+    zoomControls: string;
+    zoomMenu: string;
+    zoomOut: string;
+    zoomIn: string;
+    zoomFitWidth: string;
+    zoomValue: string;
 };
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {

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

@@ -1,9 +1,10 @@
 /** PDF page presentation; binary content and tab information come from the document owner. */
-import { type ReactNode } from 'react';
+import { type ComponentType, type ReactNode } from 'react';
 import type { PropsLocale, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
 import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
 import type { DocumentPreviewProps } from '../document/contract.ts';
 import type { PdfStore } from './store.ts';
+import type { ZoomViewportProps } from '../zoom/ZoomViewport.tsx';
 /** A record's viewing preferences survive body unmounts and leave with the tab. */
 export interface PdfBodyInjected {
     /**
@@ -12,6 +13,10 @@ export interface PdfBodyInjected {
      * @param signal - tab-record lifetime, not body visibility.
      */
     readonly retainTab: (tabId: TabId, signal: AbortSignal) => void;
+    /** Main-bundle viewport reused by the lazy PDF body. */
+    readonly ZoomViewport: ComponentType<ZoomViewportProps>;
+    /** Main-bundle class implementing fit-width and fixed-size surfaces. */
+    readonly zoomSurfaceClass: string;
 }
 /** Standard document props plus the PDF entry's locale, viewing store, and lifetime callback. */
 export type PdfBodyProps = DocumentPreviewProps & PropsLocale<'sidebarPdf'> & PropsStore<PdfStore> & PdfBodyInjected;

package/lib/types/client/pdf/store.d.ts

@@ -1,9 +1,11 @@
 /** Restorable PDF viewing preferences; document objects and canvases remain component-local. */
 import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
 import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
-/** One tab's last visible page. */
+import type { ZoomPreference } from '../zoom/types.ts';
+/** One tab's last visible page and optional PDF zoom preference. */
 export interface PdfView {
     readonly page: number;
+    readonly zoom?: ZoomPreference;
 }
 /** Page state isolated by the owning tab record. */
 export interface PdfState {
@@ -11,10 +13,11 @@ export interface PdfState {
 }
 type PdfActions = {
     page: (draft: PdfState, tabId: TabId, page: number) => void;
+    zoom: (draft: PdfState, tabId: TabId, zoom: ZoomPreference) => void;
     forget: (draft: PdfState, tabId: TabId) => void;
 };
 /**
- * Declare the last visible page isolated by tab identity.
+ * Declare the last visible page and zoom preference isolated by tab identity.
  * @returns a store declaration instantiated by the document slot for each Session.
  */
 export declare function createPdfStore(): EngineStoreHandle<PdfState, PdfActions>;

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

@@ -57,21 +57,13 @@ export declare function hostFileOf(address: string): SessionFile;
  * @returns the read the face performs.
  */
 export declare function createReadPage(remote: WorkspaceFilesReadRemote): ReadWorkspaceFilePage;
-/** Complete document bytes borrowed read-only by renderers; copy before transferring to a Worker. */
-export type DocumentFileBytes = Omit<WorkspaceFileBytes, 'data'> & {
-    readonly data: Uint8Array<ArrayBuffer>;
-};
+/** Document bytes borrowed read-only by renderers; copy before transferring to a Worker. */
+export type DocumentFileBytes = WorkspaceFileBytes<Uint8Array<ArrayBuffer>>;
 /**
  * Read a complete file through the Host endpoint.
  * @param file - Session and path decoded from the tab address.
  * @param signal - owning tab lifetime.
- * @returns complete binary bytes, including declared failures.
+ * @returns complete native bytes, including declared failures.
  */
 export type ReadDocumentBytes = (file: SessionFile, signal: AbortSignal) => Promise<RemoteResult<DocumentFileBytes>>;
-/**
- * Decode one successful Remote byte result for document renderers.
- * @param file - Host byte result with base64 data.
- * @returns the same metadata with native bytes; malformed base64 throws.
- */
-export declare function documentFileBytes(file: WorkspaceFileBytes): DocumentFileBytes;
 //# sourceMappingURL=rpc.d.ts.map

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

@@ -29,6 +29,8 @@ export interface TextPage {
 }
 /** One tab's pages and view. */
 export interface TextTabState {
+    autoRefresh: boolean;
+    resourcesDirty: boolean;
     /** Explicit viewer choice for this tab; absence follows automatic matching. */
     rendererId?: string;
     /** Current display-loading mode; absent before the first read. */
@@ -69,9 +71,12 @@ export interface TextState {
 export declare function fresh(): TextTabState;
 /** The preview store's write set; every action names the tab it writes. */
 type TextActions = {
+    toggledAutoRefresh: (draft: TextState, tabId: TabId) => void;
+    resourceChanged: (draft: TextState, tabId: TabId) => void;
     selected: (draft: TextState, tabId: TabId, rendererId: string | undefined) => void;
     loading: (draft: TextState, tabId: TabId, mode?: DocumentLoadMode, observedVersion?: string, contentRendererId?: string) => void;
     rendered: (draft: TextState, tabId: TabId, revision: number, version: string) => void;
+    rendererFailed: (draft: TextState, tabId: TabId, revision: number) => void;
     complete: (draft: TextState, tabId: TabId, file: DocumentFileBytes) => void;
     page: (draft: TextState, tabId: TabId, page: WorkspaceFileText) => void;
     failed: (draft: TextState, tabId: TabId, failure: RemoteFailure) => void;

package/lib/types/client/zoom/ZoomControls.d.ts

@@ -0,0 +1,21 @@
+import { type ZoomLabels } from './types.ts';
+/** Live percentage display updated independently from the document tree. */
+export interface ZoomControlsHandle {
+    /** @param zoom - current gesture scale multiplier. */
+    showZoom: (zoom: number) => void;
+}
+/**
+ * Present fit-width, fixed presets, and incremental controls.
+ * @param props - current resolved zoom, preference mode, labels, and callbacks.
+ * @returns a localized zoom toolbar.
+ */
+export declare const ZoomControls: import("react").ForwardRefExoticComponent<{
+    readonly zoom: number;
+    readonly fitWidth: boolean;
+    readonly labels: ZoomLabels;
+    readonly visible: boolean;
+    readonly onZoom: (zoom: number) => void;
+    readonly onFitWidth: () => void;
+    readonly onActiveChange: (active: boolean) => void;
+} & import("react").RefAttributes<ZoomControlsHandle>>;
+//# sourceMappingURL=ZoomControls.d.ts.map

package/lib/types/client/zoom/ZoomViewport.d.ts

@@ -0,0 +1,25 @@
+/** Shared zoom viewport, gesture handling, anchoring, and fit-width measurement. */
+import { type ReactNode, type RefCallback } from 'react';
+import { type ZoomLabels, type ZoomPreference } from './types.ts';
+/** @returns an actual-size scale that only shrinks content wider than the viewport. */
+export declare function fitWidthZoom(viewportWidth: number, intrinsicWidth: number | undefined, horizontalInset?: number): number;
+/** Shared viewport inputs for renderer-owned content and tab state. */
+export interface ZoomViewportProps {
+    readonly preference: ZoomPreference;
+    readonly intrinsicWidth: number | undefined;
+    readonly horizontalInset?: number;
+    readonly labels: ZoomLabels;
+    readonly signal: AbortSignal;
+    readonly scrollportRef: RefCallback<HTMLElement>;
+    readonly onPreference: (preference: ZoomPreference) => void;
+    readonly children: ReactNode;
+}
+/**
+ * Keep zoom controls and trackpad gestures independent from document rendering.
+ * @param props - renderer content, intrinsic width, tab preference, and localized labels.
+ * @returns the owned scrollport and floating zoom controls.
+ */
+export declare function ZoomViewport(props: ZoomViewportProps): ReactNode;
+/** Shared surface class for actual-size and fit-width layout. */
+export declare const zoomSurfaceClass: string;
+//# sourceMappingURL=ZoomViewport.d.ts.map

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

@@ -0,0 +1,21 @@
+/** Shared zoom copy embedded into renderer-owned dictionaries. */
+export declare const zoomZh: {
+    readonly zoomControls: "缩放控件";
+    readonly zoomMenu: "选择缩放比例";
+    readonly zoomOut: "缩小";
+    readonly zoomIn: "放大";
+    readonly zoomFitWidth: "适应宽度";
+    readonly zoomValue: "{percent}%";
+};
+/** Shared English zoom copy. */
+export declare const zoomEn: {
+    zoomControls: string;
+    zoomMenu: string;
+    zoomOut: string;
+    zoomIn: string;
+    zoomFitWidth: string;
+    zoomValue: string;
+};
+/** Shared zoom dictionary keys. */
+export type ZoomLocaleKey = keyof typeof zoomZh;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/zoom/store.d.ts

@@ -0,0 +1,28 @@
+/** Tab-local zoom preferences for renderers without additional view state. */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
+import { type ZoomPreference } from './types.ts';
+/** Tab-lifetime callback supplied by a zoomable renderer registration. */
+export interface ZoomInjected {
+    /** @param tabId - owning tab. @param signal - complete tab-record lifetime. */
+    readonly retainTab: (tabId: TabId, signal: AbortSignal) => void;
+}
+/** Zoom state isolated by the owning tab record. */
+export interface ZoomState {
+    byTab: Record<TabId, ZoomPreference>;
+}
+type ZoomActions = {
+    zoom: (draft: ZoomState, tabId: TabId, preference: ZoomPreference) => void;
+    forget: (draft: ZoomState, tabId: TabId) => void;
+};
+/**
+ * Create tab-local zoom state for a document renderer registration.
+ * @returns a store declaration retaining zoom until its tab closes.
+ */
+export declare function createZoomStore(): EngineStoreHandle<ZoomState, ZoomActions>;
+/** Default zoom value for a tab without retained state. */
+export declare const DEFAULT_ZOOM: ZoomPreference;
+/** Store declaration used by image previews. */
+export type ZoomStore = ReturnType<typeof createZoomStore>;
+export {};
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1,27 @@
+/** Automatic fit or an explicit actual-size scale selected by the reader. */
+export type ZoomPreference = {
+    readonly kind: 'fit-width';
+} | {
+    readonly kind: 'fixed';
+    readonly scale: number;
+};
+/** Default preference for a newly opened zoomable preview. */
+export declare const FIT_WIDTH: ZoomPreference;
+/** Minimum scale retained by a fixed zoom preference. */
+export declare const MIN_FIXED_ZOOM = 0.25;
+/** Maximum scale retained by a fixed zoom preference. */
+export declare const MAX_FIXED_ZOOM = 4;
+/** Scale interval used by the incremental controls. */
+export declare const ZOOM_STEP = 0.25;
+/** Fixed scale choices shown in the zoom menu. */
+export declare const ZOOM_OPTIONS: readonly [0.25, 0.5, 1, 1.5, 2];
+/** Localized copy consumed by the framework-free zoom controls. */
+export interface ZoomLabels {
+    readonly controls: string;
+    readonly menu: string;
+    readonly out: string;
+    readonly into: string;
+    readonly fitWidth: string;
+    readonly value: (percent: number) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/config.d.ts

@@ -13,9 +13,19 @@ export interface Config {
         /** Maximum readers including source and renderer metadata lookups. */
         maxReaders: number;
     };
+    /** Browser spreadsheet parser and dense cell allocation limits. */
+    excel: {
+        /** Maximum source file bytes. */
+        maxBytes: number;
+        /** Maximum combined rectangular cell area across worksheets. */
+        maxCells: number;
+        /** Maximum parser Worker lifetime in milliseconds. */
+        timeoutMs: number;
+    };
 }
 /** Deployment limits applied before Office preview registration. */
 export declare const Config: z<{
     office?: Partial<Config['office']>;
+    excel?: Partial<Config['excel']>;
 }, Config>;
 //# sourceMappingURL=config.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-sidebar-documentpreview",
-  "description": "Extensible document previews for Sidebar files: Office, Markdown, highlighted code, images, PDF, HTML, and plain text",
-  "version": "0.1.6-alpha.2",
+  "description": "Extensible Sidebar previews for Office documents, spreadsheets, Markdown, code, images, PDF, HTML, and plain text",
+  "version": "0.1.7-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -30,45 +30,57 @@
       "inject": [
         "@deepseek-ai/dsh-api-gateway",
         "@deepseek-ai/dsh-api-workspace-files",
+        "@deepseek-ai/dsh-client-resources",
         "@deepseek-ai/dsh-client-ui-sidebar-right",
         "@deepseek-ai/dsh-client-ui-session",
         "@deepseek-ai/dsh-api-remotes",
-        "@deepseek-ai/dsh-client-locale"
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings"
       ],
       "platform": "web"
     }
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "devDependencies": {
+    "@fortune-sheet/core": "1.0.4",
+    "@fortune-sheet/react": "1.0.4",
     "@testing-library/react": "^16.1.0",
+    "@types/papaparse": "^5.3.16",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "clsx": "^2.0.0",
+    "dompurify": "^3.4.11",
+    "exceljs": "4.4.0",
+    "fast-xml-parser": "5.11.1",
+    "fflate": "^0.8.3",
+    "papaparse": "5.5.3",
     "pdfjs-dist": "6.3.289",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-files": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-resources": "^0.1.6-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-dockkit": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-office-to-pdf": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.6-alpha.2"
+    "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-api-gateway": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-api-workspace-files": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-resources": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-dockkit": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-office-to-pdf": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-alpha.2"
   },
   "files": [
     "lib/index.js",
@@ -77,7 +89,7 @@
     "lib/types/**/*.d.ts"
   ],
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/schemastery": "~3.18.4"
   },
   "scripts": {
     "bundle": "tsdown",

package/lib/types/client/code/languages.d.ts

@@ -1,9 +0,0 @@
-/** Recognized suffixes shared by renderer selection and language hints. */
-export declare const CODE_EXTENSIONS: readonly string[];
-/**
- * Select the shared highlighter's grammar for a filename.
- * @param path - decoded source filename or path.
- * @returns a supported grammar hint, or undefined for other suffixes.
- */
-export declare function languageForPath(path: string): string | undefined;
-//# sourceMappingURL=languages.d.ts.map