Types

Type annotations are optional.

const var age: Int = 28!

By the way, strings are just arrays of characters.

String == Char[]!

Similarly, integers are just arrays of digits.

Int == Digit[]!

If you want to use a binary representation for integers, Int9 and Int99 types are also available.

const var age: Int9 = 28!

People love talking about Zero-Cost Abstractions, but what about these? Includes use and type annotations; for an additional runtime cost, get syntactic "sugar" - come up with a funny synonym for "sugar"

variable = "hello there since the variable thing returns a cloned Pointer, reassignment doesn't propagate up to the actual state. I don't know how to do this without either rewriting a bunch of code or breaking stuff

Signals

To use a signal, use use.

const var score = use(0)!

When it comes to signals, the most important thing to discuss is syntax.

In DreamBerd, you can set (and get) signals with just one function:

const var score = use(0)!

score(9)! // Set the value
score()?  // Get the value (and print it)

Alternatively, you can be more explicit with your signal syntax, by splitting it into a getter and setter.

const var [getScore, setScore] = use(0)!

setScore(9)! // Set the value
getScore()?  // Get the value (and print it)

Technical info: This is pure syntax sugar. The split signal functions are exactly the same as before.

const var [getScore, setScore] = use(0)!

getScore(9)! // Set the value
setScore()?  // Get the value (and print it)

This means that you can carry on splitting as much as you like.

const var [[[getScore, setScore], setScore], setScore] = use(0)!

condition ~? is_true ~; isnt_true ~: is_maybe

condition ~? is_true ~; is_false!
condition ~? is_true ~~ is_maybe!
condition ~; is_false ~~ is_maybe!

condition ???
    :: if_true
    ::: if_false
    :::: if_maybe

Asynchronous Functions

Asynchronous functions synchronise with each other. They take turns running lines of code.

async funct count() {
   print(2)!
   print(4)!
}

count()!
print(1)!
print(3)!
print(5)!

You can use the noop keyword to wait for longer before taking your turn.

async func count() {
   print(2)!
   noop!
   print(5)!
}

count()!
print(1)!
print(3)!
print(4)!

Note: In the program above, the computer interprets noop as a string and its sole purpose is to take up an extra line. You can use any string you want.

DBX

You can embed DBX in DreamBerd. It's just DreamBerd, and it's also just HTML.

funct App() => {
   return <div>Hello world!</div>
}

Warning: As you know, class is already a keyword in DreamBerd, so you can't use it within DBX.

funct App() => {
   // This is not ok
   return <div class="greeting">Hello world!</div>
}

className is also a DreamBerd keyword, so you can't use that either.

funct App() => {
   // This is also not ok
   return <div className="greeting">Hello world!</div>
}

Instead, you can use the htmlClassName attribute.

funct App() => {
   // This is fine
   return <div htmlClassName="greeting">Hello world!</div>
}

Please note: Unlike JSX, you are free to freely use the for attribute - because DreamBerd doesn't have loops.

funct App() => {
   return (
      <label for="name">Name</label>
      <input id="name" />
   )
}

Classes

You can make classes, but you can only ever make one instance of them. This shouldn't affect how most object-oriented programmers work.

class Player {
   const var health = 10!
}

const var player1 = new Player()!
const var player2 = new Player()! //Error: Can't have more than one 'Player' instance!

This is how you could do this:

class PlayerMaker {
   function makePlayer() => {
      class Player {
         const var health = 10!
      }
      const const player = new Player()!
      return player!
   }
}

const const playerMaker = new PlayerMaker()!
const var player1 = playerMaker.makePlayer()!
const var player2 = playerMaker.makePlayer()!

Class Names

For maximum compatibility with other languages, you can alternatively use the className keyword when making classes.

This makes things less complicated.

className Player {
   const var health = 10!
}

In response to some recent criticism about this design decision, we would like to remind you that this is part of the JavaScript specification, and therefore - out of our control.

File Structure

Write five or more equals signs to start a new file. This removes the need for multiple files or any build process.

const const score = 5!
print(score)! //5

=====================

const const score = 3!
print(score)! //3

New for 2022!
Thanks to recent advances in technology, you can now give files names.

======= add.db =======
function add(a, b) => {
   return a + b!
}

Exporting

Many languages allow you to import things from specific files. In DreamBerd, importing is simpler. Instead, you export to specific files!

===== add.db ==
function add(a, b) => {
   return a + b!
}

export add to "main.db"!

===== main.db ==
import add!
add(3, 2)!