layrz_ui 0.0.12

A Material-free and Cupertino-free Flutter design system built on package:flutter/widgets.dart. The successor to layrz_theme.

Changelog

0.0.12

Text selection actions and page-wide toolbar. LayrzTextInput adds an actions parameter to customize the text selection toolbar actions (copy, cut, paste, select all). Pass null for all four built-in actions, const {} to suppress the toolbar, or a custom set of LayrzSelectableAction instances. Page-wide text selection (via SelectableRegion under LayrzLayout) now displays a copy-only toolbar. The field automatically filters actions based on state (obscured fields never offer copy/cut; read-only fields never offer cut/paste). See decision D50 for design details and the five Flutter text selection traps encountered.

Input family: dense parameter removed. The dense parameter is entirely removed from LayrzTextInput and all picker-style inputs (LayrzDateInput, LayrzTimeInput, LayrzSelectInput, etc.). Only one density remains: uniform pd2 (8 logical pixels) padding on all sides. Callers needing tighter geometry use the padding: parameter explicitly. This is a breaking change for any consumer code using dense:. See decision D47 for full context and the removal rationale.

Token system refactor: spacing and radius to semantic level ramps. Both LayrzSpacingTokens and LayrzRadiusTokens move from ad-hoc pixel-named members to five semantic levels (1–5) sharing the value scale 4, 8, 16, 24, 32 — consistent with the pre-existing shadow elevation pattern. This is a breaking change requiring migration of every spacing and radius call site. See decision D46 for full context and migration guide.

Icon set migration to Material Design Icons. Migrates the system-wide icon source from the Solar set (layrz_icons) to Material Design Icons (flutter_material_design_icons), aligning with industry standards while retaining layrz_icons for the planned LayrzIconInput widget.

Navigation panel unification and layout constants refactor. The rail and drawer navigation panels were merged into a single internal widget (LayrzLayoutNavigatorPanel), eliminating ~770 lines of ~91%-identical code. The logo block was rewritten to be edge-to-edge with aspect-ratio scaling. Ten hardcoded layout design constants were removed as they were unused outside their definitions. This is a breaking change for any consumer code referencing the deleted constants. See decision D48 for full context. Note: LayrzLayoutRail and LayrzLayoutDrawer were never exported, so their internal removal is not a public API break; only the constant removals affect external consumers.

Breaking

Input family (LayrzTextInput and all picker-style inputs):

• Removed entirely (no deprecation, no aliases — all stale call sites MUST fail at compile time): dense parameter.
• Removed as side effect: kLayrzLayoutSearchFieldPaddingHorizontal (was 10.0, not on the token ramp), kLayrzTextInputDenseIconSize (was 14.0).
• Abstraction deleted: InputDensitySpec class from lib/src/inputs/src/input_density.dart (91 lines).
• Default padding: All inputs now use pd2 (8 logical pixels uniformly) as the default padding. The padding: parameter remains for custom overrides.
• Migration: Remove all dense: true and dense: false call sites. If custom padding is needed, pass padding: EdgeInsets.all(…) explicitly.

Spacing tokens (LayrzSpacingTokens):

• Removed entirely (no deprecation, no aliases — all stale call sites MUST fail at compile time): base, sp4, sp6, sp8, sp10, sp12, sp14, sp16, sp20, sp24, sp28, sp32, sp36, sp40, sp44, sp48, margin, reducedMargin, padding, spacingSize, sizedBox.
• Added as final fields (in copyWith, ==, hashCode): sp1 (4.0), sp2 (8.0), sp3 (16.0), sp4 (24.0), sp5 (32.0). Note: sp4 existed in the old scheme at 4.0; it now means 24.0. This silent-failure hazard necessitated complete removal of the old member first, then introduction of the new one.
• Added as derived getters (NOT in copyWith, ==, hashCode): pd1…pd5 and mg1…mg5, each returning EdgeInsets.all(spN). These exist for call-site clarity; padding and margin intent is now explicit in the token name.
• Migration table (all 23 old members):
  • sp4 (4.0) → sp1
  • sp6 (6.0) → sp2
  • sp8–sp10 (8.0–10.0) → sp2
  • sp12–sp14 (12.0–14.0) → sp3
  • sp16 (16.0) → sp3
  • sp20 (20.0) → sp4
  • sp24 (24.0) → sp4
  • sp28 (28.0) → sp5
  • sp32 (32.0) → sp5
  • sp36, sp40, sp44, sp48 (36.0–48.0) → sp5 [clamps to 32; 23 call sites tighten spacing by 1/3]
  • base, padding, margin → sp2 (8.0)
  • reducedMargin → mg1 (4.0)
  • spacingSize → Size(sp2, sp2) inline
  • sizedBox → SizedBox.square(dimension: sp2) inline

Radius tokens (LayrzRadiusTokens):

• Removed entirely (no deprecation, no aliases): base, r8, r10, r12, r14, r16, r20, r24, borderRadius getter.
• Added as final fields (in copyWith, ==, hashCode): r1 (4.0), r2 (8.0), r3 (16.0), r4 (24.0), r5 (32.0). Note: r12 existed at 12.0; it now does not exist, and r3 (16.0) is the nearest match.
• Retained unchanged: full (999.0, pill shape), innerRadius(), innerRadiusValue().
• Added as derived getters (NOT in copyWith, ==, hashCode): br1…br5, each returning BorderRadius.circular(rN).
• Migration table (all 8 old members):
  • r8, r10 → r2 (8.0)
  • r12–r16 → r3 (16.0) [16 call sites see visibly rounder corners]
  • r20, r24 → r4 (24.0)
  • base, borderRadius → r2 (8.0)

Layout constants:

• Removed entirely (no deprecation, no aliases — all stale call sites MUST fail at compile time): Six logo design constants (kLayrzLayoutLogoTileSize, kLayrzLayoutLogoTileRadius, kLayrzLayoutLogoGap, kLayrzLayoutLogoWidthFactor, kLayrzLayoutLogoHeight, kLayrzLayoutLogoLeftPadding) and four search-field constants (kLayrzLayoutSearchFieldHeight, kLayrzLayoutSearchFieldInternalPaddingHorizontal, kLayrzLayoutSearchFieldFontSize, kLayrzLayoutSearchFieldIconSize).
• Rationale: All ten constants were unused outside their definitions (internal to the now-merged rail/drawer panels). Their removal simplifies the token landscape and retires two off-ramp hardcoded values: kLayrzLayoutSearchFieldInternalPaddingHorizontal (10.0) and kLayrzLayoutLogoLeftPadding (6.0), neither on the 4/8/16/24/32 spacing ramp.
• Retained unchanged: kLayrzLayoutRailPaddingHorizontal, kLayrzLayoutRailPaddingVertical, kLayrzLayoutLogoBottomPadding. Note: Rail padding constants now apply to both rail and drawer presentations; renaming them would introduce a second breaking change, making them candidates for a future breaking release.

Surface color tokens: collapse to sf1–sf4 numbered ramp, remove pure white.

• Removed entirely (no deprecation, no aliases): colors.background, colors.surface, colors.surface2, colors.surface3, constant kLightBackgroundColor.
• Added as final fields (in copyWith, ==, hashCode): sf1 (#FCFCFC), sf2 (#F7F7F7), sf3 (#F0F0F0), sf4 (#E8E8E8). All surfaces now use numbered ramp logic.
• Migration table (all 4 old members):
  • background → sf1 (#FCFCFC) — canvas/scaffold background
  • surface → sf1 (#FCFCFC) — on-canvas fills (cards, dialogs, panels, alerts); elevation shadows separate layers
  • surface2 → sf2 (#F7F7F7) — nested surfaces (e.g. input fields inside a card); value unchanged
  • surface3 → sf3 (#F0F0F0)
• New step: sf4 (#E8E8E8) added for deepest nesting with maximum contrast.
• Rendering change: Pure white (#FFFFFF) is no longer used anywhere. All elevation shadows and backgrounds now render against the light gray (#FCFCFC) canvas, improving consistency. Default LayrzShadowTokens.surfaceColor updated from white to #FCFCFC; LayrzAvatar background updated similarly.
• Rationale: The collapse removes redundancy (old background and surface both mapped to similar values); the ramp adds structure (numbered 1–4 mirrors the pre-existing elevation and semantic level pattern). See decision D49 for full context.

Changed

• All icons now use flutter_material_design_icons (^3.1.0+7447) instead of layrz_icons. Every component that previously rendered LayrzIcons.solarOutlineXxx now uses MdiIcons.xxx. This is a visual change to icon appearance, as the Solar and MDI glyph sets differ. Components affected:

  • LayrzButton and LayrzDropdownEntry semantic factories (save/cancel/info/show/edit/delete) now use MDI icons
  • LayrzAlert types (info/success/warning/danger/context) now use MDI icons
  • LayrzLayout drawer trigger and navigation examples now use MDI
  • All widget examples and documentation pages updated to reflect the new icons

  Reference decision D45.

• layrz_icons dependency remains but is no longer the system-wide icon source. It is retained exclusively for the planned LayrzIconInput widget, which browses the full Solar catalogue. The dependency version is pinned at ^1.1.1 (co-constrained with layrz_sdk); this will remain until layrz_sdk upgrades to layrz_icons: ^2.0.0.

Dependencies Added

• flutter_material_design_icons: ^3.1.0+7447 — Pure icon-font package providing Material Design Icons. No Material or Cupertino coupling; purely a font and constant library. All components now import icons from this package.

---

0.0.11

Touch behaviour, and a drawer that reads as depth. Reworks how tooltips behave under a finger, corrects coordinate and scaling faults that only surface on a real device, and rebuilds the mobile drawer transition so the page floats above a flat backdrop.

Added

• Drag gestures and back-button handling for the LayrzLayout drawer. A 20px edge strip (kLayrzLayoutDrawerEdgeDragWidth) drags the drawer open while it is closed, and the visible page sliver drags it shut while it is open; both track the finger and settle by fling velocity (kLayrzLayoutDrawerDragSettleVelocity, 365 px/s) or by whether the gesture passed the halfway point. The system back button now closes an open drawer instead of popping the route, via PopScope. Reference decision D44.

• Field errors surface in a tap tooltip below the sm breakpoint. On compact widths there is no room for an error line beneath the field, so the error is reachable by tapping instead. Reference DESIGN-80 and decision D41.

• LayrzLayout honours the safe area. The top bar and drawer surfaces paint edge-to-edge beneath notches, status bars and home indicators so their fill reaches the physical screen edge, while their content stays inset. The body slot is deliberately not inset — the page owns its own edges. Reference DESIGN-82 and decision D42.

Changed

• The mobile drawer no longer slides in over the page; the page moves out of the way. It scales to 0.88 anchored at Alignment.centerLeft, translates right by the 260px drawer width, and gains radius.r16 corners with shadow.elevation4, so it reads as a card floating above the drawer. The drawer panel lost its own shadow and now renders flat, and the full-screen scrim is gone along with kLayrzLayoutDrawerScrimOpacity — with the drawer painted behind the page, a scrim can never be seen. This is a visible behaviour change. Reference decision D44.

• The drawer trigger is a 40x40 button with hover and press states (colors.surface3 on hover, colors.surface2 on press), replacing a bare 24px icon that had no feedback and a hit target below the touch minimum. Only colour varies across states; geometry is held constant per decision D15. The top bar logo is left-aligned rather than centred.

• @Preview requires a top-level function tear-off for theme:. Use layrzPreviewLightTheme; LayrzPreviewTheme.light is a static method and the widget-preview code generator cannot serialize it. Every bundled preview now also declares a size:, because the preview harness supplies unbounded width, which forces the intrinsic and dry-layout measurement that a Row with Expanded or an embedded LayoutBuilder cannot answer.

Fixed

• Touch tooltips stay open until tapped away. They previously vanished the instant a long-press was released, because the gesture that opens them ends with a pointer-up event. Dismissal now runs through a global pointer route gated on mouse presence and fires on pointer-down. Reference DESIGN-77.

• Tooltips are positioned in the overlay's coordinate space rather than the window's. The anchor was resolved with localToGlobal and no ancestor:, and the bounds came from MediaQuery, while the surface is placed by a Positioned inside the OverlayPortal's overlay child. Inside a scrollable the two spaces diverged by the scroll offset, so it was applied twice and the tooltip drifted at twice the distance the anchor moved — measured on device at ratios of 2.00 across three pages, with the error growing linearly from zero at the top of a page.

• The drawer transition no longer relays out the page on every frame. The sliver's gesture region animated a Positioned offset, and mutating one marks RenderStack dirty for layout, so the whole body subtree — including long scrollables — was laid out every frame. Profiling on device measured LAYOUT at 795ms against PAINT's 205ms, with UI frames peaking at 48.8ms. The region is now offset with Transform.translate, which is paint-and-hit-test only; the drawer subtree is built once outside the AnimatedBuilder instead of being reallocated per frame; and the page content and drawer panel each get a RepaintBoundary.

• Button labels render at the measured text scale. Reference DESIGN-78.

• Alert touch presses receive the hover treatment, so a press registers visually on a device with no pointer. Reference DESIGN-79.

• The drawer closes when a navigation item is tapped, while section labels leave it open.

Known issues

• Widget previews do not render. The preview harness installs no LayrzUiL10n, so any preview of a widget that reads context.l10n fails during build. Bounding every preview's size cleared the earlier layout assertions, but this remains.

0.0.10

The application shell. Adds LayrzLayout and LayrzScaffoldShell — the two components that turn the primitives into an application — plus a Material-free scrollbar the package installs for you.

Added

• LayrzLayout — the application shell, and the resolution of decision D8's long-open question of which single layout design ships. Two presentations, resolved from LayoutBuilder constraints via tokens.breakpoints.bandAt(...) rather than the viewport, so the layout reacts to its own box: expanded at md/lg/xl renders a 178px labelled rail beside the body slot, capping and centring body content at 1440 on xl; drawer at sm/xs replaces the rail with a 56px top bar and moves navigation into a 260px off-canvas drawer.

  It holds no application state — LayrzNavigatorPage.isSelected carries the active flag, so the consumer declares which entry is current rather than passing a selected id down. The navigator hierarchy is deliberately trimmed to two subtypes: LayrzNavigatorPage and LayrzNavigatorLabel. layrz_theme's Action, Widget and Separator items are dropped, as are breadcrumbs, the user role line and the org switcher. LayrzNavigatorLabel renders as a full-bleed band with an optional color that tints it at tonalOpacity flattened over the surface. The user block opens a dropdown supplied via userMenuItems, so no tap callback is routed through the layout, and notifications appear as a labelled footer row. logo is a required String — a LayrzImage source rather than a widget, so the layout can guarantee the image's width, height and fit. A search field filters navigator pages by labelText while preserving the section label of any section that still matches. Nothing in the component pushes a Navigator route. Reference DESIGN-61 and decision D37.

• LayrzScaffoldShell<T> — adaptive list-detail shell, driven by two builders: onBuild returns a LayrzScaffoldTile describing one row, and onDetailsBuild renders the entire detail area including its own header. A LayrzScaffoldController<T> is required and owns which item is open, so the detail view can be driven from outside the widget; the consumer owns its lifecycle and the shell never disposes it. Two panes at md/lg/xl, a single pane with a back affordance at sm/xs, swapped by internal state rather than a Navigator push.

  LayrzScaffoldTile is an abstract base class exposing titleRichText, subtitleRichText and actions, so consumers can subclass it around their own domain object and override ==/hashCode for precise change detection; LayrzScaffoldValueTile is a concrete value-equality implementation for simple lists. Search reports through onSearch and the shell does not filter — a shell generic over T cannot know which fields are searchable. There is no grouping. Reference DESIGN-62 and decision D37.

• LayrzScrollbar and LayrzScrollBehavior — a Material-free scrollbar built on RawScrollbar, since Scaffold-era Scrollbar is Material and CupertinoScrollbar is Cupertino. The thumb is always visible and rounded; the track appears only on hover. Vertical scrollables only, and only on pointer platforms — a permanently visible thumb on a touch device reads as broken.

• LayrzDropdownLabel.color — optional tint for a menu section's label band. When null the band keeps its neutral surface3 fill, so existing menus are unchanged.

Changed

• LayrzApp now installs LayrzScrollBehavior when scrollBehavior is null. This is a visible behaviour change: scroll views that previously had no scrollbar will now show one. Pass an explicit scrollBehavior to opt out.

• LayrzTextInput.dense now scales the icon size, the text style and the content height, not only the padding. Previously dense reduced vertical padding while the icon stayed at the global IconTheme size of 24 and the text stayed at body size, so a dense field was not meaningfully compact and its text could clip. Density is now resolved in one place (InputDensitySpec) covering padding, icon size, hint style, editable style and content height together. Existing dense fields will render visibly more compact; non-dense fields are unchanged.

0.0.9

The input family's foundation, plus localization. Adds LayrzTextInput — the component every other Layrz*Input will compose — and the LayrzUiL10n localization contract it depends on.

Breaking

• LayrzAvatar no longer depends on layrz_sdk. The avatar parameter is removed and replaced with source: LayrzAvatarSource?. The sealed hierarchy LayrzAvatarSource contains four concrete types: LayrzAvatarUrl, LayrzAvatarBase64, LayrzAvatarIcon, and LayrzAvatarEmoji. All four variants hold their data directly (URL string, base64 string, IconData, emoji string) rather than wrapping SDK types. Migration: replace Avatar(type: AvatarType.url, url: '...') with LayrzAvatarUrl('...'), Avatar(type: AvatarType.base64, base64: '...') with LayrzAvatarBase64('...'), Avatar(type: AvatarType.icon, icon: icon) with LayrzAvatarIcon(icon.iconData) (convert SDK LayrzIcon to IconData), and Avatar(type: AvatarType.emoji, emoji: '...') with LayrzAvatarEmoji('...'). The .image(), .icon(), .emoji(), and .initials() named constructors are unchanged.

• layrz_icons remains at ^1.1.1. Although layrz_ui no longer depends on layrz_sdk directly, the layrz_ui_extensions package must depend on both layrz_ui and layrz_sdk to provide the Avatar → LayrzAvatarSource conversion — and layrz_sdk 4.4.3 pins layrz_icons: ^1.1.1. Decision D30's exit condition (raise to 2.x once layrz_sdk upgrades) therefore remains unmet.

Added

• LayrzTextInput — Material-free single-line text field built directly on EditableText, and the base of the entire input family. Every future Layrz*Input composes it rather than reimplementing field chrome, so its label, slots, help affordance, error display and focus decoration are the chrome of every input in the system. Reference DESIGN-33 and decision D32.

  Key API notes: at least one of labelText or hintText is required (a debug assertion enforces it) — a search field wants only a hint, a form field only a label, and both together is valid. Each of the prefix and suffix slots accepts at most one of prefixIcon / prefix / prefixText (and the suffix equivalents), asserted in debug. errors is a caller-owned List<String> rendered joined with ", " on a single line in bold w700 — there is no validator and the widget never self-validates. maxLength renders a "12/50" counter right-aligned opposite the error message, which stays neutral fg3 even when errors are present. disabled blocks all interaction; readOnly still fires onTap, which is what picker-style inputs depend on. shortcut renders a ⌘K-style badge but binds nothing (see DESIGN-71) and is hidden entirely on mobile.

• LayrzUiL10n — The localization contract for the design system: 133 keys across 17 namespace mixins, each supplying an English default. Ships with LayrzUiL10nDefault, LayrzUiL10nDelegate and a context.l10n accessor, wired automatically by LayrzApp so the package works with zero configuration. Consumers extend LayrzUiL10n and override only the keys they need; keys added in later versions inherit their English default rather than breaking the subclass. Reference DESIGN-73.

  Integration note: a consumer's own delegate must be declared LocalizationsDelegate<LayrzUiL10n>, never over a subclass. LocalizationsDelegate.type is the key Localizations.of looks up, so a subclass-typed delegate is never found and every string silently falls back to English with no error.

• LayrzTooltip.titleText — Optional title rendered above the tooltip content in a heavier weight. Purely additive; existing tooltips are unchanged.

• Showroom section for inputs — The example app gains a LayrzTextInput section covering field states, label and hint variants, all three slot forms including arbitrary widgets, error display, the help affordance, dense, the shortcut badge and a numeric field.

Changed

• Type scale adjusted — display is now 40px at w700 (was 45px at w800), headline is w600 (was w700), and label is w400 (was w300). title (16px w600) and body (14px w400) are unchanged. This is a visual change to every component reading tokens.typography, not an API change.

• formatLayrzShortcut moved to a new keyboard module — Relocated from lib/src/menus/src/ now that it has a second consumer, and given its first test suite. Non-breaking for consumers, who reach it through the root barrel.

Design Notes

• Text selection is deliberately deferred. LayrzTextInput passes null for both selectionControls and contextMenuBuilder, which makes EditableText skip the selection overlay entirely while caret placement, drag-selection and keyboard selection continue to work. Selection handles, the copy/paste toolbar and the mobile magnifier are tracked separately as DESIGN-74. Material supplies these normally and its implementation cannot be used.

• Field geometry is deterministic. Height resolves from the icon size, so a field with icons is exactly as tall as one without, and every interaction state renders at identical height and border width per decision D15. Caller-supplied slot widgets are constrained to that height so a picker passing a colour swatch or avatar cannot stretch the field.

• Decision D35 was retracted. It amended D15 to permit dashed borders on modal states. The dashed border was removed before release — it never rendered, because the painter drew beneath an opaque fill — so the amendment defends nothing and D15 stands unamended. References D32, D33 and D34.

• The i18n binding lives in a separate package. layrz_ui_i18n (goldenm-software/layrz_ui_i18n) adapts LayrzUiL10n to the layrz_i18n engine. It is not published from this repository, and layrz_ui deliberately carries no dependency on any translation engine.

---

0.0.8

Final M2 core primitives. Adds three remaining M2 components and amends the dropdown menu implementation.

Breaking

• LayrzDropdownEntry.color is now Color? instead of LayrzColorSwatch? — The swatch type was originally justified because pressed and hovered states read accent.shade100 and accent.shade700. Those states are now neutral opaque tokens, so no shades are read anywhere. Passing token swatches still compiles and renders identically (each swatch is constructed with shade500 as its primary value), so most callers need no change. Only code that reads the field back expecting a swatch (e.g., entry.color.shade700) will break at compile time. Reference decision D29.

Added

• LayrzDropdownLabel.color — Optional Color? parameter that fills the label's tonal band. Null keeps the neutral surface3 fill, so existing menus are visually unchanged. Paired with D29's dropdown entry colour simplification.

• LayrzDropdownEntry semantic factories — Six convenience factories preset icon and semantic colour to match action semantics: .save() (icon solarOutlineInboxIn, colour tokens.colors.success), .cancel() (icon solarOutlineCloseSquare, colour tokens.colors.danger), .info() (icon solarOutlineInfoSquare, colour tokens.colors.info), .show() (icon solarOutlineEyeScan, colour tokens.colors.info), .edit() (icon solarOutlinePenNewSquare, colour tokens.colors.warning), .delete() (icon solarOutlineTrashBinMinimalisticN2, colour tokens.colors.danger). All factories accept optional icon and color overrides. Semantic type is resolved to token colour at build time via a private enum, never exposed as public API.

• LayrzButtonGroup — Responsive group of dropdown items rendering as a row of buttons or collapsed into a single dropdown trigger. Takes items: List<LayrzDropdownItem> (entries and labels). In row mode (above md breakpoint), LayrzDropdownEntry items convert to labelled LayrzButton instances; LayrzDropdownLabel items are silently skipped. In dropdown mode, all items pass through to LayrzDropdownMenu unchanged. Mode driven by a nullable bool useDropdown parameter. The triggerHintText parameter is required and serves as the trigger's stable accessible name. Reference DESIGN-31 and the model inversion: items are the source of truth, not derived from buttons.

• LayrzButtonGroup.builder — Variant constructor allowing a custom trigger widget. Identical to the default constructor except the trigger is built via builder: (context, controller) instead of the hardcoded triggerHintText / triggerIcon. Row mode is identical for both constructors. Gesture-arena warning: wire the controller directly to the trigger's onTap, do not wrap in GestureDetector.

• LayrzAvatar — Static display component rendering a layrz_sdk Avatar by type (URL, base64, icon, emoji), with initials as the fallback when the avatar is null or missing. Always a rounded box using the r12 radius token, consistent with LayrzCard and LayrzAlert, and carries a fixed tokens.shadow.compact1 drop shadow in all render modes. No interaction affordances; callers wrap if needed. Initials algorithm is deterministic but not locale-aware (no Unicode segmentation). Reference decision D31.

• LayrzImage — Image widget resolving network URLs, data-URIs, bare base64, and asset paths. Includes SVG support via flutter_svg and a bounded cache for decoded base64 bytes. Uses ImageSource to detect and parse the source type automatically.

• Dependencies: layrz_sdk and flutter_svg — New dependencies to support avatar models and SVG rendering. layrz_sdk requires layrz_icons: ^1.1.1, so the package constraint is downgraded from ^2.0.0 to ^1.1.1. All 20 used IconData symbols are identical in both versions, verified byte-for-byte. Reference decision D30.

Changed

• layrz_icons constraint lowered from ^2.0.0 to ^1.1.1 — Required by layrz_sdk 4.4.3. All used symbols are identical across versions. Exit condition: raise constraint back to ^2.0.0 once layrz_sdk upgrades.

Design Notes

• D29 documents the post-mortem on LayrzDropdownEntry.color. The lesson: when an API's original constraint is removed, actively audit the dependency graph for surviving references to that constraint and remove them. The swatch type should not have survived the interaction-state redesign.

• D30 records the dependency trade-off: layrz_sdk brings 18 transitive dependencies (including dio, layrz_i18n, layrz_logging, web_socket_channel), and flutter_svg adds the vector graphics chain. All verified Material-free. Exit condition explicit: revert to ^2.0.0 once layrz_sdk advances.

• D31 documents that LayrzAvatar is static display-only, following the same pattern as LayrzChip per decision D28. No interaction affordances, no elevation parameter — but the avatar always carries a fixed tokens.shadow.compact1 drop shadow. Callers own interaction logic.

---

0.0.7

First components from Milestone 2. Adds four M2 primitives: selectable text, visual chips, chip grouping, and dropdown menu.

Added

• LayrzText — Material-free drop-in replacement for Flutter's Text that makes text selectable and copyable via SelectableRegion with emptyTextSelectionControls. Supports both LayrzText(String) and LayrzText.rich(InlineSpan) constructors mirroring Text exactly. Keyboard selection (Ctrl+A) and copy (Ctrl+C) work without additional UI. Resolves null style to tokens.typography.body rather than inherited DefaultTextStyle; drag handles and context menu deferred until Material-free TextSelectionControls exists. Reference decision D28 and DESIGN-28.

• LayrzChip — static, visual-only compact label with optional leading icon and optional delete affordance. Three styles (filled, outlined, filledTonal) and six semantic types (info, success, warning, danger, context, custom). Chip is a label, not a control: no tap, hover, focus, or selected state; only the delete affordance is interactive. Reference decision D28 and DESIGN-29.

• LayrzChipGroup — horizontal layout of multiple chips with two overflow behaviors. LayrzChipGroupBehavior.none (default) renders a single scrollable row. LayrzChipGroupBehavior.compact clamps to available width and collapses the remainder into a +N indicator chip whose tooltip lists the hidden labels. Caveat: compact measures each chip individually, so the +N may appear one chip early or late; it costs one text layout per chip per build.

• LayrzDropdownMenu — menu surface anchored to a trigger widget, built on RawMenuAnchor from package:flutter/widgets.dart. The trigger is supplied via builder: (context, controller) and wires itself through the controller; the menu installs no gesture handling of its own. Items are a sealed hierarchy of LayrzDropdownEntry and LayrzDropdownLabel, ensuring standardization on rendering. Entries support an optional colour dot (driven by a LayrzColorSwatch), an optional icon, enabled state, and a display-only Set<LogicalKeyboardKey> shortcut hint rendered with platform-native glyphs and hidden entirely on iOS and Android. LayrzDropdownMenuAlignment offers start/center/end horizontal positioning relative to the trigger. Escape, arrow-key traversal, and outside-tap dismissal are handled by RawMenuAnchor. No exit animation — RawMenuAnchor tears the overlay down synchronously. Reference DESIGN-30 and milestone-2 item 9.

Changed

• LayrzText is now a StatelessWidget — public API is unchanged. Its former State only duplicated SelectableRegion's own focus-node ownership, so the redundant State/Element per instance was removed. A caller-supplied focusNode remains caller-owned and is never disposed by the widget.

Design Notes

• D28 documents the architectural decisions for text, chips, and the sealed item hierarchy (which extends to dropdown). See engineering/decisions.md#d28.
• LayrzText uses SelectableRegion with emptyTextSelectionControls from Flutter 3.47 to enable keyboard selection and copy (Ctrl+A, Ctrl+C) without Material imports. When focusNode is supplied, the caller owns and must manage its lifetime; LayrzText never disposes it.
• LayrzChip uses tokens.radius.full for pill-shaped border radius and is static by design — no tap, hover, focus, or selection state; only the delete affordance is interactive.
• LayrzChipGroup.compact mode measures each chip individually via LayrzChip.computeWidth() (using TextPainter) to determine when to show the +N overflow indicator. This costs one text layout per chip per build; avoid in hot lists.
• LayrzDropdownMenu interaction states: Dropdown entries render at surface at rest, surface2 on hover and focus, and surface3 when pressed. Interaction states are neutral and fully opaque because Colors.transparent is transparent black and lerping from it flashes dark mid-transition. See decision DESIGN-30.

---

0.0.6

Breaking: component enum trimming. Two design votes removed unused style variants.

Breaking

• LayrzButtonStyle trimmed from 12 to 6 values — only elevated, elevatedFab, outlined, outlinedFab, outlinedTonal, outlinedTonalFab remain. Removed: filled, filledFab, filledTonal, filledTonalFab, text, fab. See decision D27 and DESIGN-20.
• LayrzAlertStyle trimmed from 5 to 2 values — only layrz, filledIcon remain. Removed: filledTonal, filled, outlined. Consequence: all alerts now render in split-panel layout. See decision D27 and DESIGN-22.
• Semantic factory signature change — six button factories (.save, .cancel, .info, .show, .edit, .delete) replace the isElevated boolean with an exposed style: parameter defaulting to LayrzButtonStyle.elevated. The isFab parameter remains. isElevated is no longer a parameter. Factories map the given style to its Fab twin via a new asFab getter on the enum extension. Example: LayrzButton.save(labelText: 'Save', onTap: _save, style: LayrzButtonStyle.outlined).
• kLayrzAlertIconBoxSize and kLayrzAlertIconSize removed — orphaned by the alert style trim. Only kLayrzAlertFilledIconSize remains.

Added

• LayrzButtonStyle.asFab enum extension — maps a regular style to its Fab twin (e.g., outlined.asFab → outlinedFab). Used internally by semantic factories.

Changed

• LayrzButton semantic factories now expose the style: parameter for controlling button emphasis via style choice rather than a boolean. Developers explicitly pass style: LayrzButtonStyle.outlined for quiet buttons.
• All LayrzAlert instances now render in split-panel layout (the old .layrz and .filledIcon styles were the two split-panel options; the removed styles were single-panel).

Design Rule (Not Enforced in Code)

• Button labels should be concise; do not rely on TextOverflow.ellipsis / maxLines: 1 to truncate long text. This is design guidance only, not a runtime constraint.

---

0.0.5

Breaking: every import path changes. A single barrel replaces the fourteen per-domain entrypoints.

// Before (0.0.4)
import 'package:layrz_ui/buttons.dart';
import 'package:layrz_ui/theme.dart';
import 'package:layrz_ui/tokens.dart';

// After (0.0.5)
import 'package:layrz_ui/layrz_ui.dart';

Breaking

• The fourteen per-domain entrypoints (alerts.dart, app.dart, buttons.dart, cards.dart, constants.dart, extensions.dart, fonts.dart, grid.dart, platform.dart, state.dart, theme.dart, tokenizer.dart, tokens.dart, tooltips.dart) are removed. Import package:layrz_ui/layrz_ui.dart instead; it exports all of them.
• Deferred imports were the one benefit of the per-domain split, and they apply only to web and Android. layrz_ui targets all six Flutter platforms, so the split was not earning its complexity. Recorded as D26; D19 is superseded.

Changed

• package:layrz_ui/preview.dart is unchanged and remains a separate opt-in import. It is deliberately not exported by the root barrel.
• Implementation files move to lib/src/<module>/src/ behind a per-module barrel at lib/src/<module>/<module>.dart. This is internal layout only; consumers import the root barrel.

0.0.4

Documentation-only release. No API changes, no code changes, no migration required. If you're using 0.0.3, you already have all the features described here.

Documentation

• README corrected: removed examples for removed APIs (LayrzThemeMode, context.isDark, LayrzThemeData.dark(), kDarkBackgroundColor, kAccentColor, grid breakpoint constants kExtraSmallGrid et al., and the old fifteen-name text scale). Installation and usage examples moved to the GitHub wiki for sustained maintenance alongside the per-widget pages.
• Wiki corrected across seven pages (Getting-Started, Theming, LayrzTokenizer, LayrzAlert, LayrzTooltip, and two legacy examples) to reflect the five-style text scale (display, headline, title, body, label) that replaced the fifteen-name scale in 0.0.3.
• Progress tracking moved from a private GitHub Project to a public Notion board, linked from the README.

0.0.3

Breaking

• The text scale collapses from fifteen styles to five: display, headline, title, body, label. All *Large, *Medium and *Small names are removed with no aliases; each new name carries the former Medium values.
• Font weights now carry hierarchy: display w800, headline w700, title w600, body w400, label w300. Previously all styles painted at regular weight regardless of the tag.
• layrzTooltipPositionDelegate is renamed to positionDelegate.
• Breakpoints move from compile-time constants (kExtraSmallGrid, etc.) onto the theme as LayrzBreakpointTokens, permitting per-app override. Add context.breakpoint to retrieve the active band from viewport width.
• Grid breakpoints are now viewport-driven; the useScreenWidth escape hatch is removed. A row always selects spans from MediaQuery.sizeOf(context).width, then divides its own measured pixel width by the selected span count. The two widths routinely differ for grids inside narrow containers on large screens, matching CSS Grid and Bootstrap.
• kLayrzButtonTooltipVerticalOffset is removed; button tooltips now use LayrzTooltip with kLayrzTooltipOffset.

Added

• LayrzTooltip — a Material-free tooltip composed on Overlay, with LayrzTooltipPosition (top/bottom/left/right) positioning. Content is contentText or contentRichText; never covers its anchor, flips at viewport edges, and leaves the wrapped widget's layout and hit-testing untouched.
• LayrzAlert and LayrzAlertIcon — inline status callout with six severities (info, success, warning, danger, context, custom) and five visual styles (.layrz, .filledTonal, .filled, .outlined, .filledIcon), resolved through LayrzAlertStyleSpec.
• LayrzAlert.onTap makes alerts interactive: tap, Enter or Space activate the callback; hover and focus trigger a paint-only surface lift and shadow appears at elevation 2, while press settles the surface and shadow steps to elevation 1.
• LayrzCard — a styled surface with fixed 16u padding, token radius, and elevation (int 1–5) selecting the shadow ramp. Optionally interactive via onTap.
• LayrzRow, LayrzCol and LayrzConstrainedView — a 12-column responsive grid. Columns declare span per breakpoint (1–12) as plain ints, cascading downward when a band is unset. Rows greedily wrap columns and size them by available width. LayrzConstrainedView centres and clamps a column to maxWidth with internal vertical spacing.
• Color.flattenOn and Color.isOpaque on LayrzColorExtensions — flatten a translucent colour onto a background for pixel-perfect compositing; test colour opacity without inspecting alpha directly.
• LayrzFontHandler.resolveFamilyForWeight — resolves a font family for a specific weight. Defaults to resolveFamily, preserving compatibility; handlers like LayrzGoogleFontsHandler override it to return weight-specific families.

Changed

• Font weights across the scale: display w800, headline w700, title w600, body w400, label w300 (was w100). The title step moves from w500.
• LayrzButton now composes LayrzTooltip instead of its own private tooltip implementation.

Fixed

• Font weights render correctly. Every style previously resolved to a single-face family, so all weights painted at regular. Font families are now resolved per weight via resolveFamilyForWeight, and every weight the scale uses is preloaded; web showroom no longer flashes fallback text.
• LayrzButton's pressed state activates correctly under fast mobile taps.
• Icon tree-shaking disabled for web release builds to prevent runtime errors.

0.0.2

Breaking

• lib/layrz_ui.dart is removed; import specific domain entrypoints instead — e.g. import 'package:layrz_ui/buttons.dart'; or import 'package:layrz_ui/theme.dart'; in place of a single import 'package:layrz_ui/layrz_ui.dart';.
• Semantic colour tokens are now LayrzColorSwatch rather than Color; the base values moved from the 600 to the 500 palette shade, so semantic colours are visibly brighter.
• contrastColor now uses Material's brightness threshold instead of the stricter WCAG crossover; labels on success, danger and info backgrounds change from black to white.

Added

• LayrzButton — the first component with twelve styles (filled, elevated, filledTonal, outlined, outlinedTonal, text, each with a Fab counterpart), built only on package:flutter/widgets.dart.
• Six semantic factories on LayrzButton: .save, .cancel, .info, .show, .edit, .delete, each with an isElevated flag.
• LayrzButtonType — success, info, context, danger, warning, custom; a color override applies only to custom.
• LayrzButtonController — one controller drives many buttons so a whole view shares one busy state, with a cooldown duration that auto-clears on expiry and an anti-flash floor preventing very short busy states from strobing.
• LayrzColorSwatch — a Material-free equivalent of MaterialColor giving every semantic colour a full tonal range from shade50 through shade900.
• A compact shadow ramp, compact1–compact5, for small components alongside the existing surface elevation ramp.
• Color.opposite as a shorthand alias for contrastColor.
• LayrzRadiusTokens.innerRadiusValue for computing concentric inner radii.

Changed

• The package adopts the Flutter SDK layout: entrypoints at the top of lib/, implementation under lib/src/.
• elevation1 now has a real vertical offset; it previously computed to zero and was invisible.

0.0.1

Added

• LayrzApp and LayrzApp.router — drop-in WidgetsApp replacements with zero Material or Cupertino dependency.
• A complete immutable design-token system: LayrzTokens aggregating LayrzColorTokens, LayrzTextTheme, LayrzSpacingTokens, LayrzRadiusTokens, LayrzShadowTokens, LayrzBorderTokens and LayrzMotionTokens.
• LayrzTokenizer — a thin façade over the tokens, kept in sync with direct theme.tokens access.
• LayrzThemeExtension<T> — a Material-free equivalent of ThemeExtension<T>, so components can attach theme-scoped data; retrieved with extension<T>() / maybeExtension<T>() or context.themeExtension<T>().
• LayrzPreviewTheme for Flutter 3.47 widget previews, exposed via package:layrz_ui/preview.dart.
• LayrzFontHandler with a LayrzGoogleFontsHandler implementation (google_fonts TextStyle APIs only, never *TextTheme()).
• The WidgetState / WidgetStateProperty / WidgetStatesController family re-exported from package:flutter/widgets.dart.
• LayrzPlatform for platform detection, LayrzColorExtensions, LayrzContextExtensions, and the responsive grid + duration + colour constants.
• A CI pipeline enforcing analyze, tests, formatting, the Material/Cupertino invariant, a google_fonts guard, a test-mirror structure check and a coverage ratchet.
• public_member_api_docs enforcement, so every public member ships documented.

Fixed

• LayrzTheme extends InheritedTheme and implements wrap(), so the theme survives Overlay and route boundaries — dialogs, tooltips, menus and dropdowns can resolve LayrzTheme.of(context).

Changed

• Light mode only. LayrzThemeData.dark(), LayrzThemeMode, context.isDark and the dark token variants were removed; errorColor is now dangerColor. The accent colour was removed entirely.
• The theme now loads its font automatically rather than relying on the host app.
• Base border radius is 8.0 (layrz_theme used 10.0).

Documentation

• engineering/ holds the architecture, decision log, token spec and milestone plans; per-component usage documentation lives in the GitHub wiki.