npm - @raystack/chronicle - Versions diffs - 0.1.0-canary.e11f924 → 0.1.0-canary.f0d9bde - Mend

@raystack/chronicle 0.1.0-canary.e11f924 → 0.1.0-canary.f0d9bde

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (81) hide show

package/dist/cli/index.js +878 -9684
package/package.json +17 -12
package/src/cli/__tests__/config.test.ts +25 -0
package/src/cli/__tests__/scaffold.test.ts +10 -0
package/src/cli/commands/build.ts +66 -19
package/src/cli/commands/dev.ts +9 -22
package/src/cli/commands/init.ts +107 -11
package/src/cli/commands/serve.ts +36 -35
package/src/cli/commands/start.ts +11 -21
package/src/cli/utils/config.ts +2 -2
package/src/cli/utils/index.ts +1 -1
package/src/cli/utils/resolve.ts +6 -0
package/src/cli/utils/scaffold.ts +20 -0
package/src/components/mdx/code.tsx +10 -1
package/src/components/mdx/details.module.css +1 -24
package/src/components/mdx/details.tsx +2 -3
package/src/components/mdx/image.tsx +5 -19
package/src/components/mdx/index.tsx +3 -3
package/src/components/mdx/link.tsx +10 -11
package/src/components/ui/footer.tsx +3 -2
package/src/components/ui/search.module.css +7 -0
package/src/components/ui/search.tsx +62 -87
package/src/lib/config.ts +9 -0
package/src/lib/head.tsx +45 -0
package/src/lib/page-context.tsx +95 -0
package/src/lib/source.ts +92 -21
package/src/{app/apis/[[...slug]]/layout.tsx → pages/ApiLayout.tsx} +10 -7
package/src/pages/ApiPage.tsx +68 -0
package/src/pages/DocsLayout.tsx +18 -0
package/src/pages/DocsPage.tsx +43 -0
package/src/pages/NotFound.tsx +10 -0
package/src/pages/__tests__/head.test.tsx +57 -0
package/src/server/App.tsx +59 -0
package/src/server/__tests__/entry-server.test.tsx +35 -0
package/src/server/__tests__/handlers.test.ts +77 -0
package/src/server/__tests__/og.test.ts +23 -0
package/src/server/__tests__/router.test.ts +72 -0
package/src/server/__tests__/vite-config.test.ts +25 -0
package/src/server/adapters/vercel.ts +133 -0
package/src/server/build-search-index.ts +107 -0
package/src/server/dev.ts +158 -0
package/src/server/entry-client.tsx +74 -0
package/src/server/entry-prod.ts +98 -0
package/src/server/entry-server.tsx +35 -0
package/src/server/entry-vercel.ts +28 -0
package/src/server/handlers/apis-proxy.ts +57 -0
package/src/{app/api/health/route.ts → server/handlers/health.ts} +1 -1
package/src/server/handlers/llms.ts +58 -0
package/src/server/handlers/og.ts +87 -0
package/src/server/handlers/robots.ts +11 -0
package/src/server/handlers/search.ts +172 -0
package/src/server/handlers/sitemap.ts +39 -0
package/src/server/handlers/specs.ts +9 -0
package/src/server/index.html +12 -0
package/src/server/prod.ts +18 -0
package/src/server/request-handler.ts +64 -0
package/src/server/router.ts +42 -0
package/src/server/utils/safe-path.ts +14 -0
package/src/server/vite-config.ts +71 -0
package/src/themes/default/Layout.tsx +9 -10
package/src/themes/default/Page.module.css +60 -0
package/src/themes/default/font.ts +4 -6
package/src/themes/paper/ChapterNav.tsx +5 -6
package/src/themes/paper/Page.tsx +8 -9
package/src/types/config.ts +11 -0
package/src/types/content.ts +1 -0
package/tsconfig.json +29 -0
package/next.config.mjs +0 -10
package/source.config.ts +0 -50
package/src/app/[[...slug]]/layout.tsx +0 -15
package/src/app/[[...slug]]/page.tsx +0 -57
package/src/app/api/apis-proxy/route.ts +0 -59
package/src/app/api/search/route.ts +0 -90
package/src/app/apis/[[...slug]]/page.tsx +0 -57
package/src/app/layout.tsx +0 -26
package/src/app/llms-full.txt/route.ts +0 -18
package/src/app/llms.txt/route.ts +0 -15
package/src/app/providers.tsx +0 -8
package/src/cli/utils/process.ts +0 -7
package/src/lib/get-llm-text.ts +0 -10
/package/src/{app/apis/[[...slug]]/layout.module.css → pages/ApiLayout.module.css} +0 -0

package/src/{app/apis/[[...slug]]/layout.tsx → pages/ApiLayout.tsx} RENAMED Viewed

@@ -1,16 +1,19 @@
+import type { ReactNode } from 'react'
 import { cx } from 'class-variance-authority'
-import { loadConfig } from '@/lib/config'
-import { loadApiSpecs } from '@/lib/openapi'
+import { usePageContext } from '@/lib/page-context'
 import { buildApiPageTree } from '@/lib/api-routes'
 import { getTheme } from '@/themes/registry'
 import { Search } from '@/components/ui/search'
-import styles from './layout.module.css'
+import styles from './ApiLayout.module.css'
-export default function ApiLayout({ children }: { children: React.ReactNode }) {
-  const config = loadConfig()
+interface ApiLayoutProps {
+  children: ReactNode
+}
+export function ApiLayout({ children }: ApiLayoutProps) {
+  const { config, apiSpecs } = usePageContext()
   const { Layout, className } = getTheme(config.theme?.name)
-  const specs = loadApiSpecs(config.api ?? [])
-  const tree = buildApiPageTree(specs)
+  const tree = buildApiPageTree(apiSpecs)
   return (
     <Layout config={config} tree={tree} classNames={{

package/src/pages/ApiPage.tsx ADDED Viewed

@@ -0,0 +1,68 @@
+import type { OpenAPIV3 } from 'openapi-types'
+import { Flex, Headline, Text } from '@raystack/apsara'
+import { usePageContext } from '@/lib/page-context'
+import { findApiOperation } from '@/lib/api-routes'
+import { EndpointPage } from '@/components/api'
+import { Head } from '@/lib/head'
+import type { ApiSpec } from '@/lib/openapi'
+interface ApiPageProps {
+  slug: string[]
+}
+export function ApiPage({ slug }: ApiPageProps) {
+  const { config, apiSpecs } = usePageContext()
+  if (slug.length === 0) {
+    return (
+      <>
+        <Head
+          title="API Reference"
+          description={`API documentation for ${config.title}`}
+          config={config}
+        />
+        <ApiLanding specs={apiSpecs} />
+      </>
+    )
+  }
+  const match = findApiOperation(apiSpecs, slug)
+  if (!match) return null
+  const operation = match.operation as OpenAPIV3.OperationObject
+  const title = operation.summary ?? `${match.method.toUpperCase()} ${match.path}`
+  return (
+    <>
+      <Head
+        title={title}
+        description={operation.description}
+        config={config}
+      />
+      <EndpointPage
+        method={match.method}
+        path={match.path}
+        operation={match.operation}
+        serverUrl={match.spec.server.url}
+        specName={match.spec.name}
+        auth={match.spec.auth}
+      />
+    </>
+  )
+}
+function ApiLanding({ specs }: { specs: ApiSpec[] }) {
+  return (
+    <Flex direction="column" gap="large" style={{ padding: 'var(--rs-space-7)' }}>
+      <Headline size="medium" as="h1">API Reference</Headline>
+      {specs.map((spec) => (
+        <Flex key={spec.name} direction="column" gap="small">
+          <Headline size="small" as="h2">{spec.name}</Headline>
+          {spec.document.info.description && (
+            <Text size={3}>{spec.document.info.description}</Text>
+          )}
+        </Flex>
+      ))}
+    </Flex>
+  )
+}

package/src/pages/DocsLayout.tsx ADDED Viewed

@@ -0,0 +1,18 @@
+import type { ReactNode } from 'react'
+import { usePageContext } from '@/lib/page-context'
+import { getTheme } from '@/themes/registry'
+interface DocsLayoutProps {
+  children: ReactNode
+}
+export function DocsLayout({ children }: DocsLayoutProps) {
+  const { config, tree } = usePageContext()
+  const { Layout, className } = getTheme(config.theme?.name)
+  return (
+    <Layout config={config} tree={tree} classNames={{ layout: className }}>
+      {children}
+    </Layout>
+  )
+}

package/src/pages/DocsPage.tsx ADDED Viewed

@@ -0,0 +1,43 @@
+import { usePageContext } from '@/lib/page-context'
+import { getTheme } from '@/themes/registry'
+import { Head } from '@/lib/head'
+interface DocsPageProps {
+  slug: string[]
+}
+export function DocsPage({ slug }: DocsPageProps) {
+  const { config, tree, page } = usePageContext()
+  if (!page) return null
+  const { Page } = getTheme(config.theme?.name)
+  const pageUrl = config.url ? `${config.url}/${slug.join('/')}` : undefined
+  return (
+    <>
+      <Head
+        title={page.frontmatter.title}
+        description={page.frontmatter.description}
+        config={config}
+        jsonLd={{
+          '@context': 'https://schema.org',
+          '@type': 'Article',
+          headline: page.frontmatter.title,
+          description: page.frontmatter.description,
+          ...(pageUrl && { url: pageUrl }),
+        }}
+      />
+      <Page
+        page={{
+          slug,
+          frontmatter: page.frontmatter,
+          content: page.content,
+          toc: [],
+        }}
+        config={config}
+        tree={tree}
+      />
+    </>
+  )
+}

package/src/pages/NotFound.tsx ADDED Viewed

@@ -0,0 +1,10 @@
+import { Flex, Headline, Text } from '@raystack/apsara'
+export function NotFound() {
+  return (
+    <Flex direction="column" align="center" justify="center" style={{ minHeight: '60vh' }}>
+      <Headline size="large" as="h1">404</Headline>
+      <Text size={3}>Page not found</Text>
+    </Flex>
+  )
+}

package/src/pages/__tests__/head.test.tsx ADDED Viewed

@@ -0,0 +1,57 @@
+import { describe, it, expect } from 'vitest'
+import { renderToString } from 'react-dom/server'
+import { Head } from '@/lib/head'
+describe('Head component', () => {
+  const baseConfig = {
+    title: 'Test Docs',
+    theme: { name: 'default' as const },
+    search: { enabled: true, placeholder: 'Search...' },
+  }
+  it('renders title tag', () => {
+    const html = renderToString(
+      <Head title="Page Title" config={baseConfig} />
+    )
+    expect(html).toContain('Page Title | Test Docs')
+  })
+  it('renders description meta tag', () => {
+    const html = renderToString(
+      <Head title="Page" description="A description" config={baseConfig} />
+    )
+    expect(html).toContain('A description')
+  })
+  it('renders OG tags when config.url is set', () => {
+    const html = renderToString(
+      <Head
+        title="Page"
+        description="Desc"
+        config={{ ...baseConfig, url: 'https://docs.example.com' }}
+      />
+    )
+    expect(html).toContain('og:title')
+    expect(html).toContain('og:description')
+    expect(html).toContain('twitter:card')
+  })
+  it('skips OG tags when no url in config', () => {
+    const html = renderToString(
+      <Head title="Page" config={baseConfig} />
+    )
+    expect(html).not.toContain('og:title')
+  })
+  it('renders JSON-LD script', () => {
+    const html = renderToString(
+      <Head
+        title="Page"
+        config={baseConfig}
+        jsonLd={{ '@context': 'https://schema.org', '@type': 'Article' }}
+      />
+    )
+    expect(html).toContain('application/ld+json')
+    expect(html).toContain('schema.org')
+  })
+})

package/src/server/App.tsx ADDED Viewed

@@ -0,0 +1,59 @@
+import '@raystack/apsara/normalize.css'
+import '@raystack/apsara/style.css'
+import { ThemeProvider } from '@raystack/apsara'
+import { useLocation } from 'react-router-dom'
+import { usePageContext } from '@/lib/page-context'
+import { Head } from '@/lib/head'
+import { DocsLayout } from '@/pages/DocsLayout'
+import { DocsPage } from '@/pages/DocsPage'
+import { ApiLayout } from '@/pages/ApiLayout'
+import { ApiPage } from '@/pages/ApiPage'
+import type { ChronicleConfig } from '@/types'
+function resolveRoute(pathname: string) {
+  if (pathname.startsWith('/apis')) {
+    const slug = pathname.replace(/^\/apis\/?/, '').split('/').filter(Boolean)
+    return { type: 'api' as const, slug }
+  }
+  const slug = pathname === '/' ? [] : pathname.slice(1).split('/').filter(Boolean)
+  return { type: 'docs' as const, slug }
+}
+export function App() {
+  const { pathname } = useLocation()
+  const { config } = usePageContext()
+  const route = resolveRoute(pathname)
+  return (
+    <ThemeProvider enableSystem>
+      <RootHead config={config} />
+      {route.type === 'api' ? (
+        <ApiLayout>
+          <ApiPage slug={route.slug} />
+        </ApiLayout>
+      ) : (
+        <DocsLayout>
+          <DocsPage slug={route.slug} />
+        </DocsLayout>
+      )}
+    </ThemeProvider>
+  )
+}
+function RootHead({ config }: { config: ChronicleConfig }) {
+  return (
+    <Head
+      title={config.title}
+      description={config.description}
+      config={config}
+      jsonLd={config.url ? {
+        '@context': 'https://schema.org',
+        '@type': 'WebSite',
+        name: config.title,
+        description: config.description,
+        url: config.url,
+      } : undefined}
+    />
+  )
+}

package/src/server/__tests__/entry-server.test.tsx ADDED Viewed

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest'
+import { render, type SSRData } from '../entry-server'
+const mockData: SSRData = {
+  config: { title: 'Test Site' },
+  tree: { name: 'root', children: [] },
+  page: {
+    slug: [],
+    frontmatter: { title: 'Test' },
+    content: null,
+  },
+  apiSpecs: [],
+}
+describe('entry-server', () => {
+  it('exports a render function', () => {
+    expect(typeof render).toBe('function')
+  })
+  it('returns an HTML string', () => {
+    const html = render('http://localhost:3000/', mockData)
+    expect(typeof html).toBe('string')
+    expect(html.length).toBeGreaterThan(0)
+  })
+  it('renders docs route for root URL', () => {
+    const html = render('http://localhost:3000/', mockData)
+    expect(html).toBeTruthy()
+  })
+  it('renders api route for /apis URL', () => {
+    const html = render('http://localhost:3000/apis', mockData)
+    expect(html).toBeTruthy()
+  })
+})

package/src/server/__tests__/handlers.test.ts ADDED Viewed

@@ -0,0 +1,77 @@
+import { describe, it, expect } from 'vitest'
+import { handleHealth } from '../handlers/health'
+import { handleRobots } from '../handlers/robots'
+import { handleSitemap } from '../handlers/sitemap'
+import { handleApisProxy } from '../handlers/apis-proxy'
+import { handleLlms } from '../handlers/llms'
+describe('handleHealth', () => {
+  it('returns 200 with status ok', async () => {
+    const response = handleHealth()
+    expect(response.status).toBe(200)
+    const body = await response.json()
+    expect(body).toEqual({ status: 'ok' })
+  })
+})
+describe('handleRobots', () => {
+  it('returns text/plain content type', async () => {
+    const response = handleRobots()
+    expect(response.headers.get('content-type')).toBe('text/plain')
+  })
+  it('includes User-agent directive', async () => {
+    const response = handleRobots()
+    const text = await response.text()
+    expect(text).toContain('User-agent: *')
+    expect(text).toContain('Allow: /')
+  })
+})
+describe('handleSitemap', () => {
+  it('returns application/xml content type', async () => {
+    const response = await handleSitemap()
+    expect(response.headers.get('content-type')).toBe('application/xml')
+  })
+  it('returns valid XML structure', async () => {
+    const response = await handleSitemap()
+    const xml = await response.text()
+    expect(xml).toContain('<urlset')
+  })
+})
+describe('handleApisProxy', () => {
+  it('returns 405 for GET requests', async () => {
+    const req = new Request('http://localhost:3000/api/apis-proxy', { method: 'GET' })
+    const response = await handleApisProxy(req)
+    expect(response.status).toBe(405)
+  })
+  it('returns 400 for POST without required fields', async () => {
+    const req = new Request('http://localhost:3000/api/apis-proxy', {
+      method: 'POST',
+      body: JSON.stringify({}),
+      headers: { 'Content-Type': 'application/json' },
+    })
+    const response = await handleApisProxy(req)
+    expect(response.status).toBe(400)
+  })
+  it('returns 404 for unknown spec', async () => {
+    const req = new Request('http://localhost:3000/api/apis-proxy', {
+      method: 'POST',
+      body: JSON.stringify({ specName: 'nonexistent', method: 'GET', path: '/test' }),
+      headers: { 'Content-Type': 'application/json' },
+    })
+    const response = await handleApisProxy(req)
+    expect(response.status).toBe(404)
+  })
+})
+describe('handleLlms', () => {
+  it('returns 404 when llms not enabled', async () => {
+    const response = await handleLlms()
+    expect(response.status).toBe(404)
+  })
+})

package/src/server/__tests__/og.test.ts ADDED Viewed

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest'
+import { handleOg } from '../handlers/og'
+// OG handler requires network to fetch fonts, skip in CI-like environments
+describe.skipIf(!process.env.TEST_OG)('handleOg', () => {
+  it('returns SVG content type', async () => {
+    const req = new Request('http://localhost:3000/og?title=Test')
+    const response = await handleOg(req)
+    expect(response.headers.get('content-type')).toBe('image/svg+xml')
+  })
+  it('returns cache-control header', async () => {
+    const req = new Request('http://localhost:3000/og?title=Test')
+    const response = await handleOg(req)
+    expect(response.headers.get('cache-control')).toContain('max-age')
+  })
+})
+describe('handleOg export', () => {
+  it('exports a function', () => {
+    expect(typeof handleOg).toBe('function')
+  })
+})

package/src/server/__tests__/router.test.ts ADDED Viewed

@@ -0,0 +1,72 @@
+import { describe, it, expect } from 'vitest'
+import { matchRoute } from '../router'
+describe('router', () => {
+  it('matches /api/health route', () => {
+    const handler = matchRoute('http://localhost:3000/api/health')
+    expect(handler).not.toBeNull()
+  })
+  it('returns ok for /api/health', async () => {
+    const handler = matchRoute('http://localhost:3000/api/health')
+    const response = await handler!(new Request('http://localhost:3000/api/health'))
+    expect(response.status).toBe(200)
+    const body = await response.json()
+    expect(body).toEqual({ status: 'ok' })
+  })
+  it('matches /api/search route', () => {
+    const handler = matchRoute('http://localhost:3000/api/search')
+    expect(handler).not.toBeNull()
+  })
+  it('matches /robots.txt route', () => {
+    const handler = matchRoute('http://localhost:3000/robots.txt')
+    expect(handler).not.toBeNull()
+  })
+  it('returns robots.txt with correct content', async () => {
+    const handler = matchRoute('http://localhost:3000/robots.txt')
+    const response = await handler!(new Request('http://localhost:3000/robots.txt'))
+    expect(response.headers.get('content-type')).toBe('text/plain')
+    const text = await response.text()
+    expect(text).toContain('User-agent')
+  })
+  it('matches /sitemap.xml route', () => {
+    const handler = matchRoute('http://localhost:3000/sitemap.xml')
+    expect(handler).not.toBeNull()
+  })
+  it('returns sitemap.xml with xml content type', async () => {
+    const handler = matchRoute('http://localhost:3000/sitemap.xml')
+    const response = await handler!(new Request('http://localhost:3000/sitemap.xml'))
+    expect(response.headers.get('content-type')).toBe('application/xml')
+  })
+  it('returns null for unknown routes', () => {
+    const handler = matchRoute('http://localhost:3000/some/random/path')
+    expect(handler).toBeNull()
+  })
+  it('matches /llms.txt route', () => {
+    const handler = matchRoute('http://localhost:3000/llms.txt')
+    expect(handler).not.toBeNull()
+  })
+  it('matches /og route', () => {
+    const handler = matchRoute('http://localhost:3000/og')
+    expect(handler).not.toBeNull()
+  })
+  it('matches /api/apis-proxy route', () => {
+    const handler = matchRoute('http://localhost:3000/api/apis-proxy')
+    expect(handler).not.toBeNull()
+  })
+  it('returns 405 for non-POST to apis-proxy', async () => {
+    const handler = matchRoute('http://localhost:3000/api/apis-proxy')
+    const response = await handler!(new Request('http://localhost:3000/api/apis-proxy'))
+    expect(response.status).toBe(405)
+  })
+})

package/src/server/__tests__/vite-config.test.ts ADDED Viewed

@@ -0,0 +1,25 @@
+import { describe, it, expect } from 'vitest'
+import { createViteConfig } from '../vite-config'
+describe('createViteConfig', () => {
+  it('returns a valid vite config object', async () => {
+    const config = await createViteConfig({
+      root: '/tmp/test',
+      contentDir: '/tmp/test/content',
+      isDev: true,
+    })
+    expect(config.root).toBe('/tmp/test')
+    expect(config.configFile).toBe(false)
+  })
+  it('accepts isDev option', async () => {
+    const config = await createViteConfig({
+      root: '/tmp/test',
+      contentDir: '/tmp/test/content',
+      isDev: false,
+    })
+    expect(config.root).toBe('/tmp/test')
+  })
+})

package/src/server/adapters/vercel.ts ADDED Viewed

@@ -0,0 +1,133 @@
+import path from 'path'
+import fs from 'fs/promises'
+import { existsSync } from 'fs'
+import chalk from 'chalk'
+interface VercelAdapterOptions {
+  distDir: string
+  contentDir: string
+  projectRoot: string
+}
+const CONTENT_EXTENSIONS = new Set([
+  '.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp', '.ico',
+  '.pdf', '.json', '.yaml', '.yml', '.txt',
+])
+export async function buildVercelOutput(options: VercelAdapterOptions) {
+  const { distDir, contentDir, projectRoot } = options
+  const outputDir = path.resolve(projectRoot, '.vercel/output')
+  console.log(chalk.gray('Generating Vercel output...'))
+  // Clean previous output
+  await fs.rm(outputDir, { recursive: true, force: true })
+  // Create output directories
+  const staticDir = path.resolve(outputDir, 'static')
+  const funcDir = path.resolve(outputDir, 'functions/index.func')
+  await fs.mkdir(staticDir, { recursive: true })
+  await fs.mkdir(funcDir, { recursive: true })
+  // 1. Copy client assets → .vercel/output/static/
+  const clientDir = path.resolve(distDir, 'client')
+  await copyDir(clientDir, staticDir)
+  console.log(chalk.gray('  Copied client assets to static/'))
+  // 2. Copy content dir assets (images, etc.) → .vercel/output/static/
+  if (existsSync(contentDir)) {
+    await copyContentAssets(contentDir, staticDir)
+    console.log(chalk.gray('  Copied content assets to static/'))
+  }
+  // 3. Copy server bundle → .vercel/output/functions/index.func/
+  const serverDir = path.resolve(distDir, 'server')
+  await copyDir(serverDir, funcDir)
+  console.log(chalk.gray('  Copied server bundle to functions/'))
+  // 4. Copy HTML template into function dir (not accessible from static/ at runtime)
+  const templateSrc = path.resolve(clientDir, 'src/server/index.html')
+  await fs.copyFile(templateSrc, path.resolve(funcDir, 'index.html'))
+  // 5. Write package.json for ESM support
+  await fs.writeFile(
+    path.resolve(funcDir, 'package.json'),
+    JSON.stringify({ type: 'module' }, null, 2),
+  )
+  // 6. Write .vc-config.json
+  await fs.writeFile(
+    path.resolve(funcDir, '.vc-config.json'),
+    JSON.stringify({
+      runtime: 'nodejs24.x',
+      handler: 'entry-vercel.js',
+      launcherType: 'Nodejs',
+    }, null, 2),
+  )
+  // 7. Write config.json
+  await fs.writeFile(
+    path.resolve(outputDir, 'config.json'),
+    JSON.stringify({
+      version: 3,
+      routes: [
+        { handle: 'filesystem' },
+        { src: '/(.*)', dest: '/index' },
+      ],
+    }, null, 2),
+  )
+  console.log(chalk.green('Vercel output generated →'), outputDir)
+}
+async function copyDir(src: string, dest: string) {
+  await fs.mkdir(dest, { recursive: true })
+  const entries = await fs.readdir(src, { withFileTypes: true })
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name)
+    const destPath = path.join(dest, entry.name)
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath)
+    } else {
+      await fs.copyFile(srcPath, destPath)
+    }
+  }
+}
+async function copyContentAssets(contentDir: string, staticDir: string) {
+  const entries = await fs.readdir(contentDir, { withFileTypes: true })
+  for (const entry of entries) {
+    const srcPath = path.join(contentDir, entry.name)
+    if (entry.isDirectory()) {
+      const destSubDir = path.join(staticDir, entry.name)
+      await copyContentAssetsRecursive(srcPath, destSubDir)
+    } else {
+      const ext = path.extname(entry.name).toLowerCase()
+      if (CONTENT_EXTENSIONS.has(ext)) {
+        await fs.copyFile(srcPath, path.join(staticDir, entry.name))
+      }
+    }
+  }
+}
+async function copyContentAssetsRecursive(srcDir: string, destDir: string) {
+  const entries = await fs.readdir(srcDir, { withFileTypes: true })
+  for (const entry of entries) {
+    const srcPath = path.join(srcDir, entry.name)
+    if (entry.isDirectory()) {
+      await copyContentAssetsRecursive(srcPath, path.join(destDir, entry.name))
+    } else {
+      const ext = path.extname(entry.name).toLowerCase()
+      if (CONTENT_EXTENSIONS.has(ext)) {
+        await fs.mkdir(destDir, { recursive: true })
+        await fs.copyFile(srcPath, path.join(destDir, entry.name))
+      }
+    }
+  }
+}