@magnit-ce/code-tests 0.0.11 → 0.0.13

package/dist/code-tests.cjs

@@ -20,13 +20,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/code-tests.ts
 var code_tests_exports = {};
 __export(code_tests_exports, {
-  AFTERALL: () => AFTERALL,
-  AFTEREACH: () => AFTEREACH,
-  BEFOREALL: () => BEFOREALL,
-  BEFOREEACH: () => BEFOREEACH,
   CodeTestEventType: () => CodeTestEventType,
   CodeTests: () => CodeTests,
   CodeTestsElement: () => CodeTestsElement,
+  HookType: () => HookType,
   expect: () => expect,
   prompt: () => prompt
 });
@@ -163,11 +160,25 @@ var code_tests_default = `:host
     display: none;
 }
 :host(.has-before-hook) #before-all-details
-,:host(.has-before-hook) #after-all-details
+,:host(.has-after-hook) #after-all-details
+{
+    display: initial;
+}
+:host(.has-required-before-hook) #required-before-any-details
+,:host(.has-required-after-hook) #required-after-any-details
 {
     display: initial;
 }
 
+#required-before-any-summary
+,#required-after-any-summary
+{
+    background: var(--surface-process);
+    color: var(--text-process);
+    border: solid 1px var(--text-process);
+    grid-template-columns: auto auto 1fr;
+}
+
 #tests
 {
     margin: 0;
@@ -431,7 +442,7 @@ pre
 }`;
 
 // src/code-tests.html?raw
-var code_tests_default2 = '<slot name="header">\n    <header id="header">\n        <span id="title"><slot name="title"><span id="title-text">Tests</span></slot></span>\n        <slot name="play-button">\n            <button type="button" class="run" data-all>\n                <slot name="play-button-label">\n                    <span id="play-button-label" class="button-label label icon">Run Tests</span>\n                </slot>\n            </button>\n        </slot>\n        <slot name="details"></slot>\n    </header>\n</slot>\n<details id="before-all-details" class="hook">\n    <summary id="before-all-summary">\n        <span id="before-all-result-icon" class="result-icon"></span>\n        <span id="before-all-description" class="description">Results from Before All Hook</span>\n    </summary>\n    <div id="before-all-results" class="results"></div>\n</details>\n<ul id="tests"></ul>\n<details id="after-all-details" class="hook">\n    <summary id="after-all-summary">\n        <span id="after-all-result-icon" class="result-icon"></span>\n        <span id="after-all-description" class="description">Results from After All Hook</span>\n    </summary>\n    <div id="after-all-results" class="results"></div>\n</details>\n\n<template id="prompt-template">\n    <div class="prompt" part="prompt">\n        <div class="prompt-display">\n            <span class="icon prompt-icon"></span>\n            <span class="label prompt-label"></span>\n        </div>\n        <div class="prompt-actions">\n            <button class="prompt-button accept" type="button">Accept</button>\n            <button class="prompt-button reject" type="button">Reject</button>\n        </div>\n    </div>\n</template>';
+var code_tests_default2 = '<slot name="header">\n    <header id="header">\n        <span id="title"><slot name="title"><span id="title-text">Tests</span></slot></span>\n        <slot name="play-button">\n            <button type="button" class="run" data-all>\n                <slot name="play-button-label">\n                    <span id="play-button-label" class="button-label label icon">Run Tests</span>\n                </slot>\n            </button>\n        </slot>\n        <slot name="details"></slot>\n    </header>\n</slot>\n<details id="required-before-any-details" class="hook">\n    <summary id="required-before-any-summary">\n        <span id="required-before-any-result-icon" class="result-icon"></span>\n        <span id="required-before-any-description" class="description">Results from Required Before Any Hook</span>\n    </summary>\n    <div id="required-before-any-results" class="results"></div>\n</details>\n<details id="before-all-details" class="hook">\n    <summary id="before-all-summary">\n        <span id="before-all-result-icon" class="result-icon"></span>\n        <span id="before-all-description" class="description">Results from Before All Hook</span>\n    </summary>\n    <div id="before-all-results" class="results"></div>\n</details>\n<ul id="tests"></ul>\n<details id="after-all-details" class="hook">\n    <summary id="after-all-summary">\n        <span id="after-all-result-icon" class="result-icon"></span>\n        <span id="after-all-description" class="description">Results from After All Hook</span>\n    </summary>\n    <div id="after-all-results" class="results"></div>\n</details>\n<details id="required-after-any-details" class="hook">\n    <summary id="required-after-any-summary">\n        <span id="required-after-any-result-icon" class="result-icon"></span>\n        <span id="required-after-any-description" class="description">Results from Required After Any Hook</span>\n    </summary>\n    <div id="required-after-any-results" class="results"></div>\n</details>\n\n<template id="prompt-template">\n    <div class="prompt" part="prompt">\n        <div class="prompt-display">\n            <span class="icon prompt-icon"></span>\n            <span class="label prompt-label"></span>\n        </div>\n        <div class="prompt-actions">\n            <button class="prompt-button accept" type="button">Accept</button>\n            <button class="prompt-button reject" type="button">Reject</button>\n        </div>\n    </div>\n</template>';
 
 // src/api.ts
 var TestPromise = class extends Promise {
@@ -463,10 +474,6 @@ var TestPromise = class extends Promise {
     }
   }
 };
-var BEFOREALL = Symbol("beforeAll");
-var BEFOREEACH = Symbol("beforeEach");
-var AFTERALL = Symbol("afterAll");
-var AFTEREACH = Symbol("afterEach");
 var CodeTests = class _CodeTests {
   static timeoutMS = 500;
   static #expectInterval;
@@ -574,6 +581,15 @@ function assignClassAndIdToPart(shadowRoot) {
 }
 
 // src/code-tests.ts
+var HookType = /* @__PURE__ */ ((HookType2) => {
+  HookType2["BeforeAll"] = "beforeall";
+  HookType2["AfterAll"] = "afterall";
+  HookType2["BeforeEach"] = "beforeeach";
+  HookType2["AfterEach"] = "aftereach";
+  HookType2["RequiredBeforeAny"] = "requiredbeforeany";
+  HookType2["RequiredAfterAny"] = "requiredafterany";
+  return HookType2;
+})(HookType || {});
 var CodeTestEventType = /* @__PURE__ */ ((CodeTestEventType2) => {
   CodeTestEventType2["BeforeAll"] = "beforeall";
   CodeTestEventType2["AfterAll"] = "afterall";
@@ -600,13 +616,7 @@ var CodeTestsElement = class extends HTMLElement {
   findElement(id) {
     return this.shadowRoot.getElementById(id);
   }
-  #hooks = /* @__PURE__ */ new Map();
-  #hookIds = {
-    [BEFOREALL]: generateId(),
-    [BEFOREEACH]: generateId(),
-    [AFTEREACH]: generateId(),
-    [AFTERALL]: generateId()
-  };
+  #hooks = {};
   #continueRunningTests = true;
   constructor() {
     super();
@@ -621,7 +631,7 @@ var CodeTestsElement = class extends HTMLElement {
     if (this.getAttribute("auto") == "false") {
       return;
     }
-    const testsPath = this.getAttribute("src") ?? this.getAttribute("test") ?? this.getAttribute("tests") ?? this.getAttribute("run") ?? this.getAttribute("path");
+    const testsPath = this.#getCurrentTestsPath();
     if (testsPath == null) {
       return;
     }
@@ -691,82 +701,44 @@ var CodeTestsElement = class extends HTMLElement {
       if (tests == void 0) {
         throw new Error(`Unable to find tests definition in file at path: ${path}`);
       }
-      const beforeAll = tests[BEFOREALL];
+      const beforeAll = tests["beforeall" /* BeforeAll */];
       if (beforeAll != null) {
-        const hookMap = this.#hooks.get(BEFOREALL);
-        if (hookMap == null) {
-          const map = /* @__PURE__ */ new Map();
-          map.set(beforeAll, /* @__PURE__ */ new Set());
-          this.#hooks.set(BEFOREALL, map);
-        }
+        this.#hooks["beforeall" /* BeforeAll */] = beforeAll;
+        delete tests["beforeall" /* BeforeAll */];
         this.classList.add("has-before-hook");
       }
-      const beforeEach = tests[BEFOREEACH];
-      if (beforeEach != null) {
-        const hookMap = this.#hooks.get(BEFOREEACH);
-        if (hookMap == null) {
-          const map = /* @__PURE__ */ new Map();
-          map.set(beforeEach, /* @__PURE__ */ new Set());
-          this.#hooks.set(BEFOREEACH, map);
-        }
-      }
-      const afterAll = tests[AFTERALL];
+      const afterAll = tests["afterall" /* AfterAll */];
       if (afterAll != null) {
-        const hookMap = this.#hooks.get(AFTERALL);
-        if (hookMap == null) {
-          const map = /* @__PURE__ */ new Map();
-          map.set(afterAll, /* @__PURE__ */ new Set());
-          this.#hooks.set(AFTERALL, map);
-        }
+        this.#hooks["afterall" /* AfterAll */] = afterAll;
+        delete tests["afterall" /* AfterAll */];
         this.classList.add("has-after-hook");
       }
-      const afterEach = tests[AFTEREACH];
+      const beforeEach = tests["beforeeach" /* BeforeEach */];
+      if (beforeEach != null) {
+        this.#hooks["beforeeach" /* BeforeEach */] = beforeEach;
+        delete tests["beforeeach" /* BeforeEach */];
+      }
+      const afterEach = tests["aftereach" /* AfterEach */];
       if (afterEach != null) {
-        const hookMap = this.#hooks.get(AFTEREACH);
-        if (hookMap == null) {
-          const map = /* @__PURE__ */ new Map();
-          map.set(afterEach, /* @__PURE__ */ new Set());
-          this.#hooks.set(AFTEREACH, map);
-        }
+        this.#hooks["aftereach" /* AfterEach */] = afterEach;
+        delete tests["aftereach" /* AfterEach */];
+      }
+      const requiredBeforeAny = tests["requiredbeforeany" /* RequiredBeforeAny */];
+      if (requiredBeforeAny != null) {
+        this.#hooks["requiredbeforeany" /* RequiredBeforeAny */] = requiredBeforeAny;
+        delete tests["requiredbeforeany" /* RequiredBeforeAny */];
+        this.classList.add("has-required-before-hook");
+        this.part.add("has-required-before-hook");
+      }
+      const requiredAfterAny = tests["requiredafterany" /* RequiredAfterAny */];
+      if (requiredAfterAny != null) {
+        this.#hooks["requiredafterany" /* RequiredAfterAny */] = requiredAfterAny;
+        delete tests["requiredafterany" /* RequiredAfterAny */];
+        this.classList.add("has-required-after-hook");
+        this.part.add("has-required-after-hook");
       }
       for (const [description, test] of Object.entries(tests)) {
-        const id = this.#addTest(description, test);
-        if (beforeAll != null) {
-          const hookMap = this.#hooks.get(BEFOREALL);
-          if (hookMap != null) {
-            const testIds = hookMap.get(beforeAll);
-            if (testIds != null) {
-              testIds.add(id);
-            }
-          }
-        }
-        if (beforeEach != null) {
-          const hookMap = this.#hooks.get(BEFOREEACH);
-          if (hookMap != null) {
-            const testIds = hookMap.get(beforeEach);
-            if (testIds != null) {
-              testIds.add(id);
-            }
-          }
-        }
-        if (afterAll != null) {
-          const hookMap = this.#hooks.get(AFTERALL);
-          if (hookMap != null) {
-            const testIds = hookMap.get(afterAll);
-            if (testIds != null) {
-              testIds.add(id);
-            }
-          }
-        }
-        if (afterEach != null) {
-          const hookMap = this.#hooks.get(AFTEREACH);
-          if (hookMap != null) {
-            const testIds = hookMap.get(afterEach);
-            if (testIds != null) {
-              testIds.add(id);
-            }
-          }
-        }
+        this.#addTest(description, test);
       }
     } catch (error) {
       this.#addProcessError("An error occurred while loading the tasks:", error);
@@ -793,24 +765,49 @@ var CodeTestsElement = class extends HTMLElement {
     }
     this.#clearTestStatuses();
     const inOrder = this.hasAttribute("in-order");
-    const beforeHooks = this.#hooks.get(BEFOREALL);
-    if (beforeHooks != null) {
+    const requiredBeforeHook = this.#hooks["requiredbeforeany" /* RequiredBeforeAny */];
+    if (requiredBeforeHook != null) {
+      let hookResult;
+      try {
+        const requiredBeforeAnyHookElement = this.getElement(`required-before-any-details`);
+        requiredBeforeAnyHookElement.classList.add("running");
+        requiredBeforeAnyHookElement.part.add("running");
+        if (this.isCanceled == true) {
+          throw new Error("Test has been cancelled");
+        }
+        hookResult = await requiredBeforeHook(this, requiredBeforeAnyHookElement);
+        this.#handleHookResult(hookResult, true, "before", true);
+        requiredBeforeAnyHookElement.part.remove("running");
+        requiredBeforeAnyHookElement.classList.remove("running");
+      } catch (error) {
+        this.#handleHookResult(hookResult, false, "before", true, error);
+        console.error(error);
+        this.#continueRunningTests = false;
+        this.classList.remove("running");
+        this.part.remove("running");
+        if (playButtonLabel != null) {
+          playButtonLabel.textContent = "Run Tests";
+        }
+        this.dispatchEvent(new CustomEvent("afterall" /* AfterAll */, { bubbles: true, composed: true }));
+        return;
+      }
+    }
+    const beforeHook = this.#hooks["beforeall" /* BeforeAll */];
+    if (beforeHook != null) {
       let hookResult;
       try {
         const beforeAllHookElement = this.getElement(`before-all-details`);
         beforeAllHookElement.classList.add("running");
         beforeAllHookElement.part.add("running");
-        for (const [hook, ids] of beforeHooks) {
-          if (this.isCanceled == true) {
-            throw new Error("Test has been cancelled");
-          }
-          hookResult = await hook(this, beforeAllHookElement);
-          this.#handleHookResult(hookResult, true, "before");
+        if (this.isCanceled == true) {
+          throw new Error("Test has been cancelled");
         }
+        hookResult = await beforeHook(this, beforeAllHookElement);
+        this.#handleHookResult(hookResult, true, "before", false);
         beforeAllHookElement.part.remove("running");
         beforeAllHookElement.classList.remove("running");
       } catch (error) {
-        this.#handleHookResult(hookResult, false, "before", error);
+        this.#handleHookResult(hookResult, false, "before", false, error);
         console.error(error);
         this.#continueRunningTests = false;
         this.classList.remove("running");
@@ -833,7 +830,7 @@ var CodeTestsElement = class extends HTMLElement {
         if (this.#continueRunningTests == false) {
           break;
         }
-        await this.#runTest(id, test);
+        await this.#runTest(id, test, false);
       }
     }
     if (this.#continueRunningTests == false) {
@@ -845,25 +842,42 @@ var CodeTestsElement = class extends HTMLElement {
       this.dispatchEvent(new CustomEvent("afterall" /* AfterAll */, { bubbles: true, composed: true }));
       return;
     }
-    const afterHooks = this.#hooks.get(AFTERALL);
-    if (afterHooks != null) {
+    const afterHook = this.#hooks["afterall" /* AfterAll */];
+    if (afterHook != null) {
       let hookResult;
       try {
         const afterAllHookElement = this.getElement(`after-all-details`);
         afterAllHookElement.classList.add("running");
         afterAllHookElement.part.add("running");
-        for (const [hook, ids] of afterHooks) {
-          if (this.isCanceled == true) {
-            throw new Error("Test has been cancelled");
-          }
-          hookResult = await hook(this, afterAllHookElement);
-          this.#handleHookResult(hookResult, true, "after");
+        if (this.isCanceled == true) {
+          throw new Error("Test has been cancelled");
         }
+        hookResult = await afterHook(this, afterAllHookElement);
+        this.#handleHookResult(hookResult, true, "after", false);
         afterAllHookElement.part.remove("running");
         afterAllHookElement.classList.remove("running");
       } catch (error) {
-        this.#handleHookResult(hookResult, false, "after", error);
+        this.#handleHookResult(hookResult, false, "after", false, error);
         console.error(error);
+        const requiredAfterHook2 = this.#hooks["requiredafterany" /* RequiredAfterAny */];
+        if (requiredAfterHook2 != null) {
+          let hookResult2;
+          try {
+            const requiredAfterAnyHookElement = this.getElement(`required-after-any-details`);
+            requiredAfterAnyHookElement.classList.add("running");
+            requiredAfterAnyHookElement.part.add("running");
+            if (this.isCanceled == true) {
+              throw new Error("Test has been cancelled");
+            }
+            hookResult2 = await requiredAfterHook2(this, requiredAfterAnyHookElement);
+            this.#handleHookResult(hookResult2, true, "after", true);
+            requiredAfterAnyHookElement.part.remove("running");
+            requiredAfterAnyHookElement.classList.remove("running");
+          } catch (error2) {
+            this.#handleHookResult(hookResult2, false, "after", true, error2);
+            console.error(error2);
+          }
+        }
         this.#continueRunningTests = false;
         this.classList.remove("running");
         this.part.remove("running");
@@ -874,6 +888,26 @@ var CodeTestsElement = class extends HTMLElement {
         return;
       }
     }
+    const requiredAfterHook = this.#hooks["requiredafterany" /* RequiredAfterAny */];
+    if (requiredAfterHook != null) {
+      let hookResult;
+      try {
+        const requiredAfterAnyHookElement = this.getElement(`required-after-any-details`);
+        requiredAfterAnyHookElement.classList.add("running");
+        requiredAfterAnyHookElement.part.add("running");
+        if (this.isCanceled == true) {
+          throw new Error("Test has been cancelled");
+        }
+        hookResult = await requiredAfterHook(this, requiredAfterAnyHookElement);
+        this.#handleHookResult(hookResult, true, "after", true);
+        requiredAfterAnyHookElement.part.remove("running");
+        requiredAfterAnyHookElement.classList.remove("running");
+      } catch (error) {
+        this.#handleHookResult(hookResult, false, "after", true, error);
+        console.error(error);
+        this.#continueRunningTests = false;
+      }
+    }
     const failedTests = this.shadowRoot.querySelectorAll('[success="false"]');
     this.setAttribute("success", failedTests.length == 0 ? "true" : "false");
     this.classList.remove("running");
@@ -903,7 +937,7 @@ var CodeTestsElement = class extends HTMLElement {
     afterAllHookElement.classList.remove("success", "fail");
     afterAllHookElement.part.remove("success", "fail");
   }
-  async #runTest(testId, test) {
+  async #runTest(testId, test, handleRequiredTests = true) {
     const testElement = this.getElement("tests").querySelector(`[data-test-id="${testId}"]`);
     if (testElement == null) {
       this.#addProcessError(`Unable to find test element for test: ${testId}`);
@@ -933,17 +967,38 @@ var CodeTestsElement = class extends HTMLElement {
     let testType;
     try {
       const allowTest = this.dispatchEvent(new CustomEvent("beforetest" /* BeforeTest */, { bubbles: true, cancelable: true, composed: true, detail: { testElement } }));
+      if (handleRequiredTests == true) {
+        const requiredBeforeHook = this.#hooks["requiredbeforeany" /* RequiredBeforeAny */];
+        if (requiredBeforeHook != null) {
+          let hookResult;
+          try {
+            const requiredBeforeAnyHookElement = this.getElement(`required-before-any-details`);
+            requiredBeforeAnyHookElement.classList.add("running");
+            requiredBeforeAnyHookElement.part.add("running");
+            if (this.isCanceled == true) {
+              throw new Error("Test has been cancelled");
+            }
+            hookResult = await requiredBeforeHook(this, requiredBeforeAnyHookElement);
+            this.#handleHookResult(hookResult, true, "before", true);
+            requiredBeforeAnyHookElement.part.remove("running");
+            requiredBeforeAnyHookElement.classList.remove("running");
+          } catch (error) {
+            this.#handleHookResult(hookResult, true, "before", true, error);
+            console.error(error);
+            this.#continueRunningTests = false;
+            return;
+          }
+        }
+      }
+      if (this.#continueRunningTests == false) {
+        throw new Error("Tests have been disabled from continuing to run.");
+      }
       if (allowTest == false || this.isCanceled == true) {
         throw new Error("Test has been cancelled");
       }
-      const beforeHooks = this.#hooks.get(BEFOREEACH);
-      if (beforeHooks != null) {
-        for (const [hook, ids] of beforeHooks) {
-          if (ids.has(testId)) {
-            beforeResult = await hook(this, testElement);
-            break;
-          }
-        }
+      const beforeHook = this.#hooks["beforeeach" /* BeforeEach */];
+      if (beforeHook != null) {
+        beforeResult = await beforeHook(this, testElement);
       }
       if (this.isCanceled == true) {
         throw new Error("Test has been cancelled");
@@ -952,12 +1007,30 @@ var CodeTestsElement = class extends HTMLElement {
       if (this.isCanceled == true) {
         throw new Error("Test has been cancelled");
       }
-      const afterHooks = this.#hooks.get(AFTEREACH);
-      if (afterHooks != null) {
-        for (const [hook, ids] of afterHooks) {
-          if (ids.has(testId)) {
-            afterResult = await hook(this, testElement);
-            break;
+      const afterHook = this.#hooks["aftereach" /* AfterEach */];
+      if (afterHook != null) {
+        afterResult = await afterHook(this, testElement);
+      }
+      if (handleRequiredTests == true) {
+        const requiredAfterHook = this.#hooks["requiredafterany" /* RequiredAfterAny */];
+        if (requiredAfterHook != null) {
+          let hookResult;
+          try {
+            const requiredBeforeAnyHookElement = this.getElement(`required-before-any-details`);
+            requiredBeforeAnyHookElement.classList.add("running");
+            requiredBeforeAnyHookElement.part.add("running");
+            if (this.isCanceled == true) {
+              throw new Error("Test has been cancelled");
+            }
+            hookResult = await requiredAfterHook(this, requiredBeforeAnyHookElement);
+            this.#handleHookResult(hookResult, true, "after", true);
+            requiredBeforeAnyHookElement.part.remove("running");
+            requiredBeforeAnyHookElement.classList.remove("running");
+          } catch (error) {
+            this.#handleHookResult(hookResult, true, "after", true, error);
+            console.error(error);
+            this.#continueRunningTests = false;
+            return;
           }
         }
       }
@@ -1015,19 +1088,19 @@ Result:${objectResult.value}`,
       detailsElement.open = true;
     }
   }
-  #handleHookResult(result, finishedTest, beforeOrAfter, error) {
+  #handleHookResult(result, finishedTest, beforeOrAfter, required, error) {
     if (result instanceof HTMLElement) {
-      this.#setHookResult(result, finishedTest, beforeOrAfter);
+      this.#setHookResult(result, finishedTest, beforeOrAfter, required);
     } else {
       let defaultResult;
       if (result == void 0) {
         defaultResult = this.#createDefaultResult(finishedTest == true ? "Hook Ran Successfully" : `Failed${error != null ? `:
 ${error.message}` : ""}`, finishedTest);
-        this.#setHookResult(defaultResult, finishedTest, beforeOrAfter);
+        this.#setHookResult(defaultResult, finishedTest, beforeOrAfter, required);
       } else if (typeof result == "string") {
         defaultResult = this.#createDefaultResult(`${result}${error == null ? "" : `:
 ${error.message}`}`, finishedTest);
-        this.#setHookResult(defaultResult, finishedTest, beforeOrAfter);
+        this.#setHookResult(defaultResult, finishedTest, beforeOrAfter, required);
       } else if (typeof result == "object") {
         const objectResult = result;
         if (objectResult.success != void 0 && objectResult.expected != void 0 && objectResult.value != void 0) {
@@ -1037,7 +1110,7 @@ Expected:${objectResult.expected}
 Result:${objectResult.value}`,
             objectResult.success
           );
-          this.#setHookResult(defaultResult, finishedTest, beforeOrAfter);
+          this.#setHookResult(defaultResult, finishedTest, beforeOrAfter, required);
         }
       }
     }
@@ -1130,9 +1203,10 @@ Result:${objectResult.value}`,
     codeElement.appendChild(preElement);
     return codeElement;
   }
-  #setHookResult(valueElement, success, beforeOrAfter) {
-    const detailsElement = this.getElement(`${beforeOrAfter}-all-details`);
-    const resultsElement = this.getElement(`${beforeOrAfter}-all-results`);
+  #setHookResult(valueElement, success, beforeOrAfter, required) {
+    const selector = required == true ? `required-${beforeOrAfter}-any` : `${beforeOrAfter}-all`;
+    const detailsElement = this.getElement(`${selector}-details`);
+    const resultsElement = this.getElement(`${selector}-results`);
     detailsElement.setAttribute("success", success == true ? "true" : "false");
     detailsElement.classList.toggle("success", success);
     detailsElement.part.toggle("success", success);
@@ -1213,13 +1287,10 @@ if (customElements.get(COMPONENT_TAG_NAME) == null) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AFTERALL,
-  AFTEREACH,
-  BEFOREALL,
-  BEFOREEACH,
   CodeTestEventType,
   CodeTests,
   CodeTestsElement,
+  HookType,
   expect,
   prompt
 });

package/dist/code-tests.d.cts

@@ -4,10 +4,6 @@ declare class TestPromise<T> extends Promise<T> {
     toContainText(value: string): Promise<void>;
     toHaveAttribute(value: string): Promise<void>;
 }
-declare const BEFOREALL: unique symbol;
-declare const BEFOREEACH: unique symbol;
-declare const AFTERALL: unique symbol;
-declare const AFTEREACH: unique symbol;
 declare class CodeTests {
     #private;
     static timeoutMS: number;
@@ -27,6 +23,14 @@ type PromptOptions = {
 declare function prompt(host: CodeTestsElement, parent: HTMLElement, message: string, options?: PromptOptions): Promise<boolean>;
 
 type CodeTestsProperties = {};
+declare enum HookType {
+    BeforeAll = "beforeall",
+    AfterAll = "afterall",
+    BeforeEach = "beforeeach",
+    AfterEach = "aftereach",
+    RequiredBeforeAny = "requiredbeforeany",
+    RequiredAfterAny = "requiredafterany"
+}
 declare enum CodeTestEventType {
     BeforeAll = "beforeall",
     AfterAll = "afterall",
@@ -51,4 +55,4 @@ declare class CodeTestsElement extends HTMLElement {
     attributeChangedCallback(attributeName: string, oldValue: string, newValue: string): void;
 }
 
-export { AFTERALL, AFTEREACH, BEFOREALL, BEFOREEACH, CodeTestEventType, CodeTests, CodeTestsElement, type CodeTestsProperties, expect, prompt };
+export { CodeTestEventType, CodeTests, CodeTestsElement, type CodeTestsProperties, HookType, expect, prompt };

package/dist/code-tests.d.ts

@@ -4,10 +4,6 @@ declare class TestPromise<T> extends Promise<T> {
     toContainText(value: string): Promise<void>;
     toHaveAttribute(value: string): Promise<void>;
 }
-declare const BEFOREALL: unique symbol;
-declare const BEFOREEACH: unique symbol;
-declare const AFTERALL: unique symbol;
-declare const AFTEREACH: unique symbol;
 declare class CodeTests {
     #private;
     static timeoutMS: number;
@@ -27,6 +23,14 @@ type PromptOptions = {
 declare function prompt(host: CodeTestsElement, parent: HTMLElement, message: string, options?: PromptOptions): Promise<boolean>;
 
 type CodeTestsProperties = {};
+declare enum HookType {
+    BeforeAll = "beforeall",
+    AfterAll = "afterall",
+    BeforeEach = "beforeeach",
+    AfterEach = "aftereach",
+    RequiredBeforeAny = "requiredbeforeany",
+    RequiredAfterAny = "requiredafterany"
+}
 declare enum CodeTestEventType {
     BeforeAll = "beforeall",
     AfterAll = "afterall",
@@ -51,4 +55,4 @@ declare class CodeTestsElement extends HTMLElement {
     attributeChangedCallback(attributeName: string, oldValue: string, newValue: string): void;
 }
 
-export { AFTERALL, AFTEREACH, BEFOREALL, BEFOREEACH, CodeTestEventType, CodeTests, CodeTestsElement, type CodeTestsProperties, expect, prompt };
+export { CodeTestEventType, CodeTests, CodeTestsElement, type CodeTestsProperties, HookType, expect, prompt };

package/dist/code-tests.js

@@ -129,11 +129,25 @@ var code_tests_default = `:host
     display: none;
 }
 :host(.has-before-hook) #before-all-details
-,:host(.has-before-hook) #after-all-details
+,:host(.has-after-hook) #after-all-details
+{
+    display: initial;
+}
+:host(.has-required-before-hook) #required-before-any-details
+,:host(.has-required-after-hook) #required-after-any-details
 {
     display: initial;
 }
 
+#required-before-any-summary
+,#required-after-any-summary
+{
+    background: var(--surface-process);
+    color: var(--text-process);
+    border: solid 1px var(--text-process);
+    grid-template-columns: auto auto 1fr;
+}
+
 #tests
 {
     margin: 0;
@@ -397,7 +411,7 @@ pre
 }`;
 
 // src/code-tests.html?raw
-var code_tests_default2 = '<slot name="header">\n    <header id="header">\n        <span id="title"><slot name="title"><span id="title-text">Tests</span></slot></span>\n        <slot name="play-button">\n            <button type="button" class="run" data-all>\n                <slot name="play-button-label">\n                    <span id="play-button-label" class="button-label label icon">Run Tests</span>\n                </slot>\n            </button>\n        </slot>\n        <slot name="details"></slot>\n    </header>\n</slot>\n<details id="before-all-details" class="hook">\n    <summary id="before-all-summary">\n        <span id="before-all-result-icon" class="result-icon"></span>\n        <span id="before-all-description" class="description">Results from Before All Hook</span>\n    </summary>\n    <div id="before-all-results" class="results"></div>\n</details>\n<ul id="tests"></ul>\n<details id="after-all-details" class="hook">\n    <summary id="after-all-summary">\n        <span id="after-all-result-icon" class="result-icon"></span>\n        <span id="after-all-description" class="description">Results from After All Hook</span>\n    </summary>\n    <div id="after-all-results" class="results"></div>\n</details>\n\n<template id="prompt-template">\n    <div class="prompt" part="prompt">\n        <div class="prompt-display">\n            <span class="icon prompt-icon"></span>\n            <span class="label prompt-label"></span>\n        </div>\n        <div class="prompt-actions">\n            <button class="prompt-button accept" type="button">Accept</button>\n            <button class="prompt-button reject" type="button">Reject</button>\n        </div>\n    </div>\n</template>';
+var code_tests_default2 = '<slot name="header">\n    <header id="header">\n        <span id="title"><slot name="title"><span id="title-text">Tests</span></slot></span>\n        <slot name="play-button">\n            <button type="button" class="run" data-all>\n                <slot name="play-button-label">\n                    <span id="play-button-label" class="button-label label icon">Run Tests</span>\n                </slot>\n            </button>\n        </slot>\n        <slot name="details"></slot>\n    </header>\n</slot>\n<details id="required-before-any-details" class="hook">\n    <summary id="required-before-any-summary">\n        <span id="required-before-any-result-icon" class="result-icon"></span>\n        <span id="required-before-any-description" class="description">Results from Required Before Any Hook</span>\n    </summary>\n    <div id="required-before-any-results" class="results"></div>\n</details>\n<details id="before-all-details" class="hook">\n    <summary id="before-all-summary">\n        <span id="before-all-result-icon" class="result-icon"></span>\n        <span id="before-all-description" class="description">Results from Before All Hook</span>\n    </summary>\n    <div id="before-all-results" class="results"></div>\n</details>\n<ul id="tests"></ul>\n<details id="after-all-details" class="hook">\n    <summary id="after-all-summary">\n        <span id="after-all-result-icon" class="result-icon"></span>\n        <span id="after-all-description" class="description">Results from After All Hook</span>\n    </summary>\n    <div id="after-all-results" class="results"></div>\n</details>\n<details id="required-after-any-details" class="hook">\n    <summary id="required-after-any-summary">\n        <span id="required-after-any-result-icon" class="result-icon"></span>\n        <span id="required-after-any-description" class="description">Results from Required After Any Hook</span>\n    </summary>\n    <div id="required-after-any-results" class="results"></div>\n</details>\n\n<template id="prompt-template">\n    <div class="prompt" part="prompt">\n        <div class="prompt-display">\n            <span class="icon prompt-icon"></span>\n            <span class="label prompt-label"></span>\n        </div>\n        <div class="prompt-actions">\n            <button class="prompt-button accept" type="button">Accept</button>\n            <button class="prompt-button reject" type="button">Reject</button>\n        </div>\n    </div>\n</template>';
 
 // src/api.ts
 var TestPromise = class extends Promise {
@@ -429,10 +443,6 @@ var TestPromise = class extends Promise {
     }
   }
 };
-var BEFOREALL = Symbol("beforeAll");
-var BEFOREEACH = Symbol("beforeEach");
-var AFTERALL = Symbol("afterAll");
-var AFTEREACH = Symbol("afterEach");
 var CodeTests = class _CodeTests {
   static timeoutMS = 500;
   static #expectInterval;
@@ -540,6 +550,15 @@ function assignClassAndIdToPart(shadowRoot) {
 }
 
 // src/code-tests.ts
+var HookType = /* @__PURE__ */ ((HookType2) => {
+  HookType2["BeforeAll"] = "beforeall";
+  HookType2["AfterAll"] = "afterall";
+  HookType2["BeforeEach"] = "beforeeach";
+  HookType2["AfterEach"] = "aftereach";
+  HookType2["RequiredBeforeAny"] = "requiredbeforeany";
+  HookType2["RequiredAfterAny"] = "requiredafterany";
+  return HookType2;
+})(HookType || {});
 var CodeTestEventType = /* @__PURE__ */ ((CodeTestEventType2) => {
   CodeTestEventType2["BeforeAll"] = "beforeall";
   CodeTestEventType2["AfterAll"] = "afterall";
@@ -566,13 +585,7 @@ var CodeTestsElement = class extends HTMLElement {
   findElement(id) {
     return this.shadowRoot.getElementById(id);
   }
-  #hooks = /* @__PURE__ */ new Map();
-  #hookIds = {
-    [BEFOREALL]: generateId(),
-    [BEFOREEACH]: generateId(),
-    [AFTEREACH]: generateId(),
-    [AFTERALL]: generateId()
-  };
+  #hooks = {};
   #continueRunningTests = true;
   constructor() {
     super();
@@ -587,7 +600,7 @@ var CodeTestsElement = class extends HTMLElement {
     if (this.getAttribute("auto") == "false") {
       return;
     }
-    const testsPath = this.getAttribute("src") ?? this.getAttribute("test") ?? this.getAttribute("tests") ?? this.getAttribute("run") ?? this.getAttribute("path");
+    const testsPath = this.#getCurrentTestsPath();
     if (testsPath == null) {
       return;
     }
@@ -657,82 +670,44 @@ var CodeTestsElement = class extends HTMLElement {
       if (tests == void 0) {
         throw new Error(`Unable to find tests definition in file at path: ${path}`);
       }
-      const beforeAll = tests[BEFOREALL];
+      const beforeAll = tests["beforeall" /* BeforeAll */];
       if (beforeAll != null) {
-        const hookMap = this.#hooks.get(BEFOREALL);
-        if (hookMap == null) {
-          const map = /* @__PURE__ */ new Map();
-          map.set(beforeAll, /* @__PURE__ */ new Set());
-          this.#hooks.set(BEFOREALL, map);
-        }
+        this.#hooks["beforeall" /* BeforeAll */] = beforeAll;
+        delete tests["beforeall" /* BeforeAll */];
         this.classList.add("has-before-hook");
       }
-      const beforeEach = tests[BEFOREEACH];
-      if (beforeEach != null) {
-        const hookMap = this.#hooks.get(BEFOREEACH);
-        if (hookMap == null) {
-          const map = /* @__PURE__ */ new Map();
-          map.set(beforeEach, /* @__PURE__ */ new Set());
-          this.#hooks.set(BEFOREEACH, map);
-        }
-      }
-      const afterAll = tests[AFTERALL];
+      const afterAll = tests["afterall" /* AfterAll */];
       if (afterAll != null) {
-        const hookMap = this.#hooks.get(AFTERALL);
-        if (hookMap == null) {
-          const map = /* @__PURE__ */ new Map();
-          map.set(afterAll, /* @__PURE__ */ new Set());
-          this.#hooks.set(AFTERALL, map);
-        }
+        this.#hooks["afterall" /* AfterAll */] = afterAll;
+        delete tests["afterall" /* AfterAll */];
         this.classList.add("has-after-hook");
       }
-      const afterEach = tests[AFTEREACH];
+      const beforeEach = tests["beforeeach" /* BeforeEach */];
+      if (beforeEach != null) {
+        this.#hooks["beforeeach" /* BeforeEach */] = beforeEach;
+        delete tests["beforeeach" /* BeforeEach */];
+      }
+      const afterEach = tests["aftereach" /* AfterEach */];
       if (afterEach != null) {
-        const hookMap = this.#hooks.get(AFTEREACH);
-        if (hookMap == null) {
-          const map = /* @__PURE__ */ new Map();
-          map.set(afterEach, /* @__PURE__ */ new Set());
-          this.#hooks.set(AFTEREACH, map);
-        }
+        this.#hooks["aftereach" /* AfterEach */] = afterEach;
+        delete tests["aftereach" /* AfterEach */];
+      }
+      const requiredBeforeAny = tests["requiredbeforeany" /* RequiredBeforeAny */];
+      if (requiredBeforeAny != null) {
+        this.#hooks["requiredbeforeany" /* RequiredBeforeAny */] = requiredBeforeAny;
+        delete tests["requiredbeforeany" /* RequiredBeforeAny */];
+        this.classList.add("has-required-before-hook");
+        this.part.add("has-required-before-hook");
+      }
+      const requiredAfterAny = tests["requiredafterany" /* RequiredAfterAny */];
+      if (requiredAfterAny != null) {
+        this.#hooks["requiredafterany" /* RequiredAfterAny */] = requiredAfterAny;
+        delete tests["requiredafterany" /* RequiredAfterAny */];
+        this.classList.add("has-required-after-hook");
+        this.part.add("has-required-after-hook");
       }
       for (const [description, test] of Object.entries(tests)) {
-        const id = this.#addTest(description, test);
-        if (beforeAll != null) {
-          const hookMap = this.#hooks.get(BEFOREALL);
-          if (hookMap != null) {
-            const testIds = hookMap.get(beforeAll);
-            if (testIds != null) {
-              testIds.add(id);
-            }
-          }
-        }
-        if (beforeEach != null) {
-          const hookMap = this.#hooks.get(BEFOREEACH);
-          if (hookMap != null) {
-            const testIds = hookMap.get(beforeEach);
-            if (testIds != null) {
-              testIds.add(id);
-            }
-          }
-        }
-        if (afterAll != null) {
-          const hookMap = this.#hooks.get(AFTERALL);
-          if (hookMap != null) {
-            const testIds = hookMap.get(afterAll);
-            if (testIds != null) {
-              testIds.add(id);
-            }
-          }
-        }
-        if (afterEach != null) {
-          const hookMap = this.#hooks.get(AFTEREACH);
-          if (hookMap != null) {
-            const testIds = hookMap.get(afterEach);
-            if (testIds != null) {
-              testIds.add(id);
-            }
-          }
-        }
+        this.#addTest(description, test);
       }
     } catch (error) {
       this.#addProcessError("An error occurred while loading the tasks:", error);
@@ -759,24 +734,49 @@ var CodeTestsElement = class extends HTMLElement {
     }
     this.#clearTestStatuses();
     const inOrder = this.hasAttribute("in-order");
-    const beforeHooks = this.#hooks.get(BEFOREALL);
-    if (beforeHooks != null) {
+    const requiredBeforeHook = this.#hooks["requiredbeforeany" /* RequiredBeforeAny */];
+    if (requiredBeforeHook != null) {
+      let hookResult;
+      try {
+        const requiredBeforeAnyHookElement = this.getElement(`required-before-any-details`);
+        requiredBeforeAnyHookElement.classList.add("running");
+        requiredBeforeAnyHookElement.part.add("running");
+        if (this.isCanceled == true) {
+          throw new Error("Test has been cancelled");
+        }
+        hookResult = await requiredBeforeHook(this, requiredBeforeAnyHookElement);
+        this.#handleHookResult(hookResult, true, "before", true);
+        requiredBeforeAnyHookElement.part.remove("running");
+        requiredBeforeAnyHookElement.classList.remove("running");
+      } catch (error) {
+        this.#handleHookResult(hookResult, false, "before", true, error);
+        console.error(error);
+        this.#continueRunningTests = false;
+        this.classList.remove("running");
+        this.part.remove("running");
+        if (playButtonLabel != null) {
+          playButtonLabel.textContent = "Run Tests";
+        }
+        this.dispatchEvent(new CustomEvent("afterall" /* AfterAll */, { bubbles: true, composed: true }));
+        return;
+      }
+    }
+    const beforeHook = this.#hooks["beforeall" /* BeforeAll */];
+    if (beforeHook != null) {
       let hookResult;
       try {
         const beforeAllHookElement = this.getElement(`before-all-details`);
         beforeAllHookElement.classList.add("running");
         beforeAllHookElement.part.add("running");
-        for (const [hook, ids] of beforeHooks) {
-          if (this.isCanceled == true) {
-            throw new Error("Test has been cancelled");
-          }
-          hookResult = await hook(this, beforeAllHookElement);
-          this.#handleHookResult(hookResult, true, "before");
+        if (this.isCanceled == true) {
+          throw new Error("Test has been cancelled");
         }
+        hookResult = await beforeHook(this, beforeAllHookElement);
+        this.#handleHookResult(hookResult, true, "before", false);
         beforeAllHookElement.part.remove("running");
         beforeAllHookElement.classList.remove("running");
       } catch (error) {
-        this.#handleHookResult(hookResult, false, "before", error);
+        this.#handleHookResult(hookResult, false, "before", false, error);
         console.error(error);
         this.#continueRunningTests = false;
         this.classList.remove("running");
@@ -799,7 +799,7 @@ var CodeTestsElement = class extends HTMLElement {
         if (this.#continueRunningTests == false) {
           break;
         }
-        await this.#runTest(id, test);
+        await this.#runTest(id, test, false);
       }
     }
     if (this.#continueRunningTests == false) {
@@ -811,25 +811,42 @@ var CodeTestsElement = class extends HTMLElement {
       this.dispatchEvent(new CustomEvent("afterall" /* AfterAll */, { bubbles: true, composed: true }));
       return;
     }
-    const afterHooks = this.#hooks.get(AFTERALL);
-    if (afterHooks != null) {
+    const afterHook = this.#hooks["afterall" /* AfterAll */];
+    if (afterHook != null) {
       let hookResult;
       try {
         const afterAllHookElement = this.getElement(`after-all-details`);
         afterAllHookElement.classList.add("running");
         afterAllHookElement.part.add("running");
-        for (const [hook, ids] of afterHooks) {
-          if (this.isCanceled == true) {
-            throw new Error("Test has been cancelled");
-          }
-          hookResult = await hook(this, afterAllHookElement);
-          this.#handleHookResult(hookResult, true, "after");
+        if (this.isCanceled == true) {
+          throw new Error("Test has been cancelled");
         }
+        hookResult = await afterHook(this, afterAllHookElement);
+        this.#handleHookResult(hookResult, true, "after", false);
         afterAllHookElement.part.remove("running");
         afterAllHookElement.classList.remove("running");
       } catch (error) {
-        this.#handleHookResult(hookResult, false, "after", error);
+        this.#handleHookResult(hookResult, false, "after", false, error);
         console.error(error);
+        const requiredAfterHook2 = this.#hooks["requiredafterany" /* RequiredAfterAny */];
+        if (requiredAfterHook2 != null) {
+          let hookResult2;
+          try {
+            const requiredAfterAnyHookElement = this.getElement(`required-after-any-details`);
+            requiredAfterAnyHookElement.classList.add("running");
+            requiredAfterAnyHookElement.part.add("running");
+            if (this.isCanceled == true) {
+              throw new Error("Test has been cancelled");
+            }
+            hookResult2 = await requiredAfterHook2(this, requiredAfterAnyHookElement);
+            this.#handleHookResult(hookResult2, true, "after", true);
+            requiredAfterAnyHookElement.part.remove("running");
+            requiredAfterAnyHookElement.classList.remove("running");
+          } catch (error2) {
+            this.#handleHookResult(hookResult2, false, "after", true, error2);
+            console.error(error2);
+          }
+        }
         this.#continueRunningTests = false;
         this.classList.remove("running");
         this.part.remove("running");
@@ -840,6 +857,26 @@ var CodeTestsElement = class extends HTMLElement {
         return;
       }
     }
+    const requiredAfterHook = this.#hooks["requiredafterany" /* RequiredAfterAny */];
+    if (requiredAfterHook != null) {
+      let hookResult;
+      try {
+        const requiredAfterAnyHookElement = this.getElement(`required-after-any-details`);
+        requiredAfterAnyHookElement.classList.add("running");
+        requiredAfterAnyHookElement.part.add("running");
+        if (this.isCanceled == true) {
+          throw new Error("Test has been cancelled");
+        }
+        hookResult = await requiredAfterHook(this, requiredAfterAnyHookElement);
+        this.#handleHookResult(hookResult, true, "after", true);
+        requiredAfterAnyHookElement.part.remove("running");
+        requiredAfterAnyHookElement.classList.remove("running");
+      } catch (error) {
+        this.#handleHookResult(hookResult, false, "after", true, error);
+        console.error(error);
+        this.#continueRunningTests = false;
+      }
+    }
     const failedTests = this.shadowRoot.querySelectorAll('[success="false"]');
     this.setAttribute("success", failedTests.length == 0 ? "true" : "false");
     this.classList.remove("running");
@@ -869,7 +906,7 @@ var CodeTestsElement = class extends HTMLElement {
     afterAllHookElement.classList.remove("success", "fail");
     afterAllHookElement.part.remove("success", "fail");
   }
-  async #runTest(testId, test) {
+  async #runTest(testId, test, handleRequiredTests = true) {
     const testElement = this.getElement("tests").querySelector(`[data-test-id="${testId}"]`);
     if (testElement == null) {
       this.#addProcessError(`Unable to find test element for test: ${testId}`);
@@ -899,17 +936,38 @@ var CodeTestsElement = class extends HTMLElement {
     let testType;
     try {
       const allowTest = this.dispatchEvent(new CustomEvent("beforetest" /* BeforeTest */, { bubbles: true, cancelable: true, composed: true, detail: { testElement } }));
+      if (handleRequiredTests == true) {
+        const requiredBeforeHook = this.#hooks["requiredbeforeany" /* RequiredBeforeAny */];
+        if (requiredBeforeHook != null) {
+          let hookResult;
+          try {
+            const requiredBeforeAnyHookElement = this.getElement(`required-before-any-details`);
+            requiredBeforeAnyHookElement.classList.add("running");
+            requiredBeforeAnyHookElement.part.add("running");
+            if (this.isCanceled == true) {
+              throw new Error("Test has been cancelled");
+            }
+            hookResult = await requiredBeforeHook(this, requiredBeforeAnyHookElement);
+            this.#handleHookResult(hookResult, true, "before", true);
+            requiredBeforeAnyHookElement.part.remove("running");
+            requiredBeforeAnyHookElement.classList.remove("running");
+          } catch (error) {
+            this.#handleHookResult(hookResult, true, "before", true, error);
+            console.error(error);
+            this.#continueRunningTests = false;
+            return;
+          }
+        }
+      }
+      if (this.#continueRunningTests == false) {
+        throw new Error("Tests have been disabled from continuing to run.");
+      }
       if (allowTest == false || this.isCanceled == true) {
         throw new Error("Test has been cancelled");
       }
-      const beforeHooks = this.#hooks.get(BEFOREEACH);
-      if (beforeHooks != null) {
-        for (const [hook, ids] of beforeHooks) {
-          if (ids.has(testId)) {
-            beforeResult = await hook(this, testElement);
-            break;
-          }
-        }
+      const beforeHook = this.#hooks["beforeeach" /* BeforeEach */];
+      if (beforeHook != null) {
+        beforeResult = await beforeHook(this, testElement);
       }
       if (this.isCanceled == true) {
         throw new Error("Test has been cancelled");
@@ -918,12 +976,30 @@ var CodeTestsElement = class extends HTMLElement {
       if (this.isCanceled == true) {
         throw new Error("Test has been cancelled");
       }
-      const afterHooks = this.#hooks.get(AFTEREACH);
-      if (afterHooks != null) {
-        for (const [hook, ids] of afterHooks) {
-          if (ids.has(testId)) {
-            afterResult = await hook(this, testElement);
-            break;
+      const afterHook = this.#hooks["aftereach" /* AfterEach */];
+      if (afterHook != null) {
+        afterResult = await afterHook(this, testElement);
+      }
+      if (handleRequiredTests == true) {
+        const requiredAfterHook = this.#hooks["requiredafterany" /* RequiredAfterAny */];
+        if (requiredAfterHook != null) {
+          let hookResult;
+          try {
+            const requiredBeforeAnyHookElement = this.getElement(`required-before-any-details`);
+            requiredBeforeAnyHookElement.classList.add("running");
+            requiredBeforeAnyHookElement.part.add("running");
+            if (this.isCanceled == true) {
+              throw new Error("Test has been cancelled");
+            }
+            hookResult = await requiredAfterHook(this, requiredBeforeAnyHookElement);
+            this.#handleHookResult(hookResult, true, "after", true);
+            requiredBeforeAnyHookElement.part.remove("running");
+            requiredBeforeAnyHookElement.classList.remove("running");
+          } catch (error) {
+            this.#handleHookResult(hookResult, true, "after", true, error);
+            console.error(error);
+            this.#continueRunningTests = false;
+            return;
           }
         }
       }
@@ -981,19 +1057,19 @@ Result:${objectResult.value}`,
       detailsElement.open = true;
     }
   }
-  #handleHookResult(result, finishedTest, beforeOrAfter, error) {
+  #handleHookResult(result, finishedTest, beforeOrAfter, required, error) {
     if (result instanceof HTMLElement) {
-      this.#setHookResult(result, finishedTest, beforeOrAfter);
+      this.#setHookResult(result, finishedTest, beforeOrAfter, required);
     } else {
       let defaultResult;
       if (result == void 0) {
         defaultResult = this.#createDefaultResult(finishedTest == true ? "Hook Ran Successfully" : `Failed${error != null ? `:
 ${error.message}` : ""}`, finishedTest);
-        this.#setHookResult(defaultResult, finishedTest, beforeOrAfter);
+        this.#setHookResult(defaultResult, finishedTest, beforeOrAfter, required);
       } else if (typeof result == "string") {
         defaultResult = this.#createDefaultResult(`${result}${error == null ? "" : `:
 ${error.message}`}`, finishedTest);
-        this.#setHookResult(defaultResult, finishedTest, beforeOrAfter);
+        this.#setHookResult(defaultResult, finishedTest, beforeOrAfter, required);
       } else if (typeof result == "object") {
         const objectResult = result;
         if (objectResult.success != void 0 && objectResult.expected != void 0 && objectResult.value != void 0) {
@@ -1003,7 +1079,7 @@ Expected:${objectResult.expected}
 Result:${objectResult.value}`,
             objectResult.success
           );
-          this.#setHookResult(defaultResult, finishedTest, beforeOrAfter);
+          this.#setHookResult(defaultResult, finishedTest, beforeOrAfter, required);
         }
       }
     }
@@ -1096,9 +1172,10 @@ Result:${objectResult.value}`,
     codeElement.appendChild(preElement);
     return codeElement;
   }
-  #setHookResult(valueElement, success, beforeOrAfter) {
-    const detailsElement = this.getElement(`${beforeOrAfter}-all-details`);
-    const resultsElement = this.getElement(`${beforeOrAfter}-all-results`);
+  #setHookResult(valueElement, success, beforeOrAfter, required) {
+    const selector = required == true ? `required-${beforeOrAfter}-any` : `${beforeOrAfter}-all`;
+    const detailsElement = this.getElement(`${selector}-details`);
+    const resultsElement = this.getElement(`${selector}-results`);
     detailsElement.setAttribute("success", success == true ? "true" : "false");
     detailsElement.classList.toggle("success", success);
     detailsElement.part.toggle("success", success);
@@ -1178,13 +1255,10 @@ if (customElements.get(COMPONENT_TAG_NAME) == null) {
   customElements.define(COMPONENT_TAG_NAME, CodeTestsElement);
 }
 export {
-  AFTERALL,
-  AFTEREACH,
-  BEFOREALL,
-  BEFOREEACH,
   CodeTestEventType,
   CodeTests,
   CodeTestsElement,
+  HookType,
   expect,
   prompt
 };

package/dist/code-tests.min.js

@@ -1,4 +1,4 @@
-var S=`:host
+var w=`:host
 {
     /*** gray ***/
     --uchu-light-gray-raw: 95.57% 0.003 286.35;
@@ -128,10 +128,24 @@ var S=`:host
     display: none;
 }
 :host(.has-before-hook) #before-all-details
-,:host(.has-before-hook) #after-all-details
+,:host(.has-after-hook) #after-all-details
 {
     display: initial;
 }
+:host(.has-required-before-hook) #required-before-any-details
+,:host(.has-required-after-hook) #required-after-any-details
+{
+    display: initial;
+}
+
+#required-before-any-summary
+,#required-after-any-summary
+{
+    background: var(--surface-process);
+    color: var(--text-process);
+    border: solid 1px var(--text-process);
+    grid-template-columns: auto auto 1fr;
+}
 
 #tests
 {
@@ -393,7 +407,7 @@ pre
 {
     from { transform: rotate(0deg); }
     to { transform: rotate(360deg); }
-}`;var F=`<slot name="header">
+}`;var x=`<slot name="header">
     <header id="header">
         <span id="title"><slot name="title"><span id="title-text">Tests</span></slot></span>
         <slot name="play-button">
@@ -406,6 +420,13 @@ pre
         <slot name="details"></slot>
     </header>
 </slot>
+<details id="required-before-any-details" class="hook">
+    <summary id="required-before-any-summary">
+        <span id="required-before-any-result-icon" class="result-icon"></span>
+        <span id="required-before-any-description" class="description">Results from Required Before Any Hook</span>
+    </summary>
+    <div id="required-before-any-results" class="results"></div>
+</details>
 <details id="before-all-details" class="hook">
     <summary id="before-all-summary">
         <span id="before-all-result-icon" class="result-icon"></span>
@@ -421,6 +442,13 @@ pre
     </summary>
     <div id="after-all-results" class="results"></div>
 </details>
+<details id="required-after-any-details" class="hook">
+    <summary id="required-after-any-summary">
+        <span id="required-after-any-result-icon" class="result-icon"></span>
+        <span id="required-after-any-description" class="description">Results from Required After Any Hook</span>
+    </summary>
+    <div id="required-after-any-results" class="results"></div>
+</details>
 
 <template id="prompt-template">
     <div class="prompt" part="prompt">
@@ -433,15 +461,15 @@ pre
             <button class="prompt-button reject" type="button">Reject</button>
         </div>
     </div>
-</template>`;var T=class extends Promise{async toBeDefined(t){if(await this==null)throw new Error(`${t??"Value"} is undefined`)}async toBe(t,s=!1){let e=await this;if((s==!0?e===t:e==t)==!1)throw new Error(`  Value is not equal.
-  Expected: ${t}
-  Result: ${e}`)}async toContainText(t){let s=await this}async toHaveAttribute(t){let s=await this;if(!(s instanceof HTMLElement))throw new Error("Unable to check for attribute on non-HTMLElement target");if(s.getAttribute(t))throw new Error("Taret does not have attribute")}},v=Symbol("beforeAll"),y=Symbol("beforeEach"),k=Symbol("afterAll"),x=Symbol("afterEach"),L=class d{static timeoutMS=500;static#e;static#p;static expect(t){return new T(async(e,r)=>{if(t instanceof Promise){let n=await t;e(n);return}e(t)})}static expectSync(t){return new T(async(e,r)=>{if(t instanceof Promise){let n=await t;e(n);return}e(t)})}static expectBefore(t){return new T(async(e,r)=>{if(t instanceof Promise){let n=await t;e(n);return}e(t)})}static async prompt(t,s,e,r){return new Promise((n,o)=>{let a=t.findElement("prompt-template"),l=d.createElementFromTemplate(a);l.querySelector(".label").textContent=e;let c=h=>{let f=h.composedPath();if(f.find(i=>i instanceof HTMLButtonElement&&i.classList.contains("accept"))!=null){let i=r?.onAccept?.()??!0;l.removeEventListener("click",c),n(i);return}if(f.find(i=>i instanceof HTMLButtonElement&&i.classList.contains("reject"))!=null){let i=r?.onReject?.()??!1;l.removeEventListener("click",c),n(i);return}};l.addEventListener("click",c),r?.acceptLabel!=null&&(l.querySelector(".accept").textContent=r.acceptLabel),r?.rejectLabel!=null&&(l.querySelector(".reject").textContent=r.rejectLabel);let u=s instanceof HTMLDetailsElement?s:s.querySelector(".test-details");u!=null&&(u.open=!0),s.querySelector(".result")?.append(l)})}static createElementFromTemplate(t,s){let e=t instanceof HTMLTemplateElement?t:document.querySelector(t);if(e==null)throw new Error(`Unable to find template element from selector: ${t}`);let r=e.content.cloneNode(!0).querySelector("*");if(r==null)throw new Error("Unable to find first child of template element");return s?.append(r),r}};function I(d){return L.expect(d)}function U(d,t,s,e){return L.prompt(d,t,s,e)}var $=":not(slot,defs,g,rect,path,circle,ellipse,line,polygon,text,tspan,use,svg image,svg title,desc,template,template *)";function P(d){let t=[...d.querySelectorAll(`${$}[id]`)];for(let e=0;e<t.length;e++)t[e].part.add(t[e].id);let s=[...d.querySelectorAll(`${$}[class]`)];for(let e=0;e<s.length;e++)s[e].part.add(...s[e].classList)}var z=(n=>(n.BeforeAll="beforeall",n.AfterAll="afterall",n.BeforeTest="beforetest",n.AfterTest="aftertest",n.Cancel="cancel",n))(z||{}),H=Symbol("No Test Defined"),D=new CSSStyleSheet;D.replaceSync(S);var B="code-tests",R=class extends HTMLElement{componentParts=new Map;getElement(t){if(this.componentParts.get(t)==null){let s=this.findElement(t);s!=null&&this.componentParts.set(t,s)}return this.componentParts.get(t)}findElement(t){return this.shadowRoot.getElementById(t)}#e=new Map;#p={[v]:C(),[y]:C(),[x]:C(),[k]:C()};#t=!0;constructor(){super(),this.attachShadow({mode:"open"}),this.shadowRoot.innerHTML=F,this.shadowRoot.adoptedStyleSheets.push(D),this.#c=this.#h.bind(this)}connectedCallback(){if(P(this.shadowRoot),this.addEventListener("click",this.#c),this.getAttribute("auto")=="false")return;let t=this.getAttribute("src")??this.getAttribute("test")??this.getAttribute("tests")??this.getAttribute("run")??this.getAttribute("path");t!=null&&this.loadTests(t)}disconnectedCallback(){this.removeEventListener("click",this.#c)}#c;#h(t){let s=t.composedPath().find(o=>o instanceof HTMLButtonElement&&o.classList.contains("run"));if(s==null)return;let e=s.closest("li");if(e==null){if(s.hasAttribute("data-all")==!0)if(this.classList.contains("running")){if(this.classList.contains("canceled"))return;this.cancel()}else this.runTests();return}let r=e.dataset.testId;if(r==null)return;let n=this.#s.get(r);n!=null&&(this.isCanceled=!1,this.classList.remove("canceled"),this.part.remove("canceled"),this.#u(r,n))}#f(){return this.getAttribute("src")??this.getAttribute("test")??this.getAttribute("tests")??this.getAttribute("run")??this.getAttribute("path")}async loadTests(t){let s=t??this.#f();if(s!=null)try{this.getElement("tests").innerHTML="",this.#s.clear(),this.classList.remove("has-before-hook"),this.classList.remove("has-after-hook");let e=window.location.href.lastIndexOf("/"),n=window.location.href.substring(e).indexOf(".")!=-1==!0?window.location.href.substring(0,e+1):window.location.href,o=n+s.substring(0,s.lastIndexOf("/")+1),a=n+s,l=await(await fetch(a)).text();l=l.replaceAll(/['"`](((\.\/)|(\.\.\/))+(.*))['"`]/g,`'${o}$1'`);let c=new File([l],s.substring(s.lastIndexOf("/")),{type:"text/javascript"}),h=await import(URL.createObjectURL(c)),f=h.tests??h.default;if(f==null)throw new Error(`Unable to find tests definition in file at path: ${s}`);let E=f[v];if(E!=null){if(this.#e.get(v)==null){let p=new Map;p.set(E,new Set),this.#e.set(v,p)}this.classList.add("has-before-hook")}let b=f[y];if(b!=null&&this.#e.get(y)==null){let p=new Map;p.set(b,new Set),this.#e.set(y,p)}let i=f[k];if(i!=null){if(this.#e.get(k)==null){let p=new Map;p.set(i,new Set),this.#e.set(k,p)}this.classList.add("has-after-hook")}let A=f[x];if(A!=null&&this.#e.get(x)==null){let p=new Map;p.set(A,new Set),this.#e.set(x,p)}for(let[w,p]of Object.entries(f)){let M=this.#g(w,p);if(E!=null){let m=this.#e.get(v);if(m!=null){let g=m.get(E);g?.add(M)}}if(b!=null){let m=this.#e.get(y);if(m!=null){let g=m.get(b);g?.add(M)}}if(i!=null){let m=this.#e.get(k);if(m!=null){let g=m.get(i);g?.add(M)}}if(A!=null){let m=this.#e.get(x);if(m!=null){let g=m.get(A);g?.add(M)}}}}catch(e){this.#i("An error occurred while loading the tasks:",e)}}isCanceled=!1;cancel(){this.isCanceled=!0,this.classList.add("canceled"),this.part.add("canceled"),this.dispatchEvent(new CustomEvent("cancel",{bubbles:!0,composed:!0}))}async runTests(){this.dispatchEvent(new CustomEvent("beforeall",{bubbles:!0,composed:!0})),this.#t=!0,this.classList.add("running"),this.isCanceled=!1,this.classList.remove("canceled"),this.part.remove("canceled"),this.toggleAttribute("success",!1);let t=this.findElement("play-button-label");t!=null&&(t.textContent="Cancel"),this.#m();let s=this.hasAttribute("in-order"),e=this.#e.get(v);if(e!=null){let o;try{let a=this.getElement("before-all-details");a.classList.add("running"),a.part.add("running");for(let[l,c]of e){if(this.isCanceled==!0)throw new Error("Test has been cancelled");o=await l(this,a),this.#a(o,!0,"before")}a.part.remove("running"),a.classList.remove("running")}catch(a){this.#a(o,!1,"before",a),console.error(a),this.#t=!1,this.classList.remove("running"),this.part.remove("running"),t!=null&&(t.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}));return}}if(s==!1){let o=[];for(let[a,l]of this.#s)o.push(this.#u(a,l));await Promise.all(o)}else for(let[o,a]of this.#s){if(this.#t==!1)break;await this.#u(o,a)}if(this.#t==!1){this.classList.remove("running"),this.part.remove("running"),t!=null&&(t.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}));return}let r=this.#e.get(k);if(r!=null){let o;try{let a=this.getElement("after-all-details");a.classList.add("running"),a.part.add("running");for(let[l,c]of r){if(this.isCanceled==!0)throw new Error("Test has been cancelled");o=await l(this,a),this.#a(o,!0,"after")}a.part.remove("running"),a.classList.remove("running")}catch(a){this.#a(o,!1,"after",a),console.error(a),this.#t=!1,this.classList.remove("running"),this.part.remove("running"),t!=null&&(t.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}));return}}let n=this.shadowRoot.querySelectorAll('[success="false"]');this.setAttribute("success",n.length==0?"true":"false"),this.classList.remove("running"),this.part.remove("running"),t!=null&&(t.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}))}#m(){for(let[e,r]of this.#s){let n=this.getElement("tests").querySelector(`[data-test-id="${e}"]`);if(n==null){this.#i(`Unable to find test element for test: ${e}`);return}n.toggleAttribute("success",!1),n.classList.remove("success","fail"),n.part.remove("success","fail")}let t=this.getElement("before-all-details");t.toggleAttribute("success",!1),t.classList.remove("success","fail"),t.part.remove("success","fail");let s=this.getElement("after-all-details");s.toggleAttribute("success",!1),s.classList.remove("success","fail"),s.part.remove("success","fail")}async#u(t,s){let e=this.getElement("tests").querySelector(`[data-test-id="${t}"]`);if(e==null){this.#i(`Unable to find test element for test: ${t}`);return}e.toggleAttribute("success",!1),e.classList.add("running"),e.part.add("running"),e.classList.remove("success","fail"),e.part.remove("success","fail");let r=e.querySelector(".result-icon");r?.classList.remove("success","fail"),r?.part.remove("success","fail"),r?.classList.add("running"),r?.part.add("running");let n=e.querySelector(".error-message");n!=null&&(n.textContent="");let o=e.querySelector("details");o!=null&&(o.open=!1);let a=H,l,c=H,u;try{if(this.dispatchEvent(new CustomEvent("beforetest",{bubbles:!0,cancelable:!0,composed:!0,detail:{testElement:e}}))==!1||this.isCanceled==!0)throw new Error("Test has been cancelled");let f=this.#e.get(y);if(f!=null){for(let[b,i]of f)if(i.has(t)){a=await b(this,e);break}}if(this.isCanceled==!0)throw new Error("Test has been cancelled");if(l=await s(this,e),this.isCanceled==!0)throw new Error("Test has been cancelled");let E=this.#e.get(x);if(E!=null){for(let[b,i]of E)if(i.has(t)){c=await b(this,e);break}}u="before",a!=H&&this.#n(e,a,!0,void 0,u),u=void 0,this.#n(e,l,!0,void 0,u),u="after",c!=H&&this.#n(e,c,!0,void 0,u)}catch(h){this.#n(e,l,!1,h,u),console.error(h),this.#t=!1}finally{e?.classList.remove("running"),e?.part.remove("running"),r?.classList.remove("running"),r?.part.remove("running"),this.dispatchEvent(new CustomEvent("aftertest",{bubbles:!0,cancelable:!0,composed:!0,detail:{testElement:e}}))}}#n(t,s,e,r,n){if(s instanceof HTMLElement)this.#o(t,s,e,n);else if(s==null){let a=n==null?"Passed":"Hook Ran Successfully",l=this.#r(e==!0?`${a}`:`Failed${r!=null?`:
-${r.message}`:""}`,e,n);this.#o(t,l,e,n)}else if(typeof s=="string"){let a=this.#r(`${s}${r==null?"":`:
-${r.message}`}`,e,n);this.#o(t,a,e,n)}else if(typeof s=="object"){let a=s;if(a.success!=null&&a.expected!=null&&a.value!=null){let l=n==null?"Passed":"Success",c=n==null?"Failed":"Fail",u=this.#r(`${a.success==!0?`${l}:`:`${c}:`}
-Expected:${a.expected}
-Result:${a.value}`,a.success,n);this.#o(t,u,e,n)}}let o=t.querySelector("details");o!=null&&(o.open=!0)}#a(t,s,e,r){if(t instanceof HTMLElement)this.#l(t,s,e);else{let o;if(t==null)o=this.#r(s==!0?"Hook Ran Successfully":`Failed${r!=null?`:
-${r.message}`:""}`,s),this.#l(o,s,e);else if(typeof t=="string")o=this.#r(`${t}${r==null?"":`:
-${r.message}`}`,s),this.#l(o,s,e);else if(typeof t=="object"){let a=t;a.success!=null&&a.expected!=null&&a.value!=null&&(o=this.#r(`${a.success==!0?"Success:":"Fail:"}
-Expected:${a.expected}
-Result:${a.value}`,a.success),this.#l(o,s,e))}}let n=this.getElement(`${e}-all-details`);n!=null&&(n.open=!0)}static create(t){return document.createElement("code-tests")}#s=new Map;#g(t,s){let e=C();this.#s.set(e,s);let r=this.#b(e,t);return this.getElement("tests").append(r),e}#b(t,s){let e=document.createElement("li");e.dataset.testId=t,e.classList.add("test"),e.part.add("test");let r=document.createElement("details");r.classList.add("test-details"),r.part.add("test-details");let n=document.createElement("summary");n.classList.add("test-summary"),n.part.add("test-summary");let o=document.createElement("div");o.classList.add("result-icon"),o.part.add("result-icon"),n.append(o);let a=document.createElement("span");a.classList.add("description","test-description"),a.textContent=s,n.append(a);let l=document.createElement("button");l.classList.add("run","test-run"),l.part.add("run","test-run"),l.textContent="Run Test",l.title="Run Test",n.append(l);let c=document.createElement("div");c.classList.add("before-result","test-before-result"),c.part.add("before-result","test-before-result");let u=document.createElement("div");u.classList.add("result","test-result"),u.part.add("result","test-result");let h=document.createElement("div");return h.classList.add("after-result","test-after-result"),h.part.add("after-result","test-after-result"),r.append(n),r.append(c),r.append(u),r.append(h),e.append(r),e}#o(t,s,e,r){t.setAttribute("success",e==!0?"true":"false"),t.classList.toggle("success",e),t.part.toggle("success",e),t.classList.toggle("fail",!e),t.part.toggle("fail",!e);let n=t.querySelector(".result-icon");n?.classList.toggle("success",e),n?.part.toggle("success",e),n?.classList.toggle("fail",!e),n?.part.toggle("fail",!e);let o=t.querySelector(`.${r==null?"result":r=="before"?"before-result":"after-result"}`);if(o==null){this.#i("Unable to find result element");return}o.innerHTML="",o.appendChild(s)}#r(t,s,e){let r=document.createElement("code");r.classList.add("code"),r.part.add("code");let n=document.createElement("pre");n.textContent=t;let o=s==!0?"success-message":"error-message";return n.classList.add("pre",o),n.part.add("pre",o),r.appendChild(n),r}#l(t,s,e){let r=this.getElement(`${e}-all-details`),n=this.getElement(`${e}-all-results`);r.setAttribute("success",s==!0?"true":"false"),r.classList.toggle("success",s),r.part.toggle("success",s),r.classList.toggle("fail",!s),r.part.toggle("fail",!s),n.innerHTML="",n.appendChild(t)}#i(t,s){s instanceof Error&&(t+=`
-${s.message}`,console.error(s));let e=document.createElement("li");e.classList.add("error","process-error"),e.part.add("error","process-error");let r=document.createElement("code");r.classList.add("code","process-error-code"),r.part.add("code","process-error-code");let n=document.createElement("pre");n.classList.add("pre","process-error-pre"),n.part.add("pre","process-error-pre"),n.textContent=t,r.append(n),e.append(r),this.getElement("tests").append(e)}#d(t){if(t=="ordered"){let s=this.shadowRoot.querySelector("ul");if(s==null)return;let e=this.shadowRoot?.querySelectorAll("li"),r=document.createElement("ol");e!=null&&r.append(...e),r.id="tests",s.replaceWith(r)}else{let s=this.shadowRoot.querySelector("ol");if(s==null)return;let e=this.shadowRoot?.querySelectorAll("li"),r=document.createElement("ul");r.id="tests",e!=null&&r.append(...e),s.replaceWith(r)}}static observedAttributes=["in-order"];attributeChangedCallback(t,s,e){t=="in-order"&&(e==null?this.#d("unordered"):this.#d("ordered"))}};function C(){let d=new Uint8Array(20);crypto.getRandomValues(d);let t=[].slice.apply(d).map(function(e){return String.fromCharCode(e)}).join("");return btoa(t).replace(/\//g,"_").replace(/\+/g,"-").replace(/=/g,"")}customElements.get(B)==null&&customElements.define(B,R);export{k as AFTERALL,x as AFTEREACH,v as BEFOREALL,y as BEFOREEACH,z as CodeTestEventType,L as CodeTests,R as CodeTestsElement,I as expect,U as prompt};
+</template>`;var y=class extends Promise{async toBeDefined(e){if(await this==null)throw new Error(`${e??"Value"} is undefined`)}async toBe(e,r=!1){let t=await this;if((r==!0?t===e:t==e)==!1)throw new Error(`  Value is not equal.
+  Expected: ${e}
+  Result: ${t}`)}async toContainText(e){let r=await this}async toHaveAttribute(e){let r=await this;if(!(r instanceof HTMLElement))throw new Error("Unable to check for attribute on non-HTMLElement target");if(r.getAttribute(e))throw new Error("Taret does not have attribute")}},E=class f{static timeoutMS=500;static#e;static#r;static expect(e){return new y(async(t,s)=>{if(e instanceof Promise){let n=await e;t(n);return}t(e)})}static expectSync(e){return new y(async(t,s)=>{if(e instanceof Promise){let n=await e;t(n);return}t(e)})}static expectBefore(e){return new y(async(t,s)=>{if(e instanceof Promise){let n=await e;t(n);return}t(e)})}static async prompt(e,r,t,s){return new Promise((n,l)=>{let i=e.findElement("prompt-template"),o=f.createElementFromTemplate(i);o.querySelector(".label").textContent=t;let a=u=>{let c=u.composedPath();if(c.find(h=>h instanceof HTMLButtonElement&&h.classList.contains("accept"))!=null){let h=s?.onAccept?.()??!0;o.removeEventListener("click",a),n(h);return}if(c.find(h=>h instanceof HTMLButtonElement&&h.classList.contains("reject"))!=null){let h=s?.onReject?.()??!1;o.removeEventListener("click",a),n(h);return}};o.addEventListener("click",a),s?.acceptLabel!=null&&(o.querySelector(".accept").textContent=s.acceptLabel),s?.rejectLabel!=null&&(o.querySelector(".reject").textContent=s.rejectLabel);let p=r instanceof HTMLDetailsElement?r:r.querySelector(".test-details");p!=null&&(p.open=!0),r.querySelector(".result")?.append(o)})}static createElementFromTemplate(e,r){let t=e instanceof HTMLTemplateElement?e:document.querySelector(e);if(t==null)throw new Error(`Unable to find template element from selector: ${e}`);let s=t.content.cloneNode(!0).querySelector("*");if(s==null)throw new Error("Unable to find first child of template element");return r?.append(s),s}};function S(f){return E.expect(f)}function $(f,e,r,t){return E.prompt(f,e,r,t)}var A=":not(slot,defs,g,rect,path,circle,ellipse,line,polygon,text,tspan,use,svg image,svg title,desc,template,template *)";function L(f){let e=[...f.querySelectorAll(`${A}[id]`)];for(let t=0;t<e.length;t++)e[t].part.add(e[t].id);let r=[...f.querySelectorAll(`${A}[class]`)];for(let t=0;t<r.length;t++)r[t].part.add(...r[t].classList)}var P=(l=>(l.BeforeAll="beforeall",l.AfterAll="afterall",l.BeforeEach="beforeeach",l.AfterEach="aftereach",l.RequiredBeforeAny="requiredbeforeany",l.RequiredAfterAny="requiredafterany",l))(P||{}),F=(n=>(n.BeforeAll="beforeall",n.AfterAll="afterall",n.BeforeTest="beforetest",n.AfterTest="aftertest",n.Cancel="cancel",n))(F||{}),v=Symbol("No Test Defined"),H=new CSSStyleSheet;H.replaceSync(w);var C="code-tests",k=class extends HTMLElement{componentParts=new Map;getElement(e){if(this.componentParts.get(e)==null){let r=this.findElement(e);r!=null&&this.componentParts.set(e,r)}return this.componentParts.get(e)}findElement(e){return this.shadowRoot.getElementById(e)}#e={};#r=!0;constructor(){super(),this.attachShadow({mode:"open"}),this.shadowRoot.innerHTML=x,this.shadowRoot.adoptedStyleSheets.push(H),this.#c=this.#h.bind(this)}connectedCallback(){if(L(this.shadowRoot),this.addEventListener("click",this.#c),this.getAttribute("auto")=="false")return;let e=this.#d();e!=null&&this.loadTests(e)}disconnectedCallback(){this.removeEventListener("click",this.#c)}#c;#h(e){let r=e.composedPath().find(l=>l instanceof HTMLButtonElement&&l.classList.contains("run"));if(r==null)return;let t=r.closest("li");if(t==null){if(r.hasAttribute("data-all")==!0)if(this.classList.contains("running")){if(this.classList.contains("canceled"))return;this.cancel()}else this.runTests();return}let s=t.dataset.testId;if(s==null)return;let n=this.#s.get(s);n!=null&&(this.isCanceled=!1,this.classList.remove("canceled"),this.part.remove("canceled"),this.#u(s,n))}#d(){return this.getAttribute("src")??this.getAttribute("test")??this.getAttribute("tests")??this.getAttribute("run")??this.getAttribute("path")}async loadTests(e){let r=e??this.#d();if(r!=null)try{this.getElement("tests").innerHTML="",this.#s.clear(),this.classList.remove("has-before-hook"),this.classList.remove("has-after-hook");let t=window.location.href.lastIndexOf("/"),n=window.location.href.substring(t).indexOf(".")!=-1==!0?window.location.href.substring(0,t+1):window.location.href,l=n+r.substring(0,r.lastIndexOf("/")+1),i=n+r,o=await(await fetch(i)).text();o=o.replaceAll(/['"`](((\.\/)|(\.\.\/))+(.*))['"`]/g,`'${l}$1'`);let a=new File([o],r.substring(r.lastIndexOf("/")),{type:"text/javascript"}),u=await import(URL.createObjectURL(a)),c=u.tests??u.default;if(c==null)throw new Error(`Unable to find tests definition in file at path: ${r}`);let g=c.beforeall;g!=null&&(this.#e.beforeall=g,delete c.beforeall,this.classList.add("has-before-hook"));let b=c.afterall;b!=null&&(this.#e.afterall=b,delete c.afterall,this.classList.add("has-after-hook"));let h=c.beforeeach;h!=null&&(this.#e.beforeeach=h,delete c.beforeeach);let m=c.aftereach;m!=null&&(this.#e.aftereach=m,delete c.aftereach);let d=c.requiredbeforeany;d!=null&&(this.#e.requiredbeforeany=d,delete c.requiredbeforeany,this.classList.add("has-required-before-hook"),this.part.add("has-required-before-hook"));let T=c.requiredafterany;T!=null&&(this.#e.requiredafterany=T,delete c.requiredafterany,this.classList.add("has-required-after-hook"),this.part.add("has-required-after-hook"));for(let[q,R]of Object.entries(c))this.#m(q,R)}catch(t){this.#i("An error occurred while loading the tasks:",t)}}isCanceled=!1;cancel(){this.isCanceled=!0,this.classList.add("canceled"),this.part.add("canceled"),this.dispatchEvent(new CustomEvent("cancel",{bubbles:!0,composed:!0}))}async runTests(){this.dispatchEvent(new CustomEvent("beforeall",{bubbles:!0,composed:!0})),this.#r=!0,this.classList.add("running"),this.isCanceled=!1,this.classList.remove("canceled"),this.part.remove("canceled"),this.toggleAttribute("success",!1);let e=this.findElement("play-button-label");e!=null&&(e.textContent="Cancel"),this.#f();let r=this.hasAttribute("in-order"),t=this.#e.requiredbeforeany;if(t!=null){let o;try{let a=this.getElement("required-before-any-details");if(a.classList.add("running"),a.part.add("running"),this.isCanceled==!0)throw new Error("Test has been cancelled");o=await t(this,a),this.#t(o,!0,"before",!0),a.part.remove("running"),a.classList.remove("running")}catch(a){this.#t(o,!1,"before",!0,a),console.error(a),this.#r=!1,this.classList.remove("running"),this.part.remove("running"),e!=null&&(e.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}));return}}let s=this.#e.beforeall;if(s!=null){let o;try{let a=this.getElement("before-all-details");if(a.classList.add("running"),a.part.add("running"),this.isCanceled==!0)throw new Error("Test has been cancelled");o=await s(this,a),this.#t(o,!0,"before",!1),a.part.remove("running"),a.classList.remove("running")}catch(a){this.#t(o,!1,"before",!1,a),console.error(a),this.#r=!1,this.classList.remove("running"),this.part.remove("running"),e!=null&&(e.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}));return}}if(r==!1){let o=[];for(let[a,p]of this.#s)o.push(this.#u(a,p));await Promise.all(o)}else for(let[o,a]of this.#s){if(this.#r==!1)break;await this.#u(o,a,!1)}if(this.#r==!1){this.classList.remove("running"),this.part.remove("running"),e!=null&&(e.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}));return}let n=this.#e.afterall;if(n!=null){let o;try{let a=this.getElement("after-all-details");if(a.classList.add("running"),a.part.add("running"),this.isCanceled==!0)throw new Error("Test has been cancelled");o=await n(this,a),this.#t(o,!0,"after",!1),a.part.remove("running"),a.classList.remove("running")}catch(a){this.#t(o,!1,"after",!1,a),console.error(a);let p=this.#e.requiredafterany;if(p!=null){let u;try{let c=this.getElement("required-after-any-details");if(c.classList.add("running"),c.part.add("running"),this.isCanceled==!0)throw new Error("Test has been cancelled");u=await p(this,c),this.#t(u,!0,"after",!0),c.part.remove("running"),c.classList.remove("running")}catch(c){this.#t(u,!1,"after",!0,c),console.error(c)}}this.#r=!1,this.classList.remove("running"),this.part.remove("running"),e!=null&&(e.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}));return}}let l=this.#e.requiredafterany;if(l!=null){let o;try{let a=this.getElement("required-after-any-details");if(a.classList.add("running"),a.part.add("running"),this.isCanceled==!0)throw new Error("Test has been cancelled");o=await l(this,a),this.#t(o,!0,"after",!0),a.part.remove("running"),a.classList.remove("running")}catch(a){this.#t(o,!1,"after",!0,a),console.error(a),this.#r=!1}}let i=this.shadowRoot.querySelectorAll('[success="false"]');this.setAttribute("success",i.length==0?"true":"false"),this.classList.remove("running"),this.part.remove("running"),e!=null&&(e.textContent="Run Tests"),this.dispatchEvent(new CustomEvent("afterall",{bubbles:!0,composed:!0}))}#f(){for(let[t,s]of this.#s){let n=this.getElement("tests").querySelector(`[data-test-id="${t}"]`);if(n==null){this.#i(`Unable to find test element for test: ${t}`);return}n.toggleAttribute("success",!1),n.classList.remove("success","fail"),n.part.remove("success","fail")}let e=this.getElement("before-all-details");e.toggleAttribute("success",!1),e.classList.remove("success","fail"),e.part.remove("success","fail");let r=this.getElement("after-all-details");r.toggleAttribute("success",!1),r.classList.remove("success","fail"),r.part.remove("success","fail")}async#u(e,r,t=!0){let s=this.getElement("tests").querySelector(`[data-test-id="${e}"]`);if(s==null){this.#i(`Unable to find test element for test: ${e}`);return}s.toggleAttribute("success",!1),s.classList.add("running"),s.part.add("running"),s.classList.remove("success","fail"),s.part.remove("success","fail");let n=s.querySelector(".result-icon");n?.classList.remove("success","fail"),n?.part.remove("success","fail"),n?.classList.add("running"),n?.part.add("running");let l=s.querySelector(".error-message");l!=null&&(l.textContent="");let i=s.querySelector("details");i!=null&&(i.open=!1);let o=v,a,p=v,u;try{let c=this.dispatchEvent(new CustomEvent("beforetest",{bubbles:!0,cancelable:!0,composed:!0,detail:{testElement:s}}));if(t==!0){let h=this.#e.requiredbeforeany;if(h!=null){let m;try{let d=this.getElement("required-before-any-details");if(d.classList.add("running"),d.part.add("running"),this.isCanceled==!0)throw new Error("Test has been cancelled");m=await h(this,d),this.#t(m,!0,"before",!0),d.part.remove("running"),d.classList.remove("running")}catch(d){this.#t(m,!0,"before",!0,d),console.error(d),this.#r=!1;return}}}if(this.#r==!1)throw new Error("Tests have been disabled from continuing to run.");if(c==!1||this.isCanceled==!0)throw new Error("Test has been cancelled");let g=this.#e.beforeeach;if(g!=null&&(o=await g(this,s)),this.isCanceled==!0)throw new Error("Test has been cancelled");if(a=await r(this,s),this.isCanceled==!0)throw new Error("Test has been cancelled");let b=this.#e.aftereach;if(b!=null&&(p=await b(this,s)),t==!0){let h=this.#e.requiredafterany;if(h!=null){let m;try{let d=this.getElement("required-before-any-details");if(d.classList.add("running"),d.part.add("running"),this.isCanceled==!0)throw new Error("Test has been cancelled");m=await h(this,d),this.#t(m,!0,"after",!0),d.part.remove("running"),d.classList.remove("running")}catch(d){this.#t(m,!0,"after",!0,d),console.error(d),this.#r=!1;return}}}u="before",o!=v&&this.#a(s,o,!0,void 0,u),u=void 0,this.#a(s,a,!0,void 0,u),u="after",p!=v&&this.#a(s,p,!0,void 0,u)}catch(c){this.#a(s,a,!1,c,u),console.error(c),this.#r=!1}finally{s?.classList.remove("running"),s?.part.remove("running"),n?.classList.remove("running"),n?.part.remove("running"),this.dispatchEvent(new CustomEvent("aftertest",{bubbles:!0,cancelable:!0,composed:!0,detail:{testElement:s}}))}}#a(e,r,t,s,n){if(r instanceof HTMLElement)this.#o(e,r,t,n);else if(r==null){let i=n==null?"Passed":"Hook Ran Successfully",o=this.#n(t==!0?`${i}`:`Failed${s!=null?`:
+${s.message}`:""}`,t,n);this.#o(e,o,t,n)}else if(typeof r=="string"){let i=this.#n(`${r}${s==null?"":`:
+${s.message}`}`,t,n);this.#o(e,i,t,n)}else if(typeof r=="object"){let i=r;if(i.success!=null&&i.expected!=null&&i.value!=null){let o=n==null?"Passed":"Success",a=n==null?"Failed":"Fail",p=this.#n(`${i.success==!0?`${o}:`:`${a}:`}
+Expected:${i.expected}
+Result:${i.value}`,i.success,n);this.#o(e,p,t,n)}}let l=e.querySelector("details");l!=null&&(l.open=!0)}#t(e,r,t,s,n){if(e instanceof HTMLElement)this.#l(e,r,t,s);else{let i;if(e==null)i=this.#n(r==!0?"Hook Ran Successfully":`Failed${n!=null?`:
+${n.message}`:""}`,r),this.#l(i,r,t,s);else if(typeof e=="string")i=this.#n(`${e}${n==null?"":`:
+${n.message}`}`,r),this.#l(i,r,t,s);else if(typeof e=="object"){let o=e;o.success!=null&&o.expected!=null&&o.value!=null&&(i=this.#n(`${o.success==!0?"Success:":"Fail:"}
+Expected:${o.expected}
+Result:${o.value}`,o.success),this.#l(i,r,t,s))}}let l=this.getElement(`${t}-all-details`);l!=null&&(l.open=!0)}static create(e){return document.createElement("code-tests")}#s=new Map;#m(e,r){let t=D();this.#s.set(t,r);let s=this.#g(t,e);return this.getElement("tests").append(s),t}#g(e,r){let t=document.createElement("li");t.dataset.testId=e,t.classList.add("test"),t.part.add("test");let s=document.createElement("details");s.classList.add("test-details"),s.part.add("test-details");let n=document.createElement("summary");n.classList.add("test-summary"),n.part.add("test-summary");let l=document.createElement("div");l.classList.add("result-icon"),l.part.add("result-icon"),n.append(l);let i=document.createElement("span");i.classList.add("description","test-description"),i.textContent=r,n.append(i);let o=document.createElement("button");o.classList.add("run","test-run"),o.part.add("run","test-run"),o.textContent="Run Test",o.title="Run Test",n.append(o);let a=document.createElement("div");a.classList.add("before-result","test-before-result"),a.part.add("before-result","test-before-result");let p=document.createElement("div");p.classList.add("result","test-result"),p.part.add("result","test-result");let u=document.createElement("div");return u.classList.add("after-result","test-after-result"),u.part.add("after-result","test-after-result"),s.append(n),s.append(a),s.append(p),s.append(u),t.append(s),t}#o(e,r,t,s){e.setAttribute("success",t==!0?"true":"false"),e.classList.toggle("success",t),e.part.toggle("success",t),e.classList.toggle("fail",!t),e.part.toggle("fail",!t);let n=e.querySelector(".result-icon");n?.classList.toggle("success",t),n?.part.toggle("success",t),n?.classList.toggle("fail",!t),n?.part.toggle("fail",!t);let l=e.querySelector(`.${s==null?"result":s=="before"?"before-result":"after-result"}`);if(l==null){this.#i("Unable to find result element");return}l.innerHTML="",l.appendChild(r)}#n(e,r,t){let s=document.createElement("code");s.classList.add("code"),s.part.add("code");let n=document.createElement("pre");n.textContent=e;let l=r==!0?"success-message":"error-message";return n.classList.add("pre",l),n.part.add("pre",l),s.appendChild(n),s}#l(e,r,t,s){let n=s==!0?`required-${t}-any`:`${t}-all`,l=this.getElement(`${n}-details`),i=this.getElement(`${n}-results`);l.setAttribute("success",r==!0?"true":"false"),l.classList.toggle("success",r),l.part.toggle("success",r),l.classList.toggle("fail",!r),l.part.toggle("fail",!r),i.innerHTML="",i.appendChild(e)}#i(e,r){r instanceof Error&&(e+=`
+${r.message}`,console.error(r));let t=document.createElement("li");t.classList.add("error","process-error"),t.part.add("error","process-error");let s=document.createElement("code");s.classList.add("code","process-error-code"),s.part.add("code","process-error-code");let n=document.createElement("pre");n.classList.add("pre","process-error-pre"),n.part.add("pre","process-error-pre"),n.textContent=e,s.append(n),t.append(s),this.getElement("tests").append(t)}#p(e){if(e=="ordered"){let r=this.shadowRoot.querySelector("ul");if(r==null)return;let t=this.shadowRoot?.querySelectorAll("li"),s=document.createElement("ol");t!=null&&s.append(...t),s.id="tests",r.replaceWith(s)}else{let r=this.shadowRoot.querySelector("ol");if(r==null)return;let t=this.shadowRoot?.querySelectorAll("li"),s=document.createElement("ul");s.id="tests",t!=null&&s.append(...t),r.replaceWith(s)}}static observedAttributes=["in-order"];attributeChangedCallback(e,r,t){e=="in-order"&&(t==null?this.#p("unordered"):this.#p("ordered"))}};function D(){let f=new Uint8Array(20);crypto.getRandomValues(f);let e=[].slice.apply(f).map(function(t){return String.fromCharCode(t)}).join("");return btoa(e).replace(/\//g,"_").replace(/\+/g,"-").replace(/=/g,"")}customElements.get(C)==null&&customElements.define(C,k);export{F as CodeTestEventType,E as CodeTests,k as CodeTestsElement,P as HookType,S as expect,$ as prompt};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magnit-ce/code-tests",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "A custom html element that interprets and runs tests in a browser.",
   "type": "module",
   "main": "dist/code-tests.js",