chore: 🚧 Provide support for rive pre-release

[Copilot]

Description

Updates Splash Master to support Rive 0.14.0-dev.14 pre-release, which uses an entirely new C++ runtime-based API replacing the previous Dart implementation.

This is released as version 0.0.4-dev.1 (pre-release).

API Changes

• RiveConfig: Replaced artboardName/animations/stateMachineName with artboardSelector/stateMachineSelector. Changed fit from BoxFit to Rive's Fit enum. Added riveFactory parameter (nullable, defaults to Factory.rive at runtime).
• RiveSplash: Now uses RiveWidgetBuilder + RiveWidget instead of removed RiveAnimation widget.
• Source types: Added RiveFileSource for pre-loaded files. Removed RiveArtboardSource (not functional with Rive 0.14.x).

Unsupported in Rive 0.14.x

• DeviceFileSource and BytesSource are no longer supported for Rive splash (use AssetSource, NetworkFileSource, or RiveFileSource)

SDK Requirements

The SDK constraints (Flutter >=3.27.0 and Dart SDK >=3.6.0) are required by Rive 0.14.0-dev.14 itself and cannot be lowered.

Example

SplashMaster.rive(
  source: AssetSource('assets/animation.riv'),
  riveConfig: RiveConfig(
    artboardSelector: ArtboardSelector.byName('MyArtboard'),
    stateMachineSelector: StateMachineSelector.byDefault(),
    fit: Fit.contain,
    // riveFactory is optional - defaults to Factory.rive
  ),
  nextScreen: HomeScreen(),
)

Checklist

• The title of my PR starts with a Conventional Commit prefix (fix:, feat:, docs: etc).
• I have followed the Contributor Guide when preparing my PR.
• I have updated/added tests for ALL new/updated/fixed functionality.
• I have updated/added relevant documentation in docs and added dartdoc comments with ///.
• I have updated/added relevant examples in examples or docs.

Breaking Change?

Migration instructions

• Update to Flutter >=3.27.0 and Dart SDK >=3.6.0 (required by Rive 0.14.0-dev.14)

• Replace RiveArtboardSource with RiveFileSource (the old class has been completely removed)

• Update RiveConfig to use new selector-based API

• Migrate DeviceFileSource/BytesSource Rive sources to AssetSource or NetworkFileSource

• Note: riveFactory parameter is now optional and nullable (defaults to Factory.rive)

• Yes, this PR is a breaking change.

• No, this PR is not a breaking change.

Related Issues

Closes #75

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Feature Request: Support Rive Pre-Release Versions in Splash Master</issue_title>
<issue_description>## Summary

The upcoming pre-release versions of Rive introduce multiple breaking changes that are not compatible with the current release of Splash Master. As a result, developers using the latest Rive pre-release builds are unable to integrate them with Splash Master without encountering errors.

Request

Please provide a new version of Splash Master that is compatible with the latest pre-release versions of Rive. Which aligns with the updated Rive APIs.

Additional context

Link to pre-release of rive-: https://pub.dev/packages/rive/versions/0.14.0-dev.14</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Feature Request: Support Rive Pre-Release Versions in Splash Master #75

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[ujas-m-simformsolutions]

if possible dont update sdk and flutter version. and create a pre-release for it

[Copilot]

Changed to pre-release version 0.0.4-dev.1 in commit 5593c48.

Note: The SDK constraints (Flutter >=3.27.0 and Dart SDK >=3.6.0) are required by Rive 0.14.0-dev.14 itself and cannot be lowered. These are hard requirements from the Rive package's own pubspec.yaml.

[ujas-m-simformsolutions]

Factory.rive is not constant so providing it as default param will not work

[Copilot]

Fixed in commit d0226c3. Changed riveFactory to be nullable (Factory?) so the const constructor works. The default value Factory.rive is now applied at runtime when null.

[ujas-m-simformsolutions]

@copilot instead of adding deprecated member just remove them

[Copilot]

@copilot instead of adding deprecated member just remove them

Removed RiveArtboardSource class completely in commit 7574b99. Since this is a breaking change pre-release and the class doesn't work with Rive 0.14.x, it's been fully removed rather than deprecated.