@skysoftware-co/bayan-hr-widgets-ui 1.0.12 → 1.0.15

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 (26) hide show
  1. package/README.md +19 -140
  2. package/fesm2022/skysoftware-co-bayan-hr-widgets-ui.mjs +1067 -102
  3. package/fesm2022/skysoftware-co-bayan-hr-widgets-ui.mjs.map +1 -1
  4. package/lib/my-vacation-team-widget/components/vacation-subordinates-popup/vacation-subordinates-popup.component.d.ts +38 -0
  5. package/lib/my-vacation-team-widget/my-vacation-team-widget.component.d.ts +33 -0
  6. package/lib/profile-bank-information-widget/profile-bank-information-widget.component.d.ts +5 -3
  7. package/lib/profile-job-information-contract-widget/profile-job-information-contract-widget.component.d.ts +30 -0
  8. package/lib/profile-job-information-main-widget/profile-job-information-main-widget.component.d.ts +30 -0
  9. package/lib/profile-job-information-salary-widget/profile-job-information-salary-widget.component.d.ts +36 -0
  10. package/lib/profile-job-information-service-charge-widget/profile-job-information-service-charge-widget.component.d.ts +32 -0
  11. package/lib/profile-personal-info-contact-widget/profile-personal-info-contact-widget.component.d.ts +2 -1
  12. package/lib/profile-personal-info-languages-widget/profile-personal-info-languages-widget.component.d.ts +2 -1
  13. package/lib/profile-personal-info-main-widget/profile-personal-info-main-widget.component.d.ts +2 -1
  14. package/lib/profile-personal-info-other-nationalities-widget/profile-personal-info-other-nationalities-widget.component.d.ts +2 -1
  15. package/lib/profile-profile-personal-info-address-widget/profile-personal-info-address-widget.component.d.ts +2 -1
  16. package/lib/services/hr-self-widgets.service.d.ts +10 -2
  17. package/lib/shared/services/job-information-cache.service.d.ts +22 -0
  18. package/lib/shared/types/common.d.ts +64 -26
  19. package/package.json +1 -1
  20. package/public-api.d.ts +6 -1
  21. package/lib/my-bank-information-widget/my-bank-information-widget.component.d.ts +0 -41
  22. package/lib/personal-info-address-widget/personal-info-address-widget.component.d.ts +0 -25
  23. package/lib/personal-info-contact-widget/personal-info-contact-widget.component.d.ts +0 -28
  24. package/lib/personal-info-languages-widget/personal-info-languages-widget.component.d.ts +0 -22
  25. package/lib/personal-info-main-widget/personal-info-main-widget.component.d.ts +0 -28
  26. package/lib/personal-info-other-nationalities-widget/personal-info-other-nationalities-widget.component.d.ts +0 -22
package/README.md CHANGED
@@ -270,158 +270,37 @@ The component calls `GET {baseUrl}/hr/employee-portal/calendar` with query param
270
270
  - `MonthsCount` - Number of months to load (default: 12)
271
271
  - Header: `api-version: 2`
272
272
 
273
- ## Profile Widgets
274
273
 
275
- The package also exports profile-focused widgets used in the employee profile page.
276
-
277
- ## Profile Personal Info Main Widget
278
-
279
- ### Usage
280
- ```html
281
- <hr-profile-personal-info-main-widget
282
- [baseUrl]="baseUrl"
283
- (isLoadingChanged)="onMainLoadingChanged($event)">
284
- </hr-profile-personal-info-main-widget>
285
- ```
286
-
287
- ### Input Properties
288
- | Input | Type | Default Value | Description |
289
- |-------|------|---------------|-------------|
290
- | `baseUrl` | string | `''` | Base URL for API calls (required) |
291
- | `sectionTitle` | string | `'main'` | Section title translation key |
292
- | `alternateLanguage` | string | `'English'` | Alternate language label next to employee alternate name |
293
- | `mainIcon` | IconDefinition | `faMemoCircleInfo` | Header icon |
294
- | `emptyStateContainerClass` | string | `'d-flex flex-column justify-content-center align-items-center my-5'` | Empty/loading container CSS class |
295
- | `emptyStateTextClass` | string | `'field-secondary-label-md'` | Empty/loading text CSS class |
296
-
297
- ### Output Events
298
- - `isLoadingChanged: EventEmitter<boolean>` - Emitted when loading state changes.
299
-
300
- ## Profile Personal Info Contact Widget
301
-
302
- ### Usage
303
- ```html
304
- <hr-profile-personal-info-contact-widget
305
- [baseUrl]="baseUrl"
306
- [showEmergencyContact]="true"
307
- (isLoadingChanged)="onContactLoadingChanged($event)">
308
- </hr-profile-personal-info-contact-widget>
309
- ```
310
-
311
- ### Input Properties
312
- | Input | Type | Default Value | Description |
313
- |-------|------|---------------|-------------|
314
- | `baseUrl` | string | `''` | Base URL for API calls (required) |
315
- | `sectionTitle` | string | `'contact'` | Section title translation key |
316
- | `showEmergencyContact` | boolean | `true` | Show emergency contact block |
317
- | `contactIcon` | IconDefinition | `faPhone` | Header icon |
318
- | `emergencyContactIcon` | IconDefinition | `faBolt` | Emergency contact icon |
319
- | `emptyStateContainerClass` | string | `'d-flex flex-column justify-content-center align-items-center my-5'` | Empty/loading container CSS class |
320
- | `emptyStateTextClass` | string | `'field-secondary-label-md'` | Empty/loading text CSS class |
321
-
322
- ### Output Events
323
- - `isLoadingChanged: EventEmitter<boolean>` - Emitted when loading state changes.
324
-
325
- ## Profile Personal Info Address Widget
274
+ ## My Vacation Team Widget Component
326
275
 
327
276
  ### Usage
328
277
  ```html
329
- <hr-profile-personal-info-address-widget
330
- [baseUrl]="baseUrl"
331
- (isLoadingChanged)="onAddressLoadingChanged($event)">
332
- </hr-profile-personal-info-address-widget>
278
+ <hr-my-vacation-team-widget
279
+ [baseUrl]="environment.baseUrl"
280
+ [showProperty]="true"
281
+ (isLoadingChanged)="onLoadingChanged($event)">
282
+ </hr-my-vacation-team-widget>
333
283
  ```
334
284
 
335
- ### Input Properties
336
- | Input | Type | Default Value | Description |
337
- |-------|------|---------------|-------------|
338
- | `baseUrl` | string | `''` | Base URL for API calls (required) |
339
- | `sectionTitle` | string | `'address'` | Section title translation key |
340
- | `addressIcon` | IconDefinition | `faHouse` | Header icon |
341
- | `emptyStateContainerClass` | string | `'d-flex flex-column justify-content-center align-items-center my-5'` | Empty/loading container CSS class |
342
- | `emptyStateTextClass` | string | `'field-secondary-label-md'` | Empty/loading text CSS class |
343
-
344
- ### Output Events
345
- - `isLoadingChanged: EventEmitter<boolean>` - Emitted when loading state changes.
346
-
347
- ## Profile Personal Info Languages Widget
348
-
349
- ### Usage
350
- ```html
351
- <hr-profile-personal-info-languages-widget
352
- [baseUrl]="baseUrl"
353
- (hasDataChange)="onLanguagesDataChange($event)"
354
- (isLoadingChanged)="onLanguagesLoadingChanged($event)">
355
- </hr-profile-personal-info-languages-widget>
356
- ```
285
+ This component displays a "Next Week Vacation Insights" card showing two badges: **Upcoming Vacations** and **Expected To Return** counts for team subordinates. Clicking a badge opens a popup with a paginated, searchable data grid listing the relevant employees. It uses `SkyWidgetSectionItemComponent` from `@skysoftware-co/sky-components-ui` for badge display and `BayanEmployeeBadgeComponent` from `@skysoftware-co/bayan-components-ui` for employee photos in the popup.
357
286
 
358
287
  ### Input Properties
359
288
  | Input | Type | Default Value | Description |
360
289
  |-------|------|---------------|-------------|
361
290
  | `baseUrl` | string | `''` | Base URL for API calls |
362
- | `sectionTitle` | string | `'languages'` | Section title translation key |
363
- | `languagesIcon` | IconDefinition | `faLanguage` | Header icon |
364
- | `emptyStateContainerClass` | string | `'d-flex flex-column justify-content-center align-items-center my-5'` | Empty/loading container CSS class |
365
- | `emptyStateTextClass` | string | `'field-secondary-label-md'` | Empty/loading text CSS class |
366
-
367
- ### Output Events
368
- - `hasDataChange: EventEmitter<boolean>` - Emitted when language list has data or not.
369
- - `isLoadingChanged: EventEmitter<boolean>` - Emitted when loading state changes.
370
-
371
- ## Profile Personal Info Other Nationalities Widget
372
-
373
- ### Usage
374
- ```html
375
- <hr-profile-personal-info-other-nationalities-widget
376
- [baseUrl]="baseUrl"
377
- (hasDataChange)="onOtherNationalitiesDataChange($event)"
378
- (isLoadingChanged)="onOtherNationalitiesLoadingChanged($event)">
379
- </hr-profile-personal-info-other-nationalities-widget>
380
- ```
381
-
382
- ### Input Properties
383
- | Input | Type | Default Value | Description |
384
- |-------|------|---------------|-------------|
385
- | `baseUrl` | string | `''` | Base URL for API calls (required) |
386
- | `sectionTitle` | string | `'otherNationalities'` | Section title translation key |
387
- | `otherNationalitiesIcon` | IconDefinition | `faEarthAfrica` | Header icon |
388
- | `emptyStateTextKey` | string | `'ThereIsNoOtherNationalitiesYet'` | Empty state translation key |
389
- | `emptyStateContainerClass` | string | `'d-flex flex-column justify-content-center align-items-center my-5'` | Empty/loading container CSS class |
390
- | `emptyStateTextClass` | string | `'field-secondary-label-md'` | Empty/loading text CSS class |
391
-
392
- ### Output Events
393
- - `hasDataChange: EventEmitter<boolean>` - Emitted when other nationalities list has data or not.
394
- - `isLoadingChanged: EventEmitter<boolean>` - Emitted when loading state changes.
395
-
396
- ## Profile Bank Information Widget
397
-
398
- ### Usage
399
- ```html
400
- <hr-profile-bank-information-widget
401
- [baseUrl]="baseUrl"
402
- [currencyCode]="currencyCode"
403
- [currencyDecimals]="currencyDecimals"
404
- (isLoadingChanged)="onBankLoadingChanged($event)">
405
- </hr-profile-bank-information-widget>
406
- ```
407
-
408
- ### Input Properties
409
- | Input | Type | Default Value | Description |
410
- |-------|------|---------------|-------------|
411
- | `baseUrl` | string | `''` | Base URL for API calls (required) |
412
- | `currencyCode` | string | `''` | Currency code shown with transfer amount |
413
- | `currencyDecimals` | number | `2` | Decimal precision for transfer amount formatting |
414
- | `sectionTitle` | string | `'BankInformation'` | Section title translation key |
415
- | `sectionHeaderVisibility` | boolean | `true` | Show or hide the section header |
416
- | `language` | string | `'en'` | Language used for RTL behavior (`'ar'` enables RTL) |
417
- | `bankInformationIcon` | IconDefinition | `faMoneyCheckDollarPen` | Header icon |
418
- | `emptyStateContainerClass` | string | `'d-flex flex-column justify-content-center align-items-center my-5'` | Empty/loading container CSS class |
419
- | `emptyStateTextClass` | string | `'field-secondary-label-md'` | Empty/loading text CSS class |
291
+ | `showProperty` | boolean | `false` | Show employee property badge in the popup grid |
292
+ | `cardClass` | string | `'card rounded rounded-4 card-shadow p-16 border-top-0 h-100 p-4'` | Card container CSS class |
293
+ | `titleClass` | string | `'table-header-lg fw-meduim'` | Card title CSS class |
294
+ | `valueClass` | string | `'fs-24 mt-1 link-dark hover-primary text-decoration-none'` | Badge value CSS class (clickable) |
295
+ | `disabledValueClass` | string | `'fs-24 mt-1 text-muted pe-none text-decoration-none'` | Badge value CSS class when count is 0 |
296
+ | `upcomingContainerClass` | string | `'border-start border-5 mb-3'` | Upcoming vacations badge container CSS class |
297
+ | `expectedContainerClass` | string | `'border-start border-5'` | Expected to return badge container CSS class |
420
298
 
421
299
  ### Output Events
422
- - `isLoadingChanged: EventEmitter<boolean>` - Emitted when loading state changes.
300
+ - `isLoadingChanged: EventEmitter<boolean>` - Emitted when loading state changes
423
301
 
424
- ### Notes
302
+ ### API Endpoints
303
+ - **Summary**: `GET {baseUrl}/hr/widgets/me/team/subordinates/vacations/summary?ShowDirectSubordinatesOnly=false`
304
+ - **Upcoming list**: `GET {baseUrl}/hr/widgets/me/team/subordinates/vacations/upcoming`
305
+ - **Expected to return list**: `GET {baseUrl}/hr/widgets/me/team/subordinates/vacations/expected-to-return`
425
306
 
426
- - All profile widgets support extensive style class overrides similar to other widgets in this package.
427
- - During loading, widgets display section-based loading captions (for example: `Main is loading...`).