Add build-engine option visualize.

.api/public.d.ts

@@ -122,6 +122,13 @@ declare module "@cocos/ccbuild" {
              * @default false
              */
             preserveType?: boolean;
+            visualize?: boolean | {
+                file?: string;
+            };
+            /**
+             * Generate cocos/native-binding/decorators.ts for native platforms
+             */
+            generateDecoratorsForJSB?: boolean;
             /**
              * Whether to generate a json file that contains all output script file paths.
              */

modules/build-engine/package.json

@@ -40,5 +40,8 @@
     "@types/semver": "~7.5.0",
     "@types/node": "~20.3.3",
     "@types/glob": "~7.2.0"
+  },
+  "optionalDependencies": {
+    "rollup-plugin-visualizer": "5.9.2"
   }
 }

modules/build-engine/src/engine-js/index.ts

@@ -338,26 +338,26 @@ export async function buildJsEngine(options: Required<buildEngine.Options>): Pro
         }));
     }
 
-    // const visualizeOptions = typeof options.visualize === 'object'
-    //     ? options.visualize
-    //     : (options.visualize ? {} : undefined);
-    // if (visualizeOptions) {
-    //     let rpVisualizer;
-    //     try {
-    //         // @ts-expect-error: No typing
-    //         rpVisualizer = await import('rollup-plugin-visualizer');
-    //     } catch {
-    //         console.warn('Visualizing needs \'rollup-plugin-visualizer\' to be installed. It\'s installed as dev-dependency.');
-    //     }
-    //     if (rpVisualizer) {
-    //         const visualizeFile = visualizeOptions.file ?? ps.join(options.out, 'visualize.html');
-    //         rollupPlugins.push(rpVisualizer({
-    //             filename: visualizeFile,
-    //             title: 'Cocos Creator build visualizer',
-    //             template: 'treemap',
-    //         }));
-    //     }
-    // }
+    const visualizeOptions = typeof options.visualize === 'object'
+        ? options.visualize
+        : (options.visualize ? {} : undefined);
+    if (visualizeOptions) {
+        let rpVisualizer;
+        try {
+            // eslint-disable-next-line import/no-extraneous-dependencies
+            rpVisualizer = await import('rollup-plugin-visualizer');
+        } catch {
+            console.warn('Visualizing needs \'rollup-plugin-visualizer\' to be installed. It\'s installed as dev-dependency.');
+        }
+        if (rpVisualizer) {
+            const visualizeFile = visualizeOptions.file ?? ps.join(options.out, 'visualize.html');
+            rollupPlugins.push(rpVisualizer.visualizer({
+                filename: visualizeFile,
+                title: 'Cocos Creator build visualizer',
+                template: 'treemap',
+            }));
+        }
+    }
 
     let hasCriticalWarns = false;
 

modules/build-engine/src/index.ts

@@ -187,9 +187,9 @@ export namespace buildEngine {
          */
         preserveType?: boolean;
 
-        // visualize?: boolean | {
-        //     file?: string;
-        // };
+        visualize?: boolean | {
+            file?: string;
+        };
 
         // buildTimeConstants: IBuildTimeConstants;