Refactor updateCurrentPage method and introduce easy page update

[ulusoyca]

Description

This PR introduces significant refactoring to the updateCurrentPage method. The aim is to enhance flexibility and enable more dynamic updates to the properties of the currently visible page without the need for decorator field and wrapping the components with Builder or ValueListenableBuilder widgets.

Previously, the method directly replaced the current page's properties by accepting a new SliverWoltModalSheetPage instance. The refactor changes this approach by instead accepting a function (updateFunction) that applies updates to the current page using copyWith method.

Example

A new case to the playground app is added: Page with updateCurrentPage method.

Screen recording:

update_page_rec.mov

_ConfigSwitch(
  label: 'Is top bar layer visible',
  initialConfigValue: hasTopBarLayer,
  updatePageCallback: ({required bool newValue}) {
    WoltModalSheet.of(context).updateCurrentPage((currentPage) {
      return currentPage.copyWithChild(
        isTopBarLayerAlwaysVisible: newValue,
        hasTopBarLayer: newValue,
        topBarTitle: newValue ? const ModalSheetTopBarTitle('Update page') : const SizedBox.shrink(),
        leadingNavBarWidget: newValue ? const WoltModalSheetBackButton() : const SizedBox.shrink(),
        trailingNavBarWidget: newValue ? const WoltModalSheetCloseButton() : const SizedBox.shrink(),
        child: const Placeholder(fallbackHeight: 1200, color: Colors.pink),
      );
    });
  },
),

_ConfigSwitch(
  label: 'Enable Drag for Bottom Sheet',
  initialConfigValue: enableDrag,
  updatePageCallback: ({required bool newValue}) {
    WoltModalSheet.of(context).updateCurrentPage((currentPage) {
      return currentPage.copyWith(
          enableDrag: newValue,
          mainContentSliversBuilder: (context) {
            return [
              SliverToBoxAdapter(
                child: Placeholder(
                  fallbackHeight: MediaQuery.sizeOf(context).height / 2,
                  color: Colors.green,
                ),
              ),
            ];
          });
    });
  },
),

Related Issues

Replace this paragraph with a list of issues related to this PR from the issue database. Indicate, which of these issues are resolved or fixed by this PR.

Checklist

Before you create this PR confirm that it meets all requirements listed below by checking the relevant checkboxes ([x]).
This will ensure a smooth and quick review process.

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
• My PR includes tests for all changed/updated/fixed behaviors.
• All existing and new tests are passing.
• I updated/added relevant documentation (doc comments with ///).
• The analyzer (melos run analyze) does not report any problems on my PR.
• The package compiles with the minimum Flutter version stated in the pubspec.yaml

Breaking Change

Does your PR require plugin users to manually update their apps to accommodate your change?

• Yes, this is a breaking change.
• No, this is not a breaking change.

[github-actions]

Visit the preview URL for this PR (updated for commit 34572b0):

• https://coffeemakerexample--pr213-refactor-update-curr-9v9teqv9.web.app
• https://playgroundwoltexample--pr213-refactor-update-curr-r3vl7wql.web.app
• https://playgroundnavigator2woltexample--pr213-refactor-update-kjg7g22o.web.app

_{(expires Tue, 04 Jun 2024 12:29:07 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 906758393beb0353b979d020649d6a1efc40fb5b}

[TahaTesser]

LGTM! (Please execute dart format . in the root directory to fix format check)