@xanahlight/component-forge 0.1.0 → 1.4.0

package/dist/commands/migrate/migrate.test.js

@@ -0,0 +1,176 @@
+"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 mkdir(relPath) {
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tmpDir, relPath));
+}
+(0, vitest_1.beforeEach)(() => {
+    tmpDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'cf-migrate-'));
+});
+(0, vitest_1.afterEach)(() => {
+    fs_extra_1.default.removeSync(tmpDir);
+});
+// ---------------------------------------------------------------------------
+// scanTopLevelDirs
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('scanTopLevelDirs', () => {
+    (0, vitest_1.it)('returns only directory names, not files', () => {
+        mkdir('components');
+        mkdir('utils');
+        fs_extra_1.default.writeFileSync(node_path_1.default.join(tmpDir, 'index.ts'), '');
+        const dirs = (0, index_1.scanTopLevelDirs)(tmpDir);
+        (0, vitest_1.expect)(dirs).toContain('components');
+        (0, vitest_1.expect)(dirs).toContain('utils');
+        (0, vitest_1.expect)(dirs).not.toContain('index.ts');
+    });
+    (0, vitest_1.it)('returns empty array for non-existent path', () => {
+        (0, vitest_1.expect)((0, index_1.scanTopLevelDirs)('/non/existent/path')).toEqual([]);
+    });
+    (0, vitest_1.it)('returns empty array for empty directory', () => {
+        (0, vitest_1.expect)((0, index_1.scanTopLevelDirs)(tmpDir)).toEqual([]);
+    });
+});
+// ---------------------------------------------------------------------------
+// classifyDir
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('classifyDir', () => {
+    (0, vitest_1.it)('classifies "components" as shared/ui', () => {
+        const result = (0, index_1.classifyDir)('components');
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result.layer).toBe('shared');
+        (0, vitest_1.expect)(result.subdir).toBe('ui');
+    });
+    (0, vitest_1.it)('classifies "utils" as shared', () => {
+        const result = (0, index_1.classifyDir)('utils');
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result.layer).toBe('shared');
+    });
+    (0, vitest_1.it)('classifies "pages" as pages', () => {
+        const result = (0, index_1.classifyDir)('pages');
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result.layer).toBe('pages');
+    });
+    (0, vitest_1.it)('classifies "views" as pages', () => {
+        const result = (0, index_1.classifyDir)('views');
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result.layer).toBe('pages');
+    });
+    (0, vitest_1.it)('classifies "store" as app', () => {
+        const result = (0, index_1.classifyDir)('store');
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result.layer).toBe('app');
+    });
+    (0, vitest_1.it)('classifies "api" as shared/api', () => {
+        const result = (0, index_1.classifyDir)('api');
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result.layer).toBe('shared');
+        (0, vitest_1.expect)(result.subdir).toBe('api');
+    });
+    (0, vitest_1.it)('classifies "hooks" as shared/hooks', () => {
+        const result = (0, index_1.classifyDir)('hooks');
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result.layer).toBe('shared');
+        (0, vitest_1.expect)(result.subdir).toBe('hooks');
+    });
+    (0, vitest_1.it)('returns null for unrecognised directory', () => {
+        (0, vitest_1.expect)((0, index_1.classifyDir)('my-weird-custom-dir')).toBeNull();
+    });
+});
+// ---------------------------------------------------------------------------
+// buildMigrationPlan — FSD target
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('buildMigrationPlan → fsd', () => {
+    (0, vitest_1.it)('proposes moves for standard React project structure', () => {
+        mkdir('components');
+        mkdir('pages');
+        mkdir('utils');
+        mkdir('api');
+        mkdir('hooks');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'fsd');
+        // pages is already an FSD layer — should be skipped
+        const froms = plan.proposals.map((p) => p.from);
+        (0, vitest_1.expect)(froms).not.toContain('pages');
+        // components, utils, api, hooks should get proposals
+        (0, vitest_1.expect)(froms).toContain('components');
+        (0, vitest_1.expect)(froms).toContain('utils');
+        (0, vitest_1.expect)(froms).toContain('api');
+        (0, vitest_1.expect)(froms).toContain('hooks');
+    });
+    (0, vitest_1.it)('skips directories already in correct FSD layers', () => {
+        mkdir('features');
+        mkdir('entities');
+        mkdir('shared');
+        mkdir('widgets');
+        mkdir('pages');
+        mkdir('app');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(plan.proposals).toHaveLength(0);
+    });
+    (0, vitest_1.it)('puts unrecognised dirs in unknownFiles', () => {
+        mkdir('super-weird-module');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(plan.unknownFiles).toContain('super-weird-module');
+        (0, vitest_1.expect)(plan.proposals).toHaveLength(0);
+    });
+    (0, vitest_1.it)('proposal has correct from/to/reason shape', () => {
+        mkdir('components');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'fsd');
+        const proposal = plan.proposals.find((p) => p.from === 'components');
+        (0, vitest_1.expect)(proposal).toBeDefined();
+        (0, vitest_1.expect)(proposal.to).toContain('shared');
+        (0, vitest_1.expect)(proposal.to).toContain('ui');
+        (0, vitest_1.expect)(proposal.reason).toContain('shared');
+    });
+    (0, vitest_1.it)('summary reflects proposal count', () => {
+        mkdir('components');
+        mkdir('utils');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(plan.summary).toMatch(/\d+ director/);
+    });
+    (0, vitest_1.it)('summary says no changes when already FSD', () => {
+        mkdir('features');
+        mkdir('shared');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'fsd');
+        (0, vitest_1.expect)(plan.summary).toContain('No changes needed');
+    });
+});
+// ---------------------------------------------------------------------------
+// buildMigrationPlan — modular target
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)('buildMigrationPlan → modular', () => {
+    (0, vitest_1.it)('wraps unknown dirs as modules/', () => {
+        mkdir('auth');
+        mkdir('cart');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'modular');
+        const froms = plan.proposals.map((p) => p.from);
+        (0, vitest_1.expect)(froms).toContain('auth');
+        (0, vitest_1.expect)(froms).toContain('cart');
+        const authProp = plan.proposals.find((p) => p.from === 'auth');
+        (0, vitest_1.expect)(authProp.to).toMatch(/^modules/);
+    });
+    (0, vitest_1.it)('puts utils-like dirs under shared/', () => {
+        mkdir('utils');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'modular');
+        const utilsProp = plan.proposals.find((p) => p.from === 'utils');
+        (0, vitest_1.expect)(utilsProp.to).toMatch(/^shared/);
+    });
+    (0, vitest_1.it)('skips already-correct modular dirs', () => {
+        mkdir('modules');
+        mkdir('shared');
+        mkdir('core');
+        const plan = (0, index_1.buildMigrationPlan)(tmpDir, 'modular');
+        (0, vitest_1.expect)(plan.proposals).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=migrate.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.test.js","sourceRoot":"","sources":["../../../src/commands/migrate/migrate.test.ts"],"names":[],"mappings":";;;;;AAAA,sDAAwB;AACxB,0DAA4B;AAE5B,wDAAyB;AACzB,mCAAoE;AAEpE,mCAA2E;AAE3E,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,IAAI,MAAc,CAAA;AAElB,SAAS,KAAK,CAAC,OAAe;IAC5B,kBAAE,CAAC,aAAa,CAAC,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,IAAA,mBAAU,EAAC,GAAG,EAAE;IACd,MAAM,GAAG,kBAAE,CAAC,WAAW,CAAC,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;AAChE,CAAC,CAAC,CAAA;AAEF,IAAA,kBAAS,EAAC,GAAG,EAAE;IACb,kBAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;AACvB,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,KAAK,CAAC,YAAY,CAAC,CAAA;QACnB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,kBAAE,CAAC,aAAa,CAAC,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAA;QAEnD,MAAM,IAAI,GAAG,IAAA,wBAAgB,EAAC,MAAM,CAAC,CAAA;QACrC,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACpC,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAC/B,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,IAAA,eAAM,EAAC,IAAA,wBAAgB,EAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,IAAA,eAAM,EAAC,IAAA,wBAAgB,EAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAA,WAAE,EAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,YAAY,CAAC,CAAA;QACxC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,IAAA,eAAM,EAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACpC,IAAA,eAAM,EAAC,MAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAA;QACnC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,IAAA,eAAM,EAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAA;QACnC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,IAAA,eAAM,EAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAA;QACnC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,IAAA,eAAM,EAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAA;QACnC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,IAAA,eAAM,EAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,KAAK,CAAC,CAAA;QACjC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,IAAA,eAAM,EAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACpC,IAAA,eAAM,EAAC,MAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAA;QACnC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,IAAA,eAAM,EAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACpC,IAAA,eAAM,EAAC,MAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,IAAA,eAAM,EAAC,IAAA,mBAAW,EAAC,qBAAqB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACvD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAA,WAAE,EAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,KAAK,CAAC,YAAY,CAAC,CAAA;QACnB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,KAAK,CAAC,KAAK,CAAC,CAAA;QACZ,KAAK,CAAC,OAAO,CAAC,CAAA;QAEd,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAE9C,oDAAoD;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC/C,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAEpC,qDAAqD;QACrD,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;QACrC,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAChC,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,KAAK,CAAC,QAAQ,CAAC,CAAA;QACf,KAAK,CAAC,SAAS,CAAC,CAAA;QAChB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,KAAK,CAAC,KAAK,CAAC,CAAA;QAEZ,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC9C,IAAA,eAAM,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,KAAK,CAAC,oBAAoB,CAAC,CAAA;QAE3B,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC9C,IAAA,eAAM,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;QACzD,IAAA,eAAM,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,KAAK,CAAC,YAAY,CAAC,CAAA;QAEnB,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAE,CAAA;QAErE,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC9B,IAAA,eAAM,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAA,eAAM,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACnC,IAAA,eAAM,EAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,KAAK,CAAC,YAAY,CAAC,CAAA;QACnB,KAAK,CAAC,OAAO,CAAC,CAAA;QAEd,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC9C,IAAA,eAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,KAAK,CAAC,QAAQ,CAAC,CAAA;QAEf,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC9C,IAAA,eAAM,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,IAAA,iBAAQ,EAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,IAAA,WAAE,EAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,KAAK,CAAC,MAAM,CAAC,CAAA;QAEb,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC/C,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC/B,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAE,CAAA;QAC/D,IAAA,eAAM,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAA;QAEd,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAE,CAAA;QACjE,IAAA,eAAM,EAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,KAAK,CAAC,SAAS,CAAC,CAAA;QAChB,KAAK,CAAC,QAAQ,CAAC,CAAA;QACf,KAAK,CAAC,MAAM,CAAC,CAAA;QAEb,MAAM,IAAI,GAAG,IAAA,0BAAkB,EAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAClD,IAAA,eAAM,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/commands/migrate/plan-builder.d.ts

@@ -0,0 +1,27 @@
+import type { Architecture } from '../../types/folder-tree';
+export interface FileMoveProposal {
+    /** Current directory name relative to srcDir */
+    from: string;
+    /** Proposed path relative to srcDir */
+    to: string;
+    /** Human-readable reason for the move */
+    reason: string;
+}
+export interface MigrationPlan {
+    targetArchitecture: Architecture;
+    sourceDir: string;
+    proposals: FileMoveProposal[];
+    /** Directories that didn't match any known pattern — need manual review */
+    unknownFiles: string[];
+    summary: string;
+}
+/**
+ * Returns the names of top-level directories inside srcPath.
+ * Files at the root level are intentionally ignored.
+ */
+export declare function scanTopLevelDirs(srcPath: string): string[];
+/**
+ * Builds a migration plan by analysing top-level directories in srcPath.
+ * Pure function — no filesystem writes, safe to call at any time.
+ */
+export declare function buildMigrationPlan(srcPath: string, targetArch: Architecture): MigrationPlan;

package/dist/commands/migrate/plan-builder.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanTopLevelDirs = scanTopLevelDirs;
+exports.buildMigrationPlan = buildMigrationPlan;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const classifier_1 = require("./classifier");
+// ---------------------------------------------------------------------------
+// Directory scanner
+// ---------------------------------------------------------------------------
+/**
+ * Returns the names of top-level directories inside srcPath.
+ * Files at the root level are intentionally ignored.
+ */
+function scanTopLevelDirs(srcPath) {
+    if (!fs_extra_1.default.existsSync(srcPath))
+        return [];
+    return fs_extra_1.default
+        .readdirSync(srcPath, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+}
+// ---------------------------------------------------------------------------
+// Plan builder
+// ---------------------------------------------------------------------------
+const FSD_LAYERS = new Set([
+    'app', 'processes', 'pages', 'widgets', 'features', 'entities', 'shared',
+]);
+const MODULAR_BASE = new Set(['modules', 'shared', 'core']);
+function buildFsdProposals(dirs) {
+    const proposals = [];
+    const unknownFiles = [];
+    for (const dir of dirs) {
+        if (FSD_LAYERS.has(dir))
+            continue; // already correct
+        const classification = (0, classifier_1.classifyDir)(dir);
+        if (!classification) {
+            unknownFiles.push(dir);
+            continue;
+        }
+        const { layer, subdir } = classification;
+        const to = subdir ? node_path_1.default.join(layer, subdir, dir) : node_path_1.default.join(layer, dir);
+        proposals.push({
+            from: dir,
+            to,
+            reason: `"${dir}" maps to FSD layer "${layer}"${subdir ? `/${subdir}` : ''}`,
+        });
+    }
+    return { proposals, unknownFiles };
+}
+function buildModularProposals(dirs) {
+    const proposals = [];
+    for (const dir of dirs) {
+        if (MODULAR_BASE.has(dir))
+            continue;
+        const classification = (0, classifier_1.classifyDir)(dir);
+        const isSharedCandidate = classification?.layer === 'shared' &&
+            !['api', 'services'].includes(dir.toLowerCase());
+        if (isSharedCandidate) {
+            proposals.push({
+                from: dir,
+                to: node_path_1.default.join('shared', dir),
+                reason: `"${dir}" is a shared utility/UI — belongs under shared/`,
+            });
+        }
+        else {
+            proposals.push({
+                from: dir,
+                to: node_path_1.default.join('modules', dir),
+                reason: `"${dir}" is a feature domain — wrap as a module`,
+            });
+        }
+    }
+    return proposals;
+}
+function buildSummary(proposals, unknownFiles, target) {
+    if (proposals.length === 0 && unknownFiles.length === 0) {
+        return `No changes needed — project already looks like ${target.toUpperCase()}.`;
+    }
+    const moved = proposals.length;
+    const unknown = unknownFiles.length;
+    return (`${moved} director${moved === 1 ? 'y' : 'ies'} to move` +
+        (unknown > 0 ? `, ${unknown} unknown (manual review needed)` : '') +
+        '.');
+}
+/**
+ * Builds a migration plan by analysing top-level directories in srcPath.
+ * Pure function — no filesystem writes, safe to call at any time.
+ */
+function buildMigrationPlan(srcPath, targetArch) {
+    const dirs = scanTopLevelDirs(srcPath);
+    const { proposals, unknownFiles } = targetArch === 'fsd'
+        ? buildFsdProposals(dirs)
+        : { proposals: buildModularProposals(dirs), unknownFiles: [] };
+    return {
+        targetArchitecture: targetArch,
+        sourceDir: srcPath,
+        proposals,
+        unknownFiles,
+        summary: buildSummary(proposals, unknownFiles, targetArch),
+    };
+}
+//# sourceMappingURL=plan-builder.js.map

package/dist/commands/migrate/plan-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-builder.js","sourceRoot":"","sources":["../../../src/commands/migrate/plan-builder.ts"],"names":[],"mappings":";;;;;AAsCA,4CAOC;AA2FD,gDAkBC;AA1JD,0DAA4B;AAE5B,wDAAyB;AAIzB,6CAA0C;AAwB1C,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,IAAI,CAAC,kBAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IAEtC,OAAO,kBAAE;SACN,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ;CACzE,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;AAE3D,SAAS,iBAAiB,CACxB,IAAc;IAEd,MAAM,SAAS,GAAuB,EAAE,CAAA;IACxC,MAAM,YAAY,GAAa,EAAE,CAAA;IAEjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ,CAAC,kBAAkB;QAEpD,MAAM,cAAc,GAAG,IAAA,wBAAW,EAAC,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACtB,SAAQ;QACV,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,CAAA;QACxC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,mBAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAEzE,SAAS,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,GAAG;YACT,EAAE;YACF,MAAM,EAAE,IAAI,GAAG,wBAAwB,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SAC7E,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;AACpC,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAc;IAC3C,MAAM,SAAS,GAAuB,EAAE,CAAA;IAExC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QAEnC,MAAM,cAAc,GAAG,IAAA,wBAAW,EAAC,GAAG,CAAC,CAAA;QACvC,MAAM,iBAAiB,GACrB,cAAc,EAAE,KAAK,KAAK,QAAQ;YAClC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;QAElD,IAAI,iBAAiB,EAAE,CAAC;YACtB,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,GAAG;gBACT,EAAE,EAAE,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;gBAC5B,MAAM,EAAE,IAAI,GAAG,kDAAkD;aAClE,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,GAAG;gBACT,EAAE,EAAE,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC;gBAC7B,MAAM,EAAE,IAAI,GAAG,0CAA0C;aAC1D,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,YAAY,CACnB,SAA6B,EAC7B,YAAsB,EACtB,MAAoB;IAEpB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,kDAAkD,MAAM,CAAC,WAAW,EAAE,GAAG,CAAA;IAClF,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAA;IAC9B,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAA;IACnC,OAAO,CACL,GAAG,KAAK,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU;QACvD,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,iCAAiC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CACJ,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAChC,OAAe,EACf,UAAwB;IAExB,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEtC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAC/B,UAAU,KAAK,KAAK;QAClB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAA;IAElE,OAAO;QACL,kBAAkB,EAAE,UAAU;QAC9B,SAAS,EAAE,OAAO;QAClB,SAAS;QACT,YAAY;QACZ,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC;KAC3D,CAAA;AACH,CAAC"}

package/dist/commands/migrate/printer.d.ts

@@ -0,0 +1,6 @@
+import type { MigrationPlan } from './plan-builder';
+/**
+ * Renders a MigrationPlan as colour-coded CLI output.
+ * Pure function — receives the plan, writes to stdout.
+ */
+export declare function printMigrationPlan(plan: MigrationPlan): void;

package/dist/commands/migrate/printer.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printMigrationPlan = printMigrationPlan;
+const node_path_1 = __importDefault(require("node:path"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Renders a MigrationPlan as colour-coded CLI output.
+ * Pure function — receives the plan, writes to stdout.
+ */
+function printMigrationPlan(plan) {
+    const { proposals, unknownFiles, summary, targetArchitecture, sourceDir } = plan;
+    const rel = node_path_1.default.relative(process.cwd(), sourceDir) || '.';
+    console.log(chalk_1.default.bold(`\n  Migration plan → ${chalk_1.default.cyan(targetArchitecture.toUpperCase())}\n`));
+    console.log(chalk_1.default.gray(`  Analysed: ${rel}\n`));
+    console.log(chalk_1.default.gray(`  ${'─'.repeat(58)}`));
+    if (proposals.length === 0 && unknownFiles.length === 0) {
+        console.log(chalk_1.default.green(`\n  ✓ ${summary}\n`));
+        return;
+    }
+    if (proposals.length > 0) {
+        console.log(chalk_1.default.bold(`\n  Proposed moves (${proposals.length}):\n`));
+        for (const p of proposals) {
+            const fromFmt = chalk_1.default.yellow(p.from.padEnd(24));
+            const toFmt = chalk_1.default.green(p.to);
+            console.log(`    ${fromFmt} → ${toFmt}`);
+            console.log(chalk_1.default.gray(`      ↳ ${p.reason}`));
+        }
+    }
+    if (unknownFiles.length > 0) {
+        console.log(chalk_1.default.bold(`\n  Needs manual review (${unknownFiles.length}):\n`));
+        for (const f of unknownFiles) {
+            console.log(`    ${chalk_1.default.red('?')} ${chalk_1.default.white(f)}`);
+        }
+        console.log(chalk_1.default.gray("\n    These directories don't match known patterns."));
+        console.log(chalk_1.default.gray(`    Run ${chalk_1.default.white('component-forge explain fsd')} to understand the target structure.`));
+    }
+    console.log(chalk_1.default.gray(`\n  ${'─'.repeat(58)}`));
+    console.log(chalk_1.default.bold(`\n  Summary: ${summary}\n`));
+    console.log(chalk_1.default.yellow('  ⚠ This is a dry-run analysis — no files were moved.\n'));
+    console.log(chalk_1.default.gray("  To apply: move each directory manually or use your IDE's refactor tools.\n"));
+    console.log(chalk_1.default.gray(`  After moving, run ${chalk_1.default.white('component-forge validate')} and ${chalk_1.default.white('component-forge check')} to verify.\n`));
+}
+//# sourceMappingURL=printer.js.map

package/dist/commands/migrate/printer.js.map

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

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

@@ -0,0 +1,26 @@
+import type { Architecture } from '../../types/folder-tree';
+interface LayerRule {
+    /** Directories that MUST exist */
+    required: string[];
+    /** All allowed directories (required + optional) */
+    allowed: string[];
+}
+type Severity = 'error' | 'warning';
+export interface ValidationIssue {
+    severity: Severity;
+    message: string;
+}
+/**
+ * Checks that all required layers exist under srcDir
+ */
+export declare function checkRequiredLayers(srcPath: string, rule: LayerRule, srcDir: string): ValidationIssue[];
+/**
+ * Checks that no unknown (forbidden) directories exist directly under srcDir
+ */
+export declare function checkUnknownLayers(srcPath: string, rule: LayerRule, architecture: Architecture, srcDir: string): ValidationIssue[];
+/**
+ * Checks each slice for a public API index.ts file
+ */
+export declare function checkPublicApiFiles(srcPath: string, rule: LayerRule, srcDir: string): ValidationIssue[];
+export declare function validateCommand(): void;
+export {};

package/dist/commands/validate/index.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkRequiredLayers = checkRequiredLayers;
+exports.checkUnknownLayers = checkUnknownLayers;
+exports.checkPublicApiFiles = checkPublicApiFiles;
+exports.validateCommand = validateCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const config_1 = require("../../utils/config");
+const logger_1 = require("../../utils/logger");
+const layerRulesByArchitecture = {
+    fsd: {
+        required: ['app', 'shared'],
+        allowed: ['app', 'processes', 'pages', 'widgets', 'features', 'entities', 'shared'],
+    },
+    modular: {
+        required: ['shared', 'core'],
+        allowed: ['modules', 'shared', 'core'],
+    },
+};
+// ---------------------------------------------------------------------------
+// Validation rules — exported for unit testing
+// ---------------------------------------------------------------------------
+/**
+ * Checks that all required layers exist under srcDir
+ */
+function checkRequiredLayers(srcPath, rule, srcDir) {
+    return rule.required
+        .filter((layer) => !fs_extra_1.default.existsSync(node_path_1.default.join(srcPath, layer)))
+        .map((layer) => ({
+        severity: 'error',
+        message: `Missing required layer: ${srcDir}/${layer}`,
+    }));
+}
+/**
+ * Checks that no unknown (forbidden) directories exist directly under srcDir
+ */
+function checkUnknownLayers(srcPath, rule, architecture, srcDir) {
+    if (!fs_extra_1.default.existsSync(srcPath))
+        return [];
+    return fs_extra_1.default
+        .readdirSync(srcPath, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .filter((entry) => !rule.allowed.includes(entry.name))
+        .map((entry) => ({
+        severity: 'warning',
+        message: `"${srcDir}/${entry.name}" is not a recognised layer in ${architecture.toUpperCase()} architecture`,
+    }));
+}
+/**
+ * Checks each slice for a public API index.ts file
+ */
+function checkPublicApiFiles(srcPath, rule, srcDir) {
+    const issues = [];
+    const sliceLayers = rule.allowed.filter((l) => l !== 'app' && l !== 'shared' && l !== 'core');
+    for (const layer of sliceLayers) {
+        const layerPath = node_path_1.default.join(srcPath, layer);
+        if (!fs_extra_1.default.existsSync(layerPath))
+            continue;
+        const slices = fs_extra_1.default
+            .readdirSync(layerPath, { withFileTypes: true })
+            .filter((e) => e.isDirectory());
+        for (const slice of slices) {
+            const indexPath = node_path_1.default.join(layerPath, slice.name, 'index.ts');
+            if (!fs_extra_1.default.existsSync(indexPath)) {
+                issues.push({
+                    severity: 'warning',
+                    message: `Missing public API: ${srcDir}/${layer}/${slice.name}/index.ts`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+// ---------------------------------------------------------------------------
+// Output formatting
+// ---------------------------------------------------------------------------
+function printIssues(issues) {
+    const errors = issues.filter((i) => i.severity === 'error');
+    const warnings = issues.filter((i) => i.severity === 'warning');
+    // Print errors first — they are blocking
+    for (const issue of errors) {
+        logger_1.logger.error(issue.message);
+    }
+    for (const issue of warnings) {
+        logger_1.logger.warning(issue.message);
+    }
+    const parts = [];
+    if (errors.length > 0)
+        parts.push(`${errors.length} error(s)`);
+    if (warnings.length > 0)
+        parts.push(`${warnings.length} warning(s)`);
+    logger_1.logger.info(`Found ${parts.join(', ')}.`);
+}
+// ---------------------------------------------------------------------------
+// Command entry point
+// ---------------------------------------------------------------------------
+function validateCommand() {
+    const config = (0, config_1.loadProjectConfig)();
+    const { architecture, srcDir } = config;
+    const srcPath = node_path_1.default.join(process.cwd(), srcDir);
+    const rule = layerRulesByArchitecture[architecture];
+    logger_1.logger.info(`Validating ${architecture.toUpperCase()} architecture…`);
+    const issues = [
+        ...checkRequiredLayers(srcPath, rule, srcDir),
+        ...checkUnknownLayers(srcPath, rule, architecture, srcDir),
+        ...checkPublicApiFiles(srcPath, rule, srcDir),
+    ];
+    if (issues.length === 0) {
+        logger_1.logger.success('Architecture is valid. No issues found.');
+        return;
+    }
+    printIssues(issues);
+    const hasErrors = issues.some((i) => i.severity === 'error');
+    if (hasErrors) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/validate/validate.test.d.ts

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