@overkill-dev/engine 0.0.1 → 0.0.2

package/engine/test-plan.js

@@ -0,0 +1,115 @@
+import { caseIdentityKey, createCaseId, formatCaseId } from "./identity.js";
+import { ensureOwnedTestNode, mergeMetadata } from "./test-node.js";
+function collectTestCase(testCase, suitePath, metadata) {
+    const resolvedMetadata = mergeMetadata(metadata, testCase.metadata);
+    return {
+        cases: [
+            {
+                body: testCase.body,
+                id: createCaseId(suitePath, testCase.name, null),
+                metadata: resolvedMetadata,
+                suitePath
+            }
+        ],
+        reachedNodes: [testCase]
+    };
+}
+function collectTable(table, suitePath, metadata) {
+    if (table.cases.length === 0) {
+        throw new TypeError(`Table must contain at least one case: ${[...suitePath, table.name].join(' > ')}.`);
+    }
+    const tablePath = [...suitePath, table.name];
+    const tableMetadata = mergeMetadata(metadata, table.metadata);
+    return {
+        cases: table.cases.map(function collectTableCase(tableCase) {
+            const resolvedMetadata = mergeMetadata(tableMetadata, tableCase.metadata);
+            return {
+                body: tableCase.body,
+                id: createCaseId(tablePath, tableCase.name, null),
+                metadata: resolvedMetadata,
+                suitePath: tablePath
+            };
+        }),
+        reachedNodes: [table]
+    };
+}
+function mergeCollectedTestCases(collections) {
+    return {
+        cases: collections.flatMap(function collectCases(collection) {
+            return collection.cases;
+        }),
+        reachedNodes: collections.flatMap(function collectReachedNodes(collection) {
+            return collection.reachedNodes;
+        })
+    };
+}
+function collectNode(node, suitePath, metadata) {
+    if (node.kind === 'test') {
+        return collectTestCase(node, suitePath, metadata);
+    }
+    if (node.kind === 'table') {
+        return collectTable(node, suitePath, metadata);
+    }
+    if (node.children.length === 0) {
+        throw new TypeError(`Suite must contain at least one child: ${[...suitePath, node.name].join(' > ')}.`);
+    }
+    const childPath = [...suitePath, node.name];
+    const childMetadata = mergeMetadata(metadata, node.metadata);
+    const children = mergeCollectedTestCases(node.children.map(function collectChild(child) {
+        return collectNode(child, childPath, childMetadata);
+    }));
+    return {
+        cases: children.cases,
+        reachedNodes: [node, ...children.reachedNodes]
+    };
+}
+function toReachedNodeSet(reachedNodes) {
+    return new Set(reachedNodes);
+}
+function createOrphanedNode(node) {
+    return {
+        file: null,
+        kind: node.kind,
+        name: node.name
+    };
+}
+function collectOrphans(constructedNodes, reachedNodes) {
+    const reachedNodeSet = toReachedNodeSet(reachedNodes);
+    return Array
+        .from(constructedNodes)
+        .filter(function isOrphan(node) {
+        return !reachedNodeSet.has(node);
+    })
+        .map(createOrphanedNode);
+}
+function assertUniqueCaseIds(cases) {
+    const seenCaseIds = new Set();
+    for (const testCase of cases) {
+        const key = caseIdentityKey(testCase.id);
+        if (seenCaseIds.has(key)) {
+            throw new TypeError(`Duplicate test case identity: ${formatCaseId(testCase.id)}.`);
+        }
+        seenCaseIds.add(key);
+    }
+}
+function assertNonEmptyCases(cases) {
+    if (cases.length === 0) {
+        throw new TypeError('Test plan must contain at least one executable test case.');
+    }
+}
+export function createTestPlanFactory(owner, constructedNodes) {
+    return function createTestPlan(root) {
+        ensureOwnedTestNode(root, owner, 'Test plan root must be an engine-created TestNode value.', 'Test plan root must be created by the same engine instance.');
+        const collection = collectNode(root, [], {});
+        const { cases: discoveredCases, reachedNodes } = collection;
+        assertNonEmptyCases(discoveredCases);
+        assertUniqueCaseIds(discoveredCases);
+        return {
+            cases: discoveredCases,
+            defined: constructedNodes.size,
+            discoveredCases,
+            orphans: collectOrphans(constructedNodes, reachedNodes)
+        };
+    };
+}
+//# sourceMappingURL=test-plan.js.map

package/engine/test-plan.js.map

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

package/package.json

@@ -1,7 +1,79 @@
 {
-  "name": "@overkill-dev/engine",
-  "version": "0.0.1",
-  "description": "Placeholder claiming the npm package name \"@overkill-dev/engine\" so a trusted publisher can be configured. See https://github.com/npm/cli/issues/8544.",
-  "license": "MIT",
-  "deprecated": "Placeholder published as a workaround so a Trusted Publisher could be configured. See https://github.com/npm/cli/issues/8544."
-}
+    "author": "Christian Rackerseder <git@echooff.de>",
+    "bugs": {
+        "url": "https://github.com/enormora/overkill/issues"
+    },
+    "dependencies": {
+        "@enormora/wall-clock": "0.0.3",
+        "diff": "9.0.0"
+    },
+    "description": "Core Overkill engine primitives and execution model.",
+    "engines": {
+        "node": "^26"
+    },
+    "exports": {
+        ".": {
+            "import": "./packages/engine/engine.entry-point.js",
+            "types": "./packages/engine/engine.entry-point.d.ts"
+        },
+        "./assertion-protocol/assertion-node-shape.d.ts": {
+            "types": "./assertion-protocol/assertion-node-shape.d.ts"
+        },
+        "./assertion-protocol/assertion-node.js": {
+            "import": "./assertion-protocol/assertion-node.js",
+            "types": "./assertion-protocol/assertion-node.d.ts"
+        },
+        "./assertion-protocol/assertion-reference.js": {
+            "import": "./assertion-protocol/assertion-reference.js",
+            "types": "./assertion-protocol/assertion-reference.d.ts"
+        },
+        "./assertion-protocol/thrown-error-record.js": {
+            "import": "./assertion-protocol/thrown-error-record.js",
+            "types": "./assertion-protocol/thrown-error-record.d.ts"
+        },
+        "./assertion-protocol/thrown-matcher.js": {
+            "import": "./assertion-protocol/thrown-matcher.js",
+            "types": "./assertion-protocol/thrown-matcher.d.ts"
+        },
+        "./compare/serialized-value.js": {
+            "import": "./compare/serialized-value.js",
+            "types": "./compare/serialized-value.d.ts"
+        },
+        "./engine/identity.js": {
+            "import": "./engine/identity.js",
+            "types": "./engine/identity.d.ts"
+        },
+        "./engine/reporter.js": {
+            "import": "./engine/reporter.js",
+            "types": "./engine/reporter.d.ts"
+        },
+        "./engine/run-result.js": {
+            "import": "./engine/run-result.js",
+            "types": "./engine/run-result.d.ts"
+        },
+        "./packages/engine/assertion-protocol.entry-point.js": {
+            "import": "./packages/engine/assertion-protocol.entry-point.js",
+            "types": "./packages/engine/assertion-protocol.entry-point.d.ts"
+        }
+    },
+    "homepage": "https://github.com/enormora/overkill#readme",
+    "keywords": [
+        "tdd",
+        "test",
+        "tests"
+    ],
+    "license": "MIT",
+    "name": "@overkill-dev/engine",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/enormora/overkill.git"
+    },
+    "sideEffects": [
+        "./assertion-protocol/assertion-reference.js",
+        "./engine/execution.js",
+        "./engine/run-if-main.js",
+        "./packages/engine/engine.entry-point.js"
+    ],
+    "type": "module",
+    "version": "0.0.2"
+}

package/packages/engine/assertion-protocol.entry-point.d.ts

@@ -0,0 +1,9 @@
+export type { AssertCompositeAssertionReturn, AssertionReference, AssertionReferenceRecord, AssertReferenceArguments, AssertReferenceReturn, CompositeAssertionGroup, CompositeAssertionReference, CompositeAssertionReferenceRecord, CompositeAssertionReturn, CompositeAssertionRunnerInput, CompositeAssertionSummaryContext, CompositeAssertionSummaryFormatter, NarrowingCompositeAssertionReference, NarrowingCompositeAssertionReferenceRecord, NarrowingCompositeAssertionSummaryFormatter } from '../../assertion-protocol/assertion-reference.ts';
+export { createCompositeAssertionGroup, createCompositeAssertionReferenceRecord, createNarrowingCompositeAssertionReferenceRecord, getAssertionReferenceRecord, getCompositeAssertionReferenceRecord, getNarrowingAssertionReferenceRecord, isAssertionReference, isCompositeAssertionGroup, isNarrowingAssertionReference } from '../../assertion-protocol/assertion-reference.ts';
+export type { AssertAssertionNode, BuiltInAssertAssertionNode, CompositeAssertionChildNode, CompositeAssertionNode, ForeignAssertionNode, ForeignAssertionResult, RequireAssertionNode } from '../../assertion-protocol/assertion-node.ts';
+export type { AssertionOptions, AssertionSource, DeepComparable, FailedCheck, FailedCompositeCheck, FailedForeignCheck, FailedLeafCheck, InstanceConstructor, NonEmptyReadonlyArray, ResolvableSourceLocation, SourceLocation, SourceLocationProvider } from '../../assertion-protocol/assertion-node-shape.ts';
+export type { ErrorMatcher, ExactThrownMatcher, SynchronousCallback, ThrownAssertionObservation, ThrownMatcher } from '../../assertion-protocol/thrown-matcher.ts';
+export { thrownMatcherChildren } from '../../assertion-protocol/thrown-matcher.ts';
+export type { ThrownErrorRecord } from '../../assertion-protocol/thrown-error-record.ts';
+export { createThrownErrorRecord } from '../../assertion-protocol/thrown-error-record.ts';
+//# sourceMappingURL=assertion-protocol.entry-point.d.ts.map

package/packages/engine/assertion-protocol.entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-protocol.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/engine/assertion-protocol.entry-point.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,8BAA8B,EAC9B,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,iCAAiC,EACjC,wBAAwB,EACxB,6BAA6B,EAC7B,gCAAgC,EAChC,kCAAkC,EAClC,oCAAoC,EACpC,0CAA0C,EAC1C,2CAA2C,EAC9C,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACH,6BAA6B,EAC7B,uCAAuC,EACvC,gDAAgD,EAChD,2BAA2B,EAC3B,oCAAoC,EACpC,oCAAoC,EACpC,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,EAChC,MAAM,iDAAiD,CAAC;AACzD,YAAY,EACR,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACvB,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACR,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,sBAAsB,EACzB,MAAM,kDAAkD,CAAC;AAC1D,YAAY,EACR,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,aAAa,EAChB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC"}

package/packages/engine/assertion-protocol.entry-point.js

@@ -0,0 +1,4 @@
+export { createCompositeAssertionGroup, createCompositeAssertionReferenceRecord, createNarrowingCompositeAssertionReferenceRecord, getAssertionReferenceRecord, getCompositeAssertionReferenceRecord, getNarrowingAssertionReferenceRecord, isAssertionReference, isCompositeAssertionGroup, isNarrowingAssertionReference } from "../../assertion-protocol/assertion-reference.js";
+export { thrownMatcherChildren } from "../../assertion-protocol/thrown-matcher.js";
+export { createThrownErrorRecord } from "../../assertion-protocol/thrown-error-record.js";
+//# sourceMappingURL=assertion-protocol.entry-point.js.map

package/packages/engine/assertion-protocol.entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-protocol.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/engine/assertion-protocol.entry-point.ts"],"names":[],"mappings":"AAiBA,OAAO,EACH,6BAA6B,EAC7B,uCAAuC,EACvC,gDAAgD,EAChD,2BAA2B,EAC3B,oCAAoC,EACpC,oCAAoC,EACpC,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,EAChC,MAAM,iDAAiD,CAAC;AA+BzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAEnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC"}

package/packages/engine/engine.entry-point.d.ts

@@ -0,0 +1,39 @@
+import { type Engine } from '../../engine/engine.ts';
+import type { RunIfMainOptions } from '../../engine/run-if-main.ts';
+import type { SuiteOptions, TableOptions, TestCaseOptions, TestNode } from '../../engine/test-node.ts';
+export declare function createEngine(): Engine;
+export declare function createSuite(options: SuiteOptions): ReturnType<Engine['createSuite']>;
+export declare function createTable(options: TableOptions): ReturnType<Engine['createTable']>;
+export declare function createTestCase(options: TestCaseOptions): ReturnType<Engine['createTestCase']>;
+export declare function createTestPlan(root: TestNode): ReturnType<Engine['createTestPlan']>;
+export declare function execute(testPlan: Parameters<Engine['execute']>[0], options?: Parameters<Engine['execute']>[1]): ReturnType<Engine['execute']>;
+export declare function runIfMain(meta: Readonly<ImportMeta>, testNode: TestNode, options?: RunIfMainOptions): Promise<void>;
+export type { Engine } from '../../engine/engine.ts';
+export type { Execute, ExecuteOptions } from '../../engine/execution.ts';
+export type { RunIfMain, RunIfMainOptions } from '../../engine/run-if-main.ts';
+export { formatCaseId } from '../../engine/identity.ts';
+export type { CaseId, TestId } from '../../engine/identity.ts';
+export type { DirectorySinkDeclaration, FileSinkDeclaration, FinalResultReporter, MemorySinkDeclaration, RealTimeReporter, Reporter, ReporterEvent, RunFacts, SinkDeclaration, StandardOutputSinkDeclaration, StreamSinkDeclaration } from '../../engine/reporter.ts';
+export { validateReporterSinks } from '../../engine/reporter.ts';
+export type { AssertAssertionFacade } from '../../engine/assertion-facade.ts';
+export type { RequireAssertionFacade } from '../../engine/require-assertion-facade.ts';
+export type { AssertionOptions, AssertionSource, DeepComparable, FailedCheck, FailedCompositeCheck, FailedForeignCheck, FailedLeafCheck, InstanceConstructor, NonEmptyReadonlyArray, ResolvableSourceLocation, SourceLocationProvider, SourceLocation } from '../../assertion-protocol/assertion-node-shape.ts';
+export type { ArrayDiffOperation, ByteDiffRange, Diff, DiffPathSegment, Hunk, MapDiffOperation, ObjectDiffOperation, SetDiffOperation } from '../../diff/diff-shape.ts';
+export { defaultSerializationBudget, serializeValue, serializeValueWithBudget } from '../../compare/serialized-value.ts';
+export type { SerializationBudget, SerializedMapEntry, SerializedProperty, SerializedPropertyKey, SerializedValue, SerializationTruncation } from '../../compare/serialized-value.ts';
+export { captureSourceLocation, unknownSourceLocation } from '../../assertion-protocol/source-location.ts';
+export type { ErrorMatcher, ExactThrownMatcher, SynchronousCallback, ThrownAssertionObservation, ThrownMatcher } from '../../assertion-protocol/thrown-matcher.ts';
+export type { FalseAssertionNode, TrueAssertionNode } from '../../assertion-protocol/assertions/boolean.ts';
+export type { EmptinessAssertionNode, LengthAssertionNode } from '../../assertion-protocol/assertions/collection.ts';
+export type { DeepEqualAssertionNode, EqualAssertionNode, NotDeepEqualAssertionNode, NotEqualAssertionNode } from '../../assertion-protocol/assertions/equality.ts';
+export type { FailAssertionNode } from '../../assertion-protocol/assertions/fail.ts';
+export type { BetweenAssertionNode, NumericComparisonAssertionNode } from '../../assertion-protocol/assertions/numeric.ts';
+export type { ArrayContainsPartialAssertionNode, MembersPartialDeepEqualAssertionNode, PartialDeepEqualAssertionNode } from '../../assertion-protocol/assertions/partial.ts';
+export type { DefinedAssertionNode, NotNullAssertionNode, NullAssertionNode, UndefinedAssertionNode } from '../../assertion-protocol/assertions/presence.ts';
+export type { MatchAssertionNode, StringContainsAssertionNode } from '../../assertion-protocol/assertions/string.ts';
+export type { HasPropertyAssertionNode, InstanceOfAssertionNode, TypeAssertionNode } from '../../assertion-protocol/assertions/type-shape.ts';
+export type { AssertionTestFailure, BodyErrorTestFailure, FailOutcome, InconclusiveOutcome, OrphanedNode, PassOutcome, PerTestResult, RunResult, RunnerError, RunSummary, SkipOutcome, SuiteRunCounts, TestContractFailure, TestContractFailureCode, TestFailure, TestOutcome } from '../../engine/run-result.ts';
+export type { AssertAssertionNode, AssertionNode, AssertionResult, CompositeAssertionChildNode, CompositeAssertionNode, ForeignAssertionNode, ForeignAssertionResult, RequireAssertionNode } from '../../assertion-protocol/assertion-node.ts';
+export type { TestScopeAssertContext, Metadata, Suite, SuiteOptions, Table, TableCase, TableCaseOptions, TableOptions, TestBody, TestCase, TestCaseOptions, TestScope, TestNode } from '../../engine/test-node.ts';
+export type { TestPlan, TestPlanCase, TestPlanCaseBody } from '../../engine/test-plan.ts';
+//# sourceMappingURL=engine.entry-point.d.ts.map

package/packages/engine/engine.entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/engine/engine.entry-point.ts"],"names":[],"mappings":"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"}

package/packages/engine/engine.entry-point.js

@@ -0,0 +1,47 @@
+import { createWallClock } from '@enormora/wall-clock';
+import { createEngine as createEngineInstance } from "../../engine/engine.js";
+import { createExecute } from "../../engine/execution.js";
+import { createReporterDispatcher } from "../../engine/reporter.js";
+function readProcessExitCode() {
+    return process.exitCode;
+}
+function writeProcessExitCode(exitCode) {
+    process.exitCode = exitCode;
+}
+export function createEngine() {
+    const wallClock = createWallClock();
+    return createEngineInstance({
+        execute: createExecute({
+            reporterDispatcher: createReporterDispatcher({ wallClock }),
+            wallClock
+        }),
+        nodeVersion: process.versions.node,
+        readExitCode: readProcessExitCode,
+        wallClock,
+        writeExitCode: writeProcessExitCode
+    });
+}
+const defaultEngine = createEngine();
+export function createSuite(options) {
+    return defaultEngine.createSuite(options);
+}
+export function createTable(options) {
+    return defaultEngine.createTable(options);
+}
+export function createTestCase(options) {
+    return defaultEngine.createTestCase(options);
+}
+export function createTestPlan(root) {
+    return defaultEngine.createTestPlan(root);
+}
+export async function execute(testPlan, options) {
+    return await defaultEngine.execute(testPlan, options);
+}
+export async function runIfMain(meta, testNode, options) {
+    await defaultEngine.runIfMain(meta, testNode, options);
+}
+export { formatCaseId } from "../../engine/identity.js";
+export { validateReporterSinks } from "../../engine/reporter.js";
+export { defaultSerializationBudget, serializeValue, serializeValueWithBudget } from "../../compare/serialized-value.js";
+export { captureSourceLocation, unknownSourceLocation } from "../../assertion-protocol/source-location.js";
+//# sourceMappingURL=engine.entry-point.js.map

package/packages/engine/engine.entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/engine/engine.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,IAAI,oBAAoB,EAAe,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAIpE,SAAS,mBAAmB;IACxB,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC5B,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB;IAC1C,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY;IACxB,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,OAAO,oBAAoB,CAAC;QACxB,OAAO,EAAE,aAAa,CAAC;YACnB,kBAAkB,EAAE,wBAAwB,CAAC,EAAE,SAAS,EAAE,CAAC;YAC3D,SAAS;SACZ,CAAC;QACF,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;QAClC,YAAY,EAAE,mBAAmB;QACjC,SAAS;QACT,aAAa,EAAE,oBAAoB;KACtC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,aAAa,GAAG,YAAY,EAAE,CAAC;AAErC,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC7C,OAAO,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC7C,OAAO,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAwB;IACnD,OAAO,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAc;IACzC,OAAO,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CACzB,QAA0C,EAC1C,OAA0C;IAE1C,OAAO,MAAM,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,IAA0B,EAC1B,QAAkB,EAClB,OAA0B;IAE1B,MAAM,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAKD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAexD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AA2BjE,OAAO,EACH,0BAA0B,EAC1B,cAAc,EACd,wBAAwB,EAC3B,MAAM,mCAAmC,CAAC;AAS3C,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,6CAA6C,CAAC"}

package/readme.md

@@ -1,7 +1,123 @@
-# @overkill-dev/engine
+# `@overkill-dev/engine`
 
-This version is a placeholder published only to claim the npm name `@overkill-dev/engine` so a Trusted Publisher
-can subsequently be configured for it. It contains no real package content and is published already
-deprecated.
+Core Overkill primitives for defining executable test values and running an already-resolved test plan.
 
-Workaround context: https://github.com/npm/cli/issues/8544
+Top-level API:
+
+- `createTestCase(options)`
+- `createSuite(options)`
+- `createTable(options)`
+- `createTestPlan(root)`
+- `execute(testPlan)`
+- `runIfMain(import.meta, root, options?)`
+- `createEngine()`
+- `formatCaseId(caseId)`
+- `validateReporterSinks(reporters)`
+- `captureSourceLocation()`
+- `unknownSourceLocation`
+- `CaseId`, `TestId`, `TestPlan`, `ExecuteOptions`, `RunIfMainOptions`, `NonEmptyReadonlyArray`, `DeepComparable`
+- `Reporter`, `ReporterEvent`, `RealTimeReporter`, `FinalResultReporter`, `RunFacts`, `SinkDeclaration`
+- `RunResult`, `TestOutcome`, `PassOutcome`, `FailOutcome`, `SkipOutcome`, `InconclusiveOutcome`
+- `AssertionNode`, `AssertionResult`, `AssertAssertionFacade`, `TestScopeAssertContext`
+- `ThrownMatcher`, `ErrorMatcher`, `ExactThrownMatcher`
+- `RequireAssertionFacade`, `FailedCheck`, `TestFailure`, `RunnerError`
+- `Diff`, `DiffPathSegment`, `SerializedValue`, `SerializationBudget`
+
+The top-level constructors share one default engine instance. Use
+`createEngine()` when a collection needs isolated construction state for
+`defined` counts and orphan detection.
+
+Direct Node execution:
+
+```ts
+import { createTestCase, runIfMain } from '@overkill-dev/engine';
+import { createDotReporter } from '@overkill-dev/reporter-dot';
+
+export const spec = createTestCase({
+    body(scope) {
+        scope.assert.true(true, { message: 'passes' });
+        return scope.assert.collect();
+    },
+    metadata: {},
+    name: 'passes'
+});
+
+await runIfMain(import.meta, spec, {
+    reporters: [ createDotReporter() ]
+});
+```
+
+Aggregate direct Node execution:
+
+```ts
+import { createSuite, runIfMain } from '@overkill-dev/engine';
+import { createDotReporter } from '@overkill-dev/reporter-dot';
+import { spec as orders } from './orders.test.ts';
+import { spec as users } from './users.test.ts';
+
+export const spec = createSuite({
+    children: [ users, orders ],
+    metadata: {},
+    name: 'all'
+});
+
+await runIfMain(import.meta, spec, {
+    reporters: [ createDotReporter() ]
+});
+```
+
+Reporter lifecycle:
+
+- `RealTimeReporter` receives `ReporterEvent` values while a run executes.
+  Use it for terminal output, IDE integrations, and other live consumers.
+- `FinalResultReporter` receives the completed `RunResult` once after the
+  run finishes. Use it for reports, archives, and machine-readable output.
+- `dispose` is required and nullable on both reporter lifecycles. When
+  present, `execute()` calls it exactly once after the run or after reporter
+  validation fails.
+- A reporter has one lifecycle. If a package needs both modes, expose two
+  reporters that share the same internal formatting or recording logic.
+
+Reporter sinks:
+
+- `stdout` and `stderr` can be `exclusive` or `shared`.
+- `file`, `directory`, and `stream` sinks are exclusive.
+- `memory` sinks are private to each reporter.
+- `execute()` validates declared sink conflicts before emitting `run-start`.
+
+Assertion bodies:
+
+- `scope.assert.*` records non-gating assertion nodes and continues.
+- `scope.require.*` records narrow gating assertion nodes and short-circuits
+  when one fails.
+- Custom assertions are imported assertion reference values:
+  `scope.assert(resultOk, result)`. Narrowing references may also be used with
+  `scope.require(resultOk, result)`. Define reusable assertion references with
+  `@overkill-dev/assert`.
+- Async custom assertions must be awaited before `scope.assert.collect()`.
+- `scope.assert.throws(body, matcher)` checks synchronous thrown values.
+  Promise-returning callbacks belong to `scope.assert.rejects(...)`.
+- `scope.assert.rejects(thunk, matcher)` checks promise rejections and must be
+  awaited before `scope.assert.collect()`.
+- Thrown matchers are explicit objects. Use `{ exact: value }` for `Object.is`
+  matching, or structured error fields such as `type`, `message`, `code`,
+  `name`, and recursive `cause`. Structured error matchers require at least
+  one field, and a string `message` is exact.
+- `scope.assert.annotated(message).*` and `scope.require.annotated(message).*`
+  record message-scoped checks without positional message overloads.
+- `scope.assert.annotated(message)(reference, ...)` annotates a custom
+  assertion boundary.
+- `scope.assert.collect()` is builder-mode syntax sugar. It returns the
+  non-empty assertion list for the engine to evaluate, and is not part of
+  `AssertAssertionFacade`.
+- `scope.plan(count)` must be the first test-body call and must declare a
+  positive integer assertion count.
+- `FailedCheck` is discriminated by `kind`. Every failed check carries
+  serialized `actual` and `expected` values, a typed mismatch `path`, and
+  `diff: Diff | null`. Leaf checks carry value comparison data, composite
+  checks carry child diagnostics, and foreign checks carry normalized
+  thrown-error data.
+- Failed checks carry concrete source locations. Engine-created assertion
+  nodes capture lazy locations at the public assertion boundary. Direct raw
+  assertion nodes must provide `location`; use `captureSourceLocation()` for
+  accuracy or `unknownSourceLocation` when unavailable.

package/sbom.cdx.json

@@ -0,0 +1,67 @@
+{
+    "$schema": "http://cyclonedx.org/schema/bom-1.6.schema.json",
+    "bomFormat": "CycloneDX",
+    "specVersion": "1.6",
+    "version": 1,
+    "metadata": {
+        "tools": {
+            "components": [
+                {
+                    "type": "application",
+                    "name": "packtory",
+                    "version": "0.0.78"
+                }
+            ]
+        },
+        "component": {
+            "type": "library",
+            "name": "@overkill-dev/engine",
+            "version": "0.0.2",
+            "bom-ref": "pkg:npm/@overkill-dev/engine@0.0.2",
+            "purl": "pkg:npm/@overkill-dev/engine@0.0.2"
+        }
+    },
+    "components": [
+        {
+            "type": "library",
+            "name": "@enormora/wall-clock",
+            "version": "0.0.3",
+            "bom-ref": "pkg:npm/@enormora/wall-clock@0.0.3",
+            "scope": "required",
+            "licenses": [
+                {
+                    "expression": "MIT"
+                }
+            ],
+            "purl": "pkg:npm/@enormora/wall-clock@0.0.3"
+        },
+        {
+            "type": "library",
+            "name": "diff",
+            "version": "9.0.0",
+            "bom-ref": "pkg:npm/diff@9.0.0",
+            "scope": "required",
+            "licenses": [
+                {
+                    "expression": "BSD-3-Clause"
+                }
+            ],
+            "purl": "pkg:npm/diff@9.0.0"
+        }
+    ],
+    "dependencies": [
+        {
+            "ref": "pkg:npm/@enormora/wall-clock@0.0.3"
+        },
+        {
+            "ref": "pkg:npm/@overkill-dev/engine@0.0.2",
+            "dependsOn": [
+                "pkg:npm/@enormora/wall-clock@0.0.3",
+                "pkg:npm/diff@9.0.0"
+            ]
+        },
+        {
+            "ref": "pkg:npm/diff@9.0.0"
+        }
+    ]
+}