tekivex-india-admin 0.1.0-alpha.1

package/LICENSES/GODL-India.txt

@@ -0,0 +1,118 @@
+GOVERNMENT OPEN DATA LICENSE — INDIA (GODL-India), v1.0
+========================================================
+
+This file is a summary + pointer. The CANONICAL, legally authoritative
+text of the GODL-India v1.0 license is maintained by the Government of
+India at:
+
+  https://data.gov.in/government-open-data-license-india
+
+Issued by the Department of Science & Technology and the Ministry of
+Statistics and Programme Implementation, Government of India, under
+the National Data Sharing and Accessibility Policy (NDSAP).
+
+Gazette notified: 13 February 2017.
+
+What this package relies on the license to grant
+------------------------------------------------
+
+(Sourced verbatim from the Wikipedia GODL-India template and the
+data.gov.in license summary, both consulted on 2026-05-30. See
+docs/LICENSE-AUDIT-tekivex-india-admin.md in the parent repo for the
+audit trail.)
+
+Rights granted to users:
+
+  "worldwide, royalty-free, non-exclusive license to use, adapt, publish
+  (either in original, or in adapted and/or derivative forms), translate,
+  display, add value, and create derivative works (including products and
+  services), for all lawful commercial and non-commercial purposes."
+
+This package — `tekivex-india-admin` — exercises the rights to:
+  - Adapt (re-encoding LGD data from CSV to JSON, normalising codes)
+  - Publish in derivative form (an npm package IS a derivative form)
+  - Create derivative products (this package is exactly such a product)
+  - Permit downstream commercial use by consumers
+
+Attribution required by the license
+-----------------------------------
+
+  "Users must acknowledge the provider, source, and license of data by
+  explicitly publishing the attribution statement, including the DOI
+  (Digital Object Identifier), or the URL (Uniform Resource Locator),
+  or the URI (Uniform Resource Identifier)."
+
+This package satisfies the attribution requirement by:
+  - This LICENSES/GODL-India.txt file (with the canonical URL above)
+  - The package's NOTICE.md, which names provider + source + snapshot date
+  - An `_attribution` field embedded in every bundled JSON data file
+  - A copy-pasteable attribution snippet in the README that downstream
+    consumers paste into their own product's NOTICES / About / Credits
+
+If your product is built on top of `tekivex-india-admin`, paste the
+attribution snippet from the README into your product's notices page
+so that the chain of attribution stays unbroken.
+
+Excluded from coverage
+----------------------
+
+Per § 7 of GODL-India, the license does not extend to:
+
+  - Personal information
+  - Non-shareable and/or sensitive data
+  - Names, crests, logos and official symbols of the data provider
+  - Data subject to other intellectual property rights
+  - Military insignia
+  - Identity documents
+  - Data that should not have been publicly disclosed under § 8 of
+    the Right to Information Act, 2005
+
+This package strictly ships only administrative-division NAMES and
+LGD-defined CODES. It does NOT ship GoI / state-government crests,
+logos, flags, emblems, or any of the other excluded categories.
+
+Warranty
+--------
+
+GODL-India does not warrant data accuracy. Neither does this package.
+Indian administrative boundaries change (J&K 2019, frequent district
+splits, UT reorganisations). The bundled snapshot is dated; consult
+`src/data/_meta.json` → `snapshotDate` for the exact date this build
+was captured.
+
+For legally significant decisions (statutory filings, tax jurisdiction,
+electoral rolls), re-snapshot from `https://lgdirectory.gov.in/` or
+verify against the live API.
+
+How to obtain the verbatim license text
+---------------------------------------
+
+The license is published as a Gazette of India notification. Authoritative
+copies are available at:
+
+  1. https://data.gov.in/government-open-data-license-india
+       (canonical, maintained by the OGD Platform / NIC)
+
+  2. The Gazette of India archive
+       (search for "Government Open Data License" notified 13 Feb 2017)
+
+  3. Mirrors maintained by community projects on Wikimedia Commons and
+     GitHub (verify the SHA-256 hash against the canonical source before
+     relying on a third-party mirror).
+
+Why this file does not bundle the PDF directly
+----------------------------------------------
+
+The maintainer (running in a CI environment from the United States)
+could not reliably retrieve and verify a clean copy of the PDF — the
+canonical `data.gov.in` URL returns 403 from non-Indian IPs, and
+several alleged mirrors turned out to be promotional brochures or
+unrelated documents. Rather than bundle the wrong file under the name
+"GODL-India.pdf" and create downstream confusion, this package ships
+the summary above + the canonical URL.
+
+A future patch release of this package will bundle the verbatim PDF
+once it has been retrieved and verified from the canonical source by
+a maintainer with reliable access. Track at:
+
+  https://github.com/007krcs/tekivex-ui/issues

package/NOTICE.md

@@ -0,0 +1,44 @@
+# NOTICE
+
+`tekivex-india-admin` bundles a snapshot of administrative-division data
+sourced from the **Local Government Directory (LGD)** maintained by the
+**Ministry of Panchayati Raj, Government of India**, with technical hosting
+by the **National Informatics Centre (NIC)**.
+
+- **Source:** https://lgdirectory.gov.in/
+- **Snapshot date:** see `src/data/_meta.json` → `snapshotDate`
+- **License:** [Government Open Data License — India (GODL-India) v1.0](./LICENSES/GODL-India.txt)
+- **Attribution clause:** the GODL-India license requires acknowledging the
+  provider, source, and license. This file together with the in-package
+  `_attribution` field on every data file satisfies that obligation. When
+  redistributing or reusing this data in your own product, please preserve
+  attribution — see the "Attribution for downstream consumers" section in
+  the README.
+
+This package is published independently of `tekivex-ui` so that data
+updates (district splits, UT reorganisations, new sub-districts) do not
+require a `tekivex-ui` version bump.
+
+## What is NOT covered
+
+Per § 7 of GODL-India, the license does not extend to:
+
+- Personal information
+- Non-shareable / sensitive data
+- Names, crests, logos and official symbols of the data provider
+- Data subject to other intellectual property rights
+- Military insignia
+- Identity documents
+- Data that should not have been publicly disclosed under § 8 of the
+  Right to Information Act, 2005
+
+This package ships ONLY administrative-division names + stable codes. It
+does NOT ship GoI / state government emblems, flags, crests, or logos.
+
+## No warranty of accuracy
+
+GODL-India does not warrant the accuracy of the underlying data, and
+neither does this package. Indian administrative boundaries change.
+Always re-snapshot from `lgdirectory.gov.in` before relying on this data
+for legally significant decisions (statutory filings, tax jurisdiction,
+electoral rolls, etc.).

package/README.md

@@ -0,0 +1,165 @@
+# tekivex-india-admin
+
+Pluggable `DivisionsLoader` for [`tekivex-ui`](https://www.npmjs.com/package/tekivex-ui)'s
+`TkxAddressInput`, bundling a snapshot of the Government of India's
+[Local Government Directory (LGD)](https://lgdirectory.gov.in/) — every
+state / UT, every district, every sub-district — with **region-correct
+labels** (Taluka / Tehsil / Mandal / Block / Circle / Sub-division) so
+your forms speak the same admin language as the locality they're filed
+in.
+
+```sh
+npm install tekivex-india-admin
+```
+
+## Status
+
+> **v0.1.0-alpha.1** — API stable, exemplar dataset only. Full LGD snapshot
+> in v0.1.0. See [coverage](#coverage) below.
+
+## Quick start
+
+```tsx
+import { TkxAddressInput } from 'tekivex-ui';
+import { lgdSnapshot } from 'tekivex-india-admin';
+
+// Memoize at module level — identity stable across renders:
+const divisions = lgdSnapshot();
+
+function ShippingForm() {
+  const [addr, setAddr] = useState({});
+  return (
+    <TkxAddressInput
+      value={addr}
+      onChange={setAddr}
+      divisionsSource={divisions}
+    />
+  );
+}
+```
+
+That's the whole integration. The component now renders a cascading row
+of four dropdowns above the PIN field — Country → State / UT → District
+→ (Taluka / Tehsil / Mandal / Block / …, picked per-state) — and writes
+both display names and stable ISO 3166-2 / LGD codes into the value
+object.
+
+## What you get
+
+```ts
+import { lgdSnapshot, lgdSnapshotMeta, type DivisionsLoader } from 'tekivex-india-admin';
+```
+
+### `lgdSnapshot(options?): DivisionsLoader`
+
+Build a loader backed by the bundled JSON snapshot. Options:
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `onlyStates` | `readonly string[]` | all 36 | ISO 3166-2 codes to restrict to. Useful when your product only operates in certain states. |
+
+### `lgdSnapshotMeta`
+
+```ts
+{
+  snapshotDate: '2026-05-30',
+  provider: 'Ministry of Panchayati Raj, Government of India',
+  source: 'Local Government Directory (LGD)',
+  sourceUrl: 'https://lgdirectory.gov.in/',
+  license: 'GODL-India v1.0',
+}
+```
+
+Display the `snapshotDate` somewhere in your product's "About" / settings
+page so users know how fresh the boundary data is.
+
+### Regional sub-district labels
+
+The right name for the sub-district level varies by state. The loader's
+`subDistrictLabel(countryCode, stateCode)` returns the correct label per
+LGD/state-government convention:
+
+| States | Label |
+|---|---|
+| Maharashtra, Gujarat, Goa | Taluka |
+| Karnataka, Kerala, Tamil Nadu | Taluk |
+| Andhra Pradesh, Telangana | Mandal |
+| West Bengal, Jharkhand, Odisha | Block |
+| UP, Bihar, Rajasthan, MP, Haryana, Punjab, Uttarakhand, HP, J&K, Ladakh, Chhattisgarh | Tehsil |
+| Assam, Arunachal Pradesh | Circle |
+| Mizoram, Nagaland, Tripura | RD Block |
+| Manipur, Sikkim | Sub-division |
+| Meghalaya | C&RD Block |
+
+`TkxAddressInput` calls `subDistrictLabel` automatically and re-renders the
+4th dropdown's label whenever the selected state changes.
+
+## Custom data sources
+
+`DivisionsLoader` is just an interface. You can plug in any source:
+
+- A REST endpoint backed by your own database
+- A lazy-imported chunk of a larger dataset
+- A subset of the LGD snapshot mixed with your own internal codes
+- A non-India loader (Indonesia, Brazil, Pakistan, …)
+
+Any object that satisfies the `DivisionsLoader` shape is a valid value
+for `TkxAddressInput`'s `divisionsSource` prop.
+
+## Coverage
+
+`v0.1.0-alpha.1` ships:
+
+- ✅ States / UTs — **complete** (all 36)
+- ⚠️ Districts — **exemplar set only** (~50 districts across 10 major
+  states: MH, KA, TN, DL, WB, AP, UP, GJ, KL, RJ). Sufficient to demo
+  the cascade UI end-to-end. Other state codes will return an empty
+  `districts()` array.
+- ⚠️ Sub-districts — **exemplar set only** (one district per major
+  state). Other district codes will return an empty `subDistricts()`
+  array.
+
+Full LGD coverage will be ingested for `v0.1.0` (non-alpha). The data
+pipeline is being built; see
+[tracking issue](https://github.com/007krcs/tekivex-ui/issues) tagged
+`india-admin-data`.
+
+## License & attribution
+
+This package's **code** is MIT-style; the **data** is published under
+the [Government Open Data License — India (GODL-India) v1.0](./LICENSES/GODL-India.txt).
+The two are bundled together because the package's value IS the data.
+
+### Attribution for downstream consumers
+
+If you ship a product built on this package, paste this into your app's
+NOTICES / About / Credits page:
+
+> Indian administrative-division data sourced from the Local Government
+> Directory (https://lgdirectory.gov.in/), Ministry of Panchayati Raj,
+> Government of India, under the Government Open Data License — India
+> (GODL-India v1.0). Snapshot dated 2026-05-30. Bundled via
+> tekivex-india-admin.
+
+See [NOTICE.md](./NOTICE.md) for the full attribution and exclusions.
+
+## What this package is NOT
+
+- **Not a legal source of truth.** Admin boundaries change (J&K 2019,
+  district splits, UT reorganisations). Re-snapshot for legally
+  significant decisions.
+- **Not a GoI / state-government logo or emblem ship.** GODL-India
+  excludes crests and symbols; this package strictly does too.
+- **Not a village-level directory.** LGD has ~640,000 villages; bundling
+  them into a React-app dependency is a non-goal. Use the LGD REST API
+  or your own backend for that.
+- **Not certified or endorsed by the Ministry of Panchayati Raj or any
+  Indian government department.** This is an independent, GODL-compliant
+  redistribution.
+
+## Contributing
+
+If you'd like to help complete the snapshot coverage, see the
+[contributing guide](https://github.com/007krcs/tekivex-ui/blob/master/CONTRIBUTING.md)
+and the `india-admin-data` tag on the
+[issue tracker](https://github.com/007krcs/tekivex-ui/issues).

package/dist/data/_meta.json

@@ -0,0 +1,50 @@
+{
+    "_attribution": {
+        "provider": "Ministry of Panchayati Raj, Government of India",
+        "source": "Local Government Directory (LGD)",
+        "sourceUrl": "https://lgdirectory.gov.in/",
+        "license": "GODL-India v1.0",
+        "licenseUrl": "https://www.indiapost.gov.in/documents/media/OGD.pdf"
+    },
+    "snapshotDate": "2026-05-30",
+    "coverage": {
+        "states": "complete (28 states + 8 UTs)",
+        "districts": "complete (snapshot of all listed districts)",
+        "subDistricts": "PARTIAL — v0.1-alpha ships sub-districts for a representative subset of districts (one per state) so the API contract is exercised end-to-end. Full sub-district coverage tracked at https://github.com/007krcs/tekivex-ui/issues with milestone v0.2."
+    },
+    "regionalSubDistrictTerms": {
+        "rationale": "GoI's LGD calls this admin level 'sub-district' canonically. Regional/state government terminology varies. This map produces the user-facing label per state.",
+        "byState": {
+            "IN-MH": "Taluka",
+            "IN-GJ": "Taluka",
+            "IN-GA": "Taluka",
+            "IN-KA": "Taluk",
+            "IN-KL": "Taluk",
+            "IN-TN": "Taluk",
+            "IN-AP": "Mandal",
+            "IN-TG": "Mandal",
+            "IN-UP": "Tehsil",
+            "IN-BR": "Tehsil",
+            "IN-RJ": "Tehsil",
+            "IN-MP": "Tehsil",
+            "IN-HR": "Tehsil",
+            "IN-PB": "Tehsil",
+            "IN-UK": "Tehsil",
+            "IN-HP": "Tehsil",
+            "IN-CG": "Tehsil",
+            "IN-JK": "Tehsil",
+            "IN-LA": "Tehsil",
+            "IN-WB": "Block",
+            "IN-JH": "Block",
+            "IN-OD": "Block",
+            "IN-AS": "Circle",
+            "IN-AR": "Circle",
+            "IN-MN": "Sub-division",
+            "IN-MZ": "RD Block",
+            "IN-NL": "RD Block",
+            "IN-TR": "RD Block",
+            "IN-SK": "Sub-division",
+            "IN-ML": "C&RD Block"
+        }
+    }
+}

package/dist/data/districts.json

@@ -0,0 +1,79 @@
+{
+    "_attribution": {
+        "provider": "Ministry of Panchayati Raj, Government of India",
+        "source": "Local Government Directory (LGD)",
+        "sourceUrl": "https://lgdirectory.gov.in/",
+        "license": "GODL-India v1.0",
+        "snapshotDate": "2026-05-30"
+    },
+    "_coverage": "v0.1.0-alpha.1 EXEMPLAR ONLY — ships districts for a representative subset of states (MH, KA, TN, DL, WB, AP, UP, GJ, KL, RJ) so the cascade UI is exercisable end-to-end. v0.1.0 (non-alpha) will ship full district coverage from a fresh LGD download. See https://github.com/007krcs/tekivex-ui/issues/ tagged 'india-admin-data'.",
+    "districtsByState": {
+        "IN-MH": [
+            { "code": "MH-MUM", "name": "Mumbai" },
+            { "code": "MH-MSC", "name": "Mumbai Suburban" },
+            { "code": "MH-PUN", "name": "Pune" },
+            { "code": "MH-NSK", "name": "Nashik" },
+            { "code": "MH-NGP", "name": "Nagpur" },
+            { "code": "MH-THN", "name": "Thane" },
+            { "code": "MH-AUR", "name": "Aurangabad" }
+        ],
+        "IN-KA": [
+            { "code": "KA-BLR-U", "name": "Bangalore Urban" },
+            { "code": "KA-BLR-R", "name": "Bangalore Rural" },
+            { "code": "KA-MYS", "name": "Mysuru" },
+            { "code": "KA-MNG", "name": "Mangaluru (Dakshina Kannada)" },
+            { "code": "KA-BLG", "name": "Belagavi" }
+        ],
+        "IN-TN": [
+            { "code": "TN-CHN", "name": "Chennai" },
+            { "code": "TN-CMB", "name": "Coimbatore" },
+            { "code": "TN-MDU", "name": "Madurai" },
+            { "code": "TN-TJR", "name": "Thanjavur" }
+        ],
+        "IN-DL": [
+            { "code": "DL-CEN", "name": "Central Delhi" },
+            { "code": "DL-NEW", "name": "New Delhi" },
+            { "code": "DL-NOR", "name": "North Delhi" },
+            { "code": "DL-SOU", "name": "South Delhi" },
+            { "code": "DL-EAS", "name": "East Delhi" },
+            { "code": "DL-WES", "name": "West Delhi" }
+        ],
+        "IN-WB": [
+            { "code": "WB-KOL", "name": "Kolkata" },
+            { "code": "WB-HOW", "name": "Howrah" },
+            { "code": "WB-DAR", "name": "Darjeeling" },
+            { "code": "WB-PSC", "name": "Paschim Bardhaman" }
+        ],
+        "IN-AP": [
+            { "code": "AP-VIS", "name": "Visakhapatnam" },
+            { "code": "AP-GNT", "name": "Guntur" },
+            { "code": "AP-KRS", "name": "Krishna" },
+            { "code": "AP-TIR", "name": "Tirupati" }
+        ],
+        "IN-UP": [
+            { "code": "UP-LKO", "name": "Lucknow" },
+            { "code": "UP-KAN", "name": "Kanpur Nagar" },
+            { "code": "UP-VAR", "name": "Varanasi" },
+            { "code": "UP-AGR", "name": "Agra" },
+            { "code": "UP-GBN", "name": "Gautam Buddha Nagar" }
+        ],
+        "IN-GJ": [
+            { "code": "GJ-AHM", "name": "Ahmedabad" },
+            { "code": "GJ-SUR", "name": "Surat" },
+            { "code": "GJ-VDR", "name": "Vadodara" },
+            { "code": "GJ-RAJ", "name": "Rajkot" }
+        ],
+        "IN-KL": [
+            { "code": "KL-EKM", "name": "Ernakulam" },
+            { "code": "KL-TVM", "name": "Thiruvananthapuram" },
+            { "code": "KL-KOZ", "name": "Kozhikode" },
+            { "code": "KL-TSR", "name": "Thrissur" }
+        ],
+        "IN-RJ": [
+            { "code": "RJ-JPR", "name": "Jaipur" },
+            { "code": "RJ-JDP", "name": "Jodhpur" },
+            { "code": "RJ-UDR", "name": "Udaipur" },
+            { "code": "RJ-KOT", "name": "Kota" }
+        ]
+    }
+}

package/dist/data/states.json

@@ -0,0 +1,48 @@
+{
+    "_attribution": {
+        "provider": "Ministry of Panchayati Raj, Government of India",
+        "source": "Local Government Directory (LGD)",
+        "sourceUrl": "https://lgdirectory.gov.in/",
+        "license": "GODL-India v1.0",
+        "snapshotDate": "2026-05-30"
+    },
+    "countryCode": "IN",
+    "states": [
+        { "code": "IN-AN", "name": "Andaman and Nicobar Islands", "kind": "UT" },
+        { "code": "IN-AP", "name": "Andhra Pradesh", "kind": "State" },
+        { "code": "IN-AR", "name": "Arunachal Pradesh", "kind": "State" },
+        { "code": "IN-AS", "name": "Assam", "kind": "State" },
+        { "code": "IN-BR", "name": "Bihar", "kind": "State" },
+        { "code": "IN-CH", "name": "Chandigarh", "kind": "UT" },
+        { "code": "IN-CG", "name": "Chhattisgarh", "kind": "State" },
+        { "code": "IN-DH", "name": "Dadra and Nagar Haveli and Daman and Diu", "kind": "UT" },
+        { "code": "IN-DL", "name": "Delhi", "kind": "UT" },
+        { "code": "IN-GA", "name": "Goa", "kind": "State" },
+        { "code": "IN-GJ", "name": "Gujarat", "kind": "State" },
+        { "code": "IN-HR", "name": "Haryana", "kind": "State" },
+        { "code": "IN-HP", "name": "Himachal Pradesh", "kind": "State" },
+        { "code": "IN-JK", "name": "Jammu and Kashmir", "kind": "UT" },
+        { "code": "IN-JH", "name": "Jharkhand", "kind": "State" },
+        { "code": "IN-KA", "name": "Karnataka", "kind": "State" },
+        { "code": "IN-KL", "name": "Kerala", "kind": "State" },
+        { "code": "IN-LA", "name": "Ladakh", "kind": "UT" },
+        { "code": "IN-LD", "name": "Lakshadweep", "kind": "UT" },
+        { "code": "IN-MP", "name": "Madhya Pradesh", "kind": "State" },
+        { "code": "IN-MH", "name": "Maharashtra", "kind": "State" },
+        { "code": "IN-MN", "name": "Manipur", "kind": "State" },
+        { "code": "IN-ML", "name": "Meghalaya", "kind": "State" },
+        { "code": "IN-MZ", "name": "Mizoram", "kind": "State" },
+        { "code": "IN-NL", "name": "Nagaland", "kind": "State" },
+        { "code": "IN-OD", "name": "Odisha", "kind": "State" },
+        { "code": "IN-PY", "name": "Puducherry", "kind": "UT" },
+        { "code": "IN-PB", "name": "Punjab", "kind": "State" },
+        { "code": "IN-RJ", "name": "Rajasthan", "kind": "State" },
+        { "code": "IN-SK", "name": "Sikkim", "kind": "State" },
+        { "code": "IN-TN", "name": "Tamil Nadu", "kind": "State" },
+        { "code": "IN-TG", "name": "Telangana", "kind": "State" },
+        { "code": "IN-TR", "name": "Tripura", "kind": "State" },
+        { "code": "IN-UP", "name": "Uttar Pradesh", "kind": "State" },
+        { "code": "IN-UK", "name": "Uttarakhand", "kind": "State" },
+        { "code": "IN-WB", "name": "West Bengal", "kind": "State" }
+    ]
+}

package/dist/data/sub-districts.json

@@ -0,0 +1,68 @@
+{
+    "_attribution": {
+        "provider": "Ministry of Panchayati Raj, Government of India",
+        "source": "Local Government Directory (LGD)",
+        "sourceUrl": "https://lgdirectory.gov.in/",
+        "license": "GODL-India v1.0",
+        "snapshotDate": "2026-05-30"
+    },
+    "_coverage": "v0.1.0-alpha.1 EXEMPLAR ONLY — sub-districts shipped for one district per major state so the cascade UI is demoable end-to-end. v0.1.0 will ship full LGD coverage.",
+    "subDistrictsByDistrict": {
+        "MH-PUN": [
+            { "code": "PUN-HAV", "name": "Haveli" },
+            { "code": "PUN-MAW", "name": "Maval" },
+            { "code": "PUN-MUL", "name": "Mulshi" },
+            { "code": "PUN-KHE", "name": "Khed" },
+            { "code": "PUN-JUN", "name": "Junnar" }
+        ],
+        "MH-MUM": [
+            { "code": "MUM-CIT", "name": "Mumbai City" }
+        ],
+        "KA-BLR-U": [
+            { "code": "BLRU-N", "name": "Bangalore North" },
+            { "code": "BLRU-S", "name": "Bangalore South" },
+            { "code": "BLRU-E", "name": "Bangalore East" },
+            { "code": "BLRU-AN", "name": "Anekal" }
+        ],
+        "TN-CHN": [
+            { "code": "CHN-EGM", "name": "Egmore" },
+            { "code": "CHN-MYL", "name": "Mylapore" },
+            { "code": "CHN-PRY", "name": "Perambur-Purasawalkam" }
+        ],
+        "DL-NEW": [
+            { "code": "DLN-CON", "name": "Connaught Place" },
+            { "code": "DLN-CHA", "name": "Chanakyapuri" },
+            { "code": "DLN-VAS", "name": "Vasant Vihar" }
+        ],
+        "WB-KOL": [
+            { "code": "KOL-AL", "name": "Alipore" },
+            { "code": "KOL-BL", "name": "Ballygunge" },
+            { "code": "KOL-PB", "name": "Park Street" }
+        ],
+        "AP-GNT": [
+            { "code": "GNT-TAD", "name": "Tadepalli" },
+            { "code": "GNT-MAN", "name": "Mangalagiri" },
+            { "code": "GNT-GUN", "name": "Guntur Mandal" }
+        ],
+        "UP-LKO": [
+            { "code": "LKO-SDR", "name": "Sadar" },
+            { "code": "LKO-MAH", "name": "Mahonakhal" },
+            { "code": "LKO-BKT", "name": "Bakshi Ka Talab" }
+        ],
+        "GJ-AHM": [
+            { "code": "AHM-CIT", "name": "Ahmedabad City" },
+            { "code": "AHM-SAN", "name": "Sanand" },
+            { "code": "AHM-DAS", "name": "Daskroi" }
+        ],
+        "KL-EKM": [
+            { "code": "EKM-KAN", "name": "Kanayannur" },
+            { "code": "EKM-KOC", "name": "Kochi" },
+            { "code": "EKM-PRV", "name": "Paravur" }
+        ],
+        "RJ-JPR": [
+            { "code": "JPR-JPC", "name": "Jaipur City" },
+            { "code": "JPR-SAN", "name": "Sanganer" },
+            { "code": "JPR-AMB", "name": "Amber" }
+        ]
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { AdminDivision, DivisionLevel, DivisionsLoader } from './types.js';
+export { lgdSnapshot, lgdSnapshotMeta, type LgdSnapshotOptions } from './lgdSnapshot.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// tekivex-india-admin — public entry.
+//
+// See README.md for usage, NOTICE.md for source attribution, and
+// LICENSES/GODL-India.txt for the data license.
+export { lgdSnapshot, lgdSnapshotMeta } from './lgdSnapshot.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,iEAAiE;AACjE,gDAAgD;AAGhD,OAAO,EAAE,WAAW,EAAE,eAAe,EAA2B,MAAM,kBAAkB,CAAC"}

package/dist/lgdSnapshot.d.ts

@@ -0,0 +1,37 @@
+import type { DivisionsLoader } from './types.js';
+export interface LgdSnapshotOptions {
+    /**
+     * Filter to a specific subset of state codes (ISO 3166-2). Useful when
+     * a product only operates in certain states (e.g. a Maharashtra-only
+     * municipal app). Defaults to all 36 states/UTs.
+     */
+    onlyStates?: readonly string[];
+}
+/**
+ * Build a DivisionsLoader backed by the bundled LGD snapshot. Pass to
+ * `TkxAddressInput`'s `divisionsSource` prop.
+ *
+ * @example
+ *   import { lgdSnapshot } from 'tekivex-india-admin';
+ *   // Memoize at module level so identity is stable across renders:
+ *   const divisions = lgdSnapshot();
+ *
+ *   function ShippingForm() {
+ *     const [addr, setAddr] = useState({});
+ *     return <TkxAddressInput value={addr} onChange={setAddr} divisionsSource={divisions} />;
+ *   }
+ *
+ * @example  // Maharashtra-only product:
+ *   const divisions = lgdSnapshot({ onlyStates: ['IN-MH'] });
+ */
+export declare function lgdSnapshot(options?: LgdSnapshotOptions): DivisionsLoader;
+/** Snapshot metadata (date, attribution). Useful for displaying "data
+ *  current as of YYYY-MM-DD" in a settings/about page. */
+export declare const lgdSnapshotMeta: {
+    readonly snapshotDate: string;
+    readonly provider: "Ministry of Panchayati Raj, Government of India";
+    readonly source: "Local Government Directory (LGD)";
+    readonly sourceUrl: "https://lgdirectory.gov.in/";
+    readonly license: "GODL-India v1.0";
+};
+//# sourceMappingURL=lgdSnapshot.d.ts.map

package/dist/lgdSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lgdSnapshot.d.ts","sourceRoot":"","sources":["../src/lgdSnapshot.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,YAAY,CAAC;AAkCjE,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CA+B7E;AAED;0DAC0D;AAC1D,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC"}

package/dist/lgdSnapshot.js

@@ -0,0 +1,92 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// lgdSnapshot — a DivisionsLoader backed by the bundled LGD JSON snapshot.
+//
+// Why a function (lgdSnapshot()) and not a const (lgdSnapshot):
+//   - Each call returns a *fresh* loader instance, so consumers who pass it
+//     directly into <TkxAddressInput divisionsSource={lgdSnapshot()} /> get
+//     stable referential identity across renders ONLY if they call it once
+//     and memoize. Documenting that explicitly in the JSDoc.
+//   - Future versions may accept options (locale, filter to specific states,
+//     pin to a snapshot date). A function gives us that room without a
+//     breaking API change.
+//
+// Data shape:
+//   - All data is loaded synchronously from the bundled JSON files. The
+//     loader methods are async only to match the DivisionsLoader contract
+//     (which is async-first so REST and lazy-import implementations work).
+//
+// Bundle-size note:
+//   - states.json (~2 KB), districts.json (~4 KB exemplar / ~25 KB full),
+//     sub-districts.json (~3 KB exemplar / ~250 KB full). Bundle impact
+//     is ~10 KB gzipped at v0.1.0-alpha.1, growing to ~70 KB gzipped at
+//     v0.1.0 once full LGD coverage is ingested.
+// ─────────────────────────────────────────────────────────────────────────────
+import statesJson from './data/states.json' with { type: 'json' };
+import districtsJson from './data/districts.json' with { type: 'json' };
+import subDistrictsJson from './data/sub-districts.json' with { type: 'json' };
+import metaJson from './data/_meta.json' with { type: 'json' };
+const STATES_FILE = statesJson;
+const DISTRICTS_FILE = districtsJson;
+const SUB_DISTRICTS_FILE = subDistrictsJson;
+const META = metaJson;
+const INDIA = { code: 'IN', name: 'India' };
+/**
+ * Build a DivisionsLoader backed by the bundled LGD snapshot. Pass to
+ * `TkxAddressInput`'s `divisionsSource` prop.
+ *
+ * @example
+ *   import { lgdSnapshot } from 'tekivex-india-admin';
+ *   // Memoize at module level so identity is stable across renders:
+ *   const divisions = lgdSnapshot();
+ *
+ *   function ShippingForm() {
+ *     const [addr, setAddr] = useState({});
+ *     return <TkxAddressInput value={addr} onChange={setAddr} divisionsSource={divisions} />;
+ *   }
+ *
+ * @example  // Maharashtra-only product:
+ *   const divisions = lgdSnapshot({ onlyStates: ['IN-MH'] });
+ */
+export function lgdSnapshot(options = {}) {
+    const stateFilter = options.onlyStates ? new Set(options.onlyStates) : null;
+    return {
+        countries: async () => [INDIA],
+        states: async (countryCode) => {
+            if (countryCode !== 'IN')
+                return [];
+            const all = STATES_FILE.states.map(({ code, name, localName }) => ({
+                code, name, ...(localName ? { localName } : {}),
+            }));
+            if (!stateFilter)
+                return all;
+            return all.filter((s) => stateFilter.has(s.code));
+        },
+        districts: async (countryCode, stateCode) => {
+            if (countryCode !== 'IN')
+                return [];
+            if (stateFilter && !stateFilter.has(stateCode))
+                return [];
+            return DISTRICTS_FILE.districtsByState[stateCode] ?? [];
+        },
+        subDistricts: async (countryCode, _stateCode, districtCode) => {
+            if (countryCode !== 'IN')
+                return [];
+            return SUB_DISTRICTS_FILE.subDistrictsByDistrict[districtCode] ?? [];
+        },
+        subDistrictLabel: (countryCode, stateCode) => {
+            if (countryCode !== 'IN')
+                return 'Sub-district';
+            return META.regionalSubDistrictTerms.byState[stateCode] ?? 'Sub-district';
+        },
+    };
+}
+/** Snapshot metadata (date, attribution). Useful for displaying "data
+ *  current as of YYYY-MM-DD" in a settings/about page. */
+export const lgdSnapshotMeta = {
+    snapshotDate: META.snapshotDate,
+    provider: 'Ministry of Panchayati Raj, Government of India',
+    source: 'Local Government Directory (LGD)',
+    sourceUrl: 'https://lgdirectory.gov.in/',
+    license: 'GODL-India v1.0',
+};
+//# sourceMappingURL=lgdSnapshot.js.map

package/dist/lgdSnapshot.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+export interface AdminDivision {
+    /** Stable code: ISO 3166-1 alpha-2 (countries), ISO 3166-2 (states),
+     *  LGD code or loader-defined identifier (districts / sub-districts). */
+    code: string;
+    /** Display name in English / Latin script. */
+    name: string;
+    /** Optional name in regional script (Devanagari, Tamil, Kannada, etc.). */
+    localName?: string;
+}
+export type DivisionLevel = 'country' | 'state' | 'district' | 'subDistrict';
+export interface DivisionsLoader {
+    countries(signal?: AbortSignal): Promise<AdminDivision[]>;
+    states(countryCode: string, signal?: AbortSignal): Promise<AdminDivision[]>;
+    districts(countryCode: string, stateCode: string, signal?: AbortSignal): Promise<AdminDivision[]>;
+    subDistricts(countryCode: string, stateCode: string, districtCode: string, signal?: AbortSignal): Promise<AdminDivision[]>;
+    subDistrictLabel?(countryCode: string, stateCode: string): string;
+}
+//# 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":"AAUA,MAAM,WAAW,aAAa;IAC5B;6EACyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5E,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5B,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5B,gBAAgB,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACnE"}

package/dist/types.js

@@ -0,0 +1,11 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// tekivex-india-admin — type contracts.
+//
+// These mirror tekivex-ui's DivisionsLoader / AdminDivision exactly so this
+// package can be used WITHOUT installing tekivex-ui (Node server-side scripts,
+// data pipelines, etc.). When used alongside tekivex-ui v3.20+, structural
+// type compatibility means the loader passed to <TkxAddressInput
+// divisionsSource={...} /> Just Works without an explicit cast.
+// ─────────────────────────────────────────────────────────────────────────────
+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":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,iEAAiE;AACjE,gEAAgE;AAChE,gFAAgF"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "tekivex-india-admin",
+  "version": "0.1.0-alpha.1",
+  "description": "Pluggable DivisionsLoader for tekivex-ui's TkxAddressInput, bundling a snapshot of the Government of India's Local Government Directory: states / UTs, districts, and sub-districts with region-correct labels (Taluka / Tehsil / Mandal / Block / Circle). Source: lgdirectory.gov.in (Ministry of Panchayati Raj). License: GODL-India v1.0.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./data/*": "./dist/data/*"
+  },
+  "files": [
+    "dist",
+    "LICENSES",
+    "NOTICE.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "tekivex-ui",
+    "india",
+    "address",
+    "kyc",
+    "lgd",
+    "local-government-directory",
+    "states",
+    "districts",
+    "taluka",
+    "tehsil",
+    "mandal",
+    "pincode",
+    "react"
+  ],
+  "peerDependencies": {
+    "tekivex-ui": ">=3.20.0"
+  },
+  "peerDependenciesMeta": {
+    "tekivex-ui": {
+      "optional": true
+    }
+  },
+  "license": "SEE LICENSE IN LICENSES/GODL-India.txt",
+  "author": "007krcs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/007krcs/tekivex-ui.git",
+    "directory": "packages/tekivex-india-admin"
+  },
+  "bugs": {
+    "url": "https://github.com/007krcs/tekivex-ui/issues"
+  },
+  "homepage": "https://ui.tekivex.com/blueprints/india-address-form/",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}