v5.2.x

[palcarazm]

⚠️ Important information

This release includes a complete core refactor to TypeScript, improvements in maintainability and compatibility, and updated dependencies.

1️⃣ Complete TypeScript Refactor

• All main modules (Toggle, StateReducer, DOMBuilder, OptionResolver) have been rewritten in TypeScript to improve maintainability and type safety.
  -Option parsing, state management, and rendering logic are now centralized and modular.

2️⃣ Clear Separation of Responsibilities

• Toggle coordinates events and exposes the public API.
• OptionResolver decide options from data-attributes, user provided options and defaults options. It also handle deprecated options.
• StateReducer manages all toggle state logic (ON | OFF | INDETERMINATE | READONLY | DISABLED).
• DOMBuilder handles rendering of the toggle and its associated elements.

3️⃣ API Compatibility Preserved

• The jQuery classic API $(selector).bootstrapToggle() and the ECMAScript API document.querySelector(selector).bootstrapToggle() remains fully functional using the refactored core.
• Event and state logic is shared between ES Modules and the jQuery wrapper, eliminating duplication and historical bugs.

---

ℹ️ What's Changed

🆕 Added

🔁 Changed

• Centralized core logic in TypeScript modules – migrated build system to Rollup and PostCSS, refactored internal architecture into modular classes (OptionResolver, StateReducer, DOMBuilder, Builder).
  • by @palcarazm
  • in 246d33e
• Consolidated CI workflows – unified multiple independent workflows into a single pipeline with Node.js version matrix, coverage reporting, and cross-browser Cypress tests.
  • by @palcarazm
  • in 5acf0ab and 5acf0ab
• Updated contribution guidelines and tooling – added ESLint and commitlint, updated templates and workflows.
  • by @palcarazm
  • in 4fd8a0b

✅ Fixed

• Toggle event handling – prevents unintended toggling on scroll, drag interactions, and right-clicks using dynamic pointer listeners with gesture thresholds.
  • by @palcarazm
  • fixes [BUG] Unintentionally toggle on touch screen scrolling #213, [BUG] Toggle not allowing to scroll #153, [BUG] Not touch device friendly #187
  • in dbe4184
• DOM sizing in hidden containers – uses ResizeObserver to defer rendering until parent elements become visible, ensuring correct toggle dimensions in tabs/accordions.
  • by @palcarazm
  • fixes [BUG] Incorrect sizing when initialized in hidden containers #231
  • in 1526bb6
• Input property handling – intercepts external changes to input properties (checked, disabled, readonly, indeterminate) and restores original descriptors on destroy.
  • by @palcarazm
  • fixes Toggle State Not Synchronized with Input Element Changes #261
  • in baee160
• CSS unit support for width/height options – now properly handles explicit CSS units (rem, em, %, vw, vh) without incorrectly appending "px".
  • by @palcarazm
  • fixes [BUG] Incorrect interpretation of non numeric width and height options #242
  • in 218bb32
• Agnostic interface and user options preservation – ensures compatibility with both ECMAS and jQuery interfaces and preserves user options during rerender.
  • by @palcarazm
  • fixes [BUG] Rerender not exposed in 5.2.0-rc1 #236
  • in f50a655
• OptionResolver attribute preference – correctly prioritizes data-onvalue attribute over value attribute in options parsing.
  • by @palcarazm
  • fixes [BUG] Checkbox value not have preference to data-onvalue #237
  • in b5e3d34
• Refactored code quality improvements – multiple SonarQube-driven fixes including cognitive complexity reduction, best practice updates, and accessibility improvements.
  • by @palcarazm
  • in commits a0757b9 through 9744a68

🆙 Bump

• Dependency updates:
  • jquery from 3.7.1 to 4.0.0 (bump: bump jquery from 3.7.1 to 4.0.0 #277)
  • lodash from 4.17.21 to 4.17.23 (bump: bump lodash from 4.17.21 to 4.17.23 #279)
  • @commitlint/config-conventional from 19.8.1 to 20.3.1 (bump: bump @commitlint/config-conventional from 19.8.1 to 20.3.1 #269)
  • commitlint from 19.8.1 to 20.3.1 (bump: bump commitlint from 19.8.1 to 20.3.1 #268)
  • globals from 16.5.0 to 17.0.0 (bump: bump globals from 16.5.0 to 17.0.0 #267)
  • @commitlint/cli from 19.8.1 to 20.3.1 (bump: bump @commitlint/cli from 19.8.1 to 20.3.1 #266)
  • cypress from 13.13.3 to 15.9.0 (multiple updates: bump: bump cypress from 13.13.3 to 14.1.0 #210, bump: bump cypress from 15.8.1 to 15.8.2 #265, 780e658)
  • @typescript-eslint/parser from 8.52.0 to 8.53.0 (bump: bump @typescript-eslint/parser from 8.52.0 to 8.53.0 #278)
  • @typescript-eslint/eslint-plugin from 8.52.0 to 8.53.0 (cbad57f)
  • rollup from 4.54.0 to 4.55.1 (a8c1dbf)
• CI and infrastructure:
  • Added SonarQube analysis pipeline
  • Updated ESLint configurations and exclusions
  • Improved GitHub Actions security with SHA references
  • Updated documentation deployment pipeline
  • Enhanced test coverage with pointer/keyboard interaction tests

---

Full Changelog: v5.1.3...v5.2.0

[palcarazm]

Hi everyone 👋

After the v5.2.0-rc1 release and our complete TypeScript refactor, we’re sharing a clear RC schedule leading up to the stable release. This helps catch regressions, ensure stability, and gather valuable feedback from the community.

---

📅 RC Schedule

📆 Date	🔖 Release	🎯 Objective
02/01/2026	v5.2.0-rc1	Typescript refactor to improve maintainability and compatibility
09/01/2026	v5.2.0-rc2	Bug fixes reported in RC-1
17/01/2026	v5.2.0-rc3	Apply additional bug fixes reported in RC-2
25/01/2026	v5.2.0-rc4	Final bug fixes and integration validation
23/01/2026	v5.2.0 Stable	Official stable release ✅

🛠 RC Goals

• 🔧 Stabilize the new TypeScript architecture after the internal refactor
• 🐞 Verify bug fixes on touch devices, hidden containers, and edge cases
• ⚡ Ensure compatibility with both ES Modules and the jQuery API

📣 Call to Action

We encourage the community to test each RC in real projects and help us ship a robust stable release:

• 🐛 Report any bugs or regressions in GitHub issues
• ♿ Share accessibility feedback or issues with custom events
• ⚙️ Test integration with your app

Your feedback is crucial! Let’s make v5.2.0 the most stable release yet. 🙌

🤝 Contribute

We welcome contributions, testing, and suggestions!

• 🆘 Do you need some help? Open a thread in GitHub Discussions Q&A
• 🐛 Do you find a bug? Open an issue in GitHub bug report
• 💡 Do you have a great idea? Open an issue in GitHub feature request
• 💻 Do you know how to fix a bug? Open a pull request in GitHub pull request.

---

Thank you for helping us improve bootstrap5-toggle! 💙