@aerogel/cli 0.0.0 → 0.1.0

package/src/lib/App.ts

@@ -1,25 +1,89 @@
-import { stringToSlug } from '@noeldemartin/utils';
+import { resolve } from 'node:path';
 
-import File from '@/lib/File';
-import Log from '@/lib/Log';
-import Template from '@/lib/Template';
-import { basePath } from '@/lib/utils';
+import File from '@aerogel/cli/lib/File';
+import Log from '@aerogel/cli/lib/Log';
+import Template from '@aerogel/cli/lib/Template';
+import { packNotFound, packagePackPath, packagePath, templatePath } from '@aerogel/cli/lib/utils/paths';
+import { Editor } from '@aerogel/cli/lib/Editor';
+import { simpleGit } from 'simple-git';
+
+export interface Options {
+    local?: boolean;
+    linkedLocal?: boolean;
+}
 
 export default class App {
 
-    constructor(public name: string) {}
+    constructor(
+        protected name: string,
+        protected options: Options = {},
+    ) {}
 
-    public create(path: string): void {
+    public async create(path: string): Promise<void> {
         if (File.exists(path) && (!File.isDirectory(path) || !File.isEmptyDirectory(path))) {
             Log.fail(`Folder at '${path}' already exists!`);
         }
 
-        Template.instantiate(basePath('templates/app'), path, {
-            app: {
-                name: this.name,
-                slug: stringToSlug(this.name),
-            },
+        // Clone repository
+        await simpleGit().clone('https://github.com/NoelDeMartin/aerogel-template.git', path, {
+            '--depth': 1,
         });
+
+        File.delete(resolve(path, '.git'));
+
+        // Apply replacements
+        const dependencies = this.getDependencies();
+
+        File.replace(
+            resolve(path, 'vite.config.ts'),
+            'Aerogel({ name: \'Aerogel\' })',
+            `Aerogel({ name: '${this.name}' })`,
+        );
+
+        File.replace(resolve(path, 'src/lang/en.yaml'), 'title: \'App\'', `title: '${this.name}'`);
+
+        for (const [name, version] of Object.entries(dependencies)) {
+            File.replace(resolve(path, 'package.json'), new RegExp(`"${name}": ".*?"`, 'g'), `"${name}": "${version}"`);
+        }
+
+        // Copy template
+        Template.instantiate(templatePath('app'), path, { app: { name: this.name } });
+    }
+
+    public edit(): Editor {
+        return new Editor();
+    }
+
+    protected getDependencies(): Record<string, string> {
+        const withFilePrefix = <T extends Record<string, string>>(paths: T) =>
+            Object.entries(paths).reduce(
+                (pathsWithFile, [name, path]) => Object.assign(pathsWithFile, { [name]: `file:${path}` }) as T,
+                {} as T,
+            );
+
+        if (this.options.linkedLocal) {
+            return withFilePrefix({
+                '@aerogel/cli': packagePath('cli'),
+                '@aerogel/core': packagePath('core'),
+                '@aerogel/cypress': packagePath('cypress'),
+                '@aerogel/plugin-i18n': packagePath('plugin-i18n'),
+                '@aerogel/plugin-soukai': packagePath('plugin-soukai'),
+                '@aerogel/vite': packagePath('vite'),
+            });
+        }
+
+        if (this.options.local) {
+            return withFilePrefix({
+                '@aerogel/cli': packagePackPath('cli') ?? packNotFound('cli'),
+                '@aerogel/core': packagePackPath('core') ?? packNotFound('core'),
+                '@aerogel/cypress': packagePackPath('cypress') ?? packNotFound('cypress'),
+                '@aerogel/plugin-i18n': packagePackPath('plugin-i18n') ?? packNotFound('plugin-i18n'),
+                '@aerogel/plugin-soukai': packagePackPath('plugin-soukai') ?? packNotFound('plugin-soukai'),
+                '@aerogel/vite': packagePackPath('vite') ?? packNotFound('vite'),
+            });
+        }
+
+        return {};
     }
 
 }

package/src/lib/Editor.ts

@@ -0,0 +1,57 @@
+import { arrayFrom } from '@noeldemartin/utils';
+import { Project } from 'ts-morph';
+import type { SourceFile } from 'ts-morph';
+
+import File from '@aerogel/cli/lib/File';
+import Log from '@aerogel/cli/lib/Log';
+import Shell from '@aerogel/cli/lib/Shell';
+
+export class Editor {
+
+    private project: Project;
+    private modifiedFiles: Set<string>;
+
+    constructor() {
+        this.project = new Project({ tsConfigFilePath: 'tsconfig.json' });
+        this.modifiedFiles = new Set();
+
+        this.project.addSourceFilesAtPaths('src/**/*.ts');
+        this.project.addSourceFilesAtPaths('vite.config.ts');
+        this.project.addSourceFilesAtPaths('package.json');
+    }
+
+    public addSourceFile(path: string): void {
+        this.project.addSourceFilesAtPaths(path);
+    }
+
+    public requireSourceFile(path: string): SourceFile {
+        return this.project.getSourceFileOrThrow(path);
+    }
+
+    public async format(): Promise<void> {
+        await Log.animate('Formatting modified files', async () => {
+            const usingPrettier = File.exists('prettier.config.js') || File.contains('package.json', '"prettier": {');
+            const usingESLint = File.exists('.eslintrc.js') || File.contains('package.json', '"eslintConfig"');
+            const usingPrettierESLint = File.contains('package.json', '"prettier-eslint-cli"');
+            const formatFile = usingPrettierESLint
+                ? (file: string) => Shell.run(`npx prettier-eslint ${file} --write`)
+                : async (file: string) => {
+                    usingPrettier && (await Shell.run(`npx prettier ${file} --write`));
+                    file.match(/\.(ts|js|vue)$/) && usingESLint && (await Shell.run(`npx eslint ${file} --fix`));
+                };
+
+            await Promise.all(arrayFrom(this.modifiedFiles).map(async (file) => formatFile(file)));
+        });
+    }
+
+    public async save(file: SourceFile): Promise<void> {
+        await file.save();
+
+        this.addModifiedFile(file.getFilePath());
+    }
+
+    public addModifiedFile(path: string): void {
+        this.modifiedFiles.add(path);
+    }
+
+}

package/src/lib/File.mock.ts

@@ -8,28 +8,34 @@ export class FileMockService extends FileService {
 
     private virtualFilesystem: Record<string, string | { directory: true }> = {};
 
-    public exists(path: string): boolean {
+    public override delete(path: string): void {
+        if (path in this.virtualFilesystem) {
+            delete this.virtualFilesystem[path];
+        }
+    }
+
+    public override exists(path: string): boolean {
         return super.exists(path) || path in this.virtualFilesystem;
     }
 
-    public isDirectory(path: string): boolean {
+    public override isDirectory(path: string): boolean {
         return (
             super.isDirectory(path) ||
             (path in this.virtualFilesystem && typeof this.virtualFilesystem[path] === 'object')
         );
     }
 
-    public isFile(path: string): boolean {
+    public override isFile(path: string): boolean {
         return (
             super.isFile(path) || (path in this.virtualFilesystem && typeof this.virtualFilesystem[path] === 'string')
         );
     }
 
-    public makeDirectory(path: string): void {
+    public override makeDirectory(path: string): void {
         this.virtualFilesystem[path] = { directory: true };
     }
 
-    public read(path: string): string | null {
+    public override read(path: string): string | null {
         if (path in this.virtualFilesystem && typeof this.virtualFilesystem[path] === 'string') {
             return this.virtualFilesystem[path] as string;
         }
@@ -37,14 +43,10 @@ export class FileMockService extends FileService {
         return super.read(path);
     }
 
-    public write(path: string, contents: string): void {
+    public override write(path: string, contents: string): void {
         this.virtualFilesystem[path] = contents;
     }
 
-    public reset(): void {
-        this.virtualFilesystem = {};
-    }
-
     public expectCreated(path: string, expectContent?: (contents: string) => void): Assertion<string> {
         expect(typeof this.virtualFilesystem[path] === 'string', `expected '${path}' file to have been created`).toBe(
             true,
@@ -63,4 +65,4 @@ export class FileMockService extends FileService {
 
 }
 
-export default facade(new FileMockService());
+export default facade(FileMockService);

package/src/lib/File.ts

@@ -1,13 +1,43 @@
-import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'fs';
+import {
+    existsSync,
+    lstatSync,
+    mkdirSync,
+    readFileSync,
+    readdirSync,
+    rmSync,
+    unlinkSync,
+    writeFileSync,
+} from 'node:fs';
+import { dirname, resolve } from 'node:path';
+
 import { facade } from '@noeldemartin/utils';
-import { dirname, resolve } from 'path';
 
 export class FileService {
 
+    public contains(path: string, contents: string): boolean {
+        return !!this.read(path)?.includes(contents);
+    }
+
     public exists(path: string): boolean {
         return existsSync(path);
     }
 
+    public delete(path: string): void {
+        if (this.isDirectory(path)) {
+            rmSync(path, { recursive: true });
+
+            return;
+        }
+
+        unlinkSync(path);
+    }
+
+    public isSymlink(path: string): boolean {
+        const stats = lstatSync(path);
+
+        return stats.isSymbolicLink();
+    }
+
     public read(path: string): string | null {
         if (!this.isFile(path)) {
             return null;
@@ -16,6 +46,16 @@ export class FileService {
         return readFileSync(path).toString();
     }
 
+    public replace(path: string, search: string | RegExp, replacement: string): void {
+        const contents = this.read(path);
+
+        if (!contents) {
+            return;
+        }
+
+        this.write(path, contents.replaceAll(search, replacement));
+    }
+
     public getFiles(directoryPath: string): string[] {
         const children = readdirSync(directoryPath, { withFileTypes: true });
         const files: string[] = [];
@@ -63,4 +103,4 @@ export class FileService {
 
 }
 
-export default facade(new FileService());
+export default facade(FileService);

package/src/lib/Log.mock.ts

@@ -1,5 +1,5 @@
 import { expect } from 'vitest';
-import { arrayFrom, facade } from '@noeldemartin/utils';
+import { facade } from '@noeldemartin/utils';
 
 import { LogService } from './Log';
 
@@ -11,18 +11,23 @@ export class LogServiceMock extends LogService {
         expect(this.logs, `Expected message "${message}" to have been logged`).toContain(message);
     }
 
-    protected log(messages: string | string[]): void {
-        this.logs.push(...arrayFrom(messages));
+    public expectLogLength(count: number): void {
+        expect(this.logs, `Expected log to have length ${count}`).toHaveLength(count);
     }
 
-    public fail(message: string): void {
+    protected override logLine(message: string): void {
+        this.logs.push(message);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    public override fail<T = any>(message: string): T {
         throw new Error(`Fail: ${message}`);
     }
 
-    protected stdout(): void {
+    protected override stdout(): void {
         //
     }
 
 }
 
-export default facade(new LogServiceMock());
+export default facade(LogServiceMock);

package/src/lib/Log.test.ts

@@ -1,21 +1,37 @@
-import { bold, hex } from 'chalk';
+import chalk from 'chalk';
 import { describe, it } from 'vitest';
 
-import LogMock from '@/lib/Log.mock';
+import LogMock from '@aerogel/cli/lib/Log.mock';
 
 import Log from './Log';
 
+const info = chalk.hex('#00ffff');
+
 describe('Log', () => {
 
     it('renders markdown bold', () => {
-        // Arrange
-        const info = hex('#00ffff');
-
         // Act
         Log.info('Foo **bar**');
 
         // Assert
-        LogMock.expectLogged(info(`Foo ${bold('bar')}`));
+        LogMock.expectLogged(info(`Foo ${chalk.bold('bar')}`));
+    });
+
+    it('renders multiline messages', () => {
+        // Act
+        Log.info(`
+            This is multiline,
+                but the indentation should be respected.
+
+            As well as the new lines.
+        `);
+
+        // Assert
+        LogMock.expectLogLength(4);
+        LogMock.expectLogged(info('This is multiline,'));
+        LogMock.expectLogged(info('    but the indentation should be respected.'));
+        LogMock.expectLogged(info(''));
+        LogMock.expectLogged(info('As well as the new lines.'));
     });
 
 });

package/src/lib/Log.ts

@@ -1,16 +1,17 @@
-import { arrayFrom, facade, stringMatchAll } from '@noeldemartin/utils';
-import { bold, hex } from 'chalk';
-import { clearLine, cursorTo } from 'readline';
+import chalk from 'chalk';
+import { clearLine, cursorTo } from 'node:readline';
+import { facade, stringMatchAll } from '@noeldemartin/utils';
 
 export class LogService {
 
-    protected renderInfo = hex('#00ffff');
-    protected renderSuccess = hex('#00ff00');
-    protected renderError = hex('#ff0000');
+    protected renderInfo = chalk.hex('#00ffff');
+    protected renderSuccess = chalk.hex('#00ff00');
+    protected renderError = chalk.hex('#ff0000');
 
     public async animate<T>(message: string, operation: () => Promise<T>): Promise<T> {
-        const updateStdout = (end: string = '') => {
-            const progress = this.renderInfo(this.renderMarkdown(message) + '.'.repeat(frame % 4)) + end;
+        const updateStdout = (end: string = '', done: boolean = false) => {
+            const progress =
+                this.renderInfo(this.renderMarkdown(message) + (done ? '...' : '.'.repeat(frame % 4))) + end;
 
             this.stdout(progress);
         };
@@ -23,48 +24,63 @@ export class LogService {
         const result = await operation();
 
         clearInterval(interval);
-        updateStdout('\n');
+        updateStdout('\n', true);
 
         return result;
     }
 
-    public info(messages: string | string[]): void {
-        arrayFrom(messages).forEach((message) => {
-            this.log(this.renderInfo(this.renderMarkdown(message)));
-        });
+    public info(message: string): void {
+        this.log(this.renderMarkdown(message), this.renderInfo);
     }
 
-    public error(messages: string | string[]): void {
-        arrayFrom(messages).forEach((message) => {
-            this.log(this.renderError(this.renderMarkdown(message)));
-        });
+    public error(message: string): void {
+        this.log(this.renderMarkdown(message), this.renderError);
     }
 
-    public fail(messages: string | string[]): void {
-        this.error(messages);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    public fail<T = any>(message: string): T {
+        this.error(message);
 
         process.exit(1);
     }
 
-    public success(messages: string | string[]): void {
-        arrayFrom(messages).forEach((message) => {
-            this.log(this.renderSuccess(this.renderMarkdown(message)));
-        });
+    public success(message: string): void {
+        this.log(this.renderMarkdown(message), this.renderSuccess);
     }
 
     protected renderMarkdown(message: string): string {
         const matches = stringMatchAll<2>(message, /\*\*(.*)\*\*/g);
 
         for (const match of matches) {
-            message = message.replace(match[0], bold(match[1]));
+            message = message.replace(match[0], chalk.bold(match[1]));
         }
 
         return message;
     }
 
-    protected log(messages: string | string[]): void {
+    protected log(message: string, formatMessage?: (message: string) => string): void {
+        this.formatMessage(message).forEach((line) => {
+            this.logLine(formatMessage ? formatMessage(line) : line);
+        });
+    }
+
+    protected formatMessage(message: string): string[] {
+        if (message[0] === '\n') {
+            message = message.slice(1).trimEnd();
+
+            const lines = message.split('\n');
+            const firstLetter = message.trim()[0] ?? '';
+            const indentation = lines.find((line) => line.trim().length > 0)?.indexOf(firstLetter) ?? 0;
+
+            return lines.map((line) => line.slice(indentation));
+        }
+
+        return [message];
+    }
+
+    protected logLine(line: string): void {
         // eslint-disable-next-line no-console
-        arrayFrom(messages).forEach((message) => console.log(message));
+        console.log(line);
     }
 
     protected stdout(message: string): void {
@@ -76,4 +92,4 @@ export class LogService {
 
 }
 
-export default facade(new LogService());
+export default facade(LogService);

package/src/lib/Shell.mock.ts

@@ -7,14 +7,18 @@ export class ShellServiceMock extends ShellService {
 
     private history: string[] = [];
 
-    public async run(command: string): Promise<void> {
-        this.history.push(command);
+    public override async run(command: string): Promise<void> {
+        this.history.push(command.trim());
     }
 
     public expectRan(command: string): void {
         expect(this.history, `expected '${command}' command to have been executed`).toContain(command);
     }
 
+    public expectNotRan(command: string): void {
+        expect(this.history, `expected '${command}' command to not have been executed`).not.toContain(command);
+    }
+
 }
 
-export default facade(new ShellServiceMock());
+export default facade(ShellServiceMock);

package/src/lib/Shell.ts

@@ -1,4 +1,4 @@
-import { exec } from 'child_process';
+import { exec } from 'node:child_process';
 import { facade } from '@noeldemartin/utils';
 
 export class ShellService {
@@ -25,4 +25,4 @@ export class ShellService {
 
 }
 
-export default facade(new ShellService());
+export default facade(ShellService);

package/src/lib/Template.ts

@@ -1,12 +1,16 @@
-import { readFileSync } from 'fs';
-import { render } from 'mustache';
+import Mustache from 'mustache';
+import { readFileSync } from 'node:fs';
 import { toString } from '@noeldemartin/utils';
 
-import File from '@/lib/File';
+import File from '@aerogel/cli/lib/File';
 
 export default class Template {
 
-    public static instantiate(path: string, destination: string, replacements: Record<string, unknown>): string[] {
+    public static instantiate(
+        path: string,
+        destination: string = './',
+        replacements: Record<string, unknown> = {},
+    ): string[] {
         const template = new Template(path);
 
         return template.instantiate(destination, replacements);
@@ -25,10 +29,11 @@ export default class Template {
                 file.substring(this.path.length + 1),
             );
             const fileContents = readFileSync(file).toString();
+            const filePath =
+                destination + (relativePath.endsWith('.template') ? relativePath.slice(0, -9) : relativePath);
 
-            File.write(destination + relativePath, render(fileContents, replacements, undefined, ['<%', '%>']));
-
-            files.push(destination + relativePath);
+            File.write(filePath, Mustache.render(fileContents, replacements, undefined, ['<%', '%>']));
+            files.push(filePath);
         }
 
         return files;
@@ -38,18 +43,21 @@ export default class Template {
         replacements: Record<string, unknown>,
         prefix: string = '',
     ): Record<string, string> {
-        return Object.entries(replacements).reduce((filenameReplacements, [key, value]) => {
-            if (typeof value === 'object') {
-                Object.assign(
-                    filenameReplacements,
-                    this.getFilenameReplacements(value as Record<string, unknown>, `${key}.`),
-                );
-            } else {
-                filenameReplacements[`[${prefix}${key}]`] = toString(value);
-            }
-
-            return filenameReplacements;
-        }, {} as Record<string, string>);
+        return Object.entries(replacements).reduce(
+            (filenameReplacements, [key, value]) => {
+                if (typeof value === 'object') {
+                    Object.assign(
+                        filenameReplacements,
+                        this.getFilenameReplacements(value as Record<string, unknown>, `${key}.`),
+                    );
+                } else {
+                    filenameReplacements[`[${prefix}${key}]`] = toString(value);
+                }
+
+                return filenameReplacements;
+            },
+            {} as Record<string, string>,
+        );
     }
 
 }

package/src/lib/utils/app.ts

@@ -0,0 +1,15 @@
+import App from '@aerogel/cli/lib/App';
+import File from '@aerogel/cli/lib/File';
+
+export function app(): App {
+    // TODO parse app name
+    return new App('');
+}
+
+export function isLocalApp(): boolean {
+    return File.contains('package.json', '"@aerogel/core": "file:');
+}
+
+export function isLinkedLocalApp(): boolean {
+    return File.isSymlink('node_modules/@aerogel/core');
+}

package/src/lib/utils/edit.ts

@@ -0,0 +1,44 @@
+import { arrayFrom } from '@noeldemartin/utils';
+import type { Node, SyntaxKind } from 'ts-morph';
+
+export function editFiles(): boolean {
+    // TODO mock editor instead of relying on this for unit tests
+    return true;
+}
+
+export function findDescendant<T extends Node>(
+    node: Node | undefined,
+    options: {
+        guard?: (node: Node | undefined) => node is T;
+        validate?: (node: T) => boolean;
+        skip?: SyntaxKind | SyntaxKind[];
+    } = {},
+): T | undefined {
+    if (!node) {
+        return;
+    }
+
+    const guard = options.guard ?? (() => true);
+    const validate = options.validate ?? (() => true);
+    const skipKinds = arrayFrom(options.skip ?? []);
+
+    return node.forEachDescendant((descendant, traversal) => {
+        if (guard(descendant) && validate(descendant as T)) {
+            return descendant as T;
+        }
+
+        const descendantKind = descendant.getKind();
+
+        if (skipKinds.includes(descendantKind)) {
+            traversal.skip();
+        }
+    });
+}
+
+export function when<T extends Node>(node: Node | undefined, assertion: (node: Node) => node is T): T | undefined {
+    if (!node || !assertion(node)) {
+        return;
+    }
+
+    return node as T;
+}