mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 16:10:36 +00:00
The engine sets an addon entry's loaded byte at the START of its load, before dependencies and before the addon's own files run, clearing it again only if a required dependency fails. That byte therefore means "load has begun" -- it is loadedOrLoading, not loaded. IsAddOnLoaded returned it for both values, so an addon checking itself at file scope got (true, true) where it should get (true, false). The old comment claimed the in-flight window was unobservable from Lua; it is plainly observable, since the addon's own files and every dependency pulled in during them execute inside it. Add AddOns::LoadState, which co-hooks the per-addon loader and keeps a stack of the names currently loading -- a stack because dependency loads nest, and the name is copied because LoadAddOn passes a transient Lua string. loadedOrLoading stays the engine byte; loaded now also requires the addon not to be mid-load. Known gap, documented: an addon asking about itself from its own ADDON_LOADED handler still reads (true, false), as that event fires just before the load call returns. Also mirror the stock LoadAddOn global into C_AddOns. It already returns the modern (loaded, value) shape -- 1/nil plus a locale-independent reason token -- so it registers as the engine's own handler.
34 lines
1.5 KiB
C++
34 lines
1.5 KiB
C++
// This file is part of ClassicAPI.
|
|
//
|
|
// ClassicAPI is free software: you can redistribute it and/or modify it under the terms
|
|
// of the GNU General Public License as published by the Free Software Foundation, either
|
|
// version 3 of the License, or (at your option) any later version.
|
|
//
|
|
// ClassicAPI is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
// WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
// PURPOSE. See the GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License along with
|
|
// ClassicAPI. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
#pragma once
|
|
|
|
// `AddOns::LoadState` — tracks which addons are mid-load.
|
|
//
|
|
// The engine's own "loaded" byte (`entry+0x18`) is set at the START of a
|
|
// load, before the addon's files run, so on its own it can't tell
|
|
// "loading" from "loaded". That distinction is observable: an addon's
|
|
// file-scope code, and every dependency pulled in during it, execute
|
|
// while the byte already reads set.
|
|
//
|
|
// A co-hook on the per-addon loader keeps a stack of the names currently
|
|
// being loaded, which is the missing half of
|
|
// `C_AddOns.IsAddOnLoaded`'s `(loadedOrLoading, loaded)` pair.
|
|
namespace AddOns::LoadState {
|
|
|
|
// True while `name` is inside the engine's per-addon load call. Matching
|
|
// is case-insensitive, as addon-name matching is everywhere else.
|
|
bool IsLoading(const char *name);
|
|
|
|
} // namespace AddOns::LoadState
|