comptime.ts/lib/index.js

<div align="center"> <img src="https://raw.githubusercontent.com/feathers-studio/comptime.ts/master/docs/comptime.ts.svg" alt="Hyperactive"> </div>

import { asyncLocalStore } from "./async_store.js";
import { COMPTIME_ERRORS, ComptimeError } from "./errors.js";
export function getComptimeContext() {
    const local = asyncLocalStore.getStore();
    return typeof local === "object" ? local?.__comptime_context : undefined;
}
/**
 * Defer a function to be executed after comptime evaluation of all modules.
 *
 * ## Usage
 *
 * ```ts
 * comptime.defer(() => {
 * 	writeFileSync("foo.txt", "bar");
 * });
 * ```
 *
 * Please note that while all deferred functions are guaranteed to be executed after comptime evaluation,
 * they are not guaranteed to be executed in any specific order because modules are evaluated concurrently.
 */
function defer(fn) {
    const context = getComptimeContext();
    if (!context)
        throw new ComptimeError(COMPTIME_ERRORS.CT_ERR_NO_COMPTIME, "Invalid `comptime.defer()` call");
    context.deferQueue.push(() => asyncLocalStore.run({ __comptime_context: context }, fn));
}
/**
 * A function that returns the expression it was given.
 * This is useful to force comptime evaluation of an expression.
 *
 * Note that if the provided expression resolves to a Promise-like value,
 * it will be awaited and resolved to a value at comptime.
 *
 * ## Usage
 *
 * Import the `comptime` function from `comptime.ts` with the `type: "comptime"` option.
 *
 * ```ts
 * import { comptime } from "comptime.ts" with { type: "comptime" };
 * ```
 *
 * Use it to force comptime evaluation of an expression.
 *
 * ```ts
 * const x = comptime(1 + 2);
 * ```
 *
 * When the compiler is run, the expression will be evaluated at compile time.
 *
 * ```ts
 * const x = 3;
 * ```
 */
function comptime(expr) {
    const context = getComptimeContext();
    if (!context)
        throw new ComptimeError(COMPTIME_ERRORS.CT_ERR_NO_COMPTIME, "Invalid `comptime()` call");
    return expr;
}
const _comptime = Object.assign(comptime, { defer });
export { _comptime as comptime };
//# sourceMappingURL=index.js.map