@xanahlight/component-forge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vladislavprozorov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,266 @@
+# component-forge
+
+🌐 English | [Русский](README.ru.md)
+
+[![npm version](https://img.shields.io/npm/v/@xanahlight/component-forge.svg)](https://www.npmjs.com/package/@xanahlight/component-forge)
+[![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)
+
+> Architecture-first CLI for scalable React projects.
+
+A tool that enforces structural discipline through predefined architectural templates — Feature-Sliced Design (FSD) and Modular Architecture.
+
+---
+
+## Why
+
+React gives you flexibility — but not structure.
+
+In growing teams this often leads to:
+
+- inconsistent folder structures across engineers
+- unclear layer boundaries and ownership
+- tight coupling between features
+- architectural degradation over time
+
+**component-forge** solves this by providing:
+
+- standardized project structure from day one
+- enforced architectural layers
+- public API boundaries via `index.ts` files
+- a `validate` command that catches violations before they ship
+
+> This is not just a scaffolding tool. It is an **architecture enforcement tool**.
+
+---
+
+## Target Audience
+
+- React teams (3–10 developers)
+- Growing startups with shared codebases
+- Developers who have experienced architectural chaos
+- Engineers who value structure and long-term maintainability
+
+> Not designed for beginners learning React basics.
+
+---
+
+## Supported Architectures
+
+### 1. Feature-Sliced Design (FSD)
+
+Generates a layered structure:
+
+```
+src/
+ ├─ app/
+ ├─ processes/
+ ├─ pages/
+ ├─ widgets/
+ ├─ features/
+ ├─ entities/
+ └─ shared/
+      ├─ ui/
+      ├─ lib/
+      ├─ api/
+      └─ config/
+```
+
+Enforces strict layer hierarchy — app → pages → widgets → features → entities → shared.
+No deep imports. Public API only via `index.ts`.
+
+### 2. Modular Architecture
+
+Generates a domain-oriented structure:
+
+```
+src/
+ ├─ modules/
+ │   ├─ auth/
+ │   ├─ profile/
+ │   └─ dashboard/
+ ├─ shared/
+ └─ core/
+```
+
+Focused on domain separation and scalable team ownership.
+
+---
+
+## Installation
+
+```bash
+# Global install
+npm install -g @xanahlight/component-forge
+
+# No install required (recommended for one-time setup)
+npx @xanahlight/component-forge init fsd
+```
+
+---
+
+## Commands
+
+### init
+
+Creates the folder structure and writes `.component-forge.json`.
+
+```bash
+component-forge init fsd
+component-forge init modular
+```
+
+### generate
+
+Generates a slice with pre-populated files.
+
+```bash
+# FSD slices
+component-forge generate feature auth
+component-forge generate entity user
+component-forge generate widget Header
+component-forge generate page dashboard
+
+# Components (placed in shared/ui)
+component-forge generate component Button
+component-forge generate component forms/Input
+
+# Modular
+component-forge generate module profile
+
+# Short alias
+component-forge g feature auth
+```
+
+What gets generated for `generate feature auth`:
+
+```
+src/features/auth/
+ ├─ index.ts          <- public API
+ ├─ ui/Auth.tsx       <- React component
+ ├─ model/index.ts   <- state / hooks
+ └─ api/index.ts     <- data fetching
+```
+
+### validate
+
+Validates your project structure against the configured architecture.
+
+```bash
+component-forge validate
+```
+
+Checks:
+
+- Required layers are present (error)
+- Unknown layers that do not belong to the architecture (warning)
+- Slices missing a public API `index.ts` (warning)
+
+Exits with code `1` on errors — suitable for CI pipelines.
+
+---
+
+## Project Config
+
+After `init`, a `.component-forge.json` is created:
+
+```json
+{
+  "architecture": "fsd",
+  "srcDir": "src"
+}
+```
+
+All commands read this config automatically. No flags needed after init.
+
+---
+
+## Custom Templates
+
+You can override any built-in file template with your own [Handlebars](https://handlebarsjs.com/) (`.hbs`) files.
+
+**1. Add a `templates` field to `.component-forge.json`:**
+
+```json
+{
+  "architecture": "fsd",
+  "srcDir": "src",
+  "templates": ".forge-templates"
+}
+```
+
+**2. Create `.hbs` files mirroring the built-in structure:**
+
+```
+.forge-templates/
+ └─ feature/
+      └─ index.ts.hbs        ← overrides built-in index.ts for features
+```
+
+**Available template variables:**
+
+| Variable | Description | Example |
+| --- | --- | --- |
+| `{{name}}` | Raw slice name | `auth` |
+| `{{Name}}` | PascalCase name | `Auth` |
+| `{{sliceType}}` | Slice type | `feature` |
+
+**Example `.forge-templates/feature/index.ts.hbs`:**
+
+```handlebars
+// {{sliceType}} public API
+export { {{Name}} } from './ui/{{Name}}'
+export type { {{Name}}Props } from './ui/{{Name}}'
+```
+
+Any template file not found in your custom directory automatically falls back to the built-in default.
+
+---
+
+## Philosophy
+
+- **Opinionated > Flexible** — strong defaults prevent decision fatigue
+- **Structure > Freedom** — constraints enable scale
+- **Predictability > Improvisation** — anyone on the team knows where things live
+- **Enforcement > Convention** — `validate` catches drift before it becomes debt
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/vladislavprozorov/component-forge.git
+cd component-forge
+npm install
+npm run build
+node dist/index.js init fsd
+```
+
+> Node.js 20+ required.
+
+---
+
+## Project Status
+
+Active development. Core commands are functional. API may change before 1.0.
+
+- [x] `init` — FSD and Modular scaffolding
+- [x] `generate` — slices with file templates
+- [x] `validate` — architecture enforcement
+- [x] `generate --dry-run` — preview without writing
+- [x] Custom templates via config
+- [ ] VS Code extension
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+Please open an issue before submitting large changes.
+
+---
+
+## License
+
+[MIT](LICENSE)

package/README.ru.md

@@ -0,0 +1,219 @@
+# component-forge
+
+🌐 [English](README.md) | Русский
+
+> CLI инструмент для масштабируемых React проектов с акцентом на архитектуру.
+
+Инструмент, обеспечивающий структурную дисциплину через готовые архитектурные шаблоны — Feature-Sliced Design (FSD) и Модульную архитектуру.
+
+---
+
+## Зачем это нужно
+
+React даёт гибкость — но не структуру.
+
+В растущих командах это часто приводит к:
+
+- непоследовательным структурам папок
+- размытым границам между слоями
+- тесной связанности между фичами
+- архитектурной деградации со временем
+
+**component-forge** решает это:
+
+- стандартизированная структура проекта с первого дня
+- чёткие архитектурные слои
+- публичные API через файлы `index.ts`
+- команда `validate` ловит нарушения до попадания в прод
+
+> Это не просто инструмент генерации файлов. Это **инструмент контроля архитектуры**.
+
+---
+
+## Целевая аудитория
+
+- React команды (3–10 разработчиков)
+- Растущие стартапы с общей кодовой базой
+- Разработчики, уже сталкивавшиеся с архитектурным хаосом
+- Инженеры, ценящие структуру и долгосрочную поддерживаемость
+
+> Не предназначен для новичков, изучающих основы React.
+
+---
+
+## Поддерживаемые архитектуры
+
+### 1. Feature-Sliced Design (FSD)
+
+Генерирует слоистую структуру:
+
+```
+src/
+ ├─ app/
+ ├─ processes/
+ ├─ pages/
+ ├─ widgets/
+ ├─ features/
+ ├─ entities/
+ └─ shared/
+      ├─ ui/
+      ├─ lib/
+      ├─ api/
+      └─ config/
+```
+
+Обеспечивает строгую иерархию слоёв — app → pages → widgets → features → entities → shared.
+Нет глубоких импортов. Только публичный API через `index.ts`.
+
+### 2. Модульная архитектура
+
+Генерирует доменно-ориентированную структуру:
+
+```
+src/
+ ├─ modules/
+ │   ├─ auth/
+ │   ├─ profile/
+ │   └─ dashboard/
+ ├─ shared/
+ └─ core/
+```
+
+Фокус на разделении по доменам и масштабируемом владении кодом.
+
+---
+
+## Установка
+
+```bash
+# Глобальная установка
+npm install -g component-forge
+
+# Без установки (рекомендуется для разового использования)
+npx component-forge init fsd
+```
+
+---
+
+## Команды
+
+### init
+
+Создаёт структуру папок и записывает `.component-forge.json`.
+
+```bash
+component-forge init fsd
+component-forge init modular
+```
+
+### generate
+
+Генерирует слайс с готовыми файлами.
+
+```bash
+# FSD слайсы
+component-forge generate feature auth
+component-forge generate entity user
+component-forge generate widget Header
+component-forge generate page dashboard
+
+# Компоненты (размещаются в shared/ui)
+component-forge generate component Button
+component-forge generate component forms/Input
+
+# Модульная архитектура
+component-forge generate module profile
+
+# Короткий алиас
+component-forge g feature auth
+```
+
+Что генерируется для `generate feature auth`:
+
+```
+src/features/auth/
+ ├─ index.ts          <- публичный API
+ ├─ ui/Auth.tsx       <- React компонент
+ ├─ model/index.ts   <- состояние / хуки
+ └─ api/index.ts     <- запросы к данным
+```
+
+### validate
+
+Проверяет структуру проекта на соответствие настроенной архитектуре.
+
+```bash
+component-forge validate
+```
+
+Проверяет:
+- Обязательные слои присутствуют (ошибка)
+- Неизвестные слои, не относящиеся к архитектуре (предупреждение)
+- Слайсы без публичного API `index.ts` (предупреждение)
+
+Завершается с кодом `1` при ошибках — подходит для CI.
+
+---
+
+## Конфигурация проекта
+
+После `init` создаётся файл `.component-forge.json`:
+
+```json
+{
+  "architecture": "fsd",
+  "srcDir": "src"
+}
+```
+
+Все команды читают этот конфиг автоматически. Флаги после init не нужны.
+
+---
+
+## Философия
+
+- **Мнение > Гибкость** — строгие настройки по умолчанию исключают лишние решения
+- **Структура > Свобода** — ограничения обеспечивают масштабирование
+- **Предсказуемость > Импровизация** — каждый в команде знает где что лежит
+- **Контроль > Соглашение** — `validate` ловит отклонения до того как они становятся долгом
+
+---
+
+## Разработка
+
+```bash
+git clone https://github.com/vladislavprozorov/component-forge.git
+cd component-forge
+npm install
+npm run build
+node dist/index.js init fsd
+```
+
+> Требуется Node.js 20+.
+
+---
+
+## Статус проекта
+
+Активная разработка. Основные команды работают. API может измениться до версии 1.0.
+
+- [x] `init` — скаффолдинг FSD и Modular
+- [x] `generate` — слайсы с шаблонами файлов
+- [x] `validate` — контроль архитектуры
+- [ ] Флаг `generate --dry-run`
+- [ ] Кастомные шаблоны через конфиг
+- [ ] Расширение для VS Code
+
+---
+
+## Участие в проекте
+
+См. [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Пожалуйста, открой issue перед отправкой крупных изменений.
+
+---
+
+## Лицензия
+
+[MIT](LICENSE)

package/dist/commands/generate.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.js

@@ -0,0 +1,91 @@
+"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 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 placementByArchitecture = {
+    fsd: {
+        feature: 'features',
+        entity: 'entities',
+        widget: 'widgets',
+        page: 'pages',
+        component: 'shared/ui',
+    },
+    modular: {
+        module: 'modules',
+        component: 'shared/ui',
+    },
+};
+// ---------------------------------------------------------------------------
+// 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.\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);
+    }
+    if (templatesDir) {
+        logger_1.logger.info(`Generated ${sliceType} "${sliceName}" successfully (custom templates).`);
+    }
+    else {
+        logger_1.logger.info(`Generated ${sliceType} "${sliceName}" successfully.`);
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,10 @@
+import { Architecture } from '../types/folder-tree';
+import { CONFIG_FILENAME, loadProjectConfig } from '../utils/config';
+export { Architecture };
+export { CONFIG_FILENAME };
+/**
+ * Initialises the project folder structure for the given architecture
+ * and writes .component-forge.json so subsequent commands know the architecture.
+ */
+export declare function initCommand(architecture: Architecture): void;
+export { loadProjectConfig };

package/dist/commands/init.js

@@ -0,0 +1,54 @@
+"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_FILENAME = void 0;
+exports.initCommand = initCommand;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const fsd_1 = require("../templates/fsd");
+const modular_1 = require("../templates/modular");
+const config_1 = require("../utils/config");
+Object.defineProperty(exports, "CONFIG_FILENAME", { enumerable: true, get: function () { return config_1.CONFIG_FILENAME; } });
+Object.defineProperty(exports, "loadProjectConfig", { enumerable: true, get: function () { return config_1.loadProjectConfig; } });
+const logger_1 = require("../utils/logger");
+/**
+ * Template registry — maps architecture → folder tree definition
+ */
+const templates = {
+    fsd: fsd_1.fsdTemplate,
+    modular: modular_1.modularTemplate,
+};
+/**
+ * Recursively creates folder structure from a FolderTree definition
+ */
+function createStructure(tree, basePath) {
+    for (const [folderName, children] of Object.entries(tree)) {
+        const folderPath = node_path_1.default.join(basePath, folderName);
+        fs_extra_1.default.ensureDirSync(folderPath);
+        logger_1.logger.success(`Created: ${node_path_1.default.relative(process.cwd(), folderPath)}`);
+        createStructure(children, folderPath);
+    }
+}
+/**
+ * Initialises the project folder structure for the given architecture
+ * and writes .component-forge.json so subsequent commands know the architecture.
+ */
+function initCommand(architecture) {
+    const template = templates[architecture];
+    const projectRoot = process.cwd();
+    const configPath = node_path_1.default.join(projectRoot, config_1.CONFIG_FILENAME);
+    if (fs_extra_1.default.existsSync(configPath)) {
+        logger_1.logger.error(`Project already initialised (${config_1.CONFIG_FILENAME} exists).`);
+        logger_1.logger.info('Remove it manually if you want to reinitialise.');
+        process.exit(1);
+    }
+    logger_1.logger.info(`Initialising ${architecture.toUpperCase()} architecture…`);
+    createStructure(template, projectRoot);
+    const config = { architecture, srcDir: 'src' };
+    (0, config_1.writeProjectConfig)(config, projectRoot);
+    logger_1.logger.success(`Created: ${config_1.CONFIG_FILENAME}`);
+    logger_1.logger.success('Project structure successfully created.');
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";;;;;;AAyCA,kCAoBC;AA7DD,wDAAyB;AACzB,0DAA4B;AAE5B,0CAA8C;AAC9C,kDAAsD;AAEtD,4CAAwF;AAO/E,gGAPA,wBAAe,OAOA;AAmDf,kGA1DiB,0BAAiB,OA0DjB;AAzD1B,4CAAwC;AAQxC;;GAEG;AACH,MAAM,SAAS,GAAqC;IAClD,GAAG,EAAE,iBAAW;IAChB,OAAO,EAAE,yBAAe;CACzB,CAAA;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAgB,EAAE,QAAgB;IACzD,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QAElD,kBAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;QAC5B,eAAM,CAAC,OAAO,CAAC,YAAY,mBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;QAEtE,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACvC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,YAA0B;IACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,CAAA;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IACjC,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,wBAAe,CAAC,CAAA;IAE1D,IAAI,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,eAAM,CAAC,KAAK,CAAC,gCAAgC,wBAAe,WAAW,CAAC,CAAA;QACxE,eAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAA;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,eAAM,CAAC,IAAI,CAAC,gBAAgB,YAAY,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;IAEvE,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAEtC,MAAM,MAAM,GAAkB,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC7D,IAAA,2BAAkB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACvC,eAAM,CAAC,OAAO,CAAC,YAAY,wBAAe,EAAE,CAAC,CAAA;IAE7C,eAAM,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAA;AAC3D,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1 @@
+export declare function validateCommand(): void;