core_kit 1.1.0-beta.1
core_kit: ^1.1.0-beta.1 copied to clipboard
CoreKit (core_kit) — Flutter UI kit with responsive scaling, Dio HTTP, JWT auth, secure storage, and 35+ widgets.
1.1.0-beta.1 #
New Features #
CkPermissionenum: CoreKit now ships its own cross-platform permission descriptor. Consumers no longer need to importpermission_handlerdirectly. UseCkPermission.camera,CkPermission.location, etc. everywhere you previously usedPermission.camera,Permission.location, etc.CkShareWeb support:CkSharenow works on web via a platform-conditional implementation that uses the Web Share API withoutpath_provider. On web, text + deep-link are shared. AddedgetShareableSourceto resolve raw bytes to local paths (native) or blob URLs/data URIs (web) for in-app sharing.CkImageWeb enhancements: Added support for data: and blob: image sources to CkImage, and guarded File checks on Web to prevent Namespace crashes.
Migration Guide #
Permission API — find & replace in your project:
// Before
import 'package:permission_handler/permission_handler.dart'; // remove this
await CkPermissionHelper.request(Permission.camera);
CkPermissionHandler(permission: Permission.location);
// After — no extra import needed, CkPermission comes from core_kit
await CkPermissionHelper.request(CkPermission.camera);
CkPermissionHandler(permission: CkPermission.location);
Internal Changes #
permission_handleris now an internal-only dependency — its types are no longer part of the public API surface. This clears the pub.dev platform support warnings for Linux and macOS.CkShareuses a conditional export (dart.library.html) to select the correct implementation per platform, clearing the pub.dev Web warning.
1.0.7+6 #
- Static Analysis: static analysis issues fixed and Dependencies updated.
1.0.7+5 #
- Static Analysis: reduce static analysis issues.
1.0.7+4 #
- Dependencies: Updated dependencies to address potential compatibility issues.
1.0.7+3 #
- Documentation: Improved pub.dev page with topics, screenshots, and an updated description.
1.0.7+2 #
- Documentation: Internal code comments and doc organization.
1.0.7+1 #
- Documentation Update: Added the latest demo screenshots and a new preview video to the
README.md.
1.0.7 #
- Comprehensive Auth System Test Suite: Created a robust, VM-friendly test plan and suite containing 164 unit, service, integration, edge-case, and backward-compatibility tests to validate the full authentication and OTP flow logic.
- OTP & Mock Auth Bugfixes:
- Fixed a mock
sendOtp()bug where active triggers and recipients were not stored, preventing subsequent verification checks. - Resolved an issue where the
_preSignupOtpVerifiedflag was infinitely re-asserted in unified post-signup auth checks, ensuring it behaves correctly as a one-shot bypass. - Added test-only helpers and factories (
resetForTests(),seedForTests(), andinitForTests()) to fully isolate auth tests from disk and network dependencies.
- Fixed a mock
- Smart Text Field Capitalization:
- Added a validation-type check (
InputHelper.shouldCapitalize) to disable text capitalization on input fields where it is undesirable (e.g., email address, passwords, URLs, usernames).
- Added a validation-type check (
1.0.6+4 #
- Deprecated
CoreKitConfigDefaults: Deprecated theCoreKitConfigDefaultsmixin and updated all code implementations, comments, and documentation examples. Developers should inherit directly fromCoreKitConfiginstead, as it now provides concrete default implementations for all optional properties.
1.0.6+3 #
- Global Input Configuration (
CkInputConfig): Added support for configuring app-wide text field style defaults (borders, background colors, sizing, text styles, alignments, and capitalization defaults) from one place. - Global SnackBar Configuration (
CkSnackBarConfig): Added support for configuring globalCkSnackBaroverrides (including top/bottom positions, margins, padding, border radii, shadows, semantic colors, and custom icons). - URL Auto-Lowercase: URLs typed or pasted inside text fields are automatically converted to lowercase while preserving the surrounding text.
- Capitalization Toggle (
enableCapitalization): Added a parameter to disable automatic sentence capitalization on specific text fields.
1.0.6+2 #
- CkAppBar Title Alignment Fix: Fixed an issue where global app bar title alignment configured via
CoreKitConfigwas not being applied.
1.0.6+1 #
- New Validation Type (
usernameAndEmailValidation): AddedCkValidationType.usernameAndEmailValidationtoCkTextField, allowing a single field to accept either a valid username or a valid email address. - Documentation — Mock Auth: Corrected the auth mock docs to use
mockAuth: true(replacing the staleauthEnable: falsereferences). - Documentation — Template Setup: Expanded the template quick-start steps to include
fvm dart run build_runner build(required for AutoRoute code generation) andfvm flutter run, with a clear explanation of when to re-runbuild_runner.
1.0.6 #
- CkAppBar Initialization Fix: Resolved a
LateInitializationError: Field 'appbarConfig' has not been initializedcrash that occurred when renderingCkAppBaron initial routes (such as a Splash Screen) beforeCoreKitRouterGatecompleted its asynchronous initialization.appbarConfignow defaults to a safe instance ofCkAppBarConfig(). - Auth Mock Mode Enhancements (
mockAuth):- Renamed the
authEnableconfiguration parameter tomockAuth(inverting logic for improved semantic clarity). - Updated
signInandsignUpmocks to seamlessly bypass OTP dialog triggers whenshowOtpVerificationis not implemented in the application handlers. - Added a
mockAuthcheck inrestoreSessionto prevent profile fetch failures to blank URLs upon hot restarts.
- Renamed the
1.0.5 #
- State Abbreviation Support & Data Class: Updated
CkStateDropDowncallbacks (onChanged,selectedItemBuilder,nameBuilder) to passCkStateDropDownItemPropertycontaining bothstateNameandabbreviation. - Flexible Initial Selection: Added
initialStateparameter toCkStateDropDownaccepting either full state name (e.g.'California') or state abbreviation (e.g.'CA'). - Smart City Dropdown: Updated
CkCityDropDown'sselectedStateparameter to seamlessly handle state abbreviations as well as state names. - Built-in Abbreviation Dataset: Added
StateAbbreviationsdataset supporting automatic abbreviation lookups for US States, Canadian Provinces, and Australian States.
1.0.4 #
- Warning fixed: Fixed linting warnings in
ck_auth_service.dartandrequest_builder.dart.
1.0.3 #
- License Update: Changed package license to MIT.
1.0.2 #
- Web & Multi-Platform Support: Replaced native
dart:ioimports withuniversal_ioto ensure seamless compatibility across all platforms, including Flutter Web. - Resolved Dependency Conflicts: Downgraded to stable releases of
file_picker(^11.0.2) andshare_plus(^12.0.2) to resolve win32 compatibility issues for web and desktop platforms. - Example App: Added a full Flutter example application demonstrating core layout helpers,
CkTransport,CkStorage,CkListViewpagination,CkAppBar, and form validations. - Dartdoc Documentation: Added comprehensive documentation comments to public APIs including
CoreKit,CoreKitConfig,CkResponse,CkTransportConfig, and others. - Design Guidelines: Documented best practices in
README.mdfor using native-likeCkwidgets and correctly applying responsive extensions (.w,.h,.sp,.r).
