plainscript-lang 0.1.7 → 1.0.0-beta

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 (38) hide show
  1. package/README.md +61 -36
  2. package/compiler/bundler.js +1 -1
  3. package/compiler/cli.js +42 -42
  4. package/compiler/generator.js +623 -10
  5. package/compiler/lexer.js +31 -2
  6. package/compiler/parser.js +539 -22
  7. package/compiler/version.js +1 -1
  8. package/docs/CAPABILITY_GAP_AUDIT.md +379 -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/{cache-and-jobs.pln → cache-and-jobs.ps} +1 -1
  14. package/examples/{database.pln → database.ps} +1 -1
  15. package/examples/{deployment.pln → deployment.ps} +1 -1
  16. package/examples/{email-send.pln → email-send.ps} +1 -1
  17. package/examples/{rest-api.pln → rest-api.ps} +1 -1
  18. package/examples/{scheduled-tasks.pln → scheduled-tasks.ps} +1 -1
  19. package/examples/{websocket-server.pln → websocket-server.ps} +1 -1
  20. package/package.json +2 -2
  21. package/docs/website/index.html +0 -1500
  22. /package/examples/{arrays.pln → arrays.ps} +0 -0
  23. /package/examples/{day2.pln → day2.ps} +0 -0
  24. /package/examples/{day3.pln → day3.ps} +0 -0
  25. /package/examples/{expressions.pln → expressions.ps} +0 -0
  26. /package/examples/football-backend/{app.pln → app.ps} +0 -0
  27. /package/examples/{hello.pln → hello.ps} +0 -0
  28. /package/examples/id-verification/{app.pln → app.ps} +0 -0
  29. /package/examples/{loops.pln → loops.ps} +0 -0
  30. /package/examples/{objects.pln → objects.ps} +0 -0
  31. /package/examples/{rest-api-fetch.pln → rest-api-fetch.ps} +0 -0
  32. /package/examples/{server.pln → server.ps} +0 -0
  33. /package/examples/{start.pln → start.ps} +0 -0
  34. /package/examples/{stdlib.pln → stdlib.ps} +0 -0
  35. /package/examples/{telegram-bot.pln → telegram-bot.ps} +0 -0
  36. /package/examples/{web-app.pln → web-app.ps} +0 -0
  37. /package/examples/whatsapp-bot/{pairing.pln → pairing.ps} +0 -0
  38. /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-beta — 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-beta" }
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-beta)
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
@@ -634,8 +659,8 @@ cacheDelete("greeting")
634
659
  ## Multi-file projects
635
660
 
636
661
  ```plainscript
637
- import "./math.pln"
638
- import "./utils.pln"
662
+ import "./math.ps"
663
+ import "./utils.ps"
639
664
 
640
665
  show PI
641
666
 
@@ -731,7 +756,7 @@ plainscript install # Install all detected dependencies
731
756
  plainscript add express # Add a package
732
757
  plainscript remove express # Remove a package
733
758
  plainscript update # Update all packages
734
- plainscript start # Build src/app.pln and run its dist/ output
759
+ plainscript start # Build src/app.ps and run its dist/ output
735
760
  plainscript doctor # Check project environment
736
761
  ```
737
762
 
@@ -774,27 +799,27 @@ plainscript/
774
799
  │ └── cli.js — command-line entry point
775
800
  │
776
801
  ├── 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
802
+ │ ├── hello.ps
803
+ │ ├── day2.ps
804
+ │ ├── day3.ps
805
+ │ ├── arrays.ps
806
+ │ ├── objects.ps
807
+ │ ├── loops.ps
808
+ │ ├── expressions.ps
809
+ │ ├── stdlib.ps
810
+ │ ├── server.ps
811
+ │ ├── web-app.ps
812
+ │ ├── start.ps
813
+ │ ├── database.ps
814
+ │ ├── deployment.ps
790
815
  │ ├── football-backend/ — acceptance example (SQLite + auth + sessions)
791
- │ │ └── app.pln
816
+ │ │ └── app.ps
792
817
  │ ├── id-verification/ — acceptance example (uploads + OCR matching)
793
- │ │ ├── app.pln
818
+ │ │ ├── app.ps
794
819
  │ │ └── make-sample-id.js
795
820
  │ └── whatsapp-bot/ — WhatsApp bots (QR and pairing linking)
796
- │ ├── qr.pln
797
- │ └── pairing.pln
821
+ │ ├── qr.ps
822
+ │ └── pairing.ps
798
823
  │
799
824
  ├── tests/
800
825
  │ ├── 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
@@ -92,7 +92,7 @@ ${section('ALSO SHIPPED')}
92
92
 
93
93
  ${section('FIRST RUN')}
94
94
  plainscript new hello scaffolds hello/ with a live web app
95
- plainscript run hello/app.pln serves it at http://localhost:3000
95
+ plainscript run hello/app.ps serves it at http://localhost:3000
96
96
  `.trim();
97
97
 
98
98
  // ── npm invocation ────────────────────────────────────────────────────────────
@@ -145,8 +145,8 @@ function isValidPackageName(name) {
145
145
  // "exclude": ["vendor"] } }
146
146
  //
147
147
  // Filenames and folder structure are always preserved:
148
- // src/messi.pln → dist/messi.js
149
- // src/helpers/math.pln → dist/helpers/math.js
148
+ // src/messi.ps → dist/messi.js
149
+ // src/helpers/math.ps → dist/helpers/math.js
150
150
  const SOURCE_DIR = 'src';
151
151
  const DEFAULT_OUT_DIR = 'dist';
152
152
 
@@ -179,7 +179,7 @@ function resolveOutDir(opts) {
179
179
  return DEFAULT_OUT_DIR;
180
180
  }
181
181
 
182
- // Every .pln file under srcDir, recursively, as paths relative to srcDir.
182
+ // Every .ps file under srcDir, recursively, as paths relative to srcDir.
183
183
  // Deterministic order (sorted); node_modules, hidden directories, the output
184
184
  // directory, and any user-specified exclude patterns are skipped.
185
185
  function discoverSources(srcDir, outDir, exclude) {
@@ -202,7 +202,7 @@ function discoverSources(srcDir, outDir, exclude) {
202
202
  try { stat = fs.statSync(full); } catch (_) { continue; }
203
203
  if (stat.isDirectory()) {
204
204
  walk(full);
205
- } else if (name.endsWith('.pln')) {
205
+ } else if (name.endsWith('.ps')) {
206
206
  found.push(path.relative(root, full));
207
207
  }
208
208
  }
@@ -399,7 +399,7 @@ function nodeModulesSearchPaths(entryDir) {
399
399
 
400
400
  async function cmdRun(filePath, extraArgs = []) {
401
401
  if (!filePath) {
402
- console.error('Usage: plainscript run <file.pln>');
402
+ console.error('Usage: plainscript run <file.ps>');
403
403
  process.exit(1);
404
404
  }
405
405
  const js = compile(filePath);
@@ -436,8 +436,8 @@ function buildOne(filePath, srcDir, outDir) {
436
436
  }
437
437
  const js = compile(absFile);
438
438
  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');
439
+ let rel = path.relative(srcRoot, absFile).replace(/\.ps$/, '.js');
440
+ if (rel.startsWith('..') || path.isAbsolute(rel)) rel = path.basename(absFile).replace(/\.ps$/, '.js');
441
441
  const outPath = path.join(path.resolve(outDir), rel);
442
442
  fs.mkdirSync(path.dirname(outPath), { recursive: true });
443
443
  fs.writeFileSync(outPath, js, 'utf8');
@@ -447,16 +447,16 @@ function buildOne(filePath, srcDir, outDir) {
447
447
  // `plainscript build` — TypeScript-style production build:
448
448
  //
449
449
  // 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)
450
+ // messi.ps → dist/messi.js (project-root sources)
451
+ // src/index.ps → dist/index.js (src/ is the source root)
452
+ // src/a/b.ps → dist/a/b.js (structure preserved)
453
453
  //
454
454
  // With plainscript.config.json:
455
455
  // { "compilerOptions": { "outDir": "./build", "rootDir": "./lib" } }
456
- // lib/app.pln → build/app.js
456
+ // lib/app.ps → build/app.js
457
457
  //
458
458
  // 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.
459
+ // every .ps under the discovered source root builds to the output directory.
460
460
  async function cmdBuild(filePath) {
461
461
  const opts = readCompilerOptions();
462
462
  const srcDir = resolveSrcDir(opts);
@@ -469,7 +469,7 @@ async function cmdBuild(filePath) {
469
469
  }
470
470
  const sources = discoverSources(srcDir, outDir, exclude);
471
471
  if (sources.length === 0) {
472
- console.error(`No .pln files found under "${srcDir}".`);
472
+ console.error(`No .ps files found under "${srcDir}".`);
473
473
  process.exit(1);
474
474
  }
475
475
  QUIET_STAGES = true;
@@ -494,7 +494,7 @@ async function cmdStart(extraArgs = []) {
494
494
  const outDir = resolveOutDir(opts);
495
495
  const entryPath = findEntry(opts);
496
496
  if (!entryPath) {
497
- console.error('No entry file found. Expected "src/app.pln" or "src/index.pln".');
497
+ console.error('No entry file found. Expected "src/app.ps" or "src/index.ps".');
498
498
  process.exit(1);
499
499
  }
500
500
  const outFile = buildOne(entryPath, srcDir, outDir);
@@ -519,8 +519,8 @@ function cmdNew(projectName) {
519
519
  fs.mkdirSync(path.join(dir, 'public'));
520
520
  fs.mkdirSync(path.join(dir, 'src'));
521
521
 
522
- // src/app.pln — starter Express app
523
- fs.writeFileSync(path.join(dir, 'src', 'app.pln'), `use express
522
+ // src/app.ps — starter Express app
523
+ fs.writeFileSync(path.join(dir, 'src', 'app.ps'), `use express
524
524
 
525
525
  remember app as express()
526
526
 
@@ -554,7 +554,7 @@ done
554
554
  start: 'node dist/app.js',
555
555
  },
556
556
  devDependencies: {
557
- plainscript: `^${VERSION}`,
557
+ 'plainscript-lang': `^${VERSION}`,
558
558
  },
559
559
  dependencies: {
560
560
  express: '^4.18.2',
@@ -578,7 +578,7 @@ Then open http://localhost:3000 in your browser.
578
578
  `);
579
579
 
580
580
  console.log(`✓ Created project "${name}"`);
581
- console.log(`\nNext steps:\n cd ${name}\n npm install\n npx plainscript run src/app.pln`);
581
+ console.log(`\nNext steps:\n cd ${name}\n npm install\n npx plainscript run src/app.ps`);
582
582
  }
583
583
 
584
584
  // ── plainscript install ────────────────────────────────────────────────────────────
@@ -588,11 +588,11 @@ Then open http://localhost:3000 in your browser.
588
588
  function findEntry(opts) {
589
589
  const srcDir = resolveSrcDir(opts);
590
590
  const candidates = [
591
- path.join(srcDir, 'app.pln'),
592
- path.join(srcDir, 'index.pln'),
591
+ path.join(srcDir, 'app.ps'),
592
+ path.join(srcDir, 'index.ps'),
593
593
  ];
594
594
  if (srcDir !== '.') {
595
- candidates.push('app.pln', 'index.pln');
595
+ candidates.push('app.ps', 'index.ps');
596
596
  }
597
597
  return candidates.find((c) => fs.existsSync(path.resolve(c))) || null;
598
598
  }
@@ -607,7 +607,7 @@ function collectSourceAsts() {
607
607
  const exclude = opts && opts.exclude;
608
608
  const sources = discoverSources(srcDir, outDir, exclude);
609
609
  if (sources.length === 0) {
610
- console.error(`No .pln source files found under "${srcDir}".`);
610
+ console.error(`No .ps source files found under "${srcDir}".`);
611
611
  process.exit(1);
612
612
  }
613
613
  const root = path.resolve(srcDir);
@@ -663,14 +663,14 @@ function cmdDoctor() {
663
663
  check('Runtime', fs.existsSync(path.join(__dirname, 'generator.js')));
664
664
  console.log('');
665
665
 
666
- // Source discovery check: does the project have any .pln files?
666
+ // Source discovery check: does the project have any .ps files?
667
667
  const opts = readCompilerOptions();
668
668
  const srcDir = resolveSrcDir(opts);
669
669
  const outDir = resolveOutDir(opts);
670
670
  const exclude = opts && opts.exclude;
671
671
  const sources = discoverSources(srcDir, outDir, exclude);
672
672
  check('Source files', sources.length > 0,
673
- sources.length > 0 ? `"${srcDir}/" discovered (${sources.length} file(s))` : `no .pln files under "${srcDir}"`);
673
+ sources.length > 0 ? `"${srcDir}/" discovered (${sources.length} file(s))` : `no .ps files under "${srcDir}"`);
674
674
  if (sources.length === 0) return;
675
675
 
676
676
  // Dependency check: scan every source file for npm imports
@@ -747,7 +747,7 @@ function cmdUpdate() {
747
747
  // Check syntax of a PlainScript file without generating JavaScript or executing.
748
748
  function cmdCheck(filePath) {
749
749
  if (!filePath) {
750
- console.error('Usage: plainscript check <file.pln>');
750
+ console.error('Usage: plainscript check <file.ps>');
751
751
  process.exit(1);
752
752
  }
753
753
  const absPath = path.resolve(filePath);
@@ -769,7 +769,7 @@ function cmdCheck(filePath) {
769
769
  // Format a PlainScript file in-place.
770
770
  function cmdFmt(filePath) {
771
771
  if (!filePath) {
772
- console.error('Usage: plainscript fmt <file.pln>');
772
+ console.error('Usage: plainscript fmt <file.ps>');
773
773
  process.exit(1);
774
774
  }
775
775
  const absPath = path.resolve(filePath);
@@ -828,7 +828,7 @@ async function main() {
828
828
  case 'help': cmdHelp(); break;
829
829
  default:
830
830
  // Backwards-compatible: treat the first arg as a file to run directly
831
- if (command && command.endsWith('.pln')) {
831
+ if (command && command.endsWith('.ps')) {
832
832
  await cmdRun(command);
833
833
  } else {
834
834
  console.error(`Unknown command: "${command}". Run "plainscript help" for usage.`);