refactor: 改用 TypeScript

Author: lc-soft

.gitignore

@@ -66,4 +66,5 @@ test/fixtures/*/project
 lib/app-plugin
 *.d.ts
 .lcui
-build
+build
+lib

lib/compiler/xml-loader.js

@@ -35,7 +35,7 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "sass": "^1.64.2",
-    "simple-git": "^3.3.0",
+    "simple-git": "^3.25.0",
     "typescript": "^5.4.5",
     "winston": "^3.10.0",
     "xml-js": "^1.6.11",

lib/compiler/yaml-loader.js

@@ -1,13 +1,15 @@
 import { createHash } from "crypto";
 import path from "path";
+import { LoaderContext, ModuleMetadata } from "../types.js";
 
 /**
- * @param {LoaderContext} loaderContext
- * @param {string} name
- * @returns {string}
  * @see https://github.com/webpack/loader-utils/blob/master/lib/interpolateName.js
  */
-function interpolateName(loaderContext, name, content) {
+function interpolateName(
+  loaderContext: LoaderContext,
+  name: string | ((p: string) => string),
+  content: string
+) {
   let filename;
 
   if (typeof name === "function") {
@@ -66,17 +68,13 @@ function interpolateName(loaderContext, name, content) {
     .replace(/\[folder\]/gi, () => folder);
 }
 
-/**
- *
- * @param {*} resourcePath
- * @param {*} outputPath
- */
-function generateMetadata(resourcePath, outputPath) {
-  /** @type {ModuleMetadata} */
-  const metadata = {
+function generateMetadata(resourcePath: string, outputPath: string) {
+  const metadata: ModuleMetadata = {
     type: "asset",
     path: resourcePath,
     outputPath: outputPath,
+    headerFiles: [],
+    initCode: "",
   };
 
   if (/\.(ttf|woff|woff2)$/i.test(resourcePath)) {

lib/types.d.ts

@@ -11,6 +11,7 @@ import XMLLoader from "./xml-loader.js";
 import YAMLLoader from "./yaml-loader.js";
 import JSONLoader from "./json-loader.js";
 import { resolveRootDir } from "../utils.js";
+import { CompilerOptions, Loader, LoaderOptions, LoaderRule, ModuleRuleUseConfig } from "../types.js";
 
 /** @type {Record<string, Loader>} */
 const loaderMap = {
@@ -43,12 +44,8 @@ function getDirs() {
   };
 }
 
-/**
- * 确定加载器配置
- * @param {ModuleRuleUseConfig} config
- */
-function resolveLoaders(config) {
-  let loaders;
+function resolveLoaders(config: ModuleRuleUseConfig) {
+  let loaders: (LoaderRule | string)[];
 
   if (typeof config === "string") {
     loaders = [{ loader: config, options: {} }];
@@ -58,8 +55,8 @@ function resolveLoaders(config) {
     loaders = [config];
   }
   return loaders.map((item) => {
-    let loader;
-    let options = {};
+    let loader: Loader;
+    let options: LoaderOptions = {};
 
     if (typeof item === "string") {
       loader = loaderMap[item];
@@ -173,12 +170,10 @@ function createLogger(logFile, verbose) {
   });
 }
 
-/**
- * @param {string} file 文件或目录路径
- * @param {CompilerOptions} compilerOptions 编译选项
- */
-export default async function compile(file, compilerOptions) {
-  /** @type {CompilerOptions} */
+export default async function compile(
+  file: string,
+  compilerOptions: CompilerOptions
+) {
   const options = {
     ...getDirs(),
     ...compilerOptions,

lib/types.js

@@ -1,11 +1,9 @@
-import path from 'path';
-import * as sass from 'sass';
-import fs from 'fs-extra';
+import path from "path";
+import * as sass from "sass";
+import fs from "fs-extra";
+import { LoaderContext } from "../types.js";
 
-/**
- * @type {Loader}
- */
-export default function SassLoader(content) {
+export default function SassLoader(this: LoaderContext, content: string) {
   const { dir, ext } = path.parse(this.resourcePath);
   const result = sass.compileString(`${content}`, {
     importer: {