@solcre-org/core-ui 2.19.2 → 2.20.0

package/llm/components/datetime-field.md

@@ -0,0 +1,61 @@
+# core-datetime-field
+
+- Class: `DatetimeFieldComponent`
+- File: `projects/core-ui-library/src/lib/components/fields/types/datetime-field/datetime-field.component.ts`
+
+## Inputs
+- `value`: `Date | null`
+- `mode`: `ModalMode` (required)
+- `errors`: `string[]`
+- `rowData`: `T | null`
+- `formValue`: `any`
+
+## Outputs
+- `valueChange`: `Date | null`
+- `onBlurEvent`: `keyof T`
+- `onEnterEvent`: `keyof T`
+
+## Usage notes
+
+- Inherits inputs/outputs from `core-base-field`: `field`, `value`, `mode`, `errors`, `rowData`, `formValue` and emits `valueChange`, `onBlurEvent`, `onEnterEvent`.
+- Provide `field` using the matching config interface from `projects/core-ui-library/src/lib/interfaces/field-configs` and `FieldType`.
+- Use `mode` (`ModalMode`) to control readonly/validators and view behavior.
+
+## Config sketch
+
+
+```ts
+const meetingField: ModalFieldConfig<User> = {
+  key: 'meetingAt',
+  label: 'Meeting time',
+  type: FieldType.DATETIME,
+  readonly: false,
+};
+```
+
+## Example
+
+
+```html
+<core-datetime-field
+  [field]="fieldConfig"
+  [value]="formData[fieldConfig.key]"
+  [mode]="mode"
+  [errors]="errors[fieldConfig.key] || []"
+  [formValue]="formData"
+  (valueChange)="onFieldChange(fieldConfig.key, $event)"
+></core-datetime-field>
+```
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/document-field.md

@@ -0,0 +1,60 @@
+# core-document-field
+
+- Class: `DocumentFieldComponent`
+- File: `projects/core-ui-library/src/lib/components/fields/types/document-field/document-field.component.ts`
+
+## Inputs
+- none
+
+## Outputs
+- none
+
+## Usage notes
+
+- Inherits inputs/outputs from `core-base-field`: `field`, `value`, `mode`, `errors`, `rowData`, `formValue` and emits `valueChange`, `onBlurEvent`, `onEnterEvent`.
+- Provide `field` using the matching config interface from `projects/core-ui-library/src/lib/interfaces/field-configs` and `FieldType`.
+- Use `mode` (`ModalMode`) to control readonly/validators and view behavior.
+
+## Config sketch
+
+
+```ts
+const documentField: DocumentFieldConfig<User> = {
+  key: 'document',
+  label: 'Document',
+  type: FieldType.DOCUMENT,
+  documentTypeOptions: [
+    { value: 'id', label: 'ID' },
+    { value: 'passport', label: 'Passport' },
+  ],
+  payloadMode: DocumentPayloadMode.OBJECT,
+  readonly: false,
+};
+```
+
+## Example
+
+
+```html
+<core-document-field
+  [field]="fieldConfig"
+  [value]="formData[fieldConfig.key]"
+  [mode]="mode"
+  [errors]="errors[fieldConfig.key] || []"
+  [formValue]="formData"
+  (valueChange)="onFieldChange(fieldConfig.key, $event)"
+></core-document-field>
+```
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/dropdown.md

@@ -0,0 +1,73 @@
+# core-dropdown
+
+- Class: `DropdownComponent`
+- File: `projects/core-ui-library/src/lib/components/generic-table/components/dropdown/dropdown.component.ts`
+
+## Inputs
+- `rowId`: `number`
+- `triggerElementId`: `string`
+- `extraDefaultActions`: `any[]`
+- `row`: `T | null`
+
+## Outputs
+- `actionTriggered`: `{ action: TableAction; row: T }`
+
+## Demo usage
+
+- `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.html`:42 — `<core-dropdown`
+- `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.html`:49 — `</core-dropdown>`
+- `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.ts`:119 — `<core-dropdown`
+- `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.ts`:125 — `</core-dropdown>``
+- `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.ts`:184 — `<core-dropdown`
+- `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.ts`:192 — `</core-dropdown>``
+- `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.ts`:239 — `<core-dropdown`
+- `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.ts`:247 — `</core-dropdown>`
+
+## Demo snippet (HTML)
+
+Source: `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.html`:42-49
+
+```html
+              <core-dropdown 
+                [rowId]="item.id"
+                [triggerElementId]="'dropdown-trigger-' + item.id"
+                [extraDefaultActions]="getDefaultActions()"
+                [row]="item"
+                (actionTriggered)="onDefaultAction($event.action, $event.row)"
+                (customActionTriggered)="$event.action.callback($event.row)">
+              </core-dropdown>
+```
+
+## Demo snippet (TS)
+
+Source: `projects/core-ui-demo/src/app/admin/components/dropdown/dropdown.ts`
+
+Lines: 100-124
+
+```ts
+    this.dropdownService.closeDropdown();
+  }
+
+  onDefaultAction(action: string, item: any): void {
+    switch (action) {
+      case 'view': this.viewItem(item); break;
+      case 'edit': this.editItem(item); break;
+      case 'delete': this.deleteItem(item); break;
+    }
+  }
+}`,
+      templateCode: `
+<core-generic-button 
+  [config]="getTriggerConfig()"
+  [data]="item"
+  [id]="'dropdown-trigger-' + item.id"
+  (buttonClick)="onMoreActionsClick($event, item.id)">
+</core-generic-button>
+
+<core-dropdown 
+  [rowId]="item.id"
+  [triggerElementId]="'dropdown-trigger-' + item.id"
+  [extraDefaultActions]="getDefaultActions()"
+  [row]="item"
+  (actionTriggered)="onDefaultAction($event.action, $event.row)">
+```

package/llm/components/field-errors.md

@@ -0,0 +1,33 @@
+# core-field-errors
+
+- Class: `FieldErrorsComponent`
+- File: `projects/core-ui-library/src/lib/components/fields/field-errors/field-errors.component.ts`
+
+## Inputs
+- `errors`: `string[]` (required)
+
+## Outputs
+- none
+
+## Usage notes
+
+- Use to render validation messages for a field.
+
+## Example
+
+```html
+<core-field-errors [errors]="errors.name || []"></core-field-errors>
+```
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/file-field.md

@@ -0,0 +1,60 @@
+# core-file-field
+
+- Class: `FileFieldComponent`
+- File: `projects/core-ui-library/src/lib/components/fields/types/file-field/file-field.component.ts`
+
+## Inputs
+- none
+
+## Outputs
+- none
+
+## Usage notes
+
+- Inherits inputs/outputs from `core-base-field`: `field`, `value`, `mode`, `errors`, `rowData`, `formValue` and emits `valueChange`, `onBlurEvent`, `onEnterEvent`.
+- Provide `field` using the matching config interface from `projects/core-ui-library/src/lib/interfaces/field-configs` and `FieldType`.
+- Use `mode` (`ModalMode`) to control readonly/validators and view behavior.
+
+## Config sketch
+
+
+```ts
+const fileField: FileFieldConfig<User> = {
+  key: 'attachments',
+  label: 'Attachments',
+  type: FieldType.FILE,
+  accept: '.pdf,.png,.jpg',
+  multiple: true,
+  maxFiles: 3,
+  showPreview: true,
+  acceptString: 'pdf,png,jpg',
+  readonly: false,
+};
+```
+
+## Example
+
+
+```html
+<core-file-field
+  [field]="fieldConfig"
+  [value]="formData[fieldConfig.key]"
+  [mode]="mode"
+  [errors]="errors[fieldConfig.key] || []"
+  [formValue]="formData"
+  (valueChange)="onFieldChange(fieldConfig.key, $event)"
+></core-file-field>
+```
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/file-preview.md

@@ -0,0 +1,25 @@
+# core-file-preview
+
+- Class: `FilePreviewComponent`
+- File: `projects/core-ui-library/src/lib/components/file-preview/file-preview.component.ts`
+
+## Inputs
+- `fileModels`: `FileModel[]`
+- `files`: `FilePreviewItem[]`
+- `config`: `FilePreviewConfig`
+
+## Outputs
+- `actionTriggered`: `FilePreviewAction`
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/filter-modal.md

@@ -0,0 +1,25 @@
+# core-filter-modal
+
+- Class: `FilterModalComponent`
+- File: `projects/core-ui-library/src/lib/components/generic-table/components/filter-modal/filter-modal.component.ts`
+
+## Inputs
+- `isOpen`: `unknown`
+
+## Outputs
+- `close`: `void`
+- `clearFilters`: `void`
+- `globalFilterChange`: `string`
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/fixed-actions-mobile-modal.md

@@ -0,0 +1,23 @@
+# core-fixed-actions-mobile-modal
+
+- Class: `FixedActionsMobileModalComponent`
+- File: `projects/core-ui-library/src/lib/components/generic-fixed-actions/fixed-actions-mobile-modal.component.ts`
+
+## Inputs
+- none
+
+## Outputs
+- none
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/gallery-modal.md

@@ -0,0 +1,23 @@
+# core-gallery-modal
+
+- Class: `GalleryModalComponent`
+- File: `projects/core-ui-library/src/lib/components/gallery-modal/gallery-modal.component.ts`
+
+## Inputs
+- none
+
+## Outputs
+- none
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/generic-button.md

@@ -0,0 +1,82 @@
+# core-generic-button
+
+- Class: `GenericButtonComponent`
+- File: `projects/core-ui-library/src/lib/components/generic-button/generic-button.component.ts`
+
+## Inputs
+- `config`: `ButtonConfig` (required)
+- `data`: `any`
+
+## Outputs
+- `buttonClick`: `ButtonActionEvent`
+
+## Usage notes
+- Use `ButtonConfig` to control type, size, icon, tooltip, permissions, and custom classes.
+
+## Example
+```html
+<core-generic-button
+  [config]="buttonConfig"
+  (buttonClick)="handleClick($event)"
+></core-generic-button>
+```
+
+## Demo usage
+
+- `projects/core-ui-demo/src/app/admin/components/alerts/alerts.html`:4 — `<core-generic-button`
+- `projects/core-ui-demo/src/app/admin/components/alerts/alerts.html`:10 — `</core-generic-button>`
+- `projects/core-ui-demo/src/app/admin/components/alerts/alerts.html`:17 — `<core-generic-button`
+- `projects/core-ui-demo/src/app/admin/components/alerts/alerts.html`:20 — `</core-generic-button>`
+- `projects/core-ui-demo/src/app/admin/components/alerts/alerts.ts`:53 — `<core-generic-button`
+- `projects/core-ui-demo/src/app/admin/components/alerts/alerts.ts`:56 — `</core-generic-button>`
+- `projects/core-ui-demo/src/app/admin/components/alerts/alerts.ts`:77 — `<core-generic-button`
+- `projects/core-ui-demo/src/app/admin/components/alerts/alerts.ts`:80 — `</core-generic-button>`
+- …and 96 more matches
+
+## Demo snippet (HTML)
+
+Source: `projects/core-ui-demo/src/app/admin/components/alerts/alerts.html`:4-10
+
+```html
+      <core-generic-button
+        (buttonClick)="onOpenAlert(alertConfig)"
+        [config]="{
+          type: ButtonType.PRIMARY,
+          text: alertConfig.message
+        }">
+      </core-generic-button>
+```
+
+## Demo snippet (TS)
+
+Source: `projects/core-ui-demo/src/app/admin/components/alerts/alerts.ts`
+
+Lines: 5-29
+
+```ts
+
+@Component({
+  selector: 'app-alerts',
+  standalone: true,
+  imports: [ComponentsGrid, ComponentsGridRow, GenericButtonComponent],
+  templateUrl: './alerts.html',
+  styleUrls: ['./alerts.css']
+})
+export class Alerts {
+  @ViewChild('codeTemplate', { read: TemplateRef }) codeTemplate!: TemplateRef<any>;
+
+  ButtonType = ButtonType;
+  alertService = inject(AlertService);
+  dialog = inject(ConfirmationDialogService);
+
+  alerts = signal<Alert[]>([
+    { type: AlertType.SUCCESS,      message: 'Alerta de éxito',            duration: 3000, inBottom: true },
+    { type: AlertType.ERROR,        message: 'Alerta de error',            duration: 3000, inBottom: true },
+    { type: AlertType.WAITING,      message: 'Alerta de espera',           duration: 3000, inBottom: true },
+    { type: AlertType.HIGHLIGHTED,  message: 'Alerta destacada',           duration: 3000, inBottom: true },
+    { type: AlertType.DEFAULT,      message: 'Alerta por defecto',         duration: 3000, inBottom: true },
+    { type: AlertType.DEFAULT,      message: 'Alerta con icono customizado', duration: 3000, icon: 'icon-star-filled', inBottom: true }
+  ]);
+
+  onOpenAlert(config: Alert): void {
+```

package/llm/components/generic-calendar.md

@@ -0,0 +1,70 @@
+# core-generic-calendar
+
+- Class: `GenericCalendarComponent`
+- File: `projects/core-ui-library/src/lib/components/generic-calendar/generic-calendar.component.ts`
+
+## Inputs
+- `currentDate`: `Date`
+- `selectedDate`: `Date | null`
+- `config`: `CalendarConfig`
+- `showNavigation`: `boolean`
+- `showHeader`: `boolean`
+- `locale`: `string`
+
+## Outputs
+- `dateSelected`: `DateSelectionEvent`
+- `monthChanged`: `DateNavigationEvent`
+
+## Demo usage
+
+- `projects/core-ui-demo/src/app/admin/components/calendar/calendar-demo.component.html`:127 — `<core-generic-calendar`
+- `projects/core-ui-demo/src/app/admin/components/calendar/calendar-demo.component.html`:134 — `</core-generic-calendar>`
+
+## Demo snippet (HTML)
+
+Source: `projects/core-ui-demo/src/app/admin/components/calendar/calendar-demo.component.html`:127-134
+
+```html
+      <core-generic-calendar
+        [currentDate]="currentDate"
+        [selectedDate]="selectedDate()"
+        [config]="calendarConfig"
+        (dateSelected)="onDateSelected($event)"
+        (monthChanged)="onMonthChanged($event)"
+      >
+      </core-generic-calendar>
+```
+
+## Demo snippet (TS)
+
+Source: `projects/core-ui-demo/src/app/admin/components/calendar/calendar-demo.component.ts`
+
+Lines: 374-398
+
+```ts
+      today.getFullYear(),
+      today.getMonth(),
+      today.getDate()
+    ));
+    this.selectedDate.set(todayUTC);
+  }
+
+  onPreviousDay(date: Date): void {
+    this.selectedDate.set(date);
+  }
+
+  onNextDay(date: Date): void {
+    this.selectedDate.set(date);
+  }
+
+  onPreviousMonth(): void {
+    const current = this.selectedDate();
+    const newDate = new Date(current.getFullYear(), current.getMonth() - 1, 1);
+    this.selectedDate.set(newDate);
+  }
+
+  onNextMonth(): void {
+    const current = this.selectedDate();
+    const newDate = new Date(current.getFullYear(), current.getMonth() + 1, 1);
+    this.selectedDate.set(newDate);
+```

package/llm/components/generic-chat.md

@@ -0,0 +1,81 @@
+# core-generic-chat
+
+- Class: `GenericChatComponent`
+- File: `projects/core-ui-library/src/lib/components/generic-chat/generic-chat.component.ts`
+
+## Inputs
+- `messages`: `ChatMessage[]`
+- `config`: `ChatConfig`
+- `isTyping`: `boolean`
+
+## Outputs
+- `messagesSent`: `ChatMessage`
+- `imageClicked`: `ChatMessage`
+- `fileClicked`: `ChatMessage`
+- `fileSelected`: `File`
+- `filesSelected`: `File[]`
+- `typingStatusChanged`: `boolean`
+- `modalClosed`: `void`
+- `attachmentAction`: `{action: string, file: any, message: ChatMessage}`
+- `sendingStatusChanged`: `boolean`
+- `loadMoreMessages`: `void`
+
+## Demo usage
+
+- `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:7 — `<core-generic-chat`
+- `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:13 — `</core-generic-chat>`
+- `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:28 — `<core-generic-chat`
+- `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:34 — `</core-generic-chat>`
+- `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:53 — `<core-generic-chat`
+- `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:60 — `</core-generic-chat>`
+- `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:75 — `<core-generic-chat`
+- `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:81 — `</core-generic-chat>`
+- …and 2 more matches
+
+## Demo snippet (HTML)
+
+Source: `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.html`:7-13
+
+```html
+                    <core-generic-chat
+                        [messages]="sampleMessages()"
+                        [config]="basicConfig()"
+                        (messagesSent)="onMessageSent($event)"
+                        (imageClicked)="onImageClicked($event)"
+                        (fileClicked)="onFileClicked($event)">
+                    </core-generic-chat>
+```
+
+## Demo snippet (TS)
+
+Source: `projects/core-ui-demo/src/app/admin/components/generic-chat/generic-chat.ts`
+
+Lines: 182-206
+
+```ts
+  onMessageSent(message: ChatMessage): void {
+    console.log('Mensaje enviado:', message);
+    // Simular respuesta automática
+    setTimeout(() => {
+      const response: ChatMessage = {
+        id: Date.now().toString(),
+        content: 'Mensaje recibido correctamente',
+        type: ChatMessageType.TEXT,
+        position: ChatMessagePosition.LEFT,
+        timestamp: new Date(),
+        sender: {
+          id: 'user1',
+          name: 'Ana García',
+          avatar: 'https://via.placeholder.com/40x40/4CAF50/white?text=A'
+        }
+      };
+      this.sampleMessages.update(messages => [...messages, response]);
+    }, 1000);
+  }
+
+  onImageClicked(message: ChatMessage): void {
+    console.log('Imagen clickeada:', message);
+  }
+
+  onFileClicked(message: ChatMessage): void {
+```

package/llm/components/generic-documentation.md

@@ -0,0 +1,32 @@
+# core-generic-documentation
+
+- Class: `GenericDocumentationComponent`
+- File: `projects/core-ui-library/src/lib/components/generic-documentation/generic-documentation.component.ts`
+
+## Inputs
+- `documents`: `DocumentItem[]`
+- `config`: `DocumentConfig`
+- `loading`: `boolean`
+- `permissions`: `{
+    canDownload?: boolean;
+    canDelete?: boolean;
+    canHelp?: boolean;
+    canUpload?: boolean;
+  }`
+
+## Outputs
+- `actionTriggered`: `DocumentActionEvent`
+- `uploadRequested`: `Event`
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+

package/llm/components/generic-fixed-actions.md

@@ -0,0 +1,24 @@
+# core-generic-fixed-actions
+
+- Class: `GenericFixedActionsComponent`
+- File: `projects/core-ui-library/src/lib/components/generic-fixed-actions/generic-fixed-actions.component.ts`
+
+## Inputs
+- `externalActions`: `FixedActionConfig[]`
+- `tableId`: `string | undefined`
+
+## Outputs
+- none
+
+## Demo usage
+
+- No demo usage found in `core-ui-demo`.
+
+## Demo snippet (HTML)
+
+- No demo snippet found in `core-ui-demo`.
+
+## Demo snippet (TS)
+
+- No demo snippet found in `core-ui-demo`.
+