superdoc 2.16.1-next.9 → 2.17.0

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.16.1-next.9",
+	superdocVersion: "2.17.0",
 	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.16.1-next.9",
+	superdocVersion: "2.17.0",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/types/clipboard.d.ts

@@ -34,6 +34,16 @@ export interface ClipboardParseOptions {
     maxDepth?: number;
 }
 export interface SDPasteRunMarks {
+    /** Complex-script bold state. */
+    boldCs?: boolean;
+    /** Complex-script italic state. */
+    italicCs?: boolean;
+    /** All-caps text transform. */
+    caps?: boolean;
+    /** Small-caps text transform. */
+    smallCaps?: boolean;
+    /** Complex-script font size in points. */
+    fontSizeCsPt?: number;
     bold?: boolean;
     italic?: boolean;
     underline?: boolean;
@@ -112,6 +122,14 @@ export type SDPasteInline = SDPasteLeafInline | {
     inlines: readonly SDPasteLeafInline[];
     tooltip?: string;
     sourcePath?: readonly (string | number)[];
+} | {
+    kind: 'footnoteRef';
+    noteId: string;
+    sourcePath?: readonly (string | number)[];
+} | {
+    kind: 'endnoteRef';
+    noteId: string;
+    sourcePath?: readonly (string | number)[];
 };
 export interface SDPasteParagraphBlock {
     kind: 'paragraph';

package/dist/layout-engine/layout-bridge/src/utf16-sha256.d.ts

@@ -0,0 +1,11 @@
+export declare class Utf16Sha256 {
+    private readonly state;
+    private readonly block;
+    private readonly words;
+    private readonly view;
+    private blockLength;
+    private totalBytes;
+    private finalized;
+    write(value: string): void;
+    digestHex(): string;
+}

package/dist/layout-engine/layout-engine/src/anchors.d.ts

@@ -42,6 +42,8 @@ export type AnchoredTableCollection = {
  */
 export declare function collectPreRegisteredAnchorsSteps(blocks: FlowBlock[], measures: Measure[], checkpointEveryBlocks?: number | null): Generator<LayoutWorkCheckpoint, AnchoredDrawing[], void>;
 export declare function collectPreRegisteredAnchors(blocks: FlowBlock[], measures: Measure[]): AnchoredDrawing[];
+/** Collect page- or margin-relative floating tables before paragraph layout. */
+export declare function collectPreRegisteredTablesSteps(blocks: FlowBlock[], measures: Measure[], checkpointEveryBlocks?: number | null): Generator<LayoutWorkCheckpoint, AnchoredTable[], void>;
 /**
  * Collect anchored drawings (images/drawings) mapped to their anchor paragraph index.
  * Map of paragraph block index -> anchored images/drawings associated with that paragraph.

package/dist/layout-engine/layout-engine/src/floating-table-anchor.d.ts

@@ -11,11 +11,16 @@ export type FloatingTableAnchorResolution = {
 };
 /** Width ratio for inline (paginated) layout vs single float fragment. */
 export declare const ANCHORED_TABLE_FULL_WIDTH_RATIO = 0.99;
+/**
+ * Word pins page-relative floating tables to the physical page instead of
+ * allowing a negative tblpY to clip the table above the page canvas.
+ */
+export declare function clampPageRelativeFloatingTableY(block: TableBlock, y: number): number;
 /**
  * True when an anchored table should paginate inline instead of as one float fragment.
  * Uses tbl width, flow-affecting wrap distances from w:tblpPr, and table indent — not a fixed px fudge factor.
  */
-export declare function isAnchoredTableFullWidth(block: TableBlock, measure: TableMeasure, columnWidth: number): boolean;
+export declare function isAnchoredTableFullWidth(block: TableBlock, measure: TableMeasure, columnWidth: number, pageHeight?: number): boolean;
 /**
  * Resolve anchor paragraph + vertical offset for a block-level floating table.
  */

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

@@ -39,6 +39,8 @@ export type LayoutOptions = {
     remeasureParagraph?: (block: ParagraphBlock, maxWidth: number, firstLineIndent?: number, lineRegions?: readonly (readonly ParagraphLineRegion[])[]) => ParagraphMeasure;
     /** @internal Positioned paragraph frames that render without advancing the story cursor. */
     nonFlowPositionedParagraphFrameIds?: ReadonlySet<string>;
+    /** @internal Physical page height used for page-relative tables laid out on a synthetic region canvas. */
+    pagePositionedTableFitHeight?: number;
     sectionMetadata?: SectionMetadata[];
     /**
      * Extra bottom margin per page index (0-based) reserved for non-body content

package/dist/layout-engine/layout-engine/src/layout-paragraph.d.ts

@@ -102,6 +102,7 @@ export type ParagraphAnchorsContext = {
     columnWidth: number;
     pageWidth: number;
     pageMargins: PageMargins;
+    pagePositionedTableFitHeight?: number;
     columns: ColumnLayoutForAnchor;
     placedAnchoredIds: Set<string>;
 };

package/dist/layout-engine/layout-engine/src/layout-table.d.ts

@@ -5,6 +5,7 @@ export type TableLayoutContext = {
     block: TableBlock;
     measure: TableMeasure;
     columnWidth: number;
+    pagePositionedTableFitHeight?: number;
     ensurePage: () => PageState;
     advanceColumn: (state: PageState) => PageState;
     columnX: (state: PageState, columnIndex?: number) => number;
@@ -90,7 +91,7 @@ export declare function generateFragmentMetadata(measure: TableMeasure, block: T
  * @param context - Table layout context
 
  */
-export declare function layoutTableBlockSteps({ block, measure, columnWidth, ensurePage, advanceColumn, columnX, resumeCursor, onFragmentStart, }: TableLayoutContext): Generator<TableLayoutStep, void, void>;
+export declare function layoutTableBlockSteps({ block, measure, columnWidth, pagePositionedTableFitHeight, ensurePage, advanceColumn, columnX, resumeCursor, onFragmentStart, }: TableLayoutContext): Generator<TableLayoutStep, void, void>;
 export declare function layoutTableBlock(context: TableLayoutContext): void;
 /**
  * Create a table fragment for an anchored/floating table at its computed position.

package/dist/superdoc/src/core/helpers/font-diagnostics.d.ts

@@ -0,0 +1 @@
+export declare function warnForMissingDocumentFonts(missingFonts: readonly string[] | undefined, warnedFonts: Set<string>, hostname?: string): void;

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

@@ -4311,7 +4311,7 @@ export interface Config {
     proofing?: ProofingConfig;
     /**
      * Font system configuration. The reviewed fallback pack ships in the optional
-     * `@superdoc-dev/fonts` package: pass `superdocFonts` (bundler) or the `SuperDocFonts`
+     * `@superdoc/fonts` package: pass `superdocFonts` (bundler) or the `SuperDocFonts`
      * global from its `superdoc-fonts.min.js` browser build (CDN). To self-host, set
      * `fonts.assetBaseUrl` (e.g. `/fonts/` or a CDN URL) or `fonts.resolveAssetUrl` for
      * signed/versioned hosting. Core ships no document families, so with none configured the

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.16.1-next.9";
+		return "2.17.0";
 	} catch {
 		return "unknown";
 	}
@@ -38514,6 +38514,21 @@ function normalizeSurfacesConfig(config = {}) {
 	};
 }
 //#endregion
+//#region src/core/helpers/font-diagnostics.ts
+var FONT_GUIDE_URL = "https://docs.superdoc.dev/editor/fonts/";
+function isLocalDevelopmentHost(hostname) {
+	return hostname === "localhost" || hostname.endsWith(".localhost") || hostname === "0.0.0.0" || hostname === "::1" || hostname === "[::1]" || hostname.startsWith("127.");
+}
+function warnForMissingDocumentFonts(missingFonts, warnedFonts, hostname = typeof window === "undefined" ? "" : window.location.hostname) {
+	if (!isLocalDevelopmentHost(hostname) || !Array.isArray(missingFonts)) return;
+	const newlyMissing = [...new Set(missingFonts.map((font) => font.trim()).filter(Boolean))].filter((font) => !warnedFonts.has(font));
+	if (newlyMissing.length === 0) return;
+	for (const font of newlyMissing) warnedFonts.add(font);
+	const noun = newlyMissing.length === 1 ? "font" : "fonts";
+	const names = newlyMissing.map((font) => `"${font}"`).join(", ");
+	console.warn(`[SuperDoc] Missing document ${noun}: ${names}. The browser is using fallback fonts, which can change line and page breaks. Configure document fonts: ${FONT_GUIDE_URL}`);
+}
+//#endregion
 //#region src/core/editor-runtime/editor-runtime-registry.ts
 /**
 * Internal SuperDoc registry of mounted editor runtimes and the active-runtime
@@ -45615,6 +45630,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			useLayoutEngine: true
 		};
 		this.#fontsRelayEditors = /* @__PURE__ */ new WeakSet();
+		this.#warnedMissingFonts = /* @__PURE__ */ new WeakMap();
 		this.#lastFontsChangedPayload = null;
 		this.#fontsApi = null;
 		this.#v2FontsUnsub = null;
@@ -45710,7 +45726,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.16.1-next.9";
+		this.version = "2.17.0";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -46704,6 +46720,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	}
 	/** Editors whose `fonts-changed` we already relay, so a repeated create wires once. */
 	#fontsRelayEditors;
+	#warnedMissingFonts;
 	/**
 	* Relay an editor's authoritative `fonts-changed` up to the SuperDoc surface, so
 	* `superdoc.on('fonts-changed')` / `onFontsChanged` fire without the legacy
@@ -46719,10 +46736,10 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		if (this.#fontsRelayEditors.has(editor)) return;
 		this.#fontsRelayEditors.add(editor);
 		editor.on("fonts-changed", (payload) => {
-			if (this.#fontReportSurfaces(editor)) this.#deliverFontsChanged(payload);
+			if (this.#fontReportSurfaces(editor)) this.#deliverFontsChanged(editor, payload);
 		});
 		const cached = (editor.documentRenderer ?? editor["presentationEditor"])?.getLastFontsChangedPayload?.();
-		if (cached && this.#fontReportSurfaces(editor)) this.#deliverFontsChanged(cached);
+		if (cached && this.#fontReportSurfaces(editor)) this.#deliverFontsChanged(editor, cached);
 	}
 	/**
 	* Whether a wired editor's font report may surface on the SuperDoc instance. Only the
@@ -46738,8 +46755,16 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	/** Last font report delivered on this instance, so `fonts.onReport` can replay it. */
 	#lastFontsChangedPayload;
 	/** Cache then emit a font report, so a later `onReport` subscriber gets the current one. */
-	#deliverFontsChanged(payload) {
+	#deliverFontsChanged(editor, payload) {
 		this.#lastFontsChangedPayload = payload;
+		if (editor.editorVersion === 2) {
+			let warnedFonts = this.#warnedMissingFonts.get(editor);
+			if (!warnedFonts) {
+				warnedFonts = /* @__PURE__ */ new Set();
+				this.#warnedMissingFonts.set(editor, warnedFonts);
+			}
+			warnForMissingDocumentFonts(payload.missingFonts, warnedFonts);
+		}
 		this.emit("fonts-changed", payload);
 	}
 	/**
@@ -46837,10 +46862,10 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	#wireV2FontsRelay(facade) {
 		this.#teardownV2FontsRelay();
 		const runtime = getActiveFontRuntime(facade);
-		if (!runtime?.onChanged) return;
+		if (!facade || !runtime?.onChanged) return;
 		const current = runtime.getLastFontsChangedPayload?.();
-		if (current) this.#deliverFontsChanged(current);
-		this.#v2FontsUnsub = runtime.onChanged((payload) => this.#deliverFontsChanged(payload));
+		if (current) this.#deliverFontsChanged(facade, current);
+		this.#v2FontsUnsub = runtime.onChanged((payload) => this.#deliverFontsChanged(facade, payload));
 	}
 	/**
 	* Reconcile the compatibility `activeEditor` projection with a registry

package/dist/superdoc.es.js

@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.16.1-next.9";
+		return "2.17.0";
 	} catch {
 		return "unknown";
 	}
@@ -38474,6 +38474,21 @@ function normalizeSurfacesConfig(config = {}) {
 	};
 }
 //#endregion
+//#region src/core/helpers/font-diagnostics.ts
+var FONT_GUIDE_URL = "https://docs.superdoc.dev/editor/fonts/";
+function isLocalDevelopmentHost(hostname) {
+	return hostname === "localhost" || hostname.endsWith(".localhost") || hostname === "0.0.0.0" || hostname === "::1" || hostname === "[::1]" || hostname.startsWith("127.");
+}
+function warnForMissingDocumentFonts(missingFonts, warnedFonts, hostname = typeof window === "undefined" ? "" : window.location.hostname) {
+	if (!isLocalDevelopmentHost(hostname) || !Array.isArray(missingFonts)) return;
+	const newlyMissing = [...new Set(missingFonts.map((font) => font.trim()).filter(Boolean))].filter((font) => !warnedFonts.has(font));
+	if (newlyMissing.length === 0) return;
+	for (const font of newlyMissing) warnedFonts.add(font);
+	const noun = newlyMissing.length === 1 ? "font" : "fonts";
+	const names = newlyMissing.map((font) => `"${font}"`).join(", ");
+	console.warn(`[SuperDoc] Missing document ${noun}: ${names}. The browser is using fallback fonts, which can change line and page breaks. Configure document fonts: ${FONT_GUIDE_URL}`);
+}
+//#endregion
 //#region src/core/editor-runtime/editor-runtime-registry.ts
 /**
 * Internal SuperDoc registry of mounted editor runtimes and the active-runtime
@@ -45546,6 +45561,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 			useLayoutEngine: true
 		};
 		this.#fontsRelayEditors = /* @__PURE__ */ new WeakSet();
+		this.#warnedMissingFonts = /* @__PURE__ */ new WeakMap();
 		this.#lastFontsChangedPayload = null;
 		this.#fontsApi = null;
 		this.#v2FontsUnsub = null;
@@ -45641,7 +45657,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.16.1-next.9";
+		this.version = "2.17.0";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -46635,6 +46651,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 	}
 	/** Editors whose `fonts-changed` we already relay, so a repeated create wires once. */
 	#fontsRelayEditors;
+	#warnedMissingFonts;
 	/**
 	* Relay an editor's authoritative `fonts-changed` up to the SuperDoc surface, so
 	* `superdoc.on('fonts-changed')` / `onFontsChanged` fire without the legacy
@@ -46650,10 +46667,10 @@ var SuperDoc = class extends import_eventemitter3.default {
 		if (this.#fontsRelayEditors.has(editor)) return;
 		this.#fontsRelayEditors.add(editor);
 		editor.on("fonts-changed", (payload) => {
-			if (this.#fontReportSurfaces(editor)) this.#deliverFontsChanged(payload);
+			if (this.#fontReportSurfaces(editor)) this.#deliverFontsChanged(editor, payload);
 		});
 		const cached = (editor.documentRenderer ?? editor["presentationEditor"])?.getLastFontsChangedPayload?.();
-		if (cached && this.#fontReportSurfaces(editor)) this.#deliverFontsChanged(cached);
+		if (cached && this.#fontReportSurfaces(editor)) this.#deliverFontsChanged(editor, cached);
 	}
 	/**
 	* Whether a wired editor's font report may surface on the SuperDoc instance. Only the
@@ -46669,8 +46686,16 @@ var SuperDoc = class extends import_eventemitter3.default {
 	/** Last font report delivered on this instance, so `fonts.onReport` can replay it. */
 	#lastFontsChangedPayload;
 	/** Cache then emit a font report, so a later `onReport` subscriber gets the current one. */
-	#deliverFontsChanged(payload) {
+	#deliverFontsChanged(editor, payload) {
 		this.#lastFontsChangedPayload = payload;
+		if (editor.editorVersion === 2) {
+			let warnedFonts = this.#warnedMissingFonts.get(editor);
+			if (!warnedFonts) {
+				warnedFonts = /* @__PURE__ */ new Set();
+				this.#warnedMissingFonts.set(editor, warnedFonts);
+			}
+			warnForMissingDocumentFonts(payload.missingFonts, warnedFonts);
+		}
 		this.emit("fonts-changed", payload);
 	}
 	/**
@@ -46768,10 +46793,10 @@ var SuperDoc = class extends import_eventemitter3.default {
 	#wireV2FontsRelay(facade) {
 		this.#teardownV2FontsRelay();
 		const runtime = getActiveFontRuntime(facade);
-		if (!runtime?.onChanged) return;
+		if (!facade || !runtime?.onChanged) return;
 		const current = runtime.getLastFontsChangedPayload?.();
-		if (current) this.#deliverFontsChanged(current);
-		this.#v2FontsUnsub = runtime.onChanged((payload) => this.#deliverFontsChanged(payload));
+		if (current) this.#deliverFontsChanged(facade, current);
+		this.#v2FontsUnsub = runtime.onChanged((payload) => this.#deliverFontsChanged(facade, payload));
 	}
 	/**
 	* Reconcile the compatibility `activeEditor` projection with a registry