@xanahlight/component-forge 0.1.0 → 1.4.0

package/dist/commands/validate/validate.test.js

@@ -0,0 +1,163 @@
+"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");
+// ---------------------------------------------------------------------------
+// Shared layer rule fixtures
+// ---------------------------------------------------------------------------
+const fsdRule = {
+    required: ['app', 'shared'],
+    allowed: ['app', 'processes', 'pages', 'widgets', 'features', 'entities', 'shared'],
+};
+const modularRule = {
+    required: ['shared', 'core'],
+    allowed: ['modules', 'shared', 'core'],
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeTempDir() {
+    return fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'cf-validate-test-'));
+}
+function mkdir(base, ...segments) {
+    const p = node_path_1.default.join(base, ...segments);
+    fs_extra_1.default.ensureDirSync(p);
+    return p;
+}
+function touch(base, ...segments) {
+    const p = node_path_1.default.join(base, ...segments);
+    fs_extra_1.default.ensureDirSync(node_path_1.default.dirname(p));
+    fs_extra_1.default.writeFileSync(p, '');
+}
+// ---------------------------------------------------------------------------
+// checkRequiredLayers
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('checkRequiredLayers', () => {
+    let tmpDir;
+    (0, vitest_1.beforeEach)(() => { tmpDir = makeTempDir(); });
+    (0, vitest_1.afterEach)(() => { fs_extra_1.default.removeSync(tmpDir); });
+    (0, vitest_1.it)('returns no issues when all required layers exist', () => {
+        mkdir(tmpDir, 'app');
+        mkdir(tmpDir, 'shared');
+        const issues = (0, index_1.checkRequiredLayers)(tmpDir, fsdRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(0);
+    });
+    (0, vitest_1.it)('returns an error for each missing required layer', () => {
+        // Neither app nor shared exist
+        const issues = (0, index_1.checkRequiredLayers)(tmpDir, fsdRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(2);
+        (0, vitest_1.expect)(issues.every((i) => i.severity === 'error')).toBe(true);
+    });
+    (0, vitest_1.it)('message contains the missing layer path', () => {
+        mkdir(tmpDir, 'app');
+        // shared is missing
+        const issues = (0, index_1.checkRequiredLayers)(tmpDir, fsdRule, 'src');
+        (0, vitest_1.expect)(issues[0].message).toBe('Missing required layer: src/shared');
+    });
+    (0, vitest_1.it)('works for modular architecture', () => {
+        mkdir(tmpDir, 'shared');
+        // core is missing
+        const issues = (0, index_1.checkRequiredLayers)(tmpDir, modularRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(1);
+        (0, vitest_1.expect)(issues[0].message).toBe('Missing required layer: src/core');
+    });
+});
+// ---------------------------------------------------------------------------
+// checkUnknownLayers
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('checkUnknownLayers', () => {
+    let tmpDir;
+    (0, vitest_1.beforeEach)(() => { tmpDir = makeTempDir(); });
+    (0, vitest_1.afterEach)(() => { fs_extra_1.default.removeSync(tmpDir); });
+    (0, vitest_1.it)('returns no issues when all dirs are allowed', () => {
+        mkdir(tmpDir, 'app');
+        mkdir(tmpDir, 'features');
+        mkdir(tmpDir, 'shared');
+        const issues = (0, index_1.checkUnknownLayers)(tmpDir, fsdRule, 'fsd', 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(0);
+    });
+    (0, vitest_1.it)('returns a warning for each unknown directory', () => {
+        mkdir(tmpDir, 'app');
+        mkdir(tmpDir, 'shared');
+        mkdir(tmpDir, 'unknown-layer');
+        const issues = (0, index_1.checkUnknownLayers)(tmpDir, fsdRule, 'fsd', 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(1);
+        (0, vitest_1.expect)(issues[0].severity).toBe('warning');
+    });
+    (0, vitest_1.it)('message contains the dir name and architecture', () => {
+        mkdir(tmpDir, 'random');
+        const issues = (0, index_1.checkUnknownLayers)(tmpDir, fsdRule, 'fsd', 'src');
+        (0, vitest_1.expect)(issues[0].message).toContain('"src/random"');
+        (0, vitest_1.expect)(issues[0].message).toContain('FSD');
+    });
+    (0, vitest_1.it)('ignores files (only checks directories)', () => {
+        touch(tmpDir, 'some-file.ts');
+        const issues = (0, index_1.checkUnknownLayers)(tmpDir, fsdRule, 'fsd', 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(0);
+    });
+    (0, vitest_1.it)('returns empty array when srcPath does not exist', () => {
+        const issues = (0, index_1.checkUnknownLayers)('/non/existent', fsdRule, 'fsd', 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(0);
+    });
+    (0, vitest_1.it)('reports correct architecture name for modular', () => {
+        mkdir(tmpDir, 'alien-dir');
+        const issues = (0, index_1.checkUnknownLayers)(tmpDir, modularRule, 'modular', 'src');
+        (0, vitest_1.expect)(issues[0].message).toContain('MODULAR');
+    });
+});
+// ---------------------------------------------------------------------------
+// checkPublicApiFiles
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('checkPublicApiFiles', () => {
+    let tmpDir;
+    (0, vitest_1.beforeEach)(() => { tmpDir = makeTempDir(); });
+    (0, vitest_1.afterEach)(() => { fs_extra_1.default.removeSync(tmpDir); });
+    (0, vitest_1.it)('returns no issues when all slices have index.ts', () => {
+        touch(tmpDir, 'features', 'auth', 'index.ts');
+        touch(tmpDir, 'features', 'profile', 'index.ts');
+        const issues = (0, index_1.checkPublicApiFiles)(tmpDir, fsdRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(0);
+    });
+    (0, vitest_1.it)('returns a warning for each slice missing index.ts', () => {
+        mkdir(tmpDir, 'features', 'auth'); // no index.ts
+        const issues = (0, index_1.checkPublicApiFiles)(tmpDir, fsdRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(1);
+        (0, vitest_1.expect)(issues[0].severity).toBe('warning');
+        (0, vitest_1.expect)(issues[0].message).toBe('Missing public API: src/features/auth/index.ts');
+    });
+    (0, vitest_1.it)('skips app, shared, and core layers (they are not slice layers)', () => {
+        // Even if app/shared have no index.ts, no warning should be produced
+        mkdir(tmpDir, 'app', 'some-dir');
+        mkdir(tmpDir, 'shared', 'some-dir');
+        const issues = (0, index_1.checkPublicApiFiles)(tmpDir, fsdRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(0);
+    });
+    (0, vitest_1.it)('skips layers that do not exist on disk', () => {
+        // features dir does not exist — should not throw
+        const issues = (0, index_1.checkPublicApiFiles)(tmpDir, fsdRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(0);
+    });
+    (0, vitest_1.it)('detects missing index.ts across multiple slice layers', () => {
+        mkdir(tmpDir, 'features', 'auth'); // missing index.ts
+        mkdir(tmpDir, 'entities', 'user'); // missing index.ts
+        touch(tmpDir, 'pages', 'home', 'index.ts'); // OK
+        const issues = (0, index_1.checkPublicApiFiles)(tmpDir, fsdRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(2);
+        const messages = issues.map((i) => i.message);
+        (0, vitest_1.expect)(messages).toContain('Missing public API: src/features/auth/index.ts');
+        (0, vitest_1.expect)(messages).toContain('Missing public API: src/entities/user/index.ts');
+    });
+    (0, vitest_1.it)('works for modular architecture — checks modules layer', () => {
+        mkdir(tmpDir, 'modules', 'auth'); // missing index.ts
+        const issues = (0, index_1.checkPublicApiFiles)(tmpDir, modularRule, 'src');
+        (0, vitest_1.expect)(issues).toHaveLength(1);
+        (0, vitest_1.expect)(issues[0].message).toBe('Missing public API: src/modules/auth/index.ts');
+    });
+});
+//# sourceMappingURL=validate.test.js.map

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

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

package/dist/index.js

@@ -2,26 +2,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
-const init_1 = require("./commands/init");
+const check_1 = require("./commands/check");
+const explain_1 = require("./commands/explain");
 const generate_1 = require("./commands/generate");
+const init_1 = require("./commands/init");
+const migrate_1 = require("./commands/migrate");
 const validate_1 = require("./commands/validate");
 const program = new commander_1.Command();
 program
     .name('component-forge')
     .description('Architecture-first CLI for scalable React projects')
-    .version('0.1.0');
+    .version('1.2.0');
+// ---------------------------------------------------------------------------
+// init
+// ---------------------------------------------------------------------------
 program
     .command('init')
-    .description('Initialize project structure')
-    .argument('<architecture>', 'Architecture type (fsd | modular)', (value) => {
-    if (!['fsd', 'modular'].includes(value)) {
-        throw new Error('Architecture must be fsd or modular');
-    }
-    return value;
-})
+    .description('Initialize project structure (interactive if no architecture provided)')
+    .argument('[architecture]', 'Architecture type: fsd | modular (optional — prompts if omitted)')
     .action((architecture) => {
+    if (architecture !== undefined && !['fsd', 'modular'].includes(architecture)) {
+        console.error(`error: architecture must be "fsd" or "modular", got "${architecture}"`);
+        process.exit(1);
+    }
     (0, init_1.initCommand)(architecture);
 });
+// ---------------------------------------------------------------------------
+// generate
+// ---------------------------------------------------------------------------
 const SLICE_TYPES = ['feature', 'entity', 'widget', 'page', 'component', 'module'];
 program
     .command('generate')
@@ -33,16 +41,52 @@ program
     }
     return value;
 })
-    .argument('<name>', 'Slice name')
+    .argument('<name>', 'Slice name (supports nested paths, e.g. forms/Input)')
     .option('--dry-run', 'Preview files that would be generated without writing them')
     .action((type, name, options) => {
     (0, generate_1.generateCommand)(type, name, { dryRun: options.dryRun });
 });
+// ---------------------------------------------------------------------------
+// validate
+// ---------------------------------------------------------------------------
 program
     .command('validate')
     .description('Validate project structure against the configured architecture')
     .action(() => {
     (0, validate_1.validateCommand)();
 });
+// ---------------------------------------------------------------------------
+// check
+// ---------------------------------------------------------------------------
+program
+    .command('check')
+    .description('Check that imports do not violate architecture layer boundaries')
+    .action(() => {
+    (0, check_1.checkCommand)();
+});
+// ---------------------------------------------------------------------------
+// migrate
+// ---------------------------------------------------------------------------
+program
+    .command('migrate')
+    .description('Analyse current project structure and propose a migration plan')
+    .requiredOption('--to <architecture>', 'Target architecture: fsd | modular')
+    .action((options) => {
+    if (!['fsd', 'modular'].includes(options.to)) {
+        console.error(`error: --to must be "fsd" or "modular", got "${options.to}"`);
+        process.exit(1);
+    }
+    (0, migrate_1.migrateCommand)(options.to);
+});
+// ---------------------------------------------------------------------------
+// explain
+// ---------------------------------------------------------------------------
+program
+    .command('explain')
+    .description('Print architecture documentation in the terminal')
+    .argument('<topic>', `Topic to explain: ${explain_1.AVAILABLE_TOPICS.join(' | ')}`)
+    .action((topic) => {
+    (0, explain_1.explainCommand)(topic);
+});
 program.parse(process.argv);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,yCAAmC;AAEnC,0CAA6C;AAC7C,kDAAgE;AAChE,kDAAqD;AAErD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,iBAAiB,CAAC;KACvB,WAAW,CAAC,oDAAoD,CAAC;KACjE,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,8BAA8B,CAAC;KAC3C,QAAQ,CAAC,gBAAgB,EAAE,mCAAmC,EAAE,CAAC,KAAK,EAAE,EAAE;IACzE,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAC;KACD,MAAM,CAAC,CAAC,YAA+B,EAAE,EAAE;IAC1C,IAAA,kBAAW,EAAC,YAAY,CAAC,CAAA;AAC3B,CAAC,CAAC,CAAA;AAEJ,MAAM,WAAW,GAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;AAE/F,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,KAAK,CAAC,GAAG,CAAC;KACV,WAAW,CAAC,+BAA+B,CAAC;KAC5C,QAAQ,CAAC,QAAQ,EAAE,eAAe,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;IACvE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAkB,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,wBAAwB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,KAAkB,CAAA;AAC3B,CAAC,CAAC;KACD,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;KAChC,MAAM,CAAC,WAAW,EAAE,4DAA4D,CAAC;KACjF,MAAM,CAAC,CAAC,IAAe,EAAE,IAAY,EAAE,OAA6B,EAAE,EAAE;IACvE,IAAA,0BAAe,EAAC,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AACzD,CAAC,CAAC,CAAA;AAEJ,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,GAAG,EAAE;IACX,IAAA,0BAAe,GAAE,CAAA;AACnB,CAAC,CAAC,CAAA;AAEJ,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,yCAAmC;AAEnC,4CAA+C;AAC/C,gDAAqE;AACrE,kDAAqE;AACrE,0CAA6C;AAC7C,gDAAmD;AACnD,kDAAqD;AAGrD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,iBAAiB,CAAC;KACvB,WAAW,CAAC,oDAAoD,CAAC;KACjE,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,wEAAwE,CAAC;KACrF,QAAQ,CAAC,gBAAgB,EAAE,kEAAkE,CAAC;KAC9F,MAAM,CAAC,CAAC,YAAqB,EAAE,EAAE;IAChC,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7E,OAAO,CAAC,KAAK,CAAC,wDAAwD,YAAY,GAAG,CAAC,CAAA;QACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IACD,IAAA,kBAAW,EAAC,YAAwC,CAAC,CAAA;AACvD,CAAC,CAAC,CAAA;AAEJ,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,WAAW,GAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;AAE/F,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,KAAK,CAAC,GAAG,CAAC;KACV,WAAW,CAAC,+BAA+B,CAAC;KAC5C,QAAQ,CAAC,QAAQ,EAAE,eAAe,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;IACvE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAkB,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,wBAAwB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,KAAkB,CAAA;AAC3B,CAAC,CAAC;KACD,QAAQ,CAAC,QAAQ,EAAE,sDAAsD,CAAC;KAC1E,MAAM,CAAC,WAAW,EAAE,4DAA4D,CAAC;KACjF,MAAM,CAAC,CAAC,IAAe,EAAE,IAAY,EAAE,OAA6B,EAAE,EAAE;IACvE,IAAA,0BAAe,EAAC,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AACzD,CAAC,CAAC,CAAA;AAEJ,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,GAAG,EAAE;IACX,IAAA,0BAAe,GAAE,CAAA;AACnB,CAAC,CAAC,CAAA;AAEJ,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,iEAAiE,CAAC;KAC9E,MAAM,CAAC,GAAG,EAAE;IACX,IAAA,oBAAY,GAAE,CAAA;AAChB,CAAC,CAAC,CAAA;AAEJ,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,cAAc,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;KAC3E,MAAM,CAAC,CAAC,OAAuB,EAAE,EAAE;IAClC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,gDAAgD,OAAO,CAAC,EAAE,GAAG,CAAC,CAAA;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IACD,IAAA,wBAAc,EAAC,OAAO,CAAC,EAAkB,CAAC,CAAA;AAC5C,CAAC,CAAC,CAAA;AAEJ,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,QAAQ,CAAC,SAAS,EAAE,qBAAqB,0BAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;KACxE,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;IACxB,IAAA,wBAAc,EAAC,KAAK,CAAC,CAAA;AACvB,CAAC,CAAC,CAAA;AAEJ,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/shared/format.d.ts

@@ -0,0 +1,26 @@
+export declare const fmt: {
+    /** Bold white section heading */
+    readonly h1: (text: string) => string;
+    /** Bold cyan sub-heading */
+    readonly h2: (text: string) => string;
+    /** Dim horizontal rule (58 chars) */
+    readonly rule: () => string;
+    /** Indent a line by two spaces */
+    readonly line: (text: string) => string;
+    /** Dim / secondary text */
+    readonly dim: (text: string) => string;
+    /** Inline tag badge (cyan background) */
+    readonly tag: (text: string) => string;
+    /** Green checkmark item */
+    readonly ok: (text: string) => string;
+    /** Red cross item */
+    readonly no: (text: string) => string;
+    /**
+     * Renders a layer import-direction row.
+     *
+     * @param from    source layer name
+     * @param to      target layer name
+     * @param allowed true → green arrow, false → red cross
+     */
+    readonly arrow: (from: string, to: string, allowed: boolean) => string;
+};

package/dist/shared/format.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fmt = void 0;
+/**
+ * Shared chalk formatting helpers used across CLI output.
+ *
+ * Keeping these in one place ensures visual consistency and
+ * makes it easy to restyle the entire CLI from a single file.
+ */
+const chalk_1 = __importDefault(require("chalk"));
+exports.fmt = {
+    /** Bold white section heading */
+    h1: (text) => chalk_1.default.bold.white(`\n  ${text}\n`),
+    /** Bold cyan sub-heading */
+    h2: (text) => chalk_1.default.bold.cyan(`\n  ${text}`),
+    /** Dim horizontal rule (58 chars) */
+    rule: () => chalk_1.default.gray(`  ${'─'.repeat(58)}`),
+    /** Indent a line by two spaces */
+    line: (text) => `  ${text}`,
+    /** Dim / secondary text */
+    dim: (text) => chalk_1.default.gray(text),
+    /** Inline tag badge (cyan background) */
+    tag: (text) => chalk_1.default.bgCyan.black(` ${text} `),
+    /** Green checkmark item */
+    ok: (text) => `  ${chalk_1.default.green('✓')} ${text}`,
+    /** Red cross item */
+    no: (text) => `  ${chalk_1.default.red('✗')} ${text}`,
+    /**
+     * Renders a layer import-direction row.
+     *
+     * @param from    source layer name
+     * @param to      target layer name
+     * @param allowed true → green arrow, false → red cross
+     */
+    arrow: (from, to, allowed) => `  ${chalk_1.default.cyan(from.padEnd(12))} ${allowed ? chalk_1.default.green('→') : chalk_1.default.red('✗')} ${chalk_1.default.white(to)}`,
+};
+//# sourceMappingURL=format.js.map

package/dist/shared/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/shared/format.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;GAKG;AACH,kDAAyB;AAEZ,QAAA,GAAG,GAAG;IACjB,iCAAiC;IACjC,EAAE,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC;IAEvD,4BAA4B;IAC5B,EAAE,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAEpD,qCAAqC;IACrC,IAAI,EAAE,GAAG,EAAE,CAAC,eAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IAE7C,kCAAkC;IAClC,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE;IAEnC,2BAA2B;IAC3B,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAEvC,yCAAyC;IACzC,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,eAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC;IAEtD,2BAA2B;IAC3B,EAAE,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;IAErD,qBAAqB;IACrB,EAAE,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;IAEnD;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,IAAY,EAAE,EAAU,EAAE,OAAgB,EAAE,EAAE,CACpD,KAAK,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,eAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE;CAC9F,CAAA"}

package/dist/templates/files.d.ts

@@ -1,4 +1,4 @@
-import { SliceType } from '../types/folder-tree';
+import type { SliceType } from '../types/folder-tree';
 type SliceFileMap = Record<string, string>;
 /**
  * Returns a map of { relativeFilePath: fileContent } for a given slice type.

package/dist/templates/files.js

@@ -9,9 +9,10 @@ function toPascalCase(name) {
     return name.charAt(0).toUpperCase() + name.slice(1);
 }
 // ---------------------------------------------------------------------------
-// Individual file templates
+// Shared file templates
 // ---------------------------------------------------------------------------
-const indexTemplate = (name) => {
+/** Public barrel — re-exports ui component + its props type */
+const uiBarrelTemplate = (name) => {
     const pascal = toPascalCase(name);
     return [
         `export { ${pascal} } from './ui/${pascal}'`,
@@ -19,7 +20,22 @@ const indexTemplate = (name) => {
         '',
     ].join('\n');
 };
-const componentIndexTemplate = (name) => {
+/** Public barrel for entity — re-exports model types and api */
+const entityBarrelTemplate = (name) => {
+    const pascal = toPascalCase(name);
+    return [
+        `export type { ${pascal}State } from './model'`,
+        `export { fetch${pascal} } from './api'`,
+        '',
+    ].join('\n');
+};
+/** Public barrel for page — re-exports Page component */
+const pageBarrelTemplate = (name) => {
+    const pascal = toPascalCase(name);
+    return [`export { ${pascal}Page } from './ui/${pascal}Page'`, ''].join('\n');
+};
+/** Public barrel for flat component */
+const componentBarrelTemplate = (name) => {
     const pascal = toPascalCase(name);
     return [
         `export { ${pascal} } from './${pascal}'`,
@@ -27,6 +43,7 @@ const componentIndexTemplate = (name) => {
         '',
     ].join('\n');
 };
+/** React function component */
 const reactComponentTemplate = (name) => {
     const pascal = toPascalCase(name);
     return [
@@ -44,6 +61,7 @@ const reactComponentTemplate = (name) => {
         ``,
     ].join('\n');
 };
+/** State / stores / hooks */
 const modelTemplate = (name) => {
     const pascal = toPascalCase(name);
     return [
@@ -55,6 +73,7 @@ const modelTemplate = (name) => {
         ``,
     ].join('\n');
 };
+/** Data fetching / mutations */
 const apiTemplate = (name) => {
     const pascal = toPascalCase(name);
     return [
@@ -76,33 +95,66 @@ const apiTemplate = (name) => {
 function getSliceFiles(sliceType, name) {
     const pascal = toPascalCase(name);
     switch (sliceType) {
+        /**
+         * feature — full vertical slice (FSD)
+         * Owns its own UI, business logic (model) and server communication (api).
+         */
         case 'feature':
-        case 'entity':
             return {
-                'index.ts': indexTemplate(name),
+                'index.ts': uiBarrelTemplate(name),
                 [`ui/${pascal}.tsx`]: reactComponentTemplate(name),
                 'model/index.ts': modelTemplate(name),
                 'api/index.ts': apiTemplate(name),
             };
+        /**
+         * entity — data-layer slice (FSD)
+         * Represents a domain object: model + api, no UI of its own.
+         * UI is assembled in features/widgets that consume the entity.
+         */
+        case 'entity':
+            return {
+                'index.ts': entityBarrelTemplate(name),
+                'model/index.ts': modelTemplate(name),
+                'api/index.ts': apiTemplate(name),
+            };
+        /**
+         * widget — composite UI block (FSD)
+         * Combines multiple features/entities into a self-contained UI block.
+         * Has UI and may have local model state, but does NOT own server calls.
+         */
         case 'widget':
             return {
-                'index.ts': indexTemplate(name),
+                'index.ts': uiBarrelTemplate(name),
                 [`ui/${pascal}.tsx`]: reactComponentTemplate(name),
                 'model/index.ts': modelTemplate(name),
             };
+        /**
+         * page — route-level shell (FSD)
+         * Thin composition layer: assembles widgets/features for a route.
+         * No model or api — those belong to the layers below.
+         */
         case 'page':
             return {
-                'index.ts': [`export { ${pascal}Page } from './ui/${pascal}Page'`, ''].join('\n'),
+                'index.ts': pageBarrelTemplate(name),
                 [`ui/${pascal}Page.tsx`]: reactComponentTemplate(`${pascal}Page`),
             };
+        /**
+         * component — pure UI atom (FSD shared/ui or Modular shared/ui)
+         * Stateless, presentational, reusable across the whole codebase.
+         * Flat structure — no sub-directories.
+         */
         case 'component':
             return {
-                'index.ts': componentIndexTemplate(name),
+                'index.ts': componentBarrelTemplate(name),
                 [`${pascal}.tsx`]: reactComponentTemplate(name),
             };
+        /**
+         * module — full vertical slice (Modular architecture)
+         * Equivalent to a feature in FSD: owns UI, model and api.
+         */
         case 'module':
             return {
-                'index.ts': indexTemplate(name),
+                'index.ts': uiBarrelTemplate(name),
                 [`ui/${pascal}.tsx`]: reactComponentTemplate(name),
                 'model/index.ts': modelTemplate(name),
                 'api/index.ts': apiTemplate(name),

package/dist/templates/files.js.map

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

package/dist/templates/files.test.d.ts

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