@studiometa/js-toolkit 2.4.4-alpha.0 → 2.4.4-alpha.1

package/decorators/withIntersectionObserver.d.ts

@@ -0,0 +1,97 @@
+import type { BaseConstructor, BaseTypeParameter } from '../Base/index.js';
+interface WithIntersectionObserverInterface {
+    $options: {
+        intersectionObserver: IntersectionObserverInit;
+    };
+    $observer: IntersectionObserver;
+    intersected(entries: IntersectionObserverEntry[]): void;
+}
+/**
+ * IntersectionObserver decoration.
+ */
+export default function withIntersectionObserver<T extends BaseTypeParameter = BaseTypeParameter>(BaseClass: BaseConstructor, defaultOptions?: IntersectionObserverInit): {
+    new <U extends BaseTypeParameter = BaseTypeParameter>(element: HTMLElement): {
+        /**
+         * Intersection observer instance.
+         */
+        $observer: IntersectionObserver;
+        $parent: import("../Base/index.js").default<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+            };
+        }>;
+        $id: string;
+        $el: (WithIntersectionObserverInterface & T & U)["$el"] & HTMLElement & {
+            __base__?: WeakMap<typeof import("../Base/index.js").default, import("../Base/index.js").default<{
+                $el: HTMLElement;
+                $options: import("../Base/index.js").BaseOptions;
+                $refs: import("../Base/index.js").BaseRefs;
+                $children: {
+                    [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+                };
+            }> | "terminated">;
+        };
+        $isMounted: boolean;
+        __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>>;
+        readonly $root: import("../Base/index.js").default<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+            };
+        }>;
+        readonly __config: import("../Base/index.js").BaseConfig;
+        __services: import("../Base/managers/ServicesManager.js").default;
+        readonly $services: import("../Base/managers/ServicesManager.js").default;
+        __refs: import("../Base/managers/RefsManager.js").default & (WithIntersectionObserverInterface & T & U)["$refs"] & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & (WithIntersectionObserverInterface & T & U)["$refs"] & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & (WithIntersectionObserverInterface & T & U)["$options"] & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & (WithIntersectionObserverInterface & T & U)["$options"] & import("../Base/index.js").BaseOptions;
+        __children: import("../Base/managers/ChildrenManager.js").default & ((WithIntersectionObserverInterface & T & U)["$children"] extends infer T_1 ? { [key in keyof T_1]: (WithIntersectionObserverInterface & T & U)["$children"][key][]; } : never) & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & ((WithIntersectionObserverInterface & T & U)["$children"] extends infer T_2 ? { [key_1 in keyof T_2]: (WithIntersectionObserverInterface & T & U)["$children"][key_1][]; } : never) & import("../Base/index.js").BaseChildren;
+        __events: import("../Base/managers/EventsManager.js").default;
+        readonly $log: (...args: any) => void;
+        readonly __debug: (...args: any) => void;
+        readonly __managers: import("../Base/index.js").Managers;
+        __callMethod(method: string, ...args: any[]): any;
+        __hasEvent(event: string): boolean;
+        $mount(): any;
+        $update(): any;
+        $destroy(): any;
+        $terminate(): void;
+        __addEmits(event: string): void;
+        __removeEmits(event: string): void;
+        readonly __ctor: typeof import("../Base/index.js").default;
+        $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
+        $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        $emit(event: string, ...args: any[]): void;
+        addEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        dispatchEvent(event: Event): boolean;
+        removeEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    };
+    config: {
+        name: string;
+        options: {
+            intersectionObserver: ObjectConstructor;
+        };
+        emits: string[];
+        debug?: boolean;
+        log?: boolean;
+        refs?: string[];
+        components?: import("../Base/index.js").BaseConfigComponents;
+    };
+    readonly $isBase: boolean;
+    $factory(nameOrSelector: string): import("../Base/index.js").default<{
+        $el: HTMLElement;
+        $options: import("../Base/index.js").BaseOptions;
+        $refs: import("../Base/index.js").BaseRefs;
+        $children: {
+            [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+        };
+    }>[];
+};
+export {};

package/decorators/withMountWhenInView.d.ts

@@ -0,0 +1,95 @@
+import type { BaseTypeParameter, BaseConfig } from '../Base/index.js';
+import Base from '../Base/index.js';
+declare type WithMountWhenInViewInterface = {
+    $options: {
+        intersectionObserver: IntersectionObserverInit;
+    };
+};
+/**
+ * IntersectionObserver decoration.
+ */
+export default function withMountWhenInView<T extends BaseTypeParameter = BaseTypeParameter>(BaseClass: typeof Base, defaultOptions?: IntersectionObserverInit): {
+    new <U extends BaseTypeParameter = BaseTypeParameter>(element: HTMLElement): {
+        /**
+         * Is the component visible?
+         * @private
+         */
+        __isVisible: boolean;
+        /**
+         * The component's observer.
+         * @private
+         */
+        __observer: IntersectionObserver;
+        /**
+         * Override the mounting of the component.
+         */
+        $mount(): any;
+        $parent: Base<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: Base<any> | Promise<Base<any>>;
+            };
+        }>;
+        $id: string;
+        $el: (WithMountWhenInViewInterface & T & U)["$el"] & HTMLElement & {
+            __base__?: WeakMap<typeof Base, Base<{
+                $el: HTMLElement;
+                $options: import("../Base/index.js").BaseOptions;
+                $refs: import("../Base/index.js").BaseRefs;
+                $children: {
+                    [name: string]: Base<any> | Promise<Base<any>>;
+                };
+            }> | "terminated">;
+        };
+        $isMounted: boolean;
+        __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>>;
+        readonly $root: Base<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: Base<any> | Promise<Base<any>>;
+            };
+        }>;
+        readonly __config: BaseConfig;
+        __services: import("../Base/managers/ServicesManager.js").default;
+        readonly $services: import("../Base/managers/ServicesManager.js").default;
+        __refs: import("../Base/managers/RefsManager.js").default & (WithMountWhenInViewInterface & T & U)["$refs"] & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & (WithMountWhenInViewInterface & T & U)["$refs"] & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & (WithMountWhenInViewInterface & T & U)["$options"] & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & (WithMountWhenInViewInterface & T & U)["$options"] & import("../Base/index.js").BaseOptions;
+        __children: import("../Base/managers/ChildrenManager.js").default & ((WithMountWhenInViewInterface & T & U)["$children"] extends infer T_1 ? { [key in keyof T_1]: (WithMountWhenInViewInterface & T & U)["$children"][key][]; } : never) & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & ((WithMountWhenInViewInterface & T & U)["$children"] extends infer T_2 ? { [key_1 in keyof T_2]: (WithMountWhenInViewInterface & T & U)["$children"][key_1][]; } : never) & import("../Base/index.js").BaseChildren;
+        __events: import("../Base/managers/EventsManager.js").default;
+        readonly $log: (...args: any) => void;
+        readonly __debug: (...args: any) => void;
+        readonly __managers: import("../Base/index.js").Managers;
+        __callMethod(method: string, ...args: any[]): any;
+        __hasEvent(event: string): boolean;
+        $update(): any;
+        $destroy(): any;
+        $terminate(): void;
+        __addEmits(event: string): void;
+        __removeEmits(event: string): void;
+        readonly __ctor: typeof Base;
+        $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
+        $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        $emit(event: string, ...args: any[]): void;
+        addEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        dispatchEvent(event: Event): boolean;
+        removeEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    };
+    config: BaseConfig;
+    readonly $isBase: boolean;
+    $factory(nameOrSelector: string): Base<{
+        $el: HTMLElement;
+        $options: import("../Base/index.js").BaseOptions;
+        $refs: import("../Base/index.js").BaseRefs;
+        $children: {
+            [name: string]: Base<any> | Promise<Base<any>>;
+        };
+    }>[];
+};
+export {};

package/decorators/withResponsiveOptions.d.ts

@@ -0,0 +1,81 @@
+import type { BaseTypeParameter, BaseConstructor, Managers } from '../Base/index.js';
+import ResponsiveOptionsManager from '../Base/managers/ResponsiveOptionsManager.js';
+/**
+ * Extends the configuration of an existing class.
+ */
+export default function withResponsiveOptions<T extends BaseTypeParameter = BaseTypeParameter>(BaseClass: BaseConstructor): {
+    new <U extends BaseTypeParameters = BaseTypeParameter>(element: HTMLElement): {
+        /**
+         * Get managers.
+         */
+        readonly __managers: Managers & {
+            OptionsManager: typeof ResponsiveOptionsManager;
+        };
+        $parent: import("../Base/index.js").default<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+            };
+        }>;
+        $id: string;
+        $el: (U & T)["$el"] & HTMLElement & {
+            __base__?: WeakMap<typeof import("../Base/index.js").default, import("../Base/index.js").default<{
+                $el: HTMLElement;
+                $options: import("../Base/index.js").BaseOptions;
+                $refs: import("../Base/index.js").BaseRefs;
+                $children: {
+                    [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+                };
+            }> | "terminated">;
+        };
+        $isMounted: boolean;
+        __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>>;
+        readonly $root: import("../Base/index.js").default<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+            };
+        }>;
+        readonly __config: import("../Base/index.js").BaseConfig;
+        __services: import("../Base/managers/ServicesManager.js").default;
+        readonly $services: import("../Base/managers/ServicesManager.js").default;
+        __refs: import("../Base/managers/RefsManager.js").default & (U & T)["$refs"] & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & (U & T)["$refs"] & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & (U & T)["$options"] & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & (U & T)["$options"] & import("../Base/index.js").BaseOptions;
+        __children: import("../Base/managers/ChildrenManager.js").default & ((U & T)["$children"] extends infer T_1 ? { [key in keyof T_1]: (U & T)["$children"][key][]; } : never) & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & ((U & T)["$children"] extends infer T_2 ? { [key_1 in keyof T_2]: (U & T)["$children"][key_1][]; } : never) & import("../Base/index.js").BaseChildren;
+        __events: import("../Base/managers/EventsManager.js").default;
+        readonly $log: (...args: any) => void;
+        readonly __debug: (...args: any) => void;
+        __callMethod(method: string, ...args: any[]): any;
+        __hasEvent(event: string): boolean;
+        $mount(): any;
+        $update(): any;
+        $destroy(): any;
+        $terminate(): void;
+        __addEmits(event: string): void;
+        __removeEmits(event: string): void;
+        readonly __ctor: typeof import("../Base/index.js").default;
+        $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
+        $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        $emit(event: string, ...args: any[]): void;
+        addEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        dispatchEvent(event: Event): boolean;
+        removeEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    };
+    readonly $isBase: boolean;
+    config: import("../Base/index.js").BaseConfig;
+    $factory(nameOrSelector: string): import("../Base/index.js").default<{
+        $el: HTMLElement;
+        $options: import("../Base/index.js").BaseOptions;
+        $refs: import("../Base/index.js").BaseRefs;
+        $children: {
+            [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+        };
+    }>[];
+};

package/decorators/withScrolledInView.d.ts

@@ -0,0 +1,198 @@
+import type { BaseTypeParameter, BaseConstructor, BaseConfig } from '../Base/index.js';
+declare type ScrollInViewProps = {
+    start: {
+        x: number;
+        y: number;
+    };
+    end: {
+        x: number;
+        y: number;
+    };
+    current: {
+        x: number;
+        y: number;
+    };
+    dampedCurrent: {
+        x: number;
+        y: number;
+    };
+    progress: {
+        x: number;
+        y: number;
+    };
+    dampedProgress: {
+        x: number;
+        y: number;
+    };
+};
+declare type withScrolledInViewOptions = IntersectionObserverInit & {
+    useOffsetSizes?: boolean;
+};
+/**
+ * Add scrolled in view capabilities to a component.
+ */
+export default function withScrolledInView<T extends BaseTypeParameter = BaseTypeParameter>(BaseClass: BaseConstructor, options?: withScrolledInViewOptions): {
+    new <U extends BaseTypeParameter = BaseTypeParameter>(element: any): {
+        __props: ScrollInViewProps;
+        /**
+         * Factor used for the `dampedProgress` props.
+         */
+        dampFactor: number;
+        /**
+         * Precision for the `dampedProgress` props.
+         */
+        dampPrecision: number;
+        /**
+         * Mounted hook.
+         *
+         * @returns {void}
+         */
+        mounted(): void;
+        /**
+         * Resized hook.
+         *
+         * @param   {import('../services/resize').ResizeServiceProps} props
+         * @returns {void}
+         */
+        resized(props: any): void;
+        /**
+         * Scrolled hook.
+         *
+         * @param   {import('../services/scroll').ScrollServiceProps} props
+         * @returns {void}
+         */
+        scrolled(props: any): void;
+        /**
+         * Ticked hook.
+         *
+         * @param   {import('../services/raf').RafServiceProps} props
+         * @returns {void}
+         */
+        ticked(props: any): void;
+        /**
+         * Destroyed hook.
+         *
+         * @returns {void}
+         */
+        destroyed(): void;
+        /**
+         * Set the decorator props.
+         *
+         * @returns {void}
+         */
+        __setProps(): void;
+        __isVisible: boolean;
+        __observer: IntersectionObserver;
+        $mount(): any;
+        $parent: import("../Base/index.js").default<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+            };
+        }>;
+        $id: string;
+        $el: ({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$el"] & HTMLElement & {
+            __base__?: WeakMap<typeof import("../Base/index.js").default, import("../Base/index.js").default<{
+                $el: HTMLElement;
+                $options: import("../Base/index.js").BaseOptions;
+                $refs: import("../Base/index.js").BaseRefs;
+                $children: {
+                    [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+                };
+            }> | "terminated">;
+        };
+        $isMounted: boolean;
+        __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>>;
+        readonly $root: import("../Base/index.js").default<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+            };
+        }>;
+        readonly __config: BaseConfig;
+        __services: import("../Base/managers/ServicesManager.js").default;
+        readonly $services: import("../Base/managers/ServicesManager.js").default;
+        __refs: import("../Base/managers/RefsManager.js").default & ({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$refs"] & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & ({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$refs"] & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & ({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$options"] & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & ({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$options"] & import("../Base/index.js").BaseOptions; /**
+         * Set the decorator props.
+         *
+         * @returns {void}
+         */
+        __children: import("../Base/managers/ChildrenManager.js").default & (({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$children"] extends infer T_1 ? { [key in keyof T_1]: ({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$children"][key][]; } : never) & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & (({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$children"] extends infer T_2 ? { [key_1 in keyof T_2]: ({
+            $options: {
+                intersectionObserver: IntersectionObserverInit;
+            };
+        } & T & U)["$children"][key_1][]; } : never) & import("../Base/index.js").BaseChildren;
+        __events: import("../Base/managers/EventsManager.js").default;
+        readonly $log: (...args: any) => void;
+        readonly __debug: (...args: any) => void;
+        readonly __managers: import("../Base/index.js").Managers;
+        __callMethod(method: string, ...args: any[]): any;
+        __hasEvent(event: string): boolean;
+        $update(): any;
+        $destroy(): any;
+        $terminate(): void;
+        __addEmits(event: string): void;
+        __removeEmits(event: string): void;
+        readonly __ctor: typeof import("../Base/index.js").default;
+        $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
+        $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        $emit(event: string, ...args: any[]): void;
+        addEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        dispatchEvent(event: Event): boolean;
+        removeEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    };
+    /**
+     * Config.
+     */
+    config: BaseConfig;
+    readonly $isBase: boolean;
+    $factory(nameOrSelector: string): import("../Base/index.js").default<{
+        $el: HTMLElement;
+        $options: import("../Base/index.js").BaseOptions;
+        $refs: import("../Base/index.js").BaseRefs;
+        $children: {
+            [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+        };
+    }>[];
+};
+export {};

package/decorators/withVue2.cjs

@@ -28,7 +28,7 @@ __export(withVue2_exports, {
 });
 module.exports = __toCommonJS(withVue2_exports);
 var import_utils = require("../utils/index.cjs");
-function withVue2(BaseClass, Vue) {
+function withVue2(BaseClass, VueCtor) {
   var _a, _b, _c;
   return _c = class extends BaseClass {
     constructor(element) {
@@ -48,7 +48,7 @@ function withVue2(BaseClass, Vue) {
         }
         return;
       }
-      this.$vue = new Vue(vueConfig);
+      this.$vue = new VueCtor(vueConfig);
       this.$on("mounted", () => {
         if (!(this.$refs.vue instanceof HTMLElement)) {
           throw new Error("[withVue] The `vue` refs must be a single HTMLElement.");

package/decorators/withVue2.d.ts

@@ -0,0 +1,98 @@
+import type Vue from 'vue';
+import type { ComponentOptions, VueConstructor } from 'vue';
+import type { BaseConstructor, BaseTypeParameter } from '../Base/index.js';
+interface WithVue2Interface {
+    $refs: {
+        vue: HTMLElement;
+    };
+}
+/**
+ * withVue decorator.
+ */
+export default function withVue2<T extends BaseTypeParameter = BaseTypeParameter, VueTypeParameter extends Vue = Vue>(BaseClass: BaseConstructor, VueCtor: VueConstructor): {
+    new <U extends BaseTypeParameter = BaseTypeParameter>(element: HTMLElement): {
+        $vue: Vue;
+        $parent: import("../Base/index.js").default<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+            };
+        }>;
+        $id: string;
+        $el: (WithVue2Interface & T & U)["$el"] & HTMLElement & {
+            __base__?: WeakMap<typeof import("../Base/index.js").default, import("../Base/index.js").default<{
+                $el: HTMLElement;
+                $options: import("../Base/index.js").BaseOptions;
+                $refs: import("../Base/index.js").BaseRefs;
+                $children: {
+                    [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+                };
+            }> | "terminated">;
+        };
+        $isMounted: boolean;
+        __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>>;
+        readonly $root: import("../Base/index.js").default<{
+            $el: HTMLElement;
+            $options: import("../Base/index.js").BaseOptions;
+            $refs: import("../Base/index.js").BaseRefs;
+            $children: {
+                [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+            };
+        }>;
+        readonly __config: import("../Base/index.js").BaseConfig;
+        __services: import("../Base/managers/ServicesManager.js").default;
+        readonly $services: import("../Base/managers/ServicesManager.js").default;
+        __refs: import("../Base/managers/RefsManager.js").default & (WithVue2Interface & T & U)["$refs"] & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & (WithVue2Interface & T & U)["$refs"] & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & (WithVue2Interface & T & U)["$options"] & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & (WithVue2Interface & T & U)["$options"] & import("../Base/index.js").BaseOptions;
+        __children: import("../Base/managers/ChildrenManager.js").default & ((WithVue2Interface & T & U)["$children"] extends infer T_1 ? { [key in keyof T_1]: (WithVue2Interface & T & U)["$children"][key][]; } : never) & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & ((WithVue2Interface & T & U)["$children"] extends infer T_2 ? { [key_1 in keyof T_2]: (WithVue2Interface & T & U)["$children"][key_1][]; } : never) & import("../Base/index.js").BaseChildren;
+        __events: import("../Base/managers/EventsManager.js").default;
+        readonly $log: (...args: any) => void;
+        readonly __debug: (...args: any) => void;
+        readonly __managers: import("../Base/index.js").Managers;
+        __callMethod(method: string, ...args: any[]): any;
+        __hasEvent(event: string): boolean;
+        $mount(): any;
+        $update(): any;
+        $destroy(): any;
+        $terminate(): void;
+        __addEmits(event: string): void;
+        __removeEmits(event: string): void;
+        readonly __ctor: typeof import("../Base/index.js").default;
+        $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
+        $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        $emit(event: string, ...args: any[]): void;
+        addEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        dispatchEvent(event: Event): boolean;
+        removeEventListener(type: string, callback: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    };
+    config: {
+        name: string;
+        refs: string[];
+        debug?: boolean;
+        log?: boolean;
+        emits?: string[];
+        components?: import("../Base/index.js").BaseConfigComponents;
+        options?: import("../Base/managers/OptionsManager.js").OptionsSchema;
+    };
+    /**
+     * Vue app configuration.
+     */
+    vueConfig: ComponentOptions<VueTypeParameter, import("vue/types/options.js").DefaultData<VueTypeParameter>, import("vue/types/options.js").DefaultMethods<VueTypeParameter>, import("vue/types/options.js").DefaultComputed, import("vue/types/options.js").PropsDefinition<import("vue/types/options.js").DefaultProps>, import("vue/types/options.js").DefaultProps> & {
+        render: ComponentOptions<VueTypeParameter>['render'];
+    };
+    readonly $isBase: boolean;
+    $factory(nameOrSelector: string): import("../Base/index.js").default<{
+        $el: HTMLElement;
+        $options: import("../Base/index.js").BaseOptions;
+        $refs: import("../Base/index.js").BaseRefs;
+        $children: {
+            [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+        };
+    }>[];
+};
+export {};

package/decorators/withVue2.js

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 import { isDev, isFunction } from "../utils/index.js";
-function withVue2(BaseClass, Vue) {
+function withVue2(BaseClass, VueCtor) {
   var _a, _b, _c;
   return _c = class extends BaseClass {
     constructor(element) {
@@ -25,7 +25,7 @@ function withVue2(BaseClass, Vue) {
         }
         return;
       }
-      this.$vue = new Vue(vueConfig);
+      this.$vue = new VueCtor(vueConfig);
       this.$on("mounted", () => {
         if (!(this.$refs.vue instanceof HTMLElement)) {
           throw new Error("[withVue] The `vue` refs must be a single HTMLElement.");

package/helpers/createApp.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @typedef {import('../Base/index.js').BaseConstructor} BaseConstructor
+ */
+/**
+ * Instantiate and mount the given component on the given root element when the page has been loaded
+ * and return a function to use the app instance when it is ready.
+ *
+ * @template {BaseConstructor} T
+ * @param {T} App
+ * @param {HTMLElement} [rootElement]
+ * @returns {() => Promise<InstanceType<T>>}
+ */
+export default function createApp<T extends typeof import("../Base/index.js").default>(App: T, rootElement?: HTMLElement): () => Promise<InstanceType<T>>;
+export type BaseConstructor = import('../Base/index.js').BaseConstructor;

package/helpers/getDirectChildren.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @typedef {import('../Base/index.js').default} Base
+ */
+/**
+ * Get direct children from a parent when working with nested components.
+ *
+ * @template {Base} T
+ * @param   {Base} parentInstance
+ * @param   {string} parentName
+ * @param   {string} childrenName
+ * @returns {T[]}
+ */
+export function getDirectChildren<T extends import("../Base/index.js").default<{
+    $el: HTMLElement;
+    $options: import("../Base/index.js").BaseOptions;
+    $refs: import("../Base/index.js").BaseRefs;
+    $children: {
+        [name: string]: import("../Base/index.js").default<any> | Promise<import("../Base/index.js").default<any>>;
+    };
+}>>(parentInstance: Base, parentName: string, childrenName: string): T[];
+/**
+ * Test if a component instance is a direct child from the given component.
+ *
+ * @param   {Base}    parentInstance
+ * @param   {string}  parentName
+ * @param   {string}  childrenName
+ * @param   {Base}    childInstance
+ * @returns {boolean}
+ */
+export function isDirectChild(parentInstance: Base, parentName: string, childrenName: string, childInstance: Base): boolean;
+export type Base = import('../Base/index.js').default;