@xanahlight/component-forge 0.1.0 → 1.5.0

package/dist/index.js

@@ -2,26 +2,37 @@
 "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");
+// Read version from package.json at runtime — stays in sync automatically.
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version } = require('../package.json');
 const program = new commander_1.Command();
 program
     .name('component-forge')
     .description('Architecture-first CLI for scalable React projects')
-    .version('0.1.0');
+    .version(version);
+// ---------------------------------------------------------------------------
+// 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 +44,101 @@ program
     }
     return value;
 })
-    .argument('<name>', 'Slice name')
+    .argument('<name>', 'Slice name — supports nested paths (e.g. auth/LoginForm) to place the slice inside a subfolder')
     .option('--dry-run', 'Preview files that would be generated without writing them')
+    .addHelpText('after', `
+Slice types and their generated structure:
+  feature    Full vertical slice → ui/<Name>.tsx  model/index.ts  api/index.ts  index.ts
+  entity     Data-layer slice    → model/index.ts  api/index.ts  index.ts
+  widget     Composite UI block  → ui/<Name>.tsx  model/index.ts  index.ts
+  page       Route-level shell   → ui/<Name>Page.tsx  index.ts
+  component  Pure UI atom        → <Name>.tsx  index.ts
+  module     Vertical module     → ui/<Name>.tsx  model/index.ts  api/index.ts  index.ts
+
+Nested paths:
+  The <name> argument supports "/" separators to nest the slice inside a subdirectory.
+  The basename is used for the component name in generated files.
+
+Examples:
+  $ component-forge g feature auth
+      Creates: src/features/auth/
+
+  $ component-forge g feature auth/LoginForm
+      Creates: src/features/auth/LoginForm/   (component name: LoginForm)
+
+  $ component-forge g entity user/profile/Address
+      Creates: src/entities/user/profile/Address/   (component name: Address)
+
+  $ component-forge g component Button --dry-run
+      Preview: src/shared/ui/Button/
+`)
     .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')
+    .addHelpText('after', `
+  Each violation is printed with a targeted "→ Fix:" hint.
+  Exits with code 1 when violations are found (useful in CI pipelines).
+
+  Example:
+    $ component-forge check
+`)
+    .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')
+    .addHelpText('after', `
+  Scans your source directory and prints a step-by-step migration plan.
+  No files are moved — this is a dry-run analysis only.
+
+  Examples:
+    $ component-forge migrate --to fsd
+    $ component-forge migrate --to 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(' | ')}`)
+    .addHelpText('after', `
+  Available topics: fsd, modular, layers, slices, segments
+
+  Examples:
+    $ component-forge explain fsd
+    $ component-forge explain layers
+    $ component-forge explain slices
+`)
+    .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":"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"}

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/types/folder-tree.d.ts

@@ -10,14 +10,28 @@ export type Architecture = 'fsd' | 'modular';
  */
 export type SliceType = 'feature' | 'entity' | 'widget' | 'page' | 'component' | 'module';
 /**
- * Project config stored in .component-forge.json
+ * Project config — written by `init`, read by all commands.
+ *
+ * Can live in:
+ *   - forge.config.ts  (recommended — full TypeScript + IntelliSense)
+ *   - .component-forge.json  (legacy — still supported for backwards compatibility)
+ *
+ * @example forge.config.ts
+ * ```ts
+ * import { defineConfig } from '@xanahlight/component-forge'
+ *
+ * export default defineConfig({
+ *   architecture: 'fsd',
+ *   srcDir: 'src',
+ * })
+ * ```
  */
 export interface ProjectConfig {
     architecture: Architecture;
     srcDir: string;
     /**
      * Optional path to a directory containing custom Handlebars (.hbs) templates.
-     * Resolved relative to the project root (where .component-forge.json lives).
+     * Resolved relative to the project root.
      *
      * Directory structure must mirror the built-in layout:
      *   <templatesDir>/<sliceType>/<file>.hbs
@@ -28,3 +42,18 @@ export interface ProjectConfig {
      */
     templates?: string;
 }
+/**
+ * Type-safe config helper — provides IntelliSense and compile-time validation
+ * in forge.config.ts.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from '@xanahlight/component-forge'
+ *
+ * export default defineConfig({
+ *   architecture: 'fsd',
+ *   srcDir: 'src',
+ * })
+ * ```
+ */
+export declare function defineConfig(config: ProjectConfig): ProjectConfig;

package/dist/types/folder-tree.js

@@ -1,3 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = defineConfig;
+/**
+ * Type-safe config helper — provides IntelliSense and compile-time validation
+ * in forge.config.ts.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from '@xanahlight/component-forge'
+ *
+ * export default defineConfig({
+ *   architecture: 'fsd',
+ *   srcDir: 'src',
+ * })
+ * ```
+ */
+function defineConfig(config) {
+    return config;
+}
 //# sourceMappingURL=folder-tree.js.map

package/dist/types/folder-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"folder-tree.js","sourceRoot":"","sources":["../../src/types/folder-tree.ts"],"names":[],"mappings":""}
+{"version":3,"file":"folder-tree.js","sourceRoot":"","sources":["../../src/types/folder-tree.ts"],"names":[],"mappings":";;AAoEA,oCAEC;AAhBD;;;;;;;;;;;;;GAaG;AACH,SAAgB,YAAY,CAAC,MAAqB;IAChD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/utils/config.d.ts

@@ -1,11 +1,24 @@
-import { ProjectConfig } from '../types/folder-tree';
-export declare const CONFIG_FILENAME = ".component-forge.json";
+import type { ProjectConfig } from '../types/folder-tree';
+export declare const CONFIG_FILENAMES: {
+    readonly ts: "forge.config.ts";
+    readonly js: "forge.config.js";
+    readonly json: ".component-forge.json";
+};
 /**
- * Reads and returns the project config from .component-forge.json.
- * Exits with a user-friendly error if the file does not exist.
+ * Reads and returns the project config.
+ *
+ * Resolution order:
+ *   1. forge.config.ts
+ *   2. forge.config.js
+ *   3. .component-forge.json  (legacy)
+ *
+ * Exits with a user-friendly error if no config is found.
  */
-export declare function loadProjectConfig(): ProjectConfig;
+export declare function loadProjectConfig(projectRoot?: string): ProjectConfig;
 /**
- * Writes the project config to .component-forge.json.
+ * Writes the project config to .component-forge.json (legacy format).
+ * Used by the `init` command when scaffolding a new project.
+ *
+ * Note: users can migrate to forge.config.ts at any time for better DX.
  */
 export declare function writeProjectConfig(config: ProjectConfig, projectRoot: string): void;

package/dist/utils/config.js

@@ -3,31 +3,93 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONFIG_FILENAME = void 0;
+exports.CONFIG_FILENAMES = void 0;
 exports.loadProjectConfig = loadProjectConfig;
 exports.writeProjectConfig = writeProjectConfig;
-const fs_extra_1 = __importDefault(require("fs-extra"));
 const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const jiti_1 = require("jiti");
 const logger_1 = require("./logger");
-exports.CONFIG_FILENAME = '.component-forge.json';
+// ---------------------------------------------------------------------------
+// Config file resolution order
+//
+//   1. forge.config.ts   ← recommended (TypeScript, IntelliSense)
+//   2. forge.config.js   ← for projects that prefer plain JS
+//   3. .component-forge.json  ← legacy (backwards compat)
+// ---------------------------------------------------------------------------
+exports.CONFIG_FILENAMES = {
+    ts: 'forge.config.ts',
+    js: 'forge.config.js',
+    json: '.component-forge.json',
+};
+/**
+ * Attempts to load forge.config.ts / forge.config.js via jiti (zero-config TS runner).
+ * Returns the default export, or null if the file does not exist.
+ */
+function loadTsConfig(projectRoot) {
+    for (const filename of [exports.CONFIG_FILENAMES.ts, exports.CONFIG_FILENAMES.js]) {
+        const configPath = node_path_1.default.join(projectRoot, filename);
+        if (!fs_extra_1.default.existsSync(configPath))
+            continue;
+        try {
+            // jiti executes TypeScript on-the-fly — no build step needed
+            const jiti = (0, jiti_1.createJiti)(__filename, { interopDefault: true });
+            const mod = jiti(configPath);
+            const config = mod.default ?? mod;
+            if (!config || typeof config !== 'object') {
+                logger_1.logger.error(`${filename} must export a default config object.`);
+                logger_1.logger.info(`Use defineConfig({ architecture: 'fsd', srcDir: 'src' }) as the default export.`);
+                process.exit(1);
+            }
+            return config;
+        }
+        catch (err) {
+            logger_1.logger.error(`Failed to load ${filename}: ${err.message}`);
+            process.exit(1);
+        }
+    }
+    return null;
+}
 /**
- * Reads and returns the project config from .component-forge.json.
- * Exits with a user-friendly error if the file does not exist.
+ * Reads and returns the project config.
+ *
+ * Resolution order:
+ *   1. forge.config.ts
+ *   2. forge.config.js
+ *   3. .component-forge.json  (legacy)
+ *
+ * Exits with a user-friendly error if no config is found.
  */
-function loadProjectConfig() {
-    const configPath = node_path_1.default.join(process.cwd(), exports.CONFIG_FILENAME);
-    if (!fs_extra_1.default.existsSync(configPath)) {
-        logger_1.logger.error(`No ${exports.CONFIG_FILENAME} found.`);
-        logger_1.logger.info('Run "component-forge init <architecture>" first.');
-        process.exit(1);
+function loadProjectConfig(projectRoot = process.cwd()) {
+    // 1 & 2 — TypeScript / JS config
+    const tsConfig = loadTsConfig(projectRoot);
+    if (tsConfig)
+        return tsConfig;
+    // 3 — Legacy JSON config
+    const jsonPath = node_path_1.default.join(projectRoot, exports.CONFIG_FILENAMES.json);
+    if (fs_extra_1.default.existsSync(jsonPath)) {
+        return fs_extra_1.default.readJsonSync(jsonPath);
     }
-    return fs_extra_1.default.readJsonSync(configPath);
+    // Nothing found
+    logger_1.logger.error(`No forge.config.ts (or ${exports.CONFIG_FILENAMES.json}) found.`);
+    logger_1.logger.info('Run "component-forge init" to create a config, or create forge.config.ts manually:');
+    logger_1.logger.info('');
+    logger_1.logger.info("  import { defineConfig } from '@xanahlight/component-forge'");
+    logger_1.logger.info('');
+    logger_1.logger.info("  export default defineConfig({");
+    logger_1.logger.info("    architecture: 'fsd',");
+    logger_1.logger.info("    srcDir: 'src',");
+    logger_1.logger.info("  })");
+    process.exit(1);
 }
 /**
- * Writes the project config to .component-forge.json.
+ * Writes the project config to .component-forge.json (legacy format).
+ * Used by the `init` command when scaffolding a new project.
+ *
+ * Note: users can migrate to forge.config.ts at any time for better DX.
  */
 function writeProjectConfig(config, projectRoot) {
-    const configPath = node_path_1.default.join(projectRoot, exports.CONFIG_FILENAME);
+    const configPath = node_path_1.default.join(projectRoot, exports.CONFIG_FILENAMES.json);
     fs_extra_1.default.writeJsonSync(configPath, config, { spaces: 2 });
 }
 //# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":";;;;;;AAYA,8CAUC;AAKD,gDAGC;AA9BD,wDAAyB;AACzB,0DAA4B;AAG5B,qCAAiC;AAEpB,QAAA,eAAe,GAAG,uBAAuB,CAAA;AAEtD;;;GAGG;AACH,SAAgB,iBAAiB;IAC/B,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,uBAAe,CAAC,CAAA;IAE5D,IAAI,CAAC,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,eAAM,CAAC,KAAK,CAAC,MAAM,uBAAe,SAAS,CAAC,CAAA;QAC5C,eAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAA;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,kBAAE,CAAC,YAAY,CAAC,UAAU,CAAkB,CAAA;AACrD,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,MAAqB,EAAE,WAAmB;IAC3E,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,uBAAe,CAAC,CAAA;IAC1D,kBAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;AACrD,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"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"}

package/dist/utils/template-resolver.d.ts

@@ -1,4 +1,4 @@
-import { SliceType } from '../types/folder-tree';
+import type { SliceType } from '../types/folder-tree';
 /**
  * Resolves the file map for a slice, merging custom templates over built-in defaults.
  *

package/dist/utils/template-resolver.js

@@ -4,9 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveSliceFiles = resolveSliceFiles;
+const node_path_1 = __importDefault(require("node:path"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const handlebars_1 = __importDefault(require("handlebars"));
-const node_path_1 = __importDefault(require("node:path"));
 const files_1 = require("../templates/files");
 /** "auth" → "Auth", "userProfile" → "UserProfile" */
 function toPascalCase(str) {