warscript 0.0.1-dev.cdcfbc9 → 0.0.1-dev.ce2be36

package/engine/object-field.lua

@@ -25,6 +25,7 @@ local mutableLinkedSet = ____linked_2Dset.mutableLinkedSet
 local ____lua_2Dmaps = require("utility.lua-maps")
 local emptyLuaMap = ____lua_2Dmaps.emptyLuaMap
 local getOrPut = ____lua_2Dmaps.getOrPut
+local mutableLuaMap = ____lua_2Dmaps.mutableLuaMap
 local mutableWeakLuaMap = ____lua_2Dmaps.mutableWeakLuaMap
 local ____arrays = require("utility.arrays")
 local emptyArray = ____arrays.emptyArray
@@ -150,7 +151,13 @@ function ObjectField.prototype.applyModifier(self, instance, modifier)
             originalValueByInstance = mutableWeakLuaMap()
             self.originalValueByInstance = originalValueByInstance
         end
-        originalValueByInstance[instance] = self:getActualValue(instance)
+        local ____originalValueByInstance_1 = originalValueByInstance
+        local ____instance_2 = instance
+        local ____originalValueByInstance_instance_0 = originalValueByInstance[instance]
+        if ____originalValueByInstance_instance_0 == nil then
+            ____originalValueByInstance_instance_0 = self:getActualValue(instance)
+        end
+        ____originalValueByInstance_1[____instance_2] = ____originalValueByInstance_instance_0
         self:setActualValue(
             instance,
             self:calculateActualValue(instance)
@@ -196,22 +203,22 @@ function ObjectField.prototype.getActualValue(self, instance)
     if defaultValueByObjectDataEntryId ~= nil or self.isGlobal then
         local defaultValue = (defaultValueByObjectDataEntryId or emptyLuaMap())[self:getObjectDataEntryId(instance)]
         if defaultValue ~= nil or self.isGlobal then
-            local ____self_valueByInstance_instance_0 = self.valueByInstance[instance]
-            if ____self_valueByInstance_instance_0 == nil then
-                ____self_valueByInstance_instance_0 = defaultValue
+            local ____self_valueByInstance_instance_3 = self.valueByInstance[instance]
+            if ____self_valueByInstance_instance_3 == nil then
+                ____self_valueByInstance_instance_3 = defaultValue
             end
-            local ____self_valueByInstance_instance_0_1 = ____self_valueByInstance_instance_0
-            if ____self_valueByInstance_instance_0_1 == nil then
-                ____self_valueByInstance_instance_0_1 = self.defaultValue
+            local ____self_valueByInstance_instance_3_4 = ____self_valueByInstance_instance_3
+            if ____self_valueByInstance_instance_3_4 == nil then
+                ____self_valueByInstance_instance_3_4 = self.defaultValue
             end
-            return ____self_valueByInstance_instance_0_1
+            return ____self_valueByInstance_instance_3_4
         end
     end
-    local ____temp_2 = self:getNativeFieldValue(instance)
-    if ____temp_2 == nil then
-        ____temp_2 = self.defaultValue
+    local ____temp_5 = self:getNativeFieldValue(instance)
+    if ____temp_5 == nil then
+        ____temp_5 = self.defaultValue
     end
-    return ____temp_2
+    return ____temp_5
 end
 function ObjectField.prototype.setActualValue(self, instance, value)
     local defaultValueByObjectDataEntryId = defaultValueByObjectDataEntryIdByObjectFieldId[self.id]
@@ -219,15 +226,15 @@ function ObjectField.prototype.setActualValue(self, instance, value)
     if defaultValueByObjectDataEntryId ~= nil or self.isGlobal then
         local defaultValue = (defaultValueByObjectDataEntryId or emptyLuaMap())[objectDataEntryId]
         if defaultValue ~= nil or self.isGlobal then
-            local ____self_valueByInstance_instance_3 = self.valueByInstance[instance]
-            if ____self_valueByInstance_instance_3 == nil then
-                ____self_valueByInstance_instance_3 = defaultValue
+            local ____self_valueByInstance_instance_6 = self.valueByInstance[instance]
+            if ____self_valueByInstance_instance_6 == nil then
+                ____self_valueByInstance_instance_6 = defaultValue
             end
-            local ____self_valueByInstance_instance_3_4 = ____self_valueByInstance_instance_3
-            if ____self_valueByInstance_instance_3_4 == nil then
-                ____self_valueByInstance_instance_3_4 = self.defaultValue
+            local ____self_valueByInstance_instance_6_7 = ____self_valueByInstance_instance_6
+            if ____self_valueByInstance_instance_6_7 == nil then
+                ____self_valueByInstance_instance_6_7 = self.defaultValue
             end
-            local previousValue = ____self_valueByInstance_instance_3_4
+            local previousValue = ____self_valueByInstance_instance_6_7
             if value ~= previousValue then
                 self.valueByInstance[instance] = value
                 self:invokeValueChangeEvent(instance, self, previousValue, value)
@@ -248,10 +255,10 @@ function ObjectField.prototype.setActualValue(self, instance, value)
     return true
 end
 function ObjectField.prototype.calculateActualValue(self, instance)
-    local ____opt_5 = self.originalValueByInstance
-    local originalValue = ____opt_5 and ____opt_5[instance]
-    local ____opt_7 = self.modifiersByInstance
-    local modifiers = ____opt_7 and ____opt_7[instance]
+    local ____opt_8 = self.originalValueByInstance
+    local originalValue = ____opt_8 and ____opt_8[instance]
+    local ____opt_10 = self.modifiersByInstance
+    local modifiers = ____opt_10 and ____opt_10[instance]
     if originalValue ~= nil then
         local value = originalValue
         if modifiers ~= nil then
@@ -316,17 +323,17 @@ function ObjectArrayField.prototype.getValue(self, entry, index)
         if defaultValueByObjectDataEntryId ~= nil then
             local value = defaultValueByObjectDataEntryId[entry.id]
             if value ~= nil then
-                local ____temp_10
+                local ____temp_13
                 if index == nil then
-                    ____temp_10 = value
+                    ____temp_13 = value
                 else
-                    local ____value_index_9 = value[index + 1]
-                    if ____value_index_9 == nil then
-                        ____value_index_9 = self.defaultValue
+                    local ____value_index_12 = value[index + 1]
+                    if ____value_index_12 == nil then
+                        ____value_index_12 = self.defaultValue
                     end
-                    ____temp_10 = ____value_index_9
+                    ____temp_13 = ____value_index_12
                 end
-                return ____temp_10
+                return ____temp_13
             end
         end
         return index == nil and ({}) or self.defaultValue
@@ -336,17 +343,17 @@ function ObjectArrayField.prototype.getValue(self, entry, index)
         local defaultValue = (defaultValueByObjectDataEntryId or emptyLuaMap())[self:getObjectDataEntryId(entry)]
         if defaultValue ~= nil or self.isGlobal then
             local value = self.valueByInstance[entry] or defaultValue or emptyArray()
-            local ____temp_12
+            local ____temp_15
             if index == nil then
-                ____temp_12 = value
+                ____temp_15 = value
             else
-                local ____value_index_11 = value[index + 1]
-                if ____value_index_11 == nil then
-                    ____value_index_11 = self.defaultValue
+                local ____value_index_14 = value[index + 1]
+                if ____value_index_14 == nil then
+                    ____value_index_14 = self.defaultValue
                 end
-                ____temp_12 = ____value_index_11
+                ____temp_15 = ____value_index_14
             end
-            return ____temp_12
+            return ____temp_15
         end
     end
     if index ~= nil then
@@ -391,36 +398,16 @@ function ObjectLevelField.prototype.getValue(self, entry, level)
         if defaultValueByObjectDataEntryId ~= nil then
             local valueByLevel = defaultValueByObjectDataEntryId[entry.id]
             if valueByLevel ~= nil then
-                local ____valueByLevel_index_13 = valueByLevel[level + 1]
-                if ____valueByLevel_index_13 == nil then
-                    ____valueByLevel_index_13 = self.defaultValue
+                local ____valueByLevel_index_16 = valueByLevel[level + 1]
+                if ____valueByLevel_index_16 == nil then
+                    ____valueByLevel_index_16 = self.defaultValue
                 end
-                return ____valueByLevel_index_13
+                return ____valueByLevel_index_16
             end
         end
         return self.defaultValue
     end
-    local defaultValueByObjectDataEntryId = defaultValueByObjectDataEntryIdByObjectFieldId[self.id]
-    if defaultValueByObjectDataEntryId ~= nil or self.isGlobal then
-        local defaultValueByLevel = (defaultValueByObjectDataEntryId or emptyLuaMap())[self:getObjectDataEntryId(entry)]
-        if defaultValueByLevel ~= nil or self.isGlobal then
-            local ____opt_14 = self.valueByInstance[entry]
-            local ____temp_16 = ____opt_14 and ____opt_14[level + 1]
-            if ____temp_16 == nil then
-                ____temp_16 = (defaultValueByLevel or emptyArray())[level + 1]
-            end
-            local ____temp_16_17 = ____temp_16
-            if ____temp_16_17 == nil then
-                ____temp_16_17 = self.defaultValue
-            end
-            return ____temp_16_17
-        end
-    end
-    local ____temp_18 = self:getNativeFieldValue(entry, level)
-    if ____temp_18 == nil then
-        ____temp_18 = self.defaultValue
-    end
-    return ____temp_18
+    return self:getActualValue(entry, level)
 end
 function ObjectLevelField.prototype.setValue(self, entry, levelOrValue, value)
     if value == nil then
@@ -460,29 +447,129 @@ function ObjectLevelField.prototype.setValue(self, entry, levelOrValue, value)
         valueByLevel[level + 1] = value
         return true
     end
+    local modifiersByInstance = self.modifiersByInstance
+    if modifiersByInstance ~= nil then
+        local modifiers = modifiersByInstance[entry]
+        if modifiers ~= nil and modifiers.size ~= 0 then
+            local originalValueByLevelByInstance = self.originalValueByLevelByInstance
+            if originalValueByLevelByInstance == nil then
+                originalValueByLevelByInstance = mutableWeakLuaMap()
+                self.originalValueByLevelByInstance = originalValueByLevelByInstance
+            end
+            getOrPut(originalValueByLevelByInstance, entry, mutableLuaMap)[level] = value
+            value = self:calculateActualValue(entry, level)
+        end
+    end
+    return self:setActualValue(entry, level, value)
+end
+function ObjectLevelField.prototype.applyModifier(self, instance, modifier)
+    local modifiersByInstance = self.modifiersByInstance
+    if modifiersByInstance == nil then
+        modifiersByInstance = mutableWeakLuaMap()
+        self.modifiersByInstance = modifiersByInstance
+    end
+    if getOrPut(modifiersByInstance, instance, mutableLinkedSet):add(modifier) then
+        local originalValueByLevelByInstance = self.originalValueByLevelByInstance
+        if originalValueByLevelByInstance == nil then
+            originalValueByLevelByInstance = mutableWeakLuaMap()
+            self.originalValueByLevelByInstance = originalValueByLevelByInstance
+        end
+        local originalValueByLevel = getOrPut(originalValueByLevelByInstance, instance, mutableLuaMap)
+        local levelCount = self:getLevelCount(instance)
+        for level = 0, levelCount - 1 do
+            local ____originalValueByLevel_level_17 = originalValueByLevel[level]
+            if ____originalValueByLevel_level_17 == nil then
+                ____originalValueByLevel_level_17 = self:getActualValue(instance, level)
+            end
+            originalValueByLevel[level] = ____originalValueByLevel_level_17
+            self:setActualValue(
+                instance,
+                level,
+                self:calculateActualValue(instance, level)
+            )
+        end
+    end
+end
+function ObjectLevelField.prototype.removeModifier(self, instance, modifier)
+    local modifiersByInstance = self.modifiersByInstance
+    if modifiersByInstance ~= nil then
+        local modifiers = modifiersByInstance[instance]
+        if modifiers ~= nil and modifiers:remove(modifier) then
+            local levelCount = self:getLevelCount(instance)
+            for level = 0, levelCount - 1 do
+                self:setActualValue(
+                    instance,
+                    level,
+                    self:calculateActualValue(instance, level)
+                )
+            end
+            return true
+        end
+    end
+    return false
+end
+function ObjectLevelField.prototype.trySetValue(self, entry, levelOrValue, value)
+    if value ~= nil then
+        if __TS__TypeOf(value) ~= __TS__TypeOf(self.defaultValue) then
+            return false
+        end
+        if type(levelOrValue) ~= "number" then
+            return false
+        end
+        return self:setValue(entry, levelOrValue, value)
+    end
+    if __TS__TypeOf(levelOrValue) ~= __TS__TypeOf(self.defaultValue) then
+        return false
+    end
+    return self:setValue(entry, levelOrValue)
+end
+function ObjectLevelField.prototype.getActualValue(self, instance, level)
+    local defaultValueByObjectDataEntryId = defaultValueByObjectDataEntryIdByObjectFieldId[self.id]
+    if defaultValueByObjectDataEntryId ~= nil or self.isGlobal then
+        local defaultValueByLevel = (defaultValueByObjectDataEntryId or emptyLuaMap())[self:getObjectDataEntryId(instance)]
+        if defaultValueByLevel ~= nil or self.isGlobal then
+            local ____opt_18 = self.valueByInstance[instance]
+            local ____temp_20 = ____opt_18 and ____opt_18[level + 1]
+            if ____temp_20 == nil then
+                ____temp_20 = (defaultValueByLevel or emptyArray())[level + 1]
+            end
+            local ____temp_20_21 = ____temp_20
+            if ____temp_20_21 == nil then
+                ____temp_20_21 = self.defaultValue
+            end
+            return ____temp_20_21
+        end
+    end
+    local ____temp_22 = self:getNativeFieldValue(instance, level)
+    if ____temp_22 == nil then
+        ____temp_22 = self.defaultValue
+    end
+    return ____temp_22
+end
+function ObjectLevelField.prototype.setActualValue(self, instance, level, value)
     local defaultValueByObjectDataEntryId = defaultValueByObjectDataEntryIdByObjectFieldId[self.id]
-    local objectDataEntryId = self:getObjectDataEntryId(entry)
+    local objectDataEntryId = self:getObjectDataEntryId(instance)
     if defaultValueByObjectDataEntryId ~= nil or self.isGlobal then
         local defaultValueByLevel = (defaultValueByObjectDataEntryId or emptyLuaMap())[objectDataEntryId]
         if defaultValueByLevel ~= nil or self.isGlobal then
-            local valueByLevel = self.valueByInstance[entry]
+            local valueByLevel = self.valueByInstance[instance]
             if valueByLevel == nil then
                 valueByLevel = {}
-                self.valueByInstance[entry] = valueByLevel
+                self.valueByInstance[instance] = valueByLevel
             end
-            local ____valueByLevel_index_19 = valueByLevel[level + 1]
-            if ____valueByLevel_index_19 == nil then
-                ____valueByLevel_index_19 = (defaultValueByLevel or emptyArray())[level + 1]
+            local ____valueByLevel_index_23 = valueByLevel[level + 1]
+            if ____valueByLevel_index_23 == nil then
+                ____valueByLevel_index_23 = (defaultValueByLevel or emptyArray())[level + 1]
             end
-            local ____valueByLevel_index_19_20 = ____valueByLevel_index_19
-            if ____valueByLevel_index_19_20 == nil then
-                ____valueByLevel_index_19_20 = self.defaultValue
+            local ____valueByLevel_index_23_24 = ____valueByLevel_index_23
+            if ____valueByLevel_index_23_24 == nil then
+                ____valueByLevel_index_23_24 = self.defaultValue
             end
-            local previousValue = ____valueByLevel_index_19_20
+            local previousValue = ____valueByLevel_index_23_24
             if value ~= previousValue then
                 valueByLevel[level + 1] = value
                 self:invokeValueChangeEvent(
-                    entry,
+                    instance,
                     self,
                     level,
                     previousValue,
@@ -495,13 +582,13 @@ function ObjectLevelField.prototype.setValue(self, entry, levelOrValue, value)
     if not self:hasNativeFieldValue(objectDataEntryId) then
         return false
     end
-    local previousValue = self:getNativeFieldValue(entry, level)
+    local previousValue = self:getNativeFieldValue(instance, level)
     if value ~= previousValue then
-        if not self:setNativeFieldValue(entry, level, value) then
+        if not self:setNativeFieldValue(instance, level, value) then
             return false
         end
         self:invokeValueChangeEvent(
-            entry,
+            instance,
             self,
             level,
             previousValue,
@@ -510,20 +597,22 @@ function ObjectLevelField.prototype.setValue(self, entry, levelOrValue, value)
     end
     return true
 end
-function ObjectLevelField.prototype.trySetValue(self, entry, levelOrValue, value)
-    if value ~= nil then
-        if __TS__TypeOf(value) ~= __TS__TypeOf(self.defaultValue) then
-            return false
-        end
-        if type(levelOrValue) ~= "number" then
-            return false
+function ObjectLevelField.prototype.calculateActualValue(self, instance, level)
+    local ____opt_27 = self.originalValueByLevelByInstance
+    local ____opt_25 = ____opt_27 and ____opt_27[instance]
+    local originalValue = ____opt_25 and ____opt_25[level]
+    local ____opt_29 = self.modifiersByInstance
+    local modifiers = ____opt_29 and ____opt_29[instance]
+    if originalValue ~= nil then
+        local value = originalValue
+        if modifiers ~= nil then
+            for modifier in pairs(modifiers) do
+                value = modifier(instance, level, value, originalValue)
+            end
         end
-        return self:setValue(entry, levelOrValue, value)
-    end
-    if __TS__TypeOf(levelOrValue) ~= __TS__TypeOf(self.defaultValue) then
-        return false
+        return value
     end
-    return self:setValue(entry, levelOrValue)
+    return self.defaultValue
 end
 function ObjectLevelField.prototype.invokeValueChangeEvent(self, ...)
     self:invokeValueChangeEventRecursive(

package/engine/synchronization.d.ts

@@ -0,0 +1,11 @@
+/** @noSelfInFile */
+import { Player } from "../core/types/player";
+import { Event } from "../event";
+export declare const synchronizer: <T, K extends number>(getSyncId: (object: T) => K, getObject: (syncId: K) => T | undefined) => ((player: Player, object: T | undefined) => Promise<T | undefined>);
+export declare class ObjectBus<T, K extends number> {
+    private readonly getSyncId;
+    readonly event: Event<[Player, T | undefined]>;
+    private readonly syncSlider;
+    constructor(getSyncId: (object: T) => K, getObject: (syncId: K) => T | undefined);
+    send(object: T | undefined): void;
+}

package/engine/synchronization.lua

@@ -0,0 +1,77 @@
+local ____lualib = require("lualib_bundle")
+local __TS__New = ____lualib.__TS__New
+local __TS__Promise = ____lualib.__TS__Promise
+local __TS__Class = ____lualib.__TS__Class
+local ____exports = {}
+local ____player = require("core.types.player")
+local Player = ____player.Player
+local ____math = require("math")
+local MAXIMUM_INTEGER = ____math.MAXIMUM_INTEGER
+local MINIMUM_INTEGER = ____math.MINIMUM_INTEGER
+local ____linked_2Dset = require("utility.linked-set")
+local LinkedSet = ____linked_2Dset.LinkedSet
+local ____event = require("event")
+local Event = ____event.Event
+local eventInvoke = Event.invoke
+local createFrameByType = BlzCreateFrameByType
+local createTrigger = CreateTrigger
+local getOriginFrame = BlzGetOriginFrame
+local getTriggerFrameValue = BlzGetTriggerFrameValue
+local getTriggerPlayer = GetTriggerPlayer
+local frameSetMinMaxValue = BlzFrameSetMinMaxValue
+local frameSetValue = BlzFrameSetValue
+local triggerAddAction = TriggerAddAction
+local triggerRegisterFrameEvent = BlzTriggerRegisterFrameEvent
+____exports.synchronizer = function(getSyncId, getObject)
+    local queue = __TS__New(LinkedSet)
+    local socket = __TS__New(____exports.ObjectBus, getSyncId, getObject)
+    socket.event:addListener(function(_, object)
+        local ____opt_0 = queue:pop()
+        if ____opt_0 ~= nil then
+            ____opt_0(object)
+        end
+    end)
+    local function executor(____, resolve)
+        queue:add(resolve)
+    end
+    return function(player, object)
+        if player.isLocal then
+            socket:send(object)
+        end
+        return __TS__New(__TS__Promise, executor)
+    end
+end
+____exports.ObjectBus = __TS__Class()
+local ObjectBus = ____exports.ObjectBus
+ObjectBus.name = "ObjectBus"
+function ObjectBus.prototype.____constructor(self, getSyncId, getObject)
+    self.getSyncId = getSyncId
+    local syncSlider = createFrameByType(
+        "SLIDER",
+        "Synchronizer",
+        getOriginFrame(ORIGIN_FRAME_WORLD_FRAME, 0),
+        "",
+        0
+    )
+    frameSetMinMaxValue(syncSlider, MINIMUM_INTEGER, MAXIMUM_INTEGER)
+    self.syncSlider = syncSlider
+    local event = __TS__New(Event)
+    local trigger = createTrigger()
+    triggerRegisterFrameEvent(trigger, syncSlider, FRAMEEVENT_SLIDER_VALUE_CHANGED)
+    triggerAddAction(
+        trigger,
+        function()
+            eventInvoke(
+                event,
+                Player:of(getTriggerPlayer()),
+                getObject(getTriggerFrameValue())
+            )
+        end
+    )
+    self.event = event
+end
+function ObjectBus.prototype.send(self, object)
+    local syncId = object ~= nil and self.getSyncId(object) or 0
+    frameSetValue(self.syncSlider, syncId)
+end
+return ____exports

package/engine/text-tag.lua

@@ -36,6 +36,7 @@ local isUnitVisible = IsUnitVisible
 local getUnitFlyHeight = GetUnitFlyHeight
 local getUnitX = GetUnitX
 local getUnitY = GetUnitY
+local unitAlive = UnitAlive
 local DEFAULT_FONT_SIZE = 0.024
 local function applyConfiguration(textTag, configuration)
     setTextTagFadepoint(textTag, configuration.fadepoint)
@@ -333,7 +334,7 @@ Timer.onPeriod[1 / 64]:addListener(function()
             y,
             getUnitFlyHeight(unit) + getTerrainZ(x, y)
         )
-        if isInView and not isUnitHidden(unit) and not isUnitLoaded(unit) and isUnitVisible(unit, PLAYER_LOCAL_HANDLE) then
+        if isInView and not isUnitHidden(unit) and not isUnitLoaded(unit) and isUnitVisible(unit, PLAYER_LOCAL_HANDLE) and unitAlive(unit) then
             setTextTagPosUnit(
                 ensureHandle(textTag),
                 unit,

package/net/socket.lua

@@ -28,13 +28,13 @@ function Socket.prototype.____constructor(self)
     onReceive[self[0]]:addListener(function(sender, data)
         local chunks = chunksByPlayer[sender]
         if chunks ~= nil then
+            chunksByPlayer[sender] = nil
             chunks[#chunks + 1] = data
             Event.invoke(
                 self.onMessage,
                 sender,
                 tableConcat(chunks)
             )
-            chunksByPlayer[sender] = nil
         else
             Event.invoke(self.onMessage, sender, data)
         end

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package",
     "name": "warscript",
-    "version": "0.0.1-dev.cdcfbc9",
+    "version": "0.0.1-dev.ce2be36",
     "description": "A typescript library for Warcraft III using Warpack.",
     "keywords": [
         "warcraft",

package/utility/linked-set.d.ts

@@ -36,6 +36,7 @@ export declare class LinkedSet<T extends AnyNotNil> implements ReadonlyLinkedSet
     copyOf(): LinkedSet<T>;
     first(): T | undefined;
     last(): T | undefined;
+    pop(): T | undefined;
     next(key: T): T | undefined;
     previous(key: T): T | undefined;
     add(key: T): boolean;

package/utility/linked-set.lua

@@ -42,6 +42,23 @@ end
 function LinkedSet.prototype.last(self)
     return self.l
 end
+function LinkedSet.prototype.pop(self)
+    local f = self.f
+    if f == nil then
+        return nil
+    end
+    local n = self.n
+    local next = n[f]
+    n[f] = nil
+    self.f = next
+    if next ~= nil then
+        self.p[next] = nil
+    else
+        self.l = nil
+    end
+    self.s = self.s - 1
+    return f
+end
 function LinkedSet.prototype.next(self, key)
     return self.n[key]
 end
@@ -107,8 +124,9 @@ function LinkedSet.prototype.forEach(self, action, ...)
     local n = self.n
     local c = self.f
     while c ~= nil do
+        local next = n[c]
         action(c, ...)
-        c = n[c]
+        c = next
     end
 end
 function LinkedSet.prototype.toArray(self)