plainscript-lang 1.0.2 → 1.0.3

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 (74) hide show
  1. package/README.md +173 -738
  2. package/compiler/bundler.js +83 -12
  3. package/compiler/cli.js +74 -27
  4. package/compiler/dependency-detector.js +11 -0
  5. package/compiler/generator.js +372 -35
  6. package/compiler/lexer.js +2 -0
  7. package/compiler/parser.js +410 -28
  8. package/compiler/sourcemap.js +142 -0
  9. package/compiler/version.js +1 -1
  10. package/docs/CAPABILITY_GAP_AUDIT.md +98 -534
  11. package/docs/PLAINSCRIPT-SPEC.md +304 -551
  12. package/docs/index.html +127 -598
  13. package/docs/website/script.js +185 -1006
  14. package/docs/website/style.css +220 -656
  15. package/examples/ai-providers.pln +7 -0
  16. package/examples/arrays.pln +4 -12
  17. package/examples/async-errors.pln +18 -0
  18. package/examples/auth-api.pln +3 -50
  19. package/examples/auth-sessions.pln +32 -0
  20. package/examples/basics.pln +14 -0
  21. package/examples/bots.pln +13 -0
  22. package/examples/cache-and-jobs.pln +6 -28
  23. package/examples/cache-schedule.pln +22 -0
  24. package/examples/collections.pln +15 -0
  25. package/examples/concurrency.pln +12 -43
  26. package/examples/conditions.pln +22 -0
  27. package/examples/database.pln +6 -39
  28. package/examples/day2.pln +6 -6
  29. package/examples/day3.pln +4 -10
  30. package/examples/deployment.pln +3 -9
  31. package/examples/email-send.pln +3 -22
  32. package/examples/error-handling.pln +6 -54
  33. package/examples/expressions.pln +7 -40
  34. package/examples/file-uploads.pln +5 -34
  35. package/examples/files-and-config.pln +5 -46
  36. package/examples/files.pln +12 -0
  37. package/examples/football-backend/app.pln +21 -20
  38. package/examples/functions.pln +17 -0
  39. package/examples/hello.pln +2 -3
  40. package/examples/http-client.pln +3 -44
  41. package/examples/http.pln +11 -0
  42. package/examples/id-verification/app.pln +4 -3
  43. package/examples/id-verification/make-sample-id.js +29 -42
  44. package/examples/json.pln +11 -0
  45. package/examples/loops.pln +13 -11
  46. package/examples/modules/app.pln +3 -16
  47. package/examples/modules/main.pln +4 -0
  48. package/examples/modules/math.pln +5 -16
  49. package/examples/mongo.pln +33 -0
  50. package/examples/objects.pln +3 -11
  51. package/examples/ocr.pln +22 -0
  52. package/examples/packages.pln +6 -0
  53. package/examples/record-kinds.pln +6 -42
  54. package/examples/records.pln +15 -0
  55. package/examples/rest-api-fetch.pln +6 -90
  56. package/examples/rest-api.pln +5 -65
  57. package/examples/scheduled-tasks.pln +4 -23
  58. package/examples/search-and-filter.pln +4 -34
  59. package/examples/server.pln +5 -24
  60. package/examples/sessions-and-cookies.pln +4 -50
  61. package/examples/sqlite.pln +23 -0
  62. package/examples/start.pln +2 -2
  63. package/examples/stdlib.pln +4 -41
  64. package/examples/string-verbs.pln +16 -0
  65. package/examples/telegram-ai-bot.pln +19 -0
  66. package/examples/telegram-bot.pln +4 -40
  67. package/examples/testing.pln +13 -0
  68. package/examples/web-api.pln +27 -0
  69. package/examples/web-app.pln +4 -16
  70. package/examples/websocket-server.pln +5 -26
  71. package/examples/websocket.pln +13 -0
  72. package/examples/whatsapp-bot/pairing.pln +4 -5
  73. package/examples/whatsapp-bot/qr.pln +7 -3
  74. package/package.json +3 -2
@@ -1,1039 +1,218 @@
1
- function initSyntaxHighlighting() {
2
- var codeBlocks = document.querySelectorAll('.code-window-body code, .code-block code, .code-block--wide code');
1
+ (() => {
2
+ "use strict";
3
3
 
4
- var PS_KEYWORDS = {
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,
12
- 'save':1,'as':1,'if':1,'else':1,'then':1,'end':1,'function':1,'returns':1,
13
- 'return':1,'database':1,'query':1,'insert':1,'into':1,'values':1,'each':1,
14
- 'in':1,'while':1,'not':1,'and':1,'or':1,'equals':1,'greater':1,
15
- 'less':1,'than':1,'true':1,'false':1,'null':1,'none':1,'javascript':1,
16
- 'import':1,'from':1,'export':1,'class':1,'new':1,'this':1,'with':1,'do':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
74
- };
4
+ const prefersReduced = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
75
5
 
76
- var JS_KEYWORDS = {
77
- 'const':1,'let':1,'var':1,'function':1,'return':1,'if':1,'else':1,'for':1,
78
- 'while':1,'do':1,'switch':1,'case':1,'break':1,'continue':1,'new':1,'this':1,
79
- 'class':1,'extends':1,'import':1,'from':1,'export':1,'default':1,'try':1,
80
- 'catch':1,'throw':1,'async':1,'await':1,'typeof':1,'instanceof':1,'in':1,
81
- 'of':1,'true':1,'false':1,'null':1,'undefined':1,'void':1
82
- };
6
+ // ── three.js animated background ──────────────────────────────────────
7
+ function mountBackground() {
8
+ const canvas = document.getElementById("bg-canvas");
9
+ if (!canvas || !window.WebGLRenderingContext) return;
83
10
 
84
- var JS_BUILTINS = {
85
- 'console':1,'require':1,'module':1,'exports':1,'Math':1,'JSON':1,'Promise':1,
86
- 'Array':1,'Object':1,'String':1,'Number':1,'Boolean':1,'Date':1,'RegExp':1,
87
- 'Error':1,'Map':1,'Set':1
88
- };
11
+ const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
12
+ renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
89
13
 
90
- var OPERATORS = [
91
- '===','!==','=>','>=','<=','&&','||','++','--',
92
- '=','>','<','+','-','*','/','%','!'
93
- ];
94
-
95
- function esc(ch) {
96
- if (ch === '&') return '&amp;';
97
- if (ch === '<') return '&lt;';
98
- if (ch === '>') return '&gt;';
99
- if (ch === '"') return '&quot;';
100
- if (ch === "'") return '&#39;';
101
- return ch;
102
- }
103
-
104
- function escStr(s) {
105
- var out = '';
106
- for (var k = 0; k < s.length; k++) {
107
- out += esc(s[k]);
108
- }
109
- return out;
110
- }
111
-
112
- function span(cls, text) {
113
- return '<span class="token ' + cls + '">' + text + '</span>';
114
- }
115
-
116
- function tokenize(code, lang) {
117
- var isPS = lang === 'plainscript';
118
- var keywords = isPS ? PS_KEYWORDS : JS_KEYWORDS;
119
- var builtins = isPS ? null : JS_BUILTINS;
120
-
121
- var i = 0;
122
- var len = code.length;
123
- var out = '';
124
-
125
- while (i < len) {
126
- var ch = code[i];
127
-
128
- // --- Template literals (JS only) ---
129
- if (!isPS && ch === '`') {
130
- var tplStart = i;
131
- i++;
132
- var tplContent = '`';
133
- while (i < len && code[i] !== '`') {
134
- if (code[i] === '\\') {
135
- tplContent += code[i];
136
- i++;
137
- if (i < len) {
138
- tplContent += code[i];
139
- i++;
140
- }
141
- } else {
142
- tplContent += code[i];
143
- i++;
144
- }
145
- }
146
- if (i < len) {
147
- tplContent += '`';
148
- i++;
149
- }
150
- out += span('string', escStr(tplContent));
151
- continue;
152
- }
153
-
154
- // --- Strings ---
155
- if (ch === '"' || ch === "'") {
156
- var q = ch;
157
- var strStart = i;
158
- i++;
159
- var strContent = q;
160
- while (i < len && code[i] !== q) {
161
- if (code[i] === '\\' && i + 1 < len) {
162
- strContent += code[i];
163
- i++;
164
- strContent += code[i];
165
- i++;
166
- } else if (code[i] === '\n') {
167
- break;
168
- } else {
169
- strContent += code[i];
170
- i++;
171
- }
172
- }
173
- if (i < len && code[i] === q) {
174
- strContent += code[i];
175
- i++;
176
- }
177
- out += span('string', escStr(strContent));
178
- continue;
179
- }
180
-
181
- // --- Single-line comments ---
182
- if (ch === '/' && i + 1 < len && code[i + 1] === '/') {
183
- var commentEnd = i;
184
- while (commentEnd < len && code[commentEnd] !== '\n') {
185
- commentEnd++;
186
- }
187
- var comment = code.substring(i, commentEnd);
188
- out += span('comment', escStr(comment));
189
- i = commentEnd;
190
- continue;
191
- }
192
-
193
- // --- Multi-line comments ---
194
- if (!isPS && ch === '/' && i + 1 < len && code[i + 1] === '*') {
195
- var mEnd = i + 2;
196
- while (mEnd < len) {
197
- if (mEnd < len - 1 && code[mEnd] === '*' && code[mEnd + 1] === '/') {
198
- mEnd += 2;
199
- break;
200
- }
201
- mEnd++;
202
- }
203
- var mComment = code.substring(i, mEnd);
204
- out += span('comment', escStr(mComment));
205
- i = mEnd;
206
- continue;
207
- }
208
-
209
- // --- Hex numbers (JS only) ---
210
- if (!isPS && ch === '0' && i + 1 < len && (code[i + 1] === 'x' || code[i + 1] === 'X')) {
211
- var hexStart = i;
212
- i += 2;
213
- while (i < len && /[0-9a-fA-F]/.test(code[i])) {
214
- i++;
215
- }
216
- var hex = code.substring(hexStart, i);
217
- out += span('number', escStr(hex));
218
- continue;
219
- }
220
-
221
- // --- Numbers ---
222
- if (/[0-9]/.test(ch)) {
223
- var numStart = i;
224
- while (i < len && /[0-9]/.test(code[i])) {
225
- i++;
226
- }
227
- if (i < len && code[i] === '.' && i + 1 < len && /[0-9]/.test(code[i + 1])) {
228
- i++;
229
- while (i < len && /[0-9]/.test(code[i])) {
230
- i++;
231
- }
232
- }
233
- var num = code.substring(numStart, i);
234
- out += span('number', escStr(num));
235
- continue;
236
- }
237
-
238
- // --- Words (identifiers, keywords, builtins) ---
239
- if (/[a-zA-Z_$]/.test(ch)) {
240
- var wordStart = i;
241
- while (i < len && /[a-zA-Z0-9_$]/.test(code[i])) {
242
- i++;
243
- }
244
- var word = code.substring(wordStart, i);
245
-
246
- // Look ahead for function call
247
- var j = i;
248
- while (j < len && (code[j] === ' ' || code[j] === '\t')) {
249
- j++;
250
- }
251
- var isFuncCall = j < len && code[j] === '(';
252
-
253
- // Check for property access (preceded by a dot)
254
- var lookBehind = wordStart - 1;
255
- while (lookBehind >= 0 && (code[lookBehind] === ' ' || code[lookBehind] === '\t')) {
256
- lookBehind--;
257
- }
258
- var isProperty = lookBehind >= 0 && code[lookBehind] === '.';
259
-
260
- if (keywords[word]) {
261
- out += span('keyword', escStr(word));
262
- } else if (builtins && builtins[word]) {
263
- out += span('builtin', escStr(word));
264
- } else if (isProperty) {
265
- out += span('property', escStr(word));
266
- } else if (isFuncCall) {
267
- out += span('function', escStr(word));
268
- } else {
269
- out += span('default', escStr(word));
270
- }
271
- continue;
272
- }
273
-
274
- // --- Operators ---
275
- var matchedOp = '';
276
- for (var oi = 0; oi < OPERATORS.length; oi++) {
277
- var op = OPERATORS[oi];
278
- if (code.indexOf(op, i) === i && op.length > matchedOp.length) {
279
- matchedOp = op;
280
- }
281
- }
282
- if (matchedOp) {
283
- out += span('operator', escStr(matchedOp));
284
- i += matchedOp.length;
285
- continue;
286
- }
287
-
288
- // --- Punctuation ---
289
- if ('(){}[];,'.indexOf(ch) !== -1) {
290
- out += span('punctuation', esc(ch));
291
- i++;
292
- continue;
293
- }
294
-
295
- // --- Dot (JS property access) ---
296
- if (!isPS && ch === '.') {
297
- out += span('punctuation', '.');
298
- i++;
299
- continue;
300
- }
301
-
302
- // --- Anything else (whitespace, newlines, unknown) ---
303
- var wsStart = i;
304
- while (i < len) {
305
- var wc = code[i];
306
- if (/[a-zA-Z0-9_$'"`]/.test(wc)) break;
307
- if (wc === '/' && i + 1 < len && (code[i + 1] === '/' || code[i + 1] === '*')) break;
308
- if (wc === '\\' && !isPS) break;
309
- if ('(){}[];,'.indexOf(wc) !== -1) break;
310
- if ('=<>+-*/%!&|^~?'.indexOf(wc) !== -1) break;
311
- i++;
312
- }
313
- if (i > wsStart) {
314
- out += escStr(code.substring(wsStart, i));
315
- }
316
- }
14
+ const scene = new THREE.Scene();
15
+ const camera = new THREE.PerspectiveCamera(70, 1, 0.1, 100);
16
+ camera.position.z = 16;
317
17
 
318
- return out;
319
- }
320
-
321
- for (var i = 0; i < codeBlocks.length; i++) {
322
- var codeEl = codeBlocks[i];
323
- var text = codeEl.textContent;
324
- if (!text.trim()) continue;
325
-
326
- var win = codeEl.closest('.code-window');
327
- var lang = 'plainscript';
328
- if (win) {
329
- var title = win.querySelector('.code-window-title');
330
- if (title) {
331
- var titleText = title.textContent.toLowerCase();
332
- if (titleText.indexOf('plain') === -1) {
333
- lang = 'javascript';
334
- }
335
- }
336
- }
337
-
338
- if (!win) {
339
- lang = 'plainscript';
340
- }
341
-
342
- codeEl.innerHTML = tokenize(text, lang);
343
- }
344
- }
345
-
346
- function initThreeBackground() {
347
- var canvas = document.getElementById('bg-canvas');
348
- if (!canvas || typeof THREE === 'undefined') return;
349
-
350
- var scene = new THREE.Scene();
351
- var camera = new THREE.PerspectiveCamera(75, window.innerWidth / window.innerHeight, 0.1, 1000);
352
- var renderer = new THREE.WebGLRenderer({ canvas: canvas, alpha: true, antialias: true });
353
- renderer.setSize(window.innerWidth, window.innerHeight);
354
- renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
355
-
356
- camera.position.z = 30;
357
-
358
- var particleCount = 1500;
359
- var geometry = new THREE.BufferGeometry();
360
- var positions = new Float32Array(particleCount * 3);
361
- var sizes = new Float32Array(particleCount);
362
-
363
- for (var i = 0; i < particleCount; i++) {
364
- var i3 = i * 3;
365
- var radius = 50 + Math.random() * 50;
366
- var theta = Math.random() * Math.PI * 2;
367
- var phi = Math.acos(2 * Math.random() - 1);
368
-
369
- positions[i3] = radius * Math.sin(phi) * Math.cos(theta);
370
- positions[i3 + 1] = radius * Math.sin(phi) * Math.sin(theta);
371
- positions[i3 + 2] = radius * Math.cos(phi);
372
-
373
- sizes[i] = 0.5 + Math.random() * 1.5;
374
- }
375
-
376
- geometry.setAttribute('position', new THREE.BufferAttribute(positions, 3));
377
- geometry.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
378
-
379
- var material = new THREE.PointsMaterial({
380
- color: 0x10b981,
381
- size: 0.15,
382
- transparent: true,
383
- opacity: 0.6,
384
- blending: THREE.AdditiveBlending,
385
- depthWrite: false,
386
- sizeAttenuation: true
387
- });
18
+ const group = new THREE.Group();
19
+ scene.add(group);
388
20
 
389
- var particles = new THREE.Points(geometry, material);
390
- scene.add(particles);
391
-
392
- var mouse = { x: 0, y: 0 };
393
- var targetMouse = { x: 0, y: 0 };
394
-
395
- document.addEventListener('mousemove', function(e) {
396
- targetMouse.x = (e.clientX / window.innerWidth - 0.5) * 2;
397
- targetMouse.y = (e.clientY / window.innerHeight - 0.5) * 2;
398
- });
399
-
400
- window.addEventListener('resize', function() {
401
- camera.aspect = window.innerWidth / window.innerHeight;
402
- camera.updateProjectionMatrix();
403
- renderer.setSize(window.innerWidth, window.innerHeight);
404
- });
405
-
406
- function animate() {
407
- requestAnimationFrame(animate);
408
-
409
- particles.rotation.y += 0.0003;
410
- particles.rotation.x += 0.0001;
411
-
412
- mouse.x += (targetMouse.x - mouse.x) * 0.02;
413
- mouse.y += (targetMouse.y - mouse.y) * 0.02;
414
-
415
- particles.rotation.y += mouse.x * 0.0005;
416
- particles.rotation.x += mouse.y * 0.0005;
417
-
418
- renderer.render(scene, camera);
419
- }
420
-
421
- animate();
422
- }
423
-
424
- function initMobileMenu() {
425
- var hamburger = document.getElementById('nav-hamburger');
426
- var menu = document.getElementById('mobile-menu');
427
- if (!hamburger || !menu) return;
428
-
429
- function openMenu() {
430
- hamburger.classList.add('open');
431
- menu.classList.add('open');
432
- document.body.classList.add('menu-open');
433
- hamburger.querySelector('i').classList.remove('fa-bars');
434
- hamburger.querySelector('i').classList.add('fa-xmark');
435
- }
436
-
437
- function closeMenu() {
438
- hamburger.classList.remove('open');
439
- menu.classList.remove('open');
440
- document.body.classList.remove('menu-open');
441
- hamburger.querySelector('i').classList.remove('fa-xmark');
442
- hamburger.querySelector('i').classList.add('fa-bars');
443
- }
444
-
445
- function toggleMenu() {
446
- if (menu.classList.contains('open')) {
447
- closeMenu();
448
- } else {
449
- openMenu();
21
+ // Distant particle field
22
+ const starCount = prefersReduced ? 0 : 800;
23
+ const positions = new Float32Array(starCount * 3);
24
+ for (let i = 0; i < starCount; i++) {
25
+ positions[i * 3] = (Math.random() - 0.5) * 34;
26
+ positions[i * 3 + 1] = (Math.random() - 0.5) * 22;
27
+ positions[i * 3 + 2] = (Math.random() - 0.5) * 30;
450
28
  }
451
- }
452
-
453
- hamburger.addEventListener('click', toggleMenu);
454
-
455
- var mobileLinks = menu.querySelectorAll('a');
456
- for (var i = 0; i < mobileLinks.length; i++) {
457
- mobileLinks[i].addEventListener('click', closeMenu);
458
- }
459
-
460
- document.addEventListener('keydown', function(e) {
461
- if (e.key === 'Escape' && menu.classList.contains('open')) {
462
- closeMenu();
463
- }
464
- });
465
-
466
- window.addEventListener('resize', function() {
467
- if (window.innerWidth > 800 && menu.classList.contains('open')) {
468
- closeMenu();
469
- }
470
- });
471
- }
472
-
473
- function initCopyButtons() {
474
- var buttons = document.querySelectorAll('.code-copy, .copy-btn');
475
- for (var i = 0; i < buttons.length; i++) {
476
- buttons[i].addEventListener('click', function() {
477
- var btn = this;
478
- var target = btn.closest('.code-window') || btn.closest('.code-block');
479
- if (!target) return;
480
-
481
- var codeEl = target.querySelector('pre code') || target.querySelector('code') || target.querySelector('pre');
482
- if (!codeEl) return;
483
-
484
- var text = codeEl.textContent;
485
-
486
- navigator.clipboard.writeText(text).then(function() {
487
- var originalHTML = btn.innerHTML;
488
- btn.innerHTML = '<i class="fas fa-check"></i> Copied';
489
- btn.classList.add('copied');
490
-
491
- setTimeout(function() {
492
- btn.innerHTML = originalHTML;
493
- btn.classList.remove('copied');
494
- }, 2000);
495
- }).catch(function() {
496
- var textarea = document.createElement('textarea');
497
- textarea.value = text;
498
- textarea.style.position = 'fixed';
499
- textarea.style.opacity = '0';
500
- document.body.appendChild(textarea);
501
- textarea.select();
502
- document.execCommand('copy');
503
- document.body.removeChild(textarea);
504
-
505
- var originalHTML = btn.innerHTML;
506
- btn.innerHTML = '<i class="fas fa-check"></i> Copied';
507
- btn.classList.add('copied');
508
-
509
- setTimeout(function() {
510
- btn.innerHTML = originalHTML;
511
- btn.classList.remove('copied');
512
- }, 2000);
513
- });
29
+ const starGeo = new THREE.BufferGeometry();
30
+ starGeo.setAttribute("position", new THREE.BufferAttribute(positions, 3));
31
+ const starMat = new THREE.PointsMaterial({
32
+ color: 0x46e6b4,
33
+ size: 0.09,
34
+ transparent: true,
35
+ opacity: 0.55,
36
+ sizeAttenuation: true,
37
+ depthWrite: false,
514
38
  });
515
- }
516
- }
517
-
518
- function initFAQ() {
519
- var items = document.querySelectorAll('.faq-item');
520
- for (var i = 0; i < items.length; i++) {
521
- items[i].addEventListener('toggle', function() {
522
- if (this.open) {
523
- for (var j = 0; j < items.length; j++) {
524
- if (items[j] !== this && items[j].open) {
525
- items[j].open = false;
526
- }
527
- }
528
- }
39
+ const stars = new THREE.Points(starGeo, starMat);
40
+ group.add(stars);
41
+
42
+ // Two soft wireframe rings for structure
43
+ const ringMat = new THREE.MeshBasicMaterial({
44
+ color: 0x46e6b4,
45
+ wireframe: true,
46
+ transparent: true,
47
+ opacity: 0.12,
529
48
  });
530
- }
531
- }
532
-
533
- function initScrollSpy() {
534
- var sections = document.querySelectorAll('section[id]');
535
- if (sections.length === 0) return;
536
-
537
- var navLinks = document.querySelectorAll('.nav-links a, .mobile-menu a');
49
+ for (const [radius, tilt, speed] of [[9.5, 0.4, 0.22], [6.5, -0.25, -0.16]]) {
50
+ const ring = new THREE.Mesh(new THREE.TorusGeometry(radius, 0.05, 8, 96), ringMat);
51
+ ring.rotation.x = tilt;
52
+ ring.rotation.y = 0.6;
53
+ group.add(ring);
54
+ ring.userData.speed = speed;
55
+ }
538
56
 
539
- var observer = new IntersectionObserver(function(entries) {
540
- for (var i = 0; i < entries.length; i++) {
541
- if (entries[i].isIntersecting) {
542
- var id = entries[i].target.getAttribute('id');
57
+ let mouseX = 0;
58
+ let mouseY = 0;
59
+ window.addEventListener("pointermove", (event) => {
60
+ mouseX = (event.clientX / window.innerWidth) * 2 - 1;
61
+ mouseY = (event.clientY / window.innerHeight) * 2 - 1;
62
+ }, { passive: true });
63
+
64
+ function resize() {
65
+ const width = window.innerWidth;
66
+ const height = window.innerHeight;
67
+ renderer.setSize(width, height);
68
+ camera.aspect = width / height;
69
+ camera.updateProjectionMatrix();
70
+ }
71
+ resize();
72
+ window.addEventListener("resize", resize);
543
73
 
544
- for (var j = 0; j < navLinks.length; j++) {
545
- var link = navLinks[j];
546
- if (link.getAttribute('href') === '#' + id) {
547
- link.classList.add('active');
548
- link.style.color = '#10b981';
549
- } else {
550
- link.classList.remove('active');
551
- link.style.color = '';
552
- }
74
+ const clock = new THREE.Clock();
75
+ function tick() {
76
+ const elapsed = clock.getElapsedTime();
77
+ group.rotation.y = elapsed * 0.06;
78
+ group.children.forEach((child) => {
79
+ if (child.userData.speed) {
80
+ child.rotation.z += child.userData.speed * 0.004;
553
81
  }
554
- }
82
+ });
83
+ // Parallax toward the cursor
84
+ const targetY = elapsed * 0.06 + mouseX * 0.15;
85
+ group.rotation.x += (mouseY * 0.12 - group.rotation.x) * 0.04;
86
+ group.rotation.y += (targetY - group.rotation.y) * 0.04;
87
+ camera.position.x += (mouseX * 1.1 - camera.position.x) * 0.03;
88
+ camera.position.y += (mouseY * 0.7 - camera.position.y) * 0.03;
89
+ camera.lookAt(scene.position);
90
+ renderer.render(scene, camera);
91
+ requestAnimationFrame(tick);
555
92
  }
556
- }, {
557
- rootMargin: '-20% 0px -70% 0px',
558
- threshold: 0
559
- });
560
-
561
- for (var i = 0; i < sections.length; i++) {
562
- observer.observe(sections[i]);
93
+ if (!prefersReduced) tick();
563
94
  }
564
- }
565
-
566
- function initGSAPAnimations() {
567
- if (typeof gsap === 'undefined') return;
568
-
569
- gsap.registerPlugin(ScrollTrigger);
570
-
571
- var prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
572
- if (prefersReducedMotion) return;
95
+ mountBackground();
573
96
 
574
- var heroTimeline = gsap.timeline({ defaults: { ease: 'power3.out', duration: 0.8 } });
97
+ // ── GSAP entrance + scroll reveals ────────────────────────────────────
98
+ const gsapOk = window.gsap && !prefersReduced;
575
99
 
576
- heroTimeline
577
- .from('.hero-badge', { opacity: 0, y: 30, duration: 0.6 })
578
- .from('.hero-title', { opacity: 0, y: 40, duration: 0.8 }, '-=0.4')
579
- .from('.hero-subtitle', { opacity: 0, y: 30, duration: 0.6 }, '-=0.4')
580
- .from('.hero-actions', { opacity: 0, y: 30, duration: 0.6 }, '-=0.3')
581
- .from('.hero-code', { opacity: 0, y: 40, scale: 0.95, duration: 0.8 }, '-=0.3');
100
+ if (gsapOk) {
101
+ gsap.registerPlugin(window.ScrollTrigger);
582
102
 
583
- gsap.utils.toArray('.section-tag, .section-title, .section-lead').forEach(function(el, i) {
584
- gsap.from(el, {
585
- scrollTrigger: {
586
- trigger: el,
587
- start: 'top 85%',
588
- end: 'top 60%',
589
- toggleActions: 'play none none none'
590
- },
591
- opacity: 0,
592
- y: 40,
593
- duration: 0.7,
594
- ease: 'power3.out'
103
+ // Hero entrance
104
+ gsap.from(".hero-badge", { opacity: 0, y: 18, duration: 0.7, ease: "power2.out" });
105
+ gsap.from(".hero-title", {
106
+ opacity: 0, y: 30, duration: 0.9, ease: "power3.out", delay: 0.1,
595
107
  });
596
- });
597
-
598
- gsap.utils.toArray('.feature-card').forEach(function(card, i) {
599
- gsap.from(card, {
600
- scrollTrigger: {
601
- trigger: card,
602
- start: 'top 85%',
603
- toggleActions: 'play none none none'
604
- },
605
- opacity: 0,
606
- y: 50,
607
- duration: 0.7,
608
- delay: i * 0.1,
609
- ease: 'power3.out'
108
+ gsap.from(".hero-lead", { opacity: 0, y: 22, duration: 0.8, ease: "power2.out", delay: 0.22 });
109
+ gsap.from(".hero-actions .button", {
110
+ opacity: 0, y: 18, duration: 0.6, ease: "power2.out", delay: 0.32, stagger: 0.08,
610
111
  });
611
- });
612
-
613
- gsap.utils.toArray('.stat-item').forEach(function(item, i) {
614
- gsap.from(item, {
615
- scrollTrigger: {
616
- trigger: item,
617
- start: 'top 85%',
618
- toggleActions: 'play none none none'
619
- },
620
- opacity: 0,
621
- y: 30,
622
- duration: 0.6,
623
- delay: i * 0.15,
624
- ease: 'power3.out'
112
+ gsap.from(".hero .code-window", { opacity: 0, y: 26, duration: 0.8, ease: "power2.out", delay: 0.44 });
113
+
114
+ // Scroll reveals for cards and blocks
115
+ gsap.utils.toArray("[data-reveal]").forEach((el) => {
116
+ gsap.from(el, {
117
+ opacity: 0,
118
+ y: 28,
119
+ duration: 0.7,
120
+ ease: "power2.out",
121
+ scrollTrigger: { trigger: el, start: "top 88%", once: true },
122
+ });
625
123
  });
626
- });
627
124
 
628
- gsap.utils.toArray('.code-window').forEach(function(win) {
629
- gsap.from(win, {
630
- scrollTrigger: {
631
- trigger: win,
632
- start: 'top 85%',
633
- toggleActions: 'play none none none'
634
- },
635
- opacity: 0,
636
- y: 40,
637
- scale: 0.95,
638
- duration: 0.8,
639
- ease: 'power3.out'
125
+ // Stagger card grids
126
+ gsap.utils.toArray(".three-column, .feature-grid").forEach((grid) => {
127
+ gsap.from(grid.children, {
128
+ opacity: 0,
129
+ y: 30,
130
+ duration: 0.6,
131
+ ease: "power2.out",
132
+ stagger: 0.08,
133
+ scrollTrigger: { trigger: grid, start: "top 86%", once: true },
134
+ });
640
135
  });
641
- });
642
-
643
- gsap.utils.toArray('.faq-item').forEach(function(item, i) {
644
- gsap.from(item, {
645
- scrollTrigger: {
646
- trigger: item,
647
- start: 'top 85%',
648
- toggleActions: 'play none none none'
649
- },
650
- opacity: 0,
651
- y: 30,
652
- duration: 0.6,
653
- delay: i * 0.1,
654
- ease: 'power3.out'
136
+ } else {
137
+ // No-JS / reduced-motion fallback: keep everything visible
138
+ document.querySelectorAll("[data-reveal]").forEach((el) => el.style.opacity = 1);
139
+ document.querySelectorAll(".hero-badge, .hero-title, .hero-lead, .hero .code-window").forEach((el) => {
140
+ el.style.opacity = 1;
655
141
  });
656
- });
657
-
658
- gsap.utils.toArray('.cli-item').forEach(function(item, i) {
659
- gsap.from(item, {
660
- scrollTrigger: {
661
- trigger: item,
662
- start: 'top 85%',
663
- toggleActions: 'play none none none'
664
- },
665
- opacity: 0,
666
- x: -30,
667
- duration: 0.6,
668
- delay: i * 0.12,
669
- ease: 'power3.out'
670
- });
671
- });
672
- }
673
-
674
- function initScrollProgress() {
675
- var bar = document.getElementById('scroll-progress');
676
- if (!bar) {
677
- bar = document.createElement('div');
678
- bar.id = 'scroll-progress';
679
- document.body.appendChild(bar);
680
- }
681
-
682
- bar.style.cssText = 'position:fixed;top:0;left:0;height:3px;width:0;z-index:9999;background:linear-gradient(90deg,#10b981,#059669);transition:width 0.1s linear;pointer-events:none;';
683
-
684
- window.addEventListener('scroll', function() {
685
- var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
686
- var docHeight = document.documentElement.scrollHeight - window.innerHeight;
687
- var progress = docHeight > 0 ? (scrollTop / docHeight) * 100 : 0;
688
- bar.style.width = progress + '%';
689
- });
690
- }
691
-
692
- function initBackToTop() {
693
- var btn = document.getElementById('to-top');
694
- if (!btn) {
695
- btn = document.createElement('button');
696
- btn.id = 'to-top';
697
- btn.innerHTML = '<i class="fas fa-arrow-up"></i>';
698
- document.body.appendChild(btn);
699
142
  }
700
143
 
701
- btn.style.cssText = 'position:fixed;bottom:30px;right:30px;width:48px;height:48px;border-radius:50%;background:#10b981;color:#fff;border:none;cursor:pointer;font-size:18px;display:flex;align-items:center;justify-content:center;opacity:0;visibility:hidden;transform:translateY(20px);transition:all 0.3s ease;z-index:9998;box-shadow:0 4px 15px rgba(16,185,129,0.4);';
702
-
703
- window.addEventListener('scroll', function() {
704
- if (window.pageYOffset > 400) {
705
- btn.style.opacity = '1';
706
- btn.style.visibility = 'visible';
707
- btn.style.transform = 'translateY(0)';
708
- } else {
709
- btn.style.opacity = '0';
710
- btn.style.visibility = 'hidden';
711
- btn.style.transform = 'translateY(20px)';
712
- }
713
- });
144
+ // Nav blur once scrolled
145
+ const nav = document.getElementById("site-nav");
146
+ const onScroll = () => nav && nav.classList.toggle("is-scrolled", window.scrollY > 10);
147
+ window.addEventListener("scroll", onScroll, { passive: true });
148
+ onScroll();
149
+
150
+ // ── Feature library (search + filter) ─────────────────────────────────
151
+ const examples = [
152
+ { category: "core", name: "Variables", description: "Store and update values.", source: 'remember name as "Ada"\nremember count as 3\ncount becomes count + 1\nshow `Hello, ${name}!`' },
153
+ { category: "core", name: "Conditions", description: "Compare values in plain words.", source: 'if score is at least 80 and name contains "A"\n show "accepted"\notherwise\n show "review"\ndone' },
154
+ { category: "core", name: "Loops", description: "Go through lists and ranges.", source: 'for each item in list with "one", "two"\n show item\ndone\n\nfor index i from 0 to 2\n show i\ndone' },
155
+ { category: "core", name: "Functions", description: "Create reusable functions.", source: 'make add(a, b)\n give a + b\ndone\n\nshow add(2, 3)' },
156
+ { category: "core", name: "Modules", description: "Share code across files.", source: 'bring circleArea from "./math.pln"\nbring button from "@/components/button.pln"\nexport circleArea and squareArea' },
157
+ { category: "data", name: "Records", description: "Define the shape of your data.", source: 'define a kind called "Player" with\n name is ""\n goals is 0\ndone\nremember player as create a Player with name "Ada" and goals 4' },
158
+ { category: "data", name: "JSON", description: "Work with JSON data.", source: 'remember payload as {ok: true, count: 2}\nremember encoded as jsonEncode(payload)\nshow encoded' },
159
+ { category: "data", name: "Compound Types", description: "Use dictionaries, sets, and tuples.", source: 'remember userMap as dictionary with "name" is "Ada" and "role" is "admin" done\nremember tags as set with "admin", "editor" done\nremember point as tuple with 10, 20, 30 done' },
160
+ { category: "data", name: "SQLite", description: "Run safe SQL queries.", source: 'database "app.db" using "wasm"\nexecute\n CREATE TABLE items (name TEXT)\ndone\nremember items as query\n SELECT name FROM items\ndone' },
161
+ { category: "web", name: "Web routes", description: "Build an HTTP app with JSON routes.", source: 'web app\nroute get "/health"\n reply json\n ok is true\n done\ndone\nstart 3000' },
162
+ { category: "web", name: "HTTP client", description: "Fetch data from a URL.", source: 'remember response as get "https://example.com/data" timeout 5000\nshow response.status' },
163
+ { category: "web", name: "Auth and sessions", description: "Protect routes and track visitors.", source: 'web app\nenable sessions "session-secret"\nrequire api key from env("API_KEY")\nroute get "/me"\n reply json\n user is user of session of request\n done\ndone' },
164
+ { category: "runtime", name: "Async errors", description: "Handle errors gracefully.", source: 'try\n remember result as get "https://example.com" timeout 5000\nrecover as error\n show message of error\nfinally\n show "finished"' },
165
+ { category: "runtime", name: "Concurrency", description: "Run several tasks at once.", source: 'remember results as allOf(list with firstJob(), secondJob())\nremember quick as withTimeout(firstJob(), 1000)\nshow results' },
166
+ { category: "runtime", name: "WebSockets", description: "Chat and push updates live.", source: 'websocket server on 8080\n when socket connects\n send socket "connected"\n done\n when socket sends message\n broadcast message\n done\ndone' },
167
+ { category: "runtime", name: "Cache", description: "Keep values ready with a TTL.", source: 'cache env("REDIS_URL")\ncacheSet("status", "ready", 60)\nremember status as cacheGet("status")' },
168
+ { category: "integrations", name: "Telegram", description: "Build a Telegram bot.", source: 'bot env("TELEGRAM_BOT_TOKEN")\nwhen someone sends "/start"\n reply "Welcome"\ndone\nstart telegram bot' },
169
+ { category: "integrations", name: "Groq AI", description: "Get AI replies in your code.", source: 'remember answer as chatWith("groq", "llama-3.3-70b-versatile", "Hello")\nshow answer' },
170
+ { category: "integrations", name: "OCR uploads", description: "Read text from uploaded images.", source: 'web app\naccept uploads limit "5 MB" allow list with "image/png" folder "uploads"\nroute post "/scan"\n remember file as upload("document")\n ocr path of file as text\n reply text\ndone' },
171
+ { category: "tooling", name: "Native tests", description: "Check that your code works.", source: 'test "addition works"\n check add(2, 3) equals 5\ndone' },
172
+ { category: "tooling", name: "Source Maps", description: "Debug right in your .pln files.", source: 'plainscript build src/main.pln --sourcemap\n\n// or in code:\n// plainscript run src/main.pln --sourcemap' }
173
+ ];
714
174
 
715
- btn.addEventListener('click', function() {
716
- window.scrollTo({ top: 0, behavior: 'smooth' });
175
+ const grid = document.getElementById("lib-grid");
176
+ const empty = document.getElementById("lib-empty");
177
+ const search = document.getElementById("lib-search");
178
+ const filters = document.getElementById("lib-filters");
179
+ if (!grid || !empty || !search || !filters) return;
180
+
181
+ const categories = ["all", ...new Set(examples.map((item) => item.category))];
182
+ let activeCategory = "all";
183
+
184
+ categories.forEach((category) => {
185
+ const button = document.createElement("button");
186
+ button.type = "button";
187
+ button.className = "lib-filter" + (category === "all" ? " is-active" : "");
188
+ button.textContent = category;
189
+ button.addEventListener("click", () => {
190
+ activeCategory = category;
191
+ filters.querySelectorAll("button").forEach((item) => item.classList.remove("is-active"));
192
+ button.classList.add("is-active");
193
+ render();
194
+ });
195
+ filters.appendChild(button);
717
196
  });
718
- }
719
-
720
- function initSmoothScroll() {
721
- var links = document.querySelectorAll('a[href^="#"]');
722
- for (var i = 0; i < links.length; i++) {
723
- links[i].addEventListener('click', function(e) {
724
- var href = this.getAttribute('href');
725
- if (href === '#' || href === '#top') {
726
- e.preventDefault();
727
- window.scrollTo({ top: 0, behavior: 'smooth' });
728
- return;
729
- }
730
197
 
731
- var target = document.querySelector(href);
732
- if (target) {
733
- e.preventDefault();
734
- target.scrollIntoView({ behavior: 'smooth', block: 'start' });
735
- }
198
+ function render() {
199
+ const query = search.value.trim().toLowerCase();
200
+ const visible = examples.filter((item) => {
201
+ const matchesCategory = activeCategory === "all" || item.category === activeCategory;
202
+ const haystack = `${item.name} ${item.description} ${item.source}`.toLowerCase();
203
+ return matchesCategory && (!query || haystack.includes(query));
736
204
  });
737
- }
738
- }
739
-
740
- var LIBRARY = [
741
- {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;'},
742
- {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;'},
743
- {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);'},
744
- {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";'},
745
- {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}!`);'},
746
- {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());'},
747
- {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);'},
748
- {cat:"strings",name:"Trim Whitespace",desc:"Remove leading and trailing whitespace",ps:'remember clean as trim(" hello ")',js:'let clean = " hello ".trim();'},
749
- {cat:"strings",name:"Replace Text",desc:"Replace occurrences in a string",ps:'remember result as replace("hello world", "world", "JS")',js:'let result = "hello world".split("world").join("JS");'},
750
- {cat:"strings",name:"Split String",desc:"Split a string into an array by delimiter",ps:'remember parts as split("a,b,c", ",")',js:'let parts = "a,b,c".split(",");'},
751
- {cat:"strings",name:"Join Array",desc:"Join array elements into a string",ps:'remember text as join(["a","b","c"], ",")',js:'let text = ["a","b","c"].join(",");'},
752
- {cat:"numbers",name:"Arithmetic",desc:"Basic math operations",ps:'remember a as 10 + 5\nremember b as 20 - 3\nremember c as 4 * 7\nremember d as 15 / 3\nremember e as 17 % 5',js:'let a = 10 + 5;\nlet b = 20 - 3;\nlet c = 4 * 7;\nlet d = 15 / 3;\nlet e = 17 % 5;'},
753
- {cat:"numbers",name:"Rounding",desc:"Round, floor, or ceiling a number",ps:'show round(3.7)\nshow floor(3.7)\nshow ceiling(3.2)',js:'console.log(Math.round(3.7));\nconsole.log(Math.floor(3.7));\nconsole.log(Math.ceil(3.2));'},
754
- {cat:"numbers",name:"Random Number",desc:"Generate a random number between 0 and 1",ps:'remember roll as random()',js:'let roll = Math.random();'},
755
- {cat:"numbers",name:"Array Math",desc:"Sum, min, and max of arrays",ps:'remember nums as [1, 2, 3, 4, 5]\nshow sum(nums)\nshow smallest(nums)\nshow largest(nums)',js:'let nums = [1, 2, 3, 4, 5];\nconsole.log(nums.reduce((a, b) => a + b, 0));\nconsole.log(Math.min(...nums));\nconsole.log(Math.max(...nums));'},
756
- {cat:"booleans",name:"Comparisons",desc:"Compare values with natural English operators",ps:'if 5 is 5\n show "equal"\ndone\n\nif 5 is not 3\n show "not equal"\ndone\n\nif 10 is greater than 5\n show "bigger"\ndone\n\nif 3 is less than 7\n show "smaller"\ndone',js:'if (5 === 5) {\n console.log("equal");\n}\n\nif (5 !== 3) {\n console.log("not equal");\n}\n\nif (10 > 5) {\n console.log("bigger");\n}\n\nif (3 < 7) {\n console.log("smaller");\n}'},
757
- {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}'},
758
- {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}'},
759
- {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}'},
760
- {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}'},
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}'},
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}'},
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}'},
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);'},
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];'},
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]);'},
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);'},
769
- {cat:"arrays",name:"Sort / Reverse / Unique",desc:"Transform arrays with built-in operations",ps:'remember nums as [3, 1, 4, 1, 5]\nshow sort(nums)\nshow reverse(nums)\nshow unique(nums)',js:'let nums = [3, 1, 4, 1, 5];\nconsole.log([...nums].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0)));\nconsole.log([...nums].reverse());\nconsole.log([...new Set(nums)]);'},
770
- {cat:"objects",name:"Object Literal",desc:"Create an object with key-value pairs",ps:'remember user as\n name is "Ayokunle"\n age is 25\n role is "Developer"\ndone',js:'let user = {\n "name": "Ayokunle",\n "age": 25,\n "role": "Developer"\n};'},
771
- {cat:"objects",name:"Access Properties",desc:"Read and write object properties",ps:'remember user as\n name is "Ayokunle"\n age is 25\ndone\n\nshow user.name\nshow name of user\nuser.age becomes 26',js:'let user = {\n "name": "Ayokunle",\n "age": 25\n};\n\nconsole.log(user.name);\nconsole.log(user.name);\nuser.age = 26;'},
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" } };'},
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\');'},
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\');'},
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'},
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());'},
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});'},
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},
779
- {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},
780
- {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);'},
781
- {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},
782
- {cat:"database",name:"Connect SQLite",desc:"Open a SQLite database connection",ps:'database "app.db"',js:'const db = await __dbOpen("app.db", null);'},
783
- {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},
784
- {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},
785
- {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},
786
- {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},
787
- {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},
788
- {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;'},
789
- {cat:"cache",name:"Redis Cache",desc:"Connect to Redis for key-value caching",ps:'cache "redis://localhost:6379"',js:'// Creates Redis client and connects'},
790
- {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},
791
- {cat:"cache",name:"Delete Cache",desc:"Remove a cached key",ps:'cacheDelete("user:1")',js:'await __cacheClient().del("user:1");',skipRun:true},
792
- {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},
793
- {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},
794
- {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},
795
- {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);'},
796
- {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\');'},
797
- {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\');'},
798
- {cat:"filesystem",name:"Folder Operations",desc:"Create, list, and delete folders",ps:'makeFolder("src/components")\nshow listFolder("src")\ndeleteFolder("temp")',js:'fs.mkdirSync("src/components", { recursive: true });\nconsole.log(fs.readdirSync("src"));\nfs.rmSync("temp", { recursive: true, force: true });'},
799
- {cat:"logging",name:"Show / Print",desc:"Output values to the console",ps:'show "Hello, World!"\nshow 42\nshow true\nprint("Debug info")',js:'console.log("Hello, World!");\nconsole.log(42);\nconsole.log(true);\nconsole.log("Debug info");'},
800
- {cat:"datetime",name:"Timestamps",desc:"Get current time and create ISO dates",ps:'remember now as time()\nremember iso as date()\nshow now\nshow iso',js:'let now = Date.now();\nlet iso = new Date().toISOString();\nconsole.log(now);\nconsole.log(iso);'},
801
- {cat:"datetime",name:"Sleep",desc:"Pause execution for a duration",ps:'show "waiting..."\nsleep(2000)\nshow "done"',js:'console.log("waiting...");\nAtomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 2000);\nconsole.log("done");'},
802
- {cat:"datetime",name:"UUID & Environment",desc:"Generate UUIDs and read env vars",ps:'remember id as uuid()\nremember key as env("API_KEY")\nshow id\nshow key',js:'let id = crypto.randomUUID();\nlet key = process.env["API_KEY"];\nconsole.log(id);\nconsole.log(key);'},
803
- {cat:"errors",name:"Try / Recover",desc:"Handle errors gracefully",ps:'try\n remember data as readFile("missing.txt")\nrecover as err\n show `Error: ${err}`\ndone',js:'try {\n let data = fs.readFileSync("missing.txt", \'utf8\');\n} catch (err) {\n console.log(`Error: ${err}`);\n}'},
804
- {cat:"errors",name:"Retry",desc:"Automatically retry a failing operation",ps:'retry 3 times\n remember result as get "https://api.flaky.com/data"\ndone\n\nretry 5 times every 2 seconds\n remember result as get "https://api.flaky.com/data"\ndone',js:'for (let __attempt = 0; __attempt < 3; __attempt++) {\n try {\n let result = await __httpRequest(\'GET\', "https://api.flaky.com/data", {});\n break;\n } catch (__e) {}\n}'},
805
- {cat:"async",name:"Wait For (Await)",desc:"Wait for an asynchronous operation to complete",ps:'remember data as wait for fetch("https://api.example.com/data")\nshow data',js:'let data = await fetch("https://api.example.com/data");\nconsole.log(data);'},
806
- {cat:"async",name:"Run Background",desc:"Fire and forget an async operation",ps:'run background resizeImage("photo.png")\nrun background sendEmail(to, subject, body)',js:'setImmediate(() => { Promise.resolve(resizeImage("photo.png")).catch(() => {}); });\nsetImmediate(() => { Promise.resolve(sendEmail(to, subject, body)).catch(() => {}); });'},
807
- {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));'},
808
- {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"));'},
809
- {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});'},
810
- {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},
811
- {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 }));'},
812
- {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"]'},
813
- {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},
814
- {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});'},
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});'},
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!" });'},
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});'},
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},
822
- {cat:"cli",name:"CLI: doctor",desc:"Diagnose project issues",ps:'plainscript doctor',js:'// Checks Node version, dependencies, config',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},
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},
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},
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},
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});'},
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);'},
856
- {cat:"cli",name:"CLI: help",desc:"Show available commands",ps:'plainscript help',js:'// Lists all CLI commands',skipRun:true},
857
- {cat:"cli",name:"CLI: info",desc:"Display platform and runtime info",ps:'plainscript info',js:'// Shows version, Node version, OS',skipRun:true},
858
- {cat:"cli",name:"CLI: clean",desc:"Remove compiled output",ps:'plainscript clean',js:'// Deletes dist/ folder',skipRun:true},
859
- {cat:"cli",name:"CLI: repl",desc:"Launch interactive REPL shell",ps:'plainscript repl',js:'// Opens interactive PlainScript REPL',skipRun:true},
860
- {cat:"cli",name:"CLI: init",desc:"Initialize config file",ps:'plainscript init',js:'// Creates plainscript.config.json',skipRun:true},
861
- {cat:"cli",name:"CLI: test",desc:"Run the test suite",ps:'plainscript test',js:'// Runs test files in tests/',skipRun:true},
862
- {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);'},
863
- {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},
864
- {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});'},
865
- {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");'},
866
- {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);'},
867
- {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);'},
868
- {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);'},
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}'},
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);'},
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);'},
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);'},
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},
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});'},
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},
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},
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");'},
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}'},
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}'},
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}'},
881
- {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}'},
882
- {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}'},
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]);'},
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"), "#"));'},
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);'},
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);'},
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"); })()]);'},
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); });'},
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)]);'},
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]]);'},
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'},
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)'},
897
- {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"));'},
898
- {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'},
899
- {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'},
900
- {cat:"binary",name:"Base64 Encode / Decode",desc:"Round-trip text with base64",ps:'show base64Encode("hello")\nshow base64Decode("aGVsbG8=")',js:'show Buffer "aGVsbG8="'},
901
- {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"'},
902
- {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)'},
903
- {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())'},
904
- {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);'},
905
- {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")'},
906
- {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"'},
907
- {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"]);'},
908
- {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'},
909
- {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'},
910
- {cat:"process",name:"Command-Line Args",desc:"Read command-line arguments after the script name",ps:'show args()',js:'show process.argv.slice(2)'},
911
- {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);'},
912
- {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");'},
913
- {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'},
914
- {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);'},
915
- {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");'},
916
- {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")'},
917
- {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")'},
918
- {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")'},
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")'},
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");'},
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));'},
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();'},
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");'},
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;'},
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);'},
926
- {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);'},
927
- {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}`);'},
928
- {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);'},
929
- {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);'},
930
- {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);'},
931
- {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}'},
932
- {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}'},
933
- {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}'},
934
- {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}'},
935
- {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}`); });'},
936
- {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},
937
- {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);'},
938
- {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));'},
939
- {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);'},
940
- ];
941
-
942
- function initLibrary() {
943
- var grid = document.getElementById('lib-grid');
944
- var searchInput = document.getElementById('lib-search');
945
- var countEl = document.getElementById('lib-count');
946
- var emptyEl = document.getElementById('lib-empty');
947
- var filterBtns = document.querySelectorAll('.lib-filter');
948
- if (!grid || !searchInput) return;
949
-
950
- var activeCat = 'all';
951
-
952
- function renderCards(features) {
953
- grid.innerHTML = '';
954
- if (features.length === 0) {
955
- emptyEl.style.display = 'block';
956
- countEl.textContent = '0 results';
957
- return;
958
- }
959
- emptyEl.style.display = 'none';
960
- countEl.textContent = features.length + ' feature' + (features.length !== 1 ? 's' : '');
961
-
962
- for (var i = 0; i < features.length; i++) {
963
- var f = features[i];
964
- var card = document.createElement('div');
965
- card.className = 'lib-card';
966
- card.setAttribute('data-cat', f.cat);
967
-
968
- var header = '<div class="lib-card-header"><span class="lib-card-title">' + f.name + '</span><span class="lib-card-cat">' + f.cat + '</span></div>';
969
- var body = '<div class="lib-card-body"><pre><code>' + escapeHtml(f.ps) + '</code></pre></div>';
970
- var footer = '<div class="lib-card-footer"><div class="lib-card-js"><span>JS:</span> ' + escapeHtml(f.desc) + '</div></div>';
971
- card.innerHTML = header + body + footer;
205
+ grid.replaceChildren();
206
+ visible.forEach((item) => {
207
+ const card = document.createElement("article");
208
+ card.className = "library-card";
209
+ card.innerHTML = `<div class="library-card-top"><span class="library-category">${item.category}</span><h3>${item.name}</h3><p>${item.description}</p></div><pre><code></code></pre>`;
210
+ card.querySelector("code").textContent = item.source;
972
211
  grid.appendChild(card);
973
- }
974
-
975
- if (typeof initSyntaxHighlighting === 'function') {
976
- var codeEls = grid.querySelectorAll('code');
977
- for (var j = 0; j < codeEls.length; j++) {
978
- var text = codeEls[j].textContent;
979
- codeEls[j].innerHTML = tokenize(text, 'plainscript');
980
- }
981
- }
982
- }
983
-
984
- function escapeHtml(str) {
985
- return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
986
- }
987
-
988
- function filterFeatures() {
989
- var query = searchInput.value.toLowerCase().trim();
990
- var results = [];
991
-
992
- for (var i = 0; i < LIBRARY.length; i++) {
993
- var f = LIBRARY[i];
994
- var catMatch = activeCat === 'all' || f.cat === activeCat;
995
- if (!catMatch) continue;
996
-
997
- if (!query) {
998
- results.push(f);
999
- continue;
1000
- }
1001
-
1002
- var searchable = (f.name + ' ' + f.desc + ' ' + f.cat + ' ' + f.ps).toLowerCase();
1003
- if (searchable.indexOf(query) !== -1) {
1004
- results.push(f);
1005
- }
1006
- }
1007
-
1008
- renderCards(results);
1009
- }
1010
-
1011
- searchInput.addEventListener('input', filterFeatures);
1012
-
1013
- for (var i = 0; i < filterBtns.length; i++) {
1014
- filterBtns[i].addEventListener('click', function() {
1015
- for (var j = 0; j < filterBtns.length; j++) {
1016
- filterBtns[j].classList.remove('active');
1017
- }
1018
- this.classList.add('active');
1019
- activeCat = this.getAttribute('data-cat');
1020
- filterFeatures();
1021
212
  });
213
+ empty.hidden = visible.length !== 0;
1022
214
  }
1023
215
 
1024
- renderCards(LIBRARY);
1025
- }
1026
-
1027
- document.addEventListener('DOMContentLoaded', function() {
1028
- initSyntaxHighlighting();
1029
- initThreeBackground();
1030
- initMobileMenu();
1031
- initCopyButtons();
1032
- initFAQ();
1033
- initScrollSpy();
1034
- initSmoothScroll();
1035
- initScrollProgress();
1036
- initBackToTop();
1037
- initGSAPAnimations();
1038
- initLibrary();
1039
- });
216
+ search.addEventListener("input", render);
217
+ render();
218
+ })();