@gobrand/tiempo 2.6.3 → 2.7.0

package/dist/chunk-YQBM63DC.js

@@ -0,0 +1,57 @@
+// src/simpleFormat.ts
+import { Temporal } from "@js-temporal/polyfill";
+function simpleFormat(input, options) {
+  const { locale = "en-US", timeZone } = options;
+  const dateFormat = "date" in options ? options.date : void 0;
+  const timeFormat = "time" in options ? options.time : void 0;
+  let zdt;
+  if (input instanceof Temporal.Instant) {
+    const tz = timeZone ?? "UTC";
+    zdt = input.toZonedDateTimeISO(tz);
+  } else if (input instanceof Temporal.ZonedDateTime) {
+    if (timeZone) {
+      zdt = input.toInstant().toZonedDateTimeISO(timeZone);
+    } else {
+      zdt = input;
+    }
+  } else {
+    zdt = input.toZonedDateTime({ timeZone: timeZone ?? "UTC", plainTime: new Temporal.PlainTime() });
+  }
+  const parts = [];
+  if (dateFormat) {
+    const currentYear = Temporal.Now.plainDateISO().year;
+    const showYear = dateFormat === "full" ? true : dateFormat === "compact" ? false : zdt.year !== currentYear;
+    const dateOptions = {
+      day: "numeric",
+      month: "short",
+      year: showYear ? "numeric" : void 0
+    };
+    parts.push(zdt.toLocaleString(locale, dateOptions));
+  }
+  if (timeFormat) {
+    if (timeFormat === "compact") {
+      parts.push(formatCompactTime(zdt));
+    } else {
+      const timeOptions = {
+        hour: "numeric",
+        minute: "2-digit",
+        hour12: timeFormat === "12h"
+      };
+      parts.push(zdt.toLocaleString(locale, timeOptions));
+    }
+  }
+  return parts.join(", ");
+}
+function formatCompactTime(zdt) {
+  const hour12 = zdt.hour % 12 || 12;
+  const ampm = zdt.hour < 12 ? "am" : "pm";
+  if (zdt.minute === 0) {
+    return `${hour12}${ampm}`;
+  }
+  return `${hour12}:${zdt.minute.toString().padStart(2, "0")}${ampm}`;
+}
+
+export {
+  simpleFormat
+};
+//# sourceMappingURL=chunk-YQBM63DC.js.map

package/dist/chunk-YQBM63DC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/simpleFormat.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport type { Timezone } from './types';\n\ninterface BaseOptions {\n  locale?: string;\n  timeZone?: Timezone;\n}\n\ninterface DateOnlyOptions extends BaseOptions {\n  date: 'compact' | 'auto' | 'full';\n  time?: never;\n}\n\ninterface TimeOnlyOptions extends BaseOptions {\n  date?: never;\n  time: '12h' | '24h' | 'compact';\n}\n\ninterface DateAndTimeOptions extends BaseOptions {\n  date: 'compact' | 'auto' | 'full';\n  time: '12h' | '24h' | 'compact';\n}\n\nexport type SimpleFormatOptions = DateOnlyOptions | TimeOnlyOptions | DateAndTimeOptions;\n\n/**\n * Format a Temporal date/time in a human-friendly way.\n *\n * Pass `date`, `time`, or both to control what's displayed.\n * At least one of `date` or `time` is required.\n *\n * @param input - A Temporal.Instant, ZonedDateTime, or PlainDate\n * @param options - Format options (at least `date` or `time` required)\n *\n * Date formats:\n * - `'compact'` - \"Dec 23\" (never shows year)\n * - `'auto'` - \"Dec 23\" or \"Dec 23, 2020\" (shows year only if not current year)\n * - `'full'` - \"Dec 23, 2026\" (always shows year)\n *\n * Time formats:\n * - `'12h'` - \"3:30 PM\"\n * - `'24h'` - \"15:30\"\n * - `'compact'` - \"9am\" or \"2:30pm\" (omits minutes when zero, lowercase am/pm)\n *\n * @example\n * ```typescript\n * const zdt = Temporal.ZonedDateTime.from(\"2026-12-23T09:00:00[America/New_York]\");\n * const pastZdt = Temporal.ZonedDateTime.from(\"2020-12-23T14:30:00[America/New_York]\");\n *\n * // Date only\n * simpleFormat(zdt, { date: 'compact' });     // \"Dec 23\"\n * simpleFormat(zdt, { date: 'auto' });        // \"Dec 23\"\n * simpleFormat(pastZdt, { date: 'auto' });    // \"Dec 23, 2020\"\n * simpleFormat(zdt, { date: 'full' });        // \"Dec 23, 2026\"\n *\n * // Time only\n * simpleFormat(zdt, { time: 'compact' });     // \"9am\"\n * simpleFormat(pastZdt, { time: 'compact' }); // \"2:30pm\"\n * simpleFormat(zdt, { time: '12h' });         // \"9:00 AM\"\n * simpleFormat(zdt, { time: '24h' });         // \"09:00\"\n *\n * // Date and time\n * simpleFormat(zdt, { date: 'auto', time: 'compact' });  // \"Dec 23, 9am\"\n * simpleFormat(zdt, { date: 'full', time: '12h' });      // \"Dec 23, 2026, 9:00 AM\"\n *\n * // With Instant (timeZone required)\n * const instant = Temporal.Instant.from(\"2026-12-23T14:00:00Z\");\n * simpleFormat(instant, { date: 'auto', timeZone: 'America/New_York' }); // \"Dec 23\"\n * ```\n */\nexport function simpleFormat(\n  input: Temporal.PlainDate | Temporal.ZonedDateTime | Temporal.Instant,\n  options: SimpleFormatOptions\n): string {\n  const { locale = 'en-US', timeZone } = options;\n  const dateFormat = 'date' in options ? options.date : undefined;\n  const timeFormat = 'time' in options ? options.time : undefined;\n\n  // Convert input to ZonedDateTime for consistent handling\n  let zdt: Temporal.ZonedDateTime;\n\n  if (input instanceof Temporal.Instant) {\n    const tz = timeZone ?? 'UTC';\n    zdt = input.toZonedDateTimeISO(tz);\n  } else if (input instanceof Temporal.ZonedDateTime) {\n    if (timeZone) {\n      zdt = input.toInstant().toZonedDateTimeISO(timeZone);\n    } else {\n      zdt = input;\n    }\n  } else {\n    // PlainDate - convert to ZonedDateTime at midnight UTC for formatting\n    zdt = input.toZonedDateTime({ timeZone: timeZone ?? 'UTC', plainTime: new Temporal.PlainTime() });\n  }\n\n  const parts: string[] = [];\n\n  // Format date part\n  if (dateFormat) {\n    const currentYear = Temporal.Now.plainDateISO().year;\n    const showYear =\n      dateFormat === 'full' ? true : dateFormat === 'compact' ? false : zdt.year !== currentYear;\n\n    const dateOptions: Intl.DateTimeFormatOptions = {\n      day: 'numeric',\n      month: 'short',\n      year: showYear ? 'numeric' : undefined,\n    };\n\n    parts.push(zdt.toLocaleString(locale, dateOptions));\n  }\n\n  // Format time part\n  if (timeFormat) {\n    if (timeFormat === 'compact') {\n      parts.push(formatCompactTime(zdt));\n    } else {\n      const timeOptions: Intl.DateTimeFormatOptions = {\n        hour: 'numeric',\n        minute: '2-digit',\n        hour12: timeFormat === '12h',\n      };\n      parts.push(zdt.toLocaleString(locale, timeOptions));\n    }\n  }\n\n  return parts.join(', ');\n}\n\n/**\n * Format time in compact style: \"9am\" or \"2:30pm\"\n * Omits minutes when they're zero for cleaner display.\n */\nfunction formatCompactTime(zdt: Temporal.ZonedDateTime): string {\n  const hour12 = zdt.hour % 12 || 12;\n  const ampm = zdt.hour < 12 ? 'am' : 'pm';\n\n  if (zdt.minute === 0) {\n    return `${hour12}${ampm}`;\n  }\n  return `${hour12}:${zdt.minute.toString().padStart(2, '0')}${ampm}`;\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAsElB,SAAS,aACd,OACA,SACQ;AACR,QAAM,EAAE,SAAS,SAAS,SAAS,IAAI;AACvC,QAAM,aAAa,UAAU,UAAU,QAAQ,OAAO;AACtD,QAAM,aAAa,UAAU,UAAU,QAAQ,OAAO;AAGtD,MAAI;AAEJ,MAAI,iBAAiB,SAAS,SAAS;AACrC,UAAM,KAAK,YAAY;AACvB,UAAM,MAAM,mBAAmB,EAAE;AAAA,EACnC,WAAW,iBAAiB,SAAS,eAAe;AAClD,QAAI,UAAU;AACZ,YAAM,MAAM,UAAU,EAAE,mBAAmB,QAAQ;AAAA,IACrD,OAAO;AACL,YAAM;AAAA,IACR;AAAA,EACF,OAAO;AAEL,UAAM,MAAM,gBAAgB,EAAE,UAAU,YAAY,OAAO,WAAW,IAAI,SAAS,UAAU,EAAE,CAAC;AAAA,EAClG;AAEA,QAAM,QAAkB,CAAC;AAGzB,MAAI,YAAY;AACd,UAAM,cAAc,SAAS,IAAI,aAAa,EAAE;AAChD,UAAM,WACJ,eAAe,SAAS,OAAO,eAAe,YAAY,QAAQ,IAAI,SAAS;AAEjF,UAAM,cAA0C;AAAA,MAC9C,KAAK;AAAA,MACL,OAAO;AAAA,MACP,MAAM,WAAW,YAAY;AAAA,IAC/B;AAEA,UAAM,KAAK,IAAI,eAAe,QAAQ,WAAW,CAAC;AAAA,EACpD;AAGA,MAAI,YAAY;AACd,QAAI,eAAe,WAAW;AAC5B,YAAM,KAAK,kBAAkB,GAAG,CAAC;AAAA,IACnC,OAAO;AACL,YAAM,cAA0C;AAAA,QAC9C,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,QAAQ,eAAe;AAAA,MACzB;AACA,YAAM,KAAK,IAAI,eAAe,QAAQ,WAAW,CAAC;AAAA,IACpD;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAMA,SAAS,kBAAkB,KAAqC;AAC9D,QAAM,SAAS,IAAI,OAAO,MAAM;AAChC,QAAM,OAAO,IAAI,OAAO,KAAK,OAAO;AAEpC,MAAI,IAAI,WAAW,GAAG;AACpB,WAAO,GAAG,MAAM,GAAG,IAAI;AAAA,EACzB;AACA,SAAO,GAAG,MAAM,IAAI,IAAI,OAAO,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC,GAAG,IAAI;AACnE;","names":[]}

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export { toIso9075, type ToIso9075Options, type Iso9075Representation, type Iso9
 export { toDate } from './toDate';
 export { format, type FormatOptions } from './format';
 export { formatPlainDate, type FormatPlainDateOptions } from './formatPlainDate';
-export { simpleFormat } from './simpleFormat';
+export { simpleFormat, type SimpleFormatOptions } from './simpleFormat';
 export { today } from './today';
 export { now } from './now';
 export { startOfDay } from './startOfDay';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -69,7 +69,7 @@ import {
 } from "./chunk-JHRXY36W.js";
 import {
   simpleFormat
-} from "./chunk-TFSZ55L7.js";
+} from "./chunk-YQBM63DC.js";
 import {
   startOfDay
 } from "./chunk-YIT6EMBC.js";

package/dist/simpleFormat.d.ts

@@ -1,56 +1,67 @@
 import { Temporal } from '@js-temporal/polyfill';
 import type { Timezone } from './types';
-interface PlainDateOptions {
+interface BaseOptions {
     locale?: string;
-    year?: 'auto' | 'always' | 'never';
-}
-interface ZonedDateTimeOptions {
-    locale?: string;
-    time?: '12h' | '24h';
     timeZone?: Timezone;
-    year?: 'auto' | 'always' | 'never';
 }
-interface InstantOptions {
-    locale?: string;
-    time?: '12h' | '24h';
-    timeZone: Timezone;
-    year?: 'auto' | 'always' | 'never';
+interface DateOnlyOptions extends BaseOptions {
+    date: 'compact' | 'auto' | 'full';
+    time?: never;
+}
+interface TimeOnlyOptions extends BaseOptions {
+    date?: never;
+    time: '12h' | '24h' | 'compact';
+}
+interface DateAndTimeOptions extends BaseOptions {
+    date: 'compact' | 'auto' | 'full';
+    time: '12h' | '24h' | 'compact';
 }
+export type SimpleFormatOptions = DateOnlyOptions | TimeOnlyOptions | DateAndTimeOptions;
 /**
- * Format a Temporal date in a human-friendly way: "Dec 23" or "Dec 23, 2020"
+ * Format a Temporal date/time in a human-friendly way.
  *
- * By default (year: 'auto'), shows the year only if the date is not in the current year.
- * Use year: 'always' to always show the year, or year: 'never' to always hide it.
- * Optionally includes time in 12-hour or 24-hour format.
+ * Pass `date`, `time`, or both to control what's displayed.
+ * At least one of `date` or `time` is required.
+ *
+ * @param input - A Temporal.Instant, ZonedDateTime, or PlainDate
+ * @param options - Format options (at least `date` or `time` required)
+ *
+ * Date formats:
+ * - `'compact'` - "Dec 23" (never shows year)
+ * - `'auto'` - "Dec 23" or "Dec 23, 2020" (shows year only if not current year)
+ * - `'full'` - "Dec 23, 2026" (always shows year)
+ *
+ * Time formats:
+ * - `'12h'` - "3:30 PM"
+ * - `'24h'` - "15:30"
+ * - `'compact'` - "9am" or "2:30pm" (omits minutes when zero, lowercase am/pm)
  *
  * @example
  * ```typescript
- * // Assuming current year is 2026
- * const date2026 = Temporal.ZonedDateTime.from("2026-12-23T15:30:00[America/New_York]");
- * const date2020 = Temporal.ZonedDateTime.from("2020-12-23T15:30:00[America/New_York]");
+ * const zdt = Temporal.ZonedDateTime.from("2026-12-23T09:00:00[America/New_York]");
+ * const pastZdt = Temporal.ZonedDateTime.from("2020-12-23T14:30:00[America/New_York]");
  *
- * simpleFormat(date2026); // "Dec 23"
- * simpleFormat(date2020); // "Dec 23, 2020"
- * simpleFormat(date2026, { time: '12h' }); // "Dec 23, 3:30 PM"
- * simpleFormat(date2026, { time: '24h' }); // "Dec 23, 15:30"
+ * // Date only
+ * simpleFormat(zdt, { date: 'compact' });     // "Dec 23"
+ * simpleFormat(zdt, { date: 'auto' });        // "Dec 23"
+ * simpleFormat(pastZdt, { date: 'auto' });    // "Dec 23, 2020"
+ * simpleFormat(zdt, { date: 'full' });        // "Dec 23, 2026"
  *
- * // Control year display
- * simpleFormat(date2026, { year: 'always' }); // "Dec 23, 2026"
- * simpleFormat(date2020, { year: 'never' }); // "Dec 23"
- * simpleFormat(date2020, { year: 'auto' }); // "Dec 23, 2020" (default behavior)
+ * // Time only
+ * simpleFormat(zdt, { time: 'compact' });     // "9am"
+ * simpleFormat(pastZdt, { time: 'compact' }); // "2:30pm"
+ * simpleFormat(zdt, { time: '12h' });         // "9:00 AM"
+ * simpleFormat(zdt, { time: '24h' });         // "09:00"
  *
- * // With Instant (timeZone required)
- * const instant = Temporal.Instant.from("2026-12-23T20:30:00Z");
- * simpleFormat(instant, { timeZone: 'America/New_York' }); // "Dec 23"
- * simpleFormat(instant, { timeZone: 'America/New_York', time: '12h' }); // "Dec 23, 3:30 PM"
+ * // Date and time
+ * simpleFormat(zdt, { date: 'auto', time: 'compact' });  // "Dec 23, 9am"
+ * simpleFormat(zdt, { date: 'full', time: '12h' });      // "Dec 23, 2026, 9:00 AM"
  *
- * // With PlainDate (no time option)
- * const plain = Temporal.PlainDate.from("2020-12-23");
- * simpleFormat(plain); // "Dec 23, 2020"
+ * // With Instant (timeZone required)
+ * const instant = Temporal.Instant.from("2026-12-23T14:00:00Z");
+ * simpleFormat(instant, { date: 'auto', timeZone: 'America/New_York' }); // "Dec 23"
  * ```
  */
-export declare function simpleFormat(input: Temporal.PlainDate, options?: PlainDateOptions): string;
-export declare function simpleFormat(input: Temporal.ZonedDateTime, options?: ZonedDateTimeOptions): string;
-export declare function simpleFormat(input: Temporal.Instant, options: InstantOptions): string;
+export declare function simpleFormat(input: Temporal.PlainDate | Temporal.ZonedDateTime | Temporal.Instant, options: SimpleFormatOptions): string;
 export {};
 //# sourceMappingURL=simpleFormat.d.ts.map

package/dist/simpleFormat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simpleFormat.d.ts","sourceRoot":"","sources":["../src/simpleFormat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACpC;AAED,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACpC;AAED,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;AAC5F,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAAC;AACpG,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC"}
+{"version":3,"file":"simpleFormat.d.ts","sourceRoot":"","sources":["../src/simpleFormat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,UAAU,eAAgB,SAAQ,WAAW;IAC3C,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED,UAAU,eAAgB,SAAQ,WAAW;IAC3C,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;CACjC;AAED,UAAU,kBAAmB,SAAQ,WAAW;IAC9C,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,OAAO,EACrE,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAsDR"}

package/dist/simpleFormat.js

@@ -1,6 +1,6 @@
 import {
   simpleFormat
-} from "./chunk-TFSZ55L7.js";
+} from "./chunk-YQBM63DC.js";
 export {
   simpleFormat
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobrand/tiempo",
-  "version": "2.6.3",
+  "version": "2.7.0",
   "description": "Lightweight utility functions for converting between UTC and timezone-aware datetimes using the Temporal API",
   "private": false,
   "publishConfig": {

package/dist/chunk-TFSZ55L7.js

@@ -1,46 +0,0 @@
-// src/simpleFormat.ts
-import { Temporal } from "@js-temporal/polyfill";
-function simpleFormat(input, options = {}) {
-  const locale = options.locale ?? "en-US";
-  const time = "time" in options ? options.time : void 0;
-  const timeZone = "timeZone" in options ? options.timeZone : void 0;
-  const yearOption = "year" in options ? options.year : void 0;
-  let year;
-  let dateTimeForFormat;
-  if (input instanceof Temporal.Instant) {
-    const tz = timeZone ?? "UTC";
-    const zoned = input.toZonedDateTimeISO(tz);
-    year = zoned.year;
-    dateTimeForFormat = zoned;
-  } else if (input instanceof Temporal.ZonedDateTime) {
-    if (timeZone) {
-      const zoned = input.toInstant().toZonedDateTimeISO(timeZone);
-      year = zoned.year;
-      dateTimeForFormat = zoned;
-    } else {
-      year = input.year;
-      dateTimeForFormat = input;
-    }
-  } else {
-    year = input.year;
-    dateTimeForFormat = input;
-  }
-  const currentYear = Temporal.Now.plainDateISO().year;
-  const showYear = yearOption === "always" ? true : yearOption === "never" ? false : year !== currentYear;
-  const dateOptions = {
-    day: "numeric",
-    month: "short",
-    year: showYear ? "numeric" : void 0
-  };
-  if (time && !(input instanceof Temporal.PlainDate)) {
-    dateOptions.hour = "numeric";
-    dateOptions.minute = "2-digit";
-    dateOptions.hour12 = time === "12h";
-  }
-  return dateTimeForFormat.toLocaleString(locale, dateOptions);
-}
-
-export {
-  simpleFormat
-};
-//# sourceMappingURL=chunk-TFSZ55L7.js.map

package/dist/chunk-TFSZ55L7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/simpleFormat.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport type { Timezone } from './types';\n\n// simpleFormat options - discriminated by input type\ninterface PlainDateOptions {\n  locale?: string;\n  year?: 'auto' | 'always' | 'never';\n}\n\ninterface ZonedDateTimeOptions {\n  locale?: string;\n  time?: '12h' | '24h';\n  timeZone?: Timezone;\n  year?: 'auto' | 'always' | 'never';\n}\n\ninterface InstantOptions {\n  locale?: string;\n  time?: '12h' | '24h';\n  timeZone: Timezone; // required for Instant\n  year?: 'auto' | 'always' | 'never';\n}\n\n/**\n * Format a Temporal date in a human-friendly way: \"Dec 23\" or \"Dec 23, 2020\"\n *\n * By default (year: 'auto'), shows the year only if the date is not in the current year.\n * Use year: 'always' to always show the year, or year: 'never' to always hide it.\n * Optionally includes time in 12-hour or 24-hour format.\n *\n * @example\n * ```typescript\n * // Assuming current year is 2026\n * const date2026 = Temporal.ZonedDateTime.from(\"2026-12-23T15:30:00[America/New_York]\");\n * const date2020 = Temporal.ZonedDateTime.from(\"2020-12-23T15:30:00[America/New_York]\");\n *\n * simpleFormat(date2026); // \"Dec 23\"\n * simpleFormat(date2020); // \"Dec 23, 2020\"\n * simpleFormat(date2026, { time: '12h' }); // \"Dec 23, 3:30 PM\"\n * simpleFormat(date2026, { time: '24h' }); // \"Dec 23, 15:30\"\n *\n * // Control year display\n * simpleFormat(date2026, { year: 'always' }); // \"Dec 23, 2026\"\n * simpleFormat(date2020, { year: 'never' }); // \"Dec 23\"\n * simpleFormat(date2020, { year: 'auto' }); // \"Dec 23, 2020\" (default behavior)\n *\n * // With Instant (timeZone required)\n * const instant = Temporal.Instant.from(\"2026-12-23T20:30:00Z\");\n * simpleFormat(instant, { timeZone: 'America/New_York' }); // \"Dec 23\"\n * simpleFormat(instant, { timeZone: 'America/New_York', time: '12h' }); // \"Dec 23, 3:30 PM\"\n *\n * // With PlainDate (no time option)\n * const plain = Temporal.PlainDate.from(\"2020-12-23\");\n * simpleFormat(plain); // \"Dec 23, 2020\"\n * ```\n */\nexport function simpleFormat(input: Temporal.PlainDate, options?: PlainDateOptions): string;\nexport function simpleFormat(input: Temporal.ZonedDateTime, options?: ZonedDateTimeOptions): string;\nexport function simpleFormat(input: Temporal.Instant, options: InstantOptions): string;\nexport function simpleFormat(\n  input: Temporal.PlainDate | Temporal.ZonedDateTime | Temporal.Instant,\n  options: PlainDateOptions | ZonedDateTimeOptions | InstantOptions = {}\n): string {\n  const locale = options.locale ?? 'en-US';\n  const time = 'time' in options ? options.time : undefined;\n  const timeZone = 'timeZone' in options ? options.timeZone : undefined;\n  const yearOption = 'year' in options ? options.year : undefined;\n\n  // Get year from the input (converting Instant to ZonedDateTime if needed)\n  let year: number;\n  let dateTimeForFormat: Temporal.PlainDate | Temporal.ZonedDateTime;\n\n  if (input instanceof Temporal.Instant) {\n    const tz = timeZone ?? 'UTC';\n    const zoned = input.toZonedDateTimeISO(tz);\n    year = zoned.year;\n    dateTimeForFormat = zoned;\n  } else if (input instanceof Temporal.ZonedDateTime) {\n    if (timeZone) {\n      const zoned = input.toInstant().toZonedDateTimeISO(timeZone);\n      year = zoned.year;\n      dateTimeForFormat = zoned;\n    } else {\n      year = input.year;\n      dateTimeForFormat = input;\n    }\n  } else {\n    year = input.year;\n    dateTimeForFormat = input;\n  }\n\n  // Determine if year should be shown\n  const currentYear = Temporal.Now.plainDateISO().year;\n  const showYear =\n    yearOption === 'always' ? true : yearOption === 'never' ? false : year !== currentYear;\n\n  const dateOptions: Intl.DateTimeFormatOptions = {\n    day: 'numeric',\n    month: 'short',\n    year: showYear ? 'numeric' : undefined,\n  };\n\n  // Add time options if requested and input supports it\n  if (time && !(input instanceof Temporal.PlainDate)) {\n    dateOptions.hour = 'numeric';\n    dateOptions.minute = '2-digit';\n    dateOptions.hour12 = time === '12h';\n  }\n\n  return dateTimeForFormat.toLocaleString(locale, dateOptions);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AA2DlB,SAAS,aACd,OACA,UAAoE,CAAC,GAC7D;AACR,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,OAAO,UAAU,UAAU,QAAQ,OAAO;AAChD,QAAM,WAAW,cAAc,UAAU,QAAQ,WAAW;AAC5D,QAAM,aAAa,UAAU,UAAU,QAAQ,OAAO;AAGtD,MAAI;AACJ,MAAI;AAEJ,MAAI,iBAAiB,SAAS,SAAS;AACrC,UAAM,KAAK,YAAY;AACvB,UAAM,QAAQ,MAAM,mBAAmB,EAAE;AACzC,WAAO,MAAM;AACb,wBAAoB;AAAA,EACtB,WAAW,iBAAiB,SAAS,eAAe;AAClD,QAAI,UAAU;AACZ,YAAM,QAAQ,MAAM,UAAU,EAAE,mBAAmB,QAAQ;AAC3D,aAAO,MAAM;AACb,0BAAoB;AAAA,IACtB,OAAO;AACL,aAAO,MAAM;AACb,0BAAoB;AAAA,IACtB;AAAA,EACF,OAAO;AACL,WAAO,MAAM;AACb,wBAAoB;AAAA,EACtB;AAGA,QAAM,cAAc,SAAS,IAAI,aAAa,EAAE;AAChD,QAAM,WACJ,eAAe,WAAW,OAAO,eAAe,UAAU,QAAQ,SAAS;AAE7E,QAAM,cAA0C;AAAA,IAC9C,KAAK;AAAA,IACL,OAAO;AAAA,IACP,MAAM,WAAW,YAAY;AAAA,EAC/B;AAGA,MAAI,QAAQ,EAAE,iBAAiB,SAAS,YAAY;AAClD,gBAAY,OAAO;AACnB,gBAAY,SAAS;AACrB,gBAAY,SAAS,SAAS;AAAA,EAChC;AAEA,SAAO,kBAAkB,eAAe,QAAQ,WAAW;AAC7D;","names":[]}