chore(release): package:win32_runner v0.2.4

Author: halildurmus

.github/workflows/publish.yml

@@ -1,12 +1,18 @@
 name: Publish
 
 on:
+  pull_request:
+    branches: [main]
   push:
-    tags: ['v[0-9]+.[0-9]+.[0-9]+*']
+    tags: ['[A-z0-9]+-v[0-9]+.[0-9]+.[0-9]+*']
 
 jobs:
   publish:
+    if: ${{ github.repository_owner == 'halildurmus' }}
     name: Publish to pub.dev
     permissions:
       id-token: write
-    uses: dart-lang/setup-dart/.github/workflows/publish.yml@main
+      pull-requests: write
+    uses: dart-lang/ecosystem/.github/workflows/publish.yaml@main
+    with:
+      write-comments: false

.github/workflows/release.yml

@@ -24,14 +24,15 @@ jobs:
       - name: 🔍 Check if There is a Release Commit
         id: check_release
         run: |
-          latest_commit_msg=$(git log -1 --pretty=format:%s)
-          echo "📜 Latest commit: $latest_commit_msg"
+          msg=$(git log -1 --pretty=format:%s)
+          echo "📜 Latest commit: $msg"
 
-          if [[ "$latest_commit_msg" =~ ^chore\(release\):\ v.* ]]; then
-            echo "🎉 Release commit detected. Proceeding with the publish step."
+          if [[ "$msg" =~ chore\(release\):[[:space:]]+.*package:([a-zA-Z0-9_]+).*v ]]; then
+            pkg="${BASH_REMATCH[1]}"
+            echo "🎯 Package: $pkg"
             echo "should_publish=true" >> $GITHUB_OUTPUT
           else
-            echo "❌ No release commit detected. Skipping the publish step."
+            echo "❌ Not a release commit"
             echo "should_publish=false" >> $GITHUB_OUTPUT
           fi
 

.vscode/settings.json

@@ -1,3 +1,15 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.2.4] - 2026-02-23
+
+### 📦 Dependencies
+
+- Bumped minimum required Dart SDK version to `3.11.0`.
+
+[0.2.4]: https://github.com/halildurmus/win32_runner/compare/v0.2.3...win32_runner-v0.2.4
+
 ## 0.2.3
 
 - Bump minimum required Dart SDK version to `3.4.0`

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Contributing
 
-Thank you for your interest in contributing to **win32_runner**!
+Thank you for your interest in contributing to `package:win32_runner`!
 
 This guide provides everything you need to get started and make your
 contributions effective and rewarding.
@@ -22,18 +22,18 @@ We strive to maintain a welcoming and inclusive community, so please read our
 - **🐛 Report Bugs**: Found a bug? Let us know on our [GitHub Issues] page.
 - **📝 Improve Documentation**: High-quality documentation is crucial. Help us
   improve it by refining the existing docs or adding new content.
-- **💬 Give Feedback**: Share your experience using **win32_runner**, what
+- **💬 Give Feedback**: Share your experience using `win32_runner`, what
   features you’d like, and what works well on [GitHub Discussions].
-- **📢 Share win32_runner**: Spread the word about this project to reach more
-  users.
+- **📢 Share `win32_runner`**: Spread the word about this project to reach
+  more users.
 - **💻 Contribute to the Codebase**: Work on new features or tackle
   [open issues][GitHub Issues] — all contributions are highly appreciated!
 
 ## 🛠️ Setting Up the Environment
 
 ### ⚙️ Requirements
 
-- [Dart](https://dart.dev) version `3.5` or higher
+- [Dart](https://dart.dev) version `3.11` or higher
 - [git-cliff](https://git-cliff.org) for generating changelogs
 - [Lefthook](https://github.com/evilmartians/lefthook) for managing Git hooks
 
@@ -70,7 +70,7 @@ before commits.
 
 ### ✅ Running Tests
 
-To run tests for **win32_runner**, use:
+To run tests for the `package:win32_runner`, use:
 
 ```cmd
 dart test
@@ -128,7 +128,7 @@ automatically, and our maintainers will review it.
 Please use the pull request template to provide details about your changes,
 ensuring a smoother review process.
 
-Thank you for contributing to **win32_runner**! 🎉
+Thank you for contributing to `package:win32_runner`! 🎉
 
 [Code of Conduct]: https://github.com/halildurmus/win32_runner/blob/main/CODE_OF_CONDUCT.md
 [Conventional Commits]: https://www.conventionalcommits.org/en/v1.0.0/

CONTRIBUTING.md

@@ -9,11 +9,15 @@ Go to the [GitHub Actions] tab and trigger the [Prepare Release] workflow.
 This workflow will:
 
 - 🔼 **Bump** the `version` in the `pubspec.yaml` file based on commit messages
-  _(e.g., `6.0.0` ➡️ `6.1.0`)_.
+  _(e.g., `0.2.3` ➡️ `0.2.4`)_.
 - 📝 **Update** the `CHANGELOG.md` file with the latest changes.
 
-After making these changes, the workflow will create a pull request (PR)
-_(e.g., **`chore(release): v6.1.0`**)_.
+After making these changes, the workflow will create a pull request (PR) with
+title:
+
+```text
+chore(release): `package:win32_runner` v0.2.4
+```
 
 ## 2️⃣ Review and Merge the PR
 

PUBLISHING.md

@@ -4,72 +4,77 @@
 [![Language: Dart][language_badge]][language_link]
 [![License: BSD-3-Clause][license_badge]][license_link]
 
-An *experimental* package that allows you to run Flutter apps from a Dart runner
-instead of the default C++ runner that is provided when you create a new Flutter
-project using `flutter create`.
+**A Dart runner for Flutter Windows apps — no C++ compiler required.**
 
-This package is particularly useful if you want to create a Windows Flutter app
-without the need for a C++ compiler on your system.
+`package:win32_runner` is an *experimental* package that replaces the default
+C++ runner generated by `flutter create` with a pure Dart alternative, letting
+you build and run Flutter Windows apps without a C++ toolchain installed.
 
-**Important Note:** This package is currently in an *experimental* stage and
-should not be used for production applications. It is primarily a
-proof-of-concept, and as such, it has some limitations. For example, it does not
-support plugins.
+> ⚠️ **Experimental:** This package is a proof-of-concept and is **not suitable
+> for production use**. Plugin support is not yet implemented.
 
-## Usage
+## 🚀 Getting Started
 
-You can use the sample app in the [example] subdirectory to run an existing
-Flutter app on Windows using the Dart runner:
+The [example] subdirectory contains a ready-to-use sample. Follow the steps
+below to run an existing Flutter app on Windows using the Dart runner.
 
-1. Clone the repository:
+**1. Clone the repository**
 
 ```console
 C:\src> git clone https://github.com/halildurmus/win32_runner.git
 C:\src> cd win32_runner
 ```
 
-2. Install dependencies:
+**2. Install dependencies**
 
 ```console
 C:\src\win32_runner> dart pub get
 ```
 
-3. Create a sample app:
+**3. Create a sample Flutter app**
 
 ```console
 C:\src\win32_runner> cd ..
 C:\src> flutter create simpleapp
 C:\src> cd simpleapp
 ```
 
-4. Compile Flutter code and assets to the `build\` subdirectory:
+**4. Compile the Dart runner**
 
 ```console
-C:\src\simpleapp> flutter assemble -dTargetPlatform=windows-x64 --output=build -dBuildMode=release release_bundle_windows-x64_assets
+C:\src\simpleapp> dart build cli -t ..\win32_runner\example\win32_runner.dart -o build
 ```
 
-5. Compile Dart runner:
+**5. Compile Flutter code and assets**
 
 ```console
-C:\src\simpleapp> dart compile exe ..\win32_runner\example\win32_runner.dart -o win32_runner.exe
+C:\src\simpleapp> flutter assemble -dTargetPlatform=windows-x64 --output=build -dBuildMode=release release_bundle_windows-x64_assets
 ```
 
-6. Run Flutter app:
+**6. Run your Flutter app**
 
 ```console
-C:\src\simpleapp> .\win32_runner
+C:\src\simpleapp> .\build\bundle\bin\win32_runner.exe
 ```
 
-Once you've followed these steps, you should see your Flutter app running on
-Windows using the Dart runner:
+You should now see your Flutter app running via the Dart runner:
 
 ![demo][demo_image_link]
 
-## Feature requests and bugs
+## 📝 Documentation
+
+Full API reference is available here:
+
+👉 [API Reference][api_reference_link].
+
+Additional usage examples are located in the [example] directory.
+
+## 🐞 Features and Bugs
 
-Please file feature requests and bugs at the
-[issue tracker][issue_tracker_link].
+If you encounter bugs or need additional functionality, please
+[file an issue][issue_tracker_link].
 
+[api_reference_link]: https://pub.dev/documentation/win32_runner/latest/
 [ci_badge]: https://github.com/halildurmus/win32_runner/actions/workflows/win32_runner.yml/badge.svg
 [ci_link]: https://github.com/halildurmus/win32_runner/actions/workflows/win32_runner.yml
 [demo_image_link]: https://raw.githubusercontent.com/halildurmus/win32_runner/main/screenshots/demo.png

README.md

@@ -1 +1 @@
-include: package:lints/dart.yaml
+include: package:halildurmus_lints/dart.yaml

analysis_options.yaml

@@ -15,18 +15,24 @@ All notable changes to this project will be documented in this file.\n
 # https://keats.github.io/tera/docs/#introduction
 body = """
 {% macro print_commit(commit) -%}
-    - {% if commit.scope %}*({{ commit.scope }})* {% endif %}\
-        {% if commit.breaking %}[**breaking**] {% endif %}\
-        {{ commit.message | upper_first }} - \
-        ([{{ commit.id | truncate(length=7, end="") }}](<REPO>/commit/{{ commit.id }}))\
+  - {% if commit.scope %}*({{ commit.scope }})* {% endif %}\
+    {% if commit.breaking %}[**breaking**] {% endif %}\
+    {{ commit.message | split(pat="\n") | first | upper_first | trim }}\
+    {% if commit.remote.username %} by @{{ commit.remote.username }}{%- endif -%}
+    {% if commit.remote.pr_number %} in \
+      [#{{ commit.remote.pr_number }}](<REPO>/pull/{{ commit.remote.pr_number }}) \
+    {%- endif -%}
 {% endmacro -%}
 
-{% macro print_username(username) -%}
-    [@{{ username }}](<GITHUB>/{{ username }})
+{% macro print_contributor(contributor) -%}
+  - @{{ contributor.username }} made their first contribution
+    {%- if contributor.pr_number %} in \
+      [#{{ contributor.pr_number }}](<REPO>/pull/{{ contributor.pr_number }}) \
+    {%- endif %}
 {% endmacro -%}
 
 {% if version %}\
-    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+    ## [{{ version | trim_start_matches(pat="win32_runner-v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
 {% else %}\
     ## [unreleased]
 {% endif %}\
@@ -46,29 +52,26 @@ body = """
 {% endfor -%}
 {%- if github -%}
 {% if github.contributors | filter(attribute="is_first_time", value=true) | length != 0 %}
-  ## New Contributors ❤️
+  ### New Contributors ❤️
 {% endif %}\
 {% for contributor in github.contributors | filter(attribute="is_first_time", value=true) %}
-  * {{ self::print_username(username=contributor.username) }} \
-      made their first contribution
-    {%- if contributor.pr_number %} in \
-      [#{{ contributor.pr_number }}](<REPO>/pull/{{ contributor.pr_number }}) \
-    {%- endif %}
-{%- endfor -%}
+    {{ self::print_contributor(contributor=contributor) }}
+{%- endfor %}\n
 {%- endif %}\n
 """
 # template for the changelog footer
 footer = """
 {% for release in releases -%}
     {% if release.version -%}
         {% if release.previous.version -%}
-            [{{ release.version | trim_start_matches(pat="v") }}]: \
+            [{{ release.version | trim_start_matches(pat="win32_runner-v") }}]: \
                 <REPO>/compare/{{ release.previous.version }}..{{ release.version }}
         {% endif -%}
     {% else -%}
         [unreleased]: <REPO>/compare/{{ release.previous.version }}..HEAD
     {% endif -%}
-{% endfor %}"""
+{% endfor %}
+"""
 # remove the leading and trailing s
 trim = true
 # postprocessors
@@ -88,22 +91,29 @@ filter_unconventional = true
 split_commits = false
 # regex for preprocessing the commit messages
 commit_preprocessors = [
-    # Replace issue numbers
-    { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "([#${2}](<REPO>/issues/${2}))" },
+    # remove issue numbers from commits
+    { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "" },
 ]
 # regex for parsing and grouping commits
 commit_parsers = [
     { message = "^feat", group = "<!-- 0 -->🚀 Features" },
     { message = "^fix", group = "<!-- 1 -->🐛 Bug Fixes" },
-    { message = "^perf", group = "<!-- 2 -->⚡ Performance Improvements" },
-    { message = "^refactor", group = "<!-- 3 -->🧹 Refactors" },
+    { message = "^perf", group = "<!-- 2 -->⚡ Performance" },
+    { message = "^refactor", group = "<!-- 3 -->🧹 Refactor" },
+    { message = "^docs", group = "<!-- 4 -->📝 Documentation" },
+    { message = "^test", group = "<!-- 5 -->🧪 Testing" },
+    { message = "^style", group = "<!-- 6 -->🎨 Styling" },
+    { message = "^chore\\(deps\\)", group = "<!-- 7 -->📦 Dependencies" },
+    { message = "^chore\\(release\\): v", skip = true },
+    { message = "^chore|^ci", group = "<!-- 8 -->⚙️ Miscellaneous Tasks" },
+    { body = ".*security", group = "<!-- 9 -->🛡️ Security" },
 ]
 # protect breaking changes from being skipped due to matching a skipping commit_parser
 protect_breaking_commits = false
 # filter out the commits that are not matched by commit parsers
 filter_commits = true
 # regex for matching git tags
-tag_pattern = "v[0-9].*"
+tag_pattern = "win32_runner-v[0-9].*"
 # regex for skipping tags
 skip_tags = ""
 # regex for ignoring tags