# Migration to UnifiedFiler v2.0

## What changed

v2.0 stabilizes the Host-facing API. Existing v1.9.x demos and plugin calls remain compatible, but new Host integration should prefer Control APIs.

## Recommended before

```javascript
$('#explorer').fileExplorer(options);
var view = $('#explorer').data('fileExplorer');
```

## Recommended after

```javascript
var explorer = new UnifiedFiler.controls.FileExplorerControl('#explorer', options);
explorer.mount();
explorer.exec('refresh');
```

or:

```javascript
var filer = UnifiedFiler.create(options);
var explorer = filer.createExplorer('#explorer', { defaultStorage: 'appStorage' });
```

## New extension registration

Use `registerCreateType()` instead of only `newMenuItems` when Host code needs to add file types at runtime.

Use `registerPreviewProvider()` instead of replacing the whole `PreviewService` when Host code only needs to add a file-type preview.

## Compatibility kept

- `$.fn.fileExplorer`
- `$.fn.filePickerDialog`
- `$.fn.fileSaverDialog`
- `newMenuItems`
- Existing AMD paths under `scripts/controls`, `scripts/services`, `scripts/views`, `scripts/adapters`, `scripts/commands`, `scripts/models`