hightjs 1.0.4 → 1.0.5

package/dist/bin/hightjs.js

@@ -127,18 +127,54 @@ program
     .command('export')
     .description('Exports the application as static HTML to the "exported" folder.')
     .option('-o, --output <path>', 'Specifies the output directory', 'exported')
+    .option('--assets-dir <path>', 'Directory (inside output) where the .hight assets will be written', '.hight')
+    .option('--no-html', 'Do not generate index.html (assets only)')
     .action(async (options) => {
     const projectDir = process.cwd();
-    // Usar path.resolve é mais seguro para garantir um caminho absoluto
-    const exportDir = path.resolve(projectDir, options.output);
+    // Resolve output:
+    // - se vier absoluto, usa como está
+    // - se vier relativo, resolve a partir do projeto
+    const outputInput = typeof options.output === 'string' && options.output.trim().length
+        ? options.output.trim()
+        : 'exported';
+    const exportDir = path.isAbsolute(outputInput)
+        ? path.resolve(outputInput)
+        : path.resolve(projectDir, outputInput);
+    // Proteções: nunca permitir apagar a raiz do drive (ex: D:\) ou o root do SO (ex: C:\)
+    const exportDirResolved = path.resolve(exportDir);
+    const exportDirRoot = path.parse(exportDirResolved).root; // ex: 'D:\\'
+    const projectDirResolved = path.resolve(projectDir);
+    if (exportDirResolved === exportDirRoot) {
+        throw new Error(`Refusing to use output directory at drive root: ${exportDirResolved}`);
+    }
+    // Também evita `--output .` ou `--output ..` que cairia no diretório do projeto (perigoso)
+    // Regra: output precisa estar dentro do projeto, ou dentro de uma subpasta do projeto.
+    // (mantém comportamento esperado e evita deletar o repo inteiro por acidente)
+    const relExportToProject = path.relative(projectDirResolved, exportDirResolved);
+    if (relExportToProject === '' || relExportToProject === '.' || relExportToProject.startsWith('..')) {
+        throw new Error(`Refusing to export to ${exportDirResolved}. Use a subfolder like "exported" or an explicit path inside the project.`);
+    }
+    // assetsDir: sempre relativo ao exportDir (evita escrever fora sem querer)
+    // Permite usar '.' (raiz do output)
+    const assetsDirInputRaw = typeof options.assetsDir === 'string' ? options.assetsDir : '.hight';
+    const assetsDirInput = assetsDirInputRaw.trim().length ? assetsDirInputRaw.trim() : '.';
+    const assetsDirResolved = path.resolve(exportDirResolved, assetsDirInput);
+    const relAssetsToExport = path.relative(exportDirResolved, assetsDirResolved);
+    if (relAssetsToExport.startsWith('..') || path.isAbsolute(relAssetsToExport)) {
+        throw new Error(`Invalid --assets-dir: must be inside output directory. Received: ${assetsDirInputRaw}`);
+    }
+    // Normaliza a pasta para uso em URL no HTML
+    // Se assets-dir for '.', relAssetsToExport vira '' e assetsBaseHref vira './'
+    const assetsDirUrl = relAssetsToExport.split(path.sep).join('/').replace(/^\.?\/?/, '');
+    const assetsBaseHref = './' + (assetsDirUrl.length ? assetsDirUrl + '/' : '');
     console.log('🚀 Starting export...\n');
     try {
         // 1. Cria a pasta exported (limpa se já existir)
-        if (fs.existsSync(exportDir)) {
+        if (fs.existsSync(exportDirResolved)) {
             console.log('🗑️  Cleaning existing export folder...');
-            fs.rmSync(exportDir, { recursive: true, force: true });
+            fs.rmSync(exportDirResolved, { recursive: true, force: true });
         }
-        fs.mkdirSync(exportDir, { recursive: true });
+        fs.mkdirSync(exportDirResolved, { recursive: true });
         console.log('✅ Export folder created\n');
         // 2. Inicializa e prepara o build
         console.log('🔨 Building application...');
@@ -147,62 +183,62 @@ program
         const app = teste.default({ dev: false, port: 3000, hostname: '0.0.0.0', framework: 'native' });
         await app.prepare();
         console.log('✅ Build complete\n');
-        // 3. Copia a pasta .hight para exported (*** CORRIGIDO ***)
-        const distDir = path.join(projectDir, '.hight');
+        // 3. Copia a pasta .hight para export (respeitando --assets-dir)
+        const distDir = path.join(projectDirResolved, '.hight');
         if (fs.existsSync(distDir)) {
             console.log('📦 Copying JavaScript files...');
-            const exportDistDir = path.join(exportDir, '.hight');
-            // --- Lógica de cópia substituída ---
-            // A função copyDirRecursive agora lida com tudo (arquivos e subpastas)
+            const exportDistDir = assetsDirResolved;
             copyDirRecursive(distDir, exportDistDir);
-            // --- Fim da substituição ---
-            console.log('✅ JavaScript files copied\n');
+            console.log(`✅ JavaScript files copied to: ${path.relative(exportDirResolved, exportDistDir) || '.'}\n`);
         }
-        // 4. Copia a pasta public se existir (*** CORRIGIDO ***)
-        const publicDir = path.join(projectDir, 'public');
+        // 4. Copia a pasta public se existir
+        const publicDir = path.join(projectDirResolved, 'public');
         if (fs.existsSync(publicDir)) {
             console.log('📁 Copying public files...');
-            const exportPublicDir = path.join(exportDir, 'public');
-            // --- Lógica de cópia substituída ---
-            // Reutilizamos a mesma função corrigida
+            const exportPublicDir = path.join(exportDirResolved, 'public');
             copyDirRecursive(publicDir, exportPublicDir);
-            // --- Fim da substituição ---
             console.log('✅ Public files copied\n');
         }
-        // 5. Gera o index.html
-        console.log('📝 Generating index.html...');
-        // ATENÇÃO: Ajuste os caminhos destes 'requires' conforme a estrutura do seu projeto!
-        const { render } = require('../renderer');
-        const { loadRoutes, loadLayout, loadNotFound } = require('../router');
-        // Carrega as rotas para gerar o HTML
-        const userWebDir = path.join(projectDir, 'src', 'web');
-        const userWebRoutesDir = path.join(userWebDir, 'routes');
-        const routes = loadRoutes(userWebRoutesDir);
-        loadLayout(userWebDir);
-        loadNotFound(userWebDir);
-        // Gera HTML para a rota raiz
-        const rootRoute = routes.find(r => r.pattern === '/') || routes[0];
-        if (rootRoute) {
-            const mockReq = {
-                url: '/',
-                method: 'GET',
-                headers: { host: 'localhost' },
-                hwebDev: false,
-                hotReloadManager: null
-            };
-            const html = await render({
-                req: mockReq,
-                route: rootRoute,
-                params: {},
-                allRoutes: routes
-            });
-            const scriptReplaced = html.replace('/_hight/', './.hight/');
-            const indexPath = path.join(exportDir, 'index.html');
-            fs.writeFileSync(indexPath, scriptReplaced, 'utf8');
-            console.log('✅ index.html generated\n');
+        // 5. Gera o index.html (opcional)
+        if (options.html) {
+            console.log('📝 Generating index.html...');
+            // ATENÇÃO: Ajuste os caminhos destes 'requires' conforme a estrutura do seu projeto!
+            const { render } = require('../renderer');
+            const { loadRoutes, loadLayout, loadNotFound } = require('../router');
+            // Carrega as rotas para gerar o HTML
+            const userWebDir = path.join(projectDirResolved, 'src', 'web');
+            const userWebRoutesDir = path.join(userWebDir, 'routes');
+            const routes = loadRoutes(userWebRoutesDir);
+            loadLayout(userWebDir);
+            loadNotFound(userWebDir);
+            // Gera HTML para a rota raiz
+            const rootRoute = routes.find(r => r.pattern === '/') || routes[0];
+            if (rootRoute) {
+                const mockReq = {
+                    url: '/',
+                    method: 'GET',
+                    headers: { host: 'localhost' },
+                    hwebDev: false,
+                    hotReloadManager: null
+                };
+                const html = await render({
+                    req: mockReq,
+                    route: rootRoute,
+                    params: {},
+                    allRoutes: routes
+                });
+                // Mantém o padrão /_hight/ mas permite trocar o destino no export
+                const scriptReplaced = html.replace(/\/_hight\//g, assetsBaseHref);
+                const indexPath = path.join(exportDirResolved, 'index.html');
+                fs.writeFileSync(indexPath, scriptReplaced, 'utf8');
+                console.log('✅ index.html generated\n');
+            }
+        }
+        else {
+            console.log('⏭️  Skipping index.html generation (--no-html)\n');
         }
         console.log('🎉 Export completed successfully!');
-        console.log(`📂 Files exported to: ${exportDir}\n`);
+        console.log(`📂 Files exported to: ${exportDirResolved}\n`);
     }
     catch (error) {
         // Logar o erro completo (com stack trace) é mais útil

package/dist/builder.js

@@ -143,6 +143,58 @@ const npmDependenciesPlugin = {
         });
     }
 };
+/**
+ * Plugin para resolver aliases do tsconfig.json (como @/)
+ */
+const aliasResolvePlugin = {
+    name: 'alias-resolve',
+    setup(build) {
+        const projectDir = process.cwd();
+        const tsconfigPath = path.join(projectDir, 'tsconfig.json');
+        let aliases = {};
+        // Lê o tsconfig.json para pegar os paths
+        if (fs.existsSync(tsconfigPath)) {
+            try {
+                const tsconfigContent = fs.readFileSync(tsconfigPath, 'utf8');
+                // Remove comentários do JSON (tsconfig pode ter comentários)
+                const jsonContent = tsconfigContent.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '');
+                const tsconfig = JSON.parse(jsonContent);
+                if (tsconfig.compilerOptions?.paths) {
+                    const baseUrl = tsconfig.compilerOptions.baseUrl || '.';
+                    const basePath = path.resolve(projectDir, baseUrl);
+                    // Converte os paths do tsconfig para aliases
+                    for (const [alias, paths] of Object.entries(tsconfig.compilerOptions.paths)) {
+                        if (Array.isArray(paths) && paths.length > 0) {
+                            // Remove o /* do final do alias e do path
+                            const cleanAlias = alias.replace(/\/\*$/, '');
+                            const cleanPath = paths[0].replace(/\/\*$/, '');
+                            aliases[cleanAlias] = path.resolve(basePath, cleanPath);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                Console.warn('Error reading tsconfig.json for aliases:', error.message);
+            }
+        }
+        // Se tem aliases configurados, resolve eles
+        if (Object.keys(aliases).length > 0) {
+            build.onResolve({ filter: /.*/ }, (args) => {
+                // Verifica se o import começa com algum alias
+                for (const [alias, aliasPath] of Object.entries(aliases)) {
+                    if (args.path === alias || args.path.startsWith(alias + '/')) {
+                        const relativePath = args.path.slice(alias.length);
+                        const resolvedPath = path.join(aliasPath, relativePath);
+                        return {
+                            path: resolvedPath
+                        };
+                    }
+                }
+                return null;
+            });
+        }
+    }
+};
 /**
  * Plugin para garantir que React seja corretamente resolvido
  */
@@ -368,7 +420,7 @@ async function buildWithChunks(entryPoint, outdir, isProduction = false) {
             outdir: outdir,
             loader: { '.js': 'js', '.ts': 'tsx' },
             external: nodeBuiltIns,
-            plugins: [postcssPlugin, npmDependenciesPlugin, reactResolvePlugin, markdownPlugin, assetsPlugin],
+            plugins: [postcssPlugin, npmDependenciesPlugin, aliasResolvePlugin, reactResolvePlugin, markdownPlugin, assetsPlugin],
             format: 'esm', // ESM suporta melhor o code splitting
             jsx: 'automatic',
             define: {
@@ -429,7 +481,7 @@ async function watchWithChunks(entryPoint, outdir, hotReloadManager = null) {
             outdir: outdir,
             loader: { '.js': 'js', '.ts': 'tsx' },
             external: nodeBuiltIns,
-            plugins: [postcssPlugin, npmDependenciesPlugin, reactResolvePlugin, hmrPlugin, buildCompletePlugin, markdownPlugin, assetsPlugin],
+            plugins: [postcssPlugin, npmDependenciesPlugin, aliasResolvePlugin, reactResolvePlugin, hmrPlugin, buildCompletePlugin, markdownPlugin, assetsPlugin],
             format: 'esm',
             jsx: 'automatic',
             define: {
@@ -473,7 +525,7 @@ async function build(entryPoint, outfile, isProduction = false) {
             outfile: outfile,
             loader: { '.js': 'js', '.ts': 'tsx' },
             external: nodeBuiltIns,
-            plugins: [postcssPlugin, npmDependenciesPlugin, reactResolvePlugin, markdownPlugin, assetsPlugin],
+            plugins: [postcssPlugin, npmDependenciesPlugin, aliasResolvePlugin, reactResolvePlugin, markdownPlugin, assetsPlugin],
             format: 'iife',
             globalName: 'HwebApp',
             jsx: 'automatic',
@@ -535,6 +587,7 @@ async function watch(entryPoint, outfile, hotReloadManager = null) {
             outfile: outfile,
             loader: { '.js': 'js', '.ts': 'tsx' },
             external: nodeBuiltIns,
+            plugins: [postcssPlugin, npmDependenciesPlugin, aliasResolvePlugin, reactResolvePlugin, hmrPlugin, buildCompletePlugin, markdownPlugin, assetsPlugin],
             format: 'iife',
             globalName: 'HwebApp',
             jsx: 'automatic',

package/dist/client/entry.client.js

@@ -160,7 +160,6 @@ function App({ componentMap, routes, initialComponentPath, initialParams, layout
         if (match) {
             setCurrentPageComponent(() => componentMap[match.componentPath]);
             setParams(match.params);
-            // setar o titulo da página se necessário
         }
         else {
             // Se não encontrou rota, define como null para mostrar 404

package/dist/loaders.js

@@ -16,11 +16,103 @@
  * limitations under the License.
  */
 const fs = require('fs');
+const path = require('path');
+const Module = require('module');
+/**
+ * Carrega e processa o tsconfig.json para obter os aliases
+ */
+function loadTsConfigAliases() {
+    const projectDir = process.cwd();
+    const tsconfigPath = path.join(projectDir, 'tsconfig.json');
+    const aliases = {};
+    if (fs.existsSync(tsconfigPath)) {
+        try {
+            const tsconfigContent = fs.readFileSync(tsconfigPath, 'utf8');
+            // Remove comentários JSONC de forma mais robusta
+            let jsonContent = tsconfigContent
+                // Remove comentários de linha // (mas não em strings)
+                .replace(/(?:^|\s)\/\/.*$/gm, '')
+                // Remove comentários de bloco /* */
+                .replace(/\/\*[\s\S]*?\*\//g, '')
+                // Remove vírgulas finais (trailing commas) que JSON não aceita
+                .replace(/,(\s*[}\]])/g, '$1');
+            const tsconfig = JSON.parse(jsonContent);
+            if (tsconfig.compilerOptions?.paths) {
+                const baseUrl = tsconfig.compilerOptions.baseUrl || '.';
+                const basePath = path.resolve(projectDir, baseUrl);
+                // Converte os paths do tsconfig para aliases
+                for (const [alias, paths] of Object.entries(tsconfig.compilerOptions.paths)) {
+                    if (Array.isArray(paths) && paths.length > 0) {
+                        // Remove o /* do final
+                        const cleanAlias = alias.replace(/\/\*$/, '');
+                        const cleanPath = paths[0].replace(/\/\*$/, '');
+                        aliases[cleanAlias] = path.resolve(basePath, cleanPath);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Silenciosamente ignora erros de parsing do tsconfig
+        }
+    }
+    return aliases;
+}
 /**
  * Registra loaders customizados para Node.js
  * Permite importar arquivos não-JS diretamente no servidor
  */
 function registerLoaders() {
+    // Registra resolver de aliases do tsconfig.json
+    const aliases = loadTsConfigAliases();
+    if (Object.keys(aliases).length > 0) {
+        // Guarda referência ao _resolveFilename atual (pode já ter sido modificado por source-map-support)
+        const originalResolveFilename = Module._resolveFilename;
+        Module._resolveFilename = function (request, parent, isMain, options) {
+            // Verifica se o request começa com algum alias
+            for (const [alias, aliasPath] of Object.entries(aliases)) {
+                if (request === alias || request.startsWith(alias + '/')) {
+                    const relativePath = request.slice(alias.length);
+                    const resolvedPath = path.join(aliasPath, relativePath);
+                    // Tenta resolver com diferentes extensões
+                    const extensions = ['.tsx', '.ts', '.jsx', '.js'];
+                    // Primeiro tenta o caminho exato
+                    if (fs.existsSync(resolvedPath)) {
+                        const stats = fs.statSync(resolvedPath);
+                        if (stats.isFile()) {
+                            // Retorna o caminho resolvido diretamente
+                            request = resolvedPath;
+                            break;
+                        }
+                    }
+                    // Tenta com extensões
+                    let resolved = false;
+                    for (const ext of extensions) {
+                        const pathWithExt = resolvedPath + ext;
+                        if (fs.existsSync(pathWithExt)) {
+                            request = pathWithExt;
+                            resolved = true;
+                            break;
+                        }
+                    }
+                    if (resolved)
+                        break;
+                    // Tenta como diretório com index
+                    for (const ext of extensions) {
+                        const indexPath = path.join(resolvedPath, 'index' + ext);
+                        if (fs.existsSync(indexPath)) {
+                            request = indexPath;
+                            resolved = true;
+                            break;
+                        }
+                    }
+                    if (resolved)
+                        break;
+                }
+            }
+            // Chama o resolver original (que pode ser do source-map-support)
+            return originalResolveFilename.call(this, request, parent, isMain, options);
+        };
+    }
     // Loader para arquivos Markdown (.md)
     require.extensions['.md'] = function (module, filename) {
         const content = fs.readFileSync(filename, 'utf8');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hightjs",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "HightJS is a high-level framework for building web applications with ease and speed. It provides a robust set of tools and features to streamline development and enhance productivity.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/bin/hightjs.js

@@ -148,20 +148,64 @@ program
     .command('export')
     .description('Exports the application as static HTML to the "exported" folder.')
     .option('-o, --output <path>', 'Specifies the output directory', 'exported')
+    .option('--assets-dir <path>', 'Directory (inside output) where the .hight assets will be written', '.hight')
+    .option('--no-html', 'Do not generate index.html (assets only)')
     .action(async (options) => {
         const projectDir = process.cwd();
-        // Usar path.resolve é mais seguro para garantir um caminho absoluto
-        const exportDir = path.resolve(projectDir, options.output);
+
+        // Resolve output:
+        // - se vier absoluto, usa como está
+        // - se vier relativo, resolve a partir do projeto
+        const outputInput = typeof options.output === 'string' && options.output.trim().length
+            ? options.output.trim()
+            : 'exported';
+        const exportDir = path.isAbsolute(outputInput)
+            ? path.resolve(outputInput)
+            : path.resolve(projectDir, outputInput);
+
+        // Proteções: nunca permitir apagar a raiz do drive (ex: D:\) ou o root do SO (ex: C:\)
+        const exportDirResolved = path.resolve(exportDir);
+        const exportDirRoot = path.parse(exportDirResolved).root; // ex: 'D:\\'
+        const projectDirResolved = path.resolve(projectDir);
+
+        if (exportDirResolved === exportDirRoot) {
+            throw new Error(`Refusing to use output directory at drive root: ${exportDirResolved}`);
+        }
+
+        // Também evita `--output .` ou `--output ..` que cairia no diretório do projeto (perigoso)
+        // Regra: output precisa estar dentro do projeto, ou dentro de uma subpasta do projeto.
+        // (mantém comportamento esperado e evita deletar o repo inteiro por acidente)
+        const relExportToProject = path.relative(projectDirResolved, exportDirResolved);
+        if (relExportToProject === '' || relExportToProject === '.' || relExportToProject.startsWith('..')) {
+            throw new Error(
+                `Refusing to export to ${exportDirResolved}. Use a subfolder like "exported" or an explicit path inside the project.`
+            );
+        }
+
+        // assetsDir: sempre relativo ao exportDir (evita escrever fora sem querer)
+        // Permite usar '.' (raiz do output)
+        const assetsDirInputRaw = typeof options.assetsDir === 'string' ? options.assetsDir : '.hight';
+        const assetsDirInput = assetsDirInputRaw.trim().length ? assetsDirInputRaw.trim() : '.';
+        const assetsDirResolved = path.resolve(exportDirResolved, assetsDirInput);
+        const relAssetsToExport = path.relative(exportDirResolved, assetsDirResolved);
+        if (relAssetsToExport.startsWith('..') || path.isAbsolute(relAssetsToExport)) {
+            throw new Error(`Invalid --assets-dir: must be inside output directory. Received: ${assetsDirInputRaw}`);
+        }
+
+        // Normaliza a pasta para uso em URL no HTML
+        // Se assets-dir for '.', relAssetsToExport vira '' e assetsBaseHref vira './'
+        const assetsDirUrl = relAssetsToExport.split(path.sep).join('/').replace(/^\.?\/?/, '');
+        const assetsBaseHref = './' + (assetsDirUrl.length ? assetsDirUrl + '/' : '');
 
         console.log('🚀 Starting export...\n');
 
         try {
             // 1. Cria a pasta exported (limpa se já existir)
-            if (fs.existsSync(exportDir)) {
+            if (fs.existsSync(exportDirResolved)) {
                 console.log('🗑️  Cleaning existing export folder...');
-                fs.rmSync(exportDir, { recursive: true, force: true });
+                fs.rmSync(exportDirResolved, { recursive: true, force: true });
             }
-            fs.mkdirSync(exportDir, { recursive: true });
+            fs.mkdirSync(exportDirResolved, { recursive: true });
             console.log('✅ Export folder created\n');
 
             // 2. Inicializa e prepara o build
@@ -172,74 +216,74 @@ program
             await app.prepare();
             console.log('✅ Build complete\n');
 
-            // 3. Copia a pasta .hight para exported (*** CORRIGIDO ***)
-            const distDir = path.join(projectDir, '.hight');
+            // 3. Copia a pasta .hight para export (respeitando --assets-dir)
+            const distDir = path.join(projectDirResolved, '.hight');
             if (fs.existsSync(distDir)) {
                 console.log('📦 Copying JavaScript files...');
-                const exportDistDir = path.join(exportDir, '.hight');
+                const exportDistDir = assetsDirResolved;
 
-                // --- Lógica de cópia substituída ---
-                // A função copyDirRecursive agora lida com tudo (arquivos e subpastas)
                 copyDirRecursive(distDir, exportDistDir);
-                // --- Fim da substituição ---
 
-                console.log('✅ JavaScript files copied\n');
+                console.log(`✅ JavaScript files copied to: ${path.relative(exportDirResolved, exportDistDir) || '.'}\n`);
             }
 
-            // 4. Copia a pasta public se existir (*** CORRIGIDO ***)
-            const publicDir = path.join(projectDir, 'public');
+            // 4. Copia a pasta public se existir
+            const publicDir = path.join(projectDirResolved, 'public');
             if (fs.existsSync(publicDir)) {
                 console.log('📁 Copying public files...');
-                const exportPublicDir = path.join(exportDir, 'public');
+                const exportPublicDir = path.join(exportDirResolved, 'public');
 
-                // --- Lógica de cópia substituída ---
-                // Reutilizamos a mesma função corrigida
                 copyDirRecursive(publicDir, exportPublicDir);
-                // --- Fim da substituição ---
 
                 console.log('✅ Public files copied\n');
             }
 
-            // 5. Gera o index.html
-            console.log('📝 Generating index.html...');
-            // ATENÇÃO: Ajuste os caminhos destes 'requires' conforme a estrutura do seu projeto!
-            const { render } = require('../renderer');
-            const { loadRoutes, loadLayout, loadNotFound } = require('../router');
-
-            // Carrega as rotas para gerar o HTML
-            const userWebDir = path.join(projectDir, 'src', 'web');
-            const userWebRoutesDir = path.join(userWebDir, 'routes');
-
-            const routes = loadRoutes(userWebRoutesDir);
-            loadLayout(userWebDir);
-            loadNotFound(userWebDir);
-
-            // Gera HTML para a rota raiz
-            const rootRoute = routes.find(r => r.pattern === '/') || routes[0];
-
-            if (rootRoute) {
-                const mockReq = {
-                    url: '/',
-                    method: 'GET',
-                    headers: { host: 'localhost' },
-                    hwebDev: false,
-                    hotReloadManager: null
-                };
-
-                const html = await render({
-                    req: mockReq,
-                    route: rootRoute,
-                    params: {},
-                    allRoutes: routes
-                });
-                const scriptReplaced = html.replace('/_hight/', './.hight/');
-                const indexPath = path.join(exportDir, 'index.html');
-                fs.writeFileSync(indexPath, scriptReplaced, 'utf8');
-                console.log('✅ index.html generated\n');
+            // 5. Gera o index.html (opcional)
+            if (options.html) {
+                console.log('📝 Generating index.html...');
+                // ATENÇÃO: Ajuste os caminhos destes 'requires' conforme a estrutura do seu projeto!
+                const { render } = require('../renderer');
+                const { loadRoutes, loadLayout, loadNotFound } = require('../router');
+
+                // Carrega as rotas para gerar o HTML
+                const userWebDir = path.join(projectDirResolved, 'src', 'web');
+                const userWebRoutesDir = path.join(userWebDir, 'routes');
+
+                const routes = loadRoutes(userWebRoutesDir);
+                loadLayout(userWebDir);
+                loadNotFound(userWebDir);
+
+                // Gera HTML para a rota raiz
+                const rootRoute = routes.find(r => r.pattern === '/') || routes[0];
+
+                if (rootRoute) {
+                    const mockReq = {
+                        url: '/',
+                        method: 'GET',
+                        headers: { host: 'localhost' },
+                        hwebDev: false,
+                        hotReloadManager: null
+                    };
+
+                    const html = await render({
+                        req: mockReq,
+                        route: rootRoute,
+                        params: {},
+                        allRoutes: routes
+                    });
+
+                    // Mantém o padrão /_hight/ mas permite trocar o destino no export
+                    const scriptReplaced = html.replace(/\/_hight\//g, assetsBaseHref);
+                    const indexPath = path.join(exportDirResolved, 'index.html');
+                    fs.writeFileSync(indexPath, scriptReplaced, 'utf8');
+                    console.log('✅ index.html generated\n');
+                }
+            } else {
+                console.log('⏭️  Skipping index.html generation (--no-html)\n');
             }
 
             console.log('🎉 Export completed successfully!');
-            console.log(`📂 Files exported to: ${exportDir}\n`);
+            console.log(`📂 Files exported to: ${exportDirResolved}\n`);
 
         } catch (error) {
             // Logar o erro completo (com stack trace) é mais útil

package/src/builder.js

@@ -153,6 +153,64 @@ const npmDependenciesPlugin = {
     }
 };
 
+/**
+ * Plugin para resolver aliases do tsconfig.json (como @/)
+ */
+const aliasResolvePlugin = {
+    name: 'alias-resolve',
+    setup(build) {
+        const projectDir = process.cwd();
+        const tsconfigPath = path.join(projectDir, 'tsconfig.json');
+
+        let aliases = {};
+
+        // Lê o tsconfig.json para pegar os paths
+        if (fs.existsSync(tsconfigPath)) {
+            try {
+                const tsconfigContent = fs.readFileSync(tsconfigPath, 'utf8');
+                // Remove comentários do JSON (tsconfig pode ter comentários)
+                const jsonContent = tsconfigContent.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '');
+                const tsconfig = JSON.parse(jsonContent);
+
+                if (tsconfig.compilerOptions?.paths) {
+                    const baseUrl = tsconfig.compilerOptions.baseUrl || '.';
+                    const basePath = path.resolve(projectDir, baseUrl);
+
+                    // Converte os paths do tsconfig para aliases
+                    for (const [alias, paths] of Object.entries(tsconfig.compilerOptions.paths)) {
+                        if (Array.isArray(paths) && paths.length > 0) {
+                            // Remove o /* do final do alias e do path
+                            const cleanAlias = alias.replace(/\/\*$/, '');
+                            const cleanPath = paths[0].replace(/\/\*$/, '');
+                            aliases[cleanAlias] = path.resolve(basePath, cleanPath);
+                        }
+                    }
+                }
+            } catch (error) {
+                Console.warn('Error reading tsconfig.json for aliases:', error.message);
+            }
+        }
+
+        // Se tem aliases configurados, resolve eles
+        if (Object.keys(aliases).length > 0) {
+            build.onResolve({ filter: /.*/ }, (args) => {
+                // Verifica se o import começa com algum alias
+                for (const [alias, aliasPath] of Object.entries(aliases)) {
+                    if (args.path === alias || args.path.startsWith(alias + '/')) {
+                        const relativePath = args.path.slice(alias.length);
+                        const resolvedPath = path.join(aliasPath, relativePath);
+
+                        return {
+                            path: resolvedPath
+                        };
+                    }
+                }
+                return null;
+            });
+        }
+    }
+};
+
 /**
  * Plugin para garantir que React seja corretamente resolvido
  */
@@ -411,7 +469,7 @@ async function buildWithChunks(entryPoint, outdir, isProduction = false) {
       outdir: outdir,
       loader: { '.js': 'js', '.ts': 'tsx' },
       external: nodeBuiltIns,
-      plugins: [postcssPlugin, npmDependenciesPlugin, reactResolvePlugin, markdownPlugin, assetsPlugin],
+      plugins: [postcssPlugin, npmDependenciesPlugin, aliasResolvePlugin, reactResolvePlugin, markdownPlugin, assetsPlugin],
       format: 'esm', // ESM suporta melhor o code splitting
       jsx: 'automatic',
       define: {
@@ -473,7 +531,7 @@ async function watchWithChunks(entryPoint, outdir, hotReloadManager = null) {
             outdir: outdir,
             loader: { '.js': 'js', '.ts': 'tsx' },
             external: nodeBuiltIns,
-            plugins: [postcssPlugin, npmDependenciesPlugin, reactResolvePlugin, hmrPlugin, buildCompletePlugin, markdownPlugin, assetsPlugin],
+            plugins: [postcssPlugin, npmDependenciesPlugin, aliasResolvePlugin, reactResolvePlugin, hmrPlugin, buildCompletePlugin, markdownPlugin, assetsPlugin],
             format: 'esm',
             jsx: 'automatic',
             define: {
@@ -519,7 +577,7 @@ async function build(entryPoint, outfile, isProduction = false) {
       outfile: outfile,
       loader: { '.js': 'js', '.ts': 'tsx' },
       external: nodeBuiltIns,
-      plugins: [postcssPlugin, npmDependenciesPlugin, reactResolvePlugin, markdownPlugin, assetsPlugin],
+      plugins: [postcssPlugin, npmDependenciesPlugin, aliasResolvePlugin, reactResolvePlugin, markdownPlugin, assetsPlugin],
       format: 'iife',
       globalName: 'HwebApp',
       jsx: 'automatic',
@@ -582,6 +640,7 @@ async function watch(entryPoint, outfile, hotReloadManager = null) {
             outfile: outfile,
             loader: { '.js': 'js', '.ts': 'tsx' },
             external: nodeBuiltIns,
+            plugins: [postcssPlugin, npmDependenciesPlugin, aliasResolvePlugin, reactResolvePlugin, hmrPlugin, buildCompletePlugin, markdownPlugin, assetsPlugin],
             format: 'iife',
             globalName: 'HwebApp',
             jsx: 'automatic',

package/src/client/entry.client.tsx

@@ -152,8 +152,6 @@ function App({ componentMap, routes, initialComponentPath, initialParams, layout
         if (match) {
             setCurrentPageComponent(() => componentMap[match.componentPath]);
             setParams(match.params);
-            // setar o titulo da página se necessário
-
         } else {
             // Se não encontrou rota, define como null para mostrar 404
             setCurrentPageComponent(null);

package/src/loaders.js

@@ -16,12 +16,119 @@
  */
 
 const fs = require('fs');
+const path = require('path');
+const Module = require('module');
+
+/**
+ * Carrega e processa o tsconfig.json para obter os aliases
+ */
+function loadTsConfigAliases() {
+    const projectDir = process.cwd();
+    const tsconfigPath = path.join(projectDir, 'tsconfig.json');
+
+    const aliases = {};
+
+    if (fs.existsSync(tsconfigPath)) {
+        try {
+            const tsconfigContent = fs.readFileSync(tsconfigPath, 'utf8');
+
+            // Remove comentários JSONC de forma mais robusta
+            let jsonContent = tsconfigContent
+                // Remove comentários de linha // (mas não em strings)
+                .replace(/(?:^|\s)\/\/.*$/gm, '')
+                // Remove comentários de bloco /* */
+                .replace(/\/\*[\s\S]*?\*\//g, '')
+                // Remove vírgulas finais (trailing commas) que JSON não aceita
+                .replace(/,(\s*[}\]])/g, '$1');
+
+            const tsconfig = JSON.parse(jsonContent);
+
+            if (tsconfig.compilerOptions?.paths) {
+                const baseUrl = tsconfig.compilerOptions.baseUrl || '.';
+                const basePath = path.resolve(projectDir, baseUrl);
+
+                // Converte os paths do tsconfig para aliases
+                for (const [alias, paths] of Object.entries(tsconfig.compilerOptions.paths)) {
+                    if (Array.isArray(paths) && paths.length > 0) {
+                        // Remove o /* do final
+                        const cleanAlias = alias.replace(/\/\*$/, '');
+                        const cleanPath = paths[0].replace(/\/\*$/, '');
+                        aliases[cleanAlias] = path.resolve(basePath, cleanPath);
+                    }
+                }
+            }
+        } catch (error) {
+            // Silenciosamente ignora erros de parsing do tsconfig
+        }
+    }
+
+    return aliases;
+}
 
 /**
  * Registra loaders customizados para Node.js
  * Permite importar arquivos não-JS diretamente no servidor
  */
 function registerLoaders() {
+    // Registra resolver de aliases do tsconfig.json
+    const aliases = loadTsConfigAliases();
+
+    if (Object.keys(aliases).length > 0) {
+        // Guarda referência ao _resolveFilename atual (pode já ter sido modificado por source-map-support)
+        const originalResolveFilename = Module._resolveFilename;
+
+        Module._resolveFilename = function (request, parent, isMain, options) {
+            // Verifica se o request começa com algum alias
+            for (const [alias, aliasPath] of Object.entries(aliases)) {
+                if (request === alias || request.startsWith(alias + '/')) {
+                    const relativePath = request.slice(alias.length);
+                    const resolvedPath = path.join(aliasPath, relativePath);
+
+                    // Tenta resolver com diferentes extensões
+                    const extensions = ['.tsx', '.ts', '.jsx', '.js'];
+
+                    // Primeiro tenta o caminho exato
+                    if (fs.existsSync(resolvedPath)) {
+                        const stats = fs.statSync(resolvedPath);
+                        if (stats.isFile()) {
+                            // Retorna o caminho resolvido diretamente
+                            request = resolvedPath;
+                            break;
+                        }
+                    }
+
+                    // Tenta com extensões
+                    let resolved = false;
+                    for (const ext of extensions) {
+                        const pathWithExt = resolvedPath + ext;
+                        if (fs.existsSync(pathWithExt)) {
+                            request = pathWithExt;
+                            resolved = true;
+                            break;
+                        }
+                    }
+
+                    if (resolved) break;
+
+                    // Tenta como diretório com index
+                    for (const ext of extensions) {
+                        const indexPath = path.join(resolvedPath, 'index' + ext);
+                        if (fs.existsSync(indexPath)) {
+                            request = indexPath;
+                            resolved = true;
+                            break;
+                        }
+                    }
+
+                    if (resolved) break;
+                }
+            }
+
+            // Chama o resolver original (que pode ser do source-map-support)
+            return originalResolveFilename.call(this, request, parent, isMain, options);
+        };
+    }
+
     // Loader para arquivos Markdown (.md)
     require.extensions['.md'] = function (module, filename) {
         const content = fs.readFileSync(filename, 'utf8');