@remix-run/cli 0.0.0 → 0.2.0

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 (159) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +77 -3
  3. package/bootstrap/.agents/skills/remix/SKILL.md +501 -0
  4. package/bootstrap/.agents/skills/remix/references/animate-elements.md +195 -0
  5. package/bootstrap/.agents/skills/remix/references/assets-and-browser-modules.md +122 -0
  6. package/bootstrap/.agents/skills/remix/references/auth-and-sessions.md +420 -0
  7. package/bootstrap/.agents/skills/remix/references/component-model.md +282 -0
  8. package/bootstrap/.agents/skills/remix/references/create-mixins.md +158 -0
  9. package/bootstrap/.agents/skills/remix/references/data-and-validation.md +363 -0
  10. package/bootstrap/.agents/skills/remix/references/hydration-frames-navigation.md +297 -0
  11. package/bootstrap/.agents/skills/remix/references/middleware-and-server.md +243 -0
  12. package/bootstrap/.agents/skills/remix/references/mixins-styling-events.md +213 -0
  13. package/bootstrap/.agents/skills/remix/references/routing-and-controllers.md +324 -0
  14. package/bootstrap/.agents/skills/remix/references/testing-patterns.md +156 -0
  15. package/bootstrap/AGENTS.md +39 -0
  16. package/bootstrap/README.md +27 -0
  17. package/bootstrap/app/assets/entry.ts +19 -0
  18. package/bootstrap/app/assets.ts +18 -0
  19. package/bootstrap/app/controllers/auth.tsx +21 -0
  20. package/bootstrap/app/controllers/home.tsx +11 -0
  21. package/bootstrap/app/router.ts +16 -0
  22. package/bootstrap/app/routes.ts +7 -0
  23. package/bootstrap/app/ui/document.tsx +26 -0
  24. package/bootstrap/app/ui/layout.tsx +22 -0
  25. package/bootstrap/app/ui/prompt-button.tsx +162 -0
  26. package/bootstrap/app/ui/scaffold-home-page.tsx +526 -0
  27. package/bootstrap/app/utils/render.tsx +26 -0
  28. package/bootstrap/package.json +22 -0
  29. package/bootstrap/server.ts +37 -0
  30. package/bootstrap/tsconfig.json +18 -0
  31. package/dist/index.d.ts +2 -0
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +1 -0
  34. package/dist/lib/bootstrap-project.d.ts +17 -0
  35. package/dist/lib/bootstrap-project.d.ts.map +1 -0
  36. package/dist/lib/bootstrap-project.js +137 -0
  37. package/dist/lib/cli-context.d.ts +11 -0
  38. package/dist/lib/cli-context.d.ts.map +1 -0
  39. package/dist/lib/cli-context.js +19 -0
  40. package/dist/lib/cli.d.ts +6 -0
  41. package/dist/lib/cli.d.ts.map +1 -0
  42. package/dist/lib/cli.js +84 -0
  43. package/dist/lib/commands/completion.d.ts +3 -0
  44. package/dist/lib/commands/completion.d.ts.map +1 -0
  45. package/dist/lib/commands/completion.js +51 -0
  46. package/dist/lib/commands/doctor.d.ts +4 -0
  47. package/dist/lib/commands/doctor.d.ts.map +1 -0
  48. package/dist/lib/commands/doctor.js +293 -0
  49. package/dist/lib/commands/help.d.ts +4 -0
  50. package/dist/lib/commands/help.d.ts.map +1 -0
  51. package/dist/lib/commands/help.js +100 -0
  52. package/dist/lib/commands/new.d.ts +4 -0
  53. package/dist/lib/commands/new.d.ts.map +1 -0
  54. package/dist/lib/commands/new.js +70 -0
  55. package/dist/lib/commands/routes.d.ts +4 -0
  56. package/dist/lib/commands/routes.d.ts.map +1 -0
  57. package/dist/lib/commands/routes.js +161 -0
  58. package/dist/lib/commands/test.d.ts +4 -0
  59. package/dist/lib/commands/test.d.ts.map +1 -0
  60. package/dist/lib/commands/test.js +23 -0
  61. package/dist/lib/commands/version.d.ts +4 -0
  62. package/dist/lib/commands/version.d.ts.map +1 -0
  63. package/dist/lib/commands/version.js +29 -0
  64. package/dist/lib/completion.d.ts +12 -0
  65. package/dist/lib/completion.d.ts.map +1 -0
  66. package/dist/lib/completion.js +310 -0
  67. package/dist/lib/contained-path.d.ts +2 -0
  68. package/dist/lib/contained-path.d.ts.map +1 -0
  69. package/dist/lib/contained-path.js +10 -0
  70. package/dist/lib/controller-files.d.ts +14 -0
  71. package/dist/lib/controller-files.d.ts.map +1 -0
  72. package/dist/lib/controller-files.js +53 -0
  73. package/dist/lib/controller-ownership.d.ts +41 -0
  74. package/dist/lib/controller-ownership.d.ts.map +1 -0
  75. package/dist/lib/controller-ownership.js +224 -0
  76. package/dist/lib/display-path.d.ts +2 -0
  77. package/dist/lib/display-path.d.ts.map +1 -0
  78. package/dist/lib/display-path.js +12 -0
  79. package/dist/lib/doctor/controller-findings.d.ts +4 -0
  80. package/dist/lib/doctor/controller-findings.d.ts.map +1 -0
  81. package/dist/lib/doctor/controller-findings.js +132 -0
  82. package/dist/lib/doctor/controller-fix-plans.d.ts +4 -0
  83. package/dist/lib/doctor/controller-fix-plans.d.ts.map +1 -0
  84. package/dist/lib/doctor/controller-fix-plans.js +130 -0
  85. package/dist/lib/doctor/controller-placeholders.d.ts +4 -0
  86. package/dist/lib/doctor/controller-placeholders.d.ts.map +1 -0
  87. package/dist/lib/doctor/controller-placeholders.js +183 -0
  88. package/dist/lib/doctor/controllers.d.ts +8 -0
  89. package/dist/lib/doctor/controllers.d.ts.map +1 -0
  90. package/dist/lib/doctor/controllers.js +13 -0
  91. package/dist/lib/doctor/environment.d.ts +17 -0
  92. package/dist/lib/doctor/environment.d.ts.map +1 -0
  93. package/dist/lib/doctor/environment.js +226 -0
  94. package/dist/lib/doctor/fixes.d.ts +3 -0
  95. package/dist/lib/doctor/fixes.d.ts.map +1 -0
  96. package/dist/lib/doctor/fixes.js +65 -0
  97. package/dist/lib/doctor/project.d.ts +10 -0
  98. package/dist/lib/doctor/project.d.ts.map +1 -0
  99. package/dist/lib/doctor/project.js +371 -0
  100. package/dist/lib/doctor/types.d.ts +48 -0
  101. package/dist/lib/doctor/types.d.ts.map +1 -0
  102. package/dist/lib/doctor/types.js +15 -0
  103. package/dist/lib/errors.d.ts +167 -0
  104. package/dist/lib/errors.d.ts.map +1 -0
  105. package/dist/lib/errors.js +307 -0
  106. package/dist/lib/help-text.d.ts +13 -0
  107. package/dist/lib/help-text.d.ts.map +1 -0
  108. package/dist/lib/help-text.js +43 -0
  109. package/dist/lib/load-route-map-worker.d.ts +2 -0
  110. package/dist/lib/load-route-map-worker.d.ts.map +1 -0
  111. package/dist/lib/load-route-map-worker.js +92 -0
  112. package/dist/lib/parse-args.d.ts +22 -0
  113. package/dist/lib/parse-args.d.ts.map +1 -0
  114. package/dist/lib/parse-args.js +35 -0
  115. package/dist/lib/remix-version.d.ts +2 -0
  116. package/dist/lib/remix-version.d.ts.map +1 -0
  117. package/dist/lib/remix-version.js +58 -0
  118. package/dist/lib/reporter.d.ts +56 -0
  119. package/dist/lib/reporter.d.ts.map +1 -0
  120. package/dist/lib/reporter.js +357 -0
  121. package/dist/lib/route-map.d.ts +38 -0
  122. package/dist/lib/route-map.d.ts.map +1 -0
  123. package/dist/lib/route-map.js +195 -0
  124. package/dist/lib/terminal.d.ts +17 -0
  125. package/dist/lib/terminal.d.ts.map +1 -0
  126. package/dist/lib/terminal.js +66 -0
  127. package/package.json +47 -5
  128. package/src/index.ts +1 -0
  129. package/src/lib/bootstrap-project.ts +222 -0
  130. package/src/lib/cli-context.ts +38 -0
  131. package/src/lib/cli.ts +116 -0
  132. package/src/lib/commands/completion.ts +74 -0
  133. package/src/lib/commands/doctor.ts +393 -0
  134. package/src/lib/commands/help.ts +123 -0
  135. package/src/lib/commands/new.ts +104 -0
  136. package/src/lib/commands/routes.ts +251 -0
  137. package/src/lib/commands/test.ts +31 -0
  138. package/src/lib/commands/version.ts +39 -0
  139. package/src/lib/completion.ts +418 -0
  140. package/src/lib/contained-path.ts +13 -0
  141. package/src/lib/controller-files.ts +79 -0
  142. package/src/lib/controller-ownership.ts +397 -0
  143. package/src/lib/display-path.ts +16 -0
  144. package/src/lib/doctor/controller-findings.ts +157 -0
  145. package/src/lib/doctor/controller-fix-plans.ts +184 -0
  146. package/src/lib/doctor/controller-placeholders.ts +242 -0
  147. package/src/lib/doctor/controllers.ts +23 -0
  148. package/src/lib/doctor/environment.ts +289 -0
  149. package/src/lib/doctor/fixes.ts +84 -0
  150. package/src/lib/doctor/project.ts +435 -0
  151. package/src/lib/doctor/types.ts +95 -0
  152. package/src/lib/errors.ts +367 -0
  153. package/src/lib/help-text.ts +88 -0
  154. package/src/lib/load-route-map-worker.ts +110 -0
  155. package/src/lib/parse-args.ts +82 -0
  156. package/src/lib/remix-version.ts +80 -0
  157. package/src/lib/reporter.ts +535 -0
  158. package/src/lib/route-map.ts +303 -0
  159. package/src/lib/terminal.ts +86 -0
@@ -0,0 +1,12 @@
1
+ import * as path from 'node:path';
2
+ import * as process from 'node:process';
3
+ export function getDisplayPath(filePath, cwd = process.cwd()) {
4
+ let relativePath = path.relative(path.resolve(cwd), path.resolve(filePath));
5
+ if (relativePath.length === 0) {
6
+ return '.';
7
+ }
8
+ if (path.isAbsolute(relativePath)) {
9
+ return filePath;
10
+ }
11
+ return relativePath;
12
+ }
@@ -0,0 +1,4 @@
1
+ import type { ControllerOwnership } from '../controller-ownership.ts';
2
+ import type { DoctorFinding, DoctorFixPlan } from './types.ts';
3
+ export declare function getControllerFindings(ownership: ControllerOwnership, fixPlans: DoctorFixPlan[]): DoctorFinding[];
4
+ //# sourceMappingURL=controller-findings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"controller-findings.d.ts","sourceRoot":"","sources":["../../../src/lib/doctor/controller-findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,4BAA4B,CAAA;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE9D,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,mBAAmB,EAC9B,QAAQ,EAAE,aAAa,EAAE,GACxB,aAAa,EAAE,CAyBjB"}
@@ -0,0 +1,132 @@
1
+ export function getControllerFindings(ownership, fixPlans) {
2
+ return [
3
+ ...getSubtreeFindings(ownership.subtrees, fixPlans),
4
+ ...ownership.orphanActionPaths.map((actualPath) => ({
5
+ actualPath,
6
+ code: 'orphan-action',
7
+ message: `Standalone action ${actualPath} does not match any top-level route.`,
8
+ severity: 'warn',
9
+ suite: 'controllers',
10
+ })),
11
+ ...ownership.orphanControllerPaths.map((actualPath) => ({
12
+ actualPath,
13
+ code: 'orphan-controller',
14
+ message: `Controller ${actualPath} does not match any route group.`,
15
+ severity: 'warn',
16
+ suite: 'controllers',
17
+ })),
18
+ ...ownership.orphanRouteDirectoryPaths.map((actualPath) => ({
19
+ actualPath,
20
+ code: 'orphan-route-directory',
21
+ message: `Directory ${actualPath} does not match any route subtree.`,
22
+ severity: 'warn',
23
+ suite: 'controllers',
24
+ })),
25
+ ];
26
+ }
27
+ function getSubtreeFindings(subtrees, fixPlans) {
28
+ let findings = [];
29
+ let fixableFindingKeys = new Set(fixPlans.map((fixPlan) => `${fixPlan.code}:${fixPlan.routeName ?? ''}`));
30
+ for (let subtree of subtrees) {
31
+ let actualEntryPath = subtree.actualEntryPath ?? undefined;
32
+ let actualAlternatePath = subtree.actualAlternatePath ?? undefined;
33
+ if (subtree.actualEntryPaths.length > 1) {
34
+ findings.push({
35
+ actualPath: subtree.actualEntryPaths[0],
36
+ code: 'duplicate-owner-file',
37
+ expectedPath: subtree.entryDisplayPath,
38
+ message: `Route "${subtree.routeName}" has multiple ${subtree.kind} files: ${subtree.actualEntryPaths.join(', ')}. Keep only one ${subtree.kind} owner file.`,
39
+ routeName: subtree.routeName,
40
+ severity: 'warn',
41
+ suite: 'controllers',
42
+ });
43
+ continue;
44
+ }
45
+ if (subtree.actualAlternatePaths.length > 1) {
46
+ let alternateKind = subtree.kind === 'action' ? 'controller' : 'action';
47
+ findings.push({
48
+ actualPath: subtree.actualAlternatePaths[0],
49
+ code: 'duplicate-owner-file',
50
+ expectedPath: subtree.entryDisplayPath,
51
+ message: `Route "${subtree.routeName}" has multiple ${alternateKind} files: ${subtree.actualAlternatePaths.join(', ')}. Keep only one ${alternateKind} owner file.`,
52
+ routeName: subtree.routeName,
53
+ severity: 'warn',
54
+ suite: 'controllers',
55
+ });
56
+ continue;
57
+ }
58
+ if (actualEntryPath != null && actualAlternatePath != null) {
59
+ findings.push({
60
+ actualPath: actualAlternatePath,
61
+ code: 'ambiguous-owner',
62
+ expectedPath: actualEntryPath,
63
+ message: subtree.kind === 'action'
64
+ ? `Route "${subtree.routeName}" has both action ${actualEntryPath} and controller ${actualAlternatePath}.`
65
+ : `Route "${subtree.routeName}" has both controller ${actualEntryPath} and standalone action ${actualAlternatePath}.`,
66
+ routeName: subtree.routeName,
67
+ severity: 'warn',
68
+ suite: 'controllers',
69
+ });
70
+ continue;
71
+ }
72
+ if (actualAlternatePath != null) {
73
+ findings.push({
74
+ actualPath: actualAlternatePath,
75
+ code: 'wrong-owner-kind',
76
+ expectedPath: subtree.entryDisplayPath,
77
+ message: subtree.kind === 'action'
78
+ ? `Route "${subtree.routeName}" expects action ${subtree.entryDisplayPath}, but found controller ${actualAlternatePath}.`
79
+ : `Route "${subtree.routeName}" expects controller ${subtree.entryDisplayPath}, but found standalone action ${actualAlternatePath}.`,
80
+ fixable: fixableFindingKeys.has(`wrong-owner-kind:${subtree.routeName}`),
81
+ routeName: subtree.routeName,
82
+ severity: 'warn',
83
+ suite: 'controllers',
84
+ });
85
+ continue;
86
+ }
87
+ if (subtree.kind === 'controller' && subtree.actualEntryPath == null) {
88
+ let code = subtree.claimedFilePaths.length > 0
89
+ ? 'incomplete-controller'
90
+ : 'missing-owner';
91
+ findings.push({
92
+ actualPath: subtree.claimedFilePaths.length > 0 ? subtree.subtreePath : undefined,
93
+ code,
94
+ expectedPath: subtree.entryDisplayPath,
95
+ fixable: fixableFindingKeys.has(`${code}:${subtree.routeName}`),
96
+ message: subtree.claimedFilePaths.length > 0
97
+ ? `Route "${subtree.routeName}" has files under ${subtree.subtreePath}, but is missing controller ${subtree.entryDisplayPath}.`
98
+ : `Route "${subtree.routeName}" is missing controller ${subtree.entryDisplayPath}.`,
99
+ routeName: subtree.routeName,
100
+ severity: 'warn',
101
+ suite: 'controllers',
102
+ });
103
+ continue;
104
+ }
105
+ if (subtree.kind === 'action' && subtree.claimedFilePaths.length > 0) {
106
+ findings.push({
107
+ actualPath: subtree.subtreePath,
108
+ code: 'promotion-drift',
109
+ expectedPath: actualEntryPath ?? subtree.entryDisplayPath,
110
+ message: actualEntryPath == null
111
+ ? `Route "${subtree.routeName}" has files under ${subtree.subtreePath}, but is still expected to use action ${subtree.entryDisplayPath}. Promote it to controller ${subtree.alternateDisplayPath} or move the files back into ${subtree.entryDisplayPath}.`
112
+ : `Route "${subtree.routeName}" uses action ${actualEntryPath}, but also has files under ${subtree.subtreePath}. Promote it to controller ${subtree.alternateDisplayPath} or keep the route in ${actualEntryPath}.`,
113
+ routeName: subtree.routeName,
114
+ severity: 'warn',
115
+ suite: 'controllers',
116
+ });
117
+ continue;
118
+ }
119
+ if (subtree.actualEntryPath == null) {
120
+ findings.push({
121
+ code: 'missing-owner',
122
+ expectedPath: subtree.entryDisplayPath,
123
+ fixable: fixableFindingKeys.has(`missing-owner:${subtree.routeName}`),
124
+ message: `Route "${subtree.routeName}" is missing action ${subtree.entryDisplayPath}.`,
125
+ routeName: subtree.routeName,
126
+ severity: 'warn',
127
+ suite: 'controllers',
128
+ });
129
+ }
130
+ }
131
+ return findings;
132
+ }
@@ -0,0 +1,4 @@
1
+ import type { ControllerOwnership, OwnershipRouteNode } from '../controller-ownership.ts';
2
+ import type { DoctorFixPlan } from './types.ts';
3
+ export declare function getControllerFixPlans(appRoot: string, tree: OwnershipRouteNode[], ownership: ControllerOwnership): Promise<DoctorFixPlan[]>;
4
+ //# sourceMappingURL=controller-fix-plans.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"controller-fix-plans.d.ts","sourceRoot":"","sources":["../../../src/lib/doctor/controller-fix-plans.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,mBAAmB,EAEnB,kBAAkB,EACnB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,EAAE,EAC1B,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CAqD1B"}
@@ -0,0 +1,130 @@
1
+ import * as fs from 'node:fs/promises';
2
+ import * as path from 'node:path';
3
+ import { getOwnerCandidateForExtension, getOwnerFileExtension, } from "../controller-files.js";
4
+ import { renderActionPlaceholder, renderControllerPlaceholder } from "./controller-placeholders.js";
5
+ const OWNER_EXTENSION_PRIORITY = ['.tsx', '.ts', '.jsx', '.js'];
6
+ export async function getControllerFixPlans(appRoot, tree, ownership) {
7
+ let routeNodesByName = getRouteNodesByName(tree);
8
+ let hasTsconfig = await pathExists(path.join(appRoot, 'tsconfig.json'));
9
+ let resolvedEntryPathByRouteName = new Map();
10
+ for (let subtree of ownership.subtrees) {
11
+ if (subtree.actualEntryPath != null) {
12
+ resolvedEntryPathByRouteName.set(subtree.routeName, subtree.actualEntryPath);
13
+ continue;
14
+ }
15
+ let fixCode = getFixCodeForSubtree(subtree);
16
+ if (fixCode == null) {
17
+ continue;
18
+ }
19
+ let extension = inferOwnerExtension(subtree, ownership, hasTsconfig);
20
+ let targetPath = getOwnerCandidateForExtension(subtree.entryCandidates, extension) ?? subtree.entryDisplayPath;
21
+ resolvedEntryPathByRouteName.set(subtree.routeName, targetPath);
22
+ }
23
+ let fixPlans = [];
24
+ for (let subtree of ownership.subtrees) {
25
+ let code = getFixCodeForSubtree(subtree);
26
+ if (code == null) {
27
+ continue;
28
+ }
29
+ let routeNode = routeNodesByName.get(subtree.routeName);
30
+ let entryPath = resolvedEntryPathByRouteName.get(subtree.routeName);
31
+ if (routeNode == null || entryPath == null) {
32
+ continue;
33
+ }
34
+ let contents = subtree.kind === 'action'
35
+ ? renderActionPlaceholder(routeNode, entryPath)
36
+ : renderControllerPlaceholder(routeNode, entryPath, resolvedEntryPathByRouteName);
37
+ fixPlans.push({
38
+ code,
39
+ contents,
40
+ kind: 'create-file',
41
+ path: entryPath,
42
+ routeName: subtree.routeName,
43
+ suite: 'controllers',
44
+ });
45
+ }
46
+ return fixPlans;
47
+ }
48
+ function getFixCodeForSubtree(subtree) {
49
+ if (subtree.actualEntryPaths.length > 1 || subtree.actualAlternatePaths.length > 1) {
50
+ return null;
51
+ }
52
+ if (subtree.actualEntryPath != null) {
53
+ return null;
54
+ }
55
+ if (subtree.actualAlternatePath != null) {
56
+ return 'wrong-owner-kind';
57
+ }
58
+ if (subtree.kind === 'controller') {
59
+ return subtree.claimedFilePaths.length > 0 ? 'incomplete-controller' : 'missing-owner';
60
+ }
61
+ if (subtree.claimedFilePaths.length > 0) {
62
+ return null;
63
+ }
64
+ return 'missing-owner';
65
+ }
66
+ function inferOwnerExtension(subtree, ownership, hasTsconfig) {
67
+ let subtreeExtension = getMostCommonOwnerExtension(subtree.claimedRouteLocalFilePaths);
68
+ if (subtreeExtension != null) {
69
+ return subtreeExtension;
70
+ }
71
+ let alternateExtension = getMostCommonOwnerExtension(subtree.actualAlternatePaths);
72
+ if (alternateExtension != null) {
73
+ return alternateExtension;
74
+ }
75
+ let projectExtension = getMostCommonOwnerExtension([
76
+ ...ownership.scan.actionEntryPaths,
77
+ ...ownership.scan.controllerEntryPaths,
78
+ ]);
79
+ if (projectExtension != null) {
80
+ return projectExtension;
81
+ }
82
+ return hasTsconfig ? '.tsx' : '.js';
83
+ }
84
+ function getMostCommonOwnerExtension(filePaths) {
85
+ let counts = new Map();
86
+ for (let filePath of filePaths) {
87
+ let extension = getOwnerFileExtension(filePath);
88
+ if (extension == null) {
89
+ continue;
90
+ }
91
+ counts.set(extension, (counts.get(extension) ?? 0) + 1);
92
+ }
93
+ if (counts.size === 0) {
94
+ return null;
95
+ }
96
+ let bestExtension = null;
97
+ let bestCount = -1;
98
+ for (let extension of OWNER_EXTENSION_PRIORITY) {
99
+ let count = counts.get(extension) ?? 0;
100
+ if (count > bestCount) {
101
+ bestCount = count;
102
+ bestExtension = extension;
103
+ }
104
+ }
105
+ return bestExtension;
106
+ }
107
+ function getRouteNodesByName(tree) {
108
+ let routeNodesByName = new Map();
109
+ function visit(nodes) {
110
+ for (let node of nodes) {
111
+ routeNodesByName.set(node.name, node);
112
+ visit(node.children);
113
+ }
114
+ }
115
+ visit(tree);
116
+ return routeNodesByName;
117
+ }
118
+ async function pathExists(filePath) {
119
+ try {
120
+ await fs.access(filePath);
121
+ return true;
122
+ }
123
+ catch (error) {
124
+ let nodeError = error;
125
+ if (nodeError.code === 'ENOENT') {
126
+ return false;
127
+ }
128
+ throw error;
129
+ }
130
+ }
@@ -0,0 +1,4 @@
1
+ import type { OwnershipRouteNode } from '../controller-ownership.ts';
2
+ export declare function renderActionPlaceholder(routeNode: OwnershipRouteNode, entryPath: string): string;
3
+ export declare function renderControllerPlaceholder(routeNode: OwnershipRouteNode, entryPath: string, resolvedEntryPathByRouteName: Map<string, string>): string;
4
+ //# sourceMappingURL=controller-placeholders.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"controller-placeholders.d.ts","sourceRoot":"","sources":["../../../src/lib/doctor/controller-placeholders.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAmDpE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgChG;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,MAAM,EACjB,4BAA4B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChD,MAAM,CAkCR"}
@@ -0,0 +1,183 @@
1
+ import * as path from 'node:path';
2
+ import { getOwnerFileExtension } from "../controller-files.js";
3
+ const RESERVED_BINDING_IDENTIFIERS = new Set([
4
+ 'await',
5
+ 'break',
6
+ 'case',
7
+ 'catch',
8
+ 'class',
9
+ 'const',
10
+ 'continue',
11
+ 'debugger',
12
+ 'default',
13
+ 'delete',
14
+ 'do',
15
+ 'else',
16
+ 'enum',
17
+ 'export',
18
+ 'extends',
19
+ 'false',
20
+ 'finally',
21
+ 'for',
22
+ 'function',
23
+ 'if',
24
+ 'implements',
25
+ 'import',
26
+ 'in',
27
+ 'instanceof',
28
+ 'interface',
29
+ 'let',
30
+ 'new',
31
+ 'null',
32
+ 'package',
33
+ 'private',
34
+ 'protected',
35
+ 'public',
36
+ 'return',
37
+ 'static',
38
+ 'super',
39
+ 'switch',
40
+ 'this',
41
+ 'throw',
42
+ 'true',
43
+ 'try',
44
+ 'typeof',
45
+ 'var',
46
+ 'void',
47
+ 'while',
48
+ 'with',
49
+ 'yield',
50
+ ]);
51
+ export function renderActionPlaceholder(routeNode, entryPath) {
52
+ let routeMessage = `TODO: implement routes.${routeNode.name}`;
53
+ let extension = getOwnerFileExtension(entryPath);
54
+ let exportName = getActionExportName(routeNode.key);
55
+ if (extension === '.js' || extension === '.jsx') {
56
+ return [
57
+ `export const ${exportName} = {`,
58
+ ` handler() {`,
59
+ ` return new Response(${JSON.stringify(routeMessage)})`,
60
+ ` },`,
61
+ `}`,
62
+ '',
63
+ ].join('\n');
64
+ }
65
+ let routeExpression = getRouteAccessExpression(routeNode.name);
66
+ let routesImportPath = getRelativeImportPath(entryPath, 'app/routes.ts');
67
+ let method = routeNode.method ?? 'ANY';
68
+ return [
69
+ `import type { BuildAction } from 'remix/fetch-router'`,
70
+ '',
71
+ `import type { routes } from '${routesImportPath}'`,
72
+ '',
73
+ `export const ${exportName}: BuildAction<'${method}', typeof ${routeExpression}> = {`,
74
+ ` handler() {`,
75
+ ` return new Response(${JSON.stringify(routeMessage)})`,
76
+ ` },`,
77
+ `}`,
78
+ '',
79
+ ].join('\n');
80
+ }
81
+ export function renderControllerPlaceholder(routeNode, entryPath, resolvedEntryPathByRouteName) {
82
+ let extension = getOwnerFileExtension(entryPath);
83
+ let lines = [];
84
+ let childImports = getControllerChildImports(routeNode, entryPath, resolvedEntryPathByRouteName);
85
+ let actionEntries = routeNode.children.map((childNode) => renderControllerActionEntry(childNode, entryPath, resolvedEntryPathByRouteName));
86
+ if (extension === '.js' || extension === '.jsx') {
87
+ if (childImports.length > 0) {
88
+ lines.push(...childImports, '');
89
+ }
90
+ lines.push('export default {', ' actions: {');
91
+ lines.push(...actionEntries);
92
+ lines.push(' },', '}', '');
93
+ return lines.join('\n');
94
+ }
95
+ let routeExpression = getRouteAccessExpression(routeNode.name);
96
+ let routesImportPath = getRelativeImportPath(entryPath, 'app/routes.ts');
97
+ lines.push(`import type { Controller } from 'remix/fetch-router'`, '');
98
+ lines.push(`import type { routes } from '${routesImportPath}'`);
99
+ if (childImports.length > 0) {
100
+ lines.push('', ...childImports);
101
+ }
102
+ lines.push('', 'export default {', ' actions: {');
103
+ lines.push(...actionEntries);
104
+ lines.push(' },', `} satisfies Controller<typeof ${routeExpression}>`, '');
105
+ return lines.join('\n');
106
+ }
107
+ function getControllerChildImports(routeNode, entryPath, resolvedEntryPathByRouteName) {
108
+ let imports = [];
109
+ for (let childNode of routeNode.children) {
110
+ if (childNode.kind !== 'group') {
111
+ continue;
112
+ }
113
+ let childEntryPath = resolvedEntryPathByRouteName.get(childNode.name);
114
+ if (childEntryPath == null) {
115
+ continue;
116
+ }
117
+ imports.push(`import ${getControllerImportName(childNode.key)} from '${getRelativeImportPath(entryPath, childEntryPath)}'`);
118
+ }
119
+ return imports;
120
+ }
121
+ function renderControllerActionEntry(childNode, entryPath, resolvedEntryPathByRouteName) {
122
+ if (childNode.kind === 'route') {
123
+ return [
124
+ ` ${formatObjectKey(childNode.key)}() {`,
125
+ ` return new Response(${JSON.stringify(`TODO: implement routes.${childNode.name}`)})`,
126
+ ` },`,
127
+ ].join('\n');
128
+ }
129
+ let childEntryPath = resolvedEntryPathByRouteName.get(childNode.name);
130
+ if (childEntryPath != null) {
131
+ return ` ${formatObjectKey(childNode.key)}: ${getControllerImportName(childNode.key)},`;
132
+ }
133
+ return ` ${formatObjectKey(childNode.key)}: ${renderInlineControllerPlaceholder(childNode)},`;
134
+ }
135
+ function renderInlineControllerPlaceholder(routeNode) {
136
+ let childEntries = routeNode.children.map((childNode) => childNode.kind === 'route'
137
+ ? `${formatObjectKey(childNode.key)}() { return new Response(${JSON.stringify(`TODO: implement routes.${childNode.name}`)}) }`
138
+ : `${formatObjectKey(childNode.key)}: ${renderInlineControllerPlaceholder(childNode)}`);
139
+ return `{ actions: { ${childEntries.join(', ')} } }`;
140
+ }
141
+ function getControllerImportName(key) {
142
+ return `${toIdentifier(key)}Controller`;
143
+ }
144
+ function getActionExportName(key) {
145
+ return toIdentifier(key);
146
+ }
147
+ function getRouteAccessExpression(routeName) {
148
+ let segments = routeName.split('.');
149
+ let expression = 'routes';
150
+ for (let segment of segments) {
151
+ expression += isIdentifier(segment) ? `.${segment}` : `[${JSON.stringify(segment)}]`;
152
+ }
153
+ return expression;
154
+ }
155
+ function getRelativeImportPath(fromFilePath, toFilePath) {
156
+ let relativePath = path.posix.relative(path.posix.dirname(fromFilePath), toFilePath);
157
+ return relativePath.startsWith('.') ? relativePath : `./${relativePath}`;
158
+ }
159
+ function formatObjectKey(key) {
160
+ return isIdentifier(key) ? key : JSON.stringify(key);
161
+ }
162
+ function toIdentifier(value) {
163
+ let parts = value.split(/[^A-Za-z0-9_$]+/).filter(Boolean);
164
+ if (parts.length === 0) {
165
+ return 'route';
166
+ }
167
+ let identifier = parts
168
+ .map((part, index) => index === 0 ? part.replace(/^./, (char) => char.toLowerCase()) : capitalize(part))
169
+ .join('');
170
+ if (!/^[A-Za-z_$]/.test(identifier)) {
171
+ return `route${capitalize(identifier)}`;
172
+ }
173
+ if (RESERVED_BINDING_IDENTIFIERS.has(identifier)) {
174
+ return `route${capitalize(identifier)}`;
175
+ }
176
+ return identifier;
177
+ }
178
+ function capitalize(value) {
179
+ return value.length === 0 ? value : `${value[0].toUpperCase()}${value.slice(1)}`;
180
+ }
181
+ function isIdentifier(value) {
182
+ return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value);
183
+ }
@@ -0,0 +1,8 @@
1
+ import { type OwnershipRouteNode } from '../controller-ownership.ts';
2
+ import { type DoctorFixPlan, type DoctorSuiteResult } from './types.ts';
3
+ export interface ControllerDoctorResult {
4
+ fixPlans: DoctorFixPlan[];
5
+ suite: DoctorSuiteResult;
6
+ }
7
+ export declare function checkControllerConventions(appRoot: string, tree: OwnershipRouteNode[]): Promise<ControllerDoctorResult>;
8
+ //# sourceMappingURL=controllers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"controllers.d.ts","sourceRoot":"","sources":["../../../src/lib/doctor/controllers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAGhG,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE1F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,KAAK,EAAE,iBAAiB,CAAA;CACzB;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,EAAE,GACzB,OAAO,CAAC,sBAAsB,CAAC,CASjC"}
@@ -0,0 +1,13 @@
1
+ import { inspectControllerOwnership } from "../controller-ownership.js";
2
+ import { getControllerFindings } from "./controller-findings.js";
3
+ import { getControllerFixPlans } from "./controller-fix-plans.js";
4
+ import { createDoctorSuite } from "./types.js";
5
+ export async function checkControllerConventions(appRoot, tree) {
6
+ let ownership = await inspectControllerOwnership(appRoot, tree);
7
+ let fixPlans = await getControllerFixPlans(appRoot, tree, ownership);
8
+ let findings = getControllerFindings(ownership, fixPlans);
9
+ return {
10
+ fixPlans,
11
+ suite: createDoctorSuite('controllers', findings),
12
+ };
13
+ }
@@ -0,0 +1,17 @@
1
+ import { type DoctorFixPlan, type DoctorSuiteResult } from './types.ts';
2
+ interface DoctorPackageJson {
3
+ dependencies?: Record<string, string>;
4
+ devDependencies?: Record<string, string>;
5
+ engines?: Record<string, string>;
6
+ name?: string;
7
+ }
8
+ export interface EnvironmentDoctorResult {
9
+ packageJson?: DoctorPackageJson;
10
+ packageJsonPath?: string;
11
+ projectRoot?: string;
12
+ suite: DoctorSuiteResult;
13
+ }
14
+ export declare function checkEnvironment(cwd?: string): Promise<EnvironmentDoctorResult>;
15
+ export declare function getEnvironmentFixPlans(result: EnvironmentDoctorResult, remixVersion: string | undefined): DoctorFixPlan[];
16
+ export {};
17
+ //# sourceMappingURL=environment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/lib/doctor/environment.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAA;AAEnB,UAAU,iBAAiB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,iBAAiB,CAAA;CACzB;AAED,wBAAsB,gBAAgB,CACpC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,CAwFlC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,uBAAuB,EAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,aAAa,EAAE,CA6CjB"}