plainscript-lang 0.1.7 → 1.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 (49) hide show
  1. package/README.md +97 -39
  2. package/compiler/bundler.js +1 -1
  3. package/compiler/cli.js +44 -42
  4. package/compiler/generator.js +826 -16
  5. package/compiler/lexer.js +31 -2
  6. package/compiler/parser.js +548 -22
  7. package/compiler/version.js +1 -1
  8. package/docs/CAPABILITY_GAP_AUDIT.md +439 -0
  9. package/docs/PLINJS_SPEC.md +124 -24
  10. package/docs/index.html +535 -2205
  11. package/docs/website/script.js +889 -133
  12. package/docs/website/style.css +652 -1113
  13. package/examples/auth-api.ps +56 -0
  14. package/examples/{cache-and-jobs.pln → cache-and-jobs.ps} +1 -1
  15. package/examples/concurrency.ps +49 -0
  16. package/examples/{database.pln → database.ps} +1 -1
  17. package/examples/{deployment.pln → deployment.ps} +1 -1
  18. package/examples/{email-send.pln → email-send.ps} +1 -1
  19. package/examples/error-handling.ps +54 -0
  20. package/examples/file-uploads.ps +39 -0
  21. package/examples/files-and-config.ps +47 -0
  22. package/examples/http-client.ps +44 -0
  23. package/examples/modules/app.ps +16 -0
  24. package/examples/modules/math.ps +20 -0
  25. package/examples/record-kinds.ps +43 -0
  26. package/examples/{rest-api.pln → rest-api.ps} +1 -1
  27. package/examples/{scheduled-tasks.pln → scheduled-tasks.ps} +1 -1
  28. package/examples/search-and-filter.ps +34 -0
  29. package/examples/sessions-and-cookies.ps +54 -0
  30. package/examples/{websocket-server.pln → websocket-server.ps} +1 -1
  31. package/package.json +2 -2
  32. package/docs/website/index.html +0 -1500
  33. /package/examples/{arrays.pln → arrays.ps} +0 -0
  34. /package/examples/{day2.pln → day2.ps} +0 -0
  35. /package/examples/{day3.pln → day3.ps} +0 -0
  36. /package/examples/{expressions.pln → expressions.ps} +0 -0
  37. /package/examples/football-backend/{app.pln → app.ps} +0 -0
  38. /package/examples/{hello.pln → hello.ps} +0 -0
  39. /package/examples/id-verification/{app.pln → app.ps} +0 -0
  40. /package/examples/{loops.pln → loops.ps} +0 -0
  41. /package/examples/{objects.pln → objects.ps} +0 -0
  42. /package/examples/{rest-api-fetch.pln → rest-api-fetch.ps} +0 -0
  43. /package/examples/{server.pln → server.ps} +0 -0
  44. /package/examples/{start.pln → start.ps} +0 -0
  45. /package/examples/{stdlib.pln → stdlib.ps} +0 -0
  46. /package/examples/{telegram-bot.pln → telegram-bot.ps} +0 -0
  47. /package/examples/{web-app.pln → web-app.ps} +0 -0
  48. /package/examples/whatsapp-bot/{pairing.pln → pairing.ps} +0 -0
  49. /package/examples/whatsapp-bot/{qr.pln → qr.ps} +0 -0
package/README.md CHANGED
@@ -9,14 +9,14 @@
9
9
 
10
10
  PlainScript is an Intent-Oriented Programming Language (IOPL). You describe **what** you want; the compiler decides **how** to implement it in JavaScript.
11
11
 
12
- **Current version:** v0.1.7 — the `plainscript` npm package with a TypeScript-style production build (`plainscript build` → `dist/`, source names preserved).
12
+ **Current version:** v1.0.0 — the `plainscript` npm package with a TypeScript-style production build (`plainscript build` → `dist/`, source names preserved).
13
13
 
14
14
  ---
15
15
 
16
16
  ## Quick start
17
17
 
18
18
  ```bash
19
- npx plainscript new myapp # scaffolds src/app.pln and package.json
19
+ npx plainscript new myapp # scaffolds src/app.ps and package.json
20
20
  cd myapp
21
21
  npm install # installs plainscript as a devDependency plus runtime packages
22
22
  npm run build # compiles src/ -> dist/ (plainscript build)
@@ -27,7 +27,7 @@ Adding PlainScript to an existing project:
27
27
 
28
28
  ```bash
29
29
  npm install --save-dev plainscript
30
- # start writing src/*.pln files — plainscript build auto-discovers them
30
+ # start writing src/*.ps files — plainscript build auto-discovers them
31
31
  ```
32
32
 
33
33
  No global install is needed anywhere — everything runs through npm scripts
@@ -38,17 +38,17 @@ and `npx`.
38
38
  ## CLI
39
39
 
40
40
  ```
41
- plainscript run <file.pln> Install missing dependencies, compile and execute
41
+ plainscript run <file.ps> Install missing dependencies, compile and execute
42
42
  (executes from a scratch dir — nothing is written
43
43
  into your project)
44
- plainscript build [file.pln] Compile to dist/. With no argument, builds every
45
- .pln file under the source root, preserving names
44
+ plainscript build [file.ps] Compile to dist/. With no argument, builds every
45
+ .ps file under the source root, preserving names
46
46
  and folder structure
47
- plainscript check <file.pln> Check syntax only (no output, no execution)
48
- plainscript fmt <file.pln> Format a PlainScript file in-place
47
+ plainscript check <file.ps> Check syntax only (no output, no execution)
48
+ plainscript fmt <file.ps> Format a PlainScript file in-place
49
49
  plainscript new [name] Create a new PlainScript project (npm-ready)
50
50
  plainscript install Install dependencies detected in the project's sources
51
- plainscript start Build src/app.pln and run its dist/ output
51
+ plainscript start Build src/app.ps and run its dist/ output
52
52
  plainscript doctor Check the PlainScript project environment
53
53
  plainscript add <package> Install a package into the project
54
54
  plainscript remove <package> Uninstall a package from the project
@@ -62,13 +62,13 @@ plainscript help Print help text
62
62
  ## Building and configuration
63
63
 
64
64
  `plainscript build` is a deterministic production build, TypeScript-style but for
65
- `.pln` sources — **zero configuration required**:
65
+ `.ps` sources — **zero configuration required**:
66
66
 
67
- - `plainscript build` (no argument) discovers every `.pln` file under `src/` and
67
+ - `plainscript build` (no argument) discovers every `.ps` file under `src/` and
68
68
  compiles each to `dist/` **preserving source file names and folder structure**:
69
- `src/messi.pln` → `dist/messi.js`,
70
- `src/helpers/math.pln` → `dist/helpers/math.js`.
71
- - `plainscript build <file.pln>` compiles a single file into `dist/`.
69
+ `src/messi.ps` → `dist/messi.js`,
70
+ `src/helpers/math.ps` → `dist/helpers/math.js`.
71
+ - `plainscript build <file.ps>` compiles a single file into `dist/`.
72
72
  - Imports are bundled into each output, so every file in `dist/` runs
73
73
  standalone under Node.
74
74
  - Rebuilds are byte-identical — safe to commit, diff, and cache.
@@ -108,11 +108,11 @@ For projects that need custom output or source directories, add a
108
108
  "build": "plainscript build",
109
109
  "prepare": "plainscript build"
110
110
  },
111
- "devDependencies": { "plainscript": "^0.1.7" }
111
+ "devDependencies": { "plainscript": "^1.0.0" }
112
112
  }
113
113
  ```
114
114
 
115
- `src/index.pln` builds to `dist/index.js`; consumers install and `require()`
115
+ `src/index.ps` builds to `dist/index.js`; consumers install and `require()`
116
116
  it like any Node package. There is no PlainScript-specific registry or format —
117
117
  standard `package.json` semantics apply.
118
118
 
@@ -297,6 +297,31 @@ use node-fetch
297
297
  use @scope/package-name
298
298
  ```
299
299
 
300
+ ### TypeScript-parity capabilities (1.0.0)
301
+
302
+ The full capability-gap audit lives in [`docs/CAPABILITY_GAP_AUDIT.md`](docs/CAPABILITY_GAP_AUDIT.md).
303
+ These features close it in PlainScript's own grammar:
304
+
305
+ - **Record kinds (classes):** `define a kind called "Person" with name is "" done`
306
+ + `create a Person with name "Ada" and age 17`. Plain-object instances; unknown
307
+ fields throw.
308
+ - **Concurrency:** `all of [...]`, `any of [...]`, `settled of [...]`,
309
+ `withTimeout(promise, ms)`.
310
+ - **Generators:** `yield` inside `make ... done`; consumed with `for each` or
311
+ `spread of`.
312
+ - **Reflection:** `typeOf`, `fieldsOf`, `valueOf`, `hasField`, `sizeOf`.
313
+ - **Binary:** `base64Encode/Decode`, `textToBytes/bytesToText`, `sha256/sha1/md5`.
314
+ - **Config:** `yamlDecode/yamlEncode`, `load env file ".env"`.
315
+ - **CLI & processes:** `args()`, `runCommand(cmd, [args])`.
316
+ - **Filesystem & paths:** `fileSize`, `fileType`, `lastModified`, `walkFolder`,
317
+ `joinPath`, `baseName`, `folderOf`, `extensionOf`.
318
+ - **Streams:** `writeLine`, `appendLine`.
319
+ - **Collections:** `keyMap/mapSet/mapGet/mapHas/mapDelete`, `newSet/addToSet`.
320
+ - **Dynamic modules:** `loadModule("./m")`.
321
+ - **Native tests:** `test "name" ... done` with `check a equals b`,
322
+ `check a contains b`, `check a is b`, `check <expr> raises "msg"`.
323
+ - **Exports:** `export <name>`.
324
+
300
325
  ---
301
326
 
302
327
  ## Backend Services
@@ -558,7 +583,9 @@ start env("PORT")
558
583
  ```
559
584
 
560
585
  `param("id")`, `query("page")` and `header("x-token")` read request data;
561
- `group` composes path prefixes; `status <n>` sets the response code.
586
+ `body()` / `body("field")` read the JSON request body; `group` composes path
587
+ prefixes; `status <n>` sets the response code and `redirect to "<url>"` issues a
588
+ redirect.
562
589
 
563
590
  ### Databases with parameters and transactions
564
591
 
@@ -620,22 +647,53 @@ websocket server on 8080
620
647
  done
621
648
  ```
622
649
 
623
- ### Cache (Redis)
650
+ ### Cache (Redis with in-memory fallback)
624
651
 
625
652
  ```plainscript
626
- cache env("REDIS_URL")
653
+ cache env("REDIS_URL") // omit for an in-memory Map store with TTL
627
654
  remember token as cacheGet("token")
628
655
  cacheSet("greeting", "hi", 60)
629
656
  cacheDelete("greeting")
630
657
  ```
631
658
 
659
+ Without a configured Redis, `cacheGet`/`cacheSet`/`cacheDelete` transparently fall
660
+ back to an in-memory store, so naive caching works out of the box.
661
+
662
+ ### AI / ML
663
+
664
+ ```plainscript
665
+ remember reply as chat("gpt-4o-mini", [
666
+ { role: "user", content: "Say hello in two words" }
667
+ ])
668
+
669
+ remember vec as embedText("text-embedding-3-small", "PlainScript rocks")
670
+ remember score as similarity(vec, embedText("text-embedding-3-small", "I love PlainScript"))
671
+
672
+ remember tags as ai_tags("PlainScript is an intent-oriented language")
673
+ remember article as ai_post("Welcome to PlainScript", ["why IOPL", "quick start"])
674
+ ```
675
+
676
+ `chat` and `embedText` are async OpenAI-compatible calls (from `OPENAI_API_KEY`,
677
+ override with `options.apiKey`/`options.baseURL`); `similarity` returns -1..1.
678
+
679
+ ### Pagination
680
+
681
+ ```plainscript
682
+ remember page as paginate(allUsers, 2, 10)
683
+ show page.items # second page of 10
684
+ show page.hasNext # true if another page exists
685
+ ```
686
+
687
+ `paginate(list, page, perPage)` returns
688
+ `{ items, count, page, pages, perPage, hasNext, hasPrev }`.
689
+
632
690
  ---
633
691
 
634
692
  ## Multi-file projects
635
693
 
636
694
  ```plainscript
637
- import "./math.pln"
638
- import "./utils.pln"
695
+ import "./math.ps"
696
+ import "./utils.ps"
639
697
 
640
698
  show PI
641
699
 
@@ -731,7 +789,7 @@ plainscript install # Install all detected dependencies
731
789
  plainscript add express # Add a package
732
790
  plainscript remove express # Remove a package
733
791
  plainscript update # Update all packages
734
- plainscript start # Build src/app.pln and run its dist/ output
792
+ plainscript start # Build src/app.ps and run its dist/ output
735
793
  plainscript doctor # Check project environment
736
794
  ```
737
795
 
@@ -774,27 +832,27 @@ plainscript/
774
832
  │ └── cli.js — command-line entry point
775
833
  │
776
834
  ├── examples/
777
- │ ├── hello.pln
778
- │ ├── day2.pln
779
- │ ├── day3.pln
780
- │ ├── arrays.pln
781
- │ ├── objects.pln
782
- │ ├── loops.pln
783
- │ ├── expressions.pln
784
- │ ├── stdlib.pln
785
- │ ├── server.pln
786
- │ ├── web-app.pln
787
- │ ├── start.pln
788
- │ ├── database.pln
789
- │ ├── deployment.pln
835
+ │ ├── hello.ps
836
+ │ ├── day2.ps
837
+ │ ├── day3.ps
838
+ │ ├── arrays.ps
839
+ │ ├── objects.ps
840
+ │ ├── loops.ps
841
+ │ ├── expressions.ps
842
+ │ ├── stdlib.ps
843
+ │ ├── server.ps
844
+ │ ├── web-app.ps
845
+ │ ├── start.ps
846
+ │ ├── database.ps
847
+ │ ├── deployment.ps
790
848
  │ ├── football-backend/ — acceptance example (SQLite + auth + sessions)
791
- │ │ └── app.pln
849
+ │ │ └── app.ps
792
850
  │ ├── id-verification/ — acceptance example (uploads + OCR matching)
793
- │ │ ├── app.pln
851
+ │ │ ├── app.ps
794
852
  │ │ └── make-sample-id.js
795
853
  │ └── whatsapp-bot/ — WhatsApp bots (QR and pairing linking)
796
- │ ├── qr.pln
797
- │ └── pairing.pln
854
+ │ ├── qr.ps
855
+ │ └── pairing.ps
798
856
  │
799
857
  ├── tests/
800
858
  │ ├── compiler.test.js — language, CLI and formatter coverage
@@ -46,7 +46,7 @@ function resolveDependencies(entryPath) {
46
46
 
47
47
  // Parse the file to discover its own imports.
48
48
  // Annotate any tokenise/parse error with the filename so callers see
49
- // "file.pln — Line N, Column N: …" rather than a bare positional message.
49
+ // "file.ps — Line N, Column N: …" rather than a bare positional message.
50
50
  const source = fs.readFileSync(absPath, 'utf8');
51
51
  let tokens, ast;
52
52
  try {
package/compiler/cli.js CHANGED
@@ -1,14 +1,14 @@
1
1
  #!/usr/bin/env node
2
- // CLI: compile and run PlainScript (.pln) files.
2
+ // CLI: compile and run PlainScript (.ps) files.
3
3
  //
4
4
  // Usage:
5
- // plainscript run <file.pln> install missing dependencies, compile and execute
6
- // plainscript build [file.pln] compile src/ (or one file) to dist/, names preserved
7
- // plainscript check <file.pln> check syntax only (no JS generated, no execution)
8
- // plainscript fmt <file.pln> format a PlainScript file in-place
5
+ // plainscript run <file.ps> install missing dependencies, compile and execute
6
+ // plainscript build [file.ps] compile src/ (or one file) to dist/, names preserved
7
+ // plainscript check <file.ps> check syntax only (no JS generated, no execution)
8
+ // plainscript fmt <file.ps> format a PlainScript file in-place
9
9
  // plainscript new [name] scaffold a new PlainScript project
10
10
  // plainscript install install dependencies detected in the project's sources
11
- // plainscript start build src/app.pln (or index.pln) and run its dist output
11
+ // plainscript start build src/app.ps (or index.ps) and run its dist output
12
12
  // plainscript doctor check the PlainScript project environment
13
13
  // plainscript add <package> install a package into the project
14
14
  // plainscript remove <package> uninstall a package from the project
@@ -49,18 +49,18 @@ function warn(message) {
49
49
  const section = (title) => `\n${clrCyan(clrBold(title))}`;
50
50
 
51
51
  const HELP = `
52
- ${clrBold(`PlainScript v${VERSION}`)} ${clrDim('· .pln compiles to readable Node.js')}
52
+ ${clrBold(`PlainScript v${VERSION}`)} ${clrDim('· .ps compiles to readable Node.js')}
53
53
 
54
54
  ${section('START')}
55
- plainscript new [name] Scaffold a new project with a working app.pln
56
- plainscript run <file.pln> Install missing deps, compile, execute
57
- plainscript start Build src/app.pln and run it from dist/
55
+ plainscript new [name] Scaffold a new project with a working app.ps
56
+ plainscript run <file.ps> Install missing deps, compile, execute
57
+ plainscript start Build src/app.ps and run it from dist/
58
58
 
59
59
  ${section('BUILD & CHECK')}
60
- plainscript build Compile every .pln under src/ into dist/
61
- plainscript build <file.pln> Compile one file into dist/ (name preserved)
62
- plainscript check <file.pln> Syntax-check only — fastest feedback loop
63
- plainscript fmt <file.pln> Format a file in place
60
+ plainscript build Compile every .ps under src/ into dist/
61
+ plainscript build <file.ps> Compile one file into dist/ (name preserved)
62
+ plainscript check <file.ps> Syntax-check only — fastest feedback loop
63
+ plainscript fmt <file.ps> Format a file in place
64
64
 
65
65
  ${section('PACKAGES')}
66
66
  plainscript install Install everything your source needs
@@ -89,10 +89,12 @@ ${section('ALSO SHIPPED')}
89
89
  WhatsApp bots (v2.1.1) ·
90
90
  email · schedules · WebSocket · cache (v2.1) ·
91
91
  sessions · uploads · cookies · rate limits · api keys · OAuth (v2.1.1)
92
+ JSON body · redirect · AI chat/embeddings · vector similarity ·
93
+ paginate · collection & string primitives (v2.2)
92
94
 
93
95
  ${section('FIRST RUN')}
94
96
  plainscript new hello scaffolds hello/ with a live web app
95
- plainscript run hello/app.pln serves it at http://localhost:3000
97
+ plainscript run hello/app.ps serves it at http://localhost:3000
96
98
  `.trim();
97
99
 
98
100
  // ── npm invocation ────────────────────────────────────────────────────────────
@@ -145,8 +147,8 @@ function isValidPackageName(name) {
145
147
  // "exclude": ["vendor"] } }
146
148
  //
147
149
  // Filenames and folder structure are always preserved:
148
- // src/messi.pln → dist/messi.js
149
- // src/helpers/math.pln → dist/helpers/math.js
150
+ // src/messi.ps → dist/messi.js
151
+ // src/helpers/math.ps → dist/helpers/math.js
150
152
  const SOURCE_DIR = 'src';
151
153
  const DEFAULT_OUT_DIR = 'dist';
152
154
 
@@ -179,7 +181,7 @@ function resolveOutDir(opts) {
179
181
  return DEFAULT_OUT_DIR;
180
182
  }
181
183
 
182
- // Every .pln file under srcDir, recursively, as paths relative to srcDir.
184
+ // Every .ps file under srcDir, recursively, as paths relative to srcDir.
183
185
  // Deterministic order (sorted); node_modules, hidden directories, the output
184
186
  // directory, and any user-specified exclude patterns are skipped.
185
187
  function discoverSources(srcDir, outDir, exclude) {
@@ -202,7 +204,7 @@ function discoverSources(srcDir, outDir, exclude) {
202
204
  try { stat = fs.statSync(full); } catch (_) { continue; }
203
205
  if (stat.isDirectory()) {
204
206
  walk(full);
205
- } else if (name.endsWith('.pln')) {
207
+ } else if (name.endsWith('.ps')) {
206
208
  found.push(path.relative(root, full));
207
209
  }
208
210
  }
@@ -399,7 +401,7 @@ function nodeModulesSearchPaths(entryDir) {
399
401
 
400
402
  async function cmdRun(filePath, extraArgs = []) {
401
403
  if (!filePath) {
402
- console.error('Usage: plainscript run <file.pln>');
404
+ console.error('Usage: plainscript run <file.ps>');
403
405
  process.exit(1);
404
406
  }
405
407
  const js = compile(filePath);
@@ -436,8 +438,8 @@ function buildOne(filePath, srcDir, outDir) {
436
438
  }
437
439
  const js = compile(absFile);
438
440
  const srcRoot = path.resolve(srcDir);
439
- let rel = path.relative(srcRoot, absFile).replace(/\.pln$/, '.js');
440
- if (rel.startsWith('..') || path.isAbsolute(rel)) rel = path.basename(absFile).replace(/\.pln$/, '.js');
441
+ let rel = path.relative(srcRoot, absFile).replace(/\.ps$/, '.js');
442
+ if (rel.startsWith('..') || path.isAbsolute(rel)) rel = path.basename(absFile).replace(/\.ps$/, '.js');
441
443
  const outPath = path.join(path.resolve(outDir), rel);
442
444
  fs.mkdirSync(path.dirname(outPath), { recursive: true });
443
445
  fs.writeFileSync(outPath, js, 'utf8');
@@ -447,16 +449,16 @@ function buildOne(filePath, srcDir, outDir) {
447
449
  // `plainscript build` — TypeScript-style production build:
448
450
  //
449
451
  // Zero config (default):
450
- // messi.pln → dist/messi.js (project-root sources)
451
- // src/index.pln → dist/index.js (src/ is the source root)
452
- // src/a/b.pln → dist/a/b.js (structure preserved)
452
+ // messi.ps → dist/messi.js (project-root sources)
453
+ // src/index.ps → dist/index.js (src/ is the source root)
454
+ // src/a/b.ps → dist/a/b.js (structure preserved)
453
455
  //
454
456
  // With plainscript.config.json:
455
457
  // { "compilerOptions": { "outDir": "./build", "rootDir": "./lib" } }
456
- // lib/app.pln → build/app.js
458
+ // lib/app.ps → build/app.js
457
459
  //
458
460
  // With an explicit file argument only that entry is compiled; without one,
459
- // every .pln under the discovered source root builds to the output directory.
461
+ // every .ps under the discovered source root builds to the output directory.
460
462
  async function cmdBuild(filePath) {
461
463
  const opts = readCompilerOptions();
462
464
  const srcDir = resolveSrcDir(opts);
@@ -469,7 +471,7 @@ async function cmdBuild(filePath) {
469
471
  }
470
472
  const sources = discoverSources(srcDir, outDir, exclude);
471
473
  if (sources.length === 0) {
472
- console.error(`No .pln files found under "${srcDir}".`);
474
+ console.error(`No .ps files found under "${srcDir}".`);
473
475
  process.exit(1);
474
476
  }
475
477
  QUIET_STAGES = true;
@@ -494,7 +496,7 @@ async function cmdStart(extraArgs = []) {
494
496
  const outDir = resolveOutDir(opts);
495
497
  const entryPath = findEntry(opts);
496
498
  if (!entryPath) {
497
- console.error('No entry file found. Expected "src/app.pln" or "src/index.pln".');
499
+ console.error('No entry file found. Expected "src/app.ps" or "src/index.ps".');
498
500
  process.exit(1);
499
501
  }
500
502
  const outFile = buildOne(entryPath, srcDir, outDir);
@@ -519,8 +521,8 @@ function cmdNew(projectName) {
519
521
  fs.mkdirSync(path.join(dir, 'public'));
520
522
  fs.mkdirSync(path.join(dir, 'src'));
521
523
 
522
- // src/app.pln — starter Express app
523
- fs.writeFileSync(path.join(dir, 'src', 'app.pln'), `use express
524
+ // src/app.ps — starter Express app
525
+ fs.writeFileSync(path.join(dir, 'src', 'app.ps'), `use express
524
526
 
525
527
  remember app as express()
526
528
 
@@ -554,7 +556,7 @@ done
554
556
  start: 'node dist/app.js',
555
557
  },
556
558
  devDependencies: {
557
- plainscript: `^${VERSION}`,
559
+ 'plainscript-lang': `^${VERSION}`,
558
560
  },
559
561
  dependencies: {
560
562
  express: '^4.18.2',
@@ -578,7 +580,7 @@ Then open http://localhost:3000 in your browser.
578
580
  `);
579
581
 
580
582
  console.log(`✓ Created project "${name}"`);
581
- console.log(`\nNext steps:\n cd ${name}\n npm install\n npx plainscript run src/app.pln`);
583
+ console.log(`\nNext steps:\n cd ${name}\n npm install\n npx plainscript run src/app.ps`);
582
584
  }
583
585
 
584
586
  // ── plainscript install ────────────────────────────────────────────────────────────
@@ -588,11 +590,11 @@ Then open http://localhost:3000 in your browser.
588
590
  function findEntry(opts) {
589
591
  const srcDir = resolveSrcDir(opts);
590
592
  const candidates = [
591
- path.join(srcDir, 'app.pln'),
592
- path.join(srcDir, 'index.pln'),
593
+ path.join(srcDir, 'app.ps'),
594
+ path.join(srcDir, 'index.ps'),
593
595
  ];
594
596
  if (srcDir !== '.') {
595
- candidates.push('app.pln', 'index.pln');
597
+ candidates.push('app.ps', 'index.ps');
596
598
  }
597
599
  return candidates.find((c) => fs.existsSync(path.resolve(c))) || null;
598
600
  }
@@ -607,7 +609,7 @@ function collectSourceAsts() {
607
609
  const exclude = opts && opts.exclude;
608
610
  const sources = discoverSources(srcDir, outDir, exclude);
609
611
  if (sources.length === 0) {
610
- console.error(`No .pln source files found under "${srcDir}".`);
612
+ console.error(`No .ps source files found under "${srcDir}".`);
611
613
  process.exit(1);
612
614
  }
613
615
  const root = path.resolve(srcDir);
@@ -663,14 +665,14 @@ function cmdDoctor() {
663
665
  check('Runtime', fs.existsSync(path.join(__dirname, 'generator.js')));
664
666
  console.log('');
665
667
 
666
- // Source discovery check: does the project have any .pln files?
668
+ // Source discovery check: does the project have any .ps files?
667
669
  const opts = readCompilerOptions();
668
670
  const srcDir = resolveSrcDir(opts);
669
671
  const outDir = resolveOutDir(opts);
670
672
  const exclude = opts && opts.exclude;
671
673
  const sources = discoverSources(srcDir, outDir, exclude);
672
674
  check('Source files', sources.length > 0,
673
- sources.length > 0 ? `"${srcDir}/" discovered (${sources.length} file(s))` : `no .pln files under "${srcDir}"`);
675
+ sources.length > 0 ? `"${srcDir}/" discovered (${sources.length} file(s))` : `no .ps files under "${srcDir}"`);
674
676
  if (sources.length === 0) return;
675
677
 
676
678
  // Dependency check: scan every source file for npm imports
@@ -747,7 +749,7 @@ function cmdUpdate() {
747
749
  // Check syntax of a PlainScript file without generating JavaScript or executing.
748
750
  function cmdCheck(filePath) {
749
751
  if (!filePath) {
750
- console.error('Usage: plainscript check <file.pln>');
752
+ console.error('Usage: plainscript check <file.ps>');
751
753
  process.exit(1);
752
754
  }
753
755
  const absPath = path.resolve(filePath);
@@ -769,7 +771,7 @@ function cmdCheck(filePath) {
769
771
  // Format a PlainScript file in-place.
770
772
  function cmdFmt(filePath) {
771
773
  if (!filePath) {
772
- console.error('Usage: plainscript fmt <file.pln>');
774
+ console.error('Usage: plainscript fmt <file.ps>');
773
775
  process.exit(1);
774
776
  }
775
777
  const absPath = path.resolve(filePath);
@@ -828,7 +830,7 @@ async function main() {
828
830
  case 'help': cmdHelp(); break;
829
831
  default:
830
832
  // Backwards-compatible: treat the first arg as a file to run directly
831
- if (command && command.endsWith('.pln')) {
833
+ if (command && command.endsWith('.ps')) {
832
834
  await cmdRun(command);
833
835
  } else {
834
836
  console.error(`Unknown command: "${command}". Run "plainscript help" for usage.`);