wraplet 0.28.0 → 0.29.0

package/dist/AbstractWraplet.d.ts

@@ -1,44 +1,32 @@
-import { WrapletChildrenMap } from "./types/WrapletChildrenMap";
-import { WrapletChildren } from "./types/WrapletChildren";
-import { Wraplet, WrapletSymbol } from "./types/Wraplet";
-import { DestroyListener } from "./types/DestroyListener";
-import { ChildInstance } from "./types/ChildInstance";
-import { Groupable, GroupableSymbol, GroupExtractor } from "./types/Groupable";
-import { NodeTreeParent, NodeTreeParentSymbol } from "./types/NodeTreeParent";
-import { Core } from "./types/Core";
+import { WrapletChildrenMap } from "./Wraplet/types/WrapletChildrenMap";
+import { WrapletChildren } from "./Wraplet/types/WrapletChildren";
+import { Wraplet, WrapletSymbol } from "./Wraplet/types/Wraplet";
+import { DestroyListener } from "./Core/types/DestroyListener";
+import { ChildInstance } from "./Wraplet/types/ChildInstance";
+import { Groupable, GroupableSymbol } from "./types/Groupable";
+import { NodeTreeParent, NodeTreeParentSymbol } from "./NodeTreeManager/types/NodeTreeParent";
+import { Core } from "./Core/types/Core";
+import { WrapletApiFactoryArgs } from "./Wraplet/types/WrapletApiFactoryArgs";
+import { WrapletApi } from "./Wraplet/types/WrapletApi";
 export declare abstract class AbstractWraplet<N extends Node = Node, M extends WrapletChildrenMap = {}> implements Wraplet<N>, Groupable, NodeTreeParent {
     protected core: Core<N, M>;
     [WrapletSymbol]: true;
     [GroupableSymbol]: true;
     [NodeTreeParentSymbol]: true;
-    isGettingDestroyed: boolean;
-    isDestroyed: boolean;
-    isGettingInitialized: boolean;
-    isInitialized: boolean;
-    private groupsExtractor;
-    private destroyListeners;
-    /**
-     * This is the log of all node accessors, available for easier debugging.
-     */
-    private __debugNodeAccessors;
+    protected destroyListeners: DestroyListener<N>[];
+    wraplet: WrapletApi<N> & NodeTreeParent["wraplet"] & Groupable["wraplet"];
     constructor(core: Core<N, M>);
-    getNodeTreeChildren(): Wraplet[];
-    setGroupsExtractor(callback: GroupExtractor): void;
-    getGroups(): string[];
+    protected createWrapletApi(args: WrapletApiFactoryArgs<N, M>): WrapletApi<N> & NodeTreeParent["wraplet"] & Groupable["wraplet"];
     protected get children(): WrapletChildren<M>;
-    accessNode(callback: (node: N) => void): void;
-    destroy(): Promise<void>;
-    addDestroyListener(callback: DestroyListener<N>): void;
     /**
      * This method will be ivoked if one of the wraplet's children has been destroyed.
      */
-    protected onChildDestroyed(child: ChildInstance<M, keyof M>, id: keyof M): void;
-    initialize(): Promise<void>;
+    protected onChildDestroy(child: ChildInstance<M, keyof M>, id: keyof M): void;
     protected get node(): N;
     /**
-     * This method will be ivoked if one of the wraplet's children has been instantiated.
+     * This method will be invoked if one of the wraplet's children has been instantiated.
      */
-    protected onChildInstantiated(child: ChildInstance<M, keyof M>, id: keyof M): void;
+    protected onChildInstantiate(child: ChildInstance<M, keyof M>, id: keyof M): void;
     /**
      * This method makes sure that the given instance is an instance of a class belonging to the
      * given child.

package/dist/Core/DefaultArgCreator.d.ts

@@ -0,0 +1,10 @@
+import { ArgCreator, ArgCreatorSymbol } from "./types/ArgCreator";
+import { WrapletChildrenMap } from "../Wraplet/types/WrapletChildrenMap";
+import { WrapletCreatorArgs } from "./types/WrapletCreator";
+export declare class DefaultArgCreator<N extends Node, M extends WrapletChildrenMap = WrapletChildrenMap> implements ArgCreator<N, M> {
+    private creator;
+    [ArgCreatorSymbol]: true;
+    constructor(creator: ArgCreator<N, M>["createArg"]);
+    createArg(args: WrapletCreatorArgs<N, M>): unknown;
+    static create<N extends Node, M extends WrapletChildrenMap = WrapletChildrenMap>(creator: ArgCreator<N, M>["createArg"]): DefaultArgCreator<N, M>;
+}

package/dist/{DefaultCore.d.ts → Core/DefaultCore.d.ts}

@@ -1,27 +1,25 @@
-import { WrapletChildren } from "./types/WrapletChildren";
-import { Wraplet } from "./types/Wraplet";
-import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "./types/WrapletChildrenMap";
+import { WrapletChildren } from "../Wraplet/types/WrapletChildren";
+import { Wraplet } from "../Wraplet/types/Wraplet";
+import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../Wraplet/types/WrapletChildrenMap";
 import { InstantiateChildListener } from "./types/InstantiateChildListener";
 import { DestroyChildListener } from "./types/DestroyChildListener";
 import { CoreInitOptions } from "./types/CoreInitOptions";
 import { Core, CoreSymbol } from "./types/Core";
-import { NodeTreeParentSymbol } from "./types/NodeTreeParent";
-import { MapWrapper } from "./Map/MapWrapper";
+import { NodeTreeParentSymbol } from "../NodeTreeManager/types/NodeTreeParent";
+import { MapWrapper } from "../Map/MapWrapper";
 import { WrapletCreator } from "./types/WrapletCreator";
+import { Status } from "../Wraplet/types/Status";
 export declare class DefaultCore<N extends Node = Node, M extends WrapletChildrenMap = {}> implements Core<N, M> {
     node: N;
     [CoreSymbol]: true;
     [NodeTreeParentSymbol]: true;
-    isDestroyed: boolean;
-    isGettingDestroyed: boolean;
-    isGettingInitialized: boolean;
-    isInitialized: boolean;
+    private statusWritable;
+    get status(): Status;
     mapWrapper: MapWrapper<M>;
     private instantiatedChildren;
     private destroyChildListeners;
     private instantiateChildListeners;
     private listeners;
-    private defaultWrapletCreator;
     private wrapletCreator;
     constructor(node: N, map: M | MapWrapper<M>, initOptions?: Partial<CoreInitOptions<M>>);
     /**
@@ -42,7 +40,7 @@ export declare class DefaultCore<N extends Node = Node, M extends WrapletChildre
     private instantiateMultipleWrapletsChild;
     addDestroyChildListener(callback: DestroyChildListener<M, keyof M>): void;
     addInstantiateChildListener(callback: InstantiateChildListener<M, keyof M>): void;
-    setWrapletCreator(wrapletCreator: WrapletCreator<N, M>): void;
+    setWrapletCreator(wrapletCreator: WrapletCreator<Node, WrapletChildrenMap>): void;
     private prepareIndividualWraplet;
     /**
      * This method removes from nodes references to this wraplet and its children recursively.

package/dist/Core/defaultWrapletCreator.d.ts

@@ -0,0 +1,6 @@
+import { WrapletCreatorArgs } from "./types/WrapletCreator";
+import { WrapletChildrenMap } from "../Wraplet/types/WrapletChildrenMap";
+import { Constructable } from "../utils/types/Utils";
+import { Core } from "./types/Core";
+import { Wraplet } from "../Wraplet/types/Wraplet";
+export declare function defaultWrapletCreator(args: WrapletCreatorArgs<Node, WrapletChildrenMap>, currentCoreClass: Constructable<Core>): Wraplet;

package/dist/Core/types/ArgCreator.d.ts

@@ -0,0 +1,9 @@
+import { WrapletCreatorArgs } from "./WrapletCreator";
+import { WrapletChildrenMap } from "../../Wraplet/types/WrapletChildrenMap";
+declare const ArgCreatorSymbol: unique symbol;
+export { ArgCreatorSymbol };
+export interface ArgCreator<N extends Node, M extends WrapletChildrenMap = {}> {
+    [ArgCreatorSymbol]: true;
+    createArg(args: WrapletCreatorArgs<N, M>): unknown;
+}
+export declare function isArgCreator<N extends Node, M extends WrapletChildrenMap = {}>(object: unknown): object is ArgCreator<N, M>;

package/dist/{types → Core/types}/Core.d.ts

@@ -1,35 +1,22 @@
-import { WrapletChildren } from "./WrapletChildren";
-import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "./WrapletChildrenMap";
+import { WrapletChildren } from "../../Wraplet/types/WrapletChildren";
+import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../../Wraplet/types/WrapletChildrenMap";
 import { DestroyChildListener } from "./DestroyChildListener";
 import { InstantiateChildListener } from "./InstantiateChildListener";
-import { NodeTreeParent, NodeTreeParentSymbol } from "./NodeTreeParent";
-import { Wraplet } from "./Wraplet";
+import { Wraplet } from "../../Wraplet/types/Wraplet";
 import { WrapletCreator } from "./WrapletCreator";
+import { Status } from "../../Wraplet/types/Status";
 declare const CoreSymbol: unique symbol;
 export { CoreSymbol };
 /**
  * Children manager interface that defines the public API for managing wraplet relationships
  * and lifecycles.
  */
-export interface Core<N extends Node = Node, M extends WrapletChildrenMap = {}> extends NodeTreeParent {
+export interface Core<N extends Node = Node, M extends WrapletChildrenMap = {}> {
     [CoreSymbol]: true;
-    [NodeTreeParentSymbol]: true;
     /**
-     * Indicates whether the core is destroyed.
+     * Core status.
      */
-    isDestroyed: boolean;
-    /**
-     * Indicates whether the core is in the process of being destroyed.
-     */
-    isGettingDestroyed: boolean;
-    /**
-     * Indicates whether the core is in the process of being initialized.
-     */
-    isGettingInitialized: boolean;
-    /**
-     * Indicates whether the core has been initialized.
-     */
-    isInitialized: boolean;
+    status: Status;
     /**
      * The children map that defines the relationships between nodes.
      */
@@ -71,7 +58,7 @@ export interface Core<N extends Node = Node, M extends WrapletChildrenMap = {}>
     /**
      * Allows for overriding the default wraplet creation process.
      */
-    setWrapletCreator(wrapletCreator: WrapletCreator<N, M>): void;
+    setWrapletCreator(wrapletCreator: WrapletCreator<Node, WrapletChildrenMap>): void;
     /**
      * Get the instantiated children.
      */

package/dist/{types → Core/types}/CoreInitOptions.d.ts

@@ -1,5 +1,5 @@
 import { InstantiateChildListener } from "./InstantiateChildListener";
-import { WrapletChildrenMap } from "./WrapletChildrenMap";
+import { WrapletChildrenMap } from "../../Wraplet/types/WrapletChildrenMap";
 import { DestroyChildListener } from "./DestroyChildListener";
 export type CoreInitOptions<M extends WrapletChildrenMap = WrapletChildrenMap> = {
     instantiateChildListeners: InstantiateChildListener<M, keyof M>[];

package/dist/Core/types/DestroyChildListener.d.ts

@@ -0,0 +1,3 @@
+import { WrapletChildrenMap } from "../../Wraplet/types/WrapletChildrenMap";
+import { ChildInstance } from "../../Wraplet/types/ChildInstance";
+export type DestroyChildListener<M extends WrapletChildrenMap, K extends keyof M> = (wraplet: ChildInstance<M, K>, id: K) => void;

package/dist/{types → Core/types}/DestroyListener.d.ts

@@ -1,2 +1,2 @@
-import { Wraplet } from "./Wraplet";
+import { Wraplet } from "../../Wraplet/types/Wraplet";
 export type DestroyListener<N extends Node> = (wraplet: Wraplet<N>) => Promise<void>;

package/dist/Core/types/InstantiateChildListener.d.ts

@@ -0,0 +1,3 @@
+import { WrapletChildrenMap } from "../../Wraplet/types/WrapletChildrenMap";
+import { ChildInstance } from "../../Wraplet/types/ChildInstance";
+export type InstantiateChildListener<M extends WrapletChildrenMap, K extends keyof M> = (wraplet: ChildInstance<M, K>, id: K) => void;

package/dist/Core/types/WrapletCreator.d.ts

@@ -0,0 +1,15 @@
+import { Wraplet } from "../../Wraplet/types/Wraplet";
+import { MapWrapper } from "../../Map/MapWrapper";
+import { WrapletChildrenMap } from "../../Wraplet/types/WrapletChildrenMap";
+import { CoreInitOptions } from "./CoreInitOptions";
+import { Constructable } from "../../utils/types/Utils";
+import { Core } from "./Core";
+export type WrapletCreator<N extends Node, M extends WrapletChildrenMap> = (args: WrapletCreatorArgs<N, M>, currentCoreClass: Constructable<Core>) => Wraplet<N>;
+export type WrapletCreatorArgs<N extends Node, M extends WrapletChildrenMap> = {
+    id: keyof M;
+    Class: Constructable<Wraplet<N>>;
+    element: N;
+    map: MapWrapper<M>;
+    initOptions: CoreInitOptions<M>;
+    args: unknown[];
+};

package/dist/Map/MapRepeat.d.ts

@@ -1,5 +1,5 @@
 import { MapWrapper } from "./MapWrapper";
-import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../types/WrapletChildrenMap";
+import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../Wraplet/types/WrapletChildrenMap";
 import { DynamicMap, DynamicMapSymbol } from "./types/DynamicMap";
 export declare class MapRepeat implements DynamicMap {
     private readonly levels;

package/dist/Map/MapWrapper.d.ts

@@ -1,4 +1,4 @@
-import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../types/WrapletChildrenMap";
+import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../Wraplet/types/WrapletChildrenMap";
 type RecursiveMapKeys<T extends WrapletChildrenMap> = {
     [K in keyof T]: T[K] extends {
         map: infer M extends WrapletChildrenMap;

package/dist/Map/types/DynamicMap.d.ts

@@ -1,4 +1,4 @@
-import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../../types/WrapletChildrenMap";
+import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../../Wraplet/types/WrapletChildrenMap";
 import { MapWrapper } from "../MapWrapper";
 declare const DynamicMapSymbol: unique symbol;
 export { DynamicMapSymbol };

package/dist/{WrapletChildrenMap.d.ts → Map/utils.d.ts}

@@ -1,4 +1,4 @@
-import { WrapletChildDefinition, WrapletChildDefinitionWithDefaults } from "./types/WrapletChildDefinition";
-import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "./types/WrapletChildrenMap";
+import { WrapletChildDefinition, WrapletChildDefinitionWithDefaults } from "../Wraplet/types/WrapletChildDefinition";
+import { WrapletChildrenMap, WrapletChildrenMapWithDefaults } from "../Wraplet/types/WrapletChildrenMap";
 export declare function addDefaultsToChildDefinition<M extends WrapletChildrenMap, T extends WrapletChildDefinition<M>>(definition: T): WrapletChildDefinitionWithDefaults<T, M>;
 export declare function fillMapWithDefaults<M extends WrapletChildrenMap>(map: M): WrapletChildrenMapWithDefaults<M>;

package/dist/NodeTreeManager/DefaultNodeTreeManager.d.ts

@@ -1,5 +1,5 @@
-import { NodeTreeManager } from "./NodeTreeManager";
-import { Wraplet } from "../types/Wraplet";
+import { NodeTreeManager } from "./types/NodeTreeManager";
+import { Wraplet } from "../Wraplet/types/Wraplet";
 import { WrapletSetReadonly } from "../Set/types/WrapletSetReadonly";
 export type Initializer = (node: Node) => Promise<Wraplet[]>;
 export default class DefaultNodeTreeManager implements NodeTreeManager {

package/dist/NodeTreeManager/{NodeTreeManager.d.ts → types/NodeTreeManager.d.ts}

@@ -1,5 +1,5 @@
-import { Initializer } from "./DefaultNodeTreeManager";
-import { WrapletSetReadonly } from "../Set/types/WrapletSetReadonly";
+import { Initializer } from "../DefaultNodeTreeManager";
+import { WrapletSetReadonly } from "../../Set/types/WrapletSetReadonly";
 export interface NodeTreeManager {
     addWrapletInitializer(callback: Initializer): void;
     initializeNodeTree(node: Node): Promise<void>;

package/dist/{types → NodeTreeManager/types}/NodeTreeParent.d.ts

@@ -1,8 +1,10 @@
-import { Wraplet } from "./Wraplet";
+import { Wraplet } from "../../Wraplet/types/Wraplet";
 declare const NodeTreeParentSymbol: unique symbol;
 export { NodeTreeParentSymbol };
 export interface NodeTreeParent {
     [NodeTreeParentSymbol]: true;
-    getNodeTreeChildren(): Wraplet[];
+    wraplet: {
+        getNodeTreeChildren(): Wraplet[];
+    };
 }
 export declare function isNodeTreeParent(object: object): object is NodeTreeParent;

package/dist/{utils.d.ts → NodeTreeManager/utils.d.ts}

@@ -1,5 +1,5 @@
-import { Wraplet } from "./types/Wraplet";
-import { WrapletSet } from "./Set/types/WrapletSet";
+import { Wraplet } from "../Wraplet/types/Wraplet";
+import { WrapletSet } from "../Set/types/WrapletSet";
 export declare function isParentNode(node: Node): node is ParentNode;
 export declare function getWrapletsFromNode<N extends Node = Node, W extends Wraplet<N> = Wraplet<N>>(node: N): WrapletSet<W>;
 export declare function removeWrapletFromNode<N extends Node>(wraplet: Wraplet<N>, node: N): boolean;

package/dist/Set/DefaultWrapletSet.d.ts

@@ -1,5 +1,5 @@
 import { WrapletSet, WrapletSetSymbol } from "./types/WrapletSet";
-import { Wraplet } from "../types/Wraplet";
+import { Wraplet } from "../Wraplet/types/Wraplet";
 import { DefaultSearchableSet } from "./DefaultSearchableSet";
 import { WrapletSetReadonlySymbol } from "./types/WrapletSetReadonly";
 export declare class DefaultWrapletSet<T extends Wraplet> extends DefaultSearchableSet<T> implements WrapletSet {

package/dist/Set/DefaultWrapletSetReadonly.d.ts

@@ -1,4 +1,4 @@
-import { Wraplet } from "../types/Wraplet";
+import { Wraplet } from "../Wraplet/types/Wraplet";
 import { WrapletSetReadonly, WrapletSetReadonlySymbol } from "./types/WrapletSetReadonly";
 import { DefaultSearchableSet } from "./DefaultSearchableSet";
 export declare class DefaultWrapletSetReadonly<T extends Wraplet> extends DefaultSearchableSet<T> implements WrapletSetReadonly {

package/dist/Set/types/WrapletSet.d.ts

@@ -1,4 +1,4 @@
-import { Wraplet } from "../../types/Wraplet";
+import { Wraplet } from "../../Wraplet/types/Wraplet";
 import { BaseSet } from "./BaseSet";
 declare const WrapletSetSymbol: unique symbol;
 export { WrapletSetSymbol };

package/dist/Set/types/WrapletSetReadonly.d.ts

@@ -1,4 +1,4 @@
-import { Wraplet } from "../../types/Wraplet";
+import { Wraplet } from "../../Wraplet/types/Wraplet";
 import { BaseSet } from "./BaseSet";
 declare const WrapletSetReadonlySymbol: unique symbol;
 export { WrapletSetReadonlySymbol };

package/dist/Storage/{AbstractNongranularStorage.d.ts → AbstractNongranularKeyValueStorage.d.ts}

@@ -1,9 +1,10 @@
-import { Storage } from "./types/Storage";
+import { KeyValueStorage, KeyValueStorageSymbol } from "./types/KeyValueStorage";
 import { StorageValidators } from "./types/StorageValidators";
 import { NongranularStorageOptions } from "./NongranularStorageOptions";
-export declare abstract class AbstractNongranularStorage<D extends Record<string, unknown>> implements Storage<D> {
+export declare abstract class AbstractNongranularKeyValueStorage<D extends Record<string, unknown>> implements KeyValueStorage<D> {
     protected defaults: D;
     protected validators: StorageValidators<D>;
+    [KeyValueStorageSymbol]: true;
     private data;
     private options;
     constructor(defaults: D, validators: StorageValidators<D>, options: Partial<NongranularStorageOptions<D>>);

package/dist/Storage/ElementAttributeStorage.d.ts

@@ -1,11 +1,11 @@
 import { StorageValidators } from "./types/StorageValidators";
 import { ElementOptionsMerger } from "./ElementOptionsMerger";
-import { AbstractNongranularStorage } from "./AbstractNongranularStorage";
+import { AbstractNongranularKeyValueStorage } from "./AbstractNongranularKeyValueStorage";
 export type ElementStorageOptions<D extends Record<string, unknown>> = {
     keepFresh: boolean;
     elementOptionsMerger: ElementOptionsMerger<D>;
 };
-export declare class ElementAttributeStorage<D extends Record<string, unknown>> extends AbstractNongranularStorage<D> {
+export declare class ElementAttributeStorage<D extends Record<string, unknown>> extends AbstractNongranularKeyValueStorage<D> {
     private element;
     private attribute;
     protected defaults: D;

package/dist/Storage/ElementStorage.d.ts

@@ -1,7 +1,7 @@
 import { StorageValidators } from "./types/StorageValidators";
-import { AbstractNongranularStorage } from "./AbstractNongranularStorage";
+import { AbstractNongranularKeyValueStorage } from "./AbstractNongranularKeyValueStorage";
 import { NongranularStorageOptions } from "./NongranularStorageOptions";
-export declare class ElementStorage<D extends Record<string, unknown>, E extends Element = HTMLScriptElement> extends AbstractNongranularStorage<D> {
+export declare class ElementStorage<D extends Record<string, unknown>, E extends Element = HTMLScriptElement> extends AbstractNongranularKeyValueStorage<D> {
     private element;
     protected defaults: D;
     protected validators: StorageValidators<D>;

package/dist/Storage/StorageWrapper.d.ts

@@ -1,10 +1,11 @@
-import { Storage } from "./types/Storage";
+import { KeyValueStorage, KeyValueStorageSymbol } from "./types/KeyValueStorage";
 import { StorageValidators } from "./types/StorageValidators";
-export declare class StorageWrapper<D extends Record<string, unknown>> implements Storage<D> {
+export declare class StorageWrapper<D extends Record<string, unknown>> implements KeyValueStorage<D> {
     private storage;
     private defaults;
     private validators;
-    constructor(storage: Storage<D>, defaults: D, validators: StorageValidators<D>);
+    [KeyValueStorageSymbol]: true;
+    constructor(storage: KeyValueStorage<D>, defaults: D, validators: StorageValidators<D>);
     has(key: keyof D): Promise<boolean>;
     get<T extends keyof D>(key: T): Promise<D[T]>;
     getMultiple<T extends keyof D>(keys: T[]): Promise<Pick<D, T>>;

package/dist/Storage/types/KeyValueStorage.d.ts

@@ -0,0 +1,13 @@
+import { KeyValueStorageReadonly } from "./KeyValueStorageReadonly";
+declare const KeyValueStorageSymbol: unique symbol;
+export { KeyValueStorageSymbol };
+export interface KeyValueStorage<D extends Record<string, unknown>> extends KeyValueStorageReadonly<D> {
+    [KeyValueStorageSymbol]: true;
+    set: <T extends keyof D>(key: T, value: D[T]) => Promise<void>;
+    setMultiple: (data: Partial<D>) => Promise<void>;
+    setAll: (data: D) => Promise<void>;
+    delete: (key: keyof D) => Promise<void>;
+    deleteMultiple: (keys: (keyof D)[]) => Promise<void>;
+    deleteAll: () => Promise<void>;
+}
+export declare function isKeyValueStorage<D extends Record<string, unknown>>(object: unknown): object is KeyValueStorage<D>;

package/dist/Storage/types/{StorageReadonly.d.ts → KeyValueStorageReadonly.d.ts}

@@ -1,4 +1,4 @@
-export type StorageReadonly<D extends Record<string, unknown>> = {
+export type KeyValueStorageReadonly<D extends Record<string, unknown>> = {
     get: <T extends keyof D>(key: T) => Promise<D[T]>;
     getMultiple: <T extends keyof D>(keys: T[]) => Promise<Pick<D, T>>;
     getAll: () => Promise<D>;

package/dist/Wraplet/createWrapletApi.d.ts

@@ -0,0 +1,6 @@
+import { WrapletChildrenMap } from "./types/WrapletChildrenMap";
+import { Groupable } from "../types/Groupable";
+import { NodeTreeParent } from "../NodeTreeManager/types/NodeTreeParent";
+import { WrapletApiFactoryArgs } from "./types/WrapletApiFactoryArgs";
+import { WrapletApi, WrapletApiDebug } from "./types/WrapletApi";
+export declare const createWrapletApi: <N extends Node, M extends WrapletChildrenMap>(args: WrapletApiFactoryArgs<N, M>) => WrapletApi<N> & WrapletApiDebug<N> & NodeTreeParent["wraplet"] & Groupable["wraplet"];

package/dist/Wraplet/types/Status.d.ts

@@ -0,0 +1,9 @@
+export interface Status {
+    readonly isInitialized: boolean;
+    readonly isGettingInitialized: boolean;
+    readonly isDestroyed: boolean;
+    readonly isGettingDestroyed: boolean;
+}
+export type StatusWritable = {
+    -readonly [K in keyof Status]: Status[K];
+};

package/dist/Wraplet/types/Wraplet.d.ts

@@ -0,0 +1,8 @@
+import { WrapletApi } from "./WrapletApi";
+declare const WrapletSymbol: unique symbol;
+export { WrapletSymbol };
+export interface Wraplet<N extends Node = Node> {
+    [WrapletSymbol]: true;
+    wraplet: WrapletApi<N>;
+}
+export declare function isWraplet<N extends Node>(object: unknown): object is Wraplet<N>;

package/dist/Wraplet/types/WrapletApi.d.ts

@@ -0,0 +1,12 @@
+import { DestroyListener } from "../../Core/types/DestroyListener";
+import { Status } from "./Status";
+export interface WrapletApi<N extends Node = Node> {
+    status: Status;
+    accessNode(callback: (node: N) => void): void;
+    destroy(): Promise<void>;
+    initialize(): Promise<void>;
+    addDestroyListener(callback: DestroyListener<N>): void;
+}
+export interface WrapletApiDebug<N extends Node> {
+    __nodeAccessors: ((node: N) => void)[];
+}

package/dist/Wraplet/types/WrapletApiFactoryArgs.d.ts

@@ -0,0 +1,16 @@
+import { WrapletChildrenMap } from "./WrapletChildrenMap";
+import { Core } from "../../Core/types/Core";
+import { DestroyListener } from "../../Core/types/DestroyListener";
+import { WrapletApiFactoryBasicCallback } from "./WrapletApiFactoryBasicCallback";
+import { GroupExtractor } from "../../types/Groupable";
+import { Status } from "./Status";
+import { Wraplet } from "./Wraplet";
+export type WrapletApiFactoryArgs<N extends Node = Node, M extends WrapletChildrenMap = WrapletChildrenMap> = {
+    core: Core<N, M>;
+    wraplet: Wraplet<N>;
+    status?: Status;
+    destroyListeners?: DestroyListener<N>[];
+    initializeCallback?: WrapletApiFactoryBasicCallback;
+    destroyCallback?: WrapletApiFactoryBasicCallback;
+    groupExtractor?: GroupExtractor;
+};

package/dist/Wraplet/types/WrapletApiFactoryBasicCallback.d.ts

@@ -0,0 +1 @@
+export type WrapletApiFactoryBasicCallback = () => Promise<void>;

package/dist/{types → Wraplet/types}/WrapletChildDefinition.d.ts

@@ -1,8 +1,8 @@
 import { Wraplet } from "./Wraplet";
 import { WrapletChildrenMap } from "./WrapletChildrenMap";
-import { CoreInitOptions } from "./CoreInitOptions";
-import { DynamicMap } from "../Map/types/DynamicMap";
-import { Constructable } from "./Utils";
+import { CoreInitOptions } from "../../Core/types/CoreInitOptions";
+import { DynamicMap } from "../../Map/types/DynamicMap";
+import { Constructable } from "../../utils/types/Utils";
 export type SelectorCallback<N extends ParentNode = ParentNode> = (node: N) => Node[];
 export type WrapletChildDefinition<M extends WrapletChildrenMap = WrapletChildrenMap> = {
     selector?: string | SelectorCallback;

package/dist/{types → Wraplet/types}/WrapletChildren.d.ts

@@ -1,6 +1,6 @@
 import { WrapletChildrenMap } from "./WrapletChildrenMap";
-import { InstantiableReturnType } from "./Utils";
-import { WrapletSet } from "../Set/types/WrapletSet";
+import { InstantiableReturnType } from "../../utils/types/Utils";
+import { WrapletSet } from "../../Set/types/WrapletSet";
 export type OptionalSingleInstantiableReturnType<T extends WrapletChildrenMap, K extends keyof T> = T[K]["required"] extends true ? InstantiableReturnType<T[K]["Class"]> : InstantiableReturnType<T[K]["Class"]> | null;
 export type WrapletChildren<T extends WrapletChildrenMap> = {
     [id in keyof T]: T[id]["multiple"] extends true ? WrapletSet<InstantiableReturnType<T[id]["Class"]>> : OptionalSingleInstantiableReturnType<T, id>;

package/dist/index.cjs

@@ -1,2 +1,2 @@
-var t={d:(e,i)=>{for(var r in i)t.o(i,r)&&!t.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:i[r]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e),r:t=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})}},e={};t.r(e),t.d(e,{AbstractWraplet:()=>z,DefaultCore:()=>S,DefaultWrapletSet:()=>y,DefaultWrapletSetReadonly:()=>j,MapRepeat:()=>G,destroyWrapletsRecursively:()=>m,getWrapletsFromNode:()=>w,isWraplet:()=>L});class i extends Error{}class r extends Error{}class s extends Error{}class n extends Error{}class a extends Error{}class o extends Error{}class l extends Error{}function h(t){return Object.getPrototypeOf(t)===Object.prototype}const d=(t,e)=>"object"==typeof t&&null!==t&&!0===t[e],c=Symbol("WrapletSet");function p(t){return d(t,c)}class u extends Set{find(t){const e=[];for(const i of this)t(i)&&e.push(i);return e}findOne(t){for(const e of this)if(t(e))return e;return null}getOrdered(t){return Array.from(this).sort((e,i)=>t(e)-t(i))}}const f=Symbol("WrapletSetReadonly");class y extends u{[f]=!0;[c]=!0}function w(t){const e=t.wraplets;return p(e)&&0!==e.size?e:new y}function C(t,e){return!!e.wraplets&&e.wraplets.delete(t)}async function g(t,e){await e(t);const i=t.childNodes;for(const t of i)await g(t,e)}async function m(t){await g(t,async t=>{const e=w(t);for(const i of e)i.isGettingDestroyed||i.isDestroyed||await i.destroy(),C(i,t)})}const b=Symbol("NodeTreeParent"),v=Symbol("ChildrenManager");function I(t){return{args:[],destructible:!0,map:{},coreOptions:{},...t}}function W(t){const e={};for(const i in t){const r=t[i];e[i]=I(r);const s=r.map;s&&h(s)&&(e[i].map=W(s))}return e}const E=Symbol("DynamicMap");function M(t){return d(t,E)}class D{fullMap;startingPath;currentMap=null;path;currentPath=[];constructor(t,e=[],i=!0){this.path=e,this.startingPath=e,this.fullMap=W(t),i&&(this.currentMap=this.resolve(this.path))}getStartingMap(){return this.resolve(this.startingPath)}getCurrentMap(){return this.currentMap&&this.currentPath==this.path||(this.currentMap=this.resolve(this.path),this.currentPath=this.path),this.currentMap}findMap(t){let e=this.fullMap;for(const i of t){if(!e[i])throw new Error(`Invalid path: ${this.path.join(".")} . No such definition.`);const r=e[i].map;if(h(r))e=r;else{if(!M(r))throw new Error("Invalid map type.");e=r.create(this.clone(t,!1))}}return e}up(t,e=!0){if(!this.pathExists([...this.path,t]))throw new Error("Map doesn't exist.");this.path.push(t),e&&(this.currentMap=this.resolve(this.path))}pathExists(t){let e=this.fullMap;for(const i of t){if(!Object.hasOwn(e,i))return!1;const t=e[i].map;if(M(t))return!0;if(!h(t))throw new Error("Invalid map type.");e=t}return!0}down(t=!0){if(0===this.path.length)throw new Error("At the root already.");this.path.pop(),t&&(this.currentMap=this.resolve(this.path))}clone(t,e=!0){return new D(this.fullMap,t,e)}resolve(t){return this.findMap(t)}}class S{node;[v]=!0;[b]=!0;isDestroyed=!1;isGettingDestroyed=!1;isGettingInitialized=!1;isInitialized=!1;mapWrapper;instantiatedChildren={};destroyChildListeners=[];instantiateChildListeners=[];listeners=[];defaultWrapletCreator=t=>{const e=new this.constructor(t.element,t.map,t.initOptions);return new t.Class(e,...t.args)};wrapletCreator=this.defaultWrapletCreator;constructor(t,e,i={}){if(this.node=t,h(e))this.mapWrapper=new D(e);else{if(!(e instanceof D))throw new r("The map provided to the Core is not a valid map.");this.mapWrapper=e}this.processInitOptions(i),this.instantiatedChildren={}}async initialize(){this.isGettingInitialized=!0;const t=this.instantiateChildren();this.instantiatedChildren=this.wrapChildren(t);const e=Object.values(this.instantiatedChildren).flatMap(t=>t?p(t)?Array.from(t):[t]:[]);await Promise.all(e.map(t=>t.initialize())),this.isInitialized=!0,this.isGettingInitialized=!1}get map(){return this.mapWrapper.getStartingMap()}instantiateChildren(){const t=this.instantiatedChildren;if("function"!=typeof this.node.querySelectorAll){if(Object.keys(this.map).length>0)throw new r("If the node provided cannot have children, the children map should be empty.");return t}for(const e in this.map){const i=this.map[e],r=i.multiple,s=this.mapWrapper.clone([...this.mapWrapper.path,e]);this.validateMapItem(e,i),t[e]=r?this.instantiateMultipleWrapletsChild(i,s,this.node,e):this.instantiateSingleWrapletChild(i,s,this.node,e)}return t}syncChildren(){this.instantiatedChildren=this.instantiateChildren()}getNodeTreeChildren(){const t=[];for(const e of Object.values(this.children))if(p(e))for(const i of e)t.push(i);else t.push(e);return t.filter(t=>{let e=!1;return t.accessNode(t=>{e=this.node.contains(t)}),e})}findExistingWraplet(t,e){if(void 0===this.instantiatedChildren||!this.instantiatedChildren[t])return null;const i=this.instantiatedChildren[t];if(this.map[t].multiple){if(!p(i))throw new l("Internal logic error. Expected a WrapletSet.");const t=i.find(t=>{let i=!1;return t.accessNode(t=>{t===e&&(i=!0)}),i});if(0===t.length)return null;if(t.length>1)throw new l("Internal logic error. Multiple instances wrapping the same element found in the core.");return t[0]}return i}instantiateSingleWrapletChild(t,e,i,r){if(!t.selector)return null;const s=t.selector,n=this.findChildren(s,i);if(this.validateElements(r,n,t),0===n.length)return null;if(n.length>1)throw new a(`${this.constructor.name}: More than one element was found for the "${r}" child. Selector used: "${s}".`);const o=n[0];return this.instantiateWrapletItem(r,t,e,o)}instantiateWrapletItem(t,e,i,r){const s=this.findExistingWraplet(t,r);if(s)return s;const n=e.Class,a=e.args,o=this.wrapletCreator({id:t,Class:n,element:r,map:i,initOptions:e.coreOptions,args:a,defaultCreator:this.defaultWrapletCreator});this.prepareIndividualWraplet(t,o);for(const e of this.instantiateChildListeners)e(o,t);return o}instantiateMultipleWrapletsChild(t,e,i,r){const s=t.selector;if(!s)return new y;const n=this.findChildren(s,i);this.validateElements(r,n,t);const a=this.instantiatedChildren&&this.instantiatedChildren[r]?this.instantiatedChildren[r]:new y;for(const i of n){if(this.findExistingWraplet(r,i))continue;const s=this.instantiateWrapletItem(r,t,e,i);a.add(s)}return a}addDestroyChildListener(t){this.destroyChildListeners.push(t)}addInstantiateChildListener(t){this.instantiateChildListeners.push(t)}setWrapletCreator(t){this.wrapletCreator=t}prepareIndividualWraplet(t,e){e.addDestroyListener(e=>{this.removeChild(e,t);for(const i of this.destroyChildListeners)i(e,t)})}async destroy(){if(this.isDestroyed)throw new o("Children are already destroyed.");this.isGettingDestroyed=!0;for(const t of this.listeners){const e=t.node,i=t.eventName,r=t.callback,s=t.options;e.removeEventListener(i,r,s)}await this.destroyChildren(),this.isGettingDestroyed=!1,this.isDestroyed=!0}findChildren(t,e){return"string"==typeof t?((t,e)=>Array.from(e.querySelectorAll(t)))(t,e):t(e)}addEventListener(t,e,i,r){this.listeners.push({node:t,eventName:e,callback:i,options:r}),t.addEventListener(e,i,r)}get children(){if(!this.isInitialized)throw new n("Wraplet is not yet fully initialized. You can fetch partial children with the 'uninitializedChildren' property.");return this.instantiatedChildren}get uninitializedChildren(){if(this.isInitialized)throw new n("Wraplet is already initialized. Fetch children with 'children' property instead.");return this.instantiatedChildren}removeChild(t,e){if(p(this.instantiatedChildren[e])){if(!this.instantiatedChildren[e].delete(t))throw new l("Internal logic error. Destroyed child couldn't be removed because it's not among the children.")}else{if(this.map[e].required&&!this.isGettingDestroyed)throw new s("Required child has been destroyed.");if(null===this.instantiatedChildren[e])throw new l("Internal logic error. Destroyed child couldn't be removed because it's already null.");this.instantiatedChildren[e]=null}}validateMapItem(t,e){const i=e.selector,s=e.required;if(!i&&s)throw new r(`${this.constructor.name}: Child "${t}" cannot at the same be required and have no selector.`)}validateElements(t,e,r){if(0===e.length&&r.required)throw new i(`${this.constructor.name}: Couldn't find a node for the wraplet "${t}". Selector used: "${r.selector}".`)}wrapChildren(t){return new Proxy(t,{get:function(t,e){if(!(e in t))throw new Error(`Child '${e}' has not been found.`);return t[e]}})}defaultInitOptions(){return{instantiateChildListeners:[],destroyChildListeners:[]}}processInitOptions(t){const e=Object.assign(this.defaultInitOptions(),t);for(const t of e.instantiateChildListeners)this.instantiateChildListeners.push(t);for(const t of e.destroyChildListeners)this.destroyChildListeners.push(t)}async destroyChildren(){for(const[t,e]of Object.entries(this.children))if(e&&this.map[t].destructible)if(p(e))for(const t of e)await t.destroy();else await e.destroy()}}const O=Symbol("Wraplet");function L(t){return d(t,O)}const x=Symbol("Groupable");class z{core;[O]=!0;[x]=!0;[b]=!0;isGettingDestroyed=!1;isDestroyed=!1;isGettingInitialized=!1;isInitialized=!1;groupsExtractor=t=>{if(t instanceof Element){const e=t.getAttribute("data-js-wraplet-groupable");if(e)return e.split(",")}return[]};destroyListeners=[];__debugNodeAccessors=[];constructor(t){if(this.core=t,!d(t,v))throw new Error("AbstractWraplet requires a Core instance.");t.addDestroyChildListener(this.onChildDestroyed.bind(this)),t.addInstantiateChildListener(this.onChildInstantiated.bind(this))}getNodeTreeChildren(){return this.core.getNodeTreeChildren()}setGroupsExtractor(t){this.groupsExtractor=t}getGroups(){return this.groupsExtractor(this.node)}get children(){return this.core.children}accessNode(t){this.__debugNodeAccessors.push(t),t(this.node)}async destroy(){if(!this.isDestroyed&&(this.isGettingDestroyed=!0,!this.isGettingInitialized)){if(!this.isInitialized)return this.isDestroyed=!0,void(this.isGettingDestroyed=!1);for(const t of this.destroyListeners)await t(this);this.destroyListeners.length=0,await this.core.destroy(),this.isDestroyed=!0,this.isGettingDestroyed=!1}}addDestroyListener(t){this.destroyListeners.push(t)}onChildDestroyed(t,e){}async initialize(){this.isGettingInitialized=!0,await this.core.initialize(),this.isInitialized=!0,this.isGettingInitialized=!1,this.isGettingDestroyed&&await this.destroy()}get node(){return this.core.node}onChildInstantiated(t,e){}isChildInstance(t,e,i=null){return e===(i||e)&&t instanceof this.core.map[e].Class}static createCore(t,e){return new S(t,e)}static createWraplets(t,e,i,r=[]){if(this===z)throw new Error("You cannot instantiate an abstract class.");const s=[];if(t instanceof Element&&t.hasAttribute(i)){const i=z.createCore(t,e);s.push(new this(i,...r))}const n=t.querySelectorAll(`[${i}]`);for(const t of n){const i=z.createCore(t,e);s.push(new this(i,...r))}return s}}class G{levels;[E]=!0;constructor(t=1){if(this.levels=t,t<1)throw new Error("There have to be more than 0 repeated levels.")}create(t){for(let e=0;e<this.levels;e++)t.down();return t.getCurrentMap()}static create(t=1){return new G(t)}}class j extends u{[f]=!0}var P=exports;for(var N in e)P[N]=e[N];e.__esModule&&Object.defineProperty(P,"__esModule",{value:!0});
+var t={d:(e,i)=>{for(var r in i)t.o(i,r)&&!t.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:i[r]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e),r:t=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})}},e={};t.r(e),t.d(e,{AbstractWraplet:()=>j,DefaultArgCreator:()=>L,DefaultCore:()=>O,DefaultWrapletSet:()=>y,DefaultWrapletSetReadonly:()=>N,MapRepeat:()=>P,defaultWrapletCreator:()=>S,destroyWrapletsRecursively:()=>m,getWrapletsFromNode:()=>w,isWraplet:()=>x});class i extends Error{}class r extends Error{}class s extends Error{}class n extends Error{}class a extends Error{}class o extends Error{}class l extends Error{}function h(t){return Object.getPrototypeOf(t)===Object.prototype}const d=(t,e)=>"object"==typeof t&&null!==t&&!0===t[e],c=Symbol("WrapletSet");function p(t){return d(t,c)}class u extends Set{find(t){const e=[];for(const i of this)t(i)&&e.push(i);return e}findOne(t){for(const e of this)if(t(e))return e;return null}getOrdered(t){return Array.from(this).sort((e,i)=>t(e)-t(i))}}const f=Symbol("WrapletSetReadonly");class y extends u{[f]=!0;[c]=!0}function w(t){const e=t.wraplets;return p(e)&&0!==e.size?e:new y}function C(t,e){return!!e.wraplets&&e.wraplets.delete(t)}async function g(t,e){await e(t);const i=t.childNodes;for(const t of i)await g(t,e)}async function m(t){await g(t,async t=>{const e=w(t);for(const i of e)i.wraplet.status.isGettingDestroyed||i.wraplet.status.isDestroyed||await i.wraplet.destroy(),C(i,t)})}const b=Symbol("ChildrenManager"),W=Symbol("NodeTreeParent");function v(t){return{args:[],destructible:!0,map:{},coreOptions:{},...t}}function I(t){const e={};for(const i in t){const r=t[i];e[i]=v(r);const s=r.map;s&&h(s)&&(e[i].map=I(s))}return e}const D=Symbol("DynamicMap");function M(t){return d(t,D)}class E{fullMap;startingPath;currentMap=null;path;currentPath=[];constructor(t,e=[],i=!0){this.path=e,this.startingPath=e,this.fullMap=I(t),i&&(this.currentMap=this.resolve(this.path))}getStartingMap(){return this.resolve(this.startingPath)}getCurrentMap(){return this.currentMap&&this.currentPath==this.path||(this.currentMap=this.resolve(this.path),this.currentPath=this.path),this.currentMap}findMap(t){let e=this.fullMap;for(const i of t){if(!e[i])throw new Error(`Invalid path: ${this.path.join(".")} . No such definition.`);const r=e[i].map;if(h(r))e=r;else{if(!M(r))throw new Error("Invalid map type.");e=r.create(this.clone(t,!1))}}return e}up(t,e=!0){if(!this.pathExists([...this.path,t]))throw new Error("Map doesn't exist.");this.path.push(t),e&&(this.currentMap=this.resolve(this.path))}pathExists(t){let e=this.fullMap;for(const i of t){if(!Object.hasOwn(e,i))return!1;const t=e[i].map;if(M(t))return!0;if(!h(t))throw new Error("Invalid map type.");e=t}return!0}down(t=!0){if(0===this.path.length)throw new Error("At the root already.");this.path.pop(),t&&(this.currentMap=this.resolve(this.path))}clone(t,e=!0){return new E(this.fullMap,t,e)}resolve(t){return this.findMap(t)}}const z=Symbol("ArgCreator");function S(t,e){const i=new e(t.element,t.map,t.initOptions);return new t.Class(i,...t.args)}class O{node;[b]=!0;[W]=!0;statusWritable={isDestroyed:!1,isGettingDestroyed:!1,isInitialized:!1,isGettingInitialized:!1};get status(){return this.statusWritable}mapWrapper;instantiatedChildren={};destroyChildListeners=[];instantiateChildListeners=[];listeners=[];wrapletCreator=S;constructor(t,e,i={}){if(this.node=t,h(e))this.mapWrapper=new E(e);else{if(!(e instanceof E))throw new r("The map provided to the Core is not a valid map.");this.mapWrapper=e}this.processInitOptions(i),this.instantiatedChildren={}}async initialize(){this.statusWritable.isGettingInitialized=!0;const t=this.instantiateChildren();this.instantiatedChildren=this.wrapChildren(t);const e=Object.values(this.instantiatedChildren).flatMap(t=>t?p(t)?Array.from(t):[t]:[]);await Promise.all(e.map(t=>t.wraplet.initialize())),this.statusWritable.isInitialized=!0,this.statusWritable.isGettingInitialized=!1,this.statusWritable.isGettingDestroyed&&await this.destroy()}get map(){return this.mapWrapper.getStartingMap()}instantiateChildren(){const t=this.instantiatedChildren;if("function"!=typeof this.node.querySelectorAll){if(Object.keys(this.map).length>0)throw new r("If the node provided cannot have children, the children map should be empty.");return t}for(const e in this.map){const i=this.map[e],r=i.multiple,s=this.mapWrapper.clone([...this.mapWrapper.path,e]);this.validateMapItem(e,i),t[e]=r?this.instantiateMultipleWrapletsChild(i,s,this.node,e):this.instantiateSingleWrapletChild(i,s,this.node,e)}return t}syncChildren(){this.instantiatedChildren=this.instantiateChildren()}getNodeTreeChildren(){const t=[];for(const e of Object.values(this.children))if(p(e))for(const i of e)t.push(i);else t.push(e);return t.filter(t=>{let e=!1;return t.wraplet.accessNode(t=>{e=this.node.contains(t)}),e})}findExistingWraplet(t,e){if(void 0===this.instantiatedChildren||!this.instantiatedChildren[t])return null;const i=this.instantiatedChildren[t];if(this.map[t].multiple){if(!p(i))throw new l("Internal logic error. Expected a WrapletSet.");const t=i.find(t=>{let i=!1;return t.wraplet.accessNode(t=>{t===e&&(i=!0)}),i});if(0===t.length)return null;if(t.length>1)throw new l("Internal logic error. Multiple instances wrapping the same element found in the core.");return t[0]}return i}instantiateSingleWrapletChild(t,e,i,r){if(!t.selector)return null;const s=t.selector,n=this.findChildren(s,i);if(this.validateElements(r,n,t),0===n.length)return null;if(n.length>1)throw new a(`${this.constructor.name}: More than one element was found for the "${r}" child. Selector used: "${s}".`);const o=n[0];return this.instantiateWrapletItem(r,t,e,o)}instantiateWrapletItem(t,e,i,r){const s=this.findExistingWraplet(t,r);if(s)return s;const n={id:t,Class:e.Class,element:r,map:i,initOptions:e.coreOptions,args:e.args};n.args=n.args.map(t=>d(t,z)?t.createArg(n):t);const a=this.wrapletCreator(n,this.constructor);this.prepareIndividualWraplet(t,a);for(const e of this.instantiateChildListeners)e(a,t);return a}instantiateMultipleWrapletsChild(t,e,i,r){const s=t.selector;if(!s)return new y;const n=this.findChildren(s,i);this.validateElements(r,n,t);const a=this.instantiatedChildren&&this.instantiatedChildren[r]?this.instantiatedChildren[r]:new y;for(const i of n){if(this.findExistingWraplet(r,i))continue;const s=this.instantiateWrapletItem(r,t,e,i);a.add(s)}return a}addDestroyChildListener(t){this.destroyChildListeners.push(t)}addInstantiateChildListener(t){this.instantiateChildListeners.push(t)}setWrapletCreator(t){this.wrapletCreator=t}prepareIndividualWraplet(t,e){e.wraplet.addDestroyListener(e=>{this.removeChild(e,t);for(const i of this.destroyChildListeners)i(e,t)})}async destroy(){if(this.statusWritable.isDestroyed)throw new o("Children are already destroyed.");if(this.statusWritable.isGettingDestroyed=!0,!this.statusWritable.isGettingInitialized){if(!this.statusWritable.isInitialized)return this.statusWritable.isDestroyed=!0,void(this.statusWritable.isGettingDestroyed=!1);for(const t of this.listeners){const e=t.node,i=t.eventName,r=t.callback,s=t.options;e.removeEventListener(i,r,s)}this.listeners.length=0,await this.destroyChildren(),this.statusWritable.isInitialized=!1,this.statusWritable.isDestroyed=!0,this.statusWritable.isGettingDestroyed=!1}}findChildren(t,e){return"string"==typeof t?((t,e)=>Array.from(e.querySelectorAll(t)))(t,e):t(e)}addEventListener(t,e,i,r){this.listeners.push({node:t,eventName:e,callback:i,options:r}),t.addEventListener(e,i,r)}get children(){if(!this.statusWritable.isInitialized)throw new n("Wraplet is not yet fully initialized. You can fetch partial children with the 'uninitializedChildren' property.");return this.instantiatedChildren}get uninitializedChildren(){if(this.statusWritable.isInitialized)throw new n("Wraplet is already initialized. Fetch children with 'children' property instead.");return this.instantiatedChildren}removeChild(t,e){if(p(this.instantiatedChildren[e])){if(!this.instantiatedChildren[e].delete(t))throw new l("Internal logic error. Destroyed child couldn't be removed because it's not among the children.")}else{if(this.map[e].required&&!this.statusWritable.isGettingDestroyed)throw new s("Required child has been destroyed.");if(null===this.instantiatedChildren[e])throw new l("Internal logic error. Destroyed child couldn't be removed because it's already null.");this.instantiatedChildren[e]=null}}validateMapItem(t,e){const i=e.selector,s=e.required;if(!i&&s)throw new r(`${this.constructor.name}: Child "${t}" cannot at the same be required and have no selector.`)}validateElements(t,e,r){if(0===e.length&&r.required)throw new i(`${this.constructor.name}: Couldn't find a node for the wraplet "${t}". Selector used: "${r.selector}".`)}wrapChildren(t){return new Proxy(t,{get:function(t,e){if(!(e in t))throw new Error(`Child '${e}' has not been found.`);return t[e]}})}defaultInitOptions(){return{instantiateChildListeners:[],destroyChildListeners:[]}}processInitOptions(t){const e=Object.assign(this.defaultInitOptions(),t);for(const t of e.instantiateChildListeners)this.instantiateChildListeners.push(t);for(const t of e.destroyChildListeners)this.destroyChildListeners.push(t)}async destroyChildren(){for(const[t,e]of Object.entries(this.children))if(e&&this.map[t].destructible)if(p(e))for(const t of e)await t.wraplet.destroy();else await e.wraplet.destroy()}}class L{creator;[z]=!0;constructor(t){this.creator=t}createArg(t){return this.creator(t)}static create(t){return new L(t)}}const G=Symbol("Wraplet");function x(t){return d(t,G)}const A=Symbol("Groupable");class j{core;[G]=!0;[A]=!0;[W]=!0;destroyListeners=[];wraplet;constructor(t){if(this.core=t,!d(t,b))throw new Error("AbstractWraplet requires a Core instance.");t.addDestroyChildListener(this.onChildDestroy.bind(this)),t.addInstantiateChildListener(this.onChildInstantiate.bind(this)),this.wraplet=this.createWrapletApi({core:this.core,wraplet:this,destroyListeners:this.destroyListeners})}createWrapletApi(t){return(t=>{const e=[],i=t.destroyListeners||[];let r=t.groupExtractor||(t=>{if(t instanceof Element){const e=t.getAttribute("data-js-wraplet-groupable");if(e)return e.split(",")}return[]});const s=t.destroyCallback,n=t.status||{isGettingInitialized:!1,isDestroyed:!1,isInitialized:!1,isGettingDestroyed:!1},a=t.initializeCallback,o=async()=>{if(!n.isDestroyed&&(n.isGettingDestroyed=!0,!n.isGettingInitialized)){if(!n.isInitialized)return n.isDestroyed=!0,void(n.isGettingDestroyed=!1);await t.core.destroy();for(const e of i)await e(t.wraplet);s&&await s(),n.isGettingDestroyed=!1,n.isInitialized=!1,n.isDestroyed=!0}};return{__nodeAccessors:e,status:n,addDestroyListener:t=>{i.push(t)},initialize:async()=>{n.isInitialized||(n.isGettingInitialized=!0,await t.core.initialize(),a&&await a(),n.isInitialized=!0,n.isGettingInitialized=!1,n.isGettingDestroyed&&await o())},destroy:o,accessNode:i=>{e.push(i),i(t.core.node)},getNodeTreeChildren:()=>t.core.getNodeTreeChildren(),setGroupsExtractor:t=>{r=t},getGroups:()=>r(t.core.node)}})(t)}get children(){return this.core.children}onChildDestroy(t,e){}get node(){return this.core.node}onChildInstantiate(t,e){}isChildInstance(t,e,i=null){return e===(i||e)&&t instanceof this.core.map[e].Class}static createCore(t,e){return new O(t,e)}static createWraplets(t,e,i,r=[]){if(this===j)throw new Error("You cannot instantiate an abstract class.");const s=[];if(t instanceof Element&&t.hasAttribute(i)){const i=this.createCore(t,e);s.push(new this(i,...r))}const n=t.querySelectorAll(`[${i}]`);for(const t of n){const i=this.createCore(t,e);s.push(new this(i,...r))}return s}}class P{levels;[D]=!0;constructor(t=1){if(this.levels=t,t<1)throw new Error("There have to be more than 0 repeated levels.")}create(t){for(let e=0;e<this.levels;e++)t.down();return t.getCurrentMap()}static create(t=1){return new P(t)}}class N extends u{[f]=!0}var $=exports;for(var q in e)$[q]=e[q];e.__esModule&&Object.defineProperty($,"__esModule",{value:!0});
 //# sourceMappingURL=index.cjs.map