@intent-framework/testing 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mahyar
+
+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/dist/index.d.ts

@@ -0,0 +1,24 @@
+import type { ScreenDefinition, DefaultScreenServices } from "@intent-framework/core";
+export type ScreenHandle<TServices extends object = DefaultScreenServices> = {
+    act(label: string): {
+        toBeEnabled(): void;
+        toBeBlocked(): void;
+        toBeBlockedBy(...reasons: string[]): void;
+        run(): Promise<void>;
+    };
+    answer(label: string, value: string): Promise<void>;
+    feedback(): string | null;
+    state(): ScreenDefinition<TServices>;
+    resource(name: string): {
+        status(): string;
+        load(): Promise<void>;
+        reload(): Promise<void>;
+        invalidate(): void;
+        stale(): boolean;
+    };
+    start(): Promise<void>;
+};
+export type TestScreenOptions<TServices extends object = DefaultScreenServices> = {
+    services?: TServices;
+};
+export declare function testScreen<TServices extends object = DefaultScreenServices>(name: string | ScreenDefinition<TServices>, fn: (screen: ScreenHandle<TServices>) => Promise<void>, options?: TestScreenOptions<TServices>): Promise<void>;

package/dist/index.js

@@ -0,0 +1,75 @@
+import { createScreenRuntime } from "@intent-framework/core";
+
+//#region src/index.ts
+async function testScreen(name, fn, options) {
+	const screenDef = typeof name === "string" ? {
+		name,
+		asks: [],
+		acts: [],
+		flows: [],
+		surfaces: [],
+		resources: []
+	} : name;
+	const runtime = createScreenRuntime(screenDef, { services: options?.services });
+	const handle = {
+		act(label) {
+			const actNode = screenDef.acts.find((a) => a.label.toLowerCase() === label.toLowerCase());
+			if (!actNode) throw new Error(`Act "${label}" not found. Available acts: ${screenDef.acts.map((a) => a.label).join(", ")}`);
+			return {
+				toBeEnabled() {
+					if (!actNode.enabled.current) {
+						const reasons = actNode.blockedReasons.length > 0 ? actNode.blockedReasons : actNode.conditions.filter((c) => !c.check()).map((_) => "condition not met");
+						throw new Error(`Expected act "${label}" to be enabled but it was blocked.\n  Reasons: ${reasons.join(", ")}`);
+					}
+				},
+				toBeBlocked() {
+					if (actNode.enabled.current) throw new Error(`Expected act "${label}" to be blocked but it was enabled.`);
+				},
+				toBeBlockedBy(...reasons) {
+					if (actNode.enabled.current) throw new Error(`Expected act "${label}" to be blocked by "${reasons.join(", ")}" but it was enabled.`);
+					const actualReasons = actNode.blockedReasons;
+					for (const reason of reasons) if (!actualReasons.includes(reason)) throw new Error(`Expected act "${label}" to be blocked by "${reason}" but blocked reasons were: ${JSON.stringify(actualReasons)}`);
+				},
+				async run() {
+					await runtime.executeAct(actNode);
+				}
+			};
+		},
+		async answer(label, value) {
+			const askNode = screenDef.asks.find((a) => a.label.toLowerCase() === label.toLowerCase());
+			if (!askNode) throw new Error(`Ask "${label}" not found. Available asks: ${screenDef.asks.map((a) => a.label).join(", ")}`);
+			const stateObj = askNode.state;
+			if (typeof stateObj.set === "function") stateObj.set(value);
+		},
+		resource(name$1) {
+			const resourceNode = runtime.resources.find((r) => r.name.toLowerCase() === name$1.toLowerCase());
+			if (!resourceNode) throw new Error(`Resource "${name$1}" not found. Available resources: ${runtime.resources.map((r) => r.name).join(", ")}`);
+			return {
+				status: () => resourceNode.status,
+				load: () => resourceNode.load(runtime.getExecutionContext()),
+				reload: () => resourceNode.reload(runtime.getExecutionContext()),
+				invalidate: () => resourceNode.invalidate(),
+				stale: () => resourceNode.stale.current
+			};
+		},
+		feedback() {
+			const actWithFeedback = screenDef.acts.find((a) => a.statusMessage !== null);
+			return actWithFeedback?.statusMessage ?? null;
+		},
+		state() {
+			return screenDef;
+		},
+		start() {
+			return runtime.start();
+		}
+	};
+	await runtime.start();
+	try {
+		await fn(handle);
+	} finally {
+		runtime.dispose();
+	}
+}
+
+//#endregion
+export { testScreen };

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@intent-framework/testing",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.0-alpha.0",
+  "description": "Semantic test harness for Intent screens",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intent-framework/intent.git",
+    "directory": "packages/testing"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@intent-framework/core": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc -b",
+    "lint": "tsc -b"
+  }
+}