@reckona/mreact-test-utils 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tatsuo Kaniwa
+
+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,33 @@
+# @reckona/mreact-test-utils
+
+`@reckona/mreact-test-utils` provides compact integration-test helpers for the
+mreact app router. It wraps temporary app directories, build artifacts, request
+helpers, and HTML assertions.
+
+## Basic Usage
+
+```ts
+import { createAppFixture, responseText } from "@reckona/mreact-test-utils";
+
+const fixture = await createAppFixture({
+  files: {
+    "page.tsx": "export default function Page() { return <main>Hello</main>; }",
+  },
+});
+
+const response = await fixture.render("/");
+const html = await responseText(response);
+```
+
+## Core APIs
+
+- `createAppFixture()` creates a temporary app and `.mreact/` build output.
+- `fixture.render()` sends requests through the router using `Request` / `Response`.
+- `fixture.write()` adds or updates route files in the fixture app.
+- `responseText()` reads a response body as a string.
+
+## Use Cases
+
+Use this package for scenario tests that cross router, query, auth, forms, and
+server-action boundaries. Because this repository is a public library, test
+scenario names should be specific and written in English.

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { type RenderAppRequestOptions } from "@reckona/mreact-router";
+export interface AppFixture {
+    readonly appDir: string;
+    render(path: string, options?: AppFixtureRenderOptions | undefined): Promise<Response>;
+    write(path: string, contents: string): Promise<void>;
+}
+export type AppFixtureRenderOptions = Omit<RenderAppRequestOptions, "appDir" | "request"> & {
+    request?: RequestInit | undefined;
+    origin?: string | undefined;
+};
+export interface DehydratedQueryState {
+    queries: Array<{
+        data: unknown;
+        queryHash: string;
+        queryKey: readonly unknown[];
+        updatedAt: number;
+    }>;
+}
+export declare function createAppFixture(prefix?: string): Promise<AppFixture>;
+export declare function responseText(response: Response): Promise<string>;
+export declare function readQueryState(html: string): DehydratedQueryState | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAExF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG;IAC1F,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAKD,wBAAsB,gBAAgB,CAAC,MAAM,SAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyBzF;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAQ7E"}

package/dist/index.js

@@ -0,0 +1,47 @@
+import { mkdir, mkdtemp, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { renderAppRequest } from "@reckona/mreact-router";
+const queryStateScriptPattern = /<script\b[^>]*\bid=(?:"__mreact_query_state"|'__mreact_query_state')[^>]*>([\s\S]*?)<\/script>/i;
+export async function createAppFixture(prefix = "mreact-app-fixture") {
+    const appDir = await mkdtemp(join(tmpdir(), `${prefix}-`));
+    return {
+        appDir,
+        render(path, options = {}) {
+            const origin = options.origin ?? "http://local.test";
+            const request = new Request(new URL(path, origin), options.request);
+            const { origin: _origin, request: _request, ...routerOptions } = options;
+            void _origin;
+            void _request;
+            return renderAppRequest({
+                ...routerOptions,
+                appDir,
+                request,
+            });
+        },
+        async write(path, contents) {
+            const file = join(appDir, path);
+            await mkdir(dirname(file), { recursive: true });
+            await writeFile(file, contents);
+        },
+    };
+}
+export async function responseText(response) {
+    return response.text();
+}
+export function readQueryState(html) {
+    const encoded = queryStateScriptPattern.exec(html)?.[1];
+    if (encoded === undefined) {
+        return undefined;
+    }
+    return JSON.parse(unescapeJsonForHtml(encoded));
+}
+function unescapeJsonForHtml(value) {
+    return value
+        .replaceAll("\\u003c", "<")
+        .replaceAll("\\u003e", ">")
+        .replaceAll("\\u0026", "&")
+        .replaceAll("\\u2028", "\u2028")
+        .replaceAll("\\u2029", "\u2029");
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAgC,MAAM,wBAAwB,CAAC;AAsBxF,MAAM,uBAAuB,GAC3B,iGAAiG,CAAC;AAEpG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAM,GAAG,oBAAoB;IAClE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;IAE3D,OAAO;QACL,MAAM;QACN,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE;YACvB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,mBAAmB,CAAC;YACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACpE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;YAEzE,KAAK,OAAO,CAAC;YACb,KAAK,QAAQ,CAAC;YAEd,OAAO,gBAAgB,CAAC;gBACtB,GAAG,aAAa;gBAChB,MAAM;gBACN,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ;YACxB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAChC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAkB;IACnD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAExD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAyB,CAAC;AAC1E,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK;SACT,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC;SAC1B,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC;SAC1B,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC;SAC1B,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC;SAC/B,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@reckona/mreact-test-utils",
+  "version": "0.0.1",
+  "description": "Integration test helpers for mreact app-router applications.",
+  "keywords": [
+    "fixtures",
+    "jsx",
+    "mreact",
+    "router",
+    "testing",
+    "typescript"
+  ],
+  "homepage": "https://github.com/t-k/mreact/tree/main/packages/test-utils#readme",
+  "bugs": {
+    "url": "https://github.com/t-k/mreact/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/t-k/mreact.git",
+    "directory": "packages/test-utils"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@reckona/mreact-router": "0.0.1"
+  }
+}