@gobrand/tiempo 2.5.4 → 2.6.0

package/dist/chunk-HFQUXON5.js

@@ -0,0 +1,41 @@
+// src/toPlainDate.ts
+import { Temporal } from "@js-temporal/polyfill";
+var PLAIN_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+function toPlainDate(input, timezone) {
+  if (input instanceof Temporal.ZonedDateTime && timezone === void 0) {
+    return input.toPlainDate();
+  }
+  if (input instanceof Date) {
+    if (timezone === void 0) {
+      throw new Error("Timezone is required unless input is a ZonedDateTime, PlainDateLike, or plain date string");
+    }
+    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone).toPlainDate();
+  }
+  if (input instanceof Temporal.Instant) {
+    if (timezone === void 0) {
+      throw new Error("Timezone is required unless input is a ZonedDateTime, PlainDateLike, or plain date string");
+    }
+    return input.toZonedDateTimeISO(timezone).toPlainDate();
+  }
+  if (input instanceof Temporal.ZonedDateTime) {
+    if (timezone === void 0) {
+      throw new Error("Timezone is required unless input is a ZonedDateTime, PlainDateLike, or plain date string");
+    }
+    return input.toInstant().toZonedDateTimeISO(timezone).toPlainDate();
+  }
+  if (typeof input === "string") {
+    if (timezone !== void 0) {
+      return Temporal.Instant.from(input).toZonedDateTimeISO(timezone).toPlainDate();
+    }
+    if (PLAIN_DATE_PATTERN.test(input)) {
+      return Temporal.PlainDate.from(input);
+    }
+    throw new Error("Timezone is required unless input is a ZonedDateTime, PlainDateLike, or plain date string");
+  }
+  return Temporal.PlainDate.from(input);
+}
+
+export {
+  toPlainDate
+};
+//# sourceMappingURL=chunk-HFQUXON5.js.map

package/dist/chunk-HFQUXON5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toPlainDate.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport type { Timezone } from './types';\n\n// Pattern to detect plain date strings: YYYY-MM-DD\nconst PLAIN_DATE_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/**\n * Parse a plain date or extract the calendar date from a datetime.\n *\n * @param input - A PlainDateLike object, plain date string (YYYY-MM-DD), ZonedDateTime, or datetime input requiring timezone\n * @param timezone - IANA timezone identifier. Required for ISO strings, Date, and Instant inputs.\n * @returns A Temporal.PlainDate representing the calendar date\n *\n * @example\n * ```typescript\n * import { toPlainDate, toZonedTime } from '@gobrand/tiempo';\n *\n * // From PlainDateLike object (no timezone needed)\n * const date = toPlainDate({ year: 2025, month: 1, day: 20 }); // 2025-01-20\n *\n * // From plain date string (no timezone needed)\n * const date2 = toPlainDate(\"2025-01-20\"); // 2025-01-20\n *\n * // From ZonedDateTime (no timezone needed)\n * const zdt = toZonedTime(\"2025-01-20T15:30:00Z\", \"America/New_York\");\n * const date3 = toPlainDate(zdt); // 2025-01-20\n *\n * // From UTC string with timezone\n * const date4 = toPlainDate(\"2025-01-20T15:30:00Z\", \"America/New_York\"); // 2025-01-20\n *\n * // From Date with timezone\n * const jsDate = new Date(\"2025-01-20T15:30:00.000Z\");\n * const date5 = toPlainDate(jsDate, \"Europe/London\"); // 2025-01-20\n *\n * // Date boundary crossing: 23:00 UTC on Jan 20 → Jan 21 in Tokyo\n * const date6 = toPlainDate(\"2025-01-20T23:00:00Z\", \"Asia/Tokyo\"); // 2025-01-21\n * ```\n */\nexport function toPlainDate(input: Temporal.ZonedDateTime): Temporal.PlainDate;\nexport function toPlainDate(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: Timezone\n): Temporal.PlainDate;\nexport function toPlainDate(input: Temporal.PlainDateLike | string): Temporal.PlainDate;\nexport function toPlainDate(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime | Temporal.PlainDateLike,\n  timezone?: Timezone\n): Temporal.PlainDate {\n  // ZonedDateTime without timezone override\n  if (input instanceof Temporal.ZonedDateTime && timezone === undefined) {\n    return input.toPlainDate();\n  }\n\n  // Date requires timezone\n  if (input instanceof Date) {\n    if (timezone === undefined) {\n      throw new Error('Timezone is required unless input is a ZonedDateTime, PlainDateLike, or plain date string');\n    }\n    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone).toPlainDate();\n  }\n\n  // Instant requires timezone\n  if (input instanceof Temporal.Instant) {\n    if (timezone === undefined) {\n      throw new Error('Timezone is required unless input is a ZonedDateTime, PlainDateLike, or plain date string');\n    }\n    return input.toZonedDateTimeISO(timezone).toPlainDate();\n  }\n\n  // ZonedDateTime with timezone override\n  if (input instanceof Temporal.ZonedDateTime) {\n    if (timezone === undefined) {\n      throw new Error('Timezone is required unless input is a ZonedDateTime, PlainDateLike, or plain date string');\n    }\n    return input.toInstant().toZonedDateTimeISO(timezone).toPlainDate();\n  }\n\n  // String: ISO datetime (requires timezone) or plain date (no timezone)\n  if (typeof input === 'string') {\n    if (timezone !== undefined) {\n      return Temporal.Instant.from(input).toZonedDateTimeISO(timezone).toPlainDate();\n    }\n    if (PLAIN_DATE_PATTERN.test(input)) {\n      return Temporal.PlainDate.from(input);\n    }\n    throw new Error('Timezone is required unless input is a ZonedDateTime, PlainDateLike, or plain date string');\n  }\n\n  // PlainDateLike object - pass directly to Temporal.PlainDate.from()\n  return Temporal.PlainDate.from(input);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAIzB,IAAM,qBAAqB;AAwCpB,SAAS,YACd,OACA,UACoB;AAEpB,MAAI,iBAAiB,SAAS,iBAAiB,aAAa,QAAW;AACrE,WAAO,MAAM,YAAY;AAAA,EAC3B;AAGA,MAAI,iBAAiB,MAAM;AACzB,QAAI,aAAa,QAAW;AAC1B,YAAM,IAAI,MAAM,2FAA2F;AAAA,IAC7G;AACA,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EAC7F;AAGA,MAAI,iBAAiB,SAAS,SAAS;AACrC,QAAI,aAAa,QAAW;AAC1B,YAAM,IAAI,MAAM,2FAA2F;AAAA,IAC7G;AACA,WAAO,MAAM,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EACxD;AAGA,MAAI,iBAAiB,SAAS,eAAe;AAC3C,QAAI,aAAa,QAAW;AAC1B,YAAM,IAAI,MAAM,2FAA2F;AAAA,IAC7G;AACA,WAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EACpE;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,aAAa,QAAW;AAC1B,aAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,IAC/E;AACA,QAAI,mBAAmB,KAAK,KAAK,GAAG;AAClC,aAAO,SAAS,UAAU,KAAK,KAAK;AAAA,IACtC;AACA,UAAM,IAAI,MAAM,2FAA2F;AAAA,EAC7G;AAGA,SAAO,SAAS,UAAU,KAAK,KAAK;AACtC;","names":[]}

package/dist/chunk-JHRXY36W.js

@@ -0,0 +1,25 @@
+import {
+  normalizeTemporalInput
+} from "./chunk-MJSZNWCV.js";
+
+// src/roundToNearestSecond.ts
+var MODE_TO_ROUNDING_MODE = {
+  round: "halfExpand",
+  ceil: "ceil",
+  floor: "floor"
+};
+function roundToNearestSecond(input, options) {
+  const zonedDateTime = normalizeTemporalInput(input);
+  const mode = options?.mode ?? "round";
+  const nearestTo = options?.nearestTo ?? 1;
+  return zonedDateTime.round({
+    smallestUnit: "second",
+    roundingMode: MODE_TO_ROUNDING_MODE[mode],
+    roundingIncrement: nearestTo
+  });
+}
+
+export {
+  roundToNearestSecond
+};
+//# sourceMappingURL=chunk-JHRXY36W.js.map

package/dist/chunk-JHRXY36W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/roundToNearestSecond.ts"],"sourcesContent":["import type { Temporal } from '@js-temporal/polyfill';\nimport { normalizeTemporalInput } from './shared/normalizeTemporalInput';\n\n/**\n * Options for rounding to nearest second.\n */\nexport interface RoundToNearestSecondOptions {\n  /**\n   * The rounding mode to use.\n   *\n   * Given time 14:37:42.300:\n   * - `'round'` → 14:37:42 (300ms < 500, rounds DOWN to nearest)\n   * - `'ceil'`  → 14:37:43 (always rounds UP to next second)\n   * - `'floor'` → 14:37:42 (always rounds DOWN to current second)\n   *\n   * Given time 14:37:42 with nearestTo: 10:\n   * - `'round'` → 14:37:40 (42 is closer to 40 than 50)\n   * - `'ceil'`  → 14:37:50 (always rounds UP to next 10-sec mark)\n   * - `'floor'` → 14:37:40 (always rounds DOWN to current 10-sec mark)\n   *\n   * @default 'round'\n   */\n  mode?: 'round' | 'ceil' | 'floor';\n  /**\n   * Round to the nearest N seconds. Must divide evenly into 60.\n   * Valid values: 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30\n   * @example nearestTo: 10 rounds to 10-second marks (00, 10, 20, 30, 40, 50)\n   */\n  nearestTo?: 1 | 2 | 3 | 4 | 5 | 6 | 10 | 12 | 15 | 20 | 30;\n}\n\nconst MODE_TO_ROUNDING_MODE = {\n  round: 'halfExpand',\n  ceil: 'ceil',\n  floor: 'floor',\n} as const;\n\n/**\n * Rounds a datetime to the nearest second boundary.\n *\n * ## Mode comparison (given 14:37:42.567)\n *\n * ```\n * :42 ─────────────────●─────────────── :43\n *                    .567\n *\n * 'round' → :43  (nearest second - 567ms >= 500)\n * 'ceil'  → :43  (next second - always up)\n * 'floor' → :42  (current second - always down)\n * ```\n *\n * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime\n * @param options - Rounding options\n * @returns ZonedDateTime rounded to the second boundary\n *\n * @example\n * ```ts\n * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:42.567[America/New_York]');\n *\n * roundToNearestSecond(time);                     // → 14:37:43 (567ms >= 500)\n * roundToNearestSecond(time, { mode: 'ceil' });   // → 14:37:43 (always up)\n * roundToNearestSecond(time, { mode: 'floor' });  // → 14:37:42 (always down)\n * ```\n *\n * @example\n * ```ts\n * // 10-second intervals\n * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:42[America/New_York]');\n *\n * roundToNearestSecond(time, { nearestTo: 10 });                   // → 14:37:40 (nearest)\n * roundToNearestSecond(time, { mode: 'ceil', nearestTo: 10 });     // → 14:37:50 (next 10s)\n * roundToNearestSecond(time, { mode: 'floor', nearestTo: 10 });    // → 14:37:40 (current 10s)\n * ```\n *\n * @example\n * ```ts\n * // Remove sub-second precision for logging\n * const logTime = Temporal.ZonedDateTime.from('2025-01-20T14:37:42.123456789[UTC]');\n * roundToNearestSecond(logTime, { mode: 'floor' });\n * // → 14:37:42.000000000 (clean timestamp)\n * ```\n */\nexport function roundToNearestSecond(\n  input: Temporal.Instant | Temporal.ZonedDateTime,\n  options?: RoundToNearestSecondOptions\n): Temporal.ZonedDateTime {\n  const zonedDateTime = normalizeTemporalInput(input);\n  const mode = options?.mode ?? 'round';\n  const nearestTo = options?.nearestTo ?? 1;\n\n  return zonedDateTime.round({\n    smallestUnit: 'second',\n    roundingMode: MODE_TO_ROUNDING_MODE[mode],\n    roundingIncrement: nearestTo,\n  });\n}\n"],"mappings":";;;;;AA+BA,IAAM,wBAAwB;AAAA,EAC5B,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AACT;AA+CO,SAAS,qBACd,OACA,SACwB;AACxB,QAAM,gBAAgB,uBAAuB,KAAK;AAClD,QAAM,OAAO,SAAS,QAAQ;AAC9B,QAAM,YAAY,SAAS,aAAa;AAExC,SAAO,cAAc,MAAM;AAAA,IACzB,cAAc;AAAA,IACd,cAAc,sBAAsB,IAAI;AAAA,IACxC,mBAAmB;AAAA,EACrB,CAAC;AACH;","names":[]}

package/dist/chunk-MMI2HHT7.js

@@ -0,0 +1,25 @@
+import {
+  normalizeTemporalInput
+} from "./chunk-MJSZNWCV.js";
+
+// src/roundToNearestHour.ts
+var MODE_TO_ROUNDING_MODE = {
+  round: "halfExpand",
+  ceil: "ceil",
+  floor: "floor"
+};
+function roundToNearestHour(input, options) {
+  const zonedDateTime = normalizeTemporalInput(input);
+  const mode = options?.mode ?? "round";
+  const nearestTo = options?.nearestTo ?? 1;
+  return zonedDateTime.round({
+    smallestUnit: "hour",
+    roundingMode: MODE_TO_ROUNDING_MODE[mode],
+    roundingIncrement: nearestTo
+  });
+}
+
+export {
+  roundToNearestHour
+};
+//# sourceMappingURL=chunk-MMI2HHT7.js.map

package/dist/chunk-MMI2HHT7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/roundToNearestHour.ts"],"sourcesContent":["import type { Temporal } from '@js-temporal/polyfill';\nimport { normalizeTemporalInput } from './shared/normalizeTemporalInput';\n\n/**\n * Options for rounding to nearest hour.\n */\nexport interface RoundToNearestHourOptions {\n  /**\n   * The rounding mode to use.\n   *\n   * Given time 14:20:\n   * - `'round'` → 14:00 (20 min < 30, rounds DOWN to nearest)\n   * - `'ceil'`  → 15:00 (always rounds UP to next hour)\n   * - `'floor'` → 14:00 (always rounds DOWN to current hour)\n   *\n   * Given time 14:40:\n   * - `'round'` → 15:00 (40 min >= 30, rounds UP to nearest)\n   * - `'ceil'`  → 15:00 (always rounds UP to next hour)\n   * - `'floor'` → 14:00 (always rounds DOWN to current hour)\n   *\n   * @default 'round'\n   */\n  mode?: 'round' | 'ceil' | 'floor';\n  /**\n   * Round to the nearest N hours. Must divide evenly into 24.\n   * Valid values: 1, 2, 3, 4, 6, 8, 12\n   * @example nearestTo: 6 rounds to 00:00, 06:00, 12:00, or 18:00\n   */\n  nearestTo?: 1 | 2 | 3 | 4 | 6 | 8 | 12;\n}\n\nconst MODE_TO_ROUNDING_MODE = {\n  round: 'halfExpand',\n  ceil: 'ceil',\n  floor: 'floor',\n} as const;\n\n/**\n * Rounds a datetime to the nearest hour boundary.\n *\n * ## Mode comparison (given 14:20)\n *\n * ```\n * 14:00 ─────────────●───────────────── 15:00\n *                  14:20\n *\n * 'round' → 14:00  (nearest hour - 20 min < 30)\n * 'ceil'  → 15:00  (next hour - always up)\n * 'floor' → 14:00  (current hour - always down)\n * ```\n *\n * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime\n * @param options - Rounding options\n * @returns ZonedDateTime rounded to the hour boundary\n *\n * @example\n * ```ts\n * const time = Temporal.ZonedDateTime.from('2025-01-20T14:20:00[America/New_York]');\n *\n * roundToNearestHour(time);                     // → 14:00 (nearest)\n * roundToNearestHour(time, { mode: 'ceil' });   // → 15:00 (always up)\n * roundToNearestHour(time, { mode: 'floor' });  // → 14:00 (always down)\n * ```\n *\n * @example\n * ```ts\n * // With 37 minutes (past the halfway point)\n * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:00[America/New_York]');\n *\n * roundToNearestHour(time);                     // → 15:00 (nearest - 37 >= 30)\n * roundToNearestHour(time, { mode: 'ceil' });   // → 15:00 (always up)\n * roundToNearestHour(time, { mode: 'floor' });  // → 14:00 (always down)\n * ```\n *\n * @example\n * ```ts\n * // Round to 6-hour blocks (shift scheduling)\n * const time = Temporal.ZonedDateTime.from('2025-01-20T14:00:00[America/New_York]');\n *\n * roundToNearestHour(time, { nearestTo: 6 });                    // → 12:00\n * roundToNearestHour(time, { mode: 'ceil', nearestTo: 6 });      // → 18:00\n * roundToNearestHour(time, { mode: 'floor', nearestTo: 6 });     // → 12:00\n * ```\n */\nexport function roundToNearestHour(\n  input: Temporal.Instant | Temporal.ZonedDateTime,\n  options?: RoundToNearestHourOptions\n): Temporal.ZonedDateTime {\n  const zonedDateTime = normalizeTemporalInput(input);\n  const mode = options?.mode ?? 'round';\n  const nearestTo = options?.nearestTo ?? 1;\n\n  return zonedDateTime.round({\n    smallestUnit: 'hour',\n    roundingMode: MODE_TO_ROUNDING_MODE[mode],\n    roundingIncrement: nearestTo,\n  });\n}\n"],"mappings":";;;;;AA+BA,IAAM,wBAAwB;AAAA,EAC5B,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AACT;AAiDO,SAAS,mBACd,OACA,SACwB;AACxB,QAAM,gBAAgB,uBAAuB,KAAK;AAClD,QAAM,OAAO,SAAS,QAAQ;AAC9B,QAAM,YAAY,SAAS,aAAa;AAExC,SAAO,cAAc,MAAM;AAAA,IACzB,cAAc;AAAA,IACd,cAAc,sBAAsB,IAAI;AAAA,IACxC,mBAAmB;AAAA,EACrB,CAAC;AACH;","names":[]}

package/dist/chunk-UJW2FPI4.js

@@ -0,0 +1,25 @@
+import {
+  normalizeTemporalInput
+} from "./chunk-MJSZNWCV.js";
+
+// src/roundToNearestMinute.ts
+var MODE_TO_ROUNDING_MODE = {
+  round: "halfExpand",
+  ceil: "ceil",
+  floor: "floor"
+};
+function roundToNearestMinute(input, options) {
+  const zonedDateTime = normalizeTemporalInput(input);
+  const mode = options?.mode ?? "round";
+  const nearestTo = options?.nearestTo ?? 1;
+  return zonedDateTime.round({
+    smallestUnit: "minute",
+    roundingMode: MODE_TO_ROUNDING_MODE[mode],
+    roundingIncrement: nearestTo
+  });
+}
+
+export {
+  roundToNearestMinute
+};
+//# sourceMappingURL=chunk-UJW2FPI4.js.map

package/dist/chunk-UJW2FPI4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/roundToNearestMinute.ts"],"sourcesContent":["import type { Temporal } from '@js-temporal/polyfill';\nimport { normalizeTemporalInput } from './shared/normalizeTemporalInput';\n\n/**\n * Options for rounding to nearest minute.\n */\nexport interface RoundToNearestMinuteOptions {\n  /**\n   * The rounding mode to use.\n   *\n   * Given time 14:37:20:\n   * - `'round'` → 14:37 (20 sec < 30, rounds DOWN to nearest)\n   * - `'ceil'`  → 14:38 (always rounds UP to next minute)\n   * - `'floor'` → 14:37 (always rounds DOWN to current minute)\n   *\n   * Given time 14:37:00 with nearestTo: 15:\n   * - `'round'` → 14:30 (37 is closer to 30 than 45)\n   * - `'ceil'`  → 14:45 (always rounds UP to next 15-min slot)\n   * - `'floor'` → 14:30 (always rounds DOWN to current 15-min slot)\n   *\n   * @default 'round'\n   */\n  mode?: 'round' | 'ceil' | 'floor';\n  /**\n   * Round to the nearest N minutes. Must divide evenly into 60.\n   * Valid values: 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30\n   * @example nearestTo: 15 rounds to quarter-hour marks (00, 15, 30, 45)\n   */\n  nearestTo?: 1 | 2 | 3 | 4 | 5 | 6 | 10 | 12 | 15 | 20 | 30;\n}\n\nconst MODE_TO_ROUNDING_MODE = {\n  round: 'halfExpand',\n  ceil: 'ceil',\n  floor: 'floor',\n} as const;\n\n/**\n * Rounds a datetime to the nearest minute boundary.\n *\n * ## Mode comparison (given 14:37 with 15-min slots)\n *\n * ```\n * 14:30 ─────────●───────────────────── 14:45\n *              14:37\n *\n * 'round' → 14:30  (nearest slot - 37 is closer to 30 than 45)\n * 'ceil'  → 14:45  (next slot - always up)\n * 'floor' → 14:30  (current slot - always down)\n * ```\n *\n * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime\n * @param options - Rounding options\n * @returns ZonedDateTime rounded to the minute boundary\n *\n * @example\n * ```ts\n * // 15-minute booking slots at 14:37\n * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:00[America/New_York]');\n *\n * roundToNearestMinute(time, { nearestTo: 15 });                    // → 14:30 (nearest)\n * roundToNearestMinute(time, { mode: 'ceil', nearestTo: 15 });      // → 14:45 (next slot)\n * roundToNearestMinute(time, { mode: 'floor', nearestTo: 15 });     // → 14:30 (current slot)\n * ```\n *\n * @example\n * ```ts\n * // Basic minute rounding (no slots)\n * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:42[America/New_York]');\n *\n * roundToNearestMinute(time);                     // → 14:38 (42 sec >= 30)\n * roundToNearestMinute(time, { mode: 'ceil' });   // → 14:38 (always up)\n * roundToNearestMinute(time, { mode: 'floor' });  // → 14:37 (always down)\n * ```\n *\n * @example\n * ```ts\n * // Billing: round up to 30-minute increments\n * const sessionEnd = Temporal.ZonedDateTime.from('2025-01-20T11:07:00[America/New_York]');\n * roundToNearestMinute(sessionEnd, { mode: 'ceil', nearestTo: 30 });\n * // → 11:30 (bill for 30 mins even though session was 7 mins)\n * ```\n */\nexport function roundToNearestMinute(\n  input: Temporal.Instant | Temporal.ZonedDateTime,\n  options?: RoundToNearestMinuteOptions\n): Temporal.ZonedDateTime {\n  const zonedDateTime = normalizeTemporalInput(input);\n  const mode = options?.mode ?? 'round';\n  const nearestTo = options?.nearestTo ?? 1;\n\n  return zonedDateTime.round({\n    smallestUnit: 'minute',\n    roundingMode: MODE_TO_ROUNDING_MODE[mode],\n    roundingIncrement: nearestTo,\n  });\n}\n"],"mappings":";;;;;AA+BA,IAAM,wBAAwB;AAAA,EAC5B,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AACT;AAgDO,SAAS,qBACd,OACA,SACwB;AACxB,QAAM,gBAAgB,uBAAuB,KAAK;AAClD,QAAM,OAAO,SAAS,QAAQ;AAC9B,QAAM,YAAY,SAAS,aAAa;AAExC,SAAO,cAAc,MAAM;AAAA,IACzB,cAAc;AAAA,IACd,cAAc,sBAAsB,IAAI;AAAA,IACxC,mBAAmB;AAAA,EACrB,CAAC;AACH;","names":[]}

package/dist/chunk-UJWM2BV2.js

@@ -0,0 +1,41 @@
+// src/toPlainTime.ts
+import { Temporal } from "@js-temporal/polyfill";
+var PLAIN_TIME_PATTERN = /^\d{2}:\d{2}(:\d{2}(\.\d+)?)?$/;
+function toPlainTime(input, timezone) {
+  if (input instanceof Temporal.ZonedDateTime && timezone === void 0) {
+    return input.toPlainTime();
+  }
+  if (input instanceof Date) {
+    if (timezone === void 0) {
+      throw new Error("Timezone is required unless input is a ZonedDateTime, PlainTimeLike, or plain time string");
+    }
+    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone).toPlainTime();
+  }
+  if (input instanceof Temporal.Instant) {
+    if (timezone === void 0) {
+      throw new Error("Timezone is required unless input is a ZonedDateTime, PlainTimeLike, or plain time string");
+    }
+    return input.toZonedDateTimeISO(timezone).toPlainTime();
+  }
+  if (input instanceof Temporal.ZonedDateTime) {
+    if (timezone === void 0) {
+      throw new Error("Timezone is required unless input is a ZonedDateTime, PlainTimeLike, or plain time string");
+    }
+    return input.toInstant().toZonedDateTimeISO(timezone).toPlainTime();
+  }
+  if (typeof input === "string") {
+    if (timezone !== void 0) {
+      return Temporal.Instant.from(input).toZonedDateTimeISO(timezone).toPlainTime();
+    }
+    if (PLAIN_TIME_PATTERN.test(input)) {
+      return Temporal.PlainTime.from(input);
+    }
+    throw new Error("Timezone is required unless input is a ZonedDateTime, PlainTimeLike, or plain time string");
+  }
+  return Temporal.PlainTime.from(input);
+}
+
+export {
+  toPlainTime
+};
+//# sourceMappingURL=chunk-UJWM2BV2.js.map

package/dist/chunk-UJWM2BV2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toPlainTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport type { Timezone } from './types';\n\n// Pattern to detect plain time strings: HH:MM, HH:MM:SS, or HH:MM:SS.fractional\nconst PLAIN_TIME_PATTERN = /^\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?$/;\n\n/**\n * Parse a plain time or extract the wall-clock time from a datetime.\n *\n * @param input - A PlainTimeLike object, plain time string (HH:MM or HH:MM:SS), ZonedDateTime, or datetime input requiring timezone\n * @param timezone - IANA timezone identifier. Required for ISO strings, Date, and Instant inputs.\n * @returns A Temporal.PlainTime representing the wall-clock time\n *\n * @example\n * ```typescript\n * import { toPlainTime, toZonedTime } from '@gobrand/tiempo';\n *\n * // From PlainTimeLike object (no timezone needed)\n * const time = toPlainTime({ hour: 14, minute: 30 }); // 14:30\n *\n * // From plain time string (no timezone needed)\n * const time2 = toPlainTime(\"14:30\"); // 14:30\n * const timeWithSeconds = toPlainTime(\"14:30:45\"); // 14:30:45\n *\n * // From ZonedDateTime (no timezone needed)\n * const zdt = toZonedTime(\"2025-01-20T15:30:00Z\", \"America/New_York\");\n * const time3 = toPlainTime(zdt); // 10:30\n *\n * // From UTC string with timezone\n * const time4 = toPlainTime(\"2025-01-20T15:30:00Z\", \"America/New_York\"); // 10:30\n *\n * // From Date with timezone\n * const date = new Date(\"2025-01-20T15:30:00.000Z\");\n * const time5 = toPlainTime(date, \"Europe/London\"); // 15:30\n *\n * // From Instant with timezone\n * const instant = Temporal.Instant.from(\"2025-01-20T15:30:00Z\");\n * const time6 = toPlainTime(instant, \"Asia/Tokyo\"); // 00:30\n * ```\n */\nexport function toPlainTime(input: Temporal.ZonedDateTime): Temporal.PlainTime;\nexport function toPlainTime(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: Timezone\n): Temporal.PlainTime;\nexport function toPlainTime(input: Temporal.PlainTimeLike | string): Temporal.PlainTime;\nexport function toPlainTime(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime | Temporal.PlainTimeLike,\n  timezone?: Timezone\n): Temporal.PlainTime {\n  // ZonedDateTime without timezone override\n  if (input instanceof Temporal.ZonedDateTime && timezone === undefined) {\n    return input.toPlainTime();\n  }\n\n  // Date requires timezone\n  if (input instanceof Date) {\n    if (timezone === undefined) {\n      throw new Error('Timezone is required unless input is a ZonedDateTime, PlainTimeLike, or plain time string');\n    }\n    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone).toPlainTime();\n  }\n\n  // Instant requires timezone\n  if (input instanceof Temporal.Instant) {\n    if (timezone === undefined) {\n      throw new Error('Timezone is required unless input is a ZonedDateTime, PlainTimeLike, or plain time string');\n    }\n    return input.toZonedDateTimeISO(timezone).toPlainTime();\n  }\n\n  // ZonedDateTime with timezone override\n  if (input instanceof Temporal.ZonedDateTime) {\n    if (timezone === undefined) {\n      throw new Error('Timezone is required unless input is a ZonedDateTime, PlainTimeLike, or plain time string');\n    }\n    return input.toInstant().toZonedDateTimeISO(timezone).toPlainTime();\n  }\n\n  // String: ISO datetime (requires timezone) or plain time (no timezone)\n  if (typeof input === 'string') {\n    if (timezone !== undefined) {\n      return Temporal.Instant.from(input).toZonedDateTimeISO(timezone).toPlainTime();\n    }\n    if (PLAIN_TIME_PATTERN.test(input)) {\n      return Temporal.PlainTime.from(input);\n    }\n    throw new Error('Timezone is required unless input is a ZonedDateTime, PlainTimeLike, or plain time string');\n  }\n\n  // PlainTimeLike object - pass directly to Temporal.PlainTime.from()\n  return Temporal.PlainTime.from(input);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAIzB,IAAM,qBAAqB;AA0CpB,SAAS,YACd,OACA,UACoB;AAEpB,MAAI,iBAAiB,SAAS,iBAAiB,aAAa,QAAW;AACrE,WAAO,MAAM,YAAY;AAAA,EAC3B;AAGA,MAAI,iBAAiB,MAAM;AACzB,QAAI,aAAa,QAAW;AAC1B,YAAM,IAAI,MAAM,2FAA2F;AAAA,IAC7G;AACA,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EAC7F;AAGA,MAAI,iBAAiB,SAAS,SAAS;AACrC,QAAI,aAAa,QAAW;AAC1B,YAAM,IAAI,MAAM,2FAA2F;AAAA,IAC7G;AACA,WAAO,MAAM,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EACxD;AAGA,MAAI,iBAAiB,SAAS,eAAe;AAC3C,QAAI,aAAa,QAAW;AAC1B,YAAM,IAAI,MAAM,2FAA2F;AAAA,IAC7G;AACA,WAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EACpE;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,aAAa,QAAW;AAC1B,aAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,IAC/E;AACA,QAAI,mBAAmB,KAAK,KAAK,GAAG;AAClC,aAAO,SAAS,UAAU,KAAK,KAAK;AAAA,IACtC;AACA,UAAM,IAAI,MAAM,2FAA2F;AAAA,EAC7G;AAGA,SAAO,SAAS,UAAU,KAAK,KAAK;AACtC;","names":[]}

package/dist/index.d.ts

@@ -64,6 +64,9 @@ export { differenceInDays } from './differenceInDays';
 export { differenceInWeeks } from './differenceInWeeks';
 export { differenceInMonths } from './differenceInMonths';
 export { differenceInYears } from './differenceInYears';
+export { roundToNearestHour, type RoundToNearestHourOptions, } from './roundToNearestHour';
+export { roundToNearestMinute, type RoundToNearestMinuteOptions, } from './roundToNearestMinute';
+export { roundToNearestSecond, type RoundToNearestSecondOptions, } from './roundToNearestSecond';
 export { intlFormatDistance, type IntlFormatDistanceOptions, } from './intlFormatDistance';
 export { isPlainDateBefore } from './isPlainDateBefore';
 export { isPlainDateAfter } from './isPlainDateAfter';

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,9 +1,27 @@
+import {
+  toPlainDate
+} from "./chunk-HFQUXON5.js";
+import {
+  toPlainTime
+} from "./chunk-UJWM2BV2.js";
+import {
+  toUtc
+} from "./chunk-BW5SFCKS.js";
 import {
   toZonedTime
 } from "./chunk-MXQFENCR.js";
 import {
   today
 } from "./chunk-KZB6NERH.js";
+import {
+  subNanoseconds
+} from "./chunk-WVHAYLBW.js";
+import {
+  subSeconds
+} from "./chunk-BH2YB4MV.js";
+import {
+  subWeeks
+} from "./chunk-U4RNUZXO.js";
 import {
   subYears
 } from "./chunk-AHMKY474.js";
@@ -17,14 +35,14 @@ import {
   toIso9075
 } from "./chunk-DFLGGK4F.js";
 import {
-  toPlainDate
-} from "./chunk-UCCWUJ2K.js";
+  startOfWeek
+} from "./chunk-EZ7NVTZI.js";
 import {
-  toPlainTime
-} from "./chunk-G45S5B4O.js";
+  startOfYear
+} from "./chunk-ID52RFFD.js";
 import {
-  toUtc
-} from "./chunk-BW5SFCKS.js";
+  subDays
+} from "./chunk-YKBP3G7L.js";
 import {
   subHours
 } from "./chunk-XW5MLXX5.js";
@@ -40,21 +58,21 @@ import {
 import {
   subMonths
 } from "./chunk-52NEOY34.js";
-import {
-  subNanoseconds
-} from "./chunk-WVHAYLBW.js";
-import {
-  subSeconds
-} from "./chunk-BH2YB4MV.js";
-import {
-  subWeeks
-} from "./chunk-U4RNUZXO.js";
 import {
   isSameYear
 } from "./chunk-VLZ3HQQA.js";
 import {
   now
 } from "./chunk-FSD3DDFC.js";
+import {
+  roundToNearestHour
+} from "./chunk-MMI2HHT7.js";
+import {
+  roundToNearestMinute
+} from "./chunk-UJW2FPI4.js";
+import {
+  roundToNearestSecond
+} from "./chunk-JHRXY36W.js";
 import {
   simpleFormat
 } from "./chunk-TFSZ55L7.js";
@@ -64,15 +82,6 @@ import {
 import {
   startOfMonth
 } from "./chunk-7GEIOKVQ.js";
-import {
-  startOfWeek
-} from "./chunk-EZ7NVTZI.js";
-import {
-  startOfYear
-} from "./chunk-ID52RFFD.js";
-import {
-  subDays
-} from "./chunk-YKBP3G7L.js";
 import {
   isSameHour
 } from "./chunk-EEQ3REET.js";
@@ -267,6 +276,9 @@ export {
   isSameWeek,
   isSameYear,
   now,
+  roundToNearestHour,
+  roundToNearestMinute,
+  roundToNearestSecond,
   simpleFormat,
   startOfDay,
   startOfMonth,

package/dist/roundToNearestHour.d.ts

@@ -0,0 +1,77 @@
+import type { Temporal } from '@js-temporal/polyfill';
+/**
+ * Options for rounding to nearest hour.
+ */
+export interface RoundToNearestHourOptions {
+    /**
+     * The rounding mode to use.
+     *
+     * Given time 14:20:
+     * - `'round'` → 14:00 (20 min < 30, rounds DOWN to nearest)
+     * - `'ceil'`  → 15:00 (always rounds UP to next hour)
+     * - `'floor'` → 14:00 (always rounds DOWN to current hour)
+     *
+     * Given time 14:40:
+     * - `'round'` → 15:00 (40 min >= 30, rounds UP to nearest)
+     * - `'ceil'`  → 15:00 (always rounds UP to next hour)
+     * - `'floor'` → 14:00 (always rounds DOWN to current hour)
+     *
+     * @default 'round'
+     */
+    mode?: 'round' | 'ceil' | 'floor';
+    /**
+     * Round to the nearest N hours. Must divide evenly into 24.
+     * Valid values: 1, 2, 3, 4, 6, 8, 12
+     * @example nearestTo: 6 rounds to 00:00, 06:00, 12:00, or 18:00
+     */
+    nearestTo?: 1 | 2 | 3 | 4 | 6 | 8 | 12;
+}
+/**
+ * Rounds a datetime to the nearest hour boundary.
+ *
+ * ## Mode comparison (given 14:20)
+ *
+ * ```
+ * 14:00 ─────────────●───────────────── 15:00
+ *                  14:20
+ *
+ * 'round' → 14:00  (nearest hour - 20 min < 30)
+ * 'ceil'  → 15:00  (next hour - always up)
+ * 'floor' → 14:00  (current hour - always down)
+ * ```
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param options - Rounding options
+ * @returns ZonedDateTime rounded to the hour boundary
+ *
+ * @example
+ * ```ts
+ * const time = Temporal.ZonedDateTime.from('2025-01-20T14:20:00[America/New_York]');
+ *
+ * roundToNearestHour(time);                     // → 14:00 (nearest)
+ * roundToNearestHour(time, { mode: 'ceil' });   // → 15:00 (always up)
+ * roundToNearestHour(time, { mode: 'floor' });  // → 14:00 (always down)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With 37 minutes (past the halfway point)
+ * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:00[America/New_York]');
+ *
+ * roundToNearestHour(time);                     // → 15:00 (nearest - 37 >= 30)
+ * roundToNearestHour(time, { mode: 'ceil' });   // → 15:00 (always up)
+ * roundToNearestHour(time, { mode: 'floor' });  // → 14:00 (always down)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Round to 6-hour blocks (shift scheduling)
+ * const time = Temporal.ZonedDateTime.from('2025-01-20T14:00:00[America/New_York]');
+ *
+ * roundToNearestHour(time, { nearestTo: 6 });                    // → 12:00
+ * roundToNearestHour(time, { mode: 'ceil', nearestTo: 6 });      // → 18:00
+ * roundToNearestHour(time, { mode: 'floor', nearestTo: 6 });     // → 12:00
+ * ```
+ */
+export declare function roundToNearestHour(input: Temporal.Instant | Temporal.ZonedDateTime, options?: RoundToNearestHourOptions): Temporal.ZonedDateTime;
+//# sourceMappingURL=roundToNearestHour.d.ts.map

package/dist/roundToNearestHour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundToNearestHour.d.ts","sourceRoot":"","sources":["../src/roundToNearestHour.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;CACxC;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,OAAO,CAAC,EAAE,yBAAyB,GAClC,QAAQ,CAAC,aAAa,CAUxB"}

package/dist/roundToNearestHour.js

@@ -0,0 +1,8 @@
+import {
+  roundToNearestHour
+} from "./chunk-MMI2HHT7.js";
+import "./chunk-MJSZNWCV.js";
+export {
+  roundToNearestHour
+};
+//# sourceMappingURL=roundToNearestHour.js.map

package/dist/roundToNearestHour.js.map

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

package/dist/roundToNearestHour.test.d.ts

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

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

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

package/dist/roundToNearestMinute.d.ts

@@ -0,0 +1,76 @@
+import type { Temporal } from '@js-temporal/polyfill';
+/**
+ * Options for rounding to nearest minute.
+ */
+export interface RoundToNearestMinuteOptions {
+    /**
+     * The rounding mode to use.
+     *
+     * Given time 14:37:20:
+     * - `'round'` → 14:37 (20 sec < 30, rounds DOWN to nearest)
+     * - `'ceil'`  → 14:38 (always rounds UP to next minute)
+     * - `'floor'` → 14:37 (always rounds DOWN to current minute)
+     *
+     * Given time 14:37:00 with nearestTo: 15:
+     * - `'round'` → 14:30 (37 is closer to 30 than 45)
+     * - `'ceil'`  → 14:45 (always rounds UP to next 15-min slot)
+     * - `'floor'` → 14:30 (always rounds DOWN to current 15-min slot)
+     *
+     * @default 'round'
+     */
+    mode?: 'round' | 'ceil' | 'floor';
+    /**
+     * Round to the nearest N minutes. Must divide evenly into 60.
+     * Valid values: 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30
+     * @example nearestTo: 15 rounds to quarter-hour marks (00, 15, 30, 45)
+     */
+    nearestTo?: 1 | 2 | 3 | 4 | 5 | 6 | 10 | 12 | 15 | 20 | 30;
+}
+/**
+ * Rounds a datetime to the nearest minute boundary.
+ *
+ * ## Mode comparison (given 14:37 with 15-min slots)
+ *
+ * ```
+ * 14:30 ─────────●───────────────────── 14:45
+ *              14:37
+ *
+ * 'round' → 14:30  (nearest slot - 37 is closer to 30 than 45)
+ * 'ceil'  → 14:45  (next slot - always up)
+ * 'floor' → 14:30  (current slot - always down)
+ * ```
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param options - Rounding options
+ * @returns ZonedDateTime rounded to the minute boundary
+ *
+ * @example
+ * ```ts
+ * // 15-minute booking slots at 14:37
+ * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:00[America/New_York]');
+ *
+ * roundToNearestMinute(time, { nearestTo: 15 });                    // → 14:30 (nearest)
+ * roundToNearestMinute(time, { mode: 'ceil', nearestTo: 15 });      // → 14:45 (next slot)
+ * roundToNearestMinute(time, { mode: 'floor', nearestTo: 15 });     // → 14:30 (current slot)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Basic minute rounding (no slots)
+ * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:42[America/New_York]');
+ *
+ * roundToNearestMinute(time);                     // → 14:38 (42 sec >= 30)
+ * roundToNearestMinute(time, { mode: 'ceil' });   // → 14:38 (always up)
+ * roundToNearestMinute(time, { mode: 'floor' });  // → 14:37 (always down)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Billing: round up to 30-minute increments
+ * const sessionEnd = Temporal.ZonedDateTime.from('2025-01-20T11:07:00[America/New_York]');
+ * roundToNearestMinute(sessionEnd, { mode: 'ceil', nearestTo: 30 });
+ * // → 11:30 (bill for 30 mins even though session was 7 mins)
+ * ```
+ */
+export declare function roundToNearestMinute(input: Temporal.Instant | Temporal.ZonedDateTime, options?: RoundToNearestMinuteOptions): Temporal.ZonedDateTime;
+//# sourceMappingURL=roundToNearestMinute.d.ts.map

package/dist/roundToNearestMinute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundToNearestMinute.d.ts","sourceRoot":"","sources":["../src/roundToNearestMinute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;CAC5D;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,OAAO,CAAC,EAAE,2BAA2B,GACpC,QAAQ,CAAC,aAAa,CAUxB"}

package/dist/roundToNearestMinute.js

@@ -0,0 +1,8 @@
+import {
+  roundToNearestMinute
+} from "./chunk-UJW2FPI4.js";
+import "./chunk-MJSZNWCV.js";
+export {
+  roundToNearestMinute
+};
+//# sourceMappingURL=roundToNearestMinute.js.map

package/dist/roundToNearestMinute.js.map

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

package/dist/roundToNearestMinute.test.d.ts

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

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

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

package/dist/roundToNearestSecond.d.ts

@@ -0,0 +1,75 @@
+import type { Temporal } from '@js-temporal/polyfill';
+/**
+ * Options for rounding to nearest second.
+ */
+export interface RoundToNearestSecondOptions {
+    /**
+     * The rounding mode to use.
+     *
+     * Given time 14:37:42.300:
+     * - `'round'` → 14:37:42 (300ms < 500, rounds DOWN to nearest)
+     * - `'ceil'`  → 14:37:43 (always rounds UP to next second)
+     * - `'floor'` → 14:37:42 (always rounds DOWN to current second)
+     *
+     * Given time 14:37:42 with nearestTo: 10:
+     * - `'round'` → 14:37:40 (42 is closer to 40 than 50)
+     * - `'ceil'`  → 14:37:50 (always rounds UP to next 10-sec mark)
+     * - `'floor'` → 14:37:40 (always rounds DOWN to current 10-sec mark)
+     *
+     * @default 'round'
+     */
+    mode?: 'round' | 'ceil' | 'floor';
+    /**
+     * Round to the nearest N seconds. Must divide evenly into 60.
+     * Valid values: 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30
+     * @example nearestTo: 10 rounds to 10-second marks (00, 10, 20, 30, 40, 50)
+     */
+    nearestTo?: 1 | 2 | 3 | 4 | 5 | 6 | 10 | 12 | 15 | 20 | 30;
+}
+/**
+ * Rounds a datetime to the nearest second boundary.
+ *
+ * ## Mode comparison (given 14:37:42.567)
+ *
+ * ```
+ * :42 ─────────────────●─────────────── :43
+ *                    .567
+ *
+ * 'round' → :43  (nearest second - 567ms >= 500)
+ * 'ceil'  → :43  (next second - always up)
+ * 'floor' → :42  (current second - always down)
+ * ```
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param options - Rounding options
+ * @returns ZonedDateTime rounded to the second boundary
+ *
+ * @example
+ * ```ts
+ * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:42.567[America/New_York]');
+ *
+ * roundToNearestSecond(time);                     // → 14:37:43 (567ms >= 500)
+ * roundToNearestSecond(time, { mode: 'ceil' });   // → 14:37:43 (always up)
+ * roundToNearestSecond(time, { mode: 'floor' });  // → 14:37:42 (always down)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 10-second intervals
+ * const time = Temporal.ZonedDateTime.from('2025-01-20T14:37:42[America/New_York]');
+ *
+ * roundToNearestSecond(time, { nearestTo: 10 });                   // → 14:37:40 (nearest)
+ * roundToNearestSecond(time, { mode: 'ceil', nearestTo: 10 });     // → 14:37:50 (next 10s)
+ * roundToNearestSecond(time, { mode: 'floor', nearestTo: 10 });    // → 14:37:40 (current 10s)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Remove sub-second precision for logging
+ * const logTime = Temporal.ZonedDateTime.from('2025-01-20T14:37:42.123456789[UTC]');
+ * roundToNearestSecond(logTime, { mode: 'floor' });
+ * // → 14:37:42.000000000 (clean timestamp)
+ * ```
+ */
+export declare function roundToNearestSecond(input: Temporal.Instant | Temporal.ZonedDateTime, options?: RoundToNearestSecondOptions): Temporal.ZonedDateTime;
+//# sourceMappingURL=roundToNearestSecond.d.ts.map

package/dist/roundToNearestSecond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundToNearestSecond.d.ts","sourceRoot":"","sources":["../src/roundToNearestSecond.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;CAC5D;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,OAAO,CAAC,EAAE,2BAA2B,GACpC,QAAQ,CAAC,aAAa,CAUxB"}

package/dist/roundToNearestSecond.js

@@ -0,0 +1,8 @@
+import {
+  roundToNearestSecond
+} from "./chunk-JHRXY36W.js";
+import "./chunk-MJSZNWCV.js";
+export {
+  roundToNearestSecond
+};
+//# sourceMappingURL=roundToNearestSecond.js.map

package/dist/roundToNearestSecond.js.map

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

package/dist/roundToNearestSecond.test.d.ts

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

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

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

package/dist/toPlainDate.d.ts

@@ -1,31 +1,38 @@
 import { Temporal } from '@js-temporal/polyfill';
 import type { Timezone } from './types';
 /**
- * Extract the calendar date from a ZonedDateTime or convert an input to a timezone and extract the date.
+ * Parse a plain date or extract the calendar date from a datetime.
  *
- * @param input - A Temporal.ZonedDateTime (timezone optional) or a UTC ISO string, Date, Instant, or ZonedDateTime (timezone required)
- * @param timezone - IANA timezone identifier. Required unless input is a ZonedDateTime.
+ * @param input - A PlainDateLike object, plain date string (YYYY-MM-DD), ZonedDateTime, or datetime input requiring timezone
+ * @param timezone - IANA timezone identifier. Required for ISO strings, Date, and Instant inputs.
  * @returns A Temporal.PlainDate representing the calendar date
  *
  * @example
  * ```typescript
  * import { toPlainDate, toZonedTime } from '@gobrand/tiempo';
  *
+ * // From PlainDateLike object (no timezone needed)
+ * const date = toPlainDate({ year: 2025, month: 1, day: 20 }); // 2025-01-20
+ *
+ * // From plain date string (no timezone needed)
+ * const date2 = toPlainDate("2025-01-20"); // 2025-01-20
+ *
  * // From ZonedDateTime (no timezone needed)
  * const zdt = toZonedTime("2025-01-20T15:30:00Z", "America/New_York");
- * const date = toPlainDate(zdt); // 2025-01-20
+ * const date3 = toPlainDate(zdt); // 2025-01-20
  *
  * // From UTC string with timezone
- * const date2 = toPlainDate("2025-01-20T15:30:00Z", "America/New_York"); // 2025-01-20
+ * const date4 = toPlainDate("2025-01-20T15:30:00Z", "America/New_York"); // 2025-01-20
  *
  * // From Date with timezone
  * const jsDate = new Date("2025-01-20T15:30:00.000Z");
- * const date3 = toPlainDate(jsDate, "Europe/London"); // 2025-01-20
+ * const date5 = toPlainDate(jsDate, "Europe/London"); // 2025-01-20
  *
  * // Date boundary crossing: 23:00 UTC on Jan 20 → Jan 21 in Tokyo
- * const date4 = toPlainDate("2025-01-20T23:00:00Z", "Asia/Tokyo"); // 2025-01-21
+ * const date6 = toPlainDate("2025-01-20T23:00:00Z", "Asia/Tokyo"); // 2025-01-21
  * ```
  */
 export declare function toPlainDate(input: Temporal.ZonedDateTime): Temporal.PlainDate;
 export declare function toPlainDate(input: string | Date | Temporal.Instant | Temporal.ZonedDateTime, timezone: Timezone): Temporal.PlainDate;
+export declare function toPlainDate(input: Temporal.PlainDateLike | string): Temporal.PlainDate;
 //# sourceMappingURL=toPlainDate.d.ts.map

package/dist/toPlainDate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toPlainDate.d.ts","sourceRoot":"","sources":["../src/toPlainDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC/E,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChE,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,SAAS,CAAC"}
+{"version":3,"file":"toPlainDate.d.ts","sourceRoot":"","sources":["../src/toPlainDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC/E,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChE,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,SAAS,CAAC;AACtB,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC"}

package/dist/toPlainDate.js

@@ -1,6 +1,6 @@
 import {
   toPlainDate
-} from "./chunk-UCCWUJ2K.js";
+} from "./chunk-HFQUXON5.js";
 export {
   toPlainDate
 };

package/dist/toPlainTime.d.ts

@@ -1,32 +1,40 @@
 import { Temporal } from '@js-temporal/polyfill';
 import type { Timezone } from './types';
 /**
- * Extract the wall-clock time from a ZonedDateTime or convert an input to a timezone and extract the time.
+ * Parse a plain time or extract the wall-clock time from a datetime.
  *
- * @param input - A Temporal.ZonedDateTime (timezone optional) or a UTC ISO string, Date, Instant, or ZonedDateTime (timezone required)
- * @param timezone - IANA timezone identifier. Required unless input is a ZonedDateTime.
+ * @param input - A PlainTimeLike object, plain time string (HH:MM or HH:MM:SS), ZonedDateTime, or datetime input requiring timezone
+ * @param timezone - IANA timezone identifier. Required for ISO strings, Date, and Instant inputs.
  * @returns A Temporal.PlainTime representing the wall-clock time
  *
  * @example
  * ```typescript
  * import { toPlainTime, toZonedTime } from '@gobrand/tiempo';
  *
+ * // From PlainTimeLike object (no timezone needed)
+ * const time = toPlainTime({ hour: 14, minute: 30 }); // 14:30
+ *
+ * // From plain time string (no timezone needed)
+ * const time2 = toPlainTime("14:30"); // 14:30
+ * const timeWithSeconds = toPlainTime("14:30:45"); // 14:30:45
+ *
  * // From ZonedDateTime (no timezone needed)
  * const zdt = toZonedTime("2025-01-20T15:30:00Z", "America/New_York");
- * const time = toPlainTime(zdt); // 10:30
+ * const time3 = toPlainTime(zdt); // 10:30
  *
  * // From UTC string with timezone
- * const time2 = toPlainTime("2025-01-20T15:30:00Z", "America/New_York"); // 10:30
+ * const time4 = toPlainTime("2025-01-20T15:30:00Z", "America/New_York"); // 10:30
  *
  * // From Date with timezone
  * const date = new Date("2025-01-20T15:30:00.000Z");
- * const time3 = toPlainTime(date, "Europe/London"); // 15:30
+ * const time5 = toPlainTime(date, "Europe/London"); // 15:30
  *
  * // From Instant with timezone
  * const instant = Temporal.Instant.from("2025-01-20T15:30:00Z");
- * const time4 = toPlainTime(instant, "Asia/Tokyo"); // 00:30
+ * const time6 = toPlainTime(instant, "Asia/Tokyo"); // 00:30
  * ```
  */
 export declare function toPlainTime(input: Temporal.ZonedDateTime): Temporal.PlainTime;
 export declare function toPlainTime(input: string | Date | Temporal.Instant | Temporal.ZonedDateTime, timezone: Timezone): Temporal.PlainTime;
+export declare function toPlainTime(input: Temporal.PlainTimeLike | string): Temporal.PlainTime;
 //# sourceMappingURL=toPlainTime.d.ts.map

package/dist/toPlainTime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toPlainTime.d.ts","sourceRoot":"","sources":["../src/toPlainTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC/E,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChE,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,SAAS,CAAC"}
+{"version":3,"file":"toPlainTime.d.ts","sourceRoot":"","sources":["../src/toPlainTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC/E,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChE,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,SAAS,CAAC;AACtB,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC"}

package/dist/toPlainTime.js

@@ -1,6 +1,6 @@
 import {
   toPlainTime
-} from "./chunk-G45S5B4O.js";
+} from "./chunk-UJWM2BV2.js";
 export {
   toPlainTime
 };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;AAE5C,YAAY,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;AAE5C,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/package.json

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

package/dist/chunk-G45S5B4O.js

@@ -1,25 +0,0 @@
-// src/toPlainTime.ts
-import { Temporal } from "@js-temporal/polyfill";
-function toPlainTime(input, timezone) {
-  if (input instanceof Temporal.ZonedDateTime && timezone === void 0) {
-    return input.toPlainTime();
-  }
-  if (timezone === void 0) {
-    throw new Error("Timezone is required unless input is a ZonedDateTime");
-  }
-  if (typeof input === "string") {
-    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone).toPlainTime();
-  }
-  if (input instanceof Date) {
-    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone).toPlainTime();
-  }
-  if (input instanceof Temporal.Instant) {
-    return input.toZonedDateTimeISO(timezone).toPlainTime();
-  }
-  return input.toInstant().toZonedDateTimeISO(timezone).toPlainTime();
-}
-
-export {
-  toPlainTime
-};
-//# sourceMappingURL=chunk-G45S5B4O.js.map

package/dist/chunk-G45S5B4O.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toPlainTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport type { Timezone } from './types';\n\n/**\n * Extract the wall-clock time from a ZonedDateTime or convert an input to a timezone and extract the time.\n *\n * @param input - A Temporal.ZonedDateTime (timezone optional) or a UTC ISO string, Date, Instant, or ZonedDateTime (timezone required)\n * @param timezone - IANA timezone identifier. Required unless input is a ZonedDateTime.\n * @returns A Temporal.PlainTime representing the wall-clock time\n *\n * @example\n * ```typescript\n * import { toPlainTime, toZonedTime } from '@gobrand/tiempo';\n *\n * // From ZonedDateTime (no timezone needed)\n * const zdt = toZonedTime(\"2025-01-20T15:30:00Z\", \"America/New_York\");\n * const time = toPlainTime(zdt); // 10:30\n *\n * // From UTC string with timezone\n * const time2 = toPlainTime(\"2025-01-20T15:30:00Z\", \"America/New_York\"); // 10:30\n *\n * // From Date with timezone\n * const date = new Date(\"2025-01-20T15:30:00.000Z\");\n * const time3 = toPlainTime(date, \"Europe/London\"); // 15:30\n *\n * // From Instant with timezone\n * const instant = Temporal.Instant.from(\"2025-01-20T15:30:00Z\");\n * const time4 = toPlainTime(instant, \"Asia/Tokyo\"); // 00:30\n * ```\n */\nexport function toPlainTime(input: Temporal.ZonedDateTime): Temporal.PlainTime;\nexport function toPlainTime(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: Timezone\n): Temporal.PlainTime;\nexport function toPlainTime(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone?: Timezone\n): Temporal.PlainTime {\n  if (input instanceof Temporal.ZonedDateTime && timezone === undefined) {\n    return input.toPlainTime();\n  }\n\n  if (timezone === undefined) {\n    throw new Error('Timezone is required unless input is a ZonedDateTime');\n  }\n\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone).toPlainTime();\n  }\n\n  if (input instanceof Date) {\n    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone).toPlainTime();\n  }\n\n  if (input instanceof Temporal.Instant) {\n    return input.toZonedDateTimeISO(timezone).toPlainTime();\n  }\n\n  return input.toInstant().toZonedDateTimeISO(timezone).toPlainTime();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAmClB,SAAS,YACd,OACA,UACoB;AACpB,MAAI,iBAAiB,SAAS,iBAAiB,aAAa,QAAW;AACrE,WAAO,MAAM,YAAY;AAAA,EAC3B;AAEA,MAAI,aAAa,QAAW;AAC1B,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EAC/E;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EAC7F;AAEA,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EACxD;AAEA,SAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AACpE;","names":[]}

package/dist/chunk-UCCWUJ2K.js

@@ -1,25 +0,0 @@
-// src/toPlainDate.ts
-import { Temporal } from "@js-temporal/polyfill";
-function toPlainDate(input, timezone) {
-  if (input instanceof Temporal.ZonedDateTime && timezone === void 0) {
-    return input.toPlainDate();
-  }
-  if (timezone === void 0) {
-    throw new Error("Timezone is required unless input is a ZonedDateTime");
-  }
-  if (typeof input === "string") {
-    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone).toPlainDate();
-  }
-  if (input instanceof Date) {
-    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone).toPlainDate();
-  }
-  if (input instanceof Temporal.Instant) {
-    return input.toZonedDateTimeISO(timezone).toPlainDate();
-  }
-  return input.toInstant().toZonedDateTimeISO(timezone).toPlainDate();
-}
-
-export {
-  toPlainDate
-};
-//# sourceMappingURL=chunk-UCCWUJ2K.js.map

package/dist/chunk-UCCWUJ2K.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toPlainDate.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport type { Timezone } from './types';\n\n/**\n * Extract the calendar date from a ZonedDateTime or convert an input to a timezone and extract the date.\n *\n * @param input - A Temporal.ZonedDateTime (timezone optional) or a UTC ISO string, Date, Instant, or ZonedDateTime (timezone required)\n * @param timezone - IANA timezone identifier. Required unless input is a ZonedDateTime.\n * @returns A Temporal.PlainDate representing the calendar date\n *\n * @example\n * ```typescript\n * import { toPlainDate, toZonedTime } from '@gobrand/tiempo';\n *\n * // From ZonedDateTime (no timezone needed)\n * const zdt = toZonedTime(\"2025-01-20T15:30:00Z\", \"America/New_York\");\n * const date = toPlainDate(zdt); // 2025-01-20\n *\n * // From UTC string with timezone\n * const date2 = toPlainDate(\"2025-01-20T15:30:00Z\", \"America/New_York\"); // 2025-01-20\n *\n * // From Date with timezone\n * const jsDate = new Date(\"2025-01-20T15:30:00.000Z\");\n * const date3 = toPlainDate(jsDate, \"Europe/London\"); // 2025-01-20\n *\n * // Date boundary crossing: 23:00 UTC on Jan 20 → Jan 21 in Tokyo\n * const date4 = toPlainDate(\"2025-01-20T23:00:00Z\", \"Asia/Tokyo\"); // 2025-01-21\n * ```\n */\nexport function toPlainDate(input: Temporal.ZonedDateTime): Temporal.PlainDate;\nexport function toPlainDate(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: Timezone\n): Temporal.PlainDate;\nexport function toPlainDate(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone?: Timezone\n): Temporal.PlainDate {\n  if (input instanceof Temporal.ZonedDateTime && timezone === undefined) {\n    return input.toPlainDate();\n  }\n\n  if (timezone === undefined) {\n    throw new Error('Timezone is required unless input is a ZonedDateTime');\n  }\n\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone).toPlainDate();\n  }\n\n  if (input instanceof Date) {\n    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone).toPlainDate();\n  }\n\n  if (input instanceof Temporal.Instant) {\n    return input.toZonedDateTimeISO(timezone).toPlainDate();\n  }\n\n  return input.toInstant().toZonedDateTimeISO(timezone).toPlainDate();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAkClB,SAAS,YACd,OACA,UACoB;AACpB,MAAI,iBAAiB,SAAS,iBAAiB,aAAa,QAAW;AACrE,WAAO,MAAM,YAAY;AAAA,EAC3B;AAEA,MAAI,aAAa,QAAW;AAC1B,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EAC/E;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EAC7F;AAEA,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,mBAAmB,QAAQ,EAAE,YAAY;AAAA,EACxD;AAEA,SAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ,EAAE,YAAY;AACpE;","names":[]}