From 396a5b811a33fcfdd7314346f17d1f689aba171b Mon Sep 17 00:00:00 2001
From: Araozu <fernando@araozu.dev>
Date: Sat, 20 Jul 2024 22:44:42 -0500
Subject: [PATCH] add doc pages

---
 src/pages/learn/classes/abstract.mdx        |   7 +
 src/pages/learn/classes/constructor.mdx     | 102 ++++++++++
 src/pages/learn/classes/definition.mdx      | 197 ++++++--------------
 src/pages/learn/classes/inheritance.mdx     |  26 +++
 src/pages/learn/classes/readonly.mdx        |   7 +
 src/pages/learn/classes/visibility.mdx      |   7 +
 src/pages/learn/index.mdx                   |   5 +
 src/pages/learn/templating/control-flow.mdx |  65 +++++++
 8 files changed, 275 insertions(+), 141 deletions(-)
 create mode 100644 src/pages/learn/classes/abstract.mdx
 create mode 100644 src/pages/learn/classes/constructor.mdx
 create mode 100644 src/pages/learn/classes/inheritance.mdx
 create mode 100644 src/pages/learn/classes/readonly.mdx
 create mode 100644 src/pages/learn/classes/visibility.mdx

diff --git a/src/pages/learn/classes/abstract.mdx b/src/pages/learn/classes/abstract.mdx
new file mode 100644
index 0000000..71104ae
--- /dev/null
+++ b/src/pages/learn/classes/abstract.mdx
@@ -0,0 +1,7 @@
+---
+layout: ../../../layouts/DocsLayout.astro
+title: Abstract
+---
+import Code from "../../../components/Code.astro"
+
+# Abstract
diff --git a/src/pages/learn/classes/constructor.mdx b/src/pages/learn/classes/constructor.mdx
new file mode 100644
index 0000000..810f553
--- /dev/null
+++ b/src/pages/learn/classes/constructor.mdx
@@ -0,0 +1,102 @@
+---
+layout: ../../../layouts/DocsLayout.astro
+title: Constructor/Destructor
+---
+import Code from "../../../components/Code.astro"
+
+# Constructor/Destructor
+
+
+(for now) THP's constructors are inspired by Kotlin.
+
+PHP only allows a single constructor, and so does THP.
+The basic constructor has the syntax of function parameters.
+
+<Code thpcode={`
+//          |this is the constructor |
+class Animal(String fullname, Int age)
+
+val a1 = Animal("Nal", 4)
+`} />
+
+The class properties can be declared in the constructor,
+using the keywords `pub`, `var`, `val`:
+
+<Code thpcode={`
+class Animal(
+    // Since we are using val/var, these are promoted to class properties
+    val String fullname,
+    var Int age,
+)
+{
+    pub fun say()
+    {
+        // Here we are using the properties declared in the constructor
+        print("My name is {$fullname} and i'm {$age} years old")
+    }
+}
+
+val a1 = Animal("Nal", 4)
+a1.say()    //: My name is Nal and i'm 4 years old
+`} />
+
+By using this syntax you are declaring properties and assigning them
+at the same time.
+
+The contructor parameters can also have default values.
+
+
+### Constructor visibility
+
+The constructor is public by default. It can be made private/protected
+like this:
+
+<Code thpcode={`
+class Animal
+private constructor(
+    val String fullname,
+    var Int age,
+)
+{...}
+`} />
+
+
+### Derived properties
+
+You can declare properties whose values depend on values
+on the constructor.
+
+<Code thpcode={`
+class Animal(
+    val String fullname,
+)
+{
+    // A property whose value depends on \`fullname\`
+    // This is executed after the contructor
+    pub val Int name_length = $fullname.length
+}
+
+val a2 = Animal("Doa")
+print(a2.name_length)   //: 3
+`} />
+
+
+### Init block
+
+If you need to additional logic in the constructor you can
+use a `init` block.
+
+<Code thpcode={`
+class Animal(
+    val String fullname,
+)
+{
+    init
+    {
+        print("{$fullname} in contruction...")
+    }
+}
+
+val a3 = Animal("Lola")     //: Lola in construction
+`} />
+
diff --git a/src/pages/learn/classes/definition.mdx b/src/pages/learn/classes/definition.mdx
index 23afc7d..6c3cf0b 100644
--- a/src/pages/learn/classes/definition.mdx
+++ b/src/pages/learn/classes/definition.mdx
@@ -1,6 +1,6 @@
 ---
 layout: ../../../layouts/DocsLayout.astro
-title: Classes
+title: Basics
 ---
 import Code from "../../../components/Code.astro"
 
@@ -8,30 +8,34 @@ import Code from "../../../components/Code.astro"
 
 Syntax and semantics heavily inspired by Kotlin.
 
+Classes in THP are significantly different than PHP.
 
-## Create a new instance of a class
+## Definition
 
-To create an instance of a class call it as if it were a function,
+A class is defined as follows:
+
+<Code thpcode={`
+class Animal
+`} />
+
+The name of the class **MUST** begin with an uppercase letter.
+
+
+
+## Instanciation
+
+To create an instance of a class call it as if it was a function,
 without `new`.
 
 <Code thpcode={`
 val animal = Animal()
 `} />
 
-## Simple class 
-
-Classes are declared with the `class` keyword.
-
-<Code thpcode={`
-class Animal
-
-val instance = Animal()
-`} />
 
 ## Properties
 
-Properties are declared with `var`/`val`.
-They **must** declare their datatype.
+Properties are declared with `var`/`val` inside a block.
+They **must** explicitly declare their datatype.
 
 <Code thpcode={`
 class Person
@@ -42,11 +46,13 @@ class Person
 
     // This is correct
     val String name = "Jane Doe"
+
+    // This is also okay
+    String name = "Jane Doe"
 }
 `} />
 
-Properties are private by default,
-but can be made public with `pub`.
+**Properties are private by default**, but can be made public with `pub`.
 
 <Code thpcode={`
 class Person
@@ -57,10 +63,22 @@ class Person
     // To make a property public use \`pub\`
     pub var Int age = 30
 }
+
+val p = Person()
+print(p.name)    // Compile error: \`name\` is private
+print(p.age)     // 30
 `} />
 
-More information about how properties interact with the constructor
-is found in the contructor section.
+Unlike PHP, to access properties and methods use dot notation `.`
+instead of an arrow `->`.
+
+Static properties are explained in the Static page.
+
+Readonly properties are explained in the Readonly page.
+
+The interaction between properties and the constructor is explained
+in the Constructor page.
+
 
 
 ## Methods
@@ -77,7 +95,7 @@ class Person
 }
 `} />
 
-Methods are private by default, and are made public with `pub`.
+**Methods are private by default**, and are made public with `pub`.
 
 <Code thpcode={`
 class Person
@@ -100,10 +118,27 @@ p.greet()           //: Hello from greet
 p.private_greet()   // Compile time error. Private method.
 `} />
 
+[Unlike PHP](https://www.php.net/manual/en/language.oop5.basic.php#language.oop5.basic.properties-methods),
+in THP a method cannot have the same name as a property and viceversa.
+Doing so is a compile error.
+
+<Code thpcode={`
+class Person
+{
+    String name = "Rose"
+
+    // This is a compile error
+    fun name() -> String {
+        "Rose"
+    }
+}
+`} />
+
+
 ## This
 
-THP uses the dollar sign `$` as this. It is **required** when
-using a class property/method.
+THP uses the dollar sign `$` as this inside classes.
+It is **required** when using a class property/method.
 
 <Code thpcode={`
 class Person
@@ -123,126 +158,6 @@ class Person
 }
 `} />
 
-## Static members
-
-Static members are detailed in their own page.
-
-
-## Constructor
-
-(for now) THP's constructors are inspired by Kotlin.
-
-PHP only allows a single constructor, and so does THP.
-The basic constructor has the syntax of function parameters.
-
-<Code thpcode={`
-//          |this is the constructor |
-class Animal(String fullname, Int age)
-
-val a1 = Animal("Nal", 4)
-`} />
-
-The class properties can be declared in the constructor,
-using the keywords `pub`, `var`, `val`:
-
-<Code thpcode={`
-class Animal(
-    // Since we are using val/var, these are promoted to class properties
-    val String fullname,
-    var Int age,
-)
-{
-    pub fun say()
-    {
-        // Here we are using the properties declared in the constructor
-        print("My name is {$fullname} and i'm {$age} years old")
-    }
-}
-
-val a1 = Animal("Nal", 4)
-a1.say()    //: My name is Nal and i'm 4 years old
-`} />
-
-By using this syntax you are declaring properties and assigning them
-at the same time.
-
-The contructor parameters can also have default values.
-
-
-### Constructor visibility
-
-The constructor is public by default. It can be made private/protected
-like this:
-
-<Code thpcode={`
-class Animal
-private constructor(
-    val String fullname,
-    var Int age,
-)
-{...}
-`} />
-
-
-### Derived properties
-
-You can declare properties whose values depend on values
-on the constructor.
-
-<Code thpcode={`
-class Animal(
-    val String fullname,
-)
-{
-    // A property whose value depends on \`fullname\`
-    // This is executed after the contructor
-    pub val Int name_length = $fullname.length
-}
-
-val a2 = Animal("Doa")
-print(a2.name_length)   //: 3
-`} />
-
-
-### Init block
-
-If you need to additional logic in the constructor you can
-use a `init` block.
-
-<Code thpcode={`
-class Animal(
-    val String fullname,
-)
-{
-    init
-    {
-        print("{$fullname} in contruction...")
-    }
-}
-
-val a3 = Animal("Lola")     //: Lola in construction
-`} />
-
-
-## Inheritance
-
-
-<Code thpcode={`
-// Base class
-class Animal(var String name)
-{
-    pub fun say_name()
-    {
-        print($name)
-    }
-}
-
-// Child class
-class Cat(String name, Int lives) 
-extends Animal(name)
-
-Cat("Michi", 9).say_name()
-`} />
 
 ## Mutable methods
 
diff --git a/src/pages/learn/classes/inheritance.mdx b/src/pages/learn/classes/inheritance.mdx
new file mode 100644
index 0000000..2ccd484
--- /dev/null
+++ b/src/pages/learn/classes/inheritance.mdx
@@ -0,0 +1,26 @@
+---
+layout: ../../../layouts/DocsLayout.astro
+title: Inheritance
+---
+import Code from "../../../components/Code.astro"
+
+# Inheritance
+
+
+
+<Code thpcode={`
+// Base class
+class Animal(var String name)
+{
+    pub fun say_name()
+    {
+        print($name)
+    }
+}
+
+// Child class
+class Cat(String name, Int lives) 
+extends Animal(name)
+
+Cat("Michi", 9).say_name()
+`} />
diff --git a/src/pages/learn/classes/readonly.mdx b/src/pages/learn/classes/readonly.mdx
new file mode 100644
index 0000000..35c0536
--- /dev/null
+++ b/src/pages/learn/classes/readonly.mdx
@@ -0,0 +1,7 @@
+---
+layout: ../../../layouts/DocsLayout.astro
+title: Readonly
+---
+import Code from "../../../components/Code.astro"
+
+# Readonly
diff --git a/src/pages/learn/classes/visibility.mdx b/src/pages/learn/classes/visibility.mdx
new file mode 100644
index 0000000..8c5bce1
--- /dev/null
+++ b/src/pages/learn/classes/visibility.mdx
@@ -0,0 +1,7 @@
+---
+layout: ../../../layouts/DocsLayout.astro
+title: Visibility
+---
+import Code from "../../../components/Code.astro"
+
+# Visibility
diff --git a/src/pages/learn/index.mdx b/src/pages/learn/index.mdx
index 0097fcf..24821d4 100644
--- a/src/pages/learn/index.mdx
+++ b/src/pages/learn/index.mdx
@@ -44,7 +44,12 @@ pagesLayout:
   title: Classes
   children:
   - path: definition
+  - path: constructor
+  - path: inheritance
   - path: static
+  - path: visibility
+  - path: readonly
+  - path: abstract
   - path: interfaces
   - path: anonymous
   - path: magic
diff --git a/src/pages/learn/templating/control-flow.mdx b/src/pages/learn/templating/control-flow.mdx
index c5303a9..bff0474 100644
--- a/src/pages/learn/templating/control-flow.mdx
+++ b/src/pages/learn/templating/control-flow.mdx
@@ -7,3 +7,68 @@ import Info from "../../../components/docs/Info.astro"
 
 # Control flow
 
+## If expressions
+
+Use `@if`, `@else if` and `@else` to branch during the template
+creation.
+
+<Code thpcode={`
+fun User(User user) -> HTML
+{
+    <div>
+        @if user.verified
+        {
+            <p>Hello {user.name}</p>
+        }
+        @else
+        {
+            <p>Verify your account to continue</p>
+        }
+    </div>
+}
+`} />
+
+
+## Loops
+
+Use `@for`:
+
+<Code thpcode={`
+fun Users() -> HTML
+{
+    val users = User::get_all()
+
+    <div>
+        @for user in users
+        {
+            <User user={user} />
+        }
+    </div>
+}
+`} />
+
+
+## Match
+
+Use `@match` for pattern matching:
+
+<Code thpcode={`
+fun UserDetail(User user) -> HTML
+{
+    <div>
+        @match user.type
+        case ::Admin
+        {
+            <button>Delete resource</button>
+        }
+        case ::User
+        {
+            <button disable>Not allowed</button>
+        }
+    </div>
+}
+`} />
+
+
+
+