@absolutejs/absolute 0.14.0 → 0.15.1

package/.claude/settings.local.json

@@ -0,0 +1,11 @@
+{
+	"permissions": {
+		"allow": [
+			"WebSearch",
+			"WebFetch(domain:bun.com)",
+			"WebFetch(domain:github.com)",
+			"Bash(bun run typecheck:*)",
+			"WebFetch(domain:gist.github.com)"
+		]
+	}
+}

package/CLAUDE.md

@@ -11,6 +11,10 @@ AbsoluteJS is a full-stack, type-safe meta-framework for building web applicatio
 ```bash
 bun run typecheck   # TypeScript type checking (no emit)
 bun run format      # Prettier formatting
+bun run lint        # ESLint (do not run)
+bun test            # Run tests (do not run)
+bun run dev         # Dev server (runs example/server.ts with --hot) (ask before using always)
+bun run build       # Build the package to dist/ (do not run)
 ```
 
 ## Architecture
@@ -35,8 +39,11 @@ The central orchestrator. A single `build()` call scans, compiles, and bundles a
 - **`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/plugins/hmr.ts`** — HMR plugin with WebSocket-based hot reload for dev mode.
+- **`src/dev/`** — Dev tooling: file watcher, HMR client builder, dependency graph, framework-specific HMR handlers (React, Svelte, Vue, HTML, HTMX).
+- **`src/cli/index.ts`** — CLI entry point (`absolutejs dev [entry]`). Spawns server with `--hot`, manages database containers if docker-compose exists.
 - **`src/utils/`** — Path validation, string transforms (`toPascal`/`toKebab`), head element generation, environment variable loading (`getEnv`).
-- **`src/types.ts`** — `BuildConfig`, `BuildOptions`, `PropsOf<T>`, `Prettify<T>`.
+- **`types/`** — Type definitions: `BuildConfig`, `BuildOptions`, `PropsOf<T>`, `Prettify<T>`.
 
 ### Framework SSR Pattern
 
@@ -49,8 +56,10 @@ All frameworks follow the same pattern: server renders HTML → props serialized
 ## 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
+- **Prettier**: tabs, 4-space width, 80 char print width, single quotes, no trailing commas, semicolons
 - **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)
+- **Function expressions only**: `func-style` rule enforces arrow functions over declarations
+- **Blank line before return** statements (enforced by `@stylistic/ts/padding-line-between-statements`)
 - Elysia plugin pattern for server extensibility

package/LICENSE

@@ -1,24 +1,80 @@
-```
-# Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
+# Business Source License 1.1
 
-By using this project, you agree to the following terms under the Creative Commons Attribution-NonCommercial 4.0 International License.
+**Licensor:** Alex Kahn
 
-## 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.
+**Licensed Work:** AbsoluteJS (https://github.com/absolutejs/absolutejs)
 
-**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.
+**Change Date:** February 16, 2036
 
-## Full License Text
-The full license text can be found at: https://creativecommons.org/licenses/by-nc/4.0/legalcode
+**Change License:** Apache License, Version 2.0
 
-## Contact Information for Commercial Use
-For commercial use, licensing inquiries, or additional permissions, please contact:
-Alex Kahn
-alexkahndev@gmail.com
-alexkahndev.github.io
-```
+---
 
+## Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, permitting limited production use.
+
+### Additional Use Grant
+
+You may use the Licensed Work in production, provided your use does not include
+any of the following:
+
+1. **Offering a Competing Service.** You may not offer the Licensed Work, or
+   any derivative of it, to third parties as a hosted or managed service that
+   competes with the Licensed Work itself (for example, a "framework-as-a-service"
+   platform, deployment service, or cloud offering where AbsoluteJS or a
+   substantial portion of its functionality is a primary component of the value
+   provided to users).
+
+2. **Resale or Redistribution as a Standalone Product.** You may not sell,
+   license, or distribute the Licensed Work, or any derivative or fork of it,
+   as a standalone commercial product or framework.
+
+3. **Removal of Attribution.** Any derivative work, fork, or redistribution of
+   the Licensed Work must prominently credit AbsoluteJS and include a link to
+   the original project repository (https://github.com/absolutejs/absolutejs).
+
+For clarity, the following uses are expressly permitted:
+
+- Using AbsoluteJS to build and deploy your own applications, websites, or
+  SaaS products (whether commercial or non-commercial).
+- Using AbsoluteJS as a dependency in commercial software that you build and sell,
+  as long as the software is not itself a competing framework or hosting service.
+- Providing consulting, development, or professional services to clients using
+  AbsoluteJS.
+- Forking and modifying the Licensed Work for your own internal use, provided
+  attribution is maintained.
+
+### Change Date and Change License
+
+On the Change Date specified above, or on such other date as the Licensor may
+specify by written notice, the Licensed Work will be made available under the
+Change License (Apache License, Version 2.0). Until the Change Date, the terms
+of this Business Source License 1.1 apply.
+
+### Notices
+
+You must not remove or obscure any licensing, copyright, or other notices
+included in the Licensed Work.
+
+### No Warranty
+
+THE LICENSED WORK IS PROVIDED "AS IS". THE LICENSOR HEREBY DISCLAIMS ALL
+WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR
+IN CONNECTION WITH THE LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE
+LICENSED WORK.
+
+---
+
+## Contact
+
+For commercial licensing inquiries or additional permissions, contact:
+
+- **Alex Kahn**
+- alexkahndev@gmail.com
+- alexkahndev.github.io

package/README.md

@@ -112,10 +112,10 @@ export const server = new Elysia()
 
 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 |
+| 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 from environment variables                      |
 
 ---
 

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,61 @@
+# Third-Party Notices
+
+This product includes the following third-party software:
+
+---
+
+## Bun
+
+- **Source:** https://github.com/oven-sh/bun
+- **License:** MIT
+
+MIT License
+
+Copyright (c) 2024 Bun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Elysia
+
+- **Source:** https://github.com/elysiajs/elysia
+- **License:** MIT
+
+MIT License
+
+Copyright (c) 2022 SaltyAom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli/index.js

@@ -43,30 +43,46 @@ var dev = async (serverEntry) => {
   const scripts = usesDocker ? await readDbScripts() : null;
   if (scripts)
     await startDatabase(scripts);
-  const server = Bun.spawn(["bun", "--watch", serverEntry], {
+  const spawnServer = () => Bun.spawn(["bun", "--hot", serverEntry], {
+    cwd: process.cwd(),
+    env: {
+      ...process.env,
+      NODE_ENV: "development"
+    },
     stdin: "inherit",
     stdout: "inherit",
     stderr: "inherit"
   });
+  let serverProcess = spawnServer();
   let cleaning = false;
   const cleanup = async (exitCode = 0) => {
     if (cleaning)
       return;
     cleaning = true;
     try {
-      server.kill();
-    } catch (err) {
-      console.error("Failed to kill server process:", err);
-    }
-    await server.exited;
+      serverProcess.kill();
+    } catch {}
+    await serverProcess.exited;
     if (scripts)
       await stopDatabase(scripts);
     process.exit(exitCode);
   };
   process.on("SIGINT", () => cleanup(0));
   process.on("SIGTERM", () => cleanup(0));
-  await server.exited;
-  await cleanup(0);
+  const monitorServer = async () => {
+    while (!cleaning) {
+      const exitCode = await serverProcess.exited;
+      if (cleaning)
+        continue;
+      if (exitCode === 130 || exitCode === 143) {
+        await cleanup(0);
+        return;
+      }
+      console.error(`\x1B[31m[cli] Server exited (code ${exitCode}), restarting...\x1B[0m`);
+      serverProcess = spawnServer();
+    }
+  };
+  await monitorServer();
 };
 var command = process.argv[2];
 if (command === "dev") {

package/dist/dev/client/cssUtils.ts

@@ -0,0 +1,288 @@
+/* CSS reload/preload utilities for HMR */
+
+import type { CSSUpdateResult } from '../../../types/client';
+import { hmrState } from '../../../types/client';
+
+export const getCSSBaseName = (href: string) => {
+	const fileName = href.split('?')[0]!.split('/').pop() || '';
+	return fileName.split('.')[0]!;
+};
+
+export const reloadCSSStylesheets = (manifest: Record<string, string>) => {
+	const stylesheets = document.querySelectorAll('link[rel="stylesheet"]');
+	stylesheets.forEach(function (link) {
+		const href = (link as HTMLLinkElement).getAttribute('href');
+		if (!href || href.includes('htmx.min.js')) return;
+
+		let newHref: string | null = null;
+		if (manifest) {
+			const baseName = href
+				.split('/')
+				.pop()!
+				.replace(/\.[^.]*$/, '');
+			const manifestKey =
+				baseName
+					.split('-')
+					.map(function (part) {
+						return part.charAt(0).toUpperCase() + part.slice(1);
+					})
+					.join('') + 'CSS';
+
+			if (manifest[manifestKey]) {
+				newHref = manifest[manifestKey]!;
+			} else {
+				for (const [key, value] of Object.entries(manifest)) {
+					if (key.endsWith('CSS') && value.includes(baseName)) {
+						newHref = value;
+						break;
+					}
+				}
+			}
+		}
+
+		if (newHref && newHref !== href) {
+			(link as HTMLLinkElement).href = newHref + '?t=' + Date.now();
+		} else {
+			const url = new URL(href, window.location.origin);
+			url.searchParams.set('t', Date.now().toString());
+			(link as HTMLLinkElement).href = url.toString();
+		}
+	});
+};
+
+/* Shared CSS preload/swap logic used by HTML and HTMX handlers.
+   Returns tracking arrays for coordinating CSS load with body patching. */
+export const processCSSLinks = (headHTML: string) => {
+	const tempDiv = document.createElement('div');
+	tempDiv.innerHTML = headHTML;
+	const newStylesheets = tempDiv.querySelectorAll('link[rel="stylesheet"]');
+	const existingStylesheets = Array.from(
+		document.head.querySelectorAll<HTMLLinkElement>(
+			'link[rel="stylesheet"]'
+		)
+	);
+
+	const newHrefs = Array.from(newStylesheets).map(function (link) {
+		const href = link.getAttribute('href') || '';
+		return getCSSBaseName(href);
+	});
+
+	const linksToRemove: HTMLLinkElement[] = [];
+	const linksToWaitFor: Promise<void>[] = [];
+	const linksToActivate: HTMLLinkElement[] = [];
+
+	newStylesheets.forEach(function (newLink) {
+		const href = newLink.getAttribute('href');
+		if (!href) return;
+
+		const baseNew = getCSSBaseName(href);
+
+		let existingLink: HTMLLinkElement | null = null;
+		document.head
+			.querySelectorAll('link[rel="stylesheet"]')
+			.forEach(function (existing) {
+				const existingHref =
+					(existing as HTMLLinkElement).getAttribute('href') || '';
+				const baseExisting = getCSSBaseName(existingHref);
+				if (
+					baseExisting === baseNew ||
+					baseExisting.includes(baseNew) ||
+					baseNew.includes(baseExisting)
+				) {
+					existingLink = existing as HTMLLinkElement;
+				}
+			});
+
+		if (existingLink) {
+			const existingHrefAttr = (
+				existingLink as HTMLLinkElement
+			).getAttribute('href');
+			const existingHref = existingHrefAttr
+				? existingHrefAttr.split('?')[0]
+				: '';
+			const newHrefBase = href.split('?')[0];
+			if (existingHref !== newHrefBase) {
+				const newLinkElement = document.createElement('link');
+				newLinkElement.rel = 'stylesheet';
+				newLinkElement.media = 'print';
+				const newHref =
+					href + (href.includes('?') ? '&' : '?') + 't=' + Date.now();
+				newLinkElement.href = newHref;
+
+				linksToRemove.push(existingLink as HTMLLinkElement);
+				linksToActivate.push(newLinkElement);
+
+				const loadPromise = createCSSLoadPromise(
+					newLinkElement,
+					newHref
+				);
+				document.head.appendChild(newLinkElement);
+				linksToWaitFor.push(loadPromise);
+			}
+		} else {
+			const newLinkElement = document.createElement('link');
+			newLinkElement.rel = 'stylesheet';
+			newLinkElement.media = 'print';
+			const newHref =
+				href + (href.includes('?') ? '&' : '?') + 't=' + Date.now();
+			newLinkElement.href = newHref;
+
+			linksToActivate.push(newLinkElement);
+
+			const loadPromise = createCSSLoadPromise(newLinkElement, newHref);
+			document.head.appendChild(newLinkElement);
+			linksToWaitFor.push(loadPromise);
+		}
+	});
+
+	existingStylesheets.forEach(function (existingLink) {
+		const existingHref = existingLink.getAttribute('href') || '';
+		const baseExisting = getCSSBaseName(existingHref);
+		const stillExists = newHrefs.some(function (newBase) {
+			return (
+				baseExisting === newBase ||
+				baseExisting.includes(newBase) ||
+				newBase.includes(baseExisting)
+			);
+		});
+
+		if (!stillExists) {
+			const wasHandled = Array.from(newStylesheets).some(
+				function (newLink) {
+					const newHref = newLink.getAttribute('href') || '';
+					const baseNewLocal = getCSSBaseName(newHref);
+					return (
+						baseExisting === baseNewLocal ||
+						baseExisting.includes(baseNewLocal) ||
+						baseNewLocal.includes(baseExisting)
+					);
+				}
+			);
+
+			if (!wasHandled) {
+				linksToRemove.push(existingLink);
+			}
+		}
+	});
+
+	return { linksToActivate, linksToRemove, linksToWaitFor };
+};
+
+const createCSSLoadPromise = (
+	linkElement: HTMLLinkElement,
+	newHref: string
+) => {
+	return new Promise<void>(function (resolve) {
+		let resolved = false;
+		const doResolve = function () {
+			if (resolved) return;
+			resolved = true;
+			resolve();
+		};
+
+		const verifyCSSOM = function () {
+			try {
+				const sheets = Array.from(document.styleSheets);
+				return sheets.some(function (sheet) {
+					return (
+						sheet.href &&
+						sheet.href.includes(newHref.split('?')[0]!)
+					);
+				});
+			} catch {
+				return false;
+			}
+		};
+
+		linkElement.onload = function () {
+			let checkCount = 0;
+			const checkCSSOM = function () {
+				checkCount++;
+				if (verifyCSSOM() || checkCount > 10) {
+					doResolve();
+				} else {
+					requestAnimationFrame(checkCSSOM);
+				}
+			};
+			requestAnimationFrame(checkCSSOM);
+		};
+
+		linkElement.onerror = function () {
+			setTimeout(function () {
+				doResolve();
+			}, 50);
+		};
+
+		setTimeout(function () {
+			if (linkElement.sheet && !resolved) {
+				doResolve();
+			}
+		}, 100);
+
+		setTimeout(function () {
+			if (!resolved) {
+				doResolve();
+			}
+		}, 500);
+	});
+};
+
+/* Coordinate CSS load with body update: waits for CSS, patches body,
+   activates new CSS, removes old CSS. Handles first-update delay. */
+export const waitForCSSAndUpdate = (
+	cssResult: CSSUpdateResult,
+	updateBody: () => void
+) => {
+	const { linksToActivate, linksToRemove, linksToWaitFor } = cssResult;
+
+	if (linksToWaitFor.length > 0) {
+		Promise.all(linksToWaitFor).then(function () {
+			setTimeout(function () {
+				requestAnimationFrame(function () {
+					requestAnimationFrame(function () {
+						requestAnimationFrame(function () {
+							updateBody();
+							linksToActivate.forEach(function (link) {
+								link.media = 'all';
+							});
+							requestAnimationFrame(function () {
+								linksToRemove.forEach(function (link) {
+									if (link.parentNode) {
+										link.remove();
+									}
+								});
+								if (hmrState.isFirstHMRUpdate) {
+									hmrState.isFirstHMRUpdate = false;
+								}
+							});
+						});
+					});
+				});
+			}, 50);
+		});
+	} else {
+		const doUpdate = function () {
+			requestAnimationFrame(function () {
+				requestAnimationFrame(function () {
+					requestAnimationFrame(function () {
+						updateBody();
+						requestAnimationFrame(function () {
+							linksToRemove.forEach(function (link) {
+								if (link.parentNode) {
+									link.remove();
+								}
+							});
+						});
+					});
+				});
+			});
+		};
+
+		if (hmrState.isFirstHMRUpdate) {
+			hmrState.isFirstHMRUpdate = false;
+			setTimeout(doUpdate, 50);
+		} else {
+			doUpdate();
+		}
+	}
+};