@absolutejs/absolute 0.13.11 → 0.14.0

package/CLAUDE.md

@@ -1,56 +1,56 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-AbsoluteJS is a full-stack, type-safe meta-framework for building web applications with TypeScript. It provides universal server-side rendering (SSR) for multiple frontend frameworks (React, Svelte, Vue, HTML, HTMX) powered by Bun and Elysia.
-
-## Commands
-
-```bash
-bun run typecheck   # TypeScript type checking (no emit)
-bun run format      # Prettier formatting
-```
-
-## Architecture
-
-### Build Pipeline (`src/core/build.ts`)
-
-The central orchestrator. A single `build()` call scans, compiles, and bundles all frameworks:
-
-1. **Path validation** → `validateSafePath()` prevents directory traversal
-2. **React index generation** → creates hydration entry points in `indexes/`
-3. **Asset copy** + optional **Tailwind compilation**
-4. **Entry point scanning** → `scanEntryPoints()` globs each framework directory
-5. **Framework compilation** → Svelte (`compileSvelte`), Vue (`compileVue`) each produce SSR + client variants
-6. **Bun bundling** (3 passes): server (target=bun), client (target=browser, minified), CSS
-7. **Manifest generation** → maps filenames (PascalCased via `toPascal`) to hashed asset paths
-8. **HTML asset path updating** → regex-based injection of hashed paths
-9. **Cleanup** → removes `compiled/` intermediates unless `preserveIntermediateFiles` is set
-
-### Key Modules
-
-- **`src/core/pageHandlers.ts`** — `handleReactPageRequest`, `handleSveltePageRequest`, `handleVuePageRequest`, `handleHTMLPageRequest`, `handleHTMXPageRequest`. Each renders SSR HTML with hydration scripts.
-- **`src/core/lookup.ts`** — `asset(manifest, name)` resolves build manifest entries.
-- **`src/build/`** — Individual compilation steps: `compileSvelte.ts`, `compileVue.ts`, `generateManifest.ts`, `generateReactIndexes.ts`, `scanEntryPoints.ts`, `updateAssetPaths.ts`.
-- **`src/plugins/networking.ts`** — Elysia plugin for server startup with HOST/PORT config and LAN binding (`--host` flag).
-- **`src/utils/`** — Path validation, string transforms (`toPascal`/`toKebab`), head element generation, environment variable loading (`getEnv`).
-- **`src/types.ts`** — `BuildConfig`, `BuildOptions`, `PropsOf<T>`, `Prettify<T>`.
-
-### Framework SSR Pattern
-
-All frameworks follow the same pattern: server renders HTML → props serialized to `window.__INITIAL_PROPS__` → client hydrates with framework-specific entry point. Hydration indexes are auto-generated during build.
-
-### Configuration Type
-
-`BuildConfig` accepts optional directory paths for each framework (`reactDirectory`, `svelteDirectory`, `vueDirectory`, `htmlDirectory`, `htmxDirectory`), plus `buildDirectory`, `assetsDirectory`, `tailwind` config, and `options`.
-
-## Code Conventions
-
-- **ESLint plugin `eslint-plugin-absolute`** enforces strict rules: max nesting depth of 1, min variable name length of 3 (exceptions: `_`, `id`, `db`, `OK`), explicit return types, sorted exports/keys, no default exports (except config files)
-- **Prettier**: 4-space tabs, 80 char width, single quotes, trailing commas off, semicolons on
-- **TypeScript**: strict mode, ESNext target, bundler module resolution, decorator support enabled
-- **Barrel exports**: `index.ts` files re-export alphabetically from each module directory
-- **No default imports** from `react` or `bun` (enforced by linter)
-- Elysia plugin pattern for server extensibility
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+AbsoluteJS is a full-stack, type-safe meta-framework for building web applications with TypeScript. It provides universal server-side rendering (SSR) for multiple frontend frameworks (React, Svelte, Vue, HTML, HTMX) powered by Bun and Elysia.
+
+## Commands
+
+```bash
+bun run typecheck   # TypeScript type checking (no emit)
+bun run format      # Prettier formatting
+```
+
+## Architecture
+
+### Build Pipeline (`src/core/build.ts`)
+
+The central orchestrator. A single `build()` call scans, compiles, and bundles all frameworks:
+
+1. **Path validation** → `validateSafePath()` prevents directory traversal
+2. **React index generation** → creates hydration entry points in `indexes/`
+3. **Asset copy** + optional **Tailwind compilation**
+4. **Entry point scanning** → `scanEntryPoints()` globs each framework directory
+5. **Framework compilation** → Svelte (`compileSvelte`), Vue (`compileVue`) each produce SSR + client variants
+6. **Bun bundling** (3 passes): server (target=bun), client (target=browser, minified), CSS
+7. **Manifest generation** → maps filenames (PascalCased via `toPascal`) to hashed asset paths
+8. **HTML asset path updating** → regex-based injection of hashed paths
+9. **Cleanup** → removes `compiled/` intermediates unless `preserveIntermediateFiles` is set
+
+### Key Modules
+
+- **`src/core/pageHandlers.ts`** — `handleReactPageRequest`, `handleSveltePageRequest`, `handleVuePageRequest`, `handleHTMLPageRequest`, `handleHTMXPageRequest`. Each renders SSR HTML with hydration scripts.
+- **`src/core/lookup.ts`** — `asset(manifest, name)` resolves build manifest entries.
+- **`src/build/`** — Individual compilation steps: `compileSvelte.ts`, `compileVue.ts`, `generateManifest.ts`, `generateReactIndexes.ts`, `scanEntryPoints.ts`, `updateAssetPaths.ts`.
+- **`src/plugins/networking.ts`** — Elysia plugin for server startup with HOST/PORT config and LAN binding (`--host` flag).
+- **`src/utils/`** — Path validation, string transforms (`toPascal`/`toKebab`), head element generation, environment variable loading (`getEnv`).
+- **`src/types.ts`** — `BuildConfig`, `BuildOptions`, `PropsOf<T>`, `Prettify<T>`.
+
+### Framework SSR Pattern
+
+All frameworks follow the same pattern: server renders HTML → props serialized to `window.__INITIAL_PROPS__` → client hydrates with framework-specific entry point. Hydration indexes are auto-generated during build.
+
+### Configuration Type
+
+`BuildConfig` accepts optional directory paths for each framework (`reactDirectory`, `svelteDirectory`, `vueDirectory`, `htmlDirectory`, `htmxDirectory`), plus `buildDirectory`, `assetsDirectory`, `tailwind` config, and `options`.
+
+## Code Conventions
+
+- **ESLint plugin `eslint-plugin-absolute`** enforces strict rules: max nesting depth of 1, min variable name length of 3 (exceptions: `_`, `id`, `db`, `OK`), explicit return types, sorted exports/keys, no default exports (except config files)
+- **Prettier**: 4-space tabs, 80 char width, single quotes, trailing commas off, semicolons on
+- **TypeScript**: strict mode, ESNext target, bundler module resolution, decorator support enabled
+- **Barrel exports**: `index.ts` files re-export alphabetically from each module directory
+- **No default imports** from `react` or `bun` (enforced by linter)
+- Elysia plugin pattern for server extensibility

package/LICENSE

@@ -1,24 +1,24 @@
-```
-# Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
-
-By using this project, you agree to the following terms under the Creative Commons Attribution-NonCommercial 4.0 International License.
-
-## License Summary
-This license allows you to:
-- **Share**: Copy and redistribute the material in any medium or format.
-- **Adapt**: Remix, transform, and build upon the material.
-
-**Under the following conditions**:
-- **Attribution**: You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
-- **Non-Commercial**: You may not use the material for commercial purposes.
-
-## Full License Text
-The full license text can be found at: https://creativecommons.org/licenses/by-nc/4.0/legalcode
-
-## Contact Information for Commercial Use
-For commercial use, licensing inquiries, or additional permissions, please contact:
-Alex Kahn
-alexkahndev@gmail.com
-alexkahndev.github.io
-```
-
+```
+# Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
+
+By using this project, you agree to the following terms under the Creative Commons Attribution-NonCommercial 4.0 International License.
+
+## License Summary
+This license allows you to:
+- **Share**: Copy and redistribute the material in any medium or format.
+- **Adapt**: Remix, transform, and build upon the material.
+
+**Under the following conditions**:
+- **Attribution**: You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+- **Non-Commercial**: You may not use the material for commercial purposes.
+
+## Full License Text
+The full license text can be found at: https://creativecommons.org/licenses/by-nc/4.0/legalcode
+
+## Contact Information for Commercial Use
+For commercial use, licensing inquiries, or additional permissions, please contact:
+Alex Kahn
+alexkahndev@gmail.com
+alexkahndev.github.io
+```
+

package/README.md

@@ -1,163 +1,163 @@
-# AbsoluteJS
-
-Full‑stack, **type‑safe** batteries‑included platform that lets you **server‑side render _any_ modern front‑end**—React, Svelte, plain HTML, HTMX (Vue & Angular coming)—with a single Bun‑powered build step.
-
-[![bun-required](https://img.shields.io/badge/runtime-bun%401.x-yellowgreen?logo=bun)](https://bun.sh)
-[![elysia-required](https://img.shields.io/badge/server-elysia%40latest-blue?logo=elysia)](https://elysiajs.com)
-![license](https://img.shields.io/badge/license-CC%20BY--NC%204.0-lightgrey)
-
----
-
-## Why Absolute JS?
-
-- **Universal SSR.** Bring your favourite UI layer; Absolute JS handles bundling, hydration, and HTML streaming.
-- **One build, one manifest.** Call `build()` once—get a manifest mapping every page’s client and server assets, ready to wire into routes.
-- **End‑to‑end type safety.** A unified source of truth for your types—from the database, through the server, and all the way to the client—so you can be certain of the data shape at every step.
-- **Zero‑config philosophy.** Point the build at your folders; sane defaults light up everything else.
-- **Plugin power.** Extend with standard Elysia plugins—ship auth, logging, i18n, and more. First‑party: `absolute-auth`, `networkingPlugin`.
-
----
-
-## Requirements
-
-| Tool       | Version | Purpose                                     |
-| ---------- | ------- | ------------------------------------------- |
-| **Bun**    | ≥ 1.2   | Runtime, bundler, and TypeScript transpiler |
-| **Elysia** | latest  | Web server & middleware platform            |
-
----
-
-## Installation
-
-```bash
-bun add @absolutejs/absolute
-```
-
----
-
-## Quick Start
-
-```ts
-// example/server.ts
-import { staticPlugin } from '@elysiajs/static';
-import { Elysia } from 'elysia';
-import { file } from 'bun';
-import { build } from 'absolutejs/core/build';
-import {
-	handleHTMLPageRequest,
-	handleReactPageRequest,
-	handleSveltePageRequest
-} from 'absolutejs/core/pageHandlers';
-
-import { ReactExample } from './react/pages/ReactExample';
-import SvelteExample from './svelte/pages/SvelteExample.svelte';
-import { networkingPlugin } from 'absolutejs';
-
-const manifest = await build({
-	assetsDirectory: 'example/assets',
-	buildDirectory: 'example/build',
-	htmlDirectory: 'example/html',
-	htmxDirectory: 'example/htmx',
-	reactDirectory: 'example/react',
-	svelteDirectory: 'example/svelte',
-	options: { preserveIntermediateFiles: true }
-});
-
-if (!manifest) throw new Error('Manifest generation failed');
-
-let counter = 0;
-
-export const server = new Elysia()
-	.use(staticPlugin({ assets: './example/build', prefix: '' }))
-
-	// HTML
-	.get('/', () =>
-		handleHTMLPageRequest('./example/build/html/pages/HtmlExample.html')
-	)
-
-	// React
-	.get('/react', () =>
-		handleReactPageRequest(ReactExample, manifest['ReactExampleIndex'], {
-			test: 123
-		})
-	)
-
-	// Svelte
-	.get('/svelte', () =>
-		handleSveltePageRequest(SvelteExample, manifest, { test: 456 })
-	)
-
-	// HTMX demo
-	.get('/htmx', () => file('./example/build/htmx/HtmxHome.html'))
-	.get('/htmx/increment', () => new Response(String(++counter)))
-
-	.use(networkingPlugin)
-	.on('error', (error) => {
-		const { request } = error;
-		console.error(
-			`Server error on ${request.method} ${request.url}: ${error.message}`
-		);
-	});
-```
-
-### How it works
-
-1. **`build()`** scans your project, bundles each framework, and returns a **manifest** that has the server, and client assets required to serve each route.
-2. Route handlers (`handleReactPageRequest`, `handleSveltePageRequest`, …) stream HTML and inject scripts/assets based on that manifest.
-3. The static plugin serves all compiled files from `/build`.
-
----
-
-## Plugin System
-
-Absolute JS piggybacks on the [Elysia plugin API](https://elysiajs.com/plugins). Any Elysia plugin works out of the box; Absolute adds helpers for:
-
-| Plugin                 | Description                                                                                                                     |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| **`absolute-auth`**    | Full OAuth2 flow configured with 66 providers and allows full customizability with event handlers                               |
-| **`networkingPlugin`** | Starts your Elysia server with HOST/PORT defaults and adds a --host flag to toggle listening on localhost or your LAN interface |
-
----
-
-## Configuration Philosophy
-
-Everything funnels through a single `build()` call:
-
-```ts
-await build({
-	reactDirectory: 'src/react',
-	svelteDirectory: 'src/svelte',
-	htmlDirectory: 'src/html',
-	htmxDirectory: 'src/htmx',
-	assetsDirectory: 'public/assets',
-	options: { preserveIntermediateFiles: false }
-});
-```
-
-No separate config files or environment variables—just explicit arguments with sensible defaults.
-
----
-
-## Roadmap
-
-- **Angular** handlers
-- Prisma support
-- Biome support
-- Hot‑reload development server
-- First‑class Docker images & hosting recipes
-
----
-
-## Contributing
-
-Pull requests and issues are welcome! Whether it’s a new plugin, framework handler, or docs improvement:
-
-1. Fork & branch.
-2. `bun install && bun test`.
-3. Submit a PR with a clear description.
-
----
-
-## License
-
-Creative Commons **CC BY‑NC 4.0** – see [`LICENSE`](./LICENSE) for details.
+# AbsoluteJS
+
+Full‑stack, **type‑safe** batteries‑included platform that lets you **server‑side render _any_ modern front‑end**—React, Svelte, plain HTML, HTMX (Vue & Angular coming)—with a single Bun‑powered build step.
+
+[![bun-required](https://img.shields.io/badge/runtime-bun%401.x-yellowgreen?logo=bun)](https://bun.sh)
+[![elysia-required](https://img.shields.io/badge/server-elysia%40latest-blue?logo=elysia)](https://elysiajs.com)
+![license](https://img.shields.io/badge/license-CC%20BY--NC%204.0-lightgrey)
+
+---
+
+## Why Absolute JS?
+
+- **Universal SSR.** Bring your favourite UI layer; Absolute JS handles bundling, hydration, and HTML streaming.
+- **One build, one manifest.** Call `build()` once—get a manifest mapping every page’s client and server assets, ready to wire into routes.
+- **End‑to‑end type safety.** A unified source of truth for your types—from the database, through the server, and all the way to the client—so you can be certain of the data shape at every step.
+- **Zero‑config philosophy.** Point the build at your folders; sane defaults light up everything else.
+- **Plugin power.** Extend with standard Elysia plugins—ship auth, logging, i18n, and more. First‑party: `absolute-auth`, `networkingPlugin`.
+
+---
+
+## Requirements
+
+| Tool       | Version | Purpose                                     |
+| ---------- | ------- | ------------------------------------------- |
+| **Bun**    | ≥ 1.2   | Runtime, bundler, and TypeScript transpiler |
+| **Elysia** | latest  | Web server & middleware platform            |
+
+---
+
+## Installation
+
+```bash
+bun add @absolutejs/absolute
+```
+
+---
+
+## Quick Start
+
+```ts
+// example/server.ts
+import { staticPlugin } from '@elysiajs/static';
+import { Elysia } from 'elysia';
+import { file } from 'bun';
+import { build } from 'absolutejs/core/build';
+import {
+	handleHTMLPageRequest,
+	handleReactPageRequest,
+	handleSveltePageRequest
+} from 'absolutejs/core/pageHandlers';
+
+import { ReactExample } from './react/pages/ReactExample';
+import SvelteExample from './svelte/pages/SvelteExample.svelte';
+import { networkingPlugin } from 'absolutejs';
+
+const manifest = await build({
+	assetsDirectory: 'example/assets',
+	buildDirectory: 'example/build',
+	htmlDirectory: 'example/html',
+	htmxDirectory: 'example/htmx',
+	reactDirectory: 'example/react',
+	svelteDirectory: 'example/svelte',
+	options: { preserveIntermediateFiles: true }
+});
+
+if (!manifest) throw new Error('Manifest generation failed');
+
+let counter = 0;
+
+export const server = new Elysia()
+	.use(staticPlugin({ assets: './example/build', prefix: '' }))
+
+	// HTML
+	.get('/', () =>
+		handleHTMLPageRequest('./example/build/html/pages/HtmlExample.html')
+	)
+
+	// React
+	.get('/react', () =>
+		handleReactPageRequest(ReactExample, manifest['ReactExampleIndex'], {
+			test: 123
+		})
+	)
+
+	// Svelte
+	.get('/svelte', () =>
+		handleSveltePageRequest(SvelteExample, manifest, { test: 456 })
+	)
+
+	// HTMX demo
+	.get('/htmx', () => file('./example/build/htmx/HtmxHome.html'))
+	.get('/htmx/increment', () => new Response(String(++counter)))
+
+	.use(networkingPlugin)
+	.on('error', (error) => {
+		const { request } = error;
+		console.error(
+			`Server error on ${request.method} ${request.url}: ${error.message}`
+		);
+	});
+```
+
+### How it works
+
+1. **`build()`** scans your project, bundles each framework, and returns a **manifest** that has the server, and client assets required to serve each route.
+2. Route handlers (`handleReactPageRequest`, `handleSveltePageRequest`, …) stream HTML and inject scripts/assets based on that manifest.
+3. The static plugin serves all compiled files from `/build`.
+
+---
+
+## Plugin System
+
+Absolute JS piggybacks on the [Elysia plugin API](https://elysiajs.com/plugins). Any Elysia plugin works out of the box; Absolute adds helpers for:
+
+| Plugin                 | Description                                                                                                                     |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| **`absolute-auth`**    | Full OAuth2 flow configured with 66 providers and allows full customizability with event handlers                               |
+| **`networkingPlugin`** | Starts your Elysia server with HOST/PORT defaults and adds a --host flag to toggle listening on localhost or your LAN interface |
+
+---
+
+## Configuration Philosophy
+
+Everything funnels through a single `build()` call:
+
+```ts
+await build({
+	reactDirectory: 'src/react',
+	svelteDirectory: 'src/svelte',
+	htmlDirectory: 'src/html',
+	htmxDirectory: 'src/htmx',
+	assetsDirectory: 'public/assets',
+	options: { preserveIntermediateFiles: false }
+});
+```
+
+No separate config files or environment variables—just explicit arguments with sensible defaults.
+
+---
+
+## Roadmap
+
+- **Angular** handlers
+- Prisma support
+- Biome support
+- Hot‑reload development server
+- First‑class Docker images & hosting recipes
+
+---
+
+## Contributing
+
+Pull requests and issues are welcome! Whether it’s a new plugin, framework handler, or docs improvement:
+
+1. Fork & branch.
+2. `bun install && bun test`.
+3. Submit a PR with a clear description.
+
+---
+
+## License
+
+Creative Commons **CC BY‑NC 4.0** – see [`LICENSE`](./LICENSE) for details.

package/dist/core/build.d.ts

@@ -1,2 +1,2 @@
 import { BuildConfig } from '../types';
-export declare const build: ({ buildDirectory, assetsDirectory, reactDirectory, htmlDirectory, htmxDirectory, angularDirectory, svelteDirectory, vueDirectory, tailwind, options }: BuildConfig) => Promise<Record<string, string>>;
+export declare const build: ({ buildDirectory, assetsDirectory, publicDirectory, reactDirectory, htmlDirectory, htmxDirectory, angularDirectory, svelteDirectory, vueDirectory, tailwind, options }: BuildConfig) => Promise<Record<string, string>>;

package/dist/index.js

@@ -507,7 +507,8 @@ var vueFeatureFlags = {
 };
 var build = async ({
   buildDirectory = "build",
-  assetsDirectory = "assets",
+  assetsDirectory,
+  publicDirectory,
   reactDirectory,
   htmlDirectory,
   htmxDirectory,
@@ -554,8 +555,11 @@ var build = async ({
     serverRoot = sveltePagesPath;
   else if (vuePagesPath)
     serverRoot = vuePagesPath;
+  const publicPath = publicDirectory && validateSafePath(publicDirectory, projectRoot);
   await rm3(buildPath, { force: true, recursive: true });
   mkdirSync(buildPath);
+  if (publicPath)
+    cpSync(publicPath, buildPath, { force: true, recursive: true });
   if (reactIndexesPath && reactPagesPath)
     await generateReactIndexFiles(reactPagesPath, reactIndexesPath);
   if (assetsPath)
@@ -644,7 +648,7 @@ var build = async ({
     const { logs, outputs } = await bunBuild({
       entrypoints: cssEntryPoints,
       naming: `[name].[hash].[ext]`,
-      outdir: join5(buildPath, basename4(assetsPath), "css"),
+      outdir: join5(buildPath, assetsPath ? basename4(assetsPath) : "assets", "css"),
       target: "browser"
     }).catch((err) => {
       console.error("CSS build failed:", err);
@@ -913,5 +917,5 @@ export {
   BUN_BUILD_WARNING_SUPPRESSION
 };
 
-//# debugId=E4E62E702FF838A264756E2164756E21
+//# debugId=C07A521038D2FB1664756E2164756E21
 //# sourceMappingURL=index.js.map