@gobrand/tiempo 2.5.4 → 2.6.1

package/dist/isWithinInterval.js

@@ -0,0 +1,10 @@
+import {
+  isWithinInterval
+} from "./chunk-5C3TQSWA.js";
+import "./chunk-WY63VEXE.js";
+import "./chunk-WUAIUEH7.js";
+import "./chunk-MJSZNWCV.js";
+export {
+  isWithinInterval
+};
+//# sourceMappingURL=isWithinInterval.js.map

package/dist/isWithinInterval.js.map

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

package/dist/isWithinInterval.test.d.ts

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

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

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

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/shared/isAfter.d.ts

@@ -0,0 +1,3 @@
+import { Temporal } from '@js-temporal/polyfill';
+export declare function isAfter(date1: Temporal.ZonedDateTime, date2: Temporal.ZonedDateTime): boolean;
+//# sourceMappingURL=isAfter.d.ts.map

package/dist/shared/isAfter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isAfter.d.ts","sourceRoot":"","sources":["../../src/shared/isAfter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,wBAAgB,OAAO,CACrB,KAAK,EAAE,QAAQ,CAAC,aAAa,EAC7B,KAAK,EAAE,QAAQ,CAAC,aAAa,GAC5B,OAAO,CAET"}

package/dist/shared/isAfter.js

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

package/dist/shared/isAfter.js.map

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

package/dist/shared/isBefore.d.ts

@@ -0,0 +1,3 @@
+import { Temporal } from '@js-temporal/polyfill';
+export declare function isBefore(date1: Temporal.ZonedDateTime, date2: Temporal.ZonedDateTime): boolean;
+//# sourceMappingURL=isBefore.d.ts.map

package/dist/shared/isBefore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isBefore.d.ts","sourceRoot":"","sources":["../../src/shared/isBefore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,aAAa,EAC7B,KAAK,EAAE,QAAQ,CAAC,aAAa,GAC5B,OAAO,CAET"}

package/dist/shared/isBefore.js

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

package/dist/shared/isBefore.js.map

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

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.1",
   "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-IPJUERCK.js

@@ -1,16 +0,0 @@
-import {
-  normalizeTemporalInput
-} from "./chunk-MJSZNWCV.js";
-
-// src/isBefore.ts
-import { Temporal } from "@js-temporal/polyfill";
-function isBefore(date1, date2) {
-  const zoned1 = normalizeTemporalInput(date1);
-  const zoned2 = normalizeTemporalInput(date2);
-  return Temporal.ZonedDateTime.compare(zoned1, zoned2) < 0;
-}
-
-export {
-  isBefore
-};
-//# sourceMappingURL=chunk-IPJUERCK.js.map

package/dist/chunk-IPJUERCK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/isBefore.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport { normalizeTemporalInput } from './shared/normalizeTemporalInput';\n\n/**\n * Returns true if the first datetime is before the second datetime.\n * Compares by the underlying instant (epoch time), not by calendar date/time.\n *\n * @param date1 - First datetime (Instant or ZonedDateTime)\n * @param date2 - Second datetime (Instant or ZonedDateTime)\n * @returns true if date1 is before date2, false otherwise\n *\n * @example\n * ```ts\n * const earlier = Temporal.ZonedDateTime.from('2025-01-20T10:00:00-05:00[America/New_York]');\n * const later = Temporal.ZonedDateTime.from('2025-01-20T16:00:00-05:00[America/New_York]');\n *\n * isBefore(earlier, later); // true\n * isBefore(later, earlier); // false\n * isBefore(earlier, earlier); // false\n * ```\n *\n * @example\n * ```ts\n * // Works with Instant too\n * const instant1 = Temporal.Instant.from('2025-01-20T15:00:00Z');\n * const instant2 = Temporal.Instant.from('2025-01-20T16:00:00Z');\n *\n * isBefore(instant1, instant2); // true\n * ```\n *\n * @example\n * ```ts\n * // Different timezones - compares by instant\n * const ny = Temporal.ZonedDateTime.from('2025-01-20T10:00:00-05:00[America/New_York]');\n * const tokyo = Temporal.ZonedDateTime.from('2025-01-21T00:00:00+09:00[Asia/Tokyo]');\n *\n * isBefore(ny, tokyo); // true\n * // NY 10:00 is 15:00 UTC, Tokyo 00:00 is 15:00 UTC the previous day\n * ```\n */\nexport function isBefore(\n  date1: Temporal.Instant | Temporal.ZonedDateTime,\n  date2: Temporal.Instant | Temporal.ZonedDateTime\n): boolean {\n  const zoned1 = normalizeTemporalInput(date1);\n  const zoned2 = normalizeTemporalInput(date2);\n\n  return Temporal.ZonedDateTime.compare(zoned1, zoned2) < 0;\n}\n"],"mappings":";;;;;AAAA,SAAS,gBAAgB;AAwClB,SAAS,SACd,OACA,OACS;AACT,QAAM,SAAS,uBAAuB,KAAK;AAC3C,QAAM,SAAS,uBAAuB,KAAK;AAE3C,SAAO,SAAS,cAAc,QAAQ,QAAQ,MAAM,IAAI;AAC1D;","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":[]}