foundation library
Carpenter semantic roles, theme, adaptive primitives, units, and icon data.
Classes
- AngleUnit
- A physical angle that can be converted without a rendering context.
- Application
- The root of a Carpenter application.
- CarpenterActionDescriptor
- Immutable application action metadata used by Carpenter surfaces to project consistent label, icon, availability, semantics, shortcut, and invocation.
- CarpenterActionPalette
- State palette for one semantic action color family.
- CarpenterActionStyle
- Resolved colors for one action after semantic role, prominence, and widget state have been applied.
- CarpenterActionTheme
- Resolves semantic action color roles, prominence, and interaction state without requiring components to choose raw colors.
- CarpenterAdaptiveContext
- CarpenterCapabilityScope
- CarpenterContentTheme
- Semantic foreground palette for non-interactive content.
- CarpenterFeedbackStyle
- Resolved passive feedback colors for one semantic feedback role.
- CarpenterFeedbackTheme
- Maps FeedbackColorRole values to resolved passive feedback styles.
- CarpenterFieldStyle
- Resolved field colors after availability, focus, hover, and validation state have been applied.
- CarpenterFieldTheme
- Semantic field palette and state resolver shared by Carpenter input controls.
- CarpenterFocusTheme
- CarpenterIconData
- Base contract for non-Flutter icon sources rendered by Carpenter.
- CarpenterInputCapabilities
- CarpenterMotionTheme
-
CarpenterOption<
T> - Immutable selectable option with stable identity, value, display text, accessibility label, and availability.
- CarpenterOverlayTheme
- CarpenterSelectionPalette
- Selected-state palette for one SelectionColorRole.
- CarpenterSelectionStyle
- Resolved colors for a selectable control after role, selection, hover, and disabled state have been applied.
- CarpenterSelectionTheme
- Resolves selection controls from semantic color role, selected state, and WidgetState values.
- CarpenterShape
- Directional start/end shape descriptor for controls that may join a group.
- CarpenterShapeTheme
- CarpenterSizeTheme
- CarpenterSpacingTheme
- CarpenterSurfaceTheme
- CarpenterTheme
- Inherited boundary that exposes CarpenterThemeData to descendant Carpenter components.
- CarpenterThemeData
- Immutable semantic theme assembled from generated Carpenter tokens for one brightness, contrast, and density combination.
- CarpenterTypographyTheme
- Resolves semantic Carpenter typography roles and component text treatments into Flutter TextStyle values using the active unit scale.
- CarpenterViewportPolicy
- Degrees
- An angle expressed in degrees.
- Em
-
A value relative to the effective
emof the current element. - LengthUnit
- A physical length that can be resolved in a typography context.
- LengthUnitContext
- Runtime values required to resolve relative length units.
- Milliseconds
- A duration expressed in milliseconds.
- PaletteTokens
- Px
- An absolute logical-pixel value.
- Radians
- An angle expressed in radians.
- Rem
-
A value relative to the root
remconfigured for the widget subtree. - Seconds
- A duration expressed in seconds.
- TimeUnit
- A physical time value that can be converted to a Dart Duration.
- Turns
- An angle expressed in complete turns.
- Unit
- A typed physical UI quantity.
- UnitsHandle
-
Resolves typed units and mutates the local
emdeclaration of an element. - UnitsRoot
-
Configures the root
remvalue for a subtree.
Enums
- ActionColorRole
- Semantic color family for interactive actions.
- ActionColorSlot
- Theme slot resolved for an action color family and prominence.
- ActionExecutionPhase
- Presentation phase of an asynchronous or externally tracked action.
- ActionProminence
- Visual emphasis of an action, independent from its semantic color role.
- CarpenterActionIconPosition
- Position of an action icon relative to its label.
- CarpenterDensity
- Global density preference used by semantic sizing and spacing resolution.
- CarpenterViewportClass
- CheckboxValue
- Tri-state checkbox value.
- ContentColorRole
- Semantic foreground color for non-action content.
- ContrastMode
- Requested contrast level for semantic Carpenter colors.
- ControlSize
- Semantic size scale used by compact controls.
- DialogDismissPolicy
- Policy controlling which implicit gestures may dismiss a dialog.
- FeedbackColorRole
- Semantic color family for passive feedback and status presentation.
- FieldAvailability
- Interaction availability of an input field.
- FieldSize
- Semantic size scale used by fields and field-like controls.
- IconSize
- Semantic size scale used by icons.
- OptionsLoadState
- Loading state for option-producing controls such as selects and suggestions.
- OverlayPlacement
- Preferred placement of anchored overlay content relative to its anchor.
- SelectionColorRole
- Semantic color family for selection indicators and selected surfaces.
- ShapeRole
- Semantic endpoint shape used by grouped surfaces and controls.
- ToastDuration
- Semantic lifetime of transient toast feedback.
- TooltipDelay
- Semantic delay before tooltip presentation.
- TypographyEmphasis
- Semantic weight applied within a TypographyRole.
- TypographyRole
- Semantic typography family chosen independently from emphasis and color.
Extensions
- UnitLiterals on num
- Numeric literals for typed units.
- UnitsBuildContext on BuildContext
-
Adds
context.units(...),context.units.set(...), andcontext.units.reset().
Constants
- palette → const PaletteTokens
Typedefs
- CarpenterIconSource = Object
- Value accepted by Carpenter icon slots.
Exceptions / Errors
- MissingUnitContextException
- Thrown when a relative unit lacks required runtime context.
- UnitParseException
- A parse failure with the source representation that caused it.