@absolutejs/absolute 0.14.0 → 0.15.0

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './build';
+export * from './client';
+export * from './messages';
+export * from './websocket';

package/dist/types/messages.d.ts

@@ -0,0 +1,138 @@
+export type PingMessage = {
+    type: 'ping';
+};
+export type ReadyMessage = {
+    type: 'ready';
+    framework?: string | null;
+};
+export type RequestRebuildMessage = {
+    type: 'request-rebuild';
+};
+export type HydrationErrorMessage = {
+    type: 'hydration-error';
+    data?: {
+        componentName?: string;
+        componentPath?: string;
+        error?: string;
+    };
+};
+export type HMRClientMessage = PingMessage | ReadyMessage | RequestRebuildMessage | HydrationErrorMessage;
+export type ManifestMessage = {
+    type: 'manifest';
+    data: {
+        manifest: Record<string, string>;
+        serverVersions?: Record<string, number>;
+    };
+    timestamp: number;
+};
+export type RebuildStartMessage = {
+    type: 'rebuild-start';
+    data: {
+        affectedFrameworks: string[];
+    };
+    timestamp: number;
+};
+export type RebuildCompleteMessage = {
+    type: 'rebuild-complete';
+    data: {
+        affectedFrameworks: string[];
+        manifest: Record<string, string>;
+    };
+    timestamp: number;
+};
+export type FrameworkUpdateMessage = {
+    type: 'framework-update';
+    data: {
+        framework: string;
+        manifest?: Record<string, string>;
+    };
+    timestamp: number;
+};
+export type ModuleUpdateMessage = {
+    type: 'module-update';
+    data: {
+        framework: string;
+        manifest?: Record<string, string>;
+        modules?: Array<{
+            sourceFile: string;
+            moduleKeys: string[];
+            modulePaths: Record<string, string>;
+            componentType?: 'client' | 'server';
+            version?: number;
+        }>;
+        moduleVersions?: Record<string, number>;
+        serverVersions?: Record<string, number>;
+    };
+    timestamp: number;
+};
+export type ReactUpdateMessage = {
+    type: 'react-update';
+    data: {
+        sourceFile: string;
+        html?: string;
+        manifest?: Record<string, string>;
+    };
+    timestamp: number;
+};
+export type HTMLUpdateMessage = {
+    type: 'html-update';
+    data: {
+        sourceFile: string;
+        html?: string;
+    };
+    timestamp: number;
+};
+export type HTMXUpdateMessage = {
+    type: 'htmx-update';
+    data: {
+        sourceFile: string;
+        html?: string;
+    };
+    timestamp: number;
+};
+export type SvelteUpdateMessage = {
+    type: 'svelte-update';
+    data: {
+        sourceFile: string;
+        html?: string;
+        manifest?: Record<string, string>;
+        cssUrl?: string;
+        cssBaseName?: string;
+        updateType?: string;
+    };
+    timestamp: number;
+};
+export type VueUpdateMessage = {
+    type: 'vue-update';
+    data: {
+        sourceFile: string;
+        html?: string;
+        manifest?: Record<string, string>;
+        hmrId?: string;
+        changeType?: 'style-only' | 'template-only' | 'script' | 'full';
+        componentPath?: string;
+        cssUrl?: string;
+        cssBaseName?: string;
+        updateType?: 'css-only' | 'full';
+    };
+    timestamp: number;
+};
+export type RebuildErrorMessage = {
+    type: 'rebuild-error';
+    data: {
+        affectedFrameworks: string[];
+        error: string;
+    };
+    timestamp: number;
+};
+export type PongMessage = {
+    type: 'pong';
+    timestamp: number;
+};
+export type ConnectedMessage = {
+    type: 'connected';
+    message?: string;
+    timestamp: number;
+};
+export type HMRServerMessage = ManifestMessage | RebuildStartMessage | RebuildCompleteMessage | FrameworkUpdateMessage | ModuleUpdateMessage | ReactUpdateMessage | HTMLUpdateMessage | HTMXUpdateMessage | SvelteUpdateMessage | VueUpdateMessage | RebuildErrorMessage | PongMessage | ConnectedMessage;
+export declare const isValidHMRClientMessage: (data: unknown) => data is HMRClientMessage;

package/dist/types/websocket.d.ts

@@ -0,0 +1,6 @@
+export declare const WS_READY_STATE_OPEN = 1;
+export interface HMRWebSocket {
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    readyState: number;
+}

package/eslint.config.mjs

@@ -35,9 +35,13 @@ export default defineConfig([
 		files: ['**/*.{ts,tsx}'],
 		languageOptions: {
 			globals: {
+				...globals.node,
 				// TODO: These should only be applied to the src/core/build.ts file.
 				BuildMessage: 'readonly',
-				ResolveMessage: 'readonly'
+				ResolveMessage: 'readonly',
+				NodeJS: 'readonly',
+				Bun: 'readonly',
+				Buffer: 'readonly'
 			},
 			parser: tsParser,
 			parserOptions: {

package/package.json

@@ -4,15 +4,18 @@
 		"absolutejs": "./dist/cli/index.js"
 	},
 	"description": "A fullstack meta-framework for building web applications with TypeScript",
+	"engines": {
+		"bun": ">=1.3.6"
+	},
 	"devDependencies": {
-		"@elysiajs/static": "1.3.0",
+		"@elysiajs/static": "1.4.0",
 		"@stylistic/eslint-plugin-ts": "4.2.0",
 		"@tailwindcss/cli": "4.1.7",
-		"@types/bun": "latest",
-		"@types/react": "19.1.5",
-		"@types/react-dom": "19.1.5",
+		"@types/bun": "^1.2.18",
+		"@types/react": "19.2.0",
+		"@types/react-dom": "19.2.0",
 		"autoprefixer": "10.4.21",
-		"elysia": "1.3.1",
+		"elysia": "1.4.18",
 		"elysia-scoped-state": "0.1.1",
 		"eslint": "9.26.0",
 		"eslint-plugin-absolute": "0.1.4",
@@ -22,20 +25,21 @@
 		"postcss": "8.5.3",
 		"prettier": "3.5.3",
 		"prettier-plugin-svelte": "3.4.0",
-		"react": "19.1.0",
+		"react": "19.2.1",
+		"react-dom": "19.2.1",
+		"react-refresh": "^0.18.0",
 		"svelte": "5.35.2",
 		"tailwindcss": "4.1.7",
 		"typescript": "5.8.3",
 		"typescript-eslint": "8.32.0",
 		"vue": "3.5.27"
 	},
-	"license": "CC BY-NC 4.0",
+	"license": "BSL-1.1",
 	"main": "./dist/index.js",
 	"name": "@absolutejs/absolute",
 	"peerDependencies": {
-		"elysia": "^1.3.0",
+		"elysia": "^1.4.0",
 		"react": "^19.1.0",
-		"react-dom": "^19.1.0",
 		"svelte": "^5.35.2",
 		"vue": "^3.5.27"
 	},
@@ -47,13 +51,14 @@
 		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external react --external react-dom --external vue --external @vue/compiler-sfc --external svelte --external elysia && bun build src/cli/index.ts --outfile dist/cli/index.js --target=bun && tsc --emitDeclarationOnly --project tsconfig.build.json",
 		"db:push": "drizzle-kit push",
 		"db:studio": "drizzle-kit studio",
-		"dev": "bun src/cli/index.ts dev example/server.ts",
+		"dev": "bun run src/cli/index.ts dev example/server.ts",
+		"start": "NODE_ENV=production bun run example/server.ts",
 		"format": "prettier --write \"./**/*.{js,jsx,ts,tsx,css,json,mjs,md,svelte,html,vue}\"",
 		"lint": "eslint ./",
 		"release": "bun run format && bun run build && bun publish",
-		"test": "echo \"Error: no test specified\" && exit 1",
+		"test": "bun test",
 		"typecheck": "bun run tsc --noEmit"
 	},
 	"types": "./dist/index.d.ts",
-	"version": "0.14.0"
+	"version": "0.15.0"
 }

package/tsconfig.build.json

@@ -15,6 +15,6 @@
 		"strict": true,
 		"target": "ESNext"
 	},
-	"exclude": ["node_modules"],
+	"exclude": ["node_modules", "src/dev/client"],
 	"include": ["src/**/*"]
 }

package/types/build.ts

@@ -0,0 +1,46 @@
+import { ComponentType as ReactComponent } from 'react';
+import { Component as SvelteComponent } from 'svelte';
+import { Component as VueComponent } from 'vue';
+
+export type BuildOptions = {
+	preserveIntermediateFiles?: boolean;
+	/** When true, build() throws on error instead of exit(1) - used by HMR rebuilds */
+	throwOnError?: boolean;
+	hmr?: {
+		debounceMs?: number;
+	};
+};
+
+export type BuildConfig = {
+	buildDirectory?: string;
+	assetsDirectory?: string;
+	publicDirectory?: string;
+	reactDirectory?: string;
+	vueDirectory?: string;
+	angularDirectory?: string;
+	astroDirectory?: string;
+	svelteDirectory?: string;
+	htmlDirectory?: string;
+	htmxDirectory?: string;
+	tailwind?: {
+		input: string;
+		output: string;
+	};
+	options?: BuildOptions;
+	// Optional: List of files to rebuild incrementally (absolute paths)
+	// When provided, only these files and their dependencies will be rebuilt
+	incrementalFiles?: string[];
+};
+
+export type PropsOf<Component> =
+	Component extends ReactComponent<infer Props>
+		? Props
+		: Component extends SvelteComponent<infer Props>
+			? Props
+			: Component extends VueComponent<infer Props>
+				? Props
+				: Record<string, never>;
+
+export type PropsArgs<C> = keyof PropsOf<C> extends never ? [] : [PropsOf<C>];
+
+export type Prettify<T> = { [K in keyof T]: T[K] } & {};

package/types/client.ts

@@ -0,0 +1,109 @@
+/* Client-side HMR type definitions */
+
+export interface ErrorOverlayOptions {
+	column?: number;
+	file?: string;
+	framework?: string;
+	line?: number;
+	lineText?: string;
+	message?: string;
+}
+
+export interface DOMStateEntry {
+	checked?: boolean;
+	id?: string;
+	idx: number;
+	name?: string;
+	open?: boolean;
+	selEnd?: number;
+	selStart?: number;
+	selected?: boolean;
+	tag: string;
+	text?: string;
+	type?: string;
+	value?: string;
+	values?: string[];
+}
+
+export interface DOMStateSnapshot {
+	activeKey: string | null;
+	items: DOMStateEntry[];
+}
+
+export interface SavedComponentState {
+	count: number;
+}
+
+export interface SavedState {
+	componentState: SavedComponentState;
+	forms: Record<string, Record<string, boolean | string>>;
+	scroll: { window: { x: number; y: number } };
+}
+
+export interface ScriptInfo {
+	src: string;
+	type: string;
+}
+
+export interface CSSUpdateResult {
+	linksToActivate: HTMLLinkElement[];
+	linksToRemove: HTMLLinkElement[];
+	linksToWaitFor: Promise<void>[];
+}
+
+/* Shared mutable state for the HMR client */
+export const hmrState = {
+	isConnected: false,
+	isFirstHMRUpdate: true,
+	isHMRUpdating: false,
+	pingInterval: null as ReturnType<typeof setInterval> | null,
+	reconnectTimeout: null as ReturnType<typeof setTimeout> | null
+};
+
+/* Window interface extensions for HMR globals */
+declare global {
+	interface Window {
+		$RefreshReg$?: (type: unknown, id: string) => void;
+		$RefreshRuntime$?: {
+			createSignatureFunctionForTransform: () => (
+				type: unknown
+			) => unknown;
+			injectIntoGlobalHook: (win: Window) => void;
+			performReactRefresh: () => void;
+			register: (type: unknown, id: string) => void;
+		};
+		$RefreshSig$?: () => (type: unknown) => unknown;
+		__HMR_DOM_STATE__?: { count?: number; [key: string]: unknown };
+		__HMR_FRAMEWORK__?: string;
+		__HMR_MANIFEST__?: Record<string, string>;
+		__HMR_MODULE_UPDATES__?: Array<unknown>;
+		__HMR_MODULE_VERSIONS__?: Record<string, number>;
+		__HMR_PRESERVED_STATE__?: Record<string, unknown>;
+		__HMR_SERVER_VERSIONS__?: Record<string, number>;
+		__HMR_UPDATE_COUNT__?: number;
+		__HMR_WS__?: WebSocket;
+		__INITIAL_PROPS__?: Record<string, unknown>;
+		__REACT_ROOT__?: { render: (element: unknown) => void };
+		__SVELTE_COMPONENT__?: Record<string, unknown>;
+		__SVELTE_UNMOUNT__?: () => void;
+		__VUE_APP__?:
+			| ({
+					unmount: () => void;
+					_instance?: {
+						setupState?: Record<string, unknown>;
+						subTree?: {
+							children?: unknown[];
+							component?: {
+								setupState?: Record<string, unknown>;
+								subTree?: unknown;
+							};
+						};
+					};
+			  } & Record<string, unknown>)
+			| null;
+		__VUE_HMR_COMPONENTS__?: Record<string, unknown>;
+		htmx?: { process: (element: HTMLElement | Document) => void };
+	}
+}
+
+export {};

package/types/index.ts

@@ -0,0 +1,4 @@
+export * from './build';
+export * from './client';
+export * from './messages';
+export * from './websocket';

package/types/messages.ts

@@ -0,0 +1,205 @@
+/* HMR message types for client-server communication */
+
+/* Client-to-server message types */
+export type PingMessage = {
+	type: 'ping';
+};
+
+export type ReadyMessage = {
+	type: 'ready';
+	framework?: string | null;
+};
+
+export type RequestRebuildMessage = {
+	type: 'request-rebuild';
+};
+
+export type HydrationErrorMessage = {
+	type: 'hydration-error';
+	data?: {
+		componentName?: string;
+		componentPath?: string;
+		error?: string;
+	};
+};
+
+export type HMRClientMessage =
+	| PingMessage
+	| ReadyMessage
+	| RequestRebuildMessage
+	| HydrationErrorMessage;
+
+/* Server-to-client message types */
+export type ManifestMessage = {
+	type: 'manifest';
+	data: {
+		manifest: Record<string, string>;
+		serverVersions?: Record<string, number>;
+	};
+	timestamp: number;
+};
+
+export type RebuildStartMessage = {
+	type: 'rebuild-start';
+	data: {
+		affectedFrameworks: string[];
+	};
+	timestamp: number;
+};
+
+export type RebuildCompleteMessage = {
+	type: 'rebuild-complete';
+	data: {
+		affectedFrameworks: string[];
+		manifest: Record<string, string>;
+	};
+	timestamp: number;
+};
+
+export type FrameworkUpdateMessage = {
+	type: 'framework-update';
+	data: {
+		framework: string;
+		manifest?: Record<string, string>;
+	};
+	timestamp: number;
+};
+
+export type ModuleUpdateMessage = {
+	type: 'module-update';
+	data: {
+		framework: string;
+		manifest?: Record<string, string>;
+		modules?: Array<{
+			sourceFile: string;
+			moduleKeys: string[];
+			modulePaths: Record<string, string>;
+			componentType?: 'client' | 'server';
+			version?: number;
+		}>;
+		moduleVersions?: Record<string, number>;
+		serverVersions?: Record<string, number>;
+	};
+	timestamp: number;
+};
+
+export type ReactUpdateMessage = {
+	type: 'react-update';
+	data: {
+		sourceFile: string;
+		html?: string;
+		manifest?: Record<string, string>;
+	};
+	timestamp: number;
+};
+
+export type HTMLUpdateMessage = {
+	type: 'html-update';
+	data: {
+		sourceFile: string;
+		html?: string;
+	};
+	timestamp: number;
+};
+
+export type HTMXUpdateMessage = {
+	type: 'htmx-update';
+	data: {
+		sourceFile: string;
+		html?: string;
+	};
+	timestamp: number;
+};
+
+export type SvelteUpdateMessage = {
+	type: 'svelte-update';
+	data: {
+		sourceFile: string;
+		html?: string;
+		manifest?: Record<string, string>;
+		cssUrl?: string;
+		cssBaseName?: string;
+		updateType?: string;
+	};
+	timestamp: number;
+};
+
+export type VueUpdateMessage = {
+	type: 'vue-update';
+	data: {
+		sourceFile: string;
+		html?: string;
+		manifest?: Record<string, string>;
+		// Native Vue HMR fields
+		hmrId?: string;
+		changeType?: 'style-only' | 'template-only' | 'script' | 'full';
+		componentPath?: string;
+		cssUrl?: string;
+		cssBaseName?: string;
+		updateType?: 'css-only' | 'full';
+	};
+	timestamp: number;
+};
+
+export type RebuildErrorMessage = {
+	type: 'rebuild-error';
+	data: {
+		affectedFrameworks: string[];
+		error: string;
+	};
+	timestamp: number;
+};
+
+export type PongMessage = {
+	type: 'pong';
+	timestamp: number;
+};
+
+export type ConnectedMessage = {
+	type: 'connected';
+	message?: string;
+	timestamp: number;
+};
+
+export type HMRServerMessage =
+	| ManifestMessage
+	| RebuildStartMessage
+	| RebuildCompleteMessage
+	| FrameworkUpdateMessage
+	| ModuleUpdateMessage
+	| ReactUpdateMessage
+	| HTMLUpdateMessage
+	| HTMXUpdateMessage
+	| SvelteUpdateMessage
+	| VueUpdateMessage
+	| RebuildErrorMessage
+	| PongMessage
+	| ConnectedMessage;
+
+/* Type guard for client messages */
+export const isValidHMRClientMessage = (
+	data: unknown
+): data is HMRClientMessage => {
+	if (!data || typeof data !== 'object') {
+		return false;
+	}
+
+	const message = data as Record<string, unknown>;
+
+	if (!('type' in message) || typeof message.type !== 'string') {
+		return false;
+	}
+
+	switch (message.type) {
+		case 'ping':
+			return true;
+		case 'ready':
+			return true;
+		case 'request-rebuild':
+			return true;
+		case 'hydration-error':
+			return true;
+		default:
+			return false;
+	}
+};

package/types/websocket.ts

@@ -0,0 +1,12 @@
+/* WebSocket types for HMR */
+
+/* WebSocket ready state constant */
+export const WS_READY_STATE_OPEN = 1;
+
+/* Minimal WebSocket interface for HMR clients
+   Compatible with Elysia's WebSocket implementation */
+export interface HMRWebSocket {
+	send(data: string): void;
+	close(code?: number, reason?: string): void;
+	readyState: number;
+}

package/types/window-globals.ts

@@ -0,0 +1,53 @@
+/* Extend Window interface with HMR-specific globals */
+declare global {
+	interface Window {
+		/* Framework for current page, set at build time in index files */
+		__HMR_FRAMEWORK__?: string;
+
+		/* HMR manifest - maps component names to built file paths */
+		__HMR_MANIFEST__?: Record<string, string>;
+
+		/* Array of pending HMR module updates */
+		__HMR_MODULE_UPDATES__?: Array<unknown>;
+
+		/* Client-side module versions - tracks what version the client has loaded */
+		__HMR_MODULE_VERSIONS__?: Record<string, number>;
+
+		/* Server-side module versions - tracks what version the server has */
+		__HMR_SERVER_VERSIONS__?: Record<string, number>;
+
+		/* React root instance for HMR re-rendering */
+		__REACT_ROOT__?: {
+			render: (element: unknown) => void;
+		};
+
+		/* Initial props passed to React component */
+		__INITIAL_PROPS__?: Record<string, unknown>;
+
+		/* Preserved state across HMR updates */
+		__HMR_PRESERVED_STATE__?: Record<string, unknown>;
+
+		/* Update counter for debugging */
+		__HMR_UPDATE_COUNT__?: number;
+
+		/* Svelte component instance */
+		__SVELTE_COMPONENT__?: Record<string, unknown>;
+
+		/* Svelte unmount function (closure over current runtime + component) */
+		__SVELTE_UNMOUNT__?: () => void;
+
+		/* WebSocket instance for HMR */
+		__HMR_WS__?: WebSocket;
+
+		/* HTMX global (if HTMX is loaded) */
+		htmx?: {
+			process: (element: HTMLElement | Document) => void;
+		};
+
+		/* DOM state preserved during HTML/HTMX HMR updates */
+		__HMR_DOM_STATE__?: { count?: number; [key: string]: unknown };
+	}
+}
+
+/* Export empty object to make this a module */
+export {};

package/dist/build/compileVue.d.ts

@@ -1,5 +0,0 @@
-export declare const compileVue: (entryPoints: string[], vueRootDir: string) => Promise<{
-    vueCssPaths: string[];
-    vueIndexPaths: string[];
-    vueServerPaths: string[];
-}>;

package/dist/build/generateReactIndexes.d.ts

@@ -1 +0,0 @@
-export declare const generateReactIndexFiles: (reactPagesDirectory: string, reactIndexesDirectory: string) => Promise<void>;

package/dist/core/lookup.d.ts

@@ -1 +0,0 @@
-export declare const asset: (manifest: Record<string, string>, name: string) => string;

package/dist/utils/networking.d.ts

@@ -1 +0,0 @@
-export declare const getLocalIPAddress: () => string;