@gobrand/tiempo 2.9.1 → 2.10.0

package/dist/startOfQuarter.d.ts

@@ -0,0 +1,38 @@
+import { Temporal } from "./shared/temporal";
+import type { Timezone } from "./types";
+/**
+ * Returns a ZonedDateTime representing the first moment of the quarter
+ * (first day of the quarter's starting month at midnight).
+ *
+ * Quarters: Q1 = Jan–Mar, Q2 = Apr–Jun, Q3 = Jul–Sep, Q4 = Oct–Dec.
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @returns ZonedDateTime at the 1st day of the quarter at 00:00:00.000000000
+ *
+ * @example
+ * ```ts
+ * // From Instant (always UTC)
+ * const instant = Temporal.Instant.from('2025-05-15T12:00:00Z');
+ * const start = startOfQuarter(instant);
+ * // 2025-04-01T00:00:00Z[UTC]
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From ZonedDateTime (uses its timezone)
+ * const zoned = Temporal.ZonedDateTime.from('2025-08-15T15:30:00-05:00[America/New_York]');
+ * const start = startOfQuarter(zoned);
+ * // 2025-07-01T00:00:00-04:00[America/New_York]
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From PlainDate (requires timezone)
+ * const date = Temporal.PlainDate.from('2025-11-15');
+ * const start = startOfQuarter(date, 'America/New_York');
+ * // 2025-10-01T00:00:00-04:00[America/New_York]
+ * ```
+ */
+export declare function startOfQuarter(input: Temporal.Instant | Temporal.ZonedDateTime): Temporal.ZonedDateTime;
+export declare function startOfQuarter(input: Temporal.PlainDate, timezone: Timezone): Temporal.ZonedDateTime;
+//# sourceMappingURL=startOfQuarter.d.ts.map

package/dist/startOfQuarter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startOfQuarter.d.ts","sourceRoot":"","sources":["../src/startOfQuarter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,SAAS,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAAC"}

package/dist/startOfQuarter.js

@@ -0,0 +1,12 @@
+import {
+  startOfQuarter
+} from "./chunk-XMW72PNW.js";
+import "./chunk-XS2HUADA.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
+export {
+  startOfQuarter
+};
+//# sourceMappingURL=startOfQuarter.js.map

package/dist/startOfQuarter.js.map

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

package/dist/startOfQuarter.test.d.ts

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

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

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

package/dist/startOfWeek.js

@@ -1,9 +1,9 @@
 import {
   startOfWeek
-} from "./chunk-I6S6EIZG.js";
-import "./chunk-AHBTUFRW.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-SDJJP4HW.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   startOfWeek
 };

package/dist/startOfYear.js

@@ -1,10 +1,10 @@
 import {
   startOfYear
-} from "./chunk-HDTIOOWB.js";
-import "./chunk-TWZNSMKO.js";
-import "./chunk-AHBTUFRW.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-TGINH5JV.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   startOfYear
 };

package/dist/subDays.js

@@ -1,9 +1,9 @@
 import {
   subDays
-} from "./chunk-5ZOOVGMT.js";
-import "./chunk-MEADD45E.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-JBM7DESQ.js";
+import "./chunk-G2U5WGRP.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subDays
 };

package/dist/subHours.js

@@ -1,9 +1,9 @@
 import {
   subHours
-} from "./chunk-4RLD3OE2.js";
-import "./chunk-7JL3U64G.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-OFIPZPEA.js";
+import "./chunk-DHFBKOFZ.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subHours
 };

package/dist/subMicroseconds.js

@@ -1,9 +1,9 @@
 import {
   subMicroseconds
-} from "./chunk-FLRHLAMD.js";
-import "./chunk-WWLDINLH.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-URC6AG2N.js";
+import "./chunk-IAXVREU5.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subMicroseconds
 };

package/dist/subMilliseconds.js

@@ -1,9 +1,9 @@
 import {
   subMilliseconds
-} from "./chunk-OX4I35UO.js";
-import "./chunk-ATEVQYB6.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-VS2VCQLP.js";
+import "./chunk-FCJO72WG.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subMilliseconds
 };

package/dist/subMinutes.js

@@ -1,9 +1,9 @@
 import {
   subMinutes
-} from "./chunk-TKV5JYQY.js";
-import "./chunk-MXE44KVG.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-JQFD563S.js";
+import "./chunk-4PGGOVSG.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subMinutes
 };

package/dist/subMonths.js

@@ -1,9 +1,9 @@
 import {
   subMonths
-} from "./chunk-YNV6WGXV.js";
-import "./chunk-3RSGMPWR.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-2EFJSF2R.js";
+import "./chunk-VQPIPLHX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subMonths
 };

package/dist/subNanoseconds.js

@@ -1,9 +1,9 @@
 import {
   subNanoseconds
-} from "./chunk-3ORGILYG.js";
-import "./chunk-OPWK2TVF.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-BTXU3OGV.js";
+import "./chunk-WGLZHBJG.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subNanoseconds
 };

package/dist/subQuarters.d.ts

@@ -0,0 +1,20 @@
+import type { Temporal } from "@js-temporal/polyfill";
+/**
+ * Subtracts the specified number of quarters (3-month blocks) from a datetime.
+ *
+ * This is a convenience wrapper around addQuarters with negated value.
+ * Properly handles month-end dates and calendar edge cases through Temporal API.
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param quarters - Number of quarters to subtract
+ * @returns ZonedDateTime with quarters subtracted, in the same timezone as input
+ *
+ * @example
+ * ```ts
+ * const instant = Temporal.Instant.from('2025-07-20T12:00:00Z');
+ * const result = subQuarters(instant, 2);
+ * // 2025-01-20T12:00:00Z[UTC] (6 months earlier)
+ * ```
+ */
+export declare function subQuarters(input: Temporal.Instant | Temporal.ZonedDateTime, quarters: number): Temporal.ZonedDateTime;
+//# sourceMappingURL=subQuarters.d.ts.map

package/dist/subQuarters.d.ts.map

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

package/dist/subQuarters.js

@@ -0,0 +1,10 @@
+import {
+  subQuarters
+} from "./chunk-W5YDBBNF.js";
+import "./chunk-ZEL6JBBH.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
+export {
+  subQuarters
+};
+//# sourceMappingURL=subQuarters.js.map

package/dist/subQuarters.js.map

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

package/dist/subQuarters.test.d.ts

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

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

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

package/dist/subSeconds.js

@@ -1,9 +1,9 @@
 import {
   subSeconds
-} from "./chunk-VXG2IG2N.js";
-import "./chunk-IOLV6PTH.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-OQNFKOPA.js";
+import "./chunk-LAITZAIG.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subSeconds
 };

package/dist/subWeeks.js

@@ -1,9 +1,9 @@
 import {
   subWeeks
-} from "./chunk-4JPDLKBK.js";
-import "./chunk-NE7HNEF6.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-MDXN3WMH.js";
+import "./chunk-ZG4ROOWI.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subWeeks
 };

package/dist/subYears.js

@@ -1,9 +1,9 @@
 import {
   subYears
-} from "./chunk-3XNQYFWS.js";
-import "./chunk-YMS7JXBN.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-ZYU3P74L.js";
+import "./chunk-6YU6BQOZ.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   subYears
 };

package/dist/toDate.js

@@ -1,7 +1,7 @@
 import {
   toDate
-} from "./chunk-GSVAMMHA.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-M7Y67IAB.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   toDate
 };

package/dist/toIso.js

@@ -1,7 +1,7 @@
 import {
   toIso
-} from "./chunk-YO2VXHA5.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-H5BHFVEN.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   toIso
 };

package/dist/toIso9075.js

@@ -1,7 +1,7 @@
 import {
   toIso9075
-} from "./chunk-VTXBG2JV.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-RL2NW7HP.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   toIso9075
 };

package/dist/toPlainDate.js

@@ -1,7 +1,7 @@
 import {
   toPlainDate
-} from "./chunk-J52B4PX6.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-2E4KCD3Y.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   toPlainDate
 };

package/dist/toPlainTime.js

@@ -1,7 +1,7 @@
 import {
   toPlainTime
-} from "./chunk-RLF3Y7VC.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-M4KDJ4I4.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   toPlainTime
 };

package/dist/toUtc.js

@@ -1,7 +1,7 @@
 import {
   toUtc
-} from "./chunk-2PDEHGNB.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-RXTGHEHQ.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   toUtc
 };

package/dist/toZonedTime.js

@@ -1,7 +1,7 @@
 import {
   toZonedTime
-} from "./chunk-BQHSXMGZ.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-ELUSLRWQ.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   toZonedTime
 };

package/dist/today.js

@@ -1,7 +1,7 @@
 import {
   today
-} from "./chunk-TCEDHHNM.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-PX2I4GCF.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   today
 };

package/package.json

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

package/dist/chunk-AI5MRREC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/temporal.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * @internal\n * Single source of the Temporal implementation.\n *\n * Currently always uses `@js-temporal/polyfill`. A previous attempt to prefer\n * the runtime's native `globalThis.Temporal` was reverted: tiempo passes\n * caller-provided Temporal objects into static methods\n * (`Temporal.ZonedDateTime.compare`, etc.), and a native static method throws\n * (\"Must specify time zone.\") when handed an object created by a different\n * implementation than the one tiempo resolved. Native-first can return once\n * inputs are normalized into the resolved implementation at the boundary, with\n * a native-Temporal CI runner guarding it.\n *\n * Import `Temporal` from here so the implementation choice stays in one place.\n */\nexport { Temporal };\n\n/**\n * @internal\n * Implementation-agnostic type guards. The Temporal spec requires every\n * implementation to set `Symbol.toStringTag`, so these work regardless of which\n * implementation produced the object.\n */\nfunction brand(value: unknown): string | undefined {\n  return typeof value === 'object' && value !== null\n    ? (value as { [Symbol.toStringTag]?: string })[Symbol.toStringTag]\n    : undefined;\n}\n\nexport function isInstant(value: unknown): value is Temporal.Instant {\n  return brand(value) === 'Temporal.Instant';\n}\n\nexport function isZonedDateTime(\n  value: unknown\n): value is Temporal.ZonedDateTime {\n  return brand(value) === 'Temporal.ZonedDateTime';\n}\n\nexport function isPlainDate(value: unknown): value is Temporal.PlainDate {\n  return brand(value) === 'Temporal.PlainDate';\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAyBzB,SAAS,MAAM,OAAoC;AACjD,SAAO,OAAO,UAAU,YAAY,UAAU,OACzC,MAA4C,OAAO,WAAW,IAC/D;AACN;AAEO,SAAS,UAAU,OAA2C;AACnE,SAAO,MAAM,KAAK,MAAM;AAC1B;AAEO,SAAS,gBACd,OACiC;AACjC,SAAO,MAAM,KAAK,MAAM;AAC1B;AAEO,SAAS,YAAY,OAA6C;AACvE,SAAO,MAAM,KAAK,MAAM;AAC1B;","names":[]}