@velarscript/cli 0.10.1

package/dist/test-runner.js

@@ -0,0 +1,226 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { mkdir, readdir, writeFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { pathToFileURL } from "node:url";
+import { formatDiagnostic } from "@velarscript/compiler";
+import { compileProject } from "./project.js";
+import { standardModuleSource, standardModuleSources } from "./standard-modules.js";
+import { compiledTestModulePath, createCompiledSandbox, portablePath, quoteReportedText, removeCompiledSandbox, writeCompiledTestProject } from "./test-output.js";
+import { hostErrorStack } from "./host-error.js";
+import { captureUnownedErrors, flushOutput, mapCompiledStacksToSources } from "./unowned-errors.js";
+const defaultTestTimeoutMs = 120_000;
+const defaultTestSettleTimeoutMs = 10_000;
+function testLimits(options) {
+    const bounded = (value, fallback, name) => {
+        const resolved = value ?? fallback;
+        if (!Number.isSafeInteger(resolved) || resolved < 1 || resolved > 600_000) {
+            throw new RangeError(`${name} must be an integer from 1 through 600000`);
+        }
+        return resolved;
+    };
+    return {
+        testTimeoutMs: bounded(options.testTimeoutMs, defaultTestTimeoutMs, "Test timeout"),
+        settleTimeoutMs: bounded(options.settleTimeoutMs, defaultTestSettleTimeoutMs, "Test settle timeout"),
+        exitWhenStuck: options.exitWhenStuck !== false,
+    };
+}
+export async function runTests(config, explicitInput, options = {}) {
+    const limits = testLimits(options);
+    const files = explicitInput?.endsWith(".test.vel")
+        ? [config.entryPath]
+        : await discoverTestFiles(config.root, new Set([config.outDir, config.publicDir]));
+    if (files.length === 0) {
+        process.stderr.write("No .test.vel files were found\n");
+        return 1;
+    }
+    mapCompiledStacksToSources();
+    const temporary = await createCompiledSandbox(config.root, "test");
+    let passed = 0;
+    let failed = 0;
+    // The runner keeps running: an unowned failure belongs to the test, never to
+    // the process. The channel is shared with the browser runner so that the one
+    // stance has one implementation.
+    const channel = captureUnownedErrors();
+    const drainUnowned = () => channel.drain();
+    // Work a test started is work the test owns. Waiting for the process to run
+    // out of work before reading the verdict is what makes a late failure belong
+    // to the test that started it instead of whichever later test happens to be
+    // running when it lands — and what stops it from being dropped entirely.
+    // A fixed sleep cannot do this job: a failure one millisecond past the sleep
+    // is a failure nobody counts.
+    let stuck = false;
+    const settleWork = async (subject) => {
+        if (stuck)
+            return null;
+        if (await channel.settle(limits.settleTimeoutMs))
+            return null;
+        stuck = true;
+        return `work started ${subject} was still running ${limits.settleTimeoutMs} milliseconds later; a test owns the work it starts, and a failure from work that never finishes can never be reported`;
+    };
+    try {
+        await prepareStandardModules(temporary, config);
+        for (const file of files) {
+            const project = await compileProject(file, new Map(), {
+                sourceRoot: config.root,
+                projectRoot: config.root,
+                publicRoot: config.publicDir,
+                extensions: config.compilerExtensions,
+                extensionConfig: config.extensionConfig,
+                framework: config.framework,
+                exportTestFunctions: true,
+            });
+            const errors = [
+                ...project.failures.map((failure) => `${failure.path}: ${failure.message}`),
+                ...project.modules.flatMap((module) => module.result.diagnostics.map((diagnostic) => formatDiagnostic(module.result.source, diagnostic))),
+            ];
+            if (errors.length > 0) {
+                failed += 1;
+                process.stderr.write(`✗ ${portablePath(relative(config.root, file))}\n${errors.join("\n\n")}\n`);
+                continue;
+            }
+            await writeCompiledTestProject(project, temporary);
+            const entry = project.modules.find((module) => module.inputPath === file);
+            const tests = entry?.result.moduleInterface.tests ?? [];
+            if (tests.length === 0) {
+                failed += 1;
+                process.stderr.write(`✗ ${portablePath(relative(config.root, file))} declares no tests\n`);
+                continue;
+            }
+            const outputEntry = entry ? compiledTestModulePath(project, entry, temporary) : join(temporary, relative(config.root, file).replace(/\.vel$/u, ".js"));
+            let namespace;
+            try {
+                namespace = await import(__rewriteRelativeImportExtension(`${pathToFileURL(outputEntry).href}?run=${Date.now()}`));
+            }
+            catch (error) {
+                failed += tests.length;
+                process.stderr.write(`✗ ${portablePath(relative(config.root, file))} failed to load\n${stackOf(error)}\n`);
+                await drainUnowned();
+                continue;
+            }
+            // A module initialization error that surfaced on the host channel
+            // instead of the import's own await (BLD-D1's exact shape) fails the
+            // file's tests before any of them can run green.
+            const loadTimeErrors = await drainUnowned();
+            if (loadTimeErrors.length > 0) {
+                failed += tests.length;
+                process.stderr.write(`✗ ${portablePath(relative(config.root, file))} reported an unowned error while loading\n${loadTimeErrors.join("\n")}\n`);
+                continue;
+            }
+            for (const declared of tests) {
+                // D39 item 53 + D51 rule 105: the reporter quotes the author's name for
+                // the test, escaped, because a verdict line must say what it means on
+                // every terminal.
+                const name = quoteReportedText(declared.title);
+                const test = namespace[declared.name];
+                try {
+                    if (typeof test !== "function")
+                        throw new Error(`Test ${name} was not emitted`);
+                    if (test.length !== 0)
+                        throw new Error(`Test ${name} cannot declare parameters`);
+                    await boundedTest(test, limits.testTimeoutMs);
+                    const leftover = await settleWork("by this test");
+                    const testErrors = await drainUnowned();
+                    if (testErrors.length > 0) {
+                        throw new Error(`an unowned error was reported while this test ran\n${testErrors.join("\n")}`);
+                    }
+                    if (leftover !== null)
+                        throw new Error(leftover);
+                    passed += 1;
+                    process.stdout.write(`✓ ${quoteReportedText(portablePath(relative(config.root, file)))} :: ${name}\n`);
+                }
+                catch (error) {
+                    failed += 1;
+                    await drainUnowned();
+                    process.stderr.write(`✗ ${quoteReportedText(portablePath(relative(config.root, file)))} :: ${name}\n${stackOf(error)}\n`);
+                }
+            }
+        }
+        // Work a test left behind (a straggling timer, a task that outlived its
+        // test) still fails the run instead of crashing it after the guards come
+        // down.
+        const leftover = await settleWork("during this run");
+        const trailing = await drainUnowned();
+        if (trailing.length > 0) {
+            failed += 1;
+            process.stderr.write(`✗ an unowned error was reported after the last test\n${trailing.join("\n")}\n`);
+        }
+        if (leftover !== null) {
+            failed += 1;
+            process.stderr.write(`✗ ${leftover}\n`);
+        }
+    }
+    finally {
+        channel.release();
+        await removeCompiledSandbox(temporary);
+    }
+    process.stdout.write(`\n${passed} passed, ${failed} failed\n`);
+    const code = failed === 0 ? 0 : 1;
+    if (stuck && limits.exitWhenStuck) {
+        // The process cannot end on its own — work a test started still holds the
+        // event loop. The verdict is already written; ending the run beats hanging
+        // a gate forever on a failure that has already been reported.
+        await flushOutput(process.stdout);
+        await flushOutput(process.stderr);
+        process.exit(code);
+    }
+    return code;
+}
+/**
+ * A test that never settles is a failure that never reaches a human. The bound
+ * makes the hang a reported failure; the work itself keeps whatever handles it
+ * holds, which the run-level settle then reports in its own right.
+ */
+async function boundedTest(test, timeoutMs) {
+    let timer = null;
+    const deadline = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => reject(new Error(`this test did not finish within its ${timeoutMs} millisecond bound`)), timeoutMs);
+    });
+    void deadline.catch(() => { });
+    try {
+        await Promise.race([Promise.resolve().then(() => test()), deadline]);
+    }
+    finally {
+        if (timer !== null)
+            clearTimeout(timer);
+    }
+}
+async function discoverTestFiles(root, excluded) {
+    const output = [];
+    const visit = async (directory) => {
+        for (const entry of await readdir(directory, { withFileTypes: true })) {
+            const path = join(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === "node_modules" || entry.name === ".git" || entry.name === ".velar" || excluded.has(path))
+                    continue;
+                await visit(path);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".test.vel") && !entry.name.endsWith(".browser.test.vel")) {
+                output.push(path);
+            }
+        }
+    };
+    await visit(root);
+    return output.sort();
+}
+export async function prepareStandardModules(root, config) {
+    const packageRoot = join(root, "node_modules", "velar");
+    await mkdir(packageRoot, { recursive: true });
+    const exports = {};
+    for (const [source, code] of standardModuleSources(config.compilerExtensions)) {
+        const name = source.slice("velar/".length);
+        exports[`./${name}`] = `./${name}.js`;
+        await writeFile(join(packageRoot, `${name}.js`), standardModuleSource(source, config.extensionConfig, config.compilerExtensions) ?? code, "utf8");
+    }
+    await writeFile(join(packageRoot, "package.json"), JSON.stringify({ name: "velar", private: true, type: "module", exports }), "utf8");
+}
+function stackOf(error) {
+    return hostErrorStack(error);
+}
+//# sourceMappingURL=test-runner.js.map

package/dist/test-runner.js.map

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

package/dist/typescript-declarations.d.ts

@@ -0,0 +1,20 @@
+import { type ClassInfo, type ValueType } from "@velarscript/compiler";
+export interface TypeScriptDeclarationBridge {
+    readonly path: string;
+    readonly dependencies: readonly string[];
+    readonly exports: ReadonlyMap<string, ValueType>;
+    readonly typeExports: ReadonlyMap<string, ValueType>;
+    readonly classes: ReadonlyMap<string, ClassInfo>;
+    readonly classRegistry: ReadonlyMap<string, ClassInfo>;
+    readonly warnings: readonly string[];
+    /**
+     * BRG-U3: the package declares a `types` entry that cannot be read. The
+     * import degrades to unknown, but with a notice — a broken declared path
+     * is a package defect worth reporting, unlike a package that never
+     * declared types at all.
+     */
+    readonly unreadableDeclaredTypes?: true;
+}
+export declare function loadTypeScriptDeclarations(source: string, importerPath: string): Promise<TypeScriptDeclarationBridge | null>;
+export declare function parseTypeScriptDeclarations(source: string, path?: string, moduleSource?: string, reexportsHandled?: boolean, importedTypes?: ReadonlyMap<string, ValueType>, importedClassRegistry?: ReadonlyMap<string, ClassInfo>): TypeScriptDeclarationBridge;
+//# sourceMappingURL=typescript-declarations.d.ts.map

package/dist/typescript-declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-declarations.d.ts","sourceRoot":"","sources":["../src/typescript-declarations.ts"],"names":[],"mappings":"AAIA,OAAO,EAWL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,IAAI,CAAC;CACzC;AAwBD,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAkDlI;AA+TD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,IAAI,SAAY,EAChB,YAAY,SAAO,EACnB,gBAAgB,UAAQ,EACxB,aAAa,GAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAa,EACzD,qBAAqB,GAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAa,GAChE,2BAA2B,CA6S7B"}