@ruhlabs/atolls 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruh Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# @ruhlabs/atolls
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Maldives' 20 administrative atolls and 5 cities as typed data, with lookup and address helpers. No dependencies, works in Node and the browser.
+
+```bash
+npm install @ruhlabs/atolls
+```
+
+## Usage
+
+```ts
+import { ATOLLS, CITIES, getAtoll, parseIslandAddress, formatIslandAddress } from '@ruhlabs/atolls';
+
+getAtoll('Haa Alif');
+// {
+//   code: "HA", codeThaana: "ހއ", codeName: "Haa Alifu",
+//   officialName: "Thiladhunmathi Uthuruburi", latinLetter: "A",
+//   iso: "MV-07", capital: "Dhidhdhoo", aliases: ["Haa Alif"]
+// }
+
+// Any name or code works: "HA", "ha", "Haa Alif Atoll", "ހއ", "MV-07", "Thiladhunmathi Uthuruburi"
+getAtoll('Gaaf Dhaal')?.capital; // "Thinadhoo"
+
+parseIslandAddress('B. Eydhafushi'); // { atoll: { code: "B", ... }, island: "Eydhafushi" }
+parseIslandAddress('ބ. އޭދަފުށި'); // works with Thaana codes too
+
+formatIslandAddress('Baa', 'Eydhafushi'); // "B. Eydhafushi"
+formatIslandAddress('B', 'އޭދަފުށި', { thaana: true }); // "ބ. އޭދަފުށި"
+
+ATOLLS.map((a) => a.code); // ["HA", "HDh", "Sh", ..., "Gn", "S"], north to south
+CITIES; // Malé, Addu, Fuvahmulah, Kulhudhuffushi, Thinadhoo
+```
+
+Use it for atoll dropdowns, cleaning up addresses people type in, or showing atolls in Dhivehi.
+
+## Data
+
+Atoll codes, official names, ISO 3166-2 codes and capitals follow Wikipedia's *Administrative divisions of the Maldives* (2026) and ISO 3166-2:MV. Please open an issue if anything has changed.
+
+## License
+
+MIT © Ruh Labs

package/dist/index.cjs

@@ -0,0 +1,99 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ATOLLS: () => ATOLLS,
+  CITIES: () => CITIES,
+  formatIslandAddress: () => formatIslandAddress,
+  getAtoll: () => getAtoll,
+  getCity: () => getCity,
+  parseIslandAddress: () => parseIslandAddress
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/data.ts
+var ATOLLS = [
+  { code: "HA", codeThaana: "\u0780\u0787", codeName: "Haa Alifu", officialName: "Thiladhunmathi Uthuruburi", latinLetter: "A", iso: "MV-07", capital: "Dhidhdhoo", aliases: ["Haa Alif"] },
+  { code: "HDh", codeThaana: "\u0780\u078B", codeName: "Haa Dhaalu", officialName: "Thiladhunmathi Dhekunuburi", latinLetter: "B", iso: "MV-23", capital: "Kulhudhuffushi", aliases: ["Haa Dhaal"] },
+  { code: "Sh", codeThaana: "\u0781", codeName: "Shaviyani", officialName: "Miladhunmadulu Uthuruburi", latinLetter: "C", iso: "MV-24", capital: "Funadhoo", aliases: [] },
+  { code: "N", codeThaana: "\u0782", codeName: "Noonu", officialName: "Miladhunmadulu Dhekunuburi", latinLetter: "D", iso: "MV-25", capital: "Manadhoo", aliases: [] },
+  { code: "R", codeThaana: "\u0783", codeName: "Raa", officialName: "Maalhosmadulu Uthuruburi", latinLetter: "E", iso: "MV-13", capital: "Ungoofaaru", aliases: [] },
+  { code: "B", codeThaana: "\u0784", codeName: "Baa", officialName: "Maalhosmadulu Dhekunuburi", latinLetter: "F", iso: "MV-20", capital: "Eydhafushi", aliases: [] },
+  { code: "Lh", codeThaana: "\u0785", codeName: "Lhaviyani", officialName: "Faadhippolhu", latinLetter: "G", iso: "MV-03", capital: "Naifaru", aliases: [] },
+  { code: "K", codeThaana: "\u0786", codeName: "Kaafu", officialName: "Mal\xE9 Atholhu", latinLetter: "H", iso: "MV-26", capital: "Thulusdhoo", aliases: [] },
+  { code: "AA", codeThaana: "\u0787\u0787", codeName: "Alifu Alifu", officialName: "Ari Atholhu Uthuruburi", latinLetter: "U", iso: "MV-02", capital: "Rasdhoo", aliases: ["Alif Alif"] },
+  { code: "ADh", codeThaana: "\u0787\u078B", codeName: "Alifu Dhaalu", officialName: "Ari Atholhu Dhekunuburi", latinLetter: "I", iso: "MV-00", capital: "Mahibadhoo", aliases: ["Alif Dhaal", "Alif Dhaalu"] },
+  { code: "V", codeThaana: "\u0788", codeName: "Vaavu", officialName: "Felidhu Atholhu", latinLetter: "J", iso: "MV-04", capital: "Felidhoo", aliases: [] },
+  { code: "M", codeThaana: "\u0789", codeName: "Meemu", officialName: "Mulak Atholhu", latinLetter: "K", iso: "MV-12", capital: "Muli", aliases: [] },
+  { code: "F", codeThaana: "\u078A", codeName: "Faafu", officialName: "Nilandhe Atholhu Uthuruburi", latinLetter: "L", iso: "MV-14", capital: "Nilandhoo", aliases: [] },
+  { code: "Dh", codeThaana: "\u078B", codeName: "Dhaalu", officialName: "Nilandhe Atholhu Dhekunuburi", latinLetter: "M", iso: "MV-17", capital: "Kudahuvadhoo", aliases: [] },
+  { code: "Th", codeThaana: "\u078C", codeName: "Thaa", officialName: "Kolhumadulu", latinLetter: "N", iso: "MV-08", capital: "Veymandoo", aliases: [] },
+  { code: "L", codeThaana: "\u078D", codeName: "Laamu", officialName: "Haddhunmathi", latinLetter: "O", iso: "MV-05", capital: "Fonadhoo", aliases: [] },
+  { code: "GA", codeThaana: "\u078E\u0787", codeName: "Gaafu Alifu", officialName: "Huvadhu Atholhu Uthuruburi", latinLetter: "P", iso: "MV-27", capital: "Villingili", aliases: ["Gaafu Alif", "Gaaf Alif"] },
+  { code: "GDh", codeThaana: "\u078E\u078B", codeName: "Gaafu Dhaalu", officialName: "Huvadhu Atholhu Dhekunuburi", latinLetter: "Q", iso: "MV-28", capital: "Thinadhoo", aliases: ["Gaaf Dhaal", "Gaafu Dhaal"] },
+  { code: "Gn", codeThaana: "\u078F", codeName: "Gnaviyani", officialName: "Fuvahmulah City", latinLetter: "R", iso: "MV-29", capital: "Fuvahmulah", aliases: [] },
+  { code: "S", codeThaana: "\u0790", codeName: "Seenu", officialName: "Addu City", latinLetter: "S", iso: "MV-01", capital: "Hithadhoo", aliases: ["Addu"] }
+];
+var CITIES = [
+  { name: "Mal\xE9", atoll: null, iso: "MV-MLE" },
+  { name: "Addu", atoll: "S" },
+  { name: "Fuvahmulah", atoll: "Gn" },
+  { name: "Kulhudhuffushi", atoll: "HDh" },
+  { name: "Thinadhoo", atoll: "GDh" }
+];
+
+// src/index.ts
+var normalize = (value) => value.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/\b(atoll|atholhu)\b/g, "").replace(/[^a-z0-9ހ-ޱ]/g, "");
+var lookup = /* @__PURE__ */ new Map();
+for (const atoll of ATOLLS) {
+  for (const key of [atoll.code, atoll.codeThaana, atoll.codeName, atoll.officialName, atoll.iso, ...atoll.aliases]) {
+    lookup.set(normalize(key), atoll);
+  }
+}
+function getAtoll(query) {
+  return lookup.get(normalize(query));
+}
+function getCity(name) {
+  const key = normalize(name.replace(/\bcity\b/i, ""));
+  return CITIES.find((city) => normalize(city.name) === key);
+}
+function parseIslandAddress(input) {
+  const match = /^\s*([^\s.]+)\s*[.\s]\s*(.+?)\s*$/u.exec(input);
+  if (!match) return void 0;
+  const [, code, island] = match;
+  const atoll = getAtoll(code);
+  return atoll ? { atoll, island } : void 0;
+}
+function formatIslandAddress(atoll, island, options = {}) {
+  const found = typeof atoll === "string" ? getAtoll(atoll) : atoll;
+  if (!found) throw new Error(`Unknown atoll: ${atoll}`);
+  return `${options.thaana ? found.codeThaana : found.code}. ${island.trim()}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ATOLLS,
+  CITIES,
+  formatIslandAddress,
+  getAtoll,
+  getCity,
+  parseIslandAddress
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/data.ts"],"sourcesContent":["import { ATOLLS, CITIES, type Atoll, type City } from './data.js';\n\nexport { ATOLLS, CITIES, type Atoll, type City };\n\nconst normalize = (value: string) =>\n\tvalue\n\t\t.normalize('NFD')\n\t\t.replace(/[̀-ͯ]/g, '') // drop accents (Malé → Male)\n\t\t.toLowerCase()\n\t\t.replace(/\\b(atoll|atholhu)\\b/g, '')\n\t\t.replace(/[^a-z0-9ހ-ޱ]/g, '');\n\nconst lookup = new Map<string, Atoll>();\nfor (const atoll of ATOLLS) {\n\tfor (const key of [atoll.code, atoll.codeThaana, atoll.codeName, atoll.officialName, atoll.iso, ...atoll.aliases]) {\n\t\tlookup.set(normalize(key), atoll);\n\t}\n}\n\n/**\n * Find an atoll by any of its names or codes: \"HA\", \"Haa Alifu\", \"Haa Alif Atoll\",\n * \"ހއ\", \"Thiladhunmathi Uthuruburi\" or \"MV-07\". Case and accents don't matter.\n */\nexport function getAtoll(query: string): Atoll | undefined {\n\treturn lookup.get(normalize(query));\n}\n\n/** The city with this name (\"Malé\", \"Addu City\"), if it is one of the five cities. */\nexport function getCity(name: string): City | undefined {\n\tconst key = normalize(name.replace(/\\bcity\\b/i, ''));\n\treturn CITIES.find((city) => normalize(city.name) === key);\n}\n\nexport interface ParsedIslandAddress {\n\tatoll: Atoll;\n\tisland: string;\n}\n\n/**\n * Split an island written with its atoll code, the way Maldivians write\n * addresses: \"B. Eydhafushi\", \"HDh Kulhudhuffushi\", \"GA.Villingili\", \"ބ. އޭދަފުށި\".\n *\n * Returns `undefined` if there's no recognisable atoll code in front.\n */\nexport function parseIslandAddress(input: string): ParsedIslandAddress | undefined {\n\tconst match = /^\\s*([^\\s.]+)\\s*[.\\s]\\s*(.+?)\\s*$/u.exec(input);\n\tif (!match) return undefined;\n\tconst [, code, island] = match;\n\tconst atoll = getAtoll(code!);\n\treturn atoll ? { atoll, island: island! } : undefined;\n}\n\n/** Format an island with its atoll code: (\"B\", \"Eydhafushi\") → \"B. Eydhafushi\". */\nexport function formatIslandAddress(atoll: string | Atoll, island: string, options: { thaana?: boolean } = {}): string {\n\tconst found = typeof atoll === 'string' ? getAtoll(atoll) : atoll;\n\tif (!found) throw new Error(`Unknown atoll: ${atoll}`);\n\treturn `${options.thaana ? found.codeThaana : found.code}. ${island.trim()}`;\n}\n","export interface Atoll {\n\t/** Code abbreviation used in addresses, e.g. \"HA\", \"Sh\", \"ADh\" */\n\tcode: string;\n\t/** Code letter(s) in Thaana, e.g. \"ހއ\" */\n\tcodeThaana: string;\n\t/** Code name, e.g. \"Haa Alifu\" */\n\tcodeName: string;\n\t/** Official name of the administrative division, e.g. \"Thiladhunmathi Uthuruburi\" */\n\tofficialName: string;\n\t/** Single Latin letter used in some official systems, e.g. \"A\" */\n\tlatinLetter: string;\n\t/** ISO 3166-2 code, e.g. \"MV-07\" */\n\tiso: string;\n\t/** Administrative capital island */\n\tcapital: string;\n\t/** Other spellings people use for the code name */\n\taliases: readonly string[];\n}\n\nexport interface City {\n\tname: string;\n\t/** Code of the atoll the city is in, or null for Malé (its own division) */\n\tatoll: string | null;\n\tiso?: string;\n}\n\n/**\n * The 20 administrative atolls, from north to south.\n *\n * Source: Wikipedia, \"Administrative divisions of the Maldives\" (2026) and ISO 3166-2:MV.\n */\nexport const ATOLLS: readonly Atoll[] = [\n\t{ code: 'HA', codeThaana: 'ހއ', codeName: 'Haa Alifu', officialName: 'Thiladhunmathi Uthuruburi', latinLetter: 'A', iso: 'MV-07', capital: 'Dhidhdhoo', aliases: ['Haa Alif'] },\n\t{ code: 'HDh', codeThaana: 'ހދ', codeName: 'Haa Dhaalu', officialName: 'Thiladhunmathi Dhekunuburi', latinLetter: 'B', iso: 'MV-23', capital: 'Kulhudhuffushi', aliases: ['Haa Dhaal'] },\n\t{ code: 'Sh', codeThaana: 'ށ', codeName: 'Shaviyani', officialName: 'Miladhunmadulu Uthuruburi', latinLetter: 'C', iso: 'MV-24', capital: 'Funadhoo', aliases: [] },\n\t{ code: 'N', codeThaana: 'ނ', codeName: 'Noonu', officialName: 'Miladhunmadulu Dhekunuburi', latinLetter: 'D', iso: 'MV-25', capital: 'Manadhoo', aliases: [] },\n\t{ code: 'R', codeThaana: 'ރ', codeName: 'Raa', officialName: 'Maalhosmadulu Uthuruburi', latinLetter: 'E', iso: 'MV-13', capital: 'Ungoofaaru', aliases: [] },\n\t{ code: 'B', codeThaana: 'ބ', codeName: 'Baa', officialName: 'Maalhosmadulu Dhekunuburi', latinLetter: 'F', iso: 'MV-20', capital: 'Eydhafushi', aliases: [] },\n\t{ code: 'Lh', codeThaana: 'ޅ', codeName: 'Lhaviyani', officialName: 'Faadhippolhu', latinLetter: 'G', iso: 'MV-03', capital: 'Naifaru', aliases: [] },\n\t{ code: 'K', codeThaana: 'ކ', codeName: 'Kaafu', officialName: 'Malé Atholhu', latinLetter: 'H', iso: 'MV-26', capital: 'Thulusdhoo', aliases: [] },\n\t{ code: 'AA', codeThaana: 'އއ', codeName: 'Alifu Alifu', officialName: 'Ari Atholhu Uthuruburi', latinLetter: 'U', iso: 'MV-02', capital: 'Rasdhoo', aliases: ['Alif Alif'] },\n\t{ code: 'ADh', codeThaana: 'އދ', codeName: 'Alifu Dhaalu', officialName: 'Ari Atholhu Dhekunuburi', latinLetter: 'I', iso: 'MV-00', capital: 'Mahibadhoo', aliases: ['Alif Dhaal', 'Alif Dhaalu'] },\n\t{ code: 'V', codeThaana: 'ވ', codeName: 'Vaavu', officialName: 'Felidhu Atholhu', latinLetter: 'J', iso: 'MV-04', capital: 'Felidhoo', aliases: [] },\n\t{ code: 'M', codeThaana: 'މ', codeName: 'Meemu', officialName: 'Mulak Atholhu', latinLetter: 'K', iso: 'MV-12', capital: 'Muli', aliases: [] },\n\t{ code: 'F', codeThaana: 'ފ', codeName: 'Faafu', officialName: 'Nilandhe Atholhu Uthuruburi', latinLetter: 'L', iso: 'MV-14', capital: 'Nilandhoo', aliases: [] },\n\t{ code: 'Dh', codeThaana: 'ދ', codeName: 'Dhaalu', officialName: 'Nilandhe Atholhu Dhekunuburi', latinLetter: 'M', iso: 'MV-17', capital: 'Kudahuvadhoo', aliases: [] },\n\t{ code: 'Th', codeThaana: 'ތ', codeName: 'Thaa', officialName: 'Kolhumadulu', latinLetter: 'N', iso: 'MV-08', capital: 'Veymandoo', aliases: [] },\n\t{ code: 'L', codeThaana: 'ލ', codeName: 'Laamu', officialName: 'Haddhunmathi', latinLetter: 'O', iso: 'MV-05', capital: 'Fonadhoo', aliases: [] },\n\t{ code: 'GA', codeThaana: 'ގއ', codeName: 'Gaafu Alifu', officialName: 'Huvadhu Atholhu Uthuruburi', latinLetter: 'P', iso: 'MV-27', capital: 'Villingili', aliases: ['Gaafu Alif', 'Gaaf Alif'] },\n\t{ code: 'GDh', codeThaana: 'ގދ', codeName: 'Gaafu Dhaalu', officialName: 'Huvadhu Atholhu Dhekunuburi', latinLetter: 'Q', iso: 'MV-28', capital: 'Thinadhoo', aliases: ['Gaaf Dhaal', 'Gaafu Dhaal'] },\n\t{ code: 'Gn', codeThaana: 'ޏ', codeName: 'Gnaviyani', officialName: 'Fuvahmulah City', latinLetter: 'R', iso: 'MV-29', capital: 'Fuvahmulah', aliases: [] },\n\t{ code: 'S', codeThaana: 'ސ', codeName: 'Seenu', officialName: 'Addu City', latinLetter: 'S', iso: 'MV-01', capital: 'Hithadhoo', aliases: ['Addu'] }\n];\n\n/** The five cities, each run by a city council. */\nexport const CITIES: readonly City[] = [\n\t{ name: 'Malé', atoll: null, iso: 'MV-MLE' },\n\t{ name: 'Addu', atoll: 'S' },\n\t{ name: 'Fuvahmulah', atoll: 'Gn' },\n\t{ name: 'Kulhudhuffushi', atoll: 'HDh' },\n\t{ name: 'Thinadhoo', atoll: 'GDh' }\n];\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,58 @@
+interface Atoll {
+    /** Code abbreviation used in addresses, e.g. "HA", "Sh", "ADh" */
+    code: string;
+    /** Code letter(s) in Thaana, e.g. "ހއ" */
+    codeThaana: string;
+    /** Code name, e.g. "Haa Alifu" */
+    codeName: string;
+    /** Official name of the administrative division, e.g. "Thiladhunmathi Uthuruburi" */
+    officialName: string;
+    /** Single Latin letter used in some official systems, e.g. "A" */
+    latinLetter: string;
+    /** ISO 3166-2 code, e.g. "MV-07" */
+    iso: string;
+    /** Administrative capital island */
+    capital: string;
+    /** Other spellings people use for the code name */
+    aliases: readonly string[];
+}
+interface City {
+    name: string;
+    /** Code of the atoll the city is in, or null for Malé (its own division) */
+    atoll: string | null;
+    iso?: string;
+}
+/**
+ * The 20 administrative atolls, from north to south.
+ *
+ * Source: Wikipedia, "Administrative divisions of the Maldives" (2026) and ISO 3166-2:MV.
+ */
+declare const ATOLLS: readonly Atoll[];
+/** The five cities, each run by a city council. */
+declare const CITIES: readonly City[];
+
+/**
+ * Find an atoll by any of its names or codes: "HA", "Haa Alifu", "Haa Alif Atoll",
+ * "ހއ", "Thiladhunmathi Uthuruburi" or "MV-07". Case and accents don't matter.
+ */
+declare function getAtoll(query: string): Atoll | undefined;
+/** The city with this name ("Malé", "Addu City"), if it is one of the five cities. */
+declare function getCity(name: string): City | undefined;
+interface ParsedIslandAddress {
+    atoll: Atoll;
+    island: string;
+}
+/**
+ * Split an island written with its atoll code, the way Maldivians write
+ * addresses: "B. Eydhafushi", "HDh Kulhudhuffushi", "GA.Villingili", "ބ. އޭދަފުށި".
+ *
+ * Returns `undefined` if there's no recognisable atoll code in front.
+ */
+declare function parseIslandAddress(input: string): ParsedIslandAddress | undefined;
+/** Format an island with its atoll code: ("B", "Eydhafushi") → "B. Eydhafushi". */
+declare function formatIslandAddress(atoll: string | Atoll, island: string, options?: {
+    thaana?: boolean;
+}): string;
+
+export { ATOLLS, CITIES, formatIslandAddress, getAtoll, getCity, parseIslandAddress };
+export type { Atoll, City, ParsedIslandAddress };

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+interface Atoll {
+    /** Code abbreviation used in addresses, e.g. "HA", "Sh", "ADh" */
+    code: string;
+    /** Code letter(s) in Thaana, e.g. "ހއ" */
+    codeThaana: string;
+    /** Code name, e.g. "Haa Alifu" */
+    codeName: string;
+    /** Official name of the administrative division, e.g. "Thiladhunmathi Uthuruburi" */
+    officialName: string;
+    /** Single Latin letter used in some official systems, e.g. "A" */
+    latinLetter: string;
+    /** ISO 3166-2 code, e.g. "MV-07" */
+    iso: string;
+    /** Administrative capital island */
+    capital: string;
+    /** Other spellings people use for the code name */
+    aliases: readonly string[];
+}
+interface City {
+    name: string;
+    /** Code of the atoll the city is in, or null for Malé (its own division) */
+    atoll: string | null;
+    iso?: string;
+}
+/**
+ * The 20 administrative atolls, from north to south.
+ *
+ * Source: Wikipedia, "Administrative divisions of the Maldives" (2026) and ISO 3166-2:MV.
+ */
+declare const ATOLLS: readonly Atoll[];
+/** The five cities, each run by a city council. */
+declare const CITIES: readonly City[];
+
+/**
+ * Find an atoll by any of its names or codes: "HA", "Haa Alifu", "Haa Alif Atoll",
+ * "ހއ", "Thiladhunmathi Uthuruburi" or "MV-07". Case and accents don't matter.
+ */
+declare function getAtoll(query: string): Atoll | undefined;
+/** The city with this name ("Malé", "Addu City"), if it is one of the five cities. */
+declare function getCity(name: string): City | undefined;
+interface ParsedIslandAddress {
+    atoll: Atoll;
+    island: string;
+}
+/**
+ * Split an island written with its atoll code, the way Maldivians write
+ * addresses: "B. Eydhafushi", "HDh Kulhudhuffushi", "GA.Villingili", "ބ. އޭދަފުށި".
+ *
+ * Returns `undefined` if there's no recognisable atoll code in front.
+ */
+declare function parseIslandAddress(input: string): ParsedIslandAddress | undefined;
+/** Format an island with its atoll code: ("B", "Eydhafushi") → "B. Eydhafushi". */
+declare function formatIslandAddress(atoll: string | Atoll, island: string, options?: {
+    thaana?: boolean;
+}): string;
+
+export { ATOLLS, CITIES, formatIslandAddress, getAtoll, getCity, parseIslandAddress };
+export type { Atoll, City, ParsedIslandAddress };

package/dist/index.js

@@ -0,0 +1,67 @@
+// src/data.ts
+var ATOLLS = [
+  { code: "HA", codeThaana: "\u0780\u0787", codeName: "Haa Alifu", officialName: "Thiladhunmathi Uthuruburi", latinLetter: "A", iso: "MV-07", capital: "Dhidhdhoo", aliases: ["Haa Alif"] },
+  { code: "HDh", codeThaana: "\u0780\u078B", codeName: "Haa Dhaalu", officialName: "Thiladhunmathi Dhekunuburi", latinLetter: "B", iso: "MV-23", capital: "Kulhudhuffushi", aliases: ["Haa Dhaal"] },
+  { code: "Sh", codeThaana: "\u0781", codeName: "Shaviyani", officialName: "Miladhunmadulu Uthuruburi", latinLetter: "C", iso: "MV-24", capital: "Funadhoo", aliases: [] },
+  { code: "N", codeThaana: "\u0782", codeName: "Noonu", officialName: "Miladhunmadulu Dhekunuburi", latinLetter: "D", iso: "MV-25", capital: "Manadhoo", aliases: [] },
+  { code: "R", codeThaana: "\u0783", codeName: "Raa", officialName: "Maalhosmadulu Uthuruburi", latinLetter: "E", iso: "MV-13", capital: "Ungoofaaru", aliases: [] },
+  { code: "B", codeThaana: "\u0784", codeName: "Baa", officialName: "Maalhosmadulu Dhekunuburi", latinLetter: "F", iso: "MV-20", capital: "Eydhafushi", aliases: [] },
+  { code: "Lh", codeThaana: "\u0785", codeName: "Lhaviyani", officialName: "Faadhippolhu", latinLetter: "G", iso: "MV-03", capital: "Naifaru", aliases: [] },
+  { code: "K", codeThaana: "\u0786", codeName: "Kaafu", officialName: "Mal\xE9 Atholhu", latinLetter: "H", iso: "MV-26", capital: "Thulusdhoo", aliases: [] },
+  { code: "AA", codeThaana: "\u0787\u0787", codeName: "Alifu Alifu", officialName: "Ari Atholhu Uthuruburi", latinLetter: "U", iso: "MV-02", capital: "Rasdhoo", aliases: ["Alif Alif"] },
+  { code: "ADh", codeThaana: "\u0787\u078B", codeName: "Alifu Dhaalu", officialName: "Ari Atholhu Dhekunuburi", latinLetter: "I", iso: "MV-00", capital: "Mahibadhoo", aliases: ["Alif Dhaal", "Alif Dhaalu"] },
+  { code: "V", codeThaana: "\u0788", codeName: "Vaavu", officialName: "Felidhu Atholhu", latinLetter: "J", iso: "MV-04", capital: "Felidhoo", aliases: [] },
+  { code: "M", codeThaana: "\u0789", codeName: "Meemu", officialName: "Mulak Atholhu", latinLetter: "K", iso: "MV-12", capital: "Muli", aliases: [] },
+  { code: "F", codeThaana: "\u078A", codeName: "Faafu", officialName: "Nilandhe Atholhu Uthuruburi", latinLetter: "L", iso: "MV-14", capital: "Nilandhoo", aliases: [] },
+  { code: "Dh", codeThaana: "\u078B", codeName: "Dhaalu", officialName: "Nilandhe Atholhu Dhekunuburi", latinLetter: "M", iso: "MV-17", capital: "Kudahuvadhoo", aliases: [] },
+  { code: "Th", codeThaana: "\u078C", codeName: "Thaa", officialName: "Kolhumadulu", latinLetter: "N", iso: "MV-08", capital: "Veymandoo", aliases: [] },
+  { code: "L", codeThaana: "\u078D", codeName: "Laamu", officialName: "Haddhunmathi", latinLetter: "O", iso: "MV-05", capital: "Fonadhoo", aliases: [] },
+  { code: "GA", codeThaana: "\u078E\u0787", codeName: "Gaafu Alifu", officialName: "Huvadhu Atholhu Uthuruburi", latinLetter: "P", iso: "MV-27", capital: "Villingili", aliases: ["Gaafu Alif", "Gaaf Alif"] },
+  { code: "GDh", codeThaana: "\u078E\u078B", codeName: "Gaafu Dhaalu", officialName: "Huvadhu Atholhu Dhekunuburi", latinLetter: "Q", iso: "MV-28", capital: "Thinadhoo", aliases: ["Gaaf Dhaal", "Gaafu Dhaal"] },
+  { code: "Gn", codeThaana: "\u078F", codeName: "Gnaviyani", officialName: "Fuvahmulah City", latinLetter: "R", iso: "MV-29", capital: "Fuvahmulah", aliases: [] },
+  { code: "S", codeThaana: "\u0790", codeName: "Seenu", officialName: "Addu City", latinLetter: "S", iso: "MV-01", capital: "Hithadhoo", aliases: ["Addu"] }
+];
+var CITIES = [
+  { name: "Mal\xE9", atoll: null, iso: "MV-MLE" },
+  { name: "Addu", atoll: "S" },
+  { name: "Fuvahmulah", atoll: "Gn" },
+  { name: "Kulhudhuffushi", atoll: "HDh" },
+  { name: "Thinadhoo", atoll: "GDh" }
+];
+
+// src/index.ts
+var normalize = (value) => value.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/\b(atoll|atholhu)\b/g, "").replace(/[^a-z0-9ހ-ޱ]/g, "");
+var lookup = /* @__PURE__ */ new Map();
+for (const atoll of ATOLLS) {
+  for (const key of [atoll.code, atoll.codeThaana, atoll.codeName, atoll.officialName, atoll.iso, ...atoll.aliases]) {
+    lookup.set(normalize(key), atoll);
+  }
+}
+function getAtoll(query) {
+  return lookup.get(normalize(query));
+}
+function getCity(name) {
+  const key = normalize(name.replace(/\bcity\b/i, ""));
+  return CITIES.find((city) => normalize(city.name) === key);
+}
+function parseIslandAddress(input) {
+  const match = /^\s*([^\s.]+)\s*[.\s]\s*(.+?)\s*$/u.exec(input);
+  if (!match) return void 0;
+  const [, code, island] = match;
+  const atoll = getAtoll(code);
+  return atoll ? { atoll, island } : void 0;
+}
+function formatIslandAddress(atoll, island, options = {}) {
+  const found = typeof atoll === "string" ? getAtoll(atoll) : atoll;
+  if (!found) throw new Error(`Unknown atoll: ${atoll}`);
+  return `${options.thaana ? found.codeThaana : found.code}. ${island.trim()}`;
+}
+export {
+  ATOLLS,
+  CITIES,
+  formatIslandAddress,
+  getAtoll,
+  getCity,
+  parseIslandAddress
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/data.ts","../src/index.ts"],"sourcesContent":["export interface Atoll {\n\t/** Code abbreviation used in addresses, e.g. \"HA\", \"Sh\", \"ADh\" */\n\tcode: string;\n\t/** Code letter(s) in Thaana, e.g. \"ހއ\" */\n\tcodeThaana: string;\n\t/** Code name, e.g. \"Haa Alifu\" */\n\tcodeName: string;\n\t/** Official name of the administrative division, e.g. \"Thiladhunmathi Uthuruburi\" */\n\tofficialName: string;\n\t/** Single Latin letter used in some official systems, e.g. \"A\" */\n\tlatinLetter: string;\n\t/** ISO 3166-2 code, e.g. \"MV-07\" */\n\tiso: string;\n\t/** Administrative capital island */\n\tcapital: string;\n\t/** Other spellings people use for the code name */\n\taliases: readonly string[];\n}\n\nexport interface City {\n\tname: string;\n\t/** Code of the atoll the city is in, or null for Malé (its own division) */\n\tatoll: string | null;\n\tiso?: string;\n}\n\n/**\n * The 20 administrative atolls, from north to south.\n *\n * Source: Wikipedia, \"Administrative divisions of the Maldives\" (2026) and ISO 3166-2:MV.\n */\nexport const ATOLLS: readonly Atoll[] = [\n\t{ code: 'HA', codeThaana: 'ހއ', codeName: 'Haa Alifu', officialName: 'Thiladhunmathi Uthuruburi', latinLetter: 'A', iso: 'MV-07', capital: 'Dhidhdhoo', aliases: ['Haa Alif'] },\n\t{ code: 'HDh', codeThaana: 'ހދ', codeName: 'Haa Dhaalu', officialName: 'Thiladhunmathi Dhekunuburi', latinLetter: 'B', iso: 'MV-23', capital: 'Kulhudhuffushi', aliases: ['Haa Dhaal'] },\n\t{ code: 'Sh', codeThaana: 'ށ', codeName: 'Shaviyani', officialName: 'Miladhunmadulu Uthuruburi', latinLetter: 'C', iso: 'MV-24', capital: 'Funadhoo', aliases: [] },\n\t{ code: 'N', codeThaana: 'ނ', codeName: 'Noonu', officialName: 'Miladhunmadulu Dhekunuburi', latinLetter: 'D', iso: 'MV-25', capital: 'Manadhoo', aliases: [] },\n\t{ code: 'R', codeThaana: 'ރ', codeName: 'Raa', officialName: 'Maalhosmadulu Uthuruburi', latinLetter: 'E', iso: 'MV-13', capital: 'Ungoofaaru', aliases: [] },\n\t{ code: 'B', codeThaana: 'ބ', codeName: 'Baa', officialName: 'Maalhosmadulu Dhekunuburi', latinLetter: 'F', iso: 'MV-20', capital: 'Eydhafushi', aliases: [] },\n\t{ code: 'Lh', codeThaana: 'ޅ', codeName: 'Lhaviyani', officialName: 'Faadhippolhu', latinLetter: 'G', iso: 'MV-03', capital: 'Naifaru', aliases: [] },\n\t{ code: 'K', codeThaana: 'ކ', codeName: 'Kaafu', officialName: 'Malé Atholhu', latinLetter: 'H', iso: 'MV-26', capital: 'Thulusdhoo', aliases: [] },\n\t{ code: 'AA', codeThaana: 'އއ', codeName: 'Alifu Alifu', officialName: 'Ari Atholhu Uthuruburi', latinLetter: 'U', iso: 'MV-02', capital: 'Rasdhoo', aliases: ['Alif Alif'] },\n\t{ code: 'ADh', codeThaana: 'އދ', codeName: 'Alifu Dhaalu', officialName: 'Ari Atholhu Dhekunuburi', latinLetter: 'I', iso: 'MV-00', capital: 'Mahibadhoo', aliases: ['Alif Dhaal', 'Alif Dhaalu'] },\n\t{ code: 'V', codeThaana: 'ވ', codeName: 'Vaavu', officialName: 'Felidhu Atholhu', latinLetter: 'J', iso: 'MV-04', capital: 'Felidhoo', aliases: [] },\n\t{ code: 'M', codeThaana: 'މ', codeName: 'Meemu', officialName: 'Mulak Atholhu', latinLetter: 'K', iso: 'MV-12', capital: 'Muli', aliases: [] },\n\t{ code: 'F', codeThaana: 'ފ', codeName: 'Faafu', officialName: 'Nilandhe Atholhu Uthuruburi', latinLetter: 'L', iso: 'MV-14', capital: 'Nilandhoo', aliases: [] },\n\t{ code: 'Dh', codeThaana: 'ދ', codeName: 'Dhaalu', officialName: 'Nilandhe Atholhu Dhekunuburi', latinLetter: 'M', iso: 'MV-17', capital: 'Kudahuvadhoo', aliases: [] },\n\t{ code: 'Th', codeThaana: 'ތ', codeName: 'Thaa', officialName: 'Kolhumadulu', latinLetter: 'N', iso: 'MV-08', capital: 'Veymandoo', aliases: [] },\n\t{ code: 'L', codeThaana: 'ލ', codeName: 'Laamu', officialName: 'Haddhunmathi', latinLetter: 'O', iso: 'MV-05', capital: 'Fonadhoo', aliases: [] },\n\t{ code: 'GA', codeThaana: 'ގއ', codeName: 'Gaafu Alifu', officialName: 'Huvadhu Atholhu Uthuruburi', latinLetter: 'P', iso: 'MV-27', capital: 'Villingili', aliases: ['Gaafu Alif', 'Gaaf Alif'] },\n\t{ code: 'GDh', codeThaana: 'ގދ', codeName: 'Gaafu Dhaalu', officialName: 'Huvadhu Atholhu Dhekunuburi', latinLetter: 'Q', iso: 'MV-28', capital: 'Thinadhoo', aliases: ['Gaaf Dhaal', 'Gaafu Dhaal'] },\n\t{ code: 'Gn', codeThaana: 'ޏ', codeName: 'Gnaviyani', officialName: 'Fuvahmulah City', latinLetter: 'R', iso: 'MV-29', capital: 'Fuvahmulah', aliases: [] },\n\t{ code: 'S', codeThaana: 'ސ', codeName: 'Seenu', officialName: 'Addu City', latinLetter: 'S', iso: 'MV-01', capital: 'Hithadhoo', aliases: ['Addu'] }\n];\n\n/** The five cities, each run by a city council. */\nexport const CITIES: readonly City[] = [\n\t{ name: 'Malé', atoll: null, iso: 'MV-MLE' },\n\t{ name: 'Addu', atoll: 'S' },\n\t{ name: 'Fuvahmulah', atoll: 'Gn' },\n\t{ name: 'Kulhudhuffushi', atoll: 'HDh' },\n\t{ name: 'Thinadhoo', atoll: 'GDh' }\n];\n","import { ATOLLS, CITIES, type Atoll, type City } from './data.js';\n\nexport { ATOLLS, CITIES, type Atoll, type City };\n\nconst normalize = (value: string) =>\n\tvalue\n\t\t.normalize('NFD')\n\t\t.replace(/[̀-ͯ]/g, '') // drop accents (Malé → Male)\n\t\t.toLowerCase()\n\t\t.replace(/\\b(atoll|atholhu)\\b/g, '')\n\t\t.replace(/[^a-z0-9ހ-ޱ]/g, '');\n\nconst lookup = new Map<string, Atoll>();\nfor (const atoll of ATOLLS) {\n\tfor (const key of [atoll.code, atoll.codeThaana, atoll.codeName, atoll.officialName, atoll.iso, ...atoll.aliases]) {\n\t\tlookup.set(normalize(key), atoll);\n\t}\n}\n\n/**\n * Find an atoll by any of its names or codes: \"HA\", \"Haa Alifu\", \"Haa Alif Atoll\",\n * \"ހއ\", \"Thiladhunmathi Uthuruburi\" or \"MV-07\". Case and accents don't matter.\n */\nexport function getAtoll(query: string): Atoll | undefined {\n\treturn lookup.get(normalize(query));\n}\n\n/** The city with this name (\"Malé\", \"Addu City\"), if it is one of the five cities. */\nexport function getCity(name: string): City | undefined {\n\tconst key = normalize(name.replace(/\\bcity\\b/i, ''));\n\treturn CITIES.find((city) => normalize(city.name) === key);\n}\n\nexport interface ParsedIslandAddress {\n\tatoll: Atoll;\n\tisland: string;\n}\n\n/**\n * Split an island written with its atoll code, the way Maldivians write\n * addresses: \"B. Eydhafushi\", \"HDh Kulhudhuffushi\", \"GA.Villingili\", \"ބ. އޭދަފުށި\".\n *\n * Returns `undefined` if there's no recognisable atoll code in front.\n */\nexport function parseIslandAddress(input: string): ParsedIslandAddress | undefined {\n\tconst match = /^\\s*([^\\s.]+)\\s*[.\\s]\\s*(.+?)\\s*$/u.exec(input);\n\tif (!match) return undefined;\n\tconst [, code, island] = match;\n\tconst atoll = getAtoll(code!);\n\treturn atoll ? { atoll, island: island! } : undefined;\n}\n\n/** Format an island with its atoll code: (\"B\", \"Eydhafushi\") → \"B. Eydhafushi\". */\nexport function formatIslandAddress(atoll: string | Atoll, island: string, options: { thaana?: boolean } = {}): string {\n\tconst found = typeof atoll === 'string' ? getAtoll(atoll) : atoll;\n\tif (!found) throw new Error(`Unknown atoll: ${atoll}`);\n\treturn `${options.thaana ? found.codeThaana : found.code}. ${island.trim()}`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@ruhlabs/atolls",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Maldivian administrative atolls and cities: codes, names, capitals and address parsing",
+  "license": "MIT",
+  "author": "Ruh Labs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ruhlabs/devtools.git",
+    "directory": "packages/atolls"
+  },
+  "keywords": [
+    "maldives",
+    "atolls",
+    "islands",
+    "address",
+    "ruhlabs"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }