ilib-zic 0.0.1 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# ilib-zic
+
+## 1.0.1
+
+### Patch Changes
+
+- 729c49e: Allow Node 24 and 26 by widening engines.node upper bound from <23 to <27.
+
+  Yarn 1 enforces engines and refuses to install these packages on newer
+  Node releases when the range stops at Node 23.
+
+## 1.0.0
+
+### Major Changes
+
+- af1a7b6: First release of ilib-zic as a standalone package in the ilib-mono monorepo.
+
+  - TypeScript port of the Java zone info compiler from monolithic ilib (`com.ilib.tools.zic`), merged with the former Node `gentzinfo.js` enricher into one in-memory pipeline
+  - Compiles IANA tzdata → enriches (country codes, Windows display names, zonetab, per-country `timezone.jf`) → writes a locale tree in one pass
+  - CLI: `ilib-zic <src> <localeDir> [--verbose] [--compile-only]` (published as `ilib-zic` because npm `zic` is taken)
+  - Programmatic `ZoneInfoPipeline` API (or compile / enrich / write stages individually)
+  - Supports IANA `%z` abbreviation formats (zic `abbroffset`) for numeric UT abbrevs such as `-03/-02`
+  - Country defaults prefer `zone.tab` primaries; do not follow cross-country Link consolidations for `timezone.jf` or Windows `n`
+  - POSIX factory Links (`EST`, `CET`, …) are not treated as country-local zone ids
+  - Depends on `ilib-ctype`, `ilib-common`, `ilib-data-utils`, `cldr-core`, and `json-stable-stringify`
+  - Includes a CLI sample with a mini tzdata excerpt (including `America/Sao_Paulo` for `%z`) and an e2e snapshot suite

package/README.md

@@ -1,13 +1,75 @@
-# ilib-zic (0.0.1 placeholder)
+# ilib-zic
 
-This is a **temporary placeholder** published only so the `ilib-zic` package
-exists on npmjs.com and can have [trusted publishing
-(OIDC)](https://docs.npmjs.com/trusted-publishers) configured for the
-ilib-mono GitHub Actions Release workflow.
+Zone info compiler that converts [IANA tzdata](https://www.iana.org/time-zones)
+sources into JSON zoneinfo files used by ilib.
 
-Do not depend on this version. The real package ships as `1.0.0` from
-[`packages/zic`](https://github.com/iLib-js/ilib-mono/tree/main/packages/zic)
-in the [ilib-mono](https://github.com/iLib-js/ilib-mono) monorepo.
+This package is a TypeScript port of the Java tool in
+`com.ilib.tools.zic` from the monolithic
+[ilib](https://github.com/iLib-js/iLib) repository, plus the former
+`gentzinfo.js` enrichment step (country codes, Windows names, zonetab,
+timezone.jf).
+
+## Installation
+
+```
+npm install ilib-zic
+
+or
+
+yarn add ilib-zic
+```
+
+## CLI
+
+```
+ilib-zic /path/to/tzdata /path/to/locale [--verbose] [--compile-only]
+```
+
+| Argument / option | Description |
+|-------------------|-------------|
+| `src` | Directory containing unpacked IANA tzdata sources (required) |
+| `localeDir` | Locale root to write (`zoneinfo/`, `timezone.jf`, `und/`) (required) |
+| `-v, --verbose` | Print progress during compilation |
+| `--compile-only` | Skip enrichment; write raw zoneinfo JSON only |
+| `-V, --version` | Print version and exit |
+| `-h, --help` | Show usage |
+
+On Windows you can also run `ilib-zic.bat` from the package directory.
+
+## Programmatic API
+
+```javascript
+import { ZoneInfoPipeline } from "ilib-zic";
+
+const result = new ZoneInfoPipeline({
+    srcDir: "/path/to/tzdata",
+    localeDir: "/path/to/locale",
+    verbose: true,
+}).run();
+
+console.log(`Wrote ${result.zoneCount} zones to ${result.localeDir}`);
+```
+
+Lower-level APIs (`ZoneInfoCompiler`, `ZoneInfoEnricher`, `LocaleDataWriter`)
+are also exported for custom pipelines.
+
+## Development
+
+From the monorepo root:
+
+```
+pnpm --filter ilib-zic build
+pnpm --filter ilib-zic test
+pnpm --filter ilib-zic test:e2e
+```
+
+Or from `packages/zic`:
+
+```
+pnpm build
+pnpm test
+pnpm test:e2e
+```
 
 ## License
 

package/ilib-zic.bat

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\lib\index.js" %*

package/lib/JsonZoneWriter.d.ts

@@ -0,0 +1,42 @@
+import { Zone } from "./Zone";
+import { ZoneWriter } from "./ZoneWriter";
+/**
+ * Writes one JSON file per zone under the configured output directory.
+ */
+export declare class JsonZoneWriter extends ZoneWriter {
+    /**
+     * Root directory under which zone JSON files are written
+     * (for example `America/New_York.json` relative to this path).
+     */
+    private readonly outputDir;
+    /**
+     * When true, log progress and warnings to the console.
+     */
+    private readonly verbose;
+    /**
+     * @param outputDir Directory to write zone JSON files into
+     * @param verbose Whether to log progress
+     */
+    constructor(outputDir: string, verbose?: boolean);
+    /**
+     * Write a single zone's JSON payload to disk.
+     *
+     * Creates parent directories as needed. Does nothing when `json` is
+     * `null` (optionally warning when verbose).
+     *
+     * @param zoneName IANA zone id (path segments separated by `/`)
+     * @param json Zone payload to serialize, or `null` to skip
+     */
+    writeZone(zoneName: string, json: Record<string, unknown> | null): void;
+    /**
+     * Write every named zone in the map.
+     *
+     * Empty zone names are skipped and do not count toward the return value.
+     *
+     * @param zones Map of zone id to {@link Zone}
+     * @param currentOnly Passed through to {@link Zone.getJson}
+     * @returns Number of named zones processed
+     */
+    writeZones(zones: Map<string, Zone>, currentOnly: boolean): number;
+}
+//# sourceMappingURL=JsonZoneWriter.d.ts.map

package/lib/JsonZoneWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonZoneWriter.d.ts","sourceRoot":"","sources":["../src/JsonZoneWriter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC1C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC;;;OAGG;gBACS,SAAS,EAAE,MAAM,EAAE,OAAO,UAAQ;IAM9C;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI;IAkBvE;;;;;;;;OAQG;IACH,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM;CAarE"}

package/lib/JsonZoneWriter.js

@@ -0,0 +1,121 @@
+"use strict";
+/*
+ * JsonZoneWriter.ts - write compiled zone info as JSON files
+ *
+ * Copyright © 2014, 2020, 2026 JEDLSoft
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonZoneWriter = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ZoneWriter_1 = require("./ZoneWriter");
+/**
+ * Writes one JSON file per zone under the configured output directory.
+ */
+class JsonZoneWriter extends ZoneWriter_1.ZoneWriter {
+    /**
+     * @param outputDir Directory to write zone JSON files into
+     * @param verbose Whether to log progress
+     */
+    constructor(outputDir, verbose = false) {
+        super();
+        this.outputDir = outputDir;
+        this.verbose = verbose;
+    }
+    /**
+     * Write a single zone's JSON payload to disk.
+     *
+     * Creates parent directories as needed. Does nothing when `json` is
+     * `null` (optionally warning when verbose).
+     *
+     * @param zoneName IANA zone id (path segments separated by `/`)
+     * @param json Zone payload to serialize, or `null` to skip
+     */
+    writeZone(zoneName, json) {
+        if (json === null) {
+            if (this.verbose) {
+                console.warn("Zone " + zoneName + " has no json.");
+            }
+            return;
+        }
+        const file = path.join(this.outputDir, zoneName + ".json");
+        const dir = path.dirname(file);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        if (this.verbose) {
+            console.log("Writing output file " + file);
+        }
+        fs.writeFileSync(file, JSON.stringify(json, null, 4), "utf-8");
+    }
+    /**
+     * Write every named zone in the map.
+     *
+     * Empty zone names are skipped and do not count toward the return value.
+     *
+     * @param zones Map of zone id to {@link Zone}
+     * @param currentOnly Passed through to {@link Zone.getJson}
+     * @returns Number of named zones processed
+     */
+    writeZones(zones, currentOnly) {
+        let count = 0;
+        for (const [zoneName, zone] of zones) {
+            if (zoneName && zoneName.length > 0) {
+                if (this.verbose) {
+                    console.log("Processing zone " + zoneName);
+                }
+                this.writeZone(zoneName, zone.getJson(currentOnly));
+                count++;
+            }
+        }
+        return count;
+    }
+}
+exports.JsonZoneWriter = JsonZoneWriter;
+//# sourceMappingURL=JsonZoneWriter.js.map

package/lib/JsonZoneWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonZoneWriter.js","sourceRoot":"","sources":["../src/JsonZoneWriter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAG7B,6CAA0C;AAE1C;;GAEG;AACH,MAAa,cAAe,SAAQ,uBAAU;IAY1C;;;OAGG;IACH,YAAY,SAAiB,EAAE,OAAO,GAAG,KAAK;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAgB,EAAE,IAAoC;QAC5D,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,QAAQ,GAAG,eAAe,CAAC,CAAC;YACvD,CAAC;YACD,OAAO;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,KAAwB,EAAE,WAAoB;QACrD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YACnC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,QAAQ,CAAC,CAAC;gBAC/C,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;gBACpD,KAAK,EAAE,CAAC;YACZ,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AAvED,wCAuEC"}

package/lib/LocaleDataWriter.d.ts

@@ -0,0 +1,77 @@
+import type { EnrichedTzData, ZoneInfo } from "./types";
+/**
+ * Options for {@link LocaleDataWriter}.
+ */
+export interface LocaleDataWriterOptions {
+    /**
+     * Locale data root directory (parent of `zoneinfo/`, also receives
+     * `timezone.jf` and `und/<CC>/timezone.jf`).
+     */
+    localeDir: string;
+    /**
+     * When true, emit progress messages to stdout.
+     */
+    verbose?: boolean;
+}
+/**
+ * Summary of a successful write.
+ */
+export interface WriteResult {
+    /** Number of per-zone JSON files written under `zoneinfo/`. */
+    zoneCount: number;
+    /** Number of `und/<CC>/timezone.jf` files written. */
+    countryTimezoneCount: number;
+    /** Absolute path to the locale root. */
+    localeDir: string;
+}
+/**
+ * Writes enriched timezone data to an ilib locale directory tree.
+ *
+ * Output layout matches `ilib/js/data/locale`:
+ * - `zoneinfo/<Continent>/<City>.json`
+ * - `zoneinfo/zonetab.json`
+ * - `timezone.jf`
+ * - `und/<CC>/timezone.jf`
+ *
+ * JSON is pretty-printed with 4-space indent and stable key ordering
+ * (via `json-stable-stringify`).
+ */
+export declare class LocaleDataWriter {
+    private readonly localeDir;
+    private readonly verbose;
+    /**
+     * @param options Writer configuration
+     */
+    constructor(options: LocaleDataWriterOptions);
+    /**
+     * Persist a full enriched model under {@link LocaleDataWriterOptions.localeDir}.
+     *
+     * @param data Enriched zones and metadata from {@link ZoneInfoEnricher}
+     * @returns Write summary
+     * @throws Error when `data` is null/undefined/not an object, or when
+     *     `zones`, `countryToZones`, `rootTimezone`, or `countryTimezones`
+     *     are missing
+     * @throws Error when `localeDir` exists but is not a directory
+     */
+    write(data: EnrichedTzData): WriteResult;
+    /**
+     * Persist compiler-only zone JSON under `localeDir/zoneinfo/`.
+     *
+     * Used by `--compile-only`: no `c`/`n`, no zonetab, no timezone.jf.
+     *
+     * @param zones Zone id → compiler output
+     * @returns Number of zone files written
+     * @throws Error when `zones` is null, undefined, or not an object
+     * @throws Error when `localeDir` exists but is not a directory
+     */
+    writeZonesOnly(zones: Record<string, ZoneInfo>): number;
+    /**
+     * Resolve and validate the locale root directory.
+     */
+    private ensureLocaleDir;
+    /**
+     * Write pretty-printed, stably keyed JSON.
+     */
+    private writeJsonFile;
+}
+//# sourceMappingURL=LocaleDataWriter.d.ts.map

package/lib/LocaleDataWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleDataWriter.d.ts","sourceRoot":"","sources":["../src/LocaleDataWriter.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC;;OAEG;gBACS,OAAO,EAAE,uBAAuB;IAQ5C;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW;IAyDxC;;;;;;;;;OASG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM;IAoBvD;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAWxB"}

package/lib/LocaleDataWriter.js

@@ -0,0 +1,190 @@
+"use strict";
+/*
+ * LocaleDataWriter.ts - write enriched timezone locale data once
+ *
+ * Copyright © 2026 JEDLSoft
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocaleDataWriter = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const json_stable_stringify_1 = __importDefault(require("json-stable-stringify"));
+const ilib_data_utils_1 = require("ilib-data-utils");
+/**
+ * Writes enriched timezone data to an ilib locale directory tree.
+ *
+ * Output layout matches `ilib/js/data/locale`:
+ * - `zoneinfo/<Continent>/<City>.json`
+ * - `zoneinfo/zonetab.json`
+ * - `timezone.jf`
+ * - `und/<CC>/timezone.jf`
+ *
+ * JSON is pretty-printed with 4-space indent and stable key ordering
+ * (via `json-stable-stringify`).
+ */
+class LocaleDataWriter {
+    /**
+     * @param options Writer configuration
+     */
+    constructor(options) {
+        if (!options || !options.localeDir) {
+            throw new Error("localeDir is required");
+        }
+        this.localeDir = options.localeDir;
+        this.verbose = Boolean(options.verbose);
+    }
+    /**
+     * Persist a full enriched model under {@link LocaleDataWriterOptions.localeDir}.
+     *
+     * @param data Enriched zones and metadata from {@link ZoneInfoEnricher}
+     * @returns Write summary
+     * @throws Error when `data` is null/undefined/not an object, or when
+     *     `zones`, `countryToZones`, `rootTimezone`, or `countryTimezones`
+     *     are missing
+     * @throws Error when `localeDir` exists but is not a directory
+     */
+    write(data) {
+        if (data === null || data === undefined || typeof data !== "object") {
+            throw new Error("data must be an object");
+        }
+        if (data.zones === undefined) {
+            throw new Error("data.zones is required");
+        }
+        if (data.countryToZones === undefined) {
+            throw new Error("data.countryToZones is required");
+        }
+        if (data.rootTimezone === undefined) {
+            throw new Error("data.rootTimezone is required");
+        }
+        if (data.countryTimezones === undefined) {
+            throw new Error("data.countryTimezones is required");
+        }
+        const localeDir = this.ensureLocaleDir();
+        const zoneinfoDir = path.join(localeDir, "zoneinfo");
+        ilib_data_utils_1.Utils.makeDirs(zoneinfoDir);
+        let zoneCount = 0;
+        for (const zoneId of Object.keys(data.zones)) {
+            this.writeJsonFile(path.join(zoneinfoDir, zoneId + ".json"), data.zones[zoneId]);
+            zoneCount++;
+        }
+        this.writeJsonFile(path.join(zoneinfoDir, "zonetab.json"), data.countryToZones);
+        this.writeJsonFile(path.join(localeDir, "timezone.jf"), data.rootTimezone);
+        let countryTimezoneCount = 0;
+        for (const cc of Object.keys(data.countryTimezones)) {
+            const dir = path.join(localeDir, "und", cc);
+            ilib_data_utils_1.Utils.makeDirs(dir);
+            this.writeJsonFile(path.join(dir, "timezone.jf"), data.countryTimezones[cc]);
+            countryTimezoneCount++;
+        }
+        return {
+            zoneCount,
+            countryTimezoneCount,
+            localeDir,
+        };
+    }
+    /**
+     * Persist compiler-only zone JSON under `localeDir/zoneinfo/`.
+     *
+     * Used by `--compile-only`: no `c`/`n`, no zonetab, no timezone.jf.
+     *
+     * @param zones Zone id → compiler output
+     * @returns Number of zone files written
+     * @throws Error when `zones` is null, undefined, or not an object
+     * @throws Error when `localeDir` exists but is not a directory
+     */
+    writeZonesOnly(zones) {
+        if (zones === null || zones === undefined || typeof zones !== "object") {
+            throw new Error("zones must be an object");
+        }
+        const localeDir = this.ensureLocaleDir();
+        const zoneinfoDir = path.join(localeDir, "zoneinfo");
+        ilib_data_utils_1.Utils.makeDirs(zoneinfoDir);
+        let count = 0;
+        for (const zoneId of Object.keys(zones)) {
+            this.writeJsonFile(path.join(zoneinfoDir, zoneId + ".json"), zones[zoneId]);
+            count++;
+        }
+        return count;
+    }
+    /**
+     * Resolve and validate the locale root directory.
+     */
+    ensureLocaleDir() {
+        const localeDir = path.resolve(this.localeDir);
+        if (fs.existsSync(localeDir)) {
+            if (!fs.statSync(localeDir).isDirectory()) {
+                throw new Error(localeDir + " is not a directory");
+            }
+        }
+        else {
+            ilib_data_utils_1.Utils.makeDirs(localeDir);
+        }
+        return localeDir;
+    }
+    /**
+     * Write pretty-printed, stably keyed JSON.
+     */
+    writeJsonFile(filePath, value) {
+        var _a;
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            ilib_data_utils_1.Utils.makeDirs(dir);
+        }
+        if (this.verbose) {
+            console.log("Writing out " + filePath);
+        }
+        const text = (_a = (0, json_stable_stringify_1.default)(value, { space: 4 })) !== null && _a !== void 0 ? _a : "{}";
+        fs.writeFileSync(filePath, text, "utf-8");
+    }
+}
+exports.LocaleDataWriter = LocaleDataWriter;
+//# sourceMappingURL=LocaleDataWriter.js.map

package/lib/LocaleDataWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleDataWriter.js","sourceRoot":"","sources":["../src/LocaleDataWriter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAE7B,kFAA8C;AAC9C,qDAAwC;AAgCxC;;;;;;;;;;;GAWG;AACH,MAAa,gBAAgB;IAIzB;;OAEG;IACH,YAAY,OAAgC;QACxC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAoB;QACtB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrD,uBAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAE5B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,EACxC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CACrB,CAAC;YACF,SAAS,EAAE,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EACtC,IAAI,CAAC,cAAc,CACtB,CAAC;QACF,IAAI,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EACnC,IAAI,CAAC,YAAY,CACpB,CAAC;QAEF,IAAI,oBAAoB,GAAG,CAAC,CAAC;QAC7B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5C,uBAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACpB,IAAI,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAC7B,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAC5B,CAAC;YACF,oBAAoB,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO;YACH,SAAS;YACT,oBAAoB;YACpB,SAAS;SACZ,CAAC;IACN,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,KAA+B;QAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrD,uBAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAE5B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,EACxC,KAAK,CAAC,MAAM,CAAC,CAChB,CAAC;YACF,KAAK,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,eAAe;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,qBAAqB,CAAC,CAAC;YACvD,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,uBAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAAgB,EAAE,KAAc;;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,uBAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,IAAI,GAAG,MAAA,IAAA,+BAAS,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,mCAAI,IAAI,CAAC;QACpD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;CACJ;AA7ID,4CA6IC"}

package/lib/Offset.d.ts

@@ -0,0 +1,86 @@
+import { RelativeDate } from "./RelativeDate";
+import { RuleSet } from "./RuleSet";
+/**
+ * Models an offset from GMT in a particular time frame, optionally with
+ * a shared daylight-savings rule set.
+ */
+export declare class Offset {
+    /**
+     * Hours component of the GMT offset (may be negative).
+     */
+    offsetHours: number;
+    /**
+     * Minutes component of the GMT offset.
+     */
+    offsetMinutes: number;
+    /**
+     * Seconds component of the GMT offset.
+     */
+    offsetSeconds: number;
+    /**
+     * Named DST rule set referenced by this offset, or `null` when none
+     * (`-` in tzdata).
+     */
+    rules: RuleSet | null;
+    /**
+     * Abbreviation format string from tzdata FORMAT column
+     * (for example `"E%sT"`, `"%z"`, `"GMT"`, or `"-03/-02"`).
+     *
+     * When serializing, `%s` becomes `{c}` and `%z` becomes a numeric
+     * UT-offset abbreviation (`-03` or `-03/-02` for std/DST), matching
+     * IANA zic's `abbroffset` rules.
+     */
+    format: string | null;
+    /**
+     * When this offset stops applying. `null` means it is still current
+     * (no until fields on the zone line).
+     */
+    endDate: RelativeDate | null;
+    /**
+     * Create an empty offset, or parse fields from a Zone / continuation line.
+     *
+     * @param line Line text to parse (zone name may occupy `fields[0]`)
+     * @param ruleSets Shared map of named rule sets
+     * @param timeZoneName Zone id (kept for API parity; unused in parsing)
+     */
+    constructor(line?: string, ruleSets?: Map<string, RuleSet>, timeZoneName?: string);
+    /**
+     * Populate this offset from a split Zone or continuation line.
+     *
+     * Always reads the numeric GMT offset from `fields[1]` after splitting
+     * on whitespace (matching the Java port).
+     *
+     * @param line Source line text
+     * @param ruleSets Shared map of named rule sets (created on demand)
+     * @param _timeZoneName Unused; retained for call-site compatibility
+     * @throws {ParseException} If the line does not have enough fields
+     */
+    setFields(line: string, ruleSets: Map<string, RuleSet>, _timeZoneName: string): void;
+    /**
+     * Compare by end date. An offset with no end date (current) sorts last.
+     *
+     * @param other Offset to compare against
+     * @returns Negative if this ends earlier, positive if later, else `0`
+     */
+    compareTo(other: Offset): number;
+    /**
+     * Serialize this offset to the compact JSON shape used in zoneinfo.
+     *
+     * When `currentOnly` is true and rules are present, also emits wall-time
+     * DST start (`s`) and end (`e`) rules for the current year.
+     *
+     * @param currentOnly Whether to include current DST start/end rules
+     * @returns JSON object with keys such as `o`, `f`, `s`, and `e`
+     */
+    getJson(currentOnly: boolean): Record<string, unknown>;
+    /**
+     * Expand IANA `%z` FORMAT using zic's `abbroffset` rules:
+     * `±hh`, `±hhmm`, or `±hhmmss` (shortest form that keeps precision).
+     * With a DST savings rule, emit `std/dst` slash form (e.g. `-03/-02`).
+     *
+     * @param startRule Current DST-start rule with savings, if any
+     * @returns Numeric abbreviation string for `f`
+     */
+    private formatPercentZ;
+}
+//# sourceMappingURL=Offset.d.ts.map

package/lib/Offset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Offset.d.ts","sourceRoot":"","sources":["../src/Offset.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,qBAAa,MAAM;IACf;;OAEG;IACH,WAAW,SAAK;IAEhB;;OAEG;IACH,aAAa,SAAK;IAElB;;OAEG;IACH,aAAa,SAAK;IAElB;;;OAGG;IACH,KAAK,EAAE,OAAO,GAAG,IAAI,CAAQ;IAE7B;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B;;;OAGG;IACH,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEpC;;;;;;OAMG;gBAEC,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,CAAC,EAAE,MAAM;IAOzB;;;;;;;;;;OAUG;IACH,SAAS,CACL,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,MAAM,GACtB,IAAI;IA2CP;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAWhC;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgFtD;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;CAyBzB"}