@formkit/tempo 0.1.2 → 1.1.0

package/README.md

@@ -10,7 +10,28 @@ Tempo is a new library in a proud tradition of JavaScript date and time librarie
 
 Tempo is best thought of as a collection of utilities for working with `Date` objects — an important distinction from other libraries that provide custom date primitives. Under the hood, Tempo mines JavaScript's `Intl.DateTimeFormat` to extract complex data like timezones offsets and locale aware date formats giving you a simple API to format, parse, and manipulates dates.
 
-Tempo is tiny tree-shakable framework, you can only take what you need. All functionality is available in **5.2 kB for esm** and **5.5 kB for cjs** modules (minified and brotlied). [Size Limit](https://github.com/ai/size-limit) controls the size.
+Tempo is tiny tree-shakable framework, you can only take what you need. You can work with timezones with only a few bytes of library code, or perform full international date formatting for ~2Kb (minified and brotlied). [Size Limit](https://github.com/ai/size-limit) controls the size.
+
+## Development
+
+Install from the repository root with `pnpm`:
+
+```bash
+corepack enable
+pnpm install
+```
+
+Build the library:
+
+```bash
+pnpm build
+```
+
+Build the docs app:
+
+```bash
+pnpm docs-build
+```
 
 <a href="https://tempo.formkit.com">
 <img src="docs/public/read-the-docs.png" alt="Read the docs" width="200" height="43">

package/dist/add.d.ts

@@ -0,0 +1,11 @@
+import { MaybeDateInput, Duration } from './types.js';
+
+/**
+ * Returns a new Date object with the duration applied.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param duration - An object with values for the amount of time to add to the original date.
+ * @param [dateOverflow] - Whether to allow month/year changes to overflow into a later month.
+ */
+declare function add(inputDate: MaybeDateInput, duration: Duration, dateOverflow?: boolean): Date;
+
+export { add };

package/dist/add.mjs

@@ -0,0 +1,50 @@
+// src/add.ts
+import { addDay } from "./addDay.mjs";
+import { addHour } from "./addHour.mjs";
+import { addMillisecond } from "./addMillisecond.mjs";
+import { addMinute } from "./addMinute.mjs";
+import { addMonth } from "./addMonth.mjs";
+import { addSecond } from "./addSecond.mjs";
+import { addYear } from "./addYear.mjs";
+import { date } from "./date.mjs";
+function add(inputDate, duration, dateOverflow = false) {
+  var _a, _b;
+  let d = date(inputDate);
+  const applyFixedUnits = () => {
+    if (duration.weeks) {
+      d = addDay(d, duration.weeks * 7);
+    }
+    if (duration.days) {
+      d = addDay(d, duration.days);
+    }
+    if (duration.hours) {
+      d = addHour(d, duration.hours);
+    }
+    if (duration.minutes) {
+      d = addMinute(d, duration.minutes);
+    }
+    if (duration.seconds) {
+      d = addSecond(d, duration.seconds);
+    }
+    if (duration.milliseconds) {
+      d = addMillisecond(d, duration.milliseconds);
+    }
+  };
+  const applyCalendarUnits = () => {
+    if (duration.months) {
+      d = addMonth(d, duration.months, dateOverflow);
+    }
+    if (duration.years) {
+      d = addYear(d, duration.years, dateOverflow);
+    }
+  };
+  const calendarFirst = ((_a = duration.months) != null ? _a : 0) < 0 || ((_b = duration.years) != null ? _b : 0) < 0;
+  if (calendarFirst) applyCalendarUnits();
+  applyFixedUnits();
+  if (!calendarFirst) applyCalendarUnits();
+  return d;
+}
+export {
+  add
+};
+//# sourceMappingURL=add.mjs.map

package/dist/add.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/add.ts"],"sourcesContent":["import { addDay } from \"./addDay\"\nimport { addHour } from \"./addHour\"\nimport { addMillisecond } from \"./addMillisecond\"\nimport { addMinute } from \"./addMinute\"\nimport { addMonth } from \"./addMonth\"\nimport { addSecond } from \"./addSecond\"\nimport { addYear } from \"./addYear\"\nimport { date } from \"./date\"\nimport type { Duration, MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new Date object with the duration applied.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param duration - An object with values for the amount of time to add to the original date.\n * @param [dateOverflow] - Whether to allow month/year changes to overflow into a later month.\n */\nexport function add(\n  inputDate: MaybeDateInput,\n  duration: Duration,\n  dateOverflow = false\n) {\n  let d = date(inputDate)\n  const applyFixedUnits = () => {\n    if (duration.weeks) {\n      d = addDay(d, duration.weeks * 7)\n    }\n    if (duration.days) {\n      d = addDay(d, duration.days)\n    }\n    if (duration.hours) {\n      d = addHour(d, duration.hours)\n    }\n    if (duration.minutes) {\n      d = addMinute(d, duration.minutes)\n    }\n    if (duration.seconds) {\n      d = addSecond(d, duration.seconds)\n    }\n    if (duration.milliseconds) {\n      d = addMillisecond(d, duration.milliseconds)\n    }\n  }\n  const applyCalendarUnits = () => {\n    if (duration.months) {\n      d = addMonth(d, duration.months, dateOverflow)\n    }\n    if (duration.years) {\n      d = addYear(d, duration.years, dateOverflow)\n    }\n  }\n  const calendarFirst = (duration.months ?? 0) < 0 || (duration.years ?? 0) < 0\n\n  if (calendarFirst) applyCalendarUnits()\n  applyFixedUnits()\n  if (!calendarFirst) applyCalendarUnits()\n\n  return d\n}\n"],"mappings":";AAAA,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAC/B,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,YAAY;AASd,SAAS,IACd,WACA,UACA,eAAe,OACf;AApBF;AAqBE,MAAI,IAAI,KAAK,SAAS;AACtB,QAAM,kBAAkB,MAAM;AAC5B,QAAI,SAAS,OAAO;AAClB,UAAI,OAAO,GAAG,SAAS,QAAQ,CAAC;AAAA,IAClC;AACA,QAAI,SAAS,MAAM;AACjB,UAAI,OAAO,GAAG,SAAS,IAAI;AAAA,IAC7B;AACA,QAAI,SAAS,OAAO;AAClB,UAAI,QAAQ,GAAG,SAAS,KAAK;AAAA,IAC/B;AACA,QAAI,SAAS,SAAS;AACpB,UAAI,UAAU,GAAG,SAAS,OAAO;AAAA,IACnC;AACA,QAAI,SAAS,SAAS;AACpB,UAAI,UAAU,GAAG,SAAS,OAAO;AAAA,IACnC;AACA,QAAI,SAAS,cAAc;AACzB,UAAI,eAAe,GAAG,SAAS,YAAY;AAAA,IAC7C;AAAA,EACF;AACA,QAAM,qBAAqB,MAAM;AAC/B,QAAI,SAAS,QAAQ;AACnB,UAAI,SAAS,GAAG,SAAS,QAAQ,YAAY;AAAA,IAC/C;AACA,QAAI,SAAS,OAAO;AAClB,UAAI,QAAQ,GAAG,SAAS,OAAO,YAAY;AAAA,IAC7C;AAAA,EACF;AACA,QAAM,kBAAiB,cAAS,WAAT,YAAmB,KAAK,OAAM,cAAS,UAAT,YAAkB,KAAK;AAE5E,MAAI,cAAe,oBAAmB;AACtC,kBAAgB;AAChB,MAAI,CAAC,cAAe,oBAAmB;AAEvC,SAAO;AACT;","names":[]}

package/dist/addDay.d.ts

@@ -1,9 +1,10 @@
-import { DateInput } from './types.js';
+import { MaybeDateInput } from './types.js';
 
 /**
  * Returns a new date object 1/n days after the original one.
- * @param inputDate - A date to increment by 1 day.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param [count] - The quantity to add.
  */
-declare function addDay(inputDate: DateInput, count?: number): Date;
+declare function addDay(inputDate?: MaybeDateInput, count?: number): Date;
 
 export { addDay };

package/dist/addDay.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addDay.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n days after the original one.\n * @param inputDate - A date to increment by 1 day.\n */\nexport function addDay(inputDate: DateInput, count = 1) {\n  const d = date(inputDate)\n  d.setDate(d.getDate() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAOd,SAAS,OAAO,WAAsB,QAAQ,GAAG;AACtD,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,QAAQ,EAAE,QAAQ,IAAI,KAAK;AAC7B,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/addDay.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n days after the original one.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param [count] - The quantity to add.\n */\nexport function addDay(inputDate?: MaybeDateInput, count = 1) {\n  const d = date(inputDate)\n  d.setDate(d.getDate() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,OAAO,WAA4B,QAAQ,GAAG;AAC5D,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,QAAQ,EAAE,QAAQ,IAAI,KAAK;AAC7B,SAAO;AACT;","names":[]}

package/dist/addHour.d.ts

@@ -1,9 +1,10 @@
-import { DateInput } from './types.js';
+import { MaybeDateInput } from './types.js';
 
 /**
  * Returns a new date object 1/n hours after the original one.
- * @param inputDate - A date to increment by 1 day.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param [count] - The quantity to add.
  */
-declare function addHour(inputDate: DateInput, count?: number): Date;
+declare function addHour(inputDate?: MaybeDateInput, count?: number): Date;
 
 export { addHour };

package/dist/addHour.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addHour.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n hours after the original one.\n * @param inputDate - A date to increment by 1 day.\n */\nexport function addHour(inputDate: DateInput, count = 1) {\n  const d = date(inputDate)\n  d.setHours(d.getHours() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAOd,SAAS,QAAQ,WAAsB,QAAQ,GAAG;AACvD,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,SAAS,EAAE,SAAS,IAAI,KAAK;AAC/B,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/addHour.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n hours after the original one.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param [count] - The quantity to add.\n */\nexport function addHour(inputDate?: MaybeDateInput, count = 1) {\n  const d = date(inputDate)\n  d.setHours(d.getHours() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,QAAQ,WAA4B,QAAQ,GAAG;AAC7D,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,SAAS,EAAE,SAAS,IAAI,KAAK;AAC/B,SAAO;AACT;","names":[]}

package/dist/addMillisecond.d.ts

@@ -0,0 +1,10 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * Returns a new date object 1/n milliseconds after the original one.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param [count] - The quantity to add.
+ */
+declare function addMillisecond(inputDate?: MaybeDateInput, count?: number): Date;
+
+export { addMillisecond };

package/dist/addMillisecond.mjs

@@ -0,0 +1,11 @@
+// src/addMillisecond.ts
+import { date } from "./date.mjs";
+function addMillisecond(inputDate, count = 1) {
+  const d = date(inputDate);
+  d.setMilliseconds(d.getMilliseconds() + count);
+  return d;
+}
+export {
+  addMillisecond
+};
+//# sourceMappingURL=addMillisecond.mjs.map

package/dist/addMillisecond.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/addMillisecond.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n milliseconds after the original one.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param [count] - The quantity to add.\n */\nexport function addMillisecond(inputDate?: MaybeDateInput, count = 1) {\n  const d = date(inputDate)\n  d.setMilliseconds(d.getMilliseconds() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,eAAe,WAA4B,QAAQ,GAAG;AACpE,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,gBAAgB,EAAE,gBAAgB,IAAI,KAAK;AAC7C,SAAO;AACT;","names":[]}

package/dist/addMinute.d.ts

@@ -1,9 +1,10 @@
-import { DateInput } from './types.js';
+import { MaybeDateInput } from './types.js';
 
 /**
- * Returns a new date object 1/n seconds after the original one.
- * @param inputDate - A date to increment by 1 day.
+ * Returns a new date object 1/n minutes after the original one.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param [count] - The quantity to add.
  */
-declare function addMinute(inputDate: DateInput, count?: number): Date;
+declare function addMinute(inputDate?: MaybeDateInput, count?: number): Date;
 
 export { addMinute };

package/dist/addMinute.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addMinute.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n seconds after the original one.\n * @param inputDate - A date to increment by 1 day.\n */\nexport function addMinute(inputDate: DateInput, count = 1) {\n  const d = date(inputDate)\n  d.setMinutes(d.getMinutes() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAOd,SAAS,UAAU,WAAsB,QAAQ,GAAG;AACzD,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,WAAW,EAAE,WAAW,IAAI,KAAK;AACnC,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/addMinute.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { DateInput, MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n minutes after the original one.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param [count] - The quantity to add.\n */\nexport function addMinute(inputDate?: MaybeDateInput, count = 1) {\n  const d = date(inputDate)\n  d.setMinutes(d.getMinutes() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,UAAU,WAA4B,QAAQ,GAAG;AAC/D,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,WAAW,EAAE,WAAW,IAAI,KAAK;AACnC,SAAO;AACT;","names":[]}

package/dist/addMonth.d.ts

@@ -1,13 +1,13 @@
-import { DateInput } from './types.js';
+import { MaybeDateInput } from './types.js';
 
 /**
  * Returns a new date object 1/n months after the original one. Keep in mind if you
  * start with a date late in a given month you could get a date after the next
  * month.
- * @param inputDate - A date to increment by 1 or more months.
- * @param count - The quantity to add.
- * @param dateOverflow - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.
+ * @param [inputDate] - A date to increment or null to increment from the current time
+ * @param [count] - The quantity to add.
+ * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.
  */
-declare function addMonth(inputDate: DateInput, count?: number, dateOverflow?: boolean): Date;
+declare function addMonth(inputDate?: MaybeDateInput, count?: number, dateOverflow?: boolean): Date;
 
 export { addMonth };

package/dist/addMonth.mjs

@@ -1,17 +1,7 @@
 // src/addMonth.ts
-import { date } from "./date.mjs";
-import { monthDays } from "./monthDays.mjs";
+import { handleOverflow } from "./handleDateOverflow.mjs";
 function addMonth(inputDate, count = 1, dateOverflow = false) {
-  const d = date(inputDate);
-  const dayOfMonth = d.getDate();
-  if (!dateOverflow)
-    d.setDate(1);
-  d.setMonth(d.getMonth() + count);
-  if (!dateOverflow) {
-    const daysInMonth = monthDays(d);
-    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth);
-  }
-  return d;
+  return handleOverflow(inputDate, (d) => d.setMonth(d.getMonth() + count), dateOverflow);
 }
 export {
   addMonth

package/dist/addMonth.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addMonth.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { monthDays } from \"./monthDays\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n months after the original one. Keep in mind if you\n * start with a date late in a given month you could get a date after the next\n * month.\n * @param inputDate - A date to increment by 1 or more months.\n * @param count - The quantity to add.\n * @param dateOverflow - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.\n */\nexport function addMonth(\n  inputDate: DateInput,\n  count = 1,\n  dateOverflow = false\n) {\n  const d = date(inputDate)\n  const dayOfMonth = d.getDate()\n  // If overflowing is disallowed, set the date back to the first of the month\n  if (!dateOverflow) d.setDate(1)\n  d.setMonth(d.getMonth() + count)\n\n  // If overflowing is disallowed, we need to set the date back to the proper\n  // day or the last day of the month.\n  if (!dateOverflow) {\n    const daysInMonth = monthDays(d)\n    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth)\n  }\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAWnB,SAAS,SACd,WACA,QAAQ,GACR,eAAe,OACf;AACA,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,aAAa,EAAE,QAAQ;AAE7B,MAAI,CAAC;AAAc,MAAE,QAAQ,CAAC;AAC9B,IAAE,SAAS,EAAE,SAAS,IAAI,KAAK;AAI/B,MAAI,CAAC,cAAc;AACjB,UAAM,cAAc,UAAU,CAAC;AAC/B,MAAE,QAAQ,cAAc,aAAa,cAAc,UAAU;AAAA,EAC/D;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/addMonth.ts"],"sourcesContent":["import { handleOverflow } from \"./handleDateOverflow\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n months after the original one. Keep in mind if you\n * start with a date late in a given month you could get a date after the next\n * month.\n * @param [inputDate] - A date to increment or null to increment from the current time\n * @param [count] - The quantity to add.\n * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.\n */\nexport function addMonth(inputDate?: MaybeDateInput, count = 1, dateOverflow = false) {\n  return handleOverflow(inputDate, (d) => d.setMonth(d.getMonth() + count), dateOverflow)\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAWxB,SAAS,SAAS,WAA4B,QAAQ,GAAG,eAAe,OAAO;AACpF,SAAO,eAAe,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,IAAI,KAAK,GAAG,YAAY;AACxF;","names":[]}

package/dist/addSecond.d.ts

@@ -1,9 +1,10 @@
-import { DateInput } from './types.js';
+import { MaybeDateInput } from './types.js';
 
 /**
  * Returns a new date object 1/n seconds after the original one.
- * @param inputDate - A date to increment by 1 day.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param [count] - The quantity to add.
  */
-declare function addSecond(inputDate: DateInput, count?: number): Date;
+declare function addSecond(inputDate?: MaybeDateInput, count?: number): Date;
 
 export { addSecond };

package/dist/addSecond.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addSecond.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n seconds after the original one.\n * @param inputDate - A date to increment by 1 day.\n */\nexport function addSecond(inputDate: DateInput, count = 1) {\n  const d = date(inputDate)\n  d.setSeconds(d.getSeconds() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAOd,SAAS,UAAU,WAAsB,QAAQ,GAAG;AACzD,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,WAAW,EAAE,WAAW,IAAI,KAAK;AACnC,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/addSecond.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n seconds after the original one.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param [count] - The quantity to add.\n */\nexport function addSecond(inputDate?: MaybeDateInput, count = 1) {\n  const d = date(inputDate)\n  d.setSeconds(d.getSeconds() + count)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,UAAU,WAA4B,QAAQ,GAAG;AAC/D,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,WAAW,EAAE,WAAW,IAAI,KAAK;AACnC,SAAO;AACT;","names":[]}

package/dist/addYear.d.ts

@@ -1,13 +1,13 @@
-import { DateInput } from './types.js';
+import { MaybeDateInput } from './types.js';
 
 /**
  * Returns a new date object 1/n years after the original one. Keep in mind if
  * you start with a date late in a given month you could get a date after the
  * next month.
- * @param inputDate - A date to increment by 1 day.
- * @param count - The quantity of years add.
- * @param dateOverflow - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param [count] - The quantity of years add.
+ * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.
  */
-declare function addYear(inputDate: DateInput, count?: number, dateOverflow?: boolean): Date;
+declare function addYear(inputDate?: MaybeDateInput, count?: number, dateOverflow?: boolean): Date;
 
 export { addYear };

package/dist/addYear.mjs

@@ -1,17 +1,11 @@
 // src/addYear.ts
-import { date } from "./date.mjs";
-import { monthDays } from "./monthDays.mjs";
+import { handleOverflow } from "./handleDateOverflow.mjs";
 function addYear(inputDate, count = 1, dateOverflow = false) {
-  const d = date(inputDate);
-  const dayOfMonth = d.getDate();
-  if (!dateOverflow)
-    d.setDate(1);
-  d.setFullYear(d.getFullYear() + count);
-  if (!dateOverflow) {
-    const daysInMonth = monthDays(d);
-    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth);
-  }
-  return d;
+  return handleOverflow(
+    inputDate,
+    (d) => d.setFullYear(d.getFullYear() + count),
+    dateOverflow
+  );
 }
 export {
   addYear

package/dist/addYear.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addYear.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { monthDays } from \"./monthDays\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n years after the original one. Keep in mind if\n * you start with a date late in a given month you could get a date after the\n * next month.\n * @param inputDate - A date to increment by 1 day.\n * @param count - The quantity of years add.\n * @param dateOverflow - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.\n */\nexport function addYear(inputDate: DateInput, count = 1, dateOverflow = false) {\n  const d = date(inputDate)\n  const dayOfMonth = d.getDate()\n  // If overflowing is disallowed, set the date back to the first of the month\n  if (!dateOverflow) d.setDate(1)\n\n  d.setFullYear(d.getFullYear() + count)\n\n  // If overflowing is disallowed, we need to set the date back to the proper\n  // day or the last day of the month.\n  if (!dateOverflow) {\n    const daysInMonth = monthDays(d)\n    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth)\n  }\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAWnB,SAAS,QAAQ,WAAsB,QAAQ,GAAG,eAAe,OAAO;AAC7E,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,aAAa,EAAE,QAAQ;AAE7B,MAAI,CAAC;AAAc,MAAE,QAAQ,CAAC;AAE9B,IAAE,YAAY,EAAE,YAAY,IAAI,KAAK;AAIrC,MAAI,CAAC,cAAc;AACjB,UAAM,cAAc,UAAU,CAAC;AAC/B,MAAE,QAAQ,cAAc,aAAa,cAAc,UAAU;AAAA,EAC/D;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/addYear.ts"],"sourcesContent":["import { handleOverflow } from \"./handleDateOverflow\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n years after the original one. Keep in mind if\n * you start with a date late in a given month you could get a date after the\n * next month.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param [count] - The quantity of years add.\n * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.\n */\nexport function addYear(inputDate?: MaybeDateInput, count = 1, dateOverflow = false) {\n  return handleOverflow(\n    inputDate,\n    (d) => d.setFullYear(d.getFullYear() + count),\n    dateOverflow\n  )\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAWxB,SAAS,QAAQ,WAA4B,QAAQ,GAAG,eAAe,OAAO;AACnF,SAAO;AAAA,IACL;AAAA,IACA,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,IAAI,KAAK;AAAA,IAC5C;AAAA,EACF;AACF;","names":[]}

package/dist/ap.mjs

@@ -2,8 +2,7 @@
 import { dayPeriodMap, specDate, normStr } from "./common.mjs";
 function ap(ampm, locale) {
   const l = dayPeriodMap.get(locale);
-  if (l && l[ampm])
-    return l[ampm];
+  if (l && l[ampm]) return l[ampm];
   const specimen = new Date(specDate);
   specimen.setUTCHours(ampm === "am" ? 5 : 20);
   const subparts = new Intl.DateTimeFormat(locale, {

package/dist/ap.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ap.ts"],"sourcesContent":["import { dayPeriodMap, specDate, normStr } from \"./common\"\n\n/**\n * Determines the correct value for am/pm by locale and memoizes it.\n * @param ampm - am or pm\n * @param locale - The locale to fetch.\n */\nexport function ap(ampm: \"am\" | \"pm\", locale: string): string {\n  const l = dayPeriodMap.get(locale)\n  if (l && l[ampm]) return l[ampm] as string\n  const specimen = new Date(specDate)\n  specimen.setUTCHours(ampm === \"am\" ? 5 : 20)\n  const subparts = new Intl.DateTimeFormat(locale, {\n    timeStyle: \"full\",\n    timeZone: \"UTC\",\n    hour12: true,\n  })\n    .formatToParts(specimen)\n    .map(normStr)\n  const period = subparts.find((part) => part.type === \"dayPeriod\")\n  if (period) {\n    const localePeriods: { am?: string; pm?: string } = l || {}\n    dayPeriodMap.set(\n      locale,\n      Object.assign(localePeriods, { [ampm]: period.value })\n    )\n    return period.value\n  }\n  return ampm\n}\n"],"mappings":";AAAA,SAAS,cAAc,UAAU,eAAe;AAOzC,SAAS,GAAG,MAAmB,QAAwB;AAC5D,QAAM,IAAI,aAAa,IAAI,MAAM;AACjC,MAAI,KAAK,EAAE,IAAI;AAAG,WAAO,EAAE,IAAI;AAC/B,QAAM,WAAW,IAAI,KAAK,QAAQ;AAClC,WAAS,YAAY,SAAS,OAAO,IAAI,EAAE;AAC3C,QAAM,WAAW,IAAI,KAAK,eAAe,QAAQ;AAAA,IAC/C,WAAW;AAAA,IACX,UAAU;AAAA,IACV,QAAQ;AAAA,EACV,CAAC,EACE,cAAc,QAAQ,EACtB,IAAI,OAAO;AACd,QAAM,SAAS,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,WAAW;AAChE,MAAI,QAAQ;AACV,UAAM,gBAA8C,KAAK,CAAC;AAC1D,iBAAa;AAAA,MACX;AAAA,MACA,OAAO,OAAO,eAAe,EAAE,CAAC,IAAI,GAAG,OAAO,MAAM,CAAC;AAAA,IACvD;AACA,WAAO,OAAO;AAAA,EAChB;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/ap.ts"],"sourcesContent":["import { dayPeriodMap, specDate, normStr } from \"./common\"\n\n/**\n * Determines the correct value for am/pm by locale and memoizes it.\n * @param ampm - am or pm\n * @param locale - The locale to fetch.\n */\nexport function ap(ampm: \"am\" | \"pm\", locale: string): string {\n  const l = dayPeriodMap.get(locale)\n  if (l && l[ampm]) return l[ampm] as string\n  const specimen = new Date(specDate)\n  specimen.setUTCHours(ampm === \"am\" ? 5 : 20)\n  const subparts = new Intl.DateTimeFormat(locale, {\n    timeStyle: \"full\",\n    timeZone: \"UTC\",\n    hour12: true,\n  })\n    .formatToParts(specimen)\n    .map(normStr)\n  const period = subparts.find((part) => part.type === \"dayPeriod\")\n  if (period) {\n    const localePeriods: { am?: string; pm?: string } = l || {}\n    dayPeriodMap.set(\n      locale,\n      Object.assign(localePeriods, { [ampm]: period.value })\n    )\n    return period.value\n  }\n  return ampm\n}\n"],"mappings":";AAAA,SAAS,cAAc,UAAU,eAAe;AAOzC,SAAS,GAAG,MAAmB,QAAwB;AAC5D,QAAM,IAAI,aAAa,IAAI,MAAM;AACjC,MAAI,KAAK,EAAE,IAAI,EAAG,QAAO,EAAE,IAAI;AAC/B,QAAM,WAAW,IAAI,KAAK,QAAQ;AAClC,WAAS,YAAY,SAAS,OAAO,IAAI,EAAE;AAC3C,QAAM,WAAW,IAAI,KAAK,eAAe,QAAQ;AAAA,IAC/C,WAAW;AAAA,IACX,UAAU;AAAA,IACV,QAAQ;AAAA,EACV,CAAC,EACE,cAAc,QAAQ,EACtB,IAAI,OAAO;AACd,QAAM,SAAS,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,WAAW;AAChE,MAAI,QAAQ;AACV,UAAM,gBAA8C,KAAK,CAAC;AAC1D,iBAAa;AAAA,MACX;AAAA,MACA,OAAO,OAAO,eAAe,EAAE,CAAC,IAAI,GAAG,OAAO,MAAM,CAAC;AAAA,IACvD;AACA,WAAO,OAAO;AAAA,EAChB;AACA,SAAO;AACT;","names":[]}

package/dist/applyOffset.d.ts

@@ -1,11 +1,11 @@
-import { DateInput } from './types.js';
+import { MaybeDateInput } from './types.js';
 
 /**
  * Apply a given offset to a date, returning a new date with the offset
- * applied by adding or subtracting the given number of minutes.
- * @param dateInput - The date to apply the offset to.
- * @param offset - The offset to apply in the +-HHmm or +-HH:mm format.
+ * applied by adding or subtracting the given number of seconds.
+ * @param [dateInput] - The date to apply the offset to. (default: current time)
+ * @param [offset] - The offset to apply in the +-HHmm, +-HH:mm, +-HHmmss, or +-HH:mm:ss format.
  */
-declare function applyOffset(dateInput: DateInput, offset?: string): Date;
+declare function applyOffset(dateInput?: MaybeDateInput, offset?: string): Date;
 
 export { applyOffset };

package/dist/applyOffset.mjs

@@ -1,18 +1,12 @@
 // src/applyOffset.ts
 import { date } from "./date.mjs";
-import { fixedLengthByOffset, offsetToMins } from "./common.mjs";
+import { fixedLengthByOffset, offsetToSecs } from "./common.mjs";
 function applyOffset(dateInput, offset = "+00:00") {
   const d = date(dateInput);
-  const token = (() => {
-    switch (fixedLengthByOffset(offset)) {
-      case 5:
-        return "ZZ";
-      case 6:
-        return "Z";
-    }
-  })();
-  const timeDiffInMins = offsetToMins(offset, token);
-  return new Date(d.getTime() + timeDiffInMins * 1e3 * 60);
+  const len = fixedLengthByOffset(offset);
+  const token = len === 5 || len === 8 ? "ZZ" : "Z";
+  const timeDiffInSecs = offsetToSecs(offset, token);
+  return new Date(d.getTime() + timeDiffInSecs * 1e3);
 }
 export {
   applyOffset

package/dist/applyOffset.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/applyOffset.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { TimezoneToken, fixedLengthByOffset, offsetToMins } from \"./common\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Apply a given offset to a date, returning a new date with the offset\n * applied by adding or subtracting the given number of minutes.\n * @param dateInput - The date to apply the offset to.\n * @param offset - The offset to apply in the +-HHmm or +-HH:mm format.\n */\nexport function applyOffset(dateInput: DateInput, offset = \"+00:00\"): Date {\n  const d = date(dateInput)\n  const token = ((): TimezoneToken => {\n    switch (fixedLengthByOffset(offset)) {\n      case 5:\n        return \"ZZ\"\n      case 6:\n        return \"Z\"\n    }\n  })()\n  const timeDiffInMins = offsetToMins(offset, token)\n  return new Date(d.getTime() + timeDiffInMins * 1000 * 60)\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAwB,qBAAqB,oBAAoB;AAS1D,SAAS,YAAY,WAAsB,SAAS,UAAgB;AACzE,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,SAAS,MAAqB;AAClC,YAAQ,oBAAoB,MAAM,GAAG;AAAA,MACnC,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,IACX;AAAA,EACF,GAAG;AACH,QAAM,iBAAiB,aAAa,QAAQ,KAAK;AACjD,SAAO,IAAI,KAAK,EAAE,QAAQ,IAAI,iBAAiB,MAAO,EAAE;AAC1D;","names":[]}
+{"version":3,"sources":["../src/applyOffset.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { TimezoneToken, fixedLengthByOffset, offsetToSecs } from \"./common\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Apply a given offset to a date, returning a new date with the offset\n * applied by adding or subtracting the given number of seconds.\n * @param [dateInput] - The date to apply the offset to. (default: current time)\n * @param [offset] - The offset to apply in the +-HHmm, +-HH:mm, +-HHmmss, or +-HH:mm:ss format.\n */\nexport function applyOffset(dateInput?: MaybeDateInput, offset = \"+00:00\"): Date {\n  const d = date(dateInput)\n  const len = fixedLengthByOffset(offset)\n  // 5 or 8 chars = no colons (ZZ format), 6 or 9 chars = with colons (Z format)\n  const token: TimezoneToken = len === 5 || len === 8 ? \"ZZ\" : \"Z\"\n  const timeDiffInSecs = offsetToSecs(offset, token)\n  return new Date(d.getTime() + timeDiffInSecs * 1000)\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAwB,qBAAqB,oBAAoB;AAS1D,SAAS,YAAY,WAA4B,SAAS,UAAgB;AAC/E,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,MAAM,oBAAoB,MAAM;AAEtC,QAAM,QAAuB,QAAQ,KAAK,QAAQ,IAAI,OAAO;AAC7D,QAAM,iBAAiB,aAAa,QAAQ,KAAK;AACjD,SAAO,IAAI,KAAK,EAAE,QAAQ,IAAI,iBAAiB,GAAI;AACrD;","names":[]}