@cruxjs/client 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Maysara Elshewehy (https://github.com/maysara-elshewehy)
+
+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/README.md

@@ -0,0 +1,408 @@
+<!-- ╔══════════════════════════════ BEG ══════════════════════════════╗ -->
+
+<br>
+<div align="center">
+    <p>
+        <img src="./assets/img/logo.png" alt="logo" style="" height="80" />
+    </p>
+</div>
+
+<div align="center">
+    <img src="https://img.shields.io/badge/v-0.0.1-black"/>
+    <img src="https://img.shields.io/badge/🔥-@cruxjs-black"/>
+    <br>
+    <img src="https://img.shields.io/badge/coverage----%25-brightgreen" alt="Test Coverage" />
+    <img src="https://img.shields.io/github/issues/cruxjs/client?style=flat" alt="Github Repo Issues" />
+    <img src="https://img.shields.io/github/stars/cruxjs/client?style=social" alt="GitHub Repo stars" />
+</div>
+<br>
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->
+
+
+
+<!-- ╔══════════════════════════════ DOC ══════════════════════════════╗ -->
+
+- ## Quick Start 🔥
+
+    > **_Pure management layer for client-side applications. Routing, lifecycle, events, and viewport management without dictating your architecture._**
+
+    - ### Setup
+
+        > install [`hmm`](https://github.com/minejs-org/hmm) first.
+
+        ```bash
+        hmm i @cruxjs/client
+        ```
+
+    <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+    - ### Usage
+
+        ```ts
+        import { ClientManager } from '@cruxjs/client';
+        import type { ClientManagerConfig } from '@cruxjs/client';
+        ```
+
+        - ### 1. Basic Setup
+
+            > Create your page components:
+
+            ```typescript
+            import { ClientManager } from '@cruxjs/client';
+
+            // Your components (you build these)
+            const HomePage = () => <div>Welcome Home</div>;
+            const AboutPage = () => <div>About Us</div>;
+            const NotFoundPage = () => <div>404 - Not Found</div>;
+
+            // Create manager with YOUR routes
+            const app = new ClientManager({
+                routes: {
+                    '/': HomePage,
+                    '/about': AboutPage
+                },
+                notFoundComponent: NotFoundPage,
+                debug: true
+            });
+
+            // Boot and ready
+            await app.boot();
+            await app.ready('#app');
+
+            // App is live and routing is reactive
+            ```
+
+        - ### 2. With Lifecycle Hooks
+
+            ```typescript
+            const app = new ClientManager({
+                routes: {
+                    '/': HomePage,
+                    '/about': AboutPage
+                },
+                notFoundComponent: NotFoundPage,
+                debug: true
+            });
+
+            // Setup hooks before booting
+            app.on('onBoot', async () => {
+                console.log('App is booting...');
+                // Load data, initialize services, etc.
+            });
+
+            app.on('onReady', async () => {
+                console.log('App is live!');
+                // Track page views, setup analytics
+            });
+
+            app.on('onDestroy', async () => {
+                console.log('Cleaning up...');
+                // Close connections, cancel requests
+            });
+
+            // Start lifecycle
+            await app.boot();
+            await app.ready('#app');
+
+            // Later, shutdown
+            await app.destroy();
+            ```
+
+        - ### 3. With Event Binding
+
+            ```typescript
+            const app = new ClientManager({
+                routes: { '/': HomePage },
+                notFoundComponent: NotFoundPage
+            });
+
+            // Bind events globally
+            const unsubscribe = app.on(
+                document,
+                'click',
+                (event) => console.log('Document clicked', event)
+            );
+
+            // Or bind to specific elements
+            app.on(
+                document.getElementById('myButton'),
+                'click',
+                () => alert('Button clicked')
+            );
+
+            // Unsubscribe when needed
+            unsubscribe();
+            ```
+
+        - ### 4. With Navigation
+
+            ```typescript
+            const app = new ClientManager({
+                routes: {
+                    '/': HomePage,
+                    '/about': AboutPage,
+                    '/contact': ContactPage
+                },
+                notFoundComponent: NotFoundPage
+            });
+
+            await app.boot();
+            await app.ready('#app');
+
+            // Navigate programmatically
+            app.navigate('/about');
+
+            // Get current path as reactive signal
+            const currentPath = app.getCurrentPath();
+            console.log(currentPath()); // '/about'
+
+            // Create link handlers for anchor tags
+            const handleHomeClick = app.createLinkHandler('/');
+            ```
+
+        - ### 5. With Viewport Reactivity
+
+            ```typescript
+            const app = new ClientManager({
+                routes: { '/': HomePage },
+                notFoundComponent: NotFoundPage
+            });
+
+            await app.boot();
+            await app.ready('#app');
+
+            // Get viewport as reactive signal
+            const viewport = app.getViewport();
+
+            // Subscribe to viewport changes
+            import { effect } from '@minejs/signals';
+
+            effect(() => {
+                const { width, height } = viewport();
+                console.log(`Viewport: ${width}x${height}`);
+            });
+            ```
+
+    <br>
+
+- ## API Reference 🔥
+
+    ### Core Class
+
+    - #### `ClientManager`
+        > Main class for orchestrating client-side routing, lifecycle, and events
+
+        ```typescript
+        new ClientManager(config: ClientManagerConfig)
+        ```
+
+        **Configuration:**
+        ```typescript
+        interface ClientManagerConfig {
+            // Required: Your page components
+            routes: Record<string, RouteComponent>
+
+            // Optional: 404 fallback component
+            notFoundComponent?: RouteComponent
+
+            // Optional: Enable debug logging
+            debug?: boolean
+        }
+
+        type RouteComponent = () => JSXElement | null;
+        ```
+
+    ### Lifecycle Methods
+
+    - #### `boot(): Promise<void>`
+        > Phase 1: Bootstrap the application
+        > - Calls `onBoot` hook if defined
+        > - Sets lifecycle to 'booting'
+
+        ```typescript
+        await app.boot();
+        ```
+
+    - #### `ready(mountSelector: string | HTMLElement): Promise<void>`
+        > Phase 2: Mount and activate the application
+        > - Mounts router to DOM
+        > - Calls `onReady` hook if defined
+        > - Sets lifecycle to 'ready'
+        > - Enables reactive routing
+
+        ```typescript
+        await app.ready('#app');
+        // or
+        await app.ready(document.getElementById('app'));
+        ```
+
+    - #### `destroy(): Promise<void>`
+        > Phase 3: Shutdown and cleanup
+        > - Calls `onDestroy` hook if defined
+        > - Cleans up managers
+        > - Sets lifecycle to 'destroyed'
+
+        ```typescript
+        await app.destroy();
+        ```
+
+    ### Lifecycle Hooks
+
+    - #### `on(event: 'onBoot' | 'onReady' | 'onDestroy', callback): this`
+        > Register lifecycle hooks
+
+        ```typescript
+        app.on('onBoot', async () => {
+            // Initialize services, load data
+        });
+
+        app.on('onReady', async () => {
+            // Track page views, start animations
+        });
+
+        app.on('onDestroy', async () => {
+            // Cleanup connections
+        });
+        ```
+
+    ### Event Binding
+
+    - #### `on(target, event, handler, options?): () => void`
+        > Bind events to DOM elements with automatic cleanup
+
+        ```typescript
+        const unsubscribe = app.on(
+            document.getElementById('button'),
+            'click',
+            (event) => console.log('Clicked'),
+            { once: true }
+        );
+
+        // Unsubscribe when needed
+        unsubscribe();
+        ```
+
+    - #### `off(target, event, handler): void`
+        > Unbind events
+
+        ```typescript
+        app.off(element, 'click', myHandler);
+        ```
+
+    ### Routing & Navigation
+
+    - #### `navigate(path: string): void`
+        > Navigate to a route
+        > - Updates the router
+        > - Triggers reactive re-render
+        > - Updates current path signal
+
+        ```typescript
+        app.navigate('/about');
+        ```
+
+    - #### `mount(selector: string | HTMLElement): void`
+        > Mount router to DOM element
+        > - Called automatically by `ready()`
+        > - Sets up reactive routing effect
+        > - Handles component rendering
+
+        ```typescript
+        app.mount('#app');
+        ```
+
+    - #### `getCurrentPath(): Signal<string>`
+        > Get current path as reactive signal
+
+        ```typescript
+        const pathSignal = app.getCurrentPath();
+
+        import { effect } from '@minejs/signals';
+        effect(() => {
+            console.log(`Current path: ${pathSignal()}`);
+        });
+        ```
+
+    - #### `createLinkHandler(path: string): (e: MouseEvent) => void`
+        > Create a navigation handler for links
+
+        ```typescript
+        const goHome = app.createLinkHandler('/');
+
+        // Use in template/JSX
+        <a href="/" onClick={goHome}>Home</a>
+        ```
+
+    - #### `getRouter(): Router`
+        > Access the underlying router for advanced usage
+
+        ```typescript
+        const router = app.getRouter();
+        // Use @minejs/browser Router API
+        ```
+
+    ### Manager Access
+
+    - #### `getEventsManager(): EventsManager`
+        > Access the events manager directly
+
+        ```typescript
+        const events = app.getEventsManager();
+        ```
+
+    - #### `getWindowManager(): WindowManager`
+        > Access the window/viewport manager directly
+
+        ```typescript
+        const window = app.getWindowManager();
+        ```
+
+    - #### `getViewport(): Signal<ViewportInfo>`
+        > Get viewport dimensions as reactive signal
+
+        ```typescript
+        const viewport = app.getViewport();
+
+        effect(() => {
+            const { width, height, isMobile } = viewport();
+            console.log(`Size: ${width}x${height}, Mobile: ${isMobile}`);
+        });
+        ```
+
+    ### State Inspection
+
+    - #### `getPhase(): 'booting' | 'ready' | 'destroying' | 'destroyed'`
+        > Get current lifecycle phase
+
+        ```typescript
+        const phase = app.getPhase();
+        if (phase === 'ready') {
+            // App is live
+        }
+        ```
+
+    - #### `isReady(): boolean`
+        > Check if app is in ready phase
+
+        ```typescript
+        if (app.isReady()) {
+            // Safe to use all features
+        }
+        ```
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->
+
+
+
+<!-- ╔══════════════════════════════ END ══════════════════════════════╗ -->
+
+<br>
+
+---
+
+<div align="center">
+    <a href="https://github.com/maysara-elshewehy"><img src="https://img.shields.io/badge/by-Maysara-black"/></a>
+</div>
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var signals=require('@minejs/signals'),browser=require('@minejs/browser');var i=class{constructor(e){this.lifecycle="booting";this.hooks={};this.routeComponents={};this.currentPathSignal=signals.signal(window.location.pathname??"/");this.config=e,this.debug=e.debug??false,this.log("[INIT] Creating ClientManager"),this.routeComponents=e.routes,this.eventsManager=new browser.EventsManager,this.windowManager=new browser.WindowManager;let t=Object.entries(e.routes).map(([o,n])=>({path:o,component:n}));this.router=browser.createRouter({routes:t,notFoundComponent:e.notFoundComponent}),this.router.afterEach(o=>{this.currentPathSignal.set(o.path);}),this.log("[INIT] ClientManager created");}on(e,t,o,n){return typeof e=="string"&&e.startsWith("on")?(this.hooks[e]=t,this):this.eventsManager.on(e,t,o,n)}async boot(){if(this.lifecycle!=="booting"){console.warn("[ClientManager] Already booted or destroyed");return}this.log("\u26A1 Phase: BOOT");try{this.hooks.onBoot&&(this.log("\u2192 Calling onBoot hook"),await this.hooks.onBoot()),this.log("\u2713 BOOT phase complete");}catch(e){throw console.error("[ClientManager] Boot failed:",e),e}}async ready(e){if(this.lifecycle!=="booting"){console.warn("[ClientManager] Cannot ready - not in booting phase");return}this.log("\u26A1 Phase: READY");try{this.mount(e),this.log("\u2192 Router mounted"),this.debug&&(globalThis.__CLIENT_MANAGER__=this,this.log("\u2192 ClientManager available globally")),this.hooks.onReady&&(this.log("\u2192 Calling onReady hook"),await this.hooks.onReady()),this.lifecycle="ready",this.log("\u2713 READY phase complete"),this.log("\u2713 App is ready!");}catch(t){throw console.error("[ClientManager] Ready failed:",t),t}}async destroy(){if(this.lifecycle==="destroyed"){console.warn("[ClientManager] Already destroyed");return}this.lifecycle="destroying",this.log("\u26A1 Phase: DESTROY");try{this.hooks.onDestroy&&(this.log("\u2192 Calling onDestroy hook"),await this.hooks.onDestroy()),this.eventsManager.destroy(),this.windowManager.destroy(),this.lifecycle="destroyed",this.log("\u2713 DESTROY phase complete");}catch(e){throw console.error("[ClientManager] Destroy failed:",e),e}}navigate(e){this.router.push(e);}mount(e){let t=typeof e=="string"?document.querySelector(e):e;if(!t){console.warn("[ClientManager] Mount target not found:",e);return}signals.effect(()=>{let o=this.currentPathSignal(),n=this.routeComponents[o]||this.config.notFoundComponent||null;if(t.innerHTML="",n){let r=n();r instanceof Node&&t.appendChild(r);}else t.innerHTML="<p>No component found for this route</p>";this.log(`\u2192 Route changed to: ${o}`);}),this.log("\u2192 Routing setup complete");}getCurrentPath(){return this.currentPathSignal}createLinkHandler(e){return t=>{t.preventDefault(),this.navigate(e);}}getRouter(){return this.router}off(e,t,o){this.eventsManager.off(e,t,o);}getEventsManager(){return this.eventsManager}getViewport(){return this.windowManager.getViewport()}getWindowManager(){return this.windowManager}getPhase(){return this.lifecycle}isReady(){return this.lifecycle==="ready"}log(e){this.debug&&console.log(`[ClientManager] ${e}`);}};exports.ClientManager=i;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["ClientManager","config","signal","EventsManager","WindowManager","routesArray","path","component","createRouter","to","eventOrTarget","callbackOrEvent","handler","options","err","mountSelector","selector","container","effect","currentPath","Component","node","e","target","event","message"],"mappings":"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","file":"index.cjs","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\r\n// src/index.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n    import { signal, effect } from '@minejs/signals';\r\n    import { EventsManager, Router, WindowManager, createRouter } from '@minejs/browser';\r\n    import * as types from './types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    export class ClientManager {\r\n\r\n        // ┌──────────────────────────────── INIT ──────────────────────────────┐\r\n\r\n            private router              : Router;\r\n            private eventsManager       : EventsManager;\r\n            private windowManager       : WindowManager;\r\n            private lifecycle           : 'booting' | 'ready' | 'destroying' | 'destroyed' = 'booting';\r\n            private config              : types.ClientManagerConfig;\r\n            private hooks               : types.ClientManagerHooks = {};\r\n            private debug               : boolean;\r\n            private routeComponents     : Record<string, types.RouteComponent> = {};\r\n            private currentPathSignal   = signal<string>(window.location.pathname ?? '/');\r\n\r\n            constructor(config: types.ClientManagerConfig) {\r\n                this.config = config;\r\n                this.debug = config.debug ?? false;\r\n\r\n                this.log('[INIT] Creating ClientManager');\r\n\r\n                // Store route components provided by user\r\n                this.routeComponents = config.routes;\r\n\r\n                // Initialize managers from @minejs/browser\r\n                this.eventsManager = new EventsManager();\r\n                this.windowManager = new WindowManager();\r\n\r\n                // Initialize router with user-provided routes\r\n                const routesArray = Object.entries(config.routes).map(([path, component]) => ({\r\n                    path,\r\n                    component\r\n                }));\r\n\r\n                this.router = createRouter({\r\n                    routes: routesArray,\r\n                    notFoundComponent: config.notFoundComponent,\r\n                });\r\n\r\n                // Connect router changes to signal for automatic re-rendering\r\n                this.router.afterEach((to) => {\r\n                    this.currentPathSignal.set(to.path);\r\n                });\r\n\r\n                this.log('[INIT] ClientManager created');\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Setup lifecycle hooks OR bind events\r\n             * Overloaded: on(event: 'onBoot'|'onReady'|'onDestroy', callback) - lifecycle\r\n             *             on(target, event, handler) - event binding\r\n             */\r\n            on(event: keyof types.ClientManagerHooks, callback: any): this;\r\n            on<K extends keyof HTMLElementEventMap>(\r\n                target: EventTarget,\r\n                event: K | string,\r\n                handler: EventListener,\r\n                options?: AddEventListenerOptions\r\n            ): () => void;\r\n            on(\r\n                eventOrTarget: keyof types.ClientManagerHooks | EventTarget,\r\n                callbackOrEvent?: any,\r\n                handler?: EventListener,\r\n                options?: AddEventListenerOptions\r\n            ): this | (() => void) {\r\n                // Check if this is a lifecycle hook call\r\n                if (typeof eventOrTarget === 'string' && eventOrTarget.startsWith('on')) {\r\n                    this.hooks[eventOrTarget as keyof types.ClientManagerHooks] = callbackOrEvent;\r\n                    return this;\r\n                }\r\n\r\n                // Otherwise it's an event binding\r\n                return this.eventsManager.on(\r\n                    eventOrTarget as EventTarget,\r\n                    callbackOrEvent as string,\r\n                    handler as EventListener,\r\n                    options\r\n                );\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Bootstrap the app - Phase 1: BOOT\r\n             */\r\n            async boot(): Promise<void> {\r\n                if (this.lifecycle !== 'booting') {\r\n                    console.warn('[ClientManager] Already booted or destroyed');\r\n                    return;\r\n                }\r\n\r\n                this.log('⚡ Phase: BOOT');\r\n\r\n                try {\r\n                    // Call user onBoot hook\r\n                    if (this.hooks.onBoot) {\r\n                        this.log('→ Calling onBoot hook');\r\n                        await this.hooks.onBoot();\r\n                    }\r\n\r\n                    this.log('✓ BOOT phase complete');\r\n                } catch (err) {\r\n                    console.error('[ClientManager] Boot failed:', err);\r\n                    throw err;\r\n                }\r\n            }\r\n\r\n            /**\r\n             * Ready the app - Phase 2: READY\r\n             * Mount to DOM and make everything live\r\n             */\r\n            async ready(mountSelector: string | HTMLElement): Promise<void> {\r\n                if (this.lifecycle !== 'booting') {\r\n                    console.warn('[ClientManager] Cannot ready - not in booting phase');\r\n                    return;\r\n                }\r\n\r\n                this.log('⚡ Phase: READY');\r\n\r\n                try {\r\n                    // Mount router\r\n                    this.mount(mountSelector);\r\n                    this.log('→ Router mounted');\r\n\r\n                    // Setup global access for debugging\r\n                    if (this.debug) {\r\n                        (globalThis as any).__CLIENT_MANAGER__ = this;\r\n                        this.log('→ ClientManager available globally');\r\n                    }\r\n\r\n                    // Call user onReady hook\r\n                    if (this.hooks.onReady) {\r\n                        this.log('→ Calling onReady hook');\r\n                        await this.hooks.onReady();\r\n                    }\r\n\r\n                    this.lifecycle = 'ready';\r\n                    this.log('✓ READY phase complete');\r\n                    this.log('✓ App is ready!');\r\n                } catch (err) {\r\n                    console.error('[ClientManager] Ready failed:', err);\r\n                    throw err;\r\n                }\r\n            }\r\n\r\n            /**\r\n             * Shutdown the app - Phase 3: DESTROY\r\n             */\r\n            async destroy(): Promise<void> {\r\n                if (this.lifecycle === 'destroyed') {\r\n                    console.warn('[ClientManager] Already destroyed');\r\n                    return;\r\n                }\r\n\r\n                this.lifecycle = 'destroying';\r\n                this.log('⚡ Phase: DESTROY');\r\n\r\n                try {\r\n                    // Call user onDestroy hook\r\n                    if (this.hooks.onDestroy) {\r\n                        this.log('→ Calling onDestroy hook');\r\n                        await this.hooks.onDestroy();\r\n                    }\r\n\r\n                    // Cleanup managers\r\n                    this.eventsManager.destroy();\r\n                    this.windowManager.destroy();\r\n\r\n                    this.lifecycle = 'destroyed';\r\n                    this.log('✓ DESTROY phase complete');\r\n                } catch (err) {\r\n                    console.error('[ClientManager] Destroy failed:', err);\r\n                    throw err;\r\n                }\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Navigate to path\r\n             */\r\n            navigate(path: string): void {\r\n                this.router.push(path);\r\n            }\r\n\r\n            /**\r\n             * Mount router to DOM element and setup reactive routing\r\n             * Automatically re-renders when route changes\r\n             */\r\n            mount(selector: string | HTMLElement): void {\r\n                const container = typeof selector === 'string'\r\n                    ? document.querySelector(selector)\r\n                    : selector;\r\n\r\n                if (!container) {\r\n                    console.warn('[ClientManager] Mount target not found:', selector);\r\n                    return;\r\n                }\r\n\r\n                // Setup reactive routing effect - re-renders when currentPathSignal changes\r\n                effect(() => {\r\n                    const currentPath = this.currentPathSignal();\r\n                    const Component = this.routeComponents[currentPath]\r\n                        || this.config.notFoundComponent\r\n                        || null;\r\n\r\n                    // Clear and mount new component\r\n                    container.innerHTML = '';\r\n\r\n                    if (Component) {\r\n                        const node = Component();\r\n                        if (node instanceof Node) {\r\n                            container.appendChild(node);\r\n                        }\r\n                    } else {\r\n                        container.innerHTML = '<p>No component found for this route</p>';\r\n                    }\r\n\r\n                    this.log(`→ Route changed to: ${currentPath}`);\r\n                });\r\n\r\n                this.log('→ Routing setup complete');\r\n            }\r\n\r\n            /**\r\n             * Get current path signal for reactivity\r\n             */\r\n            getCurrentPath() {\r\n                return this.currentPathSignal;\r\n            }\r\n\r\n            /**\r\n             * Create navigation link handler\r\n             */\r\n            createLinkHandler(path: string) {\r\n                return (e: MouseEvent) => {\r\n                    e.preventDefault();\r\n                    this.navigate(path);\r\n                };\r\n            }\r\n\r\n            /**\r\n             * Get underlying router for advanced usage\r\n             */\r\n            getRouter() {\r\n                return this.router;\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Unbind event\r\n             */\r\n            off(target: EventTarget, event: string, handler: EventListener): void {\r\n                this.eventsManager.off(target, event, handler);\r\n            }\r\n\r\n            /**\r\n             * Get events manager directly\r\n             */\r\n            getEventsManager(): EventsManager {\r\n                return this.eventsManager;\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Get viewport info as reactive signal\r\n             */\r\n            getViewport() {\r\n                return this.windowManager.getViewport();\r\n            }\r\n\r\n            /**\r\n             * Get window manager directly\r\n             */\r\n            getWindowManager(): WindowManager {\r\n                return this.windowManager;\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Get lifecycle phase\r\n             */\r\n            getPhase() {\r\n                return this.lifecycle;\r\n            }\r\n\r\n            /**\r\n             * Check if ready\r\n             */\r\n            isReady(): boolean {\r\n                return this.lifecycle === 'ready';\r\n            }\r\n\r\n            /**\r\n             * Internal logging\r\n             */\r\n            private log(message: string): void {\r\n                if (this.debug) {\r\n                    console.log(`[ClientManager] ${message}`);\r\n                }\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,100 @@
+import * as _minejs_browser from '@minejs/browser';
+import { Router, EventsManager, WindowManager } from '@minejs/browser';
+import * as _minejs_signals from '@minejs/signals';
+import { JSXElement } from '@minejsx/render';
+
+type RouteComponent = () => JSXElement | null;
+interface ClientManagerConfig {
+    routes: Record<string, RouteComponent>;
+    notFoundComponent?: RouteComponent;
+    debug?: boolean;
+}
+interface ClientManagerHooks {
+    onBoot?: () => void | Promise<void>;
+    onReady?: () => void | Promise<void>;
+    onDestroy?: () => void | Promise<void>;
+}
+
+declare class ClientManager {
+    private router;
+    private eventsManager;
+    private windowManager;
+    private lifecycle;
+    private config;
+    private hooks;
+    private debug;
+    private routeComponents;
+    private currentPathSignal;
+    constructor(config: ClientManagerConfig);
+    /**
+     * Setup lifecycle hooks OR bind events
+     * Overloaded: on(event: 'onBoot'|'onReady'|'onDestroy', callback) - lifecycle
+     *             on(target, event, handler) - event binding
+     */
+    on(event: keyof ClientManagerHooks, callback: any): this;
+    on<K extends keyof HTMLElementEventMap>(target: EventTarget, event: K | string, handler: EventListener, options?: AddEventListenerOptions): () => void;
+    /**
+     * Bootstrap the app - Phase 1: BOOT
+     */
+    boot(): Promise<void>;
+    /**
+     * Ready the app - Phase 2: READY
+     * Mount to DOM and make everything live
+     */
+    ready(mountSelector: string | HTMLElement): Promise<void>;
+    /**
+     * Shutdown the app - Phase 3: DESTROY
+     */
+    destroy(): Promise<void>;
+    /**
+     * Navigate to path
+     */
+    navigate(path: string): void;
+    /**
+     * Mount router to DOM element and setup reactive routing
+     * Automatically re-renders when route changes
+     */
+    mount(selector: string | HTMLElement): void;
+    /**
+     * Get current path signal for reactivity
+     */
+    getCurrentPath(): _minejs_signals.Signal<string>;
+    /**
+     * Create navigation link handler
+     */
+    createLinkHandler(path: string): (e: MouseEvent) => void;
+    /**
+     * Get underlying router for advanced usage
+     */
+    getRouter(): Router;
+    /**
+     * Unbind event
+     */
+    off(target: EventTarget, event: string, handler: EventListener): void;
+    /**
+     * Get events manager directly
+     */
+    getEventsManager(): EventsManager;
+    /**
+     * Get viewport info as reactive signal
+     */
+    getViewport(): _minejs_signals.Signal<_minejs_browser.ViewportInfo>;
+    /**
+     * Get window manager directly
+     */
+    getWindowManager(): WindowManager;
+    /**
+     * Get lifecycle phase
+     */
+    getPhase(): "booting" | "ready" | "destroying" | "destroyed";
+    /**
+     * Check if ready
+     */
+    isReady(): boolean;
+    /**
+     * Internal logging
+     */
+    private log;
+}
+
+export { ClientManager };

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+import * as _minejs_browser from '@minejs/browser';
+import { Router, EventsManager, WindowManager } from '@minejs/browser';
+import * as _minejs_signals from '@minejs/signals';
+import { JSXElement } from '@minejsx/render';
+
+type RouteComponent = () => JSXElement | null;
+interface ClientManagerConfig {
+    routes: Record<string, RouteComponent>;
+    notFoundComponent?: RouteComponent;
+    debug?: boolean;
+}
+interface ClientManagerHooks {
+    onBoot?: () => void | Promise<void>;
+    onReady?: () => void | Promise<void>;
+    onDestroy?: () => void | Promise<void>;
+}
+
+declare class ClientManager {
+    private router;
+    private eventsManager;
+    private windowManager;
+    private lifecycle;
+    private config;
+    private hooks;
+    private debug;
+    private routeComponents;
+    private currentPathSignal;
+    constructor(config: ClientManagerConfig);
+    /**
+     * Setup lifecycle hooks OR bind events
+     * Overloaded: on(event: 'onBoot'|'onReady'|'onDestroy', callback) - lifecycle
+     *             on(target, event, handler) - event binding
+     */
+    on(event: keyof ClientManagerHooks, callback: any): this;
+    on<K extends keyof HTMLElementEventMap>(target: EventTarget, event: K | string, handler: EventListener, options?: AddEventListenerOptions): () => void;
+    /**
+     * Bootstrap the app - Phase 1: BOOT
+     */
+    boot(): Promise<void>;
+    /**
+     * Ready the app - Phase 2: READY
+     * Mount to DOM and make everything live
+     */
+    ready(mountSelector: string | HTMLElement): Promise<void>;
+    /**
+     * Shutdown the app - Phase 3: DESTROY
+     */
+    destroy(): Promise<void>;
+    /**
+     * Navigate to path
+     */
+    navigate(path: string): void;
+    /**
+     * Mount router to DOM element and setup reactive routing
+     * Automatically re-renders when route changes
+     */
+    mount(selector: string | HTMLElement): void;
+    /**
+     * Get current path signal for reactivity
+     */
+    getCurrentPath(): _minejs_signals.Signal<string>;
+    /**
+     * Create navigation link handler
+     */
+    createLinkHandler(path: string): (e: MouseEvent) => void;
+    /**
+     * Get underlying router for advanced usage
+     */
+    getRouter(): Router;
+    /**
+     * Unbind event
+     */
+    off(target: EventTarget, event: string, handler: EventListener): void;
+    /**
+     * Get events manager directly
+     */
+    getEventsManager(): EventsManager;
+    /**
+     * Get viewport info as reactive signal
+     */
+    getViewport(): _minejs_signals.Signal<_minejs_browser.ViewportInfo>;
+    /**
+     * Get window manager directly
+     */
+    getWindowManager(): WindowManager;
+    /**
+     * Get lifecycle phase
+     */
+    getPhase(): "booting" | "ready" | "destroying" | "destroyed";
+    /**
+     * Check if ready
+     */
+    isReady(): boolean;
+    /**
+     * Internal logging
+     */
+    private log;
+}
+
+export { ClientManager };

package/dist/index.js

@@ -0,0 +1,2 @@
+import {signal,effect}from'@minejs/signals';import {EventsManager,WindowManager,createRouter}from'@minejs/browser';var i=class{constructor(e){this.lifecycle="booting";this.hooks={};this.routeComponents={};this.currentPathSignal=signal(window.location.pathname??"/");this.config=e,this.debug=e.debug??false,this.log("[INIT] Creating ClientManager"),this.routeComponents=e.routes,this.eventsManager=new EventsManager,this.windowManager=new WindowManager;let t=Object.entries(e.routes).map(([o,n])=>({path:o,component:n}));this.router=createRouter({routes:t,notFoundComponent:e.notFoundComponent}),this.router.afterEach(o=>{this.currentPathSignal.set(o.path);}),this.log("[INIT] ClientManager created");}on(e,t,o,n){return typeof e=="string"&&e.startsWith("on")?(this.hooks[e]=t,this):this.eventsManager.on(e,t,o,n)}async boot(){if(this.lifecycle!=="booting"){console.warn("[ClientManager] Already booted or destroyed");return}this.log("\u26A1 Phase: BOOT");try{this.hooks.onBoot&&(this.log("\u2192 Calling onBoot hook"),await this.hooks.onBoot()),this.log("\u2713 BOOT phase complete");}catch(e){throw console.error("[ClientManager] Boot failed:",e),e}}async ready(e){if(this.lifecycle!=="booting"){console.warn("[ClientManager] Cannot ready - not in booting phase");return}this.log("\u26A1 Phase: READY");try{this.mount(e),this.log("\u2192 Router mounted"),this.debug&&(globalThis.__CLIENT_MANAGER__=this,this.log("\u2192 ClientManager available globally")),this.hooks.onReady&&(this.log("\u2192 Calling onReady hook"),await this.hooks.onReady()),this.lifecycle="ready",this.log("\u2713 READY phase complete"),this.log("\u2713 App is ready!");}catch(t){throw console.error("[ClientManager] Ready failed:",t),t}}async destroy(){if(this.lifecycle==="destroyed"){console.warn("[ClientManager] Already destroyed");return}this.lifecycle="destroying",this.log("\u26A1 Phase: DESTROY");try{this.hooks.onDestroy&&(this.log("\u2192 Calling onDestroy hook"),await this.hooks.onDestroy()),this.eventsManager.destroy(),this.windowManager.destroy(),this.lifecycle="destroyed",this.log("\u2713 DESTROY phase complete");}catch(e){throw console.error("[ClientManager] Destroy failed:",e),e}}navigate(e){this.router.push(e);}mount(e){let t=typeof e=="string"?document.querySelector(e):e;if(!t){console.warn("[ClientManager] Mount target not found:",e);return}effect(()=>{let o=this.currentPathSignal(),n=this.routeComponents[o]||this.config.notFoundComponent||null;if(t.innerHTML="",n){let r=n();r instanceof Node&&t.appendChild(r);}else t.innerHTML="<p>No component found for this route</p>";this.log(`\u2192 Route changed to: ${o}`);}),this.log("\u2192 Routing setup complete");}getCurrentPath(){return this.currentPathSignal}createLinkHandler(e){return t=>{t.preventDefault(),this.navigate(e);}}getRouter(){return this.router}off(e,t,o){this.eventsManager.off(e,t,o);}getEventsManager(){return this.eventsManager}getViewport(){return this.windowManager.getViewport()}getWindowManager(){return this.windowManager}getPhase(){return this.lifecycle}isReady(){return this.lifecycle==="ready"}log(e){this.debug&&console.log(`[ClientManager] ${e}`);}};export{i as ClientManager};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["ClientManager","config","signal","EventsManager","WindowManager","routesArray","path","component","createRouter","to","eventOrTarget","callbackOrEvent","handler","options","err","mountSelector","selector","container","effect","currentPath","Component","node","e","target","event","message"],"mappings":"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","file":"index.js","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\r\n// src/index.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n    import { signal, effect } from '@minejs/signals';\r\n    import { EventsManager, Router, WindowManager, createRouter } from '@minejs/browser';\r\n    import * as types from './types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    export class ClientManager {\r\n\r\n        // ┌──────────────────────────────── INIT ──────────────────────────────┐\r\n\r\n            private router              : Router;\r\n            private eventsManager       : EventsManager;\r\n            private windowManager       : WindowManager;\r\n            private lifecycle           : 'booting' | 'ready' | 'destroying' | 'destroyed' = 'booting';\r\n            private config              : types.ClientManagerConfig;\r\n            private hooks               : types.ClientManagerHooks = {};\r\n            private debug               : boolean;\r\n            private routeComponents     : Record<string, types.RouteComponent> = {};\r\n            private currentPathSignal   = signal<string>(window.location.pathname ?? '/');\r\n\r\n            constructor(config: types.ClientManagerConfig) {\r\n                this.config = config;\r\n                this.debug = config.debug ?? false;\r\n\r\n                this.log('[INIT] Creating ClientManager');\r\n\r\n                // Store route components provided by user\r\n                this.routeComponents = config.routes;\r\n\r\n                // Initialize managers from @minejs/browser\r\n                this.eventsManager = new EventsManager();\r\n                this.windowManager = new WindowManager();\r\n\r\n                // Initialize router with user-provided routes\r\n                const routesArray = Object.entries(config.routes).map(([path, component]) => ({\r\n                    path,\r\n                    component\r\n                }));\r\n\r\n                this.router = createRouter({\r\n                    routes: routesArray,\r\n                    notFoundComponent: config.notFoundComponent,\r\n                });\r\n\r\n                // Connect router changes to signal for automatic re-rendering\r\n                this.router.afterEach((to) => {\r\n                    this.currentPathSignal.set(to.path);\r\n                });\r\n\r\n                this.log('[INIT] ClientManager created');\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Setup lifecycle hooks OR bind events\r\n             * Overloaded: on(event: 'onBoot'|'onReady'|'onDestroy', callback) - lifecycle\r\n             *             on(target, event, handler) - event binding\r\n             */\r\n            on(event: keyof types.ClientManagerHooks, callback: any): this;\r\n            on<K extends keyof HTMLElementEventMap>(\r\n                target: EventTarget,\r\n                event: K | string,\r\n                handler: EventListener,\r\n                options?: AddEventListenerOptions\r\n            ): () => void;\r\n            on(\r\n                eventOrTarget: keyof types.ClientManagerHooks | EventTarget,\r\n                callbackOrEvent?: any,\r\n                handler?: EventListener,\r\n                options?: AddEventListenerOptions\r\n            ): this | (() => void) {\r\n                // Check if this is a lifecycle hook call\r\n                if (typeof eventOrTarget === 'string' && eventOrTarget.startsWith('on')) {\r\n                    this.hooks[eventOrTarget as keyof types.ClientManagerHooks] = callbackOrEvent;\r\n                    return this;\r\n                }\r\n\r\n                // Otherwise it's an event binding\r\n                return this.eventsManager.on(\r\n                    eventOrTarget as EventTarget,\r\n                    callbackOrEvent as string,\r\n                    handler as EventListener,\r\n                    options\r\n                );\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Bootstrap the app - Phase 1: BOOT\r\n             */\r\n            async boot(): Promise<void> {\r\n                if (this.lifecycle !== 'booting') {\r\n                    console.warn('[ClientManager] Already booted or destroyed');\r\n                    return;\r\n                }\r\n\r\n                this.log('⚡ Phase: BOOT');\r\n\r\n                try {\r\n                    // Call user onBoot hook\r\n                    if (this.hooks.onBoot) {\r\n                        this.log('→ Calling onBoot hook');\r\n                        await this.hooks.onBoot();\r\n                    }\r\n\r\n                    this.log('✓ BOOT phase complete');\r\n                } catch (err) {\r\n                    console.error('[ClientManager] Boot failed:', err);\r\n                    throw err;\r\n                }\r\n            }\r\n\r\n            /**\r\n             * Ready the app - Phase 2: READY\r\n             * Mount to DOM and make everything live\r\n             */\r\n            async ready(mountSelector: string | HTMLElement): Promise<void> {\r\n                if (this.lifecycle !== 'booting') {\r\n                    console.warn('[ClientManager] Cannot ready - not in booting phase');\r\n                    return;\r\n                }\r\n\r\n                this.log('⚡ Phase: READY');\r\n\r\n                try {\r\n                    // Mount router\r\n                    this.mount(mountSelector);\r\n                    this.log('→ Router mounted');\r\n\r\n                    // Setup global access for debugging\r\n                    if (this.debug) {\r\n                        (globalThis as any).__CLIENT_MANAGER__ = this;\r\n                        this.log('→ ClientManager available globally');\r\n                    }\r\n\r\n                    // Call user onReady hook\r\n                    if (this.hooks.onReady) {\r\n                        this.log('→ Calling onReady hook');\r\n                        await this.hooks.onReady();\r\n                    }\r\n\r\n                    this.lifecycle = 'ready';\r\n                    this.log('✓ READY phase complete');\r\n                    this.log('✓ App is ready!');\r\n                } catch (err) {\r\n                    console.error('[ClientManager] Ready failed:', err);\r\n                    throw err;\r\n                }\r\n            }\r\n\r\n            /**\r\n             * Shutdown the app - Phase 3: DESTROY\r\n             */\r\n            async destroy(): Promise<void> {\r\n                if (this.lifecycle === 'destroyed') {\r\n                    console.warn('[ClientManager] Already destroyed');\r\n                    return;\r\n                }\r\n\r\n                this.lifecycle = 'destroying';\r\n                this.log('⚡ Phase: DESTROY');\r\n\r\n                try {\r\n                    // Call user onDestroy hook\r\n                    if (this.hooks.onDestroy) {\r\n                        this.log('→ Calling onDestroy hook');\r\n                        await this.hooks.onDestroy();\r\n                    }\r\n\r\n                    // Cleanup managers\r\n                    this.eventsManager.destroy();\r\n                    this.windowManager.destroy();\r\n\r\n                    this.lifecycle = 'destroyed';\r\n                    this.log('✓ DESTROY phase complete');\r\n                } catch (err) {\r\n                    console.error('[ClientManager] Destroy failed:', err);\r\n                    throw err;\r\n                }\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Navigate to path\r\n             */\r\n            navigate(path: string): void {\r\n                this.router.push(path);\r\n            }\r\n\r\n            /**\r\n             * Mount router to DOM element and setup reactive routing\r\n             * Automatically re-renders when route changes\r\n             */\r\n            mount(selector: string | HTMLElement): void {\r\n                const container = typeof selector === 'string'\r\n                    ? document.querySelector(selector)\r\n                    : selector;\r\n\r\n                if (!container) {\r\n                    console.warn('[ClientManager] Mount target not found:', selector);\r\n                    return;\r\n                }\r\n\r\n                // Setup reactive routing effect - re-renders when currentPathSignal changes\r\n                effect(() => {\r\n                    const currentPath = this.currentPathSignal();\r\n                    const Component = this.routeComponents[currentPath]\r\n                        || this.config.notFoundComponent\r\n                        || null;\r\n\r\n                    // Clear and mount new component\r\n                    container.innerHTML = '';\r\n\r\n                    if (Component) {\r\n                        const node = Component();\r\n                        if (node instanceof Node) {\r\n                            container.appendChild(node);\r\n                        }\r\n                    } else {\r\n                        container.innerHTML = '<p>No component found for this route</p>';\r\n                    }\r\n\r\n                    this.log(`→ Route changed to: ${currentPath}`);\r\n                });\r\n\r\n                this.log('→ Routing setup complete');\r\n            }\r\n\r\n            /**\r\n             * Get current path signal for reactivity\r\n             */\r\n            getCurrentPath() {\r\n                return this.currentPathSignal;\r\n            }\r\n\r\n            /**\r\n             * Create navigation link handler\r\n             */\r\n            createLinkHandler(path: string) {\r\n                return (e: MouseEvent) => {\r\n                    e.preventDefault();\r\n                    this.navigate(path);\r\n                };\r\n            }\r\n\r\n            /**\r\n             * Get underlying router for advanced usage\r\n             */\r\n            getRouter() {\r\n                return this.router;\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Unbind event\r\n             */\r\n            off(target: EventTarget, event: string, handler: EventListener): void {\r\n                this.eventsManager.off(target, event, handler);\r\n            }\r\n\r\n            /**\r\n             * Get events manager directly\r\n             */\r\n            getEventsManager(): EventsManager {\r\n                return this.eventsManager;\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Get viewport info as reactive signal\r\n             */\r\n            getViewport() {\r\n                return this.windowManager.getViewport();\r\n            }\r\n\r\n            /**\r\n             * Get window manager directly\r\n             */\r\n            getWindowManager(): WindowManager {\r\n                return this.windowManager;\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n        // ┌──────────────────────────────── ──── ──────────────────────────────┐\r\n\r\n            /**\r\n             * Get lifecycle phase\r\n             */\r\n            getPhase() {\r\n                return this.lifecycle;\r\n            }\r\n\r\n            /**\r\n             * Check if ready\r\n             */\r\n            isReady(): boolean {\r\n                return this.lifecycle === 'ready';\r\n            }\r\n\r\n            /**\r\n             * Internal logging\r\n             */\r\n            private log(message: string): void {\r\n                if (this.debug) {\r\n                    console.log(`[ClientManager] ${message}`);\r\n                }\r\n            }\r\n\r\n        // └────────────────────────────────────────────────────────────────────┘\r\n\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n"]}

package/package.json

@@ -0,0 +1,59 @@
+{
+	"name": "@cruxjs/client",
+	"version": "0.0.1",
+	"description": "Pure management layer for client-side applications. Routing, lifecycle, events, and viewport management without dictating your architecture.",
+	"keywords": ["cruxjs", "client"],
+	"license": "MIT",
+	"homepage": "https://github.com/cruxjs-org/client#readme",
+	"bugs": {
+		"url": "https://github.com/cruxjs-org/client/issues"
+	},
+	"author": {
+		"name": "Maysara",
+		"email": "maysara.elshewehy@gmail.com",
+		"url": "https://github.com/maysara-elshewehy"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/cruxjs-org/client.git"
+	},
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": ["dist"],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"build": "tsup",
+		"lint": "eslint src --ext .ts",
+		"test": "bun test"
+	},
+	"engines": {
+		"bun": ">=1.3.3"
+	},
+	"peerDependencies": {
+		"bun": "^1.3.3"
+	},
+	"dependencies": {
+		"@minejs/browser": "^0.0.4",
+		"@minejs/signals": "^0.0.6",
+		"@minejsx/render": "^0.0.3"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.39.2",
+		"@stylistic/eslint-plugin": "^5.6.1",
+		"@types/bun": "^1.3.5",
+		"@types/node": "^20.19.27",
+		"bun-plugin-dts": "^0.3.0",
+		"bun-types": "^1.3.5",
+		"ts-node": "^10.9.2",
+		"tsup": "^8.5.1",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.52.0"
+	}
+}