@simpleangularcontrols/sac-common 10.0.0-rc.3 → 10.0.0-rc.30

package/simpleangularcontrols-sac-common.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/utilities/convertion.d.ts

@@ -1,15 +1,15 @@
-/**
- * Erzeugt ein Boolean
- * @param value
- */
-export declare function convertToBoolean(value: any): boolean;
-/**
- * Erzeugt ein Number
- * @param value
- */
-export declare function convertToNumber(value: any): number;
-/**
- * Erzeugt aus einer Map ein Objekt
- * @param map Map mit Key und Values. Key ist ein String. Value kann ein Objekt sein.
- */
-export declare function mapToObject(map: Map<string, any>): any;
+/**
+ * Creates a boolean
+ * @param value
+ */
+export declare function convertToBoolean(value: any): boolean;
+/**
+ * Creates a number
+ * @param value
+ */
+export declare function convertToNumber(value: any): number;
+/**
+ * Creates an object from a Map
+ * @param map Map with keys and values. Key is a string. Value can be an object.
+ */
+export declare function mapToObject(map: Map<string, any>): any;

package/utilities/convertion.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/utilities/datatypes.d.ts

@@ -1,6 +1,6 @@
-/**
- * Prüft ob ein Objekt Defined ist
- * @param value Objekt
- * @return Objekt ist definied. TRUE wenn Objekt definied. FALSE wenn Objekt NULL oder UNDEFINED.
- */
-export declare function isDefined(value: any): boolean;
+/**
+ * Checks if an object is defined
+ * @param value Object
+ * @return Object is defined. TRUE if object is defined. FALSE if object is NULL or UNDEFINED.
+ */
+export declare function isDefined(value: any): boolean;

package/utilities/datatypes.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/utilities/enums.d.ts

@@ -1,10 +1,19 @@
-/**
- * Enum für Tooltip Positionen
- */
-export declare enum TooltipPosition {
-    none = 0,
-    top = 1,
-    right = 2,
-    bottom = 4,
-    left = 8
-}
+/**
+ * Enum for tooltip positions.
+ */
+export declare enum TooltipPosition {
+    /** No position / not displayed. */
+    none = 0,
+    /** Positioned above the reference element. */
+    top = 1,
+    /** Positioned to the right of the reference element. */
+    right = 2,
+    /** Positioned below the reference element. */
+    bottom = 4,
+    /** Positioned to the left of the reference element. */
+    left = 8,
+    /** Positioned at top-end (top aligned with end/RTL-aware). */
+    topend = 16,
+    /** Positioned at bottom-end (bottom aligned with end/RTL-aware). */
+    bottomend = 32
+}

package/utilities/enums.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/utilities/guid.d.ts

@@ -1,4 +1,4 @@
-/**
- * create a guid with crypto library if availabe and a fallback to Math.Random implementation
- */
-export declare function createGuid(): string;
+/**
+ * Create a GUID with crypto library if available and a fallback to Math.Random implementation
+ */
+export declare function createGuid(): string;

package/utilities/guid.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/utilities/interpolation.d.ts

@@ -1,21 +1,22 @@
-/**
- *  Klasse zum ersetzen von Platzhaltern in Strings
- */
-export declare class Interpolation {
-    /**
-     *  Template zum Parsen der Platzhalter
-     */
-    private templateMatcher;
-    /**
-     * Platzhalter in String ersetzen
-     * @param text Text in welchem die Platzhalter ersetzt werden
-     * @param params Objekt mit Parameter.
-     */
-    interpolateString(text: string, params?: any): string;
-    /**
-     * Wert aus Objekt in Objekt oder Objektstruktur lesen
-     * @param target Objekt das zu parsen ist.
-     * @param key Key nach welchem gesucht wird. Navigation in Properties des Objekt mit einem Punkt.
-     */
-    private getValue;
-}
+/**
+ * Class for replacing placeholders in strings
+ */
+export declare class Interpolation {
+    /**
+     * Template for parsing placeholders
+     */
+    private templateMatcher;
+    /**
+     * Replace placeholders in string
+     * @param text Text in which placeholders are replaced
+     * @param params Object with parameters
+     * @returns The interpolated string with placeholders replaced
+     */
+    interpolateString(text: string, params?: any): string;
+    /**
+     * Read value from object in object or object structure
+     * @param target Object to be parsed.
+     * @param key Key to search for. Navigation in object properties with a dot.
+     */
+    private getValue;
+}

package/utilities/interpolation.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/utilities/popuphelper.d.ts

@@ -0,0 +1,120 @@
+import { TooltipPosition } from './enums';
+import { ElementRef } from '@angular/core';
+/**
+ * Utility for positioning popup elements relative to anchor elements.
+ *
+ * Provides functions for measuring container dimensions, validating available positions,
+ * and computing translated positions for tooltip/popups in various placements.
+ */
+export declare class PopUpHelper {
+    /**
+     * Get the height of the reference container element
+     * @param referenceContainer Element Reference to HTML Element
+     * @param referenceIsContainer Boolean indicating if reference is the container itself
+     * @returns The height in pixels
+     */
+    getContainerHeight(referenceContainer: ElementRef<HTMLElement>, referenceIsContainer: boolean): number;
+    /**
+     * Get the width of the reference container element
+     * @param referenceContainer Element Reference to HTML Element
+     * @param referenceIsContainer Boolean indicating if reference is the container itself
+     * @returns The width in pixels
+     */
+    getContainerWidth(referenceContainer: ElementRef<HTMLElement>, referenceIsContainer: boolean): number;
+    /**
+     * Get Position where the popup would be positioned
+     *
+     * @param referenceContainer Element Reference to HTML Element which is the reference to positioning the popup
+     * @param popupcontentcontainer Element Reference to container of popup
+     * @param arrowWidth Width of the arrow element
+     * @param arrowHeight Height of the arrow element
+     * @param allowedPositions Allowed Positions for the popup
+     * @param referenceIsContainer Boolean indicating if reference is the container itself
+     * @returns Returns the position where the popup should be displayed
+     */
+    getDisplayPosition(referenceContainer: ElementRef<HTMLElement>, popupcontentcontainer: ElementRef<HTMLElement>, arrowWidth: number, arrowHeight: number, allowedPositions: string, referenceIsContainer: boolean): TooltipPosition;
+    /**
+     * Calculates the height of the popup
+     *
+     * @param container Element Reference to container of popup
+     * @returns The height of the popup in pixels
+     */
+    getPopupHeight(container: ElementRef<HTMLElement>): number;
+    /**
+     * Calculates the width of the popup
+     *
+     * @param container Element Reference to container of popup
+     * @returns The width of the popup in pixels
+     */
+    getPopupWidth(container: ElementRef<HTMLElement>): number;
+    /**
+     * Returns the defined position for the tooltip
+     *
+     * @param allowedPositions Allowed positions defined in markup for popup
+     * @returns The calculated tooltip position
+     */
+    getPosition(allowedPositions: string): TooltipPosition;
+    /**
+     * Calculates the left position of the tooltip/popup
+     *
+     * @param referenceContainer Element Reference to HTML Element which is the reference to positioning the popup
+     * @param popupContainer Element Reference to container of popup
+     * @param controlReference Element Reference to the control element
+     * @param arrowWidth Width of the arrow element
+     * @param arrowHeight Height of the arrow element
+     * @param requestedPosition Requested Position by Control
+     * @param referenceIsContainer Boolean indicating if reference is the container itself
+     * @returns The left position in pixels
+     */
+    getPositionLeft(referenceContainer: ElementRef<HTMLElement>, popupContainer: ElementRef<HTMLElement>, controlReference: ElementRef, arrowWidth: number, arrowHeight: number, requestedPosition: string, referenceIsContainer: boolean): number;
+    /**
+     * Calculates the top position of the tooltip/popup
+     *
+     * @param referenceContainer Element Reference to HTML Element which is the reference to positioning the popup
+     * @param popupContainer Element Reference to container of popup
+     * @param controlReference Element Reference to the control element
+     * @param arrowWidth Width of the arrow element
+     * @param arrowHeight Height of the arrow element
+     * @param requestedPosition Requested Position by Control
+     * @param referenceIsContainer Boolean indicating if reference is the container itself
+     * @returns The top position in pixels
+     */
+    getPositionTop(referenceContainer: ElementRef<HTMLElement>, popupContainer: ElementRef<HTMLElement>, controlReference: ElementRef, arrowWidth: number, arrowHeight: number, requestedPosition: string, referenceIsContainer: boolean): number;
+    /**
+     * Returns whether the position has been configured
+     *
+     * @param allowedPositions Positions that allowed by control
+     * @param requestedPosition Position to be checked
+     * @returns Boolean indicating if the requested position is configured
+     */
+    hasPosition(allowedPositions: string, requestedPosition: TooltipPosition): boolean;
+    /**
+     * Defines whether AutoPosition is active
+     * @param positionProperty List of allowed positions
+     * @returns Boolean indicating if auto positioning is enabled
+     */
+    isAutoPosition(positionProperty: string): boolean;
+    /**
+     * Checks whether the position is valid or whether the tooltip on the position has space
+     * @param referenceContainer Element Reference to HTML Element which is the reference
+     * @param popupcontentcontainer Element Reference to container of popup
+     * @param arrowWidth Width of the arrow element
+     * @param arrowHeight Height of the arrow element
+     * @param referenceIsContainer Boolean indicating if reference is the container itself
+     * @returns The valid tooltip position
+     */
+    validatePositions(referenceContainer: ElementRef<HTMLElement>, popupcontentcontainer: ElementRef<HTMLElement>, arrowWidth: number, arrowHeight: number, referenceIsContainer: boolean): TooltipPosition;
+    /**
+     * Calculates the top of the page inside all elements
+     * @param element HTML Element
+     * @returns summarized top value for absolute position
+     */
+    private getOffsetTopParent;
+    /**
+     * Caclulate Scrollbars inside tree
+     * @param element HTML Element
+     * @param [isFixed=false] Invert Scroll Position value when style is fixed to preserve negative values
+     * @returns Scroll top value of element with all childs
+     */
+    private getScrollTopParent;
+}

package/utilities/popuphelper.ngfactory.d.ts

@@ -0,0 +1 @@
+export {};

package/utilities/positioncalculator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Represents geometry of a rectangular area in client coordinates.
+ */
+export interface ClientRect {
+    /** Distance from top of viewport to bottom edge in pixels. */
+    bottom: number;
+    /** Height of rectangle in pixels. */
+    height: number;
+    /** Distance from left of viewport to left edge in pixels. */
+    left: number;
+    /** Distance from left of viewport to right edge in pixels. */
+    right: number;
+    /** Distance from top of viewport to top edge in pixels. */
+    top: number;
+    /** Width of rectangle in pixels. */
+    width: number;
+}
+/**
+ * Utility class for element positioning and offset calculations.
+ *
+ * Provides helpers to compute absolute offset, relative position and placement
+ * of one element relative to another, including viewport clipping checks.
+ *
+ * @see https://github.com/ng-bootstrap/ng-bootstrap/blob/master/src/util/positioning.ts
+ */
+export declare class PositionCalculator {
+    /**
+     * Computes the offset of an element relative to the document.
+     *
+     * @param element Element to measure.
+     * @param round If true, the computed values are rounded to integers.
+     * @returns ClientRect with top/left/right/bottom/width/height position values.
+     */
+    offset(element: HTMLElement, round?: boolean): ClientRect;
+    /**
+     * Computes the position of an element relative to its offset parent.
+     *
+     * @param element Element to measure.
+     * @param round If true, the computed position values are rounded.
+     * @returns ClientRect with relative top/left/right/bottom/width/height values.
+     */
+    position(element: HTMLElement, round?: boolean): ClientRect;
+    /**
+     * Positions targetElement relative to hostElement based on placement and optionally appends to body.
+     *
+     * @param hostElement Reference element used as anchor.
+     * @param targetElement Element being positioned.
+     * @param placement Positioning string like 'top', 'bottom-right'.
+     * @param appendToBody If true, hostElement coords are based on document body.
+     * @returns True when target element stays within viewport after positioning.
+     */
+    positionElements(hostElement: HTMLElement, targetElement: HTMLElement, placement: string, appendToBody?: boolean): boolean;
+    /**
+     * Returns the computed style declarations for the given element.
+     *
+     * @param element Element to retrieve styles from.
+     * @returns CSSStyleDeclaration of computed styles.
+     */
+    private getAllStyles;
+    /**
+     * Returns the computed value of a CSS property for an element.
+     *
+     * @param element Element to query.
+     * @param prop Name of CSS property.
+     * @returns Property value string.
+     */
+    private getStyle;
+    /**
+     * Checks whether an element is statically positioned in CSS.
+     *
+     * @param element Element to inspect.
+     * @returns True when the position is 'static'.
+     */
+    private isStaticPositioned;
+    /**
+     * Gets the closest positioned ancestor element (offset parent) for a given element.
+     *
+     * @param element Element to find offset parent for.
+     * @returns Offset parent HTMLElement, or document.documentElement fallback.
+     */
+    private offsetParent;
+}

package/utilities/positioncalculator.ngfactory.d.ts

@@ -0,0 +1 @@
+export {};

package/utilities/positionelements.d.ts

@@ -0,0 +1,30 @@
+import { PositionCalculator } from './positioncalculator';
+/**
+ * Accept the placement array and applies the appropriate placement dependent on the viewport.
+ * Returns the applied placement.
+ * In case of auto placement, placements are selected in order
+ * 'top', 'bottom', 'left', 'right',
+ * 'top-left', 'top-right',
+ * 'bottom-left', 'bottom-right',
+ * 'left-top', 'left-bottom',
+ * 'right-top', 'right-bottom'.
+ * @param hostElement The host element
+ * @param targetElement The target element to be positioned
+ * @param placement The placement option(s)
+ * @param appendToBody Whether to append to body
+ * @param baseClass The base CSS class
+ * @returns The applied placement or null if not positioned
+ */
+export declare function positionElements(hostElement: HTMLElement, targetElement: HTMLElement, placement: string | Placement | PlacementArray, appendToBody?: boolean, baseClass?: string): Placement | null;
+/**
+ * Global Position Service
+ */
+export declare const positionService: PositionCalculator;
+/**
+ * Placement Typen
+ */
+export declare type Placement = 'auto' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'left-top' | 'left-bottom' | 'right-top' | 'right-bottom';
+/**
+ * Placement Array
+ */
+export declare type PlacementArray = Placement | Array<Placement> | string;

package/utilities/positionelements.ngfactory.d.ts

@@ -0,0 +1 @@
+export {};

package/utilities/testingattribute.pipe.d.ts

@@ -0,0 +1,27 @@
+import { Injector, PipeTransform } from '@angular/core';
+/**
+ * Pipe to return E2E attribute values based on configuration.
+ *
+ * - If E2E attributes are disabled, it returns null.
+ * - If explicit e2e attribute is provided, it is returned.
+ * - Otherwise, fallback to control name.
+ */
+export declare class SacTestingAttributePipe implements PipeTransform {
+    /**
+     * Defines whether the attribute is active
+     */
+    private isEnabled;
+    /**
+     * Constructor
+     * @param injector Service injector for dependency resolution
+     */
+    constructor(injector: Injector);
+    /**
+     * Transforms input to final E2E attribute value when enabled.
+     *
+     * @param controlname Optional control name for fallback attribute value.
+     * @param e2eattribute Optional explicit e2e attribute value.
+     * @returns Returned value is either `e2eattribute` or `controlname` when enabled, otherwise null.
+     */
+    transform(controlname: string, e2eattribute: string): string;
+}

package/utilities/testingattribute.pipe.ngfactory.d.ts

@@ -0,0 +1 @@
+export {};

package/utilities/utilities.module.d.ts

@@ -0,0 +1,2 @@
+export declare class SACCommonUtliltiesModule {
+}

package/utilities/utilities.module.ngfactory.d.ts

@@ -0,0 +1,3 @@
+import * as i0 from '@angular/core';
+import * as i1 from './utilities.module';
+export declare const SACCommonUtliltiesModuleNgFactory: i0.NgModuleFactory<i1.SACCommonUtliltiesModule>;

package/validation/email.validator.d.ts

@@ -1,2 +1,9 @@
-import { ValidatorFn } from '@angular/forms';
-export declare function emailValidator(validationMessage: string, validationMessageSummary: string): ValidatorFn;
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the control value is a valid email.
+ *
+ * @param validationMessage Message shown for the field when validation fails.
+ * @param validationMessageSummary Message shown in summary when validation fails.
+ * @returns Validator function to validate email format.
+ */
+export declare function emailValidator(validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/email.validator.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/equals.validator.d.ts

@@ -0,0 +1,10 @@
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the control value equals a required value.
+ *
+ * @param requiredvalue Value that control must equal.
+ * @param validationMessage Message shown when validation fails.
+ * @param validationMessageSummary Summary message shown when validation fails.
+ * @returns Validator function to validate equality.
+ */
+export declare function equalsValueValidator(requiredvalue: any, validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/equals.validator.ngfactory.d.ts

@@ -0,0 +1 @@
+export {};

package/validation/index.d.ts

@@ -1,2 +1,2 @@
-export { Validation } from './validation.class';
-export { ValidationErrorItem } from './validationerroritem';
+export { Validation } from './validation.class';
+export { ValidationErrorItem } from './validationerroritem';

package/validation/index.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/invaliddate.validator.d.ts

@@ -1,2 +1,9 @@
-import { ValidatorFn } from '@angular/forms';
-export declare function isValidDateValidator(validationMessage: string, validationMessageSummary: string): ValidatorFn;
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the control value is a valid date.
+ *
+ * @param validationMessage Message shown when date format is invalid.
+ * @param validationMessageSummary Summary message shown when date format is invalid.
+ * @returns Validator function for date format validation.
+ */
+export declare function isValidDateValidator(validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/invaliddate.validator.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/isDateValid.d.ts

@@ -1,5 +1,8 @@
-/**
- * Moment
- */
-export declare const moment: any;
-export declare function isDateValid(value: any, format: string): boolean;
+/**
+ * Checks whether a value is a valid date for a given format or ISO 8601.
+ *
+ * @param value Input value to validate.
+ * @param format Date format string for the validator.
+ * @returns True if value is valid date, otherwise false.
+ */
+export declare function isDateValid(value: any, format: string): boolean;

package/validation/isDateValid.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/maxdate.validator.d.ts

@@ -1,2 +1,10 @@
-import { ValidatorFn } from '@angular/forms';
-export declare function maxDateValidator(maxDate: Date, validationMessage: string, validationMessageSummary: string): ValidatorFn;
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the control date is <= maxDate.
+ *
+ * @param maxDate Maximum allowed date.
+ * @param validationMessage Message shown when date is too late.
+ * @param validationMessageSummary Summary message shown when date is too late.
+ * @returns Validator function for maximum date validation.
+ */
+export declare function maxDateValidator(maxDate: Date, validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/maxdate.validator.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/maxtime.validator.d.ts

@@ -1,2 +1,10 @@
-import { ValidatorFn } from '@angular/forms';
-export declare function maxTimeValidator(maxTime: Date, validationMessage: string, validationMessageSummary: string): ValidatorFn;
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the control time is <= maxTime.
+ *
+ * @param maxTime Maximum allowed time.
+ * @param validationMessage Message shown when time is too late.
+ * @param validationMessageSummary Summary message shown when time is too late.
+ * @returns Validator function for maximum time validation.
+ */
+export declare function maxTimeValidator(maxTime: Date, validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/maxtime.validator.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/maxvalue.validator.d.ts

@@ -1,2 +1,10 @@
-import { ValidatorFn } from '@angular/forms';
-export declare function maxValueValidator(maxvalue: number, validationMessage: string, validationMessageSummary: string): ValidatorFn;
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the control value is <= maxvalue.
+ *
+ * @param maxvalue Maximum allowed numeric value.
+ * @param validationMessage Message shown when value is too large.
+ * @param validationMessageSummary Summary message shown when value is too large.
+ * @returns Validator function for maximum value validation.
+ */
+export declare function maxValueValidator(maxvalue: number, validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/maxvalue.validator.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/mindate.validator.d.ts

@@ -1,2 +1,10 @@
-import { ValidatorFn } from '@angular/forms';
-export declare function minDateValidator(minDate: Date, validationMessage: string, validationMessageSummary: string): ValidatorFn;
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the control date is >= minDate.
+ *
+ * @param minDate Minimum allowed date.
+ * @param validationMessage Message shown when date is too early.
+ * @param validationMessageSummary Summary message shown when date is too early.
+ * @returns Validator function for minimum date validation.
+ */
+export declare function minDateValidator(minDate: Date, validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/mindate.validator.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/minfiles.validator.d.ts

@@ -1,2 +1,10 @@
-import { ValidatorFn } from '@angular/forms';
-export declare function minFilesValidator(minFiles: number, validationMessage: string, validationMessageSummary: string): ValidatorFn;
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the number of uploaded files is >= minFiles.
+ *
+ * @param minFiles Minimum number of files required.
+ * @param validationMessage Message shown when too few files are uploaded.
+ * @param validationMessageSummary Summary message shown when too few files are uploaded.
+ * @returns Validator function for minimum files validation.
+ */
+export declare function minFilesValidator(minFiles: number, validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/minfiles.validator.ngfactory.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/validation/mintextlength.validator.d.ts

@@ -0,0 +1,10 @@
+import { ValidatorFn } from '@angular/forms';
+/**
+ * Returns a validator that checks if the text length is >= mintextlength.
+ *
+ * @param mintextlength Minimum text length required.
+ * @param validationMessage Message shown when text is too short.
+ * @param validationMessageSummary Summary message shown when text is too short.
+ * @returns Validator function for minimum text length validation.
+ */
+export declare function minTextLengthValidator(mintextlength: number, validationMessage: string, validationMessageSummary: string): ValidatorFn;

package/validation/mintextlength.validator.ngfactory.d.ts

@@ -0,0 +1 @@
+export {};