- [From 4.x.x to 5.0.0](#from-4xx-to-500)
  - [Removed Icons](#removed-icons)
  - [Renamed Icons](#renamed-icons)
  - [Core set size reduction](#core-set-size-reduction)
    - [Move AI related icons to `ai` set](#move-ai-related-icons-to-ai-set)
    - [Move file related icons to `file` set](#move-file-related-icons-to-file-set)
    - [Move social/logo icons to `logo` set](#move-sociallogo-icons-to-logo-set)
    - [Move marketing related icons to `marketing` set](#move-marketing-related-icons-to-marketing-set)
    - [Move user related icons to `user` set](#move-user-related-icons-to-user-set)
- [From 3.x.x to 4.x.x](#from-3xx-to-4xx)

## From 4.x.x to 5.0.0

### Removed Icons

- `core::ai-assistant` - was deprecated
- `core::warning-outline` - use `core::warning` instead

### Renamed Icons

- [ ] `medical::alarm` → `medical::audio`
- [ ] `medical::alarm-off` → `medical::audio-off`
- [ ] `medical::alarm-pause` → `medical::audio-pause`

### Core set size reduction

In order to reduce the size of the core set several icons have been moved from the `core` set into 5 new icon sets based on their use cases:

- **`ai`** - AI and agent related icons
- **`file`** - File type icons
- **`logo`** - Social media and company logos
- **`marketing`** - Marketing and workplace benefit icons
- **`user`** - User related icons like user roles and user management

Update your icon set imports to include the new sets/icons you want to use

#### Move AI related icons to `ai` set

- [ ] `core::ai-search` → `ai::search`
- [ ] `core::ai-spark` → `ai::spark`
- [ ] `core::ai-sessions` → `ai::sessions`
- [ ] `core::chat-agent` → `ai::chat-agent`
- [ ] `core::code-agent` → `ai::code-agent`
- [ ] `core::data-agent` → `ai::data-agent`
- [ ] `core::gaia` → `ai::gaia`
- [ ] `core::language-agent` → `ai::language-agent`
- [ ] `core::learning-agent` → `ai::learning-agent`
- [ ] `core::magic-wand` → `ai::magic-wand`
- [ ] `core::medical-product-agent` → `ai::medical-product-agent`
- [ ] `core::safety-product-agent` → `ai::safety-product-agent`
- [ ] `core::writing-agent` → `ai::writing-agent`

#### Move file related icons to `file` set

- [ ] `core::file-csv` → `file::csv`
- [ ] `core::file-excel` → `file::excel`
- [ ] `core::file-image` → `file::image`
- [ ] `core::file-jpg` → `file::jpg`
- [ ] `core::file-others` → `file::others`
- [ ] `core::file-pdf` → `file::pdf`
- [ ] `core::file-png` → `file::png`
- [ ] `core::file-ppt` → `file::ppt`
- [ ] `core::file-svg` → `file::svg`
- [ ] `core::file-video` → `file::video`
- [ ] `core::file-wmv` → `file::wmv`
- [ ] `core::file-word` → `file::word`
- [ ] `core::file-zip` → `file::zip`

#### Move social/logo icons to `logo` set

- [ ] `core::bluetooth-logo` → `logo::bluetooth`
- [ ] `core::logo-engage` → `logo::engage`
- [ ] `core::naver` → `logo::naver`
- [ ] `core::naver-safety-blog` → `logo::naver-safety-blog`
- [ ] `core::naver-medical-blog` → `logo::naver-medical-blog`
- [ ] `core::rutube` → `logo::rutube`
- [ ] `core::social-facebook` → `logo::facebook`
- [ ] `core::social-instagram` → `logo::instagram`
- [ ] `core::social-linkedin` → `logo::linkedin`
- [ ] `core::social-x` → `logo::x`
- [ ] `core::social-xing` → `logo::xing`
- [ ] `core::social-youtube` → `logo::youtube`
- [ ] `core::social-whatsapp` → `logo::whatsapp`
- [ ] `core::social-wechat` → `logo::wechat`
- [ ] `core::social-qq` → `logo::qq`
- [ ] `core::social-vk` → `logo::vk`

#### Move marketing related icons to `marketing` set

- [ ] `core::discount` → `marketing::discount`
- [ ] `core::career` → `marketing::career`
- [ ] `core::childcare` → `marketing::childcare`
- [ ] `core::dataprivacy` → `marketing::dataprivacy`
- [ ] `core::family` → `marketing::family`
- [ ] `core::finance-service` → `marketing::finance-service`
- [ ] `core::fitness-discount` → `marketing::fitness-discount`
- [ ] `core::hybridwork` → `marketing::hybridwork`
- [ ] `core::information-security` → `marketing::information-security`
- [ ] `core::kantine` → `marketing::canteen`
- [ ] `core::money` → `marketing::money`
- [ ] `core::networking` → `marketing::networking`
- [ ] `core::sabbatical` → `marketing::sabbatical`
- [ ] `core::sports` → `marketing::sports`
- [ ] `core::vacation` → `marketing::vacation`

#### Move user related icons to `user` set

- [ ] `core::user-add` → `user::add`
- [ ] `core::user-administration` → `user::administration`
- [ ] `core::user-administrator` → `user::administrator`
- [ ] `core::user-edit` → `user::edit`
- [ ] `core::user-engineer` → `user::engineer`
- [ ] `core::user-group-administration` → `user::group-administration`
- [ ] `core::user-group` → `user::group`
- [ ] `core::user-id-edit` → `user::id-edit`
- [ ] `core::user-id-error-mono` → `user::id-error-mono`
- [ ] `core::user-id-error` → `user::id-error`
- [ ] `core::user-id-invalid-mono` → `user::id-invalid-mono`
- [ ] `core::user-id-invalid` → `user::id-invalid`
- [ ] `core::user-id-query` → `user::id-query`
- [ ] `core::user-id-reading` → `user::id-reading`
- [ ] `core::user-id-success-mono` → `user::id-success-mono`
- [ ] `core::user-id-success` → `user::id-success`
- [ ] `core::user-id` → `user::id`
- [ ] `core::user-level-1` → `user::level-1`
- [ ] `core::user-level-2` → `user::level-2`
- [ ] `core::user-level-3` → `user::level-3`
- [ ] `core::user-level-4` → `user::level-4`
- [ ] `core::user-level-5` → `user::level-5`
- [ ] `core::user-logout` → `user::logout`
- [ ] `core::user-maintainer` → `user::maintainer`
- [ ] `core::user-operator` → `user::operator`
- [ ] `core::user-trainer` → `user::trainer`
- [ ] `core::user-worker` → `user::worker`

## From 3.x.x to 4.x.x

In order to migrate from versions prior to 4.x.x, you need to update your imports and usage as follows:

- Remove icon font imports, as they are no longer supported.
- Update your icon imports to use the new module structure.

If you are using the CSS variant of the icons

```HTML
<i class="odx-icon" data-icon-name="user": data-icon-set="core"></i>
```

you will need to switch to the new custom element or import our compatibility script

```js
import '@odx/icons/compat';
```

```js
import disconnectObservers from '@odx/icons/compat';

// Call this function to disconnect the observers when they are no longer needed
disconnectObservers();
```

> The script replaces elements that look like `<odx-icon data-icon-name="...">` and `<i class="odx-icon" data-icon-name="...">` with the new custom element.
