@altopelago/aeon-parser 0.9.1 → 0.9.3

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 (2) hide show
  1. package/README.md +22 -0
  2. package/package.json +5 -4
package/README.md CHANGED
@@ -19,8 +19,30 @@ const result = parse(tokens);
19
19
 
20
20
  if (result.errors.length === 0) {
21
21
  console.log(result.root);
22
+ } else {
23
+ console.error(result.errors);
22
24
  }
23
25
  ```
24
26
 
27
+ ## What This Package Does
28
+
29
+ - converts lexer tokens into AEON syntax trees
30
+ - preserves parser diagnostics for source-aware tooling
31
+ - keeps parsing separate from schema validation and final materialization
32
+
33
+ ## API
34
+
35
+ - `parse(tokens, options?)`
36
+ - parser result and AST node types
37
+
38
+ ## When To Use It
39
+
25
40
  Use this package when you need direct parser output for tooling or advanced analysis.
26
41
  If you want the stable application-facing entry point, prefer `@altopelago/aeon-core`.
42
+
43
+ ## Notes
44
+
45
+ - The parser does not execute AEON documents.
46
+ - The parser does not coerce values into JavaScript application types.
47
+ - Most applications should use `@altopelago/aeon-core`, which combines lexing,
48
+ parsing, mode checks, AES emission, and diagnostics into a safer entry point.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@altopelago/aeon-parser",
3
- "version": "0.9.1",
4
- "description": "Parser for AEON tokens and source text.",
3
+ "version": "0.9.3",
4
+ "description": "Parse AEON tokens into syntax trees and diagnostics.",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "main": "./dist/index.js",
@@ -35,15 +35,16 @@
35
35
  "keywords": [
36
36
  "aeon",
37
37
  "aeonite",
38
+ "ast",
38
39
  "parser",
39
- "schema",
40
+ "syntax",
40
41
  "typescript"
41
42
  ],
42
43
  "publishConfig": {
43
44
  "access": "public"
44
45
  },
45
46
  "dependencies": {
46
- "@altopelago/aeon-lexer": "0.9.1"
47
+ "@altopelago/aeon-lexer": "0.9.3"
47
48
  },
48
49
  "scripts": {
49
50
  "build": "tsc -p tsconfig.json",