@sigil-dev/grimoire 0.9.4 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/index.ts +37 -37
  2. package/package.json +3 -3
  3. package/preload.js +3 -3
  4. package/server.ts +19 -19
  5. package/src/client/deps.ts +36 -36
  6. package/src/client/enhance.ts +102 -102
  7. package/src/client/head.ts +30 -30
  8. package/src/client/index.ts +5 -5
  9. package/src/client/router.ts +128 -38
  10. package/src/client/scope.ts +22 -22
  11. package/src/dev/compile-module.ts +215 -163
  12. package/src/dev/effect-registry.ts +23 -23
  13. package/src/dev/graph.ts +109 -114
  14. package/src/dev/hmr-client.ts +202 -185
  15. package/src/dev/hmr-server.ts +261 -187
  16. package/src/dev/loader.ts +120 -47
  17. package/src/dev/paths.ts +14 -14
  18. package/src/dev/resolve.ts +70 -0
  19. package/src/dev/runtime-bundle.ts +52 -52
  20. package/src/dev/scan.ts +78 -0
  21. package/src/dev/watcher.ts +69 -47
  22. package/src/env/dynamic-private.ts +19 -19
  23. package/src/env/dynamic-public.ts +22 -22
  24. package/src/env/index.ts +25 -25
  25. package/src/env/plugin.ts +19 -19
  26. package/src/env/private.ts +5 -5
  27. package/src/env/public.ts +7 -7
  28. package/src/env/typegen.ts +61 -61
  29. package/src/headers.ts +114 -114
  30. package/src/integrations/vite.ts +73 -73
  31. package/src/logger/index.ts +4 -4
  32. package/src/logger/instance.ts +6 -6
  33. package/src/logger/logger.ts +113 -113
  34. package/src/logger/request-middleware.ts +24 -24
  35. package/src/logger/transports.ts +117 -117
  36. package/src/logger/types.ts +39 -39
  37. package/src/rendering/head.ts +52 -47
  38. package/src/rendering/hydrate.ts +16 -3
  39. package/src/rendering/index.ts +43 -17
  40. package/src/rendering/ssrPlugin.ts +78 -69
  41. package/src/routing/manifest-gen.ts +55 -55
  42. package/src/routing/router.ts +135 -135
  43. package/src/routing/scanner.ts +196 -187
  44. package/src/routing/transform-routes.ts +102 -102
  45. package/src/sentinels/error.ts +52 -52
  46. package/src/sentinels/fail.ts +41 -41
  47. package/src/sentinels/redirect.ts +35 -35
  48. package/src/server/build.ts +250 -255
  49. package/src/server/context.ts +10 -10
  50. package/src/server/cookie-utils.ts +66 -66
  51. package/src/server/coordinator.ts +1 -1
  52. package/src/server/hooks.ts +114 -114
  53. package/src/server/index.ts +110 -69
  54. package/src/server/interactive.ts +56 -56
  55. package/src/server/plugins.ts +121 -121
  56. package/src/server/worker.ts +58 -58
  57. package/src/typegen/index.ts +389 -389
  58. package/src/types.ts +286 -286
  59. package/test/client-router.test.ts +76 -8
  60. package/test/context.test.ts +52 -52
  61. package/test/env.test.ts +90 -90
  62. package/test/exports.test.ts +37 -37
  63. package/test/fail.test.ts +46 -46
  64. package/test/headers.test.ts +100 -100
  65. package/test/hmr.test.ts +426 -0
  66. package/test/hydration.test.ts +119 -119
  67. package/test/middleware.test.ts +223 -223
  68. package/test/preload.ts +5 -5
  69. package/test/redirect-error.test.ts +112 -112
  70. package/test/rendering.test.ts +719 -728
  71. package/test/routing.test.ts +197 -194
  72. package/test/scanning.test.ts +314 -254
  73. package/test/scope.test.ts +195 -195
  74. package/test/server.test.ts +360 -354
  75. package/test/streaming.test.ts +40 -1
  76. package/test/transform-routes.test.ts +87 -87
  77. package/test/typegen.test.ts +697 -697
  78. package/tsconfig.json +10 -10
@@ -1,697 +1,697 @@
1
- import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
- import { existsSync } from "node:fs";
3
- import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
4
- import { tmpdir } from "node:os";
5
- import { join, sep } from "node:path";
6
- import type { RouteFile } from "../src/routing/scanner";
7
- import { scanRoutes } from "../src/routing/scanner";
8
- import {
9
- buildParams,
10
- generateTypes,
11
- groupByDirectory,
12
- toImportPath,
13
- } from "../src/typegen";
14
-
15
- // ---------------------------------------------------------------------------
16
- // toImportPath
17
- // ---------------------------------------------------------------------------
18
-
19
- describe("toImportPath", () => {
20
- test(".ts extension becomes .js", () => {
21
- const result = toImportPath("/a/b", "/a/b/c/file.ts");
22
- expect(result).toBe("c/file.js");
23
- });
24
-
25
- test(".tsx extension becomes .js", () => {
26
- const result = toImportPath("/a/b", "/a/b/c/file.tsx");
27
- expect(result).toBe("c/file.js");
28
- });
29
-
30
- test("produces ../ prefixes for parent directories", () => {
31
- const result = toImportPath(
32
- "/project/.grimoire/types/src/routes/blog/[slug]",
33
- "/project/src/routes/blog/[slug]/+page.server.ts",
34
- );
35
- // From .grimoire/types/src/routes/blog/[slug] up 6 levels to /project/, then down
36
- expect(result).toBe(
37
- "../../../../../../src/routes/blog/[slug]/+page.server.js",
38
- );
39
- });
40
-
41
- test("never contains backslashes regardless of platform separator", () => {
42
- // Construct paths using the OS separator to exercise the replace logic
43
- // from: C:\project\.grimoire\types\src\routes (4 levels below C:\project)
44
- // to: C:\project\src\routes\+page.server.ts
45
- // → 4 "../" to escape back to C:\project, then down to src/routes/file
46
- const from = ["C:", "project", ".grimoire", "types", "src", "routes"].join(
47
- sep,
48
- );
49
- const to = ["C:", "project", "src", "routes", "+page.server.ts"].join(sep);
50
- const result = toImportPath(from, to);
51
- expect(result).not.toContain("\\");
52
- expect(result).toBe("../../../../src/routes/+page.server.js");
53
- });
54
-
55
- test("sibling file produces just the filename", () => {
56
- const result = toImportPath("/a/b/c", "/a/b/c/file.ts");
57
- expect(result).toBe("file.js");
58
- });
59
- });
60
-
61
- // ---------------------------------------------------------------------------
62
- // buildParams
63
- // ---------------------------------------------------------------------------
64
-
65
- describe("buildParams", () => {
66
- test("empty array returns {}", () => {
67
- expect(buildParams([])).toBe("{}");
68
- });
69
-
70
- test("single param", () => {
71
- expect(buildParams(["id"])).toBe("{\n id: string;\n}");
72
- });
73
-
74
- test("multiple params", () => {
75
- expect(buildParams(["org", "repo"])).toBe(
76
- "{\n org: string;\n repo: string;\n}",
77
- );
78
- });
79
-
80
- test("produces valid TypeScript type syntax", () => {
81
- const result = buildParams(["slug"]);
82
- expect(result).toContain("slug: string;");
83
- });
84
-
85
- test("optional params are typed string | undefined", () => {
86
- const result = buildParams(["slug"], ["lang"], ["rest"]);
87
- expect(result).toContain("slug: string;");
88
- expect(result).toContain("lang: string | undefined;");
89
- expect(result).toContain("rest: string;");
90
- });
91
- });
92
-
93
- // ---------------------------------------------------------------------------
94
- // groupByDirectory
95
- // ---------------------------------------------------------------------------
96
-
97
- function makeRouteFile(
98
- overrides: Partial<RouteFile> & { filePath: string; type: RouteFile["type"] },
99
- ): RouteFile {
100
- return {
101
- path: "/",
102
- clientPath: "/src/routes/+page.tsx",
103
- paramNames: [],
104
- optionalParamNames: [],
105
- restParamNames: [],
106
- paramMatchers: {},
107
- ...overrides,
108
- };
109
- }
110
-
111
- describe("groupByDirectory", () => {
112
- test("simple files are excluded", () => {
113
- const tree = {
114
- routes: [
115
- makeRouteFile({ filePath: "/app/routes/index.tsx", type: "simple" }),
116
- makeRouteFile({ filePath: "/app/routes/about.tsx", type: "simple" }),
117
- ],
118
- layouts: [],
119
- servers: [],
120
- errors: [],
121
- paramMatcherFiles: [],
122
- };
123
- const groups = groupByDirectory(tree);
124
- expect(groups.size).toBe(0);
125
- });
126
-
127
- test("+page.tsx and +page.server.ts in the same directory form one group", () => {
128
- const tree = {
129
- routes: [
130
- makeRouteFile({
131
- filePath: "/app/routes/blog/[slug]/+page.tsx",
132
- type: "page",
133
- paramNames: ["slug"],
134
- }),
135
- makeRouteFile({
136
- filePath: "/app/routes/blog/[slug]/+page.server.ts",
137
- type: "pageServer",
138
- paramNames: ["slug"],
139
- }),
140
- ],
141
- layouts: [],
142
- servers: [],
143
- errors: [],
144
- paramMatcherFiles: [],
145
- };
146
- const groups = groupByDirectory(tree);
147
- expect(groups.size).toBe(1);
148
- const group = groups.get("/app/routes/blog/[slug]")!;
149
- expect(group).toBeDefined();
150
- expect(group.page?.filePath).toBe("/app/routes/blog/[slug]/+page.tsx");
151
- expect(group.pageServer?.filePath).toBe(
152
- "/app/routes/blog/[slug]/+page.server.ts",
153
- );
154
- });
155
-
156
- test("+layout files go into their own group separate from +page files", () => {
157
- const tree = {
158
- routes: [
159
- makeRouteFile({ filePath: "/app/routes/+page.tsx", type: "page" }),
160
- ],
161
- layouts: [
162
- makeRouteFile({ filePath: "/app/routes/+layout.tsx", type: "layout" }),
163
- ],
164
- servers: [],
165
- errors: [],
166
- paramMatcherFiles: [],
167
- };
168
- const groups = groupByDirectory(tree);
169
- expect(groups.size).toBe(1);
170
- const group = groups.get("/app/routes")!;
171
- expect(group.page).toBeDefined();
172
- expect(group.layout).toBeDefined();
173
- });
174
-
175
- test("+server.ts creates a group with server field set", () => {
176
- const tree = {
177
- routes: [],
178
- layouts: [],
179
- servers: [
180
- makeRouteFile({
181
- filePath: "/app/routes/api/hello/+server.ts",
182
- type: "server",
183
- }),
184
- ],
185
- errors: [],
186
- paramMatcherFiles: [],
187
- };
188
- const groups = groupByDirectory(tree);
189
- expect(groups.size).toBe(1);
190
- expect(groups.get("/app/routes/api/hello")!.server).toBeDefined();
191
- });
192
-
193
- test("+error.tsx creates a group with error field set", () => {
194
- const tree = {
195
- routes: [],
196
- layouts: [],
197
- servers: [],
198
- errors: [
199
- makeRouteFile({
200
- filePath: "/app/routes/+error.tsx",
201
- type: "error",
202
- }),
203
- ],
204
- };
205
- const groups = groupByDirectory(tree);
206
- expect(groups.size).toBe(1);
207
- expect(groups.get("/app/routes")!.error).toBeDefined();
208
- });
209
-
210
- test("paramNames taken from the file with most params", () => {
211
- const tree = {
212
- routes: [
213
- makeRouteFile({
214
- filePath: "/app/routes/[org]/[repo]/+page.tsx",
215
- type: "page",
216
- paramNames: ["org", "repo"],
217
- }),
218
- makeRouteFile({
219
- filePath: "/app/routes/[org]/[repo]/+page.server.ts",
220
- type: "pageServer",
221
- paramNames: ["org", "repo"],
222
- }),
223
- ],
224
- layouts: [],
225
- servers: [],
226
- errors: [],
227
- paramMatcherFiles: [],
228
- };
229
- const groups = groupByDirectory(tree);
230
- const group = groups.values().next().value!;
231
- expect(group.paramNames).toEqual(["org", "repo"]);
232
- });
233
-
234
- test("simple files mixed with +page files: only +page files contribute to groups", () => {
235
- const tree = {
236
- routes: [
237
- makeRouteFile({ filePath: "/app/routes/about.tsx", type: "simple" }),
238
- makeRouteFile({
239
- filePath: "/app/routes/blog/+page.tsx",
240
- type: "page",
241
- }),
242
- ],
243
- layouts: [],
244
- servers: [],
245
- errors: [],
246
- paramMatcherFiles: [],
247
- };
248
- const groups = groupByDirectory(tree);
249
- expect(groups.size).toBe(1);
250
- expect(groups.has("/app/routes/blog")).toBe(true);
251
- expect(groups.has("/app/routes")).toBe(false);
252
- });
253
- });
254
-
255
- // ---------------------------------------------------------------------------
256
- // generateTypes — integration (file system)
257
- // ---------------------------------------------------------------------------
258
-
259
- let tmpDir: string;
260
-
261
- beforeAll(async () => {
262
- tmpDir = join(tmpdir(), `grimoire-typegen-${Date.now()}`);
263
- await mkdir(join(tmpDir, "src", "routes", "blog", "[slug]"), {
264
- recursive: true,
265
- });
266
- await mkdir(join(tmpDir, "src", "routes", "api", "posts"), {
267
- recursive: true,
268
- });
269
-
270
- // Layout at root
271
- await writeFile(
272
- join(tmpDir, "src", "routes", "+layout.tsx"),
273
- "export default () => null;",
274
- );
275
-
276
- // Page-only route (no server)
277
- await writeFile(
278
- join(tmpDir, "src", "routes", "blog", "+page.tsx"),
279
- "export default () => null;",
280
- );
281
-
282
- // Route with +page.server.ts that has a load function
283
- await writeFile(
284
- join(tmpDir, "src", "routes", "blog", "[slug]", "+page.tsx"),
285
- "export default () => null;",
286
- );
287
- await writeFile(
288
- join(tmpDir, "src", "routes", "blog", "[slug]", "+page.server.ts"),
289
- `export async function load({ params }: { params: { slug: string } }) {
290
- return { post: { title: "Hello", views: 42 } };
291
- }
292
- export async function DELETE({ request }: { request: Request }) {
293
- return {};
294
- }`,
295
- );
296
-
297
- // Route with +layout.server.ts
298
- await writeFile(
299
- join(tmpDir, "src", "routes", "blog", "+layout.server.ts"),
300
- `export async function load() { return { nav: ["Home", "Blog"] }; }`,
301
- );
302
-
303
- // API route (+server.ts)
304
- await writeFile(
305
- join(tmpDir, "src", "routes", "api", "posts", "+server.ts"),
306
- `export async function GET() { return Response.json([]); }
307
- export async function POST() { return Response.json({}); }`,
308
- );
309
-
310
- // Error page
311
- await writeFile(
312
- join(tmpDir, "src", "routes", "+error.tsx"),
313
- "export default () => null;",
314
- );
315
-
316
- // Simple file (should be ignored)
317
- await writeFile(
318
- join(tmpDir, "src", "routes", "about.tsx"),
319
- "export default () => null;",
320
- );
321
-
322
- // Rest (catch-all) param route
323
- await mkdir(join(tmpDir, "src", "routes", "files", "[...path]"), {
324
- recursive: true,
325
- });
326
- await writeFile(
327
- join(tmpDir, "src", "routes", "files", "[...path]", "+server.ts"),
328
- `export async function GET() { return new Response("ok"); }`,
329
- );
330
- });
331
-
332
- afterAll(async () => {
333
- await rm(tmpDir, { recursive: true, force: true });
334
- });
335
-
336
- async function runGenerate() {
337
- const routesDir = join(tmpDir, "src", "routes");
338
- const tree = await scanRoutes(routesDir, tmpDir);
339
- await generateTypes(tree, {
340
- projectRoot: tmpDir,
341
- routesDir,
342
- outDir: join(tmpDir, ".grimoire", "types"),
343
- });
344
- }
345
-
346
- async function readGenerated(routeRelPath: string) {
347
- const p = join(tmpDir, ".grimoire", "types", routeRelPath, "$types.d.ts");
348
- return readFile(p, "utf-8");
349
- }
350
-
351
- describe("generateTypes — output structure", () => {
352
- test("creates ambient.d.ts with App.Locals namespace", async () => {
353
- await runGenerate();
354
- const ambient = await readFile(
355
- join(tmpDir, ".grimoire", "types", "ambient.d.ts"),
356
- "utf-8",
357
- );
358
- expect(ambient).toContain("declare namespace App");
359
- expect(ambient).toContain("interface Locals");
360
- });
361
-
362
- test("creates tsconfig.generated.json with rootDirs", async () => {
363
- const config = JSON.parse(
364
- await readFile(
365
- join(tmpDir, ".grimoire", "tsconfig.generated.json"),
366
- "utf-8",
367
- ),
368
- );
369
- expect(config.compilerOptions.rootDirs).toContain("..");
370
- expect(config.compilerOptions.rootDirs).toContain("./types");
371
- });
372
-
373
- test("generates $types.d.ts for each route directory with + files", async () => {
374
- expect(
375
- existsSync(
376
- join(tmpDir, ".grimoire", "types", "src", "routes", "$types.d.ts"),
377
- ),
378
- ).toBe(true);
379
- expect(
380
- existsSync(
381
- join(
382
- tmpDir,
383
- ".grimoire",
384
- "types",
385
- "src",
386
- "routes",
387
- "blog",
388
- "$types.d.ts",
389
- ),
390
- ),
391
- ).toBe(true);
392
- expect(
393
- existsSync(
394
- join(
395
- tmpDir,
396
- ".grimoire",
397
- "types",
398
- "src",
399
- "routes",
400
- "blog",
401
- "[slug]",
402
- "$types.d.ts",
403
- ),
404
- ),
405
- ).toBe(true);
406
- });
407
-
408
- test("does NOT generate $types.d.ts for simple (non-+ convention) files", async () => {
409
- // about.tsx is a simple file in src/routes/ — there's no $types for it
410
- // (src/routes/ does get $types from +layout.tsx, but it's not created for about.tsx alone)
411
- // Confirm that about/ directory itself has no $types
412
- expect(
413
- existsSync(
414
- join(
415
- tmpDir,
416
- ".grimoire",
417
- "types",
418
- "src",
419
- "routes",
420
- "about",
421
- "$types.d.ts",
422
- ),
423
- ),
424
- ).toBe(false);
425
- });
426
- });
427
-
428
- describe("generateTypes — route without +page.server.ts", () => {
429
- test("PageData = Record<string, never>", async () => {
430
- const content = await readGenerated("src/routes/blog");
431
- expect(content).toContain("export type PageData = Record<string, never>;");
432
- });
433
-
434
- test("PageServerLoad = never", async () => {
435
- const content = await readGenerated("src/routes/blog");
436
- expect(content).toContain("export type PageServerLoad = never;");
437
- });
438
-
439
- test("Actions = Record<string, never>", async () => {
440
- const content = await readGenerated("src/routes/blog");
441
- expect(content).toContain("export type Actions = Record<string, never>;");
442
- });
443
-
444
- test("PageProps contains data and params", async () => {
445
- const content = await readGenerated("src/routes/blog");
446
- expect(content).toContain(
447
- "export type PageProps = { data: PageData; params: Params };",
448
- );
449
- });
450
- });
451
-
452
- describe("generateTypes — route with +page.server.ts", () => {
453
- test("uses typeof import() for the server module", async () => {
454
- const content = await readGenerated("src/routes/blog/[slug]");
455
- expect(content).toMatch(/type _PS = typeof import\("/);
456
- });
457
-
458
- test("import path ends with .js", async () => {
459
- const content = await readGenerated("src/routes/blog/[slug]");
460
- const match = content.match(/typeof import\("([^"]+)"\)/);
461
- expect(match?.[1]).toMatch(/\.js$/);
462
- });
463
-
464
- test("import path contains only forward slashes", async () => {
465
- const content = await readGenerated("src/routes/blog/[slug]");
466
- const match = content.match(/typeof import\("([^"]+)"\)/);
467
- expect(match?.[1]).not.toContain("\\");
468
- });
469
-
470
- test("PageData inferred from load() via ReturnType", async () => {
471
- const content = await readGenerated("src/routes/blog/[slug]");
472
- expect(content).toContain(
473
- 'export type PageData = "load" extends keyof _PS',
474
- );
475
- expect(content).toContain('Awaited<ReturnType<_PS["load"]>>');
476
- });
477
-
478
- test("PageProps = { data: PageData; params: Params }", async () => {
479
- const content = await readGenerated("src/routes/blog/[slug]");
480
- expect(content).toContain(
481
- "export type PageProps = { data: PageData; params: Params };",
482
- );
483
- });
484
-
485
- test("Actions excludes load and default from keys", async () => {
486
- const content = await readGenerated("src/routes/blog/[slug]");
487
- expect(content).toContain(
488
- 'type _ActionKeys = Exclude<keyof _PS, "load" | "default">;',
489
- );
490
- });
491
-
492
- test("Params has slug typed as string", async () => {
493
- const content = await readGenerated("src/routes/blog/[slug]");
494
- expect(content).toContain("slug: string;");
495
- });
496
- });
497
-
498
- describe("generateTypes — +layout.server.ts", () => {
499
- test("LayoutData inferred from load() via typeof import", async () => {
500
- const content = await readGenerated("src/routes/blog");
501
- expect(content).toMatch(/type _LS = typeof import\("/);
502
- expect(content).toContain(
503
- 'export type LayoutData = "load" extends keyof _LS',
504
- );
505
- expect(content).toContain('Awaited<ReturnType<_LS["load"]>>');
506
- });
507
-
508
- test("LayoutProps includes children", async () => {
509
- const content = await readGenerated("src/routes/blog");
510
- expect(content).toContain("children?: unknown");
511
- });
512
- });
513
-
514
- describe("generateTypes — +server.ts (API route)", () => {
515
- test("generates ServerHandlers type", async () => {
516
- const content = await readGenerated("src/routes/api/posts");
517
- expect(content).toContain("export type ServerHandlers");
518
- });
519
-
520
- test("uses typeof import() for server module", async () => {
521
- const content = await readGenerated("src/routes/api/posts");
522
- expect(content).toMatch(/type _SRV = typeof import\("/);
523
- });
524
-
525
- test("extracts HTTP method keys", async () => {
526
- const content = await readGenerated("src/routes/api/posts");
527
- expect(content).toContain("_HttpMethods");
528
- expect(content).toContain("_ServerKeys");
529
- });
530
- });
531
-
532
- describe("generateTypes — +error.tsx", () => {
533
- test("generates ErrorProps type", async () => {
534
- const content = await readGenerated("src/routes");
535
- expect(content).toContain(
536
- "export type ErrorProps = { status: number; message: string; error: unknown; route: string };",
537
- );
538
- });
539
- });
540
-
541
- describe("generateTypes — rest (catch-all) params", () => {
542
- test("Params includes rest param name as string", async () => {
543
- const content = await readGenerated("src/routes/files/[...path]");
544
- expect(content).toContain("path: string;");
545
- expect(content).toMatch(/export type Params = \{\s+path: string;\s+\};/);
546
- });
547
- });
548
-
549
- // This behavior no lnger exists
550
- // describe("generateTypes — clears stale output", () => {
551
- // test("removes files from a deleted route on re-run", async () => {
552
- // // First run already happened in beforeAll via runGenerate()
553
- // // Write a stale file manually
554
- // const staleDir = join(
555
- // tmpDir,
556
- // ".grimoire",
557
- // "types",
558
- // "src",
559
- // "routes",
560
- // "old-route",
561
- // );
562
- // await mkdir(staleDir, { recursive: true });
563
- // await writeFile(join(staleDir, "$types.d.ts"), "// stale");
564
-
565
- // // Re-run
566
- // await runGenerate();
567
-
568
- // // Stale file should be gone
569
- // expect(existsSync(join(staleDir, "$types.d.ts"))).toBe(false);
570
- // });
571
- // });
572
-
573
- // ---------------------------------------------------------------------------
574
- // tsc integration — proves the generated types actually type-check
575
- // ---------------------------------------------------------------------------
576
-
577
- describe("tsc integration", () => {
578
- let tscDir: string;
579
-
580
- beforeAll(async () => {
581
- tscDir = join(tmpdir(), `grimoire-tsc-${Date.now()}`);
582
- const routeDir = join(tscDir, "src", "routes", "blog", "[slug]");
583
- await mkdir(routeDir, { recursive: true });
584
-
585
- // Minimal +page.server.ts whose return type flows through to PageProps
586
- await writeFile(
587
- join(routeDir, "+page.server.ts"),
588
- `export async function load({ params }: { params: { slug: string } }) {
589
- return { post: { title: "Hello", views: 42 } };
590
- }`,
591
- );
592
-
593
- // File that uses the generated types — must live in the route dir for ./$types to resolve
594
- await writeFile(
595
- join(routeDir, "check.ts"),
596
- `import type { PageProps } from "./$types";
597
- declare const props: PageProps;
598
- const _title: string = props.data.post.title;
599
- const _views: number = props.data.post.views;
600
- const _slug: string = props.params.slug;
601
- export {};`,
602
- );
603
-
604
- // tsconfig for this mini-project
605
- await writeFile(
606
- join(tscDir, "tsconfig.json"),
607
- JSON.stringify(
608
- {
609
- extends: "./.grimoire/tsconfig.generated.json",
610
- compilerOptions: {
611
- target: "ESNext",
612
- module: "ESNext",
613
- moduleResolution: "bundler",
614
- strict: true,
615
- skipLibCheck: true,
616
- noEmit: true,
617
- },
618
- include: ["src", ".grimoire/types"],
619
- },
620
- null,
621
- 2,
622
- ),
623
- );
624
-
625
- // Generate types
626
- const routesDir = join(tscDir, "src", "routes");
627
- const tree = await scanRoutes(routesDir, tscDir);
628
- await generateTypes(tree, {
629
- projectRoot: tscDir,
630
- routesDir,
631
- outDir: join(tscDir, ".grimoire", "types"),
632
- });
633
- });
634
-
635
- afterAll(async () => {
636
- await rm(tscDir, { recursive: true, force: true });
637
- });
638
-
639
- function runTsc(cwd: string) {
640
- const proc = Bun.spawnSync(
641
- [
642
- process.execPath,
643
- "x",
644
- "--bun",
645
- "@typescript/native-preview",
646
- "--noEmit",
647
- "--project",
648
- "tsconfig.json",
649
- ],
650
- { cwd },
651
- );
652
- return proc;
653
- }
654
-
655
- test("check.ts with correct types passes tsc", () => {
656
- const result = runTsc(tscDir);
657
- // Ignore bun package-download messages; only care about exit code
658
- expect(result.exitCode).toBe(0);
659
- });
660
-
661
- test("accessing a non-existent property fails tsc", async () => {
662
- // Add a file with a wrong property access
663
- const routeDir = join(tscDir, "src", "routes", "blog", "[slug]");
664
- await writeFile(
665
- join(routeDir, "bad.ts"),
666
- `import type { PageProps } from "./$types";
667
- declare const props: PageProps;
668
- const _bad = props.post.bogus;
669
- export {};`,
670
- );
671
-
672
- const result = runTsc(tscDir);
673
- expect(result.exitCode).not.toBe(0);
674
-
675
- // Clean up so subsequent test runs are clean
676
- const { unlink } = await import("node:fs/promises");
677
- await unlink(join(routeDir, "bad.ts"));
678
- });
679
-
680
- test("params properties are typed as string", async () => {
681
- // Assigning params.slug to a number should fail
682
- const routeDir = join(tscDir, "src", "routes", "blog", "[slug]");
683
- await writeFile(
684
- join(routeDir, "wrong-param-type.ts"),
685
- `import type { PageProps } from "./$types";
686
- declare const props: PageProps;
687
- const _n: number = props.params.slug;
688
- export {};`,
689
- );
690
-
691
- const result = runTsc(tscDir);
692
- expect(result.exitCode).not.toBe(0);
693
-
694
- const { unlink } = await import("node:fs/promises");
695
- await unlink(join(routeDir, "wrong-param-type.ts"));
696
- });
697
- });
1
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
+ import { existsSync } from "node:fs";
3
+ import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
4
+ import { tmpdir } from "node:os";
5
+ import { join, sep } from "node:path";
6
+ import type { RouteFile } from "../src/routing/scanner";
7
+ import { scanRoutes } from "../src/routing/scanner";
8
+ import {
9
+ buildParams,
10
+ generateTypes,
11
+ groupByDirectory,
12
+ toImportPath,
13
+ } from "../src/typegen";
14
+
15
+ // ---------------------------------------------------------------------------
16
+ // toImportPath
17
+ // ---------------------------------------------------------------------------
18
+
19
+ describe("toImportPath", () => {
20
+ test(".ts extension becomes .js", () => {
21
+ const result = toImportPath("/a/b", "/a/b/c/file.ts");
22
+ expect(result).toBe("c/file.js");
23
+ });
24
+
25
+ test(".tsx extension becomes .js", () => {
26
+ const result = toImportPath("/a/b", "/a/b/c/file.tsx");
27
+ expect(result).toBe("c/file.js");
28
+ });
29
+
30
+ test("produces ../ prefixes for parent directories", () => {
31
+ const result = toImportPath(
32
+ "/project/.grimoire/types/src/routes/blog/[slug]",
33
+ "/project/src/routes/blog/[slug]/+page.server.ts",
34
+ );
35
+ // From .grimoire/types/src/routes/blog/[slug] up 6 levels to /project/, then down
36
+ expect(result).toBe(
37
+ "../../../../../../src/routes/blog/[slug]/+page.server.js",
38
+ );
39
+ });
40
+
41
+ test("never contains backslashes regardless of platform separator", () => {
42
+ // Construct paths using the OS separator to exercise the replace logic
43
+ // from: C:\project\.grimoire\types\src\routes (4 levels below C:\project)
44
+ // to: C:\project\src\routes\+page.server.ts
45
+ // → 4 "../" to escape back to C:\project, then down to src/routes/file
46
+ const from = ["C:", "project", ".grimoire", "types", "src", "routes"].join(
47
+ sep,
48
+ );
49
+ const to = ["C:", "project", "src", "routes", "+page.server.ts"].join(sep);
50
+ const result = toImportPath(from, to);
51
+ expect(result).not.toContain("\\");
52
+ expect(result).toBe("../../../../src/routes/+page.server.js");
53
+ });
54
+
55
+ test("sibling file produces just the filename", () => {
56
+ const result = toImportPath("/a/b/c", "/a/b/c/file.ts");
57
+ expect(result).toBe("file.js");
58
+ });
59
+ });
60
+
61
+ // ---------------------------------------------------------------------------
62
+ // buildParams
63
+ // ---------------------------------------------------------------------------
64
+
65
+ describe("buildParams", () => {
66
+ test("empty array returns {}", () => {
67
+ expect(buildParams([])).toBe("{}");
68
+ });
69
+
70
+ test("single param", () => {
71
+ expect(buildParams(["id"])).toBe("{\n id: string;\n}");
72
+ });
73
+
74
+ test("multiple params", () => {
75
+ expect(buildParams(["org", "repo"])).toBe(
76
+ "{\n org: string;\n repo: string;\n}",
77
+ );
78
+ });
79
+
80
+ test("produces valid TypeScript type syntax", () => {
81
+ const result = buildParams(["slug"]);
82
+ expect(result).toContain("slug: string;");
83
+ });
84
+
85
+ test("optional params are typed string | undefined", () => {
86
+ const result = buildParams(["slug"], ["lang"], ["rest"]);
87
+ expect(result).toContain("slug: string;");
88
+ expect(result).toContain("lang: string | undefined;");
89
+ expect(result).toContain("rest: string;");
90
+ });
91
+ });
92
+
93
+ // ---------------------------------------------------------------------------
94
+ // groupByDirectory
95
+ // ---------------------------------------------------------------------------
96
+
97
+ function makeRouteFile(
98
+ overrides: Partial<RouteFile> & { filePath: string; type: RouteFile["type"] },
99
+ ): RouteFile {
100
+ return {
101
+ path: "/",
102
+ clientPath: "/src/routes/+page.tsx",
103
+ paramNames: [],
104
+ optionalParamNames: [],
105
+ restParamNames: [],
106
+ paramMatchers: {},
107
+ ...overrides,
108
+ };
109
+ }
110
+
111
+ describe("groupByDirectory", () => {
112
+ test("simple files are excluded", () => {
113
+ const tree = {
114
+ routes: [
115
+ makeRouteFile({ filePath: "/app/routes/index.tsx", type: "simple" }),
116
+ makeRouteFile({ filePath: "/app/routes/about.tsx", type: "simple" }),
117
+ ],
118
+ layouts: [],
119
+ servers: [],
120
+ errors: [],
121
+ paramMatcherFiles: [],
122
+ };
123
+ const groups = groupByDirectory(tree);
124
+ expect(groups.size).toBe(0);
125
+ });
126
+
127
+ test("+page.tsx and +page.server.ts in the same directory form one group", () => {
128
+ const tree = {
129
+ routes: [
130
+ makeRouteFile({
131
+ filePath: "/app/routes/blog/[slug]/+page.tsx",
132
+ type: "page",
133
+ paramNames: ["slug"],
134
+ }),
135
+ makeRouteFile({
136
+ filePath: "/app/routes/blog/[slug]/+page.server.ts",
137
+ type: "pageServer",
138
+ paramNames: ["slug"],
139
+ }),
140
+ ],
141
+ layouts: [],
142
+ servers: [],
143
+ errors: [],
144
+ paramMatcherFiles: [],
145
+ };
146
+ const groups = groupByDirectory(tree);
147
+ expect(groups.size).toBe(1);
148
+ const group = groups.get("/app/routes/blog/[slug]")!;
149
+ expect(group).toBeDefined();
150
+ expect(group.page?.filePath).toBe("/app/routes/blog/[slug]/+page.tsx");
151
+ expect(group.pageServer?.filePath).toBe(
152
+ "/app/routes/blog/[slug]/+page.server.ts",
153
+ );
154
+ });
155
+
156
+ test("+layout files go into their own group separate from +page files", () => {
157
+ const tree = {
158
+ routes: [
159
+ makeRouteFile({ filePath: "/app/routes/+page.tsx", type: "page" }),
160
+ ],
161
+ layouts: [
162
+ makeRouteFile({ filePath: "/app/routes/+layout.tsx", type: "layout" }),
163
+ ],
164
+ servers: [],
165
+ errors: [],
166
+ paramMatcherFiles: [],
167
+ };
168
+ const groups = groupByDirectory(tree);
169
+ expect(groups.size).toBe(1);
170
+ const group = groups.get("/app/routes")!;
171
+ expect(group.page).toBeDefined();
172
+ expect(group.layout).toBeDefined();
173
+ });
174
+
175
+ test("+server.ts creates a group with server field set", () => {
176
+ const tree = {
177
+ routes: [],
178
+ layouts: [],
179
+ servers: [
180
+ makeRouteFile({
181
+ filePath: "/app/routes/api/hello/+server.ts",
182
+ type: "server",
183
+ }),
184
+ ],
185
+ errors: [],
186
+ paramMatcherFiles: [],
187
+ };
188
+ const groups = groupByDirectory(tree);
189
+ expect(groups.size).toBe(1);
190
+ expect(groups.get("/app/routes/api/hello")!.server).toBeDefined();
191
+ });
192
+
193
+ test("+error.tsx creates a group with error field set", () => {
194
+ const tree = {
195
+ routes: [],
196
+ layouts: [],
197
+ servers: [],
198
+ errors: [
199
+ makeRouteFile({
200
+ filePath: "/app/routes/+error.tsx",
201
+ type: "error",
202
+ }),
203
+ ],
204
+ };
205
+ const groups = groupByDirectory(tree);
206
+ expect(groups.size).toBe(1);
207
+ expect(groups.get("/app/routes")!.error).toBeDefined();
208
+ });
209
+
210
+ test("paramNames taken from the file with most params", () => {
211
+ const tree = {
212
+ routes: [
213
+ makeRouteFile({
214
+ filePath: "/app/routes/[org]/[repo]/+page.tsx",
215
+ type: "page",
216
+ paramNames: ["org", "repo"],
217
+ }),
218
+ makeRouteFile({
219
+ filePath: "/app/routes/[org]/[repo]/+page.server.ts",
220
+ type: "pageServer",
221
+ paramNames: ["org", "repo"],
222
+ }),
223
+ ],
224
+ layouts: [],
225
+ servers: [],
226
+ errors: [],
227
+ paramMatcherFiles: [],
228
+ };
229
+ const groups = groupByDirectory(tree);
230
+ const group = groups.values().next().value!;
231
+ expect(group.paramNames).toEqual(["org", "repo"]);
232
+ });
233
+
234
+ test("simple files mixed with +page files: only +page files contribute to groups", () => {
235
+ const tree = {
236
+ routes: [
237
+ makeRouteFile({ filePath: "/app/routes/about.tsx", type: "simple" }),
238
+ makeRouteFile({
239
+ filePath: "/app/routes/blog/+page.tsx",
240
+ type: "page",
241
+ }),
242
+ ],
243
+ layouts: [],
244
+ servers: [],
245
+ errors: [],
246
+ paramMatcherFiles: [],
247
+ };
248
+ const groups = groupByDirectory(tree);
249
+ expect(groups.size).toBe(1);
250
+ expect(groups.has("/app/routes/blog")).toBe(true);
251
+ expect(groups.has("/app/routes")).toBe(false);
252
+ });
253
+ });
254
+
255
+ // ---------------------------------------------------------------------------
256
+ // generateTypes — integration (file system)
257
+ // ---------------------------------------------------------------------------
258
+
259
+ let tmpDir: string;
260
+
261
+ beforeAll(async () => {
262
+ tmpDir = join(tmpdir(), `grimoire-typegen-${Date.now()}`);
263
+ await mkdir(join(tmpDir, "src", "routes", "blog", "[slug]"), {
264
+ recursive: true,
265
+ });
266
+ await mkdir(join(tmpDir, "src", "routes", "api", "posts"), {
267
+ recursive: true,
268
+ });
269
+
270
+ // Layout at root
271
+ await writeFile(
272
+ join(tmpDir, "src", "routes", "+layout.tsx"),
273
+ "export default () => null;",
274
+ );
275
+
276
+ // Page-only route (no server)
277
+ await writeFile(
278
+ join(tmpDir, "src", "routes", "blog", "+page.tsx"),
279
+ "export default () => null;",
280
+ );
281
+
282
+ // Route with +page.server.ts that has a load function
283
+ await writeFile(
284
+ join(tmpDir, "src", "routes", "blog", "[slug]", "+page.tsx"),
285
+ "export default () => null;",
286
+ );
287
+ await writeFile(
288
+ join(tmpDir, "src", "routes", "blog", "[slug]", "+page.server.ts"),
289
+ `export async function load({ params }: { params: { slug: string } }) {
290
+ return { post: { title: "Hello", views: 42 } };
291
+ }
292
+ export async function DELETE({ request }: { request: Request }) {
293
+ return {};
294
+ }`,
295
+ );
296
+
297
+ // Route with +layout.server.ts
298
+ await writeFile(
299
+ join(tmpDir, "src", "routes", "blog", "+layout.server.ts"),
300
+ `export async function load() { return { nav: ["Home", "Blog"] }; }`,
301
+ );
302
+
303
+ // API route (+server.ts)
304
+ await writeFile(
305
+ join(tmpDir, "src", "routes", "api", "posts", "+server.ts"),
306
+ `export async function GET() { return Response.json([]); }
307
+ export async function POST() { return Response.json({}); }`,
308
+ );
309
+
310
+ // Error page
311
+ await writeFile(
312
+ join(tmpDir, "src", "routes", "+error.tsx"),
313
+ "export default () => null;",
314
+ );
315
+
316
+ // Simple file (should be ignored)
317
+ await writeFile(
318
+ join(tmpDir, "src", "routes", "about.tsx"),
319
+ "export default () => null;",
320
+ );
321
+
322
+ // Rest (catch-all) param route
323
+ await mkdir(join(tmpDir, "src", "routes", "files", "[...path]"), {
324
+ recursive: true,
325
+ });
326
+ await writeFile(
327
+ join(tmpDir, "src", "routes", "files", "[...path]", "+server.ts"),
328
+ `export async function GET() { return new Response("ok"); }`,
329
+ );
330
+ });
331
+
332
+ afterAll(async () => {
333
+ await rm(tmpDir, { recursive: true, force: true });
334
+ });
335
+
336
+ async function runGenerate() {
337
+ const routesDir = join(tmpDir, "src", "routes");
338
+ const tree = await scanRoutes(routesDir, tmpDir);
339
+ await generateTypes(tree, {
340
+ projectRoot: tmpDir,
341
+ routesDir,
342
+ outDir: join(tmpDir, ".grimoire", "types"),
343
+ });
344
+ }
345
+
346
+ async function readGenerated(routeRelPath: string) {
347
+ const p = join(tmpDir, ".grimoire", "types", routeRelPath, "$types.d.ts");
348
+ return readFile(p, "utf-8");
349
+ }
350
+
351
+ describe("generateTypes — output structure", () => {
352
+ test("creates ambient.d.ts with App.Locals namespace", async () => {
353
+ await runGenerate();
354
+ const ambient = await readFile(
355
+ join(tmpDir, ".grimoire", "types", "ambient.d.ts"),
356
+ "utf-8",
357
+ );
358
+ expect(ambient).toContain("declare namespace App");
359
+ expect(ambient).toContain("interface Locals");
360
+ });
361
+
362
+ test("creates tsconfig.generated.json with rootDirs", async () => {
363
+ const config = JSON.parse(
364
+ await readFile(
365
+ join(tmpDir, ".grimoire", "tsconfig.generated.json"),
366
+ "utf-8",
367
+ ),
368
+ );
369
+ expect(config.compilerOptions.rootDirs).toContain("..");
370
+ expect(config.compilerOptions.rootDirs).toContain("./types");
371
+ });
372
+
373
+ test("generates $types.d.ts for each route directory with + files", async () => {
374
+ expect(
375
+ existsSync(
376
+ join(tmpDir, ".grimoire", "types", "src", "routes", "$types.d.ts"),
377
+ ),
378
+ ).toBe(true);
379
+ expect(
380
+ existsSync(
381
+ join(
382
+ tmpDir,
383
+ ".grimoire",
384
+ "types",
385
+ "src",
386
+ "routes",
387
+ "blog",
388
+ "$types.d.ts",
389
+ ),
390
+ ),
391
+ ).toBe(true);
392
+ expect(
393
+ existsSync(
394
+ join(
395
+ tmpDir,
396
+ ".grimoire",
397
+ "types",
398
+ "src",
399
+ "routes",
400
+ "blog",
401
+ "[slug]",
402
+ "$types.d.ts",
403
+ ),
404
+ ),
405
+ ).toBe(true);
406
+ });
407
+
408
+ test("does NOT generate $types.d.ts for simple (non-+ convention) files", async () => {
409
+ // about.tsx is a simple file in src/routes/ — there's no $types for it
410
+ // (src/routes/ does get $types from +layout.tsx, but it's not created for about.tsx alone)
411
+ // Confirm that about/ directory itself has no $types
412
+ expect(
413
+ existsSync(
414
+ join(
415
+ tmpDir,
416
+ ".grimoire",
417
+ "types",
418
+ "src",
419
+ "routes",
420
+ "about",
421
+ "$types.d.ts",
422
+ ),
423
+ ),
424
+ ).toBe(false);
425
+ });
426
+ });
427
+
428
+ describe("generateTypes — route without +page.server.ts", () => {
429
+ test("PageData = Record<string, never>", async () => {
430
+ const content = await readGenerated("src/routes/blog");
431
+ expect(content).toContain("export type PageData = Record<string, never>;");
432
+ });
433
+
434
+ test("PageServerLoad = never", async () => {
435
+ const content = await readGenerated("src/routes/blog");
436
+ expect(content).toContain("export type PageServerLoad = never;");
437
+ });
438
+
439
+ test("Actions = Record<string, never>", async () => {
440
+ const content = await readGenerated("src/routes/blog");
441
+ expect(content).toContain("export type Actions = Record<string, never>;");
442
+ });
443
+
444
+ test("PageProps contains data and params", async () => {
445
+ const content = await readGenerated("src/routes/blog");
446
+ expect(content).toContain(
447
+ "export type PageProps = { data: PageData; params: Params };",
448
+ );
449
+ });
450
+ });
451
+
452
+ describe("generateTypes — route with +page.server.ts", () => {
453
+ test("uses typeof import() for the server module", async () => {
454
+ const content = await readGenerated("src/routes/blog/[slug]");
455
+ expect(content).toMatch(/type _PS = typeof import\("/);
456
+ });
457
+
458
+ test("import path ends with .js", async () => {
459
+ const content = await readGenerated("src/routes/blog/[slug]");
460
+ const match = content.match(/typeof import\("([^"]+)"\)/);
461
+ expect(match?.[1]).toMatch(/\.js$/);
462
+ });
463
+
464
+ test("import path contains only forward slashes", async () => {
465
+ const content = await readGenerated("src/routes/blog/[slug]");
466
+ const match = content.match(/typeof import\("([^"]+)"\)/);
467
+ expect(match?.[1]).not.toContain("\\");
468
+ });
469
+
470
+ test("PageData inferred from load() via ReturnType", async () => {
471
+ const content = await readGenerated("src/routes/blog/[slug]");
472
+ expect(content).toContain(
473
+ 'export type PageData = "load" extends keyof _PS',
474
+ );
475
+ expect(content).toContain('Awaited<ReturnType<_PS["load"]>>');
476
+ });
477
+
478
+ test("PageProps = { data: PageData; params: Params }", async () => {
479
+ const content = await readGenerated("src/routes/blog/[slug]");
480
+ expect(content).toContain(
481
+ "export type PageProps = { data: PageData; params: Params };",
482
+ );
483
+ });
484
+
485
+ test("Actions excludes load and default from keys", async () => {
486
+ const content = await readGenerated("src/routes/blog/[slug]");
487
+ expect(content).toContain(
488
+ 'type _ActionKeys = Exclude<keyof _PS, "load" | "default">;',
489
+ );
490
+ });
491
+
492
+ test("Params has slug typed as string", async () => {
493
+ const content = await readGenerated("src/routes/blog/[slug]");
494
+ expect(content).toContain("slug: string;");
495
+ });
496
+ });
497
+
498
+ describe("generateTypes — +layout.server.ts", () => {
499
+ test("LayoutData inferred from load() via typeof import", async () => {
500
+ const content = await readGenerated("src/routes/blog");
501
+ expect(content).toMatch(/type _LS = typeof import\("/);
502
+ expect(content).toContain(
503
+ 'export type LayoutData = "load" extends keyof _LS',
504
+ );
505
+ expect(content).toContain('Awaited<ReturnType<_LS["load"]>>');
506
+ });
507
+
508
+ test("LayoutProps includes children", async () => {
509
+ const content = await readGenerated("src/routes/blog");
510
+ expect(content).toContain("children?: unknown");
511
+ });
512
+ });
513
+
514
+ describe("generateTypes — +server.ts (API route)", () => {
515
+ test("generates ServerHandlers type", async () => {
516
+ const content = await readGenerated("src/routes/api/posts");
517
+ expect(content).toContain("export type ServerHandlers");
518
+ });
519
+
520
+ test("uses typeof import() for server module", async () => {
521
+ const content = await readGenerated("src/routes/api/posts");
522
+ expect(content).toMatch(/type _SRV = typeof import\("/);
523
+ });
524
+
525
+ test("extracts HTTP method keys", async () => {
526
+ const content = await readGenerated("src/routes/api/posts");
527
+ expect(content).toContain("_HttpMethods");
528
+ expect(content).toContain("_ServerKeys");
529
+ });
530
+ });
531
+
532
+ describe("generateTypes — +error.tsx", () => {
533
+ test("generates ErrorProps type", async () => {
534
+ const content = await readGenerated("src/routes");
535
+ expect(content).toContain(
536
+ "export type ErrorProps = { status: number; message: string; error: unknown; route: string };",
537
+ );
538
+ });
539
+ });
540
+
541
+ describe("generateTypes — rest (catch-all) params", () => {
542
+ test("Params includes rest param name as string", async () => {
543
+ const content = await readGenerated("src/routes/files/[...path]");
544
+ expect(content).toContain("path: string;");
545
+ expect(content).toMatch(/export type Params = \{\s+path: string;\s+\};/);
546
+ });
547
+ });
548
+
549
+ // This behavior no lnger exists
550
+ // describe("generateTypes — clears stale output", () => {
551
+ // test("removes files from a deleted route on re-run", async () => {
552
+ // // First run already happened in beforeAll via runGenerate()
553
+ // // Write a stale file manually
554
+ // const staleDir = join(
555
+ // tmpDir,
556
+ // ".grimoire",
557
+ // "types",
558
+ // "src",
559
+ // "routes",
560
+ // "old-route",
561
+ // );
562
+ // await mkdir(staleDir, { recursive: true });
563
+ // await writeFile(join(staleDir, "$types.d.ts"), "// stale");
564
+
565
+ // // Re-run
566
+ // await runGenerate();
567
+
568
+ // // Stale file should be gone
569
+ // expect(existsSync(join(staleDir, "$types.d.ts"))).toBe(false);
570
+ // });
571
+ // });
572
+
573
+ // ---------------------------------------------------------------------------
574
+ // tsc integration — proves the generated types actually type-check
575
+ // ---------------------------------------------------------------------------
576
+
577
+ describe("tsc integration", () => {
578
+ let tscDir: string;
579
+
580
+ beforeAll(async () => {
581
+ tscDir = join(tmpdir(), `grimoire-tsc-${Date.now()}`);
582
+ const routeDir = join(tscDir, "src", "routes", "blog", "[slug]");
583
+ await mkdir(routeDir, { recursive: true });
584
+
585
+ // Minimal +page.server.ts whose return type flows through to PageProps
586
+ await writeFile(
587
+ join(routeDir, "+page.server.ts"),
588
+ `export async function load({ params }: { params: { slug: string } }) {
589
+ return { post: { title: "Hello", views: 42 } };
590
+ }`,
591
+ );
592
+
593
+ // File that uses the generated types — must live in the route dir for ./$types to resolve
594
+ await writeFile(
595
+ join(routeDir, "check.ts"),
596
+ `import type { PageProps } from "./$types";
597
+ declare const props: PageProps;
598
+ const _title: string = props.data.post.title;
599
+ const _views: number = props.data.post.views;
600
+ const _slug: string = props.params.slug;
601
+ export {};`,
602
+ );
603
+
604
+ // tsconfig for this mini-project
605
+ await writeFile(
606
+ join(tscDir, "tsconfig.json"),
607
+ JSON.stringify(
608
+ {
609
+ extends: "./.grimoire/tsconfig.generated.json",
610
+ compilerOptions: {
611
+ target: "ESNext",
612
+ module: "ESNext",
613
+ moduleResolution: "bundler",
614
+ strict: true,
615
+ skipLibCheck: true,
616
+ noEmit: true,
617
+ },
618
+ include: ["src", ".grimoire/types"],
619
+ },
620
+ null,
621
+ 2,
622
+ ),
623
+ );
624
+
625
+ // Generate types
626
+ const routesDir = join(tscDir, "src", "routes");
627
+ const tree = await scanRoutes(routesDir, tscDir);
628
+ await generateTypes(tree, {
629
+ projectRoot: tscDir,
630
+ routesDir,
631
+ outDir: join(tscDir, ".grimoire", "types"),
632
+ });
633
+ });
634
+
635
+ afterAll(async () => {
636
+ await rm(tscDir, { recursive: true, force: true });
637
+ });
638
+
639
+ function runTsc(cwd: string) {
640
+ const proc = Bun.spawnSync(
641
+ [
642
+ process.execPath,
643
+ "x",
644
+ "--bun",
645
+ "@typescript/native-preview",
646
+ "--noEmit",
647
+ "--project",
648
+ "tsconfig.json",
649
+ ],
650
+ { cwd },
651
+ );
652
+ return proc;
653
+ }
654
+
655
+ test("check.ts with correct types passes tsc", () => {
656
+ const result = runTsc(tscDir);
657
+ // Ignore bun package-download messages; only care about exit code
658
+ expect(result.exitCode).toBe(0);
659
+ });
660
+
661
+ test("accessing a non-existent property fails tsc", async () => {
662
+ // Add a file with a wrong property access
663
+ const routeDir = join(tscDir, "src", "routes", "blog", "[slug]");
664
+ await writeFile(
665
+ join(routeDir, "bad.ts"),
666
+ `import type { PageProps } from "./$types";
667
+ declare const props: PageProps;
668
+ const _bad = props.post.bogus;
669
+ export {};`,
670
+ );
671
+
672
+ const result = runTsc(tscDir);
673
+ expect(result.exitCode).not.toBe(0);
674
+
675
+ // Clean up so subsequent test runs are clean
676
+ const { unlink } = await import("node:fs/promises");
677
+ await unlink(join(routeDir, "bad.ts"));
678
+ });
679
+
680
+ test("params properties are typed as string", async () => {
681
+ // Assigning params.slug to a number should fail
682
+ const routeDir = join(tscDir, "src", "routes", "blog", "[slug]");
683
+ await writeFile(
684
+ join(routeDir, "wrong-param-type.ts"),
685
+ `import type { PageProps } from "./$types";
686
+ declare const props: PageProps;
687
+ const _n: number = props.params.slug;
688
+ export {};`,
689
+ );
690
+
691
+ const result = runTsc(tscDir);
692
+ expect(result.exitCode).not.toBe(0);
693
+
694
+ const { unlink } = await import("node:fs/promises");
695
+ await unlink(join(routeDir, "wrong-param-type.ts"));
696
+ });
697
+ });