PhraseTrie

Defined in: packages/engine/src/normalizer/PhraseTrie.ts:98

Word-level trie for single-pass multi-word phrase matching.

Example

const trie = new PhraseTrie();
trie.addPhrase("to the power of", "CARET");
trie.addPhrase("power of", "CARET");
trie.addPhrase("abyssal whip", "ITEM");

// At position 0 with tokens ["to","the","power","of","3"]
const match = trie.matchAt(tokens, 0);
// → { consumed: 4, replacement: [CARET("to the power of")] }

Constructors

Constructor

new PhraseTrie(): PhraseTrie;

Returns

PhraseTrie

Accessors

size

Get Signature

get size(): number;

Defined in: packages/engine/src/normalizer/PhraseTrie.ts:246

Number of unique first words (not total phrases).

Returns

number

Methods

addPhrase()

addPhrase(phrase, tokenType): void;

Defined in: packages/engine/src/normalizer/PhraseTrie.ts:120

Register a phrase for fusion into a single compound token.

Parameters

Parameter	Type	Description
phrase	string	Multi-word phrase (e.g., “to the power of”)
tokenType	string	Target token type after fusion (e.g., “CARET”)

Returns

void

---

canStart()

canStart(word): boolean;

Defined in: packages/engine/src/normalizer/PhraseTrie.ts:286

Check if any phrase starts with this word (case-insensitive).

Parameters

Parameter	Type
word	string

Returns

boolean

---

getAllPhrases()

getAllPhrases(): Record<string, string>;

Defined in: packages/engine/src/normalizer/PhraseTrie.ts:262

Return all registered phrases and their target token types.

Used by diagnostic mode to expose the complete trie structure to the playground’s NormalizerTab for rendering ALL registered phrases (not just the ones that matched in this evaluation).

The listing has no prototype, so it holds exactly its own entries: a phrase spelled __proto__ is listed rather than reaching the prototype setter and vanishing, and constructor or toString read back as the phrase’s token type, never as an inherited function.

Returns

Record<string, string>

---

matchAt()

matchAt(tokens, pos):
  | NormalizerMatch
  | null;

Defined in: packages/engine/src/normalizer/PhraseTrie.ts:171

Attempt to match a phrase starting at pos in the token stream.

Walks the trie one token at a time, tracking the deepest terminal node reached. Returns the longest match found, or null if no phrase starts at this position.

Parameters

Parameter	Type	Description
tokens	Token[]	The current token stream
pos	number	Position to attempt matching from

Returns

| NormalizerMatch | null

The longest NormalizerMatch, or null on no match