Changelog

Added

• AudioPlayer. Themed audio player with play/pause, scrub bar, time, volume, optional cover slot, and download button. Wraps the native <audio> element; exposes OnPlay / OnPause / OnEnded / OnTimeUpdate callbacks.
• SignaturePad. Canvas-backed signature capture via mouse / touch / stylus. Configurable stroke color + width, transparent or solid background, PNG / JPEG / WebP output, optional download, and a disabled mode for read-only display of previously captured signatures.
• Lumeo.PdfViewer satellite. New optional NuGet package for rendering PDF documents inline.
• Lumeo.Maps satellite. New optional NuGet package for interactive map embeds.
• Lumeo.CodeEditor satellite. New optional NuGet package for a Monaco-style in-browser code editor.
• DataGrid PinColumn UI. Per-column pin / unpin (left / right) inside the column chooser flyout, in addition to programmatic pinning.
• DataGrid drag-to-reorder columns. Reorder columns directly inside the column chooser by drag-and-drop; order persists with the grid's existing state hooks.
• Batch edit mode segment in the playground. New segment on the DataGrid playground page to flip between row / cell / batch edit modes live.

Improved

• DataGrid per-column toggles are reactive. Sortable and Filterable on DataGridColumnDef now update at runtime — the column re-registers on OnParametersSet instead of only on first render, so toggling them from parent state works without an explicit grid refresh.

Internal

• 5 new media methods and 7 new SignaturePad methods added to IComponentInteropService to back the new components.

Improved

• Soft borders sweep — 27 components. border-border → border-border/40 on popovers, menus, hover cards, cards, and other neutral surfaces. Semantic borders (focus rings, active states, destructive variants) deliberately left at full opacity so they still read as state changes.
• Accessibility + keyboard polish — 23 components. Dialog / Sheet / Drawer / Popover / AlertDialog triggers and close buttons now handle Enter and Space. Icon-only buttons across the library gained aria-label + explicit type="button". Image / ImageGallery preview overlays announce as role="dialog" with auto-focus on open. Pagination current page gets aria-current="page"; Steps active step gets aria-current="step"; Sidebar collapsible groups expose aria-expanded.
• Icon resolver coverage. ~66 new Lucide names mapped in the DynamicIcon resolver — fewer fall-throughs to the default icon when consumers wire up arbitrary Lucide names.

Added

• DataGrid playground. New page at /components/datagrid/playground — 29 toggles across 10 sidebar groups, collapse / expand the controls via SidebarTrigger. Click anything and see the grid reconfigure live; great for evaluating before vendoring.
• Living demo reel on the home page. Hero stats with NumberTicker, an auto-cycling carousel of Tabs / BarChart / Toast / Stepper / Sparklines, a Kanban with real drag-and-drop, and a DropdownMenu submenu tile. Replaces the static screenshots with components driving themselves.

Fixed

• DataGrid aggregate row extracted to a sibling strip. Previously the aggregate row sat inside the table footer / scroll region, which broke sticky-header math when the grid scrolled and double-counted height under fullscreen. It now renders as a sibling element next to the scroll container — sticky header, sticky aggregate, no overlap. This supersedes the 3.0.2 and 3.0.3 attempts at the same problem.

Fixed

• Accordion / Collapsible smooth animation. Previous keyframe interpolated height: 0 → auto, which CSS can't animate — content snapped in instantly. Now uses the modern grid grid-rows-[0fr] / [1fr] trick, smooth in both directions, zero JS.
• Tabs Card variant baseline. Added border-b border-border/40 on TabsList + -mb-px on active triggers so Card tabs sit on a real baseline.
• Toast close button needed two clicks. The 3.0 pause-on-hover wiring intercepted focusin events. Fixed by stopping focusin propagation on the close button.
• Chevron rotations. DataGrid group-panel trigger, DataGridGroupRow, DataGridRow (expandable detail), PivotGrid, FileManager, TreeViewNode — replaced icon-swap with a single chevron + transition-transform + conditional -rotate-90.

Added

• TabsList.SavedLayout + OnLayoutChanged — mirrors DataGrid's layout persistence pattern for the 3.0 Reorderable Tabs.
• LumeoGestureOptions — single DI-registered options bag (SwipeThresholdPx, VerticalDeadZonePx, SwipeDismissThresholdPx, SwipeDismissFirePx) consumed by Tabs / Carousel / Calendar / ImageGallery / Drawer / Sheet swipe handlers. Defaults match the previously hardcoded values.

Tier 1 — Reliability

Automatic nested overlay stacking (Dialog/Sheet/Drawer/AlertDialog allocate z-index per overlay, Escape closes the top one); OnBeforeClose + DismissEventArgs (Reason: escape / outside / swipe / close / action / cancel) on the same four overlays so consumers can intercept dismissals; toast hover/focus pauses the auto-dismiss timer and the ARIA role is now variant-aware (Destructive → role=alert + aria-live=assertive; others → role=status + aria-live=polite); tooltip viewport-edge auto-flip.

Helpers

Form.ResetValues() restores the model snapshot captured on first render (the existing Form.Reset() only clears errors / dirty / submitting state). DatePicker gained AllowKeyboardInput (default true) + OnParseError so typed dates round-trip cleanly; readonly opt-out is one prop.

Tier B — Quality

DateTimePicker is now time-zone aware: TimeZone (a TimeZoneInfo), OffsetValue (a DateTimeOffset), and ShowTimeZoneLabel so users see which zone they're working in. FormField gained async validation — AsyncValidator, AsyncValidationDebounceMs, AsyncValidateOn (OnBlur / OnChange), IsValidating, OnValidatingChanged, and FormContext.IsAnyFieldValidating for submit-button gating.

Tier C — Features

TabsList.Reorderable + OnReorder (TabsReorderEventArgs: FromIndex, ToIndex, MovedTabValue) — the consumer mutates the collection, the library handles drag UX. New Submenu support across DropdownMenu, ContextMenu, and Menubar via *Sub / *SubTrigger / *SubContent with hover-intent open, ArrowLeft/ArrowRight navigation, and Escape-closes-the-whole-tree.

Tier D — BREAKING: enum unification

The per-component Size, Side, Align, and Orientation enums (e.g. Button.ButtonSize, Tooltip.TooltipSide, Sheet.SheetSide, Popover.PopoverAlign, Tabs.TabsOrientation) have been replaced by four library-wide types in the Lumeo namespace: Lumeo.Size, Lumeo.Side, Lumeo.Align, Lumeo.Orientation. The rename is mechanical (search-and-replace) and the values are 1:1 across the old and new types — see MIGRATION.md for the full per-component recipe.

Fixed

• FileUpload: auto-upload no longer dispatched via Task.Run (which hopped to the thread pool and forced every inner StateHasChanged to marshal back through InvokeAsync). Replaced with a direct InvokeAsync(async () => …) + try/catch that surfaces systemic upload failures on each pending item's Status + ErrorMessage.
• DateWheelPicker + TimeWheelPicker: CommitDay/CommitMonth/CommitYear/CommitHour/CommitMinute/CommitPeriod were async void. Any exception thrown after the first await escaped to the thread-pool finalizer and crashed the circuit. Converted to async Task; ResetTimer's commit parameter is now Func<Task> so InvokeAsync can observe completion.
• Wheel-picker init delay: Task.Delay(150).ContinueWith(_ => InvokeAsync(...)) ran the continuation on the thread pool and silently swallowed any exception (including the typical JSDisconnectedException during circuit teardown). Replaced with InvokeAsync(async () => { await Task.Delay(150); … }) + explicit JSDisconnectedException catch.
• DatePicker.SetIsOpen + HoverCard.OnClickOutside: _ = OpenChanged.InvokeAsync(value) fire-and-forget — a faulting consumer handler vanished into the void. Now wrapped in InvokeAsync + try/catch (DatePicker) or returned via await (HoverCard, whose caller is async-aware).

Added

• Drag-to-group affordance on column headers — when ShowGroupPanel="true" and the column is Groupable, the header now reveals a muted Group icon on hover (mirroring the filter button's opacity pattern), plus the cell carries cursor-grab. Title attribute uses L["DataGrid.DragToGroup"] ("Drag to group by this column" / "Zum Gruppieren nach dieser Spalte ziehen"). Both icon + cursor are hidden when there's no panel to drop into, so non-grouping grids aren't cluttered.

Fixed (i18n)

• Group-panel empty-state placeholder "Drag a Groupable column header here, or use the dropdown" was still a hardcoded English literal inside @(GroupPanelText ?? "…") — the 2.2.0 i18n agents missed it because of the null-coalesce shape. Now routes through L["DataGrid.GroupPanelPlaceholder"]. Consumers passing an explicit GroupPanelText still take precedence — back-compat preserved.

Localisation keys added

• DataGrid.GroupPanelPlaceholder (EN + DE)
• DataGrid.DragToGroup (EN + DE)

Fixed

• Group panel "+ Add group level" picker now right-aligned — the 2.2.0 refactor moved the trigger into a <DropdownMenu> component, which renders its own relative inline-block wrapper as root. The ml-auto on the inner trigger button had no effect on the flex-parent panel because DropdownMenu was the actual flex child. Wrapped the component in a <div class="ml-auto"> so the picker sits hard-right again.
• Grouping changes now persist to localStorage — AddGroupField / RemoveGroupField / ClearGroupFields didn't call ScheduleAutoSave(), so the snapshot serialization built in v2.1.1 had nothing to act on. Sort/filter changes had been calling it from day one. Three matching ScheduleAutoSave() calls added — grouping now round-trips through reload identically to sort/filter/columns.

Fixed (CSS theming)

• Placeholder hover-override (B1) — inner <span class="text-muted-foreground"> placeholder text inside hover-styled trigger buttons no longer becomes illegible on hover (dark grey on accent green). Fixed across TimePicker, DateTimePicker, DatePicker (5 placeholder spans) via group + group-hover:text-accent-foreground.
• DataGrid group-panel "+ Add group level" dropdown — was a native HTML <select> rendering with OS-default chrome (white-on-blue on Windows). Replaced with Lumeo's own <DropdownMenu> + <DropdownMenuItem>.
• NavigationMenuMobile — Class and AdditionalAttributes were declared but never propagated to a root element. Now applied (Class merged into inner SheetContent; AdditionalAttributes on the inner div).

Improved (accessibility — keyboard focus)

• ~110 new focus-visible:ring-* rings across ~45 files: DataGrid (header sort/filter buttons, toolbar buttons, row expand/edit/save/cancel, batch ops), Editor (toolbar, BubbleMenu, AiActionMenu), QueryBuilder (combinator pills), Calendar (day cells + nav buttons), Tour, DatePicker preset buttons, ThemeSwitcher swatches, Pagination, NumberInput steppers, FileUpload buttons, TreeViewNode, Sortable handles, RadioGroupCard, MegaMenuLink, PivotGrid, Segmented, ConsentBanner, ImageGallery, InplaceEditor, ReasoningDisplay, FileManager, TreeSelect, PromptInput, PickList, BackToTop, Transfer, and more.
• Special-case patterns spotted & fixed: hover-revealed icon buttons (group-hover:opacity-100) now also reveal on keyboard focus via focus-visible:opacity-100; adjacent button-groups (steppers, file-action rows) use focus-visible:relative focus-visible:z-10 so rings aren't clipped; overlay/lightbox buttons over bg-black/80 backdrops use ring-white for visibility.

Improved (i18n — multi-lingual UI)

• 62 hardcoded English UI strings routed through ILumeoLocalizer across ~32 components (FileManager 15, QueryBuilder 8, PickList 4, Scheduler 3, ThemeSwitcher 3, and many one-offs across aria-labels, titles, placeholders, default parameter values).
• ~50 new localization keys added to LumeoDefaultStrings.cs (English + German pairs). New namespaces: FileManager.*, QueryBuilder.*, PickList.*, Scheduler.*, Theme.*, Chart.* (Loading), BottomNav.*, Dock.*, Badge.*, Chip.*, Alert.*, ImageCompare.*, PromptInput.*, PivotGrid.*, Editor.*, Tabs.*.
• Effective* nullable-parameter pattern introduced for default-value localization (e.g. LoadingText on Charts, AriaLabel on Dock/BottomNavFab/TriggerDropdown/ToastClose, GrandTotalLabel on PivotGrid). Consumers passing explicit strings still work — back-compat preserved.

Docs

• Hero badge bumped to v2.2.0. Install snippets (Code, Cli) updated to --version 2.2.0.
• lumeo-mcp package.json + package-lock + src/index.ts + src/registry.json bumped to 2.2.0 (lockstep).
• New DataGrid.AddGroupLevel key (EN/DE) added.

Known follow-ups (deferred to 2.2.1)

• QueryBuilderGroup Field/Operator pickers still use native <select> with themed trigger but OS-default dropdown popup. InplaceEditor the same. Refactor to <Select> needs the disabled-placeholder pattern.
• StepperStep is a pure-registration component; its Class parameter is currently dead. Plan: thread through StepRegistration record so parent Stepper can apply it.

Fixed

• ComponentInteropService.GetModuleAsync + ImportModuleAsync now append ?v={assembly-version} to all _content/Lumeo*/ module URLs. KeyboardShortcutService.GetModuleAsync updated symmetrically.
• Upgrades from this release forward are immune to the stale-cache class of failure when new JS exports are added in the lib (e.g. the v2.1.3 registerViewportListener failure). v2.1.3 users hitting that error today need a hard refresh (Ctrl/Cmd+Shift+R); from v2.1.4 the cache-buster handles it automatically.

Notes

• Version derived once from AssemblyInformationalVersionAttribute (which Directory.Build.props <Version> drives), so it tracks every release without manual maintenance.
• URLs that already contain a query string pass through untouched — consumer overrides (e.g. local debugging with ?nocache=1) are preserved.
• Non-library URLs are passed through unchanged, so consumer JS modules loaded via ImportModuleAsync aren't affected.

Added

• IResponsiveService — reactive viewport/breakpoint service. Exposes Width, Height, Current (Breakpoint enum: Xs/Sm/Md/Lg/Xl/Xxl aligned with Tailwind v4), IsMobile/IsTablet/IsDesktop, and a ViewportChanged event. One JS resize listener per circuit, debounced 100ms.
• OverlayOptions.MobileBreakpoint/MobileSheetSide/MobileSheetSize/MobileSwipeToClose — per-overlay responsive overrides. Below MobileBreakpoint (default 768px = Tailwind md) the Mobile* fields take precedence. OverlayProvider re-renders reactively on viewport crossing — sheet flips correctly when a tablet is rotated mid-flight.

Improved

• Swipe gesture (Sheet + Drawer) — previously the element followed the finger from pixel 1 with no axis lock; users reported the sheet felt wackelig on micro-movements and accidentally engaged on diagonal scroll attempts. Now: 10px activation deadzone (finger must commit before the sheet moves), direction lock at activation (gesture locked to the dominant axis — diagonal-on-bottom-sheet scrolls content instead of dismissing), and rubber-band past 150px so the sheet doesn't fly off-screen when the user keeps pulling. Dismiss threshold (100px) unchanged.
• Docs parameter coverage now 100% across all 163 components — 504 missing API table rows added across 60 pages (largely Chart components which previously documented their core 5 params but not the recurring Width/Height/Theme/ColorPalette/AnimationDuration/MarkLine/MarkPoint/Toolbox surface).

Docs

• Hero badge bumped to v2.1.3.
• OverlayService page: OverlayOptions table gains the four Mobile* rows; new "Responsive sheets" section with the desktop-Right ↔ mobile-Bottom example.
• Sheet page: cross-reference to IResponsiveService for live-reactive sizing decisions.
• New IResponsiveService docs page covering the API and the recommended subscription pattern.

Fixed

• DataGrid column filter popover now renders with position:fixed instead of position:absolute. The popover is pinned to the trigger via Interop.PositionFixed (same path as PopoverContent), so its layout box no longer contributes to the scroll container's scrollWidth.

Improved

• Filter popover click-outside dismiss — previously the popover only closed via Apply / Clear; clicking elsewhere left it open. Now registers a click-outside listener (excluding the trigger so the toggle button doesn't immediately close-then-reopen) and follows the trigger on grid scroll/resize.

Fixed

• DataGrid layout persistence: SnapshotCurrentLayout and BuildLayoutSnapshot now capture _runtimeGroupFields; ApplyLayoutAsync / ApplyLayoutSnapshotAsync restore the panel chips. Internal DataGridLayout + public DataGridLayoutSnapshot gain GroupByFields; snapshot version bumped 1 → 2. v1 payloads still load via the legacy single-level GroupBy fallback.
• DataGrid column filter popover: custom FilterTemplate rows with hover:bg-accent painted past the rounded-lg corners. DataGridColumnFilter wrapper gains overflow-hidden; w-64 → min-w-64 so wider templates grow the popover instead of overflowing.

Improved

• Sheet Size="Full" on Top/Bottom: now produces a true mobile-fullscreen sheet (inset-y-0 h-full max-h-full) instead of being a silent no-op. Sm/Lg/Xl cap height at 40/70/85vh for symmetry with Left/Right width caps. Default keeps legacy content-driven height — back-compat.
• OverlayService OverlayOptions.SwipeToClose: programmatically-opened Sheets can now be swipe-dismissed, matching the declarative <SheetContent SwipeToClose="true"> path. Drawers already had swipe-close by default; this puts Sheets at parity. Default false — back-compat.

Docs

• DataGrid page: Persistence demo description and "Saving and loading layouts" prose now mention the group panel is included; Version: 2 noted alongside the v1-backcompat clause.
• Sheet page: Size row now documents the Top/Bottom height behaviour and the Full-on-Bottom mobile-fullscreen pattern.
• Overlay Service page: SwipeToClose added to the OverlayOptions API table.

Improved

• DataGrid ServerMode: GroupByFields (multi-level) now applies to server-returned items.
• DataGrid group panel (ShowGroupPanel="true"): drag-to-group, add-level dropdown, per-chip remove, and clear-all all fire in ServerMode without an extra server round-trip.
• Per-page semantic preserved: grouping runs over the rows the server returned for the current page. For cross-page grouping, either disable pagination (ShowPagination="false") so the server delivers all rows in one response, or have the server pre-aggregate groups itself. This is a consumer-side architecture choice, not a grid limitation.
• Side benefit: ServerMode single-level grouping now also computes per-group aggregates (was previously client-mode only) because the unified path runs through ProcessSingleLevelGrouping.

Docs

• DataGrid component page: new ServerMode-grouping callout above the Server-Side Mode demo; GroupBy + GroupByFields parameter rows clarified; "Group panel & multi-level grouping" section gains a per-page-caveat paragraph.
• MCP registry description updated across registry.json, registry-search.json, registry/data-grid.json, components-api.json, and skills catalog to advertise "multi-level group (client + server)".

Fixed

• RazorParameterScanner: only parsed the LAST @code block, silently dropping all 14 of FileManager's [Parameter]s. Now parses every @code block independently and merges results — so Checkbox's markup-bearing RenderFragment block no longer corrupts extraction.
• RegistryGen version source: now reads the lockstep <Version> from Directory.Build.props instead of two hardcoded literals (one was still 2.0.0-rc.38) — registry can't drift again.
• Stale install snippets in docs: the Code component demo and CLI docs page hardcoded --version 2.0.0. RegistryGen pulls the Code example into components-api.json, so MCP clients got stale guidance — the exact bug class this release fixes. Bumped to 2.0.1.

Changed

• Lockstep bump: Directory.Build.props 2.0.0 → 2.0.1; tools/lumeo-mcp package.json + index.ts → 2.0.1.
• Regenerated registry: 149 components, 3510 params, 104 enums, 59 records, 0 parse failures. Skill catalog auto-resynced via sync-skill-catalog.yml.

Release prep — blockers

• README: replaced the release-candidate callout with stable-2.0 language; pinning guidance updated to 2.0.0+.
• Companion package drift: tools/Lumeo.Cli and templates/Lumeo.Templates had a hardcoded 2.0.0-rc.16 (38 RCs behind). Removed the override so both inherit the lockstep Directory.Build.props version.
• MIGRATION.md: documented the rc.53 IComponentInteropService.RegisterCarouselSwipe scrollHandler signature change (Func<double,double,Task> → Func<double,double,int,Task>) as breaking change #6.

Release prep — Codex findings

• npm audit clean at --audit-level=high: tools/lumeo-mcp went from 4 vulns (1 high via express-rate-limit → vulnerable ip-address) to 0; docs/Lumeo.Docs from 1 high to 0.
• SECURITY.md: supported-versions table, private disclosure channels (GitHub Security Advisories + [email protected]), response SLAs, scope, and dependency-hygiene statement.
• Package READMEs: all 9 packable projects now set <PackageReadmeFile>README.md. Shared packing rule centralised in Directory.Build.targets (not .props — .props is imported before the project body so the conditional wouldn't see PackageReadmeFile). Zero NU5039.

Open-source declutter

• Removed 25 internal audit docs from loose docs/*.md (release-readiness iterations + business-sensitive market-gap-analysis). User-facing docs at docs/Lumeo.Docs/ untouched (632 files). Gitignored the path so internal notes can't re-enter the published tree.
• Removed docs/superpowers/: 146 files of internal AI-workflow scaffolding (audits, implementation plans, workspace matrices). Preserved in git history.
• Removed scratch build-dump txt files: _p2.txt, build_lib.txt, etc. — accidentally tracked stdout dumps. Gitignored the patterns.
• Dropped stale .github/SECURITY.md: still claimed pre-1.0 status. GitHub resolves .github/ over root, so the Security tab was showing the outdated policy. Removing the duplicate makes GitHub fall back to the canonical root file.
• README refreshed for stable: PackageReference examples 2.0.0-rc.54 → 2.0.0; component count consistent at 145; stale "~530 KB" core-size claim replaced with a link to the live /docs/bundle-facts page.

Fixed

• ToastClose focus ring: focus:ring-1 (1px, no color) → focus-visible:ring-2 ring-current ring-offset-1 — visible on every variant including Destructive/Success/Warning/Info (ring-current inherits text color → contrast guaranteed).
• ToastClose keyboard reveal: focus-visible:opacity-100 ensures keyboard focus surfaces the X on desktop (was opacity-0 sm:group-hover:opacity-100, invisible to keyboard users).
• ToastClose affordance: hover/focus background (bg-foreground/10) + text-color shift instead of just an opacity tween.
• ToastViewport mobile collapse: all 6 positions now collapse to bottom-center with inset-x-4 (16px gutters) below the sm breakpoint. Width is w-auto sm:w-full sm:max-w-[420px] — mobile fills gutters, desktop caps at 420px. Developer-chosen position takes effect unchanged from sm: upwards.

Fixed

• Tabs swipe re-registration: gated on firstRender + one-shot flag; in Active render mode the panel DOM is recreated on every switch. Replaced with bidirectional _swipeAttached tracking — OnAfterRenderAsync now re-attaches whenever the panel becomes active.
• Calendar swipe re-registration: same root cause when switching view to Months/Years and back to Days. Same _swipeAttached pattern; swipe stays scoped to Days view by design.
• Carousel touch jitter: on release, browser scroll-snap momentum AND an imperative scrollIntoView({behavior:smooth}) fired simultaneously, producing visible jumps. Removed the touchend listener — native scroll-snap handles release smoothly. onScroll now reports the nearest snapped index back to .NET to keep _currentIndex in sync.
• Toast mobile padding: 44px close button overlapped toast text because content padding was a fixed pr-6. Changed to pr-11 sm:pr-6. Close button flush to corner on mobile (right-0 top-0), offset on desktop.
• PullToRefresh DevTools: DevTools mobile emulation reports pointerType='mouse' and drops pointermove events when the pointer drifts outside the element. Added setPointerCapture on pointerdown so the move stream stays alive.
• Chip dismiss X: replaced rc.49's negative-margin hit-area trick with a before:absolute pseudo-element — visual size back to a compact 20×20 px X with no visible padding sprawl.

Changed (internal)

• BREAKING (internal API): IComponentInteropService.RegisterCarouselSwipe scrollHandler signature changed from Func<double, double, Task> to Func<double, double, int, Task> (added current snap index). Only caller is Carousel.razor; no external consumers expected.

Docs polish

• TouchRipple: new "When to use TouchRipple vs Button's built-in ripple" Alert + canonical demo wrapping a Card with three tappable list rows.
• SafeArea: realistic sticky bottom-tab-bar demo pinned above the iPhone home indicator via SafeArea Bottom="true".
• Pagination: demos wrapped in overflow-x-auto containers + mobile-tip Alert pointing to the Compact variant.

Added

• Tabs — SwipeEnabled / SwipeWrap params. Horizontal swipe on TabsContent switches panels (50px threshold, 30px vertical guard, touch-action: pan-y, interactive-child bailout). New registerTabSwipe JS helper.
• Calendar — SwipeEnabled (default true) on the day-grid navigates between months; chevrons bumped to h-11 w-11 sm:h-7 sm:w-7 for WCAG 2.5.5. New registerHorizontalSwipe JS helper.
• ImageGallery — GesturesEnabled (default true). Fullscreen viewer pinch-zoom reuses Image.Zoomable pipeline; horizontal swipe navigates prev/next.
• Switch + Checkbox — opt-in HapticFeedback param (default false). Fires HapticsService.Light() on toggle — establishes the cross-cutting haptic-opt-in convention for more inputs in rc.53.
• Pagination + Stepper 44×44 targets: PaginationItem h-9 w-9 → h-11 w-11 sm:h-9 sm:w-9; Stepper invisible hit-area trick (p-1.5 -m-1.5 sm:p-0 sm:m-0) so the visible 32px dot expands to ~44px tap target on touch.
• /docs/mobile — Mobile Playground: hands-on demos of every gesture, haptic primitive and hit-target retrofit. One page to test the whole mobile stack.

Docs

• Sheet page: replaced single Bottom swipe demo with a 4-side interactive demo (Top quick-actions, Right edit-form, Bottom filter-list, Left navigation). Updated SwipeToClose API description to reflect all 4 sides.
• TabsPage / CalendarPage / SwitchPage / CheckboxPage / ImagePage: new Mobile-feature sections + API table rows.

Fixed

• NumberTicker background-tab freeze: defer start = now until the first step() callback. Standard RAF pattern; zero-cost for foreground-loaded tabs. Verified live on /docs/bundle-facts.
• NoopInteropService (Docs.Tests): added the missing rc.49 APIs (RegisterPinchZoom/UnregisterPinchZoom, GetScrollTop, WheelScrollTop, WheelScrollTo). Without these the Docs.Tests project failed to compile — surfaced as red CI on rc.49/50/51 (Publish/Deploy stayed green so packages and docs were online; only CI was noisy).

Added — new components

• PullToRefresh: wraps scrollable content; pointer-driven pull-down gesture with spinner fade + rubber-band; OnRefresh fires after threshold. v1: requires the wrapper itself to be the scroll container.
• SwipeActions: iOS Mail.app pattern with LeadingActions / TrailingActions RenderFragment slots. Foreground translates horizontally on swipe; locks open at ActivationThresholdPx; vertical-scroll passthrough. v1: fixed 160px open width.
• SafeArea: CSS env(safe-area-inset-*) wrapper for notch/system bars. Per-side toggle params; no JS.
• TouchRipple: Material-style ripple. PointerDown spawns positioned span with CSS animation. Custom Color/Opacity/DurationMs. CTS-cancelled Task.Delay cleanup on Dispose.
• HapticsService: facade over Interop.Vibrate(int). Light/Medium/Heavy/Success/Error semantic presets. Registered in AddLumeo().

Added — picker variants

• DatePicker Variant=Wheel: 3-column iOS-style wheel (day/month/year). Culture-aware month names; Min/Max year range; day re-clamps when month/year changes (no Feb 30).
• TimePicker Variant=Wheel: hours/minutes + AM/PM column when 12h. Honours CurrentCulture.AMDesignator; MinuteStep snap.

Added — interop + CSS

• Interop: GetScrollTop(elementId), WheelScrollTop(elementRef), WheelScrollTo(elementRef, scrollTop). Reuses Vibrate(int) from rc.49.
• CSS: .lumeo-touch-ripple + keyframes; .scrollbar-none utility (Firefox + WebKit).

Added — gestures

• Sheet: swipe-to-close (opt-in via new SwipeToClose param, false-default to avoid conflicts with scrollable content inside Bottom sheets).
• DataGrid: column resize via pointer events with setPointerCapture.
• Slider: thumb tooltip on touch-drag (@onpointerenter/leave).
• Rating: iOS-style touch-drag-to-scrub across stars.
• ContextMenu: long-press path (500ms timer, 10px move tolerance, haptic via navigator.vibrate(50)).
• Image: new Zoomable param — pinch-zoom via two-pointer tracking, scale-delta dispatch, clamped to [0.5, 5.0].

Added — 44×44 hit-target audit (WCAG 2.5.5)

• Window title-bar buttons (Close/Min/Max/Restore), resize handle.
• Chip dismiss button, TabsTrigger close X, DialogContent close X, SortableList drag handle, SidebarMenuButton row.
• ToastClose with mobile visibility fix — was opacity-0 hover-only, now opacity-100 sm:opacity-0 sm:group-hover:opacity-100.
• DropdownMenuItem + ContextMenuItem rows: min-h-11 sm:min-h-0.
• Pattern: full 44px hit area on touch (no sm:), compact original size at sm: and up. Icon sizes unchanged so desktop visual density is preserved.

Fixed (caught by review-agent before tag)

• Rating mouse double-fire: pointerdown was firing for mouse too, causing ValueChanged to double-fire with AllowHalf=true. Fixed via e.PointerType=='mouse' early-return.
• ToastClose invisible-but-blocking on mobile: opacity-0 hover-only with 44px hit area was capturing taps on the toast title. Fixed via responsive opacity-100 sm:opacity-0.
• Pinch-zoom 3-finger baseline drift: lastDistance now re-baselined on 3→2 transition.
• Sheet swipe-vs-scroll conflict on Bottom sheets: SwipeToClose now opt-in.

Added

• Section 8 "Hot Reload that actually works" with 6 concrete facts, each paired with a "what other libs do" contrast so the comparison is grounded:
  1. No Blazor CSS isolation (Tailwind utility-first, no per-component scoped-class hashing).
  2. Theme is CSS variables, not a C# object (no recompile to swap colors).
  3. No source generators in runtime hot path ([LumeoForm] is opt-in).
  4. No reflection in render path (rc.44 compiled-getter fix).
  5. CascadingValue composition over inheritance — each Razor file HRs independently.
  6. Tailwind + Razor SDK watch run in parallel; CSS swaps don't go through Blazor at all.
• Why-brotli-not-nupkg Accordion rewritten with a 3-row comparison block (1.35 MB pre-rc.40 → 660 KB post-rc.40 → 400 KB brotli to browser) and a link to nuget.org/packages/Lumeo for self-verification.

New page sections

• Hero — animated NumberTicker hitting 400 KB inside a Sparkles overlay.
• Per-package bar chart — 7 staggered BlurFade rows showing proportional brotli sizes.
• What's actually in the .nupkg — 4 cards explaining Lumeo.dll / lumeo.css / components.js / build-props.
• "What's NOT in core" Marquee — endless strip of deliberately-excluded dependencies (Newtonsoft.Json, AutoMapper, jQuery, etc.).
• Comparison table vs MudBlazor / Radzen / FluentUI / Telerik (approximate brotli sizes).
• Heavy features are opt-in — 3-tile Bento for Charts / DataGrid / Editor.
• Why brotli not .nupkg — Accordion with 3 explainers.
• CTA footer — ShimmerButton to /docs/installation.

Home.razor

• Removed the entire <Dialog @bind-Open="_bundleSizeDialogOpen"> block (~72 lines).
• Replaced the trigger button with <Lumeo.Link Href="/docs/bundle-facts"> wrapping the existing "~400 KB core" text.
• Removed the now-orphan _bundleSizeDialogOpen field.
• Sidebar nav nav-config.json gained a "Bundle Facts" entry under getting-started.

Fixed

• Window: Math.Clamp(0, -40) crash on drag-during-init. The rc.44 viewport-aware drag clamp could be invoked before _viewportHeight finished loading from JS (or in non-WASM contexts where the JS interop returns null). When zero, Math.Clamp(_dragStartPosY + dy, 0, _viewportHeight - TitleBarHeight) resolved to Math.Clamp(value, 0, -40) → ArgumentException. Fix mirrors the ClampPosition() guard: if viewport is unknown, fall back to lower-bound-only clamp (pre-rc.44 behavior).
• LumeoForm generator: InvalidCastException setting Button.type on the submit button. The generator emitted AddAttribute("type", "submit") — lowercase HTML attribute name + string value — but Lumeo.Button.Type is a strongly-typed ButtonType enum (Button/Submit/Reset). Fix: emit AddAttribute("Type", global::Lumeo.Button.ButtonType.Submit).

A — Carry-overs from rc.43

• Window drag-clamp (viewport-aware): new Interop.GetViewportSize() + ClampPosition() keeps the title bar inside the viewport on all four edges (MinVisible=50px, TitleBarHeight=40px). Consumer-set InitialX=9999 is now clamped on first render.
• RTL ArrowKey-swap: Carousel, Stepper, Tabs, Splitter now respect ThemeService.CurrentDirection == LayoutDirection.Rtl and swap ArrowLeft↔ArrowRight for horizontal navigation.
• Scheduler: lumeo:theme-changed listener re-renders active calendars; OnInitError callback surfaces FullCalendar bundle-load + Calendar-constructor failures.
• Gantt: OnInitError callback added (matches Chart/Scheduler pattern).

B — LumeoForm generator design + Visual Diff

• LMF001: read-only / init-only properties now emit a Roslyn diagnostic explaining they're excluded.
• LMF002: unsupported types (collections, custom refs) emit a diagnostic suggesting [LumeoFormIgnore] or TagInput override.
• New [LumeoFormIgnore] attribute + [NotMapped] recognition suppress diagnostics on properties that should be excluded silently.
• Visual Diff: HomePageVisualTests now uses ImageSharp perceptual compare (0.5% tolerance, Manhattan RGBA > 30). CI skip removed — test runs everywhere.

C-Audit Findings + Fixes

Localization (7 HIGH)

• Delta stops hardcoding InvariantCulture — German users now see +12,5 %. KPI cards across all dashboards inherit.
• DateRangePicker.Format default "MMM dd, yyyy" → null, resolves to CurrentCulture.ShortDatePattern.
• TimePicker.Use24Hour bool → bool? → null derives from CurrentCulture.ShortTimePattern. Hardcoded "AM"/"PM" → AMDesignator/PMDesignator.
• DataGrid plurals (RU/PL/AR-aware): new LumeoPlurals.PluralKey(count, baseKey, culture) helper — returns .One/.Few/.Many/.Other based on language rules. DataGrid.ItemsCount uses it. EN/DE/PL/RU/AR translations supplied.
• Stepper.* and Window.* translations added to all 13 non-English locale dicts — half the strings were silently falling back to English.
• DateTimePicker now forwards FirstDayOfWeek to inner Calendar.
• Hardcoded English aria-labels in NumberInput, Input, Window, Slider, FileManager, FileUpload, DateTimePicker routed through ILumeoLocalizer. Keys added to all 14 locales.

Performance (5 HIGH)

• DataGridColumn.GetValue now uses compiled Expression<Func<TItem,object?>> getters cached per field. ~10× faster than the old PropertyInfo.GetValue. Supports nested paths (Address.City) with null-safe chain.
• DataGridRow + DataGridCell CssClass memoization: tuple-keyed cache. 1k rows × 10 cols = 10k+ string allocations per render → ~1 per row+cell on state change.
• Context.VisibleColumns exposed on DataGridContext<TItem> — eliminates per-row Columns.Where(c => c.Visible) LINQ.
• ComboboxContent.FilteredItems: property → memoized backing field invalidated on Items/SearchText change. 10k-item dropdowns no longer re-filter 3× per render.
• PivotGrid skip-rebuild gate (_lastItemsRef + dims hash) — eliminates full tree-rebuild on unrelated parent re-renders.

Blazor Server + Touch + Disposal

• 9 components wrapped their first-render JS interop in try/catch (JSDisconnectedException, ObjectDisposedException): Affix, BackToTop, Carousel, Scrollspy, ResizableHandle, OtpInput, ConsentBanner, PromptInput, AgentMessageList.
• TabsList prerender measurement guarded against InvalidOperationException (Blazor prerender).
• Keyboard shortcut Map cleared on registerKeyboardShortcuts entry — no more stale entries leaking across Blazor Server circuit reconnects.
• P0 mobile fix: registerClickOutside now binds touchstart (with { passive: true } + 600ms synthetic-mousedown dedupe). Tap-outside now closes every Dropdown, Combobox, Select, Popover, ColorPicker, ContextMenu, DatePicker, TimePicker on mobile.
• SortableList touch reorder: new registerSortableTouch JS helper with elementFromPoint drop detection. Mouse path unchanged (still uses HTML5 Drag API).
• Tooltip + HoverCard tap-to-pin: tap toggles pinned state; click-outside unpins via the now-touch-aware registerClickOutside.
• NavigationMenu + MegaMenu: @onmouseenter/leave → @onpointerenter/leave with e.PointerType == "mouse" guard. Submenus no longer close on touch liftoff before the user can tap a sub-item.

Deferred to v2.1 (breaking-change release)

• API consistency renames: Stepper.ActiveStep → CurrentStep, Multi-value collection type unification (HashSet/List/IEnumerable), Values → SelectedValues, SidebarProvider.IsCollapsed → Collapsed, Size enum harmonization. These are breaking and need consumer migration.

A11y (12 fixes — interactive components keyboard navigation)

• Carousel arrow-keys now preventDefault — page no longer scrolls when the carousel handles ArrowLeft/Right.
• Roving tabindex on MenubarTrigger, Rating, TreeViewNode (focused-node tracking), Stepper step buttons. Toolbar container gets tabindex="0" so screen readers announce "toolbar".
• SplitterDivider now resizable via ArrowKeys (±10px delta per press, horizontal/vertical based on orientation).
• Focus management on open/close: Mention/Cascader return focus to trigger on close; Cascader focuses first option on open.
• ContextMenuTrigger now activates on Shift+F10 / ContextMenu key for keyboard users.
• OtpInput Backspace stopsPropagation so it can't accidentally trigger SPA back-navigation.

RTL (10 fixes — full right-to-left support)

• Carousel (Next/Previous/Content/Item), Combobox input, DatePicker (5 hardcoded directions), Select / SelectTrigger migrated from hardcoded ml-/mr-/pl-/pr-/left-/right-/border-r/border-l to Tailwind logical properties (ms-/me-/ps-/pe-/start-/end-/border-s/border-e).
• Directional chevrons on Carousel, Pagination, Breadcrumb now flip in RTL via [dir=rtl]:rotate-180. Arrow-key handler RTL-swap deferred (separate concern; tagged with TODO).

Theme + Dark Mode (5 fixes — ColorPicker is now dark-mode-correct)

• ColorPicker slider thumbs: background: #fff → var(--color-background). White thumbs were invisible against light-colored hues in dark mode.
• ColorPicker checkerboard (transparency visualization): hardcoded rgba(0,0,0,0.08) → color-mix(in srgb, var(--color-muted) 60%, var(--color-background)). Visible in both modes.
• ColorPicker SV-indicator shadow uses theme-aware color-mix(... var(--color-foreground) ...). The white-on-canvas border itself is kept (correct against any swatch color).
• ThemeSwitcher: stale-default-on-first-render fixed via OnInitializedAsync. UI shows the real current scheme/mode immediately.
• ThemeService.ToggleModeAsync: now cycles System → Dark → Light → System (was binary Light↔Dark and permanently lost System mode on first toggle). 3 tests updated to match the new cycle contract.

Async / Memory (4 fixes — leak elimination)

• FileUpload now implements IAsyncDisposable — disposes all in-flight CancellationTokenSources in _cancellations on unmount. CRITICAL: every upload running at page-navigate previously leaked a CTS.
• FileUpload batch staleness: _currentBatchId counter — old slow batches can no longer fire OnAllUploaded after a newer batch has started.
• TreeSelect.OpenDropdown: post-await disposal guards. Setting _registered=true after a disposal-during-Interop is now impossible.
• Mention.HandleBlur: 150ms Task.Delay now uses a CancellationTokenSource — re-focusing inside the window cancels the pending hide.

Heavy Wrappers (RichTextEditor — 2 real fixes)

• Silent init failure surfaced: JS wraps new Editor() + TipTap bundle load in try/catch with descriptive errors. C# catches JSException, sets _initError, renders an error card, and invokes new OnInitError callback. Matches the pattern Chart.razor already used.
• Orphan suggestion DOM cleanup: suggestion popups are now tagged with data-rte-id; destroy(id) hunts them down explicitly. No more dangling popups in document.body after unmount-mid-suggestion.
• FALSE ALARM verified: theme-unaware inline styles. The audit thought style.cssText was baked at init — but the strings use var(--color-*) references, which browsers re-resolve on every paint. Already theme-aware.

Forms + Source Generator (4 fixes)

• LumeoForm generator: non-null enum no longer emits model.Prop?.ToString() (CS0023). Nullable-aware emit handles both MyEnum and MyEnum? correctly.
• LumeoForm nullable-enum clear: when user clears the Select, the property goes to null for nullable enums. Was: silently kept the old value.
• LumeoForm DateTimeOffset: invalid (DateTime?) cast replaced with .DateTime accessor; original .Offset is preserved through the round-trip. Was: timezone silently stripped.
• FormField now reads errors from a cascaded FormContext parameter — Form.Reset() now actually clears children's visible error state. Was: child kept showing the old error.

False alarms cleared (11)

• DropdownMenuItem: tabindex="-1" + parent-driven FocusMenuItemByIndex is the correct WAI-ARIA menu pattern, not a bug. ColorPicker HSV gradients: hardcoded white/black are color-space primitives, not theme colors. Charts: full theme-change listener and resize observer already in place. Gantt: CSS variables read on every render — passive theme support is intentional. Combobox/Select/Carousel/InplaceEditor/Stepper/Cascader async paths: all guarded correctly. FileUpload didn't have a leak we expected — actual leak (no CTS dispose on unmount) is the one we fixed instead.

Fixed

• Toolbar overflow was completely broken at runtime. Toolbar.razor called observeToolbarOverflow but toolbar.js only exported observeToolbarWidth / measureToolbarChildren — the function the component depended on didn't exist. Overflow="true" VisibleCount="-1" users got zero auto-collapse. Implemented the missing function (full ResizeObserver + child-width measurement + fitting-count computation in JS), switched C# to InvokeVoidAsync with a stable per-component DOM id.
• ToastOptions.Position (rc.37 API) was silently ignored. The per-toast position override existed in ToastService but ToastProvider.razor rendered every toast into a single <ToastViewport Position="Position"> — the provider's default. Now toasts are grouped by their effective position (options.Position ?? defaultPosition) and rendered into one viewport per group. Multiple position:fixed viewports coexist without overlap.
• TreeView lazy-loaded children inherit parent's check state (bonus). When LoadChildren resolves, freshly-loaded children now inherit a fully-checked parent's state. Previously a checked parent would expand to reveal unchecked children — a visibly broken tri-state. Indeterminate parents recompute correctly when newly-loaded children land in their default state.

Tests

• New DataGridGroupPanelTests.cs — 8 bUnit tests covering the rc.41 group-panel fixes: panel render, Groupable-only dropdown filtering, Add/Remove/Clear behavior, and the specific "add after clear still works" regression that the user reported.
• All 8 pass green; one assertion was tightened from a panel-wide string match (which falsely included the "+ Add level" dropdown options) to a chip-span selector.

False alarms (audit findings that turned out to be FINE)

• Sortable cross-container drag has OnDragEnd as a state-reset belt regardless of drop. TreeView MultiSelect cascade is correct (tri-state computed via UpdateAncestorStates). DataGrid virtualization is bypassed when grouping is active (no row-skip risk). Column-reorder during grouping is safe — fields are stored as strings, not indices. Combobox/Select filter clears on close. Tabs uses value-based active state, no index drift. Stepper's HandleStepClick guards via CanClickStep. Splitter uses pointer events (touch works). Sheet/Drawer scroll-lock is refcounted. DateRangePicker provides visual feedback for inverted ranges. InplaceEditor's Esc-vs-blur race is synchronously guarded. PivotGrid handles empty data without NaN.

Deferred

• Window component drag can push the window below the viewport (no upper-bound clamp on _posY). Clean fix needs viewport-aware JS interop — queued for rc.43. Workaround: don't drag the window far enough off-screen to lose it.
• Splitter divider is keyboard-focusable but ArrowKey resize is missing (a11y gap). Same sprint.

Fixed

• Drag-to-group now actually works. Column headers with Groupable="true" are HTML5-draggable whenever ShowGroupPanel="true" on the grid — independent of Reorderable. The panel now has full @ondragover / @ondrop handlers and lights up border-primary bg-primary/10 when a valid Groupable column is dragged over it. Drops on non-Groupable columns (or columns already grouped) are rejected silently.
• Re-grouping after clearing all levels works again. The "+ Add group level" <select>'s native DOM value was sticking on the last-picked option, so after the second add the placeholder ("+ Add group level") wouldn't re-render and the dropdown felt frozen. @key on the select now forces a fresh DOM element each time the group-fields count changes.
• Added a "Clear" button next to the panel chips for one-click reset to ungrouped. Cleaner than chip-by-chip removal.
• DataGridContext gained ShowGroupPanel: bool so header cells can decide on their own whether to be drag-source-eligible without extra plumbing.

No API break

• The DataGridContext<TItem> record gained one new positional field — only code that constructs the context manually would break, and the only such caller is DataGrid.razor itself (consumer Razor pages cascade-read it).
• Existing single-level GroupBy="..." demos and multi-level GroupByFields=@(...) usage are unchanged. The interactive demo on the DataGrid page now genuinely shows the panel feature.

Result

• Lumeo.nupkg: 1,405,580 B → 672,193 B (−52%, −733 KB). Back below the rc.20 baseline. NuGet UI now displays a sensible package size that matches the actual browser footprint story instead of three times it.
• Browser-shipped bytes unchanged. Brotli-compressed Lumeo.dll is still ~400 KB — nothing about the runtime payload moved. The 733 KB savings come entirely from dev-time-only assets.

What changed

• src/Lumeo/wwwroot/registry/ deleted (146 JSON files). RegistryGen now writes per-component snippets to docs/Lumeo.Docs/wwwroot/registry/ only — that's the canonical CDN source consumed by lumeo add + MCP via https://lumeo.nativ.sh/registry/<slug>.json.
• Lumeo.csproj: removed the SyncRegistryIntoWwwroot MSBuild target and added a <None Include="registry\registry.json" Pack="false" /> so the master index stays in source control but never gets packed.
• deploy-cloudflare.yml: the per-component-registry copy step now reads from docs/Lumeo.Docs/wwwroot/registry/ instead of the now-deleted src/Lumeo/wwwroot/registry/. (Mostly a no-op because the SDK already publishes that folder, but kept as a safety net.)
• Registry doc page: the "Raw JSON" link now points at /registry.json (Cloudflare-served from docs/Lumeo.Docs/wwwroot/registry.json) instead of the now-dead /_content/Lumeo/registry/registry.json URL.

Consumer impact

• None. Runtime apps don't reference the registry JSONs (their registryUrl already pointed at the CDN, not /_content/Lumeo/registry/). The Lumeo.CLI's default URL was already https://lumeo.nativ.sh/registry.json — no behavior change.

Docs site — closing the demo coverage gaps

• DataGrid ShowGroupPanel interactive demo. The group-panel + multi-level grouping features had docs prose + an API table but no live preview. New demo with Segmented toggles for panel on/off and single-vs-multi-level grouping (Department → Status with per-group salary average).
• Animation & visual sliders (5 pages): AnimatedBeam (Curvature, DurationMs), BlurFade (DelayMs, BlurPx + Replay), Barcode (Height, BarWidth), BackToTop (VisibilityThreshold), Affix (anchor + Offset).
• Input controls (5 pages): Pagination size, OtpInput Length (4/6/8), PasswordInput ShowStrength + ShowToggle, NumberInput Step + Precision, Mention Trigger character.
• Variants & modes (4 pages): PopConfirm IsDestructive, ToggleGroup PressEffect (None/Scale/Brightness/Ripple), Toggle icon+text slot toggles, ShimmerButton size — single live preview not side-by-side.
• Display + event-feedback (7 pages): Textarea ShowCount counter, TextReveal Threshold scroll-trigger, Timeline ActiveIndexChanged binding, TreeView OnItemClick, Transfer OnChange, AgentMessageList Role switcher, Tooltip Side demo refactored to compound <SegmentedItem> pattern.
• Two audit findings sauber geskippt: Pagination has no Size enum, Menubar has no Orientation parameter — fix-agents refused to invent the API. Pagination size demo done via PaginationItem Class= sizing instead.

Home — honest bundle stats

• "~530 KB core" → "~400 KB core" everywhere on the homepage, with full disclosure: this is the brotli-compressed assembly size, which is what the browser actually downloads — what every other Blazor lib means when it quotes a number. Measured 2026-05-13 on rc.38: Lumeo.dll brotli ≈ 403 KB, Charts 120 KB, DataGrid 100 KB, Editor 26 KB, Motion 18 KB, Scheduler 16 KB, Gantt 12 KB.
• Why the .nupkg shows ~1.35 MB: the package bundles ~4 MB of shadcn-style component source registry for the Lumeo CLI (staticwebassets/registry/*.json) plus the pre-compiled Tailwind utility snapshot. None of that is sent to end users' browsers — disclosed in the bundle-size dialog and in the bento footer footnote. (Moving the registry to CDN-only is queued for rc.40 — would bring the .nupkg back under 600 KB.)

• New SegmentedItem compound sub-component. The rc.37 doc-coverage sweep used <SegmentedItem Value="..."> children inside <Segmented> on ~10 interactive-preview demo pages — that's the shadcn-style composition the rest of the library uses (SelectItem, TabsTrigger, …) and the natural reach. But Segmented only had the Options="List<SegmentedOption>" data-driven API — so docs built locally but CI's -warnaserror failed with RZ10012 "unexpected element 'SegmentedItem'". Added the compound sub-component (cascading SegmentedContext, styling identical to Options-mode). Both APIs now coexist; consumers can pick whichever reads better.
• Changelog.razor: escaped a literal @page reference in the rc.37 entry that was being parsed as a Razor directive — broke the docs build for CI / E2E / Cloudflare. Now @@page in source → renders as @page in the page.

Docs site — interactive previews everywhere

• Every [Parameter] typed as an enum with ≥2 values now has a "Variant (interactive)" section on its component's doc page — a <Segmented> (or <Slider> for numeric tunables) bound to a state field driving a live component, so readers can flip between values and see the difference in real time.
• ~50 new interactive previews across Forms (Button Variant/Size, DatePicker Mode, FileUpload Variant, Rating Size, Toggle/ToggleGroup, …), Navigation/Overlay (Tabs Variant/Orientation/RenderMode, Sheet/Drawer Side, Stepper Orientation, Carousel Orientation, BottomNav Variant, MegaMenu, Splitter, Sidebar, AppBar, Popover/Tooltip Side+Align), Data Display (Steps Orientation, Statistic Size/Variant, Sparkline Type, SparkCard, Timeline, Gauge Variant, Avatar Shape/Status, Badge Variant, Bento Gap, Chip Variant, ImageCompare, QRCode, ReasoningDisplay, ToolCallCard), Motion (Marquee Speed/Direction, BorderBeam Size+Duration sliders, ShimmerButton, Dock MaxScale/MagnifyRadius, NumberTicker target, Sparkles count, TextReveal speed), Feedback (Alert Variant, Result Status, Toast Variant+Position).
• API tables filled in: ~18 Forms pages were missing FormField integration rows (Required / Invalid / ErrorText / HelperText / Label / Name) — added. AnimatedBeam PathWidth and SortableList Key rows added.
• Pages that were entirely missing got created from scratch — every one of the 145 components now resolves at /components/<kebab-name>.

API additions

• ToastOptions.Position (ToastPosition?) — per-toast position override, complementing the existing ToastViewport.Position default. Powers the new ToastPage interactive position demo.

Hygiene

• Stripped UTF-8 BOMs from three Razor source files (DatePicker / DateRangePicker / DateTimePicker) — they were breaking the sitemap generator's grep '^@page' on the Cloudflare deploy.
• SplitterPage interactive demo: fixed a mixed C#+literal Class-attribute syntax error (RZ9986). FileManagerPage RemoveNode nullable-warning fix (CS8604 — would have failed an eventual docs -warnaserror).

DataGrid — batch / buffered edit mode

• Setting EditMode="DataGridEditMode.Batch" now wires up the full UI (the rc.35 scaffolding got fleshed out): edits go into a per-cell pending-changes buffer, dirty cells get a bg-warning/10 tint and warning-coloured left border, a "N pending changes" strip appears with Save all + Discard buttons.
• Save all fires OnBatchSave (DataGridBatchSaveEventArgs<TItem> with Modified + Added lists). On clean return the buffer clears automatically.
• ShowAddRow="true" + NewItemFactory render a "+ Add row" trigger. Public HasPendingChanges / PendingModifiedItems / PendingAddedItems for warn-on-navigate.
• New ColumnVirtualize="true" + MaxVisibleColumns (default 30) — caps how many columns are rendered for very-wide grids. (Real per-cell horizontal virtualization is a follow-up; this is the simpler "max-columns cap" approximation. Clipboard paste / fill-down / ShouldRender on cells are also deferred.)

PivotGrid — multi-level column hierarchy

• ColumnFields now nests properly. A two-level [Year, Quarter] example renders three header rows (Year — colspan'd across its quarters / Quarter — colspan'd across measures / Measure names), with correct rowspans on row-field corners and the grand-total column. Column-subtotals are deferred (row subtotals work).

Toolbar — automatic overflow measurement

• <Toolbar Overflow="true"> with the default VisibleCount=-1 now auto-measures via ResizeObserver — items that don't fit collapse into the "⋯" dropdown live as the container resizes. Manual VisibleCount still wins when set.

Localization — satellites sweep

• 71 new locale keys × 14 dictionaries = 994 entries. Chart (loading text), Scheduler (Today + view-switcher + "Week of {0}"), Gantt (view-mode labels), and RichTextEditor (toolbar + bubble menu + slash-command + AI-action menu — Bold / Italic / Heading 1–3 / Bullet+Numbered+Task list / Quote / Code block / Link / Insert image/table / Undo / Redo / Clear formatting / Improve writing / Make shorter / Make longer / Translate / Summarize / Fix grammar / placeholders / …) all now route through ILumeoLocalizer with translations in de / fr / es / it / pt / nl / pl / ja / zh / ko / ar / ru / tr.

CI

• publish-mcp now succeeds when the version is already on npm (typical on a release re-run after a sibling job failed) — checks for "cannot publish over" / "previously published" in npm's error and exits 0 instead of red. Any other publish failure still fails the job.

DataGrid

• Tree-grid mode — ChildItemsSelector turns the grid into a hierarchy: rows with children get an expand chevron, indented child rows, recursive. TreeGridDefaultExpanded, TreeColumnField, OnTreeNodeExpand; role="treegrid" + aria-expanded/aria-level. Distinct from the flat DetailTemplate.
• Group panel + group-level aggregates + multi-level grouping — ShowGroupPanel renders a chip bar; columns with Groupable can be added/removed/reordered there; GroupByFields for multi-level nested grouping; each group row shows the column Aggregates over that group.
• Scaffolding for batch-edit mode landed (DataGridEditMode.Batch, DataGridBatchSaveEventArgs<TItem>) — full UI wiring follows in the next release. Plus a fix for an AriaLevel/AriaExpanded regression from rc.34.

New components

• Gauge — single-value gauge, Radial/Arc/Linear variants, threshold colour bands, role="meter".
• RingProgress — circular determinate progress ring with an optional centre label or custom content.
• Barcode — inline SVG Code 128B barcode renderer (scannable), with optional human-readable text.
• Highlighter — wraps occurrences of one or more search terms in the text with highlight marks (CaseSensitive, WholeWord).
• FileManager — headless file/folder explorer: folder tree, breadcrumb path, list/grid views, lazy loading (LoadChildren), inline rename, context-menu operations (rename/delete/open). Drag-drop / upload / multi-select are deferred.
• QueryBuilder — visual AND/OR predicate-tree builder: recursive groups, per-type value editors, serializes to JSON and to a LINQ predicate (ToExpression<T>), ShowJsonPreview, MaxDepth.

Toolbar

• New Overflow + VisibleCount — collapse trailing items into a "⋯" dropdown. (Auto-measurement of which items fit is a follow-up; for now VisibleCount is consumer-controlled.)

DataGrid — keyboard navigation + grid ARIA

• Roving-tabindex cell navigation: arrow keys move the focused cell, Home/End = row ends, Ctrl+Home/Ctrl+End = corners, PageUp/PageDown = ±10 rows, ArrowUp from row 0 jumps into the header. Enter/F2 on an editable cell starts cell-edit; Enter while editing commits + moves down, Tab commits + moves right, Escape cancels. Space toggles row selection; Ctrl+A selects all (multi-select). Enter/Space on a sortable header cell sorts.
• Grid ARIA: role="grid" + aria-rowcount/colcount/multiselectable, role="row"+aria-rowindex/selected, role="columnheader"+aria-sort, role="gridcell"+aria-colindex/readonly. Focus ring on the active cell.
• Deferred: keyboard nav inside grouped/virtualised regions (cells still carry the ARIA roles there).

New component — PivotGrid<TItem>

• Cross-tab / pivot table: pivots flat data into a row hierarchy × column values × aggregated Measures (Sum/Average/Count/Min/Max). RowFields nest into a multi-level outline; per-group subtotal rows + a column grand-total row + a row grand-total column + the overall total. Collapsible row groups (chevron + aria-expanded), OnCellClick for drill-down, EmptyContent, Compact. Single column-field level for now (row hierarchy is fully nested).

Scheduler

• Recurring events via FullCalendar's free recurrence model — new SchedulerEvent.DaysOfWeek / RecurrenceEnd / ExceptionDates.
• Resource colour-coding: new SchedulerResource record + Resources param + SchedulerEvent.ResourceId — events inherit their resource's colour, with a legend above the calendar. (True resource-lane / timeline views need FullCalendar's premium plugin, which we don't bundle.)
• NowIndicator (default true), SlotMinTime/SlotMaxTime/SlotDuration, EventClassNames/EventColor callbacks.

Gantt

• Milestones — GanttTask.IsMilestone renders a diamond instead of a bar. Grouping/swimlanes — new GroupBy param + GanttTask.GroupLabel (sort + group-separator rows). TodayHighlight, BarHeight/ColumnWidth config, BarColor per-task colour callback. (Task dependencies were already supported; rendered as arrows.)

FileUpload — a real upload pipeline

• New OnUpload callback (Func<FileUploadItem, IProgress<int>, CancellationToken, Task<string?>>) — the component drives per-file state (FileUploadItem with Status Pending/Uploading/Succeeded/Failed/Cancelled, ProgressPercent, Url, ErrorMessage) with per-file progress bars, cancel + retry buttons, AutoUpload / MaxConcurrentUploads, validation rejections surfaced as failed items (+ OnFileRejected), and OnFileUploaded/OnAllUploaded/OnFileFailed events. Legacy Progress/OnFilesSelected still work.

Select / Combobox — data-bound mode (non-breaking)

• New Items / ItemValue / ItemText / ItemGroup / ItemDisabled / ItemTemplate params — bind options from a collection instead of writing <SelectItem>s by hand. Plus Virtualize + ItemSize for large option lists. Components stay non-generic (object-typed selectors) — composition mode unchanged, zero breaking changes.

Localization

• Kanban "Add card" and Carousel a11y labels ("Previous slide" / "Next slide" / "Slide N of M") now route through ILumeoLocalizer with translations in all 13 locales. (Audit found EmptyState/Result/Steps/Mention/AlertDialog have no hardcoded English to localise — their text is consumer-supplied or icon-only.)

New components

• ButtonGroup — joins <Button>s into a segmented bar with collapsed borders and rounded ends; Orientation Horizontal/Vertical.
• DropdownButton — a button whose whole click opens a dropdown menu of secondary actions (chevron indicator).
• SplitButton — split into a primary-action half (OnClick) and a chevron half that opens the dropdown.

Component upgrades

• DatePicker: forwards FirstDayOfWeek + ShowWeekNumbers to the inner Calendar; new Inline mode (always-open calendar, no popover).
• DateTimePicker: new MinDate / MaxDate / IsDateDisabled (forwarded to its Calendar).
• Toast: ToastViewport.Position (6 corners/centres) + MaxVisible; ToastOptions.Position for per-toast overrides.
• TreeView: big overhaul — lazy/async children (LoadChildren + IsLeaf / IsLoading), tri-state checkboxes with parent↔child cascade (CascadeCheck, IsIndeterminate, CheckedValuesChanged), custom NodeTemplate, disabled nodes (IsDisabled), ExpandAll + ExpandAllNodes()/CollapseAllNodes(), multi-select (MultiSelect, SelectedValues), role="tree"/treeitem ARIA + arrow-key navigation.

API tightening — string parameters became enums

• DatePicker.Mode: string → DatePicker.DatePickerMode (Single/Range/Month/Year).
• Tabs.Variant: string → Tabs.TabsVariant (Default/Card/Pill).
• FileUpload.Variant: string → FileUpload.FileUploadVariant (Dropzone/Button/Avatar).
• Calendar.InitialView: string → Calendar.CalendarView (Days/Months/Years).
• If you pass these as string literals (Mode="Range") update to the enum (Mode="DatePicker.DatePickerMode.Range"). @bind-style usages are unaffected.

Docs site updated: new pages for ButtonGroup / DropdownButton / SplitButton, API tables + demos refreshed on DatePicker / DateTimePicker / Toast / TreeView / Tabs / FileUpload / Calendar. 134 components, 2,226 unit + 31 RegistryGen tests green.

Correctness fixes

• DataGrid @key on every non-virtualised row/group/header/cell loop — sort/filter/page/group-toggle and column reorder no longer mis-diff: rows and cell-edit components stop re-initialising, sort indicators and open filter popovers stay attached to the right column.
• OverlayProvider keyed + stable references — closing one of several stacked overlays no longer makes the focus-trap / scroll-lock interop target the wrong element. The hosted-component cascade is now IsFixed so it stops re-rendering on every provider render.
• SortableList keyed — drag-reorder now follows the item, not the index. New optional Key parameter for value-type items.
• DataTable.Virtualize now actually virtualises — it was a no-op (rendered the full list either way). Wired to Blazor's <Virtualize SpacerElement="tr">; selection still works inside virtualised rows.
• @key also added to FileUpload, Mention, Transfer, PickList, ImageGallery, TreeView/TreeViewNode, TreeSelect item loops.

New / changed parameters

• <AccordionContent ForceMount="true"> and <CollapsibleContent ForceMount="true"> — keep the panel in the DOM (with the hidden attribute) when collapsed instead of unmounting, so form input / scroll / component state survives. Mirrors Tabs' rc.29 pattern. Default off, no behaviour change.
• SortableList.Key (Func<TItem, object>?).

Performance

• DataGrid caches the visible-columns projection instead of re-materialising it on every render.
• DataTable caches ItemsList / IsAllSelected / IsSomeSelected instead of re-scanning every render.
• TreeView caches the filtered tree — the recursive whole-tree deep-copy now runs only when the search text or Items change, not on every render.
• Carousel only calls StateHasChanged from its scroll callback when the prev/next-availability flags actually flip — no more a render per scroll frame during a drag.

New MCP tools

• lumeo_validate_markup — pre-flight a Razor snippet: do the components exist? are parameter names real (catches hallucinated APIs)? are enum values legal? are sub-components nested inside their required parent (TabsContent in Tabs, DialogContent in Dialog, …)? Returns structured errors/warnings.
• lumeo_get_install — everything to actually run a component: NuGet + dotnet add, @using imports, AddLumeo…() DI, host-page <script>/<link> includes, sub-components, and gotchas (portal components needing theme classes on <body>, OverlayProvider, required params).
• lumeo_get_example — the real Razor snippet(s) behind the docs-site demos, now extracted into the API schema at generation time (122/131 components covered).
• lumeo_get_theme_tokens — all 58 theme tokens (colour + radius CSS variables) so the model uses bg-primary / text-foreground / border-border, never raw hex, never dark: prefixes.
• lumeo_list_patterns / lumeo_get_pattern — the 16 full-page "blocks" (dashboard, auth, chat, kanban, mail, settings, …) with their complete Razor source as a starting skeleton.
• lumeo_changelog — current package version + API-schema generation timestamp + changelog link.

lumeo_get_component now also includes the extracted examples array. The registry generator gained an example/theme-token/pattern extractor that scrapes the docs pages — so the MCP stays in sync automatically on every release.

Modes

• Active (default) — only the active panel is in the DOM; switching away unmounts it. Lightest footprint, no behaviour change from before.
• Lazy — a panel renders the first time its tab becomes active, then stays mounted (hidden) so its state survives subsequent switches. DevExpress OnDemand.
• Eager — every panel renders up-front; inactive ones are hidden. State always preserved, heaviest initial render. DevExpress Always.
• Per-panel override: <TabsContent ForceMount="true"> always keeps that one panel mounted regardless of the parent mode — pin a half-filled form, leave the rest light.

Hidden panels use the standard hidden attribute, so they're skipped by screen readers and the keyboard tab order while still preserving DOM state.

DataGrid — three virtualisation modes, all wired up

• Virtualised server mode (NEW) — set Virtualized="true" + OnRangeRequest and the grid fetches a sliding window of rows from your backend as the user scrolls (Blazor's <Virtualize ItemsProvider>). Pagination is hidden automatically; sort, column filter, and global search all trigger RefreshDataAsync() so the next request reflects the new query state. Public grid.RefreshVirtualizedAsync() for manual refetch after external mutations.
• Virtualised client mode (correctness fix) — the in-memory virtualiser now passes SpacerElement="tr". Without it, Blazor's default <div> spacers are invalid <tbody> children and the browser hoisted them out of the table, breaking layout whenever the threshold tripped.
• New tunables: VirtualItemSize (row-height estimate, default 41 px) and VirtualOverscanCount (default 3 rows).
• PageSizeOptions — configurable rows-per-page selector (default [10, 25, 50, 100]); pass new[] { 10, 50, 100, 200, 300 } for larger datasets, or empty array to hide the selector entirely.

Calendar / DatePicker — culture-aware

• Calendar.FirstDayOfWeek is now DayOfWeek?. Unset → derives from CultureInfo.CurrentCulture.DateTimeFormat.FirstDayOfWeek: de-DE / fr-FR / en-GB → Monday-first, en-US → Sunday-first.
• Day headers derive from AbbreviatedDayNames trimmed to two letters: en-US Su Mo Tu We Th Fr Sa, de-DE Mo Di Mi Do Fr Sa So, fr-FR lu ma me je ve sa di.
• Soft API change: explicit FirstDayOfWeek="DayOfWeek.Monday" still works (implicit lift to nullable).

The real root cause (took 6 RCs to find)

• Chrome creates a containing block for any element with an active transform-animating animation declaration — INDEPENDENT of the current computed transform value. Even with computed transform: none (overridden via !important), the active animation: ... slide-in-from-right declaration alone makes Chrome establish the sheet as a containing block for fixed-positioned descendants.
• Empirically verified: popover.x = 3278 when sheet has the animation declared (sheet at x=1536 + popover style.left=1742 ≈ 3278). Add animation: none !important on the sheet → popover.x = 1742.86 (viewport-relative). Confirmed via instrumented Chrome 131 DevTools session.
• This is Chrome's compositor optimization — it pre-creates a layer for transform-animating elements (treating them as will-change: transform implicitly). Per CSS spec strict reading this is technically aggressive but Chrome does it.

The fix

• attachOverlaySlideEnd in components.js now sets BOTH animation: none !important AND transform: none !important after the slide animation finishes. The animation property is what kills Chrome's containing-block treatment; the transform is belt-and-suspenders.
• Bug #1 (matrix containing block) and Bug #16 (DatePicker top:-1156, popover at sheet x) both resolve. Same fix.
• Slide animation visual is preserved (animation runs to completion, then properties are cleared in the post-finished state).

Added — Button propagation control

• [Parameter] public bool StopPropagation + [Parameter] public bool PreventDefault on Button. Wired to @onclick:stopPropagation / @onclick:preventDefault on the underlying <button> element. Drop-in replacement for the <span @onclick:stopPropagation="true"><Button…/></span> workaround.
• Plus [Parameter] public ButtonType Type (default Button) with Submit / Reset options for explicit form-button intent.

Improved — popover positioning robustness

• Synchronous layout flush before measurement: positionFixed now reads offsetHeight before getBoundingClientRect() so the browser flushes any pending layout (animation scaling, Blazor render mid-flight) and we measure the popover's settled dimensions, not a stale or in-flight rect.
• Universal max-height clamp: if the natural popover content exceeds the viewport, a scrollable cap is applied unconditionally — not only on flip-up edge cases.
• Bottom-overflow late guard: even after side-flip and other branches, if the popover would render past the viewport bottom, it's pulled up to fit with max-height applied.
• Combined with rc.23's negative-top guard, this makes positionFixed a true belt-and-suspenders surface — even if the underlying root cause for the rc.21–rc.25 user-reported top: -1156 is still inconclusive (the math doesn't match the reported popover height — root cause likely a transient layout state during animation), the popover is always visible.

The actual fix (5th attempt)

• Replaced addEventListener with the Web Animations API. el.getAnimations() returns running OR already-finished animations (fill-mode keeps the finished ones alive in the list), and animation.finished is a Promise that resolves immediately if the animation already ended, or once it does. Race-condition-free regardless of when the function is called.
• After awaiting .finished, set setProperty('transform', 'none', 'important') (rc.24's correct cascade-priority piece). Inline + !important is rank 4 (!important author) which beats animations (rank 5), so the fill-mode-forwarded matrix is finally overridden.
• Defensive: if getAnimations() returns no slide animation (Animation=Fade/None, or class already dropped), set the transform anyway. Edge cases get the same protection.

For maintainers — five-RC postmortem

• rc.21: keyframe trick (99%: translateX(0); to: none) — Chrome interpolates none↔translate(0) as identity under fill-mode:both. Placebo.
• rc.22: Razor @onanimationend handler — Blazor EventArgs lacks animationName, descendants bubbled up. Placebo.
• rc.23: native JS listener with plain style.transform = 'none' — animations rank above normal author. Placebo.
• rc.24: same listener but with !important — cascade priority correct, but listener attaches after animation ends. Placebo.
• rc.25: getAnimations() + .finished promises + setProperty important — race-free AND cascade-correct. Empirically verified.

Why the previous attempts failed

• rc.21 keyframe trick (99%: translateX(0); to: none): Chrome resolves to: none under fill-mode:both as identity matrix. fill-mode forwards interpolated values, and the transition between translateX(0) and none is treated as identity by all major engines. End state stuck at matrix(1,0,0,1,0,0).
• rc.22 Razor handler that drops the class: Blazor's @onanimationend EventArgs doesn't expose animationName, so descendant zoom-in / fade-in animations bubbled up and prematurely dropped the class mid-slide. Plus the Razor → JS roundtrip latency was racy.
• rc.23 native JS listener with plain inline style: filtered correctly on slide-in-from-* + target === el, but used el.style.transform = 'none' which is normal author cascade rank. Animations outrank that. Matrix stayed.

The fix that actually works

• el.style.setProperty('transform', 'none', 'important') inside the same filtered animationend listener. Inline + !important is !important author in the cascade, which beats animations. The forwarded fill-mode value is properly overridden, computed transform becomes none, no containing block, popovers (Select / DatePicker / Combobox) inside Sheet/Drawer position relative to the viewport.
• Verified mechanism: per CSS Cascade Level 4 spec, the priority order from highest to lowest is — transitions, !important user-agent, !important user, !important author, animations, normal author (incl. plain inline style), normal user, normal user agent.

Fixed — slide-trap (third time's the charm)

• New Interop.AttachOverlaySlideEnd(elementId) JS interop registers a native animationend listener that filters strictly on slide-in-from-* AND on event.target === el (descendants don't trigger it), then sets inline style.transform = 'none'. Inline-style precedence beats keyframe fill-mode forwarding — the matrix is cleared, no containing block, popovers position relative to viewport.
• SheetContent + DrawerContent now call this on every open with Animation=Slide.
• Removed the racy Razor-side @onanimationend handler + _animationDone flag — JS interop is the sole, reliable path.

Fixed — defensive popover top clamp

• positionFixed now applies a final guard: if the computed top ends up negative for any reason (entrance-animation scaling, stale rect, weird parent flex layout), it's forced to 8px with max-height + overflow: auto. Belt-and-suspenders for the rc.21 / rc.22 user-reported top: -1156.

Fixed — slide-animation transform trap (real fix this time)

• The rc.21 fix used a 99% / to: none keyframe trick. That doesn't work: animation-fill-mode: both keeps the element in the animation's end state, and Chrome resolves transform: none to identity matrix when blended through animation. The element ends up with matrix(1,0,0,1,0,0) — still a containing block, popovers still off-screen.
• Real fix: SheetContent and DrawerContent now bind @onanimationend and drop the animate-slide-in-* class once the animation completes. Without the class, there's no animation, no fill-mode, no transform — the element returns to its static state and the viewport regains its natural role as the containing block. Visually identical landing; popovers (Select, DatePicker, Combobox) inside Sheets/Drawers position correctly. Apps with the animation: fade-in !important workaround can drop it.

Fixed — DatePicker / popover overflow clamping

• Inside a Sheet's flex layout, the calendar popover could stretch to ~1574 px. The flip-up logic in positionFixed then computed top = triggerTop − contentHeight − gap, which went deeply negative (e.g. −1156 px) — popover invisible above the viewport.
• Now compares spaceAbove vs spaceBelow and picks the side with more available room, capping the popover with max-height + overflow: auto when neither side fits the natural content height. The popover is always visible.

Fixed — EditForm-in-Sheet footer pin

• When consumers wrapped a Sheet's body in <EditForm>, the rendered <form> was content-sized — SheetFooter stuck below the last field instead of pinning to the bottom. New CSS rule in lumeo.css makes direct <form> children of Lumeo sheet/dialog/drawer dialogs inherit the flex-column layout — no consumer-side CSS workaround needed.

Fixed — popover containing-block trap

• Slide keyframes now end at transform: none (was identity translateX(0)). Per CSS spec, any non-none transform — including identity translates — establishes a containing block for position: fixed descendants. The old keyframes meant Select / DatePicker / Combobox popovers inside a slid-in Sheet rendered relative to the Sheet instead of the viewport, ending up off-screen. The 99 % step keeps the visual landing identical; the 100 % step disposes of the transform.
• Apps with the .animate-slide-in-* { animation: fade-in !important } workaround can drop it.

Added — Sheet + Drawer Animation variant

• SheetContent.Animation and DrawerContent.Animation accept Slide (default), Fade, or None. Slide is now safe (transform-trap fixed); Fade / None remain available for consumers who want maximum predictability inside re-render-heavy parents.

Added — TagInput is now generic

• TagInput<TItem> with TItem defaulting to string so existing string consumers compile unchanged. Real apps now build user-pickers, mention-pickers, etc. on top of structured items.
• New params: GetTagText, GetSuggestionText, TagTemplate (RenderFragment<TItem>), SuggestionTemplate, Separators[] (multi-separator paste), ValidateInput / ValidateInputAsync, CreateTag, MaxTagsHelperText.
• New User-picker demo on the TagInput docs page (avatar + name in tag chip + name/email rows in suggestion popup, comma/semicolon/space separators).

Added — Controlled-mode popover state

• DatePicker gains optional Open? + OpenChanged (Select / Combobox already had it). When non-null, the consumer owns popover state — survives parent re-renders. Use @bind-Open inside heavily re-rendering parents (EditForm with active validation) to keep the popover open through validation cycles.

Added — Lumeo.Text full theme-token map + small param expansions

• <Lumeo.Text Color="..."/> now accepts every theme token: foreground, muted, primary, destructive, success, warning, info, accent. Case-insensitive. Unknown values fall back to no class (deliberate hardening).
• FileUpload gains Size parameter (Sm / Default / Lg) for the Button variant.
• BottomNavItem gains IconSize (default "h-5 w-5"); consumer can pass "h-7 w-7" to fit an avatar in the icon slot.
• ToggleGroupItem auto-spaces icon + label (gap-1.5 on the base class) — no more manual Class="gap-1.5".

Docs — EditForm + Localization guides

• New: EditForm + Lumeo Validation guide explaining why Lumeo inputs are not InputBase<T> derivatives, the canonical pattern with EditContext.GetValidationMessages + Invalid wiring, server-side error injection, and the nullable-EventCallback lambda workaround.
• New: Localization guide documenting Blazor WASM's en-US default and how to set browser-locale at startup.
• Sheet + Drawer docs pages gained an info Alert about the rc.21 transform-trap fix and the new Animation variants.

Added — Calendar booking API

• DateTooltip (Func<DateTime, string?>?): per-day tooltip text rendered as the day cell's title attribute (native browser tooltip on hover). Useful for "Sold out" / "Limited availability" hints in booking flows.
• DateBadge (Func<DateTime, RenderFragment?>?): per-day indicator slot rendered absolutely positioned in the bottom-right of the day cell — status dots, count badges, icons. Non-interactive (pointer-events-none) so clicks still hit the day button.
• Both callbacks plus the existing IsDateDisabled and DateClass are now also forwarded through DatePicker and DateRangePicker so the booking-calendar UX works through the popover-style pickers too.
• New booking-style demo on the Calendar docs page: synthesised hotel availability with green / amber / red / grey dots + tooltips like "Sold out", "Limited availability".

Improved — Calendar UX

• Single click target for month/year — the Days view header used to have two adjacent buttons (month name + year) that opened different pickers. Replaced with one combined button. Cycle is now: Days → click → Months → click year → Years. One predictable click target per view.
• Equal width across all three views — the picker no longer visibly resizes when switching between Days, Months and Years. Each view is fixed to 224 px of inner content (matches the 7-column day grid).

Added — Per-component registry endpoints

• 131 self-contained component files at https://lumeo.nativ.sh/registry/<key>.json (and the matching NuGet path _content/Lumeo/registry/<key>.json) — same shape as shadcn's per-component registry plus extra LLM-friendly fields: docsUrl, sourceUrl, source (full Razor file content), slots, serviceDependencies, cascadingDependencies, relatedComponents, keyboardInteractions, tests, mdSummary (a self-contained Markdown reference paragraph an LLM can drop straight into context).
• The registryUrl field on every component in the root registry.json now resolves correctly — previously it pointed at endpoints that 404'd.
• Lumeo.Cli DefaultRegistryUrl bumped from a stale jsdelivr / rc.9 pin to the live docs site (https://lumeo.nativ.sh/registry.json).

Fixed — Avatar shape + DropdownMenu focus + E2E CI

• Avatar outer wrapper now follows ShapeClasses so consumer-applied borders / rings (e.g. border-2 border-background on AvatarGroup overlap) follow the avatar's actual circular shape — no more square frames around fallback initials.
• DropdownMenu focuses the menu content on open per the WAI-ARIA menu pattern. Previously tabindex="-1" was set but focus was never moved, so Escape and Arrow keys never reached the keydown handler — keyboard nav was actually broken in production.
• E2E visual test skipped under CI until a perceptual differ ships. The home-above-fold byte-equal compare can't agree across Windows (where the baseline was generated) and the Ubuntu CI runner because of font hinting / sub-pixel rendering. The other 15 E2E tests still gate every push and PR.

Added — MCP server is now fully complete

• 131 / 131 components in the schema — every component now has full parameters, types, defaults, XML doc descriptions, EventCallback events, nested enums + records, @inherits / IAsyncDisposable, and sub-components grouped per folder. 3,152 parameters total, 86 enums, 48 records, 0 thin fallbacks.
• Auto-generated from Razor source via a new Roslyn-based pass in Lumeo.RegistryGen. Every release regenerates the schema; no more manual catalog drift.
• Hand-curated examples preserved as an overlay — lumeo_get_component still surfaces the existing example Razor snippets for ~30 popular components.

Fixed — DataGrid correctness (P1)

• Column reorder cross-talk: a static ColumnDragState was shared across every grid in the process — drops in grid B used grid A's source index. Replaced with an instance-bound DataGridDragState + OwnerGridId guard. Same fix for row reorder. New regression tests cover both drag types.
• EventCallback fire-and-forget at 6 sites in DataGrid.razor — SelectedItemsChanged, OnColumnReorder, OnRowReorder were called without await. Now awaited where the call site can be async, dispatched via SafeAsyncDispatcher.FireAndForget where it must stay sync.
• Auto-save stale generation: the existing generation guard skipped LocalStorage writes but still called OnLayoutSave with stale snapshots. Guard now covers both paths.

Fixed — Lifecycle / async hardening (P2)

• SafeAsyncDispatcher outer task — the inner try/catch only covered the work delegate. If InvokeAsync itself threw (renderer disposed), the outer Task was unobserved. Outer call now wrapped in an async helper that catches expected lifecycle exceptions silently and logs anything else.
• Alert AutoDismiss timer/dispose race — replaced System.Threading.Timer with CancellationTokenSource + Task.Delay; Dispose cancels the token and flips a _disposed flag before any state mutation.
• Editor + Gantt JS listener leaks — anonymous addEventListener closures (mousemove, mouseleave, drop on the editor; document-level mousemove + mouseup on Gantt drag) survived destroy(id). All listeners now stored as named handlers; destroy iterates and removes each.

Fixed — Theming + API + Security (P1 + P2)

• Preset code / Worker ID namespace collision — both spaces were 6-char Base62. Some Worker IDs decoded as valid v1 local presets and never hit the server. New explicit prefix scheme: l_<6> for local codes, p_<6> for Worker IDs. Bare 6-char input keeps legacy fallback behavior with strict version checks.
• Worker payload check post-read — the content-length header was the only authoritative check; missing or wrong header bypassed the limit. Now reads arrayBuffer() first and enforces real byteLength.
• Worker collision retry — same 6-char ID with different payloads no longer overwrites silently. Up to 8 salt-based retries; idempotent on matching payload; 409 if exhausted.
• Word-import 8 MiB cap — JS pre-arrayBuffer file.size check + .NET pre-Convert.FromBase64String size guard + new WordImportSizeException. New MaxWordImportBytes parameter on RichTextEditor.
• Removed eval() in IconPage — replaced with a named JS helper. CSP-clean.
• Vendored TipTap stack (~1.4 MB ESM bundle) — RichTextEditor no longer dynamic-imports from esm.sh at runtime. Ships at _content/Lumeo.Editor/js/tiptap-bundle.js; works under strict CSP and offline. window.lumeoTiptapBundleUrl is the override hook for consumers who want to host their own.

Fixed — Overlay UX + Avatar shape

• OverlayService double-backdrop when consumers nested another <SheetContent> / <DialogContent> / <DrawerContent> inside their service-opened component. New OverlayShellMarker cascade — nested *Content components self-detect the host shell and pass children through. Both patterns now render exactly one backdrop. Regression test asserts bg-black/80 appears exactly once.
• Avatar outer wrapper follows ShapeClasses — consumer-applied borders / rings (e.g. AvatarGroup overlap framing) now follow the avatar's actual shape. Previously the border landed on the rectangular outer div while the inner div clipped to a circle, creating square frames around fallback initials.
• DropdownMenu keyboard nav — menu container had tabindex="-1" but never received focus on open, so Escape and Arrow keys never fired. Now focuses the content on open per WAI-ARIA menu pattern. Surfaced while stabilizing the E2E suite.

Improved — E2E suite is green and CI-gated (P1)

• 16 / 16 E2E tests passing (was 8 / 16). Stable selectors via data-testid on the relevant docs elements; Search palette result locators scoped to the palette overlay; baseline snapshot committed at tests/Lumeo.Tests.E2E/Snapshots/home-above-fold.png with deterministic init-script (consent banner suppressed, animations zeroed).
• New .github/workflows/e2e.yml — installs Playwright browsers, builds the docs, runs the docs server on port 5290, runs E2E against it, uploads docs-server.log on failure.

Improved — Docs polish (P3)

• Mobile / Desktop preview toggle on ComponentDemo — DashboardBlock / PricingTableBlock / SettingsPageBlock no longer force phone users into horizontal scroll. Toggle wraps the demo in a 420 px phone frame so the experience is honest, not painted-over.
• dotnet format --verify-no-changes is green — formatting drift swept across 27 files in a single style pass, no behavior change. Ready to wire into CI as a release gate.

Added — Chart loading label

• New ShowLoadingLabel + LoadingText parameters on Chart (and forwarded by chart wrappers like BarChart). When IsLoading is true, a small top-right pill (Lucide LoaderCircle + "Loading…" text) is overlaid on top of whichever SkeletonStyle is active. Default-on so users never mistake cycling phantom data for a bug; opt out per-chart via ShowLoadingLabel="false".

Fixed — Drop-in setup regression

• lumeo-utilities.css ships again — the rc.15 package-split spec moved the file out on the assumption a registry CDN would host it, but the CDN was never set up. Consumers following the docs got a 404 + visibly unstyled Lumeo components (Badge px-2.5 missing, DataGrid toolbar borders gone, Switch container collapsed). Restored to _content/Lumeo/css/lumeo-utilities.css.
• Bundle now covers all 6 satellites — lumeo-utilities.src.css extended to @source the UI/ folder of every satellite (DataGrid, Charts, Editor, Scheduler, Gantt, Motion). Drop-in setup now works whether you install only core or all 7 packages.
• Docs site Tailwind scan extended the same way — docs/Lumeo.Docs/Styles/tailwind.css was scanning only src/Lumeo/UI/**/*.razor, so the live docs DataGrid demos were missing the same classes. Fixed in the same release.
• NuGet author across all 9 published packages updated from bemi (the developer's GitHub handle) to nativ.sh.

Migrating from rc.15 / rc.16 / rc.17

• If you vendored an older copy of lumeo-utilities.css as a workaround, you can drop it and revert your App.razor link tag back to _content/Lumeo/css/lumeo-utilities.css.
• If you set up your own Tailwind build (per the rc.15 "advanced" path), you can keep it — that path still works. Just drop the @source entries pointing at Lumeo packages, since the shipped bundle now covers them.

Improved — Lifecycle & async safety

• DataGrid debounced server search rewritten to a CTS-backed pattern — exact-last-call semantics, dispose cancels in-flight work, exceptions surfaced. Test now asserts Assert.Equal(1, callCount) instead of race-tolerant callCount <= 2.
• OnThisPage (docs sidebar) now uses a CancellationTokenSource per route — old retry scans cancel cleanly when navigating, no more stale headings on fast clicks. Replaced JS eval with a dedicated function.
• Toast / Overlay / MegaMenu providers — the _ = InvokeAsync(...).ContinueWith(...) pattern (which silently logged errors) replaced by Lumeo.Services.SafeAsyncDispatcher. 9 call-sites converted; expected lifecycle exceptions (JSDisconnectedException, ObjectDisposedException) swallowed silently, others logged with a structured tag.
• ComponentInteropService sync Dispose() now fire-and-forgets the same JS-side cleanup that DisposeAsync runs — stops browser-side observers/listeners from leaking when the sync path is taken.

Added — Test infrastructure

• Direct unit tests for 23 components previously without test files (Cascader, ColorPicker, ConsentBanner, DateTimePicker, Gantt, ImageCompare, InplaceEditor, InputMask, Kanban, MegaMenu, Mention, PasswordInput, PopConfirm, QRCode, RichTextEditor, Scheduler, Sortable, SpeedDial, TimePicker, Tour, Transfer, TreeSelect, TreeView). Coverage 108/131 → 131/131.
• Component contract [Theory] — 250 test cases spanning 125 components; asserts every component renders with defaults AND forwards AdditionalAttributes to its root. Catches "I forgot to splat" regressions across the entire library at once.
• Lumeo.Tests.E2E — new Playwright .NET project with 5 high-value smoke tests (Dialog focus trap, DropdownMenu keyboard nav, Tooltip hover, catalog renders ≥100 cards, Cmd+K palette navigates). Reaches the failure modes bUnit can't.
• Visual snapshot foundation — one example test capturing the home page above-the-fold and comparing against a baseline PNG. Set LUMEO_E2E_UPDATE_SNAPSHOTS=1 to regenerate baselines.
• WordImporter real-DOCX test unskipped — programmatic in-memory DOCX with headings, paragraphs, and styles replaces the local-path fixture that previously caused the test to be skipped on every CI run.

Improved — CI release gate

• CI now builds Lumeo.slnx with -warnaserror across the entire solution (was: library + satellites only — docs project was excluded).
• CI runs all three test projects: Lumeo.Tests, Lumeo.Docs.Tests, Lumeo.RegistryGen.Tests. Was previously only Lumeo.Tests.

Fixed — Docs nav UX

• Top-nav highlight: clicking into a component (/components/<slug>) now keeps "Components" lit instead of switching to "Docs".
• Sidebar from any docs/patterns/component-detail page now shows the full nav (docs + components + patterns) with collapsible groups; the group containing the current URL auto-expands. No more "to find a component you have to click into a component first".

Added — Lumeo.Motion v0.1

• Lumeo.Motion satellite package — 10 user-verified motion primitives for high-energy Aceternity / Magic UI-style interfaces.
• Migrated from core (7): BlurFade, BorderBeam, Marquee, NumberTicker, ShimmerButton, Sparkles, TextReveal.
• New (3): AnimatedBeam (Magic UI port — SVG gradient path between nodes), Confetti (canvas burst escaped from demo box via position:fixed), Dock (cursor-magnification with Lucide icons).
• Catalog cards show a NuGet badge for satellite components. All components stay in @namespace Lumeo — no consumer @using changes needed.
• More motion primitives (AnimatedCircularProgressBar, AuroraBackground, Globe, HoverBorderGradient, MagicCard, Meteors, MorphingText, OrbitingCircles, Ripple, ShineBorder, Spotlight, TypingAnimation, WordRotate, and more) are deferred to a future release pending final visual polish.

Added — Docs nav v2

• Component catalog page (/components) — sticky category rail, filter chips, and 480×270 preview-card thumbnails for all components.
• Algolia full-content search — Cmd+K now queries lumeo_docs index (components, patterns, blocks, guides); falls back to a local slim index when Algolia is unavailable.
• registry.json as single source of truth — component metadata drives the catalog, the indexer, and the prerender script.
• Thumbnail prerender script (scripts/prerender/run-all.mjs) — headless Puppeteer renders one PNG per component; runs in CI on registry change.
• Algolia indexer script (scripts/algolia/index-docs.mjs) — pushes records to Algolia on every docs deploy.

Improved

• Sidebar Form group collapsed from 34 individual links to 5 logical subgroups; Data Display from 28 to 5 — both data-driven from nav-config.json.
• CatalogFilterChips buttons now expose aria-pressed state to assistive technology.
• CatalogRail sticky offset aligned to top-[84px] to match NavMenu / BlocksSidebar / CustomizerSidebar.

Package split (DevExpress / Microsoft.Extensions model)

• Lumeo — core, ~568 KB. Layout, Forms (excl. RichTextEditor), Navigation, Overlay, Feedback, Display, Motion, Theme, ConsentBanner, AI surface.
• Lumeo.Charts — ~196 KB. Chart + 30+ subtypes + ECharts interop.
• Lumeo.DataGrid — ~111 KB. DataGrid, DataTable, Filter (incl. ClosedXML + QuestPDF for export).
• Lumeo.Editor — ~50 KB. RichTextEditor + Word import via Mammoth.
• Lumeo.Scheduler — ~22 KB. FullCalendar wrapper.
• Lumeo.Gantt — ~19 KB. Custom SVG Gantt (no third-party dep).
• All 6 packages share one lockstep version. Components stay in @namespace Lumeo so consumer @using directives are unchanged.
• lumeo add <component> CLI now auto-detects the satellite and prompts to install via dotnet add package.

RichTextEditor Pro (Lumeo.Editor)

• Mentions with pluggable triggers (@ users, # tags, $ variables, custom).
• Slash commands (Notion-style): /heading, /list, /table, /code, /image, /quote.
• Tables with resizable columns + header rows.
• Code blocks with syntax highlighting (lowlight: JS/TS/Python/CSS/HTML/JSON/Bash).
• Image upload via drag/drop/paste — consumer-supplied OnImageRequested callback or base64 fallback.
• AI actions on selection (Improve / Shorten / Expand / Translate / Summarize / FixGrammar) — consumer-supplied OnAiAction hooks into your own LLM.
• Word (.docx) import — works in-browser by default via Mammoth in the WASM bundle. Default style map handles English + German Word default styles (Title/Titel, Heading 1-6/Überschrift 1-6, Body Text/Textkörper, etc.).
• Block drag handles, bubble menu, smart paste, markdown shortcuts, task lists, auto-link.
• Lumeo Dialog for the Link prompt instead of the native browser window.prompt.

Custom Gantt renderer (Lumeo.Gantt)

• Replaces the Frappe Gantt v1.2.2 dependency with ~400 lines of deterministic custom SVG. No more CDN dep, no more theming surprises across browsers.
• View modes: Day / Week / Month / Year / HalfDay / QuarterDay.
• Drag a bar to move (snaps to single days even in Week view), drag the right edge to resize, drag the bottom-edge handle to set progress.
• Hover tooltip with task name, date range, day count, progress %.
• Theme tokens read via getComputedStyle — no theme/cache battles.
• Auto-scrolls horizontally so today is centered on first paint.

Other

• Overlay components (Dialog, Drawer, DropdownMenu, AlertDialog, Sheet, Popover, ContextMenu, Combobox, Select, ColorPicker, HoverCard, Tour, Collapsible, NavigationMenu) renamed IsOpen → Open. IsOpen kept as [Obsolete] alias for one release.
• 24 form inputs gained Required / Invalid / ErrorText / HelperText / Label / Name. Reads FormFieldContext via cascading parameter so <FormField> wrapper still works.
• Display components (Alert, Result, ReasoningDisplay, Statistic, SparkCard) gained Size + Variant; trigger components (BackToTop, SpeedDial, Chip, Carousel) gained Disabled.
• 14 missing component doc pages added (Code, Delta, KpiCard, Marquee, NumberTicker, Overlay, PromptInput, ReasoningDisplay, ShimmerButton, SparkCard, Sparkles, StreamingText, TextReveal, ToolCallCard) + 62 new ComponentsIndex entries.
• Select / Combobox Searchable filter actually filters items (was visible but inert).
• Mammoth bumped to 1.11.0 to clear NU1902 advisory.
• FullCalendar (Scheduler) now reads Lumeo theme tokens via --fc-* CSS variable map.

Added aria-label to icon-only buttons

• ToastClose — new AriaLabel parameter (default "Close"), sr-only text for screen readers.
• Cascader, DateTimePicker, Select (clear + multi-value chips), Filter.FilterPill — "Clear" / "Remove {label}" labels on the X icons that were previously empty buttons.
• Select clear-icon converted from <span> to a proper <button type="button"> — keyboard focusable and announced to assistive tech.

Already compliant (verified)

• Alert (dismiss), Chip, Badge, TagInput, DatePicker — all had aria-label on their close/remove icons.
• Dialog / Sheet / Drawer close buttons — sr-only localized text via ILumeoLocalizer.
• Carousel prev/next — aria-label + sr-only. Pagination has visible text. Calendar nav is fully labelled via L["Calendar.*"] strings. Rating stars each emit "Rate {n} of {max}".

Added

• Slider.AriaLabel — accessible name for the range input. Also auto-emits aria-valuemin / aria-valuemax / aria-valuenow. For range sliders (IsRange=true), the end-handle's aria-label is suffixed with "(end)" automatically.

Docs site

• Landing-page form controls demo now passes Label/AriaLabel on every Switch, Slider, Checkbox, and Toggle — fixes the remaining Lighthouse "button / form element without accessible name" violations.

Fixed

• Card, CardContent, CardHeader, CardFooter, Separator: moved .Trim() inside the Razor expression. Was previously rendered as a literal HTML attribute (silent error in browsers, InvalidCharacterError in strict DOM consumers like Puppeteer).
• theme.js: replaced synchronous XMLHttpRequest to /lumeo-theme.json with a DOM lookup for an inlined <script id="lumeo-theme-defaults"> tag. Eliminates the Chrome sync-XHR deprecation warning, the main-thread block, and the 404 console error on every site without a preset file.
• BlurFade no longer holds its children at opacity: 0 by default. Above-the-fold content is visible from first paint even when JS hasn't hydrated yet (previously caused a 1-2 s blank flash on prerendered landing pages).

Added

• Switch.Label, Checkbox.AriaLabel, Toggle.AriaLabel — new parameters that emit aria-label on the underlying button so icon-only usages pass Lighthouse / WCAG without ceremony. Switch also falls back to the current OnLabel / OffLabel text when no explicit label is set.
• NuGet package now ships with Source Link, a .snupkg symbol package, and deterministic compiler flags. Debuggers (Rider, Visual Studio, VS Code) can step directly into Lumeo source from GitHub. All three NuGet Package Explorer health checks now pass.

Docs site

• Full static HTML prerender in CI — every route is served with complete content for first paint + SEO (192 routes, ~110 s prerender, via Puppeteer).
• Per-route OG / Twitter preview cards generated via Satori — unique 1280×640 PNG per page with the page title, Lumeo brand, and category pill. Served from /og/<slug>.png.
• Per-page <meta name="description">, <link rel="canonical">, and JSON-LD structured data (TechArticle / BreadcrumbList / SoftwareApplication).
• /llms.txt + /llms-full.txt + per-route .md variants for GEO — ChatGPT, Perplexity, Claude can discover and cite Lumeo docs in one fetch.
• Cloudflare Web Analytics (cookie-free) gated behind the consent banner.

Added

• Lumeo.Services.ConsentService — per-category consent manager. Persists to localStorage (lumeo:consent:v1), exposes HasConsent(string) for gating third-party scripts, and fires OnChange / OnRequestOpenPreferences events so a "Manage cookies" link anywhere in the layout can reopen the banner without CascadingValue plumbing.
• <ConsentBanner> — slide-in banner with Accept / Reject / Customize. The preferences dialog has per-category toggles; "necessary" is always locked on. Strings are individually overridable for i18n.
• Registered in AddLumeo() as Scoped — zero extra wiring.

Docs site

• Migrated from GitHub Pages to Cloudflare Pages — per-path Cache-Control (fingerprinted _framework/*.wasm now immutable for a year), HTTP/3, Brotli at edge, no env-protection friction.
• sitemap.xml auto-generated from every @page directive (190 URLs) + robots.txt so Google can index all component / block / pattern pages.
• Issue + PR templates, SECURITY policy, Code of Conduct, FUNDING (Sponsors button).
• New /privacy page with live consent-management controls.
• Open Graph + Twitter Card meta tags on index.html for proper link previews on Discord / LinkedIn / Slack / X.

Added

• ShowArrow parameter on PopoverContent, DropdownMenuContent, and HoverCardContent — rotated-square arrow with matching border on outward-facing sides.
• data-state="open|closed" + group class on DropdownMenuTrigger so consumer chevrons can flip with group-data-[state=open]:rotate-180.
• Toast slide-out animation (animate-toast-out) — dismiss now slides + collapses instead of popping.
• 15 new Lucide icon mappings in DynamicIcon (Wrench, BookOpen, Component, Puzzle, Cog, Server, Database, Wand, PanelLeft, et al.) + every search-palette category now has a real icon instead of a Circle fallback.
• Chevron rotation on open for SelectTrigger, Cascader, and ColorPicker (matching existing Accordion/NavigationMenu/TreeSelect behavior).
• Demos: "With Arrow" added to Popover, DropdownMenu, and HoverCard doc pages.

Fixed

• Sparkles clustered at top-left when consumer passed Class="absolute inset-0" — root cause was Tailwind v4's @layer utilities losing to unlayered CSS. Component now drops the .lumeo-sparkles class entirely when the consumer supplies positioning.
• Checkbox rewritten — crisp inline-SVG check + minus with rounded stroke caps (no more Lucide jagginess), unchecked state now visible (was zero-sized due to arbitrary Tailwind classes not being safelisted), hover state, smooth color transition.
• Toast auto-dismiss missed StateHasChanged so toasts stuck on screen.
• Rating half-star was shifted vertically — reworked as two stacked SVGs in a single grid cell with clip-path, pixel-perfect alignment.
• Progress indeterminate sweep: retuned keyframe so exit and opacity fade align — no more "snap off" at the right edge.
• Resizable and Splitter vertical mode: swapped flex-basis: X% → flex: X 1 0 so vertical works without requiring an explicit parent height.
• Bento tiles overlapping — added grid-auto-rows: minmax(0, 1fr) and min-w-0 min-h-0 on tiles.
• ImageCompare rewritten with a transparent <input type="range"> for drag + clip-path for reveal (browser handles drag math, tracks the cursor exactly).
• Combobox + Command empty states rendered unconditionally — now gate on registered item count; items track their visibility so filtered-out items un-register.
• Tour spotlight now reads the target's computed border-radius via JS interop and matches it.
• DataGrid fullscreen: removed duplicate exit control (modal X was redundant with toolbar minimize), grid fills modal height, pagination sticks to bottom; Context.IsExpanded now rebroadcasts to toolbar on toggle so the Maximize/Minimize icon swaps correctly.
• Stack/Flex Gap values like 14, 16, 20 had no effect — Tailwind's scanner can't see runtime-interpolated class names. Added full spacing-scale safelist to the utilities bundle.
• Block previews (SignIn/SignUp/ResetPassword/OtpVerify) had a floating card halo from min-h-[640px] — replaced with tight p-8, and CardContent bumped to pt-10 so the hero icon has breathing room.
• Alert/Badge/Command/Kbd/EmptyState/Popover/HoverCard/Toast borders softened to border-border/40 or /60 across ~60 doc pages.
• Circle-fallback icons in the Ctrl+K command palette (Wrench etc. were missing from DynamicIcon's map).
• Kanban pattern "+2" overflow pill sized to match Avatar.Sm.
• Double-icon bugs on Alert demos (auto-icon + inline DynamicIcon) on AlertPage and KeyboardShortcutsPage.

Improved

• Home marquee rewritten as two rows in opposing directions with icon pills (card surface + primary-tinted) and edge-gradient fades.
• Landing comparison table fact-checked against current GitHub/NuGet state — corrected MudBlazor templates, Radzen AI + MCP, Ant Design Blazor package size.
• Customizer "Share" button collapsed to a single client-side preset code action (removed the duplicate server-code row).
• Softer borders across 228 API reference table headers + ~60 demo wrappers.

Added

• Theme customizer: Font selector (6 fonts), Icon Library (6 options, Lucide default), Menu Color, Menu Accent.
• Color themes: Violet, Amber, Teal (total 8 themes).
• Preset renames: Vega, Nova, Maia, Lyra, Mira.
• Patterns page: 32 categories with ~70 live inline variants across Accordion, Alert, Avatar, Badge, Button, Card, Checkbox, Dialog, Input, Select, Switch, Tabs, Table, Toast, Progress, Separator, Skeleton, Popover, Tooltip, Sheet, DropdownMenu, Combobox, Breadcrumb, Pagination, RadioGroup, Spinner, EmptyState, Slider, Toggle, ToggleGroup, Kbd, OtpInput.
• ChartPatternDemos shared component with 8 chart patterns.

Fixed

• Customizer BaseColor and Style options were purely visual — now apply real CSS changes.
• Heavy borders on Switch, ThemeSwitcher, FileUpload, Checkbox, RadioGroup, OtpInput, Combobox, MainLayout search modal.

Added

• lumeo apply [preset] — flat top-level command (matches shadcn apply). Writes the theme section into lumeo.json (with lumeo.json.bak backup) and wwwroot/lumeo-theme.json which theme.js reads on init for no-FOUC first paint.
• --only theme,font,icons,radius,menu,style,baseColor,dark filter on apply to restrict which parts get rewritten.
• lumeo view <component> — prints component source to stdout without writing, for preview.
• lumeo info [--json] — dumps project config + installed components + theme.
• lumeo add --all to install every component; --diff and --view flags for preview-only runs.
• Server-stored preset IDs: when a preset code can't be decoded client-side, the CLI fetches it from https://api.lumeo.nativ.sh/preset/<id> — a Cloudflare Worker backed by KV. IDs are content-addressed SHA-256 of the canonical JSON, so the same config always returns the same 6-char code.
• Customizer sidebar Share as link button — POSTs the live config to the Worker and puts lumeo apply --preset <id> on the clipboard. Useful for custom brand palettes that don't fit the bitfield codec.

Deprecated

• lumeo theme apply — still works but prints a deprecation notice. Use lumeo apply instead.

Fixed

• Default registry URL lumeo.nativ.sh wasn't live, so fresh installs of the CLI failed with a 404 on lumeo add <component>. Now defaults to cdn.jsdelivr.net/gh/Brain2k-0005/[email protected]/src/Lumeo/wwwroot/registry/registry.json — pinned to the release tag so schema stays consistent.
• File-fetch URL derivation now recognizes three patterns: (1) jsDelivr / raw.githubusercontent.com layouts where the registry lives under .../wwwroot/registry/registry.json, (2) legacy self-hosted /registry.json → /raw/, (3) bare base URLs.
• GitHub Pages deploy workflow now also triggers on v2.0-dev branch and copies the registry + source files under the published site's /registry/ + /raw/ paths.

Added

• LumeoPresetCodec — encodes theme/style/base color/radius/font/icons/menu color/menu accent/dark into a 26-bit bitfield, base62-encoded to 6 chars. Versioned schema so future option additions reject old codes cleanly.
• LumeoPresetOptions — single source of truth for option arrays (indexes are the stored values — append-only).
• /themes customizer: live 6-char preset code with copy button — puts lumeo theme apply --preset <code> on the clipboard.
• CLI: new lumeo theme apply --preset <code> subcommand. Decodes the code and prints the resolved configuration + a ready-to-paste JS snippet that drives the runtime theme-switcher. --dry-run flag.

Why no backend?

• The preset IS the data — 26 bits packed into 6 base62 chars — no hosted KV store to manage.
• Codes work offline, can be pasted into docs / issues / PRs, and never expire.
• Shorter than shadcn's 9-character IDs (which require their API).

Added

• <ToolbarContent> is now a component with a Class attribute for custom wrapper styling
• Five built-in toolbar tools as separate composable components: DataGridToolbarFullscreen, DataGridToolbarCopySelected, DataGridToolbarColumns, DataGridToolbarExport, DataGridToolbarLayouts
• DataGridToolbarContext<TItem> cascading context — tool components pick up state with no props
• Docs sidebar: active NavLink highlight + auto-scroll active item to centered viewport on direct URL loads / navigation + auto-expand Charts subtree on /components/charts/*

Improved

• DataGrid column resize: JS drives the drag entirely in the DOM (direct style writes on header + body cells) and commits ONCE on mouseup — no more Blazor round-trip per pixel
• Consumer-provided <ToolbarContent> suppresses the default tool stack to avoid duplicate icons
• Softened aggressive border-b on 228 API reference table headers and in Accordion / Command / DataTable / Table / Sidebar components to border-border/40

Fixed

• Infinite re-render loop when <ToolbarContent> re-registered on every parameter set
• Duplicate toolbar icons when composing built-in tools inside <ToolbarContent>

Added

• ChartSkeleton with shape variants (Bars, Line, Area, Pie, Scatter, Grid, Generic) — reserved plot-area geometry so the real chart swaps in without layout jump
• IsLoading / ShowLoadingSkeleton / SkeletonKind parameters on every chart wrapper
• Loading-state demo on every chart doc page — Simulate button + Hold-skeleton switch

Improved

• Chart skeleton animations per kind: bar-grow, multi-line stroke-draw, flat pie rotation, scatter breath, grid pulse
• 350ms cross-fade handoff between skeleton and real chart
• Axis / legend hint rects reserve real-chart space so there's no layout shift

Fixed

• Pre-compiled lumeo-utilities.css was missing theme-token classes (bg-background, bg-popover, text-muted-foreground, etc.) that consumers needed — added @source inline() safelists
• Theme auto-applies bg-background text-foreground to <body> on init — portal components (Dialog / Sheet / Drawer / Toast / Popover / Tooltip) now inherit theme tokens when they render outside the theme context
• BarChart LabelStrategy enum (Smart / ShowAll / Auto) replaces the old boolean — auto-rotates category labels at 11 / 17 / 25 densities without flooding dense charts
• Stacked bar chart border radius regression — stacked segments now correctly round only the outermost edge

Added — Components

• AI primitives: PromptInput, StreamingText, AgentMessageList + AgentMessage, ToolCallCard, ReasoningDisplay — SignalR-native token streaming with sticky auto-scroll and collapsible chain-of-thought
• Motion primitives: Marquee, NumberTicker, TextReveal, BlurFade, BorderBeam, ShimmerButton, Sparkles
• Dashboard tiles: Bento + BentoTile, KpiCard, SparkCard, Delta, Sparkline (standalone SVG primitive)
• Navigation / layout: BottomNav (safe-area, optional FAB), Splitter / SplitterPane / SplitterDivider, PickList<T>
• Enterprise: Scheduler (FullCalendar v6 — Month/Week/Day/List, drag-to-create/reschedule), Gantt (Frappe Gantt — Day/Week/Month/Year zoom, drag progress), RichTextEditor (TipTap v2 — Full/Basic/None toolbars, two-way HTML binding)
• Blocks: 8 copy-paste page templates — /blocks/sign-in, /sign-up, /reset-password, /otp-verify, /pricing, /hero, /dashboard-block, /settings-page

Added — Services & tooling

• IDataGridExportService — real .xlsx export via ClosedXML, PDF via QuestPDF, CSV, with browser download helper and ExportFormats flags
• 14 built-in locales via ILumeoLocalizer: EN, DE, ES, FR, IT, PT, NL, PL, JA, ZH-CN, KO, AR, RU, TR
• RTL layout via IThemeService.SetDirectionAsync(LayoutDirection) — persisted, applied before first paint, with RTL-aware keyframes
• Lumeo.Cli — shadcn-style CLI (dotnet tool install -g Lumeo.Cli). Vendorize components into your repo: lumeo init / add / list / diff
• registry.json — machine-readable catalog of 127 components (files, dependencies, CSS variables)
• @lumeo-ui/mcp-server — MCP server exposing curated component schemas so Claude / ChatGPT / Copilot / Cursor author correct Lumeo markup
• Lumeo.Templates — dotnet new lumeo-page / lumeo-form / lumeo-component scaffolders

Added — Developer experience

• [LumeoForm] Roslyn source generator — annotate a POCO and get a compile-time RenderForm(model, onSubmit) that emits a fully-bound Lumeo Form with validation. Handles string / int / decimal / bool / DateTime / enum / email / password via [DataType] + [Required] + [Display]
• Opt-in Animated / AnimatedIndicator props on Steps, Timeline, Progress, Tabs, Switch, Checkbox, Badge, BottomNav — off by default, zero overhead when unused
• PressEffect enum (Scale / Brightness / Ripple) on Button, ShimmerButton, Card, BottomNavItem, ToggleGroupItem, Chip
• 248 new bUnit tests for 2.0 components — 1,687 total. 138 missing API rows filled in across ~45 component doc pages. Scrollable OnThisPage aside on every docs page. Landing rewrite, /docs/registry authoring guide, and /docs/culture page
• Interop: motion.* (RAF + IntersectionObserver), ai.* (autosize + sticky-scroll MutationObserver), lazy-loaded rich-text-editor.js / scheduler.js / gantt.js ESM modules, DownloadFileAsync on IComponentInteropService, Splitter pointer-capture helpers

Improved

• DataGrid: inset fullscreen modal with open animation, header drag-to-reorder, layout JSON round-trip (ExportLayout() / ApplyLayoutJsonAsync()), toolbar toggles (ShowSearch / ShowColumnChooser / ShowExport), Culture parameter, SetHtmlClass for navbar hiding in fullscreen
• UX audit: cursor-pointer + focus-visible rings on every interactive component
• Culture parameter cascades through DatePicker, DateTimePicker, NumberInput, Slider, Statistic — falls back to CultureInfo.CurrentCulture
• Motion demos: interactive Steps/Timeline, proper Tabs indicator per variant, testable BottomNav, single-connector animation (no flicker on reverse)

Fixed

• DataGrid: duplicate column registration race, header-drag edge cases, fullscreen z-index now above nav, grid fills overlay width
• BarChart: every category label rendered by default (LabelStrategy.Smart) with auto-rotation at higher densities (-60°, -75°)
• Landing: quickstart terminal cards, CTA box + Star button contrast, visible gaps, removed stray separators
• QuestPDF WASM crash on DataGridExport docs page (button disabled under WASM)
• Tailwind arbitrary-class bugs and docs spacing polish across 2.0 component pages

Breaking changes

• Icon / Label RenderFragment slots removed from Alert, Badge, EmptyState, Rating, Result, Segmented, SidebarMenuButton, StepsItem, TabsTrigger, TimelineItem. Rename <Icon>…</Icon> → <IconContent>…</IconContent> and <Label>…</Label> → <LabelContent>…</LabelContent>. Deprecated in 1.6.0.
• DataGrid Excel export is a real .xlsx now (ClosedXML), not a CSV renamed to .xlsx. Transparent for normal users; remove any workaround that routed the "excel" case to your own handler.
• BarChart LabelStrategy defaults to Smart, showing every category label and auto-rotating at higher densities. Restore the previous behaviour with LabelStrategy="ChartLabelStrategy.Auto".
• Culture defaults to CultureInfo.CurrentCulture on date / number components. Pass Culture="@CultureInfo.InvariantCulture" to keep invariant formatting.

Migration

See MIGRATION.md at the repo root for before/after snippets and migration recipes for every breaking change, plus install commands for the new Lumeo.Cli, Lumeo.Templates, and @lumeo-ui/mcp-server companion packages.

Added

• IconContent / LabelContent slots on Alert, Badge, EmptyState, Rating, Result, Segmented, SidebarMenuButton, StepsItem, TabsTrigger, TimelineItem — replace the previous Icon / Label slots that collided with the <Icon> and <Label> components
• Design philosophy section in Introduction docs explaining the unprefixed naming choice and the <Name>Content convention

Deprecated

• Old Icon / Label slot parameters remain as [Obsolete] aliases — existing code compiles with a warning; aliases are removed in 2.0

Added

• <Icon> component — Lumeo-native wrapper around Blazicons with Name, Svg, and Size (Xs, Sm, Md, Lg, Xl) parameters
• Icon finder docs page — search + library switcher across Lucide, Bootstrap, Heroicons, Feather, Octicons, Material, Fluent; reflection-based catalog covering all ~1,700 Lucide icons

Added

• Service interfaces — IToastService, IOverlayService, IThemeService, IKeyboardShortcutService, IComponentInteropService — for mockability in consumer tests
• DataGrid sticky header across scrolling viewport
• DatePicker support for DateTime binding alongside DateOnly

Improved

• DialogFooter button spacing, alignment, and responsive stacking polished
• DataGrid DX: cleaner row API, simplified column definitions, better defaults

Fixed

• Stacked bar chart: outer corners stayed sharp when theme had rounded corners — now uses per-segment borderRadius arrays so the theme's radius actually applies
• Dialog zoom-in animation transform leaked with fill-mode: both — keyframe end state switched to transform: none
• DataGrid column race where the grid rendered empty until the first interaction — fixed with InvokeAsync(StateHasChanged) in AddColumnDef
• Charts not repainting on theme change — JS dispatches lumeo:theme-changed; ECharts interop listens and rerenders

Added

• Rounded outer corners on stacked bar charts (top segment top-rounded, bottom segment bottom-rounded)
• Charts now rerender automatically on theme change — no page refresh needed

Fixed

• nupkg leaked package.json / package-lock.json and caused NETSDK1152 publish conflicts in consumer apps — moved npm build to repo root and excluded Styles/ from the package

Added

• Pre-compiled lumeo-utilities.css ships in the package — zero-config Tailwind for consumers; no local Tailwind build required
• Consumers who want Tailwind in their own markup can keep their own v4 build and drop lumeo-utilities.css — their build picks up every utility Lumeo needs

Added

• Built-in EN/DE localization via ILumeoLocalizer — driven by CultureInfo.CurrentUICulture with exact → neutral → English fallback
• Override or extend locales during AddLumeo(opts => opts.Add(...))
• DataGrid, Pagination, DatePicker, and other component default strings now translatable

Fixed

• Stacked bar chart rendering on dark theme

Fixed

• PasswordInput browser-autofill yellow highlight bled past the input's rounded corners — now clipped to the input's radius

Fixed

• DataGrid pagination test assertion updated to match the new footer wording

Added

• ColorPicker SV + Hue picker surface (replaces the earlier swatch-only design)
• Blocks polish pass — cleaner layouts across Authentication, Analytics, Calendar, Chat, Dashboard, E-Commerce, FileManager, Kanban, Settings, TaskTracker and more

Fixed

• Overlay positioning inside ancestors with transform / filter (these create a containing block that breaks position: fixed)

Fixed

• Textarea @bind-Value two-way binding
• TreeSelect cleanup on dispose
• Tooltip disposal race on rapid mount/unmount
• DataGrid pagination alignment and UX polish

Added

• DataGrid GroupsExpandedByDefault parameter

Fixed

• 7 reported bugs — Input two-way binding, DataGrid skeleton, sticky header, and grouping defaults
• DataGrid pagination layout — info left, page controls right

Added

• First stable release — 103 components, 8 themes, 1,316 tests
• CI workflow publishing to NuGet on GitHub Release
• Chart error-state visibility, autosave safety guards, DelayedDispatch for timer-based components

Improved

• 1.0 hardening — error visibility across async paths, shortcut handles simplified to IAsyncDisposable, toolbar errors routed to a single sink
• All dependencies updated to latest

Added

• Checkbox: Label and Description parameters with auto-Id for form label association
• RadioGroupItem: Description text support for helper text below radio options
• Steps: Error state per step with red X icon, custom Icon slot for any step indicator
• Popover: Arrow support (ShowArrow parameter) matching Tooltip arrow pattern
• 48 new unit tests covering all upgraded component features (1,124 total tests)
• Form Validation guide — DataAnnotations, custom validation, complete registration form example
• Contributing guide — setup, component creation conventions, testing, code style
• "When to Use" and "Related Components" sections on 62 more component pages (82 total)
• API reference tables now complete on all 136 component documentation pages

Improved

• Home page stats corrected (75→103 components, 7→8 themes)
• Chart patterns integrated into Patterns page with filter category
• All hardcoded colors replaced with CSS variables (Avatar, Statistic, Result, KanbanCard)

Fixed

• MentionPage Razor escape for @user syntax
• Statistic and Result test assertions updated for new CSS variable colors

Improved

• Updated NuGet package description (90→103 components, added test count and features)
• Updated README with accurate stats, all component categories, and install command

Added

• Dialog size variants (Sm, Default, Lg, Xl, Full) and Scrollable content mode
• Drawer multi-position support (Top, Right, Bottom, Left) with direction-aware swipe
• Alert: Title, Description, Icon slots, ShowIcon with default icons per variant, AutoDismiss timer
• Input: 3 size variants (Sm, Default, Lg) and Clearable mode with X button
• Tooltip arrow support with configurable Offset and fade animation
• Badge: Pulse ping animation on dot variant and Icon slot
• Accordion: DefaultValues for initially open items and Disabled items
• Skeleton: Wave/Shimmer animation variant alongside existing Pulse
• Spinner: Dots and Bars variants, Label text, and Color override
• HoverCard: Side parameter (Top/Bottom positioning)
• Tabs: Disabled tabs with aria-disabled and TrailingContent on TabsList
• Button: FullWidth mode, LeftIcon and RightIcon slots
• Progress: Circular SVG variant with ShowValue and configurable StrokeWidth
• Avatar: Square shape option and Status indicator (Online, Offline, Away, Busy)
• Switch: Loading spinner state and OnLabel/OffLabel text
• Select: Disabled items and Placeholder text on trigger
• Combobox: EmptyText for no-results state and Creatable mode
• NumberInput: Arrow key and mouse wheel support, Prefix/Suffix text
• Textarea: Character count display, MaxLength indicator, Resize control
• New Accessibility guide page with ARIA roles, keyboard patterns, and focus management docs
• New Changelog page with full release history
• API reference tables for 30 additional component documentation pages (55 total)
• "When to Use", "Keyboard Interactions", and "Related Components" sections on 20 component pages

Improved

• Animation keyframes and utility classes now ship in lumeo.css for NuGet consumers
• Production-quality spring easing curves (cubic-bezier(0.16, 1, 0.3, 1)) on all animations
• Rating colors now use themeable --color-rating CSS variable instead of hardcoded yellow
• Accessibility and Changelog pages added to sidebar navigation

Fixed

• Broken animations for NuGet package consumers (keyframes were only in docs site)
• Missing animate-toast-in — Toast slide-in animation was never defined
• Added aria-labels to PasswordInput toggle, TagInput close buttons, DatePicker clear button, and Carousel navigation
• Rating keyboard navigation with Arrow keys and improved star labels
• 5 failing tests updated for new Spinner, Avatar, and Select component structures

Added

• 14 new components: Cascader, Color Picker, Date Range Picker, Date Time Picker, Filter, Image Compare, Inplace Editor, Input Mask, Kanban, Mega Menu, Mention, Number Input, Password Input, Sortable List
• DataGrid enhancements: column menu, inline editing, column filtering, and toolbar improvements
• Keyboard shortcuts: R to shuffle themes, Ctrl+D for dark mode, Ctrl+/ for shortcuts help
• Redesigned WASM loader with animated splash screen, brand name, and ripple animation
• Floating navbar and floating sidebar design for the docs site
• NuGet package icon (Lumeo logo)

Improved

• All UI corners now respect the CSS radius variable, enabling zero-radius presets like Lyra
• Customizer sidebar moved to header button with Ctrl+B toggle shortcut
• Replaced raw HTML elements with Lumeo components across 113 doc files
• Converted raw HTML to Lumeo components in 7 pattern files
• QR Code live preview, theme persistence, and search palette enhancements
• CommandEmpty now always renders regardless of Command context

Fixed

• Customizer radius bug where radius values did not apply correctly
• Mobile docs improvements and API table horizontal scrolling
• Floating nav sticky positioning (moved animation off root element)
• Splash screen CSS compatibility with Tailwind CDN
• Em dash encoding issues in page titles
• FormWizardPattern closing tag mismatch
• Link/a tag mismatches in LinkPage and Home
• UTF-8 BOM in Home.razor

Added

• API reference tables for 25 component documentation pages
• Programmatic OverlayService for opening dialogs, sheets, and drawers from code
• Kbd component and KeyboardShortcutService for global keyboard shortcuts
• Scrollspy component for tracking scroll position and highlighting nav items
• 926 bUnit tests across 50+ components and 4 services (expanded from 240)
• CI workflow to run tests automatically on push and PR
• Toast position support (top-left, top-right, bottom-left, bottom-right, etc.)
• 19 new patterns on the Patterns page including drag-and-drop Kanban board
• Live world map demo for GeoMapChart
• Live interactive demos for all 5 service documentation pages
• New components: blocks section, filter docs, and comprehensive UI improvements
• Custom scrollbar styling

Improved

• Redesigned Themes customizer sidebar to match reui.io design
• Redesigned Themes and Patterns pages with new layout
• Replaced inline accordion sections with flyout popover menus in the customizer
• Default theme changed from Orange to Zinc to match Lumeo logo
• Softened chunky borders across overlay components
• Docs favicon updated to dark Lumeo icon SVG
• All services registered via single AddLumeo() call

Fixed

• OtpInput eval() XSS vulnerability patched; added IAsyncDisposable
• 9 failing tests for Calendar, OtpInput, and FileUpload
• Chart rendering: dropped source-gen serializer, resolved CSS variable colors
• Chart serialization and WordCloud rendering errors
• EChartCalendar range conflict and chart error handling
• Z-index issues for overlay components, theme loading, and toast variants
• Hanging ThemeServiceTests and stale Dialog/AlertDialog assertions
• Duplicate ondragover attributes in KanbanPattern
• Patterns page layout and broken CSS opacity modifiers
• GitHub Pages deployment issues with Tailwind v4 CDN and .wasm 503 errors

Added

• Initial release with 45+ shadcn-inspired Blazor components
• Full docs site with component pages, live demos, and code snippets
• 15 chart types powered by ECharts (Bar, Line, Area, Pie, Donut, Radar, Gauge, Treemap, Sunburst, Heatmap, Sankey, Funnel, and more)
• Patterns gallery page with reusable UI pattern examples
• Theme customizer with multiple color schemes and dark mode support
• 10 additional chart types: Scatter, Candlestick, Box Plot, Word Cloud, Geo Map, Calendar Heatmap, Theme River, Graph, Parallel, Radial
• 9 full-page pattern demos
• Layout primitives: Stack, Flex, Grid, Container, Center, Spacer
• Typography components: Heading, Text, Code, Link
• Form components: Button, Checkbox, Combobox, Date Picker, File Upload, Form, Input, Label, OTP Input, Radio Group, Select, Slider, Switch, Textarea, Toggle, Toggle Group
• Overlay components: Alert Dialog, Command, Context Menu, Dialog, Drawer, Dropdown Menu, Hover Card, Popover, Sheet, Tooltip
• Navigation components: Breadcrumb, Menubar, Navigation Menu, Pagination, Sidebar, Steps
• Data Display components: Avatar, Data Table, Table, Rating, Statistic, Timeline
• Feedback components: Alert, Badge, Empty State, Progress, Skeleton, Spinner, Toast
• ToastService, ThemeService, and ComponentInteropService
• GitHub Pages deployment pipeline