commons-shared-web-ui 0.0.54 → 0.0.55

package/src/lib/modules/table-column-configuration/models/table-column-configuration.models.ts

@@ -0,0 +1,20 @@
+import { TableColumn } from '../../smart-table/models/table-config.model';
+
+/**
+ * A single editable column row in the column configurator.
+ * Wraps a TableColumn with its visibility + lock state.
+ *
+ * `column` is a live reference into the module's working (cloned) config, so
+ * writing the node state back onto it is all that's needed to produce the
+ * updated config — no fragile index re-matching required.
+ */
+export interface ConfigColumnNode {
+  /** Live reference to the TableColumn inside the working config clone. */
+  column: TableColumn;
+  /** Raw label (i18n key or text); resolved through the optional translate fn at render time. */
+  label: string;
+  /** Whether the column is shown in the table. */
+  visible: boolean;
+  /** When true, the visibility toggle is locked ON (column can never be hidden). */
+  lockVisibility: boolean;
+}

package/src/lib/modules/table-column-configuration/services/table-column-configuration.service.ts

@@ -0,0 +1,77 @@
+import { Injectable, computed, signal } from '@angular/core';
+import { TableColumn, TableConfig } from '../../smart-table/models/table-config.model';
+import { ConfigColumnNode } from '../models/table-column-configuration.models';
+
+interface TableColumnConfigurationState {
+  columns: ConfigColumnNode[];
+  /** Deep clone of the input config; node references point into this object. */
+  workingConfig: TableConfig | null;
+}
+
+/**
+ * Signal-based store for the table-column-configuration component.
+ * Owns the column list and the visibility toggle logic.
+ * Provided at the component level (one store instance per configurator).
+ */
+@Injectable()
+export class TableColumnConfigurationService {
+  private readonly _state = signal<TableColumnConfigurationState>({
+    columns: [],
+    workingConfig: null,
+  });
+
+  readonly columns = computed(() => this._state().columns);
+
+  // ── Load ──────────────────────────────────────────────────────────────────
+
+  /**
+   * Initialise from an input table config. The config is deep-cloned so the
+   * caller's object is never mutated; the nodes reference the clone.
+   */
+  loadConfig(config: TableConfig): void {
+    const workingConfig: TableConfig = JSON.parse(JSON.stringify(config));
+    const columns = (workingConfig.columns ?? []).map(col => this._buildColumn(col));
+    this._state.set({ columns, workingConfig });
+  }
+
+  // ── Mutations ─────────────────────────────────────────────────────────────
+
+  /** Toggle a column's visibility. Locked columns are ignored. */
+  toggleColumnVisible(index: number): void {
+    this._state.update(state => ({
+      ...state,
+      columns: state.columns.map((c, i) =>
+        i === index && !c.lockVisibility ? { ...c, visible: !c.visible } : c,
+      ),
+    }));
+  }
+
+  // ── Output ────────────────────────────────────────────────────────────────
+
+  /**
+   * Produce the updated config. Writes the current node state onto the working
+   * clone and returns a fresh deep clone (safe to hand to the host / persist).
+   * Returns null if no config has been loaded.
+   */
+  buildUpdatedConfig(): TableConfig | null {
+    const { columns, workingConfig } = this._state();
+    if (!workingConfig) return null;
+    for (const node of columns) {
+      node.column.isEnabled = node.visible;
+      node.column.visible = node.visible; // backward compatibility
+    }
+    return JSON.parse(JSON.stringify(workingConfig));
+  }
+
+  // ── Private helpers ─────────────────────────────────────────────────────────
+
+  private _buildColumn(column: TableColumn): ConfigColumnNode {
+    const visible = column.isEnabled ?? column.visible ?? true;
+    return {
+      column,
+      label: column.label || column.key || 'Column',
+      visible,
+      lockVisibility: column.lockVisibility === true,
+    };
+  }
+}

package/src/lib/modules/table-column-configuration/table-column-configuration.module.ts

@@ -0,0 +1,21 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+
+import { TableColumnConfigurationComponent } from './components/table-column-configuration/table-column-configuration.component';
+import { ConfigColumnNodeComponent } from './components/config-column-node/config-column-node.component';
+
+const COMPONENTS = [
+  TableColumnConfigurationComponent,
+  ConfigColumnNodeComponent,
+];
+
+@NgModule({
+  declarations: [...COMPONENTS],
+  imports: [
+    CommonModule,
+  ],
+  exports: [
+    TableColumnConfigurationComponent,
+  ],
+})
+export class TableColumnConfigurationModule {}

package/src/lib/modules/time-picker/components/time-picker/time-picker.component.html

@@ -0,0 +1,37 @@
+<div class="cc-timepicker-wrapper" [ngStyle]="wrapperStyles">
+  <label *ngIf="label" class="cc-timepicker-label" [ngStyle]="labelStyles">
+    {{ label }}
+    <span *ngIf="required" class="cc-timepicker-required">{{ labels?.requiredMarker || '*' }}</span>
+  </label>
+
+  <!-- Trigger Field -->
+  <div class="cc-timepicker-field"
+       [class.focused]="isOpen"
+       [class.disabled]="disabled"
+       [class.error]="errorMessage"
+       [ngStyle]="fieldStyles"
+       (click)="!disabled && togglePanel()">
+    <span class="cc-timepicker-value" [class.is-placeholder]="!displayValue">
+      {{ displayValue || placeholder || 'Select time' }}
+    </span>
+    <span class="cc-timepicker-icon material-icons">schedule</span>
+  </div>
+
+  <!-- Centered Modal Overlay -->
+  <div class="cc-timepicker-overlay" *ngIf="isOpen" (click)="onCancelled()">
+    <div class="cc-timepicker-modal-content" (click)="$event.stopPropagation()">
+      <lib-time-wheel-panel
+        [mode]="mode"
+        [value]="displayValue"
+        [labels]="labels"
+        [minuteStep]="minuteStep"
+        [minTime]="minTime"
+        [maxTime]="maxTime"
+        (confirmed)="onConfirmed($event)"
+        (cancelled)="onCancelled()">
+      </lib-time-wheel-panel>
+    </div>
+  </div>
+
+  <div class="cc-error-message" *ngIf="errorMessage">{{ errorMessage }}</div>
+</div>

package/src/lib/modules/time-picker/components/time-picker/time-picker.component.scss

@@ -0,0 +1,102 @@
+.cc-timepicker-wrapper {
+  display: flex;
+  flex-direction: column;
+  gap: var(--cc-timepicker-label-gap, 0.5rem);
+  font-family: var(--cc-timepicker-font-family, inherit);
+  position: relative;
+  width: 100%;
+}
+
+.cc-timepicker-label {
+  font-size: var(--cc-timepicker-label-font-size, 0.875rem);
+  font-weight: var(--cc-timepicker-label-font-weight, 500);
+  color: var(--cc-timepicker-label-color, #202124);
+  display: flex;
+  align-items: center;
+}
+
+.cc-timepicker-required {
+  color: var(--cc-timepicker-required-color, #D93025);
+  margin-left: 0.125rem;
+}
+
+.cc-timepicker-field {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  height: var(--cc-timepicker-height, 2.5rem);
+  padding: var(--cc-timepicker-padding, 0.375rem 1rem);
+  border-radius: var(--cc-timepicker-border-radius, 0.4375rem);
+  border: var(--cc-timepicker-border-width, 1px) solid var(--cc-timepicker-border-color, #BDC1C6);
+  background-color: var(--cc-timepicker-bg, #FEFEFE);
+  cursor: pointer;
+  box-sizing: border-box;
+  transition: border-color 0.2s ease, box-shadow 0.2s ease;
+  user-select: none;
+}
+
+.cc-timepicker-field:hover:not(.disabled) {
+  border-color: var(--cc-timepicker-focus-border-color, #1A73E8);
+}
+
+.cc-timepicker-field.focused {
+  border-color: var(--cc-timepicker-focus-border-color, #1A73E8);
+  box-shadow: 0 0 0 2px rgba(26, 115, 232, 0.2);
+}
+
+.cc-timepicker-field.disabled {
+  background-color: var(--cc-timepicker-disabled-bg, #F1F3F4);
+  border-color: var(--cc-timepicker-border-color, #BDC1C6);
+  cursor: not-allowed;
+}
+
+.cc-timepicker-value {
+  font-size: var(--cc-timepicker-font-size, 0.875rem);
+  font-weight: var(--cc-timepicker-font-weight, 400);
+  color: var(--cc-timepicker-color, #202124);
+  font-variant-numeric: tabular-nums;
+}
+
+.cc-timepicker-field.disabled .cc-timepicker-value {
+  color: var(--cc-timepicker-disabled-color, #80868B);
+}
+
+.cc-timepicker-value.is-placeholder {
+  color: var(--cc-timepicker-placeholder-color, #80868B);
+}
+
+.cc-timepicker-icon {
+  font-size: 20px;
+  color: var(--cc-timepicker-icon-color, #5F6368);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.cc-timepicker-field.disabled .cc-timepicker-icon {
+  color: var(--cc-timepicker-disabled-color, #80868B);
+}
+
+/* ─── Centered Modal Overlay Backdrop ─── */
+.cc-timepicker-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background-color: rgba(0, 0, 0, 0.4); /* dim backdrop */
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 9999;
+}
+
+.cc-timepicker-modal-content {
+  display: block;
+}
+
+.cc-error-message {
+  font-size: 0.75rem;
+  color: var(--cc-timepicker-error-color, #D93025);
+  margin-top: 0.25rem;
+}

package/src/lib/modules/time-picker/components/time-picker/time-picker.component.ts

@@ -0,0 +1,178 @@
+import { Component, Input, Output, EventEmitter, forwardRef, OnInit, OnChanges, SimpleChanges } from '@angular/core';
+import { ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms';
+import { TimePickerConfig, TimePickerLabels, TimeMode, TimePickerVariant } from '../../models/time-picker.models';
+
+@Component({
+  selector: 'lib-time-picker',
+  templateUrl: './time-picker.component.html',
+  styleUrls: ['./time-picker.component.scss'],
+  standalone: false,
+  providers: [
+    {
+      provide: NG_VALUE_ACCESSOR,
+      useExisting: forwardRef(() => TimePickerComponent),
+      multi: true
+    }
+  ]
+})
+export class TimePickerComponent implements ControlValueAccessor, OnInit, OnChanges {
+  @Input() config?: TimePickerConfig;
+  @Input() labels?: TimePickerLabels;
+  @Input() label: string = '';
+  @Input() placeholder: string = '';
+  @Input() variant: TimePickerVariant = 'wheel';
+  @Input() mode: TimeMode = '12';
+  @Input() minuteStep: number = 0;
+  @Input() disabled: boolean = false;
+  @Input() required: boolean = false;
+  @Input() errorMessage: string = '';
+  @Input() minTime?: string;
+  @Input() maxTime?: string;
+
+  // Style inputs (to mirror datepicker pattern)
+  @Input() width?: string;
+  @Input() height?: string;
+  @Input() borderRadius?: string;
+  @Input() fontSize?: string;
+  @Input() gap?: string;
+  @Input() fontFamily?: string;
+  @Input() labelColor?: string;
+  @Input() labelFontSize?: string;
+  @Input() labelFontWeight?: string;
+  @Input() backgroundColor?: string;
+  @Input() borderColor?: string;
+  @Input() borderWidth?: string;
+  @Input() padding?: string;
+  @Input() fontWeight?: string;
+  @Input() color?: string;
+  @Input() placeholderColor?: string;
+  @Input() focusBorderColor?: string;
+  @Input() errorColor?: string;
+  @Input() disabledBackgroundColor?: string;
+  @Input() disabledColor?: string;
+
+  @Output() timeChange = new EventEmitter<string>();
+
+  displayValue: string = '';
+  isOpen: boolean = false;
+
+  onChange: (value: string) => void = () => {};
+  onTouched: () => void = () => {};
+
+  ngOnInit(): void {
+    this.updateFromConfig();
+  }
+
+  ngOnChanges(changes: SimpleChanges): void {
+    if (changes['config']) {
+      this.updateFromConfig();
+    }
+  }
+
+  private updateFromConfig(): void {
+    if (this.config) {
+      this.label = this.config.label ?? this.label;
+      this.placeholder = this.config.placeholder ?? this.placeholder;
+      this.variant = this.config.variant ?? this.variant;
+      this.mode = this.config.mode ?? this.mode;
+      this.minuteStep = this.config.minuteStep ?? this.minuteStep;
+      this.disabled = this.config.disabled ?? this.disabled;
+      this.required = this.config.required ?? this.required;
+      this.errorMessage = this.config.errorMessage ?? this.errorMessage;
+
+      this.width = this.config.width ?? this.width;
+      this.height = this.config.height ?? this.height;
+      this.borderRadius = this.config.borderRadius ?? this.borderRadius;
+      this.fontSize = this.config.fontSize ?? this.fontSize;
+      this.gap = this.config.gap ?? this.gap;
+      this.fontFamily = this.config.fontFamily ?? this.fontFamily;
+      this.labelColor = this.config.labelColor ?? this.labelColor;
+      this.labelFontSize = this.config.labelFontSize ?? this.labelFontSize;
+      this.labelFontWeight = this.config.labelFontWeight ?? this.labelFontWeight;
+      this.backgroundColor = this.config.backgroundColor ?? this.backgroundColor;
+      this.borderColor = this.config.borderColor ?? this.borderColor;
+      this.borderWidth = this.config.borderWidth ?? this.borderWidth;
+      this.padding = this.config.padding ?? this.padding;
+      this.fontWeight = this.config.fontWeight ?? this.fontWeight;
+      this.color = this.config.color ?? this.color;
+      this.placeholderColor = this.config.placeholderColor ?? this.placeholderColor;
+      this.focusBorderColor = this.config.focusBorderColor ?? this.focusBorderColor;
+      this.errorColor = this.config.errorColor ?? this.errorColor;
+      this.disabledBackgroundColor = this.config.disabledBackgroundColor ?? this.disabledBackgroundColor;
+      this.disabledColor = this.config.disabledColor ?? this.disabledColor;
+    }
+  }
+
+  writeValue(value: string): void {
+    this.displayValue = value || '';
+  }
+
+  registerOnChange(fn: any): void {
+    this.onChange = fn;
+  }
+
+  registerOnTouched(fn: any): void {
+    this.onTouched = fn;
+  }
+
+  setDisabledState(isDisabled: boolean): void {
+    this.disabled = isDisabled;
+  }
+
+  togglePanel(): void {
+    if (this.disabled) return;
+    this.isOpen = !this.isOpen;
+  }
+
+  closePanel(): void {
+    this.isOpen = false;
+  }
+
+  onConfirmed(timeString: string): void {
+    this.displayValue = timeString;
+    this.onChange(timeString);
+    this.timeChange.emit(timeString);
+    this.isOpen = false;
+    this.onTouched();
+  }
+
+  onCancelled(): void {
+    this.isOpen = false;
+    this.onTouched();
+  }
+
+  get wrapperStyles(): { [key: string]: string | undefined } {
+    return {
+      'width': this.width ? `${this.width}` : undefined,
+      '--cc-timepicker-label-gap': this.gap ? `${this.gap}` : undefined,
+      '--cc-timepicker-font-family': this.fontFamily ? `${this.fontFamily}` : undefined
+    };
+  }
+
+  get labelStyles(): { [key: string]: string | undefined } {
+    return {
+      '--cc-timepicker-label-color': this.labelColor ? `${this.labelColor}` : undefined,
+      '--cc-timepicker-label-font-size': this.labelFontSize ? `${this.labelFontSize}` : undefined,
+      '--cc-timepicker-label-font-weight': this.labelFontWeight ? `${this.labelFontWeight}` : undefined
+    };
+  }
+
+  get fieldStyles(): { [key: string]: string | undefined } {
+    return {
+      '--cc-timepicker-bg': this.backgroundColor ? `${this.backgroundColor}` : undefined,
+      '--cc-timepicker-border-radius': this.borderRadius ? `${this.borderRadius}` : undefined,
+      '--cc-timepicker-border-color': this.borderColor ? `${this.borderColor}` : undefined,
+      '--cc-timepicker-border-width': this.borderWidth ? `${this.borderWidth}` : undefined,
+      '--cc-timepicker-height': this.height ? `${this.height}` : undefined,
+      '--cc-timepicker-padding': this.padding ? `${this.padding}` : undefined,
+      '--cc-timepicker-font-size': this.fontSize ? `${this.fontSize}` : undefined,
+      '--cc-timepicker-font-weight': this.fontWeight ? `${this.fontWeight}` : undefined,
+      '--cc-timepicker-color': this.color ? `${this.color}` : undefined,
+      '--cc-timepicker-placeholder-color': this.placeholderColor ? `${this.placeholderColor}` : undefined,
+      '--cc-timepicker-focus-border-color': this.focusBorderColor ? `${this.focusBorderColor}` : undefined,
+      '--cc-timepicker-error-color': this.errorColor ? `${this.errorColor}` : undefined,
+      '--cc-timepicker-disabled-bg': this.disabledBackgroundColor ? `${this.disabledBackgroundColor}` : undefined,
+      '--cc-timepicker-disabled-color': this.disabledColor ? `${this.disabledColor}` : undefined
+    };
+  }
+}

package/src/lib/modules/time-picker/components/time-wheel-panel/time-wheel-panel.component.html

@@ -0,0 +1,78 @@
+<div class="cc-twp-dialog">
+  <!-- Subtle Configurable Title Header -->
+  <div class="cc-twp-header">
+    <span class="cc-twp-title">{{ labels?.selectTimeTitle || 'Select Time' }}</span>
+  </div>
+
+  <!-- Digital Preview -->
+  <div class="cc-twp-preview">
+    <span class="cc-twp-preview-num">{{ selectedHour }}</span>
+    <span class="cc-twp-preview-colon">:</span>
+    <span class="cc-twp-preview-num">{{ selectedMinute }}</span>
+    <span class="cc-twp-preview-period" *ngIf="mode === '12'"> {{ selectedPeriod }}</span>
+  </div>
+
+  <!-- Wheel Area -->
+  <div class="cc-twp-wheels" [class.mode-24]="mode === '24'">
+    <div class="cc-twp-highlight-bar"></div>
+
+    <!-- Hour Column -->
+    <div class="cc-twp-col">
+      <span class="cc-twp-col-label">{{ labels?.hourLabel || 'Hour' }}</span>
+      <div class="cc-twp-scroll" #hourWheel>
+        <div class="cc-twp-spacer" *ngFor="let s of spacerRows"></div>
+        <ng-container *ngFor="let rep of hourRepeats">
+          <div *ngFor="let h of hours"
+               class="cc-twp-item"
+               [class.active]="selectedHour === h"
+               [class.disabled]="disabledHours.has(h)"
+               [attr.aria-disabled]="disabledHours.has(h)"
+               (click)="selectValue('hour', h)">{{ h }}</div>
+        </ng-container>
+        <div class="cc-twp-spacer" *ngFor="let s of spacerRows"></div>
+      </div>
+    </div>
+
+    <!-- Minute Column -->
+    <div class="cc-twp-col">
+      <span class="cc-twp-col-label">{{ labels?.minuteLabel || 'Minute' }}</span>
+      <div class="cc-twp-scroll" #minuteWheel>
+        <div class="cc-twp-spacer" *ngFor="let s of spacerRows"></div>
+        <ng-container *ngFor="let rep of minuteRepeats">
+          <div *ngFor="let m of minutes"
+               class="cc-twp-item"
+               [class.active]="selectedMinute === m"
+               [class.disabled]="disabledMinutes.has(m)"
+               [attr.aria-disabled]="disabledMinutes.has(m)"
+               (click)="selectValue('minute', m)">{{ m }}</div>
+        </ng-container>
+        <div class="cc-twp-spacer" *ngFor="let s of spacerRows"></div>
+      </div>
+    </div>
+
+    <!-- AM/PM Column — 12hr mode only -->
+    <div class="cc-twp-col" *ngIf="mode === '12'">
+      <span class="cc-twp-col-label">{{ labels?.periodLabel || 'AM/PM' }}</span>
+      <div class="cc-twp-scroll" #periodWheel>
+        <div class="cc-twp-spacer" *ngFor="let s of spacerRows"></div>
+        <div *ngFor="let p of periods"
+             class="cc-twp-item"
+             [class.active]="selectedPeriod === p"
+             [class.disabled]="disabledPeriods.has(p)"
+             [attr.aria-disabled]="disabledPeriods.has(p)"
+             (click)="selectValue('period', p)">{{ p }}</div>
+        <div class="cc-twp-spacer" *ngFor="let s of spacerRows"></div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Footer -->
+  <div class="cc-twp-footer">
+    <button class="cc-twp-btn cc-twp-btn-cancel" (click)="onCancel()">
+      {{ labels?.cancelLabel || 'Cancel' }}
+    </button>
+    <button class="cc-twp-btn cc-twp-btn-confirm" (click)="onConfirm()">
+      {{ labels?.confirmLabel || 'Confirm' }}
+    </button>
+  </div>
+</div>