@davaux/multisite 0.8.0 → 0.8.1

package/CLAUDE.md

@@ -1,133 +0,0 @@
-<!-- pka-generated -->
-# @davaux/multisite
-
-> Generated by Project Knowledge Analyzer on 2026-06-06T21:53:10.370Z
-
-## Overview
-
-Multi-site hosting for Davaux — run multiple sites from a single codebase
-
-**Version**: 0.8.0
-**Author**: David L Dyess II
-**License**: MIT
-**Repository**: https://codeberg.org/davaux/davaux#readme
-
-## Tech Stack
-
-- **Language**: TypeScript
-- **Module System**: ESM (`type: module`)
-- **Build Tool**: esbuild
-
-## Commands
-
-- `npm run build` — tsc
-- `npm run typecheck` — tsc --noEmit
-- `npm run test` — node --import tsx/esm --test 'src/test/**/*.test.ts'
-
-## Project Structure
-
-```
-├── README.md
-├── package.json
-├── tsconfig.json
-└── src/
-    ├── test/
-    │   ├── fixtures/
-    │   │   ├── base/
-    │   │   │   └── routes/
-    │   │   │       ├── _layout.ts
-    │   │   │       ├── about.page.ts
-    │   │   │       └── index.page.ts
-    │   │   ├── site-a/
-    │   │   │   └── routes/
-    │   │   │       ├── _layout.ts
-    │   │   │       ├── _middleware.ts
-    │   │   │       ├── config.page.ts
-    │   │   │       ├── index.page.ts
-    │   │   │       ├── shop.page.ts
-    │   │   │       └── state.page.ts
-    │   │   └── site-b/
-    │   │       └── routes/
-    │   │           ├── _error.ts
-    │   │           └── about.page.ts
-    │   └── multisite.test.ts
-    └── index.ts
-
-```
-
-## Entry Points
-
-- `src/index.ts`
-
-## Files by Type
-
-### Documentation (1)
-- `README.md`
-
-### Config (2)
-- `package.json`
-- `tsconfig.json`
-
-### Module (1)
-- `src/index.ts`
-
-
-## Git
-- **Branch**: main
-- **Last Commit**: chore: Add alpha status note to README
-- **Author**: David Dyess II
-- **Date**: 2026-06-06 15:52:27 -0600
-- **Remote**: https://codeberg.org/davaux/davaux.git
-
-### Recent Commits
-```
-f527031 chore: Add alpha status note to README
-90c819e chore: Add repo info to package.json files
-b200d9d feat(davaux)!: Add OmlCacheConfig - opt-in with includes option or opt-out with excludes option; Fix OML implementation to follow OML spec - use output instead of return
-3bce0c2 chore: Update and add READMEs to packages; update ROADMAP
-fc27c20 fix(davaux): Remove old dist folder on new builds; fix server port per DavauxConfig
-c760659 feat(davaux): Add minify CSS in production builds
-c899ab8 fix(davaux): Added method JS and JSX extenstion to scanner
-7d99f04 feat(davaux): Add support for declarative partial updates
-3b47f37 chore: Bump package versions to 0.8.0
-aa0460f chore: Add CHANGELOG.md
-```
-
-## Dependencies
-
-
-### Development
-@types/node, davaux, esbuild, tsx, typescript
-
-
-
-
-
-## Tests (12)
-
-### Test Suites (1)
-- `src/test/multisite.test.ts`
-
-### Fixtures (11)
-- `src/test/fixtures/base/routes/_layout.ts`
-- `src/test/fixtures/base/routes/about.page.ts`
-- `src/test/fixtures/base/routes/index.page.ts`
-- `src/test/fixtures/site-a/routes/_layout.ts`
-- `src/test/fixtures/site-a/routes/_middleware.ts`
-- `src/test/fixtures/site-a/routes/config.page.ts`
-- `src/test/fixtures/site-a/routes/index.page.ts`
-- `src/test/fixtures/site-a/routes/shop.page.ts`
-- `src/test/fixtures/site-a/routes/state.page.ts`
-- `src/test/fixtures/site-b/routes/_error.ts`
-- `src/test/fixtures/site-b/routes/about.page.ts`
-
-
-
-## Import Graph
-
-## Exported Symbols
-
-**`src/index.ts`**
-`mergeScanResults`, `defineSites`, `buildMultisiteApps`, `startMultisiteServer`, `dispatchToSite`, `startMultisiteDev`, `startMultisite`, `getSite`, `SiteDefinition`, `MultisiteConfig`, `BuildOptions`, `ServerOptions`, `StartMultisiteOptions`
-
-

package/src/build.ts

@@ -1,183 +0,0 @@
-import { existsSync } from 'node:fs'
-import { join, resolve } from 'node:path'
-import { collectCss, generateIslandsEntry, islandServerPlugin } from 'davaux/build'
-import {
-  collectEsbuildPlugins,
-  collectScannerSuffixes,
-  type DavauxPlugin,
-  pathsToAlias,
-} from 'davaux/config'
-import { scanIslands, scanRoutes } from 'davaux/scanner'
-import type { MultisiteConfig } from './index.js'
-
-export interface BuildMultisiteOptions {
-  /** Project root directory. Defaults to `process.cwd()`. */
-  cwd?: string
-  /** Output directory. Defaults to `{cwd}/dist`. */
-  outDir?: string
-  /** Extra packages to mark as external in addition to `node:*`, `davaux`, and `@davaux/multisite`. */
-  external?: string[]
-  /**
-   * Davaux plugins to apply during the build — contributes esbuild transforms and scanner
-   * suffix extensions. Use the same plugins here as in your `davaux.config.ts`.
-   *
-   * @example
-   * import { mdx } from '@davaux/mdx'
-   * await buildMultisite(sites, { cwd: import.meta.dirname, plugins: [mdx()] })
-   */
-  plugins?: DavauxPlugin[]
-  /**
-   * tsconfig-style path aliases forwarded to esbuild `alias`. Same format as
-   * `compilerOptions.paths` — e.g. `{ '~/*': ['./src/*'] }`.
-   */
-  paths?: Record<string, string>
-}
-
-/**
- * Compile a multisite project to JavaScript.
- *
- * Reads route and island directories directly from the `MultisiteConfig` so the
- * config is the single source of truth. Discovers and compiles all route, layout,
- * middleware, and error-page files, per-site client island bundles, plus
- * `server.ts` / `multisite.config.ts` if they exist at the project root.
- *
- * Requires `esbuild` to be installed (it is present in any project that
- * depends on `davaux`).
- *
- * @example
- * // build.ts
- * import { buildMultisite } from '@davaux/multisite/build'
- * import { sites } from './multisite.config.js'
- *
- * await buildMultisite(sites, { cwd: import.meta.dirname })
- */
-export async function buildMultisite<T>(
-  config: MultisiteConfig<T>,
-  options: BuildMultisiteOptions = {},
-): Promise<void> {
-  const { build } = await import('esbuild')
-  const cwd = options.cwd ?? process.cwd()
-  const outDir = options.outDir ?? resolve(cwd, 'dist')
-  const davauxPlugins = options.plugins ?? []
-  const extraSuffixes = [...(config.extraSuffixes ?? []), ...collectScannerSuffixes(davauxPlugins)]
-  const userAlias = pathsToAlias(options.paths ?? {})
-
-  // All island directories (for the server-side island plugin)
-  const allIslandDirs: string[] = [
-    ...(config.islandsDir ? [config.islandsDir] : []),
-    ...config.sites.flatMap((s) => (s.islandsDir ? [s.islandsDir] : [])),
-  ]
-
-  // Collect route directories directly from config — no re-discovery needed
-  const routeDirs: string[] = []
-  if (config.baseDir) routeDirs.push(config.baseDir)
-  for (const site of config.sites) {
-    if (site.routesDir) routeDirs.push(site.routesDir)
-  }
-
-  // Scan for compilable files in each routes directory
-  const routeFiles: string[] = []
-  for (const dir of routeDirs) {
-    if (!existsSync(dir)) continue
-    const { routes, layouts, middlewares, errorPage } = await scanRoutes(dir, extraSuffixes)
-    routeFiles.push(
-      ...routes.map((r) => r.filePath),
-      ...layouts.map((l) => l.filePath),
-      ...middlewares.map((m) => m.filePath),
-      ...(errorPage ? [errorPage] : []),
-    )
-  }
-
-  // Include server.ts and multisite.config.ts at the project root if present
-  const entryPoints: string[] = [...routeFiles]
-  for (const name of ['server.ts', 'multisite.config.ts']) {
-    const p = resolve(cwd, name)
-    if (existsSync(p)) entryPoints.push(p)
-  }
-
-  const baseExternal = ['node:*', 'davaux', '@davaux/multisite', ...(options.external ?? [])]
-
-  // Include src/middleware.ts if present (app-level middleware runs before route matching)
-  const middlewareSrc = resolve(cwd, 'src', 'middleware.ts')
-  if (existsSync(middlewareSrc)) entryPoints.push(middlewareSrc)
-
-  // Compile routes (with island server wrapping + plugin transforms)
-  await build({
-    entryPoints,
-    outdir: outDir,
-    outbase: cwd,
-    format: 'esm',
-    platform: 'node',
-    target: 'node22',
-    bundle: true,
-    jsx: 'automatic',
-    jsxImportSource: 'davaux',
-    external: baseExternal,
-    sourcemap: true,
-    alias: { ...userAlias, 'davaux/client': 'davaux/signal' },
-    plugins: [
-      ...(allIslandDirs.length > 0 ? [islandServerPlugin(allIslandDirs)] : []),
-      ...collectEsbuildPlugins(davauxPlugins),
-    ],
-  })
-
-  // Collect CSS side-effect outputs into dist/_davaux/styles.css
-  const stylesOutFile = join(outDir, '_davaux', 'styles.css')
-  await collectCss(outDir, stylesOutFile)
-
-  // Compile per-site client island bundles to dist/_davaux/<name>/islands.js
-  const baseIslands = config.islandsDir ? await scanIslands(config.islandsDir) : []
-  let islandBundles = 0
-
-  for (const site of config.sites) {
-    const siteIslands = site.islandsDir ? await scanIslands(site.islandsDir) : []
-    const allIslands = [...baseIslands, ...siteIslands]
-    if (allIslands.length === 0) continue
-
-    await build({
-      stdin: {
-        contents: generateIslandsEntry(allIslands),
-        loader: 'ts',
-        resolveDir: cwd,
-      },
-      outfile: join(outDir, '_davaux', site.name, 'islands.js'),
-      format: 'esm',
-      platform: 'browser',
-      target: 'es2022',
-      bundle: true,
-      jsx: 'automatic',
-      jsxImportSource: 'davaux/client',
-      sourcemap: true,
-      alias: userAlias,
-      plugins: collectEsbuildPlugins(davauxPlugins),
-    })
-    islandBundles++
-  }
-
-  // Compile per-site client bundles to dist/_davaux/<name>/client.js
-  let clientBundles = 0
-
-  for (const site of config.sites) {
-    const clientEntry = site.clientEntry ?? config.clientEntry
-    if (!clientEntry || !existsSync(clientEntry)) continue
-
-    await build({
-      entryPoints: [clientEntry],
-      outfile: join(outDir, '_davaux', site.name, 'client.js'),
-      format: 'esm',
-      platform: 'browser',
-      target: 'es2022',
-      bundle: true,
-      jsx: 'automatic',
-      jsxImportSource: 'davaux/client',
-      sourcemap: true,
-      alias: userAlias,
-      plugins: collectEsbuildPlugins(davauxPlugins),
-    })
-    clientBundles++
-  }
-
-  console.log(
-    `[davaux/multisite] Built ${routeFiles.length} route file(s), ${islandBundles} island bundle(s), ${clientBundles} client bundle(s)`,
-  )
-}