@mandujs/core 0.53.3 → 0.54.1

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 (336) hide show
  1. package/README.md +654 -654
  2. package/package.json +1 -1
  3. package/src/a11y/__tests__/run-audit.test.ts +333 -333
  4. package/src/a11y/fix-hints.ts +76 -76
  5. package/src/a11y/index.ts +18 -18
  6. package/src/a11y/run-audit.ts +394 -394
  7. package/src/a11y/types.ts +125 -125
  8. package/src/auth/__tests__/login.test.ts +1 -1
  9. package/src/auth/__tests__/password.test.ts +122 -122
  10. package/src/auth/__tests__/tokens.test.ts +274 -274
  11. package/src/auth/__tests__/verification.test.ts +274 -274
  12. package/src/auth/index.ts +76 -76
  13. package/src/auth/login.ts +225 -225
  14. package/src/auth/password.ts +120 -120
  15. package/src/auth/reset.ts +243 -243
  16. package/src/auth/tokens.ts +612 -612
  17. package/src/auth/verification.ts +253 -253
  18. package/src/brain/__tests__/redactor.test.ts +94 -94
  19. package/src/brain/adapters/__tests__/_helpers.ts +83 -83
  20. package/src/brain/adapters/__tests__/anthropic-oauth.test.ts +196 -196
  21. package/src/brain/adapters/__tests__/chatgpt-auth.test.ts +193 -193
  22. package/src/brain/adapters/__tests__/openai-oauth.test.ts +209 -209
  23. package/src/brain/adapters/__tests__/resolver.test.ts +143 -143
  24. package/src/brain/adapters/anthropic-oauth.ts +1 -1
  25. package/src/brain/adapters/chatgpt-auth.ts +300 -300
  26. package/src/brain/adapters/index.ts +319 -319
  27. package/src/brain/adapters/oauth-flow.ts +439 -439
  28. package/src/brain/consent.ts +240 -240
  29. package/src/brain/credentials.ts +396 -396
  30. package/src/bundler/__tests__/build-runner.ts +113 -113
  31. package/src/bundler/__tests__/dev-reliability.test.ts +619 -619
  32. package/src/bundler/__tests__/extended-watch.test.ts +711 -711
  33. package/src/bundler/__tests__/fast-refresh.test.ts +10 -10
  34. package/src/bundler/__tests__/hdr.test.ts +353 -353
  35. package/src/bundler/__tests__/hmr-client.test.ts +532 -532
  36. package/src/bundler/__tests__/manifest-schema.test.ts +266 -266
  37. package/src/bundler/__tests__/prod-smoke.test.ts +138 -138
  38. package/src/bundler/__tests__/reverse-import-graph.test.ts +519 -519
  39. package/src/bundler/__tests__/slot-dispatch.test.ts +573 -573
  40. package/src/bundler/__tests__/url-cap-and-slot-regex.test.ts +286 -286
  41. package/src/bundler/__tests__/vendor-cache.test.ts +455 -455
  42. package/src/bundler/budget.ts +404 -404
  43. package/src/bundler/build.test.ts +179 -179
  44. package/src/bundler/build.ts +55 -55
  45. package/src/bundler/dev.ts +42 -42
  46. package/src/bundler/manifest-schema.ts +301 -301
  47. package/src/bundler/plugins/__tests__/block-generated-imports.test.ts +263 -263
  48. package/src/bundler/plugins/__tests__/react-compiler-config.test.ts +83 -83
  49. package/src/bundler/plugins/__tests__/react-compiler-lint.test.ts +110 -110
  50. package/src/bundler/plugins/block-generated-imports.ts +155 -155
  51. package/src/bundler/plugins/index.ts +83 -83
  52. package/src/bundler/plugins/react-compiler-config.ts +108 -108
  53. package/src/bundler/plugins/react-compiler-lint.ts +253 -253
  54. package/src/bundler/plugins/react-compiler.ts +162 -162
  55. package/src/bundler/reverse-import-graph.ts +339 -339
  56. package/src/bundler/safe-build.test.ts +201 -201
  57. package/src/bundler/safe-build.ts +103 -103
  58. package/src/bundler/scenario-matrix.ts +229 -229
  59. package/src/bundler/types.ts +10 -10
  60. package/src/bundler/vendor-cache-types.ts +130 -130
  61. package/src/bundler/vendor-cache.ts +526 -526
  62. package/src/change/snapshot.ts +18 -18
  63. package/src/client/Form.tsx +105 -105
  64. package/src/client/Link.tsx +9 -9
  65. package/src/client/__tests__/use-sse.test.ts +153 -153
  66. package/src/client/globals.ts +1 -1
  67. package/src/client/hooks.ts +362 -362
  68. package/src/client/hydrate.ts +340 -340
  69. package/src/client/prefetch-helper.ts +55 -55
  70. package/src/client/router.ts +11 -11
  71. package/src/client/runtime.ts +47 -47
  72. package/src/client/serialize.ts +404 -404
  73. package/src/client/use-fetch.ts +6 -6
  74. package/src/client/use-head.ts +197 -197
  75. package/src/client/use-sse.ts +378 -378
  76. package/src/client/window-state.ts +101 -101
  77. package/src/components/Image.tsx +162 -162
  78. package/src/config/validate.ts +3 -3
  79. package/src/config/watcher.ts +311 -311
  80. package/src/constants.ts +40 -40
  81. package/src/content/collection.ts +8 -8
  82. package/src/content/content-layer.ts +7 -7
  83. package/src/content/data-store.ts +245 -245
  84. package/src/content/frontmatter.ts +189 -189
  85. package/src/content/loader-context.ts +171 -171
  86. package/src/content/loaders/api.ts +216 -216
  87. package/src/content/loaders/file.ts +172 -172
  88. package/src/content/loaders/glob.ts +253 -253
  89. package/src/content/loaders/index.ts +34 -34
  90. package/src/content/loaders/types.ts +137 -137
  91. package/src/content/meta-store.ts +209 -209
  92. package/src/content/prebuild.test.ts +571 -571
  93. package/src/content/prebuild.ts +636 -636
  94. package/src/content/schema.ts +20 -20
  95. package/src/content/sidebar.ts +630 -630
  96. package/src/content/slug.ts +110 -110
  97. package/src/content/types.ts +282 -282
  98. package/src/content/watcher.ts +135 -135
  99. package/src/contract/client-safe.test.ts +42 -42
  100. package/src/contract/client-safe.ts +114 -114
  101. package/src/contract/define.ts +11 -11
  102. package/src/contract/index.ts +1 -1
  103. package/src/contract/normalize.test.ts +276 -276
  104. package/src/contract/normalize.ts +410 -410
  105. package/src/contract/registry.test.ts +206 -206
  106. package/src/contract/route-helpers.ts +1 -1
  107. package/src/contract/rpc.ts +443 -443
  108. package/src/contract/schema.ts +48 -48
  109. package/src/contract/types.ts +58 -58
  110. package/src/db/__tests__/db.test.ts +482 -482
  111. package/src/db/index.ts +138 -138
  112. package/src/db/migrations/history-table.ts +345 -345
  113. package/src/db/migrations/index.ts +3 -3
  114. package/src/db/migrations/lock.ts +324 -324
  115. package/src/db/migrations/runner.ts +650 -650
  116. package/src/deploy/cache.ts +140 -140
  117. package/src/deploy/compile/vercel.ts +344 -344
  118. package/src/deploy/index.ts +87 -87
  119. package/src/deploy/inference/brain.ts +268 -268
  120. package/src/deploy/inference/context.ts +182 -182
  121. package/src/deploy/inference/filling-extract.ts +245 -245
  122. package/src/deploy/inference/heuristic.ts +182 -182
  123. package/src/deploy/intent.ts +173 -173
  124. package/src/deploy/plan.ts +178 -178
  125. package/src/design/__tests__/agents-link.test.ts +109 -109
  126. package/src/design/__tests__/extract-patch-diff.test.ts +265 -265
  127. package/src/design/__tests__/lint.test.ts +110 -110
  128. package/src/design/__tests__/parser.test.ts +195 -195
  129. package/src/design/__tests__/tailwind-theme.test.ts +229 -229
  130. package/src/design/agents-link.ts +165 -165
  131. package/src/design/diff.ts +138 -138
  132. package/src/design/extract.ts +285 -285
  133. package/src/design/index.ts +102 -102
  134. package/src/design/lint.ts +209 -209
  135. package/src/design/parser.ts +555 -555
  136. package/src/design/patch.ts +241 -241
  137. package/src/design/scaffold.ts +147 -147
  138. package/src/design/tailwind-theme.ts +441 -441
  139. package/src/design/types.ts +210 -210
  140. package/src/desktop/__tests__/webview-fallback.test.ts +254 -254
  141. package/src/desktop/__tests__/window.test.ts +248 -248
  142. package/src/desktop/__tests__/worker.test.ts +266 -266
  143. package/src/desktop/index.ts +43 -43
  144. package/src/desktop/types.ts +158 -158
  145. package/src/desktop/worker.ts +180 -180
  146. package/src/dev-error-overlay/__tests__/overlay-injector.test.ts +241 -241
  147. package/src/dev-error-overlay/index.ts +30 -30
  148. package/src/dev-error-overlay/overlay-injector.ts +243 -243
  149. package/src/dev-error-overlay/overlay-styles.ts +52 -52
  150. package/src/dev-error-overlay/types.ts +66 -66
  151. package/src/devtools/ai/context-builder.ts +375 -375
  152. package/src/devtools/ai/index.ts +25 -25
  153. package/src/devtools/ai/mcp-connector.ts +25 -25
  154. package/src/devtools/client/catchers/error-catcher.ts +344 -344
  155. package/src/devtools/client/catchers/index.ts +18 -18
  156. package/src/devtools/client/components/index.ts +39 -39
  157. package/src/devtools/client/components/mandu-character.tsx +331 -331
  158. package/src/devtools/client/components/overlay.tsx +368 -368
  159. package/src/devtools/client/components/panel/errors-panel.tsx +259 -259
  160. package/src/devtools/client/components/panel/guard-panel.tsx +30 -30
  161. package/src/devtools/client/components/panel/islands-panel.tsx +320 -320
  162. package/src/devtools/client/components/panel/network-panel.tsx +291 -291
  163. package/src/devtools/client/components/panel/panel-container.tsx +500 -500
  164. package/src/devtools/client/components/panel/preview-panel.tsx +46 -46
  165. package/src/devtools/client/filters/context-filters.ts +282 -282
  166. package/src/devtools/client/filters/index.ts +16 -16
  167. package/src/devtools/client/index.ts +63 -63
  168. package/src/devtools/client/persistence.ts +335 -335
  169. package/src/devtools/hook/create-hook.ts +207 -207
  170. package/src/devtools/hook/index.ts +13 -13
  171. package/src/devtools/index.ts +439 -439
  172. package/src/devtools/init.ts +265 -265
  173. package/src/devtools/protocol.ts +237 -237
  174. package/src/devtools/server/index.ts +17 -17
  175. package/src/devtools/server/source-context.ts +450 -450
  176. package/src/devtools/types.ts +35 -35
  177. package/src/devtools/worker/index.ts +25 -25
  178. package/src/devtools/worker/redaction-worker.ts +233 -233
  179. package/src/devtools/worker/worker-manager.ts +410 -410
  180. package/src/diagnose/__tests__/checks.test.ts +451 -451
  181. package/src/diagnose/checks.ts +832 -832
  182. package/src/diagnose/index.ts +17 -17
  183. package/src/diagnose/run.ts +93 -93
  184. package/src/diagnose/types.ts +53 -53
  185. package/src/email/__tests__/email.test.ts +355 -355
  186. package/src/email/index.ts +282 -282
  187. package/src/email/smtp.ts +64 -64
  188. package/src/error/domains.ts +265 -265
  189. package/src/error/result.ts +60 -60
  190. package/src/error/types.ts +6 -6
  191. package/src/errors/extractor.ts +409 -409
  192. package/src/errors/index.ts +19 -19
  193. package/src/filling/__tests__/session-sqlite.test.ts +454 -454
  194. package/src/filling/auth.ts +308 -308
  195. package/src/filling/cookie-codec.ts +299 -299
  196. package/src/filling/deps.ts +265 -265
  197. package/src/filling/session-sqlite.ts +617 -617
  198. package/src/filling/sse.ts +5 -5
  199. package/src/filling/ws.ts +78 -78
  200. package/src/generator/index.ts +3 -3
  201. package/src/guard/__tests__/design-inline-class.test.ts +219 -219
  202. package/src/guard/__tests__/tsgolint-bridge.test.ts +347 -347
  203. package/src/guard/analyzer.ts +360 -360
  204. package/src/guard/auto-correct.ts +1 -1
  205. package/src/guard/contract-guard.ts +9 -9
  206. package/src/guard/define-rule.ts +243 -243
  207. package/src/guard/design-inline-class.ts +393 -393
  208. package/src/guard/file-type.test.ts +24 -24
  209. package/src/guard/graph.ts +1 -1
  210. package/src/guard/healing.ts +36 -36
  211. package/src/guard/presets/atomic.ts +70 -70
  212. package/src/guard/presets/clean.ts +77 -77
  213. package/src/guard/presets/fsd.ts +79 -79
  214. package/src/guard/presets/hexagonal.ts +68 -68
  215. package/src/guard/reporter.ts +442 -442
  216. package/src/guard/rule-presets.ts +379 -379
  217. package/src/guard/semantic-slots.ts +1 -1
  218. package/src/guard/suggestions.ts +358 -358
  219. package/src/guard/tsgolint-bridge.ts +512 -512
  220. package/src/guard/types.ts +348 -348
  221. package/src/guard/watcher.ts +405 -405
  222. package/src/i18n/define.ts +126 -126
  223. package/src/i18n/index.ts +52 -52
  224. package/src/i18n/message-registry.ts +173 -173
  225. package/src/i18n/types.ts +112 -112
  226. package/src/id/index.ts +105 -105
  227. package/src/index.ts +2 -2
  228. package/src/kitchen/api/agent-devtools-api.ts +779 -544
  229. package/src/kitchen/api/errors-grouping.ts +126 -0
  230. package/src/kitchen/kitchen-handler.ts +192 -63
  231. package/src/kitchen/kitchen-ui.ts +842 -464
  232. package/src/logging/index.ts +22 -22
  233. package/src/logging/transports.ts +365 -365
  234. package/src/middleware/bridge.ts +147 -147
  235. package/src/middleware/compose.ts +134 -134
  236. package/src/middleware/compress.ts +62 -62
  237. package/src/middleware/cors.ts +47 -47
  238. package/src/middleware/csrf.ts +328 -328
  239. package/src/middleware/define.ts +132 -132
  240. package/src/middleware/jwt.ts +134 -134
  241. package/src/middleware/logger.ts +58 -58
  242. package/src/middleware/oauth/__tests__/oauth.test.ts +1 -1
  243. package/src/middleware/oauth/index.ts +505 -505
  244. package/src/middleware/oauth/providers.ts +115 -115
  245. package/src/middleware/rate-limit/index.ts +522 -522
  246. package/src/middleware/rate-limit/sqlite-store.ts +382 -382
  247. package/src/middleware/scheduler-cron.ts +96 -96
  248. package/src/middleware/secure/__tests__/secure.test.ts +360 -360
  249. package/src/middleware/secure/csp.ts +193 -193
  250. package/src/middleware/session.ts +174 -174
  251. package/src/middleware/timeout.ts +55 -55
  252. package/src/observability/logger-adapter.ts +36 -36
  253. package/src/observability/sqlite-store.ts +254 -254
  254. package/src/openapi/generator.ts +1 -1
  255. package/src/openapi/openapi.test.ts +43 -43
  256. package/src/perf/__tests__/user-marks.test.ts +354 -354
  257. package/src/perf/index.ts +133 -133
  258. package/src/plugins/__tests__/lifecycle-integration.test.ts +272 -272
  259. package/src/plugins/__tests__/runner.test.ts +409 -409
  260. package/src/plugins/define.ts +124 -124
  261. package/src/plugins/examples/dep-check-plugin.ts +80 -80
  262. package/src/plugins/examples/prerender-cache-plugin.ts +111 -111
  263. package/src/plugins/examples/sitemap-plugin.ts +65 -65
  264. package/src/plugins/runner.ts +361 -361
  265. package/src/plugins/types.ts +368 -368
  266. package/src/report/index.ts +1 -1
  267. package/src/resource/__tests__/generator.test.ts +32 -32
  268. package/src/resource/ddl/__tests__/diff.test.ts +639 -639
  269. package/src/resource/ddl/__tests__/emit.test.ts +823 -823
  270. package/src/resource/ddl/__tests__/snapshot.test.ts +499 -499
  271. package/src/resource/ddl/emit.ts +559 -559
  272. package/src/resource/ddl/persistence-types.ts +218 -218
  273. package/src/resource/ddl/type-map.ts +223 -223
  274. package/src/resource/ddl/types.ts +232 -232
  275. package/src/resource/generator-repo.ts +630 -630
  276. package/src/resource/schema.ts +1 -1
  277. package/src/router/fs-patterns.test.ts +96 -96
  278. package/src/router/fs-routes.ts +6 -6
  279. package/src/routes/index.ts +74 -74
  280. package/src/routes/metadata-routes.ts +427 -427
  281. package/src/routes/types.ts +341 -341
  282. package/src/runtime/__tests__/error-boundary-redaction.test.ts +141 -141
  283. package/src/runtime/__tests__/hdr-client.test.ts +223 -223
  284. package/src/runtime/__tests__/http-errors.test.ts +117 -117
  285. package/src/runtime/__tests__/not-found.test.ts +152 -152
  286. package/src/runtime/adapter.ts +47 -47
  287. package/src/runtime/boundary.tsx +252 -252
  288. package/src/runtime/cache.ts +494 -494
  289. package/src/runtime/compose.ts +222 -222
  290. package/src/runtime/fast-refresh-runtime.ts +322 -322
  291. package/src/runtime/handler.ts +65 -65
  292. package/src/runtime/handlers.ts +300 -300
  293. package/src/runtime/http-errors.ts +113 -113
  294. package/src/runtime/image-handler.ts +1 -1
  295. package/src/runtime/lifecycle.ts +381 -381
  296. package/src/runtime/logger.test.ts +345 -345
  297. package/src/runtime/middleware.ts +264 -264
  298. package/src/runtime/not-found.ts +93 -93
  299. package/src/runtime/openapi-endpoint.ts +236 -236
  300. package/src/runtime/ppr.ts +74 -74
  301. package/src/runtime/registry.ts +171 -171
  302. package/src/runtime/router.ts +105 -105
  303. package/src/runtime/server.ts +67 -67
  304. package/src/runtime/shims.ts +48 -48
  305. package/src/runtime/trace.ts +144 -144
  306. package/src/scheduler/validate.ts +169 -169
  307. package/src/seo/index.ts +219 -219
  308. package/src/seo/integration/ssr.ts +306 -306
  309. package/src/seo/render/basic.ts +435 -435
  310. package/src/seo/render/index.ts +143 -143
  311. package/src/seo/render/jsonld.ts +539 -539
  312. package/src/seo/render/opengraph.ts +197 -197
  313. package/src/seo/render/robots.ts +116 -116
  314. package/src/seo/render/sitemap.ts +137 -137
  315. package/src/seo/render/twitter.ts +127 -127
  316. package/src/seo/resolve/opengraph.ts +143 -143
  317. package/src/seo/resolve/robots.ts +73 -73
  318. package/src/seo/resolve/title.ts +94 -94
  319. package/src/seo/resolve/twitter.ts +73 -73
  320. package/src/seo/resolve/url.ts +104 -104
  321. package/src/seo/routes/index.ts +290 -290
  322. package/src/seo/types.ts +588 -588
  323. package/src/slot/validator.ts +39 -39
  324. package/src/storage/s3/__tests__/s3.test.ts +479 -479
  325. package/src/storage/s3/index.ts +412 -412
  326. package/src/testing/__tests__/assertions.test.ts +632 -632
  327. package/src/testing/__tests__/reporter.test.ts +454 -454
  328. package/src/testing/assertions.ts +986 -986
  329. package/src/testing/db.ts +157 -157
  330. package/src/testing/mocks.ts +203 -203
  331. package/src/testing/session.ts +190 -190
  332. package/src/types/branded.ts +56 -56
  333. package/src/types/index.ts +1 -1
  334. package/src/utils/safe-io.ts +188 -188
  335. package/src/utils/string-safe.ts +298 -298
  336. package/src/watcher/watcher.ts +18 -18
package/src/seo/integration/ssr.ts CHANGED
@@ -1,306 +1,306 @@
1
- /**
2
- * Mandu SEO - SSR Integration
3
- *
4
- * Streaming SSR 파이프라인에 SEO 메타데이터 통합
5
- *
6
- * @example
7
- * ```typescript
8
- * // app/blog/[slug]/page.tsx
9
- * import { renderWithSEO } from '@mandujs/core'
10
- *
11
- * export default async function handler(req: Request) {
12
- * const slug = getSlug(req)
13
- * const post = await getPost(slug)
14
- *
15
- * return renderWithSEO(<BlogPost post={post} />, {
16
- * metadata: [
17
- * layoutMetadata, // from layout.tsx
18
- * {
19
- * title: post.title,
20
- * description: post.excerpt,
21
- * openGraph: { title: post.title, images: [post.image] },
22
- * },
23
- * ],
24
- * routeParams: { slug },
25
- * })
26
- * }
27
- * ```
28
- */
29
-
30
- import type { Metadata, MetadataItem, ResolvedMetadata } from '../types'
31
- import { resolveMetadata, createDefaultMetadata } from '../resolve'
32
- import { renderMetadata } from '../render'
33
-
34
- // ============================================================================
35
- // Types
36
- // ============================================================================
37
-
38
- export interface SEOOptions {
39
- /**
40
- * 메타데이터 항목들 (Layout 체인 순서)
41
- * [rootLayout, ...nestedLayouts, page]
42
- */
43
- metadata?: MetadataItem[]
44
-
45
- /**
46
- * 단일 정적 메타데이터 (간단한 경우)
47
- */
48
- staticMetadata?: Metadata
49
-
50
- /**
51
- * 라우트 파라미터 (동적 메타데이터용)
52
- */
53
- routeParams?: Record<string, string>
54
-
55
- /**
56
- * 쿼리 파라미터 (동적 메타데이터용)
57
- */
58
- searchParams?: Record<string, string>
59
- }
60
-
61
- export interface SEOResult {
62
- /** 해석된 메타데이터 */
63
- resolved: ResolvedMetadata
64
- /** 렌더링된 HTML 문자열 (<head> 내부) */
65
- html: string
66
- /** 페이지 타이틀 */
67
- title: string | null
68
- }
69
-
70
- // ============================================================================
71
- // SEO Resolution
72
- // ============================================================================
73
-
74
- /**
75
- * SEO 메타데이터 해석 및 렌더링
76
- *
77
- * @param options - SEO 옵션
78
- * @returns 해석된 메타데이터와 HTML
79
- */
80
- export async function resolveSEO(options: SEOOptions = {}): Promise<SEOResult> {
81
- const { metadata, staticMetadata, routeParams = {}, searchParams = {} } = options
82
-
83
- let resolved: ResolvedMetadata
84
-
85
- if (metadata && metadata.length > 0) {
86
- // Layout 체인에서 메타데이터 해석
87
- resolved = await resolveMetadata(metadata, routeParams, searchParams)
88
- } else if (staticMetadata) {
89
- // 단일 정적 메타데이터
90
- const _base = createDefaultMetadata()
91
- resolved = await resolveMetadata([staticMetadata], routeParams, searchParams)
92
- } else {
93
- // 기본 메타데이터
94
- resolved = createDefaultMetadata()
95
- }
96
-
97
- // HTML 렌더링
98
- const html = renderMetadata(resolved)
99
- const title = resolved.title?.absolute || null
100
-
101
- return { resolved, html, title }
102
- }
103
-
104
- /**
105
- * 동기 버전 (정적 메타데이터 전용)
106
- *
107
- * 주의: 동기 버전은 간단한 메타데이터만 처리합니다.
108
- * 복잡한 메타데이터(OG, Twitter 등)는 resolveSEO를 사용하세요.
109
- */
110
- export function resolveSEOSync(staticMetadata: Metadata): SEOResult {
111
- const base = createDefaultMetadata()
112
-
113
- // title 해석
114
- let resolvedTitle: { absolute: string; template: string | null } | null = null
115
- if (staticMetadata.title) {
116
- if (typeof staticMetadata.title === 'string') {
117
- resolvedTitle = { absolute: staticMetadata.title, template: null }
118
- } else if ('absolute' in staticMetadata.title) {
119
- resolvedTitle = {
120
- absolute: staticMetadata.title.absolute ?? '',
121
- template: staticMetadata.title.template ?? null,
122
- }
123
- } else if ('default' in staticMetadata.title) {
124
- resolvedTitle = {
125
- absolute: staticMetadata.title.default ?? '',
126
- template: staticMetadata.title.template ?? null,
127
- }
128
- }
129
- }
130
-
131
- // 간단한 병합 (동기)
132
- const resolved: ResolvedMetadata = {
133
- ...base,
134
- title: resolvedTitle,
135
- description: staticMetadata.description || null,
136
- keywords: staticMetadata.keywords
137
- ? typeof staticMetadata.keywords === 'string'
138
- ? staticMetadata.keywords.split(',').map(k => k.trim())
139
- : staticMetadata.keywords
140
- : null,
141
- robots: staticMetadata.robots
142
- ? typeof staticMetadata.robots === 'string'
143
- ? { basic: staticMetadata.robots, googleBot: null }
144
- : {
145
- basic: [
146
- staticMetadata.robots.index === false ? 'noindex' : 'index',
147
- staticMetadata.robots.follow === false ? 'nofollow' : 'follow',
148
- ].join(', '),
149
- googleBot: null,
150
- }
151
- : null,
152
- }
153
-
154
- const html = renderMetadata(resolved)
155
- const title = resolved.title?.absolute || null
156
-
157
- return { resolved, html, title }
158
- }
159
-
160
- // ============================================================================
161
- // Streaming SSR Integration
162
- // ============================================================================
163
-
164
- /**
165
- * StreamingSSROptions에 추가할 SEO 확장 옵션
166
- */
167
- export interface StreamingSSRWithSEOOptions {
168
- /** SEO 옵션 */
169
- seo?: SEOOptions
170
- }
171
-
172
- /**
173
- * Streaming SSR 옵션에 SEO headTags 주입
174
- *
175
- * @example
176
- * ```typescript
177
- * const baseOptions = { routeId: 'blog-post', isDev: true }
178
- * const seoOptions = { metadata: [layoutMeta, pageMeta] }
179
- *
180
- * const options = await injectSEOIntoOptions(baseOptions, seoOptions)
181
- * // → { ...baseOptions, title: 'Post Title', headTags: '<meta ...>' }
182
- * ```
183
- */
184
- export async function injectSEOIntoOptions<T extends { title?: string; headTags?: string }>(
185
- options: T,
186
- seoOptions: SEOOptions
187
- ): Promise<T & { title: string; headTags: string }> {
188
- const { resolved: _resolved, html, title } = await resolveSEO(seoOptions)
189
-
190
- // 기존 headTags와 병합
191
- const existingHeadTags = options.headTags || ''
192
- const mergedHeadTags = html + (existingHeadTags ? '\n' + existingHeadTags : '')
193
-
194
- return {
195
- ...options,
196
- title: title || options.title || 'Mandu App',
197
- headTags: mergedHeadTags,
198
- }
199
- }
200
-
201
- // ============================================================================
202
- // Layout Chain Helpers
203
- // ============================================================================
204
-
205
- /**
206
- * 레이아웃 체인에서 메타데이터 수집
207
- *
208
- * @example
209
- * ```typescript
210
- * // 파일 시스템 기반 라우팅에서 사용
211
- * const chain = await collectLayoutMetadata([
212
- * { path: 'app/layout.tsx', metadata: rootMeta },
213
- * { path: 'app/blog/layout.tsx', metadata: blogMeta },
214
- * { path: 'app/blog/[slug]/page.tsx', generateMetadata: generatePostMeta },
215
- * ])
216
- * ```
217
- */
218
- export interface LayoutMetadataEntry {
219
- /** 레이아웃/페이지 경로 */
220
- path: string
221
- /** 정적 메타데이터 */
222
- metadata?: Metadata
223
- /** 동적 메타데이터 생성 함수 */
224
- generateMetadata?: (props: {
225
- params: Record<string, string>
226
- searchParams: Record<string, string>
227
- }) => Metadata | Promise<Metadata>
228
- }
229
-
230
- /**
231
- * 레이아웃 엔트리를 MetadataItem 배열로 변환
232
- */
233
- export function layoutEntriesToMetadataItems(
234
- entries: LayoutMetadataEntry[]
235
- ): MetadataItem[] {
236
- return entries.map((entry) => {
237
- if (entry.generateMetadata) {
238
- return entry.generateMetadata
239
- }
240
- return entry.metadata || null
241
- })
242
- }
243
-
244
- // ============================================================================
245
- // React Component Integration
246
- // ============================================================================
247
-
248
- /**
249
- * SEO Context 타입 (React Context 사용 시)
250
- */
251
- export interface SEOContextValue {
252
- metadata: ResolvedMetadata
253
- updateMetadata: (partial: Partial<Metadata>) => void
254
- }
255
-
256
- /**
257
- * 메타데이터를 React 컴포넌트에서 사용할 수 있는 props로 변환
258
- */
259
- export function metadataToProps(resolved: ResolvedMetadata): {
260
- title: string | null
261
- description: string | null
262
- ogImage: string | null
263
- ogUrl: string | null
264
- } {
265
- return {
266
- title: resolved.title?.absolute || null,
267
- description: resolved.description || null,
268
- ogImage: resolved.openGraph?.images?.[0]?.url
269
- ? typeof resolved.openGraph.images[0].url === 'string'
270
- ? resolved.openGraph.images[0].url
271
- : resolved.openGraph.images[0].url.toString()
272
- : null,
273
- ogUrl: resolved.openGraph?.url?.href || null,
274
- }
275
- }
276
-
277
- // ============================================================================
278
- // Head Component Support
279
- // ============================================================================
280
-
281
- /**
282
- * 동적 Head 업데이트를 위한 스크립트 생성
283
- * (클라이언트에서 document.title 등 업데이트)
284
- */
285
- export function generateHeadUpdateScript(metadata: ResolvedMetadata): string {
286
- const updates: string[] = []
287
-
288
- // Title 업데이트
289
- if (metadata.title?.absolute) {
290
- updates.push(`document.title = ${JSON.stringify(metadata.title.absolute)};`)
291
- }
292
-
293
- // Description 업데이트
294
- if (metadata.description) {
295
- updates.push(`
296
- (function() {
297
- var meta = document.querySelector('meta[name="description"]');
298
- if (meta) meta.content = ${JSON.stringify(metadata.description)};
299
- })();
300
- `)
301
- }
302
-
303
- if (updates.length === 0) return ''
304
-
305
- return `<script>(function(){${updates.join('')}})()</script>`
306
- }
1
+ /**
2
+ * Mandu SEO - SSR Integration
3
+ *
4
+ * Streaming SSR 파이프라인에 SEO 메타데이터 통합
5
+ *
6
+ * @example
7
+ * ```typescript
8
+ * // app/blog/[slug]/page.tsx
9
+ * import { renderWithSEO } from '@mandujs/core'
10
+ *
11
+ * export default async function handler(req: Request) {
12
+ * const slug = getSlug(req)
13
+ * const post = await getPost(slug)
14
+ *
15
+ * return renderWithSEO(<BlogPost post={post} />, {
16
+ * metadata: [
17
+ * layoutMetadata, // from layout.tsx
18
+ * {
19
+ * title: post.title,
20
+ * description: post.excerpt,
21
+ * openGraph: { title: post.title, images: [post.image] },
22
+ * },
23
+ * ],
24
+ * routeParams: { slug },
25
+ * })
26
+ * }
27
+ * ```
28
+ */
29
+
30
+ import type { Metadata, MetadataItem, ResolvedMetadata } from '../types'
31
+ import { resolveMetadata, createDefaultMetadata } from '../resolve'
32
+ import { renderMetadata } from '../render'
33
+
34
+ // ============================================================================
35
+ // Types
36
+ // ============================================================================
37
+
38
+ export interface SEOOptions {
39
+ /**
40
+ * 메타데이터 항목들 (Layout 체인 순서)
41
+ * [rootLayout, ...nestedLayouts, page]
42
+ */
43
+ metadata?: MetadataItem[]
44
+
45
+ /**
46
+ * 단일 정적 메타데이터 (간단한 경우)
47
+ */
48
+ staticMetadata?: Metadata
49
+
50
+ /**
51
+ * 라우트 파라미터 (동적 메타데이터용)
52
+ */
53
+ routeParams?: Record<string, string>
54
+
55
+ /**
56
+ * 쿼리 파라미터 (동적 메타데이터용)
57
+ */
58
+ searchParams?: Record<string, string>
59
+ }
60
+
61
+ export interface SEOResult {
62
+ /** 해석된 메타데이터 */
63
+ resolved: ResolvedMetadata
64
+ /** 렌더링된 HTML 문자열 (<head> 내부) */
65
+ html: string
66
+ /** 페이지 타이틀 */
67
+ title: string | null
68
+ }
69
+
70
+ // ============================================================================
71
+ // SEO Resolution
72
+ // ============================================================================
73
+
74
+ /**
75
+ * SEO 메타데이터 해석 및 렌더링
76
+ *
77
+ * @param options - SEO 옵션
78
+ * @returns 해석된 메타데이터와 HTML
79
+ */
80
+ export async function resolveSEO(options: SEOOptions = {}): Promise<SEOResult> {
81
+ const { metadata, staticMetadata, routeParams = {}, searchParams = {} } = options
82
+
83
+ let resolved: ResolvedMetadata
84
+
85
+ if (metadata && metadata.length > 0) {
86
+ // Layout 체인에서 메타데이터 해석
87
+ resolved = await resolveMetadata(metadata, routeParams, searchParams)
88
+ } else if (staticMetadata) {
89
+ // 단일 정적 메타데이터
90
+ const _base = createDefaultMetadata()
91
+ resolved = await resolveMetadata([staticMetadata], routeParams, searchParams)
92
+ } else {
93
+ // 기본 메타데이터
94
+ resolved = createDefaultMetadata()
95
+ }
96
+
97
+ // HTML 렌더링
98
+ const html = renderMetadata(resolved)
99
+ const title = resolved.title?.absolute || null
100
+
101
+ return { resolved, html, title }
102
+ }
103
+
104
+ /**
105
+ * 동기 버전 (정적 메타데이터 전용)
106
+ *
107
+ * 주의: 동기 버전은 간단한 메타데이터만 처리합니다.
108
+ * 복잡한 메타데이터(OG, Twitter 등)는 resolveSEO를 사용하세요.
109
+ */
110
+ export function resolveSEOSync(staticMetadata: Metadata): SEOResult {
111
+ const base = createDefaultMetadata()
112
+
113
+ // title 해석
114
+ let resolvedTitle: { absolute: string; template: string | null } | null = null
115
+ if (staticMetadata.title) {
116
+ if (typeof staticMetadata.title === 'string') {
117
+ resolvedTitle = { absolute: staticMetadata.title, template: null }
118
+ } else if ('absolute' in staticMetadata.title) {
119
+ resolvedTitle = {
120
+ absolute: staticMetadata.title.absolute ?? '',
121
+ template: staticMetadata.title.template ?? null,
122
+ }
123
+ } else if ('default' in staticMetadata.title) {
124
+ resolvedTitle = {
125
+ absolute: staticMetadata.title.default ?? '',
126
+ template: staticMetadata.title.template ?? null,
127
+ }
128
+ }
129
+ }
130
+
131
+ // 간단한 병합 (동기)
132
+ const resolved: ResolvedMetadata = {
133
+ ...base,
134
+ title: resolvedTitle,
135
+ description: staticMetadata.description || null,
136
+ keywords: staticMetadata.keywords
137
+ ? typeof staticMetadata.keywords === 'string'
138
+ ? staticMetadata.keywords.split(',').map(k => k.trim())
139
+ : staticMetadata.keywords
140
+ : null,
141
+ robots: staticMetadata.robots
142
+ ? typeof staticMetadata.robots === 'string'
143
+ ? { basic: staticMetadata.robots, googleBot: null }
144
+ : {
145
+ basic: [
146
+ staticMetadata.robots.index === false ? 'noindex' : 'index',
147
+ staticMetadata.robots.follow === false ? 'nofollow' : 'follow',
148
+ ].join(', '),
149
+ googleBot: null,
150
+ }
151
+ : null,
152
+ }
153
+
154
+ const html = renderMetadata(resolved)
155
+ const title = resolved.title?.absolute || null
156
+
157
+ return { resolved, html, title }
158
+ }
159
+
160
+ // ============================================================================
161
+ // Streaming SSR Integration
162
+ // ============================================================================
163
+
164
+ /**
165
+ * StreamingSSROptions에 추가할 SEO 확장 옵션
166
+ */
167
+ export interface StreamingSSRWithSEOOptions {
168
+ /** SEO 옵션 */
169
+ seo?: SEOOptions
170
+ }
171
+
172
+ /**
173
+ * Streaming SSR 옵션에 SEO headTags 주입
174
+ *
175
+ * @example
176
+ * ```typescript
177
+ * const baseOptions = { routeId: 'blog-post', isDev: true }
178
+ * const seoOptions = { metadata: [layoutMeta, pageMeta] }
179
+ *
180
+ * const options = await injectSEOIntoOptions(baseOptions, seoOptions)
181
+ * // → { ...baseOptions, title: 'Post Title', headTags: '<meta ...>' }
182
+ * ```
183
+ */
184
+ export async function injectSEOIntoOptions<T extends { title?: string; headTags?: string }>(
185
+ options: T,
186
+ seoOptions: SEOOptions
187
+ ): Promise<T & { title: string; headTags: string }> {
188
+ const { resolved: _resolved, html, title } = await resolveSEO(seoOptions)
189
+
190
+ // 기존 headTags와 병합
191
+ const existingHeadTags = options.headTags || ''
192
+ const mergedHeadTags = html + (existingHeadTags ? '\n' + existingHeadTags : '')
193
+
194
+ return {
195
+ ...options,
196
+ title: title || options.title || 'Mandu App',
197
+ headTags: mergedHeadTags,
198
+ }
199
+ }
200
+
201
+ // ============================================================================
202
+ // Layout Chain Helpers
203
+ // ============================================================================
204
+
205
+ /**
206
+ * 레이아웃 체인에서 메타데이터 수집
207
+ *
208
+ * @example
209
+ * ```typescript
210
+ * // 파일 시스템 기반 라우팅에서 사용
211
+ * const chain = await collectLayoutMetadata([
212
+ * { path: 'app/layout.tsx', metadata: rootMeta },
213
+ * { path: 'app/blog/layout.tsx', metadata: blogMeta },
214
+ * { path: 'app/blog/[slug]/page.tsx', generateMetadata: generatePostMeta },
215
+ * ])
216
+ * ```
217
+ */
218
+ export interface LayoutMetadataEntry {
219
+ /** 레이아웃/페이지 경로 */
220
+ path: string
221
+ /** 정적 메타데이터 */
222
+ metadata?: Metadata
223
+ /** 동적 메타데이터 생성 함수 */
224
+ generateMetadata?: (props: {
225
+ params: Record<string, string>
226
+ searchParams: Record<string, string>
227
+ }) => Metadata | Promise<Metadata>
228
+ }
229
+
230
+ /**
231
+ * 레이아웃 엔트리를 MetadataItem 배열로 변환
232
+ */
233
+ export function layoutEntriesToMetadataItems(
234
+ entries: LayoutMetadataEntry[]
235
+ ): MetadataItem[] {
236
+ return entries.map((entry) => {
237
+ if (entry.generateMetadata) {
238
+ return entry.generateMetadata
239
+ }
240
+ return entry.metadata || null
241
+ })
242
+ }
243
+
244
+ // ============================================================================
245
+ // React Component Integration
246
+ // ============================================================================
247
+
248
+ /**
249
+ * SEO Context 타입 (React Context 사용 시)
250
+ */
251
+ export interface SEOContextValue {
252
+ metadata: ResolvedMetadata
253
+ updateMetadata: (partial: Partial<Metadata>) => void
254
+ }
255
+
256
+ /**
257
+ * 메타데이터를 React 컴포넌트에서 사용할 수 있는 props로 변환
258
+ */
259
+ export function metadataToProps(resolved: ResolvedMetadata): {
260
+ title: string | null
261
+ description: string | null
262
+ ogImage: string | null
263
+ ogUrl: string | null
264
+ } {
265
+ return {
266
+ title: resolved.title?.absolute || null,
267
+ description: resolved.description || null,
268
+ ogImage: resolved.openGraph?.images?.[0]?.url
269
+ ? typeof resolved.openGraph.images[0].url === 'string'
270
+ ? resolved.openGraph.images[0].url
271
+ : resolved.openGraph.images[0].url.toString()
272
+ : null,
273
+ ogUrl: resolved.openGraph?.url?.href || null,
274
+ }
275
+ }
276
+
277
+ // ============================================================================
278
+ // Head Component Support
279
+ // ============================================================================
280
+
281
+ /**
282
+ * 동적 Head 업데이트를 위한 스크립트 생성
283
+ * (클라이언트에서 document.title 등 업데이트)
284
+ */
285
+ export function generateHeadUpdateScript(metadata: ResolvedMetadata): string {
286
+ const updates: string[] = []
287
+
288
+ // Title 업데이트
289
+ if (metadata.title?.absolute) {
290
+ updates.push(`document.title = ${JSON.stringify(metadata.title.absolute)};`)
291
+ }
292
+
293
+ // Description 업데이트
294
+ if (metadata.description) {
295
+ updates.push(`
296
+ (function() {
297
+ var meta = document.querySelector('meta[name="description"]');
298
+ if (meta) meta.content = ${JSON.stringify(metadata.description)};
299
+ })();
300
+ `)
301
+ }
302
+
303
+ if (updates.length === 0) return ''
304
+
305
+ return `<script>(function(){${updates.join('')}})()</script>`
306
+ }