commons-shared-web-ui 0.0.14 → 0.0.16

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,11 +1702,80 @@ 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 {
+    /** Default active tab: 'VENUE' | 'ONLINE' | 'TBA'. Defaults to 'VENUE'. */
+    defaultTab?: 'VENUE' | 'ONLINE' | 'TBA';
+    /** Allow multiple locations. Replaces the need for maxLocations. */
+    allowMulti?: boolean;
+    /** Maximum number of venue locations allowed. Defaults to 5 if allowMulti is true. */
+    maxLocations?: number;
+    /** Placeholder for the venue search input */
+    venuePlaceholder?: string;
+    /** Google Maps API Key – required for map rendering and autocomplete */
+    googleMapsApiKey?: string;
+    /** Height of the embedded Google Map. Defaults to '300px'. */
+    mapHeight?: string;
+    /** Default map center latitude when no locations are added (e.g., India: 20.5937) */
+    defaultLat?: number;
+    /** Default map center longitude when no locations are added (e.g., India: 78.9629) */
+    defaultLng?: number;
+    /** Default zoom level when no locations are added (e.g., 4) */
+    defaultZoom?: number;
+    /** Placeholder for the online event URL input */
+    onlinePlaceholder?: string;
+    /** Show map preview after locations are added (default: true) */
+    showMap?: boolean;
+    /** Whether the current location button is enabled inside venue tab */
     enableCurrentLocation?: boolean;
+    /** @deprecated Use showMap instead */
     enableMapPicker?: boolean;
 }
+/** A single venue location picked from Google Places autocomplete. */
+interface LocationItem {
+    uuid?: string;
+    isActive?: boolean;
+    id?: number;
+    locationCode?: string;
+    latitude?: number;
+    longitude?: number;
+    address?: string;
+    name?: string;
+    cityLabel?: string;
+    stateLabel?: string;
+    countryLabel?: string;
+    placeId?: string;
+    type?: string;
+    /** Legacy field for UI binding */
+    description?: string;
+}
+/**
+ * Value shape stored in the FormControl for a LOCATION field.
+ * `tab` indicates which mode is active.
+ */
+interface LocationFieldValue {
+    tab: 'VENUE' | 'ONLINE' | 'TBA';
+    /** Array of venue locations (only valid when tab === 'VENUE') */
+    venues?: LocationItem[];
+    /** Event URL (only valid when tab === 'ONLINE') */
+    onlineUrl?: string;
+}
 interface RatingConfig {
     maxRating?: number;
     allowHalf?: boolean;
@@ -1712,6 +1783,8 @@ interface RatingConfig {
 interface RichTextConfig {
     height?: string;
     placeholder?: string;
+    maxLength?: number;
+    showCharCount?: boolean;
 }
 interface ValidationResult {
     isValid: boolean;
@@ -1720,6 +1793,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 +2003,34 @@ 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;
+    /** Active tab: VENUE | ONLINE | TBA */
+    locationActiveTab: 'VENUE' | 'ONLINE' | 'TBA';
+    /** Current text in the venue search box */
+    locationSearchText: string;
+    /** Google Places autocomplete suggestions */
+    locationSuggestions: any[];
+    /** Show the suggestions dropdown */
+    locationShowSuggestions: boolean;
+    /** Cached Google AutocompleteService instance */
+    private _googleAcService;
+    /** Whether Google Maps is loaded */
+    locationMapLoaded: boolean;
+    /** Map instance */
+    private _googleMap;
+    /** Map markers */
+    private _mapMarkers;
     /** FormControl used ONLY for the autocomplete text-input display value */
     autocompleteInputCtrl: FormControl<string>;
     /** Filtered option list shown in the mat-autocomplete panel */
@@ -1992,6 +2113,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 +2122,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;
@@ -2008,6 +2132,7 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     get isGenerated(): boolean;
     get isRow(): boolean;
     get isGroup(): boolean;
+    get isLocation(): boolean;
     /**
      * Initialise the separate display-control that drives the mat-autocomplete
      * text input.  The real form control always stores the *code* value.
@@ -2044,13 +2169,66 @@ 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;
+    private initLocationField;
+    private _ensureGoogleMapsScript;
+    onLocationTabChange(tab: 'VENUE' | 'ONLINE' | 'TBA'): void;
+    get locationValue(): LocationFieldValue;
+    get locationVenues(): LocationItem[];
+    get locationOnlineUrl(): string;
+    get locationMaxReached(): boolean;
+    handleLocationSearchInput(event: Event): void;
+    onLocationSuggestionSelect(prediction: any): void;
+    private _addVenueAndUpdate;
+    removeLocationVenue(index: number): void;
+    onLocationUrlChange(url: string): void;
+    hideLocationSuggestions(): void;
+    getLocationMapEmbedUrl(): string;
+    private _renderMap;
     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>;
 }
 
@@ -2527,6 +2705,7 @@ declare const SAMPLE_FORMS: {
     demandDefinitionForm: string;
     projectInfoForm: string;
     faqForm: string;
+    locationForm: string;
 };
 
 declare const smartForm_examples_d_SAMPLE_FORMS: typeof SAMPLE_FORMS;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commons-shared-web-ui",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "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,