@buenojs/bueno 0.8.6 → 0.8.7

package/dist/frontend/file-router.d.ts

@@ -0,0 +1,170 @@
+/**
+ * File-based Routing Implementation
+ *
+ * Provides Next.js-style file-based routing:
+ * - pages/ directory scanning
+ * - Dynamic routes: [id].tsx, [...slug].tsx
+ * - Route generation from file structure
+ * - Integration with existing Router
+ */
+import { Router } from "../router/index.js";
+import type { DynamicRoute, FileRouterConfig, PartialFileRouterConfig, RouteDefinition, RouteMatch } from "./types.js";
+/**
+ * File-based router that scans directories and generates routes
+ *
+ * Features:
+ * - Next.js-style file-based routing
+ * - Dynamic routes with [param] syntax
+ * - Catch-all routes with [...param] syntax
+ * - API routes in pages/api/
+ * - Hot reload support
+ */
+export declare class FileRouter {
+    private config;
+    private logger;
+    private routes;
+    private dynamicRoutes;
+    private router;
+    private pageModules;
+    private apiHandlers;
+    constructor(config?: PartialFileRouterConfig);
+    /**
+     * Normalize partial config to full config with defaults
+     */
+    private normalizeConfig;
+    /**
+     * Initialize the file router by scanning the pages directory
+     */
+    init(): Promise<void>;
+    /**
+     * Scan the pages directory for route files
+     */
+    private scanPagesDirectory;
+    /**
+     * Process a single route file
+     */
+    private processRouteFile;
+    /**
+     * Convert file path to route path
+     */
+    private filePathToRoute;
+    /**
+     * Determine route type from file path
+     */
+    private getRouteType;
+    /**
+     * Parse route pattern and extract parameters
+     */
+    private parseRoutePattern;
+    /**
+     * Convert route path to regex
+     */
+    private routeToRegex;
+    /**
+     * Generate unique route ID
+     */
+    private generateRouteId;
+    /**
+     * Build the router from collected routes
+     */
+    private buildRouter;
+    /**
+     * Sort routes by specificity
+     * Static routes come before dynamic routes
+     */
+    private sortRoutesBySpecificity;
+    /**
+     * Create page handler for a route
+     */
+    private createPageHandler;
+    /**
+     * Register API route with all HTTP methods
+     */
+    private registerApiRoute;
+    /**
+     * Create API handler for a route and method
+     */
+    private createApiHandler;
+    /**
+     * Load page module dynamically
+     */
+    private loadPageModule;
+    /**
+     * Load API module dynamically
+     */
+    private loadApiModule;
+    /**
+     * Extract params from URL using route definition
+     */
+    private extractParams;
+    /**
+     * Create context for request
+     */
+    private createContext;
+    /**
+     * Match a request to a route
+     */
+    match(method: string, pathname: string): RouteMatch | null;
+    /**
+     * Handle incoming request
+     */
+    handle(request: Request): Promise<Response>;
+    /**
+     * Create handler for route
+     */
+    private createHandler;
+    /**
+     * Get all routes
+     */
+    getRoutes(): RouteDefinition[];
+    /**
+     * Get route by path
+     */
+    getRoute(path: string): RouteDefinition | undefined;
+    /**
+     * Get dynamic routes
+     */
+    getDynamicRoutes(): DynamicRoute[];
+    /**
+     * Generate URL for a route
+     */
+    generateUrl(routeId: string, params?: Record<string, string>): string | null;
+    /**
+     * Reload routes (for hot reload)
+     */
+    reload(): Promise<void>;
+    /**
+     * Get the underlying router
+     */
+    getRouter(): Router;
+    /**
+     * Get configuration
+     */
+    getConfig(): FileRouterConfig;
+}
+/**
+ * Create a file router
+ */
+export declare function createFileRouter(config?: PartialFileRouterConfig): FileRouter;
+/**
+ * Check if a path is a dynamic route
+ */
+export declare function isDynamicRoute(path: string): boolean;
+/**
+ * Check if a path is a catch-all route
+ */
+export declare function isCatchAllRoute(path: string): boolean;
+/**
+ * Get parameter names from route path
+ */
+export declare function getRouteParams(path: string): string[];
+/**
+ * Normalize route path
+ */
+export declare function normalizeRoutePath(path: string): string;
+/**
+ * Compare route specificity
+ * Returns negative if a is more specific, positive if b is more specific
+ */
+export declare function compareRouteSpecificity(a: string, b: string): number;
+//# sourceMappingURL=file-router.d.ts.map

package/dist/frontend/file-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../src/frontend/file-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,EACX,YAAY,EAEZ,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EAEf,UAAU,EAGV,MAAM,YAAY,CAAC;AAWpB;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,WAAW,CAAwD;gBAE/D,MAAM,GAAE,uBAA4B;IAUhD;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;YACW,kBAAkB;IAahC;;OAEG;YACW,gBAAgB;IAsC9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;YACW,gBAAgB;IAuC9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;YACW,cAAc;IAe5B;;OAEG;YACW,aAAa;IAY3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IA4B1D;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYjD;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,SAAS,IAAI,eAAe,EAAE;IAI9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD;;OAEG;IACH,gBAAgB,IAAI,YAAY,EAAE;IAIlC;;OAEG;IACH,WAAW,CACV,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,MAAM,GAAG,IAAI;IAchB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,IAAI,gBAAgB;CAG7B;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,GAAE,uBAA4B,GAClC,UAAU,CAEZ;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAcrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBpE"}

package/dist/frontend/frameworks/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Framework Build Configurations
+ *
+ * Exports framework-specific build configurations for all supported frameworks.
+ * Each framework module provides configuration for JSX runtime, plugins, and defines.
+ */
+import type { FrameworkBuildConfig, FrontendFramework } from "../types.js";
+export { getReactBuildConfig, isReactComponent, getReactRefreshPreamble, reactFrameworkMeta, } from "./react.js";
+export { getVueBuildConfig, isVueComponent, isVueJsx, getVueBlockTypes, vueFrameworkMeta, } from "./vue.js";
+export { getSvelteBuildConfig, isSvelteComponent, getSveltePreprocessConfig, getSvelteCompilerOptions, svelteFrameworkMeta, } from "./svelte.js";
+export { getSolidBuildConfig, isSolidComponent, getSolidRefreshPreamble, getSolidTransformOptions, solidFrameworkMeta, } from "./solid.js";
+export interface FrameworkMeta {
+    name: FrontendFramework;
+    displayName: string;
+    fileExtensions: string[];
+    componentExtensions: string[];
+    needsRefreshRuntime: boolean;
+    supportsHMR: boolean;
+    supportsSSR: boolean;
+}
+/**
+ * Get framework build configuration by framework name
+ */
+export declare function getFrameworkConfig(framework: FrontendFramework): FrameworkBuildConfig;
+/**
+ * Get framework metadata by framework name
+ */
+export declare function getFrameworkMeta(framework: FrontendFramework): FrameworkMeta;
+/**
+ * Detect framework from file extension
+ */
+export declare function detectFrameworkFromExtension(filePath: string): FrontendFramework | null;
+/**
+ * Get all supported file extensions
+ */
+export declare function getAllSupportedExtensions(): string[];
+/**
+ * Check if a file extension is supported
+ */
+export declare function isSupportedExtension(filePath: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/frameworks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frontend/frameworks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAS3E,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,GAClB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,iBAAiB,GAC1B,oBAAoB,CActB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,GAAG,aAAa,CAa5E;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC3C,QAAQ,EAAE,MAAM,GACd,iBAAiB,GAAG,IAAI,CAa1B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAOpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG9D"}

package/dist/frontend/frameworks/react.d.ts

@@ -0,0 +1,32 @@
+/**
+ * React Framework Build Configuration
+ *
+ * Provides build configuration specific to React applications,
+ * including JSX runtime, automatic import handling, and React-specific defines.
+ */
+import type { FrameworkBuildConfig } from "../types.js";
+/**
+ * Get React framework build configuration
+ */
+export declare function getReactBuildConfig(): FrameworkBuildConfig;
+/**
+ * Check if a file is a React component
+ */
+export declare function isReactComponent(filePath: string): boolean;
+/**
+ * Get React refresh preamble for development
+ */
+export declare function getReactRefreshPreamble(): string;
+/**
+ * React framework metadata
+ */
+export declare const reactFrameworkMeta: {
+    name: "react";
+    displayName: string;
+    fileExtensions: string[];
+    componentExtensions: string[];
+    needsRefreshRuntime: boolean;
+    supportsHMR: boolean;
+    supportsSSR: boolean;
+};
+//# sourceMappingURL=react.d.ts.map

package/dist/frontend/frameworks/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/frontend/frameworks/react.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAOrE;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,oBAAoB,CA6B1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAOhD;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CASrB,CAAC"}

package/dist/frontend/frameworks/solid.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Solid Framework Build Configuration
+ *
+ * Provides build configuration specific to Solid applications,
+ * including Solid JSX transforms and Solid-specific optimizations.
+ */
+import type { FrameworkBuildConfig } from "../types.js";
+/**
+ * Get Solid framework build configuration
+ */
+export declare function getSolidBuildConfig(): FrameworkBuildConfig;
+/**
+ * Check if a file is a Solid component
+ */
+export declare function isSolidComponent(filePath: string): boolean;
+/**
+ * Get Solid refresh preamble for development
+ * Solid uses a different HMR mechanism than React
+ */
+export declare function getSolidRefreshPreamble(): string;
+/**
+ * Solid babel-like transform options
+ * For use with custom build configurations
+ */
+export declare function getSolidTransformOptions(): {
+    generate: "dom";
+    hydratable: boolean;
+    runtime: "solid-js/web";
+};
+/**
+ * Solid framework metadata
+ */
+export declare const solidFrameworkMeta: {
+    name: "solid";
+    displayName: string;
+    fileExtensions: string[];
+    componentExtensions: string[];
+    needsRefreshRuntime: boolean;
+    supportsHMR: boolean;
+    supportsSSR: boolean;
+};
+//# sourceMappingURL=solid.d.ts.map

package/dist/frontend/frameworks/solid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../../../src/frontend/frameworks/solid.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAOrE;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,oBAAoB,CA+B1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAQhD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB;;;;EASvC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CASrB,CAAC"}

package/dist/frontend/frameworks/svelte.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Svelte Framework Build Configuration
+ *
+ * Provides build configuration specific to Svelte applications,
+ * including Svelte SFC support and Svelte-specific preprocessing.
+ */
+import type { FrameworkBuildConfig } from "../types.js";
+/**
+ * Get Svelte framework build configuration
+ */
+export declare function getSvelteBuildConfig(): FrameworkBuildConfig;
+/**
+ * Check if a file is a Svelte component
+ */
+export declare function isSvelteComponent(filePath: string): boolean;
+/**
+ * Get Svelte preprocessor configuration
+ * Returns configuration for svelte-preprocess
+ */
+export declare function getSveltePreprocessConfig(): {
+    typescript: {
+        compilerOptions: {
+            allowJs: boolean;
+            checkJs: boolean;
+        };
+    };
+    postcss: boolean;
+    scss: {
+        prependData: string;
+    };
+};
+/**
+ * Svelte compiler options
+ */
+export declare function getSvelteCompilerOptions(): {
+    cssHash: ({ hash, css, name, }: {
+        hash: (s: string) => string;
+        css: string;
+        name: string;
+    }) => string;
+    generate: "dom";
+    hydratable: boolean;
+    preserveWhitespace: boolean;
+};
+/**
+ * Svelte framework metadata
+ */
+export declare const svelteFrameworkMeta: {
+    name: "svelte";
+    displayName: string;
+    fileExtensions: string[];
+    componentExtensions: string[];
+    needsRefreshRuntime: boolean;
+    supportsHMR: boolean;
+    supportsSSR: boolean;
+};
+//# sourceMappingURL=svelte.d.ts.map

package/dist/frontend/frameworks/svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte.d.ts","sourceRoot":"","sources":["../../../src/frontend/frameworks/svelte.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAQrE;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,oBAAoB,CA2B3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;EAcxC;AAED;;GAEG;AACH,wBAAgB,wBAAwB;oCAOnC;QAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;EAU9D;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CASrB,CAAC"}

package/dist/frontend/frameworks/vue.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Vue Framework Build Configuration
+ *
+ * Provides build configuration specific to Vue applications,
+ * including Vue SFC support, JSX configuration, and Vue-specific defines.
+ */
+import type { FrameworkBuildConfig } from "../types.js";
+/**
+ * Get Vue framework build configuration
+ */
+export declare function getVueBuildConfig(): FrameworkBuildConfig;
+/**
+ * Check if a file is a Vue component
+ */
+export declare function isVueComponent(filePath: string): boolean;
+/**
+ * Check if a file uses Vue JSX
+ */
+export declare function isVueJsx(filePath: string): boolean;
+/**
+ * Get Vue SFC block types
+ */
+export declare function getVueBlockTypes(): string[];
+/**
+ * Vue framework metadata
+ */
+export declare const vueFrameworkMeta: {
+    name: "vue";
+    displayName: string;
+    fileExtensions: string[];
+    componentExtensions: string[];
+    needsRefreshRuntime: boolean;
+    supportsHMR: boolean;
+    supportsSSR: boolean;
+};
+//# sourceMappingURL=vue.d.ts.map

package/dist/frontend/frameworks/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../../src/frontend/frameworks/vue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAQrE;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,oBAAoB,CAiCxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC9B,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CASrB,CAAC"}

package/dist/frontend/hmr-client.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HMR Client Script
+ *
+ * This script is injected into HTML pages to enable Hot Module Replacement.
+ * It handles WebSocket communication, module updates, and framework-specific HMR.
+ *
+ * The script is kept minimal (< 5KB) for fast injection.
+ *
+ * @module frontend/hmr-client
+ */
+export declare const HMR_CLIENT_SCRIPT = "\n(function() {\n\t'use strict';\n\n\t// ============= Configuration =============\n\tconst HMR_CONFIG = {\n\t\treconnectInterval: 1000,\n\t\tmaxReconnectAttempts: 10,\n\t\theartbeatInterval: 30000,\n\t};\n\n\t// ============= State =============\n\tlet ws = null;\n\tlet clientId = null;\n\tlet reconnectAttempts = 0;\n\tlet reconnectTimer = null;\n\tlet heartbeatTimer = null;\n\tlet subscribedFiles = new Set();\n\tlet moduleCache = new Map();\n\tlet isConnecting = false;\n\n\t// ============= Framework Detection =============\n\tconst framework = detectFramework();\n\n\tfunction detectFramework() {\n\t\tif (typeof window === 'undefined') return 'unknown';\n\t\t\n\t\t// Check for React\n\t\tif (window.React || document.querySelector('[data-reactroot]') || \n\t\t\tdocument.querySelector('[data-reactid]')) {\n\t\t\treturn 'react';\n\t\t}\n\t\t\n\t\t// Check for Vue\n\t\tif (window.Vue || document.querySelector('[data-v-]') ||\n\t\t\tdocument.querySelector('[data-vue-app]')) {\n\t\t\treturn 'vue';\n\t\t}\n\t\t\n\t\t// Check for Svelte\n\t\tif (window.__SVELTE_HMR__ || document.querySelector('[data-svelte]')) {\n\t\t\treturn 'svelte';\n\t\t}\n\t\t\n\t\t// Check for Solid\n\t\tif (window.Solid$$ || document.querySelector('[data-solid]')) {\n\t\t\treturn 'solid';\n\t\t}\n\t\t\n\t\treturn 'unknown';\n\t}\n\n\t// ============= WebSocket Connection =============\n\tfunction connect() {\n\t\tif (isConnecting || (ws && ws.readyState === WebSocket.OPEN)) {\n\t\t\treturn;\n\t\t}\n\t\t\n\t\tisConnecting = true;\n\t\t\n\t\t// Build WebSocket URL\n\t\tconst protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';\n\t\tconst host = window.location.hostname;\n\t\tconst port = getHMRPort();\n\t\tconst url = protocol + '//' + host + ':' + port + '/_hmr';\n\t\t\n\t\ttry {\n\t\t\tws = new WebSocket(url);\n\t\t\t\n\t\t\tws.onopen = handleOpen;\n\t\t\tws.onclose = handleClose;\n\t\t\tws.onerror = handleError;\n\t\t\tws.onmessage = handleMessage;\n\t\t} catch (e) {\n\t\t\tconsole.error('[HMR] Failed to create WebSocket:', e);\n\t\t\tisConnecting = false;\n\t\t\tscheduleReconnect();\n\t\t}\n\t}\n\n\tfunction getHMRPort() {\n\t\t// Try to get port from script tag or default to dev server port + 1\n\t\tconst scripts = document.querySelectorAll('script[data-hmr-port]');\n\t\tif (scripts.length > 0) {\n\t\t\treturn parseInt(scripts[0].getAttribute('data-hmr-port'), 10);\n\t\t}\n\t\treturn parseInt(window.location.port || '3000', 10) + 1;\n\t}\n\n\tfunction handleOpen() {\n\t\tisConnecting = false;\n\t\treconnectAttempts = 0;\n\t\tconsole.log('[HMR] Connected');\n\t\t\n\t\t// Start heartbeat\n\t\tstartHeartbeat();\n\t\t\n\t\t// Re-subscribe to files\n\t\tsubscribedFiles.forEach(function(fileId) {\n\t\t\tsendMessage({ type: 'subscribe', fileId: fileId });\n\t\t});\n\t}\n\n\tfunction handleClose(event) {\n\t\tisConnecting = false;\n\t\tstopHeartbeat();\n\t\t\n\t\tif (event.code !== 1000) {\n\t\t\tconsole.log('[HMR] Connection closed, attempting to reconnect...');\n\t\t\tscheduleReconnect();\n\t\t}\n\t}\n\n\tfunction handleError(error) {\n\t\tisConnecting = false;\n\t\tconsole.error('[HMR] WebSocket error:', error);\n\t}\n\n\tfunction scheduleReconnect() {\n\t\tif (reconnectTimer) {\n\t\t\tclearTimeout(reconnectTimer);\n\t\t}\n\t\t\n\t\tif (reconnectAttempts >= HMR_CONFIG.maxReconnectAttempts) {\n\t\t\tconsole.error('[HMR] Max reconnect attempts reached. Please refresh the page.');\n\t\t\tshowOverlay({\n\t\t\t\tmessage: 'HMR connection lost. Please refresh the page.',\n\t\t\t\ttype: 'error'\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\t\t\n\t\treconnectAttempts++;\n\t\tvar delay = HMR_CONFIG.reconnectInterval * reconnectAttempts;\n\t\t\n\t\treconnectTimer = setTimeout(function() {\n\t\t\tconsole.log('[HMR] Reconnecting... (attempt ' + reconnectAttempts + ')');\n\t\t\tconnect();\n\t\t}, delay);\n\t}\n\n\t// ============= Heartbeat =============\n\tfunction startHeartbeat() {\n\t\tstopHeartbeat();\n\t\theartbeatTimer = setInterval(function() {\n\t\t\tif (ws && ws.readyState === WebSocket.OPEN) {\n\t\t\t\tsendMessage({ type: 'ping' });\n\t\t\t}\n\t\t}, HMR_CONFIG.heartbeatInterval);\n\t}\n\n\tfunction stopHeartbeat() {\n\t\tif (heartbeatTimer) {\n\t\t\tclearInterval(heartbeatTimer);\n\t\t\theartbeatTimer = null;\n\t\t}\n\t}\n\n\t// ============= Message Handling =============\n\tfunction sendMessage(message) {\n\t\tif (ws && ws.readyState === WebSocket.OPEN) {\n\t\t\tws.send(JSON.stringify(message));\n\t\t}\n\t}\n\n\tfunction handleMessage(event) {\n\t\ttry {\n\t\t\tvar message = JSON.parse(event.data);\n\t\t\t\n\t\t\tswitch (message.type) {\n\t\t\t\tcase 'connected':\n\t\t\t\t\tclientId = message.clientId;\n\t\t\t\t\tconsole.log('[HMR] Client ID:', clientId);\n\t\t\t\t\tbreak;\n\t\t\t\t\t\n\t\t\t\tcase 'pong':\n\t\t\t\t\t// Heartbeat response\n\t\t\t\t\tbreak;\n\t\t\t\t\t\n\t\t\t\tcase 'update':\n\t\t\t\t\thandleUpdate(message);\n\t\t\t\t\tbreak;\n\t\t\t\t\t\n\t\t\t\tcase 'reload':\n\t\t\t\t\thandleReload(message);\n\t\t\t\t\tbreak;\n\t\t\t\t\t\n\t\t\t\tcase 'error':\n\t\t\t\t\thandleError(message);\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tconsole.error('[HMR] Failed to parse message:', e);\n\t\t}\n\t}\n\n\t// ============= Update Handling =============\n\tfunction handleUpdate(message) {\n\t\tconsole.log('[HMR] Update received:', message.fileId);\n\t\t\n\t\t// Hide any existing error overlay\n\t\thideOverlay();\n\t\t\n\t\tvar changes = message.changes || [];\n\t\tvar hasCSSUpdate = changes.some(function(file) {\n\t\t\treturn file.endsWith('.css') || file.endsWith('.scss') || \n\t\t\t\t   file.endsWith('.sass') || file.endsWith('.less');\n\t\t});\n\t\t\n\t\tif (hasCSSUpdate) {\n\t\t\t// Handle CSS updates without flash\n\t\t\tupdateCSS(changes);\n\t\t}\n\t\t\n\t\t// Check if we can do hot update\n\t\tif (canHotUpdate(changes)) {\n\t\t\tperformHotUpdate(message);\n\t\t} else {\n\t\t\t// Fall back to full reload\n\t\t\tconsole.log('[HMR] Cannot hot update, reloading page...');\n\t\t\twindow.location.reload();\n\t\t}\n\t}\n\n\tfunction handleReload(message) {\n\t\tconsole.log('[HMR] Full reload requested');\n\t\thideOverlay();\n\t\twindow.location.reload();\n\t}\n\n\tfunction handleError(message) {\n\t\tconsole.error('[HMR] Error:', message.error);\n\t\tshowOverlay({\n\t\t\tmessage: message.error.message,\n\t\t\tstack: message.error.stack,\n\t\t\tfile: message.error.file,\n\t\t\tline: message.error.line,\n\t\t\tcolumn: message.error.column,\n\t\t\ttype: 'error'\n\t\t});\n\t}\n\n\t// ============= CSS Hot Update =============\n\tfunction updateCSS(changedFiles) {\n\t\tvar links = document.querySelectorAll('link[rel=\"stylesheet\"]');\n\t\t\n\t\tlinks.forEach(function(link) {\n\t\t\tvar href = link.getAttribute('href');\n\t\t\tif (!href) return;\n\t\t\t\n\t\t\t// Check if this stylesheet is affected\n\t\t\tvar isAffected = changedFiles.some(function(file) {\n\t\t\t\treturn href.includes(file.replace(/^.*\\//, '')) ||\n\t\t\t\t\t   file.includes(href.replace(/^.*\\//, ''));\n\t\t\t});\n\t\t\t\n\t\t\tif (isAffected) {\n\t\t\t\t// Add timestamp to force reload\n\t\t\t\tvar newHref = href.split('?')[0] + '?v=' + Date.now();\n\t\t\t\t\n\t\t\t\t// Create new link and swap\n\t\t\t\tvar newLink = document.createElement('link');\n\t\t\t\tnewLink.rel = 'stylesheet';\n\t\t\t\tnewLink.href = newHref;\n\t\t\t\t\n\t\t\t\tnewLink.onload = function() {\n\t\t\t\t\tlink.remove();\n\t\t\t\t};\n\t\t\t\t\n\t\t\t\tnewLink.onerror = function() {\n\t\t\t\t\tconsole.error('[HMR] Failed to reload CSS:', newHref);\n\t\t\t\t\tlink.remove();\n\t\t\t\t};\n\t\t\t\t\n\t\t\t\tlink.parentNode.insertBefore(newLink, link);\n\t\t\t}\n\t\t});\n\t}\n\n\t// ============= Hot Update Logic =============\n\tfunction canHotUpdate(changes) {\n\t\t// Check if all changed files can be hot updated\n\t\treturn changes.every(function(file) {\n\t\t\tvar ext = file.split('.').pop().toLowerCase();\n\t\t\t\n\t\t\t// CSS files can always be hot updated\n\t\t\tif (ext === 'css' || ext === 'scss' || ext === 'sass' || ext === 'less') {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\t\n\t\t\t// JS/TS files need HMR boundary\n\t\t\tif (ext === 'js' || ext === 'jsx' || ext === 'ts' || ext === 'tsx') {\n\t\t\t\treturn hasHMRBoundary(file);\n\t\t\t}\n\t\t\t\n\t\t\t// Framework-specific files\n\t\t\tif (ext === 'vue' || ext === 'svelte') {\n\t\t\t\treturn true; // Vue and Svelte have built-in HMR\n\t\t\t}\n\t\t\t\n\t\t\treturn false;\n\t\t});\n\t}\n\n\tfunction hasHMRBoundary(file) {\n\t\t// Check if the module accepts hot updates\n\t\t// This is a simplified check - in production, we'd track this from the server\n\t\treturn true; // For now, assume all modules can be hot updated\n\t}\n\n\tfunction performHotUpdate(message) {\n\t\tvar changes = message.changes || [];\n\t\t\n\t\t// Framework-specific update handling\n\t\tswitch (framework) {\n\t\t\tcase 'react':\n\t\t\t\tperformReactUpdate(message);\n\t\t\t\tbreak;\n\t\t\tcase 'vue':\n\t\t\t\tperformVueUpdate(message);\n\t\t\t\tbreak;\n\t\t\tcase 'svelte':\n\t\t\t\tperformSvelteUpdate(message);\n\t\t\t\tbreak;\n\t\t\tcase 'solid':\n\t\t\t\tperformSolidUpdate(message);\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\t// Generic update - reload scripts\n\t\t\t\tperformGenericUpdate(message);\n\t\t}\n\t}\n\n\t// ============= React Fast Refresh =============\n\tfunction performReactUpdate(message) {\n\t\tif (!window.__HMR_REACT_REFRESH__) {\n\t\t\t// React Refresh not available, fall back to reload\n\t\t\twindow.location.reload();\n\t\t\treturn;\n\t\t}\n\t\t\n\t\tconsole.log('[HMR] Applying React Fast Refresh...');\n\t\t\n\t\t// Signal to React Refresh that an update is coming\n\t\tif (window.__REACT_REFRESH__) {\n\t\t\ttry {\n\t\t\t\tchanges.forEach(function(file) {\n\t\t\t\t\t// Invalidate the module\n\t\t\t\t\tinvalidateModule(file);\n\t\t\t\t});\n\t\t\t\t\n\t\t\t\t// Trigger React Refresh\n\t\t\t\twindow.__REACT_REFRESH__.performReactRefresh();\n\t\t\t} catch (e) {\n\t\t\t\tconsole.error('[HMR] React Fast Refresh failed:', e);\n\t\t\t\twindow.location.reload();\n\t\t\t}\n\t\t} else {\n\t\t\t// Fallback: reload the page\n\t\t\twindow.location.reload();\n\t\t}\n\t}\n\n\t// ============= Vue HMR =============\n\tfunction performVueUpdate(message) {\n\t\tconsole.log('[HMR] Applying Vue HMR...');\n\t\t\n\t\t// Vue's HMR is handled by vue-loader and vue-hot-reload-api\n\t\tif (window.__VUE_HMR__) {\n\t\t\ttry {\n\t\t\t\tmessage.changes.forEach(function(file) {\n\t\t\t\t\tif (file.endsWith('.vue')) {\n\t\t\t\t\t\twindow.__VUE_HMR__.rerender(file);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t} catch (e) {\n\t\t\t\tconsole.error('[HMR] Vue HMR failed:', e);\n\t\t\t\twindow.location.reload();\n\t\t\t}\n\t\t} else {\n\t\t\twindow.location.reload();\n\t\t}\n\t}\n\n\t// ============= Svelte HMR =============\n\tfunction performSvelteUpdate(message) {\n\t\tconsole.log('[HMR] Applying Svelte HMR...');\n\t\t\n\t\tif (window.__SVELTE_HMR__) {\n\t\t\ttry {\n\t\t\t\tmessage.changes.forEach(function(file) {\n\t\t\t\t\tif (file.endsWith('.svelte')) {\n\t\t\t\t\t\t// Svelte HMR preserves component state\n\t\t\t\t\t\twindow.__SVELTE_HMR__.update(file);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t} catch (e) {\n\t\t\t\tconsole.error('[HMR] Svelte HMR failed:', e);\n\t\t\t\twindow.location.reload();\n\t\t\t}\n\t\t} else {\n\t\t\twindow.location.reload();\n\t\t}\n\t}\n\n\t// ============= Solid HMR =============\n\tfunction performSolidUpdate(message) {\n\t\tconsole.log('[HMR] Applying Solid HMR...');\n\t\t\n\t\tif (window.__SOLID_HMR__) {\n\t\t\ttry {\n\t\t\t\tmessage.changes.forEach(function(file) {\n\t\t\t\t\tinvalidateModule(file);\n\t\t\t\t});\n\t\t\t\t\n\t\t\t\twindow.__SOLID_HMR__.update();\n\t\t\t} catch (e) {\n\t\t\t\tconsole.error('[HMR] Solid HMR failed:', e);\n\t\t\t\twindow.location.reload();\n\t\t\t}\n\t\t} else {\n\t\t\twindow.location.reload();\n\t\t}\n\t}\n\n\t// ============= Generic Update =============\n\tfunction performGenericUpdate(message) {\n\t\tconsole.log('[HMR] Performing generic update...');\n\t\t\n\t\t// For unknown frameworks, reload scripts\n\t\tmessage.changes.forEach(function(file) {\n\t\t\tinvalidateModule(file);\n\t\t});\n\t\t\n\t\t// Reload the page as a fallback\n\t\twindow.location.reload();\n\t}\n\n\t// ============= Module Management =============\n\tfunction invalidateModule(fileId) {\n\t\tmoduleCache.delete(fileId);\n\t\t\n\t\t// Find and reload script tags\n\t\tvar scripts = document.querySelectorAll('script[src]');\n\t\tscripts.forEach(function(script) {\n\t\t\tvar src = script.getAttribute('src');\n\t\t\tif (src && src.includes(fileId)) {\n\t\t\t\treloadScript(script);\n\t\t\t}\n\t\t});\n\t}\n\n\tfunction reloadScript(oldScript) {\n\t\tvar src = oldScript.getAttribute('src');\n\t\tvar newSrc = src.split('?')[0] + '?v=' + Date.now();\n\t\t\n\t\tvar newScript = document.createElement('script');\n\t\tnewScript.src = newSrc;\n\t\tnewScript.type = oldScript.type || 'text/javascript';\n\t\tnewScript.async = false;\n\t\t\n\t\t// Copy attributes\n\t\tArray.from(oldScript.attributes).forEach(function(attr) {\n\t\t\tif (attr.name !== 'src') {\n\t\t\t\tnewScript.setAttribute(attr.name, attr.value);\n\t\t\t}\n\t\t});\n\t\t\n\t\toldScript.parentNode.replaceChild(newScript, oldScript);\n\t}\n\n\t// ============= Error Overlay =============\n\tfunction showOverlay(options) {\n\t\t// Remove existing overlay\n\t\thideOverlay();\n\t\t\n\t\tvar overlay = document.createElement('div');\n\t\toverlay.id = '__hmr-overlay__';\n\t\toverlay.style.cssText = [\n\t\t\t'position: fixed',\n\t\t\t'top: 0',\n\t\t\t'left: 0',\n\t\t\t'right: 0',\n\t\t\t'bottom: 0',\n\t\t\t'background: rgba(0, 0, 0, 0.85)',\n\t\t\t'z-index: 99999',\n\t\t\t'display: flex',\n\t\t\t'align-items: center',\n\t\t\t'justify-content: center',\n\t\t\t'font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif',\n\t\t\t'color: white',\n\t\t\t'padding: 20px'\n\t\t].join(';');\n\t\t\n\t\tvar content = document.createElement('div');\n\t\tcontent.style.cssText = [\n\t\t\t'max-width: 800px',\n\t\t\t'max-height: 80vh',\n\t\t\t'overflow: auto',\n\t\t\t'background: #1a1a1a',\n\t\t\t'border-radius: 8px',\n\t\t\t'padding: 20px',\n\t\t\t'box-shadow: 0 4px 20px rgba(0, 0, 0, 0.5)'\n\t\t].join(';');\n\t\t\n\t\tvar title = document.createElement('h2');\n\t\ttitle.style.cssText = 'color: #ff5555; margin: 0 0 15px 0; font-size: 18px;';\n\t\ttitle.textContent = 'HMR Error';\n\t\t\n\t\tvar message = document.createElement('pre');\n\t\tmessage.style.cssText = [\n\t\t\t'background: #282828',\n\t\t\t'padding: 15px',\n\t\t\t'border-radius: 4px',\n\t\t\t'overflow-x: auto',\n\t\t\t'font-size: 13px',\n\t\t\t'line-height: 1.5',\n\t\t\t'white-space: pre-wrap',\n\t\t\t'word-break: break-word'\n\t\t].join(';');\n\t\tmessage.textContent = options.message;\n\t\t\n\t\tcontent.appendChild(title);\n\t\tcontent.appendChild(message);\n\t\t\n\t\tif (options.stack) {\n\t\t\tvar stack = document.createElement('pre');\n\t\t\tstack.style.cssText = [\n\t\t\t\t'background: #282828',\n\t\t\t\t'padding: 15px',\n\t\t\t\t'border-radius: 4px',\n\t\t\t\t'margin-top: 10px',\n\t\t\t\t'font-size: 12px',\n\t\t\t\t'color: #888',\n\t\t\t\t'overflow-x: auto'\n\t\t\t].join(';');\n\t\t\tstack.textContent = options.stack;\n\t\t\tcontent.appendChild(stack);\n\t\t}\n\t\t\n\t\tif (options.file) {\n\t\t\tvar file = document.createElement('div');\n\t\t\tfile.style.cssText = 'margin-top: 15px; color: #888; font-size: 12px;';\n\t\t\tfile.textContent = 'File: ' + options.file + \n\t\t\t\t(options.line ? ':' + options.line + (options.column ? ':' + options.column : '') : '');\n\t\t\tcontent.appendChild(file);\n\t\t}\n\t\t\n\t\tvar closeBtn = document.createElement('button');\n\t\tcloseBtn.style.cssText = [\n\t\t\t'position: absolute',\n\t\t\t'top: 10px',\n\t\t\t'right: 10px',\n\t\t\t'background: transparent',\n\t\t\t'border: none',\n\t\t\t'color: #888',\n\t\t\t'font-size: 20px',\n\t\t\t'cursor: pointer',\n\t\t\t'padding: 5px'\n\t\t].join(';');\n\t\tcloseBtn.textContent = '\u00D7';\n\t\tcloseBtn.onclick = hideOverlay;\n\t\t\n\t\toverlay.style.position = 'relative';\n\t\toverlay.appendChild(closeBtn);\n\t\toverlay.appendChild(content);\n\t\t\n\t\tdocument.body.appendChild(overlay);\n\t}\n\n\tfunction hideOverlay() {\n\t\tvar overlay = document.getElementById('__hmr-overlay__');\n\t\tif (overlay) {\n\t\t\toverlay.remove();\n\t\t}\n\t}\n\n\t// ============= Subscription Management =============\n\tfunction subscribe(fileId) {\n\t\tsubscribedFiles.add(fileId);\n\t\tsendMessage({ type: 'subscribe', fileId: fileId });\n\t}\n\n\tfunction unsubscribe(fileId) {\n\t\tsubscribedFiles.delete(fileId);\n\t\tsendMessage({ type: 'unsubscribe', fileId: fileId });\n\t}\n\n\t// ============= Initialization =============\n\tfunction init() {\n\t\t// Connect to HMR server\n\t\tconnect();\n\t\t\n\t\t// Subscribe to current page\n\t\tvar currentFile = window.location.pathname;\n\t\tsubscribe(currentFile);\n\t\t\n\t\t// Expose HMR API\n\t\twindow.__HMR__ = {\n\t\t\tsubscribe: subscribe,\n\t\t\tunsubscribe: unsubscribe,\n\t\t\tconnect: connect,\n\t\t\tclientId: function() { return clientId; },\n\t\t\tframework: framework\n\t\t};\n\t\t\n\t\tconsole.log('[HMR] Client initialized (framework: ' + framework + ')');\n\t}\n\n\t// Start when DOM is ready\n\tif (document.readyState === 'complete') {\n\t\tinit();\n\t} else {\n\t\tdocument.addEventListener('DOMContentLoaded', init);\n\t}\n})();\n";
+/**
+ * Get the HMR client script with optional configuration
+ */
+export declare function getHMRClientScript(options?: {
+    port?: number;
+}): string;
+/**
+ * Inject HMR client script into HTML content
+ */
+export declare function injectHMRScript(html: string, port?: number): string;
+//# sourceMappingURL=hmr-client.d.ts.map

package/dist/frontend/hmr-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-client.d.ts","sourceRoot":"","sources":["../../src/frontend/hmr-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,eAAO,MAAM,iBAAiB,m7hBAwmB7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAQT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBnE"}

package/dist/frontend/hmr.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Hot Module Replacement (HMR) Implementation
+ *
+ * Provides live updates without full page refreshes for a better developer experience.
+ * Supports React Fast Refresh, Vue Hot Component Replacement, Svelte HMR, and Solid Hot Reloading.
+ *
+ * @module frontend/hmr
+ */
+import type { FrontendFramework, HMRConfig, HMRUpdate, HMRUpdateError } from "./types.js";
+/**
+ * Manages Hot Module Replacement for the development server.
+ *
+ * Features:
+ * - WebSocket server for client communication
+ * - File watching with dependency tracking
+ * - Framework-specific HMR support (React, Vue, Svelte, Solid)
+ * - Debounced file change handling
+ * - Error overlay support
+ */
+export declare class HMRManager {
+    private config;
+    private logger;
+    private clients;
+    private dependencyGraph;
+    private pendingUpdates;
+    private debounceTimer;
+    private framework;
+    private devServerPort;
+    private watcher;
+    constructor(framework: FrontendFramework, devServerPort: number, config?: Partial<HMRConfig>);
+    /**
+     * Normalize partial config to full config with defaults
+     */
+    private normalizeConfig;
+    /**
+     * Get the HMR client script for injection
+     */
+    getClientScript(): string;
+    /**
+     * Get the WebSocket URL for HMR
+     */
+    getWebSocketUrl(): string;
+    /**
+     * Get the HMR port
+     */
+    getPort(): number;
+    /**
+     * Check if HMR is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Handle WebSocket upgrade request
+     */
+    handleUpgrade(request: Request): WebSocket | null;
+    /**
+     * Handle fetch requests for WebSocket server
+     */
+    private handleWebSocketFetch;
+    /**
+     * Handle WebSocket connection open
+     */
+    private handleWebSocketOpen;
+    /**
+     * Handle WebSocket connection close
+     */
+    private handleWebSocketClose;
+    /**
+     * Handle WebSocket message from client
+     */
+    private handleWebSocketMessage;
+    /**
+     * Send message to a WebSocket client
+     */
+    private sendToClient;
+    /**
+     * Broadcast update to all connected clients
+     */
+    broadcastUpdate(update: HMRUpdate): void;
+    /**
+     * Start file watching
+     */
+    startWatching(rootDir: string): void;
+    /**
+     * Stop file watching
+     */
+    stopWatching(): void;
+    /**
+     * Handle a file change event
+     */
+    private handleFileChange;
+    /**
+     * Check if a file should be ignored
+     */
+    private shouldIgnoreFile;
+    /**
+     * Schedule debounced update processing
+     */
+    private scheduleDebouncedUpdate;
+    /**
+     * Process all pending file updates
+     */
+    private processPendingUpdates;
+    /**
+     * Determine the type of update needed
+     */
+    private determineUpdateType;
+    /**
+     * Handle module accepted from client
+     */
+    private handleModuleAccepted;
+    /**
+     * Register a file in the dependency graph
+     */
+    registerFile(filePath: string, imports?: string[]): void;
+    /**
+     * Get files that depend on a given file
+     */
+    getDependents(filePath: string): string[];
+    /**
+     * Get files that a file imports
+     */
+    getImports(filePath: string): string[];
+    /**
+     * Broadcast an error to all clients
+     */
+    broadcastError(error: Error | HMRUpdateError): void;
+    /**
+     * Generate a unique client ID
+     */
+    private generateClientId;
+    /**
+     * Generate a file ID from a file path
+     */
+    private generateFileId;
+    /**
+     * Get the number of connected clients
+     */
+    getClientCount(): number;
+    /**
+     * Get all connected client IDs
+     */
+    getClientIds(): string[];
+    /**
+     * Disconnect all clients
+     */
+    disconnectAll(): void;
+    /**
+     * Stop the HMR manager
+     */
+    stop(): void;
+    /**
+     * Get framework-specific HMR runtime code
+     */
+    getFrameworkRuntime(): string;
+    /**
+     * React Fast Refresh runtime
+     */
+    private getReactRuntime;
+    /**
+     * Vue HMR runtime
+     */
+    private getVueRuntime;
+    /**
+     * Svelte HMR runtime
+     */
+    private getSvelteRuntime;
+    /**
+     * Solid HMR runtime
+     */
+    private getSolidRuntime;
+}
+/**
+ * Create an HMR manager
+ */
+export declare function createHMRManager(framework: FrontendFramework, devServerPort: number, config?: Partial<HMRConfig>): HMRManager;
+/**
+ * Check if a file is an HMR boundary
+ * (a file that can accept hot updates without propagating to parents)
+ */
+export declare function isHMRBoundary(filePath: string, content: string): boolean;
+/**
+ * Parse imports from a file's content
+ */
+export declare function parseImports(content: string, filePath: string): string[];
+//# sourceMappingURL=hmr.d.ts.map

package/dist/frontend/hmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../../src/frontend/hmr.ts"],"names":[],"mappings":"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"}