3.2.02026-09-20

Expands date/time capabilities with custom triggers and range shortcuts, and polishes table, color picker, feedback interactions, and overlay visuals.

Features

• DateRangePicker: Adds show-time and default-time, with in-panel date/time switching and confirm-to-commit
• Range shortcuts: Adds range-shortcuts and shortcuts-position; defaults cover last 7 / 30 days and last year, and can be customized or disabled
• Custom trigger: DatePicker, DateRangePicker, MonthPicker, YearPicker, and TimePicker gain a #trigger slot for custom openers such as buttons
• Today marker: Range calendars show a today indicator dot
• ColorPicker: Adds shape (square / circle) and show-value; four size levels remain available
• Table: Adds size (mini / normal / large) for density control
• ConfigProvider: Supports global fontFamily so components follow the configured font stack
• Radio button group: Selected item uses a sliding indicator transition
• Steps / Switch: Adds transitions for state changes

Improvements

• TimePicker / range time: Improves time-column scroll positioning, centering, and highlight behavior
• Message: Top messages fade/slide down, bottom ones fade/slide up; bottom stacking uses offset positioning for smoother consecutive toasts
• Overlay: Modal, Drawer, and Spin share a frosted-glass mask with a light dim layer, including dark mode

Fixes

• Table: Removes the double border caused by the last row and the table frame
• DateRangePicker: Fixes the defaultTime TypeScript prop cast that broke production builds

3.1.02026-08-30

Improves component internationalization and fixes missing UnoCSS utilities in published styles.

Features

• i18n: Adds zh-CN / en-US locale packs and useLocale; built-in component copy is driven by the active locale
• ConfigProvider: Adds localeMessages for partial overrides; switching locale updates Modal, Drawer, Popconfirm, Pagination, Table, DatePicker, TimePicker, and related components
• Defaults for okText / cancelText / title / emptyText / pagination templates on those components are now empty strings and fall back to the active locale pack when omitted

Fixes

• Style build: Merges UnoCSS utilities into theme/index.css and dist/index.css, and injects per-component rules into on-demand theme/*.css, fixing missing utilities such as mr-1 after install

3.0.02026-08-24

Birdpaper UI v3 (Blue) is a major release. It is rewritten for Vue 3, with a complete design system, theming and dark mode, full TypeScript types, and a tree-shakeable component package.

Breaking Changes

• Minimum dependency is now Vue 3.5+; Vue 2 and Vue 3.4 or earlier are not supported
• Theming is driven by CSS variables—import styles via birdpaper-ui/theme/index.css (or on-demand theme/*.css)
• Dark mode root class is unified as .dark (.bp-dark is removed); update app toggle logic accordingly
• Default overlay base z-index is now zIndex: 3000, aligned with --z-index-base
• Package layout is a monorepo build (es / lib / theme / types); follow the Installation guide to update imports

Design System

• New color system: functional colors (Primary / Success / Warning / Danger) and neutrals, each with 10 steps, for light and dark tokens
• Unified size scale: mini / small / default / large for height, font size, padding, and radius
• Shared tokens for shadow, spacing, motion, and z-index across components
• Design principles, style guide, dark mode, and resource docs for design–engineering alignment

Features

• ConfigProvider / global config: prefix, namespace, locale, size, zIndex, emptyText
• Theming: override --bp-primary-*, --bp-size-*, and related variables for brand color and component size
• Dark mode: toggle .dark on the root; semantic and neutral colors remap automatically with no per-component work
• On-demand import: tree-shakeable components and matching styles
• Date & time: DatePicker, DateRangePicker, MonthPicker, YearPicker, TimePicker
• Forms: InputTag, InputNumber, VerifyCode, ColorPicker, plus Form validation
• Data display: Table (fixed columns / scroll / selection, and more), Statistic, Rate, Badge, Empty, Image, Avatar, Tag
• Navigation & feedback: Steps, Pagination, Dropdown, Modal, Drawer (async confirm), Message, Popconfirm, Tooltip, Spin, Alert
• Layout & basics: Grid, Space, Button / ButtonGroup, Link, Switch, Checkbox, Radio, Select, Trigger
• Icons via birdpaper-icon