@moatamed-sce/ui-components 0.1.1 → 0.1.2

package/types/moatamed-sce-ui-components.d.ts

@@ -16,12 +16,14 @@ import { ToastPositionType } from 'primeng/toast';
 import { TranslateService } from '@ngx-translate/core';
 import { DynamicDialogRef } from 'primeng/dynamicdialog';
 
+/** One selectable card in `sce-card-radio-group`, with an optional `icon` and `description` line. */
 interface CardRadioOption {
     value: string;
     label: string;
     description?: string;
     icon?: string;
 }
+/** Radio group that renders each option as a selectable card with an optional icon and description; unlike the other sce field components it is a ControlValueAccessor, so it accepts `formControlName`. */
 declare class SceCardRadioGroupComponent implements ControlValueAccessor {
     readonly options: _angular_core.InputSignal<CardRadioOption[]>;
     readonly label: _angular_core.InputSignal<string>;
@@ -45,6 +47,7 @@ declare class SceCardRadioGroupComponent implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceCardRadioGroupComponent, "sce-card-radio-group", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Shared form-field wrapper that renders the label, required marker, projected control, help text and error message for the other sce field components; `id` and `label` are required. */
 declare class SceFieldComponent {
     readonly id: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
@@ -82,6 +85,7 @@ interface SceFieldValidationMessages {
 type SceTextFieldPrefixMode = 'absolute' | 'inline';
 /** @see SceFieldValidationMode — kept as the published name for this field. */
 type SceTextFieldValidationMode = SceFieldValidationMode;
+/** Single-line text form field built on PrimeNG InputText, with a shared validation engine and an optional inline or absolute prefix; validation is opt-in, since `validationMode` defaults to `'never'`. */
 declare class SceTextFieldComponent {
     private readonly mirrorLabelAsPlaceholder;
     readonly id: _angular_core.InputSignal<string>;
@@ -128,6 +132,7 @@ declare class SceTextFieldComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceTextFieldComponent, "sce-text-field", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "helpText": { "alias": "helpText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "inputClassName": { "alias": "inputClassName"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "listId": { "alias": "listId"; "required": false; "isSignal": true; }; "validationMode": { "alias": "validationMode"; "required": false; "isSignal": true; }; "validationMessages": { "alias": "validationMessages"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "validate": { "alias": "validate"; "required": false; "isSignal": true; }; "prefix": { "alias": "prefix"; "required": false; "isSignal": true; }; "prefixMode": { "alias": "prefixMode"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "focused": "focused"; "blurred": "blurred"; }, never, never, true, never>;
 }
 
+/** Multi-line textarea form field built on PrimeNG Textarea with the shared validation engine; validation is opt-in, since `validationMode` defaults to `'never'`. */
 declare class SceTextareaFieldComponent {
     private readonly mirrorLabelAsPlaceholder;
     readonly id: _angular_core.InputSignal<string>;
@@ -164,6 +169,7 @@ declare class SceTextareaFieldComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceTextareaFieldComponent, "sce-textarea-field", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "helpText": { "alias": "helpText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "inputClassName": { "alias": "inputClassName"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "validationMode": { "alias": "validationMode"; "required": false; "isSignal": true; }; "validationMessages": { "alias": "validationMessages"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "validate": { "alias": "validate"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "blurred": "blurred"; }, never, never, true, never>;
 }
 
+/** Password form field built on PrimeNG Password with a reveal toggle enabled by default and an optional strength-feedback panel; `id` and `label` are required. */
 declare class ScePasswordFieldComponent {
     readonly id: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
@@ -200,11 +206,13 @@ declare class ScePasswordFieldComponent {
  * - `'never'`                   — never show built-in errors (rely on external `error` input)
  */
 type SceSelectValidationMode = 'onChange' | 'onBlur' | 'onTouched' | 'always' | 'touched' | 'never';
+/** One choice in `sce-select-field` and `sce-multi-select-field`, generic over the value type (defaults to `string`) and individually disableable. */
 interface SceSelectOption<V extends string | number = string> {
     label: string;
     value: V;
     disabled?: boolean;
 }
+/** Single-select form field built on PrimeNG Select with a built-in validation engine that shows errors once the control is touched; when no placeholder is given it falls back to the label if the `SCE_MIRROR_LABEL_AS_PLACEHOLDER` token is provided. */
 declare class SceSelectFieldComponent {
     private readonly mirrorLabelAsPlaceholder;
     readonly id: _angular_core.InputSignal<string>;
@@ -260,6 +268,7 @@ interface SceMultiSelectValidationMessages {
     minSelected?: (min: number) => string;
     maxSelected?: (max: number) => string;
 }
+/** Multi-select form field built on PrimeNG MultiSelect with a built-in required/min/max validation engine and an optional footer for adding new options; `id` and `label` are required. */
 declare class SceMultiSelectFieldComponent {
     readonly id: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
@@ -308,6 +317,7 @@ declare class SceMultiSelectFieldComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceMultiSelectFieldComponent, "sce-multi-select-field", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "helpText": { "alias": "helpText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "panelClassName": { "alias": "panelClassName"; "required": false; "isSignal": true; }; "inputClassName": { "alias": "inputClassName"; "required": false; "isSignal": true; }; "fieldClassName": { "alias": "fieldClassName"; "required": false; "isSignal": true; }; "labelClassName": { "alias": "labelClassName"; "required": false; "isSignal": true; }; "containerClassName": { "alias": "containerClassName"; "required": false; "isSignal": true; }; "minSelected": { "alias": "minSelected"; "required": false; "isSignal": true; }; "maxSelected": { "alias": "maxSelected"; "required": false; "isSignal": true; }; "validationMode": { "alias": "validationMode"; "required": false; "isSignal": true; }; "validationMessages": { "alias": "validationMessages"; "required": false; "isSignal": true; }; "validate": { "alias": "validate"; "required": false; "isSignal": true; }; "selectedItemsLabel": { "alias": "selectedItemsLabel"; "required": false; "isSignal": true; }; "allowAdd": { "alias": "allowAdd"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "addOption": "addOption"; }, never, never, true, never>;
 }
 
+/** Toggle switch built on PrimeNG ToggleSwitch, with optional active/inactive labels that fall back to translated defaults. */
 declare class SceSwitchComponent {
     private readonly translate;
     readonly checked: _angular_core.InputSignal<boolean>;
@@ -322,6 +332,7 @@ declare class SceSwitchComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceSwitchComponent, "sce-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "activeLabel": { "alias": "activeLabel"; "required": false; "isSignal": true; }; "inactiveLabel": { "alias": "inactiveLabel"; "required": false; "isSignal": true; }; }, { "checkedChange": "checkedChange"; }, never, never, true, never>;
 }
 
+/** Five-star rating input with hover preview, arrow-key adjustment and an optional error message, emitting the selected score. */
 declare class SceStarRatingInputComponent {
     readonly value: _angular_core.InputSignal<number>;
     readonly disabled: _angular_core.InputSignal<boolean>;
@@ -338,6 +349,7 @@ declare class SceStarRatingInputComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceStarRatingInputComponent, "sce-star-rating-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/** Currency amount field wrapped in `sce-field` that sanitizes typed text to a non-negative decimal and emits the parsed number, or `null` when cleared; `id` and `label` are required. */
 declare class SceCurrencyInputComponent {
     readonly id: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
@@ -359,6 +371,7 @@ declare class SceCurrencyInputComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceCurrencyInputComponent, "sce-currency-input", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "helpText": { "alias": "helpText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/** Unlabelled numeric input with a trailing unit suffix that sanitizes typed text to a non-negative number and emits the sanitized string. */
 declare class SceUnitInputComponent {
     readonly value: _angular_core.InputSignal<string | number | null>;
     readonly unit: _angular_core.InputSignal<string>;
@@ -385,6 +398,7 @@ declare class SceUnitInputComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceUnitInputComponent, "sce-unit-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "allowDecimal": { "alias": "allowDecimal"; "required": false; "isSignal": true; }; "inputClassName": { "alias": "inputClassName"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "focused": "focused"; }, never, never, true, never>;
 }
 
+/** Labelled numeric field with a trailing unit suffix that defaults to the translated square-metre unit; `id` and `label` are required. */
 declare class SceUnitInputFieldComponent {
     private readonly translate;
     readonly id: _angular_core.InputSignal<string>;
@@ -402,12 +416,16 @@ declare class SceUnitInputFieldComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceUnitInputFieldComponent, "sce-unit-input-field", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "unitInput": { "alias": "unitInput"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "helpText": { "alias": "helpText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "allowDecimal": { "alias": "allowDecimal"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/** A date-field range as two `YYYY-MM-DD` strings in the active calendar system; an unset end is the empty string, not `null`. */
 interface DateRangeValue {
     from: string;
     to: string;
 }
+/** Calendar system a date field runs in; `'georgian'` is a tolerated misspelling that normalizes to `'gregorian'`. */
 type CalendarSystem = 'hijri' | 'gregorian' | 'georgian';
+/** Whether a date field captures one date or a from/to range. */
 type SelectionMode = 'single' | 'range';
+/** The two locales the date utilities format for, driving month names and the first day of the week (Saturday for `ar`). */
 type AppDateLocale = 'ar' | 'en';
 interface CalendarDay {
     date: Date;
@@ -415,6 +433,7 @@ interface CalendarDay {
     labelDay: number;
     value: string;
 }
+/** One month's rendered calendar: the day cells (including leading/trailing days from adjacent months) plus the localized weekday headers. */
 interface CalendarGrid {
     days: CalendarDay[];
     weekdays: string[];
@@ -424,17 +443,24 @@ interface HijriYmd {
     month: number;
     day: number;
 }
+/** Steps a `Date` forward or back by `delta` Hijri months by walking day-by-day across Umm al-Qura month boundaries. */
 declare function addHijriMonths(anchor: Date, delta: number): Date;
+/** Formats a `Date` as its Umm al-Qura Hijri `YYYY-MM-DD` string. */
 declare function toHijriValue(date: Date): string;
+/** Formats a `Date` as its local-time Gregorian `YYYY-MM-DD` string. */
 declare function toGregorianValue(date: Date): string;
+/** Parses a `YYYY-MM-DD` string in the given calendar system back to a `Date`, returning `null` if it is malformed or (for Hijri) has no Gregorian match in the scanned window. */
 declare function parseValueToDate(value: string, system: 'hijri' | 'gregorian'): Date | null;
+/** Builds the six-week day grid around `anchor` for the given calendar system and locale, along with the anchor month's index and year number. */
 declare function buildCalendarGrid(anchor: Date, system: 'hijri' | 'gregorian', locale: AppDateLocale): {
     grid: CalendarGrid;
     currentMonthIndex: number;
     currentYearNumber: number;
 };
+/** Returns the Umm al-Qura Hijri year, month, and day numbers for a `Date`. */
 declare function getHijriYmdFromDate(date: Date): HijriYmd;
 
+/** Date field that pairs a text input with a modal calendar supporting both Hijri and Gregorian systems and single or range selection; it defaults to the Hijri calendar and locks body scroll while the calendar is open. */
 declare class SceDateFieldComponent {
     private doc;
     readonly id: _angular_core.InputSignal<string>;
@@ -499,6 +525,7 @@ declare class SceDateFieldComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDateFieldComponent, "sce-date-field", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "calendarSystem": { "alias": "calendarSystem"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "showToggleDate": { "alias": "showToggleDate"; "required": false; "isSignal": true; }; "hijriOnly": { "alias": "hijriOnly"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "displayFormat": { "alias": "displayFormat"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hideLabel": { "alias": "hideLabel"; "required": false; "isSignal": true; }; "listId": { "alias": "listId"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
+/** Fully-controlled modal calendar used by `sce-date-field`, rendering the day grid plus month and year pickers and emitting every navigation and selection as an output; `locale` and `grid` are required. */
 declare class SceDatePickerModalComponent {
     readonly open: _angular_core.InputSignal<boolean>;
     readonly locale: _angular_core.InputSignal<AppDateLocale>;
@@ -555,6 +582,7 @@ declare class SceDatePickerModalComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDatePickerModalComponent, "sce-date-picker-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": true; "isSignal": true; }; "system": { "alias": "system"; "required": false; "isSignal": true; }; "showToggle": { "alias": "showToggle"; "required": false; "isSignal": true; }; "hijriOnly": { "alias": "hijriOnly"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "draftSingle": { "alias": "draftSingle"; "required": false; "isSignal": true; }; "draftRange": { "alias": "draftRange"; "required": false; "isSignal": true; }; "hoveredDay": { "alias": "hoveredDay"; "required": false; "isSignal": true; }; "anchor": { "alias": "anchor"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "canShowToday": { "alias": "canShowToday"; "required": false; "isSignal": true; }; "grid": { "alias": "grid"; "required": true; "isSignal": true; }; "currentMonthIndex": { "alias": "currentMonthIndex"; "required": false; "isSignal": true; }; "currentYearNumber": { "alias": "currentYearNumber"; "required": false; "isSignal": true; }; "yearRange": { "alias": "yearRange"; "required": false; "isSignal": true; }; "yearPageStart": { "alias": "yearPageStart"; "required": false; "isSignal": true; }; "showMonthPicker": { "alias": "showMonthPicker"; "required": false; "isSignal": true; }; "showYearPicker": { "alias": "showYearPicker"; "required": false; "isSignal": true; }; }, { "systemChange": "systemChange"; "showMonthPickerChange": "showMonthPickerChange"; "showYearPickerChange": "showYearPickerChange"; "movePrev": "movePrev"; "moveNext": "moveNext"; "selectDay": "selectDay"; "hoverDay": "hoverDay"; "clearHoverDay": "clearHoverDay"; "selectMonth": "selectMonth"; "selectYear": "selectYear"; "yearPagePrev": "yearPagePrev"; "yearPageNext": "yearPageNext"; "today": "today"; "cancel": "cancel"; "confirm": "confirm"; "backdropClick": "backdropClick"; }, never, never, true, never>;
 }
 
+/** Page-number paginator with an ellipsis window and a page-size select; it is stateless (`page`, `pageSize`, `totalItems` are required inputs) and derives direction from `locale` unless `dir` is set — note it uses `ViewEncapsulation.None`. */
 declare class ScePaginatorComponent {
     page: _angular_core.InputSignal<number>;
     pageSize: _angular_core.InputSignal<number>;
@@ -581,6 +609,7 @@ declare class ScePaginatorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScePaginatorComponent, "sce-paginator", never, { "page": { "alias": "page"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": true; "isSignal": true; }; "totalItems": { "alias": "totalItems"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "numberFormatter": { "alias": "numberFormatter"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; }, never, never, true, never>;
 }
 
+/** Design-system demo harness that wires `sce-paginator` to local page state; not for production pages. */
 declare class ScePaginatorDemoComponent {
     readonly totalRecords: _angular_core.InputSignal<number>;
     readonly locale: _angular_core.InputSignal<"ar" | "en">;
@@ -592,7 +621,9 @@ declare class ScePaginatorDemoComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScePaginatorDemoComponent, "sce-paginator-demo", never, { "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Width preset shared by every dialog built on `sce-dialog-shell`. */
 type DialogSize = 'sm' | 'md' | 'lg' | 'xl';
+/** Shared PrimeNG-Dialog shell that every sce dialog builds on, providing the sticky header, close button, projected body and footer and the size presets; setting `locked` blocks both Escape and mask dismissal. */
 declare class SceDialogShellComponent {
     /** Controls dialog visibility. */
     visible: _angular_core.InputSignal<boolean>;
@@ -641,6 +672,7 @@ declare class SceDialogShellComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDialogShellComponent, "sce-dialog-shell", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "centerHeader": { "alias": "centerHeader"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "locked": { "alias": "locked"; "required": false; "isSignal": true; }; "dismissableMask": { "alias": "dismissableMask"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "compactBody": { "alias": "compactBody"; "required": false; "isSignal": true; }; "closeAriaLabel": { "alias": "closeAriaLabel"; "required": false; "isSignal": true; }; "hasBody": { "alias": "hasBody"; "required": false; "isSignal": true; }; "hasFooter": { "alias": "hasFooter"; "required": false; "isSignal": true; }; }, { "close": "close"; }, never, ["*", "[dialogFooter]"], true, never>;
 }
 
+/** Design-system demo host that shows `sce-dialog-shell` and reports its visibility back through `visibleChange`. */
 declare class SceDialogShellDemoComponent implements OnInit {
     readonly visible: _angular_core.InputSignal<boolean>;
     readonly visibleChange: _angular_core.OutputEmitterRef<boolean>;
@@ -651,7 +683,9 @@ declare class SceDialogShellDemoComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDialogShellDemoComponent, "sce-dialog-shell-demo", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; }, { "visibleChange": "visibleChange"; }, never, never, true, never>;
 }
 
+/** Tone of a confirm dialog, selecting both its header icon and the severity of its confirm button. */
 type ConfirmDialogVariant = 'primary' | 'danger' | 'success' | 'warning' | 'info';
+/** Configuration for the optional reason input a confirm dialog can collect before confirming — set `multiline` for a textarea and `required` to block confirmation until it is filled. */
 interface ConfirmReasonField {
     label: string;
     placeholder?: string;
@@ -663,6 +697,7 @@ interface ConfirmReasonField {
     maxLength?: number;
     rows?: number;
 }
+/** Confirmation dialog built on `sce-dialog-shell` with per-variant icon and button styling and an optional reason field; supplying `onConfirmHandler` makes it await the async handler and lock the buttons, mask and Escape while pending. */
 declare class SceConfirmDialogComponent {
     private readonly translate;
     visible: _angular_core.InputSignal<boolean>;
@@ -720,6 +755,7 @@ declare class SceConfirmDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceConfirmDialogComponent, "sce-confirm-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "confirmDisabled": { "alias": "confirmDisabled"; "required": false; "isSignal": true; }; "cancelDisabled": { "alias": "cancelDisabled"; "required": false; "isSignal": true; }; "hideCancelButton": { "alias": "hideCancelButton"; "required": false; "isSignal": true; }; "field": { "alias": "field"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "centerHeader": { "alias": "centerHeader"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "hasBodySlot": { "alias": "hasBodySlot"; "required": false; "isSignal": true; }; "onConfirmHandler": { "alias": "onConfirmHandler"; "required": false; "isSignal": true; }; }, { "close": "close"; "cancel": "cancel"; "confirm": "confirm"; }, never, ["[confirmIcon]", "[confirmBody]"], true, never>;
 }
 
+/** Design-system demo host that shows `sce-confirm-dialog` and reports its visibility back through `visibleChange`. */
 declare class SceConfirmDialogDemoComponent implements OnInit {
     readonly visible: _angular_core.InputSignal<boolean>;
     readonly visibleChange: _angular_core.OutputEmitterRef<boolean>;
@@ -751,11 +787,13 @@ declare class SceModalHostComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceModalHostComponent, "sce-modal-host", never, {}, {}, never, never, true, never>;
 }
 
+/** An already-uploaded image the zone renders alongside new picks, removable via the `removeExisting` output. */
 interface FileUploadExistingItem {
     id: string;
     url: string;
     alt?: string;
 }
+/** Overridable copy for `sce-file-upload-zone`; the two size/count messages are functions so the limit can be interpolated. */
 interface FileUploadZoneStrings {
     chooseFile: string;
     addImage: string;
@@ -764,6 +802,7 @@ interface FileUploadZoneStrings {
     fileTooLarge: (maxSizeLabel: string) => string;
     tooManyFiles: (max: number) => string;
 }
+/** Drag-and-drop file picker with client-side accept/size/count validation and image previews; uploading is the consumer's job (it only emits `fileChange`/`filesChange`), it is not a ControlValueAccessor, and it uses `ViewEncapsulation.None`. */
 declare class SceFileUploadZoneComponent implements OnDestroy {
     private readonly translate;
     locale: _angular_core.InputSignal<"ar" | "en">;
@@ -838,6 +877,7 @@ declare class SceFileUploadZoneComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFileUploadZoneComponent, "sce-file-upload-zone", never, { "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "uploading": { "alias": "uploading"; "required": false; "isSignal": true; }; "uploadError": { "alias": "uploadError"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "allowDrop": { "alias": "allowDrop"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxFileSizeBytes": { "alias": "maxFileSizeBytes"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "showPreviews": { "alias": "showPreviews"; "required": false; "isSignal": true; }; "appendOnSelect": { "alias": "appendOnSelect"; "required": false; "isSignal": true; }; "existingItems": { "alias": "existingItems"; "required": false; "isSignal": true; }; "strings": { "alias": "strings"; "required": false; "isSignal": true; }; "topLabel": { "alias": "topLabel"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; "filesChange": "filesChange"; "removeExisting": "removeExisting"; "fileDialogOpen": "fileDialogOpen"; "fileDialogClose": "fileDialogClose"; }, never, never, true, never>;
 }
 
+/** Design-system demo page for `sce-file-upload-zone`, showing its zone and dialog variants under the `dir` passed in. */
 declare class SceFileUploadZoneDemoComponent {
     readonly dir: _angular_core.InputSignal<"rtl" | "ltr">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceFileUploadZoneDemoComponent, never>;
@@ -848,19 +888,26 @@ declare class SceFileUploadZoneDemoComponent {
  * React source: Moatamed-Frontend/src/shared-utils/components/business-status/business-status-tone.ts
  */
 type BusinessStatusTone = 'draft-initial' | 'modified' | 'cancelled' | 'closed' | 'returned-edit' | 'active' | 'pending-beneficiary' | 'pending-approval' | 'request-draft' | 'open-offers' | 'extended' | 'request-closed' | 'awarded' | 'request-new' | 'rejected' | 'approved' | 'invitation-public' | 'invitation-direct' | 'fallback-1' | 'fallback-2' | 'fallback-3' | 'fallback-4' | 'fallback-5' | 'fallback-6' | 'fallback-7' | 'fallback-8';
+/** Maps a free-text Arabic or English status label to a tone by keyword match, falling back to one of eight stable hash-picked tones. */
 declare function resolveBusinessStatusTone(label: string | null | undefined): BusinessStatusTone;
+/** A status label paired with the `BusinessStatusTone` resolved for it. */
 interface BusinessStatusPresentation {
     label: string;
     tone: BusinessStatusTone;
 }
+/** Resolves a label and its tone together, substituting `fallbackLabel` (an em dash by default) when the label is blank. */
 declare function resolveBusinessStatusPresentation(label: string | null | undefined, fallbackLabel?: string): BusinessStatusPresentation;
+/** Convenience wrapper over `resolveBusinessStatusPresentation` that returns the plain `{ label, tone }` shape table cells bind to. */
 declare function toBusinessStatusTableCell(label: string | null | undefined, fallbackLabel?: string): {
     label: string;
     tone: BusinessStatusTone;
 };
 
+/** Colour scheme of `sce-tag`; ignored when `businessTone` is supplied. */
 type SceTagVariant = 'pending' | 'in-progress' | 'info' | 'success' | 'inactive' | 'danger' | 'warning' | 'neutral' | 'purple' | 'assigned' | 'review' | 'new' | 'closed';
+/** Height and typography scale of `sce-tag`; defaults to `md`. */
 type SceTagSize = 'sm' | 'md' | 'lg';
+/** Status pill rendering `label`; colour comes from `businessTone` when set and otherwise from `variant` (default `pending`), and it uses `ViewEncapsulation.None`. */
 declare class SceTagComponent {
     readonly label: _angular_core.InputSignal<string>;
     readonly variant: _angular_core.InputSignal<SceTagVariant>;
@@ -876,6 +923,7 @@ declare class SceTagComponent {
 
 /** Shared with `sce-status-page` so every page state speaks the same visual language. */
 type EmptyStateTone = 'neutral' | 'info' | 'success' | 'warning' | 'error';
+/** Empty state with an illustration (or a tinted PrimeIcons circle when no `imageSrc` is given), a title and a subtitle, each settable as literal text or a translation key; the `error` tone announces assertively via `role="alert"` while every other tone stays a polite status. */
 declare class SceEmptyStateComponent {
     /** Translation key for the title (e.g. COMMON.NO_DATA). Used when title is not provided. */
     readonly titleKey: _angular_core.InputSignal<string | undefined>;
@@ -922,6 +970,7 @@ declare class SceEmptyStateComponent {
 type ResultStateStatus = 'api-error' | 'network-offline' | 'timeout' | 'server-error' | 'no-data' | 'no-filter-results' | 'no-search-results' | 'not-found' | 'forbidden' | 'unauthorized' | 'maintenance' | 'coming-soon' | 'first-use';
 /** Action buttons a preset can offer. The first entry renders as the primary button. */
 type ResultStateAction = 'retry' | 'back' | 'clearFilters' | 'clearSearch' | 'signIn';
+/** The tone, icon, copy keys, and default action buttons `sce-result-state` renders for one status. */
 interface ResultStatePreset {
     readonly tone: EmptyStateTone;
     /** PrimeIcons suffix. */
@@ -947,6 +996,7 @@ declare const RESULT_STATE_ACTION_META: Readonly<Record<ResultStateAction, {
     directional?: boolean;
 }>>;
 
+/** One column of `sce-generic-table`: the row `field` to read, its header text, and optional sorting (via `sortKey`) and alignment. */
 interface SceTableColumn {
     field: string;
     header: string;
@@ -954,11 +1004,13 @@ interface SceTableColumn {
     sortKey?: string;
     align?: 'start' | 'center' | 'end';
 }
+/** Cell value that renders as a status tag; supply `businessTone` for the business-status palette, otherwise `variant` picks an `SceTagVariant`. */
 interface SceTableStatusCell {
     label: string;
     variant?: SceTagVariant;
     tone?: BusinessStatusTone;
 }
+/** Cell value that renders as a toggle switch; the table echoes `rowId` and the column field back through `switchChange`. */
 interface SceTableSwitchCell {
     type: 'switch';
     checked: boolean;
@@ -967,20 +1019,24 @@ interface SceTableSwitchCell {
     inactiveLabel?: string;
     rowId: string;
 }
+/** Per-row opt-in for the edit and delete action buttons, set on a row's `_rowActions` key. */
 interface SceTableRowActions {
     edit?: boolean;
     delete?: boolean;
 }
+/** One row of `sce-generic-table`: a required `id`, an optional `rowHref`/`_rowActions`, and an open index of cell values that may be plain strings, status cells, or switch cells. */
 interface SceTableRow {
     id: string;
     rowHref?: string;
     _rowActions?: SceTableRowActions;
     [key: string]: string | SceTableStatusCell | SceTableSwitchCell | SceTableRowActions | undefined;
 }
+/** Current table sort: the column key plus a tri-state `orderBy` (0 unsorted, 1 ascending, 2 descending). */
 interface SceTableSort {
     key: string;
     orderBy: 0 | 1 | 2;
 }
+/** Pagination config for `sce-generic-table`; `mode: 'client'` slices the supplied rows, while `'server'` expects the host to honour `pageChange` and provide `totalItems`. */
 interface SceTablePagination {
     enabled?: boolean;
     pageSize?: number;
@@ -990,6 +1046,7 @@ interface SceTablePagination {
     page?: number;
     totalItems?: number;
 }
+/** Data table driven by `columns` and `rows`, with sorting, client- or server-side pagination, status/switch cells, and row actions; its empty body reads differently depending on `error`, `searching`, and `filtered`, and it uses `ViewEncapsulation.None`. */
 declare class SceGenericTableComponent {
     private readonly messageService;
     private readonly translate;
@@ -1114,6 +1171,7 @@ declare class SceGenericTableComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceGenericTableComponent, "sce-generic-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": false; "isSignal": true; }; "loadingDelay": { "alias": "loadingDelay"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorStatus": { "alias": "errorStatus"; "required": false; "isSignal": true; }; "filtered": { "alias": "filtered"; "required": false; "isSignal": true; }; "searching": { "alias": "searching"; "required": false; "isSignal": true; }; }, { "errorRetry": "errorRetry"; "clearFilters": "clearFilters"; "clearSearch": "clearSearch"; "sortChange": "sortChange"; "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; "rowClick": "rowClick"; "switchChange": "switchChange"; "editClick": "editClick"; "deleteClick": "deleteClick"; }, never, never, true, never>;
 }
 
+/** Design-system demo harness for `sce-generic-table` with three hard-coded rows; its columns and rows re-translate whenever `LanguageService.locale()` changes. */
 declare class SceGenericTableDemoComponent {
     private readonly translate;
     private readonly language;
@@ -1124,6 +1182,7 @@ declare class SceGenericTableDemoComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceGenericTableDemoComponent, "sce-generic-table-demo", never, {}, {}, never, never, true, never>;
 }
 
+/** Status tag whose colour tone is inferred from the label text when `tone` is not supplied explicitly. */
 declare class SceBusinessStatusTagComponent {
     label: _angular_core.InputSignal<string>;
     tone: _angular_core.InputSignal<BusinessStatusTone | undefined>;
@@ -1133,6 +1192,7 @@ declare class SceBusinessStatusTagComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceBusinessStatusTagComponent, "sce-business-status-tag", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Verified/unverified badge icon derived from an engineering office's service-provider status. */
 declare class SceEngineeringOfficeVerificationBadgeComponent {
     readonly status: _angular_core.InputSignal<OrganizationServiceProviderStatus | null | undefined>;
     readonly size: _angular_core.InputSignal<number>;
@@ -1143,6 +1203,7 @@ declare class SceEngineeringOfficeVerificationBadgeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceEngineeringOfficeVerificationBadgeComponent, "sce-engineering-office-verification-badge", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Circular office logo that renders uploaded photos with `object-fit: cover` and bundled SVGs with `contain`, falling back to the default office icon when the source is empty or fails to load. */
 declare class SceOfficeBrandLogoComponent {
     /** Logo source. http(s)/CMS/blob/data render as photo; anything else as bundled icon. */
     readonly src: _angular_core.InputSignal<string>;
@@ -1160,6 +1221,7 @@ declare class SceOfficeBrandLogoComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeBrandLogoComponent, "sce-office-brand-logo", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "iconClassName": { "alias": "iconClassName"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Inline error banner for an already-resolved `message`, showing a retry button only when `retryable` is opted into (it defaults to false so a failed save cannot re-trigger a load). */
 declare class SceInlineApiErrorComponent {
     message: _angular_core.InputSignal<string>;
     className: _angular_core.InputSignal<string>;
@@ -1280,7 +1342,9 @@ declare class SceGlobalLoadingBarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceGlobalLoadingBarComponent, "sce-global-loading-bar", never, {}, {}, never, never, true, never>;
 }
 
+/** Colour/tone of a notification badge, one per notification kind (contract, offer, approval, alert…). */
 type DashboardNotificationTypeVariant = 'contract-new' | 'contract-closed' | 'offer' | 'approved' | 'rejected' | 'alert' | 'info';
+/** Small pill showing a notification's kind: renders the already-translated `label` styled by `variant` (default `info`), with extra classes from `className`; uses `ViewEncapsulation.None`. */
 declare class SceNotificationTypeBadgeComponent {
     readonly label: _angular_core.InputSignal<string>;
     readonly variant: _angular_core.InputSignal<DashboardNotificationTypeVariant>;
@@ -1292,6 +1356,7 @@ declare class SceNotificationTypeBadgeComponent {
 
 type InfoFieldCardVariant = 'default' | 'highlight' | 'editable';
 type InfoFieldCardSize = 'default' | 'compact';
+/** Read-only label/value card used throughout profile and review screens, with default, highlight and editable variants. */
 declare class SceInfoFieldCardComponent {
     readonly label: _angular_core.InputSignal<string | undefined>;
     readonly value: _angular_core.InputSignal<string | undefined>;
@@ -1305,6 +1370,7 @@ declare class SceInfoFieldCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceInfoFieldCardComponent, "sce-info-field-card", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "labelClassName": { "alias": "labelClassName"; "required": false; "isSignal": true; }; "valueClassName": { "alias": "valueClassName"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Layout wrapper that arranges projected info-field cards into a one- to four-column grid. */
 declare class SceInfoFieldsGridComponent {
     readonly columns: _angular_core.InputSignal<1 | 3 | 4 | 2>;
     readonly gap: _angular_core.InputSignal<"sm" | "default">;
@@ -1330,6 +1396,7 @@ declare class ScePublicLegalProseComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScePublicLegalProseComponent, "sce-public-legal-prose", never, { "html": { "alias": "html"; "required": true; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Table row-action affordance rendering the chevron icon with `alt` as its accessible text; uses `ViewEncapsulation.None`, so its styles are global. */
 declare class SceRowActionIconComponent {
     readonly alt: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceRowActionIconComponent, never>;
@@ -1337,6 +1404,7 @@ declare class SceRowActionIconComponent {
 }
 
 type DashboardRole$1 = 'client' | 'manager' | 'entity' | 'office';
+/** Avatar/role icon for a dashboard account; the supplied `photoUrl` is only used for individual client accounts, everything else falls back to the role icon. */
 declare class SceDashboardAccountRoleIconComponent {
     readonly role: _angular_core.InputSignal<DashboardRole$1>;
     readonly accountKind: _angular_core.InputSignal<"individual" | "organization" | undefined>;
@@ -1351,11 +1419,13 @@ declare class SceDashboardAccountRoleIconComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDashboardAccountRoleIconComponent, "sce-dashboard-account-role-icon", never, { "role": { "alias": "role"; "required": false; "isSignal": true; }; "accountKind": { "alias": "accountKind"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "photoUrl": { "alias": "photoUrl"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One label/value row of a review panel; a null or undefined `value` renders as a placeholder, and `hidden` drops the row entirely. */
 interface ReviewFieldItem {
     label: string;
     value: string | number | null | undefined;
     hidden?: boolean;
 }
+/** Panel rendering a list of label/value review fields as table rows, skipping any item marked `hidden`. */
 declare class SceReviewFieldTablePanelComponent {
     items: _angular_core.InputSignal<ReviewFieldItem[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceReviewFieldTablePanelComponent, never>;
@@ -1392,6 +1462,7 @@ declare class SceServiceCardStartButtonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceServiceCardStartButtonComponent, "sce-service-card-start-button", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "externalStart": { "alias": "externalStart"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; }, never, never, true, never>;
 }
 
+/** View model of an engineering-office card; hero and logo each accept either a URL (`imageSrc`/`logoSrc`) or a blob `objectUrl`, and `extraTagsCount` drives the "+N more" chip. */
 interface SceEngineeringOfficeCardModel {
     name: string;
     imageSrc?: string;
@@ -1430,6 +1501,7 @@ declare class SceEngineeringOfficeCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceEngineeringOfficeCardComponent, "sce-engineering-office-card", never, { "office": { "alias": "office"; "required": true; "isSignal": true; }; "viewMode": { "alias": "viewMode"; "required": false; "isSignal": true; }; "bookmarkLabel": { "alias": "bookmarkLabel"; "required": false; "isSignal": true; }; "bookmarked": { "alias": "bookmarked"; "required": false; "isSignal": true; }; "ratingLabel": { "alias": "ratingLabel"; "required": false; "isSignal": true; }; "locationLabel": { "alias": "locationLabel"; "required": false; "isSignal": true; }; "otherLabel": { "alias": "otherLabel"; "required": false; "isSignal": true; }; }, { "bookmarkClick": "bookmarkClick"; }, never, never, true, never>;
 }
 
+/** Loading placeholder for the engineering office card, mirroring its grid or list layout via `viewMode`. */
 declare class SceEngineeringOfficeCardSkeletonComponent {
     readonly viewMode: _angular_core.InputSignal<"grid" | "list">;
     readonly wrapperClass: _angular_core.Signal<string>;
@@ -1438,17 +1510,20 @@ declare class SceEngineeringOfficeCardSkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceEngineeringOfficeCardSkeletonComponent, "sce-engineering-office-card-skeleton", never, { "viewMode": { "alias": "viewMode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Contents of one office metric tile: a `title`, a `subtitle` and an optional icon name. */
 interface OfficeMetricCardItem {
     title: string;
     subtitle: string;
     icon?: string;
 }
+/** Single office metric tile rendering a title, subtitle and optional icon in an accent or soft variant. */
 declare class SceOfficeMetricCardComponent {
     readonly item: _angular_core.InputSignal<OfficeMetricCardItem>;
     readonly variant: _angular_core.InputSignal<"accent" | "soft">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceOfficeMetricCardComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeMetricCardComponent, "sce-office-metric-card", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
+/** Row of office metric tiles laid out in two or three columns, sharing one variant across all items. */
 declare class SceOfficeMetricCardsRowComponent {
     readonly items: _angular_core.InputSignal<OfficeMetricCardItem[]>;
     readonly variant: _angular_core.InputSignal<"accent" | "soft">;
@@ -1457,6 +1532,7 @@ declare class SceOfficeMetricCardsRowComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeMetricCardsRowComponent, "sce-office-metric-cards-row", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Loading placeholder matching `sce-info-fields-grid`: `count` info-field cards (default 6) with an optional section-title bar. */
 declare class SceInfoFieldsSkeletonComponent {
     /** Number of info-field cards to render */
     readonly count: _angular_core.InputSignal<number>;
@@ -1469,6 +1545,7 @@ declare class SceInfoFieldsSkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceInfoFieldsSkeletonComponent, "sce-info-fields-skeleton", never, { "count": { "alias": "count"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "showSectionTitle": { "alias": "showSectionTitle"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Loading placeholder for a form: `count` label-plus-input pairs (default 6) laid out in one or two `columns`. */
 declare class SceFormFieldsSkeletonComponent {
     readonly count: _angular_core.InputSignal<number>;
     readonly columns: _angular_core.InputSignal<1 | 2>;
@@ -1477,6 +1554,7 @@ declare class SceFormFieldsSkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFormFieldsSkeletonComponent, "sce-form-fields-skeleton", never, { "count": { "alias": "count"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Loading placeholder for a notification list: `count` rows (default 5), with `compact` tightening the padding for dropdown menus. */
 declare class SceNotificationListSkeletonComponent {
     readonly count: _angular_core.InputSignal<number>;
     /** Compact padding for dropdown menus */
@@ -1486,6 +1564,7 @@ declare class SceNotificationListSkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceNotificationListSkeletonComponent, "sce-notification-list-skeleton", never, { "count": { "alias": "count"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Loading placeholder for a profile page: a hero banner of `heroHeight` (default `230px`) above `fieldCount` info-field placeholders. */
 declare class SceProfileHeroSkeletonComponent {
     readonly heroHeight: _angular_core.InputSignal<string>;
     readonly fieldCount: _angular_core.InputSignal<number>;
@@ -1493,7 +1572,9 @@ declare class SceProfileHeroSkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceProfileHeroSkeletonComponent, "sce-profile-hero-skeleton", never, { "heroHeight": { "alias": "heroHeight"; "required": false; "isSignal": true; }; "fieldCount": { "alias": "fieldCount"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Wrapper style for the table skeleton: a standalone card, or the `.block` shell used by dashboard tables. */
 type SceTableSkeletonLayout = 'standalone' | 'dashboard-block';
+/** Loading placeholder for a data table (`columns` x `rows`, default 5x5), cycling a fixed set of column widths and treating the last column as a status pill; `wrapInCard` defaults to true. */
 declare class SceTableSkeletonComponent {
     readonly columns: _angular_core.InputSignal<number>;
     readonly rows: _angular_core.InputSignal<number>;
@@ -1538,17 +1619,20 @@ declare class SceFeaturedOfficeCardSkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFeaturedOfficeCardSkeletonComponent, "sce-featured-office-card-skeleton", never, {}, {}, never, never, true, never>;
 }
 
+/** Fixed loading placeholder for the service-detail page; takes no inputs. */
 declare class SceServiceDetailSkeletonComponent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceServiceDetailSkeletonComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceServiceDetailSkeletonComponent, "sce-service-detail-skeleton", never, {}, {}, never, never, true, never>;
 }
 
+/** Loading placeholder for the office-details panel — `count` repeated blocks (minimum 1); uses `ViewEncapsulation.None` and shares its styles with the office-projects skeleton. */
 declare class SceOfficeDetailsSkeletonComponent {
     readonly count: _angular_core.InputSignal<number>;
     readonly countArray: _angular_core.Signal<number[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceOfficeDetailsSkeletonComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeDetailsSkeletonComponent, "sce-office-details-skeleton", never, { "count": { "alias": "count"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
+/** Office-projects loading placeholder; reuses the office-details skeleton template but carries no styles of its own, so it inherits them from an office-details skeleton rendered elsewhere on the page (`ViewEncapsulation.None`). */
 declare class SceOfficeProjectsSkeletonComponent {
     readonly count: _angular_core.InputSignal<number>;
     readonly countArray: _angular_core.Signal<number[]>;
@@ -1556,6 +1640,7 @@ declare class SceOfficeProjectsSkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProjectsSkeletonComponent, "sce-office-projects-skeleton", never, { "count": { "alias": "count"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One engineering office plotted on the offices map; `approximate` marks a coordinate derived from a city or region rather than a precise address. */
 interface SceOsmOfficeMapPoint {
     id: string | number;
     name: string;
@@ -1592,10 +1677,12 @@ declare class SceOsmOfficesMapComponent implements AfterViewInit, OnChanges, OnD
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOsmOfficesMapComponent, "sce-osm-offices-map", never, { "offices": { "alias": "offices"; "required": false; "isSignal": true; }; "selectedOfficeId": { "alias": "selectedOfficeId"; "required": false; "isSignal": true; }; "showTooltip": { "alias": "showTooltip"; "required": false; "isSignal": true; }; "ariaLabelInput": { "alias": "ariaLabelInput"; "required": false; "isSignal": true; }; }, { "selectOffice": "selectOffice"; "ready": "ready"; "mapError": "mapError"; }, never, never, true, never>;
 }
 
+/** An inclusive from/to date range, with `null` on either end meaning that bound is open. */
 interface FilterDateRangeValue {
     from: Date | null;
     to: Date | null;
 }
+/** Filter-bar date-range picker with a leading icon and a clear button; works controlled when `value` is bound and falls back to its own internal state when it is left `undefined`, and uses `ViewEncapsulation.None`. */
 declare class SceFilterCalendarRangeComponent {
     locale: _angular_core.InputSignal<"ar" | "en">;
     placeholder: _angular_core.InputSignal<string>;
@@ -1617,10 +1704,12 @@ declare class SceFilterCalendarRangeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFilterCalendarRangeComponent, "sce-filter-calendar-range", never, { "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "iconSrc": { "alias": "iconSrc"; "required": false; "isSignal": true; }; "iconAlt": { "alias": "iconAlt"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/** A single choice offered by a `select`-kind `DashboardFilterField`. */
 interface DashboardFilterFieldOption {
     label: string;
     value: string;
 }
+/** Discriminated union of the filter controls a dashboard table can render, keyed by `kind` (`search`, `text`, `select`, `date`, `dateRange`); each variant carries its own value and `onChange` callback rather than being bound with `ngModel`. */
 type DashboardFilterField = {
     kind: 'search';
     id: string;
@@ -1667,6 +1756,7 @@ type DashboardFilterField = {
     iconSrc?: string;
     iconAlt?: string;
 };
+/** Renders a dashboard table's filter row from a declarative `fields` array and exposes `hasActiveSearch`/`hasActiveFilters` plus `clearSearch()`/`clearFilters()` for a page to drive via a template reference; uses `ViewEncapsulation.None`. */
 declare class SceDashboardTableFiltersComponent {
     locale: _angular_core.InputSignal<"ar" | "en">;
     idPrefix: _angular_core.InputSignal<string>;
@@ -1697,10 +1787,12 @@ declare class SceDashboardTableFiltersComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDashboardTableFiltersComponent, "sce-dashboard-table-filters", never, { "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "idPrefix": { "alias": "idPrefix"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** A single `label`/`value` choice in `sce-filter-dropdown`. */
 interface FilterDropdownOption {
     label: string;
     value: string;
 }
+/** Filter-bar select built on PrimeNG `Select` with an optional leading icon, clear button, and type-ahead `filter`; controlled when `value` is bound and self-managing when it is left `undefined`, and uses `ViewEncapsulation.None`. */
 declare class SceFilterDropdownComponent {
     id: _angular_core.InputSignal<string>;
     locale: _angular_core.InputSignal<"ar" | "en">;
@@ -1724,6 +1816,7 @@ declare class SceFilterDropdownComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFilterDropdownComponent, "sce-filter-dropdown", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "iconSrc": { "alias": "iconSrc"; "required": false; "isSignal": true; }; "iconAlt": { "alias": "iconAlt"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/** Filter-bar single-date picker with a leading icon and a clear button; controlled when `value` is bound and self-managing when it is left `undefined`, and uses `ViewEncapsulation.None`. */
 declare class SceFilterCalendarComponent {
     locale: _angular_core.InputSignal<"ar" | "en">;
     placeholder: _angular_core.InputSignal<string>;
@@ -1761,6 +1854,7 @@ interface ServicesTopFiltersChange {
  */
 /** Which of the three dropdowns a change came from. */
 type SceServicesTopFilterField = 'category' | 'target' | 'extra';
+/** Filter bar for the public services and offices listings, rendering a search box plus category, target, extra and sort dropdowns and emitting the resolved filter state via `filtersChange`. */
 declare class SceServicesTopFiltersComponent implements OnInit {
     private readonly language;
     private readonly translate;
@@ -1858,10 +1952,12 @@ declare class SceServicesTopFiltersComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceServicesTopFiltersComponent, "sce-services-top-filters", never, { "q": { "alias": "q"; "required": false; "isSignal": true; }; "category": { "alias": "category"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "targets": { "alias": "targets"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "extra": { "alias": "extra"; "required": false; "isSignal": true; }; "extraOptions": { "alias": "extraOptions"; "required": false; "isSignal": true; }; "extraParamName": { "alias": "extraParamName"; "required": false; "isSignal": true; }; }, { "filtersChange": "filtersChange"; }, never, never, true, never>;
 }
 
+/** One entry in the landing navigation bar: the router path and the i18n key rendered as its label. */
 interface LandingNavItem {
     href: string;
     label: string;
 }
+/** Landing-page navigation bar that renders the required `items` as router links with route prefetching and active-route highlighting. */
 declare class SceLandingNavComponent {
     readonly items: _angular_core.InputSignal<LandingNavItem[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceLandingNavComponent, never>;
@@ -1896,6 +1992,7 @@ declare class SceLandingMobileMenuComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLandingMobileMenuComponent, "sce-landing-mobile-menu", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Button that switches the app between Arabic and English through LanguageService, labelled with the language it will switch to rather than the current one. */
 declare class SceLangToggleComponent {
     private readonly language;
     private readonly translate;
@@ -1908,6 +2005,7 @@ declare class SceLangToggleComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLangToggleComponent, "sce-lang-toggle", never, { "lightContext": { "alias": "lightContext"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Light/dark theme switcher backed by ThemeService, with labels falling back to translated defaults. */
 declare class SceThemeSwitcherComponent {
     private readonly themeService;
     private readonly translate;
@@ -1941,6 +2039,7 @@ declare class SceThemeToggleButtonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceThemeToggleButtonComponent, "sce-theme-toggle-button", never, {}, {}, never, never, true, never>;
 }
 
+/** Tone of an action dialog's confirm button — `danger` for destructive actions. */
 type ActionDialogVariant = 'primary' | 'danger';
 /** Legacy reason-field config preserved for back-compat. */
 interface ActionDialogField {
@@ -1952,6 +2051,7 @@ interface ActionDialogField {
     multiline?: boolean;
     error?: string;
 }
+/** Thin wrapper over `sce-confirm-dialog` for approve/reject actions, offering a convenience reason-textarea API (`showReasonInput` and friends) alongside the legacy `field` config, which wins when both are supplied. */
 declare class SceActionDialogComponent {
     visible: _angular_core.InputSignal<boolean>;
     locale: _angular_core.InputSignal<"ar" | "en">;
@@ -1995,11 +2095,14 @@ declare class SceActionDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceActionDialogComponent, "sce-action-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": true; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": true; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "confirmDisabled": { "alias": "confirmDisabled"; "required": false; "isSignal": true; }; "field": { "alias": "field"; "required": false; "isSignal": true; }; "showReasonInput": { "alias": "showReasonInput"; "required": false; "isSignal": true; }; "reasonLabel": { "alias": "reasonLabel"; "required": false; "isSignal": true; }; "reasonPlaceholder": { "alias": "reasonPlaceholder"; "required": false; "isSignal": true; }; "reasonValue": { "alias": "reasonValue"; "required": false; "isSignal": true; }; "reasonRequired": { "alias": "reasonRequired"; "required": false; "isSignal": true; }; "reasonError": { "alias": "reasonError"; "required": false; "isSignal": true; }; }, { "close": "close"; "cancel": "cancel"; "confirm": "confirm"; "reasonChange": "reasonChange"; "fieldChange": "fieldChange"; }, never, never, true, never>;
 }
 
+/** Tone of a form dialog's submit button. */
 type FormDialogVariant = 'primary' | 'danger' | 'success';
+/** An extra footer button beside submit and cancel in `sce-form-dialog`; clicking it emits an output rather than submitting the form. */
 interface FormDialogSecondaryAction {
     label: string;
     disabled?: boolean;
 }
+/** Dialog shell for forms, with submit/cancel footer buttons, an optional secondary action and an error banner; the footer submit button lives outside the projected `<form>` and is wired to it by a generated id, so submission goes through the native form submit event. */
 declare class SceFormDialogComponent {
     private readonly translate;
     visible: _angular_core.InputSignal<boolean>;
@@ -2035,6 +2138,7 @@ declare class SceFormDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFormDialogComponent, "sce-form-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "submitLabel": { "alias": "submitLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "isSubmitting": { "alias": "isSubmitting"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "dismissableMask": { "alias": "dismissableMask"; "required": false; "isSignal": true; }; "secondaryAction": { "alias": "secondaryAction"; "required": false; "isSignal": true; }; "secondaryActionPosition": { "alias": "secondaryActionPosition"; "required": false; "isSignal": true; }; }, { "close": "close"; "submitForm": "submitForm"; "submitValues": "submitValues"; "secondaryActionClick": "secondaryActionClick"; }, never, ["*"], true, never>;
 }
 
+/** Optionally-titled section wrapper for grouping projected fields inside `sce-form-dialog`, laid out in one or two columns. */
 declare class SceFormDialogSectionComponent {
     title: _angular_core.InputSignal<string | undefined>;
     twoColumn: _angular_core.InputSignal<boolean>;
@@ -2042,6 +2146,7 @@ declare class SceFormDialogSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFormDialogSectionComponent, "sce-form-dialog-section", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "twoColumn": { "alias": "twoColumn"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Renders the small leading `<img>` icon inside a filter control, sized 20x20 by default and omitted entirely when `iconSrc` is unset. */
 declare class SceFilterFieldIconComponent {
     iconSrc: _angular_core.InputSignal<string | undefined>;
     iconAlt: _angular_core.InputSignal<string>;
@@ -2052,11 +2157,13 @@ declare class SceFilterFieldIconComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFilterFieldIconComponent, "sce-filter-field-icon", never, { "iconSrc": { "alias": "iconSrc"; "required": false; "isSignal": true; }; "iconAlt": { "alias": "iconAlt"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One accordion panel: an `id` used for open/close identity, plus its `title` and `content` strings. */
 interface AccordionItem {
     id: number | string;
     title: string;
     content: string;
 }
+/** Single-expand accordion that renders a list of title/content items, toggling one open panel at a time. */
 declare class SceAccordionComponent {
     items: _angular_core.InputSignal<AccordionItem[]>;
     className: _angular_core.InputSignal<string>;
@@ -2069,11 +2176,13 @@ declare class SceAccordionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAccordionComponent, "sce-accordion", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "itemClassName": { "alias": "itemClassName"; "required": false; "isSignal": true; }; "headerClassName": { "alias": "headerClassName"; "required": false; "isSignal": true; }; "contentClassName": { "alias": "contentClassName"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One step in a wizard stepper, identified by a numeric `id` that also orders it against `currentStep`. */
 interface StepItem$1 {
     id: number;
     title: string;
     completed?: boolean;
 }
+/** Horizontal wizard progress indicator with three `variant`s (numbered `steps`, a `progress` bar, or `pills`), optional per-step error markers, and click-to-navigate gated by `clickable` (off by default) plus an `isStepClickable` predicate; uses `ViewEncapsulation.None`. */
 declare class SceHorizontalWizardStepperComponent {
     private readonly translate;
     steps: _angular_core.InputSignal<StepItem$1[]>;
@@ -2114,6 +2223,7 @@ declare class SceHorizontalWizardStepperComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceHorizontalWizardStepperComponent, "sce-horizontal-wizard-stepper", never, { "steps": { "alias": "steps"; "required": true; "isSignal": true; }; "currentStep": { "alias": "currentStep"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "errorStepIds": { "alias": "errorStepIds"; "required": false; "isSignal": true; }; "isStepClickable": { "alias": "isStepClickable"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "showErrors": { "alias": "showErrors"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, { "stepClick": "stepClick"; "showError": "showError"; }, never, never, true, never>;
 }
 
+/** Vertical wizard stepper sharing `StepItem` with the horizontal one; unlike that component `clickable` defaults to true, and `errorStepIds` marks steps whose `showError` link is emitted on click. */
 declare class SceVerticalStepperComponent {
     private readonly translate;
     steps: _angular_core.InputSignal<StepItem$1[]>;
@@ -2163,9 +2273,12 @@ declare class SceVerticalStepperComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceVerticalStepperComponent, "sce-vertical-stepper", never, { "steps": { "alias": "steps"; "required": true; "isSignal": true; }; "currentStep": { "alias": "currentStep"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; "errorStepIds": { "alias": "errorStepIds"; "required": false; "isSignal": true; }; "isStepClickable": { "alias": "isStepClickable"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; }, { "stepClick": "stepClick"; "showError": "showError"; }, never, never, true, never>;
 }
 
+/** Size preset shared by the loader components; each maps to a fixed pixel dimension (28 / 42 / 56). */
 type LoaderSize = 'sm' | 'md' | 'lg';
+/** Whether a loader sits in the flow of the page or covers the viewport as a blocking overlay. */
 type LoaderVariant = 'inline' | 'fullscreen';
 
+/** Branded loading indicator that animates the app logo at a small/medium/large size preset, rendered inline or as a fullscreen overlay. */
 declare class SceBrandLoaderComponent {
     private readonly translate;
     size: _angular_core.InputSignal<LoaderSize>;
@@ -2179,6 +2292,7 @@ declare class SceBrandLoaderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceBrandLoaderComponent, "sce-brand-loader", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "logoSrc": { "alias": "logoSrc"; "required": false; "isSignal": true; }; "hintText": { "alias": "hintText"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Spinning ring loading indicator drawn with a radial-gradient mask at a size preset, rendered inline or as a fullscreen overlay. */
 declare class SceRingLoaderComponent {
     private readonly translate;
     size: _angular_core.InputSignal<LoaderSize>;
@@ -2193,6 +2307,7 @@ declare class SceRingLoaderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceRingLoaderComponent, "sce-ring-loader", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "hintText": { "alias": "hintText"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Loading indicator that renders two meshed, counter-rotating SVG gears whose paths are generated at module load, sized by preset and shown inline or as a fullscreen overlay. */
 declare class SceGearsLoaderComponent {
     private readonly translate;
     size: _angular_core.InputSignal<LoaderSize>;
@@ -2212,8 +2327,11 @@ declare class SceGearsLoaderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceGearsLoaderComponent, "sce-gears-loader", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "hintText": { "alias": "hintText"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Shape preset of `SceSkeleton`, each carrying its own default height and radius. */
 type SkeletonVariant = 'text' | 'circular' | 'rectangular' | 'rounded' | 'avatar' | 'button' | 'chip' | 'card' | 'image' | 'header' | 'paragraph' | 'divider' | 'badge' | 'input';
+/** Shimmer animation of `SceSkeleton`; defaults to `wave`. */
 type SkeletonAnimation = 'pulse' | 'wave' | 'none';
+/** Loading placeholder in one of several shape variants, optionally repeated `count` times with a shortened last line. */
 declare class SceSkeleton {
     /** Shape variant of the skeleton */
     readonly variant: _angular_core.InputSignal<SkeletonVariant>;
@@ -2253,6 +2371,7 @@ declare class SceSkeleton {
  * to let the icon size itself via CSS (useful inside flex/grid containers).
  */
 type IconSize = number | 'auto' | null;
+/** Inline SVG icon that fetches the named asset over HTTP, sanitizes it and caches it in a module-level cache shared by all instances. */
 declare class SceIcon {
     private readonly http;
     private readonly sanitizer;
@@ -2276,8 +2395,11 @@ declare class SceIcon {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceIcon, "sce-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Visual style of `SceButton`, driving the `btn--*` modifier class. */
 type SceButtonVariant = 'primary' | 'black' | 'neutral' | 'secondary' | 'transparent' | 'outline' | 'danger' | 'text' | 'link';
+/** Size preset of `SceButton`; `small-icon-only` is the square icon-button form. */
 type SceButtonSize = 'compact' | 'mini' | 'extra-small' | 'small-icon-only' | 'small' | 'medium' | 'large';
+/** Design-system button that renders an `<a>` when `routerLink` or `href` is set and a `<button>` otherwise; note `fullWidth` defaults to true. */
 declare class SceButton {
     readonly variant: _angular_core.InputSignal<SceButtonVariant>;
     readonly type: _angular_core.InputSignal<"button" | "submit" | "reset">;
@@ -2305,6 +2427,7 @@ declare class SceButton {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceButton, "sce-button", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconPosition": { "alias": "iconPosition"; "required": false; "isSignal": true; }; "iconSize": { "alias": "iconSize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Labelled checkbox implementing `ControlValueAccessor`, so it works with `formControl`/`ngModel` as well as the `changed` output. */
 declare class SceCheckbox implements ControlValueAccessor {
     readonly label: _angular_core.InputSignal<string>;
     readonly inputId: _angular_core.InputSignal<string | undefined>;
@@ -2335,7 +2458,9 @@ declare class SceSpinner {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceSpinner, "sce-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Side the tooltip pops out on; physical (not logical) because it maps straight onto PrimeNG's `tooltipPosition`. */
 type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+/** Wraps projected content in a PrimeNG tooltip with the required `text` and a configurable position and z-index. */
 declare class SceTooltip {
     readonly text: _angular_core.InputSignal<string>;
     readonly position: _angular_core.InputSignal<TooltipPosition>;
@@ -2346,6 +2471,7 @@ declare class SceTooltip {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceTooltip, "sce-tooltip", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "zIndex": { "alias": "zIndex"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Linear progress bar whose fill direction follows the app locale, with an optional label and a leading thumb that is on by default. */
 declare class SceProgressBar {
     private readonly languageService;
     /** Matches app language: Arabic -> rtl (fill from the right), English -> ltr (fill from the left). */
@@ -2364,6 +2490,7 @@ declare class SceProgressBar {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceProgressBar, "sce-progress-bar", never, { "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "showThumb": { "alias": "showThumb"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** SVG ring showing step progress (current of total) with an optional custom label, falling back to the COMMON.STEP_OF translation. */
 declare class SceCircularProgress {
     /** Current step (1-based). */
     readonly current: _angular_core.InputSignal<number>;
@@ -2398,6 +2525,7 @@ declare class SceCircularProgress {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceCircularProgress, "sce-circular-progress", never, { "current": { "alias": "current"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "progressColor": { "alias": "progressColor"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Form field label with optional sub-text and a required-marker; `text` is a required input. */
 declare class SceFormLabel {
     readonly text: _angular_core.InputSignal<string>;
     readonly subText: _angular_core.InputSignal<string | undefined>;
@@ -2406,6 +2534,7 @@ declare class SceFormLabel {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFormLabel, "sce-form-label", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "subText": { "alias": "subText"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Inline form validation message rendered from a translation key; both `show` and `messageKey` are required inputs. */
 declare class SceFormError {
     readonly show: _angular_core.InputSignal<boolean>;
     readonly messageKey: _angular_core.InputSignal<string>;
@@ -2461,6 +2590,7 @@ declare class SceBidiIsolate {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceBidiIsolate, "sce-bidi-isolate", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "tabular": { "alias": "tabular"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Floating button that appears once the window is scrolled past 280px and scrolls back to the top, using an instant jump when `prefers-reduced-motion` is set. */
 declare class SceScrollToTopButtonComponent implements OnInit {
     private readonly translate;
     readonly ariaLabelOverride: _angular_core.InputSignal<string>;
@@ -2475,10 +2605,12 @@ declare class SceScrollToTopButtonComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceScrollToTopButtonComponent, "sce-scroll-to-top-button", never, { "ariaLabelOverride": { "alias": "ariaLabelOverride"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One image in the lightbox: its `src` and optional alt text. */
 interface ImageGallerySwapperItem {
     src: string;
     alt?: string;
 }
+/** Full-screen image lightbox with prev/next navigation, arrow-key and Escape handling and body-scroll locking; supplying `activeIndex` switches it from self-managed to parent-controlled paging. */
 declare class SceImageGallerySwapperComponent implements OnDestroy {
     open: _angular_core.InputSignal<boolean>;
     images: _angular_core.InputSignal<ImageGallerySwapperItem[]>;
@@ -2514,6 +2646,7 @@ declare class SceImageGallerySwapperComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceImageGallerySwapperComponent, "sce-image-gallery-swapper", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "images": { "alias": "images"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "initialIndex": { "alias": "initialIndex"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; }, { "close": "close"; "activeIndexChange": "activeIndexChange"; }, never, never, true, never>;
 }
 
+/** Thumbnail grid of an office project's images that opens `sce-image-gallery-swapper` at the clicked index; `imageUrls` and `title` are required. */
 declare class SceOfficeProjectGalleryComponent {
     readonly imageUrls: _angular_core.InputSignal<string[]>;
     readonly title: _angular_core.InputSignal<string>;
@@ -2542,6 +2675,7 @@ type AsyncPageGateSkeletonVariant = 'info-fields' | 'form-fields' | 'table' | 'n
  * signal it can wire up, rather than a dead retry button.
  */
 type AsyncPageGateRecovery = 'default' | 'handled';
+/** Wraps a page in its loading/error/ready states, showing a skeleton variant while loading and a `sce-result-state` on failure; with the default `recovery` it emits `reloadRequested` and calls `Location.back()` itself. */
 declare class SceAsyncPageGateComponent {
     private readonly translate;
     private readonly location;
@@ -2604,11 +2738,13 @@ declare class SceOfflineBannerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfflineBannerComponent, "sce-offline-banner", never, { "forceVisible": { "alias": "forceVisible"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One choice in `sce-radio-button`, with an optional `description` rendered under the label. */
 interface SceRadioOption {
     label: string;
     description?: string;
     value: string | number;
 }
+/** Radio group rendering a required list of options with optional descriptions, where a parent can veto a selection through the `onBeforeChange` guard input. */
 declare class SceRadioButtonComponent {
     options: _angular_core.InputSignal<SceRadioOption[]>;
     value: _angular_core.InputSignal<string | number | null>;
@@ -2624,12 +2760,14 @@ declare class SceRadioButtonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceRadioButtonComponent, "sce-radio-button", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "onBeforeChange": { "alias": "onBeforeChange"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/** Dashboard shell that projects a sidebar, header, and main content into a grid; `sidebarCollapsed` narrows the sidebar column, and it uses `ViewEncapsulation.None`. */
 declare class SceDashboardLayoutComponent {
     readonly sidebarCollapsed: _angular_core.InputSignal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceDashboardLayoutComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDashboardLayoutComponent, "sce-dashboard-layout", never, { "sidebarCollapsed": { "alias": "sidebarCollapsed"; "required": false; "isSignal": true; }; }, {}, never, ["[sidebar]", "[header]", "*"], true, never>;
 }
 
+/** Page shell for a form: `title`/`subtitle` header, a projected form body, and an action footer; it owns the `<form>` element and re-emits its submit as `submitted`, and uses `ViewEncapsulation.None`. */
 declare class SceFormPageLayoutComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly subtitle: _angular_core.InputSignal<string | undefined>;
@@ -2638,6 +2776,7 @@ declare class SceFormPageLayoutComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFormPageLayoutComponent, "sce-form-page-layout", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; }, { "submitted": "submitted"; }, never, ["*", "[actions]"], true, never>;
 }
 
+/** Page shell for a list/table screen: `title` header plus projected filter, toolbar, and content slots; `showFilters` defaults to true, and it uses `ViewEncapsulation.None`. */
 declare class SceListPageLayoutComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly showFilters: _angular_core.InputSignal<boolean>;
@@ -2664,6 +2803,7 @@ interface AccountSwitcherOption {
     crNumber?: string;
     licenseNumber?: string;
 }
+/** Header trigger plus popover listing the user's accounts, emitting select/enter-dashboard/logout; requires `selectedAccountId`. */
 declare class SceAccountSwitcherComponent {
     private readonly language;
     private readonly elRef;
@@ -2788,6 +2928,7 @@ declare class SceLogoutModalComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLogoutModalComponent, "sce-logout-modal", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, { "cancel": "cancel"; "confirm": "confirm"; }, never, never, true, never>;
 }
 
+/** One stop on a guided tour: a CSS selector for the element to spotlight plus the i18n keys for its popover title and body. */
 interface GuidedTourStep {
     target: string;
     titleKey: string;
@@ -2803,6 +2944,7 @@ interface PopoverRect {
     top: number;
     left: number;
 }
+/** Guided product tour overlay that scrolls to and spotlights each step's target selector and positions a popover beside it, emitting `complete` on the last step and `skip` on Escape. */
 declare class SceGuidedTourComponent implements OnDestroy {
     private readonly platformId;
     locale: _angular_core.InputSignal<"ar" | "en">;
@@ -2831,6 +2973,7 @@ declare class SceGuidedTourComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceGuidedTourComponent, "sce-guided-tour", never, { "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "tourId": { "alias": "tourId"; "required": false; "isSignal": true; }; "steps": { "alias": "steps"; "required": true; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; }, { "complete": "complete"; "skip": "skip"; }, never, never, true, never>;
 }
 
+/** Dialog that lets the user crop, zoom and rotate a profile photo and emits the result as a JPEG `File`; binding the `applying` input keeps the dialog open for an async upload instead of auto-closing on apply. */
 declare class SceProfilePhotoEditDialogComponent {
     private readonly translate;
     readonly visible: _angular_core.InputSignal<boolean>;
@@ -2892,12 +3035,14 @@ declare class SceContractQrCodeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceContractQrCodeComponent, "sce-contract-qr-code", never, { "contractNumber": { "alias": "contractNumber"; "required": false; "isSignal": true; }; "documentContractId": { "alias": "documentContractId"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** A picked map location: its latitude, longitude, and the reverse-geocoded address string. */
 interface GeoLocationValue {
     lat: number;
     lng: number;
     address: string;
 }
 
+/** Geo-location field that displays the currently selected coordinates and address and opens `sce-location-picker-dialog` to choose a new one. */
 declare class SceGeoLocationFieldComponent {
     readonly label: _angular_core.InputSignal<string>;
     readonly value: _angular_core.InputSignal<GeoLocationValue | null>;
@@ -2915,6 +3060,7 @@ declare class SceGeoLocationFieldComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceGeoLocationFieldComponent, "sce-geo-location-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/** Modal Leaflet map dialog for picking a coordinate, bounded to Saudi Arabia, which validates each click or marker drag, reverse-geocodes the position to an address via Nominatim, and reverts to the last valid point when validation fails. */
 declare class SceLocationPickerDialogComponent implements OnDestroy {
     readonly visible: _angular_core.InputSignal<boolean>;
     readonly locale: _angular_core.InputSignal<"ar" | "en">;
@@ -2951,18 +3097,21 @@ declare class SceLocationPickerDialogComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLocationPickerDialogComponent, "sce-location-picker-dialog", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "initialLat": { "alias": "initialLat"; "required": false; "isSignal": true; }; "initialLng": { "alias": "initialLng"; "required": false; "isSignal": true; }; }, { "dialogClose": "dialogClose"; "confirm": "confirm"; }, never, never, true, never>;
 }
 
+/** Dashboard page heading rendering a single translated `<h1>` from `titleKey`; the whole header is omitted when `titleKey` is empty. */
 declare class DashboardPageHeaderComponent {
     readonly titleKey: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DashboardPageHeaderComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DashboardPageHeaderComponent, "sce-dashboard-page-header", never, { "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** A pin on `sce-osm-leaflet-map`, optionally draggable and carrying raw `popupHtml` for its popup bubble. */
 interface OsmMapMarker {
     lat: number;
     lng: number;
     popupHtml?: string;
     draggable?: boolean;
 }
+/** OpenStreetMap Leaflet map that lazily loads Leaflet, renders the given markers and emits map clicks and marker drag-ends; setting `interactive` to false disables panning, zooming, the zoom control and click events. */
 declare class SceOsmLeafletMapComponent implements OnDestroy {
     readonly latitude: _angular_core.InputSignal<number>;
     readonly longitude: _angular_core.InputSignal<number>;
@@ -2990,6 +3139,7 @@ declare class SceOsmLeafletMapComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOsmLeafletMapComponent, "sce-osm-leaflet-map", never, { "latitude": { "alias": "latitude"; "required": false; "isSignal": true; }; "longitude": { "alias": "longitude"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "markers": { "alias": "markers"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; }, { "mapClick": "mapClick"; "markerDragEnd": "markerDragEnd"; }, never, never, true, never>;
 }
 
+/** Read-only map of an office's location: a Leaflet map with a marker when valid coordinates are given, a Google Maps embed built from the address when they are not, and a "not specified" fallback when neither is available. */
 declare class SceOfficeLocationMapComponent implements AfterViewInit, OnDestroy {
     private readonly sanitizer;
     readonly latitude: _angular_core.InputSignal<number | null | undefined>;
@@ -3007,11 +3157,13 @@ declare class SceOfficeLocationMapComponent implements AfterViewInit, OnDestroy
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeLocationMapComponent, "sce-office-location-map", never, { "latitude": { "alias": "latitude"; "required": false; "isSignal": true; }; "longitude": { "alias": "longitude"; "required": false; "isSignal": true; }; "address": { "alias": "address"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** A position chosen in `sce-osm-location-picker`: coordinates plus the reverse-geocoded address when Nominatim returned one. */
 interface LocationPickerValue {
     lat: number;
     lng: number;
     address?: string;
 }
+/** Location picker pairing an OSM Leaflet map with a Nominatim search box, which validates every clicked, dragged or searched position before placing a draggable pin and emitting it with its reverse-geocoded address. */
 declare class SceOsmLocationPickerComponent {
     readonly initialLat: _angular_core.InputSignal<number>;
     readonly initialLng: _angular_core.InputSignal<number>;
@@ -3044,11 +3196,13 @@ declare class SceOsmLocationPickerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOsmLocationPickerComponent, "sce-osm-location-picker", never, { "initialLat": { "alias": "initialLat"; "required": false; "isSignal": true; }; "initialLng": { "alias": "initialLng"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, { "locationSelect": "locationSelect"; }, never, never, true, never>;
 }
 
+/** A position picked on the Google map: coordinates plus the geocoded address when one was resolved. */
 interface GoogleMapsLocationValue {
     lat: number;
     lng: number;
     address?: string;
 }
+/** Google Maps location picker that lazily injects the Maps JS API, drops a marker where the user clicks and emits the coordinate; it stays blank unless an `apiKey` is supplied. */
 declare class SceGoogleMapsLocationPickerComponent implements OnDestroy {
     readonly apiKey: _angular_core.InputSignal<string>;
     readonly initialLat: _angular_core.InputSignal<number>;
@@ -3119,6 +3273,7 @@ interface ChartTooltipData {
     color?: string;
 }
 
+/** Standalone chart legend rendering colour markers and labels in a row or column — used instead of the built-in ECharts legend. */
 declare class SceChartLegendComponent {
     /** List of legend items to display */
     readonly items: _angular_core.InputSignal<ChartLegendItem[]>;
@@ -3138,17 +3293,20 @@ declare class SceChartLegendComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceChartLegendComponent, "sce-chart-legend", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "iconSize": { "alias": "iconSize"; "required": false; "isSignal": true; }; "fontSize": { "alias": "fontSize"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "itemGap": { "alias": "itemGap"; "required": false; "isSignal": true; }; "justifyContent": { "alias": "justifyContent"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One bar series: values aligned to the chart's categories, an optional colour, and a `stack` key that groups it with other series into a stacked bar. */
 interface BarSeriesData {
     name: string;
     data: number[];
     color?: string;
     stack?: string;
 }
+/** A smoothed, area-filled line series drawn on top of the bars, sharing the bar chart's category axis. */
 interface OverlayLineSeries {
     name: string;
     data: number[];
     color?: string;
 }
+/** ECharts bar chart with optional stacking, overlay line series and a custom legend; axis side auto-detects RTL unless `isRtl` overrides it. */
 declare class SceBarChartComponent {
     private readonly el;
     /** Manual direction override; null auto-detects from computed style (RTL-first default). */
@@ -3180,6 +3338,7 @@ declare class SceBarChartComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceBarChartComponent, "sce-bar-chart", never, { "isRtl": { "alias": "isRtl"; "required": false; "isSignal": true; }; "series": { "alias": "series"; "required": false; "isSignal": true; }; "overlayLineSeries": { "alias": "overlayLineSeries"; "required": false; "isSignal": true; }; "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "barWidth": { "alias": "barWidth"; "required": false; "isSignal": true; }; "borderRadius": { "alias": "borderRadius"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One horizontal bar; `maxValue` overrides the chart-wide maximum for this bar only, and `color` overrides the chart's default colour. */
 interface HorizontalBarItem {
     label: string;
     value: number;
@@ -3191,6 +3350,7 @@ interface ComputedBarItem extends HorizontalBarItem {
     barColor: string;
     segmentFills: number[];
 }
+/** Pure-CSS horizontal bar chart (no ECharts) where each bar is split into `segments` that fill proportionally to its value. */
 declare class SceHorizontalBarChartComponent {
     /** Data items for horizontal bars */
     readonly data: _angular_core.InputSignal<HorizontalBarItem[]>;
@@ -3213,6 +3373,7 @@ declare class SceHorizontalBarChartComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceHorizontalBarChartComponent, "sce-horizontal-bar-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "defaultColor": { "alias": "defaultColor"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "barHeight": { "alias": "barHeight"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "segments": { "alias": "segments"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** ECharts multi-series line chart with optional area fill and a highlight bar/marker at `highlightIndex`; axis side auto-detects RTL unless `isRtl` overrides it. */
 declare class SceLineChartComponent {
     private readonly el;
     /** Manual direction override; null auto-detects from computed style (RTL-first default). */
@@ -3246,6 +3407,7 @@ declare class SceLineChartComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLineChartComponent, "sce-line-chart", never, { "isRtl": { "alias": "isRtl"; "required": false; "isSignal": true; }; "series": { "alias": "series"; "required": false; "isSignal": true; }; "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "showArea": { "alias": "showArea"; "required": false; "isSignal": true; }; "smooth": { "alias": "smooth"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "showXAxisLabels": { "alias": "showXAxisLabels"; "required": false; "isSignal": true; }; "highlightIndex": { "alias": "highlightIndex"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** ECharts gradient area chart with hidden axes and an optional highlighted point marker at `highlightIndex`. */
 declare class SceAreaChartComponent {
     /** Data points for the chart */
     readonly data: _angular_core.InputSignal<number[]>;
@@ -3270,6 +3432,7 @@ declare class SceAreaChartComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAreaChartComponent, "sce-area-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "startColor": { "alias": "startColor"; "required": false; "isSignal": true; }; "endColor": { "alias": "endColor"; "required": false; "isSignal": true; }; "smooth": { "alias": "smooth"; "required": false; "isSignal": true; }; "tooltipLabel": { "alias": "tooltipLabel"; "required": false; "isSignal": true; }; "highlightIndex": { "alias": "highlightIndex"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** ECharts pie chart with optional in-slice percentage labels, an optional centre hole and a custom legend. */
 declare class ScePieChartComponent {
     /** Data items for the pie segments */
     readonly data: _angular_core.InputSignal<ChartSeriesItem[]>;
@@ -3297,6 +3460,7 @@ declare class ScePieChartComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScePieChartComponent, "sce-pie-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; "showLabels": { "alias": "showLabels"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "startAngle": { "alias": "startAngle"; "required": false; "isSignal": true; }; "showCenterHole": { "alias": "showCenterHole"; "required": false; "isSignal": true; }; "innerRadius": { "alias": "innerRadius"; "required": false; "isSignal": true; }; "itemRadius": { "alias": "itemRadius"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Concentric ring ("donut") chart where each data item gets its own gauge ring sized against `maxRingValue`, with optional centred value and label. */
 declare class SceDonutChartComponent {
     /** Data items for the donut rings */
     readonly data: _angular_core.InputSignal<ChartSeriesItem[]>;
@@ -3335,6 +3499,7 @@ interface RingChartLegendItem {
     color: string;
     value: string | number;
 }
+/** ECharts donut ring with a centred label/value and a legend that also shows each item's value; the tooltip unit is hard-coded to Arabic "طلبات". */
 declare class SceRingChartComponent {
     /** Data items for the ring segments */
     readonly data: _angular_core.InputSignal<ChartSeriesItem[]>;
@@ -3358,6 +3523,7 @@ declare class SceRingChartComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceRingChartComponent, "sce-ring-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "centerLabel": { "alias": "centerLabel"; "required": false; "isSignal": true; }; "centerValue": { "alias": "centerValue"; "required": false; "isSignal": true; }; "innerRadius": { "alias": "innerRadius"; "required": false; "isSignal": true; }; "outerRadius": { "alias": "outerRadius"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "startAngle": { "alias": "startAngle"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Semicircular tick-mark gauge for a 0-100 value; when `isRtl` is set the chart's own text is hidden so the caller can overlay it unmirrored. */
 declare class SceGaugeChartComponent {
     /** Current value (0-100) */
     readonly value: _angular_core.InputSignal<number>;
@@ -3387,12 +3553,14 @@ declare class SceGaugeChartComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceGaugeChartComponent, "sce-gauge-chart", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "startAngle": { "alias": "startAngle"; "required": false; "isSignal": true; }; "endAngle": { "alias": "endAngle"; "required": false; "isSignal": true; }; "isRtl": { "alias": "isRtl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One segmented bar; unlike `HorizontalBarItem`, its `maxValue` is required and always scopes the fill to this bar alone. */
 interface MultiSegmentBarItem {
     label: string;
     value: number;
     maxValue: number;
     color?: string;
 }
+/** Pure-CSS horizontal bars (no ECharts), each split into `segmentCount` sub-segments that fill against the item's own `maxValue`. */
 declare class SceMultiSegmentBarChartComponent {
     private readonly el;
     /** Data items for the bar chart */
@@ -3427,6 +3595,7 @@ declare class SceMultiSegmentBarChartComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceMultiSegmentBarChartComponent, "sce-multi-segment-bar-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "barHeight": { "alias": "barHeight"; "required": false; "isSignal": true; }; "segmentCount": { "alias": "segmentCount"; "required": false; "isSignal": true; }; "segmentGap": { "alias": "segmentGap"; "required": false; "isSignal": true; }; "rowGap": { "alias": "rowGap"; "required": false; "isSignal": true; }; "defaultColor": { "alias": "defaultColor"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "isRtl": { "alias": "isRtl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Half-circle ECharts gauge whose arc is coloured by proportional segment stops, with an optional centred label and value. */
 declare class SceMultiSegmentGaugeComponent {
     /** Segments to display on the gauge arc */
     readonly segments: _angular_core.InputSignal<ChartSeriesItem[]>;
@@ -3446,6 +3615,7 @@ declare class SceMultiSegmentGaugeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceMultiSegmentGaugeComponent, "sce-multi-segment-gauge", never, { "segments": { "alias": "segments"; "required": false; "isSignal": true; }; "centerLabel": { "alias": "centerLabel"; "required": false; "isSignal": true; }; "centerValue": { "alias": "centerValue"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One slice of the stacked bar; `barValue` lets the drawn width differ from the `value` shown in the legend, and `segments` splits the slice into that many sub-segments. */
 interface StackedDistributionChartItem {
     label: string;
     value: number;
@@ -3461,6 +3631,7 @@ interface ComputedStackedDistributionChartItem extends StackedDistributionChartI
     percentage: number;
     subSegments: number[];
 }
+/** Single stacked bar showing each item's share of the total plus a legend row per item, with an auto-generated aria summary and RTL auto-detection. */
 declare class SceStackedDistributionChartComponent {
     private readonly el;
     /** Segments rendered in the distribution bar and legend rows */
@@ -3495,6 +3666,7 @@ interface StatGaugeRow {
     value: string | number;
     color: string;
 }
+/** Half-circle gauge of `value` out of `total`, rendered with a subtitle and a list of colour-coded stat rows below it. */
 declare class SceStatGaugeComponent {
     /** Current (numerator) value, e.g. 120 */
     readonly value: _angular_core.InputSignal<number>;
@@ -3518,6 +3690,7 @@ declare class SceStatGaugeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceStatGaugeComponent, "sce-stat-gauge", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "stats": { "alias": "stats"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "markerSize": { "alias": "markerSize"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** SVG progress ring (no ECharts) with a centred label and value, an optional gradient stroke and RTL auto-detection; `progress` may exceed 100. */
 declare class SceStatRingComponent {
     private readonly el;
     /** Center label shown above the value */
@@ -3569,11 +3742,13 @@ declare class SceStatRingComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceStatRingComponent, "sce-stat-ring", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "trackStrokeWidth": { "alias": "trackStrokeWidth"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "gradientStartColor": { "alias": "gradientStartColor"; "required": false; "isSignal": true; }; "gradientEndColor": { "alias": "gradientEndColor"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "startAngle": { "alias": "startAngle"; "required": false; "isSignal": true; }; "useGradient": { "alias": "useGradient"; "required": false; "isSignal": true; }; "isRtl": { "alias": "isRtl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Captions for the scale's low, mid and high segments; supply already-translated text, as the component does not translate them. */
 interface ScaleIndicatorLabels {
     low: string;
     mid: string;
     high: string;
 }
+/** Three-segment scale track showing either a single thumb or a highlighted range when both `start` and `end` are given; the segment labels default to hardcoded Arabic strings. */
 declare class SceScaleIndicatorComponent {
     /** Title displayed above the scale */
     readonly title: _angular_core.InputSignal<string>;
@@ -3614,6 +3789,7 @@ declare class SceScaleIndicatorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceScaleIndicatorComponent, "sce-scale-indicator", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "start": { "alias": "start"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "activeColor": { "alias": "activeColor"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "barHeight": { "alias": "barHeight"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Dashboard overview tile showing a stat value, translated label, icon on a coloured background and an optional trend sparkline. */
 declare class SceOverviewStatCardComponent {
     readonly value: _angular_core.InputSignal<string | number>;
     readonly labelKey: _angular_core.InputSignal<string>;
@@ -3624,6 +3800,7 @@ declare class SceOverviewStatCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOverviewStatCardComponent, "sce-overview-stat-card", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "labelKey": { "alias": "labelKey"; "required": true; "isSignal": true; }; "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "iconBg": { "alias": "iconBg"; "required": true; "isSignal": true; }; "trend": { "alias": "trend"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Small dashboard card linking to a service, showing its icon and a count with a role-aware translated suffix. */
 declare class SceServiceMiniCardComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly count: _angular_core.InputSignal<number>;
@@ -3635,6 +3812,7 @@ declare class SceServiceMiniCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceServiceMiniCardComponent, "sce-service-mini-card", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "count": { "alias": "count"; "required": true; "isSignal": true; }; "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "link": { "alias": "link"; "required": true; "isSignal": true; }; "countSuffix": { "alias": "countSuffix"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** View model of a featured-office card, carrying both the raw `reviewCount` (zero triggers the fallback) and its locale-formatted label. */
 interface FeaturedOffice {
     id: string;
     title: string;
@@ -3647,12 +3825,14 @@ interface FeaturedOffice {
     tabs: string[];
     href: string;
 }
+/** Dashboard card for a featured engineering office showing rating, review count, country and service tabs; a zero review count renders the "no reviews yet" fallback. */
 declare class SceFeaturedOfficeCardComponent {
     readonly office: _angular_core.InputSignal<FeaturedOffice>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceFeaturedOfficeCardComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFeaturedOfficeCardComponent, "sce-featured-office-card", never, { "office": { "alias": "office"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** View model of a contract-request card; `deadline` and `budget` are pre-formatted display strings and `tags` are raw status labels whose tone is resolved at render time. */
 interface ContractRequestCard {
     id: string;
     title: string;
@@ -3664,6 +3844,7 @@ interface ContractRequestCard {
     tags: string[];
     offersCount?: number;
 }
+/** Dashboard card summarising a contract request (office, location, deadline, budget) with tone-resolved tags, linking to its detail route. */
 declare class SceContractRequestCardComponent {
     readonly request: _angular_core.InputSignal<ContractRequestCard>;
     readonly tagTones: _angular_core.Signal<_moatamed_sce_ui_components.BusinessStatusTone[]>;
@@ -3671,6 +3852,7 @@ declare class SceContractRequestCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceContractRequestCardComponent, "sce-contract-request-card", never, { "request": { "alias": "request"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One row of the latest-contracts table; `status` is the display label and `statusVariant` the already-resolved `BusinessStatusTone`. */
 interface ContractRow {
     contractNumber: string;
     service: string;
@@ -3679,6 +3861,7 @@ interface ContractRow {
     status: string;
     statusVariant: BusinessStatusTone;
 }
+/** Dashboard table of the latest contracts with status tags, showing five skeleton rows while `loading`; the party column header label is caller-supplied. */
 declare class SceLatestContractsTableComponent {
     readonly contracts: _angular_core.InputSignal<ContractRow[]>;
     readonly partyColumnLabel: _angular_core.InputSignal<string>;
@@ -3688,6 +3871,7 @@ declare class SceLatestContractsTableComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLatestContractsTableComponent, "sce-latest-contracts-table", never, { "contracts": { "alias": "contracts"; "required": true; "isSignal": true; }; "partyColumnLabel": { "alias": "partyColumnLabel"; "required": true; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One user-type choice card; `titleKey` and `descriptionKey` are i18n keys, not literal text. */
 interface LoginUserTypeCard {
     type: string;
     titleKey: string;
@@ -3695,6 +3879,7 @@ interface LoginUserTypeCard {
     icon: string;
     iconVariant: 'primary' | 'muted';
 }
+/** Login flow step presenting the selectable user-type cards and emitting the picked type plus a continue action. */
 declare class SceLoginUserTypeStepComponent {
     readonly cards: _angular_core.InputSignal<LoginUserTypeCard[]>;
     readonly selectedType: _angular_core.InputSignal<string | null>;
@@ -3712,6 +3897,7 @@ declare class SceLoginUserTypeStepComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLoginUserTypeStepComponent, "sce-login-user-type-step", never, { "cards": { "alias": "cards"; "required": true; "isSignal": true; }; "selectedType": { "alias": "selectedType"; "required": false; "isSignal": true; }; }, { "selectType": "selectType"; "continue": "continue"; }, never, never, true, never>;
 }
 
+/** Login flow step capturing national ID and birth date (Hijri/Gregorian), fully controlled — every field value and error is an input. */
 declare class SceLoginCredentialsStepComponent {
     readonly titleKey: _angular_core.InputSignal<string>;
     readonly subtitleKey: _angular_core.InputSignal<string>;
@@ -3741,6 +3927,7 @@ declare class SceLoginCredentialsStepComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLoginCredentialsStepComponent, "sce-login-credentials-step", never, { "titleKey": { "alias": "titleKey"; "required": true; "isSignal": true; }; "subtitleKey": { "alias": "subtitleKey"; "required": true; "isSignal": true; }; "nationalId": { "alias": "nationalId"; "required": true; "isSignal": true; }; "nationalIdDatalistId": { "alias": "nationalIdDatalistId"; "required": false; "isSignal": true; }; "nationalIdError": { "alias": "nationalIdError"; "required": false; "isSignal": true; }; "nationalIdHistory": { "alias": "nationalIdHistory"; "required": false; "isSignal": true; }; "filteredNationalIdHistory": { "alias": "filteredNationalIdHistory"; "required": false; "isSignal": true; }; "birthDate": { "alias": "birthDate"; "required": true; "isSignal": true; }; "birthDateDatalistId": { "alias": "birthDateDatalistId"; "required": false; "isSignal": true; }; "birthDateError": { "alias": "birthDateError"; "required": false; "isSignal": true; }; "birthDateHistory": { "alias": "birthDateHistory"; "required": false; "isSignal": true; }; "birthDateCalendar": { "alias": "birthDateCalendar"; "required": true; "isSignal": true; }; "birthDateCalendarLocked": { "alias": "birthDateCalendarLocked"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": true; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; }, { "nationalIdChange": "nationalIdChange"; "nationalIdFocus": "nationalIdFocus"; "nationalIdBlur": "nationalIdBlur"; "birthDateChange": "birthDateChange"; "birthDateBlur": "birthDateBlur"; "birthDateCalendarChange": "birthDateCalendarChange"; "datePickerOpened": "datePickerOpened"; "datePickerClosed": "datePickerClosed"; "submitted": "submitted"; }, never, never, true, never>;
 }
 
+/** Login flow step with the OTP input, mask toggle and resend countdown; the timer label is supplied by the parent. */
 declare class SceLoginOtpStepComponent {
     readonly otpValue: _angular_core.InputSignal<string>;
     readonly showOtpVisible: _angular_core.InputSignal<boolean>;
@@ -3756,6 +3943,7 @@ declare class SceLoginOtpStepComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLoginOtpStepComponent, "sce-login-otp-step", never, { "otpValue": { "alias": "otpValue"; "required": true; "isSignal": true; }; "showOtpVisible": { "alias": "showOtpVisible"; "required": false; "isSignal": true; }; "otpError": { "alias": "otpError"; "required": false; "isSignal": true; }; "resendSeconds": { "alias": "resendSeconds"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; "resendTimerLabel": { "alias": "resendTimerLabel"; "required": true; "isSignal": true; }; }, { "otpValueChange": "otpValueChange"; "showOtpToggle": "showOtpToggle"; "resend": "resend"; "submitted": "submitted"; }, never, never, true, never>;
 }
 
+/** View model of one selectable login account: display `name`, `tag`, `description`, `role`, whether it is an individual or organization, and an optional avatar. */
 interface LoginAccountOptionView {
     id: string;
     name: string;
@@ -3765,6 +3953,7 @@ interface LoginAccountOptionView {
     kind: 'individual' | 'organization';
     avatarSrc?: string | null;
 }
+/** Login flow step that lists the accounts available to the authenticated user and emits the chosen account id. */
 declare class SceLoginAccountSelectStepComponent {
     readonly accounts: _angular_core.InputSignal<LoginAccountOptionView[]>;
     readonly selectedAccountId: _angular_core.InputSignal<string | null>;
@@ -3776,6 +3965,7 @@ declare class SceLoginAccountSelectStepComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLoginAccountSelectStepComponent, "sce-login-account-select-step", never, { "accounts": { "alias": "accounts"; "required": true; "isSignal": true; }; "selectedAccountId": { "alias": "selectedAccountId"; "required": false; "isSignal": true; }; "apiError": { "alias": "apiError"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; }, { "selectAccount": "selectAccount"; "submitted": "submitted"; }, never, never, true, never>;
 }
 
+/** Login flow step collecting the missing mobile and email of a profile, emitting each change and the final submit. */
 declare class SceLoginCompleteDataStepComponent {
     readonly mobile: _angular_core.InputSignal<string>;
     readonly email: _angular_core.InputSignal<string>;
@@ -3789,6 +3979,7 @@ declare class SceLoginCompleteDataStepComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLoginCompleteDataStepComponent, "sce-login-complete-data-step", never, { "mobile": { "alias": "mobile"; "required": true; "isSignal": true; }; "email": { "alias": "email"; "required": true; "isSignal": true; }; "mobileError": { "alias": "mobileError"; "required": false; "isSignal": true; }; "emailError": { "alias": "emailError"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; }, { "mobileChange": "mobileChange"; "emailChange": "emailChange"; "submitted": "submitted"; }, never, never, true, never>;
 }
 
+/** Login flow step showing a failure message with a retry action. */
 declare class SceLoginErrorStepComponent {
     readonly errorMessage: _angular_core.InputSignal<string | undefined>;
     readonly submitting: _angular_core.InputSignal<boolean>;
@@ -3797,10 +3988,12 @@ declare class SceLoginErrorStepComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceLoginErrorStepComponent, "sce-login-error-step", never, { "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; }, { "retry": "retry"; }, never, never, true, never>;
 }
 
+/** One crumb in the hero header's trail; omit `href` for the current, non-linked page. */
 interface LandingBreadcrumbItem {
     label: string;
     href?: string;
 }
+/** Landing-page hero header with a title, breadcrumb trail and optional background image, rendered either as decorative left-aligned artwork or as a full-bleed cover photo. */
 declare class SceLandingHeroHeaderComponent {
     readonly title: _angular_core.InputSignal<string | undefined>;
     readonly breadcrumbs: _angular_core.InputSignal<LandingBreadcrumbItem[]>;
@@ -3823,6 +4016,7 @@ declare class SceDashboardFeatureComingSoonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDashboardFeatureComingSoonComponent, "sce-dashboard-feature-coming-soon", never, { "titleKey": { "alias": "titleKey"; "required": true; "isSignal": true; }; "subtitleKey": { "alias": "subtitleKey"; "required": true; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Cell renderer selected for a `GridColumn` (text, status tag, progress bar, toggle, action button/menu, custom template…). */
 declare enum ColumnsEnum {
     TOGGLE = "toggle",
     TEXT = "text",
@@ -3841,6 +4035,7 @@ declare enum ColumnsEnum {
     PHONE = "phone"
 }
 
+/** Marks an `<ng-template sceCustomCol="columnDef">` inside `sce-grid-table` as the renderer for the column whose `columnDef` matches. */
 declare class SceCustomColsDirective {
     readonly sceCustomCol: _angular_core.InputSignal<string>;
     readonly templateRef: TemplateRef<any>;
@@ -3848,6 +4043,7 @@ declare class SceCustomColsDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SceCustomColsDirective, "ng-template[sceCustomCol]", never, { "sceCustomCol": { "alias": "sceCustomCol"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Marks an `<ng-template sceGridExpansion>` as the expanded-row body of `sce-grid-table`; the row is passed as `$implicit`. */
 declare class SceGridExpansionDirective {
     readonly templateRef: TemplateRef<any>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceGridExpansionDirective, never>;
@@ -3856,6 +4052,7 @@ declare class SceGridExpansionDirective {
 
 /** SceTag variant when using sce-tag for status display */
 type StatusVariant = 'success' | 'danger' | 'warning' | 'info' | 'neutral' | 'purple' | 'pending' | 'assigned' | 'review' | 'new' | 'closed';
+/** How one status value renders in a status column: its `label` plus either an `sce-tag` `variant` (preferred) or raw `color`/`bgColor`. */
 interface StatusConfig {
     label: string;
     color?: string;
@@ -3864,6 +4061,7 @@ interface StatusConfig {
     variant?: StatusVariant;
 }
 
+/** Loosely-typed row object for `SceGridTableComponent`; columns address fields by dotted path. */
 type GridRow = Record<string, unknown>;
 /** Emitted by SceGridTable when the user clicks a sortable column header. */
 interface GridSortEvent {
@@ -3877,13 +4075,16 @@ interface GridPageEvent {
     rows: number;
     first: number;
 }
+/** Data for a progress-bar cell: current `value` out of `max`, its `label` and an optional bar `color`. */
 interface ProgressConfig {
     value: number;
     max: number;
     label: string;
     color?: string;
 }
+/** Kind of row action in an action column: a route `link`, an inline `command`, or a popup `menu`. */
 type GridActionType = 'link' | 'command' | 'menu';
+/** A single row action button — `link` (route built from the row) or `command` (callback) — with optional icon, icon-only rendering and PrimeNG severity. */
 interface GridAction<T extends GridRow = GridRow> {
     type: Exclude<GridActionType, 'menu'>;
     label: string;
@@ -3893,6 +4094,7 @@ interface GridAction<T extends GridRow = GridRow> {
     link?: (row: T) => string;
     command?: (row: T) => void;
 }
+/** One entry of a row action menu: label, icon, per-row `command`, optional separator, and a `hidden(row)` predicate evaluated per row. */
 interface GridMenuItem<T extends GridRow = GridRow> {
     label?: string;
     icon?: string;
@@ -3902,6 +4104,7 @@ interface GridMenuItem<T extends GridRow = GridRow> {
     /** Return true to hide this item for the given row. */
     hidden?: (row: T) => boolean;
 }
+/** Row action that opens a popup menu of `items`, each of which may hide itself for a given row. */
 interface GridMenuAction<T extends GridRow = GridRow> {
     type: 'menu';
     label: string;
@@ -3911,7 +4114,9 @@ interface GridMenuAction<T extends GridRow = GridRow> {
     hidden?: (row: T) => boolean;
     items: GridMenuItem<T>[];
 }
+/** Any action a column can offer: a plain button (`GridAction`) or a menu (`GridMenuAction`), discriminated by `type`. */
 type GridColumnAction<T extends GridRow = GridRow> = GridAction<T> | GridMenuAction<T>;
+/** Definition of one grid column: `header`, sortability, the `field` path to read, its `ColumnsEnum` cell `type`, and the type-specific extras (`actions`, `statusMap`, `getProgress`, `columnDef` for a custom template…). */
 interface GridColumn<T extends GridRow = GridRow> {
     header: string;
     isSorted: boolean;
@@ -3929,6 +4134,7 @@ interface GridColumn<T extends GridRow = GridRow> {
     pipeArgs?: unknown;
     cssStyle?: string;
 }
+/** PrimeNG-backed data table driven by a `columns` config: renders typed cells, row actions/menus, selection, expandable rows and skeletons, and switches between empty, filtered, searched and error result states; supports both client-side and `lazy` server-side paging/sorting, emitting `pageChange`/`sortChange` rather than fetching itself. */
 declare class SceGridTableComponent<T extends GridRow = GridRow> {
     readonly showSelect: _angular_core.InputSignal<boolean>;
     readonly btnLabel: _angular_core.InputSignal<string>;
@@ -4101,11 +4307,14 @@ declare class SceGridTableComponent<T extends GridRow = GridRow> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceGridTableComponent<any>, "sce-grid-table", never, { "showSelect": { "alias": "showSelect"; "required": false; "isSignal": true; }; "btnLabel": { "alias": "btnLabel"; "required": false; "isSignal": true; }; "selectedItems": { "alias": "selectedItems"; "required": false; "isSignal": true; }; "searchPipeKey": { "alias": "searchPipeKey"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "showAddButton": { "alias": "showAddButton"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingDelay": { "alias": "loadingDelay"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "totalPages": { "alias": "totalPages"; "required": false; "isSignal": true; }; "pageNumber": { "alias": "pageNumber"; "required": false; "isSignal": true; }; "first": { "alias": "first"; "required": false; "isSignal": true; }; "tableMinWidth": { "alias": "tableMinWidth"; "required": false; "isSignal": true; }; "emptyStateIcon": { "alias": "emptyStateIcon"; "required": false; "isSignal": true; }; "emptyStateTitleKey": { "alias": "emptyStateTitleKey"; "required": false; "isSignal": true; }; "emptyStateSubtitleKey": { "alias": "emptyStateSubtitleKey"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorTitleKey": { "alias": "errorTitleKey"; "required": false; "isSignal": true; }; "errorSubtitleKey": { "alias": "errorSubtitleKey"; "required": false; "isSignal": true; }; "errorStatus": { "alias": "errorStatus"; "required": false; "isSignal": true; }; "filtered": { "alias": "filtered"; "required": false; "isSignal": true; }; "searching": { "alias": "searching"; "required": false; "isSignal": true; }; "sortField": { "alias": "sortField"; "required": false; "isSignal": true; }; "sortOrder": { "alias": "sortOrder"; "required": false; "isSignal": true; }; "rowRoute": { "alias": "rowRoute"; "required": false; "isSignal": true; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; "expandable": { "alias": "expandable"; "required": false; "isSignal": true; }; }, { "selectedItems": "selectedItemsChange"; "addActionEvent": "addActionEvent"; "searchQuery": "searchQuery"; "selectItems": "selectItems"; "sortChange": "sortChange"; "pageChange": "pageChange"; "errorRetry": "errorRetry"; "clearFilters": "clearFilters"; "clearSearch": "clearSearch"; "rowNavigate": "rowNavigate"; }, ["customColumnTemplates", "expansionTemplate"], never, true, never>;
 }
 
+/** Control rendered for a filter field; `divider` renders a separator rather than an input. */
 type FilterFieldType = 'text' | 'select' | 'multiselect' | 'date' | 'datetime' | 'date-range' | 'number' | 'search' | 'checkbox' | 'radio' | 'checkbox-search' | 'divider';
+/** A choice offered by a select, multiselect, checkbox or radio filter field. */
 interface FilterFieldOption {
     label: string;
     value: string;
 }
+/** Declarative definition of one filter field: its `key` in the value map, its `type` and options, its grid `width`/`colspan`, and a `defaultValue` that is a JSON-encoded string array for multi-value types. */
 interface FilterFieldConfig {
     /** Unique key -- maps directly to the signal model property */
     key: string;
@@ -4155,6 +4364,7 @@ interface FilterFieldConfig {
     /** Optional maximum date for date fields. */
     maxDate?: Date;
 }
+/** Whole-form filter config: the `fields`, the grid layout (`columns` for manual mode, omit for auto), the live-filter `debounceMs` (default 300) and which chrome (reset, submit, quick-filter bar, save, clear-all) to show. */
 interface FilterFormConfig {
     /** All field definitions */
     fields: FilterFieldConfig[];
@@ -4178,6 +4388,7 @@ interface FilterFormConfig {
 
 type FieldValue = string | string[];
 type FilterValues = Record<string, FieldValue>;
+/** One chip in the quick-filter bar summarising an active filter: its field `key`, `label`, the display `value` (or `values` for multi-select) and how many selections it represents. */
 interface QuickFilterTag$1 {
     key: string;
     label: string;
@@ -4185,6 +4396,7 @@ interface QuickFilterTag$1 {
     values?: string[];
     count: number;
 }
+/** Renders a filter bar from a declarative `config` (it is not a reactive form — values live in a plain `model` signal), emits `filterChange` debounced (default 300 ms), sanitises typed text against HTML/script injection, and can show a quick-filter chip bar with per-chip removal. */
 declare class SceFilterFormComponent implements OnDestroy {
     readonly config: _angular_core.InputSignal<FilterFormConfig>;
     readonly quickFilterTitle: _angular_core.InputSignal<string>;
@@ -4234,15 +4446,19 @@ declare class SceFilterFormComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFilterFormComponent, "sce-filter-form", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "quickFilterTitle": { "alias": "quickFilterTitle"; "required": false; "isSignal": true; }; "quickFilterCounter": { "alias": "quickFilterCounter"; "required": false; "isSignal": true; }; }, { "filterChange": "filterChange"; "filterSubmit": "filterSubmit"; "filterReset": "filterReset"; "saveFilterClick": "saveFilterClick"; }, never, never, true, never>;
 }
 
+/** Height/padding scale of a form field control. */
 type FieldSize = 'small' | 'medium' | 'large';
+/** Sanitisation applied to typed characters in a text field; `null` means no filtering. */
 type InputFilter = 'numeric' | 'phone' | 'noComma' | 'decimal' | null;
 /** Restricts input characters via core directives (arabicOnly, englishOnly, numbersOnly, phoneOnly, trimInput). */
 type RestrictInput = 'arabicOnly' | 'englishOnly' | 'numbersOnly' | 'phoneOnly' | 'trimInput' | null;
 
+/** A single `label`/`value` choice for `FormInput`'s select, multiselect, radio and checkbox types. */
 interface SelectOption {
     label: string;
     value: string;
 }
+/** All-in-one labelled field that switches its control on the `type` input (text, password, phone, number, select, multiselect, date/datetime, textarea, checkbox/radio); it is a self-registering `ControlValueAccessor` (`NgControl` is injected with `self`, so `formControlName` works) and maps validator errors to i18n keys, overridable per field via `errorMessages`. */
 declare class FormInput implements ControlValueAccessor {
     private static nextId;
     readonly phoneConfig: {
@@ -4568,6 +4784,7 @@ declare function buildFieldValidators(spec?: DynamicFieldValidators): ValidatorF
 /** Builds a typed, non-nullable `FormGroup` from a list of field configs. */
 declare function buildDynamicFormGroup(fields: DynamicFieldConfig[], initial: Record<string, unknown>, fb: NonNullableFormBuilder): FormGroup;
 
+/** Modal shell over PrimeNG `p-dialog` (portaled to `body`) with projected header/body/footer slots; `size` maps to a max-width and `dismissed` fires exactly once whether closed by button, backdrop or ESC — note it uses `ViewEncapsulation.None`, so its styles are global. */
 declare class Popup {
     readonly open: _angular_core.InputSignal<boolean>;
     readonly title: _angular_core.InputSignal<string>;
@@ -4609,6 +4826,7 @@ declare class Popup {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<Popup, "sce-popup", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "footerBorder": { "alias": "footerBorder"; "required": false; "isSignal": true; }; "footerStyle": { "alias": "footerStyle"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "showBackButton": { "alias": "showBackButton"; "required": false; "isSignal": true; }; "largeHeader": { "alias": "largeHeader"; "required": false; "isSignal": true; }; "showHeader": { "alias": "showHeader"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "bodyScrollable": { "alias": "bodyScrollable"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; "backClicked": "backClicked"; }, never, ["[subTitle]", "*", "[popupFooter]"], true, never>;
 }
 
+/** Abstract base for modal components: holds `isOpen`/`modalData` signals, exposes `openModal(data)`/`closeModal()`, and requires the subclass template to contain a `Popup` whose dismissal closes the modal and re-emits `dismissed`. */
 declare abstract class PopupModalBase<T = unknown> implements AfterViewInit {
     protected readonly destroyRef: DestroyRef;
     readonly modalData: _angular_core.WritableSignal<T | null>;
@@ -4655,6 +4873,7 @@ declare class TabsInkbarRtlDirective implements AfterViewInit {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TabsInkbarRtlDirective, "[sceTabsInkbarRtl]", never, {}, {}, never, never, true, never>;
 }
 
+/** One tab in `Tabs`: `id`, translatable `label`, and optional `icon`, `badge` and `disabled` flag. */
 interface TabItem$1 {
     id: string;
     label: string;
@@ -4662,6 +4881,7 @@ interface TabItem$1 {
     icon?: string;
     badge?: string | number;
 }
+/** Tab bar over PrimeNG `p-tabs` that renders `items` and emits `tabChange`, projecting the panel content itself; `activeId` seeds a `linkedSignal` (so the tab strip is uncontrolled after the first click) and a host directive fixes inkbar placement in RTL. */
 declare class Tabs {
     readonly items: _angular_core.InputSignal<TabItem$1[]>;
     readonly activeId: _angular_core.InputSignal<string>;
@@ -4681,6 +4901,7 @@ declare class Tabs {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<Tabs, "sce-tabs", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "activeId": { "alias": "activeId"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "justify": { "alias": "justify"; "required": false; "isSignal": true; }; "underlineStyle": { "alias": "underlineStyle"; "required": false; "isSignal": true; }; }, { "tabChange": "tabChange"; }, never, ["*"], true, [{ directive: typeof TabsInkbarRtlDirective; inputs: {}; outputs: {}; }]>;
 }
 
+/** One breadcrumb entry: either a literal `label` or a `translateKey` (+ `translateParams`) resolved at render time, plus optional `url`, `icon` and `command`. */
 interface BreadcrumbItem$1 {
     label?: string;
     url?: string;
@@ -4690,6 +4911,7 @@ interface BreadcrumbItem$1 {
     /** Passed to `TranslateService.instant` when `translateKey` is set */
     translateParams?: Record<string, string | number>;
 }
+/** Wraps PrimeNG `p-breadcrumb` over `items`, prepending a home entry unless `showHomeIcon` is false; re-translates labels on language change and sets its own `dir` from the `rtl` input (default: current lang is Arabic). */
 declare class Breadcrumb {
     private readonly destroyRef;
     readonly translateService: TranslateService;
@@ -4713,11 +4935,13 @@ declare class Breadcrumb {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<Breadcrumb, "sce-breadcrumb", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "home": { "alias": "home"; "required": false; "isSignal": true; }; "showHomeIcon": { "alias": "showHomeIcon"; "required": false; "isSignal": true; }; "rtl": { "alias": "rtl"; "required": false; "isSignal": true; }; "separatorItem": { "alias": "separatorItem"; "required": false; "isSignal": true; }; }, { "itemClicked": "itemClicked"; }, never, never, true, never>;
 }
 
+/** Input-free card shell: projects its content into a styled `.card` container (host class `sce-card`). */
 declare class Card {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Card, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<Card, "sce-card", never, {}, {}, never, ["*"], true, never>;
 }
 
+/** Row of `length` single-digit OTP boxes (default `VALIDATION_LENGTHS.OTP`) with auto-advance, backspace-back and paste-to-fill; a self-registering `ControlValueAccessor` whose value is the joined digit string. */
 declare class OtpInput implements ControlValueAccessor {
     readonly length: _angular_core.InputSignal<number>;
     readonly submitted: _angular_core.InputSignal<boolean>;
@@ -4746,12 +4970,14 @@ declare class OtpInput implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInput, "sce-otp-input", never, { "length": { "alias": "length"; "required": false; "isSignal": true; }; "submitted": { "alias": "submitted"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One step in `Stepper`: an `id`, optional `label`/`subLabel` (i18n keys) and a `state` of completed, active, upcoming or disabled. */
 interface StepItem {
     id: string;
     label?: string;
     subLabel?: string;
     state: 'completed' | 'active' | 'upcoming' | 'disabled';
 }
+/** Renders `steps` as a horizontal/vertical step indicator in a `steps`, `progress` or `pills` `variant`; every step click emits `stepChange`, so `linear` currently gates nothing and the host must decide whether to honour it. */
 declare class Stepper {
     readonly steps: _angular_core.InputSignal<StepItem[]>;
     readonly variant: _angular_core.InputSignal<"progress" | "steps" | "pills">;
@@ -4770,11 +4996,13 @@ declare class Stepper {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<Stepper, "sce-stepper", never, { "steps": { "alias": "steps"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "linear": { "alias": "linear"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "stepGap": { "alias": "stepGap"; "required": false; "isSignal": true; }; }, { "stepChange": "stepChange"; }, never, never, true, never>;
 }
 
+/** One breadcrumb crumb for `ScePageHeaderComponent`; supply `translationKey` for i18n or `label` for a literal, and `url` to make it a link. */
 interface BreadcrumbItem {
     label: string;
     url?: string;
     translationKey?: string;
 }
+/** Page title with an optional breadcrumb trail (`breadcrumbItems`, on by default); `breadcrumbFirst` moves the trail above the title and `actionLayout` switches to a split layout with a projected actions slot. */
 declare class ScePageHeaderComponent {
     readonly titleKey: _angular_core.InputSignal<string>;
     readonly title: _angular_core.InputSignal<string>;
@@ -4826,6 +5054,7 @@ declare class ScePageErrorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScePageErrorComponent, "sce-page-error", never, { "titleKey": { "alias": "titleKey"; "required": true; "isSignal": true; }; "subtitleKey": { "alias": "subtitleKey"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "retryLabelKey": { "alias": "retryLabelKey"; "required": false; "isSignal": true; }; }, { "retry": "retry"; }, never, never, true, never>;
 }
 
+/** Page layout for authentication screens: a logo, title and subtitle header (each settable as literal text or a translation key) above the projected form, with an optional decorative side panel and footer. */
 declare class SceAuthLayoutComponent {
     /** Logo image URL for the auth header */
     readonly logoSrc: _angular_core.InputSignal<string>;
@@ -4851,6 +5080,7 @@ declare class SceAuthLayoutComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAuthLayoutComponent, "sce-auth-layout", never, { "logoSrc": { "alias": "logoSrc"; "required": false; "isSignal": true; }; "logoAlt": { "alias": "logoAlt"; "required": false; "isSignal": true; }; "appTitle": { "alias": "appTitle"; "required": false; "isSignal": true; }; "appTitleKey": { "alias": "appTitleKey"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "subtitleKey": { "alias": "subtitleKey"; "required": false; "isSignal": true; }; "backgroundSrc": { "alias": "backgroundSrc"; "required": false; "isSignal": true; }; "showSidePanel": { "alias": "showSidePanel"; "required": false; "isSignal": true; }; "footerText": { "alias": "footerText"; "required": false; "isSignal": true; }; "footerTextKey": { "alias": "footerTextKey"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Colour variant of a status page's icon wrapper and accent stripe. */
 type StatusPageVariant = 'error' | 'warning' | 'info' | 'success' | 'neutral';
 /**
  * Full-page status component for error, maintenance, permission, and empty states.
@@ -4893,6 +5123,7 @@ declare class SceStatusPageComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceStatusPageComponent, "sce-status-page", never, { "iconVariant": { "alias": "iconVariant"; "required": false; "isSignal": true; }; "imageSrc": { "alias": "imageSrc"; "required": false; "isSignal": true; }; "imageAlt": { "alias": "imageAlt"; "required": false; "isSignal": true; }; "code": { "alias": "code"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": true; "isSignal": true; }; "subtitleKey": { "alias": "subtitleKey"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** One option in `SceSelectableListWithSearchComponent`; `label` and `subLabel` are both matched by the search box, and `metadata` carries caller-defined payload of type `T`. */
 interface SelectableListItem<T = unknown> {
     /** Unique value for the item */
     value: string;
@@ -4906,6 +5137,7 @@ interface SelectableListItem<T = unknown> {
     metadata?: T;
 }
 
+/** Searchable single- or multi-select list (`multiSelect` defaults to true) that filters `items` in-place and emits the full `selectedValues` array; rows can be overridden with a projected `ng-template`, and `loading` swaps in skeletons. */
 declare class SceSelectableListWithSearchComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly items: _angular_core.InputSignal<SelectableListItem<unknown>[]>;
@@ -4950,6 +5182,7 @@ interface QuickFilterTag {
     key?: string;
 }
 
+/** Bar of currently-applied filter tags (`activeFilters`) with an optional counter, "save filter" and "clear all" actions; it only emits clicks and never mutates the tag list itself. */
 declare class SceQuickFilterBarComponent {
     readonly activeFilters: _angular_core.InputSignal<QuickFilterTag[]>;
     readonly showSaveFilter: _angular_core.InputSignal<boolean>;
@@ -4966,6 +5199,7 @@ declare class SceQuickFilterBarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceQuickFilterBarComponent, "sce-quick-filter-bar", never, { "activeFilters": { "alias": "activeFilters"; "required": false; "isSignal": true; }; "showSaveFilter": { "alias": "showSaveFilter"; "required": false; "isSignal": true; }; "showClearAll": { "alias": "showClearAll"; "required": false; "isSignal": true; }; "quickFilterCounter": { "alias": "quickFilterCounter"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "tagGap": { "alias": "tagGap"; "required": false; "isSignal": true; }; "showRemoveButton": { "alias": "showRemoveButton"; "required": false; "isSignal": true; }; "rowJustify": { "alias": "rowJustify"; "required": false; "isSignal": true; }; }, { "saveFilterClick": "saveFilterClick"; "clearAllClick": "clearAllClick"; "filterTagClick": "filterTagClick"; }, never, never, true, never>;
 }
 
+/** The identity record a lookup returns for a verified user, shown read-only in the panel's second step. */
 interface VerifiedUserData {
     name: string;
     nationalId: string;
@@ -4973,16 +5207,19 @@ interface VerifiedUserData {
     email: string;
     mobile: string;
 }
+/** What the panel's first step emits: the national ID and birth date to look the user up with. */
 interface VerifyPayload {
     nationalId: string;
     birthDate: string;
 }
+/** What the panel's second step emits: the roles, contact details, and active flag to save for the verified user. */
 interface ConfirmPayload {
     roleIds: number[];
     email: string;
     mobile: string;
     isActive: boolean;
 }
+/** Two-step user-verification panel that first collects a national ID and birth date, then the verified user's roles, contact details and active flag, emitting `verify` and `confirm` payloads. */
 declare class SceUserVerifySectionPanelComponent {
     readonly step: _angular_core.InputSignal<1 | 2>;
     readonly loading: _angular_core.InputSignal<boolean>;
@@ -5040,7 +5277,9 @@ interface FileSourceBase64 {
     kind: 'base64';
     value: string;
 }
+/** Discriminated union (on `kind`) of the ways file content can be handed to the file viewer: URL, Blob/File, or Base64. */
 type FileSource = FileSourceUrl | FileSourceBlob | FileSourceBase64;
+/** Everything the file viewer needs about one file: its `source`, display/download `name`, MIME `type` or `extension` used to pick a renderer, optional `size`, and a `downloadable` flag that also blocks programmatic download. */
 interface FileViewerData {
     /** File content — a URL string, Blob/File, or Base64 string. */
     source: FileSource;
@@ -5055,6 +5294,7 @@ interface FileViewerData {
     /** When false, hides the download button and blocks programmatic download (e.g. confidential previews). */
     downloadable?: boolean;
 }
+/** Renderer the file viewer picks for a file; `Unsupported` shows a download-only fallback. */
 declare enum FileType {
     Image = "image",
     Pdf = "pdf",
@@ -5153,6 +5393,7 @@ declare class SceFileViewerDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SceFileViewerDirective, "[sceFileViewer]", never, { "sceFileViewer": { "alias": "sceFileViewer"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Hints `detectFileType` uses, in priority order: `mime` (or the MIME inside a data-URI `url`), then an extension taken from `extension`, `name` or `url`. */
 interface FileTypeInput {
     mime?: string;
     extension?: string;
@@ -5180,6 +5421,7 @@ interface VideoCaption {
     /** When true, this track is shown by default. */
     default?: boolean;
 }
+/** Value for the `<video preload>` attribute: fetch the whole file, metadata only, or nothing. */
 type VideoPreload = 'auto' | 'metadata' | 'none';
 
 /**
@@ -5247,12 +5489,14 @@ declare class SceTimelineComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceTimelineComponent, "sce-timeline", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
 }
 
+/** One row in `SceSearchableUsersListComponent`; only `name` is matched by the search box. */
 interface SearchableUserListItem {
     id: string | number;
     name: string;
     subtitle?: string;
 }
 
+/** User list with a client-side name search box; filtering happens internally and only `deleteUser` is emitted to the host. */
 declare class SceSearchableUsersListComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly users: _angular_core.InputSignal<SearchableUserListItem[]>;
@@ -5266,11 +5510,13 @@ declare class SceSearchableUsersListComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceSearchableUsersListComponent, "sce-searchable-users-list", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "users": { "alias": "users"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; }, { "deleteUser": "deleteUser"; }, never, never, true, never>;
 }
 
+/** One crumb in a detail-page header: a translated `label` plus an optional `route` (or legacy `url`); a crumb with neither is rendered as plain text. */
 interface DetailBreadcrumbItem {
     label: string;
     route?: string;
     url?: string;
 }
+/** A button in a detail-page header: its `label` and `icon`, plus the `action` key echoed back through `actionClick`. */
 interface DetailHeaderAction {
     label: string;
     icon: string;
@@ -5280,6 +5526,7 @@ interface DetailHeaderAction {
     iconPosition?: 'start' | 'end';
 }
 
+/** Page header for detail screens with a title, breadcrumb trail and a row of action buttons that emit `actionClick` carrying the action's key. */
 declare class SceDetailHeaderComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly breadcrumbs: _angular_core.InputSignal<DetailBreadcrumbItem[]>;
@@ -5299,10 +5546,12 @@ declare class SceDetailHeaderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDetailHeaderComponent, "sce-detail-header", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "breadcrumbs": { "alias": "breadcrumbs"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; }, { "actionClick": "actionClick"; }, never, never, true, never>;
 }
 
+/** Presentation-only status for a request header: the resolved `label` plus the tag colour to render it in. */
 interface RequestStatusPresentation {
     label: string;
     color: 'warning' | 'success' | 'danger' | 'neutral';
 }
+/** One icon-and-label metadata entry in a request header; set `isDate` to have the value formatted as a localized date. */
 interface RequestHeaderMetaItem {
     label: string;
     value: string;
@@ -5310,6 +5559,7 @@ interface RequestHeaderMetaItem {
     isDate?: boolean;
 }
 
+/** Header for a request page: `title`, a copyable `requestId`, a coloured `status` tag, and a row of `metaItems` (date items are run through `LocalizedDatePipe`). */
 declare class SceRequestHeaderComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly requestId: _angular_core.InputSignal<string>;
@@ -5321,6 +5571,7 @@ declare class SceRequestHeaderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceRequestHeaderComponent, "sce-request-header", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "requestId": { "alias": "requestId"; "required": true; "isSignal": true; }; "status": { "alias": "status"; "required": true; "isSignal": true; }; "metaItems": { "alias": "metaItems"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "dateLabelKey": { "alias": "dateLabelKey"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Card wrapper around `sce-request-header` that adds a body slot for request details; takes the same `title`, `requestId`, `status`, and `metaItems` inputs. */
 declare class SceRequestDetailsCardComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly requestId: _angular_core.InputSignal<string>;
@@ -5332,6 +5583,7 @@ declare class SceRequestDetailsCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceRequestDetailsCardComponent, "sce-request-details-card", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "requestId": { "alias": "requestId"; "required": true; "isSignal": true; }; "status": { "alias": "status"; "required": true; "isSignal": true; }; "metaItems": { "alias": "metaItems"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "dateLabelKey": { "alias": "dateLabelKey"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One attached file in an attachments list: `id`, display `name`, `url`, optional pdf/image `type`, thumbnail `previewUrl`, human-readable `sizeLabel`, and whether it may be deleted. */
 interface SceAttachmentListItem {
     id: string;
     name: string;
@@ -5342,6 +5594,7 @@ interface SceAttachmentListItem {
     deletable?: boolean;
 }
 
+/** List of file attachments with a per-row pdf/image icon inferred from the file extension and an empty state; in `download` mode it emits `downloadFile`, in `show` mode it opens the file in a new tab itself. */
 declare class SceAttachmentsListComponent {
     readonly attachments: _angular_core.InputSignal<readonly SceAttachmentListItem[]>;
     readonly titleKey: _angular_core.InputSignal<string>;
@@ -5359,6 +5612,7 @@ declare class SceAttachmentsListComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAttachmentsListComponent, "sce-attachments-list", never, { "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "showSectionTitle": { "alias": "showSectionTitle"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "downloadFile": "downloadFile"; "deleteFile": "deleteFile"; }, never, never, true, never>;
 }
 
+/** Profile banner showing an avatar (`avatarUrl`, falling back to a person icon), `name`, and `role`. */
 declare class SceProfileHeroComponent {
     readonly name: _angular_core.InputSignal<string>;
     readonly role: _angular_core.InputSignal<string>;
@@ -5367,6 +5621,7 @@ declare class SceProfileHeroComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceProfileHeroComponent, "sce-profile-hero", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "avatarUrl": { "alias": "avatarUrl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One entry in `SceResourcesListComponent`: a required `url` plus a literal `label` or i18n `labelKey` and an optional icon. */
 interface SceResourceListItem {
     label?: string;
     labelKey?: string;
@@ -5374,6 +5629,7 @@ interface SceResourceListItem {
     icon?: string;
 }
 
+/** Titled list of downloadable/linked resources from `items`; `titleKey` defaults to the knowledge-centre resources heading. */
 declare class SceResourcesListComponent {
     readonly items: _angular_core.InputSignal<SceResourceListItem[]>;
     readonly titleKey: _angular_core.InputSignal<string>;
@@ -5381,6 +5637,7 @@ declare class SceResourcesListComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceResourcesListComponent, "sce-resources-list", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** "Was this helpful?" yes/no prompt (all labels are overridable i18n keys) that emits `feedback` once and then locks itself into a thank-you state. */
 declare class SceFeedbackSectionComponent {
     readonly questionKey: _angular_core.InputSignal<string>;
     readonly yesKey: _angular_core.InputSignal<string>;
@@ -5396,6 +5653,7 @@ declare class SceFeedbackSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFeedbackSectionComponent, "sce-feedback-section", never, { "questionKey": { "alias": "questionKey"; "required": false; "isSignal": true; }; "yesKey": { "alias": "yesKey"; "required": false; "isSignal": true; }; "noKey": { "alias": "noKey"; "required": false; "isSignal": true; }; "thanksKey": { "alias": "thanksKey"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "feedback": "feedback"; }, never, never, true, never>;
 }
 
+/** One card in `SceRelatedCardsListComponent`; title/description may be given as a literal or an i18n `*Key`, and `route` makes the card a link. */
 interface SceRelatedCardItem {
     title?: string;
     titleKey?: string;
@@ -5405,6 +5663,7 @@ interface SceRelatedCardItem {
     route?: string | string[] | null;
 }
 
+/** Renders a titled grid of related-content cards from `items`, each optionally linking to its own `route`. */
 declare class SceRelatedCardsListComponent {
     readonly items: _angular_core.InputSignal<SceRelatedCardItem[]>;
     readonly titleKey: _angular_core.InputSignal<string>;
@@ -5428,11 +5687,14 @@ declare class SceRelatedCardsListComponent {
  * These are pure data shapes — no Angular or HTTP dependencies.
  */
 type OfficeTabKey = 'overview' | 'projects' | 'reviews';
+/** One tab of the office-detail page: its `key` and an already-translated `label`. */
 interface TabItem {
     key: OfficeTabKey;
     label: string;
 }
+/** Lifecycle state of an office project as shown to guests; `unknown` when the API sends no status. */
 type GuestProjectStatus = 'new' | 'inProgress' | 'completed' | 'unknown';
+/** A project shown on an office profile: hero and gallery images, copy, optional type label and status; `projectId` is null for records that carry no id. */
 interface OfficeProject {
     title: string;
     description: string;
@@ -5442,6 +5704,7 @@ interface OfficeProject {
     typeLabel?: string;
     status?: GuestProjectStatus;
 }
+/** A single customer review of an office: author, star `rating`, display `date`, body `text` and avatar URL. */
 interface OfficeReview {
     authorName: string;
     rating: number;
@@ -5449,17 +5712,20 @@ interface OfficeReview {
     text: string;
     photoUrl: string;
 }
+/** One bar of the ratings histogram: the `stars` bucket (1–5) and the `percent` of reviews in it. */
 interface RatingDistributionLine {
     stars: number;
     percent: number;
 }
 
+/** Loading placeholder for the office-detail page, rendering the hero header plus a skeleton body matching the currently active tab. */
 declare class SceOfficeDetailLoadingStateComponent {
     readonly activeTab: _angular_core.InputSignal<OfficeTabKey>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SceOfficeDetailLoadingStateComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeDetailLoadingStateComponent, "sce-office-detail-loading-state", never, { "activeTab": { "alias": "activeTab"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Not-found state for the office-detail page, rendering the hero header above a result state whose preset back action is suppressed in favour of the page's own links. */
 declare class SceOfficeDetailNotFoundComponent {
     readonly breadcrumbs: _angular_core.InputSignal<LandingBreadcrumbItem[]>;
     /** The page owns its own navigation links, so the preset's `back` button is suppressed. */
@@ -5468,6 +5734,7 @@ declare class SceOfficeDetailNotFoundComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeDetailNotFoundComponent, "sce-office-detail-not-found", never, { "breadcrumbs": { "alias": "breadcrumbs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Hero content of the public office-detail page: office name with verification badge, location, star-rating summary, reviewer avatars and an optional request-contract button. */
 declare class SceOfficeDetailHeroBodyComponent {
     readonly officeName: _angular_core.InputSignal<string>;
     readonly verificationStatus: _angular_core.InputSignal<OrganizationServiceProviderStatus | null>;
@@ -5482,6 +5749,7 @@ declare class SceOfficeDetailHeroBodyComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeDetailHeroBodyComponent, "sce-office-detail-hero-body", never, { "officeName": { "alias": "officeName"; "required": true; "isSignal": true; }; "verificationStatus": { "alias": "verificationStatus"; "required": false; "isSignal": true; }; "locationText": { "alias": "locationText"; "required": false; "isSignal": true; }; "filledStars": { "alias": "filledStars"; "required": false; "isSignal": true; }; "ratingValue": { "alias": "ratingValue"; "required": false; "isSignal": true; }; "ratingSummary": { "alias": "ratingSummary"; "required": false; "isSignal": true; }; "reviewerAvatars": { "alias": "reviewerAvatars"; "required": false; "isSignal": true; }; "canRequestContract": { "alias": "canRequestContract"; "required": false; "isSignal": true; }; }, { "requestContract": "requestContract"; }, never, never, true, never>;
 }
 
+/** Tab bar of the office-detail page, showing the office's brand logo and name beside the tab buttons and emitting `tabChange` on selection. */
 declare class SceOfficeDetailTabsBarComponent {
     readonly tabItems: _angular_core.InputSignal<TabItem[]>;
     readonly activeTab: _angular_core.InputSignal<OfficeTabKey>;
@@ -5492,6 +5760,7 @@ declare class SceOfficeDetailTabsBarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeDetailTabsBarComponent, "sce-office-detail-tabs-bar", never, { "tabItems": { "alias": "tabItems"; "required": true; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": true; "isSignal": true; }; "logoObjectUrl": { "alias": "logoObjectUrl"; "required": false; "isSignal": true; }; "officeName": { "alias": "officeName"; "required": false; "isSignal": true; }; }, { "tabChange": "tabChange"; }, never, never, true, never>;
 }
 
+/** Overview tab of the office-detail page, showing the office bio, an OSM map of its location and rows of experience and compatibility metric cards. */
 declare class SceOfficeDetailOverviewPanelComponent {
     readonly officeBio: _angular_core.InputSignal<string>;
     readonly locationText: _angular_core.InputSignal<string>;
@@ -5502,6 +5771,7 @@ declare class SceOfficeDetailOverviewPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeDetailOverviewPanelComponent, "sce-office-detail-overview-panel", never, { "officeBio": { "alias": "officeBio"; "required": false; "isSignal": true; }; "locationText": { "alias": "locationText"; "required": false; "isSignal": true; }; "mapPoints": { "alias": "mapPoints"; "required": false; "isSignal": true; }; "experienceMetricItems": { "alias": "experienceMetricItems"; "required": false; "isSignal": true; }; "compatibilityMetricItems": { "alias": "compatibilityMetricItems"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Projects tab of the office-detail page, rendering each of the office's projects alongside its image gallery. */
 declare class SceOfficeDetailProjectsPanelComponent {
     readonly projects: _angular_core.InputSignal<OfficeProject[]>;
     readonly projectGalleryImages: _angular_core.InputSignal<{
@@ -5513,6 +5783,7 @@ declare class SceOfficeDetailProjectsPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeDetailProjectsPanelComponent, "sce-office-detail-projects-panel", never, { "projects": { "alias": "projects"; "required": false; "isSignal": true; }; "projectGalleryImages": { "alias": "projectGalleryImages"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Reviews tab of the office-detail page, showing the overall rating, the per-star rating distribution and the individual reviews. */
 declare class SceOfficeDetailReviewsPanelComponent {
     readonly reviews: _angular_core.InputSignal<OfficeReview[]>;
     readonly totalReviews: _angular_core.InputSignal<number>;
@@ -5566,6 +5837,7 @@ declare class SceFormRichTextComponent implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceFormRichTextComponent, "sce-form-rich-text", never, { "labelTranslateKey": { "alias": "labelTranslateKey"; "required": false; "isSignal": true; }; "editorHeight": { "alias": "editorHeight"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Picks the `<key>Ar`/`<key>En` property of an object matching the active language (falling back to the other language, then to the bare `key`, then to ''); pure, so it does not re-run on a language switch unless the object reference changes. */
 declare class LocalizedValuePipe implements PipeTransform {
     private readonly translate;
     transform(obj: Record<string, unknown> | null | undefined, key: string, options?: {
@@ -5576,6 +5848,7 @@ declare class LocalizedValuePipe implements PipeTransform {
     static ɵpipe: _angular_core.ɵɵPipeDeclaration<LocalizedValuePipe, "localizedValue", true>;
 }
 
+/** Displays a phone number with an optional leading icon and a copy-to-clipboard button (shown by default). */
 declare class ScePhoneNumberComponent {
     readonly value: _angular_core.InputSignal<string>;
     readonly showCopy: _angular_core.InputSignal<boolean>;
@@ -5585,6 +5858,7 @@ declare class ScePhoneNumberComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScePhoneNumberComponent, "sce-phone-number", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "showCopy": { "alias": "showCopy"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "iconSize": { "alias": "iconSize"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Title-and-description row with a trailing edit button (shown by default, labelled from the translated "edit" key unless overridden). */
 declare class SceInfoRowComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly description: _angular_core.InputSignal<string>;
@@ -5598,6 +5872,7 @@ declare class SceInfoRowComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceInfoRowComponent, "sce-info-row", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": true; "isSignal": true; }; "editLabel": { "alias": "editLabel"; "required": false; "isSignal": true; }; "showEdit": { "alias": "showEdit"; "required": false; "isSignal": true; }; "ltr": { "alias": "ltr"; "required": false; "isSignal": true; }; }, { "editClick": "editClick"; }, never, never, true, never>;
 }
 
+/** Compact summary tile pairing an icon with a label, a primary value and an optional secondary value. */
 declare class SceSummaryCardComponent {
     readonly icon: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
@@ -5607,7 +5882,9 @@ declare class SceSummaryCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceSummaryCardComponent, "sce-summary-card", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "subValue": { "alias": "subValue"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Colour tone of the badge on `SceEntityInfoCardComponent`. */
 type EntityInfoCardBadgeTone = 'success' | 'info' | 'warning' | 'error' | 'neutral';
+/** Card identifying an entity by logo (or fallback icon), name, subtitle and ID, with a tone-coloured badge label that defaults to the success tone. */
 declare class SceEntityInfoCardComponent {
     readonly labelKey: _angular_core.InputSignal<string>;
     readonly nameKey: _angular_core.InputSignal<string>;
@@ -5624,6 +5901,7 @@ declare class SceEntityInfoCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceEntityInfoCardComponent, "sce-entity-info-card", never, { "labelKey": { "alias": "labelKey"; "required": true; "isSignal": true; }; "nameKey": { "alias": "nameKey"; "required": false; "isSignal": true; }; "nameText": { "alias": "nameText"; "required": false; "isSignal": true; }; "subtitleText": { "alias": "subtitleText"; "required": false; "isSignal": true; }; "idLabelKey": { "alias": "idLabelKey"; "required": false; "isSignal": true; }; "idValue": { "alias": "idValue"; "required": false; "isSignal": true; }; "logoSrc": { "alias": "logoSrc"; "required": false; "isSignal": true; }; "logoAlt": { "alias": "logoAlt"; "required": false; "isSignal": true; }; "iconName": { "alias": "iconName"; "required": false; "isSignal": true; }; "iconSize": { "alias": "iconSize"; "required": false; "isSignal": true; }; "badgeTone": { "alias": "badgeTone"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Card that either shows a completion progress bar or, in `cta` mode, an illustrated call-to-action button emitting `nextStep`. */
 declare class SceProgressCardComponent {
     readonly mode: _angular_core.InputSignal<"progress" | "cta">;
     readonly titleKey: _angular_core.InputSignal<string>;
@@ -5638,6 +5916,7 @@ declare class SceProgressCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceProgressCardComponent, "sce-progress-card", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "descriptionKey": { "alias": "descriptionKey"; "required": false; "isSignal": true; }; "titleText": { "alias": "titleText"; "required": false; "isSignal": true; }; "descriptionText": { "alias": "descriptionText"; "required": false; "isSignal": true; }; "buttonKey": { "alias": "buttonKey"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "illustrationSrc": { "alias": "illustrationSrc"; "required": false; "isSignal": true; }; }, { "nextStep": "nextStep"; }, never, ["[data-actions]"], true, never>;
 }
 
+/** Prose block that renders the translated `contentKey` as a paragraph, unless `contentHtml` is supplied, in which case that raw HTML is rendered instead. */
 declare class SceContentBlockComponent {
     readonly contentKey: _angular_core.InputSignal<string>;
     readonly contentHtml: _angular_core.InputSignal<string | null>;
@@ -5645,6 +5924,7 @@ declare class SceContentBlockComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceContentBlockComponent, "sce-content-block", never, { "contentKey": { "alias": "contentKey"; "required": true; "isSignal": true; }; "contentHtml": { "alias": "contentHtml"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Renders `items` (translation keys) as an icon-bulleted list, laid out across `maxColumns` columns (default 1). */
 declare class SceBulletListComponent {
     readonly items: _angular_core.InputSignal<string[]>;
     readonly maxColumns: _angular_core.InputSignal<number>;
@@ -5652,6 +5932,7 @@ declare class SceBulletListComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceBulletListComponent, "sce-bullet-list", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "maxColumns": { "alias": "maxColumns"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Dashboard KPI card showing a headline value, an up/down trend percentage and an optional sparkline chart. */
 declare class SceStatsAnalyticsCardComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly titleLinkText: _angular_core.InputSignal<string>;
@@ -5679,6 +5960,7 @@ interface OfficeEditProjectItem {
     previewUrls?: string[];
 }
 
+/** Result screen shown after office-profile changes are submitted, rendering either the success or the pending-review outcome with links to the profile and the requests list. */
 declare class SceOfficeProfileSubmitResultComponent {
     readonly result: _angular_core.InputSignal<"success" | "pending">;
     readonly viewProfile: _angular_core.OutputEmitterRef<void>;
@@ -5687,11 +5969,13 @@ declare class SceOfficeProfileSubmitResultComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileSubmitResultComponent, "sce-office-profile-submit-result", never, { "result": { "alias": "result"; "required": true; "isSignal": true; }; }, { "viewProfile": "viewProfile"; "viewRequests": "viewRequests"; }, never, never, true, never>;
 }
 
+/** Static banner telling the user their office-profile update is awaiting review, with a link to the requests page; it takes no inputs. */
 declare class ScePendingUpdateBannerComponent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ScePendingUpdateBannerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScePendingUpdateBannerComponent, "sce-pending-update-banner", never, {}, {}, never, never, true, never>;
 }
 
+/** Bio section of the office-profile edit form, binding the parent's `FormGroup` to the summary field, the services multi-select and the availability select. */
 declare class SceOfficeProfileEditBioSectionComponent {
     readonly form: _angular_core.InputSignal<FormGroup<any>>;
     readonly serviceOptions: _angular_core.InputSignal<SceSelectOption<string>[]>;
@@ -5701,6 +5985,7 @@ declare class SceOfficeProfileEditBioSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileEditBioSectionComponent, "sce-office-profile-edit-bio-section", never, { "form": { "alias": "form"; "required": true; "isSignal": true; }; "serviceOptions": { "alias": "serviceOptions"; "required": true; "isSignal": true; }; "availabilityOptions": { "alias": "availabilityOptions"; "required": true; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Media section of the office-profile edit form, with file-upload zones for the cover image and logo; the busy and error states come from the parent's save request rather than from an upload of its own. */
 declare class SceOfficeProfileEditMediaSectionComponent {
     readonly locale: _angular_core.InputSignal<"ar" | "en">;
     readonly coverExistingUrl: _angular_core.InputSignal<string>;
@@ -5717,6 +6002,7 @@ declare class SceOfficeProfileEditMediaSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileEditMediaSectionComponent, "sce-office-profile-edit-media-section", never, { "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "coverExistingUrl": { "alias": "coverExistingUrl"; "required": false; "isSignal": true; }; "coverFile": { "alias": "coverFile"; "required": false; "isSignal": true; }; "logoExistingUrl": { "alias": "logoExistingUrl"; "required": false; "isSignal": true; }; "logoFile": { "alias": "logoFile"; "required": false; "isSignal": true; }; "uploading": { "alias": "uploading"; "required": false; "isSignal": true; }; "uploadError": { "alias": "uploadError"; "required": false; "isSignal": true; }; }, { "coverChange": "coverChange"; "logoChange": "logoChange"; }, never, never, true, never>;
 }
 
+/** Official-data section of the office-profile edit form, binding the parent's `FormGroup` to the bank, city and preferred-project-size selects plus the geo-location picker. */
 declare class SceOfficeProfileEditOfficialSectionComponent {
     readonly form: _angular_core.InputSignal<FormGroup<any>>;
     readonly bankOptions: _angular_core.InputSignal<SceSelectOption<string>[]>;
@@ -5731,6 +6017,7 @@ declare class SceOfficeProfileEditOfficialSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileEditOfficialSectionComponent, "sce-office-profile-edit-official-section", never, { "form": { "alias": "form"; "required": true; "isSignal": true; }; "bankOptions": { "alias": "bankOptions"; "required": true; "isSignal": true; }; "cityOptions": { "alias": "cityOptions"; "required": true; "isSignal": true; }; "preferredSizeOptions": { "alias": "preferredSizeOptions"; "required": true; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "geoLocation": { "alias": "geoLocation"; "required": false; "isSignal": true; }; }, { "locationSelect": "locationSelect"; "ibanInput": "ibanInput"; }, never, never, true, never>;
 }
 
+/** Contact section of the office-profile edit form, binding the parent's `FormGroup` to the contact detail inputs. */
 declare class SceOfficeProfileEditContactSectionComponent {
     readonly form: _angular_core.InputSignal<FormGroup<any>>;
     readonly dir: _angular_core.InputSignal<"rtl" | "ltr">;
@@ -5742,6 +6029,7 @@ interface ProjectView extends OfficeEditProjectItem {
     heroUrl: string;
     thumbUrls: string[];
 }
+/** Projects section of the office-profile edit form, listing each project as a hero image with up to two thumbnails and emitting add, edit and delete requests by list index. */
 declare class SceOfficeProfileEditProjectsSectionComponent {
     readonly projects: _angular_core.InputSignal<OfficeEditProjectItem[]>;
     readonly addProject: _angular_core.OutputEmitterRef<void>;
@@ -5752,6 +6040,7 @@ declare class SceOfficeProfileEditProjectsSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileEditProjectsSectionComponent, "sce-office-profile-edit-projects-section", never, { "projects": { "alias": "projects"; "required": true; "isSignal": true; }; }, { "addProject": "addProject"; "editProject": "editProject"; "deleteProject": "deleteProject"; }, never, never, true, never>;
 }
 
+/** Dialog for adding or editing an office project, binding the parent's project `FormGroup` alongside an image upload zone whose minimum image count defaults to three. */
 declare class SceOfficeProfileProjectEditorDialogComponent {
     readonly visible: _angular_core.InputSignal<boolean>;
     readonly title: _angular_core.InputSignal<string>;
@@ -5771,6 +6060,7 @@ declare class SceOfficeProfileProjectEditorDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileProjectEditorDialogComponent, "sce-office-profile-project-editor-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": true; "isSignal": true; }; "projectForm": { "alias": "projectForm"; "required": true; "isSignal": true; }; "projectCategoryOptions": { "alias": "projectCategoryOptions"; "required": false; "isSignal": true; }; "projectStatusOptions": { "alias": "projectStatusOptions"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "projectError": { "alias": "projectError"; "required": false; "isSignal": true; }; "saveLabel": { "alias": "saveLabel"; "required": true; "isSignal": true; }; "projectMinImageCount": { "alias": "projectMinImageCount"; "required": false; "isSignal": true; }; }, { "closeDialog": "closeDialog"; "saveProject": "saveProject"; "filesChange": "filesChange"; }, never, never, true, never>;
 }
 
+/** Confirmation dialog asking the user to confirm deleting an office project. */
 declare class SceOfficeProfileProjectDeleteDialogComponent {
     readonly visible: _angular_core.InputSignal<boolean>;
     readonly closeDialog: _angular_core.OutputEmitterRef<void>;
@@ -5779,7 +6069,9 @@ declare class SceOfficeProfileProjectDeleteDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileProjectDeleteDialogComponent, "sce-office-profile-project-delete-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; }, { "closeDialog": "closeDialog"; "confirmDelete": "confirmDelete"; }, never, never, true, never>;
 }
 
+/** Identifies a tab of the office-profile view (office data, projects, services, contact). */
 type OfficeProfileTabKey = 'officeData' | 'projects' | 'services' | 'contact';
+/** Hero header of the office profile view — banner, logo, name, city, rating and verification badge — plus the profile's tab bar and an optional active/inactive status switch. */
 declare class SceOfficeProfileHeroComponent {
     readonly bannerUrl: _angular_core.InputSignal<string | null>;
     readonly logoUrl: _angular_core.InputSignal<string | null>;
@@ -5803,6 +6095,7 @@ declare class SceOfficeProfileHeroComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileHeroComponent, "sce-office-profile-hero", never, { "bannerUrl": { "alias": "bannerUrl"; "required": false; "isSignal": true; }; "logoUrl": { "alias": "logoUrl"; "required": false; "isSignal": true; }; "officeName": { "alias": "officeName"; "required": false; "isSignal": true; }; "cityName": { "alias": "cityName"; "required": false; "isSignal": true; }; "rating": { "alias": "rating"; "required": false; "isSignal": true; }; "ratingCount": { "alias": "ratingCount"; "required": false; "isSignal": true; }; "isAvailable": { "alias": "isAvailable"; "required": false; "isSignal": true; }; "verificationStatus": { "alias": "verificationStatus"; "required": false; "isSignal": true; }; "showOfficeStatusSwitch": { "alias": "showOfficeStatusSwitch"; "required": false; "isSignal": true; }; "officeIsActive": { "alias": "officeIsActive"; "required": false; "isSignal": true; }; "officeStatusSaving": { "alias": "officeStatusSaving"; "required": false; "isSignal": true; }; "updateDataChecking": { "alias": "updateDataChecking"; "required": false; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": false; "isSignal": true; }; "tabKeys": { "alias": "tabKeys"; "required": false; "isSignal": true; }; "tabLabels": { "alias": "tabLabels"; "required": false; "isSignal": true; }; }, { "updateDataClick": "updateDataClick"; "statusChange": "statusChange"; "tabChange": "tabChange"; }, never, never, true, never>;
 }
 
+/** Row of headline office statistics: years of experience, project count and service count. */
 declare class SceOfficeProfileStatsRowComponent {
     readonly yearsOfExperience: _angular_core.InputSignal<string>;
     readonly projectsCount: _angular_core.InputSignal<number>;
@@ -5811,6 +6104,7 @@ declare class SceOfficeProfileStatsRowComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileStatsRowComponent, "sce-office-profile-stats-row", never, { "yearsOfExperience": { "alias": "yearsOfExperience"; "required": false; "isSignal": true; }; "projectsCount": { "alias": "projectsCount"; "required": false; "isSignal": true; }; "servicesCount": { "alias": "servicesCount"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Overview tab of the office profile view, showing the summary, services, license number, expiry and status, and office type as info-field cards. */
 declare class SceOfficeProfileOverviewTabComponent {
     readonly summary: _angular_core.InputSignal<string>;
     readonly servicesDisplay: _angular_core.InputSignal<string[]>;
@@ -5822,6 +6116,7 @@ declare class SceOfficeProfileOverviewTabComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileOverviewTabComponent, "sce-office-profile-overview-tab", never, { "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "servicesDisplay": { "alias": "servicesDisplay"; "required": false; "isSignal": true; }; "licenseNumber": { "alias": "licenseNumber"; "required": false; "isSignal": true; }; "licenseExpiryFormatted": { "alias": "licenseExpiryFormatted"; "required": false; "isSignal": true; }; "licenseStatus": { "alias": "licenseStatus"; "required": false; "isSignal": true; }; "officeTypeDisplay": { "alias": "officeTypeDisplay"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** View-model of one project on the office-profile projects tab: id, copy, start/end dates, gallery `imageUrls`, completion flag and a display `typeLabel`. */
 interface OfficeProfileDisplayProject {
     id: number;
     title: string;
@@ -5832,6 +6127,7 @@ interface OfficeProfileDisplayProject {
     isCompleted: boolean;
     typeLabel: string;
 }
+/** Projects tab of the office profile view, rendering each project with its image gallery and showing skeletons while the project images load. */
 declare class SceOfficeProfileProjectsTabComponent {
     readonly displayProjects: _angular_core.InputSignal<OfficeProfileDisplayProject[]>;
     readonly projectImagesLoading: _angular_core.InputSignal<boolean>;
@@ -5840,6 +6136,7 @@ declare class SceOfficeProfileProjectsTabComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileProjectsTabComponent, "sce-office-profile-projects-tab", never, { "displayProjects": { "alias": "displayProjects"; "required": false; "isSignal": true; }; "projectImagesLoading": { "alias": "projectImagesLoading"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Contact tab of the office profile view, showing email, phone, city and address as info-field cards beside an embedded map and a link out to Google Maps. */
 declare class SceOfficeProfileContactTabComponent {
     readonly email: _angular_core.InputSignal<string>;
     readonly phone: _angular_core.InputSignal<string>;
@@ -5851,6 +6148,7 @@ declare class SceOfficeProfileContactTabComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileContactTabComponent, "sce-office-profile-contact-tab", never, { "email": { "alias": "email"; "required": false; "isSignal": true; }; "phone": { "alias": "phone"; "required": false; "isSignal": true; }; "cityName": { "alias": "cityName"; "required": false; "isSignal": true; }; "addressDisplay": { "alias": "addressDisplay"; "required": false; "isSignal": true; }; "safeMapEmbedSrc": { "alias": "safeMapEmbedSrc"; "required": false; "isSignal": true; }; "googleMapsLink": { "alias": "googleMapsLink"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Official-data tab of the office profile view, showing VAT number, commercial registration, bank/IBAN and national address as info-field cards, with preferred project sizes rendered as PrimeNG tag chips when `useTagChips` is set. */
 declare class SceOfficeProfileOfficialTabComponent {
     readonly vatNumber: _angular_core.InputSignal<string>;
     readonly commercialRegistrationNumber: _angular_core.InputSignal<string>;
@@ -5865,6 +6163,7 @@ declare class SceOfficeProfileOfficialTabComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficeProfileOfficialTabComponent, "sce-office-profile-official-tab", never, { "vatNumber": { "alias": "vatNumber"; "required": false; "isSignal": true; }; "commercialRegistrationNumber": { "alias": "commercialRegistrationNumber"; "required": false; "isSignal": true; }; "cityName": { "alias": "cityName"; "required": false; "isSignal": true; }; "bankNameDisplay": { "alias": "bankNameDisplay"; "required": false; "isSignal": true; }; "shortNationalAddress": { "alias": "shortNationalAddress"; "required": false; "isSignal": true; }; "ibanNumber": { "alias": "ibanNumber"; "required": false; "isSignal": true; }; "preferredProjectSizesDisplay": { "alias": "preferredProjectSizesDisplay"; "required": false; "isSignal": true; }; "preferredProjectSizesLabel": { "alias": "preferredProjectSizesLabel"; "required": false; "isSignal": true; }; "useTagChips": { "alias": "useTagChips"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Collapsible `<details>` panel (open by default) showing the reviewer's rejection note, or an em dash when the note is empty. */
 declare class SceDataRequestRejectionPanelComponent {
     /** The rejection note text from the API. Empty string shows a dash. */
     readonly note: _angular_core.InputSignal<string>;
@@ -5872,6 +6171,7 @@ declare class SceDataRequestRejectionPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDataRequestRejectionPanelComponent, "sce-data-request-rejection-panel", never, { "note": { "alias": "note"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Header card of a data-change request showing its number, status badge and office info grid, revealing the rejection panel only when `statusCode` is rejected. */
 declare class SceDataRequestHeaderCardComponent {
     /** Human-readable request number (e.g. "REQ-00123"). */
     readonly requestNumber: _angular_core.InputSignal<string>;
@@ -5899,12 +6199,14 @@ declare class SceDataRequestHeaderCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDataRequestHeaderCardComponent, "sce-data-request-header-card", never, { "requestNumber": { "alias": "requestNumber"; "required": true; "isSignal": true; }; "statusLabel": { "alias": "statusLabel"; "required": true; "isSignal": true; }; "statusCode": { "alias": "statusCode"; "required": true; "isSignal": true; }; "submissionDate": { "alias": "submissionDate"; "required": true; "isSignal": true; }; "rejectionNote": { "alias": "rejectionNote"; "required": false; "isSignal": true; }; "licenseNumber": { "alias": "licenseNumber"; "required": true; "isSignal": true; }; "officeName": { "alias": "officeName"; "required": true; "isSignal": true; }; "representativeName": { "alias": "representativeName"; "required": true; "isSignal": true; }; "reviewRequired": { "alias": "reviewRequired"; "required": true; "isSignal": true; }; "requestStatusLabel": { "alias": "requestStatusLabel"; "required": true; "isSignal": true; }; "lastActionDate": { "alias": "lastActionDate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One field of a data-change request, pairing its `current` and `updated` display values with a `changed` flag that highlights the row. */
 interface DataRequestComparisonRow {
     label: string;
     current: string;
     updated: string;
     changed: boolean;
 }
+/** Titled table contrasting each field's current and updated value in a data-change request, flagging the rows that changed. */
 declare class SceDataRequestComparisonTableComponent {
     /** Section heading text. */
     readonly title: _angular_core.InputSignal<string>;
@@ -5914,7 +6216,9 @@ declare class SceDataRequestComparisonTableComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDataRequestComparisonTableComponent, "sce-data-request-comparison-table", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Which media the comparison frames hold, selecting their aspect ratio: `logo` is square, `cover` widescreen. */
 type DataRequestMediaVariant = 'logo' | 'cover';
+/** Side-by-side before/after image frames for a data-change request, sized square for `logo` and widescreen for `cover`, emitting a click per side. */
 declare class SceDataRequestMediaComparisonComponent {
     /** Block heading (e.g. "Logo" or "Cover"). */
     readonly title: _angular_core.InputSignal<string>;
@@ -5934,11 +6238,13 @@ declare class SceDataRequestMediaComparisonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDataRequestMediaComparisonComponent, "sce-data-request-media-comparison", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "currentUrl": { "alias": "currentUrl"; "required": false; "isSignal": true; }; "newUrl": { "alias": "newUrl"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, { "currentImageClick": "currentImageClick"; "newImageClick": "newImageClick"; }, never, never, true, never>;
 }
 
+/** Payload emitted by `SceNewsletterSubscriptionDialogComponent.submitForm`: trimmed name, email and (optional) mobile. */
 interface NewsletterSubscriptionFormValues {
     clientName: string;
     email: string;
     mobile: string;
 }
+/** Newsletter subscription dialog collecting a name, email and optional Saudi mobile number with its own touch-based validation, resetting all fields whenever it is closed. */
 declare class SceNewsletterSubscriptionDialogComponent {
     private readonly translate;
     readonly visible: _angular_core.InputSignal<boolean>;
@@ -5970,6 +6276,7 @@ declare class SceNewsletterSubscriptionDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceNewsletterSubscriptionDialogComponent, "sce-newsletter-subscription-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "isSubmitting": { "alias": "isSubmitting"; "required": false; "isSignal": true; }; "apiError": { "alias": "apiError"; "required": false; "isSignal": true; }; }, { "closeDialog": "closeDialog"; "submitForm": "submitForm"; }, never, never, true, never>;
 }
 
+/** Profile-photo panel with a hidden file input: emits `photoFileSelected` on pick (resetting the input so the same file can be re-chosen) and `viewClick` only when `hasRealPhoto` is true; uses `ViewEncapsulation.None`. */
 declare class SceProfilePhotoSectionComponent {
     /** Currently displayed photo URL. Null or undefined shows the default avatar. */
     readonly photoUrl: _angular_core.InputSignal<string | null>;
@@ -5995,6 +6302,7 @@ declare class SceProfilePhotoSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceProfilePhotoSectionComponent, "sce-profile-photo-section", never, { "photoUrl": { "alias": "photoUrl"; "required": false; "isSignal": true; }; "photoLoading": { "alias": "photoLoading"; "required": false; "isSignal": true; }; "photoUploading": { "alias": "photoUploading"; "required": false; "isSignal": true; }; "photoError": { "alias": "photoError"; "required": false; "isSignal": true; }; "hasRealPhoto": { "alias": "hasRealPhoto"; "required": false; "isSignal": true; }; "acceptedTypes": { "alias": "acceptedTypes"; "required": false; "isSignal": true; }; }, { "viewClick": "viewClick"; "photoFileSelected": "photoFileSelected"; }, never, never, true, never>;
 }
 
+/** Fully resolved, display-ready personal-profile data; the caller is responsible for formatting the birth date and resolving the bank name. */
 interface ProfileInfoViewData {
     fullName: string;
     nationalId: string;
@@ -6009,11 +6317,13 @@ interface ProfileInfoViewData {
     bankNameDisplay: string;
     bankAccount: string;
 }
+/** One label/value row in a profile view section; `fullWidth` makes it span both grid columns. */
 interface ProfileViewField {
     labelKey: string;
     value: string;
     fullWidth?: boolean;
 }
+/** A titled group of read-only profile fields, optionally carrying its own Edit action. */
 interface ProfileViewSection {
     titleKey: string;
     showEditAction?: boolean;
@@ -6021,6 +6331,7 @@ interface ProfileViewSection {
 }
 /** Re-exported alias so callers don't need to import from core directly. */
 type ProfileBankOption = LookupDetailDto;
+/** Personal-profile panel that flips between a read-only field grid and an edit form (`editing`), showing skeletons while `profile` is null and an inline banner for `error`; uses `ViewEncapsulation.None`. */
 declare class SceProfileInfoSectionComponent {
     /** Resolved profile data for the read (view) mode. Null shows skeleton. */
     readonly profile: _angular_core.InputSignal<ProfileInfoViewData | null>;
@@ -6062,6 +6373,7 @@ declare class SceProfileInfoSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceProfileInfoSectionComponent, "sce-profile-info-section", never, { "profile": { "alias": "profile"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "editing": { "alias": "editing"; "required": false; "isSignal": true; }; "saving": { "alias": "saving"; "required": false; "isSignal": true; }; "editEmail": { "alias": "editEmail"; "required": false; "isSignal": true; }; "editPhone": { "alias": "editPhone"; "required": false; "isSignal": true; }; "editAddress": { "alias": "editAddress"; "required": false; "isSignal": true; }; "editBankId": { "alias": "editBankId"; "required": false; "isSignal": true; }; "editBankAccount": { "alias": "editBankAccount"; "required": false; "isSignal": true; }; "emailError": { "alias": "emailError"; "required": false; "isSignal": true; }; "phoneError": { "alias": "phoneError"; "required": false; "isSignal": true; }; "addressError": { "alias": "addressError"; "required": false; "isSignal": true; }; "bankAccountError": { "alias": "bankAccountError"; "required": false; "isSignal": true; }; "banks": { "alias": "banks"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, { "editClick": "editClick"; "cancelClick": "cancelClick"; "saveClick": "saveClick"; "emailChange": "emailChange"; "phoneChange": "phoneChange"; "addressChange": "addressChange"; "bankIdChange": "bankIdChange"; "bankAccountChange": "bankAccountChange"; }, never, never, true, never>;
 }
 
+/** Info-field grid summarising the entity's current contact and registration data on a data-change request; each unset field falls back to an em dash. */
 declare class SceDataRequestCurrentSummaryComponent {
     readonly currentPhone: _angular_core.InputSignal<string>;
     readonly currentEmail: _angular_core.InputSignal<string>;
@@ -6072,7 +6384,9 @@ declare class SceDataRequestCurrentSummaryComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDataRequestCurrentSummaryComponent, "sce-data-request-current-summary", never, { "currentPhone": { "alias": "currentPhone"; "required": false; "isSignal": true; }; "currentEmail": { "alias": "currentEmail"; "required": false; "isSignal": true; }; "currentCity": { "alias": "currentCity"; "required": false; "isSignal": true; }; "unifiedNumber": { "alias": "unifiedNumber"; "required": false; "isSignal": true; }; "currentVatNumber": { "alias": "currentVatNumber"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** How a portfolio project changed in the request, grouping it into the added, updated or removed section. */
 type ProjectChangeDisplayType = 'added' | 'updated' | 'removed';
+/** One numeric or textual attribute of a project, showing its `currentValue` beside its `nextValue` and whether the two differ. */
 interface ProjectChangeDisplayMetric {
     key: string;
     label: string;
@@ -6080,6 +6394,7 @@ interface ProjectChangeDisplayMetric {
     nextValue: string;
     changed: boolean;
 }
+/** A single project's proposed change, carrying its before/after description and metrics, its gallery `imageUrls`, and the pre-rendered badge and subtitle strings. */
 interface ProjectChangeDisplayItem {
     id: string;
     type: ProjectChangeDisplayType;
@@ -6095,6 +6410,7 @@ interface ProjectChangeDisplayItem {
     imageUrls: string[];
     compactSubtitle: string;
 }
+/** Lists the added, updated and removed portfolio projects in a data-change request, emitting the project and image index when a preview is clicked. */
 declare class SceDataRequestProjectChangesComponent {
     readonly projectChanges: _angular_core.InputSignal<ProjectChangeDisplayItem[]>;
     readonly isSystemUser: _angular_core.InputSignal<boolean>;
@@ -6106,6 +6422,7 @@ declare class SceDataRequestProjectChangesComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceDataRequestProjectChangesComponent, "sce-data-request-project-changes", never, { "projectChanges": { "alias": "projectChanges"; "required": false; "isSignal": true; }; "isSystemUser": { "alias": "isSystemUser"; "required": false; "isSignal": true; }; }, { "imageClick": "imageClick"; }, never, never, true, never>;
 }
 
+/** One knowledge-center category tile, keyed by `slug`; `titleKey` and `descriptionKey` are i18n keys, not literal text. */
 interface KnowledgeCategoryItem {
     slug: string;
     titleKey: string;
@@ -6113,6 +6430,7 @@ interface KnowledgeCategoryItem {
     icon: string;
     background?: string;
 }
+/** Grid of knowledge-center categories that also owns its loading, error and empty states and emits category/retry/ticket actions. */
 declare class SceKnowledgeCenterCategoryGridComponent {
     readonly categories: _angular_core.InputSignal<KnowledgeCategoryItem[]>;
     readonly isLoadingCategories: _angular_core.InputSignal<boolean>;
@@ -6125,6 +6443,7 @@ declare class SceKnowledgeCenterCategoryGridComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceKnowledgeCenterCategoryGridComponent, "sce-knowledge-center-category-grid", never, { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "isLoadingCategories": { "alias": "isLoadingCategories"; "required": false; "isSignal": true; }; "categoriesError": { "alias": "categoriesError"; "required": false; "isSignal": true; }; }, { "categoryClick": "categoryClick"; "retry": "retry"; "newTicket": "newTicket"; "viewTickets": "viewTickets"; }, never, never, true, never>;
 }
 
+/** Read-only contact details panel rendering working hours, response time, phone number, email link and Instagram/Twitter links. */
 declare class SceContactInfoPanelComponent {
     readonly workingHoursValue: _angular_core.InputSignal<string>;
     readonly responseValue: _angular_core.InputSignal<string>;
@@ -6137,6 +6456,7 @@ declare class SceContactInfoPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceContactInfoPanelComponent, "sce-contact-info-panel", never, { "workingHoursValue": { "alias": "workingHoursValue"; "required": false; "isSignal": true; }; "responseValue": { "alias": "responseValue"; "required": false; "isSignal": true; }; "phoneValue": { "alias": "phoneValue"; "required": false; "isSignal": true; }; "emailHref": { "alias": "emailHref"; "required": false; "isSignal": true; }; "emailValue": { "alias": "emailValue"; "required": false; "isSignal": true; }; "socialInstagramHref": { "alias": "socialInstagramHref"; "required": false; "isSignal": true; }; "socialTwitterHref": { "alias": "socialTwitterHref"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Fully-controlled contact form panel with name, email, message-type and message fields plus a hidden `website` honeypot; it holds no state of its own — every value, error and loading flag is an input and every change is an output. */
 declare class SceContactFormPanelComponent {
     readonly dir: _angular_core.InputSignal<"rtl" | "ltr">;
     readonly fullName: _angular_core.InputSignal<string>;
@@ -6172,6 +6492,7 @@ declare class SceContactFormPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceContactFormPanelComponent, "sce-contact-form-panel", never, { "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "fullName": { "alias": "fullName"; "required": true; "isSignal": true; }; "email": { "alias": "email"; "required": true; "isSignal": true; }; "messageType": { "alias": "messageType"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": true; "isSignal": true; }; "website": { "alias": "website"; "required": false; "isSignal": true; }; "submitSuccess": { "alias": "submitSuccess"; "required": false; "isSignal": true; }; "submitError": { "alias": "submitError"; "required": false; "isSignal": true; }; "isSubmitting": { "alias": "isSubmitting"; "required": false; "isSignal": true; }; "isSubmitDisabled": { "alias": "isSubmitDisabled"; "required": false; "isSignal": true; }; "submitLabel": { "alias": "submitLabel"; "required": true; "isSignal": true; }; "messageTypesLoading": { "alias": "messageTypesLoading"; "required": false; "isSignal": true; }; "messageTypeUnavailable": { "alias": "messageTypeUnavailable"; "required": false; "isSignal": true; }; "messageTypeOptions": { "alias": "messageTypeOptions"; "required": false; "isSignal": true; }; "messageTypePlaceholder": { "alias": "messageTypePlaceholder"; "required": false; "isSignal": true; }; "fullNameError": { "alias": "fullNameError"; "required": false; "isSignal": true; }; "emailError": { "alias": "emailError"; "required": false; "isSignal": true; }; "messageTypeError": { "alias": "messageTypeError"; "required": false; "isSignal": true; }; "messageError": { "alias": "messageError"; "required": false; "isSignal": true; }; "emailPattern": { "alias": "emailPattern"; "required": false; "isSignal": true; }; "fullNameValidationMessages": { "alias": "fullNameValidationMessages"; "required": false; "isSignal": true; }; "emailValidationMessages": { "alias": "emailValidationMessages"; "required": false; "isSignal": true; }; "messageTypeValidationMessages": { "alias": "messageTypeValidationMessages"; "required": false; "isSignal": true; }; "messageValidationMessages": { "alias": "messageValidationMessages"; "required": false; "isSignal": true; }; }, { "fullNameChange": "fullNameChange"; "emailChange": "emailChange"; "messageTypeChange": "messageTypeChange"; "messageChange": "messageChange"; "websiteChange": "websiteChange"; "formSubmit": "formSubmit"; }, never, never, true, never>;
 }
 
+/** Day counts for the force-majeure setting: notification periods per contract kind, plus the grantable extension periods. */
 interface PsSettingForceMajeureDurationsValue {
     notificationDays: {
         general: number;
@@ -6183,6 +6504,7 @@ interface PsSettingForceMajeureDurationsValue {
         consultancy: number;
     };
 }
+/** Discriminated union of one platform setting, keyed on `type`, which selects both the `value` shape and the control rendered for it. */
 type PsSettingField = {
     apiKey: string;
     label: string;
@@ -6202,6 +6524,7 @@ type PsSettingField = {
     type: 'forceMajeureDurations';
     value: PsSettingForceMajeureDurationsValue;
 };
+/** Renders the platform settings list as read-only info cards or editable controls, emitting a typed update per field kind (boolean, integer, force-majeure durations). */
 declare class ScePlatformSettingsFieldsComponent {
     readonly viewFields: _angular_core.InputSignal<PsSettingField[]>;
     readonly isEditMode: _angular_core.InputSignal<boolean>;
@@ -6230,6 +6553,7 @@ declare class ScePlatformSettingsFieldsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScePlatformSettingsFieldsComponent, "sce-platform-settings-fields", never, { "viewFields": { "alias": "viewFields"; "required": true; "isSignal": true; }; "isEditMode": { "alias": "isEditMode"; "required": false; "isSignal": true; }; "saving": { "alias": "saving"; "required": false; "isSignal": true; }; }, { "booleanUpdate": "booleanUpdate"; "integerUpdate": "integerUpdate"; "forceMajeureNotificationUpdate": "forceMajeureNotificationUpdate"; "forceMajeureExtensionUpdate": "forceMajeureExtensionUpdate"; "editCancel": "editCancel"; "editSave": "editSave"; }, never, never, true, never>;
 }
 
+/** Presentational entity-profile edit form bound to a caller-owned `FormGroup`; it holds no form state of its own and re-emits each field's raw input `Event` for the host to handle. */
 declare class SceEntityProfileEditFormComponent {
     readonly form: _angular_core.InputSignal<FormGroup<any>>;
     readonly dir: _angular_core.InputSignal<"rtl" | "ltr">;
@@ -6252,7 +6576,9 @@ declare class SceEntityProfileEditFormComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceEntityProfileEditFormComponent, "sce-entity-profile-edit-form", never, { "form": { "alias": "form"; "required": true; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "entityName": { "alias": "entityName"; "required": false; "isSignal": true; }; "entityType": { "alias": "entityType"; "required": false; "isSignal": true; }; "unifiedNumber": { "alias": "unifiedNumber"; "required": false; "isSignal": true; }; "bankOptions": { "alias": "bankOptions"; "required": false; "isSignal": true; }; "selectedBankId": { "alias": "selectedBankId"; "required": false; "isSignal": true; }; "bankError": { "alias": "bankError"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; }, { "phoneInput": "phoneInput"; "licenseInput": "licenseInput"; "taxInput": "taxInput"; "addressInput": "addressInput"; "ibanInput": "ibanInput"; "bankChange": "bankChange"; "formSubmit": "formSubmit"; }, never, never, true, never>;
 }
 
+/** Which tab of the account-users page is active. */
 type AccountUsersTab = 'account-users' | 'engineering-staff';
+/** Title bar with account-users / engineering-staff tabs and an optional Add button (`showAddButton`, off by default); it emits clicks and never switches `activeTab` itself. */
 declare class SceAccountUsersTabsBarComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly activeTab: _angular_core.InputSignal<AccountUsersTab>;
@@ -6264,6 +6590,7 @@ declare class SceAccountUsersTabsBarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAccountUsersTabsBarComponent, "sce-account-users-tabs-bar", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": true; "isSignal": true; }; "showAddButton": { "alias": "showAddButton"; "required": false; "isSignal": true; }; }, { "accountUsersTabClick": "accountUsersTabClick"; "staffTabClick": "staffTabClick"; "addUserClick": "addUserClick"; }, never, never, true, never>;
 }
 
+/** Dialog that collects a national ID and birth date (Hijri or Gregorian via `calendarSystem`) to verify a user before assigning them; fully controlled, emitting `submitVerify` rather than calling any API. */
 declare class SceAccountUserVerifyDialogComponent {
     readonly visible: _angular_core.InputSignal<boolean>;
     readonly locale: _angular_core.InputSignal<"ar" | "en">;
@@ -6282,6 +6609,7 @@ declare class SceAccountUserVerifyDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAccountUserVerifyDialogComponent, "sce-account-user-verify-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": true; "isSignal": true; }; "nationalId": { "alias": "nationalId"; "required": true; "isSignal": true; }; "nationalIdError": { "alias": "nationalIdError"; "required": false; "isSignal": true; }; "birthDate": { "alias": "birthDate"; "required": true; "isSignal": true; }; "birthDateError": { "alias": "birthDateError"; "required": false; "isSignal": true; }; "calendarSystem": { "alias": "calendarSystem"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; "actionError": { "alias": "actionError"; "required": false; "isSignal": true; }; }, { "dialogClose": "dialogClose"; "nationalIdChange": "nationalIdChange"; "birthDateChange": "birthDateChange"; "submitVerify": "submitVerify"; }, never, never, true, never>;
 }
 
+/** Draft values bound by the assign-user dialog; identity fields arrive pre-filled from the national-ID lookup and only email, mobile, roles, and active state are editable. */
 interface AccountUserAssignForm {
     nationalId: string;
     userName: string;
@@ -6291,10 +6619,12 @@ interface AccountUserAssignForm {
     roleIds: number[];
     isActive: boolean;
 }
+/** A role choice in the assign-user dialog's multi-select, keyed by numeric role id. */
 interface AssignRoleOption {
     label: string;
     value: number;
 }
+/** Dialog for assigning an account user roles and contact details; fully controlled — it mutates nothing, emitting every field change and `submitAssign` to the host — and uses `ViewEncapsulation.None`. */
 declare class SceAccountUserAssignDialogComponent {
     readonly visible: _angular_core.InputSignal<boolean>;
     readonly locale: _angular_core.InputSignal<"ar" | "en">;
@@ -6319,15 +6649,18 @@ declare class SceAccountUserAssignDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAccountUserAssignDialogComponent, "sce-account-user-assign-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": true; "isSignal": true; }; "assignForm": { "alias": "assignForm"; "required": true; "isSignal": true; }; "requireEmail": { "alias": "requireEmail"; "required": false; "isSignal": true; }; "requireMobile": { "alias": "requireMobile"; "required": false; "isSignal": true; }; "emailError": { "alias": "emailError"; "required": false; "isSignal": true; }; "mobileError": { "alias": "mobileError"; "required": false; "isSignal": true; }; "rolesLoading": { "alias": "rolesLoading"; "required": false; "isSignal": true; }; "roleOptions": { "alias": "roleOptions"; "required": false; "isSignal": true; }; "rolesError": { "alias": "rolesError"; "required": false; "isSignal": true; }; "actionError": { "alias": "actionError"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; }, { "dialogClose": "dialogClose"; "emailChange": "emailChange"; "mobileChange": "mobileChange"; "roleIdsChange": "roleIdsChange"; "isActiveChange": "isActiveChange"; "submitAssign": "submitAssign"; }, never, never, true, never>;
 }
 
+/** A non-editable identity field displayed in the edit-user dialog; `fullWidth` spans both grid columns. */
 interface AccountUserEditReadOnlyField {
     label: string;
     value: string | null | undefined;
     fullWidth?: boolean;
 }
+/** A role choice in the edit-user dialog's multi-select; unlike the assign dialog its `value` is a string id. */
 interface AccountUserEditRoleOption {
     label: string;
     value: string;
 }
+/** Dialog for editing an existing account user's roles and active state over a read-only identity summary; fully controlled and uses `ViewEncapsulation.None`. */
 declare class SceAccountUserEditDialogComponent {
     readonly visible: _angular_core.InputSignal<boolean>;
     readonly locale: _angular_core.InputSignal<"ar" | "en">;
@@ -6350,14 +6683,17 @@ declare class SceAccountUserEditDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAccountUserEditDialogComponent, "sce-account-user-edit-dialog", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": true; "isSignal": true; }; "readOnlyFields": { "alias": "readOnlyFields"; "required": false; "isSignal": true; }; "roleOptions": { "alias": "roleOptions"; "required": false; "isSignal": true; }; "draftRoleIds": { "alias": "draftRoleIds"; "required": false; "isSignal": true; }; "rolesLoading": { "alias": "rolesLoading"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "permissionsError": { "alias": "permissionsError"; "required": false; "isSignal": true; }; "dialogError": { "alias": "dialogError"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; "submitLabel": { "alias": "submitLabel"; "required": true; "isSignal": true; }; }, { "closed": "closed"; "submitted": "submitted"; "draftRoleIdsChange": "draftRoleIdsChange"; "isActiveChange": "isActiveChange"; }, never, never, true, never>;
 }
 
+/** A status pill in the account-user detail header, coloured by its business-status `tone`. */
 interface UserDetailStatusTag {
     label: string;
     tone?: BusinessStatusTone;
 }
+/** A label/value chip (membership number, national ID) shown beside the user's name. */
 interface UserDetailBadge {
     label: string;
     value: string;
 }
+/** Header of an account-user detail page: name, status tags, membership/national-ID badges, and an Edit button; all labels are passed in already translated. */
 declare class SceAccountUserDetailHeaderComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly statusTags: _angular_core.InputSignal<UserDetailStatusTag[]>;
@@ -6369,11 +6705,13 @@ declare class SceAccountUserDetailHeaderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAccountUserDetailHeaderComponent, "sce-account-user-detail-header", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "statusTags": { "alias": "statusTags"; "required": false; "isSignal": true; }; "membershipBadge": { "alias": "membershipBadge"; "required": false; "isSignal": true; }; "nationalIdBadge": { "alias": "nationalIdBadge"; "required": false; "isSignal": true; }; "editButtonLabel": { "alias": "editButtonLabel"; "required": true; "isSignal": true; }; }, { "editClick": "editClick"; }, never, never, true, never>;
 }
 
+/** One read-only label/value row of a user's personal details; `fullWidth` spans both grid columns. */
 interface UserDetailField {
     label: string;
     value: string | null | undefined;
     fullWidth?: boolean;
 }
+/** Titled grid of read-only personal-detail `fields` for an account user; labels and values arrive already translated and formatted. */
 declare class SceAccountUserPersonalSectionComponent {
     readonly title: _angular_core.InputSignal<string>;
     readonly fields: _angular_core.InputSignal<UserDetailField[]>;
@@ -6381,6 +6719,7 @@ declare class SceAccountUserPersonalSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAccountUserPersonalSectionComponent, "sce-account-user-personal-section", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "fields": { "alias": "fields"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Read-only permissions panel listing an account user's roles as `pills`, falling back to `noPermissionsLabel` when empty and to skeletons while `loading`. */
 declare class SceAccountUserPermissionsSectionComponent {
     readonly sectionTitle: _angular_core.InputSignal<string>;
     readonly permissionsLabel: _angular_core.InputSignal<string>;
@@ -6391,6 +6730,7 @@ declare class SceAccountUserPermissionsSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceAccountUserPermissionsSectionComponent, "sce-account-user-permissions-section", never, { "sectionTitle": { "alias": "sectionTitle"; "required": true; "isSignal": true; }; "permissionsLabel": { "alias": "permissionsLabel"; "required": true; "isSignal": true; }; "noPermissionsLabel": { "alias": "noPermissionsLabel"; "required": true; "isSignal": true; }; "pills": { "alias": "pills"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Inline (non-dialog) national-ID and birth-date step for verifying an internal user before creation; `calendarSystem` selects Hijri or Gregorian input and `verify` is emitted for the host to call the API. */
 declare class SceInternalUserVerifySectionComponent {
     readonly nationalId: _angular_core.InputSignal<string>;
     readonly birthDate: _angular_core.InputSignal<string>;
@@ -6406,7 +6746,9 @@ declare class SceInternalUserVerifySectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceInternalUserVerifySectionComponent, "sce-internal-user-verify-section", never, { "nationalId": { "alias": "nationalId"; "required": true; "isSignal": true; }; "birthDate": { "alias": "birthDate"; "required": true; "isSignal": true; }; "nationalIdError": { "alias": "nationalIdError"; "required": false; "isSignal": true; }; "birthDateError": { "alias": "birthDateError"; "required": false; "isSignal": true; }; "calendarSystem": { "alias": "calendarSystem"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": true; "isSignal": true; }; "verifying": { "alias": "verifying"; "required": false; "isSignal": true; }; }, { "nationalIdChange": "nationalIdChange"; "birthDateChange": "birthDateChange"; "verify": "verify"; }, never, never, true, never>;
 }
 
+/** Whether the internal-user fields are editing an existing user or showing the post-verification create step. */
 type InternalUserFormFieldsMode = 'edit' | 'create-verified';
+/** Contact-detail fields for an internal user: national ID, birth date, and name are read-only, and only email and mobile are editable (emitted back to the host). */
 declare class SceInternalUserFormFieldsComponent {
     readonly mode: _angular_core.InputSignal<InternalUserFormFieldsMode>;
     readonly nationalId: _angular_core.InputSignal<string>;
@@ -6422,10 +6764,12 @@ declare class SceInternalUserFormFieldsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceInternalUserFormFieldsComponent, "sce-internal-user-form-fields", never, { "mode": { "alias": "mode"; "required": true; "isSignal": true; }; "nationalId": { "alias": "nationalId"; "required": false; "isSignal": true; }; "birthDate": { "alias": "birthDate"; "required": false; "isSignal": true; }; "userName": { "alias": "userName"; "required": false; "isSignal": true; }; "email": { "alias": "email"; "required": false; "isSignal": true; }; "mobile": { "alias": "mobile"; "required": false; "isSignal": true; }; "emailError": { "alias": "emailError"; "required": false; "isSignal": true; }; "mobileError": { "alias": "mobileError"; "required": false; "isSignal": true; }; }, { "emailChange": "emailChange"; "mobileChange": "mobileChange"; }, never, never, true, never>;
 }
 
+/** A role choice in the internal-user permissions multi-select, keyed by numeric role id. */
 interface InternalUserRoleOption {
     label: string;
     value: number;
 }
+/** Editable permissions panel for an internal user: a roles multi-select (skeletons while `rolesLoading`) plus an active/inactive switch that defaults to on. */
 declare class SceInternalUserPermissionsSectionComponent {
     readonly roleOptions: _angular_core.InputSignal<InternalUserRoleOption[]>;
     readonly selectedRoleNumbers: _angular_core.InputSignal<number[]>;
@@ -6437,7 +6781,9 @@ declare class SceInternalUserPermissionsSectionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceInternalUserPermissionsSectionComponent, "sce-internal-user-permissions-section", never, { "roleOptions": { "alias": "roleOptions"; "required": false; "isSignal": true; }; "selectedRoleNumbers": { "alias": "selectedRoleNumbers"; "required": false; "isSignal": true; }; "rolesLoading": { "alias": "rolesLoading"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; }, { "selectedRoleNumbersChange": "selectedRoleNumbersChange"; "isActiveChange": "isActiveChange"; }, never, never, true, never>;
 }
 
+/** Which presentation the offices browser is showing: card grid, list, or map. */
 type OfficeViewMode = 'grid' | 'list' | 'map';
+/** Segmented grid/list/map switch for the offices browser; fully controlled — it reports `viewModeChange` rather than holding the mode itself. */
 declare class SceOfficesViewToggleComponent {
     readonly viewMode: _angular_core.InputSignal<OfficeViewMode>;
     readonly viewModeChange: _angular_core.OutputEmitterRef<OfficeViewMode>;
@@ -6445,7 +6791,9 @@ declare class SceOfficesViewToggleComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficesViewToggleComponent, "sce-offices-view-toggle", never, { "viewMode": { "alias": "viewMode"; "required": true; "isSignal": true; }; }, { "viewModeChange": "viewModeChange"; }, never, never, true, never>;
 }
 
+/** Layout the offices grid panel renders its cards in. */
 type OfficeGridViewMode = 'grid' | 'list';
+/** Paginated grid/list of engineering-office cards with skeleton and empty states; `viewMode` switches the layout and `skeletonCount` is floored at 4. */
 declare class SceOfficesGridPanelComponent {
     readonly cards: _angular_core.InputSignal<SceEngineeringOfficeCardModel[]>;
     readonly isLoading: _angular_core.InputSignal<boolean>;
@@ -6472,6 +6820,7 @@ declare class SceOfficesGridPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficesGridPanelComponent, "sce-offices-grid-panel", never, { "cards": { "alias": "cards"; "required": true; "isSignal": true; }; "isLoading": { "alias": "isLoading"; "required": true; "isSignal": true; }; "isEmpty": { "alias": "isEmpty"; "required": true; "isSignal": true; }; "viewMode": { "alias": "viewMode"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": true; "isSignal": true; }; "totalItems": { "alias": "totalItems"; "required": true; "isSignal": true; }; "locale": { "alias": "locale"; "required": true; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "bookmarkedIds": { "alias": "bookmarkedIds"; "required": false; "isSignal": true; }; "bookmarkLabel": { "alias": "bookmarkLabel"; "required": false; "isSignal": true; }; "ratingLabel": { "alias": "ratingLabel"; "required": false; "isSignal": true; }; "locationLabel": { "alias": "locationLabel"; "required": false; "isSignal": true; }; "otherLabel": { "alias": "otherLabel"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; "bookmarkClick": "bookmarkClick"; }, never, never, true, never>;
 }
 
+/** Wraps the OSM offices map with a fallback link shown when `mapLoadFailed`; emits `selectOffice` when a marker is picked. */
 declare class SceOfficesMapPanelComponent {
     readonly mapPoints: _angular_core.InputSignal<SceOsmOfficeMapPoint[]>;
     readonly mapLoadFailed: _angular_core.InputSignal<boolean>;
@@ -6484,16 +6833,21 @@ declare class SceOfficesMapPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceOfficesMapPanelComponent, "sce-offices-map-panel", never, { "mapPoints": { "alias": "mapPoints"; "required": true; "isSignal": true; }; "mapLoadFailed": { "alias": "mapLoadFailed"; "required": true; "isSignal": true; }; "fallbackMapUrl": { "alias": "fallbackMapUrl"; "required": false; "isSignal": true; }; "hasFallbackOffice": { "alias": "hasFallbackOffice"; "required": false; "isSignal": true; }; }, { "selectOffice": "selectOffice"; "ready": "ready"; "mapError": "mapError"; }, never, never, true, never>;
 }
 
+/** Ordering applied to the offices browser results. */
 type OfficeSortMode = 'rating' | 'experience' | 'clients';
+/** Office-size bucket used to narrow the offices browser results. */
 type OfficeSizeFilter = 'all' | 'small' | 'medium' | 'large';
+/** A selectable sort choice in the offices filters sidebar, labelled by i18n key. */
 interface OfficeSortOption {
     readonly value: OfficeSortMode;
     readonly labelKey: string;
 }
+/** A selectable office-size choice in the offices filters sidebar, labelled by i18n key. */
 interface OfficeSizeOption {
     readonly value: OfficeSizeFilter;
     readonly labelKey: string;
 }
+/** Fully controlled sort/size/budget/experience filter sidebar for the offices browser: it owns no state, taking every draft value, slider bound, and budget-histogram bar as a required input and emitting changes back — including the pre-flipped `*SliderLtr` values PrimeNG's slider needs under RTL. */
 declare class SceOfficesFiltersSidebarComponent {
     /** Current draft sort/filter values */
     readonly draftSort: _angular_core.InputSignal<OfficeSortMode>;
@@ -6650,6 +7004,7 @@ declare class SceRadioOptionCard {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceRadioOptionCard, "sce-radio-option-card", never, { "iconName": { "alias": "iconName"; "required": true; "isSignal": true; }; "iconSize": { "alias": "iconSize"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Value of `SceRangeBar`: a single number, or a `[start, end]` pair which switches it into two-handle range mode. */
 type SceRangeBarValue = number | [number, number];
 /** Single-value or two-handle range slider wired as a `ControlValueAccessor`. */
 declare class SceRangeBar implements ControlValueAccessor {
@@ -6682,6 +7037,7 @@ declare class SceRangeBar implements ControlValueAccessor {
 
 /** Rendering mode of the option list. */
 type SceFormCheckboxRadioType = 'radio' | 'checkbox' | 'checkbox-search';
+/** A selectable option with an already-translated `label`, a `value`, and an optional result `count` shown beside it. */
 interface SceFieldOption {
     label: string;
     value: string;
@@ -6879,6 +7235,7 @@ declare class SceNavCard {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceNavCard, "sce-nav-card", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": true; "isSignal": true; }; "thumbnailSrc": { "alias": "thumbnailSrc"; "required": false; "isSignal": true; }; "route": { "alias": "route"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "showPlayIcon": { "alias": "showPlayIcon"; "required": false; "isSignal": true; }; }, { "cardClick": "cardClick"; }, never, never, true, never>;
 }
 
+/** One selectable chip in `SceOptionGroup`: a `value`, an optional already-translated `label`, and an optional `disabled` flag. */
 interface SceOptionItem {
     value: string;
     label?: string;
@@ -6974,6 +7331,7 @@ declare class SceTabPanel {
 
 /** Layout mode: `field` renders a label/value row inside a parent panel; `card` renders a standalone padded tile. */
 type BasicCardLayout = 'card' | 'field';
+/** Label-and-value display rendered either as a standalone padded tile or, in `field` layout, as a plain row inside a parent panel. */
 declare class SceBasicCardComponent {
     readonly label: _angular_core.InputSignal<string>;
     readonly value: _angular_core.InputSignal<string>;
@@ -6983,6 +7341,7 @@ declare class SceBasicCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceBasicCardComponent, "sce-basic-card", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** One tile in `SceNavCardsListComponent`: a slug fed to the parent's route factory plus i18n title/description keys and a thumbnail. */
 interface SceNavCardItem {
     /** Stable identifier; also fed to the parent's route factory. */
     readonly slug: string;
@@ -6991,6 +7350,7 @@ interface SceNavCardItem {
     readonly thumbnailSrc: string;
 }
 
+/** Renders a grid of `sce-nav-card` tiles from `items`; stays route-agnostic by taking a required `getItemRoute` factory that turns an item slug into a router link. */
 declare class SceNavCardsListComponent {
     readonly items: _angular_core.InputSignal<readonly SceNavCardItem[]>;
     /** Maps an item slug to a router link. Kept as an input so the organism stays route-agnostic. */
@@ -7032,6 +7392,7 @@ declare class SceCardsStatisticsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceCardsStatisticsComponent, "sce-cards-statistics", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "totalNumber": { "alias": "totalNumber"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "iconColor": { "alias": "iconColor"; "required": false; "isSignal": true; }; "tintedIconBackground": { "alias": "tintedIconBackground"; "required": false; "isSignal": true; }; "trendPercentage": { "alias": "trendPercentage"; "required": false; "isSignal": true; }; "trendLabel": { "alias": "trendLabel"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Tone of the status chip on an evaluation criterion. */
 type SceCriteriaStatus = 'success' | 'warning' | 'info' | 'danger';
 /** Reviewer's write-up for one criterion: an optional reason, free-text notes, and evidence. */
 interface SceCriteriaObservation {
@@ -7039,6 +7400,7 @@ interface SceCriteriaObservation {
     readonly notes?: string;
     readonly attachments?: readonly SceAttachmentListItem[];
 }
+/** One evaluation criterion: its title, status chip `tag`/`status`, optional free-form `score` and description, and the reviewer's `observation`. */
 interface SceCriteriaItem {
     readonly id: string | number;
     readonly title: string;
@@ -7050,6 +7412,7 @@ interface SceCriteriaItem {
     readonly description?: string;
     readonly observation?: SceCriteriaObservation;
 }
+/** Payload of a criteria section: an optional heading plus the list of `criteria` to render. */
 interface SceCriteriaSectionData {
     /** i18n key or literal for the section heading. */
     readonly title?: string;
@@ -7095,6 +7458,7 @@ interface SceEntitySummarySector {
     readonly disabled?: boolean;
 }
 
+/** Card summarising an entity by logo, name and description, listing its sectors as clickable chips (disabled ones emit nothing) with info and optional settings actions. */
 declare class SceEntitySummaryCardComponent {
     readonly logo: _angular_core.InputSignal<string>;
     readonly name: _angular_core.InputSignal<string>;
@@ -7139,6 +7503,7 @@ declare class SceExportPdfContainerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceExportPdfContainerComponent, "sce-export-pdf-container", never, { "filename": { "alias": "filename"; "required": false; "isSignal": true; }; "pageNumbers": { "alias": "pageNumbers"; "required": false; "isSignal": true; }; }, { "exportStarted": "exportStarted"; "exportComplete": "exportComplete"; "exportError": "exportError"; }, never, ["*"], true, never>;
 }
 
+/** Reason a picked file was rejected by `SceImagePickerComponent`: wrong MIME type or over `maxSizeMb`. */
 type SceImagePickerError = 'type' | 'size';
 /** Avatar-style image picker with drag-and-drop, preview, and reactive-forms integration. */
 declare class SceImagePickerComponent implements ControlValueAccessor, Validator {
@@ -7186,11 +7551,13 @@ declare class SceImagePickerComponent implements ControlValueAccessor, Validator
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceImagePickerComponent, "sce-image-picker", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "fileSelected": "fileSelected"; "cleared": "cleared"; "validationError": "validationError"; }, never, never, true, never>;
 }
 
+/** Status chip shown on an inquiry-request card: a label (i18n key or literal) plus the `SceTagVariant` to colour it. */
 interface SceInquiryRequestStatus {
     /** i18n key or literal shown inside the tag. */
     readonly label: string;
     readonly variant: SceTagVariant;
 }
+/** One inquiry request rendered by the inquiry-request card: code, sender, date, deadline, status, and an optional per-row `loading` flag. */
 interface SceInquiryRequest {
     readonly id: string;
     readonly code: string;
@@ -7220,13 +7587,16 @@ declare class SceInquiryRequestCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceInquiryRequestCardComponent, "sce-inquiry-request-card", never, { "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "subtitleKey": { "alias": "subtitleKey"; "required": false; "isSignal": true; }; "inquiries": { "alias": "inquiries"; "required": true; "isSignal": true; }; }, { "inquirySelect": "inquirySelect"; }, never, never, true, never>;
 }
 
+/** Severity of a notification, which drives its colour and (unless `icon` is set) its icon. */
 type SceNotificationTone = 'info' | 'warning' | 'success' | 'danger';
+/** A button rendered inside a notification; the `id` is echoed back to the host when clicked. */
 interface SceNotificationAction {
     /** i18n key or literal shown on the action button. */
     readonly label: string;
     readonly id: string;
     readonly variant?: 'primary' | 'secondary';
 }
+/** One notification row: title, description, `tone`, read flag, `Date`, and optional category chip, icon override, and actions. */
 interface SceNotificationItem {
     readonly id: string;
     readonly title: string;
@@ -7241,6 +7611,7 @@ interface SceNotificationItem {
     readonly icon?: string;
     readonly actions?: readonly SceNotificationAction[];
 }
+/** Which notifications the list shows: everything, or only unread ones. */
 type SceNotificationFilter = 'all' | 'unread';
 
 /** Slide-in notification drawer with all/unread filtering and per-item actions. */
@@ -7275,6 +7646,7 @@ declare class SceNotificationListComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceNotificationListComponent, "sce-notification-list", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "notifications": { "alias": "notifications"; "required": true; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "notificationSelect": "notificationSelect"; "actionSelect": "actionSelect"; "markAsRead": "markAsRead"; "markAllAsRead": "markAllAsRead"; }, never, never, true, never>;
 }
 
+/** Whether the save-filter popup is naming a new filter or renaming an existing one (edit mode also offers Delete). */
 type SaveFilterMode = 'add' | 'edit';
 /** Names (or renames) a saved table filter. Open/close is driven by `PopupModalBase`. */
 declare class SceSaveFilterPopupComponent extends PopupModalBase {
@@ -7311,12 +7683,16 @@ declare class SceStoreLocationsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceStoreLocationsComponent, "sce-store-locations", never, { "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "showHeader": { "alias": "showHeader"; "required": false; "isSignal": true; }; "locations": { "alias": "locations"; "required": false; "isSignal": true; }; "selectedLocationId": { "alias": "selectedLocationId"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, { "locationSelect": "locationSelect"; }, never, never, true, never>;
 }
 
+/** Lifecycle stage of a support ticket thread. */
 type SceSupportThreadStatus = 'draft' | 'new' | 'under-review' | 'replied' | 'closed';
+/** Which side authored a thread response, which determines the bubble's alignment and styling. */
 type SceSupportResponderRole = 'support' | 'beneficiary';
+/** A file already attached to a support response, referenced by download `url`. */
 interface SceSupportThreadAttachment {
     readonly name: string;
     readonly url: string;
 }
+/** One message in a support thread: responder name and role, date, body, and any attachments. */
 interface SceSupportThreadResponse {
     readonly id: string;
     readonly responderName: string;
@@ -7325,10 +7701,12 @@ interface SceSupportThreadResponse {
     readonly message: string;
     readonly attachments?: readonly SceSupportThreadAttachment[];
 }
+/** Payload emitted when the user submits a reply; attachments are still raw `File` objects, not yet uploaded. */
 interface SceSupportThreadReply {
     readonly message: string;
     readonly attachments: readonly File[];
 }
+/** Payload emitted when the user rates whether the support response was helpful, plus a free-text comment. */
 interface SceSupportThreadFeedback {
     readonly isHelpful: boolean;
     readonly comment: string;
@@ -7379,6 +7757,7 @@ declare class SceSupportThreadComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceSupportThreadComponent, "sce-support-thread", never, { "responses": { "alias": "responses"; "required": true; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "canReply": { "alias": "canReply"; "required": false; "isSignal": true; }; "canGiveFeedback": { "alias": "canGiveFeedback"; "required": false; "isSignal": true; }; }, { "replySubmit": "replySubmit"; "feedbackSubmit": "feedbackSubmit"; }, never, never, true, never>;
 }
 
+/** One selectable user in the user-dropdown picker; both `name` and `subLabel` are matched by its search box. */
 interface SceUserDropdownItem {
     readonly id: string;
     readonly name: string;
@@ -7448,13 +7827,16 @@ declare class SceArticleDetailComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceArticleDetailComponent, "sce-article-detail", never, { "titleKey": { "alias": "titleKey"; "required": true; "isSignal": true; }; "contentKey": { "alias": "contentKey"; "required": true; "isSignal": true; }; "contentHtml": { "alias": "contentHtml"; "required": false; "isSignal": true; }; "videoSrc": { "alias": "videoSrc"; "required": false; "isSignal": true; }; "heroImageSrc": { "alias": "heroImageSrc"; "required": false; "isSignal": true; }; "isRated": { "alias": "isRated"; "required": false; "isSignal": true; }; "canGiveFeedback": { "alias": "canGiveFeedback"; "required": false; "isSignal": true; }; }, { "feedback": "feedback"; }, never, never, true, never>;
 }
 
+/** Colour of a tag chip in an article tag cloud. */
 type SceArticleTagVariant = 'brand' | 'accent' | 'info' | 'neutral';
+/** One tag chip: either a literal `label` or a `labelKey` to translate (which wins), plus an optional `variant` — omit it and the list assigns one by cycling. */
 interface SceArticleTagItem {
     /** Literal label. Ignored when `labelKey` is set. */
     readonly label?: string;
     readonly labelKey?: string;
     readonly variant?: SceArticleTagVariant;
 }
+/** Titled tag cloud for knowledge articles; any tag without an explicit variant is assigned one by cycling through brand, accent and info so the cloud stays visually varied. */
 declare class SceArticleTagsListComponent {
     readonly items: _angular_core.InputSignal<readonly SceArticleTagItem[]>;
     readonly titleKey: _angular_core.InputSignal<string>;
@@ -7513,12 +7895,15 @@ declare class SceArticlePageComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SceArticlePageComponent, "sce-article-page", never, { "titleKey": { "alias": "titleKey"; "required": true; "isSignal": true; }; "breadcrumbItems": { "alias": "breadcrumbItems"; "required": false; "isSignal": true; }; "showPageHeader": { "alias": "showPageHeader"; "required": false; "isSignal": true; }; "videoSrc": { "alias": "videoSrc"; "required": false; "isSignal": true; }; "heroImageSrc": { "alias": "heroImageSrc"; "required": false; "isSignal": true; }; "contentKey": { "alias": "contentKey"; "required": true; "isSignal": true; }; "contentHtml": { "alias": "contentHtml"; "required": false; "isSignal": true; }; "accordionItems": { "alias": "accordionItems"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "relatedItems": { "alias": "relatedItems"; "required": false; "isSignal": true; }; "tags": { "alias": "tags"; "required": false; "isSignal": true; }; "tagsTitleKey": { "alias": "tagsTitleKey"; "required": false; "isSignal": true; }; "relatedTitleKey": { "alias": "relatedTitleKey"; "required": false; "isSignal": true; }; "timelineItems": { "alias": "timelineItems"; "required": false; "isSignal": true; }; "isRated": { "alias": "isRated"; "required": false; "isSignal": true; }; "canGiveFeedback": { "alias": "canGiveFeedback"; "required": false; "isSignal": true; }; }, { "feedback": "feedback"; }, never, ["[articleSupport]"], true, never>;
 }
 
+/** Shape of a sidebar nav badge: a circular numeric pill (`count`) or a text pill (`label`). */
 type SceNavBadgeVariant = 'count' | 'label';
+/** A leaf entry nested under a `SceNavItem`; always routes somewhere. */
 interface SceNavChildItem {
     /** i18n key or literal. */
     readonly label: string;
     readonly route: string;
 }
+/** A top-level sidebar entry: icon plus label, optionally routing directly, carrying a badge, or expanding into `children`. */
 interface SceNavItem {
     readonly label: string;
     readonly icon: string;
@@ -7528,11 +7913,13 @@ interface SceNavItem {
     readonly badgeVariant?: SceNavBadgeVariant;
     readonly children?: readonly SceNavChildItem[];
 }
+/** A titled group of sidebar nav items. */
 interface SceNavSection {
     /** i18n key or literal for the section heading. */
     readonly title: string;
     readonly items: readonly SceNavItem[];
 }
+/** Branding block at the top of the sidebar: platform title, optional signed-in role, and logo. */
 interface SceSidebarBrand {
     /** i18n key or literal for the platform name. */
     readonly title: string;