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

package/lib/index.js

@@ -1,6 +1,28 @@
+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)
+}) });
+//#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

@@ -19,5 +19,5 @@ export type TextPreviewProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsRen
  * @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, }: 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,23 +20,33 @@ 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;
+    /** 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 {
+    /** 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: {
-                /** 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>;
-            };
+            owner: DocumentBodyOwner;
             hookContext: UseSidebarRightTabInfo;
             inject: {
                 hooks: {

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/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/face.d.ts

@@ -61,6 +61,15 @@ 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.

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

@@ -16,7 +16,7 @@ import { DocumentPreviewRegistry } from './document/registry.ts';
 export type { SidebarDocumentPreviewKey } from './locales.ts';
 export type { TextPreviewProps } from './TextPreview.tsx';
 export type { TextInjected } from './face.ts';
-export type { ReadWorkspaceFilePage, SessionFile, WorkspaceFilesReadRemote } from './rpc.ts';
+export type { ReadDocumentBytes, DocumentFileBytes, ReadWorkspaceFilePage, SessionFile, WorkspaceFilesReadRemote } from './rpc.ts';
 export type { TextPage, TextState, TextStore, TextTabState } from './store.ts';
 export type { DocumentContent, DocumentPreviewProps, DocumentTextPage } from './document/contract.ts';
 export type { DocumentLoadMode, DocumentPreviewDefinition } from './document/registry.ts';

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

@@ -0,0 +1,16 @@
+/** Missing-font notice and a non-modal details panel for one source version. */
+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.
+ */
+export declare function FontNotice({ resourceAddress, sourceVersion, fonts, t }: FontNoticeProps): ReactNode;
+//# sourceMappingURL=FontNotice.d.ts.map

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

@@ -0,0 +1,44 @@
+/** Office owns source loading, conversion failures, 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 { OfficeStore } from './store.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        /** PDF presentation supplied with Office-owned converted bytes. */
+        'sidebar.right.tab.document.office.pdf': {
+            kind: 'keyed';
+            scope: 'session';
+            owner: DocumentBodyOwner;
+            hookContext: UseSidebarRightTabInfo;
+            inject: {
+                hooks: {
+                    tabInfo: SlotHookFactory<'sidebar.right.tab.document', UseSidebarRightTabInfo>;
+                };
+            };
+        };
+    }
+}
+/** 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;
+    /** @param tab - owning tab. @param signal - tab lifetime, including hidden bodies. */
+    readonly retainTab: (tab: TabId, signal: AbortSignal) => void;
+}
+/** Office body inputs and its private PDF child. */
+export type OfficeBodyProps = DocumentPreviewProps & PropsStore<OfficeStore> & OfficeBodyInjected & PropsLocale<'sidebarOffice'> & PropsRenderSlots<'sidebar.right.tab.document.office.pdf'>;
+/**
+ * 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.
+ */
+export declare function OfficeBody(props: OfficeBodyProps): ReactNode;
+//# sourceMappingURL=OfficeBody.d.ts.map

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

@@ -0,0 +1,70 @@
+/** Session-authorized, version-checked Office bytes shared by concurrent preview reads. */
+import type { OfficeToPdfPriority, OfficeToPdfGeneration } from '@deepseek-ai/dsh-office-to-pdf/types';
+import type { RemoteResult } from '@deepseek-ai/dsh-api-remotes/client';
+import type { WorkspaceFileStat } from '@deepseek-ai/dsh-api-workspace-files/types';
+import type { DocumentFileBytes, SessionFile } from '../rpc.ts';
+/** PDF bytes and conversion metadata owned by Office preview. */
+export type OfficeFileBytes = DocumentFileBytes & {
+    readonly missingFonts: readonly string[];
+    readonly generation: OfficeToPdfGeneration;
+};
+/**
+ * Load authorized PDF contents for one Office source.
+ * @param file - Session and source path.
+ * @param signal - this reader's lifetime.
+ * @returns converted PDF bytes or a declared source-access failure.
+ */
+export type ReadOfficeDocument = (file: SessionFile, signal: AbortSignal) => Promise<RemoteResult<OfficeFileBytes>>;
+/** Authorized cached reads carry explicit scheduling intent to the Host. */
+export type ReadOfficeBytes = (file: SessionFile, signal: AbortSignal, priority: OfficeToPdfPriority) => ReturnType<ReadOfficeDocument>;
+type Result = Awaited<ReturnType<ReadOfficeDocument>>;
+type Stat = (file: SessionFile, signal: AbortSignal) => Promise<RemoteResult<WorkspaceFileStat>>;
+/** Bounded successful results; each caller reauthorizes and checks source freshness before reuse. */
+export declare class OfficePreviewCache {
+    private readonly stat;
+    private readonly convert;
+    private readonly maxEntries;
+    private readonly maxBytes;
+    private readonly maxPending;
+    private readonly maxReaders;
+    private readonly currentGeneration;
+    private readonly busy;
+    private readonly ready;
+    private readonly pending;
+    private bytes;
+    private readers;
+    private generation;
+    private generationQuery;
+    private acceptedQuery;
+    private readonly superseded;
+    private readonly lifetime;
+    private readonly tasks;
+    private readonly reads;
+    /**
+     * @param stat - authorized source metadata lookup.
+     * @param convert - Host render Remote returning binary PDF bytes borrowed read-only by callers.
+     * @param maxEntries - maximum completed results retained.
+     * @param maxBytes - maximum retained PDF byteLength.
+     * @param maxPending - maximum unsettled Host conversion requests, including cancellation teardown.
+     * @param maxReaders - maximum readers, including metadata lookups.
+     * @param generation - current Host renderer generation, checked before cached reuse.
+     * @param busy - localized capacity failure.
+     */
+    constructor(stat: Stat, convert: ReadOfficeBytes, maxEntries: number, maxBytes: number, maxPending: number, maxReaders: number, currentGeneration: (signal: AbortSignal) => Promise<RemoteResult<OfficeToPdfGeneration>>, busy: () => Error);
+    /**
+     * Share a conversion without letting one caller cancel another caller's work.
+     * Renderer replacement retries authorization once; repeated replacement reports localized capacity failure.
+     * @param file - Session authorization scope and source path.
+     * @param signal - this caller's lifetime.
+     * @param priority - foreground preview or speculative read.
+     * @returns current PDF bytes borrowed read-only, or a declared source-read failure; cancellation rejects.
+     */
+    read(file: SessionFile, signal: AbortSignal, priority?: OfficeToPdfPriority): Promise<Result>;
+    private lookup;
+    private lookupGeneration;
+    /** Clear retained bytes, cancel outstanding conversions, and await their completion. */
+    dispose(): Promise<void>;
+    private retain;
+}
+export {};
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1,16 @@
+/** Office preview registration backed by authorized Host rendering and the existing PDF body. */
+import type { Context } from '@deepseek-ai/cordis';
+import { type OfficePreviewKey } from './locales.ts';
+import type { Config } from '../../config.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        sidebarOffice: OfficePreviewKey;
+    }
+}
+/**
+ * Register Office previews with versioned PDF reuse and missing-font notices.
+ * @param ctx - Client renderer registry, localized copy, and optional Host Remotes.
+ * @param config - Resolved Office preview cache limits.
+ */
+export declare function apply(ctx: Context, config: Config['office']): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,43 @@
+/** Office preview copy and Host render configuration guidance. */
+export declare const zh: {
+    title: string;
+    loading: string;
+    retry: string;
+    missingFonts: string;
+    showMore: string;
+    dismissNotice: string;
+    missingFontsTitle: string;
+    missingFontsDescription: string;
+    missingFontsCount: string;
+    closeDetails: string;
+    unavailable: string;
+    invalid: string;
+    tooLarge: string;
+    failed: string;
+    timeout: string;
+    busy: string;
+    changed: string;
+};
+/** Office preview locale keys. */
+export type OfficePreviewKey = keyof typeof zh;
+/** English translations checked against the Chinese key set. */
+export declare const en: {
+    title: string;
+    loading: string;
+    retry: string;
+    missingFonts: string;
+    showMore: string;
+    dismissNotice: string;
+    missingFontsTitle: string;
+    missingFontsDescription: string;
+    missingFontsCount: string;
+    closeDetails: string;
+    unavailable: string;
+    invalid: string;
+    tooLarge: string;
+    failed: string;
+    timeout: string;
+    busy: string;
+    changed: string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1,32 @@
+/** Loaded Office previews survive body remounts until reload or tab closure. */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
+import type { OfficeFileBytes } from './cache.ts';
+/** One requested source revision and its settled preview. */
+export interface OfficeView {
+    readonly revision: number;
+    readonly file?: OfficeFileBytes;
+    readonly failure?: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+/** Office-owned content, isolated by tab identity. */
+export interface OfficeState {
+    byTab: Record<TabId, OfficeView>;
+}
+type OfficeActions = {
+    loading: (state: OfficeState, tab: TabId, revision: number) => void;
+    complete: (state: OfficeState, tab: TabId, revision: number, file: OfficeFileBytes) => void;
+    failed: (state: OfficeState, tab: TabId, revision: number, failure: NonNullable<OfficeView['failure']>) => void;
+    forget: (state: OfficeState, tab: TabId) => void;
+};
+/**
+ * Retain Office contents across body remounts within a Session.
+ * @returns the tab-content store declaration.
+ */
+export declare function createOfficeStore(): EngineStoreHandle<OfficeState, OfficeActions>;
+/** Store declaration used by the Office body. */
+export type OfficeStore = ReturnType<typeof createOfficeStore>;
+export {};
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1,10 @@
+/** Load the PDF renderer only after a PDF body is mounted. */
+import { type ReactNode } from 'react';
+import type { PdfBodyProps } from './pdf.tsx';
+/**
+ * Suspend while the package-local PDF chunk arrives.
+ * @param props - PDF body props supplied by the document slot.
+ * @returns the deferred PDF renderer.
+ */
+export declare function LazyPdfBody(props: PdfBodyProps): ReactNode;
+//# sourceMappingURL=LazyPdfBody.d.ts.map

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

@@ -1,5 +1,5 @@
 /** Canvas rendering with cancellation and page cleanup, shared by the PDF body and real-library smoke. */
-import type { PDFDocumentProxy } from 'pdfjs-dist';
+import type { PDFDocumentProxy, PDFPageProxy, PageViewport } from 'pdfjs-dist';
 /** The document operations used by one mounted PDF body. */
 export type PdfDocument = Pick<PDFDocumentProxy, 'numPages' | 'getPage'>;
 /** One in-flight PDF load and its complete cleanup operation. */
@@ -17,6 +17,11 @@ export interface PdfPageSize {
     readonly width: number;
     readonly height: number;
 }
+/** Optional DOM text rendering that shares the canvas page's cleanup barrier. */
+export type RenderPdfText = (page: PDFPageProxy, viewport: PageViewport) => {
+    readonly promise: Promise<void>;
+    cancel(): void;
+};
 /**
  * Render one page into an exclusively owned canvas. Cancellation cannot write
  * dimensions after a delayed getPage; active render tasks are cancelled and
@@ -26,7 +31,8 @@ export interface PdfPageSize {
  * @param canvas - canvas owned by this render only.
  * @param signal - render lifetime.
  * @param pixelRatio - display pixel ratio.
+ * @param renderText - optional selectable text layer sharing this page and viewport.
  * @returns the page's CSS dimensions after rendering completes.
  */
-export declare function renderPdfPage(document: PdfDocument, pageNumber: number, canvas: HTMLCanvasElement, signal: AbortSignal, pixelRatio: number): Promise<PdfPageSize>;
+export declare function renderPdfPage(document: PdfDocument, pageNumber: number, canvas: HTMLCanvasElement, signal: AbortSignal, pixelRatio: number, renderText?: RenderPdfText): Promise<PdfPageSize>;
 //# sourceMappingURL=document.d.ts.map

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

@@ -1,6 +1,10 @@
 /** Builtin PDF registration through document metadata and the keyed body slot. */
 import type { Context } from '@deepseek-ai/cordis';
 import type { DocumentPreviewDefinition } from '../document/registry.ts';
+import type { PdfBodyInjected } from './pdf.tsx';
+import type { BoundActions } from '@deepseek-ai/dsh-client-store';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import { type PdfStore } from './store.ts';
 /** PDF metadata and keyed body share this package-local implementation identity. */
 export declare const PDF_BODY_ID = "@deepseek-ai/dsh-client-ui-sidebar-documentpreview/pdf";
 /**
@@ -11,4 +15,13 @@ export declare const PDF_BODY_ID = "@deepseek-ai/dsh-client-ui-sidebar-documentp
 export declare function pdfBodyDefinition(title: () => string): DocumentPreviewDefinition;
 /** @param ctx - context carrying the locale, document registry, and slot registry. */
 export declare function apply(ctx: Context): void;
+/**
+ * Retain PDF viewing state for a document entry's tab lifetime.
+ * @param ctx - owning registration context.
+ * @returns the store and injection shared by ordinary and Office PDF registrations.
+ */
+export declare function pdfBodyRegistration(ctx: Context): {
+    store: PdfStore;
+    inject: (sessionId: SessionId, actions: BoundActions<PdfStore>) => PdfBodyInjected;
+};
 //# sourceMappingURL=index.d.ts.map

package/lib/types/client/pdf/{PdfBody.d.ts → pdf.d.ts}

@@ -3,7 +3,7 @@ import { 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 { PdfStore } from './store.ts';
 /** A record's viewing preferences survive body unmounts and leave with the tab. */
 export interface PdfBodyInjected {
     /**
@@ -21,4 +21,4 @@ export type PdfBodyProps = DocumentPreviewProps & PropsLocale<'sidebarPdf'> & Pr
  * @returns the PDF reader.
  */
 export declare function PdfBody(props: PdfBodyProps): ReactNode;
-//# sourceMappingURL=PdfBody.d.ts.map
+//# sourceMappingURL=pdf.d.ts.map

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

@@ -5,8 +5,6 @@ import type { TabId } from '@deepseek-ai/dsh-client-ui-dockkit';
 export interface PdfView {
     readonly page: number;
 }
-/** Initial viewing position before a tab reaches another page. */
-export declare const DEFAULT_PDF_VIEW: PdfView;
 /** Page state isolated by the owning tab record. */
 export interface PdfState {
     byTab: Record<TabId, PdfView>;

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

@@ -0,0 +1,10 @@
+/** PDF.js's viewer owns selection boundaries and copy normalization; the overlay follows its canvas. */
+import 'pdfjs-dist';
+import type { RenderPdfText } from './document.ts';
+/**
+ * Create a selectable overlay in a component-owned host.
+ * @param host - absolute overlay matching the displayed canvas dimensions.
+ * @returns renderer whose cancellation also releases its resize observer and DOM.
+ */
+export declare function pdfTextRenderer(host: HTMLDivElement): RenderPdfText;
+//# sourceMappingURL=text.d.ts.map

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

@@ -65,9 +65,9 @@ export type DocumentFileBytes = Omit<WorkspaceFileBytes, 'data'> & {
  * 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 wire bytes, including declared failures.
+ * @returns complete binary bytes, including declared failures.
  */
-export type ReadDocumentBytes = (file: SessionFile, signal: AbortSignal) => Promise<RemoteResult<WorkspaceFileBytes>>;
+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.

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

@@ -33,6 +33,10 @@ export interface TextTabState {
     rendererId?: string;
     /** Current display-loading mode; absent before the first read. */
     mode?: DocumentLoadMode;
+    /** Implementation owning source loading; absent for ordinary file reads. */
+    contentRendererId?: string;
+    /** Current content revision, incremented whenever loaded content is discarded. */
+    loadRevision: number;
     /** Full byte result used by complete-file renderers. */
     complete?: DocumentFileBytes;
     /** The file version the loaded pages belong to; absent before the first page. */
@@ -66,7 +70,8 @@ export declare function fresh(): TextTabState;
 /** The preview store's write set; every action names the tab it writes. */
 type TextActions = {
     selected: (draft: TextState, tabId: TabId, rendererId: string | undefined) => void;
-    loading: (draft: TextState, tabId: TabId, mode?: DocumentLoadMode, observedVersion?: string) => void;
+    loading: (draft: TextState, tabId: TabId, mode?: DocumentLoadMode, observedVersion?: string, contentRendererId?: string) => void;
+    rendered: (draft: TextState, tabId: TabId, revision: number, version: string) => 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/config.d.ts

@@ -0,0 +1,21 @@
+/** Cache limits shared by the Host configuration and browser document previews. */
+import z from '@deepseek-ai/schemastery';
+/** Transient Office conversion reuse within one Client connection. */
+export interface Config {
+    /** Retained PDF limits; pending conversions share cancellation by reader lifetime. */
+    office: {
+        /** Maximum retained completed PDFs. */
+        maxCachedEntries: number;
+        /** Maximum retained PDF bytes, counted by each binary buffer's byteLength. */
+        maxCachedBytes: number;
+        /** Maximum unsettled Host conversion RPCs, including cancellation teardown. */
+        maxPending: number;
+        /** Maximum readers including source and renderer metadata lookups. */
+        maxReaders: number;
+    };
+}
+/** Deployment limits applied before Office preview registration. */
+export declare const Config: z<{
+    office?: Partial<Config['office']>;
+}, Config>;
+//# sourceMappingURL=config.d.ts.map

package/lib/types/index.d.ts

@@ -1,4 +1,11 @@
-/** Pure host half; the whole preview lives in the browser export. */
-/** Host plugin body: the preview contributes nothing to the host tree. */
-export declare function apply(): void;
+/** Host configuration for browser document previews. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Config } from './config.ts';
+export { Config } from './config.ts';
+/**
+ * Embed validated preview settings in browser pages.
+ * @param ctx - Host context serving browser pages.
+ * @param config - Cache limits adopted when the page loads.
+ */
+export declare function apply(ctx: Context, config: Config): void;
 //# sourceMappingURL=index.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: Markdown, highlighted code, images, PDF, HTML, and plain text",
-  "version": "0.1.6-alpha.1",
+  "description": "Extensible document previews for Sidebar files: Office, Markdown, highlighted code, images, PDF, HTML, and plain text",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -32,7 +32,8 @@
         "@deepseek-ai/dsh-api-workspace-files",
         "@deepseek-ai/dsh-client-ui-sidebar-right",
         "@deepseek-ai/dsh-client-ui-session",
-        "@deepseek-ai/dsh-api-remotes"
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale"
       ],
       "platform": "web"
     }
@@ -49,28 +50,35 @@
     "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-api-gateway": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-api-workspace-files": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-resources": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-dockkit": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.1"
+    "@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"
   },
   "files": [
     "lib/index.js",
     "lib/client.js",
+    "lib/client.*.js",
     "lib/types/**/*.d.ts"
   ],
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.2"
+  },
   "scripts": {
     "bundle": "tsdown",
     "watch": "tsdown --watch"