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 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.0 — the `plainscript` npm package with a TypeScript-style production build (`plainscript build` → `dist/`, source names preserved).
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.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.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 <file.ps> check syntax only (no JS generated, no execution)
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 <file.ps> Syntax-check only — fastest feedback loop
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.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
- function cmdCheck(filePath) {
751
- if (!filePath) {
752
- console.error('Usage: plainscript check <file.ps>');
753
- process.exit(1);
754
- }
755
- const absPath = path.resolve(filePath);
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(absPath);
763
- const ms = Date.now() - t0;
764
- console.log(`${clrGreen('✓')} ${filePath} — no errors found.${clrDim(` (${ms}ms)`)}`);
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
- console.error(err.message);
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); break;
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;