@studiometa/js-toolkit 2.4.4-alpha.2 → 2.4.4-alpha.5

package/decorators/withMountWhenInView.d.ts

@@ -1,5 +1,4 @@
-import type { BaseTypeParameter, BaseConfig } from '../Base/index.js';
-import Base from '../Base/index.js';
+import type { Base, BaseTypeParameter, BaseConfig, BaseConstructor } from '../Base/index.js';
 declare type WithMountWhenInViewInterface = {
     $options: {
         intersectionObserver: IntersectionObserverInit;
@@ -8,8 +7,8 @@ declare type WithMountWhenInViewInterface = {
 /**
  * IntersectionObserver decoration.
  */
-export default function withMountWhenInView<T extends BaseTypeParameter = BaseTypeParameter>(BaseClass: typeof Base, defaultOptions?: IntersectionObserverInit): {
-    new <U extends BaseTypeParameter = BaseTypeParameter>(element: HTMLElement): {
+export default function withMountWhenInView<S extends BaseConstructor<Base>, T extends BaseTypeParameter = BaseTypeParameter>(BaseClass: S, defaultOptions?: IntersectionObserverInit): {
+    new (...args: any[]): {
         /**
          * Is the component visible?
          * @private
@@ -24,72 +23,100 @@ export default function withMountWhenInView<T extends BaseTypeParameter = BaseTy
          * 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>>;
-            };
-        }>;
+        $parent: Base<BaseTypeParameter>;
         $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">;
+        $el: HTMLElement & {
+            __base__?: WeakMap<BaseConstructor<Base<BaseTypeParameter>>, Base<BaseTypeParameter> | "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 $root: Base<BaseTypeParameter>;
         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;
+        __refs: import("../Base/managers/RefsManager.js").default & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & import("../Base/index.js").BaseOptions;
+        __children: import("../Base/managers/ChildrenManager.js").default & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & import("../Base/index.js").BaseChildren;
         __events: import("../Base/managers/EventsManager.js").default;
-        readonly $log: (...args: any) => void;
-        readonly __debug: (...args: any) => void;
+        readonly $log: (...args: unknown[]) => void;
+        readonly __debug: (...args: unknown[]) => void;
         readonly __managers: import("../Base/index.js").Managers;
-        __callMethod(method: string, ...args: any[]): any;
+        __callMethod(method: string, ...args: unknown[]): unknown;
         __hasEvent(event: string): boolean;
         $update(): any;
         $destroy(): any;
         $terminate(): void;
         __addEmits(event: string): void;
         __removeEmits(event: string): void;
-        readonly __ctor: typeof Base;
+        readonly __ctor: BaseConstructor<Base<BaseTypeParameter>>;
         $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
         $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-        $emit(event: string, ...args: any[]): void;
+        $emit(event: string, ...args: unknown[]): 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>>;
+    prototype: Base<BaseTypeParameter>;
+} & Pick<typeof Base, "prototype" | "$isBase" | "config" | "$factory"> & Pick<{
+    new (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<BaseTypeParameter>;
+        $id: string;
+        $el: HTMLElement & {
+            __base__?: WeakMap<BaseConstructor<Base<BaseTypeParameter>>, Base<BaseTypeParameter> | "terminated">;
         };
-    }>[];
+        $isMounted: boolean;
+        __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>>;
+        readonly $root: Base<BaseTypeParameter>;
+        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 & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & import("../Base/index.js").BaseOptions;
+        __children: import("../Base/managers/ChildrenManager.js").default & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & import("../Base/index.js").BaseChildren;
+        __events: import("../Base/managers/EventsManager.js").default;
+        readonly $log: (...args: unknown[]) => void;
+        readonly __debug: (...args: unknown[]) => void;
+        readonly __managers: import("../Base/index.js").Managers;
+        __callMethod(method: string, ...args: unknown[]): unknown;
+        __hasEvent(event: string): boolean;
+        $update(): any;
+        $destroy(): any;
+        $terminate(): void;
+        __addEmits(event: string): void;
+        __removeEmits(event: string): void;
+        readonly __ctor: BaseConstructor<Base<BaseTypeParameter>>;
+        $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
+        $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        $emit(event: string, ...args: unknown[]): 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: true;
+    $factory: typeof Base.$factory;
+} & S, "prototype" | "$isBase" | "config" | "$factory" | keyof S> & S & {
+    new (...args: any[]): Base<T & WithMountWhenInViewInterface>;
+    prototype: Base<BaseTypeParameter>;
 };
 export {};

package/decorators/withMountWhenInView.js

@@ -5,8 +5,8 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 function withMountWhenInView(BaseClass, defaultOptions = { threshold: [0, 1] }) {
-  var _a, _b;
-  return _b = class extends BaseClass {
+  var _a;
+  class WithMountWhenInView extends BaseClass {
     constructor(element) {
       super(element);
       __publicField(this, "__isVisible", false);
@@ -23,7 +23,10 @@ function withMountWhenInView(BaseClass, defaultOptions = { threshold: [0, 1] })
             }
           }
         },
-        { ...defaultOptions, ...this.$options.intersectionObserver }
+        {
+          ...defaultOptions,
+          ...this.$options.intersectionObserver
+        }
       );
       this.__observer.observe(this.$el);
       this.$on("terminated", () => {
@@ -36,14 +39,16 @@ function withMountWhenInView(BaseClass, defaultOptions = { threshold: [0, 1] })
       }
       return this;
     }
-  }, __publicField(_b, "config", {
+  }
+  __publicField(WithMountWhenInView, "config", {
     ...BaseClass.config,
     name: `${BaseClass.config.name}WithMountWhenInView`,
     options: {
       ...((_a = BaseClass.config) == null ? void 0 : _a.options) || {},
       intersectionObserver: Object
     }
-  }), _b;
+  });
+  return WithMountWhenInView;
 }
 export {
   withMountWhenInView as default

package/decorators/withResponsiveOptions.cjs

@@ -30,13 +30,14 @@ __export(withResponsiveOptions_exports, {
 module.exports = __toCommonJS(withResponsiveOptions_exports);
 var import_ResponsiveOptionsManager = __toESM(require("../Base/managers/ResponsiveOptionsManager.cjs"), 1);
 function withResponsiveOptions(BaseClass) {
-  return class WithResponsiveOptions extends BaseClass {
+  class WithResponsiveOptions extends BaseClass {
     get __managers() {
       return {
         ...super.__managers,
         OptionsManager: import_ResponsiveOptionsManager.default
       };
     }
-  };
+  }
+  return WithResponsiveOptions;
 }
 if (module.exports.default) module.exports = module.exports.default;

package/decorators/withResponsiveOptions.d.ts

@@ -1,58 +1,37 @@
-import type { BaseTypeParameter, BaseConstructor, Managers } from '../Base/index.js';
+import type { Base, 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): {
+export default function withResponsiveOptions<S extends BaseConstructor<Base>, T extends BaseTypeParameter = BaseTypeParameter>(BaseClass: S): {
+    new (...args: any[]): {
         /**
          * 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>>;
-            };
-        }>;
+        $parent: Base<BaseTypeParameter>;
         $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">;
+        $el: HTMLElement & {
+            __base__?: WeakMap<BaseConstructor<Base<BaseTypeParameter>>, Base<BaseTypeParameter> | "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 $root: Base<BaseTypeParameter>;
         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;
+        __refs: import("../Base/managers/RefsManager.js").default & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & import("../Base/index.js").BaseOptions;
+        __children: import("../Base/managers/ChildrenManager.js").default & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & 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;
+        readonly $log: (...args: unknown[]) => void;
+        readonly __debug: (...args: unknown[]) => void;
+        __callMethod(method: string, ...args: unknown[]): unknown;
         __hasEvent(event: string): boolean;
         $mount(): any;
         $update(): any;
@@ -60,22 +39,63 @@ export default function withResponsiveOptions<T extends BaseTypeParameter = Base
         $terminate(): void;
         __addEmits(event: string): void;
         __removeEmits(event: string): void;
-        readonly __ctor: typeof import("../Base/index.js").default;
+        readonly __ctor: BaseConstructor<Base<BaseTypeParameter>>;
         $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
         $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-        $emit(event: string, ...args: any[]): void;
+        $emit(event: string, ...args: unknown[]): 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>>;
+    prototype: Base<BaseTypeParameter>;
+} & Pick<typeof Base, "prototype" | "$isBase" | "config" | "$factory"> & Pick<{
+    new (...args: any[]): {
+        /**
+         * Get managers.
+         */
+        readonly __managers: Managers & {
+            OptionsManager: typeof ResponsiveOptionsManager;
+        };
+        $parent: Base<BaseTypeParameter>;
+        $id: string;
+        $el: HTMLElement & {
+            __base__?: WeakMap<BaseConstructor<Base<BaseTypeParameter>>, Base<BaseTypeParameter> | "terminated">;
         };
-    }>[];
+        $isMounted: boolean;
+        __eventHandlers: Map<string, Set<EventListenerOrEventListenerObject>>;
+        readonly $root: Base<BaseTypeParameter>;
+        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 & import("../Base/index.js").BaseRefs;
+        readonly $refs: import("../Base/managers/RefsManager.js").default & import("../Base/index.js").BaseRefs;
+        __options: import("../Base/managers/OptionsManager.js").default & import("../Base/index.js").BaseOptions;
+        readonly $options: import("../Base/managers/OptionsManager.js").default & import("../Base/index.js").BaseOptions;
+        __children: import("../Base/managers/ChildrenManager.js").default & import("../Base/index.js").BaseChildren;
+        readonly $children: import("../Base/managers/ChildrenManager.js").default & import("../Base/index.js").BaseChildren;
+        __events: import("../Base/managers/EventsManager.js").default;
+        readonly $log: (...args: unknown[]) => void;
+        readonly __debug: (...args: unknown[]) => void;
+        __callMethod(method: string, ...args: unknown[]): unknown;
+        __hasEvent(event: string): boolean;
+        $mount(): any;
+        $update(): any;
+        $destroy(): any;
+        $terminate(): void;
+        __addEmits(event: string): void;
+        __removeEmits(event: string): void;
+        readonly __ctor: BaseConstructor<Base<BaseTypeParameter>>;
+        $on(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
+        $off(event: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        $emit(event: string, ...args: unknown[]): 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: true;
+    config: import("../Base/index.js").BaseConfig;
+    $factory: typeof Base.$factory;
+} & S, "prototype" | "$isBase" | "config" | "$factory" | keyof S> & S & {
+    new (...args: any[]): Base<T>;
+    prototype: Base<BaseTypeParameter>;
 };

package/decorators/withResponsiveOptions.js

@@ -1,13 +1,14 @@
 import ResponsiveOptionsManager from "../Base/managers/ResponsiveOptionsManager.js";
 function withResponsiveOptions(BaseClass) {
-  return class WithResponsiveOptions extends BaseClass {
+  class WithResponsiveOptions extends BaseClass {
     get __managers() {
       return {
         ...super.__managers,
         OptionsManager: ResponsiveOptionsManager
       };
     }
-  };
+  }
+  return WithResponsiveOptions;
 }
 export {
   withResponsiveOptions as default

package/decorators/withScrolledInView.cjs

@@ -30,7 +30,7 @@ var __publicField = (obj, key, value) => {
 // packages/js-toolkit/decorators/withScrolledInView.ts
 var withScrolledInView_exports = {};
 __export(withScrolledInView_exports, {
-  default: () => withScrolledInView
+  withScrolledInView: () => withScrolledInView
 });
 module.exports = __toCommonJS(withScrolledInView_exports);
 var import_withMountWhenInView = __toESM(require("./withMountWhenInView.cjs"), 1);
@@ -56,9 +56,8 @@ function updateProps(props, dampFactor, dampPrecision, axis = "x") {
   );
 }
 function withScrolledInView(BaseClass, options = {}) {
-  var _a;
   const WithMountWhenInView = (0, import_withMountWhenInView.default)(BaseClass, options);
-  return _a = class extends WithMountWhenInView {
+  class WithScrolledInView extends WithMountWhenInView {
     constructor(element) {
       super(element);
       __publicField(this, "__props", {
@@ -87,8 +86,6 @@ function withScrolledInView(BaseClass, options = {}) {
           y: 0
         }
       });
-      __publicField(this, "dampFactor", 0.1);
-      __publicField(this, "dampPrecision", 1e-3);
       const render = () => {
         scheduler.update(() => {
           const renderFn = this.__callMethod("scrolledInView", this.__props);
@@ -139,6 +136,12 @@ function withScrolledInView(BaseClass, options = {}) {
         render();
       });
     }
+    get dampFactor() {
+      return 0.1;
+    }
+    get dampPrecision() {
+      return 1e-3;
+    }
     mounted() {
       if ((0, import_utils.isFunction)(super.mounted)) {
         super.mounted();
@@ -201,9 +204,11 @@ function withScrolledInView(BaseClass, options = {}) {
         (this.__props.dampedCurrent.y - yStart) / (yEnd - yStart)
       );
     }
-  }, __publicField(_a, "config", {
+  }
+  __publicField(WithScrolledInView, "config", {
     name: `${BaseClass.config.name}WithMountWhenInView`,
     emits: ["scrolledInView"]
-  }), _a;
+  });
+  return WithScrolledInView;
 }
 if (module.exports.default) module.exports = module.exports.default;