# coa-ace3

Canonical [Ace3](https://www.wowace.com/projects/ace3) bundle for the CoA Guild 'Exiles' addon forks.

Lifted verbatim from upstream [WoWUIDev/Ace3](https://github.com/WoWUIDev/Ace3) at commit
[`52e5f2c`](https://github.com/WoWUIDev/Ace3/commit/52e5f2c7101b6edb02b48ea232bdda2df09d2960)
(2026-05-17). Every fork in the `Exiles` org should converge on this bundle so the runtime
LibStub resolution is predictable and addons can't quietly regress when one of them is disabled.

## Versions

| Library               | MINOR |
|-----------------------|-------|
| LibStub               | 2     |
| CallbackHandler-1.0   | 8     |
| AceAddon-3.0          | 13    |
| AceEvent-3.0          | 4     |
| AceTimer-3.0          | 17    |
| AceHook-3.0           | 9     |
| AceDB-3.0             | 33    |
| AceDBOptions-3.0      | 15    |
| AceConfig-3.0         | 3     |
| AceConfigRegistry-3.0 | 22    |
| AceConfigCmd-3.0      | 14    |
| AceConfigDialog-3.0   | 92    |
| AceGUI-3.0            | 41    |
| AceLocale-3.0         | 6     |
| AceConsole-3.0        | 7     |
| AceComm-3.0           | 14    |
| AceSerializer-3.0     | 5     |
| AceBucket-3.0         | 4     |
| AceTab-3.0            | 3     |

`AceTimer-3.0` calls `C_Timer.After` at load — confirmed available on the CoA Beta client.

## How to consume

### Option 1: source bundle (preferred for forks)

Each `Exiles/coa-*` fork should rsync the libs it embeds from this bundle, so the diff is uniform:

```sh
rsync -a /path/to/coa-ace3/AceAddon-3.0/  /path/to/coa-foo/Libs/AceAddon-3.0/
```

Or replace the entire `Libs/Ace3/` tree in one go.

### Option 2: standalone addon

Drop the contents (except `README.md` / `.gitattributes`) into
`Interface/AddOns/Ace3/` and the loadable `Ace3.toc` will register every library at top
priority via LibStub. Useful for non-bundling forks (`chatter`, `sexymap`, `clique`, …) to
get Ace without each one carrying its own copy.

## Sync policy

Bumping upstream means a single PR here, then a sweep across every fork that embeds these
libs. Note the new upstream commit in the README's commit-pin line above. Never edit a
library file in place; if a CoA-specific patch is genuinely needed, ship it as a separate
loadable addon that registers a higher MINOR via LibStub, leaving this bundle pristine.