Merge branch 'main' into add-cache-extent-property

# Conflicts:
#	CHANGELOG.md
#	lib/src/cupertino_swipe_refresh.dart
#	lib/src/material_swipe_refresh.dart
#	lib/src/swipe_refresh.dart

.fvmrc

@@ -0,0 +1,3 @@
+{
+  "flutter": "3.19.0"
+}

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,58 @@
+---
+name: Bug report
+about: Something is wrong.
+title: "[BUG] "
+labels: bug
+---
+<!--
+    Thank you for contributing to our project!
+    This template is only for bugfix reports, otherwise please use another template.
+-->
+## Expected behavior
+<!--Tell us what should happen-->
+
+## Actual behavior
+<!--Tell us what happens instead-->
+
+## Video/Screenshot
+<!--Attach file with a reproduction of bug-->
+
+## Steps to reproduce
+<!--
+1)...
+2)...
+3)...
+...
+-->
+
+## Details
+Flutter version: <!--android/ios/web/desktop-->
+
+Dart version: <!--android/ios/web/desktop-->
+
+Platform: <!--android/ios/web/desktop-->
+
+## Logs and stacktrace
+<!--
+Error details
+-->
+
+## Any possible solutions
+<!--
+Optional
+What do you think would solve the problem?
+-->
+
+## What did you try to solve
+<!--
+Optional
+What did you try to solve the problem?
+-->
+
+## Checklist for self-check
+- [ ] Added expected and actual behavior.
+- [ ] Added video or screenshot of bug.
+- [ ] Added isolated way to reproduce the bug.
+- [ ] Specified Flutter, Dart version and platforms.
+- [ ] Attached error code and logs.
+- [ ] All unspecified fields in the Issue description are deleted.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: SurfGear telegram chat
+    url: https://t.me/SurfGear
+    about: Please ask and answer questions here.

.github/ISSUE_TEMPLATE/documentation_update.md

@@ -0,0 +1,20 @@
+---
+name: Documentation update
+about: Fixing a problem or improve in an existing docs page.
+labels: documentation
+---
+<!--
+    Thank you for contributing to our project!
+    This template is only for documentation update reports, otherwise please use another template.
+-->
+## Specify package name
+<!--Write the name of the package where you have problems-->
+
+## Describe what scenario you think is uncovered by the existing examples / articles
+<!--A clear and concise description of the problem that you want explained.-->
+
+## Describe why existing examples / articles do not cover this case
+<!--Explain which examples / articles you have seen before making this request, and why they did not help you with your problem.-->
+
+## Additional context
+<!--Add any other context or screenshots about the documentation request here.-->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: I'd like SurfGear team to do something new.
+labels: enhancement
+---
+<!--
+    Thank you for contributing to our project!
+    This template is only for feature requests, otherwise please use another template.
+
+    Provide thoughtful commentary *and code samples* on what this feature means for your product. What will it allow you to do that you can't do today? How will it make current workarounds straightforward? What potential bugs and edge cases does it help to avoid? etc. Please keep it product-centric.
+-->
+## Specify package name
+<!--Write the name of the package where you have problems-->
+
+## What is the new or updated feature that you are suggesting?
+<!--A clear and concise description of what you want to happen.-->
+
+## Why should this feature be included?
+<!--Is your feature request related to a problem? Please describe a clear and concise description of what the problem is. If you investigate any alternative solutions, please describe.-->
+
+## Additional context
+<!--Please provide any other context or screenshots about the feature request here.-->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,6 @@
+Tap on "Preview" ⤴
+
+And choose one of the templates:
+* [Bugfix PR](?expand=1&template=bug_fix.md)
+* [New feature PR](?expand=1&template=new_feature.md)
+* [Documentation update PR](?expand=1&template=documentation_update.md)

.github/PULL_REQUEST_TEMPLATE/bug_fix.md

@@ -0,0 +1,23 @@
+<!--
+    Thank you for contributing to our project!
+    Provide a description of your changes below and a general summary in the title.
+    Please look at the following checklist to ensure that your PR can be accepted quickly:
+-->
+## Checklist
+
+- [ ] Have you added an explanation of what your changes do and why you'd like us to include them?
+- [ ] Is there an existing issue for this PR?
+  - _link issue here_ (use keywords like `fix`, `close`, `resolve` etc. if necessary)
+- [ ] Have the files been linted and formatted?
+- [ ] Have the docs been updated to match the changes in the PR?
+- [ ] Have the tests been updated to match the changes in the PR?
+- [ ] Attached videos/screenshots demonstrating the fix/feature.
+- [ ] Have you run the tests locally to confirm they pass?
+
+## Changes
+
+### What is the current behavior, and the steps to reproduce the issue?
+
+### What is the expected behavior?
+
+### How does this PR fix the problem?

.github/PULL_REQUEST_TEMPLATE/documentation_update.md

@@ -0,0 +1,21 @@
+<!--
+    Thank you for contributing to our project!
+    Provide a description of your changes below and a general summary in the title.
+    Please look at the following checklist to ensure that your PR can be accepted quickly:
+-->
+## Checklist
+
+- [ ] Is there an existing issue for this PR?
+  - _link issue here_ (use keywords like `fix`, `close`, `resolve` etc. if necessary)
+- [ ] Have the files been linted and formatted?
+
+## Changes
+
+### What docs page needs to be fixed?
+
+- **Section**:
+- **Page**:
+
+## What is the problem?
+
+## What changes does this PR make to fix the problem?

.github/PULL_REQUEST_TEMPLATE/new_feature.md

@@ -0,0 +1,21 @@
+<!--
+    Thank you for contributing to our project!
+    Provide a description of your changes below and a general summary in the title.
+    Please look at the following checklist to ensure that your PR can be accepted quickly:
+-->
+## Checklist
+
+- [ ] Have you added an explanation of what your changes do and why you'd like us to include them?
+- [ ] Is there an existing issue for this PR?
+  - _link issue here_ (use keywords like `fix`, `close`, `resolve` etc. if necessary)
+- [ ] Have the files been linted and formatted?
+- [ ] Have the docs been updated to match the changes in the PR?
+- [ ] Have the tests been updated to match the changes in the PR?
+- [ ] Attached videos/screenshots demonstrating the fix/feature.
+- [ ] Have you run the tests locally to confirm they pass?
+
+## New Features
+
+### What new capabilities does this PR add?
+
+### What docs changes are needed to explain this?

.github/workflows/check_issue.yaml

@@ -0,0 +1,15 @@
+name: "Checking issue for correctness of described"
+
+on:
+  issues:
+    types:
+      - reopened
+      - opened
+
+jobs:
+  check-issue:
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/check_issues.yaml@main
+    with:
+      REPO_PATH: 'https://github.com/surfstudio/flutter-swipe-refresh/issues/new/choose'
+      ISSUE_TITLE: ${{ github.event.issue.title }}
+      ISSUE_BODY: ${{ github.event.issue.body }}

.github/workflows/main.yml

@@ -0,0 +1,45 @@
+name: "Main"
+
+on:
+  pull_request:
+
+jobs:
+  get_fvm_version:
+    outputs:
+      flutter_version: ${{ steps.fvm_version.outputs.flutter }}
+    name: "Get Flutter version from FVM"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - id: fvm_version
+        uses: zoexx/github-action-json-file-properties@release
+        with:
+          file_path: ".fvmrc"
+
+  analysis:
+    needs: get_fvm_version
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/analysis.yml@main
+    with:
+      flutter-version: ${{ needs.get_fvm_version.outputs.flutter_version }}
+
+  testing:
+    needs: [analysis, get_fvm_version]
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/testing.yml@main
+    with:
+      flutter-version: ${{ needs.get_fvm_version.outputs.flutter_version }}
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  build_android_example:
+    needs: [analysis, get_fvm_version]
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/build_android_example.yml@main
+    with:
+      flutter-version: ${{ needs.get_fvm_version.outputs.flutter_version }}
+
+  build_ios_example:
+    needs: [analysis, get_fvm_version]
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/build_ios_example.yml@main
+    with:
+      flutter-version: ${{ needs.get_fvm_version.outputs.flutter_version }}

.github/workflows/new_issue_to_pyrus_task.yml

@@ -0,0 +1,35 @@
+name: "Create Pyrus task from issue"
+
+on:
+  issues:
+    types:
+      - reopened
+      - opened
+
+jobs:
+  get_package_name:
+    name: Get package name
+    runs-on: ubuntu-latest
+    outputs:
+      package_name: ${{ steps.parse_pubspec.outputs.name }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Parsing pubspec.yaml
+        id: parse_pubspec
+        uses: actions-tools/yaml-outputs@v2
+        with:
+          file-path: 'pubspec.yaml'
+
+  call_create_pyrus_task_from_issue:
+    name: Create Pyrus task from issue
+    needs: get_package_name
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/new_issue_to_pyrus_task.yml@main
+    with:
+      PACKAGE_NAME: ${{ needs.get_package_name.outputs.package_name }}
+      ISSUE_TITLE: ${{ github.event.issue.title }}
+      ISSUE_BODY: ${{ github.event.issue.body }}
+      ISSUE_LINK: ${{ github.event.issue.html_url }}
+    secrets:
+      LOGIN: ${{ secrets.PYRUS_BOT_LOGIN }}
+      SECURITY_KEY: ${{ secrets.PYRUS_BOT_SECRET_KEY }}

.github/workflows/new_issues_label.yml

@@ -0,0 +1,16 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Label issues
+on:
+  issues:
+    types:
+      - reopened
+      - opened
+jobs:
+  label_issues:
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/new_issues_label.yml@main
+    secrets:
+      SECRET_ISSUES: ${{ secrets.ACCESS_TOKEN_FOR_SURFGEAR }}

.github/workflows/new_pull_request_label.yml

@@ -0,0 +1,17 @@
+# This workflow is triggered when a WIP label is added to an open pull request.
+# When deleting the WIP label, the new_pull_request label is added.
+# When adding a WIP label, the new_pull_request label is removed if there is one.
+
+name: Pull-request label tracking
+on:
+  pull_request_target:
+    types:
+      - labeled
+      - unlabeled
+
+jobs:
+  label_pull_request:
+    if: ${{ github.event.label.name == 'WIP' }}
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/new_pull_request_label.yml@main
+    secrets:
+      SECRET_ISSUES: ${{ secrets.ACCESS_TOKEN_FOR_SURFGEAR }}

.github/workflows/new_pull_request_main_actions.yml

@@ -0,0 +1,22 @@
+# This workflow is triggered when a pull request opened, edited, reopened,
+# converted_to_draft and ready_for_review.
+#
+# There is no WIP in the title, there is no WIP label and the pull request is not a draft the
+# new pull request label is added.
+# If either of these is true then remove the label new pull request if there is one.
+
+name: Pull-request tracking
+on:
+  pull_request_target:
+    types:
+      - opened
+      - edited
+      - reopened
+      - converted_to_draft
+      - ready_for_review
+
+jobs:
+  pull_request:
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/new_pull_request_label.yml@main
+    secrets:
+      SECRET_ISSUES: ${{ secrets.ACCESS_TOKEN_FOR_SURFGEAR }}

.github/workflows/publish_to_pub.yml

@@ -0,0 +1,46 @@
+name: "Publishing"
+
+on:
+  push:
+    tags:
+      - v*
+
+jobs:
+  get_fvm_version:
+    outputs:
+      flutter_version: ${{ steps.fvm_version.outputs.flutter }}
+    name: "Get Flutter version from FVM"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - id: fvm_version
+        uses: zoexx/github-action-json-file-properties@release
+        with:
+          file_path: ".fvmrc"
+
+  analysis:
+    needs: get_fvm_version
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/analysis.yml@main
+    with:
+      flutter-version: ${{ needs.get_fvm_version.outputs.flutter_version }}
+
+  testing:
+    needs: [analysis, get_fvm_version]
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/testing.yml@main
+    with:
+      flutter-version: ${{ needs.get_fvm_version.outputs.flutter_version }}
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  package-publishing:
+    needs: [analysis, testing, get_fvm_version]
+    uses: surfstudio/flutter-ci-workflows/.github/workflows/publish_to_pub.yml@main
+    with:
+      flutter-version: ${{ needs.get_fvm_version.outputs.flutter_version }}
+      PANA_TOTAL: "100"
+    secrets:
+      PUB_CREDENTIAL_JSON: ${{ secrets.SURF_PUB_CREDENTIAL_JSON }}
+      PUB_OAUTH_ACCESS_TOKEN: ${{ secrets.SURF_PUB_OAUTH_ACCESS_TOKEN }}
+      PUB_OAUTH_REFRESH_TOKEN: ${{ secrets.SURF_PUB_OAUTH_REFRESH_TOKEN }}