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

package/dist/superdoc.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-74VwNCz7.cjs");
 const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-Gxk1m05U.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-BFJ9Y0YV.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-D8mAFF-r.cjs");
@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.18.1-next.5";
+		return "2.19.0-next.2";
 	} catch {
 		return "unknown";
 	}
@@ -5456,13 +5456,13 @@ function resolveProviderExtension(candidate) {
 	if (!adapterId) return {
 		ok: false,
 		reason: "invalid-adapter-id",
-		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.adapterId."
+		message: "SuperDoc v2 provider extensions require a non-empty collaboration.adapterId."
 	};
 	const documentId = normalizeNonEmptyString(candidate.documentId);
 	if (!documentId) return {
 		ok: false,
 		reason: "invalid-document-id",
-		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.documentId."
+		message: "SuperDoc v2 provider extensions require a non-empty collaboration.documentId."
 	};
 	const roomMode = normalizeRoomMode(candidate.roomMode);
 	if (!roomMode) return invalidRoomMode();
@@ -18727,6 +18727,7 @@ var toolbarIcons = {
 	link: link_solid_default,
 	image: image_solid_default,
 	tableOfContents: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"96 96 448 448\"><!--!Font Awesome Free v7.2.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2026 Fonticons, Inc.--><path d=\"M96 160C96 124.7 124.7 96 160 96L480 96C515.3 96 544 124.7 544 160L544 480C544 515.3 515.3 544 480 544L160 544C124.7 544 96 515.3 96 480L96 160zM160 160L160 224L224 224L224 160L160 160zM480 160L288 160L288 224L480 224L480 160zM160 288L160 352L224 352L224 288L160 288zM480 288L288 288L288 352L480 352L480 288zM160 416L160 480L224 480L224 416L160 416zM480 416L288 416L288 480L480 480L480 416z\"></path></svg>\n",
+	watermark: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"12\" height=\"16\" viewBox=\"0 0 384 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path fill=\"currentColor\" fill-rule=\"evenodd\" d=\"M0 64C0 28.7 28.7 0 64 0L224 0l0 128c0 17.7 14.3 32 32 32l128 0 0 288c0 35.3-28.7 64-64 64L64 512c-35.3 0-64-28.7-64-64L0 64zm384 64l-128 0L256 0 384 128zM109.2 254.3L150.8 230.3L312.1 349.7L267.0 375.7L236.9 351.5L169.4 390.5L175.2 428.7L130.2 454.7ZM162.6 344.8L200.7 322.8L153.6 285.3Z\"/></svg>\n",
 	alignLeft: align_left_solid_default,
 	alignRight: align_right_solid_default,
 	alignCenter: align_center_solid_default,
@@ -21458,7 +21459,9 @@ var _sfc_main$23 = {
 			}
 		}
 		function handleBackdropClick(event) {
-			if (event.target === event.currentTarget && props.surface.request.closeOnBackdrop !== false) emit("close");
+			if (event.target !== event.currentTarget) return;
+			event.preventDefault();
+			if (props.surface.request.closeOnBackdrop !== false) emit("close");
 		}
 		const shellProps = (0, vue.computed)(() => ({
 			surfaceId: props.surface.id,
@@ -21535,7 +21538,7 @@ var _sfc_main$23 = {
 		};
 	}
 };
-var SurfaceDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$23, [["__scopeId", "data-v-20bf8e4b"]]);
+var SurfaceDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$23, [["__scopeId", "data-v-582b6534"]]);
 //#endregion
 //#region src/components/surfaces/SurfaceFloating.vue
 var _hoisted_1$17 = ["aria-labelledby", "aria-label"];
@@ -21706,10 +21709,9 @@ var _sfc_main$21 = {
 		* Reads the SurfaceManager's reactive state (activeDialog / activeFloating)
 		* and renders the appropriate surface shell for each slot.
 		*
-		* Uses position:fixed with bounds dynamically computed as the intersection
-		* of .superdoc__layers (the document viewport) with the browser viewport.
-		* This keeps dialogs centered and floating surfaces pinned to the visible
-		* area regardless of document scroll position.
+		* Floating surfaces are clipped to the visible document viewport. Modal
+		* dialogs are siblings of that clipped host so their backdrop covers the
+		* browser viewport, including toolbars and surrounding application content.
 		*
 		* Floating Escape and outside-pointer-down handling live here (document-level)
 		* because floating surfaces are non-modal — focus can be anywhere in the
@@ -21907,16 +21909,16 @@ var _sfc_main$21 = {
 				surface: floating.value,
 				ref_key: "floatingRef",
 				ref: floatingRef
-			}, null, 8, ["surface"])) : (0, vue.createCommentVNode)("", true), dialog.value ? ((0, vue.openBlock)(), (0, vue.createBlock)(SurfaceDialog_default, {
+			}, null, 8, ["surface"])) : (0, vue.createCommentVNode)("", true)], 4)) : (0, vue.createCommentVNode)("", true), dialog.value ? ((0, vue.openBlock)(), (0, vue.createBlock)(SurfaceDialog_default, {
 				key: dialog.value.id,
 				surface: dialog.value,
 				"scroll-lock-target": (0, vue.unref)(geometryTarget),
 				onClose: handleDialogClose
-			}, null, 8, ["surface", "scroll-lock-target"])) : (0, vue.createCommentVNode)("", true)], 4)) : (0, vue.createCommentVNode)("", true)]);
+			}, null, 8, ["surface", "scroll-lock-target"])) : (0, vue.createCommentVNode)("", true)]);
 		};
 	}
 };
-var SurfaceHost_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$21, [["__scopeId", "data-v-c6a3b75f"]]);
+var SurfaceHost_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$21, [["__scopeId", "data-v-dad99b67"]]);
 //#endregion
 //#region src/SuperDoc.vue
 var _hoisted_1$16 = ["innerHTML"];
@@ -38209,6 +38211,7 @@ function addCustomItemRegions(regions, customItems) {
 	return result;
 }
 var TOOLBAR_OPTIONAL_ITEM_REGIONS = Object.freeze({
+	watermark: "center",
 	"formatting-marks": "right",
 	"table-of-contents": "center"
 });
@@ -38319,7 +38322,8 @@ function normalizeToolbarOptions(options) {
 		fonts: options.fontOptions === void 0 ? options.fonts : mapToolbarFontOptions(options.fontOptions),
 		customButtons: options.customItems === void 0 ? options.customButtons : mapToolbarCustomItems(options.customItems),
 		showFormattingMarksButton: includeItems === null && !itemIds.has("formatting-marks") ? options.showFormattingMarksButton : itemIds.has("formatting-marks") || includeItems?.has("formatting-marks"),
-		showTableOfContentsButton: includeItems === null && !itemIds.has("table-of-contents") ? options.showTableOfContentsButton : itemIds.has("table-of-contents") || includeItems?.has("table-of-contents")
+		showTableOfContentsButton: includeItems === null && !itemIds.has("table-of-contents") ? options.showTableOfContentsButton : itemIds.has("table-of-contents") || includeItems?.has("table-of-contents"),
+		showWatermarkButton: itemIds.has("watermark") || includeItems?.has("watermark") || false
 	});
 }
 /**
@@ -38849,6 +38853,14 @@ var BUILT_IN_TOOLBAR_CATALOG = [
 		disposition: "controller-routed",
 		group: "center"
 	},
+	{
+		name: "watermark",
+		commandId: null,
+		instanceMethod: "ui.watermark.open",
+		disposition: "host-routed",
+		group: "center",
+		note: "opens the shared Watermark dialog through superdoc.ui.watermark.open; the workflow owns scope, edit permissions, and apply"
+	},
 	{
 		name: "table",
 		commandId: "table-insert",
@@ -38974,153 +38986,6 @@ function resolveToolbarCommandId(name) {
 	return entry?.disposition === "controller-routed" ? entry.commandId : null;
 }
 //#endregion
-//#region src/internal/toolbar/image-upload.js
-/**
-* Interactive image acquisition for the built-in toolbar (SD-3567).
-*
-* The toolbar image button routes through the shared controller command
-* `image` → `create.image`, which requires a base64 PNG/JPEG data-URI `src`.
-* This module owns the browser file picker and the File → data-URI
-* conversion; the toolbar dispatches the resulting payload through the
-* normal controller command path.
-*/
-/** Accept filter for the picker: PNG and JPEG only (V1 parity; OOXML-native formats). */
-var IMAGE_PICKER_ACCEPT = ".png,.jpg,.jpeg,image/png,image/jpeg";
-var SUPPORTED_IMAGE_MIME_TYPES = /* @__PURE__ */ new Set([
-	"image/png",
-	"image/jpeg",
-	"image/jpg"
-]);
-var SUPPORTED_IMAGE_EXTENSIONS = /\.(png|jpe?g)$/i;
-/**
-* Whether a picked/dropped file is an insertable image (PNG/JPEG). Falls back
-* to the file extension when the browser reports no MIME type.
-* @param {File | null | undefined} file
-* @returns {boolean}
-*/
-function isSupportedImageFile(file) {
-	if (!file) return false;
-	const type = typeof file.type === "string" ? file.type.toLowerCase() : "";
-	if (type) return SUPPORTED_IMAGE_MIME_TYPES.has(type);
-	return SUPPORTED_IMAGE_EXTENSIONS.test(String(file.name ?? ""));
-}
-/**
-* Read a File/Blob into a base64 data URI.
-*
-* Some browsers/OSes deliver picked files with an empty `type`; the picker
-* accepts those by extension, but `readAsDataURL` would then produce an
-* `application/octet-stream` data URI that `create.image` rejects. Rewrite
-* the media type from the filename so extension-accepted files still insert.
-* @param {Blob & { name?: string }} file
-* @returns {Promise<string>}
-*/
-function fileToDataUri(file) {
-	return new Promise((resolve, reject) => {
-		const reader = new FileReader();
-		reader.onload = () => resolve(normalizeImageDataUri(String(reader.result), file));
-		reader.onerror = () => reject(reader.error ?? /* @__PURE__ */ new Error("image-read-failed"));
-		reader.readAsDataURL(file);
-	});
-}
-/**
-* Ensure a data URI read from a supported file carries a PNG/JPEG media type.
-* Leaves URIs already typed as a supported image (or uninferable ones) alone.
-* @param {string} dataUri
-* @param {(Blob & { name?: string }) | null | undefined} file
-* @returns {string}
-*/
-function normalizeImageDataUri(dataUri, file) {
-	const match = /^data:([^;,]*);base64,/.exec(dataUri);
-	if (!match) return dataUri;
-	const mime = match[1].toLowerCase();
-	if (SUPPORTED_IMAGE_MIME_TYPES.has(mime)) return dataUri;
-	const name = String(file?.name ?? "");
-	const inferred = /\.jpe?g$/i.test(name) ? "image/jpeg" : /\.png$/i.test(name) ? "image/png" : null;
-	if (!inferred) return dataUri;
-	return `data:${inferred};base64,${dataUri.slice(match[0].length)}`;
-}
-/**
-* Resolve the `create.image` src for a picked file. Uses the consumer's
-* `handleImageUpload` callback when configured (V1 contract:
-* `(file: File) => Promise<string>`). A returned non-data URL is fetched and
-* embedded, because `create.image` requires an embedded base64 data URI.
-* @param {File} file
-* @param {((file: File) => Promise<string>) | null | undefined} handleImageUpload
-* @returns {Promise<string>}
-*/
-async function resolveImageSrc(file, handleImageUpload) {
-	if (typeof handleImageUpload === "function") {
-		const result = await handleImageUpload(file);
-		if (typeof result !== "string" || result.trim() === "") throw new Error("handleImageUpload returned an empty result");
-		if (result.startsWith("data:")) return result;
-		return embedRemoteImage(result, file);
-	}
-	return fileToDataUri(file);
-}
-/**
-* Fetch a remote image URL and embed it as a data URI. Object-store /
-* presigned URLs often respond `application/octet-stream`, so keep a filename
-* hint (URL path, falling back to the originally picked file) for the media
-* type normalization in `fileToDataUri`.
-* @param {string} url
-* @param {File | null | undefined} pickedFile
-* @returns {Promise<string>}
-*/
-async function embedRemoteImage(url, pickedFile) {
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`image fetch failed: ${response.status}`);
-	const blob = await response.blob();
-	const name = (/\.(?:png|jpe?g)(?:$|[?#])/i.test(url) ? url.split(/[?#]/)[0] : "") || pickedFile?.name || "";
-	return fileToDataUri(name ? Object.assign(blob, { name }) : blob);
-}
-/**
-* Hidden `<input type=file>` picker bound to one toolbar instance. The input
-* stays attached (hidden) so automation and tests can drive it; `destroy()`
-* removes it. Picking a file calls `onPick(file)`; an unsupported type or a
-* failed pick routes through `onError(error)`.
-*
-* @param {{
-*   ownerDocument?: Document,
-*   onPick?: (file: File) => unknown,
-*   onError?: (error: Error) => void,
-* }} options
-* @returns {{ input: HTMLInputElement, open: () => void, destroy: () => void }}
-*/
-function createImageFilePicker({ ownerDocument = document, onPick, onError } = {}) {
-	const input = ownerDocument.createElement("input");
-	input.type = "file";
-	input.accept = IMAGE_PICKER_ACCEPT;
-	input.hidden = true;
-	input.tabIndex = -1;
-	input.setAttribute("data-superdoc-image-picker", "true");
-	input.setAttribute("aria-hidden", "true");
-	input.addEventListener("change", () => {
-		const file = input.files && input.files[0];
-		input.value = "";
-		if (!file) return;
-		if (!isSupportedImageFile(file)) {
-			onError?.(/* @__PURE__ */ new Error(`unsupported image type: ${file.type || file.name}`));
-			return;
-		}
-		try {
-			const result = onPick?.(file);
-			if (result && typeof result.then === "function") result.catch((error) => onError?.(error));
-		} catch (error) {
-			onError?.(error);
-		}
-	});
-	ownerDocument.body?.appendChild(input);
-	return {
-		input,
-		open() {
-			input.click();
-		},
-		destroy() {
-			input.remove();
-		}
-	};
-}
-//#endregion
 //#region src/internal/toolbar/built-in/helpers.js
 var sanitizeNumber = (value, defaultNumber) => {
 	let sanitized = value.replace(/[^0-9.]/g, "");
@@ -39311,6 +39176,7 @@ var _sfc_main$18 = {
 			handleClick();
 		};
 		const onEnterKeydown = (event) => {
+			event.preventDefault();
 			if (!props.allowEnterPropagation) event.stopPropagation();
 			handleOuterEnter(event);
 		};
@@ -39503,7 +39369,7 @@ var _sfc_main$18 = {
 		};
 	}
 };
-var ToolbarButton_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$18, [["__scopeId", "data-v-22817fa7"]]);
+var ToolbarButton_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$18, [["__scopeId", "data-v-96796456"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/ToolbarSeparator.vue
 var _hoisted_1$13 = {
@@ -39584,7 +39450,7 @@ var _sfc_main$16 = {
 		}
 	},
 	emits: ["update:show", "select"],
-	setup(__props, { emit: __emit }) {
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const props = __props;
 		const emit = __emit;
 		const slots = (0, vue.useSlots)();
@@ -39819,6 +39685,7 @@ var _sfc_main$16 = {
 			trigger.setAttribute("tabindex", "-1");
 			trigger.focus();
 		};
+		__expose({ focusTrigger });
 		const handleKeyDown = (event) => {
 			if (!isOpen.value) return;
 			const { key } = event;
@@ -39931,7 +39798,7 @@ var _sfc_main$16 = {
 		};
 	}
 };
-var ToolbarDropdown_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$16, [["__scopeId", "data-v-764d5fd7"]]);
+var ToolbarDropdown_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$16, [["__scopeId", "data-v-fa3f6b69"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/toolbar-focus-helpers.js
 var preventEditorFocusTransfer = (event) => {
@@ -39979,6 +39846,7 @@ var _sfc_main$15 = {
 	setup(__props, { emit: __emit }) {
 		const emit = __emit;
 		const props = __props;
+		const dropdown = (0, vue.ref)(null);
 		const isOverflowMenuOpened = (0, vue.computed)(() => props.toolbarItem.expand.value);
 		const hasOpenDropdown = (0, vue.computed)(() => props.overflowItems.some((item) => item.type === "dropdown" && (0, vue.unref)(item.expand)));
 		const overflowToolbarItem = (0, vue.computed)(() => ({
@@ -39994,6 +39862,10 @@ var _sfc_main$15 = {
 			emit("close");
 		};
 		const handleCommand = ({ item, argument, option }) => {
+			if (item.name.value === "watermark") {
+				emit("close");
+				dropdown.value?.focusTrigger();
+			}
 			emit("command", {
 				item,
 				argument,
@@ -40002,6 +39874,8 @@ var _sfc_main$15 = {
 		};
 		return (_ctx, _cache) => {
 			return (0, vue.openBlock)(), (0, vue.createBlock)(ToolbarDropdown_default, {
+				ref_key: "dropdown",
+				ref: dropdown,
 				class: "overflow-menu",
 				"close-on-escape": !hasOpenDropdown.value,
 				"has-open-child": hasOpenDropdown.value,
@@ -40019,7 +39893,10 @@ var _sfc_main$15 = {
 					class: ["overflow-menu_items", "sd-toolbar-overflow-menu"]
 				})
 			}, {
-				trigger: (0, vue.withCtx)(() => [(0, vue.createVNode)(ToolbarButton_default, { "toolbar-item": overflowToolbarItem.value }, null, 8, ["toolbar-item"])]),
+				trigger: (0, vue.withCtx)(() => [(0, vue.createVNode)(ToolbarButton_default, {
+					"toolbar-item": overflowToolbarItem.value,
+					"allow-enter-propagation": true
+				}, null, 8, ["toolbar-item"])]),
 				menu: (0, vue.withCtx)(() => [(0, vue.createVNode)(ButtonGroup_default, {
 					class: "superdoc-toolbar-overflow",
 					"toolbar-items": __props.overflowItems,
@@ -40042,7 +39919,7 @@ var _sfc_main$15 = {
 		};
 	}
 };
-var OverflowMenu_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$15, [["__scopeId", "data-v-5f8ee279"]]);
+var OverflowMenu_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$15, [["__scopeId", "data-v-1227fcf9"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/font-typeahead.js
 /**
@@ -41680,10 +41557,12 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 	setup(__props, { emit: __emit }) {
 		const { proxy } = (0, vue.getCurrentInstance)();
 		let toolbarKey = (0, vue.ref)(1);
+		const toolbarRoot = (0, vue.ref)(null);
 		const toolbarStateVersion = (0, vue.ref)(0);
 		const compactSideGroups = (0, vue.ref)(false);
 		let containerResizeObserver = null;
 		let pendingSelectionCapture = null;
+		let renderedWidth = proxy.$toolbar.getAvailableWidth();
 		/**
 		* Computed property that determines the font-family to use for toolbar UI surfaces.
 		* Retrieves the configured font from the toolbar instance's config and validates it.
@@ -41704,10 +41583,41 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 		const updateCompactSideGroups = () => {
 			compactSideGroups.value = proxy.$toolbar.getAvailableWidth() <= RESPONSIVE_BREAKPOINTS.lg;
 		};
+		const captureFocusedControl = () => {
+			const root = toolbarRoot.value;
+			const ownerDocument = root?.ownerDocument;
+			const focused = ownerDocument?.activeElement;
+			if (!root?.contains(focused)) return null;
+			const control = focused.closest("[data-sd-part=\"toolbar-item\"]") ?? focused.querySelector("[data-sd-part=\"toolbar-item\"]");
+			if (!control || focused !== control && !focused.contains(control)) return null;
+			const itemId = control.querySelector("[data-item]")?.getAttribute("data-item");
+			if (!itemId) return null;
+			return () => {
+				const currentRoot = toolbarRoot.value;
+				if (!currentRoot?.isConnected || focused.isConnected || ownerDocument.activeElement !== ownerDocument.body) return;
+				const markers = [...currentRoot.querySelectorAll("[data-item]")];
+				for (const id of [itemId, "btn-overflow"]) {
+					const target = markers.find((marker) => marker.getAttribute("data-item") === id)?.closest("[data-sd-part=\"toolbar-item\"]");
+					if (target && target.getAttribute("aria-disabled") !== "true") {
+						target.focus({ preventScroll: true });
+						return;
+					}
+				}
+			};
+		};
+		const renderToolbar = async (restoreFocus) => {
+			toolbarKey.value += 1;
+			await (0, vue.nextTick)();
+			restoreFocus?.();
+		};
 		const onWindowResized = async () => {
+			const width = proxy.$toolbar.getAvailableWidth();
+			if (width === renderedWidth) return;
+			renderedWidth = width;
+			const restoreFocus = captureFocusedControl();
 			await proxy.$toolbar.onToolbarResize();
 			updateCompactSideGroups();
-			toolbarKey.value += 1;
+			await renderToolbar(restoreFocus);
 		};
 		const onResizeThrottled = throttle(onWindowResized, 300);
 		/**
@@ -41717,12 +41627,16 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 		* SuperToolbar emits `toolbar-items-changed` on rebuild; bumping the key re-reads the new items into the DOM.
 		*/
 		const onToolbarItemsChanged = () => {
-			toolbarKey.value += 1;
+			const restoreFocus = captureFocusedControl();
+			renderedWidth = proxy.$toolbar.getAvailableWidth();
+			updateCompactSideGroups();
+			renderToolbar(restoreFocus);
 		};
 		const onToolbarStateChanged = () => {
 			toolbarStateVersion.value += 1;
 		};
 		function teardownListeners() {
+			onResizeThrottled.cancel();
 			window.removeEventListener("resize", onResizeThrottled);
 			proxy.$toolbar.off?.("toolbar-items-changed", onToolbarItemsChanged);
 			proxy.$toolbar.off?.("toolbar-state-change", onToolbarStateChanged);
@@ -41780,6 +41694,8 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 		return (_ctx, _cache) => {
 			return (0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
 				class: "superdoc-toolbar",
+				ref_key: "toolbarRoot",
+				ref: toolbarRoot,
 				key: (0, vue.unref)(toolbarKey),
 				role: "toolbar",
 				"aria-label": "Toolbar",
@@ -41836,7 +41752,7 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 			], 32);
 		};
 	}
-}, [["__scopeId", "data-v-ed19716b"]]);
+}, [["__scopeId", "data-v-9418cc7d"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/font-options.js
 /**
@@ -43452,6 +43368,15 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts
 		disabled: false,
 		attributes: { ariaLabel: "Table of contents" }
 	});
+	const watermark = useToolbarItem({
+		type: "button",
+		name: "watermark",
+		icon: toolbarIcons.watermark,
+		tooltip: toolbarTexts.watermark,
+		allowWithoutEditor: true,
+		disabled: true,
+		attributes: { ariaLabel: toolbarTexts.watermark }
+	});
 	const tableItem = useToolbarItem({
 		type: "dropdown",
 		name: "table",
@@ -44157,6 +44082,7 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts
 		link,
 		image,
 		...shouldIncludeTableOfContents ? [tableOfContents] : [],
+		...superToolbar.config?.showWatermarkButton || configuredItemNames?.has("watermark") ? [watermark] : [],
 		tableItem,
 		tableActionsItem,
 		makeSeparator(),
@@ -44263,6 +44189,7 @@ var toolbarTexts = {
 	link: "Link",
 	image: "Image",
 	tableOfContents: "Table of contents",
+	watermark: "Watermark",
 	table: "Insert table",
 	tableActions: "Table options",
 	addRowBefore: "Insert row above",
@@ -44462,7 +44389,8 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 		groups: null,
 		customButtons: [],
 		showFormattingMarksButton: false,
-		showTableOfContentsButton: false
+		showTableOfContentsButton: false,
+		showWatermarkButton: false
 	};
 	toolbarItems = [];
 	overflowItems = [];
@@ -44796,6 +44724,7 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 		return false;
 	}
 	#canRunHostAction(name) {
+		if (name === "watermark") return this.ui?.document?.getSnapshot?.().ready === true && typeof this.ui?.watermark?.open === "function";
 		if (name === "ruler") return typeof this.superdoc?.toggleRuler === "function";
 		if (name === "formattingMarks") return typeof this.superdoc?.toggleFormattingMarks === "function" || typeof this.superdoc?.setShowFormattingMarks === "function";
 		return false;
@@ -44974,6 +44903,7 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 			item.resetDisabled();
 			this.#applyHeadlessState(item);
 		});
+		this.getToolbarItemByName("overflow")?.setDisabled(!this.overflowItems.some((item) => item.type !== "separator" && !item.disabled.value));
 		const copyFormatItem = this.getToolbarItemByName("copyFormat");
 		if (copyFormatItem) if (this.snapshot?.copyFormatActive) copyFormatItem.activate();
 		else copyFormatItem.deactivate();
@@ -44988,6 +44918,12 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 	}
 	#runHostAction(name, argument) {
 		const superdoc = this.superdoc;
+		if (name === "watermark") {
+			if (!this.#canRunHostAction(name)) return false;
+			const result = this.ui.watermark.open();
+			if (!result.ok) throw new Error(`[superdoc toolbar] Watermark dialog unavailable: ${result.reason}`);
+			return true;
+		}
 		if (name === "ruler") {
 			if (typeof superdoc?.toggleRuler === "function") {
 				superdoc.toggleRuler();
@@ -45042,10 +44978,10 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 	*/
 	#startImagePick() {
 		if ((this.snapshot?.commands?.["image"])?.disabled) return true;
-		if (!this.#imagePicker) this.#imagePicker = createImageFilePicker({
+		if (!this.#imagePicker) this.#imagePicker = require_create_super_doc_ui.createImageFilePicker({
 			ownerDocument: this.toolbarContainer?.ownerDocument ?? document,
 			onPick: async (file) => {
-				const src = await resolveImageSrc(file, this.superdoc?.config?.handleImageUpload);
+				const src = await require_create_super_doc_ui.resolveImageSrc(file, this.superdoc?.config?.handleImageUpload);
 				executeCommand(this.ui, "image", { src }, {
 					firstParty: true,
 					onSettled: () => this.updateToolbarState(),
@@ -45750,7 +45686,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.18.1-next.5";
+		this.version = "2.19.0-next.2";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -47142,7 +47078,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			{
 				feature: "shell.collaboration",
 				status: "supported",
-				reason: "v2 single-doc y-websocket collaboration is wired through document.v2Collaboration, including collaboration-ready, awareness-update, and locked event bridges; arbitrary external { ydoc, provider } adapters remain unsupported"
+				reason: "v2 single-doc collaboration (hocuspocus, y-websocket, liveblocks, and registered provider extensions) is wired through document.collaboration, including collaboration-ready, awareness-update, and locked event bridges; external { ydoc, provider } instances remain unsupported"
 			},
 			{
 				feature: "shell.context-menu",