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

package/interfaces/ISacConfigurationService.d.ts

@@ -32,7 +32,15 @@ export interface ISacConfigurationService {
      */
     InputSearchIconMode: 'text' | 'icon' | 'mixed';
     /**
-     * default labe size for large devices
+     * Defines the default label mode for all components with labels
+     *
+     * Options are 'standard' and 'floating'
+     * Floating labels are only supported in Bootstrap 5
+     * Default is 'standard'
+     */
+    LabelMode: 'standard' | 'floating';
+    /**
+     * Default label size for large devices
      */
     LabelSizeLg: number | null;
     /**

package/interfaces/ISacFileBrowserService.d.ts

@@ -1,65 +1,65 @@
-import { Observable } from 'rxjs';
 import { IBrowserFileResponse } from '../components/browser/models/browserfileresponse';
 import { IBrowserNodeResponse } from '../components/browser/models/browsernoderesponse';
+import { Observable } from 'rxjs';
 /**
- * Interface für File Browser Service
+ * Interface for File Browser Service
  */
 export interface ISacFileBrowserService {
     /**
-     * Methode welche die Dateien eines Nodes ausliest
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes in welchem die Files gelesen werden sollen
-     * @param allowedextensions Erlaubte File Extensions
-     */
-    GetFiles(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserFileResponse>;
-    /**
-     * Speichert eine Hochgeladene Datei in der Struktur
-     * @param apiurl URL zu API Service
-     * @param path Pfad in welchem das neue File gespeichert werden soll
-     * @param id ID des Uploads
-     * @param allowedextensions Erlaubte Extensions für den Upload
+     * Deletes a file
+     * @param apiurl URL to API Service
+     * @param path Path of the file to be deleted
+     * @param allowedextensions Allowed extensions for files
      */
-    SaveFile(apiurl: string, path: string, uploadid: string, allowedextensions: string): Observable<IBrowserFileResponse>;
+    DeleteFile(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Methode welche eine Datei umbenannt
-     * @param apiurl URL zu API Service
-     * @param path Pfad zum File welches umbenannt werden soll
-     * @param newFilename Neuer Dateiname
-     * @param allowedextensions Erlaubte Extension für Files
+     * Deletes a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node to be deleted
      */
-    RenameFile(apiurl: string, path: string, newFilename: string, allowedextensions: string): Observable<IBrowserFileResponse>;
+    DeleteNode(apiurl: string, path: string): Observable<IBrowserNodeResponse>;
     /**
-     * Löscht eine Datei
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Files welches gelöscht werden soll
-     * @param allowedextensions Erlaubte Extensions für Files
+     * Method that reads the files of a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node from which the files should be read
+     * @param allowedextensions Allowed file extensions
      */
-    DeleteFile(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserFileResponse>;
+    GetFiles(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Gibt einen Node zurück
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Node welcher angefordert wird
-     * @param allowedextensions Erlaubte Extensions die angezeigt werden dürfen
+     * Returns a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node being requested
+     * @param allowedextensions Allowed extensions that may be displayed
      */
     GetNode(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserNodeResponse>;
     /**
-     * Speichert einen Node
-     * @param apiurl URL zu API Service
-     * @param path Pfad in welchem der Node gespeichert werden soll
-     * @param newFoldername Name des neuen Nodes
+     * Method that renames a file
+     * @param apiurl URL to API Service
+     * @param path Path to the file to be renamed
+     * @param newFilename New filename
+     * @param allowedextensions Allowed extension for files
      */
-    SaveNode(apiurl: string, path: string, newFoldername: string): Observable<IBrowserNodeResponse>;
+    RenameFile(apiurl: string, path: string, newFilename: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Rename eines Nodes
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes welcher umbenannt werden soll
-     * @param newFoldername Neuer Name des Nodes
+     * Rename a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node to be renamed
+     * @param newFoldername New name of the node
      */
     RenameNode(apiurl: string, path: string, newFoldername: string): Observable<IBrowserNodeResponse>;
     /**
-     * Löscht einen Node
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes welcher gelöscht werden soll
+     * Saves an uploaded file in the structure
+     * @param apiurl URL to API Service
+     * @param path Path where the new file should be saved
+     * @param uploadid ID of the upload
+     * @param allowedextensions Allowed extensions for the upload
      */
-    DeleteNode(apiurl: string, path: string): Observable<IBrowserNodeResponse>;
+    SaveFile(apiurl: string, path: string, uploadid: string, allowedextensions: string): Observable<IBrowserFileResponse>;
+    /**
+     * Saves a node
+     * @param apiurl URL to API Service
+     * @param path Path where the node should be saved
+     * @param newFoldername Name of the new node
+     */
+    SaveNode(apiurl: string, path: string, newFoldername: string): Observable<IBrowserNodeResponse>;
 }

package/interfaces/ISacLabelSizes.d.ts

@@ -1,26 +1,29 @@
+/**
+ * Interface defining responsive label column sizes for various device breakpoints.
+ */
 export interface ISacLabelSizes {
     /**
-     * default label size for medium devices
+     * Default label size for large devices (lg breakpoint).
      */
-    labelSizeMd: number;
+    labelSizeLg: number;
     /**
-     * default label size for small devices
+     * Default label size for medium devices (md breakpoint).
      */
-    labelSizeSm: number;
+    labelSizeMd: number;
     /**
-     * default label column size
+     * Default label size for small devices (sm breakpoint).
      */
-    labelSizeXs: number;
+    labelSizeSm: number;
     /**
-     * default label size for extra extra large devices
+     * Default label size for extra large devices (xl breakpoint).
      */
-    labelSizeXxl: number;
+    labelSizeXl: number;
     /**
-     * default labe size for large devices
+     * Default label size for extra small devices (xs breakpoint).
      */
-    labelSizeLg: number;
+    labelSizeXs: number;
     /**
-     * default label size for extra large devices
+     * Default label size for extra extra large devices (xxl breakpoint).
      */
-    labelSizeXl: number;
+    labelSizeXxl: number;
 }

package/interfaces/ISacLanguageService.d.ts

@@ -1,12 +1,12 @@
-import { Observable } from 'rxjs';
 import { LanguageModel } from '../models/languagemodel';
+import { Observable } from 'rxjs';
 /**
  * Interface for language service
  */
 export interface ISacLanguageService {
     /**
-     * Returns any language, that the application supports. This Languages are populated to
-     * Multilanguage Control.
+     * Returns any language that the application supports. These languages are populated to the
+     * Multilanguage control.
      */
     GetLanguages(): Observable<LanguageModel[]>;
 }

package/interfaces/ISacLocalisationService.d.ts

@@ -1,10 +1,10 @@
 import { Observable } from 'rxjs';
 /**
- * Interface für Language Resource Service implementation
+ * Interface for Language Resource Service implementation
  */
 export interface ISacLocalisationService {
     /**
-     * Get String anhand von Key und Params
+     * Get String based on Key and Params
      */
     GetString(key: string, params?: any): Observable<string>;
 }

package/interfaces/ISacUploadEventCompleteState.d.ts

@@ -1,5 +1,11 @@
+/**
+ * Payload structure for upload-complete events emitted by the uploader control.
+ */
 export interface ISacUploadEventCompleteState {
+    /** File name of the uploaded file. */
     name: string;
+    /** File size in bytes of the uploaded file. */
     size: number;
+    /** Identifier of the uploaded file. */
     uploadid: string;
 }

package/interfaces/iabstractcontrollabel.d.ts

@@ -1,6 +1,9 @@
 /**
- * Interface to extend FormControl with label of control
+ * Interface to extend FormControl with a label property used for form field labeling.
  */
 export interface IAbstractControlLabelExtension {
+    /**
+     * Label text of the control, used for aria-labels and display labels.
+     */
     controllabel: string;
 }

package/interfaces/iconfirmcomponent.d.ts

@@ -1,18 +1,18 @@
 import { EventEmitter } from '@angular/core';
 /**
- * Interface für Comfirm Dialog implementation
+ * Interface for Confirm Dialog implementation
  */
 export interface IConfirmComponent {
     /**
-     * EventEmitter beim Bestätigen
+     * EventEmitter on confirmation
      */
     onconfirm: EventEmitter<string>;
     /**
-     * Anzeigen
+     * Hide
      */
-    show(): void;
+    hide(): void;
     /**
-     * Ausblenden
+     * Show
      */
-    hide(): void;
+    show(): void;
 }

package/interfaces/idatetimecontrol.d.ts

@@ -1,7 +1,16 @@
 /**
- * Interface to extend FormControl with datetime parser format
+ * Interface to extend FormControl with datetime parser format and value semantics.
+ *
+ * Controls that implement this interface expose a date/time format string used for validation
+ * and conversion, and carry the current model value.
  */
 export interface IDateTimeControl {
+    /**
+     * Date/time format pattern used by the control (moment.js format string).
+     */
     datetimeformatstring: string;
+    /**
+     * The current value of the datetime control.
+     */
     value: any;
 }

package/interfaces/treeviewaction.interface.d.ts

@@ -1,4 +1,13 @@
+/**
+ * Represents a tree view action event payload.
+ */
 export interface TreeviewAction {
+    /**
+     * Action name, e.g., 'select', 'expand', 'collapse'.
+     */
     action: string;
+    /**
+     * Node object associated with the action.
+     */
     node: any;
 }

package/models/languagemodel.d.ts

@@ -1,22 +1,22 @@
 import { IconType } from '../enums/IconType';
 /**
- * Model für Sprachen
+ * Model for languages
  */
 export declare class LanguageModel {
     /**
-     * ISO Code zu Sprache
+     * Icon for language
      */
-    IsoCode: string;
+    Icon: string;
     /**
-     * Icon für Sprache
+     * Type of the icon. Default is Image
      */
-    Icon: string;
+    IconType: IconType;
     /**
-     * Bezeichnung für Sprache
+     * ISO Code for language
      */
-    Text: string;
+    IsoCode: string;
     /**
-     * Typ des Icons. Default ist Image
+     * Designation for language
      */
-    IconType: IconType;
+    Text: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simpleangularcontrols/sac-common",
-  "version": "10.0.0-rc.29",
+  "version": "10.0.0-rc.30",
   "peerDependencies": {
     "@angular/common": "^10.1.5",
     "@angular/core": "^10.1.5",

package/public_api.d.ts

@@ -78,7 +78,8 @@ export * from './utilities/convertion';
 export * from './utilities/datatypes';
 export * from './utilities/enums';
 export * from './utilities/interpolation';
-export * from './utilities/positioning';
+export * from './utilities/positioncalculator';
+export * from './utilities/positionelements';
 export * from './utilities/testingattribute.pipe';
 export * from './common/basedatetimecontrol';
 export * from './common/baseinputcontrol';

package/services/index.d.ts

@@ -1,6 +1,6 @@
 export { SACCONFIGURATION_SERVICE, SacAbstractConfigurationService, SacDefaultConfigurationService, } from './sac-configuration.service';
 export { SACFILEBROWSER_SERVICE, SacAbstractFileBrowserService, SacDefaultFileBrowserService, } from './sac-filebrowser.service';
-export { SACICON_SERVICE, SacAbstractIconService, SacDefaultIconService, } from './sac-icon.service';
-export { SACLANGUAGE_SERVICE, SacAbstractLanguageService, SacDefaultLanguageService, } from './sac-language.service';
+export { SACICON_SERVICE, SacAbstractIconService, SacDefaultIconService } from './sac-icon.service';
+export { SACLANGUAGE_SERVICE, SacAbstractLanguageService, SacDefaultLanguageService } from './sac-language.service';
 export { SACLOCALISATION_SERVICE, SacAbstractLocalisationService, SacDefaultLocalisationService, } from './sac-localisation.service';
-export { SACVALIDATIONKEY_SERVICE, SacDefaultValidationKeyService, } from './sac-validationkey.service';
+export { SACVALIDATIONKEY_SERVICE, SacDefaultValidationKeyService } from './sac-validationkey.service';

package/services/sac-configuration.service.d.ts

@@ -37,6 +37,10 @@ export declare abstract class SacAbstractConfigurationService implements ISacCon
      * @inheritdoc
      */
     abstract get InputSearchIconMode(): 'text' | 'icon' | 'mixed';
+    /**
+     * @inheritdoc
+     */
+    abstract get LabelMode(): 'standard' | 'floating';
     /**
      * @inheritdoc
      */
@@ -98,6 +102,10 @@ export declare class SacDefaultConfigurationService extends SacAbstractConfigura
      * @inheritdoc
      */
     get InputSearchIconMode(): 'text' | 'icon' | 'mixed';
+    /**
+     * @inheritdoc
+     */
+    get LabelMode(): 'standard' | 'floating';
     /**
      * @inheritdoc
      */

package/services/sac-filebrowser.service.d.ts

@@ -5,136 +5,144 @@ import { HttpClient } from '@angular/common/http';
 import { InjectionToken } from '@angular/core';
 import { Observable } from 'rxjs';
 /**
- * Injection Token für Language Service
+ * Injection Token for Language Service
  */
 export declare const SACFILEBROWSER_SERVICE: InjectionToken<ISacFileBrowserService>;
 /**
- * Abstrakte Implementierung des File Service für die Browser Component
+ * Abstract implementation of the file service for the browser component
  */
 export declare abstract class SacAbstractFileBrowserService implements ISacFileBrowserService {
     /**
-     * Löscht eine Datei
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Files welches gelöscht werden soll
-     * @param allowedextensions Erlaubte Extensions für Files
+     * Deletes a file
+     * @param apiurl URL to API Service
+     * @param path Path of the file to be deleted
+     * @param allowedextensions Allowed extensions for files
      */
     abstract DeleteFile(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Löscht einen Node
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes welcher gelöscht werden soll
+     * Deletes a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node to be deleted
      */
     abstract DeleteNode(apiurl: string, path: string): Observable<IBrowserNodeResponse>;
     /**
-     * Methode welche die Dateien eines Nodes ausliest
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes in welchem die Files gelesen werden sollen
-     * @param allowedextensions Erlaubte File Extensions
+     * Method that reads the files of a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node from which the files should be read
+     * @param allowedextensions Allowed file extensions
      */
     abstract GetFiles(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Gibt einen Node zurück
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Node welcher angefordert wird
-     * @param allowedextensions Erlaubte Extensions die angezeigt werden dürfen
+     * Returns a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node being requested
+     * @param allowedextensions Allowed extensions that may be displayed
      */
     abstract GetNode(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserNodeResponse>;
     /**
-     * Methode welche eine Datei umbenannt
-     * @param apiurl URL zu API Service
-     * @param path Pfad zum File welches umbenannt werden soll
-     * @param newFilename Neuer Dateiname
-     * @param allowedextensions Erlaubte Extension für Files
+     * Method that renames a file
+     * @param apiurl URL to API Service
+     * @param path Path to the file to be renamed
+     * @param newFilename New filename
+     * @param allowedextensions Allowed extension for files
      */
     abstract RenameFile(apiurl: string, path: string, newFilename: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Rename eines Nodes
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes welcher umbenannt werden soll
-     * @param newFoldername Neuer Name des Nodes
+     * Rename a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node to be renamed
+     * @param newFoldername New name of the node
      */
     abstract RenameNode(apiurl: string, path: string, newFoldername: string): Observable<IBrowserNodeResponse>;
     /**
-     * Speichert eine Hochgeladene Datei in der Struktur
-     * @param apiurl URL zu API Service
-     * @param path Pfad in welchem das neue File gespeichert werden soll
-     * @param id ID des Uploads
-     * @param allowedextensions Erlaubte Extensions für den Upload
+     * Saves an uploaded file in the structure
+     * @param apiurl URL to API Service
+     * @param path Path where the new file should be saved
+     * @param id ID of the upload
+     * @param allowedextensions Allowed extensions for the upload
      */
     abstract SaveFile(apiurl: string, path: string, id: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Speichert einen Node
-     * @param apiurl URL zu API Service
-     * @param path Pfad in welchem der Node gespeichert werden soll
-     * @param newFoldername Name des neuen Nodes
+     * Saves a node
+     * @param apiurl URL to API Service
+     * @param path Path where the node should be saved
+     * @param newFoldername Name of the new node
      */
     abstract SaveNode(apiurl: string, path: string, newFoldername: string): Observable<IBrowserNodeResponse>;
 }
 /**
- * Standardimplementierung des Backend Service für die File Browser Component
+ * Standard implementation of the backend service for the file browser component
  */
 export declare class SacDefaultFileBrowserService extends SacAbstractFileBrowserService {
     private httpclient;
     /**
-     * Konstruktor
+     * Constructor
      * @param httpclient HTTP Client Service
      */
     constructor(httpclient: HttpClient);
     /**
-     * Löscht eine Datei
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Files welches gelöscht werden soll
-     * @param allowedextensions Erlaubte Extensions für Files
+     * Deletes a file
+     * @param apiurl URL to API Service
+     * @param path Path of the file to be deleted
+     * @param allowedextensions Allowed extensions for files
+     * @returns Observable containing the file response after deletion
      */
     DeleteFile(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Löscht einen Node
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes welcher gelöscht werden soll
+     * Deletes a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node to be deleted
+     * @returns Observable containing the node response after deletion
      */
     DeleteNode(apiurl: string, path: string): Observable<IBrowserNodeResponse>;
     /**
-     * Methode welche die Dateien eines Nodes ausliest
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes in welchem die Files gelesen werden sollen
-     * @param allowedextensions Erlaubte File Extensions
+     * Method that reads the files of a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node from which the files should be read
+     * @param allowedextensions Allowed file extensions
+     * @returns Observable containing the file response
      */
     GetFiles(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Gibt einen Node zurück
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Node welcher angefordert wird
-     * @param allowedextensions Erlaubte Extensions die angezeigt werden dürfen
+     * Returns a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node being requested
+     * @param allowedextensions Allowed extensions that may be displayed
+     * @returns Observable containing the node response
      */
     GetNode(apiurl: string, path: string, allowedextensions: string): Observable<IBrowserNodeResponse>;
     /**
-     * Methode welche eine Datei umbenannt
-     * @param apiurl URL zu API Service
-     * @param path Pfad zum File welches umbenannt werden soll
-     * @param newFilename Neuer Dateiname
-     * @param allowedextensions Erlaubte Extension für Files
+     * Method that renames a file
+     * @param apiurl URL to API Service
+     * @param path Path to the file to be renamed
+     * @param newFilename New filename
+     * @param allowedextensions Allowed extension for files
+     * @returns Observable containing the file response after rename
      */
     RenameFile(apiurl: string, path: string, newFilename: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Rename eines Nodes
-     * @param apiurl URL zu API Service
-     * @param path Pfad des Nodes welcher umbenannt werden soll
-     * @param newFoldername Neuer Name des Nodes
+     * Rename a node
+     * @param apiurl URL to API Service
+     * @param path Path of the node to be renamed
+     * @param newFoldername New name of the node
+     * @returns Observable containing the node response after rename
      */
     RenameNode(apiurl: string, path: string, newFoldername: string): Observable<IBrowserNodeResponse>;
     /**
-     * Speichert eine Hochgeladene Datei in der Struktur
-     * @param apiurl URL zu API Service
-     * @param path Pfad in welchem das neue File gespeichert werden soll
-     * @param id ID des Uploads
-     * @param allowedextensions Erlaubte Extensions für den Upload
+     * Saves an uploaded file in the structure
+     * @param apiurl URL to API Service
+     * @param path Path where the new file should be saved
+     * @param id ID of the upload
+     * @param allowedextensions Allowed extensions for the upload
+     * @returns Observable containing the file response after save
      */
     SaveFile(apiurl: string, path: string, id: string, allowedextensions: string): Observable<IBrowserFileResponse>;
     /**
-     * Speichert einen Node
-     * @param apiurl URL zu API Service
-     * @param path Pfad in welchem der Node gespeichert werden soll
-     * @param newFoldername Name des neuen Nodes
+     * Saves a node
+     * @param apiurl URL to API Service
+     * @param path Path where the node should be saved
+     * @param newFoldername Name of the new node
+     * @returns Observable containing the node response after save
      */
     SaveNode(apiurl: string, path: string, newFoldername: string): Observable<IBrowserNodeResponse>;
 }