platformcommons-web-lib 1.0.0

package/src/lib/modules/smart-form/utils/translation.utils.ts

@@ -0,0 +1,82 @@
+import { FieldConfig, FormSchema } from '../models/form-schema.model';
+
+/**
+ * Utility class for translating Smart Form schemas.
+ */
+export class SmartFormTranslationUtils {
+
+    /**
+     * Recursively walks the schema and replaces i18n keys with values from labels map.
+     * @param schema The FormSchema to translate.
+     * @param labels The labels map (can be flat or contain labelsObject property).
+     */
+    static translateSchema(schema: FormSchema, labels: any): void {
+        if (!schema || !labels) return;
+
+        // Support both flat labels map and the pattern used in ConfigurableForm which passes { labelsObject: ... }
+        const labelsMap = labels.labelsObject || labels;
+        const translate = (key: string) => labelsMap[key] || key;
+
+        // Root properties
+        if (schema.label) schema.label = translate(schema.label);
+        if (schema.description) schema.description = translate(schema.description);
+
+        // Submit config
+        if (schema.submitConfig) {
+            if (schema.submitConfig.successMessage) schema.submitConfig.successMessage = translate(schema.submitConfig.successMessage);
+            if (schema.submitConfig.errorMessage) schema.submitConfig.errorMessage = translate(schema.submitConfig.errorMessage);
+        }
+
+        // Section config
+        if (schema.sectionConfig) {
+            this.translateSection(schema.sectionConfig, translate);
+        }
+
+        // Stepper config
+        if (schema.stepperConfig?.children) {
+            schema.stepperConfig.children.forEach(field => this.translateField(field, translate));
+        }
+    }
+
+    private static translateSection(section: any, translate: (key: string) => string): void {
+        if (section.label) section.label = translate(section.label);
+        if (section.children) {
+            section.children.forEach((field: FieldConfig) => this.translateField(field, translate));
+        }
+    }
+
+    private static translateField(field: FieldConfig, translate: (key: string) => string): void {
+        if (field.label) field.label = translate(field.label);
+        if (field.placeholder) field.placeholder = translate(field.placeholder);
+        if (field.hint) field.hint = translate(field.hint);
+
+        if (field.richTextConfig?.placeholder) {
+            field.richTextConfig.placeholder = translate(field.richTextConfig.placeholder);
+        }
+
+        if (field.textConfig?.patternMessage) {
+            field.textConfig.patternMessage = translate(field.textConfig.patternMessage);
+        }
+
+        if (field.attachmentConfig?.acceptLabel) {
+            field.attachmentConfig.acceptLabel = translate(field.attachmentConfig.acceptLabel);
+        }
+
+        if (field.optionConfig?.optionList) {
+            field.optionConfig.optionList.forEach(opt => {
+                if (opt.label) opt.label = translate(opt.label);
+                if (opt.hint) opt.hint = translate(opt.hint);
+            });
+        }
+
+        // Recurse into children (ROW or GROUP)
+        if (field.children) {
+            field.children.forEach(child => this.translateField(child, translate));
+        }
+
+        // Recurse into nested section config
+        if (field.sectionConfig) {
+            this.translateSection(field.sectionConfig, translate);
+        }
+    }
+}

package/src/lib/modules/smart-form/utils/trusted-url.pipe.ts

@@ -0,0 +1,25 @@
+import { Pipe, PipeTransform, SecurityContext } from '@angular/core';
+import { DomSanitizer, SafeResourceUrl } from '@angular/platform-browser';
+
+/**
+ * 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.
+ */
+@Pipe({
+    name: 'trustedUrl',
+    standalone: false
+})
+export class TrustedUrlPipe implements PipeTransform {
+    constructor(private sanitizer: DomSanitizer) { }
+
+    transform(url: string): SafeResourceUrl | null {
+        if (!url) {
+            return null;
+        }
+        const cleaned = this.sanitizer.sanitize(SecurityContext.URL, url);
+        if (!cleaned) {
+            return null;
+        }
+        return this.sanitizer.bypassSecurityTrustResourceUrl(cleaned);
+    }
+}

package/src/lib/modules/smart-form/utils/validation.utils.ts

@@ -0,0 +1,98 @@
+import { AbstractControl, FormGroup, ValidationErrors, ValidatorFn } from '@angular/forms';
+
+export class ValidationUtils {
+
+
+
+  static email(): ValidatorFn {
+    return (control: AbstractControl): ValidationErrors | null => {
+      if (!control.value) return null;
+      const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+      return emailRegex.test(control.value) ? null : { email: true };
+    };
+  }
+
+  static phone(): ValidatorFn {
+    return (control: AbstractControl): ValidationErrors | null => {
+      if (!control.value) return null;
+      const phoneRegex = /^\+?[\d\s\-\(\)]{10,}$/;
+      return phoneRegex.test(control.value) ? null : { phone: true };
+    };
+  }
+
+  static url(): ValidatorFn {
+    return (control: AbstractControl): ValidationErrors | null => {
+      if (!control.value) return null;
+      const urlRegex = /^https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_\+.~#?&//=]*)$/;
+      return urlRegex.test(control.value) ? null : { url: true };
+    };
+  }
+
+  static minLength(min: number): ValidatorFn {
+    return (control: AbstractControl): ValidationErrors | null => {
+      if (!control.value) return null;
+      return control.value.length >= min ? null : { minLength: { min, actual: control.value.length } };
+    };
+  }
+
+  static maxLength(max: number): ValidatorFn {
+    return (control: AbstractControl): ValidationErrors | null => {
+      if (!control.value) return null;
+      return control.value.length <= max ? null : { maxLength: { max, actual: control.value.length } };
+    };
+  }
+
+  static pattern(pattern: string, message?: string): ValidatorFn {
+    return (control: AbstractControl): ValidationErrors | null => {
+      if (!control.value) return null;
+      const regex = new RegExp(pattern);
+      return regex.test(control.value) ? null : { pattern: { message: message || 'Invalid format' } };
+    };
+  }
+
+  static numberRange(min?: number, max?: number): ValidatorFn {
+    return (control: AbstractControl): ValidationErrors | null => {
+      if (!control.value && control.value !== 0) return null;
+      const value = Number(control.value);
+      if (min !== undefined && value < min) {
+        return { min: { min, actual: value } };
+      }
+      if (max !== undefined && value > max) {
+        return { max: { max, actual: value } };
+      }
+      return null;
+    };
+  }
+
+  static dateRange(minDate?: string, maxDate?: string): ValidatorFn {
+    return (control: AbstractControl): ValidationErrors | null => {
+      if (!control.value) return null;
+      const date = new Date(control.value);
+      if (minDate && date < new Date(minDate)) {
+        return { minDate: { minDate } };
+      }
+      if (maxDate && date > new Date(maxDate)) {
+        return { maxDate: { maxDate } };
+      }
+      return null;
+    };
+  }
+
+  static getErrorMessage(errors: ValidationErrors | null): string {
+    if (!errors) return '';
+
+    if (errors['required']) return 'This field is required';
+    if (errors['email']) return 'Please enter a valid email address';
+    if (errors['phone']) return 'Please enter a valid phone number';
+    if (errors['url']) return 'Please enter a valid URL';
+    if (errors['minLength']) return `Minimum length is ${errors['minLength'].min} characters`;
+    if (errors['maxLength']) return `Maximum length is ${errors['maxLength'].max} characters`;
+    if (errors['min']) return `Minimum value is ${errors['min'].min}`;
+    if (errors['max']) return `Maximum value is ${errors['max'].max}`;
+    if (errors['minDate']) return `Date must be after ${errors['minDate'].minDate}`;
+    if (errors['maxDate']) return `Date must be before ${errors['maxDate'].maxDate}`;
+    if (errors['pattern']) return errors['pattern'].message || 'Invalid format';
+
+    return 'Invalid value';
+  }
+}

package/src/lib/modules/smart-table/components/smart-table/smart-table.component.html

@@ -0,0 +1,283 @@
+<div class="smart-table-outer">
+  <!-- Table Card -->
+  <div class="smart-table-wrapper">
+    <!-- Top Toolbar -->
+    <div class="st-toolbar" *ngIf="config.searchConfig?.enabled || (config.filters && config.filters.length > 0) || (config.topBarButtons && config.topBarButtons.length > 0)">
+
+      <!-- Search -->
+      <div class="st-search" *ngIf="config.searchConfig?.enabled">
+        <i class="fa fa-search"></i>
+        <input type="text" [placeholder]="config.labels?.searchPlaceholder || 'Search'" (input)="onSearch($event)">
+      </div>
+
+      <!-- Filters -->
+      <div class="st-filters" *ngIf="config.filters">
+        <div class="st-filter-item" *ngFor="let filter of config.filters">
+          <!-- Trigger -->
+          <div class="st-filter-trigger"
+               [class.active]="openFilterKey === filter.key"
+               [class.has-value]="isFilterActive(filter)"
+               (click)="toggleFilter(filter.key, $event)">
+            <span class="st-filter-trigger-label">{{ getFilterDisplay(filter) }}</span>
+            <svg class="st-filter-chevron" width="12" height="12" viewBox="0 0 12 12" fill="none">
+              <path d="M2.5 4.5L6 8L9.5 4.5" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+            </svg>
+          </div>
+        </div>
+      </div>
+
+      <!-- Top Bar Buttons -->
+      <div class="st-actions" *ngIf="config.topBarButtons">
+        <lib-button *ngFor="let btn of config.topBarButtons"
+                    [variant]="btn.btnVariant || 'primary'"
+                    [icon]="btn.icon || ''"
+                    (click)="onTopAction(btn)">
+          {{ btn.label }}
+        </lib-button>
+      </div>
+    </div>
+
+    <!-- Selection count strip — visible whenever selectable is enabled -->
+    <div class="st-selection-strip" *ngIf="config.selectable">
+      <span class="st-selection-count">{{ selectedRows.length }} of {{ totalItems > 0 ? totalItems : data.length }} selected</span>
+    </div>
+
+    <!-- Table Container -->
+    <div class="st-table-container">
+      <div class="st-check-loader" *ngIf="loading">
+          <div class="spinner"></div>
+      </div>
+      <table class="st-table" [class.loading-data]="loading" [class.is-selectable]="config.selectable">
+        <thead>
+          <tr>
+            <th *ngIf="config.selectable" class="st-checkbox-col">
+              <input type="checkbox" (change)="onSelectAll($event)">
+            </th>
+            <th *ngFor="let col of config.columns; let colIndex = index"
+                #stickyHeader
+                [class.sortable]="col.sortable"
+                [class.sticky-col]="col.sticky"
+                [class.first-data-col]="colIndex === 0"
+                [ngStyle]="stickyColumnStyles[col.key]"
+                (click)="onSort(col)">
+              {{ col.label }}
+              <span *ngIf="col.sortable" class="sort-icon-wrap">
+                <svg width="18" height="18" viewBox="0 0 18 18" fill="none">
+                  <!-- Down arrow — RIGHT side, prominent when DESC -->
+                  <path d="M11.258 15.8153L14.5913 13.2699C14.7483 13.15 14.8364 12.9875 14.8364 12.818C14.8364 12.6486 14.7483 12.4861 14.5913 12.3662C14.4344 12.2464 14.2216 12.1791 13.9997 12.1791C13.7778 12.1791 13.5649 12.2464 13.408 12.3662L11.4997 13.8299V2.63636C11.4997 2.46758 11.4119 2.30572 11.2556 2.18638C11.0993 2.06704 10.8874 2 10.6663 2C10.4453 2 10.2334 2.06704 10.0771 2.18638C9.92081 2.30572 9.83301 2.46758 9.83301 2.63636V15.3635C9.83383 15.4891 9.88333 15.6117 9.97528 15.7159C10.0672 15.8201 10.1975 15.9012 10.3497 15.9489C10.4486 15.9845 10.557 16.002 10.6663 15.9998C10.776 16.0003 10.8847 15.9843 10.9863 15.9526C11.0878 15.9209 11.1801 15.8743 11.258 15.8153Z"
+                        fill="black" [attr.fill-opacity]="getDescOpacity(col.key)"/>
+                  <!-- Up arrow — LEFT side, prominent when ASC -->
+                  <path d="M7.33316 16C7.11215 16 6.90019 15.933 6.74391 15.8136C6.58763 15.6942 6.49983 15.5324 6.49983 15.3636V4.16902L4.5915 5.63278C4.43458 5.75262 4.22175 5.81995 3.99983 5.81995C3.77791 5.81995 3.56508 5.75262 3.40816 5.63278C3.25124 5.51294 3.16309 5.3504 3.16309 5.18093C3.16309 5.01145 3.25124 4.84891 3.40816 4.72907L6.7415 2.18341C6.85868 2.0951 7.00749 2.03528 7.16915 2.01149C7.33081 1.98771 7.49807 2.00102 7.64983 2.04976C7.80201 2.0975 7.93228 2.17858 8.02423 2.28278C8.11617 2.38697 8.16567 2.50962 8.1665 2.63526V15.3636C8.1665 15.5324 8.0787 15.6942 7.92242 15.8136C7.76614 15.933 7.55418 16 7.33316 16Z"
+                        fill="black" [attr.fill-opacity]="getAscOpacity(col.key)"/>
+                </svg>
+              </span>
+            </th>
+            <th *ngIf="config.actions && config.actions.length > 0" class="st-actions-col">
+              {{ config.labels?.actionColumnHeader || 'Actions' }}
+            </th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr *ngFor="let row of data; let rowIndex = index" [class.editing-row]="row.isEditing" [ngClass]="row.isEditing && config.editingRowClass ? config.editingRowClass : ''">
+            <td *ngIf="config.selectable" class="st-checkbox-col">
+              <input type="checkbox" [(ngModel)]="row.selected" (change)="onRowSelect(row)">
+            </td>
+            <td *ngFor="let col of config.columns; let colIndex = index"
+                [class.sticky-col]="col.sticky"
+                [class.first-data-col]="colIndex === 0"
+                [ngStyle]="stickyColumnStyles[col.key]"
+                [class.clickable-cell]="col.clickAction"
+                (click)="onColumnClick(row, col)">
+              <!-- READ MODE -->
+              <ng-container *ngIf="!row.isEditing">
+                <!-- Text/Number/Date -->
+                <span *ngIf="col.type !== 'custom' && col.type !== 'html' && col.type !== 'badge'">
+                  {{ getCellValue(row, col) }}
+                </span>
+                <!-- HTML -->
+                <div *ngIf="col.type === 'html'" [innerHTML]="getCellValue(row, col) | safeHtml"></div>
+                <!-- Badge -->
+                <span *ngIf="col.type === 'badge'" class="st-badge" [ngClass]="getBadgeClass(row, col)">
+                    {{ getCellValue(row, col) }}
+                </span>
+              </ng-container>
+
+              <!-- EDIT/ADD MODE -->
+              <ng-container *ngIf="row.isEditing">
+                <!-- Multi-field cell (stacked inputs) -->
+                <div *ngIf="col.subFields" class="st-stacked-inputs">
+                  <ng-container *ngFor="let sub of col.subFields">
+                    <select *ngIf="sub.dataType === 'select'"
+                            [(ngModel)]="row[sub.key]"
+                            [disabled]="sub.editable === false || col.editConfig?.disabled"
+                            class="st-cell-select">
+                      <option *ngFor="let opt of sub.options" [value]="opt.value">{{ opt.label }}</option>
+                    </select>
+                    <!-- Date picker -->
+                    <div *ngIf="sub.dataType === 'date'" class="st-date-cell">
+                      <input matInput [matDatepicker]="subPicker"
+                             [(ngModel)]="row[sub.key]"
+                             [disabled]="sub.editable === false || col.editConfig?.disabled"
+                             [placeholder]="sub.placeholder || ''"
+                             class="st-cell-input"
+                             (click)="subPicker.open()">
+                      <mat-datepicker-toggle [for]="subPicker"></mat-datepicker-toggle>
+                      <mat-datepicker #subPicker></mat-datepicker>
+                    </div>
+                    <input *ngIf="sub.dataType !== 'select' && sub.dataType !== 'date'"
+                           [type]="sub.dataType"
+                           [(ngModel)]="row[sub.key]"
+                           [disabled]="sub.editable === false || col.editConfig?.disabled"
+                           [placeholder]="sub.placeholder || ''"
+                           class="st-cell-input">
+                  </ng-container>
+                </div>
+
+                <!-- Single field cell input -->
+                <div *ngIf="!col.subFields">
+                  <select *ngIf="col.dataType === 'select'"
+                          [(ngModel)]="row[col.key]"
+                          [disabled]="col.editable === false || col.editConfig?.disabled"
+                          class="st-cell-select">
+                    <option *ngFor="let opt of col.options" [value]="opt.value">{{ opt.label }}</option>
+                  </select>
+                  <!-- Date picker -->
+                  <div *ngIf="col.dataType === 'date'" class="st-date-cell">
+                    <input matInput [matDatepicker]="colPicker"
+                           [(ngModel)]="row[col.key]"
+                           [disabled]="col.editable === false || col.editConfig?.disabled"
+                           class="st-cell-input"
+                           (click)="colPicker.open()">
+                    <mat-datepicker-toggle [for]="colPicker"></mat-datepicker-toggle>
+                    <mat-datepicker #colPicker></mat-datepicker>
+                  </div>
+                  <input *ngIf="col.dataType !== 'select' && col.dataType !== 'date'"
+                         [type]="col.dataType || 'text'"
+                         [(ngModel)]="row[col.key]"
+                         [disabled]="col.editable === false || col.editConfig?.disabled"
+                         class="st-cell-input">
+                </div>
+              </ng-container>
+            </td>
+
+            <!-- Row Actions -->
+            <td *ngIf="config.actions && config.actions.length > 0" class="st-row-actions st-actions-col">
+              <div class="action-buttons">
+                <!-- EDIT MODE ACTIONS -->
+                <ng-container *ngIf="row.isEditing">
+                  <div class="edit-mode-actions">
+                    <lib-button variant="outline" (click)="onCancelRow(row, rowIndex); $event.stopPropagation()">
+                      {{ config.labels?.cancelLabel || 'Cancel' }}
+                    </lib-button>
+                    <lib-button [variant]="row.isNew ? (config.labels?.addButtonVariant || 'danger') : (config.labels?.saveButtonVariant || 'primary')" (click)="onSaveRow(row); $event.stopPropagation()">
+                      {{ row.isNew ? (config.labels?.addLabel || 'Add') : (config.labels?.saveLabel || 'Save') }}
+                    </lib-button>
+                  </div>
+                </ng-container>
+
+                <!-- READ MODE ACTIONS -->
+                <ng-container *ngIf="!row.isEditing">
+                  <ng-container *ngFor="let action of config.actions; let i = index">
+                      <ng-container *ngIf="action.type === 'dropdown'">
+                          <div class="st-dropdown-container" (click)="$event.stopPropagation()">
+                              <button class="st-dropdown-btn"
+                                      [class.active]="openDropdownId === (rowIndex + '-' + i)"
+                                      (click)="toggleDropdown(rowIndex + '-' + i, $event, action.items, row)">
+                                  <span class="action-circle">
+                                    <i class="fa fa-ellipsis-h"></i>
+                                  </span>
+                              </button>
+                          </div>
+                      </ng-container>
+                      <ng-container *ngIf="action.type !== 'dropdown'">
+                        <lib-button
+                           [variant]="action.btnVariant || 'secondary'"
+                           [icon]="action.icon || ''"
+                           (click)="onAction(action, row)">
+                           {{ action.label }}
+                       </lib-button>
+                      </ng-container>
+                  </ng-container>
+                </ng-container>
+              </div>
+            </td>
+          </tr>
+          <tr *ngIf="data.length === 0 && !loading">
+              <td [attr.colspan]="columnCount + (config.selectable ? 1 : 0) + (config.actions ? 1 : 0)" class="no-data">
+                  {{ config.labels?.noDataMessage || 'No data available' }}
+              </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+
+    <!-- Pagination — inside the card, sticks to the bottom -->
+    <div class="st-pagination" *ngIf="showPagination">
+      <lib-pagination
+        [totalItems]="totalItems"
+        [itemsPerPage]="config.pagination!.pageSize"
+        [currentPage]="currentPage"
+        [pageSizeOptions]="config.pagination!.pageSizeOptions"
+        (pageChange)="onPageChange($event)"
+        (itemsPerPageChange)="onPageSizeChange($event)">
+      </lib-pagination>
+    </div>
+
+    <!-- Built-in Delete Confirmation Modal -->
+    <cc-confirmation-modal
+      [isOpen]="deleteModalOpen"
+      [config]="deleteModalConfig"
+      (confirm)="onDeleteConfirm()"
+      (cancel)="onDeleteCancel()"
+      (close)="onDeleteCancel()">
+      <p>{{ deleteModalMessage }}</p>
+    </cc-confirmation-modal>
+  </div>
+</div>
+
+<!--
+  Filter panel portal — position:fixed keeps it above all overflow/sticky containers.
+-->
+<div class="st-filter-panel"
+     *ngIf="openFilterKey !== null && activeFilterData"
+     [ngStyle]="{
+       position: 'fixed',
+       top: filterPosition.top + 'px',
+       left: filterPosition.left + 'px',
+       'z-index': '99999'
+     }"
+     (click)="$event.stopPropagation()">
+  <div class="st-filter-option"
+       [class.selected]="!isFilterActive(activeFilterData)"
+       (click)="selectFilterOption(activeFilterData, null)">
+    All {{ activeFilterData.label }}
+  </div>
+  <div class="st-filter-option"
+       *ngFor="let opt of getValidFilterOptions(activeFilterData)"
+       [class.selected]="activeFilters[activeFilterData.key] === opt.value"
+       (click)="selectFilterOption(activeFilterData, opt)">
+    {{ opt.label }}
+  </div>
+</div>
+
+<!--
+  Dropdown portal — rendered OUTSIDE every scroll/sticky container.
+  position:fixed + z-index:99999 here is unconditionally above all sticky table cells.
+-->
+<div class="st-dropdown-menu st-dropdown-portal"
+     *ngIf="openDropdownId !== null && activeDropdownItems"
+     [ngStyle]="{
+       position: 'fixed',
+       top: dropdownPosition.top + 'px',
+       right: dropdownPosition.right + 'px',
+       left: 'auto',
+       'z-index': '99999'
+     }"
+     (click)="$event.stopPropagation()">
+  <button class="st-dropdown-item"
+          *ngFor="let item of activeDropdownItems"
+          (click)="onActionItemClick(item, activeDropdownRow, $event); closeDropdown()">
+    <i *ngIf="item.icon" [class]="item.icon + ' st-action-icon'"></i>
+    <span>{{ item.label }}</span>
+  </button>
+</div>