CORPORATION: Add documentation (bitburner-official#1121)

This ports the PDF manual by @catloversg into .md form, so it can be used in-game and via browsing on GitHub.

It also adds MathJax rendering to in-game docs, so that the math formulas can be rendered. (GitHub already supports this natively.)

jest.config.js

@@ -7,6 +7,7 @@ module.exports = {
   transformIgnorePatterns: ["node_modules/(?!react-markdown)/"],
   testPathIgnorePatterns: [".cypress", "node_modules", "dist"],
   testEnvironment: "./FixJSDOMEnvironment.ts",
+  setupFiles: ["./jest.polyfills.js"],
   moduleNameMapper: {
     "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$":
       "<rootDir>/test/__mocks__/fileMock.js",

jest.polyfills.js

@@ -0,0 +1,6 @@
+const { TextEncoder, TextDecoder } = require("node:util");
+
+Object.defineProperties(globalThis, {
+  TextEncoder: { value: TextEncoder },
+  TextDecoder: { value: TextDecoder },
+});

package.json

@@ -97,7 +97,9 @@
     "typescript": "^5.2.2",
     "webpack": "^5.88.2",
     "webpack-cli": "^5.1.4",
-    "webpack-dev-server": "^4.15.1"
+    "webpack-dev-server": "^4.15.1",
+    "remark-math": "^5.1.1",
+    "rehype-mathjax": "^4.0.3"
   },
   "engines": {
     "node": ">=14"

src/Documentation/doc/advanced/corporation/basic-gameplay-and-term.md

@@ -0,0 +1,44 @@
+# Basic gameplay – Terms
+
+## Basic gameplay
+
+There is a `corporation-management-handbook.lit` on your home server. Read it.
+
+Go to City Hall in Sector-12 and create a Corporation through the UI if you want. However, you really should do everything by scripting.
+
+You can use seed money when creating a corporation in BN3.
+
+There are multiple industries that you can expand into. In order to do that, you need to choose an industry and create a division. Agriculture is the best starting industry. Check this [section](./industry-supply-chain.md) for details.
+
+Each division can expand to 6 cities.
+
+Each industry has different input materials and output materials/products. For example: Agriculture needs Water and Chemicals to produce Plants and Food. The number next to each material is its "coefficient" (You can call it "weight" or "factor" if you want).
+
+$$0.5\ \textit{Water}+0.2\ \textit{Chemicals} \Rightarrow 1\ \textit{Plants}+1\ \textit{Food}$$
+
+There is no "offline progress" in corporation. When you go offline, the corporation accumulates bonus time.
+
+A corporation continuously transitions between 5 states: START → PURCHASE → PRODUCTION → EXPORT → SALE → START. The action occurs when the state is _entered_, i.e., when the state is PURCHASE, it means purchasing has just occurred. One cycle (going through one of these transitions) takes 10 seconds. If you have enough bonus time, it takes one second. Check this [section](./miscellany.md) for details.
+
+Each division has its "division product multiplier". This multiplier can be increased by buying [boost materials](./boost-material.md): AI Cores, Hardware, Real Estate, and Robots.
+
+You should look around to get familiar with the UI. One confusing thing for newbies is how to setup the "buy value" to buy materials. We have "Purchase" and "Bulk purchase":
+
+- Purchase: This is "buy per second" value. For example: In cycle 1, you enter "100", then in cycle 2, at PURCHASE state, you'll have 100\*10 units in your inventory. You can buy more than what your funds allows (and go into debt) with this option. Important note: when you have enough units that you want, you must press "Clear purchase", otherwise it'll buy forever until you run out of storage space.
+- Bulk purchase: You buy exactly what you want. Must pay upfront.
+
+If you want to buy something, write a script to do that. It's too error-prone to do it manually.
+
+When you hover your mouse over a warehouse, you'll see the space that those materials take up in the warehouse. They are _not_ the numbers of units.
+
+## Terms
+
+Smart Supply: Automatically buy optimal quantities of input material units.
+
+Export: Allow export/import materials between divisions.
+
+Wilson: Wilson Analytics upgrade.
+
+Market-TA2: Automatically set optimal prices for your output materials/products.
+
+RP: Research point.