@bsky.app/tapper 0.1.1 → 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @bsky.app/tapper
+
+## 0.2.2
+
+### Patch Changes
+
+- [`255ae92`](https://github.com/bluesky-social/toolbox/commit/255ae923d552c12b6ad36dedde37a9bf44d02866) Thanks [@estrattonbailey](https://github.com/estrattonbailey)! - Bump sift/tapper for publish
+
+## 0.2.1
+
+### Patch Changes
+
+- [`06c8141`](https://github.com/bluesky-social/toolbox/commit/06c81411f8420240c8c794d41398df034c514fda) Thanks [@estrattonbailey](https://github.com/estrattonbailey)! - Bump packages

package/README.md

@@ -1,3 +1,206 @@
 # @bsky.app/tapper
 
-A minimal rich text editor for React Native and web.
+A facet-aware text input engine for React Native (including web). Parses
+configurable patterns (mentions, emoji, tags, URLs) from text as the user types,
+producing a node list you render as a colored preview overlay on top of a
+transparent `TextInput`.
+
+## Installation
+
+```sh
+pnpm add @bsky.app/tapper
+```
+
+Peer dependencies: `react`, `react-native`.
+
+## Basic example
+
+```tsx
+import {useEffect} from 'react'
+import {View, Text, TextInput} from 'react-native'
+import {useTapper} from '@bsky.app/tapper'
+
+function Composer() {
+  const {text, nodes, inputProps, focus, on} = useTapper({
+    facets: {
+      mention: {match: /@([a-zA-Z0-9._]+)/g},
+      emoji: {match: /:([a-zA-Z0-9_]+):/g},
+    },
+  })
+
+  // Re-focus after an autocomplete insertion
+  useEffect(() => {
+    return on('afterInsert', () => focus())
+  }, [on, focus])
+
+  return (
+    <View style={{position: 'relative'}}>
+      {/* Preview overlay — renders colored facets */}
+      <View
+        style={{position: 'absolute', top: 0, left: 0, right: 0, bottom: 0}}>
+        <Text>
+          {nodes.map((node, i) => (
+            <Text
+              key={i}
+              style={{
+                color:
+                  node.type === 'facet'
+                    ? '#2e7de9'
+                    : node.type === 'trigger'
+                      ? '#999'
+                      : '#000',
+              }}>
+              {node.raw}
+            </Text>
+          ))}
+        </Text>
+      </View>
+
+      {/* Actual input — transparent text, visible caret */}
+      <TextInput
+        {...inputProps}
+        multiline
+        style={{
+          color: 'transparent',
+          caretColor: '#000',
+        }}
+        placeholder="Type here..."
+      />
+    </View>
+  )
+}
+```
+
+The preview overlay and `TextInput` must share the same text styles (font
+family, size, line height, padding) so they align exactly.
+
+## How it works
+
+`useTapper` returns:
+
+| Property      | Description                                         |
+| ------------- | --------------------------------------------------- |
+| `text`        | Current text value                                  |
+| `nodes`       | Parsed node list for rendering                      |
+| `activeFacet` | The facet the cursor is currently inside, or `null` |
+| `inputProps`  | Spread onto your `TextInput`                        |
+| `on`          | Subscribe to events                                 |
+| `focus`       | Re-focus the input (useful after `commit`)          |
+
+### Nodes
+
+Each node has a `type` discriminant:
+
+- **`'text'`** — plain text, render as-is.
+- **`'trigger'`** — the user just typed a trigger character (e.g. `@`) but
+  hasn't typed any content yet. Has `facetType` so you know which kind.
+- **`'facet'`** — a matched pattern. Has `facetType` (e.g. `'mention'`,
+  `'emoji'`).
+
+All nodes have `raw` (the full matched text including trigger) and `value`
+(content only, trigger stripped). For display, use `node.raw`.
+
+```ts
+// Typing "@eric" produces:
+{type: 'facet', facetType: 'mention', raw: '@eric', value: 'eric', start: 0, end: 5}
+```
+
+### Active facet
+
+When the cursor is inside a facet or right after a trigger character,
+`activeFacet` is non-null:
+
+```ts
+activeFacet: {
+  type: 'mention',       // the facet type
+  value: 'er',           // content after trigger (no @)
+  range: {start: 0, end: 3},
+  insert: (value, options?) => void,
+}
+```
+
+Call `activeFacet.insert('@eric')` to replace the in-progress facet with a
+final value. A trailing space is appended by default; pass
+`{noTrailingSpace: true}` to suppress it.
+
+## Emoji auto-commit example
+
+A common pattern: when the user types a closing `:` on an emoji shortcode
+(e.g. `:wave:`), immediately replace it with the emoji character.
+
+```tsx
+const {on, activeFacet, focus} = useTapper({
+  facets: {
+    emoji: {match: /:([a-zA-Z0-9_]+):/g},
+  },
+})
+
+const EMOJI: Record<string, string> = {
+  wave: '👋',
+  tada: '🎉',
+  v: '✌️',
+}
+
+useEffect(() => {
+  return on('activeFacet', facet => {
+    if (facet?.type === 'emoji' && facet.value.endsWith(':')) {
+      const name = facet.value.slice(0, -1) // strip closing ":"
+      const emoji = EMOJI[name]
+      if (emoji) {
+        facet.insert(emoji, {noTrailingSpace: true})
+      }
+    }
+  })
+}, [on])
+
+// Re-focus after insertion
+useEffect(() => {
+  return on('afterInsert', () => focus())
+}, [on, focus])
+```
+
+## Events
+
+Subscribe with `on(event, callback)`. Returns an unsubscribe function — use it
+in a `useEffect` cleanup.
+
+| Event            | Data                        | When                                            |
+| ---------------- | --------------------------- | ----------------------------------------------- |
+| `activeFacet`    | `TapperActiveFacet \| null` | Cursor enters or leaves a facet                 |
+| `facetCommitted` | `TapperFacet`               | A facet is finalized (cursor left or committed) |
+| `afterInsert`    | `TapperFacet`               | After `insert()` replaces text                  |
+
+### `focus()`
+
+After `insert()` replaces text, the input may lose focus on some platforms.
+Listen for `afterInsert` and call `focus()` to restore it:
+
+```tsx
+useEffect(() => {
+  return on('afterInsert', () => focus())
+}, [on, focus])
+```
+
+## Atomic deletion
+
+Committed facets are deleted atomically — backspacing into a committed facet
+from outside removes the entire facet in one keystroke, rather than deleting
+character by character.
+
+## `initialText`
+
+Pre-populate the input with text. Any matched facets are automatically marked
+as committed.
+
+```tsx
+const {nodes} = useTapper({
+  facets: {mention: {match: /@([a-zA-Z0-9._]+)/g}},
+  initialText: 'Hello @eric',
+})
+```
+
+## `replaceText`
+
+The `Tapper` class (used internally by `useTapper`) exposes `replaceText(text,
+cursor?)` for programmatic text replacement. All matched facets in the new text
+are marked as committed.

package/build/index.d.ts

@@ -1,8 +1,40 @@
-import { type TapperConfig } from './types';
+import { TapperConfig, TapperEvents, TapperNode, TapperActiveFacet, TapperSnapshot } from './types';
 export * from './types';
-export * from './core';
+export declare class Tapper {
+    private facetRegexes;
+    private triggers;
+    private listeners;
+    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;
+    on: <K extends keyof TapperEvents>(event: K, cb: (data: TapperEvents[K]) => void) => () => void;
+    private emit;
+    private notify;
+    private update;
+    handleTextChange: (newText: string) => void;
+    handleSelectionChange: (e: {
+        nativeEvent: {
+            selection: {
+                start: number;
+            };
+        };
+    }) => void;
+    replaceText: (text: string, cursor?: number) => void;
+    private insert;
+}
 export declare function useTapper(config: TapperConfig): {
+    on: <K extends keyof TapperEvents>(event: K, cb: (data: TapperEvents[K]) => void) => () => void;
+    focus: () => void | undefined;
     inputProps: {
+        ref: React.RefObject<any>;
         value: string;
         selection: {
             start: number;
@@ -17,10 +49,9 @@ export declare function useTapper(config: TapperConfig): {
             };
         }) => void;
     };
-    store: import("./core").Tapper;
     text: string;
     cursor: number;
-    nodes: import("./types").TapperNode[];
-    activeFacet: import("./types").TapperActiveFacet | null;
+    nodes: TapperNode[];
+    activeFacet: TapperActiveFacet | null;
 };
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,cAAc,EACf,MAAM,SAAS,CAAA;AAUhB,cAAc,SAAS,CAAA;AAEvB,qBAAa,MAAM;IACjB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAqB;IAIrC,OAAO,CAAC,SAAS,CAA0D;IAG3E,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,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;IA8Dd,gBAAgB,GAAI,SAAS,MAAM,UAuBlC;IAED,qBAAqB,GAAI,GAAG;QAAC,WAAW,EAAE;YAAC,SAAS,EAAE;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAC,CAAA;SAAC,CAAA;KAAC,UActE;IAED,WAAW,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,UA+B3C;IAED,OAAO,CAAC,MAAM,CAoBb;CACF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY;SAxLtC,CAAC,SAAS,MAAM,YAAY,2CAED,IAAI;;;aAgMhB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC;;;;;;gCA3GZ,MAAM;+BAyBP;YAAC,WAAW,EAAE;gBAAC,SAAS,EAAE;oBAAC,KAAK,EAAE,MAAM,CAAA;iBAAC,CAAA;aAAC,CAAA;SAAC;;;;;;EAyFxE"}

package/build/index.js

@@ -1,15 +1,204 @@
-import { useTapperCore } from './core';
+import { useRef, useState, useSyncExternalStore } from 'react';
+import { parseNodesFromText, detectActiveFacet, deriveTriggers, nodeToFacet, compileFacetRegexes, } from './util';
 export * from './types';
-export * from './core';
+export class Tapper {
+    facetRegexes;
+    triggers;
+    // Event emitters
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    listeners = new Map();
+    // Public state
+    text = '';
+    cursor = 0;
+    nodes = [];
+    activeFacet = null;
+    // Internal tracking
+    updating = false;
+    pendingCursor = null;
+    // useSyncExternalStore plumbing
+    storeListeners = new Set();
+    snapshot;
+    constructor(config) {
+        this.facetRegexes = compileFacetRegexes(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;
+    };
+    on = (event, cb) => {
+        if (!this.listeners.has(event))
+            this.listeners.set(event, new Set());
+        this.listeners.get(event).add(cb);
+        return () => {
+            this.listeners.get(event)?.delete(cb);
+        };
+    };
+    emit(event, data) {
+        this.listeners.get(event)?.forEach(cb => cb(data));
+    }
+    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 commit() is called during an update cycle
+        if (this.updating)
+            return;
+        this.updating = true;
+        const nodes = newText === this.text
+            ? this.nodes
+            : parseNodesFromText(newText, this.facetRegexes, this.nodes, cursor, this.triggers);
+        const prev = this.activeFacet;
+        const detected = detectActiveFacet(nodes, newText, cursor, this.triggers);
+        // When cursor leaves a facet, commit it
+        let committedNode = null;
+        if (prev && (!detected || detected.type !== prev.type)) {
+            for (const node of nodes) {
+                if (node.type === 'facet' &&
+                    node.facetType === prev.type &&
+                    node.start === prev.range.start &&
+                    node.end === prev.range.end) {
+                    node.committed = true;
+                    committedNode = node;
+                    break;
+                }
+            }
+        }
+        // Build activeFacet with commit() 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();
+        // Fire events after state is finalized
+        const facetChanged = active?.type !== prev?.type ||
+            active?.value !== prev?.value ||
+            active?.range.start !== prev?.range.start ||
+            active?.range.end !== prev?.range.end;
+        if (facetChanged) {
+            this.emit('activeFacet', active);
+        }
+        if (committedNode) {
+            this.emit('facetCommitted', nodeToFacet(committedNode));
+        }
+    }
+    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 === 'facet' &&
+                    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 = (e) => {
+        const newCursor = e.nativeEvent.selection.start;
+        // After atomic deletion, ignore stale cursor values from the DOM
+        if (this.pendingCursor !== null) {
+            if (newCursor !== this.pendingCursor) {
+                return;
+            }
+            this.pendingCursor = null;
+        }
+        if (newCursor === this.cursor)
+            return;
+        this.cursor = newCursor;
+        this.update(this.text, newCursor);
+    };
+    replaceText = (text, cursor) => {
+        const prevActive = this.activeFacet;
+        const nodes = parseNodesFromText(text, this.facetRegexes);
+        // Mark all non-text nodes as committed (pre-existing facets)
+        const newlyCommitted = [];
+        for (const node of nodes) {
+            if (node.type === 'facet') {
+                node.committed = true;
+                newlyCommitted.push(node);
+            }
+        }
+        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();
+        if (active !== prevActive) {
+            this.emit('activeFacet', active);
+        }
+        for (const node of newlyCommitted) {
+            this.emit('facetCommitted', nodeToFacet(node));
+        }
+    };
+    insert = (value, options) => {
+        if (!this.activeFacet)
+            return;
+        const replacement = value + (options?.noTrailingSpace ? '' : ' ');
+        const newText = this.text.slice(0, this.activeFacet.range.start) +
+            replacement +
+            this.text.slice(this.activeFacet.range.end);
+        const newCursor = this.activeFacet.range.start + replacement.length;
+        if (this.activeFacet) {
+            this.activeFacet.value = value;
+            this.activeFacet.range = {
+                start: this.activeFacet.range.start,
+                end: this.activeFacet.range.start + value.length,
+            };
+            this.emit('afterInsert', this.activeFacet);
+        }
+        this.update(newText, newCursor);
+    };
+}
 export function useTapper(config) {
-    const tapper = useTapperCore(config);
+    const [store] = useState(() => new Tapper(config));
+    const state = useSyncExternalStore(store.subscribe, store.getSnapshot);
+    const inputRef = useRef(null);
     return {
-        ...tapper,
+        ...state,
+        on: store.on,
+        focus: () => inputRef.current?.focus(),
         inputProps: {
-            value: tapper.text,
-            selection: { start: tapper.cursor, end: tapper.cursor },
-            onChangeText: tapper.store.handleTextChange,
-            onSelectionChange: (e) => tapper.store.handleSelectionChange(e.nativeEvent.selection.start),
+            ref: inputRef,
+            value: state.text,
+            selection: { start: state.cursor, end: state.cursor },
+            onChangeText: store.handleTextChange,
+            onSelectionChange: store.handleSelectionChange,
         },
     };
 }

package/build/index.js.map

@@ -1 +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"]}
+{"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  TapperSnapshot,\n} from './types'\nimport {\n  parseNodesFromText,\n  detectActiveFacet,\n  deriveTriggers,\n  nodeToFacet,\n  compileFacetRegexes,\n  type CompiledFacetRegexes,\n} from './util'\n\nexport * from './types'\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  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.facetRegexes = compileFacetRegexes(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  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      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 commit() is called during an update cycle\n    if (this.updating) return\n    this.updating = true\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 = 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 commit() 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    // 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 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 === 'facet' &&\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 = (e: {nativeEvent: {selection: {start: number}}}) => {\n    const newCursor = e.nativeEvent.selection.start\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    if (newCursor === this.cursor) return\n\n    this.cursor = newCursor\n    this.update(this.text, newCursor)\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.cursor = 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 newCursor = 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, newCursor)\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: {start: state.cursor, end: state.cursor},\n      onChangeText: store.handleTextChange,\n      onSelectionChange: store.handleSelectionChange,\n    },\n  }\n}\n"]}

package/build/types.d.ts

@@ -3,15 +3,33 @@ export type TapperFacetConfig = {
 };
 export type TapperFacetConfigMap = Record<string, TapperFacetConfig>;
 export type TapperNode = {
-    type: string;
+    type: 'text';
+    raw: string;
+    value: string;
+    start: number;
+    end: number;
+    committed?: boolean;
+    facetType?: undefined;
+} | {
+    type: 'trigger';
+    raw: string;
+    value: string;
+    start: number;
+    end: number;
+    committed?: boolean;
+    facetType: string;
+} | {
+    type: 'facet';
+    raw: string;
     value: string;
     start: number;
     end: number;
     committed?: boolean;
+    facetType: string;
 };
 export type TapperFacet = {
-    facetType: string;
-    query: string;
+    type: string;
+    value: string;
     range: {
         start: number;
         end: number;
@@ -32,4 +50,9 @@ export type TapperConfig = {
     facets: TapperFacetConfigMap;
     initialText?: string;
 };
+export type TapperEvents = {
+    activeFacet: TapperActiveFacet | null;
+    facetCommitted: TapperFacet;
+    afterInsert: TapperFacet;
+};
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +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"}
+{"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,GAClB;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB,GACD;IACE,IAAI,EAAE,SAAS,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,GACD;IACE,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAEL,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,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;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACrC,cAAc,EAAE,WAAW,CAAA;IAC3B,WAAW,EAAE,WAAW,CAAA;CACzB,CAAA"}

package/build/types.js.map

@@ -1 +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"]}
+{"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  | {\n      type: 'text'\n      raw: string\n      value: string\n      start: number\n      end: number\n      committed?: boolean\n      facetType?: undefined\n    }\n  | {\n      type: 'trigger'\n      raw: string\n      value: string\n      start: number\n      end: number\n      committed?: boolean\n      facetType: string\n    }\n  | {\n      type: 'facet'\n      raw: string\n      value: string\n      start: number\n      end: number\n      committed?: boolean\n      facetType: string\n    }\n\nexport type TapperFacet = {\n  type: string\n  value: 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\nexport type TapperEvents = {\n  activeFacet: TapperActiveFacet | null\n  facetCommitted: TapperFacet\n  afterInsert: TapperFacet\n}\n"]}

package/build/util.d.ts

@@ -1,5 +1,14 @@
 import { TapperFacetConfigMap, TapperNode, TapperFacet } from './types';
-export declare function parseNodesFromText(text: string, config: TapperFacetConfigMap, prevNodes?: TapperNode[]): TapperNode[];
+export type CompiledFacetRegexes = Map<string, RegExp>;
+/**
+ * Pre-compile facet regexes once at init time. This avoids re-creating
+ * RegExp objects on every keystroke in parseNodesFromText. Each Tapper
+ * instance gets its own compiled copy so lastIndex state can't leak
+ * between instances.
+ */
+export declare function compileFacetRegexes(config: TapperFacetConfigMap): CompiledFacetRegexes;
+export declare function parseNodesFromText(text: string, regexes: CompiledFacetRegexes, prevNodes?: TapperNode[], cursor?: number, triggers?: Map<string, string>): TapperNode[];
 export declare function deriveTriggers(config: TapperFacetConfigMap): Map<string, string>;
+export declare function nodeToFacet(node: TapperNode): TapperFacet;
 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

@@ -1 +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"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAE,UAAU,EAAE,WAAW,EAAC,MAAM,SAAS,CAAA;AAIrE,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEtD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAMtB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,EAC7B,SAAS,CAAC,EAAE,UAAU,EAAE,EACxB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,UAAU,EAAE,CAqJd;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,oBAAoB,GAC3B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOrB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAMzD;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,CAkCpB"}