@harbour-enterprises/superdoc 1.18.0-next.23 → 1.18.0-next.24

package/dist/chunks/{SuperConverter-BbWMX2Yr.cjs → SuperConverter-DvMtX0CH.cjs}

@@ -59364,7 +59364,7 @@ var SuperConverter = class SuperConverter {
 	static getStoredSuperdocVersion(docx) {
 		return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
 	}
-	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.18.0-next.23") {
+	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.18.0-next.24") {
 		return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version, false);
 	}
 	static generateWordTimestamp() {

package/dist/chunks/{SuperConverter-DAG0cqbz.es.js → SuperConverter-IgiRNOfZ.es.js}

@@ -58060,7 +58060,7 @@ var SuperConverter = class SuperConverter {
 	static getStoredSuperdocVersion(docx) {
 		return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
 	}
-	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.18.0-next.23") {
+	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.18.0-next.24") {
 		return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version, false);
 	}
 	static generateWordTimestamp() {

package/dist/chunks/{src-C_BYlKtR.cjs → src-C9-llU1u.cjs}

@@ -1,5 +1,5 @@
 const require_rolldown_runtime = require("./rolldown-runtime-Dp2H1eGw.cjs");
-const require_SuperConverter = require("./SuperConverter-BbWMX2Yr.cjs");
+const require_SuperConverter = require("./SuperConverter-DvMtX0CH.cjs");
 const require_jszip = require("./jszip-DCT9QYaK.cjs");
 const require_uuid = require("./uuid-BZOhSkTa.cjs");
 const require_constants = require("./constants-7MkJJnfa.cjs");
@@ -264,7 +264,7 @@ var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 const COMMUNITY_LICENSE_KEY = "community-and-eval-agplv3";
 function getSuperdocVersion() {
 	try {
-		return "1.18.0-next.23";
+		return "1.18.0-next.24";
 	} catch {
 		return "unknown";
 	}
@@ -21210,7 +21210,7 @@ const canUseDOM = () => {
 		return false;
 	}
 };
-var summaryVersion = "1.18.0-next.23";
+var summaryVersion = "1.18.0-next.24";
 var nodeKeys = [
 	"group",
 	"content",
@@ -39527,7 +39527,7 @@ var Editor = class Editor extends EventEmitter$1 {
 		return migrations.length > 0;
 	}
 	processCollaborationMigrations() {
-		console.debug("[checkVersionMigrations] Current editor version", "1.18.0-next.23");
+		console.debug("[checkVersionMigrations] Current editor version", "1.18.0-next.24");
 		if (!this.options.ydoc) return;
 		let docVersion = this.options.ydoc.getMap("meta").get("version");
 		if (!docVersion) docVersion = "initial";

package/dist/chunks/{src-Bdcvgeb3.es.js → src-bVAmi6lL.es.js}

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, n as __esmMin, r as __export, t as __commonJSMin } from "./rolldown-runtime-B2q5OVn9.es.js";
-import { $ as getSchemaTypeByName, $t as INLINE_PROPERTY_BY_KEY, A as insertNewRelationship, At as resolveDocxFontFamily, B as getMarksFromSelection, Bt as getUnderlineCssString, C as calculateResolvedParagraphProperties, Ct as generateDocxRandomId, D as clampRange, Dt as encodeCSSFromRPr, E as generateOrderedListIndex, Et as encodeCSSFromPPr, F as isInTable, Ft as TABLE_FALLBACK_BORDERS, G as getMarkRange, Gt as createDocumentApi, H as isNodeActive, Ht as TrackFormatMarkName, I as posToDOMRect, It as TABLE_FALLBACK_CELL_PADDING, J as findParentNodeClosestToPos, Jt as PUBLIC_MUTATION_STEP_OP_IDS, K as isTextSelection, Kt as derivePropertyStateFromDirect, L as findChildren$1, Lt as isKnownTableStyleId, M as encodeTooltip, Mt as resolveRunProperties, N as sanitizeHref, Nt as resolveTableCellProperties, O as collectChangedRangesThroughTransactions, Ot as encodeMarksFromRPr, P as CommandService, Pt as resolveTableProperties, Q as cleanSchemaItem, Qt as OPERATION_IDS, R as getActiveFormatting, Rt as resolveExistingTableEffectiveStyleId, S as isList, St as isLegacySchemaDefaultBorders, T as docxNumberingHelpers, Tt as decodeRPrFromMarks, U as getSchemaTypeNameByName, Ut as TrackInsertMarkName, V as isActive, Vt as TrackDeleteMarkName, W as isMarkActive, Wt as carbonCopy, X as getMarkType, Xt as PROPERTY_REGISTRY, Y as defaultBlockAt$1, Yt as isPublicMutationStepOp, Z as getNodeType, Zt as COMMAND_CATALOG, _ as ListHelpers, _n as Slice, _t as dropPoint, a as helpers_exports, an as buildResolvedHandle, at as PluginKey, b as changeListLevel, bn as getExtensionConfigField, bt as replaceStep$1, c as createDocFromMarkdown, cn as MAX_PLAN_RESOLVED_TARGETS, ct as TextSelection$1, d as createDocFromHTML, dn as DELETABLE_BLOCK_NODE_TYPES, dt as RemoveMarkStep, en as INLINE_PROPERTY_KEY_SET, et as createDocument, f as InputRule, fn as DOMParser$1, ft as ReplaceAroundStep$1, g as unflattenListsInHtml, gn as Schema$1, gt as canSplit, h as inputRulesPlugin, hn as Mark$1, ht as canJoin, i as translator$1, in as buildDiscoveryResult, it as Plugin, j as UrlValidationConstants, jt as resolveParagraphProperties, k as mergeRanges, kt as DEFAULT_TBL_LOOK, l as markdownToPmFragment, ln as MAX_PLAN_STEPS, lt as AddMarkStep, m as htmlHandler, mn as Fragment$1, mt as Transform, n as kebabCase$1, nn as DocumentApiValidationError, nt as EditorState, o as updateDOMAttributes, on as SNIPPET_CONTEXT_CHARS, ot as Selection, p as handleClipboardPaste, pn as DOMSerializer, pt as ReplaceStep, q as findParentNode, qt as CAPABILITY_REASON_CODES, rn as buildDiscoveryItem, rt as NodeSelection, s as processContent, sn as SNIPPET_MAX_LENGTH, st as SelectionRange, t as SuperConverter, tn as INLINE_PROPERTY_REGISTRY, tt as AllSelection, u as readImageDimensionsFromDataUri, un as MARK_KEYS, ut as Mapping, v as removeLvlOverride, vn as minMax, vt as joinPoint, w as getResolvedParagraphProperties, wt as generateRandomSigned32BitIntStrId, x as updateNumberingProperties, xt as convertBordersToOoxmlFormat, y as translator, yn as callOrGet, yt as liftTarget, z as findMark$1, zt as resolvePreferredNewTableStyleId } from "./SuperConverter-DAG0cqbz.es.js";
+import { $ as getSchemaTypeByName, $t as INLINE_PROPERTY_BY_KEY, A as insertNewRelationship, At as resolveDocxFontFamily, B as getMarksFromSelection, Bt as getUnderlineCssString, C as calculateResolvedParagraphProperties, Ct as generateDocxRandomId, D as clampRange, Dt as encodeCSSFromRPr, E as generateOrderedListIndex, Et as encodeCSSFromPPr, F as isInTable, Ft as TABLE_FALLBACK_BORDERS, G as getMarkRange, Gt as createDocumentApi, H as isNodeActive, Ht as TrackFormatMarkName, I as posToDOMRect, It as TABLE_FALLBACK_CELL_PADDING, J as findParentNodeClosestToPos, Jt as PUBLIC_MUTATION_STEP_OP_IDS, K as isTextSelection, Kt as derivePropertyStateFromDirect, L as findChildren$1, Lt as isKnownTableStyleId, M as encodeTooltip, Mt as resolveRunProperties, N as sanitizeHref, Nt as resolveTableCellProperties, O as collectChangedRangesThroughTransactions, Ot as encodeMarksFromRPr, P as CommandService, Pt as resolveTableProperties, Q as cleanSchemaItem, Qt as OPERATION_IDS, R as getActiveFormatting, Rt as resolveExistingTableEffectiveStyleId, S as isList, St as isLegacySchemaDefaultBorders, T as docxNumberingHelpers, Tt as decodeRPrFromMarks, U as getSchemaTypeNameByName, Ut as TrackInsertMarkName, V as isActive, Vt as TrackDeleteMarkName, W as isMarkActive, Wt as carbonCopy, X as getMarkType, Xt as PROPERTY_REGISTRY, Y as defaultBlockAt$1, Yt as isPublicMutationStepOp, Z as getNodeType, Zt as COMMAND_CATALOG, _ as ListHelpers, _n as Slice, _t as dropPoint, a as helpers_exports, an as buildResolvedHandle, at as PluginKey, b as changeListLevel, bn as getExtensionConfigField, bt as replaceStep$1, c as createDocFromMarkdown, cn as MAX_PLAN_RESOLVED_TARGETS, ct as TextSelection$1, d as createDocFromHTML, dn as DELETABLE_BLOCK_NODE_TYPES, dt as RemoveMarkStep, en as INLINE_PROPERTY_KEY_SET, et as createDocument, f as InputRule, fn as DOMParser$1, ft as ReplaceAroundStep$1, g as unflattenListsInHtml, gn as Schema$1, gt as canSplit, h as inputRulesPlugin, hn as Mark$1, ht as canJoin, i as translator$1, in as buildDiscoveryResult, it as Plugin, j as UrlValidationConstants, jt as resolveParagraphProperties, k as mergeRanges, kt as DEFAULT_TBL_LOOK, l as markdownToPmFragment, ln as MAX_PLAN_STEPS, lt as AddMarkStep, m as htmlHandler, mn as Fragment$1, mt as Transform, n as kebabCase$1, nn as DocumentApiValidationError, nt as EditorState, o as updateDOMAttributes, on as SNIPPET_CONTEXT_CHARS, ot as Selection, p as handleClipboardPaste, pn as DOMSerializer, pt as ReplaceStep, q as findParentNode, qt as CAPABILITY_REASON_CODES, rn as buildDiscoveryItem, rt as NodeSelection, s as processContent, sn as SNIPPET_MAX_LENGTH, st as SelectionRange, t as SuperConverter, tn as INLINE_PROPERTY_REGISTRY, tt as AllSelection, u as readImageDimensionsFromDataUri, un as MARK_KEYS, ut as Mapping, v as removeLvlOverride, vn as minMax, vt as joinPoint, w as getResolvedParagraphProperties, wt as generateRandomSigned32BitIntStrId, x as updateNumberingProperties, xt as convertBordersToOoxmlFormat, y as translator, yn as callOrGet, yt as liftTarget, z as findMark$1, zt as resolvePreferredNewTableStyleId } from "./SuperConverter-IgiRNOfZ.es.js";
 import { a as init_dist$2, i as global, n as init_dist, o as Buffer$3, r as process$1, s as init_dist$1 } from "./jszip-ChlR43oI.es.js";
 import { n as v4_default } from "./uuid-qzgm05fK.es.js";
 import { A as ptToTwips, C as linesToTwips, D as pixelsToTwips, F as twipsToInches, I as twipsToLines, L as twipsToPixels, b as inchesToPixels, c as convertSizeToCSS, h as getArrayBufferFromUrl, j as resolveOpcTargetPath, t as COMMENT_FILE_BASENAMES, x as inchesToTwips, y as halfPointToPoints } from "./constants-CMPtQbp7.es.js";
@@ -263,7 +263,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "1.18.0-next.23";
+		return "1.18.0-next.24";
 	} catch {
 		return "unknown";
 	}
@@ -21191,7 +21191,7 @@ const canUseDOM = () => {
 		return false;
 	}
 };
-var summaryVersion = "1.18.0-next.23";
+var summaryVersion = "1.18.0-next.24";
 var nodeKeys = [
 	"group",
 	"content",
@@ -39504,7 +39504,7 @@ var Editor = class Editor extends EventEmitter$1 {
 		return migrations.length > 0;
 	}
 	processCollaborationMigrations() {
-		console.debug("[checkVersionMigrations] Current editor version", "1.18.0-next.23");
+		console.debug("[checkVersionMigrations] Current editor version", "1.18.0-next.24");
 		if (!this.options.ydoc) return;
 		let docVersion = this.options.ydoc.getMap("meta").get("version");
 		if (!docVersion) docVersion = "initial";

package/dist/super-editor/converter.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../chunks/rolldown-runtime-Dp2H1eGw.cjs");
-const require_SuperConverter = require("../chunks/SuperConverter-BbWMX2Yr.cjs");
+const require_SuperConverter = require("../chunks/SuperConverter-DvMtX0CH.cjs");
 require("../chunks/jszip-DCT9QYaK.cjs");
 require("../chunks/xml-js--DznO7Gk.cjs");
 require("../chunks/constants-7MkJJnfa.cjs");

package/dist/super-editor/converter.es.js

@@ -1,4 +1,4 @@
-import { t as SuperConverter } from "../chunks/SuperConverter-DAG0cqbz.es.js";
+import { t as SuperConverter } from "../chunks/SuperConverter-IgiRNOfZ.es.js";
 import "../chunks/jszip-ChlR43oI.es.js";
 import "../chunks/xml-js-DLE8mr0n.es.js";
 import "../chunks/constants-CMPtQbp7.es.js";

package/dist/super-editor/src/index.d.ts

@@ -1,6 +1,12 @@
-import { EditorView } from 'prosemirror-view';
-import { EditorState, Transaction } from 'prosemirror-state';
-import { Schema, Node as ProseMirrorNode, Mark as ProseMirrorMark } from 'prosemirror-model';
+/**
+ * Main type declarations for @superdoc/super-editor
+ * This file provides TypeScript types for the JavaScript exports in index.js
+ */
+
+export type { EditorView } from 'prosemirror-view';
+export type { EditorState, Transaction } from 'prosemirror-state';
+export type { Schema } from 'prosemirror-model';
+
 // ============================================
 // COMMAND TYPES (inlined from ChainedCommands.ts)
 // ============================================
@@ -152,6 +158,255 @@ export interface OpenOptions {
   fonts?: Record<string, unknown>;
 }
 
+// ============================================
+// PRESENTATION EDITOR TYPES
+// ============================================
+
+/** Page dimensions in points (72 points = 1 inch) */
+export interface PageSize {
+  /** Width in points */
+  w: number;
+  /** Height in points */
+  h: number;
+}
+
+/** Page margin configuration in points */
+export interface PageMargins {
+  top?: number;
+  right?: number;
+  bottom?: number;
+  left?: number;
+  header?: number;
+  footer?: number;
+}
+
+/** Virtualization options for large documents */
+export interface VirtualizationOptions {
+  enabled?: boolean;
+  window?: number;
+  overscan?: number;
+  gap?: number;
+  paddingTop?: number;
+}
+
+/** Tracked changes display mode */
+export type TrackedChangesMode = 'review' | 'original' | 'final' | 'off';
+
+/** Override tracked changes behavior */
+export interface TrackedChangesOverrides {
+  mode?: TrackedChangesMode;
+  enabled?: boolean;
+}
+
+/** Layout mode for page rendering */
+export type LayoutMode = 'vertical' | 'horizontal';
+
+/** Remote user presence information */
+export interface RemoteUserInfo {
+  name?: string;
+  email?: string;
+  color: string;
+}
+
+/** Remote cursor state for collaboration */
+export interface RemoteCursorState {
+  clientId: number;
+  user: RemoteUserInfo;
+  anchor: number;
+  head: number;
+  updatedAt: number;
+}
+
+/** Presence rendering options */
+export interface PresenceOptions {
+  enabled?: boolean;
+  showLabels?: boolean;
+  maxVisible?: number;
+  labelFormatter?: (user: RemoteUserInfo) => string;
+  highlightOpacity?: number;
+  staleTimeout?: number;
+}
+
+/** Layout engine configuration */
+export interface LayoutEngineOptions {
+  pageSize?: PageSize;
+  margins?: PageMargins;
+  zoom?: number;
+  virtualization?: VirtualizationOptions;
+  pageStyles?: Record<string, unknown>;
+  debugLabel?: string;
+  layoutMode?: LayoutMode;
+  trackedChanges?: TrackedChangesOverrides;
+  emitCommentPositionsInViewing?: boolean;
+  enableCommentsInViewing?: boolean;
+  presence?: PresenceOptions;
+  ruler?: {
+    enabled?: boolean;
+    interactive?: boolean;
+    onMarginChange?: (side: 'left' | 'right', marginInches: number) => void;
+  };
+}
+
+/** Options for creating a PresentationEditor instance */
+export interface PresentationEditorOptions {
+  /** Host element where the layout-engine powered UI should render (required) */
+  element: HTMLElement;
+  /** Layout-specific configuration */
+  layoutEngineOptions?: LayoutEngineOptions;
+  /** Document mode: 'editing', 'viewing', or 'suggesting' */
+  documentMode?: 'editing' | 'viewing' | 'suggesting';
+  /** Collaboration provider with awareness support */
+  collaborationProvider?: {
+    awareness?: unknown;
+    disconnect?: () => void;
+  } | null;
+  /** Whether to disable the context menu */
+  disableContextMenu?: boolean;
+  /** Document content */
+  content?: string | object;
+  /** Editor extensions */
+  extensions?: any[];
+  /** Whether the editor is editable */
+  editable?: boolean;
+  /** Additional options passed to the underlying Editor */
+  [key: string]: any;
+}
+
+/** Layout error information */
+export interface LayoutError {
+  phase: 'initialization' | 'render';
+  error: Error;
+  timestamp: number;
+}
+
+/** Rectangle with page context */
+export interface RangeRect {
+  pageIndex: number;
+  left: number;
+  right: number;
+  top: number;
+  bottom: number;
+  width: number;
+  height: number;
+}
+
+/** Layout metrics for telemetry */
+export interface LayoutMetrics {
+  durationMs: number;
+  blockCount: number;
+  pageCount: number;
+}
+
+/** Position hit result from coordinate mapping */
+export interface PositionHit {
+  pos: number;
+  layoutEpoch: number;
+  blockId: string;
+  pageIndex: number;
+  column: number;
+  lineIndex: number;
+}
+
+/** Bounding rectangle dimensions */
+export interface BoundingRect {
+  top: number;
+  left: number;
+  bottom: number;
+  right: number;
+  width: number;
+  height: number;
+}
+
+/** A fragment positioned on a page */
+export interface LayoutFragment {
+  pmStart: number;
+  pmEnd: number;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  blockId: string;
+  column?: number;
+}
+
+/** A rendered page in the layout */
+export interface LayoutPage {
+  number: number;
+  fragments: LayoutFragment[];
+  margins?: PageMargins;
+  size?: PageSize;
+  orientation?: 'portrait' | 'landscape';
+  sectionIndex?: number;
+  footnoteReserved?: number;
+}
+
+/** Final layout output from the layout engine */
+export interface Layout {
+  pageSize: PageSize;
+  pages: LayoutPage[];
+  pageGap?: number;
+  layoutEpoch?: number;
+}
+
+/** A block in the flow document model */
+export interface FlowBlock {
+  id: string;
+  type: string;
+  pmStart: number;
+  pmEnd: number;
+  [key: string]: unknown;
+}
+
+/** Measurement data for a block */
+export interface Measure {
+  blockId: string;
+  width: number;
+  height: number;
+  lines?: Array<{
+    width: number;
+    ascent: number;
+    descent: number;
+    lineHeight: number;
+  }>;
+  [key: string]: unknown;
+}
+
+/** Section metadata for multi-section documents */
+export interface SectionMetadata {
+  sectionIndex: number;
+  startPage: number;
+  endPage: number;
+  [key: string]: unknown;
+}
+
+/** Paint snapshot for debugging/testing */
+export interface PaintSnapshot {
+  formatVersion: 1;
+  pageCount: number;
+  lineCount: number;
+  markerCount: number;
+  tabCount: number;
+  pages: Array<{
+    index: number;
+    pageNumber?: number;
+    lineCount: number;
+    lines: Array<{
+      index: number;
+      inTableFragment: boolean;
+      inTableParagraph: boolean;
+      style: Record<string, unknown>;
+    }>;
+  }>;
+}
+
+/** Payload for layout update events */
+export interface LayoutUpdatePayload {
+  blocks: FlowBlock[];
+  measures: Measure[];
+  layout: Layout;
+  metrics?: LayoutMetrics;
+}
+
 // ============================================
 // EDITOR CLASS
 // ============================================
@@ -309,13 +564,333 @@ export declare class SuperToolbar {
   [key: string]: any;
 }
 
+/**
+ * PresentationEditor provides a paginated, layout-engine-powered editing experience.
+ * It wraps a hidden ProseMirror Editor and renders via the layout engine pipeline.
+ */
 export declare class PresentationEditor {
-  /** Get the painted DOM element for a document position (body only) */
-  getElementAtPos?: (
+  /**
+   * Creates a new PresentationEditor instance.
+   * @param options - Configuration options including the host element
+   */
+  constructor(options: PresentationEditorOptions);
+
+  /**
+   * Get a PresentationEditor instance by document ID.
+   */
+  static getInstance(documentId: string): PresentationEditor | undefined;
+
+  /**
+   * Set zoom globally across all PresentationEditor instances.
+   */
+  static setGlobalZoom(zoom: number): void;
+
+  // ============================================
+  // Public Getters
+  // ============================================
+
+  /** The underlying ProseMirror Editor instance */
+  readonly editor: Editor;
+
+  /** The visible host element where the editor is rendered */
+  readonly element: HTMLElement;
+
+  /** Command service for the currently active editor (body or header/footer) */
+  readonly commands: EditorCommands;
+
+  /** ProseMirror editor state for the currently active editor */
+  readonly state: EditorState;
+
+  /** Whether the active editor accepts input */
+  readonly isEditable: boolean;
+
+  /** Editor options for the currently active editor */
+  readonly options: Record<string, any>;
+
+  /** The visible host container element */
+  readonly visibleHost: HTMLElement;
+
+  /** Selection overlay element for caret and highlight rendering */
+  readonly overlayElement: HTMLElement | null;
+
+  /** Current zoom level (1 = 100%) */
+  readonly zoom: number;
+
+  // ============================================
+  // Public Methods
+  // ============================================
+
+  /**
+   * Dispatch a ProseMirror transaction to the currently active editor.
+   */
+  dispatch(tr: Transaction): void;
+
+  /**
+   * Focus the editor.
+   */
+  focus(): void;
+
+  /**
+   * Returns the currently active editor (body or header/footer session).
+   */
+  getActiveEditor(): Editor;
+
+  /**
+   * Undo the last action in the active editor.
+   */
+  undo(): boolean;
+
+  /**
+   * Redo the last undone action in the active editor.
+   */
+  redo(): boolean;
+
+  /**
+   * Run a callback against the active editor.
+   */
+  dispatchInActiveEditor(callback: (editor: Editor) => void): void;
+
+  /**
+   * Set the document mode and update editor editability.
+   * @param mode - 'editing', 'viewing', or 'suggesting'
+   */
+  setDocumentMode(mode: 'editing' | 'viewing' | 'suggesting'): void;
+
+  /**
+   * Override tracked-changes rendering preferences.
+   */
+  setTrackedChangesOverrides(overrides?: TrackedChangesOverrides): void;
+
+  /**
+   * Update viewing-mode comment rendering behavior.
+   */
+  setViewingCommentOptions(options?: {
+    emitCommentPositionsInViewing?: boolean;
+    enableCommentsInViewing?: boolean;
+  }): void;
+
+  /**
+   * Toggle the custom context menu.
+   */
+  setContextMenuDisabled(disabled: boolean): void;
+
+  /**
+   * Subscribe to layout update events. Returns an unsubscribe function.
+   */
+  onLayoutUpdated(handler: (payload: LayoutUpdatePayload) => void): () => void;
+
+  /**
+   * Subscribe to layout error events. Returns an unsubscribe function.
+   */
+  onLayoutError(handler: (error: LayoutError) => void): () => void;
+
+  /**
+   * Get the rendered pages.
+   */
+  getPages(): LayoutPage[];
+
+  /**
+   * Get the most recent layout error (if any).
+   */
+  getLayoutError(): LayoutError | null;
+
+  /**
+   * Check if layout is healthy.
+   */
+  isLayoutHealthy(): boolean;
+
+  /**
+   * Get detailed layout health state.
+   */
+  getLayoutHealthState(): 'healthy' | 'degraded' | 'failed';
+
+  /**
+   * Get layout-relative rects for the current document selection.
+   */
+  getSelectionRects(relativeTo?: HTMLElement): RangeRect[];
+
+  /**
+   * Convert a document range into layout-based bounding rects.
+   */
+  getRangeRects(from: number, to: number, relativeTo?: HTMLElement): RangeRect[];
+
+  /**
+   * Get bounds for a document range.
+   */
+  getSelectionBounds(
+    from: number,
+    to: number,
+    relativeTo?: HTMLElement,
+  ): {
+    bounds: BoundingRect;
+    rects: RangeRect[];
+    pageIndex: number;
+  } | null;
+
+  /**
+   * Remap comment positions to layout coordinates with bounds and rects.
+   */
+  getCommentBounds(
+    positions: Record<string, { start?: number; end?: number; pos?: number; [key: string]: unknown }>,
+    relativeTo?: HTMLElement,
+  ): Record<
+    string,
+    {
+      start?: number;
+      end?: number;
+      pos?: number;
+      bounds?: BoundingRect;
+      rects?: RangeRect[];
+      pageIndex?: number;
+      [key: string]: unknown;
+    }
+  >;
+
+  /**
+   * Get current layout snapshot.
+   */
+  getLayoutSnapshot(): {
+    blocks: FlowBlock[];
+    measures: Measure[];
+    layout: Layout | null;
+    sectionMetadata: SectionMetadata[];
+  };
+
+  /**
+   * Get current layout options.
+   */
+  getLayoutOptions(): LayoutEngineOptions;
+
+  /**
+   * Get current paint snapshot.
+   */
+  getPaintSnapshot(): PaintSnapshot | null;
+
+  /**
+   * Get section-aware page styles.
+   */
+  getCurrentSectionPageStyles(): {
+    pageSize: { width: number; height: number };
+    pageMargins: { left: number; right: number; top: number; bottom: number };
+    sectionIndex: number;
+    orientation: 'portrait' | 'landscape';
+  };
+
+  /**
+   * Get remote cursor states for all collaborators.
+   */
+  getRemoteCursors(): RemoteCursorState[];
+
+  /**
+   * Set the layout mode (vertical or horizontal).
+   */
+  setLayoutMode(mode: LayoutMode): void;
+
+  /**
+   * Hit test at client coordinates to find document position.
+   */
+  hitTest(clientX: number, clientY: number): PositionHit | null;
+
+  /**
+   * Normalize client coordinates to layout coordinates.
+   */
+  normalizeClientPoint(
+    clientX: number,
+    clientY: number,
+  ): {
+    x: number;
+    y: number;
+    pageIndex?: number;
+    pageLocalY?: number;
+  } | null;
+
+  /**
+   * Get viewport coordinates at a document position.
+   */
+  coordsAtPos(
     pos: number,
-    options?: { forceRebuild?: boolean; fallbackToCoords?: boolean },
-  ) => HTMLElement | null;
+  ): { left: number; right: number; top: number; bottom: number; width: number; height: number } | null;
+
+  /**
+   * Get the painted DOM element for a document position (body only).
+   */
+  getElementAtPos(pos: number, options?: { forceRebuild?: boolean; fallbackToCoords?: boolean }): HTMLElement | null;
+
+  /**
+   * Scroll to a document position.
+   */
+  scrollToPosition(pos: number, options?: { behavior?: ScrollBehavior; block?: ScrollLogicalPosition }): boolean;
+
+  /**
+   * Scroll to a document position (async version).
+   */
+  scrollToPositionAsync(
+    pos: number,
+    options?: { behavior?: ScrollBehavior; block?: ScrollLogicalPosition },
+  ): Promise<boolean>;
+
+  /**
+   * Scroll to a specific page number.
+   */
+  scrollToPage(pageNumber: number, scrollBehavior?: ScrollBehavior): Promise<boolean>;
+
+  /**
+   * Get document position at viewport coordinates.
+   */
+  posAtCoords(coords: {
+    left?: number;
+    top?: number;
+    clientX?: number;
+    clientY?: number;
+  }): { pos: number; inside: number } | null;
 
+  /**
+   * Update zoom level and re-render.
+   * @param zoom - Zoom level multiplier (1.0 = 100%)
+   */
+  setZoom(zoom: number): void;
+
+  /**
+   * Navigate to a document anchor/bookmark.
+   */
+  goToAnchor(anchor: string): Promise<boolean>;
+
+  /**
+   * Convert layout coordinates back to viewport coordinates.
+   */
+  denormalizeClientPoint(
+    layoutX: number,
+    layoutY: number,
+    pageIndex?: number,
+    height?: number,
+  ): { x: number; y: number; height?: number } | null;
+
+  /**
+   * Compute caret position in layout coordinates.
+   */
+  computeCaretLayoutRect(pos: number): { pageIndex: number; x: number; y: number; height: number } | null;
+
+  /**
+   * Clean up editor and DOM nodes.
+   */
+  destroy(): void;
+
+  /**
+   * Register an event listener.
+   */
+  on(event: string, handler: (...args: any[]) => void): void;
+
+  /**
+   * Remove an event listener.
+   */
+  off(event: string, handler: (...args: any[]) => void): void;
+
+  /**
+   * Emit an event.
+   */
+  emit(event: string, ...args: any[]): void;
+
+  /** Allow additional properties */
   [key: string]: any;
 }
 

package/dist/super-editor.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-Dp2H1eGw.cjs");
-const require_src = require("./chunks/src-C_BYlKtR.cjs");
-const require_SuperConverter = require("./chunks/SuperConverter-BbWMX2Yr.cjs");
+const require_src = require("./chunks/src-C9-llU1u.cjs");
+const require_SuperConverter = require("./chunks/SuperConverter-DvMtX0CH.cjs");
 require("./chunks/jszip-DCT9QYaK.cjs");
 require("./chunks/xml-js--DznO7Gk.cjs");
 require("./chunks/constants-7MkJJnfa.cjs");

package/dist/super-editor.es.js

@@ -1,5 +1,5 @@
-import { $ as SectionHelpers, Bt as defineNode, Ht as assertNodeType, Q as trackChangesHelpers_exports, Ut as isNodeType, Vt as isMarkType, X as getRichTextExtensions, Y as AIWriter_default, Z as getStarterExtensions, a as BasicUpload_default, at as CommentsPluginKey, c as Toolbar_default, et as PresentationEditor, i as SuperEditor_default, it as AnnotatorHelpers, n as SlashMenu, nt as getAllowedImageDimensions, o as ContextMenu_default, ot as createOrUpdateTrackedChangeComment, r as SuperInput_default, rt as fieldAnnotationHelpers_exports, s as SuperToolbar, st as TrackChangesBasePluginKey, t as Extensions, tt as Editor, zt as defineMark } from "./chunks/src-Bdcvgeb3.es.js";
-import { B as getMarksFromSelection, R as getActiveFormatting, a as helpers_exports, r as registeredHandlers, t as SuperConverter } from "./chunks/SuperConverter-DAG0cqbz.es.js";
+import { $ as SectionHelpers, Bt as defineNode, Ht as assertNodeType, Q as trackChangesHelpers_exports, Ut as isNodeType, Vt as isMarkType, X as getRichTextExtensions, Y as AIWriter_default, Z as getStarterExtensions, a as BasicUpload_default, at as CommentsPluginKey, c as Toolbar_default, et as PresentationEditor, i as SuperEditor_default, it as AnnotatorHelpers, n as SlashMenu, nt as getAllowedImageDimensions, o as ContextMenu_default, ot as createOrUpdateTrackedChangeComment, r as SuperInput_default, rt as fieldAnnotationHelpers_exports, s as SuperToolbar, st as TrackChangesBasePluginKey, t as Extensions, tt as Editor, zt as defineMark } from "./chunks/src-bVAmi6lL.es.js";
+import { B as getMarksFromSelection, R as getActiveFormatting, a as helpers_exports, r as registeredHandlers, t as SuperConverter } from "./chunks/SuperConverter-IgiRNOfZ.es.js";
 import "./chunks/jszip-ChlR43oI.es.js";
 import "./chunks/xml-js-DLE8mr0n.es.js";
 import "./chunks/constants-CMPtQbp7.es.js";

package/dist/superdoc.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-Dp2H1eGw.cjs");
-const require_src = require("./chunks/src-C_BYlKtR.cjs");
-const require_SuperConverter = require("./chunks/SuperConverter-BbWMX2Yr.cjs");
+const require_src = require("./chunks/src-C9-llU1u.cjs");
+const require_SuperConverter = require("./chunks/SuperConverter-DvMtX0CH.cjs");
 const require_jszip = require("./chunks/jszip-DCT9QYaK.cjs");
 require("./chunks/xml-js--DznO7Gk.cjs");
 const require_uuid = require("./chunks/uuid-BZOhSkTa.cjs");
@@ -20338,7 +20338,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 = "1.18.0-next.23";
+		this.version = "1.18.0-next.24";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors;

package/dist/superdoc.es.js

@@ -1,5 +1,5 @@
-import { $ as SectionHelpers, A as isMounted, At as toUint8Array, B as cNotM, C as resolveWrappedSlot, Ct as getUnixTime, D as warnOnce, Dt as readVarUint8Array, E as throwError, Et as readVarUint, F as changeColor, Ft as pow, G as ellipsis_vertical_solid_default, H as insideModal, I as c, It as v_click_outside_default, J as comment_solid_default, K as xmark_solid_default, L as cB, Lt as getFileObject, M as use_memo_default, Mt as writeVarUint8Array, N as on, Nt as create, O as useSsrAdapter, Ot as createEncoder, P as createId, Pt as min, Q as trackChangesHelpers_exports, R as cE, Rt as comments_module_events, S as configProviderInjectionKey, St as setIfUndefined, T as call, Tt as readVarString, U as insidePopover, V as createKey, W as caret_down_solid_default, X as getRichTextExtensions, Y as AIWriter_default, Z as getStarterExtensions, _ as useRtl, _t as applyAwarenessUpdate, at as CommentsPluginKey, b as useThemeClass, bt as map, ct as getTrackChanges, d as Dropdown_default, dt as toBase64, et as PresentationEditor, f as ConfigProvider_default, ft as isNode, g as _common_default$2, gt as Awareness, h as index_cssr_default$5, ht as varStorage, i as SuperEditor_default, it as AnnotatorHelpers, j as useMergedState, jt as writeVarUint, k as createInjectionKey, kt as length, l as messageApiInjectionKey, lt as createUint8ArrayFromArrayBuffer, m as use_theme_default, mt as onChange, ot as createOrUpdateTrackedChangeComment, p as light_default$1, pt as offChange, q as check_solid_default, r as SuperInput_default, rt as fieldAnnotationHelpers_exports, s as SuperToolbar, t as Extensions, tt as Editor, u as messageProviderInjectionKey, ut as fromBase64, v as cssrAnchorMetaName, vt as encodeAwarenessUpdate, w as render, wt as createDecoder, x as useConfig, xt as ObservableV2, y as toString_default, yt as removeAwarenessStates, z as cM } from "./chunks/src-Bdcvgeb3.es.js";
-import { a as helpers_exports, r as registeredHandlers, t as SuperConverter } from "./chunks/SuperConverter-DAG0cqbz.es.js";
+import { $ as SectionHelpers, A as isMounted, At as toUint8Array, B as cNotM, C as resolveWrappedSlot, Ct as getUnixTime, D as warnOnce, Dt as readVarUint8Array, E as throwError, Et as readVarUint, F as changeColor, Ft as pow, G as ellipsis_vertical_solid_default, H as insideModal, I as c, It as v_click_outside_default, J as comment_solid_default, K as xmark_solid_default, L as cB, Lt as getFileObject, M as use_memo_default, Mt as writeVarUint8Array, N as on, Nt as create, O as useSsrAdapter, Ot as createEncoder, P as createId, Pt as min, Q as trackChangesHelpers_exports, R as cE, Rt as comments_module_events, S as configProviderInjectionKey, St as setIfUndefined, T as call, Tt as readVarString, U as insidePopover, V as createKey, W as caret_down_solid_default, X as getRichTextExtensions, Y as AIWriter_default, Z as getStarterExtensions, _ as useRtl, _t as applyAwarenessUpdate, at as CommentsPluginKey, b as useThemeClass, bt as map, ct as getTrackChanges, d as Dropdown_default, dt as toBase64, et as PresentationEditor, f as ConfigProvider_default, ft as isNode, g as _common_default$2, gt as Awareness, h as index_cssr_default$5, ht as varStorage, i as SuperEditor_default, it as AnnotatorHelpers, j as useMergedState, jt as writeVarUint, k as createInjectionKey, kt as length, l as messageApiInjectionKey, lt as createUint8ArrayFromArrayBuffer, m as use_theme_default, mt as onChange, ot as createOrUpdateTrackedChangeComment, p as light_default$1, pt as offChange, q as check_solid_default, r as SuperInput_default, rt as fieldAnnotationHelpers_exports, s as SuperToolbar, t as Extensions, tt as Editor, u as messageProviderInjectionKey, ut as fromBase64, v as cssrAnchorMetaName, vt as encodeAwarenessUpdate, w as render, wt as createDecoder, x as useConfig, xt as ObservableV2, y as toString_default, yt as removeAwarenessStates, z as cM } from "./chunks/src-bVAmi6lL.es.js";
+import { a as helpers_exports, r as registeredHandlers, t as SuperConverter } from "./chunks/SuperConverter-IgiRNOfZ.es.js";
 import { a as init_dist$1, i as global, n as init_dist, r as process$1 } from "./chunks/jszip-ChlR43oI.es.js";
 import "./chunks/xml-js-DLE8mr0n.es.js";
 import { n as v4_default } from "./chunks/uuid-qzgm05fK.es.js";
@@ -20297,7 +20297,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 = "1.18.0-next.23";
+		this.version = "1.18.0-next.24";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4_default();
 		this.colors = this.config.colors;

package/dist/superdoc.umd.js

@@ -64512,7 +64512,7 @@ while (prev === _win[++scan] && prev === _win[++scan] && prev === _win[++scan] &
 	var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 	function getSuperdocVersion() {
 		try {
-			return "1.18.0-next.23";
+			return "1.18.0-next.24";
 		} catch {
 			return "unknown";
 		}
@@ -67694,7 +67694,7 @@ while (prev === _win[++scan] && prev === _win[++scan] && prev === _win[++scan] &
 		static getStoredSuperdocVersion(docx) {
 			return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
 		}
-		static setStoredSuperdocVersion(docx = this.convertedXml, version$2 = "1.18.0-next.23") {
+		static setStoredSuperdocVersion(docx = this.convertedXml, version$2 = "1.18.0-next.24") {
 			return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version$2, false);
 		}
 		static generateWordTimestamp() {
@@ -97575,7 +97575,7 @@ while (n$2 === a$3[++i$3] && n$2 === a$3[++i$3] && n$2 === a$3[++i$3] && n$2 ===
 			return false;
 		}
 	};
-	var summaryVersion = "1.18.0-next.23";
+	var summaryVersion = "1.18.0-next.24";
 	var nodeKeys = [
 		"group",
 		"content",
@@ -126530,7 +126530,7 @@ while (n$2 === a$3[++i$3] && n$2 === a$3[++i$3] && n$2 === a$3[++i$3] && n$2 ===
 			return migrations.length > 0;
 		}
 		processCollaborationMigrations() {
-			console.debug("[checkVersionMigrations] Current editor version", "1.18.0-next.23");
+			console.debug("[checkVersionMigrations] Current editor version", "1.18.0-next.24");
 			if (!this.options.ydoc) return;
 			let docVersion = this.options.ydoc.getMap("meta").get("version");
 			if (!docVersion) docVersion = "initial";
@@ -213769,7 +213769,7 @@ js: import "konva/skia-backend";
 			this.config.colors = shuffleArray(this.config.colors);
 			this.userColorMap = /* @__PURE__ */ new Map();
 			this.colorIndex = 0;
-			this.version = "1.18.0-next.23";
+			this.version = "1.18.0-next.24";
 			this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 			this.superdocId = config$32.superdocId || v4_default();
 			this.colors = this.config.colors;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@harbour-enterprises/superdoc",
   "type": "module",
-  "version": "1.18.0-next.23",
+  "version": "1.18.0-next.24",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -99,8 +99,8 @@
     "ws": "^8.18.3",
     "xml-js": "1.6.11",
     "@superdoc/common": "1.0.0",
-    "@superdoc/super-editor": "0.0.1",
-    "@superdoc-dev/superdoc-yjs-collaboration": "1.0.2"
+    "@superdoc-dev/superdoc-yjs-collaboration": "1.0.2",
+    "@superdoc/super-editor": "0.0.1"
   },
   "publishConfig": {
     "access": "public"