@decaf-ts/for-angular 0.0.16 → 0.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/assets/i18n/en.json +10 -0
  2. package/assets/i18n/pt.json +149 -0
  3. package/assets/icons/icon-128.webp +0 -0
  4. package/assets/icons/icon-192.webp +0 -0
  5. package/assets/icons/icon-256.webp +0 -0
  6. package/assets/icons/icon-48.webp +0 -0
  7. package/assets/icons/icon-512.webp +0 -0
  8. package/assets/icons/icon-72.webp +0 -0
  9. package/assets/icons/icon-96.webp +0 -0
  10. package/assets/images/apple-touch-icon.png +0 -0
  11. package/assets/images/favicon.png +0 -0
  12. package/assets/images/favicon.svg +29 -0
  13. package/components/component-renderer/component-renderer.component.d.ts +5 -4
  14. package/components/crud-field/crud-field.component.d.ts +174 -19
  15. package/components/crud-form/crud-form.component.d.ts +170 -6
  16. package/components/fieldset/fieldset.component.d.ts +374 -36
  17. package/components/list/list.component.d.ts +1 -1
  18. package/components/list-item/list-item.component.d.ts +2 -2
  19. package/components/model-renderer/model-renderer.component.d.ts +1 -5
  20. package/directives/collapsable.directive.d.ts +1 -0
  21. package/engine/NgxBaseComponent.d.ts +6 -6
  22. package/engine/NgxCrudFormField.d.ts +5 -2
  23. package/engine/NgxFormService.d.ts +113 -12
  24. package/engine/NgxRenderingEngine.d.ts +150 -25
  25. package/engine/constants.d.ts +11 -6
  26. package/engine/decorators.d.ts +2 -2
  27. package/engine/index.d.ts +4 -2
  28. package/engine/interfaces.d.ts +261 -0
  29. package/engine/types.d.ts +3 -206
  30. package/esm2022/components/component-renderer/component-renderer.component.mjs +13 -11
  31. package/esm2022/components/crud-field/crud-field.component.mjs +193 -8
  32. package/esm2022/components/crud-form/crud-form.component.mjs +116 -11
  33. package/esm2022/components/empty-state/empty-state.component.mjs +3 -3
  34. package/esm2022/components/fieldset/fieldset.component.mjs +482 -43
  35. package/esm2022/components/filter/filter.component.mjs +3 -3
  36. package/esm2022/components/layout/layout.component.mjs +3 -3
  37. package/esm2022/components/list/list.component.mjs +4 -5
  38. package/esm2022/components/list-item/list-item.component.mjs +9 -9
  39. package/esm2022/components/model-renderer/model-renderer.component.mjs +9 -8
  40. package/esm2022/components/pagination/pagination.component.mjs +4 -4
  41. package/esm2022/components/searchbar/searchbar.component.mjs +3 -3
  42. package/esm2022/directives/collapsable.directive.mjs +3 -2
  43. package/esm2022/engine/NgxBaseComponent.mjs +28 -22
  44. package/esm2022/engine/NgxCrudFormField.mjs +14 -4
  45. package/esm2022/engine/NgxFormService.mjs +239 -27
  46. package/esm2022/engine/NgxRenderingEngine.mjs +202 -46
  47. package/esm2022/engine/ValidatorFactory.mjs +6 -4
  48. package/esm2022/engine/constants.mjs +14 -9
  49. package/esm2022/engine/decorators.mjs +6 -6
  50. package/esm2022/engine/index.mjs +5 -3
  51. package/esm2022/engine/interfaces.mjs +4 -0
  52. package/esm2022/engine/types.mjs +1 -3
  53. package/esm2022/helpers/utils.mjs +6 -2
  54. package/fesm2022/decaf-ts-for-angular.mjs +2909 -2130
  55. package/fesm2022/decaf-ts-for-angular.mjs.map +1 -1
  56. package/helpers/utils.d.ts +1 -0
  57. package/package.json +2 -1
  58. package/engine/NgxRenderingEngine2.d.ts +0 -250
  59. package/esm2022/engine/NgxRenderingEngine2.mjs +0 -332
  60. package/esm2022/interfaces.mjs +0 -2
  61. package/interfaces.d.ts +0 -28
@@ -1,6 +1,10 @@
1
- import { AfterViewInit, ElementRef } from '@angular/core';
2
- import { HTMLFormTarget } from '../../engine';
1
+ import { AfterViewInit, OnInit } from '@angular/core';
2
+ import { HandlerLike, HTMLFormTarget, KeyValue } from '../../engine';
3
3
  import { CrudOperations, OperationKeys } from '@decaf-ts/db-decorators';
4
+ import { IonAccordionGroup, ItemReorderEventDetail } from '@ionic/angular/standalone';
5
+ import { FormArray } from '@angular/forms';
6
+ import { NgxBaseComponent } from '../../engine';
7
+ import { IFieldSetItem, IFieldSetValidationEvent } from '../../engine/interfaces';
4
8
  import * as i0 from "@angular/core";
5
9
  /**
6
10
  * @description Dynamic fieldset component with collapsible accordion functionality.
@@ -52,18 +56,18 @@ import * as i0 from "@angular/core";
52
56
  *
53
57
  * @memberOf ForAngularModule
54
58
  */
55
- export declare class FieldsetComponent implements AfterViewInit {
59
+ export declare class FieldsetComponent extends NgxBaseComponent implements OnInit, AfterViewInit {
56
60
  /**
57
- * @description Reference to the component's native DOM element.
58
- * @summary ViewChild reference that provides direct access to the component's root DOM element.
59
- * This is essential for manipulating the Ionic accordion group after view initialization,
60
- * particularly for setting the initial open state programmatically. The reference is used
61
- * to query and modify accordion attributes that control the component's expanded state.
61
+ * @description Reference to the ion-accordion-group component for programmatic control.
62
+ * @summary ViewChild reference that provides direct access to the Ionic accordion group component.
63
+ * This enables programmatic control over the accordion's expand/collapse state, allowing
64
+ * the component to open/close the accordion based on validation errors, CRUD operations,
65
+ * or other business logic requirements.
62
66
  *
63
- * @type {ElementRef}
67
+ * @type {IonAccordionGroup}
64
68
  * @memberOf FieldsetComponent
65
69
  */
66
- component: ElementRef;
70
+ accordionComponent: IonAccordionGroup;
67
71
  /**
68
72
  * @description The display name or title of the fieldset section.
69
73
  * @summary Sets the legend or header text that appears in the accordion header. This text
@@ -76,6 +80,38 @@ export declare class FieldsetComponent implements AfterViewInit {
76
80
  * @memberOf FieldsetComponent
77
81
  */
78
82
  name: string;
83
+ /**
84
+ * @description The parent component identifier for hierarchical fieldset relationships.
85
+ * @summary Specifies the parent component name that this fieldset belongs to in a hierarchical
86
+ * form structure. This property is used for event bubbling and establishing parent-child
87
+ * relationships between fieldsets in complex forms with nested structures.
88
+ *
89
+ * @type {string}
90
+ * @default 'Child'
91
+ * @memberOf FieldsetComponent
92
+ */
93
+ childOf: string;
94
+ /**
95
+ * @description The parent component identifier for hierarchical fieldset relationships.
96
+ * @summary Specifies the parent component name that this fieldset belongs to in a hierarchical
97
+ * form structure. This property is used for event bubbling and establishing parent-child
98
+ * relationships between fieldsets in complex forms with nested structures.
99
+ *
100
+ * @type {string}
101
+ * @default 'Child'
102
+ * @memberOf FieldsetComponent
103
+ */
104
+ uid: string;
105
+ /**
106
+ * @description Custom type definitions for specialized fieldset behavior.
107
+ * @summary Defines custom data types or validation rules that should be applied to this fieldset.
108
+ * Can be a single type string or array of types that determine how the fieldset handles
109
+ * data validation, formatting, and display behavior for specialized use cases.
110
+ *
111
+ * @type {string | string[]}
112
+ * @memberOf FieldsetComponent
113
+ */
114
+ customTypes: string | string[];
79
115
  /**
80
116
  * @description The current CRUD operation context.
81
117
  * @summary Determines the component's initial behavior and state based on the current operation.
@@ -87,7 +123,45 @@ export declare class FieldsetComponent implements AfterViewInit {
87
123
  * @default OperationKeys.READ
88
124
  * @memberOf FieldsetComponent
89
125
  */
126
+ /**
127
+ * @description The CRUD operation type for the current fieldset context.
128
+ * @summary Determines the component's initial behavior and state based on the current operation.
129
+ * This input is crucial for auto-state management: READ and DELETE operations automatically
130
+ * open the fieldset to show content, while CREATE and UPDATE operations keep it closed
131
+ * initially. This provides an intuitive user experience aligned with operation semantics.
132
+ *
133
+ * @type {OperationKeys}
134
+ * @default OperationKeys.READ
135
+ * @memberOf FieldsetComponent
136
+ */
90
137
  operation: OperationKeys;
138
+ /**
139
+ * @description Reactive form group associated with this fieldset.
140
+ * @summary The FormGroup instance that contains all form controls within this fieldset.
141
+ * Used for form validation, value management, and integration with Angular's reactive forms.
142
+ *
143
+ * @type {FormGroup}
144
+ * @memberOf FieldsetComponent
145
+ */
146
+ formGroup: FormArray;
147
+ /**
148
+ * @description Primary title text for the fieldset content.
149
+ * @summary Display title used for fieldset identification and content organization.
150
+ * Provides semantic meaning to the grouped form fields.
151
+ *
152
+ * @type {string}
153
+ * @memberOf FieldsetComponent
154
+ */
155
+ title: string;
156
+ /**
157
+ * @description Secondary descriptive text for the fieldset.
158
+ * @summary Additional information that provides context or instructions
159
+ * related to the fieldset content and purpose.
160
+ *
161
+ * @type {string}
162
+ * @memberOf FieldsetComponent
163
+ */
164
+ description: string;
91
165
  /**
92
166
  * @description Form target attribute for nested form submissions.
93
167
  * @summary Specifies where to display the response after submitting forms contained within
@@ -100,18 +174,102 @@ export declare class FieldsetComponent implements AfterViewInit {
100
174
  * @memberOf FieldsetComponent
101
175
  */
102
176
  target: HTMLFormTarget;
177
+ /**
178
+ * @description Enables multiple item management within the fieldset.
179
+ * @summary Boolean flag that determines if the fieldset supports adding multiple values.
180
+ * When true, displays a reorderable list of items with add/remove functionality.
181
+ *
182
+ * @type {boolean}
183
+ * @default false
184
+ * @memberOf FieldsetComponent
185
+ */
186
+ multiple: boolean;
187
+ /**
188
+ * @description Array of raw values stored in the fieldset.
189
+ * @summary Contains the actual data values that have been added to the fieldset.
190
+ * This is the source of truth for the fieldset's data state.
191
+ *
192
+ * @type {KeyValue[]}
193
+ * @default []
194
+ * @memberOf FieldsetComponent
195
+ */
196
+ value: KeyValue[];
197
+ /**
198
+ * @description Event handler functions for custom fieldset actions.
199
+ * @summary A record of event handler functions keyed by event names that can be triggered
200
+ * within the fieldset. These handlers provide extensibility for custom business logic
201
+ * and can be invoked for various fieldset operations and user interactions.
202
+ *
203
+ * @type {HandlerLike}
204
+ * @memberOf FieldsetComponent
205
+ */
206
+ handlers: HandlerLike;
207
+ /**
208
+ * @description Array of formatted items for UI display.
209
+ * @summary Contains the processed items ready for display in the component template.
210
+ * These items are mapped from the raw values using the mapper configuration.
211
+ *
212
+ * @type {IFieldSetItem[]}
213
+ * @default []
214
+ * @memberOf FieldsetComponent
215
+ */
216
+ items: IFieldSetItem[];
217
+ /**
218
+ * @description Currently selected item for update operations.
219
+ * @summary Holds the item being edited when in update mode. Used to track
220
+ * which item is being modified and apply changes to the correct item.
221
+ *
222
+ * @type {IFieldSetItem | undefined}
223
+ * @memberOf FieldsetComponent
224
+ */
225
+ updatingItem: IFieldSetItem | undefined;
103
226
  /**
104
227
  * @description Current state of the accordion (expanded or collapsed).
105
228
  * @summary Boolean flag that tracks whether the fieldset accordion is currently open or closed.
106
229
  * This property is automatically managed based on user interactions and initial operation state.
107
230
  * It serves as the single source of truth for the component's visibility state and is used
108
- * to coordinate between user actions and programmatic state changes.
231
+ * to coordinate between user actions and programmatic state changes. The value is automatically
232
+ * set based on CRUD operations during initialization and updated through user interactions.
109
233
  *
110
234
  * @type {boolean}
111
235
  * @default false
112
236
  * @memberOf FieldsetComponent
113
237
  */
114
238
  isOpen: boolean;
239
+ /**
240
+ * @description Indicates whether the fieldset contains required form fields.
241
+ * @summary Boolean flag that signals the presence of mandatory input fields within the fieldset.
242
+ * This property is automatically set by the CollapsableDirective when required fields are detected,
243
+ * and can be used to apply special styling, validation logic, or UI indicators to highlight
244
+ * fieldsets that contain mandatory information. It helps with form validation feedback and
245
+ * user experience by making required sections more prominent.
246
+ *
247
+ * @type {boolean}
248
+ * @default false
249
+ * @memberOf FieldsetComponent
250
+ */
251
+ isRequired: boolean;
252
+ /**
253
+ * @description Indicates whether the fieldset contains validation errors.
254
+ * @summary Boolean flag that tracks if any form fields within the fieldset have validation errors.
255
+ * This property is used to control accordion behavior when errors are present, preventing
256
+ * users from collapsing the accordion when they need to see and address validation issues.
257
+ * It's automatically updated when validation error events are received from child form fields.
258
+ *
259
+ * @type {boolean}
260
+ * @default false
261
+ * @memberOf FieldsetComponent
262
+ */
263
+ hasValidationErrors: boolean;
264
+ /**
265
+ * @description Validation error message for duplicate values.
266
+ * @summary Stores the error message when a user attempts to add a duplicate value
267
+ * to the fieldset. Used to display uniqueness validation feedback.
268
+ *
269
+ * @type {string | undefined}
270
+ * @memberOf FieldsetComponent
271
+ */
272
+ isUniqueError: string | undefined;
115
273
  /**
116
274
  * @description Reference to CRUD operation constants for template usage.
117
275
  * @summary Exposes the OperationKeys enum to the component template, enabling conditional
@@ -137,35 +295,169 @@ export declare class FieldsetComponent implements AfterViewInit {
137
295
  */
138
296
  private changeDetectorRef;
139
297
  /**
140
- * @description Initializes the component state after view and child components are rendered.
141
- * @summary This lifecycle hook implements intelligent auto-state management based on the current
142
- * CRUD operation. For READ and DELETE operations, the fieldset automatically opens to provide
143
- * immediate access to information, while CREATE and UPDATE operations keep it closed to maintain
144
- * a clean initial interface. The method directly manipulates the DOM to ensure proper accordion
145
- * synchronization and triggers change detection to reflect the programmatic state changes.
298
+ * @description Angular Renderer2 service for safe DOM manipulation.
299
+ * @summary Injected service that provides a safe, platform-agnostic way to manipulate DOM elements.
300
+ * This service ensures proper handling of DOM operations across different platforms and environments,
301
+ * including server-side rendering and web workers.
146
302
  *
147
- * @mermaid
148
- * sequenceDiagram
149
- * participant A as Angular Lifecycle
150
- * participant F as FieldsetComponent
151
- * participant D as DOM
152
- * participant C as ChangeDetector
153
- *
154
- * A->>F: ngAfterViewInit()
155
- * alt operation is READ or DELETE
156
- * F->>F: Set isOpen = true
157
- * F->>D: Query ion-accordion-group element
158
- * alt accordion element exists
159
- * F->>D: Set value attribute to 'open'
160
- * end
161
- * end
162
- * F->>C: detectChanges()
163
- * C->>F: Update view with new state
303
+ * @private
304
+ * @type {Renderer2}
305
+ * @memberOf FieldsetComponent
306
+ */
307
+ private renderer;
308
+ /**
309
+ * @description Translation service for internationalization.
310
+ * @summary Injected service that provides translation capabilities for UI text.
311
+ * Used to translate button labels and validation messages based on the current locale.
312
+ *
313
+ * @private
314
+ * @type {TranslateService}
315
+ * @memberOf FieldsetComponent
316
+ */
317
+ private translateService;
318
+ /**
319
+ * @description Localized label text for action buttons.
320
+ * @summary Dynamic button label that changes based on the current operation mode.
321
+ * Shows "Add" for create operations and "Update" for edit operations.
322
+ *
323
+ * @type {string}
324
+ * @memberOf FieldsetComponent
325
+ */
326
+ buttonLabel: string;
327
+ /**
328
+ * @description Component constructor that initializes the fieldset with icons and component name.
329
+ * @summary Calls the parent NgxBaseComponent constructor with the component name and
330
+ * required Ionic icons (alertCircleOutline for validation errors and createOutline for add actions).
331
+ * Sets up the foundational component structure and icon registry.
332
+ *
333
+ * @memberOf FieldsetComponent
334
+ */
335
+ constructor();
336
+ /**
337
+ * @description Component initialization lifecycle method.
338
+ * @summary Initializes the component by setting up repository relationships if a model exists,
339
+ * and configures the initial button label for the add action based on the current locale.
340
+ * This method ensures proper setup of translation services and component state.
164
341
  *
165
342
  * @returns {void}
166
343
  * @memberOf FieldsetComponent
167
344
  */
345
+ ngOnInit(): void;
346
+ /**
347
+ * @description Initializes the component state after view and child components are rendered.
348
+ * @summary This lifecycle hook implements intelligent auto-state management based on the current
349
+ * CRUD operation. For READ and DELETE operations, the fieldset automatically opens to provide
350
+ * immediate access to information, while CREATE and UPDATE operations keep it closed to maintain
351
+ * a clean initial interface. The method directly manipulates the DOM to ensure proper accordion
352
+ * synchronization and triggers change detection to reflect the programmatic state changes.
353
+ *
354
+ * @mermaid
355
+ * sequenceDiagram
356
+ * participant A as Angular Lifecycle
357
+ * participant F as FieldsetComponent
358
+ * participant D as DOM
359
+ * participant C as ChangeDetector
360
+ *
361
+ * A->>F: ngAfterViewInit()
362
+ * alt operation is READ or DELETE
363
+ * F->>F: Set isOpen = true
364
+ * F->>D: Query ion-accordion-group element
365
+ * alt accordion element exists
366
+ * F->>D: Set value attribute to 'open'
367
+ * end
368
+ * end
369
+ * F->>C: detectChanges()
370
+ * C->>F: Update view with new state
371
+ *
372
+ * @returns {void}
373
+ * @memberOf FieldsetComponent
374
+ */
168
375
  ngAfterViewInit(): void;
376
+ /**
377
+ * @description Handles removal of the fieldset with slide animation.
378
+ * @summary Initiates the removal process for the fieldset with a smooth slide-up animation.
379
+ * The method applies CSS classes for the slide animation and then safely removes the
380
+ * element from the DOM using Renderer2. This provides a polished user experience
381
+ * when removing fieldset instances from dynamic forms.
382
+ *
383
+ * @param {Event} event - DOM event from the remove button click
384
+ * @returns {void}
385
+ * @memberOf FieldsetComponent
386
+ */
387
+ handleRemoveComponent(event: Event): void;
388
+ /**
389
+ * @description Handles creating new items or triggering group addition events.
390
+ * @summary Processes form validation events for item creation or emits events to trigger
391
+ * the addition of new fieldset groups. When called with validation event data, it validates
392
+ * uniqueness and adds the item to the fieldset. When called without parameters, it triggers
393
+ * a group addition event for parent components to handle.
394
+ *
395
+ * @param {CustomEvent<IFieldSetValidationEvent>} [event] - Optional validation event containing form data
396
+ * @returns {Promise<void>}
397
+ * @memberOf FieldsetComponent
398
+ *
399
+ * @example
400
+ * ```typescript
401
+ * // Called from form validation
402
+ * handleCreateItem(validationEvent);
403
+ *
404
+ * // Called to trigger group addition
405
+ * handleCreateItem();
406
+ * ```
407
+ */
408
+ handleCreateItem(event?: CustomEvent<IFieldSetValidationEvent>): Promise<void>;
409
+ /**
410
+ * @description Handles item update operations with form state management.
411
+ * @summary Locates an item in the form array for editing and prepares the component
412
+ * for update mode. Updates the button label to reflect the edit state and stores
413
+ * the item being updated. Triggers a window event to notify parent components.
414
+ *
415
+ * @param {string | number} value - The identifier value of the item to update
416
+ * @param {number} index - The array index position of the item
417
+ * @returns {void}
418
+ * @memberOf FieldsetComponent
419
+ */
420
+ handleUpdateItem(value: string | number, index: number): void;
421
+ /**
422
+ * @description Cancels the update mode and resets the UI state.
423
+ * @summary Exits the update mode by resetting the button label and clearing the updating item,
424
+ * restoring the component to its default state for adding new items. Notifies parent components
425
+ * that the update operation has been cancelled.
426
+ *
427
+ * @returns {void}
428
+ * @memberOf FieldsetComponent
429
+ */
430
+ handleCancelUpdateItem(): void;
431
+ /**
432
+ * @description Handles item removal operations with form array management.
433
+ * @summary Processes item removal by either handling validation events or removing specific
434
+ * items from the form array. When called with a validation event, it triggers value updates.
435
+ * When called with an identifier, it locates and removes the matching item from the form array.
436
+ *
437
+ * @param {string | undefined} value - The identifier of the item to remove
438
+ * @param {CustomEvent} [event] - Optional validation event for form updates
439
+ * @returns {void}
440
+ * @memberOf FieldsetComponent
441
+ */
442
+ handleRemoveItem(value: string | undefined, event?: CustomEvent): void;
443
+ /**
444
+ * @description Handles reordering of items within the fieldset list.
445
+ * @summary Processes drag-and-drop reorder events from the ion-reorder-group component.
446
+ * Updates both the display items array and the underlying value array to maintain
447
+ * consistency between UI state and data state. Preserves item indices after reordering.
448
+ *
449
+ * @param {CustomEvent<ItemReorderEventDetail>} event - Ionic reorder event containing source and target indices
450
+ * @returns {void}
451
+ * @memberOf FieldsetComponent
452
+ *
453
+ * @example
454
+ * ```html
455
+ * <ion-reorder-group (ionItemReorder)="handleReorder($event)">
456
+ * <!-- Reorderable items -->
457
+ * </ion-reorder-group>
458
+ * ```
459
+ */
460
+ handleReorderItems(event: CustomEvent<ItemReorderEventDetail>): void;
169
461
  /**
170
462
  * @description Handles accordion state change events from user interactions.
171
463
  * @summary Processes CustomEvent objects triggered when users expand or collapse the accordion.
@@ -193,7 +485,53 @@ export declare class FieldsetComponent implements AfterViewInit {
193
485
  *
194
486
  * @memberOf FieldsetComponent
195
487
  */
196
- handleChange(event: CustomEvent): void;
488
+ /**
489
+ * @description Handles accordion toggle functionality with validation error consideration.
490
+ * @summary Manages the expand/collapse state of the accordion while respecting validation error states.
491
+ * When validation errors are present, the accordion cannot be collapsed to ensure users can see
492
+ * and address the errors. When no errors exist, users can freely toggle the accordion state.
493
+ * This method also stops event propagation to prevent unwanted side effects.
494
+ *
495
+ * @param {CustomEvent} [event] - Optional event object from user interaction
496
+ * @returns {void}
497
+ * @memberOf FieldsetComponent
498
+ */
499
+ handleAccordionToggle(event?: CustomEvent): void;
500
+ /**
501
+ * @description Handles validation error events from child form fields.
502
+ * @summary Processes validation error events dispatched by form fields within the fieldset.
503
+ * When errors are detected, the accordion is forced open and prevented from collapsing
504
+ * to ensure users can see the validation messages. This method updates the component's
505
+ * error state and accordion visibility accordingly.
506
+ *
507
+ * @param {CustomEvent} event - Custom event containing validation error details
508
+ * @returns {void}
509
+ * @memberOf FieldsetComponent
510
+ */
511
+ handleValidationError(event: CustomEvent): void;
512
+ /**
513
+ * @description Processes and stores a new or updated value in the fieldset.
514
+ * @summary Handles both create and update operations for fieldset items. Parses and cleans
515
+ * the input value, determines the operation type based on the updating state, and either
516
+ * adds a new item or updates an existing one. Maintains data integrity and UI consistency.
517
+ *
518
+ * @returns {void}
519
+ * @private
520
+ * @memberOf FieldsetComponent
521
+ */
522
+ private setValue;
523
+ /**
524
+ * @description Automatically configures the field mapping based on the value structure.
525
+ * @summary Analyzes the provided value object to automatically determine the primary key
526
+ * and create appropriate field mappings for display purposes. Sets up the mapper object
527
+ * with title, description, and index fields based on the available data structure.
528
+ *
529
+ * @param {KeyValue} value - Sample value object used to determine field mappings
530
+ * @returns {KeyValue} The configured mapper object
531
+ * @private
532
+ * @memberOf FieldsetComponent
533
+ */
534
+ private getMapper;
197
535
  static ɵfac: i0.ɵɵFactoryDeclaration<FieldsetComponent, never>;
198
- static ɵcmp: i0.ɵɵComponentDeclaration<FieldsetComponent, "ngx-decaf-fieldset", never, { "name": { "alias": "name"; "required": false; }; "operation": { "alias": "operation"; "required": false; }; "target": { "alias": "target"; "required": false; }; }, {}, never, ["*"], true, never>;
536
+ static ɵcmp: i0.ɵɵComponentDeclaration<FieldsetComponent, "ngx-decaf-fieldset", never, { "name": { "alias": "name"; "required": false; }; "childOf": { "alias": "childOf"; "required": false; }; "uid": { "alias": "uid"; "required": false; }; "customTypes": { "alias": "customTypes"; "required": false; }; "operation": { "alias": "operation"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "title": { "alias": "title"; "required": false; }; "description": { "alias": "description"; "required": false; }; "target": { "alias": "target"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "value": { "alias": "value"; "required": false; }; "handlers": { "alias": "handlers"; "required": false; }; }, {}, never, ["*"], true, never>;
199
537
  }
@@ -7,7 +7,7 @@ import { BaseCustomEvent, RendererCustomEvent, StringOrBoolean, KeyValue, ListIt
7
7
  import { NgxBaseComponent } from '../../engine/NgxBaseComponent';
8
8
  import { PaginationCustomEvent } from '../pagination/constants';
9
9
  import { IListEmptyResult, ListComponentsTypes } from './constants';
10
- import { FunctionLike, IFilterQuery } from '../../engine/types';
10
+ import { FunctionLike, IFilterQuery } from '../../engine';
11
11
  import * as i0 from "@angular/core";
12
12
  /**
13
13
  * @description A versatile list component that supports various data display modes.
@@ -257,7 +257,7 @@ export declare class ListItemComponent extends NgxBaseComponent implements OnIni
257
257
  * participant E as Event System
258
258
  *
259
259
  * U->>L: Perform action (click/swipe)
260
- * L->>L: stopPropagation()
260
+ * L->>L: stopImmediatePropagation()
261
261
  * alt actionMenuOpen
262
262
  * L->>L: Dismiss action menu
263
263
  * end
@@ -376,7 +376,7 @@ export declare class ListItemComponent extends NgxBaseComponent implements OnIni
376
376
  * participant A as Accessibility
377
377
  *
378
378
  * U->>L: Trigger action menu (long press/right-click)
379
- * L->>L: stopPropagation()
379
+ * L->>L: stopImmediatePropagation()
380
380
  * L->>A: removeFocusTrap()
381
381
  * L->>P: Set event reference
382
382
  * L->>L: actionMenuOpen = true
@@ -7,7 +7,7 @@ import * as i0 from "@angular/core";
7
7
  * @description Component for rendering dynamic models
8
8
  * @summary This component is responsible for dynamically rendering models,
9
9
  * handling model changes, and managing event subscriptions for the rendered components.
10
- * It uses the NgxRenderingEngine2 to render the models and supports both string and Model inputs.
10
+ * It uses the NgxRenderingEngine to render the models and supports both string and Model inputs.
11
11
  * @class
12
12
  * @template M - Type extending Model
13
13
  * @param {Injector} injector - Angular Injector for dependency injection
@@ -61,10 +61,6 @@ export declare class ModelRendererComponent<M extends Model> implements OnChange
61
61
  * @description Event emitter for custom events from the rendered component
62
62
  */
63
63
  listenEvent: EventEmitter<RendererCustomEvent>;
64
- /**
65
- * @description Instance of the NgxRenderingEngine2
66
- */
67
- private render;
68
64
  /**
69
65
  * @description Instance of the rendered component
70
66
  */
@@ -2,6 +2,7 @@ import { OnInit } from '@angular/core';
2
2
  import * as i0 from "@angular/core";
3
3
  export declare class CollapsableDirective implements OnInit {
4
4
  private element;
5
+ private injector;
5
6
  ngOnInit(): void;
6
7
  static ɵfac: i0.ɵɵFactoryDeclaration<CollapsableDirective, never>;
7
8
  static ɵdir: i0.ɵɵDirectiveDeclaration<CollapsableDirective, "[decafCollapsable]", never, {}, {}, never, never, true, never>;
@@ -2,7 +2,7 @@ import { ElementRef, OnChanges, SimpleChanges, EventEmitter } from '@angular/cor
2
2
  import { KeyValue, RendererCustomEvent, StringOrBoolean } from './types';
3
3
  import { Model } from '@decaf-ts/decorator-validation';
4
4
  import { CrudOperations } from '@decaf-ts/db-decorators';
5
- import { NgxRenderingEngine2 } from './NgxRenderingEngine2';
5
+ import { NgxRenderingEngine } from './NgxRenderingEngine';
6
6
  import { Logger } from '@decaf-ts/logging';
7
7
  import { DecafRepository } from '../components/list/constants';
8
8
  import * as i0 from "@angular/core";
@@ -45,7 +45,7 @@ import * as i0 from "@angular/core";
45
45
  * participant App as Application
46
46
  * participant Comp as Component
47
47
  * participant Base as NgxBaseComponent
48
- * participant Engine as NgxRenderingEngine2
48
+ * participant Engine as NgxRenderingEngine
49
49
  *
50
50
  * App->>Comp: Create component
51
51
  * Comp->>Base: super(instance)
@@ -302,13 +302,13 @@ export declare abstract class NgxBaseComponent implements OnChanges {
302
302
  listenEvent: EventEmitter<RendererCustomEvent>;
303
303
  /**
304
304
  * @description Reference to the rendering engine instance
305
- * @summary Provides access to the NgxRenderingEngine2 singleton instance,
305
+ * @summary Provides access to the NgxRenderingEngine singleton instance,
306
306
  * which handles the rendering of components based on model definitions.
307
307
  * This engine is used to extract decorator metadata and render child components.
308
308
  *
309
- * @type {NgxRenderingEngine2}
309
+ * @type {NgxRenderingEngine}
310
310
  */
311
- renderingEngine: NgxRenderingEngine2;
311
+ renderingEngine: NgxRenderingEngine;
312
312
  /**
313
313
  * @description Logger instance for the component.
314
314
  * @summary Provides logging capabilities for the component, allowing for consistent
@@ -358,7 +358,7 @@ export declare abstract class NgxBaseComponent implements OnChanges {
358
358
  *
359
359
  * @memberOf NgxBaseComponent
360
360
  */
361
- protected constructor(instance: string);
361
+ protected constructor(instance: string, icons?: KeyValue);
362
362
  /**
363
363
  * @description Getter for the repository instance.
364
364
  * @summary Provides a connection to the data layer for retrieving and manipulating data.
@@ -1,4 +1,4 @@
1
- import { FieldProperties } from '@decaf-ts/ui-decorators';
1
+ import { CrudOperationKeys, FieldProperties } from '@decaf-ts/ui-decorators';
2
2
  import { PossibleInputTypes } from './types';
3
3
  import { CrudOperations } from '@decaf-ts/db-decorators';
4
4
  import { ControlValueAccessor, FormControl, FormGroup } from '@angular/forms';
@@ -33,8 +33,9 @@ export declare abstract class NgxCrudFormField implements ControlValueAccessor,
33
33
  childOf?: string;
34
34
  type: PossibleInputTypes;
35
35
  disabled?: boolean;
36
+ uid?: string;
36
37
  format?: string;
37
- hidden?: boolean;
38
+ hidden?: boolean | CrudOperationKeys[];
38
39
  max?: number | Date;
39
40
  maxlength?: number;
40
41
  min?: number | Date;
@@ -50,7 +51,9 @@ export declare abstract class NgxCrudFormField implements ControlValueAccessor,
50
51
  greaterThan?: string;
51
52
  greaterThanOrEqual?: string;
52
53
  value: string | number | Date;
54
+ multiple: boolean;
53
55
  private translateService;
56
+ private validationErrorEventDispateched;
54
57
  /**
55
58
  * @summary Parent HTML element
56
59
  * @description Reference to the parent HTML element of the field