ripplearc_coreui 0.106.0
ripplearc_coreui: ^0.106.0 copied to clipboard
A Flutter design system package with design tokens and basic components.
Changelog #
0.106.0 A strip note and an error chip are never cut with "โฆ" #
๐ง Fixes #
- CoreSuggestionArea: the
noteis drawn inbodyMediumRegular(14/20), the style the UX design doc gives a strip note (Section 1.8), where 0.104.0 drew it inbodyLargeRegular. It is never cut with "โฆ": the two-line cap is gone, a long note wraps onto as many lines as it needs, and the strip, which already has a 64 dp minimum height, grows to fit it. At the default text size a note of the app's length (about 52 characters, two lines at 300 px) still fits inside 64 dp, so the keys below do not move (CA-1467) - CoreCalculatorChip: the Error type wraps its message onto more lines instead of ending it in "โฆ", so the user can read what to fix, and the chip grows taller. A wrapped error is as wide as its longest line (
TextWidthBasis.longestLine), so the chip ends as far after the text as it starts before it, not at the width of the row. Its corners are half the height of a one-line chip (CoreCalculatorChipTheme.borderRadiusFor, 14 dp for an error of one line ofbodySmallRegular), so a wrapped error keeps round corners that do not cut into its text, and a one-line error is the pill it was: the old 24 dp radius already drew as half its height. A value chip's name still ends in "โฆ" (CA-1405), and every other type keeps its corners (CA-1467)
๐งช Tests #
core_suggestion_area_test.dart: the note's style is Body Medium with no line cap; at 390 px and at 100%, 130% and 200% text a long note and a note of the app's length show every word inside the strip with nothing overflowing, and at 100% the app-length note keeps the strip at 64 dp.core_calculator_chip_test.dart: at 390 px and at 100%, 130% and 200% text a long error wraps inside a 192 dp row with every word shown and the chip taller than a one-line error, ending as far after its longest line as it starts before the text; the Error type's corners are half a one-line chip, on one line and wrapped, and every other type's are unchanged- Goldens:
core_calculator_chip_wrapped_error_{light,dark}.pngare new, with the chip as wide as its longest line;suggestion_area_note_large_text_{light,dark}.pngare new: the long note at 200% text in a 412 ร 240 view, the strip grown to fit it; the note goldens andsuggestion_area_note_two_lines_{light,dark}.pngare re-rendered for Body Medium and the uncapped note; incore_calculator_chip_long_names_{light,dark}.pngthe value-only chip that shortens its value is now an editable chip, since an error no longer shortens
0.105.0 The keyboard's visible English comes from the app #
โจ Features #
- CoreKeyboardLabels: one object for every visible word of the keyboard that is not a key's face โ the strip's "View all", the "โฆ group" header on the strip and in the "View all" sheet, and the sheet's "Function keys" title, "Measurement System" row and "Imperial" / "Metric" switch faces. CoreKeyboard and CoreFunctionKeyBottomSheet take it as
labels; CoreValueEditorSheet (both constructors and bothshowhelpers) and CoreSizesTableData take it askeyboardLabelsand hand it to the keyboard they embed, so the entry sheet aCoreGeometryAreatable opens takes the app's words too. With a set supplied, these six are no longer English literals from coreui; the function keys' faces and the group names come from the app throughKeyTypeandGroupNameType. What still is: the unit keys' faces ("Feet", "Inch", "Yards", "M", "CM", "MM" fromUnitTypeX.label), which are not in CA-1370's scope and stay as they were (CA-1370) - The parameter is optional and defaults to
CoreKeyboardLabels.english, the words the keyboard showed before, so no caller breaks and the keyboard, sheet and value editor goldens are unchanged. As withCoreKeyboardSemantics.english(0.91.0), that default is an exception to the 0.15.0 rule that a user-facing string reaches the screen only through the app's localisation, which CA-1370 allows so that no existing caller breaks, at the cost that a call site which forgets the set stays English with no warning - Showcase:
showcaseKeyboardLabels("All keys", "โฆ keys", "Units") is passed by the keyboard, display area, suggestion area, value editor and geometry area screens, the way an app passes its localised words
๐ง Fixes #
- The "View all" sheet's group header text is flexible and ends in an ellipsis inside a narrow sheet, as the strip's already did, so a long localised header no longer overflows the row beside the drag handle and the dot. The "Measurement System" label takes the width left beside the switch and ends in an ellipsis when short of it, 8 dp (
space2) from the switch as in the sheet's other rows, where before the row overflowed at 320 dp even in English; where it fits, nothing moves - An unused private unit-system toggle in the sheet's file, which drew its own "Imperial" / "Metric", is deleted; the sheet has used
CoreSwitchsince the unit row was built
๐ง Deprecations #
UnitSystemX.label("Imperial" / "Metric" from aUnitSystem) is deprecated: nothing in coreui draws it any more, and it is English only. ReadCoreKeyboardLabels.imperial/metric, or name the system through the app's localisation. The app does not call it
๐ Design notes #
CoreKeyboardLabels.viewAll,imperialandmetricare documented as short words: the "View all" button sits beside the group header, which gives way first, and the switch's track is a fixed widthCoreKeyboardLabels.viewAllandgroupHeadersay the screen reader readsCoreKeyboardSemantics.viewAllLabelandgroupHeaderinstead, so the visible words must sit inside those labels (WCAG 2.5.3, Label in Name) for a voice control user to say what they see. The showcase sets follow it: "All keys" is read as "All keys, every function key group", and "Materials keys" as "Materials keys, selects the group"- Figma's Function keys sheet (
62234:74174) draws the title and the group headers but no unit-system row: the "Measurement System" label and its switch are coreui's own, which is why the ticket names them for localisation. Figma keeps the unit system in the More sheet's Preferences as "System of units"
๐งช Tests #
core_keyboard_labels_test.dart: the English constant equals the former literals; insideCoreKeyboardthe strip shows the set's "View all" and group header, and the sheet it opens shows the set's title, measurement system label, the imperial face and then the metric face once the switch is tapped, and every group header, with none of the English left; a keyboard built without a set keeps the English on the strip and in the sheet; a sheet built on its own follows the set, and in a 320 dp sheet a long group header and a long measurement system label each end in an ellipsis inside the width, the label at least 8 dp short of the switch, and nothing overflows;CoreValueEditorSheetpasses the set on fromshowandshowSingleValue; aCoreGeometryAreatable's entry sheet fromkeyboardLabels.core_keyboard_a11y_test.dart: with a French semantics set and a French label set, "View all" and the sheet meet the label guideline in both themes, the spoken labels of "View all" and of a sheet group header start with their visible words (WCAG 2.5.3), the sheet's title and measurement-system nodes read the set's words, and no node on the sheet reads "Function keys", "Measurement System", "Imperial", "Metric", "View all" or "โฆ group". Keyboard, sheet, value editor and geometry area goldens are unchanged
0.104.0 A slot for a strip note, in the warning style #
โจ Features #
- CoreSuggestionArea.note: the strip's own slot for a short warning โ "12ft was not added." โ in
textWarningStrongatbodyLargeRegular(Body Large/Regular 16/24, as the ticket asks), up to two lines, the second ending in an ellipsis. While set it is what the strip shows, in place of the suggestions and the placeholder alike, so the app sets it on a refused key and clears it on the next one without touching its lists; before, the app had to put the note insuggestionAreaPlaceholder, in the placeholder's grey. At the default text size two lines fit inside the strip's minimum height, so a one-row strip does not move and the keyboard below stays put (at a larger text scale they are taller than it, as two chip rows are); a two-row strip folds to one row, as it does when its lists empty. Setting it folds an expanded row and reports that throughonExpandedChangedthe way a suggestion change does; clearing it brings the rows back collapsed. The note is a live region, so a screen reader hears the refusal.nullor an empty string, the default, leaves the strip as it was. The text carriesCoreSuggestionArea.noteKey(calc_strip_note) for Patrol (CA-1433) - Showcase: the suggestion area screen gains "Strip note" and "Two-line note" switches, the one-line and two-line notes the ticket asks for
๐ Design notes #
- The note uses
textWarningStrong(orange 700#B03C00light, orange 200 dark). It is the library token for Figma Text Color/Warning, the colour the ticket asks for.textWarning(orange 600) reaches only 4.2:1 on the light page background, under the 4.5:1 WCAG 1.4.3 asks of 16 px regular text;textWarningStrongreaches 5.8:1 light and over 7:1 dark
๐งช Tests #
- The note shows in the warning colour at Body Large/Regular, two lines at most with an ellipsis, in place of the placeholder; it replaces the suggestions while set and they return when it is cleared; an empty note is no note; a two-line note leaves the strip at its 64 dp minimum height, and at twice the text size the strip grows with the taller note, inside the width; in two rows a note folds both rows to that height and they come back when it clears; setting it folds an expanded row and reports
false, and clearing it brings the overflow control back. A11y: the note meets the contrast guideline in both themes and is a live region that reads the note. Light and dark goldens of the strip with a one-line note and with a two-line note ending in an ellipsis (412 ร 64 each). The existing suggestion area goldens are unchanged
0.103.0 The history panel's rule is a CoreDivider #
๐ง Internal #
- CoreDisplayArea history panel: the hairline between two previous-session cards is a
CoreDividerinlineDarkOutline, where before it was a MaterialDividerset up by hand with a private thickness constant and a TODO. The rule sits centred in aCoreSpacing.space4slot, the 16 dp thatDividerowned by default, so the cards are where they were and the stage goldens are unchanged; the TODO and the constant are gone. One thing no longer applies: an ambientDividerThemeData.spacefrom the app used to size that slot, and now does not, asCoreDividerignores divider themes by design (CA-1020) - Showcase: unchanged. The display area screen's two previous sessions show the rule in the full-screen stage
๐งช Tests #
- In the full-screen stage a
CoreDividerinlineDarkOutlinesits between each pair of session cards, one pixel tall and 7.5 dp from the card above and the card below, the cards found by their restore keys;expandedPreviousshows the last session alone with no rule. The restore group'ssession,buildAreaandrevealPreviousSessionshelpers are hoisted to the file so both groups share them. The display area goldens, the three-stage and two-stage ones included, are unchanged
0.102.0 A long name stays inside the row at phone width #
๐ง Fixes #
- CoreDisplayArea label row: a label longer than the row wraps onto a second line and ends in an ellipsis after that, where before it ran past the edge of the area; a label that fits is laid out as before. The typing dots sit beside the last line of a wrapped label, right after the label's longest line: the label is as wide as its longest line, and the dots keep the same height beside the last line that they have beside a one-line label, so every one-line label row is laid out as before (CA-1405)
- CoreCalculatorChip: inside a bounded width โ the tape's
Wrap, where a chip can be no wider than its row โ a label longer than the space left ends in an ellipsis, so the chip stays inside the row and its value stays whole (Pitch-rise per 12iโฆ 6in/12in): the value is the app's number, shorter than any row, and is the part that must be read. A chip without a label shortens its value instead. A screen reader still hears the whole text. In an unbounded width, such as a horizontal scroll view, nothing is shortened and the chip takes its full width as before; a line break in a label or value still breaks the line (CA-1405) - Showcase: the calculator chip screen shows the two shortened chips in a 192 dp row, and the display area screen's Basic Geometry group gains a "Pitch-rise per 12in run" key, so the long name reaches the label row and the tape
๐ Design notes #
- The app's S1b calculator page tests render at 800 dp; moving them to a phone's 390 dp is the app's side of CA-1405 and is not changed here
๐งช Tests #
- Chip: in a 192 dp row a long name ends in an ellipsis, the chip fits the row and the value keeps its whole width; a chip without a name shortens its value; a short name keeps its full width; the screen reader hears the whole name; in a horizontal scroll view the chip takes its full width and the name is drawn whole; a value with a line break keeps both lines; a chip lays out under an
IntrinsicWidthparent. Display area: at 390 dp with text at twice the size a long label wraps, stays inside the area, and the typing dots end before the row's edge and sit beside its last line, at the same height as beside a one-line label; a label too long for two lines ends in an ellipsis at the second. Light and dark goldens of the two shortened chips in a 192 dp row, and of a 390 dp display area at twice the text size with the long label and chip. The existing display area and chip goldens are unchanged
0.101.0 A trailing slot on the empty tape row #
โจ Features #
- CoreDisplayArea.emptyTapeTrailing: a widget placed at the end of the row that shows
historyPlaceholderwhilechipsListis empty โ the calculator's System of units pill. The row makes room for it: the placeholder takes the width that is left between the close icon and the widget and wraps, so the two never overlap on a narrow phone, where an overlay let the text run under the pill. It leaves with the placeholder: not rendered once the tape has a chip, nor inexpandedPreviousandfullScreen, where the close icon and its row are hidden.null, the default, leaves the row as it was. The close icon and the widget are centred on the first 48 dp of the row and stay at its top, and a widget taller than 48 dp starts at the row top: a placeholder that wraps past them, as it does beside a wide pill at the largest text size, grows the row downward and moves neither, so both stay inside the 228 dp collapsed area and can be tapped. A smallCoreButtonin the slot already meets the 48 dp tap target (CA-1375) - Showcase: the display area screen puts an Imperial / Metric pill in the slot; it switches the keyboard's unit system and goes when the first chip lands
๐งช Tests #
- The widget sits at the end edge of the placeholder row while the tape is empty, is left out once the tape has a chip and in the two stages that hide the close row, and comes back when the area collapses; at 390 dp a long placeholder wraps beside it and the widget keeps its own width at the end edge, with no overflow, and with text at twice the size it wraps beside a
CoreButtonpill the same way; the row without a widget is as before; aCoreButtonpill in the slot meets the label and contrast guidelines in both themes and announces its own label and hint, and is centred on the close icon, while a widget taller than 48 dp starts at the row top with the close icon still centred on the first 48 dp; at 390 dp and 375 dp with text at 3.12 times the size, and at 320 dp at 3 times, the close icon and aCoreButtonpill stay inside the collapsed area and take a tap; the stage is checked after each fling, sofullScreenis really reached; light and dark goldens of the empty state with the pill (412 ร 228). The existing display area goldens are unchanged
0.100.0 CoreSwitch disabled state and Show Hide look #
โจ Features #
- CoreSwitch disabled state: pass a null
onChangedto disable the switch (it is nowValueChanged<bool>?; enabled switches do not change). A disabled switch ignores taps, Tab skips it, and it uses one set of colours for every type, as Figma draws it:pageBackgroundtrack with alineMidborder in both On and Off,textDisablelabel and aniconGrayLightthumb without a shadow. The thumb keeps the size and side of its own On or Off state, at the same gap from the edge as an enabled thumb: the border no longer pushes a disabled On thumb 1 dp to the right (CA-1342) - CoreSwitchType.showHide: the Show Hide look of the share sheet, 72 x 32. Off is a
backgroundGrayLighttrack with alineMidborder, "Hide" intextDarkand aniconGrayMidthumb on the left, the Off thumb of the normal type. On is abuttonSurfacetrack, "Show" intextInverseand atextInversethumb on the right, like every On thumb: white in light mode, #101828 in dark mode. Both labels are Body Small Semibold and default to "Hide" and "Show"; the label always names the current state. The word sits against the 8 dp padding at the edge far from the thumb, as the storyboard draws it; the other types keep their centred label (CA-1342) - CoreSwitch semantics: the switch reads as toggled or not and as enabled or disabled. The new optional
semanticLabelis the name a screen reader reads first. The label, state, tap action and keyboard focus are one node. The default "Show" and "Hide" labels are English; pass localized labels in a localized app (CA-1342)
๐ง Fixes #
- CoreSwitch labels at large text: a label that does not fit the track scales down instead of being cut, so the switch keeps its library size. Measured in Roboto, labels used to wrap and be cut from 1.3x text ("Show", "Private", "Unlock", "Imperial"), 1.5x ("Hide" needs 38.3 dp and its slot was 34.4 dp; "Public", "Metric") or 2.0x ("Lock") (CA-1342)
- CoreSwitch focus ring: the 2 dp
outlineFocusring now stands 2 dp clear of the track, as CoreButton's focus ring does. In light mode an On track (iconDark, orbuttonSurfacefor Show Hide) is the same colour asoutlineFocus, so the touching ring of 0.58.0 only made an On switch look thicker (CA-1342)
๐ Design notes #
Show Hide is 32 high; the other labelled types stay 24 high. The Show Hide thumb is 14 in both states with 8 px padding, so it sits 9 dp from the left edge when Off (inside the 1 px border) and 8 dp from the right edge when On. Check the thumb padding against Figma node 57436:8960 when the design changes.
๐งช Tests #
- Widget tests: Show Hide label, size and colours; disabled colours for every type in On and Off; the thumb side of a disabled switch; a tap on a disabled switch; Tab skips a disabled switch and draws no ring; the semantics of an enabled and a disabled switch, and that an enabled one is focusable. Goldens: Show Hide and a disabled grid of every look in On and Off (light and dark). Accessibility tests: a screen reader can toggle an enabled switch; a disabled one exposes no tap action. Large text: every labelled type, On and Off, keeps its label inside the track and on one line at its full width at 1.5x and 2.0x (15 of the 16 fail without the fix; normal "On" at 1.5x fits anyway). On thumb is
textInversefor every type in light and dark. A disabled On thumb keeps the edge gap of an enabled one, for every type, compact and labelled. The Show Hide thumb sits at the Figma gaps. The Show Hide word sits against the far padding, enabled and disabled, On and Off, measured in Roboto (all 4 fail with the word centred). Focus: the ring is 2 dp clear of the track for normal and Show Hide, On and Off (fails without the gap). Goldens: Show Hide focused Off and On, light and dark; the normal focused goldens are redrawn with the gap
0.99.0 CoreInlineErrorRow disabled action #
โจ Features #
- CoreInlineErrorRow:
isActionDisabledgives the action its disabled look while the retry it starts is running, as the storyboard frame "Look-up, saved prices not read" says: the label stays, intextDisableand the same size and weight, with no spinner. A tap, Enter or Space calls nothing, Tab skips the action and no focus ring or pressed colour shows, and a screen reader reads it as a disabled button. The tap zone and the row do not change size or move. Only valid together withactionLabel(asserted) (CA-1411) - Showcase: the Inline Error Row screen has a row that disables its action for two seconds after a tap, and the component doc lists the new property
๐งช Tests #
- Disabled action: no
onActioncall on a tap by key or by label,textDisablein both themes with the size and weight kept, the row, zone and label unmoved, the message keeping its colour and live region, a disabled button with no tap action for a screen reader and an enabled one when not disabled, Tab, Enter and Space doing nothing and drawing no ring, nobuttonPresscolour on a press, the ring gone when an action becomes disabled while focused,textLinkand the tap back after it is enabled again, and the assert without an action. A11y: the disabled action's 48 dp zone and label in both themes, asserted directly because Flutter's guidelines skip a disabled node. Goldens: the disabled action added to the light and dark variants images
0.94.0 CoreInlineErrorRow #
โจ Features #
- CoreInlineErrorRow: a one-line error row. A
CoreIcons.erroricon at 16 dp iniconRedand the message inbodySmallRegularintextError, with 8 dp between them, as the storyboard draws it; the icon is centred on the message's first line, also when the message wraps and when the phone's text size is changed. The icon and message are one live region, so a screen reader announces the message when the row appears. An optionalactionLabelwithonActionadds atextLinkaction such as "Try again" inbodyLargeSemiBold, as the storyboard draws it, in its own button node, with a tap zone of at least 48 x 48 dp, 12 dp after the message; one without the other is rejected. The action is at most half the row wide and wraps beyond that. Tab reaches the action and Enter or Space callsonAction; focus draws a 3 dpoutlineFocusstadium ring around the label, 12 dp wider at each side so it never moves the layout, and pressed turns the labelbuttonPress, as the library Text button does; a touch tap draws no ring. The label and the whole zone end at the row's end edge. The row cannot sit inside an intrinsic-size parent such asIntrinsicHeight.actionKeyputs aKeyon the action's tap zone so a test can find it (CA-1316) - Showcase: an Inline Error Row screen in the example app, and a component doc
๐งช Tests #
- Message and action styles and colours, the icon's size and
iconRedcolour in both themes, the 12 dp gap before the action, the 8 dp gap, the label ending at the row's edge in both directions and the last 2 dp of the zone tappable, no action unless given, oneonActioncall per tap on the action and none on the message, the 48 x 48 dp zone, wrapping with the icon centred on the first line, also at 1.3x and 2x text, a one-line message's icon on the line's centre, the two asserts,actionKeyfinding the action, a short label's 48 dp wide zone and a tap beside it, the row's height under a loose-height parent, no overflow at twice the text size, the message keeping at least half of a 320 dp row at twice the text size, and the icon on the start side in right-to-left; the message announced as a live region, with the unlabelled icon adding nothing to it, and the action as a separate button outside it. Keyboard: Tab then Enter, Tab then Space, the ring's size, colour and pixel and nothing moving, no ring on a touch tap, the pressed label colour and its release. A11y: tap target, label and text contrast guidelines in both themes. Goldens: light and dark, with every variant, and the focused action
0.93.0 A function key announces its full name, and the group dots get their own tokens #
๐ง Fixes #
- FunctionKeyTile: a key with
KeyType.semanticLabelis announced by it โ the full name behind an abbreviated face, "Footing" forFootngโ and a key without one, or with an empty one, by its face. The hint iscustomHintor nothing (the strip and the sheet pass no hint, so a function key on the keyboard announces its name alone). The face is left out of the node, so the name is announced once, not the name and then the face. The tile adds no words of its own: "function key" and "Tap to use โฆ function" are gone, so nothing it announces is fixed English. Same on the strip and in the "View all" sheet (CA-1195 A)
โจ Features #
- AppColorsExtension.keyboardGroupGeometry / keyboardGroupShapes / keyboardGroupMaterials / keyboardGroupUnit / keyboardGroupTrigonometry: one accent token per function-key group for the dot on the strip and in the "View all" sheet, from
CoreKeyboardColorsandCoreDarkKeyboardColors. Light:orient800#015B7C7.21:1,violet500#7A5AF84.33:1,orange500#EB50003.54:1,royalBlue500#2970FF4.14:1,green500#009E693.30:1 on the page background. Dark:orient400#00AEE06.87:1,violet5003.93:1,amber500#F790097.56:1,royalBlue5004.10:1,emerald500#12B76A6.77:1. Every dot reaches 3:1 (WCAG 1.4.11) and no two match in either theme. The prototype's amber and green reach only 2.25:1 and 2.51:1 on the light sheet, so they take the nearest palette step that passes; its teal reaches 2.36:1 on the dark one, andorient700, the nearest step that passes, does so at 3.03:1 with no margin, so the dark Geometry dot takesorient400, the teal the dark keyboard already uses for its main key (CA-1195 B) - Showcase: the colour screen gains a "Function-key group dots" section and the keyboard screen's groups use the new tokens
๐ Design notes #
ControlAction.moreOptionsstays deprecated, not deleted (CA-1195 C): the app still carries itscase ControlAction.moreOptions:arm until CA-1087 replaces its calculator bloc. The deletion is a breaking change and follows in its own release once that arm is gone
๐งช Tests #
- Tile: a
semanticLabelis exactly what the Semantics node announces, a key without one or with an empty one exactly its face, the hint is the caller's or absent, a screen reader tap presses the key once, and a named and a bare key meet the tap target and label guidelines in both themes; the same read on the strip and in the "View all" sheet. Tokens: the five values in each theme, 3:1 on the page background, five different colours per theme,copyWith, andlerptoward five other dots; the colour swatch goldens gain the five tokens and grow 100 px so the shadow row stays whole. Keyboard and value editor goldens are unchanged
0.92.0 The keyboard's screen-reader strings come from the app (2/2: the keyboard, the sheet and the value editor) #
โจ Features #
- CoreKeyboard, CoreFunctionKeyBottomSheet and CoreValueEditorSheet (as
keyboardSemantics, on both constructors and bothshowhelpers) take aCoreKeyboardSemanticsand hand it to every key, the drag handle, the "View all" button and its hint, the unit system switch, the group headers and their drag handles. With a set supplied, no screen-reader label or hint on the keyboard, the collapsed keyboard or the "View all" sheet is an English literal from coreui, except what is named here: the function-key tile's own words are CA-1195's (#259); the visible "Function keys", "โฆ group" and "Measurement System" texts and the switch's "Imperial" / "Metric" faces are read as part of their nodes and are CA-1370's; the visible "View all" is seen and not read (CA-1198, 2/2) - The "View all" button's own node carries the set's label and hint, where before they merged into the strip and the focused button announced its visible "View all"; the node keeps the button's enabled and focusable state
- CoreSizesTableData.keyboardSemantics: the entry sheet a
CoreGeometryAreatable opens hands it to the keyboard it embeds, so that path takes the app's set too parenSemanticLabel/parenSemanticHintandreorderSemanticsLabelBuilderstay as they were and, when set, win over the set'scontrolLabel,controlHintandreorderHandle.CoreFunctionKeyBottomSheet.defaultReorderSemanticsLabelis deprecated: it isCoreKeyboardSemantics.english.reorderHandle- Showcase: the keyboard, value editor, geometry area, display area and suggestion area screens pass the showcase set to every keyboard and entry sheet they show
๐งช Tests #
- Inside
CoreKeyboardevery digit, operator, unit (imperial and metric), control and result key, the drag handle, "View all" and its hint follow the set exactly; the sheet's switch, group header and drag handle, and those of a sheet built on its own, contain the set's label; a screen reader tap on "View all" opens the sheet; the paren label, the paren hint and the reorder builder win over the set; a keyboard built without a set keeps the English;CoreValueEditorSheetpasses the set on fromshowandshowSingleValue, and aCoreGeometryAreatable's entry sheet fromkeyboardSemantics. A11y: every key kind (found by its own key) and "View all" meet the tap target and label guidelines in both themes with caller-supplied labels, and their nodes measure at least 48 dp; the drag handle announces the caller's label (its 12 dp height is older code; CA-1361 gives it a 48 dp tap area). Keyboard and value editor goldens are unchanged
0.91.0 The keyboard's screen-reader strings come from the app (1/2: the object and the keys) #
โจ Features #
- CoreKeyboardSemantics: one object for every string a screen reader announces on the keyboard โ a builder per key kind (digit, operator, unit, control label and hint, result label from the key's face) and the strings of the result hint, the drag handle, the "View all" button and its hint, the unit system switch, the group headers and their drag handles. Each key widget (
CoreDigitInput,CoreOperatorButton,CoreUnitButton,CoreControlButton,CoreResultButton) andCoreNumberKeypadtake it assemantics;CoreKeyboard, its "View all" sheet andCoreValueEditorSheettake it in 0.92.0 (CA-1198, 1/2) - The parameter is optional and defaults to
CoreKeyboardSemantics.english, the strings the keys announced before, so no caller breaks. That default is an exception to the 0.15.0 rule that a user-facing string reaches the screen only through the app's localisation, which CA-1198 allows: the English lives in one constant that an app replaces with its localisation in one place, at the cost that a call site which forgets the set stays English with no warning. A per-keysemanticLabel/semanticHintonCoreControlButtonstays as it was and, when set, wins over the object'scontrolLabel/controlHint - Showcase: the number keypad screen passes a showcase set
๐ง Fixes #
- A key's visible face is left out of its semantics node: each key drew its face (
7,Feet,( ),=) with a plainText, which Flutter merged into the key's node, so a screen reader read the supplied label and then the English face ("Pieds, Feet"). The face is now excluded and the node carries the supplied label alone (CA-1198, 1/2)
๐งช Tests #
- Each key kind announces exactly the caller-supplied label, the English face not read, and the hint where it has one, when built alone; a per-key label or hint on a control key wins over the set; a result key with a caller-supplied face gets no hint; the English constant equals the former literals, every
ControlActionincluded;CoreNumberKeypadpasses the set to its digit and backspace keys. Keyboard goldens are unchanged
0.89.0 CoreQuickSheet fixed height #
โจ Features #
- CoreQuickSheet:
isFixedHeight(defaultfalse) keeps the sheet at one height, so it no longer grows or shrinks when its content changes and the controls at the top stay under the thumb. The child gets the full height below the drag handle, so a caller can wrap one part inExpandedto fill the spare height and keep a footer at the bottom. Content that does not fit scrolls only if thatExpandedpart is a scroll view, such as aListView.fixedHeightRatiolets the caller set that height as a share of the screen (for example 0.64, as in CUJ 7); it defaults to 0.9, and values above 0.9 are capped at 0.9, so the 90% limit is kept, and with the option off the sheet sizes to its content exactly as before (CA-1343) - Showcase: a Fixed Height Sheet demo in the quick sheet screen, at 64% with
useSafeArea: trueso the footer stays above the home bar
๐งช Tests #
- Widget tests: height is 90% of the screen by default and the caller's ratio when one is passed (also with a bottom inset), a ratio above 90% is capped, a ratio without the option or of 0 is an error, height unchanged when the content changes, filling part and footer, a child that does not fill still gets all the height below the handle, long content scrolls, default still wraps its content
- Goldens: fixed height with short content (filled, footer at the bottom), with long content, and at a 64% ratio, on a 400 x 800 dp view
0.88.0 CoreUnderlineTextField text that wraps to several lines #
โจ Features #
- CoreUnderlineTextField.maxLines: lets the value wrap. The field grows with its text up to
maxLineslines, then the text scrolls inside it, and the return key adds a new line. The underline sits 8px under the last line (4px withlabelTrailingat the regular or compact size, as on one line), as the Figma Line Multi-line variants draw it. As on one line, the screen reader node is at least 48px tall while the row is drawn as tall as its lines. The default, 1, is unchanged (CA-1347) - The error row and the hint row the ticket asks for were already part of the field (
errorText,helperText), so they are only covered with new multi-line tests and goldens - No Material needed: the field brings its own transparent
Material, so outside aScaffoldorMaterialit no longer throws "No Material widget found" and its label, prefix, unit, helper line and error draw as they do under aScaffold(one line or several) - Height questions: a multi-line field gives the same height to intrinsic and dry layout as to normal layout, so inside
IntrinsicHeighta field with one line of text is 53px, as on one line (was 77px), andgetDryLayoutno longer throws - Docs:
compactnow says it draws the same asregular(since 0.55.0); the class,sizeand enum docs still said its underline sat 2px closer - Showcase: a "Several lines" section in the Underline Text Field screen, and the component doc describes
maxLines
๐งช Tests #
- Widget tests for wrapping, the 8px gap under the last line, the stop at
maxLineswith scrolling, the new line on return, the error replacing the hint, the drawn height matching one line, and the unchanged default (53px, 8px gap) - Accessibility tests: a multi-line field on one line has a 48px node, at every size, with and without a label (padded, since the tap target guideline skips a node at the screen edge)
- Widget tests: every size, one line and four, builds and takes text with no Material above it, and its label, prefix, unit, helper line and error have the same style as under a
Scaffold: not monospace, no double underline (fails without the fix) - Widget tests: in
IntrinsicHeight,maxLines1 and 4 with one line of text are both 53px; dry layout matches layout (fails without the fix) - Goldens for short text, long text, hint and error on a multi-line field; focused at the regular and large size; disabled at every size; in light and dark
0.87.0 CoreKeyboard drag handle: press feedback is visible #
๐ง Fixes #
- CoreKeyboard drag handle: pressing or focusing the handle showed nothing. Its
InkWelldrew them on aMaterialbehind the keyboard, and the keyboard'spageBackgroundwas painted over them. TheInkWellnow has its own transparentMaterial, so the theme's highlight, splash and keyboard-focus overlay show over the handle row in light and dark. Tap, drag and the handle's label are unchanged (CA-1389)
๐งช Tests #
- Pressing the handle paints ink on a layer inside the keyboard background, not behind it (fails on the old code). New goldens for the handle pressed and focused (Tab), light and dark
0.82.0 CoreCheckRowItem.checkRow, disabled rows and a keyboard focus ring #
โจ Features #
- CoreCheckRowItem.checkRow: a second look for the row, the Figma List item "Check row" (62505:74872) for lists such as the CUJ 8 "Send to" sheet: 40 dp avatar (
backgroundBlueLight, two initials such as "JS" inbodyLargeSemiBoldtextLink, as the storyboard's Send to list draws them; newCoreCheckRowItem.initialsFor), namebodyLargeMediumtextHeadline, second linebodyMediumRegulartextBody, 12 dp above and below, 20 dp at the sides, 12 dp gaps,iconDarktick, no fill when selected, and a 1 dplineLightdivider inset 20 dp on the bottom edge that adds no height.showDivider: falsedrops it on the last row; only this constructor takesshowDivider, so a Dropdown cell cannot get one. The defaultCoreCheckRowItem(...)keeps the library Dropdown cell look of 0.46.0 (CA-1318), so current callers do not change. A screen reader reads the Check row's name and second line ("Judy Smith, Homeowner ยท judy.smith@gmail.com"), so two people with the same name sound different;semanticLabelstill overrides it (CA-1344) - CoreCheckRowItem.enabled (both looks, default
true):falseignores taps, Tab skips the row, a screen reader reads it as disabled, and the name, second line and default initial usetextDisable. A customleadingoravatarTextColoris not dimmed; the box keeps its look (CA-1344)
๐ง Fixes #
- CoreCheckRowItem keyboard focus: Tab used to show Material's grey focus overlay, which is not a library colour. Both looks now draw the 2 dp
outlineFocusring other coreui parts use, just inside the row and following its radius, for keyboard focus only; a touch after Tab clears it. Enter or Space toggles the row
๐ Design notes #
The Check row's pressed fill is backgroundGrayMid, Background/Grey Mid as the library draws it (node 66801:224029). Neither library part draws a focused state.
๐งช Tests #
- Unit tests:
initialsForfor two words, three words, one word, extra spaces and a blank name - Widget tests: the Check row shows two initials and the Dropdown cell one; the Check row's styles, sizes (64 dp, 68 dp with a second line), tick colours, divider, no selected fill; press fill read as pixels on the page and inside a coloured parent; the screen reader label (name and second line in the Check row, name only in the Dropdown cell,
semanticLabelwins); for both looks two taps toggle twice, a disabled row ignores two taps and dims its text, reads as disabled, Tab draws the ring with no grey, Enter toggles, a touch after Tab clears the ring, Tab skips a disabled row; at least 48 dp high for each look, also with a small leading widget; the initial stays inside the 40 dp avatar at 200% text - Accessibility tests: the Check row (selected and not, padded off the screen edge) meets the tap target and contrast guidelines in both themes. A disabled row has no test here: Flutter's tap target and contrast guidelines skip disabled nodes, so it could not fail; the widget tests check its
textDisablecolour - Goldens (light and dark): Check row default, a second line that wraps at 360 dp ("Homeowner ยท judy.smith@gmail.com", 88 dp), selected, disabled, disabled selected, last row, Dropdown cell disabled and disabled selected; Check row pressed; Check row and Dropdown cell focused
0.81.0 Receipt toast View: press and focus looks #
๐ง Fixes #
- Toast.receipt second action (
View): it had noMaterialof its own, so it threw "No Material widget found" on a parent without one, and it showed no press look and only Material's grey focus tint over the whole 48 dp box. It now has its ownMaterial, and like the alert's text button its label turnsbuttonPresswhile pressed and Tab focus draws the 3 pxoutlineFocusring around the label (CA-1321) - Toast text button focus ring: the ring is a
StadiumBorder, not a 40 px spacing value used as a radius. It looks the same (CA-1321) - Toast text with no Material: a
Toastplaced with noMaterialabove it (aMaterialAppwithout aScaffold, for example) drew its title, description and receipt text in monospace with a yellow double underline. The toast's row now has its own transparentMaterial, so every toast type draws its text as it does under aScaffold.CoreToastwas not affected: its overlay already wraps the toast in aMaterial(CA-1321)
๐งช Tests #
- View turns Button Press while pressed and fires once over two presses; Tab rings its label and Enter takes it; it works in a coloured parent with no
Material; with the short label and a long one its ring stays clear of Undo and of the message text, and the alert View ring stays clear of the close x. New goldens: receipt View pressed and focused, light and dark; the alert View focused goldens are redrawn for the stadium ring - Every toast type (error with a title, warning, info with a title, success, receipt with Undo, acknowledgement) with no
Materialabove it: each text has the same style as under aScaffold, not monospace and no double underline. All 6 fail without the fix
0.80.0 Alert text button #
โจ Features #
- Toast alerts:
Toast.error,warning,infoandsuccesstake an optionalactionLabelwithonAction: a text button intextLinkbeside the close x, such asView, with a 48 x 48 target. The label is at most 120 dp wide and ends in an ellipsis on one line, so a long or translated label keeps the message and the x in the alert. Taking it firesonAction, thenonClose. It never pops a route, so aViewthat opens a page leaves that page on screen; only the x pops the route when there is noonClose, so passonCloseto remove an alert that has an action. On a titled alert the text button sits on the first title line with the x. An assert keepsactionLabelandonActiontogether. Like the library Text button, a pressed label turnsbuttonPressand Tab focus draws a 3 pxoutlineFocusring 12 px beside and 5 px above and below the label. The button has its ownMaterial, so it works on a coloured parent or with none (CA-1321)
๐งช Tests #
- Alerts: no text button without
actionLabel, a longViewlabel (34 characters at 100% text, 16 at 200%) in a 360 dp screen ends in an ellipsis at 120 dp with no overflow, the message keeps its width and the x stays inside the alert,onActionthenonClose, aViewwith noonClosethat opens a page leaves the page on screen, withoutonCloseViewfires on every tap and the alert stays, on a titled alertViewcentred on the first title line, the text button's 48 px target, the pressed colour on two presses with one action, Tab focus with the ring's place and Enter to take it, and a coloured parent with noMaterial. A11y: the text button's target and label in both themes. Goldens: the toast sheet (light and dark) showsViewon two error alerts; new,Viewpressed and focused in light and dark
0.73.0 Alert body text uses textDark #
๐ง Fixes #
- Toast alert body: the body of a titled error, success, warning or info alert now uses
textDark, nottextBody, so it can be read in the sun. The title and the small alert already usedtextDark. The icon keeps its kind colour. The receipt keepstextLinkand the acknowledgement does not change. Apps that show a titled alert will see darker body text in the light theme and brighter body text in the dark theme
๐งช Tests #
- On all four alert kinds, in light and dark, the title and body of a titled alert and the body of a small alert use
textDark. Goldens changed for the body text:toast_componentandcore_preference_option_sheet_info, light and dark
0.66.0 CoreChip close button: 48 dp target, keyboard focus, own label #
๐ง Fixes #
- CoreChip close (ร): the ร was a bare 20 dp
GestureDetector, so it had a 20 x 20 tap area and Tab could not reach it. It now has a 48 x 48 tap target at the chip's end, which overlaps the end of the text so the chip keeps its look. A chip with a ร is at least 48 dp high, so a small chip with a ร (42 dp before) sits centred in 48 dp. Tab moves from the chip to the ร. Pressed, the chip shows its pressed look. Focused, a 2 dpoutlineFocusring is drawn around the ร and the chip border stays at rest, so Tab on the chip and Tab on the ร look different (CA-1322) - Breaking for tests: the
close_iconkey moved from the ร icon to the ร button'sInkWell. A test that findsclose_iconand expects aCoreIconWidgetnow finds anInkWell; tapping it still removes the chip (CA-1322) - CoreChip.removeSemanticsLabel: new. Overrides the ร button's screen-reader label, which was always the English "Remove" and the chip's text. Pass a localised string (CA-1322)
๐งช Tests #
- The ร target is at least 48 x 48 on every chip size, covers the icon and stays inside the chip; Tab on the chip draws no ร ring; a second Tab rings the ร and puts the chip border back at rest; Enter or Space on the focused ร removes the chip once; pressing the ร shows the pressed look;
removeSemanticsLabelreplaces the English label; a tap on the start of the label selects the chip and does not fireonRemove. New goldens for the ร focused and pressed, and for one Tab on a chip with a ร (the chip ringed, not the ร), light and dark
0.58.0 CoreTabs press and focus looks, CoreSwitch keyboard focus #
โจ Features #
- CoreTabs press: a pressed tab fills its 40 px face with
backgroundGrayMid, the library Press state. The selected tab keeps its indicator while pressed. Flutter's tint over the whole 48 px tap area and the 4 px gap is gone. The tabs carry their own transparentMaterial, so the fill also shows inside a colouredContainer(CA-1320) - CoreTabs focus: Tab focus draws a 2 px
outlineFocusring on the tab face. A touch tap draws no ring and clears one left by Tab, and the tab keeps its size.CoreTabs.tabKey(index)finds a tab's face in tests (CA-1320) - CoreSwitch keyboard: Tab now reaches the switch, and Enter or Space toggles it. Keyboard focus draws a 2 px
outlineFocusring just outside the track, so the switch keeps its size. A touch tap draws no ring. The library draws no press look for the switch, so there is none (CA-1320)
๐งช Tests #
- Tabs: inside a coloured parent, a pressed tab fills only its 40 px face and clears on release; a pressed selected tab keeps its indicator; Tab draws the ring on each tab in turn without moving it; a touch tap draws no ring; a touch tap after Tab clears the ring. Switch: Tab then Enter, Space and Enter toggles three times; Tab draws the ring outside the track without moving it; two touch taps toggle twice and draw no ring. The tests read real pixels through a new
pixelAttest helper, which returns the 32-bit ARGB value to compare with a theme colour'stoARGB32(); the coloured parent isbackgroundOrangeLight. Goldens, light and dark: tabs pressed, focused and focused selected; switch focused
0.56.0 CoreSheetHeader #
โจ Features #
- CoreSheetHeader: the library Sheet Header (Figma set
66335:151191) at the top of a bottom sheet. Back=On, for a later step: a back arrow, a title and an optional subtitle; tapping the arrow callsonBack, and the header pops nothing itself. Back=Off, for the first step: leave outonBack, and there is no arrow.style: CoreSheetHeaderStyle.metaLineis the Logs look, with a meta line under the title.showBottomLinedraws a 1 dplineLightline under the header for content that scrolls. The title istitleMediumSemiBoldintextHeadline, marked as a heading, and takes focus when the step opens. The subtitle istextBody: Body Medium with a back arrow, Body Small on the first step and for the meta line. Each line is cut with an ellipsis. The arrow is 24 dp intextLink, centred on the title line, with a 48 ร 48 dp tap area. The text has 4 dp above it and 8 dp under it; it starts at 48 dp with the arrow, 20 dp without, 16 dp for the meta line (CA-1238) - CoreSheetHeaderStyle:
standardandmetaLine(CA-1238) - Showcase: a Sheet Header screen in the example app, with the header also opened inside a
CoreQuickSheet, and a component doc
๐งช Tests #
- The arrow's tap, its 48 ร 48 dp tap area, its 24 dp size and its place on the title line; the title offset and 20 dp right inset; the height with and without a subtitle; Back=Off without an arrow, its 20 dp inset and small subtitle; the meta line's 16 dp sides; the bottom line only when asked; focus on the title when the step opens; a back arrow without a label is rejected; the one-line ellipsis; colours in both themes and text styles. A11y: tap target, label and text contrast guidelines in both themes, the arrow announced as a labelled button and the title as a heading. Goldens: light and dark, with every variant
0.55.0 Off-grid gaps move to the 4px spacing steps #
๐ง Fixes #
- CoreUnderlineTextField: every gap is a 4px step, as design decided for the whole library. 0.54.0 (CA-1323) already moved most gaps; this moves the rest. The label badge sits 4px after the label (was 5). The caret is 16px tall on regular and compact (was 17); it stays 2px wide, a line width. Compact's underline sits 8px under the value (was 6), so compact draws the same as regular, 53 high (was 51). The side inset and prefix gap stay 0, as 0.54.0 set them (CA-1238)
- CoreStatusBadge: the side padding is 11 dp inside the 1 dp outline (was 10), so the outline and the padding make the 12 dp Figma draws from the outer edge to the text. The neutral badge keeps 11 dp. The warning badge is 2 dp wider (CA-1238)
๐ Design notes #
- Design decided on 2026-10-25 to keep the library on the 4px grid: no off-grid spacing tokens. The local constants that waited on CA-1238 are gone; each user takes the nearest 4px step
๐งช Tests #
- Underline field caret height, label badge gap and compact height and underline gap; status badge width. Goldens: every underline field golden (light and dark) and the status badge (light and dark)
0.54.0 Text fields and calculator keyboard match the design library #
๐ง Fixes #
- CoreUnderlineTextField spacing: regular puts the value 4 px under the label (was 3) and the underline 8 px under the value (was 10), with a 4 px gap before the unit (was 5); a regular field is 53 high (was 54). Large uses 4 px and 8 px (were 6 and 6) and stays 66 high. The side inset and the prefix gap are 0 for every size (were 2), so the label, value and helper line start flush with the field. Compact is still regular with the underline 2 px closer: 4 / 6 / 4 px, 51 high (was 52) (CA-1323)
- CoreTextField: the floating label is Body Small Regular in
textDark(was Body Large Semibold inoutlineFocus), and the focus border isoutlineHover(light#003A54, wastextDark). With an error the floating label istextError, as the library Error state draws it. The helper icon and text sit on one row; the icon was above the text (CA-1323) - SingleItemSelector focus: Tab focus still shows the field's own focused look, which is now an
outlineHoverborder and atextDarklabel (was Text Dark border, Outline Focus label, from 0.45.0).CoreTextField.showsFocusdraws the same look (CA-1323) - CoreKeyboard keys: unit keys have 20 px corners (were 12). Number keys are Title Large Medium (were Regular); a
textStylepassed toCoreDigitInputstill wins. A pressed key keeps its shape and only shows the flash; unit keys no longer turn into a pill and the other keys no longer change to 16 px corners. Keys stay 56 high (CA-1323)
๐ Design notes #
The Figma Line field draws 12 px above the label. That space belongs to the form, as the component doc says, so the field does not add it.
๐งช Tests #
- Underline field offsets, heights, insets and gaps for each size; text field floating label style, its contrast on the fill in both themes, its error colour, the helper icon and text on one row, and focus border; unit key radius at rest and pressed, number key weight, and a pressed number key keeping its shape. Goldens: underline field (light and dark), value editor sheet, text field, keyboard and the keyboard button grid
0.53.0 Suggestion strip chips match the design library #
๐ง Fixes #
- CoreChipSize.large (the suggestion strip chips): the library Suggestion Strip Chip. 48 high with its 1 px border (was 46), 16 px at each side, also after a close icon (was 12 on the left, 20 on the right) and no shadow (was
CoreShadows.small). The label is Body Medium Regular intextDark(was Medium intextBody), 8 px before the value (was 4), and the whole value is heavy, not only the unit. Small, medium and mini chips keep their size padding (CA-1322) - CoreChip side padding: medium and mini chips had 12 px before the text and 20 px after it, because the label row added 8 px at its end on top of the padding. That 8 px is now only the gap before a close icon, so every size has the same space at both ends (CA-1322)
- Bind suggestion chip: the dashed outline is 1.5 px at rest (was 1),
CoreChipTheme.dashedStrokeWidth; focused it still thickens to 2. Its label, value and unit areoutlineFocus(weretextDark), as the library Bind chip draws them. The outlines of Deterministic (2 pxlineHighlight) and the other kinds (1 pxlineMid) already matched (CA-1322)
๐ฅ Breaking changes #
- Visual only: a large chip is 48 high (was 46), loses its shadow and changes its label and value styles, so any golden that shows a suggestion strip chip changes.
CoreChipThemeis internal (not exported fromripplearc_coreui.dart), so its new signatures,labelGap/dashedStrokeWidthand the removedshadow()affect no consumer.CoreChip.surfaceKeyis new, for test finders (CA-1322)
๐งช Tests #
- Large chip: 48 high, the label and value insets and gap, 16 px at both ends with a close icon, the dashed chip's
outlineFocustext, no shadow, and the label and value styles in both themes. The dashed outline's resting stroke. Every size has the same space at both ends of its text, left to right and right to left. Goldens: the chip component and outline sheets (light and dark), and every suggestion area golden. The outline and two-rows goldens grow a little to fit the wider and taller chips, and their mini and medium chips lose the extra 8 px after the text
0.52.0 Date filter chip keeps focus after a clear #
๐ง Fixes #
- CoreDateFilterChip: after the x clears the filter, focus moves to the inactive chip instead of being lost with the active pill. It moves whenever the caller rebuilds without a range after the ร, however late, not only in the same frame, unless another control has focus by then, so a later "Reset all" keeps its focus (CA-1322)
- CoreFilterChip: takes an optional
focusNode, so a parent can move focus to it (CA-1322)
๐งช Tests #
- Date chip: a tap on the x focuses the inactive chip once the caller rebuilds without a range; when the caller keeps the range, a later "Reset all" keeps its focus; Tab, Tab and Enter on the x also lands focus on the inactive chip. Filter chip: focus through
focusNode
0.51.0 Active date filter chip matches the design library #
๐ง Fixes #
- CoreDateFilterChip, in use: the library Chips Type=Tags With Remove. A 32 high
chipGreypill, radius 20, 12 px at the sides, the range in Body Medium RegulartextDark(was SemiBold) and a 20 px circled x iniconGrayMid, 8 px after the dates (the x's 48 px target overlaps the range by 6 px). The range and the x are separate 48 high targets. Tapping the range reopens the date sheet; only the x (CoreDateFilterChip.clearButtonKey) firesonClear. Before, a tap anywhere on the pill cleared the filter. Holding the range or the x shows the library Press look (pageBackgroundfill, 1 pxlineDarkOutlineborder). Tab focus on the range draws the pill border inoutlineFocusat 2 px; Tab focus on the x draws a 2 pxoutlineFocusring around the x inside the pill (CoreDateFilterChip.clearFocusRingKey) and leaves the pill border at rest, so the two stops look different. Nothing is drawn outside the pill, and the chip brings its ownMaterial, so it draws the same on any parent. The dates keep Figma's 6 px above and below them inside the pill, so at 200% text the pill grows around them instead of the dates spilling out of a 32 px pill (CA-1322) - CoreDateFilterChip, right to left: in a right-to-left app the ร sits at the start of the pill and the dates after it (CA-1322)
๐ฅ Breaking changes #
- Tapping the active pill no longer clears the filter; it reopens the date sheet. To clear, tap
CoreDateFilterChip.clearButtonKey. Callers and tests that tap the pill to clear must change (CA-1322)
โจ Features #
- CoreDateFilterChip:
rangeSemanticHint(default'Opens the date range sheet') is read after the range by screen readers (CA-1322) - CoreDateFilterChip:
pillKey, for widget-test finders (CA-1322)
๐ Design notes #
CoreInputChip is not changed, so email tokens keep their look; the date chip no longer uses it.
๐งช Tests #
- Date chip: a tap on the pill opens the sheet and does not clear, a tap on the x clears, and both targets are 48 high. In a right-to-left app the x is at the start. Tab focus on the range marks the pill only, then on the x marks the x ring only; the press look; no
Materialabove the pill; the x firesonClearon each of two taps; the dates stay inside the pill at 200% text. A11y: the range and the x announce as separate labelled buttons; Tab, Tab, Enter clears. Goldens: the date chip in light and dark and, new, range focused, x focused, pressed, on a white parent, and at 200% text
0.50.0 Filter chip matches the design library #
๐ง Fixes #
- CoreFilterChip: the library Filter chip. A 32 high pill on
pageBackgroundwith a 1 pxlineDarkOutlineborder, radius 20 and 12 px at the sides (was a greybackgroundGrayMidbox, 48 high, radius 12). The arrow is the Figma 10 dp wide drop-down intextDark: a 24 dp glyph (was 16 dp iniconDark). The 48 x 48 touch area stays. The inactiveCoreDateFilterChipuses it, so it changes too. A focused chip draws its pill border inoutlineFocusat 2 px, with no tint over the touch area. The chip brings its ownMaterial, so it draws the same on any parent. Pressed, the pill fillsbackgroundGrayMid, as the library List control chip does; the library draws no Press state for the Filter chip. The pill height is a minimum, so at 200% text the pill grows and the label is not cut (CA-1322) - Docs:
core_filter_chip.mddescribes the chip, its sizes and its pressed, focused and large-text looks (CA-1322)
๐งช Tests #
- Filter chip: the 32 high pill inside a 48 high touch area; Tab focus changes the pill border and keeps its size; the chip works with no
Materialabove it; Tab then Enter opens it; the press fill on two presses in a row; a 200% label fits in the pill. Goldens: the filter chip states and, new, the filter chip in dark, focused in light and dark, pressed in light and dark, at 200% text, and on a coloured parent; the date chip in light and dark
0.49.0 Toast and alerts match the design library #
๐ง Fixes #
- Toast.acknowledgement: 48 high, like the library Toast (was 50). The tick and
CoreShadows.floatingdo not change (CA-1321) - Toast alerts without a title: the library's Small alert. The surface is drawn 40 high (was about 70) with 12 px at the sides, and the text is Body Medium Medium (14 px, was 16). The close x keeps a 48 x 48 target (CA-1321)
- Toast close control: a plain
CoreIcons.crossiniconDark, labelledcloseLabelfor screen readers. The wordCloseand the circled x are gone. WithoutonClosethe x pops the current route, as before. The x takes keyboard focus (Tab, then Enter or Space). Pressed, it turnsbuttonPress; focused, it draws a 2 pxoutlineFocuscircle around the icon, with no tint over the 48 x 48 target. With a title, the text keeps the Large alert styles, and the icon and the x sit on the first title line, as the Large alert draws them (CA-1321)
๐ Design notes #
The library toast shadow has no token yet, so the acknowledgement keeps CoreShadows.floating. The light 'Saved to history' card (the receipt) is not changed here.
๐งช Tests #
- Acknowledgement height. Alerts: the plain x and its label, on a titled alert the x centred on the first title line, a tap at the corner of the x's target, the pressed colour on two presses in a row, Tab focus with its ring and Enter to close, a coloured parent with no
Material, the 40 px surface with a 48 px target, and the text styles with and without a title.CoreToasttests find the close button by key. Goldens: the toast sheet in light and, new, dark, without the debug banner; new, the pressed and the focused x in light and dark; the preference sheet's info card (light and dark) shows the plain x on its title line
0.48.0 App bar, tabs, segmented button and switch match the design library #
๐ง Fixes #
- CoreAppBar title: a
titleTextnext to aleadingwidget, or withimplyLeading: true, is Title Large Semibold (20 px), as the Figma "Back with Headline" bar draws it. Otherwise it stays Title Medium Semibold (18 px), as on the landing page bar. That bar is 48 high in total: passheight: CoreSpacing.space12and no vertical padding (CA-1320) - CoreTabs: Flutter's 16 px label padding is gone, so a tab is its own 12 px side padding around the label ('Tab 1' is 60 px wide, was 91). Each tab has a 4 px gap after it, also the last one, so the bottom line runs 4 px past the last tab. The indicator is sized to the tab so it stops short of the gap, has square ends (it had Material 3's round top corners) and sits inside the bottom of the 40 px tab. Each tab is drawn 40 px high at the bottom of a 48 px tap area (the tab row was 44 px), so screens with tabs move down 4 px. The bottom line is
lineDarkOutline(light#98A2B3); it was Flutter's default#CAC4D0(CA-1320) - CoreSelectButton: track padding and the gap between segments are 4 px (were 8), segment padding 16 px at the sides (was 20 x 8). The track is drawn 40 high (was 52) and a segment at least 32 with its label centred, whatever the text line height, inside a 48 high component: each segment is a tap target at least 48 x 48, including the 4 px above and below the track. A pressed segment fills
backgroundGrayMid(the library Press state) and Tab focus draws a 2 pxoutlineFocusborder inside the segment (7.2:1 on the light track, 13.9:1 on the dark one;lineHighlightwas 1.4:1); there is no tint over the touch area.CoreSelectButton.tapTargetKeyfinds a segment's target in tests (CA-1320) - CoreSelectButton docs:
core_select_button.mdgives the new track, padding and gaps, the pressed and focused looks and the 48 x 48 tap targets (it still described the old 8 px padding) (CA-1320) - CoreSwitch off knob: the knob has its own colour, separate from the border. Normal is
iconGrayMid(light#667085, dark#98A2B3), the same as its border, as design decided: a lighter knob was under 3:1 on the track and looked disabled. Lock isstatusError(light#F04438, was the#D92D20border red). Imperial and the borders do not change (CA-1320)
๐ Design notes #
The centred-title app bar has no Figma library type; ask design before using it on a new screen. A segment is drawn 32 px high, as the Figma library draws it, with the extra tap space around it in code, as the library asks for parts under 48 px.
๐งช Tests #
- App bar: title style with and without a leading widget and with
implyLeading, the 48 px back bar, and an a11y check that its back button keeps a 48 x 48 target in both themes. Tabs: divider colour, label padding, the gap between tabs, a square-ended indicator exactly as wide as the tab, and a 48 px tap area around the 40 px tab (a tap 1 px inside its top edge selects the tab). Segmented button: track and segment height and the gap, a 32 px segment with a taller text line, a 48 x 48 target for every segment in the scroll view, a tap just above the track, the press fill and the Tab focus border. Switch: off knob and border colour for each type. Goldens: the back-with-title app bar (light and dark), tabs, segmented button (and, new, focused and pressed) and switch (light and dark)
0.47.0 CorePreferencesSheet rows match the library Setting List #
๐ Fixes #
- CorePreferencesSheet rows: 12 dp padding on every side (was 16 dp at the sides), a 1 px Line Light line at the bottom of each row, and the label in Text Dark (was Text Headline). A text value is Body Medium Semibold (was Body Large Semibold). A read-only value (
isMuted) is Text Body (was Text Disable, which made a read-only setting look disabled). A row is 48 dp high with its bottom line inside it (was 49) and 12 dp between the label and the value (was 8). The press and focus looks now show: the ink sits above the grey row fill, which used to cover it, and a pressed row fills Background Blue Light, the library Pressed state. The switch row's pill matches the library Switch row: Body Small Regular text (was Body Medium Semibold), a 14 dp dot (was 8) 4 dp inside the border and 4 dp before the text (were 12 and 8), and 24 dp high (was 26), so a pill row is 48 dp like the others (was 50). The pill grows with large text (CA-1318) - CorePreferenceRow.isDisabled: the library Value row Disabled state. The label and the value are Text Disable and the row ignores taps (CA-1318)
๐ Design notes #
The row fill stays Background Grey Mid. Figma uses Background Grey Light, but in code that token is the same as the page colour, so the row would not show. The option sheet already matched and is unchanged.
๐งช Tests #
- Row height 48 with the bottom line, the 12 dp label-to-value gap, the ink inside the fill with a Blue Light highlight, label colour, a disabled row in Text Disable and inert; text value style, the read-only colour and the pill text style; the pill dot, gaps and height, a pill row 48 dp high, the pill growing with 2.0 text. The tests find the pill, its dot and the ink layer by key (
PreferenceValueView.pillKey,dotKey,PreferenceRowTile.inkLayerKey). Goldens regenerated, light and dark, now with a disabled row; new, a pressed row in light and dark
0.46.0 CoreCheckRowItem matches the library Dropdown cell #
๐ Fixes #
- CoreCheckRowItem: rows are 48 dp high with 12 dp padding on every side (were 72 dp, with 16 dp at the sides). A selected row is filled Background Blue Light with a 48 dp radius; it had no fill. The check box is a bare 24 dp icon 12 dp from the end edge (it sat in a 48 ร 48 box, 28 dp from the edge), and the whole row is still the 48 dp tap target. The name is Body Medium Regular (was Body Large), the default avatar initial is Text Headline (was Icon Orient) and the avatar sits 8 dp before the text (was 12). The row draws no pressed or hover tint, as the library Dropdown cell has no such state and
core_display_area.mdalready said; keyboard focus still shows. At large text sizes the avatar initial scales down to fit its 24 dp circle instead of being cut (CA-1318)
๐งช Tests #
- Row height, check box size and end inset, avatar inset and gap, selected fill and radius on both the Material and the InkWell, unselected row without fill, name style and initial colour, no pressed or hover tint, the initial inside the avatar at 200% text. Goldens regenerated, light and dark
0.45.0 Selection sheets match the library Dropdown list #
๐ Fixes #
- CoreMultiSelectSheet: the checked box was Flutter's default purple (
#6750a4), not a library colour. Rows now draw the library check box icon, 24 dp, in Icon Dark when checked and Icon Grey when not, with a Body Medium label in Text Headline (was Body Large), 12 dp padding and a 48 dp height. A checked row is filled Background Blue Light (backgroundBlueLight) with a 48 dp radius, as the library "Plain Selected" cell draws it. The search field isCoreSearchBoxwithCoreSearchBoxType.sheet(was an outlinedCoreTextField), and the title is Title Medium Semibold (was Body Large Semibold) (CA-1318) - SingleItemSelector: the field is the library
CoreTextFieldwith a chevron (was a plainOutlineInputBorderand a Material arrow), and the sheet title is Title Medium Semibold (was Headline Medium Semibold). With nothing selected the label sits above the field and the greyhintTextshows inside it, as the library empty Text Field draws it. Tab focus shows the field's own focused look (Text Dark border, Outline Focus label). A tap draws the ripple on top of the filled field, which used to hide it; the selector brings its ownMaterialfor it, found in tests bySingleItemSelector.inkLayerKey. A disabled selector dims its chevron (iconGrayLight) and tells screen readers it is disabled (CA-1318) - CoreTextField:
showsFocusdraws the focused border and label without taking focus, for a field that only shows a choice whose tap target holds the focus, such asSingleItemSelector.floatsLabelkeeps the label above the field so an empty field that never takes focus shows itshintText(CA-1318)
๐งช Tests #
- Multi-select: title style, Sheet search bar, row label style and 48 dp height, check box icon and colours, the Blue Light fill on a checked row. Goldens regenerated, light and dark, with and without the keyboard
- Single selector: Tab focus turns on the field's focused border and label, and Enter opens the sheet. A tap draws the ripple on top of the field; an empty field shows the hint; a disabled selector dims its chevron and reads as disabled. Goldens now in light and dark for the field states and the open sheet, unselected and selected, and, new, the focused field
0.44.0 CoreSearchBox matches the library Search Bar #
๐ Fixes #
- CoreSearchBox: draws the library Search Bar. It had no border and no search icon, and its fill matched the page, so the field could not be seen. It now has a 1 px Line Mid border (Outline Focus when focused), a search icon 8 dp before the text, a plain x clear icon in place of the circled one, and a Text Body hint (was Text Disable). Typed text is Text Headline (
textHeadline). A disabled field draws its icon iniconGrayLight. The clear x takes keyboard focus: Tab reaches it and Enter clears; pressed it turnsbuttonPress, focused it draws a 2 pxoutlineFocuscircle, with no tint over its 48 dp target. The box brings its own transparentMaterial, so it works on any parent (CA-1318) - CoreSearchBoxType:
pill(the default, for pages) has a pill radius, 24 dp icons in Icon Dark, Body Medium text and the xs shadow.sheet(for bottom sheets) has 12 dp corners, 20 dp icons in Icon Grey and Body Large text. The app's two search pages keep the default, so they get the Pill look with no change. The app's "Look up a rate" sheet (your_rates_lookup_sheet.dart) draws its own border around the box, so it moves tosheetwhen the app takes this version
๐ Migration #
- Inside a sheet, pass
type: CoreSearchBoxType.sheetand remove any outer border
๐ Design notes #
The ticket text gives the Pill a 12 dp gap between the search icon and the text. The Figma Pill node (345:9195) draws 8 dp, the same as the Sheet, so both use 8 dp.
๐งช Tests #
- Pill and Sheet icon sizes and colours, shadow, corner radius, border, focus border and hint colour. Typed text colour, the disabled icon colour, the clear x's press colour on two presses, Tab focus with its ring and Enter to clear, and a field with no
Materialabove it. Goldens: light and dark, both types in default, filled and disabled states, a disabled Pill with text, and the focused Pill; new, the focused Sheet and the pressed and focused clear x
0.43.0 CoreButton matches the design library #
๐ง Fixes #
- Primary pressed fill:
buttonPressis now Orient/700 (#006D8F) in the light theme, as the Figma library draws it. It was Orient/600 (#0089B4), on which white text reaches only 4.0:1. The dark theme is unchanged (CA-1319) - Primary and secondary focus: a focused primary or secondary button keeps its
buttonSurfacefill and draws a 3 pxoutlineFocusring 5 px outside the button, with a 2 px transparent gap. It used to switch to the hover colour, which looked the same as pressed. The ring does not change the button's size or its touch area.CoreButton.focusRingWidthandCoreButton.focusRingOffsethold the two values (CA-1319) - Large padding: 20 px on each side (
space5). It was 24 px (CA-1319) - Small text: Small buttons use Body Medium Semibold. Every size used Body Large Semibold (CA-1319)
- Social login button: the logo sits at the left edge, 20 px in, and the label is centred on its own. The label is inset 32 px on both sides (the 24 px logo plus the Figma 8 px gap), so it stays centred and at least 8 px from the logo; at large text sizes a long label ends in "โฆ" instead of running under the logo. The label is Body Large Medium (was Semibold), the side padding 20 px (was 24), the border 1 px
lineMid(was 2 px). Pressed, it fillsbackgroundGrayMidand keeps thelineMidborder (the border used to turnoutlineHover). Disabled, it has no fill, a 1 pxlineMidborder and atextDisablelabel (was a grey fill andtextBody). WithfullWidth: falseit is as wide as its content (CA-1319) - Social height: a social button is 48 px tall in any parent. It used to stretch to all the height its parent offered, for example 100 px in a
Center(CA-1319) - Small and Medium tap area: a Small (36 px) or Medium (40 px) button keeps its look and now sits in a 48 x 48 px tap area, so it takes 48 px of layout. Rows of Medium buttons, such as the display area value pills, sit 8 px taller (CA-1319)
- Large text: the button heights are minimums, so at 200% text a Small or Medium label grows the button instead of being cut (CA-1319)
- Test finder:
CoreButton.fillKeyfinds the button's fill and border in widget tests (CA-1319)
๐ Design notes #
The ticket and the Figma library give the pressed colour for the light theme only, so the dark buttonPress (orient200) stays. The primary and secondary buttons draw the focus ring; the social focus look is unchanged. A wider large button changes the Undo button of the toast and the large custom-child button by 8 px.
๐งช Tests #
- Pressed primary fill, focused primary fill and ring (position, width, none when unfocused), a focused secondary keeps its colours and draws the ring, a forced parent height still filling the button, Large padding, Small and Large label styles. A11y: contrast for the small primary and focused primary buttons in both themes, the focus ring keeps the 48 px touch area, and white text reaches 4.5:1 on the light pressed fill. Social: 48 px height, logo 20 px from the left edge, centred label, a long label 8 px clear of the logo at 200% text in a 328 px button, label style, 1 px border, pressed fill and border, disabled label colour, a narrow social button as wide as its content, a social button 48 px tall in a 300 px parent. Small and Medium: drawn 36 / 40 px inside a 48 px tap area that answers taps at its top and bottom edges; a Small label is not cut at 200% text. A forced parent height now also checks the fill height
- Goldens: new focused primary (light and dark), social pressed and social disabled (light and dark), social long label at 200% text. Updated: large, medium, small, custom child, social (Google and Apple, light and dark, pressed, disabled, 200% text), toast, colour tokens, and the display area goldens with Medium value pills
0.42.0 CoreStatusBadge and its colour, radius and icon size tokens #
โจ Features #
- CoreStatusBadge: a small pill that tags a value with its status, in three looks Figma draws: the 24 dp orange warning pill (optional 14 dp info icon), the 20 dp compact warning badge, and the 22 dp grey neutral tag.
variant(CoreStatusBadgeVariant.warning/neutral) andsize(CoreStatusBadgeSize.regular/compact) select the look, and an assert refuses the pairings Figma does not draw. The heights are minimums, so a badge grows with the user's text size. The label is passed in by the app and is cut with an ellipsis when it does not fit.onInfoTapwithinfoSemanticLabelturns the info icon into a labelled button, as the storyboard has it open the explanation of the tag; without them the icon is decorative (CA-1159) - AppColorsExtension.textWarningStrong (light
orange700#B03C00, darkorange200#F7B999): orange text that reaches 4.5:1 on the orange badge fills in both themes. The existingtextWarningreached only 3.98:1 in the light theme and 4.24:1 in the dark one (the orange text token that CA-1159 added) - AppColorsExtension.lineOrange (light
orange200, darkorange300): the orange outline of the warning badge - AppColorsExtension.textGrayMid (light
gray500, darkgray300): the grey text of the neutral tag. The dark value isgray300becausegray400reaches only 4.06:1 on the dark grey fill - CoreRadius (
radius6,radius8): corner radius tokens, exported from the package - CoreIconSize.size14: the 14 dp info icon size
- Showcase: a Status Badge screen in the example app and a component doc
๐ Design notes #
The 10 and 11 dp side padding and the 22 dp neutral height wait on CA-1238. The ticket text lists a "โ Your rate" variant. The storyboard has a cost saved as your default carry no badge, so it is not built. Figma also draws "Estimated" and "Your rate", but no screen uses them, so neither is built.
๐งช Tests #
- Badge, regular warning pill: label, height, width, padding, icon on and off, icon size and gap, fill, outline, radius, text style, light and dark colours, growth at a large text size, no overflow when squeezed, and the info tap (hit area, a tap in the right padding, labelled button, same size as the decorative icon). Compact and neutral looks: height, padding, fill, outline, radius and label colour. The asserts. A11y: one announced label, no actions on a decorative icon, a labelled button on a tappable one, the text contrast guideline, 3:1 icon contrast on the regular warning pill (the only look with an icon), and 4.5:1 label contrast for every variant and size in both themes. Goldens: light and dark with all four states
- Tokens: all three new colours in both themes, through
copyWithandlerp; 4.5:1 contrast oftextWarningStrongon both orange fills and oftextGrayMidon the grey fill, in each theme;CoreRadiusandCoreIconSize.size14values. The colour and icon size swatch goldens gain the new tokens
0.41.0 CoreUnderlineTextField #
โจ Features #
- CoreUnderlineTextField: a text field drawn as a label over a value with a single rule beneath it and no border, for the dense stacked forms of the "New material, labor or equipment cost" screens (CA-1158). A sibling of
CoreTextField, not a replacement. The underline islineDarkOutlineat rest andoutlineHoveron focus, 1px, andstatusErrorfor an error. It takes a placeholder (hintText), a controller orinitialValue, afocusNode,keyboardType,textInputAction,inputFormatters,maxLength(no counter),autofocus,onChanged,onSubmittedandonTap, and owns no user-facing string - CoreUnderlineTextFieldSize:
regular(12/16 label over a 16/24 value, 1px underline, 54px tall),compact(the same with the underline 2px closer to the value, 52px tall, for the fields of an open editor panel such as waste, burden, delivery and note) andlarge(14/20 label over a 24/32 semibold value, 2pxlineMidunderline, 66px tall) for a form that asks a single question - Prefix, suffix and unit:
prefixText($),suffixText(%) andunitText(days,/gal) are drawn by the field around the typed text, so an empty field still reads$with a caret, backspace can never delete it, and the controller holds only what the user typed. The value hugs its text when something follows it, and the prefix, value, suffix and unit share one text baseline as the design draws them - Slots:
labelTrailing(a badge beside the label, which keeps the field's height),inlineAccessory(a unit chip 12px after the value) andtrailing(a lookup button at the far end of the row). The row grows to fit a taller widget and centers the value against it - Helper and error lines:
helperTextdraws an info icon and a 12/16 line 8px under the underline, which adds 24px to the field.errorText(null or empty means no error) replaces it, turns the label, underline, icon and line to the error colors, keeps the underline red on focus, and is announced as a live region. The caller decides when to show it - States:
enabled: falsedims the field and stops focus and taps;readOnlykeeps the normal look and refuses edits;selectAllOnFocusselects the value so the first digit typed replaces it;showCursorturns the caret off for a value on an own number pad. The caret takes 2px of room only while it shows - Text size: the label row and the value row are minimum heights, so they grow with the user's text size and the label is never cut or drawn over the value
- Underline text field showcase screen in the example app and a component doc
๐ Design notes #
The focus underline is outlineHover (#003A54 in light mode), which is the value the design draws; outlineFocus is the caret. The disabled colors follow the Figma Text Field Line Disable variant. The design draws the % of a waste field as part of the value; the storyboard calls it a soft fixed suffix with no cursor, so suffixText is soft and a waste field passes showCursor: false. The placeholder is textDisable as drawn, about 2.5:1 on a white page, below the 4.5:1 WCAG asks of text; it is the token CoreTextField already uses for its hint. The text field's accessibility node is 48px tall though the value row is drawn 24px or 32px tall, so the field meets the minimum tap target without changing the design's spacing.
๐งช Tests #
- Content, sizes and offsets against the design's numbers, growth at a large text size, colors in both themes, underline rest and focus, tap-to-focus on the label and underline, a replaced focus node, prefix, suffix, unit, hugging, slots, helper and error lines, disabled and read-only, select-all on focus,
onTap, and caret room - A11y: tap target, label and contrast in both themes for all three sizes, the announced label and value, error as a live region, disabled and read-only flags, and a 48px accessibility node
- Goldens in light and dark: rest, focused (12 states), affixes and slots, compact, helper and error lines, and disabled and read-only
0.40.0 CoreNumberKeypad #
โจ Features #
- CoreNumberKeypad: the app's own number pad for a plain number field. Four rows of pill keys (
7 8 9,4 5 6,1 2 3,. 0 โซ) and, under them, an outlined put-back button and a filled confirm button whose labels the caller sets (ClearorBack to 10%, andAdd to estimate). Each key and button has its own callback (onDigitPressedwith the digit,onDecimalPressed,onBackspacePressed,onClearPressed,onConfirmPressed), so the keypad knows nothing about the field.isConfirmEnabledgreys out the confirm button.CoreNumberKeypad.height(368 dp) is there for a sheet that reserves room for the keypad (CA-1253) - CoreDigitInput.textStyle replaces the label style, which by default is
titleLargeRegularscaled to the key's height. The colour staystextHeadline - CoreControlButton.isNeutral draws the key on the digits' grey with a dark grey face, so it does not compete with a filled button beside it
- Number keypad showcase: a value typed with the keypad, cleared and added
๐ Design notes #
Built from the storyboard's number pad (CUJ 4 "Keys up", cuj456_screen.css .kbd), which is newer than Figma and has no Figma variant yet. Keys are 68 dp tall with 4 dp gaps and a 16 dp side inset, and the buttons sit 16 dp below the keys. The backspace key is grey like the digits, not the calculator's dark blue, so the confirm button is the only filled key (storyboard, approved by the owner 2026-10-03). The ticket and Figma show it dark blue. The digits use titleLargeMedium (20 dp), not the calculator's height-scaled 23.8 dp. The keys reuse the calculator's CoreDigitInput and CoreControlButton, so they press and give haptic feedback the same way.
๐งช Tests #
- Keypad: each digit, the decimal point, backspace, both buttons, a disabled confirm button that ignores taps and reads disabled while the other keys still work, the key order, 124 x 68 keys and 188 x 68 buttons on a 412 dp phone, narrower keys on a 320 dp phone, and no overflow at 200 % text with a long put-back label. Keys:
textStylereplaces the scaled style and keeps the colour, the default still scales,isNeutralcolours in both themes, and delete stays dark blue without it. A11y: tap target, label and contrast guidelines in both themes, confirm enabled and disabled. Goldens: light and dark
0.39.0 CoreDetailsRow #
โจ Features #
- CoreDetailsRow: a rounded grey row that folds a detail of a form away โ a label, a bold value, an optional link-style action after a dot, and a chevron. A tap anywhere on the row but the action calls
onToggle; whileexpanded,childshows under the row inside the same card. The caller ownsexpanded, so the action can open the row too.actionLabelandonActioncome together (asserted). It replaces the Delivery row the app draws by hand in the equipment form (CA-1252) - Details row showcase: a Delivery row with an action and a Waste row without one
๐ Design notes #
Built from the storyboard's .mod / .modx (cuj456_screen.css) and the Figma "Details Row" set 65708:169539: a 48 dp row, 12 dp corners, a 1 dp lineLight edge on backgroundGrayLight. The label starts 16 dp in, as in Figma; the chevron's 48 dp square ends at the card's edge, which centres the icon 24 dp in, as in the storyboard. The dot sits in an 18 dp slot (Figma's 10 dp box with 4 dp each side). The whole row is the toggle's tap zone; the action's zone is at least 48 dp wide. The storyboard's Estimated tag on a folded row (round 18, Q33) is not part of this row yet.
๐งช Tests #
- Row: label and value in one line, the action after a dot and no dot without one, a tap on the value, the chevron or the empty middle toggles, the dot's 18 dp slot, a tap on the action calls
onActionand does not toggle, the panel hidden while folded and under the row while expanded, the chevron's turn, a 48 dp row with the chevron 24 dp in, a long value that ends in an ellipsis and keeps the action, the action assert, and the toggle and action semantics with the expanded state. A11y: tap target, label and contrast guidelines folded and expanded in both themes; each text colour holds 4.5:1 and the chevron 3:1 on the card. Goldens: light and dark
0.38.0 CoreOutlinedIconButton #
โจ Features #
- CoreOutlinedIconButton: a square icon button, a 36 dp box with a 1 dp
lineMidedge, 8 dp corners and a 20 dpiconGrayMidicon, centred in a 48 dp square that takes the taps. It replaces the look-up button the app draws by hand beside the Rate and Amount fields of the equipment form.icon,onTapandsemanticLabelare required: the button has no visible text, so the label is its only name (CA-1252) - Button showcase: the look-up button
๐ Design notes #
Built from the storyboard's .iconbtn (cuj456_screen.css): 36 dp, 8 dp corners (CoreSpacing.space2), a 1 dp --line-mid edge and a 20 dp magnifier. The box has no fill, so it takes the colour of the sheet under it. The button takes 48 ร 48 dp of layout, so a row that holds it is at least 48 dp tall.
๐งช Tests #
- Button: the icon's size and colour, the 36 dp box with its edge and corners, the 48 dp tap square, a tap on the box and a tap on the margin each call
onTaponce, and one button node named by the label. A11y: tap target, label and contrast guidelines in both themes; the icon holds 3:1 on the page in both themes. Goldens: light and dark
0.37.0 CoreListRow.action #
โจ Features #
- CoreListRow.action: a leading
iconand atitle, the icon iniconDarkand the title intextLinkatbodyLargeSemiBold(16 sp, as Figma's Action row), e.g. "+ New equipment cost" under a list of recent rates. The icon sits in the same 20 dp slot as.selectable's check, so its title lines up with every selectable row's (the plain row has no slot). Takes no subtitle or value, andonTapis required (CA-1204) - List row showcase: the action row under the plain list
๐งช Tests #
- Action: the icon in
iconDark, the title in the link colour at 16 sp, the title at the same x as a selectable row's, tap, and a screen reader hears a button with no selected state. A11y: tap target and label guidelines in both themes. Goldens: light and dark gain the action row
0.36.0 CoreListRow.selectable #
โจ Features #
- CoreListRow.selectable: a row in a pick-one list. It keeps a 20 dp check slot even when unselected, so rows don't shift when the pick moves. A selected row fills
backgroundBlueLight, turns its titletextLink, shows the check and reports its selected state to a screen reader (CA-1204) - List row showcase: a pick-one list from the Equipment "Look up a rate" screen
๐ Design notes #
Built from the storyboard's Equipment "Look up a rate" frame (cuj6-equip-4-lookup). It shares the plain row's geometry.
๐งช Tests #
- Selectable: the empty check slot keeps its width so selected and unselected titles start at the same x, the selected fill, check and title colour, and the selected state, picked or not. A11y: a selected row meets the tap target and label guidelines in both themes, and every text colour holds 4.5:1 on the selected fill in both themes. Goldens: light and dark gain selected and unselected rows
0.35.0 CoreListRow #
โจ Features #
- CoreListRow: a tappable list row with a title, an optional subtitle under it, and an optional value at the end (
valueplus a smallerunit, e.g.$145.00 /day). The row pads its content byCoreSpacing.space2and is at least 48 dp tall; the list around it supplies the page inset. The default screen-reader label is the visible texts in order, orsemanticLabel. The value takes at most half the row and shrinks rather than overflow at large text sizes; the title wraps (CA-1204) - List row showcase: plain rows from the Equipment rate screens
๐ Design notes #
Built from the storyboard's Equipment "Your recents" frame (cuj6-equip-1-recents), which the app built as one-off rows in CA-1151. The 2 dp gap between title and subtitle is the storyboard's; CoreSpacing has no step that small.
๐งช Tests #
- Row: texts, no leading slot and no fill on a plain row, a unit without a value is dropped from the row and its screen-reader label, an empty subtitle is left out of the label, tap, 48 dp minimum height, default and custom screen-reader labels with the tap action kept, and a wide value at 200 % text on a 320 dp row shrinks instead of overflowing. A11y: tap target and label guidelines in both themes, and every text colour at 4.5:1 on the page in both themes. Goldens: light and dark
0.34.0 The acknowledgement toast #
โจ Features #
- Toast.acknowledgement: the dark toast that reports a finished task โ "Added to Bedroom 2". A 24 dp
statusSuccesscircle with a 15.6 dp wide white tick (65 % of the circle) and one line ofbodyMediumSemiBoldtext onbackgroundDarkGray, with a 12 dp corner radius and the newCoreShadows.floating. It has no action and no close button, and it is a live region, so a screen reader reads it when it appears (Figma component65687:157849, CA-1256) - CoreToast.showAcknowledgement: shows it in the overlay and removes it after
duration, 4 s by default - CoreShadows.floating (0/8/24,
CoreShadowColors.shadowGrey28): the shadow that lifts a dark surface off the page - Toast showcase: an acknowledgement preview and a button that shows a live one
๐ Design notes #
In the dark theme Figma's Background/Dark Grey and Text/Inverse both resolve to gray900, the dark page colour, so the toast would vanish. The dark theme draws it on backgroundGrayMid with textHeadline text, and the tick turns dark (textInverse): white on the dark theme's green400 is 2.3:1, under the 3:1 a graphic needs. The padding and gap use the nearest CoreSpacing steps (12/16, 12) instead of 13/15 and 11, and a 50 dp minimum height keeps the frame's 384ร50.
๐งช Tests #
- Widget: the acknowledgement shows its message with no close button and nothing to tap, announces the message once as a live region, stands off the page in both themes, and keeps its tick at 3:1 against the circle in both themes. A11y: it meets the guidelines in both themes. CoreToast:
showAcknowledgementshows no close button and leaves after 4 s, or after thedurationit is given. Golden:toast_componentgains the acknowledgement
0.33.1 Light success green matches Figma #
๐ Fixes #
- CoreStatusColors.success and CoreIconColors.green (light theme) are green500 (
#009E69), not green600. Figma drawsState Color/SuccessandIcon Color/Greenas Green/500, and the dark values already matched. These two tokens draw graphics only (a tick, a switch track, an icon), where green500 on white is 3.4:1 against the 3:1 a graphic needs (CA-1256). One use falls short: the light success toast draws its tick onalertGreen(green100), which is 2.75:1 (it was 4.06:1). The tokens still follow Figma - CoreFunctionKeyBottomSheet: the
Imperiallabel is text, so it usestextSuccess(green600, 4.5:1 or better on white) instead oficonGreen, which would fail 4.5:1 now. Its colour does not change CoreCheckRowItemdocs and showcase: the avatar initials usetextSuccessfor the same reason- CoreAvatar centres its child. The fixed-size
Containerhad noalignment, so it stretched aTextchild to the full circle and drew the letter at the top left; every defaultCoreCheckRowItemavatar showed this. A child that centred itself, such as an icon, does not move
๐งช Tests #
- Goldens regenerated where the light green shows: color tokens, avatar, check row item, function key sheet, preferences sheet, switch and toast
- The check row golden draws the initials in
textSuccess, as the docs say, and its light and dark goldens are regenerated for the centred letter
0.33.0 The empty estimate summary card, and long names #
โจ Features #
- CoreEstimateSummaryCard.empty (
title,note): the card before the line can total. It has four parts instead of five: the caption, a dash in place of the amount (CoreEstimateSummaryCard.emptyAmount), the rule, and the note naming the missing field, e.g. "Needs a rate before it can total" (storyboard "Unpriced state", CA-1255). A screen reader skips the dash and reads the note - CoreEstimateSummaryCard fits long text. A long estimate name ellipsises first, so "total $2,993.62 โ" stays whole. The new total takes at most half the row, and the before text at most 70 % of what is left, and both shrink to fit instead of clipping. The line total shrinks to its 40 dp slot the same way
- Estimate summary card showcase: the empty card
๐งช Tests #
- Widget: the empty card shows the dash and the note and no totals, and is 117 dp tall (four parts). A long name ellipsises while the before text and the new total stay whole, with the new total against the right padding. On a 200 dp card the amounts shrink to one line inside the padding. A11y: every text on the empty card is at least 4.5:1 on the fill in both themes, and the empty card reads the note but not the dash. Goldens:
core_estimate_summary_cardgains a long name and the empty card
0.32.0 The estimate summary card #
โจ Features #
- CoreEstimateSummaryCard: the "Adds to this estimate" card above a cost form's Add button (Figma "Estimate Change"
66335:151611, used by the material, labor and equipment forms, CA-1255). It shows the caption, the line total in 32/40 semibold with -0.32 letter spacing, an optional extra charge, a rule, then the estimate's name and its total before the change on the left and the new total on the right. Every string arrives formatted and localised. The card is 125 dp tall without an extra charge, as in the frame: radius 14, padding 13/15/12/15 and a 1 dp gap between rows, onbackgroundBlueLight. It is one live region, so a screen reader reads the new totals as the user types - CoreEstimateSummaryCharge (
label,amount): the "incl. delivery +$85.00" row, a 24 dp row under the amount - lineBlue (
CoreBorderColors,CoreDarkBorderColors,AppColorsExtension): the rule on abackgroundBlueLightpanel. Light is Figma'sBoarder Color/Line Blue#C7ECFA, which sits between blue50 and blue100 and has no palette step. Dark is blue800, one step lighter than the dark panel's blue900. The storyboard asks for the rule to be coloured from the panel, not from the grey used on white - Estimate summary card showcase: the card with and without an extra charge
๐ Design notes #
Figma draws the "Bedroom 2 total $2,993.62 โ" text in textDisable, which is 2.4:1 on the blue fill in light and 2.6:1 in dark, under WCAG's 4.5:1. The card uses textBody (7.2:1 and 8.9:1) instead. The padding, radius and gaps are Figma's own numbers, because none of them is a CoreSpacing step.
๐งช Tests #
- Widget: the card shows every string, is 125 dp tall without a charge and 150 with one, puts the charge under the amount and the new total against the right padding, and draws the amount at 32 with -0.32 spacing. In both themes it uses the blue fill, radius 14, a
lineBluerule andtextBodyfor the before text. A11y: every text on the card is at least 4.5:1 on the fill in both themes, checked one text at a time because the merged node lets Flutter's contrast guideline pass any grey; the card is one live region that reads the caption, the amount, the charge and the new total. Theme:lineBluein light and dark. Goldens:core_estimate_summary_cardlight and dark, and the colour token sheets gainlineBlue
0.30.0 CoreCalculatorChip inert state and the stale answer #
โจ Features #
- CoreCalculatorChip.inert (default
false): dims the chip toCoreCalculatorChipTheme.inertOpacity, makes it ignoreonTapandonLongPressand reports it disabled to a screen reader, while keeping the look of itstypeโ aร5keeps its operator and an answer keeps its label. The chips before an open bracket, and the chips after a reopened one, wait like this until the bracket closes (UX design doc term 2.22, Section 7 "Editing a bracket", walkthrough 12.8). Unlikedisabledit is a state over any type, not a look of its own (CA-1189) - CoreCalculatorChipType.stale: an answer that is out of date because a chip before it is being edited. The
resultfill under a dashedlineDarkOutlineedge (prototype.t-stale), showingCoreCalculatorChip.stalePlaceholder(โ) in place of a number so no out-of-date figure can be read; the label stays, so it readsCalc โ. Takes novalue(asserted) and stays interactive unlessinert. The dash marks a chip that is unfinished (prototype decision Q3), and dashes grey rather than teal because nothing is being typed into it. The placeholder is punctuation a screen reader skips, which would leave "Calc" and no sign that the answer is pending, so a stale chip requiressemanticsLabel("Calc, pending"; asserted) - CoreCalculatorChipTheme.factorColor takes
inert(defaultfalse): an inert chip draws its factor in the colour of its text, so the operator before a waitingร5stays as readable as the number - CoreCalculatorChip.effectiveOpacity exposes the opacity the chip is drawn at, for tests
- Calculator chip showcase: the bracket section becomes the three tapes of walkthroughs 12.6 and 12.8 โ an open bracket with the
2waiting, the closed bracket with itsCalc 70, and the reopened bracket withร5waiting andCalc โ
๐ Design notes #
The prototype dims a waiting chip to 55 % (.t-frozen), which drops the typed teal to 2.7:1 against the page. inertOpacity is 70 %, which keeps every variant's text and factor at or above the 3:1 floor WCAG 1.4.11 sets for user-interface components in both themes โ a test composites all nine variants' value, label and factor over their fills at that opacity and asserts the ratio; WCAG 1.4.3 exempts an inactive control from the 4.5:1 text floor, and an inert chip reports itself disabled so the automated contrast guideline treats it as one. The factor holds the floor because an inert chip draws it in the text colour: the light theme's iconOrient and iconRed sit between 3.5:1 and 4:1 on their fills and would fall to 2.4โ2.8:1 at 70 %. The teal edge of the typed variants holds 3:1 against the page and the fill as well; the grey and red hairlines of the filled variants are outside the floor, at 1.2โ2.3:1 on their fills before any dim. The 70 % against the prototype's 55 % is open with design, recorded on CA-1189.
๐งช Tests #
- Chip: an inert chip keeps its text and factor, ignores tap and long-press, and is drawn at
inertOpacitywhile a live chip is not; inert over a result keeps its label. TheOpacitythe chip builds carrieseffectiveOpacity, inert and live, and an inert chip's factor takes the text colour. A stale answer reads its label and the placeholder and never a number, announces the caller'ssemanticsLabel, refuses avalue, refuses to be left without asemanticsLabel, and stays interactive unless inert. Theme: the stale tokens in light and dark; the dashed outline resolves fordashed,bracketOpenandstaleonly. A11y: stale meets text contrast in both themes; an inert chip reportsisEnabledfalse with no tap or long-press action; an inert tape passes the guidelines in both themes; and for all nine types in both themes the dimmed value, label and factor composited over the dimmed fill keep at least 3:1, as does the teal edge of the four typed variants against the page and the fill. Goldens: light and dark gainStale,InertandStale + inertcells
0.29.0 CoreCalculatorChip bracket looks #
โจ Features #
- CoreCalculatorChip: two bracket variants for the one chip that holds a whole bracket (UX design doc term 2.22, Section 7, walkthroughs 12.6 and 12.8).
CoreCalculatorChipType.bracketOpenis the bracket still being typed into: theactivegreen under a dashed teal edge, drawn without its closing bracket.CoreCalculatorChipType.bracketClosedis the same chip once closed: solid teal onbackgroundBlueMid, with its closing bracket, and a tap on it is how the bracket reopens. The chip draws the brackets itself โvalueis the text inside them, so3ร4reads(3ร4while open and(3ร4)once closed and the missing bracket can never disagree with the type;displayedValueexposes the drawn text. The operator before the bracket is thefactor, as on every other chip. A closed bracket requires avalue(asserted): the calculator removes an empty bracket rather than draw one (CA-1189) - CoreCalculatorChip.semanticsLabel replaces the screen-reader label built from
labeland the drawn value, andtapSemanticLabelis the tap hint ("double tap to โฆ"), which requiresonTapaslongPressSemanticLabelrequiresonLongPress. A bracket's state is punctuation a screen reader skips, so the app says it in words โ "open bracket, 3 times 4", and "reopen the bracket" on the closed chip. Both are localised by the caller - CoreCalculatorChipTheme.isDashed and
edgeColor: one place decides which variants dash and what colour their edge is;borderColor(transparent when dashed) anddashedOutlineboth read them, so a variant can no longer be solid and dashed at once, or neither - Calculator chip showcase: a Bracket section with the open and the closed chip
๐ Fixes #
- CoreCalculatorChip: a chip with a value but no factor and no label drew the
space1gap meant to separate the value from what precedes it, so its value sat 4 dp off-centre โ visible on theDimension errorcell and on a bracket that starts a chain. The gap is drawn only when a factor or a label precedes the value; the two error cells in the chip goldens shift by 4 dp
๐ Design notes #
The bracket chips follow the prototype (.t-group / .t-group-open); there is no Figma variant. The open fill is the prototype's #cffce4 exactly (backgroundGreenMid); the closed fill is the nearest token to its #d6eeff (backgroundBlueMid, #dcf5ff). Both sit flat like the other filled chips โ the prototype draws no shadows โ and keep the 1 px edge every variant shares against the prototype's 1.5 px.
๐งช Tests #
- Chip: an open bracket draws
(3ร4and nothing ending in), a closed one(3ร4), a bracket just opened reads(; the semantics label reads the bracketed text; a tap on a closed bracket reachesonTap; long-press fires on both. Theme: both variants' tokens in light and dark; the dashed outline resolves fordashedandbracketOpenonly. A11y: both variants meet text contrast in both themes. Goldens: light and dark gain the two bracket cells
0.28.0 CoreKeyboard bracket key #
โจ Features #
- CoreKeyboard: the bottom-left key is the
( )bracket key,ControlAction.paren, in the place the โฎ control held. It reaches the consumer throughonControlActionlike the other controls and carries the stable test keycalc_key_paren. The key is a toggle the tape reads, not the key: its face never changes, the first press opens a bracket and the next press closes it (UX design doc 1.3 and key card 3.6).parenEnabled(defaulttrue) dims the key, drops its tap action and reports it disabled to a screen reader, so the value editor can keep a bracket out of a single number โCoreValueEditorSheetpassesfalse(CA-1189) - CoreControlButton:
enabled(defaulttrue) is the same switch on a control built on its own; a disabled control announces no hint, and disabling it while a finger is down releases the press without firing.ControlActionX.labelis the text face of a control (( )for the bracket key,nullfor the icon controls) andControlActionX.iconreturnsnullfor the bracket key - CoreKeyboard.parenSemanticLabel and
parenSemanticHintreplace the bracket key's English screen-reader label and hint with the app's localised strings. CoreControlButton.semanticLabel andsemanticHintdo the same for a control built on its own, and CoreValueEditorSheet.parenSemanticLabel (also onshowandshowSingleValue) names the key the editor keeps disabled. All are optional: left out, the key announces the EnglishBracket buttonthe way the other keys announce theirs - Keyboard showcase: a switch above the keyboard disables the bracket key the way the value editor does, and the bracket key takes its screen-reader label and hint from the showcase
โ ๏ธ Breaking change #
- ControlAction gains
paren, so an exhaustiveswitchover it no longer compiles until it handles the new case โ the calculator bloc'smoreOptionsarm did nothing, and the bracket handler is its replacement. CoreKeyboard no longer renders the โฎ control and never sendsControlAction.moreOptions; the value stays, deprecated, so an existingmoreOptionsarm keeps compiling, and its removal is tracked by CA-1197
๐งช Tests #
- Keyboard: the bracket key sits left of the zero key, sends
parenon every press and keeps its face;parenEnabled: falsesilences the bracket key and no other; themoreOptionskey is gone. Control button: the( )face, the semantics label and hint, a disabled control ignores taps and carries no tap action. Value editor: the bracket key is disabled. A caller'ssemanticLabelandsemanticHintreplace the English defaults on a control, the keyboard and both value editors, and the hint stays withheld while disabled. A11y: the bracket key meets the tap-target and label guidelines in both themes, enabled, disabled and labelled by the caller. Goldens: the keyboard and value-editor goldens change at the bottom-left key only; the buttons grid adds an enabled and a disabled bracket key
0.27.0 Receipt toast and display-area session restore #
โจ Features #
- Toast.receipt: the self-dismissing confirmation the calculator shows when a session is banked โ "Saved to history ยท Calc 60ftยฒ" with
Undo. One line of text rather than a stacked title and description, an outlinedbackgroundBlueLightsurface with aspace3radius and no shadow, and an action instead of a close button.descriptionis the lead andhighlightthe tail after a middot;onActionfires at most once and cancels the auto-dismiss;onCloseis required, because it is the only way a receipt leaves the screen.durationdefaults to 5 s andnullholds the toast until something else removes it (CA-1042)- The action is a 48 dp
CoreButtonSize.largepill rather than the ~29 dp the design draws, because a tap target under 48 dp is an accessibility defect; the frame is open with design - The receipt announces itself as a live region, and it does not start its timer while
MediaQuery.accessibleNavigationOfis true โ it carries no close button, so a timed window a screen-reader user cannot reach in time is worse than no window - A long translated action label ellipsises itself instead of squeezing the message: the action may take 60% of the width it shares with the message, which leaves the message the other 40%
- The action is a 48 dp
- Toast.receipt:
secondaryLabel/onSecondaryadd the quieter second action (View) besideUndo. The two travel together โ asserted in the factory and checked again at build, because an assert is gone in release and a control a screen reader cannot announce is worse than none. Either action answers the toast: whichever is tapped first reports, cancels the auto-dismiss and dismisses, and the other is locked out.Viewis anInkWellwith its ink turned off, so the whole 48 dp box answers a tap and keyboard, D-pad and switch users can reach it; it renders inbodyLargeSemiBoldat 85 % oftextLink(CA-1042) - CoreDisplayArea:
onPreviousSessionTapped(String id)reports a tap on a previous-session card so the consumer can restore that tape, withrestoreSemanticsLabelnaming the control for a screen reader โ asserted non-null whenever the callback is given.CoreHistorySessionData.idis the new optional identifier; a session without one, or with an empty one, stays the plain card older callers already pass. Ids must be unique acrosspreviousSessions. The card is anInkWellwith its ink suppressed but its focus highlight kept, so keyboard, D-pad and switch users can reach it, and its contents sit under anIgnorePointer, anExcludeFocusand aMergeSemantics, so a chip in a past session is inert to touch, to the keyboard and to a screen reader alike โ it can neither win the gesture arena, nor stay a tab stop, nor sit in the tree as an enabled button that answers nothing (CA-1042) - CoreToast.showReceipt: puts a receipt in the overlay and wires its dismissal to that entry. The widget owns the timer and
CoreToaststarts none of its own, so the 5 s window is never cut short by the 3 s default the other toasts use;disableTimers()andcleanup()behave as they do for every other toast.showError,showSuccessandshowWarningkeep their 3 sCoreToasttimer (CA-1042)CoreToast.showCustomToasttakes a nullableduration: anullleaves the entry up until something else removes it, for a toast that owns its own dismissal. The 3 s default is unchanged, so every existing call behaves as before
- Showcases: the display-area demo answers a restore tap with
CoreToast.showReceiptnaming the session that came back, so the tappable card and the receipt โ the two halves of CA-1042 โ demo together instead of echoing through a MaterialSnackBar(CA-1042)
โ ๏ธ Behaviour change #
- Toast: an untitled toast is announced once instead of twice. Its semantics label is the title alone, and the description reaches the screen reader through the text it labels; before, an untitled toast used its description as the node label as well, so the description was read out and then read again (CA-1042)
- Toast.receipt: the second action renders at 85 % of
textLinkrather than the design's 75 %. At 75 % it composites to#3C839Don the receipt surface โ 4.02:1, under the 4.5:1 WCAG AA floor โ and the component's own contrast guideline fails on it. Open with design - CoreToast: every overlay removal now goes through one idempotent path, and each
onCloseand timer carries the entry it was built with rather than reading whichever entry is current. Two defects go with it. Two toasts shown in the same frame left the first orphaned in the overlay, because an entry inserted in that same frame has not mounted yet and the oldmountedcheck skipped it. Andcleanup()followed by a new toast threw "An OverlayEntry should be removed only once" in debug builds, becausecleanup()removed the entry but left it in_entryfor the next call to remove again. A close tapped on a toast that has already been replaced is now ignored instead of taking the replacement off the screen (CA-1042)
0.26.0 CorePreferencesSheet and CorePreferenceOptionSheet #
โจ Features #
- CorePreferencesSheet: a bottom sheet body listing settings grouped into
CorePreferenceSections, each row showing its label and current value and opening a single-choice sub-sheet (CA-1041). The sheet holds no persistent state โ it reports throughonChanged(key, optionId)and the caller re-suppliessections, so the stored preference stays the single source of truthCorePreferenceValueis sealed with two variants, because the rows do not all read the same way:CorePreferenceTextValue(label, isMuted:)renderstextLinktext (ortextDisablewhen the preference is still a stub) andCorePreferencePillValue(label, isOn:)renders an outlined pill with a green or grey state dot, asSystem of unitsandThousands separatordoinitialKeydeep-links to one row: it is scrolled into view before the first frame the user sees and marked forCorePreferencesSheet.emphasisDuration, the path a tapped fraction in a result takes to Fractional resolution. An unknown key opens the list at the top- A row with fewer than two options is inert โ it renders its value and opens nothing
- CorePreferenceOptionSheet: the single-choice sub-sheet. Selection is local until the user taps Update, at which point
onUpdatereceives the chosen id and the sheet pops itself, so backing out of a setting leaves it unchanged. Update stays disabled until the pick matches one ofoptions, so aselectedOptionIdleft over after the option set changed shows no ticked row and cannot be committedCorePreferenceInfo { title, description, semanticsLabel, closeLabel }on a row adds an info button to the sub-sheet's header; opening it replaces the Update button with aToast.info. The footer holds the taller of the two states, so the explanation does not grow the sheet under the thumb that opened it โ a row carrying an explanation reserves that height from the start, a row without one stays as tight as the button (Figma62481:80137and62481:80158are the same 354px container). The four fields travel as one object rather than loose optional parameters, so the button cannot be configured without its labels โ an interactive control with no semantics label is invisible to a screen reader (RULE 14)
- CorePreferencesSheet forwards
optionKeyOfandoptionUpdateButtonKeyto the sub-sheet, so a consumer can drive open-row โ pick โ commit entirely by key rather than by matching option labels as text (RULE 8) - The five preference model types (
CorePreferenceRow,CorePreferenceSection,CorePreferenceOption,CorePreferenceInfoand bothCorePreferenceValuevariants) compare by value, so two equal-by-value instances are equal and hash alike. Lists compare element-wise, so a row is judged by the options it holds rather than by which list instance holds them - Showcase: the calculator's display preferences (UX design doc, Appendix C) with deep-link buttons to Fractional resolution and to the last row
๐ Design notes #
Built to Figma 62481:79132 ("Settings page"), which differs from the ticket's
description: rows carry no chevron, the option sheet marks its choice with a
check rather than a radio, and a choice is committed with a sticky Update
button. The deep-link mark has no design of its own. The option sheet's back
button uses CoreIcons.arrowLeft, as the design system has no chevron icon.
๐งช Tests #
- Widget: an option reports nothing until Update commits it; a
selectedOptionIdmatching no option cannot be committed; a pick the user made survives the same preference changing elsewhere, including when they land back on the value the sheet opened with; back leaves the preference untouched; the info button swaps Update for the explanation without changing the sheet's height, and needs both a title and a description; Update is disabled with nothing selected, commits the pick and dismisses the sheet, and stays disabled for a sheet opened on an id matching no option;initialKeylands on a row the fixture proves starts off-screen; an unknown key opens the list; the sheet does not update its own rows; a single-option row opens nothing - A11y: rows, the back button, the info button, option rows and Update all meet tap target, label and contrast guidelines in light and dark; an option row is announced as a button and as selected, and the decorative tick is excluded from semantics so it is not announced twice
- Goldens:
core_preferences_sheet_{light,dark}.pngandcore_preference_option_sheet_{,info_}{light,dark}.png
0.25.0 CoreValueEditorSheet gains a single-value mode #
โจ New #
- CoreValueEditorSheet:
CoreValueEditorSheet.singleValue/showSingleValueedit one labelled value with an optional unit โ the sheet the calculator opens behind a dependent-key pill (sheet size, rate, waste, density) โ committing aCoreValueEditorResultand reporting throughonSaved(String value, String? unit)(CA-1040).- Both modes share one widget and one keyboard wiring: internally the sheet is a list of fields, and single-value is a one-element list.
- New
unitseeds the unit a commit reports when the user never taps the unit row. Single-value only โ a debug assert rejects it on the multi-column constructor, where nothing would read it. - A unit key differs by mode: single-value records the selection and reports
it separately, while multi-column keeps spelling it into the value the way
47.24indoes, sinceSizeEntryResultcarries no unit. This covers the keyboard's own unit column (Yards/Feet/Inch) as well as theunitOptionsrow โ it cannot be hidden, so it follows the same rule. Its/key, which exists to compose compound units inside the text, is ignored in single-value mode. The two controls report different vocabularies: the row gives back one of yourunitOptions, the column its own label.
0.24.0 CoreValueEditorSheet: the size entry sheet becomes public #
โ ๏ธ Breaking changes #
- CoreGeometryArea:
CoreSizesTableDatagains required-with-onSavedaddResultLabelandeditResultLabel, which name the entry sheet's commit key (CA-1040). They are separate fromaddLabel/editLabel, which title the sheet: the design's sheet reads "Edit size" while its key reads "Update".- Migration: add both to every
CoreSizesTableDatathat setsonSaved. A debug assert names the omission.
- Migration: add both to every
- CoreValueEditorSheet:
resultLabelis required, replacing the widget's hard-coded'Add'/'Update'. Reachable through the deprecatedSizeEntryBottomSheettypedef, so existing callers must supply it.unitGroupLabelis likewise required wheneverunitOptionsis set โ this package ships no user-facing English. - CoreGeometryArea:
CoreSizesTableData.unitOptionsandunitGroupLabelreplace the entry sheet's hard-codedm/cm/mmrow. They are user-facing strings, so the package no longer ships a default: a table that does not supplyunitOptionsrenders no unit row.- Migration: pass
unitOptionsand a localizedunitGroupLabelon any table whose entry sheet should keep its unit row; a debug assert names the omission.
- Migration: pass
- CoreKeyboard / CoreResultButton:
customLabelwas declared and documented but never read, socustomResultLabelhad no effect and the result key always rendered itsresultTypeโ the commit key showed "=" where the design asks for "Update". It is now honoured and rendered verbatim, preserving sentence case ("Update", not "UPDATE"). This changes what every existingcustomResultLabelcaller displays, with no code change on their side, so audit those call sites on upgrade. An emptycustomLabelstill falls back toresultType. Its screen-reader hint no longer claims the key calculates a result when the caller named it something else.
โจ New #
- CoreValueEditorSheet:
SizeEntryBottomSheetis promoted out ofCoreGeometryArea's private parts and exported from the barrel (CA-1040).SizeEntryBottomSheetremains as a deprecated typedef for one release.- New
validatorrejects a value, showing the message beneath the offending field and keeping the sheet open; editing that field clears it. - The sheet now survives being rebuilt with a different number of
titles, which it could not do while it was private and only ever opened as a modal.
- New
0.23.0 CoreGeometryArea renders several independently-configured tables #
โ ๏ธ Breaking changes #
- CoreGeometryArea: the single-table parameters are replaced by
tables: List<CoreSizesTableData>, so the calculator's detail panel can render the sizes, rates-and-waste and density tables together, each with its own callbacks (CA-1039)- Removed:
sizesTableTitles,sizesTableData,sizesTitleLabel,addSizeLabel,editSizeLabel,dragHandleLabel,onSizesReordered,onSizeDeleted,onSizeSaved, and thedefaultSizesTitleLabel/defaultAddSizeLabel/defaultEditSizeLabel/defaultDragHandleLabelconstants - Migration: wrap the former arguments in a single
CoreSizesTableData. Column titles becomeCoreSizesColumns,sizesTableDatabecomesrows, and theonSize*callbacks lose their prefix โonSaved,onDeleted,onReordered. Also supply the new requiredid: unlike the rest it has no predecessor to map from, so it cannot be inferred from the old call โ see โจ New below CoreSizesTableData.titleis required and has no English default. Titles interpolate the result they describe ('Sheet quantities for 180ftยฒ'), so they cannot be a package-level constant. This continues the 0.15.0 move of localization ownership to the consuming app
- Removed:
- Affordances are now driven by their callbacks. A table renders drag handles
only when
onReorderedis given, allows swipe-to-delete only whenonDeletedis given, and shows the add action only whenaddLabelis set, which in turn needsonAddoronSavedto act on. Previously drag handles and the add action rendered unconditionally and a swipe was always armed, even with no callback to receive it- Migration: a table that should stay reorderable or deletable must pass those callbacks explicitly
โจ New #
CoreSizesTableDataโ one titled table:id,title,columns,rows, optionaladdLabel/editLabel/dragHandleLabel, and optionalonAdd,onSaved,onDeleted,onReorderedidis a stable, locale-independent identity that must be unique among sibling tables. It keys the table's widget so state follows the table rather than its position when the list changes, and is deliberately separate from the display strings: two tables can legitimately share column headers (a rates and a waste table both showingPer unit), and a title changes whenever the result it interpolates does
- Row actions: a table with
onSavedrenders a pencil on every row and one withonDeletedrenders a trash button, matching the detail-panel design. The pencil opens the same pre-filled entry sheet the row tap already opened; the trash callsonDeleteddirectly, as the swipe doeseditRowSemanticsLabelBuilder/deleteRowSemanticsLabelBuilderbuild each button's label from its row, so a screen reader hears which row it acts on rather than ten identical'Edit's. Required alongside their callbacks- Each button is a 48 dp tap target around a 20 px icon, clearing
androidTapTargetGuideline, and claims horizontal drags that start on it so a swipe beginning on a button cannot delete by gesture - A table rendering both reserves 96 dp of row width, mirrored in the header. Wide tables scroll horizontally sooner: the four-column fixture now exceeds a 412 dp surface where it previously fit
CoreSizesColumnโ one column of a table; currently its header titleCoreSizesTableData.onAddโ when provided, the app owns the add flow and the built-inSizeEntryBottomSheetis not opened
๐งช Tests #
- Widget coverage for independent per-table callbacks: swiping a row in a table
without
onDeleteddeletes nothing, while the deletable table still reports its id - Coverage for each affordance disappearing with its callback โ hidden drag handles, hidden add action
- Each user-facing label is asserted alongside the callback that makes it reachable, so a nullable label cannot silently ship an unlabelled drag handle or a titleless entry sheet
- Golden and a11y fixtures moved onto shared table builders; the drag and delete goldens now pass the callbacks their affordances require
0.22.0 Stable test keys on calculator keys, strip chips and dependent-key pills #
โจ Features #
- CoreKeyboard: every key carries a stable
Keyfor Patrol and widget tests. Digits, operators, units and controls takecalc_key_<enum name>(calc_key_seven,calc_key_add,calc_key_feet,calc_key_clearAll) from the newDigitTypeX.testKey,OperatorTypeX.testKey,UnitTypeX.testKeyandControlActionX.testKey; the result button carriesCoreResultButton.testKey(calc_key_result). The key sits on the rendered button inside eachCore*Button, so a button built on its own carries it too (CA-1044) - KeyType.testKey (optional) and
KeyType.resolvedTestKey: a function-key tile carriestestKey, orcalc_key_<id>(calc_key_Length) โ on the strip and in the "View all" sheet alike - SuggestionData.testKey (optional): a strip chip carries it, or the row's default โ
CoreSuggestionArea.chipTestKey(index)(calc_strip_chip_0) on the primary row and the toggle layout's single row,CoreSuggestionArea.conversionChipTestKey(index)(calc_strip_conversion_0) on the two-row layout's conversions row, so the rows never share a key. Element identity is unchanged: the label / value / unit / kind / index key that keeps a chip's tap highlight bound to its data now sits on aKeyedSubtreearound the chip - CoreDependentKeyData.testKey (optional): a pill carries it, or
CoreDisplayArea.dependentKeyTestKey(index)(calc_dep_pill_0) - Display area showcase: the Rate, Waste, O.C and Shown-as pills carry
calc_dep_pill_rate/_waste/_oc/_shown_as
No behaviour or layout change: keys only.
๐งช Tests #
- Keyboard: every digit, operator, control, unit (imperial and metric) and the result button is found by its key, a function key by
resolvedTestKeywithtestKeywinning over the id default, and a tap through the key fires the callback; a tile on its own and the "View all" sheet's tiles carry the same keys; the enum keys andresolvedTestKeyare unit-tested - Suggestion area: chips take the index default per row, the two-row conversions row its own prefix and the toggle layout's conversions list the single-row prefix;
testKeyoverrides; a tap through the key accepts the suggestion; duplicates still get distinct keys - Display area: pills take the index default;
testKeyoverrides and a tap through it firesonPressed - Goldens unchanged
0.21.0 Calculator a11y: live regions and dependent-key pill hints #
โจ Features #
- CoreSuggestionArea: the area is a live region. Its semantics node is labelled with the suggestions on screen โ the active list in
toggle, both rows intwoRowsminus the conversions row whilesecondRowHiddenโ so a screen reader announces a new rung or a fresh set of conversions without moving focus; each chip keeps its own node inside the region.suggestionsSemanticsLabelBuilder(List<SuggestionData>)(optional) builds that text;CoreSuggestionArea.defaultSuggestionsSemanticsLabeljoins each suggestion'ssemanticsLabelโ or label, value and unit โ with commas (Area: 220 ftยฒ, Cost: $84.25). The placeholder is a live region too, so an emptied strip is heard as well (CA-1043) - CoreDisplayArea: the value text is a live region โ a computed result, a typed value or the
errorTitleis announced when it changes.CoreDependentKeyData.semanticsHintis announced after a pill's label and says what a tap does (Edits the rate,Changes how the pitch is shown), the spoken counterpart of the trailing โ / โ icon; no default, in line with the row holding no strings of its own - CoreButton:
semanticsHintpasses through to the button's semantics node - Display area showcase: the Rate, Waste, O.C and Shown-as pills carry hints
๐งช Tests #
- Suggestion area a11y: the region carries the live-region flag and the joined chip text; the text follows a suggestion change, the toggle's active list and
secondRowHidden; the builder overrides it; the placeholder is a live region; the existing guideline tests run against the new tree - Display area a11y: the value node is a live region whose label follows the value, and the error title, on the same node; pills announce their hint
- Button:
semanticsHintreaches the semantics node
0.20.0 CoreKeyboard group swipe and CoreFunctionKeyBottomSheet reorder callback #
โจ Features #
- CoreKeyboard: a horizontal swipe on the function-key strip selects the previous (swipe right) or next (swipe left) group in
allGroupsthrough the existingonGroupSelected, wrapping at either end. One gesture selects exactly one group; a drag shorter thanCoreKeyboard.groupSwipeThreshold(space16, 64 dp) is ignored, and a tap on a key never counts as a swipe โ a swipe that starts on a key cancels that key's tap instead. The "View all" sheet stays the non-gesture equivalent (CA-1038) - CoreKeyboard:
onGroupsReorderedandreorderSemanticsLabelBuilderpass through to the built-in "View all" sheet. The keyboard keeps a rebuild hook rather than an order, so when the consumer applies a reorder โ as a newallGroupslist or in place โ the sheet that is still open re-renders in the new order. Both indices reported by the callback are in range forallGroups - CoreFunctionKeyBottomSheet:
onGroupsReordered(int oldIndex, int newIndex)reports a drag once the group is dropped;newIndexis already the final index, sogroups.insert(newIndex, groups.removeAt(oldIndex))applies it. The sheet no longer keeps a private copy of the order โ it rendersgroupsas given, so the stored preference is the single source of truth. Drag handles render only when the callback is set, so a read-only sheet offers no gesture it cannot honour - CoreFunctionKeyBottomSheet:
reorderSemanticsLabelBuilder(groupLabel)replaces the hard-coded drag-handle label;defaultReorderSemanticsLabelkeeps the previous English string when the builder is omitted - Showcases: the keyboard sheet applies reorders to its group list; the display-area and suggestion-area calculators now track the swiped group and apply reorders, so the strip follows the gesture
โ ๏ธ Behaviour change #
- CoreFunctionKeyBottomSheet without
onGroupsReorderedshows no drag handles and cannot be reordered. Previously the handles were always shown and dragging reordered a private copy that no consumer could read back โ a reorder that was lost on the next rebuild. Wire the callback to keep the handles
๐งช Tests #
- Keyboard: swipe left / right select the neighbouring group exactly once, wrap at both ends, a key tap never swipes, a swipe that starts on a key cancels the tap and the key's action, a sub-threshold drag is ignored, a single group ignores swipes; the "View all" sheet forwards the reorder and the handle label and re-renders in the consumer's new order while open
- Sheet: the drop reports
(oldIndex, finalIndex)and the rendered order stays the consumer's; a host that applies the callback renders the new order; no handles without the callback; the handle label defaults to the previous string and follows the builder - Goldens: the sheet golden wires the callback so the handles stay and the image is byte-identical; keyboard goldens unchanged
0.19.0 CoreDisplayArea dependent-key row #
โจ Features #
- CoreDisplayArea:
dependentKeys: List<CoreDependentKeyData>renders a row of pills under the value instead of the singledependentKeyLabel/dependentKeyValuepair, because an answer can depend on more than one assumption at once โ a cost showsRateandWastetogether (CA-1037)CoreDependentKeyData { label, value, kind, onPressed, semanticsLabel }withCoreDependentKeyKind { editable, toggle, offer }:editableopens an editor for an assumption and carries the โ icon;togglerespells the value on screen (Shown as: in/12in) and carries the new โCoreIcons.swapHorizontalicon;offeris a one-time rewrite (Re-input 38.30ยฐ as 38ยฐ30โฒ) with no icon and a space instead of a colon, so it reads as a sentence- The row is end-aligned and scrolls horizontally with the trailing pill anchored in view when the pills outgrow the width; pills are separated by
space2 - Each pill is a
CoreButtonexposingbutton: truewith its label (or the consumer'ssemanticsLabel), drawn with a 1 pxlineMidhairline rather than the secondary button's 2 px outline, as in the Figma Dependent Key Chip spec (66225:151236); the row holds no default strings, in line with the 0.15.0 localization rule resolvedDependentKeys(@visibleForTesting) exposes the listbuildrenders, so tests assert the adapter without reaching into the widget tree
- CoreIcons.swapHorizontal (
Icons.swap_horiz) added for the toggle pill - CoreButton: optional
borderColorandborderWidthoverride the variant's border in every state (nullkeeps the variant's own), plusCoreButton.hairlineBorderWidth(1 px) for chip-style edges such as the dependent-key pill - Display area showcase: a Cost key prices the current Area and shows
Rate+Wasteeditable pills that recompute the cost on tap; the Pitch result carries aShown astoggle that cyclesin/12inโ degrees โ grade
๐ง Fixes #
- CoreButton: a raised secondary button (
variant: secondarywithshadows) painted its cardbuttonInverseโ white โ in the dark theme too, so the dependent-key pill'stextBody/textDarktext was near-invisible on it (contrast 1.47:1). In dark mode the card now takes the same elevatedbackgroundGrayLightsurface the social variant already uses; the light theme is untouched. Surfaced by the new pill contrast test; the old single pill had the same defect
๐ง Deprecations #
- CoreDisplayArea:
dependentKeyLabel,dependentKeyValueandonPressedDependentKeyare deprecated. They still render โ as oneeditablepill appended afterdependentKeysโ so existing callers get a deprecation warning only; the adapter is removed in the next minor release
๐งช Tests #
- Widget tests: the row renders every pill with its label and value; kind-specific trailing icons (โ / โ / none) and offer punctuation; per-pill
onPressed;buttonsemantics with the default and the overridden label; a disabled pill withoutonPressed; the row anchors its trailing pill in view and scrolls the leading pills in; the adapter appends the legacy pill andresolvedDependentKeysreflects both sources; the value section shows for pills alone - A11y: pills meet label and contrast guidelines in light and dark; each kind is announced with its own label
- Goldens:
display_area_dependent_keys_{light,dark}.png(cost result withRate+Waste, aShown astoggle and an offer overflowing the width), viewport scoped to the collapsed display area. The existing dependent-key goldens (more_than_two_rows, expansion stages) migrated todependentKeysand are byte-identical
0.18.0 CoreSuggestionArea two-row layout #
โจ Features #
- CoreSuggestionArea: new
layoutparameter โCoreSuggestionLayout { toggle, twoRows }, defaulttoggleso existing callers compile and render unchanged (CA-1035)twoRowsshows both lists at once:aiSuggestionson row 1 (the rung that fired),conversionSuggestionson row 2, no AI / conversion toggle. Each row keeps its own+Noverflow chip and expands on its own; a single non-empty list renders as a single row rather than an empty shelf. This is the calculator's default (prototypestrip: 'tworow'); the toggle layout survives behind the app's "Strip layout" preferencesecondRowHidden(defaultfalse) folds the conversions row away so the display area's dependent-key band can take the space. The fold is anAnimatedSizeover the new publicCoreSuggestionArea.animationDuration(300 ms โ the display area's stage timing, so the two surfaces move together); a hidden row is collapsed if it was expanded, and with only conversions present the placeholder shows. Ignored intoggleonExpandedChangedreportstruewhile either row is expanded andfalseonce both are collapsed; a suggestion or layout change collapses both rows, as beforeconversionsExpandToggleSemanticsLabelBuilder/conversionsCollapseToggleSemanticsLabel(optional) give the conversions row its own overflow semantics labels so a screen-reader user can tell the two rows'+Ncontrols apart; they fall back to the shared labels- the conversions row is visibly secondary, as in the calculator prototype's two-row strip: a leading tag (
CoreIcons.ruler+conversionsRowTagLabel, default'as', decorative) says "conversion" once, and every chip on the row is a value-onlyCoreChipSize.miniโas 264in 7.33ydunderArea: 410.67ftยฒ Cost: $84.25. The row is a semantics container labelledconversionsRowSemanticsLabel(default'Convert to other units'); both strings are overridable per locale. Thetogglelayout keeps full-size labelled conversion chips
- CoreChip: gains
CoreChipSize.miniโ the large chip's page-background surface andlineMidoutline at the medium chip's padding, no shadow, value and unit inbodyMediumSemiBoldinstead of the heavy unit.CoreChipTheme.onPageSurface(size)names the large/mini surface rule, and the chip's text styles now resolve throughCoreChipTheme.labelStyle/valueStyle/unitStyle(unitFontWeight= w800) so a size can vary them - Suggestion area showcase gains a "Two rows" switch and a "Hide conversions row" switch above the strip; two rows is the showcase default. Chip showcase gains a mini chips row
๐งช Tests #
- Widget tests: default layout is
toggle; two rows render both lists with no toggle and the conversions row below the primary row; single-list two-row renders one row;secondRowHiddenfolds the row away and back, animates over the shared duration rather than snapping, shows the placeholder when only conversions exist, and is ignored intoggle; independent per-row overflow withonExpandedChangedaggregation; a suggestion change or a runtime layout change collapses both rows; hiding the conversions row while it is expanded reports collapsed and brings it back collapsed, and reports nothing while the primary row is still open; the conversions row falls back to the shared overflow labels - Widget tests: the conversions row renders one tag then value-only mini chips below the full-size row,
conversionsRowTagLabelis configurable, and the toggle layout keeps full-size labelled conversion chips - A11y: both rows meet tap-target, label and contrast guidelines in light and dark; no toggle is announced in two-row mode; each row announces its own overflow controls; the conversions row announces its group label (configurable) and not the decorative tag, and a value-only chip still announces its value and unit
- CoreChip: mini renders at the medium height; theme tests for the mini padding, surface, outline, focus fill and semibold value/unit against the heavy unit of the other sizes, in light and dark
- Goldens:
suggestion_area_two_rows_{light,dark}.png(deterministic + predictive over anastag and three mini conversions), viewport scoped to the two rows;core_chip_outline_{light,dark}.pnggains a solid mini chip; every other suggestion-area golden verified byte-identical
0.17.0 CoreSuggestionArea suggestion kinds, bind styling, localisable toggle label #
โ ๏ธ Breaking changes #
- CoreSuggestionArea:
toggleSemanticsLabelis now a required parameter. The AI / conversion toggle's screen-reader label ('Toggle suggestion mode') was the last hard-coded semantics string insuggestion_area/; like the siblingexpandToggleSemanticsLabelBuilderandcollapseToggleSemanticsLabelit has no English default, so a user-facing string cannot reach the screen without passing through the consuming app's localization layer (CA-1036)- Migration:
toggleSemanticsLabel: AppLocalizations.of(context).toggleSuggestionMode
- Migration:
โจ Features #
- SuggestionData: gains
kindโSuggestionKind { deterministic, predictive, bind, conversion, memory }, defaultpredictiveโ so the app can attach the right accept behaviour without re-deriving it from label text, and an optionalsemanticsLabelthat overrides the chip's announced text ('12.57ydยฒ'โ "Convert to 12.57 square yards"). A suggestion update that only swaps akindorsemanticsLabelnow also collapses an expanded area (CA-1036) - CoreSuggestionArea: a
SuggestionKind.bindoffer renders with the dashed offer outline and a trailingbindSuffix(default'?', overridable per locale) appended to its last text segment โHeight: 8ft ?โ because accepting a bind relabels an existing chip instead of adding a result, and the look says so. The looks follow the Figma Suggestion Strip Chip spec (66225:151222): adeterministicrung renders with the 2 pxlineHighlightoutline, amemoryrecall with a leadingCoreIcons.historyicon (an emptylabelshows the value alone), and the bind chip keeps the strip's plain fill - CoreChip: gains
outline(CoreChipOutline { solid, dashed, highlight }, defaultsolid) andsemanticsLabel. The dashed outline reusesCoreDashedBorderDecoration(0.16.0) as the chip'sforegroundDecorationover the chip's usual fill, with the solid border painted transparent so the chip measures the same and the stroke following the focus border width;CoreChipTheme.dashedOutline(outline:, isFocused:, colors:)resolves it. The highlight outline is a solidlineHighlightborder at the focus width (CoreChipTheme.borderWidthFor(outline:)), with the padding giving the extra width back so the chip measures the same - Suggestion area showcase: digits typed with no function key start an unnamed entry, and the strip offers
bindchips for the dimensions still missing (prototype off-script rule); Area suggestions are taggeddeterministic, conversionsconversionwith spoken semantics labels
๐งช Tests #
- Suggestion area widget tests: default kind, bind outline + suffix (value and unit placement, custom suffix), solid kinds unchanged, bind accept callback,
semanticsLabeloverride, custom toggle label, and kind-only change collapsing an expanded area; a11y tests for the bind chip's tap target, label, contrast and announced text in both themes - CoreChip widget tests: default solid outline, dashed and highlight chip text,
semanticsLabeloverride, and theme resolution for the dashed chip's unchanged fill and transparent border, the highlight border colour, width and state priority, and the focus stroke width in light and dark - Suggestion area widget tests: deterministic renders the highlight outline; memory renders the history icon and hides an empty label
- Goldens:
suggestion_area_bind_{light,dark}.png(bind offer beside a deterministic chip) andcore_chip_outline_{light,dark}.png(highlight, solid and dashed at large, dashed at medium), viewport scoped to one chip row; existing suggestion area and chip goldens are byte-identical
0.16.0 CoreCalculatorChip result, dashed and error variants + long-press #
โจ Features #
- CoreCalculatorChip: three new
CoreCalculatorChipTypevariants for the calculator tape, so the app no longer has to borrowdisabledfor an answer or hand-build a chip for an error (CA-1034)resultโ filled chip for an answer the app computed (prototype: outlined = typed, filled = computed). Shares the muted grey pair ofdisabledby design (prototype.t-result) but stays interactive so a long-press can open provenancedashedโ dashedoutlineFocusoutline overbackgroundBlueLightfor a bind offer ("Height: 8ft ?") or a chip being edited in place; text and factor keep the editable tealerrorโalertRedfill inside a newalertRedOutlinestroke (red200light /red700dark, the Figma spec's error border) with a regular-weighttextDarkvalue for the dimension-error chip that backspace repairseditable,dashedanderrorcarryCoreShadows.smallas in the Figma Calculator Chip spec (58781:24269); the filleddisabled,activeandresultchips stay flatonLongPressfires for every variant exceptdisabled;longPressSemanticLabelis exposed as the semantics long-press hint only while the callback is set, so screen readers never announce an action that is not thereCoreCalculatorChipTheme.dashedOutline(type:, colors:)resolves the dashed decoration (null for every other type); the solid border is painted transparent at the same width so all six variants measure the same
- CoreDashedBorderDecoration: new shared
Decorationfor dashed rounded outlines, applied as a container'sforegroundDecorationso the solidBoxDecorationborder stays untouched - AppColorsExtension: new
alertRedOutlinetoken (red200light /red700dark) for the stroke around analertRedsurface - Calculator chip showcase regrouped by tape meaning (typed / computed / tentative / error) with a long-press provenance demo
๐งช Tests #
- Widget tests: tap and long-press gating per variant, long-press semantics action + hint (present with the callback, withheld without it and when disabled), dashed outline resolved only for
dashed, and token resolution for the three new variants in light and dark; text contrast checked for the new variants in both themes - Decoration unit tests for equality, step interpolation and painting
- Goldens: the single light golden is replaced by light + dark goldens covering all six variants
0.15.0 Localization ownership moves to the consumer #
โ ๏ธ Breaking changes #
- KeyType / GroupNameType: both gain a required
idโ a stable, locale-independent identifier separate from the displayedlabel.GroupNameTypeequality andhashCodenow key onidalone, so a group stays the same group (and the sameMapkey) when the app switches locale and re-renders its label.KeyType.groupNameis documented as holding the group'sid(CA-898)onKeyTappedis unchanged: it already hands over the wholeKeyType, so consumers readkey.idfor domain logic andkey.labelonly for display- Migration: pass
idat everyKeyType/GroupNameTypecall site. Using the existing English label as theidkeeps current domain matching working with no other change GroupNameType.idmust be non-empty and unique among sibling groups โ equality depends on nothing else, so a sharedidcollapses two groups into oneMapkey. The constructor asserts against the empty string, the shape a missed migration takes
- CoreDisplayArea:
closeSemanticLabelandhistoryPlaceholderare now required. The English defaults ('Close','Here will show what you type') and thedefaultCloseSemanticLabel/defaultHistoryPlaceholderconstants that exposed them are gone, so a user-facing string can no longer reach the screen without passing through the consuming app's localization layer (CA-654)- Migration: pass localized strings at every call site, e.g.
closeSemanticLabel: AppLocalizations.of(context).closeButton. Callers that relied on the constants for test assertions should assert against their own localized value instead
- Migration: pass localized strings at every call site, e.g.
๐งช Tests #
- Display-area widget, golden, and a11y call sites updated to pass both strings explicitly; goldens are byte-identical since the default text is unchanged
GroupNameTypeidentity tests: equal across differing labels, unequal across differing ids, still resolving as aMapkey when the label is localized, and an emptyidrejected at constructionKeyTypeidentity test:idis independent of the displayedlabel
0.14.1 Dark-theme colour audit: switch contrast, tooltip theming, AppColorsExtension dedup #
๐ง Fixes #
- CoreSwitch: the normal (non-error) inactive thumb fill moves from
lineDarkOutlinetoiconGrayMidso it clears WCAG 1.4.11 (3:1 non-text contrast) against the track in bothCoreTheme.light()andCoreTheme.dark(); the error-state thumb is unchanged (F10 in the dark-theme colour audit)_getInactiveThumbColornow delegates to_getBorderColorinstead of duplicating its body
- CoreTooltip: theme-dependent colours and typography are captured in
_showTooltip()from the widget's declaring context and threaded into the overlay, instead of being re-resolved against the root navigator's overlay context. A tooltip inside a locally themed subtree (e.g. aTheme(data: CoreTheme.dark())wrapper under a lightMaterialApp) now renders with its local theme. This matches Flutter's ownTooltip, which also resolves theme values at show time (F7 in the dark-theme colour audit)
๐ง Internal #
- AppColorsExtension:
create()/createDark()now delegate toCoreTheme.lightAppColors()/CoreTheme.darkAppColors()instead of holding a second copy of the token map. Output is unchanged (F11 in the dark-theme colour audit)
๐งช Tests #
test/theme/theme_extensions_test.dartpinsAppColorsExtension.create()/createDark()field-for-field againstCoreTheme.lightAppColors()/darkAppColors(), and asserts the dark factory returns the dark palette rather than the light one- Switch goldens: a dark golden is added (
switch_component_dark.png) and the light golden is refreshed for the new inactive-thumb colour CoreTooltipgains a regression test for the locally-themed-subtree case
0.14.0 CoreDivider hairline rule #
โจ Features #
- CoreDivider: new 1px hairline rule that replaces the hand-tokened Material
Dividercall sites in the consuming app (the search-results end-of-results footer and the auth pages' "or" separators), which each re-appliedthickness: 1+lineLightwith private constants (CA-1016)- Exactly
CoreDivider.thickness(1px) tall with no built-in whitespace โ unlike Material'sDividerand its default 16pxheight, vertical rhythm stays at the call site asCoreSpacingtokens; in aRowviaExpandedthe rule adds no vertical extent, so the label-separator row is sized by the text alone - Color defaults to the theme extension's
lineLight, so the rule tracksCoreTheme.light()andCoreTheme.dark();coloroverrides it for surfaces that need a different line token - Every Material
Dividerparameter is pinned โ includingradius: BorderRadius.zeroโ so a consuming app's ambientDividerThemeDatacannot restyle the rule indent/endIndentinset the rule from either edge; passCoreSpacingtokensresolvedColor(context)(@visibleForTesting) exposes the colorbuildpaints, so tests assert color resolution without reaching into the widget tree- Purely decorative: exposes no semantic node, matching Material's
Divider - Defaults are derived from the two consumer call-site families, not measured from Figma directly; CA-1016 names the pagination-footer frame (
65869:151824) as the design source for review cross-checking
- Exactly
- Divider showcase screen added to the example catalogue (full-bleed, inset, custom color, label separator, end-of-list footer)
๐งช Tests #
- Widget tests pin the 1px-tall/full-width geometry, the text-only row height and centering in the label-separator
Row, and color resolution across both themes plus the explicit override - A11y test pins the purely-decorative contract โ no announceable semantics node โ in light and dark
- Goldens for the three rule variants (full-bleed, inset,
lineMidoverride), light + dark
0.13.1 CoreSearchBox exposes test keys on the inner text field and clear button #
Version note: 0.13.1 is a deliberate patch even though the change is a Feature โ it is additive-only, and 0.14.0 is already claimed by the open CA-898 (#158) and CA-654 (#157) branches. Whichever of #157/#158/#159 merges last reconciles the version headers.
โจ Features #
- CoreSearchBox: exposes
CoreSearchBox.textFieldKey(core_search_box_text_field) on the inner text field and promotes the existing clear-button key toCoreSearchBox.clearButtonKey(core_search_box_clear_button, string unchanged), so app widget tests can target both withfind.byKeyinstead of fragilefind.byType(TextFormField)descendant finders. Both keys are shared statics, matchingCoreInputChip.removeButtonKeyโ scope withfind.descendantwhen a screen renders more than one search box (CA-952)
๐งช Tests #
- Widget tests pin both key strings, assert the keyed widget is the single rendered text field, and pin the shared-static behavior across two instances; the suite migrated to the shared
buildTestAppharness withCoreTheme.light()and every finder now goes through the key constants
0.13.0 CoreDateFilterChip active pill reuses the CoreInputChip primitive #
โจ Features #
- CoreInputChip: adds
removeOnChipTap(default false) โ when true, tapping anywhere on the chip invokesonRemoveand the whole chip is exposed as a single semantic button labeled withremoveSemanticLabel; the close (ร) icon stays visible as the removal affordance but is no longer a separate tap target (CA-830)
๐ง Changes #
- CoreDateFilterChip: the active pill is now a
CoreInputChipwith whole-chip tap-to-remove instead of a hand-built container, so it adopts the chip family's visual treatment (pill radius,chipGreybackground, semibold label, size-20 close icon). Consumers with goldens of the active pill will see pixel drift and should regenerate (CA-830)
๐งช Tests #
- Unit + semantics tests for the whole-chip tap-to-remove mode (tap anywhere removes, single button node, icon stays, no-op without
onRemove); default-mode chip goldens are byte-identical - CoreDateFilterChip active-pill goldens regenerated (light + dark)
0.12.0 CoreAppBar #
โจ Features #
- CoreAppBar: new top app bar that implements
PreferredSizeWidget, so it drops straight intoScaffold.appBar(CA-823)- Separating shadow comes from
CoreShadows.mediumviaBoxDecoration, with Material elevation held at zero, so the shadow is drawn exactly once instead of doubling CoreAppBarElevation { none, shadow, material }covers the un-shadowed bar, the CoreShadows bar, and surfaces that must match a Material-elevated siblingpaddingis additive topreferredSize(preferredSize.height == height + padding.vertical), so padding never shrinks the content box. This is the failure mode behind the 48x40 tap target in CA-822; the constructor also assertsheight >= CoreSpacing.space12(48) so leading and action tap targets can always meet the 48x48 guidelineheightdefaults toCoreSpacing.space14(56) โ measured from the consuming app, where 56 is the preferred size of 9 of the 12 existing bars (HeaderRowuses 64; the two estimation bars use an off-gridkToolbarHeight + 5). The class doc carries a caveat that Figma's reusable "Action Bar" component instead measures 64 total with t8/b8/l4/r16 baked-in padding, so CA-823 migration sites should passheight/paddingexplicitly rather than treating the code-derived default as spec-confirmeddecorationShadow(@visibleForTesting) exposes the shadow the bar's decoration paints, resolved fromelevationand consumed bybuilditself, so tests assert elevation behavior without reaching into the widget treescrolledUnderElevationis held at zero in every mode, so the bar does not darken or re-tint when content scrolls under it- Accepts an arbitrary
titlewidget (custom rows, icon clusters) or atitleTextconvenience styledtitleMediumSemiBoldintextHeadline; supplying both asserts - Colors resolve from the theme extension (
pageBackground,textHeadline,iconDark), so the bar tracksCoreTheme.light()andCoreTheme.dark() implyLeadingdefaults to false, so the bar never sprouts a Material back button just because the route is poppable โ the app bar design has no back button.leadingis rendered independently of the flag, so an explicit close/back icon is never silently dropped- Holds no user-visible strings โ
leadingandactionspass their ownsemanticLabelthrough, keeping localization in the consuming app
- Separating shadow comes from
๐งช Tests #
- Widget tests: preferred-size arithmetic, both asserts, elevation modes, theming fallback and override, action rendering and callbacks, and leading behaviour over a real pushed route (no implied back button by default, opt-in via
implyLeading, explicitleadingrendered regardless) - Golden tests: five bar shapes (flat/no-shadow, custom title row, back button with project title, Material elevation, plain title) in both light and dark, with the viewport scoped to each bar's own
preferredSizeso every golden contains exactly the bar and no empty body space - A11y tests: tap-target and label guidelines in both themes, including at the minimum permitted height
- Title contrast is asserted from the resolved tokens rather than sampled pixels; the pixel-sampling guideline reads the AppBar title's antialiased glyph edges and reports a blend of text and background rather than the token colors
0.11.2 Keep CoreMultiSelectSheet visible above the keyboard #
๐ง Fixes #
- CoreMultiSelectSheet: the sheet now pads itself by the keyboard's view inset and lets the item list shrink, so the search field, list, and action buttons stay visible above the keyboard while the user types (CA-842)
๐งช Tests #
- Widget test: presents the sheet through
CoreQuickSheet.show(the real presentation path), simulates the keyboard opening, and asserts the search field, list items, and Apply button all sit above the keyboard - Golden tests: keyboard-open sheet in both light and dark themes
0.11.1 CoreBottomNavBar action button semantic label #
๐ง Fixes #
- CoreBottomNavBar: adds
actionButtonSemanticLabelparameter โ when provided, the trailing circular action button is wrapped in aSemanticsnode so screen readers can announce it; when null (default) behavior is unchanged (backward compatible, no golden change)
๐งช Tests #
- Semantics test: verifies label and
isButtonflag appear on the trailing button's semantics node - A11y test: confirms the labeled trailing button meets tap-target and label guidelines in both light and dark themes
0.11.0 Parameterize CoreBottomNavBar for 2โ4 tabs #
โจ Features #
- CoreBottomNavBar: now accepts 2โ4 tabs (previously required exactly 4)
- Assert updated to
tabs.length >= 2 && tabs.length <= 4 - Layout computation derives tab-row and nav-bar base widths dynamically from
tabs.length, so pill, active-tab, and inactive-tab proportions are correct for any supported tab count - 2-tab design verified against Figma spec (CA-874)
- Inactive tab icons corrected from
iconGrayMidtoiconWhitefor contrast on dark track - Active tab label uses
textLinktoken (semantic fix; same hex value in all themes) - Existing 4-tab layout unchanged; goldens regenerated for icon color fix
- Assert updated to
๐งช Tests #
- Boundary assert tests: rejects < 2 tabs and > 4 tabs
- 2-tab rendering tests: active label only visible, correct icon count
- 2-tab interaction test: tap second tab fires
onTabSelected(1) - New golden:
core_bottom_nav_bar_2tab_default.png
0.10.2 Accessibility #
โจ Features #
- CoreInputChip: add optional
removeSemanticLabelfor a localizable remove-button announcement; when null, keeps the default'Remove <label>'English label
0.10.1 Dark-mode contrast fixes #
๐ง Fixes #
- Accessibility / Dark mode
- CoreButton (social variant): background changed from
buttonInverse(gray25 โ near-white) tobackgroundSecondaryDarkin dark mode, preventing invisible content when text and icon tokens also resolve to near-white - DimensionCard: same background-swap fix applied; card surface is now
backgroundSecondaryDarkin dark mode instead ofbuttonInverse - SizeCard: same background-swap fix applied; card surface is now
backgroundSecondaryDarkin dark mode instead ofbuttonInverse - All three fixes mirror the existing
CoreSelectButtondark-mode guard pattern; contrast ratios now meet WCAG AA (โฅ 4.5:1 for text, โฅ 3:1 for UI components)
- CoreButton (social variant): background changed from
๐งช Tests #
- Social button: WCAG contrast a11y test + light & dark golden tests
- DimensionCard / SizeCard: WCAG contrast a11y tests added to
core_geometry_area_a11y_test.dart - Dark-mode golden tests added for
CoreGeometryArea(collapsed and expanded)
0.10.0 Search & Filter Components #
โจ Features #
- UI Components
- CoreDateFilterChip: Filter chip for a date-range filter. With no selection it renders a plain
CoreFilterChipthat opens aCoreDateRangeSheeton tap; with a selection it renders an active pill showing the formatted range with a clear ร. Surface-agnostic: each caller supplies its own label, accessibility labels, and widget keys. - CoreDateRangeSheet: Modal bottom sheet for picking an inclusive, whole-calendar-day
DateRange. Offers predefined ranges (Today, Last 7 days, Last 30 days, This month) plus a Custom range option that opensCoreDatePickertwice โ once for the start date, once for the end date. Resolves with the chosenDateRange, ornullon cancel/dismiss. - CoreMultiSelectSheet: Modal bottom sheet body for selecting multiple values from a searchable list of
{id, label}items. The caller supplies the (already filtered) list and reacts to search and apply callbacks; present it withCoreQuickSheet.show. - DateRange: Value type representing an inclusive calendar-day range, shared by the date filter components.
- All three components ship with showcase screens, widget tests, accessibility tests, and light + dark golden tests.
- CoreDateFilterChip: Filter chip for a date-range filter. With no selection it renders a plain
0.9.1 Dart 3.8 compatibility patch #
๐ง Fixes #
- Dependency constraints loosened for Dart 3.8 compatibility
flutter_svg:^2.3.0โ^2.2.3โ 2.3.0 requires Dart โฅ3.9.0; 2.2.3 is the last release compatible with Dart 3.8. No coreui APIs from 2.3.0 are used.lottie:^3.4.0โ^3.3.1โ same reason; onlyLottie.asset()with stable params is used.ripplearc_lintermoved fromdependenciestodev_dependenciesโ the linter has no runtime role and should never have been a transitive dependency for consumers; this was causinganalyzer ^8.4.0to cascade to every app using coreui, breaking build tooling on Dart 3.8.
0.9.0 Dark theme #
โจ Features #
- Dark Color Tokens
- 9 dark token classes mirroring each light class (
DarkBackgroundColors,DarkTextColors,DarkIconColors,DarkBorderColors,DarkTabColors,DarkButtonColors,DarkInputColors,DarkSelectColors,DarkStateColors) โ all colors sourced from the Figma dark-mode palette CoreTheme.dark()now returns a fully populatedThemeDatawithbrightness: Brightness.darkandscaffoldBackgroundColormapped togray50; bothAppColorsExtensionandAppTypographyExtensionare switched to their dark variants automaticallyAppTypographyExtension.createDark()โ all 19 text styles substituted withCoreDarkTextColors.*(gray25 for headlines, gray100 for titles, gray300 for body); components usingtypography.someStylewithout.copyWithnow render correctly in dark mode
- 9 dark token classes mirroring each light class (
๐ง Fixes #
- Accessibility
SingleItemSelectormodal title: uses.copyWith(color: colors.textHeadline)so text stays visible on the dark scaffold (was gray900 on gray900 โ 1:1 contrast)SingleItemSelectoritem text: uses.copyWith(color: colors.textBody)to ensure list items remain legible in dark modeCoreSelectButtonselected tab: text color switches totextInverse(gray900) when tab background istabsHighlight(orient300), resolving the 1.6:1 contrast failure in dark mode
- CoreLetterAvatar: replaced
Image.assetwith aBoxDecoration-basedContainerwrapped inAspectRatio(aspectRatio: 1.0); fixesSemanticslabel propagation that was blocked byImage.assetand correctly derives height from the available width constraint without aRenderBoxinfinite-constraint error
Tests #
CoreDatePicker Visual Regression - Darkgolden added โ verifies header background (blue900), selected day fill (orient200), and month row text underCoreTheme.dark()- Dark-mode goldens added for color tokens, letter avatar, and check row item; all light goldens refreshed against current Flutter SDK
0.8.0 CoreInputChip #
โจ Features #
- UI Components
- CoreInputChip: New non-toggleable input chip for displaying committed tokens (e.g. email addresses or tags) with a remove button.
- Displays a text label in
bodyMediumSemiBoldwithTextOverflow.ellipsisโ safe insideWraprows and on narrow screens - Trailing close (ร) button meets the 48 dp minimum tap-target requirement; tapping calls
onRemove onRemoveis optional โ omitting it hides the remove button entirely, enabling a read-only/locked-token display mode- Full accessibility support: chip container exposes a
Semantics(container: true)node with the label text; remove button exposes aSemantics(button: true)node labelled"Remove <label>"; labelTextis wrapped inExcludeSemanticsto prevent double-announcement CoreInputChip.removeButtonKeystatic key for locating the tap target in tests- Widget tests, accessibility tests (both themes), and golden tests (light + dark, short label + email label)
- Displays a text label in
- CoreInputChip: New non-toggleable input chip for displaying committed tokens (e.g. email addresses or tags) with a remove button.
0.7.2 CoreCheckRowItem & CoreDatePicker #
Upgraded #
- Flutter SDK bumped from
3.32.0to3.44.4; Dart SDK constraint raised to>=3.12.0 <4.0.0. - Gradle wrapper
8.13โ8.14. - Android Gradle Plugin (AGP)
8.7.0โ8.11.1. - Kotlin Gradle Plugin
2.1.0โ2.2.20. flutter_lints^5.0.0โ^6.0.0.flutter_svg^2.2.2โ^2.3.0,lottie^3.3.1โ^3.4.0,ripplearc_linter^0.4.0โ^0.4.1.- Minimum supported iOS deployment target raised from
12.0to13.0(example app).
Fixed #
- Fixed a drag-reorder regression in
CoreFunctionKeyBottomSheetwhere migrating to Flutter's newonReorderItemcallback (which now performs index correction internally) had left the widget's own manual index-correction logic in place, causing dropped items to land one position off from where the user released them.
Changed #
- Migrated
ReorderableListView/ReorderableListView.builderusages (_SizesTable,CoreFunctionKeyBottomSheet) from the deprecatedonReordercallback toonReorderItem, ahead of Flutter's planned removal ofonReorder. - Migrated widget tests off the deprecated
SemanticsNode.hasFlag/SemanticsData.flagsAPI to the newflagsCollectionAPI, including theisSelected/isEnabledflags moving fromboolto the newTristateenum. SingleItemSelector's bottom sheet item now wraps itsListTilein aMaterialwidget withClip.antiAlias, fixing the tap ripple/ink effect rendering outside the intended bounds.CoreKeyboard's reveal/collapseSizeTransitionmigrated fromaxisAlignment: -1.0toalignment: AlignmentDirectional.topStart.
Tests #
- Existing
SingleItemSelectorwidget tests now pass without framework exceptions after theMaterial(clipBehavior: Clip.antiAlias)wrapper fix.
0.7.0 CoreCheckRowItem & CoreDatePicker #
โจ Features #
- UI Components
- CoreCheckRowItem: New selectable list row โ leading widget, title (+ optional subtitle), and a trailing checkbox.
- Whole row is tappable; tapping toggles
selectedviaonChanged - Defaults the leading widget to a 24ร24 circle showing the first initial of
title(derived from the first whitespace-delimited token, uppercased, e.g."John Doe"โ"J"; blanktitlerenders an empty circle, no crash);avatarBackgroundColor/avatarTextColor/avatarTextStyletheme it (ignored when a customleadingis supplied);avatarTextColoris applied last and remains the single source of truth for the glyph colour - Trailing checkbox swaps between
CoreIcons.checkandCoreIcons.checkBlankbased onselected - Optional
subtitlefor a second line (e.g. an email address) - Localizable
semanticLabelparam (defaults totitle); exposed as aSemantics(button: true, checked: selected)node
- Whole row is tappable; tapping toggles
- CoreDatePicker: New modal calendar widget for picking a single date (CA-220).
- Header with a localizable label and a large spelled-out selected date (
"Mon, Aug 17"-style by default, fully overridable viadateLabelBuilder) - Month selector row with previous/next navigation; arrows disable themselves once an adjacent month would be entirely out of the optional
firstDate/lastDaterange - Day grid with selected (filled), "today" (outlined), and disabled (out-of-range) states
CoreDatePicker.showstatic helper presents the picker in a themed dialog and resolves with the confirmedDateTime, ornullon cancel/dismissmonthLabelBuilderandweekdayLabelsallow full localization of all date text without subclassing- Each day cell exposes a
Semantics(button: true, selected: ...)node with a full date label viaMaterialLocalizations.formatFullDate
- Header with a localizable label and a large spelled-out selected date (
- CoreCheckRowItem: New selectable list row โ leading widget, title (+ optional subtitle), and a trailing checkbox.
0.5.0 Search components #
โจ Features #
- UI Components
- CoreSearchBox: New borderless search input field.
- Built-in leading search icon and auto-appearing clear button (shown only when the field has text)
- Flat appearance with no visible border โ designed for global or in-page search bars
- Accepts an optional
TextEditingControllerandFocusNode; manages its own when none are supplied onChanged,onSearch(keyboard submit), andonClearcallbacksenabledflag renders the field non-interactive with abackgroundGrayMidfillclearSemanticLabellocalizable constructor param (defaults to'Clear search')hintTextlocalizable constructor param for placeholder text
- CoreSearchRowItem: New single-row item for search screens.
- Two named constructors:
CoreSearchRowItem.recentSearch(history icon) andCoreSearchRowItem.suggestion(search icon with bold-prefix query highlighting) - Trailing โ icon with independent
onTrailingTapcallback (e.g. fill the search field without triggering a search) showTrailingIconflag to hide the trailing iconsemanticLabelandtrailingSemanticLabellocalizable params for full screen-reader support- Custom variant via the default constructor: caller supplies any
leadingIconand a pre-builtlabelwidget
- Two named constructors:
- CoreSearchBox: New borderless search input field.
0.4.1 CoreIconSize token #
โจ Features #
- Design Tokens
- CoreIconSize: New icon size token with four canonical sizes โ
size16(16dp),size20(20dp),size24(24dp),size32(32dp).- Value-based naming reflects how icon sizes are referenced in design tooling and specs
- Exported from the public barrel alongside other theme tokens
- Golden test verifying each size using
CoreIconWidget
- CoreIconSize: New icon size token with four canonical sizes โ
0.4.0 CoreFilterChip component #
โจ Features #
- UI Components
- CoreFilterChip: New dropdown-style filter chip for filter rows.
- Filled pill design using
backgroundGrayMid(#F2F4F7) background token - Trailing dropdown arrow icon in
iconDark(#015B7C) color label(required) andonTap(optional) public API โ chip is non-interactive whenonTapis null- Full accessibility support: outer
Semanticsnode exposes label and button role (only when enabled);Textand arrow icon wrapped inExcludeSemanticsto prevent double-announcement - Widget tests, accessibility tests, and golden tests (enabled, long label, disabled states)
- Filled pill design using
- CoreFilterChip: New dropdown-style filter chip for filter rows.
0.3.9 CoreToast title support #
0.3.8 CoreQuickSheet component #
โจ Features #
- UI Components
- CoreQuickSheet: New standardized bottom sheet component for consistent sheet presentation across the app
- Automatic content-based height (up to 90% of screen)
- Custom drag handle with consistent styling
- Theme-aware background color (defaults to
pageBackground) - Configurable dismiss behavior (
isDismissible,enableDrag) - Optional safe area handling (
useSafeArea) - Optional custom background color override
- Rounded top corners (28px) per design spec
- Returns values when dismissed for result handling
- CoreQuickSheet: New standardized bottom sheet component for consistent sheet presentation across the app
๐ง Fixes #
- Code Quality
- Fixed tooltip component forced unwrapping issue with overlay entry
- Improved null safety in tooltip overlay insertion
0.3.7 Add splash screen icons #
โจ Features #
- Icons
- Added splash screen animation icons (splashFirstState, splashSecondState, splashThirdState)
- New SVG icons available via CoreIcons for splash screen animations
0.3.6 Accessibility improvements #
โจ Features #
- Accessibility
- Added accessibility tests for all interactive components (CoreAvatar, CoreLetterAvatar, CoreKeyboard, CoreButton, CoreBottomNavBar, CoreLoadingIndicator)
- Tests verify tap target size, semantic labels, and text contrast guidelines
๐ง Fixes #
-
Design Tokens
- Updated text link color from orient600 to orient800 to match UI design specification
-
Accessibility
- Fixed CoreButton text overflow with ellipsis and FittedBox scaling for long labels
- Fixed accessibility-related contrast and layout issues across components
0.3.5 Code quality improvements #
โจ Features #
-
UI Components
- CoreLoadingIndicator: Added Lottie-based loading indicator component with customizable size and fit options
-
Dependencies
- Added lottie (^3.2.0) for animation support
-
Assets
- Added loading animation asset (
assets/animations/loading.json)
- Added loading animation asset (
0.3.4 Code quality improvements #
๐ง Fixes #
- Code Quality
- Fixed
avoid_static_colorslinter violations - Integrated shadow colors into theme system for consistent design token usage
- Fixed
0.3.3 Theme extension naming consistency #
โ ๏ธ Breaking Changes #
- TypographyExtension has been renamed to AppTypographyExtension for consistency with other theme extensions
- Update your code:
Theme.of(context).extension<TypographyExtension>()โTheme.of(context).extension<AppTypographyExtension>()
0.3.2 Code quality improvements #
๐ง Fixes #
- Code Quality
- Fixed
avoid_static_typographylinter violations - Fixed
forbid_forced_unwrappinglinter violations - Fixed
specific_exceptions_typeslinter violations
- Fixed
0.3.1 Add transparent utility color #
โจ Features #
- Design Tokens
- Added transparent utility color to the core color palette and AppColorsExtension for consistent use across apps.
0.1.0 Initial Release #
โจ Features #
-
UI Components
- CoreBottomNavBar: A customizable bottom navigation bar component with responsive sizing and smooth animations.
- SuccessModal: A bottom sheet that is displayed to the user when an operation is successful.
- Toast: Provides a static interface to display toast messages, e.g., Toast.showSuccess, Toast.showError, Toast.showWarning.
- CoreButton: Customizable button with support for primary, secondary, and social variants, multiple sizes, icons, and disabled state.
- CoreTextField: Flexible text input with label, helper text, error handling, phone number input, prefix/suffix widgets, and country code selector.
- SingleItemSelector: Single-select dropdown with bottom sheet support.
- CoreIconWidget: Unified icon widget supporting both Material and SVG icons.
-
Design Tokens
- Color tokens (brand, gray, blue, red, etc.)
- Typography tokens (font sizes, weights, styles)
- Spacing tokens (consistent spacing system)
- Shadow tokens (multiple shadow levels)
- Icon tokens (Material and custom SVG icons)
-
Theming
- Light and dark theme support
- Easily extendable theme data for custom branding
-
Assets
- Extensive icon set (SVG and Material icons)
- IBM Plex Sans Hebrew font family included