@gabrielbryk/jq-ts 1.4.0 → 1.5.0

package/dist/index.d.mts

@@ -377,10 +377,26 @@ declare const resolveLimits: (config?: LimitsConfig) => ResolvedLimits;
  */
 declare class LimitTracker {
   private readonly limits;
+  private readonly nowSeconds?;
   private steps;
   private depth;
   private outputs;
-  constructor(limits: ResolvedLimits);
+  /**
+   * @param limits - Resolved execution limits.
+   * @param nowSeconds - The wall-clock instant exposed to the `now` builtin, as
+   *   seconds since the Unix epoch (may be fractional). When `undefined`, the
+   *   `now` builtin throws rather than reading the host clock — jq-ts never
+   *   reads the real clock on its own, so date programs stay deterministic
+   *   unless the caller injects a clock via `options.now`.
+   */
+  constructor(limits: ResolvedLimits, nowSeconds?: number | undefined);
+  /**
+   * Returns the injected wall-clock instant (seconds since the Unix epoch) for
+   * the `now` builtin.
+   * @param span - The source span for error reporting.
+   * @throws {RuntimeError} If no clock was injected (`options.now` was unset).
+   */
+  now(span: Span): number;
   /**
    * Records a single execution step (AST node visit).
    * @param span - The source span for error reporting.
@@ -430,6 +446,13 @@ interface EvalOptions {
    * Keys are variable names without the '$' prefix.
    */
   vars?: Record<string, Value>;
+  /**
+   * The wall-clock instant the `now` builtin resolves to — a `Date` or seconds
+   * since the Unix epoch. When omitted, `now` throws (jq-ts never reads the
+   * host clock on its own). Pure date builtins (`gmtime`, `strftime`, `todate`,
+   * …) are unaffected.
+   */
+  now?: Date | number;
 }
 //#endregion
 //#region src/eval/dispatch.d.ts
@@ -446,6 +469,15 @@ interface EvalOptions$1 {
    * Keys are variable names without the '$' prefix.
    */
   vars?: Record<string, Value>;
+  /**
+   * The wall-clock instant the `now` builtin resolves to. Accepts a `Date` or
+   * a number of seconds since the Unix epoch (may be fractional). When omitted,
+   * `now` throws — jq-ts never reads the host clock on its own, so date
+   * programs stay deterministic unless a clock is explicitly injected. Pure
+   * date builtins that take an explicit epoch (`gmtime`, `strftime`, `todate`,
+   * …) work regardless of this option.
+   */
+  now?: Date | number;
 }
 /**
  * Runs a jq AST against an input value.

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/span.ts","../src/ast.ts","../src/parser.ts","../src/validate.ts","../src/limits.ts","../src/value.ts","../src/eval/types.ts","../src/eval/dispatch.ts","../src/errors.ts","../src/compat.ts","../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/span.ts","../src/ast.ts","../src/parser.ts","../src/validate.ts","../src/limits.ts","../src/value.ts","../src/eval/types.ts","../src/eval/dispatch.ts","../src/errors.ts","../src/compat.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -3346,6 +3346,540 @@ const mathBuiltins = [
 	}
 ];
 //#endregion
+//#region src/builtins/dates.ts
+/**
+* Date/time builtins matching the jq binary (jq 1.7+/1.8).
+*
+* jq represents time in two forms:
+*   - a number of seconds since the Unix epoch (possibly fractional), and
+*   - a "broken down time": an 8-element array
+*       [ year, month(0-11), mday, hour, minute, second,
+*         weekday(0-6, Sun=0), yearday(0-365) ].
+*     The second slot carries the fractional part of the input, and `year` is
+*     the full year (NOT year-1900). This mirrors `1425599507 | gmtime ==
+*     [2015,2,5,23,51,47,4,63]`.
+*
+* `now` is the only clock-dependent builtin; it reads the instant injected via
+* `options.now` and throws when none was supplied (jq-ts never reads the host
+* clock on its own). Every other builtin here is a pure function of its input.
+*
+* Known deviation: `strftime`'s `%s` specifier is computed as the UTC epoch of
+* the broken-down time, whereas glibc's `%s` uses the host timezone. jq-ts
+* favors determinism/portability here; every other specifier matches jq.
+*/
+const WEEKDAY_ABBR = [
+	"Sun",
+	"Mon",
+	"Tue",
+	"Wed",
+	"Thu",
+	"Fri",
+	"Sat"
+];
+const WEEKDAY_FULL = [
+	"Sunday",
+	"Monday",
+	"Tuesday",
+	"Wednesday",
+	"Thursday",
+	"Friday",
+	"Saturday"
+];
+const MONTH_ABBR = [
+	"Jan",
+	"Feb",
+	"Mar",
+	"Apr",
+	"May",
+	"Jun",
+	"Jul",
+	"Aug",
+	"Sep",
+	"Oct",
+	"Nov",
+	"Dec"
+];
+const MONTH_FULL = [
+	"January",
+	"February",
+	"March",
+	"April",
+	"May",
+	"June",
+	"July",
+	"August",
+	"September",
+	"October",
+	"November",
+	"December"
+];
+const MS_PER_DAY = 864e5;
+/**
+* `Date.UTC` / `new Date(y, …)` map years 0–99 to 1900–1999 (a legacy JS
+* quirk). jq uses the literal year, so these helpers correct it via
+* `setUTCFullYear` / `setFullYear`, which accept the true year.
+*/
+const utcMillis = (year, mon, mday, hour = 0, min = 0, sec = 0) => {
+	const ms = Date.UTC(year, mon, mday, hour, min, sec);
+	if (year >= 0 && year <= 99) {
+		const d = new Date(ms);
+		d.setUTCFullYear(year);
+		return d.getTime();
+	}
+	return ms;
+};
+const localMillis = (year, mon, mday, hour = 0, min = 0, sec = 0) => {
+	const d = new Date(year, mon, mday, hour, min, sec);
+	if (year >= 0 && year <= 99) d.setFullYear(year);
+	return d.getTime();
+};
+const pad = (value, width, fill = "0") => String(Math.trunc(value)).padStart(width, fill);
+const requireNumber = (input, fn, span) => {
+	if (typeof input !== "number") throw new RuntimeError(`${fn}() requires numeric inputs`, span);
+	return input;
+};
+const requireString = (input, fn, span) => {
+	if (typeof input !== "string") throw new RuntimeError(`${fn} requires a string, got ${describeType(input)}`, span);
+	return input;
+};
+/** Day-of-year (0-based), computed with date-only UTC math so DST can't skew it. */
+const yearDay = (year, mon, mday) => Math.round((utcMillis(year, mon, mday) - utcMillis(year, 0, 1)) / MS_PER_DAY);
+/** Converts epoch seconds into broken-down time fields (UTC or local). */
+const fieldsFromEpoch = (epochSeconds, utc) => {
+	const whole = Math.floor(epochSeconds);
+	const frac = epochSeconds - whole;
+	const d = /* @__PURE__ */ new Date(whole * 1e3);
+	const year = utc ? d.getUTCFullYear() : d.getFullYear();
+	const mon = utc ? d.getUTCMonth() : d.getMonth();
+	const mday = utc ? d.getUTCDate() : d.getDate();
+	const hour = utc ? d.getUTCHours() : d.getHours();
+	const min = utc ? d.getUTCMinutes() : d.getMinutes();
+	const sec = utc ? d.getUTCSeconds() : d.getSeconds();
+	const wday = utc ? d.getUTCDay() : d.getDay();
+	return {
+		year,
+		mon,
+		mday,
+		hour,
+		min,
+		sec: sec + frac,
+		wday,
+		yday: yearDay(year, mon, mday)
+	};
+};
+const fieldsToArray = (f) => [
+	f.year,
+	f.mon,
+	f.mday,
+	f.hour,
+	f.min,
+	f.sec,
+	f.wday,
+	f.yday
+];
+/**
+* Parses a jq broken-down time array into fields. Missing trailing slots
+* default to 0 (jq is lenient: `[1,2,3] | mktime` works); present-but-non-number
+* slots are an error. wday/yday are derived from the calendar date when absent.
+*/
+const fieldsFromArray = (input, fn, span) => {
+	if (!Array.isArray(input)) throw new RuntimeError(`${fn} requires array inputs`, span);
+	const at = (index) => {
+		if (index >= input.length) return 0;
+		const raw = input[index];
+		if (typeof raw !== "number") throw new RuntimeError(`${fn} requires an array of numbers`, span);
+		return raw;
+	};
+	const year = at(0);
+	const mon = at(1);
+	const mday = at(2);
+	return {
+		year,
+		mon,
+		mday,
+		hour: at(3),
+		min: at(4),
+		sec: at(5),
+		wday: input.length > 6 && typeof input[6] === "number" ? input[6] : new Date(utcMillis(year, mon, mday)).getUTCDay(),
+		yday: input.length > 7 && typeof input[7] === "number" ? input[7] : yearDay(year, mon, mday)
+	};
+};
+/** Converts broken-down time fields back into epoch seconds (mktime). */
+const epochFromFields = (f, utc) => {
+	const wholeSec = Math.floor(f.sec);
+	const frac = f.sec - wholeSec;
+	return (utc ? utcMillis(f.year, f.mon, f.mday, f.hour, f.min, wholeSec) : localMillis(f.year, f.mon, f.mday, f.hour, f.min, wholeSec)) / 1e3 + frac;
+};
+/** ISO-8601 week-numbering year and week (for %G / %V). */
+const isoWeek = (year, mon, mday) => {
+	const date = new Date(utcMillis(year, mon, mday));
+	const dayNum = (date.getUTCDay() + 6) % 7;
+	date.setUTCDate(date.getUTCDate() - dayNum + 3);
+	const isoYear = date.getUTCFullYear();
+	const firstThursday = new Date(utcMillis(isoYear, 0, 4));
+	const firstDayNum = (firstThursday.getUTCDay() + 6) % 7;
+	firstThursday.setUTCDate(firstThursday.getUTCDate() - firstDayNum + 3);
+	return {
+		year: isoYear,
+		week: 1 + Math.round((date.getTime() - firstThursday.getTime()) / (7 * MS_PER_DAY))
+	};
+};
+const localOffsetString = (f) => {
+	const offsetMin = -new Date(localMillis(f.year, f.mon, f.mday, f.hour, f.min, Math.floor(f.sec))).getTimezoneOffset();
+	const sign = offsetMin >= 0 ? "+" : "-";
+	const abs = Math.abs(offsetMin);
+	return `${sign}${pad(Math.floor(abs / 60), 2)}${pad(abs % 60, 2)}`;
+};
+/** Best-effort local timezone abbreviation via Intl, falling back to the offset. */
+const localTzAbbr = (f) => {
+	try {
+		const tz = new Intl.DateTimeFormat("en-US", { timeZoneName: "short" }).formatToParts(new Date(localMillis(f.year, f.mon, f.mday, f.hour, f.min, Math.floor(f.sec)))).find((p) => p.type === "timeZoneName")?.value;
+		if (tz) return tz;
+	} catch {}
+	return localOffsetString(f);
+};
+/** Formats broken-down time with a C `strftime`-style format. */
+const formatStrftime = (f, fmt, utc) => {
+	const hour12 = f.hour % 12 === 0 ? 12 : f.hour % 12;
+	let out = "";
+	for (let i = 0; i < fmt.length; i++) {
+		if (fmt[i] !== "%") {
+			out += fmt[i];
+			continue;
+		}
+		i++;
+		const spec = fmt[i];
+		switch (spec) {
+			case "Y":
+				out += String(f.year);
+				break;
+			case "C":
+				out += pad(Math.floor(f.year / 100), 2);
+				break;
+			case "y":
+				out += pad((f.year % 100 + 100) % 100, 2);
+				break;
+			case "m":
+				out += pad(f.mon + 1, 2);
+				break;
+			case "d":
+				out += pad(f.mday, 2);
+				break;
+			case "e":
+				out += pad(f.mday, 2, " ");
+				break;
+			case "H":
+				out += pad(f.hour, 2);
+				break;
+			case "k":
+				out += pad(f.hour, 2, " ");
+				break;
+			case "I":
+				out += pad(hour12, 2);
+				break;
+			case "l":
+				out += pad(hour12, 2, " ");
+				break;
+			case "M":
+				out += pad(f.min, 2);
+				break;
+			case "S":
+				out += pad(Math.floor(f.sec), 2);
+				break;
+			case "p":
+				out += f.hour < 12 ? "AM" : "PM";
+				break;
+			case "P":
+				out += f.hour < 12 ? "am" : "pm";
+				break;
+			case "j":
+				out += pad(f.yday + 1, 3);
+				break;
+			case "a":
+				out += WEEKDAY_ABBR[(f.wday % 7 + 7) % 7];
+				break;
+			case "A":
+				out += WEEKDAY_FULL[(f.wday % 7 + 7) % 7];
+				break;
+			case "b":
+			case "h":
+				out += MONTH_ABBR[(f.mon % 12 + 12) % 12];
+				break;
+			case "B":
+				out += MONTH_FULL[(f.mon % 12 + 12) % 12];
+				break;
+			case "u":
+				out += String(f.wday === 0 ? 7 : f.wday);
+				break;
+			case "w":
+				out += String(f.wday);
+				break;
+			case "V":
+				out += pad(isoWeek(f.year, f.mon, f.mday).week, 2);
+				break;
+			case "G":
+				out += String(isoWeek(f.year, f.mon, f.mday).year);
+				break;
+			case "Z":
+				out += utc ? "GMT" : localTzAbbr(f);
+				break;
+			case "z":
+				out += utc ? "+0000" : localOffsetString(f);
+				break;
+			case "s":
+				out += String(Math.floor(epochFromFields(f, true)));
+				break;
+			case "T":
+				out += `${pad(f.hour, 2)}:${pad(f.min, 2)}:${pad(Math.floor(f.sec), 2)}`;
+				break;
+			case "R":
+				out += `${pad(f.hour, 2)}:${pad(f.min, 2)}`;
+				break;
+			case "F":
+				out += `${String(f.year)}-${pad(f.mon + 1, 2)}-${pad(f.mday, 2)}`;
+				break;
+			case "D":
+				out += `${pad(f.mon + 1, 2)}/${pad(f.mday, 2)}/${pad((f.year % 100 + 100) % 100, 2)}`;
+				break;
+			case "n":
+				out += "\n";
+				break;
+			case "t":
+				out += "	";
+				break;
+			case "%":
+				out += "%";
+				break;
+			case void 0:
+				out += "%";
+				break;
+			default:
+				out += `%${spec}`;
+				break;
+		}
+	}
+	return out;
+};
+/** Parses a string into broken-down time fields using a C `strptime`-style format. */
+const parseStrptime = (input, fmt, span) => {
+	let s = 0;
+	let year = 1900;
+	let mon = 0;
+	let mday = 1;
+	let hour = 0;
+	let min = 0;
+	let sec = 0;
+	const fail = () => {
+		throw new RuntimeError(`date "${input}" does not match format "${fmt}"`, span);
+	};
+	const readInt = (maxLen) => {
+		const start = s;
+		if (input[s] === "+" || input[s] === "-") s++;
+		let digits = 0;
+		while (s < input.length && digits < maxLen && /[0-9]/.test(input[s])) {
+			s++;
+			digits++;
+		}
+		if (digits === 0) fail();
+		return parseInt(input.slice(start, s), 10);
+	};
+	const matchName = (names) => {
+		const lower = input.slice(s).toLowerCase();
+		let best = -1;
+		let bestLen = 0;
+		names.forEach((name, index) => {
+			const n = name.toLowerCase();
+			if (lower.startsWith(n) && n.length > bestLen) {
+				best = index;
+				bestLen = n.length;
+			}
+		});
+		if (best < 0) fail();
+		s += bestLen;
+		return best;
+	};
+	for (let i = 0; i < fmt.length; i++) {
+		if (fmt[i] !== "%") {
+			if (/\s/.test(fmt[i])) while (s < input.length && /\s/.test(input[s])) s++;
+			else {
+				if (input[s] !== fmt[i]) fail();
+				s++;
+			}
+			continue;
+		}
+		i++;
+		switch (fmt[i]) {
+			case "Y":
+				year = readInt(4);
+				break;
+			case "y": {
+				const yy = readInt(2);
+				year = yy < 69 ? 2e3 + yy : 1900 + yy;
+				break;
+			}
+			case "C":
+				year = readInt(2) * 100;
+				break;
+			case "m":
+				mon = readInt(2) - 1;
+				break;
+			case "d":
+			case "e":
+				while (s < input.length && input[s] === " ") s++;
+				mday = readInt(2);
+				break;
+			case "H":
+			case "k":
+			case "I":
+			case "l":
+				while (s < input.length && input[s] === " ") s++;
+				hour = readInt(2);
+				break;
+			case "M":
+				min = readInt(2);
+				break;
+			case "S":
+				sec = readInt(2);
+				break;
+			case "j":
+				readInt(3);
+				break;
+			case "b":
+			case "B":
+			case "h":
+				mon = matchName([...MONTH_ABBR, ...MONTH_FULL]) % 12;
+				break;
+			case "a":
+			case "A":
+				matchName([...WEEKDAY_ABBR, ...WEEKDAY_FULL]);
+				break;
+			case "p":
+			case "P": {
+				const ampm = input.slice(s, s + 2).toUpperCase();
+				if (ampm === "AM") {
+					if (hour === 12) hour = 0;
+					s += 2;
+				} else if (ampm === "PM") {
+					if (hour < 12) hour += 12;
+					s += 2;
+				} else fail();
+				break;
+			}
+			case "z":
+				if (input[s] === "Z") s++;
+				else {
+					if (input[s] === "+" || input[s] === "-") s++;
+					s += 2;
+					if (input[s] === ":") s++;
+					s += 2;
+				}
+				break;
+			case "Z":
+				while (s < input.length && /[A-Za-z]/.test(input[s])) s++;
+				break;
+			case "n":
+			case "t":
+				while (s < input.length && /\s/.test(input[s])) s++;
+				break;
+			case "%":
+				if (input[s] !== "%") fail();
+				s++;
+				break;
+			default: fail();
+		}
+	}
+	return fieldsFromEpoch(utcMillis(year, mon, mday, hour, min, sec) / 1e3, true);
+};
+/** Resolves strftime input that may be either an epoch number or a broken-down array. */
+const fieldsForFormat = (input, fn, span, utc) => typeof input === "number" ? fieldsFromEpoch(input, utc) : fieldsFromArray(input, fn, span);
+const readFormat = (value, fn, span) => {
+	if (typeof value !== "string") throw new RuntimeError(`${fn}/1 requires a string format`, span);
+	return value;
+};
+const ISO8601 = "%Y-%m-%dT%H:%M:%SZ";
+const dateBuiltins = [
+	{
+		name: "now",
+		arity: 0,
+		apply: function* (_input, _args, _env, tracker, _eval, span) {
+			yield emit$1(tracker.now(span), span, tracker);
+		}
+	},
+	{
+		name: "gmtime",
+		arity: 0,
+		apply: function* (input, _args, _env, tracker, _eval, span) {
+			yield emit$1(fieldsToArray(fieldsFromEpoch(requireNumber(input, "gmtime", span), true)), span, tracker);
+		}
+	},
+	{
+		name: "localtime",
+		arity: 0,
+		apply: function* (input, _args, _env, tracker, _eval, span) {
+			yield emit$1(fieldsToArray(fieldsFromEpoch(requireNumber(input, "localtime", span), false)), span, tracker);
+		}
+	},
+	{
+		name: "mktime",
+		arity: 0,
+		apply: function* (input, _args, _env, tracker, _eval, span) {
+			yield emit$1(epochFromFields(fieldsFromArray(input, "mktime", span), true), span, tracker);
+		}
+	},
+	{
+		name: "strftime",
+		arity: 1,
+		apply: function* (input, args, env, tracker, evaluate, span) {
+			const fields = fieldsForFormat(input, "strftime", span, true);
+			for (const fmt of evaluate(args[0], input, env, tracker)) yield emit$1(formatStrftime(fields, readFormat(fmt, "strftime", span), true), span, tracker);
+		}
+	},
+	{
+		name: "strflocaltime",
+		arity: 1,
+		apply: function* (input, args, env, tracker, evaluate, span) {
+			const fields = fieldsForFormat(input, "strflocaltime", span, false);
+			for (const fmt of evaluate(args[0], input, env, tracker)) yield emit$1(formatStrftime(fields, readFormat(fmt, "strflocaltime", span), false), span, tracker);
+		}
+	},
+	{
+		name: "strptime",
+		arity: 1,
+		apply: function* (input, args, env, tracker, evaluate, span) {
+			const str = requireString(input, "strptime", span);
+			for (const fmt of evaluate(args[0], input, env, tracker)) yield emit$1(fieldsToArray(parseStrptime(str, readFormat(fmt, "strptime", span), span)), span, tracker);
+		}
+	},
+	{
+		name: "todate",
+		arity: 0,
+		apply: function* (input, _args, _env, tracker, _eval, span) {
+			yield emit$1(formatStrftime(fieldsFromEpoch(requireNumber(input, "todate", span), true), ISO8601, true), span, tracker);
+		}
+	},
+	{
+		name: "todateiso8601",
+		arity: 0,
+		apply: function* (input, _args, _env, tracker, _eval, span) {
+			yield emit$1(formatStrftime(fieldsFromEpoch(requireNumber(input, "todateiso8601", span), true), ISO8601, true), span, tracker);
+		}
+	},
+	{
+		name: "fromdate",
+		arity: 0,
+		apply: function* (input, _args, _env, tracker, _eval, span) {
+			yield emit$1(epochFromFields(parseStrptime(requireString(input, "fromdate", span), ISO8601, span), true), span, tracker);
+		}
+	},
+	{
+		name: "fromdateiso8601",
+		arity: 0,
+		apply: function* (input, _args, _env, tracker, _eval, span) {
+			yield emit$1(epochFromFields(parseStrptime(requireString(input, "fromdateiso8601", span), ISO8601, span), true), span, tracker);
+		}
+	}
+];
+//#endregion
 //#region src/builtins/index.ts
 const registerAllBuiltins = () => {
 	registerBuiltins(stdBuiltins);
@@ -3355,6 +3889,7 @@ const registerAllBuiltins = () => {
 	registerBuiltins(pathBuiltins);
 	registerBuiltins(iteratorBuiltins);
 	registerBuiltins(mathBuiltins);
+	registerBuiltins(dateBuiltins);
 };
 //#endregion
 //#region src/builtins.ts
@@ -3511,8 +4046,27 @@ var LimitTracker = class {
 	steps = 0;
 	depth = 0;
 	outputs = 0;
-	constructor(limits) {
+	/**
+	* @param limits - Resolved execution limits.
+	* @param nowSeconds - The wall-clock instant exposed to the `now` builtin, as
+	*   seconds since the Unix epoch (may be fractional). When `undefined`, the
+	*   `now` builtin throws rather than reading the host clock — jq-ts never
+	*   reads the real clock on its own, so date programs stay deterministic
+	*   unless the caller injects a clock via `options.now`.
+	*/
+	constructor(limits, nowSeconds) {
 		this.limits = limits;
+		this.nowSeconds = nowSeconds;
+	}
+	/**
+	* Returns the injected wall-clock instant (seconds since the Unix epoch) for
+	* the `now` builtin.
+	* @param span - The source span for error reporting.
+	* @throws {RuntimeError} If no clock was injected (`options.now` was unset).
+	*/
+	now(span) {
+		if (this.nowSeconds === void 0) throw new RuntimeError("now/0 requires an injected clock; pass options.now (a Date or epoch seconds)", span);
+		return this.nowSeconds;
 	}
 	/**
 	* Records a single execution step (AST node visit).
@@ -4078,6 +4632,13 @@ const evalLabel = function* (node, input, env, tracker, evaluate) {
 //#endregion
 //#region src/eval/dispatch.ts
 /**
+* Normalizes the `now` option to seconds since the Unix epoch.
+*/
+const resolveNowSeconds = (now) => {
+	if (now === void 0) return void 0;
+	return now instanceof Date ? now.getTime() / 1e3 : now;
+};
+/**
 * Runs a jq AST against an input value.
 *
 * @param ast - The parsed AST.
@@ -4086,7 +4647,7 @@ const evalLabel = function* (node, input, env, tracker, evaluate) {
 * @returns An array of all values yielded by the filter.
 */
 const runAst = (ast, input, options = {}) => {
-	const tracker = new LimitTracker(resolveLimits(options.limits));
+	const tracker = new LimitTracker(resolveLimits(options.limits), resolveNowSeconds(options.now));
 	const env = [{
 		vars: new Map(Object.entries(options.vars ?? {})),
 		funcs: /* @__PURE__ */ new Map()
@@ -4372,7 +4933,6 @@ const classifyError = (err) => {
 	return "unsupported-syntax";
 };
 const isIntentionalExclusion = (message) => [
-	"now",
 	"input",
 	"inputs",
 	"env"