hron-wasm 0.6.1 → 1.0.0

package/README.md

@@ -13,31 +13,50 @@ npm install hron-wasm
 ## Usage
 
 ```javascript
-import { Schedule, fromCron } from "hron-wasm";
+import { Schedule, fromCron, explainCron } from "hron-wasm";
 
 // Parse an expression
 const schedule = Schedule.parse("every weekday at 9:00 in America/New_York");
 
-// Next occurrence (ISO string, UTC)
-const next = schedule.next();
+// Next occurrence from a given datetime (ISO 8601 string)
+const now = new Date().toISOString();
+const next = schedule.nextFrom(now);
 
 // Next N occurrences
-const nextFive = schedule.nextN(5);
+const nextFive = schedule.nextNFrom(now, 5);
 
-// Convert to cron
+// Previous occurrence before a given datetime
+const prev = schedule.previousFrom(now);
+
+// Check if a datetime matches
+const isMatch = schedule.matches(now);
+
+// Lazy iteration: occurrences after `from`, limited to `limit` results
+const occ = schedule.occurrences(now, 10);
+
+// Bounded range: occurrences where from < t <= to
+const range = schedule.between("2026-01-01T00:00:00Z", "2026-12-31T23:59:59Z");
+
+// Convert to cron (if expressible)
 const cron = schedule.toCron();
 
 // Convert from cron
 const fromCronSchedule = fromCron("0 9 * * *");
 
-// Structured JSON
+// Explain a cron expression in human-readable form
+const explanation = explainCron("0 9 * * 1-5");
+
+// Structured JSON representation
 const json = schedule.toJSON();
 
-// Canonical string
+// Canonical string (roundtrip-safe)
 const str = schedule.toString();
 
-// Validate
+// Validate without parsing
 const valid = Schedule.validate("every day at 9:00");
+
+// Timezone getter
+const tz = schedule.timezone; // "America/New_York" or undefined
 ```
 
 ## License

package/hron_wasm.d.ts

@@ -60,6 +60,11 @@ export class Schedule {
     readonly timezone: string | undefined;
 }
 
+/**
+ * Explain a cron expression in human-readable form.
+ */
+export function explainCron(cron_expr: string): string;
+
 /**
  * Parse a cron expression and return an hron Schedule.
  */

package/hron_wasm_bg.js

@@ -210,6 +210,32 @@ export class Schedule {
 }
 if (Symbol.dispose) Schedule.prototype[Symbol.dispose] = Schedule.prototype.free;
 
+/**
+ * Explain a cron expression in human-readable form.
+ * @param {string} cron_expr
+ * @returns {string}
+ */
+export function explainCron(cron_expr) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(cron_expr, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.explainCron(ptr0, len0);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * Parse a cron expression and return an hron Schedule.
  * @param {string} cron_expr
@@ -224,50 +250,50 @@ export function fromCron(cron_expr) {
     }
     return Schedule.__wrap(ret[0]);
 }
-export function __wbg_Error_8c4e43fe74559d73(arg0, arg1) {
+export function __wbg_Error_25ba92dc73c79ff8(arg0, arg1) {
     const ret = Error(getStringFromWasm0(arg0, arg1));
     return ret;
 }
-export function __wbg_Number_04624de7d0e8332d(arg0) {
+export function __wbg_Number_70eda1af1f0de797(arg0) {
     const ret = Number(arg0);
     return ret;
 }
-export function __wbg_String_8f0eb39a4a4c2f66(arg0, arg1) {
+export function __wbg_String_8564e559799eccda(arg0, arg1) {
     const ret = String(arg1);
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len1 = WASM_VECTOR_LEN;
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_is_string_cd444516edc5b180(arg0) {
+export function __wbg___wbindgen_is_string_dfb64101caa98453(arg0) {
     const ret = typeof(arg0) === 'string';
     return ret;
 }
-export function __wbg___wbindgen_throw_be289d5034ed271b(arg0, arg1) {
+export function __wbg___wbindgen_throw_f1861aae416df39d(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
-export function __wbg_new_361308b2356cecd0() {
+export function __wbg_new_1b4edd8807f9a802() {
     const ret = new Object();
     return ret;
 }
-export function __wbg_new_3eb36ae241fe6f44() {
-    const ret = new Array();
+export function __wbg_new_8189744b546559b4() {
+    const ret = new Map();
     return ret;
 }
-export function __wbg_new_dca287b076112a51() {
-    const ret = new Map();
+export function __wbg_new_dcf435def74b2b31() {
+    const ret = new Array();
     return ret;
 }
-export function __wbg_set_1eb0999cf5d27fc8(arg0, arg1, arg2) {
+export function __wbg_set_411d76b94557fe0d(arg0, arg1, arg2) {
     const ret = arg0.set(arg1, arg2);
     return ret;
 }
-export function __wbg_set_3f1d0b984ed272ed(arg0, arg1, arg2) {
-    arg0[arg1] = arg2;
-}
-export function __wbg_set_f43e577aea94465b(arg0, arg1, arg2) {
+export function __wbg_set_58d19822a2826a42(arg0, arg1, arg2) {
     arg0[arg1 >>> 0] = arg2;
 }
+export function __wbg_set_6be42768c690e380(arg0, arg1, arg2) {
+    arg0[arg1] = arg2;
+}
 export function __wbindgen_cast_0000000000000001(arg0) {
     // Cast intrinsic for `F64 -> Externref`.
     const ret = arg0;

package/package.json

@@ -2,7 +2,7 @@
   "name": "hron-wasm",
   "type": "module",
   "description": "WASM bindings for hron — human-readable cron",
-  "version": "0.6.1",
+  "version": "1.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",