feat: doxygen comments

Author: Charliechen114514

ui/components/material/cfmaterial_animation_factory.h

@@ -268,13 +268,13 @@ class CF_UI_EXPORT CFMaterialAnimationFactory : public ICFAnimationManagerFactor
      *          Unlike createAnimation(), this method always creates a new
      *          animation instance and does not use token-based lookup.
      *
-     * @param  value Pointer to the float property to animate.
-     *               Must remain valid for the lifetime of the animation.
-     * @param  from Start value of the animation.
-     * @param  to End value of the animation.
-     * @param  durationMs Duration of the animation in milliseconds.
-     * @param  easing Easing type for the animation.
-     * @param  targetWidget Optional target widget for repaint notifications.
+     * @param[in]     value Pointer to the float property to animate.
+     *                    Must remain valid for the lifetime of the animation.
+     * @param[in]     from Start value of the animation.
+     * @param[in]     to End value of the animation.
+     * @param[in]     durationMs Duration of the animation in milliseconds.
+     * @param[in]     easing Easing type for the animation.
+     * @param[in]     targetWidget Optional target widget for repaint notifications.
      *
      * @return WeakPtr to the created animation, or invalid WeakPtr if:
      *         - Global enabled is false

ui/components/material/cfmaterial_property_animation.h

@@ -86,7 +86,8 @@ class CF_UI_EXPORT CFMaterialPropertyAnimation : public ICFAbstractAnimation {
      * @ingroup       ui_components_material
      */
     CFMaterialPropertyAnimation(float* value, float from, float to, int durationMs,
-                                base::Easing::Type easing = base::Easing::Type::EmphasizedDecelerate,
+                                base::Easing::Type easing =
+                                    base::Easing::Type::EmphasizedDecelerate,
                                 QObject* parent = nullptr);
 
     /**
@@ -106,10 +107,45 @@ class CF_UI_EXPORT CFMaterialPropertyAnimation : public ICFAbstractAnimation {
     // ICFAbstractAnimation Interface
     // =========================================================================
 
+    /**
+     * @brief  Start the animation.
+     *
+     * @param[in] dir Direction to play the animation.
+     *
+     * @since 0.1
+     */
     void start(Direction dir = Direction::Forward) override;
+
+    /**
+     * @brief  Pause the animation.
+     *
+     * @since 0.1
+     */
     void pause() override;
+
+    /**
+     * @brief  Stop the animation and reset to initial state.
+     *
+     * @since 0.1
+     */
     void stop() override;
+
+    /**
+     * @brief  Reverse the animation direction.
+     *
+     * @since 0.1
+     */
     void reverse() override;
+
+    /**
+     * @brief  Update animation state by delta time.
+     *
+     * @param[in] dt Delta time in milliseconds.
+     *
+     * @return     true if animation is still running, false if finished.
+     *
+     * @since      0.1
+     */
     bool tick(int dt) override;
     cf::WeakPtr<ICFAbstractAnimation> GetWeakPtr() override {
         return weak_factory_.GetWeakPtr();
@@ -122,7 +158,7 @@ class CF_UI_EXPORT CFMaterialPropertyAnimation : public ICFAbstractAnimation {
     /**
      * @brief  Set the target widget for repaint notifications.
      *
-     * @details The widget will receive update() calls during animation
+     * @details The widget receives update() calls during animation
      *          to trigger repaints.
      *
      * @param[in]     widget Target widget (may be nullptr).

ui/widget/material/widget/textarea/textarea.h

@@ -312,7 +312,7 @@ class CF_UI_EXPORT TextArea : public QTextEdit {
      * @return        Maximum number of lines, or 0 for unlimited.
      *
      * @throws        None
-     * @note          0 means no maximum (scrollbar will appear).
+     * @note          0 means no maximum (scrollbar appears).
      * @warning       None
      * @since         0.1
      * @ingroup      ui_widget_material_widget
@@ -325,7 +325,7 @@ class CF_UI_EXPORT TextArea : public QTextEdit {
      * @param[in]     lines Maximum number of visible lines, or 0 for unlimited.
      *
      * @throws        None
-     * @note          When set, the text area will grow up to this many lines.
+     * @note          When set, the text area grows up to this many lines.
      * @warning       None
      * @since         0.1
      * @ingroup       ui_widget_material_widget