@mandujs/core 0.13.0 → 0.13.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 (155) hide show
  1. package/README.ko.md +4 -4
  2. package/README.md +653 -653
  3. package/package.json +1 -1
  4. package/src/bundler/build.ts +91 -91
  5. package/src/bundler/css.ts +302 -302
  6. package/src/client/Link.tsx +227 -227
  7. package/src/client/globals.ts +44 -44
  8. package/src/client/hooks.ts +267 -267
  9. package/src/client/index.ts +5 -5
  10. package/src/client/island.ts +8 -8
  11. package/src/client/router.ts +435 -435
  12. package/src/client/runtime.ts +23 -23
  13. package/src/client/serialize.ts +404 -404
  14. package/src/client/window-state.ts +101 -101
  15. package/src/config/mandu.ts +9 -0
  16. package/src/config/validate.ts +12 -0
  17. package/src/config/watcher.ts +311 -311
  18. package/src/constants.ts +40 -40
  19. package/src/content/content-layer.ts +314 -314
  20. package/src/content/content.test.ts +433 -433
  21. package/src/content/data-store.ts +245 -245
  22. package/src/content/digest.ts +133 -133
  23. package/src/content/index.ts +164 -164
  24. package/src/content/loader-context.ts +172 -172
  25. package/src/content/loaders/api.ts +216 -216
  26. package/src/content/loaders/file.ts +169 -169
  27. package/src/content/loaders/glob.ts +252 -252
  28. package/src/content/loaders/index.ts +34 -34
  29. package/src/content/loaders/types.ts +137 -137
  30. package/src/content/meta-store.ts +209 -209
  31. package/src/content/types.ts +282 -282
  32. package/src/content/watcher.ts +135 -135
  33. package/src/contract/client-safe.test.ts +42 -42
  34. package/src/contract/client-safe.ts +114 -114
  35. package/src/contract/client.ts +16 -16
  36. package/src/contract/define.ts +459 -459
  37. package/src/contract/handler.ts +10 -10
  38. package/src/contract/normalize.test.ts +276 -276
  39. package/src/contract/normalize.ts +404 -404
  40. package/src/contract/registry.test.ts +206 -206
  41. package/src/contract/registry.ts +568 -568
  42. package/src/contract/schema.ts +48 -48
  43. package/src/contract/types.ts +58 -58
  44. package/src/contract/validator.ts +32 -32
  45. package/src/devtools/ai/context-builder.ts +375 -375
  46. package/src/devtools/ai/index.ts +25 -25
  47. package/src/devtools/ai/mcp-connector.ts +465 -465
  48. package/src/devtools/client/catchers/error-catcher.ts +327 -327
  49. package/src/devtools/client/catchers/index.ts +18 -18
  50. package/src/devtools/client/catchers/network-proxy.ts +363 -363
  51. package/src/devtools/client/components/index.ts +39 -39
  52. package/src/devtools/client/components/kitchen-root.tsx +362 -362
  53. package/src/devtools/client/components/mandu-character.tsx +241 -241
  54. package/src/devtools/client/components/overlay.tsx +368 -368
  55. package/src/devtools/client/components/panel/errors-panel.tsx +259 -259
  56. package/src/devtools/client/components/panel/guard-panel.tsx +244 -244
  57. package/src/devtools/client/components/panel/index.ts +32 -32
  58. package/src/devtools/client/components/panel/islands-panel.tsx +304 -304
  59. package/src/devtools/client/components/panel/network-panel.tsx +292 -292
  60. package/src/devtools/client/components/panel/panel-container.tsx +259 -259
  61. package/src/devtools/client/filters/context-filters.ts +282 -282
  62. package/src/devtools/client/filters/index.ts +16 -16
  63. package/src/devtools/client/index.ts +63 -63
  64. package/src/devtools/client/persistence.ts +335 -335
  65. package/src/devtools/client/state-manager.ts +478 -478
  66. package/src/devtools/design-tokens.ts +263 -263
  67. package/src/devtools/hook/create-hook.ts +207 -207
  68. package/src/devtools/hook/index.ts +13 -13
  69. package/src/devtools/index.ts +439 -439
  70. package/src/devtools/init.ts +266 -266
  71. package/src/devtools/protocol.ts +237 -237
  72. package/src/devtools/server/index.ts +17 -17
  73. package/src/devtools/server/source-context.ts +444 -444
  74. package/src/devtools/types.ts +319 -319
  75. package/src/devtools/worker/index.ts +25 -25
  76. package/src/devtools/worker/redaction-worker.ts +222 -222
  77. package/src/devtools/worker/worker-manager.ts +409 -409
  78. package/src/error/domains.ts +265 -265
  79. package/src/error/result.ts +46 -46
  80. package/src/error/types.ts +6 -6
  81. package/src/errors/extractor.ts +409 -409
  82. package/src/errors/index.ts +19 -19
  83. package/src/filling/auth.ts +308 -308
  84. package/src/filling/context.ts +24 -1
  85. package/src/filling/deps.ts +238 -238
  86. package/src/filling/index.ts +2 -0
  87. package/src/filling/sse.test.ts +168 -0
  88. package/src/filling/sse.ts +162 -0
  89. package/src/generator/index.ts +3 -3
  90. package/src/guard/analyzer.ts +360 -360
  91. package/src/guard/ast-analyzer.ts +806 -806
  92. package/src/guard/contract-guard.ts +9 -9
  93. package/src/guard/file-type.test.ts +24 -24
  94. package/src/guard/presets/atomic.ts +70 -70
  95. package/src/guard/presets/clean.ts +77 -77
  96. package/src/guard/presets/fsd.ts +79 -79
  97. package/src/guard/presets/hexagonal.ts +68 -68
  98. package/src/guard/presets/index.ts +291 -291
  99. package/src/guard/reporter.ts +445 -445
  100. package/src/guard/rules.ts +12 -12
  101. package/src/guard/statistics.ts +578 -578
  102. package/src/guard/suggestions.ts +358 -358
  103. package/src/guard/types.ts +348 -348
  104. package/src/guard/validator.ts +834 -834
  105. package/src/guard/watcher.ts +404 -404
  106. package/src/index.ts +6 -1
  107. package/src/intent/index.ts +310 -310
  108. package/src/island/index.ts +304 -304
  109. package/src/logging/index.ts +22 -22
  110. package/src/logging/transports.ts +365 -365
  111. package/src/plugins/index.ts +38 -38
  112. package/src/plugins/registry.ts +377 -377
  113. package/src/plugins/types.ts +363 -363
  114. package/src/report/index.ts +1 -1
  115. package/src/router/fs-patterns.ts +387 -387
  116. package/src/router/fs-scanner.ts +497 -497
  117. package/src/runtime/boundary.tsx +232 -232
  118. package/src/runtime/compose.ts +222 -222
  119. package/src/runtime/escape.ts +44 -0
  120. package/src/runtime/lifecycle.ts +381 -381
  121. package/src/runtime/logger.test.ts +345 -345
  122. package/src/runtime/logger.ts +677 -677
  123. package/src/runtime/router.test.ts +476 -476
  124. package/src/runtime/router.ts +105 -105
  125. package/src/runtime/security.ts +155 -155
  126. package/src/runtime/server.ts +257 -0
  127. package/src/runtime/session-key.ts +328 -328
  128. package/src/runtime/ssr.ts +16 -21
  129. package/src/runtime/streaming-ssr.ts +24 -33
  130. package/src/runtime/trace.ts +144 -144
  131. package/src/seo/index.ts +214 -214
  132. package/src/seo/integration/ssr.ts +307 -307
  133. package/src/seo/render/basic.ts +427 -427
  134. package/src/seo/render/index.ts +143 -143
  135. package/src/seo/render/jsonld.ts +539 -539
  136. package/src/seo/render/opengraph.ts +191 -191
  137. package/src/seo/render/robots.ts +116 -116
  138. package/src/seo/render/sitemap.ts +137 -137
  139. package/src/seo/render/twitter.ts +126 -126
  140. package/src/seo/resolve/index.ts +353 -353
  141. package/src/seo/resolve/opengraph.ts +143 -143
  142. package/src/seo/resolve/robots.ts +73 -73
  143. package/src/seo/resolve/title.ts +94 -94
  144. package/src/seo/resolve/twitter.ts +73 -73
  145. package/src/seo/resolve/url.ts +97 -97
  146. package/src/seo/routes/index.ts +290 -290
  147. package/src/seo/types.ts +575 -575
  148. package/src/slot/validator.ts +39 -39
  149. package/src/spec/index.ts +3 -3
  150. package/src/spec/load.ts +76 -76
  151. package/src/spec/lock.ts +56 -56
  152. package/src/utils/bun.ts +8 -8
  153. package/src/utils/lru-cache.ts +75 -75
  154. package/src/utils/safe-io.ts +188 -188
  155. package/src/utils/string-safe.ts +298 -298
package/src/seo/index.ts CHANGED
@@ -1,214 +1,214 @@
1
- /**
2
- * Mandu SEO Module
3
- *
4
- * Next.js Metadata API 패턴 기반의 SEO 지원
5
- *
6
- * @example
7
- * ```typescript
8
- * // app/layout.tsx - 정적 메타데이터
9
- * import type { Metadata } from '@mandujs/core'
10
- *
11
- * export const metadata: Metadata = {
12
- * metadataBase: new URL('https://example.com'),
13
- * title: {
14
- * template: '%s | My Site',
15
- * default: 'My Site',
16
- * },
17
- * description: 'Welcome to my site',
18
- * openGraph: {
19
- * siteName: 'My Site',
20
- * type: 'website',
21
- * },
22
- * }
23
- * ```
24
- *
25
- * @example
26
- * ```typescript
27
- * // app/blog/[slug]/page.tsx - 동적 메타데이터
28
- * import type { Metadata, MetadataParams } from '@mandujs/core'
29
- *
30
- * export async function generateMetadata({ params }: MetadataParams): Promise<Metadata> {
31
- * const post = await getPost(params.slug)
32
- * return {
33
- * title: post.title,
34
- * description: post.excerpt,
35
- * openGraph: {
36
- * title: post.title,
37
- * images: [post.coverImage],
38
- * },
39
- * }
40
- * }
41
- * ```
42
- */
43
-
44
- // Types
45
- export type {
46
- // Main types
47
- Metadata,
48
- ResolvedMetadata,
49
- MetadataItem,
50
- MetadataParams,
51
- GenerateMetadata,
52
-
53
- // Title types
54
- Title,
55
- TemplateString,
56
- AbsoluteString,
57
- AbsoluteTemplateString,
58
-
59
- // Basic types
60
- Author,
61
- ReferrerEnum,
62
- ColorSchemeEnum,
63
- Robots,
64
- ResolvedRobots,
65
-
66
- // Icons
67
- Icon,
68
- IconURL,
69
- IconDescriptor,
70
- Icons,
71
- ResolvedIcons,
72
-
73
- // Alternates
74
- AlternateURLs,
75
- ResolvedAlternateURLs,
76
- Languages,
77
-
78
- // Verification
79
- Verification,
80
- ResolvedVerification,
81
-
82
- // Open Graph
83
- OpenGraph,
84
- OpenGraphType,
85
- OpenGraphImage,
86
- OpenGraphVideo,
87
- OpenGraphAudio,
88
- OpenGraphArticle,
89
- OpenGraphProfile,
90
- OpenGraphBook,
91
- ResolvedOpenGraph,
92
-
93
- // Twitter
94
- Twitter,
95
- TwitterCardType,
96
- TwitterImage,
97
- TwitterPlayer,
98
- TwitterApp,
99
- ResolvedTwitter,
100
-
101
- // JSON-LD
102
- JsonLd,
103
- JsonLdType,
104
-
105
- // Google SEO 최적화
106
- GoogleMeta,
107
- FormatDetection,
108
- ResourceHint,
109
- AppLinks,
110
- ThemeColor,
111
-
112
- // Metadata Routes
113
- Sitemap,
114
- SitemapEntry,
115
- RobotsFile,
116
- RobotsRule,
117
- MetadataRoute,
118
- } from './types'
119
-
120
- // Resolve functions
121
- export {
122
- resolveMetadata,
123
- mergeMetadata,
124
- createDefaultMetadata,
125
- resolveTitle,
126
- extractTitleTemplate,
127
- normalizeMetadataBase,
128
- resolveUrl,
129
- urlToString,
130
- resolveRobots,
131
- resolveOpenGraph,
132
- resolveTwitter,
133
- } from './resolve'
134
-
135
- // Render functions
136
- export {
137
- renderMetadata,
138
- renderTitle,
139
- renderBasicMeta,
140
- renderVerification,
141
- renderAlternates,
142
- renderIcons,
143
- renderManifest,
144
- renderOther,
145
- renderOpenGraph,
146
- renderTwitter,
147
- renderJsonLd,
148
- // JSON-LD helpers
149
- createArticleJsonLd,
150
- createWebSiteJsonLd,
151
- createOrganizationJsonLd,
152
- createBreadcrumbJsonLd,
153
- createFAQJsonLd,
154
- createProductJsonLd,
155
- createLocalBusinessJsonLd,
156
- createVideoJsonLd,
157
- createReviewJsonLd,
158
- createCourseJsonLd,
159
- createEventJsonLd,
160
- createSoftwareAppJsonLd,
161
- // Google SEO 최적화 렌더링
162
- renderGoogle,
163
- renderFormatDetection,
164
- renderThemeColor,
165
- renderViewport,
166
- renderResourceHints,
167
- renderAppLinks,
168
- // Metadata Routes rendering
169
- renderSitemap,
170
- renderSitemapIndex,
171
- renderRobots,
172
- createDefaultRobots,
173
- createDevRobots,
174
- } from './render'
175
-
176
- // Metadata Routes (sitemap.ts, robots.ts)
177
- export {
178
- createSitemapHandler,
179
- createRobotsHandler,
180
- createSitemapIndexHandler,
181
- buildMetadataRoutes,
182
- getMetadataRouteType,
183
- createMetadataRouteInfo,
184
- createDynamicSitemapRouteInfo,
185
- METADATA_ROUTE_PATTERNS,
186
- } from './routes'
187
-
188
- export type {
189
- SitemapFunction,
190
- RobotsFunction,
191
- MetadataRouteModule,
192
- MetadataRouteHandler,
193
- MetadataRouteConfig,
194
- DiscoveredRoutes,
195
- MetadataRouteDefinition,
196
- } from './routes'
197
-
198
- // SSR Integration
199
- export {
200
- resolveSEO,
201
- resolveSEOSync,
202
- injectSEOIntoOptions,
203
- layoutEntriesToMetadataItems,
204
- metadataToProps,
205
- generateHeadUpdateScript,
206
- } from './integration/ssr'
207
-
208
- export type {
209
- SEOOptions,
210
- SEOResult,
211
- LayoutMetadataEntry,
212
- SEOContextValue,
213
- StreamingSSRWithSEOOptions,
214
- } from './integration/ssr'
1
+ /**
2
+ * Mandu SEO Module
3
+ *
4
+ * Next.js Metadata API 패턴 기반의 SEO 지원
5
+ *
6
+ * @example
7
+ * ```typescript
8
+ * // app/layout.tsx - 정적 메타데이터
9
+ * import type { Metadata } from '@mandujs/core'
10
+ *
11
+ * export const metadata: Metadata = {
12
+ * metadataBase: new URL('https://example.com'),
13
+ * title: {
14
+ * template: '%s | My Site',
15
+ * default: 'My Site',
16
+ * },
17
+ * description: 'Welcome to my site',
18
+ * openGraph: {
19
+ * siteName: 'My Site',
20
+ * type: 'website',
21
+ * },
22
+ * }
23
+ * ```
24
+ *
25
+ * @example
26
+ * ```typescript
27
+ * // app/blog/[slug]/page.tsx - 동적 메타데이터
28
+ * import type { Metadata, MetadataParams } from '@mandujs/core'
29
+ *
30
+ * export async function generateMetadata({ params }: MetadataParams): Promise<Metadata> {
31
+ * const post = await getPost(params.slug)
32
+ * return {
33
+ * title: post.title,
34
+ * description: post.excerpt,
35
+ * openGraph: {
36
+ * title: post.title,
37
+ * images: [post.coverImage],
38
+ * },
39
+ * }
40
+ * }
41
+ * ```
42
+ */
43
+
44
+ // Types
45
+ export type {
46
+ // Main types
47
+ Metadata,
48
+ ResolvedMetadata,
49
+ MetadataItem,
50
+ MetadataParams,
51
+ GenerateMetadata,
52
+
53
+ // Title types
54
+ Title,
55
+ TemplateString,
56
+ AbsoluteString,
57
+ AbsoluteTemplateString,
58
+
59
+ // Basic types
60
+ Author,
61
+ ReferrerEnum,
62
+ ColorSchemeEnum,
63
+ Robots,
64
+ ResolvedRobots,
65
+
66
+ // Icons
67
+ Icon,
68
+ IconURL,
69
+ IconDescriptor,
70
+ Icons,
71
+ ResolvedIcons,
72
+
73
+ // Alternates
74
+ AlternateURLs,
75
+ ResolvedAlternateURLs,
76
+ Languages,
77
+
78
+ // Verification
79
+ Verification,
80
+ ResolvedVerification,
81
+
82
+ // Open Graph
83
+ OpenGraph,
84
+ OpenGraphType,
85
+ OpenGraphImage,
86
+ OpenGraphVideo,
87
+ OpenGraphAudio,
88
+ OpenGraphArticle,
89
+ OpenGraphProfile,
90
+ OpenGraphBook,
91
+ ResolvedOpenGraph,
92
+
93
+ // Twitter
94
+ Twitter,
95
+ TwitterCardType,
96
+ TwitterImage,
97
+ TwitterPlayer,
98
+ TwitterApp,
99
+ ResolvedTwitter,
100
+
101
+ // JSON-LD
102
+ JsonLd,
103
+ JsonLdType,
104
+
105
+ // Google SEO 최적화
106
+ GoogleMeta,
107
+ FormatDetection,
108
+ ResourceHint,
109
+ AppLinks,
110
+ ThemeColor,
111
+
112
+ // Metadata Routes
113
+ Sitemap,
114
+ SitemapEntry,
115
+ RobotsFile,
116
+ RobotsRule,
117
+ MetadataRoute,
118
+ } from './types'
119
+
120
+ // Resolve functions
121
+ export {
122
+ resolveMetadata,
123
+ mergeMetadata,
124
+ createDefaultMetadata,
125
+ resolveTitle,
126
+ extractTitleTemplate,
127
+ normalizeMetadataBase,
128
+ resolveUrl,
129
+ urlToString,
130
+ resolveRobots,
131
+ resolveOpenGraph,
132
+ resolveTwitter,
133
+ } from './resolve'
134
+
135
+ // Render functions
136
+ export {
137
+ renderMetadata,
138
+ renderTitle,
139
+ renderBasicMeta,
140
+ renderVerification,
141
+ renderAlternates,
142
+ renderIcons,
143
+ renderManifest,
144
+ renderOther,
145
+ renderOpenGraph,
146
+ renderTwitter,
147
+ renderJsonLd,
148
+ // JSON-LD helpers
149
+ createArticleJsonLd,
150
+ createWebSiteJsonLd,
151
+ createOrganizationJsonLd,
152
+ createBreadcrumbJsonLd,
153
+ createFAQJsonLd,
154
+ createProductJsonLd,
155
+ createLocalBusinessJsonLd,
156
+ createVideoJsonLd,
157
+ createReviewJsonLd,
158
+ createCourseJsonLd,
159
+ createEventJsonLd,
160
+ createSoftwareAppJsonLd,
161
+ // Google SEO 최적화 렌더링
162
+ renderGoogle,
163
+ renderFormatDetection,
164
+ renderThemeColor,
165
+ renderViewport,
166
+ renderResourceHints,
167
+ renderAppLinks,
168
+ // Metadata Routes rendering
169
+ renderSitemap,
170
+ renderSitemapIndex,
171
+ renderRobots,
172
+ createDefaultRobots,
173
+ createDevRobots,
174
+ } from './render'
175
+
176
+ // Metadata Routes (sitemap.ts, robots.ts)
177
+ export {
178
+ createSitemapHandler,
179
+ createRobotsHandler,
180
+ createSitemapIndexHandler,
181
+ buildMetadataRoutes,
182
+ getMetadataRouteType,
183
+ createMetadataRouteInfo,
184
+ createDynamicSitemapRouteInfo,
185
+ METADATA_ROUTE_PATTERNS,
186
+ } from './routes'
187
+
188
+ export type {
189
+ SitemapFunction,
190
+ RobotsFunction,
191
+ MetadataRouteModule,
192
+ MetadataRouteHandler,
193
+ MetadataRouteConfig,
194
+ DiscoveredRoutes,
195
+ MetadataRouteDefinition,
196
+ } from './routes'
197
+
198
+ // SSR Integration
199
+ export {
200
+ resolveSEO,
201
+ resolveSEOSync,
202
+ injectSEOIntoOptions,
203
+ layoutEntriesToMetadataItems,
204
+ metadataToProps,
205
+ generateHeadUpdateScript,
206
+ } from './integration/ssr'
207
+
208
+ export type {
209
+ SEOOptions,
210
+ SEOResult,
211
+ LayoutMetadataEntry,
212
+ SEOContextValue,
213
+ StreamingSSRWithSEOOptions,
214
+ } from './integration/ssr'