@mandujs/core 0.12.2 → 0.13.0

package/src/seo/resolve/twitter.ts

@@ -1,73 +1,73 @@
-/**
- * Mandu SEO - Twitter Card Resolution
- */
-
-import type {
-  Twitter,
-  TwitterImage,
-  ResolvedTwitter,
-} from '../types'
-import { resolveUrl } from './url'
-
-/**
- * Twitter 이미지 배열로 정규화
- */
-function resolveTwitterImages(
-  images: Twitter['images'],
-  metadataBase: URL | null
-): TwitterImage[] | null {
-  if (!images) return null
-
-  const arr = Array.isArray(images) ? images : [images]
-  const resolved: TwitterImage[] = []
-
-  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({
-          url: url.href,
-          alt: image.alt,
-        })
-      }
-    }
-  }
-
-  return resolved.length > 0 ? resolved : null
-}
-
-/**
- * Twitter Card 메타데이터 해석
- */
-export function resolveTwitter(
-  twitter: Twitter | null | undefined,
-  metadataBase: URL | null
-): ResolvedTwitter | null {
-  if (!twitter) return null
-
-  // 이미지가 있으면 기본 card는 summary_large_image
-  const hasImages = twitter.images !== undefined
-  const defaultCard = hasImages ? 'summary_large_image' : 'summary'
-
-  return {
-    card: twitter.card || defaultCard,
-    site: twitter.site || null,
-    siteId: twitter.siteId || null,
-    creator: twitter.creator || null,
-    creatorId: twitter.creatorId || null,
-    title: twitter.title || null,
-    description: twitter.description || null,
-    images: resolveTwitterImages(twitter.images, metadataBase),
-    players: twitter.players
-      ? Array.isArray(twitter.players)
-        ? twitter.players
-        : [twitter.players]
-      : null,
-    app: twitter.app || null,
-  }
-}
+/**
+ * Mandu SEO - Twitter Card Resolution
+ */
+
+import type {
+  Twitter,
+  TwitterImage,
+  ResolvedTwitter,
+} from '../types'
+import { resolveUrl } from './url'
+
+/**
+ * Twitter 이미지 배열로 정규화
+ */
+function resolveTwitterImages(
+  images: Twitter['images'],
+  metadataBase: URL | null
+): TwitterImage[] | null {
+  if (!images) return null
+
+  const arr = Array.isArray(images) ? images : [images]
+  const resolved: TwitterImage[] = []
+
+  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({
+          url: url.href,
+          alt: image.alt,
+        })
+      }
+    }
+  }
+
+  return resolved.length > 0 ? resolved : null
+}
+
+/**
+ * Twitter Card 메타데이터 해석
+ */
+export function resolveTwitter(
+  twitter: Twitter | null | undefined,
+  metadataBase: URL | null
+): ResolvedTwitter | null {
+  if (!twitter) return null
+
+  // 이미지가 있으면 기본 card는 summary_large_image
+  const hasImages = twitter.images !== undefined
+  const defaultCard = hasImages ? 'summary_large_image' : 'summary'
+
+  return {
+    card: twitter.card || defaultCard,
+    site: twitter.site || null,
+    siteId: twitter.siteId || null,
+    creator: twitter.creator || null,
+    creatorId: twitter.creatorId || null,
+    title: twitter.title || null,
+    description: twitter.description || null,
+    images: resolveTwitterImages(twitter.images, metadataBase),
+    players: twitter.players
+      ? Array.isArray(twitter.players)
+        ? twitter.players
+        : [twitter.players]
+      : null,
+    app: twitter.app || null,
+  }
+}

package/src/seo/resolve/url.ts

@@ -1,97 +1,97 @@
-/**
- * Mandu SEO - URL Resolution
- *
- * 상대 URL을 metadataBase 기준 절대 URL로 변환
- */
-
-/**
- * metadataBase를 URL 객체로 정규화
- */
-export function normalizeMetadataBase(
-  metadataBase: string | URL | null | undefined
-): URL | null {
-  if (!metadataBase) return null
-
-  if (metadataBase instanceof URL) {
-    return metadataBase
-  }
-
-  try {
-    return new URL(metadataBase)
-  } catch {
-    console.warn(`[Mandu SEO] Invalid metadataBase: ${metadataBase}`)
-    return null
-  }
-}
-
-/**
- * 상대 URL을 절대 URL로 변환
- */
-export function resolveUrl(
-  url: string | URL | null | undefined,
-  metadataBase: URL | null
-): URL | null {
-  if (!url) return null
-
-  // 이미 URL 객체
-  if (url instanceof URL) {
-    return url
-  }
-
-  // 이미 절대 URL
-  if (url.startsWith('http://') || url.startsWith('https://')) {
-    try {
-      return new URL(url)
-    } catch {
-      return null
-    }
-  }
-
-  // 상대 URL - metadataBase 필요
-  if (!metadataBase) {
-    // metadataBase 없이 상대 URL 사용 시 경고
-    if (url.startsWith('/')) {
-      console.warn(
-        `[Mandu SEO] Relative URL "${url}" requires metadataBase to be set. ` +
-        `Add metadataBase to your root layout's metadata.`
-      )
-    }
-    return null
-  }
-
-  try {
-    return new URL(url, metadataBase)
-  } catch {
-    return null
-  }
-}
-
-/**
- * URL을 문자열로 변환 (렌더링용)
- */
-export function urlToString(url: URL | string | null | undefined): string | null {
-  if (!url) return null
-  if (url instanceof URL) return url.href
-  return url
-}
-
-/**
- * 배열의 URL들을 모두 절대 URL로 변환
- */
-export function resolveUrls<T extends { url: string | URL }>(
-  items: T[] | null | undefined,
-  metadataBase: URL | null
-): (T & { url: URL })[] | null {
-  if (!items || items.length === 0) return null
-
-  const resolved: (T & { url: URL })[] = []
-
-  for (const item of items) {
-    const resolvedUrl = resolveUrl(item.url, metadataBase)
-    if (resolvedUrl) {
-      resolved.push({ ...item, url: resolvedUrl })
-    }
-  }
-
-  return resolved.length > 0 ? resolved : null
-}
+/**
+ * Mandu SEO - URL Resolution
+ *
+ * 상대 URL을 metadataBase 기준 절대 URL로 변환
+ */
+
+/**
+ * metadataBase를 URL 객체로 정규화
+ */
+export function normalizeMetadataBase(
+  metadataBase: string | URL | null | undefined
+): URL | null {
+  if (!metadataBase) return null
+
+  if (metadataBase instanceof URL) {
+    return metadataBase
+  }
+
+  try {
+    return new URL(metadataBase)
+  } catch {
+    console.warn(`[Mandu SEO] Invalid metadataBase: ${metadataBase}`)
+    return null
+  }
+}
+
+/**
+ * 상대 URL을 절대 URL로 변환
+ */
+export function resolveUrl(
+  url: string | URL | null | undefined,
+  metadataBase: URL | null
+): URL | null {
+  if (!url) return null
+
+  // 이미 URL 객체
+  if (url instanceof URL) {
+    return url
+  }
+
+  // 이미 절대 URL
+  if (url.startsWith('http://') || url.startsWith('https://')) {
+    try {
+      return new URL(url)
+    } catch {
+      return null
+    }
+  }
+
+  // 상대 URL - metadataBase 필요
+  if (!metadataBase) {
+    // metadataBase 없이 상대 URL 사용 시 경고
+    if (url.startsWith('/')) {
+      console.warn(
+        `[Mandu SEO] Relative URL "${url}" requires metadataBase to be set. ` +
+        `Add metadataBase to your root layout's metadata.`
+      )
+    }
+    return null
+  }
+
+  try {
+    return new URL(url, metadataBase)
+  } catch {
+    return null
+  }
+}
+
+/**
+ * URL을 문자열로 변환 (렌더링용)
+ */
+export function urlToString(url: URL | string | null | undefined): string | null {
+  if (!url) return null
+  if (url instanceof URL) return url.href
+  return url
+}
+
+/**
+ * 배열의 URL들을 모두 절대 URL로 변환
+ */
+export function resolveUrls<T extends { url: string | URL }>(
+  items: T[] | null | undefined,
+  metadataBase: URL | null
+): (T & { url: URL })[] | null {
+  if (!items || items.length === 0) return null
+
+  const resolved: (T & { url: URL })[] = []
+
+  for (const item of items) {
+    const resolvedUrl = resolveUrl(item.url, metadataBase)
+    if (resolvedUrl) {
+      resolved.push({ ...item, url: resolvedUrl })
+    }
+  }
+
+  return resolved.length > 0 ? resolved : null
+}