# thai-address-select > A TypeScript/JavaScript library for linked Thai province, district and subdistrict dropdowns, with postal code lookup and a browser demo. ## Documentation - [Complete documentation in Markdown](https://www.thai-address-select-lib.taotech.site/index.md): Installation, working JavaScript and React examples, constructor options, methods, events and utility functions. - [Thai documentation](https://www.thai-address-select-lib.taotech.site/): The human-readable guide and source-backed dataset notes. - [Live address playground](https://www.thai-address-select-lib.taotech.site/#playground): Select an address and inspect the JSON returned by the actual library. - [React and Next.js integration](https://www.thai-address-select-lib.taotech.site/#example-react-panel): Client-side lifecycle, refs and cleanup example. - [Postal code and address utilities](https://www.thai-address-select-lib.taotech.site/#example-utilities-panel): Lookup functions for custom interfaces. ## Primary sources - [npm package](https://www.npmjs.com/package/thai-address-select): Published package and installation instructions. - [Source repository](https://github.com/rratchapol/thai-address-select-lib): Library implementation, types and bundled dataset. - [Dropdown implementation](https://github.com/rratchapol/thai-address-select-lib/blob/main/src/components/ThaiAddressSelect.ts): Authoritative behavior of initialization, selection events, getValue, setValue and destroy. - [Data utilities](https://github.com/rratchapol/thai-address-select-lib/blob/main/src/utils/filterAddress.ts): Authoritative lookup functions and substring province search. ## Usage facts Use a client-side bundler such as Vite to handle ESM imports and bundled JSON. Initialize after the form mounts. loadData() currently resolves immediately. initialValue and setValue() do not emit events. selectChange fires only after all three selections have values; use individual change events to clear a stale postal code. Dataset counts describe the bundled snapshot, not verified current administrative boundaries. The data does not update automatically. Maintainer: rratchapol on GitHub.