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

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';
@@ -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

@@ -0,0 +1,14 @@
+/** 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 fonts: readonly string[];
+};
+/**
+ * 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({ fonts, t }: FontNoticeProps): ReactNode;
+//# sourceMappingURL=FontNotice.d.ts.map

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

@@ -0,0 +1,38 @@
+/** 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 { 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 { OfficeLoadInjected } from './face.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 extends OfficeLoadInjected {
+    /** @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 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/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/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/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,39 @@
+/** Office preview copy and Host render configuration guidance. */
+export declare const zh: {
+    title: string;
+    loading: string;
+    retry: string;
+    viewMissingFonts: 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;
+    viewMissingFonts: 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/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/{PdfBody.d.ts → 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 { 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;
@@ -21,4 +26,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

@@ -1,22 +1,23 @@
 /** 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;
 }
-/** 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>;
 }
 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/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

@@ -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 wire bytes, including declared failures.
+ * @returns complete native bytes, including declared failures.
  */
-export type ReadDocumentBytes = (file: SessionFile, signal: AbortSignal) => Promise<RemoteResult<WorkspaceFileBytes>>;
-/**
- * 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;
+export type ReadDocumentBytes = (file: SessionFile, signal: AbortSignal) => Promise<RemoteResult<DocumentFileBytes>>;
 //# sourceMappingURL=rpc.d.ts.map

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

@@ -29,10 +29,16 @@ 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. */
     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. */
@@ -65,8 +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) => 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