micazi/astromic_extensions
Public Access
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[DOCS] Updated Readme file with the new implementations.

Browse Source
This commit is contained in:
Michael W. Aziz
2026-01-08 14:45:23 +02:00
parent 0d688cedc8
commit b29e4ddb98
1 changed files with 21 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
README.md
View File

@@ -10,39 +10,38 @@ A collection of high-performance Dart extensions designed to eliminate UI boiler
### Layout & Spacing ### Layout & Spacing
*Focus: Geometry generation, responsive units, and RTL resolution.*
* **.resolveToDirectional()** (`EdgeInsetsGeometry`): Automatically flips insets based on the current `TextDirection`. * **.resolveToDirectional()** (`EdgeInsetsGeometry`): Automatically flips insets based on the current `TextDirection`.
* **.resolveToDirectional()** (`BorderRadiusGeometry`): Reverses corner radii (e.g., top-left to top-right) for RTL support. * **.resolveToDirectional()** (`BorderRadiusGeometry`): Reverses corner radii (e.g., top-left to top-right) for RTL support.
* **.copyWith()** (`EdgeInsetsGeometry` / `BorderRadiusGeometry`): An additive method to combine geometries without overwriting existing values.
* **.copyWith()** (`EdgeInsetsGeometry`): An additive copy method for combining geometries. * **.padAll / .symH / .symV / .padTop / .padBot** (`num`): Quick-access `EdgeInsets` generators directly from numbers.
* **.padStart / .padEnd** (`num`): RTL-aware `EdgeInsetsDirectional` generators.
* **.padAll / .symH / .symV** (`num`): Quick-access padding generators directly from numbers. * **.ofSW() / .ofSH()** (`num`): Returns a double representing a percentage of the screen width or height (e.g., `20.ofSW(context)`).
### Widget Wrappers (Fluent UI) ### Widget Wrappers (Fluent UI)
* **Layout**: `.center()`, `.align()`, `.positioned()`, `.sized()`, `.rotated()` *Focus: Eliminating nesting hell by wrapping widgets with dot-notation.*
* **Transform**: `.flipH()`, `.flipV()`, `.opacity()` * **Layout**: `.center`, `.align()`, `.positioned()`, `.sized()`, `.rotated()`
* **Transform**: `.flipH`, `.flipV`, `.opacity()`
* **Spacing**: `.padAll()`, `.padSymH()`, `.padSymV()`, `.padTop()`, `.padBot()`, `.padStart()`, `.padEnd()`
* **Context**: `.sw` / `.sh` (`BuildContext`): Immediate, performant access to `MediaQuery` dimensions.
* **Utility**: `.safeArea`, `.circular`, `.visibleIf(bool)`: Structural UI tools for conditional rendering and clipping.
* **Spacing**: `.padAll()`, `.padSymH()`, `.padSymV()`, `.padTop()`, `.padBot()` ### Data & Logic
* **Utility**: `.safeArea()`, `.circular()` *Focus: Non-UI logic, collection manipulation, and string parsing.*
### Data & Styling Utilities
* **.rich()** (`String`): High-performance parser to convert strings into clickable/styled `RichText` using backtick markup (e.g., `` "Hello `World`{0}" ``).
* **.toColor** (`String`): Parses Hex strings (supports `#`, `0x`, or raw hex) into Flutter `Color` objects.
* **.capitalize** / **.camelCaseToTitle** (`String`): Advanced string formatting for UI labels and titles.
* **.replaceIfEmpty()** (`String` / `String?`): Null-safe fallback logic to ensure UI strings never appear empty.
* **containsAll()** (`List<E>`): Optimized $O(n)$ check to see if a list contains all elements of another. * **containsAll()** (`List<E>`): Optimized $O(n)$ check to see if a list contains all elements of another.
* **getUnique()** (`List<E>`): Returns a list with duplicates removed using high-performance Set hashing. * **getUnique()** (`List<E>`): Returns a list with duplicates removed using high-performance Set hashing.
* **.nonNulls** / **.limit()** / **.tryReduce()** (`List<E>`): Safe collection utilities to prevent runtime errors.
* **mergeAllMaps()** (`List<Map>`): Performs a conditional deep merge of map collections. * **mergeAllMaps()** (`List<Map>`): Performs a deep merge of map collections with an optional key-collision comparer.
* **.generatePinCode** (`int`): Generates a random numeric pin of the specified length for auth flows.
* **.toColor()** (`String`): Parses Hex strings into Flutter `Color` objects.
* **.capitalize()** (`String`): Standardizes string casing.
* **.rich()** (`String`): Shorthand to convert a string directly into a `RichText` widget.
* **.toAlignment()** (`TextAlignVertical`): Converts vertical text alignment to an `Alignment` object.
--- ---