Class TComponent<T, IDMap>

constructor

• new TComponent<T extends Element = Element, IDMap = DefaultIDMap>(
      params?: ComponentParams,
  ): TComponent<T, IDMap>

  Creates an instance of TComponent.

  Type Parameters

  • T extends Element = Element

    The type of the root DOM Element.

  • IDMap = DefaultIDMap

    Defines the exact shape of the idMap.

  Parameters

  • params: ComponentParams = {}

    The initialization parameters.

  Returns TComponent<T, IDMap>

Readonlycontext

Readonlyelement

Static OptionalnamespaceURI

Static OptionalparseOptions

Statictemplate

Staticuses

destroy

• destroy(): void

  Destroys the component. Automatically removes the element from the DOM and cleans up all associated event listeners.

  Returns void

getById

• getById<K extends string | number | symbol>(id: K): IDMap[K]

  Retrieves an internal element or sub-component by its original template ID. Leverages the IDMap generic for strict type inference.

  Type Parameters

  • K extends string | number | symbol

  Parameters

  • id: K

    The original ID defined in the static template.

  Returns IDMap[K]

  The element, strongly typed based on the IDMap.

• getById<
      K extends string
      | number
      | symbol,
      E extends AbstractComponent | Element,
  >(
      id: K,
      ExpectedType: ConstructorOf<E>,
  ): E

  Retrieves an internal element or sub-component by its original template ID, and asserts its type at runtime.

  Type Parameters

  • K extends string | number | symbol
  • E extends AbstractComponent | Element

  Parameters

  • id: K

    The original ID defined in the static template.

  • ExpectedType: ConstructorOf<E>

    The expected class (e.g., HTMLInputElement, ChildComponent).

  Returns E

  The element, strongly typed to the ExpectedType.

Staticfrom

• from<C extends TComponent<Element, DefaultIDMap>>(
      this: ConstructorOf<C>,
      element: Element | null | undefined,
  ): C | undefined

  Retrieves the component instance associated with the given DOM element. Only returns the instance if it matches the calling class type.

  Type Parameters

  • C extends TComponent<Element, DefaultIDMap>

  Parameters

  • this: ConstructorOf<C>
  • element: Element | null | undefined

    The root DOM element of the component.

  Returns C | undefined

  The component instance, or undefined if not found or type mismatch.

StaticgetParsed

• getParsed(): ParsedComponent

  Retrieves the class-specific parsed templates and their dependent components (uses). If they have not been parsed yet, parses them and caches the results.

  Returns ParsedComponent

  The parsed templates and their dependencies.