@gobrand/tiempo 0.1.2 → 2.1.0

package/README.md

@@ -29,71 +29,153 @@ The Temporal API is already designed for timezone conversions, but it requires u
 ## Quick Start
 
 ```typescript
-import { utcToZonedTime, zonedTimeToUtc } from '@gobrand/tiempo';
+import { toZonedTime, toUtcString } from '@gobrand/tiempo';
 
 // Backend sends: "2025-01-20T20:00:00.000Z"
-const zoned = utcToZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
+const zoned = toZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
 console.log(zoned.hour); // 15 (3 PM in New York)
 
 // Send back to backend:
-const utc = zonedTimeToUtc(zoned);
+const utc = toUtcString(zoned);
 console.log(utc); // "2025-01-20T20:00:00Z"
 ```
 
 ## API
 
-### `utcToZonedTime(isoString, timezone)`
+### `toZonedTime(input, timezone)`
 
-Convert a UTC ISO string to a ZonedDateTime in the given timezone.
+Convert a UTC ISO string, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
 
 **Parameters:**
-- `isoString` (string): A UTC ISO 8601 string (e.g., `"2025-01-20T20:00:00.000Z"`)
+- `input` (string | Temporal.Instant | Temporal.ZonedDateTime): A UTC ISO 8601 string, Temporal.Instant, or Temporal.ZonedDateTime
 - `timezone` (string): An IANA timezone identifier (e.g., `"America/New_York"`, `"Europe/London"`)
 
 **Returns:** `Temporal.ZonedDateTime` - The same instant in the specified timezone
 
 **Example:**
 ```typescript
-import { utcToZonedTime } from '@gobrand/tiempo';
-
-// Backend sends: "2025-01-20T20:00:00.000Z"
-const zoned = utcToZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
+import { toZonedTime } from '@gobrand/tiempo';
 
+// From ISO string
+const zoned = toZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
 console.log(zoned.hour); // 15 (3 PM in New York)
 console.log(zoned.toString()); // "2025-01-20T15:00:00-05:00[America/New_York]"
+
+// From Instant
+const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+const zoned2 = toZonedTime(instant, "Asia/Tokyo");
+
+// From ZonedDateTime (convert to different timezone)
+const nyTime = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+const tokyoTime = toZonedTime(nyTime, "Asia/Tokyo");
 ```
 
-### `zonedTimeToUtc(zonedDateTime)`
+### `toUtc(input)`
 
-Convert a ZonedDateTime to a UTC ISO string.
+Convert a UTC ISO string or ZonedDateTime to a Temporal.Instant (UTC).
 
 **Parameters:**
-- `zonedDateTime` (`Temporal.ZonedDateTime`): A Temporal.ZonedDateTime instance
+- `input` (string | Temporal.ZonedDateTime): A UTC ISO 8601 string or Temporal.ZonedDateTime
 
-**Returns:** `string` - A UTC ISO 8601 string representation of the instant
+**Returns:** `Temporal.Instant` - A Temporal.Instant representing the same moment in UTC
 
 **Example:**
 ```typescript
-import { zonedTimeToUtc, utcToZonedTime } from '@gobrand/tiempo';
+import { toUtc } from '@gobrand/tiempo';
 
-const zoned = utcToZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
+// From ISO string
+const instant = toUtc("2025-01-20T20:00:00.000Z");
 
-// Send back to backend:
-const utc = zonedTimeToUtc(zoned);
-console.log(utc); // "2025-01-20T20:00:00Z"
+// From ZonedDateTime
+const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+const instant2 = toUtc(zoned);
+// Both represent the same UTC moment: 2025-01-20T20:00:00Z
+```
+
+### `toUtcString(input)`
+
+Convert a Temporal.Instant or ZonedDateTime to a UTC ISO 8601 string.
+
+**Parameters:**
+- `input` (Temporal.Instant | Temporal.ZonedDateTime): A Temporal.Instant or Temporal.ZonedDateTime
+
+**Returns:** `string` - A UTC ISO 8601 string representation
+
+**Example:**
+```typescript
+import { toUtcString } from '@gobrand/tiempo';
+
+// From ZonedDateTime
+const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+const iso = toUtcString(zoned);
+console.log(iso); // "2025-01-20T20:00:00Z"
+
+// From Instant
+const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+const iso2 = toUtcString(instant);
+console.log(iso2); // "2025-01-20T20:00:00Z"
+```
+
+### `format(input, formatStr, options?)`
+
+Format a Temporal.Instant or ZonedDateTime using date-fns-like format tokens.
+
+**Parameters:**
+- `input` (Temporal.Instant | Temporal.ZonedDateTime): A Temporal.Instant or Temporal.ZonedDateTime to format
+- `formatStr` (string): Format string using date-fns tokens (e.g., "yyyy-MM-dd HH:mm:ss")
+- `options` (FormatOptions, optional): Configuration for locale and timezone
+  - `locale` (string): BCP 47 language tag (default: "en-US")
+  - `timeZone` (string): IANA timezone identifier to convert to before formatting
+
+**Returns:** `string` - Formatted date string
+
+**Supported tokens:**
+- **Year**: `yyyy` (2025), `yy` (25), `y` (2025)
+- **Month**: `MMMM` (January), `MMM` (Jan), `MM` (01), `M` (1), `Mo` (1st)
+- **Day**: `dd` (20), `d` (20), `do` (20th)
+- **Weekday**: `EEEE` (Monday), `EEE` (Mon), `EEEEE` (M)
+- **Hour**: `HH` (15, 24h), `H` (15), `hh` (03, 12h), `h` (3)
+- **Minute**: `mm` (30), `m` (30)
+- **Second**: `ss` (45), `s` (45)
+- **AM/PM**: `a` (PM), `aa` (PM), `aaa` (pm), `aaaa` (p.m.), `aaaaa` (p)
+- **Timezone**: `xxx` (-05:00), `xx` (-0500), `XXX` (Z or -05:00), `zzzz` (Eastern Standard Time)
+- **Quarter**: `Q` (1), `QQQ` (Q1), `QQQQ` (1st quarter)
+- **Milliseconds**: `SSS` (123)
+- **Timestamp**: `T` (milliseconds), `t` (seconds)
+- **Escape text**: Use single quotes `'...'`, double single quotes `''` for literal quote
+
+**Example:**
+```typescript
+import { format } from '@gobrand/tiempo';
+
+const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:30:45-05:00[America/New_York]");
+
+format(zoned, "yyyy-MM-dd"); // "2025-01-20"
+format(zoned, "MMMM d, yyyy"); // "January 20, 2025"
+format(zoned, "h:mm a"); // "3:30 PM"
+format(zoned, "EEEE, MMMM do, yyyy 'at' h:mm a"); // "Monday, January 20th, 2025 at 3:30 PM"
+
+// With locale
+format(zoned, "MMMM d, yyyy", { locale: "es-ES" }); // "enero 20, 2025"
+format(zoned, "EEEE", { locale: "fr-FR" }); // "lundi"
+
+// Format Instant with timezone conversion
+const instant = Temporal.Instant.from("2025-01-20T20:30:45Z");
+format(instant, "yyyy-MM-dd HH:mm", { timeZone: "America/New_York" }); // "2025-01-20 15:30"
+format(instant, "yyyy-MM-dd HH:mm", { timeZone: "Asia/Tokyo" }); // "2025-01-21 05:30"
 ```
 
 ## Complete Workflow Example
 
 ```typescript
-import { utcToZonedTime, zonedTimeToUtc } from '@gobrand/tiempo';
+import { toZonedTime, toUtcString } from '@gobrand/tiempo';
 
 // 1. Receive UTC datetime from backend
 const scheduledAtUTC = "2025-01-20T20:00:00.000Z";
 
 // 2. Convert to user's timezone for display/editing
 const userTimezone = "America/New_York";
-const zonedDateTime = utcToZonedTime(scheduledAtUTC, userTimezone);
+const zonedDateTime = toZonedTime(scheduledAtUTC, userTimezone);
 
 console.log(`Scheduled for: ${zonedDateTime.hour}:00`); // "Scheduled for: 15:00"
 
@@ -101,7 +183,7 @@ console.log(`Scheduled for: ${zonedDateTime.hour}:00`); // "Scheduled for: 15:00
 const updatedZoned = zonedDateTime.with({ hour: 16 });
 
 // 4. Convert back to UTC for sending to backend
-const updatedUTC = zonedTimeToUtc(updatedZoned);
+const updatedUTC = toUtcString(updatedZoned);
 console.log(updatedUTC); // "2025-01-20T21:00:00Z"
 ```
 

package/dist/chunk-5FRUAUH2.js

@@ -0,0 +1,329 @@
+// src/format.ts
+import { Temporal } from "@js-temporal/polyfill";
+function format(input, formatStr, options = {}) {
+  const { locale = "en-US", timeZone } = options;
+  let zonedDateTime;
+  if (input instanceof Temporal.Instant) {
+    const tz = timeZone || "UTC";
+    zonedDateTime = input.toZonedDateTimeISO(tz);
+  } else {
+    zonedDateTime = timeZone ? input.toInstant().toZonedDateTimeISO(timeZone) : input;
+  }
+  let result = "";
+  let i = 0;
+  const len = formatStr.length;
+  while (i < len) {
+    const char = formatStr[i];
+    if (!char) break;
+    if (char === "'") {
+      if (i + 1 < len && formatStr[i + 1] === "'") {
+        result += "'";
+        i += 2;
+        continue;
+      }
+      i++;
+      while (i < len) {
+        if (formatStr[i] === "'") {
+          if (i + 1 < len && formatStr[i + 1] === "'") {
+            result += "'";
+            i += 2;
+          } else {
+            i++;
+            break;
+          }
+        } else {
+          result += formatStr[i];
+          i++;
+        }
+      }
+      continue;
+    }
+    const token = consumeToken(formatStr, i, char);
+    if (token !== null) {
+      result += formatToken(token, zonedDateTime, locale);
+      i += token.length;
+    } else {
+      result += char;
+      i++;
+    }
+  }
+  return result;
+}
+function consumeToken(formatStr, start, char) {
+  if (char === "M" && start + 1 < formatStr.length && formatStr[start + 1] === "o") {
+    return "Mo";
+  }
+  if (char === "d" && start + 1 < formatStr.length && formatStr[start + 1] === "o") {
+    return "do";
+  }
+  let end = start;
+  while (end < formatStr.length && formatStr[end] === char) {
+    end++;
+  }
+  const count = end - start;
+  const validTokens = [
+    "GGGGG",
+    "GGGG",
+    "GGG",
+    "GG",
+    "G",
+    "yyyy",
+    "yyy",
+    "yy",
+    "y",
+    "QQQQQ",
+    "QQQQ",
+    "QQQ",
+    "QQ",
+    "Q",
+    "MMMMM",
+    "MMMM",
+    "MMM",
+    "MM",
+    "M",
+    "dd",
+    "d",
+    "EEEEEE",
+    "EEEEE",
+    "EEEE",
+    "EEE",
+    "EE",
+    "E",
+    "aaaaa",
+    "aaaa",
+    "aaa",
+    "aa",
+    "a",
+    "HH",
+    "H",
+    "hh",
+    "h",
+    "mm",
+    "m",
+    "ss",
+    "s",
+    "SSS",
+    "SS",
+    "S",
+    "XXXXX",
+    "XXXX",
+    "XXX",
+    "XX",
+    "X",
+    "xxxxx",
+    "xxxx",
+    "xxx",
+    "xx",
+    "x",
+    "zzzz",
+    "zzz",
+    "zz",
+    "z",
+    "T",
+    "t"
+  ];
+  for (let len = Math.min(count, 6); len > 0; len--) {
+    const candidate = char.repeat(len);
+    if (validTokens.includes(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function formatToken(token, zonedDateTime, locale) {
+  switch (token) {
+    // Era
+    case "GGGGG":
+      return formatPart(zonedDateTime, "era", "narrow", locale);
+    case "GGGG":
+      return formatPart(zonedDateTime, "era", "long", locale);
+    case "GGG":
+    case "GG":
+    case "G":
+      return formatPart(zonedDateTime, "era", "short", locale);
+    // Year
+    case "yyyy":
+      return zonedDateTime.year.toString().padStart(4, "0");
+    case "yyy":
+      return zonedDateTime.year.toString().padStart(3, "0");
+    case "yy":
+      return (zonedDateTime.year % 100).toString().padStart(2, "0");
+    case "y":
+      return zonedDateTime.year.toString();
+    // Quarter
+    case "QQQQQ":
+      return Math.ceil(zonedDateTime.month / 3).toString();
+    case "QQQQ": {
+      const quarter = Math.ceil(zonedDateTime.month / 3);
+      return `${quarter}${getOrdinalSuffix(quarter)} quarter`;
+    }
+    case "QQQ":
+      return `Q${Math.ceil(zonedDateTime.month / 3)}`;
+    case "QQ":
+      return Math.ceil(zonedDateTime.month / 3).toString().padStart(2, "0");
+    case "Q":
+      return Math.ceil(zonedDateTime.month / 3).toString();
+    // Month
+    case "MMMMM":
+      return formatPart(zonedDateTime, "month", "narrow", locale);
+    case "MMMM":
+      return formatPart(zonedDateTime, "month", "long", locale);
+    case "MMM":
+      return formatPart(zonedDateTime, "month", "short", locale);
+    case "MM":
+      return zonedDateTime.month.toString().padStart(2, "0");
+    case "Mo":
+      return `${zonedDateTime.month}${getOrdinalSuffix(zonedDateTime.month)}`;
+    case "M":
+      return zonedDateTime.month.toString();
+    // Day of month
+    case "do":
+      return `${zonedDateTime.day}${getOrdinalSuffix(zonedDateTime.day)}`;
+    case "dd":
+      return zonedDateTime.day.toString().padStart(2, "0");
+    case "d":
+      return zonedDateTime.day.toString();
+    // Day of week
+    case "EEEEEE":
+      return formatPart(zonedDateTime, "weekday", "short", locale).slice(0, 2);
+    case "EEEEE":
+      return formatPart(zonedDateTime, "weekday", "narrow", locale);
+    case "EEEE":
+      return formatPart(zonedDateTime, "weekday", "long", locale);
+    case "EEE":
+    case "EE":
+    case "E":
+      return formatPart(zonedDateTime, "weekday", "short", locale);
+    // AM/PM
+    case "aaaaa": {
+      const period = formatPart(zonedDateTime, "dayPeriod", "narrow", locale).toLowerCase();
+      return period.charAt(0);
+    }
+    case "aaaa": {
+      const period = formatPart(zonedDateTime, "dayPeriod", "short", locale);
+      return period === "AM" ? "a.m." : "p.m.";
+    }
+    case "aaa":
+      return formatPart(zonedDateTime, "dayPeriod", "short", locale).toLowerCase();
+    case "aa":
+    case "a":
+      return formatPart(zonedDateTime, "dayPeriod", "short", locale);
+    // Hour [0-23]
+    case "HH":
+      return zonedDateTime.hour.toString().padStart(2, "0");
+    case "H":
+      return zonedDateTime.hour.toString();
+    // Hour [1-12]
+    case "hh": {
+      const hour12 = zonedDateTime.hour % 12 || 12;
+      return hour12.toString().padStart(2, "0");
+    }
+    case "h": {
+      const hour12 = zonedDateTime.hour % 12 || 12;
+      return hour12.toString();
+    }
+    // Minute
+    case "mm":
+      return zonedDateTime.minute.toString().padStart(2, "0");
+    case "m":
+      return zonedDateTime.minute.toString();
+    // Second
+    case "ss":
+      return zonedDateTime.second.toString().padStart(2, "0");
+    case "s":
+      return zonedDateTime.second.toString();
+    // Fractional seconds
+    case "SSS":
+      return zonedDateTime.millisecond.toString().padStart(3, "0");
+    case "SS":
+      return Math.floor(zonedDateTime.millisecond / 10).toString().padStart(2, "0");
+    case "S":
+      return Math.floor(zonedDateTime.millisecond / 100).toString();
+    // Timezone
+    case "XXXXX": {
+      const offset = getTimezoneOffset(zonedDateTime);
+      return offset === "+00:00" ? "Z" : offset;
+    }
+    case "XXXX": {
+      const offset = getTimezoneOffset(zonedDateTime).replace(":", "");
+      return offset === "+0000" ? "Z" : offset;
+    }
+    case "XXX": {
+      const offset = getTimezoneOffset(zonedDateTime);
+      return offset === "+00:00" ? "Z" : offset;
+    }
+    case "XX": {
+      const offset = getTimezoneOffset(zonedDateTime).replace(":", "");
+      return offset === "+0000" ? "Z" : offset;
+    }
+    case "X": {
+      const offset = getTimezoneOffset(zonedDateTime);
+      if (offset === "+00:00") return "Z";
+      const [hours] = offset.split(":");
+      return hours || "+00";
+    }
+    case "xxxxx":
+      return getTimezoneOffset(zonedDateTime);
+    case "xxxx":
+      return getTimezoneOffset(zonedDateTime).replace(":", "");
+    case "xxx":
+      return getTimezoneOffset(zonedDateTime);
+    case "xx":
+      return getTimezoneOffset(zonedDateTime).replace(":", "");
+    case "x": {
+      const offset = getTimezoneOffset(zonedDateTime);
+      const [hours] = offset.split(":");
+      return hours || "+00";
+    }
+    case "zzzz":
+      return formatPart(zonedDateTime, "timeZoneName", "long", locale);
+    case "zzz":
+    case "zz":
+    case "z":
+      return formatPart(zonedDateTime, "timeZoneName", "short", locale);
+    // Timestamps
+    case "T":
+      return zonedDateTime.epochMilliseconds.toString();
+    case "t":
+      return Math.floor(zonedDateTime.epochMilliseconds / 1e3).toString();
+    default:
+      return token;
+  }
+}
+function formatPart(zonedDateTime, part, style, locale) {
+  const options = {};
+  if (part === "dayPeriod") {
+    options.hour = "numeric";
+    options.hour12 = true;
+  } else {
+    options[part] = style;
+  }
+  const formatted = zonedDateTime.toLocaleString(locale, options);
+  if (part === "dayPeriod") {
+    const match = formatted.match(/\b(AM|PM|am|pm|a\.m\.|p\.m\.)\b/);
+    return match ? match[0] : formatted.split(" ").pop() || "";
+  }
+  return formatted;
+}
+function getOrdinalSuffix(num) {
+  const j = num % 10;
+  const k = num % 100;
+  if (j === 1 && k !== 11) return "st";
+  if (j === 2 && k !== 12) return "nd";
+  if (j === 3 && k !== 13) return "rd";
+  return "th";
+}
+function getTimezoneOffset(zonedDateTime) {
+  const offsetNs = zonedDateTime.offsetNanoseconds;
+  const offsetMinutes = offsetNs / (60 * 1e9);
+  const sign = offsetMinutes >= 0 ? "+" : "-";
+  const absMinutes = Math.abs(offsetMinutes);
+  const hours = Math.floor(absMinutes / 60);
+  const minutes = absMinutes % 60;
+  return `${sign}${hours.toString().padStart(2, "0")}:${minutes.toString().padStart(2, "0")}`;
+}
+
+export {
+  format
+};
+//# sourceMappingURL=chunk-5FRUAUH2.js.map

package/dist/chunk-5FRUAUH2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/format.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\nexport interface FormatOptions {\n  locale?: string;\n  timeZone?: string;\n}\n\n/**\n * Format a Temporal.Instant or ZonedDateTime using date-fns-like format tokens.\n * Uses Intl.DateTimeFormat under the hood via Temporal's toLocaleString() for zero dependencies.\n *\n * @param input - A Temporal.Instant or Temporal.ZonedDateTime to format\n * @param formatStr - Format string using date-fns tokens (e.g., \"yyyy-MM-dd HH:mm:ss\")\n * @param options - Optional configuration for locale and timezone\n * @returns Formatted date string\n *\n * @example\n * ```typescript\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n *\n * format(zoned, \"yyyy-MM-dd\"); // \"2025-01-20\"\n * format(zoned, \"MMMM d, yyyy\"); // \"January 20, 2025\"\n * format(zoned, \"h:mm a\"); // \"3:00 PM\"\n * format(zoned, \"EEEE, MMMM do, yyyy 'at' h:mm a\"); // \"Monday, January 20th, 2025 at 3:00 PM\"\n *\n * // With locale\n * format(zoned, \"MMMM d, yyyy\", { locale: \"es-ES\" }); // \"enero 20, 2025\"\n * ```\n */\nexport function format(\n  input: Temporal.Instant | Temporal.ZonedDateTime,\n  formatStr: string,\n  options: FormatOptions = {}\n): string {\n  const { locale = 'en-US', timeZone } = options;\n\n  // Convert Instant to ZonedDateTime if needed\n  let zonedDateTime: Temporal.ZonedDateTime;\n  if (input instanceof Temporal.Instant) {\n    const tz = timeZone || 'UTC';\n    zonedDateTime = input.toZonedDateTimeISO(tz);\n  } else {\n    zonedDateTime = timeZone\n      ? input.toInstant().toZonedDateTimeISO(timeZone)\n      : input;\n  }\n\n  let result = '';\n  let i = 0;\n  const len = formatStr.length;\n\n  while (i < len) {\n    const char = formatStr[i];\n    if (!char) break;\n\n    // Handle escaped text\n    if (char === \"'\") {\n      // Check for double single quote (not inside a string, just '')\n      if (i + 1 < len && formatStr[i + 1] === \"'\") {\n        result += \"'\";\n        i += 2;\n        continue;\n      }\n      // Find closing quote, handling '' inside the string\n      i++;\n      while (i < len) {\n        if (formatStr[i] === \"'\") {\n          // Check if it's a doubled quote ''\n          if (i + 1 < len && formatStr[i + 1] === \"'\") {\n            result += \"'\";\n            i += 2;\n          } else {\n            // End of quoted string\n            i++;\n            break;\n          }\n        } else {\n          result += formatStr[i];\n          i++;\n        }\n      }\n      continue;\n    }\n\n    // Check for tokens by looking ahead\n    const token = consumeToken(formatStr, i, char);\n    if (token !== null) {\n      result += formatToken(token, zonedDateTime, locale);\n      i += token.length;\n    } else {\n      result += char;\n      i++;\n    }\n  }\n\n  return result;\n}\n\nfunction consumeToken(formatStr: string, start: number, char: string): string | null {\n  // Special case for 'Mo' and 'do' - these end with 'o'\n  if (char === 'M' && start + 1 < formatStr.length && formatStr[start + 1] === 'o') {\n    return 'Mo';\n  }\n  if (char === 'd' && start + 1 < formatStr.length && formatStr[start + 1] === 'o') {\n    return 'do';\n  }\n\n  // Count how many consecutive identical characters\n  let end = start;\n  while (end < formatStr.length && formatStr[end] === char) {\n    end++;\n  }\n  const count = end - start;\n\n  // Check if this is a valid token pattern\n  const validTokens = [\n    'GGGGG',\n    'GGGG',\n    'GGG',\n    'GG',\n    'G',\n    'yyyy',\n    'yyy',\n    'yy',\n    'y',\n    'QQQQQ',\n    'QQQQ',\n    'QQQ',\n    'QQ',\n    'Q',\n    'MMMMM',\n    'MMMM',\n    'MMM',\n    'MM',\n    'M',\n    'dd',\n    'd',\n    'EEEEEE',\n    'EEEEE',\n    'EEEE',\n    'EEE',\n    'EE',\n    'E',\n    'aaaaa',\n    'aaaa',\n    'aaa',\n    'aa',\n    'a',\n    'HH',\n    'H',\n    'hh',\n    'h',\n    'mm',\n    'm',\n    'ss',\n    's',\n    'SSS',\n    'SS',\n    'S',\n    'XXXXX',\n    'XXXX',\n    'XXX',\n    'XX',\n    'X',\n    'xxxxx',\n    'xxxx',\n    'xxx',\n    'xx',\n    'x',\n    'zzzz',\n    'zzz',\n    'zz',\n    'z',\n    'T',\n    't',\n  ];\n\n  // Try to match from longest to shortest\n  for (let len = Math.min(count, 6); len > 0; len--) {\n    const candidate = char.repeat(len);\n    if (validTokens.includes(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction formatToken(token: string, zonedDateTime: Temporal.ZonedDateTime, locale: string): string {\n  switch (token) {\n    // Era\n    case 'GGGGG':\n      return formatPart(zonedDateTime, 'era', 'narrow', locale);\n    case 'GGGG':\n      return formatPart(zonedDateTime, 'era', 'long', locale);\n    case 'GGG':\n    case 'GG':\n    case 'G':\n      return formatPart(zonedDateTime, 'era', 'short', locale);\n\n    // Year\n    case 'yyyy':\n      return zonedDateTime.year.toString().padStart(4, '0');\n    case 'yyy':\n      return zonedDateTime.year.toString().padStart(3, '0');\n    case 'yy':\n      return (zonedDateTime.year % 100).toString().padStart(2, '0');\n    case 'y':\n      return zonedDateTime.year.toString();\n\n    // Quarter\n    case 'QQQQQ':\n      return Math.ceil(zonedDateTime.month / 3).toString();\n    case 'QQQQ': {\n      const quarter = Math.ceil(zonedDateTime.month / 3);\n      return `${quarter}${getOrdinalSuffix(quarter)} quarter`;\n    }\n    case 'QQQ':\n      return `Q${Math.ceil(zonedDateTime.month / 3)}`;\n    case 'QQ':\n      return Math.ceil(zonedDateTime.month / 3)\n        .toString()\n        .padStart(2, '0');\n    case 'Q':\n      return Math.ceil(zonedDateTime.month / 3).toString();\n\n    // Month\n    case 'MMMMM':\n      return formatPart(zonedDateTime, 'month', 'narrow', locale);\n    case 'MMMM':\n      return formatPart(zonedDateTime, 'month', 'long', locale);\n    case 'MMM':\n      return formatPart(zonedDateTime, 'month', 'short', locale);\n    case 'MM':\n      return zonedDateTime.month.toString().padStart(2, '0');\n    case 'Mo':\n      return `${zonedDateTime.month}${getOrdinalSuffix(zonedDateTime.month)}`;\n    case 'M':\n      return zonedDateTime.month.toString();\n\n    // Day of month\n    case 'do':\n      return `${zonedDateTime.day}${getOrdinalSuffix(zonedDateTime.day)}`;\n    case 'dd':\n      return zonedDateTime.day.toString().padStart(2, '0');\n    case 'd':\n      return zonedDateTime.day.toString();\n\n    // Day of week\n    case 'EEEEEE':\n      return formatPart(zonedDateTime, 'weekday', 'short', locale).slice(0, 2);\n    case 'EEEEE':\n      return formatPart(zonedDateTime, 'weekday', 'narrow', locale);\n    case 'EEEE':\n      return formatPart(zonedDateTime, 'weekday', 'long', locale);\n    case 'EEE':\n    case 'EE':\n    case 'E':\n      return formatPart(zonedDateTime, 'weekday', 'short', locale);\n\n    // AM/PM\n    case 'aaaaa': {\n      const period = formatPart(zonedDateTime, 'dayPeriod', 'narrow', locale).toLowerCase();\n      return period.charAt(0);\n    }\n    case 'aaaa': {\n      const period = formatPart(zonedDateTime, 'dayPeriod', 'short', locale);\n      return period === 'AM' ? 'a.m.' : 'p.m.';\n    }\n    case 'aaa':\n      return formatPart(zonedDateTime, 'dayPeriod', 'short', locale).toLowerCase();\n    case 'aa':\n    case 'a':\n      return formatPart(zonedDateTime, 'dayPeriod', 'short', locale);\n\n    // Hour [0-23]\n    case 'HH':\n      return zonedDateTime.hour.toString().padStart(2, '0');\n    case 'H':\n      return zonedDateTime.hour.toString();\n\n    // Hour [1-12]\n    case 'hh': {\n      const hour12 = zonedDateTime.hour % 12 || 12;\n      return hour12.toString().padStart(2, '0');\n    }\n    case 'h': {\n      const hour12 = zonedDateTime.hour % 12 || 12;\n      return hour12.toString();\n    }\n\n    // Minute\n    case 'mm':\n      return zonedDateTime.minute.toString().padStart(2, '0');\n    case 'm':\n      return zonedDateTime.minute.toString();\n\n    // Second\n    case 'ss':\n      return zonedDateTime.second.toString().padStart(2, '0');\n    case 's':\n      return zonedDateTime.second.toString();\n\n    // Fractional seconds\n    case 'SSS':\n      return zonedDateTime.millisecond.toString().padStart(3, '0');\n    case 'SS':\n      return Math.floor(zonedDateTime.millisecond / 10)\n        .toString()\n        .padStart(2, '0');\n    case 'S':\n      return Math.floor(zonedDateTime.millisecond / 100).toString();\n\n    // Timezone\n    case 'XXXXX': {\n      const offset = getTimezoneOffset(zonedDateTime);\n      return offset === '+00:00' ? 'Z' : offset;\n    }\n    case 'XXXX': {\n      const offset = getTimezoneOffset(zonedDateTime).replace(':', '');\n      return offset === '+0000' ? 'Z' : offset;\n    }\n    case 'XXX': {\n      const offset = getTimezoneOffset(zonedDateTime);\n      return offset === '+00:00' ? 'Z' : offset;\n    }\n    case 'XX': {\n      const offset = getTimezoneOffset(zonedDateTime).replace(':', '');\n      return offset === '+0000' ? 'Z' : offset;\n    }\n    case 'X': {\n      const offset = getTimezoneOffset(zonedDateTime);\n      if (offset === '+00:00') return 'Z';\n      const [hours] = offset.split(':');\n      return hours || '+00';\n    }\n    case 'xxxxx':\n      return getTimezoneOffset(zonedDateTime);\n    case 'xxxx':\n      return getTimezoneOffset(zonedDateTime).replace(':', '');\n    case 'xxx':\n      return getTimezoneOffset(zonedDateTime);\n    case 'xx':\n      return getTimezoneOffset(zonedDateTime).replace(':', '');\n    case 'x': {\n      const offset = getTimezoneOffset(zonedDateTime);\n      const [hours] = offset.split(':');\n      return hours || '+00';\n    }\n    case 'zzzz':\n      return formatPart(zonedDateTime, 'timeZoneName', 'long', locale);\n    case 'zzz':\n    case 'zz':\n    case 'z':\n      return formatPart(zonedDateTime, 'timeZoneName', 'short', locale);\n\n    // Timestamps\n    case 'T':\n      return zonedDateTime.epochMilliseconds.toString();\n    case 't':\n      return Math.floor(zonedDateTime.epochMilliseconds / 1000).toString();\n\n    default:\n      return token;\n  }\n}\n\nfunction formatPart(\n  zonedDateTime: Temporal.ZonedDateTime,\n  part: 'era' | 'year' | 'month' | 'weekday' | 'day' | 'dayPeriod' | 'hour' | 'minute' | 'second' | 'timeZoneName',\n  style: 'narrow' | 'short' | 'long' | 'numeric' | '2-digit',\n  locale: string\n): string {\n  const options: Intl.DateTimeFormatOptions = {};\n\n  if (part === 'dayPeriod') {\n    // dayPeriod needs hour to be present\n    options.hour = 'numeric';\n    options.hour12 = true;\n  } else {\n    options[part] = style as any;\n  }\n\n  const formatted = zonedDateTime.toLocaleString(locale, options);\n\n  if (part === 'dayPeriod') {\n    // Extract just the AM/PM part\n    const match = formatted.match(/\\b(AM|PM|am|pm|a\\.m\\.|p\\.m\\.)\\b/);\n    return match ? match[0] : formatted.split(' ').pop() || '';\n  }\n\n  return formatted;\n}\n\nfunction getOrdinalSuffix(num: number): string {\n  const j = num % 10;\n  const k = num % 100;\n  if (j === 1 && k !== 11) return 'st';\n  if (j === 2 && k !== 12) return 'nd';\n  if (j === 3 && k !== 13) return 'rd';\n  return 'th';\n}\n\nfunction getTimezoneOffset(zonedDateTime: Temporal.ZonedDateTime): string {\n  const offsetNs = zonedDateTime.offsetNanoseconds;\n  const offsetMinutes = offsetNs / (60 * 1e9);\n  const sign = offsetMinutes >= 0 ? '+' : '-';\n  const absMinutes = Math.abs(offsetMinutes);\n  const hours = Math.floor(absMinutes / 60);\n  const minutes = absMinutes % 60;\n  return `${sign}${hours.toString().padStart(2, '0')}:${minutes.toString().padStart(2, '0')}`;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-DMKGJY4N.js

@@ -0,0 +1,13 @@
+// src/toUtcString.ts
+import { Temporal } from "@js-temporal/polyfill";
+function toUtcString(input) {
+  if (input instanceof Temporal.Instant) {
+    return input.toString();
+  }
+  return input.toInstant().toString();
+}
+
+export {
+  toUtcString
+};
+//# sourceMappingURL=chunk-DMKGJY4N.js.map

package/dist/chunk-DMKGJY4N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toUtcString.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a Temporal.Instant or ZonedDateTime to a UTC ISO 8601 string.\n *\n * @param input - A Temporal.Instant or Temporal.ZonedDateTime\n * @returns A UTC ISO 8601 string representation\n *\n * @example\n * ```typescript\n * // From ZonedDateTime\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const utcString = toUtcString(zoned);\n * // utcString === \"2025-01-20T20:00:00Z\"\n *\n * // From Instant\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const utcString2 = toUtcString(instant);\n * // utcString2 === \"2025-01-20T20:00:00Z\"\n * ```\n */\nexport function toUtcString(\n  input: Temporal.Instant | Temporal.ZonedDateTime\n): string {\n  if (input instanceof Temporal.Instant) {\n    return input.toString();\n  }\n\n  return input.toInstant().toString();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAqBlB,SAAS,YACd,OACQ;AACR,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,SAAS;AAAA,EACxB;AAEA,SAAO,MAAM,UAAU,EAAE,SAAS;AACpC;","names":[]}

package/dist/chunk-GPAFAHKJ.js

@@ -0,0 +1,13 @@
+// src/toUtc.ts
+import { Temporal } from "@js-temporal/polyfill";
+function toUtc(input) {
+  if (typeof input === "string") {
+    return Temporal.Instant.from(input);
+  }
+  return input.toInstant();
+}
+
+export {
+  toUtc
+};
+//# sourceMappingURL=chunk-GPAFAHKJ.js.map

package/dist/chunk-GPAFAHKJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toUtc.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string or ZonedDateTime to a Temporal.Instant (UTC).\n *\n * @param input - A UTC ISO 8601 string or Temporal.ZonedDateTime\n * @returns A Temporal.Instant representing the same moment in UTC\n *\n * @example\n * ```typescript\n * // From ISO string\n * const instant = toUtc(\"2025-01-20T20:00:00.000Z\");\n *\n * // From ZonedDateTime\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const instant2 = toUtc(zoned);\n * // Both represent the same UTC moment: 2025-01-20T20:00:00Z\n * ```\n */\nexport function toUtc(\n  input: string | Temporal.ZonedDateTime\n): Temporal.Instant {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input);\n  }\n\n  return input.toInstant();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAmBlB,SAAS,MACd,OACkB;AAClB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK;AAAA,EACpC;AAEA,SAAO,MAAM,UAAU;AACzB;","names":[]}

package/dist/chunk-KD5GEHUA.js

@@ -0,0 +1,16 @@
+// src/toZonedTime.ts
+import { Temporal } from "@js-temporal/polyfill";
+function toZonedTime(input, timezone) {
+  if (typeof input === "string") {
+    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone);
+  }
+  if (input instanceof Temporal.Instant) {
+    return input.toZonedDateTimeISO(timezone);
+  }
+  return input.toInstant().toZonedDateTimeISO(timezone);
+}
+
+export {
+  toZonedTime
+};
+//# sourceMappingURL=chunk-KD5GEHUA.js.map

package/dist/chunk-KD5GEHUA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toZonedTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.\n *\n * @param input - A UTC ISO 8601 string, Temporal.Instant, or Temporal.ZonedDateTime\n * @param timezone - IANA timezone identifier (e.g., \"America/New_York\", \"Europe/London\")\n * @returns A Temporal.ZonedDateTime in the specified timezone\n *\n * @example\n * ```typescript\n * // From ISO string\n * const zoned = toZonedTime(\"2025-01-20T20:00:00.000Z\", \"America/New_York\");\n * // zoned.hour === 15 (3 PM in New York)\n *\n * // From Instant\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const zoned2 = toZonedTime(instant, \"Asia/Tokyo\");\n *\n * // From ZonedDateTime (convert to different timezone)\n * const nyTime = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const tokyoTime = toZonedTime(nyTime, \"Asia/Tokyo\");\n * ```\n */\nexport function toZonedTime(\n  input: string | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: string\n): Temporal.ZonedDateTime {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone);\n  }\n\n  if (input instanceof Temporal.Instant) {\n    return input.toZonedDateTimeISO(timezone);\n  }\n\n  return input.toInstant().toZonedDateTimeISO(timezone);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAwBlB,SAAS,YACd,OACA,UACwB;AACxB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ;AAAA,EACjE;AAEA,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,mBAAmB,QAAQ;AAAA,EAC1C;AAEA,SAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ;AACtD;","names":[]}

package/dist/format.d.ts

@@ -0,0 +1,29 @@
+import { Temporal } from '@js-temporal/polyfill';
+export interface FormatOptions {
+    locale?: string;
+    timeZone?: string;
+}
+/**
+ * Format a Temporal.Instant or ZonedDateTime using date-fns-like format tokens.
+ * Uses Intl.DateTimeFormat under the hood via Temporal's toLocaleString() for zero dependencies.
+ *
+ * @param input - A Temporal.Instant or Temporal.ZonedDateTime to format
+ * @param formatStr - Format string using date-fns tokens (e.g., "yyyy-MM-dd HH:mm:ss")
+ * @param options - Optional configuration for locale and timezone
+ * @returns Formatted date string
+ *
+ * @example
+ * ```typescript
+ * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+ *
+ * format(zoned, "yyyy-MM-dd"); // "2025-01-20"
+ * format(zoned, "MMMM d, yyyy"); // "January 20, 2025"
+ * format(zoned, "h:mm a"); // "3:00 PM"
+ * format(zoned, "EEEE, MMMM do, yyyy 'at' h:mm a"); // "Monday, January 20th, 2025 at 3:00 PM"
+ *
+ * // With locale
+ * format(zoned, "MMMM d, yyyy", { locale: "es-ES" }); // "enero 20, 2025"
+ * ```
+ */
+export declare function format(input: Temporal.Instant | Temporal.ZonedDateTime, formatStr: string, options?: FormatOptions): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CA+DR"}

package/dist/format.js

@@ -0,0 +1,7 @@
+import {
+  format
+} from "./chunk-5FRUAUH2.js";
+export {
+  format
+};
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=format.test.d.ts.map

package/dist/format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.d.ts","sourceRoot":"","sources":["../src/format.test.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,32 +1,5 @@
-import { Temporal } from '@js-temporal/polyfill';
-/**
- * Convert a UTC ISO string to a ZonedDateTime in the given timezone.
- *
- * @param isoString - A UTC ISO 8601 string (e.g., "2025-01-20T20:00:00.000Z")
- * @param timezone - An IANA timezone identifier (e.g., "America/New_York", "Europe/London")
- * @returns A Temporal.ZonedDateTime representing the same instant in the specified timezone
- *
- * @example
- * ```typescript
- * // Backend sends: "2025-01-20T20:00:00.000Z"
- * const zoned = utcToZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
- * // zoned.hour === 15 (3 PM in New York)
- * // zoned.toString() === "2025-01-20T15:00:00-05:00[America/New_York]"
- * ```
- */
-export declare function utcToZonedTime(isoString: string, timezone: string): Temporal.ZonedDateTime;
-/**
- * Convert a ZonedDateTime to a UTC ISO string.
- *
- * @param zonedDateTime - A Temporal.ZonedDateTime instance
- * @returns A UTC ISO 8601 string representation of the instant
- *
- * @example
- * ```typescript
- * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
- * const utc = zonedTimeToUtc(zoned);
- * // utc === "2025-01-20T20:00:00Z"
- * ```
- */
-export declare function zonedTimeToUtc(zonedDateTime: Temporal.ZonedDateTime): string;
+export { toZonedTime } from './toZonedTime';
+export { toUtc } from './toUtc';
+export { toUtcString } from './toUtcString';
+export { format, type FormatOptions } from './format';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,aAAa,CAExB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,GAAG,MAAM,CAE5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,13 +1,19 @@
-// src/index.ts
-import { Temporal } from "@js-temporal/polyfill";
-function utcToZonedTime(isoString, timezone) {
-  return Temporal.Instant.from(isoString).toZonedDateTimeISO(timezone);
-}
-function zonedTimeToUtc(zonedDateTime) {
-  return zonedDateTime.toInstant().toString();
-}
+import {
+  format
+} from "./chunk-5FRUAUH2.js";
+import {
+  toUtc
+} from "./chunk-GPAFAHKJ.js";
+import {
+  toUtcString
+} from "./chunk-DMKGJY4N.js";
+import {
+  toZonedTime
+} from "./chunk-KD5GEHUA.js";
 export {
-  utcToZonedTime,
-  zonedTimeToUtc
+  format,
+  toUtc,
+  toUtcString,
+  toZonedTime
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string to a ZonedDateTime in the given timezone.\n *\n * @param isoString - A UTC ISO 8601 string (e.g., \"2025-01-20T20:00:00.000Z\")\n * @param timezone - An IANA timezone identifier (e.g., \"America/New_York\", \"Europe/London\")\n * @returns A Temporal.ZonedDateTime representing the same instant in the specified timezone\n *\n * @example\n * ```typescript\n * // Backend sends: \"2025-01-20T20:00:00.000Z\"\n * const zoned = utcToZonedTime(\"2025-01-20T20:00:00.000Z\", \"America/New_York\");\n * // zoned.hour === 15 (3 PM in New York)\n * // zoned.toString() === \"2025-01-20T15:00:00-05:00[America/New_York]\"\n * ```\n */\nexport function utcToZonedTime(\n  isoString: string,\n  timezone: string\n): Temporal.ZonedDateTime {\n  return Temporal.Instant.from(isoString).toZonedDateTimeISO(timezone);\n}\n\n/**\n * Convert a ZonedDateTime to a UTC ISO string.\n *\n * @param zonedDateTime - A Temporal.ZonedDateTime instance\n * @returns A UTC ISO 8601 string representation of the instant\n *\n * @example\n * ```typescript\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const utc = zonedTimeToUtc(zoned);\n * // utc === \"2025-01-20T20:00:00Z\"\n * ```\n */\nexport function zonedTimeToUtc(zonedDateTime: Temporal.ZonedDateTime): string {\n  return zonedDateTime.toInstant().toString();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAiBlB,SAAS,eACd,WACA,UACwB;AACxB,SAAO,SAAS,QAAQ,KAAK,SAAS,EAAE,mBAAmB,QAAQ;AACrE;AAeO,SAAS,eAAe,eAA+C;AAC5E,SAAO,cAAc,UAAU,EAAE,SAAS;AAC5C;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/toUtc.d.ts

@@ -0,0 +1,20 @@
+import { Temporal } from '@js-temporal/polyfill';
+/**
+ * Convert a UTC ISO string or ZonedDateTime to a Temporal.Instant (UTC).
+ *
+ * @param input - A UTC ISO 8601 string or Temporal.ZonedDateTime
+ * @returns A Temporal.Instant representing the same moment in UTC
+ *
+ * @example
+ * ```typescript
+ * // From ISO string
+ * const instant = toUtc("2025-01-20T20:00:00.000Z");
+ *
+ * // From ZonedDateTime
+ * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+ * const instant2 = toUtc(zoned);
+ * // Both represent the same UTC moment: 2025-01-20T20:00:00Z
+ * ```
+ */
+export declare function toUtc(input: string | Temporal.ZonedDateTime): Temporal.Instant;
+//# sourceMappingURL=toUtc.d.ts.map

package/dist/toUtc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toUtc.d.ts","sourceRoot":"","sources":["../src/toUtc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,aAAa,GACrC,QAAQ,CAAC,OAAO,CAMlB"}

package/dist/toUtc.js

@@ -0,0 +1,7 @@
+import {
+  toUtc
+} from "./chunk-GPAFAHKJ.js";
+export {
+  toUtc
+};
+//# sourceMappingURL=toUtc.js.map

package/dist/toUtc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/toUtc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toUtc.test.d.ts.map

package/dist/toUtc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toUtc.test.d.ts","sourceRoot":"","sources":["../src/toUtc.test.ts"],"names":[],"mappings":""}

package/dist/toUtcString.d.ts

@@ -0,0 +1,22 @@
+import { Temporal } from '@js-temporal/polyfill';
+/**
+ * Convert a Temporal.Instant or ZonedDateTime to a UTC ISO 8601 string.
+ *
+ * @param input - A Temporal.Instant or Temporal.ZonedDateTime
+ * @returns A UTC ISO 8601 string representation
+ *
+ * @example
+ * ```typescript
+ * // From ZonedDateTime
+ * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+ * const utcString = toUtcString(zoned);
+ * // utcString === "2025-01-20T20:00:00Z"
+ *
+ * // From Instant
+ * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+ * const utcString2 = toUtcString(instant);
+ * // utcString2 === "2025-01-20T20:00:00Z"
+ * ```
+ */
+export declare function toUtcString(input: Temporal.Instant | Temporal.ZonedDateTime): string;
+//# sourceMappingURL=toUtcString.d.ts.map

package/dist/toUtcString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toUtcString.d.ts","sourceRoot":"","sources":["../src/toUtcString.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,MAAM,CAMR"}

package/dist/toUtcString.js

@@ -0,0 +1,7 @@
+import {
+  toUtcString
+} from "./chunk-DMKGJY4N.js";
+export {
+  toUtcString
+};
+//# sourceMappingURL=toUtcString.js.map

package/dist/toUtcString.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/toUtcString.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toUtcString.test.d.ts.map

package/dist/toUtcString.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toUtcString.test.d.ts","sourceRoot":"","sources":["../src/toUtcString.test.ts"],"names":[],"mappings":""}

package/dist/toZonedTime.d.ts

@@ -0,0 +1,25 @@
+import { Temporal } from '@js-temporal/polyfill';
+/**
+ * Convert a UTC ISO string, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
+ *
+ * @param input - A UTC ISO 8601 string, Temporal.Instant, or Temporal.ZonedDateTime
+ * @param timezone - IANA timezone identifier (e.g., "America/New_York", "Europe/London")
+ * @returns A Temporal.ZonedDateTime in the specified timezone
+ *
+ * @example
+ * ```typescript
+ * // From ISO string
+ * const zoned = toZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
+ * // zoned.hour === 15 (3 PM in New York)
+ *
+ * // From Instant
+ * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+ * const zoned2 = toZonedTime(instant, "Asia/Tokyo");
+ *
+ * // From ZonedDateTime (convert to different timezone)
+ * const nyTime = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+ * const tokyoTime = toZonedTime(nyTime, "Asia/Tokyo");
+ * ```
+ */
+export declare function toZonedTime(input: string | Temporal.Instant | Temporal.ZonedDateTime, timezone: string): Temporal.ZonedDateTime;
+//# sourceMappingURL=toZonedTime.d.ts.map

package/dist/toZonedTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toZonedTime.d.ts","sourceRoot":"","sources":["../src/toZonedTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACzD,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,aAAa,CAUxB"}

package/dist/toZonedTime.js

@@ -0,0 +1,7 @@
+import {
+  toZonedTime
+} from "./chunk-KD5GEHUA.js";
+export {
+  toZonedTime
+};
+//# sourceMappingURL=toZonedTime.js.map

package/dist/toZonedTime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/toZonedTime.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toZonedTime.test.d.ts.map

package/dist/toZonedTime.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toZonedTime.test.d.ts","sourceRoot":"","sources":["../src/toZonedTime.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobrand/tiempo",
-  "version": "0.1.2",
+  "version": "2.1.0",
   "description": "Lightweight utility functions for converting between UTC and timezone-aware datetimes using the Temporal API",
   "private": false,
   "publishConfig": {
@@ -33,7 +33,8 @@
     "build": "tsup && tsc --emitDeclarationOnly",
     "clean": "git clean -xdf .cache .turbo dist node_modules tsconfig.tsbuildinfo",
     "test": "vitest",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "release": "bash scripts/release.sh"
   },
   "dependencies": {
     "@js-temporal/polyfill": "^0.5.1"