@rimelight/seo 0.0.1 → 0.0.3

package/src/sitemap.ts

@@ -1,166 +0,0 @@
-import type { LocaleConfig, SeoEntry, SitemapUrl } from "./types.js"
-
-/**
- * Build fully-resolved sitemap URLs from entries and locale config
- */
-export function buildSitemapUrls(entries: SeoEntry[], config: LocaleConfig): SitemapUrl[] {
-  const urls: SitemapUrl[] = []
-  const { site, locales, defaultLocale, prefixDefaultLocale, trailingSlash } = config
-
-  for (const entry of entries) {
-    const entryLocales =
-      entry.locales && entry.locales.length > 0 ? entry.locales : Object.keys(locales)
-
-    const entryUrls: SitemapUrl[] = []
-
-    for (const locale of entryLocales) {
-      const isDefault = locale === defaultLocale
-      const localePrefix = !isDefault || prefixDefaultLocale ? `/${locale}` : ""
-
-      let path = entry.path
-      if (trailingSlash === "always" && !path.endsWith("/")) {
-        path += "/"
-      } else if (trailingSlash === "never" && path.endsWith("/")) {
-        path = path.replace(/\/$/, "")
-      }
-
-      const loc = `${site}${localePrefix}${path}`
-
-      const item: SitemapUrl = { loc }
-      if (entry.lastmod) {
-        item.lastmod = entry.lastmod.toISOString()
-      }
-      if (entry.changefreq) {
-        item.changefreq = entry.changefreq
-      }
-      if (entry.priority !== undefined) {
-        item.priority = entry.priority
-      }
-      entryUrls.push(item)
-    }
-
-    // Add alternates if multiple locales
-    if (entryUrls.length > 1) {
-      const defaultUrl = entryUrls.find(
-        (u) => u.loc === `${site}${prefixDefaultLocale ? `/${defaultLocale}` : ""}${entry.path}`
-      )
-
-      for (const url of entryUrls) {
-        url.alternates = entryUrls
-          .filter((u) => u.loc !== url.loc)
-          .map((u) => ({
-            hreflang: extractHreflang(u.loc, locales, defaultLocale),
-            href: u.loc
-          }))
-
-        // Add x-default pointing to default locale
-        // x-default should be on the default URL itself, pointing to itself
-        if (defaultUrl && url.loc === defaultUrl.loc) {
-          url.alternates.push({
-            hreflang: "x-default",
-            href: defaultUrl.loc
-          })
-        }
-      }
-    }
-
-    urls.push(...entryUrls)
-  }
-
-  return urls
-}
-
-/**
- * Build sitemap XML from resolved URLs
- */
-export function buildSitemapXml(urls: SitemapUrl[]): string {
-  const urlElements = urls
-    .map((url) => {
-      let xml = `  <url>\n    <loc>${escapeXml(url.loc)}</loc>`
-
-      if (url.lastmod) {
-        xml += `\n    <lastmod>${url.lastmod}</lastmod>`
-      }
-
-      if (url.changefreq) {
-        xml += `\n    <changefreq>${url.changefreq}</changefreq>`
-      }
-
-      if (url.priority !== undefined) {
-        xml += `\n    <priority>${url.priority.toFixed(1)}</priority>`
-      }
-
-      if (url.alternates && url.alternates.length > 0) {
-        for (const alt of url.alternates) {
-          xml += `\n    <xhtml:link rel="alternate" hreflang="${alt.hreflang}" href="${escapeXml(alt.href)}" />`
-        }
-      }
-
-      xml += "\n  </url>"
-      return xml
-    })
-    .join("\n")
-
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">
-${urlElements}
-</urlset>`
-}
-
-/**
- * Build sitemap index XML from sitemap URLs
- */
-export function buildSitemapIndexXml(sitemapUrls: string[]): string {
-  const sitemapElements = sitemapUrls
-    .map(
-      (url) => `  <sitemap>
-    <loc>${escapeXml(url)}</loc>
-  </sitemap>`
-    )
-    .join("\n")
-
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-${sitemapElements}
-</sitemapindex>`
-}
-
-/**
- * Chunk sitemap URLs into multiple sitemaps (max 50k URLs per sitemap)
- */
-export function chunkSitemapUrls(urls: SitemapUrl[], limit: number = 45000): SitemapUrl[][] {
-  const chunks: SitemapUrl[][] = []
-  for (let i = 0; i < urls.length; i += limit) {
-    chunks.push(urls.slice(i, i + limit))
-  }
-  return chunks
-}
-
-/**
- * Extract hreflang from a URL based on locale config
- */
-function extractHreflang(
-  url: string,
-  locales: Record<string, string>,
-  defaultLocale: string
-): string {
-  for (const [segment, hreflang] of Object.entries(locales)) {
-    if (url.includes(`/${segment}/`) || url.endsWith(`/${segment}`)) {
-      return hreflang
-    }
-  }
-  // Default to the first locale's hreflang if no match
-  return locales[defaultLocale] || "en"
-}
-
-/**
- * Escape XML special characters
- */
-function escapeXml(str: string): string {
-  return str
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&apos;")
-}

package/src/types.ts

@@ -1,219 +0,0 @@
-/**
- * Change frequency for sitemap entries
- */
-export type ChangeFreq = "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never"
-
-/**
- * SEO entry — a single page to include in sitemaps
- */
-export interface SeoEntry {
-  /**
-   * Locale-less path, e.g. "/company/blog/hello". Leading slash required.
-   */
-  path: string
-  lastmod?: Date
-  changefreq?: ChangeFreq
-  priority?: number
-  /**
-   * Restrict to a subset of locales; defaults to all configured locales.
-   */
-  locales?: readonly string[]
-}
-
-/**
- * Locale configuration for SEO builders
- */
-export interface LocaleConfig {
-  /**
-   * Absolute origin, e.g. "https://rimelight.com"
-   */
-  site: string
-  /**
-   * Map of locale segment -> hreflang, e.g. { en: "en-US", pt: "pt-BR" }
-   */
-  locales: Record<string, string>
-  defaultLocale: string
-  /**
-   * Emit the default locale without a prefix. Default: false.
-   */
-  prefixDefaultLocale?: boolean
-  trailingSlash?: "always" | "never"
-}
-
-/**
- * Fully resolved sitemap URL with alternates
- */
-export interface SitemapUrl {
-  loc: string
-  lastmod?: string
-  changefreq?: ChangeFreq
-  priority?: number
-  alternates?: SitemapAlternate[]
-}
-
-/**
- * Language alternate for a sitemap URL
- */
-export interface SitemapAlternate {
-  hreflang: string
-  href: string
-}
-
-/**
- * Options for robots.txt generation
- */
-export interface RobotsOptions {
-  /**
-   * The sitemap URL to reference
-   */
-  sitemapUrl: string
-  /**
-   * Paths to disallow for all user agents
-   */
-  disallow?: string[]
-  /**
-   * Paths to allow for all user agents
-   */
-  allow?: string[]
-  /**
-   * User-agent specific rules
-   */
-  userAgentRules?: UserAgentRule[]
-}
-
-/**
- * User-agent specific robots.txt rule
- */
-export interface UserAgentRule {
-  userAgent: string
-  disallow?: string[]
-  allow?: string[]
-}
-
-/**
- * Site identity and SEO defaults shared across all Rimelight Astro sites. The UI-specific overrides
- * (component themes, shortcuts, etc.) live in UIConfig (packages/ui) and are passed directly to the
- * ui() integration.
- */
-export interface SiteConfig {
-  id: string
-  name: string
-  description: string
-  url: string
-  ogImage: string
-  author: string
-  email: string
-  branding: {
-    logo: {
-      alt: string
-    }
-    favicon: {
-      svg: string
-    }
-    colors: {
-      themeColor: string
-      backgroundColor: string
-    }
-  }
-  seo: {
-    titleTemplate: string
-    ogImageFallback: string
-    maxDescriptionLength: number
-    authorHandle?: string
-  }
-}
-
-/**
- * Open Graph image with alt text
- */
-export interface OGImage {
-  /**
-   * Image URL (relative or absolute)
-   */
-  src: string
-  /**
-   * Alt text for the image
-   */
-  alt: string
-}
-
-/**
- * RSS feed link configuration
- */
-export interface RSSFeed {
-  /**
-   * RSS feed URL
-   */
-  href: string
-  /**
-   * Feed title (defaults to "RSS")
-   */
-  title?: string
-}
-
-/**
- * Props for the RLAHead Astro component. Defined here so consumers can construct head props without
- * importing @rimelight/ui.
- */
-export interface HeadProps {
-  /**
-   * Page title
-   */
-  title?: string
-  /**
-   * Page description
-   */
-  description?: string
-  /**
-   * Open Graph image with alt text
-   */
-  ogImage?: OGImage
-  /**
-   * Open Graph type (e.g., "website", "article")
-   */
-  ogType?: string
-  /**
-   * Open Graph locale (defaults to "en_US")
-   */
-  ogLocale?: string
-  /**
-   * Whether to prevent indexing
-   */
-  noindex?: boolean
-  /**
-   * Whether this is a 404 page
-   */
-  is404?: boolean
-  /**
-   * Robots metadata (overrides noindex/is404 logic if provided)
-   */
-  robots?: string
-  /**
-   * Canonical URL
-   */
-  canonical?: string
-  /**
-   * Language alternates for i18n
-   */
-  languageAlternates?: Array<{ hreflang: string; href: string }>
-  /**
-   * Site configuration for defaults
-   */
-  config?: SiteConfig
-  /**
-   * Whether to enable View Transitions (ClientRouter)
-   */
-  transitions?: boolean
-  /**
-   * Meta charset
-   */
-  charset?: string
-  /**
-   * Meta viewport
-   */
-  viewport?: string
-  /**
-   * RSS feed configuration
-   */
-  rssFeed?: RSSFeed
-}