feat(core basepattern): Add a destroy method.

The destroy method removes the pattern instance from the element.
This is necessary to re-initialize the same pattern on the same element.

Author: thet

src/core/basepattern.js

@@ -8,7 +8,7 @@
  */
 import logging from "./logging";
 
-const log = logging.getLogger("Patternslib Base");
+const log = logging.getLogger("basepattern");
 
 class BasePattern {
     static name; // name of pattern used in Registry.
@@ -84,6 +84,13 @@ class BasePattern {
             once: true,
         });
     }
+
+    /**
+     * Destroy/remove/unload the pattern from the element.
+     */
+    destroy() {
+        delete this.el[`pattern-${this.name}`];
+    }
 }
 
 export default BasePattern;

src/core/basepattern.test.js

@@ -117,7 +117,7 @@ describe("Basepattern class tests", function () {
         expect(pat3 instanceof Pat2).toBeTruthy();
     });
 
-    it("4 - The pattern instance is stored on the element itself.", async function () {
+    it("4.1 - The pattern instance is stored on the element itself.", async function () {
         class Pat extends BasePattern {
             static name = "example";
         }
@@ -129,6 +129,44 @@ describe("Basepattern class tests", function () {
         expect(el["pattern-example"]).toBe(pat);
     });
 
+    it("4.2 - The same pattern cannot be instantiated on the same element twice.", async function () {
+        class Pat extends BasePattern {
+            static name = "example";
+        }
+
+        const el = document.createElement("div");
+        const pat = new Pat(el);
+        await utils.timeout(1);
+
+        expect(el["pattern-example"]).toBe(pat);
+
+        const pat2 = new Pat(el);
+        await utils.timeout(1);
+
+        expect(el["pattern-example"]).toBe(pat);
+        expect(el["pattern-example"]).not.toBe(pat2);
+    });
+
+    it("4.3 - The same pattern can be instantiated on the same element again, after the first was destroyed.", async function () {
+        class Pat extends BasePattern {
+            static name = "example";
+        }
+
+        const el = document.createElement("div");
+        const pat = new Pat(el);
+        await utils.timeout(1);
+
+        expect(el["pattern-example"]).toBe(pat);
+
+        pat.destroy();
+
+        const pat2 = new Pat(el);
+        await utils.timeout(1);
+
+        expect(el["pattern-example"]).not.toBe(pat);
+        expect(el["pattern-example"]).toBe(pat2);
+    });
+
     it("5 - Registers with the registry.", async function () {
         class Pat extends BasePattern {
             static name = "example";