@xanahlight/component-forge 0.1.0 → 1.5.0

package/dist/commands/init/index.js

@@ -0,0 +1,157 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadProjectConfig = exports.CONFIG_FILENAMES = void 0;
+exports.createStructure = createStructure;
+exports.promptInitAnswers = promptInitAnswers;
+exports.runInit = runInit;
+exports.initCommand = initCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const prompts_1 = require("@inquirer/prompts");
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const fsd_1 = require("../../templates/fsd");
+const modular_1 = require("../../templates/modular");
+const config_1 = require("../../utils/config");
+Object.defineProperty(exports, "CONFIG_FILENAMES", { enumerable: true, get: function () { return config_1.CONFIG_FILENAMES; } });
+Object.defineProperty(exports, "loadProjectConfig", { enumerable: true, get: function () { return config_1.loadProjectConfig; } });
+const logger_1 = require("../../utils/logger");
+// ---------------------------------------------------------------------------
+// Template registry
+// ---------------------------------------------------------------------------
+const templates = {
+    fsd: fsd_1.fsdTemplate,
+    modular: modular_1.modularTemplate,
+};
+// ---------------------------------------------------------------------------
+// Architecture descriptions shown in the interactive selector
+// ---------------------------------------------------------------------------
+const ARCHITECTURE_DESCRIPTIONS = {
+    fsd: 'Feature-Sliced Design — layer-based architecture for large apps',
+    modular: 'Modular — module-centric architecture for medium-sized apps',
+};
+// ---------------------------------------------------------------------------
+// Folder structure creation
+// ---------------------------------------------------------------------------
+/**
+ * Recursively creates folder structure from a FolderTree definition.
+ * Returns the list of created paths (relative to cwd) for summary output.
+ */
+function createStructure(tree, basePath, cwd) {
+    const created = [];
+    for (const [folderName, children] of Object.entries(tree)) {
+        const folderPath = node_path_1.default.join(basePath, folderName);
+        fs_extra_1.default.ensureDirSync(folderPath);
+        created.push(node_path_1.default.relative(cwd, folderPath));
+        created.push(...createStructure(children, folderPath, cwd));
+    }
+    return created;
+}
+/**
+ * Runs interactive prompts to collect init parameters.
+ * Throws if the user cancels (Ctrl+C) — caller handles the exit.
+ */
+async function promptInitAnswers() {
+    console.log(chalk_1.default.bold('\n  component-forge — project initialisation\n'));
+    const architecture = await (0, prompts_1.select)({
+        message: 'Choose your architecture:',
+        choices: [
+            {
+                name: `${chalk_1.default.cyan('FSD')}  ${chalk_1.default.gray(ARCHITECTURE_DESCRIPTIONS.fsd)}`,
+                value: 'fsd',
+                short: 'FSD',
+            },
+            {
+                name: `${chalk_1.default.cyan('Modular')}  ${chalk_1.default.gray(ARCHITECTURE_DESCRIPTIONS.modular)}`,
+                value: 'modular',
+                short: 'Modular',
+            },
+        ],
+    });
+    const srcDir = await (0, prompts_1.input)({
+        message: 'Source directory:',
+        default: 'src',
+        validate: (value) => {
+            const trimmed = value.trim();
+            if (!trimmed)
+                return 'Source directory cannot be empty';
+            if (/[<>:"|?*]/.test(trimmed))
+                return 'Directory name contains invalid characters';
+            return true;
+        },
+        transformer: (value) => chalk_1.default.cyan(value),
+    });
+    const confirmed = await (0, prompts_1.confirm)({
+        message: `Initialise ${chalk_1.default.bold(architecture.toUpperCase())} in ${chalk_1.default.bold(`./${srcDir.trim()}`)}?`,
+        default: true,
+    });
+    if (!confirmed) {
+        logger_1.logger.info('Aborted.');
+        process.exit(0);
+    }
+    return { architecture, srcDir: srcDir.trim() };
+}
+// ---------------------------------------------------------------------------
+// Core init logic — pure, no side-effects on I/O apart from FS writes
+// ---------------------------------------------------------------------------
+/**
+ * Performs the actual init: creates folder structure + writes config.
+ * Exported so it can be called directly (non-interactive) or from tests.
+ */
+function runInit(architecture, srcDir, projectRoot) {
+    const configPath = node_path_1.default.join(projectRoot, config_1.CONFIG_FILENAMES.json);
+    if (fs_extra_1.default.existsSync(configPath)) {
+        logger_1.logger.error(`Project already initialised (${config_1.CONFIG_FILENAMES.json} exists).`);
+        logger_1.logger.info('Remove it or delete forge.config.ts if you want to reinitialise.');
+        process.exit(1);
+    }
+    logger_1.logger.info(`\nInitialising ${chalk_1.default.bold(architecture.toUpperCase())} architecture in ${chalk_1.default.cyan(`./${srcDir}`)}…\n`);
+    const template = templates[architecture];
+    // Resolve the base path for structure (respects custom srcDir)
+    const basePath = node_path_1.default.join(projectRoot, srcDir);
+    const created = createStructure(template, basePath, projectRoot);
+    for (const p of created) {
+        logger_1.logger.success(`Created: ${p}`);
+    }
+    const config = { architecture, srcDir };
+    (0, config_1.writeProjectConfig)(config, projectRoot);
+    logger_1.logger.success(`\nCreated: ${config_1.CONFIG_FILENAMES.json}`);
+    logger_1.logger.info(`Tip: rename to forge.config.ts for TypeScript support and IntelliSense.`);
+    console.log(chalk_1.default.bold(`\n  ✓ ${architecture.toUpperCase()} project initialised successfully!\n`));
+    console.log(chalk_1.default.gray(`  Next steps:\n`) +
+        chalk_1.default.white(`    component-forge generate feature <name>\n`) +
+        chalk_1.default.white(`    component-forge validate\n`) +
+        chalk_1.default.white(`    component-forge check\n`));
+}
+// ---------------------------------------------------------------------------
+// Command entry point
+// ---------------------------------------------------------------------------
+/**
+ * Called from index.ts.
+ * If architecture is provided — runs non-interactively (backwards-compatible).
+ * If omitted — runs interactive prompts.
+ */
+function initCommand(architecture) {
+    if (architecture) {
+        // Non-interactive path — keep full backwards compatibility
+        runInit(architecture, 'src', process.cwd());
+        return;
+    }
+    // Interactive path
+    promptInitAnswers()
+        .then(({ architecture: arch, srcDir }) => {
+        runInit(arch, srcDir, process.cwd());
+    })
+        .catch((err) => {
+        // ExitPromptError is thrown when user presses Ctrl+C
+        const isCancel = err instanceof Error && err.name === 'ExitPromptError';
+        if (isCancel) {
+            console.log(chalk_1.default.yellow('\n  Cancelled.\n'));
+            process.exit(0);
+        }
+        throw err;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/init/index.js.map

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

package/dist/commands/migrate/classifier.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Heuristic rules for classifying existing directory names
+ * into their FSD / modular equivalents.
+ *
+ * Patterns are evaluated in order — first match wins.
+ * This file owns all classification knowledge; plan-builder.ts is pure logic.
+ */
+export interface LayerHeuristic {
+    pattern: RegExp;
+    layer: string;
+    /** Optional sub-directory inside the layer, e.g. "ui" → shared/ui */
+    subdir?: string;
+}
+export declare const FSD_HEURISTICS: LayerHeuristic[];
+/**
+ * Returns the FSD destination for a given directory name,
+ * or `null` if no heuristic matches.
+ */
+export declare function classifyDir(dirName: string): {
+    layer: string;
+    subdir?: string;
+} | null;

package/dist/commands/migrate/classifier.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Heuristic rules for classifying existing directory names
+ * into their FSD / modular equivalents.
+ *
+ * Patterns are evaluated in order — first match wins.
+ * This file owns all classification knowledge; plan-builder.ts is pure logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FSD_HEURISTICS = void 0;
+exports.classifyDir = classifyDir;
+exports.FSD_HEURISTICS = [
+    // ── App / bootstrap ─────────────────────────────────────────────────────
+    { pattern: /^(app|bootstrap|main|root|providers?|router|store)$/i, layer: 'app' },
+    // ── Pages / routes ──────────────────────────────────────────────────────
+    { pattern: /^(pages?|routes?|screens?|views?)$/i, layer: 'pages' },
+    // ── Widgets (composite blocks) ──────────────────────────────────────────
+    { pattern: /^(widgets?|layouts?|containers?|blocks?)$/i, layer: 'widgets' },
+    // ── Features (user actions) ─────────────────────────────────────────────
+    { pattern: /^(features?|use-?cases?|actions?|mutations?)$/i, layer: 'features' },
+    // ── Entities (domain models) ────────────────────────────────────────────
+    { pattern: /^(entities|models?|domain|types?|interfaces?)$/i, layer: 'entities' },
+    // ── Shared UI ───────────────────────────────────────────────────────────
+    { pattern: /^(ui|components?|elements?|atoms?|molecules?)$/i, layer: 'shared', subdir: 'ui' },
+    // ── Shared utilities ────────────────────────────────────────────────────
+    { pattern: /^(utils?|helpers?|lib|libs?|common|shared)$/i, layer: 'shared' },
+    // ── Shared API ──────────────────────────────────────────────────────────
+    { pattern: /^(api|services?|http|clients?|fetchers?)$/i, layer: 'shared', subdir: 'api' },
+    // ── Shared hooks ────────────────────────────────────────────────────────
+    { pattern: /^(hooks?)$/i, layer: 'shared', subdir: 'hooks' },
+    // ── Shared config ───────────────────────────────────────────────────────
+    { pattern: /^(constants?|config|configs?|settings?)$/i, layer: 'shared', subdir: 'config' },
+    // ── Assets (shared but no rename needed) ────────────────────────────────
+    { pattern: /^(assets?|images?|icons?|fonts?|static)$/i, layer: 'shared', subdir: 'assets' },
+];
+/**
+ * Returns the FSD destination for a given directory name,
+ * or `null` if no heuristic matches.
+ */
+function classifyDir(dirName) {
+    for (const h of exports.FSD_HEURISTICS) {
+        if (h.pattern.test(dirName)) {
+            return { layer: h.layer, subdir: h.subdir };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=classifier.js.map

package/dist/commands/migrate/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../../src/commands/migrate/classifier.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAgDH,kCASC;AAhDY,QAAA,cAAc,GAAqB;IAC9C,2EAA2E;IAC3E,EAAE,OAAO,EAAE,sDAAsD,EAAE,KAAK,EAAE,KAAK,EAAE;IAEjF,2EAA2E;IAC3E,EAAE,OAAO,EAAE,qCAAqC,EAAE,KAAK,EAAE,OAAO,EAAE;IAElE,2EAA2E;IAC3E,EAAE,OAAO,EAAE,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE;IAE3E,2EAA2E;IAC3E,EAAE,OAAO,EAAE,gDAAgD,EAAE,KAAK,EAAE,UAAU,EAAE;IAEhF,2EAA2E;IAC3E,EAAE,OAAO,EAAE,iDAAiD,EAAE,KAAK,EAAE,UAAU,EAAE;IAEjF,2EAA2E;IAC3E,EAAE,OAAO,EAAE,iDAAiD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAE7F,2EAA2E;IAC3E,EAAE,OAAO,EAAE,8CAA8C,EAAE,KAAK,EAAE,QAAQ,EAAE;IAE5E,2EAA2E;IAC3E,EAAE,OAAO,EAAE,4CAA4C,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;IAEzF,2EAA2E;IAC3E,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IAE5D,2EAA2E;IAC3E,EAAE,OAAO,EAAE,2CAA2C,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IAE3F,2EAA2E;IAC3E,EAAE,OAAO,EAAE,2CAA2C,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;CAC5F,CAAA;AAED;;;GAGG;AACH,SAAgB,WAAW,CACzB,OAAe;IAEf,KAAK,MAAM,CAAC,IAAI,sBAAc,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/commands/migrate/index.d.ts

@@ -0,0 +1,8 @@
+import type { Architecture } from '../../types/folder-tree';
+export { buildMigrationPlan, scanTopLevelDirs } from './plan-builder';
+export { classifyDir } from './classifier';
+export type { FileMoveProposal, MigrationPlan } from './plan-builder';
+/**
+ * CLI entry point for the migrate command.
+ */
+export declare function migrateCommand(targetArchitecture: Architecture): void;

package/dist/commands/migrate/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyDir = exports.scanTopLevelDirs = exports.buildMigrationPlan = void 0;
+exports.migrateCommand = migrateCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../../utils/config");
+const logger_1 = require("../../utils/logger");
+const plan_builder_1 = require("./plan-builder");
+const printer_1 = require("./printer");
+var plan_builder_2 = require("./plan-builder");
+Object.defineProperty(exports, "buildMigrationPlan", { enumerable: true, get: function () { return plan_builder_2.buildMigrationPlan; } });
+Object.defineProperty(exports, "scanTopLevelDirs", { enumerable: true, get: function () { return plan_builder_2.scanTopLevelDirs; } });
+var classifier_1 = require("./classifier");
+Object.defineProperty(exports, "classifyDir", { enumerable: true, get: function () { return classifier_1.classifyDir; } });
+/**
+ * CLI entry point for the migrate command.
+ */
+function migrateCommand(targetArchitecture) {
+    const config = (0, config_1.loadProjectConfig)();
+    if (config.architecture === targetArchitecture) {
+        logger_1.logger.info(`Project is already configured as ${chalk_1.default.bold(targetArchitecture.toUpperCase())}.`);
+        logger_1.logger.info(`Run ${chalk_1.default.cyan('component-forge validate')} to check the current structure.`);
+        return;
+    }
+    const srcPath = node_path_1.default.join(process.cwd(), config.srcDir);
+    const plan = (0, plan_builder_1.buildMigrationPlan)(srcPath, targetArchitecture);
+    (0, printer_1.printMigrationPlan)(plan);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/migrate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/migrate/index.ts"],"names":[],"mappings":";;;;;;AAkBA,wCAgBC;AAlCD,0DAA4B;AAE5B,kDAAyB;AAGzB,+CAAsD;AACtD,+CAA2C;AAE3C,iDAAmD;AACnD,uCAA8C;AAE9C,+CAAqE;AAA5D,kHAAA,kBAAkB,OAAA;AAAE,gHAAA,gBAAgB,OAAA;AAC7C,2CAA0C;AAAjC,yGAAA,WAAW,OAAA;AAGpB;;GAEG;AACH,SAAgB,cAAc,CAAC,kBAAgC;IAC7D,MAAM,MAAM,GAAG,IAAA,0BAAiB,GAAE,CAAA;IAElC,IAAI,MAAM,CAAC,YAAY,KAAK,kBAAkB,EAAE,CAAC;QAC/C,eAAM,CAAC,IAAI,CACT,oCAAoC,eAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC,GAAG,CACpF,CAAA;QACD,eAAM,CAAC,IAAI,CACT,OAAO,eAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,kCAAkC,CAChF,CAAA;QACD,OAAM;IACR,CAAC;IAED,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACvD,MAAM,IAAI,GAAG,IAAA,iCAAkB,EAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;IAC5D,IAAA,4BAAkB,EAAC,IAAI,CAAC,CAAA;AAC1B,CAAC"}

package/dist/commands/migrate/plan-builder.d.ts

@@ -0,0 +1,27 @@
+import type { Architecture } from '../../types/folder-tree';
+export interface FileMoveProposal {
+    /** Current directory name relative to srcDir */
+    from: string;
+    /** Proposed path relative to srcDir */
+    to: string;
+    /** Human-readable reason for the move */
+    reason: string;
+}
+export interface MigrationPlan {
+    targetArchitecture: Architecture;
+    sourceDir: string;
+    proposals: FileMoveProposal[];
+    /** Directories that didn't match any known pattern — need manual review */
+    unknownFiles: string[];
+    summary: string;
+}
+/**
+ * Returns the names of top-level directories inside srcPath.
+ * Files at the root level are intentionally ignored.
+ */
+export declare function scanTopLevelDirs(srcPath: string): string[];
+/**
+ * Builds a migration plan by analysing top-level directories in srcPath.
+ * Pure function — no filesystem writes, safe to call at any time.
+ */
+export declare function buildMigrationPlan(srcPath: string, targetArch: Architecture): MigrationPlan;

package/dist/commands/migrate/plan-builder.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanTopLevelDirs = scanTopLevelDirs;
+exports.buildMigrationPlan = buildMigrationPlan;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const classifier_1 = require("./classifier");
+// ---------------------------------------------------------------------------
+// Directory scanner
+// ---------------------------------------------------------------------------
+/**
+ * Returns the names of top-level directories inside srcPath.
+ * Files at the root level are intentionally ignored.
+ */
+function scanTopLevelDirs(srcPath) {
+    if (!fs_extra_1.default.existsSync(srcPath))
+        return [];
+    return fs_extra_1.default
+        .readdirSync(srcPath, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+}
+// ---------------------------------------------------------------------------
+// Plan builder
+// ---------------------------------------------------------------------------
+const FSD_LAYERS = new Set([
+    'app', 'processes', 'pages', 'widgets', 'features', 'entities', 'shared',
+]);
+const MODULAR_BASE = new Set(['modules', 'shared', 'core']);
+function buildFsdProposals(dirs) {
+    const proposals = [];
+    const unknownFiles = [];
+    for (const dir of dirs) {
+        if (FSD_LAYERS.has(dir))
+            continue; // already correct
+        const classification = (0, classifier_1.classifyDir)(dir);
+        if (!classification) {
+            unknownFiles.push(dir);
+            continue;
+        }
+        const { layer, subdir } = classification;
+        const to = subdir ? node_path_1.default.join(layer, subdir, dir) : node_path_1.default.join(layer, dir);
+        proposals.push({
+            from: dir,
+            to,
+            reason: `"${dir}" maps to FSD layer "${layer}"${subdir ? `/${subdir}` : ''}`,
+        });
+    }
+    return { proposals, unknownFiles };
+}
+function buildModularProposals(dirs) {
+    const proposals = [];
+    for (const dir of dirs) {
+        if (MODULAR_BASE.has(dir))
+            continue;
+        const classification = (0, classifier_1.classifyDir)(dir);
+        const isSharedCandidate = classification?.layer === 'shared' &&
+            !['api', 'services'].includes(dir.toLowerCase());
+        if (isSharedCandidate) {
+            proposals.push({
+                from: dir,
+                to: node_path_1.default.join('shared', dir),
+                reason: `"${dir}" is a shared utility/UI — belongs under shared/`,
+            });
+        }
+        else {
+            proposals.push({
+                from: dir,
+                to: node_path_1.default.join('modules', dir),
+                reason: `"${dir}" is a feature domain — wrap as a module`,
+            });
+        }
+    }
+    return proposals;
+}
+function buildSummary(proposals, unknownFiles, target) {
+    if (proposals.length === 0 && unknownFiles.length === 0) {
+        return `No changes needed — project already looks like ${target.toUpperCase()}.`;
+    }
+    const moved = proposals.length;
+    const unknown = unknownFiles.length;
+    return (`${moved} director${moved === 1 ? 'y' : 'ies'} to move` +
+        (unknown > 0 ? `, ${unknown} unknown (manual review needed)` : '') +
+        '.');
+}
+/**
+ * Builds a migration plan by analysing top-level directories in srcPath.
+ * Pure function — no filesystem writes, safe to call at any time.
+ */
+function buildMigrationPlan(srcPath, targetArch) {
+    const dirs = scanTopLevelDirs(srcPath);
+    const { proposals, unknownFiles } = targetArch === 'fsd'
+        ? buildFsdProposals(dirs)
+        : { proposals: buildModularProposals(dirs), unknownFiles: [] };
+    return {
+        targetArchitecture: targetArch,
+        sourceDir: srcPath,
+        proposals,
+        unknownFiles,
+        summary: buildSummary(proposals, unknownFiles, targetArch),
+    };
+}
+//# sourceMappingURL=plan-builder.js.map

package/dist/commands/migrate/plan-builder.js.map

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

package/dist/commands/migrate/printer.d.ts

@@ -0,0 +1,6 @@
+import type { MigrationPlan } from './plan-builder';
+/**
+ * Renders a MigrationPlan as colour-coded CLI output.
+ * Pure function — receives the plan, writes to stdout.
+ */
+export declare function printMigrationPlan(plan: MigrationPlan): void;

package/dist/commands/migrate/printer.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printMigrationPlan = printMigrationPlan;
+const node_path_1 = __importDefault(require("node:path"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Renders a MigrationPlan as colour-coded CLI output.
+ * Pure function — receives the plan, writes to stdout.
+ */
+function printMigrationPlan(plan) {
+    const { proposals, unknownFiles, summary, targetArchitecture, sourceDir } = plan;
+    const rel = node_path_1.default.relative(process.cwd(), sourceDir) || '.';
+    console.log(chalk_1.default.bold(`\n  Migration plan → ${chalk_1.default.cyan(targetArchitecture.toUpperCase())}\n`));
+    console.log(chalk_1.default.gray(`  Analysed: ${rel}\n`));
+    console.log(chalk_1.default.gray(`  ${'─'.repeat(58)}`));
+    if (proposals.length === 0 && unknownFiles.length === 0) {
+        console.log(chalk_1.default.green(`\n  ✓ ${summary}\n`));
+        return;
+    }
+    if (proposals.length > 0) {
+        console.log(chalk_1.default.bold(`\n  Proposed moves (${proposals.length}):\n`));
+        for (const p of proposals) {
+            const fromFmt = chalk_1.default.yellow(p.from.padEnd(24));
+            const toFmt = chalk_1.default.green(p.to);
+            console.log(`    ${fromFmt} → ${toFmt}`);
+            console.log(chalk_1.default.gray(`      ↳ ${p.reason}`));
+        }
+    }
+    if (unknownFiles.length > 0) {
+        console.log(chalk_1.default.bold(`\n  Needs manual review (${unknownFiles.length}):\n`));
+        for (const f of unknownFiles) {
+            console.log(`    ${chalk_1.default.red('?')} ${chalk_1.default.white(f)}`);
+        }
+        console.log(chalk_1.default.gray("\n    These directories don't match known patterns."));
+        console.log(chalk_1.default.gray(`    Run ${chalk_1.default.white('component-forge explain fsd')} to understand the target structure.`));
+    }
+    console.log(chalk_1.default.gray(`\n  ${'─'.repeat(58)}`));
+    console.log(chalk_1.default.bold(`\n  Summary: ${summary}\n`));
+    console.log(chalk_1.default.yellow('  ⚠ This is a dry-run analysis — no files were moved.\n'));
+    console.log(chalk_1.default.gray("  To apply: move each directory manually or use your IDE's refactor tools.\n"));
+    console.log(chalk_1.default.gray(`  After moving, run ${chalk_1.default.white('component-forge validate')} and ${chalk_1.default.white('component-forge check')} to verify.\n`));
+}
+//# sourceMappingURL=printer.js.map

package/dist/commands/migrate/printer.js.map

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

package/dist/commands/validate/index.d.ts

@@ -0,0 +1,26 @@
+import type { Architecture } from '../../types/folder-tree';
+interface LayerRule {
+    /** Directories that MUST exist */
+    required: string[];
+    /** All allowed directories (required + optional) */
+    allowed: string[];
+}
+type Severity = 'error' | 'warning';
+export interface ValidationIssue {
+    severity: Severity;
+    message: string;
+}
+/**
+ * Checks that all required layers exist under srcDir
+ */
+export declare function checkRequiredLayers(srcPath: string, rule: LayerRule, srcDir: string): ValidationIssue[];
+/**
+ * Checks that no unknown (forbidden) directories exist directly under srcDir
+ */
+export declare function checkUnknownLayers(srcPath: string, rule: LayerRule, architecture: Architecture, srcDir: string): ValidationIssue[];
+/**
+ * Checks each slice for a public API index.ts file
+ */
+export declare function checkPublicApiFiles(srcPath: string, rule: LayerRule, srcDir: string): ValidationIssue[];
+export declare function validateCommand(): void;
+export {};

package/dist/commands/{validate.js → validate/index.js}

@@ -3,11 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkRequiredLayers = checkRequiredLayers;
+exports.checkUnknownLayers = checkUnknownLayers;
+exports.checkPublicApiFiles = checkPublicApiFiles;
 exports.validateCommand = validateCommand;
-const fs_extra_1 = __importDefault(require("fs-extra"));
 const node_path_1 = __importDefault(require("node:path"));
-const config_1 = require("../utils/config");
-const logger_1 = require("../utils/logger");
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const config_1 = require("../../utils/config");
+const logger_1 = require("../../utils/logger");
 const layerRulesByArchitecture = {
     fsd: {
         required: ['app', 'shared'],
@@ -19,7 +22,7 @@ const layerRulesByArchitecture = {
     },
 };
 // ---------------------------------------------------------------------------
-// Validation rules
+// Validation rules — exported for unit testing
 // ---------------------------------------------------------------------------
 /**
  * Checks that all required layers exist under srcDir
@@ -116,4 +119,4 @@ function validateCommand() {
         process.exit(1);
     }
 }
-//# sourceMappingURL=validate.js.map
+//# sourceMappingURL=index.js.map

package/dist/commands/validate/index.js.map

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