Add Enhanced Navigation Methods to WoltModalSheet

[ulusoyca]

Description

This pull request introduces a comprehensive suite of navigation methods to the WoltModalSheet widget. These methods are designed to facilitate more intuitive and adaptable multi-page in-modal navigation scenarios.

Note that this is not a breaking page. Users can still use pageIndexNotifier for navigation.

Dynamic Stack Management

Add Single Page	Add Multiple Page
add_single_page.mov	add_multiple_pages.mov

Push Multiple Page
push_multi_page.mov

Replace Current Page	Replace Previous Page
replace_current_page.mov	replace_previous_page.mov

Replace All Pages	Pop Page
replace_all_pages.mov	pop_page.mov

Key Navigation Methods Added:
addPages, addPage: Append new pages to the navigation stack.
replaceCurrentPage, replaceAllPages, replacePage: Replace existing pages in the stack.
removePage, removeUntil: Remove pages from the stack based on specific criteria.
pushPages, pushPage: Push new pages onto the stack and display them immediately.
popPage: Pop the top page from the navigation stack.
showNext, showPrevious: Navigate forward or backward within the stack.
showAtIndex, showPageWithId: Navigate directly to a specific page by index or ID.

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 0f8c7b8):

• https://coffeemakerexample--pr188-refactor-in-app-navi-zkby7j7w.web.app
• https://playgroundwoltexample--pr188-refactor-in-app-navi-1onzg4fr.web.app
• https://playgroundnavigator2woltexample--pr188-refactor-in-app-u4xjsu67.web.app

_{(expires Fri, 10 May 2024 06:52:13 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 906758393beb0353b979d020649d6a1efc40fb5b}

[TahaTesser]

Excellent PR Overall!

I'd prefer the main lib changes and example changes are split separate PRs in future. This makes it easy to read the library code and test the changes. We might require tests in the future.

[TahaTesser]

Please rebase after merging #192

[TahaTesser]

@ulusoyca
Add the following skip tag in the line 226 in wolt_modal_sheet_test.dart file.

    // Reset the physical size and device pixel ratio.
    tester.view.resetPhysicalSize();
    tester.view.resetDevicePixelRatio();
  }, skip: true);

I'll update the tests in the future.

[TahaTesser]

LGTM!

[dickermoshe]

Thank y'all so much. This is package is a dream!

When do you think this'll be on pub?