commons-shared-web-ui 0.0.14 → 0.0.15

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnInit, OnDestroy, EventEmitter, OnChanges, SimpleChanges, ElementRef, AfterViewInit, QueryList, ChangeDetectorRef, NgZone } from '@angular/core';
+import { OnInit, OnDestroy, EventEmitter, OnChanges, SimpleChanges, ElementRef, PipeTransform, AfterViewInit, QueryList, ChangeDetectorRef, NgZone } from '@angular/core';
 import * as i2$1 from '@angular/common';
 import * as i1 from '@angular/material/card';
 import * as i2 from '@angular/material/snack-bar';
@@ -40,7 +40,8 @@ import * as i11$1 from '@angular/cdk/scrolling';
 import { CdkVirtualScrollViewport } from '@angular/cdk/scrolling';
 import { HttpClient, HttpHeaders } from '@angular/common/http';
 import { Observable, Subject } from 'rxjs';
-import * as i9$1 from 'ngx-quill';
+import { DomSanitizer, SafeResourceUrl } from '@angular/platform-browser';
+import * as i10$1 from 'ngx-quill';
 
 declare class MaterialModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MaterialModule, never>;
@@ -1615,6 +1616,7 @@ interface TextConfig {
      * the check on the field that carries matchField config.
      */
     matchField?: string;
+    showCharCount?: boolean;
 }
 interface LengthConstraint {
     min?: number;
@@ -1700,6 +1702,22 @@ interface AttachmentConfig {
      * Only relevant when uploadUrl is set.
      */
     entityType?: string;
+    /**
+     * API endpoint to delete the file. Called when an uploaded file with an ID != 0 is removed.
+     */
+    deleteUrl?: string;
+    /** API endpoint to GET the default library images list */
+    libraryApiUrl?: string;
+    /** Dot-notation path to the image array in the library API response (e.g. 'data.items') */
+    libraryDataPath?: string;
+    /** Dot-notation path to the image URL within each library item (e.g. 'url') */
+    libraryUrlPath?: string;
+    /** Dot-notation path to the image ID within each library item */
+    libraryIdPath?: string;
+    /** Optional description shown in the left info panel for media upload */
+    description?: string;
+    /** Optional bullet-point feature lines shown in the left info panel for media upload */
+    features?: string[];
 }
 interface LocationConfig {
     enableCurrentLocation?: boolean;
@@ -1712,6 +1730,8 @@ interface RatingConfig {
 interface RichTextConfig {
     height?: string;
     placeholder?: string;
+    maxLength?: number;
+    showCharCount?: boolean;
 }
 interface ValidationResult {
     isValid: boolean;
@@ -1720,6 +1740,26 @@ interface ValidationResult {
         [key: string]: string;
     };
 }
+/**
+ * A single media item stored in the MEDIA_UPLOAD field value array.
+ * Can represent an uploaded image (from device or library) or a YouTube video.
+ */
+interface MediaItem {
+    /** Server-assigned ID (for pre-filled items) */
+    id?: number;
+    /** 'image' | 'youtube' */
+    mediaType: 'image' | 'youtube';
+    /** Remote URL of the image returned by the upload API, or the YouTube embed URL */
+    url: string;
+    /** Thumbnail URL (for YouTube previews) */
+    thumbnailUrl?: string;
+    /** MIME type returned by the upload API (e.g. 'image/png') */
+    mimeType?: string;
+    /** File name returned by the upload API */
+    fileName?: string;
+    /** True while the file is being uploaded */
+    isUploading?: boolean;
+}
 
 declare class SmartFormController {
     private formData;
@@ -1910,6 +1950,18 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     fileUploadError: string;
     multiSaveError: string;
     private destroy$;
+    mediaDeviceInput: ElementRef<HTMLInputElement>;
+    showMediaMenu: boolean;
+    showYoutubeInput: boolean;
+    youtubeUrlInput: string;
+    youtubeUrlError: string;
+    mediaCarouselIndex: number;
+    showLibraryModal: boolean;
+    libraryImages: any[];
+    librarySelectedIds: Set<any>;
+    libraryLoading: boolean;
+    libraryError: string;
+    mediaUploadError: string;
     /** FormControl used ONLY for the autocomplete text-input display value */
     autocompleteInputCtrl: FormControl<string>;
     /** Filtered option list shown in the mat-autocomplete panel */
@@ -1992,6 +2044,8 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     onCheckboxListChange(code: string, checked: boolean): void;
     isChecked(code: string): boolean;
     get errorMessage(): string;
+    get showCharCount(): boolean;
+    get remainingCharacters(): number | null;
     get isTextField(): boolean;
     get isNumberField(): boolean;
     get isDateField(): boolean;
@@ -1999,6 +2053,7 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     get isDropdown(): boolean;
     get isAutocomplete(): boolean;
     get isFileUpload(): boolean;
+    get isMediaUpload(): boolean;
     get isRadio(): boolean;
     get isCheckbox(): boolean;
     get isChip(): boolean;
@@ -2044,13 +2099,51 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     formatFileSize(bytes: number): string;
     get addLabel(): string;
     get removeLabel(): string;
+    get mediaItems(): MediaItem[];
+    /** Number of active items (used to clamp carousel index) */
+    get mediaCount(): number;
+    /** The currently visible carousel item */
+    get activeMediaItem(): MediaItem | null;
+    /** Thumbnail strip items */
+    get mediaThumbnails(): MediaItem[];
+    mediaCarouselPrev(): void;
+    mediaCarouselNext(): void;
+    mediaGoTo(index: number): void;
+    onMediaMenuVideo(): void;
+    addYoutubeMedia(): void;
+    private _extractYoutubeId;
+    onMediaMenuDevice(): void;
+    onMediaFileSelected(event: Event): void;
+    onMediaMenuLibrary(): void;
+    private _loadLibraryImages;
+    getLibraryItemUrl(item: any): string;
+    getLibraryItemId(item: any): any;
+    isLibraryItemSelected(item: any): boolean;
+    toggleLibraryItem(item: any): void;
+    closeLibraryModal(): void;
+    confirmLibrarySelection(): void;
+    removeMediaItem(index: number): void;
+    private _appendMediaItem;
+    private showMediaError;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<FormFieldComponent, "lib-form-field", never, { "config": { "alias": "config"; "required": false; }; "controller": { "alias": "controller"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "allowMulti": { "alias": "allowMulti"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+/**
+ * Bypasses Angular's DomSanitizer for resource URLs (e.g. YouTube embed iframes).
+ * Used only for trusted URLs such as YouTube embed links derived from user-provided video IDs.
+ */
+declare class TrustedUrlPipe implements PipeTransform {
+    private sanitizer;
+    constructor(sanitizer: DomSanitizer);
+    transform(url: string): SafeResourceUrl | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TrustedUrlPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<TrustedUrlPipe, "trustedUrl", false>;
+}
+
 declare class SmartFormModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SmartFormModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SmartFormModule, [typeof SmartFormComponent, typeof FormSectionComponent, typeof FormFieldComponent], [typeof i2$1.CommonModule, typeof i3$1.ReactiveFormsModule, typeof i3$1.FormsModule, typeof MaterialModule, typeof ButtonModule, typeof AlertModule, typeof i9$1.QuillModule], [typeof SmartFormComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SmartFormModule, [typeof SmartFormComponent, typeof FormSectionComponent, typeof FormFieldComponent, typeof TrustedUrlPipe], [typeof i2$1.CommonModule, typeof i3$1.ReactiveFormsModule, typeof i3$1.FormsModule, typeof MaterialModule, typeof ButtonModule, typeof AlertModule, typeof i10$1.QuillModule], [typeof SmartFormComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SmartFormModule>;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commons-shared-web-ui",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",

package/src/lib/modules/smart-form/smart-form.theme.scss

@@ -119,7 +119,7 @@ $default-smart-form-config: (
     generated-padding: 0.625rem 0.875rem,
 
     // ── File upload drop-zone ───────────────────────────────────────────────────
-    dropzone-bg: #F8FAFC,
+    dropzone-bg: #FFFAF1,
     dropzone-border: 1.5px dashed #CBD5E1,
     dropzone-radius: 12px,
     dropzone-hover-bg: #EFF6FF,