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