chronajs 0.0.1-0

package/esm/core/dtf.d.ts

@@ -0,0 +1,2 @@
+export declare function getDTF(locale: string, tz: string): Intl.DateTimeFormat;
+//# sourceMappingURL=dtf.d.ts.map

package/esm/core/dtf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtf.d.ts","sourceRoot":"","sources":["../../src/core/dtf.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,uBAiBhD"}

package/esm/core/dtf.js

@@ -0,0 +1,20 @@
+const dtfCache = new Map();
+export function getDTF(locale, tz) {
+    const key = `${locale}|${tz}`;
+    let dtf = dtfCache.get(key);
+    if (!dtf) {
+        dtf = new Intl.DateTimeFormat(locale, {
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hour12: false,
+            timeZone: tz,
+        });
+        dtfCache.set(key, dtf);
+    }
+    return dtf;
+}
+;

package/esm/lib/add.d.ts

@@ -0,0 +1,24 @@
+type AddOptions = {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+};
+/**
+ * Adds specified time units to the given date.
+ *
+ * @param date - The original date.
+ * @param opt - The time units to add.
+ * @returns A new Date object with the specified time units added.
+ * @example
+ * const date = new Date('2024-01-31T12:00:00Z');
+ * const newDate = add(date, { years: 1, months: 2, days: 3 });
+ * console.log(newDate.toISOString()); // '2025-04-03T12:00:00.000Z'
+ */
+export declare function add(date: Date, opt: AddOptions): Date;
+export {};
+//# sourceMappingURL=add.d.ts.map

package/esm/lib/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/lib/add.ts"],"names":[],"mappings":"AAAA,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,CA8CrD"}

package/esm/lib/add.js

@@ -0,0 +1,47 @@
+/**
+ * Adds specified time units to the given date.
+ *
+ * @param date - The original date.
+ * @param opt - The time units to add.
+ * @returns A new Date object with the specified time units added.
+ * @example
+ * const date = new Date('2024-01-31T12:00:00Z');
+ * const newDate = add(date, { years: 1, months: 2, days: 3 });
+ * console.log(newDate.toISOString()); // '2025-04-03T12:00:00.000Z'
+ */
+export function add(date, opt) {
+    let d = new Date(date.getTime());
+    // ===== calendar-based (UTC-safe) =====
+    if (opt.years || opt.months) {
+        const years = opt.years ?? 0;
+        const months = opt.months ?? 0;
+        const year = d.getUTCFullYear();
+        const month = d.getUTCMonth(); // 0-based
+        const day = d.getUTCDate();
+        // target year/month (allow overflow, normalize manually)
+        let targetMonth = month + months;
+        const targetYear = year + years + Math.floor(targetMonth / 12);
+        targetMonth = ((targetMonth % 12) + 12) % 12;
+        // last valid day of target month
+        const lastDayOfTargetMonth = new Date(Date.UTC(targetYear, targetMonth + 1, 0)).getUTCDate();
+        const safeDay = Math.min(day, lastDayOfTargetMonth);
+        d = new Date(Date.UTC(targetYear, targetMonth, safeDay, d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds(), d.getUTCMilliseconds()));
+    }
+    // ===== time-based =====
+    let delta = 0;
+    if (opt.milliseconds)
+        delta += opt.milliseconds;
+    if (opt.seconds)
+        delta += opt.seconds * 1_000;
+    if (opt.minutes)
+        delta += opt.minutes * 60_000;
+    if (opt.hours)
+        delta += opt.hours * 3_600_000;
+    if (opt.days)
+        delta += opt.days * 86_400_000;
+    if (opt.weeks)
+        delta += opt.weeks * 604_800_000;
+    if (delta)
+        d = new Date(d.getTime() + delta);
+    return d;
+}

package/esm/lib/end-of.d.ts

@@ -0,0 +1,2 @@
+export declare function endOf(date: Date, unit: 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second'): Date;
+//# sourceMappingURL=end-of.d.ts.map

package/esm/lib/end-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"end-of.d.ts","sourceRoot":"","sources":["../../src/lib/end-of.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAoCrG"}

package/esm/lib/end-of.js

@@ -0,0 +1,35 @@
+export function endOf(date, unit) {
+    const time = new Date(date.getTime());
+    switch (unit) {
+        case 'year': {
+            time.setUTCMonth(11, 31);
+            time.setUTCHours(23, 59, 59, 999);
+            break;
+        }
+        case 'month': {
+            const year = time.getUTCFullYear();
+            const month = time.getUTCMonth();
+            const lastDay = new Date(Date.UTC(year, month + 1, 0)).getUTCDate();
+            time.setUTCDate(lastDay);
+            time.setUTCHours(23, 59, 59, 999);
+            break;
+        }
+        case 'day': {
+            time.setUTCHours(23, 59, 59, 999);
+            break;
+        }
+        case 'hour': {
+            time.setUTCMinutes(59, 59, 999);
+            break;
+        }
+        case 'minute': {
+            time.setUTCSeconds(59, 999);
+            break;
+        }
+        case 'second': {
+            time.setUTCMilliseconds(999);
+            break;
+        }
+    }
+    return time;
+}

package/esm/lib/format.d.ts

@@ -0,0 +1,7 @@
+type FormatOptions = {
+    tz?: string;
+    locale?: string;
+};
+export declare function format(date: Date, fmt: string, options?: FormatOptions): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

package/esm/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAGA,KAAK,aAAa,GAAG;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAkLF,wBAAgB,MAAM,CACpB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAqBR"}

package/esm/lib/format.js

@@ -0,0 +1,170 @@
+import { getDTF } from "../core/dtf.js";
+import { months } from "./months.js";
+// Pre-compute pad functions to avoid repeated padStart calls
+const pad2 = (n) => n < 10 ? '0' + n : String(n);
+const tokenMap = {
+    YYYY: p => String(p.year),
+    YY: p => String(p.year).slice(-2),
+    M: p => String(p.month),
+    MM: p => pad2(p.month),
+    MMM: (p, l) => months(l, 'short')[p.month - 1],
+    MMMM: (p, l) => months(l, 'long')[p.month - 1],
+    D: p => String(p.day),
+    DD: p => pad2(p.day),
+    H: p => String(p.hour),
+    HH: p => pad2(p.hour),
+    m: p => String(p.minute),
+    mm: p => pad2(p.minute),
+    s: p => String(p.second),
+    ss: p => pad2(p.second),
+};
+const tokenRegex = /YYYY|MMMM|MMM|YY|MM|M|DD|D|HH|H|mm|m|ss|s/g;
+const formatCache = new Map();
+function compileFormat(fmt) {
+    const cached = formatCache.get(fmt);
+    if (cached)
+        return cached;
+    const hasLiterals = fmt.includes('[');
+    const parts = [];
+    if (!hasLiterals) {
+        // Fast path: no literals, just parse tokens
+        let lastIndex = 0;
+        tokenRegex.lastIndex = 0;
+        let match;
+        while ((match = tokenRegex.exec(fmt)) !== null) {
+            if (match.index > lastIndex) {
+                parts.push({ type: 'literal', value: fmt.slice(lastIndex, match.index) });
+            }
+            parts.push({ type: 'token', value: match[0] });
+            lastIndex = match.index + match[0].length;
+        }
+        if (lastIndex < fmt.length) {
+            parts.push({ type: 'literal', value: fmt.slice(lastIndex) });
+        }
+    }
+    else {
+        // Slow path: handle escaped literals
+        let i = 0;
+        let currentLiteral = '';
+        let inBracket = false;
+        while (i < fmt.length) {
+            if (fmt[i] === '[' && !inBracket) {
+                if (currentLiteral) {
+                    // Process current literal for tokens
+                    let lastIndex = 0;
+                    tokenRegex.lastIndex = 0;
+                    let match;
+                    while ((match = tokenRegex.exec(currentLiteral)) !== null) {
+                        if (match.index > lastIndex) {
+                            parts.push({ type: 'literal', value: currentLiteral.slice(lastIndex, match.index) });
+                        }
+                        parts.push({ type: 'token', value: match[0] });
+                        lastIndex = match.index + match[0].length;
+                    }
+                    if (lastIndex < currentLiteral.length) {
+                        parts.push({ type: 'literal', value: currentLiteral.slice(lastIndex) });
+                    }
+                    currentLiteral = '';
+                }
+                inBracket = true;
+                i++;
+            }
+            else if (fmt[i] === ']' && inBracket) {
+                // Escaped literal content - add as-is
+                if (currentLiteral) {
+                    parts.push({ type: 'literal', value: currentLiteral });
+                    currentLiteral = '';
+                }
+                inBracket = false;
+                i++;
+            }
+            else {
+                currentLiteral += fmt[i];
+                i++;
+            }
+        }
+        if (currentLiteral) {
+            let lastIndex = 0;
+            tokenRegex.lastIndex = 0;
+            let match;
+            while ((match = tokenRegex.exec(currentLiteral)) !== null) {
+                if (match.index > lastIndex) {
+                    parts.push({ type: 'literal', value: currentLiteral.slice(lastIndex, match.index) });
+                }
+                parts.push({ type: 'token', value: match[0] });
+                lastIndex = match.index + match[0].length;
+            }
+            if (lastIndex < currentLiteral.length) {
+                parts.push({ type: 'literal', value: currentLiteral.slice(lastIndex) });
+            }
+        }
+    }
+    const compiled = { hasLiterals, parts };
+    formatCache.set(fmt, compiled);
+    return compiled;
+}
+// Fast UTC date parts extraction
+function getUTCParts(date) {
+    return {
+        year: date.getUTCFullYear(),
+        month: date.getUTCMonth() + 1,
+        day: date.getUTCDate(),
+        hour: date.getUTCHours(),
+        minute: date.getUTCMinutes(),
+        second: date.getUTCSeconds(),
+    };
+}
+// Fallback for non-UTC timezones
+function getPartsWithTZ(date, locale, tz) {
+    const partsRaw = getDTF(locale, tz).formatToParts(date);
+    const p = {
+        year: 0,
+        month: 0,
+        day: 0,
+        hour: 0,
+        minute: 0,
+        second: 0,
+    };
+    for (const part of partsRaw) {
+        switch (part.type) {
+            case "year":
+                p.year = +part.value;
+                break;
+            case "month":
+                p.month = +part.value;
+                break;
+            case "day":
+                p.day = +part.value;
+                break;
+            case "hour":
+                p.hour = +part.value;
+                break;
+            case "minute":
+                p.minute = +part.value;
+                break;
+            case "second":
+                p.second = +part.value;
+                break;
+        }
+    }
+    return p;
+}
+export function format(date, fmt, options = {}) {
+    const locale = options.locale ?? "en-US";
+    const tz = options.tz ?? "UTC";
+    // Get compiled format (cached)
+    const compiled = compileFormat(fmt);
+    // Fast path for UTC
+    const p = tz === "UTC" ? getUTCParts(date) : getPartsWithTZ(date, locale, tz);
+    // Build result string from compiled parts
+    let result = '';
+    for (const part of compiled.parts) {
+        if (part.type === 'literal') {
+            result += part.value;
+        }
+        else {
+            result += tokenMap[part.value](p, locale);
+        }
+    }
+    return result;
+}

package/esm/lib/months.d.ts

@@ -0,0 +1,2 @@
+export declare function months(locale?: string, format?: "long" | "short" | "narrow"): string[];
+//# sourceMappingURL=months.d.ts.map

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

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

package/esm/lib/months.js

@@ -0,0 +1,14 @@
+const monthsCache = new Map();
+export 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/esm/lib/start-of.d.ts

@@ -0,0 +1,2 @@
+export declare function startOf(date: Date, unit: 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second'): Date;
+//# sourceMappingURL=start-of.d.ts.map

package/esm/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,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAiCvG"}

package/esm/lib/start-of.js

@@ -0,0 +1,32 @@
+export 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 '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/esm/lib/sub.d.ts

@@ -0,0 +1,23 @@
+type SubOptions = {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+};
+/**
+ *
+ * @param 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-01-31T12:00:00Z');
+ * const newDate = sub(date, { years: 1, months: 2, days: 3 });
+ * console.log(newDate.toISOString()); // '2023-11-28T12:00:00.000Z'
+ */
+export declare function sub(date: Date, opt: SubOptions): Date;
+export {};
+//# sourceMappingURL=sub.d.ts.map

package/esm/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;;;;;;;;;GASG;AAEH,wBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAarD"}

package/esm/lib/sub.js

@@ -0,0 +1,31 @@
+import { add } from "./add.js";
+/**
+ *
+ * @param 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-01-31T12:00:00Z');
+ * const newDate = sub(date, { years: 1, months: 2, days: 3 });
+ * console.log(newDate.toISOString()); // '2023-11-28T12:00:00.000Z'
+ */
+export 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 add(date, out);
+}

package/esm/lib/weekdays.d.ts

@@ -0,0 +1,2 @@
+export declare function weekdays(locale?: string, format?: "long" | "short" | "narrow"): string[];
+//# sourceMappingURL=weekdays.d.ts.map

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

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

package/esm/lib/weekdays.js

@@ -0,0 +1,14 @@
+const daysCache = new Map();
+export 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/esm/mod.d.ts

@@ -0,0 +1,8 @@
+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";
+//# sourceMappingURL=mod.d.ts.map

package/esm/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"}

package/esm/mod.js

@@ -0,0 +1,7 @@
+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";

package/esm/package.json

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "chronajs",
+  "version": "0.0.1-0",
+  "description": "A date utility library made with Deno",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/username/repo.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/username/repo/issues"
+  },
+  "main": "./script/mod.js",
+  "module": "./esm/mod.js",
+  "exports": {
+    ".": {
+      "import": "./esm/mod.js",
+      "require": "./script/mod.js"
+    }
+  },
+  "scripts": {},
+  "devDependencies": {
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@dev"
+}

package/script/core/dtf.d.ts

@@ -0,0 +1,2 @@
+export declare function getDTF(locale: string, tz: string): Intl.DateTimeFormat;
+//# sourceMappingURL=dtf.d.ts.map

package/script/core/dtf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtf.d.ts","sourceRoot":"","sources":["../../src/core/dtf.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,uBAiBhD"}

package/script/core/dtf.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDTF = getDTF;
+const dtfCache = new Map();
+function getDTF(locale, tz) {
+    const key = `${locale}|${tz}`;
+    let dtf = dtfCache.get(key);
+    if (!dtf) {
+        dtf = new Intl.DateTimeFormat(locale, {
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hour12: false,
+            timeZone: tz,
+        });
+        dtfCache.set(key, dtf);
+    }
+    return dtf;
+}
+;

package/script/lib/add.d.ts

@@ -0,0 +1,24 @@
+type AddOptions = {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+};
+/**
+ * Adds specified time units to the given date.
+ *
+ * @param date - The original date.
+ * @param opt - The time units to add.
+ * @returns A new Date object with the specified time units added.
+ * @example
+ * const date = new Date('2024-01-31T12:00:00Z');
+ * const newDate = add(date, { years: 1, months: 2, days: 3 });
+ * console.log(newDate.toISOString()); // '2025-04-03T12:00:00.000Z'
+ */
+export declare function add(date: Date, opt: AddOptions): Date;
+export {};
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/lib/add.ts"],"names":[],"mappings":"AAAA,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,CA8CrD"}

package/script/lib/add.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.add = add;
+/**
+ * Adds specified time units to the given date.
+ *
+ * @param date - The original date.
+ * @param opt - The time units to add.
+ * @returns A new Date object with the specified time units added.
+ * @example
+ * const date = new Date('2024-01-31T12:00:00Z');
+ * const newDate = add(date, { years: 1, months: 2, days: 3 });
+ * console.log(newDate.toISOString()); // '2025-04-03T12:00:00.000Z'
+ */
+function add(date, opt) {
+    let d = new Date(date.getTime());
+    // ===== calendar-based (UTC-safe) =====
+    if (opt.years || opt.months) {
+        const years = opt.years ?? 0;
+        const months = opt.months ?? 0;
+        const year = d.getUTCFullYear();
+        const month = d.getUTCMonth(); // 0-based
+        const day = d.getUTCDate();
+        // target year/month (allow overflow, normalize manually)
+        let targetMonth = month + months;
+        const targetYear = year + years + Math.floor(targetMonth / 12);
+        targetMonth = ((targetMonth % 12) + 12) % 12;
+        // last valid day of target month
+        const lastDayOfTargetMonth = new Date(Date.UTC(targetYear, targetMonth + 1, 0)).getUTCDate();
+        const safeDay = Math.min(day, lastDayOfTargetMonth);
+        d = new Date(Date.UTC(targetYear, targetMonth, safeDay, d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds(), d.getUTCMilliseconds()));
+    }
+    // ===== time-based =====
+    let delta = 0;
+    if (opt.milliseconds)
+        delta += opt.milliseconds;
+    if (opt.seconds)
+        delta += opt.seconds * 1_000;
+    if (opt.minutes)
+        delta += opt.minutes * 60_000;
+    if (opt.hours)
+        delta += opt.hours * 3_600_000;
+    if (opt.days)
+        delta += opt.days * 86_400_000;
+    if (opt.weeks)
+        delta += opt.weeks * 604_800_000;
+    if (delta)
+        d = new Date(d.getTime() + delta);
+    return d;
+}

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

@@ -0,0 +1,2 @@
+export declare function endOf(date: Date, unit: 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second'): Date;
+//# sourceMappingURL=end-of.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"end-of.d.ts","sourceRoot":"","sources":["../../src/lib/end-of.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAoCrG"}

package/script/lib/end-of.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endOf = endOf;
+function endOf(date, unit) {
+    const time = new Date(date.getTime());
+    switch (unit) {
+        case 'year': {
+            time.setUTCMonth(11, 31);
+            time.setUTCHours(23, 59, 59, 999);
+            break;
+        }
+        case 'month': {
+            const year = time.getUTCFullYear();
+            const month = time.getUTCMonth();
+            const lastDay = new Date(Date.UTC(year, month + 1, 0)).getUTCDate();
+            time.setUTCDate(lastDay);
+            time.setUTCHours(23, 59, 59, 999);
+            break;
+        }
+        case 'day': {
+            time.setUTCHours(23, 59, 59, 999);
+            break;
+        }
+        case 'hour': {
+            time.setUTCMinutes(59, 59, 999);
+            break;
+        }
+        case 'minute': {
+            time.setUTCSeconds(59, 999);
+            break;
+        }
+        case 'second': {
+            time.setUTCMilliseconds(999);
+            break;
+        }
+    }
+    return time;
+}

package/script/lib/format.d.ts

@@ -0,0 +1,7 @@
+type FormatOptions = {
+    tz?: string;
+    locale?: string;
+};
+export declare function format(date: Date, fmt: string, options?: FormatOptions): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAGA,KAAK,aAAa,GAAG;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAkLF,wBAAgB,MAAM,CACpB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAqBR"}

package/script/lib/format.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.format = format;
+const dtf_js_1 = require("../core/dtf.js");
+const months_js_1 = require("./months.js");
+// Pre-compute pad functions to avoid repeated padStart calls
+const pad2 = (n) => n < 10 ? '0' + n : String(n);
+const tokenMap = {
+    YYYY: p => String(p.year),
+    YY: p => String(p.year).slice(-2),
+    M: p => String(p.month),
+    MM: p => pad2(p.month),
+    MMM: (p, l) => (0, months_js_1.months)(l, 'short')[p.month - 1],
+    MMMM: (p, l) => (0, months_js_1.months)(l, 'long')[p.month - 1],
+    D: p => String(p.day),
+    DD: p => pad2(p.day),
+    H: p => String(p.hour),
+    HH: p => pad2(p.hour),
+    m: p => String(p.minute),
+    mm: p => pad2(p.minute),
+    s: p => String(p.second),
+    ss: p => pad2(p.second),
+};
+const tokenRegex = /YYYY|MMMM|MMM|YY|MM|M|DD|D|HH|H|mm|m|ss|s/g;
+const formatCache = new Map();
+function compileFormat(fmt) {
+    const cached = formatCache.get(fmt);
+    if (cached)
+        return cached;
+    const hasLiterals = fmt.includes('[');
+    const parts = [];
+    if (!hasLiterals) {
+        // Fast path: no literals, just parse tokens
+        let lastIndex = 0;
+        tokenRegex.lastIndex = 0;
+        let match;
+        while ((match = tokenRegex.exec(fmt)) !== null) {
+            if (match.index > lastIndex) {
+                parts.push({ type: 'literal', value: fmt.slice(lastIndex, match.index) });
+            }
+            parts.push({ type: 'token', value: match[0] });
+            lastIndex = match.index + match[0].length;
+        }
+        if (lastIndex < fmt.length) {
+            parts.push({ type: 'literal', value: fmt.slice(lastIndex) });
+        }
+    }
+    else {
+        // Slow path: handle escaped literals
+        let i = 0;
+        let currentLiteral = '';
+        let inBracket = false;
+        while (i < fmt.length) {
+            if (fmt[i] === '[' && !inBracket) {
+                if (currentLiteral) {
+                    // Process current literal for tokens
+                    let lastIndex = 0;
+                    tokenRegex.lastIndex = 0;
+                    let match;
+                    while ((match = tokenRegex.exec(currentLiteral)) !== null) {
+                        if (match.index > lastIndex) {
+                            parts.push({ type: 'literal', value: currentLiteral.slice(lastIndex, match.index) });
+                        }
+                        parts.push({ type: 'token', value: match[0] });
+                        lastIndex = match.index + match[0].length;
+                    }
+                    if (lastIndex < currentLiteral.length) {
+                        parts.push({ type: 'literal', value: currentLiteral.slice(lastIndex) });
+                    }
+                    currentLiteral = '';
+                }
+                inBracket = true;
+                i++;
+            }
+            else if (fmt[i] === ']' && inBracket) {
+                // Escaped literal content - add as-is
+                if (currentLiteral) {
+                    parts.push({ type: 'literal', value: currentLiteral });
+                    currentLiteral = '';
+                }
+                inBracket = false;
+                i++;
+            }
+            else {
+                currentLiteral += fmt[i];
+                i++;
+            }
+        }
+        if (currentLiteral) {
+            let lastIndex = 0;
+            tokenRegex.lastIndex = 0;
+            let match;
+            while ((match = tokenRegex.exec(currentLiteral)) !== null) {
+                if (match.index > lastIndex) {
+                    parts.push({ type: 'literal', value: currentLiteral.slice(lastIndex, match.index) });
+                }
+                parts.push({ type: 'token', value: match[0] });
+                lastIndex = match.index + match[0].length;
+            }
+            if (lastIndex < currentLiteral.length) {
+                parts.push({ type: 'literal', value: currentLiteral.slice(lastIndex) });
+            }
+        }
+    }
+    const compiled = { hasLiterals, parts };
+    formatCache.set(fmt, compiled);
+    return compiled;
+}
+// Fast UTC date parts extraction
+function getUTCParts(date) {
+    return {
+        year: date.getUTCFullYear(),
+        month: date.getUTCMonth() + 1,
+        day: date.getUTCDate(),
+        hour: date.getUTCHours(),
+        minute: date.getUTCMinutes(),
+        second: date.getUTCSeconds(),
+    };
+}
+// Fallback for non-UTC timezones
+function getPartsWithTZ(date, locale, tz) {
+    const partsRaw = (0, dtf_js_1.getDTF)(locale, tz).formatToParts(date);
+    const p = {
+        year: 0,
+        month: 0,
+        day: 0,
+        hour: 0,
+        minute: 0,
+        second: 0,
+    };
+    for (const part of partsRaw) {
+        switch (part.type) {
+            case "year":
+                p.year = +part.value;
+                break;
+            case "month":
+                p.month = +part.value;
+                break;
+            case "day":
+                p.day = +part.value;
+                break;
+            case "hour":
+                p.hour = +part.value;
+                break;
+            case "minute":
+                p.minute = +part.value;
+                break;
+            case "second":
+                p.second = +part.value;
+                break;
+        }
+    }
+    return p;
+}
+function format(date, fmt, options = {}) {
+    const locale = options.locale ?? "en-US";
+    const tz = options.tz ?? "UTC";
+    // Get compiled format (cached)
+    const compiled = compileFormat(fmt);
+    // Fast path for UTC
+    const p = tz === "UTC" ? getUTCParts(date) : getPartsWithTZ(date, locale, tz);
+    // Build result string from compiled parts
+    let result = '';
+    for (const part of compiled.parts) {
+        if (part.type === 'literal') {
+            result += part.value;
+        }
+        else {
+            result += tokenMap[part.value](p, locale);
+        }
+    }
+    return result;
+}

package/script/lib/months.d.ts

@@ -0,0 +1,2 @@
+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,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,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.months = months;
+const monthsCache = new Map();
+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,2 @@
+export declare function startOf(date: Date, unit: 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second'): 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,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAiCvG"}

package/script/lib/start-of.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startOf = startOf;
+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 '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,23 @@
+type SubOptions = {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+};
+/**
+ *
+ * @param 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-01-31T12:00:00Z');
+ * const newDate = sub(date, { years: 1, months: 2, days: 3 });
+ * console.log(newDate.toISOString()); // '2023-11-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;;;;;;;;;GASG;AAEH,wBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAarD"}

package/script/lib/sub.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sub = sub;
+const add_js_1 = require("./add.js");
+/**
+ *
+ * @param 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-01-31T12:00:00Z');
+ * const newDate = sub(date, { years: 1, months: 2, days: 3 });
+ * console.log(newDate.toISOString()); // '2023-11-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,2 @@
+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,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,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.weekdays = weekdays;
+const daysCache = new Map();
+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,8 @@
+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";
+//# 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"}

package/script/mod.js

@@ -0,0 +1,23 @@
+"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);

package/script/package.json

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