@coexist/testing 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Coaction
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# @coexist/testing
+
+> Testing helper facade for [Coexist](../../README.md). Re-exports `testApp` and its types from [`@coexist/core`](../core) under a dedicated, intention-revealing import for test files.
+
+Importing `testApp` from `@coexist/testing` keeps test setup separate from production imports. The behavior is identical to `@coexist/core`'s `testApp`.
+
+## Installation
+
+```sh
+pnpm add -D @coexist/testing
+```
+
+## Usage
+
+```ts
+import { afterEach, describe, expect, it } from "vitest";
+import { defineModule, provide } from "@coexist/core";
+import { testApp, type TestApp } from "@coexist/testing";
+
+abstract class Logger {
+  abstract info(message: string): void;
+}
+
+class MemoryLogger implements Logger {
+  readonly messages: string[] = [];
+  info(message: string): void {
+    this.messages.push(message);
+  }
+}
+
+class Counter {
+  count = 0;
+  constructor(readonly logger: Logger) {}
+  increase(step = 1): void {
+    this.count += step;
+    this.logger.info(`count:${this.count}`);
+  }
+}
+
+defineModule(Counter, {
+  actions: ["increase"],
+  deps: [Logger],
+  name: "counter",
+  state: ["count"],
+});
+
+let app: TestApp | undefined;
+
+afterEach(async () => {
+  await app?.dispose();
+  app = undefined;
+});
+
+describe("Counter", () => {
+  it("records actions and overrides providers", () => {
+    const logger = new MemoryLogger();
+    app = testApp({
+      providers: [Counter, provide(Logger, { useValue: console })],
+      overrides: [provide(Logger, { useValue: logger })],
+      strictActions: true,
+    });
+
+    app.getModule(Counter).increase(2);
+
+    expect(logger.messages).toEqual(["count:2"]);
+    expect(app.test.getActions()).toMatchObject([{ method: "increase", module: "counter" }]);
+    expect(app.test.getState()).toEqual({ counter: { count: 2 } });
+  });
+});
+```
+
+## API
+
+`testApp(options)` is overloaded:
+
+- `testApp(options?)` → `TestApp` (synchronous).
+- `testApp({ autoStart: true, ... })` → `Promise<TestApp>` (resolves after `start()`).
+
+Options extend `createApp` options with:
+
+| Option          | Type              | Description                                                                      |
+| --------------- | ----------------- | -------------------------------------------------------------------------------- |
+| `overrides`     | `ProviderInput[]` | Replace providers discovered from `providers`. Cannot add a brand-new `@Module`. |
+| `autoStart`     | `boolean`         | Start the app and return a promise.                                              |
+| `strictActions` | `boolean`         | Enforce action boundaries on all state writes.                                   |
+
+The `app.test` inspector exposes `getActions()`, `getState()`, `getPatches()`, `clearActions()`, `clearPatches()`, and `flushEffects()`.
+
+## Exports
+
+`testApp`, and the `TestApp`, `TestAppOptions`, `AutoStartedTestAppOptions`, `ManualTestAppOptions` types.
+
+## License
+
+[MIT](../../LICENSE) © Coaction

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { AutoStartedTestAppOptions, ManualTestAppOptions, TestApp, TestAppOptions, testApp } from "@coexist/core";
+export { type AutoStartedTestAppOptions, type ManualTestAppOptions, type TestApp, type TestAppOptions, testApp };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { testApp } from "@coexist/core";
+export { testApp };

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@coexist/testing",
+  "version": "0.2.0",
+  "description": "Testing helpers for Coexist.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coactionjs/coexist.git",
+    "directory": "packages/testing"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@coexist/core": "0.2.0"
+  },
+  "devDependencies": {
+    "tsdown": "0.22.3",
+    "typescript": "6.0.3",
+    "vitest": "4.1.9",
+    "@coexist/tsconfig": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf coverage dist .turbo",
+    "dev": "tsdown --watch",
+    "test": "cd ../.. && vitest run --project @coexist/testing",
+    "test:coverage": "cd ../.. && vitest run --coverage --project @coexist/testing",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}