Astromic Extensions

The Foundation of the Astromic Presentation System.

A collection of high-performance Dart extensions designed to eliminate UI boilerplate and simplify RTL (Right-to-Left) layout logic.

🛠 Features & API Reference

Layout & Spacing

Focus: Geometry generation, responsive units, and RTL resolution.

.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.
.copyWith() (EdgeInsetsGeometry / BorderRadiusGeometry): An additive method to combine geometries without overwriting existing values.
.padAll / .symH / .symV / .padTop / .padBot (num): Quick-access EdgeInsets generators directly from numbers.
.pad (num): General EdgeInsets wrapper.
.padStart / .padEnd (num): RTL-aware EdgeInsetsDirectional generators.
.ofSW() / .ofSH() (num): Returns a double representing a percentage of the screen width or height (e.g., 20.ofSW(context)).

Focus: Eliminating nesting hell by wrapping widgets with dot-notation.

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.

Data & Logic

Focus: Non-UI logic, collection manipulation, and string parsing.

.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.
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 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.

📦 Installation

dependencies:
  astromic_extensions:
    git:
      url: git.micazi.dev/micazi/astromic_extensions.git
      ref: main

🤝 Client Handoff & Continuity

To ensure project stability following the engagement, clients should follow these steps to secure a local version of this library:

Mirror Repository: Clone this repository and re-upload it to your internal Git organization.
Update Source: Update the pubspec.yaml in your application to point to your internal Git URL.
Versioning: Always use a specific Git ref (tag or commit hash) to ensure build reproducibility.

Note: Access to the Micazi master repository is strictly controlled. Unauthorized redistribution of this source code is prohibited under the included LICENSE terms.

⚖️ License

Developed, Maintained, and property of Michael W. Aziz (Micazi). Refer to the LICENSE file for permitted use in client projects.

3.7 KiB Raw Permalink Blame History