@bsky.app/tapper 0.1.0

package/.eslintrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  root: true,
+  extends: ['universe/native', 'universe/web'],
+  ignorePatterns: ['build'],
+};

package/README.md

@@ -0,0 +1,32 @@
+# @bsky.app/tapper
+
+My new module
+
+# API documentation
+
+- [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/@bsky.app/tapper/)
+- [Documentation for the main branch](https://docs.expo.dev/versions/unversioned/sdk/@bsky.app/tapper/)
+
+# Installation in managed Expo projects
+
+For [managed](https://docs.expo.dev/archive/managed-vs-bare/) Expo projects, please follow the installation instructions in the [API documentation for the latest stable release](#api-documentation). If you follow the link and there is no documentation available then this library is not yet usable within managed projects — it is likely to be included in an upcoming Expo SDK release.
+
+# Installation in bare React Native projects
+
+For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing.
+
+### Add the package to your npm dependencies
+
+```
+npm install @bsky.app/tapper
+```
+
+### Configure for Android
+
+### Configure for iOS
+
+Run `npx pod-install` after installing the npm package.
+
+# Contributing
+
+Contributions are very welcome! Please refer to guidelines described in the [contributing guide](https://github.com/expo/expo#contributing).

package/build/core.d.ts

@@ -0,0 +1,30 @@
+import { TapperConfig, TapperNode, TapperActiveFacet, TapperSnapshot } from './types';
+export declare class Tapper {
+    private facetConfig;
+    private triggers;
+    text: string;
+    cursor: number;
+    nodes: TapperNode[];
+    activeFacet: TapperActiveFacet | null;
+    private updating;
+    private pendingCursor;
+    private storeListeners;
+    private snapshot;
+    constructor(config: TapperConfig);
+    subscribe: (listener: () => void) => () => boolean;
+    getSnapshot: () => TapperSnapshot;
+    private notify;
+    private update;
+    handleTextChange: (newText: string) => void;
+    handleSelectionChange: (newCursor: number) => void;
+    replaceText: (text: string, cursor?: number) => void;
+    private insert;
+}
+export declare function useTapperCore(config: TapperConfig): {
+    store: Tapper;
+    text: string;
+    cursor: number;
+    nodes: TapperNode[];
+    activeFacet: TapperActiveFacet | null;
+};
+//# sourceMappingURL=core.d.ts.map

package/build/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EAEZ,UAAU,EACV,iBAAiB,EACjB,cAAc,EACf,MAAM,SAAS,CAAA;AAIhB,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAAqB;IAGrC,IAAI,SAAK;IACT,MAAM,SAAI;IACV,KAAK,EAAE,UAAU,EAAE,CAAK;IACxB,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAO;IAG5C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,aAAa,CAAsB;IAG3C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,EAAE,YAAY;IAchC,SAAS,GAAI,UAAU,MAAM,IAAI,mBAGhC;IAED,WAAW,QAAO,cAAc,CAE/B;IAED,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,MAAM;IAiCd,gBAAgB,GAAI,SAAS,MAAM,UAuBlC;IAED,qBAAqB,GAAI,WAAW,MAAM,UAWzC;IAED,WAAW,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,UAqB3C;IAED,OAAO,CAAC,MAAM,CAoBb;CACF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY;;;;;;EAIjD"}

package/build/core.js

@@ -0,0 +1,148 @@
+import { useMemo, useSyncExternalStore } from 'react';
+import { parseNodesFromText, detectActiveFacet, deriveTriggers } from './util';
+export class Tapper {
+    facetConfig;
+    triggers;
+    // Public state
+    text = '';
+    cursor = 0;
+    nodes = [];
+    activeFacet = null;
+    // Internal tracking
+    updating = false;
+    pendingCursor = null;
+    // useSyncExternalStore plumbing
+    storeListeners = new Set();
+    snapshot;
+    constructor(config) {
+        this.facetConfig = config.facets;
+        this.triggers = deriveTriggers(config.facets);
+        this.snapshot = {
+            text: this.text,
+            cursor: this.cursor,
+            nodes: this.nodes,
+            activeFacet: this.activeFacet,
+        };
+        if (config.initialText) {
+            this.replaceText(config.initialText);
+        }
+    }
+    subscribe = (listener) => {
+        this.storeListeners.add(listener);
+        return () => this.storeListeners.delete(listener);
+    };
+    getSnapshot = () => {
+        return this.snapshot;
+    };
+    notify() {
+        this.snapshot = {
+            text: this.text,
+            cursor: this.cursor,
+            nodes: this.nodes,
+            activeFacet: this.activeFacet,
+        };
+        this.storeListeners.forEach(l => l());
+    }
+    update(newText, cursor) {
+        // guard against circular updates when insert is called during an update cycle
+        if (this.updating)
+            return;
+        this.updating = true;
+        const nodes = parseNodesFromText(newText, this.facetConfig, this.nodes);
+        const prev = this.activeFacet;
+        const detected = detectActiveFacet(nodes, newText, cursor, this.triggers);
+        // When cursor leaves a facet, commit it
+        if (prev && (!detected || detected.facetType !== prev.facetType)) {
+            for (const node of nodes) {
+                if (node.type === prev.facetType && node.value === prev.query) {
+                    node.committed = true;
+                    break;
+                }
+            }
+        }
+        // Build activeFacet with insert baked in
+        const active = detected
+            ? { ...detected, insert: this.insert }
+            : null;
+        this.text = newText;
+        this.cursor = cursor;
+        this.nodes = nodes;
+        this.activeFacet = active;
+        this.updating = false;
+        this.notify();
+    }
+    handleTextChange = (newText) => {
+        const diff = newText.length - this.text.length;
+        let newCursor = Math.max(this.cursor + diff, 0);
+        // Atomic deletion: backspace into a facet from outside
+        if (diff === -1 && newCursor < this.cursor) {
+            for (const node of this.nodes) {
+                if (node.type !== 'text' &&
+                    node.committed &&
+                    this.cursor === node.end) {
+                    const remnant = node.end - node.start - 1;
+                    newText =
+                        newText.slice(0, node.start) + newText.slice(node.start + remnant);
+                    newCursor = node.start;
+                    this.pendingCursor = newCursor;
+                    break;
+                }
+            }
+        }
+        this.update(newText, newCursor);
+    };
+    handleSelectionChange = (newCursor) => {
+        // After atomic deletion, ignore stale cursor values from the DOM
+        if (this.pendingCursor !== null) {
+            if (newCursor !== this.pendingCursor) {
+                return;
+            }
+            this.pendingCursor = null;
+        }
+        this.cursor = newCursor;
+        this.update(this.text, newCursor);
+    };
+    replaceText = (text, cursor) => {
+        const nodes = parseNodesFromText(text, this.facetConfig);
+        // Mark all non-text nodes as committed (pre-existing facets)
+        for (const node of nodes) {
+            if (node.type !== 'text') {
+                node.committed = true;
+            }
+        }
+        const pos = cursor ?? text.length;
+        const detected = detectActiveFacet(nodes, text, pos, this.triggers);
+        const active = detected
+            ? { ...detected, insert: this.insert }
+            : null;
+        this.text = text;
+        this.cursor = pos;
+        this.nodes = nodes;
+        this.activeFacet = active;
+        this.notify();
+    };
+    insert = (value, options) => {
+        const active = this.activeFacet;
+        if (!active)
+            return;
+        const replacement = value + (options?.noTrailingSpace ? '' : ' ');
+        const newText = this.text.slice(0, active.range.start) +
+            replacement +
+            this.text.slice(active.range.end);
+        const newCursor = active.range.start + replacement.length;
+        this.update(newText, newCursor);
+        // Mark the inserted facet as committed
+        for (const node of this.nodes) {
+            if (node.type !== 'text' && node.start === active.range.start) {
+                node.committed = true;
+                break;
+            }
+        }
+    };
+}
+export function useTapperCore(config) {
+    const store = useMemo(() => new Tapper(config), [config]);
+    const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot);
+    return { ...snapshot, store };
+}
+//# sourceMappingURL=core.js.map

package/build/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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","sourcesContent":["import {useMemo, useSyncExternalStore} from 'react'\n\nimport {\n  TapperConfig,\n  TapperFacetConfigMap,\n  TapperNode,\n  TapperActiveFacet,\n  TapperSnapshot,\n} from './types'\n\nimport {parseNodesFromText, detectActiveFacet, deriveTriggers} from './util'\n\nexport class Tapper {\n  private facetConfig: TapperFacetConfigMap\n  private triggers: Map<string, string>\n\n  // Public state\n  text = ''\n  cursor = 0\n  nodes: TapperNode[] = []\n  activeFacet: TapperActiveFacet | null = null\n\n  // Internal tracking\n  private updating = false\n  private pendingCursor: number | null = null\n\n  // useSyncExternalStore plumbing\n  private storeListeners = new Set<() => void>()\n  private snapshot: TapperSnapshot\n\n  constructor(config: TapperConfig) {\n    this.facetConfig = config.facets\n    this.triggers = deriveTriggers(config.facets)\n    this.snapshot = {\n      text: this.text,\n      cursor: this.cursor,\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  private notify() {\n    this.snapshot = {\n      text: this.text,\n      cursor: this.cursor,\n      nodes: this.nodes,\n      activeFacet: this.activeFacet,\n    }\n    this.storeListeners.forEach(l => l())\n  }\n\n  private update(newText: string, cursor: number) {\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 nodes = parseNodesFromText(newText, this.facetConfig, this.nodes)\n    const prev = this.activeFacet\n    const detected = detectActiveFacet(nodes, newText, cursor, this.triggers)\n\n    // When cursor leaves a facet, commit it\n    if (prev && (!detected || detected.facetType !== prev.facetType)) {\n      for (const node of nodes) {\n        if (node.type === prev.facetType && node.value === prev.query) {\n          node.committed = true\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.cursor = cursor\n    this.nodes = nodes\n    this.activeFacet = active\n\n    this.updating = false\n    this.notify()\n  }\n\n  handleTextChange = (newText: string) => {\n    const diff = newText.length - this.text.length\n    let newCursor = Math.max(this.cursor + diff, 0)\n\n    // Atomic deletion: backspace into a facet from outside\n    if (diff === -1 && newCursor < this.cursor) {\n      for (const node of this.nodes) {\n        if (\n          node.type !== 'text' &&\n          node.committed &&\n          this.cursor === 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          newCursor = node.start\n          this.pendingCursor = newCursor\n          break\n        }\n      }\n    }\n\n    this.update(newText, newCursor)\n  }\n\n  handleSelectionChange = (newCursor: number) => {\n    // After atomic deletion, ignore stale cursor values from the DOM\n    if (this.pendingCursor !== null) {\n      if (newCursor !== this.pendingCursor) {\n        return\n      }\n      this.pendingCursor = null\n    }\n\n    this.cursor = newCursor\n    this.update(this.text, newCursor)\n  }\n\n  replaceText = (text: string, cursor?: number) => {\n    const nodes = parseNodesFromText(text, this.facetConfig)\n    // Mark all non-text nodes as committed (pre-existing facets)\n    for (const node of nodes) {\n      if (node.type !== 'text') {\n        node.committed = true\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.cursor = pos\n    this.nodes = nodes\n    this.activeFacet = active\n\n    this.notify()\n  }\n\n  private insert = (value: string, options?: {noTrailingSpace?: boolean}) => {\n    const active = this.activeFacet\n    if (!active) return\n\n    const replacement = value + (options?.noTrailingSpace ? '' : ' ')\n    const newText =\n      this.text.slice(0, active.range.start) +\n      replacement +\n      this.text.slice(active.range.end)\n    const newCursor = active.range.start + replacement.length\n\n    this.update(newText, newCursor)\n\n    // Mark the inserted facet as committed\n    for (const node of this.nodes) {\n      if (node.type !== 'text' && node.start === active.range.start) {\n        node.committed = true\n        break\n      }\n    }\n  }\n}\n\nexport function useTapperCore(config: TapperConfig) {\n  const store = useMemo(() => new Tapper(config), [config])\n  const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot)\n  return {...snapshot, store}\n}\n"]}

package/build/index.d.ts

@@ -0,0 +1,26 @@
+import { type TapperConfig } from './types';
+export * from './types';
+export * from './core';
+export declare function useTapper(config: TapperConfig): {
+    inputProps: {
+        value: string;
+        selection: {
+            start: number;
+            end: number;
+        };
+        onChangeText: (newText: string) => void;
+        onSelectionChange: (e: {
+            nativeEvent: {
+                selection: {
+                    start: number;
+                };
+            };
+        }) => void;
+    };
+    store: import("./core").Tapper;
+    text: string;
+    cursor: number;
+    nodes: import("./types").TapperNode[];
+    activeFacet: import("./types").TapperActiveFacet | null;
+};
+//# 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":"AACA,OAAO,EAAC,KAAK,YAAY,EAAC,MAAM,SAAS,CAAA;AAEzC,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY;;;;;;;;+BASjB;YAAC,WAAW,EAAE;gBAAC,SAAS,EAAE;oBAAC,KAAK,EAAE,MAAM,CAAA;iBAAC,CAAA;aAAC,CAAA;SAAC;;;;;;;EAIvE"}

package/build/index.js

@@ -0,0 +1,16 @@
+import { useTapperCore } from './core';
+export * from './types';
+export * from './core';
+export function useTapper(config) {
+    const tapper = useTapperCore(config);
+    return {
+        ...tapper,
+        inputProps: {
+            value: tapper.text,
+            selection: { start: tapper.cursor, end: tapper.cursor },
+            onChangeText: tapper.store.handleTextChange,
+            onSelectionChange: (e) => tapper.store.handleSelectionChange(e.nativeEvent.selection.start),
+        },
+    };
+}
+//# 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,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAA;AAGpC,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAEpC,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE;YACV,KAAK,EAAE,MAAM,CAAC,IAAI;YAClB,SAAS,EAAE,EAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAC;YACrD,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,gBAAgB;YAC3C,iBAAiB,EAAE,CAAC,CAA8C,EAAE,EAAE,CACpE,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC;SACpE;KACF,CAAA;AACH,CAAC","sourcesContent":["import {useTapperCore} from './core'\nimport {type TapperConfig} from './types'\n\nexport * from './types'\nexport * from './core'\n\nexport function useTapper(config: TapperConfig) {\n  const tapper = useTapperCore(config)\n\n  return {\n    ...tapper,\n    inputProps: {\n      value: tapper.text,\n      selection: {start: tapper.cursor, end: tapper.cursor},\n      onChangeText: tapper.store.handleTextChange,\n      onSelectionChange: (e: {nativeEvent: {selection: {start: number}}}) =>\n        tapper.store.handleSelectionChange(e.nativeEvent.selection.start),\n    },\n  }\n}\n"]}

package/build/index.web.d.ts

@@ -0,0 +1,17 @@
+import { type TapperConfig } from './types';
+export * from './types';
+export * from './core';
+export declare function useTapper(config: TapperConfig): {
+    inputProps: {
+        ref: import("react").RefObject<HTMLTextAreaElement | null>;
+        value: string;
+        onChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
+        onSelect: (e: React.SyntheticEvent<HTMLTextAreaElement>) => void;
+    };
+    store: import("./core").Tapper;
+    text: string;
+    cursor: number;
+    nodes: import("./types").TapperNode[];
+    activeFacet: import("./types").TapperActiveFacet | null;
+};
+//# sourceMappingURL=index.web.d.ts.map

package/build/index.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../src/index.web.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,KAAK,YAAY,EAAC,MAAM,SAAS,CAAA;AAEzC,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY;;;;sBAatC,KAAK,CAAC,WAAW,CAAC,mBAAmB,CAAC;sBAQtC,KAAK,CAAC,cAAc,CAAC,mBAAmB,CAAC;;;;;;;EAgBhD"}

package/build/index.web.js

@@ -0,0 +1,33 @@
+import { useCallback, useLayoutEffect, useRef } from 'react';
+import { useTapperCore } from './core';
+export * from './types';
+export * from './core';
+export function useTapper(config) {
+    const tapper = useTapperCore(config);
+    const textareaRef = useRef(null);
+    // After atomic deletion (or insert), restore cursor position in the DOM
+    useLayoutEffect(() => {
+        const ta = textareaRef.current;
+        if (ta && ta.selectionStart !== tapper.cursor) {
+            ta.setSelectionRange(tapper.cursor, tapper.cursor);
+        }
+    }, [tapper.cursor, tapper.text]);
+    const onChange = useCallback((e) => {
+        tapper.store.handleTextChange(e.target.value);
+        tapper.store.handleSelectionChange(e.target.selectionStart ?? 0);
+    }, [tapper.store]);
+    const onSelect = useCallback((e) => {
+        const target = e.target;
+        tapper.store.handleSelectionChange(target.selectionStart ?? 0);
+    }, [tapper.store]);
+    return {
+        ...tapper,
+        inputProps: {
+            ref: textareaRef,
+            value: tapper.text,
+            onChange,
+            onSelect,
+        },
+    };
+}
+//# sourceMappingURL=index.web.js.map

package/build/index.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.js","sourceRoot":"","sources":["../src/index.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,eAAe,EAAE,MAAM,EAAC,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAA;AAGpC,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,WAAW,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAA;IAErD,wEAAwE;IACxE,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAA;QAC9B,IAAI,EAAE,IAAI,EAAE,CAAC,cAAc,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9C,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACpD,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAEhC,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,CAAyC,EAAE,EAAE;QAC5C,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC7C,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,CAAA;IAClE,CAAC,EACD,CAAC,MAAM,CAAC,KAAK,CAAC,CACf,CAAA;IAED,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,CAA4C,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,CAAC,CAAC,MAA6B,CAAA;QAC9C,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,CAAA;IAChE,CAAC,EACD,CAAC,MAAM,CAAC,KAAK,CAAC,CACf,CAAA;IAED,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE;YACV,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,MAAM,CAAC,IAAI;YAClB,QAAQ;YACR,QAAQ;SACT;KACF,CAAA;AACH,CAAC","sourcesContent":["import {useCallback, useLayoutEffect, useRef} from 'react'\n\nimport {useTapperCore} from './core'\nimport {type TapperConfig} from './types'\n\nexport * from './types'\nexport * from './core'\n\nexport function useTapper(config: TapperConfig) {\n  const tapper = useTapperCore(config)\n  const textareaRef = useRef<HTMLTextAreaElement>(null)\n\n  // After atomic deletion (or insert), restore cursor position in the DOM\n  useLayoutEffect(() => {\n    const ta = textareaRef.current\n    if (ta && ta.selectionStart !== tapper.cursor) {\n      ta.setSelectionRange(tapper.cursor, tapper.cursor)\n    }\n  }, [tapper.cursor, tapper.text])\n\n  const onChange = useCallback(\n    (e: React.ChangeEvent<HTMLTextAreaElement>) => {\n      tapper.store.handleTextChange(e.target.value)\n      tapper.store.handleSelectionChange(e.target.selectionStart ?? 0)\n    },\n    [tapper.store],\n  )\n\n  const onSelect = useCallback(\n    (e: React.SyntheticEvent<HTMLTextAreaElement>) => {\n      const target = e.target as HTMLTextAreaElement\n      tapper.store.handleSelectionChange(target.selectionStart ?? 0)\n    },\n    [tapper.store],\n  )\n\n  return {\n    ...tapper,\n    inputProps: {\n      ref: textareaRef,\n      value: tapper.text,\n      onChange,\n      onSelect,\n    },\n  }\n}\n"]}

package/build/types.d.ts

@@ -0,0 +1,35 @@
+export type TapperFacetConfig = {
+    match: RegExp;
+};
+export type TapperFacetConfigMap = Record<string, TapperFacetConfig>;
+export type TapperNode = {
+    type: string;
+    value: string;
+    start: number;
+    end: number;
+    committed?: boolean;
+};
+export type TapperFacet = {
+    facetType: string;
+    query: string;
+    range: {
+        start: number;
+        end: number;
+    };
+};
+export type TapperActiveFacet = TapperFacet & {
+    insert: (value: string, options?: {
+        noTrailingSpace?: boolean;
+    }) => void;
+};
+export type TapperSnapshot = {
+    text: string;
+    cursor: number;
+    nodes: TapperNode[];
+    activeFacet: TapperActiveFacet | null;
+};
+export type TapperConfig = {
+    facets: TapperFacetConfigMap;
+    initialText?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAEpE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAC,KAAK,IAAI,CAAA;CACvE,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,oBAAoB,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type TapperFacetConfig = {\n  match: RegExp\n}\n\nexport type TapperFacetConfigMap = Record<string, TapperFacetConfig>\n\nexport type TapperNode = {\n  type: string\n  value: string\n  start: number\n  end: number\n  committed?: boolean\n}\n\nexport type TapperFacet = {\n  facetType: string\n  query: string\n  range: {start: number; end: number}\n}\n\nexport type TapperActiveFacet = TapperFacet & {\n  insert: (value: string, options?: {noTrailingSpace?: boolean}) => void\n}\n\nexport type TapperSnapshot = {\n  text: string\n  cursor: number\n  nodes: TapperNode[]\n  activeFacet: TapperActiveFacet | null\n}\n\nexport type TapperConfig = {\n  facets: TapperFacetConfigMap\n  initialText?: string\n}\n"]}

package/build/util.d.ts

@@ -0,0 +1,5 @@
+import { TapperFacetConfigMap, TapperNode, TapperFacet } from './types';
+export declare function parseNodesFromText(text: string, config: TapperFacetConfigMap, prevNodes?: TapperNode[]): TapperNode[];
+export declare function deriveTriggers(config: TapperFacetConfigMap): Map<string, string>;
+export declare function detectActiveFacet(nodes: TapperNode[], text: string, cursor: number, triggers: Map<string, string>): TapperFacet | null;
+//# sourceMappingURL=util.d.ts.map

package/build/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,oBAAoB,EAC5B,SAAS,CAAC,EAAE,UAAU,EAAE,GACvB,UAAU,EAAE,CAyFd;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhF;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EAAE,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,WAAW,GAAG,IAAI,CA2BpB"}

package/build/util.js

@@ -0,0 +1,112 @@
+export function parseNodesFromText(text, config, prevNodes) {
+    const allMatches = [];
+    for (const [name, def] of Object.entries(config)) {
+        const re = new RegExp(def.match.source, def.match.flags);
+        for (const m of text.matchAll(re)) {
+            allMatches.push({
+                facetName: name,
+                fullMatch: m[0],
+                capture: m[0],
+                index: m.index,
+            });
+        }
+    }
+    allMatches.sort((a, b) => a.index - b.index || b.fullMatch.length - a.fullMatch.length);
+    const accepted = [];
+    let lastEnd = 0;
+    for (const m of allMatches) {
+        if (m.index >= lastEnd) {
+            accepted.push(m);
+            lastEnd = m.index + m.fullMatch.length;
+        }
+    }
+    const nodes = [];
+    let cursor = 0;
+    for (const m of accepted) {
+        if (m.index > cursor) {
+            nodes.push({
+                type: 'text',
+                value: text.slice(cursor, m.index),
+                start: cursor,
+                end: m.index,
+            });
+        }
+        nodes.push({
+            type: m.facetName,
+            value: m.capture,
+            start: m.index,
+            end: m.index + m.fullMatch.length,
+        });
+        cursor = m.index + m.fullMatch.length;
+    }
+    if (cursor < text.length) {
+        nodes.push({
+            type: 'text',
+            value: text.slice(cursor),
+            start: cursor,
+            end: text.length,
+        });
+    }
+    // Transfer committed flags from previous nodes by type + occurrence index
+    if (prevNodes) {
+        const counts = new Map();
+        const committedByTypeIndex = new Set();
+        for (const node of prevNodes) {
+            if (node.type === 'text')
+                continue;
+            const idx = counts.get(node.type) ?? 0;
+            counts.set(node.type, idx + 1);
+            if (node.committed) {
+                committedByTypeIndex.add(`${node.type}:${idx}`);
+            }
+        }
+        counts.clear();
+        for (const node of nodes) {
+            if (node.type === 'text')
+                continue;
+            const idx = counts.get(node.type) ?? 0;
+            counts.set(node.type, idx + 1);
+            if (committedByTypeIndex.has(`${node.type}:${idx}`)) {
+                node.committed = true;
+            }
+        }
+    }
+    return nodes;
+}
+export function deriveTriggers(config) {
+    const triggers = new Map();
+    for (const [name, def] of Object.entries(config)) {
+        const m = def.match.source.match(/^[^\\([\]{}.*+?^$|]+/);
+        if (m)
+            triggers.set(m[0], name);
+    }
+    return triggers;
+}
+export function detectActiveFacet(nodes, text, cursor, triggers) {
+    for (const node of nodes) {
+        if (node.type !== 'text' && node.start < cursor && cursor <= node.end) {
+            return {
+                facetType: node.type,
+                query: node.value,
+                range: { start: node.start, end: node.end },
+            };
+        }
+    }
+    // Scan backward from cursor for a trigger char (partial facet not yet matched by regex)
+    for (let i = cursor - 1; i >= 0; i--) {
+        const ch = text[i];
+        // Stop at whitespace — triggers don't span across words
+        if (/\s/.test(ch))
+            break;
+        const facetType = triggers.get(ch);
+        if (facetType) {
+            return {
+                facetType,
+                query: text.slice(i + 1, cursor),
+                range: { start: i, end: cursor },
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=util.js.map

package/build/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  TapperFacetConfigMap,\n  TapperNode,\n  TapperFacet,\n} from './types'\n\nexport function parseNodesFromText(\n  text: string,\n  config: TapperFacetConfigMap,\n  prevNodes?: TapperNode[],\n): TapperNode[] {\n  const allMatches: {\n    facetName: string\n    fullMatch: string\n    capture: string\n    index: number\n  }[] = []\n\n  for (const [name, def] of Object.entries(config)) {\n    const re = new RegExp(def.match.source, def.match.flags)\n    for (const m of text.matchAll(re)) {\n      allMatches.push({\n        facetName: name,\n        fullMatch: m[0],\n        capture: m[0],\n        index: m.index,\n      })\n    }\n  }\n\n  allMatches.sort(\n    (a, b) => a.index - b.index || b.fullMatch.length - a.fullMatch.length,\n  )\n\n  const accepted: typeof allMatches = []\n  let lastEnd = 0\n  for (const m of allMatches) {\n    if (m.index >= lastEnd) {\n      accepted.push(m)\n      lastEnd = m.index + m.fullMatch.length\n    }\n  }\n\n  const nodes: TapperNode[] = []\n  let cursor = 0\n\n  for (const m of accepted) {\n    if (m.index > cursor) {\n      nodes.push({\n        type: 'text',\n        value: text.slice(cursor, m.index),\n        start: cursor,\n        end: m.index,\n      })\n    }\n    nodes.push({\n      type: m.facetName,\n      value: m.capture,\n      start: m.index,\n      end: m.index + m.fullMatch.length,\n    })\n    cursor = m.index + m.fullMatch.length\n  }\n\n  if (cursor < text.length) {\n    nodes.push({\n      type: 'text',\n      value: text.slice(cursor),\n      start: cursor,\n      end: text.length,\n    })\n  }\n\n  // Transfer committed flags from previous nodes by type + occurrence index\n  if (prevNodes) {\n    const counts = new Map<string, number>()\n    const committedByTypeIndex = new Set<string>()\n\n    for (const node of prevNodes) {\n      if (node.type === 'text') continue\n      const idx = counts.get(node.type) ?? 0\n      counts.set(node.type, idx + 1)\n      if (node.committed) {\n        committedByTypeIndex.add(`${node.type}:${idx}`)\n      }\n    }\n\n    counts.clear()\n    for (const node of nodes) {\n      if (node.type === 'text') continue\n      const idx = counts.get(node.type) ?? 0\n      counts.set(node.type, idx + 1)\n      if (committedByTypeIndex.has(`${node.type}:${idx}`)) {\n        node.committed = true\n      }\n    }\n  }\n\n  return nodes\n}\n\nexport function deriveTriggers(config: TapperFacetConfigMap): Map<string, string> {\n  const triggers = new Map<string, string>()\n  for (const [name, def] of Object.entries(config)) {\n    const m = def.match.source.match(/^[^\\\\([\\]{}.*+?^$|]+/)\n    if (m) triggers.set(m[0], name)\n  }\n  return triggers\n}\n\nexport function detectActiveFacet(\n  nodes: TapperNode[],\n  text: string,\n  cursor: number,\n  triggers: Map<string, string>,\n): TapperFacet | null {\n  for (const node of nodes) {\n    if (node.type !== 'text' && node.start < cursor && cursor <= node.end) {\n      return {\n        facetType: node.type,\n        query: node.value,\n        range: {start: node.start, end: node.end},\n      }\n    }\n  }\n\n  // Scan backward from cursor for a trigger char (partial facet not yet matched by regex)\n  for (let i = cursor - 1; i >= 0; i--) {\n    const ch = text[i]\n    // Stop at whitespace — triggers don't span across words\n    if (/\\s/.test(ch)) break\n    const facetType = triggers.get(ch)\n    if (facetType) {\n      return {\n        facetType,\n        query: text.slice(i + 1, cursor),\n        range: {start: i, end: cursor},\n      }\n    }\n  }\n\n  return null\n}\n"]}

package/expo-module.config.json

@@ -0,0 +1,5 @@
+{
+  "platforms": ["apple", "android", "web"],
+  "apple": {},
+  "android": {}
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@bsky.app/tapper",
+  "version": "0.1.0",
+  "description": "My new module",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "expo-module build",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "vitest run",
+    "prepare": "expo-module prepare",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module",
+    "open:ios": "xed example/ios",
+    "open:android": "open -a \"Android Studio\" example/android"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "tapper",
+    "Tapper"
+  ],
+  "repository": "https://github.com/estrattonbailey/tapper",
+  "bugs": {
+    "url": "https://github.com/estrattonbailey/tapper/issues"
+  },
+  "author": "Bluesky Social PBLLC <git@esb.lol> (https://github.com/estrattonbailey)",
+  "license": "MIT",
+  "homepage": "https://github.com/estrattonbailey/tapper#readme",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/react": "~19.1.1",
+    "expo-module-scripts": "^55.0.2",
+    "vitest": "^3.1.1",
+    "expo": "^55.0.8",
+    "react-native": "0.82.1"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  }
+}

package/src/core.ts

@@ -0,0 +1,185 @@
+import {useMemo, useSyncExternalStore} from 'react'
+
+import {
+  TapperConfig,
+  TapperFacetConfigMap,
+  TapperNode,
+  TapperActiveFacet,
+  TapperSnapshot,
+} from './types'
+
+import {parseNodesFromText, detectActiveFacet, deriveTriggers} from './util'
+
+export class Tapper {
+  private facetConfig: TapperFacetConfigMap
+  private triggers: Map<string, string>
+
+  // Public state
+  text = ''
+  cursor = 0
+  nodes: TapperNode[] = []
+  activeFacet: TapperActiveFacet | null = null
+
+  // Internal tracking
+  private updating = false
+  private pendingCursor: number | null = null
+
+  // useSyncExternalStore plumbing
+  private storeListeners = new Set<() => void>()
+  private snapshot: TapperSnapshot
+
+  constructor(config: TapperConfig) {
+    this.facetConfig = config.facets
+    this.triggers = deriveTriggers(config.facets)
+    this.snapshot = {
+      text: this.text,
+      cursor: this.cursor,
+      nodes: this.nodes,
+      activeFacet: this.activeFacet,
+    }
+    if (config.initialText) {
+      this.replaceText(config.initialText)
+    }
+  }
+
+  subscribe = (listener: () => void) => {
+    this.storeListeners.add(listener)
+    return () => this.storeListeners.delete(listener)
+  }
+
+  getSnapshot = (): TapperSnapshot => {
+    return this.snapshot
+  }
+
+  private notify() {
+    this.snapshot = {
+      text: this.text,
+      cursor: this.cursor,
+      nodes: this.nodes,
+      activeFacet: this.activeFacet,
+    }
+    this.storeListeners.forEach(l => l())
+  }
+
+  private update(newText: string, cursor: number) {
+    // guard against circular updates when insert is called during an update cycle
+    if (this.updating) return
+    this.updating = true
+
+    const nodes = parseNodesFromText(newText, this.facetConfig, this.nodes)
+    const prev = this.activeFacet
+    const detected = detectActiveFacet(nodes, newText, cursor, this.triggers)
+
+    // When cursor leaves a facet, commit it
+    if (prev && (!detected || detected.facetType !== prev.facetType)) {
+      for (const node of nodes) {
+        if (node.type === prev.facetType && node.value === prev.query) {
+          node.committed = true
+          break
+        }
+      }
+    }
+
+    // Build activeFacet with insert baked in
+    const active: TapperActiveFacet | null = detected
+      ? {...detected, insert: this.insert}
+      : null
+
+    this.text = newText
+    this.cursor = cursor
+    this.nodes = nodes
+    this.activeFacet = active
+
+    this.updating = false
+    this.notify()
+  }
+
+  handleTextChange = (newText: string) => {
+    const diff = newText.length - this.text.length
+    let newCursor = Math.max(this.cursor + diff, 0)
+
+    // Atomic deletion: backspace into a facet from outside
+    if (diff === -1 && newCursor < this.cursor) {
+      for (const node of this.nodes) {
+        if (
+          node.type !== 'text' &&
+          node.committed &&
+          this.cursor === node.end
+        ) {
+          const remnant = node.end - node.start - 1
+          newText =
+            newText.slice(0, node.start) + newText.slice(node.start + remnant)
+          newCursor = node.start
+          this.pendingCursor = newCursor
+          break
+        }
+      }
+    }
+
+    this.update(newText, newCursor)
+  }
+
+  handleSelectionChange = (newCursor: number) => {
+    // After atomic deletion, ignore stale cursor values from the DOM
+    if (this.pendingCursor !== null) {
+      if (newCursor !== this.pendingCursor) {
+        return
+      }
+      this.pendingCursor = null
+    }
+
+    this.cursor = newCursor
+    this.update(this.text, newCursor)
+  }
+
+  replaceText = (text: string, cursor?: number) => {
+    const nodes = parseNodesFromText(text, this.facetConfig)
+    // Mark all non-text nodes as committed (pre-existing facets)
+    for (const node of nodes) {
+      if (node.type !== 'text') {
+        node.committed = true
+      }
+    }
+
+    const pos = cursor ?? text.length
+    const detected = detectActiveFacet(nodes, text, pos, this.triggers)
+    const active: TapperActiveFacet | null = detected
+      ? {...detected, insert: this.insert}
+      : null
+
+    this.text = text
+    this.cursor = pos
+    this.nodes = nodes
+    this.activeFacet = active
+
+    this.notify()
+  }
+
+  private insert = (value: string, options?: {noTrailingSpace?: boolean}) => {
+    const active = this.activeFacet
+    if (!active) return
+
+    const replacement = value + (options?.noTrailingSpace ? '' : ' ')
+    const newText =
+      this.text.slice(0, active.range.start) +
+      replacement +
+      this.text.slice(active.range.end)
+    const newCursor = active.range.start + replacement.length
+
+    this.update(newText, newCursor)
+
+    // Mark the inserted facet as committed
+    for (const node of this.nodes) {
+      if (node.type !== 'text' && node.start === active.range.start) {
+        node.committed = true
+        break
+      }
+    }
+  }
+}
+
+export function useTapperCore(config: TapperConfig) {
+  const store = useMemo(() => new Tapper(config), [config])
+  const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot)
+  return {...snapshot, store}
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+import {useTapperCore} from './core'
+import {type TapperConfig} from './types'
+
+export * from './types'
+export * from './core'
+
+export function useTapper(config: TapperConfig) {
+  const tapper = useTapperCore(config)
+
+  return {
+    ...tapper,
+    inputProps: {
+      value: tapper.text,
+      selection: {start: tapper.cursor, end: tapper.cursor},
+      onChangeText: tapper.store.handleTextChange,
+      onSelectionChange: (e: {nativeEvent: {selection: {start: number}}}) =>
+        tapper.store.handleSelectionChange(e.nativeEvent.selection.start),
+    },
+  }
+}

package/src/index.web.ts

@@ -0,0 +1,46 @@
+import {useCallback, useLayoutEffect, useRef} from 'react'
+
+import {useTapperCore} from './core'
+import {type TapperConfig} from './types'
+
+export * from './types'
+export * from './core'
+
+export function useTapper(config: TapperConfig) {
+  const tapper = useTapperCore(config)
+  const textareaRef = useRef<HTMLTextAreaElement>(null)
+
+  // After atomic deletion (or insert), restore cursor position in the DOM
+  useLayoutEffect(() => {
+    const ta = textareaRef.current
+    if (ta && ta.selectionStart !== tapper.cursor) {
+      ta.setSelectionRange(tapper.cursor, tapper.cursor)
+    }
+  }, [tapper.cursor, tapper.text])
+
+  const onChange = useCallback(
+    (e: React.ChangeEvent<HTMLTextAreaElement>) => {
+      tapper.store.handleTextChange(e.target.value)
+      tapper.store.handleSelectionChange(e.target.selectionStart ?? 0)
+    },
+    [tapper.store],
+  )
+
+  const onSelect = useCallback(
+    (e: React.SyntheticEvent<HTMLTextAreaElement>) => {
+      const target = e.target as HTMLTextAreaElement
+      tapper.store.handleSelectionChange(target.selectionStart ?? 0)
+    },
+    [tapper.store],
+  )
+
+  return {
+    ...tapper,
+    inputProps: {
+      ref: textareaRef,
+      value: tapper.text,
+      onChange,
+      onSelect,
+    },
+  }
+}

package/src/types.ts

@@ -0,0 +1,35 @@
+export type TapperFacetConfig = {
+  match: RegExp
+}
+
+export type TapperFacetConfigMap = Record<string, TapperFacetConfig>
+
+export type TapperNode = {
+  type: string
+  value: string
+  start: number
+  end: number
+  committed?: boolean
+}
+
+export type TapperFacet = {
+  facetType: string
+  query: string
+  range: {start: number; end: number}
+}
+
+export type TapperActiveFacet = TapperFacet & {
+  insert: (value: string, options?: {noTrailingSpace?: boolean}) => void
+}
+
+export type TapperSnapshot = {
+  text: string
+  cursor: number
+  nodes: TapperNode[]
+  activeFacet: TapperActiveFacet | null
+}
+
+export type TapperConfig = {
+  facets: TapperFacetConfigMap
+  initialText?: string
+}

package/src/util.ts

@@ -0,0 +1,143 @@
+import {
+  TapperFacetConfigMap,
+  TapperNode,
+  TapperFacet,
+} from './types'
+
+export function parseNodesFromText(
+  text: string,
+  config: TapperFacetConfigMap,
+  prevNodes?: TapperNode[],
+): TapperNode[] {
+  const allMatches: {
+    facetName: string
+    fullMatch: string
+    capture: string
+    index: number
+  }[] = []
+
+  for (const [name, def] of Object.entries(config)) {
+    const re = new RegExp(def.match.source, def.match.flags)
+    for (const m of text.matchAll(re)) {
+      allMatches.push({
+        facetName: name,
+        fullMatch: m[0],
+        capture: m[0],
+        index: m.index,
+      })
+    }
+  }
+
+  allMatches.sort(
+    (a, b) => a.index - b.index || b.fullMatch.length - a.fullMatch.length,
+  )
+
+  const accepted: typeof allMatches = []
+  let lastEnd = 0
+  for (const m of allMatches) {
+    if (m.index >= lastEnd) {
+      accepted.push(m)
+      lastEnd = m.index + m.fullMatch.length
+    }
+  }
+
+  const nodes: TapperNode[] = []
+  let cursor = 0
+
+  for (const m of accepted) {
+    if (m.index > cursor) {
+      nodes.push({
+        type: 'text',
+        value: text.slice(cursor, m.index),
+        start: cursor,
+        end: m.index,
+      })
+    }
+    nodes.push({
+      type: m.facetName,
+      value: m.capture,
+      start: m.index,
+      end: m.index + m.fullMatch.length,
+    })
+    cursor = m.index + m.fullMatch.length
+  }
+
+  if (cursor < text.length) {
+    nodes.push({
+      type: 'text',
+      value: text.slice(cursor),
+      start: cursor,
+      end: text.length,
+    })
+  }
+
+  // Transfer committed flags from previous nodes by type + occurrence index
+  if (prevNodes) {
+    const counts = new Map<string, number>()
+    const committedByTypeIndex = new Set<string>()
+
+    for (const node of prevNodes) {
+      if (node.type === 'text') continue
+      const idx = counts.get(node.type) ?? 0
+      counts.set(node.type, idx + 1)
+      if (node.committed) {
+        committedByTypeIndex.add(`${node.type}:${idx}`)
+      }
+    }
+
+    counts.clear()
+    for (const node of nodes) {
+      if (node.type === 'text') continue
+      const idx = counts.get(node.type) ?? 0
+      counts.set(node.type, idx + 1)
+      if (committedByTypeIndex.has(`${node.type}:${idx}`)) {
+        node.committed = true
+      }
+    }
+  }
+
+  return nodes
+}
+
+export function deriveTriggers(config: TapperFacetConfigMap): Map<string, string> {
+  const triggers = new Map<string, string>()
+  for (const [name, def] of Object.entries(config)) {
+    const m = def.match.source.match(/^[^\\([\]{}.*+?^$|]+/)
+    if (m) triggers.set(m[0], name)
+  }
+  return triggers
+}
+
+export function detectActiveFacet(
+  nodes: TapperNode[],
+  text: string,
+  cursor: number,
+  triggers: Map<string, string>,
+): TapperFacet | null {
+  for (const node of nodes) {
+    if (node.type !== 'text' && node.start < cursor && cursor <= node.end) {
+      return {
+        facetType: node.type,
+        query: node.value,
+        range: {start: node.start, end: node.end},
+      }
+    }
+  }
+
+  // Scan backward from cursor for a trigger char (partial facet not yet matched by regex)
+  for (let i = cursor - 1; i >= 0; i--) {
+    const ch = text[i]
+    // Stop at whitespace — triggers don't span across words
+    if (/\s/.test(ch)) break
+    const facetType = triggers.get(ch)
+    if (facetType) {
+      return {
+        facetType,
+        query: text.slice(i + 1, cursor),
+        range: {start: i, end: cursor},
+      }
+    }
+  }
+
+  return null
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+// @generated by expo-module-scripts
+{
+  "extends": "expo-module-scripts/tsconfig.base",
+  "compilerOptions": {
+    "outDir": "./build"
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*", "**/__rsc_tests__/*"]
+}

package/vitest.config.ts

@@ -0,0 +1,7 @@
+import {defineConfig} from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    include: ['src/__tests__/**/*.test.ts'],
+  },
+})