@solcre-org/core-ui 2.19.2 → 2.20.0

package/llm/exports.md

@@ -0,0 +1,286 @@
+# Public exports (current)
+
+Source of truth: `projects/core-ui-library/src/public-api.ts`.
+
+## Components (from `projects/core-ui-library/src/lib/components/index.ts`)
+- `./fields/field-errors/field-errors.component`
+- `./active-filters/active-filters.component`
+- `./fields/types/base/base-field.component`
+- `./fields/types/checkbox-field/checkbox-field.component`
+- `./fields/types/color-picker-field/color-picker-field.component`
+- `./fields/types/date-field/date-field.component`
+- `./fields/types/daterange-field/daterange-field.component`
+- `./fields/types/datetime-field/datetime-field.component`
+- `./fields/types/document-field/document-field.component`
+- `./fields/types/file-field/file-field.component`
+- `./fields/types/number-field/number-field.component`
+- `./fields/types/password-field/password-field.component`
+- `./fields/types/phone-field/phone-field.component`
+- `./fields/types/select-field/select-field.component`
+- `./fields/types/server-select-field/services/server-select.service`
+- `./fields/types/server-select-field/server-select-field.component`
+- `./fields/types/switch-field/switch-field.component`
+- `./fields/types/text-area-field/text-area-field.component`
+- `./fields/types/text-field/text-field.component`
+- `./fields/types/time-field/time-field.component`
+- `./fields/types/multi-entry-field/multi-entry-field.component`
+- `./fields/types/smart-field/smart-field.component`
+- `./loader/services/loader.service`
+- `./loader/loader.component`
+- `./data-list/data-list.component`
+- `./data-list-item/data-list-item.component`
+- `./generic-button/enums/ButtonContext.enum`
+- `./generic-button/enums/ButtonSize.enum`
+- `./generic-button/enums/ButtonType.enum`
+- `./generic-button/interfaces/ButtonConfig.interface`
+- `./generic-button/interfaces/ButtonActionEvent.interface`
+- `./generic-button/generic-button.component`
+- `./generic-modal/generic-modal.component`
+- `./generic-pagination/services/pagination.service`
+- `./generic-pagination/generic-pagination.component`
+- `./generic-tabs/interfaces/tab-config.interface`
+- `./generic-tabs/interfaces/tab-click.interface`
+- `./generic-tabs/interfaces/tab.interface`
+- `./generic-tabs/generic-tabs.component`
+- `./confirmation-dialog/enums/DialogActions.enum`
+- `./confirmation-dialog/interfaces/ConfirmDialogConfig.interface`
+- `./confirmation-dialog/services/confirmation-dialog.service`
+- `./confirmation-dialog/confirmation-dialog.component`
+- `./generic-table/components/dropdown/enums/DropdownDirection.enum`
+- `./generic-table/components/dropdown/enums/TableAction.enum`
+- `./generic-table/components/dropdown/services/dropdown.service`
+- `./generic-table/components/dropdown/dropdown.component`
+- `./generic-table/components/filter-modal/enums/FilterType.enum`
+- `./generic-table/components/filter-modal/interfaces/FilterConfig.interface`
+- `./generic-table/components/filter-modal/services/filter.service`
+- `./generic-table/components/filter-modal/filter-modal.component`
+- `./generic-table/interfaces/ColumnConfig.interface`
+- `./generic-table/interfaces/ColumnDisabledConfig.interface`
+- `./generic-table/interfaces/RowVisibilityConfig.interface`
+- `./generic-table/interfaces/InlineEditConfig.interface`
+- `./generic-table/interfaces/CustomAction.interface`
+- `./generic-table/interfaces/ExpansionConfig.interface`
+- `./generic-table/interfaces/GlobalAction.interface`
+- `./generic-table/interfaces/MoreDataConfig.interface`
+- `./generic-table/interfaces/RowStyleConfig.interface`
+- `./generic-table/interfaces/TableActionConfig.interface`
+- `./generic-table/interfaces/SortConfig.interface`
+- `./generic-table/interfaces/TableSortConfig.interface`
+- `./generic-table/interfaces/TableFixedActionsConfig.interface`
+- `./generic-table/enums/SortDirection.enum`
+- `./generic-table/enums/SortMode.enum`
+- `./generic-table/services/table-action.service`
+- `./generic-table/services/table-data.service`
+- `./generic-table/services/table-sort.service`
+- `./generic-table/services/table-fixed-actions.service`
+- `./generic-table/generic-table.component`
+- `./alert/alert-container.component`
+- `./alert/alert.component`
+- `./generic-documentation/enums/DocumentAction.enum`
+- `./generic-documentation/enums/DocumentDisplayMode.enum`
+- `./generic-documentation/interfaces/DocumentActionEvent.interface`
+- `./generic-documentation/interfaces/DocumentConfig.interface`
+- `./generic-documentation/interfaces/DocumentItem.interface`
+- `./generic-documentation/generic-documentation.component`
+- `./generic-sidebar/services/sidebar.service`
+- `./generic-sidebar/services/sidebar-mobile-modal.service`
+- `./generic-sidebar/services/sidebar-custom-modal.service`
+- `./generic-sidebar/generic-sidebar.component`
+- `./generic-sidebar/components/sidebar-custom-modal.component`
+- `./generic-sidebar/services/sidebar-template-registry.service`
+- `./generic-timeline/enums/TimelineStatus.enum`
+- `./generic-timeline/enums/TimelineType.enum`
+- `./generic-timeline/interfaces/TimelineConfig.interface`
+- `./generic-timeline/interfaces/TimelineItem.interface`
+- `./generic-timeline/services/timeline.service`
+- `./generic-timeline/generic-timeline.component`
+- `./header/header.component`
+- `./mobile-header`
+- `./main-nav/enums/PermissionsActions.enum`
+- `./main-nav/enums/PermissionsResources.enum`
+- `./main-nav/enums/PermissionsCustomActions.enum`
+- `./main-nav/enums/SidebarState.enum`
+- `./main-nav/interfaces/NavConfig.interface`
+- `./main-nav/interfaces/NavUserConfig.interface`
+- `./main-nav/interfaces/NavItem.interface`
+- `./main-nav/services/main-nav.service`
+- `./main-nav/main-nav.component`
+- `./layout/services/layout-state.service`
+- `./layout/services/layout.service`
+- `./layout/layout`
+- `./layout-auth/layout-auth`
+- `./generic-steps/enums/StepStatus.enum`
+- `./generic-steps/enums/StepType.enum`
+- `./generic-steps/enums/StepSize.enum`
+- `./generic-steps/interfaces/StepsConfig.interface`
+- `./generic-steps/interfaces/StepItemConfig.interface`
+- `./generic-steps/interfaces/StepClickEvent.interface`
+- `./generic-steps/services/steps.service`
+- `./generic-steps/generic-steps.component`
+- `./generic-rating/generic-rating.component`
+- `./main-nav/interfaces/LogoImagesConfig.interface`
+- `./main-nav/interfaces/BottomNavItem.interface`
+- `./progress-bar/progress-bar-size.enum`
+- `./progress-bar/progress-bar.component`
+- `./card/card.component`
+- `./image-modal/image-modal.component`
+- `./image-preview`
+- `./carousel`
+- `./generic-skeleton`
+- `./generic-chat/enums/chat-message-type.enum`
+- `./generic-chat/enums/chat-message-position.enum`
+- `./generic-chat/interfaces/chat-message.interface`
+- `./generic-chat/interfaces/chat-config.interface`
+- `./generic-chat/interfaces/file-preview.interface`
+- `./generic-chat/services/generic-chat.service`
+- `./generic-chat/generic-chat.component`
+- `./manual-refresh`
+- `./generic-gallery`
+- `./gallery-modal`
+- `./generic-switch`
+- `./generic-fixed-actions`
+- `./auth/ad-auth/enums/ad-interaction-type.enum`
+- `./auth/ad-auth/interfaces/ad-auth-config.interface`
+- `./auth/ad-auth/services/ad-auth.service`
+- `./auth/ad-auth/guards/ad-auth.guard`
+- `./auth/ad-auth/interceptors/ad-auth.interceptor`
+- `./auth/ad-auth/providers/ad-auth.providers`
+- `./auth/ad-auth/components/ad-login-button/ad-login-button.component`
+- `./generic-calendar`
+- `./generic-scheduler`
+
+## Services (from `projects/core-ui-library/src/lib/services/index.ts`)
+- `./alert.service`
+- `./core-ui-translate.service`
+- `./custom-class.service`
+- `./data-store.service`
+- `./file-upload.service`
+- `./global-api-config.service`
+- `./header-configuration.service`
+- `./header.service`
+- `./mobile-resolution.service`
+- `./model-api.service`
+- `./permission.service`
+- `./permission-wrapper.service`
+- `./permission-enums.service`
+- `./rating.service`
+- `./redirect-url.service`
+- `./translation-merge.service`
+
+## Interfaces (from `projects/core-ui-library/src/lib/interfaces/index.ts`)
+- `./field-configs/checkbox-field-config.interface`
+- `./field-configs/date-field-config.interface`
+- `./field-configs/daterange-field-config.interface`
+- `./field-configs/document-field-config.interface`
+- `./field-configs/file-field-config.interface`
+- `./field-configs/number-field-config.interface`
+- `./field-configs/phone-field-config.interface`
+- `./field-configs/select-server-side.config.interface`
+- `./field-configs/switch-field-config.interface`
+- `./field-configs/time-field.config.interface`
+- `./field-configs/multi-entry-field.config.interface`
+- `./global/Adress.interface`
+- `./global/Alert.interface`
+- `./global/ActiveFiltersConfig.interface`
+- `./global/ApiConfig.interface`
+- `./global/ApiResponse.interface`
+- `./global/ConfirmUploadRequest.interface`
+- `./global/DataListItem.interface`
+- `./global/DynamicFieldsHelperConfig.interface`
+- `./global/FileUploadConfig.interface`
+- `./global/FilterParams.interface`
+- `./global/HeaderActionConfig.interface`
+- `./global/header-action.interface`
+- `./global/ModalButtonConfig.interface`
+- `./global/ModalFieldConfig.interface`
+- `./global/ModalStepConfig.interface`
+- `./global/ModalTabConfig.interface`
+- `./global/ModalValidationResult.interface`
+- `./global/PaginatedResponse.interface`
+- `./global/PermissionProvider.interface`
+- `./global/PermissionEnums.interface`
+- `./global/PresignedDownloadUrlResponse.interface`
+- `./global/PresignedUrlRequest.interface`
+- `./global/PresignedUrlResponse.interface`
+- `./layout/layout-config.interface`
+- `./layout/layout-data-attributes.interface`
+- `./layout/sidebar-back-button.interface`
+- `./layout/sidebar-component-events.interface`
+- `./layout/sidebar-component.interface`
+- `./layout/sidebar-config.interface`
+- `./layout/sidebar-item.interface`
+- `./layout/sidebar-sub-item.interface`
+- `./layout/sidebar-responsive-config.interface`
+- `./layout/sidebar-custom-modal-config.interface`
+- `./user/company-info.interface`
+- `./global/HeaderOrderConfig.interface`
+- `./global/ExtendedPermissionProvider.interface`
+- `./global/RatingConfig.interface`
+- `../enums/global/RatingSize.enum`
+- `../enums/global/RatingType.enum`
+- `./global/RatingStar.interface`
+- `./global/RatingSubmitEvent.interface`
+- `./calendar`
+
+## Enums (from `projects/core-ui-library/src/lib/enums/index.ts`)
+- `./global/AlertType.enum`
+- `./global/FieldType.enum`
+- `./global/FileType.enum`
+- `./global/ModalMode.enum`
+- `./global/NumberRange.enum`
+- `./global/TimeInterval.enum`
+- `./layout/layout-breakpoint.enum`
+- `./layout/layout-visibility.enum`
+- `./layout/layout.enums`
+- `./layout/sidebar-height.enum`
+- `./layout/sidebar-position.enum`
+- `./layout/sidebar-width.enum`
+- `./layout/sidebar-mobile-type.enum`
+- `./global/HeaderElementType.enum`
+- `./country-codes.enum`
+- `./calendar`
+
+## Directives
+- `projects/core-ui-library/src/lib/directives/DynamicField.directive`
+- `projects/core-ui-library/src/lib/directives/core-host.directive`
+
+## Interceptors
+- `projects/core-ui-library/src/lib/interceptors/cache-busting.interceptor`
+- `projects/core-ui-library/src/lib/interceptors/permissions.interceptor`
+
+## Loaders
+- `projects/core-ui-library/src/lib/loaders/core-ui-translate.loader`
+
+## Providers
+- `projects/core-ui-library/src/lib/providers/translate.providers`
+- `projects/core-ui-library/src/lib/providers/permission.provider`
+- `projects/core-ui-library/src/lib/providers/permission-enums.provider`
+- `projects/core-ui-library/src/lib/providers/permission-service.provider`
+- `projects/core-ui-library/src/lib/providers/api-configuration.provider`
+
+## Models
+- `projects/core-ui-library/src/lib/models/global/configuration.model`
+- `projects/core-ui-library/src/lib/models/global/file.model`
+- `projects/core-ui-library/src/lib/models/global/file-template-type.model`
+- `projects/core-ui-library/src/lib/models/global/file-template.model`
+- `projects/core-ui-library/src/lib/models/global/file-type.model`
+- `projects/core-ui-library/src/lib/models/security/permission.model`
+- `projects/core-ui-library/src/lib/models/users/users.model`
+- `projects/core-ui-library/src/lib/models/users/role.model`
+- `projects/core-ui-library/src/lib/models/users/reset-password.model`
+
+## Utilities
+- `projects/core-ui-library/src/lib/utilities/date.utility`
+- `projects/core-ui-library/src/lib/utilities/isSameDate.util`
+- `projects/core-ui-library/src/lib/utilities/dynamic-fields.helper`
+- `projects/core-ui-library/src/lib/utilities/uruguayan-document-validation.helper`
+- `projects/core-ui-library/src/lib/utilities/age-validation.helper`
+
+## Validators
+- `projects/core-ui-library/src/lib/validators/password.validator`
+- `projects/core-ui-library/src/lib/validators/document-field-validators`
+
+## Constants
+- `projects/core-ui-library/src/lib/constants/countries.constants`
+- `projects/core-ui-library/src/lib/constants/version`
+

package/llm/form-recipes.md

@@ -0,0 +1,203 @@
+# Form recipes (ModalFieldConfig)
+
+These recipes show how to assemble form fields for create/edit/filter flows.
+
+## Common building blocks
+- `ModalFieldConfig<T>` from `interfaces/global/ModalFieldConfig.interface.ts`
+- `FieldType` enum from `enums/global/FieldType.enum.ts`
+- `ModalMode` enum from `enums/global/ModalMode.enum.ts`
+- Optional per-field configs: `SelectFieldConfig`, `SelectServerSideConfig`, `PhoneModalFieldConfig`, `FileFieldConfig`, `DocumentFieldConfig`, `NumberModalFieldConfig`, `DateRangeFieldConfig`
+
+## Create/Edit form (generic modal)
+
+### Field config
+```ts
+import { ModalFieldConfig } from 'projects/core-ui-library/src/lib/interfaces/global/ModalFieldConfig.interface';
+import { FieldType, ModalMode } from 'projects/core-ui-library/src/lib/enums';
+import { Validators } from '@angular/forms';
+
+interface User {
+  id: number;
+  name: string;
+  email: string;
+  status: 'active' | 'inactive';
+  phone: string;
+}
+
+export const userFields: ModalFieldConfig<User>[] = [
+  {
+    key: 'name',
+    label: 'Name',
+    type: FieldType.TEXT,
+    placeholder: 'Full name',
+    readonly: false,
+    validators: [Validators.required],
+  },
+  {
+    key: 'email',
+    label: 'Email',
+    type: FieldType.TEXT,
+    placeholder: 'user@company.com',
+    readonly: false,
+    validators: [Validators.required],
+  },
+  {
+    key: 'status',
+    label: 'Status',
+    type: FieldType.SELECT,
+    options: [
+      { value: 'active', label: 'Active' },
+      { value: 'inactive', label: 'Inactive' },
+    ],
+    readonly: false,
+  },
+  {
+    key: 'phone',
+    label: 'Phone',
+    type: FieldType.PHONE,
+    readonly: false,
+  },
+];
+```
+
+### Modal usage
+```html
+<core-generic-modal
+  [isOpen]="isOpen"
+  [mode]="mode"
+  [title]="modalTitle"
+  [data]="formData"
+  (save)="save($event)"
+  (close)="close()"
+></core-generic-modal>
+```
+
+## Filter form (table filters)
+
+Use `ModalMode.FILTER` to reuse the same field definitions but loosen validation and readonly behavior.
+
+```ts
+const filterFields: ModalFieldConfig<User>[] = userFields.map(field => ({
+  ...field,
+  modes: {
+    [ModalMode.FILTER]: {
+      validators: [],
+      readonly: false,
+    }
+  }
+}));
+```
+
+If you want different fields for filters, define a separate array and set `type` to match the field component.
+
+## Form rendering with dynamic fields
+
+Use `core-smart-field` to render a field by type dynamically.
+
+```html
+<div *ngFor="let field of userFields">
+  <core-smart-field
+    [field]="field"
+    [value]="formData[field.key]"
+    [mode]="mode"
+    [errors]="errors[field.key] || []"
+    [formValue]="formData"
+    (valueChange)="onFieldChange(field.key, $event)"
+    (selectionChange)="onSelectionChange($event)"
+  ></core-smart-field>
+</div>
+```
+
+## Minimal wiring in TS
+
+```ts
+mode: ModalMode = ModalMode.CREATE;
+formData: Partial<User> = {};
+errors: Record<string, string[]> = {};
+
+onFieldChange(key: keyof User, value: any) {
+  this.formData = { ...this.formData, [key]: value };
+}
+
+onSelectionChange(e: { selectedItem: any; newFormValue: any }) {
+  this.formData = { ...this.formData, ...e.newFormValue };
+}
+```
+
+## Specialized field recipes
+
+### Server-side select (remote options)
+```ts
+import { SelectServerSideConfig } from 'projects/core-ui-library/src/lib/interfaces/field-configs/select-server-side.config.interface';
+
+const companyField: SelectServerSideConfig<User> = {
+  key: 'companyId',
+  label: 'Company',
+  type: FieldType.SERVER_SELECT,
+  endpoint: '/api/companies',
+  bindValue: 'id',
+  bindLabel: 'name',
+  searchParam: 'q',
+  minSearchLength: 2,
+  readonly: false,
+};
+```
+
+### File field (upload + preview)
+```ts
+import { FileFieldConfig } from 'projects/core-ui-library/src/lib/interfaces/field-configs/file-field-config.interface';
+import { FileType } from 'projects/core-ui-library/src/lib/enums/global/FileType.enum';
+
+const attachmentsField: FileFieldConfig<User> = {
+  key: 'attachments',
+  label: 'Attachments',
+  type: FieldType.FILE,
+  accept: '.pdf,.png,.jpg',
+  multiple: true,
+  maxFiles: 3,
+  maxSize: 5 * 1024 * 1024,
+  showPreview: true,
+  acceptString: 'pdf,png,jpg',
+  fileUploadConfig: {
+    fileType: FileType.DOCUMENT,
+    fileIdTarget: 'attachmentIds' as keyof User,
+  },
+  readonly: false,
+};
+```
+
+### Document field (type + number)
+```ts
+import { DocumentFieldConfig, DocumentPayloadMode } from 'projects/core-ui-library/src/lib/interfaces/field-configs/document-field-config.interface';
+
+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,
+};
+```
+
+### Phone field
+```ts
+import { PhoneModalFieldConfig } from 'projects/core-ui-library/src/lib/interfaces/field-configs/phone-field-config.interface';
+import { CountryCode } from 'projects/core-ui-library/src/lib/enums';
+
+const phoneField: PhoneModalFieldConfig<User> = {
+  key: 'phone',
+  label: 'Phone',
+  type: FieldType.PHONE,
+  phoneConfig: {
+    defaultCountry: CountryCode.UY,
+    showFlags: true,
+    showPhoneCode: true,
+    validatePhoneFormat: true,
+  },
+  readonly: false,
+};
+```

package/llm/llms.txt

@@ -0,0 +1,47 @@
+Core UI Library (Angular) — LLM Entry
+
+Purpose
+- UI component library + services for building screens in Angular apps.
+- Focus: tables, forms/fields, layout/navigation, modals, auth, utilities.
+
+Library root
+- projects/core-ui-library
+- Public surface: projects/core-ui-library/src/public-api.ts
+
+Key facts for agents
+- Components are Angular standalone components.
+- Many components depend on @ngx-translate/core (TranslateModule/TranslateService).
+- Some data-driven components use @solcre-org/core types (e.g. DataBaseModelInterface).
+
+Recommended read order
+1) repo-map.md
+2) exports.md
+3) components.md
+4) screen-recipes.md
+5) form-recipes.md
+6) screen-blueprints.md
+7) demo-examples.md
+
+Demo references (core-ui-demo)
+- Layout shell: `projects/core-ui-demo/src/app/layout/dashboard/dashboard.component.html`
+- Tables: `projects/core-ui-demo/src/app/admin/components/tables/tables.html`
+- Forms/fields showcase: `projects/core-ui-demo/src/app/admin/components/forms/forms.html`
+- Modals: `projects/core-ui-demo/src/app/admin/components/modals/modals.html`
+- Buttons: `projects/core-ui-demo/src/app/admin/components/button/button.html`
+- Alerts: `projects/core-ui-demo/src/app/admin/components/alerts/alerts.ts` and `projects/core-ui-demo/src/app/admin/components/alerts/alerts.html`
+- Steps: `projects/core-ui-demo/src/app/admin/components/steps/steps.html`
+- Calendar/Scheduler: `projects/core-ui-demo/src/app/admin/components/calendar/calendar-demo.component.html`
+- Gallery: `projects/core-ui-demo/src/app/admin/components/gallery/gallery.html`
+- Sidebar: `projects/core-ui-demo/src/app/admin/components/sidebar/sidebar.html`
+
+Where to look
+- Components: projects/core-ui-library/src/lib/components
+- Services: projects/core-ui-library/src/lib/services
+- Interfaces: projects/core-ui-library/src/lib/interfaces
+- Enums: projects/core-ui-library/src/lib/enums
+- Utilities/validators/providers/directives: projects/core-ui-library/src/lib
+
+Agent usage rules (project-specific)
+- Prefer using exported components from public-api.
+- When building screens, compose with layout, header, main-nav, and form field types.
+- For tables, see generic-table and related interfaces/services.

package/llm/repo-map.md

@@ -0,0 +1,30 @@
+# Repo map (core-ui-library)
+
+## Top-level structure
+- `projects/core-ui-library` — Angular library source
+- `projects/core-ui-demo` — Demo app (consumer of the library)
+- `docs/` — Project docs (if present)
+- `dist/` — Build outputs
+
+## Library layout (projects/core-ui-library)
+- `src/public-api.ts` — Single public export surface
+- `src/lib/components` — Standalone UI components
+- `src/lib/services` — UI + data services used by components
+- `src/lib/interfaces` — TypeScript interfaces and configs
+- `src/lib/enums` — Enums (global, layout, calendar, etc.)
+- `src/lib/models` — Data models
+- `src/lib/providers` — Angular providers
+- `src/lib/directives` — Directives used by components
+- `src/lib/interceptors` — HTTP interceptors
+- `src/lib/loaders` — Translation loader
+- `src/lib/utilities` — Helper utilities
+- `src/lib/validators` — Validators
+- `src/assets` — Library assets
+
+## Build/test commands
+- Build: `ng build core-ui-library`
+- Test: `ng test`
+
+## LLM docs location
+- `projects/core-ui-library/src/llm`
+