refactor: migrate typescript (#418)

Co-authored-by: yoshinorin <[email protected]>

Author: stevenjoezhang

.eslintignore

@@ -1,4 +1,5 @@
 node_modules/
 coverage/
 tmp/
-assets/
+assets/
+dist/

.eslintrc.json

@@ -1,4 +1,11 @@
 {
-  "extends": "hexo",
-  "root": true
+  "root": true,
+  "extends": "hexo/ts.js",
+  "parserOptions": {
+    "sourceType": "module",
+    "ecmaVersion": 2020
+  },
+  "rules": {
+    "@typescript-eslint/no-var-requires": 0
+  }
 }

.gitignore

@@ -5,3 +5,4 @@ tmp/
 .idea/
 .nyc_output/
 .vscode/
+dist/

lib/console/help.js renamed to lib/console/help.ts

@@ -1,9 +1,7 @@
-'use strict';
-
-const { underline, bold } = require('picocolors');
-const { readFile } = require('hexo-fs');
-const { join } = require('path');
-const Promise = require('bluebird');
+import { underline, bold } from 'picocolors';
+import { readFile } from 'hexo-fs';
+import { join } from 'path';
+import Promise from 'bluebird';
 
 const COMPLETION_DIR = join(__dirname, '../../completion');
 
@@ -115,4 +113,4 @@ function printCompletion(type) {
   });
 }
 
-module.exports = helpConsole;
+export = helpConsole;

lib/console/index.js renamed to lib/console/index.ts

@@ -1,9 +1,11 @@
-'use strict';
+import helpConsole from './help';
+import initConsole from './init';
+import versionConsole from './version';
 
-module.exports = function(ctx) {
+export = function(ctx) {
   const { console } = ctx.extend;
 
-  console.register('help', 'Get help on a command.', {}, require('./help'));
+  console.register('help', 'Get help on a command.', {}, helpConsole);
 
   console.register('init', 'Create a new Hexo folder.', {
     desc: 'Create a new Hexo folder at the specified path or the current directory.',
@@ -15,7 +17,7 @@ module.exports = function(ctx) {
       {name: '--no-clone', desc: 'Copy files instead of cloning from GitHub'},
       {name: '--no-install', desc: 'Skip npm install'}
     ]
-  }, require('./init'));
+  }, initConsole);
 
-  console.register('version', 'Display version information.', {}, require('./version'));
+  console.register('version', 'Display version information.', {}, versionConsole);
 };

lib/console/init.js renamed to lib/console/init.ts

@@ -1,12 +1,10 @@
-'use strict';
-
-const Promise = require('bluebird');
-const { join, resolve } = require('path');
-const { magenta } = require('picocolors');
-const { existsSync, readdirSync, rmdir, unlink, copyDir, readdir, stat } = require('hexo-fs');
-const tildify = require('tildify');
-const { spawn } = require('hexo-util');
-const commandExistsSync = require('command-exists').sync;
+import BlueBirdPromise from 'bluebird';
+import { join, resolve } from 'path';
+import { magenta } from 'picocolors';
+import { existsSync, readdirSync, rmdir, unlink, copyDir, readdir, stat } from 'hexo-fs';
+import tildify from 'tildify';
+import { spawn } from 'hexo-util';
+import { sync as commandExistsSync } from 'command-exists';
 
 const ASSET_DIR = join(__dirname, '../../assets');
 const GIT_REPO_URL = 'https://github.com/hexojs/hexo-starter.git';
@@ -20,7 +18,7 @@ async function initConsole(args) {
 
   if (existsSync(target) && readdirSync(target).length !== 0) {
     log.fatal(`${magenta(tildify(target))} not empty, please run \`hexo init\` on an empty folder and then copy your files into it`);
-    await Promise.reject(new Error('target not empty'));
+    await BlueBirdPromise.reject(new Error('target not empty'));
   }
 
   log.info('Cloning hexo-starter', GIT_REPO_URL);
@@ -38,7 +36,7 @@ async function initConsole(args) {
     await copyAsset(target);
   }
 
-  await Promise.all([
+  await BlueBirdPromise.all([
     removeGitDir(target),
     removeGitModules(target)
   ]);
@@ -111,4 +109,4 @@ async function removeGitModules(target) {
   }
 }
 
-module.exports = initConsole;
+export = initConsole;

lib/console/version.js renamed to lib/console/version.ts

@@ -1,11 +1,9 @@
-'use strict';
-
-const os = require('os');
+import os from 'os';
 const pkg = require('../../package.json');
-const Promise = require('bluebird');
-const { spawn } = require('hexo-util');
+import BlueBirdPromise from 'bluebird';
+import { spawn } from 'hexo-util';
 
-async function versionConsole(args) {
+async function versionConsole() {
   const { versions, platform } = process;
   const keys = Object.keys(versions);
 
@@ -33,7 +31,7 @@ async function versionConsole(args) {
     console.log('%s: %s', key, versions[key]);
   }
 
-  await Promise.resolve();
+  await BlueBirdPromise.resolve();
 }
 
-module.exports = versionConsole;
+export = versionConsole;

lib/context.js renamed to lib/context.ts

@@ -1,15 +1,21 @@
-'use strict';
-
-const logger = require('hexo-log');
-const { underline } = require('picocolors');
-const { EventEmitter } = require('events');
-const Promise = require('bluebird');
-const ConsoleExtend = require('./extend/console');
+import logger from 'hexo-log';
+import { underline } from 'picocolors';
+import { EventEmitter } from 'events';
+import Promise from 'bluebird';
+import ConsoleExtend from './extend/console';
 
 // a stub Hexo object
 // see `hexojs/hexo/lib/hexo/index.js`
 
+type Callback = (err?: any, value?: any) => void;
+
 class Context extends EventEmitter {
+  base_dir: string;
+  log: logger;
+  extend: {
+    console: ConsoleExtend;
+  };
+
   constructor(base = process.cwd(), args = {}) {
     super();
     this.base_dir = base;
@@ -24,9 +30,11 @@ class Context extends EventEmitter {
     // Do nothing
   }
 
-  call(name, args, callback) {
+  call(name: string, args: object, callback: Callback);
+  call(name: string, callback?: Callback);
+  call(name: string, args?: object | Callback, callback?: Callback) {
     if (!callback && typeof args === 'function') {
-      callback = args;
+      callback = args as Callback;
       args = {};
     }
 
@@ -41,7 +49,7 @@ class Context extends EventEmitter {
     }).asCallback(callback);
   }
 
-  exit(err) {
+  exit(err?: Error) {
     if (err) {
       this.log.fatal(
         {err},
@@ -58,4 +66,4 @@ class Context extends EventEmitter {
   }
 }
 
-module.exports = Context;
+export = Context;

lib/extend/console.js renamed to lib/extend/console.ts

@@ -1,15 +1,30 @@
-'use strict';
+import Promise from 'bluebird';
+import abbrev from 'abbrev';
 
-const Promise = require('bluebird');
-const abbrev = require('abbrev');
+interface Callback {
+  (args?: object): any;
+  options?: object;
+  desc?: string;
+}
+
+interface Store {
+  [key: string]: Callback;
+}
+
+interface Alias {
+  [key: string]: string;
+}
 
 class Console {
+  store: Store;
+  alias: Alias;
+
   constructor() {
     this.store = {};
     this.alias = {};
   }
 
-  get(name) {
+  get(name: string) {
     name = name.toLowerCase();
     return this.store[this.alias[name]];
   }
@@ -18,13 +33,17 @@ class Console {
     return this.store;
   }
 
-  register(name, desc, options, fn) {
+  register(name: string, desc: string, options: object, fn: Callback): void;
+  register(name: string, options: object, fn: Callback): void;
+  register(name: string, desc: string, fn: Callback): void;
+  register(name: string, fn: Callback): void;
+  register(name: string, desc: string | object | Callback, options?: object | Callback, fn?: Callback) {
     if (!name) throw new TypeError('name is required');
 
     if (!fn) {
       if (options) {
         if (typeof options === 'function') {
-          fn = options;
+          fn = options as Callback;
 
           if (typeof desc === 'object') { // name, options, fn
             options = desc;
@@ -38,7 +57,7 @@ class Console {
       } else {
         // name, fn
         if (typeof desc === 'function') {
-          fn = desc;
+          fn = desc as Callback;
           options = {};
           desc = '';
         } else {
@@ -56,10 +75,10 @@ class Console {
     this.store[name.toLowerCase()] = fn;
     const c = fn;
     c.options = options;
-    c.desc = desc;
+    c.desc = desc as string;
 
     this.alias = abbrev(Object.keys(this.store));
   }
 }
 
-module.exports = Console;
+export = Console;

lib/find_pkg.js renamed to lib/find_pkg.ts

@@ -1,21 +1,23 @@
-'use strict';
+import { resolve, join, dirname } from 'path';
+import { readFile } from 'hexo-fs';
 
-const { resolve, join, dirname } = require('path');
-const { readFile } = require('hexo-fs');
+interface findPkgArgs {
+  cwd?: string;
+}
 
-function findPkg(cwd, args = {}) {
+function findPkg(cwd: string, args: findPkgArgs = {}) {
   if (args.cwd) {
     cwd = resolve(cwd, args.cwd);
   }
 
   return checkPkg(cwd);
 }
 
-function checkPkg(path) {
+function checkPkg(path: string) {
   const pkgPath = join(path, 'package.json');
 
   return readFile(pkgPath).then(content => {
-    const json = JSON.parse(content);
+    const json = JSON.parse(content as string);
     if (typeof json.hexo === 'object') return path;
   }).catch(err => {
     if (err && err.code === 'ENOENT') {
@@ -29,4 +31,4 @@ function checkPkg(path) {
   });
 }
 
-module.exports = findPkg;
+export = findPkg;