Skip to content

Introduction

Telixon is a phone-number processing library for JavaScript and TypeScript. It parses, validates, and formats phone numbers using one deterministic engine compiled from Google’s libphonenumber metadata.

  • @telixon/core holds the engine and all phone-number logic: parsing, validation, number type, region resolution, and the format methods.
  • @telixon/web-sdk is a headless DOM adapter built on the core engine. It provides a phone-input controller with live formatting and a stable caret, and a region-list state machine for building a region selector.

The engine is loaded explicitly by the consumer. Call ensureEngineReady() once before using the API, or ensureEngineReadySync() from @telixon/core/sync-init when a synchronous start fits better.

See Quick start for a first parse.