Merge pull request #142 from px-d/main

Add Typescript Category & first initial snippet.

public/consolidated/_index.json

@@ -38,5 +38,9 @@
     {
         "lang": "SCSS",
         "icon": "/icons/scss.svg"
+    },
+    {
+        "lang": "TYPESCRIPT",
+        "icon": "/icons/typescript.svg"
     }
 ]

public/consolidated/typescript.json

@@ -0,0 +1,19 @@
+[
+    {
+        "categoryName": "Helper Types",
+        "snippets": [
+            {
+                "title": "Exclusive Types",
+                "description": "Allows to have a type which conforms to either/or.",
+                "author": "px-d",
+                "tags": [
+                    "typescript",
+                    "helper-types",
+                    "typedefinition"
+                ],
+                "contributors": [],
+                "code": "type Exclusive<T, U = T> = T | U extends Record<string, unknown>\n  ?\n      | ({ [P in Exclude<keyof T, keyof U>]?: never } & U)\n      | ({ [P in Exclude<keyof U, keyof T>]?: never } & T)\n  : T | U;\n\n\n// Usage:\ntype A = { name: string; email?: string; provider?: string };\ntype B = { name: string; phone?: string; country?: string };\n\ntype EitherOr = Exclusive<A, B>;\n\nconst w: EitherOr = { name: \"John\", email: \"[email protected]\" }; // ✅\nconst x: EitherOr = { name: \"John\", phone: \"+123 456\" }; // ✅\nconst y: EitherOr = { name: \"John\", email: \"\", phone: \"\" }; // ⛔️\nconst z: EitherOr = { name: \"John\", phne: \"\", provider: \"\" }; // ⛔️\n"
+            }
+        ]
+    }
+]

snippets/typescript/helper-types/exclusive-types.md

@@ -0,0 +1,26 @@
+---
+title: Exclusive Types
+description: Allows to have a type which conforms to either/or.
+author: px-d
+tags: typescript,helper-types,typedefinition
+---
+
+```ts
+type Exclusive<T, U = T> = T | U extends Record<string, unknown>
+  ?
+      | ({ [P in Exclude<keyof T, keyof U>]?: never } & U)
+      | ({ [P in Exclude<keyof U, keyof T>]?: never } & T)
+  : T | U;
+
+
+// Usage:
+type A = { name: string; email?: string; provider?: string };
+type B = { name: string; phone?: string; country?: string };
+
+type EitherOr = Exclusive<A, B>;
+
+const w: EitherOr = { name: "John", email: "[email protected]" }; // ✅
+const x: EitherOr = { name: "John", phone: "+123 456" }; // ✅
+const y: EitherOr = { name: "John", email: "", phone: "" }; // ⛔️
+const z: EitherOr = { name: "John", phne: "", provider: "" }; // ⛔️
+```