@ddd-ts-kit/testing 0.0.0-stage → 0.1.1

package/dist/vitest/decorator-compiler.js

@@ -0,0 +1,112 @@
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { isRecord } from './is-record.js';
+import { singleFileProject } from './single-file-project.js';
+import { sourceMapOf } from './source-map-of.js';
+/** What is taken from the project: the rest is fixed by what a single file needs. */
+const FOLLOWED = [
+    'target',
+    'useDefineForClassFields',
+    'verbatimModuleSyntax',
+    'experimentalDecorators',
+    'emitDecoratorMetadata',
+];
+/** Bumped when what is emitted for the same input changes. */
+const FORMAT = 1;
+/** Compiles one file holding standard decorators with the `tsc` of the project, once per content. */
+export class DecoratorCompiler {
+    setup;
+    projects = new Map();
+    constructor(setup) {
+        this.setup = setup;
+    }
+    compile(file, code) {
+        const project = this.projectOf(file);
+        if (project.experimentalDecorators === true) {
+            return undefined;
+        }
+        const entry = this.entryOf(file, code, project);
+        if (!existsSync(entry.output)) {
+            this.emit({ ...entry, file }, code, project);
+        }
+        return {
+            code: readFileSync(entry.output, 'utf8').replace(/\n\/\/# sourceMappingURL=.*\s*$/, '\n'),
+            map: sourceMapOf(readFileSync(`${entry.output}.map`, 'utf8'), file, code),
+        };
+    }
+    projectOf(file) {
+        const tsconfig = this.setup.tsconfig ?? nearestTsconfig(path.dirname(file));
+        if (tsconfig === undefined) {
+            return {};
+        }
+        const known = this.projects.get(tsconfig);
+        if (known !== undefined) {
+            return known;
+        }
+        const shown = JSON.parse(this.run(['--showConfig', '-p', tsconfig], tsconfig));
+        const all = isRecord(shown) && isRecord(shown.compilerOptions) ? shown.compilerOptions : {};
+        const followed = Object.fromEntries(FOLLOWED.filter((name) => name in all).map((name) => [name, all[name]]));
+        this.projects.set(tsconfig, followed);
+        return followed;
+    }
+    entryOf(file, code, project) {
+        const key = createHash('sha256')
+            .update(JSON.stringify([FORMAT, this.setup.script, project, file, code]))
+            .digest('hex')
+            .slice(0, 32);
+        const extension = path.extname(file);
+        const directory = path.join(this.setup.cacheDir, key);
+        return {
+            directory,
+            source: `source${extension}`,
+            output: path.join(directory, `source${emittedExtension(extension)}`),
+        };
+    }
+    /** Emitted next to the cache, then moved into it in one step: a reader never sees half a file. */
+    emit(entry, code, project) {
+        const workshop = `${entry.directory}.${process.pid}`;
+        mkdirSync(workshop, { recursive: true });
+        try {
+            writeFileSync(path.join(workshop, entry.source), code);
+            writeFileSync(path.join(workshop, 'tsconfig.json'), JSON.stringify(singleFileProject(entry.source, project)));
+            this.run(['-p', workshop], entry.file);
+            if (!existsSync(entry.directory)) {
+                renameSync(workshop, entry.directory);
+            }
+        }
+        finally {
+            rmSync(workshop, { recursive: true, force: true });
+        }
+    }
+    run(args, subject) {
+        try {
+            return execFileSync(process.execPath, [this.setup.script, '--pretty', 'false', ...args], {
+                encoding: 'utf8',
+                stdio: 'pipe',
+            });
+        }
+        catch (error) {
+            throw new Error(`The TypeScript compiler refused ${subject}:\n${saidBy(error)}`, { cause: error });
+        }
+    }
+}
+function nearestTsconfig(directory) {
+    const candidate = path.join(directory, 'tsconfig.json');
+    if (existsSync(candidate)) {
+        return candidate;
+    }
+    const parent = path.dirname(directory);
+    return parent === directory ? undefined : nearestTsconfig(parent);
+}
+function emittedExtension(extension) {
+    return extension.replace('ts', 'js');
+}
+function saidBy(failure) {
+    if (!isRecord(failure)) {
+        return String(failure);
+    }
+    return [failure.stdout, failure.stderr].filter((output) => typeof output === 'string').join('');
+}
+//# sourceMappingURL=decorator-compiler.js.map

package/dist/vitest/decorator-compiler.js.map

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

package/dist/vitest/decorator-coverage.d.ts

@@ -0,0 +1,27 @@
+/** The part of a Vite plugin this one fills: it is listed in `plugins` as it is. */
+export interface DecoratorCoveragePlugin {
+    readonly name: string;
+    readonly enforce: 'post';
+    transform(code: string, id: string): {
+        code: string;
+        map: null;
+    } | undefined;
+}
+/**
+ * Keeps the statements that apply legacy decorators out of the coverage measure. Under
+ * `experimentalDecorators` with `emitDecoratorMetadata` (class-validator, NestJS) the transform
+ * of the runner writes, for every type a decorated constructor or property names,
+ * `typeof Port === "undefined" ? Object : Port`: a branch no test can take, mapped to the line of
+ * the decorator. A handler with two ports would lose two branches a spec cannot win back, and the
+ * branch threshold would measure the compiler instead of the code.
+ *
+ * Each such statement is marked, after the transform, with the hint the coverage provider reads,
+ * written at the end of the line above it so that no column of the source map moves. The provider
+ * does the same by itself for the output of SWC.
+ *
+ *     // vitest.config.ts
+ *     import { decoratorCoverage } from '@ddd-ts-kit/testing/vitest';
+ *     export default defineConfig({ plugins: [decoratorCoverage()] });
+ */
+export declare function decoratorCoverage(): DecoratorCoveragePlugin;
+//# sourceMappingURL=decorator-coverage.d.ts.map

package/dist/vitest/decorator-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-coverage.d.ts","sourceRoot":"","sources":["../../src/vitest/decorator-coverage.ts"],"names":[],"mappings":"AAIA,oFAAoF;AACpF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,SAAS,CAAC;CAC9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAe3D"}

package/dist/vitest/decorator-coverage.js

@@ -0,0 +1,41 @@
+/** A statement the transform of the runner writes to apply legacy decorators: `Handler = _decorate([...], Handler);`. */
+const APPLIES_DECORATORS = /^\s*(?:[\w$.]+\s*=\s*)?_decorate\d*\(/;
+const HINT = '/* v8 ignore next */';
+/**
+ * Keeps the statements that apply legacy decorators out of the coverage measure. Under
+ * `experimentalDecorators` with `emitDecoratorMetadata` (class-validator, NestJS) the transform
+ * of the runner writes, for every type a decorated constructor or property names,
+ * `typeof Port === "undefined" ? Object : Port`: a branch no test can take, mapped to the line of
+ * the decorator. A handler with two ports would lose two branches a spec cannot win back, and the
+ * branch threshold would measure the compiler instead of the code.
+ *
+ * Each such statement is marked, after the transform, with the hint the coverage provider reads,
+ * written at the end of the line above it so that no column of the source map moves. The provider
+ * does the same by itself for the output of SWC.
+ *
+ *     // vitest.config.ts
+ *     import { decoratorCoverage } from '@ddd-ts-kit/testing/vitest';
+ *     export default defineConfig({ plugins: [decoratorCoverage()] });
+ */
+export function decoratorCoverage() {
+    return {
+        name: 'ddd-ts-kit:decorator-coverage',
+        enforce: 'post',
+        transform(code, id) {
+            if (id.includes('/node_modules/') || !code.includes('_decorate')) {
+                return undefined;
+            }
+            const lines = code.split('\n');
+            const marked = lines.map((line, index) => (isApplied(lines[index + 1]) ? withHint(line) : line)).join('\n');
+            return marked === code ? undefined : { code: marked, map: null };
+        },
+    };
+}
+function isApplied(line) {
+    return line !== undefined && APPLIES_DECORATORS.test(line);
+}
+/** A line that ends in a line comment would swallow the hint: it is left as it is. */
+function withHint(line) {
+    return line.includes('//') ? line : `${line} ${HINT}`;
+}
+//# sourceMappingURL=decorator-coverage.js.map

package/dist/vitest/decorator-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-coverage.js","sourceRoot":"","sources":["../../src/vitest/decorator-coverage.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,MAAM,kBAAkB,GAAG,uCAAuC,CAAC;AACnE,MAAM,IAAI,GAAG,sBAAsB,CAAC;AASpC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,MAAM;QACf,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjE,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE5G,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAwB;IACzC,OAAO,IAAI,KAAK,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,sFAAsF;AACtF,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/dist/vitest/decorators.d.ts

@@ -0,0 +1,41 @@
+export interface DecoratorsOptions {
+    /**
+     * The tsconfig whose `target`, `useDefineForClassFields`, `verbatimModuleSyntax` and
+     * `experimentalDecorators` are followed. Default: for each file, the nearest `tsconfig.json`
+     * above it, which is also the one the test runner follows.
+     */
+    readonly tsconfig?: string;
+    /**
+     * The package whose `tsc` compiles, resolved from the root of the project, or the path of a
+     * `tsc` script. Default: `typescript`. Any version from 5.6 fits, the native one included.
+     */
+    readonly compiler?: string;
+    /** Where compiled files are kept between runs. Default: `ddd-ts-kit-decorators` in the cache directory of Vite. */
+    readonly cacheDir?: string;
+}
+/** The part of a Vite plugin this one fills: it is listed in `plugins` as it is. */
+export interface DecoratorsPlugin {
+    readonly name: string;
+    readonly enforce: 'pre';
+    configResolved(config: {
+        readonly root: string;
+        readonly cacheDir: string;
+    }): void;
+    transform(code: string, id: string): {
+        code: string;
+        map: string;
+    } | undefined;
+}
+/**
+ * Lets Vitest run TypeScript sources that hold standard (TC39) decorators, which its own
+ * transform does not lower: a file holding one is compiled by the TypeScript compiler of the
+ * project, with its compiler options and a source map, before the runner reads it. Every other
+ * file is left to the runner, and so is every file of a project compiled with
+ * `experimentalDecorators`: the runner lowers legacy decorators by itself.
+ *
+ *     // vitest.config.ts
+ *     import { decorators } from '@ddd-ts-kit/testing/vitest';
+ *     export default defineConfig({ plugins: [decorators()] });
+ */
+export declare function decorators(options?: DecoratorsOptions): DecoratorsPlugin;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/vitest/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/vitest/decorators.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,cAAc,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAChF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAuB5E"}

package/dist/vitest/decorators.js

@@ -0,0 +1,49 @@
+import path from 'node:path';
+import { compilerScript } from './compiler-script.js';
+import { DecoratorCompiler } from './decorator-compiler.js';
+/**
+ * Lets Vitest run TypeScript sources that hold standard (TC39) decorators, which its own
+ * transform does not lower: a file holding one is compiled by the TypeScript compiler of the
+ * project, with its compiler options and a source map, before the runner reads it. Every other
+ * file is left to the runner, and so is every file of a project compiled with
+ * `experimentalDecorators`: the runner lowers legacy decorators by itself.
+ *
+ *     // vitest.config.ts
+ *     import { decorators } from '@ddd-ts-kit/testing/vitest';
+ *     export default defineConfig({ plugins: [decorators()] });
+ */
+export function decorators(options = {}) {
+    let compiler;
+    return {
+        name: 'ddd-ts-kit:decorators',
+        enforce: 'pre',
+        configResolved({ root, cacheDir }) {
+            compiler = new DecoratorCompiler({
+                script: compilerScript(options.compiler ?? 'typescript', root),
+                cacheDir: options.cacheDir ?? path.join(cacheDir, 'ddd-ts-kit-decorators'),
+                ...(options.tsconfig === undefined ? {} : { tsconfig: path.resolve(root, options.tsconfig) }),
+            });
+        },
+        transform(code, id) {
+            const file = withoutQuery(id);
+            if (compiler === undefined || !holdsADecorator(file, code)) {
+                return undefined;
+            }
+            return compiler.compile(file, code);
+        },
+    };
+}
+const QUERY = /[?#]/;
+const SOURCE = /\.[cm]?ts$/;
+const DECLARATION = /\.d\.[cm]?ts$/;
+/** A line that starts with a decorator, after `export` or `export default` at most. */
+const DECORATOR = /^[ \t]*(?:export\s+(?:default\s+)?)?@[A-Za-z_$]/m;
+/** The file of a module id, without the query or the fragment a plugin added to it. */
+function withoutQuery(id) {
+    const end = id.search(QUERY);
+    return end === -1 ? id : id.slice(0, end);
+}
+function holdsADecorator(file, code) {
+    return SOURCE.test(file) && !DECLARATION.test(file) && DECORATOR.test(code);
+}
+//# sourceMappingURL=decorators.js.map

package/dist/vitest/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/vitest/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AA0B5D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,OAAO,GAAsB,EAAE;IACxD,IAAI,QAAuC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,KAAK;QACd,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,QAAQ,GAAG,IAAI,iBAAiB,CAAC;gBAC/B,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,QAAQ,IAAI,YAAY,EAAE,IAAI,CAAC;gBAC9D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC;gBAC1E,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;aAC9F,CAAC,CAAC;QACL,CAAC;QACD,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;YAE9B,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC3D,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,KAAK,GAAG,MAAM,CAAC;AACrB,MAAM,MAAM,GAAG,YAAY,CAAC;AAC5B,MAAM,WAAW,GAAG,eAAe,CAAC;AACpC,uFAAuF;AACvF,MAAM,SAAS,GAAG,kDAAkD,CAAC;AAErE,uFAAuF;AACvF,SAAS,YAAY,CAAC,EAAU;IAC9B,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,IAAY;IACjD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/dist/vitest/is-record.d.ts

@@ -0,0 +1,2 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=is-record.d.ts.map

package/dist/vitest/is-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record.d.ts","sourceRoot":"","sources":["../../src/vitest/is-record.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/vitest/is-record.js

@@ -0,0 +1,4 @@
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=is-record.js.map

package/dist/vitest/is-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record.js","sourceRoot":"","sources":["../../src/vitest/is-record.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/vitest/project-options.d.ts

@@ -0,0 +1,3 @@
+/** The compiler options taken from the project of a file. */
+export type ProjectOptions = Readonly<Record<string, unknown>>;
+//# sourceMappingURL=project-options.d.ts.map

package/dist/vitest/project-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-options.d.ts","sourceRoot":"","sources":["../../src/vitest/project-options.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/vitest/project-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project-options.js.map

package/dist/vitest/project-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-options.js","sourceRoot":"","sources":["../../src/vitest/project-options.ts"],"names":[],"mappings":""}

package/dist/vitest/single-file-project.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectOptions } from './project-options.js';
+export declare function singleFileProject(source: string, project: ProjectOptions): unknown;
+//# sourceMappingURL=single-file-project.d.ts.map

package/dist/vitest/single-file-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-file-project.d.ts","sourceRoot":"","sources":["../../src/vitest/single-file-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAoBlF"}

package/dist/vitest/single-file-project.js

@@ -0,0 +1,26 @@
+/*
+ * One file, no resolution and no type check: imports are kept as they are written, for the
+ * runner to resolve. A target of `ESNext` would leave the decorators in place, which is what
+ * this plugin exists to avoid, so the newest dated target stands in for it.
+ */
+export function singleFileProject(source, project) {
+    const target = typeof project.target === 'string' ? project.target.toLowerCase() : 'es2022';
+    return {
+        compilerOptions: {
+            ...project,
+            target: target === 'esnext' ? 'es2024' : target,
+            module: 'preserve',
+            moduleResolution: 'bundler',
+            noResolve: true,
+            noCheck: true,
+            isolatedModules: true,
+            types: [],
+            sourceMap: true,
+            declaration: false,
+            outDir: '.',
+            rootDir: '.',
+        },
+        files: [source],
+    };
+}
+//# sourceMappingURL=single-file-project.js.map

package/dist/vitest/single-file-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-file-project.js","sourceRoot":"","sources":["../../src/vitest/single-file-project.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,OAAuB;IACvE,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE5F,OAAO;QACL,eAAe,EAAE;YACf,GAAG,OAAO;YACV,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;YAC/C,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,SAAS;YAC3B,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,GAAG;SACb;QACD,KAAK,EAAE,CAAC,MAAM,CAAC;KAChB,CAAC;AACJ,CAAC"}

package/dist/vitest/source-map-of.d.ts

@@ -0,0 +1,3 @@
+/** The emitted map, naming the real file and holding its text, for stack traces and coverage. */
+export declare function sourceMapOf(emitted: string, file: string, code: string): string;
+//# sourceMappingURL=source-map-of.d.ts.map

package/dist/vitest/source-map-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-map-of.d.ts","sourceRoot":"","sources":["../../src/vitest/source-map-of.ts"],"names":[],"mappings":"AAEA,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAW/E"}

package/dist/vitest/source-map-of.js

@@ -0,0 +1,14 @@
+import { isRecord } from './is-record.js';
+/** The emitted map, naming the real file and holding its text, for stack traces and coverage. */
+export function sourceMapOf(emitted, file, code) {
+    const map = JSON.parse(emitted);
+    const { mappings, names } = isRecord(map) ? map : {};
+    return JSON.stringify({
+        version: 3,
+        sources: [file],
+        sourcesContent: [code],
+        names: names ?? [],
+        mappings: mappings ?? '',
+    });
+}
+//# sourceMappingURL=source-map-of.js.map

package/dist/vitest/source-map-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-map-of.js","sourceRoot":"","sources":["../../src/vitest/source-map-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY,EAAE,IAAY;IACrE,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAErD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC,IAAI,CAAC;QACf,cAAc,EAAE,CAAC,IAAI,CAAC;QACtB,KAAK,EAAE,KAAK,IAAI,EAAE;QAClB,QAAQ,EAAE,QAAQ,IAAI,EAAE;KACzB,CAAC,CAAC;AACL,CAAC"}

package/dist/vitest.d.ts

@@ -0,0 +1,3 @@
+export { decoratorCoverage, type DecoratorCoveragePlugin } from './vitest/decorator-coverage.js';
+export { decorators, type DecoratorsOptions, type DecoratorsPlugin } from './vitest/decorators.js';
+//# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/vitest.js

@@ -0,0 +1,3 @@
+export { decoratorCoverage } from './vitest/decorator-coverage.js';
+export { decorators } from './vitest/decorators.js';
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.js","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAgC,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,UAAU,EAAiD,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@ddd-ts-kit/testing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Readable tests without mocks: test data builders, given/when/then scenarios and contract suites shared by fakes and real adapters.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
+    "directory": "packages/testing"
+  },
+  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/testing#readme",
+  "bugs": "https://github.com/gbourgeat/ddd-ts-kit/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contracts": {
+      "types": "./dist/contracts.d.ts",
+      "default": "./dist/contracts.js"
+    },
+    "./faker": {
+      "types": "./dist/faker.d.ts",
+      "default": "./dist/faker.js"
+    },
+    "./e2e": {
+      "types": "./dist/e2e.d.ts",
+      "default": "./dist/e2e.js"
+    },
+    "./coverage": {
+      "types": "./dist/coverage.d.ts",
+      "default": "./dist/coverage.js"
+    },
+    "./vitest": {
+      "types": "./dist/vitest.d.ts",
+      "default": "./dist/vitest.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@ddd-ts-kit/kernel": "0.1.1"
+  },
+  "devDependencies": {
+    "@ddd-ts-kit/aspects": "0.1.1",
+    "@ddd-ts-kit/events": "0.1.1",
+    "@faker-js/faker": "^10.6.0"
+  },
+  "peerDependencies": {
+    "@faker-js/faker": ">=9.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@faker-js/faker": {
+      "optional": true
+    }
+  }
+}