Add Jsdoc description to litRuntime.ts, implement new interface contract

Author: webstackdev

src/components/Test/webComponent.ts

@@ -34,8 +34,9 @@ export class TestWebComponent extends LitElement {
   }
 }
 
-export const registerWebComponent = (tagName = TestWebComponent.registeredName) =>
+export const registerWebComponent = async (tagName = TestWebComponent.registeredName) => {
   defineCustomElement(tagName, TestWebComponent)
+}
 
 export const webComponentModule: WebComponentModule<TestWebComponent> = {
   registeredName: TestWebComponent.registeredName,

src/components/scripts/@types/webComponentModule.ts

@@ -3,5 +3,5 @@ import type { LitElement } from 'lit'
 export interface WebComponentModule<TElement extends LitElement = LitElement> {
   registeredName: string
   componentCtor: CustomElementConstructor & { prototype: TElement }
-  registerWebComponent: (tagName?: string) => Promise<void> | void
+  registerWebComponent: (_tagName?: string) => Promise<void> | void
 }

test/unit/helpers/litRuntime.ts

@@ -1,3 +1,8 @@
+/**
+ * Provides Happy DOM utilities for Lit-powered Astro component tests.
+ * The helpers create scoped browser globals, load WebComponentModule contracts,
+ * render Astro templates into sanitized DOM trees, and assert against the upgraded elements.
+ */
 import { Window } from 'happy-dom'
 import type HappyDomNode from 'happy-dom/lib/nodes/node/Node'
 import type HappyDomDocumentFragment from 'happy-dom/lib/nodes/document-fragment/DocumentFragment'