@abs-test/absolutejs-test 0.1.0

package/dist/src/utils/normalizePath.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Normalize file paths to use forward slashes for cross-platform compatibility.
+ * Windows uses backslashes, but this codebase standardizes on forward slashes.
+ */
+export declare const normalizePath: (path: string) => string;
+/**
+ * Normalize all paths in an array.
+ */
+export declare const normalizePaths: (paths: string[]) => string[];

package/dist/src/utils/registerClientScript.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Utility for registering client-side scripts that need to run after Angular SSR hydration.
+ *
+ * This is necessary because Angular's lifecycle hooks don't always run reliably on the client
+ * after SSR hydration, especially for event listeners attached to DOM elements.
+ *
+ * Usage in Angular components:
+ * ```typescript
+ * import { registerClientScript } from '@absolutejs/absolute';
+ *
+ * // Register an event listener script
+ * registerClientScript(() => {
+ *   const element = document.querySelector('.my-element');
+ *   if (element) {
+ *     element.addEventListener('click', () => {
+ *       console.log('Clicked!');
+ *     });
+ *   }
+ * });
+ * ```
+ *
+ * The script will be automatically injected into the HTML response and executed on the client.
+ */
+/**
+ * Register a client-side script to be injected into the HTML response.
+ *
+ * @param script - A function containing the client-side code to execute
+ * @param requestId - Optional request ID. If not provided, uses the current request context.
+ * @returns The request ID for this script registration
+ */
+export declare const registerClientScript: (script: () => void, requestId?: string) => any;
+/**
+ * Get all registered scripts for a request and clear them.
+ * This is called by the page handler after rendering.
+ *
+ * @param requestId - The request ID to get scripts for
+ * @returns Array of script functions, or empty array if none registered
+ */
+export declare const getAndClearClientScripts: (requestId: string) => (() => void)[];
+/**
+ * Generate JavaScript code from registered scripts.
+ * Wraps each script in an IIFE and combines them.
+ *
+ * @param scripts - Array of script functions
+ * @returns JavaScript code string to inject
+ */
+export declare const generateClientScriptCode: (scripts: (() => void)[]) => string;
+/**
+ * Clear all registered scripts (useful for cleanup or testing)
+ */
+export declare const clearAllClientScripts: () => void;

package/dist/src/utils/stringModifiers.d.ts

@@ -0,0 +1,2 @@
+export declare const toPascal: (str: string) => string;
+export declare const toKebab: (str: string) => string;

package/dist/src/utils/validateSafePath.d.ts

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

package/dist/types/build.d.ts

@@ -0,0 +1,41 @@
+import { ComponentType as ReactComponent } from 'react';
+import { Component as SvelteComponent } from 'svelte';
+import { Component as VueComponent } from 'vue';
+import { build } from '../src/core/build';
+import { devBuild } from '../src/core/devBuild';
+export type BuildOptions = {
+    preserveIntermediateFiles?: boolean;
+    /** When true, build() throws on error instead of exit(1) - used by HMR rebuilds */
+    throwOnError?: boolean;
+    /** When true, HMR client code is injected into built assets. Set by devBuild(). */
+    injectHMR?: 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;
+    incrementalFiles?: string[];
+};
+export type BuildResult = ReturnType<typeof build>;
+export type DevBuildResult = ReturnType<typeof devBuild>;
+export type Result = BuildResult | DevBuildResult;
+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/dist/types/client.d.ts

@@ -0,0 +1,108 @@
+export interface ErrorOverlayOptions {
+    column?: number;
+    file?: string;
+    framework?: string;
+    kind?: 'compilation' | 'runtime';
+    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>[];
+}
+export declare const hmrState: {
+    isConnected: boolean;
+    isFirstHMRUpdate: boolean;
+    isHMRUpdating: boolean;
+    pingInterval: ReturnType<typeof setInterval> | null;
+    reconnectTimeout: ReturnType<typeof setTimeout> | null;
+};
+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;
+        __ERROR_BOUNDARY__?: {
+            reset: () => void;
+        };
+        __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/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

@@ -0,0 +1,238 @@
+// eslint.config.mjs
+import { dirname } from 'path';
+import { fileURLToPath } from 'url';
+import pluginJs from '@eslint/js';
+import stylisticTs from '@stylistic/eslint-plugin-ts';
+import tsParser from '@typescript-eslint/parser';
+import { defineConfig } from 'eslint/config';
+import absolutePlugin from 'eslint-plugin-absolute';
+import importPlugin from 'eslint-plugin-import';
+import promisePlugin from 'eslint-plugin-promise';
+import securityPlugin from 'eslint-plugin-security';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig([
+	{
+		ignores: [
+			'dist/**',
+			'**/compiled/**',
+			'**/*/htmx.*.min.js',
+			'example/build/**',
+			'tailwind.config.ts',
+			'postcss.config.ts',
+			'example/react/indexes/*'
+		]
+	},
+
+	pluginJs.configs.recommended,
+
+	...tseslint.configs.recommended,
+
+	{
+		files: ['**/*.{ts,tsx}'],
+		languageOptions: {
+			globals: {
+				...globals.node,
+				// TODO: These should only be applied to the src/core/build.ts file.
+				BuildMessage: 'readonly',
+				ResolveMessage: 'readonly',
+				NodeJS: 'readonly',
+				Bun: 'readonly',
+				Buffer: 'readonly'
+			},
+			parser: tsParser,
+			parserOptions: {
+				createDefaultProgram: true,
+				project: './tsconfig.json',
+				tsconfigRootDir: __dirname
+			}
+		},
+		plugins: { '@stylistic/ts': stylisticTs },
+		rules: {
+			'@stylistic/ts/padding-line-between-statements': [
+				'error',
+				{ blankLine: 'always', next: 'return', prev: '*' }
+			],
+
+			'@typescript-eslint/no-unnecessary-type-assertion': 'error'
+		}
+	},
+	{
+		files: ['**/*.{js,mjs,cjs,json,ts,tsx,jsx}'],
+		ignores: ['node_modules/**'],
+		languageOptions: {
+			globals: {
+				...globals.browser
+			}
+		},
+		plugins: {
+			absolute: absolutePlugin,
+			import: importPlugin,
+			promise: promisePlugin,
+			security: securityPlugin
+		},
+		rules: {
+			'absolute/explicit-object-types': 'error',
+			'absolute/localize-react-props': 'error',
+			'absolute/max-depth-extended': ['error', 1],
+			'absolute/max-jsxnesting': ['error', 5],
+			'absolute/min-var-length': [
+				'error',
+				{ allowedVars: ['_', 'id', 'db', 'OK'], minLength: 3 }
+			],
+			'absolute/no-explicit-return-type': 'error',
+			'absolute/no-useless-function': 'error',
+			'absolute/sort-exports': [
+				'error',
+				{
+					caseSensitive: true,
+					natural: true,
+					order: 'asc',
+					variablesBeforeFunctions: true
+				}
+			],
+			'absolute/sort-keys-fixable': [
+				'error',
+				{
+					caseSensitive: true,
+					natural: true,
+					order: 'asc',
+					variablesBeforeFunctions: true
+				}
+			],
+			'arrow-body-style': ['error', 'as-needed'],
+			'consistent-return': 'error',
+			eqeqeq: 'error',
+			'func-style': [
+				'error',
+				'expression',
+				{ allowArrowFunctions: true }
+			],
+			'import/no-cycle': 'error',
+			'import/no-default-export': 'error',
+			'import/no-relative-packages': 'error',
+			'import/no-unused-modules': ['error', { missingExports: true }],
+			'import/order': ['error', { alphabetize: { order: 'asc' } }],
+			'no-await-in-loop': 'error',
+			'no-debugger': 'error',
+			'no-duplicate-case': 'error',
+			'no-duplicate-imports': 'error',
+			'no-else-return': 'error',
+			'no-empty-function': 'error',
+			'no-empty-pattern': 'error',
+			'no-empty-static-block': 'error',
+			'no-fallthrough': 'error',
+			'no-floating-decimal': 'error',
+			'no-global-assign': 'error',
+			'no-implicit-coercion': 'error',
+			'no-implicit-globals': 'error',
+			'no-loop-func': 'error',
+			'no-magic-numbers': [
+				'warn',
+				{ detectObjects: false, enforceConst: true, ignore: [0, 1, 2] }
+			],
+			'no-misleading-character-class': 'error',
+			'no-nested-ternary': 'error',
+			'no-new-native-nonconstructor': 'error',
+			'no-new-wrappers': 'error',
+			'no-param-reassign': 'error',
+			'no-restricted-imports': [
+				'error',
+				{
+					paths: [
+						{
+							importNames: ['default'],
+							message:
+								'Import only named React exports for tree-shaking.',
+							name: 'react'
+						},
+						{
+							importNames: ['default'],
+							message: 'Import only the required Bun exports.',
+							name: 'bun'
+						}
+					]
+				}
+			],
+			'no-return-await': 'error',
+			'no-shadow': 'error',
+			'no-undef': 'error',
+			'no-unneeded-ternary': 'error',
+			'no-unreachable': 'error',
+			'no-useless-assignment': 'error',
+			'no-useless-concat': 'error',
+			'no-useless-return': 'error',
+			'no-var': 'error',
+			'prefer-arrow-callback': 'error',
+			'prefer-const': 'error',
+			'prefer-destructuring': [
+				'error',
+				{ array: true, object: true },
+				{ enforceForRenamedProperties: false }
+			],
+			'prefer-template': 'error',
+			'promise/always-return': 'warn',
+			'promise/avoid-new': 'warn',
+			'promise/catch-or-return': 'error',
+			'promise/no-callback-in-promise': 'warn',
+			'promise/no-nesting': 'warn',
+			'promise/no-promise-in-callback': 'warn',
+			'promise/no-return-wrap': 'error',
+			'promise/param-names': 'error'
+		}
+	},
+	{
+		//TODO: Add official eslint support for Svelte.
+		files: ['**/*.svelte.ts'],
+		languageOptions: {
+			globals: {
+				$derived: 'readonly',
+				$effect: 'readonly',
+				$props: 'readonly',
+				$state: 'readonly'
+			}
+		}
+	},
+	{
+		files: ['eslint.config.mjs', 'src/constants.ts'],
+		rules: {
+			'no-magic-numbers': 'off'
+		}
+	},
+	{
+		files: ['eslint.config.mjs'],
+		rules: {
+			'import/no-default-export': 'off'
+		}
+	},
+	{
+		files: [
+			'src/utils/index.ts',
+			'src/plugins/index.ts',
+			'src/core/index.ts',
+			'src/index.ts',
+			'example/html/scripts/*',
+			'tsconfig.json',
+			'tsconfig.build.json',
+			'package.json',
+			'.prettierrc.json'
+		],
+		rules: {
+			'import/no-unused-modules': 'off'
+		}
+	},
+	{
+		files: [
+			'tsconfig.json',
+			'tsconfig.build.json',
+			'package.json',
+			'.prettierrc.json'
+		],
+		rules: {
+			'@typescript-eslint/no-unused-expressions': 'off'
+		}
+	}
+]);

package/package.json

@@ -0,0 +1,67 @@
+{
+	"author": "Eugene Graves III",
+	"bin": {
+		"absolutejs": "dist/cli/index.js"
+	},
+	"description": "Testing Ajs",
+	"engines": {
+		"bun": ">=1.3.6"
+	},
+	"devDependencies": {
+		"@elysiajs/static": "1.4.0",
+		"@stylistic/eslint-plugin-ts": "4.2.0",
+		"@tailwindcss/cli": "4.1.7",
+		"@types/bun": "1.3.9",
+		"@types/react": "19.2.0",
+		"@types/react-dom": "19.2.0",
+		"autoprefixer": "10.4.21",
+		"elysia": "1.4.18",
+		"elysia-scoped-state": "0.1.1",
+		"eslint": "9.26.0",
+		"eslint-plugin-absolute": "0.1.4",
+		"eslint-plugin-import": "2.31.0",
+		"eslint-plugin-promise": "7.2.1",
+		"eslint-plugin-security": "3.0.1",
+		"postcss": "8.5.3",
+		"prettier": "3.5.3",
+		"prettier-plugin-svelte": "3.4.0",
+		"react": "19.2.1",
+		"react-dom": "19.2.1",
+		"svelte": "5.35.2",
+		"tailwindcss": "4.1.7",
+		"typescript": "5.8.3",
+		"typescript-eslint": "8.32.0",
+		"vue": "3.5.27"
+	},
+	"dependencies": {
+		"react-refresh": "^0.18.0"
+	},
+	"license": "BSL-1.1",
+	"main": "./dist/index.js",
+	"name": "@abs-test/absolutejs-test",
+	"peerDependencies": {
+		"elysia": "^1.4.0",
+		"react": "^19.2.0",
+		"react-dom": "^19.2.0",
+		"svelte": "^5.35.2",
+		"vue": "^3.5.27"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/absolutejs/absolutejs.git"
+	},
+	"scripts": {
+		"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 && mkdir -p dist/dev && cp -r src/dev/client dist/dev/client",
+		"db:push": "drizzle-kit push",
+		"db:studio": "drizzle-kit studio",
+		"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": "bun test",
+		"typecheck": "bun run tsc --noEmit"
+	},
+	"types": "./dist/src/index.d.ts",
+	"version": "0.1.0"
+}

package/tsconfig.build.json

@@ -0,0 +1,20 @@
+{
+	"compilerOptions": {
+		"allowJs": true,
+		"declaration": true,
+		"esModuleInterop": true,
+		"forceConsistentCasingInFileNames": true,
+		"jsx": "react-jsx",
+		"lib": ["DOM", "DOM.Iterable", "ESNext"],
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"noImplicitAny": true,
+		"noUncheckedIndexedAccess": true,
+		"outDir": "dist",
+		"skipLibCheck": true,
+		"strict": true,
+		"target": "ESNext"
+	},
+	"exclude": ["node_modules", "src/dev/client"],
+	"include": ["src/**/*"]
+}