@xanahlight/component-forge 0.1.0 → 1.4.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/check.test.d.ts

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

package/dist/commands/check/check.test.js

@@ -0,0 +1,151 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const vitest_1 = require("vitest");
+const index_1 = require("./index");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+let tmpDir;
+function write(relPath, content) {
+    const full = node_path_1.default.join(tmpDir, relPath);
+    fs_extra_1.default.ensureDirSync(node_path_1.default.dirname(full));
+    fs_extra_1.default.writeFileSync(full, content);
+}
+(0, vitest_1.beforeEach)(() => {
+    tmpDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'cf-check-'));
+});
+(0, vitest_1.afterEach)(() => {
+    fs_extra_1.default.removeSync(tmpDir);
+});
+// ---------------------------------------------------------------------------
+// parseImports
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('parseImports', () => {
+    (0, vitest_1.it)('extracts named imports', () => {
+        const src = `import { foo } from './foo'\nimport type { Bar } from '../bar'`;
+        (0, vitest_1.expect)((0, index_1.parseImports)(src)).toEqual(['./foo', '../bar']);
+    });
+    (0, vitest_1.it)('extracts default imports', () => {
+        (0, vitest_1.expect)((0, index_1.parseImports)(`import React from 'react'`)).toEqual(['react']);
+    });
+    (0, vitest_1.it)('extracts re-exports', () => {
+        (0, vitest_1.expect)((0, index_1.parseImports)(`export { foo } from './foo'`)).toEqual(['./foo']);
+    });
+    (0, vitest_1.it)('ignores non-import lines', () => {
+        (0, vitest_1.expect)((0, index_1.parseImports)(`const x = 1\nconsole.log(x)`)).toEqual([]);
+    });
+});
+// ---------------------------------------------------------------------------
+// resolveLayer
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('resolveLayer', () => {
+    (0, vitest_1.it)('returns first path segment as layer', () => {
+        (0, vitest_1.expect)((0, index_1.resolveLayer)('features/auth/index.ts')).toBe('features');
+        (0, vitest_1.expect)((0, index_1.resolveLayer)('shared/ui/Button.tsx')).toBe('shared');
+    });
+    (0, vitest_1.it)('returns single-segment layer', () => {
+        (0, vitest_1.expect)((0, index_1.resolveLayer)('app')).toBe('app');
+    });
+});
+// ---------------------------------------------------------------------------
+// collectSourceFiles
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('collectSourceFiles', () => {
+    (0, vitest_1.it)('finds ts and tsx files', () => {
+        write('features/auth/index.ts', '');
+        write('shared/ui/Button.tsx', '');
+        write('shared/ui/Button.test.ts', ''); // should be excluded
+        const files = (0, index_1.collectSourceFiles)(tmpDir);
+        (0, vitest_1.expect)(files).toContain(node_path_1.default.join('features', 'auth', 'index.ts'));
+        (0, vitest_1.expect)(files).toContain(node_path_1.default.join('shared', 'ui', 'Button.tsx'));
+        (0, vitest_1.expect)(files.some((f) => f.endsWith('.test.ts'))).toBe(false);
+    });
+    (0, vitest_1.it)('returns empty array for non-existent dir', () => {
+        (0, vitest_1.expect)((0, index_1.collectSourceFiles)('/non/existent/path')).toEqual([]);
+    });
+});
+// ---------------------------------------------------------------------------
+// FSD violations
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('runCheck — FSD', () => {
+    (0, vitest_1.it)('passes when lower layer imports from even lower layer (entities → shared)', () => {
+        write('entities/user/index.ts', `import { Button } from '../../shared/ui/Button'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(result.violations).toHaveLength(0);
+        (0, vitest_1.expect)(result.checkedFiles).toBe(1);
+    });
+    (0, vitest_1.it)('detects feature importing from feature (same level)', () => {
+        write('features/auth/index.ts', `import { foo } from '../../features/search/index'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(result.violations).toHaveLength(1);
+        (0, vitest_1.expect)(result.violations[0].message).toMatch(/must not import from "features"/);
+    });
+    (0, vitest_1.it)('detects entity importing from feature (higher level)', () => {
+        write('entities/user/index.ts', `import { login } from '../../features/auth/index'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(result.violations).toHaveLength(1);
+        (0, vitest_1.expect)(result.violations[0].message).toMatch(/must not import from "features"/);
+    });
+    (0, vitest_1.it)('detects shared importing from entities (higher level)', () => {
+        write('shared/ui/Avatar.ts', `import { User } from '../../entities/user/model'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(result.violations).toHaveLength(1);
+        (0, vitest_1.expect)(result.violations[0].message).toMatch(/must not import from "entities"/);
+    });
+    (0, vitest_1.it)('passes when feature imports from entities (lower level)', () => {
+        write('features/auth/index.ts', `import { User } from '../../entities/user/index'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(result.violations).toHaveLength(0);
+    });
+    (0, vitest_1.it)('passes when pages imports from widgets (lower level)', () => {
+        write('pages/home/index.ts', `import { Header } from '../../widgets/header/index'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(result.violations).toHaveLength(0);
+    });
+    (0, vitest_1.it)('ignores external (non-relative) imports', () => {
+        write('features/auth/index.ts', `import React from 'react'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(result.violations).toHaveLength(0);
+    });
+    (0, vitest_1.it)('reports multiple violations across multiple files', () => {
+        write('entities/user/index.ts', `import { login } from '../../features/auth/index'`);
+        write('shared/ui/Button.ts', `import { User } from '../../entities/user/model'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(result.violations).toHaveLength(2);
+        (0, vitest_1.expect)(result.checkedFiles).toBe(2);
+    });
+});
+// ---------------------------------------------------------------------------
+// Modular violations
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('runCheck — modular', () => {
+    (0, vitest_1.it)('passes when module imports from another module', () => {
+        write('modules/auth/index.ts', `import { foo } from '../../modules/ui/index'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'modular');
+        (0, vitest_1.expect)(result.violations).toHaveLength(0);
+    });
+    (0, vitest_1.it)('detects shared importing from modules', () => {
+        write('shared/utils/helper.ts', `import { login } from '../../modules/auth/index'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'modular');
+        (0, vitest_1.expect)(result.violations).toHaveLength(1);
+        (0, vitest_1.expect)(result.violations[0].message).toMatch(/must not import from "modules"/);
+    });
+    (0, vitest_1.it)('detects core importing from modules', () => {
+        write('core/router.ts', `import { AuthModule } from '../modules/auth/index'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'modular');
+        (0, vitest_1.expect)(result.violations).toHaveLength(1);
+        (0, vitest_1.expect)(result.violations[0].message).toMatch(/must not import from "modules"/);
+    });
+    (0, vitest_1.it)('passes when module imports from shared', () => {
+        write('modules/auth/index.ts', `import { Button } from '../../shared/ui/Button'`);
+        const result = (0, index_1.runCheck)(tmpDir, 'modular');
+        (0, vitest_1.expect)(result.violations).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=check.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.test.js","sourceRoot":"","sources":["../../../src/commands/check/check.test.ts"],"names":[],"mappings":";;;;;AAAA,sDAAwB;AACxB,0DAA4B;AAE5B,wDAAyB;AACzB,mCAAoE;AAEpE,mCAAkF;AAElF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,IAAI,MAAc,CAAA;AAElB,SAAS,KAAK,CAAC,OAAe,EAAE,OAAe;IAC7C,MAAM,IAAI,GAAG,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,kBAAE,CAAC,aAAa,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACpC,kBAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACjC,CAAC;AAED,IAAA,mBAAU,EAAC,GAAG,EAAE;IACd,MAAM,GAAG,kBAAE,CAAC,WAAW,CAAC,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAA;AAC9D,CAAC,CAAC,CAAA;AAEF,IAAA,kBAAS,EAAC,GAAG,EAAE;IACb,kBAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;AACvB,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAA,WAAE,EAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,GAAG,GAAG,gEAAgE,CAAA;QAC5E,IAAA,eAAM,EAAC,IAAA,oBAAY,EAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,IAAA,eAAM,EAAC,IAAA,oBAAY,EAAC,2BAA2B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,IAAA,eAAM,EAAC,IAAA,oBAAY,EAAC,6BAA6B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,IAAA,eAAM,EAAC,IAAA,oBAAY,EAAC,6BAA6B,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAA,WAAE,EAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,IAAA,eAAM,EAAC,IAAA,oBAAY,EAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/D,IAAA,eAAM,EAAC,IAAA,oBAAY,EAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,IAAA,eAAM,EAAC,IAAA,oBAAY,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAA,WAAE,EAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,KAAK,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAA;QACnC,KAAK,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAA;QACjC,KAAK,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAA,CAAC,qBAAqB;QAE3D,MAAM,KAAK,GAAG,IAAA,0BAAkB,EAAC,MAAM,CAAC,CAAA;QACxC,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;QAClE,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAA;QAChE,IAAA,eAAM,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,IAAA,eAAM,EAAC,IAAA,0BAAkB,EAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAA,WAAE,EAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,KAAK,CAAC,wBAAwB,EAAE,iDAAiD,CAAC,CAAA;QAClF,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,IAAA,eAAM,EAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,KAAK,CACH,wBAAwB,EACxB,mDAAmD,CACpD,CAAA;QACD,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,KAAK,CACH,wBAAwB,EACxB,mDAAmD,CACpD,CAAA;QACD,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,KAAK,CACH,qBAAqB,EACrB,kDAAkD,CACnD,CAAA;QACD,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,KAAK,CACH,wBAAwB,EACxB,kDAAkD,CACnD,CAAA;QACD,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,KAAK,CACH,qBAAqB,EACrB,qDAAqD,CACtD,CAAA;QACD,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,KAAK,CAAC,wBAAwB,EAAE,2BAA2B,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,KAAK,CAAC,wBAAwB,EAAE,mDAAmD,CAAC,CAAA;QACpF,KAAK,CAAC,qBAAqB,EAAE,kDAAkD,CAAC,CAAA;QAChF,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,IAAA,eAAM,EAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAA,WAAE,EAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,KAAK,CAAC,uBAAuB,EAAE,8CAA8C,CAAC,CAAA;QAC9E,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1C,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,KAAK,CAAC,wBAAwB,EAAE,kDAAkD,CAAC,CAAA;QACnF,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1C,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,KAAK,CAAC,gBAAgB,EAAE,oDAAoD,CAAC,CAAA;QAC7E,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1C,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,KAAK,CAAC,uBAAuB,EAAE,iDAAiD,CAAC,CAAA;QACjF,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1C,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,15 @@
+import type { Architecture } from '../../types/folder-tree';
+export interface CheckViolation {
+    file: string;
+    importPath: string;
+    message: 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,186 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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'],
+};
+// ---------------------------------------------------------------------------
+// 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) {
+            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)`,
+            });
+        }
+    }
+    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`,
+            });
+        }
+    }
+    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}\n`));
+    }
+    logger_1.logger.info(chalk_1.default.yellow('Tip: ') +
+        'Each layer should only import from layers below it in the hierarchy.');
+    if (config.architecture === 'fsd') {
+        logger_1.logger.info(chalk_1.default.gray('  FSD order (low → high): shared → entities → features → widgets → pages → app'));
+    }
+    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/explain.test.d.ts

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

package/dist/commands/explain/explain.test.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_1 = require("./index");
+(0, vitest_1.describe)('renderTopic', () => {
+    (0, vitest_1.it)('renders fsd topic with key sections', () => {
+        const output = (0, index_1.renderTopic)('fsd');
+        (0, vitest_1.expect)(output).toContain('Feature-Sliced Design');
+        (0, vitest_1.expect)(output).toContain('shared');
+        (0, vitest_1.expect)(output).toContain('entities');
+        (0, vitest_1.expect)(output).toContain('features');
+        (0, vitest_1.expect)(output).toContain('widgets');
+        (0, vitest_1.expect)(output).toContain('pages');
+        (0, vitest_1.expect)(output).toContain('app');
+        (0, vitest_1.expect)(output).toContain('Import rules');
+    });
+    (0, vitest_1.it)('renders modular topic with key sections', () => {
+        const output = (0, index_1.renderTopic)('modular');
+        (0, vitest_1.expect)(output).toContain('Modular Architecture');
+        (0, vitest_1.expect)(output).toContain('modules');
+        (0, vitest_1.expect)(output).toContain('core');
+        (0, vitest_1.expect)(output).toContain('shared');
+        (0, vitest_1.expect)(output).toContain('Import rules');
+    });
+    (0, vitest_1.it)('renders layers topic with FSD layer reference', () => {
+        const output = (0, index_1.renderTopic)('layers');
+        (0, vitest_1.expect)(output).toContain('FSD Layer Reference');
+        (0, vitest_1.expect)(output).toContain('shared');
+        (0, vitest_1.expect)(output).toContain('entities');
+        (0, vitest_1.expect)(output).toContain('features');
+    });
+    (0, vitest_1.it)('renders all topic combining all sections', () => {
+        const output = (0, index_1.renderTopic)('all');
+        (0, vitest_1.expect)(output).toContain('Feature-Sliced Design');
+        (0, vitest_1.expect)(output).toContain('Modular Architecture');
+        (0, vitest_1.expect)(output).toContain('FSD Layer Reference');
+    });
+    (0, vitest_1.it)('returns error message for unknown topic', () => {
+        const output = (0, index_1.renderTopic)('unknown-topic');
+        (0, vitest_1.expect)(output).toContain('Unknown topic');
+        (0, vitest_1.expect)(output).toContain('unknown-topic');
+        (0, vitest_1.expect)(output).toContain('Available topics');
+    });
+    (0, vitest_1.it)('is case-insensitive', () => {
+        const lower = (0, index_1.renderTopic)('fsd');
+        const upper = (0, index_1.renderTopic)('FSD');
+        // Same length means same content (ANSI codes are identical)
+        (0, vitest_1.expect)(lower.length).toBe(upper.length);
+    });
+    (0, vitest_1.it)('AVAILABLE_TOPICS contains expected topics', () => {
+        (0, vitest_1.expect)(index_1.AVAILABLE_TOPICS).toContain('fsd');
+        (0, vitest_1.expect)(index_1.AVAILABLE_TOPICS).toContain('modular');
+        (0, vitest_1.expect)(index_1.AVAILABLE_TOPICS).toContain('layers');
+        (0, vitest_1.expect)(index_1.AVAILABLE_TOPICS).toContain('all');
+    });
+});
+//# sourceMappingURL=explain.test.js.map

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

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