JS: Backport³ and more additions & fixes (#3961)

* JS: Fix file select for fbt launch js_app
* JS: badusb: Add numpad keys
  Co-authored-by: oldip <oldip@users.noreply.github.com>
* JS: badusb: Layout support
* JS: badusb: altPrint() and altPrintln()
  Co-authored-by: oldip <oldip@users.noreply.github.com>
* JS: badusb: quit()
* JS: serial: readAny()
* JS: serial: end()
* JS: serial: Auto disable expansion service
* JS: storage: Add example script
* JS: gui: text_input: Fix NULL ptr when no prop given
* JS: gui: text_input: Default text props
  Co-authored-by: xMasterX <xMasterX@users.noreply.github.com>
* JS: gui: byte_input
  Co-authored-by: xMasterX <xMasterX@users.noreply.github.com>
* JS: gui: file_picker
* JS: gui: viewDispatcher.currentView
* JS: gui: view.hasProperty()
* JS: gui: Add some missing typedefs comments
* JS: globals: Fix toString() with negative numbers
* JS: globals: parseInt()
  Co-authored-by: Spooks4576 <Spooks4576@users.noreply.github.com>
* JS: globals: toUpperCase() and toLowerCase()
  Co-authored-by: Spooks4576 <Spooks4576@users.noreply.github.com>
* JS: globals: Add some missing typedefs
* JS: Add example for string functions
  Co-authored-by: Spooks4576 <Spooks4576@users.noreply.github.com>
* JS: globals: __dirpath and __filepath
  Co-authored-by: jamisonderek <jamisonderek@users.noreply.github.com>
* JS: globals: load() typedef missing scope param
* JS: Add interactive REPL script example
* JS: Add missing icon for file picker
* JS: Rename to __filename and __dirname
* JS: Move toUpperCase() and toLowerCase() to string class
* JS: parseInt() refactor
* JS: Typedef base param for parseInt()
* Revert "JS: gui: view.hasProperty()"
  This reverts commit 1967ec06d4f2e9cafc4e18384ad370f7a7c44468.
* JS: Move toString() to Number class
* JS: Fix duplicate plugin files
  in plugins, `requires` is used to determine which app to distribute the .fal under `apps_data/appid/plugins`
* JS: math: Missing typedefs, use camelCase
* JS: badusb: layoutPath is optional in typedef
* Fix ASS scoping
* Rename mjs term prop type value
* Change load() description
* Enlarge buffers in default prop assign
* More checks for default data/text size
* Make PVS happy
* Fix icon symbol
* Update types for JS SDK
* toString() was moved to number class

Co-authored-by: oldip <oldip@users.noreply.github.com>
Co-authored-by: xMasterX <xMasterX@users.noreply.github.com>
Co-authored-by: Spooks4576 <Spooks4576@users.noreply.github.com>
Co-authored-by: jamisonderek <jamisonderek@users.noreply.github.com>
Co-authored-by: hedger <hedger@users.noreply.github.com>
Co-authored-by: あく <alleteam@gmail.com>

applications/system/js_app/packages/fz-sdk/badusb/index.d.ts

@@ -16,6 +16,9 @@ export type MainKey =
     "F11" | "F12" | "F13" | "F14" | "F15" | "F16" | "F17" | "F18" | "F19" |
     "F20" | "F21" | "F22" | "F23" | "F24" |
 
+    "NUM0" | "NUM1" | "NUM2" | "NUM3" | "NUM4" | "NUM5" | "NUM6" | "NUM7" |
+    "NUM8" | "NUM9" |
+
     "\n" | " " | "!" | "\"" | "#" | "$" | "%" | "&" | "'" | "(" | ")" | "*" |
     "+" | "," | "-" | "." | "/" | ":" | ";" | "<" | ">" | "=" | "?" | "@" | "[" |
     "]" | "\\" | "^" | "_" | "`" | "{" | "}" | "|" | "~" |
@@ -38,7 +41,7 @@ export type KeyCode = MainKey | ModifierKey | number;
  * @param settings USB device settings. Omit to select default parameters
  * @version Added in JS SDK 0.1
  */
-export declare function setup(settings?: { vid: number, pid: number, mfrName?: string, prodName?: string }): void;
+export declare function setup(settings?: { vid: number, pid: number, mfrName?: string, prodName?: string, layoutPath?: string }): void;
 
 /**
  * @brief Tells whether the virtual USB HID device has successfully connected
@@ -89,3 +92,26 @@ export declare function print(string: string, delay?: number): void;
  * @version Added in JS SDK 0.1
  */
 export declare function println(string: string, delay?: number): void;
+
+/**
+ * @brief Prints a string by Alt+Numpad method - works only on Windows!
+ * @param string The string to print
+ * @param delay How many milliseconds to wait between key presses
+ * @version Added in JS SDK 0.1
+ */
+export declare function altPrint(string: string, delay?: number): void;
+
+/**
+ * @brief Prints a string by Alt+Numpad method - works only on Windows!
+ *        Presses "Enter" after printing the string
+ * @param string The string to print
+ * @param delay How many milliseconds to wait between key presses
+ * @version Added in JS SDK 0.1
+ */
+export declare function altPrintln(string: string, delay?: number): void;
+
+/**
+ * @brief Releases usb, optional, but allows to switch usb profile
+ * @version Added in JS SDK 0.1
+ */
+export declare function quit(): void;

applications/system/js_app/packages/fz-sdk/global.d.ts

@@ -149,14 +149,6 @@ declare function delay(ms: number): void;
  */
 declare function print(...args: any[]): void;
 
-/**
- * @brief Converts a number to a string
- * @param value The number to convert to a string
- * @param base Integer base (`2`...`16`), default: 10
- * @version Added in JS SDK 0.1
- */
-declare function toString(value: number, base?: number): string;
-
 /**
  * @brief Reads a JS value from a file
  * 
@@ -327,13 +319,44 @@ declare class String {
      * @version Added in JS SDK 0.1
      */
     at(index: number): number;
+    /**
+     * @brief Return index of first occurrence of substr within the string or `-1` if not found
+     * @param substr The string to search for
+     * @param fromIndex The index to start searching from
+     * @version Added in JS SDK 0.1
+     */
+    indexOf(substr: string, fromIndex?: number): number;
+    /**
+     * @brief Return a substring between two indices
+     * @param start The index to start substring at
+     * @param end The index to end substring at
+     * @version Added in JS SDK 0.1
+     */
+    slice(start: number, end?: number): string;
+    /**
+     * @brief Return this string transformed to upper case
+     * @version Added in JS SDK 0.1
+     */
+    toUpperCase(): string;
+    /**
+     * @brief Return this string transformed to lower case
+     * @version Added in JS SDK 0.1
+     */
+    toLowerCase(): string;
 }
 
 declare class Boolean { }
 
 declare class Function { }
 
-declare class Number { }
+declare class Number {
+    /**
+     * @brief Converts this number to a string
+     * @param base Integer base (`2`...`16`), default: 10
+     * @version Added in JS SDK 0.1
+     */
+    toString(base?: number): string;
+}
 
 declare class Object { }
 

applications/system/js_app/packages/fz-sdk/gui/byte_input.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Displays a byte input keyboard.
+ * 
+ * <img src="../images/byte_input.png" width="200" alt="Sample screenshot of the view" />
+ * 
+ * ```js
+ * let eventLoop = require("event_loop");
+ * let gui = require("gui");
+ * let byteInputView = require("gui/byte_input");
+ * ```
+ * 
+ * This module depends on the `gui` module, which in turn depends on the
+ * `event_loop` module, so they _must_ be imported in this order. It is also
+ * recommended to conceptualize these modules first before using this one.
+ * 
+ * # Example
+ * For an example refer to the `gui.js` example script.
+ * 
+ * # View props
+ *   - `header`: Text displayed at the top of the screen
+ *   - `length`: Length of data to edit
+ *   - `defaultData`: Data to show by default
+ * 
+ * @version Added in JS SDK 0.1
+ * @module
+ */
+
+import type { View, ViewFactory } from ".";
+import type { Contract } from "../event_loop";
+
+type Props = {
+    header: string,
+    length: number,
+    defaultData: Uint8Array | ArrayBuffer,
+}
+declare class ByteInput extends View<Props> {
+    input: Contract<string>;
+}
+declare class ByteInputFactory extends ViewFactory<Props, ByteInput> { }
+declare const factory: ByteInputFactory;
+export = factory;

applications/system/js_app/packages/fz-sdk/gui/file_picker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @brief Displays a file picker and returns the selected file, or undefined if cancelled
+ * @param basePath The path to start at
+ * @param extension The file extension(s) to show (like `.sub`, `.iso|.img`, `*`)
+ * @version Added in JS SDK 0.1
+ */
+export declare function pickFile(basePath: string, extension: string): string | undefined;

applications/system/js_app/packages/fz-sdk/gui/text_input.d.ts

@@ -1,5 +1,5 @@
 /**
- * Displays a keyboard.
+ * Displays a text input keyboard.
  * 
  * <img src="../images/text_input.png" width="200" alt="Sample screenshot of the view" />
  * 
@@ -20,6 +20,8 @@
  *   - `header`: Text displayed at the top of the screen
  *   - `minLength`: Minimum allowed text length
  *   - `maxLength`: Maximum allowed text length
+ *   - `defaultText`: Text to show by default
+ *   - `defaultTextClear`: Whether to clear the default text on next character typed
  * 
  * @version Added in JS SDK 0.1
  * @module
@@ -32,6 +34,8 @@ type Props = {
     header: string,
     minLength: number,
     maxLength: number,
+    defaultText: string,
+    defaultTextClear: boolean,
 }
 declare class TextInput extends View<Props> {
     input: Contract<string>;

applications/system/js_app/packages/fz-sdk/math/index.d.ts

@@ -4,6 +4,8 @@
  * @module
  */
 
+/** @version Added in JS SDK 0.1 */
+export function isEqual(a: number, b: number, tolerance: number): boolean;
 /** @version Added in JS SDK 0.1 */
 export function abs(n: number): number;
 /** @version Added in JS SDK 0.1 */
@@ -33,6 +35,8 @@ export function exp(n: number): number;
 /** @version Added in JS SDK 0.1 */
 export function floor(n: number): number;
 /** @version Added in JS SDK 0.1 */
+export function log(n: number): number;
+/** @version Added in JS SDK 0.1 */
 export function max(n: number, m: number): number;
 /** @version Added in JS SDK 0.1 */
 export function min(n: number, m: number): number;
@@ -51,4 +55,6 @@ export function trunc(n: number): number;
 /** @version Added in JS SDK 0.1 */
 declare const PI: number;
 /** @version Added in JS SDK 0.1 */
+declare const E: number;
+/** @version Added in JS SDK 0.1 */
 declare const EPSILON: number;

applications/system/js_app/packages/fz-sdk/serial/index.d.ts

@@ -6,6 +6,9 @@
 
 /**
  * @brief Initializes the serial port
+ * 
+ * Automatically disables Expansion module service to prevent interference.
+ * 
  * @param port The port to initialize (`"lpuart"` or `"start"`)
  * @param baudRate 
  * @version Added in JS SDK 0.1
@@ -52,6 +55,20 @@ export declare function read(length: number, timeout?: number): string | undefin
  */
 export declare function readln(timeout?: number): string;
 
+/**
+ * @brief Read any available amount of data from the serial port
+ * 
+ * Can be useful to avoid starving your loop with small reads.
+ * 
+ * @param timeout The number of time, in milliseconds, after which this function
+ *                will give up and return nothing. If unset, the function will
+ *                wait forever.
+ * @returns The received data interpreted as ASCII, or `undefined` if 0 bytes
+ *          were read.
+ * @version Added in JS SDK 0.1
+ */
+export declare function readAny(timeout?: number): string | undefined;
+
 /**
  * @brief Reads data from the serial port
  * @param length The number of bytes to read
@@ -87,3 +104,9 @@ export declare function readBytes(length: number, timeout?: number): ArrayBuffer
  * @version Added in JS SDK 0.1
  */
 export declare function expect(patterns: string | number[] | string[] | number[][], timeout?: number): number | undefined;
+
+/**
+ * @brief Deinitializes the serial port, allowing multiple initializations per script run
+ * @version Added in JS SDK 0.1
+ */
+export declare function end(): void;