feat: add Type Modifiers > Prickly Predicates appetizer (#280)

Author: JoshuaKGoldberg

dictionary.txt

@@ -30,6 +30,7 @@ bibendum
 bienvenidos
 blandit
 brewerton
+Cactaceae
 chuckie
 clownsole
 commodo
@@ -44,6 +45,7 @@ cum
 curabitur
 cursus
 Ðâåà
+dadgum
 dapibus
 dbccbd
 diam
@@ -71,6 +73,7 @@ et
 etiam
 eu
 euismod
+Euphorbiaceae
 facilisi
 facilisis
 fames
@@ -106,6 +109,7 @@ krusty
 labore
 lacinia
 lacus
+Lamiaceae
 laoreet
 lawyerings
 lectus

projects/type-modifiers/prickly-predicates/01-pruning-pests/README.md

@@ -0,0 +1,24 @@
+# Step 1: Pruning Pests
+
+Thanks for signing on to the farm, friend!
+That's mighty kind of you.
+We sure do appreciate it.
+
+What we'll need from you first is help narrowing down the names of our fruits.
+We know what we grow, but these darn type systems don't.
+Can you help us out with a function to return whether a string is a known crop name?
+
+## Specification
+
+Export a type predicate function named `isCropName` that takes in a name of type `string`.
+It should return whether the data is one of the keys of the type of the existing `cropFamilies` object.
+
+## Files
+
+- `index.ts`: Write your `isCropName` function here
+- `index.test.ts`: Tests verifying `isCropName`
+- `solution.ts`: Solution code
+
+## Notes
+
+- The function's return type should be an explicit type predicate with the `is` keyword

projects/type-modifiers/prickly-predicates/01-pruning-pests/index.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it, test } from "@jest/globals";
+import { expectType } from "tsd";
+
+import * as index from "./index";
+import * as solution from "./solution";
+
+const { isCropName } = process.env.TEST_SOLUTIONS
+	? solution
+	: (index as typeof solution);
+
+describe(isCropName, () => {
+	describe("types", () => {
+		test("function type", () => {
+			expectType<(name: string) => name is keyof typeof solution.cropFamilies>(
+				isCropName
+			);
+		});
+	});
+
+	it.each([
+		["", false],
+		["dandelion", false],
+		["purslane", false],
+		["cactus", true],
+		["cassava", true],
+		["chia", true],
+	])("when given %j, returns %j", (input, expected) => {
+		expect(isCropName(input)).toBe(expected);
+	});
+});

projects/type-modifiers/prickly-predicates/01-pruning-pests/index.ts

@@ -0,0 +1,8 @@
+export const cropFamilies = {
+	cactus: "Cactaceae",
+	cassava: "Euphorbiaceae",
+	chia: "Lamiaceae",
+};
+
+// Write your isCropName function here! ✨
+// You'll need to export it so the tests can run it.

projects/type-modifiers/prickly-predicates/01-pruning-pests/solution.ts

@@ -0,0 +1,9 @@
+export const cropFamilies = {
+	cactus: "Cactaceae",
+	cassava: "Euphorbiaceae",
+	chia: "Lamiaceae",
+};
+
+export function isCropName(name: string): name is keyof typeof cropFamilies {
+	return name in cropFamilies;
+}

projects/type-modifiers/prickly-predicates/01-pruning-pests/tsconfig.json

@@ -0,0 +1,4 @@
+{
+	"extends": "../../../../tsconfig.json",
+	"include": ["."]
+}

projects/type-modifiers/prickly-predicates/02-plant-particulars/README.md

@@ -0,0 +1,37 @@
+# Step 2: Plant Particulars
+
+Well, I'll be darned!
+You blew through that first step faster than a dog chasing a roadrunner.
+Hee-yah!
+
+Our second request of you is to deal with is weeding.
+We're sick and tired of these invasive weeds in our dadgum farm!
+They're just about as welcome as a rattlesnake at a square dance.
+
+Can you help us write a function that filters data to just a known crop we want to grow?
+That'd be mighty useful in helping us skedaddle out those worrisome weeds.
+
+## Specification
+
+Export a type predicate function named `isAnyCrop` that takes in data of type `unknown`.
+It should return whether the data is an object that matches the existing `AnyCrop` interface.
+
+> Tip: when a value is type `object`, TypeScript won't allow you to access a property unless you check first that the property's key is `in` the value:
+>
+> ```ts
+> function checkValue(value: unknown) {
+> 	if (!!value && typeof value === "object" && "key" in value) {
+> 		console.log(value.key);
+> 	}
+> }
+> ```
+
+## Files
+
+- `index.ts`: Write your `isAnyCrop` function here
+- `index.test.ts`: Tests verifying `isAnyCrop`
+- `solution.ts`: Solution code
+
+## Notes
+
+- The function's return type should be an explicit type predicate with the `is` keyword

projects/type-modifiers/prickly-predicates/02-plant-particulars/index.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it, test } from "@jest/globals";
+import { expectType } from "tsd";
+
+import * as index from "./index";
+import * as solution from "./solution";
+
+const { isAnyCrop } = process.env.TEST_SOLUTIONS
+	? solution
+	: (index as typeof solution);
+
+describe(isAnyCrop, () => {
+	describe("types", () => {
+		test("function type", () => {
+			expectType<(data: solution.AnyCrop) => data is solution.AnyCrop>(
+				isAnyCrop
+			);
+		});
+	});
+
+	it.each([
+		[null, false],
+		[undefined, false],
+		["", false],
+		[123, false],
+		[[], false],
+		[{}, false],
+		[{ growth: null }, false],
+		[{ growth: 123 }, false],
+		[{ harvested: true }, false],
+		[{ name: "cactus" }, false],
+		[{ growth: null, harvested: true, name: "cactus" }, false],
+		[{ growth: 5, harvested: null, name: "cactus" }, false],
+		[{ growth: 5, harvested: true, name: null }, false],
+		[{ growth: 5, harvested: true, name: "other" }, false],
+		[{ growth: 5, harvested: true, name: "cactus" }, true],
+		[{ growth: 5, harvested: true, name: "cassava" }, true],
+		[{ growth: 5, harvested: true, name: "chia" }, true],
+	])("when given %j, returns %j", (input, expected) => {
+		expect(isAnyCrop(input)).toBe(expected);
+	});
+});

projects/type-modifiers/prickly-predicates/02-plant-particulars/index.ts

@@ -0,0 +1,8 @@
+export interface AnyCrop {
+	growth: number;
+	harvested: boolean;
+	name: "cactus" | "cassava" | "chia";
+}
+
+// Write your isAnyCrop function here! ✨
+// You'll need to export it so the tests can run it.

projects/type-modifiers/prickly-predicates/02-plant-particulars/solution.ts

@@ -0,0 +1,19 @@
+export interface AnyCrop {
+	growth: number;
+	harvested: boolean;
+	name: "cactus" | "cassava" | "chia";
+}
+
+export function isAnyCrop(data: unknown): data is AnyCrop {
+	return (
+		!!data &&
+		typeof data === "object" &&
+		"growth" in data &&
+		typeof data.growth === "number" &&
+		"harvested" in data &&
+		typeof data.harvested === "boolean" &&
+		"name" in data &&
+		typeof data.name === "string" &&
+		["cactus", "cassava", "chia"].includes(data.name)
+	);
+}