# @mielui/svelte 0.1.1 changelog This document aggregates the release notes for this version. Review it before integrating or upgrading Mielui. Large changes for this release have an LLM context page at [/changelog/0.1.1/llm.md](/changelog/0.1.1/llm.md). ## Breaking changes - Remove Fullscreen Nav. Use Sheet with navigation links for mobile menus. - Rename Modal to Dialog, including its types, package subpath, and CLI command. - Replace standalone Toast usage with Toast.Root and its composable parts. Toast progress bars have been removed. - Renamed Shortcut to Kbd, including its import path and prop type. - Require Svelte 5.33 or newer for attachment support. - Card titles default to level-two headings and accept an explicit heading level. - Alert announcements are opt-in, with separate polite and assertive modes. - Breadcrumb current-page state is explicit instead of inferred from the router. - Reorder List dragging starts from its handle; row content remains interactive and accessible. - Enforce mode-specific Input, Question, Accordion, and Toggle Group values and branch-specific Button and Badge attributes. - Require Svelte 5.56 or newer for modern reactive template declaration syntax. ## Features - Group components into Components, Blocks, AI components, and Chart components. Existing imports and docs URLs stay available. - Toast notifications use an inset content area with a title and action buttons in the footer. - Slider adds pill-shaped handles, a two-handle range mode, and right-to-left support. - Group connects related controls with separators and optional text, in horizontal or vertical layouts. - Add Heatmap with composable calendar, labels, summary, detail, legend, and keyboard navigation. - Add Morph for SVG geometry transitions and text changes, including the theme switch. - Add optional glass surfaces to overlays, menus, tooltips, selection popups, and toasts. - Add a centered component preview and wide or narrow canvases to Theme Studio. - Animate Heatmap cells and Gauge arcs on entry, with reduced-motion support. - Add Table with default and inset variants, plus Native Select with grouped and multiple options. - Add the Shimmer action and a shimmer variant for Skeleton. - Add site-wide documentation search with Command-K and Control-K. - Add a glass Composer surface and a Thinking text example for Shimmer. - Add composable Task Steps rows and summaries, Reorder List handles and content, and Message metadata parts. - Add separate Tool trigger/content parts, Color Picker surfaces, and Show More preview/trigger slots. - Add Command search/result slots, optional Alert icons, and an optional Sheet header close control. - Add controlled Context Menu state and manual tab activation. - Add scoped Tooltip providers and noninteractive rich descriptions. - Add composable Field, Fieldset, and Form components with accessible errors and SvelteKit remote-form examples. - Add Calendar, Range Calendar, Date Picker, and Date Range Picker with keyboard navigation and date constraints. - Add Number Field and OTP Field with native form submission and reset support. - Add Separator and a public composable Toolbar with keyboard navigation. - Add a swipe-dismissable Drawer with modal focus management. - Add a composable Data Table powered by TanStack Table v9, with explicit sort menus, editable filter chips, selection, and pagination. - Data Table filters accept a search control as children and align filter and sort buttons with inputs. - Form error summaries accept validation paths directly and focus after unsuccessful submissions. - Add File Upload with validation, progress, cancellation, retries, and animated completion. - Initialize Mielui from a Studio JSON preset with `init --preset`, or apply it with `add theme`. - Set glass surfaces globally from Studio or the `--mielui-surface` CSS variable. - Studio’s AI workspace demonstrates streamed Markdown, reasoning, tool activity, file attachments, and an overlaid composer with stop and replay controls. - Studio’s component preview centers interactive mini cards for controls, checklists, team members, and disclosures. - Checkbox supports small, medium, and large sizes, with a larger 18px default. - Add composable bar, line, area, mixed, pie, and donut charts powered by LayerChart, with tooltips, legends, and animated data updates. - Charts offer entry reveals and ongoing live highlights that respect reduced motion and pause offscreen. - Add a composable Empty State for first-use screens, empty search results, and completed work. - Add Notch for custom activities at any screen edge, with solid and glass surfaces and animated expansion. - Toast notifications can use a shared Notch surface through the Toaster variant. - Notch offers a persistent peek rail, timed notifications, and swipe dismissal, with timers paused during interaction. - Heatmap includes a shared tooltip for hovered and keyboard-focused days, with an optional Tooltip part for custom layouts. - Adjust edge highlight strength in Studio or theme presets. Controls, keycaps, and raised surfaces now use half strength by default. - Notch supports detached side actions that unfold on hover or focus. Notch notifications show one item at a time with previous and next controls. - Place counters or custom content outside a Notch with Accessory; notification counts now use this separate part. - Add built-in live motion to Gauge and Heatmap through their animation props. - Add built-in loading and empty-data states to Gauge and Heatmap. - Select and Combobox support multiple selection with array values and menus that stay open while choosing options. - Add the Number shuffle action and animate Gauge values with rolling digits. ## Fixes - Replace the logo and favicons with the approved compact cat silhouette. - Tag Input values have visible badge borders and backgrounds. - Toast timers pause during keyboard interaction, and close buttons remain visible. - Toast descriptions have more room above a compact title and action row. - Tag Input badges use stronger borders and a contrasting fill. - Homepage navigation uses equal button heights and spacing, with the redundant Components button removed. - Tag Input uses the standard transparent outline Badge styling. - Restore Changelog and Studio pages after TypeScript preprocessing and component path errors. - Preserve Group outer borders with single-pixel separators and composed Input, menu, and popup examples. - Match Alert to the inset Toast layout, with the description above the status row. - Render Tag Input tags as transparent outline badges. - Keep the darker inset panel inside frosted glass overlays. - Match Alert text size, vertical centering, and status-row spacing to Toast. - Use a minus indicator for checked checkboxes. - Keep morph visuals in place while updating SVG geometry without a delayed icon swap. - Keep the theme icon color synchronized with the active theme during morph transitions. - Align Switch labels with the pill-shaped control. - Keep Accordion borders between items only. - Restore original SVG visibility when Morph is removed or its child icon changes. - Respect the theme’s disabled-motion setting in chart entrances and motion actions. - Preserve checkbox state while disabled and forward accessible names to the native input. - Size Composer submission controls to their visible content and respect custom action labels. - Preserve fractional Gauge ranges and normalize invalid numeric values. - Fix preview deployment type checks for icon imports, native controls, table captions, and documentation examples. - Use Bits UI for dialogs, sheets, popovers, menus, selection controls, tabs, disclosures, switches, and toggles while retaining Mielui styling and motion. - Add menu keyboard navigation, typeahead, nested dismissal, and touch long-press behavior. - Preserve canceled events, optional overlay labels, and conditional dialog actions. - Keep option labels and disabled selections synchronized as collections change. - Prevent obsolete streams, clipboard requests, and canceled reorder gestures from overwriting newer state. - Reconcile toast persistence, durations, paused timers, and visible notification limits. - Connect field and tooltip descriptions to their controls, and ignore inactive or composing shortcuts. - Update scroll cues after content changes and support fractional progress ranges. - Preserve preview state when switching to source code and reduce redundant status animation. - Reset Avatar loading state on source changes and preserve native image callbacks. - Keep skeleton placeholders inert, normalize pagination bounds, and prevent silent inset Card footer replacement. - Add keyboard navigation to Toolbar and improve Color Picker labels, pointer ownership, and reduced motion. - Preserve Slider handle identity while adopting Bits UI keyboard behavior and adding named form values and reset support. - Use Bits UI for Combobox navigation and selection while preserving fuzzy search and Mielui styling. - Show submission errors without losing Composer drafts or Question answers, and ignore obsolete completions. - Keep disabled Button links from navigating and preserve native Input checkbox, radio, and file semantics. - Repair active tabs after removal or disabling, and keep Command results synchronized during collection changes. - Keep IME confirmation and canceled click handlers from activating commands or opening selection popups. - Give toasts one visual exit and stop long response streams from animating every character. - Preserve Group variant styling with a single joined divider. - Forward overlay action refs and keep cancel actions from stealing focus after opening. - Defer offscreen documentation previews while preserving mounted preview state. - Remove the resting shadow from outline buttons while retaining their border and keyboard focus indicator. - Show invalid input borders and reveal field errors with interruptible, reduced-motion-aware transitions. - Restore pointer hover and selection in menus and floating panels by keeping their content above dismissal layers. - Keep top and bottom drawers full width in the examples and give nested drawers separate backdrops and focus boundaries, with cancelled swipes returning to rest. - Prevent date segments from overlapping on narrow screens and keep calendar popups above surrounding navigation. - Keep advanced Studio spacing and motion overrides until their corresponding preset changes. - Match date-picker trigger heights to their inputs and keep hover feedback distinct. - Position Toast dismiss buttons at the top-right without covering the message. - Use round send and stop icons in Composer without changing its toolbar variants. - Show rejected attachments in compact error cards without decoding oversized image previews. - Animate promise toast resizing in 50 ms and place title-only messages inside a fitted inset panel. - Preserve Studio color, typography, spacing, and motion choices in CLI-compatible theme exports. - Keep tab highlights aligned while their dialog or other parent animates in. - Studio places advanced colors below the color controls and groups shape and motion presets with labeled advanced-settings buttons. - Studio previews share one surface, with dedicated Charts and AI tabs and flush joins on advanced-setting controls. - Studio uses full-width previews, a denser component gallery, and joined preset and copy controls. - Studio shows a year of heatmap activity and pairs a full-width conversation with the narrower Composer layout used in its documentation. - Fix TypeScript errors in composed controls, upload and toast motion, and documentation examples while preserving native event handlers and refs. - Update the docs and installer workspace to Svelte 5.57.1 and SvelteKit 2.70.3, with svelte-check 4.7.6. - Honor a consumer project's declared package manager and recognize Bun lockfiles in the CLI. - Keep theme editing usable when browser storage is blocked or full, and report failed theme saves. - Keep upload image previews stable as progress changes. - Keep Dialog, Sheet, Popover, and File Diff state synchronized with their bound values and current props. - Restore nested dialog stacking, single-layer dismissal, focus return, and shared background scroll locks. - Cache the GitHub star count and retain the last valid count during temporary API failures. - Preserve invoice-preview state when switching Studio tabs. - Buttons, fields, selects, and floating surfaces share subtle light-catching edges that follow the theme’s shadow settings. - Gauge defaults to a larger 120px display with proportional arcs and labels, and smoothly animates value changes. - Pie chart tooltips use opaque inset surfaces. - Menus, overlays, tooltips, conversation scrolling, and response text respect reduced motion and the theme’s disabled-motion setting. - Accordion triggers retain their content relationships, and focus traversal includes editable text regions. - Joined inputs, selects, and buttons share one control height across sizes. Table badges fit their labels instead of filling the cell. - Segmented tabs keep even rail padding at fractional spacing and inside scaled containers. - Keep inset Cards stable when their footer is removed during a state change. - Studio groups edge highlight strength under its switch and restores the previous strength when re-enabled. - Data Table uses the shared inset Table surface with a compact header. - Alert dialogs announce their title and description. Select triggers and option lists now expose linked combobox semantics and accessible names. - Combobox results collapse smoothly when filtered and stop locking page scroll as soon as the menu closes. - Give Notch content more padding and keep its detached actions close to the panel. - Dialogs restore focus when removed while open without interrupting a newly opened dialog. - Escape closes only the deepest open dropdown or context submenu, keeping its parent menu available. - Notch side actions unfold with synchronized shape and button motion, including interrupted hover changes. - Morph and Shimmer stop active effects when inherited theme motion is disabled and clean up their theme observers on removal. - Stopping a controlled Composer response no longer submits the preserved prompt again when the control returns to Send. - Let Show More content fade into its surrounding surface without a mismatched background strip. - Rework live chart motion with stationary pie highlights, area-fill sweeps, and staggered bar highlights; keep offscreen effects paused without trapping visible sweeps. - Keep Reasoning duration labels spaced, respect reduced motion in copy feedback, and keep notch notification text wrapped during morphs. - Guard font preference storage and isolate font state between server renders. - Keep Accordion accessibility relationships valid when content is omitted and honor disabled Tag Input controls. - Keep disabled Popover triggers closed and dismiss empty tooltips. - Preserve invoice draft validation and reset stale filters when creating or locating an invoice in Studio. - Scale Heatmap entrance timing with the theme motion setting. - Keep page-outline jumps aligned after lazy previews load and track section headings by their document position. - Remove content and icon morphing from Toast notifications, including stacked Notch notifications. - Prevent hidden chart data tables from creating extra scroll space inside previews. - Give chart loading and empty messages the shared inset card appearance. - Match Heatmap tooltips to the shared chart surface and inset the Gauge arc inside a thicker track. - Give Gauge arc ends a subtle corner radius. - Keep Gauge loading and empty states compact without a nested card. - Preserve the Heatmap calendar layout while loading or showing no activity. - Match the Gauge background track to its colored arc thickness. - Restore the Color Picker hue slider’s rainbow track. - Match catalog preview button text colors to the active theme. - Place Switch edge highlights on the thumb, keep passive surfaces flat, and preserve control edges when fields and buttons receive focus. - Restrict the native file picker to one file when maxFiles is one. - Keep File Upload removal animations inside the file list instead of jumping toward the viewport corner. - Preserve the Gauge loading ring while using theme colors for its mask. - Keep slider dragging focused without rescheduling focus on every pointer movement, and clear stale tab hover indicators when tabs disappear or become disabled. - Honor motion settings and visibility for spinner, progress, and shimmer animations; update traveling highlights when theme motion settings change. - Restore Notch swipe position and release pointer capture when gestures reverse or are cancelled. - Handle large chart datasets without argument-limit failures and avoid rebuilding number formatters for every tick or slice. - Parse small percentage color alpha and repeated CSS variable references correctly in Studio. - Keep Studio header sizing within supported limits and reject font values that can break generated CSS declarations. - Show indeterminate attachment progress for nonfinite values and refresh Morph text colors after theme changes. - Evaluate nested Studio length calculations with correct arithmetic precedence and root-relative units. - Include upstream license and attribution notices with CLI source installations without replacing the application's own license. - Remove unused bundled documentation fonts that lacked accompanying license notices. - Keep theme registry schema normalization compatible with its Elysia runtime. - Avoid false tab-alignment test failures caused by browser subpixel rounding. - Prevent dependency discovery from reloading browser tests during fresh CI runs. ## Docs - Use pnpm and Node.js for repository setup, development, and release tooling. - Added a component audit covering behavior, accessibility, composition, and motion. - Moved Show More into Blocks. - Toolbar now appears under Blocks. Its import path stays the same. - Add manual installation instructions with dependency commands, file tabs, copying, and expandable source. - Add a right-aligned On this page sidebar with smooth section navigation and reduced-motion support. - Move Gauge into Chart components. - Use Hugeicons throughout components and examples, with an SSR-safe HugeiconsIcon renderer. - Use dashed guides in the left documentation navigation. - Add replay controls to inset chart previews. - Align the documentation breadcrumb with the article heading. - Add Copy page actions with Markdown and AI links. - Replace anatomy summaries with prop tables for every exported component part, including native attributes and events. - Add the Agent skill guide and a complete llms-full.txt reference. - Update example identities and project links to mielsense. - Improve code-example formatting and separate API reference links in the page outline. - Document every Table and Native Select part and use Table for API references. - Shorten repetitive documentation copy and update component counts. - Soften the scrolling edge beneath the documentation toolbar. - Animate native-attribute disclosures with Collapsible. - Align Star and theme controls with the page outline and use a home icon in breadcrumbs. - Document component reuse and accessible interaction motion in the design guidelines. - Group Reorder List, Command, Color Picker, and Toast under Blocks while preserving their imports and documentation links. - Include motion actions in the component catalog and keep its counts and search in sync with navigation. - Show headless component props in the main API tables and document props from every discriminated mode. - Join the publish-date input and calendar trigger with Group in the Date Picker example. - Keep the Number Field seat-count example compact instead of stretching the control to its container. - Show Data Table search and filtering as one joined control. - Replace the Toolbar demo with selectable design tools and keyboard hints. - Rebuild Studio previews with aligned control states, Charts and AI sections, and an invoice table. - Separate basic remote form validation from multiple actions and reset. - Allow unrestricted cross-month selection in the two-month Range Calendar example and show its selected dates. - Join Date Range Picker inputs and calendar trigger with Group. - Add a promise-toast demo and use promise notifications in Form examples. - Organize Studio theme controls into collapsible sections with a tooltip-labelled advanced settings button. - Give both levels of the nested Drawer example handles and normal dismissal. - Add Bun install commands with syntax highlighting. - Add composed examples for File Upload, Reorder List, Toolbar, Separator, and Response Stream. - Add tooltips to Studio and documentation icon actions. - Simplify the top navigation to Docs and Studio. - Replace machine-specific paths in the design-system implementation plans. - Derive homepage component counts from the catalog and check each catalog entry's category, examples, and API reference. - Document controlled overlays, upload cancellation and retry, and theme storage limitations. - Add a live File Diff example and refresh generated component prop tables. - Use shared border, radius, and elevation tokens in legacy API tables. - Document shared edge, inset, focus, and motion rules for component contributions. - Keep Notch and notch notification examples inside their preview frames. - Make chart state and period-switching examples easier to adapt with named event handlers. - Chart guides have dedicated type pages, searchable navigation, and matching Markdown references. Tablet documentation navigation remains accessible. - Split chart examples into focused bar, line, area, mixed, pie, and donut guides with continuous motion, data updates, missing measurements, and loading states. - Add interactive Gauge capacity and Heatmap reporting-range examples. - Use flat leading previews and source sections, inset example cards, compact API table headers, and persistent footer page actions. - Block examples now include contained toast previews, continuous Markdown streaming, recoverable task steps, and visible command and code-action results. - Component examples now include working local actions, accessible icon controls, upload completion and recovery, and shorter variant comparisons. - Make AI examples finish, stop, and retry their simulated work; preserve partial responses and clean up pending delivery when previews close. - Document AI state ownership and add composed tool retries, response cancellation, and interactive Morph and Shimmer examples. - Rebuild Docs and Studio around fixed headers and footers, thin section dividers, and quieter navigation. Widen the documentation section rail. - Clarify inherited glass surfaces and keep example action results spaced below their controls. - Center the homepage cat within a bordered layout with subtle dithering and muted scrolling component names. - Keep preview toolbars aligned across nested examples and prevent their controls from overlapping pinned section headings. - Clarify core component setup and form behavior, and make the Group and indeterminate Progress examples interactive. - Balance section content spacing, keep sticky headings opaque, and center grid intersections across the documentation rails. - Keep navigation headings and the leading preview toolbar sticky, use text-only hover and selection states, and show API guidance from an info control. - Align footer actions with the header columns and disable elastic overscroll across the site. - Match error pages to the documentation grid and provide a retry action when a page fails to load. - Add visual component catalog cards with descriptions and search across component names and descriptions. - Present each changelog version as a sticky section and keep catalog descriptions in footer info cards. - Simplify Studio into aligned control and content previews, unify its tabs, and match footer and header heights. - Move Studio preview tabs into the header and preview width controls into the footer. - Keep headers, footers, section headings, and navigation headings at one shared height, with aligned intersection marks. - Align Studio chart, conversation, and application previews with the shared section layout and keep the composer clear of messages. - Strengthen section headings and move Button behavior notes into its Usage section. - Keep component behavior notes inside their relevant sections instead of below standalone previews. - Remove the trailing divider below Studio’s Typography controls. - Widen Studio’s conversation preview and place its simulation note below the composer. - Let the Studio conversation span the preview and scroll behind a narrower floating composer. - Add matching grid junction markers at the Studio header and footer. - Clarify block and AI component usage, state ownership, and Markdown link and image handling. - Review every component’s usage, examples, and API coverage; add chart loading, empty-data, and animation examples to each chart-type guide. - Keep documentation scrolling available over Toast previews and show section descriptions in information hover cards. - Remove excess space below the final documentation sidebar item. - Use warm pastel red and yellow series colors in chart examples. - Add loading, empty, and live-motion controls to Gauge and Heatmap examples. - Show a larger invoice dataset in Studio using the shared Data Table, with sorting, selection, and pagination. - Arrange Studio component cards in compact responsive stacks, with a smaller calendar and label and sharing examples. - Remove the repository’s OpenCode setup and skill lockfile. - Show the Markdown preview directly on the canvas without a card or nested scroll area. - Group components by type in the sidebar, with a preview catalog for each group. - Make documentation search more compact, with quick destinations and a scrollable results list. - Add space between catalog cards and use consistent parent-label styling and spacing for all nested sidebar groups, including charts, while keeping standalone links compact. - Keep the expanded Notch export example clear of its trigger and show its file count in a compact badge. - Nest catalog categories under Components in the page outline. - Increase the space between component catalog sections. - Clarify the homepage description of component theming. - Match the Code tab background and rounded corners to its example preview. - Add a single-file upload example that replaces the dropzone with the selected file. - Gently snap sidebar groups and page sections to the top while preserving free scrolling within long sections and reduced-motion preferences. - Snap sidebar group headings to the top without snapping to the bottom edges of long groups. - Give consecutive documentation examples more separation while keeping their headings and previews together. - Prevent sidebar settling from targeting offscreen groups; only visible headings approaching the top can catch. - Align page-outline link gutters and nested indentation with the navigation sidebar. - Use the same bounded top-only magnetic settling in the content column and sidebar. - Give the page-outline hook a full outer gutter and more space before its labels. - Align the footer info icon with the navigation button inset and distinguish outline hover previews with a dashed gray hook. - Move the page-outline hook directly to a clicked section without pausing on headings passed during smooth scrolling. - Keep catalog search pinned in a header-height row, with section headings and outline jumps positioned below it. - Slow the page-outline hook’s glide while retaining direct section targeting and reduced-motion behavior. - Remove the doubled divider between catalog search and the first section. - Match article, toolbar, and footer side gutters to the page-outline header. - Align the leading Preview / Code tabs with the shared content gutter. - Give documentation content a moderate side gutter while keeping tabs, headings, toolbar, and footer aligned. - Scale magnetic catch distances to neighboring section heights and settle only once per downward scroll gesture, preventing short sections from oscillating. - Match the Copy page control height to the adjacent-page arrows in the docs footer. - Keep Form and keyboard-shortcut demo feedback inside their previews and dispose unfinished toast demos on navigation. - Separate page-outline state and Studio token parsing from presentation while reducing unnecessary outline work during preview updates. - Update the agent skill and package guides for Mielui's current APIs, independent release history, and retained Sivir UI and COSS attribution. - Refresh the README screenshot with the current homepage. - Clarify current documentation sources and distinguish the historical Sivir UI changelog from Mielui releases. - Document npm publishing authorization and the GitHub release steps for maintainers. - Add agent release guidance and clarify first-publication setup before enabling trusted publishing.