@bsky.app/tapper 0.2.4 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @bsky.app/tapper
 
+## 0.3.0
+
+### Minor Changes
+
+- [`f215a99`](https://github.com/bluesky-social/toolbox/commit/f215a99913fec45d8842da22f7c02737c14301ef) Thanks [@estrattonbailey](https://github.com/estrattonbailey)! - Bump minor, packages are mostly stable
+
 ## 0.2.4
 
 ### Patch Changes

package/build/index.d.ts

@@ -9,8 +9,9 @@ export declare class Tapper {
     selection: TapperSelection;
     nodes: TapperNode[];
     activeFacet: TapperActiveFacet | null;
+    private pendingMutation;
+    private static MUTATION_DEBOUNCE_MS;
     private updating;
-    private pendingEnd;
     private storeListeners;
     private snapshot;
     constructor(config?: TapperConfig);

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAA;AAWhB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AAExB,qBAAa,MAAM;IACjB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAqB;IAIrC,OAAO,CAAC,SAAS,CAA0D;IAG3E,IAAI,SAAK;IACT,SAAS,EAAE,eAAe,CAAqB;IAC/C,KAAK,EAAE,UAAU,EAAE,CAAK;IACxB,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAO;IAG5C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,UAAU,CAAsB;IAGxC,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,CAAC,EAAE,YAAY;IAejC,SAAS,GAAI,UAAU,MAAM,IAAI,mBAGhC;IAED,WAAW,QAAO,cAAc,CAE/B;IAED,EAAE,GAAI,CAAC,SAAS,MAAM,YAAY,EAChC,OAAO,CAAC,EACR,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,gBAOpC;IAED,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,MAAM;IAmEd,gBAAgB,GAAI,SAAS,MAAM,UAuBlC;IAED,qBAAqB,GAAI,GAAG;QAC1B,WAAW,EAAE;YAAC,SAAS,EAAE;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,GAAG,EAAE,MAAM,CAAA;aAAC,CAAA;SAAC,CAAA;KACvD,UAcA;IAED,WAAW,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,UA+B3C;IAED,OAAO,CAAC,MAAM,CAoBb;CACF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY;SA/LtC,CAAC,SAAS,MAAM,YAAY,2CAED,IAAI;;;aAuMhB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC;;;gCA7GZ,MAAM;+BAyBP;YAC1B,WAAW,EAAE;gBAAC,SAAS,EAAE;oBAAC,KAAK,EAAE,MAAM,CAAC;oBAAC,GAAG,EAAE,MAAM,CAAA;iBAAC,CAAA;aAAC,CAAA;SACvD;;;;;;EAyFF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAA;AAWhB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AAExB,qBAAa,MAAM;IACjB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAqB;IAIrC,OAAO,CAAC,SAAS,CAA0D;IAG3E,IAAI,SAAK;IACT,SAAS,EAAE,eAAe,CAAqB;IAC/C,KAAK,EAAE,UAAU,EAAE,CAAK;IACxB,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAO;IAwB5C,OAAO,CAAC,eAAe,CAAuD;IAC9E,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAM;IAEzC,OAAO,CAAC,QAAQ,CAAQ;IAGxB,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,CAAC,EAAE,YAAY;IAejC,SAAS,GAAI,UAAU,MAAM,IAAI,mBAGhC;IAED,WAAW,QAAO,cAAc,CAE/B;IAED,EAAE,GAAI,CAAC,SAAS,MAAM,YAAY,EAChC,OAAO,CAAC,EACR,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,gBAOpC;IAED,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,MAAM;IAmEd,gBAAgB,GAAI,SAAS,MAAM,UA4ClC;IAED,qBAAqB,GAAI,GAAG;QAC1B,WAAW,EAAE;YAAC,SAAS,EAAE;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,GAAG,EAAE,MAAM,CAAA;aAAC,CAAA;SAAC,CAAA;KACvD,UA4BA;IAED,WAAW,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,UA+B3C;IAED,OAAO,CAAC,MAAM,CAyBb;CACF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY;SAvOtC,CAAC,SAAS,MAAM,YAAY,2CAED,IAAI;;;aA+OhB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC;;;gCArJZ,MAAM;+BA8CP;YAC1B,WAAW,EAAE;gBAAC,SAAS,EAAE;oBAAC,KAAK,EAAE,MAAM,CAAC;oBAAC,GAAG,EAAE,MAAM,CAAA;iBAAC,CAAA;aAAC,CAAA;SACvD;;;;;;EA4GF"}

package/build/index.js

@@ -14,9 +14,31 @@ export class Tapper {
     selection = { start: 0, end: 0 };
     nodes = [];
     activeFacet = null;
-    // Internal tracking
+    /*
+     * Guard against stale native events after programmatic text replacement.
+     *
+     * After insert() or atomic deletion, we update this.text and this.selection
+     * synchronously. However, iOS (especially on the old architecture bridge)
+     * may then fire stale onChangeText and onSelectionChange events reflecting
+     * the *previous* text/cursor state. These arrive within ~60ms.
+     *
+     * We record the expected textLength and a timestamp, then use two guards:
+     *
+     * 1. handleTextChange: if the incoming text length doesn't match the
+     *    expected length AND we're within the debounce window, it's a stale
+     *    event echoing the pre-replacement text. Skip it.
+     *
+     * 2. handleSelectionChange: if we're within the debounce window, skip
+     *    ALL selection events. The correct selection was already set by
+     *    update(), and any events within the window are either duplicates
+     *    (no-ops) or stale positions from the old text.
+     *
+     * After the window passes, the guard clears itself and normal event
+     * handling resumes (cursor taps, typing, etc).
+     */
+    pendingMutation = null;
+    static MUTATION_DEBOUNCE_MS = 100;
     updating = false;
-    pendingEnd = null;
     // useSyncExternalStore plumbing
     storeListeners = new Set();
     snapshot;
@@ -112,6 +134,21 @@ export class Tapper {
         }
     }
     handleTextChange = (newText) => {
+        if (newText === this.text)
+            return;
+        /*
+         * Guard 1: stale text. After insert/atomic deletion, iOS may echo
+         * onChangeText with the pre-replacement text. If the incoming length
+         * doesn't match what we expect and we're within the debounce window,
+         * this is a stale echo — skip it.
+         */
+        if (this.pendingMutation !== null) {
+            const elapsed = Date.now() - this.pendingMutation.timestamp;
+            if (elapsed < Tapper.MUTATION_DEBOUNCE_MS &&
+                newText.length !== this.pendingMutation.textLength) {
+                return;
+            }
+        }
         const diff = newText.length - this.text.length;
         let newEnd = Math.max(this.selection.end + diff, 0);
         // Atomic deletion: backspace into a facet from outside
@@ -124,7 +161,10 @@ export class Tapper {
                     newText =
                         newText.slice(0, node.start) + newText.slice(node.start + remnant);
                     newEnd = node.start;
-                    this.pendingEnd = newEnd;
+                    this.pendingMutation = {
+                        textLength: newText.length,
+                        timestamp: Date.now(),
+                    };
                     break;
                 }
             }
@@ -133,13 +173,27 @@ export class Tapper {
     };
     handleSelectionChange = (e) => {
         const { start, end } = e.nativeEvent.selection;
-        // After atomic deletion, ignore stale cursor values from the DOM
-        if (this.pendingEnd !== null) {
-            if (end !== this.pendingEnd) {
+        /*
+         * Guard 2: stale selection. After insert/atomic deletion, iOS may fire
+         * onSelectionChange with cursor positions from the old text state
+         * (e.g. a "deselection" event at the pre-insert cursor). Within the
+         * debounce window, skip ALL selection events — the correct selection
+         * was already set synchronously by update().
+         */
+        if (this.pendingMutation !== null) {
+            const elapsed = Date.now() - this.pendingMutation.timestamp;
+            if (elapsed < Tapper.MUTATION_DEBOUNCE_MS)
                 return;
-            }
-            this.pendingEnd = null;
+            this.pendingMutation = null;
         }
+        /*
+         * Guard 3: premature selection. iOS sometimes fires onSelectionChange
+         * before onChangeText for the same edit, reporting a cursor position
+         * that's beyond the current text length. Skip it — handleTextChange
+         * will set the correct position when it arrives.
+         */
+        if (end > this.text.length)
+            return;
         if (start === this.selection.start && end === this.selection.end)
             return;
         this.selection = { start, end };
@@ -182,6 +236,7 @@ export class Tapper {
             this.text.slice(this.activeFacet.range.end);
         const newEnd = this.activeFacet.range.start + replacement.length;
         if (this.activeFacet) {
+            this.activeFacet.raw = value;
             this.activeFacet.value = value;
             this.activeFacet.range = {
                 start: this.activeFacet.range.start,
@@ -189,6 +244,10 @@ export class Tapper {
             };
             this.emit('afterInsert', this.activeFacet);
         }
+        this.pendingMutation = {
+            textLength: newText.length,
+            timestamp: Date.now(),
+        };
         this.update(newText, { start: newEnd, end: newEnd });
     };
 }

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {useRef, useState, useSyncExternalStore} from 'react'\n\nimport {\n  TapperConfig,\n  TapperEvents,\n  TapperNode,\n  TapperActiveFacet,\n  TapperSelection,\n  TapperSnapshot,\n} from './types'\nimport {\n  parseNodesFromText,\n  detectActiveFacet,\n  deriveTriggers,\n  nodeToFacet,\n  compileFacetRegexes,\n  type CompiledFacetRegexes,\n} from './util'\nimport * as defaultFacets from './facets'\n\nexport * from './types'\nexport * from './facets'\n\nexport class Tapper {\n  private facetRegexes: CompiledFacetRegexes\n  private triggers: Map<string, string>\n\n  // Event emitters\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private listeners = new Map<keyof TapperEvents, Set<(data: any) => void>>()\n\n  // Public state\n  text = ''\n  selection: TapperSelection = {start: 0, end: 0}\n  nodes: TapperNode[] = []\n  activeFacet: TapperActiveFacet | null = null\n\n  // Internal tracking\n  private updating = false\n  private pendingEnd: number | null = null\n\n  // useSyncExternalStore plumbing\n  private storeListeners = new Set<() => void>()\n  private snapshot: TapperSnapshot\n\n  constructor(config?: TapperConfig) {\n    const facets = config?.facets || defaultFacets\n    this.facetRegexes = compileFacetRegexes(facets)\n    this.triggers = deriveTriggers(facets)\n    this.snapshot = {\n      text: this.text,\n      selection: this.selection,\n      nodes: this.nodes,\n      activeFacet: this.activeFacet,\n    }\n    if (config?.initialText) {\n      this.replaceText(config.initialText)\n    }\n  }\n\n  subscribe = (listener: () => void) => {\n    this.storeListeners.add(listener)\n    return () => this.storeListeners.delete(listener)\n  }\n\n  getSnapshot = (): TapperSnapshot => {\n    return this.snapshot\n  }\n\n  on = <K extends keyof TapperEvents>(\n    event: K,\n    cb: (data: TapperEvents[K]) => void,\n  ) => {\n    if (!this.listeners.has(event)) this.listeners.set(event, new Set())\n    this.listeners.get(event)!.add(cb)\n    return () => {\n      this.listeners.get(event)?.delete(cb)\n    }\n  }\n\n  private emit<K extends keyof TapperEvents>(event: K, data: TapperEvents[K]) {\n    this.listeners.get(event)?.forEach(cb => cb(data))\n  }\n\n  private notify() {\n    this.snapshot = {\n      text: this.text,\n      selection: this.selection,\n      nodes: this.nodes,\n      activeFacet: this.activeFacet,\n    }\n    this.storeListeners.forEach(l => l())\n  }\n\n  private update(newText: string, selection: TapperSelection) {\n    // guard against circular updates when insert() is called during an update cycle\n    if (this.updating) return\n    this.updating = true\n\n    const cursor = selection.end\n    const isRange = selection.start !== selection.end\n\n    const nodes =\n      newText === this.text\n        ? this.nodes\n        : parseNodesFromText(\n            newText,\n            this.facetRegexes,\n            this.nodes,\n            cursor,\n            this.triggers,\n          )\n    const prev = this.activeFacet\n    const detected = isRange\n      ? null\n      : detectActiveFacet(nodes, newText, cursor, this.triggers)\n\n    // When cursor leaves a facet, commit it\n    let committedNode: TapperNode | null = null\n    if (prev && (!detected || detected.type !== prev.type)) {\n      for (const node of nodes) {\n        if (\n          node.type === 'facet' &&\n          node.facetType === prev.type &&\n          node.start === prev.range.start &&\n          node.end === prev.range.end\n        ) {\n          node.committed = true\n          committedNode = node\n          break\n        }\n      }\n    }\n\n    // Build activeFacet with insert() baked in\n    const active: TapperActiveFacet | null = detected\n      ? {...detected, insert: this.insert}\n      : null\n\n    this.text = newText\n    this.selection = selection\n    this.nodes = nodes\n    this.activeFacet = active\n\n    this.updating = false\n    this.notify()\n\n    // Fire events after state is finalized\n    const facetChanged =\n      active?.type !== prev?.type ||\n      active?.value !== prev?.value ||\n      active?.range.start !== prev?.range.start ||\n      active?.range.end !== prev?.range.end\n    if (facetChanged) {\n      this.emit('activeFacet', active)\n    }\n    if (committedNode) {\n      this.emit('facetCommitted', nodeToFacet(committedNode))\n    }\n  }\n\n  handleTextChange = (newText: string) => {\n    const diff = newText.length - this.text.length\n    let newEnd = Math.max(this.selection.end + diff, 0)\n\n    // Atomic deletion: backspace into a facet from outside\n    if (diff === -1 && newEnd < this.selection.end) {\n      for (const node of this.nodes) {\n        if (\n          node.type === 'facet' &&\n          node.committed &&\n          this.selection.end === node.end\n        ) {\n          const remnant = node.end - node.start - 1\n          newText =\n            newText.slice(0, node.start) + newText.slice(node.start + remnant)\n          newEnd = node.start\n          this.pendingEnd = newEnd\n          break\n        }\n      }\n    }\n\n    this.update(newText, {start: newEnd, end: newEnd})\n  }\n\n  handleSelectionChange = (e: {\n    nativeEvent: {selection: {start: number; end: number}}\n  }) => {\n    const {start, end} = e.nativeEvent.selection\n    // After atomic deletion, ignore stale cursor values from the DOM\n    if (this.pendingEnd !== null) {\n      if (end !== this.pendingEnd) {\n        return\n      }\n      this.pendingEnd = null\n    }\n\n    if (start === this.selection.start && end === this.selection.end) return\n\n    this.selection = {start, end}\n    this.update(this.text, {start, end})\n  }\n\n  replaceText = (text: string, cursor?: number) => {\n    const prevActive = this.activeFacet\n    const nodes = parseNodesFromText(text, this.facetRegexes)\n    // Mark all non-text nodes as committed (pre-existing facets)\n    const newlyCommitted: TapperNode[] = []\n    for (const node of nodes) {\n      if (node.type === 'facet') {\n        node.committed = true\n        newlyCommitted.push(node)\n      }\n    }\n\n    const pos = cursor ?? text.length\n    const detected = detectActiveFacet(nodes, text, pos, this.triggers)\n    const active: TapperActiveFacet | null = detected\n      ? {...detected, insert: this.insert}\n      : null\n\n    this.text = text\n    this.selection = {start: pos, end: pos}\n    this.nodes = nodes\n    this.activeFacet = active\n\n    this.notify()\n\n    if (active !== prevActive) {\n      this.emit('activeFacet', active)\n    }\n    for (const node of newlyCommitted) {\n      this.emit('facetCommitted', nodeToFacet(node))\n    }\n  }\n\n  private insert = (value: string, options?: {noTrailingSpace?: boolean}) => {\n    if (!this.activeFacet) return\n\n    const replacement = value + (options?.noTrailingSpace ? '' : ' ')\n    const newText =\n      this.text.slice(0, this.activeFacet.range.start) +\n      replacement +\n      this.text.slice(this.activeFacet.range.end)\n    const newEnd = this.activeFacet.range.start + replacement.length\n\n    if (this.activeFacet) {\n      this.activeFacet.value = value\n      this.activeFacet.range = {\n        start: this.activeFacet.range.start,\n        end: this.activeFacet.range.start + value.length,\n      }\n      this.emit('afterInsert', this.activeFacet)\n    }\n\n    this.update(newText, {start: newEnd, end: newEnd})\n  }\n}\n\nexport function useTapper(config: TapperConfig) {\n  const [store] = useState(() => new Tapper(config))\n  const state = useSyncExternalStore(store.subscribe, store.getSnapshot)\n  const inputRef = useRef<{focus(): void}>(null)\n\n  return {\n    ...state,\n    on: store.on,\n    focus: () => inputRef.current?.focus(),\n    inputProps: {\n      ref: inputRef as React.RefObject<any>,\n      value: state.text,\n      selection: state.selection,\n      onChangeText: store.handleTextChange,\n      onSelectionChange: store.handleSelectionChange,\n    },\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {useRef, useState, useSyncExternalStore} from 'react'\n\nimport {\n  TapperConfig,\n  TapperEvents,\n  TapperNode,\n  TapperActiveFacet,\n  TapperSelection,\n  TapperSnapshot,\n} from './types'\nimport {\n  parseNodesFromText,\n  detectActiveFacet,\n  deriveTriggers,\n  nodeToFacet,\n  compileFacetRegexes,\n  type CompiledFacetRegexes,\n} from './util'\nimport * as defaultFacets from './facets'\n\nexport * from './types'\nexport * from './facets'\n\nexport class Tapper {\n  private facetRegexes: CompiledFacetRegexes\n  private triggers: Map<string, string>\n\n  // Event emitters\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private listeners = new Map<keyof TapperEvents, Set<(data: any) => void>>()\n\n  // Public state\n  text = ''\n  selection: TapperSelection = {start: 0, end: 0}\n  nodes: TapperNode[] = []\n  activeFacet: TapperActiveFacet | null = null\n\n  /*\n   * Guard against stale native events after programmatic text replacement.\n   *\n   * After insert() or atomic deletion, we update this.text and this.selection\n   * synchronously. However, iOS (especially on the old architecture bridge)\n   * may then fire stale onChangeText and onSelectionChange events reflecting\n   * the *previous* text/cursor state. These arrive within ~60ms.\n   *\n   * We record the expected textLength and a timestamp, then use two guards:\n   *\n   * 1. handleTextChange: if the incoming text length doesn't match the\n   *    expected length AND we're within the debounce window, it's a stale\n   *    event echoing the pre-replacement text. Skip it.\n   *\n   * 2. handleSelectionChange: if we're within the debounce window, skip\n   *    ALL selection events. The correct selection was already set by\n   *    update(), and any events within the window are either duplicates\n   *    (no-ops) or stale positions from the old text.\n   *\n   * After the window passes, the guard clears itself and normal event\n   * handling resumes (cursor taps, typing, etc).\n   */\n  private pendingMutation: {textLength: number; timestamp: number} | null = null\n  private static MUTATION_DEBOUNCE_MS = 100\n\n  private updating = false\n\n  // useSyncExternalStore plumbing\n  private storeListeners = new Set<() => void>()\n  private snapshot: TapperSnapshot\n\n  constructor(config?: TapperConfig) {\n    const facets = config?.facets || defaultFacets\n    this.facetRegexes = compileFacetRegexes(facets)\n    this.triggers = deriveTriggers(facets)\n    this.snapshot = {\n      text: this.text,\n      selection: this.selection,\n      nodes: this.nodes,\n      activeFacet: this.activeFacet,\n    }\n    if (config?.initialText) {\n      this.replaceText(config.initialText)\n    }\n  }\n\n  subscribe = (listener: () => void) => {\n    this.storeListeners.add(listener)\n    return () => this.storeListeners.delete(listener)\n  }\n\n  getSnapshot = (): TapperSnapshot => {\n    return this.snapshot\n  }\n\n  on = <K extends keyof TapperEvents>(\n    event: K,\n    cb: (data: TapperEvents[K]) => void,\n  ) => {\n    if (!this.listeners.has(event)) this.listeners.set(event, new Set())\n    this.listeners.get(event)!.add(cb)\n    return () => {\n      this.listeners.get(event)?.delete(cb)\n    }\n  }\n\n  private emit<K extends keyof TapperEvents>(event: K, data: TapperEvents[K]) {\n    this.listeners.get(event)?.forEach(cb => cb(data))\n  }\n\n  private notify() {\n    this.snapshot = {\n      text: this.text,\n      selection: this.selection,\n      nodes: this.nodes,\n      activeFacet: this.activeFacet,\n    }\n    this.storeListeners.forEach(l => l())\n  }\n\n  private update(newText: string, selection: TapperSelection) {\n    // guard against circular updates when insert() is called during an update cycle\n    if (this.updating) return\n    this.updating = true\n\n    const cursor = selection.end\n    const isRange = selection.start !== selection.end\n\n    const nodes =\n      newText === this.text\n        ? this.nodes\n        : parseNodesFromText(\n            newText,\n            this.facetRegexes,\n            this.nodes,\n            cursor,\n            this.triggers,\n          )\n    const prev = this.activeFacet\n    const detected = isRange\n      ? null\n      : detectActiveFacet(nodes, newText, cursor, this.triggers)\n\n    // When cursor leaves a facet, commit it\n    let committedNode: TapperNode | null = null\n    if (prev && (!detected || detected.type !== prev.type)) {\n      for (const node of nodes) {\n        if (\n          node.type === 'facet' &&\n          node.facetType === prev.type &&\n          node.start === prev.range.start &&\n          node.end === prev.range.end\n        ) {\n          node.committed = true\n          committedNode = node\n          break\n        }\n      }\n    }\n\n    // Build activeFacet with insert() baked in\n    const active: TapperActiveFacet | null = detected\n      ? {...detected, insert: this.insert}\n      : null\n\n    this.text = newText\n    this.selection = selection\n    this.nodes = nodes\n    this.activeFacet = active\n\n    this.updating = false\n    this.notify()\n\n    // Fire events after state is finalized\n    const facetChanged =\n      active?.type !== prev?.type ||\n      active?.value !== prev?.value ||\n      active?.range.start !== prev?.range.start ||\n      active?.range.end !== prev?.range.end\n    if (facetChanged) {\n      this.emit('activeFacet', active)\n    }\n    if (committedNode) {\n      this.emit('facetCommitted', nodeToFacet(committedNode))\n    }\n  }\n\n  handleTextChange = (newText: string) => {\n    if (newText === this.text) return\n\n    /*\n     * Guard 1: stale text. After insert/atomic deletion, iOS may echo\n     * onChangeText with the pre-replacement text. If the incoming length\n     * doesn't match what we expect and we're within the debounce window,\n     * this is a stale echo — skip it.\n     */\n    if (this.pendingMutation !== null) {\n      const elapsed = Date.now() - this.pendingMutation.timestamp\n      if (\n        elapsed < Tapper.MUTATION_DEBOUNCE_MS &&\n        newText.length !== this.pendingMutation.textLength\n      ) {\n        return\n      }\n    }\n\n    const diff = newText.length - this.text.length\n    let newEnd = Math.max(this.selection.end + diff, 0)\n\n    // Atomic deletion: backspace into a facet from outside\n    if (diff === -1 && newEnd < this.selection.end) {\n      for (const node of this.nodes) {\n        if (\n          node.type === 'facet' &&\n          node.committed &&\n          this.selection.end === node.end\n        ) {\n          const remnant = node.end - node.start - 1\n          newText =\n            newText.slice(0, node.start) + newText.slice(node.start + remnant)\n          newEnd = node.start\n          this.pendingMutation = {\n            textLength: newText.length,\n            timestamp: Date.now(),\n          }\n          break\n        }\n      }\n    }\n\n    this.update(newText, {start: newEnd, end: newEnd})\n  }\n\n  handleSelectionChange = (e: {\n    nativeEvent: {selection: {start: number; end: number}}\n  }) => {\n    const {start, end} = e.nativeEvent.selection\n\n    /*\n     * Guard 2: stale selection. After insert/atomic deletion, iOS may fire\n     * onSelectionChange with cursor positions from the old text state\n     * (e.g. a \"deselection\" event at the pre-insert cursor). Within the\n     * debounce window, skip ALL selection events — the correct selection\n     * was already set synchronously by update().\n     */\n    if (this.pendingMutation !== null) {\n      const elapsed = Date.now() - this.pendingMutation.timestamp\n      if (elapsed < Tapper.MUTATION_DEBOUNCE_MS) return\n      this.pendingMutation = null\n    }\n\n    /*\n     * Guard 3: premature selection. iOS sometimes fires onSelectionChange\n     * before onChangeText for the same edit, reporting a cursor position\n     * that's beyond the current text length. Skip it — handleTextChange\n     * will set the correct position when it arrives.\n     */\n    if (end > this.text.length) return\n\n    if (start === this.selection.start && end === this.selection.end) return\n\n    this.selection = {start, end}\n    this.update(this.text, {start, end})\n  }\n\n  replaceText = (text: string, cursor?: number) => {\n    const prevActive = this.activeFacet\n    const nodes = parseNodesFromText(text, this.facetRegexes)\n    // Mark all non-text nodes as committed (pre-existing facets)\n    const newlyCommitted: TapperNode[] = []\n    for (const node of nodes) {\n      if (node.type === 'facet') {\n        node.committed = true\n        newlyCommitted.push(node)\n      }\n    }\n\n    const pos = cursor ?? text.length\n    const detected = detectActiveFacet(nodes, text, pos, this.triggers)\n    const active: TapperActiveFacet | null = detected\n      ? {...detected, insert: this.insert}\n      : null\n\n    this.text = text\n    this.selection = {start: pos, end: pos}\n    this.nodes = nodes\n    this.activeFacet = active\n\n    this.notify()\n\n    if (active !== prevActive) {\n      this.emit('activeFacet', active)\n    }\n    for (const node of newlyCommitted) {\n      this.emit('facetCommitted', nodeToFacet(node))\n    }\n  }\n\n  private insert = (value: string, options?: {noTrailingSpace?: boolean}) => {\n    if (!this.activeFacet) return\n\n    const replacement = value + (options?.noTrailingSpace ? '' : ' ')\n    const newText =\n      this.text.slice(0, this.activeFacet.range.start) +\n      replacement +\n      this.text.slice(this.activeFacet.range.end)\n    const newEnd = this.activeFacet.range.start + replacement.length\n\n    if (this.activeFacet) {\n      this.activeFacet.raw = value\n      this.activeFacet.value = value\n      this.activeFacet.range = {\n        start: this.activeFacet.range.start,\n        end: this.activeFacet.range.start + value.length,\n      }\n      this.emit('afterInsert', this.activeFacet)\n    }\n\n    this.pendingMutation = {\n      textLength: newText.length,\n      timestamp: Date.now(),\n    }\n    this.update(newText, {start: newEnd, end: newEnd})\n  }\n}\n\nexport function useTapper(config: TapperConfig) {\n  const [store] = useState(() => new Tapper(config))\n  const state = useSyncExternalStore(store.subscribe, store.getSnapshot)\n  const inputRef = useRef<{focus(): void}>(null)\n\n  return {\n    ...state,\n    on: store.on,\n    focus: () => inputRef.current?.focus(),\n    inputProps: {\n      ref: inputRef as React.RefObject<any>,\n      value: state.text,\n      selection: state.selection,\n      onChangeText: store.handleTextChange,\n      onSelectionChange: store.handleSelectionChange,\n    },\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsky.app/tapper",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "license": "MIT",
   "description": "A minimal rich text editor for React Native and web.",
   "repository": "https://github.com/bluesky-social/toolbox",

package/src/index.ts

@@ -35,9 +35,32 @@ export class Tapper {
   nodes: TapperNode[] = []
   activeFacet: TapperActiveFacet | null = null
 
-  // Internal tracking
+  /*
+   * Guard against stale native events after programmatic text replacement.
+   *
+   * After insert() or atomic deletion, we update this.text and this.selection
+   * synchronously. However, iOS (especially on the old architecture bridge)
+   * may then fire stale onChangeText and onSelectionChange events reflecting
+   * the *previous* text/cursor state. These arrive within ~60ms.
+   *
+   * We record the expected textLength and a timestamp, then use two guards:
+   *
+   * 1. handleTextChange: if the incoming text length doesn't match the
+   *    expected length AND we're within the debounce window, it's a stale
+   *    event echoing the pre-replacement text. Skip it.
+   *
+   * 2. handleSelectionChange: if we're within the debounce window, skip
+   *    ALL selection events. The correct selection was already set by
+   *    update(), and any events within the window are either duplicates
+   *    (no-ops) or stale positions from the old text.
+   *
+   * After the window passes, the guard clears itself and normal event
+   * handling resumes (cursor taps, typing, etc).
+   */
+  private pendingMutation: {textLength: number; timestamp: number} | null = null
+  private static MUTATION_DEBOUNCE_MS = 100
+
   private updating = false
-  private pendingEnd: number | null = null
 
   // useSyncExternalStore plumbing
   private storeListeners = new Set<() => void>()
@@ -160,6 +183,24 @@ export class Tapper {
   }
 
   handleTextChange = (newText: string) => {
+    if (newText === this.text) return
+
+    /*
+     * Guard 1: stale text. After insert/atomic deletion, iOS may echo
+     * onChangeText with the pre-replacement text. If the incoming length
+     * doesn't match what we expect and we're within the debounce window,
+     * this is a stale echo — skip it.
+     */
+    if (this.pendingMutation !== null) {
+      const elapsed = Date.now() - this.pendingMutation.timestamp
+      if (
+        elapsed < Tapper.MUTATION_DEBOUNCE_MS &&
+        newText.length !== this.pendingMutation.textLength
+      ) {
+        return
+      }
+    }
+
     const diff = newText.length - this.text.length
     let newEnd = Math.max(this.selection.end + diff, 0)
 
@@ -175,7 +216,10 @@ export class Tapper {
           newText =
             newText.slice(0, node.start) + newText.slice(node.start + remnant)
           newEnd = node.start
-          this.pendingEnd = newEnd
+          this.pendingMutation = {
+            textLength: newText.length,
+            timestamp: Date.now(),
+          }
           break
         }
       }
@@ -188,14 +232,28 @@ export class Tapper {
     nativeEvent: {selection: {start: number; end: number}}
   }) => {
     const {start, end} = e.nativeEvent.selection
-    // After atomic deletion, ignore stale cursor values from the DOM
-    if (this.pendingEnd !== null) {
-      if (end !== this.pendingEnd) {
-        return
-      }
-      this.pendingEnd = null
+
+    /*
+     * Guard 2: stale selection. After insert/atomic deletion, iOS may fire
+     * onSelectionChange with cursor positions from the old text state
+     * (e.g. a "deselection" event at the pre-insert cursor). Within the
+     * debounce window, skip ALL selection events — the correct selection
+     * was already set synchronously by update().
+     */
+    if (this.pendingMutation !== null) {
+      const elapsed = Date.now() - this.pendingMutation.timestamp
+      if (elapsed < Tapper.MUTATION_DEBOUNCE_MS) return
+      this.pendingMutation = null
     }
 
+    /*
+     * Guard 3: premature selection. iOS sometimes fires onSelectionChange
+     * before onChangeText for the same edit, reporting a cursor position
+     * that's beyond the current text length. Skip it — handleTextChange
+     * will set the correct position when it arrives.
+     */
+    if (end > this.text.length) return
+
     if (start === this.selection.start && end === this.selection.end) return
 
     this.selection = {start, end}
@@ -246,6 +304,7 @@ export class Tapper {
     const newEnd = this.activeFacet.range.start + replacement.length
 
     if (this.activeFacet) {
+      this.activeFacet.raw = value
       this.activeFacet.value = value
       this.activeFacet.range = {
         start: this.activeFacet.range.start,
@@ -254,6 +313,10 @@ export class Tapper {
       this.emit('afterInsert', this.activeFacet)
     }
 
+    this.pendingMutation = {
+      textLength: newText.length,
+      timestamp: Date.now(),
+    }
     this.update(newText, {start: newEnd, end: newEnd})
   }
 }