add checkDepComponentInEditor decorator

[knoxHuang]

Re: # https://github.com/cocos/3d-tasks/discussions/18458

Depends: https://github.com/cocos/cocos-editor/pull/3127

Changelog

• add checkDepComponentInEditor decorator

---

Continuous Integration

This pull request:

• needs automatic test cases check.

  Manual trigger with @cocos-robot run test cases afterward.

• does not change any runtime related code or build configuration

  If any reviewer thinks the CI checks are needed, please uncheck this option, then close and reopen the issue.

---

Compatibility Check

This pull request:

• changes public API, and have ensured backward compatibility with deprecated features.
• affects platform compatibility, e.g. system version, browser version, platform sdk version, platform toolchain, language version, hardware compatibility etc.
• affects file structure of the build package or build configuration which requires user project upgrade.
• introduces breaking changes, please list all changes, affected features and the scope of violation.

Greptile Summary

This pull request introduces a new decorator checkDepComponentInEditor to enhance component dependency management in the Cocos Engine editor environment.

• Added checkDepComponentInEditor decorator in cocos/core/data/decorators/component.ts to check for dependent components before adding a new one
• Implemented _checkComponentInEditor property setting in cocos/scene-graph/component.ts for editor-related component checks
• Applied the new decorator to BuiltinPipelineSettings class in editor/assets/default_renderpipeline/builtin-pipeline-settings.ts
• Added localization strings for dependency warning messages in both English and Chinese (editor/i18n/en/components.js and editor/i18n/zh/components.js)

[greptile-apps]

_{6 file(s) reviewed, 1 comment(s)
Edit PR Review Bot Settings}

[greptile-apps]

style: Consider adding a return type annotation for clarity

[github-actions]

Interface Check Report

! WARNING this pull request has changed these public interfaces:

@@ -20927,8 +20927,23 @@
          * ```
          */
         export const requireComponent: (requiredComponent: Function | Function[]) => ClassDecorator;
         /**
+         * @en Checks for dependent components before adding a component declared as CCClass. If the dependent component does not exist, prompt for it
+         * @zh 为声明为 CCClass 的组件进行添加前检查依赖组件。如果依赖的组件不存在，进行提示
+         * @param checkDepComponentInEditor
+         * @example
+         * ```ts
+         * import { _decorator, Sprite, Component } from cc;
+         * import { ccclass, checkDepComponentInEditor } from _decorator;
+         *
+         * @ccclass
+         * @checkDepComponentInEditor('cc.Sprite')
+         * class SpriteCtrl extends Component {}
+         * ```
+         */
+        export const checkDepComponentInEditor: (component: string | string[]) => ClassDecorator;
+        /**
          * @en Set the component priority, it decides at which order the life cycle functions of components will be invoked. Smaller priority gets invoked before larger priority.
          * This will affect `onLoad`, `onEnable`, `start`, `update` and `lateUpdate`, but `onDisable` and `onDestroy` won't be affected.
          * @zh 设置脚本生命周期方法调用的优先级。优先级小于 0 的组件将会优先执行，优先级大于 0 的组件将会延后执行。优先级仅会影响 onLoad, onEnable, start, update 和 lateUpdate，而 onDisable 和 onDestroy 不受影响。
          * @param priority - The execution order of life cycle methods for Component. Smaller priority gets invoked before larger priority.