Skip to content

Bootstrap Svelte 2.0.0

Choose a tag to compare

View all tags
@vince-winkintel vince-winkintel released this 18 Sep 13:52
· 5 commits to main since this release
v2.0.0
c650831

Breaking changes and migration

Version 2.0.0 completes the Navbar and Offcanvas fixes for #26, #27, and #33. Read the 1.x to 2.0 migration guide before upgrading.

  • Navbar with omitted expandOnBreakpoint, or explicit "xs", now stays inline at every width, including SSR. Use expandOnBreakpoint={false} for collapsible navigation at every width, or a named breakpoint such as "lg" for responsive navigation.
  • Offcanvas.RootProps['showOnBreakpoint'] now accepts only sm, md, lg, xl, and xxl. Remove showOnBreakpoint="xs". Legacy untyped xs values fall back to an ordinary standalone overlay or inherit the parent Navbar's mode.
  • For a default Navbar containing an Offcanvas with its own named breakpoint, move the breakpoint to Navbar and omit it on Offcanvas so the toggler and panel share the same responsive mode.

Fixes

  • Navbar-owned togglers no longer dismiss an Offcanvas on mousedown before toggling it again on click. Unrelated outside presses retain their normal backdrop behavior.
  • Navbar togglers automatically track rendered Collapse/Offcanvas panel IDs in aria-controls, while preserving consumer overrides and handling ID changes and panel removal.
  • Runtime breakpoint changes replace stale media-query subscriptions and synchronize CSS, ARIA, panel visibility, backdrop behavior, and body scroll locks.
  • Explicit Offcanvas visibility survives responsive changes; toggler-opened state clears on entering inline mode. A nested panel's own breakpoint no longer becomes an undismissable overlay because its parent is inline.
  • Legacy Offcanvas xs values no longer emit the unsupported offcanvas-xs class or force standalone panels open on phones.

Install

pnpm add @winkintel/bootstrap-svelte@2.0.0 bootstrap

The Svelte peer requirement remains ^5.29.0. Continue supplying Bootstrap 5 CSS in the consuming application.

Package and validation

  • Published @winkintel/bootstrap-svelte@2.0.0 with the latest dist-tag and signed npm provenance.
  • Tagged publish workflow and main CI passed.
  • Local validation: 2,050 tests passed, zero Svelte/TypeScript errors or warnings, lint, build, publint, and package-content checks passed.
  • A fresh Svelte/Vite consumer installed the exact npm version, passed svelte-check with zero errors or warnings, and built successfully.

1.x support

The codex/maintenance-1.x branch starts at v1.0.12. Follow-up issues #29 and #31 remain outside this release and can be implemented compatibly for both release lines.

Full changelog: v1.0.12...v2.0.0

Assets 2
Loading