plainscript-lang 0.1.7-latest

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 (42) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +815 -0
  3. package/compiler/bundler.js +86 -0
  4. package/compiler/cli.js +843 -0
  5. package/compiler/dependency-detector.js +173 -0
  6. package/compiler/formatter.js +170 -0
  7. package/compiler/generator.js +2032 -0
  8. package/compiler/lexer.js +413 -0
  9. package/compiler/parser.js +2077 -0
  10. package/compiler/version.js +6 -0
  11. package/docs/PLINJS_SPEC.md +1051 -0
  12. package/docs/index.html +2287 -0
  13. package/docs/logo.jpg +0 -0
  14. package/docs/website/index.html +1500 -0
  15. package/docs/website/script.js +197 -0
  16. package/docs/website/style.css +1117 -0
  17. package/examples/arrays.pln +13 -0
  18. package/examples/cache-and-jobs.pln +29 -0
  19. package/examples/database.pln +41 -0
  20. package/examples/day2.pln +7 -0
  21. package/examples/day3.pln +11 -0
  22. package/examples/deployment.pln +12 -0
  23. package/examples/email-send.pln +22 -0
  24. package/examples/expressions.pln +40 -0
  25. package/examples/football-backend/app.pln +90 -0
  26. package/examples/hello.pln +3 -0
  27. package/examples/id-verification/app.pln +29 -0
  28. package/examples/id-verification/make-sample-id.js +123 -0
  29. package/examples/loops.pln +17 -0
  30. package/examples/objects.pln +12 -0
  31. package/examples/rest-api-fetch.pln +94 -0
  32. package/examples/rest-api.pln +68 -0
  33. package/examples/scheduled-tasks.pln +23 -0
  34. package/examples/server.pln +25 -0
  35. package/examples/start.pln +2 -0
  36. package/examples/stdlib.pln +41 -0
  37. package/examples/telegram-bot.pln +42 -0
  38. package/examples/web-app.pln +20 -0
  39. package/examples/websocket-server.pln +27 -0
  40. package/examples/whatsapp-bot/pairing.pln +17 -0
  41. package/examples/whatsapp-bot/qr.pln +8 -0
  42. package/package.json +47 -0
@@ -0,0 +1,1117 @@
1
+ /* ============================================================
2
+ PLINJS v0.1.7 — Documentation Website
3
+ Design: Ink — precise, typographic, developer-focused
4
+ ============================================================ */
5
+
6
+ /* ── Reset & box-sizing ──────────────────────────────────────────────────── */
7
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
8
+ html { scroll-behavior: smooth; scroll-padding-top: 68px; }
9
+
10
+ /* ── Design tokens ───────────────────────────────────────────────────────── */
11
+ :root {
12
+ --bg: #0a0c12;
13
+ --bg-alt: #0e1118;
14
+ --surface: #13161f;
15
+ --surface-2: #181c28;
16
+ --border: #1d2133;
17
+ --border-2: #262c40;
18
+ --accent: #4f7fff;
19
+ --accent-dim: rgba(79, 127, 255, 0.10);
20
+ --accent-glow: rgba(79, 127, 255, 0.06);
21
+ --green: #34d399;
22
+ --amber: #fbbf24;
23
+ --red: #f87171;
24
+ --text: #e2e6f0;
25
+ --muted: #7b869c;
26
+ --faint: #3a4158;
27
+ --code-bg: #0f1117;
28
+ --code-border: #1d2133;
29
+ --radius-sm: 4px;
30
+ --radius: 8px;
31
+ --radius-lg: 12px;
32
+ --shadow: 0 1px 3px rgba(0,0,0,.5), 0 4px 12px rgba(0,0,0,.3);
33
+ --shadow-lg: 0 4px 24px rgba(0,0,0,.6);
34
+ --max-w: 1140px;
35
+ --nav-h: 60px;
36
+ --mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', 'SF Mono', monospace;
37
+ --sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif;
38
+ --transition: 150ms ease;
39
+ }
40
+
41
+ /* ── Base typography ─────────────────────────────────────────────────────── */
42
+ body {
43
+ font-family: var(--sans);
44
+ background: var(--bg);
45
+ color: var(--text);
46
+ font-size: 16px;
47
+ line-height: 1.75;
48
+ -webkit-font-smoothing: antialiased;
49
+ }
50
+
51
+ h1, h2, h3, h4, h5 {
52
+ font-weight: 700;
53
+ line-height: 1.2;
54
+ color: var(--text);
55
+ }
56
+
57
+ p { color: var(--muted); line-height: 1.8; }
58
+ a { color: var(--accent); text-decoration: none; }
59
+ a:hover { text-decoration: underline; }
60
+
61
+ strong { color: var(--text); font-weight: 600; }
62
+
63
+ code {
64
+ font-family: var(--mono);
65
+ font-size: .85em;
66
+ background: var(--surface-2);
67
+ border: 1px solid var(--border);
68
+ border-radius: var(--radius-sm);
69
+ padding: .1em .4em;
70
+ color: var(--green);
71
+ }
72
+
73
+ pre code {
74
+ background: none;
75
+ border: none;
76
+ padding: 0;
77
+ font-size: inherit;
78
+ color: inherit;
79
+ }
80
+
81
+ /* ── Layout ──────────────────────────────────────────────────────────────── */
82
+ .container {
83
+ max-width: var(--max-w);
84
+ margin: 0 auto;
85
+ padding: 0 2rem;
86
+ }
87
+
88
+ /* ── Nav ─────────────────────────────────────────────────────────────────── */
89
+ .site-nav {
90
+ position: sticky;
91
+ top: 0;
92
+ z-index: 200;
93
+ height: var(--nav-h);
94
+ background: rgba(10, 12, 18, 0.92);
95
+ backdrop-filter: blur(16px);
96
+ -webkit-backdrop-filter: blur(16px);
97
+ border-bottom: 1px solid var(--border);
98
+ }
99
+
100
+ .nav-inner {
101
+ max-width: var(--max-w);
102
+ margin: 0 auto;
103
+ padding: 0 2rem;
104
+ height: 100%;
105
+ display: flex;
106
+ align-items: center;
107
+ gap: 0;
108
+ }
109
+
110
+ .nav-logo {
111
+ font-weight: 800;
112
+ font-size: 1.1rem;
113
+ color: var(--text);
114
+ text-decoration: none;
115
+ letter-spacing: -.02em;
116
+ display: flex;
117
+ align-items: center;
118
+ gap: .5rem;
119
+ margin-right: 2rem;
120
+ flex-shrink: 0;
121
+ }
122
+ .nav-logo .logo-word { color: var(--accent); }
123
+ .nav-logo .logo-ver {
124
+ font-size: .7rem;
125
+ font-weight: 600;
126
+ font-family: var(--mono);
127
+ color: var(--muted);
128
+ background: var(--surface-2);
129
+ border: 1px solid var(--border-2);
130
+ border-radius: 100px;
131
+ padding: .1rem .5rem;
132
+ }
133
+
134
+ .nav-links {
135
+ display: flex;
136
+ list-style: none;
137
+ gap: .25rem;
138
+ flex: 1;
139
+ }
140
+ .nav-links a {
141
+ font-size: .875rem;
142
+ color: var(--muted);
143
+ text-decoration: none;
144
+ padding: .35rem .65rem;
145
+ border-radius: var(--radius-sm);
146
+ transition: color var(--transition), background var(--transition);
147
+ }
148
+ .nav-links a:hover {
149
+ color: var(--text);
150
+ background: var(--surface);
151
+ }
152
+
153
+ .nav-actions {
154
+ display: flex;
155
+ align-items: center;
156
+ gap: .5rem;
157
+ margin-left: auto;
158
+ }
159
+ .nav-cta {
160
+ display: flex;
161
+ align-items: center;
162
+ gap: .4rem;
163
+ font-size: .83rem;
164
+ font-weight: 500;
165
+ color: var(--muted);
166
+ text-decoration: none;
167
+ padding: .35rem .75rem;
168
+ border-radius: var(--radius-sm);
169
+ border: 1px solid var(--border-2);
170
+ transition: color var(--transition), border-color var(--transition), background var(--transition);
171
+ }
172
+ .nav-cta:hover {
173
+ color: var(--text);
174
+ border-color: var(--faint);
175
+ background: var(--surface);
176
+ text-decoration: none;
177
+ }
178
+ .nav-cta i { font-size: .8rem; }
179
+
180
+ .nav-hamburger {
181
+ display: none;
182
+ background: none;
183
+ border: none;
184
+ color: var(--muted);
185
+ font-size: 1.1rem;
186
+ cursor: pointer;
187
+ padding: .5rem;
188
+ border-radius: var(--radius-sm);
189
+ margin-left: .5rem;
190
+ transition: color var(--transition);
191
+ }
192
+ .nav-hamburger:hover { color: var(--text); }
193
+
194
+ /* Mobile menu */
195
+ .mobile-menu {
196
+ display: none;
197
+ position: fixed;
198
+ top: var(--nav-h);
199
+ left: 0; right: 0;
200
+ background: var(--bg-alt);
201
+ border-bottom: 1px solid var(--border);
202
+ z-index: 199;
203
+ padding: 1rem 2rem 1.5rem;
204
+ }
205
+ .mobile-menu.open { display: block; }
206
+ .mobile-menu a {
207
+ display: block;
208
+ color: var(--muted);
209
+ text-decoration: none;
210
+ padding: .65rem 0;
211
+ border-bottom: 1px solid var(--border);
212
+ font-size: .95rem;
213
+ transition: color var(--transition);
214
+ }
215
+ .mobile-menu a:hover { color: var(--text); }
216
+ .mobile-menu a:last-child { border-bottom: none; }
217
+
218
+ /* ── Section layout ──────────────────────────────────────────────────────── */
219
+ .section {
220
+ padding: 5rem 0;
221
+ border-bottom: 1px solid var(--border);
222
+ }
223
+ .section:last-of-type { border-bottom: none; }
224
+ .section--alt { background: var(--bg-alt); }
225
+
226
+ .section-tag {
227
+ display: inline-flex;
228
+ align-items: center;
229
+ gap: .4rem;
230
+ font-size: .72rem;
231
+ font-weight: 700;
232
+ letter-spacing: .1em;
233
+ text-transform: uppercase;
234
+ color: var(--accent);
235
+ margin-bottom: .75rem;
236
+ }
237
+
238
+ .section-title {
239
+ font-size: clamp(1.6rem, 3vw, 2.1rem);
240
+ font-weight: 800;
241
+ margin-bottom: .75rem;
242
+ letter-spacing: -.02em;
243
+ }
244
+
245
+ .section-lead {
246
+ font-size: 1.05rem;
247
+ color: var(--muted);
248
+ max-width: 640px;
249
+ margin-bottom: 2.5rem;
250
+ }
251
+
252
+ h3.sub-heading {
253
+ font-size: 1.05rem;
254
+ font-weight: 600;
255
+ color: var(--text);
256
+ margin: 2rem 0 .75rem;
257
+ display: flex;
258
+ align-items: center;
259
+ gap: .5rem;
260
+ }
261
+ h3.sub-heading i { color: var(--accent); font-size: .9rem; }
262
+
263
+ /* ── Hero ────────────────────────────────────────────────────────────────── */
264
+ .hero {
265
+ padding: 6rem 0 5rem;
266
+ border-bottom: 1px solid var(--border);
267
+ position: relative;
268
+ overflow: hidden;
269
+ }
270
+ .hero::before {
271
+ content: '';
272
+ position: absolute;
273
+ top: -120px; left: 50%;
274
+ transform: translateX(-50%);
275
+ width: 800px; height: 600px;
276
+ background: radial-gradient(ellipse, rgba(79,127,255,.07) 0%, transparent 65%);
277
+ pointer-events: none;
278
+ }
279
+
280
+ .hero-grid {
281
+ display: grid;
282
+ grid-template-columns: 1fr 1fr;
283
+ gap: 4rem;
284
+ align-items: center;
285
+ }
286
+
287
+ .hero-badge {
288
+ display: inline-flex;
289
+ align-items: center;
290
+ gap: .5rem;
291
+ background: var(--accent-dim);
292
+ border: 1px solid rgba(79,127,255,.25);
293
+ color: var(--accent);
294
+ border-radius: 100px;
295
+ padding: .3rem 1rem;
296
+ font-size: .78rem;
297
+ font-weight: 600;
298
+ letter-spacing: .04em;
299
+ margin-bottom: 1.5rem;
300
+ }
301
+ .hero-badge i { font-size: .7rem; }
302
+
303
+ .hero-title {
304
+ font-size: clamp(2.4rem, 5vw, 3.8rem);
305
+ font-weight: 900;
306
+ letter-spacing: -.04em;
307
+ line-height: 1.08;
308
+ margin-bottom: 1.25rem;
309
+ }
310
+ .hero-title .accent { color: var(--accent); }
311
+
312
+ .hero-sub {
313
+ font-size: 1.15rem;
314
+ color: var(--muted);
315
+ max-width: 480px;
316
+ margin-bottom: 2.5rem;
317
+ line-height: 1.7;
318
+ }
319
+
320
+ .hero-actions {
321
+ display: flex;
322
+ gap: .75rem;
323
+ flex-wrap: wrap;
324
+ }
325
+
326
+ /* ── Buttons ─────────────────────────────────────────────────────────────── */
327
+ .btn {
328
+ display: inline-flex;
329
+ align-items: center;
330
+ gap: .5rem;
331
+ font-size: .9rem;
332
+ font-weight: 600;
333
+ padding: .65rem 1.4rem;
334
+ border-radius: var(--radius);
335
+ text-decoration: none;
336
+ transition: opacity var(--transition), transform var(--transition), background var(--transition);
337
+ cursor: pointer;
338
+ border: none;
339
+ }
340
+ .btn:hover { opacity: .88; transform: translateY(-1px); text-decoration: none; }
341
+ .btn-primary { background: var(--accent); color: #fff; }
342
+ .btn-outline {
343
+ background: transparent;
344
+ color: var(--text);
345
+ border: 1px solid var(--border-2);
346
+ }
347
+ .btn-outline:hover { border-color: var(--faint); background: var(--surface); }
348
+ .btn-sm { font-size: .8rem; padding: .4rem 1rem; }
349
+
350
+ /* ── Code blocks ─────────────────────────────────────────────────────────── */
351
+ .code-block {
352
+ background: var(--code-bg);
353
+ border: 1px solid var(--code-border);
354
+ border-radius: var(--radius-lg);
355
+ overflow: hidden;
356
+ box-shadow: var(--shadow);
357
+ font-size: .875rem;
358
+ }
359
+
360
+ .code-block-header {
361
+ display: flex;
362
+ align-items: center;
363
+ justify-content: space-between;
364
+ padding: .6rem 1rem;
365
+ background: var(--surface);
366
+ border-bottom: 1px solid var(--border);
367
+ }
368
+
369
+ .code-block-dots {
370
+ display: flex;
371
+ gap: .35rem;
372
+ }
373
+ .code-block-dots span {
374
+ width: 10px; height: 10px;
375
+ border-radius: 50%;
376
+ }
377
+ .code-block-dots span:nth-child(1) { background: #ff5f56; }
378
+ .code-block-dots span:nth-child(2) { background: #febc2e; }
379
+ .code-block-dots span:nth-child(3) { background: #28c840; }
380
+
381
+ .code-block-title {
382
+ font-size: .75rem;
383
+ font-family: var(--mono);
384
+ color: var(--muted);
385
+ font-weight: 500;
386
+ }
387
+
388
+ .code-copy {
389
+ background: none;
390
+ border: 1px solid var(--border-2);
391
+ color: var(--muted);
392
+ font-size: .72rem;
393
+ font-weight: 600;
394
+ font-family: var(--sans);
395
+ padding: .25rem .65rem;
396
+ border-radius: var(--radius-sm);
397
+ cursor: pointer;
398
+ transition: color var(--transition), border-color var(--transition);
399
+ display: flex;
400
+ align-items: center;
401
+ gap: .3rem;
402
+ }
403
+ .code-copy:hover { color: var(--text); border-color: var(--faint); }
404
+ .code-copy.copied { color: var(--green); border-color: rgba(52,211,153,.35); }
405
+
406
+ .code-block pre {
407
+ padding: 1.25rem 1.5rem;
408
+ overflow-x: auto;
409
+ line-height: 1.65;
410
+ tab-size: 4;
411
+ }
412
+
413
+ /* Syntax colours */
414
+ code .kw { color: #c084fc; } /* keywords */
415
+ code .kw2 { color: #818cf8; } /* secondary keywords */
416
+ code .str { color: #6ee7b7; } /* strings */
417
+ code .num { color: #fbbf24; } /* numbers */
418
+ code .cmt { color: #374151; } /* comments */
419
+ code .fn { color: #60a5fa; } /* function names */
420
+ code .op { color: #f472b6; } /* operators */
421
+ code .ok { color: #34d399; } /* success output */
422
+ code .prm { color: #94a3b8; } /* prompt / shell */
423
+
424
+ /* ── Compare split ───────────────────────────────────────────────────────── */
425
+ .compare {
426
+ display: grid;
427
+ grid-template-columns: 1fr 1fr;
428
+ gap: 1rem;
429
+ }
430
+ .compare .code-block-header .code-block-title { color: var(--text); font-size: .8rem; }
431
+
432
+ /* ── Install strip ───────────────────────────────────────────────────────── */
433
+ .install-strip {
434
+ background: var(--surface);
435
+ border: 1px solid var(--border);
436
+ border-radius: var(--radius-lg);
437
+ padding: 1.25rem 1.5rem;
438
+ display: flex;
439
+ align-items: center;
440
+ justify-content: space-between;
441
+ flex-wrap: wrap;
442
+ gap: 1rem;
443
+ margin: 2rem 0;
444
+ }
445
+ .install-strip-label {
446
+ display: flex;
447
+ align-items: center;
448
+ gap: .5rem;
449
+ font-size: .88rem;
450
+ color: var(--muted);
451
+ }
452
+ .install-strip-label i { color: var(--accent); }
453
+ .install-cmd {
454
+ display: flex;
455
+ align-items: center;
456
+ gap: .75rem;
457
+ font-family: var(--mono);
458
+ font-size: .92rem;
459
+ color: var(--green);
460
+ }
461
+ .install-cmd button {
462
+ background: none;
463
+ border: 1px solid var(--border-2);
464
+ color: var(--muted);
465
+ font-size: .72rem;
466
+ font-family: var(--sans);
467
+ padding: .2rem .6rem;
468
+ border-radius: var(--radius-sm);
469
+ cursor: pointer;
470
+ transition: color var(--transition), border-color var(--transition);
471
+ display: flex;
472
+ align-items: center;
473
+ gap: .25rem;
474
+ }
475
+ .install-cmd button:hover { color: var(--text); border-color: var(--faint); }
476
+ .install-cmd button.copied { color: var(--green); border-color: rgba(52,211,153,.35); }
477
+
478
+ /* ── Feature grid ────────────────────────────────────────────────────────── */
479
+ .feature-grid {
480
+ display: grid;
481
+ grid-template-columns: repeat(3, 1fr);
482
+ gap: 1rem;
483
+ margin-top: 2.5rem;
484
+ }
485
+
486
+ .feature-card {
487
+ background: var(--surface);
488
+ border: 1px solid var(--border);
489
+ border-radius: var(--radius-lg);
490
+ padding: 1.75rem;
491
+ transition: border-color var(--transition), box-shadow var(--transition);
492
+ }
493
+ .feature-card:hover {
494
+ border-color: var(--border-2);
495
+ box-shadow: 0 0 0 1px var(--border-2), var(--shadow);
496
+ }
497
+ .feature-card-icon {
498
+ width: 40px; height: 40px;
499
+ background: var(--accent-dim);
500
+ border: 1px solid rgba(79,127,255,.2);
501
+ border-radius: var(--radius);
502
+ display: flex;
503
+ align-items: center;
504
+ justify-content: center;
505
+ margin-bottom: 1.25rem;
506
+ }
507
+ .feature-card-icon i { color: var(--accent); font-size: .95rem; }
508
+ .feature-card h4 {
509
+ font-size: .97rem;
510
+ font-weight: 700;
511
+ margin-bottom: .4rem;
512
+ color: var(--text);
513
+ }
514
+ .feature-card p {
515
+ font-size: .875rem;
516
+ color: var(--muted);
517
+ margin: 0;
518
+ line-height: 1.65;
519
+ }
520
+
521
+ /* ── Why PLINJS ───────────────────────────────────────────────────────────── */
522
+ .why-grid {
523
+ display: grid;
524
+ grid-template-columns: repeat(3, 1fr);
525
+ gap: 2rem;
526
+ margin-top: 3rem;
527
+ }
528
+ .why-item { }
529
+ .why-item .why-num {
530
+ font-size: 2.5rem;
531
+ font-weight: 900;
532
+ color: var(--accent-dim);
533
+ color: rgba(79,127,255,.15);
534
+ font-family: var(--mono);
535
+ letter-spacing: -.04em;
536
+ line-height: 1;
537
+ margin-bottom: .75rem;
538
+ display: flex;
539
+ align-items: center;
540
+ gap: .5rem;
541
+ }
542
+ .why-item .why-num i { font-size: 1.3rem; color: var(--accent); opacity: .7; }
543
+ .why-item h3 { font-size: 1.1rem; font-weight: 700; margin-bottom: .4rem; }
544
+ .why-item p { font-size: .9rem; color: var(--muted); margin: 0; }
545
+
546
+ /* ── Tables ──────────────────────────────────────────────────────────────── */
547
+ .table-wrap {
548
+ width: 100%;
549
+ overflow-x: auto;
550
+ border: 1px solid var(--border);
551
+ border-radius: var(--radius-lg);
552
+ margin: 1.25rem 0;
553
+ }
554
+ table {
555
+ width: 100%;
556
+ border-collapse: collapse;
557
+ font-size: .88rem;
558
+ }
559
+ thead th {
560
+ background: var(--surface);
561
+ color: var(--muted);
562
+ font-weight: 600;
563
+ font-size: .75rem;
564
+ text-transform: uppercase;
565
+ letter-spacing: .07em;
566
+ padding: .75rem 1.25rem;
567
+ text-align: left;
568
+ border-bottom: 1px solid var(--border);
569
+ }
570
+ tbody td {
571
+ padding: .75rem 1.25rem;
572
+ border-bottom: 1px solid var(--border);
573
+ color: var(--muted);
574
+ vertical-align: top;
575
+ }
576
+ tbody td:first-child { color: var(--text); }
577
+ tbody tr:last-child td { border-bottom: none; }
578
+ tbody tr:hover td { background: var(--surface); }
579
+ td code {
580
+ font-size: .83rem;
581
+ background: var(--surface-2);
582
+ border: 1px solid var(--border);
583
+ border-radius: var(--radius-sm);
584
+ padding: .1em .4em;
585
+ color: var(--green);
586
+ }
587
+
588
+ /* ── Callouts ────────────────────────────────────────────────────────────── */
589
+ .callout {
590
+ display: flex;
591
+ gap: .9rem;
592
+ padding: 1rem 1.25rem;
593
+ border-radius: var(--radius);
594
+ border: 1px solid;
595
+ margin: 1.25rem 0;
596
+ font-size: .88rem;
597
+ }
598
+ .callout i { margin-top: .1rem; flex-shrink: 0; font-size: .9rem; }
599
+ .callout-body strong { display: block; margin-bottom: .2rem; font-weight: 600; }
600
+ .callout-body p { font-size: .875rem; margin: 0; }
601
+ .callout-info { background: rgba(79,127,255,.07); border-color: rgba(79,127,255,.25); }
602
+ .callout-info i, .callout-info strong { color: var(--accent); }
603
+ .callout-info p { color: #93aeff; }
604
+ .callout-tip { background: rgba(52,211,153,.07); border-color: rgba(52,211,153,.25); }
605
+ .callout-tip i, .callout-tip strong { color: var(--green); }
606
+ .callout-tip p { color: #6ee7b7; }
607
+ .callout-warning { background: rgba(251,191,36,.07); border-color: rgba(251,191,36,.25); }
608
+ .callout-warning i, .callout-warning strong { color: var(--amber); }
609
+ .callout-warning p { color: #fde68a; }
610
+
611
+ /* ── CLI command strip ───────────────────────────────────────────────────── */
612
+ .cmd-strip {
613
+ display: flex;
614
+ align-items: center;
615
+ gap: .75rem;
616
+ font-family: var(--mono);
617
+ font-size: .875rem;
618
+ background: var(--surface);
619
+ border: 1px solid var(--border);
620
+ border-radius: var(--radius);
621
+ padding: .7rem 1.1rem;
622
+ margin: .5rem 0;
623
+ }
624
+ .cmd-strip .prm { color: var(--green); user-select: none; }
625
+ .cmd-strip .cmd { color: var(--text); }
626
+ .cmd-strip .arg { color: #93c5fd; }
627
+ .cmd-strip .flag { color: var(--amber); }
628
+
629
+ /* ── Keyboard ────────────────────────────────────────────────────────────── */
630
+ kbd {
631
+ display: inline-flex;
632
+ align-items: center;
633
+ font-family: var(--mono);
634
+ font-size: .78em;
635
+ background: var(--surface-2);
636
+ border: 1px solid var(--border-2);
637
+ border-radius: var(--radius-sm);
638
+ padding: .15em .5em;
639
+ color: var(--text);
640
+ box-shadow: 0 2px 0 var(--border);
641
+ vertical-align: .1em;
642
+ }
643
+
644
+ /* ── Badges ──────────────────────────────────────────────────────────────── */
645
+ .badge {
646
+ display: inline-flex;
647
+ align-items: center;
648
+ gap: .3rem;
649
+ font-size: .72rem;
650
+ font-weight: 700;
651
+ letter-spacing: .04em;
652
+ border-radius: 100px;
653
+ padding: .2rem .65rem;
654
+ }
655
+ .badge-blue { background: rgba(79,127,255,.15); color: var(--accent); border: 1px solid rgba(79,127,255,.3); }
656
+ .badge-green { background: rgba(52,211,153,.12); color: var(--green); border: 1px solid rgba(52,211,153,.3); }
657
+ .badge-amber { background: rgba(251,191,36,.12); color: var(--amber); border: 1px solid rgba(251,191,36,.3); }
658
+
659
+ /* ── Roadmap ─────────────────────────────────────────────────────────────── */
660
+ .roadmap {
661
+ position: relative;
662
+ margin-top: 2.5rem;
663
+ }
664
+ .roadmap-item {
665
+ display: flex;
666
+ gap: 2rem;
667
+ margin-bottom: 2.5rem;
668
+ }
669
+ .roadmap-item:last-child { margin-bottom: 0; }
670
+ .roadmap-version {
671
+ flex-shrink: 0;
672
+ width: 80px;
673
+ font-family: var(--mono);
674
+ font-size: .8rem;
675
+ font-weight: 700;
676
+ color: var(--accent);
677
+ padding-top: .2rem;
678
+ text-align: right;
679
+ }
680
+ .roadmap-line-wrap {
681
+ flex-shrink: 0;
682
+ display: flex;
683
+ flex-direction: column;
684
+ align-items: center;
685
+ gap: 0;
686
+ }
687
+ .roadmap-dot {
688
+ width: 12px; height: 12px;
689
+ border-radius: 50%;
690
+ border: 2px solid var(--accent);
691
+ background: var(--bg);
692
+ flex-shrink: 0;
693
+ margin-top: .25rem;
694
+ }
695
+ .roadmap-dot.done { background: var(--accent); }
696
+ .roadmap-connector {
697
+ width: 2px;
698
+ flex: 1;
699
+ background: var(--border-2);
700
+ margin: .3rem 0;
701
+ min-height: 2.5rem;
702
+ }
703
+ .roadmap-content { flex: 1; padding-bottom: .5rem; }
704
+ .roadmap-content h4 { font-size: .97rem; font-weight: 700; margin-bottom: .3rem; }
705
+ .roadmap-content p { font-size: .875rem; color: var(--muted); margin: 0; }
706
+ .roadmap-content ul { margin: .5rem 0 0 1rem; color: var(--muted); font-size: .875rem; }
707
+ .roadmap-content li { margin-bottom: .2rem; }
708
+
709
+ /* ── FAQ ─────────────────────────────────────────────────────────────────── */
710
+ .faq { margin-top: 2.5rem; }
711
+ .faq-item {
712
+ border-bottom: 1px solid var(--border);
713
+ }
714
+ .faq-question {
715
+ width: 100%;
716
+ background: none;
717
+ border: none;
718
+ text-align: left;
719
+ padding: 1.25rem 0;
720
+ font-size: .975rem;
721
+ font-weight: 600;
722
+ color: var(--text);
723
+ cursor: pointer;
724
+ display: flex;
725
+ align-items: center;
726
+ justify-content: space-between;
727
+ gap: 1rem;
728
+ transition: color var(--transition);
729
+ }
730
+ .faq-question:hover { color: var(--accent); }
731
+ .faq-question i {
732
+ font-size: .75rem;
733
+ color: var(--muted);
734
+ transition: transform .2s;
735
+ flex-shrink: 0;
736
+ }
737
+ .faq-item.open .faq-question i { transform: rotate(180deg); color: var(--accent); }
738
+ .faq-answer {
739
+ display: none;
740
+ padding: 0 0 1.25rem;
741
+ font-size: .9rem;
742
+ color: var(--muted);
743
+ line-height: 1.75;
744
+ }
745
+ .faq-answer code { font-size: .82em; }
746
+ .faq-item.open .faq-answer { display: block; }
747
+
748
+ /* ── Stats row ───────────────────────────────────────────────────────────── */
749
+ .stats-row {
750
+ display: grid;
751
+ grid-template-columns: repeat(4, 1fr);
752
+ gap: 1px;
753
+ background: var(--border);
754
+ border: 1px solid var(--border);
755
+ border-radius: var(--radius-lg);
756
+ overflow: hidden;
757
+ margin: 3rem 0;
758
+ }
759
+ .stat-item {
760
+ background: var(--surface);
761
+ padding: 1.75rem 1.5rem;
762
+ text-align: center;
763
+ }
764
+ .stat-value {
765
+ font-size: 2rem;
766
+ font-weight: 900;
767
+ color: var(--text);
768
+ letter-spacing: -.04em;
769
+ line-height: 1;
770
+ margin-bottom: .3rem;
771
+ font-family: var(--mono);
772
+ }
773
+ .stat-value .unit { font-size: 1.2rem; color: var(--accent); }
774
+ .stat-label { font-size: .78rem; color: var(--muted); font-weight: 500; text-transform: uppercase; letter-spacing: .06em; }
775
+
776
+ /* ── Footer ──────────────────────────────────────────────────────────────── */
777
+ .site-footer {
778
+ background: var(--surface);
779
+ border-top: 1px solid var(--border);
780
+ padding: 3rem 0;
781
+ }
782
+ .footer-inner {
783
+ max-width: var(--max-w);
784
+ margin: 0 auto;
785
+ padding: 0 2rem;
786
+ display: grid;
787
+ grid-template-columns: 1.4fr 1fr 1fr 1fr;
788
+ gap: 3rem;
789
+ }
790
+ .footer-brand .footer-logo {
791
+ font-size: 1.1rem;
792
+ font-weight: 800;
793
+ color: var(--text);
794
+ letter-spacing: -.02em;
795
+ margin-bottom: .5rem;
796
+ display: block;
797
+ }
798
+ .footer-brand .footer-logo span { color: var(--accent); }
799
+ .footer-brand p { font-size: .85rem; color: var(--muted); margin: 0 0 1rem; line-height: 1.6; }
800
+ .footer-brand .footer-socials { display: flex; gap: .5rem; }
801
+ .footer-socials a {
802
+ width: 32px; height: 32px;
803
+ display: flex; align-items: center; justify-content: center;
804
+ border: 1px solid var(--border-2);
805
+ border-radius: var(--radius-sm);
806
+ color: var(--muted);
807
+ text-decoration: none;
808
+ font-size: .85rem;
809
+ transition: color var(--transition), border-color var(--transition);
810
+ }
811
+ .footer-socials a:hover { color: var(--text); border-color: var(--faint); }
812
+ .footer-col h5 { font-size: .78rem; font-weight: 700; text-transform: uppercase; letter-spacing: .07em; color: var(--muted); margin-bottom: .9rem; }
813
+ .footer-col ul { list-style: none; }
814
+ .footer-col ul li { margin-bottom: .45rem; }
815
+ .footer-col ul a { font-size: .875rem; color: var(--muted); text-decoration: none; transition: color var(--transition); }
816
+ .footer-col ul a:hover { color: var(--text); }
817
+ .footer-bottom {
818
+ max-width: var(--max-w);
819
+ margin: 2.5rem auto 0;
820
+ padding: 1.5rem 2rem 0;
821
+ border-top: 1px solid var(--border);
822
+ display: flex;
823
+ align-items: center;
824
+ justify-content: space-between;
825
+ flex-wrap: wrap;
826
+ gap: 1rem;
827
+ }
828
+ .footer-bottom p { font-size: .82rem; color: var(--muted); margin: 0; }
829
+ .footer-bottom .version-badge { font-size: .78rem; font-family: var(--mono); }
830
+
831
+ /* ── Two-col layout utility ──────────────────────────────────────────────── */
832
+ .two-col {
833
+ display: grid;
834
+ grid-template-columns: 1fr 1fr;
835
+ gap: 2.5rem;
836
+ align-items: start;
837
+ }
838
+ .two-col-wide {
839
+ display: grid;
840
+ grid-template-columns: 1.1fr 1fr;
841
+ gap: 3rem;
842
+ align-items: start;
843
+ }
844
+
845
+ /* ── Responsive ──────────────────────────────────────────────────────────── */
846
+ @media (max-width: 1024px) {
847
+ .feature-grid { grid-template-columns: repeat(2, 1fr); }
848
+ .why-grid { grid-template-columns: repeat(2, 1fr); }
849
+ .footer-inner { grid-template-columns: 1fr 1fr; gap: 2rem; }
850
+ .stats-row { grid-template-columns: repeat(2, 1fr); }
851
+ }
852
+
853
+ @media (max-width: 800px) {
854
+ .hero-grid { grid-template-columns: 1fr; gap: 2.5rem; }
855
+ .compare { grid-template-columns: 1fr; }
856
+ .two-col, .two-col-wide { grid-template-columns: 1fr; }
857
+ .nav-links { display: none; }
858
+ .nav-hamburger { display: flex; }
859
+ .nav-actions .nav-cta span { display: none; }
860
+ }
861
+
862
+ @media (max-width: 600px) {
863
+ .container { padding: 0 1.25rem; }
864
+ .section { padding: 3.5rem 0; }
865
+ .hero { padding: 4rem 0 3rem; }
866
+ .feature-grid { grid-template-columns: 1fr; }
867
+ .why-grid { grid-template-columns: 1fr; }
868
+ .footer-inner { grid-template-columns: 1fr; gap: 1.75rem; }
869
+ .stats-row { grid-template-columns: repeat(2, 1fr); }
870
+ .roadmap-item { flex-direction: column; gap: .5rem; }
871
+ .roadmap-version { text-align: left; width: auto; }
872
+ .roadmap-line-wrap { display: none; }
873
+ }
874
+
875
+ /* ============================================================
876
+ v2.0.1 — Interface & experience enhancements
877
+ ============================================================ */
878
+
879
+ /* ── "New in vX" pill ───────────────────────────────────────────────────── */
880
+ .tag-new {
881
+ display: inline-flex;
882
+ align-items: center;
883
+ font-size: .62rem;
884
+ font-weight: 700;
885
+ letter-spacing: .08em;
886
+ text-transform: uppercase;
887
+ font-family: var(--sans);
888
+ color: var(--green);
889
+ background: rgba(52,211,153,.10);
890
+ border: 1px solid rgba(52,211,153,.3);
891
+ border-radius: 100px;
892
+ padding: .14rem .55rem;
893
+ margin-left: .5rem;
894
+ vertical-align: middle;
895
+ white-space: nowrap;
896
+ }
897
+ td .tag-new { font-size: .58rem; padding: .08rem .45rem; margin-left: .35rem; }
898
+
899
+ /* ── Scroll progress bar ─────────────────────────────────────────────────── */
900
+ #scroll-progress {
901
+ position: fixed;
902
+ top: 0;
903
+ left: 0;
904
+ height: 2px;
905
+ width: 0;
906
+ background: linear-gradient(90deg, var(--accent), #8b5cf6 60%, var(--green));
907
+ z-index: 300;
908
+ transition: width 80ms linear;
909
+ pointer-events: none;
910
+ }
911
+
912
+ /* ── Back to top ─────────────────────────────────────────────────────────── */
913
+ .to-top {
914
+ position: fixed;
915
+ right: 1.5rem;
916
+ bottom: 1.5rem;
917
+ z-index: 250;
918
+ width: 42px;
919
+ height: 42px;
920
+ display: flex;
921
+ align-items: center;
922
+ justify-content: center;
923
+ background: var(--surface-2);
924
+ border: 1px solid var(--border-2);
925
+ border-radius: 50%;
926
+ color: var(--muted);
927
+ font-size: .85rem;
928
+ cursor: pointer;
929
+ opacity: 0;
930
+ transform: translateY(8px);
931
+ pointer-events: none;
932
+ transition: opacity var(--transition), transform var(--transition),
933
+ color var(--transition), border-color var(--transition), background var(--transition);
934
+ box-shadow: var(--shadow);
935
+ }
936
+ .to-top.visible {
937
+ opacity: 1;
938
+ transform: translateY(0);
939
+ pointer-events: auto;
940
+ }
941
+ .to-top:hover {
942
+ color: var(--text);
943
+ border-color: var(--faint);
944
+ background: var(--surface);
945
+ }
946
+
947
+ /* ── Reveal on scroll ────────────────────────────────────────────────────── */
948
+ .reveal {
949
+ opacity: 0;
950
+ transform: translateY(18px);
951
+ transition: opacity .5s ease, transform .5s ease;
952
+ will-change: opacity, transform;
953
+ }
954
+ .reveal.visible {
955
+ opacity: 1;
956
+ transform: translateY(0);
957
+ }
958
+
959
+ @media (prefers-reduced-motion: reduce) {
960
+ html { scroll-behavior: auto; }
961
+ .reveal {
962
+ opacity: 1;
963
+ transform: none;
964
+ transition: none;
965
+ }
966
+ #scroll-progress { transition: none; }
967
+ .to-top { transition: opacity var(--transition); transform: none; }
968
+ *, *::before, *::after {
969
+ animation-duration: .01ms !important;
970
+ animation-iteration-count: 1 !important;
971
+ }
972
+ }
973
+
974
+ /* ── Keyboard focus visibility (a11y) ────────────────────────────────────── */
975
+ a:focus-visible,
976
+ button:focus-visible,
977
+ .faq-question:focus-visible,
978
+ .code-copy:focus-visible,
979
+ .to-top:focus-visible {
980
+ outline: 2px solid var(--accent);
981
+ outline-offset: 2px;
982
+ border-radius: var(--radius-sm);
983
+ }
984
+
985
+ /* ── Active nav link (set by scroll spy) ─────────────────────────────────── */
986
+ .nav-links a.active {
987
+ color: var(--text);
988
+ background: var(--surface);
989
+ }
990
+
991
+ /* ── Code block hover polish ─────────────────────────────────────────────── */
992
+ .code-block {
993
+ transition: border-color var(--transition), box-shadow var(--transition);
994
+ }
995
+ .code-block:hover {
996
+ border-color: var(--border-2);
997
+ box-shadow: var(--shadow-lg);
998
+ }
999
+
1000
+ /* ============================================================
1001
+ v2.1.1 — Mobile experience refinements
1002
+ ============================================================ */
1003
+
1004
+ /* ── Touch feel ──────────────────────────────────────────────────────────── */
1005
+ html {
1006
+ -webkit-tap-highlight-color: rgba(79,127,255,.16);
1007
+ text-size-adjust: 100%;
1008
+ -webkit-text-size-adjust: 100%;
1009
+ }
1010
+ a, button,
1011
+ .faq-question, .code-copy, .to-top {
1012
+ touch-action: manipulation;
1013
+ }
1014
+
1015
+ /* ── Hamburger: a comfortable tap target ─────────────────────────────────── */
1016
+ .nav-hamburger {
1017
+ width: 42px;
1018
+ height: 42px;
1019
+ align-items: center;
1020
+ justify-content: center;
1021
+ margin-left: .25rem;
1022
+ }
1023
+
1024
+ /* ── Mobile menu: animated, scrollable, notch-aware ─────────────────────── */
1025
+ .mobile-menu {
1026
+ display: block;
1027
+ position: fixed;
1028
+ top: var(--nav-h);
1029
+ left: 0; right: 0;
1030
+ background: var(--bg-alt);
1031
+ border-bottom: 1px solid var(--border);
1032
+ z-index: 199;
1033
+ padding: .5rem 1.5rem calc(1.25rem + env(safe-area-inset-bottom, 0px));
1034
+ max-height: calc(100vh - var(--nav-h));
1035
+ max-height: calc(100dvh - var(--nav-h));
1036
+ overflow-y: auto;
1037
+ -webkit-overflow-scrolling: touch;
1038
+ overscroll-behavior: contain;
1039
+ visibility: hidden;
1040
+ opacity: 0;
1041
+ transform: translateY(-10px);
1042
+ pointer-events: none;
1043
+ transition: transform .22s ease, opacity .22s ease, visibility 0s linear .22s;
1044
+ box-shadow: var(--shadow-lg);
1045
+ }
1046
+ .mobile-menu.open {
1047
+ visibility: visible;
1048
+ opacity: 1;
1049
+ transform: translateY(0);
1050
+ pointer-events: auto;
1051
+ transition: transform .22s ease, opacity .22s ease, visibility 0s;
1052
+ }
1053
+ .mobile-menu a { padding: .8rem 0; }
1054
+ .mobile-menu a:last-child { border-bottom: none; }
1055
+
1056
+ /* Lock page scroll while the menu is open (toggled by script.js) */
1057
+ body.menu-open { overflow: hidden; }
1058
+
1059
+ @media (max-width: 800px) and (min-width: 481px) {
1060
+ /* Room for the longer feature list on large phones / small tablets */
1061
+ .mobile-menu { column-count: 2; column-gap: 2rem; }
1062
+ .mobile-menu a { break-inside: avoid; }
1063
+ }
1064
+
1065
+ /* ── Code blocks on phones ──────────────────────────────────────────────── */
1066
+ .code-block pre,
1067
+ .table-wrap {
1068
+ -webkit-overflow-scrolling: touch;
1069
+ scrollbar-width: thin;
1070
+ }
1071
+ .table-wrap table { min-width: 560px; }
1072
+
1073
+ @media (max-width: 600px) {
1074
+ .section { padding: 3rem 0; }
1075
+ .hero { padding: 3.5rem 0 2.5rem; }
1076
+
1077
+ .code-block { font-size: .82rem; }
1078
+ .code-block pre { padding: 1rem; line-height: 1.6; }
1079
+ .code-block-header { padding: .55rem .75rem .55rem 1rem; gap: .5rem; }
1080
+ .code-copy {
1081
+ font-size: .7rem;
1082
+ padding: .38rem .6rem;
1083
+ min-height: 34px;
1084
+ align-items: center;
1085
+ }
1086
+ .code-block-dots span { width: 8px; height: 8px; }
1087
+
1088
+ .table-wrap table { min-width: 480px; }
1089
+ thead th, tbody td { padding: .6rem .85rem; }
1090
+
1091
+ .callout { padding: .9rem 1rem; }
1092
+ }
1093
+
1094
+ @media (max-width: 400px) {
1095
+ .code-block-dots { display: none; }
1096
+ .code-block-title { font-size: .72rem; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
1097
+ }
1098
+
1099
+ /* Long inline code must never blow out narrow viewports */
1100
+ p code, li code, td code, .faq-answer code {
1101
+ overflow-wrap: anywhere;
1102
+ }
1103
+
1104
+ /* ── Hero & install strips on small screens ─────────────────────────────── */
1105
+ @media (max-width: 480px) {
1106
+ .hero-actions { flex-direction: column; align-items: stretch; }
1107
+ .hero-actions .btn { justify-content: center; }
1108
+ .install-strip { flex-direction: column; align-items: stretch; }
1109
+ .install-cmd { justify-content: space-between; }
1110
+ .cmd-strip { font-size: .78rem; }
1111
+ }
1112
+
1113
+ /* ── Safe-area aware floating button ────────────────────────────────────── */
1114
+ .to-top {
1115
+ right: calc(1.25rem + env(safe-area-inset-right, 0px));
1116
+ bottom: calc(1.25rem + env(safe-area-inset-bottom, 0px));
1117
+ }