refactor(#285): Add zod

Also, this adds a surplus check so that jest sees that result.error is defined

This isn’t necessary for TS itself, but somehow ts-jest didn’t see this... upgrading to latest didn’t fix this bug unfortunately, so this is as good as it gets

packages/kotti-ui/package.json

@@ -19,7 +19,8 @@
 		"normalize.css": "^8.0.1",
 		"tippy.js": "6.x",
 		"ts-custom-error": "^3.1.1",
-		"vue-clickaway": "^2.2.2"
+		"vue-clickaway": "^2.2.2",
+		"zod": "^3.8.2"
 	},
 	"description": "Kotti Vue Component UI",
 	"devDependencies": {

packages/kotti-ui/source/props.ts

@@ -0,0 +1,54 @@
+import { cloneDeep } from 'lodash'
+import { z } from 'zod'
+
+/**
+ * Easily validate vue props, improve error messages drastically
+ *
+ * This augments/replaces Vue’s prop.validator approach by using zod and therefore actually
+ * prints errors to the console that can actually help developers rather than just say
+ * "hey you failed the validator, good luck!" as vue would do by default.
+ *
+ * @example
+ * sections: {
+ * 	required: true,
+ * 	type: Array,
+ * 	validator: propValidator(KottiUserMenu.propsInternalSchema, 'sections'),
+ * }
+ */
+export const propValidator = <
+	SCHEMA extends z.ZodObject<z.ZodRawShape>,
+	KEY extends keyof z.infer<SCHEMA>,
+>(
+	schema: SCHEMA,
+	key: KEY,
+) => {
+	const validator = (value: unknown) => {
+		const result = schema.pick({ [key]: true }).safeParse({ [key]: value })
+
+		if (result.success) return true
+
+		/* eslint-disable no-console */
+		console.group(`propValidator found issues with prop “${key}”`)
+
+		// HACK: 'error' in result is necessary as `ts-jest` doesn’t see that result.success was already properly checked to be falsy and that error now exists
+		if ('error' in result) console.error(result.error)
+
+		if (Array.isArray(value)) console.table(cloneDeep(value))
+		else console.log(cloneDeep(value))
+
+		console.trace()
+
+		console.groupEnd()
+		/* eslint-enable no-console */
+
+		return false
+	}
+
+	// assign name for better debugging and to improve props rendering in the documentation
+	Object.defineProperty(validator, 'name', {
+		value: `propValidator('${key}')`,
+		writable: false,
+	})
+
+	return validator
+}