plainscript-lang 1.0.0 → 1.0.1
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 +6 -6
- package/compiler/cli.js +125 -18
- package/compiler/generator.js +155 -120
- package/compiler/lexer.js +1 -1
- package/compiler/parser.js +130 -12
- package/compiler/version.js +1 -1
- package/docs/CAPABILITY_GAP_AUDIT.md +9 -9
- package/docs/PLINJS_SPEC.md +4 -4
- package/docs/index.html +25 -20
- package/docs/website/script.js +1 -1
- package/examples/auth-api.ps +2 -2
- package/examples/concurrency.ps +1 -1
- package/examples/error-handling.ps +1 -1
- package/examples/file-uploads.ps +1 -1
- package/examples/files-and-config.ps +1 -1
- package/examples/http-client.ps +1 -1
- package/examples/modules/app.ps +1 -1
- package/examples/modules/math.ps +1 -1
- package/examples/record-kinds.ps +1 -1
- package/examples/search-and-filter.ps +1 -1
- package/examples/sessions-and-cookies.ps +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# PlainScript
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
|
-
<img src="docs/logo.jpg" alt="PlainScript Logo" width="200" />
|
|
4
|
+
<img src="https://github.com/ayoistooslick/plainscript/blob/main/docs/logo.jpg" alt="PlainScript Logo" width="200" />
|
|
5
5
|
</p>
|
|
6
6
|
|
|
7
7
|
> "When even a simple sentence can be code."
|
|
@@ -9,7 +9,7 @@
|
|
|
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:** v1.0.
|
|
12
|
+
**Current version:** v1.0.1 — the `plainscript` npm package with a TypeScript-style production build (`plainscript build` → `dist/`, source names preserved).
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
@@ -26,7 +26,7 @@ node dist/app.js # or: npm start
|
|
|
26
26
|
Adding PlainScript to an existing project:
|
|
27
27
|
|
|
28
28
|
```bash
|
|
29
|
-
npm install --save-dev plainscript
|
|
29
|
+
npm install --save-dev plainscript-lang
|
|
30
30
|
# start writing src/*.ps files — plainscript build auto-discovers them
|
|
31
31
|
```
|
|
32
32
|
|
|
@@ -108,7 +108,7 @@ 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": "^1.0.
|
|
111
|
+
"devDependencies": { "plainscript-lang": "^1.0.1" }
|
|
112
112
|
}
|
|
113
113
|
```
|
|
114
114
|
|
|
@@ -297,9 +297,9 @@ use node-fetch
|
|
|
297
297
|
use @scope/package-name
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
### TypeScript-parity capabilities (1.0.
|
|
300
|
+
### TypeScript-parity capabilities (1.0.1)
|
|
301
301
|
|
|
302
|
-
The full capability-gap audit lives in [`docs/CAPABILITY_GAP_AUDIT.md`](docs/CAPABILITY_GAP_AUDIT.md).
|
|
302
|
+
The full capability-gap audit lives in [`docs/CAPABILITY_GAP_AUDIT.md`](https://github.com/ayoistooslick/plainscript/blob/main/docs/CAPABILITY_GAP_AUDIT.md).
|
|
303
303
|
These features close it in PlainScript's own grammar:
|
|
304
304
|
|
|
305
305
|
- **Record kinds (classes):** `define a kind called "Person" with name is "" done`
|
package/compiler/cli.js
CHANGED
|
@@ -4,7 +4,8 @@
|
|
|
4
4
|
// Usage:
|
|
5
5
|
// plainscript run <file.ps> install missing dependencies, compile and execute
|
|
6
6
|
// plainscript build [file.ps] compile src/ (or one file) to dist/, names preserved
|
|
7
|
-
// plainscript check
|
|
7
|
+
// plainscript check [target] fully validate source(s): imports + generate + JS syntax
|
|
8
|
+
// (target: a .ps file, a directory, or none to scan the project)
|
|
8
9
|
// plainscript fmt <file.ps> format a PlainScript file in-place
|
|
9
10
|
// plainscript new [name] scaffold a new PlainScript project
|
|
10
11
|
// plainscript install install dependencies detected in the project's sources
|
|
@@ -18,6 +19,7 @@
|
|
|
18
19
|
|
|
19
20
|
const fs = require('fs');
|
|
20
21
|
const path = require('path');
|
|
22
|
+
const vm = require('vm');
|
|
21
23
|
const { execFileSync } = require('child_process');
|
|
22
24
|
const { tokenize } = require('./lexer');
|
|
23
25
|
const { parse } = require('./parser');
|
|
@@ -59,7 +61,9 @@ ${section('START')}
|
|
|
59
61
|
${section('BUILD & CHECK')}
|
|
60
62
|
plainscript build Compile every .ps under src/ into dist/
|
|
61
63
|
plainscript build <file.ps> Compile one file into dist/ (name preserved)
|
|
62
|
-
plainscript check
|
|
64
|
+
plainscript check [target] Validate imports + generate + JS output (no writes)
|
|
65
|
+
target: a .ps file, a directory, or none = project scan
|
|
66
|
+
--json emits deterministic machine-readable output
|
|
63
67
|
plainscript fmt <file.ps> Format a file in place
|
|
64
68
|
|
|
65
69
|
${section('PACKAGES')}
|
|
@@ -548,7 +552,7 @@ done
|
|
|
548
552
|
// deployment only needs the generated dist/ output.
|
|
549
553
|
fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({
|
|
550
554
|
name,
|
|
551
|
-
version: '1.0.
|
|
555
|
+
version: '1.0.1',
|
|
552
556
|
description: `A PlainScript v${VERSION} application`,
|
|
553
557
|
main: 'dist/app.js',
|
|
554
558
|
scripts: {
|
|
@@ -747,25 +751,127 @@ function cmdUpdate() {
|
|
|
747
751
|
}
|
|
748
752
|
|
|
749
753
|
// Check syntax of a PlainScript file without generating JavaScript or executing.
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
const
|
|
756
|
-
if (!fs.existsSync(absPath)) {
|
|
757
|
-
console.error(`File not found: ${filePath}`);
|
|
758
|
-
process.exit(1);
|
|
759
|
-
}
|
|
754
|
+
// Full validation of a single .ps entry: resolve imports, parse+generate every
|
|
755
|
+
// file in dependency order, and verify the emitted JavaScript is syntactically
|
|
756
|
+
// valid — all without writing anything to disk. Returns a deterministic
|
|
757
|
+
// result record; `deps` are the npm packages the sources require.
|
|
758
|
+
function validateSource(absPath) {
|
|
759
|
+
const rel = path.relative(process.cwd(), absPath) || absPath;
|
|
760
760
|
const t0 = Date.now();
|
|
761
761
|
try {
|
|
762
|
-
resolveDependencies
|
|
763
|
-
|
|
764
|
-
|
|
762
|
+
// resolveDependencies parses each file too, so a parse error anywhere in
|
|
763
|
+
// the import graph surfaces here with a "file.ps — Line:Col" prefix.
|
|
764
|
+
const files = resolveDependencies(absPath);
|
|
765
|
+
const context = createGenerationContext();
|
|
766
|
+
let js = files.map(({ ast }) => generate(ast, context)).filter(s => s.trim()).join('\n');
|
|
767
|
+
if (context.needsAsync) js = wrapAsync(js);
|
|
768
|
+
|
|
769
|
+
// The compiler must never emit broken JavaScript. Parsing the output with
|
|
770
|
+
// the V8 compiler catches generator regressions at check time.
|
|
771
|
+
new vm.Script(js);
|
|
772
|
+
|
|
773
|
+
// Collect unique npm dependencies across the file and its imports.
|
|
774
|
+
const deps = [];
|
|
775
|
+
for (const { absPath: f } of files) {
|
|
776
|
+
let source;
|
|
777
|
+
try { source = fs.readFileSync(f, 'utf8'); } catch (_) { continue; }
|
|
778
|
+
for (const d of detectDependencies(source)) {
|
|
779
|
+
if (!deps.includes(d)) deps.push(d);
|
|
780
|
+
}
|
|
781
|
+
}
|
|
782
|
+
return { file: rel, ok: true, deps, ms: Date.now() - t0 };
|
|
765
783
|
} catch (err) {
|
|
766
|
-
|
|
784
|
+
return { file: rel, ok: false, error: err.message, ms: Date.now() - t0 };
|
|
785
|
+
}
|
|
786
|
+
}
|
|
787
|
+
|
|
788
|
+
// `plainscript check [target] [--json]`
|
|
789
|
+
//
|
|
790
|
+
// Fully validates one .ps file, every .ps under a directory, or (with no
|
|
791
|
+
// target) the project sources, deterministically and non-interactively:
|
|
792
|
+
// resolve imports, parse + generate, and confirm the JS output parses. Never
|
|
793
|
+
// prompts, never writes files, never installs packages.
|
|
794
|
+
//
|
|
795
|
+
// plainscript check validate every .ps in the project source root
|
|
796
|
+
// plainscript check app.ps validate one file (and its imports)
|
|
797
|
+
// plainscript check src/ validate every .ps under a directory
|
|
798
|
+
// plainscript check --json machine-readable JSON on stdout
|
|
799
|
+
function cmdCheck(target, json) {
|
|
800
|
+
const opts = readCompilerOptions();
|
|
801
|
+
const srcDir = resolveSrcDir(opts);
|
|
802
|
+
const outDir = resolveOutDir(opts);
|
|
803
|
+
const exclude = opts && opts.exclude;
|
|
804
|
+
|
|
805
|
+
let sources;
|
|
806
|
+
if (target) {
|
|
807
|
+
const abs = path.resolve(target);
|
|
808
|
+
if (fs.existsSync(abs) && fs.statSync(abs).isDirectory()) {
|
|
809
|
+
sources = discoverSources(abs, outDir, exclude).map(r => path.join(abs, r));
|
|
810
|
+
} else if (/\.ps$/.test(target) && !fs.existsSync(abs)) {
|
|
811
|
+
if (json) {
|
|
812
|
+
console.log(JSON.stringify({
|
|
813
|
+
plainscript: VERSION, ok: false,
|
|
814
|
+
sources: [], summary: { total: 0, passed: 0, failed: 1 },
|
|
815
|
+
errors: [{ file: target, error: `File not found: ${target}` }],
|
|
816
|
+
}));
|
|
817
|
+
} else {
|
|
818
|
+
console.error(`File not found: ${target}`);
|
|
819
|
+
}
|
|
820
|
+
process.exit(1);
|
|
821
|
+
} else {
|
|
822
|
+
sources = [abs];
|
|
823
|
+
}
|
|
824
|
+
} else {
|
|
825
|
+
const root = path.resolve(srcDir);
|
|
826
|
+
sources = discoverSources(srcDir, outDir, exclude).map(r => path.join(root, r));
|
|
827
|
+
if (sources.length === 0) {
|
|
828
|
+
const msg = `No .ps files found under "${srcDir}".`;
|
|
829
|
+
if (json) console.log(JSON.stringify({ plainscript: VERSION, ok: false, sources: [], summary: { total: 0, passed: 0, failed: 1 }, errors: [{ file: srcDir, error: msg }] }));
|
|
830
|
+
else console.error(msg);
|
|
831
|
+
process.exit(1);
|
|
832
|
+
}
|
|
833
|
+
}
|
|
834
|
+
|
|
835
|
+
sources.sort(); // deterministic regardless of filesystem order
|
|
836
|
+
const results = sources.map(validateSource);
|
|
837
|
+
const passed = results.filter(r => r.ok);
|
|
838
|
+
const failed = results.filter(r => !r.ok);
|
|
839
|
+
|
|
840
|
+
if (json) {
|
|
841
|
+
const dependencySummary = [];
|
|
842
|
+
const depIndex = new Map();
|
|
843
|
+
for (const r of passed) {
|
|
844
|
+
for (const d of r.deps) {
|
|
845
|
+
if (!depIndex.has(d)) { depIndex.set(d, []); dependencySummary.push(d); }
|
|
846
|
+
depIndex.get(d).push(r.file);
|
|
847
|
+
}
|
|
848
|
+
}
|
|
849
|
+
console.log(JSON.stringify({
|
|
850
|
+
plainscript: VERSION,
|
|
851
|
+
ok: failed.length === 0,
|
|
852
|
+
sources: results,
|
|
853
|
+
summary: { total: results.length, passed: passed.length, failed: failed.length },
|
|
854
|
+
dependencySummary: dependencySummary.map(d => ({ package: d, usedBy: depIndex.get(d) })),
|
|
855
|
+
}));
|
|
856
|
+
process.exit(failed.length ? 1 : 0);
|
|
857
|
+
}
|
|
858
|
+
|
|
859
|
+
for (const r of results) {
|
|
860
|
+
if (r.ok) {
|
|
861
|
+
console.log(`${clrGreen('✓')} ${r.file} — ok${clrDim(` (${r.ms}ms)`)}`);
|
|
862
|
+
} else {
|
|
863
|
+
console.log(`${clrRed('✗')} ${r.file}`);
|
|
864
|
+
console.error(r.error);
|
|
865
|
+
}
|
|
866
|
+
}
|
|
867
|
+
|
|
868
|
+
if (failed.length > 0) {
|
|
869
|
+
console.error(`\n${failed.length} of ${results.length} file(s) failed validation.`);
|
|
767
870
|
process.exit(1);
|
|
768
871
|
}
|
|
872
|
+
if (results.length > 0) {
|
|
873
|
+
console.log(clrGreen(`\n✓ ${results.length} file(s) validated.`));
|
|
874
|
+
}
|
|
769
875
|
}
|
|
770
876
|
|
|
771
877
|
// Format a PlainScript file in-place.
|
|
@@ -805,6 +911,7 @@ async function main() {
|
|
|
805
911
|
// Global flags — recognized anywhere in the argument list.
|
|
806
912
|
const quiet = args.includes('--quiet');
|
|
807
913
|
const verbose = args.includes('--verbose');
|
|
914
|
+
const json = args.includes('--json');
|
|
808
915
|
if (quiet) { stage = stageQuiet; QUIET_STAGES = true; }
|
|
809
916
|
if (verbose) { stage = stageVerbose; VERBOSE = true; }
|
|
810
917
|
|
|
@@ -817,7 +924,7 @@ async function main() {
|
|
|
817
924
|
switch (command) {
|
|
818
925
|
case 'run': await cmdRun(fileArg, positional.slice(2)); break;
|
|
819
926
|
case 'build': await cmdBuild(fileArg); break;
|
|
820
|
-
case 'check': cmdCheck(fileArg);
|
|
927
|
+
case 'check': cmdCheck(fileArg, json); break;
|
|
821
928
|
case 'fmt': cmdFmt(fileArg); break;
|
|
822
929
|
case 'new': cmdNew(fileArg); break;
|
|
823
930
|
case 'install': cmdInstall(); break;
|