ruact 0.0.5 → 0.0.6

data/vendor/javascript/vite-plugin-ruact/server-functions-codegen.test.mjs

@@ -32,147 +32,22 @@ afterEach(() => {
   delete process.env.RUACT_SILENCE_LOG;
 });
 
+// Story 9.9 — the v1 (registry / `_makeRef`) render path was demolished; the
+// base snapshot is now the route-driven (version-2) shape.
 const baseSnapshot = (over = {}) => ({
-  version: 1,
+  version: 2,
   generated_at: "2026-05-13T12:34:56Z",
   functions: [],
   ...over,
 });
 
-describe("Story 8.0a — render()", () => {
-  it("emits empty module when registry JSON has no functions", () => {
-    // Story 8.2 — the empty-registry branch now also emits the
-    // `export { revalidate } from "ruact/server-functions-runtime";`
-    // line so `import { revalidate } from "@/.ruact/server-functions"`
-    // works in projects that have not declared any server actions yet.
-    expect(render(baseSnapshot())).toEqual(
-      [
-        "// AUTO-GENERATED by vite-plugin-ruact (Story 8.0a). DO NOT EDIT.",
-        "// Source: tmp/cache/ruact/server-functions.json (version 1)",
-        "// Generated at: 2026-05-13T12:34:56Z",
-        `import { _makeRef } from "${RUNTIME_IMPORT_SPECIFIER}";`,
-        "",
-        "// (no server functions registered yet — Stories 8.1 / 9.1 populate)",
-        "void _makeRef;",
-        "",
-        `export { revalidate } from "${RUNTIME_IMPORT_SPECIFIER}";`,
-        "",
-      ].join("\n"),
-    );
-  });
-
-  it("references _makeRef via `void` even when empty so noUnusedLocals stays " +
-    "green (Re-run patch 2026-05-13)", () => {
-    expect(render(baseSnapshot())).toContain("void _makeRef;");
-  });
-
-  it("emits the revalidate re-export (Story 8.2) in both empty + populated branches", () => {
-    expect(render(baseSnapshot())).toContain(
-      `export { revalidate } from "${RUNTIME_IMPORT_SPECIFIER}";`,
-    );
-    expect(
-      render(
-        baseSnapshot({
-          functions: [{ ruby_symbol: "create_post", js_identifier: "createPost", kind: "action" }],
-        }),
-      ),
-    ).toContain(`export { revalidate } from "${RUNTIME_IMPORT_SPECIFIER}";`);
-  });
-
-  it("rejects a snapshot entry whose js_identifier is not a valid JS identifier " +
-    "(snapshot trust-boundary guard — Re-run patch 2026-05-13)", () => {
-    const evil = baseSnapshot({
-      functions: [
-        {
-          ruby_symbol: "create_post",
-          js_identifier: ');\nevil();_makeRef("x',
-          kind: "action",
-        },
-      ],
-    });
-    expect(() => render(evil)).toThrow(/valid JS identifier/);
-  });
-
-  it("JSON-escapes ruby_symbol in the _makeRef argument so quotes/backslashes " +
-    "cannot break out (Re-run patch 2026-05-13)", () => {
-    const weird = baseSnapshot({
-      functions: [
-        {
-          ruby_symbol: 'weird"\\name',
-          js_identifier: "weirdName",
-          kind: "action",
-        },
-      ],
-    });
-    // The emitted call site should contain a JSON-escaped string literal.
-    expect(render(weird)).toContain('_makeRef("weird\\"\\\\name");');
-  });
-
-  it("emits one export per registered function", () => {
-    const fns = [
-      { ruby_symbol: "create_post", js_identifier: "createPost", kind: "action" },
-      { ruby_symbol: "delete_post", js_identifier: "deletePost", kind: "action" },
-    ];
-    const out = render(baseSnapshot({ functions: fns }));
-    expect((out.match(/export const /g) || []).length).toBe(2);
-    expect(out).toContain("export const createPost:");
-    expect(out).toContain("export const deletePost:");
-  });
-
-  it("emits action and query exports with identical accessor mechanics " +
-    "(both call _makeRef)", () => {
-    const out = render(
-      baseSnapshot({
-        functions: [
-          { ruby_symbol: "create_post", js_identifier: "createPost", kind: "action" },
-          { ruby_symbol: "categories", js_identifier: "categories", kind: "query" },
-        ],
-      }),
-    );
-    expect(out).toContain(`_makeRef("create_post")`);
-    expect(out).toContain(`_makeRef("categories")`);
-  });
-
-  it("Story 8.2 — action signatures emit the intersection (direct callable + " +
-    "`<form action>`-compatible overload); query signatures stay narrow", () => {
-    // R1 (2026-05-17 review patch): the previous widening to
-    // `(args?: FormData | Record<string, unknown>) => Promise<unknown>`
-    // alone did NOT make `<form action={createPost}>` typecheck against
-    // React 19's `(formData: FormData) => void | Promise<void>` — Promise
-    // generics are invariant. The intersection adds a second
-    // `(formData: FormData) => Promise<void>` signature so the same export
-    // satisfies both call sites.
-    const out = render(
-      baseSnapshot({
-        functions: [
-          { ruby_symbol: "create_post", js_identifier: "createPost", kind: "action" },
-          { ruby_symbol: "categories", js_identifier: "categories", kind: "query" },
-        ],
-      }),
-    );
-    expect(out).toContain(
-      "export const createPost: ((args?: FormData | Record<string, unknown>) => Promise<unknown>) & ((formData: FormData) => Promise<void>) =",
-    );
-    expect(out).toContain("export const categories: () => Promise<unknown> =");
-  });
-
-  it("Story 8.2 — query signatures do NOT widen (regression guard against accidental " +
-    "carry-over of the action widening)", () => {
-    const out = render(
-      baseSnapshot({
-        functions: [{ ruby_symbol: "categories", js_identifier: "categories", kind: "query" }],
-      }),
-    );
-    // The literal action-style FormData union must NOT appear next to a query export.
-    expect(out).not.toMatch(/export const categories:[^=]*FormData/);
-    expect(out).toContain("export const categories: () => Promise<unknown> =");
-  });
-
-  it("ends with exactly one trailing newline", () => {
-    const out = render(baseSnapshot());
-    expect(out.endsWith("\n")).toBe(true);
-    expect(out.endsWith("\n\n")).toBe(false);
-  });
+const v2ActionEntry = (over = {}) => ({
+  js_identifier: "demoPing",
+  kind: "action",
+  http_method: "POST",
+  path: "/demo_ping",
+  segments: [],
+  ...over,
 });
 
 describe("Story 8.0a — writeIfChanged()", () => {
@@ -224,7 +99,7 @@ describe("Story 8.0a — generateOnce()", () => {
       snapshotJson,
       JSON.stringify(
         baseSnapshot({
-          functions: [{ ruby_symbol: "demo_ping", js_identifier: "demoPing", kind: "action" }],
+          functions: [v2ActionEntry()],
         }),
       ),
     );
@@ -429,9 +304,9 @@ describe("Story 8.0a — installServerFunctionsHooks() composition", () => {
   });
 });
 
-describe("Story 8.0a — snapshot validation (Chunk 2 M1 — trust-boundary guards)", () => {
+describe("snapshot validation — version-agnostic metadata guards (trust boundary)", () => {
   it("rejects snapshot whose version contains a newline (would break out of comment)", () => {
-    const evil = baseSnapshot({ version: "1\n// injected" });
+    const evil = baseSnapshot({ version: "2\n// injected" });
     expect(() => render(evil)).toThrow(/version.*line break|line break.*version/i);
   });
 
@@ -440,86 +315,28 @@ describe("Story 8.0a — snapshot validation (Chunk 2 M1 — trust-boundary guar
     expect(() => render(evil)).toThrow(/generated_at.*line break|line break.*generated_at/i);
   });
 
-  it("rejects snapshot whose functions field is not an array", () => {
-    const evil = baseSnapshot({ functions: "oops2
// injected" });
-    expect(() => render(evil)).toThrow(/functions.*array/);
-  });
-
-  it("rejects snapshot entry with unknown kind", () => {
-    const evil = baseSnapshot({
-      functions: [{ ruby_symbol: "foo", js_identifier: "foo", kind: "mutation" }],
-    });
-    expect(() => render(evil)).toThrow(/invalid kind/);
-  });
-
-  it("rejects snapshot with duplicate js_identifier entries", () => {
-    const evil = baseSnapshot({
-      functions: [
-        { ruby_symbol: "foo", js_identifier: "foo", kind: "action" },
-        { ruby_symbol: "bar", js_identifier: "foo", kind: "query" },
-      ],
-    });
-    expect(() => render(evil)).toThrow(/duplicate js_identifier "foo"/);
-  });
-
-  it("rejects snapshot entry whose js_identifier is a JS reserved word", () => {
-    const evil = baseSnapshot({
-      functions: [{ ruby_symbol: "delete", js_identifier: "delete", kind: "action" }],
-    });
-    expect(() => render(evil)).toThrow(/reserved JS word/);
-  });
-
-  it("R12 — rejects snapshot entry whose js_identifier is reserved by ruact " +
-    "(`revalidate` — would clash with the helper re-export)", () => {
-    const evil = baseSnapshot({
-      functions: [{ ruby_symbol: "revalidate", js_identifier: "revalidate", kind: "action" }],
-    });
-    expect(() => render(evil)).toThrow(/reserved by the ruact runtime\/codegen surface/);
-  });
-
-  it("R12 — rejects snapshot entry whose js_identifier is `_makeRef` " +
-    "(would clash with the codegen's runtime import)", () => {
-    const evil = baseSnapshot({
-      functions: [{ ruby_symbol: "make_ref", js_identifier: "_makeRef", kind: "action" }],
-    });
-    expect(() => render(evil)).toThrow(/reserved by the ruact runtime\/codegen surface/);
-  });
-
-  it("rejects snapshot whose version contains U+2028 LINE SEPARATOR " +
-    "(Pass-2 patch 2026-05-14 — JS LineTerminator parity)", () => {
-    const evil = baseSnapshot({ version: "1
// injected" });
+  it("rejects snapshot whose version contains U+2028 LINE SEPARATOR (JS LineTerminator parity)", () => {
+    const evil = baseSnapshot({ version: "2
// injected" });
     expect(() => render(evil)).toThrow(/U\+2028/);
   });
 
-  it("rejects snapshot whose generated_at contains U+2029 PARAGRAPH SEPARATOR " +
-    "(Pass-2 patch 2026-05-14)", () => {
+  it("rejects snapshot whose generated_at contains U+2029 PARAGRAPH SEPARATOR", () => {
     const evil = baseSnapshot({ generated_at: "2026-05-14
// injected" });
     expect(() => render(evil)).toThrow(/U\+2029/);
   });
 
-  it("rejects snapshot missing a root key (Pass-2 patch 2026-05-14)", () => {
+  it("rejects snapshot missing a root key", () => {
     const evil = { generated_at: "x", functions: [] }; // no version
     expect(() => render(evil)).toThrow(/missing required key "version"/);
   });
 
-  it("rejects entry with empty ruby_symbol so we never emit _makeRef(\"\") " +
-    "(Pass-2 patch 2026-05-14)", () => {
-    const evil = baseSnapshot({
-      functions: [{ ruby_symbol: "", js_identifier: "foo", kind: "action" }],
-    });
-    expect(() => render(evil)).toThrow(/missing or empty ruby_symbol/);
-  });
-
-  it("rejects entry with missing ruby_symbol field (Pass-2 patch 2026-05-14)", () => {
-    const evil = baseSnapshot({
-      functions: [{ js_identifier: "foo", kind: "action" }],
-    });
-    expect(() => render(evil)).toThrow(/missing or empty ruby_symbol/);
+  it("rejects when snapshot itself is not an object (e.g., an array)", () => {
+    expect(() => render([])).toThrow(/snapshot is not an object/);
   });
 
-  it("rejects when snapshot itself is not an object (e.g., an array) " +
-    "(Pass-2 patch 2026-05-14)", () => {
-    expect(() => render([])).toThrow(/snapshot is not an object/);
+  it("rejects an unsupported (non-v2) snapshot version (Story 9.9)", () => {
+    const evil = baseSnapshot({ version: 1 });
+    expect(() => render(evil)).toThrow(/unsupported snapshot version/);
   });
 });
 
@@ -588,7 +405,7 @@ describe("Story 8.0a — configureServer watcher (Chunk 2 m1 + m2)", () => {
       snapshotJson,
       JSON.stringify(
         baseSnapshot({
-          functions: [{ ruby_symbol: "demo_ping", js_identifier: "demoPing", kind: "action" }],
+          functions: [v2ActionEntry()],
         }),
       ),
     );
@@ -644,7 +461,7 @@ describe("Story 8.0a — configureServer watcher (Chunk 2 m1 + m2)", () => {
       snapshotJson,
       JSON.stringify(
         baseSnapshot({
-          functions: [{ ruby_symbol: "categories", js_identifier: "categories", kind: "query" }],
+          functions: [v2ActionEntry({ js_identifier: "categories", http_method: "POST", path: "/categories" })],
         }),
       ),
     );
@@ -672,7 +489,7 @@ describe("Story 8.0a — configureServer watcher (Chunk 2 m1 + m2)", () => {
       snapshotJson,
       JSON.stringify(
         baseSnapshot({
-          functions: [{ ruby_symbol: "demo_ping", js_identifier: "demoPing", kind: "action" }],
+          functions: [v2ActionEntry()],
         }),
       ),
     );
@@ -687,60 +504,6 @@ describe("Story 8.0a — configureServer watcher (Chunk 2 m1 + m2)", () => {
   });
 });
 
-describe("Story 8.0a — Ruby parity (Task 8.5)", () => {
-  // The Ruby codegen reads the same fixture and must produce byte-identical
-  // output. If this test fails, the Ruby OR JS side drifted — diff the outputs
-  // and bring them back into sync rather than normalizing in the assertion.
-
-  const fixture = {
-    version: 1,
-    generated_at: "2026-05-13T12:34:56Z",
-    functions: [
-      {
-        ruby_symbol: "alpha",
-        js_identifier: "alpha",
-        kind: "query",
-        controller: "AlphaController",
-      },
-      {
-        ruby_symbol: "create_post",
-        js_identifier: "createPost",
-        kind: "action",
-        controller: "PostsController",
-      },
-      {
-        ruby_symbol: "_internal_dump",
-        js_identifier: "_internalDump",
-        kind: "action",
-        controller: "InternalsController",
-      },
-    ],
-  };
-
-  it("Ruby's Codegen.render and JS's render produce byte-identical output", () => {
-    const jsOutput = render(fixture);
-
-    // Shell out to Ruby. The gem lib path is two levels up from this file.
-    const gemLibPath = path.resolve(
-      path.dirname(new URL(import.meta.url).pathname),
-      "..",
-      "..",
-      "..",
-      "lib",
-    );
-    const fixtureJson = JSON.stringify(fixture);
-    const script =
-      'require "ruact/server_functions/codegen"; ' +
-      'require "json"; ' +
-      `print Ruact::ServerFunctions::Codegen.render(JSON.parse('${fixtureJson}'))`;
-    const rubyOutput = execFileSync("ruby", ["-I", gemLibPath, "-e", script], {
-      encoding: "utf8",
-    });
-
-    expect(jsOutput).toBe(rubyOutput);
-  });
-});
-
 describe("Story 9.3 — route-driven (v2) render + parity", () => {
   const v2Fixture = {
     version: 2,
@@ -959,3 +722,177 @@ describe("Story 9.5 — v2 query entries render + parity", () => {
     expect(jsOutput).toBe(rubyOutput);
   });
 });
+
+describe("Story 13.4 — typed query params render + parity", () => {
+  const UNION = "string | number | boolean | null";
+
+  const typedQueryFixture = {
+    version: 2,
+    generated_at: "2026-06-26T00:00:00Z",
+    functions: [
+      // no-kwargs query → bare () signature (byte-identical to 9.5)
+      {
+        js_identifier: "categories",
+        kind: "query",
+        http_method: "GET",
+        path: "/q/categories",
+        segments: [],
+        accepts_params: false,
+        params: [],
+        params_rest: false,
+        controller: "CatalogQuery",
+        action: "categories",
+      },
+      // required + optional kwargs → typed object, declaration order
+      {
+        js_identifier: "searchUsers",
+        kind: "query",
+        http_method: "GET",
+        path: "/q/searchUsers",
+        segments: [],
+        accepts_params: true,
+        params: [
+          { name: "term", required: true },
+          { name: "limit", required: false },
+        ],
+        params_rest: false,
+        controller: "CatalogQuery",
+        action: "search_users",
+      },
+      // named key + **keyrest → intersection with the open record
+      {
+        js_identifier: "withRest",
+        kind: "query",
+        http_method: "GET",
+        path: "/q/withRest",
+        segments: [],
+        accepts_params: true,
+        params: [{ name: "scope", required: true }],
+        params_rest: true,
+        controller: "CatalogQuery",
+        action: "with_rest",
+      },
+      // **keyrest-only → open record
+      {
+        js_identifier: "restOnly",
+        kind: "query",
+        http_method: "GET",
+        path: "/q/restOnly",
+        segments: [],
+        accepts_params: true,
+        params: [],
+        params_rest: true,
+        controller: "CatalogQuery",
+        action: "rest_only",
+      },
+    ],
+  };
+
+  it("emits typed params objects (required/optional, keyrest, declaration order)", () => {
+    const out = render(typedQueryFixture);
+    expect(out).toContain("export const categories: () => Promise<unknown> =");
+    expect(out).toContain(
+      `export const searchUsers: (params: { term: ${UNION}; limit?: ${UNION} }) => Promise<unknown> =`,
+    );
+    expect(out).toContain(
+      `export const withRest: (params: { scope: ${UNION} } & Record<string, unknown>) => Promise<unknown> =`,
+    );
+    expect(out).toContain(
+      "export const restOnly: (params: Record<string, unknown>) => Promise<unknown> =",
+    );
+  });
+
+  it("rejects malformed params metadata (trust boundary)", () => {
+    expect(() =>
+      render({
+        version: 2,
+        generated_at: "x",
+        functions: [
+          {
+            js_identifier: "x",
+            kind: "query",
+            http_method: "GET",
+            path: "/q/x",
+            segments: [],
+            params: [{ name: "q\n// injected", required: true }],
+          },
+        ],
+      }),
+    ).toThrow(/non-empty single-line string/);
+  });
+
+  it("rejects a non-boolean params_rest (would silently over-widen the type)", () => {
+    expect(() =>
+      render({
+        version: 2,
+        generated_at: "x",
+        functions: [
+          {
+            js_identifier: "x",
+            kind: "query",
+            http_method: "GET",
+            path: "/q/x",
+            segments: [],
+            params: [],
+            params_rest: "true",
+          },
+        ],
+      }),
+    ).toThrow(/non-boolean params_rest/);
+  });
+
+  it("Ruby's render and JS's render produce byte-identical typed-query output", () => {
+    const jsOutput = render(typedQueryFixture);
+    const gemLibPath = path.resolve(
+      path.dirname(new URL(import.meta.url).pathname),
+      "..",
+      "..",
+      "..",
+      "lib",
+    );
+    const fixtureJson = JSON.stringify(typedQueryFixture);
+    const script =
+      'require "ruact/server_functions/codegen"; ' +
+      'require "json"; ' +
+      `print Ruact::ServerFunctions::Codegen.render(JSON.parse('${fixtureJson}'))`;
+    const rubyOutput = execFileSync("ruby", ["-I", gemLibPath, "-e", script], {
+      encoding: "utf8",
+    });
+    expect(jsOutput).toBe(rubyOutput);
+  });
+
+  it("leaves action + empty modules byte-identical to the pre-13.4 output (regression)", () => {
+    const ACTION_ONLY = {
+      version: 2,
+      generated_at: "2026-06-26T00:00:00Z",
+      functions: [
+        { js_identifier: "createPost", kind: "action", http_method: "POST", path: "/posts", segments: [] },
+      ],
+    };
+    const expectedAction =
+      "// AUTO-GENERATED by vite-plugin-ruact (Story 9.3). DO NOT EDIT.\n" +
+      "// Source: Rails route table (version 2)\n" +
+      "// Generated at: 2026-06-26T00:00:00Z\n" +
+      'import { _makeServerFunction } from "ruact/server-functions-runtime";\n' +
+      "\n" +
+      "export const createPost: ((args?: FormData | Record<string, unknown>) => Promise<unknown>) " +
+      "& ((formData: FormData) => Promise<void>) =\n" +
+      '  _makeServerFunction({ method: "POST", path: "/posts", segments: [] });\n' +
+      "\n" +
+      'export { revalidate } from "ruact/server-functions-runtime";\n';
+    expect(render(ACTION_ONLY)).toBe(expectedAction);
+
+    const EMPTY = { version: 2, generated_at: "2026-06-26T00:00:00Z", functions: [] };
+    const expectedEmpty =
+      "// AUTO-GENERATED by vite-plugin-ruact (Story 9.3). DO NOT EDIT.\n" +
+      "// Source: Rails route table (version 2)\n" +
+      "// Generated at: 2026-06-26T00:00:00Z\n" +
+      'import { _makeServerFunction } from "ruact/server-functions-runtime";\n' +
+      "\n" +
+      "// (no server functions exposed yet — add a non-GET route on a Ruact::Server controller)\n" +
+      "void _makeServerFunction;\n" +
+      "\n" +
+      'export { revalidate } from "ruact/server-functions-runtime";\n';
+    expect(render(EMPTY)).toBe(expectedEmpty);
+  });
+});

data/vendor/javascript/vite-plugin-ruact/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "//": "Story 13.4 — type-check ONLY the emitted-accessor type-test fixtures (AC6). `noEmit` + `strict`; resolves the runtime import to the bundled .d.ts so the emitted `_makeQuery` call shape is exercised. Run via `npm run typecheck`.",
+  "compilerOptions": {
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "exactOptionalPropertyTypes": false,
+    "types": [],
+    "baseUrl": ".",
+    "paths": {
+      "ruact/server-functions-runtime": ["../ruact-server-functions-runtime/index.d.ts"]
+    }
+  },
+  "include": ["type-tests/**/*.ts"]
+}

data/vendor/javascript/vite-plugin-ruact/tsconfig.scaffold-agnostic.json

@@ -0,0 +1,18 @@
+{
+  "//": "Story 14.4 (AC5) — type-check the GENERATED design-system-AGNOSTIC `<Model>{List,Form,DeleteDialog}.tsx` fixtures in ISOLATION against an ambient stub (type-tests/scaffold/agnostic/ambient.d.ts) that declares ONLY React + @/.ruact/server-functions and NO @/components/ui/* module. A stray shadcn import would fail to resolve → the typecheck goes red, proving the agnostic default needs zero design-system resolution. Mirrors tsconfig.scaffold.json (the shadcn isolated typecheck), but scoped to the agnostic subdir so the two ambient stubs never merge. Run via `npm run typecheck`.",
+  "//noImplicitAny": "Relaxed ONLY here: native-element event handler params (e.g. `onChange={(e) => …}`) get no contextual type from the permissive ambient `JSX.IntrinsicElements` (no @types/react / lib:dom). The load-bearing types — PostRow, the typed `search` accessor (FR99), the required `posts` prop, the controlled DeleteDialog contract — are all EXPLICITLY annotated and stay fully checked under `strict`.",
+  "compilerOptions": {
+    "strict": true,
+    "noImplicitAny": false,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "preserve",
+    "exactOptionalPropertyTypes": false,
+    "types": [],
+    "baseUrl": "."
+  },
+  "include": ["type-tests/scaffold/agnostic/**/*.ts", "type-tests/scaffold/agnostic/**/*.tsx"]
+}

data/vendor/javascript/vite-plugin-ruact/tsconfig.scaffold.json

@@ -0,0 +1,20 @@
+{
+  "//": "Story 10.2 (AC7 / Task 5) — type-check the GENERATED `<Model>List.tsx` fixture in ISOLATION against the ambient shadcn / @tanstack/react-table / server-functions stubs (type-tests/scaffold/ambient.d.ts). `jsx: preserve` type-checks JSX without `lib: dom` / @types/react. Kept separate from tsconfig.json so the strict no-JSX 13.4 type-tests stay untouched. Run via `npm run typecheck` (which runs both).",
+  "//noImplicitAny": "Relaxed ONLY here: native-element event handler params (e.g. `onChange={(e) => …}`) get no contextual type from the permissive ambient `JSX.IntrinsicElements` (no @types/react / lib:dom). The load-bearing types — PostRow, the typed `search` accessor (FR99), ColumnDef<Row>, the required `posts` prop — are all EXPLICITLY annotated and stay fully checked under `strict`.",
+  "compilerOptions": {
+    "strict": true,
+    "noImplicitAny": false,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "preserve",
+    "exactOptionalPropertyTypes": false,
+    "types": [],
+    "baseUrl": "."
+  },
+  "include": ["type-tests/scaffold/**/*.ts", "type-tests/scaffold/**/*.tsx"],
+  "//exclude": "Story 14.4 — the agnostic fixtures live under type-tests/scaffold/agnostic/ with their OWN ambient stub (NO @/components/ui module). Exclude them here so the shadcn ambient (this config) and the agnostic ambient never merge into one compilation; they are type-checked separately via tsconfig.scaffold-agnostic.json.",
+  "exclude": ["type-tests/scaffold/agnostic/**"]
+}

data/vendor/javascript/vite-plugin-ruact/type-tests/emitted-module.test-d.ts

@@ -0,0 +1,23 @@
+// Story 13.4 (AC3 / Task 6) — proves the emitted typed-`params` `export const`
+// type-checks against the runtime `_makeQuery` declaration WITHOUT a cast (so the
+// runtime `.d.ts` needs no widening). This is a faithful copy of what
+// `renderQueryExportV2` emits for a kwargs query: the typed signature annotation
+// on the `const`, assigned the `_makeQuery({ path, kind })` factory result.
+
+import { _makeQuery } from "ruact/server-functions-runtime";
+
+// Emitted verbatim by the codegen (no cast, no `any`):
+export const searchUsers: (params: {
+  term: string | number | boolean | null;
+  limit?: string | number | boolean | null;
+}) => Promise<unknown> = _makeQuery({ path: "/q/searchUsers", kind: "query" });
+
+// And the no-kwargs shape:
+export const categories: () => Promise<unknown> = _makeQuery({
+  path: "/q/categories",
+  kind: "query",
+});
+
+// The emitted accessors are callable at their declared shapes.
+void searchUsers({ term: "ada", limit: 10 });
+void categories();