@rimelight/seo 0.0.4 → 0.0.5

package/src/meta.ts

@@ -12,19 +12,49 @@ export function buildCanonicalUrl(url: string | URL, base: string | URL): string
   return path.includes("?") ? path.replace(/\/?$/, "") : path.replace(/\/?$/, "/")
 }
 
+/**
+ * Deep merge two metadata or configuration objects.
+ */
+export function deepMerge<T extends Record<string, any>>(
+  base: T,
+  override?: Record<string, any>
+): T {
+  if (!override) return { ...base }
+  const result: Record<string, any> = { ...base }
+  for (const key of Object.keys(override)) {
+    const baseVal = base[key]
+    const overrideVal = override[key]
+    if (
+      baseVal &&
+      overrideVal &&
+      typeof baseVal === "object" &&
+      typeof overrideVal === "object" &&
+      !Array.isArray(baseVal) &&
+      !Array.isArray(overrideVal)
+    ) {
+      result[key] = deepMerge(baseVal, overrideVal)
+    } else if (overrideVal !== undefined) {
+      result[key] = overrideVal
+    }
+  }
+  return result as T
+}
+
 /**
  * Build a page title using a site's title template. Falls back to siteName for untitled pages; uses
- * a 404 label for error pages.
+ * a 404 label for error pages. Supports absolute title bypass.
  */
 export function buildPageTitle(opts: {
   title?: string
   siteName: string
   titleTemplate: string
   is404?: boolean
+  absolute?: boolean
 }): string {
-  const { title, siteName, titleTemplate, is404 } = opts
+  const { title, siteName, titleTemplate, is404, absolute } = opts
   if (is404) return `404 - Not Found | ${siteName}`
   if (!title) return siteName
+  if (absolute) return title
   return titleTemplate.replace("%s", title)
 }
 

package/src/routes/llms.txt.ts

@@ -0,0 +1,22 @@
+import type { APIRoute } from "astro"
+import { buildLlmsTxt } from "../llms.js"
+import seoConfig from "virtual:rimelight-seo-config"
+
+export const GET: APIRoute = ({ site }) => {
+  const llmsOpts = typeof seoConfig?.llms === "object" ? seoConfig.llms : {}
+  const siteStr = site ? site.toString().replace(/\/$/, "") : ""
+  const hostname = site ? new URL(site).hostname : "Site"
+  const content = buildLlmsTxt({
+    site: siteStr,
+    title: hostname,
+    pages: [],
+    ...llmsOpts
+  })
+
+  return new Response(content, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=3600, stale-while-revalidate=86400"
+    }
+  })
+}

package/src/routes/robots.txt.ts

@@ -0,0 +1,20 @@
+import type { APIRoute } from "astro"
+import { buildRobotsTxt } from "../robots.js"
+import seoConfig from "virtual:rimelight-seo-config"
+
+export const GET: APIRoute = ({ site }) => {
+  const sitemapURL = site ? new URL("sitemap.xml", site).toString() : ""
+  const robotsOpts = typeof seoConfig?.robots === "object" ? seoConfig.robots : {}
+  const robots = buildRobotsTxt({
+    sitemapUrl: sitemapURL,
+    allow: ["/"],
+    ...robotsOpts
+  })
+
+  return new Response(robots, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Cache-Control": "public, max-age=3600, stale-while-revalidate=86400"
+    }
+  })
+}

package/src/routes/sitemap.xml.ts

@@ -0,0 +1,16 @@
+import type { APIRoute } from "astro"
+import { buildSitemapXml } from "../sitemap.js"
+import seoConfig from "virtual:rimelight-seo-config"
+
+export const GET: APIRoute = () => {
+  const sitemapOpts = typeof seoConfig?.sitemap === "object" ? seoConfig.sitemap : {}
+  const urls = sitemapOpts.urls || []
+  const xml = buildSitemapXml(urls)
+
+  return new Response(xml, {
+    headers: {
+      "Content-Type": "application/xml; charset=utf-8",
+      "Cache-Control": "public, max-age=3600, stale-while-revalidate=86400"
+    }
+  })
+}

package/src/types.ts

@@ -90,6 +90,27 @@ export interface UserAgentRule {
   allow?: string[]
 }
 
+export interface OpenGraphMeta {
+  type?: string
+  locale?: string
+  url?: string
+  title?: string
+  description?: string
+  images?: OGImage[] | OGImage
+  siteName?: string
+  [key: string]: unknown
+}
+
+export interface TwitterMeta {
+  card?: "summary" | "summary_large_image" | "player" | "app"
+  site?: string
+  creator?: string
+  title?: string
+  description?: string
+  images?: OGImage[] | OGImage | string
+  [key: string]: unknown
+}
+
 /**
  * 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
@@ -121,6 +142,8 @@ export interface SiteConfig {
     maxDescriptionLength: number
     authorHandle?: string
   }
+  openGraph?: OpenGraphMeta
+  twitter?: TwitterMeta
 }
 
 /**
@@ -236,6 +259,22 @@ export interface HeadProps {
    * Version alternates for multi-version documentation
    */
   versionAlternates?: Array<{ version: string; href: string }>
+  /**
+   * Whether the title should bypass site title template
+   */
+  absolute?: boolean
+  /**
+   * Twitter card type
+   */
+  twitterCard?: "summary" | "summary_large_image" | "player" | "app"
+  /**
+   * Open Graph metadata overrides
+   */
+  openGraph?: OpenGraphMeta
+  /**
+   * Twitter metadata overrides
+   */
+  twitter?: TwitterMeta
 }
 
 export type { LlmsPage, LlmsTxtOptions, LlmsFullTxtOptions } from "./llms.js"

package/dist/types-e7gqYZwc.d.mts

@@ -1,305 +0,0 @@
-//#region src/schema.d.ts
-interface ArticleSchemaOptions {
-  type?: "TechArticle" | "Article" | "BlogPosting";
-  title: string;
-  description?: string;
-  url: string;
-  datePublished?: string | Date;
-  dateModified?: string | Date;
-  authorName?: string;
-  authorUrl?: string;
-  image?: string;
-  publisherName?: string;
-  publisherLogo?: string;
-}
-interface BreadcrumbItem {
-  name: string;
-  url: string;
-}
-/**
- * Builds Schema.org Article / TechArticle / BlogPosting JSON-LD.
- */
-declare function buildArticleSchema(options: ArticleSchemaOptions): Record<string, any>;
-/**
- * Builds Schema.org BreadcrumbList JSON-LD.
- */
-declare function buildBreadcrumbSchema(items: BreadcrumbItem[]): Record<string, any>;
-//#endregion
-//#region src/llms.d.ts
-interface LlmsPage {
-  title: string;
-  url: string;
-  description?: string;
-  markdownUrl?: string;
-  section?: string;
-}
-interface LlmsTxtOptions {
-  site: string;
-  title: string;
-  description?: string;
-  fullCorpusUrl?: string;
-  pages: LlmsPage[];
-  sections?: Array<{
-    label: string;
-    url: string;
-  }>;
-}
-interface LlmsFullTxtOptions {
-  site: string;
-  title: string;
-  description?: string;
-  pages: Array<{
-    title: string;
-    url: string;
-    description?: string;
-    markdown: string;
-    version?: string;
-  }>;
-}
-/**
- * Builds standard /llms.txt document format for AI discovery.
- */
-declare function buildLlmsTxt(options: LlmsTxtOptions): string;
-/**
- * Builds concatenated /llms-full.txt single corpus document for AI agents.
- */
-declare function buildLlmsFullTxt(options: LlmsFullTxtOptions): string;
-//#endregion
-//#region src/types.d.ts
-/**
- * Change frequency for sitemap entries
- */
-type ChangeFreq = "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
-/**
- * SEO entry — a single page to include in sitemaps
- */
-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
- */
-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
- */
-interface SitemapUrl {
-  loc: string;
-  lastmod?: string;
-  changefreq?: ChangeFreq;
-  priority?: number;
-  alternates?: SitemapAlternate[];
-}
-/**
- * Language alternate for a sitemap URL
- */
-interface SitemapAlternate {
-  hreflang: string;
-  href: string;
-}
-/**
- * Options for robots.txt generation
- */
-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
- */
-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.
- */
-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
- */
-interface OGImage {
-  /**
-   * Image URL (relative or absolute)
-   */
-  src: string;
-  /**
-   * Alt text for the image
-   */
-  alt: string;
-}
-/**
- * RSS feed link configuration
- */
-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.
- */
-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;
-  }>;
-  /**
-   * Custom favicon SVG or image path (overrides config.branding.favicon.svg)
-   */
-  favicon?: 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;
-  /**
-   * Article or BlogPosting JSON-LD configuration
-   */
-  articleSchema?: ArticleSchemaOptions;
-  /**
-   * Breadcrumb list for JSON-LD structured data
-   */
-  breadcrumbs?: BreadcrumbItem[];
-  /**
-   * URL for this page's raw Markdown alternate twin
-   */
-  markdownUrl?: string;
-  /**
-   * Version alternates for multi-version documentation
-   */
-  versionAlternates?: Array<{
-    version: string;
-    href: string;
-  }>;
-}
-//#endregion
-export { ArticleSchemaOptions as _, RSSFeed as a, buildBreadcrumbSchema as b, SiteConfig as c, UserAgentRule as d, LlmsFullTxtOptions as f, buildLlmsTxt as g, buildLlmsFullTxt as h, OGImage as i, SitemapAlternate as l, LlmsTxtOptions as m, HeadProps as n, RobotsOptions as o, LlmsPage as p, LocaleConfig as r, SeoEntry as s, ChangeFreq as t, SitemapUrl as u, BreadcrumbItem as v, buildArticleSchema as y };