react-native-richify 1.0.0

package/lib/module/hooks/useRichText.js

@@ -0,0 +1,132 @@
+"use strict";
+
+import { useState, useCallback, useRef } from 'react';
+import { EMPTY_FORMAT_STYLE } from '@/constants/defaultStyles';
+import { createSegment, segmentsToPlainText, reconcileTextChange, findPositionInSegments } from '@/utils/parser';
+import { useSelection } from '@/hooks/useSelection';
+import { useFormatting } from '@/hooks/useFormatting';
+/**
+ * Main hook for the rich text editor.
+ *
+ * Manages the complete editor state (segments, selection, active styles)
+ * and exposes all actions needed to build a rich text UI.
+ */
+export function useRichText(options = {}) {
+  const {
+    initialSegments,
+    onChangeSegments,
+    onChangeText
+  } = options;
+
+  // ─── State ───────────────────────────────────────────────────────────────
+
+  const [segments, setSegments] = useState(() => {
+    if (initialSegments && initialSegments.length > 0) {
+      return initialSegments;
+    }
+    return [createSegment('')];
+  });
+  const [activeStyles, setActiveStyles] = useState({
+    ...EMPTY_FORMAT_STYLE
+  });
+  const {
+    selection,
+    handleSelectionChange
+  } = useSelection();
+
+  // Refs for stable access in callbacks
+  const segmentsRef = useRef(segments);
+  segmentsRef.current = segments;
+  const activeStylesRef = useRef(activeStyles);
+  activeStylesRef.current = activeStyles;
+
+  // ─── Segment Change Handler ──────────────────────────────────────────────
+
+  const updateSegments = useCallback(newSegments => {
+    setSegments(newSegments);
+    onChangeSegments?.(newSegments);
+    onChangeText?.(segmentsToPlainText(newSegments));
+  }, [onChangeSegments, onChangeText]);
+
+  // ─── Formatting ──────────────────────────────────────────────────────────
+
+  const formatting = useFormatting({
+    segments,
+    selection,
+    activeStyles,
+    onSegmentsChange: updateSegments,
+    onActiveStylesChange: setActiveStyles
+  });
+
+  // ─── Text Change Handler ─────────────────────────────────────────────────
+
+  const handleTextChange = useCallback(newText => {
+    const currentSegments = segmentsRef.current;
+    const currentActiveStyles = activeStylesRef.current;
+    const newSegments = reconcileTextChange(currentSegments, newText, currentActiveStyles);
+    updateSegments(newSegments);
+  }, [updateSegments]);
+
+  // ─── Selection Change Handler ────────────────────────────────────────────
+
+  const onSelectionChange = useCallback(newSelection => {
+    handleSelectionChange(newSelection);
+
+    // Update active styles based on cursor position
+    if (newSelection.start === newSelection.end) {
+      const pos = findPositionInSegments(segmentsRef.current, newSelection.start);
+      if (segmentsRef.current.length > 0) {
+        const seg = segmentsRef.current[pos.segmentIndex];
+        setActiveStyles({
+          ...seg.styles
+        });
+      }
+    }
+  }, [handleSelectionChange]);
+
+  // ─── Export / Import ─────────────────────────────────────────────────────
+
+  const getPlainText = useCallback(() => {
+    return segmentsToPlainText(segmentsRef.current);
+  }, []);
+  const exportJSON = useCallback(() => {
+    return JSON.parse(JSON.stringify(segmentsRef.current));
+  }, []);
+  const importJSON = useCallback(newSegments => {
+    const safeSegments = newSegments.length > 0 ? newSegments : [createSegment('')];
+    updateSegments(safeSegments);
+  }, [updateSegments]);
+  const clear = useCallback(() => {
+    updateSegments([createSegment('')]);
+    setActiveStyles({
+      ...EMPTY_FORMAT_STYLE
+    });
+  }, [updateSegments]);
+
+  // ─── Build Return Value ──────────────────────────────────────────────────
+
+  const state = {
+    segments,
+    selection,
+    activeStyles
+  };
+  const actions = {
+    toggleFormat: formatting.toggleFormat,
+    setStyleProperty: formatting.setStyleProperty,
+    setHeading: formatting.setHeading,
+    setColor: formatting.setColor,
+    setBackgroundColor: formatting.setBackgroundColor,
+    setFontSize: formatting.setFontSize,
+    handleTextChange,
+    handleSelectionChange: onSelectionChange,
+    getPlainText,
+    exportJSON,
+    importJSON,
+    clear
+  };
+  return {
+    state,
+    actions
+  };
+}
+//# sourceMappingURL=useRichText.js.map

package/lib/module/hooks/useRichText.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useCallback","useRef","EMPTY_FORMAT_STYLE","createSegment","segmentsToPlainText","reconcileTextChange","findPositionInSegments","useSelection","useFormatting","useRichText","options","initialSegments","onChangeSegments","onChangeText","segments","setSegments","length","activeStyles","setActiveStyles","selection","handleSelectionChange","segmentsRef","current","activeStylesRef","updateSegments","newSegments","formatting","onSegmentsChange","onActiveStylesChange","handleTextChange","newText","currentSegments","currentActiveStyles","onSelectionChange","newSelection","start","end","pos","seg","segmentIndex","styles","getPlainText","exportJSON","JSON","parse","stringify","importJSON","safeSegments","clear","state","actions","toggleFormat","setStyleProperty","setHeading","setColor","setBackgroundColor","setFontSize"],"sourceRoot":"..\\..\\..\\src","sources":["hooks/useRichText.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/useSelection.d.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=useSelection.d.js.map

package/lib/module/hooks/useSelection.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"..\\..\\..\\src","sources":["hooks/useSelection.d.ts"],"mappings":"","ignoreList":[]}

package/lib/module/hooks/useSelection.js

@@ -0,0 +1,35 @@
+"use strict";
+
+import { useState, useCallback, useRef } from 'react';
+/**
+ * Hook for tracking TextInput selection state.
+ *
+ * Returns the current selection and a handler to update it.
+ */
+export function useSelection(initialSelection) {
+  const [selection, setSelection] = useState(initialSelection ?? {
+    start: 0,
+    end: 0
+  });
+
+  // Use a ref to avoid stale closures in callbacks
+  const selectionRef = useRef(selection);
+  selectionRef.current = selection;
+  const handleSelectionChange = useCallback(newSelection => {
+    setSelection(newSelection);
+  }, []);
+  const getSelection = useCallback(() => {
+    return selectionRef.current;
+  }, []);
+  const hasSelection = useCallback(() => {
+    return selectionRef.current.start !== selectionRef.current.end;
+  }, []);
+  return {
+    selection,
+    setSelection,
+    handleSelectionChange,
+    getSelection,
+    hasSelection
+  };
+}
+//# sourceMappingURL=useSelection.js.map

package/lib/module/hooks/useSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useCallback","useRef","useSelection","initialSelection","selection","setSelection","start","end","selectionRef","current","handleSelectionChange","newSelection","getSelection","hasSelection"],"sourceRoot":"..\\..\\..\\src","sources":["hooks/useSelection.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,WAAW,EAAEC,MAAM,QAAQ,OAAO;AAGrD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,gBAAiC,EAAE;EAC9D,MAAM,CAACC,SAAS,EAAEC,YAAY,CAAC,GAAGN,QAAQ,CACxCI,gBAAgB,IAAI;IAAEG,KAAK,EAAE,CAAC;IAAEC,GAAG,EAAE;EAAE,CACzC,CAAC;;EAED;EACA,MAAMC,YAAY,GAAGP,MAAM,CAACG,SAAS,CAAC;EACtCI,YAAY,CAACC,OAAO,GAAGL,SAAS;EAEhC,MAAMM,qBAAqB,GAAGV,WAAW,CACtCW,YAA4B,IAAK;IAChCN,YAAY,CAACM,YAAY,CAAC;EAC5B,CAAC,EACD,EACF,CAAC;EAED,MAAMC,YAAY,GAAGZ,WAAW,CAAC,MAAsB;IACrD,OAAOQ,YAAY,CAACC,OAAO;EAC7B,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMI,YAAY,GAAGb,WAAW,CAAC,MAAe;IAC9C,OAAOQ,YAAY,CAACC,OAAO,CAACH,KAAK,KAAKE,YAAY,CAACC,OAAO,CAACF,GAAG;EAChE,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IACLH,SAAS;IACTC,YAAY;IACZK,qBAAqB;IACrBE,YAAY;IACZC;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/index.d.js

@@ -0,0 +1,15 @@
+"use strict";
+
+export { RichTextInput } from '@/components/RichTextInput';
+export { OverlayText } from '@/components/OverlayText';
+export { Toolbar } from '@/components/Toolbar';
+export { ToolbarButton } from '@/components/ToolbarButton';
+export { useRichText } from '@/hooks/useRichText';
+export { useSelection } from '@/hooks/useSelection';
+export { useFormatting } from '@/hooks/useFormatting';
+export { RichTextProvider, useRichTextContext } from '@/context/RichTextContext';
+export { createSegment, segmentsToPlainText, getTotalLength, mergeAdjacentSegments, reconcileTextChange } from '@/utils/parser';
+export { toggleFormatOnSelection, setStyleOnSelection, setHeadingOnLine, isFormatActiveInSelection, getSelectionStyle } from '@/utils/formatter';
+export { formatStyleToTextStyle, segmentToTextStyle, segmentsToTextStyles } from '@/utils/styleMapper';
+export { DEFAULT_COLORS, DEFAULT_THEME, DEFAULT_TOOLBAR_ITEMS, DEFAULT_BASE_TEXT_STYLE, HEADING_FONT_SIZES, EMPTY_FORMAT_STYLE } from '@/constants/defaultStyles';
+//# sourceMappingURL=index.d.js.map

package/lib/module/index.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RichTextInput","OverlayText","Toolbar","ToolbarButton","useRichText","useSelection","useFormatting","RichTextProvider","useRichTextContext","createSegment","segmentsToPlainText","getTotalLength","mergeAdjacentSegments","reconcileTextChange","toggleFormatOnSelection","setStyleOnSelection","setHeadingOnLine","isFormatActiveInSelection","getSelectionStyle","formatStyleToTextStyle","segmentToTextStyle","segmentsToTextStyles","DEFAULT_COLORS","DEFAULT_THEME","DEFAULT_TOOLBAR_ITEMS","DEFAULT_BASE_TEXT_STYLE","HEADING_FONT_SIZES","EMPTY_FORMAT_STYLE"],"sourceRoot":"..\\..\\src","sources":["index.d.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,4BAA4B;AAC1D,SAASC,WAAW,QAAQ,0BAA0B;AACtD,SAASC,OAAO,QAAQ,sBAAsB;AAC9C,SAASC,aAAa,QAAQ,4BAA4B;AAC1D,SAASC,WAAW,QAAQ,qBAAqB;AAEjD,SAASC,YAAY,QAAQ,sBAAsB;AACnD,SAASC,aAAa,QAAQ,uBAAuB;AACrD,SAASC,gBAAgB,EAAEC,kBAAkB,QAAS,2BAA2B;AAEjF,SAASC,aAAa,EAAEC,mBAAmB,EAAEC,cAAc,EAAEC,qBAAqB,EAAEC,mBAAmB,QAAS,gBAAgB;AAChI,SAASC,uBAAuB,EAAEC,mBAAmB,EAAEC,gBAAgB,EAAEC,yBAAyB,EAAEC,iBAAiB,QAAS,mBAAmB;AACjJ,SAASC,sBAAsB,EAAEC,kBAAkB,EAAEC,oBAAoB,QAAS,qBAAqB;AACvG,SAASC,cAAc,EAAEC,aAAa,EAAEC,qBAAqB,EAAEC,uBAAuB,EAAEC,kBAAkB,EAAEC,kBAAkB,QAAS,2BAA2B","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,25 @@
+"use strict";
+
+// ─── Components ──────────────────────────────────────────────────────────────
+export { RichTextInput } from '@/components/RichTextInput';
+export { OverlayText } from '@/components/OverlayText';
+export { Toolbar } from '@/components/Toolbar';
+export { ToolbarButton } from '@/components/ToolbarButton';
+
+// ─── Hooks ───────────────────────────────────────────────────────────────────
+export { useRichText } from '@/hooks/useRichText';
+export { useSelection } from '@/hooks/useSelection';
+export { useFormatting } from '@/hooks/useFormatting';
+
+// ─── Context ─────────────────────────────────────────────────────────────────
+export { RichTextProvider, useRichTextContext } from '@/context/RichTextContext';
+// ─── Utilities ───────────────────────────────────────────────────────────────
+export { createSegment, segmentsToPlainText, getTotalLength, mergeAdjacentSegments, reconcileTextChange } from '@/utils/parser';
+export { toggleFormatOnSelection, setStyleOnSelection, setHeadingOnLine, isFormatActiveInSelection, getSelectionStyle } from '@/utils/formatter';
+export { formatStyleToTextStyle, segmentToTextStyle, segmentsToTextStyles } from '@/utils/styleMapper';
+
+// ─── Constants ───────────────────────────────────────────────────────────────
+export { DEFAULT_COLORS, DEFAULT_THEME, DEFAULT_TOOLBAR_ITEMS, DEFAULT_BASE_TEXT_STYLE, HEADING_FONT_SIZES, EMPTY_FORMAT_STYLE } from '@/constants/defaultStyles';
+
+// ─── Types ───────────────────────────────────────────────────────────────────
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RichTextInput","OverlayText","Toolbar","ToolbarButton","useRichText","useSelection","useFormatting","RichTextProvider","useRichTextContext","createSegment","segmentsToPlainText","getTotalLength","mergeAdjacentSegments","reconcileTextChange","toggleFormatOnSelection","setStyleOnSelection","setHeadingOnLine","isFormatActiveInSelection","getSelectionStyle","formatStyleToTextStyle","segmentToTextStyle","segmentsToTextStyles","DEFAULT_COLORS","DEFAULT_THEME","DEFAULT_TOOLBAR_ITEMS","DEFAULT_BASE_TEXT_STYLE","HEADING_FONT_SIZES","EMPTY_FORMAT_STYLE"],"sourceRoot":"..\\..\\src","sources":["index.ts"],"mappings":";;AAAA;AACA,SAASA,aAAa,QAAQ,4BAA4B;AAC1D,SAASC,WAAW,QAAQ,0BAA0B;AACtD,SAASC,OAAO,QAAQ,sBAAsB;AAC9C,SAASC,aAAa,QAAQ,4BAA4B;;AAE1D;AACA,SAASC,WAAW,QAAQ,qBAAqB;AAEjD,SAASC,YAAY,QAAQ,sBAAsB;AACnD,SAASC,aAAa,QAAQ,uBAAuB;;AAErD;AACA,SACEC,gBAAgB,EAChBC,kBAAkB,QACb,2BAA2B;AAGlC;AACA,SACEC,aAAa,EACbC,mBAAmB,EACnBC,cAAc,EACdC,qBAAqB,EACrBC,mBAAmB,QACd,gBAAgB;AACvB,SACEC,uBAAuB,EACvBC,mBAAmB,EACnBC,gBAAgB,EAChBC,yBAAyB,EACzBC,iBAAiB,QACZ,mBAAmB;AAC1B,SACEC,sBAAsB,EACtBC,kBAAkB,EAClBC,oBAAoB,QACf,qBAAqB;;AAE5B;AACA,SACEC,cAAc,EACdC,aAAa,EACbC,qBAAqB,EACrBC,uBAAuB,EACvBC,kBAAkB,EAClBC,kBAAkB,QACb,2BAA2B;;AAElC","ignoreList":[]}

package/lib/module/types/index.d.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=index.d.js.map

package/lib/module/types/index.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"..\\..\\..\\src","sources":["types/index.d.ts"],"mappings":"","ignoreList":[]}

package/lib/module/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=index.js.map

package/lib/module/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"..\\..\\..\\src","sources":["types/index.ts"],"mappings":"","ignoreList":[]}

package/lib/module/utils/formatter.d.js

@@ -0,0 +1,30 @@
+"use strict";
+
+/**
+ * Toggle an inline format (bold, italic, etc.) on the selected range.
+ *
+ * If the entire selection already has the format, it is removed.
+ * Otherwise, it is applied to the entire selection.
+ *
+ * Returns the new segments array.
+ */
+
+/**
+ * Set a specific style property on the selected range.
+ */
+
+/**
+ * Apply a heading level to the line containing the cursor/selection.
+ */
+
+/**
+ * Checks whether the given format is active across the entire selection.
+ */
+
+/**
+ * Gets the format style that is common across the entire selection.
+ * For properties where segments disagree, the value is undefined.
+ */
+
+export { createSegment } from '@/utils/parser';
+//# sourceMappingURL=formatter.d.js.map

package/lib/module/utils/formatter.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createSegment"],"sourceRoot":"..\\..\\..\\src","sources":["utils/formatter.d.ts"],"mappings":";;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,gBAAgB","ignoreList":[]}

package/lib/module/utils/formatter.js

@@ -0,0 +1,217 @@
+"use strict";
+
+import { createSegment, findPositionInSegments, mergeAdjacentSegments, segmentsToPlainText } from '@/utils/parser';
+import { HEADING_FONT_SIZES } from '@/constants/defaultStyles';
+
+/**
+ * Toggle an inline format (bold, italic, etc.) on the selected range.
+ *
+ * If the entire selection already has the format, it is removed.
+ * Otherwise, it is applied to the entire selection.
+ *
+ * Returns the new segments array.
+ */
+export function toggleFormatOnSelection(segments, selection, format) {
+  if (selection.start === selection.end) {
+    // No selection — return unchanged (active styles handle this case)
+    return segments;
+  }
+  const {
+    start,
+    end
+  } = normalizeSelection(selection);
+
+  // Extract the selected segments to check current state
+  const selectedSegments = extractSegmentsInRange(segments, start, end);
+  const allHaveFormat = selectedSegments.every(s => !!s.styles[format]);
+
+  // Apply or remove the format
+  return applyStyleToRange(segments, start, end, {
+    [format]: !allHaveFormat
+  });
+}
+
+/**
+ * Set a specific style property on the selected range.
+ */
+export function setStyleOnSelection(segments, selection, key, value) {
+  if (selection.start === selection.end) {
+    return segments;
+  }
+  const {
+    start,
+    end
+  } = normalizeSelection(selection);
+  return applyStyleToRange(segments, start, end, {
+    [key]: value
+  });
+}
+
+/**
+ * Apply a heading level to the line containing the cursor/selection.
+ */
+export function setHeadingOnLine(segments, selection, level) {
+  const plainText = segmentsToPlainText(segments);
+  const {
+    lineStart,
+    lineEnd
+  } = getLineRange(plainText, selection.start);
+  const headingStyle = {
+    heading: level,
+    fontSize: HEADING_FONT_SIZES[level],
+    bold: level !== 'none' ? true : undefined
+  };
+  return applyStyleToRange(segments, lineStart, lineEnd, headingStyle);
+}
+
+/**
+ * Checks whether the given format is active across the entire selection.
+ */
+export function isFormatActiveInSelection(segments, selection, format) {
+  if (selection.start === selection.end) {
+    return false;
+  }
+  const {
+    start,
+    end
+  } = normalizeSelection(selection);
+  const selected = extractSegmentsInRange(segments, start, end);
+  return selected.length > 0 && selected.every(s => !!s.styles[format]);
+}
+
+/**
+ * Gets the format style that is common across the entire selection.
+ * For properties where segments disagree, the value is undefined.
+ */
+export function getSelectionStyle(segments, selection) {
+  if (selection.start === selection.end) {
+    // Return style at cursor position
+    const pos = findPositionInSegments(segments, selection.start);
+    if (segments.length > 0) {
+      return {
+        ...segments[pos.segmentIndex].styles
+      };
+    }
+    return {};
+  }
+  const {
+    start,
+    end
+  } = normalizeSelection(selection);
+  const selected = extractSegmentsInRange(segments, start, end);
+  if (selected.length === 0) return {};
+  const result = {
+    ...selected[0].styles
+  };
+  for (let i = 1; i < selected.length; i++) {
+    const s = selected[i].styles;
+    if (result.bold !== undefined && result.bold !== !!s.bold) result.bold = undefined;
+    if (result.italic !== undefined && result.italic !== !!s.italic) result.italic = undefined;
+    if (result.underline !== undefined && result.underline !== !!s.underline) result.underline = undefined;
+    if (result.strikethrough !== undefined && result.strikethrough !== !!s.strikethrough) result.strikethrough = undefined;
+    if (result.code !== undefined && result.code !== !!s.code) result.code = undefined;
+    if (result.color !== s.color) result.color = undefined;
+    if (result.backgroundColor !== s.backgroundColor) result.backgroundColor = undefined;
+    if (result.fontSize !== s.fontSize) result.fontSize = undefined;
+    if (result.heading !== s.heading) result.heading = undefined;
+  }
+  return result;
+}
+
+// ─── Internal Helpers ────────────────────────────────────────────────────────
+
+/**
+ * Normalize selection so start <= end.
+ */
+function normalizeSelection(selection) {
+  return {
+    start: Math.min(selection.start, selection.end),
+    end: Math.max(selection.start, selection.end)
+  };
+}
+
+/**
+ * Extract the text segments that fall within [start, end) of the global text.
+ */
+function extractSegmentsInRange(segments, start, end) {
+  const result = [];
+  let pos = 0;
+  for (const seg of segments) {
+    const segStart = pos;
+    const segEnd = pos + seg.text.length;
+    if (segEnd <= start) {
+      pos = segEnd;
+      continue;
+    }
+    if (segStart >= end) {
+      break;
+    }
+
+    // This segment overlaps with [start, end)
+    const overlapStart = Math.max(segStart, start);
+    const overlapEnd = Math.min(segEnd, end);
+    result.push(createSegment(seg.text.slice(overlapStart - segStart, overlapEnd - segStart), seg.styles));
+    pos = segEnd;
+  }
+  return result;
+}
+
+/**
+ * Apply a partial style to a character range within the segments array.
+ * Splits segments at boundaries and applies the style delta to all segments in range.
+ */
+function applyStyleToRange(segments, start, end, styleDelta) {
+  const result = [];
+  let pos = 0;
+  for (const seg of segments) {
+    const segStart = pos;
+    const segEnd = pos + seg.text.length;
+    if (segEnd <= start || segStart >= end) {
+      // Outside the range — keep as-is
+      result.push(createSegment(seg.text, seg.styles));
+    } else {
+      // Overlaps with range — may need to split
+      if (segStart < start) {
+        // Portion before the range
+        result.push(createSegment(seg.text.slice(0, start - segStart), seg.styles));
+      }
+
+      // The overlapping portion — apply style delta
+      const overlapStart = Math.max(segStart, start);
+      const overlapEnd = Math.min(segEnd, end);
+      const newStyles = {
+        ...seg.styles,
+        ...styleDelta
+      };
+      result.push(createSegment(seg.text.slice(overlapStart - segStart, overlapEnd - segStart), newStyles));
+      if (segEnd > end) {
+        // Portion after the range
+        result.push(createSegment(seg.text.slice(end - segStart), seg.styles));
+      }
+    }
+    pos = segEnd;
+  }
+  return mergeAdjacentSegments(result);
+}
+
+/**
+ * Get the line start and end positions for the line containing the given position.
+ */
+function getLineRange(text, position) {
+  let lineStart = position;
+  while (lineStart > 0 && text[lineStart - 1] !== '\n') {
+    lineStart--;
+  }
+  let lineEnd = position;
+  while (lineEnd < text.length && text[lineEnd] !== '\n') {
+    lineEnd++;
+  }
+  return {
+    lineStart,
+    lineEnd
+  };
+}
+
+// Re-export for convenience
+export { createSegment } from '@/utils/parser';
+//# sourceMappingURL=formatter.js.map

package/lib/module/utils/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createSegment","findPositionInSegments","mergeAdjacentSegments","segmentsToPlainText","HEADING_FONT_SIZES","toggleFormatOnSelection","segments","selection","format","start","end","normalizeSelection","selectedSegments","extractSegmentsInRange","allHaveFormat","every","s","styles","applyStyleToRange","setStyleOnSelection","key","value","setHeadingOnLine","level","plainText","lineStart","lineEnd","getLineRange","headingStyle","heading","fontSize","bold","undefined","isFormatActiveInSelection","selected","length","getSelectionStyle","pos","segmentIndex","result","i","italic","underline","strikethrough","code","color","backgroundColor","Math","min","max","seg","segStart","segEnd","text","overlapStart","overlapEnd","push","slice","styleDelta","newStyles","position"],"sourceRoot":"..\\..\\..\\src","sources":["utils/formatter.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/parser.d.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=parser.d.js.map

package/lib/module/utils/parser.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"..\\..\\..\\src","sources":["utils/parser.d.ts"],"mappings":"","ignoreList":[]}