@smoothbricks/lmao 0.1.0

package/dist/lib/testing/trace-query.js

@@ -0,0 +1,462 @@
+import * as __typia_transform__accessExpressionAsString from "typia/lib/internal/_accessExpressionAsString";
+import * as __typia_transform__validateReport from "typia/lib/internal/_validateReport";
+import * as __typia_transform__createStandardSchema from "typia/lib/internal/_createStandardSchema";
+/**
+ * TraceQuery - Post-run query API for the SQLite trace database.
+ *
+ * Queries a single flat `spans` table where each row is a buffer entry.
+ * Status and duration are derived from entry_type and timestamps via self-joins.
+ * Tree structure uses span_id / parent_span_id (no depth column).
+ *
+ * Platform-agnostic: accepts a SyncSQLiteDatabase instance from either
+ * bun:sqlite or better-sqlite3.
+ *
+ * @example
+ * ```typescript
+ * import { Database } from 'bun:sqlite';
+ * import { TraceQuery } from '@smoothbricks/lmao/testing';
+ *
+ * const query = new TraceQuery(new Database('.trace-results.db'));
+ * console.log(query.failures());
+ * console.log(query.slowest(undefined, 10));
+ * query.close();
+ * ```
+ *
+ * @module trace-query
+ */
+import typia from 'typia';
+let validateTraceRunRow;
+let validateLatestTraceRunRow;
+let validateRootSpanRow;
+let validateTraceQueryResultRow;
+function getValidateTraceRunRow() {
+    validateTraceRunRow ??= (() => { const _io0 = (input, _exceptionable = true) => "string" === typeof input.traceId && "string" === typeof input.spanName && "number" === typeof input.startedAt && (3 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["traceId", "spanName", "startedAt"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    })); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.traceId || _report(_exceptionable, {
+            path: _path + ".traceId",
+            expected: "string",
+            value: input.traceId
+        }), "string" === typeof input.spanName || _report(_exceptionable, {
+            path: _path + ".spanName",
+            expected: "string",
+            value: input.spanName
+        }), "number" === typeof input.startedAt || _report(_exceptionable, {
+            path: _path + ".startedAt",
+            expected: "number",
+            value: input.startedAt
+        }), 3 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+            if (["traceId", "spanName", "startedAt"].some(prop => key === prop))
+                return true;
+            const value = input[key];
+            if (undefined === value)
+                return true;
+            return _report(_exceptionable, {
+                path: _path + __typia_transform__accessExpressionAsString._accessExpressionAsString(key),
+                expected: "undefined",
+                value: value,
+                description: [
+                    `The property \`${key}\` is not defined in the object type.`,
+                    "",
+                    "Please remove the property next time."
+                ].join("\n")
+            });
+        }).every(flag => flag))].every(flag => flag); const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true); let errors; let _report; return __typia_transform__createStandardSchema._createStandardSchema(input => {
+        if (false === __is(input)) {
+            errors = [];
+            _report = __typia_transform__validateReport._validateReport(errors);
+            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                path: _path + "",
+                expected: "TraceRunRow",
+                value: input
+            })) && _vo0(input, _path + "", true) || _report(true, {
+                path: _path + "",
+                expected: "TraceRunRow",
+                value: input
+            }))(input, "$input", true);
+            const success = 0 === errors.length;
+            return success ? {
+                success,
+                data: input
+            } : {
+                success,
+                errors,
+                data: input
+            };
+        }
+        return {
+            success: true,
+            data: input
+        };
+    }); })();
+    return validateTraceRunRow;
+}
+function getValidateLatestTraceRunRow() {
+    validateLatestTraceRunRow ??= (() => { const _io0 = (input, _exceptionable = true) => "string" === typeof input.traceId && (1 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["traceId"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    })); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.traceId || _report(_exceptionable, {
+            path: _path + ".traceId",
+            expected: "string",
+            value: input.traceId
+        }), 1 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+            if (["traceId"].some(prop => key === prop))
+                return true;
+            const value = input[key];
+            if (undefined === value)
+                return true;
+            return _report(_exceptionable, {
+                path: _path + __typia_transform__accessExpressionAsString._accessExpressionAsString(key),
+                expected: "undefined",
+                value: value,
+                description: [
+                    `The property \`${key}\` is not defined in the object type.`,
+                    "",
+                    "Please remove the property next time."
+                ].join("\n")
+            });
+        }).every(flag => flag))].every(flag => flag); const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true); let errors; let _report; return __typia_transform__createStandardSchema._createStandardSchema(input => {
+        if (false === __is(input)) {
+            errors = [];
+            _report = __typia_transform__validateReport._validateReport(errors);
+            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                path: _path + "",
+                expected: "LatestTraceRunRow",
+                value: input
+            })) && _vo0(input, _path + "", true) || _report(true, {
+                path: _path + "",
+                expected: "LatestTraceRunRow",
+                value: input
+            }))(input, "$input", true);
+            const success = 0 === errors.length;
+            return success ? {
+                success,
+                data: input
+            } : {
+                success,
+                errors,
+                data: input
+            };
+        }
+        return {
+            success: true,
+            data: input
+        };
+    }); })();
+    return validateLatestTraceRunRow;
+}
+function getValidateRootSpanRow() {
+    validateRootSpanRow ??= (() => { const _io0 = (input, _exceptionable = true) => "number" === typeof input.span_id && (1 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["span_id"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    })); const _vo0 = (input, _path, _exceptionable = true) => ["number" === typeof input.span_id || _report(_exceptionable, {
+            path: _path + ".span_id",
+            expected: "number",
+            value: input.span_id
+        }), 1 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+            if (["span_id"].some(prop => key === prop))
+                return true;
+            const value = input[key];
+            if (undefined === value)
+                return true;
+            return _report(_exceptionable, {
+                path: _path + __typia_transform__accessExpressionAsString._accessExpressionAsString(key),
+                expected: "undefined",
+                value: value,
+                description: [
+                    `The property \`${key}\` is not defined in the object type.`,
+                    "",
+                    "Please remove the property next time."
+                ].join("\n")
+            });
+        }).every(flag => flag))].every(flag => flag); const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true); let errors; let _report; return __typia_transform__createStandardSchema._createStandardSchema(input => {
+        if (false === __is(input)) {
+            errors = [];
+            _report = __typia_transform__validateReport._validateReport(errors);
+            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                path: _path + "",
+                expected: "RootSpanRow",
+                value: input
+            })) && _vo0(input, _path + "", true) || _report(true, {
+                path: _path + "",
+                expected: "RootSpanRow",
+                value: input
+            }))(input, "$input", true);
+            const success = 0 === errors.length;
+            return success ? {
+                success,
+                data: input
+            } : {
+                success,
+                errors,
+                data: input
+            };
+        }
+        return {
+            success: true,
+            data: input
+        };
+    }); })();
+    return validateRootSpanRow;
+}
+function getValidateTraceQueryResultRow() {
+    validateTraceQueryResultRow ??= (() => { const _io0 = (input, _exceptionable = true) => "string" === typeof input.spanName && ("ok" === input.status || "err" === input.status || "exception" === input.status || "running" === input.status) && (null === input.durationNs || "number" === typeof input.durationNs) && (null === input.describe || "string" === typeof input.describe) && "number" === typeof input.parentSpanId && (5 === Object.keys(input).length || Object.keys(input).every(key => {
+        if (["spanName", "status", "durationNs", "describe", "parentSpanId"].some(prop => key === prop))
+            return true;
+        const value = input[key];
+        if (undefined === value)
+            return true;
+        return false;
+    })); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.spanName || _report(_exceptionable, {
+            path: _path + ".spanName",
+            expected: "string",
+            value: input.spanName
+        }), "ok" === input.status || "err" === input.status || "exception" === input.status || "running" === input.status || _report(_exceptionable, {
+            path: _path + ".status",
+            expected: "(\"err\" | \"exception\" | \"ok\" | \"running\")",
+            value: input.status
+        }), null === input.durationNs || "number" === typeof input.durationNs || _report(_exceptionable, {
+            path: _path + ".durationNs",
+            expected: "(null | number)",
+            value: input.durationNs
+        }), null === input.describe || "string" === typeof input.describe || _report(_exceptionable, {
+            path: _path + ".describe",
+            expected: "(null | string)",
+            value: input.describe
+        }), "number" === typeof input.parentSpanId || _report(_exceptionable, {
+            path: _path + ".parentSpanId",
+            expected: "number",
+            value: input.parentSpanId
+        }), 5 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+            if (["spanName", "status", "durationNs", "describe", "parentSpanId"].some(prop => key === prop))
+                return true;
+            const value = input[key];
+            if (undefined === value)
+                return true;
+            return _report(_exceptionable, {
+                path: _path + __typia_transform__accessExpressionAsString._accessExpressionAsString(key),
+                expected: "undefined",
+                value: value,
+                description: [
+                    `The property \`${key}\` is not defined in the object type.`,
+                    "",
+                    "Please remove the property next time."
+                ].join("\n")
+            });
+        }).every(flag => flag))].every(flag => flag); const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true); let errors; let _report; return __typia_transform__createStandardSchema._createStandardSchema(input => {
+        if (false === __is(input)) {
+            errors = [];
+            _report = __typia_transform__validateReport._validateReport(errors);
+            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                path: _path + "",
+                expected: "TraceQueryResultRow",
+                value: input
+            })) && _vo0(input, _path + "", true) || _report(true, {
+                path: _path + "",
+                expected: "TraceQueryResultRow",
+                value: input
+            }))(input, "$input", true);
+            const success = 0 === errors.length;
+            return success ? {
+                success,
+                data: input
+            } : {
+                success,
+                errors,
+                data: input
+            };
+        }
+        return {
+            success: true,
+            data: input
+        };
+    }); })();
+    return validateTraceQueryResultRow;
+}
+function describeSqliteBoundaryError(boundary, errors, rowIndex) {
+    const firstError = errors[0];
+    const rowDetail = rowIndex === undefined ? '' : ` row ${rowIndex}`;
+    if (!firstError) {
+        return `${boundary} returned an invalid SQLite${rowDetail} result`;
+    }
+    return `${boundary} returned an invalid SQLite${rowDetail} result at ${firstError.path}: expected ${firstError.expected}`;
+}
+function parseOptionalSqliteRow(boundary, row, validate) {
+    if (row == null) {
+        return undefined;
+    }
+    const validation = validate(row);
+    if (!validation.success) {
+        throw new Error(describeSqliteBoundaryError(boundary, validation.errors));
+    }
+    return validation.data;
+}
+function parseSqliteRows(boundary, rows, validate) {
+    return rows.map((row, rowIndex) => {
+        const validation = validate(row);
+        if (!validation.success) {
+            throw new Error(describeSqliteBoundaryError(boundary, validation.errors, rowIndex));
+        }
+        return validation.data;
+    });
+}
+function toTraceQueryResult(row) {
+    return {
+        spanName: row.spanName,
+        status: row.status,
+        durationNs: row.durationNs ?? undefined,
+        describe: row.describe ?? undefined,
+        parentSpanId: row.parentSpanId,
+    };
+}
+export class TraceQuery {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Get all trace runs (root spans), most recent first */
+    runs() {
+        return parseSqliteRows('TraceQuery.runs', this.db
+            .prepare(`SELECT trace_id AS traceId, message AS spanName, timestamp_ns AS startedAt
+         FROM spans
+         WHERE parent_span_id = 0 AND row_index = 0
+         ORDER BY timestamp_ns DESC`)
+            .all(), getValidateTraceRunRow());
+    }
+    /** Get the most recent trace_id (= run_id) */
+    latestRun() {
+        return parseOptionalSqliteRow('TraceQuery.latestRun', this.db
+            .prepare(`SELECT trace_id AS traceId
+         FROM spans
+         WHERE parent_span_id = 0 AND row_index = 0
+         ORDER BY timestamp_ns DESC LIMIT 1`)
+            .get(), getValidateLatestTraceRunRow());
+    }
+    /** Get all failed tests in a run (defaults to latest run) */
+    failures(traceId) {
+        const id = traceId ?? this.latestRun()?.traceId;
+        if (!id)
+            return [];
+        // Find the root span_id for this trace
+        const root = parseOptionalSqliteRow('TraceQuery.failures root span', this.db.prepare('SELECT span_id FROM spans WHERE trace_id = ? AND parent_span_id = 0 AND row_index = 0').get(id), getValidateRootSpanRow());
+        if (!root)
+            return [];
+        // Self-join: row_index=0 for name, row_index=1 for status/duration
+        return parseSqliteRows('TraceQuery.failures rows', this.db
+            .prepare(`SELECT
+           s0.message AS spanName,
+           CASE WHEN s1.entry_type = 2 THEN 'ok'
+                WHEN s1.entry_type = 3 THEN 'err'
+                WHEN s1.entry_type = 4 THEN 'exception'
+                ELSE 'running' END AS status,
+           s1.timestamp_ns - s0.timestamp_ns AS durationNs,
+           s0.describe,
+           s0.parent_span_id AS parentSpanId
+         FROM spans s0
+         LEFT JOIN spans s1 ON s1.trace_id = s0.trace_id AND s1.span_id = s0.span_id AND s1.row_index = 1
+          WHERE s0.trace_id = ? AND s0.parent_span_id = ? AND s0.row_index = 0
+            AND s1.entry_type IN (3, 4)
+          ORDER BY s0.timestamp_ns ASC`)
+            .all(id, root.span_id), getValidateTraceQueryResultRow()).map(toTraceQueryResult);
+    }
+    /** Get slowest tests in a run (defaults to latest run) */
+    slowest(traceId, limit = 20) {
+        const id = traceId ?? this.latestRun()?.traceId;
+        if (!id)
+            return [];
+        // Find the root span_id for this trace
+        const root = parseOptionalSqliteRow('TraceQuery.slowest root span', this.db.prepare('SELECT span_id FROM spans WHERE trace_id = ? AND parent_span_id = 0 AND row_index = 0').get(id), getValidateRootSpanRow());
+        if (!root)
+            return [];
+        return parseSqliteRows('TraceQuery.slowest rows', this.db
+            .prepare(`SELECT
+           s0.message AS spanName,
+           CASE WHEN s1.entry_type = 2 THEN 'ok'
+                WHEN s1.entry_type = 3 THEN 'err'
+                WHEN s1.entry_type = 4 THEN 'exception'
+                ELSE 'running' END AS status,
+           s1.timestamp_ns - s0.timestamp_ns AS durationNs,
+           s0.describe,
+           s0.parent_span_id AS parentSpanId
+         FROM spans s0
+         LEFT JOIN spans s1 ON s1.trace_id = s0.trace_id AND s1.span_id = s0.span_id AND s1.row_index = 1
+         WHERE s0.trace_id = ? AND s0.parent_span_id = ? AND s0.row_index = 0
+            AND s1.entry_type IS NOT NULL
+          ORDER BY durationNs DESC
+          LIMIT ?`)
+            .all(id, root.span_id, limit), getValidateTraceQueryResultRow()).map(toTraceQueryResult);
+    }
+    /** Find spans by name pattern (SQL LIKE, defaults to latest run) */
+    findSpans(pattern, traceId) {
+        const id = traceId ?? this.latestRun()?.traceId;
+        if (!id)
+            return [];
+        return parseSqliteRows('TraceQuery.findSpans', this.db
+            .prepare(`SELECT
+           s0.message AS spanName,
+           CASE WHEN s1.entry_type = 2 THEN 'ok'
+                WHEN s1.entry_type = 3 THEN 'err'
+                WHEN s1.entry_type = 4 THEN 'exception'
+                ELSE 'running' END AS status,
+           s1.timestamp_ns - s0.timestamp_ns AS durationNs,
+           s0.describe,
+           s0.parent_span_id AS parentSpanId
+         FROM spans s0
+          LEFT JOIN spans s1 ON s1.trace_id = s0.trace_id AND s1.span_id = s0.span_id AND s1.row_index = 1
+          WHERE s0.trace_id = ? AND s0.row_index = 0 AND s0.message LIKE ?
+          ORDER BY s0.timestamp_ns ASC`)
+            .all(id, pattern), getValidateTraceQueryResultRow()).map(toTraceQueryResult);
+    }
+    /** Get full span tree for a specific test (all descendants, defaults to latest run) */
+    testTree(testName, traceId) {
+        const id = traceId ?? this.latestRun()?.traceId;
+        if (!id)
+            return [];
+        // Recursive CTE on span_id/parent_span_id
+        return parseSqliteRows('TraceQuery.testTree', this.db
+            .prepare(`WITH RECURSIVE tree AS (
+           -- Anchor: find the span by name
+           SELECT span_id
+           FROM spans
+           WHERE trace_id = ? AND row_index = 0 AND message = ?
+           LIMIT 1
+
+           UNION ALL
+
+           -- Recurse: find children by parent_span_id
+           SELECT s.span_id
+           FROM spans s
+           INNER JOIN tree t ON s.parent_span_id = t.span_id
+           WHERE s.trace_id = ? AND s.row_index = 0
+         )
+         SELECT
+           s0.message AS spanName,
+           CASE WHEN s1.entry_type = 2 THEN 'ok'
+                WHEN s1.entry_type = 3 THEN 'err'
+                WHEN s1.entry_type = 4 THEN 'exception'
+                ELSE 'running' END AS status,
+           s1.timestamp_ns - s0.timestamp_ns AS durationNs,
+           s0.describe,
+           s0.parent_span_id AS parentSpanId
+         FROM tree
+          JOIN spans s0 ON s0.trace_id = ? AND s0.span_id = tree.span_id AND s0.row_index = 0
+          LEFT JOIN spans s1 ON s1.trace_id = s0.trace_id AND s1.span_id = s0.span_id AND s1.row_index = 1
+          ORDER BY s0.timestamp_ns ASC`)
+            .all(id, testName, id, id), getValidateTraceQueryResultRow()).map(toTraceQueryResult);
+    }
+    close() {
+        this.db.close();
+    }
+}

package/dist/lib/testing/vitest-harness.d.ts

@@ -0,0 +1,135 @@
+/**
+ * vitest integration for LMAO trace-testing.
+ *
+ * Same architecture as bun-harness: one root trace per test run,
+ * each it() creates a child span, describe path written to `describe` schema column.
+ *
+ * Supports lifecycle tracer outputs (SQLite, stdio, or both via CompositeTracer).
+ *
+ * @example
+ * ```typescript
+ * // vitest.config.ts
+ * export default defineConfig({
+ *   test: { setupFiles: ['./test-setup.ts'] },
+ * });
+ *
+ * // test-setup.ts
+ * import { initTraceTestRun } from '@smoothbricks/lmao/testing/vitest';
+ * initTraceTestRun(myOpContext, { sqlite: { dbPath: '.trace-results.db' } });
+ *
+ * // my-test.test.ts
+ * import { describe, it, expect, useTestSpan } from '@smoothbricks/lmao/testing/vitest';
+ * ```
+ *
+ * @module testing/vitest
+ */
+import { afterAll as _afterAll, afterEach as _afterEach, beforeAll as _beforeAll, beforeEach as _beforeEach, expect as _expect } from 'vitest';
+import type { SpanContext } from '../opContext/spanContextTypes.js';
+import type { OpContextBinding, OpContextOf } from '../opContext/types.js';
+import type { AsyncSQLiteDatabase, SyncSQLiteDatabase } from '../sqlite/sqlite-db.js';
+import type { SQLiteWriterConfig } from '../sqlite/sqlite-writer.js';
+import { Tracer } from '../tracer.js';
+type TestBody = () => unknown | Promise<unknown>;
+type SpanCtx<B extends OpContextBinding> = SpanContext<OpContextOf<B>>;
+type VitestDescribeCallback = () => void;
+type VitestDescribeBranch = (name: string, fn: VitestDescribeCallback) => unknown;
+type VitestPublicTestCallback = () => void | Promise<void>;
+type VitestPublicTestBranch = (name: string, fn: VitestPublicTestCallback) => unknown;
+type VitestModuleIt = ((name: string, fn: TestBody) => unknown) & {
+    skip: (name: string, fn: VitestPublicTestCallback) => unknown;
+    only: (name: string, fn: VitestPublicTestCallback) => unknown;
+    todo: (name: string, fn: VitestPublicTestCallback) => unknown;
+    each: VitestEach;
+    skipIf: (condition: boolean) => (name: string, fn: VitestPublicTestCallback) => unknown;
+};
+type VitestEach = (...args: unknown[]) => unknown;
+export type VitestDescribe = VitestDescribeBranch & {
+    skip: VitestDescribeBranch;
+    only: VitestDescribeBranch;
+    todo: VitestDescribeBranch;
+    each: VitestEach;
+    skipIf: (condition: boolean) => VitestDescribeBranch;
+};
+export type VitestIt = VitestPublicTestBranch & {
+    skip: VitestPublicTestBranch;
+    only: VitestPublicTestBranch;
+    todo: VitestPublicTestBranch;
+    each: VitestEach;
+    skipIf: (condition: boolean) => VitestPublicTestBranch;
+};
+export interface VitestModuleShape {
+    describe: VitestDescribe;
+    it: VitestModuleIt;
+    test: VitestModuleIt;
+    [key: string]: unknown;
+}
+type SpanContextStore<Ctx> = {
+    run<R>(ctx: Ctx, fn: () => R): R;
+    getStore(): Ctx | undefined;
+};
+type SQLiteRuntimeConfig = SQLiteWriterConfig & ({
+    /** Node/bun style synchronous SQLite driver (for example better-sqlite3). */
+    createDatabase: (path: string) => SyncSQLiteDatabase;
+    createAsyncDatabase?: never;
+} | {
+    /** Async SQLite driver (for example Cloudflare D1 adapter). */
+    createAsyncDatabase: (path: string) => AsyncSQLiteDatabase | Promise<AsyncSQLiteDatabase>;
+    createDatabase?: never;
+});
+type InitTraceTestRunOptions = {
+    /**
+     * Optional SQLite persistence target.
+     *
+     * Omit this to run traced tests without DB persistence.
+     */
+    sqlite?: SQLiteRuntimeConfig;
+    /** Optional verbose stdout tracing; defaults to env flag detection. */
+    verbose?: boolean;
+};
+type VitestHarnessConfig<B extends OpContextBinding> = {
+    binding: B;
+    createSpanContextStore?: () => SpanContextStore<SpanCtx<B>>;
+};
+export type VitestTestTracer<B extends OpContextBinding> = {
+    initTraceTestRun(options?: InitTraceTestRunOptions): void;
+    useTestSpan(): SpanCtx<B>;
+    getTracer(): Tracer<B>;
+    createVitestMock<T extends VitestModuleShape>(vitestModule: T): T;
+    describe(name: string, fn: () => void): unknown;
+    it(name: string, fn: () => void | Promise<void>): void;
+};
+export type VitestTestSuiteTracer<B extends OpContextBinding> = {
+    useTestTracer: VitestTestTracer<B>;
+    useTestSpan(): SpanCtx<B>;
+    setupVitestTestSuiteTracing(): void;
+};
+export declare function installVitestTestTracing<B extends OpContextBinding>(tracer: VitestTestTracer<B>, options?: InitTraceTestRunOptions): void;
+export declare function makeVitestTestSuiteTracer<B extends OpContextBinding>(config: VitestHarnessConfig<B>, options?: InitTraceTestRunOptions): VitestTestSuiteTracer<B>;
+export declare function makeVitestTestTracer<B extends OpContextBinding>(config: VitestHarnessConfig<B>): VitestTestTracer<B>;
+/** Initialize the root tracer for the entire vitest run. Call once in setupFiles. */
+export declare function initTraceTestRun<B extends OpContextBinding>(opContext: B, options?: InitTraceTestRunOptions): void;
+/** Get the current span context from AsyncLocalStorage (inside an it() block) */
+export declare function useTestSpan(): SpanContext<OpContextOf<OpContextBinding>>;
+/** Get the root tracer instance */
+export declare function getTracer(): Tracer<OpContextBinding>;
+/**
+ * Create a vitest mock replacement that wraps it()/test()/describe() with trace spans.
+ *
+ * Call this from a vitest setupFile via vi.mock:
+ * ```typescript
+ * vi.mock('vitest', async (importOriginal) => {
+ *   const [mod, { createVitestMock }] = await Promise.all([
+ *     importOriginal(),
+ *     import('@smoothbricks/lmao/testing/vitest'),
+ *   ]);
+ *   return createVitestMock(mod);
+ * });
+ * ```
+ *
+ * @param vitestModule - The original vitest namespace from importOriginal()
+ */
+export declare function createVitestMock<T extends VitestModuleShape>(vitestModule: T): T;
+export declare const describe: VitestDescribe;
+export declare const it: VitestIt;
+export { _afterAll as afterAll, _afterEach as afterEach, _beforeAll as beforeAll, _beforeEach as beforeEach, _expect as expect, };
+//# sourceMappingURL=vitest-harness.d.ts.map

package/dist/lib/testing/vitest-harness.d.ts.map

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