@bsky.app/tapper 0.1.1 → 0.2.0

package/src/index.ts

@@ -1,20 +1,261 @@
-import {useTapperCore} from './core'
-import {type TapperConfig} from './types'
+import {useRef, useState, useSyncExternalStore} from 'react'
+
+import {
+  TapperConfig,
+  TapperEvents,
+  TapperNode,
+  TapperActiveFacet,
+  TapperSnapshot,
+} from './types'
+import {
+  parseNodesFromText,
+  detectActiveFacet,
+  deriveTriggers,
+  nodeToFacet,
+  compileFacetRegexes,
+  type CompiledFacetRegexes,
+} from './util'
 
 export * from './types'
-export * from './core'
+
+export class Tapper {
+  private facetRegexes: CompiledFacetRegexes
+  private triggers: Map<string, string>
+
+  // Event emitters
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private listeners = new Map<keyof TapperEvents, Set<(data: any) => void>>()
+
+  // Public state
+  text = ''
+  cursor = 0
+  nodes: TapperNode[] = []
+  activeFacet: TapperActiveFacet | null = null
+
+  // Internal tracking
+  private updating = false
+  private pendingCursor: number | null = null
+
+  // useSyncExternalStore plumbing
+  private storeListeners = new Set<() => void>()
+  private snapshot: TapperSnapshot
+
+  constructor(config: TapperConfig) {
+    this.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: () => void) => {
+    this.storeListeners.add(listener)
+    return () => this.storeListeners.delete(listener)
+  }
+
+  getSnapshot = (): TapperSnapshot => {
+    return this.snapshot
+  }
+
+  on = <K extends keyof TapperEvents>(
+    event: K,
+    cb: (data: TapperEvents[K]) => void,
+  ) => {
+    if (!this.listeners.has(event)) this.listeners.set(event, new Set())
+    this.listeners.get(event)!.add(cb)
+    return () => {
+      this.listeners.get(event)?.delete(cb)
+    }
+  }
+
+  private emit<K extends keyof TapperEvents>(event: K, data: TapperEvents[K]) {
+    this.listeners.get(event)?.forEach(cb => cb(data))
+  }
+
+  private notify() {
+    this.snapshot = {
+      text: this.text,
+      cursor: this.cursor,
+      nodes: this.nodes,
+      activeFacet: this.activeFacet,
+    }
+    this.storeListeners.forEach(l => l())
+  }
+
+  private update(newText: string, cursor: number) {
+    // guard against circular updates when 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)
+    const prev = this.activeFacet
+    const detected = detectActiveFacet(nodes, newText, cursor, this.triggers)
+
+    // When cursor leaves a facet, commit it
+    let committedNode: TapperNode | null = null
+    if (prev && (!detected || detected.type !== prev.type)) {
+      for (const node of nodes) {
+        if (
+          node.type === prev.type &&
+          node.value === prev.value &&
+          node.start === prev.range.start &&
+          node.end === prev.range.end
+        ) {
+          node.committed = true
+          committedNode = node
+          break
+        }
+      }
+    }
+
+    // Build activeFacet with commit() baked in
+    const active: TapperActiveFacet | null = detected
+      ? {...detected, commit: this.commit}
+      : 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: string) => {
+    const diff = newText.length - this.text.length
+    let newCursor = Math.max(this.cursor + diff, 0)
+
+    // Atomic deletion: backspace into a facet from outside
+    if (diff === -1 && newCursor < this.cursor) {
+      for (const node of this.nodes) {
+        if (
+          node.type !== 'text' &&
+          node.committed &&
+          this.cursor === node.end
+        ) {
+          const remnant = node.end - node.start - 1
+          newText =
+            newText.slice(0, node.start) + newText.slice(node.start + remnant)
+          newCursor = node.start
+          this.pendingCursor = newCursor
+          break
+        }
+      }
+    }
+
+    this.update(newText, newCursor)
+  }
+
+  handleSelectionChange = (e: {nativeEvent: {selection: {start: number}}}) => {
+    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: string, cursor?: number) => {
+    const prevActive = this.activeFacet
+    const nodes = parseNodesFromText(text, this.facetRegexes)
+    // Mark all non-text nodes as committed (pre-existing facets)
+    const newlyCommitted: TapperNode[] = []
+    for (const node of nodes) {
+      if (node.type !== 'text') {
+        node.committed = true
+        newlyCommitted.push(node)
+      }
+    }
+
+    const pos = cursor ?? text.length
+    const detected = detectActiveFacet(nodes, text, pos, this.triggers)
+    const active: TapperActiveFacet | null = detected
+      ? {...detected, commit: this.commit}
+      : 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))
+    }
+  }
+
+  private commit = (value: string, options?: {noTrailingSpace?: boolean}) => {
+    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: TapperConfig) {
-  const tapper = useTapperCore(config)
+  const [store] = useState(() => new Tapper(config))
+  const state = useSyncExternalStore(store.subscribe, store.getSnapshot)
+  const inputRef = useRef<{focus(): void}>(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: {nativeEvent: {selection: {start: number}}}) =>
-        tapper.store.handleSelectionChange(e.nativeEvent.selection.start),
+      ref: inputRef as React.RefObject<any>,
+      value: state.text,
+      selection: {start: state.cursor, end: state.cursor},
+      onChangeText: store.handleTextChange,
+      onSelectionChange: store.handleSelectionChange,
     },
   }
 }

package/src/types.ts

@@ -13,13 +13,13 @@ export type TapperNode = {
 }
 
 export type TapperFacet = {
-  facetType: string
-  query: string
+  type: string
+  value: string
   range: {start: number; end: number}
 }
 
 export type TapperActiveFacet = TapperFacet & {
-  insert: (value: string, options?: {noTrailingSpace?: boolean}) => void
+  commit: (value: string, options?: {noTrailingSpace?: boolean}) => void
 }
 
 export type TapperSnapshot = {
@@ -33,3 +33,9 @@ export type TapperConfig = {
   facets: TapperFacetConfigMap
   initialText?: string
 }
+
+export type TapperEvents = {
+  activeFacet: TapperActiveFacet | null
+  facetCommitted: TapperFacet
+  afterInsert: TapperFacet
+}

package/src/util.ts

@@ -1,12 +1,28 @@
-import {
-  TapperFacetConfigMap,
-  TapperNode,
-  TapperFacet,
-} from './types'
+import {TapperFacetConfigMap, TapperNode, TapperFacet} from './types'
+
+const WHITESPACE = /\s/
+
+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 function compileFacetRegexes(
+  config: TapperFacetConfigMap,
+): 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))
+  }
+  return compiled
+}
 
 export function parseNodesFromText(
   text: string,
-  config: TapperFacetConfigMap,
+  regexes: CompiledFacetRegexes,
   prevNodes?: TapperNode[],
 ): TapperNode[] {
   const allMatches: {
@@ -16,8 +32,10 @@ export function parseNodesFromText(
     index: number
   }[] = []
 
-  for (const [name, def] of Object.entries(config)) {
-    const re = new RegExp(def.match.source, def.match.flags)
+  for (const [name, re] of regexes) {
+    // Reset lastIndex so stateful (global) regexes don't carry over
+    // match positions from the previous parse call.
+    re.lastIndex = 0
     for (const m of text.matchAll(re)) {
       allMatches.push({
         facetName: name,
@@ -99,7 +117,9 @@ export function parseNodesFromText(
   return nodes
 }
 
-export function deriveTriggers(config: TapperFacetConfigMap): Map<string, string> {
+export function deriveTriggers(
+  config: TapperFacetConfigMap,
+): Map<string, string> {
   const triggers = new Map<string, string>()
   for (const [name, def] of Object.entries(config)) {
     const m = def.match.source.match(/^[^\\([\]{}.*+?^$|]+/)
@@ -108,6 +128,14 @@ export function deriveTriggers(config: TapperFacetConfigMap): Map<string, string
   return triggers
 }
 
+export function nodeToFacet(node: TapperNode): TapperFacet {
+  return {
+    type: node.type,
+    value: node.value,
+    range: {start: node.start, end: node.end},
+  }
+}
+
 export function detectActiveFacet(
   nodes: TapperNode[],
   text: string,
@@ -117,8 +145,8 @@ export function detectActiveFacet(
   for (const node of nodes) {
     if (node.type !== 'text' && node.start < cursor && cursor <= node.end) {
       return {
-        facetType: node.type,
-        query: node.value,
+        type: node.type,
+        value: node.value,
         range: {start: node.start, end: node.end},
       }
     }
@@ -128,12 +156,12 @@ export function detectActiveFacet(
   for (let i = cursor - 1; i >= 0; i--) {
     const ch = text[i]
     // Stop at whitespace — triggers don't span across words
-    if (/\s/.test(ch)) break
-    const facetType = triggers.get(ch)
-    if (facetType) {
+    if (WHITESPACE.test(ch)) break
+    const type = triggers.get(ch)
+    if (type) {
       return {
-        facetType,
-        query: text.slice(i + 1, cursor),
+        type,
+        value: text.slice(i + 1, cursor),
         range: {start: i, end: cursor},
       }
     }

package/build/core.d.ts

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

package/build/core.d.ts.map

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

package/build/core.js

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

package/build/core.js.map

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

package/build/index.web.d.ts

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

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

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

package/build/index.web.js

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

package/build/index.web.js.map

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