@openmfp/ngx 0.14.11 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmfp/ngx",
-  "version": "0.14.11",
+  "version": "0.16.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/openmfp/webcomponents.git"

package/types/openmfp-ngx.d.ts

@@ -111,7 +111,7 @@ interface ResourceFieldButtonClickEvent<T extends GenericResource> {
     /** Original DOM click event. */
     event: MouseEvent;
     /** The field definition of the button cell that was clicked. */
-    field: TableFieldDefinition;
+    field: FieldDefinition;
     /** The data row associated with the clicked button. */
     resource: T | undefined;
 }
@@ -119,7 +119,7 @@ interface ResourceFieldButtonClickEvent<T extends GenericResource> {
 interface FieldDefinition {
     /** Column header / form label. */
     label?: string;
-    /** Dot-separated path to the resource property (e.g. `metadata.name`). */
+    /** Dot-separated path to the resource property (e.g. `metadata.name`). For a collection field this is the path to the array itself (e.g. `status.conditions`). */
     property?: string | string[];
     /** Alternative path resolver with optional transforms. */
     propertyField?: PropertyField;
@@ -129,7 +129,14 @@ interface FieldDefinition {
     value?: string;
     /** Display and interaction configuration for this cell. */
     uiSettings?: UiSettings;
+    /**
+     * Sub-field definitions describing one entry of an array-of-objects field.
+     * When set, `property` points at the array; each sub-field describes one
+     * column/input of an entry. Mirrors `propertyField` naming for consistency.
+     */
+    propertyCollection?: FieldDefinition[];
 }
+
 /** Table column definition — extends `FieldDefinition` with optional column grouping. */
 interface TableFieldDefinition extends FieldDefinition {
     /** Groups this column visually with adjacent columns that share the same `name`. */
@@ -179,7 +186,7 @@ interface FormFieldDefinition {
     /** JSON-path key used to read and write the field value (e.g. `metadata.name`). */
     name: string;
     /** Display label shown above the input. */
-    label?: string;
+    label: string;
     /** When `true`, passes the `required` attribute to the UI5 input — shows a visual required indicator. Validation itself is the host's responsibility via `FormFieldErrors`. */
     required?: boolean;
     /** Fixed list of options rendered as a select/dropdown. */
@@ -188,6 +195,20 @@ interface FormFieldDefinition {
     disabled?: boolean;
     /** Controls when `fieldChange` is emitted for this field. When omitted, `fieldChange` is never emitted. */
     validation?: 'onBlur' | 'onChange';
+    /**
+     * Nested field definitions describing one item of an object collection.
+     *
+     * When set, this field represents an array of objects; the form renders it
+     * as a stack of expandable/collapsible cards. Each card is a nested
+     * `mfp-declarative-form` whose `fields` are the entries in
+     * `propertyCollection`; an inline Add button appends entries and a trash
+     * button removes them. Editing is live — no per-card Save/Cancel.
+     *
+     * The submitted value at this field's path is `Array<Record<string, unknown>>`,
+     * with each entry keyed by the sub-fields' `name`s. When `required` is
+     * `true`, the host is expected to require at least one entry in the array.
+     */
+    propertyCollection?: FormFieldDefinition[];
 }
 /** Event payload emitted each time a single form field value changes. */
 interface FormFieldChangeEvent {
@@ -205,20 +226,25 @@ declare class DeclarativeForm<T extends GenericResource> {
     readonly fieldErrors: _angular_core.InputSignal<FormFieldErrors>;
     readonly fieldChange: _angular_core.OutputEmitterRef<FormFieldChangeEvent>;
     readonly formSubmit: _angular_core.OutputEmitterRef<T>;
+    readonly formValueChange: _angular_core.OutputEmitterRef<Record<string, unknown>>;
     readonly form: FormGroup;
+    protected readonly collectionSeeds: _angular_core.WritableSignal<Record<string, Record<string, unknown>[]>>;
     private readonly fb;
     constructor();
     setFormControlValue($event: Event, field: FormFieldDefinition): void;
+    onCollectionValueChange(field: FormFieldDefinition, entries: Record<string, unknown>[]): void;
     getError(name: string): string | null;
     getValueState(name: string): 'None' | 'Negative';
     onFieldBlur(field: FormFieldDefinition): void;
     submit(): void;
     clear(): void;
+    collectionEntries(field: FormFieldDefinition): Record<string, unknown>[];
     private rebuildControls;
     private setInitialValues;
     private buildOutputValue;
+    private buildEntryGroup;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DeclarativeForm<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DeclarativeForm<any>, "mfp-declarative-form", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "initialValues": { "alias": "initialValues"; "required": false; "isSignal": true; }; "fieldErrors": { "alias": "fieldErrors"; "required": false; "isSignal": true; }; }, { "fieldChange": "fieldChange"; "formSubmit": "formSubmit"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DeclarativeForm<any>, "mfp-declarative-form", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "initialValues": { "alias": "initialValues"; "required": false; "isSignal": true; }; "fieldErrors": { "alias": "fieldErrors"; "required": false; "isSignal": true; }; }, { "fieldChange": "fieldChange"; "formSubmit": "formSubmit"; "formValueChange": "formValueChange"; }, never, never, true, never>;
 }
 
 /** Configuration for the create/edit resource form rendered inside the table card dialogs. */
@@ -1222,6 +1248,7 @@ declare class ResourceField<T extends GenericResource, F extends FieldDefinition
     tags: _angular_core.Signal<string[]>;
     isVisible: _angular_core.WritableSignal<boolean>;
     copySuccess: _angular_core.WritableSignal<boolean>;
+    isCollection: _angular_core.Signal<boolean>;
     toggleVisibility(e: Event): void;
     private normalizeBoolean;
     private normalizeString;
@@ -1325,4 +1352,4 @@ declare class WhatsNew {
 }
 
 export { BooleanValue, CARD_TYPES, Dashboard, DeclarativeForm, DeclarativeTable, DeclarativeTableCard, Favorites, LinkValue, ResourceField, SecretValue, ServiceStatusCard, TagListValue, VisitedServiceCard, WhatsNew };
-export type { ButtonSettings, CardConfig, CardsType, CssRule, DashboardButtonsSettings, DashboardConfig, DeleteResourceConfirmationConfig, FieldDefinition, FieldFilterDefinition, FormFieldChangeEvent, FormFieldDefinition, FormFieldErrors, GenericResource, IconDesignType, ModalSettings, MountCfg, PropertyField, ResourceFieldButtonClickEvent, ResourceFormConfig, RuleCondition, SectionConfig, ServiceStatusItem, ServiceStatusValue, TableCardButtonSettings, TableCardConfig, TableCardFormState, TableCardSearchConfig, TableConfig, TableFieldDefinition, TransformType, UiSettings, ValueRule };
+export type { ButtonSettings, CardConfig, CardsType, CssRule, DashboardButtonsSettings, DashboardConfig, DeleteResourceConfirmationConfig, FieldDefinition, FieldFilterDefinition, FormFieldChangeEvent, FormFieldDefinition, FormFieldErrors, GenericResource, IconDesignType, ModalSettings, MountCfg, PropertyField, ResourceFieldButtonClickEvent, ResourceFormConfig, RuleCondition, SectionConfig, ServiceStatusItem, ServiceStatusValue, TableCardButtonSettings, TableCardConfig, TableCardFormState, TableCardSearchConfig, TableConfig, TableFieldDefinition, TagSettings, TransformType, UiSettings, ValueRule };