angular-toolbox 1.5.5 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-toolbox",
-  "version": "1.5.5",
+  "version": "1.6.0",
   "license": "SEE LICENSE IN LICENSE",
   "peerDependencies": {
     "@angular/common": "^19.0.5",

package/lib/angular-toolbox.module.d.ts

@@ -1,9 +0,0 @@
-import * as i0 from "@angular/core";
-/**
- * @private
- */
-export declare class AngularToolboxModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AngularToolboxModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<AngularToolboxModule, never, never, never>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<AngularToolboxModule>;
-}

package/lib/collection/array-list-event-type.enum.d.ts

@@ -1,28 +0,0 @@
-/**
- * @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.
- */
-export declare enum ArrayListEventType {
-    /**
-     * The type of event associated with the `ArrayList.addAll` action.
-     */
-    ADD_ALL = "addAll",
-    /**
-     * The type of event associated with the `ArrayList.addItem`, or `ArrayList.addItemAt` actions.
-     */
-    ADD = "add",
-    /**
-     * The type of event associated with the `ArrayList.removeAll` action.
-     */
-    REMOVE_ALL = "removeAll",
-    /**
-     * The type of event associated with the `ArrayList.remove`, or `ArrayList.removeAt` actions.
-     */
-    REMOVE = "remove"
-}

package/lib/collection/array-list.d.ts

@@ -1,111 +0,0 @@
-/**
- * @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
- */
-import { EventEmitter } from "@angular/core";
-import { IdentifiableComponent } from "../core";
-import { ArrayListEvent } from "./array-list.event";
-/**
- * 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.
- */
-export declare class ArrayList<T> extends IdentifiableComponent {
-    /**
-     * Dispatches events each time this `ArrayList` is modified.
-     */
-    readonly change: EventEmitter<ArrayListEvent<T>>;
-    /**
-     * Gets the number of items in the list.
-     */
-    get length(): number;
-    /**
-     * @private
-     * The array used as a source for the `ArrayList`.
-     */
-    protected __list__: Array<T>;
-    /**
-     * @private
-     */
-    constructor(classRef?: string | undefined);
-    /**
-     * 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: Array<T>): ArrayList<T>;
-    /**
-     * 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: T): ArrayList<T>;
-    /**
-     * 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: T, index: number): ArrayList<T>;
-    /**
-     * 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: number): T | undefined;
-    /**
-     * 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: T): number;
-    /**
-     * Removes all items from the list.
-     *
-     * @return A reference to this `ArrayList` instance.
-     */
-    removeAll(): ArrayList<T>;
-    /**
-     * 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: T): boolean;
-    /**
-     * 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: number): T | undefined;
-    /**
-     * 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(): Array<T>;
-    /**
-     * @private
-     */
-    private dispatchEvent;
-}

package/lib/collection/array-list.event.d.ts

@@ -1,29 +0,0 @@
-/**
- * @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
- */
-import { ArrayList } from "./array-list";
-import { ArrayListEventType } from "./array-list-event-type.enum";
-/**
- * The `ArrayListEvent` class represents an event that is dispatched when the associated collection changes.
- */
-export declare class ArrayListEvent<T> {
-    /**
-     * The type of this event.
-     */
-    readonly type: ArrayListEventType;
-    /**
-     * The reference to the `ArrayList` instance that dispatches this event.
-     */
-    readonly list: ArrayList<T>;
-    /**
-     * 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: ArrayListEventType, list: ArrayList<T>);
-}

package/lib/collection/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * @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
- */
-export * from './array-list';
-export * from './array-list.event';
-export * from './array-list-event-type.enum';

package/lib/component/angular-toolbox-logo/angular-toolbox-logo.component.d.ts

@@ -1,5 +0,0 @@
-import * as i0 from "@angular/core";
-export declare class AngularToolboxLogoComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AngularToolboxLogoComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AngularToolboxLogoComponent, "atx-logo", never, {}, {}, never, never, true, never>;
-}

package/lib/component/dropdown/dropdown.component.d.ts

@@ -1,100 +0,0 @@
-/**
- * @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
- */
-import { EventEmitter } from '@angular/core';
-import { IdentifiableComponent } from '../../core';
-import { DropdownEvent, DropdownHorizontalPosition, DropdownVerticalPosition, PopoverState } from '../../model';
-import * as i0 from "@angular/core";
-/**
- * The ATX dropdown component allows to create popup containers that are displayed by clicking on a button.
- * The content of the container is defined by Developer.
- * This component is part of the LAF-less API.
- */
-export declare class DropdownComponent extends IdentifiableComponent {
-    /**
-     * An event fired on the dropdown component just after it is shown or hidden.
-     */
-    readonly toggle: EventEmitter<DropdownEvent>;
-    /**
-     * An event fired on the dropdown component just before it is shown or hidden.
-     */
-    readonly beforeToggle: EventEmitter<DropdownEvent>;
-    /**
-     * Sets the dropdown button CSS class.
-     */
-    buttonClass: string;
-    /**
-     * Sets the dropdown conpoment CSS class.
-     */
-    containerClass: string;
-    /**
-     * Sets the vertical position of the content container.
-     */
-    vPos: DropdownVerticalPosition;
-    /**
-     * Sets the horizontal position of the content container.
-     */
-    hPos: DropdownHorizontalPosition;
-    /**
-     * Indicates whether the content container can be "light dismissed" by selecting outside the popover area
-     * (`auto`), or not (`manual`).
-     */
-    popoverState: PopoverState;
-    /**
-     * The disabled property sets or returns whether a dropdown is disabled, or not.
-     */
-    set disabled(value: boolean);
-    get disabled(): boolean;
-    /**
-     * @private
-     */
-    protected id: string;
-    /**
-     * @private
-     */
-    private _popover;
-    /**
-     * @private
-     */
-    private _button;
-    /**
-     * @private
-     */
-    private _disabled;
-    /**
-     * @private
-     */
-    constructor();
-    /**
-     * Hides the dropdown container.
-     */
-    hideContent(): void;
-    /**
-     * Displays the dropdown container.
-     */
-    showContent(): void;
-    /**
-     * Returns the display state of the dropdown.
-     *
-     * @returns Returns `true` whether the dropdown is opened; `false` otherwise.
-     */
-    isOpen(): boolean;
-    /**
-     * @private
-     */
-    protected onBeforeToggle(event: Event): void;
-    /**
-     * @private
-     */
-    protected onToggle(event: Event): void;
-    /**
-     * @private
-     */
-    private buildEvent;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "atx-dropdown", never, { "buttonClass": { "alias": "buttonClass"; "required": false; }; "containerClass": { "alias": "containerClass"; "required": false; }; "vPos": { "alias": "vPos"; "required": false; }; "hPos": { "alias": "hPos"; "required": false; }; "popoverState": { "alias": "popoverState"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "toggle": "toggle"; "beforeToggle": "beforeToggle"; }, never, ["*", "[content]"], true, never>;
-}

package/lib/component/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * @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
- */
-export * from './angular-toolbox-logo/angular-toolbox-logo.component';
-export * from './dropdown/dropdown.component';
-export * from './navbar/navbar.component';
-export * from './layout';

package/lib/component/layout/border-layout/border-layout.component.d.ts

@@ -1,96 +0,0 @@
-/**
- * @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
- */
-import { AfterViewInit, OnDestroy, EventEmitter } from '@angular/core';
-import { BorderLayoutContainer } from '../border-layout-container/border-layout-container.component';
-import { LayoutConstraints, LayoutDragEvent, LayoutRegion, LayoutRegionType, SubscriptionService } from '../../../model';
-import { BorderLayoutRenderer } from './util/border-layout-renderer';
-import { IdentifiableComponent } from '../../../core';
-import * as i0 from "@angular/core";
-/**
- * A border layout lays out a container, arranging and resizing its components to fit in five regions: north, south, east, west, and center.
- * Each region is defined by a `BorderLayoutContainer` instance, and is identified by a corresponding constant: `NORTH`, `SOUTH`, `EAST`, `WEST`, and `CENTER`.
- * This component is part of the LAF-less API.
- */
-export declare class BorderLayout extends IdentifiableComponent implements AfterViewInit, OnDestroy {
-    private subscribeSvc;
-    /**
-     * Emits events each time the user starts dragging a region handle.
-     */
-    readonly dragStart: EventEmitter<LayoutDragEvent>;
-    /**
-     * Emits events each time the user stops dragging a region handle.
-     */
-    readonly dragStop: EventEmitter<LayoutDragEvent>;
-    /**
-     * Emits events each time the user is dragging a region handle.
-     */
-    readonly dragging: EventEmitter<LayoutDragEvent>;
-    /**
-     * @private
-     */
-    private onResize;
-    /**
-     * @private
-     */
-    private layoutContainer;
-    /**
-     * @private
-     */
-    private renderer;
-    /**
-     * @private
-     */
-    private set __containers__(value);
-    /**
-     * @private
-     */
-    constructor(subscribeSvc: SubscriptionService, document: Document);
-    /**
-     * @private
-     * For test purpose only.
-     */
-    getRenderer(): BorderLayoutRenderer;
-    /**
-     * @private
-     */
-    ngOnDestroy(): void;
-    /**
-     * @private
-     */
-    ngAfterViewInit(): void;
-    /**
-     * Forces the container to be redrawn.
-     */
-    paint(): void;
-    /**
-     * Resizes the specified region.
-     *
-     * @param region The region to resize.
-     * @param size The new size of the region to resize.
-     *
-     * @returns `true` whether the specified region has been resized; `false` otherwise.
-     */
-    resizeRegion(region: LayoutRegion | LayoutRegionType, size: number): void;
-    /**
-     * Changes the constraints of the region specified by the `LayoutConstraints.region` property.
-     *
-     * @param constraints The new constraints of the associated region.
-     */
-    setConstraints(constraints: LayoutConstraints): void;
-    /**
-     * Returns the `BorderLayoutContainer` component associated with the specified region.
-     *
-     * @param region The region for which to retreive the container.
-     *
-     * @returns The `BorderLayoutContainer` component associated with the specified region,
-     *          or `undefined` whether no container has been found.
-     */
-    getBorderLayoutContainer(region: LayoutRegionType): BorderLayoutContainer | undefined;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BorderLayout, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BorderLayout, "atx-border-layout", never, {}, { "dragStart": "dragStart"; "dragStop": "dragStop"; "dragging": "dragging"; }, ["__containers__"], ["*"], true, never>;
-}

package/lib/component/layout/border-layout/util/border-layout-bounds-manager.d.ts

@@ -1,131 +0,0 @@
-/**
- * @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
- */
-import { BorderLayoutContainer } from '../../border-layout-container/border-layout-container.component';
-import { Destroyable, LayoutRegion } from '../../../../model';
-import { ResizeMethod } from './resize-method';
-/**
- * @private
- * A utility class that computes the size of all border layout containers.
- */
-export declare class BorderLayoutBoundsManager implements Destroyable {
-    /**
-     * @private
-     * The container top position when the user starts to drag the handle.
-     */
-    private topPos;
-    /**
-     * @private
-     * The container left position when the user starts to drag the handle.
-     */
-    private leftPos;
-    /**
-     * @private
-     * The bounds of the center container.
-     */
-    private bounds;
-    /**
-     * Makes this object elligible for garbage collection.
-     */
-    destroy(): void;
-    /**
-     * Returns a rectangle that represents the bounds currently computed by this object.
-     *
-     * @returns The bounds currently computed by this object.
-     */
-    getBounds(): DOMRect;
-    /**
-     * Sets the top-left hand corner position before each bounds computaion.
-     *
-     * @param x The x position of the main container, in pixels, before computaion.
-     * @param y The y position of the main container, in pixels, before computaion.
-     */
-    setOrigin(x: number, y: number): void;
-    /**
-     * @private
-     * For test purpose only.
-     */
-    getOrigin(): any;
-    /**
-     * Computes the size of a "north" container.
-     *
-     * @param event The mouse event that triggered the computation of the container size.
-     * @param width The width of the main container.
-     * @param height The height of the main container.
-     * @param minSize The minimum size of the container for which to compute the size.
-     * @param maxSize The maximum size of the container for which to compute the size.
-     *
-     * @returns The size of a "north" container.
-     */
-    northResize(event: MouseEvent, width: number, height: number, minSize: number | undefined, maxSize: number | undefined): number;
-    /**
-     * @private
-     */
-    private setY;
-    /**
-     * Computes the size of a "south" container.
-     *
-     * @param event The mouse event that triggered the computation of the container size.
-     * @param width The width of the main container.
-     * @param height The height of the main container.
-     * @param minSize The minimum size of the container for which to compute the size.
-     * @param maxSize The maximum size of the container for which to compute the size.
-     *
-     * @returns The size of a "south" container.
-     */
-    southResize(event: MouseEvent, width: number, height: number, minSize: number | undefined, maxSize: number | undefined): number;
-    /**
-     * @private
-     */
-    private setHeight;
-    /**
-     * Computes the size of a "west" container.
-     *
-     * @param event The mouse event that triggered the computation of the container size.
-     * @param width The width of the main container.
-     * @param height The height of the main container.
-     * @param minSize The minimum size of the container for which to compute the size.
-     * @param maxSize The maximum size of the container for which to compute the size.
-     *
-     * @returns The size of a "west" container.
-     */
-    westResize(event: MouseEvent, width: number, height: number, minSize: number | undefined, maxSize: number | undefined): number;
-    /**
-     * @private
-     */
-    private setX;
-    /**
-     * Computes the size of a "east" container.
-     *
-     * @param event The mouse event that triggered the computation of the container size.
-     * @param width The width of the main container.
-     * @param height The height of the main container.
-     * @param minSize The minimum size of the container for which to compute the size.
-     * @param maxSize The maximum size of the container for which to compute the size.
-     *
-     * @returns The size of a "east" container.
-     */
-    eastResize(event: MouseEvent, width: number, height: number, minSize: number | undefined, maxSize: number | undefined): number;
-    /**
-     * @private
-     */
-    private setWidth;
-    /**
-     * Invoked after each `BorderLayoutContainer` registration to initialize the center container bounds.
-     *
-     * @param container A `BorderLayoutContainer` instance added to the main container.
-     */
-    initBounds(container: BorderLayoutContainer): void;
-    /**
-     * Returns the method used to compute the size of a container, depending on the specified region.
-     *
-     * @param region The region associated with the container for which to compute the size.
-     *
-     * @returns The method used to compute the size of a container.
-     */
-    getResizeMethod(region: LayoutRegion): ResizeMethod;
-}

package/lib/component/layout/border-layout/util/border-layout-renderer.d.ts

@@ -1,118 +0,0 @@
-/**
- * @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
- */
-import { EventEmitter, QueryList } from '@angular/core';
-import { BorderLayoutContainer } from '../../border-layout-container/border-layout-container.component';
-import { Destroyable, LayoutConstraints, LayoutDragEvent, LayoutRegion, LayoutRegionType, SubscriptionService } from '../../../../model';
-import { IdentifiableComponent } from '../../../../core';
-import { BorderLayoutBoundsManager } from './border-layout-bounds-manager';
-/**
- * @private
- * A controller object responsible for handling user actions on a `BorderLayout` container.
- */
-export declare class BorderLayoutRenderer extends IdentifiableComponent implements Destroyable {
-    private subscribeSvc;
-    private document;
-    /**
-     * Emits events each time the user starts, or stops dragging handle.
-     */
-    readonly userAction: EventEmitter<LayoutDragEvent>;
-    /**
-     * @private
-     */
-    private lytContainerElm;
-    /**
-     * @private
-     */
-    private containerList;
-    /**
-     * @private
-     */
-    private boundsManager;
-    /**
-     * @private
-     */
-    private storedStopHandler;
-    /**
-     * @private
-     */
-    private storedMoveHandler;
-    /**
-     * @private
-     */
-    constructor(subscribeSvc: SubscriptionService, document: Document);
-    /**
-     * Add the list `BorderLayoutContainer` objects associated with the main container to this controller.
-     *
-     * @param containers the list `BorderLayoutContainer` objects associated with the main container.
-     */
-    addContainers(containers: QueryList<BorderLayoutContainer>): void;
-    /**
-     * Sets the reference to the HTML container associated with the main container.
-     *
-     * @param lytContainer The reference to the HTML container associated with the main container.
-     */
-    setLayoutContainer(lytContainer: HTMLDivElement): void;
-    /**
-     * @private
-     * For test purpose only.
-     * Returns the reference to the internal `BorderLayoutBoundsManager` instance.
-     */
-    getBoundsManager(): BorderLayoutBoundsManager;
-    /**
-     * Changes the constraints of the region specified by the `LayoutConstraints.region` property.
-     *
-     * @param constraints The new constraints of the associated region.
-     */
-    setConstraints(constraints: LayoutConstraints): void;
-    /**
-     * Makes this object elligible for garbage collection.
-     */
-    destroy(): void;
-    /**
-     * Forces the layout of all `BorderLayoutContainer` objects associated with the main container.
-     */
-    paint(): void;
-    /**
-     * Returns the `BorderLayoutContainer` component associated with the specified region.
-     *
-     * @param region The region for which to retreive the container.
-     *
-     * @returns The `BorderLayoutContainer` component associated with the specified region,
-     *          or `undefined` whether no container has been found.
-     */
-    getBorderLayoutContainer(region: LayoutRegionType): BorderLayoutContainer | undefined;
-    /**
-     * Resizes the specified region of the associated container.
-     *
-     * @param region The region to resize.
-     * @param size The new size of the region to resize.
-     *
-     * @returns `true` whether the specified region has been resized; `false` otherwise.
-     */
-    resizeRegion(region: LayoutRegion, size: number): boolean;
-    /**
-     * @private
-     */
-    private resizeEnter;
-    /**
-     * @private
-     */
-    private fireEvent;
-    /**
-     * @private
-     */
-    private render;
-    /**
-     * @private
-     */
-    private checkLytContainer;
-    /**
-     * @private
-     */
-    private deleteStoredHandlers;
-}

package/lib/component/layout/border-layout/util/resize-method.d.ts

@@ -1,13 +0,0 @@
-/**
- * @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
- */
-/**
- * @private
- * A convenient type that describes methods used to compute the size of a `BorderlayoutContainer` object,
- * depending on its region.
- */
-export type ResizeMethod = (event: MouseEvent, width: number, height: number, minSize: number | undefined, maxSize: number | undefined) => number;