@mandujs/core 0.12.1 โ†’ 0.13.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 (177) hide show
  1. package/README.ko.md +304 -304
  2. package/README.md +653 -653
  3. package/package.json +8 -8
  4. package/src/brain/architecture/analyzer.ts +28 -26
  5. package/src/brain/doctor/analyzer.ts +1 -1
  6. package/src/bundler/build.ts +91 -91
  7. package/src/bundler/css.ts +302 -302
  8. package/src/bundler/dev.ts +0 -1
  9. package/src/change/history.ts +3 -3
  10. package/src/change/snapshot.ts +10 -9
  11. package/src/change/transaction.ts +2 -2
  12. package/src/client/Link.tsx +227 -227
  13. package/src/client/globals.ts +44 -44
  14. package/src/client/hooks.ts +267 -267
  15. package/src/client/index.ts +5 -5
  16. package/src/client/island.ts +8 -8
  17. package/src/client/router.ts +435 -435
  18. package/src/client/runtime.ts +23 -23
  19. package/src/client/serialize.ts +404 -404
  20. package/src/client/window-state.ts +101 -101
  21. package/src/config/mandu.ts +94 -96
  22. package/src/config/validate.ts +213 -215
  23. package/src/config/watcher.ts +311 -311
  24. package/src/constants.ts +40 -40
  25. package/src/content/content-layer.ts +314 -314
  26. package/src/content/content.test.ts +433 -433
  27. package/src/content/data-store.ts +245 -245
  28. package/src/content/digest.ts +133 -133
  29. package/src/content/index.ts +164 -164
  30. package/src/content/loader-context.ts +172 -172
  31. package/src/content/loaders/api.ts +216 -216
  32. package/src/content/loaders/file.ts +169 -169
  33. package/src/content/loaders/glob.ts +252 -252
  34. package/src/content/loaders/index.ts +34 -34
  35. package/src/content/loaders/types.ts +137 -137
  36. package/src/content/meta-store.ts +209 -209
  37. package/src/content/types.ts +282 -282
  38. package/src/content/watcher.ts +135 -135
  39. package/src/contract/client-safe.test.ts +42 -42
  40. package/src/contract/client-safe.ts +114 -114
  41. package/src/contract/client.ts +16 -16
  42. package/src/contract/define.ts +459 -459
  43. package/src/contract/handler.ts +10 -10
  44. package/src/contract/normalize.test.ts +276 -276
  45. package/src/contract/normalize.ts +404 -404
  46. package/src/contract/registry.test.ts +206 -206
  47. package/src/contract/registry.ts +568 -568
  48. package/src/contract/schema.ts +48 -48
  49. package/src/contract/types.ts +58 -58
  50. package/src/contract/validator.ts +32 -32
  51. package/src/devtools/ai/context-builder.ts +375 -375
  52. package/src/devtools/ai/index.ts +25 -25
  53. package/src/devtools/ai/mcp-connector.ts +465 -465
  54. package/src/devtools/client/catchers/error-catcher.ts +327 -327
  55. package/src/devtools/client/catchers/index.ts +18 -18
  56. package/src/devtools/client/catchers/network-proxy.ts +363 -363
  57. package/src/devtools/client/components/index.ts +39 -39
  58. package/src/devtools/client/components/kitchen-root.tsx +362 -362
  59. package/src/devtools/client/components/mandu-character.tsx +241 -241
  60. package/src/devtools/client/components/overlay.tsx +368 -368
  61. package/src/devtools/client/components/panel/errors-panel.tsx +259 -259
  62. package/src/devtools/client/components/panel/guard-panel.tsx +244 -244
  63. package/src/devtools/client/components/panel/index.ts +32 -32
  64. package/src/devtools/client/components/panel/islands-panel.tsx +304 -304
  65. package/src/devtools/client/components/panel/network-panel.tsx +292 -292
  66. package/src/devtools/client/components/panel/panel-container.tsx +259 -259
  67. package/src/devtools/client/filters/context-filters.ts +282 -282
  68. package/src/devtools/client/filters/index.ts +16 -16
  69. package/src/devtools/client/index.ts +63 -63
  70. package/src/devtools/client/persistence.ts +335 -335
  71. package/src/devtools/client/state-manager.ts +478 -478
  72. package/src/devtools/design-tokens.ts +263 -263
  73. package/src/devtools/hook/create-hook.ts +207 -207
  74. package/src/devtools/hook/index.ts +13 -13
  75. package/src/devtools/index.ts +439 -439
  76. package/src/devtools/init.ts +266 -266
  77. package/src/devtools/protocol.ts +237 -237
  78. package/src/devtools/server/index.ts +17 -17
  79. package/src/devtools/server/source-context.ts +444 -444
  80. package/src/devtools/types.ts +319 -319
  81. package/src/devtools/worker/index.ts +25 -25
  82. package/src/devtools/worker/redaction-worker.ts +222 -222
  83. package/src/devtools/worker/worker-manager.ts +409 -409
  84. package/src/error/classifier.ts +2 -2
  85. package/src/error/domains.ts +265 -265
  86. package/src/error/formatter.ts +32 -32
  87. package/src/error/result.ts +46 -46
  88. package/src/error/stack-analyzer.ts +5 -0
  89. package/src/error/types.ts +6 -6
  90. package/src/errors/extractor.ts +409 -409
  91. package/src/errors/index.ts +19 -19
  92. package/src/filling/auth.ts +308 -308
  93. package/src/filling/context.ts +569 -569
  94. package/src/filling/deps.ts +238 -238
  95. package/src/generator/contract-glue.ts +2 -1
  96. package/src/generator/generate.ts +12 -10
  97. package/src/generator/index.ts +3 -3
  98. package/src/generator/templates.ts +80 -79
  99. package/src/guard/analyzer.ts +360 -360
  100. package/src/guard/ast-analyzer.ts +806 -806
  101. package/src/guard/auto-correct.ts +1 -1
  102. package/src/guard/check.ts +128 -128
  103. package/src/guard/contract-guard.ts +9 -9
  104. package/src/guard/file-type.test.ts +24 -24
  105. package/src/guard/healing.ts +2 -0
  106. package/src/guard/index.ts +2 -0
  107. package/src/guard/negotiation.ts +430 -4
  108. package/src/guard/presets/atomic.ts +70 -70
  109. package/src/guard/presets/clean.ts +77 -77
  110. package/src/guard/presets/cqrs.test.ts +175 -0
  111. package/src/guard/presets/cqrs.ts +107 -0
  112. package/src/guard/presets/fsd.ts +79 -79
  113. package/src/guard/presets/hexagonal.ts +68 -68
  114. package/src/guard/presets/index.ts +291 -288
  115. package/src/guard/reporter.ts +445 -445
  116. package/src/guard/rules.ts +12 -12
  117. package/src/guard/statistics.ts +578 -578
  118. package/src/guard/suggestions.ts +358 -352
  119. package/src/guard/types.ts +348 -347
  120. package/src/guard/validator.ts +834 -834
  121. package/src/guard/watcher.ts +404 -404
  122. package/src/index.ts +1 -0
  123. package/src/intent/index.ts +310 -310
  124. package/src/island/index.ts +304 -304
  125. package/src/logging/index.ts +22 -22
  126. package/src/logging/transports.ts +365 -365
  127. package/src/paths.test.ts +47 -0
  128. package/src/paths.ts +47 -0
  129. package/src/plugins/index.ts +38 -38
  130. package/src/plugins/registry.ts +377 -377
  131. package/src/plugins/types.ts +363 -363
  132. package/src/report/build.ts +1 -1
  133. package/src/report/index.ts +1 -1
  134. package/src/router/fs-patterns.ts +387 -387
  135. package/src/router/fs-routes.ts +344 -401
  136. package/src/router/fs-scanner.ts +497 -497
  137. package/src/router/fs-types.ts +270 -278
  138. package/src/router/index.ts +81 -81
  139. package/src/runtime/boundary.tsx +232 -232
  140. package/src/runtime/compose.ts +222 -222
  141. package/src/runtime/lifecycle.ts +381 -381
  142. package/src/runtime/logger.test.ts +345 -345
  143. package/src/runtime/logger.ts +677 -677
  144. package/src/runtime/router.test.ts +476 -476
  145. package/src/runtime/router.ts +105 -105
  146. package/src/runtime/security.ts +155 -155
  147. package/src/runtime/server.ts +24 -24
  148. package/src/runtime/session-key.ts +328 -328
  149. package/src/runtime/ssr.ts +367 -367
  150. package/src/runtime/streaming-ssr.ts +1245 -1245
  151. package/src/runtime/trace.ts +144 -144
  152. package/src/seo/index.ts +214 -214
  153. package/src/seo/integration/ssr.ts +307 -307
  154. package/src/seo/render/basic.ts +427 -427
  155. package/src/seo/render/index.ts +143 -143
  156. package/src/seo/render/jsonld.ts +539 -539
  157. package/src/seo/render/opengraph.ts +191 -191
  158. package/src/seo/render/robots.ts +116 -116
  159. package/src/seo/render/sitemap.ts +137 -137
  160. package/src/seo/render/twitter.ts +126 -126
  161. package/src/seo/resolve/index.ts +353 -353
  162. package/src/seo/resolve/opengraph.ts +143 -143
  163. package/src/seo/resolve/robots.ts +73 -73
  164. package/src/seo/resolve/title.ts +94 -94
  165. package/src/seo/resolve/twitter.ts +73 -73
  166. package/src/seo/resolve/url.ts +97 -97
  167. package/src/seo/routes/index.ts +290 -290
  168. package/src/seo/types.ts +575 -575
  169. package/src/slot/validator.ts +39 -39
  170. package/src/spec/index.ts +3 -3
  171. package/src/spec/load.ts +76 -76
  172. package/src/spec/lock.ts +56 -56
  173. package/src/utils/bun.ts +8 -8
  174. package/src/utils/lru-cache.ts +75 -75
  175. package/src/utils/safe-io.ts +188 -188
  176. package/src/utils/string-safe.ts +298 -298
  177. package/src/watcher/rules.ts +5 -5
@@ -1,4 +1,5 @@
1
1
  import type { RouteSpec } from "../spec/schema";
2
+ import { GENERATED_RELATIVE_PATHS } from "../paths";
2
3
 
3
4
  export function generateApiHandler(route: RouteSpec): string {
4
5
  // contractModule + slotModule์ด ์žˆ์œผ๋ฉด contract ๊ฒ€์ฆ ๋ฒ„์ „ ์ƒ์„ฑ
@@ -29,7 +30,7 @@ export default function handler(req: Request, params: Record<string, string>): R
29
30
  }
30
31
 
31
32
  export function generateApiHandlerWithSlot(route: RouteSpec): string {
32
- const slotImportPath = computeSlotImportPath(route.slotModule!, "apps/server/generated/routes");
33
+ const slotImportPath = computeSlotImportPath(route.slotModule!, GENERATED_RELATIVE_PATHS.serverRoutes);
33
34
 
34
35
  return `// Generated by Mandu - DO NOT EDIT DIRECTLY
35
36
  // Route ID: ${route.id}
@@ -49,8 +50,8 @@ export default async function handler(
49
50
  }
50
51
 
51
52
  export function generateApiHandlerWithContract(route: RouteSpec): string {
52
- const slotImportPath = computeSlotImportPath(route.slotModule!, "apps/server/generated/routes");
53
- const contractImportPath = computeSlotImportPath(route.contractModule!, "apps/server/generated/routes");
53
+ const slotImportPath = computeSlotImportPath(route.slotModule!, GENERATED_RELATIVE_PATHS.serverRoutes);
54
+ const contractImportPath = computeSlotImportPath(route.contractModule!, GENERATED_RELATIVE_PATHS.serverRoutes);
54
55
 
55
56
  return `// Generated by Mandu - DO NOT EDIT DIRECTLY
56
57
  // Route ID: ${route.id}
@@ -110,14 +111,14 @@ export default async function handler(
110
111
  `;
111
112
  }
112
113
 
113
- export function generateSlotLogic(route: RouteSpec): string {
114
- if (route.contractModule) {
115
- return generateSlotLogicWithContract(route);
116
- }
117
-
118
- return `// ๐ŸฅŸ Mandu Filling - ${route.id}
119
- // Pattern: ${route.pattern}
120
- // ์ด ํŒŒ์ผ์—์„œ ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง์„ ๊ตฌํ˜„ํ•˜์„ธ์š”.
114
+ export function generateSlotLogic(route: RouteSpec): string {
115
+ if (route.contractModule) {
116
+ return generateSlotLogicWithContract(route);
117
+ }
118
+
119
+ return `// ๐ŸฅŸ Mandu Filling - ${route.id}
120
+ // Pattern: ${route.pattern}
121
+ // ์ด ํŒŒ์ผ์—์„œ ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง์„ ๊ตฌํ˜„ํ•˜์„ธ์š”.
121
122
 
122
123
  import { Mandu } from "@mandujs/core";
123
124
 
@@ -149,67 +150,67 @@ export default Mandu.filling()
149
150
  // ๐Ÿ’ก Context (ctx) API:
150
151
  // ctx.query - Query parameters { name: 'value' }
151
152
  // ctx.params - Path parameters { id: '123' }
152
- // ctx.body() - Request body (์ž๋™ ํŒŒ์‹ฑ)
153
- // ctx.body(zodSchema) - Body with validation
154
- // ctx.headers - Request headers
155
- // ctx.ok(data) - 200 OK
156
- // ctx.created(data) - 201 Created
157
- // ctx.error(msg) - 400 Bad Request
158
- // ctx.notFound(msg) - 404 Not Found
159
- // ctx.set(key, value) - Guard์—์„œ Handler๋กœ ๋ฐ์ดํ„ฐ ์ „๋‹ฌ
160
- // ctx.get(key) - Guard์—์„œ ์„ค์ •ํ•œ ๋ฐ์ดํ„ฐ ์ฝ๊ธฐ
161
- `;
162
- }
163
-
164
- export function generateSlotLogicWithContract(route: RouteSpec): string {
165
- const contractImportPath = computeSlotImportPath(
166
- route.contractModule!,
167
- pathDirname(route.slotModule ?? "spec/slots")
168
- );
169
-
170
- return `// ๐ŸฅŸ Mandu Filling - ${route.id}
171
- // Pattern: ${route.pattern}
172
- // Contract Module: ${route.contractModule}
173
- // ์ด ํŒŒ์ผ์—์„œ ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง์„ ๊ตฌํ˜„ํ•˜์„ธ์š”.
174
-
175
- import { Mandu } from "@mandujs/core";
176
- import contract from "${contractImportPath}";
177
-
178
- export default Mandu.filling()
179
- // ๐Ÿ“‹ GET ${route.pattern}
180
- .get(async (ctx) => {
181
- const input = await ctx.input(contract, "GET", ctx.params);
182
- // TODO: ๊ณ„์•ฝ์˜ ์‘๋‹ต ์ฝ”๋“œ์— ๋งž๊ฒŒ status๋ฅผ ์กฐ์ •ํ•˜์„ธ์š”
183
- return ctx.output(contract, 200, {
184
- message: "Hello from ${route.id}!",
185
- input,
186
- timestamp: new Date().toISOString(),
187
- });
188
- })
189
-
190
- // โž• POST ${route.pattern}
191
- .post(async (ctx) => {
192
- const input = await ctx.input(contract, "POST", ctx.params);
193
- // TODO: ๊ณ„์•ฝ์˜ ์‘๋‹ต ์ฝ”๋“œ์— ๋งž๊ฒŒ status๋ฅผ ์กฐ์ •ํ•˜์„ธ์š”
194
- return ctx.output(contract, 201, {
195
- message: "Created!",
196
- input,
197
- timestamp: new Date().toISOString(),
198
- });
199
- });
200
-
201
- // ๐Ÿ’ก Contract ๊ธฐ๋ฐ˜ ์‚ฌ์šฉ๋ฒ•:
202
- // ctx.input(contract, "GET") - Contract๋กœ ์š”์ฒญ ๊ฒ€์ฆ + ์ •๊ทœํ™”
203
- // ctx.output(contract, 200, data) - Contract๋กœ ์‘๋‹ต ๊ฒ€์ฆ
204
- // ctx.okContract(contract, data) - 200 OK (Contract ๊ฒ€์ฆ)
205
- // ctx.createdContract(contract, data) - 201 Created (Contract ๊ฒ€์ฆ)
206
- `;
207
- }
153
+ // ctx.body() - Request body (์ž๋™ ํŒŒ์‹ฑ)
154
+ // ctx.body(zodSchema) - Body with validation
155
+ // ctx.headers - Request headers
156
+ // ctx.ok(data) - 200 OK
157
+ // ctx.created(data) - 201 Created
158
+ // ctx.error(msg) - 400 Bad Request
159
+ // ctx.notFound(msg) - 404 Not Found
160
+ // ctx.set(key, value) - Guard์—์„œ Handler๋กœ ๋ฐ์ดํ„ฐ ์ „๋‹ฌ
161
+ // ctx.get(key) - Guard์—์„œ ์„ค์ •ํ•œ ๋ฐ์ดํ„ฐ ์ฝ๊ธฐ
162
+ `;
163
+ }
164
+
165
+ export function generateSlotLogicWithContract(route: RouteSpec): string {
166
+ const contractImportPath = computeSlotImportPath(
167
+ route.contractModule!,
168
+ pathDirname(route.slotModule ?? "spec/slots")
169
+ );
170
+
171
+ return `// ๐ŸฅŸ Mandu Filling - ${route.id}
172
+ // Pattern: ${route.pattern}
173
+ // Contract Module: ${route.contractModule}
174
+ // ์ด ํŒŒ์ผ์—์„œ ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง์„ ๊ตฌํ˜„ํ•˜์„ธ์š”.
175
+
176
+ import { Mandu } from "@mandujs/core";
177
+ import contract from "${contractImportPath}";
178
+
179
+ export default Mandu.filling()
180
+ // ๐Ÿ“‹ GET ${route.pattern}
181
+ .get(async (ctx) => {
182
+ const input = await ctx.input(contract, "GET", ctx.params);
183
+ // TODO: ๊ณ„์•ฝ์˜ ์‘๋‹ต ์ฝ”๋“œ์— ๋งž๊ฒŒ status๋ฅผ ์กฐ์ •ํ•˜์„ธ์š”
184
+ return ctx.output(contract, 200, {
185
+ message: "Hello from ${route.id}!",
186
+ input,
187
+ timestamp: new Date().toISOString(),
188
+ });
189
+ })
190
+
191
+ // โž• POST ${route.pattern}
192
+ .post(async (ctx) => {
193
+ const input = await ctx.input(contract, "POST", ctx.params);
194
+ // TODO: ๊ณ„์•ฝ์˜ ์‘๋‹ต ์ฝ”๋“œ์— ๋งž๊ฒŒ status๋ฅผ ์กฐ์ •ํ•˜์„ธ์š”
195
+ return ctx.output(contract, 201, {
196
+ message: "Created!",
197
+ input,
198
+ timestamp: new Date().toISOString(),
199
+ });
200
+ });
201
+
202
+ // ๐Ÿ’ก Contract ๊ธฐ๋ฐ˜ ์‚ฌ์šฉ๋ฒ•:
203
+ // ctx.input(contract, "GET") - Contract๋กœ ์š”์ฒญ ๊ฒ€์ฆ + ์ •๊ทœํ™”
204
+ // ctx.output(contract, 200, data) - Contract๋กœ ์‘๋‹ต ๊ฒ€์ฆ
205
+ // ctx.okContract(contract, data) - 200 OK (Contract ๊ฒ€์ฆ)
206
+ // ctx.createdContract(contract, data) - 201 Created (Contract ๊ฒ€์ฆ)
207
+ `;
208
+ }
208
209
 
209
210
  function computeSlotImportPath(slotModule: string, fromDir: string): string {
210
- // slotModule: "apps/server/slots/users.logic.ts"
211
- // fromDir: "apps/server/generated/routes"
212
- // result: "../../slots/users.logic"
211
+ // slotModule: "spec/slots/users.slot.ts"
212
+ // fromDir: ".mandu/generated/server/routes"
213
+ // result: "../../../../spec/slots/users.slot"
213
214
 
214
215
  const slotParts = slotModule.replace(/\\/g, "/").split("/");
215
216
  const fromParts = fromDir.replace(/\\/g, "/").split("/");
@@ -280,11 +281,11 @@ export default function ${pageName}Page({ params }: Props): React.ReactElement {
280
281
  */
281
282
  export function generatePageComponentWithIsland(route: RouteSpec): string {
282
283
  const pageName = toPascalCase(route.id);
283
- const clientImportPath = computeSlotImportPath(route.clientModule!, "apps/web/generated/routes");
284
+ const clientImportPath = computeSlotImportPath(route.clientModule!, GENERATED_RELATIVE_PATHS.webRoutes);
284
285
 
285
286
  // clientModule + slotModule โ†’ PageRegistration ํ˜•์‹
286
287
  if (route.slotModule) {
287
- const slotImportPath = computeSlotImportPath(route.slotModule!, "apps/web/generated/routes");
288
+ const slotImportPath = computeSlotImportPath(route.slotModule!, GENERATED_RELATIVE_PATHS.webRoutes);
288
289
 
289
290
  return `// Generated by Mandu - DO NOT EDIT DIRECTLY
290
291
  // Island-First Rendering + Slot Module
@@ -346,7 +347,7 @@ export default function ${pageName}Page({ params, loaderData }: Props): React.Re
346
347
  */
347
348
  export function generatePageHandlerWithSlot(route: RouteSpec): string {
348
349
  const pageName = toPascalCase(route.id);
349
- const slotImportPath = computeSlotImportPath(route.slotModule!, "apps/server/generated/routes");
350
+ const slotImportPath = computeSlotImportPath(route.slotModule!, GENERATED_RELATIVE_PATHS.serverRoutes);
350
351
 
351
352
  return `// Generated by Mandu - DO NOT EDIT DIRECTLY
352
353
  // Route ID: ${route.id}
@@ -383,13 +384,13 @@ export default {
383
384
  * "todo-page" โ†’ "TodoPage"
384
385
  * "user_profile" โ†’ "UserProfile"
385
386
  */
386
- function toPascalCase(str: string): string {
387
+ function toPascalCase(str: string): string {
387
388
  return str
388
389
  .split(/[-_]/)
389
390
  .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
390
391
  .join("");
391
- }
392
-
393
- function pathDirname(filePath: string): string {
394
- return filePath.replace(/\\/g, "/").split("/").slice(0, -1).join("/");
395
- }
392
+ }
393
+
394
+ function pathDirname(filePath: string): string {
395
+ return filePath.replace(/\\/g, "/").split("/").slice(0, -1).join("/");
396
+ }