chore: bump dart_style from 3.0.1 to 3.1.0

[dependabot]

Bumps dart_style from 3.0.1 to 3.1.0.

Release notes

Sourced from dart_style's releases.

package:dart_style v3.1.0

This release contains a fairly large number of style changes in response to feedback we got from shipping the new tall style formatter.

Features

• Allow preserving trailing commas and forcing the surrounding construct to split even when it would otherwise fit on one line. This is off by default (because it breaks reversibility among other reasons) but can be enabled by adding this to a surrounding analysis_options.yaml file:

  formatter:
    trailing_commas: preserve

  This is similar to how trailing commas work in the old short style formatter applied to code before language version 3.7.

Bug fixes

• Don't add a trailing comma in lists that don't allow it, even when there is a trailing comment (#1639).

Style changes

The following style changes are language versioned and only affect code whose language version is 3.8 or later. Dart code at 3.7 or earlier is formatted the same as it was before.

• Allow more code on the same line as a named argument or => (#1536, #1545, #1668, #1679).

  // Before:
  function(
    name:
        (param, another) =>
            veryLongBody,
  );
  function(
  name:
  (param) => another(
  argument1,
  argument2,
  argument3,
  ),
  );
  // After:
  function(
  name: (param, another) =>
  veryLongBody,
  );

... (truncated)

Changelog

Sourced from dart_style's changelog.

3.1.0

This release contains a fairly large number of style changes in response to feedback we got from shipping the new tall style formatter.

Features

• Allow preserving trailing commas and forcing the surrounding construct to split even when it would otherwise fit on one line. This is off by default (because it breaks reversibility among other reasons) but can be enabled by adding this to a surrounding analysis_options.yaml file:

  formatter:
    trailing_commas: preserve

  This is similar to how trailing commas work in the old short style formatter applied to code before language version 3.7.

Bug fixes

• Don't add a trailing comma in lists that don't allow it, even when there is a trailing comment (#1639).

Style changes

The following style changes are language versioned and only affect code whose language version is 3.8 or later. Dart code at 3.7 or earlier is formatted the same as it was before.

• Allow more code on the same line as a named argument or => (#1536, #1545, #1668, #1679).

  // Before:
  function(
    name:
        (param, another) =>
            veryLongBody,
  );
  function(
  name:
  (param) => another(
  argument1,
  argument2,
  argument3,

... (truncated)

Commits

• 90227c5 Fix permissions in the CI publish workflow. (#1720)
• 121e5e3 Bump version to publish 3.1.0. (#1719)
• e7264fc Add regression test for #1712. (#1715)
• 7c16cf2 Update the README. (#1713)
• 100db45 Language version all of the formatting changes since Dart 3.7. (#1707)
• c7f6131 Don't invalidate solutions from pinned pieces. (#1706)
• eaa3f2d Make the eager argument list splitting heuristic more conservative. (#1700)
• cd73f3e Add regression test for #1645. (#1697)
• 8dd0e3b Add issue templates. (#1698)
• 4d5edfc Fix bug with comments being reordered. (#1696)
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

Summary by Sourcery

Bump dart_style dev dependency from 3.0.1 to 3.1.0 to adopt the latest formatting improvements and bug fixes.

New Features:

• Support preserving trailing commas and forcing splits through analysis_options.yaml settings.

Bug Fixes:

• Avoid inserting trailing commas in lists that disallow them, even when trailing comments are present.

Enhancements:

• Allow more code on the same line for named arguments and arrow expressions in Dart 3.8 and above.

Chores:

• Update dart_style version to 3.1.0 in pubspec.yaml and lock file.

[sourcery-ai]

Reviewer's Guide

This PR updates the dart_style dev dependency to version 3.1.0 and regenerates the lockfile to reflect the new version.

File-Level Changes

Change	Details	Files
Upgrade dart_style dependency to 3.1.0	Updated version constraint in pubspec.yaml from ^3.0.1 to ^3.1.0	pubspec.yaml
Regenerate lockfile for updated dependency	Refreshed pubspec.lock entries to include dart_style 3.1.0	pubspec.lock

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[github-actions]

Build Status

Build successful. APKs to test: https://github.com/fossasia/badgemagic-app/actions/runs/15145638795/artifacts/3162829977.

Screenshots (Android)

Screenshots (iPhone)

Screenshots (iPad)