@absolutejs/absolute 0.13.11 → 0.15.0

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

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

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;