angular-toolbox 0.9.4 → 0.10.0

package/fesm2022/angular-toolbox.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Injectable, NgModule, Component, EventEmitter, Directive, Output, Input, HostListener, Inject, inject, Pipe } from '@angular/core';
+import { Injectable, NgModule, EventEmitter, Component, Directive, Output, Input, HostListener, Inject, inject, Pipe } from '@angular/core';
 import * as i1 from '@angular/router';
 import { RouterModule } from '@angular/router';
 import { DOCUMENT, XhrFactory } from '@angular/common';
@@ -542,9 +542,9 @@ class AbstractVersionManager {
  */
 const LAYERS_VERSION_CONFIG = {
     major: 0,
-    minor: 9,
-    patch: 4,
-    buildTimestamp: 1720937502057,
+    minor: 10,
+    patch: 0,
+    buildTimestamp: 1721217723149,
     metadata: "beta"
 };
 /**
@@ -586,6 +586,221 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.3", ngImpor
                 }]
         }] });
 
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+/**
+ * The `ArrayListEvent` class represents an event that is dispatched when the associated collection changes.
+ */
+class ArrayListEvent {
+    /**
+     * Represents events dispatched by the `ArrayList` class.
+     *
+     * @param type The type of the event.
+     * @param list The reference to the `ArrayList` instance that dispatches this event.
+     */
+    constructor(type, list) {
+        this.type = type;
+        this.list = list;
+    }
+}
+
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+/**
+ * The `ArrayListEventType` class the type of events on an `ArrayListEvent` object.
+ */
+var ArrayListEventType;
+(function (ArrayListEventType) {
+    /**
+     * The type of event associated with the `ArrayList.addAll` action.
+     */
+    ArrayListEventType["ADD_ALL"] = "addAll";
+    /**
+     * The type of event associated with the `ArrayList.addItem`, or `ArrayList.addItemAt` actions.
+     */
+    ArrayListEventType["ADD"] = "add";
+    /**
+     * The type of event associated with the `ArrayList.removeAll` action.
+     */
+    ArrayListEventType["REMOVE_ALL"] = "removeAll";
+    /**
+     * The type of event associated with the `ArrayList.remove`, or `ArrayList.removeAt` actions.
+     */
+    ArrayListEventType["REMOVE"] = "remove";
+})(ArrayListEventType || (ArrayListEventType = {}));
+
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+/**
+ * The `ArrayList` class uses a backing `Array` as the source of the data collection. Items in the backing
+ * `Array` can be accessed and manipulated using the methods and properties of the `ArrayList` instance.
+ * Operations on an `ArrayList` instance modify the data source.
+ *
+ * You typically use the `ArrayList` class as base class for services that persist data in the User Interface.
+ */
+class ArrayList extends IdentifiableComponent {
+    /**
+     * Gets the number of items in the list.
+     */
+    get length() {
+        return this.__list__.length;
+    }
+    /**
+     * @private
+     */
+    constructor(classRef = undefined) {
+        super(classRef || "ArrayList");
+        /**
+         * Dispatches events each time this `ArrayList` is modified.
+         */
+        this.change = new EventEmitter();
+        /**
+         * @private
+         * The array used as a source for the `ArrayList`.
+         */
+        this.__list__ = [];
+    }
+    /**
+     * Adds a list of items to the current `ArrayList` instance, placing them at the end of the
+     * list in the order they are passed.
+     *
+     * @param addList The list of items to add to this current `ArrayList` instance.
+     *
+     * @return A reference to this `ArrayList` instance.
+     */
+    addAll(addList) {
+        this.__list__.push(...addList);
+        this.dispatchEvent(ArrayListEventType.ADD_ALL);
+        return this;
+    }
+    /**
+     * Adds the specified item to the end of the list.
+     *
+     * @param item The item to add.
+     *
+     * @return A reference to this `ArrayList` instance.
+     */
+    addItem(item) {
+        this.__list__.push(item);
+        this.dispatchEvent(ArrayListEventType.ADD);
+        return this;
+    }
+    /**
+     * Adds the item at the specified index.
+     *
+     * @param item The item to place at the index.
+     * @param index The index at which to place the item.
+     *
+     * @return A reference to this `ArrayList` instance.
+     */
+    addItemAt(item, index) {
+        if (index < 0)
+            throw new RangeError("index must be greater that 0");
+        const len = this.__list__.length;
+        if (index > len)
+            throw new RangeError(`index exceeds the number of list elements. Index must not exceed ${len}.`);
+        this.__list__.splice(index, 0, item);
+        this.dispatchEvent(ArrayListEventType.ADD);
+        return this;
+    }
+    /**
+     * Gets the item at the specified index.
+     *
+     * @param index The index in the list from which to retrieve the item.
+     *
+     * @returns The item at that index, `undefined` if there is none.
+     */
+    getItemAt(index) {
+        return this.__list__[index];
+    }
+    /**
+     * Returns the index of the item if it is in the list.
+     *
+     * @param item The item to find.
+     *
+     * @returns The index of the item, `-1` if the item is not in the list.
+     */
+    getItemIndex(item) {
+        return this.__list__.findIndex(elm => elm === item);
+    }
+    /**
+     * Removes all items from the list.
+     *
+     * @return A reference to this `ArrayList` instance.
+     */
+    removeAll() {
+        this.__list__.length = 0;
+        this.dispatchEvent(ArrayListEventType.REMOVE_ALL);
+        return this;
+    }
+    /**
+     * Removes the specified item from this list.
+     *
+     * @param item Reference to the item that should be removed.
+     *
+     * @returns  `true` whether if the item was removed; `false` otherwise.
+     */
+    removeItem(item) {
+        const idx = this.getItemIndex(item);
+        if (idx === -1)
+            return false;
+        this.__list__.splice(idx, 1);
+        this.dispatchEvent(ArrayListEventType.REMOVE);
+        return true;
+    }
+    /**
+     * Removes the item at the specified index and returns it.
+     * Any items that were after this index are now one index earlier.
+     *
+     * @param index The index from which to remove the item.
+
+     * @returns The item that was removed.
+     */
+    removeItemAt(index) {
+        const result = this.__list__.splice(index, 1)[0];
+        this.dispatchEvent(ArrayListEventType.REMOVE);
+        return result;
+    }
+    /**
+     * Returns an array that is populated in the same order as this `ArrayList` instance.
+     *
+     * @returns An array that is populated in the same order as this `ArrayList` instance.
+     */
+    toArray() {
+        return this.__list__.slice(0);
+    }
+    /**
+     * @private
+     */
+    dispatchEvent(type) {
+        const event = new ArrayListEvent(type, this);
+        this.change.emit(event);
+    }
+}
+
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+
 /**
  * @license
  * Copyright Pascal ECHEMANN. All Rights Reserved.
@@ -1146,6 +1361,30 @@ const DARK_MODE_CONFIG = {
  * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
  */
 
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be found in
+ * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be found in
+ * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+
+/**
+ * @license
+ * Copyright Pascal ECHEMANN. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be found in
+ * the LICENSE file at https://pascalechemann.com/angular-toolbox/resources/license
+ */
+
 /**
  * @license
  * Copyright Pascal ECHEMANN. All Rights Reserved.
@@ -3841,5 +4080,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.3", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { APP_PRIDGE_REF, AbstractSubscriptionManager, AbstractVersionManager, AnchorLinklDirective, AngularToolboxLogoComponent, AngularToolboxModule, AppBridgeError, AppBrigeService, BIGINT, BOOLEAN, BUTTON_ROLE, ButtonRoleDirective, CSS_PROP, ContentRendererDirective, DARK_MODE_CONFIG, DarkModeService, EMPTY_STRING, FUNCTION, HTTP_MOCK_SERVICE, HttpHeadersMockBuilder, HttpMock, HttpMockService, HttpMockServiceError, HttpResponseMockBuilder, IdentifiableComponent, IntegrityError, LINK_ROLE, NUMBER, NavigateToUrlDirective, OBJECT, STORAGE_KEY, STRING, SYMBOL, SafeHtmlPipe, ScrollService, SubscriptionError, SubscriptionService, UNDEFINED, Uuid, VERSION_CONFIG, VersionService, httpHeadersMock, httpMockFactory, httpResponseMock };
+export { APP_PRIDGE_REF, AbstractSubscriptionManager, AbstractVersionManager, AnchorLinklDirective, AngularToolboxLogoComponent, AngularToolboxModule, AngularToolboxVersionService, AppBridgeError, AppBrigeService, ArrayList, ArrayListEvent, ArrayListEventType, BIGINT, BOOLEAN, BUTTON_ROLE, ButtonRoleDirective, CSS_PROP, ContentRendererDirective, DARK_MODE_CONFIG, DarkModeService, EMPTY_STRING, FUNCTION, HTTP_MOCK_SERVICE, HttpHeadersMockBuilder, HttpMock, HttpMockService, HttpMockServiceError, HttpResponseMockBuilder, IdentifiableComponent, IntegrityError, LINK_ROLE, NUMBER, NavigateToUrlDirective, OBJECT, STORAGE_KEY, STRING, SYMBOL, SafeHtmlPipe, ScrollService, SubscriptionError, SubscriptionService, UNDEFINED, Uuid, VERSION_CONFIG, VersionService, httpHeadersMock, httpMockFactory, httpResponseMock };
 //# sourceMappingURL=angular-toolbox.mjs.map