[js] Update swiper 12.1.4 → 14.0.0 (major)

[depfu]

Here is everything you need to know about this upgrade. Please take a good look at what changed and the test results before merging this pull request.

What changed?

✳️ swiper (12.1.4 → 14.0.0) · Repo · Changelog

Release Notes

14.0.0

Swiper v14 is a ground-up TypeScript rewrite of the entire codebase, focused on smaller bundles, more accurate types, and a modern browser baseline. (We skipped v13.)

Upgrading from v12 requires no code changes. Every option, default, event, payload, method signature, and module import (swiper/modules, swiper/react, swiper/vue, swiper/element, …) behaves exactly as before. The only differences you may notice are tighter TypeScript types and a narrower set of supported browsers — see Breaking Changes below.

Highlights

• Single TypeScript source of truth. src/ is now .ts/.tsx. The hand-maintained .d.ts tree (src/types/, the per-module .d.ts files) is gone — declarations are emitted directly from the runtime source with tsc, so the shipped types can no longer drift from the implementation. Several signatures that used to be any are now correctly typed (e.g. getTranslate(): number).
• Per-module type augmentation. Each module augments the central Swiper / SwiperOptions / SwiperEvents interfaces. Importing a module (e.g. import { Navigation } from 'swiper/modules') brings its option, method, and event types along with it — mirroring how the runtime already requires registration.
• More reliable type resolution. Types now resolve correctly under classic node, node16/nodenext, and bundler module resolution, and swiper/bundle exposes every module's options out of the box. Verified by a consumer-simulation test suite.
• Zero runtime dependencies. The ssr-window dependency was removed and replaced with inline environment guards. Swiper now installs with no transitive runtime deps.
• Smaller minified bundles. Legacy DOM-compat helpers and below-baseline feature detection were removed. The shared DOM utils shrank ~28%, and the main builds are ~2–4% smaller minified (swiper.min.js −4.1%, swiper-element.min.js −2.9%, swiper-bundle.min.js −2.3%).
• Babel removed from the build. TypeScript now handles the JSX transform for the React wrapper, and @babel/preset-env is a no-op at the v14 baseline. Runtime output is byte-identical (React output is marginally smaller).

Breaking Changes

• Browser baseline raised to the last ~2 years of evergreen browsers. Swiper v14 targets Chrome / Edge 110+, Safari 16.4+ (iOS 16.4+), and Firefox 110+. Code paths and feature detection for older browsers were removed (e.g. the smoothScroll support flag, the Safari < 16.2 perspective workaround, and the legacy DocumentTouch touch check). iOS/Android-specific quirk handling is kept but simplified. If you need to support older browsers, stay on v12.
• Node.js >= 20.19.0 is now required to build/develop against the package (engines was >= 4.7.0). This does not affect the browser runtime.
• Type-level changes. Stricter types may surface latent issues in code that previously relied on any-typed access to Swiper internals. These are compile-time only — there are no runtime behavior changes.

SSR

ssr-window's mock window/document were replaced with inline typeof guards. Server rendering with the React / Vue / Element wrappers is unaffected — they only instantiate Swiper in client-side mount effects. Imperatively calling new Swiper(...) in a pure Node (non-DOM) environment once again no-ops gracefully, matching v12 behavior, and is now locked down by a dedicated SSR runtime test.

12.2.0

Bug Fixes

• avoid duplicate css type resolutions (aaf6014)
• core: guard against stale event listeners in onTouchEnd and onTouchMove (00fe610)
• core: guard all event handlers against stale invocations on destroyed swiper (3b2b85f)
• types: support boolean as controller type (b10f9e0)

Does any of this look wrong? Please let us know.

Commits

See the full diff on Github. The new version differs by 56 commits:

• 14.0.0
• docs(v14): record Phase 8 SSR runtime parity work
• test(v14): add SSR runtime smoke test
• fix(v14): guard instantiation path for non-DOM (SSR) environments
• Merge branch 'master' into v14
• 14.0.0-beta.2
• docs(v14): note swiper/bundle types fix in plan
• test(v14): cover swiper/bundle module options in consumer types
• fix(v14): expose module options on swiper/bundle types
• 14.0.0-beta.1
• docs(v14): record Phase 7 type-compat hardening in plan
• test(v14): add consumer type-resolution harness
• fix(v14): resolve types under classic node + node16/nodenext
• chore(v14): remove ESLint, replace Prettier with oxfmt
• chore(v14): add drag-path profiler + document v15 perf findings
• chore(v14): drop Babel — TypeScript handles JSX, preset-env is a no-op at baseline
• chore(v14): Phase 6 — emit declarations via tsc, close augmentation gap
• chore(v14): update plan
• chore(v14): Phase 5 — delete src/types/, prune `any`/`as any` casts
• chore(v14): Phase 4 — TypeScript types for framework wrappers
• chore(v14): Phase 4 — rename framework wrappers .mjs → .ts/.tsx (no code changes)
• chore(v14): Phase 3 batch 5 — TypeScript types for effect modules
• chore(v14): Phase 3 batch 4 — TypeScript types for grid, virtual, manipulation
• chore(v14): Phase 3 batch 3 — TypeScript types for behavior modules
• chore(v14): inline module types, add getParams() helper, finish stripping `as any`
• chore(v14): strip `as any` casts from scrollbar module
• chore(v14): strip `as any` casts from pagination module
• chore(v14): strip `as any` casts from navigation module
• chore(v14): strip `as any` casts from a11y module
• chore(v14): strip `as any` casts from mousewheel module
• chore(v14): strip `as any` casts from keyboard module
• chore(v14): strip `as any` casts from hash-navigation module
• chore(v14): strip `as any` casts from history module
• chore(v14): pivot Phase 3 to per-module type augmentation (infra)
• chore(v14): Phase 3 batch 2 — TypeScript types for DOM-heavy modules
• chore(v14): Phase 3 batch 1 — TypeScript types for state-only modules
• chore(v14): rename src/modules/*.mjs + swiper-effect-utils.mjs → .ts (no code changes)
• chore(v14): Phase 2 — TypeScript types for src/core/
• chore(v14): rename src/core/*.mjs → .ts (no code changes)
• chore(v14): Phase 1 — migrate src/shared/ to TypeScript + drop ssr-window
• chore(v14): bump react to 19 and node engines to >=20.19
• chore(v14): Phase 0 — TS infra + bundle-size + contract test
• chore: updates plans
• 12.2.0
• chore: sponsors
• chore: remove lock/stale
• chore: delete workflows
• fix(core): guard all event handlers against stale invocations on destroyed swiper
• Merge pull request #8183 from arturovt/fix/guard-stale-listener
• Clean up comment in onTouchMove function
• Remove stale listener comment in onTouchEnd
• Merge pull request #8186 from Stanzilla/fix/css-types-no-duplicates
• Merge pull request #8188 from evanclan/fix/controller-boolean-type
• fix(types): support boolean as controller type
• fix: avoid duplicate css type resolutions
• fix(core): guard against stale event listeners in onTouchEnd and onTouchMove

---

Depfu will automatically keep this PR conflict-free, as long as you don't add any commits to this branch yourself. You can also trigger a rebase manually by commenting with @depfu rebase.

All Depfu comment commands

@​depfu rebase

Rebases against your default branch and redoes this update

@​depfu recreate

Recreates this PR, overwriting any edits that you've made to it

@​depfu merge

Merges this PR once your tests are passing and conflicts are resolved

@​depfu cancel merge

Cancels automatic merging of this PR

@​depfu close

Closes this PR and deletes the branch

@​depfu reopen

Restores the branch and reopens this PR (if it's closed)

@​depfu pause

Ignores all future updates for this dependency and closes this PR

@​depfu pause [minor|major]

Ignores all future minor/major updates for this dependency and closes this PR

@​depfu resume

Future versions of this dependency will create PRs again (leaves this PR as is)