Editor Helpers

function getFirstMatchingToken(
  tokens: Token[],
  query: string
): Token | null

import { getFirstMatchingToken } from 'paragrafs';

const tokens = [
  { start: 0, end: 1, text: 'the' },
  { start: 1, end: 2, text: 'quick' },
  { start: 2, end: 3, text: 'brown' },
  { start: 3, end: 4, text: 'fox' },
];

// Single word query
const result1 = getFirstMatchingToken(tokens, 'brown');
console.log(result1);
// { start: 2, end: 3, text: 'brown' }

// Multi-word query
const result2 = getFirstMatchingToken(tokens, 'quick brown');
console.log(result2);
// { start: 1, end: 2, text: 'quick' }  // Returns the first token of the match

// No match
const result3 = getFirstMatchingToken(tokens, 'lazy dog');
console.log(result3);
// null

function getFirstTokenForSelection(
  segment: Segment,
  selectionStart: number,
  selectionEnd: number
): Token | null

import { getFirstTokenForSelection } from 'paragrafs';

const segment = {
  text: 'the fox and the rabbit',
  start: 0,
  end: 6,
  tokens: [
    { start: 0, end: 1, text: 'the' },
    { start: 2, end: 3, text: 'fox' },
    { start: 3, end: 4, text: 'and' },
    { start: 4, end: 5, text: 'the' },
    { start: 5, end: 6, text: 'rabbit' },
  ],
};

// User selects the second "the" in an input field
// "the fox and the rabbit"
//              ^^^
// Character positions 12-15 (exclusive end)
const token = getFirstTokenForSelection(segment, 12, 15);
console.log(token);
// { start: 4, end: 5, text: 'the' }

// Select "rabbit"
// "the fox and the rabbit"
//                  ^^^^^^
// Character positions 16-22
const rabbitToken = getFirstTokenForSelection(segment, 16, 22);
console.log(rabbitToken);
// { start: 5, end: 6, text: 'rabbit' }