pragma_design_system 1.0.1
pragma_design_system: ^1.0.1 copied to clipboard
Flutter library that gathers Pragma's design tokens, themes, and base components for mobile apps.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.1 - 2025-12-17 #
Changed #
- Bumped the published version to
1.0.1and registered the package under thepragma.copublisher on pub.dev so it inherits the organization’s ownership and verification badge.
1.0.0 - 2025-12-17 #
Added #
- Documentation drop for the 1.0.0 release:
doc/logo.mdcompiles all official asset variants, usage rules, andPragmaLogoWidgetguidance, whiledoc/fonts.mdcaptures typography expectations, licensing, and offline bundling steps. - Rounded-corner guide (
doc/rounded_corners.md) detailing each border-radius token, design references, and implementation shortcuts throughPragmaBorderRadius. - README updated with the new references plus refreshed dependency instructions pointing to the stable 1.0.0 tag.
0.1.7 - 2025-12-16 #
Added #
PragmaLogoWidget, a projector-style logo renderer powered byPragmaScaleBoxthat automatically selects the light/dark asset, scales from a configurable width, and keeps margins proportional to each variant.- Logo assets registered in
pubspec.yaml, README quick samples, unit/widget tests, and an example showcase block at the top of the main screen.
0.1.6 - 2025-12-15 #
Added #
ModelColorToken, an immutable model with JSON helpers plus unit tests that guarantee the roundtrip of label and hexadecimal values.PragmaColorTokenRowWidget, a row-based editor that previews the color on both sides, exposes a sanitized hex input, and is showcased inside the example app together with README docs.ModelThemePragma,PragmaThemeBuilder, andPragmaThemeEditorWidget, which allow squads to craft custom themes, preview them with live components, export JSON, and explore everything inside the new Theme Lab screen on the example app.
0.1.5 - 2025-12-15 #
Fixed #
PragmaDropdownListWidgetnow wraps the remove-action icon withSemanticsinstead of a tooltip overlay, eliminating theRenderFollowercrash that occurred when hovering the remove button while keeping the action accessible. Full Flutter widget tests were rerun successfully to guard against regressions.
0.1.4 - 2025-12-15 #
Added #
PragmaToastWidgetplus the globalPragmaToastService, delivering animated neon toasts with success/error/alert/info palettes, top alignments, optional action buttons, and manual dismissal handles.- Toast playground in the example app together with README documentation and a quick sample to help squads adopt the service quickly.
0.1.3 - 2025-12-15 #
Added #
ModelFieldState, an immutable value object with JSON helpers to keep field values, validation flags, and autocomplete suggestions in sync across widgets.PragmaInputWidgetplus thePragmaInputController, a ValueNotifier-driven text field with Pragma variants, density presets, password toggle, and an overlay that filters suggestions in real time.- Example playground, README quick sample, and widget tests that validate controller synchronization, error rendering, suggestion selection, and the obscure-text toggle.
0.1.2 - 2025-12-15 #
Added #
PragmaIconButtonWidget, a spec-driven icon button with filled/outlined variants, light/dark tones, and regular/compact sizes plus hover/pressed/disabled states.- Example playground and README quick sample that showcase the new widget while encouraging migration away from the legacy
PragmaIconButton(now deprecated). - Widget tests that validate palette resolution, disabled styling, and tap callbacks for the new component.
0.1.1 - 2025-12-15 #
Added #
PragmaDropdownListWidget, a multi-select dropdown that mirrors the tone-on-tone overlay fromPragmaDropdownWidgetwhile adding checkboxes, optional icons, removable rows, and custom option builders.- Shared
PragmaDropdownOptionfile plus a new dropdown-list showcase, README section, and widget tests that validate selection callbacks and removal gestures.
0.1.0 - 2025-12-15 #
Added #
PragmaDropdownWidgetandPragmaDropdownOptionto present themed dropdowns with helper text, error states, icons per option, and tone-aware menu surfaces driven by the activeColorScheme.- Dropdown showcase in the example app plus reusable option data to demonstrate helper/error/disabled scenarios.
- README quick sample, public exports, and widget tests that validate rendering, callbacks, and error decorations.
0.0.9 - 2025-12-15 #
Added #
PragmaCardWidget, a themable card surface with tonal, outlined, and elevated variants plus media/header/supporting actions that default to the activeColorScheme.PragmaCardVariantandPragmaCardSizehelpers, along with widget tests that lock the color and padding behaviors.- Showcase and README snippets covering the new widget so teams can adopt it quickly.
0.0.8 - 2025-12-12 #
Changed #
- Rebuilt
PragmaButtonwith primary/secondary/tertiary hierarchies, brand/inverse tones, and medium/small sizes driven by the activeColorScheme. - Introduced helper classes (
PragmaPrimaryButton,PragmaSecondaryButton,PragmaTertiaryButton) plus enhancedPragmaButton.iconfor icon-only scenarios. - Updated the example showcase, README quick samples, and added
pragma_button_test.dartto cover the new behaviors.
0.0.7 - 2025-12-12 #
Added #
PragmaBreadcrumbWidget, including underline and standard variants driven by the theme plus tooltip/semantics support.- Example showcase with a playground that toggles variants, disabled state, and active page, plus a compact sample in the components wrap.
- README quick sample, public exports, and widget tests covering rendering, interaction, and disabled behaviors.
0.0.6 - 2025-12-12 #
Added #
PragmaAvatarWidget, a radius-driven avatar surface with fallbacks for image/icon/initials, palette styles, tooltips, and tap support.- Example playground demonstrating avatar radius, style, and data bindings, plus README snippet for quick adoption.
- Widget tests covering initials/icon rendering, radius clamping, and semantics (goldens left as tech debt).
0.0.5 - 2025-12-12 #
Changed #
- Standardized the project language to English across README, documentation, and in-code comments.
- Documented the anatomy value contract (0.0–1.0 range) and clarified the DartDoc examples for
ModelPragmaComponent. - Promoted the package to version
0.0.5to reflect the documentation overhaul.
0.0.4 - 2025-12-12 #
Added #
- Domain models
ModelPragmaComponentandModelAnatomyAttributeunderlib/src/domain/models, exported through the public library. - Unit tests plus JSON fixtures that validate the roundtrip for both models, ensuring consistent showcase data.
- Documentation in
doc/component_modeling.mdwith property tables, JSON examples, and best practices. - Example app updated to render documented components powered by the new models.
- README, version (
0.0.4), and changelog aligned with the JSON-driven flow.
0.0.3 - 2025-12-12 #
Added #
PragmaAccordionWidget, an accordion with internal state management,IconDatasupport, block/default sizes, andSemanticswiring.dartdoccomments with copy/paste-ready examples plus public exports inpragma_design_system.dart.PragmaBorderRadiusTokensandPragmaBorderRadiushelpers to standardize the radii defined in the spec.- Widget tests for the accordion and unit tests that cover the new tokens.
- Example app updated to showcase enabled/disabled accordions and highlight the component guide in the README.
- Opacity tokens (
PragmaOpacityTokens,PragmaOpacity) with dedicated documentation and a migration toColor.withValuesacross overlays. - New guide
doc/opacity_tokens.md, README link, and gradient/state control migrations in both the example app and widgets consuming the official transparency tokens.
0.0.2 - 2025-12-11 #
Added #
- Responsive grid tokens and utilities (
PragmaGridTokens,PragmaViewportEnum,getGridConfigFromWidth/Context) with unit tests covering every breakpoint. PragmaGridContainer, a debug overlay that paints columns, gutters, and margins, plus an informative badge with viewport metrics.- "Grid debugger" page inside the example app that renders the overlay live and showcases use cases per screen size.
- Documentation in
doc/describing how to adopt the utilities andPragmaGridContainerin product implementations. PragmaScaleBox, a widget that scales fixed compositions inside the viewport with a demo linked from the Grid Debugger page.
0.0.1 - 2025-12-11 #
Added #
- Reference file with all official chromatic tokens plus Material 3 light/dark schemes built from them.
- Initial components (
PragmaButton,PragmaCard,PragmaIconButton) andPragmaButtonsutilities. - Example app under
example/that showcases tokens, theming, and components along with a base unit test. - Full Poppins typography tokens (
PragmaTypographyTokens) and aTextThemealigned with the spec. - Official spacing system with reusable tokens and
EdgeInsetshelpers. - Documentation about the Poppins license, steps to include an offline fallback, and the
licenses/Poppins-OFL.txtfile. - Example setup with bundled Poppins fonts, runtime
GoogleFontsdisabled, and a fallback inPragmaTypographythat honors the registered assets.
[0.0.5] - 2025-12-12 #
Changed #
- Standardized the project language to English across README, documentation, and in-code comments.
- Documented the anatomy value contract (0.0–1.0 range) and clarified the DartDoc examples for
ModelPragmaComponent. - Promoted the package to version
0.0.5to reflect the documentation overhaul.