docs

Author: sinclairzx81

readme.md

@@ -71,12 +71,12 @@ License: MIT
   - [Array](#Array)
   - [Optional](#Optional)
   - [Epsilon](#Epsilon)
-- [Tokens](#Tokens)
-  - [Ident](#Ident)
-  - [Integer](#Integer)
-  - [BigInt](#BigInt)
+- [Token](#Token)
   - [Number](#Number)
   - [String](#String)
+  - [Integer](#Integer)
+  - [BigInt](#BigInt)
+  - [Ident](#Ident)
 - [Mapping](#Mapping)
 - [Modules](#Modules)
 - [Advanced](#Advanced)
@@ -235,29 +235,38 @@ const R1 = Runtime.Parse(T, 'X Y Z')                // const R1 = [['X', 'Y'], '
 const R2 = Runtime.Parse(T, 'Y Z')                  // const R2 = [[], 'Y Z']
 ```
 
-## Tokens
+## Token
 
 ParseBox includes several specialized combinators used to quickly parse common language tokens.
 
-### Ident
+### Number
 
-Parses an identifier
+Parses a number with fractional parts
 
 ```typescript
-const Expression = Runtime.Number()                 //  const Expression = { type: 'Number' }
+const T = Runtime.Number()
 
-const Let = Runtime.Tuple([                         //  const Let = {
-  Runtime.Const('let'),                             //    type: 'Tuple',
-  Runtime.Ident(),                                  //    parsers: [
-  Runtime.Const('='),                               //      { type: 'Const', value: 'let' },
-  Expression                                        //      { type: 'Ident' },
-])                                                  //      { type: 'Const', value: '=' },
-                                                    //      { type: 'Number' },
-                                                    //    ]
-                                                    //  }
+// ...
 
-const R = Runtime.Parse(Let, 'let n = 10')          // const R = [[ 'let', 'n', '=', '10'], '' ]
+const R1 = Runtime.Parse(T, '1')                    // const R1 = ['1', '']
+
+const R2 = Runtime.Parse(T, '3.14')                 // const R2 = ['3.14', '']
+
+const R3 = Runtime.Parse(T, '.1')                   // const R3 = ['.1', '']
+
+const E = Runtime.Parse(T, '01')                    // const E = ['0', '1']
+```
+
+### String
+
+The String combinator parses quoted string literals, accepting an array of permissible quote characters. The result is the interior string.
+
+```typescript
+const T = Runtime.String(['"'])
+
+// ...
 
+const R = Runtime.Parse(T, '"hello"')              // const R = ['hello', '']
 ```
 
 ### Integer
@@ -296,39 +305,27 @@ const R3 = Runtime.Parse(T, '.1n')                   // const R3 = []
 const E = Runtime.Parse(T, '01n')                    // const E = []
 ```
 
-### Number
-
-Parses a number with fractional parts
-
-```typescript
-const T = Runtime.Number()
-
-// ...
-
-const R1 = Runtime.Parse(T, '1')                    // const R1 = ['1', '']
-
-const R2 = Runtime.Parse(T, '3.14')                 // const R2 = ['3.14', '']
-
-const R3 = Runtime.Parse(T, '.1')                   // const R3 = ['.1', '']
-
-const E = Runtime.Parse(T, '01')                    // const E = ['0', '1']
-```
 
-### String
+### Ident
 
-The String combinator parses quoted string literals, accepting an array of permissible quote characters. The result is the interior string.
+Parses an identifier
 
 ```typescript
-const T = Runtime.String(['"'])
+const Let = Runtime.Tuple([                         //  const Let = {
+  Runtime.Const('let'),                             //    type: 'Tuple',
+  Runtime.Ident(), /* here */                       //    parsers: [
+  Runtime.Const('='),                               //      { type: 'Const', value: 'let' },
+  Runtime.Number()                                  //      { type: 'Ident' },
+])                                                  //      { type: 'Const', value: '=' },
+                                                    //      { type: 'Number' },
+                                                    //    ]
+                                                    //  }
 
-// ...
+const R = Runtime.Parse(Let, 'let n = 10')          // const R = [[ 'let', 'n', '=', '10'], '' ]
 
-const R = Runtime.Parse(T, '"hello"')              // const R = ['hello', '']
 ```
 
 
-
-
 ## Mapping
 
 ParseBox supports semantic actions (i.e., mappings) for both static and runtime parsing, enabling parsed content to be transformed into complex structures like abstract syntax trees (ASTs). Below is an explanation of how mapping works in both environments.