upd

Author: mattqual

TODO

@@ -162,6 +162,8 @@
   - [ ] NaN
   - [ ] undefined
   - [ ] Number = union `(byte, short, int, uint, long, bigint, float, double, decimal)`
+  - [ ] boolean alias = Boolean
+  - [ ] string alias = String
   - [ ] DecimalContext
     - [ ] Supports "precision" and "rounding" options for now (look at decimal.js's API to get some ideas)
   - [ ] Iterator.\<T> (interface)
@@ -228,6 +230,7 @@
     - [ ] toString()
     - [ ] toLocaleString()
     - [ ] valueOf()
+  - [ ] Boolean class
   - [ ] Array
     - [ ] +Iterable
     - [ ] length : int (not uint)
@@ -259,7 +262,7 @@
   - [ ] Math
     - [ ] `random()`
     - [ ] `random(start, end)` (inclusive; most Number types supported)
-  - [ ] string
+  - [ ] String class
     - [ ] +Iterable
     - [ ] static `fromByte(...):string`
     - [ ] length (in UTF-8 bytes; int, not uint)

src/SUMMARY.md

@@ -29,8 +29,8 @@
   - [Wildcard type](./types/wildcard.md)
   - [void type](./types/void.md)
   - [null type](./types/null.md)
-  - [string type](./types/string.md)
-  - [boolean type](./types/boolean.md)
+  - [String type](./types/string.md)
+  - [Boolean type](./types/boolean.md)
   - [Number type](./types/number.md)
   - [float type](./types/float.md)
   - [double type](./types/double.md)

src/overview/language-comparison/as3.md

@@ -5,15 +5,16 @@ ShockScript looks like ActionScript 3. This section describes several details th
 ## Primitive types
 
 - ShockScript does have more numeric types close to ECMAScript 4.
-- Primitive types are in a lowercase form, adapting more from the ECMAScript 4 proposal, but without backwards compatibility.
+- The Boolean and String type names are as they are, although they are alternatively aliased `boolean` and `string` in the top-level package.
 
-## string type
+## String type
 
-The `string` type stores an UTF-8 encoded text, not an UTF-16 encoded text.
+The String type stores an UTF-8 encoded text, not an UTF-16 encoded text.
 
 ```sx
-"\u{10ffff}".length    // utf-8 length
-"\u{10ffff}".charAt(0) // code point at byte 0
+"\u{10ffff}".length    // UTF-8 length
+"\u{10ffff}".charAt(0) // Code Point at byte 0
+"\u{10ffff}".charCodeAt(0)
 
 
 for each (var ch in "shockscript".chars()) {
@@ -26,7 +27,7 @@ for each (var ch in "shockscript".chars()) {
 
 ## Include directive
 
-The `include` directive is not included in ShockScript.
+The `include` directive is not included in ShockScript. It was attempted before, even though it imposes certain efforts for language servers. That may be reconsidered in the future.
 
 ## Dynamic
 
@@ -68,7 +69,7 @@ trace(k in m);
 The filter operator has been modified to use a `*` identifier rather than cluttering the lexical scope with dynamic names.
 
 ```sx
-xnode.(*.@x.startsWith("abc"))
+xn.(*.@x.startsWith("abc"))
 ```
 
 ## With statement

src/types/array.md

@@ -4,4 +4,4 @@ The `Array.<T>` type, abbreviated `[T]`, represents a growable list of elements.
 
 ## Numeric optimization
 
-`[t]` is optimized for when `t` is a number or boolean type; for instance, `[uint]` uses a growable buffer optimized specifically for 32-bit integers.
+`[t]` is optimized for when `t` is a Number or Boolean type; for instance, `[uint]` uses a growable buffer optimized specifically for 32-bit integers.

src/types/boolean.md

@@ -1,3 +1,3 @@
-# boolean type
+# Boolean type
 
-The `boolean` type consists of the values `false` and `true`.
+The Boolean type (or its alias `boolean`) consists of the values `false` and `true`.

src/types/string.md

@@ -1,5 +1,5 @@
-# string type
+# String type
 
-The `string` type represents an UTF-8 encoded character sequence.
+The String type (or its alias `string`) represents an UTF-8 encoded character sequence.
 
 > **Note**: the `.length` property of a `string` equals the byte total, and the `.chars().length()` method of a `string` equals the Unicode code point total.