superdoc 2.2.1 → 2.3.0

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

@@ -0,0 +1,66 @@
+/**
+ * @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;
+};
+export type PDFJSConfig = {
+    pdfLib: any;
+    workerSrc?: string | undefined;
+    setWorker?: boolean | undefined;
+};
+export type RenderPagesOptions = {
+    documentId: string;
+    pdfDocument: PDFDocumentProxy;
+    viewerContainer: HTMLElement;
+    emit?: ((arg0: string, ...arg1: any[]) => void) | undefined;
+};
+export type PageSize = {
+    width: number;
+    height: number;
+};
+/**
+ * @abstract
+ */
+declare class PDFAdapter {
+}
+export {};

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

@@ -0,0 +1,90 @@
+/**
+ * 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 = {
+    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'
+     */
+    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;
+};

package/dist/superdoc/src/core/theme/create-theme.d.ts

@@ -0,0 +1,82 @@
+export interface ThemeColors {
+    /** Action/accent color (buttons, links, active states). Default: #1355ff */
+    action?: string;
+    /** Action hover state. Default: #0f44cc */
+    actionHover?: string;
+    /** Text color on action-colored buttons. Default: #ffffff */
+    actionText?: string;
+    /** Default background for panels, cards, dropdowns. Default: #ffffff */
+    bg?: string;
+    /** Hover background. Default: #dbdbdb */
+    hoverBg?: string;
+    /** Active/pressed background. Default: #c8d0d8 */
+    activeBg?: string;
+    /** Disabled background. Default: #f5f5f5 */
+    disabledBg?: string;
+    /** Primary text color. Default: #47484a */
+    text?: string;
+    /** Secondary/muted text. Default: #666666 */
+    textMuted?: string;
+    /** Disabled text. Default: #ababab */
+    textDisabled?: string;
+    /** Default border color. Default: #dbdbdb */
+    border?: string;
+}
+export interface ThemeConfig {
+    /** Theme name — used in the generated class name (e.g., "dark" → "sd-theme-dark") */
+    name?: string;
+    /** UI font family */
+    font?: string;
+    /** Default border radius (e.g., "8px") */
+    radius?: string;
+    /** Default box shadow */
+    shadow?: string;
+    /** Core color palette — cascades to every component */
+    colors?: ThemeColors;
+    /** Escape hatch — raw CSS variable overrides (e.g., { '--sd-ui-toolbar-bg': '#f8fafc' }) */
+    vars?: Record<string, string | null | undefined>;
+}
+export interface ThemeResult {
+    className: string;
+    css: string;
+}
+/**
+ * Create a SuperDoc theme from a config object.
+ *
+ * Returns a CSS class name. Apply it to `<html>` to activate the theme.
+ * The style element is injected into the document automatically.
+ *
+ * For strict CSP environments that require a nonce, use {@link buildTheme} instead
+ * and inject the CSS yourself with the appropriate nonce attribute.
+ *
+ * @example
+ * ```ts
+ * import { createTheme } from 'superdoc';
+ *
+ * const theme = createTheme({
+ *   colors: { action: '#6366f1', bg: '#ffffff', text: '#1e293b' },
+ *   font: 'Inter, sans-serif',
+ *   vars: { '--sd-ui-toolbar-bg': '#f8fafc' },
+ * });
+ *
+ * document.documentElement.classList.add(theme);
+ * ```
+ */
+export declare function createTheme(config: ThemeConfig): string;
+/**
+ * Build a SuperDoc theme and return both the class name and raw CSS.
+ * Pure function — does NOT inject styles into the DOM. Use this for SSR
+ * or when you need to control style injection yourself (e.g., CSP nonce).
+ *
+ * @example
+ * ```ts
+ * import { buildTheme } from 'superdoc';
+ *
+ * const { className, css } = buildTheme({
+ *   colors: { action: '#6366f1', bg: '#ffffff', text: '#1e293b' },
+ * });
+ *
+ * const html = `<html class="${className}"><head><style>${css}</style></head>...</html>`;
+ * ```
+ */
+export declare function buildTheme(config: ThemeConfig): ThemeResult;