upd

Author: mattqual

TODO

@@ -44,7 +44,7 @@
   - [ ] String literal
     - [ ] Is applicable to enumerations (also check for union)
   - [ ] XML expression
-    - [ ] XML tags applied as WhackDS nodes: The prefix, if any, will ignore anything that is not a namespace or package import (even if it is `*`; in that case, if the user needs, they can use interpolation for specifying the tag's type).
+    - [ ] XML literals applied as `XML`/`XMLList` shall resolve namespace prefixes to lexical ShockScript names. (`namespace` definitions may be used as prefixes as well (definition name = URI); with implicit prefix.)
   - [ ] Null literal
   - [ ] Array literal
     - [ ] Is applicable to flag enumerations
@@ -63,6 +63,7 @@
   - [ ] Call operator
     - [ ] Base is passed *followedByCall=true*
     - [ ] Watch for static `sx_proxy::call` when calling classes (supports multiple signatures too)
+    - [ ] Take in consideration compatible overrides and overloads (also important for the `[object Object].equals()` method)
     - [ ] `XML` and `XMLList` being called statically shall still pass themselves as the context type to the first call argument, even if they define `sx_proxy::call()`.
   - [ ] `v as T` operator
     - [ ] Passes context type `T` to `v`
@@ -114,7 +115,7 @@
     - [ ] required `next():{ done: Boolean, value?: T }`
     - [ ] `length():int`
     - [ ] `skip(count:int):void`
-    - [ ] `sx_proxy::filter(...)`
+    - [ ] `sx_proxy::filter(...)` (returns another iterator)
     - [ ] Other functional methods
   - [ ] Iterable.\<K, V> (interface) requires keys() and values()
   - [ ] Generator.\<T>
@@ -125,8 +126,9 @@
     - [ ] Reflect::class()
     - [ ] clone() returns `this`
       - Default implementation clones most objects fine (records, tuples, arrays, maps and so on), but classes with a required constructor will require a custom clone() override.
-    - [ ] `equals(obj:*):Boolean`
+    - [ ] `equals(obj:this):Boolean`
       - May be used in addition to reference equality (==, ===). Default object behavior is ===.
+      - Incompatible operands should use the most compatible base `.equals()` method (call operator specific behavior)
       - Floating points should have an `equals()` implementation done like in React.js's memoization/state new value comparison.
       - [ ] `Map.equals()` should look structurally using inner `.equals()`
       - [ ] Array too

src/overview.md

@@ -6,7 +6,7 @@ ShockScript is a strongly typed, multi-paradigm scripting language.
 
 ## eXtensible Markup Language
 
-ShockScript incorporates eXtensible Markup Language (XML) expressions suitable for implementing GUIs, and also includes capabilities for users interested on XML data processing.
+ShockScript incorporates eXtensible Markup Language (XML) expressions suitable for implementing User Interfaces (UI), and also includes capabilities for users interested on XML data processing.
 
 For the Whack Engine, XML expressions create WhackDS nodes by default.
 

src/overview/relation/mxml.md

@@ -7,7 +7,7 @@ The following demonstrates a basic UI component implemented in WhackDS:
 ```
 package com.business.components {
     //
-    public function AppBar() {
+    public function AppBar():whack.ds.Node {
         return (
             <w:HGroup>
                 <w:Button click&={trace("clicked!")}>button 1</w:Button>

src/overview/relation/reactjs.md

@@ -66,10 +66,12 @@ Unlike React.js, in WhackDS there is no risk of accessing an outdated state's va
 ```
 package com.business.components {
     //
-    public function HelloWorld() {
+    public function HelloWorld():whack.ds.Node {
+        // x
         [State]
-        var x:decimal = 0;
+        var x:Number = 0;
 
+        // layout
         return (
             <w:VGroup>
                 <w:Label>clicked {x} times</w:Label>
@@ -101,7 +103,7 @@ In WhackDS the concept of "refs" is called *bindables*.
 ```
 package com.business.components {
     //
-    public function HelloWorld() {
+    public function HelloWorld():whack.ds.Node {
         [Bindable]
         var button:Button?;
 
@@ -122,7 +124,7 @@ package com.business.components {
 Context usage is represented as `whack.ds.ContextValue.<T>` objects, although they are used as natural `Context`-annotated locals.
 
 ```
-function ExampleComponent() {
+function ExampleComponent():whack.ds.Node {
     //
     [Context(ExampleContext)]
     const example:Number;

src/overview/xml-capabilities.md

@@ -4,12 +4,12 @@ The ShockScript language includes XML capabilities.
 
 ## XML expressions
 
-XML expressions by default are used for creating implementation-defined objects; however, when the inference type is `String`, `XML` or `XMLList`, XML expressions evaluate to one of these types.
+XML expressions by default are used for creating implementation-defined objects; however, when the inference type is `XML` or `XMLList`, XML expressions evaluate to one of these types.
 
 ```
 package com.business.components {
     //
-    public function AppBar() {
+    public function AppBar():whack.ds.Node {
         return (
             <w:HGroup>
                 <w:Button click&={trace("clicked!")}>button 1</w:Button>