@harbour-enterprises/superdoc 1.0.0-beta.60 → 1.0.0-beta.61

package/dist/super-editor/chunks/{editor-CDMuD1Nx.js → editor-45pxcsTR.js}

@@ -12,8 +12,8 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
 var _Attribute_static, getGlobalAttributes_fn, getNodeAndMarksAttributes_fn, _Schema_static, createNodesSchema_fn, createMarksSchema_fn, _events, _ExtensionService_instances, setupExtensions_fn, attachEditorEvents_fn, _editor, _stateValidators, _xmlValidators, _requiredNodeTypes, _requiredMarkTypes, _SuperValidator_instances, initializeValidators_fn, collectValidatorRequirements_fn, analyzeDocument_fn, dispatchWithFallback_fn, _commandService, _Editor_instances, initContainerElement_fn, init_fn, initRichText_fn, onFocus_fn, checkHeadless_fn, registerCopyHandler_fn, insertNewFileData_fn, getPluginKeyName_fn, createExtensionService_fn, createCommandService_fn, createConverter_fn, initMedia_fn, initFonts_fn, checkFonts_fn, determineUnsupportedFonts_fn, createSchema_fn, generatePmData_fn, createView_fn, onCollaborationReady_fn, initComments_fn, dispatchTransaction_fn, handleNodeSelection_fn, prepareDocumentForImport_fn, prepareDocumentForExport_fn, endCollaboration_fn, validateDocumentInit_fn, validateDocumentExport_fn, initDevTools_fn, _map, _editor2, _descriptors, _collections, _editorEntries, _maxCachedEditors, _editorAccessOrder, _pendingCreations, _cacheHits, _cacheMisses, _evictions, _HeaderFooterEditorManager_instances, hasConverter_fn, extractCollections_fn, collectDescriptors_fn, teardownMissingEditors_fn, teardownEditors_fn, createEditor_fn, createEditorContainer_fn, registerConverterEditor_fn, unregisterConverterEditor_fn, updateAccessOrder_fn, enforceCacheSizeLimit_fn, _manager, _mediaFiles, _blockCache, _HeaderFooterLayoutAdapter_instances, getBlocks_fn, getConverterContext_fn, _selectionOverlay, _activeEditorHost, _activeDecorationContainer, _activeRegion, _borderLine, _dimmingOverlay, _EditorOverlayManager_instances, findDecorationContainer_fn, ensureEditorHost_fn, positionEditorHost_fn, hideDimmingOverlay_fn, showHeaderFooterBorder_fn, hideHeaderFooterBorder_fn, _instances, _options, _editor3, _visibleHost, _viewportHost, _painterHost, _selectionOverlay2, _hiddenHost, _layoutOptions, _layoutState, _domPainter, _dragHandlerCleanup, _layoutError, _layoutErrorState, _errorBanner, _errorBannerMessage, _telemetryEmitter, _renderScheduled, _pendingDocChange, _isRerendering, _selectionUpdateScheduled, _remoteCursorUpdateScheduled, _rafHandle, _editorListeners, _sectionMetadata, _documentMode, _inputBridge, _trackedChangesMode, _trackedChangesEnabled, _trackedChangesOverrides, _headerFooterManager, _headerFooterAdapter, _headerFooterIdentifier, _multiSectionIdentifier, _headerLayoutResults, _footerLayoutResults, _headerLayoutsByRId, _footerLayoutsByRId, _headerDecorationProvider, _footerDecorationProvider, _headerFooterManagerCleanups, _headerRegions, _footerRegions, _session, _activeHeaderFooterEditor, _overlayManager, _hoverOverlay, _hoverTooltip, _modeBanner, _ariaLiveRegion, _hoverRegion, _clickCount, _lastClickTime, _lastClickPosition, _lastSelectedImageBlockId, _dragAnchor, _isDragging, _dragExtensionMode, _remoteCursorState, _remoteCursorElements, _remoteCursorDirty, _remoteCursorOverlay, _localSelectionLayer, _awarenessCleanup, _scrollCleanup, _scrollTimeout, _lastRemoteCursorRenderTime, _remoteCursorThrottleTimeout, _PresentationEditor_instances, collectCommentPositions_fn, aggregateLayoutBounds_fn, safeCleanup_fn, setupEditorListeners_fn, setupCollaborationCursors_fn, updateLocalAwarenessCursor_fn, normalizeAwarenessStates_fn, getFallbackColor_fn, getValidatedColor_fn, scheduleRemoteCursorUpdate_fn, scheduleRemoteCursorReRender_fn, updateRemoteCursors_fn, renderRemoteCursors_fn, renderRemoteCaret_fn, renderRemoteCursorLabel_fn, renderRemoteSelection_fn, setupPointerHandlers_fn, setupDragHandlers_fn, focusEditorAfterImageSelection_fn, setupInputBridge_fn, initHeaderFooterRegistry_fn, _handlePointerDown, getFirstTextPosition_fn, registerPointerClick_fn, selectWordAt_fn, selectParagraphAt_fn, calculateExtendedSelection_fn, isWordCharacter_fn, _handlePointerMove, _handlePointerLeave, _handlePointerUp, _handleDragOver, _handleDrop, _handleDoubleClick, _handleKeyDown, focusHeaderFooterShortcut_fn, scheduleRerender_fn, flushRerenderQueue_fn, rerender_fn, ensurePainter_fn, scheduleSelectionUpdate_fn, updateSelection_fn, resolveLayoutOptions_fn, buildHeaderFooterInput_fn, computeHeaderFooterConstraints_fn, layoutPerRIdHeaderFooters_fn, updateDecorationProviders_fn, createDecorationProvider_fn, findHeaderFooterPageForPageNumber_fn, computeDecorationBox_fn, computeExpectedSectionType_fn, rebuildHeaderFooterRegions_fn, hitTestHeaderFooterRegion_fn, pointInRegion_fn, activateHeaderFooterRegion_fn, enterHeaderFooterMode_fn, exitHeaderFooterMode_fn, getActiveDomTarget_fn, emitHeaderFooterModeChanged_fn, emitHeaderFooterEditingContext_fn, updateAwarenessSession_fn, updateModeBanner_fn, announce_fn, validateHeaderFooterEditPermission_fn, emitHeaderFooterEditBlocked_fn, resolveDescriptorForRegion_fn, createDefaultHeaderFooter_fn, getPageElement_fn, scrollPageIntoView_fn, computeAnchorMap_fn, waitForPageMount_fn, getBodyPageHeight_fn, getHeaderFooterPageHeight_fn, renderSelectionRects_fn, renderHoverRegion_fn, clearHoverRegion_fn, renderCaretOverlay_fn, getHeaderFooterContext_fn, computeHeaderFooterSelectionRects_fn, syncTrackedChangesPreferences_fn, deriveTrackedChangesMode_fn, deriveTrackedChangesEnabled_fn, getTrackChangesPluginState_fn, computeDefaultLayoutDefaults_fn, parseColumns_fn, inchesToPx_fn, applyZoom_fn, createLayoutMetrics_fn, convertPageLocalToOverlayCoords_fn, normalizeClientPoint_fn, computeCaretLayoutRect_fn, computeCaretLayoutRectFromDOM_fn, computeTableCaretLayoutRect_fn, findLineContainingPos_fn, lineHeightBeforeIndex_fn, getCurrentPageIndex_fn, findRegionForPage_fn, handleLayoutError_fn, decorateError_fn, showLayoutErrorBanner_fn, dismissErrorBanner_fn, createHiddenHost_fn, _windowRoot, _layoutSurfaces, _getTargetDom, _isEditable, _onTargetChanged, _listeners, _currentTarget, _destroyed, _useWindowFallback, _PresentationInputBridge_instances, addListener_fn, dispatchToTarget_fn, forwardKeyboardEvent_fn, forwardTextEvent_fn, forwardCompositionEvent_fn, forwardContextMenu_fn, isEventOnActiveTarget_fn, shouldSkipSurface_fn, isInLayoutSurface_fn, getListenerTargets_fn, isPlainCharacterKey_fn, _DocumentSectionView_instances, init_fn2, addToolTip_fn, _ParagraphNodeView_instances, checkShouldUpdate_fn, updateHTMLAttributes_fn, updateDOMStyles_fn, resolveNeighborParagraphProperties_fn, updateListStyles_fn, initList_fn, checkIsList_fn, createMarker_fn, createSeparator_fn, calculateTabSeparatorStyle_fn, calculateMarkerStyle_fn, removeList_fn, getParagraphContext_fn, scheduleAnimation_fn, cancelScheduledAnimation_fn, _FieldAnnotationView_instances, createAnnotation_fn, _AutoPageNumberNodeView_instances, renderDom_fn, scheduleUpdateNodeStyle_fn, _VectorShapeView_instances, ensureParentPositioned_fn, _ShapeGroupView_instances, ensureParentPositioned_fn2;
 import * as Y from "yjs";
 import { UndoManager, Item as Item$1, ContentType, Text as Text$1, XmlElement, encodeStateAsUpdate } from "yjs";
-import { P as PluginKey, a as Plugin, M as Mapping, N as NodeSelection, S as Selection, T as TextSelection, b as Slice, D as DOMSerializer, F as Fragment, c as DOMParser$1, d as Mark$1, e as dropPoint, A as AllSelection, p as process$1, B as Buffer2, f as callOrGet, g as getExtensionConfigField, h as getMarkType, i as getMarksFromSelection, j as getNodeType, k as getSchemaTypeNameByName, l as Schema$1, m as cleanSchemaItem, n as canSplit, o as defaultBlockAt$1, q as liftTarget, r as canJoin, s as joinPoint, t as replaceStep$1, R as ReplaceAroundStep$1, u as isTextSelection, v as getMarkRange, w as isMarkActive, x as isNodeActive, y as deleteProps, z as processContent, C as htmlHandler, E as ReplaceStep, G as twipsToInches, H as inchesToTwips, I as ptToTwips, J as getResolvedParagraphProperties, K as linesToTwips, L as changeListLevel, O as findParentNode, Q as isList, U as updateNumberingProperties, V as ListHelpers, W as isMacOS, X as isIOS, Y as getSchemaTypeByName, Z as inputRulesPlugin, _ as TrackDeleteMarkName$1, $ as TrackInsertMarkName$1, a0 as v4, a1 as TrackFormatMarkName$1, a2 as comments_module_events, a3 as findMark, a4 as objectIncludes, a5 as AddMarkStep, a6 as RemoveMarkStep, a7 as twipsToLines, a8 as pixelsToTwips, a9 as helpers, aa as posToDOMRect, ab as CommandService, ac as SuperConverter, ad as createDocument, ae as createDocFromMarkdown, af as createDocFromHTML, ag as EditorState, ah as isActive, ai as unflattenListsInHtml, aj as resolveParagraphProperties, ak as _getReferencedTableStyles, al as parseSizeUnit, am as minMax, an as updateDOMAttributes, ao as findChildren$5, ap as generateRandomSigned32BitIntStrId, aq as decodeRPrFromMarks, ar as calculateResolvedParagraphProperties, as as resolveRunProperties, at as encodeCSSFromPPr, au as twipsToPixels$2, av as encodeCSSFromRPr, aw as generateOrderedListIndex, ax as docxNumberingHelpers, ay as InputRule, az as convertSizeToCSS, aA as SelectionRange, aB as Transform, aC as findParentNodeClosestToPos, aD as isInTable$1, aE as generateDocxRandomId, aF as insertNewRelationship, aG as inchesToPixels, aH as kebabCase, aI as getUnderlineCssString } from "./converter-DZ7Tkh7u.js";
-import { D as DocxZipper } from "./docx-zipper-CZQWEuyi.js";
+import { P as PluginKey, a as Plugin, M as Mapping, N as NodeSelection, S as Selection, T as TextSelection, b as Slice, D as DOMSerializer, F as Fragment, c as DOMParser$1, d as Mark$1, e as dropPoint, A as AllSelection, p as process$1, B as Buffer2, f as callOrGet, g as getExtensionConfigField, h as getMarkType, i as getMarksFromSelection, j as getNodeType, k as getSchemaTypeNameByName, l as Schema$1, m as cleanSchemaItem, n as canSplit, o as defaultBlockAt$1, q as liftTarget, r as canJoin, s as joinPoint, t as replaceStep$1, R as ReplaceAroundStep$1, u as isTextSelection, v as getMarkRange, w as isMarkActive, x as isNodeActive, y as deleteProps, z as processContent, C as htmlHandler, E as ReplaceStep, G as twipsToInches, H as inchesToTwips, I as ptToTwips, J as getResolvedParagraphProperties, K as linesToTwips, L as changeListLevel, O as findParentNode, Q as isList, U as updateNumberingProperties, V as ListHelpers, W as isMacOS, X as isIOS, Y as getSchemaTypeByName, Z as inputRulesPlugin, _ as TrackDeleteMarkName$1, $ as TrackInsertMarkName$1, a0 as v4, a1 as TrackFormatMarkName$1, a2 as comments_module_events, a3 as findMark, a4 as objectIncludes, a5 as AddMarkStep, a6 as RemoveMarkStep, a7 as twipsToLines, a8 as pixelsToTwips, a9 as helpers, aa as posToDOMRect, ab as CommandService, ac as SuperConverter, ad as createDocument, ae as createDocFromMarkdown, af as createDocFromHTML, ag as EditorState, ah as isActive, ai as unflattenListsInHtml, aj as resolveParagraphProperties, ak as _getReferencedTableStyles, al as parseSizeUnit, am as minMax, an as updateDOMAttributes, ao as findChildren$5, ap as generateRandomSigned32BitIntStrId, aq as decodeRPrFromMarks, ar as calculateResolvedParagraphProperties, as as resolveRunProperties, at as encodeCSSFromPPr, au as twipsToPixels$2, av as encodeCSSFromRPr, aw as generateOrderedListIndex, ax as docxNumberingHelpers, ay as InputRule, az as convertSizeToCSS, aA as SelectionRange, aB as Transform, aC as findParentNodeClosestToPos, aD as isInTable$1, aE as generateDocxRandomId, aF as insertNewRelationship, aG as inchesToPixels, aH as kebabCase, aI as getUnderlineCssString } from "./converter-DaSkPzA9.js";
+import { D as DocxZipper } from "./docx-zipper-Cx1zgQ8B.js";
 import { ref, computed, createElementBlock, openBlock, withModifiers, Fragment as Fragment$1, renderList, normalizeClass, createCommentVNode, toDisplayString, createElementVNode, createApp } from "vue";
 var GOOD_LEAF_SIZE = 200;
 var RopeSequence = function RopeSequence2() {
@@ -13923,7 +13923,7 @@ const isHeadless = (editor) => {
 const shouldSkipNodeView = (editor) => {
   return isHeadless(editor);
 };
-const summaryVersion = "1.0.0-beta.60";
+const summaryVersion = "1.0.0-beta.61";
 const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
 const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
 function mapAttributes(attrs) {
@@ -14715,7 +14715,7 @@ const _Editor = class _Editor extends EventEmitter {
       { default: remarkStringify },
       { default: remarkGfm }
     ] = await Promise.all([
-      import("./index-GAzIoyrZ.js"),
+      import("./index-u8dj63PM.js"),
       import("./index-DRCvimau.js"),
       import("./index-C_x_N6Uh.js"),
       import("./index-D_sWOSiG.js"),
@@ -14920,7 +14920,7 @@ const _Editor = class _Editor extends EventEmitter {
    * Process collaboration migrations
    */
   processCollaborationMigrations() {
-    console.debug("[checkVersionMigrations] Current editor version", "1.0.0-beta.60");
+    console.debug("[checkVersionMigrations] Current editor version", "1.0.0-beta.61");
     if (!this.options.ydoc) return;
     const metaMap = this.options.ydoc.getMap("meta");
     let docVersion = metaMap.get("version");
@@ -26174,6 +26174,408 @@ function assertFragmentPmPositions(fragment, _context) {
   const hasPmEnd = fragment.pmEnd != null;
   globalValidationStats.record(hasPmStart, hasPmEnd);
 }
+const DEFAULT_PPI = 96;
+const DEFAULT_RULER_HEIGHT = 25;
+const TICK_SPACING_PX = DEFAULT_PPI / 8;
+function generateRulerDefinition(config) {
+  const ppi = config.ppi ?? DEFAULT_PPI;
+  const heightPx = config.heightPx ?? DEFAULT_RULER_HEIGHT;
+  const { pageSize, pageMargins } = config;
+  if (!Number.isFinite(ppi) || ppi <= 0) {
+    throw new Error(`Invalid PPI: ${ppi}. Must be a positive finite number.`);
+  }
+  if (!Number.isFinite(pageSize.width) || pageSize.width <= 0) {
+    throw new Error(`Invalid page width: ${pageSize.width}. Must be a positive finite number.`);
+  }
+  if (!Number.isFinite(pageSize.height) || pageSize.height <= 0) {
+    throw new Error(`Invalid page height: ${pageSize.height}. Must be a positive finite number.`);
+  }
+  if (!Number.isFinite(pageMargins.left) || pageMargins.left < 0) {
+    throw new Error(`Invalid left margin: ${pageMargins.left}. Must be a non-negative finite number.`);
+  }
+  if (!Number.isFinite(pageMargins.right) || pageMargins.right < 0) {
+    throw new Error(`Invalid right margin: ${pageMargins.right}. Must be a non-negative finite number.`);
+  }
+  if (pageMargins.left + pageMargins.right >= pageSize.width) {
+    throw new Error(
+      `Invalid margins: left (${pageMargins.left}) + right (${pageMargins.right}) must be less than page width (${pageSize.width}).`
+    );
+  }
+  const widthPx = pageSize.width * ppi;
+  const ticks = [];
+  let currentX = 0;
+  for (let inch = 0; inch < pageSize.width; inch++) {
+    const remaining = pageSize.width - inch;
+    ticks.push({
+      size: "main",
+      height: "20%",
+      label: inch,
+      x: currentX
+    });
+    currentX += TICK_SPACING_PX;
+    for (let i = 0; i < 3; i++) {
+      ticks.push({
+        size: "eighth",
+        height: "10%",
+        x: currentX
+      });
+      currentX += TICK_SPACING_PX;
+    }
+    ticks.push({
+      size: "half",
+      height: "40%",
+      x: currentX
+    });
+    currentX += TICK_SPACING_PX;
+    if (remaining <= 0.5) break;
+    for (let i = 0; i < 3; i++) {
+      ticks.push({
+        size: "eighth",
+        height: "10%",
+        x: currentX
+      });
+      currentX += TICK_SPACING_PX;
+    }
+  }
+  return {
+    widthPx,
+    heightPx,
+    ticks,
+    leftMarginPx: pageMargins.left * ppi,
+    rightMarginPx: widthPx - pageMargins.right * ppi,
+    pageWidthInches: pageSize.width
+  };
+}
+function calculateMarginFromHandle(handleX, side, pageWidthPx, ppi = DEFAULT_PPI) {
+  if (side === "left") {
+    return handleX / ppi;
+  } else {
+    return (pageWidthPx - handleX) / ppi;
+  }
+}
+function clampHandlePosition(handleX, side, otherHandleX, pageWidthPx, minContentWidthPx = 200) {
+  if (!Number.isFinite(handleX)) {
+    throw new Error(`Invalid handleX: ${handleX}. Must be a finite number.`);
+  }
+  if (!Number.isFinite(otherHandleX)) {
+    throw new Error(`Invalid otherHandleX: ${otherHandleX}. Must be a finite number.`);
+  }
+  if (!Number.isFinite(pageWidthPx)) {
+    throw new Error(`Invalid pageWidthPx: ${pageWidthPx}. Must be a finite number.`);
+  }
+  if (!Number.isFinite(minContentWidthPx)) {
+    throw new Error(`Invalid minContentWidthPx: ${minContentWidthPx}. Must be a finite number.`);
+  }
+  if (side === "left") {
+    const min2 = 0;
+    const max2 = otherHandleX - minContentWidthPx;
+    return Math.max(min2, Math.min(max2, handleX));
+  } else {
+    const min2 = otherHandleX + minContentWidthPx;
+    const max2 = pageWidthPx;
+    return Math.max(min2, Math.min(max2, handleX));
+  }
+}
+function generateRulerDefinitionFromPx(config) {
+  const ppi = config.ppi ?? DEFAULT_PPI;
+  const heightPx = config.heightPx ?? DEFAULT_RULER_HEIGHT;
+  const { pageWidthPx, leftMarginPx, rightMarginPx } = config;
+  if (!Number.isFinite(ppi) || ppi <= 0) {
+    throw new Error(`Invalid PPI: ${ppi}. Must be a positive finite number.`);
+  }
+  if (!Number.isFinite(pageWidthPx) || pageWidthPx <= 0) {
+    throw new Error(`Invalid page width: ${pageWidthPx}px. Must be a positive finite number.`);
+  }
+  if (!Number.isFinite(config.pageHeightPx) || config.pageHeightPx <= 0) {
+    throw new Error(`Invalid page height: ${config.pageHeightPx}px. Must be a positive finite number.`);
+  }
+  if (!Number.isFinite(leftMarginPx) || leftMarginPx < 0) {
+    throw new Error(`Invalid left margin: ${leftMarginPx}px. Must be a non-negative finite number.`);
+  }
+  if (!Number.isFinite(rightMarginPx) || rightMarginPx < 0) {
+    throw new Error(`Invalid right margin: ${rightMarginPx}px. Must be a non-negative finite number.`);
+  }
+  if (leftMarginPx + rightMarginPx >= pageWidthPx) {
+    throw new Error(
+      `Invalid margins: left (${leftMarginPx}px) + right (${rightMarginPx}px) must be less than page width (${pageWidthPx}px).`
+    );
+  }
+  const pageWidthInches = pageWidthPx / ppi;
+  const ticks = [];
+  let currentX = 0;
+  for (let inch = 0; inch < pageWidthInches; inch++) {
+    const remaining = pageWidthInches - inch;
+    ticks.push({
+      size: "main",
+      height: "20%",
+      label: inch,
+      x: currentX
+    });
+    currentX += TICK_SPACING_PX;
+    for (let i = 0; i < 3; i++) {
+      ticks.push({
+        size: "eighth",
+        height: "10%",
+        x: currentX
+      });
+      currentX += TICK_SPACING_PX;
+    }
+    ticks.push({
+      size: "half",
+      height: "40%",
+      x: currentX
+    });
+    currentX += TICK_SPACING_PX;
+    if (remaining <= 0.5) break;
+    for (let i = 0; i < 3; i++) {
+      ticks.push({
+        size: "eighth",
+        height: "10%",
+        x: currentX
+      });
+      currentX += TICK_SPACING_PX;
+    }
+  }
+  return {
+    widthPx: pageWidthPx,
+    heightPx,
+    ticks,
+    leftMarginPx,
+    rightMarginPx: pageWidthPx - rightMarginPx,
+    pageWidthInches
+  };
+}
+const RULER_CLASS_NAMES = {
+  /** Main ruler container */
+  ruler: "superdoc-ruler",
+  /** Tick mark element */
+  tick: "superdoc-ruler-tick",
+  /** Main (inch) tick */
+  tickMain: "superdoc-ruler-tick--main",
+  /** Half-inch tick */
+  tickHalf: "superdoc-ruler-tick--half",
+  /** Eighth-inch tick */
+  tickEighth: "superdoc-ruler-tick--eighth",
+  /** Inch label number */
+  label: "superdoc-ruler-label",
+  /** Margin handle */
+  handle: "superdoc-ruler-handle",
+  /** Left margin handle */
+  handleLeft: "superdoc-ruler-handle--left",
+  /** Right margin handle */
+  handleRight: "superdoc-ruler-handle--right",
+  /** Vertical indicator line during drag */
+  indicator: "superdoc-ruler-indicator"
+};
+function createRulerElement(options) {
+  const { definition, doc: doc2, interactive = false } = options;
+  if (!Number.isFinite(definition.widthPx) || definition.widthPx <= 0) {
+    console.warn(`[createRulerElement] Invalid ruler width: ${definition.widthPx}px. Using minimum width of 1px.`);
+    definition.widthPx = Math.max(1, definition.widthPx || 1);
+  }
+  if (!definition.ticks || definition.ticks.length === 0) {
+    console.warn("[createRulerElement] Ruler definition has no ticks. Ruler will be empty.");
+  }
+  const ruler = doc2.createElement("div");
+  ruler.className = RULER_CLASS_NAMES.ruler;
+  ruler.style.cssText = `
+    position: relative;
+    width: ${definition.widthPx}px;
+    height: ${definition.heightPx}px;
+    display: flex;
+    align-items: flex-end;
+    box-sizing: border-box;
+    user-select: none;
+    pointer-events: ${interactive ? "auto" : "none"};
+  `;
+  for (const tick of definition.ticks) {
+    const tickEl = createTickElement(tick, doc2);
+    ruler.appendChild(tickEl);
+  }
+  if (interactive) {
+    const leftHandle = createHandleElement("left", definition.leftMarginPx, doc2, options);
+    const rightHandle = createHandleElement("right", definition.rightMarginPx, doc2, options);
+    ruler.appendChild(leftHandle);
+    ruler.appendChild(rightHandle);
+  }
+  return ruler;
+}
+function createTickElement(tick, doc2) {
+  const el = doc2.createElement("div");
+  const sizeClass = tick.size === "main" ? RULER_CLASS_NAMES.tickMain : tick.size === "half" ? RULER_CLASS_NAMES.tickHalf : RULER_CLASS_NAMES.tickEighth;
+  el.className = `${RULER_CLASS_NAMES.tick} ${sizeClass}`;
+  el.style.cssText = `
+    position: absolute;
+    left: ${tick.x}px;
+    bottom: 0;
+    width: 1px;
+    height: ${tick.height};
+    background-color: #666;
+    pointer-events: none;
+  `;
+  if (tick.label !== void 0) {
+    const label = doc2.createElement("span");
+    label.className = RULER_CLASS_NAMES.label;
+    label.textContent = String(tick.label);
+    label.style.cssText = `
+      position: absolute;
+      top: -16px;
+      left: -2px;
+      font-size: 10px;
+      color: #666;
+      pointer-events: none;
+      user-select: none;
+    `;
+    el.appendChild(label);
+  }
+  return el;
+}
+function createHandleElement(side, x, doc2, options) {
+  const handle = doc2.createElement("div");
+  const sideClass = side === "left" ? RULER_CLASS_NAMES.handleLeft : RULER_CLASS_NAMES.handleRight;
+  handle.className = `${RULER_CLASS_NAMES.handle} ${sideClass}`;
+  handle.dataset.side = side;
+  handle.style.cssText = `
+    position: absolute;
+    left: ${x}px;
+    top: 0;
+    width: 5px;
+    height: 20px;
+    margin-left: -2px;
+    background-color: #ccc;
+    border-radius: 4px 4px 0 0;
+    cursor: grab;
+    transition: background-color 150ms ease;
+    z-index: 10;
+  `;
+  handle.addEventListener("mouseenter", () => {
+    if (!handle.dataset.dragging) {
+      handle.style.backgroundColor = "rgba(37, 99, 235, 0.4)";
+    }
+  });
+  handle.addEventListener("mouseleave", () => {
+    if (!handle.dataset.dragging) {
+      handle.style.backgroundColor = "#ccc";
+    }
+  });
+  if (options.onDragStart || options.onDrag || options.onDragEnd) {
+    setupHandleDrag(handle, side, options);
+  }
+  return handle;
+}
+function setupHandleDrag(handle, side, options) {
+  let offsetX = 0;
+  const onPointerDown = (event) => {
+    event.preventDefault();
+    handle.dataset.dragging = "true";
+    handle.style.backgroundColor = "rgba(37, 99, 235, 0.4)";
+    handle.style.cursor = "grabbing";
+    const rect = handle.getBoundingClientRect();
+    offsetX = event.clientX - rect.left - rect.width / 2;
+    handle.setPointerCapture(event.pointerId);
+    options.onDragStart?.(side, event);
+  };
+  const onPointerMove = (event) => {
+    if (handle.dataset.dragging !== "true") return;
+    const ruler = handle.parentElement;
+    if (!ruler) return;
+    const rulerRect = ruler.getBoundingClientRect();
+    const newX = event.clientX - rulerRect.left - offsetX;
+    options.onDrag?.(side, newX, event);
+  };
+  const onPointerUp = (event) => {
+    if (handle.dataset.dragging !== "true") return;
+    handle.dataset.dragging = "";
+    handle.style.backgroundColor = "#ccc";
+    handle.style.cursor = "grab";
+    handle.releasePointerCapture(event.pointerId);
+    const ruler = handle.parentElement;
+    if (!ruler) return;
+    const rulerRect = ruler.getBoundingClientRect();
+    const finalX = event.clientX - rulerRect.left - offsetX;
+    options.onDragEnd?.(side, finalX, event);
+  };
+  handle.addEventListener("pointerdown", onPointerDown);
+  handle.addEventListener("pointermove", onPointerMove);
+  handle.addEventListener("pointerup", onPointerUp);
+  handle.addEventListener("pointercancel", onPointerUp);
+}
+const RULER_STYLES = `
+/* Ruler container */
+.${RULER_CLASS_NAMES.ruler} {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  background-color: transparent;
+}
+
+/* Tick marks base styling */
+.${RULER_CLASS_NAMES.tick} {
+  flex-shrink: 0;
+}
+
+/* Handle hover and active states */
+.${RULER_CLASS_NAMES.handle}:hover {
+  background-color: rgba(37, 99, 235, 0.4) !important;
+}
+
+.${RULER_CLASS_NAMES.handle}:active,
+.${RULER_CLASS_NAMES.handle}[data-dragging="true"] {
+  background-color: rgba(37, 99, 235, 0.6) !important;
+  cursor: grabbing !important;
+}
+
+/* Vertical indicator animation */
+.${RULER_CLASS_NAMES.indicator} {
+  transition: left 16ms linear;
+}
+
+/* Print mode: hide rulers */
+@media print {
+  .${RULER_CLASS_NAMES.ruler} {
+    display: none !important;
+  }
+}
+
+/* High contrast mode support */
+@media (prefers-contrast: high) {
+  .${RULER_CLASS_NAMES.tick} {
+    background-color: #000 !important;
+  }
+
+  .${RULER_CLASS_NAMES.label} {
+    color: #000 !important;
+  }
+
+  .${RULER_CLASS_NAMES.handle} {
+    background-color: #666 !important;
+    border: 1px solid #000;
+  }
+
+  .${RULER_CLASS_NAMES.handle}:hover,
+  .${RULER_CLASS_NAMES.handle}:active {
+    background-color: #0066cc !important;
+  }
+}
+
+/* Reduced motion support */
+@media (prefers-reduced-motion: reduce) {
+  .${RULER_CLASS_NAMES.handle} {
+    transition: none !important;
+  }
+
+  .${RULER_CLASS_NAMES.indicator} {
+    transition: none !important;
+  }
+}
+`;
+let rulerStylesInjected = false;
+function ensureRulerStyles(doc2) {
+  if (rulerStylesInjected || !doc2) return;
+  const styleEl = doc2.createElement("style");
+  styleEl.setAttribute("data-superdoc-ruler-styles", "true");
+  styleEl.textContent = RULER_STYLES;
+  doc2.head?.appendChild(styleEl);
+  rulerStylesInjected = true;
+}
 function isMinimalWordLayout(value) {
   if (typeof value !== "object" || value === null) {
     return false;
@@ -26220,6 +26622,7 @@ function isMinimalWordLayout(value) {
 }
 const LIST_MARKER_GAP$1 = 8;
 const DEFAULT_TAB_INTERVAL_PX$1 = 48;
+const DEFAULT_PAGE_HEIGHT_PX = 1056;
 const COMMENT_EXTERNAL_COLOR = "#B1124B";
 const COMMENT_INTERNAL_COLOR = "#078383";
 const COMMENT_INACTIVE_ALPHA = "22";
@@ -26462,6 +26865,9 @@ const _DomPainter = class _DomPainter {
     ensureFieldAnnotationStyles(doc2);
     ensureSdtContainerStyles(doc2);
     ensureImageSelectionStyles(doc2);
+    if (this.options.ruler?.enabled) {
+      ensureRulerStyles(doc2);
+    }
     mount.classList.add(CLASS_NAMES$1.container);
     if (this.mount && this.mount !== mount) {
       this.resetState();
@@ -26719,6 +27125,12 @@ const _DomPainter = class _DomPainter {
     const el = this.doc.createElement("div");
     el.classList.add(CLASS_NAMES$1.page);
     applyStyles$2(el, pageStyles(width, height, this.getEffectivePageStyles()));
+    if (this.options.ruler?.enabled) {
+      const rulerEl = this.renderPageRuler(width, page);
+      if (rulerEl) {
+        el.appendChild(rulerEl);
+      }
+    }
     const contextBase = {
       pageNumber: page.number,
       totalPages: this.totalPages,
@@ -26731,6 +27143,70 @@ const _DomPainter = class _DomPainter {
     this.renderDecorationsForPage(el, page);
     return el;
   }
+  /**
+   * Render a ruler element for a page.
+   *
+   * Creates a horizontal ruler with tick marks and optional interactive margin handles.
+   * The ruler is positioned at the top of the page and displays inch measurements.
+   *
+   * @param pageWidthPx - Page width in pixels
+   * @param page - Page data containing margins and optional size information
+   * @returns Ruler element, or null if this.doc is unavailable or page margins are missing
+   *
+   * Side effects:
+   * - Creates DOM elements and applies inline styles
+   * - May invoke the onMarginChange callback if interactive mode is enabled
+   *
+   * Fallback behavior:
+   * - Uses DEFAULT_PAGE_HEIGHT_PX (1056px = 11 inches) if page.size.h is not available
+   * - Defaults margins to 0 if not explicitly provided
+   */
+  renderPageRuler(pageWidthPx, page) {
+    if (!this.doc) {
+      console.warn("[renderPageRuler] Cannot render ruler: document is not available.");
+      return null;
+    }
+    if (!page.margins) {
+      console.warn(`[renderPageRuler] Cannot render ruler for page ${page.number}: margins not available.`);
+      return null;
+    }
+    const margins = page.margins;
+    const leftMargin = margins.left ?? 0;
+    const rightMargin = margins.right ?? 0;
+    try {
+      const rulerDefinition = generateRulerDefinitionFromPx({
+        pageWidthPx,
+        pageHeightPx: page.size?.h ?? DEFAULT_PAGE_HEIGHT_PX,
+        leftMarginPx: leftMargin,
+        rightMarginPx: rightMargin
+      });
+      const interactive = this.options.ruler?.interactive ?? false;
+      const onMarginChange = this.options.ruler?.onMarginChange;
+      const rulerEl = createRulerElement({
+        definition: rulerDefinition,
+        doc: this.doc,
+        interactive,
+        onDragEnd: interactive && onMarginChange ? (side, x) => {
+          try {
+            const ppi = 96;
+            const marginInches = side === "left" ? x / ppi : (pageWidthPx - x) / ppi;
+            onMarginChange(side, marginInches);
+          } catch (error) {
+            console.error("[renderPageRuler] Error in onMarginChange callback:", error);
+          }
+        } : void 0
+      });
+      rulerEl.style.position = "absolute";
+      rulerEl.style.top = "0";
+      rulerEl.style.left = "0";
+      rulerEl.style.zIndex = "20";
+      rulerEl.dataset.pageNumber = String(page.number);
+      return rulerEl;
+    } catch (error) {
+      console.error(`[renderPageRuler] Failed to create ruler for page ${page.number}:`, error);
+      return null;
+    }
+  }
   renderDecorationsForPage(pageEl, page) {
     this.renderDecorationSection(pageEl, page, "header");
     this.renderDecorationSection(pageEl, page, "footer");
@@ -29531,7 +30007,8 @@ const createDomPainter = (options) => {
     layoutMode: options.layoutMode,
     headerProvider: options.headerProvider,
     footerProvider: options.footerProvider,
-    virtualization: options.virtualization
+    virtualization: options.virtualization,
+    ruler: options.ruler
   });
   return {
     paint(layout, mount) {
@@ -40273,9 +40750,11 @@ updateLocalAwarenessCursor_fn = function() {
   if (typeof provider.awareness.setLocalStateField !== "function") {
     return;
   }
-  const ystate = ySyncPluginKey.getState(__privateGet(this, _editor3).state);
+  const editorState = __privateGet(this, _editor3)?.state;
+  if (!editorState) return;
+  const ystate = ySyncPluginKey.getState(editorState);
   if (!ystate?.binding?.mapping) return;
-  const { selection } = __privateGet(this, _editor3).state;
+  const { selection } = editorState;
   const { anchor, head } = selection;
   try {
     const relAnchor = absolutePositionToRelativePosition(anchor, ystate.type, ystate.binding.mapping);
@@ -40298,7 +40777,9 @@ updateLocalAwarenessCursor_fn = function() {
 normalizeAwarenessStates_fn = function() {
   const provider = __privateGet(this, _options).collaborationProvider;
   if (!provider?.awareness) return /* @__PURE__ */ new Map();
-  const ystate = ySyncPluginKey.getState(__privateGet(this, _editor3).state);
+  const editorState = __privateGet(this, _editor3)?.state;
+  if (!editorState) return /* @__PURE__ */ new Map();
+  const ystate = ySyncPluginKey.getState(editorState);
   if (!ystate) return /* @__PURE__ */ new Map();
   const states = provider.awareness?.getStates();
   const normalized = /* @__PURE__ */ new Map();
@@ -41305,7 +41786,8 @@ ensurePainter_fn = function(blocks, measures) {
       virtualization: __privateGet(this, _layoutOptions).virtualization,
       pageStyles: __privateGet(this, _layoutOptions).pageStyles,
       headerProvider: __privateGet(this, _headerDecorationProvider),
-      footerProvider: __privateGet(this, _footerDecorationProvider)
+      footerProvider: __privateGet(this, _footerDecorationProvider),
+      ruler: __privateGet(this, _layoutOptions).ruler
     }));
   }
   return __privateGet(this, _domPainter);
@@ -62420,11 +62902,14 @@ const getStarterExtensions = () => {
 };
 export {
   Attribute as A,
-  SectionHelpers as B,
-  getAllowedImageDimensions as C,
+  index$1 as B,
+  index as C,
   DecorationSet as D,
   Editor as E,
-  CommentsPluginKey as F,
+  AnnotatorHelpers as F,
+  SectionHelpers as G,
+  getAllowedImageDimensions as H,
+  CommentsPluginKey as I,
   Mark as M,
   Node$1 as N,
   PresentationEditor as P,
@@ -62443,18 +62928,18 @@ export {
   redoDepth as j,
   getEditorSurfaceElement as k,
   collectTrackedChangesForContext as l,
-  measureCache as m,
-  isHeadless as n,
-  getStarterExtensions as o,
-  Placeholder as p,
-  getRichTextExtensions as q,
+  generateRulerDefinition as m,
+  clampHandlePosition as n,
+  calculateMarginFromHandle as o,
+  measureCache as p,
+  isHeadless as q,
   replaceSelectionWithImagePlaceholder as r,
   shouldBypassContextMenu as s,
-  Decoration as t,
+  getStarterExtensions as t,
   useHighContrastMode as u,
-  Extension as v,
-  index$1 as w,
-  index as x,
+  Placeholder as v,
+  getRichTextExtensions as w,
+  Decoration as x,
   yUndoPluginKey as y,
-  AnnotatorHelpers as z
+  Extension as z
 };

package/dist/super-editor/chunks/{index-GAzIoyrZ.js → index-u8dj63PM.js}

@@ -1,4 +1,4 @@
-import { aK as getDefaultExportFromCjs } from "./converter-DZ7Tkh7u.js";
+import { aK as getDefaultExportFromCjs } from "./converter-DaSkPzA9.js";
 import { V as VFile } from "./index-CvBqQJbG.js";
 function bail(error) {
   if (error) {

package/dist/super-editor/chunks/{toolbar-DL3rTlKm.js → toolbar-C4OC-AnI.js}

@@ -1,6 +1,6 @@
 import { computed, createElementBlock, openBlock, createElementVNode, createCommentVNode, normalizeClass, normalizeStyle, ref, withKeys, unref, withModifiers, createBlock, toDisplayString, withDirectives, vModelText, nextTick, getCurrentInstance, onMounted, onBeforeUnmount, createVNode, readonly, watch, reactive, onBeforeMount, inject, onActivated, onDeactivated, createTextVNode, Fragment, Comment, defineComponent, provide, h, Teleport, toRef, renderSlot, isVNode, shallowRef, watchEffect, mergeProps, Transition, vShow, cloneVNode, Text, renderList, withCtx } from "vue";
-import { p as process$1 } from "./converter-DZ7Tkh7u.js";
-import { _ as _export_sfc, u as useHighContrastMode, g as global$1 } from "./editor-CDMuD1Nx.js";
+import { p as process$1 } from "./converter-DaSkPzA9.js";
+import { _ as _export_sfc, u as useHighContrastMode, g as global$1 } from "./editor-45pxcsTR.js";
 const sanitizeNumber = (value, defaultNumber) => {
   let sanitized = value.replace(/[^0-9.]/g, "");
   sanitized = parseFloat(sanitized);

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

@@ -1,4 +1,4 @@
-import { ac } from "./chunks/converter-DZ7Tkh7u.js";
+import { ac } from "./chunks/converter-DaSkPzA9.js";
 export {
   ac as SuperConverter
 };

package/dist/super-editor/docx-zipper.es.js

@@ -1,5 +1,5 @@
-import "./chunks/converter-DZ7Tkh7u.js";
-import { D } from "./chunks/docx-zipper-CZQWEuyi.js";
+import "./chunks/converter-DaSkPzA9.js";
+import { D } from "./chunks/docx-zipper-Cx1zgQ8B.js";
 export {
   D as default
 };