@xanahlight/component-forge 0.1.0 → 1.4.0

package/dist/commands/explain/topics.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOPICS = void 0;
+const format_1 = require("../../shared/format");
+exports.TOPICS = {
+    fsd: renderFsd,
+    modular: renderModular,
+    layers: renderLayers,
+    all: renderAll,
+};
+// ---------------------------------------------------------------------------
+// FSD
+// ---------------------------------------------------------------------------
+function renderFsd() {
+    return [
+        format_1.fmt.h1('Feature-Sliced Design (FSD)'),
+        format_1.fmt.rule(),
+        format_1.fmt.line(''),
+        format_1.fmt.line('FSD is an architectural methodology for frontend applications that organises'),
+        format_1.fmt.line('code by ' + format_1.fmt.dim('business features') + ' instead of technical roles.'),
+        format_1.fmt.line(''),
+        format_1.fmt.h2('Layer hierarchy  (low → high)'),
+        format_1.fmt.line(''),
+        format_1.fmt.line(`  ${format_1.fmt.tag('shared')}   ${format_1.fmt.dim('Reusable UI, utilities, constants — no business logic')}`),
+        format_1.fmt.line(`  ${format_1.fmt.tag('entities')} ${format_1.fmt.dim('Business entities: User, Order, Product')}`),
+        format_1.fmt.line(`  ${format_1.fmt.tag('features')} ${format_1.fmt.dim('User actions: auth, search, payment')}`),
+        format_1.fmt.line(`  ${format_1.fmt.tag('widgets')}  ${format_1.fmt.dim('Composite blocks assembled from entities + features')}`),
+        format_1.fmt.line(`  ${format_1.fmt.tag('pages')}    ${format_1.fmt.dim('Full application screens')}`),
+        format_1.fmt.line(`  ${format_1.fmt.tag('app')}      ${format_1.fmt.dim('App-wide: router, providers, global styles')}`),
+        format_1.fmt.line(''),
+        format_1.fmt.h2('Import rules'),
+        format_1.fmt.line(''),
+        format_1.fmt.arrow('features', 'entities', true),
+        format_1.fmt.arrow('features', 'shared', true),
+        format_1.fmt.arrow('features', 'features', false),
+        format_1.fmt.arrow('entities', 'features', false),
+        format_1.fmt.arrow('shared', 'entities', false),
+        format_1.fmt.line(''),
+        format_1.fmt.line(format_1.fmt.dim('  A layer may only import from layers below it.')),
+        format_1.fmt.line(''),
+        format_1.fmt.h2('Public API rule'),
+        format_1.fmt.line(''),
+        format_1.fmt.line('  Each slice must expose its interface through a single index.ts:'),
+        format_1.fmt.line(''),
+        format_1.fmt.line(format_1.fmt.dim('    features/auth/index.ts  ← public API')),
+        format_1.fmt.line(format_1.fmt.dim('    features/auth/model.ts  ← private implementation')),
+        format_1.fmt.line(''),
+        format_1.fmt.ok('import { useAuth } from "@/features/auth"'),
+        format_1.fmt.no('import { authStore } from "@/features/auth/model"'),
+        format_1.fmt.line(''),
+        format_1.fmt.rule(),
+        format_1.fmt.line(''),
+        format_1.fmt.line('  component-forge init fsd   — scaffold FSD structure'),
+        format_1.fmt.line('  component-forge check       — validate FSD boundaries'),
+        format_1.fmt.line(''),
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Modular
+// ---------------------------------------------------------------------------
+function renderModular() {
+    return [
+        format_1.fmt.h1('Modular Architecture'),
+        format_1.fmt.rule(),
+        format_1.fmt.line(''),
+        format_1.fmt.line('Modular architecture organises code into self-contained modules'),
+        format_1.fmt.line('that encapsulate a business domain end-to-end.'),
+        format_1.fmt.line(''),
+        format_1.fmt.h2('Structure'),
+        format_1.fmt.line(''),
+        format_1.fmt.line(`  ${format_1.fmt.tag('core')}    ${format_1.fmt.dim('App-wide infra: routing, DI, config')}`),
+        format_1.fmt.line(`  ${format_1.fmt.tag('modules')} ${format_1.fmt.dim('Business domains: AuthModule, CartModule')}`),
+        format_1.fmt.line(`  ${format_1.fmt.tag('shared')}  ${format_1.fmt.dim('Design system, utilities, types')}`),
+        format_1.fmt.line(''),
+        format_1.fmt.h2('Import rules'),
+        format_1.fmt.line(''),
+        format_1.fmt.arrow('modules', 'modules', true),
+        format_1.fmt.arrow('modules', 'shared', true),
+        format_1.fmt.arrow('shared', 'modules', false),
+        format_1.fmt.arrow('core', 'modules', false),
+        format_1.fmt.line(''),
+        format_1.fmt.line(format_1.fmt.dim('  shared and core must not depend on modules — they are foundational.')),
+        format_1.fmt.line(''),
+        format_1.fmt.h2('When to choose Modular vs FSD'),
+        format_1.fmt.line(''),
+        format_1.fmt.line('  FSD     — large teams, complex domain, strict layer isolation'),
+        format_1.fmt.line('  Modular — medium apps, clear domain boundaries, less ceremony'),
+        format_1.fmt.line(''),
+        format_1.fmt.rule(),
+        format_1.fmt.line(''),
+        format_1.fmt.line('  component-forge init modular — scaffold modular structure'),
+        format_1.fmt.line('  component-forge check        — validate modular boundaries'),
+        format_1.fmt.line(''),
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Layers
+// ---------------------------------------------------------------------------
+const FSD_LAYERS = [
+    ['shared', 'Reusable: UI kit, utils, constants, types, API clients'],
+    ['entities', 'Business objects with their data model and UI: User, Product'],
+    ['features', 'User-facing use cases: LoginForm, AddToCart, SearchBar'],
+    ['widgets', 'Complex composites: Header, Sidebar, ProductCard'],
+    ['pages', 'Application routes/screens assembled from widgets'],
+    ['app', 'Bootstrap: router, global providers, themes'],
+];
+function getAllowedBelow(layer) {
+    const order = ['shared', 'entities', 'features', 'widgets', 'pages', 'app'];
+    const idx = order.indexOf(layer);
+    if (idx <= 0)
+        return idx === 0 ? 'none (bottom layer)' : 'unknown';
+    return order.slice(0, idx).join(', ');
+}
+function renderLayers() {
+    return [
+        format_1.fmt.h1('FSD Layer Reference'),
+        format_1.fmt.rule(),
+        format_1.fmt.line(''),
+        ...FSD_LAYERS.flatMap(([name, desc]) => [
+            `  ${format_1.fmt.dim(name)}`,
+            format_1.fmt.line(format_1.fmt.dim(`    ${desc}`)),
+            format_1.fmt.line(format_1.fmt.dim(`    Allowed imports: ${getAllowedBelow(name)}`)),
+            '',
+        ]),
+        format_1.fmt.rule(),
+        format_1.fmt.line(''),
+        format_1.fmt.line('  component-forge explain fsd — full FSD overview'),
+        format_1.fmt.line('  component-forge check       — detect boundary violations'),
+        format_1.fmt.line(''),
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// All
+// ---------------------------------------------------------------------------
+function renderAll() {
+    return [renderFsd(), renderModular(), renderLayers()].join('\n');
+}
+//# sourceMappingURL=topics.js.map

package/dist/commands/explain/topics.js.map

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

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

@@ -0,0 +1,6 @@
+import { SliceType } from '../../types/folder-tree';
+export { SliceType };
+export interface GenerateOptions {
+    dryRun?: boolean;
+}
+export declare function generateCommand(sliceType: SliceType, sliceName: string, options?: GenerateOptions): void;

package/dist/commands/generate/index.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCommand = generateCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const config_1 = require("../../utils/config");
+const logger_1 = require("../../utils/logger");
+const template_resolver_1 = require("../../utils/template-resolver");
+const placementByArchitecture = {
+    fsd: {
+        feature: 'features',
+        entity: 'entities',
+        widget: 'widgets',
+        page: 'pages',
+        component: 'shared/ui',
+    },
+    modular: {
+        module: 'modules',
+        component: 'shared/ui',
+    },
+};
+// ---------------------------------------------------------------------------
+// Slice descriptions — shown in dry-run and success messages
+// ---------------------------------------------------------------------------
+const sliceDescriptions = {
+    feature: 'full vertical slice — ui + model + api',
+    entity: 'data-layer slice    — model + api (no UI)',
+    widget: 'composite UI block  — ui + model (no api)',
+    page: 'route-level shell   — ui only',
+    component: 'pure UI atom        — flat component (no model/api)',
+    module: 'vertical module     — ui + model + api',
+};
+// ---------------------------------------------------------------------------
+// Path resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolves the absolute path for the slice being generated.
+ * Supports nested names like "forms/Input" → src/shared/ui/forms/Input
+ */
+function resolveSlicePath(config, sliceType, sliceName) {
+    const placement = placementByArchitecture[config.architecture][sliceType];
+    if (!placement) {
+        const available = Object.keys(placementByArchitecture[config.architecture]).join(', ');
+        logger_1.logger.error(`Slice type "${sliceType}" is not supported for ${config.architecture} architecture.`);
+        logger_1.logger.info(`Available types for ${config.architecture}: ${available}`);
+        process.exit(1);
+    }
+    return node_path_1.default.join(process.cwd(), config.srcDir, placement, sliceName);
+}
+// ---------------------------------------------------------------------------
+// File I/O
+// ---------------------------------------------------------------------------
+function writeFile(filePath, content) {
+    fs_extra_1.default.ensureDirSync(node_path_1.default.dirname(filePath));
+    fs_extra_1.default.writeFileSync(filePath, content);
+    logger_1.logger.success(`Created: ${node_path_1.default.relative(process.cwd(), filePath)}`);
+}
+function printDryRun(filePath) {
+    logger_1.logger.info(`Would create: ${node_path_1.default.relative(process.cwd(), filePath)}`);
+}
+function generateCommand(sliceType, sliceName, options = {}) {
+    const { dryRun = false } = options;
+    const config = (0, config_1.loadProjectConfig)();
+    const slicePath = resolveSlicePath(config, sliceType, sliceName);
+    if (!dryRun && fs_extra_1.default.existsSync(slicePath)) {
+        logger_1.logger.error(`Already exists: ${node_path_1.default.relative(process.cwd(), slicePath)}`);
+        process.exit(1);
+    }
+    // Resolve templates directory (absolute path) if configured
+    const templatesDir = config.templates
+        ? node_path_1.default.resolve(process.cwd(), config.templates)
+        : undefined;
+    // Derive the bare name for use in templates (e.g. "forms/Input" → "Input")
+    const sliceBaseName = node_path_1.default.basename(sliceName);
+    const files = (0, template_resolver_1.resolveSliceFiles)(sliceType, sliceBaseName, templatesDir);
+    if (dryRun) {
+        logger_1.logger.info(`Dry run — no files will be written.`);
+        logger_1.logger.info(`Type: ${sliceType}  (${sliceDescriptions[sliceType]})\n`);
+        printDryRun(slicePath + '/');
+        for (const relativePath of Object.keys(files)) {
+            printDryRun(node_path_1.default.join(slicePath, relativePath));
+        }
+        logger_1.logger.info(`\nDry run complete. Run without --dry-run to generate.`);
+        return;
+    }
+    // Create slice root
+    fs_extra_1.default.ensureDirSync(slicePath);
+    logger_1.logger.success(`Created: ${node_path_1.default.relative(process.cwd(), slicePath)}`);
+    // Write files from templates
+    for (const [relativePath, content] of Object.entries(files)) {
+        writeFile(node_path_1.default.join(slicePath, relativePath), content);
+    }
+    const source = templatesDir ? ' (custom templates)' : '';
+    logger_1.logger.info(`\nGenerated ${sliceType} "${sliceName}"${source}`);
+    logger_1.logger.info(`Structure: ${sliceDescriptions[sliceType]}`);
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,29 @@
+import type { Architecture, FolderTree } from '../../types/folder-tree';
+import { CONFIG_FILENAMES, loadProjectConfig } from '../../utils/config';
+export { CONFIG_FILENAMES };
+export { loadProjectConfig };
+/**
+ * Recursively creates folder structure from a FolderTree definition.
+ * Returns the list of created paths (relative to cwd) for summary output.
+ */
+export declare function createStructure(tree: FolderTree, basePath: string, cwd: string): string[];
+export interface InitAnswers {
+    architecture: Architecture;
+    srcDir: string;
+}
+/**
+ * Runs interactive prompts to collect init parameters.
+ * Throws if the user cancels (Ctrl+C) — caller handles the exit.
+ */
+export declare function promptInitAnswers(): Promise<InitAnswers>;
+/**
+ * Performs the actual init: creates folder structure + writes config.
+ * Exported so it can be called directly (non-interactive) or from tests.
+ */
+export declare function runInit(architecture: Architecture, srcDir: string, projectRoot: string): void;
+/**
+ * Called from index.ts.
+ * If architecture is provided — runs non-interactively (backwards-compatible).
+ * If omitted — runs interactive prompts.
+ */
+export declare function initCommand(architecture?: Architecture): void;

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/migrate.test.d.ts

@@ -0,0 +1 @@
+export {};