@mandujs/core 0.54.31 → 0.55.0-beta.1

package/src/seo/resolve/opengraph.ts

@@ -1,143 +1,143 @@
-/**
- * Mandu SEO - Open Graph Resolution
- */
-
-import type {
-  OpenGraph,
-  OpenGraphImage,
-  OpenGraphVideo,
-  OpenGraphAudio,
-  ResolvedOpenGraph,
-} from '../types'
-import { resolveUrl } from './url'
-
-/**
- * OG 이미지 배열로 정규화
- */
-function resolveOgImages(
-  images: OpenGraph['images'],
-  metadataBase: URL | null
-): OpenGraphImage[] | null {
-  if (!images) return null
-
-  const arr = Array.isArray(images) ? images : [images]
-  const resolved: OpenGraphImage[] = []
-
-  for (const image of arr) {
-    if (typeof image === 'string' || image instanceof URL) {
-      const url = resolveUrl(image, metadataBase)
-      if (url) {
-        resolved.push({ url: url.href })
-      }
-    } else {
-      const url = resolveUrl(image.url, metadataBase)
-      if (url) {
-        resolved.push({
-          ...image,
-          url: url.href,
-          secureUrl: image.secureUrl
-            ? resolveUrl(image.secureUrl, metadataBase)?.href
-            : undefined,
-        })
-      }
-    }
-  }
-
-  return resolved.length > 0 ? resolved : null
-}
-
-/**
- * OG 비디오 배열로 정규화
- */
-function resolveOgVideos(
-  videos: OpenGraph['videos'],
-  metadataBase: URL | null
-): OpenGraphVideo[] | null {
-  if (!videos) return null
-
-  const arr = Array.isArray(videos) ? videos : [videos]
-  const resolved: OpenGraphVideo[] = []
-
-  for (const video of arr) {
-    if (typeof video === 'string' || video instanceof URL) {
-      const url = resolveUrl(video, metadataBase)
-      if (url) {
-        resolved.push({ url: url.href })
-      }
-    } else {
-      const url = resolveUrl(video.url, metadataBase)
-      if (url) {
-        resolved.push({
-          ...video,
-          url: url.href,
-          secureUrl: video.secureUrl
-            ? resolveUrl(video.secureUrl, metadataBase)?.href
-            : undefined,
-        })
-      }
-    }
-  }
-
-  return resolved.length > 0 ? resolved : null
-}
-
-/**
- * OG 오디오 배열로 정규화
- */
-function resolveOgAudio(
-  audio: OpenGraph['audio'],
-  metadataBase: URL | null
-): OpenGraphAudio[] | null {
-  if (!audio) return null
-
-  const arr = Array.isArray(audio) ? audio : [audio]
-  const resolved: OpenGraphAudio[] = []
-
-  for (const item of arr) {
-    if (typeof item === 'string' || item instanceof URL) {
-      const url = resolveUrl(item, metadataBase)
-      if (url) {
-        resolved.push({ url: url.href })
-      }
-    } else {
-      const url = resolveUrl(item.url, metadataBase)
-      if (url) {
-        resolved.push({
-          ...item,
-          url: url.href,
-          secureUrl: item.secureUrl
-            ? resolveUrl(item.secureUrl, metadataBase)?.href
-            : undefined,
-        })
-      }
-    }
-  }
-
-  return resolved.length > 0 ? resolved : null
-}
-
-/**
- * Open Graph 메타데이터 해석
- */
-export function resolveOpenGraph(
-  openGraph: OpenGraph | null | undefined,
-  metadataBase: URL | null
-): ResolvedOpenGraph | null {
-  if (!openGraph) return null
-
-  return {
-    type: openGraph.type || 'website',
-    url: resolveUrl(openGraph.url, metadataBase),
-    title: openGraph.title || null,
-    description: openGraph.description || null,
-    siteName: openGraph.siteName || null,
-    locale: openGraph.locale || null,
-    images: resolveOgImages(openGraph.images, metadataBase),
-    videos: resolveOgVideos(openGraph.videos, metadataBase),
-    audio: resolveOgAudio(openGraph.audio, metadataBase),
-    determiner: openGraph.determiner || null,
-    article: openGraph.article || null,
-    profile: openGraph.profile || null,
-    book: openGraph.book || null,
-  }
-}
+/**
+ * Mandu SEO - Open Graph Resolution
+ */
+
+import type {
+  OpenGraph,
+  OpenGraphImage,
+  OpenGraphVideo,
+  OpenGraphAudio,
+  ResolvedOpenGraph,
+} from '../types'
+import { resolveUrl } from './url'
+
+/**
+ * OG 이미지 배열로 정규화
+ */
+function resolveOgImages(
+  images: OpenGraph['images'],
+  metadataBase: URL | null
+): OpenGraphImage[] | null {
+  if (!images) return null
+
+  const arr = Array.isArray(images) ? images : [images]
+  const resolved: OpenGraphImage[] = []
+
+  for (const image of arr) {
+    if (typeof image === 'string' || image instanceof URL) {
+      const url = resolveUrl(image, metadataBase)
+      if (url) {
+        resolved.push({ url: url.href })
+      }
+    } else {
+      const url = resolveUrl(image.url, metadataBase)
+      if (url) {
+        resolved.push({
+          ...image,
+          url: url.href,
+          secureUrl: image.secureUrl
+            ? resolveUrl(image.secureUrl, metadataBase)?.href
+            : undefined,
+        })
+      }
+    }
+  }
+
+  return resolved.length > 0 ? resolved : null
+}
+
+/**
+ * OG 비디오 배열로 정규화
+ */
+function resolveOgVideos(
+  videos: OpenGraph['videos'],
+  metadataBase: URL | null
+): OpenGraphVideo[] | null {
+  if (!videos) return null
+
+  const arr = Array.isArray(videos) ? videos : [videos]
+  const resolved: OpenGraphVideo[] = []
+
+  for (const video of arr) {
+    if (typeof video === 'string' || video instanceof URL) {
+      const url = resolveUrl(video, metadataBase)
+      if (url) {
+        resolved.push({ url: url.href })
+      }
+    } else {
+      const url = resolveUrl(video.url, metadataBase)
+      if (url) {
+        resolved.push({
+          ...video,
+          url: url.href,
+          secureUrl: video.secureUrl
+            ? resolveUrl(video.secureUrl, metadataBase)?.href
+            : undefined,
+        })
+      }
+    }
+  }
+
+  return resolved.length > 0 ? resolved : null
+}
+
+/**
+ * OG 오디오 배열로 정규화
+ */
+function resolveOgAudio(
+  audio: OpenGraph['audio'],
+  metadataBase: URL | null
+): OpenGraphAudio[] | null {
+  if (!audio) return null
+
+  const arr = Array.isArray(audio) ? audio : [audio]
+  const resolved: OpenGraphAudio[] = []
+
+  for (const item of arr) {
+    if (typeof item === 'string' || item instanceof URL) {
+      const url = resolveUrl(item, metadataBase)
+      if (url) {
+        resolved.push({ url: url.href })
+      }
+    } else {
+      const url = resolveUrl(item.url, metadataBase)
+      if (url) {
+        resolved.push({
+          ...item,
+          url: url.href,
+          secureUrl: item.secureUrl
+            ? resolveUrl(item.secureUrl, metadataBase)?.href
+            : undefined,
+        })
+      }
+    }
+  }
+
+  return resolved.length > 0 ? resolved : null
+}
+
+/**
+ * Open Graph 메타데이터 해석
+ */
+export function resolveOpenGraph(
+  openGraph: OpenGraph | null | undefined,
+  metadataBase: URL | null
+): ResolvedOpenGraph | null {
+  if (!openGraph) return null
+
+  return {
+    type: openGraph.type || 'website',
+    url: resolveUrl(openGraph.url, metadataBase),
+    title: openGraph.title || null,
+    description: openGraph.description || null,
+    siteName: openGraph.siteName || null,
+    locale: openGraph.locale || null,
+    images: resolveOgImages(openGraph.images, metadataBase),
+    videos: resolveOgVideos(openGraph.videos, metadataBase),
+    audio: resolveOgAudio(openGraph.audio, metadataBase),
+    determiner: openGraph.determiner || null,
+    article: openGraph.article || null,
+    profile: openGraph.profile || null,
+    book: openGraph.book || null,
+  }
+}

package/src/seo/resolve/robots.ts

@@ -1,73 +1,73 @@
-/**
- * Mandu SEO - Robots Resolution
- *
- * robots 메타 태그 값 생성
- */
-
-import type { Robots, ResolvedRobots } from '../types'
-
-/**
- * Robots 객체를 문자열로 변환
- */
-function robotsToString(robots: Robots): string {
-  const values: string[] = []
-
-  // Boolean directives
-  if (robots.index === true) values.push('index')
-  if (robots.index === false) values.push('noindex')
-  if (robots.follow === true) values.push('follow')
-  if (robots.follow === false) values.push('nofollow')
-  if (robots.noarchive) values.push('noarchive')
-  if (robots.nosnippet) values.push('nosnippet')
-  if (robots.noimageindex) values.push('noimageindex')
-  if (robots.nocache) values.push('nocache')
-  if (robots.notranslate) values.push('notranslate')
-
-  // Numeric directives
-  if (robots['max-snippet'] !== undefined) {
-    values.push(`max-snippet:${robots['max-snippet']}`)
-  }
-  if (robots['max-image-preview']) {
-    values.push(`max-image-preview:${robots['max-image-preview']}`)
-  }
-  if (robots['max-video-preview'] !== undefined) {
-    values.push(`max-video-preview:${robots['max-video-preview']}`)
-  }
-
-  return values.join(', ')
-}
-
-/**
- * Robots 설정 해석
- */
-export function resolveRobots(
-  robots: string | Robots | null | undefined
-): ResolvedRobots | null {
-  if (!robots) return null
-
-  // 문자열 그대로 사용
-  if (typeof robots === 'string') {
-    return {
-      basic: robots,
-      googleBot: null,
-    }
-  }
-
-  // 객체에서 문자열 생성
-  const basicString = robotsToString(robots)
-
-  return {
-    basic: basicString || null,
-    googleBot: null, // 향후 googleBot 별도 설정 지원
-  }
-}
-
-/**
- * 기본 robots 값 생성 (index, follow)
- */
-export function getDefaultRobots(): ResolvedRobots {
-  return {
-    basic: 'index, follow',
-    googleBot: null,
-  }
-}
+/**
+ * Mandu SEO - Robots Resolution
+ *
+ * robots 메타 태그 값 생성
+ */
+
+import type { Robots, ResolvedRobots } from '../types'
+
+/**
+ * Robots 객체를 문자열로 변환
+ */
+function robotsToString(robots: Robots): string {
+  const values: string[] = []
+
+  // Boolean directives
+  if (robots.index === true) values.push('index')
+  if (robots.index === false) values.push('noindex')
+  if (robots.follow === true) values.push('follow')
+  if (robots.follow === false) values.push('nofollow')
+  if (robots.noarchive) values.push('noarchive')
+  if (robots.nosnippet) values.push('nosnippet')
+  if (robots.noimageindex) values.push('noimageindex')
+  if (robots.nocache) values.push('nocache')
+  if (robots.notranslate) values.push('notranslate')
+
+  // Numeric directives
+  if (robots['max-snippet'] !== undefined) {
+    values.push(`max-snippet:${robots['max-snippet']}`)
+  }
+  if (robots['max-image-preview']) {
+    values.push(`max-image-preview:${robots['max-image-preview']}`)
+  }
+  if (robots['max-video-preview'] !== undefined) {
+    values.push(`max-video-preview:${robots['max-video-preview']}`)
+  }
+
+  return values.join(', ')
+}
+
+/**
+ * Robots 설정 해석
+ */
+export function resolveRobots(
+  robots: string | Robots | null | undefined
+): ResolvedRobots | null {
+  if (!robots) return null
+
+  // 문자열 그대로 사용
+  if (typeof robots === 'string') {
+    return {
+      basic: robots,
+      googleBot: null,
+    }
+  }
+
+  // 객체에서 문자열 생성
+  const basicString = robotsToString(robots)
+
+  return {
+    basic: basicString || null,
+    googleBot: null, // 향후 googleBot 별도 설정 지원
+  }
+}
+
+/**
+ * 기본 robots 값 생성 (index, follow)
+ */
+export function getDefaultRobots(): ResolvedRobots {
+  return {
+    basic: 'index, follow',
+    googleBot: null,
+  }
+}

package/src/seo/resolve/title.ts

@@ -1,94 +1,94 @@
-/**
- * Mandu SEO - Title Resolution
- *
- * title.template 패턴 처리
- * Layout의 template이 Page의 title에 적용됨
- */
-
-import type { Title, TemplateString, AbsoluteTemplateString, AbsoluteString } from '../types'
-
-/**
- * Title이 TemplateString 객체인지 확인 (default 필드 있음)
- */
-function isTemplateString(title: Title): title is TemplateString {
-  return typeof title === 'object' && title !== null && 'default' in title
-}
-
-/**
- * Title이 AbsoluteString 객체인지 확인 (absolute 필드만 있음, default 없음)
- */
-function isAbsoluteString(title: Title): title is AbsoluteString {
-  return typeof title === 'object' && title !== null && 'absolute' in title && !('default' in title)
-}
-
-/**
- * Title을 AbsoluteTemplateString으로 변환
- */
-export function resolveTitle(
-  title: Title | null | undefined,
-  parentTemplate: string | null
-): AbsoluteTemplateString | null {
-  if (title === null || title === undefined) {
-    return null
-  }
-
-  // String title
-  if (typeof title === 'string') {
-    // 부모 템플릿 적용
-    const absolute = parentTemplate
-      ? parentTemplate.replace('%s', title)
-      : title
-
-    return {
-      absolute,
-      template: null,
-    }
-  }
-
-  // AbsoluteString object ({ absolute: string }) - 템플릿 무시
-  if (isAbsoluteString(title)) {
-    return {
-      absolute: title.absolute,
-      template: title.template || null,
-    }
-  }
-
-  // TemplateString object ({ default: string, template?: string })
-  if (isTemplateString(title)) {
-    // default에 부모 템플릿 적용
-    const absolute = parentTemplate
-      ? parentTemplate.replace('%s', title.default)
-      : title.default
-
-    return {
-      absolute,
-      template: title.template || null,
-    }
-  }
-
-  return null
-}
-
-/**
- * Layout 체인에서 title template 추출
- */
-export function extractTitleTemplate(title: Title | null | undefined): string | null {
-  if (!title) return null
-
-  if (typeof title === 'string') {
-    return null
-  }
-
-  if (isTemplateString(title)) {
-    return title.template || null
-  }
-
-  return null
-}
-
-/**
- * title.absolute 값 추출 (렌더링용)
- */
-export function getTitleString(resolved: AbsoluteTemplateString | null): string | null {
-  return resolved?.absolute || null
-}
+/**
+ * Mandu SEO - Title Resolution
+ *
+ * title.template 패턴 처리
+ * Layout의 template이 Page의 title에 적용됨
+ */
+
+import type { Title, TemplateString, AbsoluteTemplateString, AbsoluteString } from '../types'
+
+/**
+ * Title이 TemplateString 객체인지 확인 (default 필드 있음)
+ */
+function isTemplateString(title: Title): title is TemplateString {
+  return typeof title === 'object' && title !== null && 'default' in title
+}
+
+/**
+ * Title이 AbsoluteString 객체인지 확인 (absolute 필드만 있음, default 없음)
+ */
+function isAbsoluteString(title: Title): title is AbsoluteString {
+  return typeof title === 'object' && title !== null && 'absolute' in title && !('default' in title)
+}
+
+/**
+ * Title을 AbsoluteTemplateString으로 변환
+ */
+export function resolveTitle(
+  title: Title | null | undefined,
+  parentTemplate: string | null
+): AbsoluteTemplateString | null {
+  if (title === null || title === undefined) {
+    return null
+  }
+
+  // String title
+  if (typeof title === 'string') {
+    // 부모 템플릿 적용
+    const absolute = parentTemplate
+      ? parentTemplate.replace('%s', title)
+      : title
+
+    return {
+      absolute,
+      template: null,
+    }
+  }
+
+  // AbsoluteString object ({ absolute: string }) - 템플릿 무시
+  if (isAbsoluteString(title)) {
+    return {
+      absolute: title.absolute,
+      template: title.template || null,
+    }
+  }
+
+  // TemplateString object ({ default: string, template?: string })
+  if (isTemplateString(title)) {
+    // default에 부모 템플릿 적용
+    const absolute = parentTemplate
+      ? parentTemplate.replace('%s', title.default)
+      : title.default
+
+    return {
+      absolute,
+      template: title.template || null,
+    }
+  }
+
+  return null
+}
+
+/**
+ * Layout 체인에서 title template 추출
+ */
+export function extractTitleTemplate(title: Title | null | undefined): string | null {
+  if (!title) return null
+
+  if (typeof title === 'string') {
+    return null
+  }
+
+  if (isTemplateString(title)) {
+    return title.template || null
+  }
+
+  return null
+}
+
+/**
+ * title.absolute 값 추출 (렌더링용)
+ */
+export function getTitleString(resolved: AbsoluteTemplateString | null): string | null {
+  return resolved?.absolute || null
+}