@0xd33p/vietnam-divisions 0.2.0

package/dist/internal/helpers.js

@@ -0,0 +1,55 @@
+const DIACRITIC_MAP = {
+    a: 'a', à: 'a', á: 'a', ả: 'a', ã: 'a', ạ: 'a',
+    ă: 'a', ằ: 'a', ắ: 'a', ẳ: 'a', ẵ: 'a', ặ: 'a',
+    â: 'a', ầ: 'a', ấ: 'a', ẩ: 'a', ẫ: 'a', ậ: 'a',
+    e: 'e', è: 'e', é: 'e', ẻ: 'e', ẽ: 'e', ẹ: 'e',
+    ê: 'e', ề: 'e', ế: 'e', ể: 'e', ễ: 'e', ệ: 'e',
+    i: 'i', ì: 'i', í: 'i', ỉ: 'i', ĩ: 'i', ị: 'i',
+    o: 'o', ò: 'o', ó: 'o', ỏ: 'o', õ: 'o', ọ: 'o',
+    ô: 'o', ồ: 'o', ố: 'o', ổ: 'o', ỗ: 'o', ộ: 'o',
+    ơ: 'o', ờ: 'o', ớ: 'o', ở: 'o', ỡ: 'o', ợ: 'o',
+    u: 'u', ù: 'u', ú: 'u', ủ: 'u', ũ: 'u', ụ: 'u',
+    ư: 'u', ừ: 'u', ứ: 'u', ử: 'u', ữ: 'u', ự: 'u',
+    y: 'y', ỳ: 'y', ý: 'y', ỷ: 'y', ỹ: 'y', ỵ: 'y',
+    đ: 'd',
+    // uppercase
+    A: 'a', À: 'a', Á: 'a', Ả: 'a', Ã: 'a', Ạ: 'a',
+    Ă: 'a', Ằ: 'a', Ắ: 'a', Ẳ: 'a', Ẵ: 'a', Ặ: 'a',
+    Â: 'a', Ầ: 'a', Ấ: 'a', Ẩ: 'a', Ẫ: 'a', Ậ: 'a',
+    E: 'e', È: 'e', É: 'e', Ẻ: 'e', Ẽ: 'e', Ẹ: 'e',
+    Ê: 'e', Ề: 'e', Ế: 'e', Ể: 'e', Ễ: 'e', Ệ: 'e',
+    I: 'i', Ì: 'i', Í: 'i', Ỉ: 'i', Ĩ: 'i', Ị: 'i',
+    O: 'o', Ò: 'o', Ó: 'o', Ỏ: 'o', Õ: 'o', Ọ: 'o',
+    Ô: 'o', Ồ: 'o', Ố: 'o', Ổ: 'o', Ỗ: 'o', Ộ: 'o',
+    Ơ: 'o', Ờ: 'o', Ớ: 'o', Ở: 'o', Ỡ: 'o', Ợ: 'o',
+    U: 'u', Ù: 'u', Ú: 'u', Ủ: 'u', Ũ: 'u', Ụ: 'u',
+    Ư: 'u', Ừ: 'u', Ứ: 'u', Ử: 'u', Ữ: 'u', Ự: 'u',
+    Y: 'y', Ỳ: 'y', Ý: 'y', Ỷ: 'y', Ỹ: 'y', Ỵ: 'y',
+    Đ: 'd',
+};
+/** Remove Vietnamese diacritics, lowercase, collapse whitespace. */
+export function normalizeName(name) {
+    return name
+        .split('')
+        .map((ch) => DIACRITIC_MAP[ch] ?? ch)
+        .join('')
+        .toLowerCase()
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export function normalizeProvince(p) {
+    return { id: p.idProvince, name: p.name };
+}
+export function normalizeCommune(c) {
+    return { id: c.idCommune, name: c.name };
+}
+export function normalizeDistrict(d) {
+    return { id: d.idDistrict, name: d.name };
+}
+export function ok(data) {
+    return { data };
+}
+export function fail(error) {
+    return { data: null, error };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/internal/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/internal/helpers.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAA2B;IAC5C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG;IACN,YAAY;IACZ,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG;IAC9C,CAAC,EAAE,GAAG;CACP,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI;SACR,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;SACpC,IAAI,CAAC,EAAE,CAAC;SACR,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAGjC;IACC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAGhC;IACC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAGjC;IACC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,EAAE,CAAI,IAAO;IAC3B,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAe;IAClC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC"}

package/dist/internal/legacy/index.d.ts

@@ -0,0 +1,21 @@
+import type { LegacyProvince, LegacyDistrict, LegacyCommune } from './types.js';
+export type { LegacyProvince, LegacyDistrict, LegacyCommune };
+declare function getProvinceById(id: string): LegacyProvince | undefined;
+declare function searchByName(name: string): LegacyProvince[];
+declare function getDistrictsByProvinceId(provinceId: string): LegacyDistrict[];
+declare function getCommunesByDistrictId(districtId: string): LegacyCommune[];
+declare function getCommunesByProvinceId(provinceId: string): LegacyCommune[];
+declare function getDistrictById(id: string): LegacyDistrict | undefined;
+declare function getCommuneById(id: string): LegacyCommune | undefined;
+/** Internal legacy API — consumed by `vn.legacy`. */
+export declare const legacy: {
+    provinces: () => LegacyProvince[];
+    getProvinceById: typeof getProvinceById;
+    searchByName: typeof searchByName;
+    getDistrictsByProvinceId: typeof getDistrictsByProvinceId;
+    getCommunesByDistrictId: typeof getCommunesByDistrictId;
+    getCommunesByProvinceId: typeof getCommunesByProvinceId;
+    getDistrictById: typeof getDistrictById;
+    getCommuneById: typeof getCommuneById;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/legacy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/legacy/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAM9D,iBAAS,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG/D;AAED,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAKpD;AAED,iBAAS,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CAGtE;AAED,iBAAS,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAGpE;AAED,iBAAS,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAMpE;AAED,iBAAS,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG/D;AAED,iBAAS,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAG7D;AAED,qDAAqD;AACrD,eAAO,MAAM,MAAM;;;;;;;;;CASlB,CAAC"}

package/dist/internal/legacy/index.js

@@ -0,0 +1,60 @@
+import provinceData from '../../data/legacy/province.json' with { type: 'json' };
+import districtData from '../../data/legacy/district.json' with { type: 'json' };
+import communeData from '../../data/legacy/commune.json' with { type: 'json' };
+const provinces = provinceData;
+const districts = districtData;
+const communes = communeData;
+function getProvinceById(id) {
+    if (!id)
+        return undefined;
+    return provinces.find((p) => p.idProvince === id);
+}
+function searchByName(name) {
+    if (!name)
+        return [];
+    const q = name.toLowerCase().trim();
+    if (!q)
+        return [];
+    return provinces.filter((p) => p.name.toLowerCase().includes(q));
+}
+function getDistrictsByProvinceId(provinceId) {
+    if (!provinceId)
+        return [];
+    return districts.filter((d) => d.idProvince === provinceId);
+}
+function getCommunesByDistrictId(districtId) {
+    if (!districtId)
+        return [];
+    return communes.filter((c) => c.idDistrict === districtId);
+}
+function getCommunesByProvinceId(provinceId) {
+    if (!provinceId)
+        return [];
+    const ds = getDistrictsByProvinceId(provinceId);
+    if (ds.length === 0)
+        return [];
+    const districtIds = new Set(ds.map((d) => d.idDistrict));
+    return communes.filter((c) => districtIds.has(c.idDistrict));
+}
+function getDistrictById(id) {
+    if (!id)
+        return undefined;
+    return districts.find((d) => d.idDistrict === id);
+}
+function getCommuneById(id) {
+    if (!id)
+        return undefined;
+    return communes.find((c) => c.idCommune === id);
+}
+/** Internal legacy API — consumed by `vn.legacy`. */
+export const legacy = {
+    provinces: () => provinces,
+    getProvinceById,
+    searchByName,
+    getDistrictsByProvinceId,
+    getCommunesByDistrictId,
+    getCommunesByProvinceId,
+    getDistrictById,
+    getCommuneById,
+};
+//# sourceMappingURL=index.js.map

package/dist/internal/legacy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/legacy/index.ts"],"names":[],"mappings":"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"}

package/dist/internal/legacy/types.d.ts

@@ -0,0 +1,18 @@
+/** A province in the legacy system (63 provinces, 3 levels: Province → District → Commune). */
+export interface LegacyProvince {
+    idProvince: string;
+    name: string;
+}
+/** A district in the legacy system (696 districts). */
+export interface LegacyDistrict {
+    idProvince: string;
+    idDistrict: string;
+    name: string;
+}
+/** A commune in the legacy system (10,051 communes). */
+export interface LegacyCommune {
+    idDistrict: string;
+    idCommune: string;
+    name: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/internal/legacy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/internal/legacy/types.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/internal/legacy/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/internal/legacy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internal/legacy/types.ts"],"names":[],"mappings":""}

package/dist/internal/v3/index.d.ts

@@ -0,0 +1,21 @@
+import type { Province, Commune, ProvinceMerge, WardMapping } from './types.js';
+export type { Province, Commune, ProvinceMerge, WardMapping };
+export declare const provinceMerges: ProvinceMerge[];
+export declare const wardMappings: WardMapping[];
+declare function getProvinceById(id: string): Province | undefined;
+declare function getProvinceByCode(code: string): Province | undefined;
+declare function searchProvinceByName(name: string): Province[];
+declare function getCommunesByProvinceId(provinceId: string): Commune[];
+declare function searchCommunesByName(provinceId: string, name: string): Commune[];
+declare function getCommuneById(id: string): Commune | undefined;
+/** Internal v3 API — consumed by the public `vn` interface. */
+export declare const v3: {
+    provinces: () => Province[];
+    getProvinceById: typeof getProvinceById;
+    getProvinceByCode: typeof getProvinceByCode;
+    searchProvinceByName: typeof searchProvinceByName;
+    getCommunesByProvinceId: typeof getCommunesByProvinceId;
+    searchCommunesByName: typeof searchCommunesByName;
+    getCommuneById: typeof getCommuneById;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/v3/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/v3/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMhF,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAI9D,eAAO,MAAM,cAAc,EAAyB,aAAa,EAAE,CAAC;AACpE,eAAO,MAAM,YAAY,EAAuB,WAAW,EAAE,CAAC;AAE9D,iBAAS,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAGzD;AAED,iBAAS,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAG7D;AAED,iBAAS,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAQtD;AAED,iBAAS,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE,CAG9D;AAED,iBAAS,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAOzE;AAED,iBAAS,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAGvD;AAED,+DAA+D;AAC/D,eAAO,MAAM,EAAE;;;;;;;;CAQd,CAAC"}

package/dist/internal/v3/index.js

@@ -0,0 +1,55 @@
+import provinceData from '../../data/v3/province.json' with { type: 'json' };
+import communeData from '../../data/v3/commune.json' with { type: 'json' };
+import provinceMergesData from '../../data/v3/province_merges.json' with { type: 'json' };
+import wardMappingsData from '../../data/v3/ward_mappings.json' with { type: 'json' };
+const provinces = provinceData;
+const communes = communeData;
+export const provinceMerges = provinceMergesData;
+export const wardMappings = wardMappingsData;
+function getProvinceById(id) {
+    if (!id || id.length === 0)
+        return undefined;
+    return provinces.find((p) => p.idProvince === id);
+}
+function getProvinceByCode(code) {
+    if (!code || code.length === 0)
+        return undefined;
+    return provinces.find((p) => p.code === code);
+}
+function searchProvinceByName(name) {
+    if (!name || name.length === 0)
+        return [];
+    const q = name.toLowerCase().trim();
+    if (q.length === 0)
+        return [];
+    return provinces.filter((p) => p.name.toLowerCase().includes(q) || p.shortName.toLowerCase().includes(q));
+}
+function getCommunesByProvinceId(provinceId) {
+    if (!provinceId || provinceId.length === 0)
+        return [];
+    return communes.filter((c) => c.idProvince === provinceId);
+}
+function searchCommunesByName(provinceId, name) {
+    if (!provinceId || !name)
+        return [];
+    const q = name.toLowerCase().trim();
+    if (q.length === 0)
+        return [];
+    return communes.filter((c) => c.idProvince === provinceId && c.name.toLowerCase().includes(q));
+}
+function getCommuneById(id) {
+    if (!id || id.length === 0)
+        return undefined;
+    return communes.find((c) => c.idCommune === id);
+}
+/** Internal v3 API — consumed by the public `vn` interface. */
+export const v3 = {
+    provinces: () => provinces,
+    getProvinceById,
+    getProvinceByCode,
+    searchProvinceByName,
+    getCommunesByProvinceId,
+    searchCommunesByName,
+    getCommuneById,
+};
+//# sourceMappingURL=index.js.map

package/dist/internal/v3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/v3/index.ts"],"names":[],"mappings":"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"}

package/dist/internal/v3/types.d.ts

@@ -0,0 +1,33 @@
+/** A province/city in the new system (34 provinces, Resolution 202/2025/QH15). */
+export interface Province {
+    idProvince: string;
+    name: string;
+    shortName: string;
+    code: string;
+    placeType: string;
+}
+/** A commune/ward in the new system (3,321 communes). */
+export interface Commune {
+    idProvince: string;
+    idCommune: string;
+    name: string;
+}
+/** Old-to-new province merge mapping. */
+export interface ProvinceMergeItem {
+    oldProvinceId: string;
+    oldProvinceName: string;
+}
+export interface ProvinceMerge {
+    newProvinceId: string;
+    newProvinceName: string;
+    mergedFrom: ProvinceMergeItem[];
+}
+/** Old-to-new ward code mapping. */
+export interface WardMapping {
+    oldIdCommune: string;
+    oldCommuneName: string;
+    newIdCommune: string;
+    newCommuneName: string;
+    newIdProvince: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/internal/v3/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/internal/v3/types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/internal/v3/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/internal/v3/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internal/v3/types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+/** A geographical unit with id + name. */
+export interface GeoUnit {
+    id: string;
+    name: string;
+}
+/** Self-descriptive error strings. */
+export type GeoError = 'province_not_found' | 'commune_not_found' | 'district_not_found' | 'empty_province_list' | 'empty_commune_list' | 'empty_district_list' | 'invalid_province_id' | 'invalid_commune_id' | 'invalid_query' | 'address_missing_province' | 'address_ambiguous_province';
+/** Result wrapper — discriminated union. */
+export interface GeoResult<T> {
+    data: T;
+    error?: undefined;
+}
+export interface GeoErrorResult {
+    data: null;
+    error: GeoError;
+}
+/** A resolved component in an address lookup. */
+export interface AddressComponent {
+    id: string | null;
+    name: string | null;
+    type: 'province' | 'district' | 'commune' | 'hamlet';
+}
+/** Result of addressLookup() — shows both legacy (63 tỉnh) and v3 (34 tỉnh) paths. */
+export interface AddressLookupResult {
+    legacy: {
+        province: GeoUnit | null;
+        district: GeoUnit | null;
+        commune: GeoUnit | null;
+        hamlet: string | null;
+    };
+    v3: {
+        province: GeoUnit | null;
+        commune: GeoUnit | null;
+        hamlet: string | null;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAChB,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,0BAA0B,GAC1B,4BAA4B,CAAC;AAEjC,4CAA4C;AAC5C,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;CACtD;AAED,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QACN,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;QACzB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;QACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,EAAE,EAAE;QACF,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;QACzB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;QACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@0xd33p/vietnam-divisions",
+  "version": "0.2.0",
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Vietnam administrative divisions — raw seed data + sync helpers (34 provinces, 3,321 communes, v3)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "dev": "tsx --watch src/index.ts",
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "catalog:",
+    "tsx": "^4.22.4",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  }
+}