From ef7940cd60220a111e2ace8fe9917fffa37a19d9 Mon Sep 17 00:00:00 2001
From: rhunk <101876869+rhunk@users.noreply.github.com>
Date: Tue, 3 Oct 2023 00:37:19 +0200
Subject: [PATCH] add toasts & interface builder

---
 SCRIPTING.md | 125 +++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 102 insertions(+), 23 deletions(-)

diff --git a/SCRIPTING.md b/SCRIPTING.md
index 5c70009..f99336e 100644
--- a/SCRIPTING.md
+++ b/SCRIPTING.md
@@ -24,6 +24,10 @@ type("java.lang.System").out.println("Hello!") // prints "Hello!"
 ```js
 logInfo(findClass("java.lang.System")) // prints "class java.lang.System"
 ```
+- **longToast**/**shortToast**(message: String) show a toast on the screen
+```js
+longToast("Hello!")
+```
 
 
 ## Execution sides
@@ -105,35 +109,35 @@ eventC called from script3.js => hello
 - enum HookStage is a string value of "before" or "after"
 
 - class HookCallback : 
-	- properties
-		- getter/setter result: Object
-		- getter thisObject: Object
-		- getter method: JavaMember
-		- getter args: ObjectArray
-	- functions
-		- cancel()
-		- arg(index: Integer)
-		- setArg(index: Integer, value: Object)
-		- invokeOriginal()
-		- invokeOriginal(args: ObjectArray)
-		
+  - properties
+    - getter/setter result: Object
+    - getter thisObject: Object
+    - getter method: JavaMember
+    - getter args: ObjectArray
+  - functions
+    - cancel()
+    - arg(index: Integer)
+    - setArg(index: Integer, value: Object)
+    - invokeOriginal()
+    - invokeOriginal(args: ObjectArray)
+    
 - function HookUnhook unhooks hooked members
 
 ### public interface
 - Find members
-	- findMethod (class: JavaClass, methodName: String) => Member
-	- findMethod (className: String, methodName: String) => Member
-	- findMethodWithParameters (class: JavaClass, methodName: String, types: StringArray) => Member
-	- findMethodWithParameters (className: String, methodName: String, types: StringArray) => Member
-	- findConstructor (class: JavaClass, types: StringArray) => Member
-	- findConstructor (className: String, types: StringArray) => Member
+  - findMethod (class: JavaClass, methodName: String) => Member
+  - findMethod (className: String, methodName: String) => Member
+  - findMethodWithParameters (class: JavaClass, methodName: String, types: StringArray) => Member
+  - findMethodWithParameters (className: String, methodName: String, types: StringArray) => Member
+  - findConstructor (class: JavaClass, types: StringArray) => Member
+  - findConstructor (className: String, types: StringArray) => Member
 
 - Hook members
-	- hook (member: JavaMember, stage: HookStage, callback: HookCallback) => HookUnhook
-	- hookAllMethods (class: JavaClass, methodName: String, stage: HookStage, callback: HookCallback) => HookUnhook
-	- hookAllMethods (className: String, methodName: String, stage: HookStage, callback: HookCallback) => HookUnhook
-	- hookAllConstructors (class: JavaClass, stage: HookStage, callback: HookCallback) => HookUnhook
-	- hookAllConstructors (className: String, stage: HookStage, callback: HookCallback) => HookUnhook
+  - hook (member: JavaMember, stage: HookStage, callback: HookCallback) => HookUnhook
+  - hookAllMethods (class: JavaClass, methodName: String, stage: HookStage, callback: HookCallback) => HookUnhook
+  - hookAllMethods (className: String, methodName: String, stage: HookStage, callback: HookCallback) => HookUnhook
+  - hookAllConstructors (class: JavaClass, stage: HookStage, callback: HookCallback) => HookUnhook
+  - hookAllConstructors (className: String, stage: HookStage, callback: HookCallback) => HookUnhook
 
 ### Example
 ```js
@@ -154,3 +158,78 @@ module.onSnapActivity = () => {
   hookerUnhook();
 }
 ```
+
+## Interface builder
+Allows to build dynamic interface in the manager
+Create a menu:
+```js
+im.create("settings", builder => {
+  builder.text("Hello world!")
+}
+```
+
+### Node
+- setAttribute(key: String, value: Object) -> Node : set a custom attribute of the node
+- padding(value: Integer) -> Node : set the padding of the node
+- color(value: Integer) -> Node : set the color of the node
+- fontSize(value: Integer) -> Node : set the font size of the node
+- label(value: String) -> Node : set the label of the node
+
+### enum Arrangement
+  start
+  end
+  top
+  bottom
+  center
+  spaceBetween
+  spaceAround
+  spaceEvenly
+
+### enum Alignment
+  start
+  end
+  top
+  bottom
+  centerVertically
+  centerHorizontally
+
+### RowColumnNode
+- arrangement(value: Arrangement) -> RowColumnNode : set the arrangement of the node
+- alignment(value: Alignment) -> RowColumnNode : set the alignment of the node
+- spacedBy(value: Integer) -> RowColumnNode : set the spacing of the child nodes
+
+
+### Builder functions: 
+  - row(builderCallback) -> RowColumnNode: create a row	
+  - column(builderCallback) -> RowColumnNode: create a column
+  - text(content: String) -> Node : create a text view
+  - switch(state: Boolean?, callback: (Boolean) -> Void) -> Node : create a switch node
+  - button(label: String, callback: () -> Void) : create a button
+  - slider(min: Int, max: Int, step: Int, value: Int, callback: (Integer) -> Void): create a integer slider
+  - onLaunched(callback) : Trigger callback when the menu appear on the screen
+
+Example: 
+```js
+im.create("settings", builder => {
+  builder.text("My Title").padding(10).color(0xff000000).fontSize(20)
+  
+  builder.row(builder => {
+    var textView = builder.text("myValue : unknown")
+    builder.slider(0, 100, 50, 1, value => {
+      // set the textview value
+      textView.label("myValue : " + value)
+    })
+  }).spacedBy(10)
+  
+  builder.row(builder => {
+    var mySwitchText = builder.text("mySwitch: unknown")
+    builder.switch(false, value => {
+      mySwitchText.label("mySwitch: " + switchValue)
+    })
+  }).arrangement("spaceBetween").alignment("centerVertically")
+  
+  builder.onLaunched(() => {
+    longToast("menu shown!")
+  })
+}
+```