zeba_academy_map_utils 0.0.1

A collection of generic and type-safe utilities for working with Dart maps, including safe lookup, filtering, transformations, merging, inversion, and grouping.

Changelog

All notable changes to this project will be documented in this file.

The format of this changelog is based on Keep a Changelog, and this project follows Semantic Versioning.

---

0.0.1 - 2026-08-13

Added

• Initial stable release of zeba_academy_map_utils.
• Added safe map value lookup with optional default values.
• Added key existence checking.
• Added map filtering utilities.
• Added key transformation utilities.
• Added value transformation utilities.
• Added key/value transformation with MapEntry.
• Added pick utility for selecting specific keys.
• Added omit utility for excluding specific keys.
• Added support for merging multiple maps.
• Added support for merging two maps.
• Added map inversion utilities.
• Added iterable grouping with groupBy.
• Added map grouping with groupMap.
• Added map entry extraction.
• Added map creation from iterables using fromIterable.
• Added every utility for validating all map entries.
• Added any utility for checking matching map entries.
• Added firstWhere utility for finding the first matching value.
• Added null-value removal utilities.
• Added immutable-style set helper.
• Added immutable-style remove helper.
• Added convenient map extension methods.
• Added generic and type-safe APIs.
• Added comprehensive unit tests.
• Added public package exports.
• Added GPL-3.0 licensing.
• Added production-ready package documentation.

Map Extension Methods

• Added getOrNull.
• Added getOrDefault.
• Added whereEntries.
• Added transformKeys.
• Added transformValues.
• Added transformEntries.
• Added pick.
• Added omit.
• Added withValue.
• Added withoutKey.
• Added inverted.
• Added withoutNullValues.

Documentation

• Added comprehensive installation instructions.
• Added API usage examples.
• Added transformation examples.
• Added filtering and grouping examples.
• Added map merging and inversion examples.
• Added extension method documentation.
• Added testing and contribution guidelines.
• Added Zeba Academy project information.
• Added author and learning-resource information.

Testing

• Added tests for safe lookup.
• Added tests for default values.
• Added tests for filtering.
• Added tests for key transformations.
• Added tests for value transformations.
• Added tests for entry transformations.
• Added tests for pick and omit.
• Added tests for map merging.
• Added tests for map inversion.
• Added tests for grouping.
• Added tests for null removal.
• Added tests for immutable-style updates.
• Added tests for extension methods.

---

Unreleased

Planned

• Additional map composition helpers.
• Additional collection grouping utilities.
• Further API refinements based on community feedback.
• Additional edge-case test coverage.

---