@cocos/ccbuild 1.1.18 → 1.1.20

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

@@ -1,146 +1,148 @@
-import { StatsQuery } from "../stats-query";
-export declare function buildEngine(options: buildEngine.Options): Promise<buildEngine.Result>;
-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'
-         */
-        moduleFormat?: ModuleFormat;
-        /**
-         * 是否对生成结果进行压缩。
-         * @default false
-         */
-        compress?: boolean;
-        /**
-         * 是否生成 source map。
-         * 若为 `inline` 则生成内联的 source map。
-         * @default false
-         */
-        sourceMap?: boolean | 'inline';
-        /**
-         * 若 `sourceMap` 为 `true`，此选项指定了 source map 的路径。
-         * @default `${outputPath.map}`
-         */
-        sourceMapFile?: string;
-        /**
-         * 若为 `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
-         */
-        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
-         */
-        noDeprecatedFeatures?: string | boolean;
-        /**
-         * Experimental.
-         */
-        incremental?: string;
-        /**
-         * BrowsersList targets.
-         */
-        targets?: string | string[] | Record<string, string>;
-        /**
-         * Enable loose compilation.
-         */
-        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.
-         */
-        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
-         */
-        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",
-         * }
-         * ```
-         */
-        exports: Record<string, string>;
-        /**
-         * The compulsory import mappings that should be applied.
-         */
-        chunkAliases: Record<string, string>;
-        /**
-         * The dependency graph, only including dependency chunks.
-         *
-         * @deprecated please use `chunkDepGraph` instead.
-         */
-        dependencyGraph?: Record<string, string[]>;
-        chunkDepGraph: Record<string, string[]>;
-        assetDepGraph: Record<string, string[]>;
-        hasCriticalWarns: boolean;
-    }
-    function transform(code: string, moduleOption: ModuleFormat, loose?: boolean): Promise<{
-        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.
-     *
-     * @deprecated since 1.1.11, please use `enumerateAllDependents` instead.
-     */
-    function enumerateDependentChunks(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.
-     */
-    function enumerateAllDependents(meta: buildEngine.Result, featureUnits: string[]): string[];
-}
+import { StatsQuery } from "../stats-query";
+export declare function buildEngine(options: buildEngine.Options): Promise<buildEngine.Result>;
+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'
+         */
+        moduleFormat?: ModuleFormat;
+        /**
+         * 是否对生成结果进行压缩。
+         * @default false
+         */
+        compress?: boolean;
+        /**
+         * 是否生成 source map。
+         * 若为 `inline` 则生成内联的 source map。
+         * @default false
+         */
+        sourceMap?: boolean | 'inline';
+        /**
+         * 若 `sourceMap` 为 `true`，此选项指定了 source map 的路径。
+         * @default `${outputPath.map}`
+         */
+        sourceMapFile?: string;
+        /**
+         * 若为 `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
+         */
+        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
+         */
+        noDeprecatedFeatures?: string | boolean;
+        /**
+         * Experimental.
+         */
+        incremental?: string;
+        /**
+         * BrowsersList targets.
+         */
+        targets?: string | string[] | Record<string, string>;
+        /**
+         * 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.
+         */
+        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
+         */
+        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",
+         * }
+         * ```
+         */
+        exports: Record<string, string>;
+        /**
+         * The compulsory import mappings that should be applied.
+         */
+        chunkAliases: Record<string, string>;
+        /**
+         * The dependency graph, only including dependency chunks.
+         *
+         * @deprecated please use `chunkDepGraph` instead.
+         */
+        dependencyGraph?: Record<string, string[]>;
+        chunkDepGraph: Record<string, string[]>;
+        assetDepGraph: Record<string, string[]>;
+        hasCriticalWarns: boolean;
+    }
+    function transform(code: string, moduleOption: ModuleFormat, loose?: boolean): Promise<{
+        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.
+     *
+     * @deprecated since 1.1.11, please use `enumerateAllDependents` instead.
+     */
+    function enumerateDependentChunks(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.
+     */
+    function enumerateAllDependents(meta: buildEngine.Result, featureUnits: string[]): string[];
+}
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build-engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAe5C,wBAAsB,WAAW,CAAE,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAmB5F;AAED,yBAAiB,WAAW,CAAC;IACzB,KAAY,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAE7D,UAAiB,OAAO;QACpB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,GAAG,EAAE,MAAM,CAAC;QAGZ,IAAI,EAAE,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC;QAE1C,QAAQ,EAAE,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC;QAElD,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAExD;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAEpB;;;WAGG;QACH,YAAY,CAAC,EAAE,YAAY,CAAC;QAE5B;;;WAGG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB;;;;WAIG;QACH,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAE/B;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB;;;;WAIG;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB;;;;;;;;;;;;;WAaG;QACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;QAElC;;;;WAIG;QACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAExC;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAIrB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAErD;;WAEG;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB;;;;;;;;;;;WAWG;QACH,cAAc,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;QAElF;;;;;WAKG;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;KAiB1B;IAED,UAAiB,MAAM;QACnB;;;;;;;;WAQG;QACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEhC;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAErC;;;;WAIG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAExC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAExC,gBAAgB,EAAE,OAAO,CAAC;KAC7B;IAED,SAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,OAAO;;OAWxF;IAaD,SAAsB,eAAe,CAAC,eAAe,EAAE,MAAM,oBAuB5D;IA0CD;;;;;;OAMG;IACH,SAAgB,wBAAwB,CAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAEzF;IAED;;;;OAIG;IACH,SAAgB,sBAAsB,CAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAIvF;CACJ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build-engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgB5C,wBAAsB,WAAW,CAAE,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAmB5F;AAED,yBAAiB,WAAW,CAAC;IACzB,KAAY,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAE7D,UAAiB,OAAO;QACpB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,GAAG,EAAE,MAAM,CAAC;QAGZ,IAAI,EAAE,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC;QAE1C,QAAQ,EAAE,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC;QAElD,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAExD;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAEpB;;;WAGG;QACH,YAAY,CAAC,EAAE,YAAY,CAAC;QAE5B;;;WAGG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB;;;;WAIG;QACH,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAE/B;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB;;;;WAIG;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB;;;;;;;;;;;;;WAaG;QACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;QAElC;;;;WAIG;QACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAExC;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAIrB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAErD;;;;WAIG;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB;;;;;;;;;;;WAWG;QACH,cAAc,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;QAElF;;;;;WAKG;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;KAiB1B;IAED,UAAiB,MAAM;QACnB;;;;;;;;WAQG;QACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEhC;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAErC;;;;WAIG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAExC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAExC,gBAAgB,EAAE,OAAO,CAAC;KAC7B;IAED,SAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,OAAO;;OAWxF;IAaD,SAAsB,eAAe,CAAC,eAAe,EAAE,MAAM,oBAuB5D;IA0CD;;;;;;OAMG;IACH,SAAgB,wBAAwB,CAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAEzF;IAED;;;;OAIG;IACH,SAAgB,sBAAsB,CAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAIvF;CACJ"}