@gobrand/tiempo 2.3.2 → 2.3.4

package/README.md

@@ -4,7 +4,7 @@
 [![CI](https://github.com/go-brand/tiempo/actions/workflows/ci.yml/badge.svg)](https://github.com/go-brand/tiempo/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Comprehensive datetime utilities for the [Temporal API](https://tc39.es/proposal-temporal/docs/). Full timezone support, nanosecond precision, and 54+ utility functions with a familiar API.
+Comprehensive datetime utilities for the [Temporal API](https://tc39.es/proposal-temporal/docs/). Full timezone support, nanosecond precision, and a familiar API.
 
 ## Installation
 
@@ -18,7 +18,7 @@ yarn add @gobrand/tiempo
 
 ## Why tiempo?
 
-The Temporal API is powerful but requires understanding its various methods and objects. **tiempo** (`@gobrand/tiempo`) provides 54+ intuitive utilities for every datetime task:
+The Temporal API is powerful but requires understanding its various methods and objects. **tiempo** (`@gobrand/tiempo`) provides intuitive utilities for every datetime task:
 
 - **🌍 Timezone conversions** - Convert between UTC and any timezone effortlessly
 - **➕ Complete arithmetic** - Add/subtract any time unit from nanoseconds to years
@@ -314,6 +314,95 @@ format(instant, "yyyy-MM-dd HH:mm", { timeZone: "America/New_York" }); // "2025-
 format(instant, "yyyy-MM-dd HH:mm", { timeZone: "Asia/Tokyo" }); // "2025-01-21 05:30"
 ```
 
+#### `formatPlainDate(date, formatStr, options?)`
+
+Format a Temporal.PlainDate using date-fns-like format tokens. Only supports date-related tokens (no time or timezone tokens).
+
+**Parameters:**
+- `date` (Temporal.PlainDate): A Temporal.PlainDate to format
+- `formatStr` (string): Format string using date-fns tokens (e.g., "yyyy-MM-dd")
+- `options` (FormatPlainDateOptions, optional): Configuration for locale
+  - `locale` (string): BCP 47 language tag (default: "en-US")
+
+**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)
+- **Quarter**: `Q` (1), `QQQ` (Q1), `QQQQ` (1st quarter)
+- **Era**: `G` (AD), `GGGG` (Anno Domini)
+- **Escape text**: Use single quotes `'...'`, double single quotes `''` for literal quote
+
+**Example:**
+```typescript
+import { formatPlainDate, today } from '@gobrand/tiempo';
+
+const date = Temporal.PlainDate.from("2025-01-20");
+
+formatPlainDate(date, "yyyy-MM-dd"); // "2025-01-20"
+formatPlainDate(date, "MMMM d, yyyy"); // "January 20, 2025"
+formatPlainDate(date, "EEEE, MMMM do, yyyy"); // "Monday, January 20th, 2025"
+formatPlainDate(date, "MM/dd/yyyy"); // "01/20/2025"
+
+// With locale
+formatPlainDate(date, "MMMM d, yyyy", { locale: "es-ES" }); // "enero 20, 2025"
+formatPlainDate(date, "EEEE", { locale: "de-DE" }); // "Montag"
+
+// Use with today()
+const todayFormatted = formatPlainDate(today(), "EEEE, MMMM do");
+// "Thursday, January 23rd"
+```
+
+#### `simpleFormat(input, options?)`
+
+Format a Temporal date in a human-friendly way: "Dec 23" or "Dec 23, 2020". By default, shows the year only if the date is not in the current year. Optionally includes time in 12-hour or 24-hour format.
+
+**Parameters:**
+- `input` (Temporal.PlainDate | Temporal.ZonedDateTime | Temporal.Instant): The date to format
+- `options` (object, optional): Formatting options
+  - `locale` (string): BCP 47 language tag (default: "en-US")
+  - `year` ('auto' | 'always' | 'never'): Control year display (default: 'auto')
+  - `time` ('12h' | '24h'): Include time in output (not available for PlainDate)
+  - `timeZone` (string): IANA timezone identifier (required for Instant, optional for ZonedDateTime)
+
+**Returns:** `string` - Human-friendly formatted date string
+
+**Example:**
+```typescript
+import { simpleFormat, today, now } from '@gobrand/tiempo';
+
+// 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]");
+
+// Basic usage - year shown only for past years
+simpleFormat(date2026); // "Dec 23"
+simpleFormat(date2020); // "Dec 23, 2020"
+
+// With time
+simpleFormat(date2026, { time: '12h' }); // "Dec 23, 3:30 PM"
+simpleFormat(date2026, { time: '24h' }); // "Dec 23, 15:30"
+
+// Control year display
+simpleFormat(date2026, { year: 'always' }); // "Dec 23, 2026"
+simpleFormat(date2020, { year: 'never' }); // "Dec 23"
+
+// 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"
+
+// With PlainDate (no time option available)
+const plain = Temporal.PlainDate.from("2020-12-23");
+simpleFormat(plain); // "Dec 23, 2020"
+
+// Different locales
+simpleFormat(date2020, { locale: 'es-ES' }); // "23 dic 2020"
+simpleFormat(date2020, { locale: 'de-DE' }); // "23. Dez. 2020"
+```
+
 ### Start/End Utilities
 
 #### `today(timezone?)`

package/dist/chunk-3A6X6WV5.js

@@ -0,0 +1,186 @@
+// src/formatPlainDate.ts
+import "@js-temporal/polyfill";
+function formatPlainDate(date, formatStr, options = {}) {
+  const { locale = "en-US" } = options;
+  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, date, 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 = [
+    // Era
+    "GGGGG",
+    "GGGG",
+    "GGG",
+    "GG",
+    "G",
+    // Year
+    "yyyy",
+    "yyy",
+    "yy",
+    "y",
+    // Quarter
+    "QQQQQ",
+    "QQQQ",
+    "QQQ",
+    "QQ",
+    "Q",
+    // Month
+    "MMMMM",
+    "MMMM",
+    "MMM",
+    "MM",
+    "M",
+    // Day
+    "dd",
+    "d",
+    // Weekday
+    "EEEEEE",
+    "EEEEE",
+    "EEEE",
+    "EEE",
+    "EE",
+    "E"
+  ];
+  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, date, locale) {
+  switch (token) {
+    // Era
+    case "GGGGG":
+      return formatPart(date, "era", "narrow", locale);
+    case "GGGG":
+      return formatPart(date, "era", "long", locale);
+    case "GGG":
+    case "GG":
+    case "G":
+      return formatPart(date, "era", "short", locale);
+    // Year
+    case "yyyy":
+      return date.year.toString().padStart(4, "0");
+    case "yyy":
+      return date.year.toString().padStart(3, "0");
+    case "yy":
+      return (date.year % 100).toString().padStart(2, "0");
+    case "y":
+      return date.year.toString();
+    // Quarter
+    case "QQQQQ":
+      return Math.ceil(date.month / 3).toString();
+    case "QQQQ": {
+      const quarter = Math.ceil(date.month / 3);
+      return `${quarter}${getOrdinalSuffix(quarter)} quarter`;
+    }
+    case "QQQ":
+      return `Q${Math.ceil(date.month / 3)}`;
+    case "QQ":
+      return Math.ceil(date.month / 3).toString().padStart(2, "0");
+    case "Q":
+      return Math.ceil(date.month / 3).toString();
+    // Month
+    case "MMMMM":
+      return formatPart(date, "month", "narrow", locale);
+    case "MMMM":
+      return formatPart(date, "month", "long", locale);
+    case "MMM":
+      return formatPart(date, "month", "short", locale);
+    case "MM":
+      return date.month.toString().padStart(2, "0");
+    case "Mo":
+      return `${date.month}${getOrdinalSuffix(date.month)}`;
+    case "M":
+      return date.month.toString();
+    // Day of month
+    case "do":
+      return `${date.day}${getOrdinalSuffix(date.day)}`;
+    case "dd":
+      return date.day.toString().padStart(2, "0");
+    case "d":
+      return date.day.toString();
+    // Day of week
+    case "EEEEEE":
+      return formatPart(date, "weekday", "short", locale).slice(0, 2);
+    case "EEEEE":
+      return formatPart(date, "weekday", "narrow", locale);
+    case "EEEE":
+      return formatPart(date, "weekday", "long", locale);
+    case "EEE":
+    case "EE":
+    case "E":
+      return formatPart(date, "weekday", "short", locale);
+    default:
+      return token;
+  }
+}
+function formatPart(date, part, style, locale) {
+  const options = {
+    [part]: style
+  };
+  return date.toLocaleString(locale, options);
+}
+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";
+}
+
+export {
+  formatPlainDate
+};
+//# sourceMappingURL=chunk-3A6X6WV5.js.map

package/dist/chunk-3A6X6WV5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formatPlainDate.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\nexport interface FormatPlainDateOptions {\n  locale?: string;\n}\n\n/**\n * Format a Temporal.PlainDate using date-fns-like format tokens.\n * Uses Intl.DateTimeFormat under the hood for locale support.\n *\n * Only supports date-related tokens (no time or timezone tokens).\n *\n * @param date - A Temporal.PlainDate to format\n * @param formatStr - Format string using date-fns tokens (e.g., \"yyyy-MM-dd\")\n * @param options - Optional configuration for locale\n * @returns Formatted date string\n *\n * @example\n * ```typescript\n * const date = Temporal.PlainDate.from(\"2025-01-20\");\n *\n * formatPlainDate(date, \"yyyy-MM-dd\"); // \"2025-01-20\"\n * formatPlainDate(date, \"MMMM d, yyyy\"); // \"January 20, 2025\"\n * formatPlainDate(date, \"EEEE, MMMM do, yyyy\"); // \"Monday, January 20th, 2025\"\n *\n * // With locale\n * formatPlainDate(date, \"MMMM d, yyyy\", { locale: \"es-ES\" }); // \"enero 20, 2025\"\n * ```\n */\nexport function formatPlainDate(\n  date: Temporal.PlainDate,\n  formatStr: string,\n  options: FormatPlainDateOptions = {}\n): string {\n  const { locale = 'en-US' } = options;\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, date, 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  // Valid tokens for PlainDate (date-only, no time/timezone)\n  const validTokens = [\n    // Era\n    'GGGGG',\n    'GGGG',\n    'GGG',\n    'GG',\n    'G',\n    // Year\n    'yyyy',\n    'yyy',\n    'yy',\n    'y',\n    // Quarter\n    'QQQQQ',\n    'QQQQ',\n    'QQQ',\n    'QQ',\n    'Q',\n    // Month\n    'MMMMM',\n    'MMMM',\n    'MMM',\n    'MM',\n    'M',\n    // Day\n    'dd',\n    'd',\n    // Weekday\n    'EEEEEE',\n    'EEEEE',\n    'EEEE',\n    'EEE',\n    'EE',\n    'E',\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, date: Temporal.PlainDate, locale: string): string {\n  switch (token) {\n    // Era\n    case 'GGGGG':\n      return formatPart(date, 'era', 'narrow', locale);\n    case 'GGGG':\n      return formatPart(date, 'era', 'long', locale);\n    case 'GGG':\n    case 'GG':\n    case 'G':\n      return formatPart(date, 'era', 'short', locale);\n\n    // Year\n    case 'yyyy':\n      return date.year.toString().padStart(4, '0');\n    case 'yyy':\n      return date.year.toString().padStart(3, '0');\n    case 'yy':\n      return (date.year % 100).toString().padStart(2, '0');\n    case 'y':\n      return date.year.toString();\n\n    // Quarter\n    case 'QQQQQ':\n      return Math.ceil(date.month / 3).toString();\n    case 'QQQQ': {\n      const quarter = Math.ceil(date.month / 3);\n      return `${quarter}${getOrdinalSuffix(quarter)} quarter`;\n    }\n    case 'QQQ':\n      return `Q${Math.ceil(date.month / 3)}`;\n    case 'QQ':\n      return Math.ceil(date.month / 3)\n        .toString()\n        .padStart(2, '0');\n    case 'Q':\n      return Math.ceil(date.month / 3).toString();\n\n    // Month\n    case 'MMMMM':\n      return formatPart(date, 'month', 'narrow', locale);\n    case 'MMMM':\n      return formatPart(date, 'month', 'long', locale);\n    case 'MMM':\n      return formatPart(date, 'month', 'short', locale);\n    case 'MM':\n      return date.month.toString().padStart(2, '0');\n    case 'Mo':\n      return `${date.month}${getOrdinalSuffix(date.month)}`;\n    case 'M':\n      return date.month.toString();\n\n    // Day of month\n    case 'do':\n      return `${date.day}${getOrdinalSuffix(date.day)}`;\n    case 'dd':\n      return date.day.toString().padStart(2, '0');\n    case 'd':\n      return date.day.toString();\n\n    // Day of week\n    case 'EEEEEE':\n      return formatPart(date, 'weekday', 'short', locale).slice(0, 2);\n    case 'EEEEE':\n      return formatPart(date, 'weekday', 'narrow', locale);\n    case 'EEEE':\n      return formatPart(date, 'weekday', 'long', locale);\n    case 'EEE':\n    case 'EE':\n    case 'E':\n      return formatPart(date, 'weekday', 'short', locale);\n\n    default:\n      return token;\n  }\n}\n\nfunction formatPart(\n  date: Temporal.PlainDate,\n  part: 'era' | 'year' | 'month' | 'weekday' | 'day',\n  style: 'narrow' | 'short' | 'long' | 'numeric' | '2-digit',\n  locale: string\n): string {\n  const options: Intl.DateTimeFormatOptions = {\n    [part]: style,\n  };\n\n  return date.toLocaleString(locale, options);\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"],"mappings":"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","names":[]}

package/dist/chunk-GQBO2UXH.js

@@ -0,0 +1,46 @@
+// 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-GQBO2UXH.js.map

package/dist/chunk-GQBO2UXH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/simpleFormat.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\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?: string;\n  year?: 'auto' | 'always' | 'never';\n}\n\ninterface InstantOptions {\n  locale?: string;\n  time?: '12h' | '24h';\n  timeZone: string; // 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;AA0DlB,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":[]}

package/dist/formatPlainDate.d.ts

@@ -0,0 +1,29 @@
+import { Temporal } from '@js-temporal/polyfill';
+export interface FormatPlainDateOptions {
+    locale?: string;
+}
+/**
+ * Format a Temporal.PlainDate using date-fns-like format tokens.
+ * Uses Intl.DateTimeFormat under the hood for locale support.
+ *
+ * Only supports date-related tokens (no time or timezone tokens).
+ *
+ * @param date - A Temporal.PlainDate to format
+ * @param formatStr - Format string using date-fns tokens (e.g., "yyyy-MM-dd")
+ * @param options - Optional configuration for locale
+ * @returns Formatted date string
+ *
+ * @example
+ * ```typescript
+ * const date = Temporal.PlainDate.from("2025-01-20");
+ *
+ * formatPlainDate(date, "yyyy-MM-dd"); // "2025-01-20"
+ * formatPlainDate(date, "MMMM d, yyyy"); // "January 20, 2025"
+ * formatPlainDate(date, "EEEE, MMMM do, yyyy"); // "Monday, January 20th, 2025"
+ *
+ * // With locale
+ * formatPlainDate(date, "MMMM d, yyyy", { locale: "es-ES" }); // "enero 20, 2025"
+ * ```
+ */
+export declare function formatPlainDate(date: Temporal.PlainDate, formatStr: string, options?: FormatPlainDateOptions): string;
+//# sourceMappingURL=formatPlainDate.d.ts.map

package/dist/formatPlainDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatPlainDate.d.ts","sourceRoot":"","sources":["../src/formatPlainDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,CAAC,SAAS,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAoDR"}

package/dist/formatPlainDate.js

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

package/dist/formatPlainDate.js.map

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

package/dist/formatPlainDate.test.d.ts

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

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

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

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export { toUtc } from './toUtc';
 export { toUtcString } from './toUtcString';
 export { toDate } from './toDate';
 export { format, type FormatOptions } from './format';
+export { formatPlainDate, type FormatPlainDateOptions } from './formatPlainDate';
+export { simpleFormat } 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

@@ -1,6 +1,18 @@
+import {
+  toUtcString
+} from "./chunk-DMKGJY4N.js";
+import {
+  toZonedTime
+} from "./chunk-2MP3ESL7.js";
 import {
   today
 } from "./chunk-67QHALIG.js";
+import {
+  subMonths
+} from "./chunk-52NEOY34.js";
+import {
+  subNanoseconds
+} from "./chunk-WVHAYLBW.js";
 import {
   subSeconds
 } from "./chunk-BH2YB4MV.js";
@@ -17,11 +29,11 @@ import {
   toUtc
 } from "./chunk-BW5SFCKS.js";
 import {
-  toUtcString
-} from "./chunk-DMKGJY4N.js";
+  startOfMonth
+} from "./chunk-TU2UNOOW.js";
 import {
-  toZonedTime
-} from "./chunk-2MP3ESL7.js";
+  startOfWeek
+} from "./chunk-2WMXB7QL.js";
 import {
   startOfYear
 } from "./chunk-YR2UCUIT.js";
@@ -41,11 +53,8 @@ import {
   subMinutes
 } from "./chunk-J6G2I2TU.js";
 import {
-  subMonths
-} from "./chunk-52NEOY34.js";
-import {
-  subNanoseconds
-} from "./chunk-WVHAYLBW.js";
+  isSameMonth
+} from "./chunk-ADQTZVMH.js";
 import {
   isSameNanosecond
 } from "./chunk-S63QUP4W.js";
@@ -61,15 +70,15 @@ import {
 import {
   now
 } from "./chunk-3YGPHHB6.js";
+import {
+  simpleFormat
+} from "./chunk-GQBO2UXH.js";
 import {
   startOfDay
 } from "./chunk-TW5EV3DH.js";
 import {
-  startOfMonth
-} from "./chunk-TU2UNOOW.js";
-import {
-  startOfWeek
-} from "./chunk-2WMXB7QL.js";
+  isPlainDateAfter
+} from "./chunk-BPZ7BRJW.js";
 import {
   isPlainDateBefore
 } from "./chunk-4E7OGJ3F.js";
@@ -91,12 +100,12 @@ import {
 import {
   isSameMinute
 } from "./chunk-LDO6PRNJ.js";
-import {
-  isSameMonth
-} from "./chunk-ADQTZVMH.js";
 import {
   format
 } from "./chunk-2G5RJGPR.js";
+import {
+  formatPlainDate
+} from "./chunk-3A6X6WV5.js";
 import {
   intlFormatDistance
 } from "./chunk-XEDXPI5G.js";
@@ -112,9 +121,6 @@ import {
 import {
   isPast
 } from "./chunk-2H4KLXGL.js";
-import {
-  isPlainDateAfter
-} from "./chunk-BPZ7BRJW.js";
 import {
   differenceInNanoseconds
 } from "./chunk-OABS374T.js";
@@ -215,6 +221,7 @@ export {
   endOfWeek,
   endOfYear,
   format,
+  formatPlainDate,
   intlFormatDistance,
   isAfter,
   isBefore,
@@ -234,6 +241,7 @@ export {
   isSameWeek,
   isSameYear,
   now,
+  simpleFormat,
   startOfDay,
   startOfMonth,
   startOfWeek,

package/dist/simpleFormat.d.ts

@@ -0,0 +1,55 @@
+import { Temporal } from '@js-temporal/polyfill';
+interface PlainDateOptions {
+    locale?: string;
+    year?: 'auto' | 'always' | 'never';
+}
+interface ZonedDateTimeOptions {
+    locale?: string;
+    time?: '12h' | '24h';
+    timeZone?: string;
+    year?: 'auto' | 'always' | 'never';
+}
+interface InstantOptions {
+    locale?: string;
+    time?: '12h' | '24h';
+    timeZone: string;
+    year?: 'auto' | 'always' | 'never';
+}
+/**
+ * Format a Temporal date in a human-friendly way: "Dec 23" or "Dec 23, 2020"
+ *
+ * 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.
+ *
+ * @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]");
+ *
+ * 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"
+ *
+ * // 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)
+ *
+ * // 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"
+ *
+ * // With PlainDate (no time option)
+ * const plain = Temporal.PlainDate.from("2020-12-23");
+ * simpleFormat(plain); // "Dec 23, 2020"
+ * ```
+ */
+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 {};
+//# sourceMappingURL=simpleFormat.d.ts.map

package/dist/simpleFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simpleFormat.d.ts","sourceRoot":"","sources":["../src/simpleFormat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,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,MAAM,CAAC;IAClB,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,MAAM,CAAC;IACjB,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"}

package/dist/simpleFormat.js

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

package/dist/simpleFormat.js.map

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

package/dist/simpleFormat.test.d.ts

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

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

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

package/package.json

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