feat: Overhaul of Message modes page (#74)

* fix: Remove warnings from `theme.config.jsx`

And clean-up it a bit. See: https://nextra.site/docs/docs-theme/theme-configuration#dark-mode-and-themes

* chore: Adding license field, CC BY 4.0

In accordance to the license used in tact-docs, and the valid SPDX license expression for it — CC-BY-4.0.

See:
* https://spdx.org/licenses/
* https://spdx.org/licenses/CC-BY-4.0.html
* https://creativecommons.org/licenses/by/4.0/

* feat: Overhaul of `Message modes` page

And couple of small warning fixes

Fix #58

Author: novusnota

Diff for: .gitignore

@@ -2,3 +2,4 @@
 node_modules
 out
 package-lock.json
+yarn-error.log

Diff for: package.json

@@ -17,5 +17,6 @@
   "devDependencies": {
     "@types/node": "^18.11.19",
     "typescript": "^4.9.5"
-  }
-}
+  },
+  "license": "CC-BY-4.0"
+}

Diff for: pages/language/guides/_meta.json

@@ -7,7 +7,8 @@
   "bounced": "Bounced Messages",
   "external": "External Messages",
   "lifecycle": "Message lifecycle",
-  "send": "Send messages",
+  "send": "Sending messages",
+  "message-mode": "Message mode",
   "deploy": "Deploy contracts",
   "debug": "Debugging",
   "upgrades": "Contract upgrades",

Diff for: pages/language/guides/message-mode.mdx

@@ -0,0 +1,49 @@
+import { Callout } from 'nextra/components'
+
+# Message `mode`
+
+As you might've noticed, messages are sent with the `mode` param of a struct `SendParameters`. It's an Int value, which is combined from base modes and optional flags, which are also Int values.
+
+It's possible to use raw Int values and manually provide them for the `mode`, but for your convenience there's a set of constants which you may use to construct the compound `mode` with ease. Take a look at the following tables for more information on base modes and optional flags.
+
+## Base modes
+
+Mode value | Constant name        | Description
+---------: | :------------------- | -----------------------------------------------------------------------------------------------------------------------
+$0$        | -                    | Ordinary message (default).
+$64$       | SendRemainingValue   | Carry all the remaining value of the inbound message in addition to the value initially indicated in the new message.
+$128$      | SendRemainingBalance | Carry all the remaining balance of the current smart contract instead of the value originally indicated in the message.
+
+## Optional flags
+
+Flag value | Constant name          | Description
+---------: | :--------------------- | ----------------------------------------------------------------------------------------------------------------------
+$+1$       | SendPayGasSeparately   | Pay forward fees separately from the message value.
+$+2$       | SendIgnoreErrors       | Ignore any errors arising while processing this message during the action phase.
+$+16$      | SendBounceIfActionFail | Bounce transaction in case of any errors during action phase. Has no effect if flag $+2$, SendIgnoreErrors is used.
+$+32$      | SendDestroyIfZero      | Current account must be destroyed if its resulting balance is zero (often used with mode $128$, SendRemainingBalance).
+
+## Combining modes with flags
+
+To make the Int value for `mode` field of SendParameters, you just have to combine base modes with optional flags by adding them together as numbers.
+
+For example, if you want to send a regular message and pay transfer fees separately, use the mode $0$ (default) and a flag $+1$ to get `mode` $= 1$, which is equal to just use SendPayGasSeparately constant.
+
+Alternatively, if you want to send the whole contract balance and destroy it immediately, use the mode $128$ and flag $+32$ to get `mode` $= 160$, which is equal to SendRemainingBalance + SendDestroyIfZero.
+
+Here's how the latter example would look in code:
+
+```tact
+let to: Address = ...;
+let value: Int = ton("1");
+send(SendParameters{
+    to: to,
+    value: value,
+    mode: SendRemainingBalance + SendDestroyIfZero,
+    body: "Hello, World!".asComment()
+});
+```
+
+<Callout>
+NOTE: There can be only one base mode, but number of optional flags may vary: you can use them all, none or just some.
+</Callout>

Diff for: pages/language/ref/_meta.json

@@ -4,6 +4,5 @@
 	"random": "Random",
 	"math": "Math",
 	"cells": "Cells, Builders and Slices",
-	"message-modes": "Message modes",
 	"advanced": "Advanced"
-}
+}

Diff for: pages/language/ref/message-modes.mdx

@@ -21,7 +21,9 @@ export default {
       <path fillRule="evenodd" clipRule="evenodd" d="M2.89671 31.4666L13.5452 19.7152L3.50521 15.7065L28.99 1.0932C26.5378 -2.74133e-09 23.0142 0 17 0C9.73879 0 6.10818 0 3.61017 1.92391C2.97777 2.41098 2.41098 2.97777 1.92391 3.61017C0 6.10818 0 9.73879 0 17C0 24.2612 0 27.8918 1.92391 30.3898C2.21981 30.774 2.54513 31.134 2.89671 31.4666ZM4.39128 32.5948C6.86599 34 10.4607 34 17 34C24.2612 34 27.8918 34 30.3898 32.0761C31.0222 31.589 31.589 31.0222 32.0761 30.3898C34 27.8918 34 24.2612 34 17C34 9.73879 34 6.10818 32.0761 3.61017C31.6542 3.06237 31.1725 2.56381 30.6401 2.12364L20.2292 13.6125L30.807 18.159L4.39128 32.5948Z" fill="currentColor" />
     </svg>
   ),
-  defaultTheme: 'dark',
+  nextThemes: {
+    defaultTheme: 'dark',
+  },
   project: {
     link: 'https://github.com/tact-lang/tact-docs',
   },
@@ -43,31 +45,15 @@ export default {
     <>
       <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 
-      <meta
-        name="description"
-        content="Tact Language Documentation"
-      />
+      <meta name="description" content="Tact Language Documentation" />
+
+      <meta name="og:title" content="Tact Language Documentation" />
+
+      <meta name="og:description" content="Language reference and guides for Tact" />
 
-      <meta
-        name="og:title"
-        content="Tact Language Documentation"
-      />
-      <meta
-        name="og:description"
-        content="Language reference and guides for Tact"
-      />
+      <meta name="twitter:card" content="summary_large_image" />
 
-      <meta 
-        name="twitter:card" 
-        content="summary_large_image" 
-      />
-      
-      <meta 
-        name="twitter:site" 
-        content="@tact_language
-      ">
-        
-      </meta>
+      <meta name="twitter:site" content="@tact_language" />
 
       <meta name="apple-mobile-web-app-title" content="Tact" />
 
@@ -86,4 +72,4 @@ export default {
       />;
     </>
   )
-}
+}