upd

Author: mattqual

TODO

@@ -222,7 +222,10 @@
         - [ ] 9. Return the result of calling f with (this) or (this, deep).
       - [ ] DefaultCloneBehavior(self, deep)
         - [ ] Let c = self.meta::class()
-        - [ ] Let o = Create a new instance of c without evaluating the constructor
+        - [ ] If c[[Constructor]].length == 0
+          - [ ] Let o = new c()
+        - [ ] Else
+          - [ ] Let o = Create a new instance of c without evaluating the constructor
         - [ ] Copy instance fields from self to o
           - [ ] If deep=true, map the field value to val?.generic::clone()
         - [ ] Return o

src/overview/e4x.md

@@ -22,9 +22,10 @@ Depending on the inference type, XML literals may be used for constructing imple
 
 ```sx
 package zero {
+    import whack.ds.UIComponent;
     import s = spark.components.*
 
-    public class Main extends whack.ds.UIComponent {
+    public class Main extends UIComponent {
         public function Main() {
             super()
             final = (

src/overview/embed.md

@@ -36,9 +36,13 @@ External files are typically embedded in a structured way in the final program,
 
 ## Including statically
 
-The user may embed files statically as either an UTF-8 encoded string, or `ByteArray`, rather than obtaining an URL.
+The user may embed files statically as either an UTF-8 encoded String, or `ByteArray`, or CSS node depending on the framework, rather than obtaining an URL.
 
 ```sx
+// String
 Embed("BeautySecrets.txt", type="text/plain")
+// ByteArray
 Embed("Hacker.bin", type="application/octet-stream")
+// For Whack, a whack.ds.StyleSheetNode
+Embed("AppBarSkin.css", type="text/css")
 ```

src/overview/language-comparison/mxml.md

@@ -6,9 +6,10 @@ The MXML language, as part of the Apache Flex framework, was used for describing
 
 ```sx
 package zero {
+    import whack.ds.UIComponent;
     import s = spark.components.*
 
-    public class HelloWorld extends whack.ds.UIComponent {
+    public class HelloWorld extends UIComponent {
         public function HelloWorld() {
             super()
             final = (
@@ -72,7 +73,7 @@ Similarly to effects, callbacks that appear in E4X literals applied to the `whac
 Declare State variables using the `State` meta-data:
 
 ```sx
-public class Main extends whack.ds.UIComponent {
+public class Main extends UIComponent {
     [State]
     var counter : uint = 0;
 }
@@ -93,7 +94,7 @@ x = [...x, 10]
 In the top-level of a Whack DS component, declare bindables by using the `Bindable` meta-data. Bindables have certain use-cases, such as persisting a value across renders, and extracting DOM elements from certain tags (in which case the `bind` attribute is used).
 
 ```sx
-public class Main extends whack.ds.UIComponent {
+public class Main extends UIComponent {
     [Bindable]
     var button : org.w3.web.Button? = null;
 
@@ -111,8 +112,8 @@ public class Main extends whack.ds.UIComponent {
 Obtain inherited contexts by using a Context variable.
 
 ```sx
-public class Main extends whack.ds.UIComponent {
-    [Context("metro.context.Theme")]
+public class Main extends UIComponent {
+    [Context("spark.contexts.Theme")]
     const theme;
 
     public function Main() {

src/overview/language-comparison/reactjs.md

@@ -8,9 +8,10 @@ There are, however, many positive differences to ReactJS, such as memoization an
 
 ```sx
 package zero {
+    import whack.ds.UIComponent;
     import s = spark.components.*
 
-    public class HelloWorld extends whack.ds.UIComponent {
+    public class HelloWorld extends UIComponent {
         public function HelloWorld() {
             super()
             final = (
@@ -85,7 +86,9 @@ Unlike ReactJS, in Whack DS there is no risk of accessing an outdated state's va
 
 ```sx
 package spark.components {
-    public class Ark extends whack.ds.UIComponent {
+    import whack.ds.UIComponent;
+
+    public class Ark extends UIComponent {
         [State]
         var x : uint = 0;
 
@@ -122,7 +125,9 @@ In Whack DS the concept of "refs" is called *bindables*.
 
 ```sx
 package spark.components {
-    public class Ark extends whack.ds.UIComponent {
+    import whack.ds.UIComponent;
+
+    public class Ark extends UIComponent {
         [Bindable]
         var button : org.w3.web.Button? = null;
 
@@ -148,8 +153,8 @@ Note `.@x` is a meta-data attribute accessor for DOM elements.
 Using contexts results in `ContextReference.<T>` objects, although they are used as natural `Context`-annotated variables.
 
 ```sx
-public class View extends whack.ds.UIComponent {
-    [Context("zero.context.Example")]
+public class View extends UIComponent {
+    [Context("zero.contexts.Example")]
     const example;
 
     public function View() {
@@ -166,7 +171,7 @@ public class View extends whack.ds.UIComponent {
 Props must be typed **tap \{\}**. It is not recommended to destructure Props.
 
 ```sx
-public class View extends whack.ds.UIComponent {
+public class View extends UIComponent {
     public function View(props : Props) {
         super()
         final = (

src/overview/whack_ds.md

@@ -40,8 +40,10 @@ Whack DS supports style sheets out of the box. Here is a simple example:
 Here is a little code snippet:
 
 ```sx
-package metro.components {
-    public class TabBar extends whack.ds.UIComponent {
+package spark.components {
+    import whack.ds.UIComponent;
+
+    public class TabBar extends UIComponent {
         var props : Props
 
         public function TabBar(props : Props) {
@@ -63,9 +65,10 @@ Here's a slightly bigger code snippet for a linear second accumulator:
 
 ```sx
 package {
+    import whack.ds.UIComponent;
     import whack.util.*
 
-    public class Clock extends whack.ds.UIComponent {
+    public class Clock extends UIComponent {
         var props : Props ;
         [State]
         var mSecs : bigint? = null;
@@ -151,9 +154,10 @@ The `function` case allows tag attributes such as `bind` to specify a receiver t
 
 ```sx
 package zero.components {
+    import whack.ds.UIComponent;
     import org.w3.web.Div;
 
-    public class Binding extends whack.ds.UIComponent {
+    public class Binding extends UIComponent {
         [Bindable]
         var element : Div? = null;
 
@@ -226,8 +230,10 @@ A component may be an alias by using the Alias meta-data, which specifies a Shoc
 
 ```sx
 package spark.components {
+    import whack.ds.UIComponent;
+
     [Alias("w::VGroup")]
-    public class VGroup extends whack.ds.UIComponent {
+    public class VGroup extends UIComponent {
     }
 }
 ```
@@ -242,15 +248,16 @@ A component library typically provides an Application component so you do not ha
 
 ```sx
 package {
-    import mx = metro.components.*;
+    import whack.ds.UIComponent;
+    import s = spark.components.*;
 
-    public class Main extends whack.ds.UIComponent {
+    public class Main extends UIComponent {
         public function Main() {
             super()
             final = (
-                <mx:Application>
+                <s:Application>
                     <w:EyeExp name="camera" size={37}/>
-                </mx:Application>
+                </s:Application>
             )
         }
     }

src/overview/whack_ds/mxml_like.md

@@ -38,7 +38,9 @@ The `key` attribute is reserved for uniquely identifying interpolated collection
 
 ```sx
 package zero.components {
-    public class Ark extends whack.ds.UIComponent {
+    import whack.ds.UIComponent;
+
+    public class Ark extends UIComponent {
         public function Ark() {
             super();
             final = (
@@ -64,7 +66,9 @@ If the style sheet is too large, it may be moved out of the ShockScript file; fo
 
 ```sx
 package zero.components {
-    public class Ark extends whack.ds.UIComponent {
+    import whack.ds.UIComponent;
+
+    public class Ark extends UIComponent {
         public function Ark() {
             super();
             final = (
@@ -127,7 +131,9 @@ For a component to support `<fx:Style>` tags, it simply needs to support a `styl
 
 ```sx
 package zero.components {
-    public class Ark extends whack.ds.UIComponent {
+    import whack.ds.UIComponent;
+
+    public class Ark extends UIComponent {
         public function Ark(props : Props) {
             super();
             final = (

src/serial.md

@@ -6,12 +6,15 @@ This feature may only be used with classes that are annotatated with either the
 
 Variants of an algebraic data type do not need to specify the `Serial` or `XS` meta-data.
 
-The default behavior while deserializing into a class other than primitive types and certain global classes, unless defining a self-attached `fromJSON` or `fromXML` method, is roughly:
-
-1. Create a new instance *o* of the class without evaluating the constructor
-2. Let *fields* = Each *o*\[*k*\] field that is not configured with the `skip="true"` option.
-3. Assign each field of *fields* to the respective data document field with the appropriate parsing of the field's data type, applying any configured rename.
-4. Return *o*
+The default behavior while deserializing into a class *c* other than primitive types and certain global classes, unless defining a self-attached `fromJSON` or `fromXML` method, is roughly:
+
+1. If *c*<i>[[Constructor]]</i>.length == 0
+  1. Let o = new *c*()
+2. Else
+  1. Let o = Create a new instance of *c* without evaluating the constructor
+3. Let *fields* = Each *o*\[*k*\] field that is not configured with the `skip="true"` option.
+4. Assign each field of *fields* to the respective data document field with the appropriate parsing of the field's data type, applying any configured rename.
+5. Return *o*
 
 Simple enums, including Flags enums, are serialized and deserialized in a different way from algebraic enums.