superdoc 2.18.1-next.5 → 2.19.0-next.2

package/dist/superdoc/src/components/surfaces/WatermarkSurface.vue.d.ts

@@ -0,0 +1,16 @@
+import { WatermarkDialogModel } from '../../public/ui/watermark-dialog-state.js';
+type __VLS_Props = {
+    model: WatermarkDialogModel;
+    surfaceId?: string;
+    mode?: string;
+    request?: object;
+    resolve?: (value?: unknown) => void;
+    close?: (reason?: string) => void;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    close: (reason?: string) => void;
+    surfaceId: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    fileInput: HTMLInputElement;
+}, HTMLFormElement>;
+export default _default;

package/dist/superdoc/src/components/surfaces/watermark-surface-runtime.d.ts

@@ -0,0 +1,8 @@
+/** The runtime owns its Vue component; consumers only need the surface request value. */
+export function createWatermarkSurfaceRuntime(getContainer?: () => HTMLElement | null): {
+  component: unknown;
+  captureFocusReturn(): (isCurrent: () => boolean) => Promise<void>;
+  mount(): void;
+  announce(message: string): void;
+  destroy(): void;
+};

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

@@ -149,15 +149,16 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
      * and throw a clear lifecycle error instead.
      */
     users: User[];
-    /** Yjs document for collaboration; set in `#init` when collaboration is enabled, otherwise undefined. */
+    /**
+     * Not set in v2. SuperDoc owns the collaboration `Y.Doc` inside its
+     * collaboration worker and does not expose it on the main thread.
+     */
     ydoc: Y.Doc | undefined;
     /**
-     * Provider for the SuperDoc-level collaboration room (separate from
-     * per-document providers). Widened to `CollaborationProvider` to match
-     * the runtime, which stores whatever provider the consumer passed via
-     * `Config.modules.collaboration.provider`. Consumers needing Hocuspocus-
-     * specific members must narrow before use.
-     *
+     * Collaboration provider facade for the active v2 room. It is not a
+     * provider instance: SuperDoc owns the provider inside its collaboration
+     * worker, and this object only offers `sendStateless(message)`. It is
+     * `undefined` or `null` when no room is open.
      */
     provider: CollaborationProvider | undefined;
     /**

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

@@ -1023,14 +1023,16 @@ export interface Document {
     isNewFile?: boolean;
     /** Password for this encrypted DOCX. Overrides top-level `Config.password`. */
     password?: string;
-    /** The Yjs document for collaboration. */
+    /**
+     * Not set in v2 and cannot be supplied. SuperDoc owns the collaboration
+     * `Y.Doc` inside its worker; configure the room with `collaboration`.
+     */
     ydoc?: YDoc;
     /**
-     * The provider for collaboration. Widened from `HocuspocusProvider` to
-     * `CollaborationProvider` to match the runtime, which stores whatever
-     * provider the consumer passed via `Config.modules.collaboration.provider`
-     * (HocuspocusProvider, LiveblocksYjsProvider, TiptapCollabProvider, etc.).
-     * Consumers needing Hocuspocus-specific members must narrow before use.
+     * Collaboration provider facade for this document's v2 room. It is not a
+     * provider instance and cannot be supplied: SuperDoc owns the provider
+     * inside its collaboration worker, and this object only offers
+     * `sendStateless(message)`. Configure the room with `collaboration`.
      */
     provider?: CollaborationProvider;
     /**
@@ -1143,19 +1145,30 @@ export interface RuntimeDocument extends Document {
      */
     removeComments?: () => void;
 }
-/** Collaboration module configuration. */
+/**
+ * SuperDoc v1 collaboration module configuration.
+ *
+ * SuperDoc v2 rejects this configuration at runtime: it owns the `Y.Doc` and
+ * provider inside its collaboration worker, so it neither attaches an external
+ * `{ ydoc, provider }` pair nor opens the internal provider these fields
+ * describe. Configure a room with `document.collaboration`
+ * (`DocumentCollaborationConfig`) instead. To keep an existing provider setup,
+ * see https://docs.superdoc.dev/editor/collaboration/use-your-own-provider
+ *
+ * @deprecated replaceWith=`DocumentCollaborationConfig` removeIn=v3.0
+ */
 export interface CollaborationConfig {
-    /** External Yjs document (provider-agnostic mode). */
+    /** SuperDoc v1 external Yjs document. Rejected by v2, which owns its `Y.Doc`. */
     ydoc?: YDoc;
-    /** External collaboration provider (provider-agnostic mode). */
+    /** SuperDoc v1 external provider. Rejected by v2, which owns its provider. */
     provider?: CollaborationProvider;
-    /** Internal provider type (deprecated). */
+    /** SuperDoc v1 internal provider type. Use `DocumentCollaborationConfig.providerType`. */
     providerType?: 'hocuspocus' | 'superdoc';
-    /** WebSocket URL for internal provider (deprecated). */
+    /** SuperDoc v1 internal provider URL. Use `DocumentCollaborationConfig` `serverUrl`. */
     url?: string;
-    /** Authentication token for internal provider (deprecated). */
+    /** SuperDoc v1 internal provider token. Use `DocumentCollaborationConfig` `token`. */
     token?: string;
-    /** Additional params for internal provider (deprecated). */
+    /** SuperDoc v1 internal provider params. Use `DocumentCollaborationConfig` `params`. */
     params?: object;
 }
 /**
@@ -2548,7 +2561,12 @@ export interface Modules {
         /** Canvas render scale (quality). */
         outputScale?: number;
     } & Record<string, unknown>;
-    /** Collaboration module configuration. */
+    /**
+     * SuperDoc v1 collaboration module. SuperDoc v2 refuses it at runtime and
+     * attaches nothing; configure `document.collaboration` instead.
+     *
+     * @deprecated replaceWith=`Document.collaboration` removeIn=v3.0
+     */
     collaboration?: CollaborationConfig;
     /**
      * Toolbar module configuration. Pass `true` to configure the toolbar with
@@ -3559,13 +3577,13 @@ export interface SuperDocZoomConfig {
 /** The three regions rendered by the built-in toolbar. */
 export type ToolbarRegion = 'left' | 'center' | 'right';
 /** Built-in controls accepted by `ui.toolbar.items` and `excludeItems`. */
-export type ToolbarItemId = 'undo' | 'redo' | 'track-changes-accept-selection' | 'track-changes-reject-selection' | 'search' | 'zoom' | 'font-family' | 'font-size' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'text-color' | 'highlight-color' | 'link' | 'image' | 'table-of-contents' | 'table' | 'table-actions' | 'text-align' | 'bullet-list' | 'numbered-list' | 'indent-decrease' | 'indent-increase' | 'line-height' | 'linked-style' | 'ruler' | 'measurement-unit' | 'formatting-marks' | 'copy-format' | 'clear-formatting' | 'ai' | 'document-mode';
+export type ToolbarItemId = 'undo' | 'redo' | 'track-changes-accept-selection' | 'track-changes-reject-selection' | 'search' | 'zoom' | 'font-family' | 'font-size' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'text-color' | 'highlight-color' | 'link' | 'image' | 'table-of-contents' | 'watermark' | 'table' | 'table-actions' | 'text-align' | 'bullet-list' | 'numbered-list' | 'indent-decrease' | 'indent-increase' | 'line-height' | 'linked-style' | 'ruler' | 'measurement-unit' | 'formatting-marks' | 'copy-format' | 'clear-formatting' | 'ai' | 'document-mode';
 /** Controls that `includeItems` can add to the default toolbar. */
-export type ToolbarOptionalItemId = 'formatting-marks' | 'table-of-contents';
+export type ToolbarOptionalItemId = 'formatting-marks' | 'table-of-contents' | 'watermark';
 /** Slots whose built-in toolbar icon can be replaced. */
-export type ToolbarIconId = 'undo' | 'redo' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'text-color' | 'link' | 'image' | 'table-of-contents' | 'align-left' | 'align-right' | 'align-center' | 'align-justify' | 'bullet-list' | 'numbered-list' | 'indent-decrease' | 'indent-increase' | 'track-changes-accept-selection' | 'track-changes-reject-selection' | 'document-mode' | 'document-mode-editing' | 'document-mode-suggesting' | 'document-mode-viewing' | 'overflow' | 'ruler' | 'linked-style' | 'highlight-color' | 'ai' | 'table' | 'table-actions' | 'split-cell' | 'merge-cells' | 'insert-row-before' | 'insert-row-after' | 'insert-column-before' | 'insert-column-after' | 'delete-row' | 'delete-column' | 'delete-table' | 'remove-borders' | 'fix-tables' | 'line-height' | 'search' | 'formatting-marks' | 'copy-format' | 'clear-formatting';
+export type ToolbarIconId = 'undo' | 'redo' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'text-color' | 'link' | 'image' | 'table-of-contents' | 'watermark' | 'align-left' | 'align-right' | 'align-center' | 'align-justify' | 'bullet-list' | 'numbered-list' | 'indent-decrease' | 'indent-increase' | 'track-changes-accept-selection' | 'track-changes-reject-selection' | 'document-mode' | 'document-mode-editing' | 'document-mode-suggesting' | 'document-mode-viewing' | 'overflow' | 'ruler' | 'linked-style' | 'highlight-color' | 'ai' | 'table' | 'table-actions' | 'split-cell' | 'merge-cells' | 'insert-row-before' | 'insert-row-after' | 'insert-column-before' | 'insert-column-after' | 'delete-row' | 'delete-column' | 'delete-table' | 'remove-borders' | 'fix-tables' | 'line-height' | 'search' | 'formatting-marks' | 'copy-format' | 'clear-formatting';
 /** Text slots whose built-in label or tooltip can be replaced. */
-export type ToolbarStringId = 'bold' | 'font-family' | 'ai' | 'font-size' | 'italic' | 'underline' | 'highlight-color' | 'strikethrough' | 'text-color' | 'search' | 'link' | 'image' | 'table-of-contents' | 'table' | 'table-actions' | 'insert-row-before' | 'insert-row-after' | 'insert-column-before' | 'insert-column-after' | 'delete-row' | 'delete-column' | 'delete-table' | 'remove-borders' | 'merge-cells' | 'split-cell' | 'fix-tables' | 'text-align' | 'bullet-list' | 'numbered-list' | 'indent-decrease' | 'indent-increase' | 'zoom' | 'measurement-unit' | 'undo' | 'redo' | 'track-changes-accept-selection' | 'track-changes-reject-selection' | 'clear-formatting' | 'copy-format' | 'line-height' | 'linked-style-label' | 'ruler' | 'formatting-marks' | 'linked-style' | 'document-mode-editing' | 'document-mode-suggesting' | 'document-mode-viewing' | 'document-mode-editing-description' | 'document-mode-suggesting-description' | 'document-mode-viewing-description';
+export type ToolbarStringId = 'bold' | 'font-family' | 'ai' | 'font-size' | 'italic' | 'underline' | 'highlight-color' | 'strikethrough' | 'text-color' | 'search' | 'link' | 'image' | 'table-of-contents' | 'watermark' | 'table' | 'table-actions' | 'insert-row-before' | 'insert-row-after' | 'insert-column-before' | 'insert-column-after' | 'delete-row' | 'delete-column' | 'delete-table' | 'remove-borders' | 'merge-cells' | 'split-cell' | 'fix-tables' | 'text-align' | 'bullet-list' | 'numbered-list' | 'indent-decrease' | 'indent-increase' | 'zoom' | 'measurement-unit' | 'undo' | 'redo' | 'track-changes-accept-selection' | 'track-changes-reject-selection' | 'clear-formatting' | 'copy-format' | 'line-height' | 'linked-style-label' | 'ruler' | 'formatting-marks' | 'linked-style' | 'document-mode-editing' | 'document-mode-suggesting' | 'document-mode-viewing' | 'document-mode-editing-description' | 'document-mode-suggesting-description' | 'document-mode-viewing-description';
 /** One selectable option in a custom toolbar dropdown. */
 export interface ToolbarCustomOption {
     /** Stable option identity. Also used as the selected value when `value` is omitted. */

package/dist/superdoc/src/internal/toolbar/built-in/OverflowMenu.vue.d.ts

@@ -8,5 +8,97 @@ declare const _default: import('vue').DefineComponent<{}, {
         readonly toolbarItem?: Record<string, any> | undefined;
         readonly overflowItems?: unknown[] | undefined;
     };
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    dropdown: ({
+        $: import('vue').ComponentInternalInstance;
+        $data: {};
+        $props: Partial<{}> & Omit<{} & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>;
+        $attrs: import('vue').Attrs;
+        $refs: {
+            [x: string]: unknown;
+        } & {
+            triggerRef: HTMLDivElement;
+            menuRef: HTMLDivElement;
+        };
+        $slots: Readonly<{
+            [name: string]: import('vue').Slot<any> | undefined;
+        }>;
+        $root: import('vue').ComponentPublicInstance | null;
+        $parent: import('vue').ComponentPublicInstance | null;
+        $host: Element | null;
+        $emit: (event: string, ...args: any[]) => void;
+        $el: HTMLDivElement;
+        $options: import('vue').ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {
+            focusTrigger: () => void;
+            $emit: (event: "select" | "update:show", ...args: any[]) => void;
+            placement: string;
+            options: unknown[];
+            disabled: boolean;
+            contentStyle: Record<string, any>;
+            show: boolean;
+            menuProps: Function;
+            nodeProps: Function;
+            closeOnEscape: boolean;
+            hasOpenChild: boolean;
+            $props: {
+                readonly placement?: string | undefined;
+                readonly options?: unknown[] | undefined;
+                readonly disabled?: boolean | undefined;
+                readonly contentStyle?: Record<string, any> | undefined;
+                readonly show?: boolean | undefined;
+                readonly menuProps?: Function | undefined;
+                readonly nodeProps?: Function | undefined;
+                readonly closeOnEscape?: boolean | undefined;
+                readonly hasOpenChild?: boolean | undefined;
+            };
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+            beforeCreate?: (() => void) | (() => void)[];
+            created?: (() => void) | (() => void)[];
+            beforeMount?: (() => void) | (() => void)[];
+            mounted?: (() => void) | (() => void)[];
+            beforeUpdate?: (() => void) | (() => void)[];
+            updated?: (() => void) | (() => void)[];
+            activated?: (() => void) | (() => void)[];
+            deactivated?: (() => void) | (() => void)[];
+            beforeDestroy?: (() => void) | (() => void)[];
+            beforeUnmount?: (() => void) | (() => void)[];
+            destroyed?: (() => void) | (() => void)[];
+            unmounted?: (() => void) | (() => void)[];
+            renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import('vue').nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+    } & Readonly<{}> & Omit<Readonly<{}> & Readonly<{}>, "placement" | "options" | "$props" | "$emit" | "disabled" | "contentStyle" | "show" | "menuProps" | "nodeProps" | "closeOnEscape" | "hasOpenChild" | "focusTrigger"> & {
+        focusTrigger: () => void;
+        $emit: (event: "select" | "update:show", ...args: any[]) => void;
+        placement: string;
+        options: unknown[];
+        disabled: boolean;
+        contentStyle: Record<string, any>;
+        show: boolean;
+        menuProps: Function;
+        nodeProps: Function;
+        closeOnEscape: boolean;
+        hasOpenChild: boolean;
+        $props: {
+            readonly placement?: string | undefined;
+            readonly options?: unknown[] | undefined;
+            readonly disabled?: boolean | undefined;
+            readonly contentStyle?: Record<string, any> | undefined;
+            readonly show?: boolean | undefined;
+            readonly menuProps?: Function | undefined;
+            readonly nodeProps?: Function | undefined;
+            readonly closeOnEscape?: boolean | undefined;
+            readonly hasOpenChild?: boolean | undefined;
+        };
+    } & {} & import('vue').ComponentCustomProperties & {} & {
+        $slots: {
+            trigger?(_: {}): any;
+            menu?(_: {}): any;
+        };
+    }) | null;
+}, HTMLDivElement>;
 export default _default;

package/dist/superdoc/src/internal/toolbar/built-in/Toolbar.vue.d.ts

@@ -1,4 +1,6 @@
 declare const _default: import('vue').DefineComponent<{}, {
     $emit: (event: "select" | "toggle" | "command", ...args: any[]) => void;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    toolbarRoot: HTMLDivElement;
+}, HTMLDivElement>;
 export default _default;

package/dist/superdoc/src/internal/toolbar/built-in/ToolbarDropdown.vue.d.ts

@@ -4,6 +4,7 @@ type __VLS_WithTemplateSlots<T, S> = T & (new () => {
     $slots: S;
 });
 declare const __VLS_component: import('vue').DefineComponent<{}, {
+    focusTrigger: () => void;
     $emit: (event: "select" | "update:show", ...args: any[]) => void;
     placement: string;
     options: unknown[];

package/dist/superdoc/src/internal/toolbar/built-in/toolbarIcons.d.ts

@@ -8,6 +8,7 @@ export namespace toolbarIcons {
     export { linkIconSvg as link };
     export { imageIconSvg as image };
     export { tocIconSvg as tableOfContents };
+    export { watermarkIconSvg as watermark };
     export { alignLeftIconSvg as alignLeft };
     export { alignRightIconSvg as alignRight };
     export { alignCenterIconSvg as alignCenter };

package/dist/superdoc/src/internal/toolbar/built-in/toolbarTexts.d.ts

@@ -12,6 +12,7 @@ export namespace toolbarTexts {
     let link: string;
     let image: string;
     let tableOfContents: string;
+    let watermark: string;
     let table: string;
     let tableActions: string;
     let addRowBefore: string;

package/dist/superdoc/src/internal/toolbar/built-in-toolbar.d.ts

@@ -33,6 +33,7 @@ export class BuiltInToolbar extends EventEmitter<string | symbol, any> {
             link: any;
             image: any;
             tableOfContents: any;
+            watermark: any;
             alignLeft: any;
             alignRight: any;
             alignCenter: any;
@@ -113,6 +114,7 @@ export class BuiltInToolbar extends EventEmitter<string | symbol, any> {
             link: string;
             image: string;
             tableOfContents: string;
+            watermark: string;
             table: string;
             tableActions: string;
             addRowBefore: string;
@@ -166,6 +168,7 @@ export class BuiltInToolbar extends EventEmitter<string | symbol, any> {
         customButtons: never[];
         showFormattingMarksButton: boolean;
         showTableOfContentsButton: boolean;
+        showWatermarkButton: boolean;
     };
     toolbarItems: any[];
     overflowItems: any[];

package/dist/superdoc/src/public/ui/types.d.ts

@@ -30,7 +30,7 @@ import { BuiltInCommandId } from './commands.js';
  * (`scripts/ensure-types.cjs` `rewriteDocApiPaths`), so no bare private
  * specifier leaks into the emitted `.d.ts`.
  */
-export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from '../../../../document-api/src/index.js';
+export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, } from '../../../../document-api/src/index.js';
 export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, } from '../../../../document-api/src/index.js';
 export type { ListPresetId } from '../../../../document-api/src/index.js';
 export type { BrowserDocumentApi, PartialBrowserDocumentApi } from '../browser-document-api.js';
@@ -1409,6 +1409,13 @@ export interface ContextMenuHandle {
         y: number;
     }): ViewportContext;
 }
+/** Runtime control for the built-in watermark dialog. */
+export interface WatermarkHandle {
+    /** Open the dialog for the active document, or return an unavailable reason. */
+    open(): WorkflowActionResult;
+    /** Dismiss the dialog. Already submitted changes continue to completion. */
+    close(): void;
+}
 /**
  * Structural shape of the active editor the controller reads. Every member is
  * optional so a non-browser / pre-ready stub still satisfies it. The
@@ -1562,6 +1569,8 @@ export interface SuperDocUI {
     readonly search: SearchController;
     /** Built-in context menu runtime control. */
     readonly contextMenu: ContextMenuHandle;
+    /** Built-in watermark dialog runtime control. */
+    readonly watermark: WatermarkHandle;
     /** Styles surface (read-only catalogue + active paragraph style). */
     readonly styles: StylesHandle;
     /** Format-painter surface (DOM listener coordination). */

package/dist/superdoc/src/public/ui/watermark-controller.d.ts

@@ -0,0 +1,32 @@
+import { RetainedPictureWatermarkInput, WatermarkInput } from '../../../../document-api/src/index.js';
+import { SurfaceHandle, SurfaceRequest } from '../../core/types/index.js';
+import { BrowserDocumentApi } from '../browser-document-api.js';
+import { FontFamilyOption, WatermarkHandle } from './types.js';
+import { WatermarkPreview } from './watermark-dialog-state.js';
+interface WatermarkEditor {
+    doc: Pick<BrowserDocumentApi, 'watermarks' | 'sections'>;
+    host?: {
+        watermarkPreview?(input: {
+            watermark: WatermarkInput | RetainedPictureWatermarkInput;
+            sectionId?: string;
+            expectedRevision?: string;
+        }): Promise<WatermarkPreview>;
+        events?: {
+            subscribe(listener: (event: {
+                type: string;
+            }) => void): () => void;
+        };
+    };
+}
+interface WatermarkControllerOptions {
+    getEditor(): WatermarkEditor | null;
+    getMode(): string | null;
+    getFonts(): readonly FontFamilyOption[];
+    getContainer?(): HTMLElement | null;
+    openSurface: ((request: SurfaceRequest) => SurfaceHandle) | null;
+    announce?(message: string): void;
+}
+export declare function createWatermarkController(options: WatermarkControllerOptions): WatermarkHandle & {
+    destroy(): void;
+};
+export {};

package/dist/superdoc/src/public/ui/watermark-dialog-state.d.ts

@@ -0,0 +1,66 @@
+import { WatermarkPlacement, WatermarkScalePercent } from '../../../../document-api/src/index.js';
+import { FontFamilyOption } from './types.js';
+export interface WatermarkDraft {
+    kind: 'none' | 'text' | 'picture';
+    geometryKind: 'text' | 'picture' | null;
+    text: string;
+    fontFamily: string;
+    fontSize: 'auto' | number;
+    bold: boolean;
+    italic: boolean;
+    color: string;
+    transparency: number;
+    orientation: 'horizontal' | 'diagonal';
+    scalePercent: WatermarkScalePercent;
+    washout: boolean;
+    lockAspectRatio: boolean;
+    pictureName: string;
+    src?: string;
+    sourceWatermarkId?: string;
+    placement?: WatermarkPlacement;
+    widthPt?: number;
+    heightPt?: number;
+    customPlacement: boolean;
+    customOrientation: boolean;
+    customSize: boolean;
+}
+export type WatermarkPageVariant = 'all' | 'default' | 'first' | 'even';
+export interface WatermarkPreview {
+    url: string;
+    width: number;
+    height: number;
+}
+export interface WatermarkDialogSnapshot {
+    phase: 'loading' | 'editing' | 'previewing' | 'applying';
+    draft: WatermarkDraft;
+    sections: {
+        id: string;
+        label: string;
+    }[];
+    sectionId: string | null;
+    variant: WatermarkPageVariant;
+    items: {
+        id: string;
+        label: string;
+        locations: string;
+    }[];
+    selectedIds: string[];
+    fonts: FontFamilyOption[];
+    dirty: boolean;
+    canApply: boolean;
+    error: string | null;
+    stale: boolean;
+    readonlyReason: string | null;
+    impact: string;
+    impactDetails: string[];
+    preview: WatermarkPreview | null;
+}
+export interface WatermarkDialogModel {
+    getSnapshot(): WatermarkDialogSnapshot;
+    subscribe(listener: (snapshot: WatermarkDialogSnapshot) => void): () => void;
+    patchDraft(patch: Partial<WatermarkDraft>): void;
+    setScope(sectionId: string | null, variant: WatermarkPageVariant): void;
+    selectWatermarks(ids: string[]): void;
+    apply(): Promise<void>;
+    reload(): Promise<void>;
+}

package/dist/superdoc/src/public/ui/watermark-draft.d.ts

@@ -0,0 +1,6 @@
+import { RetainedPictureWatermarkInput, WatermarkInfo, WatermarkInput } from '../../../../document-api/src/index.js';
+import { WatermarkDraft } from './watermark-dialog-state.js';
+export declare function createWatermarkDraft(item?: WatermarkInfo): WatermarkDraft;
+export declare function patchWatermarkDraft(draft: WatermarkDraft, patch: Partial<WatermarkDraft>): WatermarkDraft;
+export declare function getWatermarkDraftError(draft: WatermarkDraft): string | null;
+export declare function toWatermarkInput(draft: WatermarkDraft): WatermarkInput | RetainedPictureWatermarkInput;

package/dist/superdoc/src/public/ui.d.cts

@@ -45,6 +45,7 @@ import type { OperationCapabilityResolveResult as __Cjs_OperationCapabilityResol
 import type { PartialBrowserDocumentApi as __Cjs_PartialBrowserDocumentApi } from './ui.js' with { "resolution-mode": "import" };
 import type { PictureWatermarkInput as __Cjs_PictureWatermarkInput } from './ui.js' with { "resolution-mode": "import" };
 import type { Receipt as __Cjs_Receipt } from './ui.js' with { "resolution-mode": "import" };
+import type { RetainedPictureWatermarkInput as __Cjs_RetainedPictureWatermarkInput } from './ui.js' with { "resolution-mode": "import" };
 import type { RichContentInsertInput as __Cjs_RichContentInsertInput } from './ui.js' with { "resolution-mode": "import" };
 import type { ScrollIntoViewInput as __Cjs_ScrollIntoViewInput } from './ui.js' with { "resolution-mode": "import" };
 import type { ScrollIntoViewOutput as __Cjs_ScrollIntoViewOutput } from './ui.js' with { "resolution-mode": "import" };
@@ -106,7 +107,12 @@ import type { ViewportGetRectInput as __Cjs_ViewportGetRectInput } from './ui.js
 import type { ViewportHandle as __Cjs_ViewportHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { ViewportRect as __Cjs_ViewportRect } from './ui.js' with { "resolution-mode": "import" };
 import type { ViewportRectResult as __Cjs_ViewportRectResult } from './ui.js' with { "resolution-mode": "import" };
+import type { WatermarkHandle as __Cjs_WatermarkHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { WatermarkInfo as __Cjs_WatermarkInfo } from './ui.js' with { "resolution-mode": "import" };
+import type { WatermarksApplyInput as __Cjs_WatermarksApplyInput } from './ui.js' with { "resolution-mode": "import" };
+import type { WatermarksApplyResult as __Cjs_WatermarksApplyResult } from './ui.js' with { "resolution-mode": "import" };
+import type { WatermarksApplySuccess as __Cjs_WatermarksApplySuccess } from './ui.js' with { "resolution-mode": "import" };
+import type { WatermarksApplyTarget as __Cjs_WatermarksApplyTarget } from './ui.js' with { "resolution-mode": "import" };
 import type { WatermarkTarget as __Cjs_WatermarkTarget } from './ui.js' with { "resolution-mode": "import" };
 import type { WorkflowActionResult as __Cjs_WorkflowActionResult } from './ui.js' with { "resolution-mode": "import" };
 import type { WorkflowReceipt as __Cjs_WorkflowReceipt } from './ui.js' with { "resolution-mode": "import" };
@@ -161,6 +167,7 @@ export type { __Cjs_OperationCapabilityResolveResult as OperationCapabilityResol
 export type { __Cjs_PartialBrowserDocumentApi as PartialBrowserDocumentApi };
 export type { __Cjs_PictureWatermarkInput as PictureWatermarkInput };
 export type { __Cjs_Receipt as Receipt };
+export type { __Cjs_RetainedPictureWatermarkInput as RetainedPictureWatermarkInput };
 export type { __Cjs_RichContentInsertInput as RichContentInsertInput };
 export type { __Cjs_ScrollIntoViewInput as ScrollIntoViewInput };
 export type { __Cjs_ScrollIntoViewOutput as ScrollIntoViewOutput };
@@ -223,7 +230,12 @@ export type { __Cjs_ViewportGetRectInput as ViewportGetRectInput };
 export type { __Cjs_ViewportHandle as ViewportHandle };
 export type { __Cjs_ViewportRect as ViewportRect };
 export type { __Cjs_ViewportRectResult as ViewportRectResult };
+export type { __Cjs_WatermarkHandle as WatermarkHandle };
 export type { __Cjs_WatermarkInfo as WatermarkInfo };
+export type { __Cjs_WatermarksApplyInput as WatermarksApplyInput };
+export type { __Cjs_WatermarksApplyResult as WatermarksApplyResult };
+export type { __Cjs_WatermarksApplySuccess as WatermarksApplySuccess };
+export type { __Cjs_WatermarksApplyTarget as WatermarksApplyTarget };
 export type { __Cjs_WatermarkTarget as WatermarkTarget };
 export type { __Cjs_WorkflowActionResult as WorkflowActionResult };
 export type { __Cjs_WorkflowReceipt as WorkflowReceipt };

package/dist/superdoc/src/public/ui.d.ts

@@ -26,4 +26,4 @@
 export { createSuperDocUI } from './ui/create-super-doc-ui.js';
 export { shallowEqual } from './ui/equality.js';
 export { BUILT_IN_COMMAND_IDS } from './ui/commands.js';
-export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandId, CommandsHandle, ContextMenuItem, ContextMenuHandle, SearchController, SearchHandle, SearchQueryOptions, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, BuiltInCommandId, ToolbarCommandId, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, ContentControlHighlightResult, FontsHandle, ZoomHandle, DocumentHandle, DocumentReplacementResult, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, SearchSnapshot, SearchSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from './ui/types.js';
+export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandId, CommandsHandle, ContextMenuItem, ContextMenuHandle, WatermarkHandle, SearchController, SearchHandle, SearchQueryOptions, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, BuiltInCommandId, ToolbarCommandId, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, ContentControlHighlightResult, FontsHandle, ZoomHandle, DocumentHandle, DocumentReplacementResult, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, SearchSnapshot, SearchSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, } from './ui/types.js';