@corbet-labs/cdate 0.1.0 → 0.2.0

package/LICENSES/FSL-1.1-ALv2.txt

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 Julian Y. Richard Corbet
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+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.

package/README.md

@@ -1,25 +1,102 @@
-# @corbet-labs/cdate
+# cdate
 
-Deterministic locale-correct date formats for formal correspondence. Pure
-port of the [cdate](https://github.com/corbet-labs/cdate) Rust crate: zero
-dependencies, zero Node APIs, synchronous, no I/O.
+**Reproducible date formats for correspondence.**
 
-```ts
-import { longDate, monthYear } from '@corbet-labs/cdate';
+[![crates.io](https://img.shields.io/crates/v/cdate.svg)](https://crates.io/crates/cdate) [![npm](https://img.shields.io/npm/v/@corbet-labs/cdate.svg)](https://www.npmjs.com/package/@corbet-labs/cdate) [![Rust API](https://docs.rs/cdate/badge.svg)](https://docs.rs/cdate)
 
-longDate('de-CH', 2026, 9, 7); // 7. September 2026
-monthYear('en', 2026, 9); // September 2026
+Format a Gregorian calendar date without a timezone, operating-system locale, or network dependency. The same inputs produce the same text in Rust, JavaScript, Python, and Typst.
+
+```js
+import { longDate } from '@corbet-labs/cdate';
+
+longDate('de-ch', 2026, 9, 7);
+// 7. September 2026
+```
+
+## Install
+
+| Environment | Command |
+| --- | --- |
+| Rust / Cargo | `cargo add cdate` |
+| Node.js / npm | `npm install @corbet-labs/cdate` |
+| pnpm | `pnpm add @corbet-labs/cdate` |
+| Yarn | `yarn add @corbet-labs/cdate` |
+| Bun | `bun add @corbet-labs/cdate` |
+| Deno | `deno add npm:@corbet-labs/cdate` |
+
+The 0.2.0 JavaScript distribution includes compiled ESM, CommonJS,
+TypeScript declarations, and a standalone browser module. Node.js 20+ is
+supported; no TypeScript loader is required.
+
+```js
+// CommonJS
+const { longDate } = require('@corbet-labs/cdate');
 ```
 
-Unknown locales fall back through the base language to English. Invalid
-calendar dates yield `null`, never a best effort. Behavior is defined by
-`tables/*.json` at the repository root; `tests/vectors/*.json` is the
-shared conformance suite.
+```html
+<script type="module">
+  import { longDate } from 'https://cdn.jsdelivr.net/npm/@corbet-labs/cdate@0.2.0/dist/browser.js';
+  console.log(longDate('de-ch', 2026, 9, 7));
+</script>
+```
+
+Python wheels, source distributions, and CLI instructions are in the
+[installation guide](https://github.com/corbet-labs/cdate/blob/main/docs/installation.md).
+JSR publication and Typst availability are listed there explicitly.
+
+## Rust
+
+```rust
+use cdate::{long_date, month_year};
+
+assert_eq!(long_date("de-ch", 2026, 9, 7).as_deref(), Some("7. September 2026"));
+assert_eq!(month_year("en", 2026, 9).as_deref(), Some("September 2026"));
+```
+
+## Python
+
+```python
+from cdate import long_date
+
+assert long_date("de-ch", 2026, 9, 7) == '7. September 2026'
+```
+
+## API
+
+| JavaScript / Python or Rust | Example for `de-ch` |
+| --- | --- |
+| `longDate` / `long_date` | `7. September 2026` |
+| `mediumDate` / `medium_date` | `07.09.2026` |
+| `shortDate` / `short_date` | `07.09.26` |
+| `monthYear` / `month_year` | `September 2026` |
+| `isValidDate` / `is_valid_date` | Calendar-date validation |
+
+The seven date-table entries are `de`, `de-at`, `de-ch`, `de-li`, `en`, `en-gb`, and `en-us`. Matching is case-insensitive; other locales fall back through the base language to English. Impossible calendar dates return `null`/`None`. Inputs are calendar components, not timestamps. Other family libraries have broader locale coverage.
+
+## Correspondence family
+
+| Library | Responsibility |
+| --- | --- |
+| [cletter](https://github.com/corbet-labs/cletter) | Compose the correspondence helpers |
+| [cgreet](https://github.com/corbet-labs/cgreet) | German salutations and titles |
+| [cfarewell](https://github.com/corbet-labs/cfarewell) | Locale-specific closings |
+| [cdate](https://github.com/corbet-labs/cdate) | Calendar-date formatting |
+| [cink](https://github.com/corbet-labs/cink) | Handwritten signature images |
+
+
+## Development
+
+Behavior is defined by [the locale tables](https://github.com/corbet-labs/cdate/tree/main/tables)
+and [shared conformance vectors](https://github.com/corbet-labs/cdate/tree/main/tests/vectors).
+Rust, JavaScript, and Python run the same vectors. Selected CI checks exercise
+installed JavaScript tarballs, Python wheels and command-line entrypoints, and
+Typst packages. Release validation records the actual runtime and platform;
+Linux results do not establish native Windows or macOS coverage.
+All five Rust crates forbid unsafe code in their own source.
 
-Run `bun ./scripts/conformance.mts` and `tsc --noEmit -p ./tsconfig.json`
-before pushing.
+See [the release guide](https://github.com/corbet-labs/cdate/blob/main/docs/releasing.md)
+for generation, verification, and publication commands.
 
 ## License
 
-FSL-1.1-ALv2. Each published version becomes available under Apache-2.0
-two years after publication.
+FSL-1.1-ALv2. Each release becomes available under Apache-2.0 two years after publication. See [the full license](https://github.com/corbet-labs/cdate/blob/main/LICENSES/FSL-1.1-ALv2.txt) for permitted use.

package/dist/browser.js

@@ -0,0 +1,97 @@
+// src/generated/tables.ts
+var DATES_TABLE = { fallback: "en", locales: { de: { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-at": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-ch": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-li": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, en: { long: "{month_long} {day}, {yyyy}", medium: "{month_short} {day}, {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], short: "{month}/{day}/{yy}" }, "en-gb": { long: "{day} {month_long} {yyyy}", medium: "{day} {month_short} {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sept", "Oct", "Nov", "Dec"], short: "{dd}/{mm}/{yyyy}" }, "en-us": { long: "{month_long} {day}, {yyyy}", medium: "{month_short} {day}, {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], short: "{month}/{day}/{yy}" } }, supported: ["de", "de-at", "de-ch", "de-li", "en", "en-gb", "en-us"] };
+
+// src/index.ts
+var table = DATES_TABLE;
+function baseLanguage(locale) {
+  return locale.split("-")[0] ?? locale;
+}
+function resolveKey(locale) {
+  const lower = locale.toLowerCase();
+  if (Object.hasOwn(table.locales, lower))
+    return lower;
+  const base = baseLanguage(lower);
+  return Object.hasOwn(table.locales, base) ? base : table.fallback;
+}
+function daysInMonth(year, month) {
+  switch (month) {
+    case 1:
+    case 3:
+    case 5:
+    case 7:
+    case 8:
+    case 10:
+    case 12:
+      return 31;
+    case 4:
+    case 6:
+    case 9:
+    case 11:
+      return 30;
+    case 2:
+      return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28;
+    default:
+      return 0;
+  }
+}
+function isValidDate(year, month, day) {
+  return Number.isInteger(year) && Number.isInteger(month) && Number.isInteger(day) && month >= 1 && month <= 12 && day >= 1 && day <= daysInMonth(year, month);
+}
+function padTwo(value) {
+  return value < 10 ? `0${value}` : `${value}`;
+}
+function padYear(year) {
+  const text = `${year}`;
+  if (year < 0 || year >= 1000)
+    return text;
+  if (year >= 100)
+    return `0${text}`;
+  if (year >= 10)
+    return `00${text}`;
+  return `000${text}`;
+}
+function render(entry, pattern, year, month, day) {
+  return pattern.replaceAll("{yyyy}", padYear(year)).replaceAll("{yy}", padTwo((year % 100 + 100) % 100)).replaceAll("{month_long}", entry.months_long[month - 1] ?? "").replaceAll("{month_short}", entry.months_short?.[month - 1] ?? "").replaceAll("{dd}", padTwo(day)).replaceAll("{mm}", padTwo(month)).replaceAll("{day}", `${day}`).replaceAll("{month}", `${month}`);
+}
+function formatWith(locale, select, year, month, day) {
+  if (!isValidDate(year, month, day))
+    return null;
+  const entry = table.locales[resolveKey(locale)];
+  if (entry === undefined)
+    return null;
+  return render(entry, select(entry), year, month, day);
+}
+function longDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.long, year, month, day);
+}
+function mediumDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.medium, year, month, day);
+}
+function shortDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.short, year, month, day);
+}
+function monthYear(locale, year, month) {
+  if (!Number.isInteger(year) || !Number.isInteger(month) || month < 1 || month > 12)
+    return null;
+  const entry = table.locales[resolveKey(locale)];
+  if (entry === undefined)
+    return null;
+  return render(entry, entry.month_year, year, month, 1);
+}
+function availableLocales() {
+  return Object.keys(table.locales).sort();
+}
+function isSupported(locale) {
+  if (table.supported.includes(locale))
+    return true;
+  return table.supported.includes(baseLanguage(locale.toLowerCase()));
+}
+export {
+  shortDate,
+  monthYear,
+  mediumDate,
+  longDate,
+  isValidDate,
+  isSupported,
+  availableLocales
+};

package/dist/index.cjs

@@ -0,0 +1,139 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  shortDate: () => shortDate,
+  monthYear: () => monthYear,
+  mediumDate: () => mediumDate,
+  longDate: () => longDate,
+  isValidDate: () => isValidDate,
+  isSupported: () => isSupported,
+  availableLocales: () => availableLocales
+});
+module.exports = __toCommonJS(exports_src);
+
+// src/generated/tables.ts
+var DATES_TABLE = { fallback: "en", locales: { de: { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-at": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-ch": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-li": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, en: { long: "{month_long} {day}, {yyyy}", medium: "{month_short} {day}, {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], short: "{month}/{day}/{yy}" }, "en-gb": { long: "{day} {month_long} {yyyy}", medium: "{day} {month_short} {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sept", "Oct", "Nov", "Dec"], short: "{dd}/{mm}/{yyyy}" }, "en-us": { long: "{month_long} {day}, {yyyy}", medium: "{month_short} {day}, {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], short: "{month}/{day}/{yy}" } }, supported: ["de", "de-at", "de-ch", "de-li", "en", "en-gb", "en-us"] };
+
+// src/index.ts
+var table = DATES_TABLE;
+function baseLanguage(locale) {
+  return locale.split("-")[0] ?? locale;
+}
+function resolveKey(locale) {
+  const lower = locale.toLowerCase();
+  if (Object.hasOwn(table.locales, lower))
+    return lower;
+  const base = baseLanguage(lower);
+  return Object.hasOwn(table.locales, base) ? base : table.fallback;
+}
+function daysInMonth(year, month) {
+  switch (month) {
+    case 1:
+    case 3:
+    case 5:
+    case 7:
+    case 8:
+    case 10:
+    case 12:
+      return 31;
+    case 4:
+    case 6:
+    case 9:
+    case 11:
+      return 30;
+    case 2:
+      return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28;
+    default:
+      return 0;
+  }
+}
+function isValidDate(year, month, day) {
+  return Number.isInteger(year) && Number.isInteger(month) && Number.isInteger(day) && month >= 1 && month <= 12 && day >= 1 && day <= daysInMonth(year, month);
+}
+function padTwo(value) {
+  return value < 10 ? `0${value}` : `${value}`;
+}
+function padYear(year) {
+  const text = `${year}`;
+  if (year < 0 || year >= 1000)
+    return text;
+  if (year >= 100)
+    return `0${text}`;
+  if (year >= 10)
+    return `00${text}`;
+  return `000${text}`;
+}
+function render(entry, pattern, year, month, day) {
+  return pattern.replaceAll("{yyyy}", padYear(year)).replaceAll("{yy}", padTwo((year % 100 + 100) % 100)).replaceAll("{month_long}", entry.months_long[month - 1] ?? "").replaceAll("{month_short}", entry.months_short?.[month - 1] ?? "").replaceAll("{dd}", padTwo(day)).replaceAll("{mm}", padTwo(month)).replaceAll("{day}", `${day}`).replaceAll("{month}", `${month}`);
+}
+function formatWith(locale, select, year, month, day) {
+  if (!isValidDate(year, month, day))
+    return null;
+  const entry = table.locales[resolveKey(locale)];
+  if (entry === undefined)
+    return null;
+  return render(entry, select(entry), year, month, day);
+}
+function longDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.long, year, month, day);
+}
+function mediumDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.medium, year, month, day);
+}
+function shortDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.short, year, month, day);
+}
+function monthYear(locale, year, month) {
+  if (!Number.isInteger(year) || !Number.isInteger(month) || month < 1 || month > 12)
+    return null;
+  const entry = table.locales[resolveKey(locale)];
+  if (entry === undefined)
+    return null;
+  return render(entry, entry.month_year, year, month, 1);
+}
+function availableLocales() {
+  return Object.keys(table.locales).sort();
+}
+function isSupported(locale) {
+  if (table.supported.includes(locale))
+    return true;
+  return table.supported.includes(baseLanguage(locale.toLowerCase()));
+}

package/dist/index.js

@@ -0,0 +1,97 @@
+// src/generated/tables.ts
+var DATES_TABLE = { fallback: "en", locales: { de: { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-at": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-ch": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, "de-li": { long: "{day}. {month_long} {yyyy}", medium: "{dd}.{mm}.{yyyy}", month_year: "{month_long} {yyyy}", months_long: ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], short: "{dd}.{mm}.{yy}" }, en: { long: "{month_long} {day}, {yyyy}", medium: "{month_short} {day}, {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], short: "{month}/{day}/{yy}" }, "en-gb": { long: "{day} {month_long} {yyyy}", medium: "{day} {month_short} {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sept", "Oct", "Nov", "Dec"], short: "{dd}/{mm}/{yyyy}" }, "en-us": { long: "{month_long} {day}, {yyyy}", medium: "{month_short} {day}, {yyyy}", month_year: "{month_long} {yyyy}", months_long: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], months_short: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], short: "{month}/{day}/{yy}" } }, supported: ["de", "de-at", "de-ch", "de-li", "en", "en-gb", "en-us"] };
+
+// src/index.ts
+var table = DATES_TABLE;
+function baseLanguage(locale) {
+  return locale.split("-")[0] ?? locale;
+}
+function resolveKey(locale) {
+  const lower = locale.toLowerCase();
+  if (Object.hasOwn(table.locales, lower))
+    return lower;
+  const base = baseLanguage(lower);
+  return Object.hasOwn(table.locales, base) ? base : table.fallback;
+}
+function daysInMonth(year, month) {
+  switch (month) {
+    case 1:
+    case 3:
+    case 5:
+    case 7:
+    case 8:
+    case 10:
+    case 12:
+      return 31;
+    case 4:
+    case 6:
+    case 9:
+    case 11:
+      return 30;
+    case 2:
+      return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28;
+    default:
+      return 0;
+  }
+}
+function isValidDate(year, month, day) {
+  return Number.isInteger(year) && Number.isInteger(month) && Number.isInteger(day) && month >= 1 && month <= 12 && day >= 1 && day <= daysInMonth(year, month);
+}
+function padTwo(value) {
+  return value < 10 ? `0${value}` : `${value}`;
+}
+function padYear(year) {
+  const text = `${year}`;
+  if (year < 0 || year >= 1000)
+    return text;
+  if (year >= 100)
+    return `0${text}`;
+  if (year >= 10)
+    return `00${text}`;
+  return `000${text}`;
+}
+function render(entry, pattern, year, month, day) {
+  return pattern.replaceAll("{yyyy}", padYear(year)).replaceAll("{yy}", padTwo((year % 100 + 100) % 100)).replaceAll("{month_long}", entry.months_long[month - 1] ?? "").replaceAll("{month_short}", entry.months_short?.[month - 1] ?? "").replaceAll("{dd}", padTwo(day)).replaceAll("{mm}", padTwo(month)).replaceAll("{day}", `${day}`).replaceAll("{month}", `${month}`);
+}
+function formatWith(locale, select, year, month, day) {
+  if (!isValidDate(year, month, day))
+    return null;
+  const entry = table.locales[resolveKey(locale)];
+  if (entry === undefined)
+    return null;
+  return render(entry, select(entry), year, month, day);
+}
+function longDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.long, year, month, day);
+}
+function mediumDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.medium, year, month, day);
+}
+function shortDate(locale, year, month, day) {
+  return formatWith(locale, (entry) => entry.short, year, month, day);
+}
+function monthYear(locale, year, month) {
+  if (!Number.isInteger(year) || !Number.isInteger(month) || month < 1 || month > 12)
+    return null;
+  const entry = table.locales[resolveKey(locale)];
+  if (entry === undefined)
+    return null;
+  return render(entry, entry.month_year, year, month, 1);
+}
+function availableLocales() {
+  return Object.keys(table.locales).sort();
+}
+function isSupported(locale) {
+  if (table.supported.includes(locale))
+    return true;
+  return table.supported.includes(baseLanguage(locale.toLowerCase()));
+}
+export {
+  shortDate,
+  monthYear,
+  mediumDate,
+  longDate,
+  isValidDate,
+  isSupported,
+  availableLocales
+};

package/dist/types/generated/tables.d.ts

@@ -0,0 +1,2 @@
+export declare const PACKAGE_VERSION: string;
+export declare const DATES_TABLE: unknown;

package/dist/types/index.d.cts

@@ -0,0 +1,41 @@
+export interface LocaleEntry {
+    long: string;
+    medium: string;
+    short: string;
+    month_year: string;
+    months_long: string[];
+    months_short?: string[];
+}
+export interface DatesTable {
+    locales: Record<string, LocaleEntry>;
+    supported: string[];
+    fallback: string;
+}
+/** Whether a proleptic Gregorian calendar date exists. */
+export declare function isValidDate(year: number, month: number, day: number): boolean;
+/**
+ * Long date for a locale: `7. September 2026` (de),
+ * `September 7, 2026` (en). Unknown locales fall back through the base
+ * language to English. Returns `null` for invalid calendar dates.
+ */
+export declare function longDate(locale: string, year: number, month: number, day: number): string | null;
+/**
+ * Medium date for a locale: `07.09.2026` (de), `Sep 7, 2026` (en).
+ * Returns `null` for invalid calendar dates.
+ */
+export declare function mediumDate(locale: string, year: number, month: number, day: number): string | null;
+/**
+ * Short numeric date for a locale: `07.09.26` (de), `9/7/26` (en).
+ * Returns `null` for invalid calendar dates.
+ */
+export declare function shortDate(locale: string, year: number, month: number, day: number): string | null;
+/**
+ * Month and year for a correspondence dateline: `September 2026`.
+ * Returns `null` for an invalid month.
+ */
+export declare function monthYear(locale: string, year: number, month: number): string | null;
+/** BCP 47 locale codes with a date-format entry, sorted. */
+export declare function availableLocales(): string[];
+/** Whether a locale code is supported: present in the supported set
+ * directly or through its (lowercased) base language. */
+export declare function isSupported(locale: string): boolean;

package/dist/types/index.d.ts

@@ -0,0 +1,41 @@
+export interface LocaleEntry {
+    long: string;
+    medium: string;
+    short: string;
+    month_year: string;
+    months_long: string[];
+    months_short?: string[];
+}
+export interface DatesTable {
+    locales: Record<string, LocaleEntry>;
+    supported: string[];
+    fallback: string;
+}
+/** Whether a proleptic Gregorian calendar date exists. */
+export declare function isValidDate(year: number, month: number, day: number): boolean;
+/**
+ * Long date for a locale: `7. September 2026` (de),
+ * `September 7, 2026` (en). Unknown locales fall back through the base
+ * language to English. Returns `null` for invalid calendar dates.
+ */
+export declare function longDate(locale: string, year: number, month: number, day: number): string | null;
+/**
+ * Medium date for a locale: `07.09.2026` (de), `Sep 7, 2026` (en).
+ * Returns `null` for invalid calendar dates.
+ */
+export declare function mediumDate(locale: string, year: number, month: number, day: number): string | null;
+/**
+ * Short numeric date for a locale: `07.09.26` (de), `9/7/26` (en).
+ * Returns `null` for invalid calendar dates.
+ */
+export declare function shortDate(locale: string, year: number, month: number, day: number): string | null;
+/**
+ * Month and year for a correspondence dateline: `September 2026`.
+ * Returns `null` for an invalid month.
+ */
+export declare function monthYear(locale: string, year: number, month: number): string | null;
+/** BCP 47 locale codes with a date-format entry, sorted. */
+export declare function availableLocales(): string[];
+/** Whether a locale code is supported: present in the supported set
+ * directly or through its (lowercased) base language. */
+export declare function isSupported(locale: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corbet-labs/cdate",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Deterministic locale-correct date formats for formal correspondence. Mirrors the cdate Rust crate release line.",
   "license": "FSL-1.1-ALv2",
   "publishConfig": {
@@ -9,26 +9,62 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/corbet-labs/cdate.git",
+    "url": "git+https://github.com/corbet-labs/cdate.git",
     "directory": "js/@corbet-labs/cdate"
   },
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.cjs",
+  "types": "./dist/types/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/browser.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
+    "dist/**/*",
     "src/**/*",
-    "README.md"
+    "README.md",
+    "LICENSES/**/*"
   ],
   "scripts": {
-    "prepack": "bash ./scripts/sync-assets.sh",
+    "prepack": "bun run build",
     "conformance": "bun ./scripts/conformance.mts",
-    "typecheck": "tsc --noEmit -p ./tsconfig.json"
+    "typecheck": "tsc --noEmit -p ./tsconfig.json",
+    "build": "bun ./scripts/build.mjs"
   },
   "devDependencies": {
     "@types/node": "25.8.0",
     "typescript": "6.0.3"
-  }
+  },
+  "module": "./dist/index.js",
+  "unpkg": "./dist/browser.js",
+  "jsdelivr": "./dist/browser.js",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "homepage": "https://github.com/corbet-labs/cdate#readme",
+  "bugs": {
+    "url": "https://github.com/corbet-labs/cdate/issues"
+  },
+  "keywords": [
+    "i18n",
+    "correspondence",
+    "typescript",
+    "rust",
+    "cdate"
+  ]
 }

package/src/generated/tables.ts

@@ -1,3 +1,3 @@
 // GENERATED by scripts/sync-assets.sh — do not edit.
-export const PACKAGE_VERSION = "0.1.0";
-export const DATES_TABLE = {"fallback": "en", "locales": {"de": {"long": "{day}. {month_long} {yyyy}", "medium": "{dd}.{mm}.{yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], "short": "{dd}.{mm}.{yy}"}, "de-AT": {"long": "{day}. {month_long} {yyyy}", "medium": "{dd}.{mm}.{yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], "short": "{dd}.{mm}.{yy}"}, "de-CH": {"long": "{day}. {month_long} {yyyy}", "medium": "{dd}.{mm}.{yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], "short": "{dd}.{mm}.{yy}"}, "en": {"long": "{month_long} {day}, {yyyy}", "medium": "{month_short} {day}, {yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], "months_short": ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], "short": "{month}/{day}/{yy}"}, "en-GB": {"long": "{day} {month_long} {yyyy}", "medium": "{day} {month_short} {yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], "months_short": ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sept", "Oct", "Nov", "Dec"], "short": "{dd}/{mm}/{yyyy}"}, "en-US": {"long": "{month_long} {day}, {yyyy}", "medium": "{month_short} {day}, {yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], "months_short": ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], "short": "{month}/{day}/{yy}"}}, "supported": ["de", "de-AT", "de-CH", "en", "en-GB", "en-US"]};
+export const PACKAGE_VERSION: string = "0.2.0";
+export const DATES_TABLE: unknown = {"fallback": "en", "locales": {"de": {"long": "{day}. {month_long} {yyyy}", "medium": "{dd}.{mm}.{yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], "short": "{dd}.{mm}.{yy}"}, "de-at": {"long": "{day}. {month_long} {yyyy}", "medium": "{dd}.{mm}.{yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], "short": "{dd}.{mm}.{yy}"}, "de-ch": {"long": "{day}. {month_long} {yyyy}", "medium": "{dd}.{mm}.{yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], "short": "{dd}.{mm}.{yy}"}, "de-li": {"long": "{day}. {month_long} {yyyy}", "medium": "{dd}.{mm}.{yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["Januar", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"], "short": "{dd}.{mm}.{yy}"}, "en": {"long": "{month_long} {day}, {yyyy}", "medium": "{month_short} {day}, {yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], "months_short": ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], "short": "{month}/{day}/{yy}"}, "en-gb": {"long": "{day} {month_long} {yyyy}", "medium": "{day} {month_short} {yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], "months_short": ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sept", "Oct", "Nov", "Dec"], "short": "{dd}/{mm}/{yyyy}"}, "en-us": {"long": "{month_long} {day}, {yyyy}", "medium": "{month_short} {day}, {yyyy}", "month_year": "{month_long} {yyyy}", "months_long": ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], "months_short": ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], "short": "{month}/{day}/{yy}"}}, "supported": ["de", "de-at", "de-ch", "de-li", "en", "en-gb", "en-us"]};

package/src/index.ts

@@ -6,7 +6,7 @@
  * at the repository root; `tests/vectors/*.json` is the shared conformance
  * suite.
  */
-import { DATES_TABLE } from './generated/tables.js';
+import { DATES_TABLE } from './generated/tables.ts';
 
 export interface LocaleEntry {
     long: string;
@@ -25,25 +25,15 @@ export interface DatesTable {
 
 const table = DATES_TABLE as DatesTable;
 
-/** Lowercased table key → canonical BCP 47 key. Tables keep canonical keys
- * for compatibility; inputs resolve case-insensitively through this index. */
-const canonicalByLower: Record<string, string> = {};
-for (const key of Object.keys(table.locales)) {
-    canonicalByLower[key.toLowerCase()] = key;
-}
-
 function baseLanguage(locale: string): string {
     return locale.split('-')[0] ?? locale;
 }
 
 function resolveKey(locale: string): string {
-    if (Object.hasOwn(table.locales, locale)) return locale;
-    const lowered = locale.toLowerCase();
-    const exact = canonicalByLower[lowered];
-    if (exact !== undefined) return exact;
-    const base = canonicalByLower[baseLanguage(lowered)];
-    if (base !== undefined) return base;
-    return table.fallback;
+    const lower = locale.toLowerCase();
+    if (Object.hasOwn(table.locales, lower)) return lower;
+    const base = baseLanguage(lower);
+    return Object.hasOwn(table.locales, base) ? base : table.fallback;
 }
 
 function daysInMonth(year: number, month: number): number {