proteum 1.0.2 → 1.0.3

package/AGENTS.md

@@ -0,0 +1,9 @@
+# Workflow
+
+- Everytime I input error messages without any instructions, don't implement fixes.
+Instead, ivestigate the potential causes of the errors, and for each: 
+  1. Evaluate / quantify the probabiliies 
+  2. Give why and 
+  3. Suggest how to fix it
+- When you have finished your work, summarize in one top-level short sentence ALL the changes you made since the beginning of the WHOLE conversation. Output as "Commit message". Max 90 characters.
+

package/cli/app/config.ts

@@ -24,7 +24,8 @@ export default class ConfigParser {
 
     public constructor(
         public appDir: string,
-        public envName?: string
+        public envName?: string,
+        public routerPortOverride?: number
     ) {
 
     }
@@ -43,6 +44,12 @@ export default class ConfigParser {
         const envFile = this.loadYaml( envFileName );
         return {
             ...envFile,
+            router: this.routerPortOverride === undefined
+                ? envFile.router
+                : {
+                    ...envFile.router,
+                    port: this.routerPortOverride
+                },
             version: 'CLI'
         }
     }

package/cli/app/index.ts

@@ -37,6 +37,23 @@ type TServiceSubservices = {
     [key: string]: TServiceSetup | TServiceRef
 }
 
+const parseRouterPortOverride = (
+    rawPort: string | boolean | string[] | undefined
+): number | undefined => {
+
+    if (rawPort === undefined || rawPort === '')
+        return undefined;
+
+    if (typeof rawPort !== 'string')
+        throw new Error(`Invalid value for -port: expected a numeric value.`);
+
+    const port = Number(rawPort);
+    if (!Number.isInteger(port) || port < 1 || port > 65535)
+        throw new Error(`Invalid value for -port: "${rawPort}". Expected an integer between 1 and 65535.`);
+
+    return port;
+}
+
 /*----------------------------------
 - SERVICE
 ----------------------------------*/
@@ -49,6 +66,8 @@ export class App {
 
     public env: TEnvConfig;
 
+    public routerPortOverride?: number;
+
     public packageJson: {[key: string]: any};
 
     public buildId: number = Date.now();
@@ -57,6 +76,7 @@ export class App {
 
         root: cli.paths.appRoot,
         bin: path.join( cli.paths.appRoot, 'bin'),
+        dev: path.join( cli.paths.appRoot, 'dev'),
         data: path.join( cli.paths.appRoot, 'var', 'data'),
         public: path.join( cli.paths.appRoot, 'public'),
         pages: path.join( cli.paths.appRoot, 'client', 'pages'),
@@ -92,13 +112,25 @@ export class App {
     public constructor() {
         
         cli.debug && console.log(`[cli] Loading app config ...`);
-        const configParser = new ConfigParser( cli.paths.appRoot );
+        this.routerPortOverride = parseRouterPortOverride( cli.args.port );
+
+        const configParser = new ConfigParser(
+            cli.paths.appRoot,
+            undefined,
+            this.routerPortOverride
+        );
         this.identity = configParser.identity();
         this.env = configParser.env();
         this.packageJson = this.loadPkg();
         
     }
 
+    public outputPath(target: 'dev' | 'bin') {
+        return target === 'dev'
+            ? this.paths.dev
+            : this.paths.bin;
+    }
+
     /*----------------------------------
     - ALIAS
     ----------------------------------*/

package/cli/commands/build.ts

@@ -2,33 +2,59 @@
 - DEPENDANCES
 ----------------------------------*/
 
-// Npm
-import prompts from 'prompts';
+// Core
+import cli from '..';
 
 // Configs
 import Compiler from '../compiler';
+import type { TCompileMode } from '../compiler/common';
 
-/*----------------------------------
-- TYPES
-----------------------------------*/
+const allowedBuildArgs = new Set(['dev', 'prod', 'analyze', 'cache']);
 
 /*----------------------------------
 - COMMAND
 ----------------------------------*/
-export const run = (): Promise<void> => new Promise(async (resolve) => {
+function resolveBuildMode(): TCompileMode {
+
+    const enabledArgs = Object.entries(cli.args)
+        .filter(([name, value]) => name !== 'workdir' && value === true)
+        .map(([name]) => name);
+
+    const invalidArgs = enabledArgs.filter(arg => !allowedBuildArgs.has(arg));
+    if (invalidArgs.length > 0)
+        throw new Error(`Unknown build argument(s): ${invalidArgs.join(', ')}. Allowed values: dev, prod, analyze, cache.`);
 
-    const compiler = new Compiler('prod');
+    const requestedModes = enabledArgs.filter((arg): arg is TCompileMode =>
+        arg === 'dev' || arg === 'prod'
+    );
+    if (requestedModes.length > 1)
+        throw new Error(`Please specify only one build mode. Received: ${requestedModes.join(', ')}.`);
 
+    return requestedModes[0] ?? 'dev';
+}
+
+export const run = async (): Promise<void> => {
+
+    const mode = resolveBuildMode();
+    const compiler = new Compiler(mode, {}, false, 'bin');
     const multiCompiler = await compiler.create();
 
-    multiCompiler.run((error, stats) => {
+    await new Promise<void>((resolve, reject) => {
+        multiCompiler.run((error, stats) => {
+
+            if (error) {
+                console.error("An error occurred during the compilation:", error);
+                reject(error);
+                return;
+            }
 
-        if (error) {
-            console.error("An error occurred during the compilation:", error);
-            throw error;
-        }
+            if (stats?.hasErrors()) {
+                reject(new Error(`Compilation failed for build mode "${mode}".`));
+                return;
+            }
 
-        //resolve();
+            resolve();
+        });
 
     });
-});
+};

package/cli/commands/dev.ts

@@ -3,7 +3,7 @@
 ----------------------------------*/
 
 // Npm
-import fs from 'fs-extra';
+import path from 'path';
 import { spawn, ChildProcess } from 'child_process';
 
 // Cor elibs
@@ -16,6 +16,8 @@ import Compiler from '../compiler';
 // Core
 import { app, App } from '../app';
 
+const ignoredWatchPathPatterns = /(node_modules\/(?!proteum\/))|(\.generated\/)|(\.cache\/)/;
+
 /*----------------------------------
 - COMMANDE
 ----------------------------------*/
@@ -39,6 +41,7 @@ export const run = () => new Promise<void>(async () => {
     });
 
     const multiCompiler = await compiler.create();
+    const ignoredOutputPaths = [app.paths.bin, app.paths.dev].map(normalizeWatchPath);
 
     multiCompiler.watch({
 
@@ -51,7 +54,15 @@ export const run = () => new Promise<void>(async () => {
         // Ignore updated from:
         // - Node modules except 5HTP core (framework dev mode)
         // - Generated files during runtime (cause infinite loop. Ex: models.d.ts)
-        ignored: /(node_modules\/(?!proteum\/))|(\.generated\/)|(\.cache\/)/
+        // - Webpack output folders (`./dev`, legacy `./bin`)
+        ignored: (watchPath: string) => {
+            const normalizedPath = normalizeWatchPath(watchPath);
+            return ignoredWatchPathPatterns.test(normalizedPath)
+                || ignoredOutputPaths.some(outputPath =>
+                    normalizedPath === outputPath
+                    || normalizedPath.startsWith(outputPath + '/')
+                );
+        }
 
         //aggregateTimeout: 1000,
     }, async (error, stats) => {
@@ -92,7 +103,7 @@ async function startApp( app: App ) {
     stopApp('Restart asked');
 
     console.info(`Launching new server ...`);
-    cp = spawn('node', ['' + app.paths.bin + '/server.js', '--preserve-symlinks'], {
+    cp = spawn('node', ['' + app.outputPath('dev') + '/server.js', '--preserve-symlinks'], {
 
         // sdin, sdout, sderr
         stdio: ['inherit', 'inherit', 'inherit']
@@ -107,3 +118,7 @@ function stopApp( reason: string ) {
     }
 
 }
+
+function normalizeWatchPath(watchPath: string) {
+    return path.resolve(watchPath).replace(/\\/g, '/').replace(/\/$/, '');
+}

package/cli/commands/refresh.ts

@@ -0,0 +1,18 @@
+/*----------------------------------
+- DEPENDANCES
+----------------------------------*/
+
+// Configs
+import Compiler from '../compiler';
+
+/*----------------------------------
+- COMMAND
+----------------------------------*/
+export const run = (): Promise<void> => new Promise(async (resolve) => {
+
+    const compiler = new Compiler('dev');
+
+    await compiler.refreshGeneratedTypings();
+
+    resolve();
+});

package/cli/compiler/client/identite.ts

@@ -2,20 +2,18 @@
 import favicons from 'favicons';
 import fs from 'fs-extra';
 
-// Libs
-import cli from '../..';
-
 // Type
 import type App from '../../app';
 
-export default async ( app: App ) => {
+export default async ( app: App, outputDir: string, enabled: boolean = true ) => {
 
-    const dossierCache = app.paths.root + '/public/app';
+    if (!enabled)
+        return;
 
-    if (!fs.existsSync(dossierCache)) {
+    if (!fs.existsSync(outputDir)) {
 
         console.info(`Generating identity assets ...`);
-        fs.emptyDirSync(dossierCache);
+        fs.emptyDirSync(outputDir);
 
         const identity = app.identity;
 
@@ -45,7 +43,6 @@ export default async ( app: App ) => {
                 appleStartup: false,
                 coast: false,
                 favicons: true,
-                firefox: true,
                 windows: true,
                 yandex: false
             }
@@ -56,13 +53,13 @@ export default async ( app: App ) => {
 
             // Enregistrement images
             ...response.images.map((image) => {
-                let destimg = dossierCache + '/' + image.name;
+                let destimg = outputDir + '/' + image.name;
                 return fs.writeFile(destimg, image.contents);
             }),
 
             // Enregistrement fichiers
             ...response.files.map((fichier) => {
-                let destfichier = dossierCache + '/' + fichier.name;
+                let destfichier = outputDir + '/' + fichier.name;
                 return fs.writeFile(destfichier, fichier.contents);
             })
 

package/cli/compiler/client/index.ts

@@ -5,6 +5,7 @@
 // Npm
 import webpack from 'webpack';
 import fs from 'fs-extra';
+import path from 'path';
 
 // Plugins
 const TerserPlugin = require('terser-webpack-plugin');
@@ -22,7 +23,7 @@ import WebpackAssetsManifest from 'webpack-assets-manifest';
 import PreactRefreshPlugin from '@prefresh/webpack';
 
 // Core
-import createCommonConfig, { TCompileMode, regex } from '../common';
+import createCommonConfig, { TCompileMode, TCompileOutputTarget, regex } from '../common';
 import identityAssets from './identite';
 import cli from '../..';
 
@@ -34,15 +35,21 @@ const debug = false;
 /*----------------------------------
 - CONFIG
 ----------------------------------*/
-export default function createCompiler( app: App, mode: TCompileMode ): webpack.Configuration {
+export default function createCompiler(
+    app: App,
+    mode: TCompileMode,
+    outputTarget: TCompileOutputTarget = mode === 'dev' ? 'dev' : 'bin'
+): webpack.Configuration {
 
     console.info(`Creating compiler for client (${mode}).`);
     const dev = mode === 'dev';
+    const buildDev = dev && outputTarget === 'bin';
+    const outputPath = app.outputPath(outputTarget);
 
-    const commonConfig = createCommonConfig(app, 'client', mode);
+    const commonConfig = createCommonConfig(app, 'client', mode, outputTarget);
 
-    // Pas besoin d'attendre que les assets soient générés pour lancer la compilation
-    identityAssets(app);
+    // Smoke builds only validate compilation, so skip expensive static generation.
+    identityAssets(app, path.join(outputPath, 'public', 'app'), !buildDev);
 
     // Symlinks to public
     /*const publicDirs = fs.readdirSync(app.paths.root + '/public');
@@ -82,7 +89,7 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
         output: {
 
             pathinfo: dev,
-            path: app.paths.bin + '/public',
+            path: outputPath + '/public',
             filename: '[name].js', // Output client.js
             assetModuleFilename: '[hash][ext]',
 
@@ -119,14 +126,14 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
                         app.paths.root + '/server/.generated/models.ts',
 
                     ],
-                    rules: require('../common/babel')(app, 'client', dev)
+                    rules: require('../common/babel')(app, 'client', dev, buildDev)
                 },
 
                 // Les pages étan tà la fois compilées dans le bundle client et serveur
                 // On ne compile les ressources (css) qu'une seule fois
                 {
                     test: regex.style,
-                    rules: require('../common/files/style')(app, dev, true),
+                    rules: require('../common/files/style')(app, dev, true, buildDev),
 
                     // Don't consider CSS imports dead code even if the
                     // containing package claims to have no side effects.
@@ -157,43 +164,44 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
                 new MiniCssExtractPlugin({})
             ]),
             
-            // Emit a file with assets cli.paths
-            // https://github.com/webdeveric/webpack-assets-manifest#options
-            new WebpackAssetsManifest({
-                output: app.paths.root + `/bin/asset-manifest.json`,
-                publicPath: true,
-                writeToDisk: true, // Force la copie du fichier sur e disque, au lieu d'en mémoire en mode dev
-                customize: ({ key, value }) => {
-                    // You can prevent adding items to the manifest by returning false.
-                    if (key.toLowerCase().endsWith('.map')) return false;
-                    return { key, value };
-                },
-                done: (manifest, stats) => {
-                    // Write chunk-manifest.json.json
-                    const chunkFileName = app.paths.root + `/bin/chunk-manifest.json`;
-                    try {
-                        const fileFilter = file => !file.endsWith('.map');
-                        const addPath = file => manifest.getPublicPath(file);
-                        const chunkFiles = stats.compilation.chunkGroups.reduce((acc, c) => {
-                            acc[c.name] = [
-                                ...(acc[c.name] || []),
-                                ...c.chunks.reduce(
-                                    (files, cc) => [
-                                        ...files,
-                                        ...[...cc.files].filter(fileFilter).map(addPath),
-                                    ],
-                                    [],
-                                ),
-                            ];
-                            return acc;
-                        }, Object.create(null));
-                        fs.writeFileSync(chunkFileName, JSON.stringify(chunkFiles, null, 4));
-                    } catch (err) {
-                        console.error(`ERROR: Cannot write ${chunkFileName}: `, err);
-                        if (!dev) process.exit(1);
-                    }
-                },
-            }),
+            ...(buildDev ? [] : [
+                // Emit runtime asset manifests only for runnable builds.
+                new WebpackAssetsManifest({
+                    output: outputPath + `/asset-manifest.json`,
+                    publicPath: true,
+                    writeToDisk: true, // Force la copie du fichier sur e disque, au lieu d'en mémoire en mode dev
+                    customize: ({ key, value }) => {
+                        // You can prevent adding items to the manifest by returning false.
+                        if (key.toLowerCase().endsWith('.map')) return false;
+                        return { key, value };
+                    },
+                    done: (manifest, stats) => {
+                        // Write chunk-manifest.json.json
+                        const chunkFileName = outputPath + `/chunk-manifest.json`;
+                        try {
+                            const fileFilter = file => !file.endsWith('.map');
+                            const addPath = file => manifest.getPublicPath(file);
+                            const chunkFiles = stats.compilation.chunkGroups.reduce((acc, c) => {
+                                acc[c.name] = [
+                                    ...(acc[c.name] || []),
+                                    ...c.chunks.reduce(
+                                        (files, cc) => [
+                                            ...files,
+                                            ...[...cc.files].filter(fileFilter).map(addPath),
+                                        ],
+                                        [],
+                                    ),
+                                ];
+                                return acc;
+                            }, Object.create(null));
+                            fs.writeFileSync(chunkFileName, JSON.stringify(chunkFiles, null, 4));
+                        } catch (err) {
+                            console.error(`ERROR: Cannot write ${chunkFileName}: `, err);
+                            if (!dev) process.exit(1);
+                        }
+                    },
+                })
+            ]),
 
             ...(dev ? [
 
@@ -230,7 +238,7 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
 
         // CSP-safe in development: avoid any `eval`-based source map mode.
         // https://webpack.js.org/configuration/devtool/#devtool
-        devtool: dev ? 'cheap-module-source-map' : 'source-map',
+        devtool: buildDev ? false : (dev ? 'cheap-module-source-map' : 'source-map'),
         /*devServer: {
             hot: true,
         },*/

package/cli/compiler/common/babel/index.ts

@@ -5,6 +5,7 @@
 // Npm
 import type webpack from 'webpack';
 import PresetBabel, { Options } from '@babel/preset-env';
+import path from 'path';
 
 import cli from '@cli';
 import type { TAppSide, App } from '@cli/app';
@@ -12,7 +13,7 @@ import type { TAppSide, App } from '@cli/app';
 /*----------------------------------
 - REGLES
 ----------------------------------*/
-module.exports = (app: App, side: TAppSide, dev: boolean): webpack.RuleSetRule[] => {
+module.exports = (app: App, side: TAppSide, dev: boolean, buildDev: boolean = false): webpack.RuleSetRule[] => {
 
     const babelPresetEnvConfig: Options = side === 'client'  ? {
 
@@ -64,7 +65,9 @@ module.exports = (app: App, side: TAppSide, dev: boolean): webpack.RuleSetRule[]
             // https://github.com/babel/babel-loader#options
 
             // ATTENTION: Ne prend pas toujours compte des màj des plugins babel
-            cacheDirectory: dev || cli.args.cache === true,
+            cacheDirectory: (dev || cli.args.cache === true)
+                ? path.join(app.paths.cache, 'babel', side, buildDev ? 'build-dev' : (dev ? 'dev' : 'prod'))
+                : false,
             // Désactive car ralenti compilation
             cacheCompression: false,
 

package/cli/compiler/common/babel/routes/routes.ts

@@ -650,55 +650,95 @@ function Plugin(babel, { app, side, debug }: TOptions) {
 
     function isProgramBodyLevelFunction(path: NodePath): boolean {
 
-        const parent = path.parentPath;
-        if (!parent)
-            return false;
-
-        // function Foo() {}
-        if (parent.isProgram())
-            return true;
-
-        // export default function Foo() {} / export default () => {}
-        if (
-            parent.isExportDefaultDeclaration()
-            &&
-            parent.parentPath?.isProgram()
-        )
-            return true;
-
-        // export const Foo = () => {}
-        if (
-            parent.isExportNamedDeclaration()
-            &&
-            parent.parentPath?.isProgram()
-        )
-            return true;
-
-        // const Foo = () => {} (top-level) / export const Foo = () => {}
-        if (parent.isVariableDeclarator()) {
+        let currentPath: NodePath | null = path;
+        while (currentPath) {
 
-            const declaration = parent.parentPath;
-            if (!declaration?.isVariableDeclaration())
+            const parent = currentPath.parentPath;
+            if (!parent)
                 return false;
 
-            const declarationParent = declaration.parentPath;
-            if (!declarationParent)
-                return false;
+            // function Foo() {}
+            if (parent.isProgram())
+                return true;
 
-            if (declarationParent.isProgram())
+            // export default function Foo() {} / export default () => {}
+            if (
+                parent.isExportDefaultDeclaration()
+                &&
+                parent.parentPath?.isProgram()
+            )
                 return true;
 
+            // export const Foo = () => {}
             if (
-                declarationParent.isExportNamedDeclaration()
+                parent.isExportNamedDeclaration()
                 &&
-                declarationParent.parentPath?.isProgram()
+                parent.parentPath?.isProgram()
             )
                 return true;
+
+            // const Foo = () => {} (top-level) / export const Foo = () => {}
+            if (parent.isVariableDeclarator()) {
+
+                const declaration = parent.parentPath;
+                if (!declaration?.isVariableDeclaration())
+                    return false;
+
+                const declarationParent = declaration.parentPath;
+                if (!declarationParent)
+                    return false;
+
+                if (declarationParent.isProgram())
+                    return true;
+
+                if (
+                    declarationParent.isExportNamedDeclaration()
+                    &&
+                    declarationParent.parentPath?.isProgram()
+                )
+                    return true;
+            }
+
+            // Support top-level component wrappers such as React.forwardRef(...) and React.memo(...)
+            if (
+                parent.isCallExpression()
+                &&
+                isSupportedComponentWrapperCall(parent, currentPath)
+            ) {
+                currentPath = parent;
+                continue;
+            }
+
+            return false;
         }
 
         return false;
     }
 
+    function isSupportedComponentWrapperCall(
+        callPath: NodePath<types.CallExpression>,
+        wrappedPath: NodePath
+    ): boolean {
+
+        if (callPath.node.arguments[0] !== wrappedPath.node)
+            return false;
+
+        const callee = callPath.node.callee;
+        if (callee.type === 'Identifier')
+            return ['forwardRef', 'memo'].includes(callee.name);
+
+        if (
+            callee.type === 'MemberExpression'
+            &&
+            !callee.computed
+            &&
+            callee.property.type === 'Identifier'
+        )
+            return ['forwardRef', 'memo'].includes(callee.property.name);
+
+        return false;
+    }
+
     function ensureUseContextImport(path: NodePath<types.Program>, pluginState: TPluginState) {
 
         if (!pluginState.needsUseContextImport)

package/cli/compiler/common/files/style.ts

@@ -3,9 +3,9 @@ import MiniCssExtractPlugin from "mini-css-extract-plugin";
 
 import type { App } from '../../../app';
 
-module.exports = (app: App, dev: Boolean, client: boolean) => {
+module.exports = (app: App, dev: boolean, client: boolean, buildDev: boolean = false) => {
 
-    console.log('app.paths.root', app.paths.root)
+    const enableSourceMaps = dev && !buildDev;
 
     return [
 
@@ -19,7 +19,7 @@ module.exports = (app: App, dev: Boolean, client: boolean) => {
             exclude: [app.paths.root],
             loader: 'css-loader',
             options: {
-                sourceMap: dev
+                sourceMap: enableSourceMaps
             },
         },
 
@@ -30,7 +30,7 @@ module.exports = (app: App, dev: Boolean, client: boolean) => {
             options: {
                 // CSS Loader https://github.com/webpack/css-loader
                 importLoaders: 1, // let postcss run on @imports
-                sourceMap: dev
+                sourceMap: enableSourceMaps
             },
         },
 
@@ -49,7 +49,9 @@ module.exports = (app: App, dev: Boolean, client: boolean) => {
                             optimize: false,
                         }),
                         ///* Tailwind V3 */require('tailwindcss'),
-                        require('autoprefixer'),
+                        ...(buildDev ? [] : [
+                            require('autoprefixer'),
+                        ]),
                     ],
                 },
             },

package/cli/compiler/common/index.ts

@@ -34,6 +34,7 @@ export const regex = {
 ----------------------------------*/
 
 export type TCompileMode = 'dev' | 'prod'
+export type TCompileOutputTarget = 'dev' | 'bin'
 
 /*----------------------------------
 - BASE CONFIG
@@ -43,9 +44,11 @@ export default function createCommonConfig(
     app: App, 
     side: TAppSide, 
     mode: TCompileMode,
+    outputTarget: TCompileOutputTarget = mode === 'dev' ? 'dev' : 'bin',
 ): webpack.Configuration {
 
     const dev = mode === 'dev';
+    const buildDev = dev && outputTarget === 'bin';
     const config: webpack.Configuration = {
 
         // Project root
@@ -83,6 +86,8 @@ export default function createCommonConfig(
                 BUILD_ID: JSON.stringify(app.buildId),
                 APP_PATH: JSON.stringify(app.paths.root),
                 APP_NAME: JSON.stringify(app.identity.web.title),
+                APP_OUTPUT_DIR: JSON.stringify(path.basename(app.outputPath(outputTarget))),
+                PROTEUM_ROUTER_PORT_OVERRIDE: JSON.stringify(app.routerPortOverride ?? null),
 
             }),
 
@@ -121,18 +126,18 @@ export default function createCommonConfig(
         // our own hints via the FileSizeReporter
         performance: false,
 
-        // Don't attempt to continue if there are any errors.
-        bail: !dev,
+        // Smoke builds should fail immediately on the first compilation error.
+        bail: buildDev || !dev,
 
-        // Persistent cache speeds up cold starts and incremental rebuilds.
-        cache: /*(dev || cli.args.cache === true) ? {
+        // Persistent cache speeds up repeated local build-dev invocations.
+        cache: (buildDev || cli.args.cache === true) ? {
             type: 'filesystem',
-            cacheDirectory: path.join(app.paths.cache, 'webpack', side),
+            cacheDirectory: path.join(app.paths.cache, 'webpack', side, buildDev ? 'build-dev' : mode),
             compression: false,
             buildDependencies: {
                 config: [__filename],
             },
-        } : */false,
+        } : false,
 
         // Increase compilation performance
         profile: false,

package/cli/compiler/index.ts

@@ -16,7 +16,7 @@ import app from '../app';
 import cli from '..';
 import createServerConfig from './server';
 import createClientConfig from './client';
-import { TCompileMode } from './common';
+import { TCompileMode, TCompileOutputTarget } from './common';
 
 type TCompilerCallback = (compiler: webpack.Compiler) => void
 
@@ -50,28 +50,34 @@ export default class Compiler {
             before?: TCompilerCallback,
             after?: TCompilerCallback,
         } = {},
-        private debug: boolean = false
+        private debug: boolean = false,
+        private outputTarget: TCompileOutputTarget = mode === 'dev' ? 'dev' : 'bin'
     ) {
 
     }
 
     public cleanup() {
+        const outputPath = app.outputPath(this.outputTarget);
+        const generatedPublicEntries = new Set(['app']);
 
-        fs.emptyDirSync( app.paths.bin );
-        fs.ensureDirSync( path.join(app.paths.bin, 'public') )
+        fs.emptyDirSync( outputPath );
+        fs.ensureDirSync( path.join(outputPath, 'public') )
         const publicFiles = fs.readdirSync(app.paths.public);
         for (const publicFile of publicFiles) {
+            if (generatedPublicEntries.has(publicFile))
+                continue;
+
             // Dev: faster to use symlink
             if (this.mode === 'dev')
                 fs.symlinkSync( 
                     path.join(app.paths.public, publicFile), 
-                    path.join(app.paths.bin, 'public', publicFile) 
+                    path.join(outputPath, 'public', publicFile) 
                 );
             // Prod: Symlink not always supported by CI / Containers solutions
             else
                 fs.copySync( 
                     path.join(app.paths.public, publicFile), 
-                    path.join(app.paths.bin, 'public', publicFile) 
+                    path.join(outputPath, 'public', publicFile) 
                 );
         }
     }
@@ -87,6 +93,7 @@ export default class Compiler {
             return console.info("Not fixing npm issue because proteum wasn't installed with npm link.");
 
         this.debug && console.info(`Fix NPM link issues ...`);
+        const outputPath = app.outputPath(this.outputTarget);
 
         const appModules = path.join(app.paths.root, 'node_modules');
         const coreModules = path.join(corePath, 'node_modules');
@@ -95,7 +102,7 @@ export default class Compiler {
         // Modules are installed locally and not glbally as with with the 5htp package from NPM.
         // So we need to symbilnk the http-core node_modules in one of the parents of server.js.
         // It avoids errors like: "Error: Cannot find module 'intl'"
-        fs.symlinkSync( coreModules, path.join(app.paths.bin, 'node_modules') );
+        fs.symlinkSync( coreModules, path.join(outputPath, 'node_modules') );
 
         // Same problem: when 5htp-core is installed via npm link, 
         // Typescript doesn't detect React and shows mission JSX errors
@@ -492,10 +499,24 @@ declare module '@models/types' {
         );
     }
 
-    public async create() {
+    private async warmupApp() {
 
         await app.warmup();
 
+    }
+
+    public async refreshGeneratedTypings() {
+
+        await this.warmupApp();
+
+        this.indexServices();
+
+    }
+
+    public async create() {
+
+        await this.warmupApp();
+
         this.cleanup();
 
         this.fixNpmLinkIssues();
@@ -504,8 +525,8 @@ declare module '@models/types' {
 
         // Create compilers
         const multiCompiler = webpack([
-            smp.wrap( createServerConfig(app, this.mode) ),
-            smp.wrap( createClientConfig(app, this.mode) )
+            smp.wrap( createServerConfig(app, this.mode, this.outputTarget) ),
+            smp.wrap( createClientConfig(app, this.mode, this.outputTarget) )
         ]);
 
         for (const compiler of multiCompiler.compilers) {

package/cli/compiler/server/index.ts

@@ -12,7 +12,7 @@ const TerserPlugin = require("terser-webpack-plugin");
 
 // Core
 import cli from '@cli';
-import createCommonConfig, { TCompileMode, regex } from '../common';
+import createCommonConfig, { TCompileMode, TCompileOutputTarget, regex } from '../common';
 
 // Type
 import type { App } from '../../app';
@@ -39,12 +39,18 @@ const debug = false;
 /*----------------------------------
 - CONFIG
 ----------------------------------*/
-export default function createCompiler( app: App, mode: TCompileMode ): webpack.Configuration {
+export default function createCompiler(
+    app: App,
+    mode: TCompileMode,
+    outputTarget: TCompileOutputTarget = mode === 'dev' ? 'dev' : 'bin'
+): webpack.Configuration {
 
     debug && console.info(`Creating compiler for server (${mode}).`);
     const dev = mode === 'dev';
+    const buildDev = dev && outputTarget === 'bin';
+    const outputPath = app.outputPath(outputTarget);
 
-    const commonConfig = createCommonConfig(app, 'server', mode);
+    const commonConfig = createCommonConfig(app, 'server', mode, outputTarget);
     const { aliases } = app.aliases.server.forWebpack({
         modulesPath: app.paths.root + '/node_modules'
     });
@@ -73,7 +79,7 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
 
             libraryTarget: 'commonjs2',
 
-            path: app.paths.bin,
+            path: outputPath,
             filename: '[name].js',
             publicPath: '/',
             assetModuleFilename: 'public/[hash][ext]',
@@ -106,6 +112,7 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
                     request.startsWith('proteum')
                     ||
                     // Compile 5HTP modules
+                    request.startsWith('@mantine/') ||
                     request.startsWith('react-number-format') ||
                     request.startsWith('@floating-ui')
                 )
@@ -155,7 +162,7 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
                         // Temp disabled because compile issue on vercel
                         //...getCorePluginsList(app)
                     ],
-                    rules: require('../common/babel')(app, 'server', dev)
+                    rules: require('../common/babel')(app, 'server', dev, buildDev)
                 }, 
 
                 // Les pages étan tà la fois compilées dans le bundle client et serveur
@@ -197,7 +204,9 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
         },
 
         // https://webpack.js.org/configuration/devtool/#devtool
-        devtool: dev 
+        devtool: buildDev
+            ? false
+            : dev
             ? 'eval-source-map' // Recommended choice for development builds with high quality SourceMaps.
             : 'source-map', // Recommended choice for production builds with high quality SourceMaps.
 
@@ -208,4 +217,4 @@ export default function createCompiler( app: App, mode: TCompileMode ): webpack.
     };
 
     return config;
-};
+};

package/cli/index.ts

@@ -35,6 +35,19 @@ export class CLI {
 
     // Context
     public args: TArgsObject = {};
+
+    public commandOptionDefaults: { [command: string]: TArgsObject } = {
+        dev: {
+            port: '',
+        },
+        build: {
+            port: '',
+            dev: false,
+            prod: false,
+            analyze: false,
+            cache: false,
+        },
+    };
     
     public debug: boolean = false;
 
@@ -61,6 +74,7 @@ export class CLI {
     public commands: { [name: string]: TCliCommand } = {
         "init": () => import('./commands/init'),
         "dev": () => import('./commands/dev'),
+        "refresh": () => import('./commands/refresh'),
         "build": () => import('./commands/build'),
     }
 
@@ -75,20 +89,27 @@ export class CLI {
         if (this.commands[commandName] === undefined)
             throw new Error(`Command ${commandName} does not exists.`);
 
+        this.args = {
+            ...(this.commandOptionDefaults[commandName] || {})
+        };
         this.args.workdir = process.cwd();
 
         let opt: string | null = null;
         for (const a of argv) {
 
-            if (a[0] === '-') {
+            if (a.startsWith('-')) {
 
-                opt = a.substring(1);
+                opt = a.replace(/^-+/, '');
+                if (opt.length === 0)
+                    throw new Error(`Unknown option: ${a}`);
                 if (!(opt in this.args)) 
                     throw new Error(`Unknown option: ${opt}`);
 
                 // Init with default value
-                if (typeof this.args[opt] === "boolean")
+                if (typeof this.args[opt] === "boolean") {
                     this.args[opt] = true;
+                    opt = null;
+                }
 
             } else if (opt !== null) {
 
@@ -108,6 +129,9 @@ export class CLI {
             }
         }
 
+        if (opt !== null && typeof this.args[opt] !== 'boolean')
+            throw new Error(`Missing value for option: ${opt}`);
+
         this.runCommand(commandName);
     }
 
@@ -186,4 +210,4 @@ export class CLI {
 
 }
 
-export default new CLI()
+export default new CLI()

package/doc/TODO.md

@@ -34,7 +34,7 @@ abstract class Controller<
 
 ```typescript
 //? /headhunter/missions/suggested'
-class Missions extends Controller<UniqueDomains["router"]> {
+class Missions extends Controller<CrossPath["router"]> {
 
     auth = 'USER';
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "proteum",
 	"description": "Convenient TypeScript framework designed for Performance and Productivity.",
-	"version": "1.0.2",
+	"version": "1.0.3",
 	"author": "Gaetan Le Gac (https://github.com/gaetanlegac)",
 	"repository": "git://github.com/gaetanlegac/proteum.git",
 	"license": "MIT",
@@ -25,7 +25,6 @@
 		"@babel/preset-env": "^7.15.6",
 		"@babel/preset-react": "^7.14.5",
 		"@babel/preset-typescript": "^7.15.0",
-		"@lexical/react": "^0.18.0",
 		"@prefresh/webpack": "^3.3.2",
 		"@prisma/client": "^6.5.0",
 		"@tailwindcss/postcss": "^4.1.17",
@@ -73,7 +72,6 @@
 		"json5": "^2.2.0",
 		"jsonwebtoken": "^8.5.1",
 		"less-loader": "^10.0.1",
-		"lexical": "^0.18.0",
 		"load-script": "^2.0.0",
 		"locale": "^0.1.0",
 		"markdown-it": "^13.0.1",

package/server/app/container/config.ts

@@ -15,6 +15,8 @@ import yaml from 'yaml';
 import type { TDomainsList } from '@common/router';
 import type { TLogProfile } from './console';
 
+declare const PROTEUM_ROUTER_PORT_OVERRIDE: number | null;
+
 /*----------------------------------
 - TYPES
 ----------------------------------*/
@@ -114,6 +116,16 @@ export type AppConfig = {
 
 const debug = false;
 
+const getRouterPortOverride = () => {
+    if (
+        typeof PROTEUM_ROUTER_PORT_OVERRIDE !== 'undefined'
+        && PROTEUM_ROUTER_PORT_OVERRIDE !== null
+    )
+        return PROTEUM_ROUTER_PORT_OVERRIDE;
+
+    return undefined;
+}
+
 /*----------------------------------
 - LOADE
 ----------------------------------*/
@@ -138,8 +150,15 @@ export default class ConfigParser {
         console.log("[app] Using environment:", process.env.NODE_ENV);
         const envFileName = this.appDir + '/env.yaml';
         const envFile = this.loadYaml( envFileName );
+        const routerPortOverride = getRouterPortOverride();
         return {
             ...envFile,
+            router: routerPortOverride === undefined
+                ? envFile.router
+                : {
+                    ...envFile.router,
+                    port: routerPortOverride
+                },
             version: BUILD_DATE
         }
     }
@@ -200,4 +219,4 @@ export default class ConfigParser {
             deepExtend(fileConfig, loadYaml(fullpath));
 
     }
-}*/
+}*/

package/server/services/router/http/index.ts

@@ -115,7 +115,7 @@ export default class HttpServer {
         routes.use('/public', cors());
         routes.use(
             '/public',
-            express.static( Container.path.root + '/bin/public', {
+            express.static( path.join(Container.path.root, APP_OUTPUT_DIR, 'public'), {
                 dotfiles: 'deny',
                 setHeaders: function setCustomCacheControl(res, path) {
 
@@ -214,4 +214,4 @@ export default class HttpServer {
     public async cleanup() {
         this.http.close();
     }
-}
+}

package/server/utils/slug.ts

@@ -7,9 +7,6 @@ import escapeStringRegexp from 'escape-regexp';
 import slugify from 'slugify';
 import { removeStopwords, eng } from 'stopword';
 
-// Core
-import type SQL from "@server/services/database";
-
 /*----------------------------------
 - TYPES
 ----------------------------------*/

package/types/global/constants.d.ts

@@ -0,0 +1,12 @@
+declare const __DEV__: boolean;
+declare const SERVER: boolean;
+
+declare const CORE_VERSION: string;
+declare const CORE_PATH: string;
+
+declare const BUILD_DATE: string;
+declare const BUILD_ID: number;
+
+declare const APP_PATH: string;
+declare const APP_NAME: string;
+declare const APP_OUTPUT_DIR: string;