@jumentix/cli-init 0.0.0

package/dist/generators/domains.js

@@ -0,0 +1,170 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectDesignerDomains = exports.renderCompositionRoot = exports.planDomainsToDesignerState = exports.domainsForService = exports.isUsersDomain = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const planBuilder_1 = require("../sources/planBuilder");
+const USERS_DOMAIN_TOKENS = new Set(['users', 'user']);
+function isUsersDomain(domain) {
+    const id = String(domain.id || '').toLowerCase();
+    const name = String(domain.name || '').toLowerCase();
+    return USERS_DOMAIN_TOKENS.has(id) || USERS_DOMAIN_TOKENS.has(name);
+}
+exports.isUsersDomain = isUsersDomain;
+/**
+ * Domains owned by a service that should be codegen'd (Users stays from the
+ * template seed — never overwritten by hexagonal boilerplate).
+ */
+function domainsForService(plan, service) {
+    const owned = new Set(service.domains.map((id) => String(id)));
+    return plan.domains.filter((domain) => {
+        if (isUsersDomain(domain))
+            return false;
+        if (owned.size === 0)
+            return service.kind === 'core';
+        return owned.has(domain.id) || (domain.name ? owned.has(domain.name) : false);
+    });
+}
+exports.domainsForService = domainsForService;
+/**
+ * Convert plan domains into the designer-state shape `buildHexagonalBundle`
+ * expects.
+ */
+function planDomainsToDesignerState(domains) {
+    return {
+        domains: domains.map((domain) => {
+            const name = domain.name || domain.id;
+            return {
+                id: domain.id,
+                name,
+                entities: domain.entities.map((entity) => {
+                    const properties = (entity.schema && typeof entity.schema === 'object'
+                        && entity.schema.properties)
+                        || {};
+                    const fieldNames = Object.keys(properties);
+                    const fields = (fieldNames.length
+                        ? fieldNames
+                        : [entity.primaryKey || 'id']).map((fieldName) => ({
+                        name: fieldName,
+                        pk: fieldName === entity.primaryKey,
+                        type: 'string'
+                    }));
+                    return {
+                        id: entity.name,
+                        name: entity.name,
+                        fields
+                    };
+                })
+            };
+        })
+    };
+}
+exports.planDomainsToDesignerState = planDomainsToDesignerState;
+function toDomainToken(value) {
+    const token = String(value || '')
+        .trim()
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+    return token || 'Domain';
+}
+function flattenBundleLocally(bundle) {
+    const files = [];
+    for (const module of bundle.modules) {
+        for (const role of Object.keys(module.files)) {
+            const file = module.files[role];
+            if (file)
+                files.push(file);
+        }
+        for (const entity of module.entities) {
+            for (const role of Object.keys(entity.files)) {
+                files.push(entity.files[role]);
+            }
+        }
+    }
+    return files;
+}
+/**
+ * Composition root that always registers Users auth and any generated domains.
+ */
+function renderCompositionRoot(generatedModuleTokens) {
+    const unique = [...new Set(generatedModuleTokens)].filter(Boolean);
+    const imports = unique.map((token) => `import { compose${token}Services } from './${token}/composition/compose${token}Services';`);
+    const registerLines = unique.map((token) => `  ${token}: compose${token}Services()`);
+    const registryBody = [
+        '  ...(users ? { Users: users } : {}),',
+        ...registerLines.map((line, index) => (index < registerLines.length - 1 ? `${line},` : line))
+    ];
+    return [
+        '/**',
+        ' * Generated composition root (JUM-847).',
+        ' * Core always includes Users + auth from the seed; designer domains are',
+        ' * registered via their hexagonal compose<Domain>Services exports.',
+        ' */',
+        'import { composeUsersAuthServices } from \'./Users/composition/composeUsersAuthServices\';',
+        ...imports,
+        '',
+        'export type GeneratedDomainRegistry = Record<string, unknown>;',
+        '',
+        'export function registerGeneratedDomains(',
+        '  usersDeps?: Parameters<typeof composeUsersAuthServices>[0]',
+        '): GeneratedDomainRegistry {',
+        '  const users = usersDeps',
+        '    ? composeUsersAuthServices(usersDeps)',
+        '    : undefined;',
+        '  return {',
+        ...registryBody,
+        '  };',
+        '}',
+        '',
+        `export const GENERATED_DOMAIN_MODULES = ${JSON.stringify(unique)} as const;`,
+        ''
+    ].join('\n');
+}
+exports.renderCompositionRoot = renderCompositionRoot;
+/**
+ * Generate hexagonal modules for non-Users domains and write a composition
+ * root that registers each `compose<Domain>Services` export.
+ */
+async function injectDesignerDomains(options) {
+    const { serviceRoot, plan, service } = options;
+    const targetDomains = domainsForService(plan, service);
+    const filesWritten = [];
+    const moduleNames = [];
+    if (targetDomains.length === 0) {
+        const compositionPath = node_path_1.default.join(serviceRoot, 'src', 'modules', 'compositionRoot.ts');
+        const content = renderCompositionRoot([]);
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(compositionPath), { recursive: true });
+        node_fs_1.default.writeFileSync(compositionPath, content, 'utf8');
+        filesWritten.push('src/modules/compositionRoot.ts');
+        return { moduleNames, filesWritten };
+    }
+    const designerCore = await (0, planBuilder_1.loadDesignerCore)();
+    const state = planDomainsToDesignerState(targetDomains);
+    const oasDocument = plan.contracts.oasPerService[service.id]
+        || Object.values(plan.contracts.oasPerService)[0]
+        || {};
+    const bundle = designerCore.buildHexagonalBundle(state, { oasDocument });
+    const flat = typeof designerCore.flattenBundleFiles === 'function'
+        ? designerCore.flattenBundleFiles(bundle)
+        : flattenBundleLocally(bundle);
+    for (const file of flat) {
+        const absolute = node_path_1.default.join(serviceRoot, file.path);
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(absolute), { recursive: true });
+        node_fs_1.default.writeFileSync(absolute, file.content, 'utf8');
+        filesWritten.push(file.path.replace(/\\/g, '/'));
+    }
+    for (const module of bundle.modules) {
+        moduleNames.push(toDomainToken(module.module));
+    }
+    const compositionPath = node_path_1.default.join(serviceRoot, 'src', 'modules', 'compositionRoot.ts');
+    node_fs_1.default.writeFileSync(compositionPath, renderCompositionRoot(moduleNames), 'utf8');
+    filesWritten.push('src/modules/compositionRoot.ts');
+    return { moduleNames, filesWritten };
+}
+exports.injectDesignerDomains = injectDesignerDomains;
+//# sourceMappingURL=domains.js.map

package/dist/generators/domains.js.map

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

package/dist/generators/env.d.ts

@@ -0,0 +1,26 @@
+import type { DbChoice, HttpInterface, RealtimeInterface } from '../sources/types';
+/** Runtime env driver names accepted by `@jumentix/database-client-factory`. */
+export type EnvDatabaseDriver = 'SQLite' | 'PostgreSQL' | 'MySQL' | 'Mongo' | 'InMemory';
+/**
+ * Map a GenerationPlan db choice to the seed's `JUMENTIX_DATABASE_DRIVER` value.
+ */
+export declare function mapDbChoiceToDriver(db: DbChoice): EnvDatabaseDriver;
+/**
+ * Map realtime plan choice to seed env pair
+ * (`JUMENTIX_REALTIME_API` + `JUMENTIX_REALTIME_API_PROTOCOL`).
+ */
+export declare function mapRealtimeToEnv(realtime: RealtimeInterface): {
+    enabled: 'yes' | 'no';
+    protocol: 'websocket' | 'grpc';
+};
+export type EnvRenderInput = {
+    http: HttpInterface;
+    realtime: RealtimeInterface;
+    db: DbChoice;
+    databaseName?: string;
+};
+/**
+ * Render a `.env.dev` body from plan interfaces/db, starting from the seed
+ * template content when provided.
+ */
+export declare function renderEnvDev(input: EnvRenderInput, templateContent?: string): string;

package/dist/generators/env.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderEnvDev = exports.mapRealtimeToEnv = exports.mapDbChoiceToDriver = void 0;
+const DB_DRIVER_MAP = {
+    sqlite: 'SQLite',
+    postgres: 'PostgreSQL',
+    mysql: 'MySQL',
+    mongo: 'Mongo',
+    inmemory: 'InMemory'
+};
+/**
+ * Map a GenerationPlan db choice to the seed's `JUMENTIX_DATABASE_DRIVER` value.
+ */
+function mapDbChoiceToDriver(db) {
+    return DB_DRIVER_MAP[db] || 'InMemory';
+}
+exports.mapDbChoiceToDriver = mapDbChoiceToDriver;
+/**
+ * Map realtime plan choice to seed env pair
+ * (`JUMENTIX_REALTIME_API` + `JUMENTIX_REALTIME_API_PROTOCOL`).
+ */
+function mapRealtimeToEnv(realtime) {
+    if (realtime === 'none') {
+        return { enabled: 'no', protocol: 'websocket' };
+    }
+    return {
+        enabled: 'yes',
+        protocol: realtime === 'grpc' ? 'grpc' : 'websocket'
+    };
+}
+exports.mapRealtimeToEnv = mapRealtimeToEnv;
+/**
+ * Render a `.env.dev` body from plan interfaces/db, starting from the seed
+ * template content when provided.
+ */
+function renderEnvDev(input, templateContent = '') {
+    const driver = mapDbChoiceToDriver(input.db);
+    const realtime = mapRealtimeToEnv(input.realtime);
+    const databaseName = input.databaseName || 'jumentix';
+    const replacements = [
+        [/^JUMENTIX_HTTP_FRAMEWORK=.*$/m, `JUMENTIX_HTTP_FRAMEWORK=${input.http}`],
+        [/^JUMENTIX_REALTIME_API=.*$/m, `JUMENTIX_REALTIME_API=${realtime.enabled}`],
+        [
+            /^JUMENTIX_REALTIME_API_PROTOCOL=.*$/m,
+            `JUMENTIX_REALTIME_API_PROTOCOL=${realtime.protocol}`
+        ],
+        [/^JUMENTIX_DATABASE_DRIVER=.*$/m, `JUMENTIX_DATABASE_DRIVER=${driver}`],
+        [/^JUMENTIX_DATABASE_NAME=.*$/m, `JUMENTIX_DATABASE_NAME=${databaseName}`]
+    ];
+    let body = templateContent.trimEnd();
+    if (!body) {
+        body = [
+            'JUMENTIX_HTTP_FRAMEWORK=express',
+            'JUMENTIX_REALTIME_API=no',
+            'JUMENTIX_REALTIME_API_PROTOCOL=websocket',
+            'JUMENTIX_DATABASE_DRIVER=InMemory',
+            'JUMENTIX_DATABASE_NAME=jumentix',
+            ''
+        ].join('\n');
+    }
+    for (const [pattern, line] of replacements) {
+        if (pattern.test(body)) {
+            body = body.replace(pattern, line);
+        }
+        else {
+            body = `${body}\n${line}`;
+        }
+    }
+    return `${body.trimEnd()}\n`;
+}
+exports.renderEnvDev = renderEnvDev;
+//# sourceMappingURL=env.js.map

package/dist/generators/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/generators/env.ts"],"names":[],"mappings":";;;AAKA,MAAM,aAAa,GAAwC;IACzD,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,YAAY;IACtB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF;;GAEG;AACH,SAAgB,mBAAmB,CAAC,EAAY;IAC9C,OAAO,aAAa,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC;AACzC,CAAC;AAFD,kDAEC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,QAA2B;IAI1D,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAClD,CAAC;IACD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW;KACrD,CAAC;AACJ,CAAC;AAXD,4CAWC;AASD;;;GAGG;AACH,SAAgB,YAAY,CAC1B,KAAqB,EACrB,eAAe,GAAG,EAAE;IAEpB,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,UAAU,CAAC;IAEtD,MAAM,YAAY,GAA4B;QAC5C,CAAC,+BAA+B,EAAE,2BAA2B,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1E,CAAC,6BAA6B,EAAE,yBAAyB,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC5E;YACE,sCAAsC;YACtC,kCAAkC,QAAQ,CAAC,QAAQ,EAAE;SACtD;QACD,CAAC,gCAAgC,EAAE,4BAA4B,MAAM,EAAE,CAAC;QACxE,CAAC,8BAA8B,EAAE,0BAA0B,YAAY,EAAE,CAAC;KAC3E,CAAC;IAEF,IAAI,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG;YACL,iCAAiC;YACjC,0BAA0B;YAC1B,0CAA0C;YAC1C,mCAAmC;YACnC,iCAAiC;YACjC,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,YAAY,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,GAAG,IAAI,KAAK,IAAI,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;AAC/B,CAAC;AAxCD,oCAwCC"}

package/dist/generators/frontend.d.ts

@@ -0,0 +1,47 @@
+import type { GenerationPlan } from '../sources/types';
+import { type GeneratedModuleResult } from './frontendModules';
+export type GenerateFrontendOptions = {
+    plan: GenerationPlan;
+    /** Workspace root (services/frontend land under `apps/`). */
+    outputDir: string;
+    /** npm scope from project name (`@<project>/frontend`). */
+    projectName: string;
+    /** Force one version for every `@jumentix/*` dep (default: recorded per-package versions). */
+    jumentixVersion?: string;
+    /** Override template root (tests). */
+    templateRoot?: string;
+    /** Destination folder under apps/ (default: frontend). */
+    appFolder?: string;
+    log?: (message?: string) => void;
+};
+export type GenerateFrontendResult = {
+    root: string;
+    packageName: string;
+    modules: GeneratedModuleResult[];
+    offline: boolean;
+    bakedPaths: number;
+    envPath: string;
+};
+/**
+ * Bake merged OAS into `src/contracts/openapi.json`.
+ * When the plan's filtered OAS has no paths (common for the Users preset
+ * fixture before `x-service` annotations), keep the seed contract already
+ * copied from the template.
+ */
+export declare function bakeMergedOas(frontendRoot: string, plan: GenerationPlan): {
+    bakedPaths: number;
+    keptTemplate: boolean;
+};
+/**
+ * Write `.env` with Core/service URLs and the offline flag.
+ */
+export declare function writeFrontendEnv(frontendRoot: string, plan: GenerationPlan, offline: boolean): string;
+/**
+ * When `--offline` is off, disable the Cana boot path in main.ts and drop
+ * offline Cypress specs so the seed stays online-only.
+ */
+export declare function applyOfflineFlag(frontendRoot: string, offline: boolean): void;
+/**
+ * Generate `apps/frontend` from the packaged seed + GenerationPlan.
+ */
+export declare function generateFrontend(options: GenerateFrontendOptions): Promise<GenerateFrontendResult>;

package/dist/generators/frontend.js

@@ -0,0 +1,211 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFrontend = exports.applyOfflineFlag = exports.writeFrontendEnv = exports.bakeMergedOas = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const jumentixVersions_1 = require("./jumentixVersions");
+const frontendModules_1 = require("./frontendModules");
+const frontendOas_1 = require("./frontendOas");
+const paths_1 = require("./paths");
+const FRONTEND_JUMENTIX_DEPS = Object.freeze([
+    '@jumentix/cana',
+    '@jumentix/cana-vue',
+    '@jumentix/persistence-contracts',
+    '@jumentix/sdk-rest-client'
+]);
+function copyFrontendTemplate(templateRoot, destRoot) {
+    const walk = (srcDir, rel = '') => {
+        const entries = node_fs_1.default.readdirSync(srcDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const relPath = rel ? `${rel}/${entry.name}` : entry.name;
+            const normalized = relPath.replace(/\\/g, '/');
+            const srcPath = node_path_1.default.join(srcDir, entry.name);
+            const destPath = node_path_1.default.join(destRoot, ...normalized.split('/'));
+            if (entry.isDirectory()) {
+                node_fs_1.default.mkdirSync(destPath, { recursive: true });
+                walk(srcPath, normalized);
+            }
+            else {
+                node_fs_1.default.mkdirSync(node_path_1.default.dirname(destPath), { recursive: true });
+                node_fs_1.default.copyFileSync(srcPath, destPath);
+            }
+        }
+    };
+    node_fs_1.default.mkdirSync(destRoot, { recursive: true });
+    walk(templateRoot);
+}
+function writeFrontendPackageJson(frontendRoot, projectName, pin) {
+    const pkgPath = node_path_1.default.join(frontendRoot, 'package.json');
+    let pkg = {};
+    if (node_fs_1.default.existsSync(pkgPath)) {
+        pkg = JSON.parse(node_fs_1.default.readFileSync(pkgPath, 'utf8'));
+    }
+    const scope = (0, paths_1.sanitizePackageScope)(projectName);
+    const packageName = `@${scope}/frontend`;
+    pkg.name = packageName;
+    pkg.version = '0.0.0';
+    pkg.private = true;
+    const dependencies = (pkg.dependencies && typeof pkg.dependencies === 'object'
+        ? { ...pkg.dependencies }
+        : {});
+    for (const name of FRONTEND_JUMENTIX_DEPS) {
+        if (dependencies[name] !== undefined) {
+            dependencies[name] = pin(name);
+        }
+    }
+    pkg.dependencies = dependencies;
+    pkg.jumentix = {
+        generated: true,
+        kind: 'frontend'
+    };
+    node_fs_1.default.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+    return packageName;
+}
+/**
+ * Bake merged OAS into `src/contracts/openapi.json`.
+ * When the plan's filtered OAS has no paths (common for the Users preset
+ * fixture before `x-service` annotations), keep the seed contract already
+ * copied from the template.
+ */
+function bakeMergedOas(frontendRoot, plan) {
+    const outputPath = node_path_1.default.join(frontendRoot, 'src', 'contracts', 'openapi.json');
+    const merged = (0, frontendOas_1.mergeServiceOas)(plan.contracts.oasPerService);
+    const pathCount = (0, frontendOas_1.oasPathCount)(merged);
+    if (pathCount === 0) {
+        if (!node_fs_1.default.existsSync(outputPath)) {
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(outputPath), { recursive: true });
+            node_fs_1.default.writeFileSync(outputPath, `${JSON.stringify(merged, null, 2)}\n`, 'utf8');
+            return { bakedPaths: 0, keptTemplate: false };
+        }
+        const existing = JSON.parse(node_fs_1.default.readFileSync(outputPath, 'utf8'));
+        return { bakedPaths: (0, frontendOas_1.oasPathCount)(existing), keptTemplate: true };
+    }
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(outputPath), { recursive: true });
+    node_fs_1.default.writeFileSync(outputPath, `${JSON.stringify(merged, null, 2)}\n`, 'utf8');
+    return { bakedPaths: pathCount, keptTemplate: false };
+}
+exports.bakeMergedOas = bakeMergedOas;
+function readBundledOas(frontendRoot) {
+    const outputPath = node_path_1.default.join(frontendRoot, 'src', 'contracts', 'openapi.json');
+    if (!node_fs_1.default.existsSync(outputPath))
+        return { paths: {}, components: { schemas: {} } };
+    return JSON.parse(node_fs_1.default.readFileSync(outputPath, 'utf8'));
+}
+function coreServiceUrl(plan) {
+    const core = plan.services.find((service) => service.kind === 'core') || plan.services[0];
+    return core?.url || 'http://localhost:3000/api/1.0.0';
+}
+function proxyTargetFromApiUrl(apiUrl) {
+    try {
+        const parsed = new URL(apiUrl);
+        return `${parsed.protocol}//${parsed.host}`;
+    }
+    catch {
+        return 'http://localhost:3010';
+    }
+}
+/**
+ * Write `.env` with Core/service URLs and the offline flag.
+ */
+function writeFrontendEnv(frontendRoot, plan, offline) {
+    const coreUrl = coreServiceUrl(plan);
+    const proxyTarget = proxyTargetFromApiUrl(coreUrl);
+    const targets = {};
+    for (const service of plan.services) {
+        const url = service.url || coreUrl;
+        targets[service.id] = proxyTargetFromApiUrl(url);
+    }
+    const lines = [
+        '# Generated by @jumentix/cli-init',
+        `VITE_API_BASE_URL=${coreUrl}`,
+        `VITE_API_PROXY_TARGET=${proxyTarget}`,
+        `VITE_API_PROXY_TARGETS=${JSON.stringify(targets)}`,
+        'VITE_DEV_PORT=3001',
+        `VITE_CORE_URL=${coreUrl}`,
+        `VITE_OFFLINE=${offline ? '1' : '0'}`,
+        `VITE_PWA=${offline ? '1' : '0'}`
+    ];
+    for (const service of plan.services) {
+        const key = `VITE_SERVICE_${(0, paths_1.sanitizePackageScope)(service.id).replace(/-/g, '_').toUpperCase()}_URL`;
+        lines.push(`${key}=${service.url || coreUrl}`);
+    }
+    lines.push('');
+    const envPath = node_path_1.default.join(frontendRoot, '.env');
+    node_fs_1.default.writeFileSync(envPath, `${lines.join('\n')}\n`, 'utf8');
+    return envPath;
+}
+exports.writeFrontendEnv = writeFrontendEnv;
+/**
+ * When `--offline` is off, disable the Cana boot path in main.ts and drop
+ * offline Cypress specs so the seed stays online-only.
+ */
+function applyOfflineFlag(frontendRoot, offline) {
+    if (offline)
+        return;
+    const mainPath = node_path_1.default.join(frontendRoot, 'src', 'main.ts');
+    if (node_fs_1.default.existsSync(mainPath)) {
+        let source = node_fs_1.default.readFileSync(mainPath, 'utf8');
+        source = source.replace(/import \{ bootCana, exposeCanaTestHooks \} from '@\/data\/db';\n/, '');
+        source = source.replace(/import \{ registerSW \} from '@\/data\/pwa';\n/, '');
+        source = source.replace(/import \{ bindOnlineReplay \} from '@\/data\/sync';\n/, '');
+        source = source.replace(/const boot = await bootCana\(\);\nexposeCanaTestHooks\(\);\nif \(boot === 'ok'\) \{\n {2}bindOnlineReplay\(\);\n {2}registerSW\(\);\n\}\napp\.provide\('canaBoot', boot\);\n/, 'const boot = \'unavailable\' as const;\napp.provide(\'canaBoot\', boot);\n');
+        node_fs_1.default.writeFileSync(mainPath, source, 'utf8');
+    }
+    const cypressE2e = node_path_1.default.join(frontendRoot, 'cypress', 'e2e');
+    if (node_fs_1.default.existsSync(cypressE2e)) {
+        for (const entry of node_fs_1.default.readdirSync(cypressE2e)) {
+            if (entry.startsWith('offline-') && entry.endsWith('.cy.ts')) {
+                node_fs_1.default.rmSync(node_path_1.default.join(cypressE2e, entry), { force: true });
+            }
+        }
+    }
+}
+exports.applyOfflineFlag = applyOfflineFlag;
+/**
+ * Generate `apps/frontend` from the packaged seed + GenerationPlan.
+ */
+async function generateFrontend(options) {
+    const { plan, outputDir, projectName, appFolder = 'frontend', log = () => undefined } = options;
+    if (!plan.frontend && plan.mode !== 'hybrid' && plan.mode !== 'frontend') {
+        throw new Error('Frontend generation failed: GenerationPlan has no frontend section '
+            + '(pass --frontend or --mode=hybrid|frontend).');
+    }
+    const packageRoot = node_path_1.default.resolve(__dirname, '..', '..');
+    const templateRoot = options.templateRoot || (0, paths_1.resolveFrontendTemplateRoot)(packageRoot);
+    const pin = (0, jumentixVersions_1.resolveJumentixPin)(packageRoot, options.jumentixVersion);
+    const scope = (0, paths_1.sanitizePackageScope)(projectName);
+    const offline = Boolean(plan.frontend?.offline);
+    const frontendRoot = node_path_1.default.join(outputDir, 'apps', appFolder);
+    if (node_fs_1.default.existsSync(frontendRoot)) {
+        node_fs_1.default.rmSync(frontendRoot, { recursive: true, force: true });
+    }
+    log(`Generating frontend → apps/${appFolder} (offline=${offline ? 'yes' : 'no'})`);
+    copyFrontendTemplate(templateRoot, frontendRoot);
+    const packageName = writeFrontendPackageJson(frontendRoot, scope, pin);
+    const { bakedPaths } = bakeMergedOas(frontendRoot, plan);
+    const oas = readBundledOas(frontendRoot);
+    const modules = [];
+    for (const domain of plan.domains) {
+        modules.push((0, frontendModules_1.writeDomainModule)(frontendRoot, domain, oas));
+    }
+    (0, frontendModules_1.writeModulesIndex)(frontendRoot, modules);
+    (0, frontendModules_1.patchI18nTitles)(frontendRoot, modules);
+    (0, frontendModules_1.patchRouterHome)(frontendRoot, modules[0]?.moduleId);
+    const envPath = writeFrontendEnv(frontendRoot, plan, offline);
+    applyOfflineFlag(frontendRoot, offline);
+    log(`Frontend generation wrote ${modules.length} module(s), `
+        + `${bakedPaths} OAS path(s) baked.`);
+    return {
+        root: frontendRoot,
+        packageName,
+        modules,
+        offline,
+        bakedPaths,
+        envPath
+    };
+}
+exports.generateFrontend = generateFrontend;
+//# sourceMappingURL=frontend.js.map

package/dist/generators/frontend.js.map

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

package/dist/generators/frontendModules.d.ts

@@ -0,0 +1,53 @@
+import type { PlanDomain } from '../sources/types';
+import { type LocalizedTitle } from './frontendOas';
+type JsonObject = Record<string, unknown>;
+/** Kebab/camel-safe module or entity folder slug. */
+export declare function slugifyIdentifier(raw: string, fallback?: string): string;
+/** camelCase identifier from entity name (User → user, Organization → organization). */
+export declare function camelCaseName(raw: string): string;
+/** PascalCase for view/component names. */
+export declare function pascalCaseName(raw: string): string;
+export type GeneratedEntityConfig = {
+    entityId: string;
+    entityName: string;
+    featureDir: string;
+    configExport: string;
+    configFile: string;
+    viewFile: string;
+    viewExport: string;
+    title: LocalizedTitle;
+    operations: {
+        list: string;
+        create: string;
+        update: string;
+        delete: string;
+    };
+    searchFields: string[];
+    schemas: {
+        create: string;
+        update: string;
+    };
+};
+export type GeneratedModuleResult = {
+    moduleId: string;
+    moduleFile: string;
+    title: LocalizedTitle;
+    icon: string;
+    entities: GeneratedEntityConfig[];
+};
+/**
+ * Write one frontend module (entity configs, views, dashboard widgets, manifest)
+ * under the generated frontend root.
+ */
+export declare function writeDomainModule(frontendRoot: string, domain: PlanDomain, oas: JsonObject): GeneratedModuleResult;
+/** Rewrite `src/modules/index.ts` to register generated modules. */
+export declare function writeModulesIndex(frontendRoot: string, modules: GeneratedModuleResult[]): void;
+/**
+ * Append `module.*` / `nav.*` titles into i18n messages for generated modules.
+ */
+export declare function patchI18nTitles(frontendRoot: string, modules: GeneratedModuleResult[]): void;
+/**
+ * Point the default home redirect at the first generated module.
+ */
+export declare function patchRouterHome(frontendRoot: string, firstModuleId: string | undefined): void;
+export {};