iss-ctrl 0.0.12 → 0.0.14

package/types/iss-ctrl.d.ts

@@ -1,11 +1,11 @@
 import * as i0 from '@angular/core';
-import { InputSignal, WritableSignal, OutputEmitterRef, OnInit, OnDestroy, Signal, Type, DestroyRef, StaticProvider, InjectionToken, PipeTransform, Injector } from '@angular/core';
+import { InputSignal, WritableSignal, OutputEmitterRef, OnInit, OnDestroy, Signal, Type, DestroyRef, StaticProvider, InjectionToken, PipeTransform, Injector, Provider } from '@angular/core';
 import { ControlValueAccessor, Validator, FormControl, AbstractControl, ValidationErrors, FormGroup, ValidatorFn, AsyncValidatorFn, ControlContainer } from '@angular/forms';
 import { MatChipInputEvent } from '@angular/material/chips';
 import { MatDatepickerInputEvent } from '@angular/material/datepicker';
 import { PhoneNumber } from 'libphonenumber-js/mobile';
 import { Observable, BehaviorSubject } from 'rxjs';
-import { MatDateFormats } from '@angular/material/core';
+import { MatDateFormats, NativeDateAdapter } from '@angular/material/core';
 
 interface Option {
     value: string;
@@ -52,7 +52,9 @@ interface Hint {
  *
  * ### Content projection
  * Controls that render a `mat-form-field` project `<label>` into the floating label.
- * The label space collapses automatically when no `<label>` is supplied.
+ * An omitted label — or one that interpolates to an empty string — leaves `<mat-label>`
+ * empty, and `upgrade.scss` collapses the floating-label space for it. No label markup is
+ * removed at runtime, so a label that arrives later simply shows up.
  *
  * @example
  * ```html
@@ -116,16 +118,12 @@ declare class ControlBase implements ControlValueAccessor, Validator {
      */
     onChange: OutputEmitterRef<any>;
     protected ctrl: FormControl;
-    protected hasLabel: WritableSignal<boolean>;
-    private hostRef;
-    constructor();
     registerOnChange(fn: () => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     writeValue(value: string | FormData | Date | null): void;
     markAsTouched(): void;
     validate(control: AbstractControl): ValidationErrors | null;
-    private hasProjectedLabel;
     protected onTouch: () => void;
     protected onPropagateValue: (_: any) => void;
     protected emitValue(value?: any): void;
@@ -228,6 +226,14 @@ declare class ChipsControl extends ControlBase {
  * | `minDate` | `Date \| null` | `null` | Earliest selectable date. |
  * | `maxDate` | `Date \| null` | `null` | Latest selectable date. |
  * | `disabledDays` | `number[]` | `[]` | Week days to block, `0` = Sunday … `6` = Saturday. |
+ * | `hijriCalendar` | `boolean` | `false` | Shows an Umm al-Qura Hijri calendar; the value stays Gregorian. |
+ * | `emitHijri` | `boolean` | `false` | Emits the Hijri date instead of the Gregorian one. Implies `hijriCalendar`. |
+ *
+ * ### Hijri dates
+ * `hijriCalendar` only changes what the user sees: the calendar is Hijri, the input reads
+ * `dd/MM/yyyy` in Hijri, and a day shown as `16/03/1447` is still emitted as `2025-09-08`.
+ * Turn on `emitHijri` as well when the form value itself has to be the Hijri date. `minDate` and
+ * `maxDate` stay Gregorian in both cases — they are bounds on a day, not on a notation.
  *
  * ### Inherited from {@link ControlBase}
  * `formControlName` · `readonly` · `className` · `(onChange)`
@@ -235,6 +241,7 @@ declare class ChipsControl extends ControlBase {
  * Projects `<label>` into the floating label; omit it to render the control without one.
  */
 declare class DatePickerControl extends ControlBase implements Validator {
+    #private;
     /**
      * Week days that cannot be selected — `0` is Sunday through `6` for Saturday.
      */
@@ -247,12 +254,25 @@ declare class DatePickerControl extends ControlBase implements Validator {
      * Latest selectable date.
      */
     maxDate: InputSignal<Date | null>;
+    /**
+     * Renders the calendar as an Umm al-Qura Hijri calendar, leaving the emitted value Gregorian.
+     */
+    hijriCalendar: InputSignal<boolean>;
+    /**
+     * Emits the picked date as a Hijri `yyyy-MM-dd` string. Implies {@link hijriCalendar}.
+     */
+    emitHijri: InputSignal<boolean>;
+    /**
+     * Whether this picker is currently showing the Hijri calendar.
+     */
+    isHijri(): boolean;
+    writeValue(value: string | Date | null): void;
     clear(event: MouseEvent): void;
     protected calendarDaysFilter: (d: Date | null) => boolean;
     protected emit($event: MatDatepickerInputEvent<any>): void;
     protected openPicker(picker: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerControl, "iss-ctrl-date-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; }, {}, never, ["label"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerControl, "iss-ctrl-date-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "hijriCalendar": { "alias": "hijriCalendar"; "required": false; "isSignal": true; }; "emitHijri": { "alias": "emitHijri"; "required": false; "isSignal": true; }; }, {}, never, ["label"], true, never>;
 }
 
 interface DateRangeEmission {
@@ -281,6 +301,13 @@ interface DateRangeEmission {
  * | `minDate` | `Date \| null` | `null` | Earliest selectable date. |
  * | `maxDate` | `Date \| null` | `null` | Latest selectable date. |
  * | `disabledDays` | `number[]` | `[]` | Week days to block, `0` = Sunday … `6` = Saturday. |
+ * | `hijriCalendar` | `boolean` | `false` | Shows an Umm al-Qura Hijri calendar; the value stays Gregorian. |
+ * | `emitHijri` | `boolean` | `false` | Emits both endpoints as Hijri dates. Implies `hijriCalendar`. |
+ *
+ * ### Hijri dates
+ * `hijriCalendar` only changes what the user sees; the emitted range stays Gregorian until
+ * `emitHijri` is on as well, at which point both endpoints carry Hijri dates. `duration` is
+ * a count of days either way, and `minDate`/`maxDate` stay Gregorian.
  *
  * ### Inherited from {@link ControlBase}
  * `formControlName` · `readonly` · `className` · `(onChange)`
@@ -304,6 +331,14 @@ declare class DateRangePickerControl extends ControlBase implements OnInit, OnDe
      * Latest selectable date.
      */
     maxDate: InputSignal<Date | null>;
+    /**
+     * Renders the calendar as an Umm al-Qura Hijri calendar, leaving the emitted range Gregorian.
+     */
+    hijriCalendar: InputSignal<boolean>;
+    /**
+     * Emits both endpoints as Hijri dates. Implies {@link hijriCalendar}.
+     */
+    emitHijri: InputSignal<boolean>;
     /**
      * Emits the selected range as an object, or `null` while the range is incomplete.
      */
@@ -312,15 +347,19 @@ declare class DateRangePickerControl extends ControlBase implements OnInit, OnDe
      * The `start`/`end` form group backing the range input. Internal state.
      */
     readonly range: FormGroup;
+    /**
+     * Whether this picker is currently showing the Hijri calendar.
+     */
+    isHijri(): boolean;
     ngOnInit(): void;
     setDisabledState(isDisabled: boolean): void;
     clear(event: MouseEvent): void;
-    protected openPicker(picker: any): void;
     writeValue(value: string | FormData | null): void;
     ngOnDestroy(): void;
+    protected openPicker(picker: any): void;
     protected calendarDaysFilter: (d: Date | null) => boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<DateRangePickerControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DateRangePickerControl, "iss-ctrl-date-range-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; }, { "onDateRangeObjectChange": "onDateRangeObjectChange"; }, never, ["label"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DateRangePickerControl, "iss-ctrl-date-range-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "hijriCalendar": { "alias": "hijriCalendar"; "required": false; "isSignal": true; }; "emitHijri": { "alias": "emitHijri"; "required": false; "isSignal": true; }; }, { "onDateRangeObjectChange": "onDateRangeObjectChange"; }, never, ["label"], true, never>;
 }
 
 /**
@@ -344,6 +383,12 @@ declare class DateRangePickerControl extends ControlBase implements OnInit, OnDe
  * | `minTime` | `string \| null` | `null` | Earliest selectable time, `HH:mm`. |
  * | `maxTime` | `string \| null` | `null` | Latest selectable time, `HH:mm`. |
  * | `disabledDays` | `number[]` | `[]` | Week days to block, `0` = Sunday … `6` = Saturday. |
+ * | `hijriCalendar` | `boolean` | `false` | Shows an Umm al-Qura Hijri calendar; the value stays Gregorian. |
+ * | `emitHijri` | `boolean` | `false` | Emits the date half as a Hijri date. Implies `hijriCalendar`. |
+ *
+ * ### Hijri dates
+ * Both flags are handed straight to the inner date picker; the time half is untouched, so a
+ * Hijri value reads `1447-03-15T09:30:00`.
  *
  * ### Inherited from {@link ControlBase}
  * `formControlName` · `readonly` · `className` · `(onChange)`
@@ -373,11 +418,19 @@ declare class DatetimePickerControl extends ControlBase {
      * Latest selectable time of day, as `HH:mm`.
      */
     maxTime: InputSignal<string | null>;
+    /**
+     * Renders the calendar as an Umm al-Qura Hijri calendar, leaving the emitted date Gregorian.
+     */
+    hijriCalendar: InputSignal<boolean>;
+    /**
+     * Emits the date half of the value as a Hijri date. Implies {@link hijriCalendar}.
+     */
+    emitHijri: InputSignal<boolean>;
     setDisabledState(isDisabled: boolean): void;
     emit(): void;
     writeValue(value: string | Date | null): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DatetimePickerControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DatetimePickerControl, "iss-ctrl-datetime-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; }, {}, never, ["label"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DatetimePickerControl, "iss-ctrl-datetime-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "hijriCalendar": { "alias": "hijriCalendar"; "required": false; "isSignal": true; }; "emitHijri": { "alias": "emitHijri"; "required": false; "isSignal": true; }; }, {}, never, ["label"], true, never>;
 }
 
 interface IssAttachment {
@@ -903,7 +956,7 @@ declare class FieldAsyncValidation {
  * ### Keys by area
  * - **Common:** `type` · `disabled` · `readonly` · `placeholder` · `suffix` · `hideLabel` · `multiple`
  * - **Bounds:** `min` · `max` · `minLength` · `maxLength`
- * - **Dates:** `minDate` · `maxDate` · `dateFilter`
+ * - **Dates:** `minDate` · `maxDate` · `dateFilter` · `hijriCalendar` · `emitHijri`
  * - **Attachments:** `allowedFileSize` · `allowedFileTypes` · `minFilesCount` · `maxFilesCount` · `templateId` · `templateUrl`
  * - **Users:** `minUsersCount` · `maxUsersCount`
  * - **Table:** `showInTableColumns` · `tableWithFilter` · `tableWithSort` · `tableWithPagination`
@@ -970,6 +1023,18 @@ declare class FieldConfig {
      * Restricts the calendar to working days. Source: `config.acceptWorkDaysOnly`.
      */
     dateFilter: WritableSignal<boolean | undefined>;
+    /**
+     * Renders the calendar as an Umm al-Qura Hijri calendar. The emitted value stays Gregorian
+     * unless {@link FieldConfig.emitHijri} is also on. Source: `config.hijriCalendar`, also
+     * accepted as `config.HijriCalendar`.
+     */
+    hijriCalendar: WritableSignal<boolean | undefined>;
+    /**
+     * Emits the picked date as a Hijri date instead of a Gregorian one — the same day emitted
+     * as `1447-03-16` rather than `2025-09-08`. Implies {@link FieldConfig.hijriCalendar}: a
+     * Hijri value is always picked from a Hijri calendar.
+     */
+    emitHijri: WritableSignal<boolean | undefined>;
     /**
      * Id of a downloadable template offered next to an attachment field.
      */
@@ -1635,6 +1700,8 @@ declare class TimePickerField extends FieldBase {
  * | `minDate` | `Date` | Earliest selectable date. |
  * | `maxDate` | `Date` | Latest selectable date. |
  * | `readonly` | `boolean` | Shows the value but blocks interaction. |
+ * | `hijriCalendar` | `boolean` | Renders an Umm al-Qura Hijri calendar while the emitted value stays Gregorian. |
+ * | `emitHijri` | `boolean` | Emits the Hijri date instead of the Gregorian one. Implies `hijriCalendar`. |
  *
  * ### Other field members used
  * `label()`
@@ -1664,6 +1731,8 @@ declare class DatePickerField extends FieldBase {
  * | `minDate` | `Date` | Earliest selectable date. |
  * | `maxDate` | `Date` | Latest selectable date. |
  * | `readonly` | `boolean` | Shows the value but blocks interaction. |
+ * | `hijriCalendar` | `boolean` | Renders an Umm al-Qura Hijri calendar while the emitted value stays Gregorian. |
+ * | `emitHijri` | `boolean` | Emits the Hijri date instead of the Gregorian one. Implies `hijriCalendar`. |
  *
  * ### Other field members used
  * `label()`
@@ -1693,6 +1762,8 @@ declare class DatetimePickerField extends FieldBase {
  * | `minDate` | `Date` | Earliest selectable date. |
  * | `maxDate` | `Date` | Latest selectable date. |
  * | `readonly` | `boolean` | Shows the value but blocks interaction. |
+ * | `hijriCalendar` | `boolean` | Renders an Umm al-Qura Hijri calendar while the emitted value stays Gregorian. |
+ * | `emitHijri` | `boolean` | Emits the Hijri date instead of the Gregorian one. Implies `hijriCalendar`. |
  *
  * ### Other field members used
  * `label()`
@@ -1794,18 +1865,21 @@ declare class TimePickerViewer extends ViewerBase {
 }
 
 declare class DatePickerViewer extends ViewerBase {
+    protected hijriDate: Signal<string | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerViewer, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerViewer, "iss-viewer-date-picker", never, {}, {}, never, never, true, never>;
 }
 
 declare class DatePickerTimeViewer extends ViewerBase {
     protected readonly DATETIME_FORMAT = "dd/MM/yyyy hh:mm a";
+    protected hijriDatetime: Signal<string | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerTimeViewer, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerTimeViewer, "iss-viewer-datetime-picker", never, {}, {}, never, never, true, never>;
 }
 
 declare class DateRangePickerViewer extends ViewerBase implements OnInit {
     dateRange: string[];
+    hijriDates: (string | null)[];
     ngOnInit(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DateRangePickerViewer, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DateRangePickerViewer, "iss-viewer-date-range-picker", never, {}, {}, never, never, true, never>;
@@ -1965,12 +2039,137 @@ declare class Employee {
     static ɵprov: i0.ɵɵInjectableDeclaration<Employee>;
 }
 
+/**
+ * The single date adapter behind every `iss-ctrl-*` picker.
+ *
+ * It behaves as a plain Gregorian adapter — `dd/MM/yyyy` in and out — until its locale is
+ * switched to {@link HIJRI_LOCALE}, at which point the whole calendar grid becomes Umm
+ * al-Qura Hijri: the month lengths, the year and month labels and the day numbers all come
+ * from the Hijri calendar.
+ *
+ * The value never changes shape. The adapter always works on a `Date`, so a Hijri calendar
+ * still hands the control an ordinary `Date`, and it stays the control's decision whether to
+ * emit that as a Gregorian or a Hijri string.
+ *
+ * Switch modes through {@link setHijri}, never by assigning `locale` — `setLocale` is what
+ * tells an open calendar to re-render.
+ */
+declare class IssDateAdapter extends NativeDateAdapter {
+    #private;
+    /** The Gregorian locale to fall back to when the Hijri calendar is turned off. */
+    gregorianLocale: string;
+    /** Whether the adapter is currently presenting the Hijri calendar. */
+    get isHijri(): boolean;
+    /**
+     * Turns the Hijri calendar on or off. Goes through `setLocale` so that a calendar that is
+     * already open redraws itself.
+     */
+    setHijri(hijri: boolean): void;
+    getYear(date: Date): number;
+    getMonth(date: Date): number;
+    getDate(date: Date): number;
+    getMonthNames(style: "long" | "short" | "narrow"): string[];
+    getDateNames(): string[];
+    getDayOfWeekNames(style: "long" | "short" | "narrow"): string[];
+    getYearName(date: Date): string;
+    getFirstDayOfWeek(): number;
+    getNumDaysInMonth(date: Date): number;
+    createDate(year: number, month: number, date: number): Date;
+    addCalendarYears(date: Date, years: number): Date;
+    addCalendarMonths(date: Date, months: number): Date;
+    addCalendarDays(date: Date, days: number): Date;
+    parse(value: any, parseFormat?: any): Date | null;
+    format(date: Date, displayFormat: string): string;
+    deserialize(value: any): Date | null;
+    toIso8601(date: Date): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IssDateAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<IssDateAdapter>;
+}
+/**
+ * Providers every date-based control needs: the {@link IssDateAdapter} itself, the Gregorian
+ * locale it falls back to, and the `dd/MM/yyyy` formats both of its calendars are rendered in.
+ *
+ * Declared per component, so each picker owns its adapter instance and one field switching to
+ * the Hijri calendar leaves every other field on the form alone.
+ */
+declare function provideIssDateAdapter(): Provider[];
+
 declare function arrayFrom<T>(length: number, valueFunction: (index: number) => T): T[];
 
 declare function formatFileSize(x: string | number): string;
 
 declare function getPropertyByPath(obj: any, path: string | undefined): any;
 
+/**
+ * Umm al-Qura Hijri calendar helpers.
+ *
+ * Every function here works on a plain `Date`: a `Date` is an instant, and the Hijri
+ * calendar is only another way of naming that instant. Nothing stores Hijri numbers on the
+ * date itself, so a value converted to Hijri for display or emission is still the same day.
+ *
+ * The conversion is done by `Intl` with the `islamic-umalqura` calendar, which is the
+ * calendar used officially in Saudi Arabia.
+ */
+/** Locale used by the calendar UI when the Hijri calendar is on. */
+declare const HIJRI_LOCALE = "ar-SA-u-ca-islamic-umalqura";
+declare const HIJRI_MONTH_NAMES: {
+    ar: string[];
+    en: string[];
+    enShort: string[];
+};
+interface HijriParts {
+    /** Hijri year, for example `1447`. */
+    year: number;
+    /** Hijri month, **zero based** like `Date.getMonth()` — `0` is Muharram. */
+    month: number;
+    /** Hijri day of month, starting at `1`. */
+    day: number;
+}
+/**
+ * Reads the Hijri year, month and day a `Date` falls on.
+ */
+declare function getHijriParts(date: Date): HijriParts;
+/**
+ * The Gregorian `Date` of the first day of the Hijri month `date` falls in, at midday.
+ *
+ * Midday, not midnight, so a daylight-saving shift can never push the result into the
+ * previous day while the month is being walked.
+ */
+declare function startOfHijriMonth(date: Date): Date;
+/**
+ * Number of days in the Hijri month `date` falls in — 29 or 30, decided by Umm al-Qura.
+ */
+declare function getHijriDaysInMonth(date: Date): number;
+/**
+ * Builds the `Date` for a Hijri year/month/day. The month is zero based, and a day past the
+ * end of the month is clamped to the last day of that month.
+ */
+declare function createHijriDate(year: number, month: number, day: number): Date;
+/**
+ * Formats a date as a Hijri `yyyy-MM-dd` string — the shape the form emits when
+ * `emitHijri` is on.
+ */
+declare function formatHijriDate(date: Date): string;
+/**
+ * Reads a Hijri date back into a `Date`, accepting both the emitted `yyyy-MM-dd` shape and
+ * the `dd/MM/yyyy` shape shown in the input. Returns `null` for anything else.
+ */
+declare function parseHijriDate(value: string | null | undefined): Date | null;
+/**
+ * Renders a stored form value as a Hijri `dd/MM/yyyy` string for the read-only viewers, or
+ * returns `null` when the field is not on the Hijri calendar and the value should be shown
+ * as an ordinary Gregorian date.
+ *
+ * The two Hijri modes store different things, so they are read differently: with `emitHijri`
+ * the value already carries Hijri numbers and only its notation changes, while with
+ * `hijriCalendar` alone the value is Gregorian and has to be converted.
+ */
+declare function toHijriDisplay(value: string | null | undefined, options: {
+    hijriCalendar?: boolean;
+    emitHijri?: boolean;
+    withTime?: boolean;
+}): string | null;
+
 declare function replacePlaceholders(str: string, values: any): string;
 
 declare abstract class IssValidators {
@@ -1997,5 +2196,5 @@ declare abstract class TimeValidator {
     static afterDate(field: IssField): ValidatorFn;
 }
 
-export { ATTACHMENT_DOWNLOAD_URL, ATTACHMENT_UPLOAD_RESPONSE_MAPPER, ATTACHMENT_UPLOAD_URL, ArabicNumberPipe, AttachmentViewer, COMPONENTS, COUNTRIES, CheckboxControl, CheckboxField, CheckboxViewer, ChipsControl, ChipsField, ChipsViewer, ControlBase, DATETIME_FORMAT, DATE_FORMAT_ADAPTER, DEFAULT_COUNTRY, DatePickerControl, DatePickerField, DatePickerTimeViewer, DatePickerViewer, DateRangePickerControl, DateRangePickerField, DateRangePickerViewer, DatetimePickerControl, DatetimePickerField, Droppable, Employee, FIELD_DATA, FieldBase, FieldDataInjector, FileHandler, FilePickerControl, FilePickerField, FileValidators, FormEngine, HOST, HintsComponent, InputControl, InputField, InputViewer, IssValidators, Loader, MobileControl, MobileField, MobileViewer, Outlet, PLACEHOLDER_REGEX, PLATE_LETTERS, Phone, PlateControl, PlateField, PlateLetterPipe, PlateViewer, RadioControl, RadioField, RadioViewer, SERVICES, SelectControl, SelectField, SelectStatusPipe, SelectViewer, SlideToggleControl, SlideToggleField, SlideToggleViewer, TextareaControl, TextareaField, TextareaViewer, TimePickerControl, TimePickerField, TimePickerViewer, TimeValidator, ToggleButtonControl, ToggleButtonField, ToggleButtonViewer, TranslatePipe, UI_LANGUAGE, USER_SEARCH_API, VALIDATION_MESSAGES, VALIDATORS, VIEW_PROVIDER, ValidationMessageComponent, arrayFrom, formatFileSize, getPropertyByPath, replacePlaceholders };
-export type { ActionTriggerFn, ComponentOutlet, Country, DateRangeEmission, DynamicImport, EventArgument, EventConfigFn, EventStrategy, FieldChange, Hint, HintAlignment, I18n, ISO2, IssAttachment, IssFile, Mobile, Option, PlateLetter, ValidationMessage, ValidationMessageFn };
+export { ATTACHMENT_DOWNLOAD_URL, ATTACHMENT_UPLOAD_RESPONSE_MAPPER, ATTACHMENT_UPLOAD_URL, ArabicNumberPipe, AttachmentViewer, COMPONENTS, COUNTRIES, CheckboxControl, CheckboxField, CheckboxViewer, ChipsControl, ChipsField, ChipsViewer, ControlBase, DATETIME_FORMAT, DATE_FORMAT_ADAPTER, DEFAULT_COUNTRY, DatePickerControl, DatePickerField, DatePickerTimeViewer, DatePickerViewer, DateRangePickerControl, DateRangePickerField, DateRangePickerViewer, DatetimePickerControl, DatetimePickerField, Droppable, Employee, FIELD_DATA, FieldBase, FieldDataInjector, FileHandler, FilePickerControl, FilePickerField, FileValidators, FormEngine, HIJRI_LOCALE, HIJRI_MONTH_NAMES, HOST, HintsComponent, InputControl, InputField, InputViewer, IssDateAdapter, IssValidators, Loader, MobileControl, MobileField, MobileViewer, Outlet, PLACEHOLDER_REGEX, PLATE_LETTERS, Phone, PlateControl, PlateField, PlateLetterPipe, PlateViewer, RadioControl, RadioField, RadioViewer, SERVICES, SelectControl, SelectField, SelectStatusPipe, SelectViewer, SlideToggleControl, SlideToggleField, SlideToggleViewer, TextareaControl, TextareaField, TextareaViewer, TimePickerControl, TimePickerField, TimePickerViewer, TimeValidator, ToggleButtonControl, ToggleButtonField, ToggleButtonViewer, TranslatePipe, UI_LANGUAGE, USER_SEARCH_API, VALIDATION_MESSAGES, VALIDATORS, VIEW_PROVIDER, ValidationMessageComponent, arrayFrom, createHijriDate, formatFileSize, formatHijriDate, getHijriDaysInMonth, getHijriParts, getPropertyByPath, parseHijriDate, provideIssDateAdapter, replacePlaceholders, startOfHijriMonth, toHijriDisplay };
+export type { ActionTriggerFn, ComponentOutlet, Country, DateRangeEmission, DynamicImport, EventArgument, EventConfigFn, EventStrategy, FieldChange, HijriParts, Hint, HintAlignment, I18n, ISO2, IssAttachment, IssFile, Mobile, Option, PlateLetter, ValidationMessage, ValidationMessageFn };

package/upgrade.scss

@@ -54,6 +54,22 @@ mat-form-field.mat-mdc-form-field:has(mat-label) .mat-mdc-form-field-infix {
   padding-top: 10px !important;
 }
 
+// mat-form-field always renders its floating label, so a control whose label is omitted or
+// interpolates to "" would keep the space above the input. Both cases leave an :empty element
+// — <mat-label> itself when nothing is projected, the projected <label> when its text is empty
+// — which is what these selectors collapse. Keep <mat-label> free of whitespace in templates,
+// or it is never :empty.
+mat-form-field.mat-mdc-form-field:has(mat-label:empty),
+mat-form-field.mat-mdc-form-field:has(mat-label > label:empty) {
+  .mdc-floating-label {
+    display: none !important;
+  }
+
+  .mat-mdc-form-field-infix {
+    padding-top: 0 !important;
+  }
+}
+
 
 mat-form-field.mat-mdc-form-field
 .mat-mdc-input-element::placeholder {