thaizip 0.4.0 → 0.6.0

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/normalizer.ts","../src/core/trigrams.ts","../src/core/search.ts","../src/core/formatter.ts","../src/core/resolver.ts","../src/react/useThaiAddressAutocomplete.ts"],"names":["useRef","useState","useEffect","useCallback"],"mappings":"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","file":"react.cjs","sourcesContent":["const TONE_MARKS = /[่-๋็์]/g\nconst ADDRESS_PREFIXES = /^(จังหวัด|อำเภอ|ตำบล|แขวง|เขต|จ\\.|อ\\.|ต\\.|ข\\.)/\n\nexport function normalizeThaiAddressText(input: string): string {\n  if (!input) return ''\n  let text = input.trim()\n  text = text.replace(ADDRESS_PREFIXES, '').trim()\n  text = text.replace(TONE_MARKS, '')\n  text = text.toLowerCase()\n  return text\n}\n","import { normalizeThaiAddressText } from './normalizer'\n\n// Public: for callers who start from raw (un-normalised) text — e.g. indexer\nexport function extractTrigrams(text: string): Set<string> {\n  return extractTrigramsNormalized(normalizeThaiAddressText(text))\n}\n\n// Internal: for callers who already hold a normalised string — e.g. search.ts\nexport function extractTrigramsNormalized(text: string): Set<string> {\n  const result = new Set<string>()\n  if (text.length === 0) return result\n  if (text.length < 3) {\n    result.add(text)\n    return result\n  }\n  for (let i = 0; i <= text.length - 3; i++) {\n    result.add(text.slice(i, i + 3))\n  }\n  return result\n}\n","import { normalizeThaiAddressText } from './normalizer'\nimport { extractTrigramsNormalized } from './trigrams'\nimport type { SearchOptions, ThaiAddressRecord, TrigramIndex } from '../types'\n\nconst ZIP_CODE_RE = /^\\d+$/\n\nexport function searchThaiAddress(\n  index: TrigramIndex,\n  query: string,\n  options?: SearchOptions,\n): ThaiAddressRecord[] {\n  const limit = options?.limit ?? 10\n  const threshold = options?.threshold ?? 0.4\n\n  if (!index || !query) return []\n  const normalized = normalizeThaiAddressText(query)\n  if (normalized.length === 0) return []\n  if (normalized.length > 300) return []\n\n  // Special case: zip code query (require at least 2 digits to avoid overly broad matches)\n  if (ZIP_CODE_RE.test(normalized)) {\n    if (normalized.length < 2) return []\n    const matches: ThaiAddressRecord[] = []\n    for (const [zip, indices] of index.zipIndex) {\n      if (zip.startsWith(normalized)) {\n        for (const idx of indices) matches.push(index.records[idx])\n      }\n    }\n    // exact match first, then ascending zip code\n    matches.sort((a, b) => {\n      if (a.zipCode === normalized && b.zipCode !== normalized) return -1\n      if (b.zipCode === normalized && a.zipCode !== normalized) return 1\n      return a.zipCode.localeCompare(b.zipCode, undefined, { numeric: true })\n    })\n    return matches.slice(0, limit)\n  }\n\n  // Queries shorter than 3 chars produce a single-element trigram set where every\n  // partial hit scores 1.0 — meaningless for text search.\n  // Exception: if the raw query was longer (e.g. \"ต.กา\" normalizes to \"กา\"),\n  // a Thai address prefix was stripped — allow through to avoid silent empty results.\n  if (normalized.length < 3 && query.trim().length < 3) return []\n\n  const queryTrigrams = extractTrigramsNormalized(normalized)\n\n  // Accumulate hit counts per record index\n  const hits = new Map<number, number>()\n  for (const trigram of queryTrigrams) {\n    const candidates = index.map.get(trigram)\n    if (!candidates) continue\n    for (const idx of candidates) {\n      hits.set(idx, (hits.get(idx) ?? 0) + 1)\n    }\n  }\n\n  const scored: { idx: number; score: number }[] = []\n  for (const [idx, count] of hits) {\n    const score = count / queryTrigrams.size\n    if (score >= threshold) {\n      scored.push({ idx, score })\n    }\n  }\n\n  scored.sort((a, b) => {\n    if (b.score !== a.score) return b.score - a.score\n    const ra = index.records[a.idx]\n    const rb = index.records[b.idx]\n    return (\n      ra.provinceNameTh.localeCompare(rb.provinceNameTh, 'th') ||\n      ra.amphureNameTh.localeCompare(rb.amphureNameTh, 'th') ||\n      ra.tambonNameTh.localeCompare(rb.tambonNameTh, 'th')\n    )\n  })\n\n  return scored.slice(0, limit).map(({ idx }) => index.records[idx])\n}\n","import type { ThaiAddressRecord, ThaiAddressSuggestion } from '../types'\n\nexport function formatThaiAddressSuggestion(record: ThaiAddressRecord): ThaiAddressSuggestion {\n  return {\n    id: String(record.tambonId),\n    label: `${record.tambonNameTh} > ${record.amphureNameTh} > ${record.provinceNameTh} ${record.zipCode}`,\n    tambon: record.tambonNameTh,\n    tambonEn: record.tambonNameEn,\n    amphure: record.amphureNameTh,\n    amphureEn: record.amphureNameEn,\n    province: record.provinceNameTh,\n    provinceEn: record.provinceNameEn,\n    zipCode: record.zipCode,\n  }\n}\n","import type { ThaiAddressRecord, ResolvedThaiAddress } from '../types'\n\nexport function resolveThaiAddress(record: ThaiAddressRecord): ResolvedThaiAddress {\n  return {\n    tambon: record.tambonNameTh,\n    tambonEn: record.tambonNameEn,\n    amphure: record.amphureNameTh,\n    amphureEn: record.amphureNameEn,\n    province: record.provinceNameTh,\n    provinceEn: record.provinceNameEn,\n    zipCode: record.zipCode,\n    subdistrict: record.tambonNameTh,\n    subdistrictEn: record.tambonNameEn,\n    district: record.amphureNameTh,\n    districtEn: record.amphureNameEn,\n    postalCode: record.zipCode,\n  }\n}\n","// NOTE (SZ-4): CJS consumers (`dist/index.cjs`) cannot tree-shake this hook out of the bundle.\n// If you are using the CJS build in a non-React environment, import only from the core entry\n// or use the ESM build with a bundler that supports tree-shaking.\nimport { useState, useEffect, useCallback, useRef } from 'react'\nimport { searchThaiAddress } from '../core/search'\nimport { formatThaiAddressSuggestion } from '../core/formatter'\nimport { resolveThaiAddress } from '../core/resolver'\nimport type {\n  UseThaiAddressAutocompleteOptions,\n  ThaiAddressRecord,\n  ThaiAddressSuggestion,\n  ResolvedThaiAddress,\n} from '../types'\n\n/**\n * Headless Thai address autocomplete hook.\n *\n * @param options.index - The TrigramIndex to search against. The hook reads `index`\n *   via an internal ref, so a new object reference does NOT restart the debounce\n *   timer. When `index` itself changes (e.g. swapped for a custom dataset), any\n *   pending query is re-searched immediately with the new index.\n * @param options.limit - Maximum number of suggestions (default 10).\n * @param options.debounce - Debounce delay in ms (default 200).\n * @param options.threshold - Minimum trigram score 0–1 (default 0.4).\n */\nexport function useThaiAddressAutocomplete(options: UseThaiAddressAutocompleteOptions) {\n  const { index, limit = 10, debounce: debounceMs = 200, threshold = 0.4 } = options\n\n  // Keep index in a ref so a new object reference from the caller doesn't\n  // re-trigger the search effect. The ref is updated synchronously each render\n  // so the debounce callback always reads the latest value.\n  const indexRef = useRef(index)\n  indexRef.current = index\n\n  const [query, setQuery] = useState('')\n  const [suggestions, setSuggestions] = useState<ThaiAddressSuggestion[]>([])\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null)\n  const matchedRecordsMapRef = useRef<Map<string, ThaiAddressRecord>>(new Map())\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  useEffect(() => {\n    if (timerRef.current) clearTimeout(timerRef.current)\n\n    if (query.length === 0) {\n      setSuggestions([])\n      matchedRecordsMapRef.current = new Map()\n      return\n    }\n\n    timerRef.current = setTimeout(() => {\n      const records = searchThaiAddress(indexRef.current, query, { limit, threshold })\n      const formatted = records.map(formatThaiAddressSuggestion)\n      const recordMap = new Map<string, ThaiAddressRecord>()\n      for (let i = 0; i < records.length; i++) {\n        recordMap.set(formatted[i].id, records[i])\n      }\n      matchedRecordsMapRef.current = recordMap\n      setSuggestions(formatted)\n    }, debounceMs)\n\n    return () => {\n      if (timerRef.current) clearTimeout(timerRef.current)\n    }\n    // `index` is intentionally omitted — it is read via indexRef.current so that\n    // a new reference from the caller does not restart the debounce timer.\n  }, [query, limit, threshold, debounceMs])\n\n  // When `index` changes (e.g. loaded after user started typing, or swapped for a\n  // custom dataset), re-run the search immediately rather than waiting for the\n  // next keystroke.\n  useEffect(() => {\n    if (query.length === 0) return\n    if (timerRef.current) clearTimeout(timerRef.current)\n    const records = searchThaiAddress(index, query, { limit, threshold })\n    const formatted = records.map(formatThaiAddressSuggestion)\n    const recordMap = new Map<string, ThaiAddressRecord>()\n    for (let i = 0; i < records.length; i++) {\n      recordMap.set(formatted[i].id, records[i])\n    }\n    matchedRecordsMapRef.current = recordMap\n    setSuggestions(formatted)\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [index])\n\n  /**\n   * Resolves a suggestion to a full ThaiAddress and clears the suggestions list.\n   *\n   * Note: `query` is intentionally left unchanged so the input field retains the\n   * typed text. Call `clear()` afterwards if you want to reset the input as well.\n   */\n  const selectSuggestion = useCallback(\n    (item: ThaiAddressSuggestion): ResolvedThaiAddress => {\n      if (timerRef.current) clearTimeout(timerRef.current)\n      const record = matchedRecordsMapRef.current.get(item.id)\n      if (!record) {\n        throw new Error(`[thaizip] No record found for suggestion id \"${item.id}\". Make sure to use suggestions returned by this hook.`)\n      }\n      setSuggestions([])\n      matchedRecordsMapRef.current = new Map()\n      return resolveThaiAddress(record)\n    },\n    [],\n  )\n\n  const clear = useCallback(() => {\n    setQuery('')\n    setSuggestions([])\n    matchedRecordsMapRef.current = new Map()\n  }, [])\n\n  return {\n    query,\n    setQuery,\n    suggestions,\n    isOpen: query.length > 0 && suggestions.length > 0,\n    selectSuggestion,\n    clear,\n  }\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,72 @@
+import * as react from 'react';
+
+type ThaiAddressRecord = {
+    provinceId: number;
+    provinceNameTh: string;
+    provinceNameEn: string;
+    amphureId: number;
+    amphureNameTh: string;
+    amphureNameEn: string;
+    tambonId: number;
+    tambonNameTh: string;
+    tambonNameEn: string;
+    zipCode: string;
+};
+type TrigramIndex = {
+    map: Map<string, Set<number>>;
+    records: ThaiAddressRecord[];
+    zipIndex: Map<string, number[]>;
+};
+type ThaiAddressSuggestion = {
+    id: string;
+    label: string;
+    tambon: string;
+    tambonEn: string;
+    amphure: string;
+    amphureEn: string;
+    province: string;
+    provinceEn: string;
+    zipCode: string;
+};
+type ResolvedThaiAddress = {
+    tambon: string;
+    tambonEn: string;
+    amphure: string;
+    amphureEn: string;
+    province: string;
+    provinceEn: string;
+    zipCode: string;
+    subdistrict: string;
+    subdistrictEn: string;
+    district: string;
+    districtEn: string;
+    postalCode: string;
+};
+type UseThaiAddressAutocompleteOptions = {
+    index: TrigramIndex;
+    limit?: number;
+    debounce?: number;
+    threshold?: number;
+};
+
+/**
+ * Headless Thai address autocomplete hook.
+ *
+ * @param options.index - The TrigramIndex to search against. The hook reads `index`
+ *   via an internal ref, so a new object reference does NOT restart the debounce
+ *   timer. When `index` itself changes (e.g. swapped for a custom dataset), any
+ *   pending query is re-searched immediately with the new index.
+ * @param options.limit - Maximum number of suggestions (default 10).
+ * @param options.debounce - Debounce delay in ms (default 200).
+ * @param options.threshold - Minimum trigram score 0–1 (default 0.4).
+ */
+declare function useThaiAddressAutocomplete(options: UseThaiAddressAutocompleteOptions): {
+    query: string;
+    setQuery: react.Dispatch<react.SetStateAction<string>>;
+    suggestions: ThaiAddressSuggestion[];
+    isOpen: boolean;
+    selectSuggestion: (item: ThaiAddressSuggestion) => ResolvedThaiAddress;
+    clear: () => void;
+};
+
+export { type ResolvedThaiAddress, type ThaiAddressSuggestion, type TrigramIndex, type UseThaiAddressAutocompleteOptions, useThaiAddressAutocomplete };

package/dist/react.d.ts

@@ -0,0 +1,72 @@
+import * as react from 'react';
+
+type ThaiAddressRecord = {
+    provinceId: number;
+    provinceNameTh: string;
+    provinceNameEn: string;
+    amphureId: number;
+    amphureNameTh: string;
+    amphureNameEn: string;
+    tambonId: number;
+    tambonNameTh: string;
+    tambonNameEn: string;
+    zipCode: string;
+};
+type TrigramIndex = {
+    map: Map<string, Set<number>>;
+    records: ThaiAddressRecord[];
+    zipIndex: Map<string, number[]>;
+};
+type ThaiAddressSuggestion = {
+    id: string;
+    label: string;
+    tambon: string;
+    tambonEn: string;
+    amphure: string;
+    amphureEn: string;
+    province: string;
+    provinceEn: string;
+    zipCode: string;
+};
+type ResolvedThaiAddress = {
+    tambon: string;
+    tambonEn: string;
+    amphure: string;
+    amphureEn: string;
+    province: string;
+    provinceEn: string;
+    zipCode: string;
+    subdistrict: string;
+    subdistrictEn: string;
+    district: string;
+    districtEn: string;
+    postalCode: string;
+};
+type UseThaiAddressAutocompleteOptions = {
+    index: TrigramIndex;
+    limit?: number;
+    debounce?: number;
+    threshold?: number;
+};
+
+/**
+ * Headless Thai address autocomplete hook.
+ *
+ * @param options.index - The TrigramIndex to search against. The hook reads `index`
+ *   via an internal ref, so a new object reference does NOT restart the debounce
+ *   timer. When `index` itself changes (e.g. swapped for a custom dataset), any
+ *   pending query is re-searched immediately with the new index.
+ * @param options.limit - Maximum number of suggestions (default 10).
+ * @param options.debounce - Debounce delay in ms (default 200).
+ * @param options.threshold - Minimum trigram score 0–1 (default 0.4).
+ */
+declare function useThaiAddressAutocomplete(options: UseThaiAddressAutocompleteOptions): {
+    query: string;
+    setQuery: react.Dispatch<react.SetStateAction<string>>;
+    suggestions: ThaiAddressSuggestion[];
+    isOpen: boolean;
+    selectSuggestion: (item: ThaiAddressSuggestion) => ResolvedThaiAddress;
+    clear: () => void;
+};
+
+export { type ResolvedThaiAddress, type ThaiAddressSuggestion, type TrigramIndex, type UseThaiAddressAutocompleteOptions, useThaiAddressAutocomplete };

package/dist/react.js

@@ -0,0 +1,186 @@
+import { useRef, useState, useEffect, useCallback } from 'react';
+
+// src/react/useThaiAddressAutocomplete.ts
+
+// src/core/normalizer.ts
+var TONE_MARKS = /[่-๋็์]/g;
+var ADDRESS_PREFIXES = /^(จังหวัด|อำเภอ|ตำบล|แขวง|เขต|จ\.|อ\.|ต\.|ข\.)/;
+function normalizeThaiAddressText(input) {
+  if (!input) return "";
+  let text = input.trim();
+  text = text.replace(ADDRESS_PREFIXES, "").trim();
+  text = text.replace(TONE_MARKS, "");
+  text = text.toLowerCase();
+  return text;
+}
+
+// src/core/trigrams.ts
+function extractTrigramsNormalized(text) {
+  const result = /* @__PURE__ */ new Set();
+  if (text.length === 0) return result;
+  if (text.length < 3) {
+    result.add(text);
+    return result;
+  }
+  for (let i = 0; i <= text.length - 3; i++) {
+    result.add(text.slice(i, i + 3));
+  }
+  return result;
+}
+
+// src/core/search.ts
+var ZIP_CODE_RE = /^\d+$/;
+function searchThaiAddress(index, query, options) {
+  const limit = options?.limit ?? 10;
+  const threshold = options?.threshold ?? 0.4;
+  if (!index || !query) return [];
+  const normalized = normalizeThaiAddressText(query);
+  if (normalized.length === 0) return [];
+  if (normalized.length > 300) return [];
+  if (ZIP_CODE_RE.test(normalized)) {
+    if (normalized.length < 2) return [];
+    const matches = [];
+    for (const [zip, indices] of index.zipIndex) {
+      if (zip.startsWith(normalized)) {
+        for (const idx of indices) matches.push(index.records[idx]);
+      }
+    }
+    matches.sort((a, b) => {
+      if (a.zipCode === normalized && b.zipCode !== normalized) return -1;
+      if (b.zipCode === normalized && a.zipCode !== normalized) return 1;
+      return a.zipCode.localeCompare(b.zipCode, void 0, { numeric: true });
+    });
+    return matches.slice(0, limit);
+  }
+  if (normalized.length < 3 && query.trim().length < 3) return [];
+  const queryTrigrams = extractTrigramsNormalized(normalized);
+  const hits = /* @__PURE__ */ new Map();
+  for (const trigram of queryTrigrams) {
+    const candidates = index.map.get(trigram);
+    if (!candidates) continue;
+    for (const idx of candidates) {
+      hits.set(idx, (hits.get(idx) ?? 0) + 1);
+    }
+  }
+  const scored = [];
+  for (const [idx, count] of hits) {
+    const score = count / queryTrigrams.size;
+    if (score >= threshold) {
+      scored.push({ idx, score });
+    }
+  }
+  scored.sort((a, b) => {
+    if (b.score !== a.score) return b.score - a.score;
+    const ra = index.records[a.idx];
+    const rb = index.records[b.idx];
+    return ra.provinceNameTh.localeCompare(rb.provinceNameTh, "th") || ra.amphureNameTh.localeCompare(rb.amphureNameTh, "th") || ra.tambonNameTh.localeCompare(rb.tambonNameTh, "th");
+  });
+  return scored.slice(0, limit).map(({ idx }) => index.records[idx]);
+}
+
+// src/core/formatter.ts
+function formatThaiAddressSuggestion(record) {
+  return {
+    id: String(record.tambonId),
+    label: `${record.tambonNameTh} > ${record.amphureNameTh} > ${record.provinceNameTh} ${record.zipCode}`,
+    tambon: record.tambonNameTh,
+    tambonEn: record.tambonNameEn,
+    amphure: record.amphureNameTh,
+    amphureEn: record.amphureNameEn,
+    province: record.provinceNameTh,
+    provinceEn: record.provinceNameEn,
+    zipCode: record.zipCode
+  };
+}
+
+// src/core/resolver.ts
+function resolveThaiAddress(record) {
+  return {
+    tambon: record.tambonNameTh,
+    tambonEn: record.tambonNameEn,
+    amphure: record.amphureNameTh,
+    amphureEn: record.amphureNameEn,
+    province: record.provinceNameTh,
+    provinceEn: record.provinceNameEn,
+    zipCode: record.zipCode,
+    subdistrict: record.tambonNameTh,
+    subdistrictEn: record.tambonNameEn,
+    district: record.amphureNameTh,
+    districtEn: record.amphureNameEn,
+    postalCode: record.zipCode
+  };
+}
+
+// src/react/useThaiAddressAutocomplete.ts
+function useThaiAddressAutocomplete(options) {
+  const { index, limit = 10, debounce: debounceMs = 200, threshold = 0.4 } = options;
+  const indexRef = useRef(index);
+  indexRef.current = index;
+  const [query, setQuery] = useState("");
+  const [suggestions, setSuggestions] = useState([]);
+  const timerRef = useRef(null);
+  const matchedRecordsMapRef = useRef(/* @__PURE__ */ new Map());
+  useEffect(() => {
+    if (timerRef.current) clearTimeout(timerRef.current);
+    if (query.length === 0) {
+      setSuggestions([]);
+      matchedRecordsMapRef.current = /* @__PURE__ */ new Map();
+      return;
+    }
+    timerRef.current = setTimeout(() => {
+      const records = searchThaiAddress(indexRef.current, query, { limit, threshold });
+      const formatted = records.map(formatThaiAddressSuggestion);
+      const recordMap = /* @__PURE__ */ new Map();
+      for (let i = 0; i < records.length; i++) {
+        recordMap.set(formatted[i].id, records[i]);
+      }
+      matchedRecordsMapRef.current = recordMap;
+      setSuggestions(formatted);
+    }, debounceMs);
+    return () => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+    };
+  }, [query, limit, threshold, debounceMs]);
+  useEffect(() => {
+    if (query.length === 0) return;
+    if (timerRef.current) clearTimeout(timerRef.current);
+    const records = searchThaiAddress(index, query, { limit, threshold });
+    const formatted = records.map(formatThaiAddressSuggestion);
+    const recordMap = /* @__PURE__ */ new Map();
+    for (let i = 0; i < records.length; i++) {
+      recordMap.set(formatted[i].id, records[i]);
+    }
+    matchedRecordsMapRef.current = recordMap;
+    setSuggestions(formatted);
+  }, [index]);
+  const selectSuggestion = useCallback(
+    (item) => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+      const record = matchedRecordsMapRef.current.get(item.id);
+      if (!record) {
+        throw new Error(`[thaizip] No record found for suggestion id "${item.id}". Make sure to use suggestions returned by this hook.`);
+      }
+      setSuggestions([]);
+      matchedRecordsMapRef.current = /* @__PURE__ */ new Map();
+      return resolveThaiAddress(record);
+    },
+    []
+  );
+  const clear = useCallback(() => {
+    setQuery("");
+    setSuggestions([]);
+    matchedRecordsMapRef.current = /* @__PURE__ */ new Map();
+  }, []);
+  return {
+    query,
+    setQuery,
+    suggestions,
+    isOpen: query.length > 0 && suggestions.length > 0,
+    selectSuggestion,
+    clear
+  };
+}
+
+export { useThaiAddressAutocomplete };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/normalizer.ts","../src/core/trigrams.ts","../src/core/search.ts","../src/core/formatter.ts","../src/core/resolver.ts","../src/react/useThaiAddressAutocomplete.ts"],"names":[],"mappings":"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","file":"react.js","sourcesContent":["const TONE_MARKS = /[่-๋็์]/g\nconst ADDRESS_PREFIXES = /^(จังหวัด|อำเภอ|ตำบล|แขวง|เขต|จ\\.|อ\\.|ต\\.|ข\\.)/\n\nexport function normalizeThaiAddressText(input: string): string {\n  if (!input) return ''\n  let text = input.trim()\n  text = text.replace(ADDRESS_PREFIXES, '').trim()\n  text = text.replace(TONE_MARKS, '')\n  text = text.toLowerCase()\n  return text\n}\n","import { normalizeThaiAddressText } from './normalizer'\n\n// Public: for callers who start from raw (un-normalised) text — e.g. indexer\nexport function extractTrigrams(text: string): Set<string> {\n  return extractTrigramsNormalized(normalizeThaiAddressText(text))\n}\n\n// Internal: for callers who already hold a normalised string — e.g. search.ts\nexport function extractTrigramsNormalized(text: string): Set<string> {\n  const result = new Set<string>()\n  if (text.length === 0) return result\n  if (text.length < 3) {\n    result.add(text)\n    return result\n  }\n  for (let i = 0; i <= text.length - 3; i++) {\n    result.add(text.slice(i, i + 3))\n  }\n  return result\n}\n","import { normalizeThaiAddressText } from './normalizer'\nimport { extractTrigramsNormalized } from './trigrams'\nimport type { SearchOptions, ThaiAddressRecord, TrigramIndex } from '../types'\n\nconst ZIP_CODE_RE = /^\\d+$/\n\nexport function searchThaiAddress(\n  index: TrigramIndex,\n  query: string,\n  options?: SearchOptions,\n): ThaiAddressRecord[] {\n  const limit = options?.limit ?? 10\n  const threshold = options?.threshold ?? 0.4\n\n  if (!index || !query) return []\n  const normalized = normalizeThaiAddressText(query)\n  if (normalized.length === 0) return []\n  if (normalized.length > 300) return []\n\n  // Special case: zip code query (require at least 2 digits to avoid overly broad matches)\n  if (ZIP_CODE_RE.test(normalized)) {\n    if (normalized.length < 2) return []\n    const matches: ThaiAddressRecord[] = []\n    for (const [zip, indices] of index.zipIndex) {\n      if (zip.startsWith(normalized)) {\n        for (const idx of indices) matches.push(index.records[idx])\n      }\n    }\n    // exact match first, then ascending zip code\n    matches.sort((a, b) => {\n      if (a.zipCode === normalized && b.zipCode !== normalized) return -1\n      if (b.zipCode === normalized && a.zipCode !== normalized) return 1\n      return a.zipCode.localeCompare(b.zipCode, undefined, { numeric: true })\n    })\n    return matches.slice(0, limit)\n  }\n\n  // Queries shorter than 3 chars produce a single-element trigram set where every\n  // partial hit scores 1.0 — meaningless for text search.\n  // Exception: if the raw query was longer (e.g. \"ต.กา\" normalizes to \"กา\"),\n  // a Thai address prefix was stripped — allow through to avoid silent empty results.\n  if (normalized.length < 3 && query.trim().length < 3) return []\n\n  const queryTrigrams = extractTrigramsNormalized(normalized)\n\n  // Accumulate hit counts per record index\n  const hits = new Map<number, number>()\n  for (const trigram of queryTrigrams) {\n    const candidates = index.map.get(trigram)\n    if (!candidates) continue\n    for (const idx of candidates) {\n      hits.set(idx, (hits.get(idx) ?? 0) + 1)\n    }\n  }\n\n  const scored: { idx: number; score: number }[] = []\n  for (const [idx, count] of hits) {\n    const score = count / queryTrigrams.size\n    if (score >= threshold) {\n      scored.push({ idx, score })\n    }\n  }\n\n  scored.sort((a, b) => {\n    if (b.score !== a.score) return b.score - a.score\n    const ra = index.records[a.idx]\n    const rb = index.records[b.idx]\n    return (\n      ra.provinceNameTh.localeCompare(rb.provinceNameTh, 'th') ||\n      ra.amphureNameTh.localeCompare(rb.amphureNameTh, 'th') ||\n      ra.tambonNameTh.localeCompare(rb.tambonNameTh, 'th')\n    )\n  })\n\n  return scored.slice(0, limit).map(({ idx }) => index.records[idx])\n}\n","import type { ThaiAddressRecord, ThaiAddressSuggestion } from '../types'\n\nexport function formatThaiAddressSuggestion(record: ThaiAddressRecord): ThaiAddressSuggestion {\n  return {\n    id: String(record.tambonId),\n    label: `${record.tambonNameTh} > ${record.amphureNameTh} > ${record.provinceNameTh} ${record.zipCode}`,\n    tambon: record.tambonNameTh,\n    tambonEn: record.tambonNameEn,\n    amphure: record.amphureNameTh,\n    amphureEn: record.amphureNameEn,\n    province: record.provinceNameTh,\n    provinceEn: record.provinceNameEn,\n    zipCode: record.zipCode,\n  }\n}\n","import type { ThaiAddressRecord, ResolvedThaiAddress } from '../types'\n\nexport function resolveThaiAddress(record: ThaiAddressRecord): ResolvedThaiAddress {\n  return {\n    tambon: record.tambonNameTh,\n    tambonEn: record.tambonNameEn,\n    amphure: record.amphureNameTh,\n    amphureEn: record.amphureNameEn,\n    province: record.provinceNameTh,\n    provinceEn: record.provinceNameEn,\n    zipCode: record.zipCode,\n    subdistrict: record.tambonNameTh,\n    subdistrictEn: record.tambonNameEn,\n    district: record.amphureNameTh,\n    districtEn: record.amphureNameEn,\n    postalCode: record.zipCode,\n  }\n}\n","// NOTE (SZ-4): CJS consumers (`dist/index.cjs`) cannot tree-shake this hook out of the bundle.\n// If you are using the CJS build in a non-React environment, import only from the core entry\n// or use the ESM build with a bundler that supports tree-shaking.\nimport { useState, useEffect, useCallback, useRef } from 'react'\nimport { searchThaiAddress } from '../core/search'\nimport { formatThaiAddressSuggestion } from '../core/formatter'\nimport { resolveThaiAddress } from '../core/resolver'\nimport type {\n  UseThaiAddressAutocompleteOptions,\n  ThaiAddressRecord,\n  ThaiAddressSuggestion,\n  ResolvedThaiAddress,\n} from '../types'\n\n/**\n * Headless Thai address autocomplete hook.\n *\n * @param options.index - The TrigramIndex to search against. The hook reads `index`\n *   via an internal ref, so a new object reference does NOT restart the debounce\n *   timer. When `index` itself changes (e.g. swapped for a custom dataset), any\n *   pending query is re-searched immediately with the new index.\n * @param options.limit - Maximum number of suggestions (default 10).\n * @param options.debounce - Debounce delay in ms (default 200).\n * @param options.threshold - Minimum trigram score 0–1 (default 0.4).\n */\nexport function useThaiAddressAutocomplete(options: UseThaiAddressAutocompleteOptions) {\n  const { index, limit = 10, debounce: debounceMs = 200, threshold = 0.4 } = options\n\n  // Keep index in a ref so a new object reference from the caller doesn't\n  // re-trigger the search effect. The ref is updated synchronously each render\n  // so the debounce callback always reads the latest value.\n  const indexRef = useRef(index)\n  indexRef.current = index\n\n  const [query, setQuery] = useState('')\n  const [suggestions, setSuggestions] = useState<ThaiAddressSuggestion[]>([])\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null)\n  const matchedRecordsMapRef = useRef<Map<string, ThaiAddressRecord>>(new Map())\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  useEffect(() => {\n    if (timerRef.current) clearTimeout(timerRef.current)\n\n    if (query.length === 0) {\n      setSuggestions([])\n      matchedRecordsMapRef.current = new Map()\n      return\n    }\n\n    timerRef.current = setTimeout(() => {\n      const records = searchThaiAddress(indexRef.current, query, { limit, threshold })\n      const formatted = records.map(formatThaiAddressSuggestion)\n      const recordMap = new Map<string, ThaiAddressRecord>()\n      for (let i = 0; i < records.length; i++) {\n        recordMap.set(formatted[i].id, records[i])\n      }\n      matchedRecordsMapRef.current = recordMap\n      setSuggestions(formatted)\n    }, debounceMs)\n\n    return () => {\n      if (timerRef.current) clearTimeout(timerRef.current)\n    }\n    // `index` is intentionally omitted — it is read via indexRef.current so that\n    // a new reference from the caller does not restart the debounce timer.\n  }, [query, limit, threshold, debounceMs])\n\n  // When `index` changes (e.g. loaded after user started typing, or swapped for a\n  // custom dataset), re-run the search immediately rather than waiting for the\n  // next keystroke.\n  useEffect(() => {\n    if (query.length === 0) return\n    if (timerRef.current) clearTimeout(timerRef.current)\n    const records = searchThaiAddress(index, query, { limit, threshold })\n    const formatted = records.map(formatThaiAddressSuggestion)\n    const recordMap = new Map<string, ThaiAddressRecord>()\n    for (let i = 0; i < records.length; i++) {\n      recordMap.set(formatted[i].id, records[i])\n    }\n    matchedRecordsMapRef.current = recordMap\n    setSuggestions(formatted)\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [index])\n\n  /**\n   * Resolves a suggestion to a full ThaiAddress and clears the suggestions list.\n   *\n   * Note: `query` is intentionally left unchanged so the input field retains the\n   * typed text. Call `clear()` afterwards if you want to reset the input as well.\n   */\n  const selectSuggestion = useCallback(\n    (item: ThaiAddressSuggestion): ResolvedThaiAddress => {\n      if (timerRef.current) clearTimeout(timerRef.current)\n      const record = matchedRecordsMapRef.current.get(item.id)\n      if (!record) {\n        throw new Error(`[thaizip] No record found for suggestion id \"${item.id}\". Make sure to use suggestions returned by this hook.`)\n      }\n      setSuggestions([])\n      matchedRecordsMapRef.current = new Map()\n      return resolveThaiAddress(record)\n    },\n    [],\n  )\n\n  const clear = useCallback(() => {\n    setQuery('')\n    setSuggestions([])\n    matchedRecordsMapRef.current = new Map()\n  }, [])\n\n  return {\n    query,\n    setQuery,\n    suggestions,\n    isOpen: query.length > 0 && suggestions.length > 0,\n    selectSuggestion,\n    clear,\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thaizip",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Fast, fuzzy Thai address autocomplete library (headless + React)",
   "keywords": [
     "thai",
@@ -25,6 +25,11 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
     "./data": {
       "types": "./dist/data.d.ts",
       "import": "./dist/data.js",
@@ -68,6 +73,6 @@
     }
   },
   "engines": {
-    "node": ">=14"
+    "node": ">=18"
   }
 }