@mandujs/core 0.12.1 → 0.13.0

package/src/seo/render/opengraph.ts

@@ -1,191 +1,191 @@
-/**
- * Mandu SEO - Open Graph Meta Tags Rendering
- */
-
-import type { ResolvedMetadata, ResolvedOpenGraph } from '../types'
-import { urlToString } from '../resolve/url'
-
-/**
- * HTML 이스케이프
- */
-function escapeHtml(str: string): string {
-  return str
-    .replace(/&/g, '&')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&#039;')
-}
-
-/**
- * OG 메타 태그 생성 헬퍼
- */
-function og(property: string, content: string | number): string {
-  return `<meta property="og:${property}" content="${escapeHtml(String(content))}" />`
-}
-
-/**
- * Open Graph 메타 태그 렌더링
- */
-export function renderOpenGraph(metadata: ResolvedMetadata): string {
-  const openGraph = metadata.openGraph
-  if (!openGraph) return ''
-
-  const tags: string[] = []
-
-  // Basic OG tags
-  if (openGraph.type) {
-    tags.push(og('type', openGraph.type))
-  }
-
-  // title - fallback to metadata.title
-  const title = openGraph.title || metadata.title?.absolute
-  if (title) {
-    tags.push(og('title', title))
-  }
-
-  // description - fallback to metadata.description
-  const description = openGraph.description || metadata.description
-  if (description) {
-    tags.push(og('description', description))
-  }
-
-  if (openGraph.url) {
-    tags.push(og('url', openGraph.url.href))
-  }
-
-  if (openGraph.siteName) {
-    tags.push(og('site_name', openGraph.siteName))
-  }
-
-  if (openGraph.locale) {
-    tags.push(og('locale', openGraph.locale))
-  }
-
-  if (openGraph.determiner) {
-    tags.push(og('determiner', openGraph.determiner))
-  }
-
-  // Images
-  if (openGraph.images) {
-    for (const image of openGraph.images) {
-      tags.push(og('image', urlToString(image.url)))
-      if (image.secureUrl) {
-        tags.push(og('image:secure_url', urlToString(image.secureUrl)))
-      }
-      if (image.type) {
-        tags.push(og('image:type', image.type))
-      }
-      if (image.width) {
-        tags.push(og('image:width', image.width))
-      }
-      if (image.height) {
-        tags.push(og('image:height', image.height))
-      }
-      if (image.alt) {
-        tags.push(og('image:alt', image.alt))
-      }
-    }
-  }
-
-  // Videos
-  if (openGraph.videos) {
-    for (const video of openGraph.videos) {
-      tags.push(og('video', urlToString(video.url)))
-      if (video.secureUrl) {
-        tags.push(og('video:secure_url', urlToString(video.secureUrl)))
-      }
-      if (video.type) {
-        tags.push(og('video:type', video.type))
-      }
-      if (video.width) {
-        tags.push(og('video:width', video.width))
-      }
-      if (video.height) {
-        tags.push(og('video:height', video.height))
-      }
-    }
-  }
-
-  // Audio
-  if (openGraph.audio) {
-    for (const audio of openGraph.audio) {
-      tags.push(og('audio', urlToString(audio.url)))
-      if (audio.secureUrl) {
-        tags.push(og('audio:secure_url', urlToString(audio.secureUrl)))
-      }
-      if (audio.type) {
-        tags.push(og('audio:type', audio.type))
-      }
-    }
-  }
-
-  // Article specific
-  if (openGraph.article) {
-    const article = openGraph.article
-    if (article.publishedTime) {
-      tags.push(og('article:published_time', article.publishedTime))
-    }
-    if (article.modifiedTime) {
-      tags.push(og('article:modified_time', article.modifiedTime))
-    }
-    if (article.expirationTime) {
-      tags.push(og('article:expiration_time', article.expirationTime))
-    }
-    if (article.section) {
-      tags.push(og('article:section', article.section))
-    }
-    if (article.authors) {
-      const authors = Array.isArray(article.authors) ? article.authors : [article.authors]
-      for (const author of authors) {
-        tags.push(og('article:author', author))
-      }
-    }
-    if (article.tags) {
-      for (const tag of article.tags) {
-        tags.push(og('article:tag', tag))
-      }
-    }
-  }
-
-  // Profile specific
-  if (openGraph.profile) {
-    const profile = openGraph.profile
-    if (profile.firstName) {
-      tags.push(og('profile:first_name', profile.firstName))
-    }
-    if (profile.lastName) {
-      tags.push(og('profile:last_name', profile.lastName))
-    }
-    if (profile.username) {
-      tags.push(og('profile:username', profile.username))
-    }
-    if (profile.gender) {
-      tags.push(og('profile:gender', profile.gender))
-    }
-  }
-
-  // Book specific
-  if (openGraph.book) {
-    const book = openGraph.book
-    if (book.isbn) {
-      tags.push(og('book:isbn', book.isbn))
-    }
-    if (book.releaseDate) {
-      tags.push(og('book:release_date', book.releaseDate))
-    }
-    if (book.authors) {
-      const authors = Array.isArray(book.authors) ? book.authors : [book.authors]
-      for (const author of authors) {
-        tags.push(og('book:author', author))
-      }
-    }
-    if (book.tags) {
-      for (const tag of book.tags) {
-        tags.push(og('book:tag', tag))
-      }
-    }
-  }
-
-  return tags.join('\n')
-}
+/**
+ * Mandu SEO - Open Graph Meta Tags Rendering
+ */
+
+import type { ResolvedMetadata, ResolvedOpenGraph } from '../types'
+import { urlToString } from '../resolve/url'
+
+/**
+ * HTML 이스케이프
+ */
+function escapeHtml(str: string): string {
+  return str
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#039;')
+}
+
+/**
+ * OG 메타 태그 생성 헬퍼
+ */
+function og(property: string, content: string | number): string {
+  return `<meta property="og:${property}" content="${escapeHtml(String(content))}" />`
+}
+
+/**
+ * Open Graph 메타 태그 렌더링
+ */
+export function renderOpenGraph(metadata: ResolvedMetadata): string {
+  const openGraph = metadata.openGraph
+  if (!openGraph) return ''
+
+  const tags: string[] = []
+
+  // Basic OG tags
+  if (openGraph.type) {
+    tags.push(og('type', openGraph.type))
+  }
+
+  // title - fallback to metadata.title
+  const title = openGraph.title || metadata.title?.absolute
+  if (title) {
+    tags.push(og('title', title))
+  }
+
+  // description - fallback to metadata.description
+  const description = openGraph.description || metadata.description
+  if (description) {
+    tags.push(og('description', description))
+  }
+
+  if (openGraph.url) {
+    tags.push(og('url', openGraph.url.href))
+  }
+
+  if (openGraph.siteName) {
+    tags.push(og('site_name', openGraph.siteName))
+  }
+
+  if (openGraph.locale) {
+    tags.push(og('locale', openGraph.locale))
+  }
+
+  if (openGraph.determiner) {
+    tags.push(og('determiner', openGraph.determiner))
+  }
+
+  // Images
+  if (openGraph.images) {
+    for (const image of openGraph.images) {
+      tags.push(og('image', urlToString(image.url)))
+      if (image.secureUrl) {
+        tags.push(og('image:secure_url', urlToString(image.secureUrl)))
+      }
+      if (image.type) {
+        tags.push(og('image:type', image.type))
+      }
+      if (image.width) {
+        tags.push(og('image:width', image.width))
+      }
+      if (image.height) {
+        tags.push(og('image:height', image.height))
+      }
+      if (image.alt) {
+        tags.push(og('image:alt', image.alt))
+      }
+    }
+  }
+
+  // Videos
+  if (openGraph.videos) {
+    for (const video of openGraph.videos) {
+      tags.push(og('video', urlToString(video.url)))
+      if (video.secureUrl) {
+        tags.push(og('video:secure_url', urlToString(video.secureUrl)))
+      }
+      if (video.type) {
+        tags.push(og('video:type', video.type))
+      }
+      if (video.width) {
+        tags.push(og('video:width', video.width))
+      }
+      if (video.height) {
+        tags.push(og('video:height', video.height))
+      }
+    }
+  }
+
+  // Audio
+  if (openGraph.audio) {
+    for (const audio of openGraph.audio) {
+      tags.push(og('audio', urlToString(audio.url)))
+      if (audio.secureUrl) {
+        tags.push(og('audio:secure_url', urlToString(audio.secureUrl)))
+      }
+      if (audio.type) {
+        tags.push(og('audio:type', audio.type))
+      }
+    }
+  }
+
+  // Article specific
+  if (openGraph.article) {
+    const article = openGraph.article
+    if (article.publishedTime) {
+      tags.push(og('article:published_time', article.publishedTime))
+    }
+    if (article.modifiedTime) {
+      tags.push(og('article:modified_time', article.modifiedTime))
+    }
+    if (article.expirationTime) {
+      tags.push(og('article:expiration_time', article.expirationTime))
+    }
+    if (article.section) {
+      tags.push(og('article:section', article.section))
+    }
+    if (article.authors) {
+      const authors = Array.isArray(article.authors) ? article.authors : [article.authors]
+      for (const author of authors) {
+        tags.push(og('article:author', author))
+      }
+    }
+    if (article.tags) {
+      for (const tag of article.tags) {
+        tags.push(og('article:tag', tag))
+      }
+    }
+  }
+
+  // Profile specific
+  if (openGraph.profile) {
+    const profile = openGraph.profile
+    if (profile.firstName) {
+      tags.push(og('profile:first_name', profile.firstName))
+    }
+    if (profile.lastName) {
+      tags.push(og('profile:last_name', profile.lastName))
+    }
+    if (profile.username) {
+      tags.push(og('profile:username', profile.username))
+    }
+    if (profile.gender) {
+      tags.push(og('profile:gender', profile.gender))
+    }
+  }
+
+  // Book specific
+  if (openGraph.book) {
+    const book = openGraph.book
+    if (book.isbn) {
+      tags.push(og('book:isbn', book.isbn))
+    }
+    if (book.releaseDate) {
+      tags.push(og('book:release_date', book.releaseDate))
+    }
+    if (book.authors) {
+      const authors = Array.isArray(book.authors) ? book.authors : [book.authors]
+      for (const author of authors) {
+        tags.push(og('book:author', author))
+      }
+    }
+    if (book.tags) {
+      for (const tag of book.tags) {
+        tags.push(og('book:tag', tag))
+      }
+    }
+  }
+
+  return tags.join('\n')
+}

package/src/seo/render/robots.ts

@@ -1,116 +1,116 @@
-/**
- * Mandu SEO - Robots.txt Rendering
- *
- * RobotsFile 객체를 텍스트 문자열로 변환
- */
-
-import type { RobotsFile, RobotsRule } from '../types'
-
-/**
- * 값을 배열로 정규화
- */
-function toArray<T>(value: T | T[] | undefined): T[] {
-  if (!value) return []
-  return Array.isArray(value) ? value : [value]
-}
-
-/**
- * 단일 규칙을 텍스트로 변환
- */
-function renderRule(rule: RobotsRule): string {
-  const lines: string[] = []
-
-  // User-agent
-  const userAgents = toArray(rule.userAgent)
-  if (userAgents.length === 0) {
-    userAgents.push('*')
-  }
-
-  for (const ua of userAgents) {
-    lines.push(`User-agent: ${ua}`)
-  }
-
-  // Allow
-  const allows = toArray(rule.allow)
-  for (const allow of allows) {
-    lines.push(`Allow: ${allow}`)
-  }
-
-  // Disallow
-  const disallows = toArray(rule.disallow)
-  for (const disallow of disallows) {
-    lines.push(`Disallow: ${disallow}`)
-  }
-
-  // Crawl-delay
-  if (rule.crawlDelay !== undefined) {
-    lines.push(`Crawl-delay: ${rule.crawlDelay}`)
-  }
-
-  return lines.join('\n')
-}
-
-/**
- * RobotsFile 객체를 robots.txt 문자열로 렌더링
- *
- * @param robots - Robots 설정 객체
- * @returns robots.txt 문자열
- *
- * @example
- * ```typescript
- * const txt = renderRobots({
- *   rules: [
- *     { userAgent: '*', allow: '/', disallow: '/admin' },
- *     { userAgent: 'Googlebot', allow: '/' },
- *   ],
- *   sitemap: 'https://example.com/sitemap.xml',
- * })
- * ```
- */
-export function renderRobots(robots: RobotsFile): string {
-  const sections: string[] = []
-
-  // 규칙들
-  const rules = toArray(robots.rules)
-  for (const rule of rules) {
-    sections.push(renderRule(rule))
-  }
-
-  // Host (Yandex 전용)
-  if (robots.host) {
-    sections.push(`Host: ${robots.host}`)
-  }
-
-  // Sitemap
-  const sitemaps = toArray(robots.sitemap)
-  for (const sitemap of sitemaps) {
-    sections.push(`Sitemap: ${sitemap}`)
-  }
-
-  return sections.join('\n\n')
-}
-
-/**
- * 기본 robots.txt 생성 (모든 크롤러 허용)
- */
-export function createDefaultRobots(sitemapUrl?: string): RobotsFile {
-  return {
-    rules: {
-      userAgent: '*',
-      allow: '/',
-    },
-    sitemap: sitemapUrl,
-  }
-}
-
-/**
- * 개발 환경용 robots.txt 생성 (모든 크롤러 차단)
- */
-export function createDevRobots(): RobotsFile {
-  return {
-    rules: {
-      userAgent: '*',
-      disallow: '/',
-    },
-  }
-}
+/**
+ * Mandu SEO - Robots.txt Rendering
+ *
+ * RobotsFile 객체를 텍스트 문자열로 변환
+ */
+
+import type { RobotsFile, RobotsRule } from '../types'
+
+/**
+ * 값을 배열로 정규화
+ */
+function toArray<T>(value: T | T[] | undefined): T[] {
+  if (!value) return []
+  return Array.isArray(value) ? value : [value]
+}
+
+/**
+ * 단일 규칙을 텍스트로 변환
+ */
+function renderRule(rule: RobotsRule): string {
+  const lines: string[] = []
+
+  // User-agent
+  const userAgents = toArray(rule.userAgent)
+  if (userAgents.length === 0) {
+    userAgents.push('*')
+  }
+
+  for (const ua of userAgents) {
+    lines.push(`User-agent: ${ua}`)
+  }
+
+  // Allow
+  const allows = toArray(rule.allow)
+  for (const allow of allows) {
+    lines.push(`Allow: ${allow}`)
+  }
+
+  // Disallow
+  const disallows = toArray(rule.disallow)
+  for (const disallow of disallows) {
+    lines.push(`Disallow: ${disallow}`)
+  }
+
+  // Crawl-delay
+  if (rule.crawlDelay !== undefined) {
+    lines.push(`Crawl-delay: ${rule.crawlDelay}`)
+  }
+
+  return lines.join('\n')
+}
+
+/**
+ * RobotsFile 객체를 robots.txt 문자열로 렌더링
+ *
+ * @param robots - Robots 설정 객체
+ * @returns robots.txt 문자열
+ *
+ * @example
+ * ```typescript
+ * const txt = renderRobots({
+ *   rules: [
+ *     { userAgent: '*', allow: '/', disallow: '/admin' },
+ *     { userAgent: 'Googlebot', allow: '/' },
+ *   ],
+ *   sitemap: 'https://example.com/sitemap.xml',
+ * })
+ * ```
+ */
+export function renderRobots(robots: RobotsFile): string {
+  const sections: string[] = []
+
+  // 규칙들
+  const rules = toArray(robots.rules)
+  for (const rule of rules) {
+    sections.push(renderRule(rule))
+  }
+
+  // Host (Yandex 전용)
+  if (robots.host) {
+    sections.push(`Host: ${robots.host}`)
+  }
+
+  // Sitemap
+  const sitemaps = toArray(robots.sitemap)
+  for (const sitemap of sitemaps) {
+    sections.push(`Sitemap: ${sitemap}`)
+  }
+
+  return sections.join('\n\n')
+}
+
+/**
+ * 기본 robots.txt 생성 (모든 크롤러 허용)
+ */
+export function createDefaultRobots(sitemapUrl?: string): RobotsFile {
+  return {
+    rules: {
+      userAgent: '*',
+      allow: '/',
+    },
+    sitemap: sitemapUrl,
+  }
+}
+
+/**
+ * 개발 환경용 robots.txt 생성 (모든 크롤러 차단)
+ */
+export function createDevRobots(): RobotsFile {
+  return {
+    rules: {
+      userAgent: '*',
+      disallow: '/',
+    },
+  }
+}