浪語

一種 JavaScript 的方言，因為由浪打所創因而得名。

目前你可以在浪打所作的聊天插件上使用他。

此手冊目前還有 HackMD 線上板手冊中文版（更好的閱讀體驗，但須翻牆）

在 HackMD 上也有 English Manual.

資料型態大概以下這些：

Boolean (true/false)
Number (-1/0/3.14)
String ("hello, lambda!")
Array ([1,2,3,4])
Object ({x: 1.34, y: 4.5})
Function ((a, b) => a + b)

因為這個語言會被 JavaScript 直譯，

所以 JS 裡的物件其實都能在這個語言裡面進行構造、使用。

由於參考到 JS 的 globalThis，所以你也可以直接使用 global 裡面的東西。

console.log("hello world");
alert("it's a alert!");

和 JS 不同的地方在於，浪語裡面所有東西都是 Expression，都一定有回傳值。

這個語言通常不會出現 undefined，取而代之的是，他回傳一個~~空物件 {}~~ false。

分號 (;) 基本上都可以省略，或者你可以使用分號回傳~~一個空物件~~ false。

所有第一次參考到的變數，如果不存在，便會~~以空物件創建~~ 是 false。

print(x)
// not defined, show false (before v1.740 is {}, false after v1.740)

這個語言也可以發 ajax，可以實作一些有趣的功能。

fetch("https://v1.hitokoto.cn")
    .then(response => response.json())
	.then(result => {
	print(result.hitokoto);
});

※ ~~測試姬 /baka yande.re 指令復現~~（nsfw 警告）

event[me,msg](u,m:"^/baka yande.re")=>$.get("https://yande.re/post.json?limit=1&page="+Math.floor(Math.random()*1e4),d=>drrr.dm(u,".",d[0].preview_url))

基本的 +, -, *, / 運算子都有支援，+=, ++, -- 之類的也有，但目前不支援三元運算子。

目前支援 if else 語法，但 switch 沒有支援。

迴圈語法支援 while, for loop, for in, for of，基本上和 JS 一樣，但沒有 do while。

迴圈的小括弧可以省略。

// for(i = 0; i < 10; i++) is also good
for i = 0
    i < 10
    i++
    print(i)
    
j = 0
while(j < 3){
    print(j);
    j++;
}

for(i of [1,2,3,4]) print(i);
for(j in {tom: 1, allen: 2}) print(j);

沒有支援 function 語法，僅支援 arrow function，預設回傳最後一個 expression。

f = (x) =>
  if x <= 0 then 0
  else if x == 1 then 1
  else f(x - 1) + f(x - 2)

[0, 1, 2, 3, 4, 5, 6].map(f)
// => [0,1,1,2,3,5,8]

Scope ({}) 如果被當作參數，或者是 right value 綁定時，會被 lift 成沒有參數的 function。

f = (a, b) => a + b;
print(f(1, 4)) // 5

g = { args[0] + args[1] };
print(g(1, 2)) // 3

跟 js 的 arguments 一樣，在 function 或是 lifted scope 中，浪語的 args 可以拿到參數列。

我提供了一些和 drrr 有關的 function，綁定在 drrr 這個物件中。

drrr.title("設定部屋名稱")

drrr.descr("設定部屋描述")

drrr.print("發送訊息")

drrr.dm("人名", "私訊訊息")

drrr.chown("人名") // 更換房主

drrr.leave() // 離開部屋

drrr.play("關鍵字", "音源", "數字")
// 後兩個參數是選擇性，和插件的 play 一樣。
// 可以綁定以下 event 供使用者調用
event msg (user, msg: "^/play") => {
    word = argfmt(["$[1-]"], user, msg)[0]
    drrr.play(word)
}


drrr.join("房間 ID")

drrr.create("房間名稱", "房間描述", 房間人數:數字, "語系")
// 基本上都有預設參數，所以要傳幾個參數都行

// 還有一些幫你抓好的變數
drrr.loc // 現在位置（大廳或房間 "lounge" / "room"）
drrr.profile // 個人訊息
drrr.room // 房間訊息
drrr.users // 房間成員
drrr.info // 跟個人訊息有點像
drrr.rooms // 所有房間，大廳狀態

// 有時你會需要更新，可以透過以下函數去更新他們
drrr.getLounge(callback);
drrr.getProfile(callback);
drrr.getLoc(callback);

目前浪語裡，除了先前提到的保留字外，還有一些特殊的關鍵字：

- state 宣告一個 state，與 going 搭配使用，有自己的 scope。

但 going 是直接跳去那個地方不會回來。

如果你要回來的話，請使用 visit。

state welcome {
    print("hello world");
    going bye
}

state bye {
    print("bye");
    // done.
}

going welcome

state welcome {
    print("hello world");
    going bye
}

state bye {
    print("bye");
    // because "visit welcome", so back to visit
}

visit welcome
// back from bye
print("done");
// done.

- event 處理相關事件，event 種類和 event action 裡的說明一樣。

// 冒號 (:) 後面是 RegExp，如果匹配才呼叫。
// 適用於 user 和 content （第一和第二個參數）
event msg (user: "lambda", content, url, tripcode, req) => {
    drrr.print(user + " 叫了一下");
}

// 參數個數和名稱都可以任意，看你需求
event join (user) => {
    drrr.print("welcome " + user);
}

- timer 用於定時執行 function。

// 單位是 ms，所以 10000 是十秒
timer 10000 print("hello world"); // print 會被自動 lift 成 function

// 三十秒使用一言換一次部屋描述
timer 30000 fetch("https://v1.hitokoto.cn")
    .then(response => response.json())
    .then(result => {
	drrr.descr(result.hitokoto);
});

// 等價於第一個範例
timer 10000 {
    print("hello world");
}

// parse error, 10000() is not a function call
timer 10000 () => {
    print("hello world");
}

- later 用於延遲執行 function，和 timer 很像，但是只執行一次。

later 10000 print("hello world")
// 注意以下 function 不會被呼叫
f = () => console.log("hello world")
later 3000 f // 不會被呼叫，因為 f 被 auto lift，又被包了一層 function 在外面
later 3000 f() // 這樣才會在三秒後印出 hello world
later 3000 () => console.log("hello world") // parse error, 3000() is not a function call
later 3000; () => console.log("hello world") // works, good
later 3000; (a, b) => console.log("hello world") // fine, too
later 3000 console.log("hello world") // 這個也會正常運作
later 3000 {
    console.log("hello world") // 這個也會正常運作
}

※ 注意 timer 和 later 會將 "非 lambda 的 expression" lift 成一個 lambda expression，然後時間到了再 eval 他。

一些功能實作：

歡迎回來功能：

guests = drrr.users.map((x)=>x.name);
event join (user) => {
  if guests.includes(user)
  then drrr.print("welcome back, " + user)
  else guests.push(user)
}
print(guests)

猜數字遊戲：

valid = (digits) =>
    (new Set(digits.split(""))).size === 4

generate = () => {
    while(!valid(digits = String(Math.floor(1000 + Math.random() * 9000))));
    digits
}

gnjdg = (guess, callback) => {
  if(valid(guess)) then {
    d = theNumber.split("")
    g = guess.split("")
    c = g.map((v)=>d.includes(v)).reduce((a, b)=>a+b)
    a = g.map((v, idx)=>d[idx] === g[idx]).reduce((a, b)=>a+b)
    b  = c - a
    callback(
      if(a === 4) then
        "Your Number is Correct"
      else
        guess + ":" + String(a) + "A" + String(b) + "B"
    )
  } else callback("guess number must be 4 non-repeat digits" + guess);
}

theNumber = generate()
event msg (user, cont: "^\\d\\d\\d\\d$") => gnjdg(cont, drrr.print)
event msg (user, cont: "^new$") => theNumber = generate()
event msg (user, cont: "^ans$") => drrr.print(theNumber)

歡迎貴賓：

// 房間上限 9.0001 人
event join (user) => {
  if drrr.users.length == 10
  then
  	drrr.print("/me恭喜成為 0.0001 人，你終於不做人類了嗎！");
  else
	drrr.print("/me歡迎第 " + String(drrr.users.length) + " 個貴賓！");
}

套件管理器

可以用套件管理導入

也可以 fork 一份 bs-pkgs 維護一個 mirror，

然後透過 add_mirror(alias, repo) 來添加你的 mirror。

或者直接呼叫也行

要刪除的話就呼叫 del_mirror(alias)。

選擇 mirror 後，點選 update 更新套件索引。之後可以選擇分類和套件，可以把他載入到編輯器或是儲存到本地。

本地的套件句選後，可以選擇預載入，或是刪除。重新開啟視窗，如果是有句選，就代表為預載入套件。

確定預載入後，在編輯器以套件名作為函數調用。（套件通常會提供這個函數，但具體還是要看套件內容定義）

浪語

套件管理器

导航菜单