@rimelight/config 0.0.5 → 0.0.7

package/README.md

@@ -42,7 +42,10 @@ For Astro projects using SolidJS components:
 
 ## Vite+ Configs
 
+### App / Standard Config
+
 ```typescript
+import { defineConfig } from "vite-plus"
 import { rimelightConfig } from "@rimelight/config/vite-plus/base"
 
 export default defineConfig({
@@ -51,6 +54,76 @@ export default defineConfig({
 })
 ```
 
+### Package Config (with Auto-Entry Discovery)
+
+For library / workspace packages:
+
+```typescript
+import { defineConfig } from "vite-plus"
+import { rimelightPackConfig } from "@rimelight/config/vite-plus/base"
+
+export default defineConfig(
+  rimelightPackConfig({
+    // Automatically discovers all entry modules in src/ (ignoring tests and .d.ts)
+    autoEntry: true
+  })
+)
+```
+
+## Astro Configs
+
+### Full Standard Rimelight Site Config
+
+Zero-boilerplate setup with preconfigured Cloudflare adapter, Cloudflare cache, SWR route rules, Fontsource fonts (Noto Sans, Noto Serif, JetBrains Mono), responsive image defaults, and declarative package flags:
+
+```typescript
+import { defineConfig } from "astro/config"
+import { rimelightAstroConfig } from "@rimelight/config/astro"
+import en from "./src/translations/en.json"
+import pt from "./src/translations/pt.json"
+
+export default defineConfig(
+  rimelightAstroConfig({
+    // Automatically derives site: "https://example.com"
+    // and image.domains: ["example.com", "cdn.example.com", "cdn.rimelight.com"]
+    domain: "example.com",
+
+    // Declarative package flags (dynamically imported, tree-shakeable)
+    solid: true,
+    cms: true,
+    security: true,
+    i18n: {
+      translations: { en, pt }
+    },
+    ui: {
+      logos: { ... }
+    }
+  })
+)
+```
+
+### Granular / Composable Presets
+
+If you prefer to compose configuration piecemeal:
+
+```typescript
+import { defineConfig } from "astro/config"
+import {
+  cloudflarePreset,
+  cacheRulesPreset,
+  fontsPreset,
+  imagePreset
+} from "@rimelight/config/astro"
+
+export default defineConfig({
+  site: "https://example.com",
+  ...cloudflarePreset(),
+  ...cacheRulesPreset(),
+  ...fontsPreset(),
+  ...imagePreset({ domains: ["example.com"] })
+})
+```
+
 ## Config Details
 
 ### TypeScript Base Config

package/astro/index.js

@@ -0,0 +1,329 @@
+import fs from "node:fs"
+import path from "node:path"
+import cloudflare from "@astrojs/cloudflare"
+import { cacheCloudflare } from "@astrojs/cloudflare/cache"
+import { fontProviders } from "astro/config"
+
+export function cacheRulesPreset(options = {}) {
+  const { apiSwrSeconds = 600, pageMaxAgeSeconds = 300, customRules = {} } = options
+  return {
+    routeRules: {
+      "/api/[...path]": {
+        swr: apiSwrSeconds
+      },
+      "/[...path]": {
+        maxAge: pageMaxAgeSeconds
+      },
+      ...customRules
+    }
+  }
+}
+
+export function fontsPreset(options = {}) {
+  const defaultFonts = [
+    {
+      name: "Noto Sans",
+      cssVariable: "--font-sans",
+      fallbacks: ["sans-serif"],
+      subsets: ["latin", "latin-ext"],
+      weights: [400, 500, 600, 700],
+      styles: ["normal"]
+    },
+    {
+      name: "Noto Serif",
+      cssVariable: "--font-serif",
+      fallbacks: ["serif"],
+      subsets: ["latin", "latin-ext"],
+      weights: [400, 700],
+      styles: ["normal"]
+    },
+    {
+      name: "JetBrains Mono",
+      cssVariable: "--font-mono",
+      fallbacks: ["monospace"],
+      subsets: ["latin", "latin-ext"],
+      weights: [400, 500, 700],
+      styles: ["normal"]
+    }
+  ]
+
+  const provider = (options.fontProviders || fontProviders)?.fontsource
+    ? (options.fontProviders || fontProviders).fontsource()
+    : undefined
+
+  return {
+    fonts: (options.fonts || defaultFonts).map((font) => ({
+      ...(provider ? { provider } : {}),
+      ...font
+    }))
+  }
+}
+
+export function imagePreset(options = {}) {
+  const { domains = [], layout = "constrained", responsiveStyles = true } = options
+  return {
+    image: {
+      domains,
+      layout,
+      responsiveStyles
+    }
+  }
+}
+
+export function cloudflarePreset(options = {}) {
+  const { adapter = cloudflare(), cacheProvider = cacheCloudflare(), session = false } = options
+  return {
+    output: "server",
+    session,
+    adapter,
+    cache: { provider: cacheProvider }
+  }
+}
+
+function discoverTranslations(dir = "./src/translations") {
+  const translations = {}
+  try {
+    const resolvedDir = path.resolve(process.cwd(), dir)
+    if (fs.existsSync(resolvedDir)) {
+      const files = fs.readdirSync(resolvedDir)
+      for (const file of files) {
+        if (file.endsWith(".json")) {
+          const locale = path.basename(file, ".json")
+          const content = JSON.parse(fs.readFileSync(path.join(resolvedDir, file), "utf8"))
+          translations[locale] = content
+        }
+      }
+    }
+  } catch {}
+  return translations
+}
+
+function discoverLogos(dir = "./src/assets/logos") {
+  try {
+    const candidateDirs = [dir, "./src/assets/logo"]
+    let resolvedDir = null
+    for (const d of candidateDirs) {
+      const p = path.resolve(process.cwd(), d)
+      if (fs.existsSync(p) && fs.statSync(p).isDirectory()) {
+        resolvedDir = p
+        break
+      }
+    }
+    if (!resolvedDir) return undefined
+
+    const files = fs.readdirSync(resolvedDir)
+    const logos = {}
+
+    const variants = ["logomark", "logotype", "logo"]
+    const modes = ["color", "white", "black", "light", "dark"]
+    const extensions = [".svg", ".png", ".webp", ".jpg", ".jpeg", ".gif"]
+
+    for (const variant of variants) {
+      for (const mode of modes) {
+        for (const ext of extensions) {
+          const fileName = `${variant}_${mode}${ext}`
+          if (files.includes(fileName)) {
+            if (!logos[variant]) logos[variant] = {}
+            const relPath = `./${path.relative(process.cwd(), path.join(resolvedDir, fileName)).replace(/\\/g, "/")}`
+            logos[variant][mode] = relPath
+          }
+        }
+      }
+      for (const ext of extensions) {
+        const fileName = `${variant}${ext}`
+        if (files.includes(fileName) && !logos[variant]) {
+          const relPath = `./${path.relative(process.cwd(), path.join(resolvedDir, fileName)).replace(/\\/g, "/")}`
+          logos[variant] = relPath
+        }
+      }
+    }
+
+    return Object.keys(logos).length > 0 ? logos : undefined
+  } catch {
+    return undefined
+  }
+}
+
+function defaultShortcuts() {
+  return {
+    categories: {
+      system: { label: "System" },
+      navigation: { label: "Navigation" }
+    }
+  }
+}
+
+function rimelightIntegration(options, imageDomains, domain) {
+  return {
+    name: "rimelight-auto-plugins",
+    hooks: {
+      "astro:config:setup": async ({ updateConfig }) => {
+        const integrations = []
+        const plugins = []
+
+        if (options.solid) {
+          const solidMod = await import("@astrojs/solid-js")
+          const solidFn = solidMod.default || solidMod
+          const solidOpts =
+            typeof options.solid === "object"
+              ? options.solid
+              : { include: ["**/solid/**", "**/*.tsx"] }
+          integrations.push(solidFn(solidOpts))
+        }
+
+        if (options.seo) {
+          const seoMod = await import("@rimelight/seo")
+          const { rimelightSeo } = seoMod
+          const seoOpts = typeof options.seo === "object" ? options.seo : {}
+          integrations.push(rimelightSeo(seoOpts))
+        }
+
+        if (options.cms) {
+          const cmsMod = await import("@rimelight/cms/integration")
+          const { rimelightCms } = cmsMod
+          const cmsOpts = typeof options.cms === "object" ? options.cms : {}
+          let storage = cmsOpts.storage
+          if (!storage) {
+            const storageMod = await import("@rimelight/cms/storage")
+            const { r2 } = storageMod
+            storage = r2({ binding: cmsOpts.binding || "BLOB" })
+          }
+          integrations.push(
+            rimelightCms({
+              storage,
+              auth: cmsOpts.auth || "./src/auth/auth.ts",
+              ...cmsOpts
+            })
+          )
+        }
+
+        if (options.security) {
+          const secMod = await import("@rimelight/security")
+          const { security: securityFn } = secMod
+          const secOpts = typeof options.security === "object" ? options.security : {}
+          const defaultImgSrc = imageDomains.map((d) =>
+            d.startsWith("http://") || d.startsWith("https://") ? d : `https://${d}`
+          )
+          const imgSrc = secOpts.imgSrc
+            ? Array.from(new Set([...defaultImgSrc, ...secOpts.imgSrc]))
+            : defaultImgSrc
+
+          plugins.push(
+            securityFn({
+              domain: secOpts.domain || domain,
+              imgSrc,
+              ...secOpts
+            })
+          )
+        }
+
+        if (options.i18n) {
+          const i18nMod = await import("@rimelight/i18n")
+          const { i18n: i18nFn } = i18nMod
+          const i18nOpts = typeof options.i18n === "object" ? options.i18n : {}
+          const translations = i18nOpts.translations || discoverTranslations()
+          const locales = i18nOpts.locales || Object.keys(translations)
+          const defaultLocale = i18nOpts.defaultLocale || (locales.length > 0 ? locales[0] : "en")
+          const kvBinding =
+            i18nOpts.kvBinding ||
+            (domain ? `${domain.replaceAll(".", "-")}_translations` : undefined)
+
+          plugins.push(
+            i18nFn({
+              locales,
+              defaultLocale,
+              prefixDefaultLocale: i18nOpts.prefixDefaultLocale ?? true,
+              translations,
+              ...(kvBinding ? { kvBinding } : {}),
+              ...i18nOpts
+            })
+          )
+        }
+
+        if (options.ui) {
+          const uiMod = await import("@rimelight/ui")
+          const { ui: uiFn } = uiMod
+          const uiOpts = typeof options.ui === "object" ? options.ui : {}
+          const discoveredLogos = discoverLogos()
+
+          const mergedLogos = uiOpts.logos
+            ? { ...discoveredLogos, ...uiOpts.logos }
+            : discoveredLogos
+
+          const mergedShortcuts =
+            uiOpts.shortcuts === false
+              ? undefined
+              : {
+                  ...defaultShortcuts(),
+                  ...(typeof uiOpts.shortcuts === "object" ? uiOpts.shortcuts : {})
+                }
+
+          plugins.push(
+            uiFn({
+              ...(mergedLogos ? { logos: mergedLogos } : {}),
+              ...(mergedShortcuts ? { shortcuts: mergedShortcuts } : {}),
+              ...uiOpts
+            })
+          )
+        }
+
+        updateConfig({
+          integrations,
+          vite: {
+            plugins
+          }
+        })
+      }
+    }
+  }
+}
+
+export function rimelightAstroConfig(options = {}) {
+  const {
+    domain,
+    site = domain ? `https://${domain}` : undefined,
+    imageDomains = domain ? [domain, `cdn.${domain}`, "cdn.rimelight.com"] : [],
+    apiSwrSeconds = 600,
+    pageMaxAgeSeconds = 300,
+    adapter,
+    cacheProvider,
+    fonts,
+    solid,
+    security,
+    i18n,
+    cms,
+    ui,
+    seo,
+    integrations = [],
+    vite = {},
+    ...rest
+  } = options
+
+  const hasFlags = Boolean(solid || security || i18n || cms || ui || seo)
+
+  return {
+    ...(site ? { site } : {}),
+    prefetch: {
+      prefetchAll: true
+    },
+    ...cloudflarePreset({
+      ...(adapter !== undefined ? { adapter } : {}),
+      ...(cacheProvider !== undefined ? { cacheProvider } : {})
+    }),
+    ...cacheRulesPreset({
+      ...(apiSwrSeconds !== undefined ? { apiSwrSeconds } : {}),
+      ...(pageMaxAgeSeconds !== undefined ? { pageMaxAgeSeconds } : {})
+    }),
+    ...fontsPreset(fonts !== undefined ? { fonts } : {}),
+    ...imagePreset({ domains: imageDomains }),
+    markdown: {
+      syntaxHighlight: "prism"
+    },
+    integrations: [
+      ...(hasFlags ? [rimelightIntegration(options, imageDomains, domain)] : []),
+      ...integrations
+    ],
+    vite,
+    ...rest
+  }
+}

package/astro/index.ts

@@ -0,0 +1,415 @@
+import fs from "node:fs"
+import path from "node:path"
+import cloudflare from "@astrojs/cloudflare"
+import { cacheCloudflare } from "@astrojs/cloudflare/cache"
+import { fontProviders } from "astro/config"
+
+export interface CacheRulesPresetOptions {
+  apiSwrSeconds?: number
+  pageMaxAgeSeconds?: number
+  customRules?: Record<string, any>
+}
+
+export function cacheRulesPreset(options: CacheRulesPresetOptions = {}): any {
+  const { apiSwrSeconds = 600, pageMaxAgeSeconds = 300, customRules = {} } = options
+  return {
+    routeRules: {
+      "/api/[...path]": {
+        swr: apiSwrSeconds
+      },
+      "/[...path]": {
+        maxAge: pageMaxAgeSeconds
+      },
+      ...customRules
+    }
+  }
+}
+
+export interface FontsPresetOptions {
+  fontProviders?: any
+  fonts?: any[]
+}
+
+export function fontsPreset(options: FontsPresetOptions = {}): any {
+  const defaultFonts = [
+    {
+      name: "Noto Sans",
+      cssVariable: "--font-sans",
+      fallbacks: ["sans-serif"],
+      subsets: ["latin", "latin-ext"],
+      weights: [400, 500, 600, 700],
+      styles: ["normal"]
+    },
+    {
+      name: "Noto Serif",
+      cssVariable: "--font-serif",
+      fallbacks: ["serif"],
+      subsets: ["latin", "latin-ext"],
+      weights: [400, 700],
+      styles: ["normal"]
+    },
+    {
+      name: "JetBrains Mono",
+      cssVariable: "--font-mono",
+      fallbacks: ["monospace"],
+      subsets: ["latin", "latin-ext"],
+      weights: [400, 500, 700],
+      styles: ["normal"]
+    }
+  ]
+
+  const provider = (options.fontProviders || fontProviders)?.fontsource
+    ? (options.fontProviders || fontProviders).fontsource()
+    : undefined
+
+  return {
+    fonts: (options.fonts || defaultFonts).map((font) => ({
+      ...(provider ? { provider } : {}),
+      ...font
+    }))
+  }
+}
+
+export interface ImagePresetOptions {
+  domains?: string[]
+  layout?: "constrained" | "fixed" | "full-width" | "responsive"
+  responsiveStyles?: boolean
+}
+
+export function imagePreset(options: ImagePresetOptions = {}): any {
+  const { domains = [], layout = "constrained", responsiveStyles = true } = options
+  return {
+    image: {
+      domains,
+      layout,
+      responsiveStyles
+    }
+  }
+}
+
+export interface CloudflarePresetOptions {
+  adapter?: any
+  cacheProvider?: any
+  session?: boolean
+}
+
+export function cloudflarePreset(options: CloudflarePresetOptions = {}): any {
+  const { adapter = cloudflare(), cacheProvider = cacheCloudflare(), session = false } = options
+  return {
+    output: "server" as const,
+    session,
+    adapter,
+    cache: { provider: cacheProvider }
+  }
+}
+
+export interface RimelightAstroOptions {
+  domain?: string
+  site?: string
+  imageDomains?: string[]
+  apiSwrSeconds?: number
+  pageMaxAgeSeconds?: number
+  adapter?: any
+  cacheProvider?: any
+  fonts?: any[]
+  solid?: boolean | { include?: string[]; [key: string]: any }
+  security?:
+    | boolean
+    | {
+        domain?: string
+        imgSrc?: string[]
+        directives?: Record<string, any>
+        [key: string]: any
+      }
+  i18n?:
+    | boolean
+    | {
+        translations?: Record<string, any>
+        locales?: string[]
+        defaultLocale?: string
+        prefixDefaultLocale?: boolean
+        kvBinding?: string
+        [key: string]: any
+      }
+  seo?:
+    | boolean
+    | {
+        robots?: boolean | Record<string, any>
+        sitemap?: boolean | Record<string, any>
+        llms?: boolean | Record<string, any>
+        [key: string]: any
+      }
+  cms?:
+    | boolean
+    | {
+        storage?: any
+        binding?: string
+        auth?: string
+        [key: string]: any
+      }
+  ui?:
+    | boolean
+    | {
+        logos?: any
+        shortcuts?: any
+        [key: string]: any
+      }
+  integrations?: any[]
+  vite?: {
+    plugins?: any[]
+    [key: string]: any
+  }
+  [key: string]: any
+}
+
+function discoverTranslations(dir = "./src/translations"): Record<string, any> {
+  const translations: Record<string, any> = {}
+  try {
+    const resolvedDir = path.resolve(process.cwd(), dir)
+    if (fs.existsSync(resolvedDir)) {
+      const files = fs.readdirSync(resolvedDir)
+      for (const file of files) {
+        if (file.endsWith(".json")) {
+          const locale = path.basename(file, ".json")
+          const content = JSON.parse(fs.readFileSync(path.join(resolvedDir, file), "utf8"))
+          translations[locale] = content
+        }
+      }
+    }
+  } catch {}
+  return translations
+}
+
+function discoverLogos(dir = "./src/assets/logos"): Record<string, any> | undefined {
+  try {
+    const candidateDirs = [dir, "./src/assets/logo"]
+    let resolvedDir: string | null = null
+    for (const d of candidateDirs) {
+      const p = path.resolve(process.cwd(), d)
+      if (fs.existsSync(p) && fs.statSync(p).isDirectory()) {
+        resolvedDir = p
+        break
+      }
+    }
+    if (!resolvedDir) return undefined
+
+    const files = fs.readdirSync(resolvedDir)
+    const logos: Record<string, any> = {}
+
+    const variants = ["logomark", "logotype", "logo"]
+    const modes = ["color", "white", "black", "light", "dark"]
+    const extensions = [".svg", ".png", ".webp", ".jpg", ".jpeg", ".gif"]
+
+    for (const variant of variants) {
+      for (const mode of modes) {
+        for (const ext of extensions) {
+          const fileName = `${variant}_${mode}${ext}`
+          if (files.includes(fileName)) {
+            if (!logos[variant]) logos[variant] = {}
+            const relPath = `./${path.relative(process.cwd(), path.join(resolvedDir, fileName)).replace(/\\/g, "/")}`
+            logos[variant][mode] = relPath
+          }
+        }
+      }
+      for (const ext of extensions) {
+        const fileName = `${variant}${ext}`
+        if (files.includes(fileName) && !logos[variant]) {
+          const relPath = `./${path.relative(process.cwd(), path.join(resolvedDir, fileName)).replace(/\\/g, "/")}`
+          logos[variant] = relPath
+        }
+      }
+    }
+
+    return Object.keys(logos).length > 0 ? logos : undefined
+  } catch {
+    return undefined
+  }
+}
+
+function defaultShortcuts(): Record<string, any> {
+  return {
+    categories: {
+      system: { label: "System" },
+      navigation: { label: "Navigation" }
+    }
+  }
+}
+
+function rimelightIntegration(
+  options: RimelightAstroOptions,
+  imageDomains: string[],
+  domain?: string
+) {
+  return {
+    name: "rimelight-auto-plugins",
+    hooks: {
+      "astro:config:setup": async ({ updateConfig }: { updateConfig: (config: any) => void }) => {
+        const integrations: any[] = []
+        const plugins: any[] = []
+
+        if (options.solid) {
+          const solidMod = await import("@astrojs/solid-js")
+          const solidFn = (solidMod as any).default || solidMod
+          const solidOpts =
+            typeof options.solid === "object"
+              ? options.solid
+              : { include: ["**/solid/**", "**/*.tsx"] }
+          integrations.push(solidFn(solidOpts))
+        }
+
+        if (options.seo) {
+          const seoMod = await import("@rimelight/seo")
+          const { rimelightSeo } = seoMod as any
+          const seoOpts = typeof options.seo === "object" ? options.seo : {}
+          integrations.push(rimelightSeo(seoOpts))
+        }
+
+        if (options.cms) {
+          const cmsMod = await import("@rimelight/cms/integration")
+          const { rimelightCms } = cmsMod as any
+          const cmsOpts = typeof options.cms === "object" ? options.cms : {}
+          let storage = cmsOpts.storage
+          if (!storage) {
+            const storageMod = await import("@rimelight/cms/storage")
+            const { r2 } = storageMod as any
+            storage = r2({ binding: cmsOpts.binding || "BLOB" })
+          }
+          integrations.push(
+            rimelightCms({
+              storage,
+              auth: cmsOpts.auth || "./src/auth/auth.ts",
+              ...cmsOpts
+            })
+          )
+        }
+
+        if (options.security) {
+          const secMod = await import("@rimelight/security")
+          const { security: securityFn } = secMod as any
+          const secOpts = typeof options.security === "object" ? options.security : {}
+          const defaultImgSrc = imageDomains.map((d: string) =>
+            d.startsWith("http://") || d.startsWith("https://") ? d : `https://${d}`
+          )
+          const imgSrc = secOpts.imgSrc
+            ? Array.from(new Set([...defaultImgSrc, ...secOpts.imgSrc]))
+            : defaultImgSrc
+
+          plugins.push(
+            securityFn({
+              domain: secOpts.domain || domain,
+              imgSrc,
+              ...secOpts
+            })
+          )
+        }
+
+        if (options.i18n) {
+          const i18nMod = await import("@rimelight/i18n")
+          const { i18n: i18nFn } = i18nMod as any
+          const i18nOpts = typeof options.i18n === "object" ? options.i18n : {}
+          const translations = i18nOpts.translations || discoverTranslations()
+          const locales = i18nOpts.locales || Object.keys(translations)
+          const defaultLocale = i18nOpts.defaultLocale || (locales.length > 0 ? locales[0] : "en")
+          const kvBinding =
+            i18nOpts.kvBinding ||
+            (domain ? `${domain.replaceAll(".", "-")}_translations` : undefined)
+
+          plugins.push(
+            i18nFn({
+              locales,
+              defaultLocale,
+              prefixDefaultLocale: i18nOpts.prefixDefaultLocale ?? true,
+              translations,
+              ...(kvBinding ? { kvBinding } : {}),
+              ...i18nOpts
+            })
+          )
+        }
+
+        if (options.ui) {
+          const uiMod = await import("@rimelight/ui")
+          const { ui: uiFn } = uiMod as any
+          const uiOpts = typeof options.ui === "object" ? options.ui : {}
+          const discoveredLogos = discoverLogos()
+
+          const mergedLogos = uiOpts.logos
+            ? { ...discoveredLogos, ...uiOpts.logos }
+            : discoveredLogos
+
+          const mergedShortcuts =
+            uiOpts.shortcuts === false
+              ? undefined
+              : {
+                  ...defaultShortcuts(),
+                  ...(typeof uiOpts.shortcuts === "object" ? uiOpts.shortcuts : {})
+                }
+
+          plugins.push(
+            uiFn({
+              ...(mergedLogos ? { logos: mergedLogos } : {}),
+              ...(mergedShortcuts ? { shortcuts: mergedShortcuts } : {}),
+              ...uiOpts
+            })
+          )
+        }
+
+        updateConfig({
+          integrations,
+          vite: {
+            plugins
+          }
+        })
+      }
+    }
+  }
+}
+
+export function rimelightAstroConfig(options: RimelightAstroOptions = {}): any {
+  const {
+    domain,
+    site = domain ? `https://${domain}` : undefined,
+    imageDomains = domain ? [domain, `cdn.${domain}`, "cdn.rimelight.com"] : [],
+    apiSwrSeconds = 600,
+    pageMaxAgeSeconds = 300,
+    adapter,
+    cacheProvider,
+    fonts,
+    solid,
+    security,
+    i18n,
+    cms,
+    ui,
+    seo,
+    integrations = [],
+    vite = {},
+    ...rest
+  } = options
+
+  const hasFlags = Boolean(solid || security || i18n || cms || ui || seo)
+
+  return {
+    ...(site ? { site } : {}),
+    prefetch: {
+      prefetchAll: true
+    },
+    ...cloudflarePreset({
+      ...(adapter !== undefined ? { adapter } : {}),
+      ...(cacheProvider !== undefined ? { cacheProvider } : {})
+    }),
+    ...cacheRulesPreset({
+      ...(apiSwrSeconds !== undefined ? { apiSwrSeconds } : {}),
+      ...(pageMaxAgeSeconds !== undefined ? { pageMaxAgeSeconds } : {})
+    }),
+    ...fontsPreset(fonts !== undefined ? { fonts } : {}),
+    ...imagePreset({ domains: imageDomains }),
+    markdown: {
+      syntaxHighlight: "prism" as const
+    },
+    integrations: [
+      ...(hasFlags ? [rimelightIntegration(options, imageDomains, domain)] : []),
+      ...integrations
+    ],
+    vite,
+    ...rest
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimelight/config",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "private": false,
   "description": "Rimelight Entertainment's shared configuration package",
   "homepage": "https://rimelight.com/docs",
@@ -18,6 +18,7 @@
   "files": [
     "tsconfig",
     "vite-plus",
+    "astro",
     "src"
   ],
   "type": "module",
@@ -28,16 +29,58 @@
     "./vite-plus/base": {
       "types": "./vite-plus/base.ts",
       "default": "./vite-plus/base.js"
+    },
+    "./astro": {
+      "types": "./astro/index.ts",
+      "default": "./astro/index.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
+    "@astrojs/cloudflare": "14.3.1",
+    "astro": "7.3.2",
     "typescript": "6.0.3",
-    "vite-plus": "0.3.0"
+    "vite-plus": "0.3.1"
+  },
+  "peerDependencies": {
+    "@astrojs/cloudflare": ">=14.0.0",
+    "@astrojs/solid-js": ">=7.0.0",
+    "@rimelight/cms": ">=0.0.1",
+    "@rimelight/i18n": ">=0.0.1",
+    "@rimelight/security": ">=0.0.1",
+    "@rimelight/seo": ">=0.0.1",
+    "@rimelight/ui": ">=0.0.1",
+    "astro": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@astrojs/cloudflare": {
+      "optional": true
+    },
+    "@astrojs/solid-js": {
+      "optional": true
+    },
+    "@rimelight/cms": {
+      "optional": true
+    },
+    "@rimelight/i18n": {
+      "optional": true
+    },
+    "@rimelight/security": {
+      "optional": true
+    },
+    "@rimelight/seo": {
+      "optional": true
+    },
+    "@rimelight/ui": {
+      "optional": true
+    },
+    "astro": {
+      "optional": true
+    }
   },
   "engines": {
-    "node": ">=26.7.0"
+    "node": ">=26.8.2"
   }
 }

package/vite-plus/base.js

@@ -1,3 +1,42 @@
+import fs from "node:fs"
+import path from "node:path"
+
+export function findSourceEntries(baseDir = "src") {
+  if (!fs.existsSync(baseDir)) {
+    return []
+  }
+
+  const entries = []
+
+  function walk(currentDir) {
+    const files = fs.readdirSync(currentDir, { withFileTypes: true })
+    for (const file of files) {
+      const fullPath = path.join(currentDir, file.name)
+      if (file.isDirectory()) {
+        walk(fullPath)
+      } else if (file.isFile()) {
+        const normalized = fullPath.split(path.sep).join("/")
+        if (
+          (file.name.endsWith(".ts") ||
+            file.name.endsWith(".tsx") ||
+            file.name.endsWith(".js") ||
+            file.name.endsWith(".jsx")) &&
+          !file.name.endsWith(".d.ts") &&
+          !file.name.endsWith(".test.ts") &&
+          !file.name.endsWith(".test.tsx") &&
+          !file.name.endsWith(".spec.ts") &&
+          !file.name.endsWith(".spec.tsx")
+        ) {
+          entries.push(normalized)
+        }
+      }
+    }
+  }
+
+  walk(baseDir)
+  return entries.sort((a, b) => a.localeCompare(b))
+}
+
 export function rimelightConfig() {
   return {
     lint: {
@@ -17,18 +56,99 @@ export function rimelightConfig() {
     },
     staged: {
       "*": "vp check --fix"
+    },
+    test: {
+      environment: "node"
+    }
+  }
+}
+
+export function findPackageExternals(pkgJsonPath = "package.json") {
+  try {
+    const fullPath = path.resolve(process.cwd(), pkgJsonPath)
+    if (!fs.existsSync(fullPath)) return ["@rimelight/*"]
+    const pkg = JSON.parse(fs.readFileSync(fullPath, "utf8"))
+    const externals = new Set()
+
+    if (pkg.peerDependencies) {
+      Object.keys(pkg.peerDependencies).forEach((dep) => externals.add(dep))
     }
+    if (pkg.dependencies) {
+      Object.keys(pkg.dependencies).forEach((dep) => externals.add(dep))
+    }
+
+    return Array.from(externals)
+  } catch {
+    return []
+  }
+}
+
+export function verifyPackageExports(pkgJsonPath = "package.json", srcDir = "src") {
+  try {
+    const fullPath = path.resolve(process.cwd(), pkgJsonPath)
+    if (!fs.existsSync(fullPath)) {
+      return { valid: false, missingExports: ["package.json not found"], extraExports: [] }
+    }
+    const pkg = JSON.parse(fs.readFileSync(fullPath, "utf8"))
+    const exportsMap = pkg.exports || {}
+    const sourceEntries = findSourceEntries(srcDir)
+
+    const expectedKeys = sourceEntries.map((file) => {
+      const rel = file.replace(new RegExp(`^${srcDir}/`), "").replace(/\.(ts|tsx|js|jsx)$/, "")
+      return rel === "index" ? "." : `./${rel}`
+    })
+
+    const definedKeys = Object.keys(exportsMap)
+    const missingExports = expectedKeys.filter(
+      (k) => !definedKeys.includes(k) && !definedKeys.includes("./*")
+    )
+    const extraExports = definedKeys.filter(
+      (k) => k !== "." && k !== "./*" && !k.includes("*") && !expectedKeys.includes(k)
+    )
+
+    return {
+      valid: missingExports.length === 0,
+      missingExports,
+      extraExports
+    }
+  } catch (err) {
+    return { valid: false, missingExports: [err.message], extraExports: [] }
   }
 }
 
 export function rimelightPackConfig(options = {}) {
-  const { entry = ["src/index.ts"], pack = {}, ...rest } = options
+  const { entry, autoEntry, pack = {}, autoExternal = true, ...rest } = options
+
+  let resolvedEntry = ["src/index.ts"]
+
+  if (Array.isArray(entry)) {
+    resolvedEntry = entry
+  } else if (entry === "auto" || autoEntry) {
+    const dir = typeof autoEntry === "string" ? autoEntry : "src"
+    const discovered = findSourceEntries(dir)
+    if (discovered.length > 0) {
+      resolvedEntry = discovered
+    }
+  } else if (typeof entry === "string") {
+    resolvedEntry = [entry]
+  }
+
+  const discoveredExternals = autoExternal ? findPackageExternals() : []
+  const userExternal = pack["external"] || []
+  const userExternalList = Array.isArray(userExternal) ? userExternal : [userExternal]
+  const userNeverBundle = pack["deps"]?.["neverBundle"] || []
+  const userNeverBundleList = Array.isArray(userNeverBundle) ? userNeverBundle : [userNeverBundle]
+  const mergedExternal = Array.from(
+    new Set([...userExternalList, ...userNeverBundleList, ...discoveredExternals])
+  ).filter(Boolean)
+
   return {
     ...rimelightConfig(),
     ...rest,
     pack: {
-      entry,
+      entry: resolvedEntry,
       dts: true,
+      ...(mergedExternal.length > 0 ? { deps: { neverBundle: mergedExternal } } : {}),
       ...pack
     }
   }

package/vite-plus/base.ts

@@ -1,5 +1,43 @@
+import fs from "node:fs"
+import path from "node:path"
 import type { UserConfig } from "vite-plus"
 
+export function findSourceEntries(baseDir = "src"): string[] {
+  if (!fs.existsSync(baseDir)) {
+    return []
+  }
+
+  const entries: string[] = []
+
+  function walk(currentDir: string) {
+    const files = fs.readdirSync(currentDir, { withFileTypes: true })
+    for (const file of files) {
+      const fullPath = path.join(currentDir, file.name)
+      if (file.isDirectory()) {
+        walk(fullPath)
+      } else if (file.isFile()) {
+        const normalized = fullPath.split(path.sep).join("/")
+        if (
+          (file.name.endsWith(".ts") ||
+            file.name.endsWith(".tsx") ||
+            file.name.endsWith(".js") ||
+            file.name.endsWith(".jsx")) &&
+          !file.name.endsWith(".d.ts") &&
+          !file.name.endsWith(".test.ts") &&
+          !file.name.endsWith(".test.tsx") &&
+          !file.name.endsWith(".spec.ts") &&
+          !file.name.endsWith(".spec.tsx")
+        ) {
+          entries.push(normalized)
+        }
+      }
+    }
+  }
+
+  walk(baseDir)
+  return entries.sort((a, b) => a.localeCompare(b))
+}
+
 export function rimelightConfig(): UserConfig {
   return {
     lint: {
@@ -19,20 +57,116 @@ export function rimelightConfig(): UserConfig {
     },
     staged: {
       "*": "vp check --fix"
+    },
+    test: {
+      environment: "node"
     }
   }
 }
 
-export function rimelightPackConfig(
-  options: { entry?: string[]; pack?: Record<string, any>; [key: string]: any } = {}
-): any {
-  const { entry = ["src/index.ts"], pack = {}, ...rest } = options
+export function findPackageExternals(pkgJsonPath = "package.json"): string[] {
+  try {
+    const fullPath = path.resolve(process.cwd(), pkgJsonPath)
+    if (!fs.existsSync(fullPath)) return ["@rimelight/*"]
+    const pkg = JSON.parse(fs.readFileSync(fullPath, "utf8"))
+    const externals = new Set<string>()
+
+    if (pkg.peerDependencies) {
+      Object.keys(pkg.peerDependencies).forEach((dep) => externals.add(dep))
+    }
+    if (pkg.dependencies) {
+      Object.keys(pkg.dependencies).forEach((dep) => externals.add(dep))
+    }
+
+    return Array.from(externals)
+  } catch {
+    return []
+  }
+}
+
+export interface ExportValidationResult {
+  valid: boolean
+  missingExports: string[]
+  extraExports: string[]
+}
+
+export function verifyPackageExports(
+  pkgJsonPath = "package.json",
+  srcDir = "src"
+): ExportValidationResult {
+  try {
+    const fullPath = path.resolve(process.cwd(), pkgJsonPath)
+    if (!fs.existsSync(fullPath)) {
+      return { valid: false, missingExports: ["package.json not found"], extraExports: [] }
+    }
+    const pkg = JSON.parse(fs.readFileSync(fullPath, "utf8"))
+    const exportsMap = pkg.exports || {}
+    const sourceEntries = findSourceEntries(srcDir)
+
+    const expectedKeys = sourceEntries.map((file) => {
+      const rel = file.replace(new RegExp(`^${srcDir}/`), "").replace(/\.(ts|tsx|js|jsx)$/, "")
+      return rel === "index" ? "." : `./${rel}`
+    })
+
+    const definedKeys = Object.keys(exportsMap)
+    const missingExports = expectedKeys.filter(
+      (k) => !definedKeys.includes(k) && !definedKeys.includes("./*")
+    )
+    const extraExports = definedKeys.filter(
+      (k) => k !== "." && k !== "./*" && !k.includes("*") && !expectedKeys.includes(k)
+    )
+
+    return {
+      valid: missingExports.length === 0,
+      missingExports,
+      extraExports
+    }
+  } catch (err: any) {
+    return { valid: false, missingExports: [err.message], extraExports: [] }
+  }
+}
+
+export interface RimelightPackOptions {
+  entry?: string[] | "auto"
+  autoEntry?: boolean | string
+  pack?: Record<string, any>
+  autoExternal?: boolean
+  [key: string]: any
+}
+
+export function rimelightPackConfig(options: RimelightPackOptions = {}): any {
+  const { entry, autoEntry, pack = {}, autoExternal = true, ...rest } = options
+
+  let resolvedEntry: string[] = ["src/index.ts"]
+
+  if (Array.isArray(entry)) {
+    resolvedEntry = entry
+  } else if (entry === "auto" || autoEntry) {
+    const dir = typeof autoEntry === "string" ? autoEntry : "src"
+    const discovered = findSourceEntries(dir)
+    if (discovered.length > 0) {
+      resolvedEntry = discovered
+    }
+  } else if (typeof entry === "string") {
+    resolvedEntry = [entry]
+  }
+
+  const discoveredExternals = autoExternal ? findPackageExternals() : []
+  const userExternal = pack["external"] || []
+  const userExternalList = Array.isArray(userExternal) ? userExternal : [userExternal]
+  const userNeverBundle = (pack["deps"] as Record<string, any> | undefined)?.["neverBundle"] || []
+  const userNeverBundleList = Array.isArray(userNeverBundle) ? userNeverBundle : [userNeverBundle]
+  const mergedExternal = Array.from(
+    new Set([...userExternalList, ...userNeverBundleList, ...discoveredExternals])
+  ).filter(Boolean)
+
   return {
     ...rimelightConfig(),
     ...rest,
     pack: {
-      entry,
+      entry: resolvedEntry,
       dts: true,
+      ...(mergedExternal.length > 0 ? { deps: { neverBundle: mergedExternal } } : {}),
       ...pack
     }
   }