> For the complete documentation index, see [llms.txt](https://ghiscoding.gitbook.io/slickgrid-universal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ghiscoding.gitbook.io/slickgrid-universal/migrations/migration-to-3.x.md).

# Migration Guide to 3.x (2023-05-29)

### SlickGrid is now jQuery free (2023-05-29) 🌊

In our previous v2.0 release (see [Migration to v2.0](https://github.com/ghiscoding/slickgrid-universal/blob/master/docs/migrations/Migration-to-2.x.md)), we dropped jQueryUI and now in v3.0 we are going even further and are now dropping [jQuery](https://jquery.com/) entirely. You can still use jQuery but it's no longer a dependency. There are multiple benefits in dropping jQuery and go the vanilla route, the biggest advantages are:

1. it should provide better performance (browser native)
2. build size should be smaller (see table below)

**Major Changes - Quick Summary**

* minimum requirements bump
  * [`@slickgrid-universal/rxjs-observable`](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/rxjs-observable) package now requires RxJS `>=7.7.1`
* we dropped jQuery requirement
  * it also required me to rewrite the `multiple-select` (jQuery based lib) into a brand new [`multiple-select-vanilla`](https://github.com/ghiscoding/multiple-select-vanilla) lib which is now native and has zero dependency

***

**NOTE:** if you come from an earlier version other than 2.x, then please make sure to follow each migration in their respective order

### Changes

#### Replaced `multiple-select` with [`multiple-select-vanilla`](https://github.com/ghiscoding/multiple-select-vanilla)

This change was required because the previous library was a jQuery based lib, so I rewrote the lib as a new native lib to drop jQuery. However with this change, there were a couple of options that were dropped and/or modified.

```diff
// you can load `MultipleSelectOption` from either the new Multiple-Select-Vanilla lib or from Slickgrid-Universal (which is a re-export)
  import { MultipleSelectOption } from '@slickgrid-universal/common'; // still works, but is a re-export of the import shown below
+ import { MultipleSelectOption } from 'multiple-select-vanilla';     // preferred

filterOptions: {
-  autoDropWidth: true, // removed and no longer required
} as MultipleSelectOption
```

The new lib also offers a bunch of new options as well, you can see the full interface at [MultipleSelectOption](https://github.com/ghiscoding/multiple-select-vanilla/blob/main/lib/src/interfaces/multipleSelectOption.interface.ts)

#### Slickgrid-Universal

If you use any of the Slickgrid-Universal optional dependencies then make sure to upgrade them all to the new major `3.0.0` version

```diff
  "dependencies": {
-   "@slickgrid-universal/excel-export": "^2.6.4",
+   "@slickgrid-universal/excel-export": "^3.0.0",
}
```

#### Editor/Filter `params` should be using `editorOptions`/`filterOptions`

For better TypeScript support, we now recommend to use either `editorOptions` or `filterOptions` depending if it's an Editor or a Filter.

```diff
this.columnDefinitions = [{
  id: 'cost', name: 'Cost', field: 'cost',
  editor: {
    model: Editors.slider,
-    params: { hideSliderNumber: false }
+    editorOptions: { hideSliderNumber: false } as SliderOption
  },
  filter: {
    model: Filters.slider,
-    params: { hideSliderNumber: false }
+    filterOptions: { hideSliderNumber: false } as SliderOption
  },
```

#### Final Note

and that's about it, the migration is relatively simple as you can see :)

***

#### File Size Comparisons

The comparison below was made by looking at the folder properties from "size on disk" on Windows, and it looks like we're averaging 4-5% smaller size in our new release by removing jQuery.

**Slickgrid-Universal**

| File                                                                                                                                   | before             | after              | diff                | % diff        |
| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------ | ------------------- | ------------- |
| [SF Bundle Zip File](https://github.com/ghiscoding/slickgrid-universal/tree/master/packages/vanilla-force-bundle/dist-grid-bundle-zip) | 624Kb (638,976)    | 596Kb (610,304)    | -28Kb               | 4.48% smaller |
| [GitHub Vite Demo Website](https://ghiscoding.github.io/slickgrid-universal/)                                                          | 4.99Mb (5,234,688) | 4.72Mb (4,956,160) | -0.27Mb (or -272Kb) | 4.07% smaller |