geodata-kit-tz 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 geodata-kit contributors
+
+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.
+
+The code is MIT-licensed. The bundled data keeps the licences of its sources;
+see NOTICE.

package/LICENSE-DATA

@@ -0,0 +1,27 @@
+Data licence for geodata-kit-tz
+===============================
+
+The file data/timezones.bin is a derived database made from the timezone
+boundaries of timezone-boundary-builder
+(https://github.com/evansiroky/timezone-boundary-builder, release 2026f),
+which are based on OpenStreetMap data.
+
+  © OpenStreetMap contributors (https://www.openstreetmap.org/copyright)
+
+This database is made available under the Open Database License (ODbL) 1.0:
+https://opendatacommons.org/licenses/odbl/1-0/
+
+Any rights in individual contents of the database are licensed under the
+Database Contents License: https://opendatacommons.org/licenses/dbcl/1-0/
+
+How it was derived: polygons were simplified (Douglas–Peucker, tolerance
+0.001°), quantised to 1/10,000 degree and packed with a 1°×1° grid index by
+scripts/build/tz.ts in the geodata-kit repository, which is the means of
+reproducing it from the source.
+
+ODbL is a share-alike licence: if you publicly use an adapted version of this
+database, you must offer that adapted database under the ODbL as well. Using
+the lookup results in your application (a "Produced Work") requires
+attribution, for example: "Timezone data © OpenStreetMap contributors (ODbL)".
+
+The JavaScript code of geodata-kit-tz is MIT-licensed (see LICENSE).

package/NOTICE

@@ -0,0 +1,91 @@
+geodata-kit — third-party data notices
+======================================
+
+The code of geodata-kit is MIT-licensed (see LICENSE). The data shipped in
+the packages was generated from the sources below and keeps their licences.
+Every source, its download URL, size, SHA-256 and download date is listed in
+data/meta.json of the repository.
+
+GeoNames
+  Countries, subdivisions, cities, localities, alternate names, airports,
+  timezones per place and postal codes. Data from GeoNames (https://www.geonames.org),
+  licensed under Creative Commons Attribution 4.0 (CC BY 4.0,
+  https://creativecommons.org/licenses/by/4.0/). Modified: filtered,
+  re-keyed and combined with the other sources listed here.
+
+Unicode CLDR
+  Country, language and subdivision names, currencies with dates, retired
+  codes, UN M49 regions, languages per country, likely locales, week and
+  measurement data. Copyright © 1991-2025 Unicode, Inc. Licensed under the
+  Unicode License v3 (https://www.unicode.org/license.txt):
+
+    UNICODE LICENSE V3
+    COPYRIGHT AND PERMISSION NOTICE
+    Copyright © 1991-2025 Unicode, Inc.
+    NOTICE TO USER: Carefully read the following legal agreement. BY
+    DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING DATA FILES, AND/OR
+    SOFTWARE, YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+    TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT
+    DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of data files and any associated documentation (the "Data Files") or
+    software and any associated documentation (the "Software") to deal in the
+    Data Files or Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, and/or sell
+    copies of the Data Files or Software, and to permit persons to whom the
+    Data Files or Software are furnished to do so, provided that either (a)
+    this copyright and permission notice appear with all copies of the Data
+    Files or Software, or (b) this copyright and permission notice appear in
+    associated Documentation.
+    THE DATA FILES AND SOFTWARE ARE 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 OF
+    THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS
+    INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT
+    OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
+    USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+    OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+    PERFORMANCE OF THE DATA FILES OR SOFTWARE.
+    Except as contained in this notice, the name of a copyright holder shall
+    not be used in advertising or otherwise to promote the sale, use or other
+    dealings in these Data Files or Software without prior written
+    authorization of the copyright holder.
+
+IANA Time Zone Database
+  Timezone names, zones per country and legacy aliases, from the IANA Time
+  Zone Database (https://www.iana.org/time-zones), which is in the public domain.
+
+Wikidata
+  Subdivision ISO 3166-2 ↔ GeoNames mapping, official languages of countries
+  and subdivisions, demonyms, calling codes, driving side. From Wikidata
+  (https://www.wikidata.org), dedicated to the public domain under CC0 1.0.
+
+Natural Earth
+  Country and first-level subdivision polygons. Made with Natural Earth.
+  Free vector and raster map data @ naturalearthdata.com (public domain).
+
+libphonenumber
+  Phone-number metadata, converted from PhoneNumberMetadata.xml.
+  Copyright (C) The Libphonenumber Authors. Licensed under the Apache
+  License, Version 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
+  You may not use this data except in compliance with that License. Unless
+  required by applicable law or agreed to in writing, it is distributed on
+  an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+Google address metadata (libaddressinput)
+  Address formats, required fields, postal-code patterns and region lists.
+  Data from Google's libaddressinput project
+  (https://github.com/google/libaddressinput), licensed under CC BY 4.0.
+  Modified: merged with GeoNames postal formats.
+
+European Union / EFTA
+  EU, Eurozone, Schengen, EEA and EFTA membership dates, compiled from
+  europa.eu (© European Union, CC BY 4.0) and efta.int. Modified.
+
+geodata-kit-tz only
+  Timezone polygons from timezone-boundary-builder
+  (https://github.com/evansiroky/timezone-boundary-builder), based on data
+  © OpenStreetMap contributors, licensed under the Open Database License
+  (ODbL) 1.0 (https://opendatacommons.org/licenses/odbl/1-0/). The ODbL
+  applies to that data, not to the rest of geodata-kit. See LICENSE-DATA in
+  that package.

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# geodata-kit-tz
 
-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 exact timezone for any coordinate. Works in Node.js and browsers.
+
+```bash
+npm install geodata-kit-tz
+```
+
+```ts
+import { getTimezoneAt } from 'geodata-kit-tz';
+
+await getTimezoneAt(39.77, -86.16);   // 'America/Indiana/Indianapolis'
+await getTimezoneAt(0, -30);          // 'Etc/GMT+2' (at sea)
+```
+
+## API
+
+| Function | Returns |
+|---|---|
+| `getTimezoneAt(lat, lng)` | async; IANA zone, or `Etc/GMT±N` at sea |
+| `getTimezonesAt(lat, lng)` | async; all zones at the point (a few areas overlap), most specific first |
+| `listPolygonTimezones()` | async; every zone in the data |
+| `nauticalTimezone(lng)` | `Etc/GMT±N` for a longitude |
+
+Code: MIT. Data: © OpenStreetMap contributors, Open Database License (ODbL);
+see `LICENSE-DATA`. Credit OpenStreetMap when you show results.

package/dist/index.cjs

@@ -0,0 +1,159 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  getTimezoneAt: () => getTimezoneAt,
+  getTimezonesAt: () => getTimezonesAt,
+  listPolygonTimezones: () => listPolygonTimezones,
+  nauticalTimezone: () => nauticalTimezone
+});
+module.exports = __toCommonJS(src_exports);
+
+// ../../node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+// src/index.ts
+var DATA_URL = new URL("../data/timezones.bin", importMetaUrl);
+var SCALE = 1e4;
+var indexPromise = null;
+async function readData() {
+  const isNode = typeof process !== "undefined" && Boolean(process.versions?.node);
+  if (isNode && DATA_URL.protocol === "file:") {
+    const { readFile } = await import("fs/promises");
+    const file = await readFile(DATA_URL);
+    return file.buffer.slice(file.byteOffset, file.byteOffset + file.byteLength);
+  }
+  const response = await fetch(DATA_URL);
+  if (!response.ok) throw new Error(`geodata-kit-tz: cannot load ${DATA_URL.href} (HTTP ${response.status})`);
+  return response.arrayBuffer();
+}
+function parse(buffer) {
+  const view = new DataView(buffer);
+  const decoder = new TextDecoder();
+  if (decoder.decode(new Uint8Array(buffer, 0, 4)) !== "GKTZ") throw new Error("geodata-kit-tz: not a timezone index");
+  let offset = 8;
+  const zoneCount = view.getUint32(offset, true);
+  offset += 4;
+  const zones = [];
+  for (let i = 0; i < zoneCount; i++) {
+    const length = view.getUint16(offset, true);
+    offset += 2;
+    zones.push(decoder.decode(new Uint8Array(buffer, offset, length)));
+    offset += length;
+  }
+  const polygonCount = view.getUint32(offset, true);
+  offset += 4;
+  const polygons = [];
+  for (let i = 0; i < polygonCount; i++) {
+    const zone = view.getUint16(offset, true);
+    offset += 2;
+    const ringCount = view.getUint16(offset, true);
+    offset += 2;
+    const bbox = [
+      view.getInt32(offset, true),
+      view.getInt32(offset + 4, true),
+      view.getInt32(offset + 8, true),
+      view.getInt32(offset + 12, true)
+    ];
+    offset += 16;
+    const rings = [];
+    for (let r = 0; r < ringCount; r++) {
+      const pointCount = view.getUint32(offset, true);
+      offset += 4;
+      rings.push(new Int32Array(buffer.slice(offset, offset + pointCount * 8)));
+      offset += pointCount * 8;
+    }
+    polygons.push({ zone, bbox, rings });
+  }
+  const cellOffsets = new Uint32Array(buffer.slice(offset, offset + (360 * 180 + 1) * 4));
+  offset += (360 * 180 + 1) * 4;
+  const cellList = new Uint32Array(buffer.slice(offset));
+  return { zones, polygons, cellOffsets, cellList };
+}
+function load() {
+  indexPromise ?? (indexPromise = readData().then(parse));
+  return indexPromise;
+}
+function insideRing(ring, x, y) {
+  let inside = false;
+  for (let i = 0, j = ring.length - 2; i < ring.length; j = i, i += 2) {
+    const xi = ring[i];
+    const yi = ring[i + 1];
+    const xj = ring[j];
+    const yj = ring[j + 1];
+    if (yi > y !== yj > y && x < (xj - xi) * (y - yi) / (yj - yi) + xi) inside = !inside;
+  }
+  return inside;
+}
+function nauticalTimezone(lng) {
+  const offset = Math.round(lng / 15);
+  if (offset === 0) return "Etc/GMT";
+  return `Etc/GMT${offset > 0 ? "-" : "+"}${Math.abs(offset)}`;
+}
+async function zonesAt(lat, lng, firstOnly) {
+  if (!Number.isFinite(lat) || !Number.isFinite(lng) || lat < -90 || lat > 90) throw new RangeError(`Invalid coordinate ${lat}, ${lng}`);
+  const normalizedLng = ((lng + 180) % 360 + 360) % 360 - 180;
+  const index = await load();
+  const x = Math.round(normalizedLng * SCALE);
+  const y = Math.round(lat * SCALE);
+  const row = Math.min(179, Math.max(0, Math.floor(lat) + 90));
+  const col = Math.min(359, Math.max(0, Math.floor(normalizedLng) + 180));
+  const cell = row * 360 + col;
+  const found = [];
+  for (let i = index.cellOffsets[cell]; i < index.cellOffsets[cell + 1]; i++) {
+    const polygon = index.polygons[index.cellList[i]];
+    const [minX, minY, maxX, maxY] = polygon.bbox;
+    if (x < minX || x > maxX || y < minY || y > maxY) continue;
+    if (insideRing(polygon.rings[0], x, y) && !polygon.rings.slice(1).some((hole) => insideRing(hole, x, y))) {
+      const zone = index.zones[polygon.zone];
+      if (!found.includes(zone)) found.push(zone);
+      if (firstOnly) break;
+    }
+  }
+  return found.length ? found : [nauticalTimezone(normalizedLng)];
+}
+async function getTimezoneAt(lat, lng) {
+  return (await zonesAt(lat, lng, true))[0];
+}
+async function getTimezonesAt(lat, lng) {
+  return zonesAt(lat, lng, false);
+}
+async function listPolygonTimezones() {
+  return [...(await load()).zones];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getTimezoneAt,
+  getTimezonesAt,
+  listPolygonTimezones,
+  nauticalTimezone
+});

package/dist/index.d.cts

@@ -0,0 +1,22 @@
+/**
+ * geodata-kit-tz — exact IANA timezone for a coordinate, from timezone
+ * polygons (timezone-boundary-builder, data © OpenStreetMap contributors,
+ * ODbL 1.0 — see LICENSE-DATA). Polygons are simplified to about 110 m.
+ *
+ * Works in Node.js (reads the file) and in browsers (fetches it next to the module).
+ */
+/** Nautical timezone for open sea: Etc/GMT-1 east of 7.5°E, etc. (the sign is inverted in these names). */
+declare function nauticalTimezone(lng: number): string;
+/**
+ * IANA timezone at a coordinate: (48.137, 11.575) → "Europe/Berlin",
+ * (39.77, -86.16) → "America/Indiana/Indianapolis". At sea: "Etc/GMT±N".
+ * Where zones overlap in the source (Xinjiang: Asia/Urumqi inside Asia/Shanghai),
+ * the most specific (smallest) one is returned; see getTimezonesAt.
+ */
+declare function getTimezoneAt(lat: number, lng: number): Promise<string>;
+/** Every zone whose polygon contains the point, most specific first (usually one). */
+declare function getTimezonesAt(lat: number, lng: number): Promise<string[]>;
+/** Every timezone name in the polygon data. */
+declare function listPolygonTimezones(): Promise<string[]>;
+
+export { getTimezoneAt, getTimezonesAt, listPolygonTimezones, nauticalTimezone };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * geodata-kit-tz — exact IANA timezone for a coordinate, from timezone
+ * polygons (timezone-boundary-builder, data © OpenStreetMap contributors,
+ * ODbL 1.0 — see LICENSE-DATA). Polygons are simplified to about 110 m.
+ *
+ * Works in Node.js (reads the file) and in browsers (fetches it next to the module).
+ */
+/** Nautical timezone for open sea: Etc/GMT-1 east of 7.5°E, etc. (the sign is inverted in these names). */
+declare function nauticalTimezone(lng: number): string;
+/**
+ * IANA timezone at a coordinate: (48.137, 11.575) → "Europe/Berlin",
+ * (39.77, -86.16) → "America/Indiana/Indianapolis". At sea: "Etc/GMT±N".
+ * Where zones overlap in the source (Xinjiang: Asia/Urumqi inside Asia/Shanghai),
+ * the most specific (smallest) one is returned; see getTimezonesAt.
+ */
+declare function getTimezoneAt(lat: number, lng: number): Promise<string>;
+/** Every zone whose polygon contains the point, most specific first (usually one). */
+declare function getTimezonesAt(lat: number, lng: number): Promise<string[]>;
+/** Every timezone name in the polygon data. */
+declare function listPolygonTimezones(): Promise<string[]>;
+
+export { getTimezoneAt, getTimezonesAt, listPolygonTimezones, nauticalTimezone };

package/dist/index.js

@@ -0,0 +1,115 @@
+// src/index.ts
+var DATA_URL = new URL("../data/timezones.bin", import.meta.url);
+var SCALE = 1e4;
+var indexPromise = null;
+async function readData() {
+  const isNode = typeof process !== "undefined" && Boolean(process.versions?.node);
+  if (isNode && DATA_URL.protocol === "file:") {
+    const { readFile } = await import("fs/promises");
+    const file = await readFile(DATA_URL);
+    return file.buffer.slice(file.byteOffset, file.byteOffset + file.byteLength);
+  }
+  const response = await fetch(DATA_URL);
+  if (!response.ok) throw new Error(`geodata-kit-tz: cannot load ${DATA_URL.href} (HTTP ${response.status})`);
+  return response.arrayBuffer();
+}
+function parse(buffer) {
+  const view = new DataView(buffer);
+  const decoder = new TextDecoder();
+  if (decoder.decode(new Uint8Array(buffer, 0, 4)) !== "GKTZ") throw new Error("geodata-kit-tz: not a timezone index");
+  let offset = 8;
+  const zoneCount = view.getUint32(offset, true);
+  offset += 4;
+  const zones = [];
+  for (let i = 0; i < zoneCount; i++) {
+    const length = view.getUint16(offset, true);
+    offset += 2;
+    zones.push(decoder.decode(new Uint8Array(buffer, offset, length)));
+    offset += length;
+  }
+  const polygonCount = view.getUint32(offset, true);
+  offset += 4;
+  const polygons = [];
+  for (let i = 0; i < polygonCount; i++) {
+    const zone = view.getUint16(offset, true);
+    offset += 2;
+    const ringCount = view.getUint16(offset, true);
+    offset += 2;
+    const bbox = [
+      view.getInt32(offset, true),
+      view.getInt32(offset + 4, true),
+      view.getInt32(offset + 8, true),
+      view.getInt32(offset + 12, true)
+    ];
+    offset += 16;
+    const rings = [];
+    for (let r = 0; r < ringCount; r++) {
+      const pointCount = view.getUint32(offset, true);
+      offset += 4;
+      rings.push(new Int32Array(buffer.slice(offset, offset + pointCount * 8)));
+      offset += pointCount * 8;
+    }
+    polygons.push({ zone, bbox, rings });
+  }
+  const cellOffsets = new Uint32Array(buffer.slice(offset, offset + (360 * 180 + 1) * 4));
+  offset += (360 * 180 + 1) * 4;
+  const cellList = new Uint32Array(buffer.slice(offset));
+  return { zones, polygons, cellOffsets, cellList };
+}
+function load() {
+  indexPromise ?? (indexPromise = readData().then(parse));
+  return indexPromise;
+}
+function insideRing(ring, x, y) {
+  let inside = false;
+  for (let i = 0, j = ring.length - 2; i < ring.length; j = i, i += 2) {
+    const xi = ring[i];
+    const yi = ring[i + 1];
+    const xj = ring[j];
+    const yj = ring[j + 1];
+    if (yi > y !== yj > y && x < (xj - xi) * (y - yi) / (yj - yi) + xi) inside = !inside;
+  }
+  return inside;
+}
+function nauticalTimezone(lng) {
+  const offset = Math.round(lng / 15);
+  if (offset === 0) return "Etc/GMT";
+  return `Etc/GMT${offset > 0 ? "-" : "+"}${Math.abs(offset)}`;
+}
+async function zonesAt(lat, lng, firstOnly) {
+  if (!Number.isFinite(lat) || !Number.isFinite(lng) || lat < -90 || lat > 90) throw new RangeError(`Invalid coordinate ${lat}, ${lng}`);
+  const normalizedLng = ((lng + 180) % 360 + 360) % 360 - 180;
+  const index = await load();
+  const x = Math.round(normalizedLng * SCALE);
+  const y = Math.round(lat * SCALE);
+  const row = Math.min(179, Math.max(0, Math.floor(lat) + 90));
+  const col = Math.min(359, Math.max(0, Math.floor(normalizedLng) + 180));
+  const cell = row * 360 + col;
+  const found = [];
+  for (let i = index.cellOffsets[cell]; i < index.cellOffsets[cell + 1]; i++) {
+    const polygon = index.polygons[index.cellList[i]];
+    const [minX, minY, maxX, maxY] = polygon.bbox;
+    if (x < minX || x > maxX || y < minY || y > maxY) continue;
+    if (insideRing(polygon.rings[0], x, y) && !polygon.rings.slice(1).some((hole) => insideRing(hole, x, y))) {
+      const zone = index.zones[polygon.zone];
+      if (!found.includes(zone)) found.push(zone);
+      if (firstOnly) break;
+    }
+  }
+  return found.length ? found : [nauticalTimezone(normalizedLng)];
+}
+async function getTimezoneAt(lat, lng) {
+  return (await zonesAt(lat, lng, true))[0];
+}
+async function getTimezonesAt(lat, lng) {
+  return zonesAt(lat, lng, false);
+}
+async function listPolygonTimezones() {
+  return [...(await load()).zones];
+}
+export {
+  getTimezoneAt,
+  getTimezonesAt,
+  listPolygonTimezones,
+  nauticalTimezone
+};

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "geodata-kit-tz",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Optional companion to geodata-kit: exact IANA timezone for any coordinate from timezone polygons (timezone-boundary-builder). Code MIT, data ODbL 1.0.",
+  "keywords": [
+    "timezone",
+    "tz",
+    "iana",
+    "coordinates",
+    "point-in-polygon",
+    "geodata-kit"
+  ],
+  "license": "MIT AND ODbL-1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/greta-devhub/geodata-kit.git",
+    "directory": "packages/geodata-kit-tz"
+  },
+  "homepage": "https://github.com/greta-devhub/geodata-kit/tree/main/packages/geodata-kit-tz#readme",
+  "bugs": {
+    "url": "https://github.com/greta-devhub/geodata-kit/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "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"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "data",
+    "NOTICE",
+    "LICENSE",
+    "LICENSE-DATA",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup"
+  }
+}