@bsky.app/tapper 0.2.0 → 0.2.3

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @bsky.app/tapper
+
+## 0.2.3
+
+### Patch Changes
+
+- [`5952994`](https://github.com/bluesky-social/toolbox/commit/59529944ec895f43b30928b078edd5f3868753ae) Thanks [@estrattonbailey](https://github.com/estrattonbailey)! - Adjust tapper facet config
+
+## 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: /@([a-zA-Z0-9._]+)/g,
+      emoji: /:([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: /:([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: /@([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/facets.d.ts

@@ -0,0 +1,5 @@
+export declare const mention: RegExp;
+export declare const emoji: RegExp;
+export declare const tag: RegExp;
+export declare const url: RegExp;
+//# sourceMappingURL=facets.d.ts.map

package/build/facets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facets.d.ts","sourceRoot":"","sources":["../src/facets.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,QAAuB,CAAA;AAC3C,eAAO,MAAM,KAAK,QAAuB,CAAA;AACzC,eAAO,MAAM,GAAG,QACmK,CAAA;AACnL,eAAO,MAAM,GAAG,QAC0D,CAAA"}

package/build/facets.js

@@ -0,0 +1,5 @@
+export const mention = /@([a-zA-Z0-9.-]+)/g;
+export const emoji = /:([a-zA-Z0-9_]+):/g;
+export const tag = /[#＃]((?!\ufe0f)[^\s\u00AD\u2060\u200A\u200B\u200C\u200D\u20e2]*[^\d\s\p{P}\u00AD\u2060\u200A\u200B\u200C\u200D\u20e2]+[^\s\u00AD\u2060\u200A\u200B\u200C\u200D\u20e2\p{P}]*)?/gu;
+export const url = /((https?:\/\/[\S]+)|((?<domain>[a-z][a-z0-9]*(\.[a-z0-9]+)+)[\S]*))/gim;
+//# sourceMappingURL=facets.js.map

package/build/facets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facets.js","sourceRoot":"","sources":["../src/facets.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,oBAAoB,CAAA;AAC3C,MAAM,CAAC,MAAM,KAAK,GAAG,oBAAoB,CAAA;AACzC,MAAM,CAAC,MAAM,GAAG,GACd,iLAAiL,CAAA;AACnL,MAAM,CAAC,MAAM,GAAG,GACd,wEAAwE,CAAA","sourcesContent":["export const mention = /@([a-zA-Z0-9.-]+)/g\nexport const emoji = /:([a-zA-Z0-9_]+):/g\nexport const tag =\n  /[#＃]((?!\\ufe0f)[^\\s\\u00AD\\u2060\\u200A\\u200B\\u200C\\u200D\\u20e2]*[^\\d\\s\\p{P}\\u00AD\\u2060\\u200A\\u200B\\u200C\\u200D\\u20e2]+[^\\s\\u00AD\\u2060\\u200A\\u200B\\u200C\\u200D\\u20e2\\p{P}]*)?/gu\nexport const url =\n  /((https?:\\/\\/[\\S]+)|((?<domain>[a-z][a-z0-9]*(\\.[a-z0-9]+)+)[\\S]*))/gim\n"]}

package/build/index.d.ts

@@ -1,5 +1,6 @@
 import { TapperConfig, TapperEvents, TapperNode, TapperActiveFacet, TapperSnapshot } from './types';
 export * from './types';
+export * from './facets';
 export declare class Tapper {
     private facetRegexes;
     private triggers;
@@ -12,7 +13,7 @@ export declare class Tapper {
     private pendingCursor;
     private storeListeners;
     private snapshot;
-    constructor(config: TapperConfig);
+    constructor(config?: TapperConfig);
     subscribe: (listener: () => void) => () => boolean;
     getSnapshot: () => TapperSnapshot;
     on: <K extends keyof TapperEvents>(event: K, cb: (data: TapperEvents[K]) => void) => () => void;
@@ -28,7 +29,7 @@ export declare class Tapper {
         };
     }) => void;
     replaceText: (text: string, cursor?: number) => void;
-    private commit;
+    private insert;
 }
 export declare function useTapper(config: TapperConfig): {
     on: <K extends keyof TapperEvents>(event: K, cb: (data: TapperEvents[K]) => void) => () => void;

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,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;IAwDd,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;SAlLtC,CAAC,SAAS,MAAM,YAAY,2CAED,IAAI;;;aA0LhB,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"}
+{"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;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,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,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;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,6 +1,8 @@
 import { useRef, useState, useSyncExternalStore } from 'react';
 import { parseNodesFromText, detectActiveFacet, deriveTriggers, nodeToFacet, compileFacetRegexes, } from './util';
+import * as defaultFacets from './facets';
 export * from './types';
+export * from './facets';
 export class Tapper {
     facetRegexes;
     triggers;
@@ -19,15 +21,16 @@ export class Tapper {
     storeListeners = new Set();
     snapshot;
     constructor(config) {
-        this.facetRegexes = compileFacetRegexes(config.facets);
-        this.triggers = deriveTriggers(config.facets);
+        const facets = config?.facets || defaultFacets;
+        this.facetRegexes = compileFacetRegexes(facets);
+        this.triggers = deriveTriggers(facets);
         this.snapshot = {
             text: this.text,
             cursor: this.cursor,
             nodes: this.nodes,
             activeFacet: this.activeFacet,
         };
-        if (config.initialText) {
+        if (config?.initialText) {
             this.replaceText(config.initialText);
         }
     }
@@ -65,15 +68,15 @@ export class Tapper {
         this.updating = true;
         const nodes = newText === this.text
             ? this.nodes
-            : parseNodesFromText(newText, this.facetRegexes, 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 === prev.type &&
-                    node.value === prev.value &&
+                if (node.type === 'facet' &&
+                    node.facetType === prev.type &&
                     node.start === prev.range.start &&
                     node.end === prev.range.end) {
                     node.committed = true;
@@ -84,7 +87,7 @@ export class Tapper {
         }
         // Build activeFacet with commit() baked in
         const active = detected
-            ? { ...detected, commit: this.commit }
+            ? { ...detected, insert: this.insert }
             : null;
         this.text = newText;
         this.cursor = cursor;
@@ -110,7 +113,7 @@ export class Tapper {
         // Atomic deletion: backspace into a facet from outside
         if (diff === -1 && newCursor < this.cursor) {
             for (const node of this.nodes) {
-                if (node.type !== 'text' &&
+                if (node.type === 'facet' &&
                     node.committed &&
                     this.cursor === node.end) {
                     const remnant = node.end - node.start - 1;
@@ -144,7 +147,7 @@ export class Tapper {
         // Mark all non-text nodes as committed (pre-existing facets)
         const newlyCommitted = [];
         for (const node of nodes) {
-            if (node.type !== 'text') {
+            if (node.type === 'facet') {
                 node.committed = true;
                 newlyCommitted.push(node);
             }
@@ -152,7 +155,7 @@ export class Tapper {
         const pos = cursor ?? text.length;
         const detected = detectActiveFacet(nodes, text, pos, this.triggers);
         const active = detected
-            ? { ...detected, commit: this.commit }
+            ? { ...detected, insert: this.insert }
             : null;
         this.text = text;
         this.cursor = pos;
@@ -166,7 +169,7 @@ export class Tapper {
             this.emit('facetCommitted', nodeToFacet(node));
         }
     };
-    commit = (value, options) => {
+    insert = (value, options) => {
         if (!this.activeFacet)
             return;
         const replacement = value + (options?.noTrailingSpace ? '' : ' ');

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  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(newText, this.facetRegexes, 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    let committedNode: TapperNode | null = null\n    if (prev && (!detected || detected.type !== prev.type)) {\n      for (const node of nodes) {\n        if (\n          node.type === prev.type &&\n          node.value === prev.value &&\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, commit: this.commit}\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 !== '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 = (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 !== 'text') {\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, commit: this.commit}\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 commit = (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"]}
+{"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'\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  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    const facets = config?.facets || defaultFacets\n    this.facetRegexes = compileFacetRegexes(facets)\n    this.triggers = deriveTriggers(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

@@ -1,13 +1,28 @@
-export type TapperFacetConfig = {
-    match: RegExp;
-};
-export type TapperFacetConfigMap = Record<string, TapperFacetConfig>;
+export type TapperFacetConfig = Record<string, RegExp>;
 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 = {
     type: string;
@@ -18,7 +33,7 @@ export type TapperFacet = {
     };
 };
 export type TapperActiveFacet = TapperFacet & {
-    commit: (value: string, options?: {
+    insert: (value: string, options?: {
         noTrailingSpace?: boolean;
     }) => void;
 };
@@ -29,7 +44,7 @@ export type TapperSnapshot = {
     activeFacet: TapperActiveFacet | null;
 };
 export type TapperConfig = {
-    facets: TapperFacetConfigMap;
+    facets?: TapperFacetConfig;
     initialText?: string;
 };
 export type TapperEvents = {

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,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEtD,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,CAAC,EAAE,iBAAiB,CAAA;IAC1B,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  type: string\n  value: string\n  range: {start: number; end: number}\n}\n\nexport type TapperActiveFacet = TapperFacet & {\n  commit: (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"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type TapperFacetConfig = Record<string, RegExp>\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?: TapperFacetConfig\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,4 +1,4 @@
-import { TapperFacetConfigMap, TapperNode, TapperFacet } from './types';
+import { TapperFacetConfig, TapperNode, TapperFacet } from './types';
 export type CompiledFacetRegexes = Map<string, RegExp>;
 /**
  * Pre-compile facet regexes once at init time. This avoids re-creating
@@ -6,9 +6,9 @@ export type CompiledFacetRegexes = Map<string, RegExp>;
  * 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[]): TapperNode[];
-export declare function deriveTriggers(config: TapperFacetConfigMap): Map<string, string>;
+export declare function compileFacetRegexes(config: TapperFacetConfig): CompiledFacetRegexes;
+export declare function parseNodesFromText(text: string, regexes: CompiledFacetRegexes, prevNodes?: TapperNode[], cursor?: number, triggers?: Map<string, string>): TapperNode[];
+export declare function deriveTriggers(config: TapperFacetConfig): 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,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,GACvB,UAAU,EAAE,CA2Fd;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,CA2BpB"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAC,MAAM,SAAS,CAAA;AAIlE,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEtD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GACxB,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,CAAC,MAAM,EAAE,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7E;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"}

package/build/util.js

@@ -7,12 +7,12 @@ const WHITESPACE = /\s/;
  */
 export function compileFacetRegexes(config) {
     const compiled = new Map();
-    for (const [name, def] of Object.entries(config)) {
-        compiled.set(name, new RegExp(def.match.source, def.match.flags));
+    for (const [name, re] of Object.entries(config)) {
+        compiled.set(name, new RegExp(re.source, re.flags));
     }
     return compiled;
 }
-export function parseNodesFromText(text, regexes, prevNodes) {
+export function parseNodesFromText(text, regexes, prevNodes, cursor, triggers) {
     const allMatches = [];
     for (const [name, re] of regexes) {
         // Reset lastIndex so stateful (global) regexes don't carry over
@@ -22,7 +22,7 @@ export function parseNodesFromText(text, regexes, prevNodes) {
             allMatches.push({
                 facetName: name,
                 fullMatch: m[0],
-                capture: m[0],
+                capture: m[1] ?? m[0],
                 index: m.index,
             });
         }
@@ -37,52 +37,108 @@ export function parseNodesFromText(text, regexes, prevNodes) {
         }
     }
     const nodes = [];
-    let cursor = 0;
+    let pos = 0;
     for (const m of accepted) {
-        if (m.index > cursor) {
+        if (m.index > pos) {
+            const raw = text.slice(pos, m.index);
             nodes.push({
                 type: 'text',
-                value: text.slice(cursor, m.index),
-                start: cursor,
+                raw,
+                value: raw,
+                start: pos,
                 end: m.index,
             });
         }
         nodes.push({
-            type: m.facetName,
+            type: 'facet',
+            facetType: m.facetName,
+            raw: m.fullMatch,
             value: m.capture,
             start: m.index,
             end: m.index + m.fullMatch.length,
         });
-        cursor = m.index + m.fullMatch.length;
+        pos = m.index + m.fullMatch.length;
     }
-    if (cursor < text.length) {
+    if (pos < text.length) {
+        const raw = text.slice(pos);
         nodes.push({
             type: 'text',
-            value: text.slice(cursor),
-            start: cursor,
+            raw,
+            value: raw,
+            start: pos,
             end: text.length,
         });
     }
-    // Transfer committed flags from previous nodes by type + occurrence index
+    // If the cursor is right after a trigger char that the regex didn't match,
+    // splice a 'trigger' node out of the containing text node.
+    if (cursor != null && triggers) {
+        for (let i = cursor - 1; i >= 0; i--) {
+            const ch = text[i];
+            if (WHITESPACE.test(ch))
+                break;
+            const facetType = triggers.get(ch);
+            if (facetType) {
+                // Only create a trigger node if the trigger is inside a text node
+                // (i.e. the regex didn't already match it as a facet)
+                const textNodeIdx = nodes.findIndex(n => n.type === 'text' && n.start <= i && n.end > i);
+                if (textNodeIdx !== -1) {
+                    const node = nodes[textNodeIdx];
+                    const spliced = [];
+                    if (node.start < i) {
+                        const raw = text.slice(node.start, i);
+                        spliced.push({
+                            type: 'text',
+                            raw,
+                            value: raw,
+                            start: node.start,
+                            end: i,
+                        });
+                    }
+                    const triggerRaw = text.slice(i, cursor);
+                    spliced.push({
+                        type: 'trigger',
+                        facetType,
+                        raw: triggerRaw,
+                        value: text.slice(i + ch.length, cursor),
+                        start: i,
+                        end: cursor,
+                    });
+                    if (cursor < node.end) {
+                        const raw = text.slice(cursor, node.end);
+                        spliced.push({
+                            type: 'text',
+                            raw,
+                            value: raw,
+                            start: cursor,
+                            end: node.end,
+                        });
+                    }
+                    nodes.splice(textNodeIdx, 1, ...spliced);
+                }
+                break;
+            }
+        }
+    }
+    // Transfer committed flags from previous nodes by facetType + occurrence index
     if (prevNodes) {
         const counts = new Map();
         const committedByTypeIndex = new Set();
         for (const node of prevNodes) {
-            if (node.type === 'text')
+            if (node.type !== 'facet')
                 continue;
-            const idx = counts.get(node.type) ?? 0;
-            counts.set(node.type, idx + 1);
+            const idx = counts.get(node.facetType) ?? 0;
+            counts.set(node.facetType, idx + 1);
             if (node.committed) {
-                committedByTypeIndex.add(`${node.type}:${idx}`);
+                committedByTypeIndex.add(`${node.facetType}:${idx}`);
             }
         }
         counts.clear();
         for (const node of nodes) {
-            if (node.type === 'text')
+            if (node.type !== 'facet')
                 continue;
-            const idx = counts.get(node.type) ?? 0;
-            counts.set(node.type, idx + 1);
-            if (committedByTypeIndex.has(`${node.type}:${idx}`)) {
+            const idx = counts.get(node.facetType) ?? 0;
+            counts.set(node.facetType, idx + 1);
+            if (committedByTypeIndex.has(`${node.facetType}:${idx}`)) {
                 node.committed = true;
             }
         }
@@ -91,8 +147,8 @@ export function parseNodesFromText(text, regexes, prevNodes) {
 }
 export function deriveTriggers(config) {
     const triggers = new Map();
-    for (const [name, def] of Object.entries(config)) {
-        const m = def.match.source.match(/^[^\\([\]{}.*+?^$|]+/);
+    for (const [name, re] of Object.entries(config)) {
+        const m = re.source.match(/^[^\\([\]{}.*+?^$|]+/);
         if (m)
             triggers.set(m[0], name);
     }
@@ -100,16 +156,23 @@ export function deriveTriggers(config) {
 }
 export function nodeToFacet(node) {
     return {
-        type: node.type,
+        type: node.facetType,
         value: node.value,
         range: { start: node.start, end: node.end },
     };
 }
 export function detectActiveFacet(nodes, text, cursor, triggers) {
     for (const node of nodes) {
-        if (node.type !== 'text' && node.start < cursor && cursor <= node.end) {
+        if (node.type === 'trigger' && node.start < cursor && cursor <= node.end) {
+            return {
+                type: node.facetType,
+                value: node.value,
+                range: { start: node.start, end: node.end },
+            };
+        }
+        if (node.type === 'facet' && node.start < cursor && cursor <= node.end) {
             return {
-                type: node.type,
+                type: node.facetType,
                 value: node.value,
                 range: { start: node.start, end: node.end },
             };

package/build/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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","sourcesContent":["import {TapperFacetConfigMap, TapperNode, TapperFacet} from './types'\n\nconst WHITESPACE = /\\s/\n\nexport type CompiledFacetRegexes = Map<string, RegExp>\n\n/**\n * Pre-compile facet regexes once at init time. This avoids re-creating\n * RegExp objects on every keystroke in parseNodesFromText. Each Tapper\n * instance gets its own compiled copy so lastIndex state can't leak\n * between instances.\n */\nexport function compileFacetRegexes(\n  config: TapperFacetConfigMap,\n): CompiledFacetRegexes {\n  const compiled = new Map<string, RegExp>()\n  for (const [name, def] of Object.entries(config)) {\n    compiled.set(name, new RegExp(def.match.source, def.match.flags))\n  }\n  return compiled\n}\n\nexport function parseNodesFromText(\n  text: string,\n  regexes: CompiledFacetRegexes,\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, re] of regexes) {\n    // Reset lastIndex so stateful (global) regexes don't carry over\n    // match positions from the previous parse call.\n    re.lastIndex = 0\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(\n  config: TapperFacetConfigMap,\n): 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 nodeToFacet(node: TapperNode): TapperFacet {\n  return {\n    type: node.type,\n    value: node.value,\n    range: {start: node.start, end: node.end},\n  }\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        type: node.type,\n        value: 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 (WHITESPACE.test(ch)) break\n    const type = triggers.get(ch)\n    if (type) {\n      return {\n        type,\n        value: text.slice(i + 1, cursor),\n        range: {start: i, end: cursor},\n      }\n    }\n  }\n\n  return null\n}\n"]}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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","sourcesContent":["import {TapperFacetConfig, TapperNode, TapperFacet} from './types'\n\nconst WHITESPACE = /\\s/\n\nexport type CompiledFacetRegexes = Map<string, RegExp>\n\n/**\n * Pre-compile facet regexes once at init time. This avoids re-creating\n * RegExp objects on every keystroke in parseNodesFromText. Each Tapper\n * instance gets its own compiled copy so lastIndex state can't leak\n * between instances.\n */\nexport function compileFacetRegexes(\n  config: TapperFacetConfig,\n): CompiledFacetRegexes {\n  const compiled = new Map<string, RegExp>()\n  for (const [name, re] of Object.entries(config)) {\n    compiled.set(name, new RegExp(re.source, re.flags))\n  }\n  return compiled\n}\n\nexport function parseNodesFromText(\n  text: string,\n  regexes: CompiledFacetRegexes,\n  prevNodes?: TapperNode[],\n  cursor?: number,\n  triggers?: Map<string, string>,\n): TapperNode[] {\n  const allMatches: {\n    facetName: string\n    fullMatch: string\n    capture: string\n    index: number\n  }[] = []\n\n  for (const [name, re] of regexes) {\n    // Reset lastIndex so stateful (global) regexes don't carry over\n    // match positions from the previous parse call.\n    re.lastIndex = 0\n    for (const m of text.matchAll(re)) {\n      allMatches.push({\n        facetName: name,\n        fullMatch: m[0],\n        capture: m[1] ?? 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 pos = 0\n\n  for (const m of accepted) {\n    if (m.index > pos) {\n      const raw = text.slice(pos, m.index)\n      nodes.push({\n        type: 'text',\n        raw,\n        value: raw,\n        start: pos,\n        end: m.index,\n      })\n    }\n    nodes.push({\n      type: 'facet',\n      facetType: m.facetName,\n      raw: m.fullMatch,\n      value: m.capture,\n      start: m.index,\n      end: m.index + m.fullMatch.length,\n    })\n    pos = m.index + m.fullMatch.length\n  }\n\n  if (pos < text.length) {\n    const raw = text.slice(pos)\n    nodes.push({\n      type: 'text',\n      raw,\n      value: raw,\n      start: pos,\n      end: text.length,\n    })\n  }\n\n  // If the cursor is right after a trigger char that the regex didn't match,\n  // splice a 'trigger' node out of the containing text node.\n  if (cursor != null && triggers) {\n    for (let i = cursor - 1; i >= 0; i--) {\n      const ch = text[i]\n      if (WHITESPACE.test(ch)) break\n      const facetType = triggers.get(ch)\n      if (facetType) {\n        // Only create a trigger node if the trigger is inside a text node\n        // (i.e. the regex didn't already match it as a facet)\n        const textNodeIdx = nodes.findIndex(\n          n => n.type === 'text' && n.start <= i && n.end > i,\n        )\n        if (textNodeIdx !== -1) {\n          const node = nodes[textNodeIdx]\n          const spliced: TapperNode[] = []\n          if (node.start < i) {\n            const raw = text.slice(node.start, i)\n            spliced.push({\n              type: 'text',\n              raw,\n              value: raw,\n              start: node.start,\n              end: i,\n            })\n          }\n          const triggerRaw = text.slice(i, cursor)\n          spliced.push({\n            type: 'trigger',\n            facetType,\n            raw: triggerRaw,\n            value: text.slice(i + ch.length, cursor),\n            start: i,\n            end: cursor,\n          })\n          if (cursor < node.end) {\n            const raw = text.slice(cursor, node.end)\n            spliced.push({\n              type: 'text',\n              raw,\n              value: raw,\n              start: cursor,\n              end: node.end,\n            })\n          }\n          nodes.splice(textNodeIdx, 1, ...spliced)\n        }\n        break\n      }\n    }\n  }\n\n  // Transfer committed flags from previous nodes by facetType + 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 !== 'facet') continue\n      const idx = counts.get(node.facetType!) ?? 0\n      counts.set(node.facetType!, idx + 1)\n      if (node.committed) {\n        committedByTypeIndex.add(`${node.facetType}:${idx}`)\n      }\n    }\n\n    counts.clear()\n    for (const node of nodes) {\n      if (node.type !== 'facet') continue\n      const idx = counts.get(node.facetType!) ?? 0\n      counts.set(node.facetType!, idx + 1)\n      if (committedByTypeIndex.has(`${node.facetType}:${idx}`)) {\n        node.committed = true\n      }\n    }\n  }\n\n  return nodes\n}\n\nexport function deriveTriggers(config: TapperFacetConfig): Map<string, string> {\n  const triggers = new Map<string, string>()\n  for (const [name, re] of Object.entries(config)) {\n    const m = re.source.match(/^[^\\\\([\\]{}.*+?^$|]+/)\n    if (m) triggers.set(m[0], name)\n  }\n  return triggers\n}\n\nexport function nodeToFacet(node: TapperNode): TapperFacet {\n  return {\n    type: node.facetType!,\n    value: node.value,\n    range: {start: node.start, end: node.end},\n  }\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 === 'trigger' && node.start < cursor && cursor <= node.end) {\n      return {\n        type: node.facetType,\n        value: node.value,\n        range: {start: node.start, end: node.end},\n      }\n    }\n    if (node.type === 'facet' && node.start < cursor && cursor <= node.end) {\n      return {\n        type: node.facetType,\n        value: 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 (WHITESPACE.test(ch)) break\n    const type = triggers.get(ch)\n    if (type) {\n      return {\n        type,\n        value: text.slice(i + 1, cursor),\n        range: {start: i, end: cursor},\n      }\n    }\n  }\n\n  return null\n}\n"]}

package/package.json

@@ -1,28 +1,19 @@
 {
   "name": "@bsky.app/tapper",
-  "version": "0.2.0",
+  "version": "0.2.3",
+  "license": "MIT",
   "description": "A minimal rich text editor for React Native and web.",
+  "repository": "https://github.com/bluesky-social/toolbox",
+  "author": "Eric Bailey <git@esb.lol> (https://github.com/estrattonbailey)",
+  "homepage": "https://github.com/bluesky-social/toolbox/tree/main/packages/tapper",
   "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"
   ],
-  "author": "Bluesky Social, PBLLC",
-  "license": "MIT",
   "dependencies": {},
   "devDependencies": {
     "@types/react": "~19.1.1",
@@ -35,5 +26,14 @@
     "expo": "*",
     "react": "*",
     "react-native": "*"
+  },
+  "scripts": {
+    "build": "expo-module build",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "vitest run",
+    "expo-module": "expo-module",
+    "open:ios": "xed example/ios",
+    "open:android": "open -a \"Android Studio\" example/android"
   }
-}
+}

package/src/facets.ts

@@ -0,0 +1,6 @@
+export const mention = /@([a-zA-Z0-9.-]+)/g
+export const emoji = /:([a-zA-Z0-9_]+):/g
+export const tag =
+  /[#＃]((?!\ufe0f)[^\s\u00AD\u2060\u200A\u200B\u200C\u200D\u20e2]*[^\d\s\p{P}\u00AD\u2060\u200A\u200B\u200C\u200D\u20e2]+[^\s\u00AD\u2060\u200A\u200B\u200C\u200D\u20e2\p{P}]*)?/gu
+export const url =
+  /((https?:\/\/[\S]+)|((?<domain>[a-z][a-z0-9]*(\.[a-z0-9]+)+)[\S]*))/gim

package/src/index.ts

@@ -15,8 +15,10 @@ import {
   compileFacetRegexes,
   type CompiledFacetRegexes,
 } from './util'
+import * as defaultFacets from './facets'
 
 export * from './types'
+export * from './facets'
 
 export class Tapper {
   private facetRegexes: CompiledFacetRegexes
@@ -40,16 +42,17 @@ export class Tapper {
   private storeListeners = new Set<() => void>()
   private snapshot: TapperSnapshot
 
-  constructor(config: TapperConfig) {
-    this.facetRegexes = compileFacetRegexes(config.facets)
-    this.triggers = deriveTriggers(config.facets)
+  constructor(config?: TapperConfig) {
+    const facets = config?.facets || defaultFacets
+    this.facetRegexes = compileFacetRegexes(facets)
+    this.triggers = deriveTriggers(facets)
     this.snapshot = {
       text: this.text,
       cursor: this.cursor,
       nodes: this.nodes,
       activeFacet: this.activeFacet,
     }
-    if (config.initialText) {
+    if (config?.initialText) {
       this.replaceText(config.initialText)
     }
   }
@@ -96,7 +99,13 @@ export class Tapper {
     const nodes =
       newText === this.text
         ? this.nodes
-        : parseNodesFromText(newText, this.facetRegexes, this.nodes)
+        : parseNodesFromText(
+            newText,
+            this.facetRegexes,
+            this.nodes,
+            cursor,
+            this.triggers,
+          )
     const prev = this.activeFacet
     const detected = detectActiveFacet(nodes, newText, cursor, this.triggers)
 
@@ -105,8 +114,8 @@ export class Tapper {
     if (prev && (!detected || detected.type !== prev.type)) {
       for (const node of nodes) {
         if (
-          node.type === prev.type &&
-          node.value === prev.value &&
+          node.type === 'facet' &&
+          node.facetType === prev.type &&
           node.start === prev.range.start &&
           node.end === prev.range.end
         ) {
@@ -119,7 +128,7 @@ export class Tapper {
 
     // Build activeFacet with commit() baked in
     const active: TapperActiveFacet | null = detected
-      ? {...detected, commit: this.commit}
+      ? {...detected, insert: this.insert}
       : null
 
     this.text = newText
@@ -152,7 +161,7 @@ export class Tapper {
     if (diff === -1 && newCursor < this.cursor) {
       for (const node of this.nodes) {
         if (
-          node.type !== 'text' &&
+          node.type === 'facet' &&
           node.committed &&
           this.cursor === node.end
         ) {
@@ -191,7 +200,7 @@ export class Tapper {
     // Mark all non-text nodes as committed (pre-existing facets)
     const newlyCommitted: TapperNode[] = []
     for (const node of nodes) {
-      if (node.type !== 'text') {
+      if (node.type === 'facet') {
         node.committed = true
         newlyCommitted.push(node)
       }
@@ -200,7 +209,7 @@ export class Tapper {
     const pos = cursor ?? text.length
     const detected = detectActiveFacet(nodes, text, pos, this.triggers)
     const active: TapperActiveFacet | null = detected
-      ? {...detected, commit: this.commit}
+      ? {...detected, insert: this.insert}
       : null
 
     this.text = text
@@ -218,7 +227,7 @@ export class Tapper {
     }
   }
 
-  private commit = (value: string, options?: {noTrailingSpace?: boolean}) => {
+  private insert = (value: string, options?: {noTrailingSpace?: boolean}) => {
     if (!this.activeFacet) return
 
     const replacement = value + (options?.noTrailingSpace ? '' : ' ')

package/src/types.ts

@@ -1,16 +1,33 @@
-export type TapperFacetConfig = {
-  match: RegExp
-}
-
-export type TapperFacetConfigMap = Record<string, TapperFacetConfig>
+export type TapperFacetConfig = Record<string, RegExp>
 
-export type TapperNode = {
-  type: string
-  value: string
-  start: number
-  end: number
-  committed?: boolean
-}
+export type TapperNode =
+  | {
+      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 = {
   type: string
@@ -19,7 +36,7 @@ export type TapperFacet = {
 }
 
 export type TapperActiveFacet = TapperFacet & {
-  commit: (value: string, options?: {noTrailingSpace?: boolean}) => void
+  insert: (value: string, options?: {noTrailingSpace?: boolean}) => void
 }
 
 export type TapperSnapshot = {
@@ -30,7 +47,7 @@ export type TapperSnapshot = {
 }
 
 export type TapperConfig = {
-  facets: TapperFacetConfigMap
+  facets?: TapperFacetConfig
   initialText?: string
 }
 

package/src/util.ts

@@ -1,4 +1,4 @@
-import {TapperFacetConfigMap, TapperNode, TapperFacet} from './types'
+import {TapperFacetConfig, TapperNode, TapperFacet} from './types'
 
 const WHITESPACE = /\s/
 
@@ -11,11 +11,11 @@ export type CompiledFacetRegexes = Map<string, RegExp>
  * between instances.
  */
 export function compileFacetRegexes(
-  config: TapperFacetConfigMap,
+  config: TapperFacetConfig,
 ): CompiledFacetRegexes {
   const compiled = new Map<string, RegExp>()
-  for (const [name, def] of Object.entries(config)) {
-    compiled.set(name, new RegExp(def.match.source, def.match.flags))
+  for (const [name, re] of Object.entries(config)) {
+    compiled.set(name, new RegExp(re.source, re.flags))
   }
   return compiled
 }
@@ -24,6 +24,8 @@ export function parseNodesFromText(
   text: string,
   regexes: CompiledFacetRegexes,
   prevNodes?: TapperNode[],
+  cursor?: number,
+  triggers?: Map<string, string>,
 ): TapperNode[] {
   const allMatches: {
     facetName: string
@@ -40,7 +42,7 @@ export function parseNodesFromText(
       allMatches.push({
         facetName: name,
         fullMatch: m[0],
-        capture: m[0],
+        capture: m[1] ?? m[0],
         index: m.index,
       })
     }
@@ -60,55 +62,113 @@ export function parseNodesFromText(
   }
 
   const nodes: TapperNode[] = []
-  let cursor = 0
+  let pos = 0
 
   for (const m of accepted) {
-    if (m.index > cursor) {
+    if (m.index > pos) {
+      const raw = text.slice(pos, m.index)
       nodes.push({
         type: 'text',
-        value: text.slice(cursor, m.index),
-        start: cursor,
+        raw,
+        value: raw,
+        start: pos,
         end: m.index,
       })
     }
     nodes.push({
-      type: m.facetName,
+      type: 'facet',
+      facetType: m.facetName,
+      raw: m.fullMatch,
       value: m.capture,
       start: m.index,
       end: m.index + m.fullMatch.length,
     })
-    cursor = m.index + m.fullMatch.length
+    pos = m.index + m.fullMatch.length
   }
 
-  if (cursor < text.length) {
+  if (pos < text.length) {
+    const raw = text.slice(pos)
     nodes.push({
       type: 'text',
-      value: text.slice(cursor),
-      start: cursor,
+      raw,
+      value: raw,
+      start: pos,
       end: text.length,
     })
   }
 
-  // Transfer committed flags from previous nodes by type + occurrence index
+  // If the cursor is right after a trigger char that the regex didn't match,
+  // splice a 'trigger' node out of the containing text node.
+  if (cursor != null && triggers) {
+    for (let i = cursor - 1; i >= 0; i--) {
+      const ch = text[i]
+      if (WHITESPACE.test(ch)) break
+      const facetType = triggers.get(ch)
+      if (facetType) {
+        // Only create a trigger node if the trigger is inside a text node
+        // (i.e. the regex didn't already match it as a facet)
+        const textNodeIdx = nodes.findIndex(
+          n => n.type === 'text' && n.start <= i && n.end > i,
+        )
+        if (textNodeIdx !== -1) {
+          const node = nodes[textNodeIdx]
+          const spliced: TapperNode[] = []
+          if (node.start < i) {
+            const raw = text.slice(node.start, i)
+            spliced.push({
+              type: 'text',
+              raw,
+              value: raw,
+              start: node.start,
+              end: i,
+            })
+          }
+          const triggerRaw = text.slice(i, cursor)
+          spliced.push({
+            type: 'trigger',
+            facetType,
+            raw: triggerRaw,
+            value: text.slice(i + ch.length, cursor),
+            start: i,
+            end: cursor,
+          })
+          if (cursor < node.end) {
+            const raw = text.slice(cursor, node.end)
+            spliced.push({
+              type: 'text',
+              raw,
+              value: raw,
+              start: cursor,
+              end: node.end,
+            })
+          }
+          nodes.splice(textNodeIdx, 1, ...spliced)
+        }
+        break
+      }
+    }
+  }
+
+  // Transfer committed flags from previous nodes by facetType + 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.type !== 'facet') continue
+      const idx = counts.get(node.facetType!) ?? 0
+      counts.set(node.facetType!, idx + 1)
       if (node.committed) {
-        committedByTypeIndex.add(`${node.type}:${idx}`)
+        committedByTypeIndex.add(`${node.facetType}:${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}`)) {
+      if (node.type !== 'facet') continue
+      const idx = counts.get(node.facetType!) ?? 0
+      counts.set(node.facetType!, idx + 1)
+      if (committedByTypeIndex.has(`${node.facetType}:${idx}`)) {
         node.committed = true
       }
     }
@@ -117,12 +177,10 @@ export function parseNodesFromText(
   return nodes
 }
 
-export function deriveTriggers(
-  config: TapperFacetConfigMap,
-): Map<string, string> {
+export function deriveTriggers(config: TapperFacetConfig): Map<string, string> {
   const triggers = new Map<string, string>()
-  for (const [name, def] of Object.entries(config)) {
-    const m = def.match.source.match(/^[^\\([\]{}.*+?^$|]+/)
+  for (const [name, re] of Object.entries(config)) {
+    const m = re.source.match(/^[^\\([\]{}.*+?^$|]+/)
     if (m) triggers.set(m[0], name)
   }
   return triggers
@@ -130,7 +188,7 @@ export function deriveTriggers(
 
 export function nodeToFacet(node: TapperNode): TapperFacet {
   return {
-    type: node.type,
+    type: node.facetType!,
     value: node.value,
     range: {start: node.start, end: node.end},
   }
@@ -143,9 +201,16 @@ export function detectActiveFacet(
   triggers: Map<string, string>,
 ): TapperFacet | null {
   for (const node of nodes) {
-    if (node.type !== 'text' && node.start < cursor && cursor <= node.end) {
+    if (node.type === 'trigger' && node.start < cursor && cursor <= node.end) {
+      return {
+        type: node.facetType,
+        value: node.value,
+        range: {start: node.start, end: node.end},
+      }
+    }
+    if (node.type === 'facet' && node.start < cursor && cursor <= node.end) {
       return {
-        type: node.type,
+        type: node.facetType,
         value: node.value,
         range: {start: node.start, end: node.end},
       }