siemens · spliffone · Jul 31, 2026
@@ -69,7 +69,6 @@ export class SiFormFieldsetComponent {
 // @public (undocumented)
 export class SiFormItemComponent implements AfterContentInit, AfterContentChecked, OnChanges, OnInit, OnDestroy, SiFormFieldsetControl {
     readonly disableErrorPrinting: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    // (undocumented)
     readonly formErrorMapper: _angular_core.InputSignal<SiFormValidationErrorMapper | undefined>;
     readonly label: _angular_core.InputSignal<TranslatableString>;
     readonly labelWidth: _angular_core.InputSignal<string | number | undefined>;
@@ -168,7 +167,6 @@ export interface SiFormValidationErrorMapper {
 // @public
 export class SiFormValidationTooltipDirective implements DoCheck {
     constructor();
-    // (undocumented)
     readonly formErrorMapper: _angular_core.InputSignal<SiFormValidationErrorMapper | undefined>;
 }
 

@@ -32,11 +32,9 @@ export class SiFormlyComponent<TControl extends {
     readonly fields: _angular_core.InputSignal<FormlyFieldConfig<_ngx_formly_core.FormlyFieldProps & {
         [additionalProperties: string]: any;
     }>[]>;
-    // (undocumented)
     readonly fieldsChange: _angular_core.OutputEmitterRef<FormlyFieldConfig<_ngx_formly_core.FormlyFieldProps & {
         [additionalProperties: string]: any;
     }>[]>;
-    // (undocumented)
     readonly form: _angular_core.ModelSignal<FormGroup<TControl> | undefined>;
     readonly formlyForm: _angular_core.Signal<FormlyForm | undefined>;
     readonly labelWidth: _angular_core.InputSignal<number | undefined>;

@@ -47,7 +47,6 @@ export class SiIconModule {
 
 // @public (undocumented)
 export class SiStatusIconComponent {
-    // (undocumented)
     readonly status: _angular_core.InputSignal<EntityStatusType>;
 }
 

@@ -90,6 +90,7 @@ export class SiFormItemComponent
    */
   readonly disableErrorPrinting = input(false, { transform: booleanAttribute });
 
+  /** Maps validation errors of the contained control to custom messages. */
   readonly formErrorMapper = input<SiFormValidationErrorMapper>();
 
   /**

@@ -49,6 +49,7 @@ export class SiFormValidationTooltipDirective implements DoCheck {
   private tooltipService = inject(SiTooltipService);
   private formValidationService = inject(SiFormValidationErrorService);
   private formContainer = inject(SiFormContainerComponent, { optional: true });
+  /** Maps validation errors of the associated form control to custom tooltip messages. */
   readonly formErrorMapper = input<SiFormValidationErrorMapper>();
   private ngControl = inject(NgControl);
   private elementRef = inject(ElementRef);

@@ -47,6 +47,7 @@ export class SiFormlyComponent<
    */
   readonly formlyForm = viewChild(FormlyForm);
 
+  /** Reactive form used by Formly. A form is created when none is provided. */
   readonly form = model<FormGroup<TControl>>();
   /**
    * Mapping of field name and its value.
@@ -80,9 +81,10 @@ export class SiFormlyComponent<
   // eslint-disable-next-line @angular-eslint/prefer-signal-model
   readonly fields = input<FormlyFieldConfig[]>([]);
 
+  /** Emits the effective field configuration, including configuration generated from `schema`. */
   readonly fieldsChange = output<FormlyFieldConfig[]>();
 
-  /** Define width for field labels in pixel */
+  /** Width in pixels applied to field labels. */
   readonly labelWidth = input<number | undefined>();
 
   protected readonly fieldConfig = computed<FormlyFieldConfig[]>(() => {

@@ -11,6 +11,7 @@ import { SI_FORM_ITEM_CONTROL, SiFormItemControl } from '@siemens/element-ng/for
   providers: [{ provide: SI_FORM_ITEM_CONTROL, useExisting: SiFormlyFormFieldProviderDirective }]
 })
 export class SiFormlyFormFieldProviderDirective implements SiFormItemControl, OnChanges {
+  /** Formly field configuration used to provide form-item control metadata. */
   readonly field = input.required<FormlyFieldConfig>();
 
   readonly id = computed(() => this.field().id);

@@ -30,6 +30,8 @@ import { SiHeaderDropdownComponent } from './si-header-dropdown.component';
   changeDetection: ChangeDetectionStrategy.Eager
 })
 export class SiHeaderDropdownItemsFactoryComponent {
+  /** Menu items rendered by this factory. */
   readonly items = input.required<MenuItem[]>();
+  /** Emits whether a generated dropdown item is active. */
   readonly activeChange = output<boolean>();
 }
@@ -60,9 +60,9 @@ class SiHeaderAnchorComponent {
 export class SiHeaderDropdownTriggerDirective implements OnChanges, OnInit, OnDestroy {
   private static idCounter = 0;
 
-  /** Template that be rendered inside the dropdown. */
+  /** Template rendered inside the dropdown. */
   readonly dropdown = input.required<TemplateRef<unknown>>({ alias: 'siHeaderDropdownTriggerFor' });
-  /** Data that should be passed as template context to the dropdown. */
+  /** Context data passed to the dropdown template. */
   readonly dropdownData = input<unknown>();
   /** Emits whenever a dropdown is opened or closed. */
   readonly openChange = output<boolean>();
@@ -122,7 +122,7 @@ export class SiHeaderDropdownTriggerDirective implements OnChanges, OnInit, OnDe
     });
   }
 
-  /** Whether the dropdown is open. */
+  /** Whether the dropdown is currently open. */
   get isOpen(): boolean {
     return this._isOpen;
   }

@@ -25,6 +25,7 @@ import { STATUS_ICON_CONFIG } from './status-icon';
 export class SiStatusIconComponent {
   private readonly statusIcons = inject(STATUS_ICON_CONFIG);
 
+  /** Status that determines the rendered stacked icon and accessible label. */
   readonly status = input.required<EntityStatusType>();
 
   protected readonly statusIcon = computed(() => this.statusIcons[this.status()]);
-Original file line number
+Diff line change
@@ Expand Up / @@ -90,6 +90,7 @@ export class SiFormItemComponent @@
        */
       readonly disableErrorPrinting = input(false, { transform: booleanAttribute });
+      /** Maps validation errors of the contained control to custom messages. */
       readonly formErrorMapper = input<SiFormValidationErrorMapper>();
       /**
@@ Expand Down @@