docs: point import examples at the layrz_ui.dart root barrel
Release 0.0.5 replaced the per-domain entrypoints with a single root barrel.
Update the remaining references in Design-Tokens and Grid, and drop the
alternative import block in Platform-And-Extensions, which now offered the same
import twice.
Co-Authored-By: Anthropic Claude <noreply@anthropic.com>
abef902
docs: correct examples for the five-style text scale
The text scale collapsed from fifteen names to five, so every example
using displayMedium, titleLarge, bodyMedium or labelSmall no longer
compiled. Getting-Started mattered most, since the README now sends new
users straight there.
Also replaces the retired grid breakpoint constants with the theme's
breakpoint tokens, and takes the installation and usage material moved out
of the README.
04fd531
docs: collapse the type scale to five styles
display, headline, title, body and label, without size suffixes. Each takes
the values of the former Medium variant, so nothing renders differently
except where a component was using a non-Medium size.
a259374
docs: update LayrzAlert for the split-panel redesign
The layrz style is no longer a neutral surface with an icon chip. It now
shares filledIcon's split-panel layout with a tonal left panel instead of a
solid one, so the two styles read as one pattern at two intensities.
filledIcon gained a border, without which its surface-coloured half was
invisible on a white page.
Also documents flattenOn and isOpaque on the colour extension, including
why flattening exists: a translucent fill lets a BoxDecoration's shadow
bleed through it.
00915e4
docs: document the interactive LayrzAlert
Records the optional onTap: what changes on hover, focus and press, that
the lift is a paint-only transform so the alert's rect never moves, and
that an interactive alert announces as a button and activates with Enter
or Space without any extra wiring inside LayrzApp.
Non-interactive remains the default and renders exactly as before.
8d20c66
docs: correct LayrzTooltip for the composed rebuild
The page described a thin RawTooltip wrapper with an anchor-opacity
limitation. Neither is true any more: the component is composed on Overlay
and no longer changes the hit-testing or layout of whatever it wraps.
Records the guarantee that replaced the limitation, that the surface always
renders outside the anchor's bounding box, and drops the RawTooltip
positionDelegate gotcha. The gesture-arena constraint with a child's own
onLongPress is retained, since it still holds.
4792f07
docs: add LayrzTooltip and LayrzAlert pages
Documents both M2 Feedback components: full API, enums, styling tables and
examples.
The tooltip page distinguishes the surface's pass-through guarantee from
the anchor, which RawTooltip makes opaque to hit-testing, and links the
tracked rebuild. It also records the measured gesture-arena behaviour and
the SDK gotcha where a custom positionDelegate forces verticalOffset to
0.0.
45a61a5
docs: document LayrzCard and the breakpoint tokens
Rewrite the LayrzCard page from draft to final API. Update the Grid page and
Design Tokens for breakpoints moving onto the theme, and add LayrzCard to the
Component Catalog.
ac3eb72
docs: correct Grid page for viewport-driven breakpoints
Remove useScreenWidth, which no longer exists, and replace the
container-versus-viewport section with the single behaviour: bands come from
the viewport, pixel widths from the row's own box.
Fix the worked example, which claimed a 1920px viewport selected the lg band.
1920 is above lg's 1903 ceiling, so it selects xl and cascades to the lg value.
7c8a467
docs: add Grid page for LayrzRow, LayrzCol and LayrzConstrainedView
59ef6d8
docs(button): rewrite LayrzButton for the shipped API
The LayrzButton wiki page had drifted nine rounds out of date and documented an API that no longer existed. It now describes the twelve styles including `text` and `fab`; `LayrzButtonType` and its token mapping; the six semantic factories with their per-factory `isElevated` defaults and the reasoning behind `.cancel` and `.delete` differing; the `LayrzButtonController`, including that one controller drives many buttons in lockstep, that cooldown auto-clears on expiry, and the anti-flash floor; the four-state interaction model and the fill ladder, with keyboard focus rendering as hover; and that sizing is standardised rather than caller-configurable. Removed references to `isMobile`, `tooltipEnabled`, the separate `isLoading`/`isCooldown` listenables and the five deleted sizing parameters. The Component Catalog row is updated to match.
Co-Authored-By: Anthropic Claude <noreply@anthropic.com>
af01d83
docs(button): document LayrzButton API and update catalog
The LayrzButton page now documents the shipped API:
- Ten style variants (.standard, .filled, .outlined, .filledTonal, .filledIcon,
.fab, .fabSmall, .icon, .ghost, .text)
- Six semantic factories (.save, .cancel, .info, .show, .edit, .delete)
- Externally-owned ValueListenable<bool>? for isLoading and isCooldown states
- Nullable onTap + isDisabled disabled state contract
- RawTooltip-for-now caveat for FAB variants
The Component Catalog row for LayrzButton has been updated to reflect the
completed implementation. The three previously open questions on the page
have been resolved.
GitHub issue #21 (LayrzButton component).
b0d9a32
docs: document the theme extension and preview theme
159a21d
docs: rename the scaffold component to LayrzScaffoldShell
ThemedScaffoldView and ThemedScaffoldCell are retired rather than ported.
layrz_ui ships a single public LayrzScaffoldShell; the view and cell
become private implementation details.
Co-Authored-By: Anthropic Claude <noreply@anthropic.com>
f0b4d9d
docs: correct the install instructions
layrz_ui is not published on pub.dev; the endpoint returns 404 and the
repo version is 0.0.1, so the documented ^0.1.0 constraint could not
resolve. Replace it with a git dependency and note that publication has
not happened yet.
Co-Authored-By: Anthropic Claude <noreply@anthropic.com>
891d0e7
docs: add foundation usage documentation
Adds 8 comprehensive foundation documentation pages to the wiki:
- Getting-Started.md: dependency setup, minimal app, font preload, first screen
- LayrzApp.md: root widget API reference and theme installation
- Theming.md: theme system, LayrzTheme, LayrzThemeData, accessing tokens
- Design-Tokens.md: complete token reference (colors, typography, spacing, radius, shadow, border, motion)
- LayrzTokenizer.md: token facade with group getters and flat shortcuts
- Fonts.md: font setup, preloading, Google Fonts handler, custom fonts
- Widget-States.md: re-export of Flutter's WidgetState and WidgetStateProperty
- Platform-And-Extensions.md: LayrzPlatform detection and Color/BuildContext utilities
Also updates Home.md and _Sidebar.md with navigation to the new foundation pages.
Co-Authored-By: Anthropic Claude <noreply@anthropic.com>
f19587d
docs: point engineering doc links at engineering/
The repository's engineering documentation moved from doc/ to
engineering/. Updated 57 URLs across 35 pages. Wiki-internal links,
which use bare page names, are unaffected.
Co-Authored-By: Anthropic Claude <noreply@anthropic.com>
cdfb0ce
docs: add card, avatar, table, snackbar and layout pages
Five new component pages:
- LayrzCard, a brand-new elevation shell with hover and onTap. Intent
is confirmed but its parameter list is still open.
- LayrzAvatar, mirroring ThemedAvatar. Its dynamicAvatar path depends
on layrz_models, which is deferred under decision D2.
- LayrzTable, mirroring ThemedTable2. Frames the scrolling foundation
as an open choice between sync_scroll_controller, the clean
two_dimensional_scrollables TableView primitives, or the SDK's
TwoDimensionalViewport directly.
- LayrzSnackbar, confirmed scope, with mandatory titleText and
descriptionText, a type defaulting to success, icon and color valid
only for the custom type, a 10 second default duration and a
nullable onTap that runs then dismisses.
- LayrzLayout, a placeholder. ThemedLayout offers three desktop and
two mobile presentations that must be narrowed to one before this
can be specified.
Component-Catalog and the widgets sidebar are updated to index them.
Co-Authored-By: Anthropic Claude <noreply@anthropic.com>
2ab6998
feat: add LayrzTextAreaInput, LayrzTextInput, LayrzTimeInput, and LayrzTimeRangeInput documentation
- Introduced LayrzTextAreaInput for multiline text input with detailed specifications.
- Established LayrzTextInput as the foundational single-line text input component.
- Created LayrzTimeInput for time selection via a picker dialog.
- Added LayrzTimeRangeInput for selecting a range of times, including detailed parameters and interaction patterns.
- Updated sidebar to include new input components for easy navigation.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
66f2c6e
docs: add documentation for new input components and update sidebar
- Introduced `LayrzTextAreaInput` for multiline text input with detailed specifications and interaction patterns.
- Added `LayrzTimeInput` for single time selection and `LayrzTimeRangeInput` for time range selection, both derived from `layrz_theme`.
- Updated `_Sidebar.md` to include new input components and organized references for better navigation.
- Created `_Footer.md` for consistent branding across documentation.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
f75c714