feat(curriculum): add type safe math toolkit workshop to typescript module (freeCodeCamp#66073)

Co-authored-by: Kolade <chrisjay967@gmail.com>
Co-authored-by: Kolade Chris <65571316+Ksound22@users.noreply.github.com>

Author: jdwilkin4

client/i18n/locales/english/intro.json

@@ -6187,6 +6187,12 @@
           "In this workshop, you will practice working with type annotations, array types, object types and more by building out a user profile."
         ]
       },
+      "workshop-type-safe-math-toolkit": {
+        "title": "Build a Type Safe Math Toolkit",
+        "intro": [
+          "In this workshop, you will practice typing functions by building a math toolkit project."
+        ]
+      },
       "lecture-understanding-type-composition": {
         "title": "Understanding Type Composition",
         "intro": [

curriculum/challenges/english/blocks/workshop-type-safe-math-toolkit/699f1d72e906e4616155290d.md

@@ -0,0 +1,53 @@
+---
+id: 699f1d72e906e4616155290d
+title: Step 1
+challengeType: 1
+dashedName: step-1
+---
+
+# --description--
+
+In this workshop, you will continue to learn about type annotations and how they work with functions by building out a type safe math toolkit.
+
+Start by creating a function called `square` that accepts a parameter and returns the square of a number.
+
+# --hints--
+
+You should have a function called `square`.
+
+```js
+const explorer = await __helpers.Explorer(code);
+assert.exists(explorer.allFunctions.square);
+```
+
+Your `square` function should have one parameter.
+
+```js
+const explorer = await __helpers.Explorer(code);
+assert.lengthOf(explorer.allFunctions.square.parameters, 1);
+```
+
+Your `square` function should return the square of a number.
+
+```js
+assert.strictEqual(square(2), 4);
+assert.strictEqual(square(3), 9);
+```
+
+# --seed--
+
+## --seed-contents--
+
+```ts
+--fcc-editable-region--
+
+--fcc-editable-region--
+```
+
+```json
+{
+  "compilerOptions": {
+    "noCheck": true
+  }
+}
+```

curriculum/challenges/english/blocks/workshop-type-safe-math-toolkit/699f3738921fb79a651ded56.md

@@ -0,0 +1,69 @@
+---
+id: 699f3738921fb79a651ded56
+title: Step 2
+challengeType: 1
+dashedName: step-2
+---
+
+# --description--
+
+Now it is time to call your function. 
+
+Create a variable called `result` and assign it the function call of `square` with an argument of `5`.
+
+Below that, log the value of `result` to the console.
+
+# --before-each--
+
+```js
+const spy = __helpers.spyOn(console, 'log');
+const getLogs = () => spy.calls.map(call => call?.[0]);
+```
+
+# --hints--
+
+You should have a variable called `result`.
+
+```js
+assert.isDefined(result);
+```
+
+Your `result` variable should be a number.
+
+```js
+assert.isNumber(result);
+```
+
+Your `result` variable should be the square of `5`.
+
+```js
+assert.strictEqual(result, 25);
+```
+
+You should log the `result` variable to the console.
+
+```js
+assert.equal(getLogs()[0], result);
+```
+
+# --seed--
+
+## --seed-contents--
+
+```ts
+function square(num) {
+  return num * num;
+}
+
+--fcc-editable-region--
+
+--fcc-editable-region--
+```
+
+```json
+{
+  "compilerOptions": {
+    "noCheck": true
+  }
+}
+```

curriculum/challenges/english/blocks/workshop-type-safe-math-toolkit/699f38937b053e4679878ff1.md

@@ -0,0 +1,47 @@
+---
+id: 699f38937b053e4679878ff1
+title: Step 3
+challengeType: 1
+dashedName: step-3
+---
+
+# --description--
+
+When working with vanilla JavaScript, there is nothing to prevent you from calling the `square` function with a string or an array, which would lead to unexpected results.
+
+To illustrate this, change your function call to use the string `"something"` instead of the number `5`.
+
+In the next lesson, you will learn how to use TypeScript to add type safety to your code and prevent these kinds of errors.
+
+# --hints--
+
+Your `square` function call should have an argument of `"something"`.
+
+```js
+const explorer = await __helpers.Explorer(code);
+assert.isTrue(explorer.variables.result.value.matches("square('something')"));
+```
+
+# --seed--
+
+## --seed-contents--
+
+```ts
+function square(num) {
+  return num * num;
+}
+
+--fcc-editable-region--
+const result = square(5);
+--fcc-editable-region--
+
+console.log(result);
+```
+
+```json
+{
+  "compilerOptions": {
+    "noCheck": true
+  }
+}
+```

curriculum/challenges/english/blocks/workshop-type-safe-math-toolkit/699f3cb8d057f29954205d7d.md

@@ -0,0 +1,74 @@
+---
+id: 699f3cb8d057f29954205d7d
+title: Step 4
+challengeType: 1
+dashedName: step-4
+---
+
+# --description--
+
+As you recall from earlier lessons, you can add type annotations to function parameters like this:
+
+```ts
+function add(num1: number, num2: number) {
+  return num1 + num2;
+}
+```
+
+In this example, TypeScript will display an error if you try to call the `add` function with arguments that are not numbers.
+
+Update your `square` function to include a type annotation for the `num` parameter. The type should be `number`.
+
+# --hints--
+
+You should add a type annotation to the `num` parameter in the `square` function. The type should be a `number`.
+
+```js
+const explorer = await __helpers.Explorer(code);
+const { parameters } = explorer.allFunctions.square;
+assert.isTrue(parameters[0].matches("num: number"));
+```
+
+# --seed--
+
+## --seed-contents--
+
+```ts
+--fcc-editable-region--
+function square(num) {
+  return num * num;
+}
+
+--fcc-editable-region--
+const result = square("something");
+
+console.log(result);
+```
+
+```json
+{
+  "compilerOptions": {
+    "noCheck": true
+  }
+}
+```
+
+# --solutions--
+
+```ts
+function square(num: number) {
+  return num * num;
+}
+
+const result = square("something");
+
+console.log(result);
+```
+
+```json
+{
+  "compilerOptions": {
+    "noCheck": true
+  }
+}
+```

curriculum/challenges/english/blocks/workshop-type-safe-math-toolkit/699f3f636aa840b7201aa37c.md

@@ -0,0 +1,43 @@
+---
+id: 699f3f636aa840b7201aa37c
+title: Step 5
+challengeType: 1
+dashedName: step-5
+---
+
+# --description--
+
+If you open up the console, you should see the following TypeScript error message:
+
+```md
+Argument of type 'string' is not assignable to parameter of type 'number'
+```
+
+Now that the parameter is explicitly typed as a number, TypeScript is able to catch the error of trying to pass a string argument to the `square` function. 
+
+Change the argument passed to the `square` function to the number `5` to fix the error and see the correct output in the console.
+
+# --hints--
+
+Your `square` function call should have an argument of `5` instead of `"something"`.
+
+```js
+assert.strictEqual(result, 25);
+```
+
+# --seed--
+
+## --seed-contents--
+
+```ts
+function square(num: number) {
+  return num * num;
+}
+
+--fcc-editable-region--
+const result = square("something");
+--fcc-editable-region--
+
+console.log(result);
+```
+

curriculum/challenges/english/blocks/workshop-type-safe-math-toolkit/699f412114c87221f16a99e3.md

@@ -0,0 +1,66 @@
+---
+id: 699f412114c87221f16a99e3
+title: Step 6
+challengeType: 1
+dashedName: step-6
+---
+
+# --description--
+
+Another benefit of using TypeScript is that it will catch errors if you pass to many or to few arguments to a function call.
+
+To illustrate this, update your `square` function call to take two arguments of `5` and `10`.
+
+# --hints--
+
+Your `square` function call should have two arguments of `5` and `10`.
+
+```js
+const explorer = await __helpers.Explorer(code);
+const { result } = explorer.variables;
+assert.isTrue(result.value.matches("square(5, 10)"));
+```
+
+# --seed--
+
+## --seed-contents--
+
+```ts
+function square(num: number) {
+  return num * num;
+}
+
+--fcc-editable-region--
+const result = square(5);
+--fcc-editable-region--
+
+console.log(result);
+```
+
+```json
+{
+  "compilerOptions": {
+    "noCheck": true
+  }
+}
+```
+
+# --solutions--
+
+```ts
+function square(num: number) {
+  return num * num;
+}
+
+const result = square(5, 10);
+
+console.log(result);
+```
+
+```json
+{
+  "compilerOptions": {
+    "noCheck": true
+  }
+}
+```