plainscript-lang 1.0.1 → 1.0.2

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.
Files changed (52) hide show
  1. package/README.md +154 -147
  2. package/compiler/bundler.js +2 -2
  3. package/compiler/cli.js +58 -58
  4. package/compiler/formatter.js +1 -1
  5. package/compiler/generator.js +753 -67
  6. package/compiler/lexer.js +127 -53
  7. package/compiler/parser.js +953 -151
  8. package/compiler/version.js +1 -1
  9. package/docs/CAPABILITY_GAP_AUDIT.md +130 -29
  10. package/docs/PLAINSCRIPT-SPEC.md +584 -0
  11. package/docs/index.html +33 -42
  12. package/docs/website/script.js +110 -24
  13. package/docs/website/style.css +4 -4
  14. package/examples/arrays.pln +12 -0
  15. package/examples/{auth-api.ps → auth-api.pln} +3 -3
  16. package/examples/{cache-and-jobs.ps → cache-and-jobs.pln} +1 -1
  17. package/examples/{concurrency.ps → concurrency.pln} +8 -8
  18. package/examples/{database.ps → database.pln} +1 -1
  19. package/examples/{deployment.ps → deployment.pln} +2 -2
  20. package/examples/{email-send.ps → email-send.pln} +1 -1
  21. package/examples/{error-handling.ps → error-handling.pln} +8 -7
  22. package/examples/{expressions.ps → expressions.pln} +1 -1
  23. package/examples/{file-uploads.ps → file-uploads.pln} +4 -4
  24. package/examples/{files-and-config.ps → files-and-config.pln} +4 -4
  25. package/examples/football-backend/{app.ps → app.pln} +2 -2
  26. package/examples/{http-client.ps → http-client.pln} +18 -18
  27. package/examples/id-verification/{app.ps → app.pln} +1 -1
  28. package/examples/{loops.ps → loops.pln} +2 -3
  29. package/examples/modules/{app.ps → app.pln} +4 -4
  30. package/examples/modules/{math.ps → math.pln} +1 -1
  31. package/examples/{record-kinds.ps → record-kinds.pln} +4 -4
  32. package/examples/{rest-api-fetch.ps → rest-api-fetch.pln} +1 -1
  33. package/examples/{rest-api.ps → rest-api.pln} +5 -5
  34. package/examples/{scheduled-tasks.ps → scheduled-tasks.pln} +2 -2
  35. package/examples/{search-and-filter.ps → search-and-filter.pln} +5 -5
  36. package/examples/{sessions-and-cookies.ps → sessions-and-cookies.pln} +2 -2
  37. package/examples/start.pln +2 -0
  38. package/examples/{stdlib.ps → stdlib.pln} +2 -2
  39. package/examples/{telegram-bot.ps → telegram-bot.pln} +2 -2
  40. package/examples/{websocket-server.ps → websocket-server.pln} +1 -1
  41. package/package.json +1 -1
  42. package/docs/PLINJS_SPEC.md +0 -1151
  43. package/examples/arrays.ps +0 -13
  44. package/examples/start.ps +0 -2
  45. /package/examples/{day2.ps → day2.pln} +0 -0
  46. /package/examples/{day3.ps → day3.pln} +0 -0
  47. /package/examples/{hello.ps → hello.pln} +0 -0
  48. /package/examples/{objects.ps → objects.pln} +0 -0
  49. /package/examples/{server.ps → server.pln} +0 -0
  50. /package/examples/{web-app.ps → web-app.pln} +0 -0
  51. /package/examples/whatsapp-bot/{pairing.ps → pairing.pln} +0 -0
  52. /package/examples/whatsapp-bot/{qr.ps → qr.pln} +0 -0
package/docs/index.html CHANGED
@@ -35,7 +35,7 @@
35
35
  <a href="#" class="nav-logo">
36
36
  <img src="logo.jpg" alt="PlainScript Logo">
37
37
  <span class="logo-word">PlainScript</span>
38
- <span class="logo-ver">v1.0.1</span>
38
+ <span class="logo-ver">v1.0.2</span>
39
39
  </a>
40
40
  <div class="nav-links">
41
41
  <a href="#language">Language</a>
@@ -85,7 +85,7 @@
85
85
  <!-- Hero Section -->
86
86
  <section class="hero">
87
87
  <div class="hero-content">
88
- <div class="hero-badge">v1.0.1 — intent-oriented, TypeScript-capable</div>
88
+ <div class="hero-badge">v1.0.2: intent-oriented, TypeScript-capable</div>
89
89
  <h1 class="hero-title">
90
90
  Write code that<br>
91
91
  reads like <span class="green">Plain English</span>
@@ -105,7 +105,7 @@
105
105
  <span class="dot yellow"></span>
106
106
  <span class="dot green"></span>
107
107
  </div>
108
- <span class="code-window-title">app.ps</span>
108
+ <span class="code-window-title">app.pln</span>
109
109
  <button class="code-copy" aria-label="Copy code"><i class="far fa-copy"></i></button>
110
110
  </div>
111
111
  <div class="code-window-body">
@@ -114,7 +114,7 @@ route get "/"
114
114
  reply "Hello, World!"
115
115
  done
116
116
 
117
- show "Server is running"</code></pre>
117
+ print "Server is running"</code></pre>
118
118
  </div>
119
119
  </div>
120
120
  <div class="code-window">
@@ -174,13 +174,6 @@ console.log("Server is running");</code></pre>
174
174
  <h3 class="feature-title">Intent-Oriented</h3>
175
175
  <p class="feature-desc">Describe what you want. The compiler figures out the how.</p>
176
176
  </div>
177
- <div class="feature-card">
178
- <div class="feature-icon">
179
- <i class="fas fa-code"></i>
180
- </div>
181
- <h3 class="feature-title">JavaScript Gateway</h3>
182
- <p class="feature-desc">Embed raw JS with the javascript keyword when you need low-level control.</p>
183
- </div>
184
177
  <div class="feature-card">
185
178
  <div class="feature-icon">
186
179
  <i class="fas fa-cube"></i>
@@ -238,16 +231,16 @@ console.log("Server is running");</code></pre>
238
231
  <div class="code-window-body">
239
232
  <pre><code>web app
240
233
  route get "/"
241
- reply "Hello, World!"
234
+ print "Hello, World!"
242
235
  done
243
236
 
244
237
  route get "/users"
245
- reply json
238
+ print json
246
239
  count is 3
247
- done
248
- done
240
+ end
241
+ end
249
242
 
250
- show "Server running on port 3000"</code></pre>
243
+ print "Server running on port 3000"</code></pre>
251
244
  </div>
252
245
  </div>
253
246
  <div class="code-window">
@@ -300,7 +293,7 @@ app.listen(3000, () => {
300
293
  <pre><code>database "app.db"
301
294
 
302
295
  remember results as query
303
- SELECT * FROM users WHERE active = 1
296
+ SELECT * FROM users WHERE active = 1
304
297
  done
305
298
 
306
299
  for each user in results
@@ -349,7 +342,7 @@ results.forEach((user) => {
349
342
  <h3 class="step-title">Install</h3>
350
343
  <div class="code-block">
351
344
  <button class="code-copy" aria-label="Copy code"><i class="far fa-copy"></i></button>
352
- <pre><code>npm install -g plainscript-lang</code></pre>
345
+ <pre><code>npm install --save-dev plainscript-lang</code></pre>
353
346
  </div>
354
347
  </div>
355
348
  </div>
@@ -361,7 +354,7 @@ results.forEach((user) => {
361
354
  <button class="code-copy" aria-label="Copy code"><i class="far fa-copy"></i></button>
362
355
  <pre><code>plainscript new my-app</code></pre>
363
356
  </div>
364
- <p class="step-note">Then write your code in <code>src/app.ps</code></p>
357
+ <p class="step-note">Then write your code in <code>src/app.pln</code></p>
365
358
  </div>
366
359
  </div>
367
360
  <div class="quickstart-step">
@@ -378,7 +371,7 @@ results.forEach((user) => {
378
371
  </div>
379
372
  </section>
380
373
 
381
- <!-- CLI Section -->
374
+ <!-- CLI Section -->
382
375
  <section id="cli" class="section section--alt">
383
376
  <div class="container">
384
377
  <div class="section-tag">Command Line</div>
@@ -393,44 +386,48 @@ results.forEach((user) => {
393
386
  <div class="cli-desc">Build and execute your application in one step.</div>
394
387
  </div>
395
388
  <div class="cli-item">
396
- <div class="cli-cmd">plainscript new &lt;name&gt;</div>
389
+ <div class="cli-cmd">plainscript new <name></div>
397
390
  <div class="cli-desc">Scaffold a new PlainScript project with defaults.</div>
398
391
  </div>
399
392
  <div class="cli-item">
400
393
  <div class="cli-cmd">plainscript fmt</div>
401
394
  <div class="cli-desc">Auto-format all PlainScript files in your project.</div>
402
395
  </div>
396
+ <div class="cli-item">
397
+ <div class="cli-cmd">plainscript check</div>
398
+ <div class="cli-desc">Syntax check your code without emitting output.</div>
399
+ </div>
403
400
  <div class="cli-item">
404
401
  <div class="cli-cmd">plainscript doctor</div>
405
402
  <div class="cli-desc">Diagnose issues with your PlainScript installation.</div>
406
403
  </div>
407
404
  <div class="cli-item">
408
- <div class="cli-cmd">plainscript check</div>
409
- <div class="cli-desc">Type-check your code without emitting output.</div>
405
+ <div class="cli-cmd">plainscript install</div>
406
+ <div class="cli-desc">Install all detected dependencies.</div>
410
407
  </div>
411
408
  <div class="cli-item">
412
- <div class="cli-cmd">plainscript init</div>
413
- <div class="cli-desc">Initialize a plainscript.config.js in the current directory.</div>
409
+ <div class="cli-cmd">plainscript start</div>
410
+ <div class="cli-desc">Build src/app.pln and run its dist/ output.</div>
414
411
  </div>
415
412
  <div class="cli-item">
416
- <div class="cli-cmd">plainscript watch</div>
417
- <div class="cli-desc">Watch for file changes and recompile automatically.</div>
413
+ <div class="cli-cmd">plainscript add <pkg></div>
414
+ <div class="cli-desc">Add a package to your project.</div>
418
415
  </div>
419
416
  <div class="cli-item">
420
- <div class="cli-cmd">plainscript clean</div>
421
- <div class="cli-desc">Remove all compiled output and build artifacts.</div>
417
+ <div class="cli-cmd">plainscript remove <pkg></div>
418
+ <div class="cli-desc">Remove a package from your project.</div>
422
419
  </div>
423
420
  <div class="cli-item">
424
- <div class="cli-cmd">plainscript info</div>
425
- <div class="cli-desc">Display version, platform, and runtime information.</div>
421
+ <div class="cli-cmd">plainscript update</div>
422
+ <div class="cli-desc">Update all installed npm packages.</div>
426
423
  </div>
427
424
  <div class="cli-item">
428
- <div class="cli-cmd">plainscript test</div>
429
- <div class="cli-desc">Run your PlainScript test suite.</div>
425
+ <div class="cli-cmd">plainscript version</div>
426
+ <div class="cli-desc">Print the compiler version.</div>
430
427
  </div>
431
428
  <div class="cli-item">
432
- <div class="cli-cmd">plainscript repl</div>
433
- <div class="cli-desc">Launch the interactive PlainScript REPL shell.</div>
429
+ <div class="cli-cmd">plainscript help</div>
430
+ <div class="cli-desc">Print help text.</div>
434
431
  </div>
435
432
  </div>
436
433
  </div>
@@ -551,12 +548,6 @@ use dotenv</code></pre>
551
548
  <p>Yes. PlainScript includes first-class SQLite support with the <code>database</code>, <code>query</code>, and <code>insert</code> keywords. It works with both native SQLite and WebAssembly builds.</p>
552
549
  </div>
553
550
  </details>
554
- <details class="faq-item">
555
- <summary class="faq-question">Can I mix PlainScript and JavaScript?</summary>
556
- <div class="faq-answer">
557
- <p>Absolutely. Use the <code>javascript</code> keyword to embed raw JavaScript directly in your PlainScript files. This gives you full access to JavaScript when you need low-level control.</p>
558
- </div>
559
- </details>
560
551
  <details class="faq-item">
561
552
  <summary class="faq-question">Is PlainScript production-ready?</summary>
562
553
  <div class="faq-answer">
@@ -607,7 +598,7 @@ use dotenv</code></pre>
607
598
  </div>
608
599
  <div class="footer-bottom">
609
600
  <p>&copy; 2026 PlainScript. Built by Ayokunle.</p>
610
- <span class="footer-badge">v1.0.1</span>
601
+ <span class="footer-badge">v1.0.2</span>
611
602
  </div>
612
603
  </div>
613
604
  </footer>
@@ -2,13 +2,75 @@ function initSyntaxHighlighting() {
2
2
  var codeBlocks = document.querySelectorAll('.code-window-body code, .code-block code, .code-block--wide code');
3
3
 
4
4
  var PS_KEYWORDS = {
5
- 'use':1,'server':1,'when':1,'someone':1,'asks':1,'for':1,'send':1,'log':1,
5
+ 'let':1,'is':1,'print':1,'define':1,'function':1,'give':1,'back':1,'return':1,
6
+ 'if':1,'else':1,'end':1,'done':1,'database':1,'query':1,'insert':1,'into':1,'values':1,'each':1,
7
+ 'in':1,'while':1,'not':1,'and':1,'or':1,'greater':1,'less':1,'than':1,
8
+ 'true':1,'false':1,'null':1,'none':1,
9
+ 'import':1,'from':1,'export':1,'class':1,'new':1,'this':1,'with':1,'do':1,
10
+ 'try':1,'catch':1,'throw':1,'async':1,'await':1,
11
+ 'use':1,'server':1,'when':1,'someone':1,'visits':1,'for':1,'send':1,'log':1,
6
12
  'save':1,'as':1,'if':1,'else':1,'then':1,'end':1,'function':1,'returns':1,
7
13
  'return':1,'database':1,'query':1,'insert':1,'into':1,'values':1,'each':1,
8
- 'in':1,'while':1,'let':1,'be':1,'not':1,'and':1,'or':1,'equals':1,'greater':1,
14
+ 'in':1,'while':1,'not':1,'and':1,'or':1,'equals':1,'greater':1,
9
15
  'less':1,'than':1,'true':1,'false':1,'null':1,'none':1,'javascript':1,
10
16
  'import':1,'from':1,'export':1,'class':1,'new':1,'this':1,'with':1,'do':1,
11
- 'try':1,'catch':1,'throw':1,'async':1,'await':1
17
+ 'try':1,'catch':1,'throw':1,'async':1,'await':1,
18
+ 'is':1,'now':1,'now':1,'contains':1,'starts':1,'ends':1,'with':1,
19
+ 'between':1,'above':1,'below':1,'at':1,'least':1,'most':1,'empty':1,
20
+ 'not':1,'and':1,'or':1,'is':1,'equal':1,'to':1,
21
+ 'route':1,'group':1,'start':1,'run':1,'on':1,'listen':1,'reply':1,'serve':1,'folder':1,
22
+ 'web':1,'app':1,'allow':1,'cors':1,'status':1,'redirect':1,'to':1,
23
+ 'json':1,'show':1,'ask':1,'ocr':1,'using':1,'yield':1,'symbol':1,
24
+ 'debugger':1,'import':1,'meta':1,'include':1,'load':1,
25
+ 'define':1,'kind':1,'called':1,'extends':1,'export':1,'test':1,'check':1,
26
+ 'raises':1,'equals':1,'contains':1,'spread':1,'of':1,'all':1,'any':1,'settled':1,
27
+ 'wait':1,'for':1,'retry':1,'times':1,'every':1,'seconds':1,
28
+ 'accept':1,'uploads':1,'limit':1,'allow':1,'folder':1,'require':1,'api':1,'key':1,
29
+ 'enable':1,'sessions':1,'destroy':1,'session':1,'cookie':1,'expires':1,'in':1,'days':1,
30
+ 'clear':1,'rate':1,'limit':1,'requests':1,'per':1,'minute':1,'google':1,'oauth':1,
31
+ 'id':1,'secret':1,'callback':1,'landing':1,'postgres':1,'env':1,
32
+ 'execute':1,'update':1,'delete':1,'transaction':1,'connect':1,'database':1,
33
+ 'cache':1,'get':1,'set':1,'delete':1,'mail':1,'transport':1,'send':1,'mail':1,
34
+ 'from':1,'to':1,'subject':1,'text':1,'every':1,'minutes':1,'schedule':1,
35
+ 'run':1,'background':1,'websocket':1,'server':1,'on':1,'socket':1,'connects':1,
36
+ 'sends':1,'message':1,'disconnects':1,'send':1,'broadcast':1,
37
+ 'cache':1,'env':1,'redis':1,'chat':1,'embed':1,'text':1,'similarity':1,
38
+ 'tags':1,'post':1,'paginate':1,'items':1,'count':1,'page':1,'pages':1,'per':1,'hasNext':1,'hasPrev':1,
39
+ 'import':1,'include':1,'load':1,'define':1,'kind':1,'called':1,'extends':1,
40
+ 'create':1,'a':1,'with':1,'test':1,'name':1,'check':1,'equals':1,'contains':1,
41
+ 'is':1,'raises':1,'spread':1,'of':1,'all':1,'any':1,'settled':1,'withTimeout':1,
42
+ 'loadModule':1,'args':1,'runCommand':1,'withTimeout':1,'typeOf':1,'fieldsOf':1,
43
+ 'hasField':1,'valueOf':1,'sizeOf':1,'base64Encode':1,'base64Decode':1,'textToBytes':1,
44
+ 'bytesToText':1,'sha256':1,'sha1':1,'md5':1,'yamlDecode':1,'yamlEncode':1,
45
+ 'loadEnvFile':1,'args':1,'runCommand':1,'withTimeout':1,'spread':1,'keyMap':1,
46
+ 'mapSet':1,'mapGet':1,'mapHas':1,'mapDelete':1,'newSet':1,'addToSet':1,'removeFromSet':1,'setHas':1,
47
+ 'fileSize':1,'fileType':1,'lastModified':1,'walkFolder':1,'joinPath':1,'baseName':1,'folderOf':1,'extensionOf':1,
48
+ 'writeLine':1,'appendLine':1,'abs':1,'min':1,'max':1,'sqrt':1,'pow':1,'floor':1,'ceil':1,'round':1,
49
+ 'trunc':1,'sign':1,'random':1,'randomInt':1,'clamp':1,'lerp':1,'PI':1,'E':1,'ln2':1,'ln10':1,
50
+ 'log2e':1,'log10e':1,'sin':1,'cos':1,'tan':1,'asin':1,'acos':1,'atan':1,'atan2':1,
51
+ 'sinh':1,'cosh':1,'tanh':1,'exp':1,'expm1':1,'log':1,'log1p':1,'log2':1,'log10':1,
52
+ 'hypot':1,'cbrt':1,'trim':1,'trimStart':1,'trimEnd':1,'toUpperCase':1,'toLowerCase':1,
53
+ 'charAt':1,'charCodeAt':1,'codePointAt':1,'slice':1,'substring':1,'substr':1,
54
+ 'indexOf':1,'lastIndexOf':1,'includes':1,'startsWith':1,'endsWith':1,'repeat':1,
55
+ 'padStart':1,'padEnd':1,'split':1,'join':1,'replace':1,'replaceAll':1,'match':1,'matchAll':1,
56
+ 'search':1,'toString':1,'valueOf':1,'push':1,'pop':1,'shift':1,'unshift':1,'splice':1,
57
+ 'concat':1,'slice':1,'copyWithin':1,'fill':1,'find':1,'findIndex':1,'findLast':1,'findLastIndex':1,
58
+ 'indexOf':1,'lastIndexOf':1,'includes':1,'join':1,'reverse':1,'sort':1,'flat':1,'flatMap':1,
59
+ 'map':1,'filter':1,'reduce':1,'reduceRight':1,'forEach':1,'some':1,'every':1,'at':1,'with':1,
60
+ 'toSorted':1,'toReversed':1,'toSpliced':1,'keys':1,'values':1,'entries':1,
61
+ 'assign':1,'create':1,'defineProperty':1,'defineProperties':1,'getOwnPropertyDescriptor':1,
62
+ 'getOwnPropertyDescriptors':1,'getOwnPropertyNames':1,'getOwnPropertySymbols':1,
63
+ 'getPrototypeOf':1,'setPrototypeOf':1,'objectIs':1,'isExtensible':1,'isFrozen':1,'isSealed':1,
64
+ 'preventExtensions':1,'freeze':1,'seal':1,'hasOwn':1,'Promise':1,'resolve':1,'reject':1,'all':1,
65
+ 'allSettled':1,'race':1,'any':1,'await':1,'sleep':1,'timeout':1,'jsonParse':1,'stringify':1,
66
+ 'isArray':1,'isInteger':1,'isNaN':1,'isFinite':1,'isSafeInteger':1,'parseInt':1,'parseFloat':1,
67
+ 'arrayFrom':1,'arrayOf':1,'arrayIsArray':1,'objectFromEntries':1,'objectGetOwnPropertySymbols':1,
68
+ 'objectGetOwnPropertyDescriptors':1,'objectGetPrototypeOf':1,'objectSetPrototypeOf':1,
69
+ 'objectIs':1,'objectCreate':1,'objectAssign':1,'objectKeys':1,'objectValues':1,'objectEntries':1,
70
+ 'objectHasOwn':1,'objectDefineProperty':1,'objectDefineProperties':1,'objectGetOwnPropertyDescriptor':1,
71
+ 'objectGetOwnPropertyNames':1,'objectIsExtensible':1,'objectIsFrozen':1,'objectIsSealed':1,
72
+ 'objectPreventExtensions':1,'objectFreeze':1,'objectSeal':1,'symbol':1,'symbolFor':1,'symbolKeyFor':1,
73
+ 'symbolIterator':1
12
74
  };
13
75
 
14
76
  var JS_KEYWORDS = {
@@ -699,8 +761,8 @@ var LIBRARY = [
699
761
  {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
762
  {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
763
  {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}'},
702
- {cat:"functions",name:"Define Function",desc:"Create a reusable block of code",ps:'make greet(name)\n show `Hello ${name}!`\ndone\n\ngreet("Ayokunle")',js:'function greet(name) {\n console.log(`Hello ${name}!`);\n}\n\ngreet("Ayokunle");'},
703
- {cat:"functions",name:"Return Value",desc:"Return a value from a function",ps:'make add(a, b)\n give a + b\ndone\n\nremember result as add(5, 7)\nshow result',js:'function add(a, b) {\n return a + b;\n}\n\nlet result = add(5, 7);\nconsole.log(result);'},
764
+ {cat:"functions",name:"Define Function",desc:"Create a reusable block of code",ps:'to greet(name)\n show `Hello ${name}!`\ndone\n\ngreet("Ayokunle")',js:'function greet(name) {\n console.log(`Hello ${name}!`);\n}\n\ngreet("Ayokunle");'},
765
+ {cat:"functions",name:"Return Value",desc:"Return a value from a function",ps:'to add(a, b)\n give a + b\ndone\n\nremember result as add(5, 7)\nshow result',js:'function add(a, b) {\n return a + b;\n}\n\nlet result = add(5, 7);\nconsole.log(result);'},
704
766
  {cat:"arrays",name:"Array Literal",desc:"Create an array of values",ps:'remember colors as ["red", "green", "blue"]\nremember nums as [1, 2, 3, 4, 5]',js:'let colors = ["red", "green", "blue"];\nlet nums = [1, 2, 3, 4, 5];'},
705
767
  {cat:"arrays",name:"Access Elements",desc:"Get items by index (one-based English syntax)",ps:'remember items as ["a", "b", "c"]\nshow first item from items\nshow last item from items\nshow items[0]',js:'let items = ["a", "b", "c"];\nconsole.log(items[0]);\nconsole.log(items[items.length - 1]);\nconsole.log(items[0]);'},
706
768
  {cat:"arrays",name:"Add / Remove Items",desc:"Push to or splice from an array",ps:'remember list as [1, 2, 3]\nadd(4 to list)\nremove(2 from list)',js:'let list = [1, 2, 3];\nlist.push(4);\nlist.splice(list.indexOf(2), 1);'},
@@ -710,7 +772,7 @@ var LIBRARY = [
710
772
  {cat:"objects",name:"Object Utilities",desc:"Get keys, values, check properties, merge objects",ps:'remember user as\n name is "Ayo"\n age is 25\ndone\n\nshow keys(user)\nshow values(user)\nshow hasKey(user, "name")\n\nremember merged as merge(user, { city: "Lagos" })',js:'let user = {\n "name": "Ayo",\n "age": 25\n};\n\nconsole.log(Object.keys(user));\nconsole.log(Object.values(user));\nconsole.log(Object.prototype.hasOwnProperty.call(user, "name"));\n\nlet merged = { ...user, ...{ "city": "Lagos" } };'},
711
773
  {cat:"imports",name:"Use npm Package",desc:"Import any npm package with the use keyword",ps:'use express\nuse axios\nuse dotenv\nuse chalk',js:'const express = require(\'express\');\nconst axios = require(\'axios\');\nrequire(\'dotenv\').config();\nconst chalk = require(\'chalk\');'},
712
774
  {cat:"imports",name:"Use with Alias",desc:"Import a package under a different name",ps:'use node-fetch as fetch',js:'const fetch = require(\'node-fetch\');'},
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'},
775
+ {cat:"imports",name:"Import .pln File",desc:"Import another PlainScript file",ps:'import "./utils.pln"\nimport "./database.pln"',js:'// Bundled in dependency order at compile time'},
714
776
  {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
777
  {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
778
  {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},
@@ -753,20 +815,44 @@ var LIBRARY = [
753
815
  {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
816
  {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
817
  {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',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},
818
+ {cat:"cli",name:"CLI: new",desc:"Scaffold a new PlainScript project",ps:'plainscript new my-app',js:'// Creates my-app/ with src/app.pln and package.json',skipRun:true},
819
+ {cat:"cli",name:"CLI: run",desc:"Compile and execute a PlainScript file",ps:'plainscript run src/app.pln',js:'// Compiles src/app.pln and runs the output',skipRun:true},
820
+ {cat:"cli",name:"CLI: build",desc:"Compile .pln files to JavaScript",ps:'plainscript build',js:'// Compiles src/app.pln to dist/app.js',skipRun:true},
821
+ {cat:"cli",name:"CLI: fmt",desc:"Auto-format PlainScript code",ps:'plainscript fmt src/app.pln',js:'// Formats src/app.pln in place',skipRun:true},
760
822
  {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},
823
+ {cat:"cli",name:"CLI: check",desc:"Type-check without emitting output",ps:'plainscript check src/app.pln',js:'// Validates syntax without compiling',skipRun:true},
824
+ {cat:"cli",name:"CLI: watch",desc:"Watch files and recompile on change",ps:'plainscript watch',js:'// Starts file watcher for .pln files',skipRun:true},
763
825
  {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
- {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})();',skipRun:true},
766
826
  {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
827
  {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
828
  {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 v1.0.1',skipRun:true},
829
+ {cat:"cli",name:"CLI: version",desc:"Print the PlainScript version",ps:'plainscript version',js:'// Prints v1.0.2',skipRun:true},
830
+ {cat:"datetime",name:"Create Date",desc:"Create a new Date object from ISO string, timestamp, or components",ps:'remember d as newDate()\nremember d2 as newDate("2026-08-28")\nremember d3 as newDate(2026, 8, 28, 12, 0, 0)',js:'let d = new Date();\nlet d2 = new Date("2026-08-28");\nlet d3 = new Date(2026, 7, 28, 12, 0, 0);'},
831
+ {cat:"datetime",name:"Current Time",desc:"Get current timestamp in milliseconds or seconds",ps:'remember ms as now()\nremember sec as nowSec()',js:'let ms = Date.now();\nlet sec = Math.floor(Date.now() / 1000);'},
832
+ {cat:"datetime",name:"Date Components",desc:"Extract year, month, day, hour, minute, second from a Date",ps:'remember d as newDate()\nshow year(d)\nshow month(d)\nshow day(d)\nshow hours(d)\nshow minutes(d)\nshow seconds(d)',js:'let d = new Date();\nconsole.log(d.getFullYear());\nconsole.log(d.getMonth() + 1);\nconsole.log(d.getDate());\nconsole.log(d.getHours());\nconsole.log(d.getMinutes());\nconsole.log(d.getSeconds());'},
833
+ {cat:"datetime",name:"Date Formatting",desc:"Format dates as ISO, locale, UTC, or custom patterns",ps:'remember d as newDate()\nshow toISO(d)\nshow toLocaleDate(d)\nshow toLocaleTime(d)\nshow toUTC(d)\nshow format(d, "YYYY-MM-DD HH:mm:ss")',js:'let d = new Date();\nconsole.log(d.toISOString());\nconsole.log(d.toLocaleDateString());\nconsole.log(d.toLocaleTimeString());\nconsole.log(d.toUTCString());\n// Custom format via __formatDate helper'},
834
+ {cat:"datetime",name:"Date Arithmetic",desc:"Add, subtract, and diff dates with units (ms, s, m, h, d, w, mo, y)",ps:'remember d as newDate()\nremember tomorrow as addTime(d, 1, "d")\nremember yesterday as subTime(d, 1, "d")\nshow diffTime(tomorrow, d, "h")',js:'let d = new Date();\nlet tomorrow = new Date(d.getTime() + 86400000);\nlet yesterday = new Date(d.getTime() - 86400000);\nconsole.log((tomorrow - d) / 3600000);'},
835
+ {cat:"datetime",name:"Date Boundaries",desc:"Get start/end of day, month, year for a Date",ps:'remember d as newDate()\nshow startOfDay(d)\nshow endOfDay(d)\nshow startOfMonth(d)\nshow endOfMonth(d)\nshow startOfYear(d)\nshow endOfYear(d)',js:'let d = new Date();\nlet startOfDay = new Date(d); startOfDay.setHours(0,0,0,0);\nlet endOfDay = new Date(d); endOfDay.setHours(23,59,59,999);\n// Similar for month/year boundaries'},
836
+ {cat:"regex",name:"Create Regex",desc:"Create a RegExp from a pattern string with optional flags",ps:'remember r as regex("\\d+", "g")',js:'let r = new RegExp("\\d+", "g");'},
837
+ {cat:"regex",name:"Test Match",desc:"Check if a string matches a regex pattern",ps:'show matches("abc123", "\\d+")',js:'console.log(new RegExp("\\d+").test("abc123"));'},
838
+ {cat:"regex",name:"Extract Match",desc:"Get the first match of a regex in a string",ps:'remember m as regexMatch("abc123", "\\d+")',js:'let m = "abc123".match(new RegExp("\\d+"));'},
839
+ {cat:"regex",name:"Extract All Matches",desc:"Get all matches of a regex in a string",ps:'remember all as regexMatchAll("a1b2c3", "\\d+")',js:'let all = Array.from("a1b2c3".matchAll(new RegExp("\\d+", "g")));'},
840
+ {cat:"regex",name:"Replace with Regex",desc:"Replace using regex with capture group support",ps:'remember replaced as replaceRegex("abc123", "\\d+", "X")',js:'let replaced = "abc123".replace(new RegExp("\\d+"), "X");'},
841
+ {cat:"regex",name:"Split by Regex",desc:"Split a string using a regex pattern",ps:'remember parts as splitRegex("a,b;c", "[,;]")',js:'let parts = "a,b;c".split(new RegExp("[,;]"));'},
842
+ {cat:"numbers",name:"Math Constants",desc:"Access PI, E, LN2, LN10, LOG2E, LOG10E",ps:'show PI()\nshow E()\nshow ln2()',js:'console.log(Math.PI);\nconsole.log(Math.E);\nconsole.log(Math.LN2);'},
843
+ {cat:"numbers",name:"Trigonometry",desc:"sin, cos, tan, asin, acos, atan, atan2, sinh, cosh, tanh",ps:'show sin(0)\nshow cos(0)\nshow atan2(1, 1)',js:'console.log(Math.sin(0));\nconsole.log(Math.cos(0));\nconsole.log(Math.atan2(1, 1));'},
844
+ {cat:"numbers",name:"Exponential & Logarithmic",desc:"exp, expm1, log, log1p, log2, log10, pow, sqrt, cbrt, hypot",ps:'show exp(1)\nshow log(10)\nshow log2(8)\nshow sqrt(16)\nshow pow(2, 3)',js:'console.log(Math.exp(1));\nconsole.log(Math.log(10));\nconsole.log(Math.log2(8));\nconsole.log(Math.sqrt(16));\nconsole.log(Math.pow(2, 3));'},
845
+ {cat:"numbers",name:"Random Integers",desc:"Generate random integers in a range",ps:'show randomInt(1, 100)',js:'console.log(Math.floor(Math.random() * 100) + 1);'},
846
+ {cat:"numbers",name:"Clamp & Lerp",desc:"Clamp a value between min/max, linear interpolation",ps:'show clamp(5, 0, 10)\nshow lerp(0, 100, 0.5)',js:'console.log(Math.min(Math.max(5, 0), 10));\nconsole.log(0 + (100 - 0) * 0.5);'},
847
+ {cat:"strings",name:"Extended String Methods",desc:"slice, substring, indexOf, lastIndexOf, startsWith, endsWith, includes, repeat, padStart, padEnd",ps:'show slice("hello", 1, 4)\nshow indexOf("hello", "l")\nshow startsWith("hello", "he")\nshow repeat("ha", 3)\nshow padStart("5", 3, "0")',js:'console.log("hello".slice(1, 4));\nconsole.log("hello".indexOf("l"));\nconsole.log("hello".startsWith("he"));\nconsole.log("ha".repeat(3));\nconsole.log("5".padStart(3, "0"));'},
848
+ {cat:"arrays",name:"Array Methods",desc:"push, pop, shift, unshift, splice, concat, slice, find, filter, map, reduce, some, every, flat, flatMap, at, with, toSorted, toReversed",ps:'remember arr as [3, 1, 4]\nshow push(arr, 9)\nshow filter(arr, x => x > 2)\nshow map(arr, x => x * 2)\nshow reduce(arr, (a, b) => a + b, 0)',js:'let arr = [3, 1, 4];\narr.push(9);\nconsole.log(arr.filter(x => x > 2));\nconsole.log(arr.map(x => x * 2));\nconsole.log(arr.reduce((a, b) => a + b, 0));'},
849
+ {cat:"objects",name:"Object Methods",desc:"assign, create, defineProperty, getOwnPropertyNames, getPrototypeOf, setPrototypeOf, is, isExtensible, freeze, seal, hasOwn",ps:'show assign({}, {a: 1}, {b: 2})\nshow hasOwn({a: 1}, "a")\nshow objectIs({}, {})\nshow freeze({})',js:'console.log(Object.assign({}, {a: 1}, {b: 2}));\nconsole.log(Object.hasOwn({a: 1}, "a"));\nconsole.log(Object.is({}, {}));\nconsole.log(Object.freeze({}));'},
850
+ {cat:"async",name:"Promise Utilities",desc:"Promise.resolve, Promise.all, Promise.race, Promise.any, Promise.allSettled",ps:'remember p as promiseAll([1, 2, 3])\nremember r as promiseRace([1, 2, 3])',js:'let p = Promise.all([1, 2, 3]);\nlet r = Promise.race([1, 2, 3]);'},
851
+ {cat:"async",name:"Async Sleep & Timeout",desc:"Sleep for milliseconds, wrap promises with timeout",ps:'sleep(1000)\nremember result as timeout(fetchData(), 5000)',js:'await new Promise(r => setTimeout(r, 1000));\nlet result = await Promise.race([fetchData(), new Promise((_, r) => setTimeout(() => r(new Error("timeout")), 5000))]);'},
852
+ {cat:"async",name:"Await Helper",desc:"Explicitly await a promise in any context",ps:'remember data as await fetch("https://api.example.com")',js:'let data = await fetch("https://api.example.com");'},
853
+ {cat:"json",name:"JSON Parse / Stringify",desc:"Parse JSON strings and stringify values with options",ps:'remember obj as jsonParse("{\"a\": 1}")\nshow stringify(obj)\nshow stringify(obj, null, 2)',js:'let obj = JSON.parse("{\\"a\\": 1}");\nconsole.log(JSON.stringify(obj));\nconsole.log(JSON.stringify(obj, null, 2));'},
854
+ {cat:"types",name:"Type Checks",desc:"isArray, isInteger, isNaN, isFinite, isSafeInteger, parseInt, parseFloat",ps:'show isArray([1,2,3])\nshow isInteger(5)\nshow isNaN(NaN)\nshow parseInt("42")',js:'console.log(Array.isArray([1,2,3]));\nconsole.log(Number.isInteger(5));\nconsole.log(Number.isNaN(NaN));\nconsole.log(parseInt("42"));'},
855
+ {cat:"globals",name:"Global Objects",desc:"Access globalThis, console, process, Buffer directly",ps:'show globalThis()\nshow console()\nshow process()\nshow Buffer()',js:'console.log(globalThis);\nconsole.log(console);\nconsole.log(process);\nconsole.log(Buffer);'},
770
856
  {cat:"cli",name:"CLI: help",desc:"Show available commands",ps:'plainscript help',js:'// Lists all CLI commands',skipRun:true},
771
857
  {cat:"cli",name:"CLI: info",desc:"Display platform and runtime info",ps:'plainscript info',js:'// Shows version, Node version, OS',skipRun:true},
772
858
  {cat:"cli",name:"CLI: clean",desc:"Remove compiled output",ps:'plainscript clean',js:'// Deletes dist/ folder',skipRun:true},
@@ -783,12 +869,12 @@ var LIBRARY = [
783
869
  {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
870
  {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
871
  {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);'},
872
+ {cat:"async",name:"Parallel Async",desc:"Run multiple async operations concurrently",ps:'to slowJob()\n sleep(10)\n give "slow"\ndone\nto 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
873
  {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
874
  {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
875
  {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
876
  {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");'},
877
+ {cat:"functions",name:"Default Parameters",desc:"Provide fallback values for function arguments",ps:'to 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
878
  {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
879
  {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
880
  {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}'},
@@ -797,14 +883,14 @@ var LIBRARY = [
797
883
  {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
884
  {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
885
  {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);'},
886
+ {cat:"concurrency",name:"All Of (Promise.all)",desc:"Await every promise and collect results",ps:'to fetchA()\n give "a"\ndone\nto 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);'},
887
+ {cat:"concurrency",name:"Any Of (Promise.race)",desc:"Resolve with the first promise to settle",ps:'to slow()\n give "slow"\ndone\nto 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);'},
888
+ {cat:"concurrency",name:"Settled Of (Promise.allSettled)",desc:"Await all promises; each yields status/value/reason",ps:'to 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);'},
889
+ {cat:"concurrency",name:"With Timeout",desc:"Reject a promise if it does not settle in time",ps:'to 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");'},
890
+ {cat:"async",name:"Await (wait for)",desc:"Await a promise to get its resolved value",ps:'to fetchData()\n give 42\ndone\nremember value as wait for fetchData()\nshow value',js:'let value = (await fetchData());\nconsole.log(value);'},
805
891
  {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
892
  {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)]);'},
893
+ {cat:"generators",name:"Yield Generator",desc:"yield inside make makes a generator",ps:'to 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
894
  {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
895
  {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
896
  {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)'},
@@ -833,7 +919,7 @@ var LIBRARY = [
833
919
  {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
920
  {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
921
  {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();'},
922
+ {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\nto 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
923
  {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
924
  {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
925
  {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);'},
@@ -576,7 +576,7 @@ pre{font-family:var(--font-mono);font-size:.875rem;line-height:1.7;overflow-x:au
576
576
  }
577
577
 
578
578
  /* ═══════════════════════════════
579
- RESPONSIVE — 1024px
579
+ RESPONSIVE: 1024px
580
580
  ═══════════════════════════════ */
581
581
  @media(max-width:1024px){
582
582
  .features-grid{grid-template-columns:repeat(2,1fr)}
@@ -584,7 +584,7 @@ pre{font-family:var(--font-mono);font-size:.875rem;line-height:1.7;overflow-x:au
584
584
  }
585
585
 
586
586
  /* ═══════════════════════════════
587
- RESPONSIVE — 800px
587
+ RESPONSIVE: 800px
588
588
  ═══════════════════════════════ */
589
589
  @media(max-width:800px){
590
590
  .hero{padding:calc(var(--nav-h) + 48px) 0 64px}
@@ -604,7 +604,7 @@ pre{font-family:var(--font-mono);font-size:.875rem;line-height:1.7;overflow-x:au
604
604
  }
605
605
 
606
606
  /* ═══════════════════════════════
607
- RESPONSIVE — 600px
607
+ RESPONSIVE: 600px
608
608
  ═══════════════════════════════ */
609
609
  @media(max-width:600px){
610
610
  .section{padding:48px 16px}
@@ -623,7 +623,7 @@ pre{font-family:var(--font-mono);font-size:.875rem;line-height:1.7;overflow-x:au
623
623
  }
624
624
 
625
625
  /* ═══════════════════════════════
626
- RESPONSIVE — 480px
626
+ RESPONSIVE: 480px
627
627
  ═══════════════════════════════ */
628
628
  @media(max-width:480px){
629
629
  .hero-title{font-size:1.8rem}
@@ -0,0 +1,12 @@
1
+ remember players as list with
2
+ "Haaland",
3
+ "Foden",
4
+ "Rodri"
5
+
6
+ show players at position 0
7
+
8
+ players at position 1 becomes "Palmer"
9
+
10
+ show players at position 1
11
+
12
+ show length(players)
@@ -1,6 +1,6 @@
1
- // PlainScript v1.0.1 — API key protection, rate limits and tokens
1
+ // PlainScript v1.0.2 — API key protection, rate limits and tokens
2
2
  //
3
- // Run with: API_KEY=my-secret plainscript run examples/auth-api.ps
3
+ // Run with: API_KEY=my-secret plainscript run examples/auth-api.pln
4
4
  // Then try:
5
5
  // curl -H "x-api-key: my-secret" http://localhost:3000/status
6
6
  // curl http://localhost:3000/status # 401 without the key
@@ -22,7 +22,7 @@ remember secret as env("TOKEN_SECRET")
22
22
  route get "/status"
23
23
  reply json
24
24
  status is "ok"
25
- version is "1.0.1"
25
+ version is "1.0.2"
26
26
  done
27
27
  done
28
28
 
@@ -1,6 +1,6 @@
1
1
  // PlainScript v2.1 — Cache, background jobs and cron working together
2
2
  //
3
- // Run with: REDIS_URL=redis://localhost:6379 plainscript run examples/cache-and-jobs.ps
3
+ // Run with: REDIS_URL=redis://localhost:6379 plainscript run examples/cache-and-jobs.pln
4
4
  //
5
5
  // Heavy work is pushed off the request path with "run background", shared
6
6
  // state lives in Redis, and a cron job refreshes it every minute.
@@ -1,18 +1,18 @@
1
- // PlainScript v1.0.1 — Concurrency: combinators, timeouts and workers
1
+ // PlainScript v1.0.2 — Concurrency: combinators, timeouts and workers
2
2
  //
3
- // Run with: plainscript run examples/concurrency.ps
3
+ // Run with: plainscript run examples/concurrency.pln
4
4
  //
5
5
  // all / any / settled run several promises in parallel; withTimeout bounds
6
6
  // how long one may take; run background fires work without blocking.
7
7
 
8
8
  make fetchUsers()
9
9
  sleep(300)
10
- give { source: "users", count: 42 }
10
+ give record with source "users" and count 42 done
11
11
  done
12
12
 
13
13
  make fetchOrders()
14
14
  sleep(150)
15
- give { source: "orders", count: 17 }
15
+ give record with source "orders" and count 17 done
16
16
  done
17
17
 
18
18
  make flakyFetch()
@@ -21,17 +21,17 @@ make flakyFetch()
21
21
  done
22
22
 
23
23
  // Every item must resolve — an array of results
24
- remember dashboard as all of [fetchUsers(), fetchOrders()]
24
+ remember dashboard as all of list with fetchUsers(), fetchOrders()
25
25
  for each panel in dashboard
26
26
  show source of panel + ": " + text(count of panel)
27
27
  done
28
28
 
29
29
  // First to settle wins
30
- remember first as any of [fetchUsers(), fetchOrders()]
30
+ remember first as any of list with fetchUsers(), fetchOrders()
31
31
  show "first: " + source of first
32
32
 
33
33
  // Never throws; each outcome is a record with a status
34
- remember results as settled of [fetchUsers(), flakyFetch()]
34
+ remember results as settled of list with fetchUsers(), flakyFetch()
35
35
  for each outcome in results
36
36
  if status of outcome is "fulfilled"
37
37
  show "ok: " + text(value of outcome)
@@ -46,4 +46,4 @@ show "bounded result ready"
46
46
 
47
47
  // Fire-and-forget background work
48
48
  run background fetchUsers()
49
- show "background job launched — this line prints immediately"
49
+ show "background job launched — this line prints immediately"
@@ -1,6 +1,6 @@
1
1
  // PlainScript v2.1 — Databases: SQLite, parameters and transactions
2
2
  //
3
- // Run with: plainscript run examples/database.ps
3
+ // Run with: plainscript run examples/database.pln
4
4
  //
5
5
  // SQL placeholders are written {likeThis} and bind to PlainScript variables of
6
6
  // the same name. A transaction block runs all enclosed writes atomically.
@@ -1,7 +1,7 @@
1
- // PlainScript v1.0.1 — runtime dependency and deployment example
1
+ // PlainScript v1.0.2 — runtime dependency and deployment example
2
2
  //
3
3
  // `plainscript build` and `plainscript run` detect express from `web app` and install it
4
- // when it is missing. `plainscript start` builds src/app.ps by default.
4
+ // when it is missing. `plainscript start` builds src/app.pln by default.
5
5
 
6
6
  web app
7
7
 
@@ -1,6 +1,6 @@
1
1
  // PlainScript v2.1 — Sending email
2
2
  //
3
- // Run with: MAIL_PASS=secret plainscript run examples/email-send.ps
3
+ // Run with: MAIL_PASS=secret plainscript run examples/email-send.pln
4
4
  //
5
5
  // Configure the outgoing transport once, then send as many mails as you
6
6
  // like. Credentials come from the environment — never hardcode them.