Support block order for buttons (#107)

* add order to button args for keepButton

* 1.6.13

docs/060-alternative-methods.md

@@ -50,7 +50,7 @@ The caption of the button is also available in the SmartBlock workflow under the
 
 ## Predefined Variables
 
-There are currently 3 predefined variables: `RemoveButton`, `Clear`, and `Sibling`.
+There are currently 5 predefined variables: `RemoveButton`, `Order`, `TargetRef`, `Clear`, and `Sibling`.
 
 ### Remove Button
 
@@ -60,6 +60,26 @@ By default, SmartBlock buttons are removed and the workflow will replace it with
 
 - `{{caption:SmartBlock:workflow name:RemoveButton=false}}`
 
+### Order
+
+When using `RemoveButton` is set to `false`, you can set the `Order` in which to insert the SmartBlock.
+
+Default is 0. (which is first)
+Use `last` to target the last block.
+
+**Example**
+
+- `{{caption:SmartBlock:workflow name:RemoveButton=false,Order=last}}`
+-
+
+### Target Ref
+
+When using `RemoveButton` is set to `false`, you can set the UID of the block in which to run the SmartBlock on via `TargetRef`.
+
+**Example**
+
+- `{{caption:SmartBlock:workflow name:RemoveButton=false,TargetRef=((kZrX4zMQq))}}`
+
 ### Clear
 
 By default, SmartBlock buttons will leave the text as is (of the block the button is running in). If you would like the text of the block cleared, set `Clear` to `true`

package.json

@@ -1,6 +1,6 @@
 {
   "name": "smartblocks",
-  "version": "1.6.12",
+  "version": "1.6.13",
   "description": "Create custom and programmable templates from within Roam!",
   "main": "./build/main.js",
   "scripts": {

src/index.ts

@@ -598,6 +598,14 @@ export default runExtension(async ({ extensionAPI }) => {
           const clearBlock = /true/i.test(variables["Clear"]);
           const applyToSibling = variables["Sibling"];
           const explicitTargetUid = extractRef(variables["TargetRef"]);
+          const order =
+            variables["Order"] === "last"
+              ? "last"
+              : !variables["Order"]
+              ? 0
+              : !isNaN(Number(variables["Order"]))
+              ? Number(variables["Order"])
+              : 0;
 
           const props = {
             srcUid,
@@ -672,6 +680,7 @@ export default runExtension(async ({ extensionAPI }) => {
               : createBlock({
                   node: { text: "" },
                   parentUid,
+                  order,
                 }).then((targetUid) =>
                   sbBomb({
                     ...props,