ranuts 0.1.0-alpha.1 → 0.1.0-alpha.3

package/src/ranpack/module.ts

@@ -1,431 +0,0 @@
-import MagicString from 'magic-string';
-import { parse } from '../astParser';
-import type { Bundle } from './bundle';
-import { Statement } from './statement';
-import type { ModuleLoader } from './moduleLoader';
-import type {
-  Declaration
-} from './ast/Declaration';
-import {
-  SyntheticDefaultDeclaration,
-  SyntheticNamespaceDeclaration
-} from './ast/Declaration';
-import { keys } from './utils/object';
-
-export interface ModuleOptions {
-  path: string;
-  bundle: Bundle;
-  loader: ModuleLoader;
-  code: string;
-  isEntry: boolean;
-}
-
-interface ImportOrExportInfo {
-  source?: string;
-  localName: string;
-  name: string;
-  statement?: Statement;
-  isDeclaration?: boolean;
-  module?: Module;
-}
-
-interface Specifier {
-  type: string;
-  local: {
-    name: string;
-  };
-  imported: {
-    name: string;
-  };
-  exported: {
-    name: string;
-  };
-}
-
-type Imports = Record<string, ImportOrExportInfo>;
-type Exports = Record<string, ImportOrExportInfo>;
-
-export class Module {
-  isEntry: boolean = false;
-  id: string;
-  path: string;
-  bundle: Bundle;
-  moduleLoader: ModuleLoader;
-  code: string;
-  magicString: MagicString;
-  statements: Statement[];
-  imports: Imports;
-  exports: Exports;
-  reexports: Exports;
-  exportAllSources: string[] = [];
-  exportAllModules: Module[] = [];
-  declarations: Record<string, Declaration>;
-  dependencies: string[] = [];
-  dependencyModules: Module[] = [];
-  referencedModules: Module[] = [];
-  constructor({ path, bundle, code, loader, isEntry = false }: ModuleOptions) {
-    this.id = path;
-    this.bundle = bundle;
-    this.moduleLoader = loader;
-    this.isEntry = isEntry;
-    this.path = path;
-    this.code = code;
-    this.magicString = new MagicString(code);
-    this.imports = {};
-    this.exports = {};
-    this.reexports = {};
-    this.declarations = {};
-    try {
-      // 将整个模块解析成 ast 结构，用于分析模块
-      const ast = parse(code);
-      // 获取 ast 的 内容体
-      const nodes = ast.body;
-      // 以语句(Statement)的维度来拆分 Module，保存 statement 的集合，供之后分析
-      this.statements = nodes.map((node) => {
-        const magicString = this.magicString.snip(node.start, node.end);
-        return new Statement(node, magicString, this);
-      });
-    } catch (e) {
-      console.log('generate module fail: ', e);
-      throw e;
-    }
-    // 分析 AST 节点
-    this.analyzeAST();
-  }
-
-  analyzeAST(): void {
-    // 以语句为最小单元来分析
-    this.statements.forEach((statement) => {
-      // 对 statement 进行分析
-      statement.analyze();
-      // 如果有 import 声明
-      if (statement.isImportDeclaration) {
-        this.addImports(statement);
-      } else if (statement.isExportDeclaration) {
-        // 如果有 export 声明
-        this.addExports(statement);
-      }
-      // 注册顶层声明
-      if (!statement.scope.parent) {
-        statement.scope.eachDeclaration((name, declaration) => {
-          this.declarations[name] = declaration;
-        });
-      }
-    });
-    // 注册 statement 的 next 属性，用于生成代码使用，next 即下一个 statement 的起始位置
-    const statements = this.statements;
-    let next = this.code.length;
-    for (let i = statements.length - 1; i >= 0; i--) {
-      statements[i].next = next;
-      next = statements[i].start;
-    }
-    // console.log('module:', this.path, this.declarations);
-  }
-
-  addDependencies(source: string): void {
-    if (!this.dependencies.includes(source)) {
-      this.dependencies.push(source);
-    }
-  }
-
-  addImports(statement: Statement): void {
-    const node = statement.node as any;
-    const source = node.source.value;
-    // import
-    node.specifiers.forEach((specifier: Specifier) => {
-      const isDefault = specifier.type === 'ImportDefaultSpecifier';
-      const isNamespace = specifier.type === 'ImportNamespaceSpecifier';
-      const localName = specifier.local.name;
-      const name = isDefault
-        ? 'default'
-        : isNamespace
-          ? '*'
-          : specifier.imported.name;
-      this.imports[localName] = { source, name, localName };
-    });
-    this.addDependencies(source);
-  }
-
-  addExports(statement: Statement): void {
-    const node = statement.node as any;
-    const source = node.source && node.source.value;
-    if (node.type === 'ExportNamedDeclaration') {
-      // export { a, b } from 'mod'
-      if (node.specifiers.length) {
-        node.specifiers.forEach((specifier: Specifier) => {
-          const localName = specifier.local.name;
-          const exportedName = specifier.exported.name;
-          this.exports[exportedName] = {
-            localName,
-            name: exportedName
-          };
-          if (source) {
-            this.reexports[localName] = {
-              statement,
-              source,
-              localName,
-              name: localName,
-              module: undefined
-            };
-            this.imports[localName] = {
-              source,
-              localName,
-              name: localName
-            };
-            this.addDependencies(source);
-          }
-        });
-      } else {
-        const declaration = node.declaration;
-        let name;
-        if (declaration.type === 'VariableDeclaration') {
-          // export const foo = 2;
-          name = declaration.declarations[0].id.name;
-        } else {
-          // export function foo() {}
-          name = declaration.id.name;
-        }
-        this.exports[name] = {
-          statement,
-          localName: name,
-          name
-        };
-      }
-    } else if (node.type === 'ExportDefaultDeclaration') {
-      const identifier =
-        // export default foo;
-        (node.declaration.id && node.declaration.id.name) ||
-        // export default function foo(){}
-        node.declaration.name;
-
-      this.exports['default'] = {
-        statement,
-        localName: identifier,
-        name: 'default'
-      };
-      this.declarations['default'] = new SyntheticDefaultDeclaration(
-        node,
-        identifier,
-        statement
-      );
-    } else if (node.type === 'ExportAllDeclaration') {
-      // export * from 'mod'
-      if (source) {
-        this.exportAllSources.push(source);
-        this.addDependencies(source);
-      }
-    }
-  }
-
-  bind(): void {
-    this.bindImportSpecifiers();
-    this.bindReferences();
-  }
-
-  bindImportSpecifiers(): void {
-    [...Object.values(this.imports), ...Object.values(this.reexports)].forEach(
-      (specifier) => {
-        specifier.module = this._getModuleBySource(specifier.source!);
-      }
-    );
-    this.exportAllModules = this.exportAllSources.map(
-      this._getModuleBySource.bind(this)
-    );
-    // 建立模块依赖图
-    this.dependencyModules = this.dependencies.map(
-      this._getModuleBySource.bind(this)
-    );
-    this.dependencyModules.forEach((module) => {
-      module.referencedModules.push(this);
-    });
-  }
-
-  bindReferences(): void {
-    // 处理 default 导出
-    if (this.declarations['default'] && this.exports['default'].localName) {
-      const declaration = this.trace(this.exports['default'].localName);
-      if (declaration) {
-        (this.declarations['default'] as SyntheticDefaultDeclaration).bind(
-          declaration
-        );
-      }
-    }
-    this.statements.forEach((statement) => {
-      statement.references.forEach((reference) => {
-        // 根据引用寻找声明的位置
-        // 寻找顺序: 1. statement 2. 当前模块 3. 依赖模块
-        const declaration =
-          reference.scope.findDeclaration(reference.name) ||
-          this.trace(reference.name);
-        if (declaration) {
-          declaration.addReference(reference);
-        }
-      });
-    });
-  }
-  getOrCreateNamespace(): Declaration {
-    if (!this.declarations['*']) {
-      this.declarations['*'] = new SyntheticNamespaceDeclaration(this);
-    }
-    return this.declarations['*'];
-  }
-  trace(name: string): Declaration | null {
-    if (this.declarations[name]) {
-      // 从当前模块找
-      return this.declarations[name];
-    }
-    if (this.imports[name]) {
-      const importSpecifier = this.imports[name];
-      const importModule = importSpecifier.module!;
-      if (importSpecifier.name === '*') {
-        return importModule.getOrCreateNamespace();
-      }
-      // 从依赖模块找
-      const declaration = importModule.traceExport(importSpecifier.name);
-      if (declaration) {
-        return declaration;
-      }
-    }
-    return null;
-  }
-  // 从导出名追溯到 Declaration 声明节点
-  traceExport(name: string): Declaration | null {
-    // 1. reexport
-    // export { foo as bar } from './mod'
-    const reexportDeclaration = this.reexports[name];
-    if (reexportDeclaration) {
-      // 说明是从其它模块 reexport 出来的
-      // 经过 bindImportSpecifier 方法处理，现已绑定 module
-      const declaration = reexportDeclaration.module!.traceExport(
-        reexportDeclaration.localName
-      );
-      if (!declaration) {
-        throw new Error(
-          `${reexportDeclaration.localName} is not exported by module ${reexportDeclaration.module!.path
-          }(imported by ${this.path})`
-        );
-      }
-      return declaration;
-    }
-    // 2. export
-    // export { foo }
-    const exportDeclaration = this.exports[name];
-    if (exportDeclaration) {
-      const declaration = this.trace(name);
-      if (declaration) {
-        return declaration;
-      }
-    }
-    // 3. export all
-    for (const exportAllModule of this.exportAllModules) {
-      const declaration = exportAllModule.trace(name);
-      if (declaration) {
-        return declaration;
-      }
-    }
-    return null;
-  }
-
-  render(): MagicString {
-    const source = this.magicString.clone().trim();
-    this.statements.forEach((statement) => {
-      // 1. Tree Shaking
-      if (!statement.isIncluded) {
-        source.remove(statement.start, statement.next);
-        return;
-      }
-      // 2. 重写引用位置的变量名 -> 对应的声明位置的变量名
-      statement.references.forEach((reference) => {
-        const { start, end } = reference;
-        const declaration = reference.declaration;
-        if (declaration) {
-          const name = declaration.render();
-          source.overwrite(start, end, name!);
-        }
-      });
-      // 3. 擦除/重写 export 相关的代码
-      if (statement.isExportDeclaration && !this.isEntry) {
-        // export { foo, bar }
-        if (
-          statement.node.type === 'ExportNamedDeclaration' &&
-          statement.node.specifiers.length
-        ) {
-          source.remove(statement.start, statement.next);
-        }
-        // remove `export` from `export const foo = 42`
-        else if (
-          statement.node.type === 'ExportNamedDeclaration' &&
-          (statement.node.declaration!.type === 'VariableDeclaration' ||
-            statement.node.declaration!.type === 'FunctionDeclaration')
-        ) {
-          source.remove(
-            statement.node.start,
-            statement.node.declaration!.start
-          );
-        }
-        // remove `export * from './mod'`
-        else if (statement.node.type === 'ExportAllDeclaration') {
-          source.remove(statement.start, statement.next);
-        }
-        // export default
-        else if (statement.node.type === 'ExportDefaultDeclaration') {
-          const defaultDeclaration = this.declarations['default'];
-          const defaultName = defaultDeclaration.render();
-
-          // export default function() {}  -> function a() {}
-          if (statement.node.declaration.type === 'FunctionDeclaration') {
-            if (statement.node.declaration.id) {
-              // export default function foo() {} -> const a = function foo() {}
-              source.overwrite(
-                statement.node.start,
-                statement.node.declaration.start,
-                `const ${defaultName} = `
-              );
-            } else {
-              source.overwrite(
-                statement.node.start,
-                statement.node.declaration.start + 8,
-                `function ${defaultName}`
-              );
-            }
-          } else {
-            // export default () => {}
-            // export default Foo;
-            source.overwrite(
-              statement.node.start,
-              statement.node.declaration.start,
-              `const ${defaultName} = `
-            );
-          }
-        }
-      }
-    });
-    // 4. 单独处理 namespace 导出
-    if (this.declarations['*']) {
-      const namespaceDeclaration = this.declarations[
-        '*'
-      ] as SyntheticNamespaceDeclaration;
-      if (namespaceDeclaration.needsNamespaceBlock) {
-        source.append(`\n\n${namespaceDeclaration.renderBlock()}\n`);
-      }
-    }
-    return source.trim();
-  }
-  // 拿到模块所有导出
-  getExports(): string[] {
-    return [
-      ...keys(this.exports),
-      ...keys(this.reexports),
-      ...this.exportAllModules
-        .map((module) =>
-          module.getExports().filter((name: string) => name !== 'default')
-        )
-        .flat()
-    ];
-  }
-
-  private _getModuleBySource(source: string) {
-    const id = this.moduleLoader.resolveId(source!, this.path) as string;
-    return this.bundle.getModuleById(id);
-  }
-}

package/src/ranpack/moduleLoader.ts

@@ -1,73 +0,0 @@
-import { readFile } from 'node:fs/promises'
-import { Module } from './module'
-import { defaultResolver } from './utils/resolve'
-import type { Bundle } from './bundle'
-/**
- * @description: 1.调用 resolveId 方法解析模块路径 2.初始化模块实例即 Module 对象，解析模块 AST 3.递归初始化模块的所有依赖模块
- * @return {*}
- */
-export class ModuleLoader {
-  bundle: Bundle
-  resolveIdsMap: Map<string, string | false> = new Map()
-  constructor(bundle: Bundle) {
-    this.bundle = bundle
-  }
-  /**
-   * @description: 解析模块逻辑
-   * @param {string} id
-   * @param {string} importer
-   * @return {*}
-   */  
-  resolveId(id: string, importer: string = ''): string | false {
-    const cacheKey = id + importer
-    if (this.resolveIdsMap.has(cacheKey)) {
-      return this.resolveIdsMap.get(cacheKey)!
-    }
-    const resolved = defaultResolver(id, importer)
-    this.resolveIdsMap.set(cacheKey, resolved)
-    return resolved
-  }
-  /**
-   * @description: 加载模块内容并解析
-   * @return {*}
-   */  
-  async fetchModule(
-    id: string,
-    importer: string,
-    isEntry = false,
-    bundle: Bundle = this.bundle,
-    loader: ModuleLoader = this,
-  ): Promise<Module | null> {
-    const path = this.resolveId(id, importer)
-
-    if (path === false) {
-      return null
-    }
-    // 查找缓存
-    const existModule = this.bundle.getModuleById(path)
-    if (existModule) {
-      return existModule
-    }
-    const code = await readFile(path, { encoding: 'utf-8' })
-    // 初始化模块，解析 AST
-    const module = new Module({
-      path,
-      code,
-      bundle,
-      loader,
-      isEntry,
-    })
-    this.bundle.addModule(module)
-    // 拉取所有的依赖模块
-    await this.fetchAllDependencies(module)
-    return module
-  }
-
-  async fetchAllDependencies(module: Module): Promise<void> {
-    await Promise.all(
-      module.dependencies.map((dep) => {
-        return this.fetchModule(dep, module.path)
-      }),
-    )
-  }
-}

package/src/ranpack/plugins.ts

@@ -1,70 +0,0 @@
-interface PluginItem {
-  name: string
-  exec: Function
-}
-
-// pre-alias
-// alias
-// modulepreload-polyfill
-// optimized-deps
-// resolve
-
-interface Plugin {
-  [x: string]: (() => void) | undefined | string
-  name: string
-  // input
-  options?: () => void
-  buildStart?: () => void
-  resolvedId?: () => void
-  load?: () => void
-  transform?: () => void
-  moduleParsed?: () => void
-  resolveDynamicImport?: () => void
-  watchChange?: () => void
-  closeWatcher?: () => void
-  buildEnd?: () => void
-  // output
-  renderStart?: () => void
-  generateBundle?: () => void
-  closeBundle?: () => void
-}
-
-class PluginHooks {
-  [x: string]: Array<PluginItem>
-  constructor() {
-    // input
-    this.option = []
-    this.buildStart = []
-    this.resolvedId = []
-    this.load = []
-    this.transform = []
-    this.moduleParsed = []
-    this.resolveDynamicImport = []
-    this.watchChange = []
-    this.closeWatcher = []
-    this.buildEnd = []
-    // output
-    this.renderStart = []
-    this.generateBundle = []
-    this.closeBundle = []
-  }
-}
-
-class Plugins {
-  pluginHooks: PluginHooks
-  constructor(plugins = []) {
-    this.pluginHooks = new PluginHooks()
-    plugins.forEach((plugin) => this.register(plugin))
-  }
-  register = (plugin: Plugin): void => {
-    const { name, ...hooks } = plugin
-    Object.keys(hooks).forEach((hook) => {
-      const exec = plugin[hook]
-      if (exec instanceof Function) {
-        this.pluginHooks[hook]?.push({ name, exec })
-      }
-    })
-  }
-}
-
-export default Plugins

package/src/ranpack/statement.ts

@@ -1,66 +0,0 @@
-import type MagicString from 'magic-string';
-import type { ExportAllDeclaration, ExportDeclaration, ExportNamedDeclaration, FunctionDeclaration, Statement as StatementNode } from '../astParser';
-import type { Reference } from './ast/Reference';
-import { findReference } from './utils/findReference';
-import { buildScope } from './utils/buildScope';
-import {
-  isExportDeclaration,
-  isFunctionDeclaration,
-  isImportDeclaration
-} from './utils/isFunctionDeclaration';
-import { Scope } from './ast/Scope';
-import type { Module } from './module';
-
-/**
- * @description: 生成用于分析的 Statement 语句
- */
-export class Statement {
-  // acorn type problem
-  node: StatementNode;
-  magicString: MagicString;
-  module: Module;
-  scope: Scope;
-  start: number;
-  next: number;
-  isImportDeclaration: boolean;
-  isExportDeclaration: boolean;
-  isReexportDeclaration: boolean;
-  isFunctionDeclaration: boolean;
-  isIncluded: boolean = false;
-  defines: Set<string> = new Set();
-  modifies: Set<string> = new Set();
-  dependsOn: Set<string> = new Set();
-  references: Reference[] = [];
-  constructor(node: StatementNode, magicString: MagicString, module: Module) {
-    this.magicString = magicString;
-    this.node = node;
-    this.module = module;
-    this.scope = new Scope({
-      statement: this
-    });
-    this.start = node.start;
-    this.next = 0;
-    this.isImportDeclaration = isImportDeclaration(node);
-    this.isExportDeclaration = isExportDeclaration(node as ExportDeclaration);
-    this.isReexportDeclaration = this.isExportDeclaration && !!(node as (ExportAllDeclaration | ExportNamedDeclaration)).source;
-    this.isFunctionDeclaration = isFunctionDeclaration(node as FunctionDeclaration);
-  }
-
-  analyze():void {
-    if (this.isImportDeclaration) return;
-    // 1、构建作用域链，记录 Declaration 节点表
-    buildScope(this);
-    // 2. 寻找引用依赖，记录 Reference 节点表
-    findReference(this);
-  }
-
-  mark():void {
-    if (this.isIncluded) {
-      return;
-    }
-    this.isIncluded = true;
-    this.references.forEach(
-      (ref: Reference) => ref.declaration && ref.declaration.use()
-    );
-  }
-}