Update readme and changelog

Author: tagliala

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+* [FEATURE] Breaking change: Remove the jQuery runtime dependency and the old jQuery plugin aliases from the published JavaScript assets
+* [FEATURE] Breaking change: Public JavaScript APIs now work with native DOM elements and DOM collections instead of jQuery-wrapped objects
+* [ENHANCEMENT] Use native browser events and event listeners throughout the runtime and test harness
+
 ## 23.1.0 / 2026-01-27
 
 * [FEATURE] Add jQuery 4.0.0 compatibility

README.md

@@ -108,6 +108,30 @@ rails g client_side_validations:copy_assets
 
 Note: If you run `copy_assets`, you will need to run it again each time you update this project.
 
+## Migration Guide ##
+
+### Removing jQuery Dependency ###
+
+If you are upgrading from the older jQuery-based API, update your integration code to use the `ClientSideValidations` object directly.
+
+The old jQuery plugin methods are removed. Use the DOM-first public API instead:
+
+```js
+ClientSideValidations.enable(form)
+ClientSideValidations.validate(form)
+ClientSideValidations.isValid(form, validators)
+ClientSideValidations.disable(form)
+ClientSideValidations.reset(form)
+```
+
+These methods accept native DOM elements and DOM collections. They do not accept jQuery objects or CSS selector strings.
+
+Custom validators, form builders, and callbacks now receive native DOM nodes instead of jQuery wrappers. Update any custom code to use DOM APIs such as `.value`, `.form`, `.closest()`, and `querySelector()`.
+
+If you are upgrading from a version older than 23.0.0, update any custom selectors or custom code that still reads `data-changed`, `data-valid`, or `data-validate` to use `data-csv-changed`, `data-csv-valid`, and `data-csv-validate` instead.
+
+If your application vendors the compiled asset with `rails g client_side_validations:copy_assets`, run that generator again after upgrading so your copied asset matches the current jQuery-free bundle.
+
 ## Initializer ##
 
 The initializer includes a commented out `ActionView::Base.field_error_proc`.