i18n-timezones 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 onomojo
+
+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

@@ -0,0 +1,159 @@
+# i18n-timezones
+
+> Localized timezone names for JavaScript and TypeScript -- 36 locales, 152 timezones, zero dependencies.
+
+Building a timezone picker for an international audience? Displaying meeting times across regions? The `Intl` API gives you raw IANA identifiers like `America/New_York`, but your users expect to see **"Eastern Time (US & Canada)"** -- in their own language.
+
+**i18n-timezones** provides human-friendly, localized timezone display names sourced from [CLDR](https://cldr.unicode.org/), the same data that powers ICU, Chrome, and Android. It accepts both friendly timezone names and IANA timezone identifiers, giving you everything you need to build polished, multilingual timezone UIs.
+
+## Why i18n-timezones?
+
+- **36 locales** covering 4+ billion speakers -- from Arabic to Vietnamese
+- **Zero dependencies** -- just translation data and lookup functions
+- **Tree-shakeable** -- bundle only the locales you need (~3-5 KB each, gzipped)
+- **Dual ESM + CJS** -- works everywhere: Vite, Webpack, Next.js, Node.js
+- **Full TypeScript** -- native type declarations, not bolted on
+- **Friendly names + IANA** -- accepts both `"Tokyo"` and `"Asia/Tokyo"`, converts between them
+- **Dropdown-ready** -- `getTimezoneList()` returns entries sorted by UTC offset, perfect for `<select>` menus
+
+## Install
+
+```bash
+npm install i18n-timezones
+```
+
+## Quick Start
+
+The fastest way to get going -- register all locales at once and set a default:
+
+```typescript
+import { registerAllLocales, setDefaultLocale, getTimezoneName } from 'i18n-timezones';
+import allLocales from 'i18n-timezones/langs/all.json';
+
+registerAllLocales(allLocales);
+setDefaultLocale('de');
+
+getTimezoneName('Tokyo');  // => "Tokio"
+```
+
+## Usage
+
+### Bundle-conscious apps -- register only what you need
+
+Each locale is a separate JSON file. Import only the ones your app requires -- bundlers will tree-shake the rest.
+
+```typescript
+import { registerLocale, getTimezoneName, getTimezoneDisplay } from 'i18n-timezones';
+import de from 'i18n-timezones/langs/de.json';
+import fr from 'i18n-timezones/langs/fr.json';
+
+registerLocale(de);
+registerLocale(fr);
+
+getTimezoneName('Tokyo', 'de');        // => "Tokio"
+getTimezoneName('Asia/Tokyo', 'fr');   // => "Tokyo" (accepts IANA IDs too)
+getTimezoneDisplay('Tokyo', 'de');     // => "(GMT+09:00) Tokio"
+```
+
+### Using a default locale
+
+Set a default locale so you don't have to pass it every time:
+
+```typescript
+import { registerLocale, setDefaultLocale, getDefaultLocale, getTimezoneName } from 'i18n-timezones';
+import de from 'i18n-timezones/langs/de.json';
+
+registerLocale(de);
+setDefaultLocale('de');
+
+getTimezoneName('Tokyo');           // => "Tokio" (uses default locale)
+getTimezoneName('Tokyo', 'de');     // => "Tokio" (explicit locale still works)
+getDefaultLocale();                 // => "de"
+```
+
+### Building a timezone dropdown
+
+```typescript
+import { registerLocale, getTimezoneList } from 'i18n-timezones';
+import en from 'i18n-timezones/langs/en.json';
+
+registerLocale(en);
+
+const timezones = getTimezoneList('en');
+// Returns an array sorted by UTC offset:
+// [
+//   { key: "International Date Line West", iana: "Etc/GMT+12", name: "International Date Line West",
+//     display: "(GMT-12:00) International Date Line West", utcOffset: -720 },
+//   ...
+//   { key: "Tokyo", iana: "Asia/Tokyo", name: "Tokyo",
+//     display: "(GMT+09:00) Tokyo", utcOffset: 540 },
+//   ...
+// ]
+
+// Use it in a React component:
+function TimezonePicker({ value, onChange }) {
+  return (
+    <select value={value} onChange={e => onChange(e.target.value)}>
+      {timezones.map(tz => (
+        <option key={tz.key} value={tz.iana ?? tz.key}>
+          {tz.display}
+        </option>
+      ))}
+    </select>
+  );
+}
+```
+
+### Converting between friendly names and IANA IDs
+
+```typescript
+import { getIanaTimezone, getTimezoneFriendlyName } from 'i18n-timezones';
+
+getIanaTimezone('Eastern Time (US & Canada)');  // => "America/New_York"
+getTimezoneFriendlyName('Asia/Tokyo');          // => "Osaka"
+```
+
+## API Reference
+
+| Function | Description |
+|----------|-------------|
+| `registerLocale(data)` | Register a locale's timezone translations. Required before lookups. |
+| `registerAllLocales(allData)` | Register an array of locale data objects at once. |
+| `setDefaultLocale(locale)` | Set the default locale for lookup functions. Throws if locale is not registered. |
+| `getDefaultLocale()` | Get the current default locale, or `undefined` if none is set. |
+| `getTimezoneName(timezone, locale?)` | Get the localized name. Accepts friendly names or IANA IDs. Uses default locale if omitted. |
+| `getTimezoneDisplay(timezone, locale?, options?)` | Formatted string like `"(GMT+09:00) Tokio"`. Options: `{ offsetFormat: 'GMT' \| 'UTC' }` |
+| `getTimezoneList(locale?, options?)` | Sorted array of all timezones -- ready for dropdowns. |
+| `getTimezoneNames(locale?)` | All translations as a `{ name: localizedName }` object. |
+| `getIanaTimezone(friendlyName)` | Convert friendly name to IANA ID. |
+| `getTimezoneFriendlyName(ianaId)` | Convert IANA ID to friendly name. |
+| `getSupportedLocales()` | List all registered locale codes. |
+| `isLocaleRegistered(locale)` | Check if a locale has been registered. |
+
+All lookup functions return `undefined` when a timezone or locale is not found -- no exceptions thrown.
+
+## Supported Locales
+
+36 locales covering major world languages:
+
+| | | | | | | |
+|---|---|---|---|---|---|---|
+| ar | bn | ca | cs | da | de | el |
+| en | es | eu | fi | fr | he | hi |
+| hr | hu | id | it | ja | ko | ms |
+| nl | no | pl | pt | pt-BR | ro | ru |
+| sq | sv | th | tr | uk | vi | zh-CN |
+| zh-TW | | | | | | |
+
+## Data Source
+
+All translations come from the [Unicode CLDR](https://cldr.unicode.org/) (Common Locale Data Repository) -- the industry-standard source used by every major platform including iOS, Android, Chrome, and Java. This ensures translations are accurate, consistent, and maintained by native speakers through Unicode's established review process.
+
+## Related
+
+- **[i18n-country-translations](https://github.com/onomojo/i18n-country-translations-js)** -- Localized country names for 168 locales
+- **[i18n-timezones-data](https://github.com/onomojo/i18n-timezones-data)** -- Raw YAML translation data (for non-JS consumers)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,473 @@
+"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, {
+  getDefaultLocale: () => getDefaultLocale,
+  getIanaTimezone: () => getIanaTimezone,
+  getSupportedLocales: () => getSupportedLocales,
+  getTimezoneDisplay: () => getTimezoneDisplay,
+  getTimezoneFriendlyName: () => getTimezoneFriendlyName,
+  getTimezoneList: () => getTimezoneList,
+  getTimezoneName: () => getTimezoneName,
+  getTimezoneNames: () => getTimezoneNames,
+  isLocaleRegistered: () => isLocaleRegistered,
+  registerAllLocales: () => registerAllLocales,
+  registerLocale: () => registerLocale,
+  setDefaultLocale: () => setDefaultLocale
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/registry.ts
+var locales = /* @__PURE__ */ new Map();
+var defaultLocale;
+function registerLocale(data) {
+  if (!data || typeof data.locale !== "string" || data.locale.length === 0) {
+    throw new Error("registerLocale: data.locale must be a non-empty string");
+  }
+  if (!data.timezones || typeof data.timezones !== "object") {
+    throw new Error("registerLocale: data.timezones must be a non-null object");
+  }
+  locales.set(data.locale, data.timezones);
+}
+function registerAllLocales(allData) {
+  for (const data of allData) {
+    registerLocale(data);
+  }
+}
+function setDefaultLocale(locale) {
+  if (!locales.has(locale)) {
+    throw new Error(`setDefaultLocale: locale "${locale}" is not registered`);
+  }
+  defaultLocale = locale;
+}
+function getDefaultLocale() {
+  return defaultLocale;
+}
+function getSupportedLocales() {
+  return Array.from(locales.keys());
+}
+function isLocaleRegistered(locale) {
+  return locales.has(locale);
+}
+function getLocaleData(locale) {
+  return locales.get(locale);
+}
+
+// src/mapping.ts
+var friendlyNameToIana = {
+  "International Date Line West": "Etc/GMT+12",
+  "American Samoa": "Pacific/Pago_Pago",
+  "Midway Island": "Pacific/Midway",
+  "Hawaii": "Pacific/Honolulu",
+  "Alaska": "America/Juneau",
+  "Pacific Time (US & Canada)": "America/Los_Angeles",
+  "Tijuana": "America/Tijuana",
+  "Arizona": "America/Phoenix",
+  "Mazatlan": "America/Mazatlan",
+  "Mountain Time (US & Canada)": "America/Denver",
+  "Central America": "America/Guatemala",
+  "Central Time (US & Canada)": "America/Chicago",
+  "Chihuahua": "America/Chihuahua",
+  "Guadalajara": "America/Mexico_City",
+  "Mexico City": "America/Mexico_City",
+  "Monterrey": "America/Monterrey",
+  "Saskatchewan": "America/Regina",
+  "Bogota": "America/Bogota",
+  "Eastern Time (US & Canada)": "America/New_York",
+  "Indiana (East)": "America/Indiana/Indianapolis",
+  "Lima": "America/Lima",
+  "Quito": "America/Lima",
+  "Asuncion": "America/Asuncion",
+  "Atlantic Time (Canada)": "America/Halifax",
+  "Caracas": "America/Caracas",
+  "Georgetown": "America/Guyana",
+  "La Paz": "America/La_Paz",
+  "Puerto Rico": "America/Puerto_Rico",
+  "Santiago": "America/Santiago",
+  "Newfoundland": "America/St_Johns",
+  "Brasilia": "America/Sao_Paulo",
+  "Buenos Aires": "America/Argentina/Buenos_Aires",
+  "Montevideo": "America/Montevideo",
+  "Greenland": "America/Godthab",
+  "Mid-Atlantic": "Atlantic/South_Georgia",
+  "Azores": "Atlantic/Azores",
+  "Cape Verde Is.": "Atlantic/Cape_Verde",
+  "Edinburgh": "Europe/London",
+  "Lisbon": "Europe/Lisbon",
+  "London": "Europe/London",
+  "Monrovia": "Africa/Monrovia",
+  "UTC": "Etc/UTC",
+  "Amsterdam": "Europe/Amsterdam",
+  "Belgrade": "Europe/Belgrade",
+  "Berlin": "Europe/Berlin",
+  "Bern": "Europe/Zurich",
+  "Bratislava": "Europe/Bratislava",
+  "Brussels": "Europe/Brussels",
+  "Budapest": "Europe/Budapest",
+  "Casablanca": "Africa/Casablanca",
+  "Copenhagen": "Europe/Copenhagen",
+  "Dublin": "Europe/Dublin",
+  "Ljubljana": "Europe/Ljubljana",
+  "Madrid": "Europe/Madrid",
+  "Paris": "Europe/Paris",
+  "Prague": "Europe/Prague",
+  "Rome": "Europe/Rome",
+  "Sarajevo": "Europe/Sarajevo",
+  "Skopje": "Europe/Skopje",
+  "Stockholm": "Europe/Stockholm",
+  "Vienna": "Europe/Vienna",
+  "Warsaw": "Europe/Warsaw",
+  "West Central Africa": "Africa/Algiers",
+  "Zagreb": "Europe/Zagreb",
+  "Zurich": "Europe/Zurich",
+  "Athens": "Europe/Athens",
+  "Bucharest": "Europe/Bucharest",
+  "Cairo": "Africa/Cairo",
+  "Harare": "Africa/Harare",
+  "Helsinki": "Europe/Helsinki",
+  "Jerusalem": "Asia/Jerusalem",
+  "Kaliningrad": "Europe/Kaliningrad",
+  "Kyiv": "Europe/Kyiv",
+  "Pretoria": "Africa/Johannesburg",
+  "Riga": "Europe/Riga",
+  "Sofia": "Europe/Sofia",
+  "Tallinn": "Europe/Tallinn",
+  "Vilnius": "Europe/Vilnius",
+  "Baghdad": "Asia/Baghdad",
+  "Istanbul": "Europe/Istanbul",
+  "Kuwait": "Asia/Kuwait",
+  "Minsk": "Europe/Minsk",
+  "Moscow": "Europe/Moscow",
+  "Nairobi": "Africa/Nairobi",
+  "Riyadh": "Asia/Riyadh",
+  "St. Petersburg": "Europe/Moscow",
+  "Volgograd": "Europe/Volgograd",
+  "Tehran": "Asia/Tehran",
+  "Abu Dhabi": "Asia/Muscat",
+  "Baku": "Asia/Baku",
+  "Muscat": "Asia/Muscat",
+  "Samara": "Europe/Samara",
+  "Tbilisi": "Asia/Tbilisi",
+  "Yerevan": "Asia/Yerevan",
+  "Kabul": "Asia/Kabul",
+  "Ekaterinburg": "Asia/Yekaterinburg",
+  "Islamabad": "Asia/Karachi",
+  "Karachi": "Asia/Karachi",
+  "Tashkent": "Asia/Tashkent",
+  "Chennai": "Asia/Kolkata",
+  "Kolkata": "Asia/Kolkata",
+  "Mumbai": "Asia/Kolkata",
+  "New Delhi": "Asia/Kolkata",
+  "Sri Jayawardenepura": "Asia/Colombo",
+  "Kathmandu": "Asia/Kathmandu",
+  "Almaty": "Asia/Almaty",
+  "Astana": "Asia/Dhaka",
+  "Dhaka": "Asia/Dhaka",
+  "Urumqi": "Asia/Urumqi",
+  "Rangoon": "Asia/Rangoon",
+  "Bangkok": "Asia/Bangkok",
+  "Hanoi": "Asia/Bangkok",
+  "Jakarta": "Asia/Jakarta",
+  "Krasnoyarsk": "Asia/Krasnoyarsk",
+  "Novosibirsk": "Asia/Novosibirsk",
+  "Beijing": "Asia/Shanghai",
+  "Chongqing": "Asia/Chongqing",
+  "Hong Kong": "Asia/Hong_Kong",
+  "Irkutsk": "Asia/Irkutsk",
+  "Kuala Lumpur": "Asia/Kuala_Lumpur",
+  "Perth": "Australia/Perth",
+  "Singapore": "Asia/Singapore",
+  "Taipei": "Asia/Taipei",
+  "Ulaanbaatar": "Asia/Ulaanbaatar",
+  "Osaka": "Asia/Tokyo",
+  "Sapporo": "Asia/Tokyo",
+  "Seoul": "Asia/Seoul",
+  "Tokyo": "Asia/Tokyo",
+  "Yakutsk": "Asia/Yakutsk",
+  "Adelaide": "Australia/Adelaide",
+  "Darwin": "Australia/Darwin",
+  "Brisbane": "Australia/Brisbane",
+  "Canberra": "Australia/Melbourne",
+  "Guam": "Pacific/Guam",
+  "Hobart": "Australia/Hobart",
+  "Melbourne": "Australia/Melbourne",
+  "Port Moresby": "Pacific/Port_Moresby",
+  "Sydney": "Australia/Sydney",
+  "Vladivostok": "Asia/Vladivostok",
+  "Magadan": "Asia/Magadan",
+  "New Caledonia": "Pacific/Noumea",
+  "Solomon Is.": "Pacific/Guadalcanal",
+  "Srednekolymsk": "Asia/Srednekolymsk",
+  "Auckland": "Pacific/Auckland",
+  "Fiji": "Pacific/Fiji",
+  "Kamchatka": "Asia/Kamchatka",
+  "Marshall Is.": "Pacific/Majuro",
+  "Wellington": "Pacific/Auckland",
+  "Chatham Is.": "Pacific/Chatham",
+  "Nuku'alofa": "Pacific/Tongatapu",
+  "Samoa": "Pacific/Apia",
+  "Tokelau Is.": "Pacific/Fakaofo"
+};
+var ianaToFriendlyName = {};
+for (const [name, iana] of Object.entries(friendlyNameToIana)) {
+  if (!(iana in ianaToFriendlyName)) {
+    ianaToFriendlyName[iana] = name;
+  }
+}
+var utcOffsets = {
+  "International Date Line West": -720,
+  "American Samoa": -660,
+  "Midway Island": -660,
+  "Hawaii": -600,
+  "Alaska": -540,
+  "Pacific Time (US & Canada)": -480,
+  "Tijuana": -480,
+  "Arizona": -420,
+  "Mazatlan": -420,
+  "Mountain Time (US & Canada)": -420,
+  "Central America": -360,
+  "Central Time (US & Canada)": -360,
+  "Chihuahua": -360,
+  "Guadalajara": -360,
+  "Mexico City": -360,
+  "Monterrey": -360,
+  "Saskatchewan": -360,
+  "Bogota": -300,
+  "Eastern Time (US & Canada)": -300,
+  "Indiana (East)": -300,
+  "Lima": -300,
+  "Quito": -300,
+  "Asuncion": -240,
+  "Atlantic Time (Canada)": -240,
+  "Caracas": -240,
+  "Georgetown": -240,
+  "La Paz": -240,
+  "Puerto Rico": -240,
+  "Santiago": -240,
+  "Newfoundland": -210,
+  "Brasilia": -180,
+  "Buenos Aires": -180,
+  "Montevideo": -180,
+  "Greenland": -180,
+  "Mid-Atlantic": -120,
+  "Azores": -60,
+  "Cape Verde Is.": -60,
+  "Edinburgh": 0,
+  "Lisbon": 0,
+  "London": 0,
+  "Monrovia": 0,
+  "UTC": 0,
+  "Amsterdam": 60,
+  "Belgrade": 60,
+  "Berlin": 60,
+  "Bern": 60,
+  "Bratislava": 60,
+  "Brussels": 60,
+  "Budapest": 60,
+  "Casablanca": 60,
+  "Copenhagen": 60,
+  "Dublin": 60,
+  "Ljubljana": 60,
+  "Madrid": 60,
+  "Paris": 60,
+  "Prague": 60,
+  "Rome": 60,
+  "Sarajevo": 60,
+  "Skopje": 60,
+  "Stockholm": 60,
+  "Vienna": 60,
+  "Warsaw": 60,
+  "West Central Africa": 60,
+  "Zagreb": 60,
+  "Zurich": 60,
+  "Athens": 120,
+  "Bucharest": 120,
+  "Cairo": 120,
+  "Harare": 120,
+  "Helsinki": 120,
+  "Jerusalem": 120,
+  "Kaliningrad": 120,
+  "Kyiv": 120,
+  "Pretoria": 120,
+  "Riga": 120,
+  "Sofia": 120,
+  "Tallinn": 120,
+  "Vilnius": 120,
+  "Baghdad": 180,
+  "Istanbul": 180,
+  "Kuwait": 180,
+  "Minsk": 180,
+  "Moscow": 180,
+  "Nairobi": 180,
+  "Riyadh": 180,
+  "St. Petersburg": 180,
+  "Volgograd": 180,
+  "Tehran": 210,
+  "Abu Dhabi": 240,
+  "Baku": 240,
+  "Muscat": 240,
+  "Samara": 240,
+  "Tbilisi": 240,
+  "Yerevan": 240,
+  "Kabul": 270,
+  "Ekaterinburg": 300,
+  "Islamabad": 300,
+  "Karachi": 300,
+  "Tashkent": 300,
+  "Chennai": 330,
+  "Kolkata": 330,
+  "Mumbai": 330,
+  "New Delhi": 330,
+  "Sri Jayawardenepura": 330,
+  "Kathmandu": 345,
+  "Almaty": 360,
+  "Astana": 360,
+  "Dhaka": 360,
+  "Urumqi": 360,
+  "Rangoon": 390,
+  "Bangkok": 420,
+  "Hanoi": 420,
+  "Jakarta": 420,
+  "Krasnoyarsk": 420,
+  "Novosibirsk": 420,
+  "Beijing": 480,
+  "Chongqing": 480,
+  "Hong Kong": 480,
+  "Irkutsk": 480,
+  "Kuala Lumpur": 480,
+  "Perth": 480,
+  "Singapore": 480,
+  "Taipei": 480,
+  "Ulaanbaatar": 480,
+  "Osaka": 540,
+  "Sapporo": 540,
+  "Seoul": 540,
+  "Tokyo": 540,
+  "Yakutsk": 540,
+  "Adelaide": 570,
+  "Darwin": 570,
+  "Brisbane": 600,
+  "Canberra": 600,
+  "Guam": 600,
+  "Hobart": 600,
+  "Melbourne": 600,
+  "Port Moresby": 600,
+  "Sydney": 600,
+  "Vladivostok": 600,
+  "Magadan": 660,
+  "New Caledonia": 660,
+  "Solomon Is.": 660,
+  "Srednekolymsk": 660,
+  "Auckland": 720,
+  "Fiji": 720,
+  "Kamchatka": 720,
+  "Marshall Is.": 720,
+  "Wellington": 720,
+  "Chatham Is.": 765,
+  "Nuku'alofa": 780,
+  "Samoa": 780,
+  "Tokelau Is.": 780
+};
+function getIanaTimezone(friendlyName) {
+  return friendlyNameToIana[friendlyName];
+}
+function getTimezoneFriendlyName(ianaId) {
+  return ianaToFriendlyName[ianaId];
+}
+function resolveToFriendlyName(timezone) {
+  if (timezone in friendlyNameToIana) return timezone;
+  return ianaToFriendlyName[timezone];
+}
+function getUtcOffset(friendlyName) {
+  return utcOffsets[friendlyName];
+}
+function formatOffset(minutes, format = "GMT") {
+  const sign = minutes >= 0 ? "+" : "-";
+  const abs = Math.abs(minutes);
+  const h = String(Math.floor(abs / 60)).padStart(2, "0");
+  const m = String(abs % 60).padStart(2, "0");
+  return `${format}${sign}${h}:${m}`;
+}
+
+// src/lookup.ts
+function resolveLocale(locale) {
+  return locale ?? getDefaultLocale();
+}
+function getTimezoneName(timezone, locale) {
+  const loc = resolveLocale(locale);
+  if (!loc) return void 0;
+  const data = getLocaleData(loc);
+  if (!data) return void 0;
+  const key = resolveToFriendlyName(timezone);
+  if (!key) return void 0;
+  return data[key];
+}
+function getTimezoneDisplay(timezone, locale, options) {
+  const loc = resolveLocale(locale);
+  if (!loc) return void 0;
+  const key = resolveToFriendlyName(timezone);
+  if (!key) return void 0;
+  const name = getTimezoneName(key, loc);
+  if (!name) return void 0;
+  const offset = getUtcOffset(key);
+  if (offset === void 0) return name;
+  return `(${formatOffset(offset, options?.offsetFormat ?? "GMT")}) ${name}`;
+}
+function getTimezoneNames(locale) {
+  const loc = resolveLocale(locale);
+  if (!loc) return void 0;
+  const data = getLocaleData(loc);
+  if (!data) return void 0;
+  return { ...data };
+}
+function getTimezoneList(locale, options) {
+  const loc = resolveLocale(locale);
+  if (!loc) return void 0;
+  const data = getLocaleData(loc);
+  if (!data) return void 0;
+  const entries = Object.entries(data).map(([key, name]) => {
+    const offset = getUtcOffset(key) ?? 0;
+    return {
+      key,
+      iana: getIanaTimezone(key),
+      name,
+      display: `(${formatOffset(offset, options?.offsetFormat ?? "GMT")}) ${name}`,
+      utcOffset: offset
+    };
+  });
+  return entries.sort((a, b) => a.utcOffset - b.utcOffset);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDefaultLocale,
+  getIanaTimezone,
+  getSupportedLocales,
+  getTimezoneDisplay,
+  getTimezoneFriendlyName,
+  getTimezoneList,
+  getTimezoneName,
+  getTimezoneNames,
+  isLocaleRegistered,
+  registerAllLocales,
+  registerLocale,
+  setDefaultLocale
+});
+//# sourceMappingURL=index.cjs.map