wuira 0.3.0 → 0.3.3

package/CHANGELOG.md

@@ -7,6 +7,38 @@ with the release date and highlight breaking changes explicitly.
 
 ## Unreleased
 
+## 0.3.3 — 2026-10-19
+
+### Breaking
+
+- Datasource classes open through `UseSource`. `new HP()`, `new Mana()`, `new SourceConverter()`, and the other datasource constructors are not part of the TypeScript API.
+
+### Added
+
+- `Absorb` reads `UnitGetTotalAbsorbs`. `Prediction` reads `UnitGetIncomingHeals`. Both are standalone sources.
+- `UseSource(HP, unit).UseAbsorb().UsePrediction()` appends those sources for the same unit. `hp.Absorb` and `hp.Prediction` stay empty until requested.
+- `Source` stores the query props and passes them back on each read.
+
+### Changed
+
+- `UseHealPrediction`, `UseAbsorbPrediction`, `HealPrediction`, and `AbsorbPrediction` forward to the new methods and getters.
+
+## 0.3.2 — 2026-10-19
+
+### Fixed
+
+- Older `justify` uses only leftover space. A line wider than its container stays at the start instead of being pulled backward.
+
+## 0.3.1 — 2026-10-19
+
+### Added
+
+- `width` and `height` accept `"fill"`. Fill children share the space left after fixed siblings. `"inherit"` still takes the whole parent.
+- Flow and grid accept `ltr`, `rtl`, `ttb`, and `btt`, plus `alignX` and `alignY`. A child's anchor places it inside its slot. Older `horizontal`, `vertical`, and `justify` values still apply.
+- Flow `columnGap` and `rowGap` set horizontal and vertical spacing independently. Older `gap` and `lineGap` still apply when the matching axis is unset.
+- `startOverlayGlow` draws Pixel, button overlay, autocast shine, and proc styles with additive textures. It returns a stop function and does not depend on another addon.
+- Static client catalogs for progress textures, backgrounds, borders, and fonts. A catalog key resolves to a Blizzard path; any other string remains a custom path.
+
 ## 0.3.0 — 2026-10-17
 
 ### Breaking

package/README.md

@@ -54,18 +54,33 @@ npm run build
 
 ## Data sources
 
+Open every datasource with `UseSource`. Those classes have no public constructor.
+
 ```tsx
-import { HP, Mana, Unit } from "wuira/datasources";
+import { UseSource, HP, Mana, Unit } from "wuira/datasources";
 
-const hp = new HP(Unit.Player).UseHealPrediction().UseAbsorbPrediction();
-const mana = new Mana(Unit.Player).UseRegenTimer();
+const hp = UseSource(HP, Unit.Player).UsePrediction().UseAbsorb();
+const mana = UseSource(Mana, Unit.Player).UseRegenTimer();
 
 <progress height={24} source={hp} />
 <progress height={24} source={mana} />
 ```
 
+`UsePrediction()` and `UseAbsorb()` append the same `Prediction` and `Absorb` sources for that unit. Read them as `hp.Prediction` and `hp.Absorb`. Incoming heals are `UnitGetIncomingHeals`. Absorbs are `UnitGetTotalAbsorbs`. `hp.Value`, `hp.Max`, and `hp.Percent` stay the three health reads.
+
 Other sources include `AuraTimer`, `GlobalCooldown`, `CastTimer`, `SpellCooldown`, `SwingTimer`, `GroupMembers`, `PartyMembers`, `RaidMembers`, `Buffs`, `Debuffs`, `KnownSpells`, `Spells`, `UnitSource`, `ClassSource`, `SpecSource`, and `SpellSource`.
 
+## Layout
+
+`width` and `height` accept a number, `"inherit"`, or `"fill"`. Fill siblings share the space left after fixed children. `columnGap` is horizontal space. `rowGap` is vertical space.
+
+```tsx
+<flow width={200} height={40} direction="ltr" columnGap={4} rowGap={2} alignY="center">
+    <cell width="fill" height={12} />
+    <cell width={40} height={12} />
+</flow>
+```
+
 ## Secure buttons
 
 ```tsx
@@ -82,14 +97,14 @@ Supported action types: `spell`, `item`, `macro`, `action`, and `target`. Action
 ```tsx
 import { UI } from "wuira/ui";
 import { Nameplates } from "wuira/skins";
-import { HP } from "wuira/datasources";
+import { UseSource, HP } from "wuira/datasources";
 
 const plates = Nameplates
     .Apply(p => p.GUID === configuredGUID, p => {
         if (p.Native.healthBar) p.Size(p.Native.healthBar, 140, 12);
     })
     .Replace(() => true, p => (
-        <progress width={140} height={12} source={new HP(p.Unit)} />
+        <progress width={140} height={12} source={UseSource(HP, p.Unit)} />
     ));
 
 // plates.Dispose();

package/docs/source-converters.md

@@ -3,12 +3,12 @@
 `SourceConverter` transforms a readable source with a typed callback. It consumes change notifications, shares one upstream subscription across observers, and does not create a timer or dispose the shared input. Sources without notifications remain available as checked one-time reads.
 
 ```ts
-import { SourceConverter, HP, ClassSource, Unit } from "wuira/datasources";
+import { UseSource, SourceConverter, HP, ClassSource, Unit } from "wuira/datasources";
 
-const hp = new HP(Unit.Player);
-const doubled = new SourceConverter(hp, value => value * 2);
-const characterClass = new ClassSource(Unit.Player);
-const token = new SourceConverter(characterClass, info => info?.token);
+const hp = UseSource(HP, Unit.Player);
+const doubled = UseSource(SourceConverter, hp, value => value * 2);
+const characterClass = UseSource(ClassSource, Unit.Player);
+const token = UseSource(SourceConverter, characterClass, info => info?.token);
 const stop = doubled.BindTo(value => console.log(value));
 
 // On removal:

package/lib/datasources/AuraTimer.d.ts

@@ -14,7 +14,7 @@ export declare class AuraTimer extends TimerSource {
     readonly target: UnitSource;
     readonly Texture: TextureSource;
     private status;
-    constructor(unit: UnitInput, options: AuraTimerOptions);
+    protected constructor(unit: UnitInput, options: AuraTimerOptions);
     get Status(): AuraTimerStatus;
     private ReadAura;
     private ReadDuration;

package/lib/datasources/AuraTimer.lua

@@ -179,6 +179,10 @@ end
 local ____exports = {}
 local ____TimerSource = require("datasources.TimerSource")
 local TimerSource = ____TimerSource.TimerSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
+local ____UseSource = require("datasources.UseSource")
+local UseSource = ____UseSource.UseSource
 local ____TextureSource = require("datasources.TextureSource")
 local TextureSource = ____TextureSource.TextureSource
 local ____UnitSource = require("datasources.UnitSource")
@@ -206,7 +210,8 @@ function AuraTimer.prototype.____constructor(self, unit, options)
     self.options = options
     self.status = "inactive"
     self.target = target
-    self.Texture = __TS__New(
+    self.Texture = UseSource(
+        nil,
         TextureSource,
         function()
             local ____opt_0 = self:ReadAura()
@@ -309,7 +314,14 @@ function AuraTimer.prototype.ReadDuration(self)
             return ____returnValue
         end
     end
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.AuraTimer,
+        function(____, props) return __TS__New(____exports.AuraTimer, props[1], props[2]) end
+    )
+end)(AuraTimer)
 __TS__SetDescriptor(
     AuraTimer.prototype,
     "Status",

package/lib/datasources/Auras.d.ts

@@ -25,8 +25,8 @@ export declare abstract class AuraSource extends DataSource<readonly Aura[]> {
     protected GetValue(): readonly Aura[];
 }
 export declare class Buffs extends AuraSource {
-    constructor(unit: UnitInput);
+    protected constructor(unit: UnitInput);
 }
 export declare class Debuffs extends AuraSource {
-    constructor(unit: UnitInput);
+    protected constructor(unit: UnitInput);
 }

package/lib/datasources/Auras.lua

@@ -179,6 +179,8 @@ end
 local ____exports = {}
 local ____DataSource = require("datasources.DataSource")
 local DataSource = ____DataSource.DataSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
 local ____UnitSource = require("datasources.UnitSource")
 local resolveUnit = ____UnitSource.resolveUnit
 --- Readable aura snapshot. Unit tokens describe the source at snapshot time.
@@ -273,12 +275,26 @@ Buffs.name = "Buffs"
 __TS__ClassExtends(Buffs, ____exports.AuraSource)
 function Buffs.prototype.____constructor(self, unit)
     Buffs.____super.prototype.____constructor(self, unit, "HELPFUL")
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.Buffs,
+        function(____, props) return __TS__New(____exports.Buffs, props[1]) end
+    )
+end)(Buffs)
 ____exports.Debuffs = __TS__Class()
 local Debuffs = ____exports.Debuffs
 Debuffs.name = "Debuffs"
 __TS__ClassExtends(Debuffs, ____exports.AuraSource)
 function Debuffs.prototype.____constructor(self, unit)
     Debuffs.____super.prototype.____constructor(self, unit, "HARMFUL")
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.Debuffs,
+        function(____, props) return __TS__New(____exports.Debuffs, props[1]) end
+    )
+end)(Debuffs)
 return ____exports

package/lib/datasources/CastTimer.d.ts

@@ -5,5 +5,5 @@ import type { UnitInput } from "./UnitSource";
 export declare class CastTimer extends TimerSource {
     readonly target: UnitSource;
     get SpellName(): string;
-    constructor(unit?: UnitInput);
+    protected constructor(unit?: UnitInput);
 }

package/lib/datasources/CastTimer.lua

@@ -171,10 +171,18 @@ do
         metatable.__newindex = descriptorNewIndex
     end
 end
+
+local function __TS__New(target, ...)
+    local instance = setmetatable({}, target.prototype)
+    instance:____constructor(...)
+    return instance
+end
 -- End of Lua Library inline imports
 local ____exports = {}
 local ____TimerSource = require("datasources.TimerSource")
 local TimerSource = ____TimerSource.TimerSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
 local ____UnitSource = require("datasources.UnitSource")
 local Unit = ____UnitSource.Unit
 local resolveUnit = ____UnitSource.resolveUnit
@@ -236,5 +244,12 @@ __TS__SetDescriptor(
         return channel or ""
     end},
     true
-)
+);
+(function(self)
+    registerSource(
+        nil,
+        ____exports.CastTimer,
+        function(____, props) return __TS__New(____exports.CastTimer, props[1]) end
+    )
+end)(CastTimer)
 return ____exports

package/lib/datasources/EditModeLayouts.d.ts

@@ -20,7 +20,7 @@ export declare class EditModeLayouts extends DataSource<EditModeLayoutSnapshot>
     private readonly listeners;
     private readonly frame;
     private disposed;
-    constructor();
+    protected constructor();
     get Status(): EditModeLayoutsStatus;
     get Layouts(): readonly EditModeLayout[];
     get Active(): EditModeLayout | undefined;

package/lib/datasources/EditModeLayouts.lua

@@ -520,6 +520,8 @@ end
 local ____exports = {}
 local ____DataSource = require("datasources.DataSource")
 local DataSource = ____DataSource.DataSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
 --- Read-only native Edit Mode layouts, refreshed by events without polling.
 ____exports.EditModeLayouts = __TS__Class()
 local EditModeLayouts = ____exports.EditModeLayouts
@@ -661,7 +663,14 @@ function EditModeLayouts.prototype.Dispose(self)
     self.frame:UnregisterAllEvents()
     self.frame:SetScript("OnEvent", nil)
     self.frame:Hide()
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.EditModeLayouts,
+        function() return __TS__New(____exports.EditModeLayouts) end
+    )
+end)(EditModeLayouts)
 __TS__SetDescriptor(
     EditModeLayouts.prototype,
     "Status",

package/lib/datasources/GroupMembers.d.ts

@@ -6,7 +6,7 @@ export declare class GroupMembers extends DataSource<readonly string[]> {
     private restricted;
     private readonly listeners;
     private frame?;
-    constructor(scope?: GroupScope);
+    protected constructor(scope?: GroupScope);
     /** Roster/connection events, with one listener frame while observed. No polling. */
     onChange(listener: (units: readonly string[]) => void): () => void;
     private StopListening;
@@ -16,9 +16,9 @@ export declare class GroupMembers extends DataSource<readonly string[]> {
 }
 /** Includes the player in a party; empty when solo or in a raid. */
 export declare class PartyMembers extends GroupMembers {
-    constructor();
+    protected constructor();
 }
 /** Includes the player through their raidN token; empty outside a raid. */
 export declare class RaidMembers extends GroupMembers {
-    constructor();
+    protected constructor();
 }

package/lib/datasources/GroupMembers.lua

@@ -321,6 +321,8 @@ end
 local ____exports = {}
 local ____DataSource = require("datasources.DataSource")
 local DataSource = ____DataSource.DataSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
 --- Fresh roster tokens, including offline members. Tokens are not persistent identities.
 ____exports.GroupMembers = __TS__Class()
 local GroupMembers = ____exports.GroupMembers
@@ -434,7 +436,14 @@ function GroupMembers.prototype.GetValue(self)
         end
     end
     return units
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.GroupMembers,
+        function(____, props) return __TS__New(____exports.GroupMembers, props[1]) end
+    )
+end)(GroupMembers)
 --- Includes the player in a party; empty when solo or in a raid.
 ____exports.PartyMembers = __TS__Class()
 local PartyMembers = ____exports.PartyMembers
@@ -442,7 +451,14 @@ PartyMembers.name = "PartyMembers"
 __TS__ClassExtends(PartyMembers, ____exports.GroupMembers)
 function PartyMembers.prototype.____constructor(self)
     PartyMembers.____super.prototype.____constructor(self, "party")
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.PartyMembers,
+        function() return __TS__New(____exports.PartyMembers) end
+    )
+end)(PartyMembers)
 --- Includes the player through their raidN token; empty outside a raid.
 ____exports.RaidMembers = __TS__Class()
 local RaidMembers = ____exports.RaidMembers
@@ -450,5 +466,12 @@ RaidMembers.name = "RaidMembers"
 __TS__ClassExtends(RaidMembers, ____exports.GroupMembers)
 function RaidMembers.prototype.____constructor(self)
     RaidMembers.____super.prototype.____constructor(self, "raid")
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.RaidMembers,
+        function() return __TS__New(____exports.RaidMembers) end
+    )
+end)(RaidMembers)
 return ____exports

package/lib/datasources/GroupRoster.d.ts

@@ -17,7 +17,7 @@ export declare class GroupRoster extends DataSource<readonly GroupRosterMember[]
     private snapshot;
     private restricted;
     get Status(): "ready" | "restricted";
-    constructor(scope?: GroupScope, options?: {
+    protected constructor(scope?: GroupScope, options?: {
         pets?: boolean;
         includeSelfWhenSolo?: boolean;
     });

package/lib/datasources/GroupRoster.lua

@@ -47,12 +47,6 @@ local function __TS__ClassExtends(target, base)
     end
 end
 
-local function __TS__New(target, ...)
-    local instance = setmetatable({}, target.prototype)
-    instance:____constructor(...)
-    return instance
-end
-
 local __TS__Symbol, Symbol
 do
     local symbolMetatable = {__tostring = function(self)
@@ -277,6 +271,12 @@ do
     Map[Symbol.species] = Map
 end
 
+local function __TS__New(target, ...)
+    local instance = setmetatable({}, target.prototype)
+    instance:____constructor(...)
+    return instance
+end
+
 local __TS__Unpack = table.unpack or unpack
 
 local function __TS__ArrayMap(self, callbackfn, thisArg)
@@ -474,6 +474,10 @@ end
 local ____exports = {}
 local ____DataSource = require("datasources.DataSource")
 local DataSource = ____DataSource.DataSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
+local ____UseSource = require("datasources.UseSource")
+local UseSource = ____UseSource.UseSource
 local ____GroupMembers = require("datasources.GroupMembers")
 local GroupMembers = ____GroupMembers.GroupMembers
 function ____exports.getPetUnitToken(self, unit)
@@ -504,7 +508,7 @@ function GroupRoster.prototype.____constructor(self, scope, options)
     self.knownNames = __TS__New(Map)
     self.snapshot = {}
     self.restricted = false
-    self.roster = __TS__New(GroupMembers, scope)
+    self.roster = UseSource(nil, GroupMembers, scope)
 end
 function GroupRoster.prototype.GetValue(self)
     self.restricted = self.roster:IsSecret()
@@ -607,5 +611,12 @@ __TS__SetDescriptor(
         return self.restricted and "restricted" or "ready"
     end},
     true
-)
+);
+(function(self)
+    registerSource(
+        nil,
+        ____exports.GroupRoster,
+        function(____, props) return __TS__New(____exports.GroupRoster, props[1], props[2]) end
+    )
+end)(GroupRoster)
 return ____exports

package/lib/datasources/KnownSpells.d.ts

@@ -14,7 +14,7 @@ export declare class KnownSpells extends DataSource<readonly number[]> {
     private readonly listeners;
     private readonly frame;
     private disposed;
-    constructor();
+    protected constructor();
     get Status(): KnownSpellsStatus;
     /** Detached cached metadata, with no native reads. Unreadable books return no entries. */
     get Entries(): readonly KnownSpell[];

package/lib/datasources/KnownSpells.lua

@@ -753,6 +753,8 @@ end
 local ____exports = {}
 local ____DataSource = require("datasources.DataSource")
 local DataSource = ____DataSource.DataSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
 --- Cached learned player spellbook IDs. Native events refresh the snapshot; no polling.
 ____exports.KnownSpells = __TS__Class()
 local KnownSpells = ____exports.KnownSpells
@@ -1045,7 +1047,14 @@ function KnownSpells.prototype.Dispose(self)
     self.frame:SetScript("OnEvent", nil)
     self.frame:Hide()
     self.listeners:clear()
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.KnownSpells,
+        function() return __TS__New(____exports.KnownSpells) end
+    )
+end)(KnownSpells)
 __TS__SetDescriptor(
     KnownSpells.prototype,
     "Status",

package/lib/datasources/ManaRegenTimer.d.ts

@@ -14,7 +14,7 @@ export declare class ManaRegenTimer extends ProgressSource {
     private readonly bindings;
     private alphaCurve?;
     private disposed;
-    constructor(observe: ObserveMana);
+    protected constructor(observe: ObserveMana);
     get Phase(): ManaRegenPhase;
     get IsActive(): boolean;
     private Remaining;

package/lib/datasources/ManaRegenTimer.lua

@@ -451,6 +451,8 @@ end
 local ____exports = {}
 local ____ProgressSource = require("datasources.ProgressSource")
 local ProgressSource = ____ProgressSource.ProgressSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
 --- Owned by Mana.UseRegenTimer(). The two-second phase is an estimate, not a server clock.
 ____exports.ManaRegenTimer = __TS__Class()
 local ManaRegenTimer = ____exports.ManaRegenTimer
@@ -654,7 +656,14 @@ function ManaRegenTimer.prototype.Dispose(self)
         ____opt_12(self)
     end
     self.unsubscribe = nil
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.ManaRegenTimer,
+        function(____, props) return __TS__New(____exports.ManaRegenTimer, props[1]) end
+    )
+end)(ManaRegenTimer)
 __TS__SetDescriptor(
     ManaRegenTimer.prototype,
     "Phase",

package/lib/datasources/NativeNumberSource.d.ts

@@ -2,6 +2,6 @@ import { DataSource } from "./DataSource";
 /** Read-only API value; no cached assignment or game-state mutation. */
 export declare class NativeNumberSource extends DataSource<number> {
     private readonly read;
-    constructor(read: () => number);
+    protected constructor(read: () => number);
     protected GetValue(): number;
 }

package/lib/datasources/NativeNumberSource.lua

@@ -31,10 +31,18 @@ local function __TS__ClassExtends(target, base)
         target.prototype.__tostring = base.prototype.__tostring
     end
 end
+
+local function __TS__New(target, ...)
+    local instance = setmetatable({}, target.prototype)
+    instance:____constructor(...)
+    return instance
+end
 -- End of Lua Library inline imports
 local ____exports = {}
 local ____DataSource = require("datasources.DataSource")
 local DataSource = ____DataSource.DataSource
+local ____Source = require("datasources.Source")
+local registerSource = ____Source.registerSource
 --- Read-only API value; no cached assignment or game-state mutation.
 ____exports.NativeNumberSource = __TS__Class()
 local NativeNumberSource = ____exports.NativeNumberSource
@@ -46,5 +54,12 @@ function NativeNumberSource.prototype.____constructor(self, read)
 end
 function NativeNumberSource.prototype.GetValue(self)
     return self:read()
-end
+end;
+(function(self)
+    registerSource(
+        nil,
+        ____exports.NativeNumberSource,
+        function(____, props) return __TS__New(____exports.NativeNumberSource, props[1]) end
+    )
+end)(NativeNumberSource)
 return ____exports

package/lib/datasources/ProgressSource.lua

@@ -31,18 +31,14 @@ local function __TS__ClassExtends(target, base)
         target.prototype.__tostring = base.prototype.__tostring
     end
 end
-
-local function __TS__New(target, ...)
-    local instance = setmetatable({}, target.prototype)
-    instance:____constructor(...)
-    return instance
-end
 -- End of Lua Library inline imports
 local ____exports = {}
 local ____DataSource = require("datasources.DataSource")
 local DataSource = ____DataSource.DataSource
 local ____NativeNumberSource = require("datasources.NativeNumberSource")
 local NativeNumberSource = ____NativeNumberSource.NativeNumberSource
+local ____UseSource = require("datasources.UseSource")
+local UseSource = ____UseSource.UseSource
 --- Shared contract for health, power, cooldowns, and other progress values.
 ____exports.ProgressSource = __TS__Class()
 local ProgressSource = ____exports.ProgressSource
@@ -51,9 +47,9 @@ __TS__ClassExtends(ProgressSource, DataSource)
 function ProgressSource.prototype.____constructor(self, readers)
     DataSource.prototype.____constructor(self, 0)
     self.readers = readers
-    self.Min = __TS__New(NativeNumberSource, readers.min)
-    self.Max = __TS__New(NativeNumberSource, readers.max)
-    self.Percent = __TS__New(NativeNumberSource, readers.percent)
+    self.Min = UseSource(nil, NativeNumberSource, readers.min)
+    self.Max = UseSource(nil, NativeNumberSource, readers.max)
+    self.Percent = UseSource(nil, NativeNumberSource, readers.percent)
 end
 function ProgressSource.prototype.GetValue(self)
     return self.readers:current()

package/lib/datasources/Resources.d.ts

@@ -1,9 +1,9 @@
 import { ProgressSource } from "./ProgressSource";
 import { UnitSource } from "./UnitSource";
 import type { UnitInput } from "./UnitSource";
-import { DataSource } from "./DataSource";
 import type { ProgressOverrides } from "./ProgressSource";
 import { ManaRegenTimer } from "./ManaRegenTimer";
+import { Source } from "./Source";
 export { Unit } from "./UnitSource";
 /** Direct API-to-widget binding; opaque values are never compared or calculated. */
 declare abstract class Resource extends ProgressSource {
@@ -23,25 +23,46 @@ declare abstract class Resource extends ProgressSource {
     protected Observe(listener: (event: string, payload: unknown[], value: number) => void): () => void;
     protected Listen(_frame: wuiraNativeFrame, refresh: () => void): () => void;
 }
-/** Live optional prediction channel. Secret amounts only travel to native sinks. */
-export declare class HealthPrediction extends DataSource<number> {
-    private readonly read;
-    constructor(read: (() => number | undefined) | undefined);
-    get IsAvailable(): boolean;
-    protected GetValue(): number;
+/** One optional unit amount. A missing native function stays unavailable and is never called. */
+declare abstract class UnitAmount extends Source<number, [UnitInput]> {
+    readonly target: UnitSource;
+    abstract get IsAvailable(): boolean;
+    protected constructor(unit: UnitInput);
     ApplyTo(frame: wuiraNativeStatusBar, maximum: number): void;
 }
+/** Total absorbs on a unit. `UnitGetTotalAbsorbs`. */
+export declare class Absorb extends UnitAmount {
+    get IsAvailable(): boolean;
+    protected constructor(unit: UnitInput);
+    protected read(props: [UnitInput]): number;
+}
+/** Incoming heals on a unit. `UnitGetIncomingHeals`. */
+export declare class Prediction extends UnitAmount {
+    get IsAvailable(): boolean;
+    protected constructor(unit: UnitInput);
+    protected read(props: [UnitInput]): number;
+}
 export declare class HP extends Resource {
-    private healPrediction?;
-    private absorbPrediction?;
-    get HealPrediction(): HealthPrediction | undefined;
-    get AbsorbPrediction(): HealthPrediction | undefined;
-    UseHealPrediction(): this;
+    private absorb?;
+    private prediction?;
+    /** Same object as `UseSource(Absorb, unit)`. Absent until `UseAbsorb`. */
+    get Absorb(): Absorb | undefined;
+    /** Same object as `UseSource(Prediction, unit)`. Absent until `UsePrediction`. */
+    get Prediction(): Prediction | undefined;
+    /** @deprecated Use Absorb. */
+    get AbsorbPrediction(): Absorb | undefined;
+    /** @deprecated Use Prediction. */
+    get HealPrediction(): Prediction | undefined;
+    UseAbsorb(): this;
+    UsePrediction(): this;
+    /** @deprecated Use UseAbsorb. */
     UseAbsorbPrediction(): this;
+    /** @deprecated Use UsePrediction. */
+    UseHealPrediction(): this;
     BindTo(frame: wuiraNativeStatusBar, options?: ProgressOverrides): () => void;
     readonly target: UnitSource;
     get unit(): string;
-    constructor(unit?: UnitInput);
+    protected constructor(unit?: UnitInput);
 }
 /** Explicit mana (power type 0), even while the unit uses rage/energy. */
 export declare class Mana extends Resource {
@@ -50,7 +71,7 @@ export declare class Mana extends Resource {
     UseRegenTimer(): this;
     readonly target: UnitSource;
     get unit(): string;
-    constructor(unit: UnitInput);
+    protected constructor(unit: UnitInput);
 }
 export declare const DataSources: {
     Resources: {