iss-ctrl 0.0.4 → 0.0.6

package/projects/iss/src/components/controls/plate/plate.viewer.ts

@@ -0,0 +1,289 @@
+import { ChangeDetectionStrategy, Component, effect, signal } from "@angular/core";
+import { ViewerBase } from "../base/viewer-base";
+import { PLATE_LETTERS } from "./plate-letters.const";
+
+@Component({
+  selector: "iss-viewer-plate",
+  imports: [],
+  template: `
+    <div class="plate-container">
+      <div class="section numbers-section">
+        <div class="digit-row">
+          @for (numAr of numbersAr(); track numAr) {
+            <span>{{ numAr }}</span>
+          }
+        </div>
+        <div class="digit-row">
+          @for (numEn of numbersEn(); track numEn) {
+            <span>{{ numEn }}</span>
+          }
+        </div>
+      </div>
+
+      <div class="section emblem-section">
+        <svg class="emblem-svg" viewBox="0 0 17 19" fill="none" xmlns="http://www.w3.org/2000/svg">
+          <path
+            fill-rule="evenodd"
+            clip-rule="evenodd"
+            d="M10.8072 16.8744C11.4633 16.178 11.3244 15.3914 10.7996 15.3825C10.9872 15.9606 10.5562 16.3344 10.3922 16.5266C9.97894 16.1712 9.55086 15.7761 9.10778 15.3694C11.2695 13.5812 13.6354 11.995 16.7263 11.9452C13.3983 10.7499 10.7417 12.7815 8.4925 14.8084C6.24308 12.7815 3.58672 10.7499 0.257812 11.9452C3.34944 11.995 5.71507 13.581 7.87722 15.3694C7.43329 15.7761 7.00564 16.1712 6.59172 16.5266C6.42902 16.3344 5.99777 15.9606 6.18435 15.3825C5.65992 15.3914 5.52089 16.178 6.17758 16.8744C5.91495 17.0931 5.48962 17.4631 5.15113 17.5518C4.89082 17.6199 4.68185 17.4846 4.63473 17.2026C4.53542 16.6069 3.61271 16.6959 3.72554 17.5372C3.82907 18.3044 4.76066 18.6391 5.55892 18.2837C5.87565 18.1424 6.3107 17.7413 6.66778 17.45C6.83111 17.641 7.26215 18.0145 7.07494 18.5935C7.59979 18.5838 7.7384 17.798 7.08234 17.1005C7.54845 16.7028 8.01625 16.2927 8.4925 15.887C8.96833 16.2925 9.43634 16.7028 9.90288 17.1005C9.24639 17.798 9.385 18.5838 9.91006 18.5935C9.72285 18.0145 10.1539 17.6414 10.3168 17.45C10.6745 17.7413 11.1091 18.1424 11.4263 18.2837C12.2246 18.6391 13.1555 18.3044 13.259 17.5372C13.3719 16.6959 12.4496 16.6069 12.3494 17.2026C12.3023 17.4846 12.094 17.6196 11.8332 17.5518C11.4948 17.4631 11.0696 17.0931 10.8072 16.8744ZM6.72504 5.72093C6.22365 7.04637 6.19597 8.53894 6.9169 10.1805C6.80195 8.47576 7.17594 7.06771 7.8713 6.0066L8.01815 7.46832H7.84679L8.01815 9.17958H7.84679L8.01815 10.8904H7.84679L8.01794 12.5991L7.53366 13.0819H8.4925H9.45156L8.96685 12.5991L9.13842 10.8904H8.96685L9.13842 9.17958H8.96685L9.13842 7.46832H8.96685L9.11391 6.0066C9.80906 7.06771 10.1833 8.47682 10.0683 10.1805C10.7886 8.53894 10.7616 7.047 10.2602 5.72093C11.1115 6.72478 11.7701 7.89851 12.0661 9.36572C12.3733 7.50466 11.848 5.98568 10.8852 4.8071C11.8174 5.47943 12.6184 6.33157 13.1785 7.48396C13.048 5.72072 12.1559 4.57742 10.927 3.75824C11.989 4.1054 12.8561 4.68645 13.6343 5.71798C13.1139 3.8884 11.9801 3.15564 10.575 2.74362C11.5332 2.67368 12.4386 2.78165 13.3347 3.33988C12.3621 2.02839 11.0565 1.81055 9.73257 1.95634C10.2893 1.67279 10.9158 1.53101 11.5888 1.63137C10.8302 1.07187 9.81836 1.01651 8.95227 1.48812L8.4925 0.328125L8.0321 1.48749C7.1658 1.01651 6.15476 1.07166 5.39623 1.63137C6.06877 1.53122 6.69483 1.67279 7.25179 1.95634C5.92826 1.81055 4.62311 2.0286 3.6499 3.33988C4.54662 2.78165 5.45137 2.67368 6.41001 2.74362C5.00534 3.15564 3.87112 3.8884 3.35113 5.71798C4.12868 4.68666 4.99625 4.1054 6.05842 3.75824C4.8287 4.57721 3.93704 5.72072 3.80625 7.48396C4.36618 6.33157 5.16782 5.47943 6.09962 4.8071C5.13676 5.98568 4.61149 7.50466 4.91871 9.36572C5.21494 7.89851 5.87354 6.72478 6.72504 5.72093Z"
+            fill="#1D252D"
+          />
+        </svg>
+      </div>
+
+      <div class="section letters-section">
+        <div class="arabic-row" dir="rtl">
+          @for (lAr of lettersAr(); track lAr) {
+            <span>{{ lAr }}</span>
+          }
+        </div>
+        <div class="english-row" dir="rtl">
+          @for (lEn of lettersEn(); track lEn) {
+            <span>{{ lEn }}</span>
+          }
+        </div>
+      </div>
+
+      <div class="ksa-strip">
+        <svg class="mini-emblem" viewBox="0 0 17 19" fill="none" xmlns="http://www.w3.org/2000/svg">
+          <path
+            fill-rule="evenodd" clip-rule="evenodd"
+            d="M10.8072 16.8744C11.4633 16.178 11.3244 15.3914 10.7996 15.3825C10.9872 15.9606 10.5562 16.3344 10.3922 16.5266C9.97894 16.1712 9.55086 15.7761 9.10778 15.3694C11.2695 13.5812 13.6354 11.995 16.7263 11.9452C13.3983 10.7499 10.7417 12.7815 8.4925 14.8084C6.24308 12.7815 3.58672 10.7499 0.257812 11.9452C3.34944 11.995 5.71507 13.581 7.87722 15.3694C7.43329 15.7761 7.00564 16.1712 6.59172 16.5266C6.42902 16.3344 5.99777 15.9606 6.18435 15.3825C5.65992 15.3914 5.52089 16.178 6.17758 16.8744C5.91495 17.0931 5.48962 17.4631 5.15113 17.5518C4.89082 17.6199 4.68185 17.4846 4.63473 17.2026C4.53542 16.6069 3.61271 16.6959 3.72554 17.5372C3.82907 18.3044 4.76066 18.6391 5.55892 18.2837C5.87565 18.1424 6.3107 17.7413 6.66778 17.45C6.83111 17.641 7.26215 18.0145 7.07494 18.5935C7.59979 18.5838 7.7384 17.798 7.08234 17.1005C7.54845 16.7028 8.01625 16.2927 8.4925 15.887C8.96833 16.2925 9.43634 16.7028 9.90288 17.1005C9.24639 17.798 9.385 18.5838 9.91006 18.5935C9.72285 18.0145 10.1539 17.6414 10.3168 17.45C10.6745 17.7413 11.1091 18.1424 11.4263 18.2837C12.2246 18.6391 13.1555 18.3044 13.259 17.5372C13.3719 16.6959 12.4496 16.6069 12.3494 17.2026C12.3023 17.4846 12.094 17.6196 11.8332 17.5518C11.4948 17.4631 11.0696 17.0931 10.8072 16.8744ZM6.72504 5.72093C6.22365 7.04637 6.19597 8.53894 6.9169 10.1805C6.80195 8.47576 7.17594 7.06771 7.8713 6.0066L8.01815 7.46832H7.84679L8.01815 9.17958H7.84679L8.01815 10.8904H7.84679L8.01794 12.5991L7.53366 13.0819H8.4925H9.45156L8.96685 12.5991L9.13842 10.8904H8.96685L9.13842 9.17958H8.96685L9.13842 7.46832H8.96685L9.11391 6.0066C9.80906 7.06771 10.1833 8.47682 10.0683 10.1805C10.7886 8.53894 10.7616 7.047 10.2602 5.72093C11.1115 6.72478 11.7701 7.89851 12.0661 9.36572C12.3733 7.50466 11.848 5.98568 10.8852 4.8071C11.8174 5.47943 12.6184 6.33157 13.1785 7.48396C13.048 5.72072 12.1559 4.57742 10.927 3.75824C11.989 4.1054 12.8561 4.68645 13.6343 5.71798C13.1139 3.8884 11.9801 3.15564 10.575 2.74362C11.5332 2.67368 12.4386 2.78165 13.3347 3.33988C12.3621 2.02839 11.0565 1.81055 9.73257 1.95634C10.2893 1.67279 10.9158 1.53101 11.5888 1.63137C10.8302 1.07187 9.81836 1.01651 8.95227 1.48812L8.4925 0.328125L8.0321 1.48749C7.1658 1.01651 6.15476 1.07166 5.39623 1.63137C6.06877 1.53122 6.69483 1.67279 7.25179 1.95634C5.92826 1.81055 4.62311 2.0286 3.6499 3.33988C4.54662 2.78165 5.45137 2.67368 6.41001 2.74362C5.00534 3.15564 3.87112 3.8884 3.35113 5.71798C4.12868 4.68666 4.99625 4.1054 6.05842 3.75824C4.8287 4.57721 3.93704 5.72072 3.80625 7.48396C4.36618 6.33157 5.16782 5.47943 6.09962 4.8071C5.13676 5.98568 4.61149 7.50466 4.91871 9.36572C5.21494 7.89851 5.87354 6.72478 6.72504 5.72093Z"
+            fill="#1D252D"
+          />
+        </svg>
+        <span class="ksa-text">KSA</span>
+      </div>
+    </div>
+  `,
+  styles: `
+    .plate-container {
+      width: 600px;
+      height: 130px;
+      border: 4px solid #1D252D;
+      border-radius: 10px;
+      background: white;
+      display: flex;
+      box-shadow: 0 4px 10px rgba(0, 0, 0, 0.2);
+      overflow: hidden;
+      position: relative;
+    }
+
+    /* General Section Styling */
+    .section {
+      display: flex;
+      flex-direction: column;
+      justify-content: center;
+      align-items: center;
+    }
+
+    /* Left Section: Numbers/Asterisks */
+    .numbers-section {
+      flex: 2;
+      padding: 0 10px;
+    }
+
+    .digit-row {
+      display: flex;
+      justify-content: space-between;
+      width: 80%;
+      font-size: 38px;
+      line-height: 1;
+      color: #1D252D;
+      margin: 2px 0;
+    }
+
+    /* Middle Section: Emblem */
+    .emblem-section {
+      flex: 1.2;
+      padding: 10px;
+    }
+
+    .emblem-svg {
+      width: 100%;
+      height: 100%;
+      max-height: 90px;
+    }
+
+    /* Right Section: Letters */
+    .letters-section {
+      flex: 1.8;
+      border-right: 2px solid #1D252D;
+      padding: 0 10px;
+    }
+
+    .arabic-row {
+      font-family: 'Noto Sans Arabic', sans-serif;
+      font-size: 32px;
+      display: flex;
+      justify-content: space-around;
+      width: 100%;
+      margin-bottom: 5px;
+      color: #1D252D;
+    }
+
+    .english-row {
+      font-size: 38px;
+      display: flex;
+      justify-content: space-around;
+      width: 100%;
+      color: #1D252D;
+    }
+
+    /* Far Right: KSA Strip */
+    .ksa-strip {
+      width: 50px;
+      display: flex;
+      flex-direction: column;
+      justify-content: space-between;
+      align-items: center;
+      padding: 10px 0;
+      background-color: #fff; /* or specific reflective white */
+    }
+
+    .mini-emblem {
+      width: 25px;
+      height: auto;
+    }
+
+    .ksa-text {
+      writing-mode: vertical-rl;
+      text-orientation: upright;
+      font-weight: 900;
+      font-size: 16px;
+      letter-spacing: 2px;
+      color: #1D252D;
+      margin-top: auto;
+      margin-bottom: 5px;
+    }
+
+    .plate-input {
+      background: transparent;
+      border: none;
+      text-align: center;
+      font-family: inherit;
+      font-size: inherit;
+      font-weight: bold;
+      color: #1D252D;
+      width: 100%; /* Fill the flex/grid item */
+      padding: 0;
+      margin: 0;
+      outline: none; /* Remove blue outline on focus */
+    }
+
+    /* Optional: Add a subtle underline or color change when user clicks the input */
+    .plate-input:focus {
+      border-bottom: 2px solid #1D252D;
+    }
+
+    /* Adjusting the container flex settings to ensure inputs fit */
+    .digit-row, .arabic-row, .english-row {
+      display: flex;
+      justify-content: space-between;
+      width: 100%;
+    }
+
+    /* Specific sizing for numbers to ensure they match plate proportions */
+    .number-input {
+      /* Adjust width based on your container size, roughly 20-25% */
+      flex: 1;
+    }
+
+    /* Specific sizing for letters */
+    .letter-input {
+      flex: 1;
+    }
+
+    /* Placeholder styling to look like a ghost plate */
+    .plate-input::placeholder {
+      color: #ccc;
+      opacity: 1;
+    }
+
+    .input-wrapper {
+      position: relative;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      flex: 1;
+    }
+
+    .error-tooltip {
+      position: absolute;
+      bottom: -15px;
+      font-size: 10px;
+      color: red;
+      white-space: nowrap;
+    }
+
+    .plate-input.invalid {
+      color: red;
+    }
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush
+})
+export class PlateViewer extends ViewerBase {
+  numbersAr = signal<string[]>(Array(4).fill(""));
+  numbersEn = signal<string[]>(Array(4).fill(""));
+  lettersAr = signal<string[]>(Array(3).fill(""));
+  lettersEn = signal<string[]>(Array(3).fill(""));
+  effectRef = effect(() => {
+    const val = this.field().value;
+    if (val) {
+      const parts = val.split("-");
+      const letters = parts[0]?.split("") || [];
+      const numbers = parts[1]?.split("") || [];
+
+      // Initialize letters
+      const lAr: string[] = [];
+      const lEn: string[] = [];
+      for (let i = 0; i < 3; i++) {
+        const char = letters[i] || "";
+        if (char) {
+          const plateLetter = PLATE_LETTERS.find(l => l.value === char || l.label.en === char || l.label.ar === char);
+          if (plateLetter) {
+            lAr.push(plateLetter.label.ar);
+            lEn.push(plateLetter.label.en);
+          } else {
+            lAr.push("");
+            lEn.push("");
+          }
+        } else {
+          lAr.push("");
+          lEn.push("");
+        }
+      }
+      this.lettersAr.set(lAr);
+      this.lettersEn.set(lEn);
+
+      // Initialize numbers
+      const nAr: string[] = [];
+      const nEn: string[] = [];
+      for (let i = 0; i < 4; i++) {
+        const char = numbers[i] || "";
+        if (char) {
+          nAr.push(this.convertDigit(char, "ar"));
+          nEn.push(this.convertDigit(char, "en"));
+        } else {
+          nAr.push("");
+          nEn.push("");
+        }
+      }
+      this.numbersAr.set(nAr);
+      this.numbersEn.set(nEn);
+    }
+  });
+
+  private convertDigit(digit: string, toLang: "ar" | "en"): string {
+    const arDigits = ["٠", "١", "٢", "٣", "٤", "٥", "٦", "٧", "٨", "٩"];
+    const enDigits = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9"];
+
+    if (toLang === "ar") {
+      const index = enDigits.indexOf(digit);
+      return index !== -1 ? arDigits[index] : digit;
+    } else {
+      const index = arDigits.indexOf(digit);
+      return index !== -1 ? enDigits[index] : digit;
+    }
+  }
+}

package/projects/iss/src/components/controls/radio/radio.control.ts

@@ -0,0 +1,48 @@
+import { Component, input, InputSignal } from "@angular/core";
+import { NG_VALUE_ACCESSOR, ReactiveFormsModule } from "@angular/forms";
+import { MatButtonToggle, MatButtonToggleGroup } from "@angular/material/button-toggle";
+import { Option } from "../../../shared/interfaces/option";
+import { ControlBase } from "../base/control-base";
+
+@Component({
+  selector: "iss-ctrl-radio",
+  imports: [
+    ReactiveFormsModule,
+    MatButtonToggleGroup,
+    MatButtonToggle,
+  ],
+  providers: [
+    {provide: NG_VALUE_ACCESSOR, useExisting: RadioControl, multi: true}
+  ],
+  template: `
+    <mat-button-toggle-group [hideSingleSelectionIndicator]="true">
+      @for (option of options(); track option.value) {
+        <mat-button-toggle
+          [value]="option.value"
+          [checked]="ctrl.value === option.value"
+          (change)="onRadioChange(option.value)"
+        >{{ option.label }}
+        </mat-button-toggle>
+      }
+    </mat-button-toggle-group>
+  `,
+})
+export class RadioControl extends ControlBase {
+  options: InputSignal<Option[]> = input.required();
+
+  override writeValue(value: string | null) {
+    if (value === null || value === undefined) {
+      return;
+    }
+    const values: string[] = value.split(",").map((val: string) => val.trim());
+    if (values.length > 1) {
+      this.emitValue(null);
+      throw new Error("You cannot set multiple values while the control is in single selection mode!");
+    }
+    this.ctrl.setValue(value);
+  }
+
+  onRadioChange(value: string) {
+    this.emitValue(value);
+  }
+}

package/projects/iss/src/components/controls/radio/radio.field.ts

@@ -0,0 +1,38 @@
+import { Component } from "@angular/core";
+import { ReactiveFormsModule } from "@angular/forms";
+import { MatLabel } from "@angular/material/form-field";
+import { VIEW_PROVIDER } from "../../../shared/constants/view-provider.const";
+import { FieldBase } from "../base/field-base";
+import { RadioControl } from "./radio.control";
+import { RadioViewer } from "./radio.viewer";
+
+@Component({
+  selector: "iss-field-radio",
+  viewProviders: [VIEW_PROVIDER],
+  imports: [
+    ReactiveFormsModule,
+    MatLabel,
+    RadioControl,
+    RadioViewer
+  ],
+  template: `
+    @if (field.visible()) {
+      <div style="display: flex; flex-direction: column">
+        @if (!(field.config.hideLabel)) {
+          <mat-label>{{ field.label() }}</mat-label>
+        }
+
+        @if (field.mode() === "edit") {
+          <iss-ctrl-radio [formControlName]="field.name" [options]="field.options()" (onChange)="onChange($event)" />
+        } @else {
+          <iss-viewer-radio [field]="field" />
+        }
+      </div>
+    }
+  `
+})
+export class RadioField extends FieldBase {
+  onChange($event: any) {
+    this.field.ctrlJsonValue.set($event);
+  }
+}

package/projects/iss/src/components/controls/radio/radio.viewer.ts

@@ -0,0 +1,14 @@
+import { Component } from "@angular/core";
+import { ViewerBase } from "../base/viewer-base";
+
+@Component({
+  selector: "iss-viewer-radio",
+  template: `
+    <p>
+      @for (item of field().ctrlJsonValue(); track item?.value) {
+        <span>{{ item.label }}</span>
+      }
+    </p>
+  `,
+})
+export class RadioViewer extends ViewerBase {}

package/projects/iss/src/components/controls/select/select.control.ts

@@ -0,0 +1,242 @@
+import { CdkFixedSizeVirtualScroll, CdkVirtualForOf, CdkVirtualScrollViewport } from "@angular/cdk/scrolling";
+import { NgClass, NgStyle, NgTemplateOutlet } from "@angular/common";
+import { Component, computed, contentChild, CUSTOM_ELEMENTS_SCHEMA, effect, input, InputSignal, OnDestroy, output, OutputEmitterRef, signal, Signal, WritableSignal } from "@angular/core";
+import { toSignal } from "@angular/core/rxjs-interop";
+import { NG_VALUE_ACCESSOR, ReactiveFormsModule } from "@angular/forms";
+import { MatAutocompleteModule } from "@angular/material/autocomplete";
+import { MatChipsModule } from "@angular/material/chips";
+import { MatIconModule } from "@angular/material/icon";
+import { MatInputModule } from "@angular/material/input";
+import { Option } from "../../../shared/interfaces/option";
+import { SelectStatusPipe } from "../../../shared/pipes/select-status.pipe";
+import { ControlBase } from "../base/control-base";
+
+@Component({
+  selector: "iss-ctrl-select",
+  imports: [
+    ReactiveFormsModule,
+    MatAutocompleteModule,
+    MatInputModule,
+    MatChipsModule,
+    MatIconModule,
+    NgClass,
+    SelectStatusPipe,
+    CdkVirtualForOf,
+    CdkVirtualScrollViewport,
+    CdkFixedSizeVirtualScroll,
+    NgStyle,
+    NgTemplateOutlet,
+  ],
+  providers: [
+    {provide: NG_VALUE_ACCESSOR, useExisting: SelectControl, multi: true},
+  ],
+  template: `
+    <mat-form-field floatLabel="auto" class="">
+      <mat-label class="fs-16 fc-black">
+        <ng-content select="label"></ng-content>
+      </mat-label>
+      <input [formControl]="ctrl" [matAutocomplete]="auto" [matChipInputFor]="chipGrid" [placeholder]="placeholder()" class="m-0" matInput />
+      @if (!disabled()) {
+        @if (selectedOptions().size) {
+          <span matSuffix class="sfi sfi-close fs-18 fc-black cursor-pointer" (click)="clearSelection()"></span>
+        } @else {
+          <span matSuffix class="sfi sfi-arrow-down fs-18 fc-black cursor-pointer"></span>
+        }
+      }
+
+      <mat-autocomplete #auto="matAutocomplete" (optionSelected)="captureValue($event)" [displayWith]="displayFn" autoActiveFirstOption hideSingleSelectionIndicator>
+        @if (loading()) {
+          <mat-option disabled="true">
+            <ds-icon icon="spinner" class="spin fc-coral fs-20"></ds-icon>
+          </mat-option>
+        } @else {
+          @if (filteredOptions().length) {
+            @if (multiple()) {
+              <mat-option (click)="toggleAllSelection()" value="_SELECT_ALL_OPTIONS_">
+                {{ allSelected() ? "deselect all" : "Select All" }}
+              </mat-option>
+            }
+            <cdk-virtual-scroll-viewport itemSize="5" [ngStyle]="{'height': height()}">
+              <mat-option *cdkVirtualFor="let option of filteredOptions()" [value]="option" [ngClass]="{'mdc-list-item__selected': option | selectStatus: selectedOptions()}">
+                @if (optionTemplate()) {
+                  <ng-container *ngTemplateOutlet="optionTemplate(); context: { $implicit: option}" />
+                } @else {
+                  {{ option.label }}
+                }
+              </mat-option>
+            </cdk-virtual-scroll-viewport>
+          } @else {
+            <mat-option disabled="true">No Result Found</mat-option>
+          }
+        }
+      </mat-autocomplete>
+    </mat-form-field>
+
+    <mat-chip-grid #chipGrid>
+      @if (multiple()) {
+        @for (chip of selectedOptions(); track chip[0]) {
+          <mat-chip-row (removed)="removeFromSelectedOptionsMap(chip[1])">
+            @if (cardViewerTemplate()) {
+              <ng-container
+                *ngTemplateOutlet="cardViewerTemplate(); context: { $implicit:  chip[1]}"
+              />
+            } @else {
+              {{ chip[1].label }}
+            }
+            <button matChipRemove [attr.aria-label]="'remove ' + chip[1].label">
+              <ds-icon icon="trash" class="fc-red"></ds-icon>
+            </button>
+          </mat-chip-row>
+        }
+      }
+    </mat-chip-grid>
+  `,
+  styles: `
+    ::ng-deep {
+      .mat-mdc-option.mdc-list-item__selected:not(.mdc-list-item--disabled) .mdc-list-item__primary-text {
+        --mat-option-selected-state-label-text-color: var(--green);
+        color: var(--green);
+      }
+    }
+  `,
+  schemas: [CUSTOM_ELEMENTS_SCHEMA]
+})
+export class SelectControl extends ControlBase implements OnDestroy {
+  selectedOptions: WritableSignal<Map<string, Option>> = signal(new Map<string, Option>());
+  options: InputSignal<Option[]> = input.required();
+  height: InputSignal<string> = input("150px");
+  query: Signal<string> = toSignal(this.ctrl.valueChanges);
+  filteredOptions: Signal<Option[]> = computed(() => this.#filter(this.query()));
+  loading: InputSignal<boolean> = input(false);
+  onQueryChange: OutputEmitterRef<string> = output();
+  displayFn = (options: Option | Option[]): string => {
+    if (Array.isArray(options) && !this.multiple()) {
+      return options[0]?.label;
+    }
+    return "";
+  };
+  protected optionTemplate: any = contentChild("optionTemplate");
+  protected cardViewerTemplate: any = contentChild("cardViewerTemplate");
+  protected allSelected: WritableSignal<boolean> = signal(false);
+  #queryEffectRef = effect(() => {
+    if (typeof this.query() === "string") {
+      this.onQueryChange.emit(this.query());
+    }
+  });
+  #disabledEffectRef = effect(() => {
+    if (this.disabled()) {
+      this.ctrl.disable();
+    } else {
+      this.ctrl.enable();
+    }
+  });
+
+  /*todo: add pagination for async options*/
+
+  override writeValue(value: string | null) {
+    this.#reset();
+    if (value === null || value === undefined) {
+      return;
+    }
+    const values: string[] = value.split(",").map(val => val.trim());
+    let selectedOptions: Option[] = this.options().filter((option: Option) => values.includes(option.value));
+    if (!this.multiple()) {
+      if (selectedOptions.length > 1) {
+        this.#emit();
+        throw new Error("You cannot set multiple values while the control is in single selection mode!");
+      }
+      selectedOptions = selectedOptions.splice(-selectedOptions.length, selectedOptions.length - selectedOptions.length + 1);
+    }
+    for (let i = 0; i < selectedOptions.length; i++) {
+      const val: Option = selectedOptions[i];
+      this.#addToSelectedOptionsMap(val);
+    }
+    this.ctrl.setValue(selectedOptions);
+  }
+
+  captureValue($event: any) {
+    if ($event?.option.value === "_SELECT_ALL_OPTIONS_") {
+      return;
+    }
+    this.#addToSelectedOptionsMap($event?.option.value);
+    this.#emit();
+  }
+
+  removeFromSelectedOptionsMap(option: Option) {
+    this.selectedOptions().delete(option.value);
+    this.filteredOptions = computed(() => this.#filter(this.query()));
+    this.allSelected.set(false);
+    this.#emit();
+  }
+
+  clearSelection() {
+    this.#reset();
+    this.allSelected.set(false);
+    this.#emit();
+  }
+
+  toggleAllSelection() {
+    if (this.selectedOptions().size === this.options().length) {
+      this.#reset();
+      this.#emit();
+      this.allSelected.set(false);
+      return;
+    }
+    for (let i = 0; i < this.options().length; i++) {
+      this.#addToSelectedOptionsMap(this.options()[i]);
+    }
+    this.allSelected.set(true);
+    this.#emit();
+  }
+
+  ngOnDestroy(): void {
+    this.#queryEffectRef.destroy();
+    this.#disabledEffectRef.destroy();
+  }
+
+  #addToSelectedOptionsMap(option: any) {
+    if (option) {
+      const selectedOption = option;
+      if (!this.multiple()) {
+        this.#reset();
+      }
+      this.selectedOptions().set(selectedOption.value, selectedOption);
+      this.ctrl.setValue(this.#convertSelectedMapToArray());
+    }
+  }
+
+  #stringifySelectedOptions(): string | null {
+    const selectedOptionsArr: Option[] | null = this.#convertSelectedMapToArray();
+    if (selectedOptionsArr) {
+      return selectedOptionsArr.map((o) => o.value).join();
+    }
+    return null;
+  }
+
+  #filter(queryString: string | Option): Option[] {
+    if (queryString === null || queryString === undefined || typeof queryString !== "string") {
+      return this.options();
+    }
+    const query: string = queryString.toLowerCase();
+    const filteredOptions: Option[] = this.options().filter((option: Option) => {
+      return (option.value.toLowerCase().includes(query) || option.label.toLowerCase().includes(query));
+    });
+    return JSON.parse(JSON.stringify(filteredOptions));
+  }
+
+  #emit() {
+    this.propagateValue(this.#stringifySelectedOptions());
+    this.emitOnChangeEvent(this.#convertSelectedMapToArray());
+  }
+
+  #reset() {
+    this.selectedOptions().clear();
+    this.filteredOptions = computed(() => this.#filter(this.query()));
+    this.ctrl.setValue(null);
+  }
+
+  #convertSelectedMapToArray(): Option[] | null {
+    const selectedOptionsArr: Option[] = Array.from(this.selectedOptions(), ([_, option]) => option);
+    return selectedOptionsArr.length ? selectedOptionsArr : null;
+  }
+}

package/projects/iss/src/components/controls/select/select.field.ts

@@ -0,0 +1,32 @@
+import { Component } from "@angular/core";
+import { ReactiveFormsModule } from "@angular/forms";
+import { VIEW_PROVIDER } from "../../../shared/constants/view-provider.const";
+import { FieldBase } from "../base/field-base";
+import { SelectControl } from "./select.control";
+import { SelectViewer } from "./select.viewer";
+
+@Component({
+  selector: "iss-field-select",
+  viewProviders: [VIEW_PROVIDER],
+  imports: [
+    ReactiveFormsModule,
+    SelectControl,
+    SelectViewer
+  ],
+  template: `
+    @if (field.visible()) {
+      @if (field.mode() === "edit") {
+        <iss-ctrl-select [formControlName]="field.name" [options]="field.options()" [multiple]="field.config.multiple()" (onChange)="onChange($event)">
+          <label>{{ field.label() }}</label>
+        </iss-ctrl-select>
+      } @else {
+        <iss-viewer-select [field]="field" />
+      }
+    }
+  `
+})
+export class SelectField extends FieldBase {
+  onChange($event: string | FormData) {
+    this.field.ctrlJsonValue.set($event);
+  }
+}

package/projects/iss/src/components/controls/select/select.viewer.ts

@@ -0,0 +1,14 @@
+import { Component } from "@angular/core";
+import { ViewerBase } from "../base/viewer-base";
+
+@Component({
+  selector: "iss-viewer-select",
+  template: `
+    <p>
+      @for (item of field().ctrlJsonValue(); track item?.value; let last = $last) {
+        <span>{{ item.label }} {{ last ? '' : ', ' }}</span>
+      }
+    </p>
+  `,
+})
+export class SelectViewer extends ViewerBase {}