commons-shared-web-ui 0.0.52 → 0.0.53

package/ng-package.json

@@ -0,0 +1,28 @@
+{
+    "$schema": "./node_modules/ng-packagr/ng-package.schema.json",
+    "dest": "./dist/commons-shared-web-ui",
+    "lib": {
+        "entryFile": "src/public-api.ts"
+    },
+    "assets": [
+        "src/lib/styles/global.scss",
+        "src/lib/styles/utilities.scss",
+        "src/lib/modules/pagination/pagination.theme.scss",
+        "src/lib/modules/summary-card/summary-card.theme.scss",
+        "src/lib/modules/button/button.theme.scss",
+        "src/lib/modules/alert/alert.theme.scss",
+        "src/lib/modules/confirmation-modal/confirmation-modal.theme.scss",
+        "src/lib/modules/filter-sidebar/filter-sidebar.theme.scss",
+        "src/lib/modules/filter/filter.theme.scss",
+        "src/lib/modules/nav/nav.theme.scss",
+        "src/lib/modules/configurable-form/configurable-form.theme.scss",
+        "src/lib/modules/form-components/form-components.theme.scss",
+        "src/lib/modules/form-components/**/_theme.scss",
+        "src/lib/modules/smart-table/smart-table.theme.scss",
+        "src/lib/modules/smart-form/smart-form.theme.scss",
+        "src/lib/modules/side-nav/side-nav.theme.scss",
+        "src/lib/modules/form-builder/form-builder.theme.scss",
+        "src/lib/modules/filter-table-selector/filter-table-selector.theme.scss",
+        "src/lib/modules/snackbar/snackbar.theme.scss"
+    ]
+}

package/package.json

@@ -1,35 +1,54 @@
-{
-  "name": "commons-shared-web-ui",
-  "version": "0.0.52",
-  "peerDependencies": {
-    "@angular/animations": "20.3.15",
-    "@angular/cdk": "20.2.14",
-    "@angular/common": "20.3.15",
-    "@angular/compiler": "20.3.15",
-    "@angular/core": "20.3.15",
-    "@angular/forms": "20.3.15",
-    "@angular/material": "20.2.14",
-    "@angular/platform-browser": "20.3.15",
-    "@angular/platform-browser-dynamic": "20.3.15",
-    "@angular/router": "20.3.15",
-    "rxjs": "7.8.0",
-    "zone.js": "~0.14.0 || ~0.15.0",
-    "ngx-quill": "^28.0.0",
-    "quill": "^2.0.3"
-  },
-  "dependencies": {
-    "tslib": "^2.3.0"
-  },
-  "module": "fesm2022/commons-shared-web-ui.mjs",
-  "typings": "index.d.ts",
-  "exports": {
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./index.d.ts",
-      "default": "./fesm2022/commons-shared-web-ui.mjs"
-    }
-  },
-  "sideEffects": false
+{
+    "name": "commons-shared-web-ui",
+    "version": "0.0.53",
+    "peerDependencies": {
+        "@angular/animations": "20.3.15",
+        "@angular/cdk": "20.2.14",
+        "@angular/common": "20.3.15",
+        "@angular/compiler": "20.3.15",
+        "@angular/core": "20.3.15",
+        "@angular/forms": "20.3.15",
+        "@angular/material": "20.2.14",
+        "@angular/platform-browser": "20.3.15",
+        "@angular/platform-browser-dynamic": "20.3.15",
+        "@angular/router": "20.3.15",
+        "rxjs": "7.8.0",
+        "tslib": "^2.3.0",
+        "zone.js": "~0.14.0 || ~0.15.0",
+        "ngx-quill": "^28.0.0",
+        "quill": "^2.0.3"
+    },
+    "dependencies": {
+        "tslib": "^2.3.0"
+    },
+    "devDependencies": {
+        "@angular-devkit/build-angular": "20.3.13",
+        "@angular/animations": "20.3.15",
+        "@angular/cdk": "20.2.14",
+        "@angular/cli": "20.3.13",
+        "@angular/common": "20.3.15",
+        "@angular/compiler": "20.3.15",
+        "@angular/compiler-cli": "20.3.15",
+        "@angular/core": "20.3.15",
+        "@angular/forms": "20.3.15",
+        "@angular/material": "20.2.14",
+        "@angular/platform-browser": "20.3.15",
+        "@angular/platform-browser-dynamic": "20.3.15",
+        "@angular/router": "20.3.15",
+        "@types/jasmine": "~3.10.0",
+        "@types/node": "^20.11.1",
+        "jasmine-core": "~4.0.0",
+        "karma": "^6.4.4",
+        "karma-chrome-launcher": "~3.1.0",
+        "karma-coverage": "~2.1.0",
+        "karma-jasmine": "~4.0.0",
+        "karma-jasmine-html-reporter": "~1.7.0",
+        "ng-packagr": "^20.0.0",
+        "rxjs": "7.8.0",
+        "typescript": "^5.9.3",
+        "zone.js": "~0.15.0"
+    },
+    "scripts": {
+        "build": "ng-packagr -p ng-package.json"
+    }
 }

package/src/lib/modules/alert/alert.models.ts

@@ -0,0 +1,6 @@
+export type AlertVariant = 'info' | 'warning' | 'warning-shadow' | 'success' | 'error';
+export type IconInput = boolean | string | { type: 'material' | 'fontawesome' | 'img'; value: string };
+
+export interface AlertLabels {
+    iconAltText?: string;
+}

package/src/lib/modules/alert/alert.module.ts

@@ -0,0 +1,16 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { AlertComponent } from './components/alert/alert.component';
+
+@NgModule({
+    declarations: [
+        AlertComponent
+    ],
+    imports: [
+        CommonModule
+    ],
+    exports: [
+        AlertComponent
+    ]
+})
+export class AlertModule { }

package/src/lib/modules/alert/components/alert/alert.component.html

@@ -0,0 +1,27 @@
+<div class="cc-alert" [ngClass]="'cc-alert-' + variant" [style.width]="width" [style.height]="height"
+    [style.border-radius]="borderRadius" [style.border-top-left-radius]="borderTopLeftRadius"
+    [style.border-top-right-radius]="borderTopRightRadius" [style.border-bottom-left-radius]="borderBottomLeftRadius"
+    [style.border-bottom-right-radius]="borderBottomRightRadius" [style.padding]="padding" [style.gap]="gap"
+    [style.background-color]="backgroundColor" [style.color]="color" [style.border-color]="borderColor"
+    [style.font-size]="fontSize" [style.font-weight]="fontWeight" [style.box-shadow]="boxShadow">
+
+    <div class="cc-alert-icon" *ngIf="icon">
+        <i *ngIf="customIcon" [ngClass]="customIcon"></i>
+        <i *ngIf="!customIcon && isDefaultIcon" [ngClass]="defaultIconClass"></i>
+        <i *ngIf="!customIcon && isStringIcon && !isImgIcon" [ngClass]="iconString"></i>
+        <img *ngIf="!customIcon && isStringIcon && isImgIcon" [src]="iconString"
+            [attr.alt]="labels?.iconAltText || 'alert icon'" />
+        <ng-container *ngIf="isObjectIcon">
+            <i *ngIf="iconObject.type === 'fontawesome'" [ngClass]="iconObject.value"></i>
+            <span *ngIf="iconObject.type === 'material'" class="material-icons">{{ iconObject.value }}</span>
+            <img *ngIf="iconObject.type === 'img'" [src]="iconObject.value"
+                [attr.alt]="labels?.iconAltText || 'alert icon'" />
+        </ng-container>
+    </div>
+
+    <div class="cc-alert-content">
+        <div class="cc-alert-title" *ngIf="title">{{ title }}</div>
+        <div class="cc-alert-message" *ngIf="message">{{ message }}</div>
+        <ng-content></ng-content>
+    </div>
+</div>

package/src/lib/modules/alert/components/alert/alert.component.scss

@@ -0,0 +1,92 @@
+.cc-alert {
+    display: flex;
+    align-items: flex-start;
+    width: 100%;
+    padding: var(--cc-alert-padding, 1rem 2rem);
+    border-radius: var(--cc-alert-radius, 0.75rem);
+    gap: var(--cc-alert-gap, 1rem);
+    box-sizing: border-box;
+    font-family: var(--cc-alert-font-family, inherit);
+
+    .cc-alert-icon {
+        font-size: var(--cc-alert-icon-size, 1.25rem);
+        flex-shrink: 0;
+        margin-top: var(--cc-alert-icon-margin-top, 0.125rem);
+
+        img {
+            width: var(--cc-alert-icon-size, 1.25rem);
+            height: var(--cc-alert-icon-size, 1.25rem);
+            object-fit: contain;
+        }
+    }
+
+    .cc-alert-content {
+        display: flex;
+        flex-direction: column;
+        gap: 0.25rem; // Keeping small internal gap as is, or could be a var
+        flex-grow: 1;
+
+        .cc-alert-title {
+            font-weight: 700;
+            font-size: var(--cc-alert-title-size, 1rem);
+            line-height: var(--cc-alert-title-line-height, 1.5rem);
+        }
+
+        .cc-alert-message {
+            font-size: var(--cc-alert-message-size, 0.875rem);
+            line-height: 200%; // Relative unit is fine
+            opacity: 0.9;
+        }
+    }
+
+    // Variants
+    &.cc-alert-info {
+        background-color: var(--cc-alert-info-bg);
+        color: var(--cc-alert-info-color);
+
+        .cc-alert-icon {
+            color: #5F6368;
+        }
+    }
+
+    &.cc-alert-warning {
+        background-color: var(--cc-alert-warning-bg);
+        color: var(--cc-alert-warning-color);
+
+        .cc-alert-title {
+            color: var(--cc-alert-warning-title-color);
+        }
+
+        .cc-alert-icon {
+            color: var(--cc-alert-warning-title-color);
+        }
+    }
+
+    &.cc-alert-warning-shadow {
+        background-color: var(--cc-alert-warning-bg);
+        color: var(--cc-alert-warning-color);
+        box-shadow: var(--cc-alert-warning-shadow);
+
+        .cc-alert-title {
+            color: var(--cc-alert-warning-title-color);
+        }
+
+        .cc-alert-icon {
+            color: var(--cc-alert-warning-title-color);
+        }
+    }
+
+    &.cc-alert-success {
+        background-color: var(--cc-alert-success-bg);
+        color: var(--cc-alert-success-color);
+    }
+
+    &.cc-alert-error {
+        background-color: var(--cc-alert-error-bg);
+        color: var(--cc-alert-error-color);
+
+        .cc-alert-icon {
+            color: var(--cc-alert-error-color);
+        }
+    }
+}

package/src/lib/modules/alert/components/alert/alert.component.ts

@@ -0,0 +1,81 @@
+import { Component, Input, OnInit } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { AlertLabels, AlertVariant, IconInput } from '../../alert.models';
+
+@Component({
+    selector: 'lib-alert',
+    templateUrl: './alert.component.html',
+    styleUrls: ['./alert.component.scss'],
+    standalone: false
+})
+export class AlertComponent implements OnInit {
+    @Input() variant: AlertVariant = 'info';
+    @Input() title: string = '';
+    @Input() message: string = '';
+    @Input() icon: IconInput = true;
+    @Input() customIcon: string = ''; // New input for custom class
+    @Input() labels?: AlertLabels;
+
+    // Customization Inputs
+    @Input() width?: string;
+    @Input() height?: string;
+    @Input() borderRadius?: string;
+    @Input() padding?: string;
+    @Input() gap?: string;
+    @Input() backgroundColor?: string;
+    @Input() color?: string; // New input for custom text color
+    @Input() borderColor?: string;
+    @Input() fontSize?: string;
+    @Input() fontWeight?: string;
+    @Input() boxShadow?: string;
+
+    // Granular Border Radius Customization
+    @Input() borderTopLeftRadius?: string;
+    @Input() borderTopRightRadius?: string;
+    @Input() borderBottomLeftRadius?: string;
+    @Input() borderBottomRightRadius?: string;
+
+    constructor() { }
+
+    ngOnInit(): void {
+    }
+
+    get isDefaultIcon(): boolean {
+        return this.icon === true;
+    }
+
+    get isStringIcon(): boolean {
+        return typeof this.icon === 'string';
+    }
+
+    get isObjectIcon(): boolean {
+        return typeof this.icon === 'object' && this.icon !== null;
+    }
+
+    get iconString(): string {
+        return typeof this.icon === 'string' ? this.icon : '';
+    }
+
+    get isImgIcon(): boolean {
+        const icon = this.icon;
+        if (typeof icon === 'string') {
+            return icon.includes('/') || icon.includes('.') || icon.startsWith('http');
+        }
+        return typeof icon === 'object' && icon !== null && icon.type === 'img';
+    }
+
+    get iconObject(): { type: string; value: string } {
+        return typeof this.icon === 'object' ? this.icon as any : { type: '', value: '' };
+    }
+
+    get defaultIconClass(): string {
+        switch (this.variant) {
+            case 'success': return 'fa-solid fa-circle-check';
+            case 'warning':
+            case 'warning-shadow': return 'fa-solid fa-triangle-exclamation';
+            case 'error': return 'fa-solid fa-triangle-exclamation';
+            case 'info':
+            default: return 'fa-solid fa-circle-info';
+        }
+    }
+}

package/src/lib/modules/button/button.models.ts

@@ -0,0 +1,13 @@
+export type ButtonVariant =
+    | 'primary'
+    | 'warning'
+    | 'outline'
+    | 'secondary'
+    | 'success'
+    | 'danger'
+    | 'danger-outline'
+    | 'text';
+
+export interface ButtonLabels {
+    iconAltText?: string;
+}

package/src/lib/modules/button/button.module.ts

@@ -0,0 +1,16 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { ButtonComponent } from './components/button/button.component';
+
+@NgModule({
+  declarations: [
+    ButtonComponent
+  ],
+  imports: [
+    CommonModule
+  ],
+  exports: [
+    ButtonComponent
+  ]
+})
+export class ButtonModule { }

package/src/lib/modules/button/components/button/button.component.html

@@ -0,0 +1,22 @@
+<button [type]="type" [disabled]="disabled" class="cc-btn" [ngClass]="'cc-btn-' + variant" [style.width]="width"
+  [style.height]="height" [style.border-radius]="borderRadius" [style.font-size]="fontSize"
+  [style.font-weight]="fontWeight" [style.background-color]="backgroundColor" [style.color]="color"
+  [style.border]="border">
+  <div class="cc-btn-icon-wrapper" *ngIf="icon">
+    <!-- String Icons -->
+    <ng-container *ngIf="isStringIcon">
+      <i *ngIf="!isImgIcon" [ngClass]="iconString" class="cc-btn-icon"></i>
+      <img *ngIf="isImgIcon" [src]="iconString" [attr.alt]="labels?.iconAltText || 'button icon'"
+        class="cc-btn-icon cc-btn-img-icon" />
+    </ng-container>
+
+    <!-- Object Icons -->
+    <ng-container *ngIf="isObjectIcon">
+      <i *ngIf="iconObject.type === 'fontawesome'" [ngClass]="iconObject.value" class="cc-btn-icon"></i>
+      <span *ngIf="iconObject.type === 'material'" class="material-icons cc-btn-icon">{{ iconObject.value }}</span>
+      <img *ngIf="iconObject.type === 'img'" [src]="iconObject.value" [attr.alt]="labels?.iconAltText || 'button icon'"
+        class="cc-btn-icon cc-btn-img-icon" />
+    </ng-container>
+  </div>
+  <ng-content></ng-content>
+</button>

package/src/lib/modules/button/components/button/button.component.scss

@@ -0,0 +1,88 @@
+.cc-btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    box-sizing: border-box;
+    cursor: pointer;
+    transition: all 0.2s ease-in-out;
+
+    // Common styles from variables
+    font-family: var(--cc-btn-font-family);
+    font-weight: var(--cc-btn-font-weight);
+    font-size: var(--cc-btn-font-size);
+    padding: var(--cc-btn-padding);
+
+    // Disabled State
+    &:disabled {
+        opacity: var(--cc-btn-disabled-opacity);
+        cursor: var(--cc-btn-disabled-cursor);
+        pointer-events: none;
+    }
+
+    // Variants
+    &.cc-btn-primary {
+        background-color: var(--cc-btn-primary-bg);
+        color: var(--cc-btn-primary-color);
+        border-radius: var(--cc-btn-primary-radius);
+        border: var(--cc-btn-primary-border);
+    }
+
+    &.cc-btn-warning {
+        background-color: var(--cc-btn-warning-bg);
+        color: var(--cc-btn-warning-color);
+        border-radius: var(--cc-btn-warning-radius);
+        border: var(--cc-btn-warning-border);
+    }
+
+    &.cc-btn-outline {
+        background-color: var(--cc-btn-outline-bg);
+        color: var(--cc-btn-outline-color);
+        border-radius: var(--cc-btn-outline-radius);
+        border: var(--cc-btn-outline-border);
+    }
+
+    &.cc-btn-secondary {
+        background-color: var(--cc-btn-secondary-bg);
+        color: var(--cc-btn-secondary-color);
+        border-radius: var(--cc-btn-secondary-radius);
+        border: var(--cc-btn-secondary-border);
+    }
+
+    &.cc-btn-success {
+        background-color: var(--cc-btn-success-bg);
+        color: var(--cc-btn-success-color);
+        border-radius: var(--cc-btn-success-radius);
+        border: var(--cc-btn-success-border);
+    }
+
+    &.cc-btn-danger {
+        background-color: var(--cc-btn-danger-bg);
+        color: var(--cc-btn-danger-color);
+        border-radius: var(--cc-btn-danger-radius);
+        border: var(--cc-btn-danger-border);
+    }
+
+    &.cc-btn-danger-outline {
+        background-color: var(--cc-btn-danger-outline-bg);
+        color: var(--cc-btn-danger-outline-color);
+        border-radius: var(--cc-btn-danger-outline-radius);
+        border: var(--cc-btn-danger-outline-border);
+    }
+
+    .cc-btn-icon-wrapper {
+        display: inline-flex;
+        align-items: center;
+        margin-right: 0.5rem; // 8px
+    }
+
+    .cc-btn-icon {
+        font-size: 1.1em;
+        line-height: 1;
+    }
+
+    .cc-btn-img-icon {
+        width: 1.25rem;
+        height: 1.25rem;
+        object-fit: contain;
+    }
+}

package/src/lib/modules/button/components/button/button.component.ts

@@ -0,0 +1,67 @@
+import { Component, Input, OnInit, HostBinding } from '@angular/core';
+
+import { ButtonLabels, ButtonVariant } from '../../button.models';
+
+@Component({
+    selector: 'lib-button',
+    templateUrl: './button.component.html',
+    styleUrls: ['./button.component.scss'],
+    standalone: false
+})
+export class ButtonComponent implements OnInit {
+
+    @Input() variant: ButtonVariant = 'primary';
+    @Input() type: 'button' | 'submit' | 'reset' = 'button';
+    @Input() disabled: boolean = false;
+
+    @HostBinding('style.pointer-events')
+    get pointerEvents(): string {
+        return this.disabled ? 'none' : 'auto';
+    }
+
+    // Customization Inputs
+    @Input() width?: string;
+    @Input() height?: string;
+    @Input() borderRadius?: string;
+    @Input() fontSize?: string;
+    @Input() fontWeight?: string;
+    @Input() backgroundColor?: string;
+    @Input() color?: string;
+    @Input() border?: string;
+    @Input() icon: boolean | string | { type: 'material' | 'fontawesome' | 'img'; value: string } = '';
+    @Input() labels?: ButtonLabels;
+
+    constructor() { }
+
+    ngOnInit(): void {
+    }
+
+    get isDefaultIcon(): boolean {
+        return this.icon === true;
+    }
+
+    get isStringIcon(): boolean {
+        return typeof this.icon === 'string' && this.icon !== '';
+    }
+
+    get isImgIcon(): boolean {
+        const icon = this.icon;
+        if (typeof icon === 'string') {
+            return icon.includes('/') || icon.includes('.') || icon.startsWith('http');
+        }
+        return typeof icon === 'object' && icon !== null && !!icon.value && (icon.type === 'img' || icon.value.includes('/') || icon.value.includes('.') || icon.value.startsWith('http'));
+    }
+
+    get isObjectIcon(): boolean {
+        return typeof this.icon === 'object' && this.icon !== null;
+    }
+
+    get iconString(): string {
+        return typeof this.icon === 'string' ? this.icon : '';
+    }
+
+    get iconObject(): { type: string; value: string } {
+        return typeof this.icon === 'object' ? this.icon as any : { type: '', value: '' };
+    }
+
+}

package/src/lib/modules/button-dropdown/button-dropdown.models.ts

@@ -0,0 +1,26 @@
+import { ButtonVariant } from '../button/button.models';
+
+export interface DropdownAction {
+    label: string;
+    type: 'api' | 'route' | 'callback';
+    icon?: string;
+    color?: string; // Generic override
+    variant?: ButtonVariant; // Explict variant (primary, warning, danger, etc)
+
+    // For 'route' type
+    route?: string;
+
+    // For 'api' type
+    apiUrl?: string;
+    apiMethod?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    apiPayload?: any;
+
+    // For 'callback' type
+    callback?: (data: any) => void;
+
+    // Universal options
+    disabled?: boolean;
+    confirmationNeeded?: boolean;
+    confirmationMessage?: string;
+    confirmationTitle?: string;
+}

package/src/lib/modules/button-dropdown/button-dropdown.module.ts

@@ -0,0 +1,22 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { RouterModule } from '@angular/router';
+import { ButtonDropdownComponent } from './components/button-dropdown/button-dropdown.component';
+import { ButtonModule } from '../button/button.module';
+import { ConfirmationModalModule } from '../confirmation-modal/confirmation-modal.module';
+
+@NgModule({
+    declarations: [
+        ButtonDropdownComponent
+    ],
+    imports: [
+        CommonModule,
+        RouterModule,
+        ButtonModule,
+        ConfirmationModalModule
+    ],
+    exports: [
+        ButtonDropdownComponent
+    ]
+})
+export class ButtonDropdownModule { }