flexr 1.1.0 → 2.0.0

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 (133) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +2 -1
  3. data/CHANGELOG.md +116 -0
  4. data/CONTRIBUTING.md +46 -3
  5. data/README.md +5 -4
  6. data/Rakefile +191 -68
  7. data/Steepfile +7 -0
  8. data/benchmark/baselines/json.json +2 -2
  9. data/benchmark/golden/calculator_lexer.rb +276 -0
  10. data/benchmark/golden/graphql_lexer.rb +310 -0
  11. data/benchmark/golden/json_lexer.rb +292 -0
  12. data/benchmark/golden/regexp_tokenizer.rb +293 -0
  13. data/benchmark/golden/ruby_subset_lexer.rb +280 -0
  14. data/benchmark/golden/sql_lexer.rb +293 -0
  15. data/benchmark/golden/toml_lexer.rb +292 -0
  16. data/benchmark/golden/toy_lang_lexer.rb +273 -0
  17. data/benchmark/golden/with_lrama_lexer.rb +264 -0
  18. data/benchmark/golden/with_racc_lexer.rb +264 -0
  19. data/benchmark/lrama_lexer.rb +165 -0
  20. data/benchmark/matrix.rb +79 -0
  21. data/benchmark/profile.rb +109 -0
  22. data/benchmark/run.rb +4 -1
  23. data/benchmark/state_dispatch.rb +78 -0
  24. data/docs/README.md +1 -2
  25. data/docs/RELEASING.md +3 -2
  26. data/docs/explanation/backends.md +17 -0
  27. data/docs/how-to/deploy-a-standalone-lexer.md +1 -1
  28. data/docs/how-to/tune-performance.md +12 -0
  29. data/docs/migration-v2.md +74 -0
  30. data/docs/perf-log.md +196 -0
  31. data/docs/reference/README.md +2 -0
  32. data/docs/reference/cli.md +71 -5
  33. data/docs/reference/compatibility.md +10 -4
  34. data/docs/reference/diagnostics.md +338 -0
  35. data/docs/reference/dsl.md +12 -5
  36. data/docs/reference/errors.md +28 -0
  37. data/docs/reference/generated-artifacts.md +42 -4
  38. data/docs/reference/public-api.md +33 -8
  39. data/docs/reference/regexp.md +19 -7
  40. data/docs/reference/ruby-lsp.md +34 -0
  41. data/docs/reference/runtime.md +2 -2
  42. data/docs/reference/testing.md +57 -0
  43. data/docs/reference/tokens-and-locations.md +8 -0
  44. data/examples/graphql/README.md +14 -0
  45. data/examples/graphql/lexer.flexr.rb +29 -0
  46. data/examples/json/lexer.flexr.rb +6 -6
  47. data/examples/sql/README.md +16 -0
  48. data/examples/sql/lexer.flexr.rb +23 -0
  49. data/examples/toml/README.md +14 -0
  50. data/examples/toml/lexer.flexr.rb +23 -0
  51. data/gemfiles/ruby_lsp.gemfile +4 -0
  52. data/gemfiles/types.gemfile +7 -0
  53. data/lib/flexr/automaton/accel.rb +69 -1
  54. data/lib/flexr/automaton/analysis.rb +161 -7
  55. data/lib/flexr/automaton/compiler.rb +179 -25
  56. data/lib/flexr/automaton/types.rb +1 -1
  57. data/lib/flexr/cli.rb +117 -17
  58. data/lib/flexr/codegen/firstmatch.rb +1 -7
  59. data/lib/flexr/codegen/table.rb +8 -2
  60. data/lib/flexr/configuration.rb +8 -0
  61. data/lib/flexr/diagnostics.rb +39 -3
  62. data/lib/flexr/dsl.rb +12 -9
  63. data/lib/flexr/errors.rb +6 -6
  64. data/lib/flexr/generated.rb +65 -17
  65. data/lib/flexr/generator.rb +62 -34
  66. data/lib/flexr/grammar.rb +41 -0
  67. data/lib/flexr/ir.rb +2 -2
  68. data/lib/flexr/migration.rb +31 -0
  69. data/lib/flexr/minitest.rb +24 -0
  70. data/lib/flexr/options.rb +4 -2
  71. data/lib/flexr/regexp/matcher.rb +26 -0
  72. data/lib/flexr/regexp/normalizer.rb +4 -8
  73. data/lib/flexr/regexp/parser.rb +127 -21
  74. data/lib/flexr/regexp/tokenizer.rb +26 -26
  75. data/lib/flexr/rspec.rb +51 -0
  76. data/lib/flexr/runtime/core.rb +47 -17
  77. data/lib/flexr/runtime/errors.rb +6 -4
  78. data/lib/flexr/runtime/interpreter.rb +55 -46
  79. data/lib/flexr/runtime/location.rb +35 -12
  80. data/lib/flexr/runtime/record.rb +14 -0
  81. data/lib/flexr/runtime/token.rb +7 -1
  82. data/lib/flexr/runtime.rb +7 -2
  83. data/lib/flexr/source/passthrough.rb +14 -11
  84. data/lib/flexr/source/prism_reader.rb +53 -16
  85. data/lib/flexr/testing.rb +47 -0
  86. data/lib/flexr/trace.rb +197 -0
  87. data/lib/flexr/unicode/property.rb +1 -3
  88. data/lib/flexr/unicode/reference_regexp.rb +8 -10
  89. data/lib/flexr/version.rb +1 -1
  90. data/lib/flexr.rb +1 -0
  91. data/lib/ruby_lsp/flexr/addon.rb +114 -0
  92. data/sig/flexr.rbs +191 -0
  93. data/site/README.md +54 -3
  94. data/site/astro.config.mjs +3 -1
  95. data/site/package.json +12 -5
  96. data/site/playwright.config.mjs +16 -0
  97. data/site/pnpm-lock.yaml +218 -88
  98. data/site/ruby/playground.rb +57 -0
  99. data/site/scripts/prepare-playground.mjs +35 -0
  100. data/site/scripts/verify-site.mjs +5 -3
  101. data/site/src/content/docs/concepts/matching-semantics.md +4 -2
  102. data/site/src/content/docs/concepts/security-model.md +9 -1
  103. data/site/src/content/docs/learn/generation.md +1 -1
  104. data/site/src/content/docs/reference/dsl.md +2 -2
  105. data/site/src/content/docs/reference/public-api.md +4 -2
  106. data/site/src/content/docs/reference/tokens-and-locations.md +3 -0
  107. data/site/src/layouts/SiteLayout.astro +11 -3
  108. data/site/src/pages/index.astro +69 -155
  109. data/site/src/pages/playground.astro +40 -38
  110. data/site/src/playground/client.js +211 -0
  111. data/site/src/playground/graph-worker.mjs +11 -0
  112. data/site/src/playground/presets.mjs +33 -0
  113. data/site/src/playground/runtime.mjs +34 -0
  114. data/site/src/playground/share.mjs +30 -0
  115. data/site/src/playground/worker.mjs +29 -0
  116. data/site/src/styles/custom.css +12 -287
  117. data/site/src/styles/landing.css +239 -0
  118. data/site/tests/browser/playground.spec.mjs +99 -0
  119. data/site/tests/playground-runtime.test.mjs +85 -0
  120. data/test/ruby_lsp_addon_spec.rb +135 -0
  121. data/tools/docs_verify.rb +3 -2
  122. data/tools/golden.rb +54 -0
  123. data/tools/verification_failure.rb +119 -0
  124. metadata +56 -13
  125. data/benchmark/golden/calculator_lexer.sha256 +0 -1
  126. data/benchmark/golden/json_lexer.sha256 +0 -1
  127. data/benchmark/golden/regexp_tokenizer.sha256 +0 -1
  128. data/benchmark/golden/ruby_subset_lexer.sha256 +0 -1
  129. data/benchmark/golden/toy_lang_lexer.sha256 +0 -1
  130. data/benchmark/golden/with_lrama_lexer.sha256 +0 -1
  131. data/benchmark/golden/with_racc_lexer.sha256 +0 -1
  132. data/docs/releases/v1.1.0.md +0 -44
  133. data/site/public/playground.js +0 -189
@@ -26,8 +26,8 @@
26
26
  --flexr-blue: #28658a;
27
27
  --flexr-red: #b54848;
28
28
  --flexr-code: #192a24;
29
- --sl-font: "IBM Plex Sans", ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
30
- --sl-font-mono: "JetBrains Mono", "SFMono-Regular", Consolas, "Liberation Mono", monospace;
29
+ --sl-font: "Public Sans", ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
30
+ --sl-font-mono: "SFMono-Regular", Consolas, "Liberation Mono", monospace;
31
31
  }
32
32
 
33
33
  html {
@@ -106,7 +106,6 @@ textarea {
106
106
  font-family: var(--sl-font-mono);
107
107
  font-size: 1rem;
108
108
  font-weight: 700;
109
- letter-spacing: -0.08em;
110
109
  text-decoration: none;
111
110
  }
112
111
 
@@ -164,12 +163,6 @@ textarea {
164
163
  transform: translateY(-1px);
165
164
  }
166
165
 
167
- .site-mark {
168
- font-family: var(--sl-font-mono);
169
- font-weight: 700;
170
- letter-spacing: -0.07em;
171
- }
172
-
173
166
  .eyebrow {
174
167
  color: var(--flexr-green);
175
168
  font-family: var(--sl-font-mono);
@@ -179,57 +172,6 @@ textarea {
179
172
  text-transform: uppercase;
180
173
  }
181
174
 
182
- .home-shell {
183
- overflow: hidden;
184
- background:
185
- linear-gradient(rgba(23, 39, 31, 0.035) 1px, transparent 1px),
186
- linear-gradient(90deg, rgba(23, 39, 31, 0.035) 1px, transparent 1px),
187
- var(--flexr-canvas);
188
- background-size: 4rem 4rem;
189
- }
190
-
191
- .home-hero,
192
- .home-section,
193
- .site-footer {
194
- width: min(1160px, calc(100% - 2.5rem));
195
- margin-inline: auto;
196
- }
197
-
198
- .home-hero {
199
- display: grid;
200
- grid-template-columns: minmax(0, 1.03fr) minmax(360px, 0.97fr);
201
- align-items: center;
202
- gap: 5.5rem;
203
- padding: 7.25rem 0 6.5rem;
204
- }
205
-
206
- .home-hero h1 {
207
- max-width: 10ch;
208
- margin: 1.1rem 0 1.4rem;
209
- color: var(--flexr-ink);
210
- font-family: var(--sl-font);
211
- font-size: clamp(3.1rem, 6vw, 5.5rem);
212
- font-weight: 600;
213
- line-height: 0.98;
214
- letter-spacing: -0.075em;
215
- }
216
-
217
- .hero-copy {
218
- max-width: 36rem;
219
- color: var(--flexr-muted);
220
- font-size: clamp(1.05rem, 1.7vw, 1.2rem);
221
- line-height: 1.72;
222
- }
223
-
224
- .hero-actions,
225
- .home-links {
226
- display: flex;
227
- flex-wrap: wrap;
228
- gap: 0.7rem;
229
- align-items: center;
230
- margin-top: 2rem;
231
- }
232
-
233
175
  .button {
234
176
  display: inline-flex;
235
177
  min-height: 2.85rem;
@@ -271,36 +213,6 @@ textarea {
271
213
  background: var(--flexr-paper);
272
214
  }
273
215
 
274
- .demo-window {
275
- overflow: hidden;
276
- border: 1px solid #2b4037;
277
- border-radius: 0.55rem;
278
- background: var(--flexr-code);
279
- box-shadow: 0 1.5rem 3rem rgba(23, 39, 31, 0.13);
280
- }
281
-
282
- .window-bar {
283
- display: flex;
284
- gap: 0.45rem;
285
- align-items: center;
286
- padding: 0.85rem 1rem;
287
- border-bottom: 1px solid rgba(216, 235, 225, 0.14);
288
- color: #94aaa0;
289
- font-family: var(--sl-font-mono);
290
- font-size: 0.68rem;
291
- }
292
-
293
- .window-dot {
294
- width: 0.5rem;
295
- height: 0.5rem;
296
- border-radius: 999px;
297
- background: #61746b;
298
- }
299
-
300
- .window-dot:first-child { background: #d38d7c; }
301
- .window-dot:nth-child(2) { background: #c5ad6e; }
302
- .window-dot:nth-child(3) { background: #69ad8e; }
303
-
304
216
  .code-block {
305
217
  margin: 0;
306
218
  padding: 1.35rem;
@@ -317,191 +229,6 @@ textarea {
317
229
  .code-method { color: #90cbd0; }
318
230
  .code-number { color: #dbc786; }
319
231
 
320
- .decision-panel {
321
- padding: 1rem 1.35rem 1.25rem;
322
- border-top: 1px solid rgba(216, 235, 225, 0.14);
323
- }
324
-
325
- .decision-label {
326
- display: flex;
327
- justify-content: space-between;
328
- margin-bottom: 0.7rem;
329
- color: #8fa89b;
330
- font-family: var(--sl-font-mono);
331
- font-size: 0.66rem;
332
- }
333
-
334
- .decision-label strong { color: #d8e9df; font-weight: 500; }
335
-
336
- .decision-row {
337
- display: grid;
338
- grid-template-columns: 1fr auto;
339
- gap: 1rem;
340
- padding: 0.58rem 0;
341
- border-top: 1px solid rgba(216, 235, 225, 0.11);
342
- font-family: var(--sl-font-mono);
343
- font-size: 0.7rem;
344
- }
345
-
346
- .decision-row strong { color: #d8e9df; font-weight: 500; }
347
- .decision-row span { color: #8fa89b; }
348
- .decision-row.winner strong { color: #9ed3b0; }
349
- .decision-row.winner span { color: #9ed3b0; }
350
-
351
- .home-section {
352
- padding: 6.25rem 0;
353
- border-top: 1px solid var(--flexr-line);
354
- }
355
-
356
- .section-heading {
357
- display: flex;
358
- justify-content: space-between;
359
- align-items: end;
360
- gap: 3rem;
361
- margin-bottom: 2.7rem;
362
- }
363
-
364
- .section-heading h2 {
365
- max-width: 16ch;
366
- margin: 0.7rem 0 0;
367
- color: var(--flexr-ink);
368
- font-family: var(--sl-font);
369
- font-size: clamp(2rem, 4vw, 3.2rem);
370
- font-weight: 600;
371
- line-height: 1.05;
372
- letter-spacing: -0.065em;
373
- }
374
-
375
- .section-heading p {
376
- max-width: 31rem;
377
- margin: 0;
378
- color: var(--flexr-muted);
379
- font-size: 0.98rem;
380
- line-height: 1.75;
381
- }
382
-
383
- .card-grid {
384
- display: grid;
385
- grid-template-columns: repeat(2, minmax(0, 1fr));
386
- gap: 0;
387
- border-top: 1px solid var(--flexr-line-strong);
388
- border-left: 1px solid var(--flexr-line-strong);
389
- }
390
-
391
- .site-card {
392
- min-height: 10rem;
393
- padding: 1.5rem 1.6rem;
394
- border-right: 1px solid var(--flexr-line-strong);
395
- border-bottom: 1px solid var(--flexr-line-strong);
396
- background: rgba(255, 255, 255, 0.48);
397
- }
398
-
399
- .site-card:hover {
400
- background: rgba(255, 255, 255, 0.88);
401
- }
402
-
403
- .site-card h3,
404
- .workflow-step h3,
405
- .trust-panel h3 {
406
- margin: 0.8rem 0 0.55rem;
407
- color: var(--flexr-ink);
408
- font-size: 1rem;
409
- font-weight: 600;
410
- letter-spacing: -0.02em;
411
- }
412
-
413
- .site-card p,
414
- .workflow-step p,
415
- .trust-panel p {
416
- max-width: 31rem;
417
- margin: 0;
418
- color: var(--flexr-muted);
419
- font-size: 0.9rem;
420
- line-height: 1.7;
421
- }
422
-
423
- .card-index {
424
- color: var(--flexr-green);
425
- font-family: var(--sl-font-mono);
426
- font-size: 0.65rem;
427
- font-weight: 700;
428
- letter-spacing: 0.08em;
429
- }
430
-
431
- .workflow-grid {
432
- display: grid;
433
- grid-template-columns: repeat(4, minmax(0, 1fr));
434
- gap: 1.25rem;
435
- }
436
-
437
- .workflow-step {
438
- padding-top: 1.1rem;
439
- border-top: 2px solid var(--flexr-line-strong);
440
- }
441
-
442
- .workflow-step:first-child { border-color: var(--flexr-green); }
443
- .workflow-step h3 { font-family: var(--sl-font-mono); font-size: 0.82rem; }
444
-
445
- .compare-panel {
446
- display: grid;
447
- grid-template-columns: 1fr 1fr;
448
- gap: 1px;
449
- overflow: hidden;
450
- border: 1px solid var(--flexr-line-strong);
451
- background: var(--flexr-line-strong);
452
- }
453
-
454
- .compare-panel > div {
455
- min-height: 12rem;
456
- padding: 1.7rem;
457
- background: rgba(255, 255, 255, 0.72);
458
- }
459
-
460
- .compare-panel h3 {
461
- margin: 0 0 1rem;
462
- color: var(--flexr-green-dark);
463
- font-family: var(--sl-font-mono);
464
- font-size: 0.78rem;
465
- }
466
-
467
- .compare-panel p {
468
- max-width: 30rem;
469
- margin: 0;
470
- color: var(--flexr-muted);
471
- line-height: 1.75;
472
- }
473
-
474
- .compare-panel code {
475
- padding: 0.12rem 0.3rem;
476
- color: var(--flexr-green-dark);
477
- background: var(--flexr-green-soft);
478
- font-family: var(--sl-font-mono);
479
- font-size: 0.8em;
480
- }
481
-
482
- .trust-grid {
483
- display: grid;
484
- grid-template-columns: repeat(4, minmax(0, 1fr));
485
- gap: 2rem;
486
- }
487
-
488
- .trust-panel {
489
- padding-top: 1.15rem;
490
- border-top: 1px solid var(--flexr-line-strong);
491
- }
492
-
493
- .trust-panel h3 { font-size: 0.95rem; }
494
- .trust-panel .home-links { margin-top: 1.1rem; }
495
-
496
- .site-footer {
497
- padding: 2rem 0 4rem;
498
- border-top: 1px solid var(--flexr-line);
499
- color: var(--flexr-muted);
500
- font-size: 0.82rem;
501
- }
502
-
503
- .site-footer a { color: var(--flexr-green); }
504
-
505
232
  .playground-shell {
506
233
  min-height: calc(100vh - 4.25rem);
507
234
  padding: 4.5rem max(1.25rem, calc((100vw - 1160px) / 2)) 6rem;
@@ -668,6 +395,14 @@ textarea {
668
395
  .result-table td { color: var(--flexr-ink); }
669
396
  .winner-text { color: var(--flexr-green-dark) !important; }
670
397
  .workbench-status { min-height: 1.4rem; margin: 0; color: var(--flexr-muted); font-size: 0.78rem; }
398
+ .workbench pre { margin: 0; min-height: 4rem; white-space: pre-wrap; overflow-wrap: anywhere; max-height: 36rem; overflow: auto; font-size: 0.78rem; }
399
+ .workbench summary { padding: 1rem; cursor: pointer; }
400
+ .workbench button:disabled { opacity: 0.55; cursor: default; }
401
+ .workbench input[type="range"] { flex: 1; min-width: 5rem; }
402
+ .workbench .share-link { box-sizing: border-box; width: 100%; padding: 0.75rem; }
403
+ .workbench .workbench-status { padding: 0.5rem 1rem; }
404
+ .graph-output { overflow: auto; max-height: 36rem; }
405
+ .graph-output svg { min-width: 20rem; max-width: none; }
671
406
  .back-link { display: inline-flex; margin-bottom: 1.5rem; color: var(--flexr-green); font-family: var(--sl-font-mono); font-size: 0.72rem; }
672
407
 
673
408
  .sl-markdown-content a,
@@ -680,21 +415,11 @@ textarea {
680
415
  background: var(--flexr-green-soft);
681
416
  }
682
417
 
683
- @media (max-width: 920px) {
684
- .home-hero { grid-template-columns: 1fr; gap: 3rem; padding-top: 5.5rem; }
685
- .home-hero h1 { max-width: 12ch; }
686
- .workflow-grid, .trust-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
687
- }
688
-
689
418
  @media (max-width: 700px) {
690
419
  .site-nav-links { display: none; }
691
- .site-nav-inner, .home-hero, .home-section, .site-footer { width: min(100% - 1.5rem, 1160px); }
420
+ .site-nav-inner { width: min(100% - 1.5rem, 1160px); }
692
421
  .site-nav-inner { min-height: 3.9rem; }
693
- .home-hero { padding: 4rem 0 4.5rem; }
694
- .home-section { padding: 4.5rem 0; }
695
- .section-heading { display: block; }
696
- .section-heading p { margin-top: 1rem; }
697
- .card-grid, .workflow-grid, .trust-grid, .compare-panel, .workbench { grid-template-columns: 1fr; }
422
+ .workbench { grid-template-columns: 1fr; }
698
423
  .workbench-panel.full { grid-column: auto; }
699
424
  .playground-shell { padding: 3rem 0.75rem 4rem; }
700
425
  }
@@ -0,0 +1,239 @@
1
+ .landing {
2
+ --ink: #f3f0eb;
3
+ --muted: #aaa5a0;
4
+ --paper: #161518;
5
+ --surface: #211e23;
6
+ --line: #3f3a40;
7
+ --accent: #ef6b7a;
8
+ color: var(--ink);
9
+ background: var(--paper);
10
+ overflow-x: clip;
11
+ }
12
+
13
+ html,
14
+ body { color-scheme: dark; background: #161518; }
15
+ ::selection { color: #161518; background: #ef6b7a; }
16
+ :focus-visible { outline-color: #ef6b7a; }
17
+ .skip-link { color: #161518; background: #ef6b7a; }
18
+ .site-nav { border-color: #3f3a40; background: #161518; backdrop-filter: none; }
19
+ .site-nav-brand { color: #f3f0eb; }
20
+ .site-nav-brand::before { background: #ef6b7a; }
21
+ .site-nav-brand span { color: #ef6b7a; }
22
+ .site-nav-links a { display: inline-flex; min-height: 2.75rem; align-items: center; color: #aaa5a0; transition: none; }
23
+ .site-nav-links a:hover { color: #f3f0eb; }
24
+ .site-nav-cta { min-height: 2.75rem; color: #161518; border-radius: 0; background: #f3f0eb; transition: none; }
25
+ .site-nav-cta:hover { color: #161518; background: #ef6b7a; transform: none; }
26
+
27
+ .landing h1,
28
+ .landing h2 {
29
+ font-family: "Newsreader", Georgia, serif;
30
+ font-weight: 500;
31
+ text-wrap: balance;
32
+ }
33
+
34
+ .landing p { text-wrap: pretty; }
35
+
36
+ .hero,
37
+ .specimen,
38
+ .principles,
39
+ .start,
40
+ .landing-footer {
41
+ box-sizing: border-box;
42
+ width: min(1160px, calc(100% - 3rem));
43
+ margin-inline: auto;
44
+ }
45
+
46
+ .hero {
47
+ display: grid;
48
+ grid-template-columns: minmax(0, 1.65fr) minmax(18rem, 0.75fr);
49
+ gap: clamp(3rem, 8vw, 8rem);
50
+ align-items: end;
51
+ min-height: min(46rem, 78dvh);
52
+ padding-block: clamp(5rem, 10vw, 9rem) clamp(4rem, 8vw, 7rem);
53
+ }
54
+
55
+ .hero-heading > p,
56
+ .specimen header p,
57
+ .principles header > p,
58
+ .start > div > p {
59
+ margin: 0 0 1.25rem;
60
+ color: var(--accent);
61
+ font-size: 0.84rem;
62
+ font-weight: 600;
63
+ }
64
+
65
+ .hero h1 {
66
+ max-width: 10ch;
67
+ margin: 0;
68
+ font-size: clamp(4.25rem, 8.5vw, 7.75rem);
69
+ line-height: 0.86;
70
+ }
71
+
72
+ .hero h1 em { color: inherit; font-weight: 400; }
73
+
74
+ .hero-intro > p {
75
+ margin: 0;
76
+ color: var(--muted);
77
+ font-size: clamp(1rem, 1.5vw, 1.14rem);
78
+ line-height: 1.75;
79
+ }
80
+
81
+ .hero-actions {
82
+ display: flex;
83
+ flex-wrap: wrap;
84
+ gap: 0.75rem 1.25rem;
85
+ align-items: center;
86
+ margin-top: 2rem;
87
+ }
88
+
89
+ .action {
90
+ box-sizing: border-box;
91
+ display: inline-flex;
92
+ min-height: 2.75rem;
93
+ align-items: center;
94
+ justify-content: center;
95
+ color: var(--ink);
96
+ font-size: 0.88rem;
97
+ font-weight: 600;
98
+ text-decoration: none;
99
+ }
100
+
101
+ .action-primary { padding: 0.7rem 1rem; color: var(--paper); background: var(--ink); }
102
+ .action-primary:hover { color: var(--paper); background: var(--accent); }
103
+ .action-link { border-bottom: 1px solid var(--ink); }
104
+ .action-link:hover { color: var(--accent); border-color: var(--accent); }
105
+
106
+ .specimen {
107
+ padding-block: clamp(4rem, 8vw, 7rem);
108
+ border-top: 1px solid var(--ink);
109
+ }
110
+
111
+ .specimen header,
112
+ .principles header {
113
+ display: grid;
114
+ grid-template-columns: 1fr 2fr;
115
+ gap: 2rem;
116
+ align-items: start;
117
+ margin-bottom: clamp(2.5rem, 5vw, 4.5rem);
118
+ }
119
+
120
+ .specimen h2,
121
+ .principles h2,
122
+ .start h2 {
123
+ max-width: 16ch;
124
+ margin: 0;
125
+ font-size: clamp(2.5rem, 5vw, 4.75rem);
126
+ line-height: 0.98;
127
+ }
128
+
129
+ .source-line {
130
+ display: grid;
131
+ grid-template-columns: 1fr 3fr;
132
+ gap: 1rem;
133
+ align-items: baseline;
134
+ padding-block: 1.25rem;
135
+ border-block: 1px solid var(--line);
136
+ }
137
+
138
+ .source-line span,
139
+ .token-line strong {
140
+ color: var(--muted);
141
+ font-size: 0.76rem;
142
+ font-weight: 500;
143
+ }
144
+
145
+ .source-line code { font-size: clamp(1.35rem, 3vw, 2.4rem); }
146
+
147
+ .token-line {
148
+ display: grid;
149
+ grid-template-columns: 0.7fr 1.5fr 0.8fr 1fr;
150
+ margin: 0;
151
+ padding: 0;
152
+ list-style: none;
153
+ }
154
+
155
+ .token-line li {
156
+ display: grid;
157
+ gap: 2.5rem;
158
+ min-width: 0;
159
+ padding: clamp(1.25rem, 3vw, 2rem);
160
+ border-bottom: 1px solid var(--line);
161
+ border-left: 1px solid var(--line);
162
+ }
163
+
164
+ .token-line li:first-child { border-left: 0; }
165
+ .token-line span { overflow: hidden; font-family: var(--sl-font-mono); font-size: clamp(1.4rem, 3.5vw, 3rem); }
166
+ .token-line .token-accent { color: var(--paper); border-color: var(--accent); background: var(--accent); }
167
+ .token-line .token-accent strong { color: var(--paper); }
168
+
169
+ .decision { margin: 1.25rem 0 0 auto; color: var(--muted); font-size: 0.84rem; text-align: right; }
170
+ .decision code { color: var(--ink); }
171
+
172
+ .principles { padding-block: clamp(4rem, 9vw, 8rem); }
173
+
174
+ .principle-list { border-top: 1px solid var(--ink); }
175
+ .principle-list article {
176
+ display: grid;
177
+ grid-template-columns: 1fr 2fr;
178
+ gap: 2rem;
179
+ padding-block: 1.5rem;
180
+ border-bottom: 1px solid var(--line);
181
+ }
182
+
183
+ .principle-list h3 { margin: 0; font-size: 1rem; }
184
+ .principle-list p { max-width: 40rem; margin: 0; color: var(--muted); line-height: 1.7; }
185
+ .principle-list a { color: var(--accent); text-underline-offset: 0.2rem; }
186
+
187
+ .start {
188
+ display: grid;
189
+ grid-template-columns: 1fr auto auto;
190
+ gap: 1.5rem;
191
+ align-items: center;
192
+ padding-block: clamp(3.5rem, 7vw, 6rem);
193
+ border-block: 1px solid var(--ink);
194
+ }
195
+
196
+ .start h2 { font-size: clamp(2.25rem, 4vw, 4rem); }
197
+ .start > code { padding: 0.8rem 1rem; border: 1px solid var(--line); background: var(--surface); white-space: nowrap; }
198
+
199
+ .landing-footer {
200
+ display: grid;
201
+ grid-template-columns: auto 1fr auto;
202
+ gap: 2rem;
203
+ align-items: center;
204
+ padding-block: 2rem 3.5rem;
205
+ color: var(--muted);
206
+ font-size: 0.82rem;
207
+ }
208
+
209
+ .footer-brand { color: var(--ink); font-family: var(--sl-font-mono); font-weight: 700; text-decoration: none; }
210
+ .landing-footer nav { display: flex; gap: 1.25rem; }
211
+ .landing-footer nav a { display: inline-flex; min-height: 2.75rem; align-items: center; color: var(--muted); }
212
+ .landing-footer p { margin: 0; }
213
+
214
+ @media (max-width: 760px) {
215
+ .hero,
216
+ .specimen,
217
+ .principles,
218
+ .start,
219
+ .landing-footer { width: min(100% - 1.5rem, 1160px); }
220
+
221
+ .hero { grid-template-columns: 1fr; gap: 2.5rem; min-height: auto; padding-block: 4rem; }
222
+ .hero h1 { font-size: clamp(3.7rem, 18vw, 6rem); }
223
+ .specimen header,
224
+ .principles header,
225
+ .source-line,
226
+ .principle-list article { grid-template-columns: 1fr; gap: 0.75rem; }
227
+ .token-line { grid-template-columns: 1fr 1fr; }
228
+ .token-line li:nth-child(3) { border-left: 0; }
229
+ .decision { text-align: left; }
230
+ .start { grid-template-columns: 1fr; justify-items: start; }
231
+ .landing-footer { grid-template-columns: 1fr; gap: 0.9rem; }
232
+ }
233
+
234
+ @media (max-width: 460px) {
235
+ .hero-actions { align-items: stretch; flex-direction: column; }
236
+ .action { width: 100%; }
237
+ .token-line { grid-template-columns: 1fr; }
238
+ .token-line li { border-left: 0; }
239
+ }
@@ -0,0 +1,99 @@
1
+ import { test, expect } from '@playwright/test';
2
+
3
+ test('runs actual edited Ruby, steps the trace, draws the DFA, and restores a share link without running', async ({ page }, testInfo) => {
4
+ const wasm = [];
5
+ const errors = [];
6
+ page.context().on('request', request => { if (request.url().endsWith('ruby.wasm')) wasm.push(request.url()); });
7
+ page.on('pageerror', error => errors.push(error.message));
8
+ await page.goto('/flexr/playground/');
9
+ await expect(page.locator('#spec')).toContainText('');
10
+ await expect(page.locator('#spec')).toHaveValue(/class Lexer/);
11
+ expect(wasm).toHaveLength(0);
12
+ const source = 'class Lexer < Flexr::Lexer\n emits :INT\n rule(/[0-9]+/) { emit :INT, text.to_i * 3 }\n rule(/ +/, skip: true)\nend';
13
+ await page.locator('#spec').fill(source);
14
+ await page.locator('#input').fill('12 2');
15
+ await page.getByRole('button', { name: 'Run', exact: true }).click();
16
+ await expect(page.locator('#status')).toContainText('2 tokens, 3 steps', { timeout: 30_000 });
17
+ expect(JSON.parse(await page.locator('#tokens').textContent())).toEqual([['INT', 36], ['INT', 6]]);
18
+ await expect(page.locator('#metrics')).toContainText('MiB Ruby download');
19
+ console.log(`Playground measurement: ${await page.locator('#metrics').textContent()}; ${await page.evaluate(() => navigator.userAgent)}`);
20
+ await page.getByRole('button', { name: 'Next step' }).click();
21
+ await expect(page.locator('#decisions')).toContainText('"action": "skip"');
22
+ await page.getByRole('button', { name: 'Draw DFA' }).click();
23
+ await expect(page.locator('#graph svg')).toBeVisible({ timeout: 10_000 });
24
+ await page.evaluate(() => window.scrollTo(0, 0));
25
+ await page.screenshot({ path: testInfo.outputPath('playground-desktop.png') });
26
+ await expect(page.locator('#generated')).toContainText('Generated by flexr');
27
+ await page.locator('#mode').selectOption('generated');
28
+ await page.getByRole('button', { name: 'Run', exact: true }).click();
29
+ await expect(page.locator('#status')).toContainText('2 tokens, 3 steps', { timeout: 15_000 });
30
+ expect(JSON.parse(await page.locator('#tokens').textContent())).toEqual([['INT', 36], ['INT', 6]]);
31
+ await page.getByRole('button', { name: 'Copy share link' }).click();
32
+ await expect(page.locator('#share-link')).toBeVisible();
33
+ const link = await page.locator('#share-link').inputValue();
34
+ const count = wasm.length;
35
+ const shared = await page.context().newPage();
36
+ await shared.goto(link);
37
+ await expect(shared.locator('#spec')).toHaveValue(source);
38
+ await expect(shared.locator('#status')).toContainText('Review it');
39
+ await expect(shared.locator('#mode')).toHaveValue('generated');
40
+ await shared.setViewportSize({ width: 390, height: 844 });
41
+ await shared.screenshot({ path: testInfo.outputPath('playground-mobile.png') });
42
+ expect(await shared.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(391);
43
+ expect(wasm).toHaveLength(count);
44
+ expect(errors).toEqual([]);
45
+ });
46
+
47
+ test('shows source diagnostics and terminates runaway Ruby while the UI stays responsive', async ({ page }) => {
48
+ await page.goto('/flexr/playground/');
49
+ await page.locator('#spec').fill('class Lexer < Flexr::Lexer\n rule(/a(?=b)/, emit: :A)\nend');
50
+ await page.locator('#input').fill('ab');
51
+ await page.getByRole('button', { name: 'Run', exact: true }).click();
52
+ await expect(page.locator('#diagnostics')).toContainText('FLEXR-E014', { timeout: 30_000 });
53
+ await expect(page.locator('#diagnostics')).toContainText('playground.flexr.rb:2:');
54
+ await page.locator('#spec').fill('loop {}\nclass Lexer < Flexr::Lexer\n rule(/a/, emit: :A)\nend');
55
+ await page.getByRole('button', { name: 'Run', exact: true }).click();
56
+ await expect(page.locator('#status')).toContainText('Execution exceeded 5 seconds', { timeout: 15_000 });
57
+ await expect(page.getByRole('button', { name: 'Run', exact: true })).toBeEnabled();
58
+ });
59
+
60
+ test('treats tokens and console text as text and disables worker network access', async ({ page }) => {
61
+ await page.goto('/flexr/playground/');
62
+ await page.locator('#spec').fill(`class Lexer < Flexr::Lexer
63
+ rule(/a/) do
64
+ require "js"
65
+ emit :TEXT, "<img src=x onerror=alert(1)>"
66
+ puts "<script>alert(1)</script>"
67
+ raise "network enabled" unless JS.global[:fetch].typeof == "undefined"
68
+ end
69
+ end`);
70
+ await page.locator('#input').fill('a');
71
+ await page.getByRole('button', { name: 'Run', exact: true }).click();
72
+ await expect(page.locator('#status')).toContainText('1 token, 1 step', { timeout: 30_000 });
73
+ await expect(page.locator('#tokens')).toContainText('<img src=x');
74
+ await expect(page.locator('#tokens img')).toHaveCount(0);
75
+ await expect(page.locator('#console script')).toHaveCount(0);
76
+ });
77
+
78
+ test('loads the actual TOML, GraphQL, and SQL example presets', async ({ page }) => {
79
+ await page.goto('/flexr/playground/');
80
+ for (const [name, namespace] of [['toml', 'TomlExample'], ['graphql', 'GraphqlExample'], ['sql', 'SqlExample']]) {
81
+ await page.locator('#preset').selectOption(name);
82
+ await expect(page.locator('#spec')).toHaveValue(new RegExp(`module ${namespace}`));
83
+ await page.getByRole('button', { name: 'Run', exact: true }).click();
84
+ await expect(page.locator('#status')).toContainText('steps. Ruby', { timeout: 30_000 });
85
+ expect(JSON.parse(await page.locator('#tokens').textContent()).length).toBeGreaterThan(0);
86
+ }
87
+ });
88
+
89
+ test('executes literal Unicode action values in runtime and generated modes', async ({ page }) => {
90
+ await page.goto('/flexr/playground/');
91
+ await page.locator('#spec').fill('class Lexer < Flexr::Lexer\n LABEL = "前"\n rule(/a/) { emit :TEXT, LABEL + "あ" }\n TRAILER = "後"\nend');
92
+ await page.locator('#input').fill('a');
93
+ for (const mode of ['runtime', 'generated']) {
94
+ await page.locator('#mode').selectOption(mode);
95
+ await page.getByRole('button', { name: 'Run', exact: true }).click();
96
+ await expect(page.locator('#status')).toContainText('1 token, 1 step', { timeout: 30_000 });
97
+ expect(JSON.parse(await page.locator('#tokens').textContent())).toEqual([['TEXT', '前あ']]);
98
+ }
99
+ });