@absolutejs/absolute 0.12.5 → 0.13.0

package/CLAUDE.md

@@ -0,0 +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

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/constants.d.ts

@@ -10,4 +10,3 @@ export declare const TWO_THIRDS: number;
 export declare const DEFAULT_PORT = 3000;
 export declare const DEFAULT_CHUNK_SIZE = 16384;
 export declare const BUN_BUILD_WARNING_SUPPRESSION = "wildcard sideEffects are not supported yet";
-export declare const ANGULAR_BUILD_WARNING_SUPPRESSION = "@angular/common/package.json";

package/dist/index.js

@@ -12,7 +12,6 @@ var TWO_THIRDS = 2 / 3;
 var DEFAULT_PORT = 3000;
 var DEFAULT_CHUNK_SIZE = 16384;
 var BUN_BUILD_WARNING_SUPPRESSION = "wildcard sideEffects are not supported yet";
-var ANGULAR_BUILD_WARNING_SUPPRESSION = "@angular/common/package.json";
 // src/core/build.ts
 import { copyFileSync, cpSync, mkdirSync } from "fs";
 import { rm as rm3 } from "fs/promises";
@@ -294,7 +293,7 @@ var compileVue = async (entryPoints, vueRootDir) => {
     const clientOutputFile = join2(clientOutputDir, relative2(vueRootDir, entryPath).replace(/\\/g, "/").replace(/\.vue$/, ".js"));
     await mkdir2(dirname2(indexOutputFile), { recursive: true });
     await write2(indexOutputFile, [
-      `import Comp from "${relative2(dirname2(indexOutputFile), clientOutputFile)}";`,
+      `import Comp from "${relative2(dirname2(indexOutputFile), clientOutputFile).replace(/\\/g, "/")}";`,
       'import { createSSRApp } from "vue";',
       "const props = window.__INITIAL_PROPS__ ?? {};",
       'createSSRApp(Comp, props).mount("#root");'
@@ -328,7 +327,7 @@ var compileVue = async (entryPoints, vueRootDir) => {
 import { extname as extname2 } from "path";
 var generateManifest = (outputs, buildPath) => outputs.reduce((manifest, artifact) => {
   let relative3 = artifact.path.startsWith(buildPath) ? artifact.path.slice(buildPath.length) : artifact.path;
-  relative3 = relative3.replace(/^\/+/, "");
+  relative3 = relative3.replace(/\\/g, "/").replace(/^\/+/, "");
   const segments = relative3.split("/");
   const fileWithHash = segments.pop();
   if (!fileWithHash)
@@ -393,7 +392,7 @@ var generateReactIndexFiles = async (reactPagesDirectory, reactIndexesDirectory)
 // src/build/outputLogs.ts
 var outputLogs = (logs) => {
   for (const log of logs) {
-    if (log.message.includes(BUN_BUILD_WARNING_SUPPRESSION) && log.position?.file?.includes(ANGULAR_BUILD_WARNING_SUPPRESSION))
+    if (log.message.includes(BUN_BUILD_WARNING_SUPPRESSION))
       continue;
     if (log.level === "error")
       console.error(log);
@@ -575,7 +574,6 @@ var build = async ({
   const htmxCssEntries = htmxDir ? await scanEntryPoints(join5(htmxDir, "styles"), "*.css") : [];
   const reactCssEntries = reactDir ? await scanEntryPoints(join5(reactDir, "styles"), "*.css") : [];
   const svelteCssEntries = svelteDir ? await scanEntryPoints(join5(svelteDir, "styles"), "*.css") : [];
-  const angularCssEntries = angularDir ? await scanEntryPoints(join5(angularDir, "styles"), "*.css") : [];
   const { svelteServerPaths, svelteClientPaths } = svelteDir ? await compileSvelte(svelteEntries, svelteDir) : { svelteClientPaths: [], svelteServerPaths: [] };
   const { vueServerPaths, vueIndexPaths, vueCssPaths } = vueDir ? await compileVue(vueEntries, vueDir) : { vueCssPaths: [], vueIndexPaths: [], vueServerPaths: [] };
   const serverEntryPoints = [...svelteServerPaths, ...vueServerPaths];
@@ -590,8 +588,7 @@ var build = async ({
     ...reactCssEntries,
     ...svelteCssEntries,
     ...htmlCssEntries,
-    ...htmxCssEntries,
-    ...angularCssEntries
+    ...htmxCssEntries
   ];
   if (serverEntryPoints.length === 0 && clientEntryPoints.length === 0 && htmxDir === undefined) {
     console.warn("No entry points found, manifest will be empty.");
@@ -761,30 +758,6 @@ var renderToReadableStream = async (component, props, {
   }
 };
 
-// src/svelte/renderToString.ts
-import { render as render2 } from "svelte/server";
-var renderToString = (component, props, {
-  bootstrapScriptContent,
-  bootstrapScripts = [],
-  bootstrapModules = [],
-  nonce,
-  onError = console.error
-} = {}) => {
-  try {
-    const { head, body } = typeof props === "undefined" ? render2(component) : render2(component, { props });
-    const nonceAttr = nonce ? ` nonce="${nonce}"` : "";
-    const scripts = [
-      bootstrapScriptContent && `<script${nonceAttr}>${escapeScriptContent(bootstrapScriptContent)}</script>`,
-      ...bootstrapScripts.map((src) => `<script${nonceAttr} src="${src}"></script>`),
-      ...bootstrapModules.map((src) => `<script${nonceAttr} type="module" src="${src}"></script>`)
-    ].filter(Boolean).join("");
-    return `<!DOCTYPE html><html lang="en"><head>${head}</head><body>${body}${scripts}</body></html>`;
-  } catch (error) {
-    onError(error);
-    throw error;
-  }
-};
-
 // src/core/pageHandlers.ts
 var handleReactPageRequest = async (pageComponent, index, ...props) => {
   const [maybeProps] = props;
@@ -798,17 +771,6 @@ var handleReactPageRequest = async (pageComponent, index, ...props) => {
   });
 };
 var handleSveltePageRequest = async (_PageComponent, pagePath, indexPath, props) => {
-  const Zone = globalThis.Zone;
-  if (Zone && Zone.current) {
-    const { default: ImportedPageComponent2 } = await import(pagePath);
-    const html = renderToString(ImportedPageComponent2, props, {
-      bootstrapModules: indexPath ? [indexPath] : [],
-      bootstrapScriptContent: `window.__INITIAL_PROPS__=${JSON.stringify(props)}`
-    });
-    return new Response(html, {
-      headers: { "Content-Type": "text/html" }
-    });
-  }
   const { default: ImportedPageComponent } = await import(pagePath);
   const stream = await renderToReadableStream(ImportedPageComponent, props, {
     bootstrapModules: indexPath ? [indexPath] : [],
@@ -948,9 +910,8 @@ export {
   HOURS_IN_DAY,
   DEFAULT_PORT,
   DEFAULT_CHUNK_SIZE,
-  BUN_BUILD_WARNING_SUPPRESSION,
-  ANGULAR_BUILD_WARNING_SUPPRESSION
+  BUN_BUILD_WARNING_SUPPRESSION
 };
 
-//# debugId=898E0366299327F164756E2164756E21
+//# debugId=E4E62E702FF838A264756E2164756E21
 //# sourceMappingURL=index.js.map