mmhglobal-dynamicform 2.41.5 → 2.43.0

package/lib/services/zcomponent.service.d.ts

@@ -34,9 +34,7 @@ export declare class ZComponentService {
     translateComponentProperties(componentProperties: ZComponentProperties, group: ZGroup): Observable<any>;
     private translateCompByProperty;
     private readonly timePickerDateType;
-    localizeDateTimeByIgnoringTimeZone(value: string, data: ZField): Date;
-    private removeTimeZoneAndConvertToISOString;
-    private convertOffsetMinToHour;
+    localizeDateTimeByIgnoringTimeZone(value: any, field: ZField): Date;
     decrementComponentCounterForField(field: ZField): void;
     isMobileScreen(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<ZComponentService, never>;

package/lib/zdatetime/dateParser.pipe.d.ts

@@ -5,7 +5,7 @@ import * as i0 from "@angular/core";
 export declare class DateParserFilter implements PipeTransform {
     componentService: ZComponentService;
     constructor(componentService: ZComponentService);
-    transform(value: any, data: ZField): any;
+    transform(rawValue: any, field: ZField): Date | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<DateParserFilter, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<DateParserFilter, "dateParser">;
 }

package/lib/zdatetime/zdatetime.component.d.ts

@@ -26,6 +26,11 @@ export declare class ZdatetimeComponent extends InputFieldBase implements ZCompo
     private setStepValue;
     private setDisabledDates;
     private convertDateTimeValueToString;
+    /**
+     * Adjusts a Date so that its wall-clock time stays the same
+     * when ignoring the browser timezone.
+     */
+    private adjustForIgnoreTimeZone;
     private parseAnyValueToDate;
     private parseAnyValueToDateOnly;
     focus(): boolean;

package/lib/zgauge/zgauge.component.d.ts

@@ -10,13 +10,24 @@ import * as i0 from "@angular/core";
 export declare class ZgaugeComponent extends FieldBase implements ZComponent, OnInit {
     componentService: ZComponentService;
     isLoading: boolean;
+    private value;
+    private title;
+    private color;
+    private majorTicks;
+    private minorTicks;
+    private startAngle;
+    private endAngle;
+    private minValue;
+    private maxValue;
     options: {
         value: number;
         title: string;
         chartInnerText1: string;
         chartInnerText2: string;
         scaleMax: number;
-        colors: any[];
+        colors: {
+            color: string;
+        }[];
         transitions: boolean;
         majorTicks: {
             visible: boolean;
@@ -33,12 +44,12 @@ export declare class ZgaugeComponent extends FieldBase implements ZComponent, On
         endAngle: number;
         rangePlaceholderColor: string;
         labelsColor: string;
-        rangeFrom: number;
-        rangeTo: number;
         rangeColor: string;
         rangeLineCap: string;
         showLabels: boolean;
         rangeSize: number;
+        labelStyle: string;
+        arcgaugeStyle: string;
     };
     constructor(componentService: ZComponentService);
     ngOnInit(): void;

package/lib/ztexteditor/ztexteditor.component.d.ts

@@ -1,18 +1,17 @@
 /********** Angular **********/
-import { OnInit } from '@angular/core';
-/********** Ionic **********/
+import { OnInit, AfterViewInit } from '@angular/core';
 /********** Plugin **********/
 import { EditorComponent, EditorPasteEvent } from '@progress/kendo-angular-editor';
+import { ToolBarButtonComponent } from '@progress/kendo-angular-toolbar';
+import { DialogRef, DialogService } from '@progress/kendo-angular-dialog';
 /********** Component & Service **********/
 import { InputFieldBase } from '../components/inputfieldbase.component';
 import { ZComponentService } from '../services/zcomponent.service';
-import { ZComponent, FontAweSomeService, CompressImageService, AlertService, ToastService } from 'mmhglobal-zcore';
-import { DialogService, DialogRef } from "@progress/kendo-angular-dialog";
-import { ToolBarButtonComponent } from '@progress/kendo-angular-toolbar';
+import { AlertService, CompressImageService, FontAweSomeService, ToastService, ZComponent } from 'mmhglobal-zcore';
 import * as i0 from "@angular/core";
-export declare class ZtexteditorComponent extends InputFieldBase implements ZComponent, OnInit {
-    componentService: ZComponentService;
-    fontAweSomeService: FontAweSomeService;
+export declare class ZtexteditorComponent extends InputFieldBase implements ZComponent, OnInit, AfterViewInit {
+    readonly componentService: ZComponentService;
+    readonly fontAweSomeService: FontAweSomeService;
     private readonly dialogService;
     private readonly alertService;
     private readonly compressImage;
@@ -23,35 +22,77 @@ export declare class ZtexteditorComponent extends InputFieldBase implements ZCom
         removeMsClasses: boolean;
         removeMsStyles: boolean;
         removeInvalidHTML: boolean;
+        [key: string]: any;
     };
     componentSettings: {
         iframe: boolean;
+        [key: string]: any;
     };
     isCompressModeOn: boolean;
     CloseEnlargeBtn: boolean;
-    private style;
-    private readonly CompressionEnableIcon;
-    private readonly CompressionDisabledIcon;
-    dialogRef: DialogRef;
+    dialogRef?: DialogRef;
+    private originalInlineStyle;
+    private readonly compressionEnableIcon;
+    private readonly compressionDisabledIcon;
     constructor(componentService: ZComponentService, fontAweSomeService: FontAweSomeService, dialogService: DialogService, alertService: AlertService, compressImage: CompressImageService, toastService: ToastService);
+    /** Initialize component state and editor configuration. */
     ngOnInit(): void;
+    /** Notify component service once view is ready. */
     ngAfterViewInit(): void;
-    onChange(value: any): void;
-    onPaste($event: EditorPasteEvent): Promise<void>;
-    OnOffCompressMode($event: any): void;
+    /** Sync editor content to zModel and trigger configured change handler. */
+    onChange(value: unknown): void;
+    /** Handle paste: normalize plain-text special entities, then optionally compress pasted base64 images. */
+    onPaste(e: EditorPasteEvent): Promise<void>;
+    /**
+     * If the paste is plain text (no HTML tags and no images), normalize common entities and insert as real text.
+     * Returns true when the event is handled and default paste is prevented.
+     */
+    private handleCommonSymbolTags;
+    /**
+     * If compression is enabled and compress mode is ON, compress any pasted base64 images (data:image/*).
+     * IMPORTANT: modifies e.cleanedHtml (what gets pasted), not editor.value.
+     */
+    private handleImageCompression;
+    /**
+     * Toggle compress mode via confirmation dialog.
+     */
+    onOffCompressMode(event: Event): void;
+    /** Focus editor if available. Returns true if focus succeeded. */
     focus(): boolean;
-    getFontAwesome(iconName: any, fontAwesomeService: FontAweSomeService): any;
+    getFontAwesome(iconName: string, fontAwesomeService: FontAweSomeService): unknown;
+    /** Merge paste cleanup options from data.Options (string expression or object) into pasteCleanupSettings. */
     private setupPasteCleanupSettings;
+    /** Trigger hidden file input click for image upload. */
     openFileExplorer(): void;
+    /** Open an enlarged popup editor. */
     openPopup(): void;
+    /** Close the popup editor if open. */
     onPopupClose(): void;
-    uploadImage(fileInput: any): void;
+    /**
+     * Handle <input type="file"> change and insert selected image into editor.
+     * NOTE: Prefer typing fileInput as Event for better safety.
+     */
+    uploadImage(fileInput: Event): void;
+    /** Insert image into editor, optionally compressing first. */
     private insertImageIntoEditor;
+    /** Convert base64 (data URL) to File. */
     private base64ToFile;
-    private ImageCompression;
+    /**
+     * Compress an image file if it is an image and above min threshold.
+     * Returns the compressed file, or null if not compressible / compression skipped.
+     */
+    private imageCompression;
+    /** Normalize image compression config into byte-based thresholds. */
     private compressionConfigHandler;
+    /**
+     * Convert size string like "100kb", "1 MB", "2gb" to bytes.
+     * If no unit is provided, bytes are assumed.
+     */
     private convertSizeToByte;
+    /** Read a File as base64 data URL. */
     private readFileAsDataURL;
+    /** Extract event target as HTMLElement safely. */
+    private getEventTargetElement;
     static ɵfac: i0.ɵɵFactoryDeclaration<ZtexteditorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ZtexteditorComponent, "app-ztexteditor", never, {}, {}, never, never>;
 }

package/lib/zupload/zupload.component.d.ts

@@ -1,50 +1,117 @@
 /********** Angular **********/
-import { OnInit, NgZone } from "@angular/core";
-import { FileInfo, SuccessEvent, RemoveEvent, UploadEvent, FileRestrictions, ChunkSettings, SelectEvent, UploadComponent } from "@progress/kendo-angular-upload";
+import { NgZone, OnInit } from "@angular/core";
+import { ChunkSettings, FileInfo, FileRestrictions, RemoveEvent, SelectEvent, SuccessEvent, UploadComponent, UploadEvent } from "@progress/kendo-angular-upload";
 /********** Component & Service **********/
 import { InputFieldBase } from "../components/inputfieldbase.component";
 import { ZComponentService } from "../services/zcomponent.service";
-import { AuthService, ZCoreService, CompressImageService, AlertService, ZComponent, SharePointService } from "mmhglobal-zcore";
+import { AlertService, AuthService, CompressImageService, SharePointService, ZComponent, ZCoreService } from "mmhglobal-zcore";
 import * as i0 from "@angular/core";
+/**
+ * Kendo FileInfo + optional base64 payload (used by SelectFileOnly mode).
+ * NOTE: Keeps runtime behavior the same; only improves type safety.
+ */
+declare type SelectedFileData = FileInfo & {
+    /**
+     * Base64 Data URL or ArrayBuffer from FileReader.
+     * Present only when SelectFileOnly reads file content into memory.
+     */
+    file?: string | ArrayBuffer | null;
+};
 export declare class MyFileInfo implements FileInfo {
     name: string;
     uid?: string;
+    /**
+     * Server or application-defined UID used for remove/download operations.
+     * (Set from API response fileUid when upload succeeds)
+     */
     myUid?: string;
 }
 export declare class ZuploadComponent extends InputFieldBase implements ZComponent, OnInit {
-    componentService: ZComponentService;
-    private authService;
-    private compressImage;
-    private zcoreService;
-    private ngZone;
-    private sharePointService;
-    private alertService;
+    readonly componentService: ZComponentService;
+    private readonly authService;
+    private readonly compressImage;
+    private readonly zcoreService;
+    private readonly ngZone;
+    private readonly sharePointService;
+    private readonly alertService;
     uploadComponent: UploadComponent;
-    uploadAttachmentUrl: string;
+    private readonly defaultUploadSaveUrl;
+    private readonly defaultUploadRemoveUrl;
+    uploadAttachmentUrl: string | null;
     uploadSaveUrl: string;
     uploadRemoveUrl: string;
-    downloadFileUrl: string;
-    getImageUrl: string;
+    readonly downloadFileUrl = "/Attachment/downloadFile";
+    readonly getImageUrl = "/Attachment/getImage";
     isAutoUpload: boolean;
     isMultiple: boolean;
-    imagePreviews: any[];
-    uid: string[];
     showFileList: boolean;
-    fileList: any[];
+    imagePreviews: Array<Record<string, unknown>>;
+    uid: string[];
+    fileList: SelectedFileData[];
     restrictions: FileRestrictions;
-    chunkSettings: ChunkSettings;
+    readonly chunkSettings: ChunkSettings;
     constructor(componentService: ZComponentService, authService: AuthService, compressImage: CompressImageService, zcoreService: ZCoreService, ngZone: NgZone, sharePointService: SharePointService, alertService: AlertService);
+    /**
+     * Angular lifecycle hook - initializes restrictions and upload behavior from field config.
+     */
     ngOnInit(): void;
+    /**
+     * Kendo Upload success callback for both upload and remove.
+     * Keeps zModel in sync and emits ZComponent output events.
+     */
     onSuccess(e: SuccessEvent): void;
+    /**
+     * Normalize and enrich image compression config with byte-based thresholds.
+     */
     private compressionConfigHandler;
+    /**
+     * Convert string size values like "10KB", "2 MB", "1gb", "1024" into bytes.
+     * If unit is omitted, bytes are assumed.
+     *
+     * @param sizeString Human readable size string.
+     * @returns Size in bytes. Returns 0 if parsing fails.
+     */
     private convertSizeToByte;
+    /**
+     * Kendo Upload upload event: validates files, builds image previews, injects metadata and auth header.
+     */
     uploadEventHandler(e: UploadEvent): void;
+    /**
+     * Kendo Upload remove event: updates component memory, fires project event if defined,
+     * otherwise attaches required payload and authorization headers.
+     */
     onRemove(e: RemoveEvent): void;
-    onChange(file: FileInfo[]): void;
+    /**
+     * Kendo Upload change event handler. Emits project event if configured.
+     */
+    onChange(files: FileInfo[]): void;
+    /**
+     * Validate a selected/uploaded file against configured restrictions (size + extension).
+     *
+     * @param file Kendo FileInfo
+     * @returns true if file passes restrictions, otherwise false (and shows alert).
+     */
     private isValidUploadedFile;
+    /**
+     * Kendo Upload select event handler:
+     * - Handles SharePoint endpoint switching
+     * - Supports SelectFileOnly mode (read file content into memory and emit event)
+     * - Supports image compression when AutoUpload is false
+     */
     selectEventHandler(e: SelectEvent): void;
+    /**
+     * Clears UI-selected files and syncs group state.
+     * NOTE: Original behavior sets group value to fileList (not empty); preserved.
+     */
     clearFiles(): void;
+    /**
+     * Format bytes into human-readable string.
+     *
+     * @param bytes Raw byte size
+     * @returns Formatted file size string (e.g. "12.5MB")
+     */
     private formatFileSize;
     static ɵfac: i0.ɵɵFactoryDeclaration<ZuploadComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ZuploadComponent, "app-zupload", never, {}, {}, never, never>;
 }
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mmhglobal-dynamicform",
-  "version": "2.41.5",
+  "version": "2.43.0",
   "peerDependencies": {},
   "dependencies": {
     "tslib": "^2.3.1"