plainscript-lang 0.1.7-rc → 1.0.0-beta

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -679,7 +679,7 @@ var LIBRARY = [
679
679
  {cat:"variables",name:"Declare Variable",desc:"Store a value in a named variable",ps:'remember name as "Ayokunle"\nremember age as 25\nremember pi as 3.14',js:'let name = "Ayokunle";\nlet age = 25;\nlet pi = 3.14;'},
680
680
  {cat:"variables",name:"Reassign Variable",desc:"Change the value of an existing variable",ps:'remember count as 0\ncount becomes 10',js:'let count = 0;\ncount = 10;'},
681
681
  {cat:"variables",name:"Type Coercion",desc:"Convert values between types",ps:'remember num as number("42")\nremember str as text(100)',js:'let num = Number("42");\nlet str = String(100);'},
682
- {cat:"strings",name:"String Literals",desc:"Create string values with double or single quotes",ps:'remember greeting as "Hello, World!"\nremember name as \'Ayokunle\'',js:'let greeting = "Hello, World!";\nlet name = \'Ayokunle\';'},
682
+ {cat:"strings",name:"String Literals",desc:"Create string values with double quotes or backticks",ps:'remember greeting as "Hello, World!"\nremember name as "Ayokunle"',js:'let greeting = "Hello, World!";\nlet name = "Ayokunle";'},
683
683
  {cat:"strings",name:"String Interpolation",desc:"Embed variables inside template literals",ps:'remember name as "Ayokunle"\nshow `Hello ${name}!`',js:'let name = "Ayokunle";\nconsole.log(`Hello ${name}!`);'},
684
684
  {cat:"strings",name:"Uppercase / Lowercase",desc:"Change the case of a string",ps:'show uppercase("hello")\nshow lowercase("WORLD")',js:'console.log("hello".toUpperCase());\nconsole.log("WORLD".toLowerCase());'},
685
685
  {cat:"strings",name:"String Length",desc:"Get the number of characters in a string",ps:'remember len as length("abc")\nshow len',js:'let len = "abc".length;\nconsole.log(len);'},
@@ -695,7 +695,7 @@ var LIBRARY = [
695
695
  {cat:"booleans",name:"Range Checks",desc:"Check if a value is between, at least, or at most",ps:'remember age as 25\nif age between 18 and 65\n show "working age"\ndone\n\nif age is at least 18\n show "adult"\ndone',js:'let age = 25;\nif (age >= 18 && age <= 65) {\n console.log("working age");\n}\n\nif (age >= 18) {\n console.log("adult");\n}'},
696
696
  {cat:"booleans",name:"String Checks",desc:"Check if a string contains, starts with, or ends with",ps:'remember msg as "Hello World"\nif msg contains "World"\n show "found"\ndone\n\nif msg starts with "Hello"\n show "greeting"\ndone\n\nif msg ends with "World"\n show "ending"\ndone',js:'let msg = "Hello World";\nif (msg.includes("World")) {\n console.log("found");\n}\n\nif (msg.startsWith("Hello")) {\n console.log("greeting");\n}\n\nif (msg.endsWith("World")) {\n console.log("ending");\n}'},
697
697
  {cat:"booleans",name:"Empty Checks",desc:"Check if a value is empty or not empty",ps:'remember items as []\nif items is empty\n show "no items"\ndone\n\nif items is not empty\n show "has items"\ndone',js:'let items = [];\nif (items.length === 0) {\n console.log("no items");\n}\n\nif (items.length > 0) {\n console.log("has items");\n}'},
698
- {cat:"booleans",name:"Logical Operators",desc:"Combine conditions with and, or, not",ps:'remember age as 25\nremember name as "Ayo"\n\nif age is 25 and name is "Ayo"\n show "match"\ndone\n\nif age is 10 or age is 25\n show "found"\ndone\n\nif not (age is empty)\n show "has value"\ndone',js:'let age = 25;\nlet name = "Ayo";\n\nif (age === 25 && name === "Ayo") {\n console.log("match");\n}\n\nif (age === 10 || age === 25) {\n console.log("found");\n}\n\nif (!(age.length === 0)) {\n console.log("has value");\n}'},
698
+ {cat:"booleans",name:"Logical Operators",desc:"Combine conditions with and, or, not",ps:'remember age as 25\nremember name as "Ayo"\n\nif age is 25 and name is "Ayo"\n show "match"\ndone\n\nif age is 10 or age is 25\n show "found"\ndone\n\nif age is not empty\n show "has value"\ndone',js:'let age = 25;\nlet name = "Ayo";\n\nif (age === 25 && name === "Ayo") {\n console.log("match");\n}\n\nif (age === 10 || age === 25) {\n console.log("found");\n}\n\nif (!(age.length === 0)) {\n console.log("has value");\n}'},
699
699
  {cat:"conditionals",name:"If / Otherwise",desc:"Branch logic based on conditions",ps:'remember score as 85\n\nif score is greater than 80\n show "grade A"\notherwise if score is greater than 60\n show "grade B"\notherwise\n show "grade C"\ndone',js:'let score = 85;\n\nif (score > 80) {\n console.log("grade A");\n} else if (score > 60) {\n console.log("grade B");\n} else {\n console.log("grade C");\n}'},
700
700
  {cat:"loops",name:"For Each Loop",desc:"Iterate over every item in a collection",ps:'remember fruits as ["apple", "banana", "cherry"]\n\nfor each fruit in fruits\n show fruit\ndone',js:'let fruits = ["apple", "banana", "cherry"];\n\nfor (const fruit of fruits) {\n console.log(fruit);\n}'},
701
701
  {cat:"loops",name:"While Loop",desc:"Repeat while a condition is true",ps:'remember count as 0\n\nwhile count is less than 5\n show count\n count becomes count + 1\ndone',js:'let count = 0;\n\nwhile (count < 5) {\n console.log(count);\n count = count + 1;\n}'},
@@ -713,23 +713,23 @@ var LIBRARY = [
713
713
  {cat:"imports",name:"Import .ps File",desc:"Import another PlainScript file",ps:'import "./utils.ps"\nimport "./database.ps"',js:'// Bundled in dependency order at compile time'},
714
714
  {cat:"server",name:"Web App",desc:"Create an Express server with one line",ps:'web app',js:'const express = require(\'express\');\nconst app = express();\napp.use(express.json());'},
715
715
  {cat:"server",name:"Define Route",desc:"Handle HTTP requests with route blocks",ps:'web app\n\nroute "/"\n reply "Hello, World!"\ndone\n\nroute post "/users"\n reply json\n name is "Ayokunle"\n done\ndone',js:'const express = require(\'express\');\nconst app = express();\napp.use(express.json());\n\napp.get("/", (req, res) => {\n res.send("Hello, World!");\n});\n\napp.post("/users", (req, res) => {\n res.json({ "name": "Ayokunle" });\n});'},
716
- {cat:"server",name:"Route Groups",desc:"Prefix multiple routes with a common path",ps:'group "/api"\n route "/users"\n reply "users list"\n done\n\n route "/posts"\n reply "posts list"\n done\ndone',js:'app.get("/api/users", (req, res) => {\n res.send("users list");\n});\n\napp.get("/api/posts", (req, res) => {\n res.send("posts list");\n});'},
717
- {cat:"server",name:"Request Data",desc:"Access params, query, headers, and body",ps:'route "/users/:id"\n remember id as param("id")\n remember page as query("page")\n remember token as header("x-token")\n remember data as body of request\n show id\ndone',js:'app.get("/users/:id", (req, res) => {\n let id = req.params["id"];\n let page = req.query["page"];\n let token = req.headers["x-token"];\n let data = req.body;\n console.log(id);\n});'},
716
+ {cat:"server",name:"Route Groups",desc:"Prefix multiple routes with a common path",ps:'group "/api"\n route "/users"\n reply "users list"\n done\n\n route "/posts"\n reply "posts list"\n done\ndone',js:'app.get("/api/users", (req, res) => {\n res.send("users list");\n});\n\napp.get("/api/posts", (req, res) => {\n res.send("posts list");\n});',skipRun:true},
717
+ {cat:"server",name:"Request Data",desc:"Access params, query, headers, and body",ps:'route "/users/:id"\n remember id as param("id")\n remember page as query("page")\n remember token as header("x-token")\n remember data as body of request\n show id\ndone',js:'app.get("/users/:id", (req, res) => {\n let id = req.params["id"];\n let page = req.query["page"];\n let token = req.headers["x-token"];\n let data = req.body;\n console.log(id);\n});',skipRun:true},
718
718
  {cat:"server",name:"Static Files & CORS",desc:"Serve static files and enable CORS",ps:'web app\nserve folder "public"\nallow cors\nstart 3000',js:'const express = require(\'express\');\nconst app = express();\napp.use(express.json());\napp.use(express.static("public"));\n// CORS middleware added\napp.listen(3000);'},
719
- {cat:"server",name:"Status Codes",desc:"Set HTTP response status codes",ps:'route "/not-found"\n status 404\n reply "Not found"\ndone',js:'app.get("/not-found", (req, res) => {\n res.status(404);\n res.send("Not found");\n});'},
719
+ {cat:"server",name:"Status Codes",desc:"Set HTTP response status codes",ps:'route "/not-found"\n status 404\n reply "Not found"\ndone',js:'app.get("/not-found", (req, res) => {\n res.status(404);\n res.send("Not found");\n});',skipRun:true},
720
720
  {cat:"database",name:"Connect SQLite",desc:"Open a SQLite database connection",ps:'database "app.db"',js:'const db = await __dbOpen("app.db", null);'},
721
- {cat:"database",name:"Query Data",desc:"Run a SELECT query and get results",ps:'remember rows as query\n SELECT * FROM users WHERE active = 1\ndone\n\nfor each row in rows\n show row.name\ndone',js:'let rows = db.prepare(\n "SELECT * FROM users WHERE active = 1"\n).all();\n\nfor (const row of rows) {\n console.log(row.name);\n}'},
722
- {cat:"database",name:"Insert Data",desc:"Insert new rows into a table",ps:'insert\n INSERT INTO users (name, email)\n VALUES ("Ayokunle", "ayo@test.com")\ndone',js:'db.prepare(\n "INSERT INTO users (name, email) VALUES (?, ?)"\n).run("Ayokunle", "ayo@test.com");'},
723
- {cat:"database",name:"Update Data",desc:"Update existing rows",ps:'update\n UPDATE users SET active = 0 WHERE id = 1\ndone',js:'db.prepare(\n "UPDATE users SET active = 0 WHERE id = 1"\n).run();'},
724
- {cat:"database",name:"Create Tables",desc:"Execute DDL statements",ps:'execute\n CREATE TABLE IF NOT EXISTS users (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL,\n email TEXT UNIQUE\n )\ndone',js:'db.exec(\n "CREATE TABLE IF NOT EXISTS users (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n name TEXT NOT NULL,\\n email TEXT UNIQUE\\n )"\n);'},
725
- {cat:"database",name:"Transactions",desc:"Wrap multiple operations in a transaction",ps:'transaction\n insert\n INSERT INTO accounts (name, balance) VALUES ("Ayo", 1000)\n done\n insert\n INSERT INTO accounts (name, balance) VALUES ("Dayo", 500)\n done\ndone',js:'db.transaction(() => {\n db.prepare("INSERT INTO accounts (name, balance) VALUES (?, ?)").run("Ayo", 1000);\n db.prepare("INSERT INTO accounts (name, balance) VALUES (?, ?)").run("Dayo", 500);\n})();'},
721
+ {cat:"database",name:"Query Data",desc:"Run a SELECT query and get results",ps:'remember rows as query\n SELECT * FROM users WHERE active = 1\ndone\n\nfor each row in rows\n show row.name\ndone',js:'let rows = db.prepare(\n "SELECT * FROM users WHERE active = 1"\n).all();\n\nfor (const row of rows) {\n console.log(row.name);\n}',skipRun:true},
722
+ {cat:"database",name:"Insert Data",desc:"Insert new rows into a table",ps:'insert\n INSERT INTO users (name, email)\n VALUES ("Ayokunle", "ayo@test.com")\ndone',js:'db.prepare(\n "INSERT INTO users (name, email) VALUES (?, ?)"\n).run("Ayokunle", "ayo@test.com");',skipRun:true},
723
+ {cat:"database",name:"Update Data",desc:"Update existing rows",ps:'update\n UPDATE users SET active = 0 WHERE id = 1\ndone',js:'db.prepare(\n "UPDATE users SET active = 0 WHERE id = 1"\n).run();',skipRun:true},
724
+ {cat:"database",name:"Create Tables",desc:"Execute DDL statements",ps:'execute\n CREATE TABLE IF NOT EXISTS users (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL,\n email TEXT UNIQUE\n )\ndone',js:'db.exec(\n "CREATE TABLE IF NOT EXISTS users (\\n id INTEGER PRIMARY KEY AUTOINCREMENT,\\n name TEXT NOT NULL,\\n email TEXT UNIQUE\\n )"\n);',skipRun:true},
725
+ {cat:"database",name:"Transactions",desc:"Wrap multiple operations in a transaction",ps:'transaction\n insert\n INSERT INTO accounts (name, balance) VALUES ("Ayo", 1000)\n done\n insert\n INSERT INTO accounts (name, balance) VALUES ("Dayo", 500)\n done\ndone',js:'db.transaction(() => {\n db.prepare("INSERT INTO accounts (name, balance) VALUES (?, ?)").run("Ayo", 1000);\n db.prepare("INSERT INTO accounts (name, balance) VALUES (?, ?)").run("Dayo", 500);\n})();',skipRun:true},
726
726
  {cat:"database",name:"PostgreSQL",desc:"Connect to a PostgreSQL database",ps:'postgres env("DATABASE_URL")\n\nremember rows as query\n SELECT * FROM users LIMIT 10\ndone',js:'const pool = new Pool({ connectionString: process.env["DATABASE_URL"] });\nlet result = await pool.query("SELECT * FROM users LIMIT 10");\nlet rows = result.rows;'},
727
727
  {cat:"cache",name:"Redis Cache",desc:"Connect to Redis for key-value caching",ps:'cache "redis://localhost:6379"',js:'// Creates Redis client and connects'},
728
- {cat:"cache",name:"Get / Set Cache",desc:"Read and write cached values",ps:'cacheSet("user:1", "Ayokunle")\ncacheSet("token:abc", data, 3600)\n\nremember name as cacheGet("user:1")\nshow name',js:'await __cacheClient().set("user:1", "Ayokunle");\nawait __cacheClient().set("token:abc", data, { EX: 3600 });\n\nlet name = await __cacheClient().get("user:1");\nconsole.log(name);'},
729
- {cat:"cache",name:"Delete Cache",desc:"Remove a cached key",ps:'cacheDelete("user:1")',js:'await __cacheClient().del("user:1");'},
730
- {cat:"http",name:"GET Request",desc:"Fetch data from an API",ps:'remember response as get "https://api.example.com/users"\nshow data of response',js:'let response = await __httpRequest(\'GET\', "https://api.example.com/users", {});\nconsole.log(response.data);'},
731
- {cat:"http",name:"POST Request",desc:"Send data to an API",ps:'remember body as\n name is "Ayokunle"\n email is "ayo@test.com"\ndone\n\nremember result as post "https://api.example.com/users" with body',js:'let body = {\n "name": "Ayokunle",\n "email": "ayo@test.com"\n};\n\nlet result = await __httpRequest(\'POST\', "https://api.example.com/users", { body });'},
732
- {cat:"http",name:"PUT / PATCH / DELETE",desc:"Update or remove resources via API",ps:'put "https://api.example.com/users/1" with body\npatch "https://api.example.com/users/1" with body\ndelete "https://api.example.com/users/1"',js:'await __httpRequest(\'PUT\', url, { body });\nawait __httpRequest(\'PATCH\', url, { body });\nawait __httpRequest(\'DELETE\', "https://api.example.com/users/1", {});'},
728
+ {cat:"cache",name:"Get / Set Cache",desc:"Read and write cached values",ps:'cacheSet("user:1", "Ayokunle")\ncacheSet("token:abc", data, 3600)\n\nremember name as cacheGet("user:1")\nshow name',js:'await __cacheClient().set("user:1", "Ayokunle");\nawait __cacheClient().set("token:abc", data, { EX: 3600 });\n\nlet name = await __cacheClient().get("user:1");\nconsole.log(name);',skipRun:true},
729
+ {cat:"cache",name:"Delete Cache",desc:"Remove a cached key",ps:'cacheDelete("user:1")',js:'await __cacheClient().del("user:1");',skipRun:true},
730
+ {cat:"http",name:"GET Request",desc:"Fetch data from an API",ps:'remember response as get "https://api.example.com/users"\nshow data of response',js:'let response = await __httpRequest(\'GET\', "https://api.example.com/users", {});\nconsole.log(response.data);',skipRun:true},
731
+ {cat:"http",name:"POST Request",desc:"Send data to an API",ps:'remember body as\n name is "Ayokunle"\n email is "ayo@test.com"\ndone\n\nremember result as post "https://api.example.com/users" with body',js:'let body = {\n "name": "Ayokunle",\n "email": "ayo@test.com"\n};\n\nlet result = await __httpRequest(\'POST\', "https://api.example.com/users", { body });',skipRun:true},
732
+ {cat:"http",name:"PUT / PATCH / DELETE",desc:"Update or remove resources via API",ps:'put "https://api.example.com/users/1" with body\npatch "https://api.example.com/users/1" with body\ndelete "https://api.example.com/users/1"',js:'await __httpRequest(\'PUT\', url, { body });\nawait __httpRequest(\'PATCH\', url, { body });\nawait __httpRequest(\'DELETE\', "https://api.example.com/users/1", {});',skipRun:true},
733
733
  {cat:"filesystem",name:"Read File",desc:"Read a file from disk",ps:'remember content as readFile("data.txt")\nshow content',js:'let content = fs.readFileSync("data.txt", \'utf8\');\nconsole.log(content);'},
734
734
  {cat:"filesystem",name:"Write File",desc:"Write content to a file",ps:'writeFile("output.txt", "Hello World")\nwrite("data" to "output.txt")',js:'fs.writeFileSync("output.txt", "Hello World", \'utf8\');\nfs.writeFileSync("data", "output.txt", \'utf8\');'},
735
735
  {cat:"filesystem",name:"File Operations",desc:"Check, copy, move, and delete files",ps:'show fileExists("data.txt")\ncopyFile("data.txt", "backup.txt")\nmoveFile("old.txt", "new.txt")\ndeleteFile("temp.txt")\nappendFile("log.txt", "new line\\n")',js:'console.log(fs.existsSync("data.txt"));\nfs.copyFileSync("data.txt", "backup.txt");\nfs.renameSync("old.txt", "new.txt");\nfs.unlinkSync("temp.txt");\nfs.appendFileSync("log.txt", "new line\\n", \'utf8\');'},
@@ -745,37 +745,112 @@ var LIBRARY = [
745
745
  {cat:"auth",name:"Password Hashing",desc:"Hash and verify passwords securely",ps:'remember hash as hashPassword("my-secret-pw")\nshow checkPassword("my-secret-pw", hash)',js:'let hash = hashPassword("my-secret-pw");\nconsole.log(checkPassword("my-secret-pw", hash));'},
746
746
  {cat:"auth",name:"JWT Tokens",desc:"Create and verify JSON Web Tokens",ps:'remember token as createToken({ id: 1 }, "secret-key")\nshow readToken(token, "secret-key")',js:'let token = createToken({ "id": 1 }, "secret-key");\nconsole.log(readToken(token, "secret-key"));'},
747
747
  {cat:"auth",name:"Sessions",desc:"Enable server-side sessions",ps:'web app\nenable sessions "my-secret-key"\n\nroute "/login"\n user of session of request becomes "Ayokunle"\n reply "Logged in"\ndone',js:'app.use(__enableSessions("my-secret-key"));\n\napp.get("/login", (req, res) => {\n __sessionOf(req).user = "Ayokunle";\n res.send("Logged in");\n});'},
748
- {cat:"auth",name:"Cookies",desc:"Set, read, and clear cookies",ps:'route "/pref"\n set cookie "theme" to "dark"\n set cookie "lang" to "en" expires in 7 days\n remember theme as cookie("theme")\n clear cookie "theme"\ndone',js:'app.get("/pref", (req, res) => {\n res.cookie("theme", "dark", { httpOnly: true, path: \'/\' });\n res.cookie("lang", "en", { httpOnly: true, path: \'/\', maxAge: 604800000 });\n let theme = __cookieValue(req, "theme");\n res.clearCookie("theme", { path: \'/\' });\n});'},
748
+ {cat:"auth",name:"Cookies",desc:"Set, read, and clear cookies",ps:'route "/pref"\n set cookie "theme" to "dark"\n set cookie "lang" to "en" expires in 7 days\n remember theme as cookie("theme")\n clear cookie "theme"\ndone',js:'app.get("/pref", (req, res) => {\n res.cookie("theme", "dark", { httpOnly: true, path: \'/\' });\n res.cookie("lang", "en", { httpOnly: true, path: \'/\', maxAge: 604800000 });\n let theme = __cookieValue(req, "theme");\n res.clearCookie("theme", { path: \'/\' });\n});',skipRun:true},
749
749
  {cat:"auth",name:"Rate Limiting",desc:"Protect endpoints from abuse",ps:'web app\nlimit requests to 100 per minute',js:'app.use(__rateLimit({ "max": 100, "windowMs": 60000 }));'},
750
750
  {cat:"auth",name:"API Key Protection",desc:"Require an API key for access",ps:'web app\nrequire api key from env("API_KEY")',js:'// Middleware checks x-api-key header against process.env["API_KEY"]'},
751
- {cat:"telegram",name:"Telegram Bot",desc:"Create a Telegram bot with command handlers",ps:'bot env("BOT_TOKEN")\n\nwhen someone sends "/start"\n reply "Welcome to PlainScript!"\ndone\n\nwhen someone sends matching "/echo (.+)"\n reply match\ndone\n\nstart telegram bot',js:'BOT = await Telegram.createTelegramBot(process.env["BOT_TOKEN"]);\n\nBOT.onCommand("/start", async (ctx) => {\n await Telegram.sendMessage(ctx.chatId, "Welcome to PlainScript!");\n});\n\nBOT.onPattern(/echo (.+)/i, async (ctx) => {\n await Telegram.sendMessage(ctx.chatId, ctx.match[1]);\n});\n\nawait BOT.start();'},
751
+ {cat:"telegram",name:"Telegram Bot",desc:"Create a Telegram bot with command handlers",ps:'bot env("BOT_TOKEN")\n\nwhen someone sends "/start"\n reply "Welcome to PlainScript!"\ndone\n\nwhen someone sends matching "/echo (.+)"\n reply "echo"\ndone\n\nstart telegram bot',js:'BOT = await Telegram.createTelegramBot(process.env["BOT_TOKEN"]);\n\nBOT.onCommand("/start", async (ctx) => {\n await Telegram.sendMessage(ctx.chatId, "Welcome to PlainScript!");\n});\n\nBOT.onPattern(/echo (.+)/i, async (ctx) => {\n await Telegram.sendMessage(ctx.chatId, ctx.match[1]);\n});\n\nawait BOT.start();',skipRun:true},
752
752
  {cat:"whatsapp",name:"WhatsApp Bot",desc:"Create a WhatsApp bot with message handlers",ps:'whatsapp bot\n on message\n reply "You said: ${message.text}"\n done\ndone',js:'await __whatsappStart({ "folder": "plainscript-whatsapp-auth", "login": "qr" });\n__whatsappOnMessage(async (__waCtx) => {\n await __whatsappReply(__waCtx.chat, `You said: ${__waCtx.message.text}`);\n});'},
753
753
  {cat:"websocket",name:"WebSocket Server",desc:"Create a real-time WebSocket server",ps:'websocket server on 8080\n when socket connects\n send socket "Welcome!"\n done\n\n when socket sends message\n broadcast message\n done\n\ndone',js:'__wsServerCreate(8080, {\n connect: async (socket) => {\n __wsSend(socket, "Welcome!");\n },\n message: async (socket, message) => {\n __wsBroadcast(__wsServer, message);\n }\n});'},
754
754
  {cat:"email",name:"Send Email",desc:"Configure SMTP and send emails",ps:'mail transport\n host is "smtp.gmail.com"\n port is 587\n user is env("EMAIL_USER")\n pass is env("EMAIL_PASS")\ndone\n\nsend mail\n from is "me@example.com"\n to is "friend@example.com"\n subject is "Hello"\n text is "PlainScript sends email!"\ndone',js:'__mailCreate({ "host": "smtp.gmail.com", "port": 587, "auth": { "user": process.env["EMAIL_USER"], "pass": process.env["EMAIL_PASS"] } });\n\nawait __mailSend({ "from": "me@example.com", "to": "friend@example.com", "subject": "Hello", "text": "PlainScript sends email!" });'},
755
755
  {cat:"upload",name:"File Uploads",desc:"Accept and process file uploads",ps:'web app\naccept uploads limit "10 MB"\nallow ["image/png", "image/jpeg"]\nfolder "uploads"\n\nroute "/upload"\n remember file as upload("document")\n show file.name\n show file.size\ndone',js:'app.use(__uploads({ "limitBytes": 10485760, "mimes": ["image/png", "image/jpeg"], "folder": "uploads" }));\n\napp.get("/upload", (req, res) => {\n let file = __uploadedFile(req, "document");\n console.log(file.name);\n console.log(file.size);\n});'},
756
- {cat:"cli",name:"CLI: new",desc:"Scaffold a new PlainScript project",ps:'plainscript new my-app',js:'// Creates my-app/ with src/app.ps and package.json'},
757
- {cat:"cli",name:"CLI: run",desc:"Compile and execute a PlainScript file",ps:'plainscript run src/app.ps',js:'// Compiles src/app.ps and runs the output'},
758
- {cat:"cli",name:"CLI: build",desc:"Compile .ps files to JavaScript",ps:'plainscript build',js:'// Compiles src/app.ps to dist/app.js'},
759
- {cat:"cli",name:"CLI: fmt",desc:"Auto-format PlainScript code",ps:'plainscript fmt src/app.ps',js:'// Formats src/app.ps in place'},
760
- {cat:"cli",name:"CLI: doctor",desc:"Diagnose project issues",ps:'plainscript doctor',js:'// Checks Node version, dependencies, config'},
761
- {cat:"cli",name:"CLI: check",desc:"Type-check without emitting output",ps:'plainscript check src/app.ps',js:'// Validates syntax without compiling'},
762
- {cat:"cli",name:"CLI: watch",desc:"Watch files and recompile on change",ps:'plainscript watch',js:'// Starts file watcher for .ps files'},
763
- {cat:"cli",name:"CLI: install / add / remove",desc:"Manage project dependencies",ps:'plainscript install\nplainscript add express\nplainscript remove lodash',js:'// npm install / npm install express / npm uninstall lodash'},
756
+ {cat:"cli",name:"CLI: new",desc:"Scaffold a new PlainScript project",ps:'plainscript new my-app',js:'// Creates my-app/ with src/app.ps and package.json',skipRun:true},
757
+ {cat:"cli",name:"CLI: run",desc:"Compile and execute a PlainScript file",ps:'plainscript run src/app.ps',js:'// Compiles src/app.ps and runs the output',skipRun:true},
758
+ {cat:"cli",name:"CLI: build",desc:"Compile .ps files to JavaScript",ps:'plainscript build',js:'// Compiles src/app.ps to dist/app.js',skipRun:true},
759
+ {cat:"cli",name:"CLI: fmt",desc:"Auto-format PlainScript code",ps:'plainscript fmt src/app.ps',js:'// Formats src/app.ps in place',skipRun:true},
760
+ {cat:"cli",name:"CLI: doctor",desc:"Diagnose project issues",ps:'plainscript doctor',js:'// Checks Node version, dependencies, config',skipRun:true},
761
+ {cat:"cli",name:"CLI: check",desc:"Type-check without emitting output",ps:'plainscript check src/app.ps',js:'// Validates syntax without compiling',skipRun:true},
762
+ {cat:"cli",name:"CLI: watch",desc:"Watch files and recompile on change",ps:'plainscript watch',js:'// Starts file watcher for .ps files',skipRun:true},
763
+ {cat:"cli",name:"CLI: install / add / remove",desc:"Manage project dependencies",ps:'plainscript install\nplainscript add express\nplainscript remove lodash',js:'// npm install / npm install express / npm uninstall lodash',skipRun:true},
764
764
  {cat:"logging",name:"JavaScript Gateway",desc:"Embed raw JavaScript when you need full control",ps:'remember result as javascript\n return fetch("https://api.example.com/data")\n .then(r => r.json())\ndone\n\nshow result',js:'let result = await (async () => {\n return fetch("https://api.example.com/data")\n .then(r => r.json());\n})();\n\nconsole.log(result);'},
765
- {cat:"booleans",name:"Ternary / Inline If",desc:"Use if expressions inline (via javascript gateway)",ps:'remember label as javascript\n return age >= 18 ? "adult" : "minor"\ndone',js:'let label = await (async () => {\n return age >= 18 ? "adult" : "minor";\n})();'},
766
- {cat:"server",name:"404 Catch-All",desc:"Handle unmatched routes",ps:'when nothing matches\n status 404\n reply "Page not found"\ndone',js:'app.use((req, res) => {\n res.status(404);\n res.send("Page not found");\n});'},
767
- {cat:"server",name:"Validate Request Body",desc:"Require specific fields in the request body",ps:'route post "/users"\n validate(body of request, ["name", "email"])\n reply "Created"\ndone',js:'app.post("/users", (req, res) => {\n __validate(req.body, ["name", "email"]);\n res.send("Created");\n});'},
765
+ {cat:"booleans",name:"Ternary / Inline If",desc:"Use if expressions inline (via javascript gateway)",ps:'remember label as javascript\n return age >= 18 ? "adult" : "minor"\ndone',js:'let label = await (async () => {\n return age >= 18 ? "adult" : "minor";\n})();',skipRun:true},
766
+ {cat:"server",name:"404 Catch-All",desc:"Handle unmatched routes",ps:'when nothing matches\n status 404\n reply "Page not found"\ndone',js:'app.use((req, res) => {\n res.status(404);\n res.send("Page not found");\n});',skipRun:true},
767
+ {cat:"server",name:"Validate Request Body",desc:"Require specific fields in the request body",ps:'route post "/users"\n validate(body of request, ["name", "email"])\n reply "Created"\ndone',js:'app.post("/users", (req, res) => {\n __validate(req.body, ["name", "email"]);\n res.send("Created");\n});',skipRun:true},
768
768
  {cat:"auth",name:"Google OAuth",desc:"Add Google login to your app",ps:'web app\ngoogle oauth\n id is env("GOOGLE_CLIENT_ID")\n secret is env("GOOGLE_CLIENT_SECRET")\n callback is "/auth/google/callback"\n landing is "/dashboard"\ndone',js:'__googleOAuth(app, {\n clientId: process.env["GOOGLE_CLIENT_ID"],\n clientSecret: process.env["GOOGLE_CLIENT_SECRET"],\n callbackUrl: "/auth/google/callback",\n afterLogin: "/dashboard"\n});'},
769
- {cat:"cli",name:"CLI: version",desc:"Print the PlainScript version",ps:'plainscript version',js:'// Prints v0.1.7'},
770
- {cat:"cli",name:"CLI: help",desc:"Show available commands",ps:'plainscript help',js:'// Lists all CLI commands'},
771
- {cat:"cli",name:"CLI: info",desc:"Display platform and runtime info",ps:'plainscript info',js:'// Shows version, Node version, OS'},
772
- {cat:"cli",name:"CLI: clean",desc:"Remove compiled output",ps:'plainscript clean',js:'// Deletes dist/ folder'},
773
- {cat:"cli",name:"CLI: repl",desc:"Launch interactive REPL shell",ps:'plainscript repl',js:'// Opens interactive PlainScript REPL'},
774
- {cat:"cli",name:"CLI: init",desc:"Initialize config file",ps:'plainscript init',js:'// Creates plainscript.config.json'},
775
- {cat:"cli",name:"CLI: test",desc:"Run the test suite",ps:'plainscript test',js:'// Runs test files in tests/'},
769
+ {cat:"cli",name:"CLI: version",desc:"Print the PlainScript version",ps:'plainscript version',js:'// Prints v1.0.0-beta',skipRun:true},
770
+ {cat:"cli",name:"CLI: help",desc:"Show available commands",ps:'plainscript help',js:'// Lists all CLI commands',skipRun:true},
771
+ {cat:"cli",name:"CLI: info",desc:"Display platform and runtime info",ps:'plainscript info',js:'// Shows version, Node version, OS',skipRun:true},
772
+ {cat:"cli",name:"CLI: clean",desc:"Remove compiled output",ps:'plainscript clean',js:'// Deletes dist/ folder',skipRun:true},
773
+ {cat:"cli",name:"CLI: repl",desc:"Launch interactive REPL shell",ps:'plainscript repl',js:'// Opens interactive PlainScript REPL',skipRun:true},
774
+ {cat:"cli",name:"CLI: init",desc:"Initialize config file",ps:'plainscript init',js:'// Creates plainscript.config.json',skipRun:true},
775
+ {cat:"cli",name:"CLI: test",desc:"Run the test suite",ps:'plainscript test',js:'// Runs test files in tests/',skipRun:true},
776
776
  {cat:"filesystem",name:"Binary File I/O",desc:"Read and write raw bytes",ps:'remember buf as readBytes("image.png")\nwriteBytes("copy.png", buf)',js:'let buf = fs.readFileSync("image.png");\nfs.writeFileSync("copy.png", buf);'},
777
- {cat:"upload",name:"Multiple Uploads",desc:"Handle multiple file uploads at once",ps:'route "/upload-many"\n remember files as uploads("documents")\n for each f in files\n show f.name\n done\ndone',js:'app.get("/upload-many", (req, res) => {\n let files = __uploadedFiles(req, "documents");\n for (const f of files) {\n console.log(f.name);\n }\n});'},
777
+ {cat:"upload",name:"Multiple Uploads",desc:"Handle multiple file uploads at once",ps:'route "/upload-many"\n remember files as uploads("documents")\n for each f in files\n show f.name\n done\ndone',js:'app.get("/upload-many", (req, res) => {\n let files = __uploadedFiles(req, "documents");\n for (const f of files) {\n console.log(f.name);\n }\n});',skipRun:true},
778
778
  {cat:"server",name:"Cron Jobs",desc:"Schedule recurring tasks",ps:'every 5 minutes\n show "running cleanup"\n // cleanup code here\ndone\n\nschedule "0 2 * * *"\n show "daily backup"\n // backup code here\ndone',js:'setInterval(async () => {\n console.log("running cleanup");\n}, 300000);\n\ncron.schedule("0 2 * * *", async () => {\n console.log("daily backup");\n});'},
779
+ {cat:"ai",name:"OCR (Optical Character Recognition)",desc:"Extract text from images using Tesseract OCR",ps:'ocr "screenshot.png" as extractedText\nshow extractedText\n\nocr "receipt.jpg" as receiptText using "eng+fra"',js:'let extractedText = await ocrImage("screenshot.png", "eng");\nconsole.log(extractedText);\n\nlet receiptText = await ocrImage("receipt.jpg", "eng+fra");'},
780
+ {cat:"data",name:"Gather (Map)",desc:"Transform every item in a collection",ps:'remember numbers as [1, 2, 3, 4, 5]\ngather each num in numbers giving num * 2\nshow numbers',js:'let numbers = [1, 2, 3, 4, 5];\nnumbers = numbers.map(num => num * 2);\nconsole.log(numbers);'},
781
+ {cat:"data",name:"Filter",desc:"Keep only items that match a condition",ps:'remember people as [{name: "Ayo", age: 25}, {name: "Tunde", age: 15}]\nfilter each person in people when person.age is above 17\nshow people',js:'let people = [{"name": "Ayo", "age": 25}, {"name": "Tunde", "age": 15}];\npeople = people.filter(person => person.age > 17);\nconsole.log(people);'},
782
+ {cat:"data",name:"Total (Reduce)",desc:"Combine all items into a single value",ps:'remember numbers as [1, 2, 3, 4, 5]\ntotal each num in numbers giving num\nshow numbers',js:'let numbers = [1, 2, 3, 4, 5];\nnumbers = numbers.reduce((__sum, num) => __sum + num, 0);\nconsole.log(numbers);'},
783
+ {cat:"data",name:"Pattern Matching",desc:"Match a value against multiple cases",ps:'remember command as "start"\nmatch command against\n "start" -> show "starting"\n "stop" -> show "stopping"\n otherwise -> show "unknown"\ndone',js:'let command = "start";\nswitch (command) {\n case "start":\n console.log("starting");\n break;\n case "stop":\n console.log("stopping");\n break;\n default:\n console.log("unknown");\n break;\n}'},
784
+ {cat:"data",name:"Regular Expressions",desc:"Match text patterns with regex",ps:'remember email as "ayo@test.com"\nmatch pattern "(\\w+)@(\\w+)" in email as parts\nshow parts',js:'let email = "ayo@test.com";\nlet parts = email.match(new RegExp("(\\\\w+)@(\\\\w+)"));\nconsole.log(parts);'},
785
+ {cat:"data",name:"Dynamic Property Access",desc:"Use a variable as an object key",ps:'remember key as "name"\nremember user as {name: "Ayo", age: 25}\nremember value as user[key]\nshow value',js:'let key = "name";\nlet user = { "name": "Ayo", "age": 25 };\nlet value = user[key];\nconsole.log(value);'},
786
+ {cat:"async",name:"Parallel Async",desc:"Run multiple async operations concurrently",ps:'make slowJob()\n sleep(10)\n give "slow"\ndone\nmake fastJob()\n sleep(5)\n give "fast"\ndone\nremember results as all of [slowJob(), fastJob()]\nshow results',js:'const results = await Promise.all([slowJob(), fastJob()]);\nconsole.log(results);'},
787
+ {cat:"async",name:"Event Emitter",desc:"Create decoupled publish/subscribe systems",ps:'emit "user.login" with user\n\nwhen "user.login" happens as data\n show `User logged in: ${data}`\ndone',js:'__emitter.emit("user.login", user);\n\n__emitter.on("user.login", (data) => {\n console.log(`User logged in: ${data}`);\n});',skipRun:true},
788
+ {cat:"async",name:"Stream Processing",desc:"Process large files line by line without loading into memory",ps:'stream "data.csv" as line\n show line\ndone',js:'await __streamFile("data.csv", async (line) => {\n console.log(line);\n});'},
789
+ {cat:"async",name:"Worker Threads",desc:"Run operations in parallel for faster execution",ps:'run in parallel\n remember a as wait for slowJob()\n remember b as wait for fastJob()\ndone as results',js:'const results = await Promise.all([(async () => {\n let a = (await slowJob());\n let b = (await fastJob());\n})()]);',skipRun:true},
790
+ {cat:"errors",name:"Typed Error Recovery",desc:"Catch specific error types separately",ps:'try\n riskyOperation()\nrecover when err catches "TypeError"\n show "type error"\nrecover when err catches "NetworkError"\n show "network error"\nrecover\n show "other error"\ndone',js:'try {\n riskyOperation();\n} catch (err) {\n if (err instanceof TypeError) {\n console.log("type error");\n }\n else if (err instanceof NetworkError) {\n console.log("network error");\n }\n else {\n console.log("other error");\n }\n}',skipRun:true},
791
+ {cat:"functions",name:"Default Parameters",desc:"Provide fallback values for function arguments",ps:'make greet(name, greeting as "Hello")\n show `${greeting}, ${name}!`\ndone\n\ngreet("Ayo")\ngreet("Ayo", "Hey")',js:'function greet(name, greeting = "Hello") {\n console.log(`${greeting}, ${name}!`);\n}\n\ngreet("Ayo");\ngreet("Ayo", "Hey");'},
792
+ {cat:"conditionals",name:"Else-If Chain",desc:"Test several conditions in order with otherwise if",ps:'remember score as 85\n\nif score is above 80\n show "grade A"\notherwise if score is above 60\n show "grade B"\notherwise\n show "grade C"\ndone',js:'let score = 85;\nif (score > 80) {\n console.log("grade A");\n} else if (score > 60) {\n console.log("grade B");\n} else {\n console.log("grade C");\n}'},
793
+ {cat:"conditionals",name:"Nested If",desc:"Nest an if inside another branch",ps:'remember a as 2\nif a is 1\n show "one"\notherwise\n if a is 2\n show "two"\n done\ndone',js:'let a = 2;\nif (a === 1) {\n console.log("one");\n} else {\n if (a === 2) console.log("two");\n}'},
794
+ {cat:"pattern",name:"Match Against Cases",desc:"Switch on a value against string, number, or boolean cases",ps:'remember color as "green"\n\nmatch color against\n "red" -> show "stop"\n "green" -> show "go"\n otherwise -> show "hold"\ndone',js:'let color = "green";\nswitch (color) {\n case "red": console.log("stop"); break;\n case "green": console.log("go"); break;\n default: console.log("hold");\n}'},
795
+ {cat:"pattern",name:"Match Numbers",desc:"Switch on numeric cases",ps:'remember n as 2\nmatch n against\n 1 -> show "one"\n 2 -> show "two"\n otherwise -> show "many"\ndone',js:'let n = 2;\nswitch (n) {\n case 1: console.log("one"); break;\n case 2: console.log("two"); break;\n default: console.log("many");\n}'},
796
+ {cat:"pattern",name:"Match Booleans",desc:"Switch on boolean cases",ps:'remember flag as true\nmatch flag against\n true -> show "switched on"\n false -> show "off"\ndone',js:'let flag = true;\nswitch (flag) {\n case true: console.log("switched on"); break;\n case false: console.log("off");\n}'},
797
+ {cat:"regex",name:"Regex Match",desc:"Capture regex groups from text",ps:'match pattern "(\\\\d+)-(\\\\d+)" in "order 12-34" as m\nshow m[1]\nshow m[2]',js:'const m = "order 12-34".match(new RegExp("(\\\\d+)-(\\\\d+)"));\nconsole.log(m[1]);\nconsole.log(m[2]);'},
798
+ {cat:"regex",name:"Regex Replace",desc:"Replace every regex match in a string",ps:'show regexReplace("a1b2c3", "\\\\d", "#")',js:'console.log("a1b2c3".replace(new RegExp("\\\\d", "g"), "#"));'},
799
+ {cat:"regex",name:"Regex Split",desc:"Split on a regex pattern",ps:'remember parts as split("a1b2", "\\\\d")\nshow parts',js:'let parts = "a1b2".split(/\\d/);\nconsole.log(parts);'},
800
+ {cat:"concurrency",name:"All Of (Promise.all)",desc:"Await every promise and collect results",ps:'make fetchA()\n give "a"\ndone\nmake fetchB()\n give "b"\ndone\nremember both as all of [fetchA(), fetchB()]\nshow both',js:'let both = await Promise.all([fetchA(), fetchB()]);\nconsole.log(both);'},
801
+ {cat:"concurrency",name:"Any Of (Promise.race)",desc:"Resolve with the first promise to settle",ps:'make slow()\n give "slow"\ndone\nmake fast()\n give "fast"\ndone\nremember winner as any of [slow(), fast()]\nshow winner',js:'let winner = await Promise.race([slow(), fast()]);\nconsole.log(winner);'},
802
+ {cat:"concurrency",name:"Settled Of (Promise.allSettled)",desc:"Await all promises; each yields status/value/reason",ps:'make ok(x)\n give x\ndone\nremember s as settled of [ok(1), ok(2)]\nshow s[0].status\nshow s[1].value',js:'let s = await Promise.allSettled([ok(1), ok(2)]);\nconsole.log(s[0].status);\nconsole.log(s[1].value);'},
803
+ {cat:"concurrency",name:"With Timeout",desc:"Reject a promise if it does not settle in time",ps:'make job()\n sleep(500)\n give "done"\ndone\nremember r as withTimeout(job(), 100)\nshow "finished"',js:'let r = await __withTimeout(job(), 100);\nconsole.log("finished");'},
804
+ {cat:"async",name:"Await (wait for)",desc:"Await a promise to get its resolved value",ps:'make fetchData()\n give 42\ndone\nremember value as wait for fetchData()\nshow value',js:'let value = (await fetchData());\nconsole.log(value);'},
805
+ {cat:"async",name:"Run in Parallel",desc:"Run blocks concurrently and collect results",ps:'run in parallel\n show "task1"\n show "task2"\ndone as results',js:'const results = await Promise.all([(async () => { console.log("task1"); console.log("task2"); })()]);'},
806
+ {cat:"async",name:"Stream File",desc:"Process a file line by line without loading it whole",ps:'stream "data.csv" as line\n show line\ndone',js:'await __streamFile("data.csv", async (line) => { console.log(line); });'},
807
+ {cat:"generators",name:"Yield Generator",desc:"yield inside make makes a generator",ps:'make countUp(n)\n remember i as 0\n while i is less than n\n i becomes i + 1\n yield i\n done\ndone\nshow spread of countUp(3)',js:'function* countUp(n) {\n let i = 0;\n while (i < n) { i = i + 1; yield i; }\n}\nconsole.log([...countUp(3)]);'},
808
+ {cat:"generators",name:"Spread Of",desc:"Materialize any iterable into a fresh array",ps:'show spread of "abc"\nshow spread of [1, 2, 3]',js:'console.log([..."abc"]);\nconsole.log([...[1, 2, 3]]);'},
809
+ {cat:"reflection",name:"Type Of",desc:"Classify a value by its PlainScript type",ps:'show typeOf("hi")\nshow typeOf(42)\nshow typeOf(true)\nshow typeOf([])\nshow typeOf({})\nshow typeOf(null)',js:'show typeOf -> text, number, boolean, array, record, null'},
810
+ {cat:"reflection",name:"Fields Of",desc:"List the keys of a record",ps:'remember u as {name: "A", age: 2}\nshow fieldsOf(u)',js:'show Object.keys(u)'},
811
+ {cat:"reflection",name:"Has Field",desc:"Check a record has a key without tripping on prototypes",ps:'remember u as {name: "A"}\nshow hasField(u, "name")\nshow hasField(u, "age")',js:'console.log(hasField(u, "name"));\nconsole.log(hasField(u, "age"));'},
812
+ {cat:"reflection",name:"Value Of",desc:"Read a field with a fallback if missing",ps:'remember u as {name: "A"}\nshow valueOf(u, "age", 0)',js:'show valueOf(u, "age", 0) // -> 0'},
813
+ {cat:"reflection",name:"Size Of",desc:"Length of a string/array, key count of a record",ps:'show sizeOf([1, 2, 3])\nshow sizeOf("abc")\nshow sizeOf({a: 1, b: 2})',js:'show 3, 3, 2'},
814
+ {cat:"binary",name:"Base64 Encode / Decode",desc:"Round-trip text with base64",ps:'show base64Encode("hello")\nshow base64Decode("aGVsbG8=")',js:'show Buffer "aGVsbG8="'},
815
+ {cat:"binary",name:"Bytes <-> Text",desc:"Convert text to a UTF-8 buffer and back",ps:'remember buf as textToBytes("hi")\nshow bytesToText(buf)',js:'show Buffer.from("hi","utf8") -> "hi"'},
816
+ {cat:"binary",name:"Hashing",desc:"Compute sha256 / sha1 / md5 hex digests",ps:'show sha256("abc")\nshow sha1("abc")\nshow md5("abc")',js:'show crypto digests (hex)'},
817
+ {cat:"binary",name:"Read / Write Bytes",desc:"Read and write raw binary files",ps:'writeBytes("out.bin", textToBytes("hi"))\nremember buf as readBytes("out.bin")\nshow bytesToText(buf)',js:'fs.writeFileSync("out.bin", Buffer.from("hi"));\nlet buf = fs.readFileSync("out.bin");\nconsole.log(buf.toString())'},
818
+ {cat:"booleans",name:"Null Coalesce",desc:"Pick the first value that is not null or undefined",ps:'remember config as {theme: null}\nremember theme as coalesce(theme of config, "light")\nshow theme',js:'let theme = (config.theme ?? "light");\nconsole.log(theme);'},
819
+ {cat:"datetime",name:"Parse Date",desc:"Turn a date string into milliseconds since the epoch",ps:'remember ms as parseDate("2020-01-02")\nshow ms',js:'show Date.parse("2020-01-02")'},
820
+ {cat:"datetime",name:"Format Date",desc:"Format milliseconds/Date with a pattern",ps:'remember ms as parseDate("2020-01-02")\nshow formatDate(ms, "DD/MM/YYYY")',js:'show formatDate -> "02/01/2020"'},
821
+ {cat:"config",name:"Load Env File",desc:"Apply KEY=VALUE pairs from a .env file",ps:'load env file ".env"\nshow env("PORT")',js:'__loadEnvFile(".env");\nconsole.log(process.env["PORT"]);'},
822
+ {cat:"config",name:"YAML Decode",desc:"Parse a YAML subset into a record",ps:'remember cfg as yamlDecode("name: Ada\\nport: 3000\\n")\nshow cfg.name',js:'show __yamlParse text -> record'},
823
+ {cat:"config",name:"YAML Encode",desc:"Serialize a record to YAML lines",ps:'remember text as yamlEncode({name: "Ada", port: 3000})\nshow text',js:'show __yamlStringify record -> text'},
824
+ {cat:"process",name:"Command-Line Args",desc:"Read command-line arguments after the script name",ps:'show args()',js:'show process.argv.slice(2)'},
825
+ {cat:"process",name:"Run Command",desc:"Run an external command and capture its output",ps:'remember r as runCommand("node", ["-e", "console.log(2+2)"])\nshow r.ok\nshow r.stdout',js:'let r = await __runCommand("node", ["-e", "console.log(2+2)"]);\nconsole.log(r.ok);\nconsole.log(r.stdout);'},
826
+ {cat:"process",name:"Load Module",desc:"Dynamically require a module at runtime",ps:'remember m as loadModule("./my-module")\nshow "loaded"',js:'let m = __loadModule("./my-module");\nconsole.log("loaded");'},
827
+ {cat:"filesystem",name:"File Metadata",desc:"Get size, type, and modified time of a file",ps:'show fileSize("data.txt")\nshow fileType("data.txt")\nshow lastModified("data.txt")',js:'show fs.statSync("data.txt").size / isDirectory / mtime'},
828
+ {cat:"filesystem",name:"Walk Folder",desc:"Recursively list every file path under a folder",ps:'for each f in walkFolder("src")\n show f\ndone',js:'for (const f of __walkFolder("src")) console.log(f);'},
829
+ {cat:"filesystem",name:"Append Line",desc:"Append a line terminated by a newline",ps:'writeLine("log.txt", "first")\nappendLine("log.txt", "second")',js:'fs.appendFileSync("log.txt", "first\\n", "utf8");\nfs.appendFileSync("log.txt", "second\\n", "utf8");'},
830
+ {cat:"paths",name:"Join Path",desc:"Join path segments for the current OS",ps:'show joinPath("a", "b", "c")',js:'show path.join("a", "b", "c")'},
831
+ {cat:"paths",name:"Base Name",desc:"Get the file name from a path",ps:'show baseName("/a/b.txt")',js:'show path.basename("/a/b.txt")'},
832
+ {cat:"paths",name:"Folder Of",desc:"Get the directory part of a path",ps:'show folderOf("/a/b.txt")',js:'show path.dirname("/a/b.txt")'},
833
+ {cat:"paths",name:"Extension Of",desc:"Get the extension of a path",ps:'show extensionOf("/a/b.txt")',js:'show path.extname("/a/b.txt")'},
834
+ {cat:"data",name:"Map Helpers",desc:"A keyed collection via keyMap and friends",ps:'remember m as keyMap()\nmapSet(m, "user", "Ada")\nshow mapGet(m, "user")\nshow mapHas(m, "user")\nmapDelete(m, "user")',js:'let m = new Map();\n__mapSet(m, "user", "Ada");\nconsole.log(m.get("user"));\nconsole.log(m.has("user"));\nm.delete("user");'},
835
+ {cat:"data",name:"Set Helpers",desc:"A de-duplicating collection via newSet and friends",ps:'remember s as newSet()\naddToSet(s, 1)\naddToSet(s, 1)\nshow setHas(s, 1) // true (dedup)',js:'let s = new Set();\ns.add(1);\ns.add(1);\nconsole.log(s.has(1));'},
836
+ {cat:"testing",name:"Native Test Suite",desc:"Declare a test block with check assertions",ps:'test "addition"\n check add(2, 3) equals 5\n check "hello" contains "ell"\n check 1 is 1\ndone\n\nmake add(a, b)\n give a + b\ndone',js:'const __tests = [];\n__tests.push(() => __check("equals", add(2,3), 5));\n__tests.push(() => __check("contains", "hello", "ell"));\n__tests.push(() => __check("is", 1, 1));\n__runTests();'},
837
+ {cat:"testing",name:"Check Raises",desc:"Assert that an expression throws",ps:'test "invalid json"\n check jsonDecode("not json") raises "JSON"\ndone',js:'__check("raises", () => JSON.parse("not json"), "JSON");'},
838
+ {cat:"imports",name:"Export Symbol",desc:"Mark a top-level symbol for module.exports",ps:'remember version as 3\nexport version',js:'module.exports.version = 3;'},
839
+ {cat:"ai",name:"OCR Image",desc:"Extract text from an image with tesseract.js",ps:'ocr "scan.png" as text\nshow text',js:'let text = await __ocr("scan.png", "eng");\nconsole.log(text);'},
840
+ {cat:"ai",name:"OCR Language",desc:"Choose a language pack for OCR",ps:'ocr "scan.png" as text using "deu"\nshow text',js:'let text = await __ocr("scan.png", "deu");\nconsole.log(text);'},
841
+ {cat:"logging",name:"Ask Input",desc:"Prompt for a line of terminal input",ps:'ask "Your name?" as name\nshow `Hello, ${name}`',js:'let name = await __ask("Your name?");\nconsole.log(`Hello, ${name}`);'},
842
+ {cat:"data",name:"Gather (Map)",desc:"Transform every item in a collection",ps:'remember nums as [1, 2, 3]\ngather each n in nums giving n * 2\nshow nums',js:'nums = nums.map(n => n * 2);\nconsole.log(nums);'},
843
+ {cat:"data",name:"Filter Items",desc:"Keep only items that match a condition",ps:'remember nums as [1, 2, 3, 4]\nfilter each n in nums when n is above 2\nshow nums',js:'nums = nums.filter(n => n > 2);\nconsole.log(nums);'},
844
+ {cat:"data",name:"Total (Reduce)",desc:"Combine all items into one value",ps:'remember nums as [1, 2, 3]\ntotal each n in nums giving n\nshow nums',js:'nums = nums.reduce((sum, n) => sum + n, 0);\nconsole.log(nums);'},
845
+ {cat:"errors",name:"Try / Recover",desc:"Catch errors raised inside a block",ps:'try\n jsonDecode("not json")\nrecover as err\n show "caught"\ndone',js:'try {\n JSON.parse("not json");\n} catch (err) {\n console.log("caught");\n}'},
846
+ {cat:"errors",name:"Recover by Type",desc:"Catch specific error types with catches",ps:'try\n jsonDecode("x")\nrecover when err catches "SyntaxError"\n show "bad json"\nrecover\n show "other"\ndone',js:'try {\n JSON.parse("x");\n} catch (err) {\n if (err instanceof SyntaxError) console.log("bad json");\n else console.log("other");\n}'},
847
+ {cat:"errors",name:"Retry",desc:"Retry a block a number of times",ps:'retry 3 times\n show "attempt"\ndone',js:'for (let __i = 0; __i < 3; __i++) {\n console.log("attempt");\n}'},
848
+ {cat:"errors",name:"Retry with Delay",desc:"Retry with a delay between attempts",ps:'retry 3 times every 2 seconds\n show "retrying"\ndone',js:'for (let __i = 0; __i < 3; __i++) {\n console.log("retrying");\n if (__i < 2) await __retrySleep(2000);\n}'},
849
+ {cat:"errors",name:"Event Emitter",desc:"Publish and subscribe to named events",ps:'emit "user.login" with "Ada"\nwhen "user.login" happens as user\n show `welcome ${user}`\ndone',js:'__emitter.emit("user.login", "Ada");\n__emitter.on("user.login", (user) => { console.log(`welcome ${user}`); });'},
850
+ {cat:"http",name:"HTTP Headers & Timeout",desc:"Send HTTP requests with custom headers and timeout",ps:'remember r as get "https://api.example.com" headers { "x-key": "abc" } timeout 5000\nshow r.status',js:'let r = await __httpRequest("GET", url, { headers: {...}, timeoutMs: 5000 });\nconsole.log(r.status);',skipRun:true},
851
+ {cat:"server",name:"Typed Server Routes",desc:"Start a web app with typed route accessors",ps:'web app\nroute get "/u/:id"\n remember who as param("id")\n remember page as query("page")\n reply `user=${who} page=${page}`\ndone\nroute post "/check"\n remember missing as validate(body of request, ["name"])\n reply missing\ndone\nstart 3000',js:'const app = express();\napp.get("/u/:id", (req, res) => {\n const who = req.params["id"];\n const page = req.query["page"];\n res.send(`user=${who} page=${page}`);\n});\napp.post("/check", (req, res) => {\n res.send(__validate(req.body, ["name"]));\n});\napp.listen(3000);'},
852
+ {cat:"auth",name:"Password Hashing",desc:"Hash and verify passwords (scrypt)",ps:'remember hash as hashPassword("secret123")\nshow checkPassword("secret123", hash)',js:'let hash = hashPassword("secret123");\nconsole.log(checkPassword("secret123", hash));'},
853
+ {cat:"auth",name:"Signed Tokens",desc:"Create and verify HS256 JWTs",ps:'remember token as createToken({ role: "admin" }, "secret", 3600)\nremember claims as readToken(token, "secret")\nshow claims.role',js:'let token = createToken({ role: "admin" }, "secret", 3600);\nlet claims = readToken(token, "secret");\nconsole.log(claims.role);'},
779
854
  ];
780
855
 
781
856
  function initLibrary() {
package/package.json CHANGED
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "plainscript-lang",
3
- "version": "0.1.7-rc",
3
+ "version": "1.0.0-beta",
4
4
  "description": "PlainScript — an Intent-Oriented Programming Language. When even a simple sentence can be code.",
5
5
  "main": "compiler/cli.js",
6
6
  "bin": {
7
7
  "plainscript": "./compiler/cli.js"
8
8
  },
9
9
  "scripts": {
10
- "test": "node tests/compiler.test.js && node tests/build.test.js && node tests/telegram.test.js && node tests/ocr.test.js && node tests/backend.test.js && node tests/runtime.test.js && node tests/acceptance.test.js && node tests/whatsapp.test.js"
10
+ "test": "node tests/compiler.test.js && node tests/build.test.js && node tests/telegram.test.js && node tests/ocr.test.js && node tests/backend.test.js && node tests/runtime.test.js && node tests/acceptance.test.js && node tests/whatsapp.test.js && node tests/audit.test.js"
11
11
  },
12
12
  "files": [
13
13
  "compiler",