@mostajs/setup 1.5.1 → 2.0.0

package/dist/api/detect-modules.route.js

@@ -1,6 +1,6 @@
 // @mosta/setup — Detect modules API route factory
 // Author: Dr Hamid MADANI drmdh@msn.com
-import { discoverNpmModules } from '../lib/discover-modules';
+import { discoverNpmModules } from '../lib/discover-modules.js';
 export function createDetectModulesHandler() {
     async function GET() {
         const result = await discoverNpmModules();

package/dist/api/install-modules.route.js

@@ -4,7 +4,7 @@ import { exec } from 'child_process';
 import { promisify } from 'util';
 import fs from 'fs';
 import path from 'path';
-import { MODULES, resolveModuleDependencies } from '../data/module-definitions';
+import { MODULES, resolveModuleDependencies } from '../data/module-definitions.js';
 const execAsync = promisify(exec);
 /**
  * Factory for POST /api/setup/install-modules

package/dist/api/install.route.d.ts

@@ -1,4 +1,4 @@
-import type { MostaSetupConfig } from '../types/index';
+import type { MostaSetupConfig } from '../types/index.js';
 type NeedsSetupFn = () => Promise<boolean>;
 /**
  * Creates a POST handler for running the installation.

package/dist/api/install.route.js

@@ -2,7 +2,7 @@
 // Author: Dr Hamid MADANI drmdh@msn.com
 //
 // Copy to: src/app/api/setup/install/route.ts
-import { runInstall } from '../lib/setup';
+import { runInstall } from '../lib/setup.js';
 /**
  * Creates a POST handler for running the installation.
  */

package/dist/api/reconfig.route.js

@@ -1,8 +1,8 @@
 // @mostajs/setup — API Route factory for reconfiguration
 // Author: Dr Hamid MADANI drmdh@msn.com
-import { testDbConnection } from '../lib/db-test';
-import { writeEnvLocal } from '../lib/env-writer';
-import { composeDbUri } from '../lib/compose-uri';
+import { testDbConnection } from '../lib/db-test.js';
+import { writeEnvLocal } from '../lib/env-writer.js';
+import { composeDbUri } from '../lib/compose-uri.js';
 /**
  * Creates handlers for the reconfiguration API.
  *

package/dist/api/test-db.route.js

@@ -2,7 +2,7 @@
 // Author: Dr Hamid MADANI drmdh@msn.com
 //
 // Copy to: src/app/api/setup/test-db/route.ts
-import { testDbConnection } from '../lib/db-test';
+import { testDbConnection } from '../lib/db-test.js';
 /**
  * Creates a POST handler for testing DB connections.
  */

package/dist/api/upload-jar.route.js

@@ -376,7 +376,7 @@ export function createUploadJarHandlers() {
             if (!dialect) {
                 return Response.json({ ok: false, error: 'dialect requis' }, { status: 400 });
             }
-            const { composeDbUri } = await import('../lib/compose-uri');
+            const { composeDbUri } = await import('../lib/compose-uri.js');
             const uri = composeDbUri(dialect, {
                 host: host || 'localhost',
                 port: port || 0,

package/dist/api/upload-setup-json.route.js

@@ -25,8 +25,10 @@ export function createSetupJsonHandler(needsSetup) {
                 exists: true,
                 config: {
                     appName: json.app?.name,
+                    dbNamePrefix: json.app?.dbNamePrefix,
                     hasRbac: !!(json.rbac?.roles?.length || json.rbac?.permissions?.length),
                     seedCount: json.seeds?.length ?? 0,
+                    modules: json.modules ?? [],
                 },
             });
         }

package/dist/components/SetupWizard.d.ts

@@ -18,5 +18,25 @@ export interface SetupWizardProps {
     dbNamePrefix?: string;
     /** Whether to persist wizard state in sessionStorage (default: true) */
     persistState?: boolean;
+    /**
+     * Show the modules selection step even without a detectModules endpoint.
+     * When true and no detectModules endpoint, uses the built-in module list.
+     * Default: true
+     */
+    showModules?: boolean;
+    /**
+     * Full module definitions from setup.json (section "modules").
+     * When provided, the wizard shows these modules directly
+     * instead of calling the detectModules endpoint.
+     */
+    declaredModules?: {
+        key: string;
+        packageName?: string;
+        label?: string;
+        description?: string;
+        icon?: string;
+        required?: boolean;
+        dependsOn?: string[];
+    }[];
 }
-export default function SetupWizard({ t: tProp, onComplete, endpoints, dbNamePrefix, persistState, }: SetupWizardProps): import("react/jsx-runtime").JSX.Element;
+export default function SetupWizard({ t: tProp, onComplete, endpoints, dbNamePrefix, persistState, showModules, declaredModules, }: SetupWizardProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SetupWizard.js

@@ -344,10 +344,10 @@ function JarUploadInline({ dialect, jarEndpoint, dbConfig }) {
     return (_jsxs("div", { style: S.jarBox, children: [_jsxs("div", { style: S.flex(8), children: [_jsx("span", { style: S.jarTitle, children: "Driver JDBC" }), jarStatus?.hasJar ? (_jsx("span", { style: { ...S.badge('installed'), marginLeft: 0 }, children: jarStatus.jarFile })) : (_jsx("span", { style: { fontSize: 12, color: '#6b7280' }, children: "Aucun JAR installe" }))] }), _jsxs("div", { style: { marginTop: 8 }, children: [_jsxs("label", { style: { ...S.btn('primary', uploading), cursor: uploading ? 'wait' : 'pointer', fontSize: 12, padding: '6px 12px' }, children: [uploading ? 'Upload...' : 'Uploader un .jar', _jsx("input", { type: "file", accept: ".jar", onChange: handleUpload, disabled: uploading, style: { display: 'none' } })] }), _jsx("span", { style: { fontSize: 11, color: '#9ca3af', marginLeft: 8 }, children: "Ex: hsqldb*.jar, ojdbc*.jar" })] }), isHsqldb && jarStatus?.hasJar && (_jsxs("div", { style: { marginTop: 10, padding: '10px 12px', backgroundColor: '#fef9c3', borderRadius: 6, border: '1px solid #fde68a' }, children: [_jsxs("div", { style: { fontSize: 12, fontWeight: 600, color: '#92400e', marginBottom: 6 }, children: ["Serveur HSQLDB", _jsxs("span", { style: { fontWeight: 400, color: '#6b7280', marginLeft: 4 }, children: ["(port SGBD : ", dbConfig.port || 9001, ")"] }), serverInfo?.running && (_jsxs("span", { style: { fontWeight: 400, color: '#059669', marginLeft: 8 }, children: ["En marche sur port ", serverInfo.port, serverInfo.pid > 0 ? ` — PID ${serverInfo.pid}` : ''] })), !serverInfo?.running && (_jsx("span", { style: { fontWeight: 400, color: '#dc2626', marginLeft: 8 }, children: "Arrete" }))] }), _jsxs("div", { style: { display: 'flex', gap: 8 }, children: [_jsx("button", { style: btnSmall('#059669', loading === 'start-server' || serverInfo?.running), onClick: () => patchAction({ action: 'start-server', dialect, name: dbConfig.name, host: dbConfig.host, port: dbConfig.port || 9001 }, 'start-server'), disabled: loading === 'start-server' || !!serverInfo?.running, children: loading === 'start-server' ? 'Demarrage...' : `Demarrer le serveur (port ${dbConfig.port || 9001})` }), _jsx("button", { style: btnSmall('#dc2626', loading === 'stop-server' || !serverInfo?.running), onClick: () => patchAction({ action: 'stop-server', port: serverInfo?.port || dbConfig.port || 9001 }, 'stop-server'), disabled: loading === 'stop-server' || !serverInfo?.running, children: loading === 'stop-server' ? 'Arret...' : 'Arreter le serveur' })] })] })), jarStatus?.hasJar && (_jsxs("div", { style: { marginTop: 10, padding: '10px 12px', backgroundColor: '#f0fdf4', borderRadius: 6, border: '1px solid #bbf7d0' }, children: [_jsxs("div", { style: { fontSize: 12, fontWeight: 600, color: '#166534', marginBottom: 6 }, children: ["Bridge JDBC", _jsxs("span", { style: { fontWeight: 400, color: '#6b7280', marginLeft: 4 }, children: ["(port bridge : ", bridgePort || 8765, ")"] }), bridgePort && (_jsxs("span", { style: { fontWeight: 400, color: '#059669', marginLeft: 8 }, children: ["Actif sur port ", bridgePort] })), !bridgePort && bridges.length === 0 && (_jsx("span", { style: { fontWeight: 400, color: '#dc2626', marginLeft: 8 }, children: "Inactif" }))] }), _jsx("div", { style: { display: 'flex', gap: 8, marginBottom: bridges.length > 0 ? 8 : 0 }, children: _jsx("button", { style: btnSmall('#059669', loading === 'start-bridge' || bridges.length > 0), onClick: () => patchAction({ action: 'start', dialect, ...dbConfig }, 'start-bridge'), disabled: loading === 'start-bridge' || bridges.length > 0, children: loading === 'start-bridge' ? 'Lancement...' : `Lancer le bridge (SGBD ${dbConfig.host || 'localhost'}:${dbConfig.port || 9001})` }) }), bridges.map(b => (_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 8, padding: '4px 0', fontSize: 12 }, children: [_jsx("span", { style: { width: 8, height: 8, borderRadius: '50%', backgroundColor: b.status === 'active' ? '#22c55e' : '#f59e0b', flexShrink: 0 } }), _jsxs("span", { style: { color: '#374151', fontFamily: 'monospace', fontSize: 11 }, children: ["Bridge port :", b.port, " ", b.pid > 0 ? `(PID ${b.pid})` : '', " ", b.jdbcUrl ? `— ${b.jdbcUrl}` : ''] }), _jsx("button", { style: { ...btnSmall('#dc2626', loading === `kill-${b.port}`), fontSize: 11, padding: '2px 8px', marginLeft: 'auto' }, onClick: () => patchAction({ action: 'stop', port: b.port, pid: b.pid }, `kill-${b.port}`), disabled: loading === `kill-${b.port}`, children: loading === `kill-${b.port}` ? '...' : 'Kill' })] }, b.port)))] })), message && (_jsx("p", { style: { fontSize: 12, color: message.ok ? '#059669' : '#dc2626', marginTop: 8 }, children: message.text }))] }));
 }
 // ── Main Component ───────────────────────────────────────────
-export default function SetupWizard({ t: tProp, onComplete, endpoints = {}, dbNamePrefix = 'mydb', persistState = true, }) {
+export default function SetupWizard({ t: tProp, onComplete, endpoints = {}, dbNamePrefix = 'mydb', persistState = true, showModules = true, declaredModules, }) {
     const t = tProp || ((k) => k);
-    // Modules step is only shown if detectModules endpoint is explicitly provided
-    const hasModulesStep = !!endpoints.detectModules;
+    // Modules step is shown unless explicitly disabled
+    const hasModulesStep = showModules !== false;
     const STEPS = hasModulesStep
         ? ALL_STEPS
         : ALL_STEPS.filter(s => s !== 'modules');
@@ -416,12 +416,30 @@ export default function SetupWizard({ t: tProp, onComplete, endpoints = {}, dbNa
         }
         catch { }
     }, [hydrated, persistState, currentStep, dialect, dbConfig, adminConfig, seedOptions, selectedModules]);
-    // --- Detect modules (only if endpoint is provided) ---
+    // --- Detect modules ---
     useEffect(() => {
+        // From setup.json (passed as prop)
+        if (declaredModules && declaredModules.length > 0) {
+            const mods = declaredModules.map(m => ({
+                key: m.key,
+                label: m.label ?? m.key,
+                description: m.description ?? '',
+                icon: m.icon ?? '📦',
+                required: m.required,
+                default: true,
+                dependsOn: m.dependsOn,
+            }));
+            setAvailableModules(mods);
+            setSelectedModules(declaredModules.map(m => m.key));
+            setModulesDetected(true);
+            return;
+        }
+        // No modules and no endpoint → skip
         if (!ep.detectModules) {
             setModulesDetected(true);
             return;
         }
+        // From API endpoint
         fetch(ep.detectModules)
             .then(r => r.json())
             .then((data) => {
@@ -644,9 +662,9 @@ export default function SetupWizard({ t: tProp, onComplete, endpoints = {}, dbNa
                                                                     color: mod.type === 'business' ? '#1e40af' : '#6b21a8',
                                                                 }, children: mod.type })] }), _jsxs("div", { style: { fontSize: 12, color: '#6b7280', fontFamily: 'monospace' }, children: ["v", mod.version] }), _jsxs("div", { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', marginTop: 4 }, children: [_jsx("span", { style: { fontSize: 12, fontWeight: 600, color: mod.installed ? '#059669' : '#6b7280' }, children: mod.installed ? 'ON' : 'OFF' }), _jsx("button", { style: S.toggleBtn(mod.installed, wireBusy === mod.name), onClick: (e) => { e.stopPropagation(); handleWireToggle(mod); }, disabled: wireBusy !== null, children: wireBusy === mod.name
                                                                     ? (mod.installed ? 'Decablage...' : 'Cablage...')
-                                                                    : (mod.installed ? 'Desinstaller' : 'Installer') })] })] }, mod.name))) }))] }), _jsxs("div", { style: S.navRow, children: [_jsxs("button", { style: S.btn('outline'), onClick: goBack, children: ["\u2190 ", t('setup.back')] }), _jsxs("button", { style: S.btn('primary', !canGoNext()), onClick: goNext, disabled: !canGoNext(), children: [t('setup.next'), " \u2192"] })] })] })), step === 'dialect' && (_jsxs("div", { children: [_jsxs("div", { style: S.sectionHeader, children: [_jsx("span", { style: S.sectionIcon, children: "\uD83D\uDCBE" }), _jsxs("div", { children: [_jsx("div", { style: S.sectionTitle, children: t('setup.dialect.title') }), _jsx("div", { style: S.sectionDesc, children: t('setup.dialect.description') })] })] }), _jsx("div", { style: S.grid3, children: DIALECT_INFO.map(d => (_jsxs("div", { style: S.dialectCard(dialect === d.key, !!d.premium), onClick: () => !d.premium && selectDialect(d.key), title: d.premium ? `${d.name} — disponible en version Premium` : d.name, children: [_jsx("div", { style: S.dialectIcon, children: d.icon }), _jsx("div", { style: S.dialectName, children: d.name }), d.premium && (_jsx("span", { style: { ...S.badge('premium'), marginLeft: 0, marginTop: 4 }, children: "Premium" }))] }, d.key))) }), _jsxs("div", { style: S.navRow, children: [_jsxs("button", { style: S.btn('outline'), onClick: goBack, children: ["\u2190 ", t('setup.back')] }), _jsxs("button", { style: S.btn('primary'), onClick: goNext, children: [t('setup.next'), " \u2192"] })] })] })), step === 'database' && (_jsxs("div", { children: [_jsxs("div", { style: S.sectionHeader, children: [_jsx("span", { style: S.sectionIcon, children: "\uD83D\uDDC4\uFE0F" }), _jsxs("div", { children: [_jsx("div", { style: S.sectionTitle, children: t('setup.database.title') }), _jsx("div", { style: S.sectionDesc, children: t('setup.database.description') })] })] }), dialect === 'sqlite' ? (_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.name') }), _jsx("input", { style: S.input, value: dbConfig.name, onChange: e => { setDbConfig({ ...dbConfig, name: e.target.value }); setDbTestResult(null); }, placeholder: dbNamePrefix }), _jsxs("p", { style: { fontSize: 11, color: '#9ca3af', marginTop: 4 }, children: [t('setup.database.sqliteInfo'), " ", _jsxs("code", { style: { fontFamily: 'monospace', backgroundColor: '#f3f4f6', padding: '1px 4px', borderRadius: 3 }, children: ["./data/", dbConfig.name, ".db"] })] })] })) : dialect === 'spanner' ? (_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.spannerPath') }), _jsx("input", { style: S.input, value: dbConfig.name, onChange: e => { setDbConfig({ ...dbConfig, name: e.target.value }); setDbTestResult(null); }, placeholder: "my-project/my-instance/mydb" }), _jsx("p", { style: { fontSize: 11, color: '#9ca3af', marginTop: 4 }, children: t('setup.database.spannerInfo') })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { style: S.formRow, children: [_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.host') }), _jsx("input", { style: S.input, value: dbConfig.host, onChange: e => { setDbConfig({ ...dbConfig, host: e.target.value }); setDbTestResult(null); } })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.port') }), _jsx("input", { style: S.input, type: "number", value: dbConfig.port, onChange: e => { setDbConfig({ ...dbConfig, port: parseInt(e.target.value) || 0 }); setDbTestResult(null); } })] })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.name') }), _jsx("input", { style: S.input, value: dbConfig.name, onChange: e => { setDbConfig({ ...dbConfig, name: e.target.value }); setDbTestResult(null); } })] }), _jsxs("div", { style: S.formRow, children: [_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.user') }), _jsx("input", { style: S.input, value: dbConfig.user, onChange: e => { setDbConfig({ ...dbConfig, user: e.target.value }); setDbTestResult(null); }, placeholder: dialect === 'hsqldb' ? 'SA' : '' })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.password') }), _jsx("input", { style: S.input, type: "password", value: dbConfig.password, onChange: e => { setDbConfig({ ...dbConfig, password: e.target.value }); setDbTestResult(null); } })] })] })] })), dialect === 'hsqldb' && (_jsxs("div", { style: { ...S.alert('warning'), marginTop: 12, fontSize: 12 }, children: [_jsx("strong", { children: "Prerequis :" }), " Le serveur HSQLDB doit etre lance avant le bridge.", _jsx("br", {}), _jsxs("code", { style: { fontFamily: 'monospace', backgroundColor: '#fef3c7', padding: '2px 6px', borderRadius: 3, display: 'inline-block', marginTop: 4, fontSize: 11 }, children: ["java -cp hsqldb*.jar org.hsqldb.server.Server --database.0 file:./data/", dbConfig.name, " --dbname.0 ", dbConfig.name] })] })), dialect !== 'mongodb' && dialect !== 'sqlite' && (_jsxs("div", { style: { ...S.alert('warning'), marginTop: 12 }, children: [t('setup.database.driverHint'), ' ', _jsx("code", { style: { fontFamily: 'monospace', backgroundColor: '#fef3c7', padding: '1px 4px', borderRadius: 3 }, children: DRIVER_HINTS[dialect] })] })), JDBC_DIALECTS.includes(dialect) && (_jsx(JarUploadInline, { dialect: dialect, jarEndpoint: ep.uploadJar, dbConfig: dbConfig })), dialect !== 'sqlite' && dialect !== 'spanner' && (_jsxs("div", { style: { ...S.checkRow, marginTop: 12, padding: '10px 14px', backgroundColor: '#fffbeb', border: '1px solid #fde68a', borderRadius: 8 }, children: [_jsx("input", { type: "checkbox", style: S.checkbox, checked: createIfNotExists, onChange: e => setCreateIfNotExists(e.target.checked) }), _jsxs("div", { children: [_jsx("div", { style: { fontSize: 13, fontWeight: 500 }, children: t('setup.database.createIfNotExists') }), _jsx("div", { style: { fontSize: 12, color: '#92400e' }, children: t('setup.database.createIfNotExistsDesc') })] })] })), dialect !== 'sqlite' && dialect !== 'spanner' && (_jsxs("div", { style: { ...S.flex(16), marginTop: 16 }, children: [_jsxs("button", { style: S.btn('outline', dbTesting), onClick: testDb, disabled: dbTesting, children: [dbTesting ? '⏳ ' : '🗄️ ', dbTesting ? t('setup.database.testing') : t('setup.database.test')] }), dbTestResult && (_jsx("span", { style: { fontSize: 13, color: dbTestResult.ok ? '#059669' : '#dc2626' }, children: dbTestResult.ok
-                                                ? `✅ ${t('setup.database.success')}${dbTestResult.dbVersion ? ` (v${dbTestResult.dbVersion})` : ''}`
-                                                : `❌ ${t('setup.database.error')}: ${dbTestResult.error}` }))] })), _jsxs("div", { style: S.navRow, children: [_jsxs("button", { style: S.btn('outline'), onClick: goBack, children: ["\u2190 ", t('setup.back')] }), _jsxs("button", { style: S.btn('primary', !canGoNext()), onClick: goNext, disabled: !canGoNext(), children: [t('setup.next'), " \u2192"] })] })] })), step === 'admin' && (_jsxs("div", { children: [_jsxs("div", { style: S.sectionHeader, children: [_jsx("span", { style: S.sectionIcon, children: "\uD83D\uDC64" }), _jsxs("div", { children: [_jsx("div", { style: S.sectionTitle, children: t('setup.admin.title') }), _jsx("div", { style: S.sectionDesc, children: t('setup.admin.description') })] })] }), _jsxs("div", { style: S.formRow, children: [_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.firstName') }), _jsx("input", { style: S.input, value: adminConfig.firstName, onChange: e => setAdminConfig({ ...adminConfig, firstName: e.target.value }) })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.lastName') }), _jsx("input", { style: S.input, value: adminConfig.lastName, onChange: e => setAdminConfig({ ...adminConfig, lastName: e.target.value }) })] })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.email') }), _jsx("input", { style: S.input, type: "email", value: adminConfig.email, onChange: e => setAdminConfig({ ...adminConfig, email: e.target.value }), placeholder: "admin@example.com" })] }), _jsxs("div", { style: S.formRow, children: [_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.password') }), _jsx("input", { style: S.input, type: "password", value: adminConfig.password, onChange: e => setAdminConfig({ ...adminConfig, password: e.target.value }) })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.confirmPassword') }), _jsx("input", { style: S.input, type: "password", value: adminConfig.confirmPassword, onChange: e => setAdminConfig({ ...adminConfig, confirmPassword: e.target.value }) })] })] }), adminConfig.password && adminConfig.confirmPassword && adminConfig.password !== adminConfig.confirmPassword && (_jsx("p", { style: { fontSize: 13, color: '#dc2626' }, children: t('setup.admin.passwordMismatch') })), _jsxs("div", { style: S.navRow, children: [_jsxs("button", { style: S.btn('outline'), onClick: goBack, children: ["\u2190 ", t('setup.back')] }), _jsxs("button", { style: S.btn('primary', !canGoNext()), onClick: goNext, disabled: !canGoNext(), children: [t('setup.next'), " \u2192"] })] })] })), step === 'summary' && (_jsxs("div", { children: [_jsxs("div", { style: S.sectionHeader, children: [_jsx("span", { style: S.sectionIcon, children: "\u2699\uFE0F" }), _jsxs("div", { children: [_jsx("div", { style: S.sectionTitle, children: t('setup.summary.title') }), _jsx("div", { style: S.sectionDesc, children: t('setup.summary.description') })] })] }), _jsxs("div", { style: S.summaryCard, children: [_jsx("div", { style: S.summaryTitle, children: t('setup.summary.dbConfig') }), _jsxs("div", { style: S.summaryText, children: [_jsx("span", { style: { fontFamily: 'monospace' }, children: dbSummaryLabel() }), dialect !== 'sqlite' && dbConfig.user && _jsxs("span", { style: { display: 'block', marginTop: 4 }, children: ["Utilisateur: ", dbConfig.user] })] })] }), _jsxs("div", { style: S.summaryCard, children: [_jsx("div", { style: S.summaryTitle, children: t('setup.summary.adminConfig') }), _jsxs("div", { style: S.summaryText, children: [_jsxs("div", { children: [adminConfig.firstName, " ", adminConfig.lastName] }), _jsx("div", { children: adminConfig.email })] })] }), _jsxs("div", { style: S.summaryCard, children: [_jsx("div", { style: S.summaryTitle, children: t('setup.modules.title') }), _jsx("div", { style: S.flexWrap, children: selectedModules.map(key => {
+                                                                    : (mod.installed ? 'Desinstaller' : 'Installer') })] })] }, mod.name))) }))] }), _jsxs("div", { style: S.navRow, children: [_jsxs("button", { style: S.btn('outline'), onClick: goBack, children: ["\u2190 ", t('setup.back')] }), _jsxs("button", { style: S.btn('primary', !canGoNext()), onClick: goNext, disabled: !canGoNext(), children: [t('setup.next'), " \u2192"] })] })] })), step === 'dialect' && (_jsxs("div", { children: [_jsxs("div", { style: S.sectionHeader, children: [_jsx("span", { style: S.sectionIcon, children: "\uD83D\uDCBE" }), _jsxs("div", { children: [_jsx("div", { style: S.sectionTitle, children: t('setup.dialect.title') }), _jsx("div", { style: S.sectionDesc, children: t('setup.dialect.description') })] })] }), _jsx("div", { style: S.grid3, children: DIALECT_INFO.map(d => (_jsxs("div", { style: S.dialectCard(dialect === d.key, !!d.premium), onClick: () => !d.premium && selectDialect(d.key), title: d.premium ? `${d.name} — disponible en version Premium` : d.name, children: [_jsx("div", { style: S.dialectIcon, children: d.icon }), _jsx("div", { style: S.dialectName, children: d.name }), d.premium && (_jsx("span", { style: { ...S.badge('premium'), marginLeft: 0, marginTop: 4 }, children: "Premium" }))] }, d.key))) }), _jsxs("div", { style: S.navRow, children: [_jsxs("button", { style: S.btn('outline'), onClick: goBack, children: ["\u2190 ", t('setup.back')] }), _jsxs("button", { style: S.btn('primary'), onClick: goNext, children: [t('setup.next'), " \u2192"] })] })] })), step === 'database' && (_jsxs("div", { children: [_jsxs("div", { style: S.sectionHeader, children: [_jsx("span", { style: S.sectionIcon, children: "\uD83D\uDDC4\uFE0F" }), _jsxs("div", { children: [_jsx("div", { style: S.sectionTitle, children: t('setup.database.title') }), _jsx("div", { style: S.sectionDesc, children: t('setup.database.description') })] })] }), dialect === 'sqlite' ? (_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.name') }), _jsx("input", { style: S.input, value: dbConfig.name, onChange: e => { setDbConfig({ ...dbConfig, name: e.target.value }); setDbTestResult(null); }, placeholder: dbNamePrefix }), _jsxs("p", { style: { fontSize: 11, color: '#9ca3af', marginTop: 4 }, children: [t('setup.database.sqliteInfo'), " ", _jsxs("code", { style: { fontFamily: 'monospace', backgroundColor: '#f3f4f6', padding: '1px 4px', borderRadius: 3 }, children: ["./data/", dbConfig.name, ".db"] })] })] })) : dialect === 'spanner' ? (_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.spannerPath') }), _jsx("input", { style: S.input, value: dbConfig.name, onChange: e => { setDbConfig({ ...dbConfig, name: e.target.value }); setDbTestResult(null); }, placeholder: "my-project/my-instance/mydb" }), _jsx("p", { style: { fontSize: 11, color: '#9ca3af', marginTop: 4 }, children: t('setup.database.spannerInfo') })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { style: S.formRow, children: [_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.host') }), _jsx("input", { style: S.input, value: dbConfig.host, onChange: e => { setDbConfig({ ...dbConfig, host: e.target.value }); setDbTestResult(null); } })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.port') }), _jsx("input", { style: S.input, type: "number", value: dbConfig.port, onChange: e => { setDbConfig({ ...dbConfig, port: parseInt(e.target.value) || 0 }); setDbTestResult(null); } })] })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.name') }), _jsx("input", { style: S.input, value: dbConfig.name, onChange: e => { setDbConfig({ ...dbConfig, name: e.target.value }); setDbTestResult(null); } })] }), _jsxs("div", { style: S.formRow, children: [_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.user') }), _jsx("input", { style: S.input, value: dbConfig.user, onChange: e => { setDbConfig({ ...dbConfig, user: e.target.value }); setDbTestResult(null); }, placeholder: dialect === 'hsqldb' ? 'SA' : '' })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.database.password') }), _jsx("input", { style: S.input, type: "password", value: dbConfig.password, onChange: e => { setDbConfig({ ...dbConfig, password: e.target.value }); setDbTestResult(null); } })] })] })] })), dialect === 'hsqldb' && (_jsxs("div", { style: { ...S.alert('warning'), marginTop: 12, fontSize: 12 }, children: [_jsx("strong", { children: "Prerequis :" }), " Le serveur HSQLDB doit etre lance avant le bridge.", _jsx("br", {}), _jsxs("code", { style: { fontFamily: 'monospace', backgroundColor: '#fef3c7', padding: '2px 6px', borderRadius: 3, display: 'inline-block', marginTop: 4, fontSize: 11 }, children: ["java -cp hsqldb*.jar org.hsqldb.server.Server --database.0 file:./data/", dbConfig.name, " --dbname.0 ", dbConfig.name] })] })), dialect !== 'mongodb' && dialect !== 'sqlite' && (_jsxs("div", { style: { ...S.alert('warning'), marginTop: 12 }, children: [t('setup.database.driverHint'), ' ', _jsx("code", { style: { fontFamily: 'monospace', backgroundColor: '#fef3c7', padding: '1px 4px', borderRadius: 3 }, children: DRIVER_HINTS[dialect] })] })), JDBC_DIALECTS.includes(dialect) && (_jsx(JarUploadInline, { dialect: dialect, jarEndpoint: ep.uploadJar, dbConfig: dbConfig })), dialect !== 'sqlite' && dialect !== 'spanner' && (_jsxs("div", { style: { ...S.checkRow, marginTop: 12, padding: '10px 14px', backgroundColor: '#fffbeb', border: '1px solid #fde68a', borderRadius: 8 }, children: [_jsx("input", { type: "checkbox", style: S.checkbox, checked: createIfNotExists, onChange: e => setCreateIfNotExists(e.target.checked) }), _jsxs("div", { children: [_jsx("div", { style: { fontSize: 13, fontWeight: 500 }, children: t('setup.database.createIfNotExists') }), _jsx("div", { style: { fontSize: 12, color: '#92400e' }, children: t('setup.database.createIfNotExistsDesc') })] })] })), dialect !== 'sqlite' && dialect !== 'spanner' && (_jsxs("div", { style: { ...S.flex(16), marginTop: 16 }, children: [_jsxs("button", { style: S.btn('outline', dbTesting), onClick: testDb, disabled: dbTesting, children: [dbTesting ? '⏳ ' : '🗄️ ', dbTesting ? t('setup.database.testing') : t('setup.database.test')] }), dbTestResult && (_jsxs("div", { style: { fontSize: 13 }, children: [_jsx("span", { style: { color: dbTestResult.ok ? '#059669' : '#dc2626' }, children: dbTestResult.ok
+                                                        ? `✅ ${t('setup.database.success')}${dbTestResult.dbVersion ? ` (v${dbTestResult.dbVersion})` : ''}`
+                                                        : `❌ ${t('setup.database.error')}: ${dbTestResult.error}` }), dbTestResult.ok && (_jsxs("div", { style: { fontSize: 11, color: '#6b7280', marginTop: 4, fontFamily: 'monospace', backgroundColor: '#f3f4f6', padding: '4px 8px', borderRadius: 4 }, children: [dialect, "://", dbConfig.user ? dbConfig.user + '@' : '', dbConfig.host, ":", dbConfig.port, "/", dbConfig.name] }))] }))] })), _jsxs("div", { style: S.navRow, children: [_jsxs("button", { style: S.btn('outline'), onClick: goBack, children: ["\u2190 ", t('setup.back')] }), _jsxs("button", { style: S.btn('primary', !canGoNext()), onClick: goNext, disabled: !canGoNext(), children: [t('setup.next'), " \u2192"] })] })] })), step === 'admin' && (_jsxs("div", { children: [_jsxs("div", { style: S.sectionHeader, children: [_jsx("span", { style: S.sectionIcon, children: "\uD83D\uDC64" }), _jsxs("div", { children: [_jsx("div", { style: S.sectionTitle, children: t('setup.admin.title') }), _jsx("div", { style: S.sectionDesc, children: t('setup.admin.description') })] })] }), _jsxs("div", { style: S.formRow, children: [_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.firstName') }), _jsx("input", { style: S.input, value: adminConfig.firstName, onChange: e => setAdminConfig({ ...adminConfig, firstName: e.target.value }) })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.lastName') }), _jsx("input", { style: S.input, value: adminConfig.lastName, onChange: e => setAdminConfig({ ...adminConfig, lastName: e.target.value }) })] })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.email') }), _jsx("input", { style: S.input, type: "email", value: adminConfig.email, onChange: e => setAdminConfig({ ...adminConfig, email: e.target.value }), placeholder: "admin@example.com" })] }), _jsxs("div", { style: S.formRow, children: [_jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.password') }), _jsx("input", { style: S.input, type: "password", value: adminConfig.password, onChange: e => setAdminConfig({ ...adminConfig, password: e.target.value }) })] }), _jsxs("div", { style: S.formGroup, children: [_jsx("label", { style: S.label, children: t('setup.admin.confirmPassword') }), _jsx("input", { style: S.input, type: "password", value: adminConfig.confirmPassword, onChange: e => setAdminConfig({ ...adminConfig, confirmPassword: e.target.value }) })] })] }), adminConfig.password && adminConfig.confirmPassword && adminConfig.password !== adminConfig.confirmPassword && (_jsx("p", { style: { fontSize: 13, color: '#dc2626' }, children: t('setup.admin.passwordMismatch') })), _jsxs("div", { style: S.navRow, children: [_jsxs("button", { style: S.btn('outline'), onClick: goBack, children: ["\u2190 ", t('setup.back')] }), _jsxs("button", { style: S.btn('primary', !canGoNext()), onClick: goNext, disabled: !canGoNext(), children: [t('setup.next'), " \u2192"] })] })] })), step === 'summary' && (_jsxs("div", { children: [_jsxs("div", { style: S.sectionHeader, children: [_jsx("span", { style: S.sectionIcon, children: "\u2699\uFE0F" }), _jsxs("div", { children: [_jsx("div", { style: S.sectionTitle, children: t('setup.summary.title') }), _jsx("div", { style: S.sectionDesc, children: t('setup.summary.description') })] })] }), _jsxs("div", { style: S.summaryCard, children: [_jsx("div", { style: S.summaryTitle, children: t('setup.summary.dbConfig') }), _jsxs("div", { style: S.summaryText, children: [_jsx("span", { style: { fontFamily: 'monospace' }, children: dbSummaryLabel() }), dialect !== 'sqlite' && dbConfig.user && _jsxs("span", { style: { display: 'block', marginTop: 4 }, children: ["Utilisateur: ", dbConfig.user] })] })] }), _jsxs("div", { style: S.summaryCard, children: [_jsx("div", { style: S.summaryTitle, children: t('setup.summary.adminConfig') }), _jsxs("div", { style: S.summaryText, children: [_jsxs("div", { children: [adminConfig.firstName, " ", adminConfig.lastName] }), _jsx("div", { children: adminConfig.email })] })] }), _jsxs("div", { style: S.summaryCard, children: [_jsx("div", { style: S.summaryTitle, children: t('setup.modules.title') }), _jsx("div", { style: S.flexWrap, children: selectedModules.map(key => {
                                                 const mod = availableModules.find(m => m.key === key);
                                                 return mod ? (_jsxs("span", { style: {
                                                         display: 'inline-flex', alignItems: 'center', gap: 4,

package/dist/data/dialects.d.ts

@@ -1,3 +1,3 @@
-import type { DialectType, DialectInfo } from '../types/index';
+import type { DialectType, DialectInfo } from '../types/index.js';
 export declare const DIALECT_INFO: Record<DialectType, DialectInfo>;
 export declare const ALL_DIALECTS: DialectType[];

package/dist/index.d.ts

@@ -1,22 +1,22 @@
-export { needsSetup, runInstall } from './lib/setup';
-export { testDbConnection } from './lib/db-test';
-export { composeDbUri } from './lib/compose-uri';
-export { writeEnvLocal } from './lib/env-writer';
-export { DIALECT_INFO, ALL_DIALECTS } from './data/dialects';
-export { MODULES, resolveModuleDependencies } from './data/module-definitions';
-export { discoverNpmModules } from './lib/discover-modules';
-export { loadSetupJson } from './lib/load-setup-json';
-export type { SetupJson, SetupJsonRbac, SetupJsonSeed, SetupJsonCategory, SetupJsonPermission, SetupJsonRole } from './lib/load-setup-json';
-export { createTestDbHandler } from './api/test-db.route';
-export { createInstallHandler } from './api/install.route';
-export { createStatusHandler } from './api/status.route';
-export { createDetectModulesHandler } from './api/detect-modules.route';
-export { createInstallModulesHandler } from './api/install-modules.route';
-export { createReconfigHandlers } from './api/reconfig.route';
-export { createUploadJarHandlers } from './api/upload-jar.route';
-export { createWireModuleHandler } from './api/wire-module.route';
-export { createSetupJsonHandler } from './api/upload-setup-json.route';
-export { default as ReconfigPanel } from './components/ReconfigPanel';
-export { default as SetupWizard } from './components/SetupWizard';
-export { setupMenuContribution } from './lib/menu';
-export type { DialectType, DialectInfo, DbConfig, InstallConfig, SeedOptions, SeedDefinition, MostaSetupConfig, ModuleDefinition, } from './types/index';
+export { needsSetup, runInstall } from './lib/setup.js';
+export { testDbConnection } from './lib/db-test.js';
+export { composeDbUri } from './lib/compose-uri.js';
+export { writeEnvLocal } from './lib/env-writer.js';
+export { DIALECT_INFO, ALL_DIALECTS } from './data/dialects.js';
+export { MODULES, resolveModuleDependencies } from './data/module-definitions.js';
+export { discoverNpmModules } from './lib/discover-modules.js';
+export { loadSetupJson } from './lib/load-setup-json.js';
+export type { SetupJson, SetupJsonRbac, SetupJsonSeed, SetupJsonCategory, SetupJsonPermission, SetupJsonRole } from './lib/load-setup-json.js';
+export { createTestDbHandler } from './api/test-db.route.js';
+export { createInstallHandler } from './api/install.route.js';
+export { createStatusHandler } from './api/status.route.js';
+export { createDetectModulesHandler } from './api/detect-modules.route.js';
+export { createInstallModulesHandler } from './api/install-modules.route.js';
+export { createReconfigHandlers } from './api/reconfig.route.js';
+export { createUploadJarHandlers } from './api/upload-jar.route.js';
+export { createWireModuleHandler } from './api/wire-module.route.js';
+export { createSetupJsonHandler } from './api/upload-setup-json.route.js';
+export { default as ReconfigPanel } from './components/ReconfigPanel.js';
+export { default as SetupWizard } from './components/SetupWizard.js';
+export { setupMenuContribution } from './lib/menu.js';
+export type { DialectType, DialectInfo, DbConfig, InstallConfig, SeedOptions, SeedDefinition, MostaSetupConfig, ModuleDefinition, } from './types/index.js';

package/dist/index.js

@@ -1,28 +1,28 @@
 // @mosta/setup — Barrel exports
 // Author: Dr Hamid MADANI drmdh@msn.com
 // Core
-export { needsSetup, runInstall } from './lib/setup';
-export { testDbConnection } from './lib/db-test';
-export { composeDbUri } from './lib/compose-uri';
-export { writeEnvLocal } from './lib/env-writer';
+export { needsSetup, runInstall } from './lib/setup.js';
+export { testDbConnection } from './lib/db-test.js';
+export { composeDbUri } from './lib/compose-uri.js';
+export { writeEnvLocal } from './lib/env-writer.js';
 // Data
-export { DIALECT_INFO, ALL_DIALECTS } from './data/dialects';
-export { MODULES, resolveModuleDependencies } from './data/module-definitions';
+export { DIALECT_INFO, ALL_DIALECTS } from './data/dialects.js';
+export { MODULES, resolveModuleDependencies } from './data/module-definitions.js';
 // Lib
-export { discoverNpmModules } from './lib/discover-modules';
-export { loadSetupJson } from './lib/load-setup-json';
+export { discoverNpmModules } from './lib/discover-modules.js';
+export { loadSetupJson } from './lib/load-setup-json.js';
 // API route factories
-export { createTestDbHandler } from './api/test-db.route';
-export { createInstallHandler } from './api/install.route';
-export { createStatusHandler } from './api/status.route';
-export { createDetectModulesHandler } from './api/detect-modules.route';
-export { createInstallModulesHandler } from './api/install-modules.route';
-export { createReconfigHandlers } from './api/reconfig.route';
-export { createUploadJarHandlers } from './api/upload-jar.route';
-export { createWireModuleHandler } from './api/wire-module.route';
-export { createSetupJsonHandler } from './api/upload-setup-json.route';
+export { createTestDbHandler } from './api/test-db.route.js';
+export { createInstallHandler } from './api/install.route.js';
+export { createStatusHandler } from './api/status.route.js';
+export { createDetectModulesHandler } from './api/detect-modules.route.js';
+export { createInstallModulesHandler } from './api/install-modules.route.js';
+export { createReconfigHandlers } from './api/reconfig.route.js';
+export { createUploadJarHandlers } from './api/upload-jar.route.js';
+export { createWireModuleHandler } from './api/wire-module.route.js';
+export { createSetupJsonHandler } from './api/upload-setup-json.route.js';
 // Components
-export { default as ReconfigPanel } from './components/ReconfigPanel';
-export { default as SetupWizard } from './components/SetupWizard';
+export { default as ReconfigPanel } from './components/ReconfigPanel.js';
+export { default as SetupWizard } from './components/SetupWizard.js';
 // Menu contribution
-export { setupMenuContribution } from './lib/menu';
+export { setupMenuContribution } from './lib/menu.js';

package/dist/lib/compose-uri.d.ts

@@ -1,4 +1,4 @@
-import type { DialectType, DbConfig } from '../types/index';
+import type { DialectType, DbConfig } from '../types/index.js';
 /**
  * Compose a database connection URI from individual fields.
  */

package/dist/lib/db-test.d.ts

@@ -1,4 +1,4 @@
-import type { DialectType, DbConfig } from '../types/index';
+import type { DialectType, DbConfig } from '../types/index.js';
 /**
  * Test a database connection without affecting the global dialect singleton.
  */

package/dist/lib/db-test.js

@@ -1,4 +1,4 @@
-import { composeDbUri } from './compose-uri';
+import { composeDbUri } from './compose-uri.js';
 /**
  * Test a database connection without affecting the global dialect singleton.
  */

package/dist/lib/discover-modules.d.ts

@@ -1,4 +1,4 @@
-import { type ModuleDefinition } from '../data/module-definitions';
+import { type ModuleDefinition } from '../data/module-definitions.js';
 /**
  * Discover @mostajs packages from npm registry and merge with static list.
  *

package/dist/lib/discover-modules.js

@@ -4,7 +4,7 @@ import { exec } from 'child_process';
 import { promisify } from 'util';
 import fs from 'fs';
 import path from 'path';
-import { MODULES } from '../data/module-definitions';
+import { MODULES } from '../data/module-definitions.js';
 const execAsync = promisify(exec);
 /**
  * Discover @mostajs packages from npm registry and merge with static list.

package/dist/lib/env-writer.d.ts

@@ -1,4 +1,4 @@
-import type { DialectType } from '../types/index';
+import type { DialectType } from '../types/index.js';
 export interface EnvWriterOptions {
     dialect: DialectType;
     uri: string;

package/dist/lib/load-setup-json.d.ts

@@ -1,4 +1,4 @@
-import type { MostaSetupConfig } from '../types/index';
+import type { MostaSetupConfig } from '../types/index.js';
 export interface SetupJsonCategory {
     name: string;
     label: string;
@@ -45,9 +45,19 @@ export interface SetupJson {
         dbNamePrefix?: string;
     };
     env?: Record<string, string>;
+    modules?: SetupJsonModule[];
     rbac?: SetupJsonRbac;
     seeds?: SetupJsonSeed[];
 }
+export interface SetupJsonModule {
+    key: string;
+    packageName: string;
+    label?: string;
+    description?: string;
+    icon?: string;
+    required?: boolean;
+    dependsOn?: string[];
+}
 /**
  * Load a setup.json and return a MostaSetupConfig.
  *

package/dist/lib/load-setup-json.js

@@ -58,10 +58,15 @@ function validate(json) {
     }
 }
 function buildConfig(json, repoFactory) {
+    // Derive MOSTAJS_MODULES from modules[] section
+    const extraEnvVars = { ...(json.env ?? {}) };
+    if (json.modules?.length) {
+        extraEnvVars.MOSTAJS_MODULES = json.modules.map(m => m.key).join(',');
+    }
     const config = {
         appName: json.app.name,
         defaultPort: json.app.port,
-        extraEnvVars: json.env ? { ...json.env } : undefined,
+        extraEnvVars: Object.keys(extraEnvVars).length > 0 ? extraEnvVars : undefined,
     };
     // ── seedRBAC ───────────────────────────────────────────
     if (json.rbac) {
@@ -88,7 +93,7 @@ function buildConfig(json, repoFactory) {
             if (json.rbac.roles?.length) {
                 const roleRepo = await getRepo('role');
                 const allPermIds = Object.values(permissionMap);
-                for (const roleDef of json.rbac.roles) {
+                for (const roleDef of json.rbac.roles.filter(r => r.name)) {
                     const permissionIds = roleDef.permissions.includes('*')
                         ? allPermIds
                         : roleDef.permissions.map(code => permissionMap[code]).filter(Boolean);

package/dist/lib/setup.d.ts

@@ -1,4 +1,4 @@
-import type { InstallConfig, MostaSetupConfig } from '../types/index';
+import type { InstallConfig, MostaSetupConfig } from '../types/index.js';
 /**
  * Check if the app needs initial setup (0 users in DB).
  * Provide a countUsers function from your app.

package/dist/lib/setup.js

@@ -1,7 +1,7 @@
 // @mosta/setup — Core setup logic
 // Author: Dr Hamid MADANI drmdh@msn.com
-import { composeDbUri } from './compose-uri';
-import { writeEnvLocal } from './env-writer';
+import { composeDbUri } from './compose-uri.js';
+import { writeEnvLocal } from './env-writer.js';
 /**
  * Check if the app needs initial setup (0 users in DB).
  * Provide a countUsers function from your app.

package/dist/types/index.d.ts

@@ -28,7 +28,7 @@ export interface InstallConfig {
     seed?: SeedOptions;
     modules?: string[];
 }
-export type { ModuleDefinition } from '../data/module-definitions';
+export type { ModuleDefinition } from '../data/module-definitions.js';
 export interface SeedOptions {
     [key: string]: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/setup",
-  "version": "1.5.1",
+  "version": "2.0.0",
   "description": "Reusable setup wizard module — multi-dialect DB configuration, .env.local writer, seed runner",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "MIT",

package/schemas/setup.schema.json

@@ -151,6 +151,45 @@
         }
       }
     },
+    "modules": {
+      "type": "array",
+      "description": "Modules to use in the project. Exported by MostaSetup Studio. Shown in the wizard with install commands.",
+      "items": {
+        "type": "object",
+        "required": ["key", "packageName"],
+        "additionalProperties": false,
+        "properties": {
+          "key": {
+            "type": "string",
+            "description": "Unique module identifier (e.g. 'orm', 'auth', 'ticketing')"
+          },
+          "packageName": {
+            "type": "string",
+            "description": "npm package name (e.g. '@mostajs/orm')"
+          },
+          "label": {
+            "type": "string",
+            "description": "Display label"
+          },
+          "description": {
+            "type": "string"
+          },
+          "icon": {
+            "type": "string",
+            "description": "Emoji icon"
+          },
+          "required": {
+            "type": "boolean",
+            "description": "Whether this module is required (cannot be deselected)"
+          },
+          "dependsOn": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Module keys this module depends on"
+          }
+        }
+      }
+    },
     "seeds": {
       "type": "array",
       "description": "Optional seed datasets shown as checkboxes in the install wizard",