@jalvin/runtime 2.0.1 → 2.0.3

package/dist/stdlib/regex.js

@@ -0,0 +1,80 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// stdlib/regex.ts — Regex — thin, ergonomic wrapper over JS RegExp
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JalvinRegex = exports.Regex = exports.RegexResult = void 0;
+class RegexResult {
+    value;
+    range;
+    groupValues;
+    constructor(value, range, groupValues) {
+        this.value = value;
+        this.range = range;
+        this.groupValues = groupValues;
+    }
+}
+exports.RegexResult = RegexResult;
+class Regex {
+    _re;
+    constructor(pattern, options = "") {
+        // Map Jalvin option names to JS flags
+        const flags = options
+            .replace("IGNORE_CASE", "i")
+            .replace("MULTILINE", "m")
+            .replace("DOT_MATCHES_ALL", "s")
+            .replace(/[^gimsuy]/g, "");
+        this._re = new RegExp(pattern, flags || undefined);
+    }
+    /** Returns true if the **entire** input matches this regex (anchored). */
+    matches(input) {
+        const anchored = new RegExp(`^(?:${this._re.source})$`, this._re.flags.replace("g", ""));
+        return anchored.test(input);
+    }
+    /** Returns true if any part of the input matches. */
+    containsMatchIn(input) {
+        const unanchored = new RegExp(this._re.source, this._re.flags.replace("g", ""));
+        return unanchored.test(input);
+    }
+    find(input, startIndex = 0) {
+        const re = new RegExp(this._re.source, "g" + this._re.flags.replace("g", ""));
+        re.lastIndex = startIndex;
+        const m = re.exec(input);
+        if (!m)
+            return null;
+        return new RegexResult(m[0], { start: m.index, endInclusive: m.index + m[0].length - 1 }, m.slice(1).map((g) => g ?? ""));
+    }
+    findAll(input, startIndex = 0) {
+        const re = new RegExp(this._re.source, "g" + this._re.flags.replace("g", ""));
+        re.lastIndex = startIndex;
+        const results = [];
+        let m;
+        while ((m = re.exec(input)) !== null) {
+            results.push(new RegexResult(m[0], { start: m.index, endInclusive: m.index + m[0].length - 1 }, m.slice(1).map((g) => g ?? "")));
+        }
+        return results;
+    }
+    replace(input, replacement) {
+        const re = new RegExp(this._re.source, "g" + this._re.flags.replace("g", ""));
+        if (typeof replacement === "string")
+            return input.replace(re, replacement);
+        return input.replace(re, (match, ...groups) => {
+            const index = groups[groups.length - 2];
+            const r = new RegexResult(match, { start: index, endInclusive: index + match.length - 1 }, groups.slice(0, -2).map(String));
+            return replacement(r);
+        });
+    }
+    replaceFirst(input, replacement) {
+        const re = new RegExp(this._re.source, this._re.flags.replace("g", ""));
+        return input.replace(re, replacement);
+    }
+    split(input, limit) {
+        const parts = input.split(this._re);
+        return limit !== undefined ? parts.slice(0, limit) : parts;
+    }
+    toPattern() { return this._re.source; }
+    toString() { return this._re.toString(); }
+}
+exports.Regex = Regex;
+exports.JalvinRegex = Regex;
+//# sourceMappingURL=regex.js.map

package/dist/stdlib/regex.js.map

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

package/dist/stdlib/result.d.ts

@@ -0,0 +1,29 @@
+export declare class Result<T> {
+    private readonly _value;
+    private readonly _error;
+    private readonly _ok;
+    private constructor();
+    static success<T>(value: T): Result<T>;
+    static failure<T>(error: unknown): Result<T>;
+    get isSuccess(): boolean;
+    get isFailure(): boolean;
+    getOrNull(): T | null;
+    getOrUndefined(): T | undefined;
+    getOrThrow(): T;
+    getOrDefault(default_: T): T;
+    getOrElse(fn: (e: unknown) => T): T;
+    exceptionOrNull(): unknown | null;
+    map<U>(fn: (value: T) => U): Result<U>;
+    /** Alias for `map` — always wraps the transform in a try/catch. */
+    mapCatching<U>(fn: (value: T) => U): Result<U>;
+    recover(fn: (e: unknown) => T): Result<T>;
+    onSuccess(fn: (value: T) => void): this;
+    onFailure(fn: (error: unknown) => void): this;
+    fold<R>(onSuccess: (value: T) => R, onFailure: (error: unknown) => R): R;
+    toString(): string;
+}
+/** Wraps a throwing synchronous call in a Result. */
+export declare function runCatching<T>(fn: () => T): Result<T>;
+/** Wraps a throwing async call in a Result. */
+export declare function runCatchingAsync<T>(fn: () => Promise<T>): Promise<Result<T>>;
+//# sourceMappingURL=result.d.ts.map

package/dist/stdlib/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/stdlib/result.ts"],"names":[],"mappings":"AAIA,qBAAa,MAAM,CAAC,CAAC;IAEjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO;IAMP,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAQ,MAAM,CAAC,CAAC,CAAC;IAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IAE5C,IAAI,SAAS,IAAI,OAAO,CAAqB;IAC7C,IAAI,SAAS,IAAI,OAAO,CAAsB;IAE9C,SAAS,IAAS,CAAC,GAAG,IAAI;IAC1B,cAAc,IAAI,CAAC,GAAG,SAAS;IAE/B,UAAU,IAAI,CAAC;IAKf,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC;IAI5B,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC;IAInC,eAAe,IAAI,OAAO,GAAG,IAAI;IAEjC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAMtC,mEAAmE;IACnE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAE9C,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAMzC,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAKvC,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAK7C,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC;IAIxE,QAAQ,IAAI,MAAM;CAKnB;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAGrD;AAED,+CAA+C;AAC/C,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAGlF"}

package/dist/stdlib/result.js

@@ -0,0 +1,96 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// stdlib/result.ts — Result<T> — wraps a success value or a failure exception
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Result = void 0;
+exports.runCatching = runCatching;
+exports.runCatchingAsync = runCatchingAsync;
+class Result {
+    _value;
+    _error;
+    _ok;
+    constructor(_value, _error, _ok) {
+        this._value = _value;
+        this._error = _error;
+        this._ok = _ok;
+    }
+    static success(value) { return new Result(value, undefined, true); }
+    static failure(error) { return new Result(undefined, error, false); }
+    get isSuccess() { return this._ok; }
+    get isFailure() { return !this._ok; }
+    getOrNull() { return this._ok ? this._value : null; }
+    getOrUndefined() { return this._ok ? this._value : undefined; }
+    getOrThrow() {
+        if (this._ok)
+            return this._value;
+        throw this._error;
+    }
+    getOrDefault(default_) {
+        return this._ok ? this._value : default_;
+    }
+    getOrElse(fn) {
+        return this._ok ? this._value : fn(this._error);
+    }
+    exceptionOrNull() { return this._ok ? null : this._error; }
+    map(fn) {
+        if (!this._ok)
+            return Result.failure(this._error);
+        try {
+            return Result.success(fn(this._value));
+        }
+        catch (e) {
+            return Result.failure(e);
+        }
+    }
+    /** Alias for `map` — always wraps the transform in a try/catch. */
+    mapCatching(fn) { return this.map(fn); }
+    recover(fn) {
+        if (this._ok)
+            return this;
+        try {
+            return Result.success(fn(this._error));
+        }
+        catch (e) {
+            return Result.failure(e);
+        }
+    }
+    onSuccess(fn) {
+        if (this._ok)
+            fn(this._value);
+        return this;
+    }
+    onFailure(fn) {
+        if (!this._ok)
+            fn(this._error);
+        return this;
+    }
+    fold(onSuccess, onFailure) {
+        return this._ok ? onSuccess(this._value) : onFailure(this._error);
+    }
+    toString() {
+        return this._ok
+            ? `Result.success(${this._value})`
+            : `Result.failure(${this._error})`;
+    }
+}
+exports.Result = Result;
+/** Wraps a throwing synchronous call in a Result. */
+function runCatching(fn) {
+    try {
+        return Result.success(fn());
+    }
+    catch (e) {
+        return Result.failure(e);
+    }
+}
+/** Wraps a throwing async call in a Result. */
+async function runCatchingAsync(fn) {
+    try {
+        return Result.success(await fn());
+    }
+    catch (e) {
+        return Result.failure(e);
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/stdlib/result.js.map

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

package/dist/stdlib/strings.d.ts

@@ -0,0 +1,35 @@
+export declare function isBlank(s: string): boolean;
+export declare function isNotBlank(s: string): boolean;
+export declare function isNullOrBlank(s: string | null | undefined): boolean;
+export declare function toIntOrNull(s: string): number | null;
+export declare function toDoubleOrNull(s: string): number | null;
+export declare function toBooleanOrNull(s: string): boolean | null;
+export declare function padStart(s: string, length: number, padChar?: string): string;
+export declare function padEnd(s: string, length: number, padChar?: string): string;
+export declare function repeat_(s: string, n: number): string;
+export declare function capitalize(s: string): string;
+export declare function decapitalize(s: string): string;
+export declare function substringBefore(s: string, delimiter: string): string;
+export declare function substringAfter(s: string, delimiter: string): string;
+export declare function substringBeforeLast(s: string, delimiter: string): string;
+export declare function substringAfterLast(s: string, delimiter: string): string;
+export declare function removePrefix(s: string, prefix: string): string;
+export declare function removeSuffix(s: string, suffix: string): string;
+export declare function lines(s: string): string[];
+export declare function lineSequence(s: string): string[];
+export declare function ifEmpty<T extends string | null | undefined>(value: T, default_: () => T): T;
+export declare function ifBlank<T extends string | null | undefined>(value: T, default_: () => T): T;
+export declare function trimIndent(s: string): string;
+export declare class StringBuilder {
+    private readonly _parts;
+    append(s: unknown): this;
+    appendLine(s?: unknown): this;
+    prepend(s: unknown): this;
+    clear(): this;
+    get length(): number;
+    isEmpty(): boolean;
+    isNotEmpty(): boolean;
+    toString(): string;
+}
+export declare function buildString(fn: (sb: StringBuilder) => void): string;
+//# sourceMappingURL=strings.d.ts.map

package/dist/stdlib/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/stdlib/strings.ts"],"names":[],"mappings":"AAQA,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEnE;AAMD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAIzD;AAMD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,SAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,SAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAMD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAMD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAMD,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzC;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhD;AAMD,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAE3F;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAE3F;AAMD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5C;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,MAAM,CAAC,CAAC,EAAE,OAAO,GAAO,IAAI;IAC5B,UAAU,CAAC,CAAC,GAAE,OAAY,GAAG,IAAI;IACjC,OAAO,CAAC,CAAC,EAAE,OAAO,GAAM,IAAI;IAC5B,KAAK,IAAmB,IAAI;IAE5B,IAAI,MAAM,IAAI,MAAM,CAAgE;IACpF,OAAO,IAAM,OAAO;IACpB,UAAU,IAAI,OAAO;IACrB,QAAQ,IAAK,MAAM;CACpB;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,CAInE"}

package/dist/stdlib/strings.js

@@ -0,0 +1,161 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// stdlib/strings.ts — String utilities and StringBuilder
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringBuilder = void 0;
+exports.isBlank = isBlank;
+exports.isNotBlank = isNotBlank;
+exports.isNullOrBlank = isNullOrBlank;
+exports.toIntOrNull = toIntOrNull;
+exports.toDoubleOrNull = toDoubleOrNull;
+exports.toBooleanOrNull = toBooleanOrNull;
+exports.padStart = padStart;
+exports.padEnd = padEnd;
+exports.repeat_ = repeat_;
+exports.capitalize = capitalize;
+exports.decapitalize = decapitalize;
+exports.substringBefore = substringBefore;
+exports.substringAfter = substringAfter;
+exports.substringBeforeLast = substringBeforeLast;
+exports.substringAfterLast = substringAfterLast;
+exports.removePrefix = removePrefix;
+exports.removeSuffix = removeSuffix;
+exports.lines = lines;
+exports.lineSequence = lineSequence;
+exports.ifEmpty = ifEmpty;
+exports.ifBlank = ifBlank;
+exports.trimIndent = trimIndent;
+exports.buildString = buildString;
+// ─────────────────────────────────────────────────────────────────────────────
+// String predicates
+// ─────────────────────────────────────────────────────────────────────────────
+function isBlank(s) {
+    return s.trim().length === 0;
+}
+function isNotBlank(s) {
+    return s.trim().length > 0;
+}
+function isNullOrBlank(s) {
+    return s == null || s.trim().length === 0;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Parsing with fallback
+// ─────────────────────────────────────────────────────────────────────────────
+function toIntOrNull(s) {
+    const n = parseInt(s, 10);
+    return isNaN(n) ? null : n;
+}
+function toDoubleOrNull(s) {
+    const n = parseFloat(s);
+    return isNaN(n) ? null : n;
+}
+function toBooleanOrNull(s) {
+    if (s.toLowerCase() === "true")
+        return true;
+    if (s.toLowerCase() === "false")
+        return false;
+    return null;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Padding and repetition
+// ─────────────────────────────────────────────────────────────────────────────
+function padStart(s, length, padChar = " ") {
+    return s.padStart(length, padChar);
+}
+function padEnd(s, length, padChar = " ") {
+    return s.padEnd(length, padChar);
+}
+function repeat_(s, n) {
+    return s.repeat(n);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Case and casing helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function capitalize(s) {
+    return s.length === 0 ? s : s[0].toUpperCase() + s.slice(1);
+}
+function decapitalize(s) {
+    return s.length === 0 ? s : s[0].toLowerCase() + s.slice(1);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Substring extraction
+// ─────────────────────────────────────────────────────────────────────────────
+function substringBefore(s, delimiter) {
+    const idx = s.indexOf(delimiter);
+    return idx === -1 ? s : s.slice(0, idx);
+}
+function substringAfter(s, delimiter) {
+    const idx = s.indexOf(delimiter);
+    return idx === -1 ? "" : s.slice(idx + delimiter.length);
+}
+function substringBeforeLast(s, delimiter) {
+    const idx = s.lastIndexOf(delimiter);
+    return idx === -1 ? s : s.slice(0, idx);
+}
+function substringAfterLast(s, delimiter) {
+    const idx = s.lastIndexOf(delimiter);
+    return idx === -1 ? "" : s.slice(idx + delimiter.length);
+}
+function removePrefix(s, prefix) {
+    return s.startsWith(prefix) ? s.slice(prefix.length) : s;
+}
+function removeSuffix(s, suffix) {
+    return s.endsWith(suffix) ? s.slice(0, s.length - suffix.length) : s;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Line splitting
+// ─────────────────────────────────────────────────────────────────────────────
+function lines(s) {
+    return s.split(/\r?\n/);
+}
+function lineSequence(s) {
+    return lines(s);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Default-if-empty helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function ifEmpty(value, default_) {
+    return (value == null || value.length === 0) ? default_() : value;
+}
+function ifBlank(value, default_) {
+    return (value == null || value.trim().length === 0) ? default_() : value;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Indent trimming — strips the common leading whitespace from all lines
+// ─────────────────────────────────────────────────────────────────────────────
+function trimIndent(s) {
+    const allLines = s.split("\n");
+    const nonEmpty = allLines.filter((l) => l.trim().length > 0);
+    const minIndent = nonEmpty.reduce((min, l) => {
+        const match = l.match(/^(\s*)/);
+        return Math.min(min, match?.[1]?.length ?? 0);
+    }, Infinity);
+    const indentToStrip = isFinite(minIndent) ? minIndent : 0;
+    return allLines
+        .map((l) => l.slice(indentToStrip))
+        .join("\n")
+        .replace(/^\n/, "")
+        .replace(/\n$/, "");
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// StringBuilder — mutable string builder for efficient concatenation
+// ─────────────────────────────────────────────────────────────────────────────
+class StringBuilder {
+    _parts = [];
+    append(s) { this._parts.push(String(s ?? "")); return this; }
+    appendLine(s = "") { this._parts.push(String(s), "\n"); return this; }
+    prepend(s) { this._parts.unshift(String(s ?? "")); return this; }
+    clear() { this._parts.length = 0; return this; }
+    get length() { return this._parts.reduce((sum, p) => sum + p.length, 0); }
+    isEmpty() { return this.length === 0; }
+    isNotEmpty() { return this.length > 0; }
+    toString() { return this._parts.join(""); }
+}
+exports.StringBuilder = StringBuilder;
+function buildString(fn) {
+    const sb = new StringBuilder();
+    fn(sb);
+    return sb.toString();
+}
+//# sourceMappingURL=strings.js.map

package/dist/stdlib/strings.js.map

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

package/dist/stdlib/timing.d.ts

@@ -0,0 +1,12 @@
+export interface TimedValue<T> {
+    value: T;
+    /** Elapsed time in milliseconds */
+    duration: number;
+}
+/** Measures how long a synchronous block takes in milliseconds. */
+export declare function measureTimeMillis(fn: () => void): number;
+/** Measures how long an async block takes in milliseconds. */
+export declare function measureTimeMillisAsync(fn: () => Promise<void>): Promise<number>;
+/** Runs a block and returns both its result and the elapsed time. */
+export declare function measureTimedValue<T>(fn: () => T): TimedValue<T>;
+//# sourceMappingURL=timing.d.ts.map

package/dist/stdlib/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/stdlib/timing.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAK,CAAC,CAAC;IACZ,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,CAIxD;AAED,8DAA8D;AAC9D,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrF;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAI/D"}

package/dist/stdlib/timing.js

@@ -0,0 +1,27 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// stdlib/timing.ts — Performance measurement utilities
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.measureTimeMillis = measureTimeMillis;
+exports.measureTimeMillisAsync = measureTimeMillisAsync;
+exports.measureTimedValue = measureTimedValue;
+/** Measures how long a synchronous block takes in milliseconds. */
+function measureTimeMillis(fn) {
+    const start = performance.now();
+    fn();
+    return Math.round(performance.now() - start);
+}
+/** Measures how long an async block takes in milliseconds. */
+async function measureTimeMillisAsync(fn) {
+    const start = performance.now();
+    await fn();
+    return Math.round(performance.now() - start);
+}
+/** Runs a block and returns both its result and the elapsed time. */
+function measureTimedValue(fn) {
+    const start = performance.now();
+    const value = fn();
+    return { value, duration: Math.round(performance.now() - start) };
+}
+//# sourceMappingURL=timing.js.map

package/dist/stdlib/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/stdlib/timing.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;;AAShF,8CAIC;AAGD,wDAIC;AAGD,8CAIC;AAnBD,mEAAmE;AACnE,SAAgB,iBAAiB,CAAC,EAAc;IAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,EAAE,EAAE,CAAC;IACL,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,8DAA8D;AACvD,KAAK,UAAU,sBAAsB,CAAC,EAAuB;IAClE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,MAAM,EAAE,EAAE,CAAC;IACX,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,qEAAqE;AACrE,SAAgB,iBAAiB,CAAI,EAAW;IAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,EAAE,EAAE,CAAC;IACnB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/stdlib/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `notNull(value)` — emitted for Jalvin's `!!` operator.
+ * Throws if value is null/undefined, otherwise returns the value.
+ */
+export declare function notNull<T>(value: T | null | undefined): T;
+export declare class NullPointerException extends Error {
+    constructor(message?: string);
+}
+/**
+ * `safeCast<T>(value, Type)` — emitted for Jalvin's `as?` operator.
+ * Returns the value if it's an instanceof Type, otherwise returns null.
+ */
+export declare function safeCast<T>(value: unknown, Type: new (...args: any[]) => T): T | null;
+export declare function checkNotNull<T>(value: T | null | undefined, message?: string): T;
+export declare function requireNotNull<T>(value: T | null | undefined, message?: string): T;
+export declare function requireCondition(condition: boolean, message?: string | (() => string)): void;
+export declare function check(condition: boolean, message?: string | (() => string)): void;
+export declare function error(message: string): never;
+export declare class IllegalArgumentException extends Error {
+    constructor(message: string);
+}
+export declare class IllegalStateException extends Error {
+    constructor(message: string);
+}
+export declare class UnsupportedOperationException extends Error {
+    constructor(message?: string);
+}
+export declare class IndexOutOfBoundsException extends Error {
+    constructor(message?: string);
+}
+export declare class NoSuchElementException extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/stdlib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/stdlib/types.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,CAKzD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,SAAmB;CAIvC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,OAAO,EAEd,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAC9B,CAAC,GAAG,IAAI,CAEV;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,SAA2B,GAAG,CAAC,CAElG;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,SAA4B,GAAG,CAAC,CAErG;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAwB,GAAG,IAAI,CAIlH;AAED,wBAAgB,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAkB,GAAG,IAAI,CAIjG;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAE5C;AAMD,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAC5B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAC5B;AAED,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,OAAO,SAA+B;CACnD;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,SAAwB;CAC5C;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,SAAoB;CACxC"}

package/dist/stdlib/types.js

@@ -0,0 +1,82 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// stdlib/types.ts — Null safety, preconditions, and exception classes
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoSuchElementException = exports.IndexOutOfBoundsException = exports.UnsupportedOperationException = exports.IllegalStateException = exports.IllegalArgumentException = exports.NullPointerException = void 0;
+exports.notNull = notNull;
+exports.safeCast = safeCast;
+exports.checkNotNull = checkNotNull;
+exports.requireNotNull = requireNotNull;
+exports.requireCondition = requireCondition;
+exports.check = check;
+exports.error = error;
+/**
+ * `notNull(value)` — emitted for Jalvin's `!!` operator.
+ * Throws if value is null/undefined, otherwise returns the value.
+ */
+function notNull(value) {
+    if (value === null || value === undefined) {
+        throw new NullPointerException("!! operator invoked on null or undefined value");
+    }
+    return value;
+}
+class NullPointerException extends Error {
+    constructor(message = "Value was null") {
+        super(message);
+        this.name = "NullPointerException";
+    }
+}
+exports.NullPointerException = NullPointerException;
+/**
+ * `safeCast<T>(value, Type)` — emitted for Jalvin's `as?` operator.
+ * Returns the value if it's an instanceof Type, otherwise returns null.
+ */
+function safeCast(value, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+Type) {
+    return value instanceof Type ? value : null;
+}
+function checkNotNull(value, message = "Value must not be null") {
+    return notNull(value) ?? (() => { throw new NullPointerException(message); })();
+}
+function requireNotNull(value, message = "Required value was null") {
+    return notNull(value);
+}
+function requireCondition(condition, message = "Requirement failed") {
+    if (!condition) {
+        throw new IllegalArgumentException(typeof message === "function" ? message() : message);
+    }
+}
+function check(condition, message = "Check failed") {
+    if (!condition) {
+        throw new IllegalStateException(typeof message === "function" ? message() : message);
+    }
+}
+function error(message) {
+    throw new IllegalStateException(message);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Standard exception hierarchy
+// ─────────────────────────────────────────────────────────────────────────────
+class IllegalArgumentException extends Error {
+    constructor(message) { super(message); this.name = "IllegalArgumentException"; }
+}
+exports.IllegalArgumentException = IllegalArgumentException;
+class IllegalStateException extends Error {
+    constructor(message) { super(message); this.name = "IllegalStateException"; }
+}
+exports.IllegalStateException = IllegalStateException;
+class UnsupportedOperationException extends Error {
+    constructor(message = "Operation is not supported") { super(message); this.name = "UnsupportedOperationException"; }
+}
+exports.UnsupportedOperationException = UnsupportedOperationException;
+class IndexOutOfBoundsException extends Error {
+    constructor(message = "Index out of bounds") { super(message); this.name = "IndexOutOfBoundsException"; }
+}
+exports.IndexOutOfBoundsException = IndexOutOfBoundsException;
+class NoSuchElementException extends Error {
+    constructor(message = "No such element") { super(message); this.name = "NoSuchElementException"; }
+}
+exports.NoSuchElementException = NoSuchElementException;
+//# sourceMappingURL=types.js.map

package/dist/stdlib/types.js.map

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