CHANGELOG

FeatureComponents
  • Props API audit hardening — full passthrough / slots / compound escape hatch / a11y across all 25 exported components (148 tests passing)
  • useIntlPhoneInput — international phone input hook with country code selector and accessibility improvements
FeatureDocumentation
  • ComponentDocTemplate — structured 4-tab skeleton (Guide / Examples / Specs / Dev) with fixed slot order; all 27×2 component MDX pages migrated
  • Loading overlay — canvas particle animation with 3 phases (float → converge → freeze), SVG logo sampling, prefers-reduced-motion support
  • Anatomy diagrams — fix callout positioning + add 7 missing anatomy demos (Accordion, FAB, Pagination, Skeleton, Tabs, TextArea, Toast)
  • Demo card unification — shared DemoCard/DemoPreview/DemoControls via _shared.tsx, 17 demos migrated to --doc-* tokens
  • TextField — add required vs optional usage guideline
FixPerformance
  • Sidebar scroll — remove drag-to-scroll (~200 lines), batch DOM read/write, CSS containment + will-change layer hints
FixBug Fixes
  • TextField — floating label stays inside input with leadingSlot until focus/value
  • Tabs — resolve hydration mismatch by deferring hash read to useEffect
  • Sidebar — resolve scroll animation oscillation, double-reset, and click jitter
  • Chip — refine close icon SVG path; Toast — reduce icon size to 18px
  • Icon gallery — correct theme rendering for mono/multicolor/contrast icons
FeatureDocumentation
  • UI Redesign — decoupled framework (--doc-) from design system (--ds-), industrial-minimalism sidebar with dual-dial navigation, entry animation, and drag-to-scroll
  • DoDont MDX component — Do/Don't comparison cards for Usage Guidelines pages
  • AnatomyView MDX component — interactive component anatomy diagrams
  • PaginationFooter — Figma-aligned arrow-line layout with directional hover nudge animation
FixBug Fixes
  • Sidebar click jitter — eliminate secondary nav jump on navigation
  • SwitchAnatomy demo — rename deprecated propSwitch to semantic
  • Color page — refine swatch border-radius and table styles
FeatureComponents
  • Props API normalization — Badge, Switch, Toast, Chip, Pagination, DatePicker, Selector naming and controlled/uncontrolled patterns unified
  • Button / GradientButton — asChild support via Radix Slot
FeatureDocumentation
  • Footer social icons (react-icons/fa6) + SVG favicon
  • Changelog page — Timeline/TimelineItem/TimelineGroup MDX components
  • 41 MDX pages × en/zh — Tab attribute unification + Props API alignment
FeatureComponents
  • Toast — snackbar preset API with variant, action, and close support
  • Tabs — fix size variant not applying, enhanced switch animation
TokensTokens
  • Fix LostMary dark mode desktop layout tokens overridden by mobile values
FixBug Fixes
  • IconButton SVG centering — remove span wrapper, add [&_svg]:block
FeatureComponents
  • DatePicker — calendar picker with range support (Figma node 597:1889)
  • FAB — floating action button (Figma node 667:4222)
  • Gradient Button — new variant with gradient background
FixBug Fixes
  • Button brand/error variant text color — use text-white-primary for theme flip
FeatureComponents
  • Toast — lightweight notification with 5 semantic variants
  • Tooltip — accessible hover/focus content with positioning
  • Accordion — collapsible content sections with 3 style variants
  • Pagination — page navigation with brand/default styles
  • Breadcrumb — navigation trail (Figma node 651:2564)
  • TextArea — multiline text input aligned with Figma specs
  • TextField — full rewrite with Figma alignment
  • Button / GradientButton / IconButton — split into standalone components
FeatureTheming
  • LostMary brand switching — dual-brand support via data-brand attribute
  • Dark mode — anti-FOUC script + localStorage persistence + system preference
FixBug Fixes
  • Brand/Error variant dark mode text color fix
  • Anti-Jitter — eliminate border size jumps across Button, TextField, Select
FeatureFoundation
  • Design System monorepo initialized — packages/ui + apps/docs
  • Style Dictionary token pipeline — CSS variables with --ds- prefix