Adds instant integrated circuit execution for event handling circuits. (#61205)

code/modules/wiremod/core/component.dm

@@ -16,6 +16,9 @@
 	/// The name of the component shown on the UI
 	var/display_name = "Generic"
 
+	/// The colour this circuit component appears in the UI
+	var/ui_color = "blue"
+
 	/// The integrated_circuit that this component is attached to.
 	var/obj/item/integrated_circuit/parent
 
@@ -70,6 +73,8 @@
 		trigger_input = add_input_port("Trigger", PORT_TYPE_SIGNAL, order = 2)
 	if(circuit_flags & CIRCUIT_FLAG_OUTPUT_SIGNAL)
 		trigger_output = add_output_port("Triggered", PORT_TYPE_SIGNAL, order = 2)
+	if(circuit_flags & CIRCUIT_FLAG_INSTANT)
+		ui_color = "orange"
 
 
 /obj/item/circuit_component/Destroy()
@@ -184,8 +189,9 @@
  * Return value indicates whether the trigger was successful or not.
  * Arguments:
  * * port - Can be null. The port that sent the input
+ * * return_values - Only defined if the component is receiving an input due to instant execution. Contains the values to be returned once execution has stopped.
  */
-/obj/item/circuit_component/proc/trigger_component(datum/port/input/port)
+/obj/item/circuit_component/proc/trigger_component(datum/port/input/port, list/return_values)
 	SHOULD_NOT_SLEEP(TRUE)
 	pre_input_received(port)
 	if(!should_receive_input(port))
@@ -196,9 +202,9 @@
 		var/proc_to_call = port.trigger
 		if(!proc_to_call)
 			return FALSE
-		result = call(src, proc_to_call)(port)
+		result = call(src, proc_to_call)(port, return_values)
 	else
-		result = input_received()
+		result = input_received(null, return_values)
 
 	if(result)
 		return FALSE
@@ -248,8 +254,9 @@
  * Return value indicates that the circuit should not send an output signal.
  * Arguments:
  * * port - Can be null. The port that sent the input
+ * * return_values - Only defined if the component is receiving an input due to instant execution. Contains the values to be returned once execution has stopped.
  */
-/obj/item/circuit_component/proc/input_received(datum/port/input/port)
+/obj/item/circuit_component/proc/input_received(datum/port/input/port, list/return_values)
 	SHOULD_NOT_SLEEP(TRUE)
 	return
 
@@ -274,6 +281,9 @@
 /obj/item/circuit_component/proc/get_ui_notices()
 	. = list()
 
+	if(circuit_flags & CIRCUIT_FLAG_INSTANT)
+		. += create_ui_notice("Instant Execution", "red", "tachometer-alt")
+
 	if(!removable)
 		. += create_ui_notice("Unremovable", "red", "lock")
 

code/modules/wiremod/core/integrated_circuit.dm

@@ -278,7 +278,7 @@ GLOBAL_LIST_EMPTY_TYPED(integrated_circuits, /obj/item/integrated_circuit)
 				"connected_to" = connected_to,
 				"color" = port.color,
 				"current_data" = current_data,
-				"datatype_data" = port.datatype_ui_data(user),
+				"datatype_data" = port.datatype_ui_data(user)
 			))
 		component_data["output_ports"] = list()
 		for(var/datum/port/output/port as anything in component.output_ports)
@@ -293,6 +293,7 @@ GLOBAL_LIST_EMPTY_TYPED(integrated_circuits, /obj/item/integrated_circuit)
 		component_data["x"] = component.rel_x
 		component_data["y"] = component.rel_y
 		component_data["removable"] = component.removable
+		component_data["color"] = component.ui_color
 		.["components"] += list(component_data)
 
 	.["variables"] = list()

code/modules/wiremod/core/port.dm

@@ -57,12 +57,12 @@
 /**
  * Updates the value of the input and calls input_received on the connected component
  */
-/datum/port/input/proc/set_input(value)
+/datum/port/input/proc/set_input(value, list/return_values)
 	if(QDELETED(src)) //Pain
 		return
 	set_value(value)
 	if(trigger)
-		connected_component.trigger_component(src)
+		connected_component.trigger_component(src, return_values)
 
 /datum/port/output/proc/set_output(value)
 	set_value(value)
@@ -204,7 +204,7 @@
  */
 /datum/port/input/proc/receive_value(datum/port/output/output, value)
 	SIGNAL_HANDLER
-	SScircuit_component.add_callback(CALLBACK(src, .proc/set_input, value))
+	SScircuit_component.add_callback(src, CALLBACK(src, .proc/set_input, value))
 
 /// Signal handler proc to null the input if an atom is deleted. An update is not sent because this was not set by anything.
 /datum/port/proc/null_value(datum/source)

code/modules/wiremod/shell/airlock.dm

@@ -16,7 +16,7 @@
 	. = ..()
 	AddComponent( \
 		/datum/component/shell, \
-		unremovable_circuit_components = list(new /obj/item/circuit_component/airlock), \
+		unremovable_circuit_components = list(new /obj/item/circuit_component/airlock, new /obj/item/circuit_component/airlock_access_event), \
 		capacity = SHELL_CAPACITY_LARGE, \
 		shell_flags = SHELL_FLAG_ALLOW_FAILURE_ACTION \
 	)
@@ -37,7 +37,7 @@
 	display_name = "Airlock"
 	desc = "The general interface with an airlock. Includes general statuses of the airlock"
 
-	/// Called when attack_hand is called on the shell.
+	/// The shell, if it is an airlock.
 	var/obj/machinery/door/airlock/attached_airlock
 
 	/// Bolts the airlock (if possible)
@@ -127,3 +127,65 @@
 		INVOKE_ASYNC(attached_airlock, /obj/machinery/door/airlock.proc/open)
 	if(COMPONENT_TRIGGERED_BY(close, port) && !attached_airlock.density)
 		INVOKE_ASYNC(attached_airlock, /obj/machinery/door/airlock.proc/close)
+
+
+/obj/item/circuit_component/airlock_access_event
+	display_name = "Airlock Access Event"
+	desc = "An event that can be handled through circuit components to determine if the door should open or not for an entity that might be trying to access it."
+	circuit_flags = CIRCUIT_FLAG_INSTANT
+
+	/// The shell, if it is an airlock.
+	var/obj/machinery/door/airlock/attached_airlock
+
+	/// Tells the event to open the airlock.
+	var/datum/port/input/open_airlock
+
+	/// The person trying to open the airlock.
+	var/datum/port/output/accessing_entity
+
+	/// The signal sent when this event is triggered
+	var/datum/port/output/event_triggered
+
+
+/obj/item/circuit_component/airlock_access_event/register_shell(atom/movable/shell)
+	. = ..()
+	if(istype(shell, /obj/machinery/door/airlock))
+		attached_airlock = shell
+		RegisterSignal(shell, COMSIG_OBJ_ALLOWED, .proc/handle_allowed)
+
+/obj/item/circuit_component/airlock_access_event/unregister_shell(atom/movable/shell)
+	attached_airlock = null
+	UnregisterSignal(shell, list(
+		COMSIG_OBJ_ALLOWED,
+	))
+	return ..()
+
+
+/obj/item/circuit_component/airlock_access_event/populate_ports()
+	open_airlock = add_input_port("Should Open Airlock", PORT_TYPE_SIGNAL, trigger = .proc/should_open_airlock)
+	accessing_entity = add_output_port("Accessing Entity", PORT_TYPE_ATOM)
+	event_triggered = add_output_port("Event Triggered", PORT_TYPE_SIGNAL)
+
+
+/obj/item/circuit_component/airlock_access_event/proc/should_open_airlock(datum/port/input/port, list/return_values)
+	CIRCUIT_TRIGGER
+	if(!return_values)
+		return
+	return_values["should_open"] = TRUE
+
+/obj/item/circuit_component/airlock_access_event/proc/handle_allowed(datum/source, mob/accesser)
+	SIGNAL_HANDLER
+	if(!attached_airlock)
+		return
+
+	SScircuit_component.queue_instant_run()
+	accessing_entity.set_output(accesser)
+	event_triggered.set_output(COMPONENT_SIGNAL)
+	var/list/result = SScircuit_component.execute_instant_run()
+
+	if(!result)
+		attached_airlock.visible_message(span_warning("[attached_airlock]'s circuitry overheats!"))
+		return
+
+	if(result["should_open"])
+		return COMPONENT_OBJ_ALLOW