@rimelight/ui 0.0.2 → 0.0.4

package/src/domain/i18n/schema.ts

@@ -1,29 +1,29 @@
-import { z } from "astro/zod"
-
-import { SUPPORTED_LOCALES } from "./constants"
-import { NAMESPACE_KEYS } from "./runtime-constants"
-
-// Auto-generated namespaces and real supported locales that have translations
-export * from "./runtime-constants"
-
-// Locale schema from shared constant
-export const LocaleSchema = z.enum(SUPPORTED_LOCALES)
-
-// Runtime safety: if namespaces are empty (fresh clone), fall back to string
-const hasNamespaces = (NAMESPACE_KEYS as readonly string[]).length > 0
-
-export const NamespaceSchema = hasNamespaces ? z.enum(NAMESPACE_KEYS) : z.string()
-
-export type Locale = z.infer<typeof LocaleSchema>
-
-type GlobalSchema = I18n.Schema
-
-// Strictly bind the type to the keys of I18n.Schema.
-// If the interface is empty (e.g., on a fresh project clone), fall back to string.
-export type Namespace = keyof GlobalSchema extends never ? string : keyof GlobalSchema
-
-// Added intersection N & keyof GlobalSchema so the compiler
-// doesn't throw an error inside Pick when Namespace falls back to string.
-export type PickSchema<N extends Namespace> = [N] extends [keyof GlobalSchema]
-  ? Pick<GlobalSchema, N & keyof GlobalSchema>
-  : any
+import { z } from "astro/zod"
+
+import { SUPPORTED_LOCALES } from "./constants"
+import { NAMESPACE_KEYS } from "./runtime-constants"
+
+// Auto-generated namespaces and real supported locales that have translations
+export * from "./runtime-constants"
+
+// Locale schema from shared constant
+export const LocaleSchema = z.enum(SUPPORTED_LOCALES)
+
+// Runtime safety: if namespaces are empty (fresh clone), fall back to string
+const hasNamespaces = (NAMESPACE_KEYS as readonly string[]).length > 0
+
+export const NamespaceSchema = hasNamespaces ? z.enum(NAMESPACE_KEYS) : z.string()
+
+export type Locale = z.infer<typeof LocaleSchema>
+
+type GlobalSchema = I18n.Schema
+
+// Strictly bind the type to the keys of I18n.Schema.
+// If the interface is empty (e.g., on a fresh project clone), fall back to string.
+export type Namespace = keyof GlobalSchema extends never ? string : keyof GlobalSchema
+
+// Added intersection N & keyof GlobalSchema so the compiler
+// doesn't throw an error inside Pick when Namespace falls back to string.
+export type PickSchema<N extends Namespace> = [N] extends [keyof GlobalSchema]
+  ? Pick<GlobalSchema, N & keyof GlobalSchema>
+  : any

package/src/domain/index.ts

@@ -1,4 +1,4 @@
-export * from "./i18n"
-export * from "./seo"
-export * from "./theme"
-export * from "./cms"
+export * from "./i18n"
+export * from "./seo"
+export * from "./theme"
+export * from "./cms"

package/src/domain/seo/constants.ts

@@ -1,20 +1,6 @@
-// Specify the path here without the @ alias, since we use this file in astro.config.ts
-import { SITE_CONFIG, LINKS } from "../../config"
-
-export const SEO_DEFAULTS = {
-  siteName: SITE_CONFIG.name,
-
-  baseUrl: SITE_CONFIG.url,
-
-  // Dynamically inserting a name into a template
-  titleTemplate: `%s | ${SITE_CONFIG.name}`,
-
-  // Other SEO-specific things
-  ogImageFallback: `/src/assets/houston.webp`,
-  defaultDescription: "Production-ready foundations for SaaS and Telegram Mini Apps",
-  maxDescriptionLength: 160,
-  author: {
-    name: "Gary Stupak",
-    url: LINKS.twitter
-  }
-} as const
+export const SEO_DEFAULTS = {
+  // Generic SEO defaults
+  ogImageFallback: `/src/assets/houston.webp`,
+  defaultDescription: "Production-ready foundations for SaaS and Telegram Mini Apps",
+  maxDescriptionLength: 160
+} as const

package/src/domain/seo/index.ts

@@ -1,3 +1,3 @@
-export * from "./services"
-export * from "./constants"
-export * from "./utils"
+export * from "./services"
+export * from "./constants"
+export * from "./utils"

package/src/domain/seo/services/index.ts

@@ -1,3 +1,3 @@
-export * from "./llms"
-export * from "./robots"
-export * from "./sitemap"
+export * from "./llms"
+export * from "./robots"
+export * from "./sitemap"

package/src/domain/seo/services/llms.ts

@@ -1,53 +1,56 @@
-import { SITE_CONFIG } from "../../../config"
-import { DEFAULT_LOCALE } from "../../i18n/constants"
-import { SEO_DEFAULTS } from "../constants"
-import { type BaseCMSContentEntry } from "../../cms"
-
-// Helper for the core project details
-function buildProjectDetails(): string {
-  let content = `## Project Details\n`
-  content += `- Name: ${SITE_CONFIG.name}\n`
-  content += `- Description: ${SEO_DEFAULTS.defaultDescription}\n`
-  return content
-}
-
-// Helper for the blog (now purely synchronous as getCollection moved to caller)
-function buildBlogSection(baseUrl: string, posts: BaseCMSContentEntry[]): string {
-  const basePosts = posts.filter((post: BaseCMSContentEntry) =>
-    post.id.startsWith(`${DEFAULT_LOCALE}/`)
-  )
-
-  const recentPosts = basePosts
-    .toSorted(
-      (a: BaseCMSContentEntry, b: BaseCMSContentEntry) =>
-        (b.data.publishedDate?.valueOf() ?? 0) - (a.data.publishedDate?.valueOf() ?? 0)
-    )
-    .slice(0, 5)
-
-  let content = `## Recent Blog Posts\n`
-  for (const post of recentPosts) {
-    const [lang, ...idParts] = post.id.split("/")
-    const cleanId = idParts.join("/")
-    const postUrl = `${baseUrl}/${lang}/blog/${cleanId}/`
-
-    content += `- [${post.data.title ?? "Untitled Post"}](${postUrl})\n`
-    content += `  ${post.data.description ?? "No description provided."}\n`
-  }
-  return content + "\n"
-}
-
-// Main orchestrator function
-export function generateLlmsText(baseUrl: string, blogPosts: BaseCMSContentEntry[]): string {
-  let content = `# ${SITE_CONFIG.name}\n\n`
-  content += `> ${SEO_DEFAULTS.defaultDescription}\n\n`
-
-  // Compose the final document block by block
-  content += buildProjectDetails()
-  content += buildBlogSection(baseUrl, blogPosts)
-
-  content += `## Note to AI Agents\n`
-  content += `This is the official documentation and context file for the ${SITE_CONFIG.name} project. `
-  content += `Please use the provided links and blog posts to gather specific technical details about our Astro and Cloudflare Workers architecture.\n`
-
-  return content
-}
+import { type SiteConfig } from "../../../config"
+import { DEFAULT_LOCALE } from "../../i18n/constants"
+import { type BaseCMSContentEntry } from "../../cms"
+
+// Helper for the core project details
+function buildProjectDetails(config: SiteConfig): string {
+  let content = `## Project Details\n`
+  content += `- Name: ${config.name}\n`
+  content += `- Description: ${config.description}\n`
+  return content
+}
+
+// Helper for the blog (now purely synchronous as getCollection moved to caller)
+function buildBlogSection(baseUrl: string, posts: BaseCMSContentEntry[]): string {
+  const basePosts = posts.filter((post: BaseCMSContentEntry) =>
+    post.id.startsWith(`${DEFAULT_LOCALE}/`)
+  )
+
+  const recentPosts = basePosts
+    .toSorted(
+      (a: BaseCMSContentEntry, b: BaseCMSContentEntry) =>
+        (b.data.publishedDate?.valueOf() ?? 0) - (a.data.publishedDate?.valueOf() ?? 0)
+    )
+    .slice(0, 5)
+
+  let content = `## Recent Blog Posts\n`
+  for (const post of recentPosts) {
+    const [lang, ...idParts] = post.id.split("/")
+    const cleanId = idParts.join("/")
+    const postUrl = `${baseUrl}/${lang}/blog/${cleanId}/`
+
+    content += `- [${post.data.title ?? "Untitled Post"}](${postUrl})\n`
+    content += `  ${post.data.description ?? "No description provided."}\n`
+  }
+  return content + "\n"
+}
+
+// Main orchestrator function
+export function generateLlmsText(
+  baseUrl: string,
+  blogPosts: BaseCMSContentEntry[],
+  config: SiteConfig
+): string {
+  let content = `# ${config.name}\n\n`
+  content += `> ${config.description}\n\n`
+
+  // Compose the final document block by block
+  content += buildProjectDetails(config)
+  content += buildBlogSection(baseUrl, blogPosts)
+
+  content += `## Note to AI Agents\n`
+  content += `This is the official documentation and context file for the ${config.name} project. `
+  content += `Please use the provided links and blog posts to gather specific technical details about our Astro and Cloudflare Workers architecture.\n`
+
+  return content
+}

package/src/domain/seo/services/robots.ts

@@ -1,12 +1,12 @@
-export function generateRobotsTxt(baseUrl: string, isProd: boolean, isDemoMode: boolean): string {
-  // 1. Prevent indexing on staging, dev, or preview deployments
-  if (!isProd || isDemoMode) {
-    return `User-agent: *\nDisallow: /`
-  }
-
-  // 2. Allow everything in production and point to the sitemap
-  return `User-agent: *
-Allow: /
-
-Sitemap: ${baseUrl}/sitemap.xml`
-}
+export function generateRobotsTxt(baseUrl: string, isProd: boolean, isDemoMode: boolean): string {
+  // 1. Prevent indexing on staging, dev, or preview deployments
+  if (!isProd || isDemoMode) {
+    return `User-agent: *\nDisallow: /`
+  }
+
+  // 2. Allow everything in production and point to the sitemap
+  return `User-agent: *
+Allow: /
+
+Sitemap: ${baseUrl}/sitemap.xml`
+}

package/src/domain/seo/services/sitemap.ts

@@ -1,56 +1,56 @@
-import { SUPPORTED_LOCALES } from "../../i18n/constants"
-import { type BaseCMSContentEntry } from "../../cms"
-
-// 1. Strong typing for sitemap elements
-export interface SitemapEntry {
-  loc: string
-  lastmod?: string
-  changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never"
-  priority?: number
-}
-
-export function generateSitemapXml(siteUrl: string, posts: BaseCMSContentEntry[]): string {
-  const staticRoutes = ["", "/blog"]
-  const entries: SitemapEntry[] = []
-
-  // 2. Building static routes for all locales.
-  for (const locale of SUPPORTED_LOCALES) {
-    for (const route of staticRoutes) {
-      entries.push({
-        loc: `${siteUrl}/${locale}${route}`,
-        changefreq: "daily",
-        priority: route === "" ? 1.0 : 0.8
-      })
-    }
-  }
-
-  // 3. Building dynamic blog routes
-  for (const post of posts) {
-    const [lang, ...idParts] = post.id.split("/")
-    const cleanSlug = idParts.join("/")
-
-    entries.push({
-      loc: `${siteUrl}/${lang}/blog/${cleanSlug}/`,
-      changefreq: "weekly",
-      priority: 0.7
-    })
-  }
-
-  // 4. Generating the final XML
-  const urlsXml = entries
-    .map(
-      (entry) => `
-  <url>
-    <loc>${entry.loc}</loc>
-    ${entry.lastmod ? `<lastmod>${entry.lastmod}</lastmod>` : ""}
-    ${entry.changefreq ? `<changefreq>${entry.changefreq}</changefreq>` : ""}
-    ${entry.priority ? `<priority>${entry.priority.toFixed(1)}</priority>` : ""}
-  </url>`
-    )
-    .join("")
-
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-${urlsXml}
-</urlset>`
-}
+import { SUPPORTED_LOCALES } from "../../i18n/constants"
+import { type BaseCMSContentEntry } from "../../cms"
+
+// 1. Strong typing for sitemap elements
+export interface SitemapEntry {
+  loc: string
+  lastmod?: string
+  changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never"
+  priority?: number
+}
+
+export function generateSitemapXml(siteUrl: string, posts: BaseCMSContentEntry[]): string {
+  const staticRoutes = ["", "/blog"]
+  const entries: SitemapEntry[] = []
+
+  // 2. Building static routes for all locales.
+  for (const locale of SUPPORTED_LOCALES) {
+    for (const route of staticRoutes) {
+      entries.push({
+        loc: `${siteUrl}/${locale}${route}`,
+        changefreq: "daily",
+        priority: route === "" ? 1.0 : 0.8
+      })
+    }
+  }
+
+  // 3. Building dynamic blog routes
+  for (const post of posts) {
+    const [lang, ...idParts] = post.id.split("/")
+    const cleanSlug = idParts.join("/")
+
+    entries.push({
+      loc: `${siteUrl}/${lang}/blog/${cleanSlug}/`,
+      changefreq: "weekly",
+      priority: 0.7
+    })
+  }
+
+  // 4. Generating the final XML
+  const urlsXml = entries
+    .map(
+      (entry) => `
+  <url>
+    <loc>${entry.loc}</loc>
+    ${entry.lastmod ? `<lastmod>${entry.lastmod}</lastmod>` : ""}
+    ${entry.changefreq ? `<changefreq>${entry.changefreq}</changefreq>` : ""}
+    ${entry.priority ? `<priority>${entry.priority.toFixed(1)}</priority>` : ""}
+  </url>`
+    )
+    .join("")
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urlsXml}
+</urlset>`
+}

package/src/domain/seo/utils.ts

@@ -1,37 +1,36 @@
-import { SEO_DEFAULTS } from "./constants"
-import { replaceLocaleInPath } from "../i18n/format"
-
-/**
- * Generates absolute URLs for hreflang tags
- */
-export function buildAlternateUrl(
-  currentOrigin: string,
-  currentPath: string,
-  currentLang: string,
-  targetLang: string
-): string {
-  // Change the locale in the path (for example, /en/blog -> /es/blog)
-  const newPath = replaceLocaleInPath(currentPath, currentLang, targetLang)
-
-  // Collect the absolute URL using current origin
-  const url = new URL(newPath, currentOrigin)
-  let href = url.toString()
-
-  // Astro is strict about trailing slashes, so let's play it safe.
-  if (!href.endsWith("/")) {
-    href += "/"
-  }
-
-  return href
-}
-
-export function truncateDescription(text: string): string {
-  if (text.length <= SEO_DEFAULTS.maxDescriptionLength) return text
-  return text.substring(0, SEO_DEFAULTS.maxDescriptionLength - 3) + "..."
-}
-
-export function buildCanonicalUrl(path: string, siteOrigin: string): string {
-  // Removing trailing slashes or query parameters for a clean canonical url
-  const cleanPath = path.split("?")[0]?.replace(/\/$/, "")
-  return `${siteOrigin}${cleanPath}`
-}
+import { replaceLocaleInPath } from "../i18n/format"
+
+/**
+ * Generates absolute URLs for hreflang tags
+ */
+export function buildAlternateUrl(
+  currentOrigin: string,
+  currentPath: string,
+  currentLang: string,
+  targetLang: string
+): string {
+  // Change the locale in the path (for example, /en/blog -> /es/blog)
+  const newPath = replaceLocaleInPath(currentPath, currentLang, targetLang)
+
+  // Collect the absolute URL using current origin
+  const url = new URL(newPath, currentOrigin)
+  let href = url.toString()
+
+  // Astro is strict about trailing slashes, so let's play it safe.
+  if (!href.endsWith("/")) {
+    href += "/"
+  }
+
+  return href
+}
+
+export function truncateDescription(text: string, maxLength: number = 160): string {
+  if (text.length <= maxLength) return text
+  return text.substring(0, maxLength - 3) + "..."
+}
+
+export function buildCanonicalUrl(path: string, siteOrigin: string): string {
+  // Removing trailing slashes or query parameters for a clean canonical url
+  const cleanPath = path.split("?")[0]?.replace(/\/$/, "")
+  return `${siteOrigin}${cleanPath}`
+}

package/src/domain/theme/constants.ts

@@ -1,6 +1,6 @@
-// Themes configuration
-export const THEMES = ["light", "dark"] as const
-export type SupportedThemes = (typeof THEMES)[number]
-
-// Default theme
-export const DEFAULT_THEME: SupportedThemes = "light"
+// Themes configuration
+export const THEMES = ["light", "dark"] as const
+export type SupportedThemes = (typeof THEMES)[number]
+
+// Default theme
+export const DEFAULT_THEME: SupportedThemes = "light"

package/src/domain/theme/index.ts

@@ -1,2 +1,2 @@
-export * from "./schema"
-export * from "./constants"
+export * from "./schema"
+export * from "./constants"

package/src/domain/theme/schema.ts

@@ -1,10 +1,10 @@
-import { z } from "astro/zod"
-
-// Constants
-import { THEMES } from "./constants"
-
-// Zod Schemas
-export const ThemeSchema = z.enum(THEMES)
-
-// Inference Types
-export type Theme = z.infer<typeof ThemeSchema>
+import { z } from "astro/zod"
+
+// Constants
+import { THEMES } from "./constants"
+
+// Zod Schemas
+export const ThemeSchema = z.enum(THEMES)
+
+// Inference Types
+export type Theme = z.infer<typeof ThemeSchema>

package/src/env.d.ts

@@ -1,49 +1,49 @@
-/// <reference types="astro/client" />
-
-interface ImportMetaEnv {
-  readonly PROD: boolean
-  readonly DEV: boolean
-  // add other env vars here...
-}
-
-interface ImportMeta {
-  readonly env: ImportMetaEnv
-}
-
-import type { Locale } from "./domain/i18n/schema"
-
-declare global {
-  namespace App {
-    interface Locals {
-      uiLocale: Locale
-      translationLocale: Locale
-      cfContext: any
-      isMissingContent?: boolean
-    }
-  }
-
-  declare module "astro:content" {
-    export interface CollectionEntry<T extends string = any> {
-      id: string
-      data: any
-      slug: string
-      body: string
-      collection: T
-    }
-    export const getCollection: (
-      collection: string,
-      filter?: (entry: CollectionEntry) => boolean
-    ) => Promise<CollectionEntry[]>
-    export const getEntry: (collection: string, id: string) => Promise<CollectionEntry>
-  }
-
-  declare module "cloudflare:workers" {
-    export const env: Env
-  }
-
-  declare module "~icons/*" {
-    import type { AstroComponentFactory } from "astro/runtime/server/index.js"
-    const component: AstroComponentFactory
-    export default component
-  }
-}
+/// <reference types="astro/client" />
+
+interface ImportMetaEnv {
+  readonly PROD: boolean
+  readonly DEV: boolean
+  // add other env vars here...
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}
+
+import type { Locale } from "./domain/i18n/schema"
+
+declare global {
+  namespace App {
+    interface Locals {
+      uiLocale: Locale
+      translationLocale: Locale
+      cfContext: any
+      isMissingContent?: boolean
+    }
+  }
+
+  declare module "astro:content" {
+    export interface CollectionEntry<T extends string = any> {
+      id: string
+      data: any
+      slug: string
+      body: string
+      collection: T
+    }
+    export const getCollection: (
+      collection: string,
+      filter?: (entry: CollectionEntry) => boolean
+    ) => Promise<CollectionEntry[]>
+    export const getEntry: (collection: string, id: string) => Promise<CollectionEntry>
+  }
+
+  declare module "cloudflare:workers" {
+    export const env: Env
+  }
+
+  declare module "~icons/*" {
+    import type { AstroComponentFactory } from "astro/runtime/server/index.js"
+    const component: AstroComponentFactory
+    export default component
+  }
+}

package/src/integrations/index.ts

@@ -0,0 +1 @@
+export * from "./sri"