@cocos/ccbuild 2.0.3-alpha.11 → 2.0.3-alpha.12

package/modules/build-engine/lib/index.d.ts

@@ -1,131 +1,131 @@
 import { StatsQuery } from "../../stats-query/lib/index";
-/**
- * @group Merged Types
+/**
+ * @group Merged Types
  */
 export declare function buildEngine(options: buildEngine.Options): Promise<buildEngine.Result>;
-/**
- * @group Merged Types
+/**
+ * @group Merged Types
  */
 export declare namespace buildEngine {
   type ModuleFormat = 'esm' | 'cjs' | 'system' | 'iife';
   interface Options {
-    /**
-     * 引擎仓库目录。
+    /**
+     * 引擎仓库目录。
      */
     engine: string;
-    /**
-     * 输出目录。
+    /**
+     * 输出目录。
      */
     out: string;
     mode: StatsQuery.ConstantManager.ModeType;
     platform: StatsQuery.ConstantManager.PlatformType;
     flags?: Partial<StatsQuery.ConstantManager.IFlagConfig>;
-    /**
-     * 包含的功能。
+    /**
+     * 包含的功能。
      */
     features?: string[];
-    /**
-     * 输出模块格式。
-     * @default 'system'
+    /**
+     * 输出模块格式。
+     * @default 'system'
      */
     moduleFormat?: ModuleFormat;
-    /**
-     * 是否对生成结果进行压缩。
-     * @default false
+    /**
+     * 是否对生成结果进行压缩。
+     * @default false
      */
     compress?: boolean;
-    /**
-     * 是否生成 source map。
-     * 若为 `inline` 则生成内联的 source map。
-     * @default false
+    /**
+     * 是否生成 source map。
+     * 若为 `inline` 则生成内联的 source map。
+     * @default false
      */
     sourceMap?: boolean | 'inline';
-    /**
-     * 若 `sourceMap` 为 `true`，此选项指定了 source map 的路径。
-     * @default `${outputPath.map}`
+    /**
+     * 若 `sourceMap` 为 `true`，此选项指定了 source map 的路径。
+     * @default `${outputPath.map}`
      */
     sourceMapFile?: string;
-    /**
-     * 若为 `true`，分割出 **所有** 引擎子模块。
-     * 否则，`.moduleEntries` 指定的所有子模块将被合并成一个单独的 `"cc"` 模块。
-     * @default false
+    /**
+     * 若为 `true`，分割出 **所有** 引擎子模块。
+     * 否则，`.moduleEntries` 指定的所有子模块将被合并成一个单独的 `"cc"` 模块。
+     * @default false
      */
     split?: boolean;
-    /**
-     * 使用的 ammo.js 版本，也即 `@cocos/ammo` 映射到的版本。
-     * - 为 `true` 时使用 WebAssembly 版本的 ammo.js；
-     * - 为 `false` 时使用 asm.js 版本的 ammo.js；
-     * - 为 `'fallback` 时同时在结果中包含两个版本的 ammo.js，并自动根据环境 fallback 选择。
-     *
-     * 注意，`'fallback'` 只有在 SystemJS 和 Async functions 同时支持时才有效。
-     * @default true
-     *
-     * @deprecated 从 1.1.5 版本开始，该选项只会影响 FORCE_BANNING_BULLET_WASM 宏的值
-     * - 为 `true` 时，FORCE_BANNING_BULLET_WASM 为 false
-     * - 为 `false` 时，FORCE_BANNING_BULLET_WASM 为 true
-     * - 为 `'fallback'` 时, FORCE_BANNING_BULLET_WASM 为 false
+    /**
+     * 使用的 ammo.js 版本，也即 `@cocos/ammo` 映射到的版本。
+     * - 为 `true` 时使用 WebAssembly 版本的 ammo.js；
+     * - 为 `false` 时使用 asm.js 版本的 ammo.js；
+     * - 为 `'fallback` 时同时在结果中包含两个版本的 ammo.js，并自动根据环境 fallback 选择。
+     *
+     * 注意，`'fallback'` 只有在 SystemJS 和 Async functions 同时支持时才有效。
+     * @default true
+     *
+     * @deprecated 从 1.1.5 版本开始，该选项只会影响 FORCE_BANNING_BULLET_WASM 宏的值
+     * - 为 `true` 时，FORCE_BANNING_BULLET_WASM 为 false
+     * - 为 `false` 时，FORCE_BANNING_BULLET_WASM 为 true
+     * - 为 `'fallback'` 时, FORCE_BANNING_BULLET_WASM 为 false
      */
     ammoJsWasm?: boolean | 'fallback';
-    /**
-     * If true, all deprecated features/API are excluded.
-     * You can also specify a version range(in semver range) to exclude deprecations in specified version(s).
-     * @default false
+    /**
+     * If true, all deprecated features/API are excluded.
+     * You can also specify a version range(in semver range) to exclude deprecations in specified version(s).
+     * @default false
      */
     noDeprecatedFeatures?: string | boolean;
-    /**
-     * Experimental.
+    /**
+     * Experimental.
      */
     incremental?: string;
-    /**
-     * BrowsersList targets.
+    /**
+     * BrowsersList targets.
      */
     targets?: string | string[] | Record<string, string>;
-    /**
-     * Enable loose compilation.
-     *
-     * @deprecated since 1.1.20, we force using true internal.
+    /**
+     * Enable loose compilation.
+     *
+     * @deprecated since 1.1.20, we force using true internal.
      */
     loose?: boolean;
-    /**
-     * How to generate the reference to external assets:
-     * - `'relative-from-out'`
-     * Generate the path relative from `out` directory, does not contain the leading './'.
-     *
-     * - `'relative-from-chunk'`
-     * Generate the path relative from the referencing output chunk.
-     *
-     * - `'dynamic'`(default)
-     * Use runtime `URL` API to resolve the absolute URL.
-     * This requires `URL` and `import.meta.url` to be valid.
+    /**
+     * How to generate the reference to external assets:
+     * - `'relative-from-out'`
+     * Generate the path relative from `out` directory, does not contain the leading './'.
+     *
+     * - `'relative-from-chunk'`
+     * Generate the path relative from the referencing output chunk.
+     *
+     * - `'dynamic'`(default)
+     * Use runtime `URL` API to resolve the absolute URL.
+     * This requires `URL` and `import.meta.url` to be valid.
      */
     assetURLFormat?: 'relative-from-out' | 'relative-from-chunk' | 'runtime-resolved';
-    /**
-     * Preserve engine type info, this options will build a TS engine to the output directory.
-     * It's useful when we need to take a step towards the AOT optimization.
-     * This options is only supported on Open Harmony platform for now.
-     * @default false
+    /**
+     * Preserve engine type info, this options will build a TS engine to the output directory.
+     * It's useful when we need to take a step towards the AOT optimization.
+     * This options is only supported on Open Harmony platform for now.
+     * @default false
      */
     preserveType?: boolean;
   }
   interface Result {
-    /**
-     * Mappings between feature unit name and their actual chunk file, for example:
-     * ```js
-     * {
-     *   "core": "./core.js",
-     *   "gfx-webgl": "./gfx-webgl.js",
-     * }
-     * ```
+    /**
+     * Mappings between feature unit name and their actual chunk file, for example:
+     * ```js
+     * {
+     *   "core": "./core.js",
+     *   "gfx-webgl": "./gfx-webgl.js",
+     * }
+     * ```
      */
     exports: Record<string, string>;
-    /**
-     * The compulsory import mappings that should be applied.
+    /**
+     * The compulsory import mappings that should be applied.
      */
     chunkAliases: Record<string, string>;
-    /**
-     * The dependency graph, only including dependency chunks.
-     *
-     * @deprecated please use `chunkDepGraph` instead.
+    /**
+     * The dependency graph, only including dependency chunks.
+     *
+     * @deprecated please use `chunkDepGraph` instead.
      */
     dependencyGraph?: Record<string, string[]>;
     chunkDepGraph: Record<string, string[]>;
@@ -136,22 +136,22 @@ export declare namespace buildEngine {
     code: string;
   }>;
   function isSourceChanged(incrementalFile: string): Promise<boolean>;
-  /**
-   * Enumerates all chunk files that used by specified feature units.
-   * @param meta Metadata of build result.
-   * @param featureUnits Feature units.
+  /**
+   * Enumerates all chunk files that used by specified feature units.
+   * @param meta Metadata of build result.
+   * @param featureUnits Feature units.
    */
   function enumerateDependentChunks(meta: buildEngine.Result, featureUnits: string[]): string[];
-  /**
-   * Enumerates all asset files that used by specified feature units.
-   * @param meta Metadata of build result.
-   * @param featureUnits Feature units.
+  /**
+   * Enumerates all asset files that used by specified feature units.
+   * @param meta Metadata of build result.
+   * @param featureUnits Feature units.
    */
   function enumerateDependentAssets(meta: buildEngine.Result, featureUnits: string[]): string[];
-  /**
-   * Enumerates all chunk files and asset files that used by specified feature units.
-   * @param meta Metadata of build result.
-   * @param featureUnits Feature units.
+  /**
+   * Enumerates all chunk files and asset files that used by specified feature units.
+   * @param meta Metadata of build result.
+   * @param featureUnits Feature units.
    */
   function enumerateAllDependents(meta: buildEngine.Result, featureUnits: string[]): string[];
 }

package/modules/build-engine/lib/index.js

@@ -64,8 +64,8 @@ function moduleOptionsToBabelEnvModules(moduleOptions) {
       throw new Error(`Unknown module format ${moduleOptions}`);
   }
 }
-/**
- * @group Merged Types
+/**
+ * @group Merged Types
  */
 function buildEngine(options) {
   return __awaiter(this, void 0, void 0, function* () {
@@ -89,8 +89,8 @@ function buildEngine(options) {
   });
 }
 exports.buildEngine = buildEngine;
-/**
- * @group Merged Types
+/**
+ * @group Merged Types
  */
 (function (buildEngine) {
   function transform(code, moduleOption, loose) {
@@ -178,29 +178,29 @@ exports.buildEngine = buildEngine;
     }
     return result;
   }
-  /**
-   * Enumerates all chunk files that used by specified feature units.
-   * @param meta Metadata of build result.
-   * @param featureUnits Feature units.
+  /**
+   * Enumerates all chunk files that used by specified feature units.
+   * @param meta Metadata of build result.
+   * @param featureUnits Feature units.
    */
   function enumerateDependentChunks(meta, featureUnits) {
     return _enumerateDependentChunks(meta, featureUnits);
   }
   buildEngine.enumerateDependentChunks = enumerateDependentChunks;
-  /**
-   * Enumerates all asset files that used by specified feature units.
-   * @param meta Metadata of build result.
-   * @param featureUnits Feature units.
+  /**
+   * Enumerates all asset files that used by specified feature units.
+   * @param meta Metadata of build result.
+   * @param featureUnits Feature units.
    */
   function enumerateDependentAssets(meta, featureUnits) {
     const dependentChunks = _enumerateDependentChunks(meta, featureUnits);
     return _enumerateDependentAssets(meta, dependentChunks);
   }
   buildEngine.enumerateDependentAssets = enumerateDependentAssets;
-  /**
-   * Enumerates all chunk files and asset files that used by specified feature units.
-   * @param meta Metadata of build result.
-   * @param featureUnits Feature units.
+  /**
+   * Enumerates all chunk files and asset files that used by specified feature units.
+   * @param meta Metadata of build result.
+   * @param featureUnits Feature units.
    */
   function enumerateAllDependents(meta, featureUnits) {
     const dependentChunks = _enumerateDependentChunks(meta, featureUnits);

package/modules/dts-bundler/lib/index.js

@@ -331,11 +331,11 @@ exports.build = build;
 function buildIndexModule(featureUnits, statsQuery) {
   return `declare module "cc" {\n${statsQuery.evaluateIndexModuleSource(featureUnits).split('\n').map(line => `    ${line}`).join('\n')}\n}`;
 }
-/**
- * '@cocos/moduleName' -> 'cc/editor/moduleName'
- * '@cocos/moduleName/editor' -> 'cc/editor/moduleName'
- * 'moduleName' -> 'cc/editor/moduleName'
- * @param moduleName
+/**
+ * '@cocos/moduleName' -> 'cc/editor/moduleName'
+ * '@cocos/moduleName/editor' -> 'cc/editor/moduleName'
+ * 'moduleName' -> 'cc/editor/moduleName'
+ * @param moduleName
  */
 function transformToEditorModuleName(moduleName) {
   const split = moduleName.split('/');

package/modules/modularize/lib/module-config.d.ts

@@ -3,130 +3,130 @@ export type MinigamePlatformConfig = { [key in Lowercase<keyof typeof MinigamePl
 export type NativePlatformConfig = { [key in Lowercase<keyof typeof NativePlatform>]?: string };
 export type WebPlatformConfig = { [key in Lowercase<keyof typeof WebPlatform>]?: string };
 export type PlatformType = Uppercase<keyof typeof WebPlatform | keyof typeof MinigamePlatform | keyof typeof NativePlatform> | 'HTML5' | 'NATIVE';
-/**
- * Abstract platform export, like `web`, `native` and `minigame`.
- * Usually this is used for PAL modules.
- * The build tools resolve the relative platform as entry according to the build platform config.
- * - The value can be a `string` or a `object` which requires a default item.
- * eg. { "web": "/path/to/index.ts" } is equals to { "web": { default: "/path/to/index.ts" } }.
- * - We can also specify the exact platform like
- * { "web": {default: "/path/to/index.ts", "web-desktop": "/path/to/index.ts" } }.
+/**
+ * Abstract platform export, like `web`, `native` and `minigame`.
+ * Usually this is used for PAL modules.
+ * The build tools resolve the relative platform as entry according to the build platform config.
+ * - The value can be a `string` or a `object` which requires a default item.
+ * eg. { "web": "/path/to/index.ts" } is equals to { "web": { default: "/path/to/index.ts" } }.
+ * - We can also specify the exact platform like
+ * { "web": {default: "/path/to/index.ts", "web-desktop": "/path/to/index.ts" } }.
  */
 type AbstractPlatformExport<T> = ({
-  /**
-   * Default platform export for unspecified platforms.
+  /**
+   * Default platform export for unspecified platforms.
    */
   default: string;
 } & T) | string;
-/**
- * The export condition. `types` fields are required.
+/**
+ * The export condition. `types` fields are required.
  */
 type ExportCondition<T> = {
-  /**
-   * This is the main module export condition.
-   * - The dts bundle tools resolve this condition as entry.
-   * - The API doc tools resolve this condition as entry.
-   * - If no platform export is specified, the build tools resolve this condition as entry.
+  /**
+   * This is the main module export condition.
+   * - The dts bundle tools resolve this condition as entry.
+   * - The API doc tools resolve this condition as entry.
+   * - If no platform export is specified, the build tools resolve this condition as entry.
    */
   types: string;
-  /**
-   * The custom condition, for example:
-   * - For gfx module: {"webgl1": "/path/to/webgl1/index.ts", "webgl2": "/path/to/webgl2/index.ts"}
-   * - For physics module {"cannon": "/path/to/cannon/index.ts", "physX": "/path/to/physX/index.ts"}
+  /**
+   * The custom condition, for example:
+   * - For gfx module: {"webgl1": "/path/to/webgl1/index.ts", "webgl2": "/path/to/webgl2/index.ts"}
+   * - For physics module {"cannon": "/path/to/cannon/index.ts", "physX": "/path/to/physX/index.ts"}
    */
   [customCondition: string]: string;
 } & T;
 interface ConditionalExports {
-  /**
-   * This is exported to the game runtime.
-   * Also we build the `cc.d.ts` with this export condition's `types` field.
-   * `node` field is required to resolve the path of package.json for build tools.
+  /**
+   * This is exported to the game runtime.
+   * Also we build the `cc.d.ts` with this export condition's `types` field.
+   * `node` field is required to resolve the path of package.json for build tools.
    */
   '.': ExportCondition<{
-    /**
-     * `node` should be specified as './package.json' to resolve the path of package.json for build tools.
+    /**
+     * `node` should be specified as './package.json' to resolve the path of package.json for build tools.
      */
     node: './package.json';
     minigame?: AbstractPlatformExport<MinigamePlatformConfig>;
     native?: AbstractPlatformExport<NativePlatformConfig>;
     web?: AbstractPlatformExport<WebPlatformConfig>;
   }>;
-  /**
-   * This is exported to the engine internal.
-   * It useful when we need to export some friend interfaces for internal engine modules.
+  /**
+   * This is exported to the engine internal.
+   * It useful when we need to export some friend interfaces for internal engine modules.
    */
   './internal'?: ExportCondition<{
     minigame?: AbstractPlatformExport<MinigamePlatformConfig>;
     native?: AbstractPlatformExport<NativePlatformConfig>;
     web?: AbstractPlatformExport<WebPlatformConfig>;
   }>;
-  /**
-   * This is exported to the editor, which is useful when we need to export some editor only interfaces.
-   * Also we build `cc.editor.d.ts` from this export condition's `types` field.
-   * If this is not specified, we use the '.' export condition by default for module editor export,
-   * otherwise, the build tools merges '.' and './editor' exports together for editor runtime environment.
-   * It is different with `web_editor` or `native_editor` platform export:
-   * - this condition exports some editor specific interfaces which is not cross-platform.
-   * - the `web_editor` or `native_editor` platform export is an editor version of implementation of interfaces defined in `types` field which should be cross-platform.
+  /**
+   * This is exported to the editor, which is useful when we need to export some editor only interfaces.
+   * Also we build `cc.editor.d.ts` from this export condition's `types` field.
+   * If this is not specified, we use the '.' export condition by default for module editor export,
+   * otherwise, the build tools merges '.' and './editor' exports together for editor runtime environment.
+   * It is different with `web_editor` or `native_editor` platform export:
+   * - this condition exports some editor specific interfaces which is not cross-platform.
+   * - the `web_editor` or `native_editor` platform export is an editor version of implementation of interfaces defined in `types` field which should be cross-platform.
    */
   './editor'?: ExportCondition<{}>;
 }
 interface ModuleOverride {
-  /**
-   * The test string to evaluate.
+  /**
+   * The test string to evaluate.
    */
   test: string;
-  /**
-   * The override config, override mapping from key to value.
+  /**
+   * The override config, override mapping from key to value.
    */
   overrides: Record<string, string>;
 }
 export interface ModuleConfig {
   [key: string]: unknown;
-  /**
-   * The module name.
+  /**
+   * The module name.
    */
   name: string;
-  /**
-   * The version of module.
-   * It is useful when we change the module config, then we need to make some migration.
-   * This usually comes with the `cc.migrations` field.
+  /**
+   * The version of module.
+   * It is useful when we change the module config, then we need to make some migration.
+   * This usually comes with the `cc.migrations` field.
    */
   version: string;
-  /**
-   * The config for conditional exports.
+  /**
+   * The config for conditional exports.
    */
   exports: ConditionalExports;
-  /**
-   * Specify the module dependencies is required if this module import another one.
-   * We need this field to generate the module dependency graph.
+  /**
+   * Specify the module dependencies is required if this module import another one.
+   * We need this field to generate the module dependency graph.
    */
   dependencies?: Record<string, string>;
-  /**
-   * Specify the dev dependencies, these dependencies are always used in `scripts` folder.
+  /**
+   * Specify the dev dependencies, these dependencies are always used in `scripts` folder.
    */
   devDependencies?: Record<string, string>;
-  /**
-   * The dependencies between modules form a tree-structured dependency graph.
-   * The correct dependency relationship should be that the upper module depends on the lower module one-way, and the reverse is wrong.
-   * However, it is normal for modules at the same layer to depend on each other, and such dependencies should be declared as `peerDependencies`.
-   * Otherwise the Turbo pipeline will report an error due to module circular dependencies.
-   * see: https://github.com/vercel/turbo/issues/1480
+  /**
+   * The dependencies between modules form a tree-structured dependency graph.
+   * The correct dependency relationship should be that the upper module depends on the lower module one-way, and the reverse is wrong.
+   * However, it is normal for modules at the same layer to depend on each other, and such dependencies should be declared as `peerDependencies`.
+   * Otherwise the Turbo pipeline will report an error due to module circular dependencies.
+   * see: https://github.com/vercel/turbo/issues/1480
    */
   peerDependencies?: Record<string, string>;
-  /**
-   * This is a CC-specific item difference from the node package.json standard specification.
+  /**
+   * This is a CC-specific item difference from the node package.json standard specification.
    */
   cc?: {
-    /**
-     * The module asset dependencies, which is an array of asset uuid.
+    /**
+     * The module asset dependencies, which is an array of asset uuid.
      */
     assetDependencies?: string[];
-    /**
-     * This is different with conditional exports.
-     * Sometimes we just want to override a script file instead of the whole module.
-     * Module override could support to do this job.
-     * - eg. { "test": "context.mode === 'BUILD'", "overrides": { "/path/to/dev.ts": "/path/to/build.ts" } }
+    /**
+     * This is different with conditional exports.
+     * Sometimes we just want to override a script file instead of the whole module.
+     * Module override could support to do this job.
+     * - eg. { "test": "context.mode === 'BUILD'", "overrides": { "/path/to/dev.ts": "/path/to/build.ts" } }
      */
     moduleOverrides?: ModuleOverride[];
   };

package/modules/modularize/lib/module-query.d.ts

@@ -1,26 +1,26 @@
 import { ModuleConfig, PlatformType } from './module-config';
 export interface ModuleQueryContext {
-  /**
-   * The engine root path.
+  /**
+   * The engine root path.
    */
   engine: string;
-  /**
-   * The platform to resolve conditional export.
+  /**
+   * The platform to resolve conditional export.
    */
   platform: PlatformType;
-  /**
-   * The custom export condition.
-   * The higher the array is sorted, the higher the priority is.
-   *
-   * @example
-   * ```ts
-   * [ 'webgl1',  'cannon' ]  // the backend of 'gfx' and 'physics' modules.
-   * ```
+  /**
+   * The custom export condition.
+   * The higher the array is sorted, the higher the priority is.
+   *
+   * @example
+   * ```ts
+   * [ 'webgl1',  'cannon' ]  // the backend of 'gfx' and 'physics' modules.
+   * ```
    */
   customExportConditions?: string[];
 }
-/**
- * The module info manager.
+/**
+ * The module info manager.
  */
 export declare class ModuleQuery {
   private _context;
@@ -28,25 +28,25 @@ export declare class ModuleQuery {
   private _resolvedCache;
   private _cachedHasEditorSpecificExport;
   constructor(context: ModuleQueryContext);
-  /**
-   * Get all modules' name defined in engine workspaces.
+  /**
+   * Get all modules' name defined in engine workspaces.
    */
   getAllModules(): Promise<string[]>;
-  /**
-   * Resolve module package.json path by module name.
+  /**
+   * Resolve module package.json path by module name.
    */
   resolvePackageJson(moduleName: string): string;
-  /**
-   * Get module config by module name.
+  /**
+   * Get module config by module name.
    */
   getConfig(moduleName: string): Promise<ModuleConfig>;
-  /**
-   * Resolve module entry path by import source.
+  /**
+   * Resolve module entry path by import source.
    */
   resolveExport(source: string): Promise<string | void>;
-  /**
-   * To detect whether the module has a './editor' export.
-   * @param moduleName
+  /**
+   * To detect whether the module has a './editor' export.
+   * @param moduleName
    */
   hasEditorSpecificExport(moduleName: string): Promise<boolean>;
   private _isWebPlatform;