@xanahlight/component-forge 0.1.0 → 1.5.0

package/README.md

@@ -3,6 +3,7 @@
 🌐 English | [Русский](README.ru.md)
 
 [![npm version](https://img.shields.io/npm/v/@xanahlight/component-forge.svg)](https://www.npmjs.com/package/@xanahlight/component-forge)
+[![CI](https://github.com/vladislavprozorov/component-forge/actions/workflows/ci.yml/badge.svg)](https://github.com/vladislavprozorov/component-forge/actions/workflows/ci.yml)
 [![Node.js](https://img.shields.io/node/v/@xanahlight/component-forge.svg)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
@@ -236,6 +237,13 @@ npm run build
 node dist/index.js init fsd
 ```
 
+Run tests:
+
+```bash
+npm test
+npm run test:coverage
+```
+
 > Node.js 20+ required.
 
 ---

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

@@ -0,0 +1,30 @@
+import type { Architecture } from '../../types/folder-tree';
+/**
+ * Classifies a FSD violation into one of three kinds:
+ *   - "same-layer"   — both files live in the same FSD layer
+ *   - "higher-layer" — file imports from a layer that sits ABOVE it
+ *   - "modular"      — modular-arch forbidden dependency
+ */
+export type ViolationKind = 'fsd-same-layer' | 'fsd-higher-layer' | 'modular-forbidden';
+/**
+ * Returns a concise, actionable hint for a given violation.
+ * Exported for unit testing.
+ */
+export declare function buildHint(kind: ViolationKind, fromLayer: string, toLayer: string): string;
+export interface CheckViolation {
+    file: string;
+    importPath: string;
+    /** Human-readable description of what rule was broken. */
+    message: string;
+    /** Concrete suggestion on how to fix the violation. */
+    hint: string;
+}
+export interface CheckResult {
+    violations: CheckViolation[];
+    checkedFiles: number;
+}
+export declare function parseImports(source: string): string[];
+export declare function resolveLayer(relPath: string): string | null;
+export declare function collectSourceFiles(dir: string, base?: string): string[];
+export declare function runCheck(srcPath: string, architecture: Architecture): CheckResult;
+export declare function checkCommand(): void;

package/dist/commands/check/index.js

@@ -0,0 +1,255 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHint = buildHint;
+exports.parseImports = parseImports;
+exports.resolveLayer = resolveLayer;
+exports.collectSourceFiles = collectSourceFiles;
+exports.runCheck = runCheck;
+exports.checkCommand = checkCommand;
+const node_fs_1 = __importDefault(require("node:fs"));
+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");
+// ---------------------------------------------------------------------------
+// FSD layer hierarchy — higher index = higher layer
+// A layer may only import from layers with a LOWER index.
+// ---------------------------------------------------------------------------
+const FSD_LAYER_ORDER = [
+    'shared',
+    'entities',
+    'features',
+    'widgets',
+    'pages',
+    'processes',
+    'app',
+];
+// For modular architecture — no strict hierarchy between modules,
+// but modules must not import from app-level dirs and shared cannot
+// import from modules.
+const MODULAR_FORBIDDEN = {
+    shared: ['modules', 'core'],
+    core: ['modules'],
+};
+/**
+ * Per-pair advice table for FSD violations.
+ *
+ * Key format: "<fromLayer>-><toLayer>"
+ * Falls back to generic advice when a specific pair is not listed.
+ */
+const FSD_PAIR_HINTS = {
+    // Same-layer cross-imports
+    'features->features': 'Extract the shared logic into shared/ (e.g. shared/lib or shared/api) ' +
+        'or lift it into a widget that composes both features.',
+    'entities->entities': 'Move the shared data type or helper to shared/. ' +
+        'Entities must remain independent of each other.',
+    'widgets->widgets': 'Extract the common UI piece into shared/ui or compose them inside a page instead.',
+    'pages->pages': 'Pages should not depend on each other. ' +
+        'Move the shared UI to widgets/ or shared/ui.',
+    // Higher-layer imports (lower importing from higher)
+    'shared->entities': 'shared/ is the foundation — it must not know about entities. ' +
+        'Move the type/helper to shared/ itself, or invert the dependency.',
+    'shared->features': 'shared/ must not import from features/. ' +
+        'Extract only the primitive/generic part into shared/.',
+    'shared->widgets': 'shared/ must not import from widgets/. ' +
+        'The component should live in shared/ui or be passed as a prop.',
+    'shared->pages': 'shared/ must not import from pages/. ' +
+        'Anything shared across pages belongs in shared/ or widgets/.',
+    'entities->features': 'Entities must not depend on features. ' +
+        'If you need a callback/handler, pass it as a prop or use an event bus.',
+    'entities->widgets': 'Entities must not depend on widgets. ' +
+        'Lift the dependency inversion: pass the widget as a ReactNode prop.',
+    'entities->pages': 'Entities must not depend on pages. ' +
+        'Pages are composed at the top — entities should never reference them.',
+    'features->widgets': 'Features must not import from widgets. ' +
+        'A widget composes features, not the other way around.',
+    'features->pages': 'Features must not import from pages. ' +
+        'Consider moving the shared piece down to shared/ or entities/.',
+    'widgets->pages': 'Widgets must not import from pages. ' +
+        'Pages are the top-level composers — extract the shared part into widgets/ itself.',
+};
+/**
+ * Returns a concise, actionable hint for a given violation.
+ * Exported for unit testing.
+ */
+function buildHint(kind, fromLayer, toLayer) {
+    if (kind === 'modular-forbidden') {
+        if (fromLayer === 'shared') {
+            return ('shared/ is infrastructure — it must not import from modules/. ' +
+                'Move the dependency into the module itself or create a shared abstraction.');
+        }
+        if (fromLayer === 'core') {
+            return ('core/ sets up the application shell and must not depend on feature modules. ' +
+                'Use dependency injection or an event bus to decouple them.');
+        }
+        return (`"${fromLayer}" must not import from "${toLayer}" in modular architecture. ` +
+            'Consider inverting the dependency or extracting shared logic into shared/.');
+    }
+    const key = `${fromLayer}->${toLayer}`;
+    if (FSD_PAIR_HINTS[key])
+        return FSD_PAIR_HINTS[key];
+    // Generic fallback
+    if (kind === 'fsd-same-layer') {
+        return (`Two slices inside "${fromLayer}" must not import from each other. ` +
+            'Extract shared logic to shared/ or compose them in a higher layer.');
+    }
+    // fsd-higher-layer fallback
+    return (`"${fromLayer}" sits below "${toLayer}" in the FSD hierarchy and must not import from it. ` +
+        'Move the shared code down to a layer that both can depend on (e.g. shared/ or entities/).');
+}
+// ---------------------------------------------------------------------------
+// Import parsing — extracts all static import paths from a TS/TSX file
+// ---------------------------------------------------------------------------
+const IMPORT_RE = /^\s*(?:import|export)\s+(?:[^'"]*\s+from\s+)?['"]([^'"]+)['"]/gm;
+function parseImports(source) {
+    const imports = [];
+    let match;
+    const re = new RegExp(IMPORT_RE.source, IMPORT_RE.flags);
+    while ((match = re.exec(source)) !== null) {
+        imports.push(match[1]);
+    }
+    return imports;
+}
+// ---------------------------------------------------------------------------
+// Layer resolution — given a file path relative to srcDir, returns its layer
+// ---------------------------------------------------------------------------
+function resolveLayer(relPath) {
+    // relPath looks like "features/auth/index.ts" or "shared/ui/Button.ts"
+    const parts = relPath.split(node_path_1.default.sep);
+    return parts[0] ?? null;
+}
+// ---------------------------------------------------------------------------
+// FSD violation check
+// ---------------------------------------------------------------------------
+function checkFsdViolations(srcPath, relFilePath, imports) {
+    const violations = [];
+    const fileLayer = resolveLayer(relFilePath);
+    if (!fileLayer)
+        return violations;
+    const fileLayerIdx = FSD_LAYER_ORDER.indexOf(fileLayer);
+    if (fileLayerIdx === -1)
+        return violations; // unknown layer — skip
+    for (const imp of imports) {
+        // Only check relative imports that could cross layer boundaries
+        // e.g. "../../features/auth" — resolve to get the target layer
+        if (!imp.startsWith('.'))
+            continue;
+        const fileDir = node_path_1.default.dirname(node_path_1.default.join(srcPath, relFilePath));
+        const resolved = node_path_1.default.resolve(fileDir, imp);
+        const relResolved = node_path_1.default.relative(srcPath, resolved);
+        const targetLayer = resolveLayer(relResolved);
+        if (!targetLayer)
+            continue;
+        const targetLayerIdx = FSD_LAYER_ORDER.indexOf(targetLayer);
+        if (targetLayerIdx === -1)
+            continue; // unknown target layer
+        // Violation: importing from the same layer OR a higher layer
+        if (targetLayerIdx >= fileLayerIdx) {
+            const kind = targetLayerIdx === fileLayerIdx ? 'fsd-same-layer' : 'fsd-higher-layer';
+            violations.push({
+                file: relFilePath,
+                importPath: imp,
+                message: `Layer "${fileLayer}" must not import from "${targetLayer}" ` +
+                    `(${targetLayer} is at the same level or higher in FSD hierarchy)`,
+                hint: buildHint(kind, fileLayer, targetLayer),
+            });
+        }
+    }
+    return violations;
+}
+// ---------------------------------------------------------------------------
+// Modular violation check
+// ---------------------------------------------------------------------------
+function checkModularViolations(srcPath, relFilePath, imports) {
+    const violations = [];
+    const fileLayer = resolveLayer(relFilePath);
+    if (!fileLayer)
+        return violations;
+    const forbidden = MODULAR_FORBIDDEN[fileLayer];
+    if (!forbidden)
+        return violations;
+    for (const imp of imports) {
+        if (!imp.startsWith('.'))
+            continue;
+        const fileDir = node_path_1.default.dirname(node_path_1.default.join(srcPath, relFilePath));
+        const resolved = node_path_1.default.resolve(fileDir, imp);
+        const relResolved = node_path_1.default.relative(srcPath, resolved);
+        const targetLayer = resolveLayer(relResolved);
+        if (!targetLayer)
+            continue;
+        if (forbidden.includes(targetLayer)) {
+            violations.push({
+                file: relFilePath,
+                importPath: imp,
+                message: `Layer "${fileLayer}" must not import from "${targetLayer}" in modular architecture`,
+                hint: buildHint('modular-forbidden', fileLayer, targetLayer),
+            });
+        }
+    }
+    return violations;
+}
+// ---------------------------------------------------------------------------
+// File collector — recursively finds .ts / .tsx files under srcPath
+// ---------------------------------------------------------------------------
+function collectSourceFiles(dir, base = dir) {
+    const results = [];
+    if (!node_fs_1.default.existsSync(dir))
+        return results;
+    for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        const full = node_path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...collectSourceFiles(full, base));
+        }
+        else if (/\.(ts|tsx)$/.test(entry.name) && !entry.name.endsWith('.test.ts')) {
+            results.push(node_path_1.default.relative(base, full));
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Core check logic — exported for testing
+// ---------------------------------------------------------------------------
+function runCheck(srcPath, architecture) {
+    const files = collectSourceFiles(srcPath);
+    const violations = [];
+    for (const relFile of files) {
+        const fullPath = node_path_1.default.join(srcPath, relFile);
+        const source = node_fs_1.default.readFileSync(fullPath, 'utf8');
+        const imports = parseImports(source);
+        if (architecture === 'fsd') {
+            violations.push(...checkFsdViolations(srcPath, relFile, imports));
+        }
+        else {
+            violations.push(...checkModularViolations(srcPath, relFile, imports));
+        }
+    }
+    return { violations, checkedFiles: files.length };
+}
+// ---------------------------------------------------------------------------
+// Command entry point
+// ---------------------------------------------------------------------------
+function checkCommand() {
+    const config = (0, config_1.loadProjectConfig)();
+    const srcPath = node_path_1.default.join(process.cwd(), config.srcDir);
+    logger_1.logger.info(`Checking architecture boundaries (${config.architecture})…\n`);
+    const { violations, checkedFiles } = runCheck(srcPath, config.architecture);
+    if (violations.length === 0) {
+        logger_1.logger.success(`✓ No violations found in ${checkedFiles} file(s). Architecture looks clean!`);
+        return;
+    }
+    console.log(chalk_1.default.red(`✖ Found ${violations.length} violation(s) in ${checkedFiles} file(s):\n`));
+    for (const v of violations) {
+        console.log(chalk_1.default.bold(chalk_1.default.white(`  ${v.file}`)));
+        console.log(chalk_1.default.gray(`    import "${v.importPath}"`));
+        console.log(chalk_1.default.red(`    ✗ ${v.message}`));
+        console.log(chalk_1.default.yellow(`    → Fix: ${v.hint}\n`));
+    }
+    if (config.architecture === 'fsd') {
+        console.log(chalk_1.default.gray('  FSD order (low → high): shared → entities → features → widgets → pages → app\n'));
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { TOPICS } from './topics';
+export { TOPICS };
+export declare const AVAILABLE_TOPICS: readonly string[];
+/**
+ * Renders the requested topic to a string.
+ * Pure function — no stdout side-effects — making it fully testable.
+ */
+export declare function renderTopic(topic: string): string;
+/**
+ * CLI entry point — writes the rendered topic to stdout.
+ */
+export declare function explainCommand(topic: string): void;

package/dist/commands/explain/index.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AVAILABLE_TOPICS = exports.TOPICS = void 0;
+exports.renderTopic = renderTopic;
+exports.explainCommand = explainCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const format_1 = require("../../shared/format");
+const topics_1 = require("./topics");
+Object.defineProperty(exports, "TOPICS", { enumerable: true, get: function () { return topics_1.TOPICS; } });
+exports.AVAILABLE_TOPICS = Object.keys(topics_1.TOPICS);
+/**
+ * Renders the requested topic to a string.
+ * Pure function — no stdout side-effects — making it fully testable.
+ */
+function renderTopic(topic) {
+    const renderer = topics_1.TOPICS[topic.toLowerCase()];
+    if (!renderer) {
+        return [
+            chalk_1.default.red(`\n  Unknown topic: "${topic}"\n`),
+            format_1.fmt.line(`  Available topics: ${chalk_1.default.cyan(exports.AVAILABLE_TOPICS.join(', '))}`),
+            format_1.fmt.line(''),
+            format_1.fmt.line(`  Example: component-forge explain fsd`),
+            format_1.fmt.line(''),
+        ].join('\n');
+    }
+    return renderer();
+}
+/**
+ * CLI entry point — writes the rendered topic to stdout.
+ */
+function explainCommand(topic) {
+    process.stdout.write(renderTopic(topic));
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/explain/index.ts"],"names":[],"mappings":";;;;;;AAaA,kCAcC;AAKD,wCAEC;AAlCD,kDAAyB;AAEzB,gDAAyC;AAEzC,qCAAiC;AAExB,uFAFA,eAAM,OAEA;AACF,QAAA,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAM,CAAsB,CAAA;AAExE;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAa;IACvC,MAAM,QAAQ,GAAG,eAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IAE5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,eAAK,CAAC,GAAG,CAAC,uBAAuB,KAAK,KAAK,CAAC;YAC5C,YAAG,CAAC,IAAI,CAAC,uBAAuB,eAAK,CAAC,IAAI,CAAC,wBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1E,YAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACZ,YAAG,CAAC,IAAI,CAAC,wCAAwC,CAAC;YAClD,YAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;IAED,OAAO,QAAQ,EAAE,CAAA;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAa;IAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;AAC1C,CAAC"}

package/dist/commands/explain/topics.d.ts

@@ -0,0 +1,3 @@
+type TopicRenderer = () => string;
+export declare const TOPICS: Record<string, TopicRenderer>;
+export {};

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.d.ts → generate/index.d.ts}

@@ -1,4 +1,4 @@
-import { SliceType } from '../types/folder-tree';
+import { SliceType } from '../../types/folder-tree';
 export { SliceType };
 export interface GenerateOptions {
     dryRun?: boolean;

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

@@ -4,11 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateCommand = generateCommand;
-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 template_resolver_1 = require("../utils/template-resolver");
+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',
@@ -23,6 +23,17 @@ const placementByArchitecture = {
     },
 };
 // ---------------------------------------------------------------------------
+// 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
 // ---------------------------------------------------------------------------
 /**
@@ -66,7 +77,8 @@ function generateCommand(sliceType, sliceName, options = {}) {
     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.\n`);
+        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));
@@ -81,11 +93,8 @@ function generateCommand(sliceType, sliceName, options = {}) {
     for (const [relativePath, content] of Object.entries(files)) {
         writeFile(node_path_1.default.join(slicePath, relativePath), content);
     }
-    if (templatesDir) {
-        logger_1.logger.info(`Generated ${sliceType} "${sliceName}" successfully (custom templates).`);
-    }
-    else {
-        logger_1.logger.info(`Generated ${sliceType} "${sliceName}" successfully.`);
-    }
+    const source = templatesDir ? ' (custom templates)' : '';
+    logger_1.logger.info(`\nGenerated ${sliceType} "${sliceName}"${source}`);
+    logger_1.logger.info(`Structure: ${sliceDescriptions[sliceType]}`);
 }
-//# sourceMappingURL=generate.js.map
+//# 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;