| name | k-fencore |
| description | Context for FenCore - the pure logic library for WoW addons. Covers utility functions, math helpers, table operations, and environment detection. Load this when working with FenCore or needing utility functions. Triggers: fencore, utility, math, table, logic, pure functions.
|
FenCore Library
FenCore is a pure logic library for WoW addons - no UI dependencies, just utility functions.
Design Philosophy
- Pure Functions: No side effects, predictable outputs
- No UI Dependencies: Works in any layer of your addon
- Testable: All functions can be unit tested without WoW
- Documented: Every function has clear input/output contracts
MCP Tools
| Task |
MCP Tool |
| List All Functions |
fencore.catalog() |
| Search Functions |
fencore.search(query="clamp") |
| Get Function Details |
fencore.info(domain="Math", function="Clamp") |
Domains
FenCore organizes functions by domain:
| Domain |
Purpose |
Examples |
| Math |
Numeric operations |
Clamp, Round, Lerp, InRange |
| Table |
Table manipulation |
Copy, Merge, Filter, Map |
| String |
String utilities |
Split, Trim, StartsWith, Format |
| Color |
Color manipulation |
HexToRGB, RGBToHex, Lighten, Darken |
| Time |
Time formatting |
FormatDuration, FormatTime, ParseDuration |
| Environment |
WoW detection |
IsRetail, IsClassic, GetExpansion |
Usage Pattern
local FenCore = LibStub("FenCore")
-- Access by domain
local Math = FenCore.Math
local result = Math.Clamp(value, 0, 100)
-- Or direct access
local clamped = FenCore.Math.Clamp(value, 0, 100)
Common Functions
Math
FenCore.Math.Clamp(value, min, max) -- Constrain value to range
FenCore.Math.Round(value, decimals) -- Round to decimal places
FenCore.Math.Lerp(a, b, t) -- Linear interpolation
FenCore.Math.InRange(value, min, max) -- Check if value in range
Table
FenCore.Table.Copy(tbl) -- Shallow copy
FenCore.Table.DeepCopy(tbl) -- Deep copy
FenCore.Table.Merge(base, override) -- Merge tables
FenCore.Table.Filter(tbl, predicate) -- Filter by function
FenCore.Table.Map(tbl, transform) -- Transform values
Environment
FenCore.Environment.IsRetail() -- true if retail client
FenCore.Environment.IsClassic() -- true if classic client
FenCore.Environment.GetExpansion() -- "TWW", "Classic", etc.
FenCore.Environment.GetBuildInfo() -- version, build, date
Best Practices
- Use for Core layer - FenCore belongs in your addon's pure logic layer
- Don't wrap unnecessarily - Call FenCore directly, don't create wrappers
- Check domain first - Use
fencore.search to find existing functions before writing your own
- Prefer pure functions - If you need state, that belongs in Bridge layer