Add .d.ts files and rename C++ functions to not shadow TS counterpart.

Author: microbit-carlos

enums.d.ts

@@ -0,0 +1,41 @@
+// Auto-generated. Do not edit.
+
+
+    /**
+     * (c) 2021, Micro:bit Educational Foundation and contributors
+     *
+     * SPDX-License-Identifier: MIT
+     */
+
+    declare const enum FullPowerSource {
+    //% block="button A"
+    A = 1,  // MICROBIT_ID_BUTTON_A
+    //% block="button B"
+    B = 2,  // MICROBIT_ID_BUTTON_B
+    //% block="pin P0"
+    P0 = 100,  // MICROBIT_ID_IO_P0
+    //% block="pin P1"
+    P1 = 101,  // MICROBIT_ID_IO_P1
+    //% block="pin P2"
+    P2 = 102,  // MICROBIT_ID_IO_P2
+    }
+
+
+    declare const enum LowPowerMode {
+    //% block="continue"
+    Continue = 0,
+    //% block="wait"
+    Wait = 1,
+    }
+
+
+    declare const enum LowPowerEnable {
+    //% block="prevent"
+    Prevent = 0,
+    //% block="allow"
+    Allow = 1,
+    }
+declare namespace power {
+}
+
+// Auto-generated. Do not edit. Really.

power.cpp

@@ -40,9 +40,9 @@ enum class LowPowerMode {
 
 enum class LowPowerEnable {
     //% block="prevent"
-    Prevent,
+    Prevent = 0,
     //% block="allow"
-    Allow
+    Allow = 1
 };
 
 
@@ -55,7 +55,7 @@ namespace power {
 int timerEventValue  = 1;
 #endif // MICROBIT_CODAL
 
-void lowPowerRequest(LowPowerMode mode = LowPowerMode::Continue);
+void _lowPowerRequest(LowPowerMode mode = LowPowerMode::Continue);
 
 /**
   * Request low power when the next idle
@@ -66,7 +66,7 @@ void lowPowerRequest(LowPowerMode mode = LowPowerMode::Continue);
 //% weight=700
 //% block="request low power||and $mode"
 //%
-void lowPowerRequest(LowPowerMode mode) {
+void _lowPowerRequest(LowPowerMode mode) {
 #if MICROBIT_CODAL
     if ( mode == LowPowerMode::Wait)
         uBit.power.deepSleep();
@@ -88,7 +88,7 @@ void lowPowerRequest(LowPowerMode mode) {
 //% interval.shadow=longTimePicker
 //% block="request low power for $interval ms"
 //%
-void lowPowerPause(int interval) {
+void _lowPowerPause(int interval) {
 #if MICROBIT_CODAL
     uBit.power.deepSleep(interval);
 #else
@@ -106,7 +106,7 @@ void lowPowerPause(int interval) {
 //% weight=500
 //% block="low power %enable"
 //%
-void lowPowerEnable(LowPowerEnable enable) {
+void _lowPowerEnable(LowPowerEnable enable) {
 #if MICROBIT_CODAL
     switch ( enable)
     {
@@ -130,7 +130,7 @@ void lowPowerEnable(LowPowerEnable enable) {
 */
 //% help=power/low-power-is-enabled
 //%
-bool lowPowerIsEnabled() {
+bool _lowPowerIsEnabled() {
 #if MICROBIT_CODAL
     return uBit.power.powerDownIsEnabled();
 #else
@@ -152,7 +152,7 @@ bool lowPowerIsEnabled() {
 //% afterOnStart=true
 //% block="full power every $interval ms"
 //%
-void fullPowerEvery(int interval, Action code) {
+void _fullPowerEvery(int interval, Action code) {
 #if MICROBIT_CODAL
     registerWithDal( MICROBIT_ID_MAKECODE_POWER, timerEventValue, code);
     // CODAL_TIMER_EVENT_FLAGS_WAKEUP makes the timer event trigger power up
@@ -171,7 +171,7 @@ void fullPowerEvery(int interval, Action code) {
   */
 //% help=power/full-power-source-enable
 //%
-void fullPowerSourceEnable(FullPowerSource source, bool enable) {
+void _fullPowerSourceEnable(FullPowerSource source, bool enable) {
 #if MICROBIT_CODAL
     switch ( source)
     {
@@ -205,7 +205,7 @@ void fullPowerSourceEnable(FullPowerSource source, bool enable) {
   */
 //% help=power/full-power-source-is-enabled
 //%
-bool fullPowerSourceIsEnabled(FullPowerSource source) {
+bool _fullPowerSourceIsEnabled(FullPowerSource source) {
 #if MICROBIT_CODAL
     switch ( source)
     {
@@ -242,8 +242,8 @@ bool fullPowerSourceIsEnabled(FullPowerSource source) {
 //% weight=900
 //% block="full power on %source"
 //%
-void fullPowerOn(FullPowerSource source) {
-  fullPowerSourceEnable(source, true);
+void _fullPowerOn(FullPowerSource source) {
+  _fullPowerSourceEnable(source, true);
 }
 
 

power.ts

@@ -4,36 +4,6 @@
  * SPDX-License-Identifier: MIT
  */
 
-const enum FullPowerSource {
-    //% block="button A"
-    A = DAL.MICROBIT_ID_BUTTON_A, // 1
-    //% block="button B"
-    B = DAL.MICROBIT_ID_BUTTON_B, // 2
-    //% block="pin P0"
-    P0 = DAL.MICROBIT_ID_IO_P0, // 100
-    //% block="pin P1"
-    P1 = DAL.MICROBIT_ID_IO_P1, // 101
-    //% block="pin P2"
-    P2 = DAL.MICROBIT_ID_IO_P2 // 102
-}
-
-
-const enum LowPowerMode {
-    //% block="continue"
-    Continue = 0,
-    //% block="wait"
-    Wait = 1
-}
-
-
-const enum LowPowerEnable {
-    //% block="prevent"
-    Prevent = 0,
-    //% block="allow"
-    Allow = 1
-}
-
-
 //% block="Power"
 //% icon="\uf011"
 //% color=#AA278D
@@ -48,7 +18,7 @@ namespace power {
 //% weight=700
 //% block="request low power||and $mode"
 //% parts="v2"
-//% shim=power::lowPowerRequest
+//% shim=power::_lowPowerRequest
 export function lowPowerRequest(mode?: LowPowerMode): void {
     basic.pause(0)
 }
@@ -63,7 +33,7 @@ export function lowPowerRequest(mode?: LowPowerMode): void {
 //% interval.shadow=longTimePicker
 //% block="request low power for $interval ms"
 //% parts="v2"
-//% shim=power::lowPowerPause
+//% shim=power::_lowPowerPause
 export function lowPowerPause(interval: number): void {
     basic.pause(interval)
 }
@@ -77,7 +47,7 @@ export function lowPowerPause(interval: number): void {
 //% weight=500
 //% block="low power %enable"
 //% parts="v2"
-//% shim=power::lowPowerEnable
+//% shim=power::_lowPowerEnable
 export function lowPowerEnable(enable: LowPowerEnable): void {
     return
 }
@@ -86,7 +56,7 @@ export function lowPowerEnable(enable: LowPowerEnable): void {
     * Determine if low power is enabled
     */
 //% help=power/low-power-is-enabled
-//% shim=power::lowPowerIsEnabled
+//% shim=power::_lowPowerIsEnabled
 export function lowPowerIsEnabled(): boolean {
     return false
 }
@@ -104,7 +74,7 @@ export function lowPowerIsEnabled(): boolean {
 //% afterOnStart=true
 //% block="full power every $interval ms"
 //% parts="v2"
-//% shim=power::fullPowerEvery
+//% shim=power::_fullPowerEvery
 export function fullPowerEvery(interval: number, code: () => void): void {
     loops.everyInterval(interval, code)
 }
@@ -115,7 +85,7 @@ export function fullPowerEvery(interval: number, code: () => void): void {
     * @param enable true to trigger full power
     */
 //% help=power/full-power-source-enable
-//% shim=power::fullPowerSourceEnable
+//% shim=power::_fullPowerSourceEnable
 export function fullPowerSourceEnable(source: FullPowerSource, enable: boolean): void {
     return
 }
@@ -126,7 +96,7 @@ export function fullPowerSourceEnable(source: FullPowerSource, enable: boolean):
     * @return true if the source will trigger full power
     */
 //% help=power/full-power-source-is-enabled
-//% shim=power::fullPowerSourceIsEnabled
+//% shim=power::_fullPowerSourceIsEnabled
 export function fullPowerSourceIsEnabled(source: FullPowerSource): boolean {
     return false
 }
@@ -140,7 +110,7 @@ export function fullPowerSourceIsEnabled(source: FullPowerSource): boolean {
 //% weight=900
 //% block="full power on %source"
 //% parts="v2"
-//% shim=power::fullPowerOn
+//% shim=power::_fullPowerOn
 export function fullPowerOn(source: FullPowerSource): void {
     return
 }

pxt.json

@@ -8,6 +8,8 @@
     "files": [
         "power.cpp",
         "power.ts",
+        "shims.d.ts",
+        "enums.d.ts",
         "README.md",
         "basic-sleep-wake.md"
     ],

shims.d.ts

@@ -0,0 +1,96 @@
+// Auto-generated. Do not edit.
+
+
+
+    //% block="Power"
+    //% icon="\uf011"
+    //% color=#AA278D
+declare namespace power {
+
+    /**
+     * Request low power when the next idle
+     * @param mode If Continue, then return immediately; if Wait, then pause until a power-up event occurs 
+     */
+    //% help=power/low-power-request
+    //% group="micro:bit (V2)"
+    //% weight=700
+    //% block="request low power||and $mode"
+    //% shim=power::_lowPowerRequest
+    function _lowPowerRequest(mode: LowPowerMode): void;
+
+    /**
+     * Pause for a fixed interval, and request low power when idle.
+     * @param interval The period of time to pause, in milliseconds.
+     */
+    //% help=power/low-power-for
+    //% group="micro:bit (V2)"
+    //% weight=600
+    //% interval.shadow=longTimePicker
+    //% block="request low power for $interval ms"
+    //% shim=power::_lowPowerPause
+    function _lowPowerPause(interval: int32): void;
+
+    /**
+     * Prevent or allow low power.
+     * Prevent and allow requests should occur in pairs.
+     * The default is to allow.
+     */
+    //% help=power/low-power-enable
+    //% weight=500
+    //% block="low power %enable"
+    //% shim=power::_lowPowerEnable
+    function _lowPowerEnable(enable: LowPowerEnable): void;
+
+    /**
+     * Determine if low power is enabled
+     */
+    //% help=power/low-power-is-enabled
+    //% shim=power::_lowPowerIsEnabled
+    function _lowPowerIsEnabled(): boolean;
+
+    /**
+     * Do something repeatedy with full power using a timer.
+     * @param interval the time (in ms) for the timer.
+     * @param code the code to execute
+     */
+    //% help=power/full-power-every
+    //% group="micro:bit (V2)"
+    //% weight=800
+    //% blockAllowMultiple=1
+    //% interval.shadow=longTimePicker
+    //% afterOnStart=true
+    //% block="full power every $interval ms"
+    //% shim=power::_fullPowerEvery
+    function _fullPowerEvery(interval: int32, code: () => void): void;
+
+    /**
+     * Set whether the source should trigger full power.
+     * @param source the source to set
+     * @param enable true to trigger full power
+     */
+    //% help=power/full-power-source-enable
+    //% shim=power::_fullPowerSourceEnable
+    function _fullPowerSourceEnable(source: FullPowerSource, enable: boolean): void;
+
+    /**
+     * Determine if the source will trigger full power.
+     * @param source the source to check
+     * @return true if the source will trigger full power
+     */
+    //% help=power/full-power-source-is-enabled
+    //% shim=power::_fullPowerSourceIsEnabled
+    function _fullPowerSourceIsEnabled(source: FullPowerSource): boolean;
+
+    /**
+     * Set the source to trigger full power.
+     * @param source the source to set
+     */
+    //% help=power/full-power-on
+    //% group="micro:bit (V2)"
+    //% weight=900
+    //% block="full power on %source"
+    //% shim=power::_fullPowerOn
+    function _fullPowerOn(source: FullPowerSource): void;
+}
+
+// Auto-generated. Do not edit. Really.