superdoc 2.29.0-next.9 → 2.30.0-next.13

package/dist/superdoc/src/composables/use-viewport-fit.d.ts

@@ -1,3 +1,63 @@
+import { Ref } from 'vue';
+import { RuntimeDocument, SuperDocFitWidthOptions, SuperDocViewportMetrics, SuperDocZoomConfig, SuperDocZoomMode } from '../core/types/index.js';
+import { PageMetricsPage, PageMetricsSnapshot } from '../public/ui/page-metrics.js';
+export type ResolvedFitWidthOptions = Required<SuperDocFitWidthOptions>;
+type PageWidthSnapshot = Partial<Pick<PageMetricsSnapshot, 'widestPageWidthPx'>> & {
+    pages?: ReadonlyArray<{
+        base?: Partial<Pick<PageMetricsPage['base'], 'widthPx'>>;
+    } | null | undefined>;
+};
+type EditorPageGeometry = {
+    pageMetrics?: {
+        getSnapshot?: () => PageWidthSnapshot | null | undefined;
+    } | null;
+    getPages?: () => Array<{
+        size?: {
+            w?: unknown;
+        };
+    } | null | undefined> | null | undefined;
+    getPageStyles?: () => {
+        pageSize?: {
+            width?: unknown;
+        };
+    } | null | undefined;
+};
+type ViewportFitEventName = 'editorCreate' | 'pagination-update' | 'pdf:document-ready';
+interface ViewportFitSuperDoc {
+    config?: {
+        zoom?: Pick<SuperDocZoomConfig, 'fitWidth'> | null;
+    } | null;
+    activeEditor?: EditorPageGeometry | null;
+    emit(event: 'zoomChange', payload: {
+        zoom: number;
+        mode: 'fit-width';
+    }): unknown;
+    emit(event: 'viewport-change', payload: SuperDocViewportMetrics): unknown;
+    on?(event: ViewportFitEventName, listener: () => void): unknown;
+    off?(event: ViewportFitEventName, listener: () => void): unknown;
+}
+interface UseViewportFitOptions {
+    getSuperdoc: () => ViewportFitSuperDoc | null | undefined;
+    superdocContainerWidth: Readonly<Ref<number>>;
+    isReady: Readonly<Ref<boolean>>;
+    activeZoom: Ref<number>;
+    zoomMode: Readonly<Ref<SuperDocZoomMode>>;
+    viewportMetrics: Ref<SuperDocViewportMetrics | null>;
+    showCommentsSidebar?: Readonly<Ref<unknown>>;
+    rightSidebarRef?: Readonly<Ref<HTMLElement | null>>;
+    superdocRoot: Readonly<Ref<HTMLElement | null>>;
+    documents?: Readonly<Ref<readonly RuntimeDocument[]>>;
+}
+export declare const FIT_WIDTH_DEFAULTS: Readonly<{
+    min: 10;
+    max: 100;
+    padding: 0;
+}>;
+export declare const resolveFitWidthOptions: (rawFitConfig: unknown) => ResolvedFitWidthOptions;
+export declare const computeFitZoom: (availableWidth: number, documentWidth: number) => number | null;
+export declare const computeAppliedFitZoom: (availableWidth: number, documentWidth: number, options: ResolvedFitWidthOptions) => number | null;
+export declare const normalizePdfPageMeasurement: (measured: number, scaleFactor: number, zoomFactor: number) => number | null;
+export declare const resolveEditorPageWidth: (editor: EditorPageGeometry | null | undefined) => number | null;
 /**
  * Viewport fit tracking. Maintains pure viewport metrics (available width,
  * document base width, fit zoom), stores them for `getViewportMetrics()`,
@@ -21,31 +81,7 @@
  * Must be called inside a component `setup()` (registers watchers and an
  * unmount hook).
  */
-export function useViewportFit({ getSuperdoc, superdocContainerWidth, isReady, activeZoom, zoomMode, viewportMetrics, showCommentsSidebar, rightSidebarRef, superdocRoot, documents, }: {
-    getSuperdoc: any;
-    superdocContainerWidth: any;
-    isReady: any;
-    activeZoom: any;
-    zoomMode: any;
-    viewportMetrics: any;
-    showCommentsSidebar: any;
-    rightSidebarRef: any;
-    superdocRoot: any;
-    documents: any;
-}): {
+export declare function useViewportFit({ getSuperdoc, superdocContainerWidth, isReady, activeZoom, zoomMode, viewportMetrics, showCommentsSidebar, rightSidebarRef, superdocRoot, documents, }: UseViewportFitOptions): {
     evaluateViewport: () => void;
 };
-export const FIT_WIDTH_DEFAULTS: Readonly<{
-    min: 10;
-    max: 100;
-    padding: 0;
-}>;
-export function resolveFitWidthOptions(rawFitConfig: any): {
-    min: number;
-    max: number;
-    padding: any;
-};
-export function computeFitZoom(availableWidth: any, documentWidth: any): number | null;
-export function computeAppliedFitZoom(availableWidth: any, documentWidth: any, options: any): number | null;
-export function normalizePdfPageMeasurement(measured: any, scaleFactor: any, zoomFactor: any): any;
-export function resolveEditorPageWidth(editor: any): number | null;
+export {};

package/dist/superdoc/src/core/SuperDoc.d.ts

@@ -2,7 +2,7 @@ import { SuperDocDiagnostics } from './types/diagnostics.js';
 import { EventEmitter } from 'eventemitter3';
 import { DocumentReplacementResult } from '../public/document-replacement.js';
 import { HocuspocusProviderWebsocket } from '@hocuspocus/provider';
-import { createSuperdocVueApp } from './create-app.js';
+import { Pinia } from 'pinia';
 import { Whiteboard } from './whiteboard/Whiteboard.js';
 import { normalizeUiConfig } from './config/normalize-ui-config.js';
 import { normalizeInteractionConfig } from './config/normalize-interaction-config.js';
@@ -47,10 +47,12 @@ interface SuperDocEventMap {
     'comments-list-change': [SuperDocCommentsListChangePayload];
     /** Requests the shell open its find/replace surface (e.g. the toolbar search button). */
     'search:open': [];
+    /** @deprecated replaceWith=`superdoc.ui.zoom.observe` removeIn=v3.0 */
     zoomChange: [SuperDocZoomPayload];
     'measurement-unit-change': [SuperDocMeasurementUnitChangePayload];
     'page-margins-change': [SuperDocPageMarginsChangePayload];
     'formatting-marks-change': [SuperDocFormattingMarksChangePayload];
+    /** @deprecated replaceWith=`superdoc.ui.document.observe` removeIn=v3.0 */
     'document-mode-change': [SuperDocDocumentModeChangePayload];
     /**
      * The active editor was assigned or cleared. Internal: the UI controller
@@ -85,9 +87,15 @@ interface SuperDocEventMap {
     'fonts-resolved': [FontsResolvedPayload];
     'fonts-changed': [FontsChangedPayload];
     'pagination-update': [SuperDocPaginationUpdatePayload];
+    /**
+     * Never emitted by SuperDoc 2.
+     *
+     * @deprecated replaceWith=`editor-update` and `doc.lists.list` removeIn=v3.0
+     */
     'list-definitions-change': [ListDefinitionsPayload];
     'comments-update': [SuperDocCommentsUpdatePayload];
     'content-control:active-change': [ContentControlActiveChangePayload];
+    /** @deprecated replaceWith=`superdoc.ui.contentControls.onClick` removeIn=v3.0 */
     'content-control:click': [ContentControlClickPayload];
     'collaboration-ready': [SuperDocEditorPayload];
     'awareness-update': [SuperDocAwarenessUpdatePayload];
@@ -98,6 +106,7 @@ interface SuperDocEventMap {
     'whiteboard:change': [WhiteboardData];
     'whiteboard:enabled': [boolean];
     'whiteboard:tool': [string];
+    /** A union of payloads; narrow by `stage`, `code`, `itemName`, `source`, or `diagnosticCode` before reading on. */
     exception: [SuperDocExceptionPayload];
     'viewport-change': [SuperDocViewportChangePayload];
     'source:complete': [];
@@ -223,9 +232,9 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
      * mount/unmount, `provide()`, and `config.globalProperties` setup.
      * Not consumer API: no docs or examples reference `superdoc.app`,
      * and the only cross-file reader (`SuperComments.createVueApp()`
-     * at `super-comments-list.js:35`) is a `.js` file under
-     * `checkJs: false`, so the `@private` boundary does not break
-     * internal source compilation.
+     * in `super-comments-list.ts`) uses bracket access, which
+     * TypeScript allows for `private` members, so the `@private`
+     * boundary does not break internal source compilation.
      *
      * Same SD-3213f-style TS surface hide as
      * `superdocStore` / `commentsStore` /
@@ -235,7 +244,7 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
      */
     private app;
     /** Pinia store root for the SuperDoc Vue app. Set in `#initVueApp`. */
-    pinia: ReturnType<typeof createSuperdocVueApp>['pinia'] | undefined;
+    pinia: Pinia | undefined;
     /** Count of editors that have signaled `editorCreate`. */
     readyEditors: number;
     activeEditor: Editor | null;
@@ -339,7 +348,7 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
      * surface does not pull the Pinia comment model type graph.
      *
      */
-    getComment(commentId: string): import('../stores/helpers/comment-identity.js').CommentIdentityRow | null;
+    getComment(commentId: string): Record<string, unknown> | null;
     /**
      * Get the SuperDoc container element
      */

package/dist/superdoc/src/core/collaboration/cdn-collaboration-comment-map.d.ts

@@ -0,0 +1 @@
+export declare function createCollaborationCommentMap(entries: Iterable<[string, unknown]>): import('yjs').Map<unknown>;

package/dist/superdoc/src/core/collaboration/collaboration-comment-map.d.ts

@@ -0,0 +1,2 @@
+import { Map as YMap } from 'yjs';
+export declare function createCollaborationCommentMap(entries: Iterable<[string, unknown]>): YMap<unknown>;

package/dist/superdoc/src/core/collaboration/helpers.d.ts

@@ -1,4 +1,4 @@
-import { CommentEvent } from '../../../../../shared/common';
+import { CommentEvent } from '../../../../shared/common/event-types.js';
 import { SuperDoc } from '../SuperDoc.js';
 import { Modules, User } from '../types/index.js';
 import { CollaborationCommentEvent } from './collaboration-comments.js';

package/dist/superdoc/src/core/config/normalize-interaction-config.d.ts

@@ -1,4 +1,4 @@
-import { CommentInteractionLevel, Config } from '../types/index.js';
+import { CommentInteractionLevel, Config, WritingAssistanceConfig } from '../types/index.js';
 type InteractionSource = Pick<Config, 'interaction' | 'modules'>;
 type NormalizedInteractionConfig = {
     comments: {
@@ -9,6 +9,15 @@ type NormalizedInteractionConfig = {
     trackedChanges: {
         allowDecisions: boolean;
     };
+    touch: {
+        gestures: boolean;
+    };
+    writingAssistance: {
+        enabled: boolean;
+        autocorrect: boolean;
+        autocapitalize: NonNullable<WritingAssistanceConfig['autocapitalize']>;
+        spellcheck: boolean;
+    };
 };
 /**
  * Resolve the effective interaction policy.

package/dist/superdoc/src/core/document-open-telemetry.d.ts

@@ -1,4 +1,4 @@
-import { Telemetry, TelemetryConfig } from '../../../../shared/common';
+import { Telemetry, TelemetryConfig } from '../../../shared/common/Telemetry.js';
 import { Config } from './types/index.js';
 type DocumentOpenTelemetryClient = Pick<Telemetry, 'trackDocumentOpen'>;
 export type DocumentOpenTelemetry = {

package/dist/superdoc/src/core/editor-runtime/types.d.ts

@@ -377,6 +377,10 @@ export type EditorRuntimeUnsubscribe = () => void;
  * computeds without forcing them async in current implementation.
  */
 export interface EditorRuntimeUser {
+    commentIdentity?: {
+        providerId: string;
+        userId: string;
+    } | null;
     name: string;
     id?: string;
     email?: string;

package/dist/superdoc/src/core/editor-runtime/v2/v2-editor-runtime-adapter.d.ts

@@ -189,5 +189,6 @@ export interface V2EditorRuntimeAdapterOptions {
 export declare function createV2EditorRuntimeAdapter(options: V2EditorRuntimeAdapterOptions): {
     runtime: EditorRuntime;
     attachMountHandle(handle: HostMountHandleLike | null): void;
+    detach(): void;
 };
 export {};

package/dist/superdoc/src/core/pdf/pdf-adapter.d.ts

@@ -20,10 +20,14 @@ export declare class PDFJSAdapter extends PDFAdapter {
     workerSrc: string | undefined;
     constructor(config: PDFJSConfig);
     getDocument(file: PdfSource): Promise<PDFDocumentProxy>;
-    getPages(pdf: PDFDocumentProxy, firstPage: number, lastPage: number): Promise<PDFPageProxy[]>;
+    getPages<Page = PDFPageProxy>(pdf: {
+        getPage(pageNumber: number): Promise<Page>;
+    }, firstPage: number, lastPage: number): Promise<Page[]>;
 }
 export declare class PDFAdapterFactory {
-    static create(config: PDFConfig): PDFJSAdapter;
+    static create(config: PDFJSConfig & {
+        adapter: string;
+    }): PDFJSAdapter;
 }
 export declare function getWorkerSrcFromCDN(version: string): string;
 export {};

package/dist/superdoc/src/core/types/index.d.ts

@@ -3,11 +3,12 @@ import { DiagnosticsConfig } from './diagnostics.js';
 import { Doc as YDoc } from 'yjs';
 import { HocuspocusProviderWebsocket } from '@hocuspocus/provider';
 import { Ref, ComputedRef } from 'vue';
-import { ContentControlType, HyperlinkTarget } from '../../../../document-api/src/index.js';
+import { HyperlinkTarget } from '../../../../document-api/src/index.js';
 import { DocumentFontOption, FontAssetUrlResolver, FontFamilyOption, FontLoadSummary, FontResolutionRecord } from '../../../../shared/font-system/src/index.js';
 import { SuperDoc as SuperDocClass } from '../SuperDoc.js';
 import { SuperDocActiveEditorExtensions, SuperDocExtension } from '../extensions/index.js';
 import { BrowserDocumentApi } from '../../public/browser-document-api.js';
+import { ContentControlClickPayload, ContentControlRef } from '../../public/content-control-ref.js';
 import { CustomCommandContext, FontFamilyOption as ToolbarFontFamilyOption } from '../../public/ui/types.js';
 export type { DocumentFontOption, FontFamilyOption, FontLoadSummary, FontResolutionRecord, } from '../../../../shared/font-system/src/index.js';
 export type SuperDoc = SuperDocClass;
@@ -449,12 +450,41 @@ export interface V2AuthoringFacade {
  * `#assignUserColor()` after `#init`.
  */
 export interface User {
+    commentIdentity?: {
+        providerId: string;
+        userId: string;
+    } | null;
+    /** Stable application user id. Collaborative change records report it as the actor id. */
     id?: string | null;
     name?: string | null;
     email?: string | null;
     image?: string | null;
+    /**
+     * Opaque identity claim published with this session's change records, such as
+     * a JWT your server signs. SuperDoc never verifies it.
+     */
+    claim?: UserClaim;
     [key: string]: unknown;
 }
+/** Context passed to a {@link UserClaim} function. */
+export interface UserClaimContext {
+    /** Collaboration document id of the session. */
+    documentId: string;
+    /** Yjs client id of the session. */
+    clientId: number;
+}
+/**
+ * Identity claim for {@link User.claim}: a string, or a function that returns
+ * one for the session's collaboration document and Yjs client id.
+ */
+export type UserClaim = string | ((ctx: UserClaimContext) => string | Promise<string>);
+/** Per-session retention of attributed change records (`doc.changes`). */
+export interface ChangesConfig {
+    /** Maximum number of retained records. Defaults to 1000. */
+    retainRecords?: number;
+    /** Maximum retained size in bytes, including captured updates. Defaults to 8 MiB. */
+    retainBytes?: number;
+}
 /** V2-neutral active editor facade exposed by legacy shell methods. */
 export interface EditorCommands {
     search?: (text: string | RegExp, options?: Record<string, unknown>) => SearchMatch[];
@@ -2919,6 +2949,7 @@ export interface EditorUpdateEvent {
      * available. Always present (defaults to `null`); may be `null`.
      */
     sectionType: string | null;
+    isRemote: boolean;
 }
 /**
  * Payload emitted with the `ready` event and passed to `Config.onReady`.
@@ -3071,18 +3102,50 @@ export interface SuperDocAwarenessUpdatePayload {
  * `Config.onCommentsUpdate`. Field set differs from older inline
  * declarations: the runtime emits `comment?` and `changes?` (never a
  * `data` field).
+ *
+ * A refused comment mutation emits `rejected: true` with a stable `reason`
+ * (e.g. `'adapter-threw'`, `'receipt-failure'`) and leaves the comment list
+ * unchanged so the user can retry. It may add the document receipt failure
+ * `code` (e.g. `'TARGET_NOT_FOUND'`), a `detail` (an error message or a
+ * structured description of the mismatch), and `committed: true` when the
+ * change reached the document but could not be confirmed in the comment list.
  */
 export interface SuperDocCommentsUpdatePayload {
-    /** Update kind (e.g. `'created'`, `'updated'`, `'deleted'`); set by the comments store. */
+    /** Update kind (e.g. `'add'`, `'update'`, `'deleted'`, `'resolved'`, `'pending'`); set by the comments store. */
     type: string;
-    /** The comment object the update refers to, when applicable. */
-    comment?: Comment;
-    /** Per-field change set when the update is a mutation. */
+    /** The comment object the update refers to, when applicable; `null` when a created comment could not be read back. */
+    comment?: Comment | null;
+    /** Per-field change set: `'deleted'` names the comment; `text`, `isInternal`, `resolvedTime` carry `value` (check its type, not just `key`). */
     changes?: Array<{
         key: string;
         commentId: string;
         fileId?: string | null;
+        value?: undefined;
+        previousValue?: undefined;
+    } | {
+        key: 'text';
+        value: string;
+        commentId?: undefined;
+        fileId?: undefined;
+        previousValue?: undefined;
+    } | {
+        key: 'isInternal';
+        value: boolean;
+        previousValue: boolean;
+        commentId?: undefined;
+        fileId?: undefined;
+    } | {
+        key: 'resolvedTime';
+        value: null;
+        commentId?: undefined;
+        fileId?: undefined;
+        previousValue?: undefined;
     }>;
+    rejected?: true;
+    reason?: string;
+    committed?: true;
+    code?: string;
+    detail?: unknown;
     /**
      * The Document API selection snapshot captured at the moment a
      * `'pending'` comment was started, before the pending mark is
@@ -3145,19 +3208,7 @@ export interface EditorTransactionEvent {
     /** Header/footer variant (`default`, `first`, `even`, `odd`) when available. */
     sectionType?: string | null;
 }
-/** A content control reported by an Editor interaction callback. */
-export interface ContentControlRef {
-    /** Content-control id from the DOCX. */
-    id: string;
-    /** Content-control tag, when the DOCX defines one. */
-    tag?: string;
-    /** Display name from the DOCX, when defined. */
-    alias?: string;
-    /** Content-control type, such as `text`, `checkbox`, or `date`. */
-    controlType: ContentControlType;
-    /** Whether the control is inline or contains one or more blocks. */
-    scope: 'inline' | 'block';
-}
+export type { ContentControlRef } from '../../public/content-control-ref.js';
 /**
  * Previous content-control reference shape.
  * @deprecated replaceWith=`ContentControlRef` compat-indefinitely=v2 event payload compatibility
@@ -3183,13 +3234,7 @@ export interface ContentControlActiveChangePayload {
     /** Reported source of the selection change. */
     source: 'keyboard' | 'pointer';
 }
-/** Details reported when someone clicks inside a content control. */
-export interface ContentControlClickPayload {
-    /** Innermost clicked content control. */
-    target: ContentControlRef;
-    /** Content-control clicks always originate from a pointer. */
-    source: 'pointer';
-}
+export type { ContentControlClickPayload } from '../../public/content-control-ref.js';
 export interface SuperDocLayoutEngineOptions {
     /**
      * Layout engine flow mode.
@@ -3848,6 +3893,37 @@ export interface TrackChangesInteractionConfig {
      */
     allowDecisions?: boolean;
 }
+/** Native keyboard writing assistance requested from the device keyboard. */
+export interface WritingAssistanceConfig {
+    /** Let the keyboard apply autocorrect and predictive replacements (default: false). */
+    autocorrect?: boolean;
+    /** Keyboard auto-capitalization mode (default: 'off'). */
+    autocapitalize?: 'off' | 'sentences' | 'words' | 'characters';
+    /** Let the keyboard underline and suggest spelling fixes (default: false). */
+    spellcheck?: boolean;
+}
+/**
+ * Opt-in touch behavior for this Editor. Every field defaults to off, and
+ * omitted or `false` values keep the existing touch behavior unchanged.
+ * Mouse, pen and keyboard input are never affected.
+ */
+export interface TouchInteractionConfig {
+    /**
+     * Opt in to SuperDoc-owned touch gestures (default: false).
+     *
+     * When enabled, a stationary touch hold on document content opens the
+     * existing SuperDoc context menu when the finger lifts, with the same caret
+     * and selection rules as a right-click. The lift does not activate content
+     * underneath. Where the browser shows its own text-selection menu for the
+     * hold (iOS Safari), it is dismissed once the SuperDoc menu opens and the
+     * held word stays selected in SuperDoc; where the browser reports the hold
+     * as a context-menu event (Android Chrome), the existing right-click path
+     * opens the menu once. A hold during IME composition does nothing. Taps and
+     * swipes keep their existing behavior. Hosts that disable the context menu,
+     * and viewing mode, keep native behavior. Read when the editor mounts.
+     */
+    gestures?: boolean;
+}
 /**
  * Controls which interactions this Editor allows, independent of what
  * SuperDoc renders.
@@ -3860,6 +3936,10 @@ export interface InteractionConfig {
     comments?: CommentInteractionConfig;
     /** Tracked-change interaction policy. */
     trackedChanges?: TrackChangesInteractionConfig;
+    /** Opt-in touch behavior. Omitted fields keep the existing behavior. */
+    touch?: TouchInteractionConfig;
+    /** Native keyboard writing assistance. Everything is off when omitted. */
+    writingAssistance?: WritingAssistanceConfig;
 }
 /**
  * Shared plumbing for dialogs and floating overlays, including surfaces the
@@ -3904,16 +3984,25 @@ export interface SurfacesConfig {
     };
 }
 /**
- * Browser worker asset URLs for deployments where application code and built
- * SuperDoc assets are served from different origins. Each URL must resolve to
- * a same-origin module worker served by the embedding application.
+ * Worker URLs accepted by v2. The editor runs on the page and starts no
+ * document worker, so only `collaboration` is used, and only by collaboration
+ * targets with `providerType: 'extension'`.
  */
 interface V2WorkerUrlsConfig {
-    /** Main document worker used by non-collaborative v2 documents. */
+    /**
+     * @deprecated The editor runs on the page and starts no document worker.
+     * Accepted and ignored for configuration compatibility.
+     */
     document?: string | URL;
-    /** Collaboration-capable document worker used by v2 collaboration rooms. */
+    /**
+     * Your provider-extension collaboration worker, built with
+     * `bootstrapSuperDocCollaborationWorker` from the same SuperDoc version.
+     * Must be a same-origin module worker URL. Required for
+     * `providerType: 'extension'`; ignored by the built-in providers, which
+     * sync on the page.
+     */
     collaboration?: string | URL;
-    /** @deprecated Review processing runs in the document worker. Accepted for configuration compatibility. */
+    /** @deprecated Accepted and ignored for configuration compatibility. */
     reviewIndex?: string | URL;
 }
 export interface Config {
@@ -4139,12 +4228,25 @@ export interface Config {
     onReady?: (params: SuperDocReadyPayload) => void;
     /** Callback when comments are updated. */
     onCommentsUpdate?: (params: SuperDocCommentsUpdatePayload) => void;
+    /**
+     * Called when someone accepts a tracked change from its bubble in the comments sidebar.
+     * Receives the tracked-change comment and the active editor. In SuperDoc 2 it runs after the accept is applied.
+     */
+    onTrackedChangeBubbleAccept?: (comment: Comment, editor: Editor | null) => void;
+    /**
+     * Called when someone rejects a tracked change from its bubble in the comments sidebar.
+     * Receives the tracked-change comment and the active editor. In SuperDoc 2 it runs after the reject is applied.
+     */
+    onTrackedChangeBubbleReject?: (comment: Comment, editor: Editor | null) => void;
     /**
      * Callback when the selection enters, leaves, or moves between content controls.
      * @deprecated replaceWith=`superdoc.ui.contentControls.observe` compat-indefinitely=v2 event compatibility
      */
     onContentControlActiveChange?: (params: ContentControlActiveChangePayload) => void;
-    /** Callback when someone clicks inside a content control. */
+    /**
+     * Callback when someone clicks inside a content control.
+     * @deprecated replaceWith=`superdoc.ui.contentControls.onClick` removeIn=v3.0
+     */
     onContentControlClick?: (params: ContentControlClickPayload) => void;
     /** Callback when awareness is updated. */
     onAwarenessUpdate?: (params: SuperDocAwarenessUpdatePayload) => void;
@@ -4199,6 +4301,8 @@ export interface Config {
      * Callback when the zoom level changes. Fires for every zoom source:
      * `setZoom()`, the toolbar zoom control, and fit-width
      * adjustments.
+     *
+     * @deprecated replaceWith=`superdoc.ui.zoom.observe` removeIn=v3.0
      */
     onZoomChange?: (params: SuperDocZoomPayload) => void;
     /**
@@ -4371,22 +4475,22 @@ export interface Config {
      */
     fonts?: FontsConfig;
     /**
-     * Optional same-origin URLs for v2's browser worker assets. Configure these
-     * when the application and SuperDoc bundle are served from different origins.
-     * Omitted entries keep SuperDoc's bundled worker URLs.
+     * Worker URLs. Only `collaboration` is used: the provider-extension
+     * collaboration worker for `providerType: 'extension'`. `document` and
+     * `reviewIndex` are accepted and ignored because the editor runs on the page.
      */
     workerUrls?: V2WorkerUrlsConfig;
     /**
-     * Budget for the document worker to start up, in milliseconds
-     * (default: 30000). Measured from worker spawn, so it covers script
-     * download, parsing, evaluation, and the worker's first response to
-     * SuperDoc. Raise it when a large worker chunk is served
-     * over a slow connection or a cold dev-server cache; lower it to fail faster.
-     * Worker load errors are reported immediately and do not wait for this
-     * budget. Must be a finite positive number no greater than 2147483647, the
-     * platform timer ceiling above which a delay would fire immediately.
+     * Budget for the provider-extension collaboration worker
+     * (`workerUrls.collaboration`, `providerType: 'extension'`) to start up and
+     * send its first response, in milliseconds. Defaults to the collaboration
+     * `syncTimeoutMs`, or 30000. Worker load errors are reported immediately and
+     * do not wait for this budget. Ignored by the built-in providers and by
+     * documents opened without collaboration, which start no worker.
      */
     workerStartupTimeoutMs?: number;
+    /** Retention of attributed change records read through `activeEditor.doc.changes`. */
+    changes?: ChangesConfig;
     /**
      * Whether `layoutEngineOptions` are passed when a DOCX editor opens.
      *

package/dist/superdoc/src/core/v2-integration/browser-peer-runtime.d.ts

@@ -1,3 +1,5 @@
-export function readSuperDocV2BrowserRuntime(globalObject?: typeof globalThis): any;
-export function installSuperDocV2BrowserRuntime(runtime?: {}, globalObject?: typeof globalThis): any;
-export const SUPERDOC_V2_BROWSER_RUNTIME_GLOBAL_KEY: "__SUPERDOC_V2_BROWSER_RUNTIME__";
+export declare const SUPERDOC_V2_BROWSER_RUNTIME_GLOBAL_KEY = "__SUPERDOC_V2_BROWSER_RUNTIME__";
+type SuperDocV2BrowserRuntime = Record<string, unknown>;
+export declare function readSuperDocV2BrowserRuntime(globalObject?: object): SuperDocV2BrowserRuntime | null;
+export declare function installSuperDocV2BrowserRuntime(runtime?: SuperDocV2BrowserRuntime, globalObject?: object): SuperDocV2BrowserRuntime;
+export {};

package/dist/superdoc/src/core/v2-integration/cdn-engine-loader.d.ts

@@ -1,16 +1,6 @@
-/**
- * @param {typeof globalThis} globalObject
- * @param {string} engineVersion
- * @param {string | null} buildOverride
- */
-export function resolveDocxEngineCdnBaseUrl(globalObject: typeof globalThis, engineVersion: string, buildOverride?: string | null): any;
-/** @param {{ engineVersion: string, buildBaseUrl: string | null }} options */
-export function configureCdnEngineLoader({ engineVersion, buildBaseUrl }: {
+export declare function resolveDocxEngineCdnBaseUrl(globalObject: object, engineVersion: string, buildOverride?: string | null): string;
+export declare function configureCdnEngineLoader({ engineVersion, buildBaseUrl, }: {
     engineVersion: string;
     buildBaseUrl: string | null;
 }): void;
-/**
- * @param {string} url
- * @returns {Promise<void>}
- */
-export function loadStylesheetOnce(url: string): Promise<void>;
+export declare function loadStylesheetOnce(url: string): Promise<void>;