diff --git a/packages/cli_core/README.md b/packages/cli_core/README.md index 453a5ff..793895e 100644 --- a/packages/cli_core/README.md +++ b/packages/cli_core/README.md @@ -22,6 +22,13 @@ A shared utility package for CLI operations in Flutter Forge packages, providing core functionality for CLI commands, Flutter project management, and Melos workspace operations. +## Compatibility and migration + +Requires Dart 3.6 or newer (below Dart 4). `FileUtils.isMonoRepo` now searches +the current directory and its ancestors for either `melos.yaml` or a native +Dart `workspace` in `pubspec.yaml`. Detection no longer needs a globally installed +Melos executable. Invalid YAML in an unrelated ancestor is ignored. + ## Table of Contents - [Overview](#overview) diff --git a/packages/connectivity_wrapper/README.md b/packages/connectivity_wrapper/README.md index 9efa67e..45de28d 100644 --- a/packages/connectivity_wrapper/README.md +++ b/packages/connectivity_wrapper/README.md @@ -29,16 +29,16 @@ This plugin allows Flutter apps provide feedback on your app when it's not connected to it, or when there's no connection. -## Requirements - -- Flutter >=3.19.0 -- Dart >=3.3.0 <4.0.0 -- iOS >=12.0 -- MacOS >=10.14 -- Android `compileSDK` 34 -- Java 17 -- Android Gradle Plugin >=8.3.0 -- Gradle wrapper >=8.4 +## Compatibility and migration + +Requires Dart 3.6 or newer (below Dart 4) and upgrades `connectivity_plus` to +the 7.x series. Upgrade application platform settings for that dependency: iOS +13+, macOS 10.15+, Java 17, Android Gradle Plugin 8.12.1+, Gradle 8.13+, and +Xcode 26.1.1+. Use a Flutter SDK that includes a compatible Dart SDK. + +Connectivity providers now cancel their subscriptions and close their streams +on disposal; socket checks close sockets in `finally`. Existing widget usage +remains the same. ## Getting Started diff --git a/packages/dzod/README.md b/packages/dzod/README.md index abcd65f..32161da 100644 --- a/packages/dzod/README.md +++ b/packages/dzod/README.md @@ -33,6 +33,18 @@ --- +## Compatibility and migration + +Requires Dart 3.6 or newer (below Dart 4). Async refinements now await the +wrapped schema's asynchronous validation. + +`StringSchema.startsWith`, `endsWith`, `contains`, `date`, and `datetime` return +`Schema` instead of using an invalid cast to `StringSchema`. Apply +string-specific builders before these refinements, and use `Schema` +for the resulting value. Utility classes such as `Parser`, `SchemaUtils`, +`ErrorUtils`, and `CoercionUtils` are static-only `abstract final` classes; +call their static methods rather than implementing these classes. + ## 🎯 What is Dzod? Dzod is an **enterprise-grade** Dart schema validation library heavily inspired by [Zod](https://zod.dev/) with advanced enterprise features. Built for production applications requiring robust data validation, type safety, and exceptional developer experience. diff --git a/packages/html_rich_text/README.md b/packages/html_rich_text/README.md index 9fd8040..17f98e0 100644 --- a/packages/html_rich_text/README.md +++ b/packages/html_rich_text/README.md @@ -31,6 +31,13 @@ A lightweight Flutter package for rendering HTML-styled text without heavy depen ![HTML Rich Text Demo](html_rich_text.png) +## Compatibility and migration + +Requires Dart 3.6 or newer (below Dart 4). Upgrade to a Flutter SDK containing +a compatible Dart SDK before updating this package. The HTML rendering API +is unchanged; this release includes the package's SDK constraint and Dart +workspace metadata updates. + ## Overview HTML Rich Text is an ultra-lightweight solution for parsing and displaying HTML-styled text in Flutter applications. Unlike traditional HTML rendering packages that include full DOM parsing and heavy dependencies, this package uses a simple regex-based approach to parse only the tags you need. diff --git a/packages/morse_tap/README.md b/packages/morse_tap/README.md index 19d52ac..e5388fb 100644 --- a/packages/morse_tap/README.md +++ b/packages/morse_tap/README.md @@ -31,6 +31,16 @@ A Flutter package that provides Morse code input functionality using intuitive g ![Morse Tap Demo](morse_tap.png) +## Compatibility and migration + +Requires Dart 3.8.1 or newer (below Dart 4). `HapticUtils` is now an +`abstract final` utility class. Continue calling its static methods; code that +implements `HapticUtils` must move to its own interface or wrapper. + +Tests can set `HapticUtils.debugHapticSupportedOverride` to control haptic +support without changing the host platform. Reset it to `null` during teardown +to restore normal platform detection. + ## Features ✨ **MorseTapDetector** - Widget that detects specific Morse code patterns using gestures diff --git a/packages/ns_firebase_utils/README.md b/packages/ns_firebase_utils/README.md index e1eb8ac..01e25ad 100644 --- a/packages/ns_firebase_utils/README.md +++ b/packages/ns_firebase_utils/README.md @@ -29,6 +29,17 @@ 🚀 This package provides a comprehensive set of methods and extensions for Firebase, simplifying its integration into your Flutter projects while also adding valuable functionality. +## Compatibility and migration + +Requires Dart 3.6 or newer (below Dart 4) and the FlutterFire versions listed +below. Upgrade directly declared Firebase dependencies and their platform +configuration together; the previous Firebase major versions are no longer +accepted. `firebase_dynamic_links` is no longer included by this package. + +`AppAnalytics`, `FirebaseApi`, and `FirebaseGroupApi` accept optional Firebase +instances for testing. Storage uploads accept an optional storage instance, +and analytics event logging forwards the optional `items` list. + ## Getting Started @@ -56,17 +67,16 @@ import 'package:ns_firebase_utils/ns_firebase_utils/src.dart'; This package offers a single plugin that conveniently adds all necessary Firebase dependencies to your project: ```yaml - cloud_firestore: ^5.5.0 - cloud_functions: ^5.1.5 - fake_cloud_firestore: ^3.1.0 - firebase_analytics: ^11.3.5 - firebase_auth: ^5.3.3 - firebase_core: ^3.8.0 - firebase_crashlytics: ^4.1.5 - firebase_dynamic_links: ^6.0.10 - firebase_messaging: ^15.1.5 - firebase_remote_config: ^5.1.5 - firebase_storage: ^12.3.6 + cloud_firestore: ^6.10.0 + cloud_functions: ^6.5.0 + fake_cloud_firestore: ^4.3.0 + firebase_analytics: ^12.6.0 + firebase_auth: ^6.7.0 + firebase_core: ^4.15.0 + firebase_crashlytics: ^5.4.0 + firebase_messaging: ^16.7.0 + firebase_remote_config: ^6.7.0 + firebase_storage: ^13.6.0 ``` Additionally, it provides a powerful set of methods to accelerate your development process. diff --git a/packages/ns_intl_phone_input/README.md b/packages/ns_intl_phone_input/README.md index ecc2ad3..4f2332a 100644 --- a/packages/ns_intl_phone_input/README.md +++ b/packages/ns_intl_phone_input/README.md @@ -30,6 +30,13 @@ The Flutter Phone Validation Package by Nonstop IO is a versatile and easy-to-use Flutter package designed to validate phone numbers from more than 200 countries. With this package, users can seamlessly integrate phone number validation into their Flutter applications, enhancing user experience and ensuring data integrity. +## Compatibility and migration + +Requires Dart 3.6 or newer (below Dart 4) and `equatable` 2.1.0 or newer +within the 2.x series. Use a Flutter SDK containing a compatible Dart SDK. +The phone-input widget API remains unchanged; internal listener input is +explicitly typed as `String`. + ## Screenshots - Widget with Country Code and Phone Number Field: diff --git a/packages/ns_utils/README.md b/packages/ns_utils/README.md index cf9d09c..6c6f67e 100644 --- a/packages/ns_utils/README.md +++ b/packages/ns_utils/README.md @@ -27,6 +27,20 @@ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT) +## Compatibility and migration + +Requires Dart 3.6 or newer (below Dart 4). This release upgrades +`cached_network_image` to 4.x, `device_info_plus` to 13.x, `package_info_plus` +to 10.x, `intl` to 0.20.x, and `objectid` to 4.x. Some dependency APIs are +re-exported, so migrate application code and direct dependency constraints +together with those upstream major versions. + +Static utility classes including `Sizes`, `ValidatorUtil`, and `DeviceService` +are `abstract final`; use their static methods rather than implementing them. +JSON conversion, navigation, and numeric helpers now handle Dart errors as +well as exceptions, and failed comma-separated list conversion returns the +package's default string. + ## Introduction ns_utils is a powerful Flutter utility library that simplifies and enhances your Flutter app development experience. It provides a collection of methods and extensions to streamline your code, making it more readable and efficient. Whether you need responsive design, date and time handling, map operations, string manipulation, or widget customization, ns_utils has got you covered. diff --git a/packages/timer_button/README.md b/packages/timer_button/README.md index c9fefd8..ab7050c 100644 --- a/packages/timer_button/README.md +++ b/packages/timer_button/README.md @@ -32,6 +32,13 @@ specified time delay. ![Timer Button](https://cdn-images-1.medium.com/max/640/1*NhgmN1C4ltcQA-o34SYbIQ.gif) +## Compatibility and migration + +Requires Dart 3.6 or newer (below Dart 4). Upgrade to a Flutter SDK containing +a compatible Dart SDK before updating this package. The button API and timer +behavior are unchanged; this release includes the package's SDK constraint +and Dart workspace metadata updates. + ## Overview A customizable button widget capable of activation after a designated time interval. diff --git a/plugins/contact_permission/README.md b/plugins/contact_permission/README.md index ce5d919..37e4e04 100644 --- a/plugins/contact_permission/README.md +++ b/plugins/contact_permission/README.md @@ -45,6 +45,17 @@ A plugin for Flutter that requests and verifies contact permissions. > on many devices. >This predicament led to the development of this package. +## Compatibility and migration + +Requires Flutter 3.44 or newer and Dart 3.12 or newer (below Dart 4). Android +now requires API 24+, compile SDK 36, and Java 17-compatible compilation. +The plugin build uses Android Gradle Plugin 9.4.1 and the Gradle 9.7.1 wrapper. +iOS deployment targets must be 15.0 or newer. Update the application's Android +build configuration and iOS deployment target before upgrading. + +The permission-checking Dart API is unchanged. Applications that still need +older Android or iOS releases should keep using the 1.x package series. + ## Getting Started