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.
- package/README.md +97 -39
- package/compiler/bundler.js +1 -1
- package/compiler/cli.js +44 -42
- package/compiler/generator.js +826 -16
- package/compiler/lexer.js +31 -2
- package/compiler/parser.js +548 -22
- package/compiler/version.js +1 -1
- package/docs/CAPABILITY_GAP_AUDIT.md +439 -0
- package/docs/PLINJS_SPEC.md +124 -24
- package/docs/index.html +535 -2205
- package/docs/website/script.js +889 -133
- package/docs/website/style.css +652 -1113
- package/examples/auth-api.ps +56 -0
- package/examples/{cache-and-jobs.pln → cache-and-jobs.ps} +1 -1
- package/examples/concurrency.ps +49 -0
- package/examples/{database.pln → database.ps} +1 -1
- package/examples/{deployment.pln → deployment.ps} +1 -1
- package/examples/{email-send.pln → email-send.ps} +1 -1
- package/examples/error-handling.ps +54 -0
- package/examples/file-uploads.ps +39 -0
- package/examples/files-and-config.ps +47 -0
- package/examples/http-client.ps +44 -0
- package/examples/modules/app.ps +16 -0
- package/examples/modules/math.ps +20 -0
- package/examples/record-kinds.ps +43 -0
- package/examples/{rest-api.pln → rest-api.ps} +1 -1
- package/examples/{scheduled-tasks.pln → scheduled-tasks.ps} +1 -1
- package/examples/search-and-filter.ps +34 -0
- package/examples/sessions-and-cookies.ps +54 -0
- package/examples/{websocket-server.pln → websocket-server.ps} +1 -1
- package/package.json +2 -2
- package/docs/website/index.html +0 -1500
- /package/examples/{arrays.pln → arrays.ps} +0 -0
- /package/examples/{day2.pln → day2.ps} +0 -0
- /package/examples/{day3.pln → day3.ps} +0 -0
- /package/examples/{expressions.pln → expressions.ps} +0 -0
- /package/examples/football-backend/{app.pln → app.ps} +0 -0
- /package/examples/{hello.pln → hello.ps} +0 -0
- /package/examples/id-verification/{app.pln → app.ps} +0 -0
- /package/examples/{loops.pln → loops.ps} +0 -0
- /package/examples/{objects.pln → objects.ps} +0 -0
- /package/examples/{rest-api-fetch.pln → rest-api-fetch.ps} +0 -0
- /package/examples/{server.pln → server.ps} +0 -0
- /package/examples/{start.pln → start.ps} +0 -0
- /package/examples/{stdlib.pln → stdlib.ps} +0 -0
- /package/examples/{telegram-bot.pln → telegram-bot.ps} +0 -0
- /package/examples/{web-app.pln → web-app.ps} +0 -0
- /package/examples/whatsapp-bot/{pairing.pln → pairing.ps} +0 -0
- /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:**
|
|
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.
|
|
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/*.
|
|
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.
|
|
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.
|
|
45
|
-
.
|
|
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.
|
|
48
|
-
plainscript fmt <file.
|
|
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.
|
|
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
|
-
`.
|
|
65
|
+
`.ps` sources — **zero configuration required**:
|
|
66
66
|
|
|
67
|
-
- `plainscript build` (no argument) discovers every `.
|
|
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.
|
|
70
|
-
`src/helpers/math.
|
|
71
|
-
- `plainscript build <file.
|
|
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.
|
|
111
|
+
"devDependencies": { "plainscript": "^1.0.0" }
|
|
112
112
|
}
|
|
113
113
|
```
|
|
114
114
|
|
|
115
|
-
`src/index.
|
|
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
|
-
`
|
|
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.
|
|
638
|
-
import "./utils.
|
|
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.
|
|
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.
|
|
778
|
-
│ ├── day2.
|
|
779
|
-
│ ├── day3.
|
|
780
|
-
│ ├── arrays.
|
|
781
|
-
│ ├── objects.
|
|
782
|
-
│ ├── loops.
|
|
783
|
-
│ ├── expressions.
|
|
784
|
-
│ ├── stdlib.
|
|
785
|
-
│ ├── server.
|
|
786
|
-
│ ├── web-app.
|
|
787
|
-
│ ├── start.
|
|
788
|
-
│ ├── database.
|
|
789
|
-
│ ├── deployment.
|
|
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.
|
|
849
|
+
│ │ └── app.ps
|
|
792
850
|
│ ├── id-verification/ — acceptance example (uploads + OCR matching)
|
|
793
|
-
│ │ ├── app.
|
|
851
|
+
│ │ ├── app.ps
|
|
794
852
|
│ │ └── make-sample-id.js
|
|
795
853
|
│ └── whatsapp-bot/ — WhatsApp bots (QR and pairing linking)
|
|
796
|
-
│ ├── qr.
|
|
797
|
-
│ └── pairing.
|
|
854
|
+
│ ├── qr.ps
|
|
855
|
+
│ └── pairing.ps
|
|
798
856
|
│
|
|
799
857
|
├── tests/
|
|
800
858
|
│ ├── compiler.test.js — language, CLI and formatter coverage
|
package/compiler/bundler.js
CHANGED
|
@@ -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.
|
|
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 (.
|
|
2
|
+
// CLI: compile and run PlainScript (.ps) files.
|
|
3
3
|
//
|
|
4
4
|
// Usage:
|
|
5
|
-
// plainscript run <file.
|
|
6
|
-
// plainscript build [file.
|
|
7
|
-
// plainscript check <file.
|
|
8
|
-
// plainscript fmt <file.
|
|
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.
|
|
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('· .
|
|
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.
|
|
56
|
-
plainscript run <file.
|
|
57
|
-
plainscript start Build src/app.
|
|
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 .
|
|
61
|
-
plainscript build <file.
|
|
62
|
-
plainscript check <file.
|
|
63
|
-
plainscript fmt <file.
|
|
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.
|
|
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.
|
|
149
|
-
// src/helpers/math.
|
|
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 .
|
|
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('.
|
|
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.
|
|
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(/\.
|
|
440
|
-
if (rel.startsWith('..') || path.isAbsolute(rel)) rel = path.basename(absFile).replace(/\.
|
|
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.
|
|
451
|
-
// src/index.
|
|
452
|
-
// src/a/b.
|
|
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.
|
|
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 .
|
|
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 .
|
|
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.
|
|
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.
|
|
523
|
-
fs.writeFileSync(path.join(dir, 'src', 'app.
|
|
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.
|
|
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.
|
|
592
|
-
path.join(srcDir, 'index.
|
|
593
|
+
path.join(srcDir, 'app.ps'),
|
|
594
|
+
path.join(srcDir, 'index.ps'),
|
|
593
595
|
];
|
|
594
596
|
if (srcDir !== '.') {
|
|
595
|
-
candidates.push('app.
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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.
|
|
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.
|
|
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('.
|
|
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.`);
|