@eclosion-tech/react-native-yjs-text 0.1.0

package/build/useYTextEditor.js

@@ -0,0 +1,166 @@
+import { useMemo } from 'react';
+import { formatRange, inheritedMarksAt, marksInRange, transactProgrammatic } from './bridge';
+import { getEditor } from './internal/editorRegistry';
+import { validateMarks } from './schema';
+/**
+ * Build a stable imperative editor handle bound to `yText`.
+ *
+ * Returns the same `YTextEditor` instance across re-renders so that consumers
+ * can pass commands to event handlers without re-binding. The commands resolve
+ * the *current* live native view at call time via the editor registry — so
+ * unmounting and remounting the `YTextInput` doesn't break a toolbar that's
+ * holding the editor handle.
+ *
+ * If no `YTextInput` is currently mounted for this Y.Text, commands that need
+ * a live view (focus, selection-dependent mark toggles) gracefully no-op. Pure
+ * Y.Text mutations (`insertText` with explicit ranges via `deleteRange`,
+ * `setMark` on a known selection) still work — useful for programmatic edits.
+ *
+ * @param yText The Y.Text this editor mutates.
+ * @param schema The schema declaring which marks are valid.
+ */
+export function useYTextEditor(yText, schema) {
+    return useMemo(() => {
+        function currentSelection() {
+            const handle = getEditor(yText);
+            return handle?.getSelection() ?? null;
+        }
+        function pendingMarks() {
+            return getEditor(yText)?.getPendingMarks() ?? {};
+        }
+        function setPendingMarks(marks) {
+            getEditor(yText)?.setPendingMarks(marks);
+        }
+        return {
+            getSelection: currentSelection,
+            setSelection(range) {
+                getEditor(yText)?.setSelection(range);
+            },
+            toggleMark(name, attrs) {
+                const sel = currentSelection();
+                if (!sel)
+                    return;
+                // Validate first — if the mark isn't in the schema, we drop on the floor.
+                const { sanitised, violations } = validateMarks({ [name]: attrs ?? {} }, schema);
+                if (violations.length > 0 || !(name in sanitised))
+                    return;
+                const normalisedAttrs = sanitised[name];
+                if (sel.from === sel.to) {
+                    // Collapsed selection: toggle pending mark. The next typed
+                    // character will adopt it (or strip it if turning off).
+                    const pending = pendingMarks();
+                    const inherited = inheritedMarksAt(yText, sel.from);
+                    const isOnInherited = name in inherited;
+                    const isOnPending = name in pending;
+                    const isOn = isOnPending ? Boolean(pending[name]) : isOnInherited;
+                    const next = { ...pending };
+                    if (isOn) {
+                        // Mark is currently on for the next-character — turn it off.
+                        // We have to distinguish: if it's on via inheritance, set
+                        // `false` so the insert path overrides; if only via pending,
+                        // delete the pending entry.
+                        if (isOnInherited)
+                            next[name] = false;
+                        else
+                            delete next[name];
+                    }
+                    else {
+                        next[name] = normalisedAttrs;
+                    }
+                    setPendingMarks(next);
+                    return;
+                }
+                // Range selection: format the range. Turn on unless every char
+                // already has the mark, in which case turn off.
+                const common = marksInRange(yText, sel.from, sel.to);
+                const allHaveIt = name in common;
+                formatRange(yText, sel.from, sel.to, name, allHaveIt ? null : normalisedAttrs);
+            },
+            setMark(name, attrs) {
+                const sel = currentSelection();
+                if (!sel)
+                    return;
+                const { sanitised, violations } = validateMarks({ [name]: attrs ?? {} }, schema);
+                if (violations.length > 0 || !(name in sanitised))
+                    return;
+                if (sel.from === sel.to) {
+                    setPendingMarks({ ...pendingMarks(), [name]: sanitised[name] });
+                    return;
+                }
+                formatRange(yText, sel.from, sel.to, name, sanitised[name]);
+            },
+            removeMark(name) {
+                const sel = currentSelection();
+                if (!sel)
+                    return;
+                if (sel.from === sel.to) {
+                    const pending = pendingMarks();
+                    const inherited = inheritedMarksAt(yText, sel.from);
+                    const next = { ...pending };
+                    if (name in inherited) {
+                        next[name] = false;
+                    }
+                    else {
+                        delete next[name];
+                    }
+                    setPendingMarks(next);
+                    return;
+                }
+                formatRange(yText, sel.from, sel.to, name, null);
+            },
+            marksAtSelection() {
+                const sel = currentSelection();
+                if (!sel)
+                    return {};
+                const base = sel.from === sel.to
+                    ? inheritedMarksAt(yText, sel.from)
+                    : marksInRange(yText, sel.from, sel.to);
+                // Overlay pending marks: `false` removes, anything truthy replaces.
+                const pending = pendingMarks();
+                const merged = { ...base };
+                for (const [name, value] of Object.entries(pending)) {
+                    if (value === false)
+                        delete merged[name];
+                    else
+                        merged[name] = value;
+                }
+                return merged;
+            },
+            insertText(text, attrs) {
+                const sel = currentSelection() ?? { from: yText.length, to: yText.length };
+                transactProgrammatic(yText, () => {
+                    if (sel.from !== sel.to) {
+                        yText.delete(sel.from, sel.to - sel.from);
+                    }
+                    if (text.length === 0)
+                        return;
+                    const inherited = inheritedMarksAt(yText, sel.from);
+                    const combined = {
+                        ...inherited,
+                        ...pendingMarks(),
+                        ...(attrs ?? {}),
+                    };
+                    const { sanitised } = validateMarks(combined, schema);
+                    yText.insert(sel.from, text, Object.keys(sanitised).length > 0 ? sanitised : undefined);
+                });
+            },
+            deleteRange(from, to) {
+                if (to <= from)
+                    return;
+                transactProgrammatic(yText, () => {
+                    yText.delete(from, to - from);
+                });
+            },
+            focus() {
+                getEditor(yText)?.focus();
+            },
+            blur() {
+                getEditor(yText)?.blur();
+            },
+            isFocused() {
+                return getEditor(yText)?.isFocused() ?? false;
+            },
+        };
+    }, [yText, schema]);
+}
+//# sourceMappingURL=useYTextEditor.js.map

package/build/useYTextEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useYTextEditor.js","sourceRoot":"","sources":["../src/useYTextEditor.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react';\nimport type * as Y from 'yjs';\n\nimport { formatRange, inheritedMarksAt, marksInRange, transactProgrammatic } from './bridge';\nimport { getEditor } from './internal/editorRegistry';\nimport { validateMarks } from './schema';\nimport type { MarkAttrs, Schema, SelectionRange, YTextEditor } from './types';\n\n/**\n * Build a stable imperative editor handle bound to `yText`.\n *\n * Returns the same `YTextEditor` instance across re-renders so that consumers\n * can pass commands to event handlers without re-binding. The commands resolve\n * the *current* live native view at call time via the editor registry — so\n * unmounting and remounting the `YTextInput` doesn't break a toolbar that's\n * holding the editor handle.\n *\n * If no `YTextInput` is currently mounted for this Y.Text, commands that need\n * a live view (focus, selection-dependent mark toggles) gracefully no-op. Pure\n * Y.Text mutations (`insertText` with explicit ranges via `deleteRange`,\n * `setMark` on a known selection) still work — useful for programmatic edits.\n *\n * @param yText The Y.Text this editor mutates.\n * @param schema The schema declaring which marks are valid.\n */\nexport function useYTextEditor(yText: Y.Text, schema: Schema): YTextEditor {\n  return useMemo<YTextEditor>(() => {\n    function currentSelection(): SelectionRange | null {\n      const handle = getEditor(yText);\n      return handle?.getSelection() ?? null;\n    }\n\n    function pendingMarks(): MarkAttrs {\n      return getEditor(yText)?.getPendingMarks() ?? {};\n    }\n\n    function setPendingMarks(marks: MarkAttrs): void {\n      getEditor(yText)?.setPendingMarks(marks);\n    }\n\n    return {\n      getSelection: currentSelection,\n\n      setSelection(range) {\n        getEditor(yText)?.setSelection(range);\n      },\n\n      toggleMark(name, attrs) {\n        const sel = currentSelection();\n        if (!sel) return;\n        // Validate first — if the mark isn't in the schema, we drop on the floor.\n        const { sanitised, violations } = validateMarks({ [name]: attrs ?? {} }, schema);\n        if (violations.length > 0 || !(name in sanitised)) return;\n        const normalisedAttrs = sanitised[name] as MarkAttrs;\n\n        if (sel.from === sel.to) {\n          // Collapsed selection: toggle pending mark. The next typed\n          // character will adopt it (or strip it if turning off).\n          const pending = pendingMarks();\n          const inherited = inheritedMarksAt(yText, sel.from);\n          const isOnInherited = name in inherited;\n          const isOnPending = name in pending;\n          const isOn = isOnPending ? Boolean(pending[name]) : isOnInherited;\n          const next: MarkAttrs = { ...pending };\n          if (isOn) {\n            // Mark is currently on for the next-character — turn it off.\n            // We have to distinguish: if it's on via inheritance, set\n            // `false` so the insert path overrides; if only via pending,\n            // delete the pending entry.\n            if (isOnInherited) next[name] = false;\n            else delete next[name];\n          } else {\n            next[name] = normalisedAttrs;\n          }\n          setPendingMarks(next);\n          return;\n        }\n\n        // Range selection: format the range. Turn on unless every char\n        // already has the mark, in which case turn off.\n        const common = marksInRange(yText, sel.from, sel.to);\n        const allHaveIt = name in common;\n        formatRange(yText, sel.from, sel.to, name, allHaveIt ? null : normalisedAttrs);\n      },\n\n      setMark(name, attrs) {\n        const sel = currentSelection();\n        if (!sel) return;\n        const { sanitised, violations } = validateMarks({ [name]: attrs ?? {} }, schema);\n        if (violations.length > 0 || !(name in sanitised)) return;\n        if (sel.from === sel.to) {\n          setPendingMarks({ ...pendingMarks(), [name]: sanitised[name] as MarkAttrs });\n          return;\n        }\n        formatRange(yText, sel.from, sel.to, name, sanitised[name] as MarkAttrs);\n      },\n\n      removeMark(name) {\n        const sel = currentSelection();\n        if (!sel) return;\n        if (sel.from === sel.to) {\n          const pending = pendingMarks();\n          const inherited = inheritedMarksAt(yText, sel.from);\n          const next: MarkAttrs = { ...pending };\n          if (name in inherited) {\n            next[name] = false;\n          } else {\n            delete next[name];\n          }\n          setPendingMarks(next);\n          return;\n        }\n        formatRange(yText, sel.from, sel.to, name, null);\n      },\n\n      marksAtSelection() {\n        const sel = currentSelection();\n        if (!sel) return {};\n        const base =\n          sel.from === sel.to\n            ? inheritedMarksAt(yText, sel.from)\n            : marksInRange(yText, sel.from, sel.to);\n        // Overlay pending marks: `false` removes, anything truthy replaces.\n        const pending = pendingMarks();\n        const merged: MarkAttrs = { ...base };\n        for (const [name, value] of Object.entries(pending)) {\n          if (value === false) delete merged[name];\n          else merged[name] = value;\n        }\n        return merged;\n      },\n\n      insertText(text, attrs) {\n        const sel = currentSelection() ?? { from: yText.length, to: yText.length };\n        transactProgrammatic(yText, () => {\n          if (sel.from !== sel.to) {\n            yText.delete(sel.from, sel.to - sel.from);\n          }\n          if (text.length === 0) return;\n          const inherited = inheritedMarksAt(yText, sel.from);\n          const combined: MarkAttrs = {\n            ...inherited,\n            ...pendingMarks(),\n            ...(attrs ?? {}),\n          };\n          const { sanitised } = validateMarks(combined, schema);\n          yText.insert(sel.from, text, Object.keys(sanitised).length > 0 ? sanitised : undefined);\n        });\n      },\n\n      deleteRange(from, to) {\n        if (to <= from) return;\n        transactProgrammatic(yText, () => {\n          yText.delete(from, to - from);\n        });\n      },\n\n      focus() {\n        getEditor(yText)?.focus();\n      },\n\n      blur() {\n        getEditor(yText)?.blur();\n      },\n\n      isFocused() {\n        return getEditor(yText)?.isFocused() ?? false;\n      },\n    };\n  }, [yText, schema]);\n}\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["YjsTextModule"]
+  },
+  "android": {
+    "modules": ["tech.eclosion.yjstext.YjsTextModule"]
+  }
+}

package/ios/YjsText.podspec

@@ -0,0 +1,30 @@
+Pod::Spec.new do |s|
+  s.name           = 'YjsText'
+  s.version        = '0.1.0'
+  s.summary        = 'Native React Native rich text editor backed by Y.Text — no WebView, no contenteditable'
+  s.description    = <<-DESC
+    react-native-yjs-text renders a Y.Text shared type into a native UITextView (iOS)
+    or AppCompatEditText (Android), with bidirectional sync between user edits and the
+    Yjs CRDT. No WebView, no contenteditable, no browser shim — every editor instance
+    edits one Y.Text inline rich-text region. The consumer owns the Y.Doc and Y.Text;
+    the library is the native view binding.
+  DESC
+  s.author         = { 'Eclosion Technologies' => 'hello@eclosion.tech' }
+  s.homepage       = 'https://github.com/eclosion-tech/react-native-yjs-text'
+  s.license        = { :type => 'MIT', :file => '../LICENSE' }
+  s.platforms      = {
+    :ios => '16.4',
+    :tvos => '16.4'
+  }
+  s.source         = { git: 'https://github.com/eclosion-tech/react-native-yjs-text.git' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
+end

package/ios/YjsTextModule.swift

@@ -0,0 +1,75 @@
+import ExpoModulesCore
+
+/// Expo Module registration for `@eclosion-tech/react-native-yjs-text` on iOS.
+///
+/// The view's behaviour lives in `YjsTextView`; this file is just the wiring
+/// declaration the Expo Modules DSL needs in order to:
+///   - publish the four events the view dispatches
+///   - bind every prop the JS side sends down to its `didSet` setter
+///   - expose the imperative methods (`focus`, `blur`, `setSelection`,
+///     `isFocused`) as `AsyncFunction`s that JS resolves via the view's ref
+public class YjsTextModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("YjsText")
+
+    View(YjsTextView.self) {
+      Events(
+        "onContentChange",
+        "onNativeSelectionChange",
+        "onFocusChange",
+        "onMarkTap"
+      )
+
+      // MARK: - Props
+
+      Prop("runs") { (view: YjsTextView, value: [YjsTextRunRecord]) in
+        view.runs = value
+      }
+      Prop("renderSpec") { (view: YjsTextView, value: [String: YjsTextMarkStyleRecord]) in
+        view.renderSpec = value
+      }
+      Prop("pendingSelection") { (view: YjsTextView, value: YjsTextSelectionRecord?) in
+        view.pendingSelection = value
+      }
+      Prop("editable") { (view: YjsTextView, value: Bool) in
+        view.editable = value
+      }
+      Prop("placeholder") { (view: YjsTextView, value: String?) in
+        view.placeholder = value
+      }
+      Prop("placeholderColor") { (view: YjsTextView, value: String?) in
+        view.placeholderColor = YjsTextColor.parse(value) ?? UIColor(white: 0.6, alpha: 1.0)
+      }
+      Prop("baseFontSize") { (view: YjsTextView, value: Double?) in
+        view.baseFontSize = value
+      }
+      Prop("baseFontFamily") { (view: YjsTextView, value: String?) in
+        view.baseFontFamily = value
+      }
+      Prop("baseColor") { (view: YjsTextView, value: String?) in
+        view.baseColor = YjsTextColor.parse(value)
+      }
+      Prop("baseFontWeight") { (view: YjsTextView, value: String?) in
+        view.baseFontWeight = value
+      }
+      Prop("baseFontStyle") { (view: YjsTextView, value: String?) in
+        view.baseFontStyle = value
+      }
+
+      // MARK: - View methods (callable via the view's React ref)
+
+      AsyncFunction("focus") { (view: YjsTextView) in
+        view.focusInput()
+      }
+      AsyncFunction("blur") { (view: YjsTextView) in
+        view.blurInput()
+      }
+      AsyncFunction("isFocused") { (view: YjsTextView) -> Bool in
+        view.isInputFocused()
+      }
+      AsyncFunction("setSelection") { (view: YjsTextView, from: Int, to: Int) in
+        view.setSelection(from: from, to: to)
+      }
+    }
+  }
+}

package/ios/YjsTextSupport.swift

@@ -0,0 +1,135 @@
+import ExpoModulesCore
+import Foundation
+import UIKit
+
+// MARK: - Bridge Records
+
+/// A single attributed run as sent from JS. `marksJson` is a JSON-stringified
+/// `{ markName: attrs }` object — see the SerializedRun comment on the JS
+/// side for why we use JSON instead of a typed Record field.
+struct YjsTextRunRecord: Record {
+  @Field var text: String = ""
+  @Field var marksJson: String = "{}"
+}
+
+/// Per-mark style spec, mirrored from the JS `CompiledRenderSpec`. Only the
+/// keys in this struct are honoured; unknown keys are dropped during
+/// deserialisation.
+struct YjsTextMarkStyleRecord: Record {
+  @Field var fontWeight: String? = nil
+  @Field var fontStyle: String? = nil
+  @Field var fontFamily: String? = nil
+  @Field var fontSize: Double? = nil
+  @Field var color: String? = nil
+  @Field var backgroundColor: String? = nil
+  @Field var textDecorationLine: String? = nil
+}
+
+/// JS-pushed selection bundle. `version` is a monotonic counter the JS side
+/// bumps every time a selection change must be reflected on the native view —
+/// we re-apply only when it changes.
+///
+/// This is a SINGLE Record rather than two separate props (`selection` and
+/// `selectionVersion`) because Expo Modules doesn't guarantee setter order
+/// within a render batch on Fabric. If `selectionVersion` were set before
+/// `selection`, an `applySelectionIfNeeded()` triggered by the version
+/// didSet would read a stale `selection` and push the *previous* range to
+/// the textView — the "selection jumps to previously selected text" bug.
+/// Bundling makes the update atomic: one setter, one didSet, no race.
+struct YjsTextSelectionRecord: Record {
+  @Field var from: Int = 0
+  @Field var to: Int = 0
+  @Field var version: Int = -1
+}
+
+// MARK: - Event payloads (documentation only)
+//
+// Swift's `EventDispatcher` takes `[String: Any?]` dictionaries, not typed
+// Records (the generic-payload form only exists in the Kotlin DSL). The
+// dispatch sites in `YjsTextView` build matching dictionaries inline; the
+// types below document the contract for human readers and stay in lockstep
+// with the Kotlin / TypeScript shapes.
+//
+//   onContentChange       -> { type: "replace", from: Int, to: Int, text: String }
+//   onNativeSelectionChange -> { from: Int, to: Int }
+//   onFocusChange         -> { focused: Bool }
+//   onMarkTap (reserved)  -> { mark: String, attrsJson: String }
+
+// MARK: - Utilities
+
+enum YjsTextColor {
+  /// Parse a CSS-ish colour string (`#rrggbb`, `#rrggbbaa`, `rgb(...)`,
+  /// `rgba(...)`, named colours) into a `UIColor`. Returns nil on failure
+  /// rather than throwing — the caller falls back to the platform default.
+  static func parse(_ input: String?) -> UIColor? {
+    guard let raw = input?.trimmingCharacters(in: .whitespacesAndNewlines), !raw.isEmpty else {
+      return nil
+    }
+    // Hex
+    if raw.hasPrefix("#") {
+      return parseHex(String(raw.dropFirst()))
+    }
+    // rgb / rgba
+    if raw.lowercased().hasPrefix("rgb") {
+      return parseRGB(raw)
+    }
+    // A handful of named colours that show up in the default schema.
+    switch raw.lowercased() {
+    case "black":       return .black
+    case "white":       return .white
+    case "transparent": return .clear
+    default:            return nil
+    }
+  }
+
+  private static func parseHex(_ hex: String) -> UIColor? {
+    var r: UInt64 = 0, g: UInt64 = 0, b: UInt64 = 0, a: UInt64 = 0xff
+    let s = hex.uppercased()
+    let scanner = Scanner(string: s)
+    var value: UInt64 = 0
+    guard scanner.scanHexInt64(&value) else { return nil }
+    switch s.count {
+    case 6:
+      r = (value & 0xff0000) >> 16
+      g = (value & 0x00ff00) >> 8
+      b = (value & 0x0000ff)
+    case 8:
+      r = (value & 0xff000000) >> 24
+      g = (value & 0x00ff0000) >> 16
+      b = (value & 0x0000ff00) >> 8
+      a = (value & 0x000000ff)
+    case 3:
+      r = ((value & 0xf00) >> 8) * 0x11
+      g = ((value & 0x0f0) >> 4) * 0x11
+      b = (value & 0x00f) * 0x11
+    default:
+      return nil
+    }
+    return UIColor(
+      red: CGFloat(r) / 255.0,
+      green: CGFloat(g) / 255.0,
+      blue: CGFloat(b) / 255.0,
+      alpha: CGFloat(a) / 255.0
+    )
+  }
+
+  private static func parseRGB(_ raw: String) -> UIColor? {
+    let pieces = raw
+      .replacingOccurrences(of: " ", with: "")
+      .replacingOccurrences(of: "rgba(", with: "")
+      .replacingOccurrences(of: "rgb(", with: "")
+      .replacingOccurrences(of: ")", with: "")
+      .split(separator: ",")
+    guard pieces.count == 3 || pieces.count == 4 else { return nil }
+    let r = Double(pieces[0]) ?? 0
+    let g = Double(pieces[1]) ?? 0
+    let b = Double(pieces[2]) ?? 0
+    let a = pieces.count == 4 ? (Double(pieces[3]) ?? 1) : 1
+    return UIColor(
+      red: CGFloat(r) / 255.0,
+      green: CGFloat(g) / 255.0,
+      blue: CGFloat(b) / 255.0,
+      alpha: CGFloat(a)
+    )
+  }
+}