@c9up/chronos 0.1.3 → 0.1.5

package/dist/native.js

@@ -0,0 +1,77 @@
+/**
+ * Universal engine loader — auto-detects Node (NAPI) vs Browser (WASM).
+ *
+ * **No fallback.** If neither NAPI nor WASM loads, `nativeChronos()` throws
+ * immediately. Chronos operations (timezone, DST, RFC 5545) are too complex
+ * for a pure-TS fallback.
+ */
+let native;
+let loadError;
+const isNode = typeof globalThis.process !== "undefined" &&
+    typeof globalThis.process.versions?.node === "string";
+if (isNode) {
+    try {
+        const { createRequire } = await import("node:module");
+        const { dirname, join } = await import("node:path");
+        const { fileURLToPath } = await import("node:url");
+        const { arch, platform } = await import("node:process");
+        const nodeRequire = createRequire(import.meta.url);
+        const currentDir = dirname(fileURLToPath(import.meta.url));
+        const platformMap = {
+            "linux-x64": "linux-x64-gnu",
+            "linux-arm64": "linux-arm64-gnu",
+            "darwin-x64": "darwin-x64",
+            "darwin-arm64": "darwin-arm64",
+            "win32-x64": "win32-x64-msvc",
+        };
+        const suffix = platformMap[`${platform}-${arch}`];
+        if (suffix) {
+            native = nodeRequire(join(currentDir, `../index.${suffix}.node`));
+        }
+    }
+    catch (e) {
+        loadError = e;
+    }
+}
+else {
+    try {
+        // wasm-bindgen preserves Rust snake_case names (start_of, end_of, etc.)
+        // while NAPI-RS auto-converts to camelCase. We adapt the WASM module
+        // shape (which uses bigint for large integers) to the NativeChronos
+        // interface (number-based), so consumers don't deal with the difference.
+        const wasm = await import("../wasm/chronos_engine_wasm.js");
+        await wasm.default();
+        native = {
+            add: (iso, amount, unit) => wasm.add(iso, BigInt(amount), unit),
+            diff: (a, b, unit) => Number(wasm.diff(a, b, unit)),
+            startOf: (iso, unit) => wasm.start_of(iso, unit),
+            endOf: (iso, unit) => wasm.end_of(iso, unit),
+            format: (iso, pattern) => wasm.format(iso, pattern),
+            validateTimezone: (zone) => wasm.validate_timezone(zone),
+            toZone: (iso, zone) => wasm.to_zone(iso, zone),
+            addInZone: (iso, amount, unit, zone) => wasm.add_in_zone(iso, BigInt(amount), unit, zone),
+            diffInZone: (a, b, unit, zone) => Number(wasm.diff_in_zone(a, b, unit, zone)),
+            zoneOffset: (iso, zone) => wasm.zone_offset(iso, zone),
+            fromLocal: (naive, zone) => wasm.from_local(naive, zone),
+            parseRfc2822: (input) => wasm.parse_rfc2822(input),
+            parseSql: (input) => wasm.parse_sql(input),
+            parseHttp: (input) => wasm.parse_http(input),
+            rruleExpand: (start, rrule, limit) => wasm.rrule_expand(start, rrule, limit),
+            calendarParts: (iso) => wasm.calendar_parts(iso),
+        };
+    }
+    catch (e) {
+        loadError = e;
+    }
+}
+export function nativeChronos() {
+    if (!native) {
+        throw new Error(`[CHRONOS_ENGINE_REQUIRED] The Chronos engine is required but not loaded.\n` +
+            `  Environment: ${isNode ? "Node" : "Browser"}\n` +
+            `  Reason: ${loadError ?? "binary not found"}\n` +
+            `  Fix (Node): cd packages/chronos && pnpm build:napi\n` +
+            `  Fix (Browser): cd packages/chronos && pnpm build:wasm`);
+    }
+    return native;
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

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

package/dist/rrule.d.ts

@@ -0,0 +1,21 @@
+export type RRuleWeekday = "MO" | "TU" | "WE" | "TH" | "FR" | "SA" | "SU";
+export type RRuleByDayToken = RRuleWeekday | `${number}${RRuleWeekday}`;
+export interface RRuleBuild {
+    freq: "SECONDLY" | "MINUTELY" | "HOURLY" | "DAILY" | "WEEKLY" | "MONTHLY" | "YEARLY";
+    interval?: number;
+    wkst?: RRuleWeekday;
+    byDay?: RRuleByDayToken[];
+    byMonthDay?: number[];
+    byMonth?: number[];
+    byWeekNo?: number[];
+    byYearDay?: number[];
+    bySetPos?: number[];
+    byHour?: number[];
+    byMinute?: number[];
+    bySecond?: number[];
+    count?: number;
+    until?: string;
+}
+export declare function toRRuleString(rule: RRuleBuild): string;
+export declare function expandRRule(startIso: string, rrule: string | RRuleBuild, limit?: number): string[];
+//# sourceMappingURL=rrule.d.ts.map

package/dist/rrule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrule.d.ts","sourceRoot":"","sources":["../src/rrule.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,GAAG,MAAM,GAAG,YAAY,EAAE,CAAC;AAExE,MAAM,WAAW,UAAU;IAC1B,IAAI,EACD,UAAU,GACV,UAAU,GACV,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA6BtD;AAgBD,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,KAAK,SAAM,GACT,MAAM,EAAE,CAcV"}

package/dist/rrule.js

@@ -0,0 +1,58 @@
+import { nativeChronos } from "./native.js";
+function pushNumericList(parts, key, values) {
+    if (!values || values.length === 0)
+        return;
+    parts.push(`${key}=${values.join(",")}`);
+}
+export function toRRuleString(rule) {
+    const parts = [`FREQ=${rule.freq}`];
+    if (rule.interval && rule.interval !== 1)
+        parts.push(`INTERVAL=${rule.interval}`);
+    if (rule.wkst)
+        parts.push(`WKST=${rule.wkst}`);
+    if (rule.byDay?.length)
+        parts.push(`BYDAY=${rule.byDay.join(",")}`);
+    pushNumericList(parts, "BYMONTHDAY", rule.byMonthDay);
+    pushNumericList(parts, "BYMONTH", rule.byMonth);
+    pushNumericList(parts, "BYWEEKNO", rule.byWeekNo);
+    pushNumericList(parts, "BYYEARDAY", rule.byYearDay);
+    pushNumericList(parts, "BYSETPOS", rule.bySetPos);
+    pushNumericList(parts, "BYHOUR", rule.byHour);
+    pushNumericList(parts, "BYMINUTE", rule.byMinute);
+    pushNumericList(parts, "BYSECOND", rule.bySecond);
+    if (rule.count !== undefined)
+        parts.push(`COUNT=${rule.count}`);
+    if (rule.until) {
+        // RFC 5545 §3.3.10 UNTIL format: YYYYMMDDTHHMMSSZ (no hyphens/colons/ms).
+        parts.push(`UNTIL=${new Date(rule.until)
+            .toISOString()
+            .replace(/[-:]/g, "")
+            .replace(/\.\d+Z$/, "Z")}`);
+    }
+    return parts.join(";");
+}
+/**
+ * Expand an RRULE into concrete occurrence dates. **NAPI-only** — the Rust
+ * engine handles the full RFC 5545 spec (BYDAY, BYSETPOS, BYMONTHDAY,
+ * BYWEEKNO, BYYEARDAY, UNTIL, COUNT, INTERVAL, WKST). No TS fallback.
+ */
+/**
+ * Hard cap on `expandRRule(... , limit)` so a caller passing an absurd
+ * number (or one derived from user input) can't ask the Rust engine to
+ * allocate gigabytes / run for seconds. 10_000 covers any realistic
+ * pagination + cushion (a year of every-minute occurrences = ~525k, so
+ * apps wanting that should iterate or stream, not call once).
+ */
+const MAX_RRULE_EXPAND = 10_000;
+export function expandRRule(startIso, rrule, limit = 100) {
+    if (!Number.isInteger(limit) || limit < 1) {
+        throw new RangeError(`expandRRule(limit) must be a positive integer (got ${String(limit)})`);
+    }
+    if (limit > MAX_RRULE_EXPAND) {
+        throw new RangeError(`expandRRule(limit=${limit}) exceeds the safety cap of ${MAX_RRULE_EXPAND}. ` +
+            "Page through the result set instead of asking for everything at once.");
+    }
+    const built = typeof rrule === "string" ? rrule : toRRuleString(rrule);
+    return nativeChronos().rruleExpand(startIso, built, limit);
+}
+//# sourceMappingURL=rrule.js.map

package/dist/rrule.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared helpers for DateTime and RRule modules.
+ */
+/**
+ * Normalize an ISO 8601 string: strip the `.000` when subseconds are zero
+ * for compact output that matches `new Date(iso).toISOString().replace('.000Z', 'Z')`.
+ * When subseconds are non-zero, preserve them so precision isn't silently lost.
+ */
+export declare function normalizeIso(iso: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/utils.js

@@ -0,0 +1,12 @@
+/**
+ * Shared helpers for DateTime and RRule modules.
+ */
+/**
+ * Normalize an ISO 8601 string: strip the `.000` when subseconds are zero
+ * for compact output that matches `new Date(iso).toISOString().replace('.000Z', 'Z')`.
+ * When subseconds are non-zero, preserve them so precision isn't silently lost.
+ */
+export function normalizeIso(iso) {
+    return iso.replace(".000Z", "Z");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACvC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/chronos",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Chronos — advanced date/time and recurrence engine (TypeScript + Rust N-API)",
   "license": "MIT",
   "type": "module",

package/src/Duration.ts

@@ -84,14 +84,18 @@ export class Duration {
 	 * that cannot be mixed with other designators per the spec.
 	 */
 	static fromISO(iso: string): Duration {
-		const s = iso.trim();
+		const trimmed = iso.trim();
+		// A leading '-' marks a negative duration (the extension toISO emits).
+		const negative = trimmed.startsWith("-P");
+		const s = negative ? trimmed.slice(1) : trimmed;
 		if (!s.startsWith("P"))
 			throw new Error(`Invalid ISO 8601 duration: ${iso}`);
+		const apply = (d: Duration): Duration => (negative ? d.negate() : d);
 
 		// Week form: P3W
 		const weekMatch = /^P(\d+(?:\.\d+)?)W$/.exec(s);
 		if (weekMatch) {
-			return new Duration({ weeks: Number.parseFloat(weekMatch[1]) });
+			return apply(new Duration({ weeks: Number.parseFloat(weekMatch[1]) }));
 		}
 
 		const match =
@@ -101,19 +105,26 @@ export class Duration {
 		if (!match) throw new Error(`Invalid ISO 8601 duration: ${iso}`);
 
 		const [, y, mo, d, h, mi, sec] = match;
+		// The all-optional regex also matches bare "P"/"PT" — a duration needs at
+		// least one component. An explicit zero ("PT0S", "P0D") still parses.
+		if (!y && !mo && !d && !h && !mi && !sec) {
+			throw new Error(`Invalid ISO 8601 duration: ${iso}`);
+		}
 		const seconds = sec ? Math.floor(Number.parseFloat(sec)) : 0;
 		const milliseconds = sec
 			? Math.round((Number.parseFloat(sec) - seconds) * 1000)
 			: 0;
-		return new Duration({
-			years: y ? Number(y) : 0,
-			months: mo ? Number(mo) : 0,
-			days: d ? Number(d) : 0,
-			hours: h ? Number(h) : 0,
-			minutes: mi ? Number(mi) : 0,
-			seconds,
-			milliseconds,
-		});
+		return apply(
+			new Duration({
+				years: y ? Number(y) : 0,
+				months: mo ? Number(mo) : 0,
+				days: d ? Number(d) : 0,
+				hours: h ? Number(h) : 0,
+				minutes: mi ? Number(mi) : 0,
+				seconds,
+				milliseconds,
+			}),
+		);
 	}
 
 	// ─── Accessors ──────────────────────────────────────────
@@ -297,42 +308,102 @@ export class Duration {
 
 	// ─── Formatting ─────────────────────────────────────────
 
-	/** ISO 8601 duration string (`P1Y2M3DT4H5M6S`). */
+	/**
+	 * ISO 8601 duration string (`P1Y2M3DT4H5M6S`). Always round-trips through
+	 * {@link fromISO}.
+	 *
+	 * Two spec constraints are honoured: the week form (`PnW`) cannot mix with
+	 * other designators — so weeks are emitted alone as `PnW`, otherwise folded
+	 * into days; and durations are non-negative — a uniformly-negative duration
+	 * (e.g. from {@link negate}) is emitted with a single leading `-` over
+	 * absolute components, which `fromISO` parses back.
+	 */
 	toISO(): string {
 		const v = this.#values;
+		const units = ORDERED_UNITS.map((u) => v[u]);
+		const negative = units.some((n) => n < 0) && units.every((n) => n <= 0);
+		const sign = negative ? "-" : "";
+		const a = (n: number): number => (negative ? Math.abs(n) : n);
+
+		// Week form only when weeks is the sole unit; never combined with others.
+		const onlyWeeks =
+			v.weeks !== 0 &&
+			v.years === 0 &&
+			v.months === 0 &&
+			v.days === 0 &&
+			v.hours === 0 &&
+			v.minutes === 0 &&
+			v.seconds === 0 &&
+			v.milliseconds === 0;
+		if (onlyWeeks) return `${sign}P${a(v.weeks)}W`;
+
+		const days = v.days + v.weeks * 7;
 		let date = "";
-		if (v.years) date += `${v.years}Y`;
-		if (v.months) date += `${v.months}M`;
-		if (v.weeks) date += `${v.weeks}W`;
-		if (v.days) date += `${v.days}D`;
+		if (v.years) date += `${a(v.years)}Y`;
+		if (v.months) date += `${a(v.months)}M`;
+		if (days) date += `${a(days)}D`;
 		let time = "";
-		if (v.hours) time += `${v.hours}H`;
-		if (v.minutes) time += `${v.minutes}M`;
+		if (v.hours) time += `${a(v.hours)}H`;
+		if (v.minutes) time += `${a(v.minutes)}M`;
 		const totalSec = v.seconds + v.milliseconds / 1000;
-		if (totalSec) time += `${totalSec}S`;
+		if (totalSec) time += `${a(totalSec)}S`;
 		if (!date && !time) return "PT0S";
-		return `P${date}${time ? `T${time}` : ""}`;
+		return `${sign}P${date}${time ? `T${time}` : ""}`;
 	}
 
 	/**
 	 * Simple pattern format: `hh:mm:ss`, `HH:mm`, etc. Supported tokens:
 	 * `Y` (years), `M` (months), `d` (days), `h`/`hh` (hours), `m`/`mm`
 	 * (minutes), `s`/`ss` (seconds), `S`/`SSS` (milliseconds).
+	 *
+	 * Wrap literal text in square brackets so its letters aren't read as tokens:
+	 * `"h [hours], m [min]"` → `"2 hours, 30 min"`. A single left-to-right scan
+	 * (longest token first) means substituted values are never re-scanned and
+	 * literal/overlapping text is left intact.
 	 */
 	toFormat(pattern: string): string {
 		const v = this.normalize().#values;
-		return pattern
-			.replace(/hh/g, String(v.hours).padStart(2, "0"))
-			.replace(/mm/g, String(v.minutes).padStart(2, "0"))
-			.replace(/ss/g, String(v.seconds).padStart(2, "0"))
-			.replace(/SSS/g, String(v.milliseconds).padStart(3, "0"))
-			.replace(/h/g, String(v.hours))
-			.replace(/m/g, String(v.minutes))
-			.replace(/s/g, String(v.seconds))
-			.replace(/S/g, String(v.milliseconds))
-			.replace(/Y/g, String(v.years))
-			.replace(/M/g, String(v.months))
-			.replace(/d/g, String(v.days));
+		const tokens: Record<string, string> = {
+			SSS: String(v.milliseconds).padStart(3, "0"),
+			hh: String(v.hours).padStart(2, "0"),
+			mm: String(v.minutes).padStart(2, "0"),
+			ss: String(v.seconds).padStart(2, "0"),
+			S: String(v.milliseconds),
+			h: String(v.hours),
+			m: String(v.minutes),
+			s: String(v.seconds),
+			Y: String(v.years),
+			M: String(v.months),
+			d: String(v.days),
+		};
+		const order = ["SSS", "hh", "mm", "ss", "S", "h", "m", "s", "Y", "M", "d"];
+		let out = "";
+		let i = 0;
+		while (i < pattern.length) {
+			if (pattern[i] === "[") {
+				i++;
+				while (i < pattern.length && pattern[i] !== "]") {
+					out += pattern[i];
+					i++;
+				}
+				if (i < pattern.length) i++; // skip the closing ']'
+				continue;
+			}
+			let matched = false;
+			for (const key of order) {
+				if (pattern.startsWith(key, i)) {
+					out += tokens[key];
+					i += key.length;
+					matched = true;
+					break;
+				}
+			}
+			if (!matched) {
+				out += pattern[i];
+				i++;
+			}
+		}
+		return out;
 	}
 
 	/**