# 0.0.3

## ⚠️ Your artwork moved out of the module — one manual step is required

Everything the module stores now lives in **`Data/dh-assets/`**, in your Foundry data folder next
to `worlds/` and `modules/`. It used to live inside the module itself, at
`Data/modules/dh-assets/storage/`.

**Why:** `persistentStorage` protected that folder across module *updates*, but not across an
*uninstall*. Removing the module deleted the whole folder — every image you had put there went with
it, with no warning and no way back. A folder in the data root belongs to no package, so
uninstalling, reinstalling or switching versions can no longer touch it.

**What you have to do**, once, if you already had art in the old folder:

1. Back up your world.
2. Move `storage/assets/` and `storage/custom/` into `Data/dh-assets/` in your file manager.
3. Click **Regenerate Art Mappings**, then reload.
4. Run `docs/fix-old-paths.js` as a script macro to repair paths already saved on your documents.

The full walkthrough is in the README, under *Coming From an Older Version*. The module does not do
this for you on purpose: Foundry gives a module no way to move or delete a file, only to copy one,
so an in-module "migrate" button could only ever leave you with two full copies of your library and
no way to remove either.

### New

- `docs/fix-old-paths.js` — a one-off repair macro that rewrites pre-0.0.3 artwork paths saved
  inside world documents: actor portraits, prototype tokens (wildcards included), the dynamic ring,
  every embedded item, sidebar items, unlinked scene tokens, tiles and scene backgrounds. Runs as a
  dry-run first and asks for confirmation before writing. **Sync Actor Images cannot do this job** —
  it only replaces images that are still the system default, and an old module path counts as an
  image somebody chose.

### Changed

- `core-mapping.json` and `beastform-art.json` are now written to `Data/dh-assets/`, and
  `module.json` points Foundry's compendium-art loader at the new location.
- All asset folders — including the beastform tree and any *Custom Compendiums* folders — are
  created under `Data/dh-assets/` on world load.
- The **Instructions** dialog names the new folder and explains the manual move.

### Notes

- `persistentStorage` stays enabled for now, so the old folder is not wiped by a module update
  before you have had a chance to empty it yourself.
- Nothing about naming, matching, wildcards or the beastform galleries changed. Once your files are
  in the new folder and the mapping is regenerated, everything behaves exactly as before.