superdoc 2.21.0 → 2.22.0-next.2

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.21.0",
+	superdocVersion: "2.22.0-next.2",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.21.0",
+	superdocVersion: "2.22.0-next.2",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/layout-engine/contracts/src/index.d.ts

@@ -84,6 +84,24 @@ export type StructuredContentLockMode = 'unlocked' | 'sdtLocked' | 'contentLocke
  *     DOM textContent (a11y / copy-paste behavior).
  */
 export type StructuredContentAppearance = 'boundingBox' | 'tags' | 'hidden';
+/** The visible state Word stores on a `w14:checkbox` content control. */
+export type StructuredContentCheckbox = {
+    checked: boolean;
+    checkedSymbol: {
+        font: string;
+        char: string;
+    };
+    uncheckedSymbol: {
+        font: string;
+        char: string;
+    };
+    /**
+     * CSS-pixel size resolved from the checkbox SDT's own `<w:rPr>`.
+     * Word applies this control-level run formatting to its glyph even when the
+     * carrier `<w:sym>` does not retain that formatting through projection.
+     */
+    fontSize?: number;
+};
 export type StructuredContentMetadata = {
     type: 'structuredContent';
     scope: 'inline' | 'block';
@@ -93,6 +111,8 @@ export type StructuredContentMetadata = {
     lockMode?: StructuredContentLockMode;
     /** Appearance from the SDT's `<w15:appearance>` element, when present. */
     appearance?: StructuredContentAppearance;
+    /** Word-native checkbox state parsed from the SDT properties, when present. */
+    checkbox?: StructuredContentCheckbox;
     sdtPr?: unknown;
 };
 export type DocumentSectionMetadata = {

package/dist/layout-engine/painters/dom/src/runs/text-run.d.ts

@@ -2,6 +2,14 @@ import { Run, TextRun } from '../../../../contracts/src/index.js';
 import { FragmentRenderContext } from '../renderer.js';
 import { BROWSER_DEFAULT_FONT_SIZE } from '../styles.js';
 import { RunRenderContext, TrackedChangesRenderConfig } from './types.js';
+export type CheckboxGlyphs = {
+    checked: string;
+    unchecked: string;
+    current: string;
+};
+export declare const checkboxGlyphs: (run: TextRun) => CheckboxGlyphs | null;
+/** Stamps the authored states needed to reflect an accepted checkbox toggle. */
+export declare const applyCheckboxGlyphMetadata: (element: HTMLElement, run: TextRun) => CheckboxGlyphs | null;
 /**
  * Underline thickness in px, scaled to font size. Shared by text runs
  * (`text-decoration-thickness`) and tab underlines (border width) so a run's

package/dist/shared/font-system/src/document-font-options.d.ts

@@ -1,11 +1,3 @@
-/**
- * Document-scoped font options for the toolbar: one option per logical family a loaded document
- * actually uses. Distinct from the static {@link ./font-offerings} (the bundled choices): this is
- * runtime and document-scoped because it needs the document's registry and resolver.
- *
- * Fallback diagnostics are intentionally not part of this surface. The toolbar lists document fonts as
- * plain picker rows; internal fallback/reporting details stay in SuperDoc's runtime font report.
- */
 import { type BundledActivation } from './activation.js';
 import { type UsedFace } from './report.js';
 import type { FontRegistry } from './registry.js';
@@ -22,6 +14,8 @@ export interface DocumentFontOption {
      * provided font previews as itself). The regular face is used as the representative when present.
      */
     previewFamily: string;
+    /** First CSS generic in the rendered logical stack, or null when that stack has none. */
+    genericFamily: string | null;
 }
 /**
  * The document-specific font options for the toolbar: one per LOGICAL family the document renders,
@@ -50,4 +44,4 @@ export interface FontFamilyOption {
  * always listed - they come from the loaded document itself. Sorted alphabetically, deduped by
  * logical family.
  */
-export declare function buildFontFamilyOptions(documentOptions: ReadonlyArray<DocumentFontOption>, activation?: BundledActivation): FontFamilyOption[];
+export declare function buildFontFamilyOptions(documentOptions: ReadonlyArray<Pick<DocumentFontOption, 'logicalFamily' | 'previewFamily'>>, activation?: BundledActivation): FontFamilyOption[];

package/dist/style.css

@@ -2340,34 +2340,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-0d8ce95e] {
+.superdoc[data-v-b22dc061] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-0d8ce95e] {
+.right-sidebar[data-v-b22dc061] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-0d8ce95e] {
+.floating-comments[data-v-b22dc061] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-0d8ce95e] {
+.superdoc__layers[data-v-b22dc061] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-0d8ce95e] {
+.superdoc__document[data-v-b22dc061] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-0d8ce95e] {
+.superdoc__sub-document[data-v-b22dc061] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-0d8ce95e] {
+.superdoc__selection-layer[data-v-b22dc061] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -2378,13 +2378,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-0d8ce95e] {
+.superdoc__whiteboard-layer[data-v-b22dc061] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-0d8ce95e] {
+.superdoc__temp-selection[data-v-b22dc061] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-0d8ce95e] {
+.superdoc__right-sidebar[data-v-b22dc061] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -2392,7 +2392,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-0d8ce95e] {
+.superdoc__compact-comment-popover[data-v-b22dc061] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -2401,14 +2401,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-0d8ce95e] {
+.tools[data-v-b22dc061] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-0d8ce95e] {
+.tools-item[data-v-b22dc061] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -2419,10 +2419,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-0d8ce95e] {
+.tools-item i[data-v-b22dc061] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-0d8ce95e] {
+.superdoc__tools-icon[data-v-b22dc061] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -2437,22 +2437,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-0d8ce95e] {
+.superdoc .superdoc__layers[data-v-b22dc061] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-0d8ce95e] {
+.superdoc__sub-document[data-v-b22dc061] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-0d8ce95e] {
+.superdoc__right-sidebar[data-v-b22dc061] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-0d8ce95e] {
+.ai-writer-container[data-v-b22dc061] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -2468,10 +2468,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-0d8ce95e] {
+.ai-tool > svg[data-v-b22dc061] {
   fill: transparent;
 }
-.ai-tool[data-v-0d8ce95e]::before {
+.ai-tool[data-v-b22dc061]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2492,7 +2492,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-0d8ce95e]:hover::before {
+.ai-tool[data-v-b22dc061]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/style.layered.css

@@ -2340,34 +2340,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-0d8ce95e] {
+.superdoc[data-v-b22dc061] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-0d8ce95e] {
+.right-sidebar[data-v-b22dc061] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-0d8ce95e] {
+.floating-comments[data-v-b22dc061] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-0d8ce95e] {
+.superdoc__layers[data-v-b22dc061] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-0d8ce95e] {
+.superdoc__document[data-v-b22dc061] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-0d8ce95e] {
+.superdoc__sub-document[data-v-b22dc061] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-0d8ce95e] {
+.superdoc__selection-layer[data-v-b22dc061] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -2378,13 +2378,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-0d8ce95e] {
+.superdoc__whiteboard-layer[data-v-b22dc061] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-0d8ce95e] {
+.superdoc__temp-selection[data-v-b22dc061] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-0d8ce95e] {
+.superdoc__right-sidebar[data-v-b22dc061] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -2392,7 +2392,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-0d8ce95e] {
+.superdoc__compact-comment-popover[data-v-b22dc061] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -2401,14 +2401,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-0d8ce95e] {
+.tools[data-v-b22dc061] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-0d8ce95e] {
+.tools-item[data-v-b22dc061] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -2419,10 +2419,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-0d8ce95e] {
+.tools-item i[data-v-b22dc061] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-0d8ce95e] {
+.superdoc__tools-icon[data-v-b22dc061] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -2437,22 +2437,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-0d8ce95e] {
+.superdoc .superdoc__layers[data-v-b22dc061] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-0d8ce95e] {
+.superdoc__sub-document[data-v-b22dc061] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-0d8ce95e] {
+.superdoc__right-sidebar[data-v-b22dc061] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-0d8ce95e] {
+.ai-writer-container[data-v-b22dc061] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -2468,10 +2468,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-0d8ce95e] {
+.ai-tool > svg[data-v-b22dc061] {
   fill: transparent;
 }
-.ai-tool[data-v-0d8ce95e]::before {
+.ai-tool[data-v-b22dc061]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2492,7 +2492,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-0d8ce95e]:hover::before {
+.ai-tool[data-v-b22dc061]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/superdoc/src/helpers/v2-selection-sync.d.ts

@@ -10,3 +10,6 @@ export function isV2RangeSnapshot(snapshot: {
 } | null | undefined): boolean;
 export function hasOutsideV2DomRangeSelection(selection: Selection | null | undefined, root: Node | null | undefined): boolean;
 export function shouldPreserveHostV2Selection(documentMode: string | null | undefined, hostSnapshot: unknown): boolean;
+export function shouldRetainV2FloatingSelection(hasHostRange: boolean, selectionPosition: {
+    source?: unknown;
+} | null | undefined): boolean;

package/dist/superdoc.cjs

@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.21.0";
+		return "2.22.0-next.2";
 	} catch {
 		return "unknown";
 	}
@@ -17363,6 +17363,17 @@ var shouldPreserveHostV2Selection = (documentMode, hostSnapshot) => {
 	if (documentMode !== "editing" && documentMode !== "suggesting") return false;
 	return isV2RangeSnapshot(hostSnapshot);
 };
+/**
+* A V2 paint can briefly have no DOM anchor while a selected control is being
+* rebuilt. Keep an already-positioned comment affordance during that gap when
+* the host still owns a range; otherwise the button unmounts and remounts on
+* consecutive paint frames, making it blink and intercepting its own click.
+*
+* @param {boolean} hasHostRange
+* @param {{ source?: unknown } | null | undefined} selectionPosition
+* @returns {boolean}
+*/
+var shouldRetainV2FloatingSelection = (hasHostRange, selectionPosition) => hasHostRange === true && selectionPosition?.source === "document-editor";
 //#endregion
 //#region src/composables/use-password-prompt.js
 /** @typedef {import('../core/types').PasswordPromptConfig} PasswordPromptConfig */
@@ -23007,6 +23018,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			}
 			const selection = buildV2FloatingSelection();
 			if (!selection) {
+				if (shouldRetainV2FloatingSelection(v2HasRangeSelection.value, selectionPosition.value)) return;
 				activeSelection.value = null;
 				resetSelection();
 				return;
@@ -24541,7 +24553,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-0d8ce95e"]]);
+}, [["__scopeId", "data-v-b22dc061"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46358,7 +46370,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.21.0";
+		this.version = "2.22.0-next.2";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -314,7 +314,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.21.0";
+		return "2.22.0-next.2";
 	} catch {
 		return "unknown";
 	}
@@ -17347,6 +17347,17 @@ var shouldPreserveHostV2Selection = (documentMode, hostSnapshot) => {
 	if (documentMode !== "editing" && documentMode !== "suggesting") return false;
 	return isV2RangeSnapshot(hostSnapshot);
 };
+/**
+* A V2 paint can briefly have no DOM anchor while a selected control is being
+* rebuilt. Keep an already-positioned comment affordance during that gap when
+* the host still owns a range; otherwise the button unmounts and remounts on
+* consecutive paint frames, making it blink and intercepting its own click.
+*
+* @param {boolean} hasHostRange
+* @param {{ source?: unknown } | null | undefined} selectionPosition
+* @returns {boolean}
+*/
+var shouldRetainV2FloatingSelection = (hasHostRange, selectionPosition) => hasHostRange === true && selectionPosition?.source === "document-editor";
 //#endregion
 //#region src/composables/use-password-prompt.js
 /** @typedef {import('../core/types').PasswordPromptConfig} PasswordPromptConfig */
@@ -22966,6 +22977,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			}
 			const selection = buildV2FloatingSelection();
 			if (!selection) {
+				if (shouldRetainV2FloatingSelection(v2HasRangeSelection.value, selectionPosition.value)) return;
 				activeSelection.value = null;
 				resetSelection();
 				return;
@@ -24500,7 +24512,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-0d8ce95e"]]);
+}, [["__scopeId", "data-v-b22dc061"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46287,7 +46299,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.21.0";
+		this.version = "2.22.0-next.2";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];