Changelog

What's new in each version of SoftUI.

v1.16.3

Avatar Groups, Date Sorting, Away Status and Fixes

New:
  - Data table: data-sort="date" sorts by date (reads a <time datetime>
    in the cell, or parses the text). Any cell can set data-sort-value to
    override what is sorted
  - sui-avatar-status-away (amber presence dot)

Fixes:
  - Avatar groups no longer clip two-letter initials: the overlap scales
    with avatar size and covered avatars center their initials in the
    visible part. The overlap now also works in RTL
  - sui-sr-only text inside a scroll container no longer widens the page
  - The hidden attribute always hides SoftUI elements, including alerts,
    hints and anything with a display utility
  - Segmented controls position their indicator correctly when they start
    hidden (inside a tab, modal or collapsed panel) and are shown later

v1.16.2

Flex Grow & Shrink Utilities, Logo Avatars

New:
  - Flex grow and shrink utilities: sui-flex-1 (fill the remaining space),
    sui-flex-auto, sui-flex-none, sui-flex-grow-0 / -1 and
    sui-flex-shrink-0 / -1. Equal-height cards can now sit under headings
    that stay outside the cards
  - Logo avatars: sui-avatar-logo fits the whole image inside the circle or
    square with breathing room (object-fit: contain), so raw logo files
    work without editing

v1.16.1

Stat Footers Line Up, Top and Bottom Auto Margins

Fixes:
  - Stat card footers (sui-stat-footer) sit at the bottom of the card, so
    they line up across a row even when labels wrap to different line
    counts. The gap above the footer stays at least 12px (8px compact).
    Browsers without :has() keep the fixed gap

New:
  - sui-mt-auto and sui-mb-auto, completing the auto-margin utilities

v1.16.0

Theme Switcher, AA Colors, Section, Footer, Links & Scroll Reveal, Framework-Ready JS

New Components:
  - Theme Toggle — data-sui-theme-toggle on any button toggles dark mode;
    data-sui-theme-toggle="light" | "dark" | "system" sets that value;
    <html data-sui-theme-auto> follows the OS with no button. Saves the
    choice, follows the OS until the user picks, syncs across tabs.
    SoftUI.theme.get/set/toggle/clear/system and a sui-theme-change event
    ({theme, source}). New sui-theme-toggle sun/moon button (-sm, -lg)
  - Scroll Reveal — sui-reveal with -start, -end, -down, -fade, -scale,
    -zoom-out, -blur; speeds sui-reveal-fast / -slow; --sui-reveal-blur;
    data-reveal-stagger, data-reveal-repeat, --sui-delay,
    --sui-reveal-distance, --sui-reveal-duration and SoftUI.reveal().
    Content stays visible without JS, under reduced motion and in print
  - Section — sui-section / sui-section-sm page spacing, sui-section-header
    with sui-section-title, sui-section-subtitle, sui-section-action, and
    sui-heading-accent. Sizes sui-section-sm / -lg; surfaces
    sui-section-raised, -inset, -alt, -bordered; sui-section-header-center
    and -bordered; heading accent colors (-success, -danger, -warning,
    -info), -lg and -bottom
  - Footer — centered, split (sui-footer-split) and multi-column
    (sui-footer-columns), bordered / raised / inset / tinted, compact
    (sui-footer-sm), raised links and social icons (sui-footer-social)
  - Links — sui-link (underlined prose link), sui-link-subtle,
    sui-link-muted, sui-link-arrow (RTL-aware), sui-link-external,
    sui-link-raised, sui-link-underline-hover, colors (-success, -danger,
    -warning, -info) and sizes (-sm, -lg)
  - Status Dot — sui-status-dot with colors, -sm / -lg, -pulse, and a
    sui-status label wrapper

New:
  - Hero: sui-hero-start (start-aligned) and sui-hero-split (text + media
    side by side from 992px: sui-hero-content, sui-hero-media,
    sui-hero-media-start)
  - Display headings: sui-display-1, -2, -3 (fluid)
  - Stat card footer: sui-stat-footer pill with a --sui-fill bar and
    -primary / -success / -danger / -warning / -info tints
  - Avatars: sui-avatar-2xl (120px) and sui-avatar-3xl (160px)
  - sui-flat-all — on a container, turns every neumorphic shadow inside
    (including toggle knobs and range thumbs) into a hairline outline
  - Spacing scale 0-7 (0/4/8/16/24/48/64/96px) backed by --sui-space-0..7.
    New sui-px/py/pt/pb/ps/pe-*, sui-mx/my/ms/me-*, sui-my-auto,
    sui-gap-6 and sui-gap-7. Start/end classes flip in RTL; sui-ml-* and
    sui-mr-* stay as aliases of ms/me
  - Font utilities: sui-font-sans, sui-font-mono, sui-tabular-nums,
    sui-proportional-nums
  - Images: sui-img-fluid, sui-img-frame. Aspect ratio: sui-aspect-4-5
  - Sidebar: off-canvas drawer below 900px (data-sidebar-open,
    data-sidebar-close, overlay, Esc), sui-sidebar-static,
    sui-sidebar-drawer, sui-sidebar-trigger-mobile, and
    SoftUI.sidebar().open() / close() / isOpen()
  - Tokens: --sui-{primary,success,danger,warning,info}-text and -text-hover
    (AA text shades), --sui-warning-contrast, --sui-font-mono,
    --sui-space-0..7, --sui-section-space / -sm / -lg / -xs,
    --sui-section-header-gap. Optional: --sui-focus-ring,
    --sui-focus-ring-color, --sui-link, --sui-link-hover,
    --sui-link-underline, --sui-heading-accent
  - Embed build: dist/softui-embed.css and softui-embed.min.css. Same
    components and tokens, without the global reset, body styles, element
    typography, scrollbar, reduced-motion and print rules outside SoftUI
    elements
  - window.SoftUI is a real global and the package's CommonJS / ES default
    export (import SoftUI from 'softui-css'). Importing on the server (SSR)
    is a no-op; loading the script twice reuses the first copy
  - SoftUI.init(root) sets up markup added after load (element, selector or
    nothing; safe to repeat). SoftUI.version
  - A component that fails to initialize logs "[SoftUI] <name> failed"
    and no longer stops the others
  - SoftUI.modal(), SoftUI.sheet() and SoftUI.carousel() accept an element
  - Typewriter and Text Rotate: data-reserve (fixed width), data-sr-text
  - New events: sui-copy, sui-copy-error, sui-tree-toggle, sui-diff-change
  - Token --sui-edge-mix (22% light, 38% dark): how much --sui-text-light
    goes into the hairlines and control edges that must show in both themes
  - Ghost buttons cover all six colors: sui-btn-ghost with sui-btn-warning
    or sui-btn-info
  - Speed dial trigger colors sui-speed-dial-warning and -info
  - sui-rounded-xs (--sui-radius-xs, 6px)
  - sui-color-palette-item: a palette label plus its swatch row, no inline
    style needed
  - sui- names for the SVG line/area chart parts: sui-chart-line, -area,
    -dot, -grid-line, -axis-label, and colors such as
    sui-chart-line-success or sui-chart-dot-info. The old chart-* names
    still work
  - List group items can be <button type="button"> (e.g. sub-menu
    toggles); a sui-dropend flyout in a list group opens below its item on
    screens 600px or less
  - Pagination: a disabled button (disabled) or link (aria-disabled="true")
    is muted with no hover lift, like .sui-page-item.disabled
  - Color input: softui.js updates .sui-color-input-value when a color is
    picked
  - Tour: Escape closes it; next(), prev() and goTo(n) do nothing when out
    of range (they used to throw); padding: 0 is respected; onComplete
    runs once

Changes (check these when upgrading):
  - Colored text uses the new -text shades: links, outline and ghost
    buttons, outline badges and chips, alerts, sui-text-*, steppers, toasts
    and active nav. Darker in light mode (warning text is now brown),
    lighter in dark mode (link hover gets lighter, not darker). If you
    rebrand --sui-primary, also set --sui-primary-text and -text-hover in
    each theme
  - Success and info fills are slightly darker so white text passes AA:
    --sui-success #1FA96E → #198758 (hover #178A59 → #126D47),
    --sui-info #1A82D4 → #187AC8 (hover #146BAE → #1364A3)
  - --sui-text-light: #6A7D94 → #526072 (light), #8A94A6 → #939CAD (dark)
  - --sui-text-muted (light): #5A6A7E → #4D5A6D, so muted text also passes
    AA on --sui-bg-dark
  - Dark-mode warning fills (buttons, badges, chips, filled alerts) use dark
    text (#2D3748) instead of white
  - Tints, glows and focus rings use color-mix() and follow your color
    tokens at any scope. Old-palette tints now match the current palette
    (slightly deeper); the info chart color is now --sui-info.
    Browser baseline for these effects: Chrome/Edge 111, Safari 16.2,
    Firefox 113. Older browsers lose tints and rings; layout is unaffected
  - Spacing (sui-p-*, sui-m-*, ...), text color and alignment (sui-text-*),
    radius (sui-rounded-*) and aspect-ratio (sui-aspect-*) utilities now use
    !important, like display, flex and gap. They now override component
    defaults (e.g. sui-modal-body sui-p-0) and inline margin/padding on the
    same element. Custom CSS that overrode them at equal specificity now
    needs !important
  - Gutter classes sui-g-*, sui-gx-* and sui-gy-* now apply (a default rule
    used to force a 24px horizontal, 0 vertical gutter). sui-g-0 is now
    flush, g-1/2/3 are narrower, g-5 is wider, and g/gy rows get vertical
    gaps between wrapped lines
  - All component events now bubble. New sui-* aliases: sui-editable-save,
    sui-editable-cancel, sui-countdown-end (editable:save, editable:cancel
    and countdown:end still fire)
  - Toast title/message and tour title/description are inserted as plain
    text (XSS fix). Pass html: true for trusted HTML. File upload names are
    always text
  - Escape closes only the topmost modal or sheet; static modals, alert
    dialogs and static sheets shake instead of closing. An open dropdown,
    popover, menu, combobox, styled select, speed dial or lightbox inside
    it is closed first, on its own Escape
  - sui-mx-auto and sui-my-auto moved into the spacing utilities, before the
    single-side classes, so sui-mx-auto sui-ms-3 now gives a 16px start
    margin (sui-ms-auto / sui-me-auto still win over sui-ms-* / sui-me-*)
  - Sidebars become an off-canvas drawer below 900px; add
    sui-sidebar-static to keep one inline
  - Navigation menu: clicking a sub-menu parent opens/closes its sub-menu
    instead of following its link
  - Scripted motion respects prefers-reduced-motion: carousel autoplay,
    text rotate, typewriter, radial count-up, scroll reveal, and
    scrollspy/tour smooth scrolling
  - data-theme sets color-scheme, so native scrollbars and form controls
    match the theme
  - Scoped themes fully reset component tints, the select arrow, borders,
    scrollbars, warning text and the loading overlay; the overlay follows
    the theme background
  - code, kbd, OTP slots, color picker, copy input and calendar time use
    --sui-font-mono. --sui-font also lists 'Plus Jakarta Sans Variable'
  - The hero title scales smoothly (clamp) instead of jumping at 600px
  - Typewriter block and underscore cursors blink; text already in the
    element is kept and typed over
  - Playground preview iframe no longer has allow-same-origin, so shared
    #code= links cannot run script against the docs site
  - Button groups scroll sideways on screens 600px or less instead of
    wrapping onto a second row
  - Pricing cards shrink to 200px (was 240px), so three plans fit side by
    side in a ~700px column
  - Progress with label: the label sits at the end of the fill in a
    contrasting color (it was muted text centered over the bar)
  - Disabled toggles: opacity 0.5 → 0.6
  - Table inset looks recessed: transparent header, --sui-bg body

Fixes:
  - Badge dot inside sui-badge-positioned is a 10px dot (was an 18px pill);
    added the info dot color
  - Cards: images keep their aspect ratio and match the card radius;
    overlay cards are positioned and clipped automatically; cards drop
    their padding for direct images; sui-card-horizontal is a real row
  - Outline toggle group border and default sidebar shadow restored
  - Printing a dark page (or a scoped dark section) uses the light palette
  - Focus returns to the opener on every modal/sheet close; body scroll
    unlocks only when no overlay is open
  - Opening a modal or sheet moves focus into it (it stayed on the opener),
    and Tab pulls focus back inside if it has escaped
  - SoftUI.carousel(el) returns the existing instance instead of building a
    second one with its own position, listeners and autoplay timer
  - Command dialog open buttons added after load work
  - Inset sidebars get a solid background when shown as a drawer
  - Drawer drag-to-dismiss threw an error and left the drawer open
  - Carousel: autoplay intervals no longer stack; rewind-mode dots and
    goTo() stop at the last full page
  - Datepicker in 24-hour mode no longer adds "AM"
  - Copy button: falls back to execCommand (works over http), restores its
    own icon or label, survives double-clicks, .copy-failed state
  - Password toggle no longer swallows click events
  - Countdown: an invalid data-date shows "--"; a past date no longer
    throws; relative dates may contain spaces ("+2y 5d")
  - Timeline compact + right / alternate margins
  - Stack back cards show inside surfaces and cards (isolation)
  - Tour no longer dims the highlighted target
  - Bottom-center toasts slide up from the bottom edge
  - Text rotate exit animation in RTL
  - RTL via logical properties: navbar brand, timeline, alerts, filled
    alerts, blockquotes, table headers and corners, sortable data table
    headers, lists, bordered stats, positioned badges, avatar status dots,
    navigation menu
  - Dark mode: unchecked toggles, checkboxes and radios, range and slider
    tracks and thumbs, the segmented indicator and OTP slots get a faint
    edge; outlined buttons, drop zones, file upload, empty rating stars,
    outlined kbd, bordered nav menu, OTP dividers, timeline dots and
    connectors, skeletons and color swatches are visible again
  - Phone mockup: cutouts stay dark on every frame color (the island and
    notch were invisible on White); sui-phone-landscape turns the screen
    with the frame instead of overflowing it
  - Command palette: arrow keys, Enter and hover skip disabled items
  - Slider warning value badge uses --sui-warning-contrast (white was 2:1)
  - Breadcrumbs wrap on narrow screens; navbar links wrap on mobile (the
    rule targeted a class that does not exist)
  - Mobile (600px or less): horizontal steppers stack like the vertical
    one; the tab list scrolls instead of clipping panel shadows; calendar
    with two months stacks; countdown wraps; line/area chart axis labels
    stay readable
  - Carousel with gap leaves room for card shadows; diff vertical labels
    Before at the top and After at the bottom; alert icons have a fixed
    width; the combobox multiple placeholder is muted; striped
    descriptions get side padding
  - Wrapping tooltips (sui-tooltip-wrap) use their full 280px instead of
    the trigger's width
  - Section header gap on mobile is 70% of --sui-section-header-gap (was a
    fixed 28px), so overriding the token works
  - Display headings never render smaller than sui-h1 on phones
  - Radial progress inset keeps a faint track and shows the pressed-in look
  - sui-kbd-inline is an inline-block, so single glyphs like arrows read
  - Theme: with localStorage blocked, the theme switcher keeps a data-theme
    the page already set

Accessibility:
  - Contrast: colored text (-text tokens) meets WCAG AA 4.5:1 on every
    --sui-bg* surface in light and dark; text on filled buttons, badges and
    chips meets 4.5:1 (white, or #2D3748 on warning)
  - Keyboard support and roles: rating (slider), color swatches (radio
    group), tree view (ARIA tree), editable text (button), lightbox (dialog
    with focus trap), diff (slider), navigation menu (arrows, Esc,
    aria-expanded), sidebar drawer (focus trap, Esc)
  - Focus-visible rings: dock, swap, speed dial, data table selects,
    calendar AM/PM, copy buttons, color swatches, navigation menu;
    context-menu items reached by keyboard get the hover highlight
  - Speed dial: aria-expanded, Escape closes it, closed actions leave the
    tab order; dock and speed-dial labels show on focus
  - Typewriter and text rotate: screen readers hear the full text once,
    without the cursor glyph
  - Scroll reveal: hidden content appears when it receives focus, and short
    elements at the very end of the page are revealed
  - Vertical diff slider: PageUp/PageDown move the handle the same way as
    the Up/Down arrows
  - Playground editor is no longer a keyboard trap (Esc then Tab leaves)

Docs:
  - New pages: Section, Links, Footer, Scroll Reveal
  - Demo captions are one short sentence; keys, attributes, events and
    tokens go in a Reference table (new on Command, Data Table, Drag &
    Drop, Dropdown, File Upload, Input OTP, Menubar, Navbar, Resizable,
    Speed Dial, Stack, Toast, Tour, Position, Radius). Class names in
    Reference tables are written without a leading dot
  - New sections: Hero (Start Aligned, Split), Typography (Display), Stat
    Card (With Footer), Badges (Status Dot), Shadows (Flat Scope), Avatars
    (Sizes: 2XL/3XL), Sidebar (Mobile Drawer), Timeline (RTL), Spacing
    (Spacing Scale, Padding/Margin Directions, Spacing Tokens), Text (Font
    Family & Numerals), Sizing (Images), Aspect Ratio (4:5), Typewriter /
    Text Rotate (Reserve Space), Hero (Split, Media First), Slider (With
    Label, With Ticks), Kbd (Inline), Chart (Donut Sizes), Descriptions
    (Horizontal), Stack (Directions), Swap (Sizes), Navbar (Full Width),
    Result (Info), List Group (With Icons, Flush), Marquee (Speeds),
    Sidebar (Inset, Sizes), Button Group (Segmented), Toggles (Radio
    Colors), Tooltips (Multiline), Phone Mockup (Landscape)
  - Theming: theme switcher, text shades, tints and focus rings, link and
    section tokens, dark-theme halo note, loading the fonts
  - Getting Started: JS API, frameworks with SoftUI.init, events, embed
    build; the JS size is measured at build time
  - The no-flash snippet no longer hides the body with opacity:0, so it
    also works with the embed build
  - Fixed "On This Page" links on Alerts, Badges, Buttons, Cards, Progress
    and Toggles; fixed Playground snippets with non-existent classes
  - 118 playground snippets (new: Theme Toggle, Hero Split, Section &
    Header, Stat Card Footer, Status Dot, Footer, Scroll Reveal, Links),
    with variants for section surfaces, hero alignment, footer layouts,
    reveal directions and effects, and status dot and link sizes
  - The docs footer uses sui-footer

Tooling:
  - npm run build:embed; build:min also builds the embed files and syncs
    the "/*! SoftUI vX.Y.Z" banners and SoftUI.version from package.json
  - Publish workflow checks the npm registry, installs with
    bun --frozen-lockfile and can be run manually; npm run dev works on
    Windows cmd.exe

v1.15.0

Existing-Site Support: Surface, Scoped Themes & Sturdier Flat

New:
  - Surface (sui-surface) — paints the SoftUI background, text color, and
    font on a section, so components render correctly inside existing sites
  - Scoped themes — data-theme="dark" / "light" now works on any element,
    not just <html> (shadow tokens re-resolve per section)

Fixes:
  - sui-flat now removes the shadow of the element it is on, including
    hover and active states; keyboard focus keeps a visible ring. Inner
    parts such as toggle knobs and range thumbs keep their shadows (see
    sui-flat-all in v1.16.0 to flatten a whole area)

Docs:
  - "Using in an Existing Site" section on Getting Started
  - Scoped themes on the Theming page
  - "Flat on Any Background" demo on the Shadows page

v1.14.0

Navigation Menu, Segmented Control, Countdown, Scrollspy, Editable Text

New Components:
  - Navigation Menu — dropdowns, mega-menu, icons, groups, bordered, raised,
    inset, hover-to-open, sub-menus (hover + click)
  - Segmented Control — iOS-style toggle with sliding indicator, primary,
    block, sizes, disabled
  - Countdown — animated timer with years/days/hours/min/sec, relative dates
    (+2y5d), primary, inset, bordered, sizes
  - Scrollspy — auto-highlight nav on scroll, vertical, horizontal, pill,
    auto-detect scroll container, click-to-scroll
  - Editable Text — click-to-edit inline, underline variant, sizes,
    save/cancel events, with/without icon

Enhancements:
  - Bento grid reordered by category, dense packing (no gaps)
  - 110 playground snippets

v1.13.0

Result, Hero, Descriptions, List Group & Print Styles

New Components:
  - Result — full-page feedback states (success, error, warning, 404, info, inset)
  - Hero — landing page banners (default, small, large, raised, bordered, inset, gradient, accent)
  - Descriptions — key-value displays (default, bordered, raised, inset, striped)
  - List Group — styled lists with badges, avatars, flyout sub-menus, active/disabled states

Enhancements:
  - Print styles — hides overlays, removes shadows, adds borders
  - On This Page sidebar on Getting Started
  - Playground expanded to 100+ snippets

v1.12.0

Drawer, Radio/Checkbox Cards, Mask Shapes & 101 Playground Snippets

New Components:
  - Drawer — mobile-first bottom sheet with drag handle, swipe to dismiss, snap points
  - Radio Card — click entire card to select (single selection)
  - Checkbox Card — click entire card to select (multiple selection)
  - Mask — 12 CSS clip-path shapes (circle, squircle, star, heart, diamond,
    hexagon, triangle, pentagon, octagon, cross, shield, parallelogram)

Enhancements:
  - Print styles — hides overlays, removes shadows, adds borders for printing
  - On This Page sidebar added to Getting Started
  - Playground expanded to 101 snippets covering all components

v1.11.0

RTL Support, Cross-Browser Fixes & Search Improvements

New:
  - Full RTL (right-to-left) support for Arabic, Hebrew, Farsi
  - RTL demo page with live examples
  - Browser Support section on Getting Started

RTL:
  - Utility classes use CSS logical properties (margin-inline-start/end)
  - dir="rtl" overrides for sheets, carousel, lightbox, breadcrumbs,
    dropdowns, sidebar, speed dial, avatar, select, accordion, timeline

Cross-Browser:
  - Added -webkit-user-select prefix to all components
  - Removed deprecated overflow:overlay

Docs:
  - Theming, Changelog, RTL Demo added to Cmd+K search
  - Search keywords added for better discoverability

v1.10.0

Styled Select, Data Table Enhancements & Fixes

New:
  - Styled Select — custom dropdown replacement for native <select>
  - Data table filter dropdown for row filtering
  - Data table sort reset (3-click cycle: asc → desc → unsorted)
  - Dropdown no-arrow modifier
  - Pricing selectable variant (click cards to select)

Fixes:
  - Modals no longer clip dropdowns or datepickers
  - Datepicker trigger matches input sizing
  - Number input spin buttons hidden automatically
  - Navbar brand hover stays text color
  - Horizontal bar chart spacing and alignment
  - Dark mode flash prevention guide in Getting Started

v1.9.0

Pricing Component

New Components:
  - Pricing Cards — default, featured badge, billing toggle, inset

v1.8.0

Accessibility, Design Tokens & Docs

Accessibility:
  - prefers-reduced-motion support
  - Focus-visible states on links, sidebar nav, inputs
  - Color contrast improved to WCAG AA
  - Dropdown arrow key navigation
  - Proper ARIA roles on modals and tables

New:
  - Design tokens (dist/tokens.json)
  - Theming guide with full variable reference
  - Framework integration examples (React, Vue, Svelte, Astro, Next.js)
  - Changelog page
  - No-flash page loading (opacity:0 + early theme detection)

v1.7.0

Utility Classes & New Components

New Components:
  - Tour / Walkthrough — spotlight overlay with step-by-step tooltips
  - Copy Button — click-to-copy with checkmark feedback
  - Text Rotate — animated word cycling (fade, slide, flip, zoom)
  - Typewriter — character-by-character typing with cursor styles
  - Marquee — infinite scrolling logos, text, cards
  - Browser Mockup — macOS/Windows chrome with tabs
  - Phone Mockup — notch, dynamic island, teardrop, punch hole

Utility Classes:
  - Display: inline, inline-block, grid
  - Position: relative, absolute, fixed, sticky + placement
  - Sizing: width, max-width, height, min/max
  - Overflow: hidden, auto, scroll, x/y variants
  - Opacity: 0 through 100
  - Z-Index: 0, 10, 20, 30, 40, 50
  - Cursor: pointer, not-allowed, grab, move, text
  - Visibility: visible, invisible, sr-only
  - Pointer Events, User Select

5 new utility docs pages.

Fixes:
  - Tour positioning and scroll-into-view
  - Brand hover color fix
  - Bento card tab focus (tabindex=-1 on preview elements)
  - Mobile drawer removed from tab order when closed

v1.6.0

12 New Components & Major Docs Improvements

New Components:
  - Tree View — hierarchical tree with icons, lines, tri-state checkboxes
  - Speed Dial / FAB — floating action button with expandable actions
  - Image Lightbox — grid, filmstrip, vertical gallery, captions, zoom
  - Loading Overlay — spinner variants, blur, fullscreen
  - Diff — image compare slider with draggable divider
  - Stack — overlapping cards with fanned and hover spread

Docs:
  - Sidebar reorganized into 9 categorized groups
  - Code of Conduct and Contributing guide added
  - Raised container variants for Tree View, Rating, Color Picker, Swap

Fixes:
  - Table row hover blending with background
  - Global scrollbar restyled (thin rounded pill, no arrows)
  - Modal shadow reduced, backdrop blur variants added (none/sm/md/lg/xl)

v1.5.0

6 New Components, Form Enhancements & Search

New Components:
  - Chat Bubble — sent/received messages with avatar, status, grouped
  - Color Picker — swatches, spectrum picker (canvas + hue + RGB/hex)
  - File Upload — drag-and-drop, file list, progress, image previews
  - Radial Progress — SVG circle ring with animated count-up
  - Dock — macOS-style icon bar with hover magnification
  - Swap — animated toggle (rotate, flip, fade, slide) + multi-state cycle

Form Enhancements:
  - Password Input with eye toggle and validation rules
  - Number Input with styled +/- buttons
  - Tags Input (type to create chips)
  - Cards → Empty State variant

Docs:
  - Cmd+K search with command palette
  - JS requirement banners on 28 component pages
  - Getting Started → JavaScript section
  - Code block audit across 18 components (removed all ... placeholders)

v1.4.0

Rating Component

New Components:
  - Rating — star/heart/custom icon rating with half-star support,
    sizes, colors, read-only, inset

Fixes:
  - Timeline bento card connector alignment

v1.3.0

Stat Card Component

New Components:
  - Stat Card — KPI display with value, label, trend arrow,
    icon, progress, bordered, inset, flat, compact variants

v1.2.0

Sidebar, Timeline & Playground

New Components:
  - Sidebar — collapsible app sidebar with nav links, groups, icons
  - Timeline — vertical event timeline with dots, connectors, colors

Docs:
  - Playground page for live code editing
  - Simplified snippet insertion (click to insert)

Fixes:
  - Tab panel border-radius on only-child cards

v1.0.0 – v1.0.5

Initial Release

Core library with 44 components and 7 utility categories:
  - Buttons, Cards, Badges, Alerts, Progress, Tables, Forms
  - Modal, Sheet, Dropdown, Popover, Tooltip, Context Menu
  - Tabs, Accordion, Carousel, Calendar, Chart, Data Table
  - Navbar, Breadcrumbs, Pagination, Stepper, Kbd, Chip
  - Skeleton, Spinner, Slider, Toggle Group, Input OTP
  - Combobox, Command Palette, Resizable, Drag & Drop
  - Scroll Area, Collapsible, Hover Card, Menubar
  - Layout system (12-column grid, containers, flex utilities)
  - Dark mode support
  - Published to npm as softui-css

Delete this item?

This action cannot be undone. This will permanently delete the item and remove all associated data.