Add was_touched

I think the docs PRs are missing get_touches too but will revisit that.

lang/en/typeshed/stdlib/microbit/__init__.pyi

@@ -278,24 +278,19 @@ class MicroBitTouchPin(MicroBitAnalogDigitalPin):
 
         Example: ``pin0.is_touched()``
 
-        The default touch mode for the pins on the edge connector is ``resistive``.
-        The default for the logo pin **V2** is ``capacitive``.
+        :return: ``True`` if the pin is being touched with a finger, otherwise return ``False``.
+        """
+        ...
 
-        **Resistive touch**
-        This test is done by measuring how much resistance there is between the
-        pin and ground.  A low resistance gives a reading of ``True``.  To get
-        a reliable reading using a finger you may need to touch the ground pin
-        with another part of your body, for example your other hand.
+    def was_touched(self) -> bool:
+        """Check if the pin was touched since the last time this method was called.
 
-        **Capacitive touch**
-        This test is done by interacting with the electric field of a capacitor
-        using a finger as a conductor. `Capacitive touch
-        <https://www.allaboutcircuits.com/technical-articles/introduction-to-capacitive-touch-sensing>`_
-        does not require you to make a ground connection as part of a circuit.
+        Example: ``pin0.was_touched()``
 
-        :return: ``True`` if the pin is being touched with a finger, otherwise return ``False``.
+        :return: ``True`` or ``False`` to indicate if the pin was touched since the device started or since the last time this method was called.
         """
         ...
+
     def set_touch_mode(self, value: int) -> None:
         """Set the touch mode for the pin.
 
@@ -304,6 +299,18 @@ class MicroBitTouchPin(MicroBitAnalogDigitalPin):
         The default touch mode for the pins on the edge connector is
         ``resistive``. The default for the logo pin **V2** is ``capacitive``.
 
+        **Resistive touch**
+        This test is done by measuring how much resistance there is between the
+        pin and ground.  A low resistance gives a reading of ``True``.  To get
+        a reliable reading using a finger you may need to touch the ground pin
+        with another part of your body, for example your other hand.
+
+        **Capacitive touch**
+        This test is done by interacting with the electric field of a capacitor
+        using a finger as a conductor. `Capacitive touch
+        <https://www.allaboutcircuits.com/technical-articles/introduction-to-capacitive-touch-sensing>`_
+        does not require you to make a ground connection as part of a circuit.
+
         :param value: ``CAPACITIVE`` or ``RESISTIVE`` from the relevant pin.
         """
         ...