@gobrand/tiempo 2.9.0 → 2.10.0

package/dist/startOfDay.js

@@ -1,10 +1,10 @@
 import {
   startOfDay
-} from "./chunk-3WWRI3NR.js";
-import "./chunk-Y4HT4LCB.js";
-import "./chunk-LYPSZYIG.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.js";
+} from "./chunk-VKXN4FQD.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   startOfDay
 };

package/dist/startOfMonth.js

@@ -1,10 +1,10 @@
 import {
   startOfMonth
-} from "./chunk-SFXJV5ZT.js";
-import "./chunk-Y4HT4LCB.js";
-import "./chunk-LYPSZYIG.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.js";
+} from "./chunk-5CFWMIHL.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   startOfMonth
 };

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-OKPTY2ZQ.js";
-import "./chunk-LYPSZYIG.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-GS3J5YVW.js";
-import "./chunk-Y4HT4LCB.js";
-import "./chunk-LYPSZYIG.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-DN3V4IZC.js";
-import "./chunk-G4COVQ5S.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-VVV5BNLP.js";
-import "./chunk-DJRIH2PX.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-SDCVBRJP.js";
-import "./chunk-KKMM6HYC.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-QGXK664C.js";
-import "./chunk-KONRPZXK.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-OZYC3TAR.js";
-import "./chunk-PBT2OZJH.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-7XVPK2AV.js";
-import "./chunk-OGNREZPA.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-CP4JNCMO.js";
-import "./chunk-DOGZ2WBH.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-PWPACA4G.js";
-import "./chunk-RTANLM3L.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-ZKGR3F4F.js";
-import "./chunk-BOGN7JC3.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-WJOGQ6IB.js";
-import "./chunk-5HVHKQTJ.js";
-import "./chunk-F6EWMA4K.js";
-import "./chunk-VOZTLX5F.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-T6ONGPRF.js";
-import "./chunk-VOZTLX5F.js";
+} from "./chunk-M7Y67IAB.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   toDate
 };

package/dist/toIso.js

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

package/dist/toIso9075.js

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

package/dist/toPlainDate.js

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

package/dist/toPlainTime.js

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

package/dist/toUtc.js

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

package/dist/toZonedTime.js

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

package/dist/today.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobrand/tiempo",
-  "version": "2.9.0",
+  "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-VOZTLX5F.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/temporal.ts"],"sourcesContent":["import type { Temporal as TemporalNamespace } from '@js-temporal/polyfill';\n\n/**\n * @internal\n * Single source of the Temporal implementation.\n *\n * Prefers the runtime's native `globalThis.Temporal` (Node 26+, Chrome 144+,\n * Firefox 139+, Edge, Deno) and dynamically loads `@js-temporal/polyfill` only\n * when native Temporal is absent (Safari, Node <= 25). On native runtimes the\n * polyfill is never imported or executed.\n *\n * Do not import the polyfill directly anywhere else in src/ — import `Temporal`\n * from this module so the runtime choice stays in one place.\n */\nexport const Temporal: typeof TemporalNamespace =\n  (globalThis as { Temporal?: typeof TemporalNamespace }).Temporal ??\n  (await import('@js-temporal/polyfill')).Temporal;\n\n/**\n * @internal\n * Merge the resolved value with the polyfill's `Temporal` type namespace so a\n * single `import { Temporal }` serves both runtime construction\n * (`Temporal.Instant.from(...)`) and type annotations (`Temporal.Instant`),\n * exactly like importing `Temporal` directly from the polyfill used to.\n */\nexport namespace Temporal {\n  export type Instant = TemporalNamespace.Instant;\n  export type ZonedDateTime = TemporalNamespace.ZonedDateTime;\n  export type PlainDate = TemporalNamespace.PlainDate;\n  export type PlainTime = TemporalNamespace.PlainTime;\n  export type PlainDateTime = TemporalNamespace.PlainDateTime;\n  export type PlainYearMonth = TemporalNamespace.PlainYearMonth;\n  export type PlainMonthDay = TemporalNamespace.PlainMonthDay;\n  export type Duration = TemporalNamespace.Duration;\n  export type PlainTimeLike = TemporalNamespace.PlainTimeLike;\n  export type PlainDateLike = TemporalNamespace.PlainDateLike;\n}\n\n/**\n * @internal\n * Implementation-agnostic type guards.\n *\n * `instanceof` is identity-based and fails across implementations. The Temporal\n * spec requires every implementation to set `Symbol.toStringTag`, so brand\n * checks work regardless of which 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 TemporalNamespace.Instant {\n  return brand(value) === 'Temporal.Instant';\n}\n\nexport function isZonedDateTime(\n  value: unknown\n): value is TemporalNamespace.ZonedDateTime {\n  return brand(value) === 'Temporal.ZonedDateTime';\n}\n\nexport function isPlainDate(\n  value: unknown\n): value is TemporalNamespace.PlainDate {\n  return brand(value) === 'Temporal.PlainDate';\n}\n"],"mappings":";AAcO,IAAM,WACV,WAAuD,aACvD,MAAM,OAAO,uBAAuB,GAAG;AA8B1C,SAAS,MAAM,OAAoC;AACjD,SAAO,OAAO,UAAU,YAAY,UAAU,OACzC,MAA4C,OAAO,WAAW,IAC/D;AACN;AAEO,SAAS,UAAU,OAAoD;AAC5E,SAAO,MAAM,KAAK,MAAM;AAC1B;AAEO,SAAS,gBACd,OAC0C;AAC1C,SAAO,MAAM,KAAK,MAAM;AAC1B;AAEO,SAAS,YACd,OACsC;AACtC,SAAO,MAAM,KAAK,MAAM;AAC1B;","names":[]}