superdoc 1.0.0-beta.60 → 1.0.0-beta.62

package/dist/superdoc.umd.js

@@ -42132,11 +42132,71 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       return JSON.parse(xmljs.xml2json(newXml, null, 2));
     }
     /**
-     * Generic method to get a stored custom property from docx
+     * Checks if an element name matches the expected local name, with or without namespace prefix.
+     * This helper supports custom namespace prefixes in DOCX files (e.g., 'op:Properties', 'custom:property').
+     *
+     * @private
+     * @static
+     * @param {string|undefined|null} elementName - The element name to check (may include namespace prefix)
+     * @param {string} expectedLocalName - The expected local name without prefix
+     * @returns {boolean} True if the element name matches (with or without prefix)
+     *
+     * @example
+     * // Exact match without prefix
+     * _matchesElementName('Properties', 'Properties') // => true
+     *
+     * @example
+     * // Match with namespace prefix
+     * _matchesElementName('op:Properties', 'Properties') // => true
+     * _matchesElementName('custom:property', 'property') // => true
+     *
+     * @example
+     * // No match
+     * _matchesElementName('SomeOtherElement', 'Properties') // => false
+     * _matchesElementName(':Properties', 'Properties') // => false (empty prefix)
+     */
+    static _matchesElementName(elementName, expectedLocalName) {
+      if (!elementName || typeof elementName !== "string") return false;
+      if (!expectedLocalName) return false;
+      if (elementName === expectedLocalName) return true;
+      if (elementName.endsWith(`:${expectedLocalName}`)) {
+        const prefix2 = elementName.slice(0, -(expectedLocalName.length + 1));
+        return prefix2.length > 0;
+      }
+      return false;
+    }
+    /**
+     * Generic method to get a stored custom property from docx.
+     * Supports both standard and custom namespace prefixes (e.g., 'op:Properties', 'custom:property').
+     *
      * @static
      * @param {Array} docx - Array of docx file objects
      * @param {string} propertyName - Name of the property to retrieve
      * @returns {string|null} The property value or null if not found
+     *
+     * Returns null in the following cases:
+     * - docx array is empty or doesn't contain 'docProps/custom.xml'
+     * - custom.xml cannot be parsed
+     * - Properties element is not found (with or without namespace prefix)
+     * - Property with the specified name is not found
+     * - Property has malformed structure (missing nested elements or text)
+     * - Any error occurs during parsing or retrieval
+     *
+     * @example
+     * // Standard property without namespace prefix
+     * const version = SuperConverter.getStoredCustomProperty(docx, 'SuperdocVersion');
+     * // => '1.2.3'
+     *
+     * @example
+     * // Property with namespace prefix (e.g., from Office 365)
+     * const guid = SuperConverter.getStoredCustomProperty(docx, 'DocumentGuid');
+     * // Works with both 'Properties' and 'op:Properties' elements
+     * // => 'abc-123-def-456'
+     *
+     * @example
+     * // Non-existent property
+     * const missing = SuperConverter.getStoredCustomProperty(docx, 'NonExistent');
+     * // => null
      */
     static getStoredCustomProperty(docx, propertyName) {
       try {
@@ -42145,10 +42205,16 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         const converter = new _SuperConverter2();
         const content2 = customXml.content;
         const contentJson = converter.parseXmlToJson(content2);
-        const properties = contentJson.elements.find((el) => el.name === "Properties");
-        if (!properties.elements) return null;
-        const property2 = properties.elements.find((el) => el.name === "property" && el.attributes.name === propertyName);
+        const properties = contentJson?.elements?.find((el) => _SuperConverter2._matchesElementName(el.name, "Properties"));
+        if (!properties?.elements) return null;
+        const property2 = properties.elements.find(
+          (el) => _SuperConverter2._matchesElementName(el.name, "property") && el.attributes?.name === propertyName
+        );
         if (!property2) return null;
+        if (!property2.elements?.[0]?.elements?.[0]?.text) {
+          console.warn(`Malformed property structure for "${propertyName}"`);
+          return null;
+        }
         return property2.elements[0].elements[0].text;
       } catch (e) {
         console.warn(`Error getting custom property ${propertyName}:`, e);
@@ -42156,60 +42222,112 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       }
     }
     /**
-     * Generic method to set a stored custom property in docx
+     * Generic method to set a stored custom property in docx.
+     * Supports both standard and custom namespace prefixes (e.g., 'op:Properties', 'custom:property').
+     *
      * @static
-     * @param {Object} docx - The docx object to store the property in
+     * @param {Object} docx - The docx object to store the property in (converted XML structure)
      * @param {string} propertyName - Name of the property
      * @param {string|Function} value - Value or function that returns the value
      * @param {boolean} preserveExisting - If true, won't overwrite existing values
-     * @returns {string} The stored value
+     * @returns {string|null} The stored value, or null if Properties element is not found
+     *
+     * @throws {Error} If an error occurs during property setting (logged as warning)
+     *
+     * @example
+     * // Set a new property
+     * const value = SuperConverter.setStoredCustomProperty(docx, 'MyProperty', 'MyValue');
+     * // => 'MyValue'
+     *
+     * @example
+     * // Set a property with a function
+     * const guid = SuperConverter.setStoredCustomProperty(docx, 'DocumentGuid', () => uuidv4());
+     * // => 'abc-123-def-456'
+     *
+     * @example
+     * // Preserve existing value
+     * SuperConverter.setStoredCustomProperty(docx, 'MyProperty', 'NewValue', true);
+     * // => 'MyValue' (original value preserved)
+     *
+     * @example
+     * // Works with namespace prefixes
+     * // If docx has 'op:Properties' and 'op:property' elements, this will handle them correctly
+     * const version = SuperConverter.setStoredCustomProperty(docx, 'Version', '2.0.0');
+     * // => '2.0.0'
      */
     static setStoredCustomProperty(docx, propertyName, value, preserveExisting = false) {
-      const customLocation = "docProps/custom.xml";
-      if (!docx[customLocation]) docx[customLocation] = generateCustomXml();
-      const customXml = docx[customLocation];
-      const properties = customXml.elements?.find((el) => el.name === "Properties");
-      if (!properties) return null;
-      if (!properties.elements) properties.elements = [];
-      let property2 = properties.elements.find((el) => el.name === "property" && el.attributes.name === propertyName);
-      if (property2 && preserveExisting) {
-        return property2.elements[0].elements[0].text;
-      }
-      const finalValue = typeof value === "function" ? value() : value;
-      if (!property2) {
-        const existingPids = properties.elements.filter((el) => el.attributes?.pid).map((el) => parseInt(el.attributes.pid, 10)).filter(Number.isInteger);
-        const pid = existingPids.length > 0 ? Math.max(...existingPids) + 1 : 2;
-        property2 = {
-          type: "element",
-          name: "property",
-          attributes: {
-            name: propertyName,
-            fmtid: "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}",
-            pid
-          },
-          elements: [
-            {
-              type: "element",
-              name: "vt:lpwstr",
-              elements: [
-                {
-                  type: "text",
-                  text: finalValue
-                }
-              ]
-            }
-          ]
-        };
-        properties.elements.push(property2);
-      } else {
-        property2.elements[0].elements[0].text = finalValue;
+      try {
+        const customLocation = "docProps/custom.xml";
+        if (!docx[customLocation]) docx[customLocation] = generateCustomXml();
+        const customXml = docx[customLocation];
+        const properties = customXml.elements?.find((el) => _SuperConverter2._matchesElementName(el.name, "Properties"));
+        if (!properties) return null;
+        if (!properties.elements) properties.elements = [];
+        let property2 = properties.elements.find(
+          (el) => _SuperConverter2._matchesElementName(el.name, "property") && el.attributes?.name === propertyName
+        );
+        if (property2 && preserveExisting) {
+          if (!property2.elements?.[0]?.elements?.[0]?.text) {
+            console.warn(`Malformed existing property structure for "${propertyName}"`);
+            return null;
+          }
+          return property2.elements[0].elements[0].text;
+        }
+        const finalValue = typeof value === "function" ? value() : value;
+        if (!property2) {
+          const existingPids = properties.elements.filter((el) => el.attributes?.pid).map((el) => parseInt(el.attributes.pid, 10)).filter(Number.isInteger);
+          const pid = existingPids.length > 0 ? Math.max(...existingPids) + 1 : 2;
+          property2 = {
+            type: "element",
+            name: "property",
+            attributes: {
+              name: propertyName,
+              fmtid: "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}",
+              pid
+            },
+            elements: [
+              {
+                type: "element",
+                name: "vt:lpwstr",
+                elements: [
+                  {
+                    type: "text",
+                    text: finalValue
+                  }
+                ]
+              }
+            ]
+          };
+          properties.elements.push(property2);
+        } else {
+          if (!property2.elements?.[0]?.elements?.[0]) {
+            console.warn(`Malformed property structure for "${propertyName}", recreating structure`);
+            property2.elements = [
+              {
+                type: "element",
+                name: "vt:lpwstr",
+                elements: [
+                  {
+                    type: "text",
+                    text: finalValue
+                  }
+                ]
+              }
+            ];
+          } else {
+            property2.elements[0].elements[0].text = finalValue;
+          }
+        }
+        return finalValue;
+      } catch (e) {
+        console.warn(`Error setting custom property ${propertyName}:`, e);
+        return null;
       }
-      return finalValue;
     }
     static getStoredSuperdocVersion(docx) {
       return _SuperConverter2.getStoredCustomProperty(docx, "SuperdocVersion");
     }
-    static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.0.0-beta.60") {
+    static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.0.0-beta.62") {
       return _SuperConverter2.setStoredCustomProperty(docx, "SuperdocVersion", version2, false);
     }
     /**
@@ -67255,7 +67373,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   const shouldSkipNodeView = (editor) => {
     return isHeadless(editor);
   };
-  const summaryVersion = "1.0.0-beta.60";
+  const summaryVersion = "1.0.0-beta.62";
   const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
   const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
   function mapAttributes(attrs) {
@@ -68044,7 +68162,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         { default: remarkStringify2 },
         { default: remarkGfm2 }
       ] = await Promise.all([
-        Promise.resolve().then(() => indexGAzIoyrZ),
+        Promise.resolve().then(() => indexXOsGE2PW),
         Promise.resolve().then(() => indexDRCvimau),
         Promise.resolve().then(() => indexC_x_N6Uh),
         Promise.resolve().then(() => indexD_sWOSiG),
@@ -68249,7 +68367,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
      * 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.62");
       if (!this.options.ydoc) return;
       const metaMap = this.options.ydoc.getMap("meta");
       let docVersion = metaMap.get("version");
@@ -72222,12 +72340,6 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     resolveSpacingIndent: resolveSpacingIndent$1,
     scaleWrapPolygon
   }, Symbol.toStringTag, { value: "Module" }));
-  const extractHeaderFooterSpace = (margins) => {
-    return {
-      headerSpace: margins?.header ?? 0,
-      footerSpace: margins?.footer ?? 0
-    };
-  };
   const hasParagraphStyleContext = (context) => {
     return Boolean(context?.docx);
   };
@@ -79415,6 +79527,408 @@ ${l}
     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(config2) {
+    const ppi = config2.ppi ?? DEFAULT_PPI;
+    const heightPx = config2.heightPx ?? DEFAULT_RULER_HEIGHT;
+    const { pageSize, pageMargins } = config2;
+    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 i2 = 0; i2 < 3; i2++) {
+        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 i2 = 0; i2 < 3; i2++) {
+        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(config2) {
+    const ppi = config2.ppi ?? DEFAULT_PPI;
+    const heightPx = config2.heightPx ?? DEFAULT_RULER_HEIGHT;
+    const { pageWidthPx, leftMarginPx, rightMarginPx } = config2;
+    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(config2.pageHeightPx) || config2.pageHeightPx <= 0) {
+      throw new Error(`Invalid page height: ${config2.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 i2 = 0; i2 < 3; i2++) {
+        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 i2 = 0; i2 < 3; i2++) {
+        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: definition2, doc: doc2, interactive = false } = options;
+    if (!Number.isFinite(definition2.widthPx) || definition2.widthPx <= 0) {
+      console.warn(`[createRulerElement] Invalid ruler width: ${definition2.widthPx}px. Using minimum width of 1px.`);
+      definition2.widthPx = Math.max(1, definition2.widthPx || 1);
+    }
+    if (!definition2.ticks || definition2.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: ${definition2.widthPx}px;
+    height: ${definition2.heightPx}px;
+    display: flex;
+    align-items: flex-end;
+    box-sizing: border-box;
+    user-select: none;
+    pointer-events: ${interactive ? "auto" : "none"};
+  `;
+    for (const tick of definition2.ticks) {
+      const tickEl = createTickElement(tick, doc2);
+      ruler.appendChild(tickEl);
+    }
+    if (interactive) {
+      const leftHandle = createHandleElement("left", definition2.leftMarginPx, doc2, options);
+      const rightHandle = createHandleElement("right", definition2.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, x2, doc2, options) {
+    const handle2 = doc2.createElement("div");
+    const sideClass = side === "left" ? RULER_CLASS_NAMES.handleLeft : RULER_CLASS_NAMES.handleRight;
+    handle2.className = `${RULER_CLASS_NAMES.handle} ${sideClass}`;
+    handle2.dataset.side = side;
+    handle2.style.cssText = `
+    position: absolute;
+    left: ${x2}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;
+  `;
+    handle2.addEventListener("mouseenter", () => {
+      if (!handle2.dataset.dragging) {
+        handle2.style.backgroundColor = "rgba(37, 99, 235, 0.4)";
+      }
+    });
+    handle2.addEventListener("mouseleave", () => {
+      if (!handle2.dataset.dragging) {
+        handle2.style.backgroundColor = "#ccc";
+      }
+    });
+    if (options.onDragStart || options.onDrag || options.onDragEnd) {
+      setupHandleDrag(handle2, side, options);
+    }
+    return handle2;
+  }
+  function setupHandleDrag(handle2, side, options) {
+    let offsetX = 0;
+    const onPointerDown = (event) => {
+      event.preventDefault();
+      handle2.dataset.dragging = "true";
+      handle2.style.backgroundColor = "rgba(37, 99, 235, 0.4)";
+      handle2.style.cursor = "grabbing";
+      const rect = handle2.getBoundingClientRect();
+      offsetX = event.clientX - rect.left - rect.width / 2;
+      handle2.setPointerCapture(event.pointerId);
+      options.onDragStart?.(side, event);
+    };
+    const onPointerMove = (event) => {
+      if (handle2.dataset.dragging !== "true") return;
+      const ruler = handle2.parentElement;
+      if (!ruler) return;
+      const rulerRect = ruler.getBoundingClientRect();
+      const newX = event.clientX - rulerRect.left - offsetX;
+      options.onDrag?.(side, newX, event);
+    };
+    const onPointerUp = (event) => {
+      if (handle2.dataset.dragging !== "true") return;
+      handle2.dataset.dragging = "";
+      handle2.style.backgroundColor = "#ccc";
+      handle2.style.cursor = "grab";
+      handle2.releasePointerCapture(event.pointerId);
+      const ruler = handle2.parentElement;
+      if (!ruler) return;
+      const rulerRect = ruler.getBoundingClientRect();
+      const finalX = event.clientX - rulerRect.left - offsetX;
+      options.onDragEnd?.(side, finalX, event);
+    };
+    handle2.addEventListener("pointerdown", onPointerDown);
+    handle2.addEventListener("pointermove", onPointerMove);
+    handle2.addEventListener("pointerup", onPointerUp);
+    handle2.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;
@@ -79461,6 +79975,7 @@ ${l}
   }
   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";
@@ -79703,6 +80218,9 @@ ${l}
       ensureFieldAnnotationStyles(doc2);
       ensureSdtContainerStyles(doc2);
       ensureImageSelectionStyles(doc2);
+      if (this.options.ruler?.enabled) {
+        ensureRulerStyles(doc2);
+      }
       mount2.classList.add(CLASS_NAMES$1.container);
       if (this.mount && this.mount !== mount2) {
         this.resetState();
@@ -79960,6 +80478,12 @@ ${l}
       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,
@@ -79972,6 +80496,70 @@ ${l}
       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, x2) => {
+            try {
+              const ppi = 96;
+              const marginInches = side === "left" ? x2 / ppi : (pageWidthPx - x2) / 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");
@@ -80003,6 +80591,7 @@ ${l}
       container.style.height = `${data.height}px`;
       container.style.top = `${Math.max(0, offset2)}px`;
       container.style.zIndex = "1";
+      container.style.overflow = "visible";
       let footerYOffset = 0;
       if (kind === "footer" && data.fragments.length > 0) {
         const contentHeight = typeof data.contentHeight === "number" ? data.contentHeight : data.fragments.reduce((max2, f2) => {
@@ -82772,7 +83361,8 @@ ${l}
       layoutMode: options.layoutMode,
       headerProvider: options.headerProvider,
       footerProvider: options.footerProvider,
-      virtualization: options.virtualization
+      virtualization: options.virtualization,
+      ruler: options.ruler
     });
     return {
       paint(layout, mount2) {
@@ -89014,7 +89604,14 @@ ${l}
         leftJustifiedMarkerSpace = markerBoxWidth + gutterWidth;
       }
     }
-    const initialAvailableWidth = Math.max(1, contentWidth - firstLineOffset - leftJustifiedMarkerSpace);
+    let initialAvailableWidth;
+    const isFirstLineIndentMode = wordLayout?.firstLineIndentMode === true;
+    const textStartPx = wordLayout?.textStartPx;
+    if (isFirstLineIndentMode && typeof textStartPx === "number" && textStartPx > 0) {
+      initialAvailableWidth = Math.max(1, maxWidth - textStartPx - indentRight);
+    } else {
+      initialAvailableWidth = Math.max(1, contentWidth - firstLineOffset - leftJustifiedMarkerSpace);
+    }
     const tabStops = buildTabStopsPx(
       indent2,
       block.attrs?.tabs,
@@ -90990,7 +91587,9 @@ ${l}
       const batch2 = {};
       let hasBlocks = false;
       descriptors.forEach((descriptor) => {
-        if (!descriptor.variant) return;
+        if (!descriptor.variant) {
+          return;
+        }
         const blocks2 = __privateMethod$1(this, _HeaderFooterLayoutAdapter_instances, getBlocks_fn).call(this, descriptor);
         if (blocks2 && blocks2.length > 0) {
           batch2[descriptor.variant] = blocks2;
@@ -93300,9 +93899,11 @@ ${l}
     if (typeof provider2.awareness.setLocalStateField !== "function") {
       return;
     }
-    const ystate = ySyncPluginKey.getState(__privateGet$1(this, _editor3).state);
+    const editorState = __privateGet$1(this, _editor3)?.state;
+    if (!editorState) return;
+    const ystate = ySyncPluginKey.getState(editorState);
     if (!ystate?.binding?.mapping) return;
-    const { selection } = __privateGet$1(this, _editor3).state;
+    const { selection } = editorState;
     const { anchor, head } = selection;
     try {
       const relAnchor = absolutePositionToRelativePosition(anchor, ystate.type, ystate.binding.mapping);
@@ -93320,7 +93921,9 @@ ${l}
   normalizeAwarenessStates_fn = function() {
     const provider2 = __privateGet$1(this, _options).collaborationProvider;
     if (!provider2?.awareness) return /* @__PURE__ */ new Map();
-    const ystate = ySyncPluginKey.getState(__privateGet$1(this, _editor3).state);
+    const editorState = __privateGet$1(this, _editor3)?.state;
+    if (!editorState) return /* @__PURE__ */ new Map();
+    const ystate = ySyncPluginKey.getState(editorState);
     if (!ystate) return /* @__PURE__ */ new Map();
     const states = provider2.awareness?.getStates();
     const normalized = /* @__PURE__ */ new Map();
@@ -94113,7 +94716,8 @@ ${l}
         virtualization: __privateGet$1(this, _layoutOptions).virtualization,
         pageStyles: __privateGet$1(this, _layoutOptions).pageStyles,
         headerProvider: __privateGet$1(this, _headerDecorationProvider),
-        footerProvider: __privateGet$1(this, _footerDecorationProvider)
+        footerProvider: __privateGet$1(this, _footerDecorationProvider),
+        ruler: __privateGet$1(this, _layoutOptions).ruler
       }));
     }
     return __privateGet$1(this, _domPainter);
@@ -94252,14 +94856,20 @@ ${l}
     const margins = __privateGet$1(this, _layoutOptions).margins ?? DEFAULT_MARGINS;
     const marginLeft = margins.left ?? DEFAULT_MARGINS.left;
     const marginRight = margins.right ?? DEFAULT_MARGINS.right;
-    const width = pageSize.w - (marginLeft + marginRight);
-    if (!Number.isFinite(width) || width <= 0) {
+    const bodyContentWidth = pageSize.w - (marginLeft + marginRight);
+    if (!Number.isFinite(bodyContentWidth) || bodyContentWidth <= 0) {
       return null;
     }
-    const { headerSpace, footerSpace } = extractHeaderFooterSpace(margins);
-    const height = Math.max(headerSpace, footerSpace, 1);
+    const measurementWidth = bodyContentWidth;
+    const marginTop = margins.top ?? DEFAULT_MARGINS.top;
+    const marginBottom = margins.bottom ?? DEFAULT_MARGINS.bottom;
+    const headerMargin = margins.header ?? 0;
+    const footerMargin = margins.footer ?? 0;
+    const headerContentSpace = Math.max(marginTop - headerMargin, 0);
+    const footerContentSpace = Math.max(marginBottom - footerMargin, 0);
+    const height = Math.max(headerContentSpace, footerContentSpace, 1);
     return {
-      width,
+      width: measurementWidth,
       height,
       // Pass actual page dimensions for page-relative anchor positioning in headers/footers
       pageWidth: pageSize.w,
@@ -128199,6 +128809,7 @@ ${style2}
          */
         toggleRuler: () => {
           this.superdoc.toggleRuler();
+          this.updateToolbarState();
         },
         /**
          * Initiates the image upload process
@@ -128624,6 +129235,13 @@ ${style2}
             item.activate();
           }
         }
+        if (item.name.value === "ruler") {
+          if (this.superdoc?.config?.rulers) {
+            item.activate();
+          } else {
+            item.deactivate();
+          }
+        }
       });
     }
     /**
@@ -130057,8 +130675,12 @@ ${style2}
       };
     }
   };
-  const _hoisted_1$4$1 = { class: "numbering" };
+  const _hoisted_1$4$1 = {
+    key: 0,
+    class: "numbering"
+  };
   const MIN_WIDTH = 200;
+  const PPI = 96;
   const alignment = "flex-end";
   const _sfc_main$6$1 = {
     __name: "Ruler",
@@ -130081,7 +130703,7 @@ ${style2}
       const emit2 = __emit;
       const props = __props;
       const ruler = ref(null);
-      const rulerDefinition = ref([]);
+      const rulerDefinition = ref(null);
       const rulerHandleOriginalColor = ref("#CCCCCC");
       const rulerHandleActiveColor = ref("#2563EB66");
       const pageSize = ref(null);
@@ -130094,45 +130716,32 @@ ${style2}
       const initialX = ref(0);
       let offsetX = 0;
       const initRuler = () => {
-        if (props.editor.options.mode !== "docx") return;
-        const rulerItems = [];
+        if (props.editor.options.mode !== "docx") return null;
         const { pageMargins: docMargins, pageSize: docSize } = props.editor.getPageStyles();
         pageSize.value = docSize;
         pageMargins.value = docMargins;
-        rightHandle.x = docSize.width * 96 - docMargins.right * 96;
-        leftHandle.x = docMargins.left * 96;
-        for (let i2 = 0; i2 < docSize.width; i2++) {
-          const marginNum = 0.0625 * 96 - 0.5;
-          const margin = `${marginNum}px`;
-          const diff = docSize.width - i2;
-          rulerItems.push(...generateSection(1, "main", "20%", margin, i2));
-          rulerItems.push(...generateSection(3, "eighth", "10%", margin));
-          rulerItems.push(...generateSection(1, "half", "40%", margin));
-          if (diff <= 0.5) break;
-          rulerItems.push(...generateSection(3, "eighth", "10%", margin));
-        }
-        return rulerItems;
-      };
-      const generateSection = (qty, size2, height, margin, index2) => {
-        return Array.from({ length: qty }, (_2, i2) => {
-          const item = {
-            className: `${size2}-unit ruler-section`,
-            height,
-            margin
-          };
-          if (index2 !== void 0) item.numbering = index2;
-          return item;
+        const definition2 = generateRulerDefinition({
+          pageSize: { width: docSize.width, height: docSize.height },
+          pageMargins: {
+            left: docMargins.left,
+            right: docMargins.right,
+            top: docMargins.top ?? 1,
+            bottom: docMargins.bottom ?? 1
+          }
         });
+        leftHandle.x = definition2.leftMarginPx;
+        rightHandle.x = definition2.rightMarginPx;
+        return definition2;
       };
-      const getStyle = computed(() => (unit) => {
+      const getTickStyle = computed(() => (tick) => {
         return {
+          position: "absolute",
+          left: `${tick.x}px`,
+          bottom: "0",
           width: "1px",
-          minWidth: "1px",
-          maxWidth: "1px",
-          height: unit.height,
-          backgroundColor: unit.color || "#666",
-          marginLeft: unit.numbering === 0 ? null : unit.margin,
-          marginRight: unit.margin
+          height: tick.height,
+          backgroundColor: "#666",
+          pointerEvents: "none"
         };
       });
       const getHandlePosition = computed(() => (side) => {
@@ -130144,7 +130753,8 @@ ${style2}
       const getVerticalIndicatorStyle = computed(() => {
         if (!ruler.value) return;
         const parentElement = ruler.value.parentElement;
-        const editor = parentElement.querySelector(".super-editor");
+        const editor = parentElement?.querySelector(".super-editor") ?? document.querySelector(".super-editor");
+        if (!editor) return { left: `${currentHandle.value.x}px`, minHeight: "100%" };
         const editorBounds = editor.getBoundingClientRect();
         return {
           left: `${currentHandle.value.x}px`,
@@ -130161,22 +130771,11 @@ ${style2}
         showVerticalIndicator.value = true;
       };
       const handleMouseMove2 = (event) => {
-        if (!isDragging.value) return;
+        if (!isDragging.value || !pageSize.value) return;
         const newLeft = event.clientX - offsetX;
-        currentHandle.value.x = newLeft;
-        if (currentHandle.value.side === "left") {
-          if (newLeft <= 0) {
-            currentHandle.value.x = 0;
-          } else if (newLeft >= rightHandle.x - MIN_WIDTH) {
-            currentHandle.value.x = rightHandle.x - MIN_WIDTH;
-          }
-        } else {
-          if (newLeft >= pageSize.value.width * 96) {
-            currentHandle.value.x = pageSize.value.width * 96;
-          } else if (newLeft <= leftHandle.x + MIN_WIDTH) {
-            currentHandle.value.x = leftHandle.x + MIN_WIDTH;
-          }
-        }
+        const pageWidthPx = pageSize.value.width * PPI;
+        const otherHandleX = currentHandle.value.side === "left" ? rightHandle.x : leftHandle.x;
+        currentHandle.value.x = clampHandlePosition(newLeft, currentHandle.value.side, otherHandleX, pageWidthPx, MIN_WIDTH);
       };
       const handleMouseUp = () => {
         isDragging.value = false;
@@ -130197,14 +130796,17 @@ ${style2}
         rulerHandleOriginalColor.value = "#CCC";
       };
       const getNewMarginValue = () => {
-        if (currentHandle.value.side === "left") return currentHandle.value.x / 96;
-        else return (pageSize.value.width * 96 - currentHandle.value.x) / 96;
+        if (!pageSize.value) return 0;
+        const pageWidthPx = pageSize.value.width * PPI;
+        return calculateMarginFromHandle(currentHandle.value.x, currentHandle.value.side, pageWidthPx, PPI);
       };
       const getStyleVars = computed(() => {
+        const width = rulerDefinition.value?.widthPx ?? pageSize.value?.width * PPI ?? 816;
         return {
           "--alignment": alignment,
           "--ruler-handle-color": rulerHandleOriginalColor.value,
-          "--ruler-handle-active-color": rulerHandleActiveColor.value
+          "--ruler-handle-active-color": rulerHandleActiveColor.value,
+          "--ruler-width": `${width}px`
         };
       });
       onMounted(() => {
@@ -130240,32 +130842,20 @@ ${style2}
             class: "vertical-indicator",
             style: normalizeStyle(getVerticalIndicatorStyle.value)
           }, null, 4)) : createCommentVNode("", true),
-          (openBlock(true), createElementBlock(Fragment, null, renderList(rulerDefinition.value, (unit) => {
+          rulerDefinition.value ? (openBlock(true), createElementBlock(Fragment, { key: 1 }, renderList(rulerDefinition.value.ticks, (tick, index2) => {
             return openBlock(), createElementBlock("div", {
-              class: normalizeClass(unit.className),
-              style: normalizeStyle(getStyle.value(unit))
+              key: index2,
+              class: normalizeClass(["ruler-tick", `ruler-tick--${tick.size}`]),
+              style: normalizeStyle(getTickStyle.value(tick))
             }, [
-              createBaseVNode("div", _hoisted_1$4$1, toDisplayString(unit.numbering), 1),
-              (openBlock(true), createElementBlock(Fragment, null, renderList(unit.elements, (half) => {
-                return openBlock(), createElementBlock("div", {
-                  class: normalizeClass(half.className),
-                  style: normalizeStyle(getStyle.value(half))
-                }, [
-                  (openBlock(true), createElementBlock(Fragment, null, renderList(half.elements, (quarter) => {
-                    return openBlock(), createElementBlock("div", {
-                      class: normalizeClass(quarter.className),
-                      style: normalizeStyle(getStyle.value(quarter))
-                    }, null, 6);
-                  }), 256))
-                ], 6);
-              }), 256))
+              tick.label !== void 0 ? (openBlock(), createElementBlock("span", _hoisted_1$4$1, toDisplayString(tick.label), 1)) : createCommentVNode("", true)
             ], 6);
-          }), 256))
+          }), 128)) : createCommentVNode("", true)
         ], 4);
       };
     }
   };
-  const Ruler = /* @__PURE__ */ _export_sfc$1(_sfc_main$6$1, [["__scopeId", "data-v-79f9a944"]]);
+  const Ruler = /* @__PURE__ */ _export_sfc$1(_sfc_main$6$1, [["__scopeId", "data-v-b9f4f30a"]]);
   const _sfc_main$5$1 = {
     __name: "GenericPopover",
     props: {
@@ -131446,7 +132036,7 @@ ${style2}
   const BlankDOCX$1 = "data:application/octet-stream;base64,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";
   const _hoisted_1$1$1 = { class: "super-editor-container" };
   const _hoisted_2$a = {
-    key: 1,
+    key: 2,
     class: "placeholder-editor"
   };
   const _hoisted_3$8 = { class: "placeholder-title" };
@@ -131491,6 +132081,19 @@ ${style2}
         const active = activeEditor.value;
         return active?.options ? Boolean(active.options.disableContextMenu) : Boolean(props.options.disableContextMenu);
       });
+      const rulersVisible = ref(Boolean(props.options.rulers));
+      watch(
+        () => props.options,
+        (newOptions) => {
+          const rulers = newOptions?.rulers;
+          if (rulers && typeof rulers === "object" && "value" in rulers) {
+            rulersVisible.value = Boolean(rulers.value);
+          } else {
+            rulersVisible.value = Boolean(rulers);
+          }
+        },
+        { immediate: true, deep: true }
+      );
       const message = useMessage();
       const editorWrapper = ref(null);
       const editorElem = ref(null);
@@ -131903,8 +132506,17 @@ ${style2}
       });
       return (_ctx, _cache) => {
         return openBlock(), createElementBlock("div", _hoisted_1$1$1, [
-          __props.options.rulers && !!activeEditor.value ? (openBlock(), createBlock(Ruler, {
+          __props.options.rulerContainer && rulersVisible.value && !!activeEditor.value ? (openBlock(), createBlock(Teleport, {
             key: 0,
+            to: __props.options.rulerContainer
+          }, [
+            createVNode(Ruler, {
+              class: "ruler superdoc-ruler",
+              editor: activeEditor.value,
+              onMarginChange: handleMarginChange
+            }, null, 8, ["editor"])
+          ], 8, ["to"])) : rulersVisible.value && !!activeEditor.value ? (openBlock(), createBlock(Ruler, {
+            key: 1,
             class: "ruler",
             editor: activeEditor.value,
             onMarginChange: handleMarginChange
@@ -131998,7 +132610,7 @@ ${style2}
             })
           ])) : createCommentVNode("", true),
           activeEditor.value ? (openBlock(), createBlock(GenericPopover, {
-            key: 2,
+            key: 3,
             editor: activeEditor.value,
             visible: popoverControls.visible,
             position: popoverControls.position,
@@ -132013,7 +132625,7 @@ ${style2}
       };
     }
   });
-  const SuperEditor = /* @__PURE__ */ _export_sfc$1(_sfc_main$1$1, [["__scopeId", "data-v-a935d3e2"]]);
+  const SuperEditor = /* @__PURE__ */ _export_sfc$1(_sfc_main$1$1, [["__scopeId", "data-v-cb3fe66f"]]);
   const _hoisted_1$h = ["innerHTML"];
   const _sfc_main$i = {
     __name: "SuperInput",
@@ -148624,6 +149236,7 @@ ${style2}
           markdown: doc2.markdown,
           documentMode: proxy.$superdoc.config.documentMode,
           rulers: doc2.rulers,
+          rulerContainer: proxy.$superdoc.config.rulerContainer,
           isInternal: proxy.$superdoc.config.isInternal,
           annotations: proxy.$superdoc.config.annotations,
           isCommentsEnabled: Boolean(commentsModuleConfig.value),
@@ -148999,7 +149612,7 @@ ${style2}
                         "file-source": doc2.data,
                         state: doc2.state,
                         "document-id": doc2.id,
-                        options: editorOptions(doc2),
+                        options: { ...editorOptions(doc2), rulers: doc2.rulers },
                         onEditorReady,
                         onPageMarginsChange: ($event) => handleSuperEditorPageMarginsChange(doc2, $event)
                       }, null, 8, ["file-source", "state", "document-id", "options", "onPageMarginsChange"])) : createCommentVNode("", true)
@@ -149052,7 +149665,7 @@ ${style2}
       };
     }
   };
-  const App = /* @__PURE__ */ _export_sfc(_sfc_main$1, [["__scopeId", "data-v-5b2a75a6"]]);
+  const App = /* @__PURE__ */ _export_sfc(_sfc_main$1, [["__scopeId", "data-v-e229774d"]]);
   const createSuperdocVueApp = () => {
     const app = createApp(App);
     const pinia = createPinia();
@@ -149232,7 +149845,7 @@ ${style2}
       this.config.colors = shuffleArray(this.config.colors);
       this.userColorMap = /* @__PURE__ */ new Map();
       this.colorIndex = 0;
-      this.version = "1.0.0-beta.60";
+      this.version = "1.0.0-beta.62";
       this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
       this.superdocId = config2.superdocId || v4();
       this.colors = this.config.colors;
@@ -149573,6 +150186,10 @@ ${style2}
       const moduleConfig = this.config.modules?.toolbar || {};
       this.toolbarElement = this.config.modules?.toolbar?.selector || this.config.toolbar;
       this.toolbar = null;
+      const excludeItems = [...moduleConfig.excludeItems || []];
+      if (!this.config.rulers) {
+        excludeItems.push("ruler");
+      }
       const config2 = {
         selector: this.toolbarElement || null,
         isDev: this.isDev || false,
@@ -149587,7 +150204,9 @@ ${style2}
         superdoc: this,
         aiApiKey: this.config.modules?.ai?.apiKey,
         aiEndpoint: this.config.modules?.ai?.endpoint,
-        ...moduleConfig
+        ...moduleConfig,
+        excludeItems
+        // Override moduleConfig.excludeItems with our computed list
       };
       this.toolbar = new SuperToolbar(config2);
       this.toolbar.on("superdoc-command", this.onToolbarCommand.bind(this));
@@ -151698,7 +152317,7 @@ ${style2}
       value && typeof value === "object" && "byteLength" in value && "byteOffset" in value
     );
   }
-  const indexGAzIoyrZ = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  const indexXOsGE2PW = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     __proto__: null,
     unified
   }, Symbol.toStringTag, { value: "Module" }));