chronal 0.0.1-0

package/script/lib/is-after.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Checks if the first date is after the second date.
+ *
+ * @param dateLeft - The date to compare.
+ * @param dateRight - The date to compare against.
+ * @returns True if dateLeft is after dateRight, false otherwise.
+ * @example
+ * const date1 = new Date('2024-01-20T12:00:00Z');
+ * const date2 = new Date('2024-01-15T12:00:00Z');
+ * console.log(isAfter(date1, date2)); // true
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAfter = isAfter;
+function isAfter(dateLeft, dateRight) {
+    return dateLeft.getTime() > dateRight.getTime();
+}
+;

package/script/lib/is-before.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Checks if the first date is before the second date.
+ *
+ * @param dateLeft - The date to compare.
+ * @param dateRight - The date to compare against.
+ * @returns True if dateLeft is before dateRight, false otherwise.
+ * @example
+ * const date1 = new Date('2024-01-15T12:00:00Z');
+ * const date2 = new Date('2024-01-20T12:00:00Z');
+ * console.log(isBefore(date1, date2)); // true
+ */
+export declare function isBefore(dateLeft: Date, dateRight: Date): boolean;
+//# sourceMappingURL=is-before.d.ts.map

package/script/lib/is-before.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-before.d.ts","sourceRoot":"","sources":["../../src/lib/is-before.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAEjE"}

package/script/lib/is-before.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Checks if the first date is before the second date.
+ *
+ * @param dateLeft - The date to compare.
+ * @param dateRight - The date to compare against.
+ * @returns True if dateLeft is before dateRight, false otherwise.
+ * @example
+ * const date1 = new Date('2024-01-15T12:00:00Z');
+ * const date2 = new Date('2024-01-20T12:00:00Z');
+ * console.log(isBefore(date1, date2)); // true
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBefore = isBefore;
+function isBefore(dateLeft, dateRight) {
+    return dateLeft.getTime() < dateRight.getTime();
+}

package/script/lib/months.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns an array of month names for the specified locale and format.
+ *
+ * @param locale - The locale to use (default: 'en-US').
+ * @param format - The format of month names: 'long', 'short', or 'narrow' (default: 'long').
+ * @returns An array of 12 month names starting from January.
+ * @example
+ * console.log(months('en-US', 'long')); // ['January', 'February', 'March', ...]
+ * console.log(months('en-US', 'short')); // ['Jan', 'Feb', 'Mar', ...]
+ * console.log(months('pt-BR', 'long')); // ['janeiro', 'fevereiro', 'março', ...]
+ */
+export declare function months(locale?: string, format?: "long" | "short" | "narrow"): string[];
+//# sourceMappingURL=months.d.ts.map

package/script/lib/months.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"months.d.ts","sourceRoot":"","sources":["../../src/lib/months.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,wBAAgB,MAAM,CACpB,MAAM,SAAU,EAChB,MAAM,GAAE,MAAM,GAAG,OAAO,GAAG,QAAiB,GAC3C,MAAM,EAAE,CAiBV"}

package/script/lib/months.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.months = months;
+const monthsCache = new Map();
+/**
+ * Returns an array of month names for the specified locale and format.
+ *
+ * @param locale - The locale to use (default: 'en-US').
+ * @param format - The format of month names: 'long', 'short', or 'narrow' (default: 'long').
+ * @returns An array of 12 month names starting from January.
+ * @example
+ * console.log(months('en-US', 'long')); // ['January', 'February', 'March', ...]
+ * console.log(months('en-US', 'short')); // ['Jan', 'Feb', 'Mar', ...]
+ * console.log(months('pt-BR', 'long')); // ['janeiro', 'fevereiro', 'março', ...]
+ */
+function months(locale = "en-US", format = "long") {
+    const key = `${locale}|${format}`;
+    const cached = monthsCache.get(key);
+    if (cached)
+        return cached;
+    const fmt = new Intl.DateTimeFormat(locale, {
+        month: format,
+        timeZone: "UTC",
+    });
+    const result = Array.from({ length: 12 }, (_, i) => fmt.format(new Date(Date.UTC(2024, i, 1))));
+    monthsCache.set(key, result);
+    return result;
+}

package/script/lib/start-of.d.ts

@@ -0,0 +1,14 @@
+import type { Unit } from "../types/unit.js";
+/**
+ * Returns the start of the specified time unit for the given date.
+ *
+ * @param date - The original date.
+ * @param unit - The time unit to get the start of ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second').
+ * @returns A new Date object set to the start of the specified unit.
+ * @example
+ * const date = new Date('2024-06-15T14:35:22.500Z');
+ * const startOfDay = startOf(date, 'day');
+ * console.log(startOfDay.toISOString()); // '2024-06-15T00:00:00.000Z'
+ */
+export declare function startOf(date: Date, unit: Unit): Date;
+//# sourceMappingURL=start-of.d.ts.map

package/script/lib/start-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-of.d.ts","sourceRoot":"","sources":["../../src/lib/start-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;;;GAUG;AAEH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAwCpD"}

package/script/lib/start-of.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startOf = startOf;
+/**
+ * Returns the start of the specified time unit for the given date.
+ *
+ * @param date - The original date.
+ * @param unit - The time unit to get the start of ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second').
+ * @returns A new Date object set to the start of the specified unit.
+ * @example
+ * const date = new Date('2024-06-15T14:35:22.500Z');
+ * const startOfDay = startOf(date, 'day');
+ * console.log(startOfDay.toISOString()); // '2024-06-15T00:00:00.000Z'
+ */
+function startOf(date, unit) {
+    const time = new Date(date.getTime());
+    switch (unit) {
+        case 'year': {
+            time.setUTCMonth(0, 1);
+            time.setUTCHours(0, 0, 0, 0);
+            break;
+        }
+        case 'month': {
+            time.setUTCDate(1);
+            time.setUTCHours(0, 0, 0, 0);
+            break;
+        }
+        case 'week': {
+            const day = time.getUTCDay();
+            const diff = (day === 0 ? -6 : 1) - day; // Adjust when day is Sunday
+            time.setUTCDate(time.getUTCDate() + diff);
+            time.setUTCHours(0, 0, 0, 0);
+            break;
+        }
+        case 'day': {
+            time.setUTCHours(0, 0, 0, 0);
+            break;
+        }
+        case 'hour': {
+            time.setUTCMinutes(0, 0, 0);
+            break;
+        }
+        case 'minute': {
+            time.setUTCSeconds(0, 0);
+            break;
+        }
+        case 'second': {
+            time.setUTCMilliseconds(0);
+            break;
+        }
+    }
+    return time;
+}

package/script/lib/sub.d.ts

@@ -0,0 +1,24 @@
+type SubOptions = {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+};
+/**
+ * Subtracts specified time units from the given date.
+ *
+ * @param date - The original date.
+ * @param opt - The time units to subtract.
+ * @returns A new Date object with the specified time units subtracted.
+ * @example
+ * const date = new Date('2024-03-31T12:00:00Z');
+ * const newDate = sub(date, { years: 1, months: 1 });
+ * console.log(newDate.toISOString()); // '2023-02-28T12:00:00.000Z'
+ */
+export declare function sub(date: Date, opt: SubOptions): Date;
+export {};
+//# sourceMappingURL=sub.d.ts.map

package/script/lib/sub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub.d.ts","sourceRoot":"","sources":["../../src/lib/sub.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;GAUG;AAEH,wBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAarD"}

package/script/lib/sub.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sub = sub;
+const add_js_1 = require("./add.js");
+/**
+ * Subtracts specified time units from the given date.
+ *
+ * @param date - The original date.
+ * @param opt - The time units to subtract.
+ * @returns A new Date object with the specified time units subtracted.
+ * @example
+ * const date = new Date('2024-03-31T12:00:00Z');
+ * const newDate = sub(date, { years: 1, months: 1 });
+ * console.log(newDate.toISOString()); // '2023-02-28T12:00:00.000Z'
+ */
+function sub(date, opt) {
+    const out = {};
+    if (opt.years)
+        out.years = -opt.years;
+    if (opt.months)
+        out.months = -opt.months;
+    if (opt.weeks)
+        out.weeks = -opt.weeks;
+    if (opt.days)
+        out.days = -opt.days;
+    if (opt.hours)
+        out.hours = -opt.hours;
+    if (opt.minutes)
+        out.minutes = -opt.minutes;
+    if (opt.seconds)
+        out.seconds = -opt.seconds;
+    if (opt.milliseconds)
+        out.milliseconds = -opt.milliseconds;
+    return (0, add_js_1.add)(date, out);
+}

package/script/lib/weekdays.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns an array of weekday names for the specified locale and format.
+ *
+ * @param locale - The locale to use (default: 'en-US').
+ * @param format - The format of weekday names: 'long', 'short', or 'narrow' (default: 'long').
+ * @returns An array of 7 weekday names starting from Monday.
+ * @example
+ * console.log(weekdays('en-US', 'long')); // ['Monday', 'Tuesday', 'Wednesday', ...]
+ * console.log(weekdays('en-US', 'short')); // ['Mon', 'Tue', 'Wed', ...]
+ * console.log(weekdays('pt-BR', 'long')); // ['segunda-feira', 'terça-feira', ...]
+ */
+export declare function weekdays(locale?: string, format?: "long" | "short" | "narrow"): string[];
+//# sourceMappingURL=weekdays.d.ts.map

package/script/lib/weekdays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekdays.d.ts","sourceRoot":"","sources":["../../src/lib/weekdays.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,wBAAgB,QAAQ,CACtB,MAAM,SAAU,EAChB,MAAM,GAAE,MAAM,GAAG,OAAO,GAAG,QAAiB,GAC3C,MAAM,EAAE,CAiBV"}

package/script/lib/weekdays.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.weekdays = weekdays;
+const daysCache = new Map();
+/**
+ * Returns an array of weekday names for the specified locale and format.
+ *
+ * @param locale - The locale to use (default: 'en-US').
+ * @param format - The format of weekday names: 'long', 'short', or 'narrow' (default: 'long').
+ * @returns An array of 7 weekday names starting from Monday.
+ * @example
+ * console.log(weekdays('en-US', 'long')); // ['Monday', 'Tuesday', 'Wednesday', ...]
+ * console.log(weekdays('en-US', 'short')); // ['Mon', 'Tue', 'Wed', ...]
+ * console.log(weekdays('pt-BR', 'long')); // ['segunda-feira', 'terça-feira', ...]
+ */
+function weekdays(locale = "en-US", format = "long") {
+    const key = `${locale}|${format}`;
+    const cached = daysCache.get(key);
+    if (cached)
+        return cached;
+    const fmt = new Intl.DateTimeFormat(locale, {
+        weekday: format,
+        timeZone: "UTC",
+    });
+    const result = Array.from({ length: 7 }, (_, i) => fmt.format(new Date(Date.UTC(2024, 0, i + 1))));
+    daysCache.set(key, result);
+    return result;
+}

package/script/mod.d.ts

@@ -0,0 +1,12 @@
+export * from "./lib/add.js";
+export * from "./lib/sub.js";
+export * from "./lib/months.js";
+export * from "./lib/start-of.js";
+export * from "./lib/end-of.js";
+export * from "./lib/format.js";
+export * from "./lib/weekdays.js";
+export * from "./lib/is-after.js";
+export * from "./lib/is-before.js";
+export * from "./lib/difference.js";
+export * from "./types/unit.js";
+//# sourceMappingURL=mod.d.ts.map

package/script/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/script/mod.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/add.js"), exports);
+__exportStar(require("./lib/sub.js"), exports);
+__exportStar(require("./lib/months.js"), exports);
+__exportStar(require("./lib/start-of.js"), exports);
+__exportStar(require("./lib/end-of.js"), exports);
+__exportStar(require("./lib/format.js"), exports);
+__exportStar(require("./lib/weekdays.js"), exports);
+__exportStar(require("./lib/is-after.js"), exports);
+__exportStar(require("./lib/is-before.js"), exports);
+__exportStar(require("./lib/difference.js"), exports);
+__exportStar(require("./types/unit.js"), exports);

package/script/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/script/types/unit.d.ts

@@ -0,0 +1,3 @@
+export type Unit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
+export type PluralUnit = 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds';
+//# sourceMappingURL=unit.d.ts.map

package/script/types/unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit.d.ts","sourceRoot":"","sources":["../../src/types/unit.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACpF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC"}

package/script/types/unit.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });