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

package/build/YTextRenderer.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { YTextRendererProps } from './types';
+/**
+ * Read-only rich-text renderer for a Y.Text.
+ *
+ * Implemented as nested `<Text>` views — no native `UITextView` /
+ * `AppCompatEditText` instance, no event handling, no keyboard. Significantly
+ * cheaper than {@link YTextInput} and the right choice for lists of read-only
+ * content (feeds, notification bodies, message previews, etc.).
+ *
+ * Observes the Y.Text and re-renders on every change. The consumer should
+ * unmount this component when the underlying Y.Text is freed.
+ */
+export declare function YTextRenderer(props: YTextRendererProps): React.ReactElement;
+//# sourceMappingURL=YTextRenderer.d.ts.map

package/build/YTextRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YTextRenderer.d.ts","sourceRoot":"","sources":["../src/YTextRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAA0B,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA6B3E"}

package/build/YTextRenderer.js

@@ -0,0 +1,85 @@
+import * as React from 'react';
+import { Text } from 'react-native';
+import { ytextToRuns } from './bridge';
+/**
+ * Read-only rich-text renderer for a Y.Text.
+ *
+ * Implemented as nested `<Text>` views — no native `UITextView` /
+ * `AppCompatEditText` instance, no event handling, no keyboard. Significantly
+ * cheaper than {@link YTextInput} and the right choice for lists of read-only
+ * content (feeds, notification bodies, message previews, etc.).
+ *
+ * Observes the Y.Text and re-renders on every change. The consumer should
+ * unmount this component when the underlying Y.Text is freed.
+ */
+export function YTextRenderer(props) {
+    const { yText, schema, style, numberOfLines } = props;
+    const [version, setVersion] = React.useState(0);
+    React.useEffect(() => {
+        function onChange() {
+            setVersion((v) => v + 1);
+        }
+        yText.observe(onChange);
+        return () => {
+            yText.unobserve(onChange);
+        };
+    }, [yText]);
+    const runs = React.useMemo(() => ytextToRuns(yText), [yText, version]);
+    // Empty Y.Text — render an empty Text rather than nothing, so the consumer's
+    // layout (line height, spacing) is preserved.
+    if (runs.length === 0) {
+        return <Text style={style} numberOfLines={numberOfLines}/>;
+    }
+    return (<Text style={style} numberOfLines={numberOfLines}>
+      {runs.map((run, index) => (<RunText key={index} run={run} schema={schema}/>))}
+    </Text>);
+}
+function RunText({ run, schema }) {
+    // Layer each mark's renderStyle in declaration order; consumer-defined
+    // marks later in the schema map override earlier ones if they collide —
+    // EXCEPT for `textDecorationLine`, which RN's style-flatten would just
+    // overwrite (last write wins). Multiple marks can legitimately want both
+    // decorations at once (e.g. `underline` + `strike`), and RN accepts the
+    // combined token `"underline line-through"` for both. We accumulate the
+    // distinct decoration tokens across marks and apply the merged value as
+    // the final style layer.
+    const styles = [];
+    const decorationTokens = new Set();
+    let onPress;
+    for (const markName of Object.keys(run.marks)) {
+        const value = run.marks[markName];
+        // `null` / `false` are the "explicitly off" sentinels produced by the
+        // insert path's `computeInsertAttrs`. Skip them so we don't re-apply
+        // the mark's renderStyle to text the user just toggled it off for.
+        if (value === null || value === false || value === undefined)
+            continue;
+        const spec = schema.marks[markName];
+        if (!spec)
+            continue;
+        if (spec.renderStyle) {
+            const { textDecorationLine, ...rest } = spec.renderStyle;
+            if (textDecorationLine && textDecorationLine !== 'none') {
+                for (const token of String(textDecorationLine).split(/\s+/)) {
+                    if (token === 'underline' || token === 'line-through') {
+                        decorationTokens.add(token);
+                    }
+                }
+            }
+            styles.push(rest);
+        }
+        if (spec.onTap) {
+            const attrs = run.marks[markName] ?? {};
+            onPress = () => spec.onTap?.(attrs);
+        }
+    }
+    if (decorationTokens.size > 0) {
+        // Stable order: underline first, line-through second. RN accepts
+        // "underline line-through" / "none" / each on its own.
+        const ordered = ['underline', 'line-through'].filter((t) => decorationTokens.has(t));
+        styles.push({ textDecorationLine: ordered.join(' ') });
+    }
+    return (<Text style={styles} onPress={onPress}>
+      {run.text}
+    </Text>);
+}
+//# sourceMappingURL=YTextRenderer.js.map

package/build/YTextRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"YTextRenderer.js","sourceRoot":"","sources":["../src/YTextRenderer.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from 'react';\nimport { Text, type TextStyle } from 'react-native';\n\nimport { ytextToRuns } from './bridge';\nimport type { MarkAttrs, Run, Schema, YTextRendererProps } from './types';\n\n/**\n * Read-only rich-text renderer for a Y.Text.\n *\n * Implemented as nested `<Text>` views — no native `UITextView` /\n * `AppCompatEditText` instance, no event handling, no keyboard. Significantly\n * cheaper than {@link YTextInput} and the right choice for lists of read-only\n * content (feeds, notification bodies, message previews, etc.).\n *\n * Observes the Y.Text and re-renders on every change. The consumer should\n * unmount this component when the underlying Y.Text is freed.\n */\nexport function YTextRenderer(props: YTextRendererProps): React.ReactElement {\n  const { yText, schema, style, numberOfLines } = props;\n  const [version, setVersion] = React.useState(0);\n\n  React.useEffect(() => {\n    function onChange(): void {\n      setVersion((v) => v + 1);\n    }\n    yText.observe(onChange);\n    return () => {\n      yText.unobserve(onChange);\n    };\n  }, [yText]);\n\n  const runs = React.useMemo<Run[]>(() => ytextToRuns(yText), [yText, version]);\n\n  // Empty Y.Text — render an empty Text rather than nothing, so the consumer's\n  // layout (line height, spacing) is preserved.\n  if (runs.length === 0) {\n    return <Text style={style} numberOfLines={numberOfLines} />;\n  }\n\n  return (\n    <Text style={style} numberOfLines={numberOfLines}>\n      {runs.map((run, index) => (\n        <RunText key={index} run={run} schema={schema} />\n      ))}\n    </Text>\n  );\n}\n\nfunction RunText({ run, schema }: { run: Run; schema: Schema }): React.ReactElement {\n  // Layer each mark's renderStyle in declaration order; consumer-defined\n  // marks later in the schema map override earlier ones if they collide —\n  // EXCEPT for `textDecorationLine`, which RN's style-flatten would just\n  // overwrite (last write wins). Multiple marks can legitimately want both\n  // decorations at once (e.g. `underline` + `strike`), and RN accepts the\n  // combined token `\"underline line-through\"` for both. We accumulate the\n  // distinct decoration tokens across marks and apply the merged value as\n  // the final style layer.\n  const styles: TextStyle[] = [];\n  const decorationTokens = new Set<string>();\n  let onPress: (() => void) | undefined;\n  for (const markName of Object.keys(run.marks)) {\n    const value = run.marks[markName];\n    // `null` / `false` are the \"explicitly off\" sentinels produced by the\n    // insert path's `computeInsertAttrs`. Skip them so we don't re-apply\n    // the mark's renderStyle to text the user just toggled it off for.\n    if (value === null || value === false || value === undefined) continue;\n    const spec = schema.marks[markName];\n    if (!spec) continue;\n    if (spec.renderStyle) {\n      const { textDecorationLine, ...rest } = spec.renderStyle;\n      if (textDecorationLine && textDecorationLine !== 'none') {\n        for (const token of String(textDecorationLine).split(/\\s+/)) {\n          if (token === 'underline' || token === 'line-through') {\n            decorationTokens.add(token);\n          }\n        }\n      }\n      styles.push(rest);\n    }\n    if (spec.onTap) {\n      const attrs = (run.marks[markName] as MarkAttrs) ?? {};\n      onPress = () => spec.onTap?.(attrs);\n    }\n  }\n  if (decorationTokens.size > 0) {\n    // Stable order: underline first, line-through second. RN accepts\n    // \"underline line-through\" / \"none\" / each on its own.\n    const ordered = ['underline', 'line-through'].filter((t) => decorationTokens.has(t));\n    styles.push({ textDecorationLine: ordered.join(' ') as TextStyle['textDecorationLine'] });\n  }\n  return (\n    <Text style={styles} onPress={onPress}>\n      {run.text}\n    </Text>\n  );\n}\n"]}

package/build/bridge.d.ts

@@ -0,0 +1,88 @@
+import * as Y from 'yjs';
+import type { MarkAttrs, ReplaceEdit, Run, Schema, SelectionRange } from './types';
+/**
+ * Convert a Y.Text into the array of attributed runs sent down to the native
+ * view as a prop.
+ *
+ * v0.1 only deals with string inserts — embeds (the future inline-non-text node
+ * story documented in the spec) are deferred. If the underlying delta contains
+ * a non-string insert we stringify defensively rather than throwing.
+ */
+export declare function ytextToRuns(yText: Y.Text): Run[];
+/**
+ * Compute the marks that should be inherited by an insertion at the given
+ * character offset. Mirrors Quill / ProseMirror behaviour: the inserted text
+ * adopts the marks of the character immediately to its left.
+ *
+ * At offset 0 there is no left character, so we return empty marks.
+ */
+export declare function inheritedMarksAt(yText: Y.Text, position: number): MarkAttrs;
+/**
+ * Get the marks that are common to *every* character in `[from, to)`. Used by
+ * `toggleMark` to decide whether to add or remove.
+ */
+export declare function marksInRange(yText: Y.Text, from: number, to: number): MarkAttrs;
+/**
+ * Apply a `replace` edit captured from the native view to the Y.Text.
+ *
+ * The edit is wrapped in a single Y.Doc transaction tagged with
+ * {@link ORIGIN_LOCAL_VIEW} so the observer loop in {@link YTextInput} knows
+ * to skip the resulting render-down (the view already has the change locally).
+ */
+export declare function applyReplaceEdit(yText: Y.Text, edit: ReplaceEdit, schema: Schema, onSchemaViolation?: (info: {
+    mark: string;
+    attrs: MarkAttrs;
+}) => void, pendingMarks?: MarkAttrs): void;
+/**
+ * Wrap a programmatic mutation (anything driven from JS — toolbar mark
+ * toggles, scripted inserts, deletes) in a Y.Doc transaction.
+ *
+ * Critically, we do NOT tag this with {@link ORIGIN_LOCAL_VIEW}. That origin
+ * is reserved for {@link applyReplaceEdit} — the round-trip path for text
+ * the user just typed into the native view, where the view *already* shows
+ * the change and re-pushing runs back down would clobber the in-flight IME
+ * composition / caret. Programmatic mutations, by contrast, haven't been
+ * reflected in the native view yet, so they MUST be observed by `YTextInput`
+ * to trigger an attributed-string update. Leaving the origin unset (or, in
+ * future, using a distinct `ORIGIN_LOCAL_PROGRAMMATIC` sentinel) is what
+ * causes the observer's `origin === ORIGIN_LOCAL_VIEW` short-circuit to
+ * fall through and recompute / repaint.
+ */
+export declare function transactProgrammatic(yText: Y.Text, fn: () => void): void;
+/**
+ * Carrier for a caret/range expressed as relative positions. Survives concurrent
+ * remote insertions/deletions: when the underlying Y.Text changes, resolving
+ * the relative positions against the new state gives us the new absolute offsets
+ * that correspond to "the same logical place" the user was at.
+ */
+export interface RelativeSelection {
+    from: Y.RelativePosition;
+    to: Y.RelativePosition;
+}
+/**
+ * Capture the current absolute selection as a {@link RelativeSelection}.
+ *
+ * Y.RelativePosition has an "assoc" flag controlling which side of a tie the
+ * position lives on. For a caret we use:
+ *   - `assoc = -1` for the `from` (start) — sticks to the *left* of a future
+ *     insertion at the same offset, which is the conventional caret behaviour
+ *     for the start of a selection
+ *   - `assoc = 1` for the `to` (end) — sticks to the *right*
+ *
+ * For a collapsed caret both still work — the caret stays where the user "is".
+ */
+export declare function captureRelativeSelection(yText: Y.Text, selection: SelectionRange): RelativeSelection;
+/**
+ * Resolve a {@link RelativeSelection} against the current Y.Text state.
+ *
+ * Returns `null` if either endpoint can no longer be resolved (e.g. the Y.Text
+ * was completely cleared remotely). Callers should fall back to a sensible
+ * default — typically clamping the caret to `yText.length`.
+ */
+export declare function resolveRelativeSelection(yText: Y.Text, sel: RelativeSelection): SelectionRange | null;
+/**
+ * Apply (or remove) a mark across a range. Removal is requested by passing
+ * `attrs = null` (matches the Yjs `format()` semantics).
+ */
+export declare function formatRange(yText: Y.Text, from: number, to: number, markName: string, attrs: MarkAttrs | null): void;
+//# sourceMappingURL=bridge.d.ts.map

package/build/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGnF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAUhD;AAWD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAa3E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAyB/E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,CAAC,CAAC,IAAI,EACb,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,KAAK,IAAI,EACtE,YAAY,CAAC,EAAE,SAAS,GACvB,IAAI,CA2BN;AA4DD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAOxE;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC;IACzB,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,CAAC,CAAC,IAAI,EACb,SAAS,EAAE,cAAc,GACxB,iBAAiB,CAKnB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,CAAC,CAAC,IAAI,EACb,GAAG,EAAE,iBAAiB,GACrB,cAAc,GAAG,IAAI,CAOvB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,CAAC,CAAC,IAAI,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,GAAG,IAAI,GACtB,IAAI,CAQN"}

package/build/bridge.js

@@ -0,0 +1,231 @@
+import * as Y from 'yjs';
+import { validateMarks } from './schema';
+import { ORIGIN_LOCAL_VIEW } from './types';
+/**
+ * Convert a Y.Text into the array of attributed runs sent down to the native
+ * view as a prop.
+ *
+ * v0.1 only deals with string inserts — embeds (the future inline-non-text node
+ * story documented in the spec) are deferred. If the underlying delta contains
+ * a non-string insert we stringify defensively rather than throwing.
+ */
+export function ytextToRuns(yText) {
+    const delta = yText.toDelta();
+    const runs = [];
+    for (const op of delta) {
+        if (op.insert == null)
+            continue;
+        const text = typeof op.insert === 'string' ? op.insert : String(op.insert);
+        if (text.length === 0)
+            continue;
+        runs.push({ text, marks: op.attributes ?? {} });
+    }
+    return runs;
+}
+/**
+ * Compute the marks that should be inherited by an insertion at the given
+ * character offset. Mirrors Quill / ProseMirror behaviour: the inserted text
+ * adopts the marks of the character immediately to its left.
+ *
+ * At offset 0 there is no left character, so we return empty marks.
+ */
+export function inheritedMarksAt(yText, position) {
+    if (position <= 0)
+        return {};
+    const delta = yText.toDelta();
+    let cursor = 0;
+    for (const op of delta) {
+        const len = typeof op.insert === 'string' ? op.insert.length : op.insert ? 1 : 0;
+        if (len === 0)
+            continue;
+        if (cursor + len >= position) {
+            return op.attributes ? { ...op.attributes } : {};
+        }
+        cursor += len;
+    }
+    return {};
+}
+/**
+ * Get the marks that are common to *every* character in `[from, to)`. Used by
+ * `toggleMark` to decide whether to add or remove.
+ */
+export function marksInRange(yText, from, to) {
+    if (to <= from)
+        return inheritedMarksAt(yText, from);
+    const delta = yText.toDelta();
+    let cursor = 0;
+    let common = null;
+    for (const op of delta) {
+        const len = typeof op.insert === 'string' ? op.insert.length : op.insert ? 1 : 0;
+        if (len === 0)
+            continue;
+        const opStart = cursor;
+        const opEnd = cursor + len;
+        cursor = opEnd;
+        if (opEnd <= from)
+            continue;
+        if (opStart >= to)
+            break;
+        const attrs = op.attributes ?? {};
+        if (common === null) {
+            common = { ...attrs };
+        }
+        else {
+            for (const key of Object.keys(common)) {
+                const a = JSON.stringify(common[key]);
+                const b = JSON.stringify(attrs[key]);
+                if (a !== b)
+                    delete common[key];
+            }
+        }
+    }
+    return common ?? {};
+}
+/**
+ * Apply a `replace` edit captured from the native view to the Y.Text.
+ *
+ * The edit is wrapped in a single Y.Doc transaction tagged with
+ * {@link ORIGIN_LOCAL_VIEW} so the observer loop in {@link YTextInput} knows
+ * to skip the resulting render-down (the view already has the change locally).
+ */
+export function applyReplaceEdit(yText, edit, schema, onSchemaViolation, pendingMarks) {
+    const doc = yText.doc;
+    if (!doc) {
+        // Y.Text not attached to a doc — extremely defensive, shouldn't happen in
+        // normal use, but we'd rather no-op than crash.
+        return;
+    }
+    doc.transact(() => {
+        const deleteLen = edit.to - edit.from;
+        if (deleteLen > 0) {
+            yText.delete(edit.from, deleteLen);
+        }
+        if (edit.text.length > 0) {
+            const insertAttrs = computeInsertAttrs(yText, edit.from, schema, pendingMarks, onSchemaViolation);
+            yText.insert(edit.from, edit.text, Object.keys(insertAttrs).length > 0 ? insertAttrs : undefined);
+        }
+    }, ORIGIN_LOCAL_VIEW);
+}
+/**
+ * Compute the attributes to pass to `Y.Text.insert(...)` for a new run of text
+ * at `position`, given the inherited marks of the character to the left and
+ * the editor's pending-marks overlay.
+ *
+ * Crucially, the returned object actively **`null`s out** any mark that's
+ * being suppressed — either because the user toggled it off via the pending
+ * overlay, or because the schema sanitiser dropped it (unknown mark, failed
+ * validation). Y.Text inheriting an attribute on the new characters can only
+ * be cancelled by passing `null` for that key; passing `undefined` or
+ * omitting the key keeps the inheritance.
+ */
+function computeInsertAttrs(yText, position, schema, pendingMarks, onSchemaViolation) {
+    const inherited = inheritedMarksAt(yText, position);
+    const pending = pendingMarks ?? {};
+    // Build the "intended" set of marks. Start from inherited, then apply
+    // pending: a truthy value adds/overrides, `false` removes.
+    const additions = { ...inherited };
+    const explicitRemovals = new Set();
+    for (const [name, value] of Object.entries(pending)) {
+        if (value === false) {
+            explicitRemovals.add(name);
+            delete additions[name];
+        }
+        else {
+            additions[name] = value;
+        }
+    }
+    const { sanitised, violations } = validateMarks(additions, schema);
+    if (onSchemaViolation) {
+        for (const v of violations)
+            onSchemaViolation(v);
+    }
+    // Anything we *wanted* to keep but the sanitiser dropped (unknown mark,
+    // invalid attrs) should also be actively removed so it doesn't leak into
+    // the inserted characters via Y.Text inheritance.
+    for (const name of Object.keys(additions)) {
+        if (!(name in sanitised))
+            explicitRemovals.add(name);
+    }
+    // Inherited marks that the user didn't explicitly touch and that *did*
+    // survive sanitisation are already in `sanitised`. Inherited marks that
+    // *failed* sanitisation are caught by the loop above. We don't need to
+    // null any of them twice.
+    const out = { ...sanitised };
+    for (const name of explicitRemovals) {
+        out[name] = null;
+    }
+    return out;
+}
+/**
+ * Wrap a programmatic mutation (anything driven from JS — toolbar mark
+ * toggles, scripted inserts, deletes) in a Y.Doc transaction.
+ *
+ * Critically, we do NOT tag this with {@link ORIGIN_LOCAL_VIEW}. That origin
+ * is reserved for {@link applyReplaceEdit} — the round-trip path for text
+ * the user just typed into the native view, where the view *already* shows
+ * the change and re-pushing runs back down would clobber the in-flight IME
+ * composition / caret. Programmatic mutations, by contrast, haven't been
+ * reflected in the native view yet, so they MUST be observed by `YTextInput`
+ * to trigger an attributed-string update. Leaving the origin unset (or, in
+ * future, using a distinct `ORIGIN_LOCAL_PROGRAMMATIC` sentinel) is what
+ * causes the observer's `origin === ORIGIN_LOCAL_VIEW` short-circuit to
+ * fall through and recompute / repaint.
+ */
+export function transactProgrammatic(yText, fn) {
+    const doc = yText.doc;
+    if (!doc) {
+        fn();
+        return;
+    }
+    doc.transact(fn);
+}
+/**
+ * Capture the current absolute selection as a {@link RelativeSelection}.
+ *
+ * Y.RelativePosition has an "assoc" flag controlling which side of a tie the
+ * position lives on. For a caret we use:
+ *   - `assoc = -1` for the `from` (start) — sticks to the *left* of a future
+ *     insertion at the same offset, which is the conventional caret behaviour
+ *     for the start of a selection
+ *   - `assoc = 1` for the `to` (end) — sticks to the *right*
+ *
+ * For a collapsed caret both still work — the caret stays where the user "is".
+ */
+export function captureRelativeSelection(yText, selection) {
+    return {
+        from: Y.createRelativePositionFromTypeIndex(yText, selection.from, -1),
+        to: Y.createRelativePositionFromTypeIndex(yText, selection.to, 1),
+    };
+}
+/**
+ * Resolve a {@link RelativeSelection} against the current Y.Text state.
+ *
+ * Returns `null` if either endpoint can no longer be resolved (e.g. the Y.Text
+ * was completely cleared remotely). Callers should fall back to a sensible
+ * default — typically clamping the caret to `yText.length`.
+ */
+export function resolveRelativeSelection(yText, sel) {
+    const doc = yText.doc;
+    if (!doc)
+        return null;
+    const from = Y.createAbsolutePositionFromRelativePosition(sel.from, doc);
+    const to = Y.createAbsolutePositionFromRelativePosition(sel.to, doc);
+    if (!from || !to || from.type !== yText || to.type !== yText)
+        return null;
+    return { from: from.index, to: to.index };
+}
+/**
+ * Apply (or remove) a mark across a range. Removal is requested by passing
+ * `attrs = null` (matches the Yjs `format()` semantics).
+ */
+export function formatRange(yText, from, to, markName, attrs) {
+    if (to <= from)
+        return;
+    transactProgrammatic(yText, () => {
+        // Y.Text.format expects an attributes object where `null` values remove
+        // the corresponding mark. We pass the single mark either as its attrs
+        // object (apply) or as `null` (remove).
+        yText.format(from, to - from, { [markName]: attrs });
+    });
+}
+//# sourceMappingURL=bridge.js.map

package/build/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Y from 'yjs';\n\nimport { validateMarks } from './schema';\nimport type { MarkAttrs, ReplaceEdit, Run, Schema, SelectionRange } from './types';\nimport { ORIGIN_LOCAL_VIEW } from './types';\n\n/**\n * Convert a Y.Text into the array of attributed runs sent down to the native\n * view as a prop.\n *\n * v0.1 only deals with string inserts — embeds (the future inline-non-text node\n * story documented in the spec) are deferred. If the underlying delta contains\n * a non-string insert we stringify defensively rather than throwing.\n */\nexport function ytextToRuns(yText: Y.Text): Run[] {\n  const delta = yText.toDelta() as YDeltaOp[];\n  const runs: Run[] = [];\n  for (const op of delta) {\n    if (op.insert == null) continue;\n    const text = typeof op.insert === 'string' ? op.insert : String(op.insert);\n    if (text.length === 0) continue;\n    runs.push({ text, marks: op.attributes ?? {} });\n  }\n  return runs;\n}\n\n/**\n * The shape `Y.Text.toDelta()` returns. Yjs's published types are loose here;\n * we narrow to what we actually consume.\n */\ninterface YDeltaOp {\n  insert?: string | object;\n  attributes?: MarkAttrs;\n}\n\n/**\n * Compute the marks that should be inherited by an insertion at the given\n * character offset. Mirrors Quill / ProseMirror behaviour: the inserted text\n * adopts the marks of the character immediately to its left.\n *\n * At offset 0 there is no left character, so we return empty marks.\n */\nexport function inheritedMarksAt(yText: Y.Text, position: number): MarkAttrs {\n  if (position <= 0) return {};\n  const delta = yText.toDelta() as YDeltaOp[];\n  let cursor = 0;\n  for (const op of delta) {\n    const len = typeof op.insert === 'string' ? op.insert.length : op.insert ? 1 : 0;\n    if (len === 0) continue;\n    if (cursor + len >= position) {\n      return op.attributes ? { ...op.attributes } : {};\n    }\n    cursor += len;\n  }\n  return {};\n}\n\n/**\n * Get the marks that are common to *every* character in `[from, to)`. Used by\n * `toggleMark` to decide whether to add or remove.\n */\nexport function marksInRange(yText: Y.Text, from: number, to: number): MarkAttrs {\n  if (to <= from) return inheritedMarksAt(yText, from);\n  const delta = yText.toDelta() as YDeltaOp[];\n  let cursor = 0;\n  let common: MarkAttrs | null = null;\n  for (const op of delta) {\n    const len = typeof op.insert === 'string' ? op.insert.length : op.insert ? 1 : 0;\n    if (len === 0) continue;\n    const opStart = cursor;\n    const opEnd = cursor + len;\n    cursor = opEnd;\n    if (opEnd <= from) continue;\n    if (opStart >= to) break;\n    const attrs = op.attributes ?? {};\n    if (common === null) {\n      common = { ...attrs };\n    } else {\n      for (const key of Object.keys(common)) {\n        const a = JSON.stringify(common[key]);\n        const b = JSON.stringify(attrs[key]);\n        if (a !== b) delete common[key];\n      }\n    }\n  }\n  return common ?? {};\n}\n\n/**\n * Apply a `replace` edit captured from the native view to the Y.Text.\n *\n * The edit is wrapped in a single Y.Doc transaction tagged with\n * {@link ORIGIN_LOCAL_VIEW} so the observer loop in {@link YTextInput} knows\n * to skip the resulting render-down (the view already has the change locally).\n */\nexport function applyReplaceEdit(\n  yText: Y.Text,\n  edit: ReplaceEdit,\n  schema: Schema,\n  onSchemaViolation?: (info: { mark: string; attrs: MarkAttrs }) => void,\n  pendingMarks?: MarkAttrs\n): void {\n  const doc = yText.doc;\n  if (!doc) {\n    // Y.Text not attached to a doc — extremely defensive, shouldn't happen in\n    // normal use, but we'd rather no-op than crash.\n    return;\n  }\n  doc.transact(() => {\n    const deleteLen = edit.to - edit.from;\n    if (deleteLen > 0) {\n      yText.delete(edit.from, deleteLen);\n    }\n    if (edit.text.length > 0) {\n      const insertAttrs = computeInsertAttrs(\n        yText,\n        edit.from,\n        schema,\n        pendingMarks,\n        onSchemaViolation\n      );\n      yText.insert(\n        edit.from,\n        edit.text,\n        Object.keys(insertAttrs).length > 0 ? insertAttrs : undefined\n      );\n    }\n  }, ORIGIN_LOCAL_VIEW);\n}\n\n/**\n * Compute the attributes to pass to `Y.Text.insert(...)` for a new run of text\n * at `position`, given the inherited marks of the character to the left and\n * the editor's pending-marks overlay.\n *\n * Crucially, the returned object actively **`null`s out** any mark that's\n * being suppressed — either because the user toggled it off via the pending\n * overlay, or because the schema sanitiser dropped it (unknown mark, failed\n * validation). Y.Text inheriting an attribute on the new characters can only\n * be cancelled by passing `null` for that key; passing `undefined` or\n * omitting the key keeps the inheritance.\n */\nfunction computeInsertAttrs(\n  yText: Y.Text,\n  position: number,\n  schema: Schema,\n  pendingMarks: MarkAttrs | undefined,\n  onSchemaViolation?: (info: { mark: string; attrs: MarkAttrs }) => void\n): MarkAttrs {\n  const inherited = inheritedMarksAt(yText, position);\n  const pending = pendingMarks ?? {};\n\n  // Build the \"intended\" set of marks. Start from inherited, then apply\n  // pending: a truthy value adds/overrides, `false` removes.\n  const additions: MarkAttrs = { ...inherited };\n  const explicitRemovals = new Set<string>();\n  for (const [name, value] of Object.entries(pending)) {\n    if (value === false) {\n      explicitRemovals.add(name);\n      delete additions[name];\n    } else {\n      additions[name] = value as MarkAttrs;\n    }\n  }\n\n  const { sanitised, violations } = validateMarks(additions, schema);\n  if (onSchemaViolation) {\n    for (const v of violations) onSchemaViolation(v);\n  }\n\n  // Anything we *wanted* to keep but the sanitiser dropped (unknown mark,\n  // invalid attrs) should also be actively removed so it doesn't leak into\n  // the inserted characters via Y.Text inheritance.\n  for (const name of Object.keys(additions)) {\n    if (!(name in sanitised)) explicitRemovals.add(name);\n  }\n  // Inherited marks that the user didn't explicitly touch and that *did*\n  // survive sanitisation are already in `sanitised`. Inherited marks that\n  // *failed* sanitisation are caught by the loop above. We don't need to\n  // null any of them twice.\n\n  const out: MarkAttrs = { ...sanitised };\n  for (const name of explicitRemovals) {\n    out[name] = null;\n  }\n  return out;\n}\n\n/**\n * Wrap a programmatic mutation (anything driven from JS — toolbar mark\n * toggles, scripted inserts, deletes) in a Y.Doc transaction.\n *\n * Critically, we do NOT tag this with {@link ORIGIN_LOCAL_VIEW}. That origin\n * is reserved for {@link applyReplaceEdit} — the round-trip path for text\n * the user just typed into the native view, where the view *already* shows\n * the change and re-pushing runs back down would clobber the in-flight IME\n * composition / caret. Programmatic mutations, by contrast, haven't been\n * reflected in the native view yet, so they MUST be observed by `YTextInput`\n * to trigger an attributed-string update. Leaving the origin unset (or, in\n * future, using a distinct `ORIGIN_LOCAL_PROGRAMMATIC` sentinel) is what\n * causes the observer's `origin === ORIGIN_LOCAL_VIEW` short-circuit to\n * fall through and recompute / repaint.\n */\nexport function transactProgrammatic(yText: Y.Text, fn: () => void): void {\n  const doc = yText.doc;\n  if (!doc) {\n    fn();\n    return;\n  }\n  doc.transact(fn);\n}\n\n/**\n * Carrier for a caret/range expressed as relative positions. Survives concurrent\n * remote insertions/deletions: when the underlying Y.Text changes, resolving\n * the relative positions against the new state gives us the new absolute offsets\n * that correspond to \"the same logical place\" the user was at.\n */\nexport interface RelativeSelection {\n  from: Y.RelativePosition;\n  to: Y.RelativePosition;\n}\n\n/**\n * Capture the current absolute selection as a {@link RelativeSelection}.\n *\n * Y.RelativePosition has an \"assoc\" flag controlling which side of a tie the\n * position lives on. For a caret we use:\n *   - `assoc = -1` for the `from` (start) — sticks to the *left* of a future\n *     insertion at the same offset, which is the conventional caret behaviour\n *     for the start of a selection\n *   - `assoc = 1` for the `to` (end) — sticks to the *right*\n *\n * For a collapsed caret both still work — the caret stays where the user \"is\".\n */\nexport function captureRelativeSelection(\n  yText: Y.Text,\n  selection: SelectionRange\n): RelativeSelection {\n  return {\n    from: Y.createRelativePositionFromTypeIndex(yText, selection.from, -1),\n    to: Y.createRelativePositionFromTypeIndex(yText, selection.to, 1),\n  };\n}\n\n/**\n * Resolve a {@link RelativeSelection} against the current Y.Text state.\n *\n * Returns `null` if either endpoint can no longer be resolved (e.g. the Y.Text\n * was completely cleared remotely). Callers should fall back to a sensible\n * default — typically clamping the caret to `yText.length`.\n */\nexport function resolveRelativeSelection(\n  yText: Y.Text,\n  sel: RelativeSelection\n): SelectionRange | null {\n  const doc = yText.doc;\n  if (!doc) return null;\n  const from = Y.createAbsolutePositionFromRelativePosition(sel.from, doc);\n  const to = Y.createAbsolutePositionFromRelativePosition(sel.to, doc);\n  if (!from || !to || from.type !== yText || to.type !== yText) return null;\n  return { from: from.index, to: to.index };\n}\n\n/**\n * Apply (or remove) a mark across a range. Removal is requested by passing\n * `attrs = null` (matches the Yjs `format()` semantics).\n */\nexport function formatRange(\n  yText: Y.Text,\n  from: number,\n  to: number,\n  markName: string,\n  attrs: MarkAttrs | null\n): void {\n  if (to <= from) return;\n  transactProgrammatic(yText, () => {\n    // Y.Text.format expects an attributes object where `null` values remove\n    // the corresponding mark. We pass the single mark either as its attrs\n    // object (apply) or as `null` (remove).\n    yText.format(from, to - from, { [markName]: attrs });\n  });\n}\n"]}

package/build/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @eclosion-tech/react-native-yjs-text
+ *
+ * Native React Native rich text editor backed by Y.Text. No WebView, no
+ * `contenteditable`, no DOM. See ./SPEC.md for the full design rationale.
+ */
+export { YTextInput } from './YTextInput';
+export { YTextRenderer } from './YTextRenderer';
+export { useYTextEditor } from './useYTextEditor';
+export { defaultSchema } from './schema';
+export type { MarkAttrs, MarkSpec, Run, Schema, SelectionRange, YTextEditor, YTextInputProps, YTextRendererProps, } from './types';
+export { ORIGIN_LOCAL_VIEW } from './types';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EACV,SAAS,EACT,QAAQ,EACR,GAAG,EACH,MAAM,EACN,cAAc,EACd,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/build/index.js

@@ -0,0 +1,12 @@
+/**
+ * @eclosion-tech/react-native-yjs-text
+ *
+ * Native React Native rich text editor backed by Y.Text. No WebView, no
+ * `contenteditable`, no DOM. See ./SPEC.md for the full design rationale.
+ */
+export { YTextInput } from './YTextInput';
+export { YTextRenderer } from './YTextRenderer';
+export { useYTextEditor } from './useYTextEditor';
+export { defaultSchema } from './schema';
+export { ORIGIN_LOCAL_VIEW } from './types';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAWzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC","sourcesContent":["/**\n * @eclosion-tech/react-native-yjs-text\n *\n * Native React Native rich text editor backed by Y.Text. No WebView, no\n * `contenteditable`, no DOM. See ./SPEC.md for the full design rationale.\n */\nexport { YTextInput } from './YTextInput';\nexport { YTextRenderer } from './YTextRenderer';\nexport { useYTextEditor } from './useYTextEditor';\nexport { defaultSchema } from './schema';\nexport type {\n  MarkAttrs,\n  MarkSpec,\n  Run,\n  Schema,\n  SelectionRange,\n  YTextEditor,\n  YTextInputProps,\n  YTextRendererProps,\n} from './types';\nexport { ORIGIN_LOCAL_VIEW } from './types';\n"]}

package/build/internal/NativeYTextInputView.d.ts

@@ -0,0 +1,114 @@
+import * as React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { CompiledRenderSpec } from '../schema';
+import type { MarkAttrs, Run, SelectionRange } from '../types';
+/**
+ * Selection bundle pushed to native as a single atomic prop.
+ *
+ * Bundling `from`/`to`/`version` into one Record (rather than two separate
+ * props on the native side) sidesteps Expo Modules' unspecified prop-setter
+ * ordering on Fabric: if the version prop were applied before the value,
+ * the native side would re-apply a stale selection and the user would see
+ * the previous selection "jump back" after every format toggle.
+ */
+export interface SerializedPendingSelection {
+    from: number;
+    to: number;
+    version: number;
+}
+/**
+ * A single run as it goes over the bridge to native. Marks are JSON-serialised
+ * because Expo Module `Record` fields don't cleanly accept heterogeneous
+ * `[String: Any]` dictionaries (mark attrs are arbitrary per the schema), and
+ * the cost of a JSON round-trip per run on every render is negligible compared
+ * to the layout work native then does.
+ */
+export interface SerializedRun {
+    text: string;
+    /** JSON-stringified `Record<string, unknown>` of mark name -> attrs. */
+    marksJson: string;
+}
+/** Serialise a public {@link Run} into the bridge representation. */
+export declare function serializeRun(run: Run): SerializedRun;
+/**
+ * Props sent to the native `YjsText` view across the bridge. Keep this shape
+ * stable — the iOS and Android sides parse it; adding a key requires native
+ * changes on both sides.
+ */
+export interface NativeYTextInputViewProps {
+    /**
+     * Attributed runs to render. Native always rebuilds when this prop
+     * changes — we used to ship a sibling `contentVersion: number` prop to
+     * force re-apply on attr-only changes, but Expo Modules' Fabric setter
+     * ordering didn't guarantee `runs` was applied before `contentVersion`,
+     * which caused every toggle to render the *previous* runs. Collapsing
+     * to a single trigger sidesteps the race entirely. The JS side prevents
+     * redundant pushes by memoising this array on a `contentVersion` state
+     * that bumps only on real Y.Text changes.
+     */
+    runs: SerializedRun[];
+    /**
+     * Per-mark style spec. Inner keys are bounded by `RENDERABLE_TEXT_STYLE_KEYS`
+     * so this serialises cleanly into a typed Swift / Kotlin Record.
+     */
+    renderSpec: CompiledRenderSpec;
+    /**
+     * Atomic selection bundle. Native re-applies whenever the embedded
+     * `version` differs from the last value it observed. `null` means "no
+     * JS-driven selection yet" — native leaves the in-flight user selection
+     * alone.
+     */
+    pendingSelection: SerializedPendingSelection | null;
+    editable: boolean;
+    placeholder?: string;
+    placeholderColor?: string;
+    baseFontSize?: number;
+    baseFontFamily?: string;
+    baseColor?: string;
+    baseFontWeight?: string;
+    baseFontStyle?: string;
+    style?: StyleProp<ViewStyle>;
+    onContentChange?: (event: {
+        nativeEvent: {
+            type: 'replace';
+            from: number;
+            to: number;
+            text: string;
+        };
+    }) => void;
+    onNativeSelectionChange?: (event: {
+        nativeEvent: {
+            from: number;
+            to: number;
+        };
+    }) => void;
+    onFocusChange?: (event: {
+        nativeEvent: {
+            focused: boolean;
+        };
+    }) => void;
+    onMarkTap?: (event: {
+        nativeEvent: {
+            mark: string;
+            attrsJson: string;
+        };
+    }) => void;
+}
+/** Parse a mark-tap event payload from native back into a `MarkAttrs` object. */
+export declare function parseMarkTapAttrs(attrsJson: string): MarkAttrs;
+/**
+ * Direct handle to the underlying native `UITextView` / `AppCompatEditText`.
+ * Exposed via {@link React.useImperativeHandle} so the JS layer can call
+ * focus/blur/setSelection without going through props.
+ *
+ * Implemented as Expo Modules `AsyncFunction`s on the native side that take a
+ * view tag and dispatch to the matching view instance.
+ */
+export interface NativeYTextInputViewRef {
+    focus(): void;
+    blur(): void;
+    setSelection(range: SelectionRange): void;
+    isFocused(): boolean;
+}
+export declare const NativeYTextInputView: React.ForwardRefExoticComponent<NativeYTextInputViewProps & React.RefAttributes<NativeYTextInputViewRef>>;
+//# sourceMappingURL=NativeYTextInputView.d.ts.map

package/build/internal/NativeYTextInputView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeYTextInputView.d.ts","sourceRoot":"","sources":["../../src/internal/NativeYTextInputView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAKpD;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;OASG;IACH,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;;;OAKG;IACH,gBAAgB,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAE7B,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE;QACxB,WAAW,EAAE;YAAE,IAAI,EAAE,SAAS,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1E,KAAK,IAAI,CAAC;IACX,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IACzF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CACnF;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAQ9D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,SAAS,IAAI,OAAO,CAAC;CACtB;AAMD,eAAO,MAAM,oBAAoB,2GAK/B,CAAC"}