superdoc 2.29.0-next.2 → 2.29.0-next.9

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

@@ -1,45 +1,8 @@
-export function extractBrowserFile(input: File | Blob | UploadWrapper | any, fallbackName?: string): File | Blob | null;
-export function isDocumentByteSource(input: unknown): input is ArrayBuffer | Uint8Array;
-export function documentByteSourceToBlob(input: ArrayBuffer | Uint8Array, type: string): Blob;
-export function normalizeDocumentEntry(entry: File | Blob | UploadWrapper | DocumentEntry | any): DocumentEntry | any;
-export type UploadWrapper = {
-    /**
-     * Underlying file reference used by some uploaders
-     */
-    originFileObj?: File | Blob | undefined;
-    /**
-     * Underlying file reference used by some uploaders
-     */
-    file?: File | Blob | undefined;
-    /**
-     * Underlying file reference used by some uploaders
-     */
-    raw?: File | Blob | undefined;
-    /**
-     * Optional unique id from uploaders (ignored)
-     */
-    uid?: string | number | undefined;
-    /**
-     * Display name (not always reliable for the native file)
-     */
-    name?: string | undefined;
-};
-export type DocumentEntry = {
-    /**
-     * Mime type or shorthand ('docx' | 'pdf' | 'html')
-     */
-    type?: string | undefined;
-    /**
-     * Filename to display
-     */
-    name?: string | undefined;
-    /**
-     * Document data
-     */
-    data?: File | Blob | ArrayBuffer | Uint8Array<ArrayBufferLike> | UploadWrapper | undefined;
-    /**
-     * Remote URL to fetch; left as-is for URL flows
-     */
-    url?: string | undefined;
-    isNewFile?: boolean | undefined;
-};
+import { Document, DocumentSource } from '../types/index.js';
+type BrowserFile = File | Blob;
+type DocumentByteSource = ArrayBuffer | Uint8Array;
+export declare const extractBrowserFile: (input: unknown, fallbackName?: unknown) => BrowserFile | null;
+export declare const isDocumentByteSource: (input: unknown) => input is DocumentByteSource;
+export declare const documentByteSourceToBlob: (input: DocumentByteSource, type: string) => Blob;
+export declare function normalizeDocumentEntry(entry: Exclude<DocumentSource, string>): Document;
+export {};

package/dist/superdoc/src/core/helpers/normalize-track-changes-config.d.ts

@@ -1,60 +1,6 @@
-/**
- * Resolves tracked-change behavior from `config.trackChanges` and viewer
- * projection from `config.viewing.trackedChanges`. The normalized result is
- * mirrored to the previous paths while their internal consumers migrate.
- *
- * Precedence per field: canonical > legacy > derived default.
- *
- * Emits a one-time deprecation warning per legacy key path that was
- * populated by the caller. Suppresses warnings on a second pass over the
- * same config object so write-through values don't look like new legacy
- * usage.
- *
- * @param {Record<string, any>} config  The SuperDoc config object (mutated in place)
- * @returns {NormalizedTrackChangesConfig}
- */
-export function normalizeTrackChangesConfig(config: Record<string, any>): NormalizedTrackChangesConfig;
-/**
- * Test-only hook: clears the deduplicated deprecation-warning set so
- * tests can assert the warning fires on the first invocation.
- */
-export function __resetDeprecationWarnings(): void;
-export type TrackChangesMode = "review" | "original" | "final" | "off";
-export type ViewingTrackedChangesMode = "original" | "markup" | "final";
-export type TrackChangesReplacementMode = "grouped" | "separate";
-export type InternalTrackChangesReplacementMode = "paired" | "independent";
-export type AuthorColorsConfig = {
-    enabled?: boolean;
-    overrides?: Record<string, string>;
-    resolve?: (author: {
-        name?: string;
-        email?: string;
-        image?: string;
-    }) => (string | undefined);
-};
-export type TrackedChangeSemanticColorKey = import('../types/index.js').TrackedChangeSemanticColorKey;
-export type SemanticColorResolverInput = {
-    key: TrackedChangeSemanticColorKey;
-    author?: {
-        name?: string;
-        email?: string;
-        image?: string;
-    };
-    type?: string;
-    subtype?: string;
-    targetKind?: string;
-    semanticAnchorScope?: string;
-};
-export type SemanticColorsConfig = {
-    enabled?: boolean;
-    overrides?: Partial<Record<TrackedChangeSemanticColorKey, string>>;
-    resolve?: (input: SemanticColorResolverInput) => (string | undefined);
-};
-export type NormalizedTrackChangesConfig = {
-    visible: boolean;
-    mode: TrackChangesMode;
-    enabled: boolean;
-    replacements: InternalTrackChangesReplacementMode;
-    authorColors?: AuthorColorsConfig;
-    semanticColors?: SemanticColorsConfig;
-};
+import { Config, TrackChangesModuleConfig } from '../types/index.js';
+type TrackChangesConfigSource = Pick<Config, 'documentMode' | 'viewing' | 'modules' | 'trackChanges' | 'layoutEngineOptions' | 'comments'>;
+type NormalizedTrackChangesConfig = Required<Pick<TrackChangesModuleConfig, 'visible' | 'mode' | 'enabled' | 'replacements'>> & Pick<TrackChangesModuleConfig, 'authorColors' | 'semanticColors'>;
+export declare function normalizeTrackChangesConfig(config: TrackChangesConfigSource): NormalizedTrackChangesConfig;
+export declare function __resetDeprecationWarnings(): void;
+export {};

package/dist/superdoc/src/core/pdf/helpers/constants.d.ts

@@ -1,2 +1,2 @@
-export const OUTPUT_SCALE: 2;
-export const PDF_TO_CSS_UNITS: number;
+export declare const OUTPUT_SCALE = 2;
+export declare const PDF_TO_CSS_UNITS: number;

package/dist/superdoc/src/core/pdf/helpers/floor.d.ts

@@ -1 +1 @@
-export function floor(val: any, precision: any): number;
+export declare const floor: (val: number, precision?: number) => number;

package/dist/superdoc/src/core/pdf/helpers/range.d.ts

@@ -1 +1 @@
-export function range(start: any, end: any): any[];
+export declare const range: (start: number, end: number) => number[];

package/dist/superdoc/src/core/pdf/helpers/read-file.d.ts

@@ -1 +1 @@
-export function readFileAsArrayBuffer(blob: any): Promise<any>;
+export declare const readFileAsArrayBuffer: (blob: Blob) => Promise<ArrayBuffer>;

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

@@ -1,66 +1,29 @@
-/**
- * @param {number} version
- * @returns {string}
- */
-export function getWorkerSrcFromCDN(version: number): string;
-export function createPDFConfig(config?: Partial<PDFConfig>): PDFConfig;
-export class PDFJSAdapter extends PDFAdapter {
-    /**
-     * @param {PDFJSConfig} config
-     */
-    constructor(config: PDFJSConfig);
-    pdfLib: any;
-    workerSrc: string | undefined;
-    /**
-     * @param {string | ArrayBuffer | Uint8Array} file
-     * @returns {Promise<PDFDocumentProxy>}
-     */
-    getDocument(file: string | ArrayBuffer | Uint8Array): Promise<PDFDocumentProxy>;
-    /**
-     * @param {PDFDocumentProxy} pdf
-     * @param {number} firstPage
-     * @param {number} lastPage
-     * @returns {Promise<PDFPageProxy[]>}
-     */
-    getPages(pdf: PDFDocumentProxy, firstPage: number, lastPage: number): Promise<PDFPageProxy[]>;
-}
-export class PDFAdapterFactory {
-    /**
-     * @param {PDFJSConfig & {adapter: AdapterType}} config
-     * @returns {PDFAdapter}
-     * @throws {Error}
-     */
-    static create(config: PDFJSConfig & {
-        adapter: AdapterType;
-    }): PDFAdapter;
-}
-export type PDFDocumentProxy = import('pdfjs-dist').PDFDocumentProxy;
-export type PDFPageProxy = import('pdfjs-dist').PDFPageProxy;
-export type AdapterType = "pdfjs";
-export type PDFConfig = {
-    adapter: AdapterType;
-    pdfLib?: any;
-    workerSrc?: string | undefined;
-    setWorker?: boolean | undefined;
-};
+import { PDFDocumentProxy, PDFPageProxy } from 'pdfjs-dist';
+import type * as PdfJs from 'pdfjs-dist';
+export type AdapterType = 'pdfjs';
+export type PdfJsLib = Pick<typeof PdfJs, 'getDocument' | 'GlobalWorkerOptions' | 'version'>;
+export type PdfSource = NonNullable<Parameters<PdfJsLib['getDocument']>[0]>;
 export type PDFJSConfig = {
-    pdfLib: any;
-    workerSrc?: string | undefined;
-    setWorker?: boolean | undefined;
+    pdfLib?: object;
+    workerSrc?: string;
+    setWorker?: boolean;
 };
-export type RenderPagesOptions = {
-    documentId: string;
-    pdfDocument: PDFDocumentProxy;
-    viewerContainer: HTMLElement;
-    emit?: ((arg0: string, ...arg1: any[]) => void) | undefined;
-};
-export type PageSize = {
-    width: number;
-    height: number;
+export type PDFConfig = PDFJSConfig & {
+    adapter: AdapterType;
 };
-/**
- * @abstract
- */
-declare class PDFAdapter {
+export declare const createPDFConfig: (config?: Partial<PDFConfig>) => PDFConfig;
+declare abstract class PDFAdapter {
+    constructor();
+}
+export declare class PDFJSAdapter extends PDFAdapter {
+    pdfLib: object | undefined;
+    workerSrc: string | undefined;
+    constructor(config: PDFJSConfig);
+    getDocument(file: PdfSource): Promise<PDFDocumentProxy>;
+    getPages(pdf: PDFDocumentProxy, firstPage: number, lastPage: number): Promise<PDFPageProxy[]>;
+}
+export declare class PDFAdapterFactory {
+    static create(config: PDFConfig): PDFJSAdapter;
 }
+export declare function getWorkerSrcFromCDN(version: string): string;
 export {};

package/dist/superdoc/src/core/superdoc-ui-owner.d.ts

@@ -1 +1 @@
-export function getSuperDocUiOwnerId(superdoc: any): any;
+export declare function getSuperDocUiOwnerId(superdoc: unknown): string | null;

package/dist/superdoc/src/core/surface-manager.d.ts

@@ -1,90 +1,28 @@
-/**
- * SurfaceManager — a plain JavaScript class that owns surface lifecycle state.
- *
- * NOT a Pinia store. Lives on the SuperDoc instance and survives runtime
- * restarts (collaboration upgrades). Vue components observe the reactive
- * refs (`activeDialog`, `activeFloating`) via provide/inject.
- */
-export class SurfaceManager {
-    /**
-     * @param {{ getModuleConfig: () => SurfacesModuleConfig | undefined }} options
-     */
-    constructor({ getModuleConfig }: {
-        getModuleConfig: () => SurfacesModuleConfig | undefined;
-    });
-    /** @type {import('vue').ShallowRef<ActiveSurface | null>} */
-    activeDialog: import('vue').ShallowRef<ActiveSurface | null>;
-    /** @type {import('vue').ShallowRef<ActiveSurface | null>} */
-    activeFloating: import('vue').ShallowRef<ActiveSurface | null>;
-    /**
-     * Open a surface. Returns a handle with a result promise that always resolves.
-     *
-     * Throws synchronously on API misuse (bad request shape, unresolvable intent).
-     * Normal lifecycle events (close, replace, destroy) resolve through the handle.
-     *
-     * @template [TResult=unknown]
-     * @param {SurfaceRequest} rawRequest
-     * @returns {SurfaceHandle<TResult>}
-     */
-    open<TResult = unknown>(rawRequest: SurfaceRequest): SurfaceHandle<TResult>;
-    /**
-     * Close a surface by id, or the topmost surface if no id is given.
-     * @param {string} [id]
-     * @param {unknown} [reason]
-     */
-    close(id?: string, reason?: unknown): void;
-    /**
-     * Settle all active surfaces with the given outcome.
-     * Used by SuperDoc during runtime restart and destroy.
-     * @param {SurfaceOutcome} outcome
-     */
-    settleAll(outcome: SurfaceOutcome): void;
-    /**
-     * Permanently shut down the manager. All active surfaces are settled with
-     * { status: 'destroyed' }. Future open() calls return destroyed handles.
-     */
-    destroy(): void;
-    #private;
-}
-export type SurfaceMode = import('./types/index.js').SurfaceMode;
-export type SurfaceRequest = import('./types/index.js').SurfaceRequest;
-export type SurfaceResolution = import('./types/index.js').SurfaceResolution;
-export type SurfaceHandle = import('./types/index.js').SurfaceHandle;
-export type SurfaceOutcome = import('./types/index.js').SurfaceOutcome;
-export type SurfacesModuleConfig = import('./types/index.js').SurfacesModuleConfig;
-export type ExternalSurfaceRenderContext = import('./types/index.js').ExternalSurfaceRenderContext;
-export type ActiveSurface = {
+import { ShallowRef } from 'vue';
+import { DirectSurfaceRequest, SurfaceHandle, SurfaceMode, SurfaceOutcome, SurfaceRequest, SurfacesModuleConfig } from './types/index.js';
+type SurfaceRender = NonNullable<DirectSurfaceRequest['render']>;
+export interface ActiveSurface {
     id: string;
     mode: SurfaceMode;
     request: SurfaceRequest;
-    /**
-     * Resolved Vue component
-     */
     component?: unknown;
-    /**
-     * Extra props for the Vue component
-     */
-    props?: Record<string, unknown> | undefined;
-    /**
-     * External renderer
-     */
-    render?: ((ctx: ExternalSurfaceRenderContext) => ({
-        destroy?: () => void;
-    } | void)) | undefined;
-    /**
-     * Content-facing: settle with 'submitted'
-     */
+    props?: Record<string, unknown>;
+    render?: SurfaceRender;
     resolve: (data?: unknown) => void;
-    /**
-     * Content-facing: settle with 'closed' and clear slot
-     */
     close: (reason?: unknown) => void;
-    /**
-     * Settle the handle promise (internal)
-     */
     settle: (outcome: SurfaceOutcome) => boolean;
-    /**
-     * Whether the handle has already been settled
-     */
-    settled: boolean;
-};
+    readonly settled: boolean;
+}
+export declare class SurfaceManager {
+    #private;
+    activeDialog: ShallowRef<ActiveSurface | null>;
+    activeFloating: ShallowRef<ActiveSurface | null>;
+    constructor({ getModuleConfig }: {
+        getModuleConfig: () => SurfacesModuleConfig | undefined;
+    });
+    open(rawRequest: SurfaceRequest): SurfaceHandle;
+    close(id?: string, reason?: unknown): void;
+    settleAll(outcome: SurfaceOutcome): void;
+    destroy(): void;
+}
+export {};

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

@@ -9,7 +9,7 @@ import { SuperDoc as SuperDocClass } from '../SuperDoc.js';
 import { SuperDocActiveEditorExtensions, SuperDocExtension } from '../extensions/index.js';
 import { BrowserDocumentApi } from '../../public/browser-document-api.js';
 import { CustomCommandContext, FontFamilyOption as ToolbarFontFamilyOption } from '../../public/ui/types.js';
-export type { DocumentFontOption, FontAssetUrlContext, FontAssetUrlResolver, FontFaceSlot, FontFamilyOption, FontLoadResult, FontLoadStatus, FontLoadSummary, FontResolutionReason, FontResolutionRecord, GlyphException, ResolvedFontEvidence, SubstitutePolicyAction, SubstituteVerdict, } from '../../../../shared/font-system/src/index.js';
+export type { DocumentFontOption, FontFamilyOption, FontLoadSummary, FontResolutionRecord, } from '../../../../shared/font-system/src/index.js';
 export type SuperDoc = SuperDocClass;
 export type { BrowserDocumentApi } from '../../public/browser-document-api.js';
 export type { CommentsType, ExportParams, ExportType } from '../../public/export-types.js';
@@ -1099,9 +1099,7 @@ export interface RuntimeDocument extends Document {
      * created one. Set by the editor-create lifecycle.
      *
      * @deprecated Direct editor access will be removed in a future version.
-     * Use the Document API (`editor.doc`) instead. This typedef carries the
-     * deprecation marker forward from the source accessor in
-     * `packages/superdoc/src/composables/use-document.js`.
+     * Use the Document API (`editor.doc`) instead.
      */
     getEditor?: () => Editor | null | undefined;
     /**
@@ -2882,7 +2880,7 @@ export type DocumentMode = 'editing' | 'viewing' | 'suggesting';
  * - 'print': Print Layout View — displays document as it prints (default)
  * - 'web': Web Page View — content reflows to fit container (mobile/accessibility)
  */
-export type ViewLayout = 'print' | 'web';
+type ViewLayout = 'print' | 'web';
 /**
  * Document view options for controlling how the document is displayed.
  * Mirrors OOXML document view settings.
@@ -3102,7 +3100,7 @@ export interface SuperDocCommentsUpdatePayload {
      */
     pendingSelection?: SelectionInfo | null;
 }
-export interface EditorTransactionLike {
+interface EditorTransactionLike {
     readonly docChanged?: boolean;
     readonly doc?: {
         readonly content?: {
@@ -4480,19 +4478,6 @@ export interface InternalConfig extends Config {
     /** Normalized to `{}` by `#init` if the consumer passes nothing or `undefined`. */
     layoutEngineOptions: SuperDocLayoutEngineOptions;
 }
-/**
- * Internal augmentation of `SuperDocLayoutEngineOptions` for unstable tuning
- * fields. The public `SuperDocLayoutEngineOptions` interface above is the
- * customer-facing contract; this type adds fields the implementation may
- * read but that are intentionally not part of the v1 stable API.
- */
-export interface InternalSuperDocLayoutEngineOptions extends SuperDocLayoutEngineOptions {
-    /**
-     * Internal-only semantic mode tuning options. Shape may change without
-     * notice; not part of the public surface.
-     */
-    semanticOptions?: object;
-}
 export type ProofingStatus = 'idle' | 'checking' | 'disabled' | 'degraded';
 export interface ProofingError {
     kind: 'provider-error' | 'validation-error' | 'timeout';

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

@@ -12,7 +12,7 @@ export interface V2GeometryPayload {
     mount?: unknown;
 }
 export type V2CommittedPageWindow = Readonly<Record<string, unknown>>;
-export interface V2GeometryPublisherOptions {
+interface V2GeometryPublisherOptions {
     getLayersContainer: () => HTMLElement | null;
     isCommentsEnabled: () => boolean;
     publishPositions: (positions: Record<string, unknown>, options?: V2GeometryPublishOptions) => void;
@@ -20,7 +20,7 @@ export interface V2GeometryPublisherOptions {
     readCurrentPositions?: () => Record<string, unknown>;
     setGeometryAvailable?: (value: boolean) => void;
 }
-export interface V2GeometryPublisher {
+interface V2GeometryPublisher {
     publish(payload: V2GeometryPayload | null, options?: V2GeometryPublishOptions): Promise<void> | void;
     recollect(options?: V2GeometryPublishOptions): Promise<void> | void;
     noteCommittedPageWindow?(window: V2CommittedPageWindow | null | undefined): void;
@@ -28,7 +28,7 @@ export interface V2GeometryPublisher {
     getLastEpoch(): number | null;
     getLastPayload(): V2GeometryPayload | null;
 }
-export interface V2ReviewWindowContext {
+interface V2ReviewWindowContext {
     superdoc: unknown;
     documentId: string;
     commentsAdapter: unknown;
@@ -36,7 +36,7 @@ export interface V2ReviewWindowContext {
     resolveReviewWindow: (input: unknown) => unknown;
     moveFragmentWordIds: (ids: readonly string[]) => unknown;
 }
-export interface V2ReviewWindowResult {
+interface V2ReviewWindowResult {
     comments?: {
         items?: readonly unknown[];
         requestedIds?: readonly string[];
@@ -49,20 +49,20 @@ export interface V2ReviewWindowResult {
     };
     preparedReview?: unknown;
 }
-export interface V2ReviewWindowControllerOptions {
+interface V2ReviewWindowControllerOptions {
     applyReviewWindow?: ((context: V2ReviewWindowContext, result: V2ReviewWindowResult) => unknown) | null;
 }
-export interface V2ReviewMutationSettlement {
+interface V2ReviewMutationSettlement {
     outcome: 'aborted' | 'rejected' | 'committed';
     allResolved?: boolean;
     resumeDomains?: readonly ('comments' | 'trackedChanges')[];
     trackedRowCount?: number | null;
 }
-export interface V2ReviewWindowSnapshot {
+interface V2ReviewWindowSnapshot {
     readonly status: 'pending' | 'ready' | 'stale';
     readonly [field: string]: unknown;
 }
-export interface V2ReviewWindowDiagnostics {
+interface V2ReviewWindowDiagnostics {
     generation: number;
     reviewEpoch: number;
     hasContext: boolean;
@@ -71,7 +71,7 @@ export interface V2ReviewWindowDiagnostics {
     mutationPaused: boolean;
     records: readonly Record<string, unknown>[];
 }
-export interface V2ReviewWindowController {
+interface V2ReviewWindowController {
     setContext(context: V2ReviewWindowContext | null): void;
     onCommittedPagePaint?(commit: V2CommittedPageWindow): void;
     refreshCommittedWindow(reason?: string): void;
@@ -85,7 +85,7 @@ export interface V2ReviewWindowController {
     subscribe?(listener: (snapshot: V2ReviewWindowSnapshot) => void): () => void;
     getDiagnostics(): V2ReviewWindowDiagnostics | null;
 }
-export interface SuperDocV2Integration {
+interface SuperDocV2Integration {
     version: number;
     capabilities: unknown;
     EditorComponent: Component;