@cocos/ccbuild 2.0.3-alpha.2 → 2.0.3-alpha.4

package/modules/stats-query/lib/config-interface.d.ts

@@ -1,11 +1,11 @@
 export interface Config {
-  /**
-   * Engine features. Keys are feature IDs.
+  /**
+   * Engine features. Keys are feature IDs.
    */
   features: Record<string, Feature>;
-  /**
-   * Describe how to generate the index module `'cc'`.
-   * Currently not used.
+  /**
+   * Describe how to generate the index module `'cc'`.
+   * Currently not used.
    */
   index?: IndexConfig;
   moduleOverrides?: Array<{
@@ -13,58 +13,58 @@ export interface Config {
     overrides: Record<string, string>;
     isVirtualModule: boolean;
   }>;
-  /**
-   * Included files for quick-compiler.
+  /**
+   * Included files for quick-compiler.
    */
   includes: Array<string>;
-  /**
-   * The constants config for engine and user.
+  /**
+   * The constants config for engine and user.
    */
   constants: IConstantConfig;
-  /**
-   * The decorators to be optimize when build engine.
+  /**
+   * The decorators to be optimize when build engine.
    */
   optimizeDecorators: IOptimizeDecorators;
 }
 export interface IndexConfig {
   modules?: Record<string, {
-    /**
-     * If specified, export contents of the module into a namespace specified by `ns`
-     * and then export that namespace into `'cc'`.
-     * If not specified, contents of the module will be directly exported into `'cc'`.
+    /**
+     * If specified, export contents of the module into a namespace specified by `ns`
+     * and then export that namespace into `'cc'`.
+     * If not specified, contents of the module will be directly exported into `'cc'`.
      */
     ns?: string;
-    /**
-     * If `true`, accesses the exports of this module from `'cc'` will be marked as deprecated.
+    /**
+     * If `true`, accesses the exports of this module from `'cc'` will be marked as deprecated.
      */
     deprecated?: boolean;
   }>;
 }
 export type Test = string;
-/**
- * An engine feature.
+/**
+ * An engine feature.
  */
 export interface Feature {
-  /**
-   * Modules to be included in this feature in their IDs.
-   * The ID of a module is its relative path(no extension) under /exports/.
+  /**
+   * Modules to be included in this feature in their IDs.
+   * The ID of a module is its relative path(no extension) under /exports/.
    */
   modules: string[];
-  /**
-   * Flags to set when this feature is enabled.
+  /**
+   * Flags to set when this feature is enabled.
    */
   intrinsicFlags?: Record<string, unknown>;
-  /**
-   * List of uuid that the feature depend on.
+  /**
+   * List of uuid that the feature depend on.
    */
   dependentAssets?: string[];
-  /**
-   * List of module that the feature depend on.
+  /**
+   * List of module that the feature depend on.
    */
   dependentModules?: string[];
-  /**
-   * Whether it is a native only feature, default is false.
-   * @default false
+  /**
+   * Whether it is a native only feature, default is false.
+   * @default false
    */
   isNativeOnly?: boolean;
 }
@@ -75,42 +75,42 @@ export interface Context {
 }
 export type ConstantTypeName = 'boolean' | 'number';
 export interface IConstantInfo {
-  /**
-   * The comment of the constant.
-   * Which is used to generate the consts.d.ts file.
+  /**
+   * The comment of the constant.
+   * Which is used to generate the consts.d.ts file.
    */
   readonly comment: string;
-  /**
-   * The type of the constant for generating consts.d.ts file.
+  /**
+   * The type of the constant for generating consts.d.ts file.
    */
   readonly type: ConstantTypeName;
-  /**
-   * The default value of the constant.
-   * It can be a boolean, number or string.
-   * When it's a string type, the value is the result of eval().
+  /**
+   * The default value of the constant.
+   * It can be a boolean, number or string.
+   * When it's a string type, the value is the result of eval().
    */
   value: boolean | string | number;
-  /**
-   * Whether exported to global as a `CC_XXXX` constant.
-   * eg. WECHAT is exported to global.CC_WECHAT
-   * NOTE: this is a feature of compatibility with Cocos 2.x engine.
-   * Default is false.
-   *
-   * @default false
+  /**
+   * Whether exported to global as a `CC_XXXX` constant.
+   * eg. WECHAT is exported to global.CC_WECHAT
+   * NOTE: this is a feature of compatibility with Cocos 2.x engine.
+   * Default is false.
+   *
+   * @default false
    */
   ccGlobal?: boolean;
-  /**
-   * Whether exported to developer.
-   * If true, it's only exported to engine.
+  /**
+   * Whether exported to developer.
+   * If true, it's only exported to engine.
    */
   readonly internal: boolean;
-  /**
-   * Some constant can't specify the value in the Editor, Preview or Test environment,
-   * so we need to dynamically judge them in runtime.
-   * These values are specified in a helper called `helper-dynamic-constants.ts`.
-   * Default is false.
-   *
-   * @default false
+  /**
+   * Some constant can't specify the value in the Editor, Preview or Test environment,
+   * so we need to dynamically judge them in runtime.
+   * These values are specified in a helper called `helper-dynamic-constants.ts`.
+   * Default is false.
+   *
+   * @default false
    */
   dynamic?: boolean;
 }
@@ -118,12 +118,12 @@ export interface IConstantConfig {
   [ConstantName: string]: IConstantInfo;
 }
 export interface IOptimizeDecorators {
-  /**
-   * The decorators which should be optimized when they only decorate class fields.
+  /**
+   * The decorators which should be optimized when they only decorate class fields.
    */
   fieldDecorators: string[];
-  /**
-   * The decorators which should be removed directly when they only work in Cocos Creator editor.
+  /**
+   * The decorators which should be removed directly when they only work in Cocos Creator editor.
    */
   editorDecorators: string[];
 }

package/modules/stats-query/lib/index.d.ts

@@ -1,77 +1,77 @@
 import { Context } from './config-interface';
 import * as ConfigInterface from './config-interface';
 export { ConfigInterface };
-/**
- * Query any any stats of the engine.
+/**
+ * Query any any stats of the engine.
  */
 export declare class StatsQuery {
-  /**
-   * @param engine Path to the engine root.
+  /**
+   * @param engine Path to the engine root.
    */
   static create(engine: string): Promise<StatsQuery>;
-  /**
-   * Constant manager for engine and user.
+  /**
+   * Constant manager for engine and user.
    */
   constantManager: StatsQuery.ConstantManager;
-  /**
-   * Gets the path to the engine root.
+  /**
+   * Gets the path to the engine root.
    */
   get path(): string;
-  /**
-   * Gets the path to tsconfig.
+  /**
+   * Gets the path to tsconfig.
    */
   get tsConfigPath(): string;
-  /**
-   * Gets all optimzie decorators
+  /**
+   * Gets all optimzie decorators
    */
   getOptimizeDecorators(): ConfigInterface.IOptimizeDecorators;
-  /**
-   * Gets all features defined.
+  /**
+   * Gets all features defined.
    */
   getFeatures(): string[];
-  /**
-   * Returns if the specified feature is defined.
-   * @param feature Feature ID.
+  /**
+   * Returns if the specified feature is defined.
+   * @param feature Feature ID.
    */
   hasFeature(feature: string): boolean;
-  /**
-   * Gets all feature units included in specified features.
-   * @param featureIds Feature ID.
+  /**
+   * Gets all feature units included in specified features.
+   * @param featureIds Feature ID.
    */
   getUnitsOfFeatures(featureIds: string[]): string[];
   getIntrinsicFlagsOfFeatures(featureIds: string[]): Record<string, string | number | boolean>;
-  /**
-   * Gets all feature units in their names.
+  /**
+   * Gets all feature units in their names.
    */
   getFeatureUnits(): string[];
-  /**
-   * Gets the path to source file of the feature unit.
-   * @param moduleId Name of the feature unit.
+  /**
+   * Gets the path to source file of the feature unit.
+   * @param moduleId Name of the feature unit.
    */
   getFeatureUnitFile(featureUnit: string): string;
-  /**
-   * Gets all editor public modules in their names.
+  /**
+   * Gets all editor public modules in their names.
    */
   getEditorPublicModules(): string[];
-  /**
-   * Gets the path to source file of the editor-public module.
-   * @param moduleName Name of the public module.
+  /**
+   * Gets the path to source file of the editor-public module.
+   * @param moduleName Name of the public module.
    */
   getEditorPublicModuleFile(moduleName: string): string;
-  /**
-   * Gets the source of `'cc'`.
-   * @param featureUnits Involved feature units.
-   * @param mapper If exists, map the feature unit name into another module request.
+  /**
+   * Gets the source of `'cc'`.
+   * @param featureUnits Involved feature units.
+   * @param mapper If exists, map the feature unit name into another module request.
    */
   evaluateIndexModuleSource(featureUnits: string[], mapper?: (featureUnit: string) => string): string;
-  /**
-   * Evaluates the source of `'internal-constants'`(`'cc/env'`),
-   * @param context
+  /**
+   * Evaluates the source of `'internal-constants'`(`'cc/env'`),
+   * @param context
    */
   evaluateEnvModuleSourceFromRecord(record: Record<string, unknown>): string;
-  /**
-   * Evaluates module overrides under specified context.
-   * @param context
+  /**
+   * Evaluates module overrides under specified context.
+   * @param context
    */
   evaluateModuleOverrides(context: Context): Record<string, string>;
   private static _readModulesInDir;
@@ -113,24 +113,24 @@ export declare namespace StatsQuery {
       WEBGPU: boolean;
       WASM_SUPPORT_MODE: number;
       FORCE_BANNING_BULLET_WASM: boolean;
-      /**
-       * Whether cull the asm.js module.
-       * If this is true, the external modules ending with '.asm.js' or 'js.mem' will be culled.
-       *
-       * @default false
+      /**
+       * Whether cull the asm.js module.
+       * If this is true, the external modules ending with '.asm.js' or 'js.mem' will be culled.
+       *
+       * @default false
        */
       CULL_ASM_JS_MODULE: boolean;
-      /**
-       * An internal constant to indicate whether need a fallback of wasm.
-       * If true, we build a wasm fallback module for the compatibility of wasm files compiled by different version of emscripten.
-       * This is useful when we use wasm on different version of Safari browsers.
-       *
-       * @default false
+      /**
+       * An internal constant to indicate whether need a fallback of wasm.
+       * If true, we build a wasm fallback module for the compatibility of wasm files compiled by different version of emscripten.
+       * This is useful when we use wasm on different version of Safari browsers.
+       *
+       * @default false
        */
       WASM_FALLBACK: boolean;
-      /**
-       * An internal constant to indicate whether we use wasm assets as minigame subpackage.
-       * This is useful when we need to reduce code size.
+      /**
+       * An internal constant to indicate whether we use wasm assets as minigame subpackage.
+       * This is useful when we need to reduce code size.
        */
       WASM_SUBPACKAGE: boolean;
     }

package/modules/stats-query/lib/index.js

@@ -73,12 +73,12 @@ const json5_1 = __importDefault(require("json5"));
 const dedent_1 = __importDefault(require("dedent"));
 const ConfigInterface = __importStar(require("./config-interface"));
 exports.ConfigInterface = ConfigInterface;
-/**
- * Query any any stats of the engine.
+/**
+ * Query any any stats of the engine.
  */
 class StatsQuery {
-  /**
-   * @param engine Path to the engine root.
+  /**
+   * @param engine Path to the engine root.
    */
   static create(engine) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -91,33 +91,33 @@ class StatsQuery {
       return query;
     });
   }
-  /**
-   * Gets the path to the engine root.
+  /**
+   * Gets the path to the engine root.
    */
   get path() {
     return this._engine;
   }
-  /**
-   * Gets the path to tsconfig.
+  /**
+   * Gets the path to tsconfig.
    */
   get tsConfigPath() {
     return path_1.default.join(this._engine, 'tsconfig.json');
   }
-  /**
-   * Gets all optimzie decorators
+  /**
+   * Gets all optimzie decorators
    */
   getOptimizeDecorators() {
     return this._config.optimizeDecorators;
   }
-  /**
-   * Gets all features defined.
+  /**
+   * Gets all features defined.
    */
   getFeatures() {
     return Object.keys(this._features);
   }
-  /**
-   * Returns if the specified feature is defined.
-   * @param feature Feature ID.
+  /**
+   * Returns if the specified feature is defined.
+   * @param feature Feature ID.
    */
   hasFeature(feature) {
     return !!this._features[feature];
@@ -126,9 +126,9 @@ class StatsQuery {
   // public isNativeOnlyFeature (feature: string) {
   //     return !!this._features[feature].isNativeOnly;
   // }
-  /**
-   * Gets all feature units included in specified features.
-   * @param featureIds Feature ID.
+  /**
+   * Gets all feature units included in specified features.
+   * @param featureIds Feature ID.
    */
   getUnitsOfFeatures(featureIds) {
     var _a;
@@ -149,36 +149,36 @@ class StatsQuery {
     }
     return flags;
   }
-  /**
-   * Gets all feature units in their names.
+  /**
+   * Gets all feature units in their names.
    */
   getFeatureUnits() {
     return Object.keys(this._featureUnits);
   }
-  /**
-   * Gets the path to source file of the feature unit.
-   * @param moduleId Name of the feature unit.
+  /**
+   * Gets the path to source file of the feature unit.
+   * @param moduleId Name of the feature unit.
    */
   getFeatureUnitFile(featureUnit) {
     return this._featureUnits[featureUnit];
   }
-  /**
-   * Gets all editor public modules in their names.
+  /**
+   * Gets all editor public modules in their names.
    */
   getEditorPublicModules() {
     return Object.keys(this._editorPublicModules);
   }
-  /**
-   * Gets the path to source file of the editor-public module.
-   * @param moduleName Name of the public module.
+  /**
+   * Gets the path to source file of the editor-public module.
+   * @param moduleName Name of the public module.
    */
   getEditorPublicModuleFile(moduleName) {
     return this._editorPublicModules[moduleName];
   }
-  /**
-   * Gets the source of `'cc'`.
-   * @param featureUnits Involved feature units.
-   * @param mapper If exists, map the feature unit name into another module request.
+  /**
+   * Gets the source of `'cc'`.
+   * @param featureUnits Involved feature units.
+   * @param mapper If exists, map the feature unit name into another module request.
    */
   evaluateIndexModuleSource(featureUnits, mapper) {
     return featureUnits.map(featureUnit => {
@@ -194,16 +194,16 @@ class StatsQuery {
       return `export * from '${(_b = mapper === null || mapper === void 0 ? void 0 : mapper(featureUnit)) !== null && _b !== void 0 ? _b : featureUnit}';`;
     }).join('\n');
   }
-  /**
-   * Evaluates the source of `'internal-constants'`(`'cc/env'`),
-   * @param context
+  /**
+   * Evaluates the source of `'internal-constants'`(`'cc/env'`),
+   * @param context
    */
   evaluateEnvModuleSourceFromRecord(record) {
     return Object.entries(record).map(([k, v]) => `export const ${k} = ${v};`).join('\n');
   }
-  /**
-   * Evaluates module overrides under specified context.
-   * @param context
+  /**
+   * Evaluates module overrides under specified context.
+   * @param context
    */
   evaluateModuleOverrides(context) {
     var _a;

package/package.json

@@ -1,11 +1,11 @@
 {
     "name": "@cocos/ccbuild",
-    "version": "2.0.3-alpha.2",
+    "version": "2.0.3-alpha.4",
     "description": "The next generation of build tool for Cocos engine.",
     "main": "./lib/src/index.js",
     "types": "./lib/src/index.d.ts",
     "files": [
-        "lib/src**/*",
+        "lib/src/**/*",
         "static/**/*",
         "CHANGELOG.md",
         "README.md",
@@ -21,9 +21,13 @@
         "build",
         "compile"
     ],
+    "workspaces": [
+        "./modules/*"
+    ],
     "author": "PP_Pro",
     "license": "MIT",
     "dependencies": {
+        "@types/resolve": "^1.20.2",
         "@typescript-eslint/eslint-plugin": "^5.52.0",
         "@typescript-eslint/parser": "^5.52.0",
         "dedent": "^0.7.0",
@@ -34,11 +38,18 @@
         "json5": "^2.2.3",
         "resolve": "^1.22.1",
         "typescript": "^4.3.5",
+        "semver": "~7.5.3",
+        "rollup": "^2.79.1",
+        "@rollup/plugin-babel": "^6.0.3",
+        "@rollup/plugin-commonjs": "^11.1.0",
+        "@rollup/plugin-json": "^4.1.0",
+        "@rollup/plugin-node-resolve": "^7.1.3",
+        "@rollup/plugin-virtual": "^3.0.1",
+        "@rollup/plugin-typescript": "~11.1.2",
+        "rollup-plugin-terser": "^7.0.2",
         "path": "~0.12.7",
         "commander": "~11.0.0",
         "ejs": "~3.1.9",
-        "@types/resolve": "^1.20.2",
-        "semver": "~7.5.3",
         "@babel/core": "^7.20.12",
         "@babel/parser": "^7.20.13",
         "@babel/plugin-syntax-decorators": "^7.19.0",
@@ -49,15 +60,7 @@
         "@cocos/babel-plugin-dynamic-import-vars": "^1.0.2",
         "@cocos/creator-programming-babel-preset-cc": "1.0.1-alpha.4",
         "@babel/plugin-transform-modules-systemjs": "~7.22.5",
-        "@babel/helper-module-imports": "7.18.6",
-        "rollup": "^2.79.1",
-        "@rollup/plugin-babel": "^6.0.3",
-        "@rollup/plugin-commonjs": "^11.1.0",
-        "@rollup/plugin-json": "^4.1.0",
-        "@rollup/plugin-node-resolve": "^7.1.3",
-        "@rollup/plugin-virtual": "^3.0.1",
-        "@rollup/plugin-typescript": "~11.1.2",
-        "rollup-plugin-terser": "^7.0.2"
+        "@babel/helper-module-imports": "7.18.6"
     },
     "exports": {
         ".": {

package/static/helper-dynamic-constants.txt

@@ -1,13 +1,13 @@
-function defined (name) {
-    const _global = typeof window === 'undefined' ? global : window;
-    return typeof _global[name] === 'object';
-}
-
-export const TEST = tryDefineGlobal('CC_TEST', defined('tap') || defined('QUnit'));
-export const EDITOR = tryDefineGlobal('CC_EDITOR', defined('Editor') && defined('process') && ('electron' in process.versions));
-export const PREVIEW = tryDefineGlobal('CC_PREVIEW', !EDITOR);
-export const JSB = tryDefineGlobal('CC_JSB', defined('jsb'));
-export const NATIVE = JSB;
-export const HTML5 = !(EDITOR && NATIVE);
-export const DEV = tryDefineGlobal('CC_DEV', true);
-export const EDITOR_NOT_IN_PREVIEW = EDITOR && !tryDefineGlobal('isPreviewProcess',false);
+function defined (name) {
+    const _global = typeof window === 'undefined' ? global : window;
+    return typeof _global[name] === 'object';
+}
+
+export const TEST = tryDefineGlobal('CC_TEST', defined('tap') || defined('QUnit'));
+export const EDITOR = tryDefineGlobal('CC_EDITOR', defined('Editor') && defined('process') && ('electron' in process.versions));
+export const PREVIEW = tryDefineGlobal('CC_PREVIEW', !EDITOR);
+export const JSB = tryDefineGlobal('CC_JSB', defined('jsb'));
+export const NATIVE = JSB;
+export const HTML5 = !(EDITOR && NATIVE);
+export const DEV = tryDefineGlobal('CC_DEV', true);
+export const EDITOR_NOT_IN_PREVIEW = EDITOR && !tryDefineGlobal('isPreviewProcess',false);

package/static/helper-file-decorator.ts

@@ -1,21 +1,21 @@
-
-/**
- * TsPropertyDecorator cannot access the property descriptor, sometimes we need to access the initializer in property descriptor.
- * This helper helps receive the initializer from EngineCompiler, and generate a BabelPropertyDecorator in runtime.
- * @param decoratorOrFactory A TsPropertyDecorator or a decorator factory
- * @param initializer the property initializer generate from engine compiler
- * @param factoryArgs if `decoratorOrFactory` is a factory, then we may need some arguments for this factory method.
- * @returns BabelPropertyDecorator
- */
-export function CCBuildTsFieldDecoratorHelper (decoratorOrFactory: Function, initializer: Function, ...factoryArgs: any[]): PropertyDecorator {
-    if (factoryArgs.length > 0) {
-        const decorator = decoratorOrFactory(...factoryArgs);
-        return (target, propertyKey) => {
-            decorator(target, propertyKey, initializer);
-        };
-    } else {
-        return (target, propertyKey) => {
-            decoratorOrFactory(target, propertyKey, initializer);
-        };
-    }
+
+/**
+ * TsPropertyDecorator cannot access the property descriptor, sometimes we need to access the initializer in property descriptor.
+ * This helper helps receive the initializer from EngineCompiler, and generate a BabelPropertyDecorator in runtime.
+ * @param decoratorOrFactory A TsPropertyDecorator or a decorator factory
+ * @param initializer the property initializer generate from engine compiler
+ * @param factoryArgs if `decoratorOrFactory` is a factory, then we may need some arguments for this factory method.
+ * @returns BabelPropertyDecorator
+ */
+export function CCBuildTsFieldDecoratorHelper (decoratorOrFactory: Function, initializer: Function | null, ...factoryArgs: any[]): PropertyDecorator {
+    if (factoryArgs.length > 0) {
+        const decorator = decoratorOrFactory(...factoryArgs);
+        return (target, propertyKey) => {
+            decorator(target, propertyKey, initializer);
+        };
+    } else {
+        return (target, propertyKey) => {
+            decoratorOrFactory(target, propertyKey, initializer);
+        };
+    }
 }

package/static/helper-global-exporter.txt

@@ -1,9 +1,9 @@
-function tryDefineGlobal (name, value) {
-    const _global = typeof window === 'undefined' ? global : window;
-    if (typeof _global[name] === 'undefined') {
-        return (_global[name] = value);
-    } else {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-        return _global[name];
-    }
+function tryDefineGlobal (name, value) {
+    const _global = typeof window === 'undefined' ? global : window;
+    if (typeof _global[name] === 'undefined') {
+        return (_global[name] = value);
+    } else {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return _global[name];
+    }
 }